Graphorin API reference v0.5.0
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 |
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; }> | A6 / SOTA-2 — 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 |