sub-agents-mcp 0.5.2 → 0.5.3

package/dist/execution/McpRequestTimeout.js

@@ -1,278 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.McpRequestTimeout = exports.DEFAULT_MCP_TIMEOUT_CONFIG = void 0;
-const Logger_1 = require("../utils/Logger");
-/**
- * Default timeout configuration for MCP requests
- * Based on MCP best practices and LLM operation characteristics
- */
-exports.DEFAULT_MCP_TIMEOUT_CONFIG = {
-    defaultTimeoutMs: 360000, // 6 minutes - considering complex agent operations
-    maxTimeoutMs: 660000, // 11 minutes - absolute maximum for AI->MCP
-    progressResetEnabled: true,
-    warningThresholdMs: 60000, // 1 minute - send progress notification
-    enableDebugLogging: false,
-};
-/**
- * McpRequestTimeout manages timeout behavior for MCP server requests
- * Implements MCP specification recommendations for handling long-running operations
- *
- * This class handles AI -> MCP level timeouts, separate from MCP -> AI (AgentExecutor) timeouts
- * Following MCP best practices:
- * - Progressive timeout with reset on progress
- * - Maximum absolute timeout enforcement
- * - Progress notifications for better UX
- * - Graceful cancellation support
- */
-class McpRequestTimeout {
-    /**
-     * Creates a new McpRequestTimeout instance
-     *
-     * @param config - Optional timeout configuration
-     * @param logger - Optional logger instance
-     */
-    constructor(config, logger) {
-        this.contexts = new Map();
-        this.config = { ...exports.DEFAULT_MCP_TIMEOUT_CONFIG, ...config };
-        this.logger = logger || new Logger_1.Logger(process.env['LOG_LEVEL'] || 'info');
-    }
-    /**
-     * Start timeout tracking for a request
-     *
-     * @param requestId - Unique request identifier
-     * @param onTimeout - Callback when timeout occurs
-     * @param onProgress - Optional callback for progress notifications
-     * @returns TimeoutContext for the request
-     */
-    startTimeout(requestId, onTimeout, onProgress) {
-        // Clear any existing timeout for this request
-        this.clearTimeout(requestId);
-        const context = {
-            requestId,
-            startTime: Date.now(),
-            currentTimeout: null,
-            warningTimeout: null,
-            maxTimeout: null,
-            progressCount: 0,
-            lastProgressTime: Date.now(),
-            isCompleted: false,
-            isCancelled: false,
-            onTimeout,
-            ...(onProgress && { onProgress }),
-        };
-        // Set warning timeout (for progress notification)
-        if (onProgress && this.config.warningThresholdMs > 0) {
-            context.warningTimeout = setTimeout(() => {
-                if (!context.isCompleted && !context.isCancelled) {
-                    this.sendProgressNotification(context, onProgress, 'Processing is taking longer than expected');
-                }
-            }, this.config.warningThresholdMs);
-        }
-        // Set default timeout
-        context.currentTimeout = setTimeout(() => {
-            if (!context.isCompleted && !context.isCancelled) {
-                this.handleTimeout(context, onTimeout);
-            }
-        }, this.config.defaultTimeoutMs);
-        // Set maximum absolute timeout (cannot be reset)
-        context.maxTimeout = setTimeout(() => {
-            if (!context.isCompleted && !context.isCancelled) {
-                this.logger.warn('Maximum timeout reached, forcing termination', {
-                    requestId,
-                    elapsedMs: Date.now() - context.startTime,
-                    maxTimeoutMs: this.config.maxTimeoutMs,
-                });
-                this.handleTimeout(context, onTimeout);
-            }
-        }, this.config.maxTimeoutMs);
-        this.contexts.set(requestId, context);
-        if (this.config.enableDebugLogging) {
-            this.logger.debug('Timeout tracking started', {
-                requestId,
-                defaultTimeoutMs: this.config.defaultTimeoutMs,
-                maxTimeoutMs: this.config.maxTimeoutMs,
-            });
-        }
-        return context;
-    }
-    /**
-     * Report progress and optionally reset timeout
-     * Following MCP specification: MAY reset timeout on progress, but enforce maximum
-     *
-     * @param requestId - Request identifier
-     * @param message - Progress message
-     * @param percentage - Optional completion percentage
-     */
-    reportProgress(requestId, message, percentage) {
-        const context = this.contexts.get(requestId);
-        if (!context || context.isCompleted || context.isCancelled) {
-            return;
-        }
-        context.progressCount++;
-        context.lastProgressTime = Date.now();
-        if (this.config.enableDebugLogging) {
-            this.logger.debug('Progress reported', {
-                requestId,
-                message,
-                percentage,
-                progressCount: context.progressCount,
-                elapsedMs: Date.now() - context.startTime,
-            });
-        }
-        // Reset timeout if enabled (but maximum timeout remains)
-        if (this.config.progressResetEnabled && context.currentTimeout) {
-            clearTimeout(context.currentTimeout);
-            // Calculate remaining time before max timeout
-            const elapsedMs = Date.now() - context.startTime;
-            const remainingMs = this.config.maxTimeoutMs - elapsedMs;
-            const newTimeoutMs = Math.min(this.config.defaultTimeoutMs, remainingMs);
-            if (newTimeoutMs > 0 && context.onTimeout) {
-                context.currentTimeout = setTimeout(() => {
-                    if (!context.isCompleted && !context.isCancelled) {
-                        this.handleTimeout(context, context.onTimeout);
-                    }
-                }, newTimeoutMs);
-                this.logger.info('Timeout reset due to progress', {
-                    requestId,
-                    newTimeoutMs,
-                    remainingBeforeMaxMs: remainingMs,
-                });
-            }
-        }
-    }
-    /**
-     * Mark request as completed and clear timeouts
-     *
-     * @param requestId - Request identifier
-     */
-    complete(requestId) {
-        const context = this.contexts.get(requestId);
-        if (!context) {
-            return;
-        }
-        context.isCompleted = true;
-        this.clearTimeouts(context);
-        const totalTime = Date.now() - context.startTime;
-        this.logger.info('Request completed within timeout', {
-            requestId,
-            totalTimeMs: totalTime,
-            progressCount: context.progressCount,
-        });
-        this.contexts.delete(requestId);
-    }
-    /**
-     * Cancel request and clear timeouts
-     * Following MCP specification for cancellation
-     *
-     * @param requestId - Request identifier
-     * @param reason - Cancellation reason
-     */
-    cancel(requestId, reason) {
-        const context = this.contexts.get(requestId);
-        if (!context) {
-            return;
-        }
-        context.isCancelled = true;
-        this.clearTimeouts(context);
-        this.logger.info('Request cancelled', {
-            requestId,
-            reason,
-            elapsedMs: Date.now() - context.startTime,
-        });
-        this.contexts.delete(requestId);
-    }
-    /**
-     * Clear timeout for a request
-     *
-     * @param requestId - Request identifier
-     */
-    clearTimeout(requestId) {
-        const context = this.contexts.get(requestId);
-        if (context) {
-            this.clearTimeouts(context);
-            this.contexts.delete(requestId);
-        }
-    }
-    /**
-     * Check if request has timed out
-     *
-     * @param requestId - Request identifier
-     * @returns true if timed out
-     */
-    hasTimedOut(requestId) {
-        const context = this.contexts.get(requestId);
-        if (!context) {
-            return false;
-        }
-        const elapsedMs = Date.now() - context.startTime;
-        return elapsedMs >= this.config.maxTimeoutMs;
-    }
-    /**
-     * Get timeout statistics for monitoring
-     *
-     * @returns Current timeout statistics
-     */
-    getStats() {
-        const activeContexts = Array.from(this.contexts.values()).filter((c) => !c.isCompleted && !c.isCancelled);
-        const now = Date.now();
-        const longestRunningMs = activeContexts.reduce((max, c) => Math.max(max, now - c.startTime), 0);
-        const averageProgressCount = activeContexts.length > 0
-            ? activeContexts.reduce((sum, c) => sum + c.progressCount, 0) / activeContexts.length
-            : 0;
-        return {
-            activeRequests: activeContexts.length,
-            averageProgressCount,
-            longestRunningMs,
-        };
-    }
-    /**
-     * Handle timeout event
-     *
-     * @private
-     */
-    handleTimeout(context, onTimeout) {
-        const elapsedMs = Date.now() - context.startTime;
-        this.logger.warn('Request timeout occurred', {
-            requestId: context.requestId,
-            elapsedMs,
-            progressCount: context.progressCount,
-            lastProgressMs: Date.now() - context.lastProgressTime,
-        });
-        onTimeout(context);
-        this.clearTimeouts(context);
-    }
-    /**
-     * Send progress notification
-     *
-     * @private
-     */
-    sendProgressNotification(context, onProgress, message) {
-        const notification = {
-            requestId: context.requestId,
-            message,
-            timestamp: Date.now(),
-        };
-        onProgress(notification);
-    }
-    /**
-     * Clear all timeouts for a context
-     *
-     * @private
-     */
-    clearTimeouts(context) {
-        if (context.currentTimeout) {
-            clearTimeout(context.currentTimeout);
-            context.currentTimeout = null;
-        }
-        if (context.warningTimeout) {
-            clearTimeout(context.warningTimeout);
-            context.warningTimeout = null;
-        }
-        if (context.maxTimeout) {
-            clearTimeout(context.maxTimeout);
-            context.maxTimeout = null;
-        }
-    }
-}
-exports.McpRequestTimeout = McpRequestTimeout;
-//# sourceMappingURL=McpRequestTimeout.js.map

package/dist/execution/McpRequestTimeout.js.map

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

package/dist/execution/PromptController.d.ts

@@ -1,92 +0,0 @@
-import type { ExecutionParams } from '../types/ExecutionParams';
-/**
- * Configuration options for recursion prevention warnings.
- * Allows customization of warning messages and formatting.
- */
-export interface RecursionWarningConfig {
-    /**
-     * The warning message template to add to prompts.
-     * Should contain clear instructions to prevent recursion.
-     */
-    warningTemplate: string;
-    /**
-     * Whether to format the warning with visual separators.
-     * Defaults to true for better readability.
-     */
-    useFormatting: boolean;
-}
-/**
- * Default configuration for recursion prevention warnings.
- * Uses clear English instructions to prevent sub-agents-mcp MCP tool usage.
- */
-export declare const DEFAULT_RECURSION_WARNING_CONFIG: RecursionWarningConfig;
-/**
- * Controller class for enhancing prompts with recursion prevention instructions.
- * Implements the security strategy defined in ADR-0001 for preventing infinite loops
- * in agent-to-agent communication through prompt control.
- */
-export declare class PromptController {
-    private readonly config;
-    /**
-     * Creates a new PromptController instance.
-     *
-     * @param config - Optional configuration for recursion warning behavior
-     */
-    constructor(config?: RecursionWarningConfig);
-    /**
-     * Adds recursion prevention warning to a prompt string.
-     *
-     * This method implements the prompt control strategy defined in ADR-0001
-     * to prevent infinite loops in agent-to-agent communication. It preserves
-     * the original prompt content while adding clear security instructions
-     * that explicitly prohibit the use of sub-agents-mcp MCP tools.
-     *
-     * @param originalPrompt - The original user prompt to enhance
-     * @returns Enhanced prompt with recursion prevention instructions appended
-     * @throws {Error} When originalPrompt is empty or contains only whitespace
-     *
-     * @example
-     * ```typescript
-     * const controller = new PromptController()
-     * const enhanced = controller.addRecursionWarning("Help me debug this code")
-     * console.log(enhanced)
-     * // Output: "Help me debug this code\n============...===========\nIMPORTANT RECURSION PREVENTION INSTRUCTIONS:\n- Do NOT use sub-agents-mcp MCP tools..."
-     * ```
-     */
-    addRecursionWarning(originalPrompt: string): string;
-    /**
-     * Formats the warning message according to the current configuration.
-     *
-     * @private
-     * @returns Formatted warning message with or without visual separators
-     */
-    private formatWarningMessage;
-    /**
-     * Enhances ExecutionParams by adding recursion prevention to the prompt field.
-     *
-     * This method is the primary interface for integrating prompt enhancement
-     * into the agent execution pipeline. It creates a new ExecutionParams object
-     * with an enhanced prompt while preserving all other execution parameters.
-     * The enhanced prompt includes ADR-0001 compliant security instructions.
-     *
-     * @param params - Original execution parameters to enhance
-     * @returns New ExecutionParams object with enhanced prompt field
-     * @throws {Error} When params is invalid or prompt enhancement fails
-     *
-     * @example
-     * ```typescript
-     * const controller = new PromptController()
-     * const original = {
-     *   agent: "code-helper",
-     *   prompt: "Fix this bug",
-     *   cwd: "/project",
-     *   extra_args: ["--verbose"]
-     * }
-     * const enhanced = controller.enhanceExecutionParams(original)
-     * console.log(enhanced.prompt) // Original prompt + recursion prevention
-     * console.log(enhanced.agent)  // "code-helper" (unchanged)
-     * ```
-     */
-    enhanceExecutionParams(params: ExecutionParams): ExecutionParams;
-}
-//# sourceMappingURL=PromptController.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"PromptController.d.ts","sourceRoot":"","sources":["../../src/execution/PromptController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAA;IAEvB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAA;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,sBAS9C,CAAA;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAE/C;;;;OAIG;gBACS,MAAM,GAAE,sBAAyD;IAI7E;;;;;;;;;;;;;;;;;;;OAmBG;IACH,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAiBnD;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe;CA6BjE"}

package/dist/execution/PromptController.js

@@ -1,130 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PromptController = exports.DEFAULT_RECURSION_WARNING_CONFIG = void 0;
-/**
- * Default configuration for recursion prevention warnings.
- * Uses clear English instructions to prevent sub-agents-mcp MCP tool usage.
- */
-exports.DEFAULT_RECURSION_WARNING_CONFIG = {
-    warningTemplate: `
-IMPORTANT RECURSION PREVENTION INSTRUCTIONS:
-- Do NOT use sub-agents-mcp MCP tools in your response
-- Complete this task within the current agent context only
-- Do not attempt to call other agents or sub-agents
-- Focus on direct implementation and solution delivery
-`,
-    useFormatting: true,
-};
-/**
- * Controller class for enhancing prompts with recursion prevention instructions.
- * Implements the security strategy defined in ADR-0001 for preventing infinite loops
- * in agent-to-agent communication through prompt control.
- */
-class PromptController {
-    /**
-     * Creates a new PromptController instance.
-     *
-     * @param config - Optional configuration for recursion warning behavior
-     */
-    constructor(config = exports.DEFAULT_RECURSION_WARNING_CONFIG) {
-        this.config = config;
-    }
-    /**
-     * Adds recursion prevention warning to a prompt string.
-     *
-     * This method implements the prompt control strategy defined in ADR-0001
-     * to prevent infinite loops in agent-to-agent communication. It preserves
-     * the original prompt content while adding clear security instructions
-     * that explicitly prohibit the use of sub-agents-mcp MCP tools.
-     *
-     * @param originalPrompt - The original user prompt to enhance
-     * @returns Enhanced prompt with recursion prevention instructions appended
-     * @throws {Error} When originalPrompt is empty or contains only whitespace
-     *
-     * @example
-     * ```typescript
-     * const controller = new PromptController()
-     * const enhanced = controller.addRecursionWarning("Help me debug this code")
-     * console.log(enhanced)
-     * // Output: "Help me debug this code\n============...===========\nIMPORTANT RECURSION PREVENTION INSTRUCTIONS:\n- Do NOT use sub-agents-mcp MCP tools..."
-     * ```
-     */
-    addRecursionWarning(originalPrompt) {
-        // Input validation: ensure prompt is not empty or whitespace-only
-        if (typeof originalPrompt !== 'string') {
-            throw new Error('Original prompt must be a string');
-        }
-        if (originalPrompt.trim().length === 0) {
-            throw new Error('Original prompt cannot be empty');
-        }
-        // Format warning based on configuration
-        const warning = this.formatWarningMessage();
-        // Concatenate original prompt with warning
-        return `${originalPrompt}${warning}`;
-    }
-    /**
-     * Formats the warning message according to the current configuration.
-     *
-     * @private
-     * @returns Formatted warning message with or without visual separators
-     */
-    formatWarningMessage() {
-        if (this.config.useFormatting) {
-            const separator = '='.repeat(60);
-            return `\n${separator}\n${this.config.warningTemplate}\n${separator}\n`;
-        }
-        return this.config.warningTemplate;
-    }
-    /**
-     * Enhances ExecutionParams by adding recursion prevention to the prompt field.
-     *
-     * This method is the primary interface for integrating prompt enhancement
-     * into the agent execution pipeline. It creates a new ExecutionParams object
-     * with an enhanced prompt while preserving all other execution parameters.
-     * The enhanced prompt includes ADR-0001 compliant security instructions.
-     *
-     * @param params - Original execution parameters to enhance
-     * @returns New ExecutionParams object with enhanced prompt field
-     * @throws {Error} When params is invalid or prompt enhancement fails
-     *
-     * @example
-     * ```typescript
-     * const controller = new PromptController()
-     * const original = {
-     *   agent: "code-helper",
-     *   prompt: "Fix this bug",
-     *   cwd: "/project",
-     *   extra_args: ["--verbose"]
-     * }
-     * const enhanced = controller.enhanceExecutionParams(original)
-     * console.log(enhanced.prompt) // Original prompt + recursion prevention
-     * console.log(enhanced.agent)  // "code-helper" (unchanged)
-     * ```
-     */
-    enhanceExecutionParams(params) {
-        // Input validation: ensure params is valid ExecutionParams object
-        if (!params || typeof params !== 'object') {
-            throw new Error('ExecutionParams must be a valid object');
-        }
-        if (!params.agent || typeof params.agent !== 'string') {
-            throw new Error('ExecutionParams must have a valid agent field');
-        }
-        if (!params.prompt || typeof params.prompt !== 'string') {
-            throw new Error('ExecutionParams must have a valid prompt field');
-        }
-        try {
-            // Enhance the prompt with recursion prevention instructions
-            const enhancedPrompt = this.addRecursionWarning(params.prompt);
-            // Return new object with enhanced prompt, preserving all other fields
-            return {
-                ...params,
-                prompt: enhancedPrompt,
-            };
-        }
-        catch (error) {
-            throw new Error(`Failed to enhance execution parameters: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-    }
-}
-exports.PromptController = PromptController;
-//# sourceMappingURL=PromptController.js.map

package/dist/execution/PromptController.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PromptController.js","sourceRoot":"","sources":["../../src/execution/PromptController.ts"],"names":[],"mappings":";;;AAoBA;;;GAGG;AACU,QAAA,gCAAgC,GAA2B;IACtE,eAAe,EAAE;;;;;;CAMlB;IACC,aAAa,EAAE,IAAI;CACpB,CAAA;AAED;;;;GAIG;AACH,MAAa,gBAAgB;IAG3B;;;;OAIG;IACH,YAAY,SAAiC,wCAAgC;QAC3E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,mBAAmB,CAAC,cAAsB;QACxC,kEAAkE;QAClE,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;QACrD,CAAC;QAED,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;QACpD,CAAC;QAED,wCAAwC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAA;QAE3C,2CAA2C;QAC3C,OAAO,GAAG,cAAc,GAAG,OAAO,EAAE,CAAA;IACtC,CAAC;IAED;;;;;OAKG;IACK,oBAAoB;QAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAChC,OAAO,KAAK,SAAS,KAAK,IAAI,CAAC,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,CAAA;QACzE,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAA;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,sBAAsB,CAAC,MAAuB;QAC5C,kEAAkE;QAClE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;QAC3D,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAClE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;QACnE,CAAC;QAED,IAAI,CAAC;YACH,4DAA4D;YAC5D,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YAE9D,sEAAsE;YACtE,OAAO;gBACL,GAAG,MAAM;gBACT,MAAM,EAAE,cAAc;aACvB,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,2CAA2C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CACtG,CAAA;QACH,CAAC;IACH,CAAC;CACF;AAvHD,4CAuHC"}

package/dist/execution/TimeoutManager.d.ts

@@ -1,159 +0,0 @@
-/**
- * Timeout management for agent execution with configurable limits and cleanup.
- *
- * Provides timeout enforcement with warning mechanisms, graceful cleanup,
- * and integration with agent execution processes.
- */
-/**
- * Configuration interface for timeout management.
- */
-export interface TimeoutConfig {
-    /** Default timeout in milliseconds (default: 30000) */
-    defaultTimeoutMs: number;
-    /** Warning threshold as percentage of timeout (default: 0.8 for 80%) */
-    warningThresholdPercent: number;
-    /** Enable timeout warnings (default: true) */
-    enableWarnings: boolean;
-    /** Grace period for cleanup in milliseconds (default: 5000) */
-    cleanupGracePeriodMs: number;
-}
-/**
- * Timeout execution context for tracking active operations.
- */
-export interface TimeoutContext {
-    /** Unique identifier for the operation */
-    operationId: string;
-    /** Start time of the operation */
-    startTime: Date;
-    /** Timeout duration in milliseconds */
-    timeoutMs: number;
-    /** Warning callback function */
-    onWarning?: (remainingMs: number) => void;
-    /** Cleanup callback function */
-    onCleanup?: () => Promise<void>;
-}
-/**
- * Default timeout configuration.
- */
-export declare const DEFAULT_TIMEOUT_CONFIG: TimeoutConfig;
-/**
- * Timeout manager for execution time monitoring and enforcement.
- *
- * Manages timeout enforcement with configurable limits, warning mechanisms,
- * and graceful cleanup for agent execution processes.
- */
-export declare class TimeoutManager {
-    private readonly config;
-    private readonly activeTimeouts;
-    /**
-     * Creates a new TimeoutManager instance.
-     *
-     * @param config - Timeout configuration (uses defaults if not provided)
-     */
-    constructor(config?: Partial<TimeoutConfig>);
-    /**
-     * 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: TimeoutContext): string;
-    /**
-     * Clears timeout monitoring for an operation.
-     *
-     * @param operationId - Operation ID to clear
-     * @returns True if timeout was cleared, false if not found
-     */
-    clearTimeout(operationId: string): boolean;
-    /**
-     * 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: string): number | null;
-    /**
-     * 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: string): number | null;
-    /**
-     * Checks if an operation is currently being tracked.
-     *
-     * @param operationId - Operation ID to check
-     * @returns True if operation is being tracked
-     */
-    isActive(operationId: string): boolean;
-    /**
-     * Gets all active operation IDs.
-     *
-     * @returns Array of active operation IDs
-     */
-    getActiveOperations(): string[];
-    /**
-     * 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: string, timeoutMs?: number, options?: {
-        onWarning?: (remainingMs: number) => void;
-        onCleanup?: () => Promise<void>;
-    }): TimeoutContext;
-    /**
-     * Gets the current configuration.
-     *
-     * @returns Timeout configuration
-     */
-    getConfig(): TimeoutConfig;
-    /**
-     * Clears all active timeouts.
-     *
-     * @returns Number of timeouts cleared
-     */
-    clearAllTimeouts(): number;
-    /**
-     * Gets timeout statistics for monitoring and optimization.
-     *
-     * @returns Timeout statistics
-     */
-    getTimeoutStats(): {
-        activeOperations: number;
-        totalOperationsStarted: number;
-        averageCompletionTime: number;
-        timeoutRate: number;
-    };
-    /**
-     * 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?: string): number;
-    /**
-     * Updates timeout statistics.
-     *
-     * @param operationId - Operation that completed/timed out
-     * @param completed - Whether operation completed successfully
-     * @private
-     */
-    private updateStats;
-    /**
-     * Handles timeout event with cleanup and error throwing.
-     *
-     * @param context - Timeout context
-     * @private
-     */
-    private handleTimeout;
-    /**
-     * Statistics tracking for timeout optimization.
-     * @private
-     */
-    private stats;
-}
-//# sourceMappingURL=TimeoutManager.d.ts.map