pi-agent-flow 2.2.32 → 2.3.0

package/dist/cli/parse.js

@@ -0,0 +1,165 @@
+/**
+ * CLI argument parser.
+ *
+ * Parses a token array into subcommand, flags, and positionals.
+ */
+export class CliError extends Error {
+    hint;
+    constructor(message, hint) {
+        super(message);
+        this.name = "CliError";
+        this.hint = hint;
+    }
+}
+export function parseCommand(tokens, spec) {
+    if (tokens.length === 0) {
+        throw new CliError("No command provided.");
+    }
+    const subcommand = tokens[0];
+    const flags = {};
+    const positionals = [];
+    let endOfFlags = false;
+    // Build reverse map: short char -> flag name
+    const shortMap = {};
+    for (const [name, cfg] of Object.entries(spec)) {
+        if (cfg.short) {
+            shortMap[cfg.short] = name;
+        }
+    }
+    for (let i = 1; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (token === "--") {
+            endOfFlags = true;
+            continue;
+        }
+        if (endOfFlags) {
+            positionals.push(token);
+            continue;
+        }
+        if (token.startsWith("--")) {
+            const eqIdx = token.indexOf("=");
+            let name;
+            let value;
+            if (eqIdx >= 0) {
+                name = token.slice(2, eqIdx);
+                value = token.slice(eqIdx + 1);
+            }
+            else {
+                name = token.slice(2);
+            }
+            if (!spec[name]) {
+                throw new CliError(`Unknown flag: --${name}`, `Run with --help for available flags.`);
+            }
+            const cfg = spec[name];
+            if (cfg.type === "boolean") {
+                if (cfg.multi) {
+                    const existing = flags[name];
+                    flags[name] = Array.isArray(existing) ? [...existing, true] : [true];
+                }
+                else {
+                    flags[name] = true;
+                }
+            }
+            else {
+                if (value === undefined) {
+                    if (i + 1 >= tokens.length) {
+                        throw new CliError(`Flag --${name} requires a value.`);
+                    }
+                    value = tokens[++i];
+                }
+                let parsedValue;
+                if (cfg.type === "number") {
+                    if (value === "") {
+                        parsedValue = "";
+                    }
+                    else {
+                        const num = Number(value);
+                        if (!Number.isFinite(num)) {
+                            throw new CliError(`Flag --${name} expects a number, got: ${value}`);
+                        }
+                        parsedValue = num;
+                    }
+                }
+                else {
+                    parsedValue = value;
+                }
+                if (cfg.multi) {
+                    const existing = flags[name];
+                    flags[name] = Array.isArray(existing) ? [...existing, parsedValue] : [parsedValue];
+                }
+                else {
+                    flags[name] = parsedValue;
+                }
+            }
+            continue;
+        }
+        if (token.startsWith("-") && token.length > 1) {
+            // Could be bundled booleans or a short flag with value
+            const chars = token.slice(1);
+            for (let j = 0; j < chars.length; j++) {
+                const ch = chars[j];
+                const name = shortMap[ch];
+                if (!name) {
+                    throw new CliError(`Unknown flag: -${ch}`, `Run with --help for available flags.`);
+                }
+                const cfg = spec[name];
+                if (cfg.type === "boolean") {
+                    if (cfg.multi) {
+                        const existing = flags[name];
+                        flags[name] = Array.isArray(existing) ? [...existing, true] : [true];
+                    }
+                    else {
+                        flags[name] = true;
+                    }
+                }
+                else {
+                    // Non-boolean short flag: if it's the last char in the bundle,
+                    // consume the next token as value. Otherwise, consume the rest of this token.
+                    let value;
+                    if (j === chars.length - 1) {
+                        if (i + 1 >= tokens.length) {
+                            throw new CliError(`Flag -${ch} (--${name}) requires a value.`);
+                        }
+                        value = tokens[++i];
+                    }
+                    else {
+                        value = chars.slice(j + 1);
+                        // Handle = separator in bundled short flags (e.g., -n=foo)
+                        if (value.startsWith("=")) {
+                            value = value.slice(1);
+                        }
+                        j = chars.length; // break out of inner loop
+                    }
+                    let parsedValue;
+                    if (cfg.type === "number") {
+                        if (value === "") {
+                            parsedValue = "";
+                        }
+                        else {
+                            const num = Number(value);
+                            if (!Number.isFinite(num)) {
+                                throw new CliError(`Flag -${ch} (--${name}) expects a number, got: ${value}`);
+                            }
+                            parsedValue = num;
+                        }
+                    }
+                    else {
+                        parsedValue = value;
+                    }
+                    if (cfg.multi) {
+                        const existing = flags[name];
+                        flags[name] = Array.isArray(existing) ? [...existing, parsedValue] : [parsedValue];
+                    }
+                    else {
+                        flags[name] = parsedValue;
+                    }
+                    break;
+                }
+            }
+            continue;
+        }
+        positionals.push(token);
+    }
+    return { subcommand, flags, positionals };
+}
+//# sourceMappingURL=parse.js.map

package/dist/cli/parse.js.map

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

package/dist/cli/register.d.ts

@@ -0,0 +1,73 @@
+/**
+ * batch_read and batch CLI tool factories.
+ */
+import type { BatchTheme } from "../batch/constants.js";
+import type { BashProcessTracker } from "../batch/batch-bash.js";
+export declare function createBatchReadCliTool(): {
+    name: string;
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: any;
+    execute(_toolCallId: string, input: unknown, signal: AbortSignal | undefined, _onUpdate: unknown, ctx: {
+        cwd: string;
+    }): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        details: {
+            results: import("../batch/constants.js").OpResult[];
+        };
+        isError: true | undefined;
+    } | {
+        isError: boolean;
+        content: {
+            type: string;
+            text: string;
+        }[];
+        details?: undefined;
+    }>;
+    renderCall: (args: Record<string, unknown>, theme: BatchTheme) => import("@earendil-works/pi-tui").Container;
+    renderResult: (result: any, { expanded, isPartial }: {
+        expanded: boolean;
+        isPartial?: boolean;
+    }, theme: BatchTheme, args?: Record<string, unknown>) => any;
+};
+export declare function createBatchCliTool(bashTracker?: BashProcessTracker, toolOptimize?: boolean): {
+    name: string;
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: any;
+    execute(_toolCallId: string, input: unknown, signal: AbortSignal | undefined, _onUpdate: unknown, ctx: {
+        cwd: string;
+        sessionManager?: {
+            getSessionDir(): string;
+        };
+    }): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        details: {
+            results: import("../batch/constants.js").OpResult[];
+        };
+        isError: true | undefined;
+    } | {
+        isError: boolean;
+        content: {
+            type: string;
+            text: string;
+        }[];
+        details?: undefined;
+    }>;
+    renderCall: (args: Record<string, unknown>, theme: BatchTheme) => import("@earendil-works/pi-tui").Container;
+    renderResult: (result: any, { expanded, isPartial }: {
+        expanded: boolean;
+        isPartial?: boolean;
+    }, theme: BatchTheme, args?: Record<string, unknown>) => any;
+};
+//# sourceMappingURL=register.d.ts.map

package/dist/cli/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/cli/register.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,wBAAgB,sBAAsB;;;;;;;yBAUnB,MAAM,SACZ,OAAO,UACN,WAAW,GAAG,SAAS,aACpB,OAAO,OACb;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;uBAqCH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,UAAU;2BACtC,GAAG,2BAA2B;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,SAAS,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAGrJ;AAED,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,kBAAkB,EAAE,YAAY,CAAC,EAAE,OAAO;;;;;;;yBAaxE,MAAM,SACZ,OAAO,UACN,WAAW,GAAG,SAAS,aACpB,OAAO,OACb;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE;YAAE,aAAa,IAAI,MAAM,CAAA;SAAE,CAAA;KAAE;;;;;;;;;;;;;;;;;uBAqCjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,UAAU;2BACtC,GAAG,2BAA2B;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,SAAS,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAGrJ"}

package/dist/cli/register.js

@@ -0,0 +1,105 @@
+/**
+ * batch_read and batch CLI tool factories.
+ */
+import { runBatchReadCli, BatchReadCliParams, BATCH_READ_CLI_DESCRIPTION, BATCH_READ_CLI_SNIPPET, BATCH_READ_CLI_GUIDELINES, } from "./batch-read.js";
+import { runBatchCli, BatchCliParams, BATCH_CLI_DESCRIPTION, BATCH_CLI_SNIPPET, BATCH_CLI_GUIDELINES, } from "./batch.js";
+import { CliError } from "./parse.js";
+import { renderBatchReadResult, renderBatchReadCall } from "../batch/render.js";
+export function createBatchReadCliTool() {
+    return {
+        name: "batch_read",
+        label: "batch_read",
+        description: BATCH_READ_CLI_DESCRIPTION,
+        promptSnippet: BATCH_READ_CLI_SNIPPET,
+        promptGuidelines: BATCH_READ_CLI_GUIDELINES,
+        parameters: BatchReadCliParams,
+        async execute(_toolCallId, input, signal, _onUpdate, ctx) {
+            let cmd;
+            let cwd;
+            if (input && typeof input === "object") {
+                const args = input;
+                cmd = typeof args.cmd === "string" ? args.cmd : "";
+                cwd = typeof args.cwd === "string" ? args.cwd : ctx.cwd;
+            }
+            else {
+                cmd = "";
+                cwd = ctx.cwd;
+            }
+            try {
+                const { text, results, hasError } = await runBatchReadCli(cmd, cwd, signal);
+                return {
+                    content: [{ type: "text", text }],
+                    details: { results },
+                    isError: hasError || undefined,
+                };
+            }
+            catch (err) {
+                if (err instanceof CliError) {
+                    const hint = err.hint ? `\nHint: ${err.hint}` : "";
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: `Error: ${err.message}${hint}` }],
+                    };
+                }
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Error: ${message}` }],
+                };
+            }
+        },
+        renderCall: (args, theme) => renderBatchReadCall(args, theme),
+        renderResult: (result, { expanded, isPartial }, theme, args) => renderBatchReadResult(result, { expanded, isPartial: isPartial ?? false }, theme, args),
+    };
+}
+export function createBatchCliTool(bashTracker, toolOptimize) {
+    return {
+        name: "batch",
+        label: "batch",
+        description: BATCH_CLI_DESCRIPTION,
+        promptSnippet: BATCH_CLI_SNIPPET,
+        promptGuidelines: [
+            ...BATCH_CLI_GUIDELINES,
+            ...(toolOptimize ? ["Batch is your ONLY edit tool — no separate edit command."] : []),
+        ],
+        parameters: BatchCliParams,
+        async execute(_toolCallId, input, signal, _onUpdate, ctx) {
+            let cmd;
+            let cwd;
+            if (input && typeof input === "object") {
+                const args = input;
+                cmd = typeof args.cmd === "string" ? args.cmd : "";
+                cwd = typeof args.cwd === "string" ? args.cwd : ctx.cwd;
+            }
+            else {
+                cmd = "";
+                cwd = ctx.cwd;
+            }
+            try {
+                const { text, results, hasError } = await runBatchCli(cmd, cwd, bashTracker, ctx.sessionManager, signal);
+                return {
+                    content: [{ type: "text", text }],
+                    details: { results },
+                    isError: hasError || undefined,
+                };
+            }
+            catch (err) {
+                if (err instanceof CliError) {
+                    const hint = err.hint ? `\nHint: ${err.hint}` : "";
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: `Error: ${err.message}${hint}` }],
+                    };
+                }
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Error: ${message}` }],
+                };
+            }
+        },
+        renderCall: (args, theme) => renderBatchReadCall(args, theme),
+        renderResult: (result, { expanded, isPartial }, theme, args) => renderBatchReadResult(result, { expanded, isPartial: isPartial ?? false }, theme, args),
+    };
+}
+//# sourceMappingURL=register.js.map

package/dist/cli/register.js.map

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

package/dist/cli/tokenize.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shell-style tokenizer.
+ *
+ * Splits a string into tokens respecting single quotes, double quotes,
+ * and backslash escapes. Does NOT split on `;` or `&&` — that's the
+ * chain splitter's job.
+ */
+export declare function tokenize(input: string): string[];
+//# sourceMappingURL=tokenize.d.ts.map

package/dist/cli/tokenize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../src/cli/tokenize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA+EhD"}

package/dist/cli/tokenize.js

@@ -0,0 +1,80 @@
+/**
+ * Shell-style tokenizer.
+ *
+ * Splits a string into tokens respecting single quotes, double quotes,
+ * and backslash escapes. Does NOT split on `;` or `&&` — that's the
+ * chain splitter's job.
+ */
+export function tokenize(input) {
+    const tokens = [];
+    let current = "";
+    let inSingle = false;
+    let inDouble = false;
+    let escapeNext = false;
+    for (let i = 0; i < input.length; i++) {
+        const ch = input[i];
+        if (escapeNext) {
+            if (inDouble) {
+                // In double quotes, only \", \\, and backslash-newline are special;
+                // everything else keeps the backslash literal.
+                if (ch === '"' || ch === '\\') {
+                    current += ch;
+                }
+                else {
+                    current += '\\' + ch;
+                }
+            }
+            else {
+                current += ch;
+            }
+            escapeNext = false;
+            continue;
+        }
+        if (ch === '\\' && !inSingle) {
+            escapeNext = true;
+            continue;
+        }
+        if (inSingle) {
+            if (ch === "'") {
+                inSingle = false;
+            }
+            else {
+                current += ch;
+            }
+            continue;
+        }
+        if (inDouble) {
+            if (ch === '"') {
+                inDouble = false;
+            }
+            else {
+                current += ch;
+            }
+            continue;
+        }
+        if (ch === "'") {
+            inSingle = true;
+            continue;
+        }
+        if (ch === '"') {
+            inDouble = true;
+            continue;
+        }
+        if (ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r') {
+            if (current.length > 0) {
+                tokens.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += ch;
+    }
+    if (escapeNext) {
+        current += '\\';
+    }
+    if (current.length > 0) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+//# sourceMappingURL=tokenize.js.map

package/dist/cli/tokenize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.js","sourceRoot":"","sources":["../../src/cli/tokenize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,QAAQ,EAAE,CAAC;gBACb,oEAAoE;gBACpE,+CAA+C;gBAC/C,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;oBAC9B,OAAO,IAAI,EAAE,CAAC;gBAChB,CAAC;qBAAM,CAAC;oBACN,OAAO,IAAI,IAAI,GAAG,EAAE,CAAC;gBACvB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;YACD,UAAU,GAAG,KAAK,CAAC;YACnB,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,UAAU,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAC5D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;YACD,SAAS;QACX,CAAC;QAED,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core2/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/core2/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAsB,MAAM,mBAAmB,CAAC;AAGtF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC3C,cAAc,EAAE,qBAAqB,EACrC,OAAO,CAAC,EAAE,yBAAyB,EACnC,gBAAgB,CAAC,EAAE,MAAM,GACvB;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAiGvD;AAED,MAAM,WAAW,qBAAqB;IACrC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,OAAO,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,kBAAkB,CAAC,EAAE,cAAc,CAAC;IACpC,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAqBD,sEAAsE;AACtE,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAExE;AAyHD,wBAAgB,kBAAkB,CACjC,cAAc,EAAE,qBAAqB,EACrC,OAAO,CAAC,EAAE,yBAAyB,GACjC,MAAM,GAAG,IAAI,CA8Ff;AAilCD,MAAM,WAAW,aAAa;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,GAAG,SAAS,CAsG1F"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/core2/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAsB,MAAM,mBAAmB,CAAC;AAUtF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC3C,cAAc,EAAE,qBAAqB,EACrC,OAAO,CAAC,EAAE,yBAAyB,EACnC,gBAAgB,CAAC,EAAE,MAAM,GACvB;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAiGvD;AAED,MAAM,WAAW,qBAAqB;IACrC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,OAAO,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,kBAAkB,CAAC,EAAE,cAAc,CAAC;IACpC,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAqBD,sEAAsE;AACtE,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAExE;AAyHD,wBAAgB,kBAAkB,CACjC,cAAc,EAAE,qBAAqB,EACrC,OAAO,CAAC,EAAE,yBAAyB,GACjC,MAAM,GAAG,IAAI,CA8Ff;AA8lCD,MAAM,WAAW,aAAa;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,GAAG,SAAS,CAsG1F"}

package/dist/core2/snapshot.js

@@ -7,6 +7,13 @@
  */
 import { stripDirectives } from "../steering/tool-utils.js";
 import { logWarn } from "../config/log.js";
+/** Extract --intent value from a trace cmd string for collapse deduplication. */
+function extractIntentFromTraceCmd(cmd) {
+    if (typeof cmd !== "string")
+        return "";
+    const m = cmd.match(/--intent(?:=|\s+)(?:"([^"]*)"|'([^']*)'|(\S+))/);
+    return m ? (m[1] || m[2] || m[3] || "").trim() : "";
+}
 /**
  * Build a snapshot with optional context compression. If the estimated token
  * count exceeds the threshold (or an override is set), a second pass applies
@@ -525,6 +532,18 @@ function optimizeSharedContext(branchEntries) {
                         }
                     }
                 }
+                else if (name === "trace" && tc.arguments) {
+                    // Trace is a leaf tool with disposable child transcripts.
+                    // Key by intent so the latest trace of the same exploration
+                    // supersedes earlier ones. Empty/missing intent falls back to
+                    // a generic "trace" key (matches existing flow dedup semantics
+                    // where the latest run always wins).
+                    const intent = (tc.arguments.intent || extractIntentFromTraceCmd(tc.arguments.cmd) || "").trim();
+                    const key = intent ? `trace:${intent.slice(0, 80)}` : "trace";
+                    toolCallMap.set(id, { toolName: "trace", keys: [key], isReadWrite: false, op: "trace" });
+                    const existing = lastExecution.get(key);
+                    lastExecution.set(key, { toolCallId: id, count: (existing?.count ?? 0) + 1 });
+                }
             }
         }
     }
@@ -551,6 +570,9 @@ function optimizeSharedContext(branchEntries) {
                 const flowType = info.keys[0]?.split(":")[1] || "output";
                 newContent = `[Flow ${flowType} output omitted; superseded by later run]`;
             }
+            else if (info.toolName === "trace") {
+                newContent = `[Trace output omitted; superseded by later trace]`;
+            }
             else if (info.isReadWrite) {
                 const countEntry = lastExecution.get(info.keys[0]);
                 const count = countEntry?.count ?? 1;