@defai.digital/ax-cli 3.15.10 → 3.15.11

package/dist/mcp/error-formatter.js

@@ -5,6 +5,7 @@
  * 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
  */
@@ -86,7 +87,10 @@ function getHintsForField(field, originalConfig) {
             break;
         default:
             if (field.startsWith('transport.')) {
-                hints.push(`Check the ${field.split('.')[1]} field in your transport configuration`);
+                // 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;
@@ -148,234 +152,27 @@ export function formatConnectionError(serverName, error, transportType) {
     lines.push(chalk.red('╰────────────────────────────────────────────────╯'));
     return lines.join('\n');
 }
-/**
- * Comprehensive error code to remediation mapping
- * Maps error codes/patterns to specific troubleshooting steps
- */
-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',
-            'Check environment variable is set: echo $<VAR_NAME>',
-            'Regenerate the API key if expired',
-            'Verify the token has required permissions'
-        ]
-    },
-    '403': {
-        title: 'Access forbidden',
-        hints: [
-            'You don\'t have permission to access this resource',
-            'Check if your API key has the required scopes',
-            'Verify the account has access to this feature',
-            'Contact the service provider for access'
-        ]
-    },
-    // 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',
-            'Verify the server version is compatible',
-            'Try running: ax-cli mcp test <server-name>'
-        ]
-    },
-    'protocol error': {
-        title: 'MCP protocol error',
-        hints: [
-            'Invalid message format or unsupported protocol version',
-            'Ensure the server implements MCP protocol correctly',
-            'Check for server updates',
-            'Verify client and server versions are compatible'
-        ]
-    },
-    'tool not found': {
-        title: 'MCP tool not found',
-        hints: [
-            'The requested tool is not available on the server',
-            'List available tools: ax-cli mcp tools <server-name>',
-            'The server may need to be restarted',
-            'Check if the tool requires additional configuration'
-        ]
-    }
-};
 /**
  * Get hints for connection errors
- * Enhanced with comprehensive error code mapping
+ * Uses extracted error remediation module for pattern matching
  */
 function getConnectionErrorHints(error, transportType) {
     const hints = [];
-    const message = error.message.toLowerCase();
-    const errorCode = error.code?.toLowerCase() || '';
-    // Check for specific error codes first
-    for (const [pattern, remediation] of Object.entries(ERROR_REMEDIATION)) {
-        if (message.includes(pattern) || errorCode.includes(pattern)) {
-            hints.push(`${chalk.bold(remediation.title)}`);
-            hints.push(...remediation.hints);
-            if (remediation.command) {
-                hints.push(`Debug command: ${chalk.cyan(remediation.command)}`);
-            }
-            break;
+    // 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) {
-        if (transportType === 'stdio') {
-            hints.push('For stdio transport:');
-            hints.push('• Verify command is installed: which <command>');
-            hints.push('• Ensure args include a script path (not just the runtime)');
-            hints.push('• Example: ["@modelcontextprotocol/server-github"]');
-            hints.push('• Commands like "node" without args start a REPL and hang');
-        }
-        else if (transportType === 'http' || transportType === 'sse') {
-            hints.push('For HTTP/SSE transport:');
-            hints.push('• Verify server is running: curl <url>/health');
-            hints.push('• Check URL is accessible from your network');
-            hints.push('• Verify SSL certificate if using HTTPS');
-            hints.push('• Check authentication headers are correct');
-        }
-        else {
-            hints.push('General troubleshooting:');
-            hints.push('• Check the server logs for more details');
-            hints.push('• Verify all required environment variables are set');
-            hints.push('• Try running ax-cli mcp test <server-name>');
-        }
+        hints.push(...getTransportHints(transportType));
     }
     // Add environment variable hints if relevant
-    if (message.includes('api_key') || message.includes('token') || message.includes('secret')) {
-        hints.push('');
-        hints.push('Environment variable tips:');
-        hints.push('• Set in shell: export VAR_NAME=value');
-        hints.push('• Or in .env file in project root');
-        hints.push('• Verify: echo $VAR_NAME');
-    }
+    hints.push(...getEnvVarHints(error.message));
     return hints;
 }
 /**

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

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

@@ -0,0 +1,45 @@
+/**
+ * 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

@@ -0,0 +1,254 @@
+/**
+ * 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',
+            'Check environment variable is set: echo $<VAR_NAME>',
+            'Regenerate the API key if expired',
+            'Verify the token has required permissions'
+        ]
+    },
+    '403': {
+        title: 'Access forbidden',
+        hints: [
+            'You don\'t have permission to access this resource',
+            'Check if your API key has the required scopes',
+            'Verify the account has access to this feature',
+            'Contact the service provider for access'
+        ]
+    },
+    // 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',
+            'Verify the server version is compatible',
+            'Try running: ax-cli mcp test <server-name>'
+        ]
+    },
+    'protocol error': {
+        title: 'MCP protocol error',
+        hints: [
+            'Invalid message format or unsupported protocol version',
+            'Ensure the server implements MCP protocol correctly',
+            'Check for server updates',
+            'Verify client and server versions are compatible'
+        ]
+    },
+    'tool not found': {
+        title: 'MCP tool not found',
+        hints: [
+            'The requested tool is not available on the server',
+            'List available tools: ax-cli mcp tools <server-name>',
+            'The server may need to be restarted',
+            'Check if the tool requires additional configuration'
+        ]
+    }
+};
+/**
+ * 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

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

package/dist/mcp/index.d.ts

@@ -16,24 +16,35 @@
  * All new code should use `MCPManagerV2` for better type safety.
  * `MCPManager` is maintained for SDK backward compatibility.
  *
+ * ## Export Organization
+ *
+ * Exports are grouped by domain:
+ * 1. Core API (v1 legacy + v2 recommended)
+ * 2. Configuration (loading, templates, migration)
+ * 3. Transports (stdio, HTTP, SSE)
+ * 4. Features (progress, cancellation, subscriptions, validation)
+ * 5. Utilities (type safety, resources, prompts)
+ * 6. Z.AI Integration (templates, detection)
+ *
  * @packageDocumentation
  */
 export { MCPManager } from "./client.js";
 export type { MCPTool, MCPServerConfig, MCPTransportConfig } from "./client.js";
 export { MCPManagerV2, createServerName, createToolName, type ConnectionState, type ReconnectionConfig, type MCPPrompt, } from "./client-v2.js";
 export type { ServerName, ToolName } from "./client-v2.js";
-export { parseMCPIdentifier, // Shared utility for parsing MCP identifiers
-promptToSlashCommand, parsePromptCommand, formatPromptResult, getPromptDescription, } from "./prompts.js";
 export { loadMCPConfig, addMCPServer, removeMCPServer, PREDEFINED_SERVERS, getTemplate, generateConfigFromTemplate, } from "./config.js";
 export type { MCPConfig } from "./config.js";
-export { createTransport, type MCPTransport, type TransportType, type TransportConfig, type StdioFraming, } from "./transports.js";
 export { detectConfigFormat, detectMultipleConfigs, getDetectionSummary } from "./config-detector.js";
 export { migrateConfig, batchMigrateConfigs, formatBatchMigrationResult } from "./config-migrator.js";
-export { Result, Ok, Err } from "./type-safety.js";
-export { resolveMCPReferences, extractMCPReferences } from "./resources.js";
+export { createTransport, type MCPTransport, type TransportType, type TransportConfig, type StdioFraming, } from "./transports.js";
 export { ProgressTracker, getProgressTracker, resetProgressTracker, formatProgress, formatElapsedTime, type ProgressUpdate, type ProgressCallback, } from "./progress.js";
 export { CancellationManager, getCancellationManager, resetCancellationManager, isRequestCancelled, createCancellationError, CANCELLED_ERROR_CODE, type CancellableRequest, type CancellationResult, } from "./cancellation.js";
 export { SubscriptionManager, getSubscriptionManager, resetSubscriptionManager, type ResourceSubscription, } from "./subscriptions.js";
 export { ToolOutputValidator, getToolOutputValidator, resetToolOutputValidator, type SchemaValidationResult, type SchemaValidationStatus, } from "./schema-validator.js";
+export { MCP_TIMEOUTS, MCP_LIMITS, MCP_ERROR_CODES, MCP_RECONNECTION, MCP_TRANSPORT_DEFAULTS, MCP_PATTERNS, } from "./constants.js";
+export { Result, Ok, Err, toError } from "./type-safety.js";
+export { matchErrorPattern, getTransportHints, getEnvVarHints, ERROR_REMEDIATION, type Remediation } from "./error-remediation.js";
+export { resolveMCPReferences, extractMCPReferences } from "./resources.js";
+export { parseMCPIdentifier, promptToSlashCommand, parsePromptCommand, formatPromptResult, getPromptDescription, } from "./prompts.js";
 export { ZAI_SERVER_NAMES, ZAI_ENDPOINTS, ZAI_VISION_PACKAGE, ZAI_MCP_TEMPLATES, ZAI_QUOTA_LIMITS, generateZAIServerConfig, getAllZAIServerNames, isZAIServer, getZAITemplate, type ZAIServerName, type ZAIPlanTier, type ZAIMCPTemplate, } from "./zai-templates.js";
 export { detectZAIServices, getEnabledZAIServers, validateZAIApiKey, getZAIApiKey, isZAIMCPConfigured, getRecommendedServers, isGLMModel, isZAIBaseURL, formatZAIStatus, type ZAIServiceStatus, } from "./zai-detector.js";