@namzu/sdk 34.2.0 → 36.0.0

package/dist/compaction/serializer.js

@@ -47,6 +47,18 @@ function renderToolResults(results, evictedCount = 0) {
     }
     return lines.join('\n');
 }
+/** The pinned-facts section alone, or null when nothing is pinned. */
+export function renderPins(state) {
+    const pins = state.pins ? [...state.pins.values()] : [];
+    if (pins.length === 0)
+        return null;
+    const lines = pins.map((p) => `- **${p.key}**: ${p.text} _(${p.source})_`);
+    const dropped = state.evicted.pins ?? 0;
+    if (dropped > 0) {
+        lines.push(`- _(${dropped} older ${dropped === 1 ? 'pin' : 'pins'} dropped to stay within the pin budget)_`);
+    }
+    return `${SECTION_HEADERS.pins}\n\n${lines.join('\n')}`;
+}
 export function serializeState(state) {
     const sections = [];
     if (state.task) {
@@ -58,6 +70,9 @@ export function serializeState(state) {
     if (state.plan.length > 0) {
         sections.push(`${SECTION_HEADERS.plan}\n\n${renderPlan(state.plan)}`);
     }
+    const pinned = renderPins(state);
+    if (pinned)
+        sections.push(pinned);
     if (state.environment.length > 0) {
         sections.push(`${SECTION_HEADERS.environment}\n\n${renderList(state.environment, state.evicted.environment)}`);
     }

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/token-estimate.d.ts

@@ -0,0 +1,13 @@
+import type { Message } from '../types/message/index.js';
+/**
+ * Provider-neutral prompt estimate shared by triggers, retention and eviction.
+ *
+ * Text and tool inputs use the existing characters-per-token approximation.
+ * Images and documents have an explicit allowance independent of compression
+ * and of whether the bytes are inline or stored externally. Without dimensions,
+ * page counts and a provider tokenizer their exact cost is unknown. In
+ * particular, serialized base64 is never treated as model-visible prose.
+ */
+export declare function estimateMessageTokens(message: Message): number;
+export declare function estimateMessagesTokens(messages: readonly Message[]): number;
+//# sourceMappingURL=token-estimate.d.ts.map

package/dist/compaction/token-estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimate.d.ts","sourceRoot":"","sources":["../../src/compaction/token-estimate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAsC,MAAM,2BAA2B,CAAA;AAe5F;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CA2B9D;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAE3E"}

package/dist/compaction/token-estimate.js

@@ -0,0 +1,58 @@
+import { CHARS_PER_TOKEN } from '../constants/limits.js';
+// Heuristic allowances, not provider billing formulas or upper bounds. Encoded
+// byte length depends on compression, not the number of visual tokens. The
+// provider's measured prompt usage replaces these guesses after the next call.
+const IMAGE_TOKENS = 1_024;
+const DOCUMENT_TOKENS = 4_096;
+const OMITTED_IMAGE_TOKENS = 64;
+function richTokens(block) {
+    if (block.type === 'stored')
+        return block.kind === 'image' ? IMAGE_TOKENS : DOCUMENT_TOKENS;
+    if (block.type === 'document')
+        return DOCUMENT_TOKENS;
+    return block.modelOmission ? OMITTED_IMAGE_TOKENS : IMAGE_TOKENS;
+}
+/**
+ * Provider-neutral prompt estimate shared by triggers, retention and eviction.
+ *
+ * Text and tool inputs use the existing characters-per-token approximation.
+ * Images and documents have an explicit allowance independent of compression
+ * and of whether the bytes are inline or stored externally. Without dimensions,
+ * page counts and a provider tokenizer their exact cost is unknown. In
+ * particular, serialized base64 is never treated as model-visible prose.
+ */
+export function estimateMessageTokens(message) {
+    let chars = 0;
+    let rich = 0;
+    if (typeof message.content === 'string')
+        chars += message.content.length;
+    else if (message.content) {
+        for (const block of message.content) {
+            if (block.type === 'text')
+                chars += block.text.length;
+            else {
+                rich += richTokens(block);
+                if (block.type === 'document')
+                    chars += block.name?.length ?? 0;
+            }
+        }
+    }
+    if (message.role === 'assistant') {
+        for (const call of message.toolCalls ?? []) {
+            chars += call.function.name.length + call.function.arguments.length;
+        }
+    }
+    if (message.role === 'user') {
+        for (const attachment of message.attachments ?? []) {
+            rich += richTokens(attachment);
+            if (attachment.type === 'document' || attachment.type === 'stored') {
+                chars += attachment.name?.length ?? 0;
+            }
+        }
+    }
+    return Math.ceil(chars / CHARS_PER_TOKEN) + rich;
+}
+export function estimateMessagesTokens(messages) {
+    return messages.reduce((total, message) => total + estimateMessageTokens(message), 0);
+}
+//# sourceMappingURL=token-estimate.js.map

package/dist/compaction/token-estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimate.js","sourceRoot":"","sources":["../../src/compaction/token-estimate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAGxD,+EAA+E;AAC/E,2EAA2E;AAC3E,+EAA+E;AAC/E,MAAM,YAAY,GAAG,KAAK,CAAA;AAC1B,MAAM,eAAe,GAAG,KAAK,CAAA;AAC7B,MAAM,oBAAoB,GAAG,EAAE,CAAA;AAE/B,SAAS,UAAU,CAAC,KAAqE;IACxF,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,CAAA;IAC3F,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,eAAe,CAAA;IACrD,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,YAAY,CAAA;AACjE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACrD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QAAE,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAA;SACnE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;gBAAE,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAA;iBAChD,CAAC;gBACL,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;gBACzB,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;oBAAE,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAA;YAChE,CAAC;QACF,CAAC;IACF,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YAC5C,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAA;QACpE,CAAC;IACF,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC7B,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;YACpD,IAAI,IAAI,UAAU,CAAC,UAAU,CAAC,CAAA;YAC9B,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpE,KAAK,IAAI,UAAU,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAA;YACtC,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,GAAG,IAAI,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAA4B;IAClE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;AACtF,CAAC"}

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

@@ -1,4 +1,4 @@
-import type { Message } from '../types/message/index.js';
+import type { Message, ToolMessage } from '../types/message/index.js';
 /**
  * Clear stale tool OUTPUT in place, without touching the conversation's
  * shape.
@@ -39,9 +39,17 @@ 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. */
+    /** Payload characters removed, including encoded data; not a token estimate. */
     readonly charsReclaimed: number;
 }
+/**
+ * One result cleared on its own, for a caller that chose it by some
+ * other rule than staleness. The same placeholder, the same accounting.
+ */
+export declare function clearToolResult(tool: ToolMessage, toolName: string): {
+    readonly message: ToolMessage;
+    readonly charsReclaimed: number;
+};
 export declare function isClearedToolResult(content: unknown): boolean;
 /**
  * Replace the output of old, large tool results with a short placeholder.

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

@@ -1 +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"}
+{"version":3,"file":"tool-result-editing.d.ts","sourceRoot":"","sources":["../../src/compaction/tool-result-editing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAmB,MAAM,2BAA2B,CAAA;AAItF;;;;;;;;;;;;;;;;;;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;AA2E/C,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAC/B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,GACd;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAIpE;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,CA8DvB"}

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

@@ -1,6 +1,8 @@
+import { CHARS_PER_TOKEN } from '../constants/limits.js';
 import { SPILL_MARKER } from '../runtime/query/tool-output-budget.js';
 import { toolResultToText } from '../types/message/content.js';
 import { findRetainedIndices } from './retention.js';
+import { estimateMessageTokens } from './token-estimate.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. */
@@ -43,7 +45,7 @@ function clearedPlaceholder(content, toolName, size) {
         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.');
+        parts.push('Full result unavailable here. Recover from a saved artifact or a read-only observation; do not repeat a state-changing action to recover its output.');
     }
     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));
@@ -58,6 +60,15 @@ function clearedPlaceholder(content, toolName, size) {
     }
     return parts.join('\n');
 }
+/**
+ * One result cleared on its own, for a caller that chose it by some
+ * other rule than staleness. The same placeholder, the same accounting.
+ */
+export function clearToolResult(tool, toolName) {
+    const size = measureContent(tool.content);
+    const content = clearedPlaceholder(tool.content, toolName, size);
+    return { message: { ...tool, content }, charsReclaimed: Math.max(0, size - content.length) };
+}
 export function isClearedToolResult(content) {
     return typeof content === 'string' && content.startsWith(CLEARED_PREFIX);
 }
@@ -116,36 +127,23 @@ export function clearStaleToolResults(messages, config = {}) {
         if (preserve.has(toolName))
             return msg;
         const size = measureContent(tool.content);
-        if (size < minChars)
+        if (estimateMessageTokens(tool) * CHARS_PER_TOKEN < minChars)
+            return msg;
+        const content = clearedPlaceholder(tool.content, toolName, size);
+        if (estimateMessageTokens({ ...tool, content }) >= estimateMessageTokens(tool))
             return msg;
         clearedCount++;
-        charsReclaimed += size - 0;
+        charsReclaimed += size - content.length;
         return {
             ...tool,
-            content: clearedPlaceholder(tool.content, toolName, size),
+            content,
         };
     });
-    // 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 };
+    return { messages: edited, clearedCount, charsReclaimed: Math.max(0, 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.
+ * Payload character count for storage telemetry. Encoded image length is
+ * independent of visual token cost; context decisions use the shared estimate.
  */
 function measureContent(content) {
     if (typeof content === 'string')
@@ -156,7 +154,7 @@ function measureContent(content) {
     for (const block of content) {
         if (block.type === 'text')
             total += block.text.length;
-        else if (block.type === 'image')
+        else if (block.type === 'image' || block.type === 'document')
             total += block.data.length;
     }
     return total;

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

@@ -1 +1 @@
-{"version":3,"file":"tool-result-editing.js","sourceRoot":"","sources":["../../src/compaction/tool-result-editing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAE9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAsCpD,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAA;AACjD,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAA;AAE/C,gFAAgF;AAChF,MAAM,cAAc,GAAG,uBAAuB,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,eAAe,GAAG,GAAG,CAAA;AAC3B,MAAM,eAAe,GAAG,GAAG,CAAA;AAE3B;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,kBAAkB,CAC1B,OAA+B,EAC/B,QAAgB,EAChB,IAAY;IAEZ,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAC9E,MAAM,KAAK,GAAa;QACvB,GAAG,cAAc,IAAI,QAAQ,aAAa,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,0CAA0C;KAChH,CAAA;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAA;IAChF,IAAI,SAAS,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CACT,SAAS,EACT,0EAA0E,CAC1E,CAAA;IACF,CAAC;SAAM,CAAC;QACP,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAA;IAC9D,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,GAAG,eAAe,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CACT,EAAE,EACF,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,EAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,eAAe,GAAG,eAAe,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,sBAAsB,EACpG,IAAI,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,CAC5B,CAAA;IACF,CAAC;SAAM,CAAC;QACP,oEAAoE;QACpE,kEAAkE;QAClE,oEAAoE;QACpE,qEAAqE;QACrE,0BAA0B;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IACrB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC;AASD,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IACnD,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;AACzE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACpC,QAA4B,EAC5B,SAA+B,EAAE;IAEjC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,qBAAqB,IAAI,gCAAgC,CAAC,CAAA;IAChG,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,eAAe,IAAI,0BAA0B,CAAC,CAAA;IAClF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAA;IAEpD,mEAAmE;IACnE,wEAAwE;IACxE,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAA;IAClD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,SAAS;YAAE,SAAQ;QACxD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YAClC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAClD,CAAC;IACF,CAAC;IAED,MAAM,WAAW,GAAa,EAAE,CAAA;IAChC,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;YAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,uEAAuE;IACvE,oEAAoE;IACpE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;IAExF,yEAAyE;IACzE,yEAAyE;IACzE,yEAAyE;IACzE,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAE9C,IAAI,YAAY,GAAG,CAAC,CAAA;IACpB,IAAI,cAAc,GAAG,CAAC,CAAA;IAEtB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC1C,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,GAAG,CAAA;QACnC,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,CAAA;QAC3C,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,CAAA;QAEnC,MAAM,IAAI,GAAG,GAAkB,CAAA;QAC/B,qEAAqE;QACrE,oEAAoE;QACpE,0DAA0D;QAC1D,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,GAAG,CAAA;QAC5B,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,GAAG,CAAA;QAEjD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,SAAS,CAAA;QACnE,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,GAAG,CAAA;QAEtC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACzC,IAAI,IAAI,GAAG,QAAQ;YAAE,OAAO,GAAG,CAAA;QAE/B,YAAY,EAAE,CAAA;QACd,cAAc,IAAI,IAAI,GAAG,CAAC,CAAA;QAC1B,OAAO;YACN,GAAG,IAAI;YACP,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC;SACnC,CAAA;IACxB,CAAC,CAAC,CAAA;IAEF,kEAAkE;IAClE,sEAAsE;IACtE,oBAAoB;IACpB,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,gBAAgB,GAAG,CAAC,CAAA;QACxB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YAC1B,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7D,gBAAgB,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YAChD,CAAC;QACF,CAAC;QACD,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAAC,CAAA;IAChE,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,CAAA;AAC1D,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,OAA+B;IACtD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,MAAM,CAAA;IACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAA;IACrC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,KAAK,IAAI,OAAqC,EAAE,CAAC;QAC3D,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAA;aAChD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAA;IAC5D,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC"}
+{"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

@@ -1,6 +1,15 @@
 export interface WorkingState {
     task: string;
     plan: PlanSlot[];
+    /**
+     * Facts pinned by tools, by key. A tool that knows something the model
+     * must not lose — what its controls do, where the piece is, what has
+     * already failed — pins it with a key, and a later pin under the same
+     * key replaces it. Pins live in the working-memory slot, so they are in
+     * front of the model every iteration and survive compaction; the
+     * rule-based extractor below only guesses, a pin is stated.
+     */
+    pins: Map<string, PinSlot>;
     files: Map<string, FileSlot>;
     decisions: string[];
     failures: string[];
@@ -20,6 +29,18 @@ export interface WorkingState {
      */
     evicted: Record<string, number>;
 }
+export interface PinSlot {
+    key: string;
+    text: string;
+    /** The tool that pinned it. */
+    source: string;
+    updatedAt: number;
+}
+/** What a tool result carries to pin a fact; see `ToolResult.workingState`. */
+export interface WorkingStatePin {
+    readonly key: string;
+    readonly text: string;
+}
 export interface PlanSlot {
     id: string;
     label: string;
@@ -46,5 +67,5 @@ export interface ToolResultSlot {
     summary: string;
     timestamp: number;
 }
-export type CompactionStrategy = 'structured' | 'sliding-window' | 'disabled';
+export type CompactionStrategy = 'structured' | 'salience' | 'sliding-window' | 'disabled';
 //# sourceMappingURL=types.d.ts.map

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;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"}
+{"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;;;;;;;OAOG;IACH,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC1B,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,OAAO;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CACjB;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACrB;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,UAAU,GAAG,gBAAgB,GAAG,UAAU,CAAA"}

package/dist/compaction/wire.d.ts

@@ -1,6 +1,6 @@
 import type { CompactionConfig } from '../config/runtime.js';
 import { WorkingStateManager } from './manager.js';
-import type { FileSlot, PlanSlot, ToolResultSlot } from './types.js';
+import type { FileSlot, PinSlot, PlanSlot, ToolResultSlot } from './types.js';
 /**
  * The working state in a form that survives a process boundary.
  *
@@ -25,6 +25,8 @@ import type { FileSlot, PlanSlot, ToolResultSlot } from './types.js';
 export interface WorkingStateSnapshot {
     readonly task: string;
     readonly plan: readonly PlanSlot[];
+    /** Absent in snapshots written before pins existed; restored as none. */
+    readonly pins?: readonly PinSlot[];
     readonly files: readonly FileSlot[];
     readonly decisions: readonly string[];
     readonly failures: readonly string[];

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

@@ -1 +1 @@
-{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/compaction/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAA;AAElF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAA;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAClD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB,CAevF;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,gBAAgB,GACtB,mBAAmB,CAiBrB"}
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/compaction/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAA;AAE3F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAA;IAClC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAA;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAClD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB,CAgBvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,gBAAgB,GACtB,mBAAmB,CAkBrB"}

package/dist/compaction/wire.js

@@ -4,6 +4,7 @@ export function snapshotWorkingState(manager) {
     return {
         task: state.task,
         plan: [...state.plan],
+        pins: [...(state.pins?.values() ?? [])],
         files: [...state.files.values()],
         decisions: [...state.decisions],
         failures: [...state.failures],
@@ -29,6 +30,7 @@ export function restoreWorkingState(snapshot, config) {
     const state = {
         task: snapshot.task,
         plan: [...snapshot.plan],
+        pins: new Map((snapshot.pins ?? []).map((p) => [p.key, p])),
         files: new Map(snapshot.files.map((f) => [f.path, f])),
         decisions: [...snapshot.decisions],
         failures: [...snapshot.failures],

package/dist/compaction/wire.js.map

@@ -1 +1 @@
-{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../src/compaction/wire.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AA2ClD,MAAM,UAAU,oBAAoB,CAAC,OAA4B;IAChE,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;IAChC,OAAO;QACN,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;QACrB,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAChC,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QAC/B,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC7B,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;QACnC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;QACnC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;QACnC,gBAAgB,EAAE,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC;QAC7C,cAAc,EAAE,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC;QACzC,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE;KAC7B,CAAA;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAClC,QAA8B,EAC9B,MAAwB;IAExB,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAC/C,MAAM,KAAK,GAAiB;QAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;QACxB,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACtD,SAAS,EAAE,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC;QAClC,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAChC,WAAW,EAAE,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC;QACtC,WAAW,EAAE,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC;QACtC,WAAW,EAAE,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC;QACtC,gBAAgB,EAAE,CAAC,GAAG,QAAQ,CAAC,gBAAgB,CAAC;QAChD,cAAc,EAAE,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC;QAC5C,OAAO,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE;KAChC,CAAA;IACD,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;IAC3B,OAAO,OAAO,CAAA;AACf,CAAC"}
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../src/compaction/wire.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AA6ClD,MAAM,UAAU,oBAAoB,CAAC,OAA4B;IAChE,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;IAChC,OAAO;QACN,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;QACrB,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAChC,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QAC/B,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC7B,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;QACnC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;QACnC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;QACnC,gBAAgB,EAAE,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC;QAC7C,cAAc,EAAE,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC;QACzC,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE;KAC7B,CAAA;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAClC,QAA8B,EAC9B,MAAwB;IAExB,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAC/C,MAAM,KAAK,GAAiB;QAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;QACxB,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACtD,SAAS,EAAE,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC;QAClC,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAChC,WAAW,EAAE,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC;QACtC,WAAW,EAAE,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC;QACtC,WAAW,EAAE,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC;QACtC,gBAAgB,EAAE,CAAC,GAAG,QAAQ,CAAC,gBAAgB,CAAC;QAChD,cAAc,EAAE,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC;QAC5C,OAAO,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE;KAChC,CAAA;IACD,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;IAC3B,OAAO,OAAO,CAAA;AACf,CAAC"}

package/dist/config/runtime.d.ts

@@ -27,7 +27,19 @@ export declare const TaskRouterConfigSchema: z.ZodOptional<z.ZodObject<{
     planning?: string | null | undefined;
 }>>;
 export declare const CompactionConfigSchema: z.ZodObject<{
-    strategy: z.ZodDefault<z.ZodEnum<["structured", "sliding-window", "disabled"]>>;
+    /**
+     * `salience` is the default: every message scored without a model, the
+     * context held from half the window. `structured` is the previous
+     * default — positional retention, a pass only at the trigger — and one
+     * word away for a host that wants it back.
+     */
+    strategy: z.ZodDefault<z.ZodEnum<["structured", "salience", "sliding-window", "disabled"]>>;
+    /**
+     * `salience` only: the fraction of the window at which the working-set
+     * pass starts evicting low-salience messages, well before
+     * `triggerThreshold` summarises. The context is held around here.
+     */
+    softTarget: z.ZodOptional<z.ZodNumber>;
     /**
      * Optional model context-window size (tokens) the compaction trigger
      * measures the CURRENT window against. NO default: when omitted the
@@ -130,7 +142,7 @@ export declare const CompactionConfigSchema: z.ZodObject<{
     maxCharsPerRequirement: z.ZodDefault<z.ZodNumber>;
     maxCharsPerTask: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    strategy: "structured" | "sliding-window" | "disabled";
+    strategy: "structured" | "salience" | "sliding-window" | "disabled";
     triggerThreshold: number;
     resetThreshold: number;
     keepRecentMessages: number;
@@ -149,11 +161,13 @@ export declare const CompactionConfigSchema: z.ZodObject<{
     maxCharsPerNote: number;
     maxCharsPerRequirement: number;
     maxCharsPerTask: number;
+    softTarget?: number | undefined;
     contextWindowTokens?: number | undefined;
     keepRecentTokens?: number | undefined;
     preserveToolResultsFrom?: string[] | undefined;
 }, {
-    strategy?: "structured" | "sliding-window" | "disabled" | undefined;
+    strategy?: "structured" | "salience" | "sliding-window" | "disabled" | undefined;
+    softTarget?: number | undefined;
     contextWindowTokens?: number | undefined;
     triggerThreshold?: number | undefined;
     resetThreshold?: number | undefined;
@@ -260,7 +274,19 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
         planning?: string | null | undefined;
     }>>;
     compaction: z.ZodDefault<z.ZodObject<{
-        strategy: z.ZodDefault<z.ZodEnum<["structured", "sliding-window", "disabled"]>>;
+        /**
+         * `salience` is the default: every message scored without a model, the
+         * context held from half the window. `structured` is the previous
+         * default — positional retention, a pass only at the trigger — and one
+         * word away for a host that wants it back.
+         */
+        strategy: z.ZodDefault<z.ZodEnum<["structured", "salience", "sliding-window", "disabled"]>>;
+        /**
+         * `salience` only: the fraction of the window at which the working-set
+         * pass starts evicting low-salience messages, well before
+         * `triggerThreshold` summarises. The context is held around here.
+         */
+        softTarget: z.ZodOptional<z.ZodNumber>;
         /**
          * Optional model context-window size (tokens) the compaction trigger
          * measures the CURRENT window against. NO default: when omitted the
@@ -363,7 +389,7 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
         maxCharsPerRequirement: z.ZodDefault<z.ZodNumber>;
         maxCharsPerTask: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        strategy: "structured" | "sliding-window" | "disabled";
+        strategy: "structured" | "salience" | "sliding-window" | "disabled";
         triggerThreshold: number;
         resetThreshold: number;
         keepRecentMessages: number;
@@ -382,11 +408,13 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
         maxCharsPerNote: number;
         maxCharsPerRequirement: number;
         maxCharsPerTask: number;
+        softTarget?: number | undefined;
         contextWindowTokens?: number | undefined;
         keepRecentTokens?: number | undefined;
         preserveToolResultsFrom?: string[] | undefined;
     }, {
-        strategy?: "structured" | "sliding-window" | "disabled" | undefined;
+        strategy?: "structured" | "salience" | "sliding-window" | "disabled" | undefined;
+        softTarget?: number | undefined;
         contextWindowTokens?: number | undefined;
         triggerThreshold?: number | undefined;
         resetThreshold?: number | undefined;
@@ -456,27 +484,27 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
         requireIsolation: z.ZodDefault<z.ZodArray<z.ZodEnum<["filesystem", "network", "process"]>, "many">>;
         workspace: z.ZodDefault<z.ZodEnum<["ephemeral", "working-directory"]>>;
     }, "strip", z.ZodTypeAny, {
+        workspace: "ephemeral" | "working-directory";
         enabled: boolean;
         provider: "local";
         timeoutMs: number;
         memoryLimitMb: number;
         maxProcesses: number;
         requireIsolation: ("network" | "filesystem" | "process")[];
-        workspace: "ephemeral" | "working-directory";
     }, {
+        workspace?: "ephemeral" | "working-directory" | undefined;
         enabled?: boolean | undefined;
         provider?: "local" | undefined;
         timeoutMs?: number | undefined;
         memoryLimitMb?: number | undefined;
         maxProcesses?: number | undefined;
         requireIsolation?: ("network" | "filesystem" | "process")[] | undefined;
-        workspace?: "ephemeral" | "working-directory" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     model: string;
     timeoutMs: number;
     compaction: {
-        strategy: "structured" | "sliding-window" | "disabled";
+        strategy: "structured" | "salience" | "sliding-window" | "disabled";
         triggerThreshold: number;
         resetThreshold: number;
         keepRecentMessages: number;
@@ -495,6 +523,7 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
         maxCharsPerNote: number;
         maxCharsPerRequirement: number;
         maxCharsPerTask: number;
+        softTarget?: number | undefined;
         contextWindowTokens?: number | undefined;
         keepRecentTokens?: number | undefined;
         preserveToolResultsFrom?: string[] | undefined;
@@ -503,6 +532,15 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
     tokenBudget: number;
     maxResponseTokens: number;
     maxIterations: number;
+    sandbox?: {
+        workspace: "ephemeral" | "working-directory";
+        enabled: boolean;
+        provider: "local";
+        timeoutMs: number;
+        memoryLimitMb: number;
+        maxProcesses: number;
+        requireIsolation: ("network" | "filesystem" | "process")[];
+    } | undefined;
     taskRouter?: {
         default?: string | null | undefined;
         compaction?: string | null | undefined;
@@ -526,20 +564,21 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
         allowedScopes: ("user" | "project")[];
         hookTimeoutMs: number;
     } | undefined;
-    sandbox?: {
-        enabled: boolean;
-        provider: "local";
-        timeoutMs: number;
-        memoryLimitMb: number;
-        maxProcesses: number;
-        requireIsolation: ("network" | "filesystem" | "process")[];
-        workspace: "ephemeral" | "working-directory";
-    } | undefined;
 }, {
     model?: string | undefined;
+    sandbox?: {
+        workspace?: "ephemeral" | "working-directory" | undefined;
+        enabled?: boolean | undefined;
+        provider?: "local" | undefined;
+        timeoutMs?: number | undefined;
+        memoryLimitMb?: number | undefined;
+        maxProcesses?: number | undefined;
+        requireIsolation?: ("network" | "filesystem" | "process")[] | undefined;
+    } | undefined;
     timeoutMs?: number | undefined;
     compaction?: {
-        strategy?: "structured" | "sliding-window" | "disabled" | undefined;
+        strategy?: "structured" | "salience" | "sliding-window" | "disabled" | undefined;
+        softTarget?: number | undefined;
         contextWindowTokens?: number | undefined;
         triggerThreshold?: number | undefined;
         resetThreshold?: number | undefined;
@@ -589,15 +628,6 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
         allowedScopes?: ("user" | "project")[] | undefined;
         hookTimeoutMs?: number | undefined;
     } | undefined;
-    sandbox?: {
-        enabled?: boolean | undefined;
-        provider?: "local" | undefined;
-        timeoutMs?: number | undefined;
-        memoryLimitMb?: number | undefined;
-        maxProcesses?: number | undefined;
-        requireIsolation?: ("network" | "filesystem" | "process")[] | undefined;
-        workspace?: "ephemeral" | "working-directory" | undefined;
-    } | undefined;
 }>;
 export type RuntimeConfig = z.infer<typeof RuntimeConfigSchema>;
 export declare const RUNTIME_DEFAULTS: Readonly<RuntimeConfig>;

package/dist/config/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/config/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAE/D,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAE9B,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;GAUvB,CAAA;AAEZ,eAAO,MAAM,sBAAsB;;IAElC;;;;;;;OAOG;;IAEH,uEAAuE;;IAEvE;;;;;;;;;;;;;OAaG;;;IAGH;;;;;;;;;;;;;OAaG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAEH;;;;;;;;;;OAUG;;IAEH,kFAAkF;;IAElF;;;;OAIG;;IAEH,oDAAoD;;;;IAKpD;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUF,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAO/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,uBAAuB;;;;;;;;;EAGlC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QApI/B;;;;;;;WAOG;;QAEH,uEAAuE;;QAEvE;;;;;;;;;;;;;WAaG;;;QAGH;;;;;;;;;;;;;WAaG;;QAGH;;;;;;;;;;;;;;;;WAgBG;;QAEH;;;;;;;;;;WAUG;;QAEH,kFAAkF;;QAElF;;;;WAIG;;QAEH,oDAAoD;;;;QAKpD;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDF,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,aAAa,CAAiC,CAAA"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/config/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAE/D,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAE9B,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;GAUvB,CAAA;AAEZ,eAAO,MAAM,sBAAsB;IAClC;;;;;OAKG;;IAEH;;;;OAIG;;IAEH;;;;;;;OAOG;;IAEH,uEAAuE;;IAEvE;;;;;;;;;;;;;OAaG;;;IAGH;;;;;;;;;;;;;OAaG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAEH;;;;;;;;;;OAUG;;IAEH,kFAAkF;;IAElF;;;;OAIG;;IAEH,oDAAoD;;;;IAKpD;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUF,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAO/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,uBAAuB;;;;;;;;;EAGlC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAjJ/B;;;;;WAKG;;QAEH;;;;WAIG;;QAEH;;;;;;;WAOG;;QAEH,uEAAuE;;QAEvE;;;;;;;;;;;;;WAaG;;;QAGH;;;;;;;;;;;;;WAaG;;QAGH;;;;;;;;;;;;;;;;WAgBG;;QAEH;;;;;;;;;;WAUG;;QAEH,kFAAkF;;QAElF;;;;WAIG;;QAEH,oDAAoD;;;;QAKpD;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDF,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,aAAa,CAAiC,CAAA"}

package/dist/config/runtime.js

@@ -14,7 +14,19 @@ export const TaskRouterConfigSchema = z
 })
     .optional();
 export const CompactionConfigSchema = z.object({
-    strategy: z.enum(['structured', 'sliding-window', 'disabled']).default('structured'),
+    /**
+     * `salience` is the default: every message scored without a model, the
+     * context held from half the window. `structured` is the previous
+     * default — positional retention, a pass only at the trigger — and one
+     * word away for a host that wants it back.
+     */
+    strategy: z.enum(['structured', 'salience', 'sliding-window', 'disabled']).default('salience'),
+    /**
+     * `salience` only: the fraction of the window at which the working-set
+     * pass starts evicting low-salience messages, well before
+     * `triggerThreshold` summarises. The context is held around here.
+     */
+    softTarget: z.number().min(0).max(1).optional(),
     /**
      * Optional model context-window size (tokens) the compaction trigger
      * measures the CURRENT window against. NO default: when omitted the