@dsh-cc/context-crusher 0.7.1 → 0.8.0-rc.2

package/lib/defer/swap.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The deferred swap pass (design §3.3): one non-awaiting critical section
+ * per eligible entry, executed at the `agent/pre-step` boundary. Mirrors the
+ * microcompact replacement shape exactly (compaction-micro index.ts
+ * 270-295): a `compaction/prune` shadow-price row debiting the token meter,
+ * immediately followed by the `tool/result` replacement carrying
+ * `surfaceOp: replace` + `sourceEventSeqs`, with every non-content field of
+ * the original block preserved.
+ *
+ * Staleness is re-checked against the live surface inside the same section
+ * (locate by callId — the sole locator — then byte-equality of the body), so
+ * an in-flight request or a microcompact pass cannot interleave with a swap.
+ *
+ * @module @dsh-cc/context-crusher/defer/swap
+ */
+import type { Message } from '@deepseek-ai/dsh-llm';
+import type { Session, SessionEvent, SessionSeq } from '@deepseek-ai/dsh-session';
+import type { DeferGateFacts, ResidentEntry } from './residents.ts';
+export interface SwapInput {
+    readonly session: Session;
+    readonly entry: ResidentEntry;
+    /** Stored original full text (fetched BEFORE the critical section). */
+    readonly fullText: string;
+    /** Standard compressed body + `buildMarker(...)` trailer. */
+    readonly stubText: string;
+    /** `false` in dry-run: evaluate everything, append nothing (§3.6). */
+    readonly apply: boolean;
+    readonly margin: number;
+    readonly remainingRequestsEstimate: number;
+    readonly urgencyTokens?: number;
+    readonly sessionTokens?: number;
+    readonly contextWindow?: number;
+    readonly estimateMessage: (message: Message) => number;
+}
+export type SwapResult = {
+    readonly outcome: 'applied' | 'dry-run' | 'gate-failed';
+    readonly gate: DeferGateFacts;
+} | {
+    readonly outcome: 'stale';
+};
+/** Locate the current surface `tool/result` event by callId (sole locator). */
+export declare function locateResultEvent(session: Session, callId: ResidentEntry['callId']): {
+    seq: SessionSeq;
+    event: SessionEvent<'tool/result'>;
+} | undefined;
+/**
+ * Σ estimateMessage over surface nodes AFTER `seq` — the suffix the prompt
+ * cache would reprice if the entry were swapped now (§3.4).
+ */
+export declare function suffixTokensAfter(session: Session, seq: SessionSeq, estimateMessage: (message: Message) => number): number;
+/**
+ * Evaluate and (when `apply`) commit one entry's swap. Synchronous: callers
+ * must fetch the stored text and build the stub BEFORE calling, so the
+ * staleness re-check and the two appends happen without yielding.
+ */
+export declare function attemptSwap(input: SwapInput): SwapResult;
+//# sourceMappingURL=swap.d.ts.map

package/lib/defer/swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../../src/defer/swap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAmB,MAAM,sBAAsB,CAAA;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAqB,MAAM,0BAA0B,CAAA;AAKpG,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;CACvD;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GAC1F;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA;AAEjC,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAC9B;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,CAAA;CAAE,GAAG,SAAS,CAOrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,UAAU,EACf,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAC5C,MAAM,CAeR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CA0DxD"}

package/lib/defer/swap.js

@@ -0,0 +1,120 @@
+/**
+ * The deferred swap pass (design §3.3): one non-awaiting critical section
+ * per eligible entry, executed at the `agent/pre-step` boundary. Mirrors the
+ * microcompact replacement shape exactly (compaction-micro index.ts
+ * 270-295): a `compaction/prune` shadow-price row debiting the token meter,
+ * immediately followed by the `tool/result` replacement carrying
+ * `surfaceOp: replace` + `sourceEventSeqs`, with every non-content field of
+ * the original block preserved.
+ *
+ * Staleness is re-checked against the live surface inside the same section
+ * (locate by callId — the sole locator — then byte-equality of the body), so
+ * an in-flight request or a microcompact pass cannot interleave with a swap.
+ *
+ * @module @dsh-cc/context-crusher/defer/swap
+ */
+import { freezeMessage } from '@deepseek-ai/dsh-llm';
+import { deriveEventMessage } from '@deepseek-ai/dsh-session';
+import { joinTextBlocks } from "./counter.js";
+import { evaluateDeferGate } from "./gate.js";
+/** Locate the current surface `tool/result` event by callId (sole locator). */
+export function locateResultEvent(session, callId) {
+    for (const seq of session.surface.nodes) {
+        const event = session.eventAt(seq);
+        if (event?.type !== 'tool/result')
+            continue;
+        if (String(event.data.message.source.callId) === String(callId))
+            return { seq, event };
+    }
+    return undefined;
+}
+/**
+ * Σ estimateMessage over surface nodes AFTER `seq` — the suffix the prompt
+ * cache would reprice if the entry were swapped now (§3.4).
+ */
+export function suffixTokensAfter(session, seq, estimateMessage) {
+    let sum = 0;
+    let seen = false;
+    for (const node of session.surface.nodes) {
+        if (node === seq) {
+            seen = true;
+            continue;
+        }
+        if (!seen)
+            continue;
+        const event = session.eventAt(node);
+        if (event === undefined)
+            continue;
+        const message = deriveEventMessage(event);
+        if (message !== null)
+            sum += estimateMessage(message);
+    }
+    return sum;
+}
+/**
+ * Evaluate and (when `apply`) commit one entry's swap. Synchronous: callers
+ * must fetch the stored text and build the stub BEFORE calling, so the
+ * staleness re-check and the two appends happen without yielding.
+ */
+export function attemptSwap(input) {
+    const { session, entry } = input;
+    const located = locateResultEvent(session, entry.callId);
+    if (located === undefined)
+        return { outcome: 'stale' };
+    const { seq, event } = located;
+    const message = event.data.message;
+    const first = message.content[0];
+    const resultBlock = first?.type === 'tool-result' ? first : undefined;
+    const body = resultBlock === undefined ? undefined : joinTextBlocks(resultBlock.content);
+    if (body !== input.fullText)
+        return { outcome: 'stale' };
+    const suffixTokens = suffixTokensAfter(session, seq, input.estimateMessage);
+    const gate = evaluateDeferGate({
+        tokensSaved: entry.tokensSaved,
+        remainingRequestsEstimate: input.remainingRequestsEstimate,
+        margin: input.margin,
+        suffixTokens,
+        ...(input.urgencyTokens !== undefined ? { urgencyTokens: input.urgencyTokens } : {}),
+        ...(input.sessionTokens !== undefined ? { sessionTokens: input.sessionTokens } : {}),
+        ...(input.contextWindow !== undefined ? { contextWindow: input.contextWindow } : {}),
+    });
+    const facts = {
+        sentCount: entry.sentCount,
+        suffixTokens,
+        projectedSavings: gate.projectedSavings,
+        margin: input.margin,
+        remainingRequestsEstimate: Math.max(1, input.remainingRequestsEstimate),
+        urgencyOverride: gate.urgencyOverride,
+    };
+    if (!gate.pass)
+        return { outcome: 'gate-failed', gate: facts };
+    if (!input.apply)
+        return { outcome: 'dry-run', gate: facts };
+    // Preserve every non-content field of the original tool-result block (type,
+    // toolCallId, isError, plus future additions) — the "may change only
+    // content" surface invariant.
+    const replacementBlock = resultBlock === undefined
+        ? { type: 'tool-result', toolCallId: message.source.callId, content: [{ type: 'text', text: input.stubText }] }
+        : { ...resultBlock, content: [{ type: 'text', text: input.stubText }] };
+    const replacementMessage = freezeMessage({
+        ...message,
+        content: [replacementBlock],
+    });
+    // Shadow-price protocol: the metering event and its replacement are
+    // appended synchronously adjacent so the token meter subtracts the
+    // shadowed node's heuristic price exactly once.
+    session.append('compaction/prune', {
+        shadowedRange: { start: seq, end: seq },
+        shadowedSeqs: [seq],
+        shadowedTokenCount: input.estimateMessage(message),
+    });
+    session.append('tool/result', {
+        ...event.data,
+        message: replacementMessage,
+    }, {
+        surfaceOp: { op: 'replace', startSeq: seq, endSeq: seq },
+        sourceEventSeqs: [seq],
+    });
+    return { outcome: 'applied', gate: facts };
+}
+//# sourceMappingURL=swap.js.map

package/lib/defer/swap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.js","sourceRoot":"","sources":["../../src/defer/swap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAI7D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAwB7C,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAC/B,OAAgB,EAChB,MAA+B;IAE/B,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,KAAK,EAAE,IAAI,KAAK,aAAa;YAAE,SAAQ;QAC3C,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;IACxF,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAgB,EAChB,GAAe,EACf,eAA6C;IAE7C,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,IAAI,IAAI,GAAG,KAAK,CAAA;IAChB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACzC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,IAAI,GAAG,IAAI,CAAA;YACX,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,IAAI;YAAE,SAAQ;QACnB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,KAAK,KAAK,SAAS;YAAE,SAAQ;QACjC,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;QACzC,IAAI,OAAO,KAAK,IAAI;YAAE,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,CAAA;IACvD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB;IAC1C,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IAChC,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACxD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;IACtD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAA;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAChC,MAAM,WAAW,GAAgC,KAAK,EAAE,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IAClG,MAAM,IAAI,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IACxF,IAAI,IAAI,KAAK,KAAK,CAAC,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;IAExD,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;IAC3E,MAAM,IAAI,GAAG,iBAAiB,CAAC;QAC7B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,yBAAyB,EAAE,KAAK,CAAC,yBAAyB;QAC1D,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY;QACZ,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrF,CAAC,CAAA;IACF,MAAM,KAAK,GAAmB;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY;QACZ,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,yBAAyB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,yBAAyB,CAAC;QACvE,eAAe,EAAE,IAAI,CAAC,eAAe;KACtC,CAAA;IACD,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC9D,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAE5D,4EAA4E;IAC5E,qEAAqE;IACrE,8BAA8B;IAC9B,MAAM,gBAAgB,GAAoB,WAAW,KAAK,SAAS;QACjE,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE;QAC/G,CAAC,CAAC,EAAE,GAAG,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAA;IACzE,MAAM,kBAAkB,GAAG,aAAa,CAAoB;QAC1D,GAAG,OAAO;QACV,OAAO,EAAE,CAAC,gBAAgB,CAAC;KAC5B,CAAC,CAAA;IACF,oEAAoE;IACpE,mEAAmE;IACnE,gDAAgD;IAChD,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE;QACjC,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;QACvC,YAAY,EAAE,CAAC,GAAG,CAAC;QACnB,kBAAkB,EAAE,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC;KACnD,CAAC,CAAA;IACF,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE;QAC5B,GAAG,KAAK,CAAC,IAAI;QACb,OAAO,EAAE,kBAAkB;KAC5B,EAAE;QACD,SAAS,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;QACxD,eAAe,EAAE,CAAC,GAAG,CAAC;KACvB,CAAC,CAAA;IACF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AAC5C,CAAC"}

package/lib/fold-counters.d.ts

@@ -0,0 +1,29 @@
+/**
+ * foldCounters seam for @dsh-cc/token-efficiency (design
+ * docs/plans/2026-09-20-token-efficiency-eval-harness.md §3.4).
+ *
+ * The marker/ledger shape knowledge lives HERE (the feature owns it): if the
+ * marker contract or tool-result extraction drifts, this fold and its tests
+ * must change in the same PR — never a silently-wrong foreign regex.
+ *
+ * @module @dsh-cc/context-crusher/fold-counters
+ */
+/**
+ * Structural materials contract shared by every efficiency-feature fold.
+ * Declared locally (no cross-package import); the loose event shape
+ * intentionally mirrors SessionLogEvent without depending on dsh-session.
+ */
+export interface FoldCounterMaterials {
+    readonly events: readonly {
+        readonly type: string;
+        readonly time?: number;
+        readonly data?: Record<string, unknown> | undefined;
+    }[];
+    readonly dshHome: string;
+}
+/**
+ * Fold CCR evidence in session streams: `ccr.applied` (marker count),
+ * `ccr.tokensBefore` (ΣN), `ccr.tokensAfter` (ΣM).
+ */
+export declare function foldCounters(materials: FoldCounterMaterials): Record<string, number>;
+//# sourceMappingURL=fold-counters.d.ts.map

package/lib/fold-counters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-counters.d.ts","sourceRoot":"","sources":["../src/fold-counters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;KACpD,EAAE,CAAA;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAyBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBpF"}

package/lib/fold-counters.js

@@ -0,0 +1,62 @@
+/**
+ * foldCounters seam for @dsh-cc/token-efficiency (design
+ * docs/plans/2026-09-20-token-efficiency-eval-harness.md §3.4).
+ *
+ * The marker/ledger shape knowledge lives HERE (the feature owns it): if the
+ * marker contract or tool-result extraction drifts, this fold and its tests
+ * must change in the same PR — never a silently-wrong foreign regex.
+ *
+ * @module @dsh-cc/context-crusher/fold-counters
+ */
+import { parseMarker } from "./marker.js";
+/**
+ * Extract every text fragment from a tool/result event's message content.
+ * Handles the real dsh-llm shapes: string content, text blocks, and
+ * nested tool-result blocks (content: ContentBlock[]).
+ */
+function resultTexts(data) {
+    const content = data?.message?.content;
+    const texts = [];
+    if (typeof content === 'string')
+        return [content];
+    if (!Array.isArray(content))
+        return texts;
+    for (const block of content) {
+        const b = block;
+        if (b.type === 'tool-result') {
+            for (const inner of (Array.isArray(b.content) ? b.content : [])) {
+                if (typeof inner?.text === 'string')
+                    texts.push(inner.text);
+            }
+        }
+        else if (typeof b?.text === 'string') {
+            texts.push(b.text);
+        }
+    }
+    return texts;
+}
+/**
+ * Fold CCR evidence in session streams: `ccr.applied` (marker count),
+ * `ccr.tokensBefore` (ΣN), `ccr.tokensAfter` (ΣM).
+ */
+export function foldCounters(materials) {
+    let applied = 0;
+    let tokensBefore = 0;
+    let tokensAfter = 0;
+    for (const event of materials.events) {
+        if (event.type !== 'tool/result')
+            continue;
+        for (const text of resultTexts(event.data)) {
+            for (const line of text.split('\n')) {
+                const marker = parseMarker(line.trim());
+                if (marker === null)
+                    continue;
+                applied += 1;
+                tokensBefore += marker.tokensBefore;
+                tokensAfter += marker.tokensAfter;
+            }
+        }
+    }
+    return { 'ccr.applied': applied, 'ccr.tokensBefore': tokensBefore, 'ccr.tokensAfter': tokensAfter };
+}
+//# sourceMappingURL=fold-counters.js.map

package/lib/fold-counters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-counters.js","sourceRoot":"","sources":["../src/fold-counters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAgBzC;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAa;IAChC,MAAM,OAAO,GAAI,IAAwD,EAAE,OAAO,EAAE,OAAO,CAAA;IAC3F,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAA;IACzC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,KAA6D,CAAA;QACvE,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC7B,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAyB,EAAE,CAAC;gBACxF,IAAI,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ;oBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAC7D,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAA+B;IAC1D,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,YAAY,GAAG,CAAC,CAAA;IACpB,IAAI,WAAW,GAAG,CAAC,CAAA;IACnB,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;YAAE,SAAQ;QAC1C,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;gBACvC,IAAI,MAAM,KAAK,IAAI;oBAAE,SAAQ;gBAC7B,OAAO,IAAI,CAAC,CAAA;gBACZ,YAAY,IAAI,MAAM,CAAC,YAAY,CAAA;gBACnC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAA;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAA;AACrG,CAAC"}

package/lib/index.d.ts

@@ -20,9 +20,19 @@ import type { CrusherConfig, RetrieveError, ResolvedConfig } from './types.ts';
 export { resolveConfig, overlaySettings, DEFAULTS, DEFAULT_PROTECTED_TOOLS, Config } from './config.ts';
 export { SETTINGS_NAMESPACE } from './settings.ts';
 export { route } from './router.ts';
+export { REDUCER_COMMAND_TOOLS, invocationCommand, isReducerEligible, reduceToolOutput, truncateView } from './reducer.ts';
+export { parseReceipt, renderReceipt, ReceiptSchema } from './receipt.ts';
+export { verifyReceipt } from './verifier.ts';
 export { CrusherStore, shortHash, STORE_MAX_ENTRIES, STORE_TTL_MS } from './store.ts';
 export { SavingsLedger } from './ledger.ts';
 export { buildMarker, parseMarker } from './marker.ts';
+export { foldCounters } from './fold-counters.ts';
+export type { FoldCounterMaterials } from './fold-counters.ts';
+export { Deferral } from './defer/pass.ts';
+export { evaluateDeferGate } from './defer/gate.ts';
+export { attemptSwap } from './defer/swap.ts';
+export { DeferLedger, ResidentTable, foldDeferRows, parseTodoCounts, readDeferLedger, rebuildResidents, } from './defer/residents.ts';
+export type { DeferLedgerRow, ResidentEntry } from './defer/residents.ts';
 export type { CrusherConfig, CrusherMode, ResolvedConfig, LedgerRow, RetrieveError } from './types.ts';
 export declare const RETRIEVE_TOOL_NAME = "context_retrieve";
 /** The pinned marker contract, mirrored verbatim in the retrieve tool's description. */
@@ -45,11 +55,21 @@ export declare class ContextCrusher extends Service {
     private readonly readSettings;
     private readonly store;
     private readonly ledger;
+    private readonly home;
+    /** Deferred-mode orchestration (counting, swap pass, resume, ledger). */
+    private readonly deferral;
     constructor(ctx: Context, config?: CrusherConfig);
     /** Effective configuration for one use: config defaults overlaid by live settings. */
     effectiveConfig(): ResolvedConfig;
     private registerListener;
     private crush;
+    /**
+     * Reducer escalation stage (§3.1): after the deterministic route declined
+     * (null) or its savings fell below `minSavingsRatio`. Any reducer failure —
+     * eligibility, lane, timeout, verification — passes the ORIGINAL bytes
+     * through (fail-soft inside `reduceToolOutput` too).
+     */
+    private reduceOrPassthrough;
     /** Token-based sizing (D3): the same estimator gates, markers, and ledger rows. */
     private estimate;
     /** `sha256(sessionCwd)` first 16 hex — the store's project bucket. */

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAIlD,OAAO,KAAK,EAAwD,cAAc,EAAE,MAAM,eAAe,CAAA;AASzG,OAAO,KAAK,EAAE,aAAa,EAAa,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEzF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACvG,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACtD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEtG,eAAO,MAAM,kBAAkB,qBAAqB,CAAA;AAEpD,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,QAK8C,CAAA;AAKpF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,oGAAoG;QACpG,WAAW,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,MAAM,CAAA;KAChD;CACF;AAyBD;;;GAGG;AACH,qBAAa,cAAe,SAAQ,OAAO;IACzC,MAAM,CAAC,MAAM,WAAiB;IAE9B,MAAM,CAAC,MAAM,4DAAS;IAEtB,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAEtC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,aAAkB;IAgBpD,sFAAsF;IACtF,eAAe,IAAI,cAAc;IAIjC,OAAO,CAAC,gBAAgB;YAmBV,KAAK;IAgEnB,mFAAmF;IACnF,OAAO,CAAC,QAAQ;IAOhB,sEAAsE;IACtE,OAAO,CAAC,UAAU;IAYlB,+EAA+E;IACzE,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CACzD;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,aAAa,GAAG,aAAa,GAAG,cAAc,CAAA;KAAE,CAClG;IAcD,OAAO,CAAC,oBAAoB;CAK7B;AA2BD,eAAe,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/index.js

@@ -19,15 +19,26 @@ import { getSessionCwd } from '@dsh-cc/session-cwd';
 import { resolveConfig, overlaySettings, Config } from "./config.js";
 import { registerSettings } from "./settings.js";
 import { route } from "./router.js";
+import { reduceToolOutput } from "./reducer.js";
 import { CrusherStore, shortHash } from "./store.js";
 import { SavingsLedger } from "./ledger.js";
 import { buildMarker, CCR_HASH_RE } from "./marker.js";
+import { joinTextBlocks } from "./defer/counter.js";
+import { Deferral } from "./defer/pass.js";
 export { resolveConfig, overlaySettings, DEFAULTS, DEFAULT_PROTECTED_TOOLS, Config } from "./config.js";
 export { SETTINGS_NAMESPACE } from "./settings.js";
 export { route } from "./router.js";
+export { REDUCER_COMMAND_TOOLS, invocationCommand, isReducerEligible, reduceToolOutput, truncateView } from "./reducer.js";
+export { parseReceipt, renderReceipt, ReceiptSchema } from "./receipt.js";
+export { verifyReceipt } from "./verifier.js";
 export { CrusherStore, shortHash, STORE_MAX_ENTRIES, STORE_TTL_MS } from "./store.js";
 export { SavingsLedger } from "./ledger.js";
 export { buildMarker, parseMarker } from "./marker.js";
+export { foldCounters } from "./fold-counters.js";
+export { Deferral } from "./defer/pass.js";
+export { evaluateDeferGate } from "./defer/gate.js";
+export { attemptSwap } from "./defer/swap.js";
+export { DeferLedger, ResidentTable, foldDeferRows, parseTodoCounts, readDeferLedger, rebuildResidents, } from "./defer/residents.js";
 export const RETRIEVE_TOOL_NAME = 'context_retrieve';
 /** The pinned marker contract, mirrored verbatim in the retrieve tool's description. */
 export const RETRIEVE_TOOL_DESCRIPTION = 'Retrieve the ORIGINAL text of a tool result that dsh-cc compressed. When a tool result '
@@ -49,32 +60,30 @@ function dshHomeFn(ctx) {
     }
 }
 /** Join text blocks; returns undefined when any block is non-text. */
-function allTextBlocks(blocks) {
-    const parts = [];
-    for (const block of blocks) {
-        if (block.type !== 'text')
-            return undefined;
-        parts.push(block.text);
-    }
-    return parts.join('\n');
-}
+const allTextBlocks = joinTextBlocks;
 /**
  * The context-crusher service: registers the post-execute tripwire listener
  * and the `context_retrieve` agent tool.
  */
 export class ContextCrusher extends Service {
-    static inject = ['tokenMeter'];
+    // `llm` backs the reducer's cheap-lane side query (runSideQuery reads it
+    // through the context; cordis requires a declared injection to read it).
+    static inject = ['tokenMeter', 'llm'];
     static Config = Config;
     /** Resolved config-layer defaults; the settings overlay re-reads per use. */
     base;
     readSettings;
     store;
     ledger;
+    home;
+    /** Deferred-mode orchestration (counting, swap pass, resume, ledger). */
+    deferral;
     constructor(ctx, config = {}) {
         super(ctx, 'contextCrusher');
         this.base = resolveConfig(config);
         this.readSettings = registerSettings(ctx, this.base);
         const home = dshHomeFn(ctx);
+        this.home = home;
         if (home === undefined) {
             // D6 fail-closed: without a durable home the store/ledger cannot exist.
             ctx.logger.warn('context-crusher: no dshHomePath on the host context; force-disabled');
@@ -83,7 +92,14 @@ export class ContextCrusher extends Service {
             this.store = new CrusherStore(home('ccr'));
             this.ledger = new SavingsLedger(home('ccr', 'savings.jsonl'));
         }
+        this.deferral = new Deferral({
+            ctx,
+            store: () => this.store,
+            home: () => this.home,
+            effectiveConfig: () => this.effectiveConfig(),
+        });
         this.registerListener();
+        this.deferral.registerListeners();
         this.registerRetrieveTool();
     }
     /** Effective configuration for one use: config defaults overlaid by live settings. */
@@ -119,6 +135,10 @@ export class ContextCrusher extends Service {
         };
         if (!cfg.enabled || this.store === undefined)
             return d;
+        // Observe-only todo snapshot for the defer gate's remaining-requests
+        // estimate (compaction cost-gate doc); the decision is untouched.
+        if (exec.name === 'todo_write' && cfg.deferRequests > 0)
+            this.deferral.observeTodoSnapshot(exec);
         // D7: protected tools REPLACE the default list when explicitly set.
         if (cfg.protectedTools.includes(exec.name))
             return d;
@@ -142,21 +162,40 @@ export class ContextCrusher extends Service {
             return d;
         const candidate = route(originalText);
         if (candidate === null)
-            return d;
+            return this.reduceOrPassthrough(exec, result, d, originalText, tokensBefore, cfg, ledgerRow);
         const compressedBody = candidate.text;
         const tokensAfter = this.estimate(compressedBody);
         const savings = 1 - tokensAfter / tokensBefore;
-        if (savings < cfg.minSavingsRatio)
-            return d;
-        if (cfg.mode !== 'on') {
+        if (savings < cfg.minSavingsRatio) {
+            // Escalation (§3.1): sub-threshold deterministic savings go to the
+            // reducer, never mixing partial compressions.
+            return this.reduceOrPassthrough(exec, result, d, originalText, tokensBefore, cfg, ledgerRow);
+        }
+        if (cfg.mode !== 'on' && cfg.deferRequests <= 0) {
             // Dry-run: measure only; the committed result stays original.
             await ledgerRow({ kind: candidate.kind, charsBefore: originalText.length, charsAfter: compressedBody.length, tokensBefore, tokensAfter, applied: false });
             return d;
         }
         const projectKey = this.projectKey(exec);
-        if (projectKey === undefined)
+        if (projectKey === undefined) {
+            // Preserve the dry-run ledger row even when deferral wanted a store.
+            if (cfg.mode !== 'on') {
+                await ledgerRow({ kind: candidate.kind, charsBefore: originalText.length, charsAfter: compressedBody.length, tokensBefore, tokensAfter, applied: false });
+            }
             return d;
+        }
         const hash = await this.store.put(projectKey, originalText);
+        if (cfg.deferRequests > 0) {
+            // Deferred mode (§3.1): the store put happened (evidence is durable),
+            // the resident entry is recorded, and the downstream decision returns
+            // UNMODIFIED — the full text enters the session. §3.6: this applies to
+            // dry-run too (deferred dry-run writes store files and ledger rows; it
+            // only never appends to the session).
+            await this.deferral.recordResident(exec, hash, tokensBefore - tokensAfter);
+            await ledgerRow({ kind: candidate.kind, charsBefore: originalText.length, charsAfter: compressedBody.length, tokensBefore, tokensAfter, applied: false, hash });
+            void this.store.sweep();
+            return d;
+        }
         const replacement = {
             type: 'text',
             text: `${compressedBody}\n${buildMarker(tokensBefore, tokensAfter, hash)}`,
@@ -170,6 +209,38 @@ export class ContextCrusher extends Service {
         // here (checked above), so this is the content-carrying accept variant.
         return { kind: 'accept', ...('additionalContexts' in d && d.additionalContexts !== undefined ? { additionalContexts: d.additionalContexts } : {}), content: [replacement] };
     }
+    /**
+     * Reducer escalation stage (§3.1): after the deterministic route declined
+     * (null) or its savings fell below `minSavingsRatio`. Any reducer failure —
+     * eligibility, lane, timeout, verification — passes the ORIGINAL bytes
+     * through (fail-soft inside `reduceToolOutput` too).
+     */
+    async reduceOrPassthrough(exec, result, d, originalText, tokensBefore, cfg, ledgerRow) {
+        const replacementText = await reduceToolOutput({
+            ctx: this.ctx,
+            cfg,
+            exec,
+            originalText,
+            tokensBefore,
+            isError: result.isError,
+            estimate: (text) => this.estimate(text),
+            projectKey: this.projectKey(exec),
+            mode: cfg.mode,
+            put: (projectKey, text) => {
+                // The `store === undefined` gate above guarantees the store exists.
+                return this.store.put(projectKey, text);
+            },
+            ledgerRow,
+        });
+        if (replacementText === undefined)
+            return d;
+        const replacement = { type: 'text', text: replacementText };
+        // Fire-and-forget sweep AFTER the decision is formed (D6), matching the
+        // deterministic replacement path.
+        void this.store?.sweep();
+        // D11: spread the downstream decision so its additionalContexts survive.
+        return { kind: 'accept', ...('additionalContexts' in d && d.additionalContexts !== undefined ? { additionalContexts: d.additionalContexts } : {}), content: [replacement] };
+    }
     /** Token-based sizing (D3): the same estimator gates, markers, and ledger rows. */
     estimate(text) {
         return this.ctx.tokenMeter.estimateMessage({

package/lib/index.js.map

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

package/lib/receipt.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Receipt schema and canonical renderer for the evidence-preserving reducer.
+ * @module @dsh-cc/context-crusher/receipt
+ */
+import z from '@deepseek-ai/schemastery';
+/** One failing test entry: identifier plus a verbatim evidence quote. */
+export interface ReceiptFailure {
+    readonly name: string;
+    readonly evidence: string;
+}
+/**
+ * The cheap-lane extraction receipt (plan §3.3). Every `evidence` /
+ * `key_output` string must be a verbatim substring of the (possibly
+ * truncated) source view; `verifyReceipt` enforces that.
+ */
+export interface Receipt {
+    readonly v: 1;
+    readonly cmd: string;
+    readonly exit: {
+        readonly ok: boolean;
+        readonly code?: number | undefined;
+    };
+    readonly failures: ReceiptFailure[];
+    readonly key_output: string[];
+    readonly counts?: {
+        readonly pass: number;
+        readonly fail: number;
+        readonly skip: number;
+    } | undefined;
+}
+/** schemastery schema for the receipt shape (types only; see parseReceipt for key-set checks). */
+export declare const ReceiptSchema: z<Receipt>;
+/**
+ * Parse and validate a raw receipt. Returns the receipt, or `null` when any
+ * check fails: schema types, the 8-entry `key_output` cap, or the explicit
+ * exact-key-set check at every object level (schemastery `z.object` keeps
+ * unknown keys rather than stripping them, so rejection is explicit here).
+ */
+export declare function parseReceipt(raw: unknown): Receipt | null;
+/**
+ * Canonical few-line rendering (plan §3.5): deterministic, receipt body only.
+ * The caller appends the pinned `buildMarker(...)` line — never included here.
+ */
+export declare function renderReceipt(r: Receipt): string;
+//# sourceMappingURL=receipt.d.ts.map

package/lib/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../src/receipt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAA;IACb,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IAC3E,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAA;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAA;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CACtG;AAKD,kGAAkG;AAClG,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,OAAO,CAOnC,CAAA;AAeF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAgBzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAQhD"}