sub-agents-mcp 0.1.2

package/dist/execution/TimeoutManager.js

@@ -0,0 +1,283 @@
+"use strict";
+/**
+ * Timeout management for agent execution with configurable limits and cleanup.
+ *
+ * Provides timeout enforcement with warning mechanisms, graceful cleanup,
+ * and integration with agent execution processes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutManager = exports.DEFAULT_TIMEOUT_CONFIG = void 0;
+const ErrorHandler_1 = require("../utils/ErrorHandler");
+/**
+ * Default timeout configuration.
+ */
+exports.DEFAULT_TIMEOUT_CONFIG = {
+    defaultTimeoutMs: 30000, // 30 seconds
+    warningThresholdPercent: 0.8, // 80%
+    enableWarnings: true,
+    cleanupGracePeriodMs: 5000, // 5 seconds
+};
+/**
+ * Timeout manager for execution time monitoring and enforcement.
+ *
+ * Manages timeout enforcement with configurable limits, warning mechanisms,
+ * and graceful cleanup for agent execution processes.
+ */
+class TimeoutManager {
+    /**
+     * Creates a new TimeoutManager instance.
+     *
+     * @param config - Timeout configuration (uses defaults if not provided)
+     */
+    constructor(config = {}) {
+        this.activeTimeouts = new Map();
+        /**
+         * Statistics tracking for timeout optimization.
+         * @private
+         */
+        this.stats = {
+            totalOperations: 0,
+            totalCompletions: 0,
+            totalCompletionTime: 0,
+            totalTimeouts: 0,
+        };
+        this.config = { ...exports.DEFAULT_TIMEOUT_CONFIG, ...config };
+    }
+    /**
+     * Starts timeout monitoring for an operation.
+     *
+     * @param context - Timeout context for the operation
+     * @returns Operation ID for tracking
+     * @throws {Error} If operation ID is already being tracked
+     */
+    startTimeout(context) {
+        if (this.activeTimeouts.has(context.operationId)) {
+            throw new Error(`Timeout already active for operation: ${context.operationId}`);
+        }
+        // Set up warning timer if enabled and warning callback provided
+        let warningTimer;
+        if (this.config.enableWarnings && context.onWarning) {
+            const warningDelayMs = context.timeoutMs * this.config.warningThresholdPercent;
+            warningTimer = setTimeout(() => {
+                const elapsed = Date.now() - context.startTime.getTime();
+                const remaining = context.timeoutMs - elapsed;
+                context.onWarning?.(remaining);
+            }, warningDelayMs);
+        }
+        // Set up main timeout timer
+        const timer = setTimeout(async () => {
+            await this.handleTimeout(context);
+        }, context.timeoutMs);
+        this.activeTimeouts.set(context.operationId, {
+            timer,
+            warningTimer,
+            context,
+        });
+        return context.operationId;
+    }
+    /**
+     * Clears timeout monitoring for an operation.
+     *
+     * @param operationId - Operation ID to clear
+     * @returns True if timeout was cleared, false if not found
+     */
+    clearTimeout(operationId) {
+        const timeoutData = this.activeTimeouts.get(operationId);
+        if (!timeoutData) {
+            return false;
+        }
+        // Update statistics for successful completion
+        this.updateStats(operationId, true);
+        clearTimeout(timeoutData.timer);
+        if (timeoutData.warningTimer) {
+            clearTimeout(timeoutData.warningTimer);
+        }
+        this.activeTimeouts.delete(operationId);
+        return true;
+    }
+    /**
+     * Gets the remaining time for an operation.
+     *
+     * @param operationId - Operation ID to check
+     * @returns Remaining time in milliseconds, or null if not found
+     */
+    getRemainingTime(operationId) {
+        const timeoutData = this.activeTimeouts.get(operationId);
+        if (!timeoutData) {
+            return null;
+        }
+        const elapsed = Date.now() - timeoutData.context.startTime.getTime();
+        const remaining = timeoutData.context.timeoutMs - elapsed;
+        return Math.max(0, remaining);
+    }
+    /**
+     * Gets the elapsed time for an operation.
+     *
+     * @param operationId - Operation ID to check
+     * @returns Elapsed time in milliseconds, or null if not found
+     */
+    getElapsedTime(operationId) {
+        const timeoutData = this.activeTimeouts.get(operationId);
+        if (!timeoutData) {
+            return null;
+        }
+        return Date.now() - timeoutData.context.startTime.getTime();
+    }
+    /**
+     * Checks if an operation is currently being tracked.
+     *
+     * @param operationId - Operation ID to check
+     * @returns True if operation is being tracked
+     */
+    isActive(operationId) {
+        return this.activeTimeouts.has(operationId);
+    }
+    /**
+     * Gets all active operation IDs.
+     *
+     * @returns Array of active operation IDs
+     */
+    getActiveOperations() {
+        return Array.from(this.activeTimeouts.keys());
+    }
+    /**
+     * Creates a timeout context with default values.
+     *
+     * @param operationId - Unique operation identifier
+     * @param timeoutMs - Timeout duration (uses default if not provided)
+     * @param options - Additional context options
+     * @returns Timeout context
+     */
+    createContext(operationId, timeoutMs, options = {}) {
+        const context = {
+            operationId,
+            startTime: new Date(),
+            timeoutMs: timeoutMs ?? this.config.defaultTimeoutMs,
+        };
+        if (options.onWarning) {
+            context.onWarning = options.onWarning;
+        }
+        if (options.onCleanup) {
+            context.onCleanup = options.onCleanup;
+        }
+        return context;
+    }
+    /**
+     * Gets the current configuration.
+     *
+     * @returns Timeout configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Clears all active timeouts.
+     *
+     * @returns Number of timeouts cleared
+     */
+    clearAllTimeouts() {
+        const count = this.activeTimeouts.size;
+        for (const [operationId] of this.activeTimeouts) {
+            this.clearTimeout(operationId);
+        }
+        return count;
+    }
+    /**
+     * Gets timeout statistics for monitoring and optimization.
+     *
+     * @returns Timeout statistics
+     */
+    getTimeoutStats() {
+        return {
+            activeOperations: this.activeTimeouts.size,
+            totalOperationsStarted: this.stats.totalOperations,
+            averageCompletionTime: this.stats.totalCompletions > 0
+                ? this.stats.totalCompletionTime / this.stats.totalCompletions
+                : 0,
+            timeoutRate: this.stats.totalOperations > 0 ? this.stats.totalTimeouts / this.stats.totalOperations : 0,
+        };
+    }
+    /**
+     * Suggests optimal timeout based on historical data.
+     *
+     * @param operationType - Type of operation for historical analysis (reserved for future use)
+     * @returns Suggested timeout in milliseconds
+     */
+    suggestOptimalTimeout(operationType = 'default') {
+        // operationType is reserved for future use when we implement operation-specific timeouts
+        void operationType;
+        const stats = this.getTimeoutStats();
+        const baseTimeout = this.config.defaultTimeoutMs;
+        // If no historical data, use default
+        if (stats.averageCompletionTime === 0) {
+            return baseTimeout;
+        }
+        // Add buffer based on completion time and timeout rate
+        const bufferMultiplier = 1 + stats.timeoutRate * 2; // More buffer for higher timeout rates
+        const suggestedTimeout = stats.averageCompletionTime * bufferMultiplier;
+        // Ensure it's within reasonable bounds
+        return Math.max(Math.min(suggestedTimeout, baseTimeout * 3), baseTimeout * 0.5);
+    }
+    /**
+     * Updates timeout statistics.
+     *
+     * @param operationId - Operation that completed/timed out
+     * @param completed - Whether operation completed successfully
+     * @private
+     */
+    updateStats(operationId, completed) {
+        const timeoutData = this.activeTimeouts.get(operationId);
+        if (!timeoutData)
+            return;
+        this.stats.totalOperations++;
+        if (completed) {
+            this.stats.totalCompletions++;
+            const completionTime = Date.now() - timeoutData.context.startTime.getTime();
+            this.stats.totalCompletionTime += completionTime;
+        }
+        else {
+            this.stats.totalTimeouts++;
+        }
+    }
+    /**
+     * Handles timeout event with cleanup and error throwing.
+     *
+     * @param context - Timeout context
+     * @private
+     */
+    async handleTimeout(context) {
+        // Update statistics
+        this.updateStats(context.operationId, false);
+        // Remove from active timeouts
+        this.activeTimeouts.delete(context.operationId);
+        // Perform cleanup if provided
+        if (context.onCleanup) {
+            try {
+                // Give cleanup a grace period
+                const cleanupPromise = context.onCleanup();
+                const cleanupTimeout = new Promise((_, reject) => {
+                    setTimeout(() => {
+                        reject(new Error('Cleanup timeout exceeded'));
+                    }, this.config.cleanupGracePeriodMs);
+                });
+                await Promise.race([cleanupPromise, cleanupTimeout]);
+            }
+            catch (cleanupError) {
+                // Log cleanup error but don't prevent timeout error from being thrown
+                console.error(`Cleanup failed for operation ${context.operationId}:`, cleanupError);
+            }
+        }
+        // Throw timeout error with enhanced context
+        const elapsed = Date.now() - context.startTime.getTime();
+        throw new ErrorHandler_1.TimeoutError(`Operation timed out after ${elapsed}ms (limit: ${context.timeoutMs}ms)`, 'EXECUTION_TIMEOUT', context.timeoutMs, {
+            operation: 'timeout_handling',
+            metadata: {
+                operationId: context.operationId,
+                actualDuration: elapsed,
+                configuredTimeout: context.timeoutMs,
+            },
+        });
+    }
+}
+exports.TimeoutManager = TimeoutManager;
+//# sourceMappingURL=TimeoutManager.js.map

package/dist/execution/TimeoutManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeoutManager.js","sourceRoot":"","sources":["../../src/execution/TimeoutManager.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,yDAAqD;AAuCrD;;GAEG;AACU,QAAA,sBAAsB,GAAkB;IACnD,gBAAgB,EAAE,KAAK,EAAE,aAAa;IACtC,uBAAuB,EAAE,GAAG,EAAE,MAAM;IACpC,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,IAAI,EAAE,YAAY;CACzC,CAAA;AAED;;;;;GAKG;AACH,MAAa,cAAc;IAWzB;;;;OAIG;IACH,YAAY,SAAiC,EAAE;QAd9B,mBAAc,GAO3B,IAAI,GAAG,EAAE,CAAA;QAwSb;;;WAGG;QACK,UAAK,GAAG;YACd,eAAe,EAAE,CAAC;YAClB,gBAAgB,EAAE,CAAC;YACnB,mBAAmB,EAAE,CAAC;YACtB,aAAa,EAAE,CAAC;SACjB,CAAA;QAzSC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,8BAAsB,EAAE,GAAG,MAAM,EAAE,CAAA;IACxD,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,OAAuB;QAClC,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;QACjF,CAAC;QAED,gEAAgE;QAChE,IAAI,YAAwC,CAAA;QAC5C,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACpD,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAA;YAC9E,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;gBACxD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,GAAG,OAAO,CAAA;gBAC7C,OAAO,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAA;YAChC,CAAC,EAAE,cAAc,CAAC,CAAA;QACpB,CAAC;QAED,4BAA4B;QAC5B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YAClC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;QACnC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QAErB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE;YAC3C,KAAK;YACL,YAAY;YACZ,OAAO;SACR,CAAC,CAAA;QAEF,OAAO,OAAO,CAAC,WAAW,CAAA;IAC5B,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,WAAmB;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACxD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,8CAA8C;QAC9C,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;QAEnC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAC/B,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;YAC7B,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;QACxC,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,WAAmB;QAClC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACxD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;QACpE,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,GAAG,OAAO,CAAA;QACzD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IAC/B,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,WAAmB;QAChC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACxD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;IAC7D,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,WAAmB;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IAC7C,CAAC;IAED;;;;OAIG;IACH,mBAAmB;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAA;IAC/C,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CACX,WAAmB,EACnB,SAAkB,EAClB,UAGI,EAAE;QAEN,MAAM,OAAO,GAAmB;YAC9B,WAAW;YACX,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,SAAS,EAAE,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB;SACrD,CAAA;QAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;QACvC,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;QACvC,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,gBAAgB;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAA;QACtC,KAAK,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAChD,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAA;QAChC,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;OAIG;IACH,eAAe;QAMb,OAAO;YACL,gBAAgB,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI;YAC1C,sBAAsB,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe;YAClD,qBAAqB,EACnB,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,CAAC;gBAC7B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB;gBAC9D,CAAC,CAAC,CAAC;YACP,WAAW,EACT,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;SAC7F,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,aAAa,GAAG,SAAS;QAC7C,yFAAyF;QACzF,KAAK,aAAa,CAAA;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,EAAE,CAAA;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAA;QAEhD,qCAAqC;QACrC,IAAI,KAAK,CAAC,qBAAqB,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,WAAW,CAAA;QACpB,CAAC;QAED,uDAAuD;QACvD,MAAM,gBAAgB,GAAG,CAAC,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,CAAA,CAAC,uCAAuC;QAC1F,MAAM,gBAAgB,GAAG,KAAK,CAAC,qBAAqB,GAAG,gBAAgB,CAAA;QAEvE,uCAAuC;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,WAAW,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,GAAG,CAAC,CAAA;IACjF,CAAC;IAED;;;;;;OAMG;IACK,WAAW,CAAC,WAAmB,EAAE,SAAkB;QACzD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACxD,IAAI,CAAC,WAAW;YAAE,OAAM;QAExB,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAA;QAE5B,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAA;YAC7B,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;YAC3E,IAAI,CAAC,KAAK,CAAC,mBAAmB,IAAI,cAAc,CAAA;QAClD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAA;QAC5B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,aAAa,CAAC,OAAuB;QACjD,oBAAoB;QACpB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;QAE5C,8BAA8B;QAC9B,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAE/C,8BAA8B;QAC9B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,8BAA8B;gBAC9B,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,CAAA;gBAC1C,MAAM,cAAc,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBACrD,UAAU,CAAC,GAAG,EAAE;wBACd,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAA;oBAC/C,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAA;gBACtC,CAAC,CAAC,CAAA;gBAEF,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAA;YACtD,CAAC;YAAC,OAAO,YAAY,EAAE,CAAC;gBACtB,sEAAsE;gBACtE,OAAO,CAAC,KAAK,CAAC,gCAAgC,OAAO,CAAC,WAAW,GAAG,EAAE,YAAY,CAAC,CAAA;YACrF,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;QACxD,MAAM,IAAI,2BAAY,CACpB,6BAA6B,OAAO,cAAc,OAAO,CAAC,SAAS,KAAK,EACxE,mBAAmB,EACnB,OAAO,CAAC,SAAS,EACjB;YACE,SAAS,EAAE,kBAAkB;YAC7B,QAAQ,EAAE;gBACR,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,cAAc,EAAE,OAAO;gBACvB,iBAAiB,EAAE,OAAO,CAAC,SAAS;aACrC;SACF,CACF,CAAA;IACH,CAAC;CAYF;AA3TD,wCA2TC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * MCP Server Application Entry Point
+ *
+ * Initializes and starts the MCP server with configuration loaded from
+ * environment variables. This server provides AI agent execution capabilities
+ * through the Model Context Protocol.
+ */
+export { McpServer } from './server/McpServer';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AA6CH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * MCP Server Application Entry Point
+ *
+ * Initializes and starts the MCP server with configuration loaded from
+ * environment variables. This server provides AI agent execution capabilities
+ * through the Model Context Protocol.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpServer = void 0;
+const ServerConfig_1 = require("./config/ServerConfig");
+const McpServer_1 = require("./server/McpServer");
+/**
+ * Main function to start the MCP server
+ * @throws {Error} When server initialization or startup fails
+ */
+async function main() {
+    try {
+        // Load configuration from environment
+        const config = new ServerConfig_1.ServerConfig();
+        // Create and start MCP server
+        const server = new McpServer_1.McpServer(config);
+        // Start the server
+        await server.start();
+        // Setup graceful shutdown handling
+        process.on('SIGINT', async () => {
+            await server.close();
+            process.exit(0);
+        });
+        process.on('SIGTERM', async () => {
+            await server.close();
+            process.exit(0);
+        });
+    }
+    catch (error) {
+        console.error('Failed to start MCP server:', error);
+        process.exit(1);
+    }
+}
+// Start the server if this module is the main entry point
+// Note: Using process.argv check instead of import.meta for broader compatibility
+if (require.main === module) {
+    main().catch((error) => {
+        console.error('Unhandled error in main:', error);
+        process.exit(1);
+    });
+}
+var McpServer_2 = require("./server/McpServer");
+Object.defineProperty(exports, "McpServer", { enumerable: true, get: function () { return McpServer_2.McpServer; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;;;;GAMG;;;AAEH,0DAAsD;AACtD,oDAAgD;AAEhD;;;GAGG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,sCAAsC;QACtC,MAAM,MAAM,GAAG,IAAI,2BAAY,EAAE,CAAA;QAEjC,8BAA8B;QAC9B,MAAM,MAAM,GAAG,IAAI,qBAAS,CAAC,MAAM,CAAC,CAAA;QAEpC,mBAAmB;QACnB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;QAEpB,mCAAmC;QACnC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC,CAAC,CAAA;QAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAA;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,kFAAkF;AAClF,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAA;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,kDAAgD;AAAvC,sGAAA,SAAS,OAAA"}

package/dist/resources/AgentResources.d.ts

@@ -0,0 +1,104 @@
+/**
+ * AgentResources implementation for publishing agent definitions via MCP
+ *
+ * Provides MCP resources for agent discovery including a list of all
+ * available agents and individual agent definition resources.
+ */
+import type { AgentManager } from '../agents/AgentManager';
+/**
+ * MCP resource content type for text responses
+ */
+interface McpResourceContent {
+    [x: string]: unknown;
+    type: 'text';
+    text: string;
+    uri: string;
+}
+/**
+ * MCP resource response format
+ */
+interface McpResourceResponse {
+    [x: string]: unknown;
+    contents: McpResourceContent[];
+}
+/**
+ * MCP resource definition for publication
+ */
+interface McpResource {
+    [x: string]: unknown;
+    uri: string;
+    name: string;
+    description: string;
+    mimeType?: string;
+}
+/**
+ * AgentResources class for managing agent definition resources in MCP
+ *
+ * Publishes agent information as MCP resources that clients can discover
+ * and read to understand available agents and their capabilities.
+ */
+export declare class AgentResources {
+    private agentManager?;
+    private logger;
+    constructor(agentManager?: AgentManager | undefined);
+    /**
+     * Get list of all published agent resources
+     *
+     * @returns Promise resolving to array of MCP resource definitions
+     */
+    listResources(): Promise<McpResource[]>;
+    /**
+     * Read content of a specific agent resource
+     *
+     * @param uri - Resource URI to read
+     * @returns Promise resolving to resource content
+     * @throws {Error} When resource URI is invalid or not found
+     */
+    readResource(uri: string): Promise<McpResourceResponse>;
+    /**
+     * Get content for the agent list resource
+     *
+     * @private
+     * @returns Promise resolving to agent list content
+     */
+    private getAgentListContent;
+    /**
+     * Get content for a specific agent resource
+     *
+     * @private
+     * @param agentName - Name of the agent to get content for
+     * @returns Promise resolving to agent content
+     */
+    private getAgentContent;
+    /**
+     * Format agent definition content for display
+     *
+     * @private
+     * @param agent - Agent definition to format
+     * @returns Formatted content string
+     */
+    private formatAgentContent;
+    /**
+     * Get list of available agent names
+     *
+     * @private
+     * @returns Promise resolving to array of agent names
+     */
+    private getAvailableAgentNames;
+    /**
+     * Generate unique request ID for tracking
+     *
+     * @private
+     * @returns Unique request identifier
+     */
+    private generateRequestId;
+    /**
+     * Check if a resource URI is valid with enhanced validation
+     *
+     * @param uri - Resource URI to validate
+     * @returns True if URI is valid
+     */
+    isValidResourceUri(uri: string): boolean;
+}
+export {};
+//# sourceMappingURL=AgentResources.d.ts.map

package/dist/resources/AgentResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentResources.d.ts","sourceRoot":"","sources":["../../src/resources/AgentResources.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAI3D;;GAEG;AACH,UAAU,kBAAkB;IAC1B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACpB,QAAQ,EAAE,kBAAkB,EAAE,CAAA;CAC/B;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAGb,OAAO,CAAC,YAAY,CAAC;IAFjC,OAAO,CAAC,MAAM,CAAQ;gBAEF,YAAY,CAAC,EAAE,YAAY,YAAA;IAI/C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAyD7C;;;;;;OAMG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4C7D;;;;;OAKG;YACW,mBAAmB;IA4DjC;;;;;;OAMG;YACW,eAAe;IAyD7B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;;;;OAKG;YACW,sBAAsB;IAapC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;;OAKG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CA4BzC"}