claude-flow-novice 2.6.0 → 2.9.0

package/dist/cli/conversation-fork.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/conversation-fork.ts"],"sourcesContent":["/**\r\n * Conversation Fork Management\r\n *\r\n * Implements application-level conversation forking for CFN Loop iterations.\r\n * Stores conversation history in Redis and allows branching at specific points.\r\n *\r\n * Sprint 4: Conversation Forking (v2.7.0)\r\n */\r\n\r\nimport { execSync } from 'child_process';\r\nimport { randomBytes } from 'crypto';\r\n\r\nexport interface Message {\r\n  role: 'user' | 'assistant';\r\n  content: string;\r\n  iteration: number;\r\n  timestamp: string;\r\n}\r\n\r\nexport interface ForkMetadata {\r\n  forkId: string;\r\n  taskId: string;\r\n  agentId: string;\r\n  createdAt: string;\r\n  parentIteration: number;\r\n  messageCount: number;\r\n}\r\n\r\n/**\r\n * Store a message in conversation history\r\n */\r\nexport async function storeMessage(\r\n  taskId: string,\r\n  agentId: string,\r\n  message: Message\r\n): Promise<void> {\r\n  const key = `swarm:${taskId}:${agentId}:messages`;\r\n  const messageJson = JSON.stringify(message);\r\n\r\n  try {\r\n    execSync(`redis-cli rpush \"${key}\" '${messageJson.replace(/'/g, \"'\\\\''\")}'`, {\r\n      encoding: 'utf8'\r\n    });\r\n  } catch (error) {\r\n    console.error(`[conversation-fork] Failed to store message:`, error);\r\n    throw error;\r\n  }\r\n}\r\n\r\n/**\r\n * Load all messages from conversation history\r\n */\r\nexport async function loadMessages(\r\n  taskId: string,\r\n  agentId: string,\r\n  forkId?: string\r\n): Promise<Message[]> {\r\n  const key = forkId\r\n    ? `swarm:${taskId}:${agentId}:fork:${forkId}:messages`\r\n    : `swarm:${taskId}:${agentId}:messages`;\r\n\r\n  try {\r\n    const output = execSync(`redis-cli lrange \"${key}\" 0 -1`, {\r\n      encoding: 'utf8'\r\n    }).trim();\r\n\r\n    if (!output || output === '(empty array)') {\r\n      return [];\r\n    }\r\n\r\n    // Redis returns each message on a new line\r\n    const lines = output.split('\\n');\r\n    return lines.map(line => JSON.parse(line));\r\n  } catch (error) {\r\n    console.error(`[conversation-fork] Failed to load messages:`, error);\r\n    return [];\r\n  }\r\n}\r\n\r\n/**\r\n * Create a fork from current conversation state\r\n * Copies all messages up to current iteration\r\n */\r\nexport async function createFork(\r\n  taskId: string,\r\n  agentId: string,\r\n  currentIteration: number\r\n): Promise<string> {\r\n  // Generate unique fork ID\r\n  const forkId = `fork-${currentIteration}-${randomBytes(4).toString('hex')}`;\r\n\r\n  // Load messages up to current iteration\r\n  const messages = await loadMessages(taskId, agentId);\r\n  const forkMessages = messages.filter(m => m.iteration <= currentIteration);\r\n\r\n  if (forkMessages.length === 0) {\r\n    throw new Error(`No messages found for iteration ${currentIteration}`);\r\n  }\r\n\r\n  // Store fork snapshot\r\n  const forkKey = `swarm:${taskId}:${agentId}:fork:${forkId}:messages`;\r\n\r\n  for (const message of forkMessages) {\r\n    const messageJson = JSON.stringify(message);\r\n    execSync(`redis-cli rpush \"${forkKey}\" '${messageJson.replace(/'/g, \"'\\\\''\")}'`, {\r\n      encoding: 'utf8'\r\n    });\r\n  }\r\n\r\n  // Store fork metadata\r\n  const metadata: ForkMetadata = {\r\n    forkId,\r\n    taskId,\r\n    agentId,\r\n    createdAt: new Date().toISOString(),\r\n    parentIteration: currentIteration,\r\n    messageCount: forkMessages.length\r\n  };\r\n\r\n  const metaKey = `swarm:${taskId}:${agentId}:fork:${forkId}:meta`;\r\n  execSync(`redis-cli setex \"${metaKey}\" 86400 '${JSON.stringify(metadata)}'`, {\r\n    encoding: 'utf8'\r\n  });\r\n\r\n  // Set as current fork\r\n  const currentForkKey = `swarm:${taskId}:${agentId}:current-fork`;\r\n  execSync(`redis-cli setex \"${currentForkKey}\" 86400 \"${forkId}\"`, {\r\n    encoding: 'utf8'\r\n  });\r\n\r\n  console.log(`[conversation-fork] Created fork ${forkId} with ${forkMessages.length} messages`);\r\n\r\n  return forkId;\r\n}\r\n\r\n/**\r\n * Get current active fork ID\r\n */\r\nexport async function getCurrentFork(\r\n  taskId: string,\r\n  agentId: string\r\n): Promise<string | null> {\r\n  const key = `swarm:${taskId}:${agentId}:current-fork`;\r\n\r\n  try {\r\n    const forkId = execSync(`redis-cli get \"${key}\"`, {\r\n      encoding: 'utf8'\r\n    }).trim();\r\n\r\n    if (forkId === '(nil)' || !forkId) {\r\n      return null;\r\n    }\r\n\r\n    return forkId;\r\n  } catch (error) {\r\n    return null;\r\n  }\r\n}\r\n\r\n/**\r\n * Get fork metadata\r\n */\r\nexport async function getForkMetadata(\r\n  taskId: string,\r\n  agentId: string,\r\n  forkId: string\r\n): Promise<ForkMetadata | null> {\r\n  const key = `swarm:${taskId}:${agentId}:fork:${forkId}:meta`;\r\n\r\n  try {\r\n    const metaJson = execSync(`redis-cli get \"${key}\"`, {\r\n      encoding: 'utf8'\r\n    }).trim();\r\n\r\n    if (metaJson === '(nil)' || !metaJson) {\r\n      return null;\r\n    }\r\n\r\n    return JSON.parse(metaJson);\r\n  } catch (error) {\r\n    return null;\r\n  }\r\n}\r\n\r\n/**\r\n * List all forks for an agent\r\n */\r\nexport async function listForks(\r\n  taskId: string,\r\n  agentId: string\r\n): Promise<ForkMetadata[]> {\r\n  const pattern = `swarm:${taskId}:${agentId}:fork:*:meta`;\r\n\r\n  try {\r\n    const keys = execSync(`redis-cli keys \"${pattern}\"`, {\r\n      encoding: 'utf8'\r\n    }).trim().split('\\n').filter(k => k);\r\n\r\n    const forks: ForkMetadata[] = [];\r\n\r\n    for (const key of keys) {\r\n      const metaJson = execSync(`redis-cli get \"${key}\"`, {\r\n        encoding: 'utf8'\r\n      }).trim();\r\n\r\n      if (metaJson && metaJson !== '(nil)') {\r\n        forks.push(JSON.parse(metaJson));\r\n      }\r\n    }\r\n\r\n    return forks.sort((a, b) =>\r\n      new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()\r\n    );\r\n  } catch (error) {\r\n    console.error(`[conversation-fork] Failed to list forks:`, error);\r\n    return [];\r\n  }\r\n}\r\n\r\n/**\r\n * Delete a fork and its messages\r\n */\r\nexport async function deleteFork(\r\n  taskId: string,\r\n  agentId: string,\r\n  forkId: string\r\n): Promise<void> {\r\n  const messagesKey = `swarm:${taskId}:${agentId}:fork:${forkId}:messages`;\r\n  const metaKey = `swarm:${taskId}:${agentId}:fork:${forkId}:meta`;\r\n\r\n  try {\r\n    execSync(`redis-cli del \"${messagesKey}\" \"${metaKey}\"`, {\r\n      encoding: 'utf8'\r\n    });\r\n\r\n    console.log(`[conversation-fork] Deleted fork ${forkId}`);\r\n  } catch (error) {\r\n    console.error(`[conversation-fork] Failed to delete fork:`, error);\r\n    throw error;\r\n  }\r\n}\r\n\r\n/**\r\n * Clear current fork (start fresh conversation)\r\n */\r\nexport async function clearCurrentFork(\r\n  taskId: string,\r\n  agentId: string\r\n): Promise<void> {\r\n  const key = `swarm:${taskId}:${agentId}:current-fork`;\r\n\r\n  try {\r\n    execSync(`redis-cli del \"${key}\"`, {\r\n      encoding: 'utf8'\r\n    });\r\n  } catch (error) {\r\n    console.error(`[conversation-fork] Failed to clear current fork:`, error);\r\n  }\r\n}\r\n\r\n/**\r\n * Format messages for Anthropic API\r\n */\r\nexport function formatMessagesForAPI(messages: Message[]): Array<{role: string, content: string}> {\r\n  return messages.map(m => ({\r\n    role: m.role,\r\n    content: m.content\r\n  }));\r\n}\r\n\r\n/**\r\n * Get conversation statistics\r\n */\r\nexport async function getConversationStats(\r\n  taskId: string,\r\n  agentId: string,\r\n  forkId?: string\r\n): Promise<{\r\n  messageCount: number;\r\n  userMessages: number;\r\n  assistantMessages: number;\r\n  iterations: number;\r\n  firstMessage: string | null;\r\n  lastMessage: string | null;\r\n}> {\r\n  const messages = await loadMessages(taskId, agentId, forkId);\r\n\r\n  if (messages.length === 0) {\r\n    return {\r\n      messageCount: 0,\r\n      userMessages: 0,\r\n      assistantMessages: 0,\r\n      iterations: 0,\r\n      firstMessage: null,\r\n      lastMessage: null\r\n    };\r\n  }\r\n\r\n  const userMessages = messages.filter(m => m.role === 'user').length;\r\n  const assistantMessages = messages.filter(m => m.role === 'assistant').length;\r\n  const iterations = Math.max(...messages.map(m => m.iteration));\r\n\r\n  return {\r\n    messageCount: messages.length,\r\n    userMessages,\r\n    assistantMessages,\r\n    iterations,\r\n    firstMessage: messages[0].timestamp,\r\n    lastMessage: messages[messages.length - 1].timestamp\r\n  };\r\n}\r\n"],"names":["execSync","randomBytes","storeMessage","taskId","agentId","message","key","messageJson","JSON","stringify","replace","encoding","error","console","loadMessages","forkId","output","trim","lines","split","map","line","parse","createFork","currentIteration","toString","messages","forkMessages","filter","m","iteration","length","Error","forkKey","metadata","createdAt","Date","toISOString","parentIteration","messageCount","metaKey","currentForkKey","log","getCurrentFork","getForkMetadata","metaJson","listForks","pattern","keys","k","forks","push","sort","a","b","getTime","deleteFork","messagesKey","clearCurrentFork","formatMessagesForAPI","role","content","getConversationStats","userMessages","assistantMessages","iterations","firstMessage","lastMessage","Math","max","timestamp"],"mappings":"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"}

package/dist/cli/index.js

@@ -27,6 +27,10 @@ import { agentCommand } from './agent-command.js';
                 options.iteration = parseInt(value, 10);
                 i++;
                 break;
+            case '--agent-id':
+                options.agentId = value;
+                i++;
+                break;
             case '--context':
                 options.context = value;
                 i++;

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\r\n/**\r\n * CLI Entry Point - v2.0\r\n *\r\n * Handles agent spawning commands:\r\n *   npx claude-flow-novice agent <type> [options]\r\n */\r\n\r\n// Load environment variables from .env file\r\nimport 'dotenv/config';\r\n\r\nimport { VERSION } from '../core/index.js';\r\nimport { agentCommand, AgentCommandOptions } from './agent-command.js';\r\n\r\n/**\r\n * Parse command line arguments\r\n */\r\nfunction parseArgs(args: string[]): { command: string; agentType?: string; options: AgentCommandOptions } {\r\n  const command = args[0] || 'help';\r\n  const agentType = args[1] && !args[1].startsWith('--') ? args[1] : undefined;\r\n  const options: AgentCommandOptions = {};\r\n\r\n  // Parse options\r\n  for (let i = agentType ? 2 : 1; i < args.length; i++) {\r\n    const arg = args[i];\r\n    const value = args[i + 1];\r\n\r\n    switch (arg) {\r\n      case '--task-id':\r\n        options.taskId = value;\r\n        i++;\r\n        break;\r\n      case '--iteration':\r\n        options.iteration = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--context':\r\n        options.context = value;\r\n        i++;\r\n        break;\r\n      case '--mode':\r\n        options.mode = value;\r\n        i++;\r\n        break;\r\n      case '--priority':\r\n        options.priority = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--parent-task-id':\r\n        options.parentTaskId = value;\r\n        i++;\r\n        break;\r\n      case '--list':\r\n        options.list = true;\r\n        break;\r\n      case '--help':\r\n      case '-h':\r\n        options.help = true;\r\n        break;\r\n    }\r\n  }\r\n\r\n  return { command, agentType, options };\r\n}\r\n\r\n/**\r\n * Display main CLI help\r\n */\r\nfunction displayHelp(): void {\r\n  console.log(`\r\nClaude Flow Novice CLI v${VERSION}\r\n\r\nUsage:\r\n  npx claude-flow-novice <command> [options]\r\n\r\nCommands:\r\n  agent <type> [options]    Spawn an agent for task execution\r\n  --version                 Show version number\r\n  --help                    Show this help message\r\n\r\nExamples:\r\n  # Spawn an agent\r\n  npx claude-flow-novice agent coder --context \"Implement feature\"\r\n\r\n  # List available agents\r\n  npx claude-flow-novice agent --list\r\n\r\n  # Show version\r\n  npx claude-flow-novice --version\r\n\r\nFor more information:\r\n  https://github.com/yourusername/claude-flow-novice\r\n`);\r\n}\r\n\r\n/**\r\n * Main CLI entry point\r\n */\r\nasync function main() {\r\n  const args = process.argv.slice(2);\r\n\r\n  // Handle version flag\r\n  if (args.includes('--version') || args.includes('-v')) {\r\n    console.log(`Claude Flow Novice v${VERSION}`);\r\n    return;\r\n  }\r\n\r\n  // Handle help flag\r\n  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {\r\n    displayHelp();\r\n    return;\r\n  }\r\n\r\n  const { command, agentType, options } = parseArgs(args);\r\n\r\n  switch (command) {\r\n    case 'agent':\r\n      await agentCommand(agentType, options);\r\n      break;\r\n\r\n    default:\r\n      console.error(`Unknown command: ${command}`);\r\n      console.log('Run with --help for usage information');\r\n      process.exit(1);\r\n  }\r\n}\r\n\r\n// Run CLI\r\nmain().catch((error) => {\r\n  console.error('[claude-flow-novice] Fatal error:', error);\r\n  process.exit(1);\r\n});\r\n"],"names":["VERSION","agentCommand","parseArgs","args","command","agentType","startsWith","undefined","options","i","length","arg","value","taskId","iteration","parseInt","context","mode","priority","parentTaskId","list","help","displayHelp","console","log","main","process","argv","slice","includes","error","exit","catch"],"mappings":";AACA;;;;;CAKC,GAED,4CAA4C;AAC5C,OAAO,gBAAgB;AAEvB,SAASA,OAAO,QAAQ,mBAAmB;AAC3C,SAASC,YAAY,QAA6B,qBAAqB;AAEvE;;CAEC,GACD,SAASC,UAAUC,IAAc;IAC/B,MAAMC,UAAUD,IAAI,CAAC,EAAE,IAAI;IAC3B,MAAME,YAAYF,IAAI,CAAC,EAAE,IAAI,CAACA,IAAI,CAAC,EAAE,CAACG,UAAU,CAAC,QAAQH,IAAI,CAAC,EAAE,GAAGI;IACnE,MAAMC,UAA+B,CAAC;IAEtC,gBAAgB;IAChB,IAAK,IAAIC,IAAIJ,YAAY,IAAI,GAAGI,IAAIN,KAAKO,MAAM,EAAED,IAAK;QACpD,MAAME,MAAMR,IAAI,CAACM,EAAE;QACnB,MAAMG,QAAQT,IAAI,CAACM,IAAI,EAAE;QAEzB,OAAQE;YACN,KAAK;gBACHH,QAAQK,MAAM,GAAGD;gBACjBH;gBACA;YACF,KAAK;gBACHD,QAAQM,SAAS,GAAGC,SAASH,OAAO;gBACpCH;gBACA;YACF,KAAK;gBACHD,QAAQQ,OAAO,GAAGJ;gBAClBH;gBACA;YACF,KAAK;gBACHD,QAAQS,IAAI,GAAGL;gBACfH;gBACA;YACF,KAAK;gBACHD,QAAQU,QAAQ,GAAGH,SAASH,OAAO;gBACnCH;gBACA;YACF,KAAK;gBACHD,QAAQW,YAAY,GAAGP;gBACvBH;gBACA;YACF,KAAK;gBACHD,QAAQY,IAAI,GAAG;gBACf;YACF,KAAK;YACL,KAAK;gBACHZ,QAAQa,IAAI,GAAG;gBACf;QACJ;IACF;IAEA,OAAO;QAAEjB;QAASC;QAAWG;IAAQ;AACvC;AAEA;;CAEC,GACD,SAASc;IACPC,QAAQC,GAAG,CAAC,CAAC;wBACS,EAAExB,QAAQ;;;;;;;;;;;;;;;;;;;;;;AAsBlC,CAAC;AACD;AAEA;;CAEC,GACD,eAAeyB;IACb,MAAMtB,OAAOuB,QAAQC,IAAI,CAACC,KAAK,CAAC;IAEhC,sBAAsB;IACtB,IAAIzB,KAAK0B,QAAQ,CAAC,gBAAgB1B,KAAK0B,QAAQ,CAAC,OAAO;QACrDN,QAAQC,GAAG,CAAC,CAAC,oBAAoB,EAAExB,SAAS;QAC5C;IACF;IAEA,mBAAmB;IACnB,IAAIG,KAAKO,MAAM,KAAK,KAAKP,KAAK0B,QAAQ,CAAC,aAAa1B,KAAK0B,QAAQ,CAAC,OAAO;QACvEP;QACA;IACF;IAEA,MAAM,EAAElB,OAAO,EAAEC,SAAS,EAAEG,OAAO,EAAE,GAAGN,UAAUC;IAElD,OAAQC;QACN,KAAK;YACH,MAAMH,aAAaI,WAAWG;YAC9B;QAEF;YACEe,QAAQO,KAAK,CAAC,CAAC,iBAAiB,EAAE1B,SAAS;YAC3CmB,QAAQC,GAAG,CAAC;YACZE,QAAQK,IAAI,CAAC;IACjB;AACF;AAEA,UAAU;AACVN,OAAOO,KAAK,CAAC,CAACF;IACZP,QAAQO,KAAK,CAAC,qCAAqCA;IACnDJ,QAAQK,IAAI,CAAC;AACf"}
+{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\r\n/**\r\n * CLI Entry Point - v2.0\r\n *\r\n * Handles agent spawning commands:\r\n *   npx claude-flow-novice agent <type> [options]\r\n */\r\n\r\n// Load environment variables from .env file\r\nimport 'dotenv/config';\r\n\r\nimport { VERSION } from '../core/index.js';\r\nimport { agentCommand, AgentCommandOptions } from './agent-command.js';\r\n\r\n/**\r\n * Parse command line arguments\r\n */\r\nfunction parseArgs(args: string[]): { command: string; agentType?: string; options: AgentCommandOptions } {\r\n  const command = args[0] || 'help';\r\n  const agentType = args[1] && !args[1].startsWith('--') ? args[1] : undefined;\r\n  const options: AgentCommandOptions = {};\r\n\r\n  // Parse options\r\n  for (let i = agentType ? 2 : 1; i < args.length; i++) {\r\n    const arg = args[i];\r\n    const value = args[i + 1];\r\n\r\n    switch (arg) {\r\n      case '--task-id':\r\n        options.taskId = value;\r\n        i++;\r\n        break;\r\n      case '--iteration':\r\n        options.iteration = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--agent-id':\r\n        options.agentId = value;\r\n        i++;\r\n        break;\r\n      case '--context':\r\n        options.context = value;\r\n        i++;\r\n        break;\r\n      case '--mode':\r\n        options.mode = value;\r\n        i++;\r\n        break;\r\n      case '--priority':\r\n        options.priority = parseInt(value, 10);\r\n        i++;\r\n        break;\r\n      case '--parent-task-id':\r\n        options.parentTaskId = value;\r\n        i++;\r\n        break;\r\n      case '--list':\r\n        options.list = true;\r\n        break;\r\n      case '--help':\r\n      case '-h':\r\n        options.help = true;\r\n        break;\r\n    }\r\n  }\r\n\r\n  return { command, agentType, options };\r\n}\r\n\r\n/**\r\n * Display main CLI help\r\n */\r\nfunction displayHelp(): void {\r\n  console.log(`\r\nClaude Flow Novice CLI v${VERSION}\r\n\r\nUsage:\r\n  npx claude-flow-novice <command> [options]\r\n\r\nCommands:\r\n  agent <type> [options]    Spawn an agent for task execution\r\n  --version                 Show version number\r\n  --help                    Show this help message\r\n\r\nExamples:\r\n  # Spawn an agent\r\n  npx claude-flow-novice agent coder --context \"Implement feature\"\r\n\r\n  # List available agents\r\n  npx claude-flow-novice agent --list\r\n\r\n  # Show version\r\n  npx claude-flow-novice --version\r\n\r\nFor more information:\r\n  https://github.com/yourusername/claude-flow-novice\r\n`);\r\n}\r\n\r\n/**\r\n * Main CLI entry point\r\n */\r\nasync function main() {\r\n  const args = process.argv.slice(2);\r\n\r\n  // Handle version flag\r\n  if (args.includes('--version') || args.includes('-v')) {\r\n    console.log(`Claude Flow Novice v${VERSION}`);\r\n    return;\r\n  }\r\n\r\n  // Handle help flag\r\n  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {\r\n    displayHelp();\r\n    return;\r\n  }\r\n\r\n  const { command, agentType, options } = parseArgs(args);\r\n\r\n  switch (command) {\r\n    case 'agent':\r\n      await agentCommand(agentType, options);\r\n      break;\r\n\r\n    default:\r\n      console.error(`Unknown command: ${command}`);\r\n      console.log('Run with --help for usage information');\r\n      process.exit(1);\r\n  }\r\n}\r\n\r\n// Run CLI\r\nmain().catch((error) => {\r\n  console.error('[claude-flow-novice] Fatal error:', error);\r\n  process.exit(1);\r\n});\r\n"],"names":["VERSION","agentCommand","parseArgs","args","command","agentType","startsWith","undefined","options","i","length","arg","value","taskId","iteration","parseInt","agentId","context","mode","priority","parentTaskId","list","help","displayHelp","console","log","main","process","argv","slice","includes","error","exit","catch"],"mappings":";AACA;;;;;CAKC,GAED,4CAA4C;AAC5C,OAAO,gBAAgB;AAEvB,SAASA,OAAO,QAAQ,mBAAmB;AAC3C,SAASC,YAAY,QAA6B,qBAAqB;AAEvE;;CAEC,GACD,SAASC,UAAUC,IAAc;IAC/B,MAAMC,UAAUD,IAAI,CAAC,EAAE,IAAI;IAC3B,MAAME,YAAYF,IAAI,CAAC,EAAE,IAAI,CAACA,IAAI,CAAC,EAAE,CAACG,UAAU,CAAC,QAAQH,IAAI,CAAC,EAAE,GAAGI;IACnE,MAAMC,UAA+B,CAAC;IAEtC,gBAAgB;IAChB,IAAK,IAAIC,IAAIJ,YAAY,IAAI,GAAGI,IAAIN,KAAKO,MAAM,EAAED,IAAK;QACpD,MAAME,MAAMR,IAAI,CAACM,EAAE;QACnB,MAAMG,QAAQT,IAAI,CAACM,IAAI,EAAE;QAEzB,OAAQE;YACN,KAAK;gBACHH,QAAQK,MAAM,GAAGD;gBACjBH;gBACA;YACF,KAAK;gBACHD,QAAQM,SAAS,GAAGC,SAASH,OAAO;gBACpCH;gBACA;YACF,KAAK;gBACHD,QAAQQ,OAAO,GAAGJ;gBAClBH;gBACA;YACF,KAAK;gBACHD,QAAQS,OAAO,GAAGL;gBAClBH;gBACA;YACF,KAAK;gBACHD,QAAQU,IAAI,GAAGN;gBACfH;gBACA;YACF,KAAK;gBACHD,QAAQW,QAAQ,GAAGJ,SAASH,OAAO;gBACnCH;gBACA;YACF,KAAK;gBACHD,QAAQY,YAAY,GAAGR;gBACvBH;gBACA;YACF,KAAK;gBACHD,QAAQa,IAAI,GAAG;gBACf;YACF,KAAK;YACL,KAAK;gBACHb,QAAQc,IAAI,GAAG;gBACf;QACJ;IACF;IAEA,OAAO;QAAElB;QAASC;QAAWG;IAAQ;AACvC;AAEA;;CAEC,GACD,SAASe;IACPC,QAAQC,GAAG,CAAC,CAAC;wBACS,EAAEzB,QAAQ;;;;;;;;;;;;;;;;;;;;;;AAsBlC,CAAC;AACD;AAEA;;CAEC,GACD,eAAe0B;IACb,MAAMvB,OAAOwB,QAAQC,IAAI,CAACC,KAAK,CAAC;IAEhC,sBAAsB;IACtB,IAAI1B,KAAK2B,QAAQ,CAAC,gBAAgB3B,KAAK2B,QAAQ,CAAC,OAAO;QACrDN,QAAQC,GAAG,CAAC,CAAC,oBAAoB,EAAEzB,SAAS;QAC5C;IACF;IAEA,mBAAmB;IACnB,IAAIG,KAAKO,MAAM,KAAK,KAAKP,KAAK2B,QAAQ,CAAC,aAAa3B,KAAK2B,QAAQ,CAAC,OAAO;QACvEP;QACA;IACF;IAEA,MAAM,EAAEnB,OAAO,EAAEC,SAAS,EAAEG,OAAO,EAAE,GAAGN,UAAUC;IAElD,OAAQC;QACN,KAAK;YACH,MAAMH,aAAaI,WAAWG;YAC9B;QAEF;YACEgB,QAAQO,KAAK,CAAC,CAAC,iBAAiB,EAAE3B,SAAS;YAC3CoB,QAAQC,GAAG,CAAC;YACZE,QAAQK,IAAI,CAAC;IACjB;AACF;AAEA,UAAU;AACVN,OAAOO,KAAK,CAAC,CAACF;IACZP,QAAQO,KAAK,CAAC,qCAAqCA;IACnDJ,QAAQK,IAAI,CAAC;AACf"}

package/dist/cli/init-command.js

@@ -0,0 +1,20 @@
+import { fileURLToPath } from 'url';
+import path from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export async function registerInitCommand(program) {
+    program.command('init').description('Initialize Claude Flow Novice CFN project').action(async ()=>{
+        try {
+            // Dynamically import the init-project script
+            const { default: initializeCfnProject } = await import(path.resolve(__dirname, '../../scripts/init-project.js'));
+            // Execute initialization
+            await initializeCfnProject();
+        } catch (error) {
+            console.error('CFN Initialization Error:', error);
+            process.exit(1);
+        }
+    });
+}
+export default registerInitCommand;
+
+//# sourceMappingURL=init-command.js.map

package/dist/cli/init-command.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/init-command.ts"],"sourcesContent":["import { Command } from 'commander';\r\nimport { fileURLToPath } from 'url';\r\nimport path from 'path';\r\n\r\nconst __filename = fileURLToPath(import.meta.url);\r\nconst __dirname = path.dirname(__filename);\r\n\r\nexport async function registerInitCommand(program: Command) {\r\n  program\r\n    .command('init')\r\n    .description('Initialize Claude Flow Novice CFN project')\r\n    .action(async () => {\r\n      try {\r\n        // Dynamically import the init-project script\r\n        const { default: initializeCfnProject } = await import(\r\n          path.resolve(__dirname, '../../scripts/init-project.js')\r\n        );\r\n\r\n        // Execute initialization\r\n        await initializeCfnProject();\r\n      } catch (error) {\r\n        console.error('CFN Initialization Error:', error);\r\n        process.exit(1);\r\n      }\r\n    });\r\n}\r\n\r\nexport default registerInitCommand;"],"names":["fileURLToPath","path","__filename","url","__dirname","dirname","registerInitCommand","program","command","description","action","default","initializeCfnProject","resolve","error","console","process","exit"],"mappings":"AACA,SAASA,aAAa,QAAQ,MAAM;AACpC,OAAOC,UAAU,OAAO;AAExB,MAAMC,aAAaF,cAAc,YAAYG,GAAG;AAChD,MAAMC,YAAYH,KAAKI,OAAO,CAACH;AAE/B,OAAO,eAAeI,oBAAoBC,OAAgB;IACxDA,QACGC,OAAO,CAAC,QACRC,WAAW,CAAC,6CACZC,MAAM,CAAC;QACN,IAAI;YACF,6CAA6C;YAC7C,MAAM,EAAEC,SAASC,oBAAoB,EAAE,GAAG,MAAM,MAAM,CACpDX,KAAKY,OAAO,CAACT,WAAW;YAG1B,yBAAyB;YACzB,MAAMQ;QACR,EAAE,OAAOE,OAAO;YACdC,QAAQD,KAAK,CAAC,6BAA6BA;YAC3CE,QAAQC,IAAI,CAAC;QACf;IACF;AACJ;AAEA,eAAeX,oBAAoB"}

package/dist/cli/tool-definitions.js

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

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/tool-definitions.ts"],"sourcesContent":["/**\r\n * Tool Definitions for CLI-Spawned Agents\r\n *\r\n * Converts agent markdown tool names to Anthropic API tool definitions.\r\n * Implements core tools: Read, Write, Edit, Bash, TodoWrite\r\n */\r\n\r\nexport interface ToolDefinition {\r\n  name: string;\r\n  description: string;\r\n  input_schema: {\r\n    type: 'object';\r\n    properties: Record<string, any>;\r\n    required: string[];\r\n  };\r\n}\r\n\r\n/**\r\n * Tool registry mapping agent tool names to Anthropic API format\r\n */\r\nconst TOOL_REGISTRY: Record<string, ToolDefinition> = {\r\n  Read: {\r\n    name: 'Read',\r\n    description: 'Reads a file from the local filesystem. Can access any file by absolute path.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        file_path: {\r\n          type: 'string',\r\n          description: 'The absolute path to the file to read'\r\n        },\r\n        limit: {\r\n          type: 'number',\r\n          description: 'Optional: The number of lines to read (for large files)'\r\n        },\r\n        offset: {\r\n          type: 'number',\r\n          description: 'Optional: The line number to start reading from'\r\n        }\r\n      },\r\n      required: ['file_path']\r\n    }\r\n  },\r\n\r\n  Write: {\r\n    name: 'Write',\r\n    description: 'Writes content to a file. Creates new file or overwrites existing file.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        file_path: {\r\n          type: 'string',\r\n          description: 'The absolute path to the file to write (must be absolute, not relative)'\r\n        },\r\n        content: {\r\n          type: 'string',\r\n          description: 'The content to write to the file'\r\n        }\r\n      },\r\n      required: ['file_path', 'content']\r\n    }\r\n  },\r\n\r\n  Edit: {\r\n    name: 'Edit',\r\n    description: 'Performs exact string replacement in files. Must read file first before editing.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        file_path: {\r\n          type: 'string',\r\n          description: 'The absolute path to the file to modify'\r\n        },\r\n        old_string: {\r\n          type: 'string',\r\n          description: 'The exact text to replace (must be unique in file)'\r\n        },\r\n        new_string: {\r\n          type: 'string',\r\n          description: 'The text to replace it with'\r\n        },\r\n        replace_all: {\r\n          type: 'boolean',\r\n          description: 'Optional: Replace all occurrences (default false)'\r\n        }\r\n      },\r\n      required: ['file_path', 'old_string', 'new_string']\r\n    }\r\n  },\r\n\r\n  Bash: {\r\n    name: 'Bash',\r\n    description: 'Executes bash commands in a persistent shell session. For terminal operations like git, npm, docker.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        command: {\r\n          type: 'string',\r\n          description: 'The bash command to execute'\r\n        },\r\n        description: {\r\n          type: 'string',\r\n          description: 'Clear, concise description of what this command does (5-10 words)'\r\n        },\r\n        timeout: {\r\n          type: 'number',\r\n          description: 'Optional timeout in milliseconds (max 600000, default 120000)'\r\n        },\r\n        run_in_background: {\r\n          type: 'boolean',\r\n          description: 'Optional: Run command in background (default false)'\r\n        }\r\n      },\r\n      required: ['command']\r\n    }\r\n  },\r\n\r\n  TodoWrite: {\r\n    name: 'TodoWrite',\r\n    description: 'Creates and manages structured task list for tracking progress.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        todos: {\r\n          type: 'array',\r\n          description: 'Array of todo items with content, status, and activeForm',\r\n          items: {\r\n            type: 'object',\r\n            properties: {\r\n              content: {\r\n                type: 'string',\r\n                description: 'Task description in imperative form (e.g., \"Run tests\")'\r\n              },\r\n              status: {\r\n                type: 'string',\r\n                enum: ['pending', 'in_progress', 'completed'],\r\n                description: 'Task status'\r\n              },\r\n              activeForm: {\r\n                type: 'string',\r\n                description: 'Present continuous form shown during execution (e.g., \"Running tests\")'\r\n              }\r\n            },\r\n            required: ['content', 'status', 'activeForm']\r\n          }\r\n        }\r\n      },\r\n      required: ['todos']\r\n    }\r\n  },\r\n\r\n  Glob: {\r\n    name: 'Glob',\r\n    description: 'Fast file pattern matching. Supports glob patterns like \"**/*.js\".',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        pattern: {\r\n          type: 'string',\r\n          description: 'The glob pattern to match files against'\r\n        },\r\n        path: {\r\n          type: 'string',\r\n          description: 'Optional: Directory to search in (defaults to current working directory)'\r\n        }\r\n      },\r\n      required: ['pattern']\r\n    }\r\n  },\r\n\r\n  Grep: {\r\n    name: 'Grep',\r\n    description: 'Powerful search tool built on ripgrep. Supports regex patterns.',\r\n    input_schema: {\r\n      type: 'object',\r\n      properties: {\r\n        pattern: {\r\n          type: 'string',\r\n          description: 'The regular expression pattern to search for'\r\n        },\r\n        path: {\r\n          type: 'string',\r\n          description: 'Optional: File or directory to search in'\r\n        },\r\n        output_mode: {\r\n          type: 'string',\r\n          enum: ['content', 'files_with_matches', 'count'],\r\n          description: 'Output mode (default: files_with_matches)'\r\n        },\r\n        glob: {\r\n          type: 'string',\r\n          description: 'Optional: Glob pattern to filter files'\r\n        },\r\n        type: {\r\n          type: 'string',\r\n          description: 'Optional: File type (js, py, rust, etc.)'\r\n        },\r\n        '-i': {\r\n          type: 'boolean',\r\n          description: 'Case insensitive search'\r\n        },\r\n        '-n': {\r\n          type: 'boolean',\r\n          description: 'Show line numbers (requires output_mode: content)'\r\n        },\r\n        '-A': {\r\n          type: 'number',\r\n          description: 'Lines to show after match (requires output_mode: content)'\r\n        },\r\n        '-B': {\r\n          type: 'number',\r\n          description: 'Lines to show before match (requires output_mode: content)'\r\n        },\r\n        '-C': {\r\n          type: 'number',\r\n          description: 'Lines to show before and after match (requires output_mode: content)'\r\n        }\r\n      },\r\n      required: ['pattern']\r\n    }\r\n  }\r\n};\r\n\r\n/**\r\n * Convert agent tool names to Anthropic API tool definitions\r\n */\r\nexport function convertToolNames(toolNames: string[]): ToolDefinition[] {\r\n  const definitions: ToolDefinition[] = [];\r\n\r\n  for (const toolName of toolNames) {\r\n    const definition = TOOL_REGISTRY[toolName];\r\n    if (definition) {\r\n      definitions.push(definition);\r\n    } else {\r\n      console.warn(`[tool-definitions] Unknown tool: ${toolName}`);\r\n    }\r\n  }\r\n\r\n  return definitions;\r\n}\r\n\r\n/**\r\n * Get tool definition by name\r\n */\r\nexport function getToolDefinition(toolName: string): ToolDefinition | undefined {\r\n  return TOOL_REGISTRY[toolName];\r\n}\r\n\r\n/**\r\n * Check if tool name is valid\r\n */\r\nexport function isValidTool(toolName: string): boolean {\r\n  return toolName in TOOL_REGISTRY;\r\n}\r\n\r\n/**\r\n * Get all available tool names\r\n */\r\nexport function getAvailableTools(): string[] {\r\n  return Object.keys(TOOL_REGISTRY);\r\n}\r\n"],"names":["TOOL_REGISTRY","Read","name","description","input_schema","type","properties","file_path","limit","offset","required","Write","content","Edit","old_string","new_string","replace_all","Bash","command","timeout","run_in_background","TodoWrite","todos","items","status","enum","activeForm","Glob","pattern","path","Grep","output_mode","glob","convertToolNames","toolNames","definitions","toolName","definition","push","console","warn","getToolDefinition","isValidTool","getAvailableTools","Object","keys"],"mappings":"AAAA;;;;;CAKC,GAYD;;CAEC,GACD,MAAMA,gBAAgD;IACpDC,MAAM;QACJC,MAAM;QACNC,aAAa;QACbC,cAAc;YACZC,MAAM;YACNC,YAAY;gBACVC,WAAW;oBACTF,MAAM;oBACNF,aAAa;gBACf;gBACAK,OAAO;oBACLH,MAAM;oBACNF,aAAa;gBACf;gBACAM,QAAQ;oBACNJ,MAAM;oBACNF,aAAa;gBACf;YACF;YACAO,UAAU;gBAAC;aAAY;QACzB;IACF;IAEAC,OAAO;QACLT,MAAM;QACNC,aAAa;QACbC,cAAc;YACZC,MAAM;YACNC,YAAY;gBACVC,WAAW;oBACTF,MAAM;oBACNF,aAAa;gBACf;gBACAS,SAAS;oBACPP,MAAM;oBACNF,aAAa;gBACf;YACF;YACAO,UAAU;gBAAC;gBAAa;aAAU;QACpC;IACF;IAEAG,MAAM;QACJX,MAAM;QACNC,aAAa;QACbC,cAAc;YACZC,MAAM;YACNC,YAAY;gBACVC,WAAW;oBACTF,MAAM;oBACNF,aAAa;gBACf;gBACAW,YAAY;oBACVT,MAAM;oBACNF,aAAa;gBACf;gBACAY,YAAY;oBACVV,MAAM;oBACNF,aAAa;gBACf;gBACAa,aAAa;oBACXX,MAAM;oBACNF,aAAa;gBACf;YACF;YACAO,UAAU;gBAAC;gBAAa;gBAAc;aAAa;QACrD;IACF;IAEAO,MAAM;QACJf,MAAM;QACNC,aAAa;QACbC,cAAc;YACZC,MAAM;YACNC,YAAY;gBACVY,SAAS;oBACPb,MAAM;oBACNF,aAAa;gBACf;gBACAA,aAAa;oBACXE,MAAM;oBACNF,aAAa;gBACf;gBACAgB,SAAS;oBACPd,MAAM;oBACNF,aAAa;gBACf;gBACAiB,mBAAmB;oBACjBf,MAAM;oBACNF,aAAa;gBACf;YACF;YACAO,UAAU;gBAAC;aAAU;QACvB;IACF;IAEAW,WAAW;QACTnB,MAAM;QACNC,aAAa;QACbC,cAAc;YACZC,MAAM;YACNC,YAAY;gBACVgB,OAAO;oBACLjB,MAAM;oBACNF,aAAa;oBACboB,OAAO;wBACLlB,MAAM;wBACNC,YAAY;4BACVM,SAAS;gCACPP,MAAM;gCACNF,aAAa;4BACf;4BACAqB,QAAQ;gCACNnB,MAAM;gCACNoB,MAAM;oCAAC;oCAAW;oCAAe;iCAAY;gCAC7CtB,aAAa;4BACf;4BACAuB,YAAY;gCACVrB,MAAM;gCACNF,aAAa;4BACf;wBACF;wBACAO,UAAU;4BAAC;4BAAW;4BAAU;yBAAa;oBAC/C;gBACF;YACF;YACAA,UAAU;gBAAC;aAAQ;QACrB;IACF;IAEAiB,MAAM;QACJzB,MAAM;QACNC,aAAa;QACbC,cAAc;YACZC,MAAM;YACNC,YAAY;gBACVsB,SAAS;oBACPvB,MAAM;oBACNF,aAAa;gBACf;gBACA0B,MAAM;oBACJxB,MAAM;oBACNF,aAAa;gBACf;YACF;YACAO,UAAU;gBAAC;aAAU;QACvB;IACF;IAEAoB,MAAM;QACJ5B,MAAM;QACNC,aAAa;QACbC,cAAc;YACZC,MAAM;YACNC,YAAY;gBACVsB,SAAS;oBACPvB,MAAM;oBACNF,aAAa;gBACf;gBACA0B,MAAM;oBACJxB,MAAM;oBACNF,aAAa;gBACf;gBACA4B,aAAa;oBACX1B,MAAM;oBACNoB,MAAM;wBAAC;wBAAW;wBAAsB;qBAAQ;oBAChDtB,aAAa;gBACf;gBACA6B,MAAM;oBACJ3B,MAAM;oBACNF,aAAa;gBACf;gBACAE,MAAM;oBACJA,MAAM;oBACNF,aAAa;gBACf;gBACA,MAAM;oBACJE,MAAM;oBACNF,aAAa;gBACf;gBACA,MAAM;oBACJE,MAAM;oBACNF,aAAa;gBACf;gBACA,MAAM;oBACJE,MAAM;oBACNF,aAAa;gBACf;gBACA,MAAM;oBACJE,MAAM;oBACNF,aAAa;gBACf;gBACA,MAAM;oBACJE,MAAM;oBACNF,aAAa;gBACf;YACF;YACAO,UAAU;gBAAC;aAAU;QACvB;IACF;AACF;AAEA;;CAEC,GACD,OAAO,SAASuB,iBAAiBC,SAAmB;IAClD,MAAMC,cAAgC,EAAE;IAExC,KAAK,MAAMC,YAAYF,UAAW;QAChC,MAAMG,aAAarC,aAAa,CAACoC,SAAS;QAC1C,IAAIC,YAAY;YACdF,YAAYG,IAAI,CAACD;QACnB,OAAO;YACLE,QAAQC,IAAI,CAAC,CAAC,iCAAiC,EAAEJ,UAAU;QAC7D;IACF;IAEA,OAAOD;AACT;AAEA;;CAEC,GACD,OAAO,SAASM,kBAAkBL,QAAgB;IAChD,OAAOpC,aAAa,CAACoC,SAAS;AAChC;AAEA;;CAEC,GACD,OAAO,SAASM,YAAYN,QAAgB;IAC1C,OAAOA,YAAYpC;AACrB;AAEA;;CAEC,GACD,OAAO,SAAS2C;IACd,OAAOC,OAAOC,IAAI,CAAC7C;AACrB"}

package/dist/cli/tool-executor.js

@@ -0,0 +1,247 @@
+/**
+ * Tool Executor for CLI-Spawned Agents
+ *
+ * Executes tools requested by agents via Anthropic API tool_use blocks.
+ * Implements Read, Write, Edit, Bash, TodoWrite, Glob, Grep.
+ */ import fs from 'fs/promises';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { glob } from 'glob';
+const execAsync = promisify(exec);
+/**
+ * Execute a single tool and return result
+ */ export async function executeTool(toolUse) {
+    console.log(`[tool-executor] Executing tool: ${toolUse.name}`);
+    console.log(`[tool-executor] Tool use ID: ${toolUse.id}`);
+    try {
+        let result;
+        switch(toolUse.name){
+            case 'Read':
+                result = await executeRead(toolUse.input);
+                break;
+            case 'Write':
+                result = await executeWrite(toolUse.input);
+                break;
+            case 'Edit':
+                result = await executeEdit(toolUse.input);
+                break;
+            case 'Bash':
+                result = await executeBash(toolUse.input);
+                break;
+            case 'TodoWrite':
+                result = await executeTodoWrite(toolUse.input);
+                break;
+            case 'Glob':
+                result = await executeGlob(toolUse.input);
+                break;
+            case 'Grep':
+                result = await executeGrep(toolUse.input);
+                break;
+            default:
+                throw new Error(`Unknown tool: ${toolUse.name}`);
+        }
+        console.log(`[tool-executor] ✓ Tool executed successfully`);
+        return {
+            type: 'tool_result',
+            tool_use_id: toolUse.id,
+            content: result
+        };
+    } catch (error) {
+        console.error(`[tool-executor] ✗ Tool execution failed:`, error);
+        return {
+            type: 'tool_result',
+            tool_use_id: toolUse.id,
+            content: error instanceof Error ? error.message : String(error),
+            is_error: true
+        };
+    }
+}
+/**
+ * Execute Read tool
+ */ async function executeRead(input) {
+    const { file_path, offset, limit } = input;
+    if (!file_path) {
+        throw new Error('file_path parameter is required');
+    }
+    const content = await fs.readFile(file_path, 'utf-8');
+    const lines = content.split('\n');
+    // Apply offset and limit if provided
+    const startLine = offset ? Number(offset) - 1 : 0;
+    const endLine = limit ? startLine + Number(limit) : lines.length;
+    const selectedLines = lines.slice(startLine, endLine);
+    // Format with line numbers (cat -n style)
+    const formatted = selectedLines.map((line, idx)=>`${String(startLine + idx + 1).padStart(6)}→${line}`).join('\n');
+    return formatted;
+}
+/**
+ * Execute Write tool
+ */ async function executeWrite(input) {
+    const { file_path, content } = input;
+    if (!file_path) {
+        throw new Error('file_path parameter is required');
+    }
+    if (content === undefined) {
+        throw new Error('content parameter is required');
+    }
+    await fs.writeFile(file_path, content, 'utf-8');
+    return `File written successfully: ${file_path}`;
+}
+/**
+ * Execute Edit tool
+ */ async function executeEdit(input) {
+    const { file_path, old_string, new_string, replace_all } = input;
+    if (!file_path) {
+        throw new Error('file_path parameter is required');
+    }
+    if (!old_string) {
+        throw new Error('old_string parameter is required');
+    }
+    if (new_string === undefined) {
+        throw new Error('new_string parameter is required');
+    }
+    // Read file
+    const content = await fs.readFile(file_path, 'utf-8');
+    // Perform replacement
+    let newContent;
+    if (replace_all) {
+        // Replace all occurrences
+        newContent = content.split(old_string).join(new_string);
+    } else {
+        // Replace first occurrence only (must be unique)
+        const occurrences = content.split(old_string).length - 1;
+        if (occurrences === 0) {
+            throw new Error('old_string not found in file');
+        }
+        if (occurrences > 1) {
+            throw new Error(`old_string appears ${occurrences} times. Must be unique or use replace_all: true`);
+        }
+        newContent = content.replace(old_string, new_string);
+    }
+    // Write back
+    await fs.writeFile(file_path, newContent, 'utf-8');
+    return `File edited successfully: ${file_path}`;
+}
+/**
+ * Execute Bash tool
+ */ async function executeBash(input) {
+    const { command, timeout, run_in_background } = input;
+    if (!command) {
+        throw new Error('command parameter is required');
+    }
+    // DEBUG: Log bash command execution details
+    console.log(`[tool-executor] Bash command: ${command}`);
+    console.log(`[tool-executor] Timeout: ${timeout || 120000}ms`);
+    console.log(`[tool-executor] Background: ${run_in_background || false}`);
+    const timeoutMs = timeout ? Number(timeout) : 120000; // 2 minutes default
+    if (run_in_background) {
+        // Start background process and return immediately
+        exec(command);
+        return `Command started in background: ${command}`;
+    }
+    // Execute synchronously with timeout
+    const { stdout, stderr } = await execAsync(command, {
+        timeout: timeoutMs,
+        maxBuffer: 10 * 1024 * 1024 // 10MB buffer
+    });
+    return stdout + stderr;
+}
+/**
+ * Execute TodoWrite tool
+ */ async function executeTodoWrite(input) {
+    const { todos } = input;
+    if (!Array.isArray(todos)) {
+        throw new Error('todos parameter must be an array');
+    }
+    // Validate todo structure
+    for (const todo of todos){
+        if (!todo.content || !todo.status || !todo.activeForm) {
+            throw new Error('Each todo must have content, status, and activeForm');
+        }
+        if (![
+            'pending',
+            'in_progress',
+            'completed'
+        ].includes(todo.status)) {
+            throw new Error('Invalid status. Must be pending, in_progress, or completed');
+        }
+    }
+    // Format todos for display
+    const formatted = todos.map((todo, idx)=>{
+        const status = todo.status === 'completed' ? '✓' : todo.status === 'in_progress' ? '⚡' : '○';
+        return `${idx + 1}. [${status}] ${todo.content}`;
+    }).join('\n');
+    return `Todo list updated:\n${formatted}`;
+}
+/**
+ * Execute Glob tool
+ */ async function executeGlob(input) {
+    const { pattern, path } = input;
+    if (!pattern) {
+        throw new Error('pattern parameter is required');
+    }
+    const cwd = path || process.cwd();
+    const files = await glob(pattern, {
+        cwd,
+        nodir: true
+    });
+    if (files.length === 0) {
+        return 'No files found';
+    }
+    return files.join('\n');
+}
+/**
+ * Execute Grep tool
+ */ async function executeGrep(input) {
+    const { pattern, path, output_mode, glob: globPattern, type } = input;
+    if (!pattern) {
+        throw new Error('pattern parameter is required');
+    }
+    // Build ripgrep command
+    const args = [
+        'rg'
+    ];
+    // Output mode
+    if (output_mode === 'files_with_matches' || !output_mode) {
+        args.push('-l'); // List files with matches
+    } else if (output_mode === 'count') {
+        args.push('-c'); // Count matches per file
+    }
+    // Default is content (no flag)
+    // Optional flags
+    if (input['-i']) args.push('-i'); // Case insensitive
+    if (input['-n']) args.push('-n'); // Line numbers
+    if (input['-A']) args.push(`-A${input['-A']}`); // After context
+    if (input['-B']) args.push(`-B${input['-B']}`); // Before context
+    if (input['-C']) args.push(`-C${input['-C']}`); // Context
+    // File filtering
+    if (globPattern) args.push('--glob', globPattern);
+    if (type) args.push('--type', type);
+    // Pattern and path
+    args.push(pattern);
+    if (path) args.push(path);
+    const command = args.join(' ');
+    try {
+        const { stdout } = await execAsync(command, {
+            maxBuffer: 10 * 1024 * 1024 // 10MB buffer
+        });
+        return stdout || 'No matches found';
+    } catch (error) {
+        // ripgrep exits with code 1 if no matches found
+        if (error.code === 1) {
+            return 'No matches found';
+        }
+        throw error;
+    }
+}
+/**
+ * Execute multiple tools in sequence
+ */ export async function executeTools(toolUses) {
+    const results = [];
+    for (const toolUse of toolUses){
+        const result = await executeTool(toolUse);
+        results.push(result);
+    }
+    return results;
+}
+
+//# sourceMappingURL=tool-executor.js.map