mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-07-20 15:33:54 +00:00
121 lines
4.3 KiB
Python
121 lines
4.3 KiB
Python
"""Kimi / Moonshot provider profiles.
|
|
|
|
Kimi has dual endpoints:
|
|
- sk-kimi-* keys → api.kimi.com/coding (Anthropic Messages API)
|
|
- legacy keys → api.moonshot.ai/v1 (OpenAI chat completions)
|
|
|
|
This module covers the chat_completions path (/v1 endpoint).
|
|
"""
|
|
|
|
from typing import Any
|
|
from urllib.parse import urlparse
|
|
|
|
from providers import register_provider
|
|
from providers.base import OMIT_TEMPERATURE, ProviderProfile
|
|
|
|
|
|
def _is_confirmed_kimi_coding_url(base_url: str) -> bool:
|
|
"""Return True only for Kimi Code's canonical HTTPS API surfaces."""
|
|
try:
|
|
parsed = urlparse(base_url)
|
|
port = parsed.port
|
|
except ValueError:
|
|
return False
|
|
return (
|
|
parsed.scheme.lower() == "https"
|
|
and (parsed.hostname or "").lower() == "api.kimi.com"
|
|
and port in (None, 443)
|
|
and parsed.username is None
|
|
and parsed.password is None
|
|
and parsed.path.rstrip("/") in {"/coding", "/coding/v1"}
|
|
and not parsed.query
|
|
and not parsed.fragment
|
|
)
|
|
|
|
|
|
class KimiProfile(ProviderProfile):
|
|
"""Kimi/Moonshot — temperature omitted, thinking xor reasoning_effort."""
|
|
|
|
def fetch_models(
|
|
self,
|
|
*,
|
|
api_key: str | None = None,
|
|
base_url: str | None = None,
|
|
timeout: float = 8.0,
|
|
) -> list[str] | None:
|
|
"""Use Kimi Code's OpenAI-compatible surface for model discovery."""
|
|
effective_base = (base_url or self.base_url or "").rstrip("/")
|
|
confirmed_coding_endpoint = _is_confirmed_kimi_coding_url(effective_base)
|
|
if confirmed_coding_endpoint and urlparse(effective_base).path.rstrip("/") == "/coding":
|
|
effective_base += "/v1"
|
|
models = super().fetch_models(
|
|
api_key=api_key,
|
|
base_url=effective_base or None,
|
|
timeout=timeout,
|
|
)
|
|
if models is None or confirmed_coding_endpoint:
|
|
return models
|
|
return [model for model in models if model.strip().lower() != "k3"]
|
|
|
|
def build_api_kwargs_extras(
|
|
self, *, reasoning_config: dict | None = None, **context
|
|
) -> tuple[dict[str, Any], dict[str, Any]]:
|
|
"""Kimi reasoning controls.
|
|
|
|
Moonshot's wire shape treats ``extra_body.thinking`` (a binary toggle)
|
|
and a top-level ``reasoning_effort`` as mutually exclusive — sending
|
|
both is at best redundant and risks "cannot specify both 'thinking' and
|
|
'reasoning_effort'" (HTTP 400). This mirrors the kimi-k2 handling on the
|
|
opencode-go relay: send effort when one is requested, otherwise fall
|
|
back to ``extra_body.thinking`` — never both.
|
|
"""
|
|
extra_body = {}
|
|
top_level = {}
|
|
|
|
if not reasoning_config or not isinstance(reasoning_config, dict):
|
|
# No config → thinking enabled, let the server pick the depth.
|
|
# (Previously also sent reasoning_effort="medium", which paired
|
|
# thinking + effort on every default call.)
|
|
extra_body["thinking"] = {"type": "enabled"}
|
|
return extra_body, top_level
|
|
|
|
enabled = reasoning_config.get("enabled", True)
|
|
if enabled is False:
|
|
extra_body["thinking"] = {"type": "disabled"}
|
|
return extra_body, top_level
|
|
|
|
# Enabled: prefer an explicit effort; only fall back to extra_body
|
|
# thinking when no recognized effort is requested.
|
|
effort = (reasoning_config.get("effort") or "").strip().lower()
|
|
if effort in {"low", "medium", "high"}:
|
|
top_level["reasoning_effort"] = effort
|
|
else:
|
|
extra_body["thinking"] = {"type": "enabled"}
|
|
|
|
return extra_body, top_level
|
|
|
|
|
|
kimi = KimiProfile(
|
|
name="kimi-coding",
|
|
aliases=("kimi", "moonshot", "kimi-for-coding"),
|
|
env_vars=("KIMI_API_KEY", "KIMI_CODING_API_KEY"),
|
|
base_url="https://api.moonshot.ai/v1",
|
|
fixed_temperature=OMIT_TEMPERATURE,
|
|
default_max_tokens=32000,
|
|
default_headers={"User-Agent": "hermes-agent/1.0"},
|
|
default_aux_model="kimi-k2-turbo-preview",
|
|
)
|
|
|
|
kimi_cn = KimiProfile(
|
|
name="kimi-coding-cn",
|
|
aliases=("kimi-cn", "moonshot-cn"),
|
|
env_vars=("KIMI_CN_API_KEY",),
|
|
base_url="https://api.moonshot.cn/v1",
|
|
fixed_temperature=OMIT_TEMPERATURE,
|
|
default_max_tokens=32000,
|
|
default_headers={"User-Agent": "hermes-agent/1.0"},
|
|
default_aux_model="kimi-k2-turbo-preview",
|
|
)
|
|
|
|
register_provider(kimi)
|
|
register_provider(kimi_cn)
|