fraim 2.0.270 → 2.0.272

package/dist/src/cli/commands/add-ide.js

@@ -36,63 +36,54 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.saveProviderTokenToConfig = exports.loadGlobalConfig = exports.addIDECommand = exports.runAddIDE = void 0;
+exports.loadGlobalConfig = exports.addIDECommand = exports.runAddIDE = void 0;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const prompts_1 = __importDefault(require("prompts"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
 const ide_detector_1 = require("../setup/ide-detector");
 const mcp_config_generator_1 = require("../setup/mcp-config-generator");
 const claude_code_telemetry_1 = require("../setup/claude-code-telemetry");
 const script_sync_utils_1 = require("../utils/script-sync-utils");
 const mcp_server_registry_1 = require("../mcp/mcp-server-registry");
-const get_provider_client_1 = require("../api/get-provider-client");
-const provider_prompts_1 = require("../setup/provider-prompts");
-const provider_registry_1 = require("../providers/provider-registry");
 const user_config_1 = require("../utils/user-config");
+const resolveGlobalConfigPath = () => {
+    const primary = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
+    if (fs_1.default.existsSync(primary)) {
+        try {
+            const config = JSON.parse(fs_1.default.readFileSync(primary, 'utf8'));
+            if (config && config.apiKey)
+                return primary;
+        }
+        catch {
+            return primary;
+        }
+    }
+    // The aggregate test runner sets FRAIM_USER_DIR for process isolation, while
+    // older command tests isolate by monkey-patching os.homedir(). In test mode,
+    // honor that fixture home if it already contains the config under test.
+    if (process.env.NODE_ENV === 'test') {
+        const homedirConfig = path_1.default.join(os_1.default.homedir(), '.fraim', 'config.json');
+        if (homedirConfig !== primary && fs_1.default.existsSync(homedirConfig)) {
+            return homedirConfig;
+        }
+    }
+    return primary;
+};
 const loadGlobalConfig = async () => {
-    const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
+    const globalConfigPath = resolveGlobalConfigPath();
     if (!fs_1.default.existsSync(globalConfigPath)) {
         return null;
     }
     try {
         const config = JSON.parse(fs_1.default.readFileSync(globalConfigPath, 'utf8'));
-        // Support both old and new token format
-        const tokens = config.tokens || {};
-        // Backward compatibility: map old format to new
-        // Only try to fetch provider IDs if we have a valid FRAIM key
-        if (config.apiKey) {
-            try {
-                const client = (0, get_provider_client_1.getProviderClient)();
-                const providerIds = await client.getAllProviderIds();
-                for (const id of providerIds) {
-                    const oldKey = `${id}Token`;
-                    if (config[oldKey] && !tokens[id]) {
-                        tokens[id] = config[oldKey];
-                    }
-                }
-            }
-            catch (e) {
-                // If provider client fails (network error, invalid key, etc.), 
-                // skip backward compatibility mapping and use local fallback
-                // This is fine - the config will still work with the new format
-            }
-        }
-        // Load all provider configs
-        const providerConfigs = {};
-        // New format: providerConfigs object
-        if (config.providerConfigs) {
-            Object.entries(config.providerConfigs).forEach(([key, value]) => {
-                const providerId = key.replace('Config', '');
-                providerConfigs[providerId] = value;
-            });
-        }
+        if (!config.apiKey)
+            return null;
         return {
             fraimKey: config.apiKey,
-            tokens,
             mode: config.mode,
-            providerConfigs
         };
     }
     catch (e) {
@@ -100,65 +91,7 @@ const loadGlobalConfig = async () => {
     }
 };
 exports.loadGlobalConfig = loadGlobalConfig;
-const promptForProviderTokenIfNeeded = async (providerId, isOptional = false) => {
-    const client = (0, get_provider_client_1.getProviderClient)();
-    const provider = await client.getProvider(providerId);
-    if (!provider)
-        return '';
-    if (isOptional) {
-        console.log(chalk_1.default.yellow(`\n🔑 ${provider.displayName} token (optional for conversational mode)`));
-        console.log(chalk_1.default.gray(`${provider.displayName} token enables ${provider.displayName}-specific MCP features.\n`));
-        const wantsToken = await (0, prompts_1.default)({
-            type: 'confirm',
-            name: 'addToken',
-            message: `Do you want to add a ${provider.displayName} token?`,
-            initial: false
-        });
-        if (!wantsToken.addToken) {
-            console.log(chalk_1.default.blue(`ℹ️  Skipping ${provider.displayName} token - ${provider.displayName} MCP server will not be configured`));
-            return '';
-        }
-    }
-    else {
-        console.log(chalk_1.default.yellow(`\n🔑 ${provider.displayName} token needed for MCP configuration`));
-        console.log(chalk_1.default.gray(`This is required for ${provider.displayName} MCP servers to function properly.\n`));
-    }
-    try {
-        return await (0, provider_prompts_1.promptForProviderToken)(client, providerId);
-    }
-    catch (error) {
-        if (isOptional) {
-            console.log(chalk_1.default.blue(`ℹ️  No ${provider.displayName} token provided - ${provider.displayName} MCP server will not be configured`));
-            return '';
-        }
-        console.log(chalk_1.default.red(`${provider.displayName} token is required. Exiting.`));
-        process.exit(1);
-    }
-};
-const saveProviderTokenToConfig = async (providerId, token) => {
-    const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
-    if (fs_1.default.existsSync(globalConfigPath)) {
-        try {
-            const config = JSON.parse(fs_1.default.readFileSync(globalConfigPath, 'utf8'));
-            // Use new tokens structure
-            if (!config.tokens) {
-                config.tokens = {};
-            }
-            config.tokens[providerId] = token;
-            fs_1.default.writeFileSync(globalConfigPath, JSON.stringify(config, null, 2));
-            const { getProvider } = await Promise.resolve().then(() => __importStar(require('../providers/provider-registry')));
-            const provider = await getProvider(providerId);
-            console.log(chalk_1.default.green(`✅ ${provider?.displayName || providerId} token saved to global config`));
-        }
-        catch (e) {
-            const { getProvider } = await Promise.resolve().then(() => __importStar(require('../providers/provider-registry')));
-            const provider = await getProvider(providerId);
-            console.log(chalk_1.default.yellow(`⚠️ Could not save ${provider?.displayName || providerId} token to config`));
-        }
-    }
-};
-exports.saveProviderTokenToConfig = saveProviderTokenToConfig;
-const configureIDEMCP = async (ide, fraimKey, tokens, providerConfigs) => {
+const configureIDEMCP = async (ide, fraimKey) => {
     const configPath = (0, ide_detector_1.expandPath)(ide.configPath);
     console.log(chalk_1.default.blue(`🔧 Configuring ${ide.name}...`));
     // Create backup if config exists
@@ -193,13 +126,10 @@ const configureIDEMCP = async (ide, fraimKey, tokens, providerConfigs) => {
             existingTomlContent = fs_1.default.readFileSync(configPath, 'utf8');
             console.log(chalk_1.default.gray(`  📋 Found existing TOML config`));
         }
-        const newTomlContent = await (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, tokens, providerConfigs);
+        const newTomlContent = await (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, {});
         const { getAllMCPServerIds } = await Promise.resolve().then(() => __importStar(require('../mcp/mcp-server-registry')));
         const baseServerIds = getAllMCPServerIds();
-        // Add provider server IDs from tokens
-        const providerServerIds = Object.keys(tokens).filter(id => tokens[id]);
-        const serversToAdd = [...baseServerIds, ...providerServerIds];
-        const mergeResult = (0, mcp_config_generator_1.mergeTomlMCPServers)(existingTomlContent, newTomlContent, serversToAdd);
+        const mergeResult = (0, mcp_config_generator_1.mergeTomlMCPServers)(existingTomlContent, newTomlContent, baseServerIds);
         fs_1.default.writeFileSync(configPath, mergeResult.content);
         mergeResult.addedServers.forEach(server => {
             console.log(chalk_1.default.green(`  ✅ Added ${server} MCP server`));
@@ -213,14 +143,14 @@ const configureIDEMCP = async (ide, fraimKey, tokens, providerConfigs) => {
     }
     else {
         // For JSON configs - intelligent merging
-        const newConfig = await (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, tokens, providerConfigs);
+        const newConfig = await (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, {});
         const newMCPServers = newConfig[serversKey] || newConfig.mcpServers || {};
         // Merge MCP servers intelligently
         const mergedMCPServers = { ...existingMCPServers };
         const addedServers = [];
         const updatedServers = [];
         const skippedServers = [];
-        const alwaysUpdateServers = new Set(['fraim', 'github', 'gitlab', 'jira', 'ado', 'linear']);
+        const alwaysUpdateServers = new Set(['fraim']);
         for (const [serverName, serverConfig] of Object.entries(newMCPServers)) {
             if (!existingMCPServers[serverName]) {
                 mergedMCPServers[serverName] = serverConfig;
@@ -276,7 +206,7 @@ const listSupportedIDEs = () => {
     console.log(chalk_1.default.yellow('   Gemini aliases: gemini, gemini-cli, gemini cli'));
     console.log(chalk_1.default.yellow('   GitHub Copilot CLI aliases: copilot, copilot-cli, github copilot cli'));
 };
-const promptForIDESelection = async (availableIDEs, tokens) => {
+const promptForIDESelection = async (availableIDEs) => {
     console.log(chalk_1.default.green(`✅ Found ${availableIDEs.length} IDEs that can be configured:\n`));
     availableIDEs.forEach((ide, index) => {
         const configExists = fs_1.default.existsSync((0, ide_detector_1.expandPath)(ide.configPath));
@@ -289,14 +219,6 @@ const promptForIDESelection = async (availableIDEs, tokens) => {
     for (const server of mcp_server_registry_1.BASE_MCP_SERVERS) {
         console.log(chalk_1.default.gray(`   • ${server.id} (${server.description})`));
     }
-    // Show provider servers (only if tokens exist)
-    const allProviders = await (0, provider_registry_1.getAllProviders)();
-    for (const provider of allProviders) {
-        const hasToken = tokens?.[provider.id];
-        if (hasToken && provider.mcpServer) {
-            console.log(chalk_1.default.gray(`   - ${provider.id} (${provider.description})`));
-        }
-    }
     const response = await (0, prompts_1.default)({
         type: 'text',
         name: 'selection',
@@ -334,25 +256,8 @@ const runAddIDE = async (options) => {
         console.log(chalk_1.default.yellow('💡 Please run "fraim setup" first to configure your FRAIM keys.'));
         process.exit(1);
     }
-    const platformTokens = globalConfig.tokens || {};
     const isConversationalMode = globalConfig.mode === 'conversational';
-    // Check if any provider tokens exist
-    const allProviderIds = await (0, provider_registry_1.getAllProviderIds)();
-    const hasAnyToken = allProviderIds.some(id => platformTokens[id]);
-    if (!hasAnyToken && !isConversationalMode && !options.skipTokenPrompts) {
-        console.log(chalk_1.default.yellow('⚠️ No provider tokens found in configuration.'));
-        // Prompt for first integrated provider as default
-        const integratedProviders = await (0, provider_registry_1.getProvidersWithCapability)('integrated');
-        const defaultProviderId = integratedProviders[0]?.id;
-        if (defaultProviderId) {
-            const token = await promptForProviderTokenIfNeeded(defaultProviderId, false);
-            if (token) {
-                await saveProviderTokenToConfig(defaultProviderId, token);
-                platformTokens[defaultProviderId] = token;
-            }
-        }
-    }
-    if (isConversationalMode && !hasAnyToken) {
+    if (isConversationalMode) {
         console.log(chalk_1.default.blue('ℹ️  Conversational mode: Configuring MCP without platform integration\n'));
     }
     else {
@@ -389,7 +294,7 @@ const runAddIDE = async (options) => {
         }
         else {
             // Interactive selection
-            idesToConfigure = await promptForIDESelection(detectedIDEs, platformTokens);
+            idesToConfigure = await promptForIDESelection(detectedIDEs);
         }
     }
     if (idesToConfigure.length === 0) {
@@ -403,7 +308,7 @@ const runAddIDE = async (options) => {
     };
     for (const ide of idesToConfigure) {
         try {
-            await configureIDEMCP(ide, globalConfig.fraimKey, platformTokens, globalConfig.providerConfigs);
+            await configureIDEMCP(ide, globalConfig.fraimKey);
             results.successful.push(ide.name);
             (0, user_config_1.addInstalledIde)((0, ide_detector_1.getAdapterConfigType)(ide));
         }

package/dist/src/cli/commands/add-provider.js

@@ -1,275 +1,39 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.addProviderCommand = exports.runAddProvider = void 0;
+exports.addProviderCommand = exports.runAddProvider = exports.explainAgentManagedProviderSetup = void 0;
 const commander_1 = require("commander");
-const chalk_1 = __importDefault(require("chalk"));
-const prompts_1 = __importDefault(require("prompts"));
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const child_process_1 = require("child_process");
-const mcp_config_generator_1 = require("../setup/mcp-config-generator");
-const ide_detector_1 = require("../setup/ide-detector");
-const script_sync_utils_1 = require("../utils/script-sync-utils");
-const mcp_config_generator_2 = require("../setup/mcp-config-generator");
-const provider_registry_1 = require("../providers/provider-registry");
-const provider_prompts_1 = require("../setup/provider-prompts");
-const get_provider_client_1 = require("../api/get-provider-client");
-const loadGlobalConfig = () => {
-    const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
-    if (!fs_1.default.existsSync(globalConfigPath)) {
-        return null;
-    }
-    try {
-        return JSON.parse(fs_1.default.readFileSync(globalConfigPath, 'utf8'));
-    }
-    catch (e) {
-        return null;
-    }
-};
-const saveGlobalConfig = (config) => {
-    const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
-    fs_1.default.writeFileSync(globalConfigPath, JSON.stringify(config, null, 2));
-};
-const forEachInstalledIDE = async (callback) => {
-    const detectedIDEs = (0, ide_detector_1.detectInstalledIDEs)();
-    if (detectedIDEs.length === 0) {
-        console.log(chalk_1.default.yellow('⚠️ No IDEs detected. MCP configs not updated.'));
-        return;
-    }
-    console.log(chalk_1.default.blue(`\n🔧 Updating ${detectedIDEs.length} IDE configuration(s)...\n`));
-    for (const ide of detectedIDEs) {
-        try {
-            await callback(ide, (0, ide_detector_1.expandPath)(ide.configPath));
-        }
-        catch (error) {
-            console.log(chalk_1.default.red(`❌ Failed to update ${ide.name}: ${error instanceof Error ? error.message : 'Unknown error'}`));
-        }
-    }
-};
-const writeOAuthProviderToIDEConfigs = async (provider, mcpUrl) => {
-    const urlOnlyEntry = { type: 'http', url: mcpUrl };
-    await forEachInstalledIDE(async (ide, configPath) => {
-        if (provider === 'github' && ide.configType === 'copilot-cli') {
-            console.log(chalk_1.default.gray(`Skipped ${ide.name} GitHub MCP entry (built into Copilot CLI)`));
-            return;
-        }
-        if (ide.configFormat === 'json') {
-            let ideConfig = {};
-            if (fs_1.default.existsSync(configPath)) {
-                ideConfig = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
-            }
-            const serversKey = ide.configType === 'vscode' ? 'servers' : 'mcpServers';
-            if (!ideConfig[serversKey]) {
-                ideConfig[serversKey] = {};
-            }
-            ideConfig[serversKey][provider] = ide.configType === 'copilot-cli'
-                ? { ...urlOnlyEntry, tools: ['*'] }
-                : urlOnlyEntry;
-            fs_1.default.writeFileSync(configPath, JSON.stringify(ideConfig, null, 2));
-            console.log(chalk_1.default.green(`✅ Updated ${ide.name} config`));
-        }
-        else if (ide.configFormat === 'toml') {
-            console.log(chalk_1.default.yellow(`⚠️ ${ide.name} uses TOML format — update manually: add [tools.${provider}] url = "${mcpUrl}"`));
-        }
-    });
-};
-const updateIDEConfigs = async (provider, fraimKey, token, providerConfig) => {
-    const tokenConfig = { [provider]: token };
-    const providerConfigs = providerConfig ? { [provider]: providerConfig } : {};
-    await forEachInstalledIDE(async (ide, configPath) => {
-        if (ide.configFormat === 'json') {
-            let ideConfig = {};
-            if (fs_1.default.existsSync(configPath)) {
-                ideConfig = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
-            }
-            const mcpConfig = await (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, tokenConfig, providerConfigs);
-            const serversKey = ide.configType === 'vscode' ? 'servers' : 'mcpServers';
-            if (!ideConfig[serversKey]) {
-                ideConfig[serversKey] = {};
-            }
-            const providerServerKey = provider === 'ado' ? 'ado' : provider;
-            if (mcpConfig[serversKey] && mcpConfig[serversKey][providerServerKey]) {
-                ideConfig[serversKey][providerServerKey] = mcpConfig[serversKey][providerServerKey];
-                fs_1.default.writeFileSync(configPath, JSON.stringify(ideConfig, null, 2));
-                console.log(chalk_1.default.green(`✅ Updated ${ide.name} config`));
-            }
-        }
-        else if (ide.configFormat === 'toml') {
-            const mcpConfigToml = await (0, mcp_config_generator_1.generateMCPConfig)(ide.configType, fraimKey, tokenConfig, providerConfigs);
-            if (fs_1.default.existsSync(configPath)) {
-                const existingContent = fs_1.default.readFileSync(configPath, 'utf8');
-                const serversToMerge = [provider === 'ado' ? 'ado' : provider];
-                const mergeResult = (0, mcp_config_generator_2.mergeTomlMCPServers)(existingContent, mcpConfigToml, serversToMerge);
-                fs_1.default.writeFileSync(configPath, mergeResult.content);
-                console.log(chalk_1.default.green(`✅ Updated ${ide.name} config`));
-            }
-            else {
-                console.log(chalk_1.default.yellow(`⚠️ ${ide.name} config not found, skipping`));
-            }
-        }
-    });
-};
-const offerModeSwitch = async (config) => {
-    if (config.mode === 'split') {
-        console.log(chalk_1.default.gray('\nAlready in split mode.'));
-        return;
-    }
-    console.log(chalk_1.default.blue('\n🔄 Mode Switch Available'));
-    console.log(chalk_1.default.gray('You can now use split mode (separate platforms for code and issues).'));
-    console.log(chalk_1.default.gray('Example: GitHub for code, Jira for issue tracking\n'));
-    // Skip prompt if FRAIM_AUTO_SWITCH_MODE is set (for testing)
-    const shouldSwitch = process.env.FRAIM_AUTO_SWITCH_MODE === 'true';
-    if (!shouldSwitch && !process.env.FRAIM_AUTO_SWITCH_MODE) {
-        const response = await (0, prompts_1.default)({
-            type: 'confirm',
-            name: 'switchMode',
-            message: 'Switch to split mode?',
-            initial: false
-        });
-        if (response.switchMode) {
-            config.mode = 'split';
-            saveGlobalConfig(config);
-            console.log(chalk_1.default.green('✅ Switched to split mode'));
-            console.log(chalk_1.default.gray('Run "fraim init-project" in your projects to use split mode'));
-        }
-    }
-    else if (shouldSwitch) {
-        config.mode = 'split';
-        saveGlobalConfig(config);
-        console.log(chalk_1.default.green('✅ Switched to split mode'));
-        console.log(chalk_1.default.gray('Run "fraim init-project" in your projects to use split mode'));
-    }
-};
-const runAddProvider = async (provider, options) => {
-    console.log(chalk_1.default.blue(`\n🔧 Adding ${provider.toUpperCase()} provider...\n`));
-    // Check global setup exists
-    const config = loadGlobalConfig();
-    if (!config) {
-        console.log(chalk_1.default.red('❌ Global FRAIM setup not found.'));
-        console.log(chalk_1.default.yellow('Please run: fraim setup --key=<your-fraim-key>'));
-        process.exit(1);
-    }
-    // Initialize tokens object if it doesn't exist
-    if (!config.tokens) {
-        config.tokens = {};
-    }
-    // Check if provider already configured
-    const providerName = await (0, provider_registry_1.getProviderDisplayName)(provider);
-    const hasExistingConfig = config.tokens[provider] ||
-        (provider === 'jira' && config.providerConfigs?.jiraConfig?.baseUrl) ||
-        (provider === 'ado' && config.providerConfigs?.adoConfig?.organization);
-    if (hasExistingConfig) {
-        const displayInfo = provider === 'jira' && config.providerConfigs?.jiraConfig?.baseUrl
-            ? ` (${config.providerConfigs.jiraConfig.baseUrl})`
-            : provider === 'ado' && config.providerConfigs?.adoConfig?.organization
-                ? ` (${config.providerConfigs.adoConfig.organization})`
-                : '';
-        console.log(chalk_1.default.yellow(`⚠️  ${providerName} is already configured${displayInfo}`));
-        // Skip prompt if FRAIM_FORCE_OVERWRITE is set (for testing)
-        if (!process.env.FRAIM_FORCE_OVERWRITE) {
-            const response = await (0, prompts_1.default)({
-                type: 'confirm',
-                name: 'overwrite',
-                message: `Overwrite existing ${providerName} configuration?`,
-                initial: false
-            });
-            if (!response.overwrite) {
-                console.log(chalk_1.default.gray('Cancelled.'));
-                process.exit(0);
-            }
-        }
-    }
-    // Check prerequisites for the provider's MCP server command
-    const providerDefCheck = await (0, provider_registry_1.getProvider)(provider);
-    if (providerDefCheck?.mcpServer?.type === 'stdio' && providerDefCheck.mcpServer.command && !process.env.FRAIM_SKIP_PREREQ_CHECK) {
-        const cmd = providerDefCheck.mcpServer.command;
-        // Only check non-standard commands (npx/node are assumed to be available)
-        if (!['npx', 'node', 'npm'].includes(cmd)) {
-            try {
-                (0, child_process_1.execSync)(`${cmd} --version`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
-            }
-            catch {
-                const installInstructions = {
-                    uvx: 'Install uv first: https://docs.astral.sh/uv/getting-started/installation/\n' +
-                        '   macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh\n' +
-                        '   Windows:    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"',
-                };
-                console.log(chalk_1.default.red(`\n❌ "${cmd}" is required for ${providerName} but was not found on your system.\n`));
-                console.log(chalk_1.default.yellow(installInstructions[cmd] || `Please install "${cmd}" and try again.`));
-                console.log(chalk_1.default.gray('\nAfter installing, restart your terminal and run this command again.'));
-                process.exit(1);
-            }
-        }
-    }
-    // Detect OAuth-first providers: HTTP MCP with no authHeaderTemplate means the IDE
-    // handles OAuth natively. Skip credential collection and write a URL-only IDE entry.
-    const providerDefOAuth = await (0, provider_registry_1.getProvider)(provider);
-    if (providerDefOAuth?.mcpServer?.type === 'http' &&
-        !providerDefOAuth.mcpServer.authHeaderTemplate) {
-        const mcpUrl = providerDefOAuth.mcpServer.url;
-        await writeOAuthProviderToIDEConfigs(provider, mcpUrl);
-        console.log(chalk_1.default.green(`\n✅ ${providerName} configured for IDE-native OAuth.`));
-        console.log(chalk_1.default.cyan('\n💡 Next steps:'));
-        console.log(chalk_1.default.gray('   1. Restart your IDE(s) to load the new MCP server'));
-        console.log(chalk_1.default.gray('   2. On first use, your IDE will prompt you to sign in to ' + providerName));
-        return;
-    }
-    // Get credentials using generic prompt system
-    try {
-        // Build provided tokens/configs from CLI options
-        const providedTokens = {};
-        const providedConfigs = {};
-        if (options.token) {
-            providedTokens[provider] = options.token;
-        }
-        // Handle provider-specific config options (e.g., Jira URL/email or ADO organization)
-        if (options.url || options.email || options.organization) {
-            providedConfigs[provider] = {
-                ...(options.url && { baseUrl: options.url.replace(/^https?:\/\//, '').replace(/\/$/, '') }),
-                ...(options.email && { email: options.email }),
-                ...(options.organization && { organization: options.organization })
-            };
-        }
-        // Get credentials using generic prompt system
-        const client = (0, get_provider_client_1.getProviderClient)();
-        const creds = await (0, provider_prompts_1.promptForProviderCredentials)(client, provider, providedTokens[provider], providedConfigs[provider]);
-        // Write provider MCP entry directly to IDE configs (token not stored in global config)
-        await updateIDEConfigs(provider, config.apiKey, creds.token, creds.config);
-        // Offer mode switch if adding a provider with issues capability
-        const providerDef = await (0, provider_registry_1.getProvider)(provider);
-        if (providerDef?.capabilities.includes('issues') && provider === 'jira') {
-            await offerModeSwitch(config);
-        }
-        console.log(chalk_1.default.green('\n🎉 Provider added successfully!'));
-        console.log(chalk_1.default.cyan('\n💡 Next steps:'));
-        console.log(chalk_1.default.gray('   1. Restart your IDE(s) to load new MCP servers'));
-        if (provider === 'jira' && config.mode === 'split') {
-            console.log(chalk_1.default.gray('   2. Run "fraim init-project" in your projects to use split mode'));
-        }
-    }
-    catch (error) {
-        console.log(chalk_1.default.red(`\n❌ Failed to add provider: ${error instanceof Error ? error.message : 'Unknown error'}`));
-        process.exit(1);
-    }
+const MAX_PROVIDER_LABEL_LENGTH = 80;
+const safeProviderLabel = (provider) => {
+    const sanitized = provider
+        .replace(/\p{C}/gu, '')
+        .trim()
+        .slice(0, MAX_PROVIDER_LABEL_LENGTH);
+    return sanitized || 'this provider';
+};
+const explainAgentManagedProviderSetup = (provider) => {
+    const safeProvider = safeProviderLabel(provider);
+    return {
+        provider: safeProvider,
+        changed: false,
+        exitCode: 1,
+        message: [
+            'Provider setup is managed by your FRAIM agent.',
+            `Ask your agent: Use the FRAIM connect-mcp skill to connect ${safeProvider}.`,
+            'The legacy fraim add-provider command made no changes.',
+        ].join('\n'),
+    };
+};
+exports.explainAgentManagedProviderSetup = explainAgentManagedProviderSetup;
+const runAddProvider = (provider) => {
+    const explanation = (0, exports.explainAgentManagedProviderSetup)(provider);
+    console.error(explanation.message);
+    return explanation;
 };
 exports.runAddProvider = runAddProvider;
 exports.addProviderCommand = new commander_1.Command('add-provider')
-    .description(`Add or update a provider after initial setup`)
-    .argument('<provider>', `Provider to add`)
-    .option('--token <token>', 'Provider token (will prompt if not provided)')
-    .option('--organization <organization>', 'Organization (for providers that require it)')
-    .option('--email <email>', 'Email (for providers that require it)')
-    .option('--url <url>', 'Instance URL (for providers that require it)')
-    .option('--no-validate', 'Skip token validation')
-    .action(async (provider, options) => {
-    if (!(await (0, provider_registry_1.isValidProviderId)(provider))) {
-        const allProviderIds = await (0, provider_registry_1.getAllProviderIds)();
-        console.log(chalk_1.default.red(`❌ Invalid provider: ${provider}`));
-        console.log(chalk_1.default.yellow(`Valid providers: ${allProviderIds.join(', ')}`));
-        process.exit(1);
-    }
-    await (0, exports.runAddProvider)(provider, options);
+    .description('Deprecated: provider setup is agent-managed through the FRAIM connect-mcp skill')
+    .argument('<provider>', 'Provider to connect through your FRAIM agent')
+    .action((provider) => {
+    const result = (0, exports.runAddProvider)(provider);
+    process.exitCode = result.exitCode;
 });