feat: provider modules — ProviderProfile ABC, 33 providers, fetch_models, transport single-path
Introduces providers/ package — single source of truth for every
inference provider. Adding a simple api-key provider now requires one
providers/<name>.py file with zero edits anywhere else.
What this PR ships:
- providers/ package (ProviderProfile ABC + 33 profiles across 4 api_modes)
- ProviderProfile declarative fields: name, api_mode, aliases, display_name,
env_vars, base_url, models_url, auth_type, fallback_models, hostname,
default_headers, fixed_temperature, default_max_tokens, default_aux_model
- 4 overridable hooks: prepare_messages, build_extra_body,
build_api_kwargs_extras, fetch_models
- chat_completions.build_kwargs: profile path via _build_kwargs_from_profile,
legacy flag path retained for lmstudio/tencent-tokenhub (which have
session-aware reasoning probing that doesn't map cleanly to hooks yet)
- run_agent.py: profile path for all registered providers; legacy path
variable scoping fixed (all flags defined before branching)
- Auto-wires: auth.PROVIDER_REGISTRY, models.CANONICAL_PROVIDERS,
doctor health checks, config.OPTIONAL_ENV_VARS, model_metadata._URL_TO_PROVIDER
- GeminiProfile: thinking_config translation (native + openai-compat nested)
- New tests/providers/ (79 tests covering profile declarations, transport
parity, hook overrides, e2e kwargs assembly)
Deltas vs original PR (salvaged onto current main):
- Added profiles: alibaba-coding-plan, azure-foundry, minimax-oauth
(were added to main since original PR)
- Skipped profiles: lmstudio, tencent-tokenhub stay on legacy path (their
reasoning_effort probing has no clean hook equivalent yet)
- Removed lmstudio alias from custom profile (it's a separate provider now)
- Skipped openrouter/custom from PROVIDER_REGISTRY auto-extension
(resolve_provider special-cases them; adding breaks runtime resolution)
- runtime_provider: profile.api_mode only as fallback when URL detection
finds nothing (was breaking minimax /v1 override)
- Preserved main's legacy-path improvements: deepseek reasoning_content
preserve, gemini Gemma skip, OpenRouter response caching, Anthropic 1M
beta recovery, etc.
- Kept agent/copilot_acp_client.py in place (rejected PR's relocation —
main has 7 fixes landed since; relocation would revert them)
- _API_KEY_PROVIDER_AUX_MODELS alias kept for backward compat with existing
test imports
Co-authored-by: kshitijk4poor <82637225+kshitijk4poor@users.noreply.github.com>
Closes #14418
2026-05-05 10:18:49 -07:00
|
|
|
"""OpenCode provider profiles (Zen + Go).
|
|
|
|
|
|
|
|
|
|
Both use per-model api_mode routing:
|
|
|
|
|
- OpenCode Zen: Claude → anthropic_messages, GPT-5/Codex → codex_responses,
|
|
|
|
|
everything else → chat_completions (this profile)
|
|
|
|
|
- OpenCode Go: MiniMax → anthropic_messages, GLM/Kimi → chat_completions
|
|
|
|
|
(this profile)
|
|
|
|
|
"""
|
|
|
|
|
|
2026-05-22 23:19:53 -04:00
|
|
|
from __future__ import annotations
|
|
|
|
|
|
|
|
|
|
from typing import Any
|
|
|
|
|
|
feat: provider modules — ProviderProfile ABC, 33 providers, fetch_models, transport single-path
Introduces providers/ package — single source of truth for every
inference provider. Adding a simple api-key provider now requires one
providers/<name>.py file with zero edits anywhere else.
What this PR ships:
- providers/ package (ProviderProfile ABC + 33 profiles across 4 api_modes)
- ProviderProfile declarative fields: name, api_mode, aliases, display_name,
env_vars, base_url, models_url, auth_type, fallback_models, hostname,
default_headers, fixed_temperature, default_max_tokens, default_aux_model
- 4 overridable hooks: prepare_messages, build_extra_body,
build_api_kwargs_extras, fetch_models
- chat_completions.build_kwargs: profile path via _build_kwargs_from_profile,
legacy flag path retained for lmstudio/tencent-tokenhub (which have
session-aware reasoning probing that doesn't map cleanly to hooks yet)
- run_agent.py: profile path for all registered providers; legacy path
variable scoping fixed (all flags defined before branching)
- Auto-wires: auth.PROVIDER_REGISTRY, models.CANONICAL_PROVIDERS,
doctor health checks, config.OPTIONAL_ENV_VARS, model_metadata._URL_TO_PROVIDER
- GeminiProfile: thinking_config translation (native + openai-compat nested)
- New tests/providers/ (79 tests covering profile declarations, transport
parity, hook overrides, e2e kwargs assembly)
Deltas vs original PR (salvaged onto current main):
- Added profiles: alibaba-coding-plan, azure-foundry, minimax-oauth
(were added to main since original PR)
- Skipped profiles: lmstudio, tencent-tokenhub stay on legacy path (their
reasoning_effort probing has no clean hook equivalent yet)
- Removed lmstudio alias from custom profile (it's a separate provider now)
- Skipped openrouter/custom from PROVIDER_REGISTRY auto-extension
(resolve_provider special-cases them; adding breaks runtime resolution)
- runtime_provider: profile.api_mode only as fallback when URL detection
finds nothing (was breaking minimax /v1 override)
- Preserved main's legacy-path improvements: deepseek reasoning_content
preserve, gemini Gemma skip, OpenRouter response caching, Anthropic 1M
beta recovery, etc.
- Kept agent/copilot_acp_client.py in place (rejected PR's relocation —
main has 7 fixes landed since; relocation would revert them)
- _API_KEY_PROVIDER_AUX_MODELS alias kept for backward compat with existing
test imports
Co-authored-by: kshitijk4poor <82637225+kshitijk4poor@users.noreply.github.com>
Closes #14418
2026-05-05 10:18:49 -07:00
|
|
|
from providers import register_provider
|
|
|
|
|
from providers.base import ProviderProfile
|
|
|
|
|
|
2026-05-22 23:19:53 -04:00
|
|
|
|
|
|
|
|
def _flat_model_name(model: str | None) -> str:
|
|
|
|
|
"""Return the bare OpenCode model ID, tolerating aggregator prefixes."""
|
|
|
|
|
return (model or "").strip().rsplit("/", 1)[-1].lower()
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _is_kimi_k2_model(model: str | None) -> bool:
|
|
|
|
|
return _flat_model_name(model).startswith("kimi-k2")
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _is_deepseek_thinking_model(model: str | None) -> bool:
|
|
|
|
|
m = _flat_model_name(model)
|
|
|
|
|
if m.startswith("deepseek-v") and not m.startswith("deepseek-v3"):
|
|
|
|
|
return True
|
|
|
|
|
return m == "deepseek-reasoner"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class OpenCodeGoProfile(ProviderProfile):
|
|
|
|
|
"""OpenCode Go - model-specific reasoning controls."""
|
|
|
|
|
|
|
|
|
|
def build_api_kwargs_extras(
|
|
|
|
|
self, *, reasoning_config: dict | None = None, model: str | None = None, **context
|
|
|
|
|
) -> tuple[dict[str, Any], dict[str, Any]]:
|
|
|
|
|
extra_body: dict[str, Any] = {}
|
|
|
|
|
top_level: dict[str, Any] = {}
|
|
|
|
|
|
|
|
|
|
if _is_kimi_k2_model(model):
|
2026-05-23 01:49:26 -07:00
|
|
|
# Kimi K2 on OpenCode Go uses Moonshot's native wire shape:
|
|
|
|
|
# extra_body.thinking (binary toggle) + top-level reasoning_effort
|
|
|
|
|
# (low|medium|high). Mirrors the KimiProfile (api.moonshot.ai/v1).
|
|
|
|
|
if not isinstance(reasoning_config, dict):
|
|
|
|
|
# No config → leave server defaults alone.
|
|
|
|
|
return extra_body, top_level
|
|
|
|
|
|
|
|
|
|
enabled = reasoning_config.get("enabled") is not False
|
|
|
|
|
extra_body["thinking"] = {"type": "enabled" if enabled else "disabled"}
|
|
|
|
|
|
|
|
|
|
if not enabled:
|
|
|
|
|
return extra_body, top_level
|
|
|
|
|
|
|
|
|
|
effort = (reasoning_config.get("effort") or "").strip().lower()
|
|
|
|
|
if effort in {"xhigh", "max"}:
|
|
|
|
|
top_level["reasoning_effort"] = "high"
|
|
|
|
|
elif effort in {"low", "medium", "high"}:
|
|
|
|
|
top_level["reasoning_effort"] = effort
|
2026-05-22 23:19:53 -04:00
|
|
|
return extra_body, top_level
|
|
|
|
|
|
|
|
|
|
if not _is_deepseek_thinking_model(model):
|
|
|
|
|
return extra_body, top_level
|
|
|
|
|
|
|
|
|
|
enabled = True
|
|
|
|
|
if isinstance(reasoning_config, dict) and reasoning_config.get("enabled") is False:
|
|
|
|
|
enabled = False
|
|
|
|
|
extra_body["thinking"] = {"type": "enabled" if enabled else "disabled"}
|
|
|
|
|
|
|
|
|
|
if not enabled:
|
|
|
|
|
return extra_body, top_level
|
|
|
|
|
|
|
|
|
|
if isinstance(reasoning_config, dict):
|
|
|
|
|
effort = (reasoning_config.get("effort") or "").strip().lower()
|
|
|
|
|
if effort in {"xhigh", "max"}:
|
|
|
|
|
top_level["reasoning_effort"] = "max"
|
|
|
|
|
elif effort in {"low", "medium", "high"}:
|
|
|
|
|
top_level["reasoning_effort"] = effort
|
|
|
|
|
|
|
|
|
|
return extra_body, top_level
|
|
|
|
|
|
|
|
|
|
|
feat: provider modules — ProviderProfile ABC, 33 providers, fetch_models, transport single-path
Introduces providers/ package — single source of truth for every
inference provider. Adding a simple api-key provider now requires one
providers/<name>.py file with zero edits anywhere else.
What this PR ships:
- providers/ package (ProviderProfile ABC + 33 profiles across 4 api_modes)
- ProviderProfile declarative fields: name, api_mode, aliases, display_name,
env_vars, base_url, models_url, auth_type, fallback_models, hostname,
default_headers, fixed_temperature, default_max_tokens, default_aux_model
- 4 overridable hooks: prepare_messages, build_extra_body,
build_api_kwargs_extras, fetch_models
- chat_completions.build_kwargs: profile path via _build_kwargs_from_profile,
legacy flag path retained for lmstudio/tencent-tokenhub (which have
session-aware reasoning probing that doesn't map cleanly to hooks yet)
- run_agent.py: profile path for all registered providers; legacy path
variable scoping fixed (all flags defined before branching)
- Auto-wires: auth.PROVIDER_REGISTRY, models.CANONICAL_PROVIDERS,
doctor health checks, config.OPTIONAL_ENV_VARS, model_metadata._URL_TO_PROVIDER
- GeminiProfile: thinking_config translation (native + openai-compat nested)
- New tests/providers/ (79 tests covering profile declarations, transport
parity, hook overrides, e2e kwargs assembly)
Deltas vs original PR (salvaged onto current main):
- Added profiles: alibaba-coding-plan, azure-foundry, minimax-oauth
(were added to main since original PR)
- Skipped profiles: lmstudio, tencent-tokenhub stay on legacy path (their
reasoning_effort probing has no clean hook equivalent yet)
- Removed lmstudio alias from custom profile (it's a separate provider now)
- Skipped openrouter/custom from PROVIDER_REGISTRY auto-extension
(resolve_provider special-cases them; adding breaks runtime resolution)
- runtime_provider: profile.api_mode only as fallback when URL detection
finds nothing (was breaking minimax /v1 override)
- Preserved main's legacy-path improvements: deepseek reasoning_content
preserve, gemini Gemma skip, OpenRouter response caching, Anthropic 1M
beta recovery, etc.
- Kept agent/copilot_acp_client.py in place (rejected PR's relocation —
main has 7 fixes landed since; relocation would revert them)
- _API_KEY_PROVIDER_AUX_MODELS alias kept for backward compat with existing
test imports
Co-authored-by: kshitijk4poor <82637225+kshitijk4poor@users.noreply.github.com>
Closes #14418
2026-05-05 10:18:49 -07:00
|
|
|
opencode_zen = ProviderProfile(
|
|
|
|
|
name="opencode-zen",
|
|
|
|
|
aliases=("opencode", "opencode_zen", "zen"),
|
|
|
|
|
env_vars=("OPENCODE_ZEN_API_KEY",),
|
|
|
|
|
base_url="https://opencode.ai/zen/v1",
|
|
|
|
|
default_aux_model="gemini-3-flash",
|
|
|
|
|
)
|
|
|
|
|
|
2026-05-22 23:19:53 -04:00
|
|
|
opencode_go = OpenCodeGoProfile(
|
feat: provider modules — ProviderProfile ABC, 33 providers, fetch_models, transport single-path
Introduces providers/ package — single source of truth for every
inference provider. Adding a simple api-key provider now requires one
providers/<name>.py file with zero edits anywhere else.
What this PR ships:
- providers/ package (ProviderProfile ABC + 33 profiles across 4 api_modes)
- ProviderProfile declarative fields: name, api_mode, aliases, display_name,
env_vars, base_url, models_url, auth_type, fallback_models, hostname,
default_headers, fixed_temperature, default_max_tokens, default_aux_model
- 4 overridable hooks: prepare_messages, build_extra_body,
build_api_kwargs_extras, fetch_models
- chat_completions.build_kwargs: profile path via _build_kwargs_from_profile,
legacy flag path retained for lmstudio/tencent-tokenhub (which have
session-aware reasoning probing that doesn't map cleanly to hooks yet)
- run_agent.py: profile path for all registered providers; legacy path
variable scoping fixed (all flags defined before branching)
- Auto-wires: auth.PROVIDER_REGISTRY, models.CANONICAL_PROVIDERS,
doctor health checks, config.OPTIONAL_ENV_VARS, model_metadata._URL_TO_PROVIDER
- GeminiProfile: thinking_config translation (native + openai-compat nested)
- New tests/providers/ (79 tests covering profile declarations, transport
parity, hook overrides, e2e kwargs assembly)
Deltas vs original PR (salvaged onto current main):
- Added profiles: alibaba-coding-plan, azure-foundry, minimax-oauth
(were added to main since original PR)
- Skipped profiles: lmstudio, tencent-tokenhub stay on legacy path (their
reasoning_effort probing has no clean hook equivalent yet)
- Removed lmstudio alias from custom profile (it's a separate provider now)
- Skipped openrouter/custom from PROVIDER_REGISTRY auto-extension
(resolve_provider special-cases them; adding breaks runtime resolution)
- runtime_provider: profile.api_mode only as fallback when URL detection
finds nothing (was breaking minimax /v1 override)
- Preserved main's legacy-path improvements: deepseek reasoning_content
preserve, gemini Gemma skip, OpenRouter response caching, Anthropic 1M
beta recovery, etc.
- Kept agent/copilot_acp_client.py in place (rejected PR's relocation —
main has 7 fixes landed since; relocation would revert them)
- _API_KEY_PROVIDER_AUX_MODELS alias kept for backward compat with existing
test imports
Co-authored-by: kshitijk4poor <82637225+kshitijk4poor@users.noreply.github.com>
Closes #14418
2026-05-05 10:18:49 -07:00
|
|
|
name="opencode-go",
|
|
|
|
|
aliases=("opencode_go", "go", "opencode-go-sub"),
|
|
|
|
|
env_vars=("OPENCODE_GO_API_KEY",),
|
|
|
|
|
base_url="https://opencode.ai/zen/go/v1",
|
|
|
|
|
default_aux_model="glm-5",
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
register_provider(opencode_zen)
|
|
|
|
|
register_provider(opencode_go)
|