@vextlabs/theron-cli 0.2.1 → 0.4.0

package/dist/tools/index.js

@@ -11,7 +11,18 @@ import { execBash } from "./bash.js";
 import { execGlob } from "./glob.js";
 import { execGrep } from "./grep.js";
 import { execLs } from "./ls.js";
+import { execMultiEdit } from "./multiedit.js";
+import { execWebFetch } from "./webfetch.js";
+import { execWebSearch } from "./websearch.js";
+import { execTask } from "./task.js";
+import { execTodoWrite } from "./todowrite.js";
 import { execStoa, STOA_TOOL_DESCRIBE, STOA_TOOL_SCHEMA } from "./stoa.js";
+import { buildLocalToolSchemas, MUTATING_LOCAL_TOOLS } from "@vextlabs/theron-agent-sdk";
+let _loadedSkills = [];
+/** Called by repl.ts after loadAllMarkdownSkills() resolves. */
+export function setLoadedSkills(skills) {
+    _loadedSkills = skills;
+}
 export const TOOL_REGISTRY = {
     Read: {
         name: "Read",
@@ -64,125 +75,250 @@ export const TOOL_REGISTRY = {
         execute: (args, ctx) => execStoa(args, ctx),
         describe: STOA_TOOL_DESCRIBE,
     },
+    MultiEdit: {
+        name: "MultiEdit",
+        confirmPolicy: "always",
+        execute: (args, ctx) => execMultiEdit(args, ctx),
+        describe: (args) => `MultiEdit ${args.file_path}`,
+    },
+    WebFetch: {
+        name: "WebFetch",
+        confirmPolicy: "never",
+        execute: (args, ctx) => execWebFetch(args, ctx),
+        describe: (args) => `Fetching ${args.url}`,
+    },
+    WebSearch: {
+        name: "WebSearch",
+        confirmPolicy: "never",
+        execute: (args, ctx) => execWebSearch(args, ctx),
+        describe: (args) => `Searching: ${args.query}`,
+    },
+    Task: {
+        name: "Task",
+        confirmPolicy: "always",
+        execute: (args, ctx) => execTask(args, ctx),
+        describe: (args) => `Task: ${args.description || args.prompt?.slice(0, 60)}`,
+    },
+    TodoWrite: {
+        name: "TodoWrite",
+        confirmPolicy: "never",
+        execute: (args, ctx) => execTodoWrite(args, ctx),
+        describe: () => `Updating todo list`,
+    },
+    ToolSearch: {
+        name: "ToolSearch",
+        confirmPolicy: "never",
+        execute: async (args, ctx) => {
+            const query = typeof args.query === "string" ? args.query.trim() : "";
+            if (!query)
+                return "[error] query is required.";
+            if (!ctx.apiUrl)
+                return "[error] apiUrl not configured.";
+            try {
+                const res = await fetch(`${ctx.apiUrl.replace(/\/$/, "")}/api/tools/search?q=${encodeURIComponent(query)}&surface=cli`, {
+                    headers: ctx.apiKey ? { authorization: `Bearer ${ctx.apiKey}` } : {},
+                    signal: AbortSignal.timeout(10_000),
+                });
+                if (!res.ok)
+                    return `[error] /api/tools/search returned ${res.status}.`;
+                const data = (await res.json());
+                if (!data.tools || data.tools.length === 0) {
+                    return `No tools found matching "${query}".`;
+                }
+                const lines = data.tools.map((t) => `- ${t.name}: ${t.description}`);
+                return `Found ${data.tools.length} tool(s) matching "${query}":\n${lines.join("\n")}\n\nCall the tool by name in your next turn.`;
+            }
+            catch (err) {
+                return `[error] ToolSearch failed: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+        describe: (args) => `Searching tools: ${args.query}`,
+    },
+    /** Skill — look up an installed CLI skill by name and return its body so the
+     *  model can see the instruction pack and use it in-context. Skills are
+     *  user-defined packs stored in ~/.theron/skills/ or .theron/skills/. */
+    Skill: {
+        name: "Skill",
+        confirmPolicy: "never",
+        execute: async (args) => {
+            const name = typeof args.name === "string" ? args.name.toLowerCase().trim() : "";
+            if (!name) {
+                if (_loadedSkills.length === 0)
+                    return "No skills are currently loaded. Add SKILL.md files to ~/.theron/skills/ or .theron/skills/.";
+                const list = _loadedSkills.map((s) => `- ${s.name}: ${s.description}`).join("\n");
+                return `Loaded skills:\n${list}`;
+            }
+            const skill = _loadedSkills.find((s) => s.name === name);
+            if (!skill) {
+                const available = _loadedSkills.length > 0
+                    ? _loadedSkills.map((s) => s.name).join(", ")
+                    : "(none)";
+                return `[error] Skill '${name}' not found. Available: ${available}`;
+            }
+            const toolNote = skill.allowedTools && skill.allowedTools.length > 0
+                ? `\n\nPrefer these tools for this skill: ${skill.allowedTools.join(", ")}`
+                : "";
+            const extra = typeof args.args === "string" && args.args.trim() ? `\n\nArgs: ${args.args.trim()}` : "";
+            return `Skill: ${skill.name}\nSource: ${skill.source}\n\n${skill.body}${toolNote}${extra}`;
+        },
+        describe: (args) => `Skill: ${args.name ?? "(list)"}`,
+    },
 };
+// The 7 shared local-tool schemas come from the canonical contract in
+// @vextlabs/theron-agent-sdk (single source of truth, shared with theron-vscode).
+// The CLI supplies its own surface-specific descriptions; Stoa is CLI-only.
 export const TOOL_SCHEMAS = [
+    ...buildLocalToolSchemas({
+        Read: "Read a file from the user's local working directory. Returns the file contents as text. Use offset/limit to page through large files (1-indexed lines). Errors if the path is outside the repo or doesn't exist.",
+        Write: "Write a file to the user's local working directory. Creates or overwrites. Asks the user for confirmation before each write unless --yes is passed.",
+        Edit: "Replace an exact substring in a file. old_string must appear EXACTLY ONCE (or set replace_all=true). The CLI shows a diff and asks for confirmation unless --yes.",
+        Bash: "Run a shell command in the user's working directory. Returns stdout + stderr + exit code. Asks for confirmation unless --yes. Has a default 120s timeout.",
+        Glob: "Find files by glob pattern. Returns paths sorted by mtime descending. Use to locate files when you don't know exact names.",
+        Grep: "Search file contents with a regex. Returns matching lines with file:line prefixes. Use for 'where is this defined' / 'who calls X' questions.",
+        LS: "List files and directories in a path (single level, not recursive).",
+    }),
+    STOA_TOOL_SCHEMA,
     {
         type: "function",
         function: {
-            name: "Read",
-            description: "Read a file from the user's local working directory. Returns the file contents as text. Use offset/limit to page through large files (1-indexed lines). Errors if the path is outside the repo or doesn't exist.",
+            name: "MultiEdit",
+            description: "Apply multiple exact-substring replacements to a single file in one atomic operation. All edits are validated before any write occurs — a missing or ambiguous old_string fails the entire batch early. Use when you need to make several related edits to one file.",
             parameters: {
                 type: "object",
                 properties: {
-                    file_path: { type: "string", description: "Absolute or repo-relative path." },
-                    offset: { type: "number", description: "Optional 1-indexed line to start reading from." },
-                    limit: { type: "number", description: "Optional max lines to read." },
+                    file_path: { type: "string", description: "Absolute or cwd-relative path to the file." },
+                    edits: {
+                        type: "array",
+                        description: "Ordered list of edits. Applied in sequence; each edit sees the result of the previous ones.",
+                        items: {
+                            type: "object",
+                            properties: {
+                                old_string: { type: "string", description: "Exact substring to replace. Must be unique (or set replace_all=true)." },
+                                new_string: { type: "string", description: "Replacement text." },
+                                replace_all: { type: "boolean", description: "Replace all occurrences (default false)." },
+                            },
+                            required: ["old_string", "new_string"],
+                        },
+                    },
                 },
-                required: ["file_path"],
+                required: ["file_path", "edits"],
             },
         },
     },
     {
         type: "function",
         function: {
-            name: "Write",
-            description: "Write a file to the user's local working directory. Creates or overwrites. Asks the user for confirmation before each write unless --yes is passed.",
+            name: "WebFetch",
+            description: "Fetch a URL and return its text content (HTML stripped to prose). 15s timeout. Content is truncated to maxBytes. file://, localhost, and private IP ranges are rejected.",
             parameters: {
                 type: "object",
                 properties: {
-                    file_path: { type: "string" },
-                    content: { type: "string", description: "Full file contents — overwrites whatever was there." },
+                    url: { type: "string", description: "The URL to fetch (http: or https: only)." },
                 },
-                required: ["file_path", "content"],
+                required: ["url"],
             },
         },
     },
     {
         type: "function",
         function: {
-            name: "Edit",
-            description: "Replace an exact substring in a file. old_string must appear EXACTLY ONCE (or set replace_all=true). The CLI shows a diff and asks for confirmation unless --yes.",
+            name: "WebSearch",
+            description: "Search the web via DuckDuckGo and return the top results as title + URL pairs. No API key required.",
             parameters: {
                 type: "object",
                 properties: {
-                    file_path: { type: "string" },
-                    old_string: { type: "string" },
-                    new_string: { type: "string" },
-                    replace_all: { type: "boolean", default: false },
+                    query: { type: "string", description: "The search query." },
+                    max_results: { type: "number", description: "Maximum results to return (default 10, max 20)." },
                 },
-                required: ["file_path", "old_string", "new_string"],
+                required: ["query"],
             },
         },
     },
     {
         type: "function",
         function: {
-            name: "Bash",
-            description: "Run a shell command in the user's working directory. Returns stdout + stderr + exit code. Asks for confirmation unless --yes. Has a default 120s timeout.",
+            name: "Task",
+            description: "Spawn a bounded read-only research subagent. The subagent can only use Read/Grep/Glob/LS — no writes, no shell, no web. Times out after timeout_seconds (default 300). Use for parallel investigation or complex read-only research.",
             parameters: {
                 type: "object",
                 properties: {
-                    command: { type: "string" },
-                    timeout: { type: "number", description: "Timeout in ms (default 120000, max 600000)." },
-                    description: { type: "string", description: "Short label for what the command does, shown to the user." },
+                    description: { type: "string", description: "Short label for the task (shown in terminal)." },
+                    prompt: { type: "string", description: "The full prompt to send the subagent." },
+                    timeout_seconds: { type: "number", description: "Aggregate wall-clock timeout (default 300)." },
                 },
-                required: ["command"],
+                required: ["description", "prompt"],
             },
         },
     },
     {
         type: "function",
         function: {
-            name: "Glob",
-            description: "Find files by glob pattern. Returns paths sorted by mtime descending. Use to locate files when you don't know exact names.",
+            name: "TodoWrite",
+            description: "Maintain a structured task list for the current session. Replaces the full list with the provided array. Each item has content (string), status (pending/in_progress/completed), and optional activeForm.",
             parameters: {
                 type: "object",
                 properties: {
-                    pattern: { type: "string", description: "Glob like 'src/**/*.ts'." },
-                    path: { type: "string", description: "Root to search from (default cwd)." },
+                    todos: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                content: { type: "string" },
+                                status: { type: "string", enum: ["pending", "in_progress", "completed"] },
+                                activeForm: { type: "string" },
+                            },
+                            required: ["content", "status"],
+                        },
+                    },
                 },
-                required: ["pattern"],
+                required: ["todos"],
             },
         },
     },
     {
         type: "function",
         function: {
-            name: "Grep",
-            description: "Search file contents with a regex. Returns matching lines with file:line prefixes. Use for 'where is this defined' / 'who calls X' questions.",
+            name: "ToolSearch",
+            description: "Search for available tools by keyword. Returns matching tool names and descriptions. Use this when you need a tool that isn't in the base set (Read, Write, Edit, Bash, Glob, Grep, LS, Stoa). The returned tools can be called by name in the next turn.",
             parameters: {
                 type: "object",
                 properties: {
-                    pattern: { type: "string", description: "Regex pattern." },
-                    path: { type: "string", description: "Optional file or directory to limit the search." },
-                    glob: { type: "string", description: "Optional glob filter, e.g. '*.ts'." },
-                    case_insensitive: { type: "boolean", default: false },
+                    query: {
+                        type: "string",
+                        description: "Search query — a keyword or phrase describing what you want to do (e.g. 'send email', 'create calendar event', 'search trademark').",
+                    },
                 },
-                required: ["pattern"],
+                required: ["query"],
             },
         },
     },
     {
         type: "function",
         function: {
-            name: "LS",
-            description: "List files and directories in a path (single level, not recursive).",
+            name: "Skill",
+            description: "Look up an installed CLI skill by name and return its instruction body. Skills are user-defined instruction packs stored in ~/.theron/skills/ or .theron/skills/. Omit 'name' to list all loaded skills.",
             parameters: {
                 type: "object",
                 properties: {
-                    path: { type: "string", description: "Default cwd." },
+                    name: {
+                        type: "string",
+                        description: "Skill slug (e.g. 'deep-research'). Omit to list all.",
+                    },
+                    args: {
+                        type: "string",
+                        description: "Optional arguments appended to the skill body.",
+                    },
                 },
             },
         },
     },
-    STOA_TOOL_SCHEMA,
 ];
 /** Tool names that can MUTATE the user's machine or hit a real SaaS.
  *  Plan mode hard-denies these at the executor (see repl.ts) so no write
  *  can run even with --yes. Stoa is included because its caps cause real
  *  side effects; Bash because a shell can write/delete. */
 export const MUTATING_TOOLS = new Set([
-    "Write", "Edit", "Bash", "Stoa",
+    ...MUTATING_LOCAL_TOOLS, "Stoa", "MultiEdit", "Task",
 ]);
 /** The read-only subset of TOOL_SCHEMAS sent to the model in plan mode.
  *  Filtering the schema makes the model LESS likely to even attempt a

package/dist/tools/index.js.map

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

package/dist/tools/ls.d.ts

@@ -1,6 +1,9 @@
 import type { ToolContext } from "./index.js";
 interface LsArgs {
     path?: string;
+    show_hidden?: boolean;
+    recursive?: boolean;
+    depth?: number;
 }
 export declare function execLs(args: LsArgs, ctx: ToolContext): Promise<string>;
 export {};

package/dist/tools/ls.js

@@ -1,23 +1,34 @@
-// LS tool — single-level directory listing.
+// LS tool — directory listing with optional dotfile and recursive support.
 import { promises as fs } from "node:fs";
 import path from "node:path";
 export async function execLs(args, ctx) {
     const target = args.path
         ? (path.isAbsolute(args.path) ? args.path : path.resolve(ctx.cwd, args.path))
         : ctx.cwd;
-    let entries;
-    try {
-        entries = await fs.readdir(target, { withFileTypes: true });
-    }
-    catch (err) {
-        return `[error] Cannot list ${target}: ${err instanceof Error ? err.message : String(err)}`;
-    }
+    const showHidden = args.show_hidden === true;
+    const recursive = args.recursive === true;
+    const maxDepth = (args.depth != null && args.depth >= 0) ? args.depth : (recursive ? 3 : 1);
     const lines = [];
-    for (const e of entries) {
-        if (e.name.startsWith("."))
-            continue;
-        lines.push(`${e.isDirectory() ? "d" : "-"} ${e.name}${e.isDirectory() ? "/" : ""}`);
+    async function walk(dir, depth, prefix) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch (err) {
+            lines.push(`${prefix}[error] Cannot list ${dir}: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        for (const e of entries) {
+            if (!showHidden && e.name.startsWith("."))
+                continue;
+            const isDir = e.isDirectory();
+            lines.push(`${prefix}${isDir ? "d" : "-"} ${e.name}${isDir ? "/" : ""}`);
+            if (isDir && recursive && depth < maxDepth) {
+                await walk(path.join(dir, e.name), depth + 1, prefix + "  ");
+            }
+        }
     }
+    await walk(target, 1, "");
     if (lines.length === 0)
         return `${target} is empty.`;
     return `${target}\n${lines.join("\n")}`;

package/dist/tools/ls.js.map

@@ -1 +1 @@
-{"version":3,"file":"ls.js","sourceRoot":"","sources":["../../src/tools/ls.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,GAAgB;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI;QACtB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACZ,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,MAAM,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9F,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACrC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,MAAM,YAAY,CAAC;IACrD,OAAO,GAAG,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"ls.js","sourceRoot":"","sources":["../../src/tools/ls.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,GAAgB;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI;QACtB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACZ,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;IAC1C,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5F,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,UAAU,IAAI,CAAC,GAAW,EAAE,KAAa,EAAE,MAAc;QAC5D,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,uBAAuB,GAAG,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvG,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACpD,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzE,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;gBAC3C,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,MAAM,YAAY,CAAC;IACrD,OAAO,GAAG,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1C,CAAC"}

package/dist/tools/multiedit.d.ts

@@ -0,0 +1,12 @@
+import type { ToolContext } from "./index.js";
+interface SingleEdit {
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean;
+}
+interface MultiEditArgs {
+    file_path: string;
+    edits: SingleEdit[];
+}
+export declare function execMultiEdit(args: MultiEditArgs, ctx: ToolContext): Promise<string>;
+export {};

package/dist/tools/multiedit.js

@@ -0,0 +1,79 @@
+// MultiEdit tool — applies a sequence of exact-substring replacements to a
+// single file in one operation, reading once and writing once. Mirrors the
+// semantics of edit.ts but batches multiple edits. Fails early on the first
+// missing/ambiguous old_string so no partial writes occur.
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { sha256Hex, receiptLocalAction } from "../receipt.js";
+import { pushCheckpoint } from "../checkpoints.js";
+function countOccurrences(haystack, needle) {
+    if (!needle)
+        return 0;
+    let count = 0;
+    let from = 0;
+    while (true) {
+        const idx = haystack.indexOf(needle, from);
+        if (idx < 0)
+            return count;
+        count += 1;
+        from = idx + needle.length;
+    }
+}
+export async function execMultiEdit(args, ctx) {
+    if (!Array.isArray(args.edits) || args.edits.length === 0) {
+        return "[error] edits must be a non-empty array.";
+    }
+    const target = path.isAbsolute(args.file_path)
+        ? args.file_path
+        : path.resolve(ctx.cwd, args.file_path);
+    let original;
+    try {
+        original = await fs.readFile(target, "utf-8");
+    }
+    catch (err) {
+        return `[error] Cannot read ${target}: ${err instanceof Error ? err.message : String(err)}`;
+    }
+    // Snapshot pre-edit content for /rewind.
+    try {
+        pushCheckpoint(target, original);
+    }
+    catch { /* never throws */ }
+    // Validate ALL edits before touching the file (fail-early).
+    let text = original;
+    for (let i = 0; i < args.edits.length; i++) {
+        const ed = args.edits[i];
+        if (ed.old_string === ed.new_string) {
+            return `[error] Edit ${i + 1}: old_string === new_string — nothing to change.`;
+        }
+        const count = countOccurrences(text, ed.old_string);
+        if (count === 0) {
+            return `[error] Edit ${i + 1}: old_string not found in ${target}.`;
+        }
+        if (count > 1 && !ed.replace_all) {
+            return `[error] Edit ${i + 1}: old_string appears ${count} times. Make it unique or set replace_all=true.`;
+        }
+        // Apply edit in sequence so subsequent edits see earlier changes.
+        if (ed.replace_all) {
+            text = text.split(ed.old_string).join(ed.new_string);
+        }
+        else {
+            const idx = text.indexOf(ed.old_string);
+            text = text.slice(0, idx) + ed.new_string + text.slice(idx + ed.old_string.length);
+        }
+    }
+    // Write once.
+    const preSha256 = sha256Hex(original);
+    await fs.writeFile(target, text, "utf-8");
+    const postSha256 = sha256Hex(text);
+    const totalReplacements = args.edits.length;
+    const baseResult = `MultiEdit applied ${totalReplacements} edit${totalReplacements === 1 ? "" : "s"} to ${target}.`;
+    // Mint a STOA receipt for this multi-edit.
+    const verifyUrl = await receiptLocalAction(ctx.apiUrl, ctx.apiKey, "local_multiedit", {
+        path: target,
+        edit_count: totalReplacements,
+        pre_sha256: preSha256,
+        post_sha256: postSha256,
+    }).catch(() => null);
+    return verifyUrl ? baseResult + "\nsigned -- verify: " + verifyUrl : baseResult;
+}
+//# sourceMappingURL=multiedit.js.map

package/dist/tools/multiedit.js.map

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

package/dist/tools/stoa.d.ts

@@ -7,7 +7,7 @@ interface StoaArgs {
      *  spec in the Stoa registry. */
     input: Record<string, unknown>;
 }
-export declare function execStoa(args: StoaArgs, _ctx: ToolContext): Promise<string>;
+export declare function execStoa(args: StoaArgs, ctx: ToolContext): Promise<string>;
 export declare const STOA_TOOL_DESCRIBE: (args: Record<string, unknown>) => string;
 /** OpenAI-compatible function tool def for the Stoa cap proxy. */
 export declare const STOA_TOOL_SCHEMA: {

package/dist/tools/stoa.js

@@ -15,24 +15,28 @@
 //     (the CLI displays whatever signature the server provides), so a
 //     caller has an auditable record of "Theron did this, here's the proof."
 const DEFAULT_BASE = process.env.THERON_STOA_BASE ?? "https://theron.tryvext.com";
-export async function execStoa(args, _ctx) {
+export async function execStoa(args, ctx) {
     if (typeof args.cap !== "string" || !args.cap.startsWith("urn:stoa:cap:")) {
         throw new Error(`invalid cap URN: ${args.cap}`);
     }
     if (typeof args.input !== "object" || args.input === null) {
         throw new Error("input must be an object");
     }
-    const url = `${DEFAULT_BASE}/v1/cap`;
+    const base = ctx.apiUrl || DEFAULT_BASE;
+    const url = `${base.replace(/\/$/, "")}/v1/cap`;
     const envelope = {
         stoa: "1",
         cap: args.cap,
         input: args.input,
     };
+    const headers = { "content-type": "application/json" };
+    if (ctx.apiKey)
+        headers["authorization"] = `Bearer ${ctx.apiKey}`;
     let response;
     try {
         response = await fetch(url, {
             method: "POST",
-            headers: { "content-type": "application/json" },
+            headers,
             body: JSON.stringify(envelope),
         });
     }

package/dist/tools/stoa.js.map

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

package/dist/tools/task.d.ts

@@ -0,0 +1,9 @@
+import type { ToolContext } from "./index.js";
+interface TaskArgs {
+    description: string;
+    prompt: string;
+    /** Aggregate timeout in seconds across all turns (default 300). */
+    timeout_seconds?: number;
+}
+export declare function execTask(args: TaskArgs, ctx: ToolContext): Promise<string>;
+export {};