@defai.digital/ax-cli 2.7.0 → 3.0.0

package/dist/agent/subagent-orchestrator.js

@@ -0,0 +1,388 @@
+/**
+ * Subagent Orchestrator
+ *
+ * Manages the lifecycle of subagents and coordinates parallel task execution.
+ * Handles spawning, delegation, dependency resolution, and result aggregation.
+ */
+import { EventEmitter } from 'events';
+import { Subagent } from './subagent.js';
+import { SubagentRole, SubagentState } from './subagent-types.js';
+import { DependencyResolver } from './dependency-resolver.js';
+// Import specialized agents
+import { TestingAgent } from './specialized/testing-agent.js';
+import { DocumentationAgent } from './specialized/documentation-agent.js';
+import { RefactoringAgent } from './specialized/refactoring-agent.js';
+import { AnalysisAgent } from './specialized/analysis-agent.js';
+import { DebugAgent } from './specialized/debug-agent.js';
+import { PerformanceAgent } from './specialized/performance-agent.js';
+/**
+ * SubagentOrchestrator manages multiple subagents
+ */
+export class SubagentOrchestrator extends EventEmitter {
+    subagents;
+    taskQueue;
+    results;
+    dependencyResolver;
+    activeCount;
+    config;
+    // Track event listeners for cleanup to prevent memory leaks
+    subagentListeners;
+    constructor(config) {
+        super();
+        this.config = {
+            maxConcurrentAgents: 5,
+            defaultTimeout: 300000,
+            autoCheckpoint: false,
+            verbose: false,
+            ...config,
+        };
+        this.subagents = new Map();
+        this.taskQueue = [];
+        this.results = new Map();
+        this.dependencyResolver = new DependencyResolver();
+        this.activeCount = 0;
+        this.subagentListeners = new Map();
+    }
+    /**
+     * Spawn a new subagent with the specified role
+     */
+    async spawn(role, config) {
+        // Check max concurrent agents limit
+        if (this.subagents.size >= this.config.maxConcurrentAgents) {
+            throw new Error(`Maximum concurrent agents limit (${this.config.maxConcurrentAgents}) reached`);
+        }
+        let subagent;
+        // Create specialized subagent based on role
+        switch (role) {
+            case SubagentRole.TESTING:
+                subagent = new TestingAgent(config);
+                break;
+            case SubagentRole.DOCUMENTATION:
+                subagent = new DocumentationAgent(config);
+                break;
+            case SubagentRole.REFACTORING:
+                subagent = new RefactoringAgent(config);
+                break;
+            case SubagentRole.ANALYSIS:
+                subagent = new AnalysisAgent(config);
+                break;
+            case SubagentRole.DEBUG:
+                subagent = new DebugAgent(config);
+                break;
+            case SubagentRole.PERFORMANCE:
+                subagent = new PerformanceAgent(config);
+                break;
+            case SubagentRole.GENERAL:
+            default:
+                subagent = new Subagent(SubagentRole.GENERAL, config);
+                break;
+        }
+        // Register subagent using its own ID
+        this.subagents.set(subagent.id, subagent);
+        // Forward subagent events
+        this.forwardSubagentEvents(subagent.id, subagent);
+        this.emit('spawn', { id: subagent.id, role });
+        return subagent;
+    }
+    /**
+     * Alias for spawn() for backward compatibility
+     */
+    async spawnSubagent(role, config) {
+        return this.spawn(role, config);
+    }
+    /**
+     * Forward events from subagent to orchestrator
+     * Stores listeners for proper cleanup to prevent memory leaks
+     */
+    forwardSubagentEvents(id, subagent) {
+        // Create named handlers so we can remove them later
+        const handlers = new Map();
+        const taskStartedHandler = (data) => {
+            this.activeCount++;
+            this.emit('subagent-start', { subagentId: id, ...data });
+        };
+        handlers.set('task-started', taskStartedHandler);
+        subagent.on('task-started', taskStartedHandler);
+        const taskCompletedHandler = (data) => {
+            this.activeCount--;
+            this.results.set(data.taskId, data.result);
+            this.emit('subagent-complete', { subagentId: id, ...data });
+        };
+        handlers.set('task-completed', taskCompletedHandler);
+        subagent.on('task-completed', taskCompletedHandler);
+        const taskFailedHandler = (data) => {
+            this.activeCount--;
+            this.emit('subagent-error', { subagentId: id, ...data });
+        };
+        handlers.set('task-failed', taskFailedHandler);
+        subagent.on('task-failed', taskFailedHandler);
+        const progressHandler = (data) => {
+            this.emit('subagent-progress', { subagentId: id, ...data });
+        };
+        handlers.set('progress', progressHandler);
+        subagent.on('progress', progressHandler);
+        const toolExecutedHandler = (data) => {
+            this.emit('subagent-tool', { subagentId: id, ...data });
+        };
+        handlers.set('tool-executed', toolExecutedHandler);
+        subagent.on('tool-executed', toolExecutedHandler);
+        // Store handlers for cleanup
+        this.subagentListeners.set(id, handlers);
+    }
+    /**
+     * Delegate a task to a subagent with the specified role
+     */
+    async delegateTask(task, role) {
+        // Determine role from task if not specified
+        const taskRole = role || this.inferRoleFromTask(task);
+        // Spawn subagent
+        const subagent = await this.spawnSubagent(taskRole);
+        try {
+            // Execute task
+            const result = await subagent.executeTask(task);
+            // Store result
+            this.results.set(task.id, result);
+            return result;
+        }
+        finally {
+            // Clean up subagent after task completion
+            await this.terminateSubagent(subagent.id);
+        }
+    }
+    /**
+     * Execute multiple tasks in parallel
+     */
+    async executeParallel(tasks) {
+        // Validate dependencies
+        if (!this.dependencyResolver.validateDependencies(tasks)) {
+            throw new Error('Circular dependencies detected in tasks');
+        }
+        // Resolve dependencies and get execution batches
+        const batches = this.dependencyResolver.resolveDependencies(tasks);
+        const allResults = [];
+        // Execute batches sequentially, but tasks within each batch in parallel
+        for (const batch of batches) {
+            const batchTasks = batch
+                .map(taskId => tasks.find(t => t.id === taskId))
+                .filter((task) => task !== undefined);
+            // Skip empty batches (shouldn't happen with valid dependency resolution)
+            if (batchTasks.length === 0)
+                continue;
+            // Execute batch in parallel
+            const batchResults = await this.executeBatch(batchTasks);
+            allResults.push(...batchResults);
+        }
+        return allResults;
+    }
+    /**
+     * Execute a batch of tasks in parallel
+     */
+    async executeBatch(tasks) {
+        const promises = tasks.map(async (task) => {
+            // Infer role from task
+            const role = this.inferRoleFromTask(task);
+            // Spawn and execute
+            const subagent = await this.spawnSubagent(role);
+            try {
+                const result = await subagent.executeTask(task);
+                this.results.set(task.id, result);
+                return result;
+            }
+            finally {
+                await this.terminateSubagent(subagent.id);
+            }
+        });
+        // Execute all in parallel with fail-safe
+        const results = await Promise.allSettled(promises);
+        return results.map((r, i) => {
+            if (r.status === 'fulfilled') {
+                return r.value;
+            }
+            else {
+                // Task failed - create a proper SubagentResult
+                const task = tasks[i];
+                const failedResult = {
+                    id: `failed-${task.id}`,
+                    taskId: task.id,
+                    role: task.role,
+                    success: false,
+                    output: '',
+                    error: r.reason?.message || 'Unknown error',
+                    executionTime: 0,
+                    status: {
+                        id: `status-${task.id}`,
+                        taskId: task.id,
+                        role: task.role,
+                        state: SubagentState.FAILED,
+                        progress: 0,
+                        startTime: new Date(),
+                        endTime: new Date(),
+                        error: r.reason?.message || 'Unknown error',
+                    },
+                };
+                return failedResult;
+            }
+        });
+    }
+    /**
+     * Infer subagent role from task description
+     */
+    inferRoleFromTask(task) {
+        const desc = task.description.toLowerCase();
+        if (desc.includes('test') || desc.includes('testing')) {
+            return SubagentRole.TESTING;
+        }
+        if (desc.includes('document') || desc.includes('readme') || desc.includes('docs')) {
+            return SubagentRole.DOCUMENTATION;
+        }
+        if (desc.includes('refactor') || desc.includes('restructure')) {
+            return SubagentRole.REFACTORING;
+        }
+        if (desc.includes('analyze') || desc.includes('review') || desc.includes('audit')) {
+            return SubagentRole.ANALYSIS;
+        }
+        if (desc.includes('debug') || desc.includes('fix') || desc.includes('bug')) {
+            return SubagentRole.DEBUG;
+        }
+        if (desc.includes('performance') || desc.includes('optimize') || desc.includes('speed')) {
+            return SubagentRole.PERFORMANCE;
+        }
+        return SubagentRole.GENERAL;
+    }
+    /**
+     * Terminate a specific subagent by ID
+     * Properly removes event listeners to prevent memory leaks
+     */
+    async terminateSubagent(subagentId) {
+        const subagent = this.subagents.get(subagentId);
+        if (!subagent) {
+            return; // Gracefully handle non-existent subagent
+        }
+        // Remove event listeners to prevent memory leaks
+        const handlers = this.subagentListeners.get(subagentId);
+        if (handlers) {
+            for (const [event, handler] of handlers) {
+                subagent.off(event, handler);
+            }
+            this.subagentListeners.delete(subagentId);
+        }
+        await subagent.terminate();
+        this.subagents.delete(subagentId);
+        this.emit('terminate', { id: subagentId });
+    }
+    /**
+     * Terminate all subagents
+     * Properly removes all event listeners to prevent memory leaks
+     */
+    async terminateAll() {
+        // Remove all event listeners before terminating
+        for (const [subagentId, subagent] of this.subagents) {
+            const handlers = this.subagentListeners.get(subagentId);
+            if (handlers) {
+                for (const [event, handler] of handlers) {
+                    subagent.off(event, handler);
+                }
+            }
+        }
+        this.subagentListeners.clear();
+        const terminatePromises = Array.from(this.subagents.values()).map((subagent) => subagent.terminate());
+        await Promise.all(terminatePromises);
+        this.subagents.clear();
+        this.activeCount = 0;
+        this.emit('all-terminated');
+    }
+    /**
+     * Get result for a specific task
+     */
+    getResult(taskId) {
+        return this.results.get(taskId);
+    }
+    /**
+     * Get all results
+     */
+    getAllResults() {
+        return new Map(this.results);
+    }
+    /**
+     * Get orchestrator status
+     */
+    getStatus() {
+        return {
+            totalSubagents: this.subagents.size,
+            activeSubagents: this.activeCount,
+            completedTasks: this.results.size,
+            queuedTasks: this.taskQueue.length,
+        };
+    }
+    /**
+     * Get list of active subagents
+     */
+    getActiveSubagents() {
+        const active = [];
+        for (const [id, subagent] of this.subagents) {
+            const status = subagent.getStatus();
+            // Check if state is RUNNING (active)
+            if (status.state === SubagentState.RUNNING) {
+                active.push({
+                    id,
+                    role: status.role,
+                    status: status,
+                });
+            }
+        }
+        return active;
+    }
+    /**
+     * Clear all results
+     */
+    clearResults() {
+        this.results.clear();
+    }
+    /**
+     * Get all active subagents (alias for tests)
+     */
+    getActive() {
+        return Array.from(this.subagents.values());
+    }
+    /**
+     * Monitor a specific subagent's status
+     */
+    monitor(subagentId) {
+        const subagent = this.subagents.get(subagentId);
+        if (!subagent) {
+            return null;
+        }
+        return subagent.getStatus();
+    }
+    /**
+     * Get orchestrator statistics
+     */
+    getStats() {
+        const results = Array.from(this.results.values());
+        return {
+            activeAgents: this.subagents.size,
+            totalResults: results.length,
+            successfulTasks: results.filter(r => r.success).length,
+            failedTasks: results.filter(r => !r.success).length,
+        };
+    }
+    /**
+     * Spawn multiple subagents in parallel
+     */
+    async spawnParallel(configs) {
+        return Promise.all(configs.map(({ role, config }) => this.spawn(role, config)));
+    }
+    /**
+     * Send a message to a subagent
+     */
+    async sendMessage(subagentId, message) {
+        const subagent = this.subagents.get(subagentId);
+        if (!subagent) {
+            throw new Error(`Subagent ${subagentId} not found`);
+        }
+        // Subagent will handle the message via receiveMessage method
+        // For now, just emit an event
+        this.emit('message-sent', { subagentId, message });
+    }
+}
+//# sourceMappingURL=subagent-orchestrator.js.map

package/dist/agent/subagent-orchestrator.js.map

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

package/dist/agent/subagent-types.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Subagent System Types
+ *
+ * Type definitions for the autonomous subagent system that enables
+ * parallel task execution and specialized agent capabilities.
+ */
+import type { LLMToolCall } from '../llm/client.js';
+/**
+ * Types of specialized agents available
+ */
+export declare enum SubagentRole {
+    /** General-purpose agent for any task */
+    GENERAL = "general",
+    /** Specialized in writing and running tests */
+    TESTING = "testing",
+    /** Specialized in generating documentation */
+    DOCUMENTATION = "documentation",
+    /** Specialized in code refactoring */
+    REFACTORING = "refactoring",
+    /** Specialized in code analysis and bug detection */
+    ANALYSIS = "analysis",
+    /** Specialized in debugging and error resolution */
+    DEBUG = "debug",
+    /** Specialized in performance optimization */
+    PERFORMANCE = "performance"
+}
+/**
+ * Chat entry (from llm-agent.ts to avoid circular dependency)
+ */
+export interface ChatEntry {
+    type: 'user' | 'assistant' | 'tool_result' | 'tool_call';
+    content: string;
+    timestamp: Date;
+    toolCalls?: LLMToolCall[];
+    toolCall?: LLMToolCall;
+    toolResult?: {
+        success: boolean;
+        output?: string;
+        error?: string;
+    };
+    isStreaming?: boolean;
+    reasoningContent?: string;
+    isReasoningStreaming?: boolean;
+}
+/**
+ * Configuration for creating a subagent
+ */
+export interface SubagentConfig {
+    /** Role/specialization of the subagent */
+    role: SubagentRole;
+    /** Tools this subagent is allowed to use */
+    allowedTools: string[];
+    /** Maximum tool execution rounds */
+    maxToolRounds: number;
+    /** Number of conversation messages to include as context */
+    contextDepth: number;
+    /** Custom system prompt (overrides role-based prompt) */
+    customSystemPrompt?: string;
+    /** Execution timeout in milliseconds */
+    timeout?: number;
+    /** Priority level (higher = executed first) */
+    priority?: number;
+}
+/**
+ * Task to be executed by a subagent
+ */
+export interface SubagentTask {
+    /** Unique task identifier */
+    id: string;
+    /** Human-readable task description */
+    description: string;
+    /** Subagent role to use for this task */
+    role: SubagentRole;
+    /** Priority level (higher = executed first) */
+    priority: number;
+    /** Context to provide to the subagent */
+    context: SubagentContext;
+    /** IDs of tasks that must complete before this one */
+    dependencies?: string[];
+    /** Maximum tool rounds for this task */
+    maxToolRounds?: number;
+    /** Timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Context provided to a subagent
+ */
+export interface SubagentContext {
+    /** File paths to include in context */
+    files?: string[];
+    /** Code snippets to include */
+    codeSnippets?: CodeSnippet[];
+    /** Relevant conversation history */
+    conversationHistory?: ChatEntry[];
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Code snippet for context
+ */
+export interface CodeSnippet {
+    /** File path this snippet is from */
+    path: string;
+    /** The code content */
+    content: string;
+    /** Programming language */
+    language: string;
+    /** Starting line number */
+    startLine?: number;
+    /** Ending line number */
+    endLine?: number;
+}
+/**
+ * Execution state of a subagent
+ */
+export declare enum SubagentState {
+    /** Waiting to be started */
+    PENDING = "pending",
+    /** Currently executing */
+    RUNNING = "running",
+    /** Successfully completed */
+    COMPLETED = "completed",
+    /** Failed with error */
+    FAILED = "failed",
+    /** Cancelled by user or system */
+    CANCELLED = "cancelled"
+}
+/**
+ * Status information for a subagent
+ */
+export interface SubagentStatus {
+    /** Subagent unique identifier */
+    id: string;
+    /** Task being executed */
+    taskId: string;
+    /** Subagent role */
+    role: SubagentRole;
+    /** Current execution state */
+    state: SubagentState;
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** When execution started */
+    startTime: Date;
+    /** When execution ended (if completed/failed) */
+    endTime?: Date;
+    /** Error message if failed */
+    error?: string;
+    /** Current action being performed */
+    currentAction?: string;
+    /** Tools used so far */
+    toolsUsed?: string[];
+    /** Number of tool rounds used */
+    toolRoundsUsed?: number;
+}
+/**
+ * Result of subagent execution
+ */
+export interface SubagentResult {
+    /** Subagent identifier */
+    id: string;
+    /** Task identifier */
+    taskId: string;
+    /** Subagent role */
+    role: SubagentRole;
+    /** Whether execution was successful */
+    success: boolean;
+    /** Output/response from the subagent */
+    output: string;
+    /** Files modified */
+    filesModified?: string[];
+    /** Files created */
+    filesCreated?: string[];
+    /** Tool calls made during execution */
+    toolCalls?: LLMToolCall[];
+    /** Error message if failed */
+    error?: string;
+    /** Execution time in milliseconds */
+    executionTime: number;
+    /** Final status */
+    status: SubagentStatus;
+    /** Artifacts produced (file paths, URLs, etc) */
+    artifacts?: string[];
+}
+/**
+ * Message sent to/from a subagent
+ */
+export interface SubagentMessage {
+    /** Message sender */
+    from: 'parent' | 'subagent';
+    /** Message recipient */
+    to: 'parent' | 'subagent';
+    /** Message type */
+    type: 'instruction' | 'progress' | 'result' | 'error' | 'cancellation';
+    /** Message content */
+    content: string;
+    /** Timestamp */
+    timestamp: Date;
+    /** Additional data */
+    data?: unknown;
+}
+/**
+ * Event emitted by subagent system
+ */
+export interface SubagentEvent {
+    /** Event type */
+    type: 'spawn' | 'start' | 'progress' | 'complete' | 'fail' | 'cancel';
+    /** Subagent ID */
+    subagentId: string;
+    /** Task ID */
+    taskId: string;
+    /** Event data */
+    data?: unknown;
+    /** Timestamp */
+    timestamp: Date;
+}
+/**
+ * Configuration for subagent orchestrator
+ */
+export interface OrchestratorConfig {
+    /** Maximum concurrent subagents */
+    maxConcurrentAgents: number;
+    /** Default timeout for subagents */
+    defaultTimeout: number;
+    /** Enable automatic checkpoint before spawning */
+    autoCheckpoint: boolean;
+    /** Enable detailed logging */
+    verbose: boolean;
+}
+/**
+ * Dependency graph node
+ */
+export interface DependencyNode {
+    /** Task ID */
+    taskId: string;
+    /** Tasks this depends on */
+    dependencies: string[];
+    /** Tasks that depend on this */
+    dependents: string[];
+    /** Execution level (0 = no dependencies) */
+    level: number;
+}
+/**
+ * Dependency graph
+ */
+export interface DependencyGraph {
+    /** All nodes in the graph */
+    nodes: Map<string, DependencyNode>;
+    /** Execution order (batches that can run in parallel) */
+    executionOrder: string[][];
+    /** Whether graph has cycles */
+    hasCycles: boolean;
+    /** Cycle details if any */
+    cycles?: string[][];
+}
+/**
+ * Default subagent configuration by role
+ */
+export declare const DEFAULT_SUBAGENT_CONFIG: Record<SubagentRole, Partial<SubagentConfig>>;
+/**
+ * System prompts for each subagent role
+ */
+export declare const SUBAGENT_SYSTEM_PROMPTS: Record<SubagentRole, string>;