@pellux/goodvibes-sdk 0.18.14 → 0.18.16

package/dist/_internal/platform/providers/auto-register.js

@@ -0,0 +1,359 @@
+/**
+ * auto-register.ts
+ *
+ * Automatically registers providers when their API keys are detected in the environment.
+ *
+ * When a user has an API key set in their environment (e.g. GROQ_API_KEY),
+ * auto-register that provider using catalog data — zero manual configuration.
+ *
+ * Multi-endpoint providers (e.g. ZenMux) are handled by registering separate
+ * provider instances for each endpoint, routed by the model's native API format.
+ */
+import { OpenAICompatProvider } from './openai-compat.js';
+import { AnthropicCompatProvider } from './anthropic-compat.js';
+import { hasKeyForProvider } from './model-catalog.js';
+import { logger } from '@pellux/goodvibes-sdk/platform/utils/logger';
+import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils/error-display';
+// ---------------------------------------------------------------------------
+// Catalog of auto-registerable providers
+// ---------------------------------------------------------------------------
+/**
+ * Well-known providers that can be auto-registered from environment variables.
+ *
+ * Each entry maps to one registered LLM provider instance. Multi-endpoint
+ * providers (e.g. ZenMux) appear multiple times — once per endpoint — with
+ * distinct `id` and `name` values (e.g. 'zenmux' and 'zenmux-anthropic').
+ *
+ * Order determines registration priority when multiple providers offer the
+ * same model. Earlier entries take precedence in the auto-registration log.
+ */
+export const AUTO_REGISTER_CATALOG = [
+    // -------------------------------------------------------------------------
+    // Free / no-key-required providers
+    // -------------------------------------------------------------------------
+    {
+        id: 'nvidia',
+        name: 'NVIDIA',
+        envVars: ['NVIDIA_API_KEY', 'NIM_API_KEY'],
+        baseUrl: 'https://integrate.api.nvidia.com/v1',
+        apiFormat: 'openai',
+        defaultModel: 'meta/llama-4-scout-17b-16e-instruct',
+        seedModels: [
+            'meta/llama-4-scout-17b-16e-instruct',
+            'nvidia/llama-3.1-nemotron-ultra-253b-v1',
+            'moonshotai/kimi-k2-instruct',
+        ],
+    },
+    // -------------------------------------------------------------------------
+    // OpenAI-compatible paid providers
+    // -------------------------------------------------------------------------
+    {
+        id: 'groq',
+        name: 'Groq',
+        envVars: ['GROQ_API_KEY'],
+        baseUrl: 'https://api.groq.com/openai/v1',
+        apiFormat: 'openai',
+        defaultModel: 'qwen/qwen3-32b',
+        seedModels: [
+            'qwen/qwen3-32b',
+            'moonshotai/kimi-k2-instruct',
+            'llama-3.3-70b-versatile',
+            'llama-3.1-8b-instant',
+        ],
+    },
+    {
+        id: 'cerebras',
+        name: 'Cerebras',
+        envVars: ['CEREBRAS_API_KEY'],
+        baseUrl: 'https://api.cerebras.ai/v1',
+        apiFormat: 'openai',
+        defaultModel: 'qwen-3-235b-a22b-instruct-2507',
+        seedModels: [
+            'qwen-3-235b-a22b-instruct-2507',
+            'llama3.1-8b',
+        ],
+    },
+    {
+        id: 'together',
+        name: 'Together AI',
+        envVars: ['TOGETHER_API_KEY'],
+        baseUrl: 'https://api.together.xyz/v1',
+        apiFormat: 'openai',
+        defaultModel: 'meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8',
+        seedModels: [
+            'meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8',
+            'Qwen/Qwen3-235B-A22B-fp8-tput',
+            'moonshotai/Kimi-K2-Instruct',
+        ],
+    },
+    {
+        id: 'fireworks',
+        name: 'Fireworks',
+        envVars: ['FIREWORKS_API_KEY'],
+        baseUrl: 'https://api.fireworks.ai/inference/v1',
+        apiFormat: 'openai',
+        defaultModel: 'accounts/fireworks/models/kimi-k2p5-turbo',
+        seedModels: [
+            'accounts/fireworks/models/kimi-k2p5-turbo',
+            'accounts/fireworks/models/llama-v3p1-405b-instruct',
+        ],
+    },
+    {
+        id: 'mistral',
+        name: 'Mistral',
+        envVars: ['MISTRAL_API_KEY'],
+        baseUrl: 'https://api.mistral.ai/v1',
+        apiFormat: 'openai',
+        defaultModel: 'mistral-large-latest',
+        seedModels: [
+            'mistral-large-latest',
+            'codestral-latest',
+            'mistral-small-latest',
+        ],
+    },
+    {
+        id: 'cohere',
+        name: 'Cohere',
+        envVars: ['COHERE_API_KEY', 'CO_API_KEY'],
+        baseUrl: 'https://api.cohere.com/v2',
+        apiFormat: 'openai',
+        defaultModel: 'command-a-03-2025',
+        seedModels: [
+            'command-a-03-2025',
+            'command-r-plus-08-2024',
+        ],
+    },
+    {
+        id: 'deepinfra',
+        name: 'DeepInfra',
+        envVars: ['DEEPINFRA_API_KEY'],
+        baseUrl: 'https://api.deepinfra.com/v1/openai',
+        apiFormat: 'openai',
+        defaultModel: 'moonshotai/Kimi-K2-Instruct',
+        seedModels: [
+            'moonshotai/Kimi-K2-Instruct',
+            'meta-llama/Llama-4-Maverick-17B-128E-Instruct',
+        ],
+    },
+    {
+        id: 'huggingface',
+        name: 'HuggingFace',
+        envVars: ['HF_TOKEN', 'HUGGINGFACE_API_KEY', 'HUGGING_FACE_HUB_TOKEN'],
+        baseUrl: 'https://api-inference.huggingface.co/v1',
+        apiFormat: 'openai',
+        defaultModel: 'Qwen/Qwen3-235B-A22B',
+        seedModels: [
+            'Qwen/Qwen3-235B-A22B',
+            'moonshotai/Kimi-K2-Instruct',
+        ],
+    },
+    {
+        id: 'xai',
+        name: 'xAI',
+        envVars: ['XAI_API_KEY'],
+        baseUrl: 'https://api.x.ai/v1',
+        apiFormat: 'openai',
+        defaultModel: 'grok-4',
+        seedModels: [
+            'grok-4',
+            'grok-3-mini',
+        ],
+    },
+    {
+        id: 'perplexity',
+        name: 'Perplexity',
+        envVars: ['PERPLEXITY_API_KEY'],
+        baseUrl: 'https://api.perplexity.ai',
+        apiFormat: 'openai',
+        defaultModel: 'sonar-pro',
+        seedModels: [
+            'sonar-pro',
+            'sonar',
+            'r1-1776',
+        ],
+    },
+    {
+        id: 'sambanova',
+        name: 'SambaNova',
+        envVars: ['SAMBANOVA_API_KEY'],
+        baseUrl: 'https://fast-api.snova.ai/v1',
+        apiFormat: 'openai',
+        defaultModel: 'Llama-4-Maverick-17B-128E-Instruct',
+        seedModels: [
+            'Llama-4-Maverick-17B-128E-Instruct',
+            'Meta-Llama-3.3-70B-Instruct',
+        ],
+    },
+    {
+        id: 'opencode-zen',
+        name: 'OpenCode Zen',
+        envVars: ['OPENCODE_ZEN_API_KEY', 'ZEN_API_KEY'],
+        baseUrl: 'https://zenmux.ai/api/v1',
+        apiFormat: 'openai',
+        defaultModel: 'kimi-k2.5-free',
+        seedModels: [
+            'kimi-k2.5-free',
+            'gpt-oss-120b-free',
+        ],
+    },
+    // -------------------------------------------------------------------------
+    // ZenMux: multi-endpoint provider
+    // OpenAI-compatible endpoint (primary)
+    // -------------------------------------------------------------------------
+    {
+        id: 'zenmux',
+        name: 'ZenMux',
+        envVars: ['ZENMUX_API_KEY'],
+        baseUrl: 'https://zenmux.ai/api/v1',
+        apiFormat: 'openai',
+        defaultModel: 'gpt-5.4',
+        seedModels: [
+            'gpt-5.4',
+            'gpt-5-mini',
+            'kimi-k2-instruct',
+        ],
+    },
+    // ZenMux: Anthropic-compatible endpoint (secondary)
+    {
+        id: 'zenmux-anthropic',
+        name: 'ZenMux (Anthropic)',
+        envVars: ['ZENMUX_API_KEY'],
+        baseUrl: 'https://zenmux.ai/api/anthropic/v1',
+        apiFormat: 'anthropic',
+        defaultModel: 'claude-opus-4-6',
+        seedModels: [
+            'claude-opus-4-6',
+            'claude-sonnet-4-6',
+            'claude-haiku-4-5',
+        ],
+    },
+    // -------------------------------------------------------------------------
+    // Ollama Cloud / self-hosted
+    // -------------------------------------------------------------------------
+    {
+        id: 'ollama-cloud',
+        name: 'Ollama Cloud',
+        envVars: ['OLLAMA_API_KEY', 'OLLAMA_HOST'],
+        baseUrl: 'https://ollama.com/api',
+        apiFormat: 'openai',
+        defaultModel: 'llama3.3',
+        seedModels: [
+            'llama3.3',
+            'qwen3:32b',
+        ],
+    },
+];
+// ---------------------------------------------------------------------------
+// Internal helpers (exported for testing)
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a provider ID is already registered in the provider registry.
+ * Uses try/catch since ProviderRegistry.get() throws on missing providers.
+ *
+ * @internal Exported for testing.
+ */
+export function isProviderRegistered(providerRegistry, providerId) {
+    try {
+        providerRegistry.get(providerId);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve the API key to use for a provider entry.
+ * Returns the first non-empty env var value, or empty string.
+ *
+ * @internal Exported for testing.
+ */
+export function resolveApiKey(entry) {
+    for (const varName of entry.envVars) {
+        const val = process.env[varName];
+        if (typeof val === 'string' && val.length > 0) {
+            return val;
+        }
+    }
+    return '';
+}
+/**
+ * Create an LLMProvider instance from an AutoRegisterEntry.
+ * Routes to the correct provider class based on apiFormat.
+ *
+ * @internal Exported for testing.
+ */
+export function createProviderFromEntry(entry, apiKey) {
+    const models = entry.seedModels ?? [entry.defaultModel];
+    if (entry.apiFormat === 'anthropic') {
+        return new AnthropicCompatProvider({
+            name: entry.id,
+            baseURL: entry.baseUrl,
+            apiKey,
+            defaultModel: entry.defaultModel,
+            models,
+        });
+    }
+    // Default: OpenAI-compatible
+    return new OpenAICompatProvider({
+        name: entry.id,
+        baseURL: entry.baseUrl,
+        apiKey,
+        defaultModel: entry.defaultModel,
+        models,
+        reasoningFormat: 'none',
+    });
+}
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
+/**
+ * autoRegisterProviders — scan catalog providers, check env vars, register
+ * any providers not already in the registry.
+ *
+ * Called during startup after `initCatalog()`. Safe to call multiple times;
+ * already-registered providers are skipped.
+ *
+ * @param catalog - Optional override for the provider catalog entries.
+ *   Defaults to AUTO_REGISTER_CATALOG. Pass a custom list in tests.
+ * @returns Array of display names that were newly registered.
+ *
+ * @example
+ * // Startup sequence:
+ * // const names = autoRegisterProviders();
+ * // if (names.length > 0) {
+ * //   conversation.addSystemMessage(`Auto-registered ${names.length} providers: ${names.join(', ')}`);
+ * // }
+ */
+export function autoRegisterProviders(providerRegistry, catalog = AUTO_REGISTER_CATALOG) {
+    const registered = [];
+    for (const entry of catalog) {
+        // Skip if env var not set (no key available)
+        if (!hasKeyForProvider(entry)) {
+            continue;
+        }
+        // Skip if provider is already registered (built-in or previously auto-registered)
+        if (isProviderRegistered(providerRegistry, entry.id)) {
+            continue;
+        }
+        const apiKey = resolveApiKey(entry);
+        try {
+            const provider = createProviderFromEntry(entry, apiKey);
+            providerRegistry.register(provider);
+            registered.push(entry.name);
+        }
+        catch (err) {
+            const errMsg = summarizeError(err);
+            // IMPORTANT: Use logger (NOT process.stderr.write) for all output here.
+            // process.stderr.write bypasses the TUI renderer and writes directly to the
+            // terminal, corrupting the cell-based display. All diagnostic output in a TUI
+            // app must go through the logger, which writes to the log file without
+            // disrupting the screen.
+            logger.warn(`[auto-register] Failed to register ${entry.name}: ${errMsg}`);
+        }
+    }
+    if (registered.length > 0) {
+        const noun = registered.length === 1 ? 'provider' : 'providers';
+        logger.info(`[auto-register] Auto-registered ${registered.length} ${noun}: ${registered.join(', ')}`);
+    }
+    return registered;
+}

package/dist/_internal/platform/providers/builtin-catalog.d.ts

@@ -0,0 +1,41 @@
+import type { OpenAICompatOptions } from './openai-compat.js';
+import type { AnthropicCompatOptions } from './anthropic-compat.js';
+export interface BuiltinProviderDefinition {
+    readonly id: string;
+    readonly label: string;
+    readonly envVars: readonly string[];
+    readonly serviceNames?: readonly string[];
+    readonly aliases?: readonly string[];
+    readonly subscriptionProviderId?: string;
+}
+export interface BuiltinOpenAICompatDefinition extends BuiltinProviderDefinition {
+    readonly kind: 'openai-compat';
+    readonly baseURL: string;
+    readonly defaultModel: string;
+    readonly models: readonly string[];
+    readonly embeddingModel?: string;
+    readonly reasoningFormat?: OpenAICompatOptions['reasoningFormat'];
+    readonly suppressedModels?: readonly string[];
+    readonly streamProtocol?: string;
+    readonly defaultHeaders?: Record<string, string>;
+    readonly allowAnonymous?: boolean;
+    readonly anonymousConfigured?: boolean;
+    readonly anonymousDetail?: string;
+}
+export interface BuiltinAnthropicCompatDefinition extends BuiltinProviderDefinition {
+    readonly kind: 'anthropic-compat';
+    readonly baseURL: string;
+    readonly defaultModel: string;
+    readonly models: readonly string[];
+    readonly defaultHeaders?: Record<string, string>;
+    readonly authHeaderMode?: AnthropicCompatOptions['authHeaderMode'];
+    readonly streamProtocol?: string;
+    readonly allowAnonymous?: boolean;
+    readonly anonymousConfigured?: boolean;
+    readonly anonymousDetail?: string;
+}
+export type BuiltinCompatDefinition = BuiltinOpenAICompatDefinition | BuiltinAnthropicCompatDefinition;
+export declare const BUILTIN_PROVIDER_ENV_KEYS: Record<string, readonly string[]>;
+export declare function getBuiltinProviderEnvVars(providerId: string): readonly string[];
+export declare const BUILTIN_COMPAT_PROVIDERS: readonly BuiltinCompatDefinition[];
+//# sourceMappingURL=builtin-catalog.d.ts.map

package/dist/_internal/platform/providers/builtin-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-catalog.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/providers/builtin-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED,MAAM,WAAW,6BAA8B,SAAQ,yBAAyB;IAC9E,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IAClE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,gCAAiC,SAAQ,yBAAyB;IACjF,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IACnE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,MAAM,uBAAuB,GAC/B,6BAA6B,GAC7B,gCAAgC,CAAC;AAErC,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CA+CvE,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAE/E;AAED,eAAO,MAAM,wBAAwB,EAAE,SAAS,uBAAuB,EAoOtE,CAAC"}

package/dist/_internal/platform/providers/builtin-catalog.js

@@ -0,0 +1,280 @@
+export const BUILTIN_PROVIDER_ENV_KEYS = {
+    openai: ['OPENAI_API_KEY', 'OPENAI_KEY'],
+    anthropic: ['ANTHROPIC_API_KEY', 'CLAUDE_API_KEY'],
+    gemini: ['GEMINI_API_KEY', 'GOOGLE_API_KEY', 'GOOGLE_GEMINI_API_KEY'],
+    inceptionlabs: ['INCEPTION_API_KEY'],
+    openrouter: ['OPENROUTER_API_KEY'],
+    aihubmix: ['AIHUBMIX_API_KEY'],
+    groq: ['GROQ_API_KEY'],
+    cerebras: ['CEREBRAS_API_KEY'],
+    mistral: ['MISTRAL_API_KEY'],
+    'ollama-cloud': ['OLLAMA_CLOUD_API_KEY', 'OLLAMA_API_KEY'],
+    huggingface: ['HF_API_KEY', 'HUGGINGFACE_API_KEY', 'HF_TOKEN', 'HUGGING_FACE_HUB_TOKEN'],
+    nvidia: ['NVIDIA_API_KEY', 'NIM_API_KEY'],
+    llm7: ['LLM7_API_KEY'],
+    'amazon-bedrock': ['AWS_BEARER_TOKEN_BEDROCK', 'AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY'],
+    'amazon-bedrock-mantle': ['AWS_BEARER_TOKEN_BEDROCK', 'AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY'],
+    'anthropic-vertex': ['GOOGLE_APPLICATION_CREDENTIALS', 'ANTHROPIC_VERTEX_PROJECT_ID', 'GOOGLE_CLOUD_PROJECT', 'GOOGLE_CLOUD_PROJECT_ID'],
+    deepseek: ['DEEPSEEK_API_KEY'],
+    fireworks: ['FIREWORKS_API_KEY'],
+    'github-copilot': ['COPILOT_GITHUB_TOKEN', 'GH_TOKEN', 'GITHUB_TOKEN'],
+    'microsoft-foundry': ['AZURE_OPENAI_API_KEY'],
+    minimax: ['MINIMAX_API_KEY'],
+    moonshot: ['MOONSHOT_API_KEY'],
+    qianfan: ['QIANFAN_API_KEY'],
+    qwen: ['QWEN_API_KEY', 'DASHSCOPE_API_KEY', 'MODELSTUDIO_API_KEY'],
+    sglang: ['SGLANG_API_KEY'],
+    stepfun: ['STEPFUN_API_KEY'],
+    together: ['TOGETHER_API_KEY'],
+    venice: ['VENICE_API_KEY'],
+    volcengine: ['VOLCANO_ENGINE_API_KEY'],
+    xai: ['XAI_API_KEY'],
+    xiaomi: ['XIAOMI_API_KEY'],
+    zai: ['ZAI_API_KEY', 'Z_AI_API_KEY'],
+    'cloudflare-ai-gateway': ['CLOUDFLARE_AI_GATEWAY_API_KEY'],
+    'vercel-ai-gateway': ['AI_GATEWAY_API_KEY'],
+    litellm: ['LITELLM_API_KEY'],
+    'copilot-proxy': ['COPILOT_PROXY_API_KEY'],
+    perplexity: ['PERPLEXITY_API_KEY'],
+    deepgram: ['DEEPGRAM_API_KEY'],
+    elevenlabs: ['ELEVENLABS_API_KEY', 'XI_API_KEY'],
+    microsoft: [],
+    vydra: ['VYDRA_API_KEY'],
+    byteplus: ['BYTEPLUS_API_KEY'],
+    fal: ['FAL_KEY', 'FAL_API_KEY'],
+    comfy: ['COMFY_API_KEY'],
+    runway: ['RUNWAYML_API_SECRET', 'RUNWAY_API_KEY'],
+    alibaba: ['MODELSTUDIO_API_KEY', 'DASHSCOPE_API_KEY', 'QWEN_API_KEY'],
+};
+export function getBuiltinProviderEnvVars(providerId) {
+    return BUILTIN_PROVIDER_ENV_KEYS[providerId] ?? [];
+}
+export const BUILTIN_COMPAT_PROVIDERS = [
+    {
+        kind: 'openai-compat',
+        id: 'deepseek',
+        label: 'DeepSeek',
+        envVars: getBuiltinProviderEnvVars('deepseek'),
+        serviceNames: ['deepseek'],
+        baseURL: 'https://api.deepseek.com',
+        defaultModel: 'deepseek-chat',
+        models: ['deepseek-chat', 'deepseek-reasoner'],
+        aliases: ['deepseek-ai'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'fireworks',
+        label: 'Fireworks',
+        envVars: getBuiltinProviderEnvVars('fireworks'),
+        serviceNames: ['fireworks'],
+        baseURL: 'https://api.fireworks.ai/inference/v1',
+        defaultModel: 'accounts/fireworks/routers/kimi-k2p5-turbo',
+        models: [
+            'accounts/fireworks/routers/kimi-k2p5-turbo',
+            'accounts/fireworks/models/kimi-k2p5-turbo',
+            'accounts/fireworks/models/llama-v3p1-405b-instruct',
+        ],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'microsoft-foundry',
+        label: 'Microsoft Foundry',
+        envVars: getBuiltinProviderEnvVars('microsoft-foundry'),
+        serviceNames: ['microsoft-foundry'],
+        baseURL: 'https://example.openai.azure.com/openai/v1',
+        defaultModel: 'gpt-5.4',
+        models: ['gpt-5.4', 'gpt-5-mini', 'gpt-4.1', 'gpt-4o', 'o3-mini'],
+        aliases: ['azure-openai', 'azure-openai-responses'],
+        streamProtocol: 'openai-sse',
+    },
+    {
+        kind: 'anthropic-compat',
+        id: 'minimax',
+        label: 'MiniMax',
+        envVars: getBuiltinProviderEnvVars('minimax'),
+        serviceNames: ['minimax'],
+        baseURL: 'https://api.minimax.io/anthropic',
+        defaultModel: 'MiniMax-M2.7',
+        models: ['MiniMax-M2.7', 'MiniMax-M2.5', 'MiniMax-M1-80k'],
+        streamProtocol: 'anthropic-sse',
+    },
+    {
+        kind: 'openai-compat',
+        id: 'moonshot',
+        label: 'Moonshot',
+        envVars: getBuiltinProviderEnvVars('moonshot'),
+        serviceNames: ['moonshot'],
+        baseURL: 'https://api.moonshot.ai/v1',
+        defaultModel: 'kimi-k2.5',
+        models: ['kimi-k2.5', 'kimi-k2-thinking', 'kimi-k2-instruct'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'qianfan',
+        label: 'Qianfan',
+        envVars: getBuiltinProviderEnvVars('qianfan'),
+        serviceNames: ['qianfan'],
+        baseURL: 'https://qianfan.baidubce.com/v2',
+        defaultModel: 'deepseek-v3.2',
+        models: ['deepseek-v3.2', 'ernie-4.5-300b-a47b', 'ernie-4.5-turbo-32k'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'qwen',
+        label: 'Qwen',
+        envVars: getBuiltinProviderEnvVars('qwen'),
+        serviceNames: ['qwen'],
+        baseURL: 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1',
+        defaultModel: 'qwen3.5-plus',
+        models: ['qwen3.5-plus', 'qwen3-coder-plus', 'qwen3-max', 'qwen-vl-max'],
+        aliases: ['dashscope'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'sglang',
+        label: 'SGLang',
+        envVars: getBuiltinProviderEnvVars('sglang'),
+        serviceNames: ['sglang'],
+        baseURL: 'http://127.0.0.1:30000/v1',
+        defaultModel: 'default',
+        models: ['default'],
+        allowAnonymous: true,
+        anonymousConfigured: true,
+        anonymousDetail: 'SGLang usually runs as a local OpenAI-compatible server.',
+    },
+    {
+        kind: 'openai-compat',
+        id: 'stepfun',
+        label: 'StepFun',
+        envVars: getBuiltinProviderEnvVars('stepfun'),
+        serviceNames: ['stepfun'],
+        baseURL: 'https://api.stepfun.ai/v1',
+        defaultModel: 'step-3.5-flash',
+        models: ['step-3.5-flash', 'step-2-mini', 'step-1v-8k'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'together',
+        label: 'Together AI',
+        envVars: getBuiltinProviderEnvVars('together'),
+        serviceNames: ['together'],
+        baseURL: 'https://api.together.xyz/v1',
+        defaultModel: 'moonshotai/Kimi-K2.5',
+        models: [
+            'moonshotai/Kimi-K2.5',
+            'moonshotai/Kimi-K2-Instruct',
+            'meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8',
+            'Qwen/Qwen3-235B-A22B-fp8-tput',
+        ],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'venice',
+        label: 'Venice',
+        envVars: getBuiltinProviderEnvVars('venice'),
+        serviceNames: ['venice'],
+        baseURL: 'https://api.venice.ai/api/v1',
+        defaultModel: 'kimi-k2-5',
+        models: ['kimi-k2-5', 'llama-3.3-70b', 'qwen-2.5-coder-32b'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'volcengine',
+        label: 'Volcengine',
+        envVars: getBuiltinProviderEnvVars('volcengine'),
+        serviceNames: ['volcengine'],
+        baseURL: 'https://ark.cn-beijing.volces.com/api/v3',
+        defaultModel: 'doubao-seed-1-8-251228',
+        models: ['doubao-seed-1-8-251228', 'ark-code-latest', 'doubao-1.5-pro-32k'],
+        aliases: ['volcano-engine'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'xai',
+        label: 'xAI',
+        envVars: getBuiltinProviderEnvVars('xai'),
+        serviceNames: ['xai'],
+        baseURL: 'https://api.x.ai/v1',
+        defaultModel: 'grok-4',
+        models: ['grok-4', 'grok-4-fast', 'grok-4-1-fast', 'grok-code-fast-1'],
+        aliases: ['x-ai'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'xiaomi',
+        label: 'Xiaomi MiMo',
+        envVars: getBuiltinProviderEnvVars('xiaomi'),
+        serviceNames: ['xiaomi'],
+        baseURL: 'https://api.xiaomimimo.com/v1',
+        defaultModel: 'mimo-v2-flash',
+        models: ['mimo-v2-flash', 'mimo-v2-preview'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'zai',
+        label: 'Z.ai',
+        envVars: getBuiltinProviderEnvVars('zai'),
+        serviceNames: ['zai'],
+        baseURL: 'https://api.z.ai/api/paas/v4',
+        defaultModel: 'glm-5',
+        models: ['glm-5', 'glm-4.7', 'glm-4.6', 'glm-4.5-air'],
+        aliases: ['z-ai'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'cloudflare-ai-gateway',
+        label: 'Cloudflare AI Gateway',
+        envVars: getBuiltinProviderEnvVars('cloudflare-ai-gateway'),
+        serviceNames: ['cloudflare-ai-gateway'],
+        baseURL: 'https://gateway.ai.cloudflare.com/v1/account/gateway/openai',
+        defaultModel: 'claude-sonnet-4-5',
+        models: ['claude-sonnet-4-5', 'gpt-4.1', 'grok-4'],
+        aliases: ['cloudflare-gateway'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'vercel-ai-gateway',
+        label: 'Vercel AI Gateway',
+        envVars: getBuiltinProviderEnvVars('vercel-ai-gateway'),
+        serviceNames: ['vercel-ai-gateway'],
+        baseURL: 'https://ai-gateway.vercel.sh/v1',
+        defaultModel: 'anthropic/claude-opus-4.6',
+        models: ['anthropic/claude-opus-4.6', 'openai/gpt-5.4', 'xai/grok-4'],
+        aliases: ['ai-gateway'],
+    },
+    {
+        kind: 'openai-compat',
+        id: 'litellm',
+        label: 'LiteLLM',
+        envVars: getBuiltinProviderEnvVars('litellm'),
+        serviceNames: ['litellm'],
+        baseURL: 'http://localhost:4000/v1',
+        defaultModel: 'claude-opus-4-6',
+        models: ['claude-opus-4-6', 'gpt-5.4', 'gemini-3-pro'],
+        allowAnonymous: true,
+        anonymousConfigured: true,
+        anonymousDetail: 'LiteLLM commonly runs as a local or self-hosted gateway.',
+    },
+    {
+        kind: 'openai-compat',
+        id: 'copilot-proxy',
+        label: 'Copilot Proxy',
+        envVars: getBuiltinProviderEnvVars('copilot-proxy'),
+        serviceNames: ['copilot-proxy'],
+        baseURL: 'http://localhost:3000/v1',
+        defaultModel: 'gpt-5.2',
+        models: [
+            'gpt-5.2',
+            'gpt-5.2-codex',
+            'gpt-5.1',
+            'gpt-5-mini',
+            'claude-opus-4.6',
+            'claude-sonnet-4.5',
+            'gemini-3-pro',
+            'grok-code-fast-1',
+        ],
+        allowAnonymous: true,
+        anonymousConfigured: true,
+        anonymousDetail: 'Copilot Proxy is an operator-managed local gateway.',
+    },
+];