Skip to content
Merged
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
8 changes: 8 additions & 0 deletions docs-site/src/content/docs/fr/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -404,6 +404,14 @@ URL de base modifiée ressemblant à l'original n'est jamais sondée. Les crédi
gratuits restants sont affichés sous forme de fenêtre en USD lorsque Command Code signale également les
dépenses de la période.

**Contexte de projet Command Code.** `projectContext: "on"` optionnel sur le fournisseur OAuth `command-code`
uniquement (pas le préréglage à clé API `commandcode`) remplit `memory`, `taste` et `skills` de
`/alpha/generate` depuis le répertoire de travail du proxy. Définissez-le sur `providers.command-code` via
**Providers → Command Code → Edit JSON**, démarrez le proxy depuis le projet Codex de confiance et
redémarrez après enregistrement. Absent ou `"off"` conserve l'enveloppe vide même si `AGENTS.md` ou des
fichiers taste existent. Voir [Adapters](/fr/reference/adapters/#command-code) pour les chemins, plafonds
et le comportement fail-soft.

**Découverte SambaNova Cloud.** Le préréglage lit la liste publique `/v1/models` de SambaNova Cloud depuis
l'hôte API fixe, préserve les identifiants natifs du fournisseur et limite la découverte à 128 KiB et 128
lignes brutes. Le catalogue n'étant pas authentifié, le parcours de connexion de la CLI signale que la clé ne
Expand Down
6 changes: 6 additions & 0 deletions docs-site/src/content/docs/fr/guides/sidecars.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,12 @@ Lorsque Codex demande un hébergement `web_search` pour un modèle routé sans p
(par défaut 3), supprime ensuite l'outil de recherche et force une réponse finale. De vrais outils clients tels que
`apply_patch` ou le shell mettent fin au tour afin que ces appels parviennent à Codex.

**Exception Antigravity Gemini 3 :** lorsque le fournisseur routé est Google Antigravity (`google-antigravity`)
et que le modèle filaire est Gemini 3.x, opencodex attache `google_search` CCA (et `url_context` si le tour
contient des URL `http(s)`) sur la **même** requête principale au lieu de la boucle sidecar. Claude-on-CCA,
les backends explicites `openai` / `anthropic` / `xai` / `exa`, et Gemini < 3 avec des outils fonction Codex
restent sur le sidecar.

Chaque itération du modèle routé envoie `stream: true` en amont, mais, par défaut, opencodex met entièrement
en mémoire tampon les événements sémantiques avant de décider s'il faut lancer une recherche ou renvoyer la réponse finale.
Seuls les en-têtes et le statut du tour final, ainsi que les réponses 429 de la première itération, sont traités immédiatement. Ainsi,
Expand Down
16 changes: 15 additions & 1 deletion docs-site/src/content/docs/fr/reference/adapters.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,21 @@ Si Kiro s’arrête sans appeler l’outil d’achèvement, l’adaptateur effec
- Rejoue l’état de la conversation au moyen de blobs adressés par leur contenu, remappe les appels d’outils du serveur vers Codex, découvre les modèles Cursor disponibles en direct au moyen de l’appel RPC protobuf `GetUsableModels` et ne relance une opération qu’avant que la requête d’exécution ait été écrite sur le transport.
- Expose Cursor Router sous `cursor/auto`, ainsi que les entrées explicites `cursor/auto-cost`, `cursor/auto-balance` et `cursor/auto-intelligence`. Les niveaux explicites sont encodés dans `requested_model.parameters`, tandis que l’ancienne entrée `cursor/auto` conserve la valeur par défaut du compte ou de l’équipe.
- Envoie les niveaux ordinaires de `cursor/grok-4.5` avec les identifiants de protocole exacts issus de la découverte en direct de Cursor (`cursor-grok-4.5-low`, `-medium` ou `-high`). `cursor/grok-4.5-fast` reste sélectionnable, mais le modèle canonique `grok-4.5` est envoyé avec des paramètres distincts `effort` et `fast=true`.
- L’exécution locale native de commandes sur le système de fichiers, le shell ou le réseau par Cursor est refusée par défaut. Les intégrations explicites `mcpServers` et `desktopExecutor` disposent d’activations distinctes ; `nativeLocalExec: "on"` active l’exécuteur intégré plus large et contourne la sémantique d’approbation et de bac à sable de Codex. L’ancien réglage `unsafeAllowNativeLocalExec: true` reste équivalent uniquement lorsque `nativeLocalExec` n’est pas défini.
- L’exécution locale native de commandes sur le système de fichiers, le shell ou le réseau par Cursor est refusée par défaut. Les intégrations explicites `mcpServers` et `desktopExecutor` disposent d’activations distinctes ; `nativeLocalExec: "on"` active l’exécuteur intégré plus large et contourne la sémantique d’approbation et de bac à sable de Codex. L’ancien réglage `unsafeAllowNativeLocalExec: true` reste équivalent uniquement lorsque `nativeLocalExec` n’est pas défini. Avec la politique par défaut `off`, Shell/Read/Ls/Grep/Fetch natifs sont mappés vers `shell_command`/`exec_command` Codex lorsque cet outil pont est dans le catalogue ; write/delete restent refusés.

## `command-code`

**Cibles :** API agent d’abonnement Command Code **OAuth** (`POST {baseUrl}/alpha/generate`).
**Authentification :** Bearer OAuth via `ocx login command-code`.

- Distinct du préréglage à clé API `commandcode` (`openai-chat` → `POST {baseUrl}/provider/v1/chat/completions`). La route à clé API ne lit jamais `projectContext` ni ne remplit l’enveloppe generate depuis le disque.
- `projectContext: "on"` optionnel sur `providers.command-code` copie des fichiers bornés depuis `process.cwd()` au moment de la requête vers `memory`, `taste` et `skills`. Absent ou `"off"` envoie `memory: ""`, `taste: null`, `skills: null` même si ces fichiers existent dans le dépôt — opt-in uniquement, jamais de chargement automatique.
- Démarrez le proxy depuis le répertoire de projet Codex de confiance afin que le répertoire de travail corresponde au dépôt que Codex édite.
- **Mémoire :** UTF-8 de `AGENTS.md` à la racine du cwd uniquement (pas `CLAUDE.md`, `CODEX.md` ni chemins du répertoire personnel). Plafond 32 768 octets ; dépassement tronqué avec `<!-- truncated -->`.
- **Taste :** UTF-8 de `.commandcode/taste/taste.md`, ou `null` si absent. Plafond 8 192 octets avec le même marqueur. Un fichier présent mais vide envoie `""`. `x-taste-learning` reste `"false"` ; charger taste n’est pas l’apprentissage taste de Command Code.
- **Skills :** paquet XML depuis les racines de skills du projet, dans l’ordre : `.commandcode/skills`, `.agents/skills`, `.pi/skills`. Chaque sous-répertoire avec `SKILL.md` devient une entrée `<skill name="…">…</skill>` (nom depuis le frontmatter YAML `name:` ou le nom du répertoire). Ignore les noms commençant par `.` et les non-répertoires ; premier gagnant par nom résolu ; 16 skills max ; plafond XML total 32 768 octets. Ne lit jamais `~/.commandcode/skills` ni d’autres arborescences de skills du répertoire personnel.
- Le confinement de chemin utilise des vérifications realpath sous cwd ; les échappements par lien symbolique sont omis. Chaque opération fichier a un délai de 2 secondes. Résultats mis en cache par cwd pendant 30 secondes (128 entrées max). Toute défaillance omet cette partie en fail-soft.
- `commandCodeVersion` épingle `x-command-code-version` (défaut `0.52.1`). `permissionMode` reste `"standard"` et `mode` reste `"agent"`.

## `azure-openai` (alias : `azure`)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,8 @@ sauvegarde dont le contenu diffère, puis réécrit en identifiants sans préfix
| `desktopExecutor?` | `DesktopExecutorConfig` | Cursor uniquement : commandes externes d'utilisation d'un ordinateur et d'enregistrement de l'écran. |
| `unsafeAllowNativeLocalExec?` | `boolean` | Ancien booléen de Cursor, équivalent à `nativeLocalExec: "on"` uniquement lorsque le champ plus récent n'est pas défini. |
| `nativeLocalExec?` | `"off" \| "codex-sandbox" \| "on"` | Politique d'exécution locale de Cursor. `off` est la valeur par défaut ; actuellement, `codex-sandbox` échoue de manière sûre comme `off`. |
| `commandCodeVersion?` | `string` | Command Code OAuth (`adapter: "command-code"`) uniquement. Épingle l'en-tête `x-command-code-version` sur les requêtes `/alpha/generate`. Si absent, utilise la valeur par défaut de l'adaptateur (`0.52.1`). Non lu par le préréglage à clé API `commandcode` (`openai-chat` / `/provider/v1`). |
| `projectContext?` | `"off" \| "on"` | Command Code OAuth (`adapter: "command-code"`) uniquement. Lorsque `"on"`, copie des fichiers de projet bornés depuis le répertoire de travail du processus proxy vers l'enveloppe `/alpha/generate` `memory`, `taste` et `skills`. Absent ou `"off"` conserve l'enveloppe vide actuelle, même si ces fichiers existent sur le disque. Non lu par le préréglage à clé API `commandcode`. À définir sur `providers.command-code`, pas au niveau supérieur. Dans le tableau de bord, utilisez **Providers → Command Code → Edit JSON**. Démarrez le proxy depuis le répertoire de projet Codex de confiance afin que `process.cwd()` soit le dépôt visé. Fail-soft : fichier manquant, illisible, expiré ou hors du périmètre → cette partie est omise plutôt que de faire échouer le tour. Ne lit pas `~/.commandcode/skills` ni d'autres arborescences du répertoire personnel. `x-taste-learning` reste `"false"` quel que soit ce réglage. |

Les fournisseurs à clé API peuvent détenir une clé littérale ou une référence à une variable d'environnement. Les fournisseurs OAuth utilisent le
magasin d'identifiants alimenté par `ocx login` ; le comportement de lancement de Claude Code avec abonnement est
Expand Down Expand Up @@ -296,8 +298,8 @@ sur la liste curatée `noVisionModels` et passent par le sidecar de description
Les outils locaux pilotés par le serveur Cursor sont désactivés par défaut. Codex continue d'utiliser ses propres outils tels que
`apply_patch` et `exec_command` avec sa propre politique d'approbation et de bac à sable :

- `"off"` (par défaut) rejette l'exécution des outils Cursor natifs `read`, `write`, `delete`, `ls`, `grep`, `shell` et
`fetch`.
- `"off"` (par défaut) refuse l'exécution proxy-locale des outils Cursor natifs `read`, `write`, `delete`, `ls`, `grep`, `shell` et
`fetch`. Lorsque le tour annonce un outil Codex nu `shell_command` ou `exec_command`, Shell/Read/Ls/Grep/Fetch natifs sont mappés vers ce pont Codex au lieu de s'exécuter sur l'hôte proxy ; write/delete restent refusés.
- `"on"` active une exécution locale de confiance et contourne les règles d'approbation et de bac à sable de Codex.
- `"codex-sandbox"` est conservé pour compatibilité, mais échoue de manière sûre comme `"off"` ; le texte de la requête
ne constitue pas une attestation fiable d'exécution en bac à sable.
Expand Down
7 changes: 7 additions & 0 deletions docs-site/src/content/docs/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -401,6 +401,13 @@ account bearer; the Provider-API key preset (`commandcode`) uses the active conf
key. A user-edited lookalike base URL is never probed. Remaining monthly, purchased, and
free credits are shown as a USD window when Command Code also reports period spend.

**Command Code project context.** Optional `projectContext: "on"` on the OAuth `command-code` provider
only (not the API-key `commandcode` preset) fills `/alpha/generate` `memory`, `taste`, and `skills`
from the proxy working directory. Set it on `providers.command-code` via **Providers → Command Code →
Edit JSON**, start the proxy from the trusted Codex project, and restart after saving. Absent or
`"off"` keeps the empty envelope even when `AGENTS.md` or taste files exist. See
[Adapters](/reference/adapters/#command-code) for file paths, caps, and fail-soft behavior.

**SambaNova Cloud discovery.** The preset reads SambaNova Cloud's public `/v1/models` list from the fixed API
host, preserves provider-native ids, and caps discovery at 128 KiB and 128 raw rows. Because the
catalog is unauthenticated, the CLI login flow reports the key as unverifiable instead of treating
Expand Down
10 changes: 9 additions & 1 deletion docs-site/src/content/docs/guides/sidecars.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ a missing credential produces no sidecar plan and the request takes the normal r

## Web-search sidecar

When Codex requests hosted `web_search` for a non-passthrough routed model, opencodex:
When Codex requests hosted `web_search` for a non-passthrough routed model, opencodex normally:

1. **Drops** the hosted `web_search` tool and exposes a synthetic `web_search(query)` function tool
to the routed model instead. The original hosted-tool options are retained for the sidecar call.
Expand All @@ -45,6 +45,14 @@ When Codex requests hosted `web_search` for a non-passthrough routed model, open
(default 3), then removes the search tool and forces a final answer. Real client tools such as
`apply_patch` or shell finalize the turn so those calls reach Codex.

**Antigravity Gemini 3 exception:** when the routed provider is Google Antigravity (`google-antigravity`)
and the wire model is Gemini 3.x, opencodex attaches CCA `google_search` (and `url_context` when the
turn includes `http(s)` URLs) on the **same** main routed request instead of the synthetic sidecar loop.
Grounding citations are appended to the streamed answer. The sidecar remains the path for Claude-on-CCA,
explicit `webSearchSidecar.backend` overrides (`openai`, `anthropic`, `xai`, `exa`), and
Gemini models below 3.x when Codex function tools are also present. An explicit `gemini` backend
does not disable in-turn grounding when the route itself is Antigravity Gemini 3.

Every routed-model iteration requests upstream `stream: true`, but by default opencodex fully
buffers semantic events internally before deciding whether to search or return the final answer.
Only the first iteration's final headers/status and 429 key rotations are acquired eagerly. Thus
Expand Down
2 changes: 2 additions & 0 deletions docs-site/src/content/docs/ja/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -277,6 +277,8 @@ discovery エンドポイントから取得します。チャットリクエス

**Command Code の quota:** ダッシュボードと `ocx account refresh` は、正規ホスト `https://api.commandcode.ai` 上の `/alpha/billing/credits` ウィンドウ(5時間と週次)を照会します。OAuth プリセット (`command-code`) は保存済みアカウント bearer を使い、Provider-API キープリセット (`commandcode`) は設定済みの有効キーを使います。ユーザーが編集した類似ホストは照会しません。期間支出が返る場合は、残りの monthly / purchased / free credits を USD ウィンドウとして表示します。

**Command Code プロジェクトコンテキスト。** OAuth `command-code` プロバイダーのみ(API キー `commandcode` プリセットではない)で、任意の `projectContext: "on"` がプロキシ作業ディレクトリから `/alpha/generate` の `memory` / `taste` / `skills` を埋めます。**Providers → Command Code → Edit JSON** で `providers.command-code` に設定し、信頼できる Codex プロジェクトからプロキシを起動して保存後に再起動してください。未設定または `"off"` のときは `AGENTS.md` や taste ファイルがあっても空のエンベロープのままです。ファイルパス、上限、fail-soft の挙動は [Adapters](/ja/reference/adapters/#command-code) を参照してください。

**SambaNova Cloud の discovery:** preset は固定 API ホスト上の SambaNova Cloud の公開 `/v1/models` 一覧を読み、
プロバイダー固有の ID を保持し、discovery を 128 KiB と raw 128 行に制限します。カタログは認証不要のため、
CLI の login flow は公開レスポンスをキーの有効性の証拠にせず、キーを検証不能として報告します。chat リクエストは
Expand Down
6 changes: 6 additions & 0 deletions docs-site/src/content/docs/ja/guides/sidecars.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,12 @@ Codex がパススルーでないルーティングモデルにホスト型 `web
**反復**します。限度に達すると検索ツールを削除し最終回答を強制します。`apply_patch` や shell
のような実際のクライアントツールが出たらターンを終了し該当呼び出しが Codex に渡るようにします。

**Antigravity Gemini 3 の例外:** ルーティング先が Google Antigravity (`google-antigravity`) で
ワイヤモデルが Gemini 3.x のとき、opencodex は合成サイドカーループの代わりに、同じメインリクエストへ
CCA `google_search`(ターンに `http(s)` URL があれば `url_context`)を付けます。Claude-on-CCA、
明示的な `openai` / `anthropic` / `xai` / `exa` バックエンド、および Codex 関数ツール付きの
Gemini 3 未満は従来のサイドカーのままです。

ルーティングモデルのすべての反復は上流に `stream: true` を要求しますが、opencodex は検索可否や最終
回答を決める前に意味のある event を内部ですべてバッファリングします。最初の反復の最終
header/status と 429 キーローテーションのみ先行取得します。したがって合成検索呼び出しと中間出力はクライアントに
Expand Down
Loading
Loading