@defai.digital/ax-cli 4.4.6 → 4.4.10

package/dist/mcp/error-formatter.js.map

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

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

@@ -1,45 +0,0 @@
-/**
- * MCP Error Remediation Module
- *
- * Centralized error code to remediation mapping for MCP connection errors.
- * Maps error codes/patterns to specific troubleshooting steps.
- *
- * Extracted from error-formatter.ts for better separation of concerns.
- */
-/**
- * Remediation information for an error
- */
-export interface Remediation {
-    /** Short title describing the error */
-    title: string;
-    /** List of troubleshooting hints */
-    hints: string[];
-    /** Optional debug command to run */
-    command?: string;
-}
-/**
- * Comprehensive error code to remediation mapping
- * Maps error codes/patterns to specific troubleshooting steps
- */
-export declare const ERROR_REMEDIATION: Record<string, Remediation>;
-/**
- * Match an error against known patterns and return remediation info
- *
- * @param error - The error to match
- * @returns Remediation info if a pattern matches, null otherwise
- */
-export declare function matchErrorPattern(error: Error): Remediation | null;
-/**
- * Get transport-specific troubleshooting hints when no specific error pattern matches
- *
- * @param transportType - The transport type (stdio, http, sse)
- * @returns Array of troubleshooting hints
- */
-export declare function getTransportHints(transportType?: string): string[];
-/**
- * Get environment variable hints if the error relates to credentials
- *
- * @param errorMessage - The error message to check
- * @returns Array of environment variable hints, or empty array if not applicable
- */
-export declare function getEnvVarHints(errorMessage: string): string[];

package/dist/mcp/error-remediation.js

@@ -1,291 +0,0 @@
-/**
- * MCP Error Remediation Module
- *
- * Centralized error code to remediation mapping for MCP connection errors.
- * Maps error codes/patterns to specific troubleshooting steps.
- *
- * Extracted from error-formatter.ts for better separation of concerns.
- */
-/**
- * Comprehensive error code to remediation mapping
- * Maps error codes/patterns to specific troubleshooting steps
- */
-export const ERROR_REMEDIATION = {
-    // Process/Command errors
-    'enoent': {
-        title: 'Command not found',
-        hints: [
-            'The MCP server command is not installed or not in PATH',
-            'Install the package: npm install -g <package-name>',
-            'Or use npx: npx <package-name>',
-            'Verify installation: which <command> or command -v <command>'
-        ],
-        command: 'npm list -g --depth=0'
-    },
-    'eacces': {
-        title: 'Permission denied',
-        hints: [
-            'The command or file lacks execute permissions',
-            'Fix permissions: chmod +x <file>',
-            'Or install globally with proper permissions',
-            'Avoid using sudo with npm - fix npm permissions instead'
-        ],
-        command: 'npm config set prefix ~/.npm-global'
-    },
-    'spawn': {
-        title: 'Failed to spawn process',
-        hints: [
-            'The command could not be started',
-            'Verify the command path is correct',
-            'Check if the binary is compatible with your system',
-            'Try running the command directly in terminal'
-        ]
-    },
-    // Network errors
-    'econnrefused': {
-        title: 'Connection refused',
-        hints: [
-            'The MCP server is not running or not listening',
-            'Start the server first, then retry',
-            'Check if the port is correct',
-            'Verify no firewall is blocking the connection'
-        ],
-        command: 'lsof -i :<port> # Check if port is in use'
-    },
-    'enotfound': {
-        title: 'Host not found',
-        hints: [
-            'The hostname could not be resolved',
-            'Check if the URL is spelled correctly',
-            'Verify your internet connection',
-            'Try using IP address instead of hostname'
-        ],
-        command: 'nslookup <hostname>'
-    },
-    'econnreset': {
-        title: 'Connection reset',
-        hints: [
-            'The server closed the connection unexpectedly',
-            'The server may have crashed or restarted',
-            'Check server logs for errors',
-            'Retry the connection'
-        ]
-    },
-    'etimedout': {
-        title: 'Connection timed out',
-        hints: [
-            'The server took too long to respond',
-            'Check if the server is overloaded',
-            'Verify network connectivity',
-            'Increase timeout in configuration if needed'
-        ]
-    },
-    'esockettimedout': {
-        title: 'Socket timed out',
-        hints: [
-            'The connection was established but no response received',
-            'The server may be hanging or processing slowly',
-            'For stdio: ensure command has proper args (not a REPL)',
-            'Check if the MCP server is compatible with this client'
-        ]
-    },
-    // SSL/TLS errors
-    'cert_': {
-        title: 'SSL Certificate error',
-        hints: [
-            'The server\'s SSL certificate is invalid or expired',
-            'For development: you can skip verification (not recommended)',
-            'For production: ensure valid certificate is installed',
-            'Check certificate chain: openssl s_client -connect <host>:443'
-        ]
-    },
-    'unable_to_verify': {
-        title: 'SSL verification failed',
-        hints: [
-            'Cannot verify the server\'s SSL certificate',
-            'The certificate may be self-signed',
-            'CA certificates may need to be updated',
-            'Set NODE_TLS_REJECT_UNAUTHORIZED=0 for development only'
-        ]
-    },
-    // Authentication errors
-    '401': {
-        title: 'Authentication failed',
-        hints: [
-            'The API key or token is invalid or expired',
-            '→ For Figma: ax-cli mcp add figma --template --env FIGMA_ACCESS_TOKEN=YOUR_TOKEN',
-            '→ For GitHub: ax-cli mcp add github --template --env GITHUB_TOKEN=YOUR_TOKEN',
-            'Regenerate the API key if expired at the provider dashboard',
-            'Check environment variable is set: echo $<VAR_NAME>'
-        ],
-        command: 'ax-cli mcp validate <server-name>'
-    },
-    '403': {
-        title: 'Access forbidden',
-        hints: [
-            'You don\'t have permission to access this resource',
-            'Check if your API key has the required scopes/permissions',
-            '→ For Figma: ensure token has "file:read" permission',
-            '→ For GitHub: ensure token has "repo" scope',
-            'Regenerate token with correct permissions if needed'
-        ],
-        command: 'ax-cli mcp test <server-name>'
-    },
-    // Server errors
-    '500': {
-        title: 'Server error',
-        hints: [
-            'The MCP server encountered an internal error',
-            'Check server logs for details',
-            'Try again later',
-            'Report the issue to the server maintainer'
-        ]
-    },
-    '502': {
-        title: 'Bad gateway',
-        hints: [
-            'The server received an invalid response from upstream',
-            'The upstream server may be down',
-            'Try again later',
-            'Check if there are known outages'
-        ]
-    },
-    '503': {
-        title: 'Service unavailable',
-        hints: [
-            'The server is temporarily unavailable',
-            'It may be overloaded or under maintenance',
-            'Wait a few minutes and retry',
-            'Check service status page'
-        ]
-    },
-    // MCP-specific errors
-    'initialization failed': {
-        title: 'MCP initialization failed',
-        hints: [
-            'The MCP server failed to initialize properly',
-            'Check if all required environment variables are set',
-            '→ Run: ax-cli mcp validate <server-name>',
-            '→ Run: ax-cli mcp test <server-name>'
-        ],
-        command: 'ax-cli mcp templates'
-    },
-    'protocol error': {
-        title: 'MCP protocol error',
-        hints: [
-            'Invalid message format or unsupported protocol version',
-            'This may be a compatibility issue with the MCP server',
-            '→ Try removing and re-adding: ax-cli mcp remove <name> && ax-cli mcp add <name> --template',
-            'Check for server updates or use a different server version'
-        ]
-    },
-    'tool not found': {
-        title: 'MCP tool not found',
-        hints: [
-            'The requested tool is not available on the server',
-            '→ Run: ax-cli mcp tools <server-name> (to list available tools)',
-            'The server may need to be reconnected',
-            '→ Run: ax-cli mcp test <server-name>'
-        ]
-    },
-    // Figma-specific errors
-    'figma_access_token': {
-        title: 'Figma access token missing or invalid',
-        hints: [
-            '→ Run: ax-cli mcp add figma --template --env FIGMA_ACCESS_TOKEN=YOUR_TOKEN',
-            'Generate a new token at: https://www.figma.com/settings',
-            'Or set environment variable: export FIGMA_ACCESS_TOKEN="your_token"',
-            'Ensure the token has file read permissions'
-        ],
-        command: 'ax-cli mcp validate figma'
-    },
-    'figma': {
-        title: 'Figma MCP server error',
-        hints: [
-            '→ Run: ax-cli mcp test figma (to test connection)',
-            'Verify FIGMA_ACCESS_TOKEN is set: echo $FIGMA_ACCESS_TOKEN',
-            '→ Reinstall: ax-cli mcp remove figma && ax-cli mcp add figma --template --env FIGMA_ACCESS_TOKEN=YOUR_TOKEN',
-            'Check Figma API status: https://status.figma.com'
-        ],
-        command: 'ax-cli mcp health figma'
-    },
-    // GitHub-specific errors
-    'github_token': {
-        title: 'GitHub token missing or invalid',
-        hints: [
-            '→ Run: ax-cli mcp add github --template --env GITHUB_TOKEN=YOUR_TOKEN',
-            'Generate a new token at: https://github.com/settings/tokens',
-            'Ensure token has "repo" scope for repository access',
-            'Or set: export GITHUB_TOKEN="ghp_your_token"'
-        ],
-        command: 'ax-cli mcp validate github'
-    }
-};
-/**
- * Match an error against known patterns and return remediation info
- *
- * @param error - The error to match
- * @returns Remediation info if a pattern matches, null otherwise
- */
-export function matchErrorPattern(error) {
-    const message = error.message.toLowerCase();
-    const errorCode = error.code?.toLowerCase() || '';
-    for (const [pattern, remediation] of Object.entries(ERROR_REMEDIATION)) {
-        if (message.includes(pattern) || errorCode.includes(pattern)) {
-            return remediation;
-        }
-    }
-    return null;
-}
-/**
- * Get transport-specific troubleshooting hints when no specific error pattern matches
- *
- * @param transportType - The transport type (stdio, http, sse)
- * @returns Array of troubleshooting hints
- */
-export function getTransportHints(transportType) {
-    if (transportType === 'stdio') {
-        return [
-            'For stdio transport:',
-            '• Verify command is installed: which <command>',
-            '• Ensure args include a script path (not just the runtime)',
-            '• Example: ["@modelcontextprotocol/server-github"]',
-            '• Commands like "node" without args start a REPL and hang'
-        ];
-    }
-    if (transportType === 'http' || transportType === 'sse') {
-        return [
-            'For HTTP/SSE transport:',
-            '• Verify server is running: curl <url>/health',
-            '• Check URL is accessible from your network',
-            '• Verify SSL certificate if using HTTPS',
-            '• Check authentication headers are correct'
-        ];
-    }
-    return [
-        'General troubleshooting:',
-        '• Check the server logs for more details',
-        '• Verify all required environment variables are set',
-        '• Try running ax-cli mcp test <server-name>'
-    ];
-}
-/**
- * Get environment variable hints if the error relates to credentials
- *
- * @param errorMessage - The error message to check
- * @returns Array of environment variable hints, or empty array if not applicable
- */
-export function getEnvVarHints(errorMessage) {
-    const message = errorMessage.toLowerCase();
-    if (message.includes('api_key') || message.includes('token') || message.includes('secret')) {
-        return [
-            '',
-            'Environment variable tips:',
-            '• Set in shell: export VAR_NAME=value',
-            '• Or in .env file in project root',
-            '• Verify: echo $VAR_NAME'
-        ];
-    }
-    return [];
-}
-//# sourceMappingURL=error-remediation.js.map

package/dist/mcp/error-remediation.js.map

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

package/dist/mcp/health.d.ts

@@ -1,120 +0,0 @@
-/**
- * MCP Server Health Monitoring
- *
- * Provides health checking, status monitoring, and automatic reconnection
- * for MCP servers.
- */
-import { EventEmitter } from 'events';
-import type { MCPManager } from './client.js';
-import { ReconnectionManager, type ReconnectionStrategy } from './reconnection.js';
-/**
- * Health status for an MCP server
- */
-export interface ServerHealth {
-    /** Server name */
-    serverName: string;
-    /** Connection status */
-    connected: boolean;
-    /** Number of available tools */
-    toolCount: number;
-    /** Server uptime in milliseconds */
-    uptime?: number;
-    /** Connection start time */
-    connectedAt?: number;
-    /** Last successful call timestamp */
-    lastSuccess?: number;
-    /** Last error message */
-    lastError?: string;
-    /** Last error timestamp */
-    lastErrorAt?: number;
-    /** Total number of successful tool calls */
-    successCount: number;
-    /** Total number of failed tool calls */
-    failureCount: number;
-    /** Average latency in milliseconds */
-    avgLatency?: number;
-    /** P95 latency in milliseconds */
-    p95Latency?: number;
-    /** Success rate percentage (0-100) */
-    successRate: number;
-}
-/**
- * Health check event types
- */
-export interface HealthCheckEvents {
-    'health-check': (health: ServerHealth) => void;
-    'server-disconnected': (serverName: string) => void;
-    'server-reconnected': (serverName: string) => void;
-    'health-check-error': (serverName: string, error: Error) => void;
-}
-export declare class MCPHealthMonitor extends EventEmitter {
-    private mcpManager;
-    private healthCheckInterval;
-    private reconnectionManager;
-    private serverStats;
-    /** Get or create stats for a server */
-    private getOrCreateStats;
-    constructor(mcpManager: MCPManager, reconnectionStrategy?: ReconnectionStrategy);
-    /**
-     * Start health monitoring with specified interval
-     */
-    start(intervalMs?: number): void;
-    /**
-     * Stop health monitoring
-     */
-    stop(): void;
-    /**
-     * Clean up all resources (interval, reconnection manager, event listeners)
-     */
-    dispose(): void;
-    /**
-     * Perform health checks on all servers
-     */
-    private performHealthChecks;
-    /**
-     * Check health of a specific server
-     */
-    checkServerHealth(serverName: string): Promise<ServerHealth>;
-    /** Record a successful tool call */
-    recordSuccess(serverName: string, latencyMs: number): void;
-    /** Record a failed tool call */
-    recordFailure(serverName: string, error: string): void;
-    /**
-     * 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.
-     */
-    /**
-     * Get reconnection manager
-     */
-    getReconnectionManager(): ReconnectionManager;
-    /**
-     * Calculate percentile from array of values
-     * Returns 0 for empty arrays to distinguish from actual values
-     */
-    private calculatePercentile;
-    /**
-     * Get health report for all servers
-     */
-    getHealthReport(): Promise<ServerHealth[]>;
-    /**
-     * Get health status for a specific server
-     */
-    getServerStatus(serverName: string): Promise<ServerHealth | null>;
-    /** Reset stats for a server */
-    resetStats(serverName: string): void;
-    /**
-     * Get formatted uptime string
-     */
-    static formatUptime(uptimeMs: number): string;
-    /**
-     * Get formatted latency string
-     */
-    static formatLatency(latencyMs: number): string;
-    /**
-     * Clean up resources and remove all event listeners.
-     */
-    destroy(): void;
-}