@defai.digital/ax-cli 3.7.2 → 3.8.2

package/dist/mcp/config-v2.js

@@ -0,0 +1,417 @@
+/**
+ * Type-Safe MCP Configuration (Phase 2 Improvements)
+ *
+ * Improvements applied:
+ * 1. Result types for all functions (explicit error handling)
+ * 2. No global mutable state (class-based design)
+ * 3. Branded types for ServerName
+ * 4. Invariant checks for validation
+ * 5. Phantom types for non-empty server lists
+ *
+ * Coverage: 85% → 90% (Phase 2)
+ */
+import { getSettingsManager } from "../utils/settings-manager.js";
+import { MCPServerConfigSchema } from "../schemas/settings-schemas.js";
+import { ErrorCategory, createErrorMessage } from "../utils/error-handler.js";
+import { loadAutomatosXMCPServers, mergeConfigs, getConfigRecommendation, formatMergeResult } from "./automatosx-loader.js";
+import { migrateConfig } from "./config-migrator.js";
+import { detectConfigFormat } from "./config-detector.js";
+import { formatMCPConfigError, formatWarning, formatInfo } from "./error-formatter.js";
+// Phase 2: Import type safety utilities
+import { Ok, Err } from "./type-safety.js";
+import { createServerName, asNonEmpty } from "./type-safety.js";
+import { assertValidServerName } from "./invariants.js";
+/**
+ * Type-safe MCP Configuration Loader
+ *
+ * Phase 2 improvements:
+ * - No global mutable state (class instead of module-level variables)
+ * - Result types for all operations
+ * - Branded types for server names
+ * - Better error aggregation
+ */
+export class MCPConfigLoader {
+    hasShownMigrationWarnings = false;
+    /**
+     * Load MCP configuration from project settings with validation and auto-migration
+     *
+     * Returns Result type instead of throwing
+     */
+    loadMCPConfig() {
+        try {
+            const manager = getSettingsManager();
+            const projectSettings = manager.loadProjectSettings();
+            // Load ax-cli servers
+            const axCliRawServers = projectSettings.mcpServers
+                ? Object.values(projectSettings.mcpServers)
+                : [];
+            // Process ax-cli servers with migration
+            const axCliResult = this.processAxCliServers(axCliRawServers);
+            if (!axCliResult.success) {
+                return axCliResult;
+            }
+            const { servers: axCliServers, hadLegacy } = axCliResult.value;
+            // Load AutomatosX servers (if exists)
+            const automatosXResult = loadAutomatosXMCPServers();
+            if (automatosXResult.found && !this.hasShownMigrationWarnings) {
+                if (automatosXResult.errors.length > 0) {
+                    console.warn(formatWarning('AutomatosX config found but has errors:', automatosXResult.errors));
+                }
+                if (automatosXResult.warnings.length > 0 && process.env.DEBUG) {
+                    automatosXResult.warnings.forEach(warning => {
+                        console.warn(formatInfo(warning));
+                    });
+                }
+            }
+            // Merge configs if we have both sources
+            let finalServers;
+            if (automatosXResult.found && automatosXResult.servers.length > 0) {
+                const mergeResult = mergeConfigs(axCliServers, automatosXResult.servers);
+                finalServers = mergeResult.servers;
+                // Show merge info only in debug mode or if there are conflicts
+                if (!this.hasShownMigrationWarnings && (mergeResult.conflicts.length > 0 || process.env.DEBUG)) {
+                    if (process.env.DEBUG) {
+                        console.log(formatMergeResult(mergeResult));
+                    }
+                    const recommendation = getConfigRecommendation(mergeResult);
+                    if (recommendation && mergeResult.conflicts.length > 0) {
+                        console.warn(formatInfo(recommendation));
+                    }
+                }
+            }
+            else {
+                finalServers = axCliServers;
+            }
+            // Mark that we've shown warnings this session
+            if (hadLegacy || automatosXResult.found) {
+                this.hasShownMigrationWarnings = true;
+            }
+            return Ok({ servers: finalServers });
+        }
+        catch (error) {
+            return Err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Process ax-cli servers with auto-migration
+     */
+    processAxCliServers(rawServers) {
+        const servers = [];
+        let hadLegacy = false;
+        const errors = [];
+        for (const server of rawServers) {
+            // Detect format
+            const detection = detectConfigFormat(server);
+            if (detection.isLegacy) {
+                hadLegacy = true;
+                // Auto-migrate legacy format
+                const migration = migrateConfig(server);
+                if (migration.success && migration.migratedConfig) {
+                    servers.push(migration.migratedConfig);
+                    if (!this.hasShownMigrationWarnings) {
+                        console.warn(formatWarning(`Legacy MCP config format detected for "${server?.name || 'unknown'}"`, [
+                            'Auto-migrated to new format (temporary - not saved to file)',
+                            'Please update your config with: ax-cli mcp migrate',
+                            'See: https://docs.ax-cli.dev/mcp/migration'
+                        ]));
+                    }
+                }
+                else {
+                    // Migration failed
+                    if (detection.issues.length > 0 && !this.hasShownMigrationWarnings) {
+                        const errorMsg = formatMCPConfigError(server?.name || 'unknown', { issues: detection.issues.map(i => ({ path: [], message: i })) });
+                        console.warn(errorMsg);
+                        errors.push(errorMsg);
+                    }
+                }
+            }
+            else {
+                // Modern format - validate
+                const result = MCPServerConfigSchema.safeParse(server);
+                if (result.success && result.data) {
+                    servers.push(result.data);
+                }
+                else {
+                    // Show user-friendly error
+                    if (!this.hasShownMigrationWarnings && result.error) {
+                        const errorMsg = formatMCPConfigError(server?.name || 'unknown', result.error);
+                        console.warn(errorMsg);
+                        errors.push(errorMsg);
+                    }
+                }
+            }
+        }
+        // If we have errors but also some valid servers, continue
+        // If ALL servers failed, return error
+        if (servers.length === 0 && errors.length > 0) {
+            return Err(new Error(`All MCP servers failed validation:\n${errors.join('\n')}`));
+        }
+        return Ok({ servers, hadLegacy });
+    }
+    /**
+     * Reset migration warning flag (useful for testing)
+     */
+    resetMigrationWarnings() {
+        this.hasShownMigrationWarnings = false;
+    }
+    /**
+     * Save MCP configuration
+     */
+    saveMCPConfig(config) {
+        try {
+            const manager = getSettingsManager();
+            const mcpServers = {};
+            // Convert servers array to object keyed by name
+            for (const server of config.servers) {
+                mcpServers[server.name] = server;
+            }
+            manager.updateProjectSetting('mcpServers', mcpServers);
+            return Ok(undefined);
+        }
+        catch (error) {
+            return Err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Add MCP server with validation
+     */
+    addMCPServer(config) {
+        // Phase 2: Validate server name as branded type
+        const serverName = createServerName(config.name);
+        if (!serverName) {
+            return Err(new Error(`Invalid server name: "${config.name}"`));
+        }
+        // Validate server config before adding
+        const validationResult = MCPServerConfigSchema.safeParse(config);
+        if (!validationResult.success) {
+            return Err(new Error(createErrorMessage(ErrorCategory.VALIDATION, `Adding MCP server "${config.name}"`, validationResult.error || 'Invalid server configuration')));
+        }
+        try {
+            const manager = getSettingsManager();
+            const projectSettings = manager.loadProjectSettings();
+            const mcpServers = projectSettings.mcpServers || {};
+            // Check if server already exists
+            if (mcpServers[config.name]) {
+                return Err(new Error(`Server "${config.name}" already exists`));
+            }
+            // Type narrowing: validationResult.success is true, so data is defined
+            if (validationResult.data) {
+                mcpServers[config.name] = validationResult.data;
+                manager.updateProjectSetting('mcpServers', mcpServers);
+            }
+            return Ok(undefined);
+        }
+        catch (error) {
+            return Err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Remove MCP server
+     */
+    removeMCPServer(serverName) {
+        // Phase 2: Invariant check
+        assertValidServerName(serverName);
+        try {
+            const manager = getSettingsManager();
+            const projectSettings = manager.loadProjectSettings();
+            const mcpServers = projectSettings.mcpServers;
+            if (!mcpServers) {
+                return Err(new Error('No MCP servers configured'));
+            }
+            if (!mcpServers[serverName]) {
+                return Err(new Error(`Server ${serverName} not found`));
+            }
+            delete mcpServers[serverName];
+            manager.updateProjectSetting('mcpServers', mcpServers);
+            return Ok(undefined);
+        }
+        catch (error) {
+            return Err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Get MCP server by name
+     */
+    getMCPServer(serverName) {
+        // Phase 2: Invariant check
+        assertValidServerName(serverName);
+        try {
+            const manager = getSettingsManager();
+            const projectSettings = manager.loadProjectSettings();
+            const server = projectSettings.mcpServers?.[serverName];
+            if (!server) {
+                return Err(new Error(`Server ${serverName} not found`));
+            }
+            return Ok(server);
+        }
+        catch (error) {
+            return Err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Get all configured servers
+     *
+     * Phase 2: Returns Result type
+     */
+    getAllServers() {
+        try {
+            const manager = getSettingsManager();
+            const projectSettings = manager.loadProjectSettings();
+            const mcpServers = projectSettings.mcpServers;
+            if (!mcpServers) {
+                return Ok([]);
+            }
+            const servers = Object.values(mcpServers);
+            return Ok(servers);
+        }
+        catch (error) {
+            return Err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Get all server names
+     *
+     * Phase 2: Returns branded types
+     */
+    getAllServerNames() {
+        try {
+            const manager = getSettingsManager();
+            const projectSettings = manager.loadProjectSettings();
+            const mcpServers = projectSettings.mcpServers;
+            if (!mcpServers) {
+                return Ok([]);
+            }
+            const names = [];
+            for (const name of Object.keys(mcpServers)) {
+                const serverName = createServerName(name);
+                if (serverName) {
+                    names.push(serverName);
+                }
+            }
+            return Ok(names);
+        }
+        catch (error) {
+            return Err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Phase 2: Get non-empty list of servers
+     * Uses phantom types to prove list is non-empty
+     */
+    getNonEmptyServers() {
+        const serversResult = this.getAllServers();
+        if (!serversResult.success) {
+            return serversResult;
+        }
+        const servers = serversResult.value;
+        const nonEmpty = asNonEmpty(servers);
+        if (!nonEmpty) {
+            return Err(new Error('No MCP servers configured'));
+        }
+        return Ok(nonEmpty);
+    }
+    /**
+     * Type-safe method wrappers for tests
+     * These mirror the exported functions but as instance methods
+     */
+    getMCPServerSafe(serverName) {
+        const name = createServerName(serverName);
+        if (!name) {
+            return Err(new Error(`Invalid server name: "${serverName}"`));
+        }
+        return this.getMCPServer(name);
+    }
+    addMCPServerSafe(config) {
+        return this.addMCPServer(config);
+    }
+    removeMCPServerSafe(serverName) {
+        const name = createServerName(serverName);
+        if (!name) {
+            return Err(new Error(`Invalid server name: "${serverName}"`));
+        }
+        return this.removeMCPServer(name);
+    }
+    getNonEmptyServersSafe() {
+        return this.getNonEmptyServers();
+    }
+}
+/**
+ * Singleton instance for backward compatibility
+ */
+const configLoader = new MCPConfigLoader();
+/**
+ * Legacy function exports that wrap the class methods
+ */
+export function loadMCPConfig() {
+    const result = configLoader.loadMCPConfig();
+    if (!result.success) {
+        throw result.error;
+    }
+    return result.value;
+}
+export function resetMigrationWarnings() {
+    configLoader.resetMigrationWarnings();
+}
+export function saveMCPConfig(config) {
+    const result = configLoader.saveMCPConfig(config);
+    if (!result.success) {
+        throw result.error;
+    }
+}
+export function addMCPServer(config) {
+    const result = configLoader.addMCPServer(config);
+    if (!result.success) {
+        throw result.error;
+    }
+}
+export function removeMCPServer(serverName) {
+    const name = createServerName(serverName);
+    if (!name) {
+        throw new Error(`Invalid server name: "${serverName}"`);
+    }
+    const result = configLoader.removeMCPServer(name);
+    if (!result.success) {
+        throw result.error;
+    }
+}
+export function getMCPServer(serverName) {
+    const name = createServerName(serverName);
+    if (!name) {
+        return undefined;
+    }
+    const result = configLoader.getMCPServer(name);
+    if (!result.success) {
+        return undefined;
+    }
+    return result.value;
+}
+/**
+ * New type-safe exports (preferred for new code)
+ */
+export function loadMCPConfigSafe() {
+    return configLoader.loadMCPConfig();
+}
+export function saveMCPConfigSafe(config) {
+    return configLoader.saveMCPConfig(config);
+}
+export function addMCPServerSafe(config) {
+    return configLoader.addMCPServer(config);
+}
+export function removeMCPServerSafe(serverName) {
+    return configLoader.removeMCPServer(serverName);
+}
+export function getMCPServerSafe(serverName) {
+    return configLoader.getMCPServer(serverName);
+}
+export function getAllServersSafe() {
+    return configLoader.getAllServers();
+}
+export function getAllServerNamesSafe() {
+    return configLoader.getAllServerNames();
+}
+export function getNonEmptyServersSafe() {
+    return configLoader.getNonEmptyServers();
+}
+// Import templates
+export { TEMPLATES as PREDEFINED_SERVERS, getTemplate, hasTemplate, generateConfigFromTemplate } from './templates.js';
+//# sourceMappingURL=config-v2.js.map

package/dist/mcp/config-v2.js.map

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

package/dist/mcp/config.d.ts

@@ -3,9 +3,20 @@ export interface MCPConfig {
     servers: MCPServerConfig[];
 }
 /**
- * Load MCP configuration from project settings with validation
+ * Load MCP configuration from project settings with validation and auto-migration
+ *
+ * This function:
+ * 1. Loads configs from .ax-cli/settings.json
+ * 2. Loads configs from .automatosx/config.json (if exists)
+ * 3. Auto-migrates legacy formats
+ * 4. Merges both sources (ax-cli takes precedence)
+ * 5. Validates final configs
  */
 export declare function loadMCPConfig(): MCPConfig;
+/**
+ * Reset migration warning flag (useful for testing)
+ */
+export declare function resetMigrationWarnings(): void;
 export declare function saveMCPConfig(config: MCPConfig): void;
 export declare function addMCPServer(config: MCPServerConfig): void;
 export declare function removeMCPServer(serverName: string): void;

package/dist/mcp/config.js

@@ -1,27 +1,112 @@
 import { getSettingsManager } from "../utils/settings-manager.js";
 import { MCPServerConfigSchema } from "../schemas/settings-schemas.js";
 import { ErrorCategory, createErrorMessage } from "../utils/error-handler.js";
+import { loadAutomatosXMCPServers, mergeConfigs, getConfigRecommendation, formatMergeResult } from "./automatosx-loader.js";
+import { migrateConfig } from "./config-migrator.js";
+import { detectConfigFormat } from "./config-detector.js";
+import { formatMCPConfigError, formatWarning, formatInfo } from "./error-formatter.js";
+// Track if we've already shown migration warnings this session
+let hasShownMigrationWarnings = false;
 /**
- * Load MCP configuration from project settings with validation
+ * Load MCP configuration from project settings with validation and auto-migration
+ *
+ * This function:
+ * 1. Loads configs from .ax-cli/settings.json
+ * 2. Loads configs from .automatosx/config.json (if exists)
+ * 3. Auto-migrates legacy formats
+ * 4. Merges both sources (ax-cli takes precedence)
+ * 5. Validates final configs
  */
 export function loadMCPConfig() {
     const manager = getSettingsManager();
     const projectSettings = manager.loadProjectSettings();
-    const rawServers = projectSettings.mcpServers
+    // Load ax-cli servers
+    const axCliRawServers = projectSettings.mcpServers
         ? Object.values(projectSettings.mcpServers)
         : [];
-    // Validate each server config
-    const validatedServers = [];
-    for (const server of rawServers) {
-        const result = MCPServerConfigSchema.safeParse(server);
-        if (result.success && result.data) {
-            validatedServers.push(result.data);
+    // Process ax-cli servers with migration
+    const axCliServers = [];
+    let axCliHadLegacy = false;
+    for (const server of axCliRawServers) {
+        // Detect format
+        const detection = detectConfigFormat(server);
+        if (detection.isLegacy) {
+            axCliHadLegacy = true;
+            // Auto-migrate legacy format
+            const migration = migrateConfig(server);
+            if (migration.success && migration.migratedConfig) {
+                axCliServers.push(migration.migratedConfig);
+                if (!hasShownMigrationWarnings) {
+                    console.warn(formatWarning(`Legacy MCP config format detected for "${server?.name || 'unknown'}"`, [
+                        'Auto-migrated to new format (temporary - not saved to file)',
+                        'Please update your config with: ax-cli mcp migrate',
+                        'See: https://docs.ax-cli.dev/mcp/migration'
+                    ]));
+                }
+            }
+            else {
+                // Migration failed - use formatted error
+                if (detection.issues.length > 0 && !hasShownMigrationWarnings) {
+                    console.warn(formatMCPConfigError(server?.name || 'unknown', { issues: detection.issues.map(i => ({ path: [], message: i })) }));
+                }
+            }
         }
         else {
-            console.warn(createErrorMessage(ErrorCategory.VALIDATION, `MCP server config validation for "${server?.name || 'unknown'}"`, result.error || 'Invalid configuration'));
+            // Modern format - validate
+            const result = MCPServerConfigSchema.safeParse(server);
+            if (result.success && result.data) {
+                axCliServers.push(result.data);
+            }
+            else {
+                // Show user-friendly error instead of technical validation error
+                if (!hasShownMigrationWarnings && result.error) {
+                    console.warn(formatMCPConfigError(server?.name || 'unknown', result.error));
+                }
+            }
         }
     }
-    return { servers: validatedServers };
+    // Load AutomatosX servers (if exists)
+    const automatosXResult = loadAutomatosXMCPServers();
+    if (automatosXResult.found && !hasShownMigrationWarnings) {
+        if (automatosXResult.errors.length > 0) {
+            console.warn(formatWarning('AutomatosX config found but has errors:', automatosXResult.errors));
+        }
+        if (automatosXResult.warnings.length > 0 && process.env.DEBUG) {
+            automatosXResult.warnings.forEach(warning => {
+                console.warn(formatInfo(warning));
+            });
+        }
+    }
+    // Merge configs if we have both sources
+    let finalServers;
+    if (automatosXResult.found && automatosXResult.servers.length > 0) {
+        const mergeResult = mergeConfigs(axCliServers, automatosXResult.servers);
+        finalServers = mergeResult.servers;
+        // Show merge info only in debug mode or if there are conflicts
+        if (!hasShownMigrationWarnings && (mergeResult.conflicts.length > 0 || process.env.DEBUG)) {
+            if (process.env.DEBUG) {
+                console.log(formatMergeResult(mergeResult));
+            }
+            const recommendation = getConfigRecommendation(mergeResult);
+            if (recommendation && mergeResult.conflicts.length > 0) {
+                console.warn(formatInfo(recommendation));
+            }
+        }
+    }
+    else {
+        finalServers = axCliServers;
+    }
+    // Mark that we've shown warnings this session
+    if (axCliHadLegacy || automatosXResult.found) {
+        hasShownMigrationWarnings = true;
+    }
+    return { servers: finalServers };
+}
+/**
+ * Reset migration warning flag (useful for testing)
+ */
+export function resetMigrationWarnings() {
+    hasShownMigrationWarnings = false;
 }
 export function saveMCPConfig(config) {
     const manager = getSettingsManager();

package/dist/mcp/config.js.map

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

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

@@ -0,0 +1,46 @@
+/**
+ * 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?: any): 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 function formatWarning(message: string, details?: string[]): string;
+/**
+ * Format a success message
+ */
+export declare function formatSuccess(message: string, details?: string[]): string;
+/**
+ * Format info message
+ */
+export declare function formatInfo(message: string, details?: string[]): string;