Graphorin API reference v0.15.1

---

Graphorin API reference / @graphorin/memory / / ClearToolResultsOptions

Interface: ClearToolResultsOptions

Defined in: packages/memory/src/context-engine/compaction/clear-tool-results.ts:28

Knobs for clearOldToolResults (mirrors the strategy variant).

Properties

Property	Modifier	Type	Description	Defined in
clearAtLeast?	readonly	number	Only clear if at least this many tokens are reclaimable; else leave untouched (default 0).	packages/memory/src/context-engine/compaction/clear-tool-results.ts:32
clearToolInputs?	readonly	boolean	Parity with clear_tool_uses_20250919: additionally blank the PAIRED assistant message's tool-call arguments for every cleared result, reclaiming the input side of verbose calls too. Default false.	packages/memory/src/context-engine/compaction/clear-tool-results.ts:72
excludeTools?	readonly	readonly string[]	Tool names whose results are never cleared.	packages/memory/src/context-engine/compaction/clear-tool-results.ts:34
externalize?	readonly	(content, info) => Promise<{ handleId: string; preview?: string; }>	Recoverable clearing. When provided, the original tool-result text of each cleared message is handed to this callback (wire it to a spill store / the read_result handle registry) and the placeholder references the returned handle id + preview, so the model can re-fetch the full result via read_result rather than losing it. Invoked only for clears that actually commit (after the clearAtLeast floor), so a rejected clearing never spills. Omitted ⇒ the bare placeholder (irrecoverable, byte-identical default).	packages/memory/src/context-engine/compaction/clear-tool-results.ts:50
keepToolUses?	readonly	number	Most-recent tool results kept verbatim (default DEFAULT_KEEP_TOOL_USES).	packages/memory/src/context-engine/compaction/clear-tool-results.ts:30
placeholder?	readonly	(info) => string	Placeholder builder; defaults to a one-line [cleared tool result …] marker.	packages/memory/src/context-engine/compaction/clear-tool-results.ts:36
readResultToolName?	readonly	string | null	The tool the externalized-handle placeholder advertises. The memory package cannot know whether the agent registered read_result (that depends on spill wiring), so callers whose runtime does NOT expose it pass null and the placeholder degrades to a tool-neutral phrasing instead of promising a tool the model cannot call. Default 'read_result' (the agent built-in).	packages/memory/src/context-engine/compaction/clear-tool-results.ts:66