concevent-ai-agent-sdk 2.2.0 → 2.3.0

package/dist/tools/index.js

@@ -0,0 +1,141 @@
+import { TOOL_NAMES } from './types.js';
+import { createProcessManagerWithInternal } from './utils/shell.js';
+// Export individual tool creators
+export { createReadTool } from './read.js';
+export { createWriteTool } from './write.js';
+export { createEditTool } from './edit.js';
+export { createGlobTool } from './glob.js';
+export { createGrepTool } from './grep.js';
+export { createBashTool } from './bash.js';
+export { createBashOutputTool } from './bash-output.js';
+export { createKillBashTool } from './kill-bash.js';
+export { createTaskTool } from './task.js';
+export { createTodoWriteTool, createTodoReadTool } from './todo-write.js';
+export { TOOL_NAMES } from './types.js';
+// Export schemas for consumers who want to validate parameters
+export { readSchema } from './read.js';
+export { writeSchema } from './write.js';
+export { editSchema } from './edit.js';
+export { globSchema } from './glob.js';
+export { grepSchema } from './grep.js';
+export { bashSchema } from './bash.js';
+export { bashOutputSchema } from './bash-output.js';
+export { killBashSchema } from './kill-bash.js';
+export { taskSchema } from './task.js';
+export { todoWriteSchema } from './todo-write.js';
+// Import tool creators for factory
+import { createReadTool } from './read.js';
+import { createWriteTool } from './write.js';
+import { createEditTool } from './edit.js';
+import { createGlobTool } from './glob.js';
+import { createGrepTool } from './grep.js';
+import { createBashTool } from './bash.js';
+import { createBashOutputTool } from './bash-output.js';
+import { createKillBashTool } from './kill-bash.js';
+import { createTaskTool } from './task.js';
+import { createTodoWriteTool } from './todo-write.js';
+const TOOL_CREATORS = {
+    [TOOL_NAMES.READ]: createReadTool,
+    [TOOL_NAMES.WRITE]: createWriteTool,
+    [TOOL_NAMES.EDIT]: createEditTool,
+    [TOOL_NAMES.GLOB]: createGlobTool,
+    [TOOL_NAMES.GREP]: createGrepTool,
+    [TOOL_NAMES.BASH]: createBashTool,
+    [TOOL_NAMES.BASH_OUTPUT]: createBashOutputTool,
+    [TOOL_NAMES.KILL_BASH]: createKillBashTool,
+    [TOOL_NAMES.TASK]: createTaskTool,
+    [TOOL_NAMES.TODO_WRITE]: createTodoWriteTool,
+};
+/**
+ * Creates an array of built-in tools based on configuration.
+ * You must explicitly specify which tools you need using the `tools` property.
+ * Tool names are strongly typed with autocomplete support.
+ *
+ * @example
+ * ```typescript
+ * import { createBuiltInTools } from 'concevent-ai-agent-sdk';
+ *
+ * // Specify exactly which tools you need
+ * const { tools, cleanup } = createBuiltInTools({
+ *   workingDirectory: '/project',
+ *   tools: ['Read', 'Write', 'Glob'],
+ * });
+ *
+ * // For shell tools
+ * const { tools: shellTools } = createBuiltInTools({
+ *   workingDirectory: '/project',
+ *   tools: ['Bash'],
+ *   defaultTimeout: 60000,
+ * });
+ *
+ * // Don't forget to cleanup when done
+ * process.on('exit', () => cleanup());
+ * ```
+ */
+export function createBuiltInTools(config) {
+    const requestedTools = config.tools;
+    if (!requestedTools || requestedTools.length === 0) {
+        throw new Error('You must specify which tools to include using the `tools` property. ' +
+            `Available tools: ${Object.keys(TOOL_CREATORS).join(', ')}`);
+    }
+    // Validate that Task tool has agentFactory if requested
+    if (requestedTools.includes(TOOL_NAMES.TASK) && !config.agentFactory) {
+        throw new Error('The Task tool requires an agentFactory to be provided in the configuration.');
+    }
+    // Create process manager for shell tools
+    const processManager = createProcessManagerWithInternal();
+    // Create tools
+    const tools = [];
+    const unknownTools = [];
+    for (const name of requestedTools) {
+        const creator = TOOL_CREATORS[name];
+        if (creator) {
+            tools.push(creator(config, processManager));
+        }
+        else {
+            unknownTools.push(name);
+        }
+    }
+    if (unknownTools.length > 0) {
+        throw new Error(`Unknown tool(s): ${unknownTools.join(', ')}. ` +
+            `Available tools: ${Object.keys(TOOL_CREATORS).join(', ')}`);
+    }
+    return {
+        tools,
+        processManager,
+        cleanup: () => processManager.cleanup(),
+    };
+}
+/**
+ * Creates a single built-in tool by name.
+ * Tool names are strongly typed with autocomplete support.
+ *
+ * @example
+ * ```typescript
+ * import { createBuiltInTool } from 'concevent-ai-agent-sdk';
+ *
+ * const readTool = createBuiltInTool('Read', {
+ *   workingDirectory: '/project'
+ * });
+ * ```
+ */
+export function createBuiltInTool(name, config = {}, processManager) {
+    const creator = TOOL_CREATORS[name];
+    if (!creator) {
+        throw new Error(`Unknown built-in tool: ${name}. Available tools: ${Object.keys(TOOL_CREATORS).join(', ')}`);
+    }
+    return creator(config, processManager);
+}
+/**
+ * Gets the names of all available built-in tools.
+ */
+export function getBuiltInToolNames() {
+    return Object.keys(TOOL_CREATORS);
+}
+/**
+ * Checks if a tool name is a built-in tool.
+ */
+export function isBuiltInTool(name) {
+    return name in TOOL_CREATORS;
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/kill-bash.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 KillBash tool parameters
+ */
+export declare const killBashSchema: z.ZodObject<{
+    process_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    process_id: string;
+}, {
+    process_id: string;
+}>;
+export type KillBashParams = z.infer<typeof killBashSchema>;
+/**
+ * Creates the KillBash tool for terminating background processes
+ */
+export declare function createKillBashTool(_config?: ToolConfig, processManager?: ProcessManager): ToolDefinition;
+//# sourceMappingURL=kill-bash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kill-bash.d.ts","sourceRoot":"","sources":["../../src/tools/kill-bash.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,cAAc;;;;;;EAEzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,UAAe,EACxB,cAAc,CAAC,EAAE,cAAc,GAC9B,cAAc,CA4ChB"}

package/dist/tools/kill-bash.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * Schema for the KillBash tool parameters
+ */
+export const killBashSchema = z.object({
+    process_id: z.string().describe('The ID of the background process to terminate.'),
+});
+/**
+ * Creates the KillBash tool for terminating background processes
+ */
+export function createKillBashTool(_config = {}, processManager) {
+    return {
+        declaration: {
+            name: 'KillBash',
+            description: `Terminates a running background bash process.
+First sends SIGTERM for graceful shutdown, then SIGKILL if needed.
+
+The process will be removed from the process list after termination.`,
+            parametersJsonSchema: zodToJsonSchema(killBashSchema),
+        },
+        executor: async (args) => {
+            const params = killBashSchema.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 already been terminated or the ID is invalid.`);
+            }
+            const wasRunning = process.running;
+            const killed = await processManager.kill(params.process_id);
+            if (!killed) {
+                throw new Error(`Failed to terminate process ${params.process_id}`);
+            }
+            return {
+                process_id: params.process_id,
+                command: process.command,
+                was_running: wasRunning,
+                success: true,
+                message: wasRunning
+                    ? `Successfully terminated running process ${params.process_id}`
+                    : `Process ${params.process_id} was already completed, removed from list`,
+            };
+        },
+        parallel: false, // Killing processes should be sequential to avoid race conditions
+    };
+}
+//# sourceMappingURL=kill-bash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kill-bash.js","sourceRoot":"","sources":["../../src/tools/kill-bash.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,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAClF,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAsB,EAAE,EACxB,cAA+B;IAE/B,OAAO;QACL,WAAW,EAAE;YACX,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE;;;qEAGkD;YAC/D,oBAAoB,EAAE,eAAe,CAAC,cAAc,CAAC;SACtD;QACD,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAE1C,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,sEAAsE,CAC9G,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAE5D,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACtE,CAAC;YAED,OAAO;gBACL,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,WAAW,EAAE,UAAU;gBACvB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,UAAU;oBACjB,CAAC,CAAC,2CAA2C,MAAM,CAAC,UAAU,EAAE;oBAChE,CAAC,CAAC,WAAW,MAAM,CAAC,UAAU,2CAA2C;aAC5E,CAAC;QACJ,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,kEAAkE;KACpF,CAAC;AACJ,CAAC"}

package/dist/tools/read.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types/index.js';
+import type { ToolConfig } from './types.js';
+/**
+ * Schema for the Read tool parameters
+ */
+export declare const readSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    file_path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, {
+    file_path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>;
+export type ReadParams = z.infer<typeof readSchema>;
+/**
+ * Creates the Read tool for reading file contents
+ */
+export declare function createReadTool(config?: ToolConfig): ToolDefinition;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.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;;;;;;;;;;;;EAcrB,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,CAyFtE"}

package/dist/tools/read.js

@@ -0,0 +1,103 @@
+import * as fs from 'fs/promises';
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { resolvePath, isPathAllowed, isPathSafe } from './utils/path.js';
+/**
+ * Schema for the Read tool parameters
+ */
+export const readSchema = z.object({
+    file_path: z
+        .string()
+        .describe('The path to the file to read. Can be absolute or relative to working directory.'),
+    offset: z
+        .number()
+        .optional()
+        .describe('Line number to start reading from (1-based). If not provided, starts from the beginning.'),
+    limit: z
+        .number()
+        .optional()
+        .describe('Maximum number of lines to read. If not provided, reads the entire file.'),
+});
+/**
+ * Creates the Read tool for reading file contents
+ */
+export function createReadTool(config = {}) {
+    const workingDirectory = config.workingDirectory || process.cwd();
+    return {
+        declaration: {
+            name: 'Read',
+            description: `Reads the contents of a file. Returns the file content with line numbers.
+If offset and limit are provided, reads only the specified range of lines.
+Line numbers in output are 1-based and formatted as "LINE_NUMBER|LINE_CONTENT".`,
+            parametersJsonSchema: zodToJsonSchema(readSchema),
+        },
+        executor: async (args) => {
+            const params = readSchema.parse(args);
+            const resolvedPath = resolvePath(params.file_path, workingDirectory);
+            // Security checks
+            if (!isPathSafe(params.file_path, workingDirectory)) {
+                throw new Error(`Path traversal detected: ${params.file_path}`);
+            }
+            if (!isPathAllowed(resolvedPath, config.allowedPaths)) {
+                throw new Error(`Access denied: ${params.file_path} is outside allowed paths`);
+            }
+            // Check if file exists
+            try {
+                const stat = await fs.stat(resolvedPath);
+                if (!stat.isFile()) {
+                    throw new Error(`Not a file: ${params.file_path}`);
+                }
+            }
+            catch (error) {
+                if (error.code === 'ENOENT') {
+                    throw new Error(`File not found: ${params.file_path}`);
+                }
+                throw error;
+            }
+            // Read file contents
+            const content = await fs.readFile(resolvedPath, 'utf-8');
+            // Handle empty files
+            if (content.length === 0) {
+                return {
+                    file_path: params.file_path,
+                    content: '',
+                    message: 'File is empty.',
+                    total_lines: 0,
+                };
+            }
+            const lines = content.split('\n');
+            const totalLines = lines.length;
+            // Apply offset and limit
+            const startLine = params.offset ? Math.max(1, params.offset) : 1;
+            const endLine = params.limit
+                ? Math.min(totalLines, startLine + params.limit - 1)
+                : totalLines;
+            // Format lines with line numbers (1-based, right-aligned to 6 chars)
+            const outputLines = [];
+            for (let i = startLine - 1; i < endLine; i++) {
+                const lineNum = (i + 1).toString().padStart(6, ' ');
+                outputLines.push(`${lineNum}|${lines[i]}`);
+            }
+            const result = {
+                file_path: params.file_path,
+                content: outputLines.join('\n'),
+                total_lines: totalLines,
+                lines_shown: {
+                    start: startLine,
+                    end: endLine,
+                    count: endLine - startLine + 1,
+                },
+            };
+            // Add note if not showing all lines
+            if (startLine > 1 || endLine < totalLines) {
+                return {
+                    ...result,
+                    note: `Showing lines ${startLine}-${endLine} of ${totalLines} total lines.`,
+                };
+            }
+            return result;
+        },
+        parallel: true, // Reading is safe to do in parallel
+    };
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"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"}

package/dist/tools/task.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types/index.js';
+import type { ToolConfig } from './types.js';
+/**
+ * Schema for the Task tool parameters
+ */
+export declare const taskSchema: z.ZodObject<{
+    description: z.ZodString;
+    prompt: z.ZodString;
+    allowed_tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    prompt: string;
+    allowed_tools?: string[] | undefined;
+}, {
+    description: string;
+    prompt: string;
+    allowed_tools?: string[] | undefined;
+}>;
+export type TaskParams = z.infer<typeof taskSchema>;
+/**
+ * Creates the Task tool for launching sub-agents
+ */
+export declare function createTaskTool(config?: ToolConfig): ToolDefinition;
+//# sourceMappingURL=task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/tools/task.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,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;EASrB,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,CA2DtE"}

package/dist/tools/task.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * Schema for the Task tool parameters
+ */
+export const taskSchema = z.object({
+    description: z.string().describe('A clear description of what this sub-task should accomplish.'),
+    prompt: z.string().describe('The prompt/instructions for the sub-agent to execute.'),
+    allowed_tools: z
+        .array(z.string())
+        .optional()
+        .describe('List of tool names the sub-agent is allowed to use. If not specified, the sub-agent may use all available tools.'),
+});
+/**
+ * Creates the Task tool for launching sub-agents
+ */
+export function createTaskTool(config = {}) {
+    return {
+        declaration: {
+            name: 'Task',
+            description: `Launches a new sub-agent to handle a specific task.
+The sub-agent operates independently and returns its result when complete.
+
+Use this to:
+- Break down complex tasks into smaller, focused sub-tasks
+- Delegate specialized work to agents with specific tool access
+- Run tasks that require different tool permissions
+
+The sub-agent inherits the current context but operates in isolation.`,
+            parametersJsonSchema: zodToJsonSchema(taskSchema),
+        },
+        executor: async (args, context) => {
+            const params = taskSchema.parse(args);
+            if (!config.agentFactory) {
+                throw new Error('Task tool is not available: No agent factory configured. ' +
+                    'To use the Task tool, provide an agentFactory in the BuiltInToolsConfig.');
+            }
+            // Check if aborted before starting
+            if (context.abortSignal?.aborted) {
+                throw new Error('Task cancelled: operation was aborted');
+            }
+            try {
+                const result = await config.agentFactory({
+                    description: params.description,
+                    prompt: params.prompt,
+                    allowedTools: params.allowed_tools,
+                });
+                return {
+                    success: true,
+                    description: params.description,
+                    result: result.message,
+                    message: 'Sub-task completed successfully',
+                };
+            }
+            catch (error) {
+                // Re-throw abort errors
+                if (error.name === 'AbortError' || error.message.includes('abort')) {
+                    throw error;
+                }
+                return {
+                    success: false,
+                    description: params.description,
+                    error: error.message,
+                    message: `Sub-task failed: ${error.message}`,
+                };
+            }
+        },
+        parallel: false, // Sub-agents should run sequentially
+    };
+}
+//# sourceMappingURL=task.js.map

package/dist/tools/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/tools/task.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,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IAChG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IACpF,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,kHAAkH,CACnH;CACJ,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAqB,EAAE;IACpD,OAAO;QACL,WAAW,EAAE;YACX,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE;;;;;;;;sEAQmD;YAChE,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,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACb,2DAA2D;oBACzD,0EAA0E,CAC7E,CAAC;YACJ,CAAC;YAED,mCAAmC;YACnC,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAC3D,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;oBACvC,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,YAAY,EAAE,MAAM,CAAC,aAAa;iBACnC,CAAC,CAAC;gBAEH,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,MAAM,EAAE,MAAM,CAAC,OAAO;oBACtB,OAAO,EAAE,iCAAiC;iBAC3C,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,wBAAwB;gBACxB,IAAK,KAAe,CAAC,IAAI,KAAK,YAAY,IAAK,KAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBACzF,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,KAAK,EAAG,KAAe,CAAC,OAAO;oBAC/B,OAAO,EAAE,oBAAqB,KAAe,CAAC,OAAO,EAAE;iBACxD,CAAC;YACJ,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,qCAAqC;KACvD,CAAC;AACJ,CAAC"}

package/dist/tools/todo-write.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types/index.js';
+import type { ToolConfig } from './types.js';
+/**
+ * Schema for the TodoWrite tool parameters
+ */
+export declare const todoWriteSchema: z.ZodObject<{
+    todos: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        content: z.ZodString;
+        status: z.ZodEnum<["pending", "in_progress", "completed", "cancelled"]>;
+    }, "strip", z.ZodTypeAny, {
+        status: "pending" | "in_progress" | "completed" | "cancelled";
+        id: string;
+        content: string;
+    }, {
+        status: "pending" | "in_progress" | "completed" | "cancelled";
+        id: string;
+        content: string;
+    }>, "many">;
+    merge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    todos: {
+        status: "pending" | "in_progress" | "completed" | "cancelled";
+        id: string;
+        content: string;
+    }[];
+    merge: boolean;
+}, {
+    todos: {
+        status: "pending" | "in_progress" | "completed" | "cancelled";
+        id: string;
+        content: string;
+    }[];
+    merge?: boolean | undefined;
+}>;
+export type TodoWriteParams = z.infer<typeof todoWriteSchema>;
+/**
+ * Creates the TodoWrite tool for managing todo items
+ */
+export declare function createTodoWriteTool(config?: ToolConfig): ToolDefinition;
+/**
+ * Creates a TodoRead tool for reading current todos (bonus utility)
+ */
+export declare function createTodoReadTool(config?: ToolConfig): ToolDefinition;
+//# sourceMappingURL=todo-write.d.ts.map

package/dist/tools/todo-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-write.d.ts","sourceRoot":"","sources":["../../src/tools/todo-write.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,EAAqC,MAAM,YAAY,CAAC;AAahF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAuC9D;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,UAAe,GAAG,cAAc,CA+D3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,UAAe,GAAG,cAAc,CAmC1E"}