claude-flow-novice 1.0.0

package/dist/src/mcp/recovery/reconnection-manager.js

@@ -0,0 +1,219 @@
+/**
+ * Reconnection Manager for MCP
+ * Handles automatic reconnection with exponential backoff
+ */ import { EventEmitter } from 'node:events';
+export class ReconnectionManager extends EventEmitter {
+    client;
+    logger;
+    state;
+    reconnectTimer;
+    reconnectPromise;
+    defaultConfig = {
+        maxRetries: 10,
+        initialDelay: 1000,
+        maxDelay: 30000,
+        backoffMultiplier: 2,
+        jitterFactor: 0.1,
+        resetAfterSuccess: true
+    };
+    constructor(client, logger, config){
+        super(), this.client = client, this.logger = logger;
+        this.config = {
+            ...this.defaultConfig,
+            ...config
+        };
+        this.state = {
+            attempts: 0,
+            nextDelay: this.config.initialDelay,
+            isReconnecting: false
+        };
+    }
+    config;
+    /**
+   * Attempt to reconnect
+   */ async attemptReconnection() {
+        // Prevent concurrent reconnection attempts
+        if (this.reconnectPromise) {
+            this.logger.debug('Reconnection already in progress');
+            return this.reconnectPromise;
+        }
+        if (this.state.attempts >= this.config.maxRetries) {
+            this.logger.error('Max reconnection attempts exceeded');
+            this.emit('maxRetriesExceeded', this.state);
+            return false;
+        }
+        this.reconnectPromise = this.performReconnection();
+        const result = await this.reconnectPromise;
+        this.reconnectPromise = undefined;
+        return result;
+    }
+    /**
+   * Start automatic reconnection
+   */ startAutoReconnect() {
+        if (this.state.isReconnecting) {
+            this.logger.debug('Auto-reconnect already active');
+            return;
+        }
+        this.logger.info('Starting automatic reconnection');
+        this.state.isReconnecting = true;
+        this.emit('reconnectStart');
+        this.scheduleReconnect();
+    }
+    /**
+   * Stop reconnection attempts
+   */ stopReconnection() {
+        if (!this.state.isReconnecting) {
+            return;
+        }
+        this.logger.info('Stopping reconnection attempts');
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        this.state.isReconnecting = false;
+        this.emit('reconnectStop');
+    }
+    /**
+   * Reset reconnection state
+   */ reset() {
+        this.logger.debug('Resetting reconnection manager');
+        this.stopReconnection();
+        this.state = {
+            attempts: 0,
+            nextDelay: this.config.initialDelay,
+            isReconnecting: false
+        };
+    }
+    /**
+   * Get current reconnection state
+   */ getState() {
+        return {
+            ...this.state
+        };
+    }
+    /**
+   * Calculate next retry delay
+   */ getNextDelay() {
+        return this.state.nextDelay;
+    }
+    async performReconnection() {
+        this.state.attempts++;
+        this.state.lastAttempt = new Date();
+        this.logger.info('Attempting reconnection', {
+            attempt: this.state.attempts,
+            maxRetries: this.config.maxRetries,
+            delay: this.state.nextDelay
+        });
+        this.emit('attemptStart', {
+            attempt: this.state.attempts,
+            delay: this.state.nextDelay
+        });
+        try {
+            // Disconnect first if needed
+            if (this.client.isConnected()) {
+                await this.client.disconnect();
+            }
+            // Attempt to reconnect
+            await this.client.connect();
+            // Success!
+            this.logger.info('Reconnection successful', {
+                attempts: this.state.attempts
+            });
+            this.emit('success', {
+                attempts: this.state.attempts,
+                duration: Date.now() - this.state.lastAttempt.getTime()
+            });
+            // Reset state if configured
+            if (this.config.resetAfterSuccess) {
+                this.reset();
+            }
+            return true;
+        } catch (error) {
+            this.state.lastError = error;
+            this.logger.error('Reconnection failed', {
+                attempt: this.state.attempts,
+                error: error.message
+            });
+            this.emit('attemptFailed', {
+                attempt: this.state.attempts,
+                error: error
+            });
+            // Calculate next delay with exponential backoff
+            this.calculateNextDelay();
+            // Schedule next attempt if within retry limit
+            if (this.state.attempts < this.config.maxRetries && this.state.isReconnecting) {
+                this.scheduleReconnect();
+            } else if (this.state.attempts >= this.config.maxRetries) {
+                this.logger.error('Max reconnection attempts reached');
+                this.emit('maxRetriesExceeded', this.state);
+                this.state.isReconnecting = false;
+            }
+            return false;
+        }
+    }
+    scheduleReconnect() {
+        if (!this.state.isReconnecting) {
+            return;
+        }
+        const delay = this.addJitter(this.state.nextDelay);
+        this.logger.debug('Scheduling next reconnection attempt', {
+            delay,
+            baseDelay: this.state.nextDelay
+        });
+        this.reconnectTimer = setTimeout(()=>{
+            this.attemptReconnection().catch((error)=>{
+                this.logger.error('Scheduled reconnection error', error);
+            });
+        }, delay);
+        this.emit('attemptScheduled', {
+            attempt: this.state.attempts + 1,
+            delay
+        });
+    }
+    calculateNextDelay() {
+        // Exponential backoff calculation
+        const nextDelay = Math.min(this.state.nextDelay * this.config.backoffMultiplier, this.config.maxDelay);
+        this.state.nextDelay = nextDelay;
+        this.logger.debug('Calculated next delay', {
+            delay: nextDelay,
+            multiplier: this.config.backoffMultiplier,
+            maxDelay: this.config.maxDelay
+        });
+    }
+    addJitter(delay) {
+        // Add random jitter to prevent thundering herd
+        const jitter = delay * this.config.jitterFactor;
+        const randomJitter = (Math.random() - 0.5) * 2 * jitter;
+        return Math.max(0, delay + randomJitter);
+    }
+    /**
+   * Force immediate reconnection attempt
+   */ async forceReconnect() {
+        this.logger.info('Forcing immediate reconnection');
+        // Cancel any scheduled reconnect
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        // Reset delay for immediate attempt
+        const originalDelay = this.state.nextDelay;
+        this.state.nextDelay = 0;
+        const result = await this.attemptReconnection();
+        // Restore delay if failed
+        if (!result) {
+            this.state.nextDelay = originalDelay;
+        }
+        return result;
+    }
+    /**
+   * Get estimated time until next reconnection attempt
+   */ getTimeUntilNextAttempt() {
+        if (!this.state.isReconnecting || !this.reconnectTimer) {
+            return null;
+        }
+        // This is an approximation since we don't track the exact timer start
+        return this.state.nextDelay;
+    }
+}
+
+//# sourceMappingURL=reconnection-manager.js.map

package/dist/src/mcp/recovery/reconnection-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/recovery/reconnection-manager.ts"],"names":["EventEmitter","ReconnectionManager","state","reconnectTimer","reconnectPromise","defaultConfig","maxRetries","initialDelay","maxDelay","backoffMultiplier","jitterFactor","resetAfterSuccess","client","logger","config","attempts","nextDelay","isReconnecting","attemptReconnection","debug","error","emit","performReconnection","result","undefined","startAutoReconnect","info","scheduleReconnect","stopReconnection","clearTimeout","reset","getState","getNextDelay","lastAttempt","Date","attempt","delay","isConnected","disconnect","connect","duration","now","getTime","lastError","message","calculateNextDelay","addJitter","baseDelay","setTimeout","catch","Math","min","multiplier","jitter","randomJitter","random","max","forceReconnect","originalDelay","getTimeUntilNextAttempt"],"mappings":"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"}

package/dist/src/mcp/recovery/recovery-manager.js

@@ -0,0 +1,262 @@
+/**
+ * Recovery Manager for MCP
+ * Orchestrates all recovery components for comprehensive connection stability
+ */ import { EventEmitter } from 'node:events';
+import { ConnectionHealthMonitor } from './connection-health-monitor.js';
+import { ReconnectionManager } from './reconnection-manager.js';
+import { FallbackCoordinator } from './fallback-coordinator.js';
+import { ConnectionStateManager } from './connection-state-manager.js';
+export class RecoveryManager extends EventEmitter {
+    client;
+    mcpConfig;
+    logger;
+    healthMonitor;
+    reconnectionManager;
+    fallbackCoordinator;
+    stateManager;
+    isRecoveryActive = false;
+    recoveryStartTime;
+    metrics = {
+        totalRecoveries: 0,
+        successfulRecoveries: 0,
+        failedRecoveries: 0,
+        totalRecoveryTime: 0
+    };
+    constructor(client, mcpConfig, logger, config){
+        super(), this.client = client, this.mcpConfig = mcpConfig, this.logger = logger;
+        // Initialize components
+        this.healthMonitor = new ConnectionHealthMonitor(client, logger, config?.healthMonitor);
+        this.reconnectionManager = new ReconnectionManager(client, logger, config?.reconnection);
+        this.fallbackCoordinator = new FallbackCoordinator(logger, config?.fallback);
+        this.stateManager = new ConnectionStateManager(logger, config?.state);
+        // Set up component event handlers
+        this.setupEventHandlers();
+        this.logger.info('Recovery manager initialized');
+    }
+    /**
+   * Start recovery management
+   */ async start() {
+        this.logger.info('Starting recovery manager');
+        // Start health monitoring
+        await this.healthMonitor.start();
+        // Restore any previous state
+        const previousState = this.stateManager.restoreState();
+        if (previousState && previousState.pendingRequests.length > 0) {
+            this.logger.info('Restored previous connection state', {
+                sessionId: previousState.sessionId,
+                pendingRequests: previousState.pendingRequests.length
+            });
+            // Queue pending requests for retry
+            previousState.pendingRequests.forEach((request)=>{
+                this.fallbackCoordinator.queueOperation({
+                    type: 'tool',
+                    method: request.method,
+                    params: request.params,
+                    priority: 'high',
+                    retryable: true
+                });
+            });
+        }
+        this.emit('started');
+    }
+    /**
+   * Stop recovery management
+   */ async stop() {
+        this.logger.info('Stopping recovery manager');
+        // Stop all components
+        await this.healthMonitor.stop();
+        this.reconnectionManager.stopReconnection();
+        this.fallbackCoordinator.disableCLIFallback();
+        await this.stateManager.cleanup();
+        this.emit('stopped');
+    }
+    /**
+   * Get current recovery status
+   */ getStatus() {
+        const healthStatus = this.healthMonitor.getHealthStatus();
+        const reconnectionState = this.reconnectionManager.getState();
+        const fallbackState = this.fallbackCoordinator.getState();
+        return {
+            isRecoveryActive: this.isRecoveryActive,
+            connectionHealth: healthStatus,
+            reconnectionState: {
+                attempts: reconnectionState.attempts,
+                isReconnecting: reconnectionState.isReconnecting,
+                nextDelay: reconnectionState.nextDelay
+            },
+            fallbackState: {
+                isFallbackActive: fallbackState.isFallbackActive,
+                queuedOperations: fallbackState.queuedOperations
+            },
+            metrics: {
+                totalRecoveries: this.metrics.totalRecoveries,
+                successfulRecoveries: this.metrics.successfulRecoveries,
+                failedRecoveries: this.metrics.failedRecoveries,
+                averageRecoveryTime: this.metrics.totalRecoveries > 0 ? this.metrics.totalRecoveryTime / this.metrics.totalRecoveries : 0
+            }
+        };
+    }
+    /**
+   * Force a recovery attempt
+   */ async forceRecovery() {
+        this.logger.info('Forcing recovery attempt');
+        // Check if already recovering
+        if (this.isRecoveryActive) {
+            this.logger.warn('Recovery already in progress');
+            return false;
+        }
+        return this.startRecovery('manual');
+    }
+    /**
+   * Handle a request that needs recovery consideration
+   */ async handleRequest(request) {
+        // Add to pending requests if disconnected
+        if (!this.client.isConnected()) {
+            this.stateManager.addPendingRequest(request);
+            // Queue for fallback execution
+            this.fallbackCoordinator.queueOperation({
+                type: 'tool',
+                method: request.method,
+                params: request.params,
+                priority: 'medium',
+                retryable: true
+            });
+        }
+    }
+    setupEventHandlers() {
+        // Health monitor events
+        this.healthMonitor.on('connectionLost', async ({ error })=>{
+            this.logger.error('Connection lost, initiating recovery', error);
+            await this.startRecovery('health-check');
+        });
+        this.healthMonitor.on('healthChange', (newStatus, oldStatus)=>{
+            this.emit('healthChange', newStatus, oldStatus);
+            // Record state change
+            this.stateManager.recordEvent({
+                type: newStatus.healthy ? 'connect' : 'disconnect',
+                sessionId: this.generateSessionId(),
+                details: {
+                    health: newStatus
+                }
+            });
+        });
+        // Reconnection manager events
+        this.reconnectionManager.on('success', async ({ attempts, duration })=>{
+            this.logger.info('Reconnection successful', {
+                attempts,
+                duration
+            });
+            await this.completeRecovery(true);
+        });
+        this.reconnectionManager.on('maxRetriesExceeded', async ()=>{
+            this.logger.error('Max reconnection attempts exceeded');
+            await this.completeRecovery(false);
+        });
+        this.reconnectionManager.on('attemptFailed', ({ attempt, error })=>{
+            this.emit('recoveryAttemptFailed', {
+                attempt,
+                error
+            });
+        });
+        // Fallback coordinator events
+        this.fallbackCoordinator.on('fallbackEnabled', (state)=>{
+            this.logger.warn('Fallback mode activated', state);
+            this.emit('fallbackActivated', state);
+        });
+        this.fallbackCoordinator.on('replayOperation', async (operation)=>{
+            // Replay operation through MCP client
+            if (this.client.isConnected()) {
+                try {
+                    await this.client.request(operation.method, operation.params);
+                    this.stateManager.removePendingRequest(operation.id);
+                } catch (error) {
+                    this.logger.error('Failed to replay operation', {
+                        operation,
+                        error
+                    });
+                }
+            }
+        });
+    }
+    async startRecovery(trigger) {
+        if (this.isRecoveryActive) {
+            return false;
+        }
+        this.isRecoveryActive = true;
+        this.recoveryStartTime = new Date();
+        this.metrics.totalRecoveries++;
+        this.logger.info('Starting recovery process', {
+            trigger
+        });
+        this.emit('recoveryStart', {
+            trigger
+        });
+        // Save current state
+        this.stateManager.saveState({
+            sessionId: this.generateSessionId(),
+            lastConnected: new Date(),
+            pendingRequests: [],
+            configuration: this.mcpConfig,
+            metadata: {
+                trigger
+            }
+        });
+        // Enable fallback mode immediately
+        this.fallbackCoordinator.enableCLIFallback();
+        // Start reconnection attempts
+        this.reconnectionManager.startAutoReconnect();
+        return true;
+    }
+    async completeRecovery(success) {
+        if (!this.isRecoveryActive) {
+            return;
+        }
+        const duration = this.recoveryStartTime ? Date.now() - this.recoveryStartTime.getTime() : 0;
+        this.isRecoveryActive = false;
+        this.recoveryStartTime = undefined;
+        if (success) {
+            this.metrics.successfulRecoveries++;
+            this.metrics.totalRecoveryTime += duration;
+            // Disable fallback mode
+            this.fallbackCoordinator.disableCLIFallback();
+            // Process any queued operations
+            await this.fallbackCoordinator.processQueue();
+            // Reset health monitor
+            this.healthMonitor.reset();
+            // Record reconnection
+            this.stateManager.recordEvent({
+                type: 'reconnect',
+                sessionId: this.generateSessionId(),
+                details: {
+                    duration
+                }
+            });
+            this.logger.info('Recovery completed successfully', {
+                duration
+            });
+            this.emit('recoveryComplete', {
+                success: true,
+                duration
+            });
+        } else {
+            this.metrics.failedRecoveries++;
+            this.logger.error('Recovery failed');
+            this.emit('recoveryComplete', {
+                success: false,
+                duration
+            });
+            // Keep fallback active
+            this.emit('fallbackPermanent');
+        }
+    }
+    generateSessionId() {
+        return `recovery-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    }
+    /**
+   * Clean up resources
+   */ async cleanup() {
+        await this.stop();
+    }
+}
+
+//# sourceMappingURL=recovery-manager.js.map

package/dist/src/mcp/recovery/recovery-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/mcp/recovery/recovery-manager.ts"],"names":["EventEmitter","ConnectionHealthMonitor","ReconnectionManager","FallbackCoordinator","ConnectionStateManager","RecoveryManager","healthMonitor","reconnectionManager","fallbackCoordinator","stateManager","isRecoveryActive","recoveryStartTime","metrics","totalRecoveries","successfulRecoveries","failedRecoveries","totalRecoveryTime","client","mcpConfig","logger","config","reconnection","fallback","state","setupEventHandlers","info","start","previousState","restoreState","pendingRequests","length","sessionId","forEach","request","queueOperation","type","method","params","priority","retryable","emit","stop","stopReconnection","disableCLIFallback","cleanup","getStatus","healthStatus","getHealthStatus","reconnectionState","getState","fallbackState","connectionHealth","attempts","isReconnecting","nextDelay","isFallbackActive","queuedOperations","averageRecoveryTime","forceRecovery","warn","startRecovery","handleRequest","isConnected","addPendingRequest","on","error","newStatus","oldStatus","recordEvent","healthy","generateSessionId","details","health","duration","completeRecovery","attempt","operation","removePendingRequest","id","trigger","Date","saveState","lastConnected","configuration","metadata","enableCLIFallback","startAutoReconnect","success","now","getTime","undefined","processQueue","reset","Math","random","toString","slice"],"mappings":"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"}