@nexus-cortex/core 4.26.0

package/dist/orchestrator/SubAgentManager.js

@@ -0,0 +1,477 @@
+/**
+ * Sub-Agent Manager
+ *
+ * Central manager for spawning, tracking, and controlling sub-agents.
+ * Implements the ISubAgentManager interface and provides:
+ * - Agent spawning with model resolution
+ * - Concurrent agent tracking
+ * - Pause/resume/interrupt controls
+ * - Guidance message injection
+ * - Event streaming coordination
+ *
+ * @module orchestrator/SubAgentManager
+ * @version 1.0.0
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { getGlobalSubAgentEmitter } from './SubAgentEventEmitter.js';
+import { SubAgentOrchestrator } from './SubAgentOrchestrator.js';
+import { createPauseControllerWithAbort } from './PauseController.js';
+import { getDefaultResolver } from '../models/registry/ModelAliasResolver.js';
+import { ModelRouterMatrix } from '../training/ModelRouterMatrix.js';
+import { classifyTask } from '../training/TaskClassifier.js';
+/**
+ * Last-resort sub-agent model when an agent is `inherit`/unset AND no driver
+ * default is configured. DeepSeek is the standing default: most capable per
+ * dollar, and it honors the no-xAI cost constraint (a grok/sonnet fallback here
+ * would silently bill expensive providers for routine sub-agent work).
+ */
+const DEFAULT_SUBAGENT_MODEL = 'deepseek-v4-flash';
+/**
+ * Sub-Agent Manager
+ *
+ * Main entry point for spawning and managing sub-agents.
+ *
+ * @example
+ * ```typescript
+ * const manager = new SubAgentManager({
+ *   baseOrchestratorConfig: { projectPath: '/workspace' },
+ *   parentSessionId: 'session-123',
+ *   parentTurnNumber: 5,
+ * });
+ *
+ * const result = await manager.spawnAgent(agentDef, 'Review the auth module');
+ * console.log(result.summary);
+ * ```
+ */
+export class SubAgentManager {
+    config;
+    eventEmitter;
+    modelResolver;
+    activeAgents = new Map();
+    completedAgents = new Map();
+    guidanceMessages = new Map();
+    constructor(config) {
+        this.config = {
+            maxConcurrentAgents: 5,
+            debug: false,
+            ...config,
+        };
+        this.eventEmitter = config.eventEmitter ?? getGlobalSubAgentEmitter();
+        this.modelResolver = config.modelResolver ?? getDefaultResolver();
+    }
+    /**
+     * Spawn a new sub-agent to execute a task
+     *
+     * @param agentDefinition Agent definition from TaskToolExecutor
+     * @param taskPrompt The task for the agent to perform
+     * @param options Optional spawn options
+     * @returns Promise resolving to the agent's result
+     */
+    async spawnAgent(agentDefinition, taskPrompt, options = {}) {
+        // Check concurrent limit
+        if (this.activeAgents.size >= (this.config.maxConcurrentAgents ?? 5)) {
+            throw new Error(`Maximum concurrent agents (${this.config.maxConcurrentAgents}) reached. ` +
+                'Wait for an agent to complete or interrupt one.');
+        }
+        // Generate unique agent ID
+        const agentId = this.generateAgentId(agentDefinition.name);
+        // Resolve model. An explicit 'auto' delegates to the trust-gated router
+        // (overrides the global MODEL_ROUTER_ENABLED flag); resolveAutoModel always
+        // returns a concrete model (routed when trustworthy, else parent's model).
+        let modelId = this.resolveModel(agentDefinition, options.modelOverride);
+        if (modelId === 'auto') {
+            modelId = this.resolveAutoModel(taskPrompt);
+        }
+        // Create controllers
+        const abortController = new AbortController();
+        const pauseController = createPauseControllerWithAbort(abortController.signal);
+        // Build context
+        const context = {
+            parentSessionId: this.config.parentSessionId,
+            parentTurnNumber: this.config.parentTurnNumber,
+            eventEmitter: this.eventEmitter,
+            abortController,
+            pauseController,
+            approvalMode: 'inherit', // Inherit from parent
+        };
+        // Build sub-agent config
+        const subAgentConfig = {
+            agentId,
+            agentDefinition,
+            taskPrompt: this.buildEnhancedPrompt(taskPrompt, options.additionalContext),
+            modelId,
+            timeoutMs: options.timeoutMs ?? 300000,
+            maxTurns: options.maxTurns ?? 50,
+        };
+        // Create orchestrator
+        const orchestrator = new SubAgentOrchestrator({
+            config: subAgentConfig,
+            context,
+            parentPolicies: this.config.parentPolicies,
+            baseConfig: this.config.baseOrchestratorConfig,
+            debug: this.config.debug,
+        });
+        // Start execution
+        const promise = this.executeAgent(orchestrator, agentId);
+        // Track active agent
+        const state = {
+            agentId,
+            agentName: agentDefinition.name,
+            orchestrator,
+            pauseController,
+            abortController,
+            startTime: new Date(),
+            promise,
+        };
+        this.activeAgents.set(agentId, state);
+        this.guidanceMessages.set(agentId, []);
+        if (this.config.debug) {
+            console.log(`[SubAgentManager] Spawned agent "${agentDefinition.name}" (${agentId}) with model ${modelId}`);
+        }
+        // Wait for completion
+        const result = await promise;
+        // Move to completed
+        this.activeAgents.delete(agentId);
+        this.completedAgents.set(agentId, result);
+        this.guidanceMessages.delete(agentId);
+        return result;
+    }
+    /**
+     * Execute an agent and handle cleanup
+     */
+    async executeAgent(orchestrator, agentId) {
+        try {
+            return await orchestrator.execute();
+        }
+        catch (error) {
+            // Ensure agent is cleaned up on error
+            this.activeAgents.delete(agentId);
+            throw error;
+        }
+    }
+    /**
+     * Resolve model ID from agent definition or override
+     */
+    resolveModel(agentDefinition, override) {
+        // Use override if provided
+        if (override) {
+            const resolved = this.modelResolver.resolveToId(override);
+            return resolved ?? override;
+        }
+        // Use agent's model preference
+        const agentModel = agentDefinition.model;
+        // Handle 'inherit'
+        if (agentModel === 'inherit' || !agentModel) {
+            return this.config.defaultModelId ?? DEFAULT_SUBAGENT_MODEL;
+        }
+        // Resolve alias
+        const resolved = this.modelResolver.resolveToId(agentModel);
+        return resolved ?? agentModel;
+    }
+    routerMatrix;
+    getRouterMatrix() {
+        if (!this.routerMatrix) {
+            const root = this.config.baseOrchestratorConfig?.projectPath ||
+                process.env.PROJECT_ROOT ||
+                process.cwd();
+            this.routerMatrix = new ModelRouterMatrix(root);
+        }
+        return this.routerMatrix;
+    }
+    /**
+     * Resolve an explicit `model: 'auto'` sub-agent dispatch via the model router.
+     *
+     * This is the per-dispatch OPT-IN: passing 'auto' lets the orchestrator
+     * delegate model choice to the router, and it overrides the global
+     * MODEL_ROUTER_ENABLED flag (the orchestrator chose to route by passing
+     * 'auto'). But it only ACTUALLY routes when the decision is trustworthy —
+     * the task classifies with enough confidence AND the matrix has >= minSamples
+     * real benchmark observations for that task type. Otherwise it inherits the
+     * parent's model. The whole point of the router is to raise routing-decision
+     * quality over time; until a task type has earned trust, 'auto' is a safe
+     * no-op (parent model), and the recorded outcomes push it toward trust.
+     *
+     * Never returns 'auto', so the sub-agent always gets a concrete, resolvable
+     * model — the auto path can never crash on getModel('auto').
+     */
+    resolveAutoModel(taskPrompt) {
+        const parentModel = this.config.defaultModelId ?? DEFAULT_SUBAGENT_MODEL;
+        const minConfidence = Number(process.env.ROUTER_MIN_CONFIDENCE ?? '0.3');
+        const minSamples = Number(process.env.ROUTER_MIN_SAMPLES ?? '3');
+        try {
+            const { taskType, confidence } = classifyTask(taskPrompt);
+            if (confidence < minConfidence)
+                return parentModel;
+            // OPT-IN explore/exploit: when MODEL_ROUTER_EXPLORATION is on, Thompson
+            // sampling deliberately gives thinly-sampled models a chance (the trust
+            // gate's opposite philosophy — it explores to gather data). Default off →
+            // the conservative trust-gated greedy pick. Either path falls back to the
+            // parent model when there's no eligible recommendation, so 'auto' never
+            // routes to a banned (MODEL_ROUTER_EXCLUDE) or unresolvable model.
+            // MODEL_ROUTER_EXCLUDE is a comma-separated ban list — each entry is an exact
+            // model ID or a 'prefix*' wildcard, so multiple models/providers can be excluded
+            // at once (e.g. "grok*,gpt-4o"). Applied to BOTH routing paths.
+            const exclude = (process.env.MODEL_ROUTER_EXCLUDE ?? '')
+                .split(',').map(s => s.trim()).filter(Boolean);
+            const explore = process.env.MODEL_ROUTER_EXPLORATION === 'true';
+            const recommended = explore
+                ? this.getRouterMatrix().recommendThompson(taskType, { exclude })
+                : this.getRouterMatrix().recommendTrusted(taskType, minSamples, exclude);
+            if (!recommended)
+                return parentModel;
+            return this.modelResolver.resolveToId(recommended) ?? recommended;
+        }
+        catch {
+            return parentModel; // classifier/matrix error → safe inherit, never crash
+        }
+    }
+    /**
+     * Build enhanced prompt with additional context
+     */
+    buildEnhancedPrompt(taskPrompt, additionalContext) {
+        if (!additionalContext) {
+            return taskPrompt;
+        }
+        return `${taskPrompt}\n\n## Additional Context\n\n${additionalContext}`;
+    }
+    /**
+     * Generate a unique agent ID
+     */
+    generateAgentId(agentName) {
+        const shortId = uuidv4().split('-')[0];
+        return `${agentName}-${shortId}`;
+    }
+    /**
+     * Pause a running agent
+     *
+     * @param agentId Agent ID to pause
+     * @returns true if agent was found and paused
+     */
+    pauseAgent(agentId) {
+        const state = this.activeAgents.get(agentId);
+        if (!state) {
+            return false;
+        }
+        if (state.pauseController.isPaused()) {
+            return true; // Already paused
+        }
+        state.pauseController.pause();
+        this.eventEmitter.emit('agent:paused', { agentId });
+        if (this.config.debug) {
+            console.log(`[SubAgentManager] Paused agent ${agentId}`);
+        }
+        return true;
+    }
+    /**
+     * Resume a paused agent
+     *
+     * @param agentId Agent ID to resume
+     * @returns true if agent was found and resumed
+     */
+    resumeAgent(agentId) {
+        const state = this.activeAgents.get(agentId);
+        if (!state) {
+            return false;
+        }
+        if (!state.pauseController.isPaused()) {
+            return true; // Already running
+        }
+        state.pauseController.resume();
+        this.eventEmitter.emit('agent:resumed', { agentId });
+        if (this.config.debug) {
+            console.log(`[SubAgentManager] Resumed agent ${agentId}`);
+        }
+        return true;
+    }
+    /**
+     * Interrupt (abort) a running agent
+     *
+     * @param agentId Agent ID to interrupt
+     * @param reason Reason for interruption
+     * @returns true if agent was found and interrupted
+     */
+    interruptAgent(agentId, reason) {
+        const state = this.activeAgents.get(agentId);
+        if (!state) {
+            return false;
+        }
+        state.abortController.abort();
+        this.eventEmitter.emit('agent:interrupted', {
+            agentId,
+            reason,
+        });
+        if (this.config.debug) {
+            console.log(`[SubAgentManager] Interrupted agent ${agentId}: ${reason}`);
+        }
+        return true;
+    }
+    /**
+     * Send guidance message to a running agent
+     *
+     * The guidance will be injected into the agent's next turn.
+     *
+     * @param agentId Agent ID to guide
+     * @param message Guidance message
+     * @returns true if agent was found
+     */
+    async guideAgent(agentId, message) {
+        const state = this.activeAgents.get(agentId);
+        if (!state) {
+            return false;
+        }
+        // Store guidance for injection
+        const messages = this.guidanceMessages.get(agentId) ?? [];
+        messages.push(message);
+        this.guidanceMessages.set(agentId, messages);
+        if (this.config.debug) {
+            console.log(`[SubAgentManager] Added guidance for agent ${agentId}: ${message}`);
+        }
+        return true;
+    }
+    /**
+     * Get pending guidance messages for an agent
+     */
+    getGuidanceMessages(agentId) {
+        return this.guidanceMessages.get(agentId) ?? [];
+    }
+    /**
+     * Clear guidance messages after they've been processed
+     */
+    clearGuidanceMessages(agentId) {
+        this.guidanceMessages.set(agentId, []);
+    }
+    /**
+     * Get the event emitter for subscribing to agent events
+     */
+    getEventEmitter() {
+        return this.eventEmitter;
+    }
+    /**
+     * Get list of active agent IDs
+     */
+    getActiveAgentIds() {
+        return Array.from(this.activeAgents.keys());
+    }
+    /**
+     * Check if an agent is currently active
+     */
+    isAgentActive(agentId) {
+        return this.activeAgents.has(agentId);
+    }
+    /**
+     * Get status of an active agent
+     */
+    getAgentStatus(agentId) {
+        const state = this.activeAgents.get(agentId);
+        if (!state) {
+            return null;
+        }
+        return {
+            isActive: true,
+            isPaused: state.pauseController.isPaused(),
+            elapsedMs: Date.now() - state.startTime.getTime(),
+            agentName: state.agentName,
+        };
+    }
+    /**
+     * Get result of a completed agent
+     */
+    getCompletedResult(agentId) {
+        return this.completedAgents.get(agentId) ?? null;
+    }
+    /**
+     * Wait for all active agents to complete
+     */
+    async waitForAll() {
+        const promises = Array.from(this.activeAgents.values()).map((s) => s.promise);
+        return Promise.all(promises);
+    }
+    /**
+     * Interrupt all active agents
+     */
+    interruptAll(reason) {
+        let count = 0;
+        for (const agentId of this.activeAgents.keys()) {
+            if (this.interruptAgent(agentId, reason)) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Pause all active agents
+     */
+    pauseAll() {
+        let count = 0;
+        for (const agentId of this.activeAgents.keys()) {
+            if (this.pauseAgent(agentId)) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Resume all paused agents
+     */
+    resumeAll() {
+        let count = 0;
+        for (const agentId of this.activeAgents.keys()) {
+            if (this.resumeAgent(agentId)) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Get summary of all agents
+     */
+    getSummary() {
+        const agents = [];
+        // Add active agents
+        for (const [id, state] of this.activeAgents) {
+            agents.push({
+                id,
+                name: state.agentName,
+                status: state.pauseController.isPaused() ? 'paused' : 'active',
+                elapsedMs: Date.now() - state.startTime.getTime(),
+            });
+        }
+        // Add completed agents
+        for (const [id, result] of this.completedAgents) {
+            agents.push({
+                id,
+                name: result.agentName,
+                status: 'completed',
+                elapsedMs: result.durationMs,
+            });
+        }
+        return {
+            active: this.activeAgents.size,
+            completed: this.completedAgents.size,
+            agents,
+        };
+    }
+    /**
+     * Clear completed agents from memory
+     */
+    clearCompleted() {
+        const count = this.completedAgents.size;
+        this.completedAgents.clear();
+        return count;
+    }
+}
+/**
+ * Create a sub-agent manager with sensible defaults
+ */
+export function createSubAgentManager(parentSessionId, parentTurnNumber, projectPath, options) {
+    return new SubAgentManager({
+        parentSessionId,
+        parentTurnNumber,
+        baseOrchestratorConfig: {
+            projectPath,
+            ...options?.baseOrchestratorConfig,
+        },
+        ...options,
+    });
+}
+//# sourceMappingURL=SubAgentManager.js.map

package/dist/orchestrator/SubAgentManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubAgentManager.js","sourceRoot":"","sources":["../../src/orchestrator/SubAgentManager.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/SubAgentOrchestrator.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Sub-Agent Orchestrator
+ *
+ * A lightweight orchestrator for sub-agent execution.
+ * Creates a minimal conversation context for the sub-agent task,
+ * tracks tool usage and file operations, and produces a
+ * comprehensive result for the parent orchestrator.
+ *
+ * Design: Uses CortexOrchestrator's built-in agentic loop
+ * which automatically handles tool execution. The sub-agent
+ * orchestrator wraps this to add:
+ * - Event emission for real-time monitoring
+ * - Abort/pause signal handling
+ * - Result aggregation and formatting
+ *
+ * @module orchestrator/SubAgentOrchestrator
+ * @version 1.0.0
+ */
+import type { OrchestratorConfig } from './CortexOrchestrator.js';
+import type { SubAgentConfig, SubAgentContext, SubAgentResult } from './SubAgentTypes.js';
+import { SubAgentPermissionChecker } from './SubAgentPermissionChecker.js';
+import type { PermissionPolicy } from '../middleware/contracts/MiddlewareContracts.js';
+/**
+ * Options for sub-agent orchestrator creation
+ */
+export interface SubAgentOrchestratorOptions {
+    /** Sub-agent configuration */
+    config: SubAgentConfig;
+    /** Context from parent orchestrator */
+    context: SubAgentContext;
+    /** Parent's permission policies */
+    parentPolicies?: PermissionPolicy[];
+    /** Base orchestrator configuration */
+    baseConfig: Partial<OrchestratorConfig>;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Sub-Agent Orchestrator
+ *
+ * Manages the lifecycle of a sub-agent execution:
+ * 1. Creates isolated orchestrator with agent's system prompt
+ * 2. Runs the task through orchestrator's agentic loop
+ * 3. Tracks tool usage and file operations from responses
+ * 4. Handles abort/pause signals via polling
+ * 5. Produces comprehensive result for parent
+ */
+export declare class SubAgentOrchestrator {
+    private options;
+    private orchestrator?;
+    private permissionChecker;
+    private eventEmitter;
+    private pauseController;
+    private abortController;
+    private startTime?;
+    private endTime?;
+    private turnCount;
+    private toolUsage;
+    private filesRead;
+    private filesModified;
+    private inputTokens;
+    private outputTokens;
+    private cacheHits;
+    private fullResponseParts;
+    private isRunning;
+    private status;
+    private error?;
+    constructor(options: SubAgentOrchestratorOptions);
+    /**
+     * Execute the sub-agent task
+     *
+     * @returns SubAgentResult with execution details
+     */
+    execute(): Promise<SubAgentResult>;
+    /**
+     * Run the agentic execution with abort/pause checking
+     */
+    private runAgenticExecution;
+    /**
+     * Execute the task using orchestrator's built-in agentic loop
+     */
+    private executeWithOrchestrator;
+    /**
+     * Extract text content from response content
+     */
+    private extractTextContent;
+    /**
+     * Track tool usage from response tool use blocks
+     */
+    private trackToolFromResponse;
+    /**
+     * Track file operations from tool inputs
+     */
+    private trackFileOperation;
+    /**
+     * Build the final result
+     */
+    private buildResult;
+    /**
+     * Build a summary for the parent LLM
+     */
+    private buildSummary;
+    /**
+     * Estimate cost based on model pricing
+     */
+    private estimateCost;
+    /**
+     * Truncate text for display
+     */
+    private truncateForDisplay;
+    /**
+     * Get current execution status
+     */
+    getStatus(): {
+        isRunning: boolean;
+        turnCount: number;
+        status: SubAgentResult['status'];
+        elapsedMs: number;
+    };
+    /**
+     * Get permission summary
+     */
+    getPermissionSummary(): ReturnType<SubAgentPermissionChecker['getSummary']>;
+}
+//# sourceMappingURL=SubAgentOrchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SubAgentOrchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/SubAgentOrchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEtF,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,cAAc,EAKf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,8BAA8B;IAC9B,MAAM,EAAE,cAAc,CAAC;IAEvB,uCAAuC;IACvC,OAAO,EAAE,eAAe,CAAC;IAEzB,mCAAmC;IACnC,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEpC,sCAAsC;IACtC,UAAU,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAExC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,YAAY,CAAC,CAAqB;IAC1C,OAAO,CAAC,iBAAiB,CAA4B;IACrD,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,eAAe,CAAkB;IAGzC,OAAO,CAAC,SAAS,CAAC,CAAO;IACzB,OAAO,CAAC,OAAO,CAAC,CAAO;IACvB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,KAAK,CAAC,CAAQ;gBAEV,OAAO,EAAE,2BAA2B;IAmBhD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;IA0DxC;;OAEG;YACW,mBAAmB;IAyDjC;;OAEG;YACW,uBAAuB;IA+CrC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAuDnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiCpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,SAAS,IAAI;QACX,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QACjC,SAAS,EAAE,MAAM,CAAC;KACnB;IAaD;;OAEG;IACH,oBAAoB,IAAI,UAAU,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC;CAG5E"}