whale-code 6.5.6 → 6.5.8

package/dist/cli/services/local-tools-agent-defs-utils.js

@@ -0,0 +1,198 @@
+/**
+ * Agent Tool Definitions — Background processes, Config, LSP, Ask User, and Skill tools.
+ * Extracted from local-tools-agent-defs.ts for file size management.
+ */
+
+export const UTILITY_TOOL_DEFINITIONS = [
+// ------------------------------------------------------------------
+// BACKGROUND PROCESS TOOLS
+// ------------------------------------------------------------------
+{
+  name: "bash_output",
+  description: "Read output from a running or completed background shell process. Returns only NEW output since the last read.",
+  input_schema: {
+    type: "object",
+    properties: {
+      bash_id: {
+        type: "string",
+        description: "The process ID returned when starting the background process"
+      },
+      filter: {
+        type: "string",
+        description: "Optional regex to filter output lines"
+      }
+    },
+    required: ["bash_id"]
+  }
+}, {
+  name: "kill_shell",
+  description: "Terminate a running background shell process",
+  input_schema: {
+    type: "object",
+    properties: {
+      shell_id: {
+        type: "string",
+        description: "The process ID to kill"
+      }
+    },
+    required: ["shell_id"]
+  }
+}, {
+  name: "list_shells",
+  description: "List all background shell processes (running and recent completed)",
+  input_schema: {
+    type: "object",
+    properties: {},
+    required: []
+  }
+},
+// ------------------------------------------------------------------
+// TASK OUTPUT / TASK STOP — unified background task management
+// ------------------------------------------------------------------
+{
+  name: "task_output",
+  description: "Get output from a background task (shell or agent). Returns status and output content.",
+  input_schema: {
+    type: "object",
+    properties: {
+      task_id: {
+        type: "string",
+        description: "The task/agent ID (e.g. shell-xxx or agent-xxx)"
+      },
+      block: {
+        type: "boolean",
+        description: "Wait for completion (default: true)"
+      },
+      timeout: {
+        type: "number",
+        description: "Max wait time in ms (default: 30000)"
+      }
+    },
+    required: ["task_id"]
+  }
+}, {
+  name: "task_stop",
+  description: "Stop a running background task (shell or agent) by ID.",
+  input_schema: {
+    type: "object",
+    properties: {
+      task_id: {
+        type: "string",
+        description: "The task ID to stop"
+      }
+    },
+    required: ["task_id"]
+  }
+},
+// ------------------------------------------------------------------
+// CONFIG — runtime settings + mode control (consolidated)
+// ------------------------------------------------------------------
+{
+  name: "config",
+  description: "Read or write CLI settings. Omit value to read. Keys: model (sonnet/opus/haiku), mode (default/plan/yolo — plan restricts to read-only tools), memory. Use mode=plan before non-trivial tasks to explore first, mode=default to resume full access.",
+  input_schema: {
+    type: "object",
+    properties: {
+      setting: {
+        type: "string",
+        description: "Setting key: 'model', 'mode', 'memory'"
+      },
+      value: {
+        type: "string",
+        description: "New value. Omit to read current value."
+      }
+    },
+    required: ["setting"]
+  }
+},
+// ------------------------------------------------------------------
+// LSP — Language Server Protocol code intelligence
+// ------------------------------------------------------------------
+{
+  name: "lsp",
+  description: "Code intelligence via Language Server Protocol. Supports: goToDefinition, findReferences, hover, documentSymbol, workspaceSymbol, goToImplementation, prepareCallHierarchy, incomingCalls, outgoingCalls. Requires a language server installed for the file type.",
+  input_schema: {
+    type: "object",
+    properties: {
+      operation: {
+        type: "string",
+        enum: ["goToDefinition", "findReferences", "hover", "documentSymbol", "workspaceSymbol", "goToImplementation", "prepareCallHierarchy", "incomingCalls", "outgoingCalls"],
+        description: "LSP operation to perform"
+      },
+      filePath: {
+        type: "string",
+        description: "Absolute or relative path to the file"
+      },
+      line: {
+        type: "number",
+        description: "Line number (1-based, as shown in editors)"
+      },
+      character: {
+        type: "number",
+        description: "Character offset (1-based, as shown in editors)"
+      },
+      query: {
+        type: "string",
+        description: "Search query for workspaceSymbol operation (optional, defaults to all symbols)"
+      }
+    },
+    required: ["operation", "filePath", "line", "character"]
+  }
+},
+// ------------------------------------------------------------------
+// ASK_USER — structured multi-choice question
+// ------------------------------------------------------------------
+{
+  name: "ask_user",
+  description: "Ask the user a structured question with predefined options. Use to gather preferences, clarify requirements, or get decisions during execution. The user can always type a custom answer.",
+  input_schema: {
+    type: "object",
+    properties: {
+      question: {
+        type: "string",
+        description: "The question to ask"
+      },
+      options: {
+        type: "array",
+        description: "2-4 options for the user to choose from",
+        items: {
+          type: "object",
+          properties: {
+            label: {
+              type: "string",
+              description: "Short option label (1-5 words)"
+            },
+            description: {
+              type: "string",
+              description: "Explanation of what this option means"
+            }
+          },
+          required: ["label", "description"]
+        }
+      }
+    },
+    required: ["question", "options"]
+  }
+},
+// ------------------------------------------------------------------
+// SKILL — invoke named skills (model-callable)
+// ------------------------------------------------------------------
+{
+  name: "skill",
+  description: "Invoke a named skill. Skills provide specialized workflows like committing code, reviewing PRs, etc. Built-in skills: commit, review, review-pr. Custom skills from .whale/commands/ and ~/.whale/commands/.",
+  input_schema: {
+    type: "object",
+    properties: {
+      skill: {
+        type: "string",
+        description: "Skill name (e.g., 'commit', 'review-pr')"
+      },
+      args: {
+        type: "string",
+        description: "Optional arguments for the skill"
+      }
+    },
+    required: ["skill"]
+  }
+}];
+//# sourceMappingURL=local-tools-agent-defs-utils.js.map

package/dist/cli/services/local-tools-agent-defs-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-tools-agent-defs-utils.js","names":["UTILITY_TOOL_DEFINITIONS","name","description","input_schema","type","properties","bash_id","filter","required","shell_id","task_id","block","timeout","setting","value","operation","enum","filePath","line","character","query","question","options","items","label","skill","args"],"sources":["../../../src/cli/services/local-tools-agent-defs-utils.ts"],"sourcesContent":["/**\n * Agent Tool Definitions — Background processes, Config, LSP, Ask User, and Skill tools.\n * Extracted from local-tools-agent-defs.ts for file size management.\n */\n\nimport type { LocalToolDefinition } from \"./local-tools.js\";\n\nexport const UTILITY_TOOL_DEFINITIONS: LocalToolDefinition[] = [\n  // ------------------------------------------------------------------\n  // BACKGROUND PROCESS TOOLS\n  // ------------------------------------------------------------------\n  {\n    name: \"bash_output\",\n    description: \"Read output from a running or completed background shell process. Returns only NEW output since the last read.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        bash_id: { type: \"string\", description: \"The process ID returned when starting the background process\" },\n        filter: { type: \"string\", description: \"Optional regex to filter output lines\" },\n      },\n      required: [\"bash_id\"],\n    },\n  },\n  {\n    name: \"kill_shell\",\n    description: \"Terminate a running background shell process\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        shell_id: { type: \"string\", description: \"The process ID to kill\" },\n      },\n      required: [\"shell_id\"],\n    },\n  },\n  {\n    name: \"list_shells\",\n    description: \"List all background shell processes (running and recent completed)\",\n    input_schema: {\n      type: \"object\",\n      properties: {},\n      required: [],\n    },\n  },\n  // ------------------------------------------------------------------\n  // TASK OUTPUT / TASK STOP — unified background task management\n  // ------------------------------------------------------------------\n  {\n    name: \"task_output\",\n    description: \"Get output from a background task (shell or agent). Returns status and output content.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        task_id: { type: \"string\", description: \"The task/agent ID (e.g. shell-xxx or agent-xxx)\" },\n        block: { type: \"boolean\", description: \"Wait for completion (default: true)\" },\n        timeout: { type: \"number\", description: \"Max wait time in ms (default: 30000)\" },\n      },\n      required: [\"task_id\"],\n    },\n  },\n  {\n    name: \"task_stop\",\n    description: \"Stop a running background task (shell or agent) by ID.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        task_id: { type: \"string\", description: \"The task ID to stop\" },\n      },\n      required: [\"task_id\"],\n    },\n  },\n\n  // ------------------------------------------------------------------\n  // CONFIG — runtime settings + mode control (consolidated)\n  // ------------------------------------------------------------------\n  {\n    name: \"config\",\n    description: \"Read or write CLI settings. Omit value to read. Keys: model (sonnet/opus/haiku), mode (default/plan/yolo — plan restricts to read-only tools), memory. Use mode=plan before non-trivial tasks to explore first, mode=default to resume full access.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        setting: { type: \"string\", description: \"Setting key: 'model', 'mode', 'memory'\" },\n        value: { type: \"string\", description: \"New value. Omit to read current value.\" },\n      },\n      required: [\"setting\"],\n    },\n  },\n\n  // ------------------------------------------------------------------\n  // LSP — Language Server Protocol code intelligence\n  // ------------------------------------------------------------------\n  {\n    name: \"lsp\",\n    description: \"Code intelligence via Language Server Protocol. Supports: goToDefinition, findReferences, hover, documentSymbol, workspaceSymbol, goToImplementation, prepareCallHierarchy, incomingCalls, outgoingCalls. Requires a language server installed for the file type.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        operation: {\n          type: \"string\",\n          enum: [\n            \"goToDefinition\",\n            \"findReferences\",\n            \"hover\",\n            \"documentSymbol\",\n            \"workspaceSymbol\",\n            \"goToImplementation\",\n            \"prepareCallHierarchy\",\n            \"incomingCalls\",\n            \"outgoingCalls\",\n          ],\n          description: \"LSP operation to perform\",\n        },\n        filePath: { type: \"string\", description: \"Absolute or relative path to the file\" },\n        line: { type: \"number\", description: \"Line number (1-based, as shown in editors)\" },\n        character: { type: \"number\", description: \"Character offset (1-based, as shown in editors)\" },\n        query: { type: \"string\", description: \"Search query for workspaceSymbol operation (optional, defaults to all symbols)\" },\n      },\n      required: [\"operation\", \"filePath\", \"line\", \"character\"],\n    },\n  },\n\n  // ------------------------------------------------------------------\n  // ASK_USER — structured multi-choice question\n  // ------------------------------------------------------------------\n  {\n    name: \"ask_user\",\n    description: \"Ask the user a structured question with predefined options. Use to gather preferences, clarify requirements, or get decisions during execution. The user can always type a custom answer.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        question: { type: \"string\", description: \"The question to ask\" },\n        options: {\n          type: \"array\",\n          description: \"2-4 options for the user to choose from\",\n          items: {\n            type: \"object\",\n            properties: {\n              label: { type: \"string\", description: \"Short option label (1-5 words)\" },\n              description: { type: \"string\", description: \"Explanation of what this option means\" },\n            },\n            required: [\"label\", \"description\"],\n          },\n        },\n      },\n      required: [\"question\", \"options\"],\n    },\n  },\n\n  // ------------------------------------------------------------------\n  // SKILL — invoke named skills (model-callable)\n  // ------------------------------------------------------------------\n  {\n    name: \"skill\",\n    description: \"Invoke a named skill. Skills provide specialized workflows like committing code, reviewing PRs, etc. Built-in skills: commit, review, review-pr. Custom skills from .whale/commands/ and ~/.whale/commands/.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        skill: { type: \"string\", description: \"Skill name (e.g., 'commit', 'review-pr')\" },\n        args: { type: \"string\", description: \"Optional arguments for the skill\" },\n      },\n      required: [\"skill\"],\n    },\n  },\n];\n"],"mappings":"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","ignoreList":[]}

package/dist/cli/services/local-tools-agent-defs.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Agent & System Tool Definitions — tasks, subagents, teams, config, LSP, etc.
+ * Extracted from local-tools.ts for file size management.
+ *
+ * Split into:
+ *   - local-tools-agent-defs-tasks.ts  (tasks, multi_edit, subagent, team tools)
+ *   - local-tools-agent-defs-utils.ts  (background, config, LSP, ask_user, skill tools)
+ */
+import type { LocalToolDefinition } from "./local-tools.js";
+export declare const AGENT_TOOL_DEFINITIONS: LocalToolDefinition[];

package/dist/cli/services/local-tools-agent-defs.js

@@ -0,0 +1,13 @@
+/**
+ * Agent & System Tool Definitions — tasks, subagents, teams, config, LSP, etc.
+ * Extracted from local-tools.ts for file size management.
+ *
+ * Split into:
+ *   - local-tools-agent-defs-tasks.ts  (tasks, multi_edit, subagent, team tools)
+ *   - local-tools-agent-defs-utils.ts  (background, config, LSP, ask_user, skill tools)
+ */
+
+import { TASK_AND_TEAM_TOOL_DEFINITIONS } from "./local-tools-agent-defs-tasks.js";
+import { UTILITY_TOOL_DEFINITIONS } from "./local-tools-agent-defs-utils.js";
+export const AGENT_TOOL_DEFINITIONS = [...TASK_AND_TEAM_TOOL_DEFINITIONS, ...UTILITY_TOOL_DEFINITIONS];
+//# sourceMappingURL=local-tools-agent-defs.js.map

package/dist/cli/services/local-tools-agent-defs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-tools-agent-defs.js","names":["TASK_AND_TEAM_TOOL_DEFINITIONS","UTILITY_TOOL_DEFINITIONS","AGENT_TOOL_DEFINITIONS"],"sources":["../../../src/cli/services/local-tools-agent-defs.ts"],"sourcesContent":["/**\n * Agent & System Tool Definitions — tasks, subagents, teams, config, LSP, etc.\n * Extracted from local-tools.ts for file size management.\n *\n * Split into:\n *   - local-tools-agent-defs-tasks.ts  (tasks, multi_edit, subagent, team tools)\n *   - local-tools-agent-defs-utils.ts  (background, config, LSP, ask_user, skill tools)\n */\n\nimport type { LocalToolDefinition } from \"./local-tools.js\";\nimport { TASK_AND_TEAM_TOOL_DEFINITIONS } from \"./local-tools-agent-defs-tasks.js\";\nimport { UTILITY_TOOL_DEFINITIONS } from \"./local-tools-agent-defs-utils.js\";\n\nexport const AGENT_TOOL_DEFINITIONS: LocalToolDefinition[] = [\n  ...TASK_AND_TEAM_TOOL_DEFINITIONS,\n  ...UTILITY_TOOL_DEFINITIONS,\n];\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,8BAA8B,QAAQ,mCAAmC;AAClF,SAASC,wBAAwB,QAAQ,mCAAmC;AAE5E,OAAO,MAAMC,sBAA6C,GAAG,CAC3D,GAAGF,8BAA8B,EACjC,GAAGC,wBAAwB,CAC5B","ignoreList":[]}

package/dist/cli/services/local-tools-definitions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Local Tool Definitions — Anthropic API tool schemas
+ * Extracted from local-tools.ts for file size management.
+ */
+import type { LocalToolDefinition } from "./local-tools.js";
+export declare const LOCAL_TOOL_DEFINITIONS: LocalToolDefinition[];

package/dist/cli/services/local-tools-files.test.js

@@ -0,0 +1,256 @@
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import { writeFileSync, mkdirSync, rmSync, existsSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+
+// ============================================================================
+// Test setup — create temporary files for testing
+// ============================================================================
+
+const TEST_DIR = join(tmpdir(), `local-tools-test-${Date.now()}`);
+function setupTestFiles() {
+  mkdirSync(join(TEST_DIR, "src", "sub"), {
+    recursive: true
+  });
+
+  // Normal text files
+  writeFileSync(join(TEST_DIR, "src", "file1.ts"), 'export const a = 1;\nexport const b = 2;\n');
+  writeFileSync(join(TEST_DIR, "src", "file2.ts"), 'export const c = 3;\n');
+  writeFileSync(join(TEST_DIR, "src", "sub", "nested.ts"), 'export const d = 4;\n');
+  writeFileSync(join(TEST_DIR, "config.json"), '{"key": "value"}\n');
+
+  // Large file (>500 lines)
+  const bigLines = [];
+  for (let i = 0; i < 600; i++) {
+    bigLines.push(`// Line ${i + 1}: some content here`);
+  }
+  writeFileSync(join(TEST_DIR, "src", "big-file.ts"), bigLines.join("\n"));
+
+  // Small MP3-like file (just the extension matters for detection)
+  writeFileSync(join(TEST_DIR, "test.mp3"), Buffer.from("fake-mp3-content"));
+  writeFileSync(join(TEST_DIR, "test.wav"), Buffer.from("fake-wav-content"));
+  writeFileSync(join(TEST_DIR, "test.png"), Buffer.from("fake-png-content"));
+}
+function cleanupTestFiles() {
+  if (existsSync(TEST_DIR)) {
+    rmSync(TEST_DIR, {
+      recursive: true,
+      force: true
+    });
+  }
+}
+beforeAll(() => {
+  cleanupTestFiles();
+  setupTestFiles();
+});
+afterAll(() => {
+  cleanupTestFiles();
+});
+
+// ============================================================================
+// Feature 1: read_many_files
+// ============================================================================
+
+describe("read_many_files", () => {
+  // Dynamic import to avoid ESM issues
+  let executeLocalTool;
+  beforeAll(async () => {
+    const mod = await import("./local-tools.js");
+    executeLocalTool = mod.executeLocalTool;
+  });
+  it("reads multiple files matching a glob pattern", async () => {
+    const result = await executeLocalTool("read_many_files", {
+      pattern: "*.ts",
+      path: join(TEST_DIR, "src")
+    });
+    expect(result.success).toBe(true);
+    expect(result.output).toContain("=== ");
+    expect(result.output).toContain("file1.ts");
+    expect(result.output).toContain("export const a = 1;");
+    expect(result.output).toContain("file2.ts");
+    expect(result.output).toContain("export const c = 3;");
+  });
+  it("respects the limit parameter", async () => {
+    const result = await executeLocalTool("read_many_files", {
+      pattern: "*.ts",
+      path: join(TEST_DIR, "src"),
+      limit: 1
+    });
+    expect(result.success).toBe(true);
+    // Should only read 1 file
+    const separatorCount = (result.output.match(/=== /g) || []).length;
+    expect(separatorCount).toBe(1);
+  });
+  it("truncates files >2000 lines to first 500 lines", async () => {
+    // The test setup creates a 600-line file, but the truncation threshold is 2000 lines.
+    // A 600-line file is NOT truncated. We need a file with >2000 lines to trigger truncation.
+    // First, create a big enough file
+    const bigLines = [];
+    for (let i = 0; i < 2500; i++) {
+      bigLines.push(`// Line ${i + 1}: some content here`);
+    }
+    writeFileSync(join(TEST_DIR, "src", "huge-file.ts"), bigLines.join("\n"));
+    const result = await executeLocalTool("read_many_files", {
+      pattern: "huge-file.ts",
+      path: join(TEST_DIR, "src")
+    });
+    expect(result.success).toBe(true);
+    expect(result.output).toContain("truncated");
+    expect(result.output).toContain("2500 total lines");
+    expect(result.output).toContain("showing first 500");
+    // Should contain line 1 but not line 1000
+    expect(result.output).toContain("Line 1:");
+    expect(result.output).not.toContain("Line 1000:");
+  });
+  it("skips binary files with a marker", async () => {
+    const result = await executeLocalTool("read_many_files", {
+      pattern: "*.mp3",
+      path: TEST_DIR
+    });
+    expect(result.success).toBe(true);
+    expect(result.output).toContain("Binary file");
+    expect(result.output).toContain("mp3");
+  });
+  it("returns summary with counts", async () => {
+    const result = await executeLocalTool("read_many_files", {
+      pattern: "*.ts",
+      path: join(TEST_DIR, "src")
+    });
+    expect(result.success).toBe(true);
+    expect(result.output).toContain("Read ");
+    expect(result.output).toContain("total matches");
+  });
+  it("handles no matches gracefully", async () => {
+    const result = await executeLocalTool("read_many_files", {
+      pattern: "*.xyz",
+      path: TEST_DIR
+    });
+    expect(result.success).toBe(true);
+    expect(result.output).toContain("No files matched");
+  });
+  it("enforces max limit of 50", async () => {
+    const result = await executeLocalTool("read_many_files", {
+      pattern: "*.ts",
+      path: join(TEST_DIR, "src"),
+      limit: 999
+    });
+
+    // Should not error; limit is clamped to 50
+    expect(result.success).toBe(true);
+  });
+  it("defaults path to cwd when not specified", async () => {
+    // This tests that it doesn't crash; actual files depend on cwd
+    const result = await executeLocalTool("read_many_files", {
+      pattern: "package.json"
+    });
+    expect(result.success).toBe(true);
+  });
+});
+
+// ============================================================================
+// Feature 2: Audio file support in read_file
+// ============================================================================
+
+describe("read_file audio support", () => {
+  let executeLocalTool;
+  beforeAll(async () => {
+    const mod = await import("./local-tools.js");
+    executeLocalTool = mod.executeLocalTool;
+  });
+  it("reads .mp3 files as base64 with __AUDIO__ marker", async () => {
+    const result = await executeLocalTool("read_file", {
+      path: join(TEST_DIR, "test.mp3")
+    });
+    expect(result.success).toBe(true);
+    expect(result.output).toMatch(/^__AUDIO__audio\/mpeg__/);
+    // Verify the base64 data is present
+    const parts = result.output.split("__");
+    expect(parts.length).toBeGreaterThanOrEqual(3);
+  });
+  it("reads .wav files as base64 with __AUDIO__ marker", async () => {
+    const result = await executeLocalTool("read_file", {
+      path: join(TEST_DIR, "test.wav")
+    });
+    expect(result.success).toBe(true);
+    expect(result.output).toMatch(/^__AUDIO__audio\/wav__/);
+  });
+  it("still reads images with __IMAGE__ marker", async () => {
+    const result = await executeLocalTool("read_file", {
+      path: join(TEST_DIR, "test.png")
+    });
+    expect(result.success).toBe(true);
+    expect(result.output).toMatch(/^__IMAGE__image\/png__/);
+  });
+  it("still reads text files normally", async () => {
+    const result = await executeLocalTool("read_file", {
+      path: join(TEST_DIR, "config.json")
+    });
+    expect(result.success).toBe(true);
+    expect(result.output).toContain('"key"');
+    expect(result.output).not.toContain("__AUDIO__");
+    expect(result.output).not.toContain("__IMAGE__");
+  });
+  it("rejects audio files larger than 25MB", async () => {
+    // Create a file that appears to be >25MB
+    const bigAudioPath = join(TEST_DIR, "big.m4a");
+    // We can't easily create a 25MB+ file in a test, but we can test the
+    // path works for normal-sized files
+    writeFileSync(bigAudioPath, Buffer.from("small-audio"));
+    const result = await executeLocalTool("read_file", {
+      path: bigAudioPath
+    });
+    expect(result.success).toBe(true);
+    expect(result.output).toMatch(/^__AUDIO__audio\/mp4__/);
+  });
+  it("handles non-existent audio files", async () => {
+    const result = await executeLocalTool("read_file", {
+      path: join(TEST_DIR, "nonexistent.mp3")
+    });
+    expect(result.success).toBe(false);
+    expect(result.output).toContain("not found");
+  });
+  it("supports all audio extensions", async () => {
+    const extensions = ["aiff", "aac", "ogg", "flac"];
+    const expectedMimes = {
+      aiff: "audio/aiff",
+      aac: "audio/aac",
+      ogg: "audio/ogg",
+      flac: "audio/flac"
+    };
+    for (const ext of extensions) {
+      const filePath = join(TEST_DIR, `test.${ext}`);
+      writeFileSync(filePath, Buffer.from(`fake-${ext}-content`));
+      const result = await executeLocalTool("read_file", {
+        path: filePath
+      });
+      expect(result.success).toBe(true);
+      expect(result.output).toContain(`__AUDIO__${expectedMimes[ext]}__`);
+    }
+  });
+});
+
+// ============================================================================
+// Tool registry checks
+// ============================================================================
+
+describe("tool registry", () => {
+  let LOCAL_TOOL_NAMES;
+  let LOCAL_TOOL_DEFINITIONS;
+  let isLocalTool;
+  beforeAll(async () => {
+    const mod = await import("./local-tools.js");
+    LOCAL_TOOL_NAMES = mod.LOCAL_TOOL_NAMES;
+    LOCAL_TOOL_DEFINITIONS = mod.LOCAL_TOOL_DEFINITIONS;
+    isLocalTool = mod.isLocalTool;
+  });
+  it("includes read_many_files in LOCAL_TOOL_NAMES", () => {
+    expect(LOCAL_TOOL_NAMES.has("read_many_files")).toBe(true);
+  });
+  it("isLocalTool returns true for read_many_files", () => {
+    expect(isLocalTool("read_many_files")).toBe(true);
+  });
+  it("has a tool definition for read_many_files", () => {
+    const def = LOCAL_TOOL_DEFINITIONS.find(d => d.name === "read_many_files");
+    expect(def).toBeDefined();
+  });
+});

package/dist/cli/services/local-tools-read-many.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Read Many Files — reads multiple files matching glob patterns
+ * Extracted from local-tools.ts for file size management.
+ */
+import type { ToolResult } from "../../shared/types.js";
+export declare function readManyFiles(input: Record<string, unknown>): Promise<ToolResult>;

package/dist/cli/services/local-tools.js

@@ -9,7 +9,7 @@
 export { loadTodos, setTodoSessionId, getTodoState } from "./tools/task-manager.js";
 
 // Import tool implementations from extracted modules
-import { readFile, writeFile, editFile, multiEdit, notebookEdit, listDirectory, searchFiles, searchContent, resolvePath } from "./tools/file-ops.js";
+import { readFile, writeFile, editFile, multiEdit, notebookEdit, listDirectory, searchFiles, searchContent, diffFiles, resolvePath } from "./tools/file-ops.js";
 import { readFileSync, existsSync, statSync } from "fs";
 import { resolve } from "path";
 import { globSearch, grepSearch } from "./tools/search-tools.js";
@@ -39,7 +39,7 @@ export const LOCAL_TOOL_NAMES = new Set([
 "team_create",
 // Agent team tool (explicit tasks)
 "team_auto",
-// Auto-decompose + parallel team + review
+// Auto-decompose + parallel team
 // Background process tools
 "bash_output", "kill_shell", "list_shells",
 // Background task tools (shells + agents)
@@ -565,11 +565,11 @@ export const LOCAL_TOOL_DEFINITIONS = [
   }
 },
 // ------------------------------------------------------------------
-// TEAM — parallel agent team for large tasks
+// TEAM — parallel agent team for large tasks (non-blocking)
 // ------------------------------------------------------------------
 {
   name: "team_create",
-  description: "Create an Agent Team — multiple full Claude instances in parallel. Each teammate has full tool access, can spawn subagents via 'task' tool, and batches tool calls. Teammates → subagents → batch tools. Size tasks for 5-6 items per teammate. Include file lists to prevent conflicts.",
+  description: "Create an Agent Team — multiple full Claude instances in parallel. Returns immediately with a team_id. Use task_output to check progress and task_stop to kill stuck teammates. Each teammate has full tool access. Size tasks for 5-6 items per teammate. Include file lists to prevent conflicts.",
   input_schema: {
     type: "object",
     properties: {
@@ -623,7 +623,7 @@ export const LOCAL_TOOL_DEFINITIONS = [
   }
 }, {
   name: "team_auto",
-  description: "Auto-decompose a task and run it as a parallel agent team. AI breaks the task into sub-tasks with file ownership, spawns teammates, executes in parallel, and reviews results. Use this for large tasks where you don't want to manually plan the decomposition.",
+  description: "Auto-decompose a task and run it as a parallel agent team. AI breaks the task into sub-tasks with file ownership, spawns teammates, executes in parallel. Returns a team_id — use team_status to monitor progress and team_stop to kill stuck teammates.",
   input_schema: {
     type: "object",
     properties: {
@@ -643,10 +643,6 @@ export const LOCAL_TOOL_DEFINITIONS = [
       working_directory: {
         type: "string",
         description: "Project directory to work in (default: cwd)"
-      },
-      review: {
-        type: "boolean",
-        description: "Run a review pass after completion (default: true)"
       }
     },
     required: ["task"]
@@ -956,6 +952,8 @@ export async function executeLocalTool(name, input, signal) {
         return multiEdit(input);
       case "notebook_edit":
         return notebookEdit(input);
+      case "diff_files":
+        return diffFiles(input);
       // Search (tools/search-tools.ts)
       case "glob":
         return globSearch(input);