@nexus-cortex/core 4.26.0

package/dist/orchestrator/SubAgentEventEmitter.js

@@ -0,0 +1,372 @@
+/**
+ * Sub-Agent Event Emitter
+ *
+ * Typed event emitter for sub-agent communication.
+ * Provides real-time streaming of sub-agent activities to the parent
+ * orchestrator and CLI components.
+ *
+ * @module orchestrator/SubAgentEventEmitter
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+/**
+ * Typed event emitter for sub-agent events
+ *
+ * Extends Node's EventEmitter with type-safe event handling
+ * for the sub-agent system.
+ */
+export class SubAgentEventEmitter extends EventEmitter {
+    activeAgentIds = new Set();
+    eventLog = [];
+    maxLogSize = 1000;
+    constructor() {
+        super();
+        // Set higher max listeners to support many concurrent agents
+        this.setMaxListeners(50);
+    }
+    /**
+     * Emit a typed event
+     */
+    emit(event, data) {
+        // Log event for debugging/monitoring
+        const agentId = 'agentId' in data ? data.agentId : 'unknown';
+        this.logEvent(event, agentId);
+        // Track agent lifecycle
+        if (event === 'agent:started') {
+            this.activeAgentIds.add(agentId);
+        }
+        else if (event === 'agent:completed' ||
+            event === 'agent:error' ||
+            event === 'agent:interrupted' ||
+            event === 'agent:timeout') {
+            this.activeAgentIds.delete(agentId);
+        }
+        return super.emit(event, data);
+    }
+    /**
+     * Add a typed event listener
+     */
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    /**
+     * Add a one-time typed event listener
+     */
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    /**
+     * Remove a typed event listener
+     */
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Convenience Methods for Emitting Common Events
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Emit agent started event
+     */
+    emitStarted(agentId, agentName, model, task, parentSessionId) {
+        this.emit('agent:started', {
+            agentId,
+            agentName,
+            model,
+            task,
+            parentSessionId,
+        });
+    }
+    /**
+     * Emit progress update
+     */
+    emitProgress(agentId, turnNumber, totalTokens, elapsedMs) {
+        this.emit('agent:progress', {
+            agentId,
+            turnNumber,
+            totalTokens,
+            elapsedMs,
+        });
+    }
+    /**
+     * Emit tool call event
+     */
+    emitToolCall(agentId, toolName, toolInput, toolId) {
+        this.emit('agent:tool_call', {
+            agentId,
+            toolName,
+            toolInput,
+            toolId,
+        });
+    }
+    /**
+     * Emit tool result event
+     */
+    emitToolResult(agentId, toolName, toolId, success, summary, durationMs) {
+        this.emit('agent:tool_result', {
+            agentId,
+            toolName,
+            toolId,
+            success,
+            summary,
+            durationMs,
+        });
+    }
+    /**
+     * Emit thinking text
+     */
+    emitThinking(agentId, thinkingText) {
+        this.emit('agent:thinking', {
+            agentId,
+            thinkingText,
+        });
+    }
+    /**
+     * Emit text output
+     */
+    emitText(agentId, text, isFinal = false) {
+        this.emit('agent:text', {
+            agentId,
+            text,
+            isFinal,
+        });
+    }
+    /**
+     * Emit approval required event
+     */
+    emitApprovalRequired(agentId, agentName, toolName, toolInput, reason) {
+        this.emit('agent:approval_required', {
+            agentId,
+            agentName,
+            toolName,
+            toolInput,
+            reason,
+        });
+    }
+    /**
+     * Emit agent completed event
+     */
+    emitCompleted(agentId, result) {
+        this.emit('agent:completed', {
+            agentId,
+            result,
+        });
+    }
+    /**
+     * Emit error event
+     */
+    emitError(agentId, agentName, error) {
+        this.emit('agent:error', {
+            agentId,
+            agentName,
+            error,
+        });
+    }
+    /**
+     * Emit interrupted event
+     */
+    emitInterrupted(agentId, reason) {
+        this.emit('agent:interrupted', {
+            agentId,
+            reason,
+        });
+    }
+    /**
+     * Emit paused event
+     */
+    emitPaused(agentId) {
+        this.emit('agent:paused', { agentId });
+    }
+    /**
+     * Emit resumed event
+     */
+    emitResumed(agentId) {
+        this.emit('agent:resumed', { agentId });
+    }
+    /**
+     * Emit timeout event
+     */
+    emitTimeout(agentId, timeoutMs, elapsedMs) {
+        this.emit('agent:timeout', {
+            agentId,
+            timeoutMs,
+            elapsedMs,
+        });
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // State and Debugging
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Get currently active agent IDs
+     */
+    getActiveAgentIds() {
+        return Array.from(this.activeAgentIds);
+    }
+    /**
+     * Check if an agent is currently active
+     */
+    isAgentActive(agentId) {
+        return this.activeAgentIds.has(agentId);
+    }
+    /**
+     * Get count of active agents
+     */
+    getActiveAgentCount() {
+        return this.activeAgentIds.size;
+    }
+    /**
+     * Get recent event log
+     */
+    getEventLog(limit = 100) {
+        return this.eventLog.slice(-limit);
+    }
+    /**
+     * Get event log filtered by agent
+     */
+    getAgentEventLog(agentId, limit = 100) {
+        return this.eventLog
+            .filter((entry) => entry.agentId === agentId)
+            .slice(-limit);
+    }
+    /**
+     * Clear event log
+     */
+    clearEventLog() {
+        this.eventLog = [];
+    }
+    /**
+     * Log an event
+     */
+    logEvent(event, agentId) {
+        this.eventLog.push({
+            timestamp: new Date(),
+            event,
+            agentId,
+        });
+        // Trim log if it exceeds max size
+        if (this.eventLog.length > this.maxLogSize) {
+            this.eventLog = this.eventLog.slice(-Math.floor(this.maxLogSize / 2));
+        }
+    }
+    /**
+     * Subscribe to all events for a specific agent
+     */
+    subscribeToAgent(agentId, handlers) {
+        const boundHandlers = [];
+        for (const [eventName, handler] of Object.entries(handlers)) {
+            if (handler) {
+                const filteredHandler = (data) => {
+                    if (data.agentId === agentId) {
+                        handler(data);
+                    }
+                };
+                this.on(eventName, filteredHandler);
+                boundHandlers.push({ event: eventName, handler: filteredHandler });
+            }
+        }
+        // Return unsubscribe function
+        return () => {
+            for (const { event, handler } of boundHandlers) {
+                this.off(event, handler);
+            }
+        };
+    }
+    /**
+     * Wait for an agent to complete
+     */
+    waitForCompletion(agentId, timeoutMs = 300000) {
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                cleanup();
+                reject(new Error(`Timeout waiting for agent ${agentId} to complete`));
+            }, timeoutMs);
+            const onCompleted = (data) => {
+                if (data.agentId === agentId) {
+                    cleanup();
+                    resolve(data.result);
+                }
+            };
+            const onError = (data) => {
+                if (data.agentId === agentId) {
+                    cleanup();
+                    reject(data.error);
+                }
+            };
+            const onInterrupted = (data) => {
+                if (data.agentId === agentId) {
+                    cleanup();
+                    reject(new Error(`Agent interrupted: ${data.reason}`));
+                }
+            };
+            const onTimeout = (data) => {
+                if (data.agentId === agentId) {
+                    cleanup();
+                    reject(new Error(`Agent timed out after ${data.elapsedMs}ms`));
+                }
+            };
+            const cleanup = () => {
+                clearTimeout(timeout);
+                this.off('agent:completed', onCompleted);
+                this.off('agent:error', onError);
+                this.off('agent:interrupted', onInterrupted);
+                this.off('agent:timeout', onTimeout);
+            };
+            this.on('agent:completed', onCompleted);
+            this.on('agent:error', onError);
+            this.on('agent:interrupted', onInterrupted);
+            this.on('agent:timeout', onTimeout);
+        });
+    }
+    /**
+     * Create a child emitter that prefixes events
+     * Useful for nested sub-agents
+     */
+    createChildEmitter(_parentAgentId) {
+        const child = new SubAgentEventEmitter();
+        // Forward all events to parent with context
+        const events = [
+            'agent:started',
+            'agent:progress',
+            'agent:tool_call',
+            'agent:tool_result',
+            'agent:thinking',
+            'agent:text',
+            'agent:approval_required',
+            'agent:completed',
+            'agent:error',
+            'agent:interrupted',
+            'agent:paused',
+            'agent:resumed',
+            'agent:timeout',
+        ];
+        for (const event of events) {
+            child.on(event, (data) => {
+                // Emit to parent with nested agent context
+                this.emit(event, data);
+            });
+        }
+        return child;
+    }
+}
+/**
+ * Singleton instance for global event streaming
+ */
+let globalEmitter = null;
+/**
+ * Get the global sub-agent event emitter
+ */
+export function getGlobalSubAgentEmitter() {
+    if (!globalEmitter) {
+        globalEmitter = new SubAgentEventEmitter();
+    }
+    return globalEmitter;
+}
+/**
+ * Reset the global emitter (mainly for testing)
+ */
+export function resetGlobalSubAgentEmitter() {
+    if (globalEmitter) {
+        globalEmitter.removeAllListeners();
+    }
+    globalEmitter = null;
+}
+//# sourceMappingURL=SubAgentEventEmitter.js.map

package/dist/orchestrator/SubAgentEventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubAgentEventEmitter.js","sourceRoot":"","sources":["../../src/orchestrator/SubAgentEventEmitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAOtC;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IAC5C,cAAc,GAAgB,IAAI,GAAG,EAAE,CAAC;IACxC,QAAQ,GAA+D,EAAE,CAAC;IAC1E,UAAU,GAAW,IAAI,CAAC;IAElC;QACE,KAAK,EAAE,CAAC;QACR,6DAA6D;QAC7D,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,CAAiC,KAAQ,EAAE,IAAuB;QACpE,qCAAqC;QACrC,MAAM,OAAO,GAAG,SAAS,IAAI,IAAI,CAAC,CAAC,CAAE,IAA4B,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACtF,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAE9B,wBAAwB;QACxB,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;YAC9B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;aAAM,IACL,KAAK,KAAK,iBAAiB;YAC3B,KAAK,KAAK,aAAa;YACvB,KAAK,KAAK,mBAAmB;YAC7B,KAAK,KAAK,eAAe,EACzB,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,EAAE,CACA,KAAQ,EACR,QAA2C;QAE3C,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,IAAI,CACF,KAAQ,EACR,QAA2C;QAE3C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,GAAG,CACD,KAAQ,EACR,QAA2C;QAE3C,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,oEAAoE;IACpE,iDAAiD;IACjD,oEAAoE;IAEpE;;OAEG;IACH,WAAW,CACT,OAAe,EACf,SAAiB,EACjB,KAAa,EACb,IAAY,EACZ,eAAuB;QAEvB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;YACzB,OAAO;YACP,SAAS;YACT,KAAK;YACL,IAAI;YACJ,eAAe;SAChB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,YAAY,CACV,OAAe,EACf,UAAkB,EAClB,WAAmB,EACnB,SAAiB;QAEjB,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC1B,OAAO;YACP,UAAU;YACV,WAAW;YACX,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,YAAY,CACV,OAAe,EACf,QAAgB,EAChB,SAAkC,EAClC,MAAc;QAEd,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAC3B,OAAO;YACP,QAAQ;YACR,SAAS;YACT,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,OAAe,EACf,QAAgB,EAChB,MAAc,EACd,OAAgB,EAChB,OAAe,EACf,UAAkB;QAElB,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE;YAC7B,OAAO;YACP,QAAQ;YACR,MAAM;YACN,OAAO;YACP,OAAO;YACP,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAAe,EAAE,YAAoB;QAChD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC1B,OAAO;YACP,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAe,EAAE,IAAY,EAAE,UAAmB,KAAK;QAC9D,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;YACtB,OAAO;YACP,IAAI;YACJ,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,oBAAoB,CAClB,OAAe,EACf,SAAiB,EACjB,QAAgB,EAChB,SAAkC,EAClC,MAAc;QAEd,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE;YACnC,OAAO;YACP,SAAS;YACT,QAAQ;YACR,SAAS;YACT,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAe,EAAE,MAAsB;QACnD,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAC3B,OAAO;YACP,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAe,EAAE,SAAiB,EAAE,KAAY;QACxD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;YACvB,OAAO;YACP,SAAS;YACT,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAe,EAAE,MAAc;QAC7C,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE;YAC7B,OAAO;YACP,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe;QACxB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAe;QACzB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAe,EAAE,SAAiB,EAAE,SAAiB;QAC/D,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;YACzB,OAAO;YACP,SAAS;YACT,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IACpE,sBAAsB;IACtB,oEAAoE;IAEpE;;OAEG;IACH,iBAAiB;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAe;QAC3B,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAgB,GAAG;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,OAAe,EACf,QAAgB,GAAG;QAEnB,OAAO,IAAI,CAAC,QAAQ;aACjB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC;aAC5C,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,KAAa,EAAE,OAAe;QAC7C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,KAAK;YACL,OAAO;SACR,CAAC,CAAC;QAEH,kCAAkC;QAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,OAAe,EACf,QAEE;QAEF,MAAM,aAAa,GAAoE,EAAE,CAAC;QAE1F,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5D,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,eAAe,GAAG,CAAC,IAAyB,EAAE,EAAE;oBACpD,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;wBAC5B,OAAmC,CAAC,IAAI,CAAC,CAAC;oBAC7C,CAAC;gBACH,CAAC,CAAC;gBACF,IAAI,CAAC,EAAE,CAAC,SAAiC,EAAE,eAAwB,CAAC,CAAC;gBACrE,aAAa,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,eAAwB,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,aAAa,EAAE,CAAC;gBAC/C,IAAI,CAAC,GAAG,CAAC,KAA6B,EAAE,OAAgB,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAAe,EAAE,YAAoB,MAAM;QAC3D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,OAAO,cAAc,CAAC,CAAC,CAAC;YACxE,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,MAAM,WAAW,GAAG,CAAC,IAAuC,EAAE,EAAE;gBAC9D,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;oBAC7B,OAAO,EAAE,CAAC;oBACV,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,CAAC,IAAmC,EAAE,EAAE;gBACtD,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;oBAC7B,OAAO,EAAE,CAAC;oBACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,aAAa,GAAG,CAAC,IAAyC,EAAE,EAAE;gBAClE,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;oBAC7B,OAAO,EAAE,CAAC;oBACV,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,SAAS,GAAG,CAAC,IAAqC,EAAE,EAAE;gBAC1D,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;oBAC7B,OAAO,EAAE,CAAC;oBACV,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;gBACzC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;gBACjC,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;gBAC7C,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;YACvC,CAAC,CAAC;YAEF,IAAI,CAAC,EAAE,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;YACxC,IAAI,CAAC,EAAE,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAChC,IAAI,CAAC,EAAE,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;YAC5C,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,cAAsB;QACvC,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAEzC,4CAA4C;QAC5C,MAAM,MAAM,GAA6B;YACvC,eAAe;YACf,gBAAgB;YAChB,iBAAiB;YACjB,mBAAmB;YACnB,gBAAgB;YAChB,YAAY;YACZ,yBAAyB;YACzB,iBAAiB;YACjB,aAAa;YACb,mBAAmB;YACnB,cAAc;YACd,eAAe;YACf,eAAe;SAChB,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,IAAkC,EAAE,EAAE;gBACrD,2CAA2C;gBAC3C,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED;;GAEG;AACH,IAAI,aAAa,GAAgC,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,aAAa,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,IAAI,aAAa,EAAE,CAAC;QAClB,aAAa,CAAC,kBAAkB,EAAE,CAAC;IACrC,CAAC;IACD,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/dist/orchestrator/SubAgentIPC.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Sub-Agent IPC Protocol
+ *
+ * Defines the message protocol for communication between parent
+ * orchestrator and child sub-agent processes.
+ *
+ * Child processes are spawned via child_process.fork() and communicate
+ * via Node.js IPC (process.send / process.on('message')).
+ *
+ * @module orchestrator/SubAgentIPC
+ * @version 1.0.0
+ */
+import type { AgentDefinition, SubAgentResult } from './SubAgentTypes.js';
+import type { ChildProcess } from 'child_process';
+/**
+ * Message sent to child to start agent execution
+ */
+export interface IPCStartMessage {
+    type: 'start';
+    payload: {
+        agentId: string;
+        agentDefinition: AgentDefinition;
+        taskPrompt: string;
+        modelId: string;
+        projectPath: string;
+        timeoutMs: number;
+        maxTurns: number;
+        debug?: boolean;
+    };
+}
+/**
+ * Message sent to child to abort execution
+ */
+export interface IPCAbortMessage {
+    type: 'abort';
+    payload: {
+        reason: string;
+    };
+}
+/**
+ * Message sent to child to pause execution
+ */
+export interface IPCPauseMessage {
+    type: 'pause';
+}
+/**
+ * Message sent to child to resume execution
+ */
+export interface IPCResumeMessage {
+    type: 'resume';
+}
+/**
+ * Message sent to child with guidance
+ */
+export interface IPCGuidanceMessage {
+    type: 'guidance';
+    payload: {
+        message: string;
+    };
+}
+/**
+ * Message sent to child with permission decision from user
+ */
+export interface IPCPermissionResponseMessage {
+    type: 'permission_response';
+    payload: {
+        requestId: string;
+        approved: boolean;
+        reason?: string;
+    };
+}
+/**
+ * All messages parent can send to child
+ */
+export type ParentToChildMessage = IPCStartMessage | IPCAbortMessage | IPCPauseMessage | IPCResumeMessage | IPCGuidanceMessage | IPCPermissionResponseMessage;
+/**
+ * Child acknowledges it's ready to receive start message
+ */
+export interface IPCReadyMessage {
+    type: 'ready';
+    payload: {
+        pid: number;
+    };
+}
+/**
+ * Child reports it has started execution
+ */
+export interface IPCStartedMessage {
+    type: 'started';
+    payload: {
+        agentId: string;
+        agentName: string;
+        model: string;
+    };
+}
+/**
+ * Child reports progress
+ */
+export interface IPCProgressMessage {
+    type: 'progress';
+    payload: {
+        agentId: string;
+        turnNumber: number;
+        totalTokens: number;
+        elapsedMs: number;
+    };
+}
+/**
+ * Child reports a tool call
+ */
+export interface IPCToolCallMessage {
+    type: 'tool_call';
+    payload: {
+        agentId: string;
+        toolName: string;
+        toolId: string;
+        toolInput: Record<string, unknown>;
+    };
+}
+/**
+ * Child reports tool result
+ */
+export interface IPCToolResultMessage {
+    type: 'tool_result';
+    payload: {
+        agentId: string;
+        toolName: string;
+        toolId: string;
+        success: boolean;
+        summary: string;
+        durationMs: number;
+    };
+}
+/**
+ * Child reports thinking/reasoning
+ */
+export interface IPCThinkingMessage {
+    type: 'thinking';
+    payload: {
+        agentId: string;
+        text: string;
+    };
+}
+/**
+ * Child reports text output
+ */
+export interface IPCTextMessage {
+    type: 'text';
+    payload: {
+        agentId: string;
+        text: string;
+        isFinal: boolean;
+    };
+}
+/**
+ * Child reports an error (non-fatal)
+ */
+export interface IPCErrorMessage {
+    type: 'error';
+    payload: {
+        agentId: string;
+        message: string;
+        type: string;
+        stack?: string;
+    };
+}
+/**
+ * Child reports completion with full result
+ */
+export interface IPCCompletedMessage {
+    type: 'completed';
+    payload: {
+        agentId: string;
+        result: SubAgentResult;
+    };
+}
+/**
+ * Child reports it was interrupted
+ */
+export interface IPCInterruptedMessage {
+    type: 'interrupted';
+    payload: {
+        agentId: string;
+        reason: string;
+    };
+}
+/**
+ * Child reports timeout
+ */
+export interface IPCTimeoutMessage {
+    type: 'timeout';
+    payload: {
+        agentId: string;
+        timeoutMs: number;
+        elapsedMs: number;
+    };
+}
+/**
+ * Child reports a log message (for debugging)
+ */
+export interface IPCLogMessage {
+    type: 'log';
+    payload: {
+        level: 'debug' | 'info' | 'warn' | 'error';
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * Child requests permission approval from parent
+ * Parent should display approval UI and send IPCPermissionResponseMessage back
+ */
+export interface IPCPermissionRequestMessage {
+    type: 'permission_request';
+    payload: {
+        agentId: string;
+        requestId: string;
+        toolName: string;
+        toolInput: Record<string, unknown>;
+        reason: string;
+        timestamp: string;
+    };
+}
+/**
+ * All messages child can send to parent
+ */
+export type ChildToParentMessage = IPCReadyMessage | IPCStartedMessage | IPCProgressMessage | IPCToolCallMessage | IPCToolResultMessage | IPCThinkingMessage | IPCTextMessage | IPCErrorMessage | IPCCompletedMessage | IPCInterruptedMessage | IPCTimeoutMessage | IPCLogMessage | IPCPermissionRequestMessage;
+export declare function isParentToChildMessage(msg: unknown): msg is ParentToChildMessage;
+export declare function isChildToParentMessage(msg: unknown): msg is ChildToParentMessage;
+/**
+ * Send message from parent to child
+ */
+export declare function sendToChild(childProcess: ChildProcess, message: ParentToChildMessage): boolean;
+/**
+ * Send message from child to parent (call from child process)
+ */
+export declare function sendToParent(message: ChildToParentMessage): boolean;
+/**
+ * Create a minimal SubAgentResult for error cases
+ */
+export declare function createErrorResult(agentId: string, agentName: string, model: string, error: Error, startTime: Date): SubAgentResult;
+//# sourceMappingURL=SubAgentIPC.d.ts.map

package/dist/orchestrator/SubAgentIPC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubAgentIPC.d.ts","sourceRoot":"","sources":["../../src/orchestrator/SubAgentIPC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,eAAe,CAAC;AAMhE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,eAAe,CAAC;QACjC,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAClB,4BAA4B,CAAC;AAMjC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,cAAc,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC3C,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,cAAc,GACd,eAAe,GACf,mBAAmB,GACnB,qBAAqB,GACrB,iBAAiB,GACjB,aAAa,GACb,2BAA2B,CAAC;AAMhC,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,oBAAoB,CAIhF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,oBAAoB,CAQhF;AAMD;;GAEG;AACH,wBAAgB,WAAW,CACzB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAKnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,IAAI,GACd,cAAc,CA4BhB"}