@defai.digital/ax-cli 3.2.0 → 3.4.0

package/dist/mcp/health.js

@@ -0,0 +1,267 @@
+/**
+ * MCP Server Health Monitoring
+ *
+ * Provides health checking, status monitoring, and automatic reconnection
+ * for MCP servers.
+ */
+import { EventEmitter } from 'events';
+import { ReconnectionManager } from './reconnection.js';
+/**
+ * MCP Health Monitor
+ *
+ * Monitors the health of MCP servers and provides automatic reconnection
+ */
+export class MCPHealthMonitor extends EventEmitter {
+    mcpManager;
+    healthCheckInterval = null;
+    reconnectionManager;
+    serverStats = new Map();
+    constructor(mcpManager, reconnectionStrategy) {
+        super();
+        this.mcpManager = mcpManager;
+        this.reconnectionManager = new ReconnectionManager(reconnectionStrategy);
+        // Forward reconnection events
+        this.reconnectionManager.on('reconnection-scheduled', (data) => this.emit('reconnection-scheduled', data));
+        this.reconnectionManager.on('reconnection-attempt', (data) => this.emit('reconnection-attempt', data));
+        this.reconnectionManager.on('reconnection-success', (data) => this.emit('reconnection-success', data));
+        this.reconnectionManager.on('reconnection-failed', (data) => this.emit('reconnection-failed', data));
+        this.reconnectionManager.on('max-retries-reached', (data) => this.emit('max-retries-reached', data));
+    }
+    /**
+     * Start health monitoring with specified interval
+     */
+    start(intervalMs = 60000) {
+        if (this.healthCheckInterval) {
+            throw new Error('Health monitoring already started');
+        }
+        // Initialize stats for existing servers
+        const servers = this.mcpManager.getServers();
+        for (const serverName of servers) {
+            if (!this.serverStats.has(serverName)) {
+                this.serverStats.set(serverName, {
+                    connectedAt: Date.now(),
+                    successCount: 0,
+                    failureCount: 0,
+                    latencies: [],
+                });
+            }
+        }
+        this.healthCheckInterval = setInterval(async () => {
+            await this.performHealthChecks();
+        }, intervalMs);
+    }
+    /**
+     * Stop health monitoring
+     */
+    stop() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+        }
+    }
+    /**
+     * Perform health checks on all servers
+     */
+    async performHealthChecks() {
+        const servers = this.mcpManager.getServers();
+        for (const serverName of servers) {
+            try {
+                const health = await this.checkServerHealth(serverName);
+                this.emit('health-check', health);
+                // Check if server is unhealthy
+                if (!health.connected && health.successRate < 50) {
+                    this.emit('server-disconnected', serverName);
+                    // Note: Automatic reconnection disabled - config not available in health monitor
+                    // Reconnection should be handled externally via the reconnection manager
+                }
+            }
+            catch (error) {
+                this.emit('health-check-error', { serverName, error: error });
+            }
+        }
+    }
+    /**
+     * Check health of a specific server
+     */
+    async checkServerHealth(serverName) {
+        const tools = this.mcpManager.getTools().filter((t) => t.serverName === serverName);
+        // Initialize stats if not present
+        if (!this.serverStats.has(serverName)) {
+            this.serverStats.set(serverName, {
+                connectedAt: Date.now(),
+                successCount: 0,
+                failureCount: 0,
+                latencies: [],
+            });
+        }
+        const stats = this.serverStats.get(serverName);
+        // Calculate success rate
+        const total = stats.successCount + stats.failureCount;
+        const successRate = total > 0 ? (stats.successCount / total) * 100 : 100;
+        // Calculate latencies
+        const avgLatency = stats.latencies.length > 0
+            ? stats.latencies.reduce((a, b) => a + b, 0) / stats.latencies.length
+            : undefined;
+        const p95Latency = stats.latencies.length > 0
+            ? this.calculatePercentile(stats.latencies, 0.95)
+            : undefined;
+        // Calculate uptime
+        const uptime = Date.now() - stats.connectedAt;
+        return {
+            serverName,
+            connected: tools.length > 0,
+            toolCount: tools.length,
+            uptime,
+            connectedAt: stats.connectedAt,
+            lastSuccess: stats.lastSuccess,
+            lastError: stats.lastError,
+            lastErrorAt: stats.lastErrorAt,
+            successCount: stats.successCount,
+            failureCount: stats.failureCount,
+            avgLatency,
+            p95Latency,
+            successRate,
+        };
+    }
+    /**
+     * Record a successful tool call
+     */
+    recordSuccess(serverName, latencyMs) {
+        // Initialize stats if not present
+        if (!this.serverStats.has(serverName)) {
+            this.serverStats.set(serverName, {
+                connectedAt: Date.now(),
+                successCount: 0,
+                failureCount: 0,
+                latencies: [],
+            });
+        }
+        const stats = this.serverStats.get(serverName);
+        stats.successCount++;
+        stats.lastSuccess = Date.now();
+        stats.latencies.push(latencyMs);
+        // Keep only last 100 latencies
+        if (stats.latencies.length > 100) {
+            stats.latencies.shift();
+        }
+    }
+    /**
+     * Record a failed tool call
+     */
+    recordFailure(serverName, error) {
+        // Initialize stats if not present
+        if (!this.serverStats.has(serverName)) {
+            this.serverStats.set(serverName, {
+                connectedAt: Date.now(),
+                successCount: 0,
+                failureCount: 0,
+                latencies: [],
+            });
+        }
+        const stats = this.serverStats.get(serverName);
+        stats.failureCount++;
+        stats.lastError = error;
+        stats.lastErrorAt = Date.now();
+    }
+    /**
+     * Attempt to reconnect to a disconnected server
+     *
+     * NOTE: This method is currently not used because the health monitor
+     * doesn't have access to server configs. Reconnection should be handled
+     * externally by listening to 'server-disconnected' events.
+     */
+    /* private async attemptReconnection(serverName: string, config: any): Promise<void> {
+      // Only schedule if not already reconnecting
+      if (this.reconnectionManager.isReconnecting(serverName)) {
+        return;
+      }
+  
+      await this.reconnectionManager.scheduleReconnection(
+        serverName,
+        config,
+        async (cfg) => {
+          await this.mcpManager.addServer(cfg);
+        }
+      );
+    } */
+    /**
+     * Get reconnection manager
+     */
+    getReconnectionManager() {
+        return this.reconnectionManager;
+    }
+    /**
+     * Calculate percentile from array of values
+     */
+    calculatePercentile(values, percentile) {
+        const sorted = [...values].sort((a, b) => a - b);
+        const index = Math.ceil(sorted.length * percentile) - 1;
+        return sorted[index] || 0;
+    }
+    /**
+     * Get health report for all servers
+     */
+    async getHealthReport() {
+        const servers = this.mcpManager.getServers();
+        const report = [];
+        for (const serverName of servers) {
+            const health = await this.checkServerHealth(serverName);
+            report.push(health);
+        }
+        return report;
+    }
+    /**
+     * Get health status for a specific server
+     */
+    async getServerStatus(serverName) {
+        const servers = this.mcpManager.getServers();
+        if (!servers.includes(serverName)) {
+            return null;
+        }
+        return await this.checkServerHealth(serverName);
+    }
+    /**
+     * Reset stats for a server
+     */
+    resetStats(serverName) {
+        this.serverStats.set(serverName, {
+            connectedAt: Date.now(),
+            successCount: 0,
+            failureCount: 0,
+            latencies: [],
+        });
+    }
+    /**
+     * Get formatted uptime string
+     */
+    static formatUptime(uptimeMs) {
+        const seconds = Math.floor(uptimeMs / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        const days = Math.floor(hours / 24);
+        if (days > 0) {
+            return `${days}d ${hours % 24}h`;
+        }
+        else if (hours > 0) {
+            return `${hours}h ${minutes % 60}m`;
+        }
+        else if (minutes > 0) {
+            return `${minutes}m ${seconds % 60}s`;
+        }
+        else {
+            return `${seconds}s`;
+        }
+    }
+    /**
+     * Get formatted latency string
+     */
+    static formatLatency(latencyMs) {
+        if (latencyMs < 1000) {
+            return `${Math.round(latencyMs)}ms`;
+        }
+        else {
+            return `${(latencyMs / 1000).toFixed(2)}s`;
+        }
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/mcp/health.js.map

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

package/dist/mcp/reconnection.d.ts

@@ -0,0 +1,93 @@
+/**
+ * MCP Server Automatic Reconnection (Phase 5)
+ *
+ * Provides intelligent retry logic with exponential backoff for failed MCP connections
+ * Ensures production reliability without overwhelming servers
+ */
+import { EventEmitter } from 'events';
+import type { MCPServerConfig } from '../schemas/settings-schemas.js';
+export interface ReconnectionStrategy {
+    /** Maximum number of retry attempts */
+    maxRetries: number;
+    /** Initial delay in milliseconds */
+    baseDelayMs: number;
+    /** Maximum delay in milliseconds */
+    maxDelayMs: number;
+    /** Backoff multiplier (2 = double each time) */
+    backoffMultiplier: number;
+    /** Add random jitter to prevent thundering herd */
+    jitter: boolean;
+}
+export declare const DEFAULT_STRATEGY: ReconnectionStrategy;
+export interface ReconnectionState {
+    serverName: string;
+    attempts: number;
+    lastAttempt: number;
+    nextAttempt: number | null;
+    status: 'idle' | 'scheduled' | 'connecting' | 'failed' | 'connected';
+    lastError?: string;
+}
+/**
+ * Reconnection Manager
+ *
+ * Manages automatic reconnection attempts with exponential backoff
+ */
+export declare class ReconnectionManager extends EventEmitter {
+    private retryAttempts;
+    private reconnectTimers;
+    private reconnectionState;
+    private strategy;
+    constructor(strategy?: ReconnectionStrategy);
+    /**
+     * Schedule reconnection for a server
+     */
+    scheduleReconnection(serverName: string, config: MCPServerConfig, reconnectFn: (config: MCPServerConfig) => Promise<void>): Promise<void>;
+    /**
+     * Calculate delay for next attempt with exponential backoff
+     */
+    private calculateDelay;
+    /**
+     * Cancel reconnection attempts for a server
+     */
+    cancelReconnection(serverName: string): void;
+    /**
+     * Cancel all reconnection attempts
+     */
+    cancelAll(): void;
+    /**
+     * Reset retry counter for a server
+     */
+    resetRetries(serverName: string): void;
+    /**
+     * Get reconnection state for a server
+     */
+    getState(serverName: string): ReconnectionState | null;
+    /**
+     * Get all reconnection states
+     */
+    getAllStates(): ReconnectionState[];
+    /**
+     * Update reconnection state
+     */
+    private updateState;
+    /**
+     * Get number of active reconnection attempts
+     */
+    getActiveReconnections(): number;
+    /**
+     * Check if server is currently attempting to reconnect
+     */
+    isReconnecting(serverName: string): boolean;
+    /**
+     * Format time until next reconnection attempt
+     */
+    static formatNextAttempt(nextAttemptMs: number): string;
+    /**
+     * Get strategy configuration
+     */
+    getStrategy(): ReconnectionStrategy;
+    /**
+     * Update strategy configuration
+     */
+    setStrategy(strategy: Partial<ReconnectionStrategy>): void;
+}

package/dist/mcp/reconnection.js

@@ -0,0 +1,216 @@
+/**
+ * MCP Server Automatic Reconnection (Phase 5)
+ *
+ * Provides intelligent retry logic with exponential backoff for failed MCP connections
+ * Ensures production reliability without overwhelming servers
+ */
+import { EventEmitter } from 'events';
+export const DEFAULT_STRATEGY = {
+    maxRetries: 5,
+    baseDelayMs: 1000, // Start at 1 second
+    maxDelayMs: 30000, // Cap at 30 seconds
+    backoffMultiplier: 2, // Double each time: 1s, 2s, 4s, 8s, 16s, 30s
+    jitter: true // Add randomness
+};
+/**
+ * Reconnection Manager
+ *
+ * Manages automatic reconnection attempts with exponential backoff
+ */
+export class ReconnectionManager extends EventEmitter {
+    retryAttempts = new Map();
+    reconnectTimers = new Map();
+    reconnectionState = new Map();
+    strategy;
+    constructor(strategy = DEFAULT_STRATEGY) {
+        super();
+        this.strategy = strategy;
+    }
+    /**
+     * Schedule reconnection for a server
+     */
+    async scheduleReconnection(serverName, config, reconnectFn) {
+        const attempts = this.retryAttempts.get(serverName) || 0;
+        if (attempts >= this.strategy.maxRetries) {
+            this.updateState(serverName, {
+                serverName,
+                attempts,
+                lastAttempt: Date.now(),
+                nextAttempt: null,
+                status: 'failed',
+                lastError: 'Max reconnection attempts reached'
+            });
+            this.emit('max-retries-reached', {
+                serverName,
+                attempts,
+                config
+            });
+            return;
+        }
+        const delay = this.calculateDelay(attempts);
+        this.updateState(serverName, {
+            serverName,
+            attempts,
+            lastAttempt: Date.now(),
+            nextAttempt: Date.now() + delay,
+            status: 'scheduled'
+        });
+        this.emit('reconnection-scheduled', {
+            serverName,
+            attempt: attempts + 1,
+            maxAttempts: this.strategy.maxRetries,
+            delayMs: delay
+        });
+        const timer = setTimeout(async () => {
+            this.updateState(serverName, {
+                serverName,
+                attempts: attempts + 1,
+                lastAttempt: Date.now(),
+                nextAttempt: null,
+                status: 'connecting'
+            });
+            this.emit('reconnection-attempt', {
+                serverName,
+                attempt: attempts + 1,
+                maxAttempts: this.strategy.maxRetries
+            });
+            try {
+                await reconnectFn(config);
+                // Success - reset attempts
+                this.retryAttempts.set(serverName, 0);
+                this.updateState(serverName, {
+                    serverName,
+                    attempts: 0,
+                    lastAttempt: Date.now(),
+                    nextAttempt: null,
+                    status: 'connected'
+                });
+                this.emit('reconnection-success', {
+                    serverName,
+                    totalAttempts: attempts + 1
+                });
+            }
+            catch (error) {
+                // Failure - schedule next attempt
+                this.retryAttempts.set(serverName, attempts + 1);
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                this.updateState(serverName, {
+                    serverName,
+                    attempts: attempts + 1,
+                    lastAttempt: Date.now(),
+                    nextAttempt: null,
+                    status: 'idle',
+                    lastError: errorMessage
+                });
+                this.emit('reconnection-failed', {
+                    serverName,
+                    attempt: attempts + 1,
+                    maxAttempts: this.strategy.maxRetries,
+                    error: errorMessage
+                });
+                // Schedule next attempt
+                await this.scheduleReconnection(serverName, config, reconnectFn);
+            }
+        }, delay);
+        this.reconnectTimers.set(serverName, timer);
+    }
+    /**
+     * Calculate delay for next attempt with exponential backoff
+     */
+    calculateDelay(attempts) {
+        let delay = this.strategy.baseDelayMs * Math.pow(this.strategy.backoffMultiplier, attempts);
+        // Cap at max delay
+        delay = Math.min(delay, this.strategy.maxDelayMs);
+        // Add jitter if enabled (±25% randomness)
+        if (this.strategy.jitter) {
+            const jitterRange = delay * 0.25;
+            const jitter = (Math.random() * 2 - 1) * jitterRange;
+            delay += jitter;
+        }
+        return Math.max(delay, 0);
+    }
+    /**
+     * Cancel reconnection attempts for a server
+     */
+    cancelReconnection(serverName) {
+        const timer = this.reconnectTimers.get(serverName);
+        if (timer) {
+            clearTimeout(timer);
+            this.reconnectTimers.delete(serverName);
+        }
+        this.retryAttempts.delete(serverName);
+        this.reconnectionState.delete(serverName);
+        this.emit('reconnection-cancelled', { serverName });
+    }
+    /**
+     * Cancel all reconnection attempts
+     */
+    cancelAll() {
+        for (const serverName of this.reconnectTimers.keys()) {
+            this.cancelReconnection(serverName);
+        }
+    }
+    /**
+     * Reset retry counter for a server
+     */
+    resetRetries(serverName) {
+        this.retryAttempts.set(serverName, 0);
+    }
+    /**
+     * Get reconnection state for a server
+     */
+    getState(serverName) {
+        return this.reconnectionState.get(serverName) || null;
+    }
+    /**
+     * Get all reconnection states
+     */
+    getAllStates() {
+        return Array.from(this.reconnectionState.values());
+    }
+    /**
+     * Update reconnection state
+     */
+    updateState(serverName, state) {
+        this.reconnectionState.set(serverName, state);
+    }
+    /**
+     * Get number of active reconnection attempts
+     */
+    getActiveReconnections() {
+        return this.reconnectTimers.size;
+    }
+    /**
+     * Check if server is currently attempting to reconnect
+     */
+    isReconnecting(serverName) {
+        const state = this.getState(serverName);
+        return state?.status === 'scheduled' || state?.status === 'connecting';
+    }
+    /**
+     * Format time until next reconnection attempt
+     */
+    static formatNextAttempt(nextAttemptMs) {
+        const diff = nextAttemptMs - Date.now();
+        if (diff <= 0)
+            return 'now';
+        const seconds = Math.floor(diff / 1000);
+        if (seconds < 60)
+            return `${seconds}s`;
+        const minutes = Math.floor(seconds / 60);
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    /**
+     * Get strategy configuration
+     */
+    getStrategy() {
+        return { ...this.strategy };
+    }
+    /**
+     * Update strategy configuration
+     */
+    setStrategy(strategy) {
+        this.strategy = { ...this.strategy, ...strategy };
+    }
+}
+//# sourceMappingURL=reconnection.js.map

package/dist/mcp/reconnection.js.map

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

package/dist/mcp/registry.d.ts

@@ -0,0 +1,71 @@
+/**
+ * MCP Server Registry Integration (Phase 5)
+ *
+ * Enables discovery and installation of MCP servers from the GitHub MCP Registry
+ * Provides one-command install and browsing capabilities
+ */
+import type { MCPServerConfig } from '../schemas/settings-schemas.js';
+export interface RegistryServer {
+    /** Server name/identifier */
+    name: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Server description */
+    description: string;
+    /** GitHub repository URL */
+    repository: string;
+    /** GitHub stars count */
+    stars: number;
+    /** Server category (design, deployment, database, etc.) */
+    category: string;
+    /** Transport type */
+    transport: 'stdio' | 'http' | 'sse';
+    /** NPM package name (for stdio servers) */
+    packageName?: string;
+    /** Install command */
+    installCommand: string;
+    /** Whether this is an official/verified server */
+    verified: boolean;
+    /** Author/organization */
+    author: string;
+    /** Latest version */
+    version?: string;
+    /** Homepage URL */
+    homepage?: string;
+}
+export interface RegistrySearchOptions {
+    /** Search query */
+    query?: string;
+    /** Filter by category */
+    category?: string;
+    /** Filter by transport type */
+    transport?: 'stdio' | 'http' | 'sse';
+    /** Sort by (stars, name, updated) */
+    sortBy?: 'stars' | 'name' | 'updated';
+    /** Max results to return */
+    limit?: number;
+}
+/**
+ * Search the MCP server registry
+ */
+export declare function searchRegistry(options?: RegistrySearchOptions): Promise<RegistryServer[]>;
+/**
+ * Get details for a specific server from the registry
+ */
+export declare function getRegistryServer(nameOrPackage: string): Promise<RegistryServer | null>;
+/**
+ * Get popular/featured MCP servers
+ */
+export declare function getPopularServers(): Promise<RegistryServer[]>;
+/**
+ * Get servers by category
+ */
+export declare function getServersByCategory(category: string): Promise<RegistryServer[]>;
+/**
+ * Generate MCP server configuration from registry entry
+ */
+export declare function generateConfigFromRegistry(server: RegistryServer): MCPServerConfig;
+/**
+ * Format registry server for display
+ */
+export declare function formatRegistryServer(server: RegistryServer, compact?: boolean): string;