claude-flow-novice 1.6.1 → 1.6.3

package/.claude-flow-novice/dist/src/coordination/v2/sdk/hierarchical-background-integration.js

@@ -0,0 +1,450 @@
+/**
+ * Agent Coordination V2 - Hierarchical Background Integration
+ *
+ * Sprint 5.2 Integration Layer
+ * Connects HierarchicalCoordinator with BackgroundOrchestrator for
+ * multi-level bash process spawning with 500ms failure detection.
+ *
+ * Key Features:
+ * - Multi-level spawning (Level 1-N) via BackgroundOrchestrator
+ * - Child process monitoring via BashOutputMonitor
+ * - 500ms failure detection latency
+ * - Cascade termination support
+ * - Clean process lifecycle management
+ *
+ * @module coordination/v2/sdk/hierarchical-background-integration
+ */ import { EventEmitter } from 'events';
+import { BackgroundOrchestrator } from './background-orchestrator.js';
+import { BashOutputMonitor } from './bash-output-monitor.js';
+import { Logger } from '../../../core/logger.js';
+/**
+ * Integration layer connecting HierarchicalCoordinator to BackgroundOrchestrator
+ *
+ * Manages background bash process spawning for hierarchical agent coordination.
+ *
+ * @example
+ * ```typescript
+ * const integration = new HierarchicalBackgroundIntegration(hierarchicalCoordinator, {
+ *   maxLevels: 10,
+ *   failureDetectionTimeout: 500
+ * });
+ *
+ * await integration.initialize();
+ *
+ * // Spawn child agent at Level 3
+ * const childProcess = await integration.spawnChildAgent(parentAgent, childConfig, 3);
+ *
+ * // Monitor all child processes
+ * await integration.monitorChildren(parentAgentId);
+ * ```
+ */ export class HierarchicalBackgroundIntegration extends EventEmitter {
+    logger;
+    config;
+    coordinator;
+    backgroundOrchestrator;
+    bashOutputMonitor;
+    agentToProcessMap = new Map();
+    processToAgentMap = new Map();
+    failureDetectionTimers = new Map();
+    isInitialized = false;
+    constructor(coordinator, config){
+        super();
+        this.coordinator = coordinator;
+        this.logger = new Logger({
+            level: 'info',
+            format: 'json',
+            destination: 'console'
+        }, {
+            component: 'HierarchicalBackgroundIntegration'
+        });
+        this.config = {
+            maxLevels: 10,
+            maxProcessesPerLevel: 20,
+            monitoringInterval: 500,
+            failureDetectionTimeout: 500,
+            autoCleanup: true,
+            cleanupRetentionMs: 60000,
+            ...config
+        };
+        this.backgroundOrchestrator = new BackgroundOrchestrator({
+            maxLevels: this.config.maxLevels,
+            maxProcessesPerLevel: this.config.maxProcessesPerLevel,
+            monitoringInterval: this.config.monitoringInterval,
+            autoCleanup: this.config.autoCleanup,
+            cleanupRetentionMs: this.config.cleanupRetentionMs
+        });
+        this.bashOutputMonitor = new BashOutputMonitor();
+    }
+    /**
+   * Initialize integration layer
+   */ async initialize() {
+        if (this.isInitialized) {
+            this.logger.warn('Integration already initialized');
+            return;
+        }
+        this.logger.info('Initializing hierarchical background integration...');
+        // Setup event listeners
+        this.setupEventHandlers();
+        this.isInitialized = true;
+        this.logger.info('Hierarchical background integration initialized');
+        this.emit('integration:initialized');
+    }
+    /**
+   * Spawn child agent as background bash process
+   *
+   * @param parentAgent - Parent hierarchical agent
+   * @param childConfig - Child agent configuration
+   * @param level - Spawning level (1-N)
+   * @returns Promise resolving to spawned BackgroundProcess
+   */ async spawnChildAgent(parentAgent, childConfig, level) {
+        if (!this.isInitialized) {
+            throw new Error('Integration not initialized. Call initialize() first.');
+        }
+        this.logger.info(`Spawning child agent at level ${level}`, {
+            parentId: parentAgent.id,
+            childId: childConfig.agentId,
+            level
+        });
+        // Create agent definition for BackgroundOrchestrator
+        const agent = {
+            agentId: childConfig.agentId,
+            type: childConfig.type,
+            priority: childConfig.priority || 5,
+            sessionId: childConfig.sessionId,
+            capabilities: childConfig.capabilities,
+            metadata: {
+                ...childConfig.metadata,
+                parentAgentId: parentAgent.id,
+                parentLevel: parentAgent.level,
+                coordinatorIntegration: true
+            }
+        };
+        // Get parent process ID if exists
+        const parentProcess = this.agentToProcessMap.get(parentAgent.id);
+        const parentProcessId = parentProcess?.id;
+        // Spawn background process via BackgroundOrchestrator
+        const childProcess = await this.backgroundOrchestrator.spawnBackground(agent, level, parentProcessId);
+        // Register mappings
+        this.agentToProcessMap.set(childConfig.agentId, childProcess);
+        this.processToAgentMap.set(childProcess.id, childConfig.agentId);
+        // Start bash output monitoring
+        this.bashOutputMonitor.startMonitoring(childProcess);
+        // Start failure detection with 500ms timeout
+        this.startFailureDetection(childProcess);
+        this.logger.info(`Child agent spawned at level ${level}`, {
+            processId: childProcess.id,
+            agentId: childConfig.agentId,
+            parentId: parentAgent.id
+        });
+        this.emit('child:spawned', {
+            processId: childProcess.id,
+            agentId: childConfig.agentId,
+            level,
+            parentId: parentAgent.id
+        });
+        return childProcess;
+    }
+    /**
+   * Monitor all child processes for a given parent agent
+   *
+   * @param parentAgentId - Parent agent ID to monitor children for
+   * @returns Array of monitored child processes
+   */ async monitorChildren(parentAgentId) {
+        const parentProcess = this.agentToProcessMap.get(parentAgentId);
+        if (!parentProcess) {
+            this.logger.warn('Parent agent has no associated process', {
+                parentAgentId
+            });
+            return [];
+        }
+        const children = this.backgroundOrchestrator.getChildProcesses(parentProcess.id);
+        this.logger.debug(`Monitoring ${children.length} children for parent ${parentAgentId}`);
+        // Ensure all children are being monitored
+        for (const child of children){
+            if (!this.bashOutputMonitor.getOutputs(child.id).length) {
+                this.bashOutputMonitor.startMonitoring(child);
+            }
+            // Ensure failure detection is active
+            if (!this.failureDetectionTimers.has(child.id)) {
+                this.startFailureDetection(child);
+            }
+        }
+        return children;
+    }
+    /**
+   * Get all processes at specific nesting level
+   *
+   * @param level - Nesting level to query
+   * @returns Array of BackgroundProcess at specified level
+   */ getProcessesAtLevel(level) {
+        return this.backgroundOrchestrator.getProcessesAtLevel(level);
+    }
+    /**
+   * Get child processes for a specific agent
+   *
+   * @param agentId - Agent ID to get children for
+   * @returns Array of child BackgroundProcess instances
+   */ getChildrenForAgent(agentId) {
+        const process = this.agentToProcessMap.get(agentId);
+        if (!process) {
+            return [];
+        }
+        return this.backgroundOrchestrator.getChildProcesses(process.id);
+    }
+    /**
+   * Pause background process for agent
+   *
+   * @param agentId - Agent to pause
+   */ async pauseAgent(agentId) {
+        const process = this.agentToProcessMap.get(agentId);
+        if (!process) {
+            throw new Error(`No background process for agent ${agentId}`);
+        }
+        await this.backgroundOrchestrator.pauseProcess(process.id);
+        this.logger.info('Agent background process paused', {
+            agentId,
+            processId: process.id
+        });
+        this.emit('agent:paused', {
+            agentId,
+            processId: process.id
+        });
+    }
+    /**
+   * Resume background process for agent
+   *
+   * @param agentId - Agent to resume
+   */ async resumeAgent(agentId) {
+        const process = this.agentToProcessMap.get(agentId);
+        if (!process) {
+            throw new Error(`No background process for agent ${agentId}`);
+        }
+        await this.backgroundOrchestrator.resumeProcess(process.id);
+        this.logger.info('Agent background process resumed', {
+            agentId,
+            processId: process.id
+        });
+        this.emit('agent:resumed', {
+            agentId,
+            processId: process.id
+        });
+    }
+    /**
+   * Terminate agent and all children (cascade)
+   *
+   * @param agentId - Agent to terminate
+   */ async terminateAgent(agentId) {
+        const process = this.agentToProcessMap.get(agentId);
+        if (!process) {
+            this.logger.warn('No background process found for agent', {
+                agentId
+            });
+            return;
+        }
+        // Clear failure detection timer
+        this.clearFailureDetection(process.id);
+        // Terminate process (cascade to children)
+        await this.backgroundOrchestrator.terminateProcess(process.id);
+        // Stop monitoring
+        this.bashOutputMonitor.stopMonitoring(process.id);
+        // Clean up mappings
+        this.agentToProcessMap.delete(agentId);
+        this.processToAgentMap.delete(process.id);
+        this.logger.info('Agent background process terminated', {
+            agentId,
+            processId: process.id
+        });
+        this.emit('agent:terminated', {
+            agentId,
+            processId: process.id
+        });
+    }
+    /**
+   * Terminate all processes at level and deeper (cascade)
+   *
+   * @param level - Starting level for termination
+   */ async terminateLevel(level) {
+        this.logger.info(`Terminating all processes at level ${level} and deeper`);
+        const processes = this.backgroundOrchestrator.getProcessesAtLevel(level);
+        for (const process of processes){
+            const agentId = this.processToAgentMap.get(process.id);
+            if (agentId) {
+                await this.terminateAgent(agentId);
+            }
+        }
+        await this.backgroundOrchestrator.terminateLevel(level);
+        this.logger.info(`Terminated all processes at level ${level}+`);
+        this.emit('level:terminated', {
+            level
+        });
+    }
+    /**
+   * Get background process for agent
+   *
+   * @param agentId - Agent ID
+   * @returns BackgroundProcess or undefined
+   */ getProcessForAgent(agentId) {
+        return this.agentToProcessMap.get(agentId);
+    }
+    /**
+   * Get agent ID for background process
+   *
+   * @param processId - Process ID
+   * @returns Agent ID or undefined
+   */ getAgentForProcess(processId) {
+        return this.processToAgentMap.get(processId);
+    }
+    /**
+   * Get bash output for agent process
+   *
+   * @param agentId - Agent ID
+   * @returns Combined stdout or empty string
+   */ getAgentOutput(agentId) {
+        const process = this.agentToProcessMap.get(agentId);
+        if (!process) {
+            return '';
+        }
+        return this.bashOutputMonitor.getCombinedStdout(process.id);
+    }
+    /**
+   * Get bash stderr for agent process
+   *
+   * @param agentId - Agent ID
+   * @returns Combined stderr or empty string
+   */ getAgentErrors(agentId) {
+        const process = this.agentToProcessMap.get(agentId);
+        if (!process) {
+            return '';
+        }
+        return this.bashOutputMonitor.getCombinedStderr(process.id);
+    }
+    /**
+   * Get integration statistics
+   */ getStats() {
+        const bgStats = this.backgroundOrchestrator.getStats();
+        const monitorStats = this.bashOutputMonitor.getStats();
+        return {
+            backgroundOrchestrator: bgStats,
+            bashOutputMonitor: monitorStats,
+            agentMappings: this.agentToProcessMap.size,
+            activeFailureDetection: this.failureDetectionTimers.size
+        };
+    }
+    /**
+   * Cleanup and shutdown integration
+   */ async cleanup() {
+        this.logger.info('Cleaning up hierarchical background integration...');
+        // Clear all failure detection timers
+        for (const [processId, timer] of Array.from(this.failureDetectionTimers.entries())){
+            clearTimeout(timer);
+        }
+        this.failureDetectionTimers.clear();
+        // Cleanup background orchestrator
+        await this.backgroundOrchestrator.cleanup();
+        // Cleanup bash output monitor
+        this.bashOutputMonitor.cleanup();
+        // Clear mappings
+        this.agentToProcessMap.clear();
+        this.processToAgentMap.clear();
+        this.isInitialized = false;
+        this.logger.info('Hierarchical background integration cleanup complete');
+        this.emit('integration:cleanup');
+    }
+    /**
+   * Start failure detection for background process
+   * Detects failures within 500ms
+   */ startFailureDetection(process) {
+        const timer = setTimeout(()=>{
+            // Check if process is still running
+            if (process.status === 'running') {
+                const latestOutput = this.bashOutputMonitor.getLatestOutput(process.id);
+                const stderr = this.bashOutputMonitor.getCombinedStderr(process.id);
+                // Check for error indicators
+                if (stderr && stderr.length > 0) {
+                    this.handleProcessFailure(process.id, new Error(`Process stderr: ${stderr.substring(0, 200)}`));
+                }
+            }
+            // Re-schedule failure detection
+            this.failureDetectionTimers.delete(process.id);
+            if (process.status === 'running') {
+                this.startFailureDetection(process);
+            }
+        }, this.config.failureDetectionTimeout);
+        this.failureDetectionTimers.set(process.id, timer);
+    }
+    /**
+   * Clear failure detection timer
+   */ clearFailureDetection(processId) {
+        const timer = this.failureDetectionTimers.get(processId);
+        if (timer) {
+            clearTimeout(timer);
+            this.failureDetectionTimers.delete(processId);
+        }
+    }
+    /**
+   * Handle process failure
+   */ async handleProcessFailure(processId, error) {
+        const agentId = this.processToAgentMap.get(processId);
+        this.logger.error('Background process failed', {
+            processId,
+            agentId,
+            error: error.message
+        });
+        // Mark process as failed in orchestrator
+        await this.backgroundOrchestrator.failProcess(processId, error);
+        // Clear failure detection
+        this.clearFailureDetection(processId);
+        this.emit('process:failed', {
+            processId,
+            agentId,
+            error: error.message
+        });
+    }
+    /**
+   * Setup event handlers for integration
+   */ setupEventHandlers() {
+        // BackgroundOrchestrator events
+        this.backgroundOrchestrator.on('process:spawned', (process)=>{
+            this.logger.debug('Background process spawned', {
+                processId: process.id
+            });
+        });
+        this.backgroundOrchestrator.on('process:terminated', (process)=>{
+            this.logger.debug('Background process terminated', {
+                processId: process.id
+            });
+            this.clearFailureDetection(process.id);
+        });
+        this.backgroundOrchestrator.on('process:failed', (process, error)=>{
+            this.logger.error('Background process failed event', {
+                processId: process.id,
+                error: error.message
+            });
+            this.clearFailureDetection(process.id);
+        });
+        // BashOutputMonitor events
+        this.bashOutputMonitor.on('process:error', ({ processId, stderr })=>{
+            this.logger.warn('Process stderr output detected', {
+                processId,
+                stderr: stderr.substring(0, 200)
+            });
+        });
+        this.bashOutputMonitor.on('monitoring:completed', ({ processId, exitCode })=>{
+            this.logger.debug('Process monitoring completed', {
+                processId,
+                exitCode
+            });
+            if (exitCode !== 0) {
+                const error = new Error(`Process exited with code ${exitCode}`);
+                this.handleProcessFailure(processId, error);
+            }
+        });
+    }
+}
+/**
+ * Factory function to create integration layer
+ */ export function createHierarchicalBackgroundIntegration(coordinator, config) {
+    return new HierarchicalBackgroundIntegration(coordinator, config);
+}
+
+//# sourceMappingURL=hierarchical-background-integration.js.map

package/.claude-flow-novice/dist/src/coordination/v2/sdk/hierarchical-background-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/coordination/v2/sdk/hierarchical-background-integration.ts"],"names":["EventEmitter","BackgroundOrchestrator","BashOutputMonitor","Logger","HierarchicalBackgroundIntegration","logger","config","coordinator","backgroundOrchestrator","bashOutputMonitor","agentToProcessMap","Map","processToAgentMap","failureDetectionTimers","isInitialized","level","format","destination","component","maxLevels","maxProcessesPerLevel","monitoringInterval","failureDetectionTimeout","autoCleanup","cleanupRetentionMs","initialize","warn","info","setupEventHandlers","emit","spawnChildAgent","parentAgent","childConfig","Error","parentId","id","childId","agentId","agent","type","priority","sessionId","capabilities","metadata","parentAgentId","parentLevel","coordinatorIntegration","parentProcess","get","parentProcessId","childProcess","spawnBackground","set","startMonitoring","startFailureDetection","processId","monitorChildren","children","getChildProcesses","debug","length","child","getOutputs","has","getProcessesAtLevel","getChildrenForAgent","process","pauseAgent","pauseProcess","resumeAgent","resumeProcess","terminateAgent","clearFailureDetection","terminateProcess","stopMonitoring","delete","terminateLevel","processes","getProcessForAgent","getAgentForProcess","getAgentOutput","getCombinedStdout","getAgentErrors","getCombinedStderr","getStats","bgStats","monitorStats","agentMappings","size","activeFailureDetection","cleanup","timer","Array","from","entries","clearTimeout","clear","setTimeout","status","latestOutput","getLatestOutput","stderr","handleProcessFailure","substring","error","message","failProcess","on","exitCode","createHierarchicalBackgroundIntegration"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,YAAY,QAAQ,SAAS;AAEtC,SAASC,sBAAsB,QAAQ,+BAA+B;AACtE,SAASC,iBAAiB,QAAQ,2BAA2B;AAE7D,SAASC,MAAM,QAAQ,0BAA0B;AAyBjD;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,MAAMC,0CAA0CJ;IAC7CK,OAAe;IACfC,OAAqC;IACrCC,YAAqC;IACrCC,uBAA+C;IAC/CC,kBAAqC;IACrCC,oBAAoD,IAAIC,MAAM;IAC9DC,oBAAyC,IAAID,MAAM;IACnDE,yBAAsD,IAAIF,MAAM;IAChEG,gBAAyB,MAAM;IAEvC,YACEP,WAAoC,EACpCD,MAA8C,CAC9C;QACA,KAAK;QAEL,IAAI,CAACC,WAAW,GAAGA;QACnB,IAAI,CAACF,MAAM,GAAG,IAAIF,OAChB;YAAEY,OAAO;YAAQC,QAAQ;YAAQC,aAAa;QAAU,GACxD;YAAEC,WAAW;QAAoC;QAGnD,IAAI,CAACZ,MAAM,GAAG;YACZa,WAAW;YACXC,sBAAsB;YACtBC,oBAAoB;YACpBC,yBAAyB;YACzBC,aAAa;YACbC,oBAAoB;YACpB,GAAGlB,MAAM;QACX;QAEA,IAAI,CAACE,sBAAsB,GAAG,IAAIP,uBAAuB;YACvDkB,WAAW,IAAI,CAACb,MAAM,CAACa,SAAS;YAChCC,sBAAsB,IAAI,CAACd,MAAM,CAACc,oBAAoB;YACtDC,oBAAoB,IAAI,CAACf,MAAM,CAACe,kBAAkB;YAClDE,aAAa,IAAI,CAACjB,MAAM,CAACiB,WAAW;YACpCC,oBAAoB,IAAI,CAAClB,MAAM,CAACkB,kBAAkB;QACpD;QAEA,IAAI,CAACf,iBAAiB,GAAG,IAAIP;IAC/B;IAEA;;GAEC,GACD,MAAMuB,aAA4B;QAChC,IAAI,IAAI,CAACX,aAAa,EAAE;YACtB,IAAI,CAACT,MAAM,CAACqB,IAAI,CAAC;YACjB;QACF;QAEA,IAAI,CAACrB,MAAM,CAACsB,IAAI,CAAC;QAEjB,wBAAwB;QACxB,IAAI,CAACC,kBAAkB;QAEvB,IAAI,CAACd,aAAa,GAAG;QACrB,IAAI,CAACT,MAAM,CAACsB,IAAI,CAAC;QACjB,IAAI,CAACE,IAAI,CAAC;IACZ;IAEA;;;;;;;GAOC,GACD,MAAMC,gBACJC,WAAkC,EAClCC,WAOC,EACDjB,KAAa,EACe;QAC5B,IAAI,CAAC,IAAI,CAACD,aAAa,EAAE;YACvB,MAAM,IAAImB,MAAM;QAClB;QAEA,IAAI,CAAC5B,MAAM,CAACsB,IAAI,CAAC,CAAC,8BAA8B,EAAEZ,OAAO,EAAE;YACzDmB,UAAUH,YAAYI,EAAE;YACxBC,SAASJ,YAAYK,OAAO;YAC5BtB;QACF;QAEA,qDAAqD;QACrD,MAAMuB,QAAe;YACnBD,SAASL,YAAYK,OAAO;YAC5BE,MAAMP,YAAYO,IAAI;YACtBC,UAAUR,YAAYQ,QAAQ,IAAI;YAClCC,WAAWT,YAAYS,SAAS;YAChCC,cAAcV,YAAYU,YAAY;YACtCC,UAAU;gBACR,GAAGX,YAAYW,QAAQ;gBACvBC,eAAeb,YAAYI,EAAE;gBAC7BU,aAAad,YAAYhB,KAAK;gBAC9B+B,wBAAwB;YAC1B;QACF;QAEA,kCAAkC;QAClC,MAAMC,gBAAgB,IAAI,CAACrC,iBAAiB,CAACsC,GAAG,CAACjB,YAAYI,EAAE;QAC/D,MAAMc,kBAAkBF,eAAeZ;QAEvC,sDAAsD;QACtD,MAAMe,eAAe,MAAM,IAAI,CAAC1C,sBAAsB,CAAC2C,eAAe,CACpEb,OACAvB,OACAkC;QAGF,oBAAoB;QACpB,IAAI,CAACvC,iBAAiB,CAAC0C,GAAG,CAACpB,YAAYK,OAAO,EAAEa;QAChD,IAAI,CAACtC,iBAAiB,CAACwC,GAAG,CAACF,aAAaf,EAAE,EAAEH,YAAYK,OAAO;QAE/D,+BAA+B;QAC/B,IAAI,CAAC5B,iBAAiB,CAAC4C,eAAe,CAACH;QAEvC,6CAA6C;QAC7C,IAAI,CAACI,qBAAqB,CAACJ;QAE3B,IAAI,CAAC7C,MAAM,CAACsB,IAAI,CAAC,CAAC,6BAA6B,EAAEZ,OAAO,EAAE;YACxDwC,WAAWL,aAAaf,EAAE;YAC1BE,SAASL,YAAYK,OAAO;YAC5BH,UAAUH,YAAYI,EAAE;QAC1B;QAEA,IAAI,CAACN,IAAI,CAAC,iBAAiB;YACzB0B,WAAWL,aAAaf,EAAE;YAC1BE,SAASL,YAAYK,OAAO;YAC5BtB;YACAmB,UAAUH,YAAYI,EAAE;QAC1B;QAEA,OAAOe;IACT;IAEA;;;;;GAKC,GACD,MAAMM,gBAAgBZ,aAAqB,EAAgC;QACzE,MAAMG,gBAAgB,IAAI,CAACrC,iBAAiB,CAACsC,GAAG,CAACJ;QACjD,IAAI,CAACG,eAAe;YAClB,IAAI,CAAC1C,MAAM,CAACqB,IAAI,CAAC,0CAA0C;gBAAEkB;YAAc;YAC3E,OAAO,EAAE;QACX;QAEA,MAAMa,WAAW,IAAI,CAACjD,sBAAsB,CAACkD,iBAAiB,CAACX,cAAcZ,EAAE;QAE/E,IAAI,CAAC9B,MAAM,CAACsD,KAAK,CAAC,CAAC,WAAW,EAAEF,SAASG,MAAM,CAAC,qBAAqB,EAAEhB,eAAe;QAEtF,0CAA0C;QAC1C,KAAK,MAAMiB,SAASJ,SAAU;YAC5B,IAAI,CAAC,IAAI,CAAChD,iBAAiB,CAACqD,UAAU,CAACD,MAAM1B,EAAE,EAAEyB,MAAM,EAAE;gBACvD,IAAI,CAACnD,iBAAiB,CAAC4C,eAAe,CAACQ;YACzC;YAEA,qCAAqC;YACrC,IAAI,CAAC,IAAI,CAAChD,sBAAsB,CAACkD,GAAG,CAACF,MAAM1B,EAAE,GAAG;gBAC9C,IAAI,CAACmB,qBAAqB,CAACO;YAC7B;QACF;QAEA,OAAOJ;IACT;IAEA;;;;;GAKC,GACDO,oBAAoBjD,KAAa,EAAuB;QACtD,OAAO,IAAI,CAACP,sBAAsB,CAACwD,mBAAmB,CAACjD;IACzD;IAEA;;;;;GAKC,GACDkD,oBAAoB5B,OAAe,EAAuB;QACxD,MAAM6B,UAAU,IAAI,CAACxD,iBAAiB,CAACsC,GAAG,CAACX;QAC3C,IAAI,CAAC6B,SAAS;YACZ,OAAO,EAAE;QACX;QAEA,OAAO,IAAI,CAAC1D,sBAAsB,CAACkD,iBAAiB,CAACQ,QAAQ/B,EAAE;IACjE;IAEA;;;;GAIC,GACD,MAAMgC,WAAW9B,OAAe,EAAiB;QAC/C,MAAM6B,UAAU,IAAI,CAACxD,iBAAiB,CAACsC,GAAG,CAACX;QAC3C,IAAI,CAAC6B,SAAS;YACZ,MAAM,IAAIjC,MAAM,CAAC,gCAAgC,EAAEI,SAAS;QAC9D;QAEA,MAAM,IAAI,CAAC7B,sBAAsB,CAAC4D,YAAY,CAACF,QAAQ/B,EAAE;QAEzD,IAAI,CAAC9B,MAAM,CAACsB,IAAI,CAAC,mCAAmC;YAClDU;YACAkB,WAAWW,QAAQ/B,EAAE;QACvB;QAEA,IAAI,CAACN,IAAI,CAAC,gBAAgB;YAAEQ;YAASkB,WAAWW,QAAQ/B,EAAE;QAAC;IAC7D;IAEA;;;;GAIC,GACD,MAAMkC,YAAYhC,OAAe,EAAiB;QAChD,MAAM6B,UAAU,IAAI,CAACxD,iBAAiB,CAACsC,GAAG,CAACX;QAC3C,IAAI,CAAC6B,SAAS;YACZ,MAAM,IAAIjC,MAAM,CAAC,gCAAgC,EAAEI,SAAS;QAC9D;QAEA,MAAM,IAAI,CAAC7B,sBAAsB,CAAC8D,aAAa,CAACJ,QAAQ/B,EAAE;QAE1D,IAAI,CAAC9B,MAAM,CAACsB,IAAI,CAAC,oCAAoC;YACnDU;YACAkB,WAAWW,QAAQ/B,EAAE;QACvB;QAEA,IAAI,CAACN,IAAI,CAAC,iBAAiB;YAAEQ;YAASkB,WAAWW,QAAQ/B,EAAE;QAAC;IAC9D;IAEA;;;;GAIC,GACD,MAAMoC,eAAelC,OAAe,EAAiB;QACnD,MAAM6B,UAAU,IAAI,CAACxD,iBAAiB,CAACsC,GAAG,CAACX;QAC3C,IAAI,CAAC6B,SAAS;YACZ,IAAI,CAAC7D,MAAM,CAACqB,IAAI,CAAC,yCAAyC;gBAAEW;YAAQ;YACpE;QACF;QAEA,gCAAgC;QAChC,IAAI,CAACmC,qBAAqB,CAACN,QAAQ/B,EAAE;QAErC,0CAA0C;QAC1C,MAAM,IAAI,CAAC3B,sBAAsB,CAACiE,gBAAgB,CAACP,QAAQ/B,EAAE;QAE7D,kBAAkB;QAClB,IAAI,CAAC1B,iBAAiB,CAACiE,cAAc,CAACR,QAAQ/B,EAAE;QAEhD,oBAAoB;QACpB,IAAI,CAACzB,iBAAiB,CAACiE,MAAM,CAACtC;QAC9B,IAAI,CAACzB,iBAAiB,CAAC+D,MAAM,CAACT,QAAQ/B,EAAE;QAExC,IAAI,CAAC9B,MAAM,CAACsB,IAAI,CAAC,uCAAuC;YACtDU;YACAkB,WAAWW,QAAQ/B,EAAE;QACvB;QAEA,IAAI,CAACN,IAAI,CAAC,oBAAoB;YAAEQ;YAASkB,WAAWW,QAAQ/B,EAAE;QAAC;IACjE;IAEA;;;;GAIC,GACD,MAAMyC,eAAe7D,KAAa,EAAiB;QACjD,IAAI,CAACV,MAAM,CAACsB,IAAI,CAAC,CAAC,mCAAmC,EAAEZ,MAAM,WAAW,CAAC;QAEzE,MAAM8D,YAAY,IAAI,CAACrE,sBAAsB,CAACwD,mBAAmB,CAACjD;QAElE,KAAK,MAAMmD,WAAWW,UAAW;YAC/B,MAAMxC,UAAU,IAAI,CAACzB,iBAAiB,CAACoC,GAAG,CAACkB,QAAQ/B,EAAE;YACrD,IAAIE,SAAS;gBACX,MAAM,IAAI,CAACkC,cAAc,CAAClC;YAC5B;QACF;QAEA,MAAM,IAAI,CAAC7B,sBAAsB,CAACoE,cAAc,CAAC7D;QAEjD,IAAI,CAACV,MAAM,CAACsB,IAAI,CAAC,CAAC,kCAAkC,EAAEZ,MAAM,CAAC,CAAC;QAC9D,IAAI,CAACc,IAAI,CAAC,oBAAoB;YAAEd;QAAM;IACxC;IAEA;;;;;GAKC,GACD+D,mBAAmBzC,OAAe,EAAiC;QACjE,OAAO,IAAI,CAAC3B,iBAAiB,CAACsC,GAAG,CAACX;IACpC;IAEA;;;;;GAKC,GACD0C,mBAAmBxB,SAAiB,EAAsB;QACxD,OAAO,IAAI,CAAC3C,iBAAiB,CAACoC,GAAG,CAACO;IACpC;IAEA;;;;;GAKC,GACDyB,eAAe3C,OAAe,EAAU;QACtC,MAAM6B,UAAU,IAAI,CAACxD,iBAAiB,CAACsC,GAAG,CAACX;QAC3C,IAAI,CAAC6B,SAAS;YACZ,OAAO;QACT;QAEA,OAAO,IAAI,CAACzD,iBAAiB,CAACwE,iBAAiB,CAACf,QAAQ/B,EAAE;IAC5D;IAEA;;;;;GAKC,GACD+C,eAAe7C,OAAe,EAAU;QACtC,MAAM6B,UAAU,IAAI,CAACxD,iBAAiB,CAACsC,GAAG,CAACX;QAC3C,IAAI,CAAC6B,SAAS;YACZ,OAAO;QACT;QAEA,OAAO,IAAI,CAACzD,iBAAiB,CAAC0E,iBAAiB,CAACjB,QAAQ/B,EAAE;IAC5D;IAEA;;GAEC,GACDiD,WAAW;QACT,MAAMC,UAAU,IAAI,CAAC7E,sBAAsB,CAAC4E,QAAQ;QACpD,MAAME,eAAe,IAAI,CAAC7E,iBAAiB,CAAC2E,QAAQ;QAEpD,OAAO;YACL5E,wBAAwB6E;YACxB5E,mBAAmB6E;YACnBC,eAAe,IAAI,CAAC7E,iBAAiB,CAAC8E,IAAI;YAC1CC,wBAAwB,IAAI,CAAC5E,sBAAsB,CAAC2E,IAAI;QAC1D;IACF;IAEA;;GAEC,GACD,MAAME,UAAyB;QAC7B,IAAI,CAACrF,MAAM,CAACsB,IAAI,CAAC;QAEjB,qCAAqC;QACrC,KAAK,MAAM,CAAC4B,WAAWoC,MAAM,IAAIC,MAAMC,IAAI,CAAC,IAAI,CAAChF,sBAAsB,CAACiF,OAAO,IAAK;YAClFC,aAAaJ;QACf;QACA,IAAI,CAAC9E,sBAAsB,CAACmF,KAAK;QAEjC,kCAAkC;QAClC,MAAM,IAAI,CAACxF,sBAAsB,CAACkF,OAAO;QAEzC,8BAA8B;QAC9B,IAAI,CAACjF,iBAAiB,CAACiF,OAAO;QAE9B,iBAAiB;QACjB,IAAI,CAAChF,iBAAiB,CAACsF,KAAK;QAC5B,IAAI,CAACpF,iBAAiB,CAACoF,KAAK;QAE5B,IAAI,CAAClF,aAAa,GAAG;QAErB,IAAI,CAACT,MAAM,CAACsB,IAAI,CAAC;QACjB,IAAI,CAACE,IAAI,CAAC;IACZ;IAEA;;;GAGC,GACD,AAAQyB,sBAAsBY,OAA0B,EAAQ;QAC9D,MAAMyB,QAAQM,WAAW;YACvB,oCAAoC;YACpC,IAAI/B,QAAQgC,MAAM,KAAK,WAAW;gBAChC,MAAMC,eAAe,IAAI,CAAC1F,iBAAiB,CAAC2F,eAAe,CAAClC,QAAQ/B,EAAE;gBACtE,MAAMkE,SAAS,IAAI,CAAC5F,iBAAiB,CAAC0E,iBAAiB,CAACjB,QAAQ/B,EAAE;gBAElE,6BAA6B;gBAC7B,IAAIkE,UAAUA,OAAOzC,MAAM,GAAG,GAAG;oBAC/B,IAAI,CAAC0C,oBAAoB,CAACpC,QAAQ/B,EAAE,EAAE,IAAIF,MAAM,CAAC,gBAAgB,EAAEoE,OAAOE,SAAS,CAAC,GAAG,MAAM;gBAC/F;YACF;YAEA,gCAAgC;YAChC,IAAI,CAAC1F,sBAAsB,CAAC8D,MAAM,CAACT,QAAQ/B,EAAE;YAC7C,IAAI+B,QAAQgC,MAAM,KAAK,WAAW;gBAChC,IAAI,CAAC5C,qBAAqB,CAACY;YAC7B;QACF,GAAG,IAAI,CAAC5D,MAAM,CAACgB,uBAAuB;QAEtC,IAAI,CAACT,sBAAsB,CAACuC,GAAG,CAACc,QAAQ/B,EAAE,EAAEwD;IAC9C;IAEA;;GAEC,GACD,AAAQnB,sBAAsBjB,SAAiB,EAAQ;QACrD,MAAMoC,QAAQ,IAAI,CAAC9E,sBAAsB,CAACmC,GAAG,CAACO;QAC9C,IAAIoC,OAAO;YACTI,aAAaJ;YACb,IAAI,CAAC9E,sBAAsB,CAAC8D,MAAM,CAACpB;QACrC;IACF;IAEA;;GAEC,GACD,MAAc+C,qBAAqB/C,SAAiB,EAAEiD,KAAY,EAAiB;QACjF,MAAMnE,UAAU,IAAI,CAACzB,iBAAiB,CAACoC,GAAG,CAACO;QAE3C,IAAI,CAAClD,MAAM,CAACmG,KAAK,CAAC,6BAA6B;YAC7CjD;YACAlB;YACAmE,OAAOA,MAAMC,OAAO;QACtB;QAEA,yCAAyC;QACzC,MAAM,IAAI,CAACjG,sBAAsB,CAACkG,WAAW,CAACnD,WAAWiD;QAEzD,0BAA0B;QAC1B,IAAI,CAAChC,qBAAqB,CAACjB;QAE3B,IAAI,CAAC1B,IAAI,CAAC,kBAAkB;YAC1B0B;YACAlB;YACAmE,OAAOA,MAAMC,OAAO;QACtB;IACF;IAEA;;GAEC,GACD,AAAQ7E,qBAA2B;QACjC,gCAAgC;QAChC,IAAI,CAACpB,sBAAsB,CAACmG,EAAE,CAAC,mBAAmB,CAACzC;YACjD,IAAI,CAAC7D,MAAM,CAACsD,KAAK,CAAC,8BAA8B;gBAAEJ,WAAWW,QAAQ/B,EAAE;YAAC;QAC1E;QAEA,IAAI,CAAC3B,sBAAsB,CAACmG,EAAE,CAAC,sBAAsB,CAACzC;YACpD,IAAI,CAAC7D,MAAM,CAACsD,KAAK,CAAC,iCAAiC;gBAAEJ,WAAWW,QAAQ/B,EAAE;YAAC;YAC3E,IAAI,CAACqC,qBAAqB,CAACN,QAAQ/B,EAAE;QACvC;QAEA,IAAI,CAAC3B,sBAAsB,CAACmG,EAAE,CAAC,kBAAkB,CAACzC,SAA4BsC;YAC5E,IAAI,CAACnG,MAAM,CAACmG,KAAK,CAAC,mCAAmC;gBACnDjD,WAAWW,QAAQ/B,EAAE;gBACrBqE,OAAOA,MAAMC,OAAO;YACtB;YACA,IAAI,CAACjC,qBAAqB,CAACN,QAAQ/B,EAAE;QACvC;QAEA,2BAA2B;QAC3B,IAAI,CAAC1B,iBAAiB,CAACkG,EAAE,CAAC,iBAAiB,CAAC,EAAEpD,SAAS,EAAE8C,MAAM,EAAyC;YACtG,IAAI,CAAChG,MAAM,CAACqB,IAAI,CAAC,kCAAkC;gBACjD6B;gBACA8C,QAAQA,OAAOE,SAAS,CAAC,GAAG;YAC9B;QACF;QAEA,IAAI,CAAC9F,iBAAiB,CAACkG,EAAE,CAAC,wBAAwB,CAAC,EAAEpD,SAAS,EAAEqD,QAAQ,EAA2C;YACjH,IAAI,CAACvG,MAAM,CAACsD,KAAK,CAAC,gCAAgC;gBAAEJ;gBAAWqD;YAAS;YAExE,IAAIA,aAAa,GAAG;gBAClB,MAAMJ,QAAQ,IAAIvE,MAAM,CAAC,yBAAyB,EAAE2E,UAAU;gBAC9D,IAAI,CAACN,oBAAoB,CAAC/C,WAAWiD;YACvC;QACF;IACF;AACF;AAEA;;CAEC,GACD,OAAO,SAASK,wCACdtG,WAAoC,EACpCD,MAA8C;IAE9C,OAAO,IAAIF,kCAAkCG,aAAaD;AAC5D"}

package/.claude-flow-novice/dist/src/coordination/v2/sdk/index.js

@@ -2,7 +2,12 @@
  * Agent Coordination V2 - SDK Module Exports
  */ export { CheckpointManager, CheckpointData, CheckpointMetrics, RestoreResult } from './checkpoint-manager.js';
 export { QueryController, QueryControllerConfig } from './query-controller.js';
+export { HelpCoordinator, HelpCoordinatorConfig, HelpCoordinatorMetrics, HelperAgent, HelpRequest, HelpAssignment } from './help-coordinator.js';
 export { FilesystemArtifactStorage } from './artifact-storage.js';
 export { StateSDKIntegration, StateSDKIntegrationConfig, StateSDKMetrics, StateChangeEventData } from './state-sdk-integration.js';
+export { BackgroundOrchestrator, BackgroundOrchestratorConfig, ProcessStats } from './background-orchestrator.js';
+export { BashOutputMonitor, ProcessOutput } from './bash-output-monitor.js';
+export { HierarchicalBackgroundIntegration, HierarchicalBackgroundConfig, createHierarchicalBackgroundIntegration } from './hierarchical-background-integration.js';
+export { SessionPoolOptimizer, SessionPoolConfig, PooledSession, PoolMetrics, SessionRequest } from './session-pool-optimizer.js';
 
 //# sourceMappingURL=index.js.map

package/.claude-flow-novice/dist/src/coordination/v2/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../src/coordination/v2/sdk/index.ts"],"names":["CheckpointManager","CheckpointData","CheckpointMetrics","RestoreResult","QueryController","QueryControllerConfig","FilesystemArtifactStorage","StateSDKIntegration","StateSDKIntegrationConfig","StateSDKMetrics","StateChangeEventData"],"mappings":"AAAA;;CAEC,GAED,SACEA,iBAAiB,EACjBC,cAAc,EACdC,iBAAiB,EACjBC,aAAa,QACR,0BAA0B;AAEjC,SACEC,eAAe,EACfC,qBAAqB,QAChB,wBAAwB;AAE/B,SAASC,yBAAyB,QAAQ,wBAAwB;AAElE,SACEC,mBAAmB,EACnBC,yBAAyB,EACzBC,eAAe,EACfC,oBAAoB,QACf,6BAA6B"}
+{"version":3,"sources":["../../../../../../src/coordination/v2/sdk/index.ts"],"names":["CheckpointManager","CheckpointData","CheckpointMetrics","RestoreResult","QueryController","QueryControllerConfig","HelpCoordinator","HelpCoordinatorConfig","HelpCoordinatorMetrics","HelperAgent","HelpRequest","HelpAssignment","FilesystemArtifactStorage","StateSDKIntegration","StateSDKIntegrationConfig","StateSDKMetrics","StateChangeEventData","BackgroundOrchestrator","BackgroundOrchestratorConfig","ProcessStats","BashOutputMonitor","ProcessOutput","HierarchicalBackgroundIntegration","HierarchicalBackgroundConfig","createHierarchicalBackgroundIntegration","SessionPoolOptimizer","SessionPoolConfig","PooledSession","PoolMetrics","SessionRequest"],"mappings":"AAAA;;CAEC,GAED,SACEA,iBAAiB,EACjBC,cAAc,EACdC,iBAAiB,EACjBC,aAAa,QACR,0BAA0B;AAEjC,SACEC,eAAe,EACfC,qBAAqB,QAChB,wBAAwB;AAE/B,SACEC,eAAe,EACfC,qBAAqB,EACrBC,sBAAsB,EACtBC,WAAW,EACXC,WAAW,EACXC,cAAc,QACT,wBAAwB;AAE/B,SAASC,yBAAyB,QAAQ,wBAAwB;AAElE,SACEC,mBAAmB,EACnBC,yBAAyB,EACzBC,eAAe,EACfC,oBAAoB,QACf,6BAA6B;AAEpC,SACEC,sBAAsB,EACtBC,4BAA4B,EAC5BC,YAAY,QACP,+BAA+B;AAEtC,SACEC,iBAAiB,EACjBC,aAAa,QACR,2BAA2B;AAElC,SACEC,iCAAiC,EACjCC,4BAA4B,EAC5BC,uCAAuC,QAClC,2CAA2C;AAElD,SACEC,oBAAoB,EACpBC,iBAAiB,EACjBC,aAAa,EACbC,WAAW,EACXC,cAAc,QACT,8BAA8B"}