concevent-ai-agent-sdk 2.2.0 → 2.3.0

package/README.md

@@ -6,6 +6,7 @@ A framework-agnostic AI Agent SDK for building intelligent conversational agents
 
 - 🤖 **AI Agent Framework** - Create intelligent agents with tool/function calling capabilities
 - 🔧 **Tool Execution** - Define and execute custom tools with typed parameters using Zod schemas
+- 🧰 **Built-in Tools** - Ready-to-use tools for file operations, shell commands, and task management
 - 💬 **Conversation Management** - Automatic history tracking with built-in summarization
 - 📊 **Token Usage Tracking** - Monitor token consumption across conversations
 - 🔄 **Auto-Summarization** - Automatically summarize long conversations to stay within context limits
@@ -87,6 +88,7 @@ console.log(result.message);
   - [createAgent](#createagent)
   - [Agent Interface](#agent-interface)
   - [Tool Definitions](#tool-definitions)
+  - [Built-in Tools](#built-in-tools)
   - [Callbacks & Events](#callbacks--events)
   - [Types](#types)
 - [Streaming](#streaming)
@@ -454,6 +456,213 @@ const longRunningTool: ToolDefinition = {
 
 ---
 
+### Built-in Tools
+
+The SDK provides a collection of general-purpose, OS-agnostic built-in tools that can be used directly with agents or orchestrators. These tools cover common operations like file system access, shell execution, and task management.
+
+#### Quick Start
+
+You must explicitly specify which tools you need using the `tools` property. Tool names are strongly typed with autocomplete support:
+
+```typescript
+import { createAgent, createBuiltInTools } from 'concevent-ai-agent-sdk';
+
+// Explicitly specify which tools you need
+const { tools, cleanup } = createBuiltInTools({ 
+  workingDirectory: '/path/to/project',
+  tools: ['Read', 'Write', 'Edit', 'Glob', 'Grep'],
+});
+
+const agent = createAgent({
+  apiKey: process.env.OPENROUTER_API_KEY!,
+  model: 'anthropic/claude-3.5-sonnet',
+  systemPrompts: ['You are a helpful coding assistant.'],
+  tools: [...tools],
+});
+
+// Don't forget to cleanup background processes when done
+process.on('exit', () => cleanup());
+```
+
+#### Available Tools
+
+| Tool | Description | Parallel-Safe |
+|------|-------------|---------------|
+| `'Read'` | Read file contents with optional line range | ✅ |
+| `'Write'` | Create or overwrite files | ❌ |
+| `'Edit'` | Targeted string replacement in files | ❌ |
+| `'Glob'` | Find files matching glob patterns | ✅ |
+| `'Grep'` | Search for patterns in file contents | ✅ |
+| `'Bash'` | Execute shell commands | ❌ |
+| `'BashOutput'` | Get output from background processes | ✅ |
+| `'KillBash'` | Terminate background processes | ❌ |
+| `'Task'` | Launch sub-agents for complex tasks | ❌ |
+| `'TodoWrite'` | Manage structured todo items | ❌ |
+
+#### Tool Selection Examples
+
+```typescript
+import { createBuiltInTools } from 'concevent-ai-agent-sdk';
+
+// Read-only tools for safe analysis
+const { tools: readOnlyTools } = createBuiltInTools({
+  workingDirectory: '/project',
+  tools: ['Read', 'Glob', 'Grep'],
+});
+
+// File tools only (no shell access)
+const { tools: fileTools } = createBuiltInTools({
+  workingDirectory: '/project',
+  tools: ['Read', 'Write', 'Edit', 'Glob', 'Grep'],
+});
+
+// Shell tools only
+const { tools: shellTools } = createBuiltInTools({
+  workingDirectory: '/project',
+  tools: ['Bash', 'BashOutput', 'KillBash'],
+});
+```
+
+#### Configuration
+
+```typescript
+interface BuiltInToolsConfig {
+  /** Required: Which tools to include (strongly typed with autocomplete). */
+  tools: ToolName[];
+  
+  /** Working directory for file operations (defaults to process.cwd()) */
+  workingDirectory?: string;
+  
+  /** Allowed file paths for sandboxing */
+  allowedPaths?: string[];
+  
+  /** Blocked shell command patterns (defaults to dangerous patterns) */
+  blockedCommands?: RegExp[];
+  
+  /** Default timeout for shell commands in ms (default: 30000) */
+  defaultTimeout?: number;
+  
+  /** Agent factory for Task tool (required if using Task) */
+  agentFactory?: (config: TaskAgentConfig) => Promise<{ message: string }>;
+  
+  /** Custom todo storage (defaults to in-memory) */
+  todoStorage?: TodoStorage;
+}
+
+#### Individual Tool Creation
+
+Create specific tools when you need fine-grained control:
+
+```typescript
+import { 
+  createReadTool, 
+  createBashTool,
+  createBuiltInTool,
+} from 'concevent-ai-agent-sdk';
+
+// Create a specific tool using its creator function
+const readTool = createReadTool({ workingDirectory: '/project' });
+
+// Or use the generic factory with tool name (strongly typed)
+const bashTool = createBuiltInTool('Bash', { 
+  workingDirectory: '/project',
+  defaultTimeout: 60000,
+});
+```
+
+#### Security Features
+
+**Path Sandboxing:**
+```typescript
+const { tools } = createBuiltInTools({
+  workingDirectory: '/project',
+  tools: ['Read', 'Write'],
+  allowedPaths: ['/project/src', '/project/tests'],
+  // File tools will reject paths outside these directories
+});
+```
+
+**Command Blocking:**
+```typescript
+const { tools } = createBuiltInTools({
+  workingDirectory: '/project',
+  tools: ['Bash'],
+  blockedCommands: [
+    /rm\s+(-rf?|--recursive)/i,
+    /sudo\s+/i,
+    /curl.*\|\s*bash/i,
+  ],
+  // Bash tool will reject commands matching these patterns
+});
+```
+
+#### Task Tool with Agent Factory
+
+The Task tool requires an agent factory to launch sub-agents:
+
+```typescript
+import { createAgent, createBuiltInTools } from 'concevent-ai-agent-sdk';
+
+const { tools } = createBuiltInTools({
+  workingDirectory: '/project',
+  agentFactory: async (config) => {
+    // Create a sub-agent for the task
+    const subAgent = createAgent({
+      apiKey: process.env.OPENROUTER_API_KEY!,
+      model: 'anthropic/claude-3.5-sonnet',
+      systemPrompts: [config.description],
+      tools: [], // Configure tools based on config.allowedTools
+    });
+    
+    const result = await subAgent.chat(config.prompt, {
+      userId: 'task-agent',
+      timezone: 'UTC',
+    });
+    
+    return { message: result.message };
+  },
+});
+```
+
+#### Custom Todo Storage
+
+Implement custom storage for persisting todos:
+
+```typescript
+import type { TodoStorage, TodoItem } from 'concevent-ai-agent-sdk';
+
+const customStorage: TodoStorage = {
+  async getAll(): Promise<TodoItem[]> {
+    // Load from database, file, etc.
+    return JSON.parse(await fs.readFile('todos.json', 'utf-8'));
+  },
+  
+  async save(todos: TodoItem[], merge: boolean): Promise<TodoItem[]> {
+    if (merge) {
+      const existing = await this.getAll();
+      const merged = new Map(existing.map(t => [t.id, t]));
+      todos.forEach(t => merged.set(t.id, t));
+      const all = Array.from(merged.values());
+      await fs.writeFile('todos.json', JSON.stringify(all));
+      return all;
+    }
+    await fs.writeFile('todos.json', JSON.stringify(todos));
+    return todos;
+  },
+  
+  async clear(): Promise<void> {
+    await fs.writeFile('todos.json', '[]');
+  },
+};
+
+const { tools } = createBuiltInTools({
+  workingDirectory: '/project',
+  todoStorage: customStorage,
+});
+```
+
+---
+
 ### Callbacks & Events
 
 The SDK provides a comprehensive callback system for real-time updates during agent execution.
@@ -1790,6 +1999,76 @@ export {
 
 // Timeout error class
 export { ToolExecutionTimeoutError } from "./core/tool-executor";
+
+// Built-in Tools - Factory & Utilities
+export {
+  createBuiltInTools,
+  createBuiltInTool,
+  getBuiltInToolNames,
+  isBuiltInTool,
+  BUILTIN_TOOLS_ALL,
+  BUILTIN_TOOLS_READONLY,
+  BUILTIN_TOOLS_FILE_ONLY,
+  BUILTIN_TOOLS_SHELL_ONLY,
+  TOOL_NAMES,
+} from "./tools";
+
+// Built-in Tools - Individual Creators
+export {
+  createReadTool,
+  createWriteTool,
+  createEditTool,
+  createGlobTool,
+  createGrepTool,
+  createBashTool,
+  createBashOutputTool,
+  createKillBashTool,
+  createTaskTool,
+  createTodoWriteTool,
+  createTodoReadTool,
+} from "./tools";
+
+// Built-in Tools - Types
+export type {
+  BuiltInToolsConfig,
+  BuiltInToolsResult,
+  ToolName,
+  TodoStorage,
+  TodoItem,
+  TodoStatus,
+  ProcessManager,
+  ProcessInfo,
+  AgentFactory,
+  TaskAgentConfig,
+  ShellResult,
+} from "./tools";
+
+// Built-in Tools - Parameter Schemas & Types
+export {
+  readSchema,
+  writeSchema,
+  editSchema,
+  globSchema,
+  grepSchema,
+  bashSchema,
+  bashOutputSchema,
+  killBashSchema,
+  taskSchema,
+  todoWriteSchema,
+} from "./tools";
+
+export type {
+  ReadParams,
+  WriteParams,
+  EditParams,
+  GlobParams,
+  GrepParams,
+  BashParams,
+  BashOutputParams,
+  KillBashParams,
+  TaskParams,
+  TodoWriteParams,
+} from "./tools";
 ```
 
 ---

package/dist/core/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,kBAAkB,EAClB,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAmJlC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CA+HrF"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,kBAAkB,EAClB,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAmJlC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CAmIrF"}

package/dist/core/orchestrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAEjE;;GAEG;AACH,SAAS,mBAAmB,CAAC,KAAY;IACvC,OAAO,mBAAmB,IAAI,KAAK,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CACzB,UAA2B,EAC3B,SAA0B,EAC1B,cAA+B;IAE/B,OAAO;QACL,WAAW,EAAE;YACX,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,oBAAoB,EAAE;gBACpB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,8HAA8H;qBACjI;iBACF;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD,QAAQ,EAAE,KAAK,EACb,IAA6B,EAC7B,OAA4B,EACX,EAAE;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;YAEvC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAE/C,+BAA+B;YAC/B,cAAc,EAAE,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAE3D,gCAAgC;YAChC,SAAS,EAAE,eAAe,EAAE,CAAC;gBAC3B,SAAS,EAAE,UAAU,CAAC,IAAI;gBAC1B,OAAO;aACR,CAAC,CAAC;YAEH,IAAI,CAAC;gBACH,wDAAwD;gBACxD,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAEhC,iEAAiE;gBACjE,MAAM,gBAAgB,GAAmB;oBACvC,yBAAyB;oBACzB,SAAS,EAAE,SAAS,EAAE,SAAS;oBAC/B,yBAAyB;oBACzB,OAAO,EAAE,SAAS,EAAE,OAAO;oBAC3B,4CAA4C;oBAC5C,eAAe,EAAE,CAAC,KAA0B,EAAE,EAAE;wBAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;4BACzB,cAAc,EAAE,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;wBACxE,CAAC;wBACD,SAAS,EAAE,eAAe,EAAE,CAAC,KAAK,CAAC,CAAC;oBACtC,CAAC;oBACD,wCAAwC;oBACxC,YAAY,EAAE,CAAC,MAAsB,EAAE,EAAE;wBACvC,cAAc,EAAE,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;wBACtF,SAAS,EAAE,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC;oBACpC,CAAC;iBACF,CAAC;gBAEF,4BAA4B;gBAC5B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;gBAE/E,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;gBAE5D,uCAAuC;gBACvC,cAAc,EAAE,sBAAsB,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBAExE,mCAAmC;gBACnC,SAAS,EAAE,kBAAkB,EAAE,CAAC;oBAC9B,SAAS,EAAE,UAAU,CAAC,IAAI;oBAC1B,MAAM;iBACP,CAAC,CAAC;gBAEH,6EAA6E;gBAC7E,OAAO,MAAM,CAAC,OAAO,CAAC;YACxB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,cAAc,UAAU,CAAC,IAAI,UAAU,EAAE,KAAK,CAAC,CAAC;gBAC7D,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,KAAK;KACvC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,gCAAgC,CAAC,SAA4B;IACpE,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7F,OAAO;;;;;;;;;;EAUP,SAAS;;;;;;;8EAOmE,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA0B;IAChE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC;IAE3D,mCAAmC;IACnC,KAAK,MAAM,UAAU,IAAI,SAAS,EAAE,CAAC;QACnC,IAAI,mBAAmB,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,UAAU,CAClB,iCAAiC,EACjC,cAAc,UAAU,CAAC,IAAI,6DAA6D,CAC3F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,UAAU,IAAI,SAAS,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,UAAU,CAClB,eAAe,EACf,8BAA8B,UAAU,CAAC,IAAI,4CAA4C,CAC1F,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,yGAAyG;IACzG,sEAAsE;IACtE,IAAI,gBAA4C,CAAC;IACjD,IAAI,qBAAiD,CAAC;IAEtD,+CAA+C;IAC/C,MAAM,aAAa,GAAqB,SAAS,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QACnE,uEAAuE;QACvE,MAAM,WAAW,GAAG,kBAAkB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACzE,OAAO;YACL,GAAG,WAAW;YACd,QAAQ,EAAE,KAAK,EAAE,IAA6B,EAAE,OAA4B,EAAE,EAAE;gBAC9E,yDAAyD;gBACzD,MAAM,eAAe,GAAG,kBAAkB,CACxC,UAAU,EACV,gBAAgB,EAChB,qBAAqB,CACtB,CAAC;gBACF,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,wBAAwB,GAAG,gCAAgC,CAAC,SAAS,CAAC,CAAC;IAE7E,yDAAyD;IACzD,MAAM,qBAAqB,GAAG,CAAC,wBAAwB,EAAE,GAAG,aAAa,CAAC,CAAC;IAE3E,mDAAmD;IACnD,MAAM,eAAe,GAAG,WAAW,CAAC;QAClC,GAAG,UAAU;QACb,aAAa,EAAE,qBAAqB;QACpC,KAAK,EAAE,aAAa;KACrB,CAAC,CAAC;IAEH,wCAAwC;IACxC,MAAM,iBAAiB,GAAsB;QAC3C,KAAK,CAAC,IAAI,CACR,OAAe,EACf,OAA4B,EAC5B,SAA0B;YAE1B,+CAA+C;YAC/C,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;YAE5C,kCAAkC;YAClC,cAAc,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAE1C,0EAA0E;YAC1E,gBAAgB,GAAG,SAAS,CAAC;YAC7B,qBAAqB,GAAG,cAAc,CAAC;YAEvC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;gBAEvE,2CAA2C;gBAC3C,cAAc,CAAC,0BAA0B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAE1D,kDAAkD;gBAClD,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC;gBAEvC,OAAO;oBACL,GAAG,MAAM;oBACT,OAAO;iBACR,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,gBAAgB,GAAG,SAAS,CAAC;gBAC7B,qBAAqB,GAAG,SAAS,CAAC;YACpC,CAAC;QACH,CAAC;QAED,KAAK;YACH,eAAe,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;QAED,UAAU;YACR,OAAO,eAAe,CAAC,UAAU,EAAE,CAAC;QACtC,CAAC;QAED,UAAU,CAAC,OAAsB;YAC/B,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,YAAY;YACV,eAAe,CAAC,YAAY,EAAE,CAAC;QACjC,CAAC;QAED,aAAa;YACX,OAAO,eAAe,CAAC,aAAa,EAAE,CAAC;QACzC,CAAC;QAED,YAAY;YACV,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;QACxB,CAAC;KACF,CAAC;IAEF,0CAA0C;IAC1C,MAAM,CAAC,cAAc,CAAC,iBAAiB,EAAE,mBAAmB,EAAE;QAC5D,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;IAEH,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -8,4 +8,9 @@ export type { AgentErrorCode } from './core/errors.js';
 export type { ReasoningDetail, ChatMessage, FunctionDeclaration, ToolExecutorContext, ToolDefinition, AgentConfig, ParallelExecutionConfig, RetryConfig, TimeoutConfig, UsageMetadata, AgentResult, ToolCallStartData, ToolResultData, AgentCallbacks, AgentEventType, ThinkingEventData, UsageUpdateEventData, RetryEventData, ErrorEventData, CompleteEventData, MessageDeltaEventData, ReasoningDeltaEventData, AgentEvent, ResponseFormatConfig, Middleware, MiddlewareContext, BeforeChatContext, AfterChatContext, BeforeToolCallContext, AfterToolCallContext, ErrorContext, AgentDefinition, OrchestratorConfig, OrchestratorAgent, OrchestratorResult, SubAgentStartData, SubAgentCompleteData, OrchestratorCallbacks, } from './types/index.js';
 export { DEFAULT_TOOL_EXECUTION_TIMEOUT_MS, DEFAULT_API_REQUEST_TIMEOUT_MS, } from './types/index.js';
 export { ToolExecutionTimeoutError } from './core/tool-executor.js';
+export { createBuiltInTools, createBuiltInTool, getBuiltInToolNames, isBuiltInTool, TOOL_NAMES, } from './tools/index.js';
+export { createReadTool, createWriteTool, createEditTool, createGlobTool, createGrepTool, createBashTool, createBashOutputTool, createKillBashTool, createTaskTool, createTodoWriteTool, createTodoReadTool, } from './tools/index.js';
+export type { ToolConfig, BuiltInToolsConfig, BuiltInToolsResult, ToolName, TodoStorage, TodoItem, TodoStatus, ProcessManager, ProcessInfo, AgentFactory, TaskAgentConfig, ShellResult, } from './tools/index.js';
+export { readSchema, writeSchema, editSchema, globSchema, grepSchema, bashSchema, bashOutputSchema, killBashSchema, taskSchema, todoWriteSchema, } from './tools/index.js';
+export type { ReadParams, WriteParams, EditParams, GlobParams, GrepParams, BashParams, BashOutputParams, KillBashParams, TaskParams, TodoWriteParams, } from './tools/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,YAAY,EACV,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,EACV,oBAAoB,EAEpB,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EAEZ,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,YAAY,EACV,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,EACV,oBAAoB,EAEpB,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EAEZ,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAOpE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -5,4 +5,13 @@ export { ENCRYPTED_REASONING_MARKER } from './core/openrouter-utils.js';
 export { AgentError, formatErrorTrace, isAbortError } from './core/errors.js';
 export { DEFAULT_TOOL_EXECUTION_TIMEOUT_MS, DEFAULT_API_REQUEST_TIMEOUT_MS, } from './types/index.js';
 export { ToolExecutionTimeoutError } from './core/tool-executor.js';
+// ============================================================================
+// Built-in Tools
+// ============================================================================
+// Main factory and utilities
+export { createBuiltInTools, createBuiltInTool, getBuiltInToolNames, isBuiltInTool, TOOL_NAMES, } from './tools/index.js';
+// Individual tool creators
+export { createReadTool, createWriteTool, createEditTool, createGlobTool, createGrepTool, createBashTool, createBashOutputTool, createKillBashTool, createTaskTool, createTodoWriteTool, createTodoReadTool, } from './tools/index.js';
+// Parameter schemas for advanced usage
+export { readSchema, writeSchema, editSchema, globSchema, grepSchema, bashSchema, bashOutputSchema, killBashSchema, taskSchema, todoWriteSchema, } from './tools/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA8C9E,OAAO,EACL,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA8C9E,OAAO,EACL,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,6BAA6B;AAC7B,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,2BAA2B;AAC3B,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAkB1B,uCAAuC;AACvC,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/tools/bash-output.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types/index.js';
+import type { ToolConfig, ProcessManager } from './types.js';
+/**
+ * Schema for the BashOutput tool parameters
+ */
+export declare const bashOutputSchema: z.ZodObject<{
+    process_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    process_id: string;
+}, {
+    process_id: string;
+}>;
+export type BashOutputParams = z.infer<typeof bashOutputSchema>;
+/**
+ * Creates the BashOutput tool for retrieving output from background processes
+ */
+export declare function createBashOutputTool(_config?: ToolConfig, processManager?: ProcessManager): ToolDefinition;
+//# sourceMappingURL=bash-output.d.ts.map

package/dist/tools/bash-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-output.d.ts","sourceRoot":"","sources":["../../src/tools/bash-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,UAAe,EACxB,cAAc,CAAC,EAAE,cAAc,GAC9B,cAAc,CAwChB"}

package/dist/tools/bash-output.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * Schema for the BashOutput tool parameters
+ */
+export const bashOutputSchema = z.object({
+    process_id: z.string().describe('The ID of the background process to get output from.'),
+});
+/**
+ * Creates the BashOutput tool for retrieving output from background processes
+ */
+export function createBashOutputTool(_config = {}, processManager) {
+    return {
+        declaration: {
+            name: 'BashOutput',
+            description: `Retrieves the current output from a background bash process.
+Returns the accumulated stdout and stderr, along with process status.
+
+Use this to check on long-running background processes.`,
+            parametersJsonSchema: zodToJsonSchema(bashOutputSchema),
+        },
+        executor: async (args) => {
+            const params = bashOutputSchema.parse(args);
+            if (!processManager) {
+                throw new Error('ProcessManager not available. Background processes are not enabled.');
+            }
+            const process = processManager.get(params.process_id);
+            if (!process) {
+                throw new Error(`Process not found: ${params.process_id}. The process may have been terminated or the ID is invalid.`);
+            }
+            return {
+                process_id: process.id,
+                command: process.command,
+                running: process.running,
+                exit_code: process.exitCode,
+                stdout: process.stdout,
+                stderr: process.stderr,
+                started_at: process.startTime.toISOString(),
+                message: process.running
+                    ? `Process ${process.id} is still running`
+                    : `Process ${process.id} has completed with exit code ${process.exitCode}`,
+            };
+        },
+        parallel: true, // Reading output is safe to do in parallel
+    };
+}
+//# sourceMappingURL=bash-output.js.map

package/dist/tools/bash-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-output.js","sourceRoot":"","sources":["../../src/tools/bash-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAIrD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;CACxF,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAsB,EAAE,EACxB,cAA+B;IAE/B,OAAO;QACL,WAAW,EAAE;YACX,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE;;;wDAGqC;YAClD,oBAAoB,EAAE,eAAe,CAAC,gBAAgB,CAAC;SACxD;QACD,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAE5C,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;YACzF,CAAC;YAED,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAEtD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,sBAAsB,MAAM,CAAC,UAAU,8DAA8D,CACtG,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,UAAU,EAAE,OAAO,CAAC,EAAE;gBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,SAAS,EAAE,OAAO,CAAC,QAAQ;gBAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE;gBAC3C,OAAO,EAAE,OAAO,CAAC,OAAO;oBACtB,CAAC,CAAC,WAAW,OAAO,CAAC,EAAE,mBAAmB;oBAC1C,CAAC,CAAC,WAAW,OAAO,CAAC,EAAE,iCAAiC,OAAO,CAAC,QAAQ,EAAE;aAC7E,CAAC;QACJ,CAAC;QACD,QAAQ,EAAE,IAAI,EAAE,2CAA2C;KAC5D,CAAC;AACJ,CAAC"}

package/dist/tools/bash.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types/index.js';
+import type { ToolConfig, ProcessManager } from './types.js';
+/**
+ * Schema for the Bash tool parameters
+ */
+export declare const bashSchema: z.ZodObject<{
+    command: z.ZodString;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    cwd?: string | undefined;
+    timeout_ms?: number | undefined;
+}, {
+    command: string;
+    cwd?: string | undefined;
+    timeout_ms?: number | undefined;
+}>;
+export type BashParams = z.infer<typeof bashSchema>;
+/**
+ * Creates the Bash tool for executing shell commands
+ */
+export declare function createBashTool(config?: ToolConfig, _processManager?: ProcessManager): ToolDefinition;
+//# sourceMappingURL=bash.d.ts.map

package/dist/tools/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI7D;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;EAUrB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,GAAE,UAAe,EACvB,eAAe,CAAC,EAAE,cAAc,GAC/B,cAAc,CA8DhB"}

package/dist/tools/bash.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { executeCommand, isCommandBlocked, DEFAULT_BLOCKED_COMMANDS } from './utils/shell.js';
+import { resolvePath, isPathAllowed } from './utils/path.js';
+/**
+ * Schema for the Bash tool parameters
+ */
+export const bashSchema = z.object({
+    command: z.string().describe('The shell command to execute.'),
+    timeout_ms: z
+        .number()
+        .optional()
+        .describe('Timeout in milliseconds. Defaults to 30000 (30 seconds). Set to 0 for no timeout.'),
+    cwd: z
+        .string()
+        .optional()
+        .describe('Working directory for the command. Defaults to the configured working directory.'),
+});
+/**
+ * Creates the Bash tool for executing shell commands
+ */
+export function createBashTool(config = {}, _processManager) {
+    const workingDirectory = config.workingDirectory || process.cwd();
+    const defaultTimeout = config.defaultTimeout ?? 30000;
+    const blockedPatterns = config.blockedCommands ?? DEFAULT_BLOCKED_COMMANDS;
+    return {
+        declaration: {
+            name: 'Bash',
+            description: `Executes a shell command and returns the output.
+Uses the system's default shell (bash on Unix, cmd on Windows).
+
+Returns stdout, stderr, and exit code.
+Commands have a default timeout of 30 seconds.
+
+SECURITY: Certain dangerous commands are blocked by default.`,
+            parametersJsonSchema: zodToJsonSchema(bashSchema),
+        },
+        executor: async (args, context) => {
+            const params = bashSchema.parse(args);
+            // Security check: block dangerous commands
+            const blockReason = isCommandBlocked(params.command, blockedPatterns);
+            if (blockReason) {
+                throw new Error(blockReason);
+            }
+            // Resolve working directory
+            const cwd = params.cwd ? resolvePath(params.cwd, workingDirectory) : workingDirectory;
+            // Security check for cwd
+            if (params.cwd && !isPathAllowed(cwd, config.allowedPaths)) {
+                throw new Error(`Access denied: working directory ${params.cwd} is outside allowed paths`);
+            }
+            const timeout = params.timeout_ms ?? defaultTimeout;
+            try {
+                const result = await executeCommand(params.command, {
+                    cwd,
+                    timeout,
+                    abortSignal: context.abortSignal,
+                });
+                return {
+                    command: params.command,
+                    stdout: result.stdout,
+                    stderr: result.stderr,
+                    exit_code: result.exitCode,
+                    timed_out: result.timedOut ?? false,
+                    success: result.exitCode === 0,
+                    message: result.timedOut
+                        ? `Command timed out after ${timeout}ms`
+                        : result.exitCode === 0
+                            ? 'Command completed successfully'
+                            : `Command failed with exit code ${result.exitCode}`,
+                };
+            }
+            catch (error) {
+                throw new Error(`Failed to execute command: ${error.message}`);
+            }
+        },
+        parallel: false, // Shell commands should be sequential to avoid race conditions
+    };
+}
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC7D,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mFAAmF,CAAC;IAChG,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kFAAkF,CAAC;CAChG,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAqB,EAAE,EACvB,eAAgC;IAEhC,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAClE,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,KAAK,CAAC;IACtD,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,wBAAwB,CAAC;IAE3E,OAAO;QACL,WAAW,EAAE;YACX,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE;;;;;;6DAM0C;YACvD,oBAAoB,EAAE,eAAe,CAAC,UAAU,CAAC;SAClD;QACD,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,OAA4B,EAAE,EAAE;YACrD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEtC,2CAA2C;YAC3C,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YACtE,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;YAC/B,CAAC;YAED,4BAA4B;YAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAEtF,yBAAyB;YACzB,IAAI,MAAM,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,GAAG,2BAA2B,CAAC,CAAC;YAC7F,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,IAAI,cAAc,CAAC;YAEpD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE;oBAClD,GAAG;oBACH,OAAO;oBACP,WAAW,EAAE,OAAO,CAAC,WAAW;iBACjC,CAAC,CAAC;gBAEH,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,SAAS,EAAE,MAAM,CAAC,QAAQ;oBAC1B,SAAS,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;oBACnC,OAAO,EAAE,MAAM,CAAC,QAAQ,KAAK,CAAC;oBAC9B,OAAO,EAAE,MAAM,CAAC,QAAQ;wBACtB,CAAC,CAAC,2BAA2B,OAAO,IAAI;wBACxC,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,CAAC;4BACrB,CAAC,CAAC,gCAAgC;4BAClC,CAAC,CAAC,iCAAiC,MAAM,CAAC,QAAQ,EAAE;iBACzD,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,8BAA+B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,+DAA+D;KACjF,CAAC;AACJ,CAAC"}

package/dist/tools/edit.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types/index.js';
+import type { ToolConfig } from './types.js';
+/**
+ * Schema for the Edit tool parameters
+ */
+export declare const editSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    old_string: z.ZodString;
+    new_string: z.ZodString;
+    replace_all: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all: boolean;
+}, {
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
+}>;
+export type EditParams = z.infer<typeof editSchema>;
+/**
+ * Creates the Edit tool for targeted string replacement in files
+ */
+export declare function createEditTool(config?: ToolConfig): ToolDefinition;
+//# sourceMappingURL=edit.d.ts.map

package/dist/tools/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;EAiBrB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,UAAe,GAAG,cAAc,CAqFtE"}