dexto 1.4.0 → 1.5.1

package/dist/cli/utils/prompt-helpers.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Consistent prompt helpers for CLI flows.
+ *
+ * These helpers wrap @clack/prompts with automatic cancel handling.
+ * Use for linear flows where cancel should exit the process.
+ */
+import * as p from '@clack/prompts';
+type SelectOptions = Parameters<typeof p.select>[0];
+type TextOptions = Parameters<typeof p.text>[0];
+type ConfirmOptions = Parameters<typeof p.confirm>[0];
+/**
+ * Select prompt that exits on cancel.
+ * Use for linear flows where cancel should abort the entire operation.
+ *
+ * @example
+ * const choice = await selectOrExit<'a' | 'b'>({
+ *   message: 'Pick one',
+ *   options: [{ value: 'a', label: 'A' }, { value: 'b', label: 'B' }]
+ * }, 'Operation cancelled');
+ */
+export declare function selectOrExit<T extends string>(options: SelectOptions, cancelMessage?: string): Promise<T>;
+/**
+ * Text prompt that exits on cancel.
+ * Use for linear flows where cancel should abort the entire operation.
+ *
+ * @example
+ * const name = await textOrExit({
+ *   message: 'Enter your name',
+ *   placeholder: 'John Doe'
+ * }, 'Operation cancelled');
+ */
+export declare function textOrExit(options: TextOptions, cancelMessage?: string): Promise<string>;
+/**
+ * Confirm prompt that exits on cancel.
+ * Use for linear flows where cancel should abort the entire operation.
+ *
+ * Note: This only exits on cancel (Ctrl+C), not when user selects "No".
+ * For "must confirm or abort" behavior, check the return value separately.
+ *
+ * @example
+ * const confirmed = await confirmOrExit({
+ *   message: 'Are you sure?'
+ * }, 'Operation cancelled');
+ */
+export declare function confirmOrExit(options: ConfirmOptions, cancelMessage?: string): Promise<boolean>;
+export {};
+//# sourceMappingURL=prompt-helpers.d.ts.map

package/dist/cli/utils/prompt-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-helpers.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/prompt-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAMpC,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAMtD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC/C,OAAO,EAAE,aAAa,EACtB,aAAa,SAAc,GAC5B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC5B,OAAO,EAAE,WAAW,EACpB,aAAa,SAAc,GAC5B,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAC/B,OAAO,EAAE,cAAc,EACvB,aAAa,SAAc,GAC5B,OAAO,CAAC,OAAO,CAAC,CAOlB"}

package/dist/cli/utils/prompt-helpers.js

@@ -0,0 +1,66 @@
+/**
+ * Consistent prompt helpers for CLI flows.
+ *
+ * These helpers wrap @clack/prompts with automatic cancel handling.
+ * Use for linear flows where cancel should exit the process.
+ */
+import * as p from '@clack/prompts';
+// =============================================================================
+// LINEAR FLOW HELPERS (cancel = exit)
+// =============================================================================
+/**
+ * Select prompt that exits on cancel.
+ * Use for linear flows where cancel should abort the entire operation.
+ *
+ * @example
+ * const choice = await selectOrExit<'a' | 'b'>({
+ *   message: 'Pick one',
+ *   options: [{ value: 'a', label: 'A' }, { value: 'b', label: 'B' }]
+ * }, 'Operation cancelled');
+ */
+export async function selectOrExit(options, cancelMessage = 'Cancelled') {
+    const result = await p.select(options);
+    if (p.isCancel(result)) {
+        p.cancel(cancelMessage);
+        process.exit(0);
+    }
+    return result;
+}
+/**
+ * Text prompt that exits on cancel.
+ * Use for linear flows where cancel should abort the entire operation.
+ *
+ * @example
+ * const name = await textOrExit({
+ *   message: 'Enter your name',
+ *   placeholder: 'John Doe'
+ * }, 'Operation cancelled');
+ */
+export async function textOrExit(options, cancelMessage = 'Cancelled') {
+    const result = await p.text(options);
+    if (p.isCancel(result)) {
+        p.cancel(cancelMessage);
+        process.exit(0);
+    }
+    return result;
+}
+/**
+ * Confirm prompt that exits on cancel.
+ * Use for linear flows where cancel should abort the entire operation.
+ *
+ * Note: This only exits on cancel (Ctrl+C), not when user selects "No".
+ * For "must confirm or abort" behavior, check the return value separately.
+ *
+ * @example
+ * const confirmed = await confirmOrExit({
+ *   message: 'Are you sure?'
+ * }, 'Operation cancelled');
+ */
+export async function confirmOrExit(options, cancelMessage = 'Cancelled') {
+    const result = await p.confirm(options);
+    if (p.isCancel(result)) {
+        p.cancel(cancelMessage);
+        process.exit(0);
+    }
+    return result;
+}

package/dist/cli/utils/provider-setup.d.ts

@@ -1,23 +1,62 @@
 import { type LLMProvider } from '@dexto/core';
 /**
- * Standardized provider options used across all setup flows
+ * Provider category for organizing the selection menu
+ */
+type ProviderCategory = 'recommended' | 'local' | 'cloud' | 'gateway' | 'enterprise';
+/**
+ * Extended provider information for setup
+ */
+interface ProviderOption {
+    value: LLMProvider;
+    label: string;
+    hint: string;
+    category: ProviderCategory;
+    apiKeyUrl?: string;
+    apiKeyPrefix?: string;
+    apiKeyMinLength?: number;
+    requiresBaseURL?: boolean;
+    envVar: string;
+    free?: boolean;
+}
+/**
+ * Provider configuration registry
+ * Organized by category for better UX
+ */
+export declare const PROVIDER_REGISTRY: Partial<Record<LLMProvider, ProviderOption>>;
+/**
+ * Interactive provider selection with back option.
+ * @returns Selected provider, '_back' if back selected, or null if cancelled
+ */
+export declare function selectProvider(): Promise<LLMProvider | '_back' | null>;
+/**
+ * Get provider display name
+ */
+export declare function getProviderDisplayName(provider: LLMProvider): string;
+/**
+ * Get provider option info
+ */
+export declare function getProviderInfo(provider: LLMProvider): ProviderOption | undefined;
+/**
+ * Legacy PROVIDER_OPTIONS for backwards compatibility with init-app
  */
 export declare const PROVIDER_OPTIONS: {
-    value: string;
+    value: LLMProvider;
     label: string;
     hint: string;
 }[];
 /**
- * Interactive provider selection using standardized options
- * @returns Selected provider or null if cancelled
+ * Get API key format hint for a provider
  */
-export declare function selectProvider(): Promise<LLMProvider>;
+export declare function getApiKeyFormatHint(provider: LLMProvider): string | null;
 /**
- * Gets display name for a provider
+ * Validates API key format for a provider with detailed error messages
  */
-export declare function getProviderDisplayName(provider: LLMProvider): string;
+export declare function validateApiKeyFormat(apiKey: string, provider: LLMProvider): {
+    valid: boolean;
+    error?: string;
+};
 /**
- * Validates API key format for a provider
+ * Legacy validation function for backwards compatibility
  */
 export declare function isValidApiKeyFormat(apiKey: string, provider: LLMProvider): boolean;
 /**
@@ -26,5 +65,24 @@ export declare function isValidApiKeyFormat(apiKey: string, provider: LLMProvide
 export declare function getProviderInstructions(provider: LLMProvider): {
     title: string;
     content: string;
+    url?: string | undefined;
 } | null;
+/**
+ * Open the API key URL in the browser
+ */
+export declare function openApiKeyUrl(provider: LLMProvider): Promise<boolean>;
+/**
+ * Check if provider requires a base URL
+ */
+export declare function providerRequiresBaseURL(provider: LLMProvider): boolean;
+/**
+ * Get default model for provider, with fallback for custom providers
+ */
+export declare function getDefaultModel(provider: LLMProvider): string;
+/**
+ * Get environment variable name for provider's API key.
+ * Uses the canonical env var from the core api-key-resolver.
+ */
+export declare function getProviderEnvVar(provider: LLMProvider): string;
+export {};
 //# sourceMappingURL=provider-setup.d.ts.map

package/dist/cli/utils/provider-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-setup.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/provider-setup.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;GAqB5B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAY3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAapE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAalF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,WAAW,GACtB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6C3C"}
+{"version":3,"file":"provider-setup.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/provider-setup.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,WAAW,EAInB,MAAM,aAAa,CAAC;AAGrB;;GAEG;AACH,KAAK,gBAAgB,GAAG,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;AAErF;;GAEG;AACH,UAAU,cAAc;IACpB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CA8H1E,CAAC;AA0FF;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,GAAG,OAAO,GAAG,IAAI,CAAC,CAoB5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS,CAEjF;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;WA1GmB,WAAW;WAAS,MAAM;UAAQ,MAAM;GA0GlC,CAAC;AAEvD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAIxE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,GACtB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA0BpC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAElF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,WAAW,GACtB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,IAAI,CAwBrE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAU3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAY7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAE/D"}

package/dist/cli/utils/provider-setup.js

@@ -1,122 +1,362 @@
 // packages/cli/src/cli/utils/provider-setup.ts
 import * as p from '@clack/prompts';
 import chalk from 'chalk';
+import open from 'open';
+import { LLM_PROVIDERS, LLM_REGISTRY, getDefaultModelForProvider, } from '@dexto/core';
+import { getPrimaryApiKeyEnvVar } from '@dexto/agent-management';
 /**
- * Standardized provider options used across all setup flows
+ * Provider configuration registry
+ * Organized by category for better UX
  */
-export const PROVIDER_OPTIONS = [
-    {
+export const PROVIDER_REGISTRY = {
+    google: {
         value: 'google',
-        label: '🟢 Google Gemini',
-        hint: 'Free tier available - Recommended for beginners',
+        label: 'Google Gemini',
+        hint: 'Free tier, 1M+ context, multimodal',
+        category: 'recommended',
+        apiKeyUrl: 'https://aistudio.google.com/apikey',
+        apiKeyPrefix: 'AIza',
+        apiKeyMinLength: 20,
+        envVar: 'GOOGLE_API_KEY',
+        free: true,
     },
-    {
+    groq: {
         value: 'groq',
-        label: '🟢 Groq',
-        hint: 'Free tier available - Very fast responses',
+        label: 'Groq',
+        hint: 'Free tier, ultra-fast inference',
+        category: 'recommended',
+        apiKeyUrl: 'https://console.groq.com/keys',
+        apiKeyPrefix: 'gsk_',
+        apiKeyMinLength: 40,
+        envVar: 'GROQ_API_KEY',
+        free: true,
     },
-    {
+    // Local providers - run AI completely on your machine
+    local: {
+        value: 'local',
+        label: 'Local Models',
+        hint: 'Run Llama, Qwen, Mistral locally - Free, private, offline',
+        category: 'local',
+        envVar: '', // No API key required
+        free: true,
+    },
+    ollama: {
+        value: 'ollama',
+        label: 'Ollama',
+        hint: 'Use Ollama server for local inference',
+        category: 'local',
+        envVar: '', // No API key required (optional OLLAMA_API_KEY for remote)
+        free: true,
+    },
+    openai: {
         value: 'openai',
-        label: '🟡 OpenAI',
-        hint: 'Most popular, requires payment',
+        label: 'OpenAI',
+        hint: 'GPT-4o, GPT-5, o1/o3 reasoning',
+        category: 'cloud',
+        apiKeyUrl: 'https://platform.openai.com/api-keys',
+        apiKeyPrefix: 'sk-',
+        apiKeyMinLength: 40,
+        envVar: 'OPENAI_API_KEY',
     },
-    {
+    anthropic: {
         value: 'anthropic',
-        label: '🟡 Anthropic',
-        hint: 'High quality models, requires payment',
+        label: 'Anthropic',
+        hint: 'Claude 4.5, best for coding',
+        category: 'cloud',
+        apiKeyUrl: 'https://console.anthropic.com/settings/keys',
+        apiKeyPrefix: 'sk-ant-',
+        apiKeyMinLength: 40,
+        envVar: 'ANTHROPIC_API_KEY',
+    },
+    xai: {
+        value: 'xai',
+        label: 'xAI',
+        hint: 'Grok models',
+        category: 'cloud',
+        apiKeyUrl: 'https://console.x.ai/team/default/api-keys',
+        envVar: 'XAI_API_KEY',
+    },
+    cohere: {
+        value: 'cohere',
+        label: 'Cohere',
+        hint: 'Command models, RAG-optimized',
+        category: 'cloud',
+        apiKeyUrl: 'https://dashboard.cohere.com/api-keys',
+        envVar: 'COHERE_API_KEY',
+    },
+    openrouter: {
+        value: 'openrouter',
+        label: 'OpenRouter',
+        hint: '100+ models, unified API',
+        category: 'gateway',
+        apiKeyUrl: 'https://openrouter.ai/keys',
+        apiKeyPrefix: 'sk-or-',
+        apiKeyMinLength: 40,
+        envVar: 'OPENROUTER_API_KEY',
+    },
+    glama: {
+        value: 'glama',
+        label: 'Glama',
+        hint: 'OpenAI-compatible gateway',
+        category: 'gateway',
+        apiKeyUrl: 'https://glama.ai/settings/api-keys',
+        envVar: 'GLAMA_API_KEY',
+    },
+    litellm: {
+        value: 'litellm',
+        label: 'LiteLLM',
+        hint: 'Self-hosted proxy for 100+ providers',
+        category: 'gateway',
+        requiresBaseURL: true,
+        envVar: 'LITELLM_API_KEY',
     },
-];
+    'openai-compatible': {
+        value: 'openai-compatible',
+        label: 'OpenAI-Compatible',
+        hint: 'Ollama, vLLM, LocalAI, or any OpenAI-format API',
+        category: 'gateway',
+        requiresBaseURL: true,
+        envVar: 'OPENAI_COMPATIBLE_API_KEY',
+    },
+    vertex: {
+        value: 'vertex',
+        label: 'Google Vertex AI',
+        hint: 'GCP-hosted Gemini & Claude (uses ADC)',
+        category: 'enterprise',
+        apiKeyUrl: 'https://console.cloud.google.com/apis/credentials',
+        envVar: 'GOOGLE_VERTEX_PROJECT',
+    },
+    bedrock: {
+        value: 'bedrock',
+        label: 'AWS Bedrock',
+        hint: 'AWS-hosted Claude & Nova (uses AWS creds)',
+        category: 'enterprise',
+        apiKeyUrl: 'https://console.aws.amazon.com/bedrock',
+        envVar: 'AWS_ACCESS_KEY_ID',
+    },
+};
+/**
+ * Get providers organized by category
+ */
+function getProvidersByCategory() {
+    const categories = {
+        recommended: [],
+        local: [],
+        cloud: [],
+        gateway: [],
+        enterprise: [],
+    };
+    for (const provider of LLM_PROVIDERS) {
+        const option = PROVIDER_REGISTRY[provider];
+        if (option) {
+            categories[option.category].push(option);
+        }
+    }
+    return categories;
+}
 /**
- * Interactive provider selection using standardized options
- * @returns Selected provider or null if cancelled
+ * Build provider selection options with categories
+ */
+function buildProviderOptions() {
+    const categories = getProvidersByCategory();
+    const options = [];
+    // Recommended (free) providers first
+    if (categories.recommended.length > 0) {
+        for (const p of categories.recommended) {
+            options.push({
+                value: p.value,
+                label: `${chalk.green('●')} ${p.label}`,
+                hint: `${p.hint} ${chalk.green('(free)')}`,
+            });
+        }
+    }
+    // Local providers - run AI on your machine
+    if (categories.local.length > 0) {
+        for (const p of categories.local) {
+            options.push({
+                value: p.value,
+                label: `${chalk.cyan('●')} ${p.label}`,
+                hint: `${p.hint} ${chalk.cyan('(local)')}`,
+            });
+        }
+    }
+    // Cloud providers
+    if (categories.cloud.length > 0) {
+        for (const p of categories.cloud) {
+            options.push({
+                value: p.value,
+                label: `${chalk.blue('●')} ${p.label}`,
+                hint: p.hint,
+            });
+        }
+    }
+    // Gateway providers
+    if (categories.gateway.length > 0) {
+        for (const p of categories.gateway) {
+            const suffix = p.requiresBaseURL ? chalk.gray(' (requires URL)') : '';
+            options.push({
+                value: p.value,
+                label: `${chalk.rgb(255, 165, 0)('●')} ${p.label}`,
+                hint: `${p.hint}${suffix}`,
+            });
+        }
+    }
+    // Enterprise providers
+    if (categories.enterprise.length > 0) {
+        for (const p of categories.enterprise) {
+            options.push({
+                value: p.value,
+                label: `${chalk.cyan('●')} ${p.label}`,
+                hint: p.hint,
+            });
+        }
+    }
+    return options;
+}
+/**
+ * Interactive provider selection with back option.
+ * @returns Selected provider, '_back' if back selected, or null if cancelled
  */
 export async function selectProvider() {
+    const options = buildProviderOptions();
     const choice = await p.select({
         message: 'Choose your AI provider',
-        options: PROVIDER_OPTIONS,
+        options: [
+            ...options,
+            {
+                value: '_back',
+                label: chalk.gray('← Back'),
+                hint: 'Return to previous menu',
+            },
+        ],
     });
     if (p.isCancel(choice)) {
-        p.cancel('Setup cancelled');
-        process.exit(1);
+        return null;
     }
     return choice;
 }
 /**
- * Gets display name for a provider
+ * Get provider display name
  */
 export function getProviderDisplayName(provider) {
-    switch (provider) {
-        case 'google':
-            return 'Google Gemini';
-        case 'openai':
-            return 'OpenAI';
-        case 'anthropic':
-            return 'Anthropic';
-        case 'groq':
-            return 'Groq';
-        default:
-            return provider;
+    return PROVIDER_REGISTRY[provider]?.label || provider;
+}
+/**
+ * Get provider option info
+ */
+export function getProviderInfo(provider) {
+    return PROVIDER_REGISTRY[provider];
+}
+/**
+ * Legacy PROVIDER_OPTIONS for backwards compatibility with init-app
+ */
+export const PROVIDER_OPTIONS = buildProviderOptions();
+/**
+ * Get API key format hint for a provider
+ */
+export function getApiKeyFormatHint(provider) {
+    const info = PROVIDER_REGISTRY[provider];
+    if (!info?.apiKeyPrefix)
+        return null;
+    return `Key should start with "${info.apiKeyPrefix}"`;
+}
+/**
+ * Validates API key format for a provider with detailed error messages
+ */
+export function validateApiKeyFormat(apiKey, provider) {
+    const info = PROVIDER_REGISTRY[provider];
+    const trimmed = apiKey.trim();
+    if (!trimmed) {
+        return { valid: false, error: 'API key cannot be empty' };
+    }
+    // Check minimum length if specified
+    if (info?.apiKeyMinLength && trimmed.length < info.apiKeyMinLength) {
+        return {
+            valid: false,
+            error: `API key seems too short (expected ${info.apiKeyMinLength}+ characters, got ${trimmed.length})`,
+        };
     }
+    // Check prefix if specified
+    if (info?.apiKeyPrefix && !trimmed.startsWith(info.apiKeyPrefix)) {
+        const prefixLen = info.apiKeyPrefix.length;
+        return {
+            valid: false,
+            error: `Invalid format: ${getProviderDisplayName(provider)} keys start with "${info.apiKeyPrefix}" (got "${trimmed.slice(0, prefixLen)}...")`,
+        };
+    }
+    return { valid: true };
 }
 /**
- * Validates API key format for a provider
+ * Legacy validation function for backwards compatibility
  */
 export function isValidApiKeyFormat(apiKey, provider) {
-    switch (provider) {
-        case 'google':
-            return apiKey.startsWith('AIza') && apiKey.length > 20;
-        case 'openai':
-            return apiKey.startsWith('sk-') && apiKey.length > 40;
-        case 'anthropic':
-            return apiKey.startsWith('sk-ant-') && apiKey.length > 40;
-        case 'groq':
-            return apiKey.startsWith('gsk_') && apiKey.length > 40;
-        default:
-            return apiKey.length > 10; // Basic length check
-    }
+    return validateApiKeyFormat(apiKey, provider).valid;
 }
 /**
  * Gets provider-specific instructions for API key setup
  */
 export function getProviderInstructions(provider) {
-    switch (provider) {
-        case 'google':
-            return {
-                title: chalk.green('Google Gemini - Free API Key'),
-                content: `1. Visit: ${chalk.cyan('https://aistudio.google.com/apikey')}\n` +
-                    `2. Sign in with your Google account\n` +
-                    `3. Click "Create API Key"\n` +
-                    `4. Copy the key\n\n` +
-                    `${chalk.dim('✨ Free tier included')}`,
-            };
-        case 'openai':
-            return {
-                title: chalk.blue('OpenAI API Key'),
-                content: `1. Visit: ${chalk.cyan('https://platform.openai.com/api-keys')}\n` +
-                    `2. Sign in to your OpenAI account\n` +
-                    `3. Click "Create new secret key"\n` +
-                    `4. Copy the key\n\n` +
-                    `${chalk.dim('💰 Requires payment')}`,
-            };
-        case 'anthropic':
-            return {
-                title: chalk.magenta('Anthropic API Key'),
-                content: `1. Visit: ${chalk.cyan('https://console.anthropic.com/settings/keys')}\n` +
-                    `2. Sign in to your Anthropic account\n` +
-                    `3. Click "Create Key"\n` +
-                    `4. Copy the key\n\n` +
-                    `${chalk.dim('💰 Requires payment')}`,
-            };
-        case 'groq':
-            return {
-                title: chalk.yellow('Groq API Key'),
-                content: `1. Visit: ${chalk.cyan('https://console.groq.com/keys')}\n` +
-                    `2. Sign in with your account\n` +
-                    `3. Click "Create API Key"\n` +
-                    `4. Copy the key\n\n` +
-                    `${chalk.dim('🆓 Free tier included')}`,
-            };
-        default:
-            return null;
+    const info = PROVIDER_REGISTRY[provider];
+    if (!info)
+        return null;
+    const freeTag = info.free ? chalk.green(' (Free)') : '';
+    const title = `${getProviderDisplayName(provider)} API Key${freeTag}`;
+    let content = '';
+    if (info.apiKeyUrl) {
+        content += `1. Visit: ${chalk.cyan(info.apiKeyUrl)}\n`;
+        content += `2. Sign in to your account\n`;
+        content += `3. Create a new API key\n`;
+        content += `4. Copy and paste it below\n`;
+    }
+    else if (info.requiresBaseURL) {
+        content += `This provider requires a custom endpoint URL.\n`;
+        content += `You'll configure both the URL and API key in the next steps.\n`;
+    }
+    if (info.apiKeyPrefix) {
+        content += `\n${chalk.gray(`Key format: ${info.apiKeyPrefix}...`)}`;
+    }
+    return { title, content, url: info.apiKeyUrl };
+}
+/**
+ * Open the API key URL in the browser
+ */
+export async function openApiKeyUrl(provider) {
+    const info = PROVIDER_REGISTRY[provider];
+    if (!info?.apiKeyUrl)
+        return false;
+    try {
+        await open(info.apiKeyUrl);
+        return true;
     }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if provider requires a base URL
+ */
+export function providerRequiresBaseURL(provider) {
+    return PROVIDER_REGISTRY[provider]?.requiresBaseURL === true;
+}
+/**
+ * Get default model for provider, with fallback for custom providers
+ */
+export function getDefaultModel(provider) {
+    const defaultModel = getDefaultModelForProvider(provider);
+    if (defaultModel)
+        return defaultModel;
+    // Fallback for providers without a default (custom providers)
+    const providerInfo = LLM_REGISTRY[provider];
+    if (providerInfo?.models && providerInfo.models.length > 0) {
+        return providerInfo.models[0].name;
+    }
+    // For providers that accept any model, return empty to prompt user
+    return '';
+}
+/**
+ * Get environment variable name for provider's API key.
+ * Uses the canonical env var from the core api-key-resolver.
+ */
+export function getProviderEnvVar(provider) {
+    return getPrimaryApiKeyEnvVar(provider);
 }