dartmind 17.0.0

package/dist/mcp/MCPRecovery.js

@@ -0,0 +1,357 @@
+/**
+ * FlutterAI V16 - MCP Recovery
+ * Issue 16.2: MCP Server Recovery
+ *
+ * Automatic recovery when MCP servers fail:
+ * - Retry with exponential backoff
+ * - Fallback to alternative servers
+ * - Queue calls during recovery
+ * - Track recovery statistics
+ *
+ * @module mcp/MCPRecovery
+ * @version 16.0.0
+ */
+import { EventEmitter } from 'events';
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_CONFIG = {
+    maxRetries: 3,
+    retryDelayMs: 1000,
+    backoffMultiplier: 2,
+    maxRetryDelayMs: 30000,
+    queueTimeoutMs: 60000,
+    fallbackServers: {},
+    autoRecover: true,
+};
+// ============================================================================
+// MCPRecovery Class
+// ============================================================================
+export class MCPRecovery extends EventEmitter {
+    config;
+    healthChecker;
+    recoveryHistory = [];
+    activeRecoveries = new Map();
+    queuedCalls = new Map();
+    actionCounter = 0;
+    // Stats
+    totalRecoveries = 0;
+    successfulRecoveries = 0;
+    failedRecoveries = 0;
+    constructor(healthChecker, config) {
+        super();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.healthChecker = healthChecker;
+        // Monitor health changes if auto-recover is enabled
+        if (this.config.autoRecover) {
+            this.healthChecker.on('server-unhealthy', ({ server }) => {
+                this.initiateRecovery(server.serverId);
+            });
+            this.healthChecker.on('unhealthy-servers', ({ unhealthy }) => {
+                for (const server of unhealthy) {
+                    this.initiateRecovery(server.serverId);
+                }
+            });
+        }
+    }
+    /**
+     * Initiate recovery for a server
+     */
+    async initiateRecovery(serverId) {
+        // Check if already recovering this server
+        const existingRecovery = this.activeRecoveries.get(serverId);
+        if (existingRecovery) {
+            return existingRecovery;
+        }
+        this.totalRecoveries++;
+        const recoveryPromise = this.performRecovery(serverId);
+        this.activeRecoveries.set(serverId, recoveryPromise);
+        try {
+            const result = await recoveryPromise;
+            return result;
+        }
+        finally {
+            this.activeRecoveries.delete(serverId);
+        }
+    }
+    /**
+     * Perform recovery with retry and fallback
+     */
+    async performRecovery(serverId) {
+        const startTime = Date.now();
+        this.emit('recovery-start', { serverId });
+        let retryCount = 0;
+        let delay = this.config.retryDelayMs;
+        // Strategy 1: Retry with exponential backoff
+        while (retryCount < this.config.maxRetries) {
+            const restartResult = await this.tryRestart(serverId);
+            if (restartResult) {
+                this.recordAction(serverId, 'restart', true, retryCount, Date.now() - startTime);
+                this.successfulRecoveries++;
+                this.processQueue(serverId, true);
+                this.emit('recovery-success', { serverId, strategy: 'restart', retries: retryCount });
+                return true;
+            }
+            retryCount++;
+            if (retryCount < this.config.maxRetries) {
+                // Wait before next retry
+                await this.delay(delay);
+                delay = Math.min(delay * this.config.backoffMultiplier, this.config.maxRetryDelayMs);
+            }
+        }
+        // Strategy 2: Try fallback server
+        const fallbackId = this.config.fallbackServers[serverId];
+        if (fallbackId) {
+            const fallbackHealth = await this.healthChecker.checkServer(fallbackId);
+            if (fallbackHealth.healthy) {
+                this.recordAction(serverId, 'fallback', true, retryCount, Date.now() - startTime);
+                this.successfulRecoveries++;
+                this.emit('fallback-activated', {
+                    original: serverId,
+                    fallback: fallbackId,
+                });
+                this.processQueue(serverId, true, fallbackId);
+                return true;
+            }
+        }
+        // Recovery failed
+        this.recordAction(serverId, 'fail', false, retryCount, Date.now() - startTime);
+        this.failedRecoveries++;
+        this.processQueue(serverId, false);
+        this.emit('recovery-failed', { serverId, retries: retryCount });
+        return false;
+    }
+    /**
+     * Try to restart a server
+     */
+    async tryRestart(serverId) {
+        // In a real implementation, this would:
+        // 1. Send a restart signal to the MCP server process
+        // 2. Wait for it to come back up
+        // 3. Verify health
+        // For now, just check health after a brief delay
+        await this.delay(500);
+        const health = await this.healthChecker.checkServer(serverId);
+        return health.healthy;
+    }
+    /**
+     * Queue a call while server is recovering
+     */
+    async queueCall(serverId, toolName, args, timeoutMs) {
+        const timeout = timeoutMs ?? this.config.queueTimeoutMs;
+        return new Promise((resolve, reject) => {
+            const callId = `queue_${++this.actionCounter}_${Date.now()}`;
+            const timeoutHandle = setTimeout(() => {
+                // Remove from queue on timeout
+                this.removeFromQueue(serverId, callId);
+                reject(new Error(`Queue timeout for server ${serverId} after ${timeout}ms`));
+            }, timeout);
+            const queuedCall = {
+                id: callId,
+                serverId,
+                toolName,
+                arguments: args,
+                queuedAt: new Date(),
+                timeout: timeoutHandle,
+                resolve,
+                reject,
+            };
+            // Add to queue
+            if (!this.queuedCalls.has(serverId)) {
+                this.queuedCalls.set(serverId, []);
+            }
+            this.queuedCalls.get(serverId).push(queuedCall);
+            this.emit('call-queued', { serverId, callId, toolName });
+        });
+    }
+    /**
+     * Process queued calls after recovery
+     */
+    processQueue(serverId, success, redirectTo) {
+        const queue = this.queuedCalls.get(serverId);
+        if (!queue || queue.length === 0)
+            return;
+        this.emit('queue-processing', {
+            serverId,
+            queueLength: queue.length,
+            success,
+            redirectTo,
+        });
+        for (const call of queue) {
+            clearTimeout(call.timeout);
+            if (success) {
+                call.resolve(true);
+            }
+            else {
+                call.reject(new Error(`Server ${serverId} recovery failed`));
+            }
+        }
+        this.queuedCalls.delete(serverId);
+    }
+    /**
+     * Remove a specific call from queue
+     */
+    removeFromQueue(serverId, callId) {
+        const queue = this.queuedCalls.get(serverId);
+        if (!queue)
+            return;
+        const index = queue.findIndex((c) => c.id === callId);
+        if (index !== -1) {
+            queue.splice(index, 1);
+        }
+        if (queue.length === 0) {
+            this.queuedCalls.delete(serverId);
+        }
+    }
+    /**
+     * Record recovery action
+     */
+    recordAction(serverId, strategy, success, retryCount, durationMs, error) {
+        const action = {
+            id: `action_${++this.actionCounter}`,
+            serverId,
+            strategy,
+            timestamp: new Date(),
+            success,
+            error,
+            retryCount,
+            durationMs,
+        };
+        this.recoveryHistory.push(action);
+        this.emit('recovery-action', action);
+        // Keep last 100 actions
+        if (this.recoveryHistory.length > 100) {
+            this.recoveryHistory.shift();
+        }
+    }
+    // ==========================================================================
+    // Configuration
+    // ==========================================================================
+    /**
+     * Set fallback server mapping
+     */
+    setFallback(serverId, fallbackId) {
+        this.config.fallbackServers[serverId] = fallbackId;
+    }
+    /**
+     * Remove fallback mapping
+     */
+    removeFallback(serverId) {
+        delete this.config.fallbackServers[serverId];
+    }
+    /**
+     * Get current fallback mappings
+     */
+    getFallbacks() {
+        return { ...this.config.fallbackServers };
+    }
+    // ==========================================================================
+    // Status & Statistics
+    // ==========================================================================
+    /**
+     * Check if server is currently recovering
+     */
+    isRecovering(serverId) {
+        return this.activeRecoveries.has(serverId);
+    }
+    /**
+     * Get all servers currently recovering
+     */
+    getRecoveringServers() {
+        return Array.from(this.activeRecoveries.keys());
+    }
+    /**
+     * Get queued calls for a server
+     */
+    getQueuedCalls(serverId) {
+        return this.queuedCalls.get(serverId)?.length || 0;
+    }
+    /**
+     * Get total queued calls
+     */
+    getTotalQueuedCalls() {
+        let total = 0;
+        for (const queue of this.queuedCalls.values()) {
+            total += queue.length;
+        }
+        return total;
+    }
+    /**
+     * Get recovery history
+     */
+    getHistory() {
+        return [...this.recoveryHistory];
+    }
+    /**
+     * Get recovery statistics
+     */
+    getStats() {
+        const byStrategy = {
+            restart: 0,
+            fallback: 0,
+            queue: 0,
+            fail: 0,
+        };
+        let totalRetries = 0;
+        let totalDuration = 0;
+        for (const action of this.recoveryHistory) {
+            byStrategy[action.strategy]++;
+            totalRetries += action.retryCount;
+            totalDuration += action.durationMs;
+        }
+        const historyCount = this.recoveryHistory.length;
+        return {
+            totalRecoveries: this.totalRecoveries,
+            successfulRecoveries: this.successfulRecoveries,
+            failedRecoveries: this.failedRecoveries,
+            successRate: this.totalRecoveries > 0 ? this.successfulRecoveries / this.totalRecoveries : 0,
+            averageRetries: historyCount > 0 ? totalRetries / historyCount : 0,
+            averageDurationMs: historyCount > 0 ? totalDuration / historyCount : 0,
+            byStrategy,
+            activeRecoveries: this.activeRecoveries.size,
+            queuedCalls: this.getTotalQueuedCalls(),
+        };
+    }
+    /**
+     * Get health status
+     */
+    getHealth() {
+        const stats = this.getStats();
+        const healthy = stats.successRate >= 0.5 || stats.totalRecoveries < 3;
+        return {
+            healthy,
+            message: healthy
+                ? `MCPRecovery healthy: ${stats.successfulRecoveries}/${stats.totalRecoveries} recoveries succeeded`
+                : `MCPRecovery degraded: ${stats.failedRecoveries} failures, ${stats.activeRecoveries} active`,
+        };
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.totalRecoveries = 0;
+        this.successfulRecoveries = 0;
+        this.failedRecoveries = 0;
+        this.recoveryHistory = [];
+    }
+    /**
+     * Utility delay function
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create MCPRecovery with standard configuration
+ */
+export function createMCPRecovery(healthChecker, config) {
+    return new MCPRecovery(healthChecker, config);
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export default MCPRecovery;
+//# sourceMappingURL=MCPRecovery.js.map

package/dist/mcp/MCPRecovery.js.map

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

package/dist/mcp/ToolOrchestrator.d.ts

@@ -0,0 +1,129 @@
+/**
+ * FlutterAI V16 - Tool Orchestrator
+ * Issue 8.2: Tool Discovery + Registration
+ *
+ * Orchestrates tool discovery, planning, and execution:
+ * - Keyword-based tool discovery
+ * - Dependency-aware execution planning
+ * - Parallel execution within dependency levels
+ * - Execution history tracking
+ *
+ * @module mcp/ToolOrchestrator
+ * @version 16.0.0
+ */
+import { EventEmitter } from 'events';
+import { V16MCPBridge, MCPTool, MCPToolResult } from './V16MCPBridge.js';
+export interface ToolStep {
+    /** Step index */
+    index: number;
+    /** Tool to execute */
+    toolName: string;
+    /** Arguments for the tool */
+    arguments: Record<string, unknown>;
+    /** Step dependencies (indices) */
+    dependsOn?: number[];
+    /** Human-readable description */
+    description: string;
+    /** Estimated duration */
+    estimatedMs?: number;
+}
+export interface ToolExecutionPlan {
+    /** Plan ID */
+    id: string;
+    /** Steps to execute */
+    steps: ToolStep[];
+    /** Total estimated duration */
+    estimatedDurationMs: number;
+    /** Whether plan requires user confirmation */
+    requiresConfirmation: boolean;
+    /** Reason for confirmation requirement */
+    confirmationReason?: string;
+    /** Task description */
+    task: string;
+    /** Created timestamp */
+    createdAt: Date;
+}
+export interface StepResult {
+    /** Step executed */
+    step: ToolStep;
+    /** Tool result */
+    result: MCPToolResult;
+    /** Whether step was skipped */
+    skipped: boolean;
+    /** Skip reason if skipped */
+    skipReason?: string;
+}
+export interface ToolExecutionResult {
+    /** Plan ID */
+    planId: string;
+    /** Whether plan executed successfully */
+    success: boolean;
+    /** Step results */
+    stepResults: StepResult[];
+    /** Total execution time */
+    totalDurationMs: number;
+    /** Failed step indices */
+    failedSteps: number[];
+    /** Skipped step indices */
+    skippedSteps: number[];
+    /** Completed timestamp */
+    completedAt: Date;
+}
+export interface ToolOrchestratorConfig {
+    /** Maximum steps per plan */
+    maxStepsPerPlan?: number;
+    /** Default step timeout */
+    defaultStepTimeoutMs?: number;
+    /** Require confirmation for dangerous tools */
+    requireDangerousConfirmation?: boolean;
+}
+export declare class ToolOrchestrator extends EventEmitter {
+    private bridge;
+    private config;
+    private executionHistory;
+    constructor(bridge: V16MCPBridge, config?: ToolOrchestratorConfig);
+    /**
+     * Discover relevant tools for a task description
+     */
+    discoverTools(taskDescription: string): MCPTool[];
+    /**
+     * Create an execution plan for a task
+     */
+    createPlan(task: string, tools: MCPTool[], context?: Record<string, unknown>): ToolExecutionPlan;
+    /**
+     * Execute a plan
+     */
+    executePlan(plan: ToolExecutionPlan, onStepComplete?: (step: ToolStep, result: MCPToolResult) => void): Promise<ToolExecutionResult>;
+    /**
+     * Group steps by dependency level for parallel execution
+     */
+    private groupByDependencyLevel;
+    /**
+     * Quick execute: discover, plan, and execute in one call
+     */
+    quickExecute(task: string, context?: Record<string, unknown>): Promise<ToolExecutionResult>;
+    /**
+     * Get execution history
+     */
+    getHistory(): typeof this.executionHistory;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        totalExecutions: number;
+        successfulExecutions: number;
+        avgDurationMs: number;
+        totalSteps: number;
+        avgStepsPerPlan: number;
+    };
+    /**
+     * Clear history
+     */
+    clearHistory(): void;
+}
+/**
+ * Create ToolOrchestrator with standard configuration
+ */
+export declare function createToolOrchestrator(bridge: V16MCPBridge, config?: ToolOrchestratorConfig): ToolOrchestrator;
+export default ToolOrchestrator;
+//# sourceMappingURL=ToolOrchestrator.d.ts.map

package/dist/mcp/ToolOrchestrator.d.ts.map

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