@dsh-cc/context-crusher 0.6.2

package/lib/index.js

@@ -0,0 +1,244 @@
+/**
+ * CCR (Compress-Cache-Retrieve) reversible tool-output compression.
+ *
+ * A `tools/post-execute` listener (registered `{ prepend: true }`, composed
+ * post-`next()`) compresses large grep/log-shaped tool results, persists the
+ * original in a content-addressed store, and appends a `ccr://<hash>` marker;
+ * the `context_retrieve({ hash })` agent tool restores the original. Defaults
+ * are `enabled: false, mode: 'dry-run'` — nothing replaces until opted in.
+ *
+ * Fail-closed everywhere: a missing `dshHomePath` force-disables the crusher,
+ * and every store/ledger/sweep I/O error degrades to passthrough — a throw in
+ * this waterfall would turn the user's tool result into an error (data loss).
+ *
+ * @module @dsh-cc/context-crusher
+ */
+import { Service } from '@deepseek-ai/cordis';
+import { defineTool } from '@dsh-cc/tools';
+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 { CrusherStore, shortHash } from "./store.js";
+import { SavingsLedger } from "./ledger.js";
+import { buildMarker, CCR_HASH_RE } from "./marker.js";
+export { resolveConfig, overlaySettings, DEFAULTS, DEFAULT_PROTECTED_TOOLS, Config } from "./config.js";
+export { SETTINGS_NAMESPACE } from "./settings.js";
+export { route } from "./router.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 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 '
+    + 'ends with a marker like `[dsh-cc compressed 41230→6180 tokens. Original: ccr://a1b2c3d4e5f60708]`, '
+    + 'call this tool with the 16-hex hash from the `ccr://` handle to read the full uncompressed '
+    + 'output. Use it whenever the compressed form is not enough (you need a specific elided line, '
+    + 'a full stack trace, or untruncated rows). The original is retained for 1 hour.';
+/**
+ * Read a dsh-home path without throwing when the boot-provided `dshHomePath`
+ * resolver is absent — cordis throws on the property access itself (not a
+ * plain `undefined`), so the read must be guarded.
+ */
+function dshHomeFn(ctx) {
+    try {
+        return ctx.dshHomePath;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 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');
+}
+/**
+ * The context-crusher service: registers the post-execute tripwire listener
+ * and the `context_retrieve` agent tool.
+ */
+export class ContextCrusher extends Service {
+    static inject = ['tokenMeter'];
+    static Config = Config;
+    /** Resolved config-layer defaults; the settings overlay re-reads per use. */
+    base;
+    readSettings;
+    store;
+    ledger;
+    constructor(ctx, config = {}) {
+        super(ctx, 'contextCrusher');
+        this.base = resolveConfig(config);
+        this.readSettings = registerSettings(ctx, this.base);
+        const home = dshHomeFn(ctx);
+        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');
+        }
+        else {
+            this.store = new CrusherStore(home('ccr'));
+            this.ledger = new SavingsLedger(home('ccr', 'savings.jsonl'));
+        }
+        this.registerListener();
+        this.registerRetrieveTool();
+    }
+    /** Effective configuration for one use: config defaults overlaid by live settings. */
+    effectiveConfig() {
+        return overlaySettings(this.base, this.readSettings());
+    }
+    registerListener() {
+        this.ctx.on('tools/post-execute', async (exec, result, next) => {
+            const d = await next();
+            if (d.kind !== 'accept')
+                return d;
+            try {
+                return await this.crush(exec, result, d);
+            }
+            catch (error) {
+                // D6: degrade to passthrough. NEVER throw into the waterfall — a throw
+                // turns the user's tool result into an error result (data loss).
+                this.ctx.logger.warn(`context-crusher: degraded to passthrough: ${String(error)}`);
+                return d;
+            }
+        }, { prepend: true });
+    }
+    async crush(exec, result, d) {
+        const cfg = this.effectiveConfig();
+        const sessionId = exec.agent === undefined ? '' : String(exec.agent.session.id);
+        const ledgerRow = async (row) => {
+            await this.ledger?.append({
+                ts: new Date().toISOString(),
+                sessionId,
+                tool: exec.name,
+                ...row,
+            });
+        };
+        if (!cfg.enabled || this.store === undefined)
+            return d;
+        // D7: protected tools REPLACE the default list when explicitly set.
+        if (cfg.protectedTools.includes(exec.name))
+            return d;
+        // Never crush the retrieval tool's own output: it would recurse (the
+        // retrieved original is large and grep-shaped) and destroy the round-trip.
+        if (exec.name === RETRIEVE_TOOL_NAME)
+            return d;
+        // A value-only accept decision carries no content to crush.
+        if (Object.hasOwn(d, 'value'))
+            return d;
+        const blocks = d.content ?? result.content;
+        if (blocks === undefined)
+            return d;
+        const originalText = allTextBlocks(blocks);
+        if (originalText === undefined)
+            return d; // D2: any non-text block → skip
+        const tokensBefore = this.estimate(originalText);
+        if (result.isError && tokensBefore < 2 * cfg.minBytes)
+            return d;
+        if (tokensBefore < cfg.minBytes)
+            return d;
+        const candidate = route(originalText);
+        if (candidate === null)
+            return d;
+        const compressedBody = candidate.text;
+        const tokensAfter = this.estimate(compressedBody);
+        const savings = 1 - tokensAfter / tokensBefore;
+        if (savings < cfg.minSavingsRatio)
+            return d;
+        if (cfg.mode !== 'on') {
+            // 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)
+            return d;
+        const hash = await this.store.put(projectKey, originalText);
+        const replacement = {
+            type: 'text',
+            text: `${compressedBody}\n${buildMarker(tokensBefore, tokensAfter, hash)}`,
+        };
+        await ledgerRow({ kind: candidate.kind, charsBefore: originalText.length, charsAfter: replacement.text.length, tokensBefore, tokensAfter, applied: true, hash });
+        // D11: spread the downstream decision so its additionalContexts survive.
+        // Fire-and-forget sweep AFTER the decision is formed (D6).
+        void this.store.sweep();
+        // D11: spread the downstream decision so its additionalContexts survive.
+        // `content` is fresh (D2); the downstream decision cannot be value-carrying
+        // 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] };
+    }
+    /** Token-based sizing (D3): the same estimator gates, markers, and ledger rows. */
+    estimate(text) {
+        return this.ctx.tokenMeter.estimateMessage({
+            role: 'tool',
+            content: [{ type: 'text', text }],
+        });
+    }
+    /** `sha256(sessionCwd)` first 16 hex — the store's project bucket. */
+    projectKey(exec) {
+        if (exec.agent === undefined)
+            return undefined;
+        try {
+            // Worktree-path divergence from the TUI project-root convention is
+            // accepted here: the store is self-consistent (writer and retriever
+            // both key off the session cwd).
+            return shortHash(getSessionCwd(exec.agent));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** Typed retrieval through the store; fails closed (used by the tool body). */
+    async retrieve(exec, hash) {
+        if (this.store === undefined)
+            return { ok: false, error: 'unavailable' };
+        if (!CCR_HASH_RE.test(hash))
+            return { ok: false, error: 'invalid_hash' };
+        const agent = exec.agent;
+        if (agent === undefined)
+            return { ok: false, error: 'unavailable' };
+        let projectKey;
+        try {
+            projectKey = shortHash(getSessionCwd(agent));
+        }
+        catch {
+            return { ok: false, error: 'unavailable' };
+        }
+        return await this.store.get(projectKey, hash);
+    }
+    registerRetrieveTool() {
+        const tools = this.ctx.get('tools');
+        if (tools === undefined)
+            return;
+        tools.register(defineRetrieveTool(this));
+    }
+}
+function defineRetrieveTool(crusher) {
+    return defineTool({
+        name: RETRIEVE_TOOL_NAME,
+        description: RETRIEVE_TOOL_DESCRIPTION,
+        parameters: {
+            hash: {
+                type: 'string',
+                required: true,
+                description: 'The 16-hex content handle from a `ccr://<hash>` marker.',
+            },
+        },
+        output: {
+            schema: { type: 'object', additionalProperties: false, properties: { text: { type: 'string', required: true } } },
+            render: (_args, value) => [{ type: 'text', text: value.text }],
+        },
+        async execute(args, exec) {
+            const outcome = await crusher.retrieve(exec, args.hash);
+            if (!outcome.ok) {
+                throw new Error(`context_retrieve failed: ${outcome.error}`);
+            }
+            return { text: outcome.text };
+        },
+    });
+}
+export default ContextCrusher;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@dsh-cc/context-crusher`.
+ * @module @dsh-cc/context-crusher/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "context-crusher-invariant";
+/** Services required before the companion can register. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,oCAAoC;AACpC,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAC/C,2DAA2D;AAC3D,eAAO,MAAM,MAAM,UAAiB,CAAA;AAUpC;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CACU,CAAA"}

package/lib/invariant.js

@@ -0,0 +1,24 @@
+/**
+ * Package-owned invariant companion for `@dsh-cc/context-crusher`.
+ * @module @dsh-cc/context-crusher/invariant
+ */
+const PACKAGE_NAME = '@dsh-cc/context-crusher';
+/** Cordis companion plugin name. */
+export const name = 'context-crusher-invariant';
+/** Services required before the companion can register. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: the crusher's safety contract is enforced at the
+ * source — post-`next()` composition never converts a non-accept decision,
+ * the D2/D11 block shape is pinned by composition tests, and every I/O path
+ * fails closed to passthrough rather than relying on a cross-event check.
+ */
+const install = () => { };
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */
+//# sourceMappingURL=invariant.js.map

package/lib/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,YAAY,GAAG,yBAAyB,CAAA;AAE9C,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,2BAA2B,CAAA;AAC/C,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,OAAO,GAAuB,GAAG,EAAE,GAAE,CAAC,CAAA;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAuB,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AACjE,sBAAsB"}

package/lib/ledger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Append-only savings ledger (`<dshHome>/ccr/savings.jsonl`).
+ *
+ * One `appendFile` per row (rows are small, appends are atomic enough for
+ * single-process use). sessionId lives ONLY here — never in a store path.
+ * All I/O errors are swallowed: the ledger is observability, and a failed row
+ * must never degrade a tool result.
+ *
+ * @module @dsh-cc/context-crusher/ledger
+ */
+import type { LedgerRow } from './types.ts';
+export declare class SavingsLedger {
+    private readonly filePath;
+    constructor(filePath: string);
+    /** Append one row; never throws. */
+    append(row: LedgerRow): Promise<void>;
+}
+//# sourceMappingURL=ledger.d.ts.map

package/lib/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE7C,oCAAoC;IAC9B,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ5C"}

package/lib/ledger.js

@@ -0,0 +1,29 @@
+/**
+ * Append-only savings ledger (`<dshHome>/ccr/savings.jsonl`).
+ *
+ * One `appendFile` per row (rows are small, appends are atomic enough for
+ * single-process use). sessionId lives ONLY here — never in a store path.
+ * All I/O errors are swallowed: the ledger is observability, and a failed row
+ * must never degrade a tool result.
+ *
+ * @module @dsh-cc/context-crusher/ledger
+ */
+import { appendFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+export class SavingsLedger {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    /** Append one row; never throws. */
+    async append(row) {
+        try {
+            await mkdir(dirname(this.filePath), { recursive: true });
+            await appendFile(this.filePath, `${JSON.stringify(row)}\n`, 'utf8');
+        }
+        catch {
+            // Best-effort observability; never surface into the tool waterfall.
+        }
+    }
+}
+//# sourceMappingURL=ledger.js.map

package/lib/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD,oCAAoC;IACpC,KAAK,CAAC,MAAM,CAAC,GAAc;QACzB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACxD,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;IACH,CAAC;CACF"}

package/lib/marker.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Marker contract for crushed tool results.
+ *
+ * PINNED CONTRACT: the marker literal is appended to every compressed tool
+ * result and the `context_retrieve` tool description references the same
+ * `ccr://<hash>` spelling. A test pins the wording ↔ description pairing.
+ *
+ * @module @dsh-cc/context-crusher/marker
+ */
+/** Extracts a `ccr://<hash16>` handle from the marker. */
+export declare const CCR_HASH_RE: RegExp;
+/**
+ * Build the provenance marker appended to compressed text.
+ * @param tokensBefore - tokenMeter token estimate of the original.
+ * @param tokensAfter - tokenMeter token estimate of the compressed form (marker excluded).
+ * @param hash - the 16-hex content handle of the stored original.
+ * @returns e.g. `[dsh-cc compressed 41230→6180 tokens. Original: ccr://a1b2c3d4e5f60708]`
+ */
+export declare function buildMarker(tokensBefore: number, tokensAfter: number, hash: string): string;
+/**
+ * Parse a marker back into its parts.
+ * @param line - the marker text.
+ * @returns `{tokensBefore, tokensAfter, hash}`, or `null` when not a marker.
+ */
+export declare function parseMarker(line: string): {
+    tokensBefore: number;
+    tokensAfter: number;
+    hash: string;
+} | null;
+//# sourceMappingURL=marker.d.ts.map

package/lib/marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker.d.ts","sourceRoot":"","sources":["../src/marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0DAA0D;AAC1D,eAAO,MAAM,WAAW,QAAmB,CAAA;AAE3C;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI5G"}

package/lib/marker.js

@@ -0,0 +1,33 @@
+/**
+ * Marker contract for crushed tool results.
+ *
+ * PINNED CONTRACT: the marker literal is appended to every compressed tool
+ * result and the `context_retrieve` tool description references the same
+ * `ccr://<hash>` spelling. A test pins the wording ↔ description pairing.
+ *
+ * @module @dsh-cc/context-crusher/marker
+ */
+/** Extracts a `ccr://<hash16>` handle from the marker. */
+export const CCR_HASH_RE = /^[0-9a-f]{16}$/;
+/**
+ * Build the provenance marker appended to compressed text.
+ * @param tokensBefore - tokenMeter token estimate of the original.
+ * @param tokensAfter - tokenMeter token estimate of the compressed form (marker excluded).
+ * @param hash - the 16-hex content handle of the stored original.
+ * @returns e.g. `[dsh-cc compressed 41230→6180 tokens. Original: ccr://a1b2c3d4e5f60708]`
+ */
+export function buildMarker(tokensBefore, tokensAfter, hash) {
+    return `[dsh-cc compressed ${tokensBefore}→${tokensAfter} tokens. Original: ccr://${hash}]`;
+}
+/**
+ * Parse a marker back into its parts.
+ * @param line - the marker text.
+ * @returns `{tokensBefore, tokensAfter, hash}`, or `null` when not a marker.
+ */
+export function parseMarker(line) {
+    const m = /^\[dsh-cc compressed (\d+)→(\d+) tokens\. Original: ccr:\/\/([0-9a-f]{16})\]$/.exec(line);
+    if (m === null)
+        return null;
+    return { tokensBefore: Number(m[1]), tokensAfter: Number(m[2]), hash: m[3] ?? '' };
+}
+//# sourceMappingURL=marker.js.map

package/lib/marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker.js","sourceRoot":"","sources":["../src/marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,YAAoB,EAAE,WAAmB,EAAE,IAAY;IACjF,OAAO,sBAAsB,YAAY,IAAI,WAAW,4BAA4B,IAAI,GAAG,CAAA;AAC7F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,+EAA+E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpG,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAA;AACpF,CAAC"}

package/lib/router.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pure, deterministic content routing and compression (no I/O).
+ *
+ * Two Phase-0 compressors, both conservative: if the input does not cleanly
+ * match the format's structure the router returns `null` and the listener
+ * passes the result through untouched. Every line carrying an error or match
+ * signal survives; only repetitive context is dropped.
+ *
+ * @module @dsh-cc/context-crusher/router
+ */
+export type CompressedKind = 'search' | 'log';
+/** A safe compression, or `null` = no safe saving → passthrough. */
+export interface CompressedCandidate {
+    readonly text: string;
+    readonly kind: CompressedKind;
+}
+/**
+ * Route one tool-result text to a compressor.
+ * @param text - the joined tool-result text.
+ * @returns a compressed candidate, or `null` when the input does not cleanly
+ *   match a known format or would not compress.
+ */
+export declare function route(text: string): CompressedCandidate | null;
+//# sourceMappingURL=router.d.ts.map

package/lib/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,CAAA;AAE7C,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAC9B;AA8GD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAa9D"}

package/lib/router.js

@@ -0,0 +1,132 @@
+/**
+ * Pure, deterministic content routing and compression (no I/O).
+ *
+ * Two Phase-0 compressors, both conservative: if the input does not cleanly
+ * match the format's structure the router returns `null` and the listener
+ * passes the result through untouched. Every line carrying an error or match
+ * signal survives; only repetitive context is dropped.
+ *
+ * @module @dsh-cc/context-crusher/router
+ */
+/**
+ * Minimum structural evidence before a compressor claims an input: fewer
+ * candidate lines than this is not a confident format match.
+ */
+const MIN_EVIDENCE_LINES = 3;
+/** Share of non-empty lines that must match a format for a confident claim. */
+const MIN_EVIDENCE_RATIO = 0.6;
+/** Log-shaped output needs weaker evidence than grep rows (banners are sparse). */
+const MIN_LOG_RATIO = 0.3;
+/** Ripgrep/grep `file:line:content` row: path without spaces or colons, digits. */
+const SEARCH_ROW = /^(\.{0,2}\/?[\w.@\/-]+?):(\d+):(.*)$/;
+/** Non-search rows that would make a search claim unsafe (paths contain `:`? no). */
+function isSearchRow(line) {
+    return SEARCH_ROW.test(line);
+}
+/**
+ * Compress grep-style output: cluster consecutive rows per file, emit the
+ * path once, then `line:content` per row. Every matching line and every file
+ * path survives; only the repeated path prefixes are dropped.
+ */
+function compressSearch(text) {
+    const clusters = new Map(); // file → `lineNo:content` rows, first-appearance order
+    const loose = [];
+    for (const line of text.split('\n')) {
+        const match = SEARCH_ROW.exec(line);
+        if (match === null) {
+            loose.push(line);
+            continue;
+        }
+        const [file, lineNo, content] = [match[1] ?? '', match[2] ?? '', match[3] ?? ''];
+        const rows = clusters.get(file) ?? [];
+        rows.push(`${lineNo}:${content}`);
+        clusters.set(file, rows);
+    }
+    const out = [...loose];
+    for (const [file, rows] of clusters) {
+        out.push(`== ${file} ==`, ...rows);
+    }
+    return out.join('\n');
+}
+/** Lines that carry an error/failure signal and are always preserved. */
+const LOG_SIGNAL = [
+    /\b(ERROR|FATAL|ERR!|FAIL(?:ED|URE)?|Traceback|panic|exception)\b/i,
+    /^\s+at\s/, // JS stack frame
+    /^\s+File "/, // Python stack frame
+    /^npm ERR!/,
+    /^=+ .* =+$/, // pytest banner
+    /^\s*(?:Failed|Error):/,
+];
+function isLogSignal(line) {
+    return LOG_SIGNAL.some((re) => re.test(line));
+}
+/** Lines that identify log-shaped output (timestamps, levels, tool banners). */
+const LOG_MARKER = [
+    /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}/,
+    /^\d{2}:\d{2}:\d{2}[.,]?\d*/,
+    /\b(WARN|INFO|DEBUG|TRACE)\b/,
+    /^npm (WARN|notice)/,
+    /^(PASS|OK|PASSED|passed)\b/,
+    /^(✓|√|✔)/,
+];
+function isLogMarker(line) {
+    return LOG_MARKER.some((re) => re.test(line)) || isLogSignal(line);
+}
+/** Non-signal lines kept at the head of each cluster, for orientation. */
+const KEEP_HEAD = 3;
+/**
+ * Compress log output: keep every error/signal line and stack frame, keep the
+ * first {@link KEEP_HEAD} lines of each contiguous non-signal cluster, elide
+ * the rest with an explicit count so the shape stays honest.
+ */
+function compressLog(text) {
+    const lines = text.split('\n');
+    const out = [];
+    let run = [];
+    const flush = () => {
+        if (run.length === 0)
+            return;
+        if (run.length <= KEEP_HEAD) {
+            out.push(...run);
+        }
+        else {
+            out.push(...run.slice(0, KEEP_HEAD));
+            out.push(`[… ${run.length - KEEP_HEAD} lines elided by dsh-cc log compression …]`);
+        }
+        run = [];
+    };
+    for (const line of lines) {
+        if (isLogSignal(line) || line === '') {
+            flush();
+            out.push(line);
+        }
+        else {
+            run.push(line);
+        }
+    }
+    flush();
+    return out.join('\n');
+}
+/**
+ * Route one tool-result text to a compressor.
+ * @param text - the joined tool-result text.
+ * @returns a compressed candidate, or `null` when the input does not cleanly
+ *   match a known format or would not compress.
+ */
+export function route(text) {
+    if (text.length === 0)
+        return null;
+    const lines = text.split('\n').filter((l) => l.trim().length > 0);
+    if (lines.length < MIN_EVIDENCE_LINES)
+        return null;
+    const searchRows = lines.filter((l) => isSearchRow(l)).length;
+    if (searchRows >= MIN_EVIDENCE_LINES && searchRows / lines.length >= MIN_EVIDENCE_RATIO) {
+        return { text: compressSearch(text), kind: 'search' };
+    }
+    const logLines = lines.filter((l) => isLogMarker(l)).length;
+    if (logLines >= MIN_EVIDENCE_LINES && logLines / lines.length >= MIN_LOG_RATIO) {
+        return { text: compressLog(text), kind: 'log' };
+    }
+    return null;
+}
+//# sourceMappingURL=router.js.map

package/lib/router.js.map

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

package/lib/settings.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Settings namespace registration for the `cc-context-compression` overlay.
+ * Model-aliases style: the namespace is registered once at mount; the live
+ * scope is re-read on EVERY use so a settings write applies immediately.
+ * @module @dsh-cc/context-crusher/settings
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SettingsNamespace } from '@deepseek-ai/dsh-settings';
+import type { CrusherConfig, ResolvedConfig } from './types.ts';
+/** The settings namespace carrying the live crusher overlay. */
+export declare const SETTINGS_NAMESPACE: SettingsNamespace;
+/** A live settings reader bound at mount; returns undefined without a provider. */
+export type SettingsReader = () => CrusherConfig | undefined;
+/**
+ * Register the settings namespace and return a per-use reader. Graceful
+ * without a settings provider: the reader resolves `undefined` and callers
+ * fall back to the config defaults.
+ * @param ctx - the plug context.
+ * @param base - resolved config-layer defaults (validated once here too).
+ * @returns the live scope reader.
+ */
+export declare function registerSettings(ctx: Context, base: ResolvedConfig): SettingsReader;
+//# sourceMappingURL=settings.d.ts.map

package/lib/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,2BAA2B,CAAA;AAEpF,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE/D,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,EAA+B,iBAAiB,CAAA;AAE/E,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,MAAM,aAAa,GAAG,SAAS,CAAA;AAE5D;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,GAAG,cAAc,CAWnF"}