sub-agents-mcp 0.1.2

package/dist/execution/AgentExecutor.d.ts

@@ -0,0 +1,114 @@
+import type { ExecutionParams } from '../types/ExecutionParams';
+import { Logger } from '../utils/Logger';
+/**
+ * Detailed execution result that includes performance metrics and method information.
+ * Extends the basic ExecutionResult with additional monitoring capabilities.
+ */
+export interface AgentExecutionResult {
+    /**
+     * Standard output from the agent execution.
+     * Contains the agent's response or execution result.
+     */
+    stdout: string;
+    /**
+     * Standard error output from the agent execution.
+     * Contains error messages and diagnostic information.
+     */
+    stderr: string;
+    /**
+     * Exit code returned by the agent process.
+     * 0 indicates success, non-zero indicates failure.
+     */
+    exitCode: number;
+    /**
+     * Total execution time in milliseconds.
+     * Used for performance monitoring and optimization.
+     */
+    executionTime: number;
+    /**
+     * Whether a result JSON was successfully obtained from the agent.
+     * True when StreamProcessor detects a valid JSON response.
+     */
+    hasResult?: boolean;
+    /**
+     * The parsed JSON result from the agent if available.
+     * Contains the structured response data when hasResult is true.
+     */
+    resultJson?: unknown;
+}
+/**
+ * Simplified execution configuration.
+ */
+export interface ExecutionConfig {
+    /**
+     * Maximum execution timeout in milliseconds.
+     * Default: 5 minutes (300000ms)
+     */
+    executionTimeout: number;
+    /**
+     * Type of agent to use for execution.
+     * 'cursor' or 'claude'
+     */
+    agentType: 'cursor' | 'claude';
+}
+export declare const DEFAULT_EXECUTION_TIMEOUT = 300000;
+/**
+ * Creates a complete ExecutionConfig with the provided agent type.
+ * @param agentType - The type of agent to use
+ * @param overrides - Optional overrides for thresholds
+ */
+export declare function createExecutionConfig(agentType: 'cursor' | 'claude', overrides?: Partial<Omit<ExecutionConfig, 'agentType'>>): ExecutionConfig;
+/**
+ * AgentExecutor class implements execution strategy for running Claude Code agents.
+ * Uses child_process.spawn for proper TTY handling and stdin/stdout streaming.
+ * Includes performance monitoring and timeout management.
+ */
+export declare class AgentExecutor {
+    private readonly config;
+    private readonly logger;
+    /**
+     * Creates a new AgentExecutor instance.
+     *
+     * @param config - Execution configuration including CLI command and thresholds
+     * @param logger - Optional Logger instance for structured logging
+     */
+    constructor(config: ExecutionConfig, logger?: Logger);
+    /**
+     * Executes an agent with the specified parameters using spawn strategy.
+     *
+     * This method implements the core execution logic using spawn for proper TTY
+     * handling and streaming. It includes comprehensive performance monitoring.
+     *
+     * @param params - Execution parameters including agent name, prompt, and options
+     * @returns Promise resolving to detailed execution result with performance metrics
+     * @throws {Error} When agent execution fails or parameters are invalid
+     *
+     * @example
+     * ```typescript
+     * const executor = new AgentExecutor()
+     * const result = await executor.executeAgent({
+     *   agent: "code-helper",
+     *   prompt: "Review this code",
+     *   cwd: "/project"
+     * })
+     * console.log(`Execution took ${result.executionTime}ms using ${result.executionMethod}`)
+     * ```
+     */
+    executeAgent(params: ExecutionParams): Promise<AgentExecutionResult>;
+    /**
+     * Executes an agent using child_process.spawn for proper TTY handling.
+     *
+     * @private
+     * @param params - Execution parameters
+     * @returns Promise resolving to execution result
+     */
+    private executeWithSpawn;
+    /**
+     * Generates a unique request ID for tracking execution requests.
+     *
+     * @private
+     * @returns Unique request identifier
+     */
+    private generateRequestId;
+}
+//# sourceMappingURL=AgentExecutor.d.ts.map

package/dist/execution/AgentExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentExecutor.d.ts","sourceRoot":"","sources":["../../src/execution/AgentExecutor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAiB,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAGxD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAA;IAExB;;;OAGG;IACH,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAC/B;AAED,eAAO,MAAM,yBAAyB,SAAS,CAAA;AAE/C;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,QAAQ,GAAG,QAAQ,EAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,GACtD,eAAe,CAMjB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B;;;;;OAKG;gBACS,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM;IAMpD;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA+E1E;;;;;;OAMG;YACW,gBAAgB;IAqH9B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;CAG1B"}

package/dist/execution/AgentExecutor.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentExecutor = exports.DEFAULT_EXECUTION_TIMEOUT = void 0;
+exports.createExecutionConfig = createExecutionConfig;
+const node_child_process_1 = require("node:child_process");
+const Logger_1 = require("../utils/Logger");
+const StreamProcessor_1 = require("./StreamProcessor");
+exports.DEFAULT_EXECUTION_TIMEOUT = 300000; // 5 minutes
+/**
+ * Creates a complete ExecutionConfig with the provided agent type.
+ * @param agentType - The type of agent to use
+ * @param overrides - Optional overrides for thresholds
+ */
+function createExecutionConfig(agentType, overrides) {
+    return {
+        executionTimeout: exports.DEFAULT_EXECUTION_TIMEOUT,
+        ...overrides,
+        agentType,
+    };
+}
+/**
+ * AgentExecutor class implements execution strategy for running Claude Code agents.
+ * Uses child_process.spawn for proper TTY handling and stdin/stdout streaming.
+ * Includes performance monitoring and timeout management.
+ */
+class AgentExecutor {
+    /**
+     * Creates a new AgentExecutor instance.
+     *
+     * @param config - Execution configuration including CLI command and thresholds
+     * @param logger - Optional Logger instance for structured logging
+     */
+    constructor(config, logger) {
+        this.config = config;
+        // Use provided logger or create new one with LOG_LEVEL env var
+        this.logger = logger || new Logger_1.Logger(process.env['LOG_LEVEL'] || 'info');
+    }
+    /**
+     * Executes an agent with the specified parameters using spawn strategy.
+     *
+     * This method implements the core execution logic using spawn for proper TTY
+     * handling and streaming. It includes comprehensive performance monitoring.
+     *
+     * @param params - Execution parameters including agent name, prompt, and options
+     * @returns Promise resolving to detailed execution result with performance metrics
+     * @throws {Error} When agent execution fails or parameters are invalid
+     *
+     * @example
+     * ```typescript
+     * const executor = new AgentExecutor()
+     * const result = await executor.executeAgent({
+     *   agent: "code-helper",
+     *   prompt: "Review this code",
+     *   cwd: "/project"
+     * })
+     * console.log(`Execution took ${result.executionTime}ms using ${result.executionMethod}`)
+     * ```
+     */
+    async executeAgent(params) {
+        // Input validation
+        if (!params || !params.agent || !params.prompt) {
+            const error = 'Invalid execution parameters: agent and prompt are required';
+            this.logger.error('Agent execution failed during validation', undefined, { error, params });
+            throw new Error(error);
+        }
+        if (params.agent.length === 0 || params.prompt.length === 0) {
+            const error = 'Invalid execution parameters: agent and prompt cannot be empty';
+            this.logger.error('Agent execution failed during validation', undefined, { error, params });
+            throw new Error(error);
+        }
+        const startTime = Date.now();
+        const requestId = this.generateRequestId();
+        this.logger.info('Starting agent execution', {
+            requestId,
+            agent: params.agent,
+            promptLength: params.prompt.length,
+            cwd: params.cwd,
+            extraArgs: params.extra_args?.length || 0,
+        });
+        try {
+            // Add minimal delay to ensure execution time is measurable
+            await new Promise((resolve) => setTimeout(resolve, 1));
+            // Use spawn method for proper TTY handling
+            // Execute using spawn for proper TTY handling
+            const result = await this.executeWithSpawn(params);
+            const executionTime = Date.now() - startTime;
+            this.logger.info('Agent execution completed', {
+                requestId,
+                exitCode: result.exitCode,
+                executionTime,
+                hasResult: result.hasResult,
+            });
+            return {
+                stdout: result.stdout,
+                stderr: result.stderr,
+                exitCode: result.exitCode,
+                executionTime,
+                ...(result.hasResult !== undefined && { hasResult: result.hasResult }),
+                ...(result.resultJson !== undefined && { resultJson: result.resultJson }),
+            };
+        }
+        catch (error) {
+            const executionTime = Date.now() - startTime;
+            this.logger.error('Agent execution failed', error instanceof Error ? error : undefined, {
+                requestId,
+                executionTime,
+            });
+            // Re-throw enhancement errors
+            if (error instanceof Error &&
+                (error.message.includes('enhance') || error.message.includes('Enhancement'))) {
+                throw error;
+            }
+            // Return error result for execution failures
+            return {
+                stdout: '',
+                stderr: error instanceof Error ? error.message : 'Unknown execution error',
+                exitCode: 1,
+                executionTime,
+                hasResult: false,
+                resultJson: undefined,
+            };
+        }
+    }
+    /**
+     * Executes an agent using child_process.spawn for proper TTY handling.
+     *
+     * @private
+     * @param params - Execution parameters
+     * @returns Promise resolving to execution result
+     */
+    async executeWithSpawn(params) {
+        return new Promise((resolve) => {
+            // Generate command and args - both CLIs use the same interface
+            const formattedPrompt = `[System Context]\n${params.agent}\n\n[User Prompt]\n${params.prompt}`;
+            const args = ['--output-format', 'json', '-p', formattedPrompt];
+            // Determine command based on agent type
+            const command = this.config.agentType === 'claude' ? 'claude' : 'cursor-agent';
+            // Add API key for cursor-cli if available
+            if (this.config.agentType === 'cursor' && process.env['CLI_API_KEY']) {
+                args.push('-a', process.env['CLI_API_KEY']);
+            }
+            this.logger.debug('Executing with spawn', {
+                command,
+                cwd: params.cwd || process.cwd(),
+            });
+            // Spawn process
+            const childProcess = (0, node_child_process_1.spawn)(command, args, {
+                cwd: params.cwd || process.cwd(),
+                stdio: ['ignore', 'pipe', 'pipe'], // stdin set to 'ignore' as cursor-agent receives prompt via args
+                shell: false,
+                env: process.env,
+            });
+            // Initialize stream processor and buffers
+            const streamProcessor = new StreamProcessor_1.StreamProcessor();
+            let stdout = '';
+            let stderr = '';
+            let stdoutBuffer = '';
+            // No need to handle stdin as it's set to 'ignore'
+            const executionTimeout = setTimeout(() => {
+                this.logger.warn('Execution timeout reached', {
+                    timeout: this.config.executionTimeout,
+                });
+                childProcess.kill('SIGTERM');
+                // Get any result collected so far
+                const result = streamProcessor.getResult();
+                resolve({
+                    stdout: result ? JSON.stringify(result) : stdout,
+                    stderr: stderr || `Execution timeout: ${this.config.executionTimeout}ms`,
+                    exitCode: 124, // Standard timeout exit code
+                    hasResult: result !== null,
+                    resultJson: result !== null ? result : undefined,
+                });
+            }, this.config.executionTimeout);
+            // Handle stdout stream with simplified processing
+            childProcess.stdout?.on('data', (data) => {
+                const chunk = data.toString();
+                stdout += chunk;
+                stdoutBuffer += chunk;
+                // Process complete lines
+                const lines = stdoutBuffer.split('\n');
+                stdoutBuffer = lines.pop() || ''; // Keep incomplete line in buffer
+                for (const line of lines) {
+                    // Process line returns true when final JSON is detected
+                    const isComplete = streamProcessor.processLine(line);
+                    if (isComplete) {
+                        // Processing complete, kill the process
+                        childProcess.kill('SIGTERM');
+                        break;
+                    }
+                }
+            });
+            // Handle stderr stream
+            childProcess.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            childProcess.on('close', (code) => {
+                clearTimeout(executionTimeout);
+                // Get the final result JSON
+                const result = streamProcessor.getResult();
+                resolve({
+                    stdout: result ? JSON.stringify(result) : stdout,
+                    stderr,
+                    exitCode: code || 0,
+                    hasResult: result !== null,
+                    resultJson: result !== null ? result : undefined,
+                });
+            });
+            // Handle process errors
+            childProcess.on('error', (error) => {
+                clearTimeout(executionTimeout);
+                // Get any result collected before error
+                const result = streamProcessor.getResult();
+                resolve({
+                    stdout: result ? JSON.stringify(result) : stdout,
+                    stderr: stderr || error.message,
+                    exitCode: 1,
+                    hasResult: result !== null,
+                    resultJson: result !== null ? result : undefined,
+                });
+            });
+        });
+    }
+    /**
+     * Generates a unique request ID for tracking execution requests.
+     *
+     * @private
+     * @returns Unique request identifier
+     */
+    generateRequestId() {
+        return `req_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+    }
+}
+exports.AgentExecutor = AgentExecutor;
+//# sourceMappingURL=AgentExecutor.js.map

package/dist/execution/AgentExecutor.js.map

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

package/dist/execution/ExecutionLimits.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Execution limits configuration and enforcement for agent execution.
+ *
+ * Provides configurable limits for resource usage including memory, concurrency,
+ * execution time, and output size to ensure system stability and prevent abuse.
+ */
+/**
+ * Configuration interface for execution limits.
+ */
+export interface ExecutionLimitsConfig {
+    /** Maximum number of concurrent agent executions (default: 5) */
+    maxConcurrentExecutions: number;
+    /** Maximum memory usage per execution in MB (default: 100) */
+    maxMemoryUsageMB: number;
+    /** Maximum output size in bytes (default: 1MB) */
+    maxOutputSizeBytes: number;
+    /** Maximum execution time in milliseconds (default: 90000) */
+    maxExecutionTimeMs: number;
+    /** Enable resource monitoring (default: true) */
+    enableResourceMonitoring: boolean;
+}
+/**
+ * Resource usage statistics for monitoring.
+ */
+export interface ResourceUsage {
+    /** Current memory usage in MB */
+    memoryUsageMB: number;
+    /** Current number of active executions */
+    activeExecutions: number;
+    /** Current output size in bytes */
+    outputSizeBytes: number;
+    /** Execution time elapsed in milliseconds */
+    executionTimeMs: number;
+}
+/**
+ * Default execution limits configuration.
+ */
+export declare const DEFAULT_EXECUTION_LIMITS: ExecutionLimitsConfig;
+/**
+ * Execution limits enforcer for resource constraint management.
+ *
+ * Monitors and enforces limits on concurrent executions, memory usage,
+ * output size, and execution time to prevent resource exhaustion.
+ */
+export declare class ExecutionLimits {
+    private readonly config;
+    private activeExecutions;
+    /**
+     * Creates a new ExecutionLimits instance.
+     *
+     * @param config - Execution limits configuration (uses defaults if not provided)
+     */
+    constructor(config?: Partial<ExecutionLimitsConfig>);
+    /**
+     * Checks if a new execution can be started within limits.
+     *
+     * @param executionId - Unique identifier for the execution
+     * @throws {ResourceLimitError} When concurrent execution limit is exceeded
+     */
+    checkConcurrencyLimit(executionId: string): void;
+    /**
+     * Registers a new execution as active.
+     *
+     * @param executionId - Unique identifier for the execution
+     */
+    registerExecution(executionId: string): void;
+    /**
+     * Unregisters an execution as completed.
+     *
+     * @param executionId - Unique identifier for the execution
+     */
+    unregisterExecution(executionId: string): void;
+    /**
+     * Checks if memory usage is within limits.
+     *
+     * @param memoryUsageMB - Current memory usage in MB
+     * @throws {ResourceLimitError} When memory limit is exceeded
+     */
+    checkMemoryLimit(memoryUsageMB: number): void;
+    /**
+     * Checks if output size is within limits.
+     *
+     * @param outputSizeBytes - Current output size in bytes
+     * @throws {ResourceLimitError} When output size limit is exceeded
+     */
+    checkOutputSizeLimit(outputSizeBytes: number): void;
+    /**
+     * Gets current resource usage statistics.
+     *
+     * @param currentMemoryMB - Current memory usage in MB
+     * @param currentOutputBytes - Current output size in bytes
+     * @param executionTimeMs - Current execution time in milliseconds
+     * @returns Resource usage statistics
+     */
+    getResourceUsage(currentMemoryMB?: number, currentOutputBytes?: number, executionTimeMs?: number): ResourceUsage;
+    /**
+     * Gets the current configuration.
+     *
+     * @returns Execution limits configuration
+     */
+    getConfig(): ExecutionLimitsConfig;
+    /**
+     * Gets the number of active executions.
+     *
+     * @returns Number of active executions
+     */
+    getActiveExecutionCount(): number;
+    /**
+     * Checks if resource monitoring is enabled.
+     *
+     * @returns True if resource monitoring is enabled
+     */
+    isResourceMonitoringEnabled(): boolean;
+    /**
+     * Gets adaptive resource limits based on current system state.
+     *
+     * @param systemMemoryMB - Current available system memory in MB
+     * @param systemLoad - Current system load (0-1)
+     * @returns Adjusted execution limits configuration
+     */
+    getAdaptiveLimits(systemMemoryMB: number, systemLoad?: number): ExecutionLimitsConfig;
+    /**
+     * Monitors resource usage and suggests optimizations.
+     *
+     * @param currentUsage - Current resource usage
+     * @returns Resource optimization suggestions
+     */
+    analyzeResourceUsage(currentUsage: ResourceUsage): {
+        recommendations: string[];
+        severity: 'low' | 'medium' | 'high';
+        shouldThrottle: boolean;
+    };
+    /**
+     * Creates execution limits optimized for specific operation types.
+     *
+     * @param operationType - Type of operation (light, standard, heavy)
+     * @returns Optimized execution limits configuration
+     */
+    createOptimizedConfig(operationType: 'light' | 'standard' | 'heavy'): ExecutionLimitsConfig;
+}
+//# sourceMappingURL=ExecutionLimits.d.ts.map

package/dist/execution/ExecutionLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionLimits.d.ts","sourceRoot":"","sources":["../../src/execution/ExecutionLimits.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,uBAAuB,EAAE,MAAM,CAAA;IAE/B,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,CAAA;IAExB,kDAAkD;IAClD,kBAAkB,EAAE,MAAM,CAAA;IAE1B,8DAA8D;IAC9D,kBAAkB,EAAE,MAAM,CAAA;IAE1B,iDAAiD;IACjD,wBAAwB,EAAE,OAAO,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAA;IAErB,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAA;IAExB,mCAAmC;IACnC,eAAe,EAAE,MAAM,CAAA;IAEvB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,qBAMtC,CAAA;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,gBAAgB,CAAyB;IAEjD;;;;OAIG;gBACS,MAAM,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAIvD;;;;;OAKG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAehD;;;;OAIG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAK5C;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI9C;;;;;OAKG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAW7C;;;;;OAKG;IACH,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAWnD;;;;;;;OAOG;IACH,gBAAgB,CACd,eAAe,SAAI,EACnB,kBAAkB,SAAI,EACtB,eAAe,SAAI,GAClB,aAAa;IAShB;;;;OAIG;IACH,SAAS,IAAI,qBAAqB;IAIlC;;;;OAIG;IACH,uBAAuB,IAAI,MAAM;IAIjC;;;;OAIG;IACH,2BAA2B,IAAI,OAAO;IAItC;;;;;;OAMG;IACH,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,SAAM,GAAG,qBAAqB;IAqBlF;;;;;OAKG;IACH,oBAAoB,CAAC,YAAY,EAAE,aAAa,GAAG;QACjD,eAAe,EAAE,MAAM,EAAE,CAAA;QACzB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;QACnC,cAAc,EAAE,OAAO,CAAA;KACxB;IAmDD;;;;;OAKG;IACH,qBAAqB,CAAC,aAAa,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,qBAAqB;CA0B5F"}