context-compress 2026.3.21 → 2026.5.0

package/dist/tools/execute-file.js

@@ -0,0 +1,66 @@
+import { resolve } from "node:path";
+import { z } from "zod";
+import { ALL_LANGUAGES } from "../types.js";
+import { isWithinProject } from "../util/path.js";
+const LANGUAGE_ENUM = ALL_LANGUAGES;
+export function registerExecuteFileTool(server, ctx) {
+    const { executor, tracker, projectDir, withExecutionLimit, applyIntentFilter } = ctx;
+    server.tool("execute_file", "Read a file and process it without loading contents into context. The file is read into a FILE_CONTENT variable inside the sandbox. Only your printed summary enters context.\n\nPREFER THIS OVER Read/cat for: log files, data files (CSV, JSON, XML), large source files for analysis, and any file where you need to extract specific information rather than read the entire content.", {
+        path: z.string().describe("Absolute file path or relative to project root"),
+        language: z.enum(LANGUAGE_ENUM).describe("Runtime language"),
+        code: z
+            .string()
+            .describe("Code to process FILE_CONTENT. Print summary via console.log/print/echo/IO.puts."),
+        intent: z.string().optional().describe("What you're looking for in the output."),
+        timeout: z.number().default(30000).describe("Max execution time in ms"),
+    }, async ({ path: filePath, language, code, intent, timeout }) => {
+        const codeBytes = Buffer.byteLength(code);
+        if (codeBytes > 1_024_000) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: code too large (${(codeBytes / 1024).toFixed(0)}KB). Max 1MB.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const absPath = resolve(projectDir, filePath);
+        if (!isWithinProject(absPath, projectDir)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: path "${filePath}" is outside the project directory`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        let result;
+        try {
+            result = await withExecutionLimit(() => executor.executeFile({
+                language,
+                code,
+                filePath: absPath,
+                timeout,
+            }));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return { content: [{ type: "text", text: msg }], isError: true };
+        }
+        let output = result.stdout;
+        if (result.stderr && result.exitCode !== 0) {
+            output += `\n\nSTDERR:\n${result.stderr}`;
+        }
+        if (intent) {
+            output = applyIntentFilter(output, intent, `file:${filePath}`);
+        }
+        const responseBytes = Buffer.byteLength(output);
+        tracker.trackCall("execute_file", responseBytes);
+        return { content: [{ type: "text", text: output }] };
+    });
+}
+//# sourceMappingURL=execute-file.js.map

package/dist/tools/execute-file.js.map

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

package/dist/tools/execute.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "./context.js";
+export declare function registerExecuteTool(server: McpServer, ctx: ToolContext): void;
+//# sourceMappingURL=execute.d.ts.map

package/dist/tools/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/tools/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAgE7E"}

package/dist/tools/execute.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { ALL_LANGUAGES } from "../types.js";
+const LANGUAGE_ENUM = ALL_LANGUAGES;
+export function registerExecuteTool(server, ctx) {
+    const { executor, tracker, withExecutionLimit, applyIntentFilter, bunDetected } = ctx;
+    server.tool("execute", `Execute code in a sandboxed subprocess. Only stdout enters context — raw data stays in the subprocess. Use instead of bash/cat when output would exceed ~5KB. ${bunDetected ? "(Bun detected — JS/TS runs 3-5x faster) " : ""}Available: ${ALL_LANGUAGES.join(", ")}.
+
+PREFER THIS OVER BASH for: API calls (gh, curl, aws), test runners (npm test, pytest), git queries (git log, git diff), data processing, and ANY CLI command that may produce large output. Bash should only be used for file mutations, git writes, and navigation.`, {
+        language: z.enum(LANGUAGE_ENUM).describe("Runtime language"),
+        code: z
+            .string()
+            .describe("Source code to execute. Use console.log (JS/TS), print (Python/Ruby/Perl/R), echo (Shell), echo (PHP), fmt.Println (Go), or IO.puts (Elixir) to output a summary to context."),
+        intent: z
+            .string()
+            .optional()
+            .describe("What you're looking for in the output. When provided and output is large (>5KB), indexes output into knowledge base and returns section titles + previews — not full content. Use search(queries: [...]) to retrieve specific sections."),
+        timeout: z.number().default(30000).describe("Max execution time in ms"),
+    }, async ({ language, code, intent, timeout }) => {
+        const codeBytes = Buffer.byteLength(code);
+        if (codeBytes > 1_024_000) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: code too large (${(codeBytes / 1024).toFixed(0)}KB). Max 1MB.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        let result;
+        try {
+            result = await withExecutionLimit(() => executor.execute({ language, code, timeout }));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return { content: [{ type: "text", text: msg }], isError: true };
+        }
+        if (result.networkBytes) {
+            tracker.trackSandboxed(result.networkBytes);
+        }
+        let output = result.stdout;
+        if (result.stderr && result.exitCode !== 0) {
+            output += `\n\nSTDERR:\n${result.stderr}`;
+        }
+        if (intent) {
+            output = applyIntentFilter(output, intent, `execute:${language}`);
+        }
+        const responseBytes = Buffer.byteLength(output);
+        tracker.trackCall("execute", responseBytes);
+        return { content: [{ type: "text", text: output }] };
+    });
+}
+//# sourceMappingURL=execute.js.map

package/dist/tools/execute.js.map

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

package/dist/tools/fetch-and-index.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "./context.js";
+export declare function registerFetchAndIndexTool(server: McpServer, ctx: ToolContext): void;
+//# sourceMappingURL=fetch-and-index.d.ts.map

package/dist/tools/fetch-and-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-and-index.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-and-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAmGnF"}

package/dist/tools/fetch-and-index.js

@@ -0,0 +1,91 @@
+import { z } from "zod";
+import { isPrivateHost, resolveAndValidate } from "../network.js";
+import { buildFetchCode } from "../util/fetch-code.js";
+import { detectInjectionPatterns } from "../utils.js";
+export function registerFetchAndIndexTool(server, ctx) {
+    const { executor, store, tracker, withExecutionLimit } = ctx;
+    server.tool("fetch_and_index", "Fetches URL content, converts HTML to markdown, indexes into searchable knowledge base, and returns a ~3KB preview. Full content stays in sandbox — use search() for deeper lookups.\n\nBetter than WebFetch: preview is immediate, full content is searchable, raw HTML never enters context.", {
+        url: z.string().describe("The URL to fetch and index"),
+        source: z.string().optional().describe("Label for the indexed content"),
+    }, async ({ url, source }) => {
+        try {
+            const parsed = new URL(url);
+            if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+                return {
+                    content: [{ type: "text", text: "Error: only http/https URLs are allowed" }],
+                    isError: true,
+                };
+            }
+            if (isPrivateHost(parsed.hostname)) {
+                return {
+                    content: [
+                        { type: "text", text: "Error: internal/private URLs are not allowed" },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        catch {
+            return {
+                content: [{ type: "text", text: `Error: invalid URL "${url}"` }],
+                isError: true,
+            };
+        }
+        let resolvedIp = null;
+        try {
+            const validated = await resolveAndValidate(url);
+            resolvedIp = validated.resolvedIp;
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${err instanceof Error ? err.message : "DNS validation failed"}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const label = source ?? url;
+        const fetchCode = buildFetchCode(url, resolvedIp);
+        let result;
+        try {
+            result = await withExecutionLimit(() => executor.execute({
+                language: "javascript",
+                code: fetchCode,
+                timeout: 30_000,
+            }));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return { content: [{ type: "text", text: msg }], isError: true };
+        }
+        if (result.exitCode !== 0 || !result.stdout.trim()) {
+            const errMsg = `Failed to fetch ${url}: ${result.stderr || "empty response"}`;
+            tracker.trackCall("fetch_and_index", Buffer.byteLength(errMsg));
+            return { content: [{ type: "text", text: errMsg }], isError: true };
+        }
+        const markdown = result.stdout;
+        tracker.trackSandboxed(result.networkBytes ?? 0);
+        const injectionWarnings = detectInjectionPatterns(markdown);
+        const indexed = store.index(markdown, label);
+        tracker.trackIndexed(Buffer.byteLength(markdown));
+        const preview = markdown.slice(0, 3072);
+        const terms = store.getDistinctiveTerms(indexed.sourceId);
+        let output = `Indexed "${label}": ${indexed.totalChunks} chunks.\n\n`;
+        output += `**Preview:**\n${preview}`;
+        if (markdown.length > 3072)
+            output += "\n…(truncated)";
+        if (terms.length > 0) {
+            output += `\n\nSearchable terms: ${terms.join(", ")}`;
+        }
+        output += "\n\nUse search(queries: [...]) to retrieve full content of any section.";
+        if (injectionWarnings.length > 0) {
+            output += `\n\n⚠ Content safety notice: detected patterns (${injectionWarnings.join(", ")}). Review indexed content before relying on it.`;
+        }
+        tracker.trackCall("fetch_and_index", Buffer.byteLength(output));
+        return { content: [{ type: "text", text: output }] };
+    });
+}
+//# sourceMappingURL=fetch-and-index.js.map

package/dist/tools/fetch-and-index.js.map

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

package/dist/tools/index-content.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "./context.js";
+export declare function registerIndexTool(server: McpServer, ctx: ToolContext): void;
+//# sourceMappingURL=index-content.d.ts.map

package/dist/tools/index-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-content.d.ts","sourceRoot":"","sources":["../../src/tools/index-content.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAsF3E"}

package/dist/tools/index-content.js

@@ -0,0 +1,85 @@
+import { readFileSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { z } from "zod";
+import { isWithinProject } from "../util/path.js";
+export function registerIndexTool(server, ctx) {
+    const { store, tracker, projectDir } = ctx;
+    server.tool("index", "Index documentation or knowledge content into a searchable BM25 knowledge base. Chunks markdown by headings (keeping code blocks intact) and stores in ephemeral FTS5 database. The full content does NOT stay in context — only a brief summary is returned.\n\nWHEN TO USE:\n- Documentation (API docs, framework guides, code examples)\n- README files, migration guides, changelog entries\n- Any content with code examples you may need to reference precisely\n\nAfter indexing, use 'search' to retrieve specific sections on-demand.", {
+        content: z
+            .string()
+            .optional()
+            .describe("Raw text/markdown to index. Provide this OR path, not both."),
+        path: z
+            .string()
+            .optional()
+            .describe("File path to read and index (content never enters context)."),
+        source: z.string().optional().describe("Label for the indexed content"),
+    }, async ({ content, path: filePath, source }) => {
+        let text;
+        let label = source ?? "indexed content";
+        if (filePath) {
+            const absPath = resolve(projectDir, filePath);
+            if (!isWithinProject(absPath, projectDir)) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: path "${filePath}" is outside the project directory`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            try {
+                const fileStat = statSync(absPath);
+                if (fileStat.size > 50 * 1024 * 1024) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Error: file "${filePath}" is too large (${(fileStat.size / 1024 / 1024).toFixed(1)}MB). Max 50MB.`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                text = readFileSync(absPath, "utf-8");
+                label = source ?? filePath;
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                return {
+                    content: [{ type: "text", text: `Error reading "${filePath}": ${msg}` }],
+                    isError: true,
+                };
+            }
+        }
+        else if (content) {
+            const contentBytes = Buffer.byteLength(content);
+            if (contentBytes > 50 * 1024 * 1024) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: content too large (${(contentBytes / 1024 / 1024).toFixed(1)}MB). Max 50MB.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            text = content;
+        }
+        else {
+            return {
+                content: [{ type: "text", text: "Error: provide either 'content' or 'path'" }],
+                isError: true,
+            };
+        }
+        const result = store.index(text, label);
+        tracker.trackIndexed(Buffer.byteLength(text));
+        const summary = `Indexed "${label}": ${result.totalChunks} chunks (${result.codeChunks} with code). Use search(queries: [...]) to retrieve sections.`;
+        tracker.trackCall("index", Buffer.byteLength(summary));
+        return { content: [{ type: "text", text: summary }] };
+    });
+}
+//# sourceMappingURL=index-content.js.map

package/dist/tools/index-content.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "./context.js";
+export declare function registerSearchTool(server: McpServer, ctx: ToolContext): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CA0E5E"}

package/dist/tools/search.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+export function registerSearchTool(server, ctx) {
+    const { store, tracker, config } = ctx;
+    // Per-server-instance throttling state
+    const searchCalls = [];
+    server.tool("search", "Search indexed content. Pass ALL search questions as queries array in ONE call.\n\nTIPS: 2-4 specific terms per query. Use 'source' to scope results.", {
+        queries: z
+            .array(z.string())
+            .describe("Array of search queries. Batch ALL questions in one call."),
+        source: z
+            .string()
+            .optional()
+            .describe("Filter to a specific indexed source (partial match)."),
+        limit: z.number().default(3).describe("Results per query (default: 3)"),
+    }, async ({ queries, source, limit }) => {
+        const now = Date.now();
+        searchCalls.push(now);
+        while (searchCalls.length > 0 && searchCalls[0] < now - config.searchWindowMs) {
+            searchCalls.shift();
+        }
+        const callCount = searchCalls.length;
+        if (callCount > config.searchBlockAfter) {
+            const msg = "Too many search calls in quick succession. Use batch_execute instead to run commands and search in one call.";
+            tracker.trackCall("search", Buffer.byteLength(msg));
+            return { content: [{ type: "text", text: msg }] };
+        }
+        const effectiveLimit = callCount > config.searchReduceAfter ? 1 : Math.min(limit, config.searchLimit);
+        const allResults = [];
+        let totalBytes = 0;
+        for (const query of queries) {
+            if (totalBytes > config.searchMaxBytes)
+                break;
+            const result = store.search(query, { source, limit: effectiveLimit });
+            let block = `## ${query}\n`;
+            if (result.corrected) {
+                block += `(corrected to: "${result.corrected}")\n`;
+            }
+            if (result.results.length === 0) {
+                block += "No results found.\n";
+            }
+            else {
+                for (const hit of result.results) {
+                    block += `\n--- [${hit.source}] ---\n### ${hit.title}\n\n${hit.snippet}\n`;
+                }
+            }
+            allResults.push(block);
+            totalBytes += Buffer.byteLength(block);
+        }
+        if (callCount > config.searchReduceAfter) {
+            allResults.push(`\n⚠ Search rate limited (${callCount} calls in ${config.searchWindowMs / 1000}s). Results reduced to 1 per query.`);
+        }
+        const output = allResults.join("\n---\n\n");
+        tracker.trackCall("search", Buffer.byteLength(output));
+        return { content: [{ type: "text", text: output }] };
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/tools/stats.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "./context.js";
+export declare function registerStatsTool(server: McpServer, ctx: ToolContext): void;
+//# sourceMappingURL=stats.d.ts.map

package/dist/tools/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/tools/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAc3E"}

package/dist/tools/stats.js

@@ -0,0 +1,10 @@
+export function registerStatsTool(server, ctx) {
+    const { tracker } = ctx;
+    server.tool("stats", "Returns context consumption statistics for the current session. Shows total bytes returned to context, breakdown by tool, call counts, estimated token usage, context savings ratio, and visual charts.", {}, async () => {
+        tracker.saveCumulative();
+        const report = tracker.formatReport();
+        tracker.trackCall("stats", Buffer.byteLength(report));
+        return { content: [{ type: "text", text: report }] };
+    });
+}
+//# sourceMappingURL=stats.js.map

package/dist/tools/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/tools/stats.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,GAAgB;IACpE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IAExB,MAAM,CAAC,IAAI,CACV,OAAO,EACP,yMAAyM,EACzM,EAAE,EACF,KAAK,IAAI,EAAE;QACV,OAAO,CAAC,cAAc,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;QACtC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC/D,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -53,4 +53,15 @@ export interface SessionStats {
     bytesSandboxed: number;
     sessionStart: number;
 }
+export interface CumulativeStats {
+    totalBytesSaved: number;
+    totalBytesProcessed: number;
+    totalCalls: number;
+    totalSessions: number;
+    firstSeen: string;
+    lastSeen: string;
+    perCommand: Record<string, {
+        calls: number;
+    }>;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GACjB,YAAY,GACZ,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,MAAM,GACN,IAAI,GACJ,MAAM,GACN,KAAK,GACL,MAAM,GACN,GAAG,GACH,QAAQ,CAAC;AAEZ,eAAO,MAAM,aAAa,EAAE,SAAS,QAAQ,EAYnC,CAAC;AAEX,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IACnD,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,KAAK;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GACjB,YAAY,GACZ,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,MAAM,GACN,IAAI,GACJ,MAAM,GACN,KAAK,GACL,MAAM,GACN,GAAG,GACH,QAAQ,CAAC;AAEZ,eAAO,MAAM,aAAa,EAAE,SAAS,QAAQ,EAYnC,CAAC;AAEX,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IACnD,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,KAAK;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C"}

package/dist/util/auto-mode.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Auto mode: ask an LLM to pick the best compression mode for a given output.
+ *
+ * Backends, in priority order:
+ *   1. Anthropic API     (fastest; needs ANTHROPIC_API_KEY)
+ *   2. `claude -p` CLI   (works in Claude Code environments; ~3s per call)
+ *   3. Heuristic         (last resort, no LLM)
+ *
+ * Decisions are cached per command fingerprint with a 24h TTL so repeated
+ * commands don't pay the LLM round-trip cost. Cache lives at
+ * ~/.context-compress/auto-cache.json so it survives across sessions.
+ */
+import type { FilterMode } from "../filters.js";
+export interface AutoOptions {
+    apiKey?: string;
+    model?: string;
+    timeoutMs?: number;
+    /** When true, do not read or write the cache. Useful for benchmarks. */
+    noCache?: boolean;
+    /** When true, skip API + CLI and use the heuristic. Useful for tests. */
+    noLlm?: boolean;
+}
+/**
+ * Heuristic last-resort: pick a sensible mode without touching the LLM.
+ * This is what auto mode degrades to when both API and CLI are unavailable
+ * (or when AutoOptions.noLlm is true).
+ *
+ * Exported so callers / tests can use the heuristic directly.
+ */
+export declare function heuristicMode(cmd: string, output: string): FilterMode;
+export interface AutoResult {
+    mode: FilterMode;
+    source: "cache" | "api" | "cli" | "heuristic";
+}
+/**
+ * Pick a compression mode for the given command + output. Tries the LLM
+ * (API → CLI), falls back to a heuristic. Caches per-command-fingerprint.
+ */
+export declare function pickModeAuto(cmd: string, output: string, opts?: AutoOptions): Promise<AutoResult>;
+//# sourceMappingURL=auto-mode.d.ts.map

package/dist/util/auto-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-mode.d.ts","sourceRoot":"","sources":["../../src/util/auto-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAchD,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAsGD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAQrE;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAsB,YAAY,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,WAAgB,GACpB,OAAO,CAAC,UAAU,CAAC,CAoCrB"}