Skip to content
This repository was archived by the owner on Sep 23, 2026. It is now read-only.
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ Only write entries that are worth mentioning to users.

## Unreleased

- LLM: Send a stable `x-opencode-session` header to OpenCode Go (`*.opencode.ai`) so Chat Completions requests are not rejected with HTTP 400. The value is the Kimi session id. An explicit custom header is left as-is.

## 1.52.0 (2026-09-22)

**Highlights**: Kimi CLI is archived and no longer maintained, and this is the final release. Please migrate to [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code); see the [migration guide](https://moonshotai.github.io/kimi-code/en/guides/migration)
Expand Down
2 changes: 2 additions & 0 deletions docs/en/configuration/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,8 @@ base_url = "https://api.openai.com/v1"
api_key = "sk-xxx"
```

Hosts on `opencode.ai` (OpenCode Go) also receive a stable `x-opencode-session` header set to the current session id. Set `custom_headers` with `x-opencode-session` if you need a different value.

### `openai_responses`

For OpenAI Responses API (newer API format).
Expand Down
2 changes: 2 additions & 0 deletions docs/en/release-notes/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ This page documents the changes in each Kimi Code CLI release.

## Unreleased

- LLM: Send a stable `x-opencode-session` header to OpenCode Go (`*.opencode.ai`) so Chat Completions requests are not rejected with HTTP 400. The value is the Kimi session id. An explicit custom header is left as-is.

## 1.51.0 (2026-09-21)

**Highlights**: Kimi CLI is archived and no longer maintained, and this is the final release. Please migrate to [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code); see the [migration guide](https://moonshotai.github.io/kimi-code/en/guides/migration)
Expand Down
2 changes: 2 additions & 0 deletions docs/zh/configuration/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,8 @@ base_url = "https://api.openai.com/v1"
api_key = "sk-xxx"
```

`opencode.ai`(OpenCode Go)主机会自动附带稳定的 `x-opencode-session`,值为当前会话 id。若要改用其它值,在 `custom_headers` 里自行设置该头即可。

### `openai_responses`

用于 OpenAI Responses API(较新的 API 格式)。
Expand Down
2 changes: 2 additions & 0 deletions docs/zh/release-notes/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@

## 未发布

- LLM:向 OpenCode Go(`*.opencode.ai`)发送稳定的 `x-opencode-session` 请求头,避免 Chat Completions 请求因缺少该头被 HTTP 400 拒绝。值为当前 Kimi 会话 id;若已在 `custom_headers` 里显式设置则保持不变。

## 1.51.0 (2026-09-21)

**亮点**:Kimi CLI 已归档,不再维护,这是最后一个版本。请迁移至 [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code),详见 [迁移指南](https://moonshotai.github.io/kimi-code/zh/guides/migration)
Expand Down
35 changes: 33 additions & 2 deletions src/kimi_cli/llm.py
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@
from dataclasses import dataclass, field
from pathlib import Path
from typing import TYPE_CHECKING, Any, Literal, Protocol, Self, cast, get_args
from urllib.parse import urlparse

from kosong.chat_provider import ChatProvider, StreamedMessage, ThinkingEffort
from kosong.message import (
Expand Down Expand Up @@ -323,6 +324,34 @@ def _kimi_default_headers(provider: LLMProvider, oauth: OAuthManager | None) ->
return headers


_OPENCODE_SESSION_HEADER = "x-opencode-session"


def _is_opencode_host(base_url: str) -> bool:
"""True when *base_url* points at OpenCode's official API host."""
host = (urlparse(base_url).hostname or "").lower().rstrip(".")
return host == "opencode.ai" or host.endswith(".opencode.ai")


def _openai_compatible_headers(
provider: LLMProvider,
*,
session_id: str | None,
) -> dict[str, str] | None:
"""Headers for an OpenAI-compatible provider.

OpenCode Go returns HTTP 400 unless every request in a conversation carries
the same ``x-opencode-session`` value (MoonshotAI/kimi-cli#2653). The Kimi
session id is stable for one conversation and changes when a new session
starts. An explicit custom header is left untouched.
"""
headers = dict(provider.custom_headers) if provider.custom_headers else {}
already_set = any(name.lower() == _OPENCODE_SESSION_HEADER for name in headers)
if session_id and _is_opencode_host(provider.base_url) and not already_set:
headers[_OPENCODE_SESSION_HEADER] = session_id
return headers or None


def create_llm(
provider: LLMProvider,
model: LLMModel,
Expand Down Expand Up @@ -392,21 +421,23 @@ def create_llm(
if provider.reasoning_key is not None
else "reasoning_content"
)
openai_headers = _openai_compatible_headers(provider, session_id=session_id)
chat_provider = OpenAILegacy(
model=model.model,
base_url=provider.base_url,
api_key=resolved_api_key,
reasoning_key=reasoning_key,
default_headers=dict(provider.custom_headers) if provider.custom_headers else None,
**({"default_headers": openai_headers} if openai_headers else {}),
)
case "openai_responses":
from kosong.contrib.chat_provider.openai_responses import OpenAIResponses

openai_headers = _openai_compatible_headers(provider, session_id=session_id)
chat_provider = OpenAIResponses(
model=model.model,
base_url=provider.base_url,
api_key=resolved_api_key,
default_headers=dict(provider.custom_headers) if provider.custom_headers else None,
**({"default_headers": openai_headers} if openai_headers else {}),
)
case "anthropic":
from kosong.contrib.chat_provider.anthropic import Anthropic
Expand Down
7 changes: 6 additions & 1 deletion src/kimi_cli/web/api/sessions.py
Original file line number Diff line number Diff line change
Expand Up @@ -826,7 +826,12 @@ async def generate_session_title(
if provider_config:
oauth = OAuthManager(config)
await oauth.ensure_fresh()
llm = create_llm(provider_config, model_config, oauth=oauth)
llm = create_llm(
provider_config,
model_config,
session_id=str(session_id),
oauth=oauth,
)

if llm:
system_prompt = (
Expand Down
87 changes: 87 additions & 0 deletions tests/core/test_create_llm.py
Original file line number Diff line number Diff line change
Expand Up @@ -168,6 +168,93 @@ def test_create_llm_kimi_non_positive_completion_cap_disables_clamping(monkeypat
assert llm.chat_provider.model_parameters["max_completion_tokens"] is None


def test_create_llm_opencode_go_sets_stable_session_header():
from kosong.contrib.chat_provider.openai_legacy import OpenAILegacy

provider = LLMProvider(
type="openai_legacy",
base_url="https://opencode.ai/zen/go/v1",
api_key=SecretStr("test-key"),
)
model = LLMModel(provider="opencode", model="gpt", max_context_size=8000)

llm = create_llm(provider, model, session_id="sess-2653")

assert llm is not None
assert isinstance(llm.chat_provider, OpenAILegacy)
headers = llm.chat_provider._client_kwargs["default_headers"]
assert headers["x-opencode-session"] == "sess-2653"


def test_create_llm_opencode_subdomain_and_responses_wire():
provider = LLMProvider(
type="openai_responses",
base_url="https://go.opencode.ai/v1",
api_key=SecretStr("test-key"),
)
model = LLMModel(provider="opencode", model="gpt", max_context_size=8000)

llm = create_llm(provider, model, session_id="sess-go")

assert llm is not None
assert isinstance(llm.chat_provider, OpenAIResponses)
headers = llm.chat_provider._client_kwargs["default_headers"]
assert headers["x-opencode-session"] == "sess-go"


def test_create_llm_opencode_keeps_explicit_session_header():
from kosong.contrib.chat_provider.openai_legacy import OpenAILegacy

provider = LLMProvider(
type="openai_legacy",
base_url="https://opencode.ai/zen/go/v1",
api_key=SecretStr("test-key"),
custom_headers={"X-OpenCode-Session": "user-set", "X-Trace": "1"},
)
model = LLMModel(provider="opencode", model="gpt", max_context_size=8000)

llm = create_llm(provider, model, session_id="sess-2653")

assert llm is not None
assert isinstance(llm.chat_provider, OpenAILegacy)
headers = llm.chat_provider._client_kwargs["default_headers"]
assert headers == {"X-OpenCode-Session": "user-set", "X-Trace": "1"}


def test_create_llm_non_opencode_host_omits_session_header():
from kosong.contrib.chat_provider.openai_legacy import OpenAILegacy

provider = LLMProvider(
type="openai_legacy",
base_url="https://api.example.com/v1",
api_key=SecretStr("test-key"),
)
model = LLMModel(provider="example", model="gpt", max_context_size=8000)

llm = create_llm(provider, model, session_id="sess-2653")

assert llm is not None
assert isinstance(llm.chat_provider, OpenAILegacy)
assert "default_headers" not in llm.chat_provider._client_kwargs


def test_create_llm_opencode_without_session_omits_header():
from kosong.contrib.chat_provider.openai_legacy import OpenAILegacy

provider = LLMProvider(
type="openai_legacy",
base_url="https://opencode.ai/zen/go/v1",
api_key=SecretStr("test-key"),
)
model = LLMModel(provider="opencode", model="gpt", max_context_size=8000)

llm = create_llm(provider, model)

assert llm is not None
assert isinstance(llm.chat_provider, OpenAILegacy)
assert "default_headers" not in llm.chat_provider._client_kwargs


def test_create_llm_echo_provider():
provider = LLMProvider(type="_echo", base_url="", api_key=SecretStr(""))
model = LLMModel(provider="_echo", model="echo", max_context_size=1234)
Expand Down