@defai.digital/ax-cli 3.7.2 → 3.8.1

package/dist/utils/enhanced-error-messages.js

@@ -0,0 +1,420 @@
+/**
+ * Enhanced Error Messages
+ * Provides user-friendly, actionable error messages with clear recovery paths
+ * Phase 5: Error Message Improvements
+ */
+import { ErrorCategory } from './error-handler.js';
+/**
+ * Common file operation error patterns
+ */
+const FILE_ERROR_PATTERNS = {
+    ENOENT: {
+        title: 'File or Directory Not Found',
+        description: 'The specified path does not exist',
+        suggestions: [
+            'Check if the file path is correct',
+            'Verify the file exists using: ls <directory>',
+            'Use absolute paths to avoid confusion',
+            'Check for typos in the file name',
+        ],
+    },
+    EACCES: {
+        title: 'Permission Denied',
+        description: 'You do not have permission to access this file',
+        suggestions: [
+            'Check file permissions using: ls -la <file>',
+            'Ensure you have read/write access',
+            'Try running with appropriate permissions',
+            'Contact your system administrator if needed',
+        ],
+    },
+    EISDIR: {
+        title: 'Expected File, Got Directory',
+        description: 'The path points to a directory, not a file',
+        suggestions: [
+            'Specify a file path instead of a directory',
+            'Use ls to list directory contents',
+            'Add a filename to the end of the path',
+        ],
+    },
+    ENOTDIR: {
+        title: 'Expected Directory, Got File',
+        description: 'The path points to a file, not a directory',
+        suggestions: [
+            'Specify a directory path instead of a file',
+            'Remove the filename from the path',
+            'Check the path structure',
+        ],
+    },
+    EEXIST: {
+        title: 'File Already Exists',
+        description: 'Cannot create file because it already exists',
+        suggestions: [
+            'Choose a different filename',
+            'Delete the existing file first (use with caution)',
+            'Use str_replace to modify the existing file instead',
+        ],
+    },
+    EMFILE: {
+        title: 'Too Many Open Files',
+        description: 'System has reached the limit of open files',
+        suggestions: [
+            'Close some open files or processes',
+            'Increase system file descriptor limit',
+            'Check for file handle leaks in running processes',
+        ],
+    },
+    ENOSPC: {
+        title: 'No Space Left on Device',
+        description: 'The disk is full',
+        suggestions: [
+            'Free up disk space by deleting unnecessary files',
+            'Check disk usage with: df -h',
+            'Move files to a different location',
+            'Clean up temporary files',
+        ],
+    },
+};
+/**
+ * API error templates
+ */
+const API_ERROR_PATTERNS = {
+    400: {
+        title: 'Bad Request',
+        description: 'The API request was malformed or invalid',
+        suggestions: [
+            'Check the request parameters',
+            'Verify the model name is correct',
+            'Ensure the input is properly formatted',
+            'Review the API documentation',
+        ],
+    },
+    401: {
+        title: 'Authentication Failed',
+        description: 'Your API key is invalid or missing',
+        suggestions: [
+            'Run "ax setup" to configure your API key',
+            'Verify your API key at the provider dashboard',
+            'Check if your API key has expired',
+            'Ensure the API key matches your provider',
+        ],
+        learnMore: 'https://docs.ax-cli.dev/configuration#api-keys',
+    },
+    403: {
+        title: 'Access Forbidden',
+        description: 'You do not have permission to access this resource',
+        suggestions: [
+            'Verify your account has access to this model',
+            'Check your subscription plan',
+            'Ensure your API key has the correct permissions',
+            'Contact your provider support',
+        ],
+    },
+    404: {
+        title: 'Resource Not Found',
+        description: 'The requested model or endpoint does not exist',
+        suggestions: [
+            'Verify the model name using: ax models',
+            'Check the base URL in your configuration',
+            'Ensure the provider supports this model',
+            'Update to the latest version of ax-cli',
+        ],
+    },
+    429: {
+        title: 'Rate Limit Exceeded',
+        description: 'You have sent too many requests in a short period',
+        suggestions: [
+            'Wait a few minutes before retrying',
+            'Check your rate limits at the provider dashboard',
+            'Consider upgrading your API plan',
+            'Reduce the frequency of requests',
+        ],
+        learnMore: 'https://docs.ax-cli.dev/troubleshooting#rate-limits',
+    },
+    500: {
+        title: 'Server Error',
+        description: 'The API server encountered an internal error',
+        suggestions: [
+            'Wait a few moments and try again',
+            'Check provider status page for outages',
+            'Try again with a smaller request',
+            'Contact provider support if it persists',
+        ],
+    },
+    502: {
+        title: 'Bad Gateway',
+        description: 'The API gateway received an invalid response',
+        suggestions: [
+            'This is a temporary provider issue',
+            'Wait a few moments and try again',
+            'Check provider status page',
+        ],
+    },
+    503: {
+        title: 'Service Unavailable',
+        description: 'The API service is temporarily unavailable',
+        suggestions: [
+            'The provider may be experiencing high load',
+            'Wait a few minutes and try again',
+            'Check provider status page for updates',
+        ],
+    },
+    504: {
+        title: 'Gateway Timeout',
+        description: 'The request took too long to complete',
+        suggestions: [
+            'Try reducing the complexity of your request',
+            'Split large operations into smaller chunks',
+            'Check your internet connection',
+            'Try again in a few moments',
+        ],
+    },
+};
+/**
+ * MCP error templates
+ */
+const MCP_ERROR_PATTERNS = {
+    CONNECTION_FAILED: {
+        title: 'MCP Server Connection Failed',
+        description: 'Unable to connect to the MCP server',
+        suggestions: [
+            'Check if the MCP server is running',
+            'Verify the server configuration in .ax-cli/settings.json',
+            'Ensure the server command/URL is correct',
+            'Check server logs for errors',
+            'Try restarting the MCP server',
+        ],
+        learnMore: 'https://docs.ax-cli.dev/mcp#troubleshooting',
+    },
+    INVALID_RESPONSE: {
+        title: 'Invalid MCP Server Response',
+        description: 'The MCP server returned an unexpected response',
+        suggestions: [
+            'Ensure the MCP server is up to date',
+            'Check server logs for errors',
+            'Verify the server implements the MCP protocol correctly',
+            'Try restarting the MCP server',
+        ],
+    },
+    TIMEOUT: {
+        title: 'MCP Server Timeout',
+        description: 'The MCP server did not respond in time',
+        suggestions: [
+            'Check if the server is overloaded',
+            'Increase the timeout in settings',
+            'Verify the server is running properly',
+            'Try restarting the MCP server',
+        ],
+    },
+};
+/**
+ * Bash command error templates
+ */
+const BASH_ERROR_PATTERNS = {
+    COMMAND_NOT_FOUND: {
+        title: 'Command Not Found',
+        description: 'The specified command is not available',
+        suggestions: [
+            'Install the required command',
+            'Check if the command is in your PATH',
+            'Verify the command name is correct',
+            'Try using the full path to the command',
+        ],
+    },
+    EXIT_CODE_1: {
+        title: 'Command Failed',
+        description: 'The command exited with an error',
+        suggestions: [
+            'Check the command output above for details',
+            'Verify command arguments are correct',
+            'Ensure required files/resources exist',
+            'Try running the command manually to debug',
+        ],
+    },
+    SECURITY_VIOLATION: {
+        title: 'Security Restriction',
+        description: 'This command is blocked for security reasons',
+        suggestions: [
+            'Use allowed commands only',
+            'Check security settings in .ax-cli/settings.json',
+            'Avoid destructive operations without confirmation',
+            'Use safe alternatives when available',
+        ],
+        learnMore: 'https://docs.ax-cli.dev/security#command-restrictions',
+    },
+};
+/**
+ * Format an error message with user-friendly structure
+ */
+export function formatEnhancedError(category, operation, errorMessage, options) {
+    const template = getErrorTemplate(category, errorMessage, options);
+    if (!template) {
+        // Fallback to standard error message
+        return `[${category}] ${operation} failed: ${errorMessage}`;
+    }
+    // Build enhanced error message
+    const parts = [];
+    // Header with emoji icon
+    const icon = getErrorIcon(category);
+    parts.push(`${icon} ${template.title}\n`);
+    // Operation context
+    parts.push(`Operation: ${operation}`);
+    // File path if provided
+    if (options?.filePath) {
+        parts.push(`File: ${options.filePath}`);
+    }
+    // Description
+    parts.push(`\n${template.description}`);
+    // Original error if different from description
+    if (!template.description.includes(errorMessage) && errorMessage.length < 200) {
+        parts.push(`Error: ${errorMessage}`);
+    }
+    // Additional details if provided
+    if (options?.details) {
+        parts.push(`Details: ${options.details}`);
+    }
+    // Suggestions
+    if (template.suggestions.length > 0) {
+        parts.push('\n💡 How to fix:');
+        template.suggestions.forEach((suggestion, idx) => {
+            parts.push(`   ${idx + 1}. ${suggestion}`);
+        });
+    }
+    // Learn more link
+    if (template.learnMore) {
+        parts.push(`\n📚 Learn more: ${template.learnMore}`);
+    }
+    return parts.join('\n');
+}
+/**
+ * Get error template based on category and error message
+ */
+function getErrorTemplate(category, errorMessage, options) {
+    const lowerError = errorMessage.toLowerCase();
+    // File operations
+    if (category === ErrorCategory.FILE_OPERATION) {
+        // Check for specific error codes
+        for (const [code, template] of Object.entries(FILE_ERROR_PATTERNS)) {
+            if (lowerError.includes(code.toLowerCase()) ||
+                errorMessage.includes(code)) {
+                return template;
+            }
+        }
+        // Pattern matching
+        if (lowerError.includes('not found') || lowerError.includes('no such file')) {
+            return FILE_ERROR_PATTERNS.ENOENT;
+        }
+        if (lowerError.includes('permission') || lowerError.includes('access denied')) {
+            return FILE_ERROR_PATTERNS.EACCES;
+        }
+        if (lowerError.includes('is a directory')) {
+            return FILE_ERROR_PATTERNS.EISDIR;
+        }
+        if (lowerError.includes('already exists')) {
+            return FILE_ERROR_PATTERNS.EEXIST;
+        }
+    }
+    // API errors
+    if (category === ErrorCategory.API_ERROR ||
+        category === ErrorCategory.AUTHENTICATION ||
+        category === ErrorCategory.RATE_LIMIT) {
+        if (options?.statusCode && API_ERROR_PATTERNS[options.statusCode]) {
+            return API_ERROR_PATTERNS[options.statusCode];
+        }
+    }
+    // MCP errors
+    if (category === ErrorCategory.MCP_CONNECTION) {
+        if (lowerError.includes('connection') || lowerError.includes('connect')) {
+            return MCP_ERROR_PATTERNS.CONNECTION_FAILED;
+        }
+        if (lowerError.includes('timeout')) {
+            return MCP_ERROR_PATTERNS.TIMEOUT;
+        }
+        if (lowerError.includes('invalid') || lowerError.includes('unexpected')) {
+            return MCP_ERROR_PATTERNS.INVALID_RESPONSE;
+        }
+    }
+    // Bash errors
+    if (category === ErrorCategory.BASH_COMMAND) {
+        if (lowerError.includes('command not found') || lowerError.includes('not found')) {
+            return BASH_ERROR_PATTERNS.COMMAND_NOT_FOUND;
+        }
+        if (lowerError.includes('security') || lowerError.includes('blocked')) {
+            return BASH_ERROR_PATTERNS.SECURITY_VIOLATION;
+        }
+        if (lowerError.includes('exit code 1') || errorMessage.includes('code 1')) {
+            return BASH_ERROR_PATTERNS.EXIT_CODE_1;
+        }
+    }
+    return null;
+}
+/**
+ * Get emoji icon for error category
+ */
+function getErrorIcon(category) {
+    switch (category) {
+        case ErrorCategory.FILE_OPERATION:
+            return '📁';
+        case ErrorCategory.BASH_COMMAND:
+            return '⚡';
+        case ErrorCategory.MCP_CONNECTION:
+            return '🔌';
+        case ErrorCategory.API_ERROR:
+        case ErrorCategory.AUTHENTICATION:
+            return '🔑';
+        case ErrorCategory.RATE_LIMIT:
+            return '⏱️';
+        case ErrorCategory.NETWORK:
+            return '🌐';
+        case ErrorCategory.CONFIGURATION:
+            return '⚙️';
+        case ErrorCategory.VALIDATION:
+            return '✅';
+        case ErrorCategory.TIMEOUT:
+            return '⌛';
+        default:
+            return '❌';
+    }
+}
+/**
+ * Create a user-friendly error for common scenarios
+ */
+export function createFriendlyError(category, operation, error, options) {
+    // Extract error message and code
+    let errorMessage;
+    let errorCode;
+    let statusCode;
+    if (error instanceof Error) {
+        errorMessage = error.message;
+        // Try to extract error code from Error
+        const err = error;
+        errorCode = err.code;
+        statusCode = err.statusCode || err.status;
+    }
+    else if (typeof error === 'object' && error !== null) {
+        const err = error;
+        errorMessage = err.message || err.error?.message || JSON.stringify(error);
+        errorCode = err.code || err.error?.code;
+        statusCode = err.status || err.statusCode || err.error?.status;
+    }
+    else {
+        errorMessage = String(error);
+    }
+    return formatEnhancedError(category, operation, errorMessage, {
+        ...options,
+        errorCode,
+        statusCode,
+    });
+}
+/**
+ * Quick helper functions for common error scenarios
+ */
+export const FriendlyErrors = {
+    fileNotFound: (filePath) => formatEnhancedError(ErrorCategory.FILE_OPERATION, 'Read file', 'ENOENT', { filePath }),
+    permissionDenied: (filePath) => formatEnhancedError(ErrorCategory.FILE_OPERATION, 'Access file', 'EACCES', { filePath }),
+    apiKeyInvalid: () => formatEnhancedError(ErrorCategory.AUTHENTICATION, 'API request', 'Invalid API key', { statusCode: 401 }),
+    rateLimitExceeded: () => formatEnhancedError(ErrorCategory.RATE_LIMIT, 'API request', 'Rate limit exceeded', { statusCode: 429 }),
+    mcpConnectionFailed: (serverName) => formatEnhancedError(ErrorCategory.MCP_CONNECTION, `Connect to ${serverName}`, 'Connection failed', { details: `MCP server "${serverName}" is not responding` }),
+    commandNotFound: (command) => formatEnhancedError(ErrorCategory.BASH_COMMAND, `Execute command`, 'command not found', { details: `Command "${command}" is not available` }),
+};
+//# sourceMappingURL=enhanced-error-messages.js.map

package/dist/utils/enhanced-error-messages.js.map

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

package/dist/utils/error-handler.d.ts

@@ -1,6 +1,7 @@
 /**
  * Centralized error handling utilities
  * Provides consistent error messages and logging
+ * Phase 5: Enhanced with user-friendly error messages
  */
 import { ToolResult } from '../types/index.js';
 /**
@@ -23,13 +24,22 @@ export declare enum ErrorCategory {
 }
 /**
  * Create a standardized error message
- * Phase 3: Enhanced with actionable suggestions
+ * Phase 5: Enhanced with user-friendly formatting
  */
-export declare function createErrorMessage(category: ErrorCategory, operation: string, error: unknown): string;
+export declare function createErrorMessage(category: ErrorCategory, operation: string, error: unknown, options?: {
+    filePath?: string;
+    details?: string;
+    useEnhancedFormat?: boolean;
+}): string;
 /**
  * Create a standardized ToolResult error
+ * Phase 5: Enhanced with optional file path
  */
-export declare function createToolError(category: ErrorCategory, operation: string, error: unknown): ToolResult;
+export declare function createToolError(category: ErrorCategory, operation: string, error: unknown, options?: {
+    filePath?: string;
+    details?: string;
+    useEnhancedFormat?: boolean;
+}): ToolResult;
 /**
  * Create a standardized ToolResult success
  */

package/dist/utils/error-handler.js

@@ -1,7 +1,9 @@
 /**
  * Centralized error handling utilities
  * Provides consistent error messages and logging
+ * Phase 5: Enhanced with user-friendly error messages
  */
+import { createFriendlyError } from './enhanced-error-messages.js';
 /**
  * Standard error categories
  */
@@ -69,9 +71,18 @@ function getErrorSuggestion(category, errorMessage) {
 }
 /**
  * Create a standardized error message
- * Phase 3: Enhanced with actionable suggestions
+ * Phase 5: Enhanced with user-friendly formatting
  */
-export function createErrorMessage(category, operation, error) {
+export function createErrorMessage(category, operation, error, options) {
+    // Use enhanced formatting by default for better UX
+    const useEnhanced = options?.useEnhancedFormat !== false;
+    if (useEnhanced) {
+        return createFriendlyError(category, operation, error, {
+            filePath: options?.filePath,
+            details: options?.details,
+        });
+    }
+    // Legacy format (kept for backwards compatibility)
     const errorMsg = extractErrorMessage(error);
     const baseMessage = `[${category}] ${operation} failed: ${errorMsg}`;
     // Add suggestion if available
@@ -83,11 +94,12 @@ export function createErrorMessage(category, operation, error) {
 }
 /**
  * Create a standardized ToolResult error
+ * Phase 5: Enhanced with optional file path
  */
-export function createToolError(category, operation, error) {
+export function createToolError(category, operation, error, options) {
     return {
         success: false,
-        error: createErrorMessage(category, operation, error),
+        error: createErrorMessage(category, operation, error, options),
     };
 }
 /**

package/dist/utils/error-handler.js.map

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

package/dist/utils/external-editor.d.ts

@@ -0,0 +1,47 @@
+/**
+ * External Editor Integration (Phase 2: P2.3)
+ *
+ * Opens user's preferred $EDITOR to compose or edit messages.
+ * Supports safety checks and temporary file cleanup.
+ */
+/**
+ * Result of external editor operation
+ */
+export interface ExternalEditorResult {
+    success: boolean;
+    content?: string;
+    error?: string;
+    cancelled?: boolean;
+}
+/**
+ * Options for opening external editor
+ */
+export interface ExternalEditorOptions {
+    initialContent?: string;
+    editor?: string;
+    fileExtension?: string;
+    timeout?: number;
+}
+/**
+ * Get the preferred editor from environment
+ * Falls back to sensible defaults based on platform
+ */
+export declare function getPreferredEditor(): string;
+/**
+ * Open external editor and return edited content
+ *
+ * @param options Editor options
+ * @returns Result containing edited content or error
+ */
+export declare function openExternalEditor(options?: ExternalEditorOptions): Promise<ExternalEditorResult>;
+/**
+ * Check if external editor is available
+ *
+ * @param editor Optional specific editor to check
+ * @returns True if editor is available
+ */
+export declare function isEditorAvailable(editor?: string): Promise<boolean>;
+/**
+ * Get user-friendly editor name for display
+ */
+export declare function getEditorDisplayName(editor?: string): string;