claude-flow-novice 2.5.2 → 2.8.1

package/dist/cli/agent-prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/agent-prompt-builder.ts"],"sourcesContent":["/**\r\n * Agent Prompt Builder\r\n *\r\n * Builds comprehensive prompts for CLI-spawned agents by combining:\r\n * - Agent definition (YAML + markdown)\r\n * - Task context (taskId, iteration, mode)\r\n * - CFN Loop protocol (if applicable)\r\n * - Iteration history (Sprint 3 - Phase 2)\r\n * - Environment variables\r\n */\r\n\r\nimport { AgentDefinition, hasCFNLoopProtocol } from './agent-definition-parser.js';\r\nimport { loadIterationHistory, formatIterationHistory } from './iteration-history.js';\r\n\r\nexport interface TaskContext {\r\n  taskId?: string;\r\n  iteration?: number;\r\n  context?: string;\r\n  mode?: string;\r\n  priority?: number;\r\n  parentTaskId?: string;\r\n  agentId?: string;\r\n}\r\n\r\n/**\r\n * Build CFN Loop protocol instructions\r\n */\r\nfunction buildCFNLoopProtocol(taskId: string, agentId: string): string {\r\n  return `\r\n## CFN Loop Redis Completion Protocol\r\n\r\nYou are participating in a CFN Loop workflow. Follow this protocol EXACTLY:\r\n\r\n### Step 1: Complete Work\r\nExecute your assigned task (implementation, review, testing, etc.)\r\n\r\n### Step 2: Signal Completion\r\n\\`\\`\\`bash\r\nredis-cli lpush \"swarm:${taskId}:\\${AGENT_ID}:done\" \"complete\"\r\n\\`\\`\\`\r\n\r\n### Step 3: Report Confidence Score\r\n\\`\\`\\`bash\r\n./.claude/skills/redis-coordination/invoke-waiting-mode.sh report \\\\\r\n  --task-id \"${taskId}\" \\\\\r\n  --agent-id \"\\${AGENT_ID}\" \\\\\r\n  --confidence [0.0-1.0] \\\\\r\n  --iteration ${taskId.includes('iteration') ? 'CURRENT_ITERATION' : '1'}\r\n\\`\\`\\`\r\n\r\n### Step 4: Enter Waiting Mode (for potential iteration)\r\n\\`\\`\\`bash\r\n./.claude/skills/redis-coordination/invoke-waiting-mode.sh enter \\\\\r\n  --task-id \"${taskId}\" \\\\\r\n  --agent-id \"\\${AGENT_ID}\" \\\\\r\n  --context \"iteration-complete\"\r\n\\`\\`\\`\r\n\r\n**Critical Context Variables:**\r\n- TASK_ID: ${taskId}\r\n- AGENT_ID: ${agentId} (your unique identifier)\r\n- Confidence: Your self-assessment score (0.0-1.0)\r\n\r\n**Why This Matters:**\r\n- Zero-token blocking coordination (BLPOP waits without API calls)\r\n- Orchestrator collects confidence/consensus scores automatically\r\n- Supports autonomous iteration based on quality gates\r\n- Agent woken instantly (<100ms) if iteration needed\r\n\r\n**IMPORTANT:** You MUST complete all 4 steps in order. The orchestrator is waiting for your completion signal.\r\n`;\r\n}\r\n\r\n/**\r\n * Parse and enrich JSON context into natural language instructions\r\n */\r\nfunction enrichJSONContext(jsonObj: any): string {\r\n  const sections: string[] = [];\r\n\r\n  // Extract task description\r\n  if (jsonObj.task) {\r\n    sections.push(`**Task:** ${jsonObj.task}`);\r\n  }\r\n\r\n  // Parse files - convert comma-separated string to bullet list\r\n  if (jsonObj.files) {\r\n    const fileList = typeof jsonObj.files === 'string'\r\n      ? jsonObj.files.split(',').map(f => f.trim()).filter(f => f)\r\n      : Array.isArray(jsonObj.files) ? jsonObj.files : [];\r\n\r\n    if (fileList.length > 0) {\r\n      sections.push('\\n**Files to process:**');\r\n      fileList.forEach(file => sections.push(`- ${file}`));\r\n    }\r\n  }\r\n\r\n  // Add requirements/deliverables\r\n  if (jsonObj.requirements) {\r\n    const reqs = Array.isArray(jsonObj.requirements) ? jsonObj.requirements : [jsonObj.requirements];\r\n    sections.push('\\n**Requirements:**');\r\n    reqs.forEach((req, i) => sections.push(`${i + 1}. ${req}`));\r\n  }\r\n\r\n  if (jsonObj.deliverables) {\r\n    const delivs = Array.isArray(jsonObj.deliverables) ? jsonObj.deliverables : [jsonObj.deliverables];\r\n    sections.push('\\n**Deliverables:**');\r\n    delivs.forEach(deliv => sections.push(`- ${deliv}`));\r\n  }\r\n\r\n  // Add batch information\r\n  if (jsonObj.batch) {\r\n    sections.push(`\\n**Batch:** ${jsonObj.batch}`);\r\n  }\r\n\r\n  // Add directory context\r\n  if (jsonObj.directory) {\r\n    sections.push(`\\n**Working Directory:** ${jsonObj.directory}`);\r\n  }\r\n\r\n  // Add acceptance criteria\r\n  if (jsonObj.acceptanceCriteria) {\r\n    const criteria = Array.isArray(jsonObj.acceptanceCriteria)\r\n      ? jsonObj.acceptanceCriteria\r\n      : [jsonObj.acceptanceCriteria];\r\n    sections.push('\\n**Acceptance Criteria:**');\r\n    criteria.forEach(criterion => sections.push(`- ${criterion}`));\r\n  }\r\n\r\n  // Add explicit instructions if present\r\n  if (jsonObj.instructions) {\r\n    sections.push('\\n**Instructions:**');\r\n    const instrs = Array.isArray(jsonObj.instructions) ? jsonObj.instructions : [jsonObj.instructions];\r\n    instrs.forEach((instr, i) => sections.push(`${i + 1}. ${instr}`));\r\n  }\r\n\r\n  return sections.join('\\n');\r\n}\r\n\r\n/**\r\n * Build task description from context\r\n */\r\nfunction buildTaskDescription(agentType: string, context: TaskContext): string {\r\n  let desc = '';\r\n\r\n  if (context.context) {\r\n    // Try to parse as JSON first\r\n    let contextStr = context.context.trim();\r\n\r\n    // Check if context looks like JSON\r\n    if ((contextStr.startsWith('{') && contextStr.endsWith('}')) ||\r\n        (contextStr.startsWith('[') && contextStr.endsWith(']'))) {\r\n      try {\r\n        const jsonObj = JSON.parse(contextStr);\r\n        desc = enrichJSONContext(jsonObj);\r\n\r\n        // Add instruction footer for structured tasks\r\n        if (jsonObj.files || jsonObj.deliverables) {\r\n          desc += '\\n\\n**Process each item systematically and report confidence when complete.**';\r\n        }\r\n      } catch (e) {\r\n        // Not valid JSON, treat as plain text\r\n        desc = context.context;\r\n      }\r\n    } else {\r\n      // Plain text context\r\n      desc = context.context;\r\n    }\r\n  } else {\r\n    desc = `Execute task as ${agentType} agent`;\r\n  }\r\n\r\n  // Add metadata fields\r\n  if (context.taskId) {\r\n    desc += `\\n\\n**Task ID:** ${context.taskId}`;\r\n  }\r\n\r\n  if (context.iteration) {\r\n    desc += `\\n**Iteration:** ${context.iteration}`;\r\n  }\r\n\r\n  if (context.mode) {\r\n    desc += `\\n**Mode:** ${context.mode}`;\r\n  }\r\n\r\n  if (context.priority) {\r\n    desc += `\\n**Priority:** ${context.priority}`;\r\n  }\r\n\r\n  if (context.parentTaskId) {\r\n    desc += `\\n**Parent Task:** ${context.parentTaskId}`;\r\n  }\r\n\r\n  return desc;\r\n}\r\n\r\n/**\r\n * Build environment context section\r\n */\r\nfunction buildEnvironmentContext(context: TaskContext): string {\r\n  const env: string[] = [];\r\n\r\n  if (context.taskId) env.push(`TASK_ID=${context.taskId}`);\r\n  if (context.iteration) env.push(`ITERATION=${context.iteration}`);\r\n  if (context.mode) env.push(`MODE=${context.mode}`);\r\n  if (context.priority) env.push(`PRIORITY=${context.priority}`);\r\n  if (context.parentTaskId) env.push(`PARENT_TASK_ID=${context.parentTaskId}`);\r\n\r\n  if (env.length === 0) return '';\r\n\r\n  return `\r\n## Environment Variables\r\n\r\n\\`\\`\\`bash\r\n${env.join('\\n')}\r\n\\`\\`\\`\r\n`;\r\n}\r\n\r\n/**\r\n * Build complete prompt for agent execution (async for iteration history)\r\n */\r\nexport async function buildAgentPrompt(\r\n  definition: AgentDefinition,\r\n  context: TaskContext\r\n): Promise<string> {\r\n  const agentId = `${definition.name}-${context.iteration || 1}`;\r\n\r\n  const sections: string[] = [];\r\n\r\n  // 1. Agent definition header\r\n  sections.push(`# Agent: ${definition.name}`);\r\n  sections.push('');\r\n  sections.push(definition.description);\r\n  sections.push('');\r\n\r\n  // 2. Task description\r\n  sections.push('## Task');\r\n  sections.push('');\r\n  sections.push(buildTaskDescription(definition.name, context));\r\n  sections.push('');\r\n\r\n  // 3. Iteration history (Sprint 3 - Phase 2)\r\n  // Load and format previous iterations if iteration > 1\r\n  if (context.taskId && context.iteration && context.iteration > 1) {\r\n    try {\r\n      const history = await loadIterationHistory(context.taskId, agentId, context.iteration);\r\n      const historyText = formatIterationHistory(history, context.iteration);\r\n      sections.push(historyText);\r\n      sections.push('');\r\n    } catch (err) {\r\n      console.warn(`[agent-prompt-builder] Failed to load iteration history:`, err);\r\n      // Continue without history\r\n    }\r\n  }\r\n\r\n  // 4. Agent definition content (from markdown file)\r\n  sections.push('## Agent Definition');\r\n  sections.push('');\r\n  sections.push(definition.content);\r\n  sections.push('');\r\n\r\n  // 5. CFN Loop protocol (if agent supports it AND task context includes taskId)\r\n  if (context.taskId && hasCFNLoopProtocol(definition)) {\r\n    sections.push(buildCFNLoopProtocol(context.taskId, agentId));\r\n    sections.push('');\r\n  }\r\n\r\n  // 6. Environment context\r\n  const envContext = buildEnvironmentContext(context);\r\n  if (envContext) {\r\n    sections.push(envContext);\r\n    sections.push('');\r\n  }\r\n\r\n  // 7. Execution instructions\r\n  sections.push('## Execution Instructions');\r\n  sections.push('');\r\n  sections.push('1. Read and understand the task requirements');\r\n  if (context.iteration && context.iteration > 1) {\r\n    sections.push('2. Review iteration history and feedback from validators');\r\n    sections.push('3. Address specific feedback points from previous iteration');\r\n    sections.push('4. Execute your core responsibilities as defined above');\r\n  } else {\r\n    sections.push('2. Execute your core responsibilities as defined above');\r\n    sections.push('3. Follow any protocol steps (CFN Loop, validation hooks, etc.)');\r\n  }\r\n  sections.push('4. Provide clear, concise output');\r\n  sections.push('5. Report confidence score if applicable');\r\n  sections.push('');\r\n\r\n  // 8. Tool reminder\r\n  if (definition.tools && definition.tools.length > 0) {\r\n    sections.push('## Available Tools');\r\n    sections.push('');\r\n    sections.push(`You have access to: ${definition.tools.join(', ')}`);\r\n    sections.push('');\r\n  }\r\n\r\n  return sections.join('\\n');\r\n}\r\n\r\n/**\r\n * Extract agent ID from context\r\n * If agentId is explicitly provided in context, use it; otherwise generate from name + iteration\r\n */\r\nexport function getAgentId(definition: AgentDefinition, context: TaskContext): string {\r\n  if (context.agentId) {\r\n    return context.agentId;\r\n  }\r\n  return `${definition.name}-${context.iteration || 1}`;\r\n}\r\n\r\n/**\r\n * Build system prompt for agent (optional, for structured agent behavior)\r\n */\r\nexport function buildSystemPrompt(definition: AgentDefinition): string {\r\n  return `You are ${definition.name}, a specialized AI agent.\r\n\r\nType: ${definition.type || 'specialist'}\r\nModel: ${definition.model}\r\nTools: ${definition.tools.join(', ')}\r\n\r\nFollow your agent definition exactly and complete assigned tasks with high quality.`;\r\n}\r\n"],"names":["hasCFNLoopProtocol","loadIterationHistory","formatIterationHistory","buildCFNLoopProtocol","taskId","agentId","includes","enrichJSONContext","jsonObj","sections","task","push","files","fileList","split","map","f","trim","filter","Array","isArray","length","forEach","file","requirements","reqs","req","i","deliverables","delivs","deliv","batch","directory","acceptanceCriteria","criteria","criterion","instructions","instrs","instr","join","buildTaskDescription","agentType","context","desc","contextStr","startsWith","endsWith","JSON","parse","e","iteration","mode","priority","parentTaskId","buildEnvironmentContext","env","buildAgentPrompt","definition","name","description","history","historyText","err","console","warn","content","envContext","tools","getAgentId","buildSystemPrompt","type","model"],"mappings":"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"}

package/dist/cli/agent-spawn.js

@@ -36,6 +36,9 @@
         const key = optionArgs[i];
         const value = optionArgs[i + 1];
         switch(key){
+            case '--agent-id':
+                options.agentId = value;
+                break;
             case '--task-id':
                 options.taskId = value;
                 break;
@@ -67,8 +70,9 @@
  * This is a wrapper/alias for the existing claude-flow-novice agent spawning mechanism
  * Provides the cfn-spawn naming pattern while delegating to the working implementation
  */ async function spawnAgent(options) {
-    const { agentType, taskId, iteration, context, mode, priority, parentTaskId } = options;
+    const { agentType, agentId, taskId, iteration, context, mode, priority, parentTaskId } = options;
     console.log(`[cfn-spawn] Spawning agent: ${agentType}`);
+    if (agentId) console.log(`[cfn-spawn]   Agent ID: ${agentId}`);
     if (taskId) console.log(`[cfn-spawn]   Task ID: ${taskId}`);
     if (iteration) console.log(`[cfn-spawn]   Iteration: ${iteration}`);
     if (context) console.log(`[cfn-spawn]   Context: ${context}`);
@@ -80,6 +84,9 @@
         agentType
     ];
     // Add optional parameters
+    if (agentId) {
+        claudeArgs.push('--agent-id', agentId);
+    }
     if (taskId) {
         claudeArgs.push('--task-id', taskId);
     }
@@ -98,6 +105,47 @@
     if (parentTaskId) {
         claudeArgs.push('--parent-task-id', parentTaskId);
     }
+    // Fetch epic context from Redis if available
+    let epicContext = '';
+    let phaseContext = '';
+    let successCriteria = '';
+    if (taskId) {
+        try {
+            const { execSync } = await import('child_process');
+            // Try to read epic-level context from Redis
+            try {
+                epicContext = execSync(`redis-cli get "swarm:${taskId}:epic-context"`, {
+                    encoding: 'utf8'
+                }).trim();
+                if (epicContext === '(nil)') epicContext = '';
+            } catch (e) {
+            // Redis not available or key doesn't exist
+            }
+            // Try to read phase-specific context
+            try {
+                phaseContext = execSync(`redis-cli get "swarm:${taskId}:phase-context"`, {
+                    encoding: 'utf8'
+                }).trim();
+                if (phaseContext === '(nil)') phaseContext = '';
+            } catch (e) {
+            // Redis not available or key doesn't exist
+            }
+            // Try to read success criteria
+            try {
+                successCriteria = execSync(`redis-cli get "swarm:${taskId}:success-criteria"`, {
+                    encoding: 'utf8'
+                }).trim();
+                if (successCriteria === '(nil)') successCriteria = '';
+            } catch (e) {
+            // Redis not available or key doesn't exist
+            }
+            if (epicContext) {
+                console.log(`[cfn-spawn]   Epic context loaded from Redis`);
+            }
+        } catch (err) {
+            console.warn(`[cfn-spawn]   Could not load epic context from Redis:`, err);
+        }
+    }
     // Add environment variables for agent context
     const env = {
         ...process.env,
@@ -107,7 +155,11 @@
         CONTEXT: context || '',
         MODE: mode || 'cli',
         PRIORITY: priority?.toString() || '5',
-        PARENT_TASK_ID: parentTaskId || ''
+        PARENT_TASK_ID: parentTaskId || '',
+        // Epic-level context from Redis
+        EPIC_CONTEXT: epicContext,
+        PHASE_CONTEXT: phaseContext,
+        SUCCESS_CRITERIA: successCriteria
     };
     console.log(`[cfn-spawn] Executing: npx ${claudeArgs.join(' ')}`);
     // Spawn the claude-flow-novice agent process
@@ -162,6 +214,7 @@ Usage:
   cfn-spawn <type> [options]        (agent is implied)
 
 Options:
+  --agent-id <id>        Explicit agent identifier (overrides auto-generation)
   --task-id <id>         Task identifier
   --iteration <n>        Iteration number
   --context <text>       Context description
@@ -173,6 +226,7 @@ Examples:
   cfn-spawn agent researcher --task-id task-123 --iteration 1
   cfn-spawn coder --task-id auth-impl --context "Implement JWT auth"
   cfn-spawn reviewer --task-id auth-impl --iteration 2 --mode cli
+  cfn-spawn tester --agent-id tester-1-1 --task-id test-phase --iteration 1
     `);
         return;
     }

package/dist/cli/agent-spawn.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/agent-spawn.ts"],"sourcesContent":["#!/usr/bin/env node\r\n/**\r\n * Agent Spawning CLI - Direct agent process spawning\r\n *\r\n * Usage:\r\n *   npx cfn-spawn agent <type> [options]\r\n *   npx cfn-spawn <type> [options]  (agent is implied)\r\n *\r\n * Examples:\r\n *   npx cfn-spawn agent researcher --task-id task-123 --iteration 1\r\n *   npx cfn-spawn researcher --task-id task-123 --iteration 1\r\n */\r\n\r\nimport { spawn } from 'child_process';\r\nimport { resolve } from 'path';\r\n\r\ninterface AgentSpawnOptions {\r\n  agentType: string;\r\n  taskId?: string;\r\n  iteration?: number;\r\n  context?: string;\r\n  mode?: string;\r\n  priority?: number;\r\n  parentTaskId?: string;\r\n}\r\n\r\n/**\r\n * Parse command line arguments for agent spawning\r\n */\r\nfunction parseAgentArgs(args: string[]): AgentSpawnOptions | null {\r\n  // Handle both \"agent <type>\" and \"<type>\" patterns\r\n  let agentType: string;\r\n  let optionArgs: string[];\r\n\r\n  if (args[0] === 'agent') {\r\n    agentType = args[1];\r\n    optionArgs = args.slice(2);\r\n  } else {\r\n    agentType = args[0];\r\n    optionArgs = args.slice(1);\r\n  }\r\n\r\n  if (!agentType) {\r\n    console.error('Error: Agent type is required');\r\n    console.error('Usage: cfn-spawn agent <type> [options]');\r\n    return null;\r\n  }\r\n\r\n  const options: AgentSpawnOptions = { agentType };\r\n\r\n  // Parse optional parameters\r\n  for (let i = 0; i < optionArgs.length; i += 2) {\r\n    const key = optionArgs[i];\r\n    const value = optionArgs[i + 1];\r\n\r\n    switch (key) {\r\n      case '--task-id':\r\n        options.taskId = value;\r\n        break;\r\n      case '--iteration':\r\n        options.iteration = parseInt(value, 10);\r\n        break;\r\n      case '--context':\r\n        options.context = value;\r\n        break;\r\n      case '--mode':\r\n        options.mode = value;\r\n        break;\r\n      case '--priority':\r\n        options.priority = parseInt(value, 10);\r\n        break;\r\n      case '--parent-task':\r\n      case '--parent-task-id':\r\n        options.parentTaskId = value;\r\n        break;\r\n      default:\r\n        console.warn(`Unknown option: ${key}`);\r\n    }\r\n  }\r\n\r\n  return options;\r\n}\r\n\r\n/**\r\n * Spawn an agent process using npx claude-flow-novice agent\r\n *\r\n * This is a wrapper/alias for the existing claude-flow-novice agent spawning mechanism\r\n * Provides the cfn-spawn naming pattern while delegating to the working implementation\r\n */\r\nasync function spawnAgent(options: AgentSpawnOptions): Promise<void> {\r\n  const { agentType, taskId, iteration, context, mode, priority, parentTaskId } = options;\r\n\r\n  console.log(`[cfn-spawn] Spawning agent: ${agentType}`);\r\n  if (taskId) console.log(`[cfn-spawn]   Task ID: ${taskId}`);\r\n  if (iteration) console.log(`[cfn-spawn]   Iteration: ${iteration}`);\r\n  if (context) console.log(`[cfn-spawn]   Context: ${context}`);\r\n  if (mode) console.log(`[cfn-spawn]   Mode: ${mode}`);\r\n\r\n  // Build command arguments for npx claude-flow-novice agent\r\n  const claudeArgs = ['claude-flow-novice', 'agent', agentType];\r\n\r\n  // Add optional parameters\r\n  if (taskId) {\r\n    claudeArgs.push('--task-id', taskId);\r\n  }\r\n  if (iteration) {\r\n    claudeArgs.push('--iteration', iteration.toString());\r\n  }\r\n  if (context) {\r\n    claudeArgs.push('--context', context);\r\n  }\r\n  if (mode) {\r\n    claudeArgs.push('--mode', mode);\r\n  }\r\n  if (priority) {\r\n    claudeArgs.push('--priority', priority.toString());\r\n  }\r\n  if (parentTaskId) {\r\n    claudeArgs.push('--parent-task-id', parentTaskId);\r\n  }\r\n\r\n  // Add environment variables for agent context\r\n  const env = {\r\n    ...process.env,\r\n    AGENT_TYPE: agentType,\r\n    TASK_ID: taskId || '',\r\n    ITERATION: iteration?.toString() || '1',\r\n    CONTEXT: context || '',\r\n    MODE: mode || 'cli',\r\n    PRIORITY: priority?.toString() || '5',\r\n    PARENT_TASK_ID: parentTaskId || ''\r\n  };\r\n\r\n  console.log(`[cfn-spawn] Executing: npx ${claudeArgs.join(' ')}`);\r\n\r\n  // Spawn the claude-flow-novice agent process\r\n  const agentProcess = spawn('npx', claudeArgs, {\r\n    stdio: 'inherit',\r\n    env,\r\n    cwd: process.cwd()\r\n  });\r\n\r\n  // Handle process exit\r\n  agentProcess.on('exit', (code, signal) => {\r\n    if (code === 0) {\r\n      console.log(`[cfn-spawn] Agent ${agentType} completed successfully`);\r\n    } else {\r\n      console.error(`[cfn-spawn] Agent ${agentType} exited with code ${code}, signal ${signal}`);\r\n    }\r\n    process.exit(code || 0);\r\n  });\r\n\r\n  // Handle process errors\r\n  agentProcess.on('error', (err) => {\r\n    console.error(`[cfn-spawn] Failed to spawn agent ${agentType}:`, err.message);\r\n    process.exit(1);\r\n  });\r\n\r\n  // Cleanup on parent exit\r\n  process.on('SIGINT', () => {\r\n    console.log('\\n[cfn-spawn] Received SIGINT, terminating agent...');\r\n    agentProcess.kill('SIGINT');\r\n  });\r\n\r\n  process.on('SIGTERM', () => {\r\n    console.log('\\n[cfn-spawn] Received SIGTERM, terminating agent...');\r\n    agentProcess.kill('SIGTERM');\r\n  });\r\n}\r\n\r\n/**\r\n * Build task description for the agent\r\n */\r\nfunction buildTaskDescription(\r\n  agentType: string,\r\n  taskId?: string,\r\n  iteration?: number,\r\n  context?: string\r\n): string {\r\n  let desc = `Execute task as ${agentType} agent`;\r\n\r\n  if (taskId) desc += ` for task ${taskId}`;\r\n  if (iteration) desc += ` (iteration ${iteration})`;\r\n  if (context) desc += `: ${context}`;\r\n\r\n  return desc;\r\n}\r\n\r\n/**\r\n * Main CLI entry point\r\n */\r\nexport async function main(args: string[] = process.argv.slice(2)): Promise<void> {\r\n  // Show help if requested\r\n  if (args.includes('--help') || args.includes('-h')) {\r\n    console.log(`\r\ncfn-spawn - Claude Flow Novice Agent Spawner\r\n\r\nUsage:\r\n  cfn-spawn agent <type> [options]\r\n  cfn-spawn <type> [options]        (agent is implied)\r\n\r\nOptions:\r\n  --task-id <id>         Task identifier\r\n  --iteration <n>        Iteration number\r\n  --context <text>       Context description\r\n  --mode <mode>          Execution mode (cli, api, hybrid)\r\n  --priority <1-10>      Task priority\r\n  --parent-task-id <id>  Parent task identifier\r\n\r\nExamples:\r\n  cfn-spawn agent researcher --task-id task-123 --iteration 1\r\n  cfn-spawn coder --task-id auth-impl --context \"Implement JWT auth\"\r\n  cfn-spawn reviewer --task-id auth-impl --iteration 2 --mode cli\r\n    `);\r\n    return;\r\n  }\r\n\r\n  // Parse arguments\r\n  const options = parseAgentArgs(args);\r\n  if (!options) {\r\n    process.exit(1);\r\n  }\r\n\r\n  // Spawn the agent\r\n  await spawnAgent(options);\r\n}\r\n\r\n// Run if called directly\r\n// ES module check - compare import.meta.url with the executed file\r\nconst isMainModule = import.meta.url.endsWith(process.argv[1]?.replace(/\\\\/g, '/') || '');\r\nif (isMainModule) {\r\n  main().catch((err) => {\r\n    console.error('[cfn-spawn] Fatal error:', err);\r\n    process.exit(1);\r\n  });\r\n}\r\n"],"names":["spawn","parseAgentArgs","args","agentType","optionArgs","slice","console","error","options","i","length","key","value","taskId","iteration","parseInt","context","mode","priority","parentTaskId","warn","spawnAgent","log","claudeArgs","push","toString","env","process","AGENT_TYPE","TASK_ID","ITERATION","CONTEXT","MODE","PRIORITY","PARENT_TASK_ID","join","agentProcess","stdio","cwd","on","code","signal","exit","err","message","kill","buildTaskDescription","desc","main","argv","includes","isMainModule","url","endsWith","replace","catch"],"mappings":"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"}
+{"version":3,"sources":["../../src/cli/agent-spawn.ts"],"sourcesContent":["#!/usr/bin/env node\r\n/**\r\n * Agent Spawning CLI - Direct agent process spawning\r\n *\r\n * Usage:\r\n *   npx cfn-spawn agent <type> [options]\r\n *   npx cfn-spawn <type> [options]  (agent is implied)\r\n *\r\n * Examples:\r\n *   npx cfn-spawn agent researcher --task-id task-123 --iteration 1\r\n *   npx cfn-spawn researcher --task-id task-123 --iteration 1\r\n */\r\n\r\nimport { spawn } from 'child_process';\r\nimport { resolve } from 'path';\r\n\r\ninterface AgentSpawnOptions {\r\n  agentType: string;\r\n  agentId?: string;\r\n  taskId?: string;\r\n  iteration?: number;\r\n  context?: string;\r\n  mode?: string;\r\n  priority?: number;\r\n  parentTaskId?: string;\r\n}\r\n\r\n/**\r\n * Parse command line arguments for agent spawning\r\n */\r\nfunction parseAgentArgs(args: string[]): AgentSpawnOptions | null {\r\n  // Handle both \"agent <type>\" and \"<type>\" patterns\r\n  let agentType: string;\r\n  let optionArgs: string[];\r\n\r\n  if (args[0] === 'agent') {\r\n    agentType = args[1];\r\n    optionArgs = args.slice(2);\r\n  } else {\r\n    agentType = args[0];\r\n    optionArgs = args.slice(1);\r\n  }\r\n\r\n  if (!agentType) {\r\n    console.error('Error: Agent type is required');\r\n    console.error('Usage: cfn-spawn agent <type> [options]');\r\n    return null;\r\n  }\r\n\r\n  const options: AgentSpawnOptions = { agentType };\r\n\r\n  // Parse optional parameters\r\n  for (let i = 0; i < optionArgs.length; i += 2) {\r\n    const key = optionArgs[i];\r\n    const value = optionArgs[i + 1];\r\n\r\n    switch (key) {\r\n      case '--agent-id':\r\n        options.agentId = value;\r\n        break;\r\n      case '--task-id':\r\n        options.taskId = value;\r\n        break;\r\n      case '--iteration':\r\n        options.iteration = parseInt(value, 10);\r\n        break;\r\n      case '--context':\r\n        options.context = value;\r\n        break;\r\n      case '--mode':\r\n        options.mode = value;\r\n        break;\r\n      case '--priority':\r\n        options.priority = parseInt(value, 10);\r\n        break;\r\n      case '--parent-task':\r\n      case '--parent-task-id':\r\n        options.parentTaskId = value;\r\n        break;\r\n      default:\r\n        console.warn(`Unknown option: ${key}`);\r\n    }\r\n  }\r\n\r\n  return options;\r\n}\r\n\r\n/**\r\n * Spawn an agent process using npx claude-flow-novice agent\r\n *\r\n * This is a wrapper/alias for the existing claude-flow-novice agent spawning mechanism\r\n * Provides the cfn-spawn naming pattern while delegating to the working implementation\r\n */\r\nasync function spawnAgent(options: AgentSpawnOptions): Promise<void> {\r\n  const { agentType, agentId, taskId, iteration, context, mode, priority, parentTaskId } = options;\r\n\r\n  console.log(`[cfn-spawn] Spawning agent: ${agentType}`);\r\n  if (agentId) console.log(`[cfn-spawn]   Agent ID: ${agentId}`);\r\n  if (taskId) console.log(`[cfn-spawn]   Task ID: ${taskId}`);\r\n  if (iteration) console.log(`[cfn-spawn]   Iteration: ${iteration}`);\r\n  if (context) console.log(`[cfn-spawn]   Context: ${context}`);\r\n  if (mode) console.log(`[cfn-spawn]   Mode: ${mode}`);\r\n\r\n  // Build command arguments for npx claude-flow-novice agent\r\n  const claudeArgs = ['claude-flow-novice', 'agent', agentType];\r\n\r\n  // Add optional parameters\r\n  if (agentId) {\r\n    claudeArgs.push('--agent-id', agentId);\r\n  }\r\n  if (taskId) {\r\n    claudeArgs.push('--task-id', taskId);\r\n  }\r\n  if (iteration) {\r\n    claudeArgs.push('--iteration', iteration.toString());\r\n  }\r\n  if (context) {\r\n    claudeArgs.push('--context', context);\r\n  }\r\n  if (mode) {\r\n    claudeArgs.push('--mode', mode);\r\n  }\r\n  if (priority) {\r\n    claudeArgs.push('--priority', priority.toString());\r\n  }\r\n  if (parentTaskId) {\r\n    claudeArgs.push('--parent-task-id', parentTaskId);\r\n  }\r\n\r\n  // Fetch epic context from Redis if available\r\n  let epicContext = '';\r\n  let phaseContext = '';\r\n  let successCriteria = '';\r\n\r\n  if (taskId) {\r\n    try {\r\n      const { execSync } = await import('child_process');\r\n\r\n      // Try to read epic-level context from Redis\r\n      try {\r\n        epicContext = execSync(`redis-cli get \"swarm:${taskId}:epic-context\"`, { encoding: 'utf8' }).trim();\r\n        if (epicContext === '(nil)') epicContext = '';\r\n      } catch (e) {\r\n        // Redis not available or key doesn't exist\r\n      }\r\n\r\n      // Try to read phase-specific context\r\n      try {\r\n        phaseContext = execSync(`redis-cli get \"swarm:${taskId}:phase-context\"`, { encoding: 'utf8' }).trim();\r\n        if (phaseContext === '(nil)') phaseContext = '';\r\n      } catch (e) {\r\n        // Redis not available or key doesn't exist\r\n      }\r\n\r\n      // Try to read success criteria\r\n      try {\r\n        successCriteria = execSync(`redis-cli get \"swarm:${taskId}:success-criteria\"`, { encoding: 'utf8' }).trim();\r\n        if (successCriteria === '(nil)') successCriteria = '';\r\n      } catch (e) {\r\n        // Redis not available or key doesn't exist\r\n      }\r\n\r\n      if (epicContext) {\r\n        console.log(`[cfn-spawn]   Epic context loaded from Redis`);\r\n      }\r\n    } catch (err) {\r\n      console.warn(`[cfn-spawn]   Could not load epic context from Redis:`, err);\r\n    }\r\n  }\r\n\r\n  // Add environment variables for agent context\r\n  const env = {\r\n    ...process.env,\r\n    AGENT_TYPE: agentType,\r\n    TASK_ID: taskId || '',\r\n    ITERATION: iteration?.toString() || '1',\r\n    CONTEXT: context || '',\r\n    MODE: mode || 'cli',\r\n    PRIORITY: priority?.toString() || '5',\r\n    PARENT_TASK_ID: parentTaskId || '',\r\n    // Epic-level context from Redis\r\n    EPIC_CONTEXT: epicContext,\r\n    PHASE_CONTEXT: phaseContext,\r\n    SUCCESS_CRITERIA: successCriteria\r\n  };\r\n\r\n  console.log(`[cfn-spawn] Executing: npx ${claudeArgs.join(' ')}`);\r\n\r\n  // Spawn the claude-flow-novice agent process\r\n  const agentProcess = spawn('npx', claudeArgs, {\r\n    stdio: 'inherit',\r\n    env,\r\n    cwd: process.cwd()\r\n  });\r\n\r\n  // Handle process exit\r\n  agentProcess.on('exit', (code, signal) => {\r\n    if (code === 0) {\r\n      console.log(`[cfn-spawn] Agent ${agentType} completed successfully`);\r\n    } else {\r\n      console.error(`[cfn-spawn] Agent ${agentType} exited with code ${code}, signal ${signal}`);\r\n    }\r\n    process.exit(code || 0);\r\n  });\r\n\r\n  // Handle process errors\r\n  agentProcess.on('error', (err) => {\r\n    console.error(`[cfn-spawn] Failed to spawn agent ${agentType}:`, err.message);\r\n    process.exit(1);\r\n  });\r\n\r\n  // Cleanup on parent exit\r\n  process.on('SIGINT', () => {\r\n    console.log('\\n[cfn-spawn] Received SIGINT, terminating agent...');\r\n    agentProcess.kill('SIGINT');\r\n  });\r\n\r\n  process.on('SIGTERM', () => {\r\n    console.log('\\n[cfn-spawn] Received SIGTERM, terminating agent...');\r\n    agentProcess.kill('SIGTERM');\r\n  });\r\n}\r\n\r\n/**\r\n * Build task description for the agent\r\n */\r\nfunction buildTaskDescription(\r\n  agentType: string,\r\n  taskId?: string,\r\n  iteration?: number,\r\n  context?: string\r\n): string {\r\n  let desc = `Execute task as ${agentType} agent`;\r\n\r\n  if (taskId) desc += ` for task ${taskId}`;\r\n  if (iteration) desc += ` (iteration ${iteration})`;\r\n  if (context) desc += `: ${context}`;\r\n\r\n  return desc;\r\n}\r\n\r\n/**\r\n * Main CLI entry point\r\n */\r\nexport async function main(args: string[] = process.argv.slice(2)): Promise<void> {\r\n  // Show help if requested\r\n  if (args.includes('--help') || args.includes('-h')) {\r\n    console.log(`\r\ncfn-spawn - Claude Flow Novice Agent Spawner\r\n\r\nUsage:\r\n  cfn-spawn agent <type> [options]\r\n  cfn-spawn <type> [options]        (agent is implied)\r\n\r\nOptions:\r\n  --agent-id <id>        Explicit agent identifier (overrides auto-generation)\r\n  --task-id <id>         Task identifier\r\n  --iteration <n>        Iteration number\r\n  --context <text>       Context description\r\n  --mode <mode>          Execution mode (cli, api, hybrid)\r\n  --priority <1-10>      Task priority\r\n  --parent-task-id <id>  Parent task identifier\r\n\r\nExamples:\r\n  cfn-spawn agent researcher --task-id task-123 --iteration 1\r\n  cfn-spawn coder --task-id auth-impl --context \"Implement JWT auth\"\r\n  cfn-spawn reviewer --task-id auth-impl --iteration 2 --mode cli\r\n  cfn-spawn tester --agent-id tester-1-1 --task-id test-phase --iteration 1\r\n    `);\r\n    return;\r\n  }\r\n\r\n  // Parse arguments\r\n  const options = parseAgentArgs(args);\r\n  if (!options) {\r\n    process.exit(1);\r\n  }\r\n\r\n  // Spawn the agent\r\n  await spawnAgent(options);\r\n}\r\n\r\n// Run if called directly\r\n// ES module check - compare import.meta.url with the executed file\r\nconst isMainModule = import.meta.url.endsWith(process.argv[1]?.replace(/\\\\/g, '/') || '');\r\nif (isMainModule) {\r\n  main().catch((err) => {\r\n    console.error('[cfn-spawn] Fatal error:', err);\r\n    process.exit(1);\r\n  });\r\n}\r\n"],"names":["spawn","parseAgentArgs","args","agentType","optionArgs","slice","console","error","options","i","length","key","value","agentId","taskId","iteration","parseInt","context","mode","priority","parentTaskId","warn","spawnAgent","log","claudeArgs","push","toString","epicContext","phaseContext","successCriteria","execSync","encoding","trim","e","err","env","process","AGENT_TYPE","TASK_ID","ITERATION","CONTEXT","MODE","PRIORITY","PARENT_TASK_ID","EPIC_CONTEXT","PHASE_CONTEXT","SUCCESS_CRITERIA","join","agentProcess","stdio","cwd","on","code","signal","exit","message","kill","buildTaskDescription","desc","main","argv","includes","isMainModule","url","endsWith","replace","catch"],"mappings":"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"}

package/dist/cli/anthropic-client.js

@@ -0,0 +1,421 @@
+/**
+ * Anthropic API Client
+ *
+ * Handles communication with Claude API (Anthropic or z.ai provider).
+ * Supports streaming responses and tool execution.
+ */ import Anthropic from '@anthropic-ai/sdk';
+import fs from 'fs/promises';
+import path from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { executeTool } from './tool-executor.js';
+const execAsync = promisify(exec);
+/**
+ * Get API configuration from environment and config files
+ */ export async function getAPIConfig() {
+    // Check environment variable
+    const envProvider = process.env.CLAUDE_API_PROVIDER;
+    if (envProvider === 'zai') {
+        return {
+            provider: 'zai',
+            apiKey: process.env.ZAI_API_KEY || process.env.ANTHROPIC_API_KEY,
+            baseURL: process.env.ZAI_BASE_URL || 'https://api.z.ai/api/anthropic'
+        };
+    }
+    // Check config file
+    try {
+        const configPath = path.join('.claude', 'config', 'api-provider.json');
+        const config = JSON.parse(await fs.readFile(configPath, 'utf-8'));
+        if (config.provider === 'zai' || config.provider === 'z.ai') {
+            return {
+                provider: 'zai',
+                apiKey: config.apiKey || process.env.ZAI_API_KEY || process.env.ANTHROPIC_API_KEY,
+                baseURL: config.baseURL || process.env.ZAI_BASE_URL || 'https://api.z.ai/api/anthropic'
+            };
+        }
+    } catch  {
+    // Config file doesn't exist, use defaults
+    }
+    // Default to Anthropic
+    return {
+        provider: 'anthropic',
+        apiKey: process.env.ANTHROPIC_API_KEY
+    };
+}
+/**
+ * Create Anthropic client with appropriate configuration
+ */ export async function createClient() {
+    const config = await getAPIConfig();
+    if (!config.apiKey) {
+        throw new Error(`API key not found. Set ${config.provider === 'zai' ? 'ZAI_API_KEY' : 'ANTHROPIC_API_KEY'} environment variable.`);
+    }
+    const clientOptions = {
+        apiKey: config.apiKey,
+        timeout: 120000,
+        maxRetries: 2
+    };
+    if (config.provider === 'zai' && config.baseURL) {
+        clientOptions.baseURL = config.baseURL;
+    }
+    return new Anthropic(clientOptions);
+}
+/**
+ * Map agent model name to API model ID (provider-specific)
+ */ export function mapModelName(agentModel, provider = 'anthropic') {
+    // Z.ai uses GLM models - try glm-4.6 first for all models
+    if (provider === 'zai') {
+        const zaiModelMap = {
+            haiku: 'glm-4.6',
+            sonnet: 'glm-4.6',
+            opus: 'glm-4.6'
+        };
+        return zaiModelMap[agentModel] || 'glm-4.6';
+    }
+    // Anthropic uses Claude models
+    const modelMap = {
+        haiku: 'claude-3-5-haiku-20241022',
+        sonnet: 'claude-3-5-sonnet-20241022',
+        opus: 'claude-3-opus-20240229'
+    };
+    return modelMap[agentModel] || modelMap.haiku;
+}
+/**
+ * Get fallback model for Z.ai (glm-4.6 -> glm-4.5-air)
+ */ function getFallbackModel(model) {
+    if (model === 'glm-4.6') {
+        return 'glm-4.5-air';
+    }
+    return null;
+}
+/**
+ * Send message to Claude API with streaming support and automatic fallback
+ */ export async function sendMessage(options, onChunk) {
+    const client = await createClient();
+    const config = await getAPIConfig();
+    // Primary model (glm-4.6 for Z.ai, Claude for Anthropic)
+    let model = mapModelName(options.model, config.provider);
+    const maxTokens = options.maxTokens || 16000; // Sprint 6: 16K hard limit for GLM-4.6 (agents target 10K for buffer)
+    const temperature = options.temperature ?? 1.0;
+    // Disable streaming for Z.ai (compatibility issue)
+    const enableStreaming = options.stream && config.provider !== 'zai';
+    console.log(`[anthropic-client] Provider: ${config.provider}`);
+    console.log(`[anthropic-client] Model: ${model}`);
+    console.log(`[anthropic-client] Max tokens: ${maxTokens}`);
+    console.log(`[anthropic-client] Stream: ${enableStreaming ? 'enabled' : 'disabled'}`);
+    console.log('');
+    // Sprint 4: Use messages array if provided (conversation forking)
+    const messages = options.messages ? options.messages.map((m)=>({
+            role: m.role,
+            content: m.content
+        })) : [
+        {
+            role: 'user',
+            content: options.prompt
+        }
+    ];
+    // Retry logic: Try primary model (glm-4.6), fall back to glm-4.5 on error
+    let lastError = null;
+    let attempts = 0;
+    const maxAttempts = 2; // Primary + fallback
+    while(attempts < maxAttempts){
+        const currentModel = attempts === 0 ? model : getFallbackModel(model);
+        if (!currentModel) {
+            // No fallback available, throw last error
+            throw lastError || new Error('No model available');
+        }
+        attempts++;
+        if (attempts > 1) {
+            console.log(`[anthropic-client] Retrying with fallback model: ${currentModel}`);
+        }
+        const requestParams = {
+            model: currentModel,
+            max_tokens: maxTokens,
+            temperature,
+            messages
+        };
+        if (options.systemPrompt) {
+            requestParams.system = options.systemPrompt;
+        }
+        if (options.tools && options.tools.length > 0) {
+            requestParams.tools = options.tools;
+        }
+        try {
+            // Streaming response
+            if (enableStreaming) {
+                let fullContent = '';
+                let inputTokens = 0;
+                let outputTokens = 0;
+                let stopReason = 'end_turn';
+                console.log('[anthropic-client] Creating streaming request...');
+                const stream = await client.messages.create({
+                    ...requestParams,
+                    stream: true
+                });
+                console.log('[anthropic-client] Stream created, processing events...');
+                for await (const event of stream){
+                    console.log('[anthropic-client] Event type:', event.type);
+                    if (event.type === 'message_start') {
+                        // @ts-ignore - usage exists on message_start
+                        inputTokens = event.message.usage?.input_tokens || 0;
+                    } else if (event.type === 'content_block_delta') {
+                        // @ts-ignore - text exists on delta
+                        const text = event.delta?.text || '';
+                        fullContent += text;
+                        if (onChunk) {
+                            onChunk(text);
+                        }
+                    } else if (event.type === 'message_delta') {
+                        // @ts-ignore - usage exists on message_delta
+                        outputTokens = event.usage?.output_tokens || 0;
+                        // @ts-ignore - stop_reason exists on delta
+                        stopReason = event.delta?.stop_reason || 'end_turn';
+                    }
+                }
+                return {
+                    content: fullContent,
+                    usage: {
+                        inputTokens,
+                        outputTokens
+                    },
+                    stopReason
+                };
+            }
+            // Non-streaming response
+            const response = await client.messages.create(requestParams);
+            const content = response.content.filter((block)=>block.type === 'text').map((block)=>block.text).join('\n') || '';
+            return {
+                content,
+                usage: {
+                    inputTokens: response.usage.input_tokens,
+                    outputTokens: response.usage.output_tokens
+                },
+                stopReason: response.stop_reason || 'end_turn'
+            };
+        } catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            console.error(`[anthropic-client] Error with model ${currentModel}:`, lastError.message);
+            // If this was the last attempt, throw the error
+            if (attempts >= maxAttempts) {
+                throw lastError;
+            }
+            // Continue to next attempt with fallback model
+            console.log('[anthropic-client] Will retry with fallback model...');
+        }
+    }
+    // Should never reach here
+    throw lastError || new Error('All retry attempts failed');
+}
+/**
+ * Execute agent with tool support (agentic loop)
+ *
+ * Handles:
+ * 1. Send message with tools
+ * 2. Get response
+ * 3. If tool_use blocks, execute tools and send results back
+ * 4. Repeat until final text response
+ */ async function executeWithTools(options, onChunk) {
+    const client = await createClient();
+    const config = await getAPIConfig();
+    const model = mapModelName(options.model, config.provider);
+    const maxTokens = options.maxTokens || 16000;
+    const temperature = options.temperature ?? 1.0;
+    // Build initial messages array
+    const messages = options.messages ? options.messages.map((m)=>({
+            role: m.role,
+            content: m.content
+        })) : [
+        {
+            role: 'user',
+            content: options.prompt
+        }
+    ];
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let fullTextContent = '';
+    const MAX_ITERATIONS = 10; // Prevent infinite loops
+    let iteration = 0;
+    while(iteration < MAX_ITERATIONS){
+        iteration++;
+        console.log(`[executeWithTools] Iteration ${iteration}`);
+        const requestParams = {
+            model,
+            max_tokens: maxTokens,
+            temperature,
+            messages
+        };
+        if (options.systemPrompt) {
+            requestParams.system = options.systemPrompt;
+        }
+        if (options.tools && options.tools.length > 0) {
+            requestParams.tools = options.tools;
+        }
+        // Make API request (non-streaming for now to handle tool_use)
+        const response = await client.messages.create(requestParams);
+        totalInputTokens += response.usage.input_tokens;
+        totalOutputTokens += response.usage.output_tokens;
+        // Extract content blocks
+        const textBlocks = response.content.filter((block)=>block.type === 'text');
+        const toolUseBlocks = response.content.filter((block)=>block.type === 'tool_use');
+        // Stream text output
+        for (const block of textBlocks){
+            if (block.type === 'text') {
+                const text = block.text;
+                fullTextContent += text;
+                if (onChunk) {
+                    onChunk(text);
+                }
+            }
+        }
+        // If no tool uses, we're done
+        if (toolUseBlocks.length === 0) {
+            console.log(`[executeWithTools] No tool uses, completing`);
+            return {
+                content: fullTextContent,
+                usage: {
+                    inputTokens: totalInputTokens,
+                    outputTokens: totalOutputTokens
+                },
+                stopReason: response.stop_reason || 'end_turn'
+            };
+        }
+        // Execute tools
+        console.log(`[executeWithTools] Executing ${toolUseBlocks.length} tool(s)`);
+        const toolResults = [];
+        for (const toolUseBlock of toolUseBlocks){
+            if (toolUseBlock.type !== 'tool_use') continue;
+            const toolUse = {
+                type: 'tool_use',
+                id: toolUseBlock.id,
+                name: toolUseBlock.name,
+                input: toolUseBlock.input
+            };
+            console.log(`[executeWithTools] Tool: ${toolUse.name}`);
+            const result = await executeTool(toolUse);
+            toolResults.push(result);
+            // Stream tool result
+            if (onChunk) {
+                onChunk(`\n[Tool: ${toolUse.name}] ${result.content.substring(0, 100)}${result.content.length > 100 ? '...' : ''}\n`);
+            }
+        }
+        // Add assistant message with tool_use
+        messages.push({
+            role: 'assistant',
+            content: response.content
+        });
+        // Add tool results as user message
+        messages.push({
+            role: 'user',
+            content: toolResults
+        });
+    // Continue to next iteration
+    }
+    // Reached max iterations
+    console.warn(`[executeWithTools] Reached max iterations (${MAX_ITERATIONS})`);
+    return {
+        content: fullTextContent,
+        usage: {
+            inputTokens: totalInputTokens,
+            outputTokens: totalOutputTokens
+        },
+        stopReason: 'max_tokens'
+    };
+}
+/**
+ * Execute agent via API with full lifecycle
+ */ export async function executeAgentAPI(agentType, agentId, model, prompt, systemPrompt, messages, maxTokens, tools// Tool definitions for agent capabilities
+) {
+    // Start heartbeat monitoring (declare at function scope for error handling)
+    let heartbeatInterval = null;
+    const taskId = process.env.TASK_ID;
+    try {
+        console.log(`[anthropic-client] Executing agent: ${agentType}`);
+        console.log(`[anthropic-client] Agent ID: ${agentId}`);
+        if (messages && messages.length > 1) {
+            console.log(`[anthropic-client] Continuing conversation (${messages.length} messages)`);
+        }
+        console.log('');
+        if (taskId) {
+            heartbeatInterval = setInterval(async ()=>{
+                try {
+                    await execAsync(`redis-cli hset "swarm:${taskId}:agent:${agentId}" heartbeat "${Date.now()}" status "working"`);
+                } catch (err) {
+                    console.error('[heartbeat] Error sending heartbeat:', err);
+                }
+            }, 30000); // Every 30 seconds
+            console.log(`[heartbeat] Monitoring started for agent ${agentId} (30s interval)`);
+        }
+        let fullOutput = '';
+        // If tools provided, use agentic loop with tool execution
+        // Otherwise use simple streaming
+        let response;
+        if (tools && tools.length > 0) {
+            console.log(`[anthropic-client] Tools enabled: ${tools.map((t)=>t.name).join(', ')}`);
+            response = await executeWithTools({
+                model,
+                prompt,
+                systemPrompt,
+                messages,
+                maxTokens,
+                tools
+            }, (chunk)=>{
+                process.stdout.write(chunk);
+                fullOutput += chunk;
+            });
+        } else {
+            response = await sendMessage({
+                model,
+                prompt,
+                systemPrompt,
+                stream: true,
+                messages,
+                maxTokens
+            }, (chunk)=>{
+                process.stdout.write(chunk);
+                fullOutput += chunk;
+            });
+        }
+        console.log('\n');
+        console.log('=== Agent Execution Complete ===');
+        console.log(`Input tokens: ${response.usage.inputTokens}`);
+        console.log(`Output tokens: ${response.usage.outputTokens}`);
+        console.log(`Stop reason: ${response.stopReason}`);
+        // Stop heartbeat and send final status
+        if (heartbeatInterval) {
+            clearInterval(heartbeatInterval);
+            if (taskId) {
+                await execAsync(`redis-cli hset "swarm:${taskId}:agent:${agentId}" heartbeat "${Date.now()}" status "complete"`);
+                console.log(`[heartbeat] Monitoring stopped - agent ${agentId} complete`);
+            }
+        }
+        return {
+            success: true,
+            output: response.content,
+            usage: response.usage
+        };
+    } catch (error) {
+        console.error('[anthropic-client] Error:', error);
+        // Stop heartbeat and send error status
+        if (heartbeatInterval) {
+            clearInterval(heartbeatInterval);
+            if (taskId) {
+                try {
+                    await execAsync(`redis-cli hset "swarm:${taskId}:agent:${agentId}" heartbeat "${Date.now()}" status "error"`);
+                    console.log(`[heartbeat] Monitoring stopped - agent ${agentId} error`);
+                } catch (err) {
+                // Ignore heartbeat errors during error handling
+                }
+            }
+        }
+        return {
+            success: false,
+            output: '',
+            usage: {
+                inputTokens: 0,
+                outputTokens: 0
+            },
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+
+//# sourceMappingURL=anthropic-client.js.map