@hasna/terminal 4.0.0 → 4.2.0

package/dist/mcp/server.js

@@ -498,18 +498,21 @@ export function createServer() {
         offset: z.number().optional().describe("Start line (0-indexed)"),
         limit: z.number().optional().describe("Max lines to return"),
         summarize: z.boolean().optional().describe("Return AI summary instead of full content (saves ~90% tokens)"),
-    }, async ({ path: rawPath, offset, limit, summarize }) => {
+        focus: z.string().optional().describe("Focus hint for summary (e.g., 'public API', 'error handling', 'auth logic')"),
+    }, async ({ path: rawPath, offset, limit, summarize, focus }) => {
         const start = Date.now();
         const path = resolvePath(rawPath);
         const result = cachedRead(path, { offset, limit });
         if (summarize && result.content.length > 500) {
-            // AI-native file summary — ask directly what the file does
             const provider = getOutputProvider();
             const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
             const content = result.content.length > 8000 ? result.content.slice(0, 8000) : result.content;
+            const focusInstruction = focus
+                ? `Focus specifically on: ${focus}. Describe only aspects related to "${focus}".`
+                : `Describe what this source file does in 2-4 lines. Include: main class/module name, key methods/functions, what it exports, and its purpose.`;
             const summary = await provider.complete(`File: ${path}\n\n${content}`, {
                 model: outputModel,
-                system: `Describe what this source file does in 2-4 lines. Include: main class/module name, key methods/functions, what it exports, and its purpose. Be specific — name the actual functions and what they do. Never just say "N lines of code."`,
+                system: `${focusInstruction} Be specific — name the actual functions and what they do. Never just say "N lines of code."`,
                 maxTokens: 300,
                 temperature: 0.2,
             });
@@ -1089,6 +1092,209 @@ Be specific, not generic. Only flag real problems.`,
         }
         return { content: [{ type: "text", text: JSON.stringify({ notes, total: notes.length }) }] };
     });
+    // ── diff: show what changed ────────────────────────────────────────────────
+    server.tool("diff", "Show what changed — git diff with AI summary. One call replaces constructing git diff commands.", {
+        ref: z.string().optional().describe("Diff against this ref (default: unstaged changes). Examples: HEAD~1, main, abc123"),
+        file: z.string().optional().describe("Diff a specific file only"),
+        stat: z.boolean().optional().describe("Show file-level stats only, not full diff (default: false)"),
+        cwd: z.string().optional().describe("Working directory"),
+    }, async ({ ref, file, stat, cwd }) => {
+        const start = Date.now();
+        const workDir = cwd ?? process.cwd();
+        let cmd = "git diff";
+        if (ref)
+            cmd += ` ${ref}`;
+        if (stat)
+            cmd += " --stat";
+        if (file)
+            cmd += ` -- ${file}`;
+        const result = await exec(cmd, workDir, 15000);
+        const output = (result.stdout + result.stderr).trim();
+        if (!output) {
+            return { content: [{ type: "text", text: JSON.stringify({ clean: true, message: "No changes" }) }] };
+        }
+        const processed = await processOutput(cmd, output);
+        logCall("diff", { command: cmd, outputTokens: estimateTokens(output), tokensSaved: processed.tokensSaved, durationMs: Date.now() - start, aiProcessed: processed.aiProcessed });
+        return { content: [{ type: "text", text: JSON.stringify({
+                        summary: processed.summary,
+                        lines: output.split("\n").length,
+                        tokensSaved: processed.tokensSaved,
+                    }) }] };
+    });
+    // ── install: add packages, auto-detect package manager ────────────────────
+    server.tool("install", "Install packages — auto-detects bun/npm/pnpm/yarn/pip/cargo. Agent says what to install, we figure out how.", {
+        packages: z.array(z.string()).describe("Package names to install"),
+        dev: z.boolean().optional().describe("Install as dev dependency (default: false)"),
+        cwd: z.string().optional().describe("Working directory"),
+    }, async ({ packages, dev, cwd }) => {
+        const start = Date.now();
+        const workDir = cwd ?? process.cwd();
+        const { existsSync } = await import("fs");
+        const { join } = await import("path");
+        let cmd;
+        const pkgs = packages.join(" ");
+        const devFlag = dev ? " -D" : "";
+        if (existsSync(join(workDir, "bun.lockb")) || existsSync(join(workDir, "bun.lock"))) {
+            cmd = `bun add${devFlag} ${pkgs}`;
+        }
+        else if (existsSync(join(workDir, "pnpm-lock.yaml"))) {
+            cmd = `pnpm add${devFlag} ${pkgs}`;
+        }
+        else if (existsSync(join(workDir, "yarn.lock"))) {
+            cmd = `yarn add${dev ? " --dev" : ""} ${pkgs}`;
+        }
+        else if (existsSync(join(workDir, "package.json"))) {
+            cmd = `npm install${dev ? " --save-dev" : ""} ${pkgs}`;
+        }
+        else if (existsSync(join(workDir, "requirements.txt")) || existsSync(join(workDir, "pyproject.toml"))) {
+            cmd = `pip install ${pkgs}`;
+        }
+        else if (existsSync(join(workDir, "Cargo.toml"))) {
+            cmd = `cargo add ${pkgs}`;
+        }
+        else {
+            cmd = `npm install${dev ? " --save-dev" : ""} ${pkgs}`;
+        }
+        const result = await exec(cmd, workDir, 60000);
+        const output = (result.stdout + result.stderr).trim();
+        const processed = await processOutput(cmd, output);
+        logCall("install", { command: cmd, exitCode: result.exitCode, durationMs: Date.now() - start, aiProcessed: processed.aiProcessed });
+        return { content: [{ type: "text", text: JSON.stringify({
+                        exitCode: result.exitCode,
+                        command: cmd,
+                        summary: processed.summary,
+                    }) }] };
+    });
+    // ── help: tool discoverability ────────────────────────────────────────────
+    server.tool("help", "Get recommendations for which terminal tool to use. Describe what you want to do and get the best tool + usage example.", {
+        goal: z.string().optional().describe("What you're trying to do (e.g., 'run tests', 'find where login is defined', 'commit my changes')"),
+    }, async ({ goal }) => {
+        if (!goal) {
+            return { content: [{ type: "text", text: JSON.stringify({
+                            tools: {
+                                "execute / execute_smart": "Run any command. Smart = AI summary (80% fewer tokens)",
+                                "run({task})": "Run test/build/lint — auto-detects toolchain",
+                                "commit / bulk_commit / smart_commit": "Git commit — single, multi, or AI-grouped",
+                                "diff({ref})": "Show what changed with AI summary",
+                                "install({packages})": "Add packages — auto-detects bun/npm/pip/cargo",
+                                "search_content({pattern})": "Grep with structured results",
+                                "search_files({pattern})": "Find files by glob",
+                                "symbols({path})": "AI file outline — any language",
+                                "read_symbol({path, name})": "Read one function/class by name",
+                                "read_file({path, summarize})": "Read or AI-summarize a file",
+                                "read_files({files, summarize})": "Multi-file read in one call",
+                                "symbols_dir({path})": "Symbols for entire directory",
+                                "review({since})": "AI code review",
+                                "lookup({file, items})": "Find items in a file by name",
+                                "edit({file, find, replace})": "Find-replace in file",
+                                "repo_state": "Git branch + status + log in one call",
+                                "boot": "Full project context on session start",
+                                "watch({task})": "Run task on file change",
+                                "store_secret / list_secrets": "Secrets vault",
+                                "project_note({save/recall})": "Persistent project notes",
+                            },
+                            tips: [
+                                "Use relative paths — 'src/foo.ts' not '/Users/.../src/foo.ts'",
+                                "Use your native Read/Write/Edit for file operations when you don't need AI summary",
+                                "Use search_content for text patterns, symbols for code structure",
+                                "Use commit for single, bulk_commit for multiple, smart_commit for AI-grouped",
+                            ],
+                        }) }] };
+        }
+        // AI recommends the best tool for the goal
+        const provider = getOutputProvider();
+        const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
+        const recommendation = await provider.complete(`Agent wants to: ${goal}\n\nAvailable tools: execute, execute_smart, run, commit, bulk_commit, smart_commit, diff, install, search_content, search_files, symbols, read_symbol, read_file, read_files, symbols_dir, review, lookup, edit, repo_state, boot, watch, store_secret, list_secrets, project_note, help`, {
+            model: outputModel,
+            system: `Recommend the best terminal MCP tool for this goal. Return JSON: {"tool": "name", "example": {params}, "why": "one line"}. If multiple tools work, list top 2.`,
+            maxTokens: 200, temperature: 0,
+        });
+        return { content: [{ type: "text", text: recommendation }] };
+    });
+    // ── batch: multiple operations in one round trip ───────────────────────────
+    server.tool("batch", "Run multiple operations in ONE call. Saves N-1 round trips. Each op can be: execute (run command), read (file read/summarize), search (grep pattern), or symbols (file outline).", {
+        ops: z.array(z.object({
+            type: z.enum(["execute", "read", "search", "symbols"]).describe("Operation type"),
+            command: z.string().optional().describe("Shell command (for execute)"),
+            path: z.string().optional().describe("File path (for read/symbols)"),
+            pattern: z.string().optional().describe("Search pattern (for search)"),
+            summarize: z.boolean().optional().describe("AI summarize (for read)"),
+            format: z.enum(["raw", "summary"]).optional().describe("Output format (for execute)"),
+        })).describe("Array of operations to run"),
+        cwd: z.string().optional().describe("Working directory for all ops"),
+    }, async ({ ops, cwd }) => {
+        const start = Date.now();
+        const workDir = cwd ?? process.cwd();
+        const results = [];
+        for (let i = 0; i < ops.slice(0, 10).length; i++) {
+            const op = ops[i];
+            try {
+                if (op.type === "execute" && op.command) {
+                    const result = await exec(op.command, workDir, 30000);
+                    const output = (result.stdout + result.stderr).trim();
+                    if (op.format === "summary" && output.split("\n").length > 15) {
+                        const processed = await processOutput(op.command, output);
+                        results.push({ op: i, type: "execute", summary: processed.summary, exitCode: result.exitCode, tokensSaved: processed.tokensSaved });
+                    }
+                    else {
+                        results.push({ op: i, type: "execute", output: stripAnsi(output).slice(0, 2000), exitCode: result.exitCode });
+                    }
+                }
+                else if (op.type === "read" && op.path) {
+                    const filePath = resolvePath(op.path, workDir);
+                    const result = cachedRead(filePath, {});
+                    if (op.summarize && result.content.length > 500) {
+                        const provider = getOutputProvider();
+                        const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
+                        const content = result.content.length > 8000 ? result.content.slice(0, 8000) : result.content;
+                        const summary = await provider.complete(`File: ${filePath}\n\n${content}`, {
+                            model: outputModel,
+                            system: `Describe what this source file does in 2-4 lines. Include: main class/module name, key methods/functions, what it exports, and its purpose. Be specific.`,
+                            maxTokens: 300, temperature: 0.2,
+                        });
+                        results.push({ op: i, type: "read", path: op.path, summary, lines: result.content.split("\n").length });
+                    }
+                    else {
+                        results.push({ op: i, type: "read", path: op.path, content: result.content, lines: result.content.split("\n").length });
+                    }
+                }
+                else if (op.type === "search" && op.pattern) {
+                    const result = await searchContent(op.pattern, op.path ? resolvePath(op.path, workDir) : workDir, {});
+                    results.push({ op: i, type: "search", pattern: op.pattern, totalMatches: result.totalMatches, files: result.files.slice(0, 10) });
+                }
+                else if (op.type === "symbols" && op.path) {
+                    const filePath = resolvePath(op.path, workDir);
+                    const result = cachedRead(filePath, {});
+                    if (result.content && !result.content.startsWith("Error:")) {
+                        const provider = getOutputProvider();
+                        const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
+                        const content = result.content.length > 8000 ? result.content.slice(0, 8000) : result.content;
+                        const summary = await provider.complete(`File: ${filePath}\n\n${content}`, {
+                            model: outputModel,
+                            system: `Extract all symbols. Return ONLY a JSON array. Each: {"name":"x","kind":"function|class|method|interface|type","line":N,"signature":"brief"}. For class methods use "Class.method". Exclude imports.`,
+                            maxTokens: 2000, temperature: 0,
+                        });
+                        let symbols = [];
+                        try {
+                            const m = summary.match(/\[[\s\S]*\]/);
+                            if (m)
+                                symbols = JSON.parse(m[0]);
+                        }
+                        catch { }
+                        results.push({ op: i, type: "symbols", path: op.path, symbols });
+                    }
+                    else {
+                        results.push({ op: i, type: "symbols", path: op.path, error: "Cannot read file" });
+                    }
+                }
+            }
+            catch (err) {
+                results.push({ op: i, type: op.type, error: err.message?.slice(0, 200) });
+            }
+        }
+        logCall("batch", { command: `${ops.length} ops`, durationMs: Date.now() - start, aiProcessed: true });
+        return { content: [{ type: "text", text: JSON.stringify({ results, total: results.length, durationMs: Date.now() - start }) }] };
+    });
     return server;
 }
 // ── main: start MCP server via stdio ─────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/terminal",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "Smart terminal wrapper for AI agents and humans — structured output, token compression, MCP server, natural language",
   "type": "module",
   "files": [

package/src/mcp/server.ts

@@ -698,22 +698,25 @@ export function createServer(): McpServer {
       offset: z.number().optional().describe("Start line (0-indexed)"),
       limit: z.number().optional().describe("Max lines to return"),
       summarize: z.boolean().optional().describe("Return AI summary instead of full content (saves ~90% tokens)"),
+      focus: z.string().optional().describe("Focus hint for summary (e.g., 'public API', 'error handling', 'auth logic')"),
     },
-    async ({ path: rawPath, offset, limit, summarize }) => {
+    async ({ path: rawPath, offset, limit, summarize, focus }) => {
       const start = Date.now();
       const path = resolvePath(rawPath);
       const result = cachedRead(path, { offset, limit });
 
       if (summarize && result.content.length > 500) {
-        // AI-native file summary — ask directly what the file does
         const provider = getOutputProvider();
         const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
         const content = result.content.length > 8000 ? result.content.slice(0, 8000) : result.content;
+        const focusInstruction = focus
+          ? `Focus specifically on: ${focus}. Describe only aspects related to "${focus}".`
+          : `Describe what this source file does in 2-4 lines. Include: main class/module name, key methods/functions, what it exports, and its purpose.`;
         const summary = await provider.complete(
           `File: ${path}\n\n${content}`,
           {
             model: outputModel,
-            system: `Describe what this source file does in 2-4 lines. Include: main class/module name, key methods/functions, what it exports, and its purpose. Be specific — name the actual functions and what they do. Never just say "N lines of code."`,
+            system: `${focusInstruction} Be specific — name the actual functions and what they do. Never just say "N lines of code."`,
             maxTokens: 300,
             temperature: 0.2,
           }
@@ -1426,6 +1429,231 @@ Be specific, not generic. Only flag real problems.`,
     }
   );
 
+  // ── diff: show what changed ────────────────────────────────────────────────
+
+  server.tool(
+    "diff",
+    "Show what changed — git diff with AI summary. One call replaces constructing git diff commands.",
+    {
+      ref: z.string().optional().describe("Diff against this ref (default: unstaged changes). Examples: HEAD~1, main, abc123"),
+      file: z.string().optional().describe("Diff a specific file only"),
+      stat: z.boolean().optional().describe("Show file-level stats only, not full diff (default: false)"),
+      cwd: z.string().optional().describe("Working directory"),
+    },
+    async ({ ref, file, stat, cwd }) => {
+      const start = Date.now();
+      const workDir = cwd ?? process.cwd();
+      let cmd = "git diff";
+      if (ref) cmd += ` ${ref}`;
+      if (stat) cmd += " --stat";
+      if (file) cmd += ` -- ${file}`;
+
+      const result = await exec(cmd, workDir, 15000);
+      const output = (result.stdout + result.stderr).trim();
+
+      if (!output) {
+        return { content: [{ type: "text" as const, text: JSON.stringify({ clean: true, message: "No changes" }) }] };
+      }
+
+      const processed = await processOutput(cmd, output);
+      logCall("diff", { command: cmd, outputTokens: estimateTokens(output), tokensSaved: processed.tokensSaved, durationMs: Date.now() - start, aiProcessed: processed.aiProcessed });
+
+      return { content: [{ type: "text" as const, text: JSON.stringify({
+        summary: processed.summary,
+        lines: output.split("\n").length,
+        tokensSaved: processed.tokensSaved,
+      }) }] };
+    }
+  );
+
+  // ── install: add packages, auto-detect package manager ────────────────────
+
+  server.tool(
+    "install",
+    "Install packages — auto-detects bun/npm/pnpm/yarn/pip/cargo. Agent says what to install, we figure out how.",
+    {
+      packages: z.array(z.string()).describe("Package names to install"),
+      dev: z.boolean().optional().describe("Install as dev dependency (default: false)"),
+      cwd: z.string().optional().describe("Working directory"),
+    },
+    async ({ packages, dev, cwd }) => {
+      const start = Date.now();
+      const workDir = cwd ?? process.cwd();
+      const { existsSync } = await import("fs");
+      const { join } = await import("path");
+
+      let cmd: string;
+      const pkgs = packages.join(" ");
+      const devFlag = dev ? " -D" : "";
+
+      if (existsSync(join(workDir, "bun.lockb")) || existsSync(join(workDir, "bun.lock"))) {
+        cmd = `bun add${devFlag} ${pkgs}`;
+      } else if (existsSync(join(workDir, "pnpm-lock.yaml"))) {
+        cmd = `pnpm add${devFlag} ${pkgs}`;
+      } else if (existsSync(join(workDir, "yarn.lock"))) {
+        cmd = `yarn add${dev ? " --dev" : ""} ${pkgs}`;
+      } else if (existsSync(join(workDir, "package.json"))) {
+        cmd = `npm install${dev ? " --save-dev" : ""} ${pkgs}`;
+      } else if (existsSync(join(workDir, "requirements.txt")) || existsSync(join(workDir, "pyproject.toml"))) {
+        cmd = `pip install ${pkgs}`;
+      } else if (existsSync(join(workDir, "Cargo.toml"))) {
+        cmd = `cargo add ${pkgs}`;
+      } else {
+        cmd = `npm install${dev ? " --save-dev" : ""} ${pkgs}`;
+      }
+
+      const result = await exec(cmd, workDir, 60000);
+      const output = (result.stdout + result.stderr).trim();
+      const processed = await processOutput(cmd, output);
+      logCall("install", { command: cmd, exitCode: result.exitCode, durationMs: Date.now() - start, aiProcessed: processed.aiProcessed });
+
+      return { content: [{ type: "text" as const, text: JSON.stringify({
+        exitCode: result.exitCode,
+        command: cmd,
+        summary: processed.summary,
+      }) }] };
+    }
+  );
+
+  // ── help: tool discoverability ────────────────────────────────────────────
+
+  server.tool(
+    "help",
+    "Get recommendations for which terminal tool to use. Describe what you want to do and get the best tool + usage example.",
+    {
+      goal: z.string().optional().describe("What you're trying to do (e.g., 'run tests', 'find where login is defined', 'commit my changes')"),
+    },
+    async ({ goal }) => {
+      if (!goal) {
+        return { content: [{ type: "text" as const, text: JSON.stringify({
+          tools: {
+            "execute / execute_smart": "Run any command. Smart = AI summary (80% fewer tokens)",
+            "run({task})": "Run test/build/lint — auto-detects toolchain",
+            "commit / bulk_commit / smart_commit": "Git commit — single, multi, or AI-grouped",
+            "diff({ref})": "Show what changed with AI summary",
+            "install({packages})": "Add packages — auto-detects bun/npm/pip/cargo",
+            "search_content({pattern})": "Grep with structured results",
+            "search_files({pattern})": "Find files by glob",
+            "symbols({path})": "AI file outline — any language",
+            "read_symbol({path, name})": "Read one function/class by name",
+            "read_file({path, summarize})": "Read or AI-summarize a file",
+            "read_files({files, summarize})": "Multi-file read in one call",
+            "symbols_dir({path})": "Symbols for entire directory",
+            "review({since})": "AI code review",
+            "lookup({file, items})": "Find items in a file by name",
+            "edit({file, find, replace})": "Find-replace in file",
+            "repo_state": "Git branch + status + log in one call",
+            "boot": "Full project context on session start",
+            "watch({task})": "Run task on file change",
+            "store_secret / list_secrets": "Secrets vault",
+            "project_note({save/recall})": "Persistent project notes",
+          },
+          tips: [
+            "Use relative paths — 'src/foo.ts' not '/Users/.../src/foo.ts'",
+            "Use your native Read/Write/Edit for file operations when you don't need AI summary",
+            "Use search_content for text patterns, symbols for code structure",
+            "Use commit for single, bulk_commit for multiple, smart_commit for AI-grouped",
+          ],
+        }) }] };
+      }
+
+      // AI recommends the best tool for the goal
+      const provider = getOutputProvider();
+      const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
+      const recommendation = await provider.complete(
+        `Agent wants to: ${goal}\n\nAvailable tools: execute, execute_smart, run, commit, bulk_commit, smart_commit, diff, install, search_content, search_files, symbols, read_symbol, read_file, read_files, symbols_dir, review, lookup, edit, repo_state, boot, watch, store_secret, list_secrets, project_note, help`,
+        {
+          model: outputModel,
+          system: `Recommend the best terminal MCP tool for this goal. Return JSON: {"tool": "name", "example": {params}, "why": "one line"}. If multiple tools work, list top 2.`,
+          maxTokens: 200, temperature: 0,
+        }
+      );
+
+      return { content: [{ type: "text" as const, text: recommendation }] };
+    }
+  );
+
+  // ── batch: multiple operations in one round trip ───────────────────────────
+
+  server.tool(
+    "batch",
+    "Run multiple operations in ONE call. Saves N-1 round trips. Each op can be: execute (run command), read (file read/summarize), search (grep pattern), or symbols (file outline).",
+    {
+      ops: z.array(z.object({
+        type: z.enum(["execute", "read", "search", "symbols"]).describe("Operation type"),
+        command: z.string().optional().describe("Shell command (for execute)"),
+        path: z.string().optional().describe("File path (for read/symbols)"),
+        pattern: z.string().optional().describe("Search pattern (for search)"),
+        summarize: z.boolean().optional().describe("AI summarize (for read)"),
+        format: z.enum(["raw", "summary"]).optional().describe("Output format (for execute)"),
+      })).describe("Array of operations to run"),
+      cwd: z.string().optional().describe("Working directory for all ops"),
+    },
+    async ({ ops, cwd }) => {
+      const start = Date.now();
+      const workDir = cwd ?? process.cwd();
+      const results: Record<string, any>[] = [];
+
+      for (let i = 0; i < ops.slice(0, 10).length; i++) {
+        const op = ops[i];
+        try {
+          if (op.type === "execute" && op.command) {
+            const result = await exec(op.command, workDir, 30000);
+            const output = (result.stdout + result.stderr).trim();
+            if (op.format === "summary" && output.split("\n").length > 15) {
+              const processed = await processOutput(op.command, output);
+              results.push({ op: i, type: "execute", summary: processed.summary, exitCode: result.exitCode, tokensSaved: processed.tokensSaved });
+            } else {
+              results.push({ op: i, type: "execute", output: stripAnsi(output).slice(0, 2000), exitCode: result.exitCode });
+            }
+          } else if (op.type === "read" && op.path) {
+            const filePath = resolvePath(op.path, workDir);
+            const result = cachedRead(filePath, {});
+            if (op.summarize && result.content.length > 500) {
+              const provider = getOutputProvider();
+              const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
+              const content = result.content.length > 8000 ? result.content.slice(0, 8000) : result.content;
+              const summary = await provider.complete(`File: ${filePath}\n\n${content}`, {
+                model: outputModel,
+                system: `Describe what this source file does in 2-4 lines. Include: main class/module name, key methods/functions, what it exports, and its purpose. Be specific.`,
+                maxTokens: 300, temperature: 0.2,
+              });
+              results.push({ op: i, type: "read", path: op.path, summary, lines: result.content.split("\n").length });
+            } else {
+              results.push({ op: i, type: "read", path: op.path, content: result.content, lines: result.content.split("\n").length });
+            }
+          } else if (op.type === "search" && op.pattern) {
+            const result = await searchContent(op.pattern, op.path ? resolvePath(op.path, workDir) : workDir, {});
+            results.push({ op: i, type: "search", pattern: op.pattern, totalMatches: result.totalMatches, files: result.files.slice(0, 10) });
+          } else if (op.type === "symbols" && op.path) {
+            const filePath = resolvePath(op.path, workDir);
+            const result = cachedRead(filePath, {});
+            if (result.content && !result.content.startsWith("Error:")) {
+              const provider = getOutputProvider();
+              const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
+              const content = result.content.length > 8000 ? result.content.slice(0, 8000) : result.content;
+              const summary = await provider.complete(`File: ${filePath}\n\n${content}`, {
+                model: outputModel,
+                system: `Extract all symbols. Return ONLY a JSON array. Each: {"name":"x","kind":"function|class|method|interface|type","line":N,"signature":"brief"}. For class methods use "Class.method". Exclude imports.`,
+                maxTokens: 2000, temperature: 0,
+              });
+              let symbols: any[] = [];
+              try { const m = summary.match(/\[[\s\S]*\]/); if (m) symbols = JSON.parse(m[0]); } catch {}
+              results.push({ op: i, type: "symbols", path: op.path, symbols });
+            } else {
+              results.push({ op: i, type: "symbols", path: op.path, error: "Cannot read file" });
+            }
+          }
+        } catch (err: any) {
+          results.push({ op: i, type: op.type, error: err.message?.slice(0, 200) });
+        }
+      }
+
+      logCall("batch", { command: `${ops.length} ops`, durationMs: Date.now() - start, aiProcessed: true });
+      return { content: [{ type: "text" as const, text: JSON.stringify({ results, total: results.length, durationMs: Date.now() - start }) }] };
+    }
+  );
+
   return server;
 }