@ridit/lens 0.2.1 → 0.2.2

package/dist/index.mjs

@@ -49206,72 +49206,17 @@ print("OK")
   }
 }
 // src/prompts/system.ts
-function buildSystemPrompt(files, memorySummary = "") {
+function buildSystemPrompt(files, memorySummary = "", toolsSection) {
   const fileList = files.map((f) => `### ${f.path}
 \`\`\`
 ${f.content.slice(0, 2000)}
 \`\`\``).join(`
 
 `);
+  const tools = toolsSection ?? BUILTIN_TOOLS_SECTION;
   return `You are an expert software engineer assistant with access to the user's codebase and tools.
 
-## TOOLS
-
-You have exactly thirteen tools. To use a tool you MUST wrap it in the exact XML tags shown below — no other format will work.
-
-### 1. fetch — load a URL
-<fetch>https://example.com</fetch>
-
-### 2. shell — run a terminal command
-<shell>node -v</shell>
-
-### 3. read-file — read a file from the repo
-<read-file>src/foo.ts</read-file>
-
-### 4. read-folder — list contents of a folder (files + subfolders, one level deep)
-<read-folder>src/components</read-folder>
-
-### 5. grep — search for a pattern across files in the repo (cross-platform, no shell needed)
-<grep>
-{"pattern": "ChatRunner", "glob": "src/**/*.tsx"}
-</grep>
-
-### 6. write-file — create or overwrite a file
-<write-file>
-{"path": "data/output.csv", "content": "col1,col2
-val1,val2"}
-</write-file>
-
-### 7. delete-file — permanently delete a single file
-<delete-file>src/old-component.tsx</delete-file>
-
-### 8. delete-folder — permanently delete a folder and all its contents
-<delete-folder>src/legacy</delete-folder>
-
-### 9. open-url — open a URL in the user's default browser
-<open-url>https://github.com/owner/repo</open-url>
-
-### 10. generate-pdf — generate a PDF file from markdown-style content
-<generate-pdf>
-{"path": "output/report.pdf", "content": "# Title
-
-Some body text.
-
-## Section
-
-More content."}
-</generate-pdf>
-
-### 11. search — search the internet for anything you are unsure about
-<search>how to use React useEffect cleanup function</search>
-
-### 12. clone — clone a GitHub repo so you can explore and discuss it
-<clone>https://github.com/owner/repo</clone>
-
-### 13. changes — propose code edits (shown as a diff for user approval)
-<changes>
-{"summary": "what changed and why", "patches": [{"path": "src/foo.ts", "content": "COMPLETE file content", "isNew": false}]}
-</changes>
+${tools}
 
 ## MEMORY OPERATIONS
 
@@ -49321,9 +49266,26 @@ You may emit multiple memory operations in a single response alongside normal co
 22. When scaffolding a multi-file project, after each write-file succeeds, immediately proceed to writing the NEXT file — NEVER rewrite a file you already wrote in this session. Each file is written ONCE and ONLY ONCE.
 23. For JSX/TSX files always use \`.tsx\` extension and include \`/** @jsxImportSource react */\` or ensure tsconfig has jsx set — bun needs this to parse JSX
 24. When explaining how to use a tool in text, use [tag] bracket notation or a fenced code block — NEVER emit a real XML tool tag as part of an explanation or example
-25. NEVER chain tool calls unless the user's request explicitly requires multiple steps
-26. NEVER read files, list folders, or run tools that were not asked for in the current user message
-27. NEVER use markdown formatting in plain text responses — no **bold**, no *italics*, no # headings, no bullet points with -, *, or +, no numbered lists, no backtick inline code. Write in plain prose. Only use fenced \`\`\` code blocks when showing actual code.
+25. NEVER read files, list folders, or run tools that were not asked for in the current user message
+26. NEVER use markdown formatting in plain text responses — no **bold**, no *italics*, no # headings, no bullet points with -, *, or +, no numbered lists, no backtick inline code. Write in plain prose. Only use fenced \`\`\` code blocks when showing actual code.
+
+## SCAFFOLDING — CHAINING WRITE-FILE CALLS
+
+When creating multiple files (e.g. scaffolding a project or creating 10 files), emit ALL of them
+in a single response by chaining the tags back-to-back with no text between them:
+
+<write-file>
+{"path": "test/file1.txt", "content": "File 1 content"}
+</write-file>
+<write-file>
+{"path": "test/file2.txt", "content": "File 2 content"}
+</write-file>
+<write-file>
+{"path": "test/file3.txt", "content": "File 3 content"}
+</write-file>
+
+The system processes each tag sequentially and automatically continues to the next one.
+Do NOT wait for a user message between files — emit all tags at once.
 
 ## CRITICAL: READ BEFORE YOU WRITE
 
@@ -49345,61 +49307,62 @@ These rules are mandatory whenever you plan to edit or create a file:
 - NEVER produce a file that is shorter than the original unless you are explicitly asked to delete things
 - If you catch yourself rewriting a file from scratch, STOP — go back and read the original first
 
-## WHEN TO USE read-folder:
-- Before editing files in an unfamiliar directory — list it first to understand the structure
-- When a feature spans multiple files and you are not sure what exists
-- When the user asks you to explore or explain a part of the codebase
-
-## SCAFFOLDING A NEW PROJECT (follow this exactly)
-
-When the user asks to create a new CLI/app in a subfolder (e.g. "make a todo app called list"):
-1. Create all files first using write-file with paths like \`list/package.json\`, \`list/src/index.tsx\`
-2. Then run \`cd list && bun install\` (or npm/pnpm) in one shell command
-3. Then run the project with \`cd list && bun run index.ts\` or whatever the entry point is
-4. NEVER run \`bun init\` — it is interactive and will hang. Create package.json manually with write-file instead
-5. TSX files need either tsconfig.json with \`"jsx": "react-jsx"\` or \`/** @jsxImportSource react */\` at the top
-
-## FETCH → WRITE FLOW (follow this exactly when saving fetched data)
-
-1. fetch the URL
-2. Analyze the result — count the rows, identify columns, check completeness
-3. Tell the user what you found: "Found X rows with columns: A, B, C. Writing now."
-4. emit write-file with correctly structured, complete content
-5. After write-file confirms success, emit read-file to verify
-6. Only after read-file confirms content is correct, tell the user it is done
-
-## WHEN TO USE TOOLS
-
-- User shares any URL → fetch it immediately
-- User asks to run anything → shell it immediately
-- User asks to open a link, open a URL, or visit a website → open-url it immediately, do NOT use fetch
-- User asks to delete a file → delete-file it immediately (requires approval)
-- User asks to delete a folder or directory → delete-folder it immediately (requires approval)
-- User asks to search for a pattern in files, find usages, find where something is defined → grep it immediately, NEVER use shell grep/findstr/Select-String
-- User asks to read a file → read-file it immediately, NEVER use shell cat/type
-- User asks what files are in a folder, or to explore/list a directory → read-folder it immediately, NEVER use shell ls/dir/find/git ls-files
-- User asks to explore a folder or directory → read-folder it immediately
-- User asks to save/create/write a file → write-file it immediately, then read-file to verify
-- User asks to modify/edit/add to an existing file → read-file it FIRST, then emit changes
-- User shares a GitHub URL and wants to clone/explore/discuss it → use clone immediately, NEVER use shell git clone
-- After clone succeeds, you will see context about the clone in the conversation. Wait for the user to ask a specific question before using any tools. Do NOT auto-read files, do NOT emit any tool tags until the user asks.
-- You are unsure about an API, library, error, concept, or piece of code → search it immediately
-- User asks about something recent or that you might not know → search it immediately
-- You are about to say "I'm not sure" or "I don't know" → search instead of guessing
-
-## shell IS ONLY FOR:
-- Running code: \`node script.js\`, \`bun run dev\`, \`python main.py\`
-- Installing packages: \`npm install\`, \`pip install\`
-- Building/testing: \`npm run build\`, \`bun test\`
-- Git operations other than clone: \`git status\`, \`git log\`, \`git diff\`
-- Anything that EXECUTES — not reads or lists
-
 ## CODEBASE
 
 ${fileList.length > 0 ? fileList : "(no files indexed)"}
 
 ${memorySummary}`;
 }
+var BUILTIN_TOOLS_SECTION = `## TOOLS
+
+You have exactly thirteen tools. To use a tool you MUST wrap it in the exact XML tags shown below — no other format will work.
+
+### 1. fetch — load a URL
+<fetch>https://example.com</fetch>
+
+### 2. shell — run a terminal command
+<shell>node -v</shell>
+
+### 3. read-file — read a file from the repo
+<read-file>src/foo.ts</read-file>
+
+### 4. read-folder — list contents of a folder (files + subfolders, one level deep)
+<read-folder>src/components</read-folder>
+
+### 5. grep — search for a pattern across files in the repo (cross-platform, no shell needed)
+<grep>
+{"pattern": "ChatRunner", "glob": "src/**/*.tsx"}
+</grep>
+
+### 6. write-file — create or overwrite a file
+<write-file>
+{"path": "data/output.csv", "content": "col1,col2\\nval1,val2"}
+</write-file>
+
+### 7. delete-file — permanently delete a single file
+<delete-file>src/old-component.tsx</delete-file>
+
+### 8. delete-folder — permanently delete a folder and all its contents
+<delete-folder>src/legacy</delete-folder>
+
+### 9. open-url — open a URL in the user's default browser
+<open-url>https://github.com/owner/repo</open-url>
+
+### 10. generate-pdf — generate a PDF file from markdown-style content
+<generate-pdf>
+{"path": "output/report.pdf", "content": "# Title\\n\\nSome body text.\\n\\n## Section\\n\\nMore content."}
+</generate-pdf>
+
+### 11. search — search the internet for anything you are unsure about
+<search>how to use React useEffect cleanup function</search>
+
+### 12. clone — clone a GitHub repo so you can explore and discuss it
+<clone>https://github.com/owner/repo</clone>
+
+### 13. changes — propose code edits (shown as a diff for user approval)
+<changes>
+{"summary": "what changed and why", "patches": [{"path": "src/foo.ts", "content": "COMPLETE file content", "isNew": false}]}
+</changes>`;
 // src/prompts/fewshot.ts
 var FEW_SHOT_MESSAGES = [
   {
@@ -49842,133 +49805,129 @@ Got it — I'll always use bun for this project.`
 Done — removed that memory.`
   }
 ];
+// src/utils/tools/registry.ts
+class ToolRegistry {
+  tools = new Map;
+  register(tool) {
+    if (this.tools.has(tool.name)) {
+      console.warn(`[ToolRegistry] Overwriting existing tool: "${tool.name}"`);
+    }
+    this.tools.set(tool.name, tool);
+  }
+  unregister(name) {
+    this.tools.delete(name);
+  }
+  get(name) {
+    return this.tools.get(name);
+  }
+  all() {
+    return Array.from(this.tools.values());
+  }
+  names() {
+    return Array.from(this.tools.keys());
+  }
+  buildSystemPromptSection() {
+    const lines = [`## TOOLS
+`];
+    lines.push("You have exactly " + this.tools.size + ` tools. To use a tool you MUST wrap it in the exact XML tags shown below — no other format will work.
+`);
+    let i = 1;
+    for (const tool of this.tools.values()) {
+      lines.push(tool.systemPromptEntry(i++));
+    }
+    return lines.join(`
+`);
+  }
+}
+var registry = new ToolRegistry;
+
 // src/utils/chat.ts
 function parseResponse(text) {
   const scanText = text.replace(/```[\s\S]*?```/g, (m) => " ".repeat(m.length));
   const candidates = [];
-  const patterns = [
-    { kind: "fetch", re: /<fetch>([\s\S]*?)<\/fetch>/g },
-    { kind: "shell", re: /<shell>([\s\S]*?)<\/shell>/g },
-    { kind: "read-file", re: /<read-file>([\s\S]*?)<\/read-file>/g },
-    { kind: "read-folder", re: /<read-folder>([\s\S]*?)<\/read-folder>/g },
-    { kind: "grep", re: /<grep>([\s\S]*?)<\/grep>/g },
-    { kind: "delete-file", re: /<delete-file>([\s\S]*?)<\/delete-file>/g },
-    {
-      kind: "delete-folder",
-      re: /<delete-folder>([\s\S]*?)<\/delete-folder>/g
-    },
-    { kind: "open-url", re: /<open-url>([\s\S]*?)<\/open-url>/g },
-    { kind: "generate-pdf", re: /<generate-pdf>([\s\S]*?)<\/generate-pdf>/g },
-    { kind: "write-file", re: /<write-file>([\s\S]*?)<\/write-file>/g },
-    { kind: "search", re: /<search>([\s\S]*?)<\/search>/g },
-    { kind: "clone", re: /<clone>([\s\S]*?)<\/clone>/g },
-    { kind: "changes", re: /<changes>([\s\S]*?)<\/changes>/g },
-    { kind: "fetch", re: /```fetch\r?\n([\s\S]*?)\r?\n```/g },
-    { kind: "shell", re: /```shell\r?\n([\s\S]*?)\r?\n```/g },
-    { kind: "read-file", re: /```read-file\r?\n([\s\S]*?)\r?\n```/g },
-    { kind: "read-folder", re: /```read-folder\r?\n([\s\S]*?)\r?\n```/g },
-    { kind: "write-file", re: /```write-file\r?\n([\s\S]*?)\r?\n```/g },
-    { kind: "search", re: /```search\r?\n([\s\S]*?)\r?\n```/g },
-    { kind: "changes", re: /```changes\r?\n([\s\S]*?)\r?\n```/g }
-  ];
-  for (const { kind: kind2, re } of patterns) {
-    re.lastIndex = 0;
-    const m = re.exec(scanText);
-    if (m) {
-      const originalRe = new RegExp(re.source, re.flags.replace("g", ""));
-      const originalMatch = originalRe.exec(text.slice(m.index));
-      if (originalMatch) {
-        const fakeMatch = Object.assign([
-          text.slice(m.index, m.index + originalMatch[0].length),
-          originalMatch[1]
-        ], { index: m.index, input: text, groups: undefined });
-        candidates.push({ index: m.index, kind: kind2, match: fakeMatch });
+  for (const toolName2 of registry.names()) {
+    const escaped = toolName2.replace(/[-]/g, "\\-");
+    const xmlRe = new RegExp(`<${escaped}>([\\s\\S]*?)<\\/${escaped}>`, "g");
+    xmlRe.lastIndex = 0;
+    const xmlM = xmlRe.exec(scanText);
+    if (xmlM) {
+      const orig = new RegExp(xmlRe.source);
+      const origM = orig.exec(text.slice(xmlM.index));
+      if (origM) {
+        candidates.push({
+          index: xmlM.index,
+          toolName: toolName2,
+          match: Object.assign([
+            text.slice(xmlM.index, xmlM.index + origM[0].length),
+            origM[1]
+          ], { index: xmlM.index, input: text, groups: undefined })
+        });
+      }
+    }
+    const fencedRe = new RegExp(`\`\`\`${escaped}\\r?\\n([\\s\\S]*?)\\r?\\n\`\`\``, "g");
+    fencedRe.lastIndex = 0;
+    const fencedM = fencedRe.exec(scanText);
+    if (fencedM) {
+      const orig = new RegExp(fencedRe.source);
+      const origM = orig.exec(text.slice(fencedM.index));
+      if (origM) {
+        candidates.push({
+          index: fencedM.index,
+          toolName: toolName2,
+          match: Object.assign([
+            text.slice(fencedM.index, fencedM.index + origM[0].length),
+            origM[1]
+          ], { index: fencedM.index, input: text, groups: undefined })
+        });
       }
     }
   }
   if (candidates.length === 0)
     return { kind: "text", content: text.trim() };
   candidates.sort((a, b) => a.index - b.index);
-  const { kind, match } = candidates[0];
-  const before2 = text.slice(0, match.index).replace(/<(fetch|shell|read-file|read-folder|write-file|search|clone|changes)[^>]*>[\s\S]*?<\/\1>/g, "").trim();
+  const { toolName, match } = candidates[0];
+  const before2 = text.slice(0, match.index).trim();
   const body = (match[1] ?? "").trim();
-  if (kind === "changes") {
+  const afterMatch = text.slice(match.index + match[0].length).trim();
+  const remainder = afterMatch.length > 0 ? afterMatch : undefined;
+  if (toolName === "changes") {
     try {
       const parsed = JSON.parse(body);
       const display = [before2, parsed.summary].filter(Boolean).join(`
 
 `);
-      return { kind: "changes", content: display, patches: parsed.patches };
-    } catch {}
-  }
-  if (kind === "shell")
-    return { kind: "shell", content: before2, command: body };
-  if (kind === "fetch")
-    return {
-      kind: "fetch",
-      content: before2,
-      url: body.replace(/^<|>$/g, "").trim()
-    };
-  if (kind === "read-file")
-    return { kind: "read-file", content: before2, filePath: body };
-  if (kind === "read-folder")
-    return { kind: "read-folder", content: before2, folderPath: body };
-  if (kind === "delete-file")
-    return { kind: "delete-file", content: before2, filePath: body };
-  if (kind === "delete-folder")
-    return { kind: "delete-folder", content: before2, folderPath: body };
-  if (kind === "open-url")
-    return {
-      kind: "open-url",
-      content: before2,
-      url: body.replace(/^<|>$/g, "").trim()
-    };
-  if (kind === "search")
-    return { kind: "search", content: before2, query: body };
-  if (kind === "clone")
-    return {
-      kind: "clone",
-      content: before2,
-      repoUrl: body.replace(/^<|>$/g, "").trim()
-    };
-  if (kind === "generate-pdf") {
-    try {
-      const parsed = JSON.parse(body);
-      return {
-        kind: "generate-pdf",
-        content: before2,
-        filePath: parsed.path ?? parsed.filePath ?? "output.pdf",
-        pdfContent: parsed.content ?? ""
-      };
-    } catch {
-      return { kind: "text", content: text };
-    }
-  }
-  if (kind === "grep") {
-    try {
-      const parsed = JSON.parse(body);
       return {
-        kind: "grep",
-        content: before2,
-        pattern: parsed.pattern,
-        glob: parsed.glob ?? "**/*"
+        kind: "changes",
+        content: display,
+        patches: parsed.patches,
+        remainder
       };
     } catch {
-      return { kind: "grep", content: before2, pattern: body, glob: "**/*" };
+      return { kind: "text", content: text.trim() };
     }
   }
-  if (kind === "write-file") {
-    try {
-      const parsed = JSON.parse(body);
-      return {
-        kind: "write-file",
-        content: before2,
-        filePath: parsed.path,
-        fileContent: parsed.content
-      };
-    } catch {}
+  if (toolName === "clone") {
+    return {
+      kind: "clone",
+      content: before2,
+      repoUrl: body.replace(/^<|>$/g, "").trim(),
+      remainder
+    };
   }
-  return { kind: "text", content: text.trim() };
+  const tool = registry.get(toolName);
+  if (!tool)
+    return { kind: "text", content: text.trim() };
+  const input = tool.parseInput(body);
+  if (input === null)
+    return { kind: "text", content: text.trim() };
+  return {
+    kind: "tool",
+    toolName,
+    input,
+    rawInput: body,
+    content: before2,
+    remainder
+  };
 }
 function extractGithubUrl(text) {
   const match = text.match(/https?:\/\/github\.com\/[\w.-]+\/[\w.-]+/);
@@ -49987,10 +49946,9 @@ function buildApiMessages(messages) {
           content: "The tool call was denied by the user. Please respond without using that tool."
         };
       }
-      const label = m.toolName === "shell" ? `shell command \`${m.content}\`` : m.toolName === "fetch" ? `fetch of ${m.content}` : m.toolName === "read-file" ? `read-file of ${m.content}` : m.toolName === "read-folder" ? `read-folder of ${m.content}` : m.toolName === "grep" ? `grep for "${m.content}"` : m.toolName === "delete-file" ? `delete-file of ${m.content}` : m.toolName === "delete-folder" ? `delete-folder of ${m.content}` : m.toolName === "open-url" ? `open-url ${m.content}` : m.toolName === "generate-pdf" ? `generate-pdf to ${m.content}` : m.toolName === "search" ? `web search for "${m.content}"` : `write-file to ${m.content}`;
       return {
         role: "user",
-        content: `Here is the output from the ${label}:
+        content: `Here is the output from the ${m.toolName} of ${m.content}:
 
 ${m.result}
 
@@ -50489,50 +50447,71 @@ function PermissionPrompt({
   let icon;
   let label;
   let value;
-  if (tool.type === "shell") {
-    icon = "$";
-    label = "run";
-    value = tool.command;
-  } else if (tool.type === "fetch") {
-    icon = "~>";
-    label = "fetch";
-    value = tool.url;
-  } else if (tool.type === "read-file") {
-    icon = "r";
-    label = "read";
-    value = tool.filePath;
-  } else if (tool.type === "read-folder") {
-    icon = "d";
-    label = "folder";
-    value = tool.folderPath;
-  } else if (tool.type === "grep") {
-    icon = "/";
-    label = "grep";
-    value = `${tool.pattern}  ${tool.glob}`;
-  } else if (tool.type === "delete-file") {
-    icon = "x";
-    label = "delete";
-    value = tool.filePath;
-  } else if (tool.type === "delete-folder") {
-    icon = "X";
-    label = "delete folder";
-    value = tool.folderPath;
-  } else if (tool.type === "open-url") {
-    icon = "↗";
-    label = "open";
-    value = tool.url;
-  } else if (tool.type === "generate-pdf") {
-    icon = "P";
-    label = "pdf";
-    value = tool.filePath;
-  } else if (tool.type === "write-file") {
-    icon = "w";
-    label = "write";
-    value = `${tool.filePath} (${tool.fileContent.length} bytes)`;
+  if ("_label" in tool) {
+    const iconMap = {
+      run: "$",
+      fetch: "~>",
+      read: "r",
+      write: "w",
+      delete: "x",
+      "delete folder": "X",
+      open: "↗",
+      pdf: "P",
+      search: "?",
+      folder: "d",
+      grep: "/",
+      clone: "↓",
+      query: "⌗"
+    };
+    icon = iconMap[tool._label] ?? "·";
+    label = tool._label;
+    value = tool._display;
   } else {
-    icon = "?";
-    label = "search";
-    value = tool.query;
+    if (tool.type === "shell") {
+      icon = "$";
+      label = "run";
+      value = tool.command;
+    } else if (tool.type === "fetch") {
+      icon = "~>";
+      label = "fetch";
+      value = tool.url;
+    } else if (tool.type === "read-file") {
+      icon = "r";
+      label = "read";
+      value = tool.filePath;
+    } else if (tool.type === "read-folder") {
+      icon = "d";
+      label = "folder";
+      value = tool.folderPath;
+    } else if (tool.type === "grep") {
+      icon = "/";
+      label = "grep";
+      value = `${tool.pattern}  ${tool.glob}`;
+    } else if (tool.type === "delete-file") {
+      icon = "x";
+      label = "delete";
+      value = tool.filePath;
+    } else if (tool.type === "delete-folder") {
+      icon = "X";
+      label = "delete folder";
+      value = tool.folderPath;
+    } else if (tool.type === "open-url") {
+      icon = "↗";
+      label = "open";
+      value = tool.url;
+    } else if (tool.type === "generate-pdf") {
+      icon = "P";
+      label = "pdf";
+      value = tool.filePath;
+    } else if (tool.type === "write-file") {
+      icon = "w";
+      label = "write";
+      value = `${tool.filePath} (${tool.fileContent.length} bytes)`;
+    } else {
+      icon = "?";
+      label = "search";
+      value = tool.query ?? "";
+    }
   }
   return /* @__PURE__ */ jsx_dev_runtime20.jsxDEV(Box_default, {
     flexDirection: "column",
@@ -52555,8 +52534,7 @@ var ChatRunner = ({ repoPath }) => {
   };
   const abortControllerRef = import_react49.useRef(null);
   const toolResultCache = import_react49.useRef(new Map);
-  const inputBuffer = import_react49.useRef("");
-  const flushTimer = import_react49.useRef(null);
+  const batchApprovedRef = import_react49.useRef(false);
   const thinkingPhrase = useThinkingPhrase(stage.type === "thinking");
   import_react48.default.useEffect(() => {
     const chats = listChats(repoPath);
@@ -52567,22 +52545,8 @@ var ChatRunner = ({ repoPath }) => {
       saveChat(chatNameRef.current, repoPath, allMessages);
     }
   }, [allMessages]);
-  const flushBuffer = () => {
-    const buf = inputBuffer.current;
-    if (!buf)
-      return;
-    inputBuffer.current = "";
-    setInputValue((v) => v + buf);
-  };
-  const scheduleFlush = () => {
-    if (flushTimer.current !== null)
-      return;
-    flushTimer.current = setTimeout(() => {
-      flushTimer.current = null;
-      flushBuffer();
-    }, 16);
-  };
   const handleError = (currentAll) => (err) => {
+    batchApprovedRef.current = false;
     if (err instanceof Error && err.name === "AbortError") {
       setStage({ type: "idle" });
       return;
@@ -52598,6 +52562,7 @@ var ChatRunner = ({ repoPath }) => {
   };
   const processResponse = (raw, currentAll, signal) => {
     if (signal.aborted) {
+      batchApprovedRef.current = false;
       setStage({ type: "idle" });
       return;
     }
@@ -52620,14 +52585,15 @@ var ChatRunner = ({ repoPath }) => {
     const cleanRaw = raw.replace(/<memory-add>[\s\S]*?<\/memory-add>/g, "").replace(/<memory-delete>[\s\S]*?<\/memory-delete>/g, "").trim();
     const parsed = parseResponse(cleanRaw);
     if (parsed.kind === "changes") {
+      batchApprovedRef.current = false;
       if (parsed.patches.length === 0) {
-        const msg2 = {
+        const msg = {
           role: "assistant",
           content: parsed.content,
           type: "text"
         };
-        setAllMessages([...currentAll, msg2]);
-        setCommitted((prev) => [...prev, msg2]);
+        setAllMessages([...currentAll, msg]);
+        setCommitted((prev) => [...prev, msg]);
         setStage({ type: "idle" });
         return;
       }
@@ -52651,144 +52617,8 @@ var ChatRunner = ({ repoPath }) => {
       });
       return;
     }
-    if (parsed.kind === "shell" || parsed.kind === "fetch" || parsed.kind === "read-file" || parsed.kind === "read-folder" || parsed.kind === "grep" || parsed.kind === "write-file" || parsed.kind === "delete-file" || parsed.kind === "delete-folder" || parsed.kind === "open-url" || parsed.kind === "generate-pdf" || parsed.kind === "search") {
-      let tool;
-      if (parsed.kind === "shell") {
-        tool = { type: "shell", command: parsed.command };
-      } else if (parsed.kind === "fetch") {
-        tool = { type: "fetch", url: parsed.url };
-      } else if (parsed.kind === "read-file") {
-        tool = { type: "read-file", filePath: parsed.filePath };
-      } else if (parsed.kind === "read-folder") {
-        tool = { type: "read-folder", folderPath: parsed.folderPath };
-      } else if (parsed.kind === "grep") {
-        tool = { type: "grep", pattern: parsed.pattern, glob: parsed.glob };
-      } else if (parsed.kind === "delete-file") {
-        tool = { type: "delete-file", filePath: parsed.filePath };
-      } else if (parsed.kind === "delete-folder") {
-        tool = { type: "delete-folder", folderPath: parsed.folderPath };
-      } else if (parsed.kind === "open-url") {
-        tool = { type: "open-url", url: parsed.url };
-      } else if (parsed.kind === "generate-pdf") {
-        tool = {
-          type: "generate-pdf",
-          filePath: parsed.filePath,
-          content: parsed.pdfContent
-        };
-      } else if (parsed.kind === "search") {
-        tool = { type: "search", query: parsed.query };
-      } else {
-        tool = {
-          type: "write-file",
-          filePath: parsed.filePath,
-          fileContent: parsed.fileContent
-        };
-      }
-      if (parsed.content) {
-        const preambleMsg = {
-          role: "assistant",
-          content: parsed.content,
-          type: "text"
-        };
-        setAllMessages([...currentAll, preambleMsg]);
-        setCommitted((prev) => [...prev, preambleMsg]);
-      }
-      const isSafeTool = parsed.kind === "read-file" || parsed.kind === "read-folder" || parsed.kind === "grep" || parsed.kind === "fetch" || parsed.kind === "open-url" || parsed.kind === "search";
-      const executeAndContinue = async (approved) => {
-        let result2 = "(denied by user)";
-        if (approved) {
-          const cacheKey = parsed.kind === "read-file" ? `read-file:${parsed.filePath}` : parsed.kind === "read-folder" ? `read-folder:${parsed.folderPath}` : parsed.kind === "grep" ? `grep:${parsed.pattern}:${parsed.glob}` : null;
-          if (cacheKey && toolResultCache.current.has(cacheKey)) {
-            result2 = toolResultCache.current.get(cacheKey) + `
-
-[NOTE: This result was already retrieved earlier. Do not request it again.]`;
-          } else {
-            try {
-              setStage({ type: "thinking" });
-              if (parsed.kind === "shell") {
-                result2 = await runShell(parsed.command, repoPath);
-              } else if (parsed.kind === "fetch") {
-                result2 = await fetchUrl(parsed.url);
-              } else if (parsed.kind === "read-file") {
-                result2 = readFile(parsed.filePath, repoPath);
-              } else if (parsed.kind === "read-folder") {
-                result2 = readFolder(parsed.folderPath, repoPath);
-              } else if (parsed.kind === "grep") {
-                result2 = grepFiles(parsed.pattern, parsed.glob, repoPath);
-              } else if (parsed.kind === "delete-file") {
-                result2 = deleteFile(parsed.filePath, repoPath);
-              } else if (parsed.kind === "delete-folder") {
-                result2 = deleteFolder(parsed.folderPath, repoPath);
-              } else if (parsed.kind === "open-url") {
-                result2 = openUrl(parsed.url);
-              } else if (parsed.kind === "generate-pdf") {
-                result2 = generatePdf(parsed.filePath, parsed.pdfContent, repoPath);
-              } else if (parsed.kind === "write-file") {
-                result2 = writeFile(parsed.filePath, parsed.fileContent, repoPath);
-              } else if (parsed.kind === "search") {
-                result2 = await searchWeb(parsed.query);
-              }
-              if (cacheKey) {
-                toolResultCache.current.set(cacheKey, result2);
-              }
-            } catch (err) {
-              result2 = `Error: ${err instanceof Error ? err.message : "failed"}`;
-            }
-          }
-        }
-        if (approved && !result2.startsWith("Error:")) {
-          const kindMap2 = {
-            shell: "shell-run",
-            fetch: "url-fetched",
-            "read-file": "file-read",
-            "read-folder": "file-read",
-            grep: "file-read",
-            "delete-file": "file-written",
-            "delete-folder": "file-written",
-            "open-url": "url-fetched",
-            "generate-pdf": "file-written",
-            "write-file": "file-written",
-            search: "url-fetched"
-          };
-          appendMemory({
-            kind: kindMap2[parsed.kind] ?? "shell-run",
-            detail: parsed.kind === "shell" ? parsed.command : parsed.kind === "fetch" ? parsed.url : parsed.kind === "search" ? parsed.query : parsed.kind === "read-folder" ? parsed.folderPath : parsed.kind === "grep" ? `${parsed.pattern} ${parsed.glob}` : parsed.kind === "delete-file" ? parsed.filePath : parsed.kind === "delete-folder" ? parsed.folderPath : parsed.kind === "open-url" ? parsed.url : parsed.kind === "generate-pdf" ? parsed.filePath : parsed.filePath,
-            summary: result2.split(`
-`)[0]?.slice(0, 120) ?? "",
-            repoPath
-          });
-        }
-        const toolName = parsed.kind === "shell" ? "shell" : parsed.kind === "fetch" ? "fetch" : parsed.kind === "read-file" ? "read-file" : parsed.kind === "read-folder" ? "read-folder" : parsed.kind === "grep" ? "grep" : parsed.kind === "delete-file" ? "delete-file" : parsed.kind === "delete-folder" ? "delete-folder" : parsed.kind === "open-url" ? "open-url" : parsed.kind === "generate-pdf" ? "generate-pdf" : parsed.kind === "search" ? "search" : "write-file";
-        const toolContent = parsed.kind === "shell" ? parsed.command : parsed.kind === "fetch" ? parsed.url : parsed.kind === "search" ? parsed.query : parsed.kind === "read-folder" ? parsed.folderPath : parsed.kind === "grep" ? `${parsed.pattern} — ${parsed.glob}` : parsed.kind === "delete-file" ? parsed.filePath : parsed.kind === "delete-folder" ? parsed.folderPath : parsed.kind === "open-url" ? parsed.url : parsed.kind === "generate-pdf" ? parsed.filePath : parsed.filePath;
-        const toolMsg = {
-          role: "assistant",
-          type: "tool",
-          toolName,
-          content: toolContent,
-          result: result2,
-          approved
-        };
-        const withTool = [...currentAll, toolMsg];
-        setAllMessages(withTool);
-        setCommitted((prev) => [...prev, toolMsg]);
-        const nextAbort = new AbortController;
-        abortControllerRef.current = nextAbort;
-        setStage({ type: "thinking" });
-        callChat(provider, systemPrompt, withTool, nextAbort.signal).then((r) => processResponse(r, withTool, nextAbort.signal)).catch(handleError(withTool));
-      };
-      if (autoApprove && isSafeTool) {
-        executeAndContinue(true);
-        return;
-      }
-      setStage({
-        type: "permission",
-        tool,
-        pendingMessages: currentAll,
-        resolve: executeAndContinue
-      });
-      return;
-    }
     if (parsed.kind === "clone") {
+      batchApprovedRef.current = false;
       if (parsed.content) {
         const preambleMsg = {
           role: "assistant",
@@ -52805,23 +52635,116 @@ var ChatRunner = ({ repoPath }) => {
       });
       return;
     }
-    const msg = {
-      role: "assistant",
-      content: parsed.content,
-      type: "text"
-    };
-    const withMsg = [...currentAll, msg];
-    setAllMessages(withMsg);
-    setCommitted((prev) => [...prev, msg]);
-    const lastUserMsg = [...currentAll].reverse().find((m) => m.role === "user");
-    const githubUrl = lastUserMsg ? extractGithubUrl(lastUserMsg.content) : null;
-    if (githubUrl && !clonedUrls.has(githubUrl)) {
-      setTimeout(() => {
-        setStage({ type: "clone-offer", repoUrl: githubUrl });
-      }, 80);
-    } else {
+    if (parsed.kind === "text") {
+      batchApprovedRef.current = false;
+      const msg = {
+        role: "assistant",
+        content: parsed.content,
+        type: "text"
+      };
+      const withMsg = [...currentAll, msg];
+      setAllMessages(withMsg);
+      setCommitted((prev) => [...prev, msg]);
+      const lastUserMsg = [...currentAll].reverse().find((m) => m.role === "user");
+      const githubUrl = lastUserMsg ? extractGithubUrl(lastUserMsg.content) : null;
+      if (githubUrl && !clonedUrls.has(githubUrl)) {
+        setTimeout(() => setStage({ type: "clone-offer", repoUrl: githubUrl }), 80);
+      } else {
+        setStage({ type: "idle" });
+      }
+      return;
+    }
+    const tool = registry.get(parsed.toolName);
+    if (!tool) {
+      batchApprovedRef.current = false;
       setStage({ type: "idle" });
+      return;
+    }
+    if (parsed.content) {
+      const preambleMsg = {
+        role: "assistant",
+        content: parsed.content,
+        type: "text"
+      };
+      setAllMessages([...currentAll, preambleMsg]);
+      setCommitted((prev) => [...prev, preambleMsg]);
+    }
+    const remainder = parsed.remainder;
+    const isSafe = tool.safe ?? false;
+    const executeAndContinue = async (approved) => {
+      if (approved && remainder) {
+        batchApprovedRef.current = true;
+      }
+      let result2 = "(denied by user)";
+      if (approved) {
+        const cacheKey = isSafe ? `${parsed.toolName}:${parsed.rawInput}` : null;
+        if (cacheKey && toolResultCache.current.has(cacheKey)) {
+          result2 = toolResultCache.current.get(cacheKey) + `
+
+[NOTE: This result was already retrieved earlier. Do not request it again.]`;
+        } else {
+          try {
+            setStage({ type: "thinking" });
+            const toolResult = await tool.execute(parsed.input, {
+              repoPath,
+              messages: currentAll
+            });
+            result2 = toolResult.value;
+            if (cacheKey && toolResult.kind === "text") {
+              toolResultCache.current.set(cacheKey, result2);
+            }
+          } catch (err) {
+            result2 = `Error: ${err instanceof Error ? err.message : "failed"}`;
+          }
+        }
+      }
+      if (approved && !result2.startsWith("Error:")) {
+        appendMemory({
+          kind: "shell-run",
+          detail: tool.summariseInput ? String(tool.summariseInput(parsed.input)) : parsed.rawInput,
+          summary: result2.split(`
+`)[0]?.slice(0, 120) ?? "",
+          repoPath
+        });
+      }
+      const displayContent = tool.summariseInput ? String(tool.summariseInput(parsed.input)) : parsed.rawInput;
+      const toolMsg = {
+        role: "assistant",
+        type: "tool",
+        toolName: parsed.toolName,
+        content: displayContent,
+        result: result2,
+        approved
+      };
+      const withTool = [...currentAll, toolMsg];
+      setAllMessages(withTool);
+      setCommitted((prev) => [...prev, toolMsg]);
+      if (approved && remainder && remainder.length > 0) {
+        processResponse(remainder, withTool, signal);
+        return;
+      }
+      batchApprovedRef.current = false;
+      const nextAbort = new AbortController;
+      abortControllerRef.current = nextAbort;
+      setStage({ type: "thinking" });
+      callChat(provider, systemPrompt, withTool, nextAbort.signal).then((r) => processResponse(r, withTool, nextAbort.signal)).catch(handleError(withTool));
+    };
+    if (autoApprove && isSafe || batchApprovedRef.current) {
+      executeAndContinue(true);
+      return;
     }
+    const permLabel = tool.permissionLabel ?? tool.name;
+    const permValue = tool.summariseInput ? String(tool.summariseInput(parsed.input)) : parsed.rawInput;
+    setStage({
+      type: "permission",
+      tool: {
+        type: parsed.toolName,
+        _display: permValue,
+        _label: permLabel
+      },
+      pendingMessages: currentAll,
+      resolve: executeAndContinue
+    });
   };
   const sendMessage = (text) => {
     if (!provider)
@@ -52839,7 +52762,7 @@ var ChatRunner = ({ repoPath }) => {
       setAutoApprove(next);
       const msg = {
         role: "assistant",
-        content: next ? "Auto-approve ON — read, search, grep and folder tools will run without asking. Write and code changes still require approval." : "Auto-approve OFF — all tools will ask for permission.",
+        content: next ? "Auto-approve ON — safe tools (read, search, fetch) will run without asking." : "Auto-approve OFF — all tools will ask for permission.",
         type: "text"
       };
       setCommitted((prev) => [...prev, msg]);
@@ -52848,13 +52771,13 @@ var ChatRunner = ({ repoPath }) => {
     }
     if (text.trim().toLowerCase() === "/clear history") {
       clearRepoMemory(repoPath);
-      const clearedMsg = {
+      const msg = {
         role: "assistant",
         content: "History cleared for this repo.",
         type: "text"
       };
-      setCommitted((prev) => [...prev, clearedMsg]);
-      setAllMessages((prev) => [...prev, clearedMsg]);
+      setCommitted((prev) => [...prev, msg]);
+      setAllMessages((prev) => [...prev, msg]);
       return;
     }
     if (text.trim().toLowerCase() === "/chat") {
@@ -52901,7 +52824,7 @@ var ChatRunner = ({ repoPath }) => {
       if (!name) {
         const msg2 = {
           role: "assistant",
-          content: "Usage: `/chat delete <name>`",
+          content: "Usage: `/chat delete <n>`",
           type: "text"
         };
         setCommitted((prev) => [...prev, msg2]);
@@ -53052,6 +52975,7 @@ ${mems.map((m) => `- [${m.id}] ${m.content}`).join(`
     setCommitted((prev) => [...prev, userMsg]);
     setAllMessages(nextAll);
     toolResultCache.current.clear();
+    batchApprovedRef.current = false;
     inputHistoryRef.current = [
       text,
       ...inputHistoryRef.current.filter((m) => m !== text)
@@ -53074,6 +52998,7 @@ ${mems.map((m) => `- [${m.id}] ${m.content}`).join(`
     if (stage.type === "thinking" && key.escape) {
       abortControllerRef.current?.abort();
       abortControllerRef.current = null;
+      batchApprovedRef.current = false;
       setStage({ type: "idle" });
       return;
     }
@@ -53092,8 +53017,7 @@ ${mems.map((m) => `- [${m.id}] ${m.content}`).join(`
       if (key.downArrow) {
         const next = historyIndexRef.current - 1;
         historyIndexRef.current = next;
-        const val = next < 0 ? "" : inputHistoryRef.current[next];
-        setInputValue(val);
+        setInputValue(next < 0 ? "" : inputHistoryRef.current[next]);
         setInputKey((k) => k + 1);
         return;
       }
@@ -53153,16 +53077,14 @@ ${mems.map((m) => `- [${m.id}] ${m.content}`).join(`
     if (stage.type === "clone-exists") {
       if (input === "y" || input === "Y") {
         const { repoUrl, repoPath: existingPath } = stage;
-        const cloneUrl = toCloneUrl(repoUrl);
         setStage({ type: "cloning", repoUrl });
-        startCloneRepo(cloneUrl, { forceReclone: true }).then((result2) => {
+        startCloneRepo(toCloneUrl(repoUrl), { forceReclone: true }).then((result2) => {
           if (result2.done) {
-            const fileCount = walkDir3(existingPath).length;
             setStage({
               type: "clone-done",
               repoUrl,
               destPath: existingPath,
-              fileCount
+              fileCount: walkDir3(existingPath).length
             });
           } else {
             setStage({
@@ -53175,12 +53097,11 @@ ${mems.map((m) => `- [${m.id}] ${m.content}`).join(`
       }
       if (input === "n" || input === "N") {
         const { repoUrl, repoPath: existingPath } = stage;
-        const fileCount = walkDir3(existingPath).length;
         setStage({
           type: "clone-done",
           repoUrl,
           destPath: existingPath,
-          fileCount
+          fileCount: walkDir3(existingPath).length
         });
         return;
       }
@@ -53202,7 +53123,7 @@ Ask me anything about it — I can read files, explain how it works, or suggest
             type: "tool",
             toolName: "fetch",
             content: stage.repoUrl,
-            result: `Clone complete. Repo: ${repoName}. Local path: ${stage.destPath}. ${stage.fileCount} files. Use read-file with full path e.g. read-file ${stage.destPath}/README.md`,
+            result: `Clone complete. Repo: ${repoName}. Local path: ${stage.destPath}. ${stage.fileCount} files.`,
             approved: true
           };
           const withClone = [...allMessages, contextMsg, summaryMsg];
@@ -53223,6 +53144,7 @@ Ask me anything about it — I can read files, explain how it works, or suggest
         return;
       }
       if (input === "n" || input === "N" || key.escape) {
+        batchApprovedRef.current = false;
         stage.resolve(false);
         return;
       }
@@ -53312,17 +53234,16 @@ ${lensFile.overview}
 
 Important folders: ${lensFile.importantFolders.join(", ")}
 Suggestions: ${lensFile.suggestions.slice(0, 3).join("; ")}` : "";
-      setSystemPrompt(buildSystemPrompt(importantFiles, historySummary) + lensContext);
-      const historyNote = historySummary ? `
-
-I have memory of previous actions in this repo.` : "";
-      const lensGreetNote = lensFile ? `
-
-Found LENS.md — I have context from a previous analysis of this repo.` : "";
+      const toolsSection = registry.buildSystemPromptSection();
+      setSystemPrompt(buildSystemPrompt(importantFiles, historySummary, toolsSection) + lensContext);
       const greeting = {
         role: "assistant",
-        content: `Welcome to Lens 
-Codebase loaded — ${importantFiles.length} files indexed.${historyNote}${lensGreetNote}
+        content: `Welcome to Lens
+Codebase loaded — ${importantFiles.length} files indexed.${historySummary ? `
+
+I have memory of previous actions in this repo.` : ""}${lensFile ? `
+
+Found LENS.md — I have context from a previous analysis of this repo.` : ""}
 Ask me anything, tell me what to build, share a URL, or ask me to read/write files.
 
 Tip: type /timeline to browse commit history.`,
@@ -53337,7 +53258,7 @@ Tip: type /timeline to browse commit history.`,
     return /* @__PURE__ */ jsx_dev_runtime22.jsxDEV(ProviderPicker, {
       onDone: handleProviderDone
     }, undefined, false, undefined, this);
-  if (stage.type === "loading") {
+  if (stage.type === "loading")
     return /* @__PURE__ */ jsx_dev_runtime22.jsxDEV(Box_default, {
       gap: 1,
       marginTop: 1,
@@ -53357,19 +53278,16 @@ Tip: type /timeline to browse commit history.`,
         }, undefined, false, undefined, this)
       ]
     }, undefined, true, undefined, this);
-  }
-  if (showTimeline) {
+  if (showTimeline)
     return /* @__PURE__ */ jsx_dev_runtime22.jsxDEV(TimelineRunner, {
       repoPath,
       onExit: () => setShowTimeline(false)
     }, undefined, false, undefined, this);
-  }
-  if (showReview) {
+  if (showReview)
     return /* @__PURE__ */ jsx_dev_runtime22.jsxDEV(ReviewCommand, {
       path: repoPath,
       onExit: () => setShowReview(false)
     }, undefined, false, undefined, this);
-  }
   if (stage.type === "clone-offer")
     return /* @__PURE__ */ jsx_dev_runtime22.jsxDEV(CloneOfferView, {
       stage,
@@ -53510,9 +53428,259 @@ var TimelineCommand = ({ path: inputPath }) => {
     repoPath: resolvedPath
   }, undefined, false, undefined, this);
 };
+// src/utils/tools/builtins.ts
+var fetchTool = {
+  name: "fetch",
+  description: "load a URL",
+  safe: true,
+  permissionLabel: "fetch",
+  systemPromptEntry: (i) => `### ${i}. fetch — load a URL
+<fetch>https://example.com</fetch>`,
+  parseInput: (body) => body.replace(/^<|>$/g, "").trim() || null,
+  summariseInput: (url) => url,
+  execute: async (url) => {
+    try {
+      const value = await fetchUrl(url);
+      return { kind: "text", value };
+    } catch (err) {
+      return {
+        kind: "error",
+        value: `Fetch failed: ${err instanceof Error ? err.message : String(err)}`
+      };
+    }
+  }
+};
+var shellTool = {
+  name: "shell",
+  description: "run a terminal command",
+  safe: false,
+  permissionLabel: "run",
+  systemPromptEntry: (i) => `### ${i}. shell — run a terminal command
+<shell>node -v</shell>`,
+  parseInput: (body) => body || null,
+  summariseInput: (cmd) => cmd,
+  execute: async (cmd, ctx) => {
+    const value = await runShell(cmd, ctx.repoPath);
+    return { kind: "text", value };
+  }
+};
+var readFileTool = {
+  name: "read-file",
+  description: "read a file from the repo",
+  safe: true,
+  permissionLabel: "read",
+  systemPromptEntry: (i) => `### ${i}. read-file — read a file from the repo
+<read-file>src/foo.ts</read-file>`,
+  parseInput: (body) => body || null,
+  summariseInput: (p) => p,
+  execute: (filePath, ctx) => ({
+    kind: "text",
+    value: readFile(filePath, ctx.repoPath)
+  })
+};
+var readFolderTool = {
+  name: "read-folder",
+  description: "list contents of a folder (files + subfolders, one level deep)",
+  safe: true,
+  permissionLabel: "folder",
+  systemPromptEntry: (i) => `### ${i}. read-folder — list contents of a folder (files + subfolders, one level deep)
+<read-folder>src/components</read-folder>`,
+  parseInput: (body) => body || null,
+  summariseInput: (p) => p,
+  execute: (folderPath, ctx) => ({
+    kind: "text",
+    value: readFolder(folderPath, ctx.repoPath)
+  })
+};
+var grepTool = {
+  name: "grep",
+  description: "search for a pattern across files in the repo",
+  safe: true,
+  permissionLabel: "grep",
+  systemPromptEntry: (i) => `### ${i}. grep — search for a pattern across files in the repo (cross-platform, no shell needed)
+<grep>
+{"pattern": "ChatRunner", "glob": "src/**/*.tsx"}
+</grep>`,
+  parseInput: (body) => {
+    try {
+      const parsed = JSON.parse(body);
+      return { pattern: parsed.pattern, glob: parsed.glob ?? "**/*" };
+    } catch {
+      return { pattern: body, glob: "**/*" };
+    }
+  },
+  summariseInput: ({ pattern, glob }) => `${pattern} — ${glob}`,
+  execute: ({ pattern, glob }, ctx) => ({
+    kind: "text",
+    value: grepFiles(pattern, glob, ctx.repoPath)
+  })
+};
+var writeFileTool = {
+  name: "write-file",
+  description: "create or overwrite a file",
+  safe: false,
+  permissionLabel: "write",
+  systemPromptEntry: (i) => `### ${i}. write-file — create or overwrite a file
+<write-file>
+{"path": "data/output.csv", "content": "col1,col2\\nval1,val2"}
+</write-file>`,
+  parseInput: (body) => {
+    try {
+      const parsed = JSON.parse(body);
+      if (!parsed.path)
+        return null;
+      return parsed;
+    } catch {
+      return null;
+    }
+  },
+  summariseInput: ({ path: path21, content }) => `${path21} (${content.length} bytes)`,
+  execute: ({ path: filePath, content }, ctx) => ({
+    kind: "text",
+    value: writeFile(filePath, content, ctx.repoPath)
+  })
+};
+var deleteFileTool = {
+  name: "delete-file",
+  description: "permanently delete a single file",
+  safe: false,
+  permissionLabel: "delete",
+  systemPromptEntry: (i) => `### ${i}. delete-file — permanently delete a single file
+<delete-file>src/old-component.tsx</delete-file>`,
+  parseInput: (body) => body || null,
+  summariseInput: (p) => p,
+  execute: (filePath, ctx) => ({
+    kind: "text",
+    value: deleteFile(filePath, ctx.repoPath)
+  })
+};
+var deleteFolderTool = {
+  name: "delete-folder",
+  description: "permanently delete a folder and all its contents",
+  safe: false,
+  permissionLabel: "delete folder",
+  systemPromptEntry: (i) => `### ${i}. delete-folder — permanently delete a folder and all its contents
+<delete-folder>src/legacy</delete-folder>`,
+  parseInput: (body) => body || null,
+  summariseInput: (p) => p,
+  execute: (folderPath, ctx) => ({
+    kind: "text",
+    value: deleteFolder(folderPath, ctx.repoPath)
+  })
+};
+var openUrlTool = {
+  name: "open-url",
+  description: "open a URL in the user's default browser",
+  safe: true,
+  permissionLabel: "open",
+  systemPromptEntry: (i) => `### ${i}. open-url — open a URL in the user's default browser
+<open-url>https://github.com/owner/repo</open-url>`,
+  parseInput: (body) => body.replace(/^<|>$/g, "").trim() || null,
+  summariseInput: (url) => url,
+  execute: (url) => ({ kind: "text", value: openUrl(url) })
+};
+var generatePdfTool = {
+  name: "generate-pdf",
+  description: "generate a PDF file from markdown-style content",
+  safe: false,
+  permissionLabel: "pdf",
+  systemPromptEntry: (i) => `### ${i}. generate-pdf — generate a PDF file from markdown-style content
+<generate-pdf>
+{"path": "output/report.pdf", "content": "# Title\\n\\nSome body text."}
+</generate-pdf>`,
+  parseInput: (body) => {
+    try {
+      const parsed = JSON.parse(body);
+      return {
+        filePath: parsed.path ?? parsed.filePath ?? "output.pdf",
+        content: parsed.content ?? ""
+      };
+    } catch {
+      return null;
+    }
+  },
+  summariseInput: ({ filePath }) => filePath,
+  execute: ({ filePath, content }, ctx) => ({
+    kind: "text",
+    value: generatePdf(filePath, content, ctx.repoPath)
+  })
+};
+var searchTool = {
+  name: "search",
+  description: "search the internet for anything you are unsure about",
+  safe: true,
+  permissionLabel: "search",
+  systemPromptEntry: (i) => `### ${i}. search — search the internet for anything you are unsure about
+<search>how to use React useEffect cleanup function</search>`,
+  parseInput: (body) => body || null,
+  summariseInput: (q) => `"${q}"`,
+  execute: async (query) => {
+    try {
+      const value = await searchWeb(query);
+      return { kind: "text", value };
+    } catch (err) {
+      return {
+        kind: "error",
+        value: `Search failed: ${err instanceof Error ? err.message : String(err)}`
+      };
+    }
+  }
+};
+var cloneTool = {
+  name: "clone",
+  description: "clone a GitHub repo so you can explore and discuss it",
+  safe: false,
+  permissionLabel: "clone",
+  systemPromptEntry: (i) => `### ${i}. clone — clone a GitHub repo so you can explore and discuss it
+<clone>https://github.com/owner/repo</clone>`,
+  parseInput: (body) => body.replace(/^<|>$/g, "").trim() || null,
+  summariseInput: (url) => url,
+  execute: (repoUrl) => ({
+    kind: "text",
+    value: `Clone of ${repoUrl} was handled by the UI.`
+  })
+};
+var changesTool = {
+  name: "changes",
+  description: "propose code edits (shown as a diff for user approval)",
+  safe: false,
+  permissionLabel: "changes",
+  systemPromptEntry: (i) => `### ${i}. changes — propose code edits (shown as a diff for user approval)
+<changes>
+{"summary": "what changed and why", "patches": [{"path": "src/foo.ts", "content": "COMPLETE file content", "isNew": false}]}
+</changes>`,
+  parseInput: (body) => {
+    try {
+      return JSON.parse(body);
+    } catch {
+      return null;
+    }
+  },
+  summariseInput: ({ summary }) => summary,
+  execute: ({ summary }) => ({
+    kind: "text",
+    value: `Changes proposed: ${summary}`
+  })
+};
+function registerBuiltins() {
+  registry.register(fetchTool);
+  registry.register(shellTool);
+  registry.register(readFileTool);
+  registry.register(readFolderTool);
+  registry.register(grepTool);
+  registry.register(writeFileTool);
+  registry.register(deleteFileTool);
+  registry.register(deleteFolderTool);
+  registry.register(openUrlTool);
+  registry.register(generatePdfTool);
+  registry.register(searchTool);
+  registry.register(cloneTool);
+  registry.register(changesTool);
+}
 
 // src/index.tsx
 var jsx_dev_runtime25 = __toESM(require_jsx_dev_runtime(), 1);
+registerBuiltins();
 var program2 = new Command;
 program2.command("repo <url>").description("Analyze a remote repository").action((url) => {
   render_default(/* @__PURE__ */ jsx_dev_runtime25.jsxDEV(RepoCommand, {