@defai.digital/ax-cli 4.4.7 → 4.4.11

package/dist/mcp/debug.js

@@ -1,404 +0,0 @@
-/**
- * MCP Debug Mode
- *
- * Comprehensive diagnostic utilities for troubleshooting MCP server connections,
- * tool calls, and configuration issues.
- *
- * @module mcp/debug
- */
-import { EventEmitter } from 'events';
-/**
- * Default debug logger configuration
- */
-export const DEFAULT_DEBUG_CONFIG = {
-    enabled: false,
-    level: 'info',
-    maxEvents: 100,
-    includeTimestamps: true,
-    formatOutput: true,
-};
-/**
- * MCP Debug Logger
- *
- * Captures and formats debug events for MCP operations.
- * Can be enabled/disabled at runtime.
- */
-export class MCPDebugLogger extends EventEmitter {
-    config;
-    events = [];
-    serverHealthStatus = new Map();
-    constructor(config = {}) {
-        super();
-        this.config = { ...DEFAULT_DEBUG_CONFIG, ...config };
-    }
-    /**
-     * Enable debug mode
-     */
-    enable() {
-        this.config.enabled = true;
-    }
-    /**
-     * Disable debug mode
-     */
-    disable() {
-        this.config.enabled = false;
-    }
-    /**
-     * Check if debug mode is enabled
-     */
-    isEnabled() {
-        return this.config.enabled;
-    }
-    /**
-     * Set debug level
-     */
-    setLevel(level) {
-        this.config.level = level;
-    }
-    /**
-     * Log a debug event
-     */
-    log(type, data, options) {
-        if (!this.config.enabled)
-            return;
-        const event = {
-            type,
-            timestamp: new Date(),
-            data,
-            ...options,
-        };
-        // Add to event buffer
-        this.events.push(event);
-        // Trim buffer if needed
-        if (this.events.length > this.config.maxEvents) {
-            this.events = this.events.slice(-this.config.maxEvents);
-        }
-        // Emit event for external listeners
-        this.emit('debug', event);
-        // Console output if enabled
-        if (this.shouldLog(type)) {
-            this.outputEvent(event);
-        }
-    }
-    /**
-     * Check if event type should be logged at current level
-     */
-    shouldLog(type) {
-        const levelPriority = {
-            trace: 0,
-            debug: 1,
-            info: 2,
-            warn: 3,
-            error: 4,
-        };
-        const eventLevel = this.getEventLevel(type);
-        return levelPriority[eventLevel] >= levelPriority[this.config.level];
-    }
-    /**
-     * Get log level for event type
-     */
-    getEventLevel(type) {
-        if (type.includes('failure') || type.includes('error') || type.includes('timeout')) {
-            return 'error';
-        }
-        if (type.includes('health:failure')) {
-            return 'warn';
-        }
-        if (type.includes('reconnection')) {
-            return 'info';
-        }
-        if (type.includes('start') || type.includes('success')) {
-            return 'debug';
-        }
-        return 'trace';
-    }
-    /**
-     * Format and output an event
-     */
-    outputEvent(event) {
-        if (!this.config.formatOutput) {
-            console.log('[MCP Debug]', event);
-            return;
-        }
-        const timestamp = this.config.includeTimestamps
-            ? `[${event.timestamp.toISOString()}]`
-            : '';
-        const level = this.getEventLevel(event.type).toUpperCase().padEnd(5);
-        const serverInfo = event.serverName ? ` [${event.serverName}]` : '';
-        const toolInfo = event.toolName ? ` ${event.toolName}` : '';
-        const durationInfo = event.duration ? ` (${event.duration}ms)` : '';
-        let message = `${timestamp} ${level} ${event.type}${serverInfo}${toolInfo}${durationInfo}`;
-        if (Object.keys(event.data).length > 0) {
-            message += ` ${JSON.stringify(event.data)}`;
-        }
-        if (event.error) {
-            message += ` ERROR: ${event.error.message}`;
-        }
-        console.log(message);
-    }
-    /**
-     * Record health check result
-     */
-    recordHealthCheck(serverName, healthy) {
-        this.serverHealthStatus.set(serverName, {
-            status: healthy ? 'healthy' : 'unhealthy',
-            lastCheck: new Date(),
-        });
-        this.log('health:check', { healthy }, { serverName });
-    }
-    /**
-     * Get recent events
-     */
-    getRecentEvents(count) {
-        const limit = count ?? this.config.maxEvents;
-        return this.events.slice(-limit);
-    }
-    /**
-     * Get events for a specific server
-     */
-    getServerEvents(serverName) {
-        return this.events.filter((e) => e.serverName === serverName);
-    }
-    /**
-     * Get events for a specific tool
-     */
-    getToolEvents(toolName) {
-        return this.events.filter((e) => e.toolName === toolName);
-    }
-    /**
-     * Get events by type
-     */
-    getEventsByType(type) {
-        return this.events.filter((e) => e.type === type);
-    }
-    /**
-     * Get health status for a server
-     */
-    getHealthStatus(serverName) {
-        const status = this.serverHealthStatus.get(serverName);
-        if (!status) {
-            return { status: 'unknown' };
-        }
-        return status;
-    }
-    /**
-     * Clear all recorded events
-     */
-    clearEvents() {
-        this.events = [];
-    }
-    /**
-     * Clear health status
-     */
-    clearHealthStatus() {
-        this.serverHealthStatus.clear();
-    }
-    /**
-     * Get configuration
-     */
-    getConfig() {
-        return { ...this.config };
-    }
-    /**
-     * Update configuration
-     */
-    updateConfig(config) {
-        this.config = { ...this.config, ...config };
-    }
-    /**
-     * Clean up resources and remove all event listeners.
-     */
-    destroy() {
-        this.removeAllListeners();
-    }
-}
-// =============================================================================
-// Singleton Instance
-// =============================================================================
-let debugLoggerInstance = null;
-/**
- * Get the singleton debug logger instance
- */
-export function getMCPDebugLogger() {
-    if (!debugLoggerInstance) {
-        debugLoggerInstance = new MCPDebugLogger();
-    }
-    return debugLoggerInstance;
-}
-/**
- * Reset the debug logger instance (for testing)
- */
-export function resetMCPDebugLogger() {
-    if (debugLoggerInstance) {
-        debugLoggerInstance.removeAllListeners();
-        debugLoggerInstance.clearEvents();
-        debugLoggerInstance.clearHealthStatus();
-    }
-    debugLoggerInstance = null;
-}
-// =============================================================================
-// Diagnostic Utilities
-// =============================================================================
-/**
- * Collect diagnostics from MCPManagerV2
- *
- * @param manager - The MCP manager instance
- * @returns Diagnostic summary
- */
-export async function collectMCPDiagnostics(manager) {
-    const debugLogger = getMCPDebugLogger();
-    const connectionStatus = manager.getConnectionStatus();
-    const allTools = manager.getTools();
-    const allPrompts = manager.getPrompts();
-    const serverNames = manager.getServers();
-    const serverDiagnostics = [];
-    // Collect all servers (not just connected ones)
-    const allServerNames = new Set();
-    for (const tool of allTools) {
-        allServerNames.add(tool.serverName);
-    }
-    for (const serverName of serverNames) {
-        allServerNames.add(serverName);
-    }
-    for (const serverName of allServerNames) {
-        const state = manager.getConnectionState(serverName);
-        const transportResult = manager.getTransportType(serverName);
-        const serverTools = allTools.filter((t) => t.serverName === serverName);
-        const serverPrompts = allPrompts.filter((p) => p.serverName === serverName);
-        const healthStatus = debugLogger.getHealthStatus(serverName);
-        const diagnostic = {
-            serverName,
-            status: state?.status ?? 'idle',
-            transportType: transportResult.success ? transportResult.value : undefined,
-            connectedAt: state?.status === 'connected' ? state.connectedAt : undefined,
-            failedAt: state?.status === 'failed' ? state.failedAt : undefined,
-            lastError: state?.status === 'failed' ? state.error.message : undefined,
-            toolCount: serverTools.length,
-            tools: serverTools.map((t) => String(t.name)),
-            promptCount: serverPrompts.length,
-            prompts: serverPrompts.map((p) => p.name),
-            reconnectionAttempts: 0, // Would need access to private state
-            healthCheckStatus: healthStatus.status,
-            lastHealthCheck: healthStatus.lastCheck,
-        };
-        serverDiagnostics.push(diagnostic);
-    }
-    return {
-        timestamp: new Date(),
-        totalServers: connectionStatus.total,
-        connectedServers: connectionStatus.connected,
-        failedServers: connectionStatus.failed,
-        connectingServers: connectionStatus.connecting,
-        totalTools: allTools.length,
-        totalPrompts: allPrompts.length,
-        servers: serverDiagnostics,
-        recentEvents: debugLogger.getRecentEvents(20),
-        healthCheckEnabled: true, // Would need access to config
-        reconnectionEnabled: true, // Would need access to config
-    };
-}
-/**
- * Format diagnostics for display
- */
-export function formatMCPDiagnostics(diagnostics) {
-    const lines = [];
-    lines.push('═══════════════════════════════════════════════════════════════');
-    lines.push('                    MCP DIAGNOSTICS REPORT');
-    lines.push('═══════════════════════════════════════════════════════════════');
-    lines.push(`Timestamp: ${diagnostics.timestamp.toISOString()}`);
-    lines.push('');
-    // Summary
-    lines.push('┌─────────────────────────────────────────────────────────────┐');
-    lines.push('│                        SUMMARY                              │');
-    lines.push('├─────────────────────────────────────────────────────────────┤');
-    lines.push(`│ Servers: ${diagnostics.connectedServers}/${diagnostics.totalServers} connected, ${diagnostics.failedServers} failed, ${diagnostics.connectingServers} connecting`);
-    lines.push(`│ Tools:   ${diagnostics.totalTools} registered`);
-    lines.push(`│ Prompts: ${diagnostics.totalPrompts} available`);
-    lines.push('└─────────────────────────────────────────────────────────────┘');
-    lines.push('');
-    // Server details
-    if (diagnostics.servers.length > 0) {
-        lines.push('┌─────────────────────────────────────────────────────────────┐');
-        lines.push('│                    SERVER DETAILS                           │');
-        lines.push('└─────────────────────────────────────────────────────────────┘');
-        for (const server of diagnostics.servers) {
-            const statusIcon = server.status === 'connected' ? '✓' : server.status === 'failed' ? '✗' : '○';
-            const healthIcon = server.healthCheckStatus === 'healthy' ? '♥' : server.healthCheckStatus === 'unhealthy' ? '!' : '?';
-            lines.push(`  ${statusIcon} ${server.serverName}`);
-            lines.push(`    Status: ${server.status} ${healthIcon}`);
-            if (server.transportType) {
-                lines.push(`    Transport: ${server.transportType}`);
-            }
-            if (server.connectedAt) {
-                lines.push(`    Connected: ${new Date(server.connectedAt).toISOString()}`);
-            }
-            if (server.lastError) {
-                lines.push(`    Last Error: ${server.lastError}`);
-            }
-            lines.push(`    Tools: ${server.toolCount} (${server.tools.slice(0, 3).join(', ')}${server.tools.length > 3 ? '...' : ''})`);
-            if (server.promptCount > 0) {
-                lines.push(`    Prompts: ${server.promptCount}`);
-            }
-            lines.push('');
-        }
-    }
-    // Recent events
-    if (diagnostics.recentEvents.length > 0) {
-        lines.push('┌─────────────────────────────────────────────────────────────┐');
-        lines.push('│                    RECENT EVENTS                            │');
-        lines.push('└─────────────────────────────────────────────────────────────┘');
-        for (const event of diagnostics.recentEvents.slice(-10)) {
-            const time = event.timestamp.toISOString().split('T')[1].split('.')[0];
-            const serverInfo = event.serverName ? ` [${event.serverName}]` : '';
-            lines.push(`  ${time} ${event.type}${serverInfo}`);
-        }
-    }
-    lines.push('');
-    lines.push('═══════════════════════════════════════════════════════════════');
-    return lines.join('\n');
-}
-/**
- * Create a debug session that instruments MCP manager events
- */
-export function createDebugSession(manager, options) {
-    const debugLogger = getMCPDebugLogger();
-    if (options) {
-        debugLogger.updateConfig(options);
-    }
-    debugLogger.enable();
-    // Wire up manager events to debug logger
-    manager.on('serverAdded', (serverName, toolCount) => {
-        debugLogger.log('connection:success', { toolCount }, { serverName });
-    });
-    manager.on('serverError', (serverName, error) => {
-        debugLogger.log('connection:failure', {}, { serverName, error });
-    });
-    manager.on('serverRemoved', (serverName) => {
-        debugLogger.log('connection:disconnect', {}, { serverName });
-    });
-    manager.on('server-unhealthy', (serverName, error) => {
-        const err = error instanceof Error ? error : new Error(String(error));
-        debugLogger.log('health:failure', {}, { serverName, error: err });
-        debugLogger.recordHealthCheck(serverName, false);
-    });
-    manager.on('reconnection-scheduled', (serverName, attempt, delay) => {
-        debugLogger.log('reconnection:scheduled', { attempt, delay }, { serverName });
-    });
-    manager.on('reconnection-succeeded', (serverName, attempts) => {
-        debugLogger.log('reconnection:success', { attempts }, { serverName });
-    });
-    manager.on('reconnection-failed', (serverName, attempts, reason) => {
-        debugLogger.log('reconnection:failure', { attempts, reason }, { serverName });
-    });
-    manager.on('progress', (data) => {
-        debugLogger.log('progress:update', { progress: data.progress, total: data.total }, { serverName: data.serverName });
-    });
-    manager.on('resource-updated', (serverName, uri) => {
-        debugLogger.log('resource:updated', { uri }, { serverName });
-    });
-    manager.on('schema-validation-failed', (data) => {
-        debugLogger.log('schema:validation', { valid: false, errors: data.errors }, { serverName: data.serverName, toolName: data.toolName });
-    });
-    return debugLogger;
-}
-//# sourceMappingURL=debug.js.map

package/dist/mcp/debug.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/mcp/debug.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAwGtC;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACrD,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,MAAM;IACb,SAAS,EAAE,GAAG;IACd,iBAAiB,EAAE,IAAI;IACvB,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,OAAO,cAAe,SAAQ,YAAY;IACtC,MAAM,CAAoB;IAC1B,MAAM,GAAiB,EAAE,CAAC;IAC1B,kBAAkB,GAA0E,IAAI,GAAG,EAAE,CAAC;IAE9G,YAAY,SAAqC,EAAE;QACjD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,oBAAoB,EAAE,GAAG,MAAM,EAAE,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAoB;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,GAAG,CACD,IAAoB,EACpB,IAA6B,EAC7B,OAKC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAEjC,MAAM,KAAK,GAAe;YACxB,IAAI;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,IAAI;YACJ,GAAG,OAAO;SACX,CAAC;QAEF,sBAAsB;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExB,wBAAwB;QACxB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1D,CAAC;QAED,oCAAoC;QACpC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAE1B,4BAA4B;QAC5B,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,IAAoB;QACpC,MAAM,aAAa,GAAkC;YACnD,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;SACT,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO,aAAa,CAAC,UAAU,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,IAAoB;QACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACnF,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACpC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAClC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACvD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,KAAiB;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;YAClC,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB;YAC7C,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG;YACtC,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAEpE,IAAI,OAAO,GAAG,GAAG,SAAS,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,EAAE,CAAC;QAE3F,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,IAAI,WAAW,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAC9C,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,UAAsB,EAAE,OAAgB;QACxD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE;YACtC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;YACzC,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,KAAc;QAC5B,MAAM,KAAK,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,UAAsB;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAAkB;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAoB;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,UAAsB;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAkC;QAC7C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;CAEF;AAED,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,IAAI,mBAAmB,GAA0B,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,mBAAmB,GAAG,IAAI,cAAc,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,mBAAmB,EAAE,CAAC;QACxB,mBAAmB,CAAC,kBAAkB,EAAE,CAAC;QACzC,mBAAmB,CAAC,WAAW,EAAE,CAAC;QAClC,mBAAmB,CAAC,iBAAiB,EAAE,CAAC;IAC1C,CAAC;IACD,mBAAmB,GAAG,IAAI,CAAC;AAC7B,CAAC;AAED,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAOC;IAED,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;IACxC,MAAM,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IACxC,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAEzC,MAAM,iBAAiB,GAAwB,EAAE,CAAC;IAElD,gDAAgD;IAChD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAc,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,cAAc,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAE7D,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QACxE,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QAE5E,MAAM,YAAY,GAAG,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAE7D,MAAM,UAAU,GAAsB;YACpC,UAAU;YACV,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,MAAM;YAC/B,aAAa,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YAC1E,WAAW,EAAE,KAAK,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;YAC1E,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YACjE,SAAS,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YACvE,SAAS,EAAE,WAAW,CAAC,MAAM;YAC7B,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7C,WAAW,EAAE,aAAa,CAAC,MAAM;YACjC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACzC,oBAAoB,EAAE,CAAC,EAAE,qCAAqC;YAC9D,iBAAiB,EAAE,YAAY,CAAC,MAAM;YACtC,eAAe,EAAE,YAAY,CAAC,SAAS;SACxC,CAAC;QAEF,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,YAAY,EAAE,gBAAgB,CAAC,KAAK;QACpC,gBAAgB,EAAE,gBAAgB,CAAC,SAAS;QAC5C,aAAa,EAAE,gBAAgB,CAAC,MAAM;QACtC,iBAAiB,EAAE,gBAAgB,CAAC,UAAU;QAC9C,UAAU,EAAE,QAAQ,CAAC,MAAM;QAC3B,YAAY,EAAE,UAAU,CAAC,MAAM;QAC/B,OAAO,EAAE,iBAAiB;QAC1B,YAAY,EAAE,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC;QAC7C,kBAAkB,EAAE,IAAI,EAAE,8BAA8B;QACxD,mBAAmB,EAAE,IAAI,EAAE,8BAA8B;KAC1D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAA2B;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,UAAU;IACV,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,gBAAgB,IAAI,WAAW,CAAC,YAAY,eAAe,WAAW,CAAC,aAAa,YAAY,WAAW,CAAC,iBAAiB,aAAa,CAAC,CAAC;IACjL,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,UAAU,aAAa,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,YAAY,YAAY,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,iBAAiB;IACjB,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAE9E,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAChG,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAEvH,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;YACzD,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC7H,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,IAAI,WAAW,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAE9E,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACvE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,GAAG,UAAU,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAE9E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAqB,EACrB,OAAoC;IAEpC,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;IAExC,IAAI,OAAO,EAAE,CAAC;QACZ,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,WAAW,CAAC,MAAM,EAAE,CAAC;IAErB,yCAAyC;IACzC,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,UAAsB,EAAE,SAAiB,EAAE,EAAE;QACtE,WAAW,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,UAAsB,EAAE,KAAY,EAAE,EAAE;QACjE,WAAW,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,UAAsB,EAAE,EAAE;QACrD,WAAW,CAAC,GAAG,CAAC,uBAAuB,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,UAAsB,EAAE,KAAc,EAAE,EAAE;QACxE,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,WAAW,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAClE,WAAW,CAAC,iBAAiB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,wBAAwB,EAAE,CAAC,UAAsB,EAAE,OAAe,EAAE,KAAa,EAAE,EAAE;QAC9F,WAAW,CAAC,GAAG,CAAC,wBAAwB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,wBAAwB,EAAE,CAAC,UAAsB,EAAE,QAAgB,EAAE,EAAE;QAChF,WAAW,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,UAAsB,EAAE,QAAgB,EAAE,MAAc,EAAE,EAAE;QAC7F,WAAW,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,IAAkE,EAAE,EAAE;QAC5F,WAAW,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACtH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,UAAsB,EAAE,GAAW,EAAE,EAAE;QACrE,WAAW,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,0BAA0B,EAAE,CAAC,IAAsE,EAAE,EAAE;QAChH,WAAW,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxI,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/mcp/error-formatter.d.ts

@@ -1,40 +0,0 @@
-/**
- * User-Friendly MCP Error Formatter
- *
- * Transforms cryptic Zod validation errors and technical errors into
- * actionable, user-friendly messages with helpful hints and documentation links.
- */
-import type { z } from 'zod';
-export interface FormattedError {
-    /** Main error title */
-    title: string;
-    /** Error details */
-    details: string[];
-    /** Helpful hints */
-    hints: string[];
-    /** Documentation link */
-    docLink?: string;
-    /** Example correct configuration */
-    example?: string;
-}
-/**
- * Format a Zod validation error for MCP server config
- */
-export declare function formatMCPConfigError(serverName: string, error: z.ZodError, originalConfig?: unknown): string;
-/**
- * Format a connection error
- */
-export declare function formatConnectionError(serverName: string, error: Error, transportType?: string): string;
-/**
- * Format a validation error (generic)
- */
-export declare function formatValidationError(context: string, issues: Array<{
-    field: string;
-    message: string;
-}>): string;
-/** Format a warning message */
-export declare const formatWarning: (message: string, details?: string[]) => string;
-/** Format a success message */
-export declare const formatSuccess: (message: string, details?: string[]) => string;
-/** Format info message */
-export declare const formatInfo: (message: string, details?: string[]) => string;

package/dist/mcp/error-formatter.js

@@ -1,207 +0,0 @@
-/**
- * User-Friendly MCP Error Formatter
- *
- * Transforms cryptic Zod validation errors and technical errors into
- * actionable, user-friendly messages with helpful hints and documentation links.
- */
-import chalk from 'chalk';
-import { matchErrorPattern, getTransportHints, getEnvVarHints } from './error-remediation.js';
-/**
- * Format a Zod validation error for MCP server config
- */
-export function formatMCPConfigError(serverName, error, originalConfig) {
-    const lines = [];
-    lines.push(chalk.red('╭─ MCP Configuration Error ─────────────────────╮'));
-    lines.push(chalk.red(`│ Server: ${chalk.bold(serverName)}`));
-    lines.push(chalk.red('│'));
-    // Group errors by field
-    const errorsByField = new Map();
-    for (const issue of error.issues) {
-        const field = issue.path.length > 0 ? issue.path.join('.') : 'config';
-        const message = issue.message;
-        let fieldErrors = errorsByField.get(field);
-        if (!fieldErrors) {
-            fieldErrors = [];
-            errorsByField.set(field, fieldErrors);
-        }
-        fieldErrors.push(message);
-    }
-    // Display errors
-    lines.push(chalk.red('│ Errors:'));
-    for (const [field, messages] of errorsByField.entries()) {
-        lines.push(chalk.red(`│   ❌ Field "${chalk.yellow(field)}":`));
-        messages.forEach(msg => {
-            lines.push(chalk.red(`│      ${msg}`));
-        });
-        // Add helpful hints based on field
-        const hints = getHintsForField(field, originalConfig);
-        if (hints.length > 0) {
-            lines.push(chalk.red(`│      ${chalk.cyan('Hint:')} ${hints[0]}`));
-        }
-    }
-    lines.push(chalk.red('│'));
-    // Add example
-    const example = getExampleConfig(errorsByField, originalConfig);
-    if (example) {
-        lines.push(chalk.red('│ Example correct config:'));
-        example.split('\n').forEach(line => {
-            lines.push(chalk.red(`│   ${chalk.green(line)}`));
-        });
-        lines.push(chalk.red('│'));
-    }
-    // Add documentation link
-    lines.push(chalk.red(`│ ${chalk.blue('📖 Documentation:')} https://docs.ax-cli.dev/mcp/configuration`));
-    lines.push(chalk.red('╰────────────────────────────────────────────────╯'));
-    return lines.join('\n');
-}
-/**
- * Get helpful hints based on error field
- */
-function getHintsForField(field, originalConfig) {
-    const hints = [];
-    switch (field) {
-        case 'transport':
-            hints.push('Add "transport": { "type": "stdio", "command": "...", "args": [...] }');
-            if (originalConfig?.command) {
-                hints.push('Legacy format detected. Your "command" field should be inside "transport".');
-            }
-            break;
-        case 'transport.type':
-            hints.push('Valid types: "stdio", "http", "sse", "streamable_http"');
-            break;
-        case 'transport.command':
-            hints.push('Command is required for stdio transport');
-            hints.push('Example: "npx", "node", "python", etc.');
-            break;
-        case 'transport.url':
-            hints.push('URL is required for http/sse transports');
-            hints.push('Example: "https://api.example.com" or "http://localhost:3000"');
-            break;
-        case 'transport.args':
-            hints.push('Args should be an array of strings');
-            hints.push('Example: ["@modelcontextprotocol/server-github"]');
-            break;
-        case 'name':
-            hints.push('Server name is required and should be alphanumeric with hyphens/underscores');
-            hints.push('Example: "github", "my-server", "api_v2"');
-            break;
-        default:
-            if (field.startsWith('transport.')) {
-                // BUG FIX: Validate split result before accessing index to prevent undefined access
-                const fieldParts = field.split('.');
-                const subField = fieldParts.length > 1 ? fieldParts[1] : field;
-                hints.push(`Check the ${subField} field in your transport configuration`);
-            }
-    }
-    return hints;
-}
-/**
- * Generate example config based on errors
- */
-function getExampleConfig(errorsByField, originalConfig) {
-    const hasTransportError = Array.from(errorsByField.keys()).some(f => f === 'transport' || f.startsWith('transport.'));
-    if (!hasTransportError) {
-        return null;
-    }
-    // Check if it's likely a stdio config
-    const isStdio = originalConfig?.command || errorsByField.has('transport.command');
-    if (isStdio) {
-        return `{
-  "name": "my-server",
-  "transport": {
-    "type": "stdio",
-    "command": "npx",
-    "args": ["@modelcontextprotocol/server-example"],
-    "env": { "API_KEY": "..." }
-  }
-}`;
-    }
-    // Default to HTTP example
-    return `{
-  "name": "my-server",
-  "transport": {
-    "type": "http",
-    "url": "https://api.example.com",
-    "headers": { "Authorization": "Bearer ..." }
-  }
-}`;
-}
-/**
- * Format a connection error
- */
-export function formatConnectionError(serverName, error, transportType) {
-    const lines = [];
-    lines.push(chalk.red('╭─ MCP Connection Error ────────────────────────╮'));
-    lines.push(chalk.red(`│ Server: ${chalk.bold(serverName)}`));
-    if (transportType) {
-        lines.push(chalk.red(`│ Transport: ${transportType}`));
-    }
-    lines.push(chalk.red('│'));
-    lines.push(chalk.red(`│ Error: ${error.message}`));
-    lines.push(chalk.red('│'));
-    // Add hints based on error message
-    const hints = getConnectionErrorHints(error, transportType);
-    if (hints.length > 0) {
-        lines.push(chalk.red('│ Troubleshooting:'));
-        hints.forEach(hint => {
-            lines.push(chalk.red(`│   • ${hint}`));
-        });
-        lines.push(chalk.red('│'));
-    }
-    lines.push(chalk.red(`│ ${chalk.blue('🔧 Diagnostics:')} ax-cli mcp test ${serverName}`));
-    lines.push(chalk.red('╰────────────────────────────────────────────────╯'));
-    return lines.join('\n');
-}
-/**
- * Get hints for connection errors
- * Uses extracted error remediation module for pattern matching
- */
-function getConnectionErrorHints(error, transportType) {
-    const hints = [];
-    // Check for specific error codes first using extracted module
-    const remediation = matchErrorPattern(error);
-    if (remediation) {
-        hints.push(`${chalk.bold(remediation.title)}`);
-        hints.push(...remediation.hints);
-        if (remediation.command) {
-            hints.push(`Debug command: ${chalk.cyan(remediation.command)}`);
-        }
-    }
-    // If no specific match, provide transport-specific hints
-    if (hints.length === 0) {
-        hints.push(...getTransportHints(transportType));
-    }
-    // Add environment variable hints if relevant
-    hints.push(...getEnvVarHints(error.message));
-    return hints;
-}
-/**
- * Format a validation error (generic)
- */
-export function formatValidationError(context, issues) {
-    const lines = [];
-    lines.push(chalk.yellow('╭─ Validation Error ────────────────────────────╮'));
-    lines.push(chalk.yellow(`│ Context: ${context}`));
-    lines.push(chalk.yellow('│'));
-    lines.push(chalk.yellow('│ Issues:'));
-    issues.forEach(({ field, message }) => {
-        lines.push(chalk.yellow(`│   ❌ ${field}: ${message}`));
-    });
-    lines.push(chalk.yellow('╰────────────────────────────────────────────────╯'));
-    return lines.join('\n');
-}
-/**
- * Format a message with icon and optional details
- */
-function formatMessage(icon, colorFn, message, details) {
-    const lines = [colorFn(`${icon} ${message}`)];
-    details?.forEach(detail => lines.push(chalk.dim(`   ${detail}`)));
-    return lines.join('\n');
-}
-/** Format a warning message */
-export const formatWarning = (message, details) => formatMessage('⚠️ ', chalk.yellow, message, details);
-/** Format a success message */
-export const formatSuccess = (message, details) => formatMessage('✅', chalk.green, message, details);
-/** Format info message */
-export const formatInfo = (message, details) => formatMessage('ℹ️ ', chalk.blue, message, details);
-//# sourceMappingURL=error-formatter.js.map