claude-flow-novice 1.6.1 → 1.6.3

package/.claude-flow-novice/dist/src/coordination/v2/help-system/waiting-agent-pool.js

@@ -0,0 +1,512 @@
+/**
+ * Agent Coordination V2 - Waiting Agent Pool
+ *
+ * Zero-cost agent pool using SDK pause capabilities for dependency waiting.
+ * Supports 50+ paused agents with event-driven resume on help request arrival.
+ *
+ * Features:
+ * - Zero token consumption while paused (SDK pause integration)
+ * - <50ms resume latency on dependency resolution
+ * - Event-driven resume triggers
+ * - Timeout and retry logic
+ * - Priority-based resume ordering
+ * - Dependency tracking per waiting agent
+ *
+ * @module coordination/v2/help-system/waiting-agent-pool
+ */ import { EventEmitter } from 'node:events';
+import { Logger } from '../../../core/logger.js';
+import { generateId } from '../../../utils/helpers.js';
+/**
+ * Waiting Agent Pool - Zero-cost paused agent management.
+ *
+ * Manages agents waiting for dependencies using SDK pause capabilities.
+ * Agents consume zero tokens while waiting, and are resumed within <50ms
+ * when their dependencies are resolved.
+ *
+ * @example
+ * ```typescript
+ * const pool = new WaitingAgentPool(queryController);
+ * await pool.initialize();
+ *
+ * // Agent waiting for help
+ * await pool.addWaitingAgent({
+ *   agentId: 'agent-1',
+ *   sessionId: 'session-1',
+ *   state: 'waiting',
+ *   priority: 8,
+ *   pendingDependencies: ['help-request-123'],
+ *   metadata: { reason: 'waiting for assistance', taskId: 'task-1' }
+ * });
+ *
+ * // Dependency resolved - agent auto-resumes
+ * await pool.resolveDependency('help-request-123');
+ *
+ * // Cleanup
+ * await pool.shutdown();
+ * ```
+ */ export class WaitingAgentPool extends EventEmitter {
+    logger;
+    config;
+    queryController;
+    waitingAgents;
+    agentsByDependency;
+    timeoutCheckTimer;
+    metrics;
+    initialized = false;
+    startTime;
+    /**
+   * Creates a new waiting agent pool.
+   *
+   * @param queryController - QueryController instance for pause/resume operations
+   * @param config - Pool configuration options
+   */ constructor(queryController, config){
+        super();
+        this.logger = new Logger({
+            level: 'info',
+            format: 'text',
+            destination: 'console'
+        });
+        this.queryController = queryController;
+        this.config = {
+            maxConcurrentWaiting: config?.maxConcurrentWaiting ?? 50,
+            defaultMaxWaitMs: config?.defaultMaxWaitMs ?? 300000,
+            defaultMaxRetries: config?.defaultMaxRetries ?? 3,
+            timeoutCheckIntervalMs: config?.timeoutCheckIntervalMs ?? 5000,
+            tokenSavingsRate: config?.tokenSavingsRate ?? 0.1
+        };
+        this.waitingAgents = new Map();
+        this.agentsByDependency = new Map();
+        this.metrics = this.initializeMetrics();
+        this.startTime = Date.now();
+    }
+    /**
+   * Initializes the waiting agent pool.
+   * Starts timeout checker and sets up event listeners.
+   */ async initialize() {
+        if (this.initialized) {
+            this.logger.warn('WaitingAgentPool already initialized');
+            return;
+        }
+        this.logger.info('Initializing waiting agent pool', {
+            maxConcurrentWaiting: this.config.maxConcurrentWaiting,
+            defaultMaxWaitMs: this.config.defaultMaxWaitMs
+        });
+        // Start timeout check timer
+        this.startTimeoutChecker();
+        // Listen for QueryController resume events
+        this.queryController.on('agent:resumed', (event)=>{
+            this.handleAgentResumed(event.agentId);
+        });
+        this.initialized = true;
+        this.emit('pool:initialized');
+        this.logger.info('Waiting agent pool initialized');
+    }
+    /**
+   * Adds an agent to the waiting pool with SDK pause.
+   *
+   * @param config - Waiting agent configuration
+   * @returns Waiting agent entry ID
+   * @throws Error if pool is at capacity or agent already waiting
+   */ async addWaitingAgent(config) {
+        const startTime = Date.now();
+        if (!this.initialized) {
+            throw new Error('WaitingAgentPool not initialized. Call initialize() first.');
+        }
+        // Check capacity
+        if (this.waitingAgents.size >= this.config.maxConcurrentWaiting) {
+            throw new Error(`Waiting agent pool at capacity (${this.config.maxConcurrentWaiting} agents)`);
+        }
+        // Check if agent already waiting
+        const existingAgent = Array.from(this.waitingAgents.values()).find((a)=>a.agentId === config.agentId);
+        if (existingAgent) {
+            throw new Error(`Agent ${config.agentId} is already in waiting pool`);
+        }
+        // Validate dependencies
+        if (config.pendingDependencies.length === 0) {
+            throw new Error('Agent must have at least one pending dependency');
+        }
+        // Create waiting agent entry
+        const waitingId = generateId('waiting');
+        const waitingAgent = {
+            id: waitingId,
+            agentId: config.agentId,
+            sessionId: config.sessionId,
+            state: config.state,
+            priority: config.priority,
+            pendingDependencies: [
+                ...config.pendingDependencies
+            ],
+            waitingSince: new Date(),
+            maxWaitMs: config.maxWaitMs ?? this.config.defaultMaxWaitMs,
+            retryCount: 0,
+            maxRetries: config.maxRetries ?? this.config.defaultMaxRetries,
+            metadata: config.metadata
+        };
+        // Add to pool
+        this.waitingAgents.set(waitingId, waitingAgent);
+        // Index by dependencies
+        for (const depId of config.pendingDependencies){
+            if (!this.agentsByDependency.has(depId)) {
+                this.agentsByDependency.set(depId, new Set());
+            }
+            this.agentsByDependency.get(depId).add(config.agentId);
+        }
+        // Pause agent via SDK (zero token consumption)
+        try {
+            await this.queryController.interrupt(config.sessionId, `Waiting for dependencies: ${config.pendingDependencies.join(', ')}`);
+            this.logger.info('Agent added to waiting pool and paused', {
+                agentId: config.agentId,
+                waitingId,
+                dependencies: config.pendingDependencies,
+                priority: config.priority
+            });
+        } catch (error) {
+            // Rollback on pause failure
+            this.waitingAgents.delete(waitingId);
+            for (const depId of config.pendingDependencies){
+                this.agentsByDependency.get(depId)?.delete(config.agentId);
+            }
+            throw new Error(`Failed to pause agent ${config.agentId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Update metrics
+        this.metrics.totalWaiting = this.waitingAgents.size;
+        this.metrics.totalPaused++;
+        this.metrics.maxConcurrentWaiting = Math.max(this.metrics.maxConcurrentWaiting, this.waitingAgents.size);
+        const latencyMs = Date.now() - startTime;
+        this.emit('agent:waiting', {
+            waitingAgent,
+            latencyMs
+        });
+        return waitingId;
+    }
+    /**
+   * Resolves a dependency and resumes all agents waiting for it.
+   *
+   * @param dependencyId - ID of the resolved dependency
+   * @returns Array of resumed agent IDs
+   */ async resolveDependency(dependencyId) {
+        const startTime = Date.now();
+        const waitingAgentIds = this.agentsByDependency.get(dependencyId);
+        if (!waitingAgentIds || waitingAgentIds.size === 0) {
+            this.logger.debug('No agents waiting for dependency', {
+                dependencyId
+            });
+            return [];
+        }
+        const resumedAgents = [];
+        // Resume agents waiting for this dependency
+        for (const agentId of Array.from(waitingAgentIds)){
+            try {
+                const resumed = await this.resumeAgentForDependency(agentId, dependencyId);
+                if (resumed) {
+                    resumedAgents.push(agentId);
+                }
+            } catch (error) {
+                this.logger.error('Failed to resume agent for dependency', {
+                    agentId,
+                    dependencyId,
+                    error: error instanceof Error ? error.message : String(error)
+                });
+            }
+        }
+        // Clean up dependency index
+        this.agentsByDependency.delete(dependencyId);
+        const latencyMs = Date.now() - startTime;
+        this.logger.info('Dependency resolved, agents resumed', {
+            dependencyId,
+            resumedCount: resumedAgents.length,
+            latencyMs
+        });
+        this.emit('dependency:resolved', {
+            dependencyId,
+            resumedAgents,
+            latencyMs
+        });
+        return resumedAgents;
+    }
+    /**
+   * Manually resumes a waiting agent.
+   *
+   * @param agentId - Agent ID to resume
+   * @param reason - Reason for manual resume
+   * @returns True if agent was resumed, false if not found
+   */ async resumeAgent(agentId, reason = 'Manual resume') {
+        const waitingAgent = this.findWaitingAgent(agentId);
+        if (!waitingAgent) {
+            this.logger.warn('Agent not found in waiting pool', {
+                agentId
+            });
+            return false;
+        }
+        return await this.resumeWaitingAgent(waitingAgent, {
+            type: 'manual',
+            agentId,
+            metadata: {
+                reason
+            }
+        });
+    }
+    /**
+   * Removes an agent from the waiting pool without resuming.
+   *
+   * @param agentId - Agent ID to remove
+   * @returns True if removed, false if not found
+   */ removeWaitingAgent(agentId) {
+        const waitingAgent = this.findWaitingAgent(agentId);
+        if (!waitingAgent) {
+            return false;
+        }
+        // Clean up dependency indices
+        for (const depId of waitingAgent.pendingDependencies){
+            this.agentsByDependency.get(depId)?.delete(agentId);
+            if (this.agentsByDependency.get(depId)?.size === 0) {
+                this.agentsByDependency.delete(depId);
+            }
+        }
+        // Remove from pool
+        this.waitingAgents.delete(waitingAgent.id);
+        this.metrics.totalWaiting = this.waitingAgents.size;
+        this.logger.debug('Agent removed from waiting pool', {
+            agentId
+        });
+        this.emit('agent:removed', {
+            agentId
+        });
+        return true;
+    }
+    /**
+   * Gets all waiting agents sorted by priority (descending).
+   *
+   * @returns Array of waiting agents
+   */ getWaitingAgents() {
+        return Array.from(this.waitingAgents.values()).sort((a, b)=>b.priority - a.priority);
+    }
+    /**
+   * Gets waiting agent by agent ID.
+   *
+   * @param agentId - Agent ID to find
+   * @returns Waiting agent if found, undefined otherwise
+   */ getWaitingAgent(agentId) {
+        return this.findWaitingAgent(agentId);
+    }
+    /**
+   * Gets all agents waiting for a specific dependency.
+   *
+   * @param dependencyId - Dependency ID
+   * @returns Array of agent IDs
+   */ getAgentsWaitingFor(dependencyId) {
+        return Array.from(this.agentsByDependency.get(dependencyId) || []);
+    }
+    /**
+   * Gets pool metrics.
+   *
+   * @returns Current pool metrics
+   */ getMetrics() {
+        // Update token savings estimate
+        const uptimeSeconds = (Date.now() - this.startTime) / 1000;
+        this.metrics.estimatedTokensSaved = Math.floor(this.metrics.totalPaused * this.config.tokenSavingsRate * uptimeSeconds);
+        return {
+            ...this.metrics
+        };
+    }
+    /**
+   * Shuts down the waiting agent pool.
+   * Stops timeout checker and cleans up resources.
+   */ async shutdown() {
+        if (!this.initialized) {
+            return;
+        }
+        this.logger.info('Shutting down waiting agent pool', {
+            waitingAgents: this.waitingAgents.size
+        });
+        // Stop timeout checker
+        if (this.timeoutCheckTimer) {
+            clearInterval(this.timeoutCheckTimer);
+            this.timeoutCheckTimer = undefined;
+        }
+        // Clear all data
+        this.waitingAgents.clear();
+        this.agentsByDependency.clear();
+        this.removeAllListeners();
+        this.initialized = false;
+        this.emit('pool:shutdown');
+        this.logger.info('Waiting agent pool shut down');
+    }
+    // ============================================
+    // Private Methods
+    // ============================================
+    /**
+   * Initializes pool metrics.
+   */ initializeMetrics() {
+        return {
+            totalWaiting: 0,
+            totalPaused: 0,
+            totalResumes: 0,
+            totalTimeouts: 0,
+            averageResumeLatencyMs: 0,
+            maxConcurrentWaiting: 0,
+            totalRetries: 0,
+            estimatedTokensSaved: 0
+        };
+    }
+    /**
+   * Starts the timeout checker interval.
+   */ startTimeoutChecker() {
+        this.timeoutCheckTimer = setInterval(()=>{
+            this.checkTimeouts();
+        }, this.config.timeoutCheckIntervalMs);
+    }
+    /**
+   * Checks for timed-out waiting agents and handles them.
+   */ checkTimeouts() {
+        const now = Date.now();
+        for (const waitingAgent of Array.from(this.waitingAgents.values())){
+            const waitTimeMs = now - waitingAgent.waitingSince.getTime();
+            if (waitTimeMs >= waitingAgent.maxWaitMs) {
+                this.handleTimeout(waitingAgent);
+            }
+        }
+    }
+    /**
+   * Handles timeout for a waiting agent.
+   *
+   * @param waitingAgent - Timed-out agent
+   */ async handleTimeout(waitingAgent) {
+        this.logger.warn('Agent wait timeout', {
+            agentId: waitingAgent.agentId,
+            waitTimeMs: Date.now() - waitingAgent.waitingSince.getTime(),
+            maxWaitMs: waitingAgent.maxWaitMs,
+            pendingDependencies: waitingAgent.pendingDependencies
+        });
+        // Check retry count
+        if (waitingAgent.retryCount < waitingAgent.maxRetries) {
+            // Retry - extend wait time
+            waitingAgent.retryCount++;
+            waitingAgent.waitingSince = new Date();
+            this.metrics.totalRetries++;
+            this.logger.info('Retrying timed-out agent', {
+                agentId: waitingAgent.agentId,
+                retryCount: waitingAgent.retryCount,
+                maxRetries: waitingAgent.maxRetries
+            });
+            this.emit('agent:retry', {
+                agentId: waitingAgent.agentId,
+                retryCount: waitingAgent.retryCount
+            });
+        } else {
+            // Max retries exceeded - resume with timeout trigger
+            this.metrics.totalTimeouts++;
+            await this.resumeWaitingAgent(waitingAgent, {
+                type: 'timeout',
+                agentId: waitingAgent.agentId,
+                metadata: {
+                    reason: 'Max wait time exceeded',
+                    pendingDependencies: waitingAgent.pendingDependencies
+                }
+            });
+        }
+    }
+    /**
+   * Resumes an agent waiting for a specific dependency.
+   *
+   * @param agentId - Agent ID
+   * @param dependencyId - Resolved dependency ID
+   * @returns True if resumed, false otherwise
+   */ async resumeAgentForDependency(agentId, dependencyId) {
+        const waitingAgent = this.findWaitingAgent(agentId);
+        if (!waitingAgent) {
+            return false;
+        }
+        // Remove dependency from pending list
+        const depIndex = waitingAgent.pendingDependencies.indexOf(dependencyId);
+        if (depIndex !== -1) {
+            waitingAgent.pendingDependencies.splice(depIndex, 1);
+        }
+        // Check if all dependencies resolved
+        if (waitingAgent.pendingDependencies.length === 0) {
+            // All dependencies resolved - resume agent
+            return await this.resumeWaitingAgent(waitingAgent, {
+                type: 'dependency_resolved',
+                agentId,
+                resolvedDependencyId: dependencyId
+            });
+        } else {
+            // Still has pending dependencies - keep waiting
+            this.logger.debug('Agent still waiting for dependencies', {
+                agentId,
+                resolvedDependency: dependencyId,
+                remainingDependencies: waitingAgent.pendingDependencies
+            });
+            return false;
+        }
+    }
+    /**
+   * Resumes a waiting agent via SDK.
+   *
+   * @param waitingAgent - Agent to resume
+   * @param trigger - Resume trigger event
+   * @returns True if resumed successfully
+   */ async resumeWaitingAgent(waitingAgent, trigger) {
+        const startTime = Date.now();
+        try {
+            // Resume via QueryController
+            await this.queryController.resumeSessionAt(waitingAgent.sessionId, undefined, `Resume trigger: ${trigger.type}`);
+            // Remove from pool
+            this.waitingAgents.delete(waitingAgent.id);
+            // Clean up dependency indices
+            for (const depId of waitingAgent.pendingDependencies){
+                this.agentsByDependency.get(depId)?.delete(waitingAgent.agentId);
+            }
+            const latencyMs = Date.now() - startTime;
+            // Update metrics
+            this.metrics.totalWaiting = this.waitingAgents.size;
+            this.metrics.totalResumes++;
+            this.metrics.averageResumeLatencyMs = (this.metrics.averageResumeLatencyMs * (this.metrics.totalResumes - 1) + latencyMs) / this.metrics.totalResumes;
+            this.logger.info('Waiting agent resumed', {
+                agentId: waitingAgent.agentId,
+                triggerType: trigger.type,
+                latencyMs,
+                waitTimeMs: Date.now() - waitingAgent.waitingSince.getTime()
+            });
+            this.emit('agent:resumed', {
+                waitingAgent,
+                trigger,
+                latencyMs
+            });
+            return true;
+        } catch (error) {
+            this.logger.error('Failed to resume waiting agent', {
+                agentId: waitingAgent.agentId,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            this.emit('agent:resume-failed', {
+                agentId: waitingAgent.agentId,
+                error
+            });
+            return false;
+        }
+    }
+    /**
+   * Finds a waiting agent by agent ID.
+   *
+   * @param agentId - Agent ID to find
+   * @returns Waiting agent if found
+   */ findWaitingAgent(agentId) {
+        for (const waitingAgent of Array.from(this.waitingAgents.values())){
+            if (waitingAgent.agentId === agentId) {
+                return waitingAgent;
+            }
+        }
+        return undefined;
+    }
+    /**
+   * Handles agent resumed event from QueryController.
+   *
+   * @param agentId - Resumed agent ID
+   */ handleAgentResumed(agentId) {
+        // Ensure agent is removed from pool if still present
+        this.removeWaitingAgent(agentId);
+    }
+}
+
+//# sourceMappingURL=waiting-agent-pool.js.map

package/.claude-flow-novice/dist/src/coordination/v2/help-system/waiting-agent-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/coordination/v2/help-system/waiting-agent-pool.ts"],"names":["EventEmitter","Logger","generateId","WaitingAgentPool","logger","config","queryController","waitingAgents","agentsByDependency","timeoutCheckTimer","metrics","initialized","startTime","level","format","destination","maxConcurrentWaiting","defaultMaxWaitMs","defaultMaxRetries","timeoutCheckIntervalMs","tokenSavingsRate","Map","initializeMetrics","Date","now","initialize","warn","info","startTimeoutChecker","on","event","handleAgentResumed","agentId","emit","addWaitingAgent","Error","size","existingAgent","Array","from","values","find","a","pendingDependencies","length","waitingId","waitingAgent","id","sessionId","state","priority","waitingSince","maxWaitMs","retryCount","maxRetries","metadata","set","depId","has","Set","get","add","interrupt","join","dependencies","error","delete","message","String","totalWaiting","totalPaused","Math","max","latencyMs","resolveDependency","dependencyId","waitingAgentIds","debug","resumedAgents","resumed","resumeAgentForDependency","push","resumedCount","resumeAgent","reason","findWaitingAgent","resumeWaitingAgent","type","removeWaitingAgent","getWaitingAgents","sort","b","getWaitingAgent","getAgentsWaitingFor","getMetrics","uptimeSeconds","estimatedTokensSaved","floor","shutdown","clearInterval","undefined","clear","removeAllListeners","totalResumes","totalTimeouts","averageResumeLatencyMs","totalRetries","setInterval","checkTimeouts","waitTimeMs","getTime","handleTimeout","depIndex","indexOf","splice","resolvedDependencyId","resolvedDependency","remainingDependencies","trigger","resumeSessionAt","triggerType"],"mappings":"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"}

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

@@ -7,6 +7,8 @@
  * @module coordination/v2
  */ // Factory for coordinator creation
 export { CoordinatorFactory } from './coordinator-factory.js';
+// Unified SwarmCoordinatorV2 (Phase 9 - integrates all V2 components)
+export { SwarmCoordinatorV2, SwarmTopology } from './coordinators/swarm-coordinator-v2.js';
 // SDK implementation (QueryController)
 export { QueryController } from './sdk/query-controller.js';
 // SDK utilities and helpers
@@ -18,6 +20,10 @@ export * from './utils/sdk-helpers.js';
 export { MessageRouter } from './core/message-router.js';
 export { DeadLetterQueue } from './core/dead-letter-queue.js';
 export { MessageStorage } from './memory/message-storage.js';
+// Help System
+export { HelpRequest, HelpRequestStatus, HelpRequestPriority, HelpMatcher, HelpCoordinator } from './help-system/index.js';
+// Deadlock Detection & Recovery
+export { DeadlockDetector } from './deadlock/index.js';
  /**
  * Quick Start Examples:
  *

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/coordination/v2/index.ts"],"names":["CoordinatorFactory","QueryController","BackgroundOrchestrator","BashOutputMonitor","FilesystemArtifactStorage","MessageRouter","DeadLetterQueue","MessageStorage"],"mappings":"AAAA;;;;;;;CAOC,GAED,mCAAmC;AACnC,SAASA,kBAAkB,QAAoD,2BAA2B;AAW1G,uCAAuC;AACvC,SAASC,eAAe,QAAoC,4BAA4B;AAExF,4BAA4B;AAC5B,SAASC,sBAAsB,QAA2C,mCAAmC;AAC7G,SAASC,iBAAiB,QAA4B,+BAA+B;AACrF,SAASC,yBAAyB,QAAoC,4BAA4B;AAClG,cAAc,yBAAyB;AAEvC,4BAA4B;AAC5B,SAASC,aAAa,QAAQ,2BAA2B;AACzD,SAASC,eAAe,QAA+D,8BAA8B;AACrH,SAASC,cAAc,QAAQ,8BAA8B;CAe7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCC"}
+{"version":3,"sources":["../../../../../src/coordination/v2/index.ts"],"names":["CoordinatorFactory","SwarmCoordinatorV2","SwarmTopology","QueryController","BackgroundOrchestrator","BashOutputMonitor","FilesystemArtifactStorage","MessageRouter","DeadLetterQueue","MessageStorage","HelpRequest","HelpRequestStatus","HelpRequestPriority","HelpMatcher","HelpCoordinator","DeadlockDetector"],"mappings":"AAAA;;;;;;;CAOC,GAED,mCAAmC;AACnC,SAASA,kBAAkB,QAAoD,2BAA2B;AAW1G,sEAAsE;AACtE,SACEC,kBAAkB,EAClBC,aAAa,QAKR,yCAAyC;AAEhD,uCAAuC;AACvC,SAASC,eAAe,QAAoC,4BAA4B;AAExF,4BAA4B;AAC5B,SAASC,sBAAsB,QAA2C,mCAAmC;AAC7G,SAASC,iBAAiB,QAA4B,+BAA+B;AACrF,SAASC,yBAAyB,QAAoC,4BAA4B;AAClG,cAAc,yBAAyB;AAEvC,4BAA4B;AAC5B,SAASC,aAAa,QAAQ,2BAA2B;AACzD,SAASC,eAAe,QAA+D,8BAA8B;AACrH,SAASC,cAAc,QAAQ,8BAA8B;AAE7D,cAAc;AACd,SACEC,WAAW,EACXC,iBAAiB,EACjBC,mBAAmB,EACnBC,WAAW,EACXC,eAAe,QAaV,yBAAyB;AAEhC,gCAAgC;AAChC,SACEC,gBAAgB,QAMX,sBAAsB;CAe7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCC"}