mcp-agent-foundry 1.1.0 → 1.3.0

package/dist/cli/setup-wizard.js

@@ -18,7 +18,7 @@ import * as path from "node:path";
 import * as os from "node:os";
 import { stringify as yamlStringify } from "yaml";
 import { getUserConfigPath, getUserConfigDir } from "../config/defaults.js";
-import { testOpenAIConnection, testGeminiConnection, testDeepSeekConnection, testZaiConnection, testKimiConnection, testOllamaConnection, testAnthropicConnection, testConnectionWithSpinner, } from "./test-connection.js";
+import { testOpenAIConnection, testGeminiConnection, testDeepSeekConnection, testZaiConnection, testKimiConnection, testKimiCodeConnection, testOllamaConnection, testAnthropicConnection, testPerplexityConnection, testOpenRouterConnection, testGroqConnection, testTogetherConnection, testFireworksConnection, testConnectionWithSpinner, } from "./test-connection.js";
 // ============================================================================
 // Constants - Updated January 2026
 // ============================================================================
@@ -32,7 +32,13 @@ const PROVIDER_ENV_VARS = {
     deepseek: "DEEPSEEK_API_KEY",
     zai: "ZAI_API_KEY",
     kimi: "KIMI_API_KEY",
+    "kimi-code": "KIMI_API_KEY", // Uses same API key as regular Kimi
     ollama: "",
+    perplexity: "PERPLEXITY_API_KEY",
+    openrouter: "OPENROUTER_API_KEY",
+    groq: "GROQ_API_KEY",
+    together: "TOGETHER_API_KEY",
+    fireworks: "FIREWORKS_API_KEY",
 };
 /**
  * Track which environment variables were configured during setup
@@ -85,6 +91,42 @@ const AVAILABLE_PROVIDERS = [
         hint: "Kimi K2.5 - Excellent coding, 1M context window",
         supportsSubscription: false,
     },
+    {
+        value: "kimi-code",
+        label: "Kimi Code",
+        hint: "Dedicated coding endpoint - uses Kimi subscription",
+        supportsSubscription: false,
+    },
+    {
+        value: "perplexity",
+        label: "Perplexity",
+        hint: "Sonar models - Web search grounded, citations",
+        supportsSubscription: false,
+    },
+    {
+        value: "openrouter",
+        label: "OpenRouter",
+        hint: "Gateway to 300+ models via single API",
+        supportsSubscription: false,
+    },
+    {
+        value: "groq",
+        label: "Groq",
+        hint: "Ultra-fast LPU inference - 18x faster",
+        supportsSubscription: false,
+    },
+    {
+        value: "together",
+        label: "Together AI",
+        hint: "200+ open models, sub-100ms latency",
+        supportsSubscription: false,
+    },
+    {
+        value: "fireworks",
+        label: "Fireworks AI",
+        hint: "Fast inference, DeepSeek/Llama hosting",
+        supportsSubscription: false,
+    },
     {
         value: "ollama",
         label: "Ollama",
@@ -157,6 +199,72 @@ const KIMI_MODELS = [
     { value: "moonshot-v1-128k", label: "Moonshot V1 128K", hint: "Stable, 128K context" },
     { value: "moonshot-v1-32k", label: "Moonshot V1 32K", hint: "Fast, 32K context" },
 ];
+/**
+ * Kimi Code models (January 2026)
+ * Separate API endpoint for coding-focused Kimi
+ * Uses Kimi subscription, no separate API credits needed
+ */
+const KIMI_CODE_MODELS = [
+    { value: "kimi-for-coding", label: "Kimi for Coding", hint: "Optimized for code generation" },
+];
+/**
+ * Perplexity models (January 2026)
+ * https://docs.perplexity.ai/
+ * Web search grounded responses with citations
+ */
+const PERPLEXITY_MODELS = [
+    { value: "sonar-deep-research", label: "Sonar Deep Research", hint: "Deep research with citations" },
+    { value: "sonar-reasoning-pro", label: "Sonar Reasoning Pro", hint: "Advanced reasoning + search" },
+    { value: "sonar-reasoning", label: "Sonar Reasoning", hint: "Reasoning with web grounding" },
+    { value: "sonar-pro", label: "Sonar Pro", hint: "Enhanced search capabilities" },
+    { value: "sonar", label: "Sonar", hint: "Fast search-grounded responses" },
+    { value: "r1-1776", label: "R1-1776", hint: "Reasoning model" },
+];
+/**
+ * OpenRouter models (January 2026)
+ * https://openrouter.ai/models
+ * Gateway to 300+ models
+ */
+const OPENROUTER_MODELS = [
+    { value: "openrouter/auto", label: "Auto", hint: "Automatically selects best model" },
+    { value: "anthropic/claude-3.5-sonnet", label: "Claude 3.5 Sonnet", hint: "Via OpenRouter" },
+    { value: "openai/gpt-4o", label: "GPT-4o", hint: "Via OpenRouter" },
+    { value: "google/gemini-pro-1.5", label: "Gemini Pro 1.5", hint: "Via OpenRouter" },
+    { value: "meta-llama/llama-3.3-70b-instruct", label: "Llama 3.3 70B", hint: "Via OpenRouter" },
+];
+/**
+ * Groq models (January 2026)
+ * https://console.groq.com/docs/models
+ * Ultra-fast LPU inference
+ */
+const GROQ_MODELS = [
+    { value: "llama-3.3-70b-versatile", label: "Llama 3.3 70B Versatile", hint: "Best all-around" },
+    { value: "llama-3.1-8b-instant", label: "Llama 3.1 8B Instant", hint: "Ultra-fast, small" },
+    { value: "mixtral-8x7b-32768", label: "Mixtral 8x7B", hint: "MoE model, 32K context" },
+    { value: "gemma2-9b-it", label: "Gemma 2 9B IT", hint: "Google's open model" },
+];
+/**
+ * Together AI models (January 2026)
+ * https://docs.together.ai/docs/inference-models
+ * 200+ open models with sub-100ms latency
+ */
+const TOGETHER_MODELS = [
+    { value: "meta-llama/Llama-3.3-70B-Instruct-Turbo", label: "Llama 3.3 70B Turbo", hint: "Fast, high quality" },
+    { value: "deepseek-ai/DeepSeek-V3", label: "DeepSeek V3", hint: "Advanced reasoning" },
+    { value: "Qwen/Qwen2.5-72B-Instruct-Turbo", label: "Qwen 2.5 72B Turbo", hint: "Strong multilingual" },
+    { value: "mistralai/Mixtral-8x22B-Instruct-v0.1", label: "Mixtral 8x22B", hint: "Large MoE model" },
+];
+/**
+ * Fireworks AI models (January 2026)
+ * https://docs.fireworks.ai/models/models
+ * Fast inference for open models
+ */
+const FIREWORKS_MODELS = [
+    { value: "accounts/fireworks/models/llama-v3p3-70b-instruct", label: "Llama 3.3 70B", hint: "Fast inference" },
+    { value: "accounts/fireworks/models/deepseek-v3", label: "DeepSeek V3", hint: "Advanced reasoning" },
+    { value: "accounts/fireworks/models/mixtral-8x22b-instruct", label: "Mixtral 8x22B", hint: "Large MoE" },
+    { value: "accounts/fireworks/models/qwen2p5-72b-instruct", label: "Qwen 2.5 72B", hint: "Multilingual" },
+];
 /**
  * Ollama local models
  */
@@ -326,6 +434,18 @@ function getProviderModels(providerName) {
             return ZAI_MODELS;
         case "kimi":
             return KIMI_MODELS;
+        case "kimi-code":
+            return KIMI_CODE_MODELS;
+        case "perplexity":
+            return PERPLEXITY_MODELS;
+        case "openrouter":
+            return OPENROUTER_MODELS;
+        case "groq":
+            return GROQ_MODELS;
+        case "together":
+            return TOGETHER_MODELS;
+        case "fireworks":
+            return FIREWORKS_MODELS;
         case "ollama":
             return OLLAMA_MODELS;
         default:
@@ -335,6 +455,34 @@ function getProviderModels(providerName) {
 function getProviderInfo(providerName) {
     return AVAILABLE_PROVIDERS.find((p) => p.value === providerName);
 }
+/**
+ * Get display name for a provider.
+ */
+function getProviderDisplayName(provider) {
+    const displayNames = {
+        anthropic: "Anthropic (Claude)",
+        openai: "OpenAI (GPT)",
+        google: "Google (Gemini)",
+        deepseek: "DeepSeek",
+        zai: "Z.AI (GLM)",
+        kimi: "Moonshot (Kimi)",
+        "kimi-code": "Kimi Code",
+        ollama: "Ollama (Local)",
+        perplexity: "Perplexity",
+        openrouter: "OpenRouter",
+        groq: "Groq",
+        together: "Together AI",
+        fireworks: "Fireworks AI",
+    };
+    return displayNames[provider] || provider;
+}
+/**
+ * Get default model for a provider.
+ */
+function getDefaultModelForProvider(provider) {
+    const models = getProviderModels(provider);
+    return models[0]?.value ?? "default";
+}
 // ============================================================================
 // Provider Configuration Functions
 // ============================================================================
@@ -737,7 +885,7 @@ async function configureKimi() {
             return {
                 access_mode: "api",
                 api_key: "${" + envVarName + "}",
-                base_url: "https://api.moonshot.cn/v1",
+                base_url: "https://api.moonshot.ai/v1",
                 default_model: defaultModel,
             };
         }
@@ -757,12 +905,347 @@ async function configureKimi() {
             return {
                 access_mode: "api",
                 api_key: "${" + envVarName + "}",
-                base_url: "https://api.moonshot.cn/v1",
+                base_url: "https://api.moonshot.ai/v1",
                 default_model: "kimi-k2-5-preview",
             };
         }
     }
 }
+/**
+ * Configure Kimi Code provider
+ *
+ * Kimi Code is a separate API endpoint from the regular Moonshot API.
+ * Uses the same Kimi subscription/API key but different base URL.
+ * CRITICAL: Requires User-Agent: claude-code/1.0 header.
+ */
+async function configureKimiCode() {
+    p.log.step(color.bold("Kimi Code Configuration"));
+    p.note("Kimi Code is a dedicated coding endpoint.\n" +
+        color.bold("Uses your Kimi subscription - no separate API credits needed!") + "\n\n" +
+        "Uses your existing Kimi/Moonshot API key.\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://platform.moonshot.cn/console/api-keys"), "Kimi Code Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your Kimi API key:",
+            validate: (v) => validateApiKey(v, "kimi-code"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const result = await testConnectionWithSpinner("Kimi Code", () => testKimiCodeConnection(apiKey));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default Kimi Code model:",
+                options: KIMI_CODE_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["kimi-code"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.kimi.com/coding/v1",
+                default_model: defaultModel,
+            };
+        }
+        const action = await p.select({
+            message: "Connection test failed. What would you like to do?",
+            options: [
+                { value: "retry", label: "Re-enter API key" },
+                { value: "skip", label: "Skip this provider" },
+                { value: "add", label: "Add anyway" },
+            ],
+        });
+        if (p.isCancel(action) || action === "skip")
+            return null;
+        if (action === "add") {
+            const envVarName = PROVIDER_ENV_VARS["kimi-code"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.kimi.com/coding/v1",
+                default_model: "kimi-for-coding",
+            };
+        }
+    }
+}
+/**
+ * Configure Perplexity provider (API only)
+ */
+async function configurePerplexity() {
+    p.log.step(color.bold("Perplexity Configuration"));
+    p.note("Perplexity provides web search grounded responses with citations.\n" +
+        "Sonar models return real-time web information.\n\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://www.perplexity.ai/settings/api"), "Perplexity Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your Perplexity API key:",
+            validate: (v) => validateApiKey(v, "perplexity"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const result = await testConnectionWithSpinner("Perplexity", () => testPerplexityConnection(apiKey));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default Perplexity model:",
+                options: PERPLEXITY_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["perplexity"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.perplexity.ai",
+                default_model: defaultModel,
+            };
+        }
+        const action = await p.select({
+            message: "Connection test failed. What would you like to do?",
+            options: [
+                { value: "retry", label: "Re-enter API key" },
+                { value: "skip", label: "Skip this provider" },
+                { value: "add", label: "Add anyway" },
+            ],
+        });
+        if (p.isCancel(action) || action === "skip")
+            return null;
+        if (action === "add") {
+            const envVarName = PROVIDER_ENV_VARS["perplexity"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.perplexity.ai",
+                default_model: "sonar",
+            };
+        }
+    }
+}
+/**
+ * Configure OpenRouter provider (API only)
+ */
+async function configureOpenRouter() {
+    p.log.step(color.bold("OpenRouter Configuration"));
+    p.note("OpenRouter provides access to 300+ models via a single API.\n" +
+        "Use 'openrouter/auto' to automatically select the best model.\n\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://openrouter.ai/keys"), "OpenRouter Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your OpenRouter API key:",
+            validate: (v) => validateApiKey(v, "openrouter"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const result = await testConnectionWithSpinner("OpenRouter", () => testOpenRouterConnection(apiKey));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default OpenRouter model:",
+                options: OPENROUTER_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["openrouter"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://openrouter.ai/api/v1",
+                default_model: defaultModel,
+            };
+        }
+        const action = await p.select({
+            message: "Connection test failed. What would you like to do?",
+            options: [
+                { value: "retry", label: "Re-enter API key" },
+                { value: "skip", label: "Skip this provider" },
+                { value: "add", label: "Add anyway" },
+            ],
+        });
+        if (p.isCancel(action) || action === "skip")
+            return null;
+        if (action === "add") {
+            const envVarName = PROVIDER_ENV_VARS["openrouter"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://openrouter.ai/api/v1",
+                default_model: "openrouter/auto",
+            };
+        }
+    }
+}
+/**
+ * Configure Groq provider (API only)
+ */
+async function configureGroq() {
+    p.log.step(color.bold("Groq Configuration"));
+    p.note("Groq provides ultra-fast LPU inference - up to 18x faster than GPU.\n" +
+        color.bold("Free tier available!") + "\n\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://console.groq.com/keys"), "Groq Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your Groq API key:",
+            validate: (v) => validateApiKey(v, "groq"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const result = await testConnectionWithSpinner("Groq", () => testGroqConnection(apiKey));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default Groq model:",
+                options: GROQ_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["groq"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.groq.com/openai/v1",
+                default_model: defaultModel,
+            };
+        }
+        const action = await p.select({
+            message: "Connection test failed. What would you like to do?",
+            options: [
+                { value: "retry", label: "Re-enter API key" },
+                { value: "skip", label: "Skip this provider" },
+                { value: "add", label: "Add anyway" },
+            ],
+        });
+        if (p.isCancel(action) || action === "skip")
+            return null;
+        if (action === "add") {
+            const envVarName = PROVIDER_ENV_VARS["groq"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.groq.com/openai/v1",
+                default_model: "llama-3.3-70b-versatile",
+            };
+        }
+    }
+}
+/**
+ * Configure Together AI provider (API only)
+ */
+async function configureTogether() {
+    p.log.step(color.bold("Together AI Configuration"));
+    p.note("Together AI provides 200+ open models with sub-100ms latency.\n" +
+        color.bold("$1 free credit to start!") + "\n\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://api.together.xyz/settings/api-keys"), "Together AI Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your Together AI API key:",
+            validate: (v) => validateApiKey(v, "together"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const result = await testConnectionWithSpinner("Together AI", () => testTogetherConnection(apiKey));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default Together AI model:",
+                options: TOGETHER_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["together"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.together.xyz/v1",
+                default_model: defaultModel,
+            };
+        }
+        const action = await p.select({
+            message: "Connection test failed. What would you like to do?",
+            options: [
+                { value: "retry", label: "Re-enter API key" },
+                { value: "skip", label: "Skip this provider" },
+                { value: "add", label: "Add anyway" },
+            ],
+        });
+        if (p.isCancel(action) || action === "skip")
+            return null;
+        if (action === "add") {
+            const envVarName = PROVIDER_ENV_VARS["together"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.together.xyz/v1",
+                default_model: "meta-llama/Llama-3.3-70B-Instruct-Turbo",
+            };
+        }
+    }
+}
+/**
+ * Configure Fireworks AI provider (API only)
+ */
+async function configureFireworks() {
+    p.log.step(color.bold("Fireworks AI Configuration"));
+    p.note("Fireworks AI provides fast inference for DeepSeek, Llama, and other models.\n" +
+        color.bold("$1 free credit to start!") + "\n\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://fireworks.ai/account/api-keys"), "Fireworks AI Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your Fireworks AI API key:",
+            validate: (v) => validateApiKey(v, "fireworks"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const result = await testConnectionWithSpinner("Fireworks AI", () => testFireworksConnection(apiKey));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default Fireworks AI model:",
+                options: FIREWORKS_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["fireworks"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.fireworks.ai/inference/v1",
+                default_model: defaultModel,
+            };
+        }
+        const action = await p.select({
+            message: "Connection test failed. What would you like to do?",
+            options: [
+                { value: "retry", label: "Re-enter API key" },
+                { value: "skip", label: "Skip this provider" },
+                { value: "add", label: "Add anyway" },
+            ],
+        });
+        if (p.isCancel(action) || action === "skip")
+            return null;
+        if (action === "add") {
+            const envVarName = PROVIDER_ENV_VARS["fireworks"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.fireworks.ai/inference/v1",
+                default_model: "accounts/fireworks/models/llama-v3p3-70b-instruct",
+            };
+        }
+    }
+}
 /**
  * Configure Ollama provider (local)
  */
@@ -902,6 +1385,75 @@ async function configureRoles(configuredProviders, orchestratorProvider) {
     return roles;
 }
 // ============================================================================
+// Failover Configuration
+// ============================================================================
+/**
+ * Configure failover settings.
+ */
+async function configureFailover(configuredProviders) {
+    p.note("Failover automatically switches to backup providers when errors occur.\n" +
+        "This keeps your coding agents running even during rate limits.", "Failover Configuration");
+    const enableFailover = await p.confirm({
+        message: "Enable automatic failover?",
+        initialValue: true,
+    });
+    if (p.isCancel(enableFailover)) {
+        p.cancel("Setup cancelled");
+        process.exit(0);
+    }
+    if (!enableFailover) {
+        return {
+            enabled: false,
+            preferCostEfficient: false,
+            roleFailbacks: {},
+        };
+    }
+    const preferCostEfficient = await p.confirm({
+        message: "Prefer cheapest healthy provider when no fallback specified?",
+        initialValue: false,
+    });
+    if (p.isCancel(preferCostEfficient)) {
+        p.cancel("Setup cancelled");
+        process.exit(0);
+    }
+    // Configure fallback order for coder role if multiple providers
+    const roleFailbacks = {};
+    if (configuredProviders.length > 1) {
+        const configureCoderFallback = await p.confirm({
+            message: `Configure fallback order for the "coder" role? (${configuredProviders.length} providers available)`,
+            initialValue: true,
+        });
+        if (p.isCancel(configureCoderFallback)) {
+            p.cancel("Setup cancelled");
+            process.exit(0);
+        }
+        if (configureCoderFallback) {
+            // Create options from configured providers
+            const providerOptions = configuredProviders.map((prov) => ({
+                value: prov,
+                label: getProviderDisplayName(prov),
+            }));
+            const fallbackSelection = await p.multiselect({
+                message: "Select fallback providers in order of preference (first = primary, rest = fallbacks):",
+                options: providerOptions,
+                required: true,
+            });
+            if (p.isCancel(fallbackSelection)) {
+                p.cancel("Setup cancelled");
+                process.exit(0);
+            }
+            if (Array.isArray(fallbackSelection) && fallbackSelection.length > 1) {
+                roleFailbacks["coder"] = fallbackSelection;
+            }
+        }
+    }
+    return {
+        enabled: true,
+        preferCostEfficient: preferCostEfficient,
+        roleFailbacks,
+    };
+}
+// ============================================================================
 // Shell Profile & Config Saving
 // ============================================================================
 function getShellProfilePath() {
@@ -959,8 +1511,8 @@ async function addEnvVarsToShellProfile() {
         p.log.error(`Failed to update ${profilePath}`);
     }
 }
-function generateConfig(providers, roles) {
-    return {
+function generateConfig(providers, roles, failoverConfig) {
+    const config = {
         version: "2.0",
         defaults: {
             temperature: 0.7,
@@ -970,6 +1522,31 @@ function generateConfig(providers, roles) {
         roles,
         providers,
     };
+    // Add failover configuration to defaults
+    if (failoverConfig?.enabled) {
+        config.defaults.failover = {
+            enabled: true,
+            prefer_cost_efficient: failoverConfig.preferCostEfficient,
+            health_check_interval_ms: 60000,
+            cooldown_ms: 300000,
+        };
+        // Add fallback chains to roles
+        for (const [roleName, fallbackProviders] of Object.entries(failoverConfig.roleFailbacks)) {
+            if (config.roles[roleName] && fallbackProviders.length > 1) {
+                const [primary, ...rest] = fallbackProviders;
+                // Update primary provider
+                config.roles[roleName].provider = primary;
+                // Add fallback chain
+                config.roles[roleName].fallback_chain = {
+                    providers: rest.map((provider) => ({
+                        provider,
+                        model: getDefaultModelForProvider(provider),
+                    })),
+                };
+            }
+        }
+    }
+    return config;
 }
 async function saveConfig(config) {
     const configPath = getUserConfigPath();
@@ -1156,9 +1733,15 @@ export async function runSetupWizard() {
         "Each role can use any configured provider.", "Step 4: Assign Agent Roles");
     const roles = await configureRoles(configuredProviderNames, orchestratorProvider);
     // ============================================================================
+    // STEP 5: Configure Failover
+    // ============================================================================
+    p.note("Failover provides automatic recovery when providers fail.\n" +
+        "Configure backup providers to keep agents running.", "Step 5: Failover Settings");
+    const failoverConfig = await configureFailover(configuredProviderNames);
+    // ============================================================================
     // Save Configuration
     // ============================================================================
-    const config = generateConfig(providers, roles);
+    const config = generateConfig(providers, roles, failoverConfig);
     const saved = await saveConfig(config);
     if (saved) {
         await addEnvVarsToShellProfile();
@@ -1167,8 +1750,9 @@ export async function runSetupWizard() {
         console.log(color.bold("  Summary"));
         console.log();
         console.log(`  Orchestrator: ${color.cyan(orchestratorProvider)} (${orchestratorAccessMode})`);
-        console.log(`  Agent Providers: ${configuredProviderNames.filter(p => p !== orchestratorProvider).join(", ") || "none"}`);
+        console.log(`  Agent Providers: ${configuredProviderNames.filter(prov => prov !== orchestratorProvider).join(", ") || "none"}`);
         console.log(`  Roles: ${Object.keys(roles).join(", ")}`);
+        console.log(`  Failover: ${failoverConfig.enabled ? color.green("enabled") : color.dim("disabled")}`);
         console.log();
         console.log(`  Config: ${color.dim(getUserConfigPath())}`);
         console.log();
@@ -1195,6 +1779,18 @@ async function configureProviderWithAPIKey(providerType) {
             return configureZaiAPI();
         case "kimi":
             return configureKimiAPI();
+        case "kimi-code":
+            return configureKimiCodeAPI();
+        case "perplexity":
+            return configurePerplexityAPI();
+        case "openrouter":
+            return configureOpenRouterAPI();
+        case "groq":
+            return configureGroqAPI();
+        case "together":
+            return configureTogetherAPI();
+        case "fireworks":
+            return configureFireworksAPI();
         case "ollama":
             return configureOllama();
         default:
@@ -1399,7 +1995,258 @@ async function configureKimiAPI() {
     return {
         access_mode: "api",
         api_key: `\${KIMI_API_KEY}`,
-        base_url: "https://api.moonshot.cn/v1",
+        base_url: "https://api.moonshot.ai/v1",
+        default_model: model,
+    };
+}
+/**
+ * Configure Kimi Code with API key (no subscription option)
+ */
+async function configureKimiCodeAPI() {
+    p.note("Kimi Code is a dedicated coding endpoint.\n" +
+        color.bold("Uses your Kimi subscription - no separate API credits!") + "\n\n" +
+        "Uses your existing Kimi/Moonshot API key.\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://platform.moonshot.cn/console/api-keys"), "Kimi Code API Setup");
+    const apiKey = await p.password({
+        message: "Enter your Kimi API key:",
+        validate: (value) => validateApiKey(value, "kimi-code"),
+    });
+    if (p.isCancel(apiKey))
+        return null;
+    const result = await testConnectionWithSpinner("Kimi Code", () => testKimiCodeConnection(apiKey));
+    if (!result.success) {
+        const continueAnyway = await p.confirm({
+            message: `Connection failed: ${result.error}. Continue anyway?`,
+            initialValue: false,
+        });
+        if (p.isCancel(continueAnyway) || !continueAnyway)
+            return null;
+    }
+    const model = await p.select({
+        message: "Select default Kimi Code model:",
+        options: KIMI_CODE_MODELS.map((m) => ({
+            value: m.value,
+            label: m.label,
+            ...(m.hint ? { hint: m.hint } : {}),
+        })),
+    });
+    if (p.isCancel(model))
+        return null;
+    // Store API key for later shell profile export (uses same key as regular Kimi)
+    configuredEnvVars.set("KIMI_API_KEY", apiKey);
+    return {
+        access_mode: "api",
+        api_key: `\${KIMI_API_KEY}`,
+        base_url: "https://api.kimi.com/coding/v1",
+        default_model: model,
+    };
+}
+/**
+ * Configure Perplexity with API key (no subscription option)
+ */
+async function configurePerplexityAPI() {
+    p.note("Perplexity provides web search grounded responses with citations.\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://www.perplexity.ai/settings/api"), "Perplexity API Setup");
+    const apiKey = await p.password({
+        message: "Enter your Perplexity API key:",
+        validate: (value) => validateApiKey(value, "perplexity"),
+    });
+    if (p.isCancel(apiKey))
+        return null;
+    const result = await testConnectionWithSpinner("Perplexity", () => testPerplexityConnection(apiKey));
+    if (!result.success) {
+        const continueAnyway = await p.confirm({
+            message: `Connection failed: ${result.error}. Continue anyway?`,
+            initialValue: false,
+        });
+        if (p.isCancel(continueAnyway) || !continueAnyway)
+            return null;
+    }
+    const model = await p.select({
+        message: "Select default Perplexity model:",
+        options: PERPLEXITY_MODELS.map((m) => ({
+            value: m.value,
+            label: m.label,
+            ...(m.hint ? { hint: m.hint } : {}),
+        })),
+    });
+    if (p.isCancel(model))
+        return null;
+    // Store API key for later shell profile export
+    configuredEnvVars.set("PERPLEXITY_API_KEY", apiKey);
+    return {
+        access_mode: "api",
+        api_key: `\${PERPLEXITY_API_KEY}`,
+        base_url: "https://api.perplexity.ai",
+        default_model: model,
+    };
+}
+/**
+ * Configure OpenRouter with API key (no subscription option)
+ */
+async function configureOpenRouterAPI() {
+    p.note("OpenRouter provides access to 300+ models via a single API.\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://openrouter.ai/keys"), "OpenRouter API Setup");
+    const apiKey = await p.password({
+        message: "Enter your OpenRouter API key:",
+        validate: (value) => validateApiKey(value, "openrouter"),
+    });
+    if (p.isCancel(apiKey))
+        return null;
+    const result = await testConnectionWithSpinner("OpenRouter", () => testOpenRouterConnection(apiKey));
+    if (!result.success) {
+        const continueAnyway = await p.confirm({
+            message: `Connection failed: ${result.error}. Continue anyway?`,
+            initialValue: false,
+        });
+        if (p.isCancel(continueAnyway) || !continueAnyway)
+            return null;
+    }
+    const model = await p.select({
+        message: "Select default OpenRouter model:",
+        options: OPENROUTER_MODELS.map((m) => ({
+            value: m.value,
+            label: m.label,
+            ...(m.hint ? { hint: m.hint } : {}),
+        })),
+    });
+    if (p.isCancel(model))
+        return null;
+    // Store API key for later shell profile export
+    configuredEnvVars.set("OPENROUTER_API_KEY", apiKey);
+    return {
+        access_mode: "api",
+        api_key: `\${OPENROUTER_API_KEY}`,
+        base_url: "https://openrouter.ai/api/v1",
+        default_model: model,
+    };
+}
+/**
+ * Configure Groq with API key (no subscription option)
+ */
+async function configureGroqAPI() {
+    p.note("Groq provides ultra-fast LPU inference - up to 18x faster than GPU.\n" +
+        color.bold("Free tier available!") + "\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://console.groq.com/keys"), "Groq API Setup");
+    const apiKey = await p.password({
+        message: "Enter your Groq API key:",
+        validate: (value) => validateApiKey(value, "groq"),
+    });
+    if (p.isCancel(apiKey))
+        return null;
+    const result = await testConnectionWithSpinner("Groq", () => testGroqConnection(apiKey));
+    if (!result.success) {
+        const continueAnyway = await p.confirm({
+            message: `Connection failed: ${result.error}. Continue anyway?`,
+            initialValue: false,
+        });
+        if (p.isCancel(continueAnyway) || !continueAnyway)
+            return null;
+    }
+    const model = await p.select({
+        message: "Select default Groq model:",
+        options: GROQ_MODELS.map((m) => ({
+            value: m.value,
+            label: m.label,
+            ...(m.hint ? { hint: m.hint } : {}),
+        })),
+    });
+    if (p.isCancel(model))
+        return null;
+    // Store API key for later shell profile export
+    configuredEnvVars.set("GROQ_API_KEY", apiKey);
+    return {
+        access_mode: "api",
+        api_key: `\${GROQ_API_KEY}`,
+        base_url: "https://api.groq.com/openai/v1",
+        default_model: model,
+    };
+}
+/**
+ * Configure Together AI with API key (no subscription option)
+ */
+async function configureTogetherAPI() {
+    p.note("Together AI provides 200+ open models with sub-100ms latency.\n" +
+        color.bold("$1 free credit to start!") + "\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://api.together.xyz/settings/api-keys"), "Together AI API Setup");
+    const apiKey = await p.password({
+        message: "Enter your Together AI API key:",
+        validate: (value) => validateApiKey(value, "together"),
+    });
+    if (p.isCancel(apiKey))
+        return null;
+    const result = await testConnectionWithSpinner("Together AI", () => testTogetherConnection(apiKey));
+    if (!result.success) {
+        const continueAnyway = await p.confirm({
+            message: `Connection failed: ${result.error}. Continue anyway?`,
+            initialValue: false,
+        });
+        if (p.isCancel(continueAnyway) || !continueAnyway)
+            return null;
+    }
+    const model = await p.select({
+        message: "Select default Together AI model:",
+        options: TOGETHER_MODELS.map((m) => ({
+            value: m.value,
+            label: m.label,
+            ...(m.hint ? { hint: m.hint } : {}),
+        })),
+    });
+    if (p.isCancel(model))
+        return null;
+    // Store API key for later shell profile export
+    configuredEnvVars.set("TOGETHER_API_KEY", apiKey);
+    return {
+        access_mode: "api",
+        api_key: `\${TOGETHER_API_KEY}`,
+        base_url: "https://api.together.xyz/v1",
+        default_model: model,
+    };
+}
+/**
+ * Configure Fireworks AI with API key (no subscription option)
+ */
+async function configureFireworksAPI() {
+    p.note("Fireworks AI provides fast inference for DeepSeek, Llama, and other models.\n" +
+        color.bold("$1 free credit to start!") + "\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://fireworks.ai/account/api-keys"), "Fireworks AI API Setup");
+    const apiKey = await p.password({
+        message: "Enter your Fireworks AI API key:",
+        validate: (value) => validateApiKey(value, "fireworks"),
+    });
+    if (p.isCancel(apiKey))
+        return null;
+    const result = await testConnectionWithSpinner("Fireworks AI", () => testFireworksConnection(apiKey));
+    if (!result.success) {
+        const continueAnyway = await p.confirm({
+            message: `Connection failed: ${result.error}. Continue anyway?`,
+            initialValue: false,
+        });
+        if (p.isCancel(continueAnyway) || !continueAnyway)
+            return null;
+    }
+    const model = await p.select({
+        message: "Select default Fireworks AI model:",
+        options: FIREWORKS_MODELS.map((m) => ({
+            value: m.value,
+            label: m.label,
+            ...(m.hint ? { hint: m.hint } : {}),
+        })),
+    });
+    if (p.isCancel(model))
+        return null;
+    // Store API key for later shell profile export
+    configuredEnvVars.set("FIREWORKS_API_KEY", apiKey);
+    return {
+        access_mode: "api",
+        api_key: `\${FIREWORKS_API_KEY}`,
+        base_url: "https://api.fireworks.ai/inference/v1",
         default_model: model,
     };
 }
@@ -1459,6 +2306,24 @@ export async function addProvider(providerName) {
         case "kimi":
             config = await configureKimi();
             break;
+        case "kimi-code":
+            config = await configureKimiCode();
+            break;
+        case "perplexity":
+            config = await configurePerplexity();
+            break;
+        case "openrouter":
+            config = await configureOpenRouter();
+            break;
+        case "groq":
+            config = await configureGroq();
+            break;
+        case "together":
+            config = await configureTogether();
+            break;
+        case "fireworks":
+            config = await configureFireworks();
+            break;
         case "ollama":
             config = await configureOllama();
             break;