@phuetz/code-buddy 1.0.0 → 1.2.0

package/dist/config/env-schema.js

@@ -4,6 +4,24 @@
  * Central registry of all environment variables used by Code Buddy.
  * Provides validation, documentation, and a CLI summary.
  */
+function providerStringEnv(name, description, options = {}) {
+    return {
+        name,
+        type: 'string',
+        description,
+        category: 'provider',
+        ...options,
+    };
+}
+function providerNumberEnv(name, description, options = {}) {
+    return {
+        name,
+        type: 'number',
+        description,
+        category: 'provider',
+        ...options,
+    };
+}
 /**
  * Complete schema of all environment variables used across the codebase.
  */
@@ -69,6 +87,149 @@ export const ENV_SCHEMA = [
         category: 'core',
         min: 1000,
     },
+    {
+        name: 'CODEBUDDY_MIN_FREE_MB',
+        type: 'number',
+        default: '500',
+        description: 'disk-guard: min free space (MB) before a guarded write/launch is refused',
+        category: 'core',
+        min: 0,
+        max: 1000000,
+    },
+    {
+        name: 'CODEBUDDY_DISK_QUOTA_MB',
+        type: 'number',
+        default: '0',
+        description: 'disk-guard: per-session byte budget (MB); 0 = unlimited',
+        category: 'core',
+        min: 0,
+        max: 100000000,
+    },
+    {
+        name: 'CODEBUDDY_TEMP_MAX_AGE_MS',
+        type: 'number',
+        default: '0',
+        description: 'disk-guard: orphan-sweep age cutoff (ms); 0 = presence-based',
+        category: 'core',
+        min: 0,
+    },
+    {
+        name: 'CODEBUDDY_LOG_MAX_MB',
+        type: 'number',
+        default: '10',
+        description: 'disk-guard: append-log rotation size (MB)',
+        category: 'core',
+        min: 1,
+        max: 100000,
+    },
+    {
+        name: 'CODEBUDDY_LOG_MAX_FILES',
+        type: 'number',
+        default: '5',
+        description: 'disk-guard: append-log retention count',
+        category: 'core',
+        min: 1,
+        max: 1000,
+    },
+    {
+        name: 'CODEBUDDY_GOAL_MAX_TURNS',
+        type: 'number',
+        description: 'Turn budget for /goal auto-continue loops (default 20)',
+        category: 'core',
+        min: 1,
+        max: 1000,
+    },
+    {
+        name: 'CODEBUDDY_GOAL_JUDGE_MODEL',
+        type: 'string',
+        description: 'Model used by the /goal judge (default: current session model)',
+        category: 'core',
+    },
+    {
+        name: 'CODEBUDDY_RTK',
+        type: 'boolean',
+        default: 'false',
+        description: 'Enable RTK shell command rewriting for token-optimized command output',
+        category: 'core',
+    },
+    {
+        name: 'CODEBUDDY_RTK_REWRITE',
+        type: 'boolean',
+        default: 'false',
+        description: 'Alias flag for enabling RTK shell command rewriting',
+        category: 'core',
+    },
+    {
+        name: 'CODEBUDDY_RTK_TIMEOUT_MS',
+        type: 'number',
+        default: '1000',
+        description: 'Timeout for rtk rewrite calls before falling back to the original command',
+        category: 'core',
+        min: 50,
+        max: 10000,
+    },
+    {
+        name: 'CODEBUDDY_FALLBACK_PROVIDERS',
+        type: 'string',
+        description: 'Comma-separated provider[:model] fallbacks tried when the primary LLM chat call fails',
+        category: 'core',
+    },
+    {
+        name: 'CODEBUDDY_FALLBACK_PROVIDER',
+        type: 'string',
+        description: 'Single fallback provider id or alias, optionally paired with CODEBUDDY_FALLBACK_MODEL',
+        category: 'core',
+    },
+    {
+        name: 'CODEBUDDY_FALLBACK_MODEL',
+        type: 'string',
+        description: 'Fallback model used with CODEBUDDY_FALLBACK_PROVIDER',
+        category: 'core',
+    },
+    {
+        name: 'CODEBUDDY_MEMORY_ENFORCE_LIMITS',
+        type: 'boolean',
+        default: 'true',
+        description: 'Reject persistent-memory writes that exceed Hermes-style character budgets',
+        category: 'core',
+    },
+    {
+        name: 'CODEBUDDY_MEMORY_PROJECT_CHAR_LIMIT',
+        type: 'number',
+        default: '2200',
+        description: 'Character budget for project persistent memory',
+        category: 'core',
+        min: 1,
+    },
+    {
+        name: 'CODEBUDDY_MEMORY_USER_CHAR_LIMIT',
+        type: 'number',
+        default: '1375',
+        description: 'Character budget for user persistent memory',
+        category: 'core',
+        min: 1,
+    },
+    {
+        name: 'CODEBUDDY_MEMORY_SECURITY_SCAN',
+        type: 'boolean',
+        default: 'true',
+        description: 'Reject prompt-injection, exfiltration, private-key, and invisible-Unicode memory writes',
+        category: 'core',
+    },
+    {
+        name: 'CODEBUDDY_MEMORY_REJECT_DUPLICATES',
+        type: 'boolean',
+        default: 'true',
+        description: 'Return success without writing when a persistent memory entry is an exact duplicate',
+        category: 'core',
+    },
+    {
+        name: 'CODEBUDDY_MEMORY_AUTO_PROPOSE',
+        type: 'boolean',
+        default: 'true',
+        description: 'At session end, enqueue review-gated long-term memory candidates from the transcript',
+        category: 'core',
+    },
     {
         name: 'GROK_FORCE_TOOLS',
         type: 'boolean',
@@ -123,6 +284,19 @@ export const ENV_SCHEMA = [
         sensitive: true,
         category: 'provider',
     },
+    {
+        name: 'CODEBUDDY_PROVIDER',
+        type: 'string',
+        description: 'Force the runtime provider id (for example chatgpt, ollama, openrouter, groq)',
+        category: 'provider',
+    },
+    {
+        name: 'CHATGPT_MODEL',
+        type: 'string',
+        default: 'gpt-5.5',
+        description: 'Default model for ChatGPT OAuth / Codex Responses backend',
+        category: 'provider',
+    },
     {
         name: 'OPENAI_API_KEY',
         type: 'string',
@@ -179,6 +353,602 @@ export const ENV_SCHEMA = [
         description: 'Default Gemini model',
         category: 'provider',
     },
+    {
+        name: 'OLLAMA_HOST',
+        type: 'string',
+        default: 'http://localhost:11434',
+        description: 'Ollama host; normalized to /v1 for OpenAI-compatible calls',
+        category: 'provider',
+    },
+    {
+        name: 'OLLAMA_MODEL',
+        type: 'string',
+        default: 'qwen2.5-coder:7b',
+        description: 'Default Ollama model',
+        category: 'provider',
+    },
+    {
+        name: 'LMSTUDIO_HOST',
+        type: 'string',
+        default: 'http://localhost:1234',
+        description: 'LM Studio local server host; normalized to /v1',
+        category: 'provider',
+    },
+    {
+        name: 'LM_STUDIO_HOST',
+        type: 'string',
+        default: 'http://localhost:1234',
+        description: 'Alias for LMSTUDIO_HOST',
+        category: 'provider',
+    },
+    {
+        name: 'LMSTUDIO_MODEL',
+        type: 'string',
+        default: 'local-model',
+        description: 'Default LM Studio model',
+        category: 'provider',
+    },
+    {
+        name: 'MISTRAL_API_KEY',
+        type: 'string',
+        description: 'Mistral API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'MISTRAL_MODEL',
+        type: 'string',
+        default: 'mistral-large-latest',
+        description: 'Default Mistral model',
+        category: 'provider',
+    },
+    {
+        name: 'GROQ_API_KEY',
+        type: 'string',
+        description: 'Groq API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'GROQ_MODEL',
+        type: 'string',
+        default: 'llama-3.3-70b-versatile',
+        description: 'Default Groq model',
+        category: 'provider',
+    },
+    {
+        name: 'TOGETHER_API_KEY',
+        type: 'string',
+        description: 'Together AI API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'TOGETHER_MODEL',
+        type: 'string',
+        default: 'meta-llama/Llama-3.3-70B-Instruct-Turbo',
+        description: 'Default Together AI model',
+        category: 'provider',
+    },
+    {
+        name: 'FIREWORKS_API_KEY',
+        type: 'string',
+        description: 'Fireworks AI API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'FIREWORKS_MODEL',
+        type: 'string',
+        default: 'accounts/fireworks/models/llama-v3p1-70b-instruct',
+        description: 'Default Fireworks model',
+        category: 'provider',
+    },
+    {
+        name: 'OPENROUTER_MODEL',
+        type: 'string',
+        default: 'openai/gpt-4o',
+        description: 'Default OpenRouter model',
+        category: 'provider',
+    },
+    providerStringEnv('OPENROUTER_PROVIDER_SORT', 'OpenRouter provider ranking: price, throughput, or latency'),
+    providerStringEnv('OPENROUTER_PROVIDER_ONLY', 'Comma-separated OpenRouter sub-provider allowlist'),
+    providerStringEnv('OPENROUTER_PROVIDER_IGNORE', 'Comma-separated OpenRouter sub-provider denylist'),
+    providerStringEnv('OPENROUTER_PROVIDER_ORDER', 'Comma-separated OpenRouter sub-provider priority order'),
+    {
+        name: 'OPENROUTER_PROVIDER_REQUIRE_PARAMETERS',
+        type: 'boolean',
+        description: 'Require OpenRouter sub-providers to support every requested parameter',
+        category: 'provider',
+    },
+    providerStringEnv('OPENROUTER_PROVIDER_DATA_COLLECTION', 'OpenRouter data collection policy: allow or deny'),
+    {
+        name: 'OPENROUTER_PROVIDER_ALLOW_FALLBACKS',
+        type: 'boolean',
+        description: 'Allow OpenRouter to fall back to other sub-providers when routed providers fail',
+        category: 'provider',
+    },
+    providerStringEnv('CODEBUDDY_OPENROUTER_PROVIDER_SORT', 'Alias for OPENROUTER_PROVIDER_SORT'),
+    providerStringEnv('CODEBUDDY_OPENROUTER_PROVIDER_ONLY', 'Alias for OPENROUTER_PROVIDER_ONLY'),
+    providerStringEnv('CODEBUDDY_OPENROUTER_PROVIDER_IGNORE', 'Alias for OPENROUTER_PROVIDER_IGNORE'),
+    providerStringEnv('CODEBUDDY_OPENROUTER_PROVIDER_ORDER', 'Alias for OPENROUTER_PROVIDER_ORDER'),
+    {
+        name: 'CODEBUDDY_OPENROUTER_PROVIDER_REQUIRE_PARAMETERS',
+        type: 'boolean',
+        description: 'Alias for OPENROUTER_PROVIDER_REQUIRE_PARAMETERS',
+        category: 'provider',
+    },
+    providerStringEnv('CODEBUDDY_OPENROUTER_PROVIDER_DATA_COLLECTION', 'Alias for OPENROUTER_PROVIDER_DATA_COLLECTION'),
+    {
+        name: 'CODEBUDDY_OPENROUTER_PROVIDER_ALLOW_FALLBACKS',
+        type: 'boolean',
+        description: 'Alias for OPENROUTER_PROVIDER_ALLOW_FALLBACKS',
+        category: 'provider',
+    },
+    providerStringEnv('CODEBUDDY_AUXILIARY_PROVIDER', 'Default auxiliary-task provider: auto, main, or a runtime provider id/alias'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_MODEL', 'Default auxiliary-task model override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_BASE_URL', 'Default auxiliary-task base URL override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_API_KEY', 'Default auxiliary-task API key override', { sensitive: true }),
+    providerNumberEnv('CODEBUDDY_AUXILIARY_TIMEOUT_MS', 'Default auxiliary-task timeout in milliseconds', { min: 1 }),
+    providerStringEnv('CODEBUDDY_AUXILIARY_EXTRA_BODY', 'Default auxiliary-task JSON request-body extras'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_VISION_PROVIDER', 'Vision auxiliary provider override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_VISION_MODEL', 'Vision auxiliary model override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_VISION_BASE_URL', 'Vision auxiliary base URL override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_VISION_API_KEY', 'Vision auxiliary API key override', { sensitive: true }),
+    providerNumberEnv('CODEBUDDY_AUXILIARY_VISION_TIMEOUT_MS', 'Vision auxiliary timeout in milliseconds', { default: '120000', min: 1 }),
+    providerStringEnv('AUXILIARY_VISION_MODEL', 'Hermes-compatible vision auxiliary model override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_BROWSER_VISION_PROVIDER', 'Browser vision auxiliary provider override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_BROWSER_VISION_MODEL', 'Browser vision auxiliary model override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_WEB_EXTRACT_PROVIDER', 'Web extraction auxiliary provider override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_WEB_EXTRACT_MODEL', 'Web extraction auxiliary model override'),
+    providerNumberEnv('CODEBUDDY_AUXILIARY_WEB_EXTRACT_TIMEOUT_MS', 'Web extraction auxiliary timeout in milliseconds', { default: '360000', min: 1 }),
+    providerStringEnv('CODEBUDDY_AUXILIARY_APPROVAL_PROVIDER', 'Approval-classifier auxiliary provider override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_APPROVAL_MODEL', 'Approval-classifier auxiliary model override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_APPROVAL_API_KEY', 'Approval-classifier auxiliary API key override', { sensitive: true }),
+    providerNumberEnv('CODEBUDDY_AUXILIARY_APPROVAL_TIMEOUT_MS', 'Approval-classifier auxiliary timeout in milliseconds', { default: '30000', min: 1 }),
+    providerStringEnv('CODEBUDDY_AUXILIARY_COMPRESSION_PROVIDER', 'Context compression auxiliary provider override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_COMPRESSION_MODEL', 'Context compression auxiliary model override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_COMPRESSION_API_KEY', 'Context compression auxiliary API key override', { sensitive: true }),
+    providerStringEnv('CODEBUDDY_AUXILIARY_COMPRESSION_EXTRA_BODY', 'Context compression auxiliary JSON request-body extras'),
+    providerNumberEnv('CODEBUDDY_AUXILIARY_COMPRESSION_TIMEOUT_MS', 'Context compression auxiliary timeout in milliseconds', { default: '120000', min: 1 }),
+    providerStringEnv('CODEBUDDY_AUXILIARY_SKILLS_HUB_PROVIDER', 'Skills hub auxiliary provider override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_SKILLS_HUB_MODEL', 'Skills hub auxiliary model override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_MCP_PROVIDER', 'MCP dispatch auxiliary provider override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_MCP_MODEL', 'MCP dispatch auxiliary model override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_TRIAGE_SPECIFIER_PROVIDER', 'Triage specifier auxiliary provider override'),
+    providerStringEnv('CODEBUDDY_AUXILIARY_TRIAGE_SPECIFIER_MODEL', 'Triage specifier auxiliary model override'),
+    providerNumberEnv('CODEBUDDY_AUXILIARY_TRIAGE_SPECIFIER_TIMEOUT_MS', 'Triage specifier auxiliary timeout in milliseconds', { default: '120000', min: 1 }),
+    {
+        name: 'NOVITA_API_KEY',
+        type: 'string',
+        description: 'NovitaAI API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'NOVITA_BASE_URL',
+        type: 'string',
+        default: 'https://api.novita.ai/openai/v1',
+        description: 'NovitaAI OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'NOVITA_MODEL',
+        type: 'string',
+        default: 'moonshotai/kimi-k2.5',
+        description: 'Default NovitaAI model',
+        category: 'provider',
+    },
+    {
+        name: 'GLM_API_KEY',
+        type: 'string',
+        description: 'z.ai / GLM API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'ZAI_API_KEY',
+        type: 'string',
+        description: 'Alias API key for z.ai / GLM',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'GLM_BASE_URL',
+        type: 'string',
+        default: 'https://api.z.ai/api/paas/v4',
+        description: 'z.ai / GLM OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'GLM_MODEL',
+        type: 'string',
+        default: 'glm-5',
+        description: 'Default z.ai / GLM model',
+        category: 'provider',
+    },
+    {
+        name: 'KIMI_API_KEY',
+        type: 'string',
+        description: 'Kimi / Moonshot API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'KIMI_BASE_URL',
+        type: 'string',
+        default: 'https://api.moonshot.ai/v1',
+        description: 'Kimi / Moonshot OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'KIMI_MODEL',
+        type: 'string',
+        default: 'kimi-k2.5',
+        description: 'Default Kimi model',
+        category: 'provider',
+    },
+    {
+        name: 'KIMI_CN_API_KEY',
+        type: 'string',
+        description: 'Kimi China API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'KIMI_CN_BASE_URL',
+        type: 'string',
+        default: 'https://api.moonshot.cn/v1',
+        description: 'Kimi China OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'ARCEEAI_API_KEY',
+        type: 'string',
+        description: 'Arcee AI API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'ARCEEAI_BASE_URL',
+        type: 'string',
+        default: 'https://api.arcee.ai/api/v1',
+        description: 'Arcee AI OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'GMI_API_KEY',
+        type: 'string',
+        description: 'GMI Cloud API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'GMI_BASE_URL',
+        type: 'string',
+        default: 'https://api.gmi-serving.com/v1',
+        description: 'GMI Cloud OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'MINIMAX_API_KEY',
+        type: 'string',
+        description: 'MiniMax API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'MINIMAX_BASE_URL',
+        type: 'string',
+        default: 'https://api.minimax.io/v1',
+        description: 'MiniMax OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'MINIMAX_CN_API_KEY',
+        type: 'string',
+        description: 'MiniMax China API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'MINIMAX_CN_BASE_URL',
+        type: 'string',
+        default: 'https://api.minimaxi.com/v1',
+        description: 'MiniMax China OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'DASHSCOPE_API_KEY',
+        type: 'string',
+        description: 'Alibaba Cloud DashScope API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'DASHSCOPE_BASE_URL',
+        type: 'string',
+        default: 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1',
+        description: 'DashScope OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'ALIBABA_CODING_PLAN_API_KEY',
+        type: 'string',
+        description: 'Alibaba Coding Plan API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'KILOCODE_API_KEY',
+        type: 'string',
+        description: 'Kilo Code Gateway API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'KILOCODE_BASE_URL',
+        type: 'string',
+        default: 'https://api.kilo.ai/api/gateway',
+        description: 'Kilo Code Gateway endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'XIAOMI_API_KEY',
+        type: 'string',
+        description: 'Xiaomi MiMo API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'XIAOMI_BASE_URL',
+        type: 'string',
+        default: 'https://api.xiaomimimo.com/v1',
+        description: 'Xiaomi MiMo OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'TOKENHUB_API_KEY',
+        type: 'string',
+        description: 'Tencent TokenHub API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'TOKENHUB_BASE_URL',
+        type: 'string',
+        default: 'https://tokenhub.tencentmaas.com/v1',
+        description: 'Tencent TokenHub OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'OPENCODE_ZEN_API_KEY',
+        type: 'string',
+        description: 'OpenCode Zen API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'OPENCODE_GO_API_KEY',
+        type: 'string',
+        description: 'OpenCode Go API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'DEEPSEEK_API_KEY',
+        type: 'string',
+        description: 'DeepSeek API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'DEEPSEEK_BASE_URL',
+        type: 'string',
+        default: 'https://api.deepseek.com/v1',
+        description: 'DeepSeek OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'HF_TOKEN',
+        type: 'string',
+        description: 'Hugging Face token for the OpenAI-compatible inference router',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'HF_BASE_URL',
+        type: 'string',
+        default: 'https://router.huggingface.co/v1',
+        description: 'Hugging Face inference router endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'NVIDIA_API_KEY',
+        type: 'string',
+        description: 'NVIDIA NIM API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'NVIDIA_BASE_URL',
+        type: 'string',
+        default: 'https://integrate.api.nvidia.com/v1',
+        description: 'NVIDIA NIM OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'OLLAMA_API_KEY',
+        type: 'string',
+        description: 'Ollama Cloud API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'OLLAMA_CLOUD_BASE_URL',
+        type: 'string',
+        default: 'https://ollama.com/v1',
+        description: 'Ollama Cloud OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'STEPFUN_API_KEY',
+        type: 'string',
+        description: 'StepFun API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'STEPFUN_BASE_URL',
+        type: 'string',
+        default: 'https://api.stepfun.ai/v1',
+        description: 'StepFun OpenAI-compatible endpoint',
+        category: 'provider',
+    },
+    {
+        name: 'VLLM_API_KEY',
+        type: 'string',
+        description: 'Optional vLLM API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'VLLM_BASE_URL',
+        type: 'string',
+        default: 'http://localhost:8000',
+        description: 'vLLM OpenAI-compatible server base URL',
+        category: 'provider',
+    },
+    {
+        name: 'VLLM_MODEL',
+        type: 'string',
+        default: 'model',
+        description: 'Default vLLM served model id',
+        category: 'provider',
+    },
+    {
+        name: 'CODEBUDDY_BASE_URL',
+        type: 'string',
+        description: 'Custom OpenAI-compatible provider base URL',
+        category: 'provider',
+    },
+    {
+        name: 'CODEBUDDY_API_KEY',
+        type: 'string',
+        description: 'Custom OpenAI-compatible provider API key',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'CUSTOM_PROVIDER_API_KEY',
+        type: 'string',
+        description: 'Alias API key for a custom OpenAI-compatible provider',
+        sensitive: true,
+        category: 'provider',
+    },
+    {
+        name: 'CUSTOM_PROVIDER_BASE_URL',
+        type: 'string',
+        description: 'Alias base URL for a custom OpenAI-compatible provider',
+        category: 'provider',
+    },
+    {
+        name: 'CUSTOM_PROVIDER_MODEL',
+        type: 'string',
+        description: 'Alias model id for a custom OpenAI-compatible provider',
+        category: 'provider',
+    },
+    {
+        name: 'CODEBUDDY_MODEL',
+        type: 'string',
+        description: 'Custom OpenAI-compatible provider model id',
+        category: 'provider',
+    },
+    providerStringEnv('CODEBUDDY_CHATGPT_OAUTH', 'Presence marker for ChatGPT OAuth credentials'),
+    providerStringEnv('LMSTUDIO_API_KEY', 'Optional LM Studio API key', { sensitive: true }),
+    providerStringEnv('LM_STUDIO_API_KEY', 'Alias for LMSTUDIO_API_KEY', { sensitive: true }),
+    providerStringEnv('LMSTUDIO_BASE_URL', 'Alias for LMSTUDIO_HOST'),
+    providerStringEnv('LM_STUDIO_BASE_URL', 'Alias for LM_STUDIO_HOST'),
+    providerStringEnv('LM_STUDIO_MODEL', 'Alias for LMSTUDIO_MODEL'),
+    providerStringEnv('XAI_BASE_URL', 'Alias for GROK_BASE_URL'),
+    providerStringEnv('XAI_MODEL', 'Alias for GROK_MODEL'),
+    providerStringEnv('GEMINI_BASE_URL', 'Custom Gemini API endpoint'),
+    providerStringEnv('GOOGLE_AI_BASE_URL', 'Alias for GEMINI_BASE_URL'),
+    providerStringEnv('GOOGLE_MODEL', 'Alias for GEMINI_MODEL'),
+    providerStringEnv('ANTHROPIC_BASE_URL', 'Custom Anthropic API endpoint'),
+    providerStringEnv('CLAUDE_MODEL', 'Alias for ANTHROPIC_MODEL'),
+    providerStringEnv('MISTRAL_BASE_URL', 'Custom Mistral OpenAI-compatible endpoint'),
+    providerStringEnv('GROQ_BASE_URL', 'Custom Groq OpenAI-compatible endpoint'),
+    providerStringEnv('TOGETHER_BASE_URL', 'Custom Together AI OpenAI-compatible endpoint'),
+    providerStringEnv('FIREWORKS_BASE_URL', 'Custom Fireworks AI OpenAI-compatible endpoint'),
+    providerStringEnv('OPENROUTER_BASE_URL', 'Custom OpenRouter endpoint'),
+    providerStringEnv('ZAI_BASE_URL', 'Alias for GLM_BASE_URL'),
+    providerStringEnv('ZAI_MODEL', 'Alias for GLM_MODEL'),
+    providerStringEnv('MOONSHOT_API_KEY', 'Alias API key for Kimi / Moonshot', { sensitive: true }),
+    providerStringEnv('MOONSHOT_BASE_URL', 'Alias for KIMI_BASE_URL'),
+    providerStringEnv('MOONSHOT_MODEL', 'Alias for KIMI_MODEL'),
+    providerStringEnv('KIMI_CN_MODEL', 'Default Kimi China model'),
+    providerStringEnv('ARCEE_API_KEY', 'Alias API key for Arcee AI', { sensitive: true }),
+    providerStringEnv('ARCEE_BASE_URL', 'Alias for ARCEEAI_BASE_URL'),
+    providerStringEnv('ARCEEAI_MODEL', 'Default Arcee AI model'),
+    providerStringEnv('ARCEE_MODEL', 'Alias for ARCEEAI_MODEL'),
+    providerStringEnv('GMI_MODEL', 'Default GMI Cloud model'),
+    providerStringEnv('MINIMAX_MODEL', 'Default MiniMax model'),
+    providerStringEnv('MINIMAX_CN_MODEL', 'Default MiniMax China model'),
+    providerStringEnv('ALIBABA_API_KEY', 'Alias API key for Alibaba / DashScope', { sensitive: true }),
+    providerStringEnv('ALIBABA_BASE_URL', 'Alias for DASHSCOPE_BASE_URL'),
+    providerStringEnv('DASHSCOPE_MODEL', 'Default DashScope model'),
+    providerStringEnv('ALIBABA_MODEL', 'Alias for DASHSCOPE_MODEL'),
+    providerStringEnv('ALIBABA_CODING_PLAN_BASE_URL', 'Custom Alibaba Coding Plan endpoint'),
+    providerStringEnv('DASHSCOPE_CODING_BASE_URL', 'Alias for ALIBABA_CODING_PLAN_BASE_URL'),
+    providerStringEnv('ALIBABA_CODING_PLAN_MODEL', 'Default Alibaba Coding Plan model'),
+    providerStringEnv('DASHSCOPE_CODING_MODEL', 'Alias for ALIBABA_CODING_PLAN_MODEL'),
+    providerStringEnv('KILO_API_KEY', 'Alias API key for Kilo Code Gateway', { sensitive: true }),
+    providerStringEnv('KILO_BASE_URL', 'Alias for KILOCODE_BASE_URL'),
+    providerStringEnv('KILOCODE_MODEL', 'Default Kilo Code Gateway model'),
+    providerStringEnv('KILO_MODEL', 'Alias for KILOCODE_MODEL'),
+    providerStringEnv('XIAOMI_MODEL', 'Default Xiaomi MiMo model'),
+    providerStringEnv('TENCENT_TOKENHUB_API_KEY', 'Alias API key for Tencent TokenHub', { sensitive: true }),
+    providerStringEnv('TENCENT_TOKENHUB_BASE_URL', 'Alias for TOKENHUB_BASE_URL'),
+    providerStringEnv('TOKENHUB_MODEL', 'Default Tencent TokenHub model'),
+    providerStringEnv('TENCENT_TOKENHUB_MODEL', 'Alias for TOKENHUB_MODEL'),
+    providerStringEnv('OPENCODE_API_KEY', 'Alias API key for OpenCode Zen', { sensitive: true }),
+    providerStringEnv('OPENCODE_ZEN_BASE_URL', 'Custom OpenCode Zen endpoint'),
+    providerStringEnv('OPENCODE_BASE_URL', 'Alias for OPENCODE_ZEN_BASE_URL'),
+    providerStringEnv('OPENCODE_ZEN_MODEL', 'Default OpenCode Zen model'),
+    providerStringEnv('OPENCODE_MODEL', 'Alias for OPENCODE_ZEN_MODEL'),
+    providerStringEnv('OPENCODE_GO_BASE_URL', 'Custom OpenCode Go endpoint'),
+    providerStringEnv('OPENCODE_GO_MODEL', 'Default OpenCode Go model'),
+    providerStringEnv('DEEPSEEK_MODEL', 'Default DeepSeek model'),
+    providerStringEnv('HUGGINGFACE_API_KEY', 'Alias API key for Hugging Face', { sensitive: true }),
+    providerStringEnv('HUGGINGFACE_BASE_URL', 'Alias for HF_BASE_URL'),
+    providerStringEnv('HF_MODEL', 'Default Hugging Face router model'),
+    providerStringEnv('HUGGINGFACE_MODEL', 'Alias for HF_MODEL'),
+    providerStringEnv('NVIDIA_NIM_BASE_URL', 'Alias for NVIDIA_BASE_URL'),
+    providerStringEnv('NVIDIA_MODEL', 'Default NVIDIA NIM model'),
+    providerStringEnv('NVIDIA_NIM_MODEL', 'Alias for NVIDIA_MODEL'),
+    providerStringEnv('OLLAMA_CLOUD_MODEL', 'Default Ollama Cloud model'),
+    providerStringEnv('STEP_API_KEY', 'Alias API key for StepFun', { sensitive: true }),
+    providerStringEnv('STEP_BASE_URL', 'Alias for STEPFUN_BASE_URL'),
+    providerStringEnv('STEPFUN_MODEL', 'Default StepFun model'),
+    providerStringEnv('STEP_MODEL', 'Alias for STEPFUN_MODEL'),
+    providerStringEnv('AZURE_OPENAI_ENDPOINT', 'Azure OpenAI resource endpoint'),
+    providerStringEnv('AZURE_OPENAI_API_KEY', 'Azure OpenAI API key', { sensitive: true }),
+    providerStringEnv('AZURE_OPENAI_AD_TOKEN', 'Azure OpenAI Azure AD bearer token', { sensitive: true }),
+    providerStringEnv('AZURE_OPENAI_API_VERSION', 'Azure OpenAI API version', { default: '2024-02-01' }),
+    providerStringEnv('AZURE_OPENAI_DEPLOYMENT', 'Azure OpenAI deployment name'),
+    providerStringEnv('AZURE_OPENAI_MODEL', 'Azure OpenAI model/deployment alias'),
+    providerStringEnv('AWS_BEDROCK_REGION', 'AWS Bedrock region'),
+    providerStringEnv('AWS_REGION', 'AWS region alias for Bedrock'),
+    providerStringEnv('AWS_ACCESS_KEY_ID', 'AWS access key id for Bedrock', { sensitive: true }),
+    providerStringEnv('AWS_SECRET_ACCESS_KEY', 'AWS secret access key for Bedrock', { sensitive: true }),
+    providerStringEnv('AWS_SESSION_TOKEN', 'AWS session token for Bedrock', { sensitive: true }),
+    providerStringEnv('AWS_BEDROCK_MODEL', 'AWS Bedrock model id'),
+    providerStringEnv('BEDROCK_MODEL', 'Alias for AWS_BEDROCK_MODEL'),
+    providerStringEnv('GITHUB_COPILOT_TOKEN', 'GitHub Copilot token', { sensitive: true }),
+    providerStringEnv('COPILOT_GITHUB_TOKEN', 'Alias GitHub Copilot token', { sensitive: true }),
+    providerStringEnv('GH_TOKEN', 'GitHub token fallback for Copilot', { sensitive: true }),
+    providerStringEnv('COPILOT_MODEL', 'GitHub Copilot model override'),
     {
         name: 'ELEVENLABS_API_KEY',
         type: 'string',