claude-flow-novice 2.6.0 → 2.8.1

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  // 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  --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","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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"}
+{"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

@@ -6,6 +6,10 @@
  */ 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() {
@@ -90,7 +94,7 @@ import path from 'path';
     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 || 4096;
+    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';
@@ -99,7 +103,11 @@ import path from 'path';
     console.log(`[anthropic-client] Max tokens: ${maxTokens}`);
     console.log(`[anthropic-client] Stream: ${enableStreaming ? 'enabled' : 'disabled'}`);
     console.log('');
-    const messages = [
+    // 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
@@ -197,29 +205,188 @@ import path from 'path';
     // 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) {
+ */ 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 = '';
-        const response = await sendMessage({
-            model,
-            prompt,
-            systemPrompt,
-            stream: true
-        }, (chunk)=>{
-            // Stream output in real-time
-            process.stdout.write(chunk);
-            fullOutput += chunk;
-        });
+        // 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,
@@ -227,6 +394,18 @@ import path from 'path';
         };
     } 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: '',

package/dist/cli/anthropic-client.js.map

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

package/dist/cli/cfn-context.js

@@ -1,4 +1,154 @@
 #!/usr/bin/env node
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+// ============================================================================
+// Redis Epic Context Functions
+// ============================================================================
+/**
+ * Load epic context from Redis
+ *
+ * Redis key: swarm:{taskId}:epic-context
+ */ export async function loadEpicContext(taskId) {
+    try {
+        const { stdout } = await execAsync(`redis-cli get "swarm:${taskId}:epic-context"`);
+        const result = stdout.trim();
+        if (result === '(nil)' || !result) {
+            return null;
+        }
+        return JSON.parse(result);
+    } catch (error) {
+        console.warn(`[cfn-context] Failed to load epic context for task ${taskId}:`, error);
+        return null;
+    }
+}
+/**
+ * Load phase context from Redis
+ *
+ * Redis key: swarm:{taskId}:phase-context
+ */ export async function loadPhaseContext(taskId) {
+    try {
+        const { stdout } = await execAsync(`redis-cli get "swarm:${taskId}:phase-context"`);
+        const result = stdout.trim();
+        if (result === '(nil)' || !result) {
+            return null;
+        }
+        return JSON.parse(result);
+    } catch (error) {
+        console.warn(`[cfn-context] Failed to load phase context for task ${taskId}:`, error);
+        return null;
+    }
+}
+/**
+ * Load success criteria from Redis
+ *
+ * Redis key: swarm:{taskId}:success-criteria
+ */ export async function loadSuccessCriteria(taskId) {
+    try {
+        const { stdout } = await execAsync(`redis-cli get "swarm:${taskId}:success-criteria"`);
+        const result = stdout.trim();
+        if (result === '(nil)' || !result) {
+            return null;
+        }
+        return JSON.parse(result);
+    } catch (error) {
+        console.warn(`[cfn-context] Failed to load success criteria for task ${taskId}:`, error);
+        return null;
+    }
+}
+/**
+ * Store epic context to Redis
+ *
+ * Redis key: swarm:{taskId}:epic-context
+ * TTL: 7 days
+ */ export async function storeEpicContext(taskId, context) {
+    try {
+        const contextJson = JSON.stringify(context);
+        await execAsync(`redis-cli setex "swarm:${taskId}:epic-context" 604800 '${contextJson.replace(/'/g, "\\'")}'`);
+        console.log(`[cfn-context] Stored epic context for task ${taskId}`);
+        return true;
+    } catch (error) {
+        console.error(`[cfn-context] Failed to store epic context for task ${taskId}:`, error);
+        return false;
+    }
+}
+/**
+ * Store phase context to Redis
+ *
+ * Redis key: swarm:{taskId}:phase-context
+ * TTL: 7 days
+ */ export async function storePhaseContext(taskId, context) {
+    try {
+        const contextJson = JSON.stringify(context);
+        await execAsync(`redis-cli setex "swarm:${taskId}:phase-context" 604800 '${contextJson.replace(/'/g, "\\'")}'`);
+        console.log(`[cfn-context] Stored phase context for task ${taskId}`);
+        return true;
+    } catch (error) {
+        console.error(`[cfn-context] Failed to store phase context for task ${taskId}:`, error);
+        return false;
+    }
+}
+/**
+ * Store success criteria to Redis
+ *
+ * Redis key: swarm:{taskId}:success-criteria
+ * TTL: 7 days
+ */ export async function storeSuccessCriteria(taskId, criteria) {
+    try {
+        const criteriaJson = JSON.stringify(criteria);
+        await execAsync(`redis-cli setex "swarm:${taskId}:success-criteria" 604800 '${criteriaJson.replace(/'/g, "\\'")}'`);
+        console.log(`[cfn-context] Stored success criteria for task ${taskId}`);
+        return true;
+    } catch (error) {
+        console.error(`[cfn-context] Failed to store success criteria for task ${taskId}:`, error);
+        return false;
+    }
+}
+/**
+ * Format epic context as markdown for system prompt
+ */ export function formatEpicContextForPrompt(epic) {
+    if (!epic.epicGoal && !epic.inScope && !epic.outOfScope) {
+        return '';
+    }
+    const sections = [];
+    sections.push('## Epic Context');
+    sections.push('');
+    if (epic.epicName) {
+        sections.push(`**Epic:** ${epic.epicName}`);
+        sections.push('');
+    }
+    if (epic.epicGoal) {
+        sections.push('**Goal:**');
+        sections.push(epic.epicGoal);
+        sections.push('');
+    }
+    if (epic.currentPhase) {
+        sections.push(`**Current Phase:** ${epic.currentPhase}`);
+        sections.push('');
+    }
+    if (epic.inScope && epic.inScope.length > 0) {
+        sections.push('**In Scope:**');
+        for (const item of epic.inScope){
+            sections.push(`- ${item}`);
+        }
+        sections.push('');
+    }
+    if (epic.outOfScope && epic.outOfScope.length > 0) {
+        sections.push('**Out of Scope:**');
+        for (const item of epic.outOfScope){
+            sections.push(`- ${item}`);
+        }
+        sections.push('');
+    }
+    if (epic.references && epic.references.length > 0) {
+        sections.push('**References:**');
+        for (const ref of epic.references){
+            sections.push(`- ${ref}`);
+        }
+        sections.push('');
+    }
+    return sections.join('\n');
+}
 function parseArgs(args) {
     const subcommand = args[0] || 'stats';
     let query;