claude-flow-novice 2.5.2 → 2.8.1

package/dist/cli/iteration-history.js

@@ -0,0 +1,188 @@
+/**
+ * Iteration History Management
+ *
+ * Loads and formats iteration history from Redis for CLI-spawned agents.
+ * Enables agents to learn from previous attempts and feedback.
+ *
+ * Storage Pattern:
+ *   swarm:${TASK_ID}:${AGENT_ID}:result:iteration-${N} → Result text + confidence
+ *   swarm:${TASK_ID}:${AGENT_ID}:feedback:iteration-${N} → Validator feedback
+ *
+ * Sprint 3 - Phase 2 Implementation
+ */ import { execSync } from 'child_process';
+/**
+ * Load iteration history for an agent from Redis
+ *
+ * @param taskId - Task identifier
+ * @param agentId - Agent identifier
+ * @param currentIteration - Current iteration number (loads 1 to N-1)
+ * @returns Array of iteration results
+ */ export async function loadIterationHistory(taskId, agentId, currentIteration) {
+    const history = [];
+    // Load previous iterations (1 to currentIteration - 1)
+    for(let i = 1; i < currentIteration; i++){
+        try {
+            // Load result data
+            const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${i}`;
+            const resultJson = execSync(`redis-cli get "${resultKey}"`, {
+                encoding: 'utf8'
+            }).trim();
+            if (resultJson === '(nil)' || !resultJson) {
+                continue;
+            }
+            const resultData = JSON.parse(resultJson);
+            // Load feedback data (may not exist for all iterations)
+            const feedbackKey = `swarm:${taskId}:${agentId}:feedback:iteration-${i}`;
+            let feedback;
+            try {
+                const feedbackJson = execSync(`redis-cli get "${feedbackKey}"`, {
+                    encoding: 'utf8'
+                }).trim();
+                if (feedbackJson !== '(nil)' && feedbackJson) {
+                    const feedbackData = JSON.parse(feedbackJson);
+                    feedback = feedbackData.feedback || feedbackData.comments;
+                }
+            } catch (err) {
+                // Feedback may not exist for this iteration
+                feedback = undefined;
+            }
+            history.push({
+                iteration: i,
+                result: resultData.result || resultData.output || '',
+                confidence: resultData.confidence || 0,
+                timestamp: resultData.timestamp || new Date().toISOString(),
+                feedback
+            });
+        } catch (err) {
+            console.error(`[iteration-history] Failed to load iteration ${i}:`, err);
+        // Continue loading other iterations
+        }
+    }
+    return history;
+}
+/**
+ * Store iteration result in Redis
+ *
+ * @param taskId - Task identifier
+ * @param agentId - Agent identifier
+ * @param iteration - Iteration number
+ * @param result - Result text/output
+ * @param confidence - Confidence score (0.0-1.0)
+ */ export async function storeIterationResult(taskId, agentId, iteration, result, confidence) {
+    const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${iteration}`;
+    const resultData = {
+        result,
+        confidence,
+        timestamp: new Date().toISOString(),
+        iteration
+    };
+    const resultJson = JSON.stringify(resultData);
+    try {
+        // Store with 24 hour TTL
+        execSync(`redis-cli setex "${resultKey}" 86400 '${resultJson.replace(/'/g, "'\\''")}'`, {
+            encoding: 'utf8'
+        });
+        console.log(`[iteration-history] Stored result for iteration ${iteration}`);
+    } catch (err) {
+        console.error(`[iteration-history] Failed to store result:`, err);
+        throw err;
+    }
+}
+/**
+ * Format iteration history as markdown for system prompt
+ *
+ * @param history - Array of iteration results
+ * @param currentIteration - Current iteration number
+ * @returns Formatted markdown string
+ */ export function formatIterationHistory(history, currentIteration) {
+    if (history.length === 0) {
+        return `## Current Iteration: ${currentIteration}
+
+This is your first attempt at this task. No previous iteration history available.
+`;
+    }
+    const sections = [];
+    sections.push('## Iteration History');
+    sections.push('');
+    sections.push('Learn from your previous attempts and feedback:');
+    sections.push('');
+    // Format each iteration
+    for (const iter of history){
+        sections.push(`### Iteration ${iter.iteration}`);
+        sections.push('');
+        sections.push('**Result:**');
+        sections.push(iter.result.substring(0, 500)); // Truncate to 500 chars
+        if (iter.result.length > 500) {
+            sections.push('... (truncated)');
+        }
+        sections.push('');
+        if (iter.feedback) {
+            sections.push('**Feedback from Validators:**');
+            sections.push(iter.feedback);
+            sections.push('');
+        }
+        sections.push(`**Confidence:** ${iter.confidence.toFixed(2)}`);
+        sections.push(`**Timestamp:** ${iter.timestamp}`);
+        sections.push('');
+        sections.push('---');
+        sections.push('');
+    }
+    // Add current iteration context
+    sections.push(`## Current Iteration: ${currentIteration}`);
+    sections.push('');
+    if (history.length > 0) {
+        const lastIteration = history[history.length - 1];
+        if (lastIteration.feedback) {
+            sections.push('**Your Task:** Address the feedback from the previous iteration:');
+            sections.push('');
+            sections.push(lastIteration.feedback);
+            sections.push('');
+        } else {
+            sections.push(`**Your Task:** Improve upon iteration ${lastIteration.iteration} (confidence: ${lastIteration.confidence.toFixed(2)})`);
+            sections.push('');
+        }
+    }
+    return sections.join('\n');
+}
+/**
+ * Check if iteration history exists for an agent
+ *
+ * @param taskId - Task identifier
+ * @param agentId - Agent identifier
+ * @returns True if any iteration history exists
+ */ export async function hasIterationHistory(taskId, agentId) {
+    try {
+        const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;
+        const keys = execSync(`redis-cli --scan --pattern "${pattern}"`, {
+            encoding: 'utf8'
+        }).trim();
+        return keys.length > 0;
+    } catch (err) {
+        return false;
+    }
+}
+/**
+ * Get the latest iteration number for an agent
+ *
+ * @param taskId - Task identifier
+ * @param agentId - Agent identifier
+ * @returns Latest iteration number (0 if no history)
+ */ export async function getLatestIteration(taskId, agentId) {
+    try {
+        const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;
+        const keys = execSync(`redis-cli --scan --pattern "${pattern}"`, {
+            encoding: 'utf8'
+        }).trim().split('\n').filter((k)=>k.length > 0);
+        if (keys.length === 0) return 0;
+        // Extract iteration numbers and find max
+        const iterations = keys.map((key)=>{
+            const match = key.match(/iteration-(\d+)$/);
+            return match ? parseInt(match[1], 10) : 0;
+        });
+        return Math.max(...iterations);
+    } catch (err) {
+        return 0;
+    }
+}
+
+//# sourceMappingURL=iteration-history.js.map

package/dist/cli/iteration-history.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/iteration-history.ts"],"sourcesContent":["/**\r\n * Iteration History Management\r\n *\r\n * Loads and formats iteration history from Redis for CLI-spawned agents.\r\n * Enables agents to learn from previous attempts and feedback.\r\n *\r\n * Storage Pattern:\r\n *   swarm:${TASK_ID}:${AGENT_ID}:result:iteration-${N} → Result text + confidence\r\n *   swarm:${TASK_ID}:${AGENT_ID}:feedback:iteration-${N} → Validator feedback\r\n *\r\n * Sprint 3 - Phase 2 Implementation\r\n */\r\n\r\nimport { execSync } from 'child_process';\r\n\r\nexport interface IterationResult {\r\n  iteration: number;\r\n  result: string;\r\n  confidence: number;\r\n  timestamp: string;\r\n  feedback?: string;\r\n}\r\n\r\n/**\r\n * Load iteration history for an agent from Redis\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @param currentIteration - Current iteration number (loads 1 to N-1)\r\n * @returns Array of iteration results\r\n */\r\nexport async function loadIterationHistory(\r\n  taskId: string,\r\n  agentId: string,\r\n  currentIteration: number\r\n): Promise<IterationResult[]> {\r\n  const history: IterationResult[] = [];\r\n\r\n  // Load previous iterations (1 to currentIteration - 1)\r\n  for (let i = 1; i < currentIteration; i++) {\r\n    try {\r\n      // Load result data\r\n      const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${i}`;\r\n      const resultJson = execSync(`redis-cli get \"${resultKey}\"`, { encoding: 'utf8' }).trim();\r\n\r\n      if (resultJson === '(nil)' || !resultJson) {\r\n        // No result for this iteration (shouldn't happen in normal flow)\r\n        continue;\r\n      }\r\n\r\n      const resultData = JSON.parse(resultJson);\r\n\r\n      // Load feedback data (may not exist for all iterations)\r\n      const feedbackKey = `swarm:${taskId}:${agentId}:feedback:iteration-${i}`;\r\n      let feedback: string | undefined;\r\n\r\n      try {\r\n        const feedbackJson = execSync(`redis-cli get \"${feedbackKey}\"`, { encoding: 'utf8' }).trim();\r\n        if (feedbackJson !== '(nil)' && feedbackJson) {\r\n          const feedbackData = JSON.parse(feedbackJson);\r\n          feedback = feedbackData.feedback || feedbackData.comments;\r\n        }\r\n      } catch (err) {\r\n        // Feedback may not exist for this iteration\r\n        feedback = undefined;\r\n      }\r\n\r\n      history.push({\r\n        iteration: i,\r\n        result: resultData.result || resultData.output || '',\r\n        confidence: resultData.confidence || 0,\r\n        timestamp: resultData.timestamp || new Date().toISOString(),\r\n        feedback\r\n      });\r\n    } catch (err) {\r\n      console.error(`[iteration-history] Failed to load iteration ${i}:`, err);\r\n      // Continue loading other iterations\r\n    }\r\n  }\r\n\r\n  return history;\r\n}\r\n\r\n/**\r\n * Store iteration result in Redis\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @param iteration - Iteration number\r\n * @param result - Result text/output\r\n * @param confidence - Confidence score (0.0-1.0)\r\n */\r\nexport async function storeIterationResult(\r\n  taskId: string,\r\n  agentId: string,\r\n  iteration: number,\r\n  result: string,\r\n  confidence: number\r\n): Promise<void> {\r\n  const resultKey = `swarm:${taskId}:${agentId}:result:iteration-${iteration}`;\r\n  const resultData = {\r\n    result,\r\n    confidence,\r\n    timestamp: new Date().toISOString(),\r\n    iteration\r\n  };\r\n\r\n  const resultJson = JSON.stringify(resultData);\r\n\r\n  try {\r\n    // Store with 24 hour TTL\r\n    execSync(`redis-cli setex \"${resultKey}\" 86400 '${resultJson.replace(/'/g, \"'\\\\''\")}'`, {\r\n      encoding: 'utf8'\r\n    });\r\n    console.log(`[iteration-history] Stored result for iteration ${iteration}`);\r\n  } catch (err) {\r\n    console.error(`[iteration-history] Failed to store result:`, err);\r\n    throw err;\r\n  }\r\n}\r\n\r\n/**\r\n * Format iteration history as markdown for system prompt\r\n *\r\n * @param history - Array of iteration results\r\n * @param currentIteration - Current iteration number\r\n * @returns Formatted markdown string\r\n */\r\nexport function formatIterationHistory(\r\n  history: IterationResult[],\r\n  currentIteration: number\r\n): string {\r\n  if (history.length === 0) {\r\n    return `## Current Iteration: ${currentIteration}\r\n\r\nThis is your first attempt at this task. No previous iteration history available.\r\n`;\r\n  }\r\n\r\n  const sections: string[] = [];\r\n\r\n  sections.push('## Iteration History');\r\n  sections.push('');\r\n  sections.push('Learn from your previous attempts and feedback:');\r\n  sections.push('');\r\n\r\n  // Format each iteration\r\n  for (const iter of history) {\r\n    sections.push(`### Iteration ${iter.iteration}`);\r\n    sections.push('');\r\n\r\n    sections.push('**Result:**');\r\n    sections.push(iter.result.substring(0, 500)); // Truncate to 500 chars\r\n    if (iter.result.length > 500) {\r\n      sections.push('... (truncated)');\r\n    }\r\n    sections.push('');\r\n\r\n    if (iter.feedback) {\r\n      sections.push('**Feedback from Validators:**');\r\n      sections.push(iter.feedback);\r\n      sections.push('');\r\n    }\r\n\r\n    sections.push(`**Confidence:** ${iter.confidence.toFixed(2)}`);\r\n    sections.push(`**Timestamp:** ${iter.timestamp}`);\r\n    sections.push('');\r\n    sections.push('---');\r\n    sections.push('');\r\n  }\r\n\r\n  // Add current iteration context\r\n  sections.push(`## Current Iteration: ${currentIteration}`);\r\n  sections.push('');\r\n\r\n  if (history.length > 0) {\r\n    const lastIteration = history[history.length - 1];\r\n    if (lastIteration.feedback) {\r\n      sections.push('**Your Task:** Address the feedback from the previous iteration:');\r\n      sections.push('');\r\n      sections.push(lastIteration.feedback);\r\n      sections.push('');\r\n    } else {\r\n      sections.push(`**Your Task:** Improve upon iteration ${lastIteration.iteration} (confidence: ${lastIteration.confidence.toFixed(2)})`);\r\n      sections.push('');\r\n    }\r\n  }\r\n\r\n  return sections.join('\\n');\r\n}\r\n\r\n/**\r\n * Check if iteration history exists for an agent\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @returns True if any iteration history exists\r\n */\r\nexport async function hasIterationHistory(\r\n  taskId: string,\r\n  agentId: string\r\n): Promise<boolean> {\r\n  try {\r\n    const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;\r\n    const keys = execSync(`redis-cli --scan --pattern \"${pattern}\"`, { encoding: 'utf8' }).trim();\r\n    return keys.length > 0;\r\n  } catch (err) {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Get the latest iteration number for an agent\r\n *\r\n * @param taskId - Task identifier\r\n * @param agentId - Agent identifier\r\n * @returns Latest iteration number (0 if no history)\r\n */\r\nexport async function getLatestIteration(\r\n  taskId: string,\r\n  agentId: string\r\n): Promise<number> {\r\n  try {\r\n    const pattern = `swarm:${taskId}:${agentId}:result:iteration-*`;\r\n    const keys = execSync(`redis-cli --scan --pattern \"${pattern}\"`, { encoding: 'utf8' })\r\n      .trim()\r\n      .split('\\n')\r\n      .filter((k) => k.length > 0);\r\n\r\n    if (keys.length === 0) return 0;\r\n\r\n    // Extract iteration numbers and find max\r\n    const iterations = keys.map((key) => {\r\n      const match = key.match(/iteration-(\\d+)$/);\r\n      return match ? parseInt(match[1], 10) : 0;\r\n    });\r\n\r\n    return Math.max(...iterations);\r\n  } catch (err) {\r\n    return 0;\r\n  }\r\n}\r\n"],"names":["execSync","loadIterationHistory","taskId","agentId","currentIteration","history","i","resultKey","resultJson","encoding","trim","resultData","JSON","parse","feedbackKey","feedback","feedbackJson","feedbackData","comments","err","undefined","push","iteration","result","output","confidence","timestamp","Date","toISOString","console","error","storeIterationResult","stringify","replace","log","formatIterationHistory","length","sections","iter","substring","toFixed","lastIteration","join","hasIterationHistory","pattern","keys","getLatestIteration","split","filter","k","iterations","map","key","match","parseInt","Math","max"],"mappings":"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"}

package/dist/cli/tool-definitions.js

@@ -0,0 +1,263 @@
+/**
+ * Tool Definitions for CLI-Spawned Agents
+ *
+ * Converts agent markdown tool names to Anthropic API tool definitions.
+ * Implements core tools: Read, Write, Edit, Bash, TodoWrite
+ */ /**
+ * Tool registry mapping agent tool names to Anthropic API format
+ */ const TOOL_REGISTRY = {
+    Read: {
+        name: 'Read',
+        description: 'Reads a file from the local filesystem. Can access any file by absolute path.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'The absolute path to the file to read'
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Optional: The number of lines to read (for large files)'
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Optional: The line number to start reading from'
+                }
+            },
+            required: [
+                'file_path'
+            ]
+        }
+    },
+    Write: {
+        name: 'Write',
+        description: 'Writes content to a file. Creates new file or overwrites existing file.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'The absolute path to the file to write (must be absolute, not relative)'
+                },
+                content: {
+                    type: 'string',
+                    description: 'The content to write to the file'
+                }
+            },
+            required: [
+                'file_path',
+                'content'
+            ]
+        }
+    },
+    Edit: {
+        name: 'Edit',
+        description: 'Performs exact string replacement in files. Must read file first before editing.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'The absolute path to the file to modify'
+                },
+                old_string: {
+                    type: 'string',
+                    description: 'The exact text to replace (must be unique in file)'
+                },
+                new_string: {
+                    type: 'string',
+                    description: 'The text to replace it with'
+                },
+                replace_all: {
+                    type: 'boolean',
+                    description: 'Optional: Replace all occurrences (default false)'
+                }
+            },
+            required: [
+                'file_path',
+                'old_string',
+                'new_string'
+            ]
+        }
+    },
+    Bash: {
+        name: 'Bash',
+        description: 'Executes bash commands in a persistent shell session. For terminal operations like git, npm, docker.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                command: {
+                    type: 'string',
+                    description: 'The bash command to execute'
+                },
+                description: {
+                    type: 'string',
+                    description: 'Clear, concise description of what this command does (5-10 words)'
+                },
+                timeout: {
+                    type: 'number',
+                    description: 'Optional timeout in milliseconds (max 600000, default 120000)'
+                },
+                run_in_background: {
+                    type: 'boolean',
+                    description: 'Optional: Run command in background (default false)'
+                }
+            },
+            required: [
+                'command'
+            ]
+        }
+    },
+    TodoWrite: {
+        name: 'TodoWrite',
+        description: 'Creates and manages structured task list for tracking progress.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                todos: {
+                    type: 'array',
+                    description: 'Array of todo items with content, status, and activeForm',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            content: {
+                                type: 'string',
+                                description: 'Task description in imperative form (e.g., "Run tests")'
+                            },
+                            status: {
+                                type: 'string',
+                                enum: [
+                                    'pending',
+                                    'in_progress',
+                                    'completed'
+                                ],
+                                description: 'Task status'
+                            },
+                            activeForm: {
+                                type: 'string',
+                                description: 'Present continuous form shown during execution (e.g., "Running tests")'
+                            }
+                        },
+                        required: [
+                            'content',
+                            'status',
+                            'activeForm'
+                        ]
+                    }
+                }
+            },
+            required: [
+                'todos'
+            ]
+        }
+    },
+    Glob: {
+        name: 'Glob',
+        description: 'Fast file pattern matching. Supports glob patterns like "**/*.js".',
+        input_schema: {
+            type: 'object',
+            properties: {
+                pattern: {
+                    type: 'string',
+                    description: 'The glob pattern to match files against'
+                },
+                path: {
+                    type: 'string',
+                    description: 'Optional: Directory to search in (defaults to current working directory)'
+                }
+            },
+            required: [
+                'pattern'
+            ]
+        }
+    },
+    Grep: {
+        name: 'Grep',
+        description: 'Powerful search tool built on ripgrep. Supports regex patterns.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                pattern: {
+                    type: 'string',
+                    description: 'The regular expression pattern to search for'
+                },
+                path: {
+                    type: 'string',
+                    description: 'Optional: File or directory to search in'
+                },
+                output_mode: {
+                    type: 'string',
+                    enum: [
+                        'content',
+                        'files_with_matches',
+                        'count'
+                    ],
+                    description: 'Output mode (default: files_with_matches)'
+                },
+                glob: {
+                    type: 'string',
+                    description: 'Optional: Glob pattern to filter files'
+                },
+                type: {
+                    type: 'string',
+                    description: 'Optional: File type (js, py, rust, etc.)'
+                },
+                '-i': {
+                    type: 'boolean',
+                    description: 'Case insensitive search'
+                },
+                '-n': {
+                    type: 'boolean',
+                    description: 'Show line numbers (requires output_mode: content)'
+                },
+                '-A': {
+                    type: 'number',
+                    description: 'Lines to show after match (requires output_mode: content)'
+                },
+                '-B': {
+                    type: 'number',
+                    description: 'Lines to show before match (requires output_mode: content)'
+                },
+                '-C': {
+                    type: 'number',
+                    description: 'Lines to show before and after match (requires output_mode: content)'
+                }
+            },
+            required: [
+                'pattern'
+            ]
+        }
+    }
+};
+/**
+ * Convert agent tool names to Anthropic API tool definitions
+ */ export function convertToolNames(toolNames) {
+    const definitions = [];
+    for (const toolName of toolNames){
+        const definition = TOOL_REGISTRY[toolName];
+        if (definition) {
+            definitions.push(definition);
+        } else {
+            console.warn(`[tool-definitions] Unknown tool: ${toolName}`);
+        }
+    }
+    return definitions;
+}
+/**
+ * Get tool definition by name
+ */ export function getToolDefinition(toolName) {
+    return TOOL_REGISTRY[toolName];
+}
+/**
+ * Check if tool name is valid
+ */ export function isValidTool(toolName) {
+    return toolName in TOOL_REGISTRY;
+}
+/**
+ * Get all available tool names
+ */ export function getAvailableTools() {
+    return Object.keys(TOOL_REGISTRY);
+}
+
+//# sourceMappingURL=tool-definitions.js.map

package/dist/cli/tool-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/tool-definitions.ts"],"sourcesContent":["/**\r\n * Tool Definitions for CLI-Spawned Agents\r\n *\r\n * Converts agent markdown tool names to Anthropic API tool definitions.\r\n * Implements core tools: Read, Write, Edit, Bash, TodoWrite\r\n */\r\n\r\nexport interface ToolDefinition {\r\n  name: string;\r\n  description: string;\r\n  input_schema: {\r\n    type: 'object';\r\n    properties: Record<string, any>;\r\n    required: string[];\r\n  };\r\n}\r\n\r\n/**\r\n * Tool registry mapping agent tool names to Anthropic API format\r\n */\r\nconst TOOL_REGISTRY: Record<string, ToolDefinition> = {\r\n  Read: {\r\n    name: 'Read',\r\n    description: 'Reads a file from the local filesystem. Can access any file by absolute path.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        file_path: {\r\n          type: 'string',\r\n          description: 'The absolute path to the file to read'\r\n        },\r\n        limit: {\r\n          type: 'number',\r\n          description: 'Optional: The number of lines to read (for large files)'\r\n        },\r\n        offset: {\r\n          type: 'number',\r\n          description: 'Optional: The line number to start reading from'\r\n        }\r\n      },\r\n      required: ['file_path']\r\n    }\r\n  },\r\n\r\n  Write: {\r\n    name: 'Write',\r\n    description: 'Writes content to a file. Creates new file or overwrites existing file.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        file_path: {\r\n          type: 'string',\r\n          description: 'The absolute path to the file to write (must be absolute, not relative)'\r\n        },\r\n        content: {\r\n          type: 'string',\r\n          description: 'The content to write to the file'\r\n        }\r\n      },\r\n      required: ['file_path', 'content']\r\n    }\r\n  },\r\n\r\n  Edit: {\r\n    name: 'Edit',\r\n    description: 'Performs exact string replacement in files. Must read file first before editing.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        file_path: {\r\n          type: 'string',\r\n          description: 'The absolute path to the file to modify'\r\n        },\r\n        old_string: {\r\n          type: 'string',\r\n          description: 'The exact text to replace (must be unique in file)'\r\n        },\r\n        new_string: {\r\n          type: 'string',\r\n          description: 'The text to replace it with'\r\n        },\r\n        replace_all: {\r\n          type: 'boolean',\r\n          description: 'Optional: Replace all occurrences (default false)'\r\n        }\r\n      },\r\n      required: ['file_path', 'old_string', 'new_string']\r\n    }\r\n  },\r\n\r\n  Bash: {\r\n    name: 'Bash',\r\n    description: 'Executes bash commands in a persistent shell session. For terminal operations like git, npm, docker.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        command: {\r\n          type: 'string',\r\n          description: 'The bash command to execute'\r\n        },\r\n        description: {\r\n          type: 'string',\r\n          description: 'Clear, concise description of what this command does (5-10 words)'\r\n        },\r\n        timeout: {\r\n          type: 'number',\r\n          description: 'Optional timeout in milliseconds (max 600000, default 120000)'\r\n        },\r\n        run_in_background: {\r\n          type: 'boolean',\r\n          description: 'Optional: Run command in background (default false)'\r\n        }\r\n      },\r\n      required: ['command']\r\n    }\r\n  },\r\n\r\n  TodoWrite: {\r\n    name: 'TodoWrite',\r\n    description: 'Creates and manages structured task list for tracking progress.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        todos: {\r\n          type: 'array',\r\n          description: 'Array of todo items with content, status, and activeForm',\r\n          items: {\r\n            type: 'object',\r\n            properties: {\r\n              content: {\r\n                type: 'string',\r\n                description: 'Task description in imperative form (e.g., \"Run tests\")'\r\n              },\r\n              status: {\r\n                type: 'string',\r\n                enum: ['pending', 'in_progress', 'completed'],\r\n                description: 'Task status'\r\n              },\r\n              activeForm: {\r\n                type: 'string',\r\n                description: 'Present continuous form shown during execution (e.g., \"Running tests\")'\r\n              }\r\n            },\r\n            required: ['content', 'status', 'activeForm']\r\n          }\r\n        }\r\n      },\r\n      required: ['todos']\r\n    }\r\n  },\r\n\r\n  Glob: {\r\n    name: 'Glob',\r\n    description: 'Fast file pattern matching. Supports glob patterns like \"**/*.js\".',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        pattern: {\r\n          type: 'string',\r\n          description: 'The glob pattern to match files against'\r\n        },\r\n        path: {\r\n          type: 'string',\r\n          description: 'Optional: Directory to search in (defaults to current working directory)'\r\n        }\r\n      },\r\n      required: ['pattern']\r\n    }\r\n  },\r\n\r\n  Grep: {\r\n    name: 'Grep',\r\n    description: 'Powerful search tool built on ripgrep. Supports regex patterns.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        pattern: {\r\n          type: 'string',\r\n          description: 'The regular expression pattern to search for'\r\n        },\r\n        path: {\r\n          type: 'string',\r\n          description: 'Optional: File or directory to search in'\r\n        },\r\n        output_mode: {\r\n          type: 'string',\r\n          enum: ['content', 'files_with_matches', 'count'],\r\n          description: 'Output mode (default: files_with_matches)'\r\n        },\r\n        glob: {\r\n          type: 'string',\r\n          description: 'Optional: Glob pattern to filter files'\r\n        },\r\n        type: {\r\n          type: 'string',\r\n          description: 'Optional: File type (js, py, rust, etc.)'\r\n        },\r\n        '-i': {\r\n          type: 'boolean',\r\n          description: 'Case insensitive search'\r\n        },\r\n        '-n': {\r\n          type: 'boolean',\r\n          description: 'Show line numbers (requires output_mode: content)'\r\n        },\r\n        '-A': {\r\n          type: 'number',\r\n          description: 'Lines to show after match (requires output_mode: content)'\r\n        },\r\n        '-B': {\r\n          type: 'number',\r\n          description: 'Lines to show before match (requires output_mode: content)'\r\n        },\r\n        '-C': {\r\n          type: 'number',\r\n          description: 'Lines to show before and after match (requires output_mode: content)'\r\n        }\r\n      },\r\n      required: ['pattern']\r\n    }\r\n  }\r\n};\r\n\r\n/**\r\n * Convert agent tool names to Anthropic API tool definitions\r\n */\r\nexport function convertToolNames(toolNames: string[]): ToolDefinition[] {\r\n  const definitions: ToolDefinition[] = [];\r\n\r\n  for (const toolName of toolNames) {\r\n    const definition = TOOL_REGISTRY[toolName];\r\n    if (definition) {\r\n      definitions.push(definition);\r\n    } else {\r\n      console.warn(`[tool-definitions] Unknown tool: ${toolName}`);\r\n    }\r\n  }\r\n\r\n  return definitions;\r\n}\r\n\r\n/**\r\n * Get tool definition by name\r\n */\r\nexport function getToolDefinition(toolName: string): ToolDefinition | undefined {\r\n  return TOOL_REGISTRY[toolName];\r\n}\r\n\r\n/**\r\n * Check if tool name is valid\r\n */\r\nexport function isValidTool(toolName: string): boolean {\r\n  return toolName in TOOL_REGISTRY;\r\n}\r\n\r\n/**\r\n * Get all available tool names\r\n */\r\nexport function getAvailableTools(): string[] {\r\n  return Object.keys(TOOL_REGISTRY);\r\n}\r\n"],"names":["TOOL_REGISTRY","Read","name","description","input_schema","type","properties","file_path","limit","offset","required","Write","content","Edit","old_string","new_string","replace_all","Bash","command","timeout","run_in_background","TodoWrite","todos","items","status","enum","activeForm","Glob","pattern","path","Grep","output_mode","glob","convertToolNames","toolNames","definitions","toolName","definition","push","console","warn","getToolDefinition","isValidTool","getAvailableTools","Object","keys"],"mappings":"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"}