@sashabogi/foundation 0.1.6 → 0.1.8

package/dist/cli/setup-wizard.js

@@ -0,0 +1,1645 @@
+/**
+ * Interactive setup wizard for Foundation
+ *
+ * Foundation is an MCP server for AI-assisted development providing:
+ * - Codebase intelligence (Demerzel)
+ * - Multi-agent orchestration (Seldon)
+ * - Workflow patterns (Gaia)
+ *
+ * This wizard 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 February 2026 with latest models from all providers.
+ */
+import * as p from "@clack/prompts";
+import color from "picocolors";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { stringify as yamlStringify } from "yaml";
+import { testOpenAIConnection, testGeminiConnection, testDeepSeekConnection, testZaiConnection, testKimiConnection, testKimiCodeConnection, testOllamaConnection, testAnthropicConnection, testPerplexityConnection, testOpenRouterConnection, testGroqConnection, testTogetherConnection, testFireworksConnection, testConnectionWithSpinner, } from "./test-connection.js";
+// ============================================================================
+// Config Paths
+// ============================================================================
+const CONFIG_DIR = path.join(os.homedir(), ".foundation");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.yaml");
+function getConfigPath() {
+    return CONFIG_FILE;
+}
+function getConfigDir() {
+    return CONFIG_DIR;
+}
+// ============================================================================
+// Constants - Updated February 2026
+// ============================================================================
+/**
+ * Environment variable names for each provider (API mode)
+ */
+const PROVIDER_ENV_VARS = {
+    anthropic: "ANTHROPIC_API_KEY",
+    openai: "OPENAI_API_KEY",
+    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
+ */
+const configuredEnvVars = new Map();
+/**
+ * All available providers with their capabilities
+ * Updated February 2026
+ */
+const AVAILABLE_PROVIDERS = [
+    {
+        value: "anthropic",
+        label: "Anthropic (Claude)",
+        hint: "Claude Opus/Sonnet 4.5 - Best for orchestration and code",
+        supportsSubscription: true,
+        subscriptionInfo: "Claude Code session (Max/Pro subscription) - orchestrator only",
+    },
+    {
+        value: "openai",
+        label: "OpenAI",
+        hint: "GPT-5.2/5.1 - Excellent for coding and critiques",
+        supportsSubscription: false,
+    },
+    {
+        value: "google",
+        label: "Google Gemini",
+        hint: "Gemini 3/2.5 - Great for research and multimodal",
+        supportsSubscription: false,
+    },
+    {
+        value: "deepseek",
+        label: "DeepSeek",
+        hint: "V3.2 Reasoner - Excellent reasoning at 1/10th the cost",
+        supportsSubscription: false,
+    },
+    {
+        value: "zai",
+        label: "Z.AI (GLM)",
+        hint: "GLM-4.7 - Strong agentic coding, very affordable",
+        supportsSubscription: false,
+    },
+    {
+        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",
+        hint: "Local models - free, private, offline",
+        supportsSubscription: false,
+    },
+];
+// ============================================================================
+// Model Options - Updated February 2026
+// ============================================================================
+const ANTHROPIC_MODELS = [
+    { value: "claude-sonnet-4-5-20250929", label: "Claude Sonnet 4.5", hint: "Best balance - recommended" },
+    { value: "claude-opus-4-5-20251101", label: "Claude Opus 4.5", hint: "Most intelligent" },
+    { value: "claude-haiku-4-5-20251001", label: "Claude Haiku 4.5", hint: "Fastest, cheapest" },
+];
+const OPENAI_MODELS = [
+    { value: "gpt-5.1", label: "GPT-5.1", hint: "Best for coding - adaptive reasoning" },
+    { value: "gpt-5.2", label: "GPT-5.2", hint: "Most advanced frontier model" },
+    { value: "gpt-5", label: "GPT-5", hint: "Strong coding, 400K context" },
+    { value: "gpt-5-mini", label: "GPT-5 Mini", hint: "Smaller, cost-effective" },
+    { value: "gpt-4.1", label: "GPT-4.1", hint: "Previous gen, 1M context" },
+    { value: "o3", label: "o3", hint: "Advanced reasoning (slower)" },
+];
+const GEMINI_MODELS = [
+    { value: "gemini-2.5-pro", label: "Gemini 2.5 Pro", hint: "Stable, high capability" },
+    { value: "gemini-2.5-flash", label: "Gemini 2.5 Flash", hint: "Fast, balanced" },
+    { value: "gemini-3-pro-preview", label: "Gemini 3 Pro (Preview)", hint: "Most advanced reasoning" },
+    { value: "gemini-3-flash-preview", label: "Gemini 3 Flash (Preview)", hint: "Fast frontier performance" },
+];
+const DEEPSEEK_MODELS = [
+    { value: "deepseek-reasoner", label: "DeepSeek V3.2 (Thinking)", hint: "Best reasoning - great for critiques" },
+    { value: "deepseek-chat", label: "DeepSeek V3.2 (Non-thinking)", hint: "Fast and very cheap ($0.28/1M)" },
+];
+const ZAI_MODELS = [
+    { value: "glm-4.7", label: "GLM-4.7", hint: "Flagship - best for agentic coding" },
+    { 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" },
+];
+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" },
+];
+const KIMI_CODE_MODELS = [
+    { value: "kimi-for-coding", label: "Kimi for Coding", hint: "Optimized for code generation" },
+];
+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" },
+];
+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" },
+];
+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" },
+];
+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" },
+];
+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" },
+];
+const OLLAMA_MODELS = [
+    { value: "llama3.2", label: "Llama 3.2", hint: "Default local model" },
+    { value: "qwen3:32b", label: "Qwen 3 32B", hint: "Strong reasoning" },
+    { value: "codellama", label: "CodeLlama", hint: "Code-focused" },
+    { value: "deepseek-coder-v2", label: "DeepSeek Coder V2", hint: "Excellent for code" },
+];
+const AGENT_ROLES = [
+    {
+        value: "orchestrator",
+        label: "Orchestrator",
+        hint: "Main coordinator - routes tasks to other agents",
+        defaultProvider: "anthropic",
+        defaultModel: "claude-sonnet-4-5-20250929",
+        temperature: 0.3,
+        systemPrompt: `You are the orchestrating AI agent. Your role is to:
+
+1. **Understand the user's intent** and break down complex tasks
+2. **Route tasks** to specialized agents (critic, reviewer, researcher, etc.)
+3. **Synthesize results** from multiple agents into coherent responses
+4. **Maintain context** across the conversation
+
+You have access to other AI agents with different specializations.
+Use them strategically to provide the best possible assistance.`,
+    },
+    {
+        value: "critic",
+        label: "Critic",
+        hint: "Challenge assumptions, find flaws in plans",
+        defaultProvider: "deepseek",
+        defaultModel: "deepseek-reasoner",
+        temperature: 0.3,
+        systemPrompt: `You are a skeptical senior architect reviewing a plan.
+Your job is to provide a critical second opinion:
+
+1. **Challenge Assumptions**: Don't accept claims at face value. Ask "Why?" and "What if?"
+2. **Identify Risks**: Find failure modes, edge cases, and potential issues
+3. **Question Scope**: Is the solution over-engineered? Under-specified?
+4. **Check Completeness**: What's missing? What hasn't been considered?
+5. **Push for Excellence**: "Good enough" isn't good enough. Find ways to improve.
+
+Be constructive but rigorous. Provide specific, actionable feedback.`,
+    },
+    {
+        value: "coder",
+        label: "Coder",
+        hint: "Write, refactor, and implement code",
+        defaultProvider: "anthropic",
+        defaultModel: "claude-sonnet-4-5-20250929",
+        temperature: 0.2,
+        systemPrompt: `You are an expert software engineer. Your role is to:
+
+1. **Write Clean Code**: Follow best practices, use clear naming, add appropriate comments
+2. **Implement Features**: Turn requirements into working, well-tested code
+3. **Refactor**: Improve existing code structure without changing behavior
+4. **Debug**: Find and fix bugs systematically
+5. **Optimize**: Improve performance where it matters
+
+Always consider:
+- Error handling and edge cases
+- Testing and testability
+- Security implications
+- Performance characteristics
+- Maintainability and readability
+
+Provide complete, runnable code with explanations of key decisions.`,
+    },
+    {
+        value: "reviewer",
+        label: "Code Reviewer",
+        hint: "Review code for bugs, security, performance",
+        defaultProvider: "anthropic",
+        defaultModel: "claude-sonnet-4-5-20250929",
+        temperature: 0.2,
+        systemPrompt: `You are a senior code reviewer. Review code for:
+
+1. **Correctness**: Does it work? Are there bugs?
+2. **Security**: SQL injection, XSS, auth issues, data exposure
+3. **Performance**: N+1 queries, unnecessary computations, memory leaks
+4. **Maintainability**: Is it readable? Well-structured? Documented?
+5. **Best Practices**: Follows language/framework conventions?
+6. **Testing**: Is it testable? Are there missing tests?
+
+Be specific. Reference line numbers. Suggest improvements with code examples.`,
+    },
+    {
+        value: "designer",
+        label: "Designer",
+        hint: "UI/UX feedback and design review",
+        defaultProvider: "google",
+        defaultModel: "gemini-2.5-pro",
+        systemPrompt: `You are a senior UI/UX designer. Focus on:
+
+1. **User Experience**: Is it intuitive? Accessible? Delightful?
+2. **Visual Hierarchy**: Does the layout guide the user's eye?
+3. **Component Architecture**: Are components reusable? Maintainable?
+4. **Design Systems**: Does it follow established patterns?
+5. **Responsive Design**: How does it work across devices?
+6. **Accessibility**: WCAG compliance, keyboard navigation, screen readers
+
+Provide specific feedback with examples and alternatives.`,
+    },
+    {
+        value: "researcher",
+        label: "Researcher",
+        hint: "Fact-finding and research tasks",
+        defaultProvider: "google",
+        defaultModel: "gemini-2.5-pro",
+        systemPrompt: `You are a research analyst. Provide:
+
+1. Well-researched, factual information
+2. Source citations where possible
+3. Confidence levels for claims
+4. Alternative perspectives or approaches
+5. Current best practices in the field
+
+If you're uncertain, say so. Prefer accuracy over completeness.`,
+    },
+    {
+        value: "verifier",
+        label: "Verifier",
+        hint: "Verify implementation matches plan",
+        defaultProvider: "anthropic",
+        defaultModel: "claude-sonnet-4-5-20250929",
+        temperature: 0.2,
+        systemPrompt: `You are an implementation verifier. Your role is to:
+
+1. **Compare implementation to plan**: Does the code match what was intended?
+2. **Check for completeness**: Are all requirements addressed?
+3. **Identify deviations**: Note any differences from the plan
+4. **Verify correctness**: Does the implementation work correctly?
+5. **Check for regressions**: Did we break anything existing?
+
+Be thorough and systematic. Report issues with specific file/line references.`,
+    },
+];
+// ============================================================================
+// Display Functions
+// ============================================================================
+function displayBanner() {
+    console.log();
+    console.log(color.cyan("╭───────────────────────────────────────────────────────╮"));
+    console.log(color.cyan("│                                                       │"));
+    console.log(color.cyan("│   ") +
+        color.bold(color.yellow("🔧")) +
+        color.bold(" Foundation Setup") +
+        color.cyan("                             │"));
+    console.log(color.cyan("│                                                       │"));
+    console.log(color.cyan("│   ") +
+        color.dim("AI-assisted development with multi-agent orchestration") +
+        color.cyan("│"));
+    console.log(color.cyan("│                                                       │"));
+    console.log(color.cyan("╰───────────────────────────────────────────────────────╯"));
+    console.log();
+}
+// ============================================================================
+// Validation Functions
+// ============================================================================
+function validateApiKey(value, _provider) {
+    if (!value || value.trim().length === 0) {
+        return "API key is required";
+    }
+    if (value.length < 10) {
+        return "API key seems too short";
+    }
+    return undefined;
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function getProviderModels(providerName) {
+    switch (providerName) {
+        case "anthropic":
+            return ANTHROPIC_MODELS;
+        case "openai":
+            return OPENAI_MODELS;
+        case "google":
+            return GEMINI_MODELS;
+        case "deepseek":
+            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:
+            return [{ value: "default", label: "Default model" }];
+    }
+}
+function getProviderInfo(providerName) {
+    return AVAILABLE_PROVIDERS.find((p) => p.value === providerName);
+}
+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;
+}
+function getDefaultModelForProvider(provider) {
+    const models = getProviderModels(provider);
+    return models[0]?.value ?? "default";
+}
+// ============================================================================
+// Provider Configuration Functions
+// ============================================================================
+async function configureAnthropic() {
+    p.log.step(color.bold("Anthropic (Claude) Configuration"));
+    const provider = getProviderInfo("anthropic");
+    if (provider.supportsSubscription) {
+        const accessMode = await p.select({
+            message: `How do you want to access ${provider.label}?`,
+            options: [
+                {
+                    value: "subscription",
+                    label: "Subscription/CLI",
+                    hint: provider.subscriptionInfo ?? "Uses CLI tool with subscription",
+                },
+                {
+                    value: "api",
+                    label: "API Key",
+                    hint: "Pay-per-token usage",
+                },
+            ],
+        });
+        if (p.isCancel(accessMode))
+            return null;
+        if (accessMode === "subscription") {
+            p.note("You're using Claude Code with your existing subscription.\n" +
+                "No API key needed - Claude will be accessed through the current session.", "Subscription Mode");
+            const defaultModel = await p.select({
+                message: "Select default Claude model:",
+                options: ANTHROPIC_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            return {
+                access_mode: "subscription",
+                default_model: defaultModel,
+            };
+        }
+    }
+    // API mode
+    p.note("Get your API key from:\n" +
+        color.cyan("https://console.anthropic.com/settings/keys"), "API Key Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your Anthropic API key:",
+            validate: (v) => validateApiKey(v, "anthropic"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("Anthropic", () => testAnthropicConnection(apiKeyStr));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default Claude model:",
+                options: ANTHROPIC_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["anthropic"];
+            configuredEnvVars.set(envVarName, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                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["anthropic"];
+            configuredEnvVars.set(envVarName, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                default_model: "claude-sonnet-4-5-20250929",
+            };
+        }
+    }
+}
+async function configureOpenAI() {
+    p.log.step(color.bold("OpenAI Configuration"));
+    p.note("Get your API key from:\n" +
+        color.cyan("https://platform.openai.com/api-keys"), "API Key Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your OpenAI API key:",
+            validate: (v) => validateApiKey(v, "openai"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("OpenAI", () => testOpenAIConnection(apiKeyStr));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default OpenAI model:",
+                options: OPENAI_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["openai"];
+            configuredEnvVars.set(envVarName, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.openai.com/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["openai"];
+            configuredEnvVars.set(envVarName, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.openai.com/v1",
+                default_model: "gpt-5.1",
+            };
+        }
+    }
+}
+async function configureGemini() {
+    p.log.step(color.bold("Google Gemini Configuration"));
+    p.note("Get your API key from:\n" +
+        color.cyan("https://aistudio.google.com/apikey"), "API Key Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your Google Gemini API key:",
+            validate: (v) => validateApiKey(v, "google"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("Gemini", () => testGeminiConnection(apiKeyStr));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default Gemini model:",
+                options: GEMINI_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["google"];
+            configuredEnvVars.set(envVarName, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                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["google"];
+            configuredEnvVars.set(envVarName, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                default_model: "gemini-2.5-flash",
+            };
+        }
+    }
+}
+async function configureDeepSeek() {
+    p.log.step(color.bold("DeepSeek Configuration"));
+    p.note("DeepSeek V3.2 offers excellent reasoning at ~1/10th the cost.\n" +
+        color.bold("Pricing: $0.28/1M input, $0.42/1M output") + "\n\n" +
+        "Get your API key from:\n" +
+        color.cyan("https://platform.deepseek.com/api_keys"), "DeepSeek Setup");
+    while (true) {
+        const apiKey = await p.password({
+            message: "Enter your DeepSeek API key:",
+            validate: (v) => validateApiKey(v, "deepseek"),
+        });
+        if (p.isCancel(apiKey))
+            return null;
+        const apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("DeepSeek", () => testDeepSeekConnection(apiKeyStr));
+        if (result.success) {
+            const defaultModel = await p.select({
+                message: "Select default DeepSeek model:",
+                options: DEEPSEEK_MODELS,
+            });
+            if (p.isCancel(defaultModel))
+                return null;
+            const envVarName = PROVIDER_ENV_VARS["deepseek"];
+            configuredEnvVars.set(envVarName, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.deepseek.com",
+                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["deepseek"];
+            configuredEnvVars.set(envVarName, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.deepseek.com",
+                default_model: "deepseek-reasoner",
+            };
+        }
+    }
+}
+async function configureZai() {
+    p.log.step(color.bold("Z.AI (GLM) Configuration"));
+    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");
+    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 apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("Z.AI", () => testZaiConnection(apiKeyStr));
+        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, apiKeyStr);
+            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, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.z.ai/api/paas/v4",
+                default_model: "glm-4.7-flash",
+            };
+        }
+    }
+}
+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 apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("Moonshot", () => testKimiConnection(apiKeyStr));
+        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, apiKeyStr);
+            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, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.moonshot.ai/v1",
+                default_model: "kimi-k2-5-preview",
+            };
+        }
+    }
+}
+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 apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("Kimi Code", () => testKimiCodeConnection(apiKeyStr));
+        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, apiKeyStr);
+            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, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.kimi.com/coding/v1",
+                default_model: "kimi-for-coding",
+            };
+        }
+    }
+}
+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 apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("Perplexity", () => testPerplexityConnection(apiKeyStr));
+        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, apiKeyStr);
+            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, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.perplexity.ai",
+                default_model: "sonar",
+            };
+        }
+    }
+}
+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 apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("OpenRouter", () => testOpenRouterConnection(apiKeyStr));
+        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, apiKeyStr);
+            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, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://openrouter.ai/api/v1",
+                default_model: "openrouter/auto",
+            };
+        }
+    }
+}
+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 apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("Groq", () => testGroqConnection(apiKeyStr));
+        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, apiKeyStr);
+            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, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.groq.com/openai/v1",
+                default_model: "llama-3.3-70b-versatile",
+            };
+        }
+    }
+}
+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 apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("Together AI", () => testTogetherConnection(apiKeyStr));
+        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, apiKeyStr);
+            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, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.together.xyz/v1",
+                default_model: "meta-llama/Llama-3.3-70B-Instruct-Turbo",
+            };
+        }
+    }
+}
+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 apiKeyStr = apiKey;
+        const result = await testConnectionWithSpinner("Fireworks AI", () => testFireworksConnection(apiKeyStr));
+        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, apiKeyStr);
+            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, apiKeyStr);
+            return {
+                access_mode: "api",
+                api_key: "${" + envVarName + "}",
+                base_url: "https://api.fireworks.ai/inference/v1",
+                default_model: "accounts/fireworks/models/llama-v3p3-70b-instruct",
+            };
+        }
+    }
+}
+async function configureOllama() {
+    p.log.step(color.bold("Ollama Configuration"));
+    p.note("Ollama runs models locally - free and private.\n" +
+        "Install from: " + color.cyan("https://ollama.ai") + "\n" +
+        "Then run: " + color.cyan("ollama serve"), "Ollama Setup");
+    while (true) {
+        const baseUrl = await p.text({
+            message: "Enter Ollama base URL:",
+            placeholder: "http://localhost:11434",
+            initialValue: "http://localhost:11434",
+            validate: (v) => {
+                if (!v)
+                    return "URL is required";
+                try {
+                    new URL(v);
+                    return undefined;
+                }
+                catch {
+                    return "Invalid URL format";
+                }
+            },
+        });
+        if (p.isCancel(baseUrl))
+            return null;
+        const baseUrlStr = baseUrl;
+        const result = await testConnectionWithSpinner("Ollama", () => testOllamaConnection(baseUrlStr));
+        if (result.success) {
+            let selectedModel = "llama3.2";
+            if (result.models && result.models.length > 0) {
+                const modelChoice = await p.select({
+                    message: "Select default model:",
+                    options: result.models.map((m) => ({ value: m, label: m })),
+                });
+                if (p.isCancel(modelChoice))
+                    return null;
+                selectedModel = modelChoice;
+                p.log.success(`Found ${result.models.length} installed model(s)`);
+            }
+            else {
+                p.log.warn("No models found. Pull a model with: ollama pull llama3.2");
+            }
+            return {
+                access_mode: "api",
+                base_url: baseUrlStr,
+                default_model: selectedModel,
+            };
+        }
+        const action = await p.select({
+            message: "Connection test failed. What would you like to do?",
+            options: [
+                { value: "retry", label: "Re-enter URL" },
+                { value: "skip", label: "Skip this provider" },
+                { value: "add", label: "Add anyway" },
+            ],
+        });
+        if (p.isCancel(action) || action === "skip")
+            return null;
+        if (action === "add") {
+            return {
+                access_mode: "api",
+                base_url: baseUrlStr,
+                default_model: "llama3.2",
+            };
+        }
+    }
+}
+// ============================================================================
+// Role Configuration
+// ============================================================================
+async function configureRoles(configuredProviders, orchestratorProvider) {
+    const roles = {};
+    // Auto-configure orchestrator role
+    const orchestratorRole = AGENT_ROLES.find((r) => r.value === "orchestrator");
+    if (orchestratorRole) {
+        const defaultModel = getProviderModels(orchestratorProvider)[0]?.value ?? "default";
+        roles["orchestrator"] = {
+            provider: orchestratorProvider,
+            model: defaultModel,
+            system_prompt: orchestratorRole.systemPrompt,
+            ...(orchestratorRole.temperature !== undefined ? { temperature: orchestratorRole.temperature } : {}),
+        };
+        p.log.success(`Orchestrator -> ${orchestratorProvider}/${defaultModel}`);
+    }
+    // Filter out orchestrator from selectable roles
+    const selectableRoles = AGENT_ROLES.filter((r) => r.value !== "orchestrator");
+    const selectedRoles = await p.multiselect({
+        message: "Which agent roles would you like to enable?",
+        options: selectableRoles.map((role) => ({
+            value: role.value,
+            label: role.label,
+            ...(role.hint ? { hint: role.hint } : {}),
+        })),
+        required: false,
+    });
+    if (p.isCancel(selectedRoles) || selectedRoles.length === 0) {
+        p.log.warn("No additional roles selected. You can add roles later.");
+        return roles;
+    }
+    for (const roleValue of selectedRoles) {
+        const role = selectableRoles.find((r) => r.value === roleValue);
+        if (!role)
+            continue;
+        console.log();
+        p.log.step(color.cyan(`${role.label}`));
+        console.log(color.dim(`  ${role.hint}`));
+        const providerOptions = configuredProviders.map((provider) => {
+            const models = getProviderModels(provider);
+            const defaultModel = models[0]?.label ?? "default";
+            return {
+                value: provider,
+                label: provider,
+                hint: `Default: ${defaultModel}`,
+            };
+        });
+        const selectedProvider = await p.select({
+            message: `Which provider for ${role.label.toLowerCase()}?`,
+            options: providerOptions,
+        });
+        if (p.isCancel(selectedProvider))
+            continue;
+        const modelOptions = getProviderModels(selectedProvider);
+        const selectedModel = await p.select({
+            message: "Select model:",
+            options: modelOptions,
+        });
+        if (p.isCancel(selectedModel))
+            continue;
+        roles[role.value] = {
+            provider: selectedProvider,
+            model: selectedModel,
+            system_prompt: role.systemPrompt,
+            ...(role.temperature !== undefined ? { temperature: role.temperature } : {}),
+        };
+        console.log(color.green(`  ✓ ${role.value}`) +
+            color.dim(` -> ${selectedProvider}/${selectedModel}`));
+    }
+    return roles;
+}
+// ============================================================================
+// Shell Profile & Config Saving
+// ============================================================================
+function getShellProfilePath() {
+    const shell = process.env["SHELL"] ?? "";
+    if (shell.includes("zsh")) {
+        return path.join(os.homedir(), ".zshrc");
+    }
+    return path.join(os.homedir(), ".bashrc");
+}
+async function addEnvVarsToShellProfile() {
+    if (configuredEnvVars.size === 0)
+        return;
+    const profilePath = getShellProfilePath();
+    const profileName = path.basename(profilePath);
+    const shouldAdd = await p.confirm({
+        message: `Add API keys to ~/${profileName}?`,
+        initialValue: true,
+    });
+    if (p.isCancel(shouldAdd) || !shouldAdd) {
+        p.log.info("Set environment variables manually:");
+        for (const [envVar] of configuredEnvVars) {
+            console.log(`  ${color.cyan(`export ${envVar}="your-api-key"`)}`);
+        }
+        return;
+    }
+    try {
+        let profileContent = "";
+        if (fs.existsSync(profilePath)) {
+            profileContent = fs.readFileSync(profilePath, "utf-8");
+        }
+        const envVarsToAdd = [];
+        for (const [envVar, value] of configuredEnvVars) {
+            const existsPattern = new RegExp(`^\\s*export\\s+${envVar}=`, "m");
+            if (!existsPattern.test(profileContent)) {
+                envVarsToAdd.push({ name: envVar, value });
+            }
+        }
+        if (envVarsToAdd.length === 0) {
+            p.log.info(`Environment variables already exist in ~/${profileName}`);
+            return;
+        }
+        const exportLines = ["", "# Foundation"];
+        for (const { name, value } of envVarsToAdd) {
+            exportLines.push(`export ${name}="${value}"`);
+        }
+        let prefix = "";
+        if (profileContent.length > 0 && !profileContent.endsWith("\n")) {
+            prefix = "\n";
+        }
+        fs.appendFileSync(profilePath, prefix + exportLines.join("\n") + "\n", "utf-8");
+        p.log.success(`Added environment variables to ~/${profileName}`);
+        p.log.info(`Run ${color.cyan(`source ~/${profileName}`)} to apply changes`);
+    }
+    catch (error) {
+        p.log.error(`Failed to update ${profilePath}`);
+    }
+}
+function generateConfig(providers, roles) {
+    return {
+        version: "1.0",
+        defaults: {
+            temperature: 0.7,
+            max_tokens: 4096,
+            timeout_ms: 60000,
+        },
+        providers,
+        roles,
+    };
+}
+async function saveConfig(config) {
+    const configPath = getConfigPath();
+    const configDir = getConfigDir();
+    try {
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+        if (fs.existsSync(configPath)) {
+            const backupPath = `${configPath}.backup.${Date.now()}`;
+            fs.copyFileSync(configPath, backupPath);
+            p.log.info(`Backed up existing config to: ${color.dim(backupPath)}`);
+        }
+        const header = `# Foundation Configuration
+# Generated: ${new Date().toISOString()}
+# Documentation: https://github.com/sashabogi/foundation
+#
+# This configures AI-assisted development with multi-agent orchestration.
+# Supports both API keys and subscription/CLI access modes.
+#
+# Environment variables: \${VAR_NAME} syntax
+# Access modes: "api" (pay-per-token) or "subscription" (CLI tools)
+
+`;
+        const yamlContent = yamlStringify(config, { indent: 2, lineWidth: 100 });
+        fs.writeFileSync(configPath, header + yamlContent, "utf-8");
+        return true;
+    }
+    catch (error) {
+        p.log.error(`Failed to save config: ${error instanceof Error ? error.message : "Unknown"}`);
+        return false;
+    }
+}
+// ============================================================================
+// Provider Configuration Router
+// ============================================================================
+async function configureProviderWithAPIKey(providerType) {
+    switch (providerType) {
+        case "anthropic":
+            return configureAnthropic();
+        case "openai":
+            return configureOpenAI();
+        case "google":
+            return configureGemini();
+        case "deepseek":
+            return configureDeepSeek();
+        case "zai":
+            return configureZai();
+        case "kimi":
+            return configureKimi();
+        case "kimi-code":
+            return configureKimiCode();
+        case "perplexity":
+            return configurePerplexity();
+        case "openrouter":
+            return configureOpenRouter();
+        case "groq":
+            return configureGroq();
+        case "together":
+            return configureTogether();
+        case "fireworks":
+            return configureFireworks();
+        case "ollama":
+            return configureOllama();
+        default:
+            return null;
+    }
+}
+// ============================================================================
+// Main Setup Wizard
+// ============================================================================
+/**
+ * Detect which CLI environment we're running from
+ */
+function detectCurrentCLI() {
+    if (process.env["CLAUDE_CODE"] || process.env["ANTHROPIC_API_KEY"] === "claude-code-session") {
+        return "anthropic";
+    }
+    if (process.env["OPENAI_CODEX_CLI"]) {
+        return "openai";
+    }
+    if (process.env["GEMINI_CLI"]) {
+        return "google";
+    }
+    return "anthropic"; // Default assumption
+}
+export async function runSetupWizard() {
+    displayBanner();
+    p.intro(color.bgCyan(color.black(" Foundation Setup ")));
+    const currentCLI = detectCurrentCLI();
+    // Step 1: Choose Orchestrator
+    p.note("The " + color.bold("orchestrator") + " is the main AI that coordinates all other agents.\n" +
+        "It runs IN your current CLI session and routes tasks to specialized agents.\n\n" +
+        "Since you're running from " + color.cyan("Claude Code") + ", Anthropic can use your\n" +
+        "subscription. All other providers require API keys.", "Step 1: Choose Your Orchestrator");
+    const orchestratorProvider = await p.select({
+        message: "Which provider should be your orchestrator?",
+        options: AVAILABLE_PROVIDERS.map((provider) => ({
+            value: provider.value,
+            label: provider.label,
+            hint: provider.value === currentCLI
+                ? "Can use subscription (no API key needed)"
+                : "Requires API key",
+        })),
+    });
+    if (p.isCancel(orchestratorProvider)) {
+        p.cancel("Setup cancelled");
+        process.exit(0);
+    }
+    const providers = {};
+    const configuredProviderNames = [];
+    let orchestratorConfig = null;
+    let orchestratorAccessMode = "api";
+    // If orchestrator matches current CLI, offer subscription mode
+    if (orchestratorProvider === currentCLI) {
+        const accessChoice = await p.select({
+            message: `How do you want to access ${orchestratorProvider}?`,
+            options: [
+                {
+                    value: "subscription",
+                    label: "Use my subscription (no API key)",
+                    hint: "Recommended - uses your current Claude Code session",
+                },
+                {
+                    value: "api",
+                    label: "Use API key",
+                    hint: "Pay-per-token, separate from subscription",
+                },
+            ],
+        });
+        if (p.isCancel(accessChoice)) {
+            p.cancel("Setup cancelled");
+            process.exit(0);
+        }
+        orchestratorAccessMode = accessChoice;
+    }
+    // Configure the orchestrator provider
+    if (orchestratorAccessMode === "subscription") {
+        p.note("Your orchestrator will use Claude Code's session.\n" +
+            "No API key needed - requests pass through your subscription.", "Subscription Mode");
+        const model = await p.select({
+            message: "Select default Claude model:",
+            options: ANTHROPIC_MODELS.map((m) => ({
+                value: m.value,
+                label: m.label,
+                ...(m.hint ? { hint: m.hint } : {}),
+            })),
+        });
+        if (p.isCancel(model)) {
+            p.cancel("Setup cancelled");
+            process.exit(0);
+        }
+        orchestratorConfig = {
+            access_mode: "subscription",
+            default_model: model,
+        };
+    }
+    else {
+        orchestratorConfig = await configureProviderWithAPIKey(orchestratorProvider);
+    }
+    if (orchestratorConfig) {
+        providers[orchestratorProvider] = orchestratorConfig;
+        configuredProviderNames.push(orchestratorProvider);
+        p.log.success(`Orchestrator configured: ${orchestratorProvider}`);
+    }
+    else {
+        p.cancel("Failed to configure orchestrator");
+        process.exit(1);
+    }
+    // Step 2: Add Agent Providers
+    const remainingProviders = AVAILABLE_PROVIDERS.filter((prov) => prov.value !== orchestratorProvider);
+    p.note("Now add providers for your agent roles (coder, critic, reviewer, etc.).\n" +
+        "These are called " + color.bold("via API") + " by your orchestrator.\n\n" +
+        color.yellow("All providers below require API keys.") + "\n" +
+        "Your orchestrator will make API calls to these providers.", "Step 2: Add Agent Providers");
+    const selectedAgentProviders = await p.multiselect({
+        message: "Which additional providers do you want for agent roles?",
+        options: remainingProviders.map((provider) => ({
+            value: provider.value,
+            label: provider.label,
+            ...(provider.hint ? { hint: provider.hint } : {}),
+        })),
+        required: false,
+    });
+    if (p.isCancel(selectedAgentProviders)) {
+        p.cancel("Setup cancelled");
+        process.exit(0);
+    }
+    // Step 3: Configure API Keys
+    if (selectedAgentProviders.length > 0) {
+        p.note("Configure API keys for each selected provider.\n" +
+            "Keys are stored in your config and/or shell profile.", "Step 3: Configure API Keys");
+        for (const providerType of selectedAgentProviders) {
+            const config = await configureProviderWithAPIKey(providerType);
+            if (config) {
+                providers[providerType] = config;
+                configuredProviderNames.push(providerType);
+                p.log.success(`${providerType} configured`);
+            }
+        }
+    }
+    // Step 4: Assign Roles
+    p.note("Assign providers to agent roles.\n" +
+        "Each role can use any configured provider.", "Step 4: Assign Agent Roles");
+    const roles = await configureRoles(configuredProviderNames, orchestratorProvider);
+    // Save Configuration
+    const config = generateConfig(providers, roles);
+    const saved = await saveConfig(config);
+    if (saved) {
+        await addEnvVarsToShellProfile();
+        p.outro(color.green("✓ Foundation configured successfully!"));
+        console.log();
+        console.log(color.bold("  Summary"));
+        console.log();
+        console.log(`  Orchestrator: ${color.cyan(orchestratorProvider)} (${orchestratorAccessMode})`);
+        console.log(`  Agent Providers: ${configuredProviderNames.filter(prov => prov !== orchestratorProvider).join(", ") || "none"}`);
+        console.log(`  Roles: ${Object.keys(roles).join(", ")}`);
+        console.log();
+        console.log(`  Config: ${color.dim(getConfigPath())}`);
+        console.log();
+    }
+    else {
+        p.cancel("Failed to save configuration");
+        process.exit(1);
+    }
+}
+// ============================================================================
+// Provider Management Functions (for CLI subcommands)
+// ============================================================================
+/**
+ * Add a single provider interactively
+ */
+export async function addProvider(providerName) {
+    displayBanner();
+    p.intro(color.bgCyan(color.black(" Add Provider ")));
+    let selectedProvider;
+    if (providerName) {
+        const validProvider = AVAILABLE_PROVIDERS.find((p) => p.value.toLowerCase() === providerName.toLowerCase());
+        if (!validProvider) {
+            p.log.error(`Unknown provider: ${providerName}`);
+            p.log.info(`Available providers: ${AVAILABLE_PROVIDERS.map((p) => p.value).join(", ")}`);
+            process.exit(1);
+        }
+        selectedProvider = validProvider.value;
+    }
+    else {
+        const choice = await p.select({
+            message: "Which provider would you like to add?",
+            options: AVAILABLE_PROVIDERS.map((provider) => ({
+                value: provider.value,
+                label: provider.label,
+                ...(provider.hint ? { hint: provider.hint } : {}),
+            })),
+        });
+        if (p.isCancel(choice)) {
+            p.cancel("Cancelled");
+            process.exit(0);
+        }
+        selectedProvider = choice;
+    }
+    const config = await configureProviderWithAPIKey(selectedProvider);
+    if (config) {
+        p.log.success(`${selectedProvider} configured`);
+        await addEnvVarsToShellProfile();
+    }
+}
+/**
+ * Test provider connection(s)
+ */
+export async function testProvider(providerName) {
+    p.intro(color.bgCyan(color.black(" Test Provider Connection ")));
+    const configPath = getConfigPath();
+    if (!fs.existsSync(configPath)) {
+        p.log.error("No configuration file found.");
+        p.log.info("Run 'foundation setup' first to configure providers.");
+        process.exit(1);
+    }
+    if (providerName) {
+        const provider = AVAILABLE_PROVIDERS.find((p) => p.value.toLowerCase() === providerName.toLowerCase());
+        if (!provider) {
+            p.log.error(`Unknown provider: ${providerName}`);
+            p.log.info(`Available providers: ${AVAILABLE_PROVIDERS.map((p) => p.value).join(", ")}`);
+            process.exit(1);
+        }
+        p.log.info(`Testing ${provider.label}...`);
+        p.log.warn("Provider testing requires API keys in environment or config.");
+    }
+    else {
+        p.log.info("Testing all configured providers...");
+        p.log.warn("Provider testing requires API keys in environment or config.");
+    }
+    p.outro("Test complete");
+}
+/**
+ * List configured providers
+ */
+export async function listProviders() {
+    const configPath = getConfigPath();
+    if (!fs.existsSync(configPath)) {
+        console.log("No configuration file found.");
+        console.log("Run 'foundation setup' to configure providers.");
+        return;
+    }
+    try {
+        const configContent = fs.readFileSync(configPath, "utf-8");
+        const { parse } = await import("yaml");
+        const config = parse(configContent);
+        if (!config.providers || Object.keys(config.providers).length === 0) {
+            console.log("No providers configured.");
+            console.log("Run 'foundation setup' to add providers.");
+            return;
+        }
+        console.log();
+        console.log(color.bold("Configured Providers:"));
+        console.log();
+        for (const [name, providerConfig] of Object.entries(config.providers)) {
+            const accessMode = providerConfig.access_mode ?? "api";
+            const model = providerConfig.default_model ?? "default";
+            const hasApiKey = providerConfig.api_key ? "✓" : "✗";
+            console.log(`  ${color.cyan(name.padEnd(12))} ${accessMode.padEnd(14)} ${model}`);
+            if (accessMode === "api") {
+                console.log(`    ${color.dim(`API Key: ${hasApiKey}`)}`);
+            }
+        }
+        console.log();
+    }
+    catch (error) {
+        console.error("Error reading configuration:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=setup-wizard.js.map