claude-flow-novice 2.15.8 → 2.15.10

package/dist/coordination/spawn-agent.js

@@ -0,0 +1,364 @@
+/**
+ * Agent Spawning Abstraction Layer
+ *
+ * Provides unified interface for spawning agents in both Task Mode and CLI Mode.
+ * Abstracts away the complexity of determining spawn method and managing processes.
+ *
+ * Key Features:
+ * - Automatic mode detection (Task vs CLI)
+ * - Process management and cleanup
+ * - Error handling and retry logic
+ * - Process PID tracking
+ * - Wait for agent completion
+ * - Resource limits and timeouts
+ */ import { spawn } from 'child_process';
+import { EventEmitter } from 'events';
+import { CoordinationError, CoordinationErrorType } from './types-export';
+/**
+ * Agent Spawner
+ *
+ * Creates and manages agent processes with support for both Task and CLI modes.
+ *
+ * Task Mode: Spawns via npx CLI (no Redis coordination)
+ * CLI Mode: Spawns via npx CLI with Redis coordination environment variables
+ */ export class AgentSpawner extends EventEmitter {
+    logger;
+    executionMode;
+    canUseRedis;
+    projectRoot;
+    dockerEnabled;
+    // Track running agents
+    processes = new Map();
+    constructor(config){
+        super();
+        this.logger = config.logger;
+        this.executionMode = config.executionMode;
+        this.canUseRedis = config.canUseRedis;
+        this.projectRoot = config.projectRoot || process.cwd();
+        this.dockerEnabled = config.dockerEnabled ?? false;
+    }
+    /**
+   * Spawn an agent (auto-detects mode)
+   *
+   * Automatically selects appropriate spawn method based on execution mode.
+   */ async spawnAgent(config) {
+        if (this.executionMode === 'cli' || this.executionMode === 'unknown') {
+            // Try CLI mode first
+            return this.spawnCLIAgent(config);
+        } else {
+            // Task mode: Still spawn via CLI but without Redis
+            return this.spawnTaskAgent(config);
+        }
+    }
+    /**
+   * Spawn agent in CLI mode
+   *
+   * Spawns via npx with TASK_ID and AGENT_ID for Redis coordination.
+   */ async spawnCLIAgent(config) {
+        if (!this.canUseRedis && this.executionMode !== 'unknown') {
+            // In true CLI mode but Redis unavailable
+            this.logger.warn('CLI Mode but Redis unavailable - spawning without coordination');
+        }
+        const args = [
+            'claude-flow-novice',
+            'agent',
+            config.agentType,
+            '--task-id',
+            config.taskId,
+            '--agent-id',
+            config.agentId
+        ];
+        if (config.iteration !== undefined) {
+            args.push('--iteration', config.iteration.toString());
+        }
+        if (config.context) {
+            args.push('--context', JSON.stringify(config.context));
+        }
+        // Build environment
+        const env = {
+            ...process.env,
+            TASK_ID: config.taskId,
+            AGENT_ID: config.agentId,
+            CFN_MODE: 'cli',
+            ...config.environment || {}
+        };
+        // Add Redis connection info if available
+        if (this.canUseRedis) {
+            const redisHost = process.env.REDIS_HOST || 'localhost';
+            const redisPort = process.env.REDIS_PORT || '6379';
+            const redisPassword = process.env.REDIS_PASSWORD || process.env.CFN_REDIS_PASSWORD;
+            env.REDIS_HOST = redisHost;
+            env.REDIS_PORT = redisPort;
+            if (redisPassword) {
+                env.REDIS_PASSWORD = redisPassword;
+            }
+        }
+        return this._spawnProcess(config, args, env, 'cli');
+    }
+    /**
+   * Spawn agent in Task mode
+   *
+   * Spawns via npx without Task/Agent IDs for Main Chat execution.
+   */ async spawnTaskAgent(config) {
+        const args = [
+            'claude-flow-novice',
+            'agent',
+            config.agentType
+        ];
+        // In Task Mode, don't pass TASK_ID/AGENT_ID (Main Chat doesn't know about them)
+        if (config.context) {
+            args.push('--context', JSON.stringify(config.context));
+        }
+        // Build environment without TASK_ID/AGENT_ID
+        const env = {
+            ...process.env,
+            CFN_MODE: 'task',
+            ...config.environment || {}
+        };
+        // Remove Redis connection in Task Mode
+        delete env.TASK_ID;
+        delete env.AGENT_ID;
+        delete env.REDIS_HOST;
+        delete env.REDIS_PORT;
+        delete env.REDIS_PASSWORD;
+        return this._spawnProcess(config, args, env, 'task');
+    }
+    /**
+   * Internal: Spawn process with retry logic
+   *
+   * Handles actual process spawning with error handling and retries.
+   */ async _spawnProcess(config, args, env, mode) {
+        const maxRetries = config.maxRetries ?? 1;
+        let lastError = null;
+        for(let attempt = 1; attempt <= maxRetries; attempt++){
+            try {
+                // Spawn the process
+                const spawnOptions = {
+                    stdio: [
+                        'ignore',
+                        'pipe',
+                        'pipe'
+                    ],
+                    env,
+                    detached: true,
+                    timeout: config.timeoutMs ?? 600000
+                };
+                this.logger.debug(`Spawning agent ${config.agentId} (attempt ${attempt}/${maxRetries})`);
+                const process1 = spawn('npx', args, spawnOptions);
+                const pid = process1.pid || null;
+                const processInfo = {
+                    agentId: config.agentId,
+                    agentType: config.agentType,
+                    taskId: config.taskId,
+                    pid,
+                    mode,
+                    process: process1,
+                    startedAt: new Date().toISOString(),
+                    exitCode: null,
+                    signal: null,
+                    killed: false
+                };
+                // Track process
+                this.processes.set(config.agentId, processInfo);
+                // Attach event handlers
+                this._attachProcessHandlers(processInfo);
+                this.logger.info(`Spawned agent ${config.agentId} (PID: ${pid || 'unknown'}, mode: ${mode})`);
+                this.emit('agent-spawned', processInfo);
+                return processInfo;
+            } catch (error) {
+                lastError = error;
+                if (attempt < maxRetries) {
+                    // Wait before retry (exponential backoff)
+                    const delayMs = Math.min(1000 * Math.pow(2, attempt - 1), 10000);
+                    this.logger.warn(`Failed to spawn agent ${config.agentId} (attempt ${attempt}/${maxRetries}), retrying in ${delayMs}ms...`);
+                    await new Promise((resolve)=>setTimeout(resolve, delayMs));
+                }
+            }
+        }
+        throw new CoordinationError(CoordinationErrorType.AGENT_SPAWN_ERROR, `Failed to spawn agent ${config.agentId} after ${maxRetries} attempts: ${lastError?.message}`, mode, true // Retryable
+        );
+    }
+    /**
+   * Attach process event handlers
+   *
+   * Monitors process lifecycle and emits events.
+   */ _attachProcessHandlers(processInfo) {
+        const { process: process1, agentId } = processInfo;
+        if (!process1) return;
+        // Handle process exit
+        process1.on('exit', (code, signal)=>{
+            processInfo.exitCode = code;
+            processInfo.signal = signal;
+            this.logger.info(`Agent ${agentId} exited with code ${code}${signal ? ` (signal: ${signal})` : ''}`);
+            this.emit('agent-exit', processInfo);
+        });
+        // Handle process errors
+        process1.on('error', (error)=>{
+            this.logger.error(`Agent ${agentId} process error`, error);
+            this.emit('agent-error', {
+                agentId,
+                error
+            });
+        });
+        // Handle stdout/stderr
+        process1.stdout?.on('data', (data)=>{
+            this.logger.debug(`Agent ${agentId} stdout:`, data.toString());
+        });
+        process1.stderr?.on('data', (data)=>{
+            this.logger.debug(`Agent ${agentId} stderr:`, data.toString());
+        });
+    }
+    /**
+   * Kill an agent process
+   *
+   * Forcefully terminates an agent and cleanup.
+   */ async killAgent(agentId, signal = 'SIGTERM') {
+        const processInfo = this.processes.get(agentId);
+        if (!processInfo || !processInfo.process || !processInfo.pid) {
+            this.logger.warn(`Cannot kill agent ${agentId}: not found or no PID`);
+            return;
+        }
+        try {
+            // Kill the process group (not just the process)
+            process.kill(-processInfo.pid, signal);
+            processInfo.killed = true;
+            this.logger.info(`Killed agent ${agentId} (PID: ${processInfo.pid}, signal: ${signal})`);
+            this.emit('agent-killed', processInfo);
+            // Wait a bit for graceful shutdown
+            await new Promise((resolve)=>setTimeout(resolve, 1000));
+            // Force kill if still alive
+            if (!processInfo.process.killed) {
+                process.kill(-processInfo.pid, 'SIGKILL');
+                this.logger.warn(`Force-killed agent ${agentId} (SIGKILL)`);
+            }
+        } catch (error) {
+            this.logger.error(`Failed to kill agent ${agentId}`, error);
+        }
+    }
+    /**
+   * Get agent PID
+   *
+   * Returns process ID for a spawned agent.
+   */ getAgentPID(agentId) {
+        return this.processes.get(agentId)?.pid ?? null;
+    }
+    /**
+   * Get agent process info
+   *
+   * Returns full process information for tracking.
+   */ getAgentProcessInfo(agentId) {
+        return this.processes.get(agentId) ?? null;
+    }
+    /**
+   * Get all running agents
+   *
+   * Returns information for all spawned agents.
+   */ getAllRunningAgents() {
+        return Array.from(this.processes.values()).filter((info)=>info.process && !info.process.killed);
+    }
+    /**
+   * Wait for agent completion
+   *
+   * Blocking wait for agent process to exit with timeout.
+   */ async waitForAgent(agentId, timeoutMs = 600000 // 10 minutes
+    ) {
+        const startTime = Date.now();
+        return new Promise((resolve, reject)=>{
+            const processInfo = this.processes.get(agentId);
+            if (!processInfo) {
+                return reject(new CoordinationError(CoordinationErrorType.AGENT_NOT_FOUND, `Agent ${agentId} not found`));
+            }
+            // If already exited, return immediately
+            if (processInfo.exitCode !== null) {
+                return resolve(processInfo);
+            }
+            // Wait for exit event
+            const exitHandler = ()=>{
+                resolve(processInfo);
+                clearTimeout(timeoutHandle);
+            };
+            const timeoutHandle = setTimeout(()=>{
+                if (processInfo.process) {
+                    processInfo.process.removeListener('exit', exitHandler);
+                }
+                processInfo.exitCode = -1; // Timeout code
+                reject(new CoordinationError(CoordinationErrorType.TIMEOUT, `Agent ${agentId} did not complete within ${timeoutMs}ms`));
+            }, timeoutMs);
+            if (processInfo.process) {
+                processInfo.process.once('exit', exitHandler);
+            }
+        });
+    }
+    /**
+   * Wait for multiple agents
+   *
+   * Blocking wait for all agents to complete.
+   */ async waitForAgents(agentIds, timeoutMs = 600000) {
+        const results = new Map();
+        const startTime = Date.now();
+        for (const agentId of agentIds){
+            const elapsedMs = Date.now() - startTime;
+            const remainingMs = timeoutMs - elapsedMs;
+            if (remainingMs <= 0) {
+                throw new CoordinationError(CoordinationErrorType.TIMEOUT, `Timeout waiting for agents: exceeded ${timeoutMs}ms`);
+            }
+            try {
+                const processInfo = await this.waitForAgent(agentId, remainingMs);
+                results.set(agentId, processInfo);
+            } catch (error) {
+                // Continue waiting for other agents even if one fails
+                const processInfo = this.processes.get(agentId);
+                if (processInfo) {
+                    results.set(agentId, processInfo);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+   * Cleanup all spawned agents
+   *
+   * Kills all running agents and clears tracking.
+   */ async cleanup() {
+        const runningAgents = this.getAllRunningAgents();
+        this.logger.info(`Cleaning up ${runningAgents.length} running agents...`);
+        for (const agentInfo of runningAgents){
+            try {
+                await this.killAgent(agentInfo.agentId, 'SIGTERM');
+            } catch (error) {
+                this.logger.error(`Failed to cleanup agent ${agentInfo.agentId}`, error);
+            }
+        }
+        this.processes.clear();
+        this.logger.info('Agent cleanup complete');
+    }
+    /**
+   * Get statistics about spawned agents
+   *
+   * Returns summary of spawned agents by status.
+   */ getSpawnStatistics() {
+        const all = Array.from(this.processes.values());
+        const running = all.filter((info)=>info.exitCode === null && !info.killed);
+        const completed = all.filter((info)=>info.exitCode === 0 && !info.killed);
+        const failed = all.filter((info)=>info.exitCode !== 0 && info.exitCode !== null || info.killed);
+        return {
+            total: all.length,
+            running: running.length,
+            completed: completed.length,
+            failed: failed.length
+        };
+    }
+}
+/**
+ * Factory function for creating spawner with sensible defaults
+ */ export function createAgentSpawner(logger, config) {
+    return new AgentSpawner({
+        logger,
+        executionMode: config?.executionMode ?? 'unknown',
+        canUseRedis: config?.canUseRedis ?? false,
+        projectRoot: config?.projectRoot,
+        dockerEnabled: config?.dockerEnabled ?? false
+    });
+}
+
+//# sourceMappingURL=spawn-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/coordination/spawn-agent.ts"],"sourcesContent":["/**\r\n * Agent Spawning Abstraction Layer\r\n *\r\n * Provides unified interface for spawning agents in both Task Mode and CLI Mode.\r\n * Abstracts away the complexity of determining spawn method and managing processes.\r\n *\r\n * Key Features:\r\n * - Automatic mode detection (Task vs CLI)\r\n * - Process management and cleanup\r\n * - Error handling and retry logic\r\n * - Process PID tracking\r\n * - Wait for agent completion\r\n * - Resource limits and timeouts\r\n */\r\n\r\nimport { spawn, SpawnOptions } from 'child_process';\r\nimport { EventEmitter } from 'events';\r\nimport type { ChildProcess } from 'child_process';\r\n// Types from Redis coordination skill\r\nimport type {\r\n  AgentId,\r\n  TaskId,\r\n  ExecutionMode,\r\n  Logger,\r\n} from './types-export';\r\nimport {\r\n  CoordinationError,\r\n  CoordinationErrorType,\r\n} from './types-export';\r\n\r\n/**\r\n * Agent Spawn Configuration\r\n *\r\n * Configuration for spawning an agent with all necessary parameters.\r\n */\r\nexport interface AgentSpawnConfig {\r\n  agentType: string;\r\n  taskId: TaskId;\r\n  agentId: AgentId;\r\n  iteration?: number;\r\n  context?: Record<string, unknown>;\r\n  memoryLimit?: number; // MB\r\n  timeoutMs?: number;\r\n  maxRetries?: number;\r\n  environment?: Record<string, string>;\r\n}\r\n\r\n/**\r\n * Agent Process Information\r\n *\r\n * Tracks spawned agent process and its lifecycle.\r\n */\r\nexport interface AgentProcessInfo {\r\n  agentId: AgentId;\r\n  agentType: string;\r\n  taskId: TaskId;\r\n  pid: number | null;\r\n  mode: ExecutionMode;\r\n  process: ChildProcess | null;\r\n  startedAt: string;\r\n  exitCode: number | null;\r\n  signal: string | null;\r\n  killed: boolean;\r\n}\r\n\r\n/**\r\n * Agent Spawner Options\r\n *\r\n * Configuration for the spawner itself.\r\n */\r\nexport interface SpawnerConfig {\r\n  logger: Logger;\r\n  executionMode: ExecutionMode;\r\n  canUseRedis: boolean;\r\n  projectRoot?: string;\r\n  dockerEnabled?: boolean;\r\n}\r\n\r\n/**\r\n * Agent Spawner\r\n *\r\n * Creates and manages agent processes with support for both Task and CLI modes.\r\n *\r\n * Task Mode: Spawns via npx CLI (no Redis coordination)\r\n * CLI Mode: Spawns via npx CLI with Redis coordination environment variables\r\n */\r\nexport class AgentSpawner extends EventEmitter {\r\n  private logger: Logger;\r\n  private executionMode: ExecutionMode;\r\n  private canUseRedis: boolean;\r\n  private projectRoot: string;\r\n  private dockerEnabled: boolean;\r\n\r\n  // Track running agents\r\n  private processes = new Map<AgentId, AgentProcessInfo>();\r\n\r\n  constructor(config: SpawnerConfig) {\r\n    super();\r\n    this.logger = config.logger;\r\n    this.executionMode = config.executionMode;\r\n    this.canUseRedis = config.canUseRedis;\r\n    this.projectRoot = config.projectRoot || process.cwd();\r\n    this.dockerEnabled = config.dockerEnabled ?? false;\r\n  }\r\n\r\n  /**\r\n   * Spawn an agent (auto-detects mode)\r\n   *\r\n   * Automatically selects appropriate spawn method based on execution mode.\r\n   */\r\n  async spawnAgent(config: AgentSpawnConfig): Promise<AgentProcessInfo> {\r\n    if (this.executionMode === 'cli' || this.executionMode === 'unknown') {\r\n      // Try CLI mode first\r\n      return this.spawnCLIAgent(config);\r\n    } else {\r\n      // Task mode: Still spawn via CLI but without Redis\r\n      return this.spawnTaskAgent(config);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Spawn agent in CLI mode\r\n   *\r\n   * Spawns via npx with TASK_ID and AGENT_ID for Redis coordination.\r\n   */\r\n  async spawnCLIAgent(config: AgentSpawnConfig): Promise<AgentProcessInfo> {\r\n    if (!this.canUseRedis && this.executionMode !== 'unknown') {\r\n      // In true CLI mode but Redis unavailable\r\n      this.logger.warn('CLI Mode but Redis unavailable - spawning without coordination');\r\n    }\r\n\r\n    const args = [\r\n      'claude-flow-novice',\r\n      'agent',\r\n      config.agentType,\r\n      '--task-id', config.taskId,\r\n      '--agent-id', config.agentId,\r\n    ];\r\n\r\n    if (config.iteration !== undefined) {\r\n      args.push('--iteration', config.iteration.toString());\r\n    }\r\n\r\n    if (config.context) {\r\n      args.push('--context', JSON.stringify(config.context));\r\n    }\r\n\r\n    // Build environment\r\n    const env: Record<string, string> = {\r\n      ...process.env,\r\n      TASK_ID: config.taskId,\r\n      AGENT_ID: config.agentId,\r\n      CFN_MODE: 'cli',\r\n      ...(config.environment || {}),\r\n    };\r\n\r\n    // Add Redis connection info if available\r\n    if (this.canUseRedis) {\r\n      const redisHost = process.env.REDIS_HOST || 'localhost';\r\n      const redisPort = process.env.REDIS_PORT || '6379';\r\n      const redisPassword = process.env.REDIS_PASSWORD || process.env.CFN_REDIS_PASSWORD;\r\n\r\n      env.REDIS_HOST = redisHost;\r\n      env.REDIS_PORT = redisPort;\r\n      if (redisPassword) {\r\n        env.REDIS_PASSWORD = redisPassword;\r\n      }\r\n    }\r\n\r\n    return this._spawnProcess(config, args, env, 'cli');\r\n  }\r\n\r\n  /**\r\n   * Spawn agent in Task mode\r\n   *\r\n   * Spawns via npx without Task/Agent IDs for Main Chat execution.\r\n   */\r\n  async spawnTaskAgent(config: AgentSpawnConfig): Promise<AgentProcessInfo> {\r\n    const args = [\r\n      'claude-flow-novice',\r\n      'agent',\r\n      config.agentType,\r\n    ];\r\n\r\n    // In Task Mode, don't pass TASK_ID/AGENT_ID (Main Chat doesn't know about them)\r\n    if (config.context) {\r\n      args.push('--context', JSON.stringify(config.context));\r\n    }\r\n\r\n    // Build environment without TASK_ID/AGENT_ID\r\n    const env: Record<string, string> = {\r\n      ...process.env,\r\n      CFN_MODE: 'task',\r\n      ...(config.environment || {}),\r\n    };\r\n\r\n    // Remove Redis connection in Task Mode\r\n    delete env.TASK_ID;\r\n    delete env.AGENT_ID;\r\n    delete env.REDIS_HOST;\r\n    delete env.REDIS_PORT;\r\n    delete env.REDIS_PASSWORD;\r\n\r\n    return this._spawnProcess(config, args, env, 'task');\r\n  }\r\n\r\n  /**\r\n   * Internal: Spawn process with retry logic\r\n   *\r\n   * Handles actual process spawning with error handling and retries.\r\n   */\r\n  private async _spawnProcess(\r\n    config: AgentSpawnConfig,\r\n    args: string[],\r\n    env: Record<string, string>,\r\n    mode: ExecutionMode\r\n  ): Promise<AgentProcessInfo> {\r\n    const maxRetries = config.maxRetries ?? 1;\r\n    let lastError: Error | null = null;\r\n\r\n    for (let attempt = 1; attempt <= maxRetries; attempt++) {\r\n      try {\r\n        // Spawn the process\r\n        const spawnOptions: SpawnOptions = {\r\n          stdio: ['ignore', 'pipe', 'pipe'], // Inherit stdio for logging\r\n          env,\r\n          detached: true, // Allow process to outlive parent\r\n          timeout: config.timeoutMs ?? 600000, // 10 minute default\r\n        };\r\n\r\n        this.logger.debug(`Spawning agent ${config.agentId} (attempt ${attempt}/${maxRetries})`);\r\n\r\n        const process = spawn('npx', args, spawnOptions);\r\n        const pid = process.pid || null;\r\n\r\n        const processInfo: AgentProcessInfo = {\r\n          agentId: config.agentId,\r\n          agentType: config.agentType,\r\n          taskId: config.taskId,\r\n          pid,\r\n          mode,\r\n          process,\r\n          startedAt: new Date().toISOString(),\r\n          exitCode: null,\r\n          signal: null,\r\n          killed: false,\r\n        };\r\n\r\n        // Track process\r\n        this.processes.set(config.agentId, processInfo);\r\n\r\n        // Attach event handlers\r\n        this._attachProcessHandlers(processInfo);\r\n\r\n        this.logger.info(\r\n          `Spawned agent ${config.agentId} (PID: ${pid || 'unknown'}, mode: ${mode})`\r\n        );\r\n\r\n        this.emit('agent-spawned', processInfo);\r\n\r\n        return processInfo;\r\n      } catch (error) {\r\n        lastError = error as Error;\r\n\r\n        if (attempt < maxRetries) {\r\n          // Wait before retry (exponential backoff)\r\n          const delayMs = Math.min(1000 * Math.pow(2, attempt - 1), 10000);\r\n          this.logger.warn(\r\n            `Failed to spawn agent ${config.agentId} (attempt ${attempt}/${maxRetries}), retrying in ${delayMs}ms...`\r\n          );\r\n          await new Promise(resolve => setTimeout(resolve, delayMs));\r\n        }\r\n      }\r\n    }\r\n\r\n    throw new CoordinationError(\r\n      CoordinationErrorType.AGENT_SPAWN_ERROR,\r\n      `Failed to spawn agent ${config.agentId} after ${maxRetries} attempts: ${lastError?.message}`,\r\n      mode,\r\n      true // Retryable\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Attach process event handlers\r\n   *\r\n   * Monitors process lifecycle and emits events.\r\n   */\r\n  private _attachProcessHandlers(processInfo: AgentProcessInfo): void {\r\n    const { process, agentId } = processInfo;\r\n\r\n    if (!process) return;\r\n\r\n    // Handle process exit\r\n    process.on('exit', (code, signal) => {\r\n      processInfo.exitCode = code;\r\n      processInfo.signal = signal;\r\n      this.logger.info(\r\n        `Agent ${agentId} exited with code ${code}${signal ? ` (signal: ${signal})` : ''}`\r\n      );\r\n      this.emit('agent-exit', processInfo);\r\n    });\r\n\r\n    // Handle process errors\r\n    process.on('error', (error) => {\r\n      this.logger.error(`Agent ${agentId} process error`, error);\r\n      this.emit('agent-error', { agentId, error });\r\n    });\r\n\r\n    // Handle stdout/stderr\r\n    process.stdout?.on('data', (data) => {\r\n      this.logger.debug(`Agent ${agentId} stdout:`, data.toString());\r\n    });\r\n\r\n    process.stderr?.on('data', (data) => {\r\n      this.logger.debug(`Agent ${agentId} stderr:`, data.toString());\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Kill an agent process\r\n   *\r\n   * Forcefully terminates an agent and cleanup.\r\n   */\r\n  async killAgent(agentId: AgentId, signal: string = 'SIGTERM'): Promise<void> {\r\n    const processInfo = this.processes.get(agentId);\r\n\r\n    if (!processInfo || !processInfo.process || !processInfo.pid) {\r\n      this.logger.warn(`Cannot kill agent ${agentId}: not found or no PID`);\r\n      return;\r\n    }\r\n\r\n    try {\r\n      // Kill the process group (not just the process)\r\n      process.kill(-processInfo.pid, signal);\r\n      processInfo.killed = true;\r\n\r\n      this.logger.info(`Killed agent ${agentId} (PID: ${processInfo.pid}, signal: ${signal})`);\r\n      this.emit('agent-killed', processInfo);\r\n\r\n      // Wait a bit for graceful shutdown\r\n      await new Promise(resolve => setTimeout(resolve, 1000));\r\n\r\n      // Force kill if still alive\r\n      if (!processInfo.process.killed) {\r\n        process.kill(-processInfo.pid, 'SIGKILL');\r\n        this.logger.warn(`Force-killed agent ${agentId} (SIGKILL)`);\r\n      }\r\n    } catch (error) {\r\n      this.logger.error(`Failed to kill agent ${agentId}`, error);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get agent PID\r\n   *\r\n   * Returns process ID for a spawned agent.\r\n   */\r\n  getAgentPID(agentId: AgentId): number | null {\r\n    return this.processes.get(agentId)?.pid ?? null;\r\n  }\r\n\r\n  /**\r\n   * Get agent process info\r\n   *\r\n   * Returns full process information for tracking.\r\n   */\r\n  getAgentProcessInfo(agentId: AgentId): AgentProcessInfo | null {\r\n    return this.processes.get(agentId) ?? null;\r\n  }\r\n\r\n  /**\r\n   * Get all running agents\r\n   *\r\n   * Returns information for all spawned agents.\r\n   */\r\n  getAllRunningAgents(): AgentProcessInfo[] {\r\n    return Array.from(this.processes.values()).filter(\r\n      info => info.process && !info.process.killed\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Wait for agent completion\r\n   *\r\n   * Blocking wait for agent process to exit with timeout.\r\n   */\r\n  async waitForAgent(\r\n    agentId: AgentId,\r\n    timeoutMs: number = 600000 // 10 minutes\r\n  ): Promise<AgentProcessInfo> {\r\n    const startTime = Date.now();\r\n\r\n    return new Promise((resolve, reject) => {\r\n      const processInfo = this.processes.get(agentId);\r\n\r\n      if (!processInfo) {\r\n        return reject(\r\n          new CoordinationError(\r\n            CoordinationErrorType.AGENT_NOT_FOUND,\r\n            `Agent ${agentId} not found`\r\n          )\r\n        );\r\n      }\r\n\r\n      // If already exited, return immediately\r\n      if (processInfo.exitCode !== null) {\r\n        return resolve(processInfo);\r\n      }\r\n\r\n      // Wait for exit event\r\n      const exitHandler = () => {\r\n        resolve(processInfo);\r\n        clearTimeout(timeoutHandle);\r\n      };\r\n\r\n      const timeoutHandle = setTimeout(() => {\r\n        if (processInfo.process) {\r\n          processInfo.process.removeListener('exit', exitHandler);\r\n        }\r\n        processInfo.exitCode = -1; // Timeout code\r\n        reject(\r\n          new CoordinationError(\r\n            CoordinationErrorType.TIMEOUT,\r\n            `Agent ${agentId} did not complete within ${timeoutMs}ms`\r\n          )\r\n        );\r\n      }, timeoutMs);\r\n\r\n      if (processInfo.process) {\r\n        processInfo.process.once('exit', exitHandler);\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Wait for multiple agents\r\n   *\r\n   * Blocking wait for all agents to complete.\r\n   */\r\n  async waitForAgents(\r\n    agentIds: AgentId[],\r\n    timeoutMs: number = 600000\r\n  ): Promise<Map<AgentId, AgentProcessInfo>> {\r\n    const results = new Map<AgentId, AgentProcessInfo>();\r\n    const startTime = Date.now();\r\n\r\n    for (const agentId of agentIds) {\r\n      const elapsedMs = Date.now() - startTime;\r\n      const remainingMs = timeoutMs - elapsedMs;\r\n\r\n      if (remainingMs <= 0) {\r\n        throw new CoordinationError(\r\n          CoordinationErrorType.TIMEOUT,\r\n          `Timeout waiting for agents: exceeded ${timeoutMs}ms`\r\n        );\r\n      }\r\n\r\n      try {\r\n        const processInfo = await this.waitForAgent(agentId, remainingMs);\r\n        results.set(agentId, processInfo);\r\n      } catch (error) {\r\n        // Continue waiting for other agents even if one fails\r\n        const processInfo = this.processes.get(agentId);\r\n        if (processInfo) {\r\n          results.set(agentId, processInfo);\r\n        }\r\n      }\r\n    }\r\n\r\n    return results;\r\n  }\r\n\r\n  /**\r\n   * Cleanup all spawned agents\r\n   *\r\n   * Kills all running agents and clears tracking.\r\n   */\r\n  async cleanup(): Promise<void> {\r\n    const runningAgents = this.getAllRunningAgents();\r\n\r\n    this.logger.info(`Cleaning up ${runningAgents.length} running agents...`);\r\n\r\n    for (const agentInfo of runningAgents) {\r\n      try {\r\n        await this.killAgent(agentInfo.agentId, 'SIGTERM');\r\n      } catch (error) {\r\n        this.logger.error(`Failed to cleanup agent ${agentInfo.agentId}`, error);\r\n      }\r\n    }\r\n\r\n    this.processes.clear();\r\n    this.logger.info('Agent cleanup complete');\r\n  }\r\n\r\n  /**\r\n   * Get statistics about spawned agents\r\n   *\r\n   * Returns summary of spawned agents by status.\r\n   */\r\n  getSpawnStatistics(): {\r\n    total: number;\r\n    running: number;\r\n    completed: number;\r\n    failed: number;\r\n  } {\r\n    const all = Array.from(this.processes.values());\r\n    const running = all.filter(info => info.exitCode === null && !info.killed);\r\n    const completed = all.filter(\r\n      info => info.exitCode === 0 && !info.killed\r\n    );\r\n    const failed = all.filter(\r\n      info => (info.exitCode !== 0 && info.exitCode !== null) || info.killed\r\n    );\r\n\r\n    return {\r\n      total: all.length,\r\n      running: running.length,\r\n      completed: completed.length,\r\n      failed: failed.length,\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function for creating spawner with sensible defaults\r\n */\r\nexport function createAgentSpawner(\r\n  logger: Logger,\r\n  config?: Partial<SpawnerConfig>\r\n): AgentSpawner {\r\n  return new AgentSpawner({\r\n    logger,\r\n    executionMode: config?.executionMode ?? 'unknown',\r\n    canUseRedis: config?.canUseRedis ?? false,\r\n    projectRoot: config?.projectRoot,\r\n    dockerEnabled: config?.dockerEnabled ?? false,\r\n  });\r\n}\r\n"],"names":["spawn","EventEmitter","CoordinationError","CoordinationErrorType","AgentSpawner","logger","executionMode","canUseRedis","projectRoot","dockerEnabled","processes","Map","config","process","cwd","spawnAgent","spawnCLIAgent","spawnTaskAgent","warn","args","agentType","taskId","agentId","iteration","undefined","push","toString","context","JSON","stringify","env","TASK_ID","AGENT_ID","CFN_MODE","environment","redisHost","REDIS_HOST","redisPort","REDIS_PORT","redisPassword","REDIS_PASSWORD","CFN_REDIS_PASSWORD","_spawnProcess","mode","maxRetries","lastError","attempt","spawnOptions","stdio","detached","timeout","timeoutMs","debug","pid","processInfo","startedAt","Date","toISOString","exitCode","signal","killed","set","_attachProcessHandlers","info","emit","error","delayMs","Math","min","pow","Promise","resolve","setTimeout","AGENT_SPAWN_ERROR","message","on","code","stdout","data","stderr","killAgent","get","kill","getAgentPID","getAgentProcessInfo","getAllRunningAgents","Array","from","values","filter","waitForAgent","startTime","now","reject","AGENT_NOT_FOUND","exitHandler","clearTimeout","timeoutHandle","removeListener","TIMEOUT","once","waitForAgents","agentIds","results","elapsedMs","remainingMs","cleanup","runningAgents","length","agentInfo","clear","getSpawnStatistics","all","running","completed","failed","total","createAgentSpawner"],"mappings":"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"}

package/dist/coordination/types-export.js

@@ -0,0 +1,38 @@
+/**
+ * Type definitions for coordination layer
+ *
+ * These are branded types for type safety. Since we can't reliably import
+ * from the external Redis coordination skill, we define them here.
+ */ /**
+ * Branded types for type safety
+ *
+ * These branded types prevent accidental mixing of different string values
+ * at compile time while remaining efficient at runtime.
+ */ /**
+ * Coordination error types
+ */ export var CoordinationErrorType = /*#__PURE__*/ function(CoordinationErrorType) {
+    CoordinationErrorType["MODE_MISMATCH"] = "MODE_MISMATCH";
+    CoordinationErrorType["REDIS_UNAVAILABLE"] = "REDIS_UNAVAILABLE";
+    CoordinationErrorType["TIMEOUT"] = "TIMEOUT";
+    CoordinationErrorType["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    CoordinationErrorType["MISSING_CONTEXT"] = "MISSING_CONTEXT";
+    CoordinationErrorType["INVALID_STATE"] = "INVALID_STATE";
+    CoordinationErrorType["AGENT_SPAWN_ERROR"] = "AGENT_SPAWN_ERROR";
+    CoordinationErrorType["AGENT_NOT_FOUND"] = "AGENT_NOT_FOUND";
+    CoordinationErrorType["REDIS_ERROR"] = "REDIS_ERROR";
+    return CoordinationErrorType;
+}({});
+/**
+ * Coordination error with mode awareness
+ */ export class CoordinationError extends Error {
+    type;
+    mode;
+    canRetry;
+    constructor(type, message, mode, canRetry = false){
+        super(message), this.type = type, this.mode = mode, this.canRetry = canRetry;
+        this.name = 'CoordinationError';
+        Object.setPrototypeOf(this, CoordinationError.prototype);
+    }
+}
+
+//# sourceMappingURL=types-export.js.map

package/dist/coordination/types-export.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/coordination/types-export.ts"],"sourcesContent":["/**\r\n * Type definitions for coordination layer\r\n *\r\n * These are branded types for type safety. Since we can't reliably import\r\n * from the external Redis coordination skill, we define them here.\r\n */\r\n\r\n/**\r\n * Branded types for type safety\r\n *\r\n * These branded types prevent accidental mixing of different string values\r\n * at compile time while remaining efficient at runtime.\r\n */\r\n\r\nexport type TaskId = string & { readonly __brand: 'TaskId' };\r\nexport type AgentId = string & { readonly __brand: 'AgentId' };\r\nexport type CorrelationId = string & { readonly __brand: 'CorrelationId' };\r\n\r\n/**\r\n * Execution mode enum\r\n */\r\nexport type ExecutionMode = 'task' | 'cli' | 'unknown';\r\n\r\n/**\r\n * Coordination error types\r\n */\r\nexport enum CoordinationErrorType {\r\n  MODE_MISMATCH = 'MODE_MISMATCH',\r\n  REDIS_UNAVAILABLE = 'REDIS_UNAVAILABLE',\r\n  TIMEOUT = 'TIMEOUT',\r\n  VALIDATION_ERROR = 'VALIDATION_ERROR',\r\n  MISSING_CONTEXT = 'MISSING_CONTEXT',\r\n  INVALID_STATE = 'INVALID_STATE',\r\n  AGENT_SPAWN_ERROR = 'AGENT_SPAWN_ERROR',\r\n  AGENT_NOT_FOUND = 'AGENT_NOT_FOUND',\r\n  REDIS_ERROR = 'REDIS_ERROR',\r\n}\r\n\r\n/**\r\n * Coordination error with mode awareness\r\n */\r\nexport class CoordinationError extends Error {\r\n  constructor(\r\n    public readonly type: CoordinationErrorType,\r\n    message: string,\r\n    public readonly mode?: ExecutionMode,\r\n    public readonly canRetry: boolean = false\r\n  ) {\r\n    super(message);\r\n    this.name = 'CoordinationError';\r\n    Object.setPrototypeOf(this, CoordinationError.prototype);\r\n  }\r\n}\r\n\r\n/**\r\n * Logger interface for dependency injection\r\n */\r\nexport interface Logger {\r\n  debug(message: string, ...args: unknown[]): void;\r\n  info(message: string, ...args: unknown[]): void;\r\n  warn(message: string, ...args: unknown[]): void;\r\n  error(message: string, ...args: unknown[]): void;\r\n}\r\n"],"names":["CoordinationErrorType","CoordinationError","Error","type","message","mode","canRetry","name","Object","setPrototypeOf","prototype"],"mappings":"AAAA;;;;;CAKC,GAED;;;;;CAKC,GAWD;;CAEC,GACD,OAAO,IAAA,AAAKA,+CAAAA;;;;;;;;;;WAAAA;MAUX;AAED;;CAEC,GACD,OAAO,MAAMC,0BAA0BC;;;;IACrC,YACE,AAAgBC,IAA2B,EAC3CC,OAAe,EACf,AAAgBC,IAAoB,EACpC,AAAgBC,WAAoB,KAAK,CACzC;QACA,KAAK,CAACF,eALUD,OAAAA,WAEAE,OAAAA,WACAC,WAAAA;QAGhB,IAAI,CAACC,IAAI,GAAG;QACZC,OAAOC,cAAc,CAAC,IAAI,EAAER,kBAAkBS,SAAS;IACzD;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-novice",
-  "version": "2.15.8",
+  "version": "2.15.10",
   "description": "AI agent orchestration framework with namespace-isolated skills, agents, and CFN Loop validation. Safe installation with ~0.01% collision risk.",
   "main": "dist/index.js",
   "type": "module",