coderouter-cli 2.15.0__tar.gz → 2.15.1__tar.gz

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/CHANGELOG.md

@@ -9,6 +9,54 @@ are kept verbatim where the Japanese text itself is the subject).
 
 ---
 
+## [v2.15.1] — 2026-10-24 (docs and defaults for the October 2026 ecosystem)
+
+### Added
+
+- **`doctor` names llama.cpp's default-port change.** llama.cpp b11521
+  (2026-10-09, ggml-org/llama.cpp#30159) moved `llama-server`'s default
+  listen port from 8080 to 9931. When the `auth+basic-chat` probe cannot
+  connect to a loopback provider on :8080 or :9931, `doctor` now checks the
+  other port's `/health` (1.5 s, IPv4 literal) and, if it answers, says so
+  in the transport-error detail with the two possible fixes. The config is
+  never rewritten. Other hosts and ports send no extra request.
+- **SBOM on every release.** `release.yml` builds a CycloneDX JSON SBOM
+  (`cyclonedx-bom==7.4.0`) from a clean venv holding only the wheel and its
+  runtime dependencies, and attaches `coderouter-cli-<version>.cdx.json` to
+  the GitHub Release draft. It is written outside `dist/`, so the PyPI
+  upload is unchanged.
+
+### Changed
+
+- **Codex CLI instructions corrected.** The quickstart (Pattern B), README
+  and the "do I need CodeRouter?" guide told users to set
+  `wire_api = "chat"`. Codex removed that option in 2026-02 and now fails
+  while loading such a config; it speaks only the Responses API, which
+  CodeRouter does not serve yet. The docs now say so and give the
+  direct-connect workaround (`codex --oss`, or a `wire_api = "responses"`
+  provider pointing at `llama-server`).
+- **llama.cpp port notes.** Backend guides and examples keep their explicit
+  `--port 8080` (correct on every build) and now explain the 9931 default
+  for servers started without `--port`. The Launcher is unaffected: it
+  always passes `--port`, so its 8080 default stays.
+- **README: package-name warning.** The PyPI project named `coderouter` is
+  a different product; the install section now says to install
+  `coderouter-cli`.
+- **README: repair benchmark and release protections.** The tool-call
+  repair row links the benchmark and its numbers, and the Security section
+  lists the release protections as layers rather than resting on
+  Trusted Publishing alone.
+
+### Security
+
+- **Lockfile bumps for newly published advisories.** `anyio` 4.13.0 →
+  4.14.2 (PYSEC-2026-4024, PYSEC-2026-4025), `certifi` 2026.2.25 →
+  2026.10.23 (PYSEC-2026-4320), `fsspec` 2026.4.0 → 2026.9.0
+  (PYSEC-2026-4217; reached only through the optional `[accuracy]` extra
+  via `huggingface-hub`). Found by the CI dependency audit.
+
+---
+
 ## [v2.15.0] — 2026-08-21 (fallback explainability + stream truncation detection)
 
 ### Added

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: coderouter-cli
-Version: 2.15.0
+Version: 2.15.1
 Summary: Local-first, free-first, fallback-built-in LLM router. Claude Code / OpenAI compatible.
 Project-URL: Homepage, https://github.com/zephel01/CodeRouter
 Project-URL: Repository, https://github.com/zephel01/CodeRouter
@@ -66,7 +66,7 @@ Description-Content-Type: text/markdown
 ## 何ができるか — 30 秒で
 
 ```
-あなたのエージェント (Claude Code / codex / agy)
+あなたのエージェント (Claude Code / agy ほか ※)
         │
         ▼
   ┌─ CodeRouter ─┐
@@ -76,6 +76,8 @@ Description-Content-Type: text/markdown
   └──────────────┘
 ```
 
+※ 現行の codex CLI は Responses API（`/v1/responses`）専用になったため、CodeRouter 経由ではまだ使えません（対応予定）。直結の代替手順 → [quickstart Pattern B](./docs/start/quickstart.md#pattern-b-codex-cli-で使う)
+
 **やってくれること:**
 
 - ローカルモデルが壊した tool calling を Claude Code に届く前に修復する
@@ -118,6 +120,8 @@ uvx --from coderouter-cli coderouter serve --port 8088
 
 恒久インストールしたい場合: `uv tool install coderouter-cli`
 
+> **パッケージ名に注意**: PyPI のパッケージ名は **`coderouter-cli`** です。PyPI の `coderouter`（名前だけ同じ）は別の製品なので、`pip install coderouter` と打たないでください。
+
 ---
 
 ## Claude Code で使う
@@ -143,7 +147,7 @@ ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
 | Claude Code + ローカル Ollama で tool calling が壊れる | **必須** — tool 修復 (+ 必要なら wire 変換) |
 | Claude Code + ローカルで長時間回すと止まる | **必須級** — 6 系統ガード + self-healing |
 | Ollama v0.14+ / LM Studio にネイティブ直結で動いてる | **便利** — 直結に無い fallback / ガード / 診断を追加 (passthrough で翻訳ゼロ) |
-| codex / agy + Ollama 直繋ぎで動いてる | オプション — フォールバックが欲しいなら |
+| codex / agy + Ollama 直繋ぎで動いてる | オプション — フォールバックが欲しいなら(codex は `/v1/responses` 対応後) |
 | Claude API を直接叩いてて問題ない | 不要 |
 
 詳細は → [要否判定ガイド](./docs/start/when-do-i-need-coderouter.md)
@@ -156,7 +160,7 @@ ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
 
 | 機能 | 何をしてくれるか |
 |---|---|
-| **Tool-call 修復** | ローカルモデルがテキストで吐いた JSON を正しい tool_use ブロックに復元 |
+| **Tool-call 修復** | ローカルモデルがテキストで吐いた JSON を正しい tool_use ブロックに復元。実測は [修復ベンチ](./benchmarks/tool-repair/README.md)（壊れた tool call を出す 4 モデルで成功率 0% → 80〜100%、回帰コーパスで誤修復 0 件。CI でゲート） |
 | **3 層フォールバック** | ローカル → 無料クラウド → 有料の順に自動切替 |
 | **出力フィルタ** | `<think>` タグ漏れ、stop marker 漏れ、byte-fallback (`<0xNN>`) を自動除去/修復 |
 | **Wire 翻訳** | Anthropic 形式 ↔ OpenAI 形式を自動変換 (ネイティブ `/v1/messages` 対応 backend は passthrough で翻訳ゼロ) |
@@ -333,6 +337,14 @@ CodeRouter は backend ルーター層として独立して動きます。`OPENA
 
 シークレットは環境変数に置きます。[`docs/security.md`](./docs/guides/security.md) に完全な方針と報告手順があります。
 
+リリースは多層で守っています。どれか 1 つを根拠に「安全」とは言いません(正規のパイプラインでビルドされた汚染版が出た例があります)。
+
+- PyPI へは Trusted Publishing(OIDC)で公開し、長期の API トークンを置かない
+- PyPI 側の公開許可は `release.yml` の `pypi` 環境に限定している
+- タグは事前検査スクリプトを通してから打つ(version・CHANGELOG・main の一致を機械的に確認)
+- 実行時の依存は 5 個に絞っている
+- 各リリースに SBOM(CycloneDX)を添付する
+
 ## License
 
 MIT

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/README.en.md

@@ -21,7 +21,7 @@
 ## What it does — in 30 seconds
 
 ```
-Your agent (Claude Code / codex / agy)
+Your agent (Claude Code / agy, etc. *)
         │
         ▼
   ┌─ CodeRouter ──┐
@@ -31,6 +31,8 @@ Your agent (Claude Code / codex / agy)
   └────────────────┘
 ```
 
+\* Current codex CLI speaks only the Responses API (`/v1/responses`), so it cannot go through CodeRouter yet (planned). Direct-connect workaround → [quickstart Pattern B](./docs/start/quickstart.en.md#pattern-b-use-it-with-the-codex-cli)
+
 **What it does for you:**
 
 - Repairs broken tool calling from local models before it reaches Claude Code
@@ -55,6 +57,8 @@ uvx --from coderouter-cli coderouter serve --port 8088
 
 For a permanent install: `uv tool install coderouter-cli`
 
+> **Mind the package name**: the PyPI package is **`coderouter-cli`**. The PyPI package named `coderouter` is a different product; don't `pip install coderouter`.
+
 ---
 
 ## Use with Claude Code
@@ -79,7 +83,7 @@ That's it. Claude Code works as usual, but your local Ollama is answering behind
 |---|---|
 | Claude Code + local Ollama, tool calling breaks | **Yes** — wire translation + tool repair |
 | Claude Code + local, dies after long sessions | **Helpful** — 6 guards + self-healing |
-| codex / agy + Ollama works fine | Optional — if you want fallback |
+| codex / agy + Ollama works fine | Optional — if you want fallback (codex: once `/v1/responses` lands) |
 | Using Claude API directly, no issues | Not needed |
 
 Full decision matrix → [Do I need CodeRouter?](./docs/start/when-do-i-need-coderouter.en.md)
@@ -93,7 +97,7 @@ Full decision matrix → [Do I need CodeRouter?](./docs/start/when-do-i-need-cod
 | Feature | What it does |
 |---|---|
 | **Wire translation** | Claude Code (Anthropic format) ↔ Ollama (OpenAI format) auto-converted |
-| **Tool-call repair** | JSON that local models emit as plain text → valid tool_use blocks |
+| **Tool-call repair** | JSON that local models emit as plain text → valid tool_use blocks. Measured in the [repair benchmark](./benchmarks/tool-repair/README.md): four models that break tool calls go from 0% to 80–100% success; zero false repairs on the regression corpus, gated in CI |
 | **3-tier fallback** | Local → free cloud → paid, automatic switching |
 | **Output filters** | Strips leaked `<think>` tags, stop markers, XML tool tags |
 
@@ -268,6 +272,14 @@ CodeRouter runs as an independent backend router layer. Point any project's `OPE
 
 Secrets go in env vars, not config files. See [`docs/security.en.md`](./docs/guides/security.en.md) for the full policy and reporting instructions.
 
+Releases are protected in layers. No single one of these is offered as proof of safety (tampered builds have shipped from legitimate pipelines before).
+
+- Published to PyPI via Trusted Publishing (OIDC); no long-lived API token exists
+- PyPI accepts uploads only from `release.yml` running in the `pypi` environment
+- Tags are cut only after a pre-flight script checks version, CHANGELOG and main
+- Five runtime dependencies
+- An SBOM (CycloneDX) is attached to every release
+
 ## License
 
 MIT

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/README.md

@@ -21,7 +21,7 @@
 ## 何ができるか — 30 秒で
 
 ```
-あなたのエージェント (Claude Code / codex / agy)
+あなたのエージェント (Claude Code / agy ほか ※)
         │
         ▼
   ┌─ CodeRouter ─┐
@@ -31,6 +31,8 @@
   └──────────────┘
 ```
 
+※ 現行の codex CLI は Responses API（`/v1/responses`）専用になったため、CodeRouter 経由ではまだ使えません（対応予定）。直結の代替手順 → [quickstart Pattern B](./docs/start/quickstart.md#pattern-b-codex-cli-で使う)
+
 **やってくれること:**
 
 - ローカルモデルが壊した tool calling を Claude Code に届く前に修復する
@@ -73,6 +75,8 @@ uvx --from coderouter-cli coderouter serve --port 8088
 
 恒久インストールしたい場合: `uv tool install coderouter-cli`
 
+> **パッケージ名に注意**: PyPI のパッケージ名は **`coderouter-cli`** です。PyPI の `coderouter`（名前だけ同じ）は別の製品なので、`pip install coderouter` と打たないでください。
+
 ---
 
 ## Claude Code で使う
@@ -98,7 +102,7 @@ ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
 | Claude Code + ローカル Ollama で tool calling が壊れる | **必須** — tool 修復 (+ 必要なら wire 変換) |
 | Claude Code + ローカルで長時間回すと止まる | **必須級** — 6 系統ガード + self-healing |
 | Ollama v0.14+ / LM Studio にネイティブ直結で動いてる | **便利** — 直結に無い fallback / ガード / 診断を追加 (passthrough で翻訳ゼロ) |
-| codex / agy + Ollama 直繋ぎで動いてる | オプション — フォールバックが欲しいなら |
+| codex / agy + Ollama 直繋ぎで動いてる | オプション — フォールバックが欲しいなら(codex は `/v1/responses` 対応後) |
 | Claude API を直接叩いてて問題ない | 不要 |
 
 詳細は → [要否判定ガイド](./docs/start/when-do-i-need-coderouter.md)
@@ -111,7 +115,7 @@ ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
 
 | 機能 | 何をしてくれるか |
 |---|---|
-| **Tool-call 修復** | ローカルモデルがテキストで吐いた JSON を正しい tool_use ブロックに復元 |
+| **Tool-call 修復** | ローカルモデルがテキストで吐いた JSON を正しい tool_use ブロックに復元。実測は [修復ベンチ](./benchmarks/tool-repair/README.md)（壊れた tool call を出す 4 モデルで成功率 0% → 80〜100%、回帰コーパスで誤修復 0 件。CI でゲート） |
 | **3 層フォールバック** | ローカル → 無料クラウド → 有料の順に自動切替 |
 | **出力フィルタ** | `<think>` タグ漏れ、stop marker 漏れ、byte-fallback (`<0xNN>`) を自動除去/修復 |
 | **Wire 翻訳** | Anthropic 形式 ↔ OpenAI 形式を自動変換 (ネイティブ `/v1/messages` 対応 backend は passthrough で翻訳ゼロ) |
@@ -288,6 +292,14 @@ CodeRouter は backend ルーター層として独立して動きます。`OPENA
 
 シークレットは環境変数に置きます。[`docs/security.md`](./docs/guides/security.md) に完全な方針と報告手順があります。
 
+リリースは多層で守っています。どれか 1 つを根拠に「安全」とは言いません(正規のパイプラインでビルドされた汚染版が出た例があります)。
+
+- PyPI へは Trusted Publishing(OIDC)で公開し、長期の API トークンを置かない
+- PyPI 側の公開許可は `release.yml` の `pypi` 環境に限定している
+- タグは事前検査スクリプトを通してから打つ(version・CHANGELOG・main の一致を機械的に確認)
+- 実行時の依存は 5 個に絞っている
+- 各リリースに SBOM(CycloneDX)を添付する
+
 ## License
 
 MIT

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/coderouter/doctor.py

@@ -635,6 +635,49 @@ _PROBE_TOOL_SPEC_ANTHROPIC = {
 }
 
 
+# v2.15.1: llama.cpp changed ``llama-server``'s default listen port from
+# 8080 to 9931 (ggml-org/llama.cpp#30159, build b11521, 2026-10-09). A server
+# started without ``--port`` on a new build is invisible to a provider that
+# still points at :8080, and the reverse holds for configs written against
+# the new default. When the basic probe cannot connect to one of those two
+# ports on a loopback host, check the other one so the transport error can
+# name the likely cause instead of looking like "server not running".
+_LLAMACPP_PORT_PAIR: dict[int, int] = {8080: 9931, 9931: 8080}
+_LOOPBACK_HOSTS = frozenset({"localhost", "127.0.0.1", "::1"})
+
+
+async def _llamacpp_port_hint(base_url: object) -> str | None:
+    """Return a hint when the other llama.cpp default port answers.
+
+    Only fires for loopback hosts on port 8080 or 9931. The alternate
+    port is probed at ``GET /health`` (llama-server's readiness route)
+    with a short timeout on the IPv4 literal — ``localhost`` can resolve
+    to ``::1`` first on macOS, where llama-server is not listening. The
+    config is never rewritten; the operator decides.
+    """
+    try:
+        parsed = httpx.URL(str(base_url))
+    except (httpx.InvalidURL, TypeError):
+        return None
+    if parsed.host not in _LOOPBACK_HOSTS or parsed.port not in _LLAMACPP_PORT_PAIR:
+        return None
+    other = _LLAMACPP_PORT_PAIR[parsed.port]
+    try:
+        async with httpx.AsyncClient(timeout=1.5) as client:
+            resp = await client.get(f"http://127.0.0.1:{other}/health")
+    except httpx.HTTPError:
+        return None
+    if resp.status_code >= 500:
+        return None
+    return (
+        f"Something is answering on port {other} instead. llama.cpp "
+        f"builds b11521+ listen on 9931 when started without --port "
+        f"(older builds: 8080). Either start llama-server with "
+        f"--port {parsed.port}, or change this provider's base_url to "
+        f"port {other}"
+    )
+
+
 async def _probe_auth_and_basic_chat(
     provider: ProviderConfig,
 ) -> ProbeResult:
@@ -670,10 +713,14 @@ async def _probe_auth_and_basic_chat(
     )
 
     if status is None:
+        detail = f"could not reach {url}: {raw}"
+        hint = await _llamacpp_port_hint(provider.base_url)
+        if hint:
+            detail = f"{detail}. {hint}"
         return ProbeResult(
             name="auth+basic-chat",
             verdict=ProbeVerdict.TRANSPORT_ERROR,
-            detail=f"could not reach {url}: {raw}",
+            detail=detail,
         )
 
     if status in (401, 403):

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/backends/claude-code-llamacpp-vllm.en.md

@@ -35,6 +35,8 @@ llama-server -m ~/models/<model>.gguf --host 127.0.0.1 --port 8080 \
 # Always check "n_ctx = 32768" in the startup log
 ```
 
+> **About llama.cpp's default port**: since llama.cpp b11521 (2026-10-09), `llama-server` started without `--port` listens on **9931** (older builds: 8080). The commands on this page pass `--port 8080` explicitly, so they work on either build. If you start it without `--port`, point `base_url` in `providers.yaml` at `:9931`. `coderouter doctor --check-model` calls this out when one port refuses and the other answers.
+
 **vLLM (NVIDIA GPU)**
 
 ```bash

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/backends/claude-code-llamacpp-vllm.md

@@ -35,6 +35,8 @@ llama-server -m ~/models/<model>.gguf --host 127.0.0.1 --port 8080 \
 # 起動ログの「n_ctx = 32768」を必ず確認する
 ```
 
+> **llama.cpp の既定ポートについて**: llama.cpp b11521(2026-10-09)以降、`--port` を省略した `llama-server` は **9931** で待ち受けます(それより前は 8080)。このページの手順は `--port 8080` を明示しているので、どちらの版でもそのまま動きます。`--port` を省略して起動した場合は、`providers.yaml` の `base_url` を `:9931` に合わせてください。`coderouter doctor --check-model` は、片方のポートに繋がらずもう片方が応答しているときにそう指摘します。
+
 **vLLM（NVIDIA GPU）**
 
 ```bash

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/backends/install-backends.en.md

@@ -78,6 +78,8 @@ llama-server -m ./model.gguf --port 8080
 curl http://localhost:8080/v1/models
 ```
 
+> **About llama.cpp's default port**: since llama.cpp b11521 (2026-10-09), `llama-server` started without `--port` listens on **9931** (older builds: 8080). The commands on this page pass `--port 8080` explicitly, so they work on either build. If you start it without `--port`, point `base_url` in `providers.yaml` at `:9931`. `coderouter doctor --check-model` calls this out when one port refuses and the other answers.
+
 ### Common pitfalls
 
 - **CUDA and Metal cannot coexist in one binary.** Build/download for the machine you will run on.

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/backends/install-backends.md

@@ -78,6 +78,8 @@ llama-server -m ./model.gguf --port 8080
 curl http://localhost:8080/v1/models
 ```
 
+> **llama.cpp の既定ポートについて**: llama.cpp b11521(2026-10-09)以降、`--port` を省略した `llama-server` は **9931** で待ち受けます(それより前は 8080)。このページの手順は `--port 8080` を明示しているので、どちらの版でもそのまま動きます。`--port` を省略して起動した場合は、`providers.yaml` の `base_url` を `:9931` に合わせてください。`coderouter doctor --check-model` は、片方のポートに繋がらずもう片方が応答しているときにそう指摘します。
+
 ### よくあるつまずき
 
 - **CUDA と Metal は同一バイナリに同梱できません。** 実行マシンに合わせてビルド/ダウンロードしてください。

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/backends/launcher.en.md

@@ -106,7 +106,7 @@ The Launcher screen is made up of a "MODELS panel," a "LAUNCH form," a "PROCESSE
 | Field | Description |
 |---|---|
 | **Name** | Any identifier for management purposes (e.g. `qwen-coder-8080`) |
-| **Port** | The port the server will run on (default `8080`) |
+| **Port** | The port the server will run on (default `8080`). The Launcher always passes `--port`, so llama.cpp's own default-port change (9931 since b11521) does not affect it |
 | **Backend** | Choose from `llama.cpp` / `vllm` / `mlx`. The resolved binary path and availability are shown below |
 | **Model path** | Selected from the MODELS panel or entered directly |
 | **Option profile** | Choose a preset defined in `providers.yaml` |

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/backends/launcher.md

@@ -106,7 +106,7 @@ Launcher の画面は「MODELS パネル」「LAUNCH フォーム」「PROCESSES
 | 項目 | 説明 |
 |---|---|
 | **名前** | 管理用の任意の識別子(例: `qwen-coder-8080`) |
-| **ポート** | 起動するサーバーのポート(既定 `8080`) |
+| **ポート** | 起動するサーバーのポート(既定 `8080`)。Launcher は常に `--port` を明示して起動するので、llama.cpp 側の既定ポート変更(b11521 以降 9931)の影響は受けない |
 | **バックエンド** | `llama.cpp` / `vllm` / `mlx` から選択。解決されたバイナリパスと利用可否が下に表示される |
 | **モデルパス** | MODELS パネルから選択するか直接入力 |
 | **オプションプロファイル** | `providers.yaml` で定義したプリセットを選択 |

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/backends/llamacpp-direct.en.md

@@ -78,6 +78,9 @@ hf download unsloth/Qwen3.6-35B-A3B-GGUF \
 ```
 
 - `--port 8080`: where CodeRouter connects.
+
+> **About llama.cpp's default port**: since llama.cpp b11521 (2026-10-09), `llama-server` started without `--port` listens on **9931** (older builds: 8080). The commands on this page pass `--port 8080` explicitly, so they work on either build. If you start it without `--port`, point `base_url` in `providers.yaml` at `:9931`. `coderouter doctor --check-model` calls this out when one port refuses and the other answers.
+
 - `--ctx-size 32768`: leaves headroom for Claude Code's 15-20K-token system prompt.
 - `--n-predict 4096`: per-call generation cap.
 - `--jinja`: use the chat template embedded in GGUF metadata (Unsloth GGUFs ship one).

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/backends/llamacpp-direct.md

@@ -91,6 +91,8 @@ ls -lah ~/models/qwen3.6-35b-a3b-unsloth/
 - `-ngl 999`: 全 layer を GPU にオフロード (Metal)
 - `--host 127.0.0.1`: localhost からのみ受け付け (security)
 
+> **llama.cpp の既定ポートについて**: llama.cpp b11521(2026-10-09)以降、`--port` を省略した `llama-server` は **9931** で待ち受けます(それより前は 8080)。このページの手順は `--port 8080` を明示しているので、どちらの版でもそのまま動きます。`--port` を省略して起動した場合は、`providers.yaml` の `base_url` を `:9931` に合わせてください。`coderouter doctor --check-model` は、片方のポートに繋がらずもう片方が応答しているときにそう指摘します。
+
 起動 log で以下が出れば OK：
 
 ```

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/start/quickstart.en.md

@@ -202,45 +202,32 @@ The `claude-code` profile (local 2-tier + free cloud) is selected automatically.
 
 ## Pattern B: use it with the codex CLI
 
-> **Version note**: Codex 0.88+ defaults to `wire_api = "responses"`, which posts to
-> `/v1/responses`. CodeRouter currently only handles the Chat Completions path
-> (`/v1/chat/completions`), so you must **explicitly set `wire_api = "chat"`**.
+> **Status (as of 2026-10): current Codex CLI cannot go through CodeRouter.**
+> Codex removed `wire_api = "chat"` in 2026-02 and now speaks only the Responses API
+> (`/v1/responses`). The old instruction to set `wire_api = "chat"` makes current Codex
+> fail while loading its config. CodeRouter does not serve `/v1/responses` yet
+> (planned; until then, use the workaround below).
 
-### B-1. Install codex
+### B-1. Workaround: connect Codex directly to a local inference server
 
-```bash
-npm install -g @openai/codex
-```
+The major local servers already serve `/v1/responses`, so Codex can talk to them without
+CodeRouter in between. CodeRouter's fallback and tool-call repair do not apply in this setup.
 
-### B-2. Create `~/.codex/config.toml`
+- **Ollama / LM Studio**: `codex --oss` (Codex's built-in OSS provider)
+- **llama.cpp (`llama-server`)**: add a provider to `~/.codex/config.toml`
 
 ```toml
-model = "gpt-4o"          # CodeRouter will substitute the real model
-model_provider = "coderouter"
-
-[model_providers.coderouter]
-name = "CodeRouter"
-base_url = "http://localhost:8088/v1"
-env_key = "OPENAI_API_KEY"
-wire_api = "chat"          # required: the responses endpoint is not yet supported
-```
+model = "local"
+model_provider = "llamacpp"
 
-```bash
-export OPENAI_API_KEY="dummy"   # placeholder is fine (CodeRouter manages the backends)
+[model_providers.llamacpp]
+name = "llama.cpp"
+base_url = "http://127.0.0.1:9931/v1"   # default port since b11521; use your --port if you set one
+wire_api = "responses"
 ```
 
-### B-3. Run it
-
-```bash
-codex "write a python function that reverses a string"
-```
-
-Same backend chain, just spoken to in OpenAI shape. The `default` profile (local 7b + free cloud) is selected.
-
-> **Models without tool-call support**: Codex drives all file and shell operations
-> through tool calls. If the Ollama model does not support tool calling, Codex will
-> connect but tools will silently do nothing. Run
-> `coderouter doctor --check-model <model>` and confirm `tool_calls: OK` before use.
+> **Models without tool calling**: Codex does all file and shell work through tool
+> calls. A model without tool-call support will connect, but no tool will work.
 
 ---
 

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/start/quickstart.md

@@ -199,46 +199,33 @@ profile は自動で `claude-code` (ローカル 2 段 + 無料クラウド) が
 
 ## Pattern B: codex CLI で使う
 
-> **バージョン注意**: Codex 0.88 以降はデフォルトで `wire_api = "responses"` を使い、
-> `/v1/responses` エンドポイントに接続します。CodeRouter は現時点で Chat Completions
-> 経路 (`/v1/chat/completions`) のみ対応しているため、**`wire_api = "chat"` を明示**
-> する必要があります。
+> **現状（2026-10 時点）: 現行の Codex CLI は CodeRouter 経由では使えません。**
+> Codex は 2026-02 に `wire_api = "chat"` を廃止し、Responses API（`/v1/responses`）でしか
+> 通信しなくなりました。古い手順の `wire_api = "chat"` を書くと、現行の Codex は設定の
+> 読み込み時にエラーで止まります。CodeRouter はまだ `/v1/responses` を持っていません
+> （対応予定。それまでの代替は下記）。
 
-### B-1. codex をインストール
+### B-1. 代替: Codex をローカル推論サーバへ直結する
 
-```bash
-npm install -g @openai/codex
-```
+主要なローカル推論サーバは `/v1/responses` を持っているので、CodeRouter を挟まずに
+Codex を直結できます。この場合 CodeRouter のフォールバックと tool 修復は効きません。
 
-### B-2. `~/.codex/config.toml` を作成
+- **Ollama / LM Studio**: `codex --oss`（Codex 組み込みの OSS provider）
+- **llama.cpp（`llama-server`）**: `~/.codex/config.toml` に provider を書く
 
 ```toml
-model = "gpt-4o"          # CodeRouter 側で実際のモデルに差し替えられます
-model_provider = "coderouter"
-
-[model_providers.coderouter]
-name = "CodeRouter"
-base_url = "http://localhost:8088/v1"
-env_key = "OPENAI_API_KEY"
-wire_api = "chat"          # ← 必須: responses エンドポイントは未対応
-```
+model = "local"
+model_provider = "llamacpp"
 
-```bash
-export OPENAI_API_KEY="dummy"   # ダミーで OK (CodeRouter がバックエンドを管理します)
+[model_providers.llamacpp]
+name = "llama.cpp"
+base_url = "http://127.0.0.1:9931/v1"   # b11521 以降の既定ポート。--port を付けたならその値
+wire_api = "responses"
 ```
 
-### B-3. 実行
-
-```bash
-codex "write a python function that reverses a string"
-```
-
-同じバックエンドチェーンに対して OpenAI 形式で話しかけているだけです。profile は `default` (ローカル 7b + 無料クラウド) が選ばれます。
-
 > **tool call 非対応モデルについて**: Codex はファイル操作・シェル実行をすべて
-> tool call で行います。Ollama のモデルが tool call に対応していない場合、接続は
-> できてもツールが動きません。`coderouter doctor --check-model <モデル名>` で
-> `tool_calls: OK` を確認してから使ってください。
+> tool call で行います。モデルが tool call に対応していないと、接続はできてもツールが
+> 動きません。
 
 ---
 

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/start/when-do-i-need-coderouter.en.md

@@ -18,7 +18,7 @@ knob, and what wire format it speaks.
 | Agent | Wire format | Can point at Ollama directly? | Need CodeRouter? |
 |---|---|---|---|
 | **Claude Code** | Anthropic `/v1/messages` | No — Ollama speaks OpenAI | **Yes** — wire translation is the whole point |
-| **Codex CLI** (`@openai/codex`) | OpenAI | Yes, via `OPENAI_BASE_URL` | Optional — only if you need filters / fallback |
+| **Codex CLI** (`@openai/codex`) | OpenAI Responses | Yes, to servers with the Responses API (Ollama / LM Studio / llama.cpp) | **Not usable yet** — current Codex speaks only the Responses API, which CodeRouter does not serve yet (planned) |
 | **Plain OpenAI SDK / `curl`** | OpenAI | Yes, via `base_url` | Optional — same as above |
 | **gemini-cli** | Gemini | No — different wire | Yes, once a Gemini adapter is added |
 | **GitHub Copilot CLI** (`gh copilot`) | GitHub-proprietary | **No — backend is locked** | **N/A** — Copilot cannot be redirected at all |
@@ -91,10 +91,8 @@ Miss any one, and CodeRouter does real work.
 Before adopting anything, prove your direct path actually works:
 
 ```bash
-# Point Codex CLI (or any OpenAI-compatible tool) at Ollama
-export OPENAI_BASE_URL=http://localhost:11434/v1
-export OPENAI_API_KEY=ollama  # dummy, Ollama ignores it
-codex "write a function that reverses a string in rust"
+# Connect Codex straight to Ollama (Codex's built-in OSS provider)
+codex --oss "write a function that reverses a string in rust"
 ```
 
 Watch for these four symptoms:

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/docs/start/when-do-i-need-coderouter.md

@@ -11,7 +11,7 @@
 | エージェント | wire 形式 | Ollama に直接向けられる？ | CodeRouter 必要？ |
 |---|---|---|---|
 | **Claude Code** | Anthropic `/v1/messages` | ✕ — Ollama は OpenAI しか喋らない | **必須** — 翻訳こそが本題 |
-| **Codex CLI** (`@openai/codex`) | OpenAI | ◯ — `OPENAI_BASE_URL` で | オプション — フィルタ / フォールバックが欲しいときだけ |
+| **Codex CLI** (`@openai/codex`) | OpenAI Responses | ◯ — Responses API を持つサーバ(Ollama / LM Studio / llama.cpp)へ | **現状は使えない** — 現行の Codex は Responses API 専用で、CodeRouter は未対応(対応予定) |
 | **素の OpenAI SDK / `curl`** | OpenAI | ◯ — `base_url` で | オプション — 同上 |
 | **gemini-cli** | Gemini | ✕ — 別 wire | 必要（Gemini アダプタ追加時） |
 | **GitHub Copilot CLI** (`gh copilot`) | GitHub 独自 | **✕ — バックエンド固定** | **無力** — Copilot 側が差し替え不可 |
@@ -70,10 +70,8 @@ CodeRouter の出力フィルタと修復ロジックは、**特定のモデル
 何かを導入する前に、まず直続きが本当に動くか試すのが早いです:
 
 ```bash
-# Codex CLI（あるいは任意の OpenAI 互換ツール）を Ollama に向ける
-export OPENAI_BASE_URL=http://localhost:11434/v1
-export OPENAI_API_KEY=ollama  # ダミー。Ollama は無視
-codex "write a function that reverses a string in rust"
+# Codex を Ollama に直結する(Codex 組み込みの OSS provider)
+codex --oss "write a function that reverses a string in rust"
 ```
 
 以下 4 症状を観察:

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/examples/providers.cli-session.yaml

@@ -83,6 +83,7 @@ providers:
       env: ANTHROPIC_API_KEY
 
   # ── ローカル (認証なし) ──────────────────────────────────────────────
+  # llama-server を --port 8080 で起動した前提 (b11521+ は省略時 9931)
   - name: local-llama
     kind: openai_compat
     base_url: http://localhost:8080/v1

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/examples/providers.llamacpp-vllm.yaml

@@ -29,7 +29,8 @@
 # ポート番号は /launcher の Launch フォームで指定したものと合わせてください。
 
 providers:
-  # llama.cpp (llama-server) を 8080 で起動した場合
+  # llama.cpp (llama-server) を --port 8080 で起動した場合
+  # (b11521 以降の llama.cpp は --port を省略すると 9931 で待ち受ける)
   - name: llama-cpp-local
     kind: openai_compat
     base_url: http://localhost:8080/v1

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/examples/providers.yaml

@@ -84,6 +84,8 @@ providers:
   # ------------------------------------------------------------
 
   # llama.cpp --api-server — fastest if you have a GGUF loaded
+  # Port: started with `--port 8080` here. llama.cpp b11521+ (2026-10-09)
+  # listens on 9931 when `--port` is omitted (older builds: 8080).
   - name: local-llamacpp
     kind: openai_compat
     base_url: http://localhost:8080/v1
@@ -120,7 +122,7 @@ providers:
   #     --include "*UD-Q4_K_M*" "*tokenizer*" "*chat_template*" \
   #     --local-dir ~/models/qwen3.6-35b-a3b-unsloth
   #
-  #   # 3. llama-server 起動 (port 8080)
+  #   # 3. llama-server 起動 (port 8080 を明示。b11521 以降は省略すると 9931)
   #   ~/llama.cpp/build/bin/llama-server \
   #     --model ~/models/qwen3.6-35b-a3b-unsloth/Qwen3.6-35B-A3B-UD-Q4_K_M.gguf \
   #     --port 8080 --ctx-size 32768 --n-predict 4096 \

{coderouter_cli-2.15.0 → coderouter_cli-2.15.1}/pyproject.toml

@@ -11,7 +11,7 @@
 # in plan.md §11.B; once granted, this name will become an alias and
 # `coderouter` will become the canonical distribution name.
 name = "coderouter-cli"
-version = "2.15.0"
+version = "2.15.1"
 description = "Local-first, free-first, fallback-built-in LLM router. Claude Code / OpenAI compatible."
 readme = "README.md"
 requires-python = ">=3.12"