claude-flow-novice 2.5.2 → 2.8.1

package/dist/cli/agent-executor.js

@@ -0,0 +1,310 @@
+/**
+ * Agent Executor
+ *
+ * Executes CLI-spawned agents by:
+ * 1. Checking custom routing configuration (z.ai vs Anthropic)
+ * 2. Invoking the appropriate API
+ * 3. Managing agent lifecycle and output
+ */ import { spawn } from 'child_process';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { getAgentId } from './agent-prompt-builder.js';
+import { buildCLIAgentSystemPrompt, loadContextFromEnv } from './cli-agent-context.js';
+import { loadMessages, storeMessage, getCurrentFork, formatMessagesForAPI } from './conversation-fork.js';
+import { convertToolNames } from './tool-definitions.js';
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+const execAsync = promisify(exec);
+/**
+ * Extract confidence score from agent output
+ * Looks for patterns like:
+ * - "confidence: 0.85"
+ * - "Confidence: 0.90"
+ * - "confidence score: 0.95"
+ * - "self-confidence: 0.88"
+ */ function extractConfidence(output) {
+    if (!output) return 0.85;
+    // Try multiple patterns
+    const patterns = [
+        /confidence:\s*([0-9.]+)/i,
+        /confidence\s+score:\s*([0-9.]+)/i,
+        /self-confidence:\s*([0-9.]+)/i,
+        /my\s+confidence:\s*([0-9.]+)/i
+    ];
+    for (const pattern of patterns){
+        const match = output.match(pattern);
+        if (match && match[1]) {
+            const score = parseFloat(match[1]);
+            if (score >= 0 && score <= 1) {
+                return score;
+            }
+        }
+    }
+    // Default to 0.85 if not found
+    return 0.85;
+}
+/**
+ * Execute CFN Loop protocol after agent completes work
+ *
+ * Steps:
+ * 1. Signal completion to orchestrator
+ * 2. Report confidence score
+ * 3. Enter waiting mode (if iterations enabled)
+ */ async function executeCFNProtocol(taskId, agentId, output, iteration, enableIterations = false, maxIterations = 10) {
+    console.log(`\n[CFN Protocol] Starting for agent ${agentId}`);
+    console.log(`[CFN Protocol] Task ID: ${taskId}, Iteration: ${iteration}`);
+    try {
+        // Step 1: Signal completion
+        console.log('[CFN Protocol] Step 1: Signaling completion...');
+        await execAsync(`redis-cli lpush "swarm:${taskId}:${agentId}:done" "complete"`);
+        console.log('[CFN Protocol] ✓ Completion signaled');
+        // Step 2: Extract and report confidence
+        const confidence = extractConfidence(output);
+        console.log(`[CFN Protocol] Step 2: Reporting confidence (${confidence})...`);
+        const reportCmd = `./.claude/skills/redis-coordination/invoke-waiting-mode.sh report \
+      --task-id "${taskId}" \
+      --agent-id "${agentId}" \
+      --confidence ${confidence} \
+      --iteration ${iteration}`;
+        await execAsync(reportCmd);
+        console.log('[CFN Protocol] ✓ Confidence reported');
+        // Step 3: Exit cleanly (BUG #18 FIX - removed waiting mode)
+        // Orchestrator will spawn appropriate specialist agent for next iteration
+        // This enables adaptive agent specialization based on feedback type
+        console.log('[CFN Protocol] Step 3: Exiting cleanly (iteration complete)');
+        console.log('[CFN Protocol] Protocol complete\n');
+    } catch (error) {
+        console.error('[CFN Protocol] Error:', error);
+        throw error;
+    }
+}
+/**
+ * Check if custom routing (z.ai) is enabled
+ */ async function isCustomRoutingEnabled() {
+    // Check environment variable
+    if (process.env.CLAUDE_API_PROVIDER === 'zai') {
+        return true;
+    }
+    // Check config file (.claude/config/api-provider.json)
+    try {
+        const configPath = path.join('.claude', 'config', 'api-provider.json');
+        const config = JSON.parse(await fs.readFile(configPath, 'utf-8'));
+        return config.provider === 'zai' || config.provider === 'z.ai';
+    } catch  {
+        return false;
+    }
+}
+/**
+ * Get API provider configuration
+ */ async function getAPIProvider() {
+    const customEnabled = await isCustomRoutingEnabled();
+    return customEnabled ? 'zai' : 'anthropic';
+}
+/**
+ * Execute agent using direct API calls
+ */ async function executeViaAPI(definition, prompt, context) {
+    const agentId = getAgentId(definition, context);
+    console.log(`[agent-executor] Executing agent via API: ${definition.name}`);
+    console.log(`[agent-executor] Agent ID: ${agentId}`);
+    console.log(`[agent-executor] Model: ${definition.model}`);
+    console.log('');
+    try {
+        // Check for conversation fork (Sprint 4 enhancement)
+        const forkId = process.env.FORK_ID || await getCurrentFork(context.taskId || '', agentId);
+        const iteration = context.iteration || 1;
+        let systemPrompt;
+        let messages = [];
+        if (forkId && iteration > 1) {
+            // Continue from fork (iterations 2+)
+            console.log(`[agent-executor] Continuing from fork: ${forkId}`);
+            // Load fork messages
+            const forkMessages = await loadMessages(context.taskId || '', agentId, forkId);
+            console.log(`[agent-executor] Loaded ${forkMessages.length} messages from fork`);
+            // Extract system prompt from first message (it's always the system message)
+            // The fork messages are assistant/user pairs, we need to add system separately
+            systemPrompt = forkMessages[0]?.content || '';
+            // Format remaining messages for API
+            messages = formatMessagesForAPI(forkMessages.slice(1));
+            // Add new user message with feedback
+            messages.push({
+                role: 'user',
+                content: prompt
+            });
+            console.log(`[agent-executor] Fork continuation: ${messages.length} messages`);
+        } else {
+            // New conversation (iteration 1)
+            console.log('[agent-executor] Starting new conversation');
+            console.log('[agent-executor] Building system prompt with context...');
+            const contextOptions = loadContextFromEnv();
+            contextOptions.agentType = definition.name;
+            if (context.taskId) contextOptions.taskId = context.taskId;
+            if (context.iteration) contextOptions.iteration = context.iteration;
+            systemPrompt = await buildCLIAgentSystemPrompt(contextOptions);
+            console.log('[agent-executor] System prompt built successfully');
+            // Initial user message
+            messages = [
+                {
+                    role: 'user',
+                    content: prompt
+                }
+            ];
+        }
+        console.log('');
+        // Dynamic import to avoid bundling issues
+        const { executeAgentAPI } = await import('./anthropic-client.js');
+        // Convert agent tool names to Anthropic API format
+        const tools = definition.tools && definition.tools.length > 0 ? convertToolNames(definition.tools) : undefined;
+        const result = await executeAgentAPI(definition.name, agentId, definition.model, prompt, systemPrompt, messages.length > 1 ? messages : undefined, undefined, tools // Pass converted tools
+        );
+        // Store messages in conversation history (for future forking)
+        if (context.taskId) {
+            // Store user message
+            const userMessage = {
+                role: 'user',
+                content: prompt,
+                iteration,
+                timestamp: new Date().toISOString()
+            };
+            await storeMessage(context.taskId, agentId, userMessage);
+            // Store assistant response
+            if (result.output) {
+                const assistantMessage = {
+                    role: 'assistant',
+                    content: result.output,
+                    iteration,
+                    timestamp: new Date().toISOString()
+                };
+                await storeMessage(context.taskId, agentId, assistantMessage);
+            }
+            console.log(`[agent-executor] Stored messages for iteration ${iteration}`);
+            // Execute CFN Loop protocol (signal completion, report confidence, enter waiting mode)
+            // Iterations are enabled for CFN Loop tasks (indicated by presence of taskId)
+            try {
+                const maxIterations = 10; // Default max iterations
+                const enableIterations = true; // Enable iterations for all CFN Loop tasks
+                await executeCFNProtocol(context.taskId, agentId, result.output, iteration, enableIterations, maxIterations);
+            } catch (error) {
+                console.error('[agent-executor] CFN Protocol execution failed:', error);
+            // Don't fail the entire agent execution if CFN protocol fails
+            // This allows agents to complete even if Redis coordination has issues
+            }
+        }
+        return {
+            success: result.success,
+            agentId,
+            output: result.output,
+            error: result.error,
+            exitCode: result.success ? 0 : 1
+        };
+    } catch (error) {
+        console.error('[agent-executor] API execution failed:', error);
+        return {
+            success: false,
+            agentId,
+            error: error instanceof Error ? error.message : String(error),
+            exitCode: 1
+        };
+    }
+}
+/**
+ * Execute agent using shell script (fallback/simulation)
+ */ async function executeViaScript(definition, prompt, context) {
+    const agentId = getAgentId(definition, context);
+    // Write prompt to temporary file
+    const tmpDir = os.tmpdir();
+    const promptFile = path.join(tmpDir, `agent-${agentId}-${Date.now()}.md`);
+    await fs.writeFile(promptFile, prompt, 'utf-8');
+    console.log(`[agent-executor] Executing agent via script: ${definition.name}`);
+    console.log(`[agent-executor] Agent ID: ${agentId}`);
+    console.log(`[agent-executor] Model: ${definition.model}`);
+    console.log(`[agent-executor] Prompt file: ${promptFile}`);
+    return new Promise((resolve)=>{
+        const scriptPath = path.join('.claude', 'skills', 'agent-execution', 'execute-agent.sh');
+        // Build environment variables
+        const env = {
+            ...process.env,
+            AGENT_TYPE: definition.name,
+            AGENT_ID: agentId,
+            AGENT_MODEL: definition.model,
+            AGENT_TOOLS: definition.tools.join(','),
+            TASK_ID: context.taskId || '',
+            ITERATION: String(context.iteration || 1),
+            MODE: context.mode || 'cli',
+            PROMPT_FILE: promptFile
+        };
+        // Check if execute script exists
+        fs.access(scriptPath).then(()=>{
+            // Use execution script
+            const proc = spawn('bash', [
+                scriptPath
+            ], {
+                env,
+                stdio: 'inherit'
+            });
+            proc.on('exit', (code)=>{
+                resolve({
+                    success: code === 0,
+                    agentId,
+                    exitCode: code || 0
+                });
+            });
+            proc.on('error', (err)=>{
+                resolve({
+                    success: false,
+                    agentId,
+                    error: err.message,
+                    exitCode: 1
+                });
+            });
+        }).catch(()=>{
+            // Fallback: Print prompt
+            console.log('\n=== Agent Prompt ===');
+            console.log(prompt.substring(0, 500) + '...');
+            console.log('\n[agent-executor] Execution script not found');
+            console.log('[agent-executor] Using simulation mode\n');
+            resolve({
+                success: true,
+                agentId,
+                output: prompt,
+                exitCode: 0
+            });
+        });
+    });
+}
+/**
+ * Main agent execution function
+ */ export async function executeAgent(definition, prompt, context, options = {}) {
+    const method = options.method || 'auto';
+    // Auto-select execution method
+    if (method === 'auto') {
+        // Try API execution first, fallback to script if API key not available
+        try {
+            return await executeViaAPI(definition, prompt, context);
+        } catch (error) {
+            if (error instanceof Error && error.message.includes('API key not found')) {
+                console.log('[agent-executor] API key not found, using script fallback');
+                return executeViaScript(definition, prompt, context);
+            }
+            throw error;
+        }
+    }
+    if (method === 'api') {
+        return executeViaAPI(definition, prompt, context);
+    }
+    return executeViaScript(definition, prompt, context);
+}
+/**
+ * Write agent output to file for debugging
+ */ export async function saveAgentOutput(agentId, output, outputDir = '.claude/tmp/agent-output') {
+    await fs.mkdir(outputDir, {
+        recursive: true
+    });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const filename = `${agentId}-${timestamp}.txt`;
+    const filepath = path.join(outputDir, filename);
+    await fs.writeFile(filepath, output, 'utf-8');
+    return filepath;
+}
+
+//# sourceMappingURL=agent-executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/agent-executor.ts"],"sourcesContent":["/**\r\n * Agent Executor\r\n *\r\n * Executes CLI-spawned agents by:\r\n * 1. Checking custom routing configuration (z.ai vs Anthropic)\r\n * 2. Invoking the appropriate API\r\n * 3. Managing agent lifecycle and output\r\n */\r\n\r\nimport { spawn } from 'child_process';\r\nimport { exec } from 'child_process';\r\nimport { promisify } from 'util';\r\nimport { AgentDefinition } from './agent-definition-parser.js';\r\nimport { TaskContext, getAgentId } from './agent-prompt-builder.js';\r\nimport { buildCLIAgentSystemPrompt, loadContextFromEnv } from './cli-agent-context.js';\r\nimport {\r\n  loadMessages,\r\n  storeMessage,\r\n  getCurrentFork,\r\n  formatMessagesForAPI,\r\n  type Message\r\n} from './conversation-fork.js';\r\nimport { convertToolNames } from './tool-definitions.js';\r\nimport fs from 'fs/promises';\r\nimport path from 'path';\r\nimport os from 'os';\r\n\r\nconst execAsync = promisify(exec);\r\n\r\nexport interface AgentExecutionResult {\r\n  success: boolean;\r\n  agentId: string;\r\n  output?: string;\r\n  error?: string;\r\n  exitCode: number;\r\n}\r\n\r\n/**\r\n * Extract confidence score from agent output\r\n * Looks for patterns like:\r\n * - \"confidence: 0.85\"\r\n * - \"Confidence: 0.90\"\r\n * - \"confidence score: 0.95\"\r\n * - \"self-confidence: 0.88\"\r\n */\r\nfunction extractConfidence(output: string | undefined): number {\r\n  if (!output) return 0.85;\r\n\r\n  // Try multiple patterns\r\n  const patterns = [\r\n    /confidence:\\s*([0-9.]+)/i,\r\n    /confidence\\s+score:\\s*([0-9.]+)/i,\r\n    /self-confidence:\\s*([0-9.]+)/i,\r\n    /my\\s+confidence:\\s*([0-9.]+)/i,\r\n  ];\r\n\r\n  for (const pattern of patterns) {\r\n    const match = output.match(pattern);\r\n    if (match && match[1]) {\r\n      const score = parseFloat(match[1]);\r\n      if (score >= 0 && score <= 1) {\r\n        return score;\r\n      }\r\n    }\r\n  }\r\n\r\n  // Default to 0.85 if not found\r\n  return 0.85;\r\n}\r\n\r\n/**\r\n * Execute CFN Loop protocol after agent completes work\r\n *\r\n * Steps:\r\n * 1. Signal completion to orchestrator\r\n * 2. Report confidence score\r\n * 3. Enter waiting mode (if iterations enabled)\r\n */\r\nasync function executeCFNProtocol(\r\n  taskId: string,\r\n  agentId: string,\r\n  output: string | undefined,\r\n  iteration: number,\r\n  enableIterations: boolean = false,\r\n  maxIterations: number = 10\r\n): Promise<void> {\r\n  console.log(`\\n[CFN Protocol] Starting for agent ${agentId}`);\r\n  console.log(`[CFN Protocol] Task ID: ${taskId}, Iteration: ${iteration}`);\r\n\r\n  try {\r\n    // Step 1: Signal completion\r\n    console.log('[CFN Protocol] Step 1: Signaling completion...');\r\n    await execAsync(`redis-cli lpush \"swarm:${taskId}:${agentId}:done\" \"complete\"`);\r\n    console.log('[CFN Protocol] ✓ Completion signaled');\r\n\r\n    // Step 2: Extract and report confidence\r\n    const confidence = extractConfidence(output);\r\n    console.log(`[CFN Protocol] Step 2: Reporting confidence (${confidence})...`);\r\n\r\n    const reportCmd = `./.claude/skills/redis-coordination/invoke-waiting-mode.sh report \\\r\n      --task-id \"${taskId}\" \\\r\n      --agent-id \"${agentId}\" \\\r\n      --confidence ${confidence} \\\r\n      --iteration ${iteration}`;\r\n\r\n    await execAsync(reportCmd);\r\n    console.log('[CFN Protocol] ✓ Confidence reported');\r\n\r\n    // Step 3: Exit cleanly (BUG #18 FIX - removed waiting mode)\r\n    // Orchestrator will spawn appropriate specialist agent for next iteration\r\n    // This enables adaptive agent specialization based on feedback type\r\n    console.log('[CFN Protocol] Step 3: Exiting cleanly (iteration complete)');\r\n    console.log('[CFN Protocol] Protocol complete\\n');\r\n  } catch (error) {\r\n    console.error('[CFN Protocol] Error:', error);\r\n    throw error;\r\n  }\r\n}\r\n\r\n/**\r\n * Check if custom routing (z.ai) is enabled\r\n */\r\nasync function isCustomRoutingEnabled(): Promise<boolean> {\r\n  // Check environment variable\r\n  if (process.env.CLAUDE_API_PROVIDER === 'zai') {\r\n    return true;\r\n  }\r\n\r\n  // Check config file (.claude/config/api-provider.json)\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    return config.provider === 'zai' || config.provider === 'z.ai';\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Get API provider configuration\r\n */\r\nasync function getAPIProvider(): Promise<'anthropic' | 'zai'> {\r\n  const customEnabled = await isCustomRoutingEnabled();\r\n  return customEnabled ? 'zai' : 'anthropic';\r\n}\r\n\r\n/**\r\n * Execute agent using direct API calls\r\n */\r\nasync function executeViaAPI(\r\n  definition: AgentDefinition,\r\n  prompt: string,\r\n  context: TaskContext\r\n): Promise<AgentExecutionResult> {\r\n  const agentId = getAgentId(definition, context);\r\n\r\n  console.log(`[agent-executor] Executing agent via API: ${definition.name}`);\r\n  console.log(`[agent-executor] Agent ID: ${agentId}`);\r\n  console.log(`[agent-executor] Model: ${definition.model}`);\r\n  console.log('');\r\n\r\n  try {\r\n    // Check for conversation fork (Sprint 4 enhancement)\r\n    const forkId = process.env.FORK_ID || await getCurrentFork(context.taskId || '', agentId);\r\n    const iteration = context.iteration || 1;\r\n\r\n    let systemPrompt: string;\r\n    let messages: Array<{role: string, content: string}> = [];\r\n\r\n    if (forkId && iteration > 1) {\r\n      // Continue from fork (iterations 2+)\r\n      console.log(`[agent-executor] Continuing from fork: ${forkId}`);\r\n\r\n      // Load fork messages\r\n      const forkMessages = await loadMessages(context.taskId || '', agentId, forkId);\r\n      console.log(`[agent-executor] Loaded ${forkMessages.length} messages from fork`);\r\n\r\n      // Extract system prompt from first message (it's always the system message)\r\n      // The fork messages are assistant/user pairs, we need to add system separately\r\n      systemPrompt = forkMessages[0]?.content || '';\r\n\r\n      // Format remaining messages for API\r\n      messages = formatMessagesForAPI(forkMessages.slice(1));\r\n\r\n      // Add new user message with feedback\r\n      messages.push({\r\n        role: 'user',\r\n        content: prompt\r\n      });\r\n\r\n      console.log(`[agent-executor] Fork continuation: ${messages.length} messages`);\r\n    } else {\r\n      // New conversation (iteration 1)\r\n      console.log('[agent-executor] Starting new conversation');\r\n      console.log('[agent-executor] Building system prompt with context...');\r\n\r\n      const contextOptions = loadContextFromEnv();\r\n      contextOptions.agentType = definition.name;\r\n      if (context.taskId) contextOptions.taskId = context.taskId;\r\n      if (context.iteration) contextOptions.iteration = context.iteration;\r\n\r\n      systemPrompt = await buildCLIAgentSystemPrompt(contextOptions);\r\n      console.log('[agent-executor] System prompt built successfully');\r\n\r\n      // Initial user message\r\n      messages = [{\r\n        role: 'user',\r\n        content: prompt\r\n      }];\r\n    }\r\n\r\n    console.log('');\r\n\r\n    // Dynamic import to avoid bundling issues\r\n    const { executeAgentAPI } = await import('./anthropic-client.js');\r\n\r\n    // Convert agent tool names to Anthropic API format\r\n    const tools = definition.tools && definition.tools.length > 0\r\n      ? convertToolNames(definition.tools)\r\n      : undefined;\r\n\r\n    const result = await executeAgentAPI(\r\n      definition.name,\r\n      agentId,\r\n      definition.model,\r\n      prompt,\r\n      systemPrompt,\r\n      messages.length > 1 ? messages : undefined,\r\n      undefined, // maxTokens (use default)\r\n      tools  // Pass converted tools\r\n    );\r\n\r\n    // Store messages in conversation history (for future forking)\r\n    if (context.taskId) {\r\n      // Store user message\r\n      const userMessage: Message = {\r\n        role: 'user',\r\n        content: prompt,\r\n        iteration,\r\n        timestamp: new Date().toISOString()\r\n      };\r\n      await storeMessage(context.taskId, agentId, userMessage);\r\n\r\n      // Store assistant response\r\n      if (result.output) {\r\n        const assistantMessage: Message = {\r\n          role: 'assistant',\r\n          content: result.output,\r\n          iteration,\r\n          timestamp: new Date().toISOString()\r\n        };\r\n        await storeMessage(context.taskId, agentId, assistantMessage);\r\n      }\r\n\r\n      console.log(`[agent-executor] Stored messages for iteration ${iteration}`);\r\n\r\n      // Execute CFN Loop protocol (signal completion, report confidence, enter waiting mode)\r\n      // Iterations are enabled for CFN Loop tasks (indicated by presence of taskId)\r\n      try {\r\n        const maxIterations = 10; // Default max iterations\r\n        const enableIterations = true; // Enable iterations for all CFN Loop tasks\r\n\r\n        await executeCFNProtocol(\r\n          context.taskId,\r\n          agentId,\r\n          result.output,\r\n          iteration,\r\n          enableIterations,\r\n          maxIterations\r\n        );\r\n      } catch (error) {\r\n        console.error('[agent-executor] CFN Protocol execution failed:', error);\r\n        // Don't fail the entire agent execution if CFN protocol fails\r\n        // This allows agents to complete even if Redis coordination has issues\r\n      }\r\n    }\r\n\r\n    return {\r\n      success: result.success,\r\n      agentId,\r\n      output: result.output,\r\n      error: result.error,\r\n      exitCode: result.success ? 0 : 1,\r\n    };\r\n  } catch (error) {\r\n    console.error('[agent-executor] API execution failed:', error);\r\n    return {\r\n      success: false,\r\n      agentId,\r\n      error: error instanceof Error ? error.message : String(error),\r\n      exitCode: 1,\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Execute agent using shell script (fallback/simulation)\r\n */\r\nasync function executeViaScript(\r\n  definition: AgentDefinition,\r\n  prompt: string,\r\n  context: TaskContext\r\n): Promise<AgentExecutionResult> {\r\n  const agentId = getAgentId(definition, context);\r\n\r\n  // Write prompt to temporary file\r\n  const tmpDir = os.tmpdir();\r\n  const promptFile = path.join(tmpDir, `agent-${agentId}-${Date.now()}.md`);\r\n  await fs.writeFile(promptFile, prompt, 'utf-8');\r\n\r\n  console.log(`[agent-executor] Executing agent via script: ${definition.name}`);\r\n  console.log(`[agent-executor] Agent ID: ${agentId}`);\r\n  console.log(`[agent-executor] Model: ${definition.model}`);\r\n  console.log(`[agent-executor] Prompt file: ${promptFile}`);\r\n\r\n  return new Promise((resolve) => {\r\n    const scriptPath = path.join('.claude', 'skills', 'agent-execution', 'execute-agent.sh');\r\n\r\n    // Build environment variables\r\n    const env = {\r\n      ...process.env,\r\n      AGENT_TYPE: definition.name,\r\n      AGENT_ID: agentId,\r\n      AGENT_MODEL: definition.model,\r\n      AGENT_TOOLS: definition.tools.join(','),\r\n      TASK_ID: context.taskId || '',\r\n      ITERATION: String(context.iteration || 1),\r\n      MODE: context.mode || 'cli',\r\n      PROMPT_FILE: promptFile,\r\n    };\r\n\r\n    // Check if execute script exists\r\n    fs.access(scriptPath)\r\n      .then(() => {\r\n        // Use execution script\r\n        const proc = spawn('bash', [scriptPath], { env, stdio: 'inherit' });\r\n\r\n        proc.on('exit', (code) => {\r\n          resolve({\r\n            success: code === 0,\r\n            agentId,\r\n            exitCode: code || 0,\r\n          });\r\n        });\r\n\r\n        proc.on('error', (err) => {\r\n          resolve({\r\n            success: false,\r\n            agentId,\r\n            error: err.message,\r\n            exitCode: 1,\r\n          });\r\n        });\r\n      })\r\n      .catch(() => {\r\n        // Fallback: Print prompt\r\n        console.log('\\n=== Agent Prompt ===');\r\n        console.log(prompt.substring(0, 500) + '...');\r\n        console.log('\\n[agent-executor] Execution script not found');\r\n        console.log('[agent-executor] Using simulation mode\\n');\r\n\r\n        resolve({\r\n          success: true,\r\n          agentId,\r\n          output: prompt,\r\n          exitCode: 0,\r\n        });\r\n      });\r\n  });\r\n}\r\n\r\n/**\r\n * Main agent execution function\r\n */\r\nexport async function executeAgent(\r\n  definition: AgentDefinition,\r\n  prompt: string,\r\n  context: TaskContext,\r\n  options: {\r\n    method?: 'auto' | 'api' | 'script';\r\n  } = {}\r\n): Promise<AgentExecutionResult> {\r\n  const method = options.method || 'auto';\r\n\r\n  // Auto-select execution method\r\n  if (method === 'auto') {\r\n    // Try API execution first, fallback to script if API key not available\r\n    try {\r\n      return await executeViaAPI(definition, prompt, context);\r\n    } catch (error) {\r\n      if (error instanceof Error && error.message.includes('API key not found')) {\r\n        console.log('[agent-executor] API key not found, using script fallback');\r\n        return executeViaScript(definition, prompt, context);\r\n      }\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  if (method === 'api') {\r\n    return executeViaAPI(definition, prompt, context);\r\n  }\r\n\r\n  return executeViaScript(definition, prompt, context);\r\n}\r\n\r\n/**\r\n * Write agent output to file for debugging\r\n */\r\nexport async function saveAgentOutput(\r\n  agentId: string,\r\n  output: string,\r\n  outputDir: string = '.claude/tmp/agent-output'\r\n): Promise<string> {\r\n  await fs.mkdir(outputDir, { recursive: true });\r\n\r\n  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');\r\n  const filename = `${agentId}-${timestamp}.txt`;\r\n  const filepath = path.join(outputDir, filename);\r\n\r\n  await fs.writeFile(filepath, output, 'utf-8');\r\n\r\n  return filepath;\r\n}\r\n"],"names":["spawn","exec","promisify","getAgentId","buildCLIAgentSystemPrompt","loadContextFromEnv","loadMessages","storeMessage","getCurrentFork","formatMessagesForAPI","convertToolNames","fs","path","os","execAsync","extractConfidence","output","patterns","pattern","match","score","parseFloat","executeCFNProtocol","taskId","agentId","iteration","enableIterations","maxIterations","console","log","confidence","reportCmd","error","isCustomRoutingEnabled","process","env","CLAUDE_API_PROVIDER","configPath","join","config","JSON","parse","readFile","provider","getAPIProvider","customEnabled","executeViaAPI","definition","prompt","context","name","model","forkId","FORK_ID","systemPrompt","messages","forkMessages","length","content","slice","push","role","contextOptions","agentType","executeAgentAPI","tools","undefined","result","userMessage","timestamp","Date","toISOString","assistantMessage","success","exitCode","Error","message","String","executeViaScript","tmpDir","tmpdir","promptFile","now","writeFile","Promise","resolve","scriptPath","AGENT_TYPE","AGENT_ID","AGENT_MODEL","AGENT_TOOLS","TASK_ID","ITERATION","MODE","mode","PROMPT_FILE","access","then","proc","stdio","on","code","err","catch","substring","executeAgent","options","method","includes","saveAgentOutput","outputDir","mkdir","recursive","replace","filename","filepath"],"mappings":"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"}

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

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