pi-agent-flow 2.2.33 → 2.3.1

package/dist/cli/format.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Output formatter for chained CLI ops.
+ */
+export interface ChainedOp {
+    cmd: string;
+    output: string;
+    error?: string;
+    failed?: boolean;
+    skipped?: boolean;
+}
+export declare function formatChainedOutput(ops: ChainedOp[]): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/cli/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,CAwB5D"}

package/dist/cli/format.js

@@ -0,0 +1,29 @@
+/**
+ * Output formatter for chained CLI ops.
+ */
+export function formatChainedOutput(ops) {
+    const total = ops.length;
+    if (total === 1 && !ops[0].skipped) {
+        if (ops[0].error) {
+            return `ERROR: ${ops[0].error}`;
+        }
+        return ops[0].output;
+    }
+    const sections = [];
+    for (let i = 0; i < ops.length; i++) {
+        const op = ops[i];
+        const header = `--- op ${i + 1}/${total}: ${op.skipped ? `SKIPPED (previous failed)` : op.cmd} ---`;
+        sections.push(header);
+        if (op.skipped) {
+            continue;
+        }
+        if (op.error) {
+            sections.push(`ERROR: ${op.error}`);
+        }
+        else {
+            sections.push(op.output);
+        }
+    }
+    return sections.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/cli/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/cli/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,MAAM,UAAU,mBAAmB,CAAC,GAAgB;IAClD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC;IACzB,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAClC,CAAC;QACD,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAClB,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;QACpG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/cli/help.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Man-page style help generator.
+ */
+import { type FlagSpec } from "./parse.js";
+export interface SubcommandHelp {
+    name: string;
+    description: string;
+    flags: Record<string, {
+        short?: string;
+        type: string;
+        description: string;
+    }>;
+}
+export declare function flagSpecToHelp(flags: FlagSpec): SubcommandHelp["flags"];
+export declare function renderHelp(toolName: string, description: string, subcommands: SubcommandHelp[]): string;
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAUvE;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,cAAc,EAAE,GAC5B,MAAM,CAyBR"}

package/dist/cli/help.js

@@ -0,0 +1,42 @@
+/**
+ * Man-page style help generator.
+ */
+export function flagSpecToHelp(flags) {
+    const result = {};
+    for (const [name, cfg] of Object.entries(flags)) {
+        result[name] = {
+            short: cfg.short,
+            type: cfg.type,
+            description: cfg.description ?? "",
+        };
+    }
+    return result;
+}
+export function renderHelp(toolName, description, subcommands) {
+    const lines = [];
+    lines.push(`USAGE: ${toolName} <subcommand> [flags] [args]`);
+    lines.push("");
+    lines.push(description);
+    lines.push("");
+    lines.push("SUBCOMMANDS:");
+    for (const sub of subcommands) {
+        lines.push(`  ${sub.name.padEnd(12)}  ${sub.description}`);
+    }
+    lines.push("");
+    for (const sub of subcommands) {
+        lines.push(`${sub.name.toUpperCase()} FLAGS:`);
+        const entries = Object.entries(sub.flags);
+        if (entries.length === 0) {
+            lines.push("  (none)");
+        }
+        else {
+            for (const [name, cfg] of entries) {
+                const short = cfg.short ? `-${cfg.short}, ` : "";
+                lines.push(`  ${short}--${name.padEnd(14)}  ${cfg.description}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;SACnC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,WAAmB,EACnB,WAA6B;IAE7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,UAAU,QAAQ,8BAA8B,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;gBAClC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/cli/parse.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CLI argument parser.
+ *
+ * Parses a token array into subcommand, flags, and positionals.
+ */
+export interface FlagSpec {
+    [name: string]: {
+        short?: string;
+        type: "boolean" | "string" | "number";
+        description?: string;
+        multi?: boolean;
+    };
+}
+export interface ParsedCommand {
+    subcommand: string;
+    flags: Record<string, string | number | boolean | Array<string | number | boolean>>;
+    positionals: string[];
+}
+export declare class CliError extends Error {
+    hint?: string;
+    constructor(message: string, hint?: string);
+}
+export declare function parseCommand(tokens: string[], spec: FlagSpec): ParsedCommand;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/cli/parse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,QAAQ;IACvB,CAAC,IAAI,EAAE,MAAM,GAAG;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACtC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IACpF,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;gBACF,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAK3C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,aAAa,CAqJ5E"}

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 === "") {
+                        throw new CliError(`Flag --${name} requires a numeric value.`);
+                    }
+                    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 === "") {
+                            throw new CliError(`Flag -${ch} (--${name}) requires a numeric value.`);
+                        }
+                        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,69 @@
+/**
+ * batch_read, batch, and ask_user CLI tool factories.
+ */
+import { createAskUserCliTool } from "../tools/ask-user.js";
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+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: ExtensionContext): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        details: {
+            results: any[];
+        };
+        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: ExtensionContext): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        details: {
+            results: any[];
+        };
+        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 { createAskUserCliTool };
+//# 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;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAmFjE,wBAAgB,sBAAsB;;;;;;;yBA/CnB,MAAM,SACZ,OAAO,UACN,WAAW,GAAG,SAAS,aACpB,OAAO,OACb,gBAAgB;;;;;;;;;;;;;;;;;uBAqCJ,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;EAerJ;AAED,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,kBAAkB,EAAE,YAAY,CAAC,EAAE,OAAO;;;;;;;yBA3DxE,MAAM,SACZ,OAAO,UACN,WAAW,GAAG,SAAS,aACpB,OAAO,OACb,gBAAgB;;;;;;;;;;;;;;;;;uBAqCJ,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;EA8BrJ;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/cli/register.js

@@ -0,0 +1,82 @@
+/**
+ * batch_read, batch, and ask_user CLI tool factories.
+ */
+import { createAskUserCliTool } from "../tools/ask-user.js";
+import { CliError } from "./parse.js";
+import { renderBatchReadResult, renderBatchReadCall } from "../batch/render.js";
+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";
+function createCliTool(config) {
+    return {
+        name: config.name,
+        label: config.label,
+        description: config.description,
+        promptSnippet: config.promptSnippet,
+        promptGuidelines: config.promptGuidelines,
+        parameters: config.parameters,
+        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 config.runner(cmd, cwd, signal, ctx);
+                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 createBatchReadCliTool() {
+    return createCliTool({
+        name: "batch_read",
+        label: "batch_read",
+        description: BATCH_READ_CLI_DESCRIPTION,
+        promptSnippet: BATCH_READ_CLI_SNIPPET,
+        promptGuidelines: BATCH_READ_CLI_GUIDELINES,
+        parameters: BatchReadCliParams,
+        runner: (cmd, cwd, signal) => runBatchReadCli(cmd, cwd, signal),
+    });
+}
+export function createBatchCliTool(bashTracker, toolOptimize) {
+    return createCliTool({
+        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,
+        runner: (cmd, cwd, signal, ctx) => runBatchCli(cmd, cwd, bashTracker, ctx.sessionManager, signal),
+    });
+}
+export { createAskUserCliTool };
+//# 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/runner.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Generic chain execution helper for bash-style CLI tools.
+ */
+import { type ChainOp } from "./chain.js";
+import { type FlagSpec, type ParsedCommand } from "./parse.js";
+import type { ExecResult } from "./exec/util.js";
+import type { OpResult } from "../batch/constants.js";
+export interface ChainConfig {
+    toolPrefix: string;
+    recognizedSubs: Set<string>;
+    getFlagSpec: (subcommand: string) => FlagSpec;
+    dispatch: (subcommand: string, parsed: ParsedCommand, cwd: string, signal?: AbortSignal, extra?: unknown) => Promise<ExecResult>;
+    helpText: string;
+    validSubcommandsTip: string;
+    preprocessLink?: (link: ChainOp) => {
+        cmd: string;
+        extra?: unknown;
+    };
+    fixedSubcommand?: string;
+}
+export declare function runChain(cmd: string, cwd: string, signal: AbortSignal | undefined, config: ChainConfig): Promise<{
+    text: string;
+    results: OpResult[];
+    hasError: boolean;
+    errors: Array<{
+        message: string;
+        hint?: string;
+    }>;
+}>;
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAA0B,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,QAAQ,CAAC;IAC9C,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACjI,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAgGtH"}

package/dist/cli/runner.js

@@ -0,0 +1,102 @@
+/**
+ * Generic chain execution helper for bash-style CLI tools.
+ */
+import { tokenize } from "./tokenize.js";
+import { splitChain } from "./chain.js";
+import { parseCommand, CliError } from "./parse.js";
+import { formatChainedOutput } from "./format.js";
+export async function runChain(cmd, cwd, signal, config) {
+    const trimmed = cmd.trim();
+    if (trimmed.length === 0) {
+        return { text: config.helpText, results: [], hasError: false, errors: [] };
+    }
+    const chain = splitChain(trimmed);
+    const ops = [];
+    let previousFailed = false;
+    const allResults = [];
+    const errors = [];
+    for (const link of chain) {
+        if (link.kind === "and" && previousFailed) {
+            ops.push({ cmd: link.cmd, output: "", skipped: true });
+            continue;
+        }
+        let output = "";
+        let failed = false;
+        let error;
+        let linkExtra = undefined;
+        try {
+            const processed = config.preprocessLink ? config.preprocessLink(link) : { cmd: link.cmd };
+            linkExtra = processed.extra;
+            const tokens = tokenize(processed.cmd);
+            // Remove leading tool keyword if present (the model may include it)
+            if (tokens[0] === config.toolPrefix) {
+                tokens.shift();
+            }
+            if (tokens.length === 0) {
+                output = config.helpText;
+            }
+            else {
+                const subcommand = config.fixedSubcommand ?? tokens[0];
+                if (subcommand === "help" || subcommand === "--help" || subcommand === "-h") {
+                    output = config.helpText;
+                }
+                else {
+                    let parsed;
+                    const shouldParse = config.fixedSubcommand || config.recognizedSubs.has(subcommand);
+                    if (!shouldParse) {
+                        // Defer to dispatch's default branch for a clear "Unknown subcommand" error.
+                        parsed = { subcommand, flags: {}, positionals: tokens.slice(1) };
+                    }
+                    else {
+                        const flagSpec = config.getFlagSpec(subcommand);
+                        const tokensToParse = config.fixedSubcommand ? [subcommand, ...tokens] : tokens;
+                        try {
+                            parsed = parseCommand(tokensToParse, flagSpec);
+                        }
+                        catch (err) {
+                            if (err instanceof CliError && err.message.startsWith("Unknown flag")) {
+                                const validFlags = Object.keys(flagSpec).map((n) => `--${n}`).join(", ");
+                                throw new CliError(err.message, `\`${subcommand}\` supports: ${validFlags}. Run [cmd]: "help" for the man page.`);
+                            }
+                            throw err;
+                        }
+                    }
+                    if (parsed.flags.help === true) {
+                        output = config.helpText;
+                    }
+                    else {
+                        const result = await config.dispatch(parsed.subcommand, parsed, cwd, signal, linkExtra);
+                        output = result.output;
+                        allResults.push(...result.results);
+                        if (result.failed) {
+                            failed = true;
+                            error = `${result.error ?? "operation failed"}\nTIP: This is not a shell. Valid subcommands: ${config.validSubcommandsTip}. Run [cmd]: "help" for the man page.`;
+                        }
+                    }
+                }
+            }
+        }
+        catch (err) {
+            failed = true;
+            if (err instanceof CliError) {
+                const baseError = err.hint ? `${err.message} (hint: ${err.hint})` : err.message;
+                error = `${baseError}\nTIP: This is not a shell. Valid subcommands: ${config.validSubcommandsTip}. Run [cmd]: "help" for the man page.`;
+                errors.push({ message: err.message, hint: err.hint });
+            }
+            else {
+                error = `internal error: ${err instanceof Error ? err.message : String(err)}`;
+                errors.push({ message: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        ops.push({ cmd: link.cmd, output, error, failed, skipped: false });
+        if (failed) {
+            previousFailed = true;
+        }
+        else {
+            previousFailed = false;
+        }
+    }
+    const hasError = ops.some((op) => op.error !== undefined || op.skipped || op.failed) || errors.length > 0;
+    return { text: formatChainedOutput(ops), results: allResults, hasError, errors };
+}
+//# sourceMappingURL=runner.js.map

package/dist/cli/runner.js.map

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