@namzu/sdk 2.0.0 → 3.0.0

package/dist/compaction/managers/structured.js.map

@@ -1 +1 @@
-{"version":3,"file":"structured.js","sourceRoot":"","sources":["../../../src/compaction/managers/structured.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"structured.js","sourceRoot":"","sources":["../../../src/compaction/managers/structured.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EACN,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,GACtB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,2BAA2B;IAC9B,IAAI,GAAG,YAAY,CAAA;IACX,MAAM,CAAkB;IAEzC,YAAY,MAAwB;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACrB,CAAC;IAED,eAAe,CAAC,QAAmB;QAClC,wCAAwC;QACxC,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAEzD,IAAI,kBAAkB,GAAG,IAAI,CAAA;QAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC7B,sBAAsB,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;gBACzE,kBAAkB,GAAG,KAAK,CAAA;YAC3B,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC5D,2BAA2B,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YACxE,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpC,6DAA6D;gBAC7D,kDAAkD;YACnD,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,WAAW,IAAI,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACxF,0BAA0B;gBAC1B,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;oBAC1C,mBAAmB,CAAC,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;gBACvF,CAAC;YACF,CAAC;QACF,CAAC;QAED,0DAA0D;QAC1D,IAAI,YAAY,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC/D,OAAO,QAAQ,CAAA;QAChB,CAAC;QAED,4BAA4B;QAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAA;QACrC,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QAExC,8EAA8E;QAC9E,MAAM,MAAM,GAAc,EAAE,CAAA;QAC5B,IAAI,QAAQ,GAAG,KAAK,CAAA;QAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;YACvB,IAAI,CAAC,GAAG;gBAAE,SAAQ;YAElB,8CAA8C;YAC9C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAEhB,kCAAkC;YAClC,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACtC,MAAM,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACrB,CAAC,CAAA;gBACF,QAAQ,GAAG,IAAI,CAAA;YAChB,CAAC;QACF,CAAC;QAED,4CAA4C;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,CAAC,OAAO,CAAC;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,UAAU;gBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC,CAAA;QACH,CAAC;QAED,gDAAgD;QAChD,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,GAAG,CAAC,EAAE,CAAC;YACxD,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAA;YACvE,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;YAE/D,+DAA+D;YAC/D,iEAAiE;YACjE,8DAA8D;YAC9D,4DAA4D;YAC5D,6DAA6D;YAC7D,yDAAyD;YACzD,OAAO,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACjC,CAAC;QAED,OAAO,MAAM,CAAA;IACd,CAAC;IAED,aAAa,CAAC,QAAmB,EAAE,eAAuB;QACzD,wEAAwE;QACxE,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAEzD,IAAI,kBAAkB,GAAG,IAAI,CAAA;QAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC7B,sBAAsB,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;gBACzE,kBAAkB,GAAG,KAAK,CAAA;YAC3B,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC5D,2BAA2B,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YACxE,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,WAAW,IAAI,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACxF,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;oBAC1C,mBAAmB,CAAC,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;gBACvF,CAAC;YACF,CAAC;QACF,CAAC;QAED,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAA;QACrC,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QAExC,qFAAqF;QACrF,MAAM,MAAM,GAAc,EAAE,CAAA;QAC5B,IAAI,QAAQ,GAAG,KAAK,CAAA;QAEpB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACjB,CAAC;iBAAM,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC7C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBAChB,MAAM,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACrB,CAAC,CAAA;gBACF,QAAQ,GAAG,IAAI,CAAA;YAChB,CAAC;QACF,CAAC;QAED,sBAAsB;QACtB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,CAAA;QACjF,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAA;QAEtF,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACjB,CAAC;QACF,CAAC;QAED,2CAA2C;QAC3C,IAAI,MAAM,CAAC,MAAM,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,GAAG,WAAW,CAAA;YACpD,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;YAC/D,OAAO,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,MAAM,CAAC,MAAM,CAAA;QACtD,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAA;IACvC,CAAC;CACD"}

package/dist/compaction/retention.d.ts

@@ -0,0 +1,15 @@
+import type { Message } from '../types/message/index.js';
+/**
+ * Indices of every message protected by a `retain` marker, expanded across
+ * tool pairs.
+ *
+ * Transitive by necessity, not politeness. A `tool_result` whose
+ * `tool_use` was dropped is rejected by the provider outright, so pinning
+ * half a pair would turn a retention request into a broken next turn. So:
+ * a pinned tool result pulls in the assistant turn that issued the call,
+ * and a pinned assistant turn pulls in EVERY result answering it — the
+ * second hop matters, because an assistant turn with three calls and one
+ * surviving result is the same dangling error in the other direction.
+ */
+export declare function findRetainedIndices(messages: readonly Message[]): Set<number>;
+//# sourceMappingURL=retention.d.ts.map

package/dist/compaction/retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/compaction/retention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,OAAO,EAAe,MAAM,2BAA2B,CAAA;AAwBvF;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAoD7E"}

package/dist/compaction/retention.js

@@ -0,0 +1,89 @@
+/**
+ * Which messages compaction may not evict or clear.
+ *
+ * The retention floor was entirely POSITIONAL: the leading system run, the
+ * working-memory slot, the last N turns, the most recent tool results.
+ * Every one of those is "whatever happens to be at an end of the
+ * transcript", so a constraint stated in the MIDDLE of a conversation —
+ * "the account id is X, never bill a different one" — aged out at the same
+ * rate as chatter. The working-memory slot cannot express it either: that
+ * is host-rendered per turn and does not know what the user said.
+ *
+ * `retain` says it directly. The cost of the marker is paid by whoever
+ * sets it: pinned turns are exempt from the reclaim that keeps a long run
+ * alive, so pinning the whole history is a way to make compaction useless.
+ * Nothing here enforces a ceiling — a limit would have to guess which pin
+ * mattered, and dropping the wrong one silently is worse than the run
+ * overflowing loudly.
+ */
+const isAssistantWithCalls = (m) => m.role === 'assistant' && Array.isArray(m.toolCalls);
+/**
+ * Indices of every message protected by a `retain` marker, expanded across
+ * tool pairs.
+ *
+ * Transitive by necessity, not politeness. A `tool_result` whose
+ * `tool_use` was dropped is rejected by the provider outright, so pinning
+ * half a pair would turn a retention request into a broken next turn. So:
+ * a pinned tool result pulls in the assistant turn that issued the call,
+ * and a pinned assistant turn pulls in EVERY result answering it — the
+ * second hop matters, because an assistant turn with three calls and one
+ * surviving result is the same dangling error in the other direction.
+ */
+export function findRetainedIndices(messages) {
+    const retained = new Set();
+    for (let i = 0; i < messages.length; i++) {
+        if (messages[i]?.retain === true)
+            retained.add(i);
+    }
+    if (retained.size === 0)
+        return retained;
+    const assistantOfCall = new Map();
+    const resultsOfAssistant = new Map();
+    for (let i = 0; i < messages.length; i++) {
+        const message = messages[i];
+        if (!message || !isAssistantWithCalls(message))
+            continue;
+        for (const call of message.toolCalls ?? []) {
+            assistantOfCall.set(call.id, i);
+        }
+    }
+    for (let i = 0; i < messages.length; i++) {
+        const message = messages[i];
+        if (!message || message.role !== 'tool')
+            continue;
+        const owner = assistantOfCall.get(message.toolCallId);
+        if (owner === undefined)
+            continue;
+        const siblings = resultsOfAssistant.get(owner);
+        if (siblings)
+            siblings.push(i);
+        else
+            resultsOfAssistant.set(owner, [i]);
+    }
+    // Worklist rather than one pass: pulling in an assistant turn adds
+    // results that were not marked, and each of those would otherwise have
+    // to be re-examined by hand.
+    const pending = [...retained];
+    while (pending.length > 0) {
+        const index = pending.pop();
+        if (index === undefined)
+            continue;
+        const message = messages[index];
+        if (!message)
+            continue;
+        const add = (candidate) => {
+            if (candidate === undefined || retained.has(candidate))
+                return;
+            retained.add(candidate);
+            pending.push(candidate);
+        };
+        if (message.role === 'tool') {
+            add(assistantOfCall.get(message.toolCallId));
+        }
+        for (const sibling of resultsOfAssistant.get(index) ?? []) {
+            add(sibling);
+        }
+    }
+    return retained;
+}
+//# sourceMappingURL=retention.js.map

package/dist/compaction/retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.js","sourceRoot":"","sources":["../../src/compaction/retention.ts"],"names":[],"mappings":"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"}

package/dist/compaction/serializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../src/compaction/serializer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,YAAY,CAAA;AA0CxD,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CA4C1D"}
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../src/compaction/serializer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,YAAY,CAAA;AA2DxD,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CA0D1D"}

package/dist/compaction/serializer.js

@@ -24,11 +24,28 @@ function renderFiles(files) {
     }
     return lines.join('\n');
 }
-function renderList(items) {
-    return items.map((item) => `- ${item}`).join('\n');
+function renderList(items, evictedCount = 0) {
+    const lines = items.map((item) => `- ${item}`);
+    if (evictedCount > 0) {
+        // Say what is missing. A summary that presents a gap as complete is
+        // worse than one that admits the gap: the model reasons about a
+        // fragment as if it were the whole record.
+        const noun = evictedCount === 1 ? 'entry' : 'entries';
+        lines.push(`- _(${evictedCount} ${noun} dropped to stay within the state budget)_`);
+    }
+    return lines.join('\n');
 }
-function renderToolResults(results) {
-    return results.map((r) => `- **${r.tool}**: ${r.summary}`).join('\n');
+function renderToolResults(results, evictedCount = 0) {
+    const lines = results.map((r) => `- **${r.tool}**: ${r.summary}`);
+    if (evictedCount > 0) {
+        // The same admission every sibling section makes. This one counted
+        // its evictions and then rendered without them, so the section that
+        // carries the most volume was the only one presenting a fragment as
+        // the whole record.
+        const noun = evictedCount === 1 ? 'result' : 'results';
+        lines.push(`- _(${evictedCount} earlier tool ${noun} dropped to stay within the state budget)_`);
+    }
+    return lines.join('\n');
 }
 export function serializeState(state) {
     const sections = [];
@@ -36,31 +53,31 @@ export function serializeState(state) {
         sections.push(`${SECTION_HEADERS.task}\n\n${state.task}`);
     }
     if (state.userRequirements.length > 0) {
-        sections.push(`${SECTION_HEADERS.userRequirements}\n\n${renderList(state.userRequirements)}`);
+        sections.push(`${SECTION_HEADERS.userRequirements}\n\n${renderList(state.userRequirements, state.evicted.userRequirements)}`);
     }
     if (state.plan.length > 0) {
         sections.push(`${SECTION_HEADERS.plan}\n\n${renderPlan(state.plan)}`);
     }
     if (state.environment.length > 0) {
-        sections.push(`${SECTION_HEADERS.environment}\n\n${renderList(state.environment)}`);
+        sections.push(`${SECTION_HEADERS.environment}\n\n${renderList(state.environment, state.evicted.environment)}`);
     }
     if (state.files.size > 0) {
         sections.push(`${SECTION_HEADERS.files}\n\n${renderFiles(state.files)}`);
     }
     if (state.decisions.length > 0) {
-        sections.push(`${SECTION_HEADERS.decisions}\n\n${renderList(state.decisions)}`);
+        sections.push(`${SECTION_HEADERS.decisions}\n\n${renderList(state.decisions, state.evicted.decisions)}`);
     }
     if (state.assistantNotes.length > 0) {
-        sections.push(`${SECTION_HEADERS.assistantNotes}\n\n${renderList(state.assistantNotes)}`);
+        sections.push(`${SECTION_HEADERS.assistantNotes}\n\n${renderList(state.assistantNotes, state.evicted.assistantNotes)}`);
     }
     if (state.toolResults.length > 0) {
-        sections.push(`${SECTION_HEADERS.toolResults}\n\n${renderToolResults(state.toolResults)}`);
+        sections.push(`${SECTION_HEADERS.toolResults}\n\n${renderToolResults(state.toolResults, state.evicted.toolResults)}`);
     }
     if (state.failures.length > 0) {
-        sections.push(`${SECTION_HEADERS.failures}\n\n${renderList(state.failures)}`);
+        sections.push(`${SECTION_HEADERS.failures}\n\n${renderList(state.failures, state.evicted.failures)}`);
     }
     if (state.discoveries.length > 0) {
-        sections.push(`${SECTION_HEADERS.discoveries}\n\n${renderList(state.discoveries)}`);
+        sections.push(`${SECTION_HEADERS.discoveries}\n\n${renderList(state.discoveries, state.evicted.discoveries)}`);
     }
     return sections.join('\n\n');
 }

package/dist/compaction/serializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../src/compaction/serializer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../src/compaction/serializer.ts"],"names":[],"mappings":"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"}

package/dist/compaction/tool-result-editing.d.ts

@@ -0,0 +1,54 @@
+import type { Message } from '../types/message/index.js';
+/**
+ * Clear stale tool OUTPUT in place, without touching the conversation's
+ * shape.
+ *
+ * Compaction was all-or-nothing: once the threshold hit, every older
+ * message became a summary and the agent's own reasoning — the decisions,
+ * the false starts it learned from, the exact wording of a plan — was
+ * paraphrased away with it. That is a heavy price to pay for a context
+ * problem that is usually caused by something much dumber: a handful of
+ * enormous tool outputs the agent already read, extracted what it needed
+ * from, and moved past.
+ *
+ * Clearing those reclaims most of the same tokens while preserving every
+ * message verbatim. It is safe where trimming is not, because the `tool`
+ * message stays exactly where it is with the same `toolCallId` — so the
+ * `tool_use` ↔ `tool_result` pairing the providers require is untouched by
+ * construction. The placeholder tells the model what happened, so a result
+ * it turns out to still need is one tool call away rather than lost.
+ */
+export interface ToolResultEditConfig {
+    /**
+     * How many of the most recent tool results to leave alone. The agent is
+     * usually still working with these, and clearing them buys tokens by
+     * forcing an immediate re-read — a net loss.
+     */
+    readonly keepRecentToolResults?: number;
+    /**
+     * Don't bother clearing results smaller than this. Below it the
+     * placeholder is comparable in size to the output, so the churn buys
+     * nothing and costs the model a confusing hole in its history.
+     */
+    readonly minCharsToClear?: number;
+    /** Tools whose output is never cleared, by name. */
+    readonly preserveTools?: readonly string[];
+}
+export declare const DEFAULT_KEEP_RECENT_TOOL_RESULTS = 3;
+export declare const DEFAULT_MIN_CHARS_TO_CLEAR = 1000;
+export interface ToolResultEditOutcome {
+    readonly messages: Message[];
+    readonly clearedCount: number;
+    /** Characters removed from the model-visible history. */
+    readonly charsReclaimed: number;
+}
+export declare function isClearedToolResult(content: unknown): boolean;
+/**
+ * Replace the output of old, large tool results with a short placeholder.
+ *
+ * Returns a NEW array; the input is not mutated. `clearedCount === 0` means
+ * nothing was eligible, and the caller should fall through to whatever it
+ * would have done anyway.
+ */
+export declare function clearStaleToolResults(messages: readonly Message[], config?: ToolResultEditConfig): ToolResultEditOutcome;
+//# sourceMappingURL=tool-result-editing.d.ts.map

package/dist/compaction/tool-result-editing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-editing.d.ts","sourceRoot":"","sources":["../../src/compaction/tool-result-editing.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAgC,MAAM,2BAA2B,CAAA;AAGtF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IACvC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,oDAAoD;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1C;AAED,eAAO,MAAM,gCAAgC,IAAI,CAAA;AACjD,eAAO,MAAM,0BAA0B,OAAQ,CAAA;AAyE/C,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAC/B;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,MAAM,GAAE,oBAAyB,GAC/B,qBAAqB,CAyEvB"}

package/dist/compaction/tool-result-editing.js

@@ -0,0 +1,164 @@
+import { SPILL_MARKER } from '../runtime/query/tool-output-budget.js';
+import { toolResultToText } from '../types/message/content.js';
+import { findRetainedIndices } from './retention.js';
+export const DEFAULT_KEEP_RECENT_TOOL_RESULTS = 3;
+export const DEFAULT_MIN_CHARS_TO_CLEAR = 1_000;
+/** Marks a cleared result, and is how a second pass recognizes its own work. */
+const CLEARED_PREFIX = '[tool output cleared]';
+/**
+ * How much of the original result survives a clear, at each end.
+ *
+ * Small on purpose — the point of clearing is to reclaim context, and a
+ * generous keep defeats it. But zero was the wrong number: a result just
+ * over the minimum lost 100% of itself, including the three lines the
+ * agent was actively reasoning from, to reclaim a few hundred characters.
+ */
+const KEEP_HEAD_CHARS = 400;
+const KEEP_TAIL_CHARS = 200;
+/**
+ * Build the placeholder that replaces a cleared result.
+ *
+ * Two things survive, for two different reasons.
+ *
+ * The SPILL LINE, unconditionally: when a result was over the output
+ * budget its full text was written to disk and that line is the pointer
+ * back to it. Replacing the whole content destroyed the cheapest recovery
+ * route precisely for the largest results — and then told the model to
+ * call the tool again, which is advice to re-run something that returned
+ * megabytes. Keeping one line preserves a `read`/`grep` route worth far
+ * more than the line costs.
+ *
+ * A HEAD AND TAIL, because a result is not uniformly valuable: what a
+ * model needs from a long output is usually near one end, and keeping a
+ * few hundred characters of each is the difference between "I remember
+ * roughly what this said" and "call it again".
+ */
+function clearedPlaceholder(content, toolName, size) {
+    const text = typeof content === 'string' ? content : toolResultToText(content);
+    const parts = [
+        `${CLEARED_PREFIX} ${toolName} returned ${size.toLocaleString('en-US')} characters, cleared to reclaim context.`,
+    ];
+    const spillLine = text.split('\n').find((line) => line.startsWith(SPILL_MARKER));
+    if (spillLine) {
+        parts.push(spillLine, 'Read a window of it with `read` (offset/limit) or search it with `grep`.');
+    }
+    else {
+        parts.push('Call the tool again if you still need the rest.');
+    }
+    if (text.length > KEEP_HEAD_CHARS + KEEP_TAIL_CHARS) {
+        parts.push('', text.slice(0, KEEP_HEAD_CHARS), `… ${(text.length - KEEP_HEAD_CHARS - KEEP_TAIL_CHARS).toLocaleString('en-US')} characters elided …`, text.slice(-KEEP_TAIL_CHARS));
+    }
+    else {
+        // Shorter than what an elision would keep, so eliding it would drop
+        // content while saving nothing. A caller that lowered the minimum
+        // far enough to reach a result this small gets it back whole, and a
+        // truthful `charsReclaimed` of about zero — rather than a total loss
+        // dressed up as a saving.
+        parts.push('', text);
+    }
+    return parts.join('\n');
+}
+export function isClearedToolResult(content) {
+    return typeof content === 'string' && content.startsWith(CLEARED_PREFIX);
+}
+/**
+ * Replace the output of old, large tool results with a short placeholder.
+ *
+ * Returns a NEW array; the input is not mutated. `clearedCount === 0` means
+ * nothing was eligible, and the caller should fall through to whatever it
+ * would have done anyway.
+ */
+export function clearStaleToolResults(messages, config = {}) {
+    const keepRecent = Math.max(0, config.keepRecentToolResults ?? DEFAULT_KEEP_RECENT_TOOL_RESULTS);
+    const minChars = Math.max(0, config.minCharsToClear ?? DEFAULT_MIN_CHARS_TO_CLEAR);
+    const preserve = new Set(config.preserveTools ?? []);
+    // Which tool call produced which result, so a preserve-list can be
+    // written in terms of TOOL NAMES — the only handle a host actually has.
+    const toolNameByCallId = new Map();
+    for (const msg of messages) {
+        if (msg.role !== 'assistant' || !msg.toolCalls)
+            continue;
+        for (const call of msg.toolCalls) {
+            toolNameByCallId.set(call.id, call.function.name);
+        }
+    }
+    const toolIndices = [];
+    messages.forEach((msg, index) => {
+        if (msg.role === 'tool')
+            toolIndices.push(index);
+    });
+    // `slice(-0)` returns the WHOLE array, so a plain `slice(-keepRecent)`
+    // would protect EVERY result when the caller asked to protect none.
+    const protectedFromEnd = new Set(keepRecent === 0 ? [] : toolIndices.slice(-keepRecent));
+    // A pinned result is pinned against THIS too. Clearing keeps the message
+    // and replaces its content, which is exactly the loss `retain` was asked
+    // to prevent — a placeholder where the account id used to be reads as an
+    // answer, not as an omission.
+    const retained = findRetainedIndices(messages);
+    let clearedCount = 0;
+    let charsReclaimed = 0;
+    const edited = messages.map((msg, index) => {
+        if (msg.role !== 'tool')
+            return msg;
+        if (protectedFromEnd.has(index))
+            return msg;
+        if (retained.has(index))
+            return msg;
+        const tool = msg;
+        // An error result is small and it STEERS — it is the thing the model
+        // reads to decide what to do differently. Clearing it would reclaim
+        // nothing and remove the reason a later turn makes sense.
+        if (tool.isError)
+            return msg;
+        if (isClearedToolResult(tool.content))
+            return msg;
+        const toolName = toolNameByCallId.get(tool.toolCallId) ?? 'unknown';
+        if (preserve.has(toolName))
+            return msg;
+        const size = measureContent(tool.content);
+        if (size < minChars)
+            return msg;
+        clearedCount++;
+        charsReclaimed += size - 0;
+        return {
+            ...tool,
+            content: clearedPlaceholder(tool.content, toolName, size),
+        };
+    });
+    // Subtract what the placeholders themselves cost, so the number a
+    // caller uses to decide "was that enough?" is the real saving and not
+    // an overstatement.
+    if (clearedCount > 0) {
+        let placeholderChars = 0;
+        for (const msg of edited) {
+            if (msg.role === 'tool' && isClearedToolResult(msg.content)) {
+                placeholderChars += measureContent(msg.content);
+            }
+        }
+        charsReclaimed = Math.max(0, charsReclaimed - placeholderChars);
+    }
+    return { messages: edited, clearedCount, charsReclaimed };
+}
+/**
+ * Size of a tool result as the model sees it.
+ *
+ * An image block is measured by its base64 payload, which is the whole
+ * point: a screenshot is the single largest thing a tool result can carry,
+ * and it is exactly the kind of output an agent reads once and never
+ * needs again.
+ */
+function measureContent(content) {
+    if (typeof content === 'string')
+        return content.length;
+    if (!Array.isArray(content))
+        return 0;
+    let total = 0;
+    for (const block of content) {
+        if (block.type === 'text')
+            total += block.text.length;
+        else if (block.type === 'image')
+            total += block.data.length;
+    }
+    return total;
+}
+//# sourceMappingURL=tool-result-editing.js.map

package/dist/compaction/tool-result-editing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-editing.js","sourceRoot":"","sources":["../../src/compaction/tool-result-editing.ts"],"names":[],"mappings":"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"}

package/dist/compaction/types.d.ts

@@ -9,6 +9,16 @@ export interface WorkingState {
     toolResults: ToolResultSlot[];
     userRequirements: string[];
     assistantNotes: string[];
+    /**
+     * How many entries each capped list has dropped, keyed by slot name.
+     *
+     * The state that survives compaction is the only record of the history
+     * it replaced, so silently shrinking it is the one thing this structure
+     * must not do. Counting the loss lets the serializer say so, which is
+     * the difference between "here is the state" and "here is what is left
+     * of the state".
+     */
+    evicted: Record<string, number>;
 }
 export interface PlanSlot {
     id: string;

package/dist/compaction/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compaction/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,EAAE,CAAA;IAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,WAAW,EAAE,cAAc,EAAE,CAAA;IAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAA;CACjD;AAED,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,UAAU,EAAE,CAAA;CACrB;AAED,MAAM,MAAM,UAAU,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAErB,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,gBAAgB,GAAG,UAAU,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compaction/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,EAAE,CAAA;IAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,WAAW,EAAE,cAAc,EAAE,CAAA;IAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAA;CACjD;AAED,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,UAAU,EAAE,CAAA;CACrB;AAED,MAAM,MAAM,UAAU,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAErB,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,gBAAgB,GAAG,UAAU,CAAA"}

package/dist/compaction/verifier.d.ts

@@ -1,6 +1,25 @@
 import type { CompactionConfig } from '../config/runtime.js';
+import type { TokenUsage } from '../types/common/index.js';
 import type { Message } from '../types/message/index.js';
 import type { LLMProvider } from '../types/provider/interface.js';
 import type { WorkingStateManager } from './manager.js';
-export declare function buildVerifiedSummary(manager: WorkingStateManager, olderMessages: Message[], provider: LLMProvider, config: CompactionConfig): Promise<string>;
+/**
+ * Narrow sink for the tokens a side-channel model call spends.
+ *
+ * The verifier runs outside the iteration loop, so its usage never reached
+ * `runMgr.accumulateUsage` and the guard could not see it — and it fires
+ * exactly when the context is largest, making it the most expensive call
+ * the run does not count. A one-method sink keeps the compaction layer
+ * from depending on `RunPersistence`.
+ */
+export type UsageSink = (usage: TokenUsage) => void;
+export declare function buildVerifiedSummary(manager: WorkingStateManager, olderMessages: Message[], provider: LLMProvider, config: CompactionConfig, onUsage?: UsageSink, 
+/**
+ * The run's model. Required in practice: this used to send `model: ''`,
+ * which some drivers quietly default and others reject outright — on
+ * some backends the model id IS the endpoint. So compaction's verifier failed
+ * exactly on the providers where a long run most needs it, and the
+ * failure surfaced as compaction killing the run it exists to save.
+ */
+model?: string): Promise<string>;
 //# sourceMappingURL=verifier.d.ts.map

package/dist/compaction/verifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../src/compaction/verifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAwCvD,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,OAAO,EAAE,EACxB,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,MAAM,CAAC,CAqDjB"}
+{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../src/compaction/verifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAwCvD;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;AAEnD,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,OAAO,EAAE,EACxB,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,SAAS;AACnB;;;;;;GAMG;AACH,KAAK,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAuDjB"}

package/dist/compaction/verifier.js

@@ -32,7 +32,15 @@ function truncateMessages(messages, budget) {
     }
     return lines.join('\n\n');
 }
-export async function buildVerifiedSummary(manager, olderMessages, provider, config) {
+export async function buildVerifiedSummary(manager, olderMessages, provider, config, onUsage, 
+/**
+ * The run's model. Required in practice: this used to send `model: ''`,
+ * which some drivers quietly default and others reject outright — on
+ * some backends the model id IS the endpoint. So compaction's verifier failed
+ * exactly on the providers where a long run most needs it, and the
+ * failure surfaced as compaction killing the run it exists to save.
+ */
+model) {
     const serialized = serializeState(manager.getState());
     if (manager.slotCount() >= config.richStateThreshold) {
         return serialized;
@@ -55,11 +63,12 @@ export async function buildVerifiedSummary(manager, olderMessages, provider, con
         },
     ];
     const response = await collect(provider.chatStream({
-        model: '',
+        model: model ?? '',
         messages: verificationMessages,
         maxTokens: config.llmVerificationMaxTokens,
         temperature: 0,
     }));
+    onUsage?.(response.usage);
     const responseText = response.message.content?.trim() ?? '';
     // `COMPLETE` is the verifier saying it found nothing to add. An EMPTY reply
     // says the same thing by accident — a turn truncated at

package/dist/compaction/verifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"verifier.js","sourceRoot":"","sources":["../../src/compaction/verifier.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"verifier.js","sourceRoot":"","sources":["../../src/compaction/verifier.ts"],"names":[],"mappings":"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"}

package/dist/compaction/wire.d.ts

@@ -0,0 +1,54 @@
+import type { CompactionConfig } from '../config/runtime.js';
+import { WorkingStateManager } from './manager.js';
+import type { FileSlot, PlanSlot, ToolResultSlot } from './types.js';
+/**
+ * The working state in a form that survives a process boundary.
+ *
+ * Compaction replaces older history with a summary built from this state,
+ * and drops any PRIOR summary on the grounds that the new one supersedes
+ * it — `serializeState` is cumulative, so within one process that is true.
+ *
+ * Across a resume it was not. The manager was rebuilt empty on every
+ * `query()`, so the second compaction of a resumed run summarized only
+ * post-resume activity and deleted the summary that held everything
+ * before it. The restore path goes out of its way to carry that summary
+ * forward (it is the only surviving record of the history the first pass
+ * deleted) and the next pass destroyed it. Snapshotting the state onto the
+ * checkpoint is what makes "cumulative" true in the case that matters.
+ *
+ * A deliberate WIRE type rather than a structural alias of
+ * {@link WorkingState}: this lands in a persisted checkpoint, so `files`
+ * has to be an array rather than a `Map` (a `Map` JSON-serializes to
+ * `{}`), and the shape has to be able to change independently of the
+ * in-memory one.
+ */
+export interface WorkingStateSnapshot {
+    readonly task: string;
+    readonly plan: readonly PlanSlot[];
+    readonly files: readonly FileSlot[];
+    readonly decisions: readonly string[];
+    readonly failures: readonly string[];
+    readonly discoveries: readonly string[];
+    readonly environment: readonly string[];
+    readonly toolResults: readonly ToolResultSlot[];
+    readonly userRequirements: readonly string[];
+    readonly assistantNotes: readonly string[];
+    /**
+     * Per-slot drop counts. These MUST survive: the serializer reports them,
+     * and a resumed summary that forgot what it had already lost would claim
+     * completeness it does not have.
+     */
+    readonly evicted: Readonly<Record<string, number>>;
+}
+export declare function snapshotWorkingState(manager: WorkingStateManager): WorkingStateSnapshot;
+/**
+ * Rebuild a manager from a snapshot.
+ *
+ * Restores the state DIRECTLY rather than replaying the extractors over
+ * the restored messages. Re-extraction would be both lossy — the messages
+ * the first pass compacted away are gone, so there is nothing left to
+ * extract them from — and non-idempotent, producing a state that differs
+ * from the one that was summarized.
+ */
+export declare function restoreWorkingState(snapshot: WorkingStateSnapshot, config: CompactionConfig): WorkingStateManager;
+//# sourceMappingURL=wire.d.ts.map