mcp-agent-foundry 1.0.1 → 1.2.0

package/dist/cli/setup-wizard.js

@@ -1,11 +1,13 @@
 /**
- * Interactive setup wizard for AgentRouter v2
+ * Interactive setup wizard for Agent Foundry
  *
- * AgentRouter is an MCP server for multi-agent orchestration.
+ * Agent Foundry is an MCP server for multi-agent orchestration with
+ * Git worktree isolation for parallel coding agents.
  * This version supports:
  * - Multiple access modes: API keys OR subscription/CLI passthrough
  * - Configurable orchestrator (any provider can orchestrate)
  * - Full flexibility in role assignment
+ * - Git worktree isolation for coding agents
  *
  * Updated January 2026 with latest models from all providers.
  */
@@ -16,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, 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
 // ============================================================================
@@ -29,7 +31,14 @@ const PROVIDER_ENV_VARS = {
     google: "GEMINI_API_KEY",
     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
@@ -40,7 +49,7 @@ const configuredEnvVars = new Map();
  * Updated January 2026
  *
  * NOTE: "subscription" mode (CLI passthrough) only works for the interface
- * you're currently running FROM. Since AgentRouter typically runs from
+ * you're currently running FROM. Since Agent Foundry typically runs from
  * Claude Code, only Anthropic can use subscription mode for the orchestrator.
  * All other providers need API keys for agent roles.
  */
@@ -76,6 +85,48 @@ const AVAILABLE_PROVIDERS = [
         hint: "GLM-4.7 - Strong agentic coding, very affordable",
         supportsSubscription: false, // Requires API key when called from Claude Code
     },
+    {
+        value: "kimi",
+        label: "Moonshot (Kimi)",
+        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",
@@ -138,6 +189,82 @@ const ZAI_MODELS = [
     { value: "glm-4.7-flashx", label: "GLM-4.7 FlashX", hint: "Fast and affordable" },
     { value: "glm-4.7-flash", label: "GLM-4.7 Flash", hint: "Free tier" },
 ];
+/**
+ * Moonshot Kimi models (January 2026)
+ * https://platform.moonshot.cn/docs/api/model-list
+ * K2.5 series with 1M context window
+ */
+const KIMI_MODELS = [
+    { value: "kimi-k2-5-preview", label: "Kimi K2.5 (Preview)", hint: "Latest flagship - 1M context" },
+    { 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
  */
@@ -264,18 +391,18 @@ If you're uncertain, say so. Prefer accuracy over completeness.`,
 // ============================================================================
 function displayBanner() {
     console.log();
-    console.log(color.cyan("╭─────────────────────────────────────────────────╮"));
-    console.log(color.cyan("│                                                 │"));
+    console.log(color.cyan("╭───────────────────────────────────────────────────────╮"));
+    console.log(color.cyan("│                                                       │"));
     console.log(color.cyan("│   ") +
-        color.bold(color.yellow("🔀")) +
-        color.bold(" AgentRouter Setup v2") +
-        color.cyan("                    │"));
-    console.log(color.cyan("│                                                 │"));
+        color.bold(color.yellow("🏗️")) +
+        color.bold(" Agent Foundry Setup") +
+        color.cyan("                            │"));
+    console.log(color.cyan("│                                                       │"));
     console.log(color.cyan("│   ") +
-        color.dim("Multi-agent orchestration for AI coding tools") +
+        color.dim("Multi-agent orchestration with worktree isolation") +
         color.cyan(" │"));
-    console.log(color.cyan("│                                                 │"));
-    console.log(color.cyan("╰─────────────────────────────────────────────────╯"));
+    console.log(color.cyan("│                                                       │"));
+    console.log(color.cyan("╰───────────────────────────────────────────────────────╯"));
     console.log();
 }
 // ============================================================================
@@ -305,6 +432,20 @@ function getProviderModels(providerName) {
             return DEEPSEEK_MODELS;
         case "zai":
             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:
@@ -314,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
 // ============================================================================
@@ -640,28 +809,418 @@ async function configureZai() {
     // API mode
     p.note("GLM-4.7 is excellent for agentic coding tasks.\n" +
         "Get your API key from:\n" +
-        color.cyan("https://z.ai/manage-apikey/apikey-list"), "API Key Setup");
+        color.cyan("https://z.ai/manage-apikey/apikey-list"), "API Key Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your Z.AI API key:",
+            validate: (v) => validateApiKey(v, "zai"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const result = await testConnectionWithSpinner("Z.AI", () => testZaiConnection(apiKey));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default GLM model:",
+                options: ZAI_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["zai"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.z.ai/api/paas/v4",
+                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["zai"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.z.ai/api/paas/v4",
+                default_model: "glm-4.7-flash",
+            };
+        }
+    }
+}
+/**
+ * Configure Moonshot (Kimi) provider
+ */
+async function configureKimi() {
+    p.log.step(color.bold("Moonshot (Kimi) Configuration"));
+    p.note("Kimi K2.5 excels at coding with a 1M context window.\n" +
+        color.bold("Pricing: Very affordable") + "\n\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://platform.moonshot.cn/console/api-keys"), "Moonshot Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your Moonshot API key:",
+            validate: (v) => validateApiKey(v, "kimi"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const result = await testConnectionWithSpinner("Moonshot", () => testKimiConnection(apiKey));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default Kimi model:",
+                options: KIMI_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["kimi"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.moonshot.ai/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"];
+            configuredEnvVars.set(envVarName, apiKey);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                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 Z.AI API key:",
-            validate: (v) => validateApiKey(v, "zai"),
+            message: "Enter your Fireworks AI API key:",
+            validate: (v) => validateApiKey(v, "fireworks"),
         });
         if (p.isCancel(apiKey))
             return null;
-        const result = await testConnectionWithSpinner("Z.AI", () => testZaiConnection(apiKey));
+        const result = await testConnectionWithSpinner("Fireworks AI", () => testFireworksConnection(apiKey));
         if (result.success) {
             const defaultModel = await p.select({
-                message: "Select default GLM model:",
-                options: ZAI_MODELS,
+                message: "Select default Fireworks AI model:",
+                options: FIREWORKS_MODELS,
             });
             if (p.isCancel(defaultModel))
                 return null;
-            const envVarName = PROVIDER_ENV_VARS["zai"];
+            const envVarName = PROVIDER_ENV_VARS["fireworks"];
             configuredEnvVars.set(envVarName, apiKey);
             return {
                 access_mode: "api",
                 api_key: "${" + envVarName + "}",
-                base_url: "https://api.z.ai/api/paas/v4",
+                base_url: "https://api.fireworks.ai/inference/v1",
                 default_model: defaultModel,
             };
         }
@@ -676,13 +1235,13 @@ async function configureZai() {
         if (p.isCancel(action) || action === "skip")
             return null;
         if (action === "add") {
-            const envVarName = PROVIDER_ENV_VARS["zai"];
+            const envVarName = PROVIDER_ENV_VARS["fireworks"];
             configuredEnvVars.set(envVarName, apiKey);
             return {
                 access_mode: "api",
                 api_key: "${" + envVarName + "}",
-                base_url: "https://api.z.ai/api/paas/v4",
-                default_model: "glm-4.7-flash",
+                base_url: "https://api.fireworks.ai/inference/v1",
+                default_model: "accounts/fireworks/models/llama-v3p3-70b-instruct",
             };
         }
     }
@@ -826,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() {
@@ -867,7 +1495,7 @@ async function addEnvVarsToShellProfile() {
             p.log.info(`Environment variables already exist in ~/${profileName}`);
             return;
         }
-        const exportLines = ["", "# AgentRouter"];
+        const exportLines = ["", "# Agent Foundry"];
         for (const { name, value } of envVarsToAdd) {
             exportLines.push(`export ${name}="${value}"`);
         }
@@ -883,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,
@@ -894,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();
@@ -907,11 +1560,11 @@ async function saveConfig(config) {
             fs.copyFileSync(configPath, backupPath);
             p.log.info(`Backed up existing config to: ${color.dim(backupPath)}`);
         }
-        const header = `# AgentRouter Configuration v2
+        const header = `# Agent Foundry Configuration
 # Generated: ${new Date().toISOString()}
-# Documentation: https://github.com/hive-dev/agent-router
+# Documentation: https://github.com/sashabogi/agent-foundry
 #
-# This configures multi-agent orchestration across AI providers.
+# This configures multi-agent orchestration with Git worktree isolation.
 # Supports both API keys and subscription/CLI access modes.
 #
 # Environment variables: \${VAR_NAME} syntax
@@ -952,7 +1605,7 @@ function detectCurrentCLI() {
 }
 export async function runSetupWizard() {
     displayBanner();
-    p.intro(color.bgCyan(color.black(" AgentRouter Setup v2 ")));
+    p.intro(color.bgCyan(color.black(" Agent Foundry Setup ")));
     const currentCLI = detectCurrentCLI();
     // ============================================================================
     // STEP 1: Choose Orchestrator
@@ -1080,19 +1733,26 @@ 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();
-        p.outro(color.green("✓ AgentRouter configured successfully!"));
+        p.outro(color.green("✓ Agent Foundry configured successfully!"));
         console.log();
         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();
@@ -1117,6 +1777,20 @@ async function configureProviderWithAPIKey(providerType) {
             return configureDeepSeek();
         case "zai":
             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:
@@ -1284,6 +1958,298 @@ async function configureZaiAPI() {
         default_model: model,
     };
 }
+/**
+ * Configure Moonshot (Kimi) with API key (no subscription option)
+ */
+async function configureKimiAPI() {
+    p.note("Kimi K2.5 excels at coding with 1M context window.\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://platform.moonshot.cn/console/api-keys"), "Moonshot Kimi API Setup");
+    const apiKey = await p.password({
+        message: "Enter your Moonshot API key:",
+        validate: (value) => validateApiKey(value, "kimi"),
+    });
+    if (p.isCancel(apiKey))
+        return null;
+    const result = await testConnectionWithSpinner("Moonshot", () => testKimiConnection(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 model:",
+        options: KIMI_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("KIMI_API_KEY", apiKey);
+    return {
+        access_mode: "api",
+        api_key: `\${KIMI_API_KEY}`,
+        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,
+    };
+}
 // ============================================================================
 // Provider Management Functions (for CLI subcommands)
 // ============================================================================
@@ -1337,6 +2303,27 @@ export async function addProvider(providerName) {
         case "zai":
             config = await configureZai();
             break;
+        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;
@@ -1356,7 +2343,7 @@ export async function testProvider(providerName) {
     const configPath = getUserConfigPath();
     if (!fs.existsSync(configPath)) {
         p.log.error("No configuration file found.");
-        p.log.info("Run 'agent-router setup' first to configure providers.");
+        p.log.info("Run 'agent-foundry setup' first to configure providers.");
         process.exit(1);
     }
     // For now, just test based on provider name
@@ -1383,7 +2370,7 @@ export async function listProviders() {
     const configPath = getUserConfigPath();
     if (!fs.existsSync(configPath)) {
         console.log("No configuration file found.");
-        console.log("Run 'agent-router setup' to configure providers.");
+        console.log("Run 'agent-foundry setup' to configure providers.");
         return;
     }
     try {
@@ -1392,7 +2379,7 @@ export async function listProviders() {
         const config = parse(configContent);
         if (!config.providers || Object.keys(config.providers).length === 0) {
             console.log("No providers configured.");
-            console.log("Run 'agent-router setup' to add providers.");
+            console.log("Run 'agent-foundry setup' to add providers.");
             return;
         }
         console.log();