@claude-code-kit/tools 0.2.0 → 0.3.0

package/README.md

@@ -6,13 +6,13 @@ Built-in tool collection for the [claude-code-kit](https://github.com/Minnzen/cl
 
 | Tool | Description | Read-only |
 |------|-------------|-----------|
-| `bash` | Execute shell commands | No |
-| `read` | Read file contents with line numbers | Yes |
-| `edit` | Edit files via unique string replacement | No |
-| `write` | Write/create files with auto-mkdir | No |
-| `glob` | Find files by glob pattern | Yes |
-| `grep` | Search file contents with regex | Yes |
-| `web_fetch` | Make HTTP requests | Yes (GET) |
+| `Bash` | Execute shell commands | No |
+| `Read` | Read file contents with line numbers | Yes |
+| `Edit` | Edit files via unique string replacement | No |
+| `Write` | Write/create files with auto-mkdir | No |
+| `Glob` | Find files by glob pattern | Yes |
+| `Grep` | Search file contents with regex | Yes |
+| `WebFetch` | Make HTTP requests | Yes (GET) |
 
 ## Usage
 

package/dist/index.d.mts

@@ -1,62 +1,208 @@
 import { z } from 'zod';
 import { ToolDefinition } from '@claude-code-kit/agent';
 
-declare const inputSchema$6: z.ZodObject<{
+declare const inputSchema$c: z.ZodObject<{
     command: z.ZodString;
+    description: z.ZodString;
     cwd: z.ZodOptional<z.ZodString>;
     timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    run_in_background: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    dangerously_disable_sandbox: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
-type Input$6 = z.infer<typeof inputSchema$6>;
-declare const bashTool: ToolDefinition<Input$6>;
+type Input$c = z.infer<typeof inputSchema$c>;
+declare const bashTool: ToolDefinition<Input$c>;
 
-declare const inputSchema$5: z.ZodObject<{
-    path: z.ZodString;
+declare const inputSchema$b: z.ZodObject<{
+    file_path: z.ZodString;
     offset: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
+    pages: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Input$b = z.infer<typeof inputSchema$b>;
+declare const readTool: ToolDefinition<Input$b>;
+
+declare const inputSchema$a: z.ZodObject<{
+    file_path: z.ZodString;
+    old_string: z.ZodString;
+    new_string: z.ZodString;
+    replace_all: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+type Input$a = z.infer<typeof inputSchema$a>;
+declare const editTool: ToolDefinition<Input$a>;
+
+declare const inputSchema$9: z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+type Input$9 = z.infer<typeof inputSchema$9>;
+declare const writeTool: ToolDefinition<Input$9>;
+
+declare const inputSchema$8: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Input$8 = z.infer<typeof inputSchema$8>;
+declare const globTool: ToolDefinition<Input$8>;
+
+declare const inputSchema$7: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    glob: z.ZodOptional<z.ZodString>;
+    output_mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        content: "content";
+        files_with_matches: "files_with_matches";
+        count: "count";
+    }>>>;
+    "-A": z.ZodOptional<z.ZodNumber>;
+    "-B": z.ZodOptional<z.ZodNumber>;
+    "-C": z.ZodOptional<z.ZodNumber>;
+    context: z.ZodOptional<z.ZodNumber>;
+    head_limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    multiline: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    type: z.ZodOptional<z.ZodString>;
+    "-i": z.ZodOptional<z.ZodBoolean>;
+    "-n": z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+type Input$7 = z.infer<typeof inputSchema$7>;
+declare const grepTool: ToolDefinition<Input$7>;
+
+declare const inputSchema$6: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Input$6 = z.infer<typeof inputSchema$6>;
+declare const webFetchTool: ToolDefinition<Input$6>;
+
+declare const inputSchema$5: z.ZodObject<{
+    query: z.ZodString;
+    max_results: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    allowed_domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    blocked_domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 type Input$5 = z.infer<typeof inputSchema$5>;
-declare const readTool: ToolDefinition<Input$5>;
+declare const webSearchTool: ToolDefinition<Input$5>;
+
+interface Task {
+    id: string;
+    title: string;
+    description?: string;
+    status: "pending" | "in_progress" | "completed" | "cancelled";
+    owner?: string;
+    blocks?: string[];
+    blockedBy?: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+interface TaskToolSet {
+    taskCreate: ToolDefinition;
+    taskUpdate: ToolDefinition;
+    taskGet: ToolDefinition;
+    taskList: ToolDefinition;
+    /** Return a snapshot of all tasks (order matches insertion order). */
+    getTasks(): Task[];
+    /** Remove all tasks and reset the ID counter. */
+    clear(): void;
+}
+type TaskToolInstance = TaskToolSet;
+declare function createTaskTool(): TaskToolSet;
 
+interface SubagentFactoryInput {
+    task: string;
+    description?: string;
+    signal: AbortSignal;
+}
+interface SubagentConfig {
+    /**
+     * Factory that creates a new Agent for each subagent invocation.
+     * Receives an object with task, optional description, and AbortSignal.
+     * The returned object must have a `chat(input: string): Promise<string>` method.
+     */
+    agentFactory: (input: SubagentFactoryInput) => {
+        chat(input: string): Promise<string>;
+    };
+    /** Timeout in milliseconds for the subagent execution. Default: 120_000 (2 minutes). */
+    timeout?: number;
+}
 declare const inputSchema$4: z.ZodObject<{
-    path: z.ZodString;
-    oldString: z.ZodString;
-    newString: z.ZodString;
+    task: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Input$4 = z.infer<typeof inputSchema$4>;
-declare const editTool: ToolDefinition<Input$4>;
+/**
+ * Creates a subagent tool that spawns an independent Agent to handle a delegated task.
+ *
+ * The subagent runs with its own session (no shared message history with the parent)
+ * and returns its final text response to the caller.
+ */
+declare function createSubagentTool(config: SubagentConfig): ToolDefinition<Input$4>;
 
 declare const inputSchema$3: z.ZodObject<{
-    path: z.ZodString;
-    content: z.ZodString;
+    notebook_path: z.ZodString;
+    edit_mode: z.ZodEnum<{
+        replace: "replace";
+        insert: "insert";
+        delete: "delete";
+    }>;
+    cell_number: z.ZodOptional<z.ZodNumber>;
+    cell_id: z.ZodOptional<z.ZodString>;
+    cell_type: z.ZodOptional<z.ZodEnum<{
+        code: "code";
+        markdown: "markdown";
+    }>>;
+    new_source: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Input$3 = z.infer<typeof inputSchema$3>;
-declare const writeTool: ToolDefinition<Input$3>;
+declare const notebookEditTool: ToolDefinition<Input$3>;
 
 declare const inputSchema$2: z.ZodObject<{
-    pattern: z.ZodString;
-    cwd: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Input$2 = z.infer<typeof inputSchema$2>;
-declare const globTool: ToolDefinition<Input$2>;
+declare const enterWorktreeTool: ToolDefinition<Input$2>;
 
 declare const inputSchema$1: z.ZodObject<{
-    pattern: z.ZodString;
-    path: z.ZodOptional<z.ZodString>;
-    glob: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    keep: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 type Input$1 = z.infer<typeof inputSchema$1>;
-declare const grepTool: ToolDefinition<Input$1>;
+declare const exitWorktreeTool: ToolDefinition<Input$1>;
 
+/**
+ * Minimal interface for communicating with a Language Server.
+ * The `request` method sends an LSP method with the given params and returns
+ * the JSON-RPC result. Implementations may wrap a JSON-RPC transport, an MCP
+ * bridge, or any other mechanism that speaks LSP.
+ */
+interface LspConnection {
+    request(method: string, params: unknown): Promise<unknown>;
+}
 declare const inputSchema: z.ZodObject<{
-    url: z.ZodString;
-    method: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    body: z.ZodOptional<z.ZodString>;
+    action: z.ZodEnum<{
+        goToDefinition: "goToDefinition";
+        findReferences: "findReferences";
+        hover: "hover";
+        documentSymbol: "documentSymbol";
+        workspaceSymbol: "workspaceSymbol";
+    }>;
+    file_path: z.ZodOptional<z.ZodString>;
+    line: z.ZodOptional<z.ZodNumber>;
+    character: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Input = z.infer<typeof inputSchema>;
-declare const webFetchTool: ToolDefinition<Input>;
+/**
+ * Creates an LSP tool that communicates with a language server through the
+ * provided connection. If no connection is supplied, all actions return a
+ * helpful fallback message explaining how to set one up.
+ */
+declare function createLspTool(connection?: LspConnection): ToolDefinition<Input>;
 
 /** All built-in tools as an array, ready to pass to AgentConfig.tools */
 declare const builtinTools: ToolDefinition[];
 
-export { bashTool, builtinTools, editTool, globTool, grepTool, readTool, webFetchTool, writeTool };
+export { type LspConnection, type SubagentConfig, type SubagentFactoryInput, type Task, type TaskToolInstance, type TaskToolSet, bashTool, builtinTools, createLspTool, createSubagentTool, createTaskTool, editTool, enterWorktreeTool, exitWorktreeTool, globTool, grepTool, notebookEditTool, readTool, webFetchTool, webSearchTool, writeTool };

package/dist/index.d.ts

@@ -1,62 +1,208 @@
 import { z } from 'zod';
 import { ToolDefinition } from '@claude-code-kit/agent';
 
-declare const inputSchema$6: z.ZodObject<{
+declare const inputSchema$c: z.ZodObject<{
     command: z.ZodString;
+    description: z.ZodString;
     cwd: z.ZodOptional<z.ZodString>;
     timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    run_in_background: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    dangerously_disable_sandbox: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
-type Input$6 = z.infer<typeof inputSchema$6>;
-declare const bashTool: ToolDefinition<Input$6>;
+type Input$c = z.infer<typeof inputSchema$c>;
+declare const bashTool: ToolDefinition<Input$c>;
 
-declare const inputSchema$5: z.ZodObject<{
-    path: z.ZodString;
+declare const inputSchema$b: z.ZodObject<{
+    file_path: z.ZodString;
     offset: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
+    pages: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Input$b = z.infer<typeof inputSchema$b>;
+declare const readTool: ToolDefinition<Input$b>;
+
+declare const inputSchema$a: z.ZodObject<{
+    file_path: z.ZodString;
+    old_string: z.ZodString;
+    new_string: z.ZodString;
+    replace_all: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+type Input$a = z.infer<typeof inputSchema$a>;
+declare const editTool: ToolDefinition<Input$a>;
+
+declare const inputSchema$9: z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+type Input$9 = z.infer<typeof inputSchema$9>;
+declare const writeTool: ToolDefinition<Input$9>;
+
+declare const inputSchema$8: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Input$8 = z.infer<typeof inputSchema$8>;
+declare const globTool: ToolDefinition<Input$8>;
+
+declare const inputSchema$7: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    glob: z.ZodOptional<z.ZodString>;
+    output_mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        content: "content";
+        files_with_matches: "files_with_matches";
+        count: "count";
+    }>>>;
+    "-A": z.ZodOptional<z.ZodNumber>;
+    "-B": z.ZodOptional<z.ZodNumber>;
+    "-C": z.ZodOptional<z.ZodNumber>;
+    context: z.ZodOptional<z.ZodNumber>;
+    head_limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    multiline: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    type: z.ZodOptional<z.ZodString>;
+    "-i": z.ZodOptional<z.ZodBoolean>;
+    "-n": z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+type Input$7 = z.infer<typeof inputSchema$7>;
+declare const grepTool: ToolDefinition<Input$7>;
+
+declare const inputSchema$6: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Input$6 = z.infer<typeof inputSchema$6>;
+declare const webFetchTool: ToolDefinition<Input$6>;
+
+declare const inputSchema$5: z.ZodObject<{
+    query: z.ZodString;
+    max_results: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    allowed_domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    blocked_domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 type Input$5 = z.infer<typeof inputSchema$5>;
-declare const readTool: ToolDefinition<Input$5>;
+declare const webSearchTool: ToolDefinition<Input$5>;
+
+interface Task {
+    id: string;
+    title: string;
+    description?: string;
+    status: "pending" | "in_progress" | "completed" | "cancelled";
+    owner?: string;
+    blocks?: string[];
+    blockedBy?: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+interface TaskToolSet {
+    taskCreate: ToolDefinition;
+    taskUpdate: ToolDefinition;
+    taskGet: ToolDefinition;
+    taskList: ToolDefinition;
+    /** Return a snapshot of all tasks (order matches insertion order). */
+    getTasks(): Task[];
+    /** Remove all tasks and reset the ID counter. */
+    clear(): void;
+}
+type TaskToolInstance = TaskToolSet;
+declare function createTaskTool(): TaskToolSet;
 
+interface SubagentFactoryInput {
+    task: string;
+    description?: string;
+    signal: AbortSignal;
+}
+interface SubagentConfig {
+    /**
+     * Factory that creates a new Agent for each subagent invocation.
+     * Receives an object with task, optional description, and AbortSignal.
+     * The returned object must have a `chat(input: string): Promise<string>` method.
+     */
+    agentFactory: (input: SubagentFactoryInput) => {
+        chat(input: string): Promise<string>;
+    };
+    /** Timeout in milliseconds for the subagent execution. Default: 120_000 (2 minutes). */
+    timeout?: number;
+}
 declare const inputSchema$4: z.ZodObject<{
-    path: z.ZodString;
-    oldString: z.ZodString;
-    newString: z.ZodString;
+    task: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Input$4 = z.infer<typeof inputSchema$4>;
-declare const editTool: ToolDefinition<Input$4>;
+/**
+ * Creates a subagent tool that spawns an independent Agent to handle a delegated task.
+ *
+ * The subagent runs with its own session (no shared message history with the parent)
+ * and returns its final text response to the caller.
+ */
+declare function createSubagentTool(config: SubagentConfig): ToolDefinition<Input$4>;
 
 declare const inputSchema$3: z.ZodObject<{
-    path: z.ZodString;
-    content: z.ZodString;
+    notebook_path: z.ZodString;
+    edit_mode: z.ZodEnum<{
+        replace: "replace";
+        insert: "insert";
+        delete: "delete";
+    }>;
+    cell_number: z.ZodOptional<z.ZodNumber>;
+    cell_id: z.ZodOptional<z.ZodString>;
+    cell_type: z.ZodOptional<z.ZodEnum<{
+        code: "code";
+        markdown: "markdown";
+    }>>;
+    new_source: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Input$3 = z.infer<typeof inputSchema$3>;
-declare const writeTool: ToolDefinition<Input$3>;
+declare const notebookEditTool: ToolDefinition<Input$3>;
 
 declare const inputSchema$2: z.ZodObject<{
-    pattern: z.ZodString;
-    cwd: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Input$2 = z.infer<typeof inputSchema$2>;
-declare const globTool: ToolDefinition<Input$2>;
+declare const enterWorktreeTool: ToolDefinition<Input$2>;
 
 declare const inputSchema$1: z.ZodObject<{
-    pattern: z.ZodString;
-    path: z.ZodOptional<z.ZodString>;
-    glob: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    keep: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 type Input$1 = z.infer<typeof inputSchema$1>;
-declare const grepTool: ToolDefinition<Input$1>;
+declare const exitWorktreeTool: ToolDefinition<Input$1>;
 
+/**
+ * Minimal interface for communicating with a Language Server.
+ * The `request` method sends an LSP method with the given params and returns
+ * the JSON-RPC result. Implementations may wrap a JSON-RPC transport, an MCP
+ * bridge, or any other mechanism that speaks LSP.
+ */
+interface LspConnection {
+    request(method: string, params: unknown): Promise<unknown>;
+}
 declare const inputSchema: z.ZodObject<{
-    url: z.ZodString;
-    method: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    body: z.ZodOptional<z.ZodString>;
+    action: z.ZodEnum<{
+        goToDefinition: "goToDefinition";
+        findReferences: "findReferences";
+        hover: "hover";
+        documentSymbol: "documentSymbol";
+        workspaceSymbol: "workspaceSymbol";
+    }>;
+    file_path: z.ZodOptional<z.ZodString>;
+    line: z.ZodOptional<z.ZodNumber>;
+    character: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Input = z.infer<typeof inputSchema>;
-declare const webFetchTool: ToolDefinition<Input>;
+/**
+ * Creates an LSP tool that communicates with a language server through the
+ * provided connection. If no connection is supplied, all actions return a
+ * helpful fallback message explaining how to set one up.
+ */
+declare function createLspTool(connection?: LspConnection): ToolDefinition<Input>;
 
 /** All built-in tools as an array, ready to pass to AgentConfig.tools */
 declare const builtinTools: ToolDefinition[];
 
-export { bashTool, builtinTools, editTool, globTool, grepTool, readTool, webFetchTool, writeTool };
+export { type LspConnection, type SubagentConfig, type SubagentFactoryInput, type Task, type TaskToolInstance, type TaskToolSet, bashTool, builtinTools, createLspTool, createSubagentTool, createTaskTool, editTool, enterWorktreeTool, exitWorktreeTool, globTool, grepTool, notebookEditTool, readTool, webFetchTool, webSearchTool, writeTool };