Skip to content

Commit 802f04a

Browse files
authored
Merge pull request #2746 from lidge-jun/codex/locale-docs-contradictions
docs: stop shipping locale pages that contradict the code
2 parents a57b962 + 95314c1 commit 802f04a

18 files changed

Lines changed: 74 additions & 40 deletions

File tree

‎README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,17 +21,17 @@ ocx start # proxy + dashboard on localhost:10100
2121
<sub><b>Claude Code, running any model.</b><br>The picker is stock Claude Code. The brain behind it isn't.</sub>
2222
</td>
2323
<td width="50%" align="center">
24-
<img src="assets/demo.gif" alt="opencodex demo — running a task in the Codex app on a routed non-OpenAI model" width="410"><br>
24+
<img src="https://raw.githubusercontent.com/lidge-jun/opencodex/main/assets/demo.gif" alt="opencodex demo — running a task in the Codex app on a routed non-OpenAI model" width="410"><br>
2525
<sub><b>Codex, running any model.</b><br>Pick a provider and go — same workflow, different brain.</sub>
2626
</td>
2727
</tr>
2828
<tr>
2929
<td width="50%" align="center">
30-
<img src="assets/claude-desktop-subagent.gif" alt="Claude Desktop answering as Claude Opus 4.8, then dispatching a GPT-5.6 Sol subagent through opencodex" width="410"><br>
30+
<img src="https://raw.githubusercontent.com/lidge-jun/opencodex/main/assets/claude-desktop-subagent.gif" alt="Claude Desktop answering as Claude Opus 4.8, then dispatching a GPT-5.6 Sol subagent through opencodex" width="410"><br>
3131
<sub><b>Claude Desktop, running any model.</b><br>Opus answers, then hands the task to a GPT-5.6 Sol subagent.</sub>
3232
</td>
3333
<td width="50%" align="center">
34-
<img src="assets/grok-build-subagent.gif" alt="Grok Build running GPT-5.6 Sol through opencodex and calling a Kimi K3 subagent" width="410"><br>
34+
<img src="https://raw.githubusercontent.com/lidge-jun/opencodex/main/assets/grok-build-subagent.gif" alt="Grok Build running GPT-5.6 Sol through opencodex and calling a Kimi K3 subagent" width="410"><br>
3535
<sub><b>Grok Build, running any model.</b><br>Sol drives the session and calls a Kimi K3 subagent.</sub>
3636
</td>
3737
</tr>

‎docs-site/src/content/docs/fr/reference/adapters.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Adaptateurs
3-
description: Les sept adaptateurs de fournisseurs — leurs cibles, la construction des requêtes et leurs particularités.
3+
description: Les adaptateurs de fournisseurs — leurs cibles, la construction des requêtes et leurs particularités.
44
---
55

66
Un **adaptateur** traduit les échanges entre le modèle interne de requête/réponse d’opencodex et le protocole d’un fournisseur. Chaque adaptateur implémente l’interface `ProviderAdapter` (`src/adapters/base.ts`) :
@@ -30,7 +30,7 @@ interface ProviderAdapter {
3030
- **Réécrit le prompt d’identité GPT-5 de Codex** sous une forme indépendante du modèle afin que les modèles routés ne prétendent pas être OpenAI.
3131
- **Limite `reasoning_effort`** au sous-ensemble annoncé par le modèle lorsque le niveau exact n’est pas disponible ; `xhigh` et `max` restent des libellés distincts, sauf si un fournisseur configure explicitement un alias. L’adaptateur **omet entièrement ce champ** pour les identifiants figurant dans `provider.noReasoningModels`.
3232
- Diffuse `delta.content` (texte), `delta.reasoning_content` (raisonnement) et `delta.tool_calls[]`, et recueille `usage`.
33-
- ClinePass utilise le format de passerelle vérifié en conditions réelles `reasoning: { enabled: true, effort: "low" }` (ou `{ enabled: false }` lorsque le raisonnement est désactivé). Sa documentation publique d’API ne précise pas encore cette forme de requête. L’adaptateur limite les autres niveaux demandés au niveau `low` vérifié, accepte les deltas de raisonnement provenant de `delta.reasoning_content` ou de `delta.reasoning`, demande les données d’utilisation en flux avec `stream_options.include_usage` et lit ces données dans les enveloppes de réponse hors flux.
33+
- ClinePass utilise le format de passerelle vérifié en conditions réelles `reasoning: { enabled: true, effort }` (ou `{ enabled: false }` lorsque le raisonnement est désactivé). Sa documentation publique d’API ne précise pas encore cette forme de requête. L’adaptateur préserve les niveaux `low`, `medium`, `high`, `xhigh` et `max` demandés, accepte les deltas de raisonnement provenant de `delta.reasoning_content` ou de `delta.reasoning`, demande les données d’utilisation en flux avec `stream_options.include_usage` et lit ces données dans les enveloppes de réponse hors flux.
3434

3535
## `openai-responses`
3636

‎docs-site/src/content/docs/fr/reference/architecture.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ src/
1313
├── server/ # Bun.serve, /v1/* proxy, /api/* management API, WS bridge
1414
├── codex/ # Codex config injection, catalog sync, auth/account integration
1515
├── providers/ # provider metadata, API-key pool, quota and labels
16-
├── adapters/ # seven wire adapters, shared guards/utilities, Cursor protobuf transport
16+
├── adapters/ # wire adapters, shared guards/utilities, Cursor protobuf transport
1717
├── oauth/ # OAuth providers, API-key catalog, token store/refresh
1818
├── usage/ # request usage extraction, JSONL logs, summaries, totals
1919
├── lib/ # runtime, process, retry, privacy, token estimate helpers
@@ -42,7 +42,7 @@ Trois anciens points d’entrée volumineux préservent désormais la compatibil
4242
2. `server/responses/core.ts` décompresse et analyse le JSON, développe les entrées de mémoire locale `previous_response_id` lorsqu’elles sont disponibles, puis appelle `responses/parser.ts`.
4343
3. `router.ts` résout un identifiant simple ou `provider/model`. Le serveur détermine ensuite l’affinité du compte Codex, actualise l’authentification OAuth du fournisseur si nécessaire et applique à la route les identifiants sélectionnés.
4444
4. Avant l’appel principal, `vision/` décrit les images pour les modèles figurant dans `noVisionModels`. En l’absence de service auxiliaire sûr, les images sont supprimées plutôt qu’envoyées à un service en amont purement textuel.
45-
5. `server/adapter-resolve.ts` applique toute substitution de protocole propre au modèle et construit l’un des sept adaptateurs. L’adaptateur Responses relaie le corps natif, Cursor exécute son transport bidirectionnel `runTurn`, et les adaptateurs traduits construisent, envoient et analysent une requête en amont.
45+
5. `server/adapter-resolve.ts` applique toute substitution de protocole propre au modèle et construit l’un des adaptateurs enregistrés. L’adaptateur Responses relaie le corps natif, Cursor exécute son transport bidirectionnel `runTurn`, et les adaptateurs traduits construisent, envoient et analysent une requête en amont.
4646
6. Pour les modèles routés avec un outil hébergé `web_search`, `web-search/` expose une fonction synthétique, exécute la recherche réelle avec le backend configuré — le service auxiliaire OpenAI/ChatGPT ou le backend Anthropic —, renvoie les résultats au modèle routé et recommence dans la limite de boucle configurée. Cette boucle ne prend en charge que le chemin HTTP classique ; les adaptateurs qui implémentent `runTurn`, comme Cursor, la contournent et poursuivent leur propre transport.
4747
7. `bridge.ts` produit un flux SSE Responses ou une réponse JSON. `server/request-log.ts` et `usage/` recueillent de manière bornée l’état, la latence, les libellés de fournisseur/modèle et l’utilisation estimée des jetons, sans modifier la réponse.
4848

‎docs-site/src/content/docs/ja/reference/adapters.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: アダプター
3-
description: 7つのプロバイダーアダプターの対象、リクエスト構成方式、固有の動作。
3+
description: プロバイダーアダプターの対象、リクエスト構成方式、固有の動作。
44
---
55

66
**アダプター**は opencodex の内部リクエスト/レスポンスモデルとプロバイダーの wire 形式の間を変換します。すべてのアダプターは `ProviderAdapter` インターフェース(`src/adapters/base.ts`)を実装します。
@@ -134,7 +134,7 @@ model discovery の両方に適用されます。
134134
- ツールなしで正常終了したターンでは、返された ConversationStateStructure をプロセスローカルに保持し、検証済みの線形継続で checkpoint を再利用します。tool-result ターンでは、対象メッセージ境界が判明している場合、最後に正常終了したターンの checkpoint に未収録の suffix だけを追加します。ref のない prefix lookup は、記憶済みの Cursor conversation または安定した client thread(制限付きの Desktop session/thread fallback を含む)があり、同じ provider conversation が所有する checkpoint が一意に一致する場合だけ許可します。それ以外は full replay に戻ります。compaction、helper/shadow の分離、account/model の不一致、ref の欠落、decode の失敗、forced-fresh recovery、invalid_argument retry でも full replay を使います。プロセスを再起動するとメモリ内 store は失われ、full replay になります。Cursor Connect は権威ある cache_read_tokens を公開しないため、OpenCodex usage は cache-hit counter ではありません。制限付き Desktop fallback が保存するのはプロセスローカルで HMAC から導出した owner だけで、raw session/thread header や OAuth/authorization material を checkpoint state に書き込みません。OAuth-backed live transport とアカウントで絞り込む live model discovery は実験的です。ログインと transport の設定は [provider guide](/ja/guides/providers/) と [Cursor provider configuration](/ja/reference/configuration/providers/#cursor-provider-adapter-cursor) を参照してください。checkpoint reuse 自体は自動で、ユーザー設定はありません。
135135
- `cursor/grok-4.5-fast` は選択可能なモデルとして維持しつつ、Cursor には正規の `grok-4.5`
136136
モデルを送信し、個別の `effort` および `fast=true` 値は `requested_model.parameters` に格納します。
137-
- Cursor ネイティブのローカルファイルシステム/shell/network 実行はデフォルトで拒否します。明示的な `mcpServers` と `desktopExecutor` 統合はそれぞれ別の opt-in です。`unsafeAllowNativeLocalExec` はより広い組み込み executor を有効にし、Codex の承認/サンドボックスルールを迂回します。
137+
- Cursor ネイティブのローカルファイルシステム/shell/network 実行はデフォルトで拒否します。明示的な `mcpServers` と `desktopExecutor` 統合はそれぞれ別の opt-in です。`nativeLocalExec: "on"` はより広い組み込み executor を有効にし、Codex の承認/サンドボックスルールを迂回します。従来の `unsafeAllowNativeLocalExec: true` は、`nativeLocalExec` が設定されていない場合にのみ同等です。
138138

139139
## `azure-openai`(別名: `azure`)
140140

‎docs-site/src/content/docs/ja/reference/architecture.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ src/
1313
├── server/ # Bun.serve, /v1/* proxy, /api/* management API, WS bridge
1414
├── codex/ # Codex config injection, catalog sync, auth/account integration
1515
├── providers/ # provider metadata, API-key pool, quota and labels
16-
├── adapters/ # 7つの wire adapter, 共通 guard/util, Cursor protobuf transport
16+
├── adapters/ # wire adapter, 共通 guard/util, Cursor protobuf transport
1717
├── oauth/ # OAuth providers, API-key catalog, token store/refresh
1818
├── usage/ # usage extraction, JSONL logs, summaries, totals
1919
├── lib/ # runtime, process, retry, privacy, token estimate helpers
@@ -51,7 +51,7 @@ HTTP の境界は `server/index.ts` が担い、Responses データプレーン
5151
2. `server/responses/core.ts` が展開し JSON を読みます。覚えておいた `previous_response_id` 入力があれば展開したのち `responses/parser.ts` に渡します。
5252
3. `router.ts` が通常のモデル id または `provider/model` id を解決します。続いて Codex アカウント affinity を決定し、必要ならプロバイダー OAuth を更新して選択された認証情報を route に適用します。
5353
4. 本リクエストの前に `vision/` が `noVisionModels` モデル用の画像説明を作ります。安全なサイドカー経路がないときはテキスト専用の上流に画像を送らず取り除きます。
54-
5. `server/adapter-resolve.ts` がモデル別の wire override を適用し、7つのアダプターのいずれかを作ります。
54+
5. `server/adapter-resolve.ts` がモデル別の wire override を適用し、登録済みアダプターのいずれかを作ります。
5555
Responses passthrough は元の body を中継し、Cursor は双方向 `runTurn` transport を使い、
5656
残りの変換型アダプターは上流リクエストを build/fetch/parse します。
5757
6. ルーティングモデルがホステッド `web_search` を要求すると `web-search/` が合成関数を公開します。実際の検索は ChatGPT サイドカーで実行し、結果をルーティングモデルに戻し、設定された回数の中で繰り返します。

‎docs-site/src/content/docs/ko/reference/adapters.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -171,8 +171,9 @@ discovery에 모두 적용됩니다.
171171
- `cursor/grok-4.5-fast`는 선택 가능한 모델로 유지하되, Cursor에는 정식 `grok-4.5` 모델을 보내고
172172
별도의 `effort`, `fast=true` 값은 `requested_model.parameters`에 담습니다.
173173
- Cursor 네이티브 로컬 파일시스템/shell/network 실행은 기본적으로 거부합니다. 명시적인
174-
`mcpServers`와 `desktopExecutor` 통합은 각각 별도 opt-in입니다. `unsafeAllowNativeLocalExec`은
175-
더 넓은 내장 executor를 켜며 Codex 승인/샌드박스 규칙을 우회합니다.
174+
`mcpServers`와 `desktopExecutor` 통합은 각각 별도 opt-in입니다. `nativeLocalExec: "on"`은
175+
더 넓은 내장 executor를 켜며 Codex 승인/샌드박스 규칙을 우회합니다. 예전 설정인
176+
`unsafeAllowNativeLocalExec: true`는 `nativeLocalExec`을 지정하지 않았을 때만 같은 뜻입니다.
176177

177178
## `azure-openai` (별칭: `azure`)
178179

‎docs-site/src/content/docs/ko/reference/architecture.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ src/
1515
├── server/ # Bun.serve, /v1/* proxy, /api/* management API, WS bridge
1616
├── codex/ # Codex config injection, catalog sync, auth/account integration
1717
├── providers/ # provider metadata, API-key pool, quota and labels
18-
├── adapters/ # 7개 wire adapter, 공통 guard/util, Cursor protobuf transport
18+
├── adapters/ # wire adapter, 공통 guard/util, Cursor protobuf transport
1919
├── oauth/ # OAuth providers, API-key catalog, token store/refresh
2020
├── usage/ # usage extraction, JSONL logs, summaries, totals
2121
├── lib/ # runtime, process, retry, privacy, token estimate helpers
@@ -56,7 +56,7 @@ HTTP 경계는 `server/index.ts`가 맡고, Responses 데이터 플레인은 `se
5656
결정하고, 필요하면 프로바이더 OAuth를 갱신해 선택된 자격 증명을 route에 적용합니다.
5757
4. 본 요청 전에 `vision/`이 `noVisionModels` 모델용 이미지 설명을 만듭니다. 안전한 사이드카 경로가
5858
없으면 텍스트 전용 업스트림에 이미지를 보내지 않고 제거합니다.
59-
5. `server/adapter-resolve.ts`가 모델별 wire override를 적용하고 7개 어댑터 중 하나를 만듭니다.
59+
5. `server/adapter-resolve.ts`가 모델별 wire override를 적용하고 등록된 어댑터 중 하나를 만듭니다.
6060
Responses passthrough는 원본 body를 중계하고, Cursor는 양방향 `runTurn` transport를 사용하며,
6161
나머지 변환형 어댑터는 업스트림 요청을 build/fetch/parse합니다.
6262
6. 라우팅 모델이 호스티드 `web_search`를 요청하면 `web-search/`가 합성 함수를 노출합니다. 실제 검색은

‎docs-site/src/content/docs/reference/adapters.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Adapters
3-
description: The seven provider adapters — what each targets, how it builds requests, and its quirks.
3+
description: The provider adapters — what each targets, how it builds requests, and its quirks.
44
---
55

66
An **adapter** translates between opencodex's internal request/response model and one provider wire

‎docs-site/src/content/docs/reference/architecture.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ src/
1515
├── server/ # Bun.serve, /v1/* proxy, /api/* management API, WS bridge
1616
├── codex/ # Codex config injection, catalog sync, auth/account integration
1717
├── providers/ # provider metadata, API-key pool, quota and labels
18-
├── adapters/ # seven wire adapters, shared guards/utilities, Cursor protobuf transport
18+
├── adapters/ # wire adapters, shared guards/utilities, Cursor protobuf transport
1919
├── oauth/ # OAuth providers, API-key catalog, token store/refresh
2020
├── usage/ # request usage extraction, JSONL logs, summaries, totals
2121
├── lib/ # runtime, process, retry, privacy, token estimate helpers
@@ -59,7 +59,7 @@ the `server/responses.ts` facade and its `server/responses/*.ts` modules:
5959
4. Before the main call, `vision/` describes images for models in `noVisionModels`; if no safe
6060
sidecar path exists, images are removed rather than sent to a text-only upstream.
6161
5. `server/adapter-resolve.ts` applies any model-specific wire override and constructs one of the
62-
seven adapters. Responses passthrough relays the native body, Cursor runs its bidirectional
62+
registered adapters. Responses passthrough relays the native body, Cursor runs its bidirectional
6363
`runTurn` transport, and translated adapters build/fetch/parse an upstream request.
6464
6. For routed models with a hosted `web_search` tool, `web-search/` exposes a synthetic function,
6565
executes the real search through the configured backend (the OpenAI/ChatGPT sidecar or Anthropic),

‎docs-site/src/content/docs/ru/reference/adapters.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Адаптеры
3-
description: Семь адаптеров провайдеров — назначение каждого, способ построения запросов и особенности.
3+
description: Адаптеры провайдеров — назначение каждого, способ построения запросов и особенности.
44
---
55

66
**Адаптер** выполняет преобразование между внутренней моделью запросов/ответов opencodex и
@@ -179,8 +179,9 @@ authorization.
179179
`grok-4.5`, помещая отдельные значения `effort` и `fast=true` в `requested_model.parameters`.
180180
- Нативное для Cursor локальное выполнение операций с файловой системой/shell/сетью по умолчанию
181181
запрещено. Явные интеграции `mcpServers` и `desktopExecutor` включаются отдельно;
182-
`unsafeAllowNativeLocalExec` включает более широкий встроенный executor и обходит семантику
183-
одобрений/песочницы Codex.
182+
`nativeLocalExec: "on"` включает более широкий встроенный executor и обходит семантику
183+
одобрений/песочницы Codex; устаревший `unsafeAllowNativeLocalExec: true` эквивалентен только
184+
если `nativeLocalExec` не задан.
184185

185186
## `azure-openai` (алиас: `azure`)
186187

0 commit comments

Comments
 (0)