Skip to content

Commit b9c87c6

Browse files
committed
fix(providers): enforce encrypted V2 final wire
1 parent 2b10dcf commit b9c87c6

33 files changed

Lines changed: 205 additions & 82 deletions

File tree

‎docs-site/src/content/docs/fr/guides/sub-agent-surface.md‎

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -116,29 +116,27 @@ pendant un temps de recharge, il manque un compte Codex poolé utilisable ou au-
116116
Les sondes de disponibilité sont mises en cache pendant `subagentModelFallbackPollMs` (60 secondes par défaut).
117117

118118
La solution de secours ne rend pas lisibles les tâches chiffrées incompatibles. Lorsque la tâche enfant est chiffrée pour
119-
ChatGPT, la sélection est restreinte aux cibles ChatGPT natives canoniques ou aux fournisseurs Responses avec
120-
`allowEncryptedV2AgentTasks: true`.
119+
ChatGPT, la sélection est restreinte aux cibles ChatGPT natives canoniques même si un modèle externe
120+
apparaît plus tôt dans la chaîne.
121121

122122
## Livraison de tâches v2 cryptées
123123

124-
Codex peut envoyer une tâche enfant v2 native vers routé uniquement sous forme `encrypted_content` chiffrée par le backend. Le
125-
backend ChatGPT natif peut la traiter et certains relais compatibles peuvent la transmettre à un backend capable de la traiter ; OpenCodex ne peut pas déduire cette capacité du nom ou de l’URL de base. C'est la
124+
Codex peut envoyer une tâche enfant v2 native vers routé uniquement sous forme `encrypted_content` chiffrée par le backend. Cette
125+
charge utile peut être lue par le backend natif ChatGPT, mais pas par un fournisseur externe. C'est la
126126
limitation connue [#92](https://github.com/lidge-jun/opencodex/issues/92).
127127

128128
opencodex échoue en toute sécurité au lieu de transférer une tâche vide ou illisible :
129129

130-
- Une route directe non native non approuvée renvoie HTTP 400 avec
130+
- Une route directe non native renvoie HTTP 400 avec
131131
`error.code = "unreadable_encrypted_agent_task"` et ne fait pas écho au texte chiffré.
132-
- Un combo considère uniquement les cibles ChatGPT natives canoniques et les cibles Responses explicitement approuvées pour cette tâche, y compris les tentatives. Si aucun
132+
- Un combo considère uniquement les cibles ChatGPT natives canoniques pour cette tâche, y compris les tentatives. Si aucun
133133
est disponible, il renvoie la même erreur 400.
134134
- Une tâche lisible en texte clair conserve la route normale et le comportement de repli.
135135

136136
Les options de récupération consistent à sélectionner un enfant ChatGPT natif, à ajouter une cible ChatGPT native au combo, à utiliser
137137
v1 pour la délégation de fournisseurs hétérogènes, ou renvoyer la tâche en texte brut v2 `agent_message`
138138
contenu lorsque vous contrôlez l’appelant.
139139

140-
Après avoir vérifié qu’un endpoint Responses non canonique accepte ce ciphertext, activez **Transmettre les tâches d’agent V2 chiffrées** dans ses paramètres ou définissez `allowEncryptedV2AgentTasks: true`. L’option est désactivée par défaut, exige `adapter: "openai-responses"`, transmet la tâche opaque sans modification et ne prouve ni compatibilité ni capacité de déchiffrement. Cette route ignore alors `agentTaskRecovery`.
141-
142140
L’option expérimentale `agentTaskRecovery`, désactivée par défaut, peut récupérer cette forme précise de
143141
tâche native envoyée vers une route externe. Elle utilise un transfert Responses brut vers le point de
144142
terminaison ChatGPT `/responses` fixe et la forme d’identification entrante du fournisseur canonique
@@ -156,7 +154,8 @@ récupéré, la fidélité octet par octet n’est pas garantie. Les appelants g
156154
sont rejetés, et tout échec conserve l’erreur `unreadable_encrypted_agent_task`. Consultez
157155
[Configuration de l'agent : récupération de tâche chiffrée v2](/fr/reference/configuration/agents/#récupération-des-tâches-v2-chiffrées)
158156
pour la limite de confiance complète et la configuration.
159-
Le routage des combinaisons applique la même règle et considère les cibles ChatGPT natives canoniques ainsi que les cibles Responses explicitement approuvées.
157+
Le routage des combinaisons reste inchangé et continue de considérer uniquement les cibles ChatGPT natives
158+
canoniques pour les tâches chiffrées.
160159

161160
## Changer le mode
162161

‎docs-site/src/content/docs/fr/reference/configuration/providers.md‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,6 @@ sauvegarde dont le contenu diffère, puis réécrit en identifiants sans préfix
7272
| `modelSupportsServiceTier?` | `Record<string, boolean>` | Remplacements de capacité par identifiant exact de modèle en amont. La valeur exacte `true` autorise ce modèle Chat même sans `chatServiceTier` ; `false` restreint les valeurs globales et l’autorisation Chat. Une valeur globale explicite `supportsServiceTier: false` reste fermée et ne peut pas être réactivée. Les modèles non déclarés suivent le comportement global. La requête de gestion `PATCH /api/providers` fusionne les entrées et accepte `null` pour en supprimer une. |
7373
| `chatServiceTier?` | `boolean` | Active globalement la sérialisation de `service_tier` sur `/chat/completions`. Des modèles exacts peuvent aussi l’activer avec `modelSupportsServiceTier` ; les modèles non déclarés restent bloqués lorsque ce champ est absent ou faux. |
7474
| `preserveResponsesReasoningContent?` | `boolean` | Conserve le contenu de raisonnement en texte brut dans les éléments de raisonnement Responses relus, au lieu de l'effacer comme l'exige le moteur ChatGPT. Activez cette option pour les services en amont dont le contrat accepte la relecture du raisonnement, comme DeepSeek. Les enveloppes `ocxr1` créées par le proxy sont toujours supprimées. |
75-
| `allowEncryptedV2AgentTasks?` | `boolean` | Désactivé par défaut. Fait confiance à ce fournisseur `openai-responses` non canonique pour traiter les tâches de sous-agent V2 chiffrées et opaques. Une fois activé, opencodex transmet `encrypted_content` sans modification et ignore la récupération en texte brut pour cette route. Cette option ne prouve pas la compatibilité ni la capacité de déchiffrement ; ne l’activez qu’après vérification du service en amont. Le transfert ChatGPT canonique n’en a pas besoin. |
7675
| `disabled?` | `boolean` | Conserve le fournisseur sur le disque, mais l'exclut du routage et des listes de modèles et de catalogues. |
7776
| `apiKey?` | `string` | Clé API, ou référence `${ENV_VAR}` / `$ENV_VAR` résolue au moment de la requête. |
7877
| `apiKeyTransport?` | `"x-api-key" \| "bearer"` | Style de l'en-tête de clé Anthropic. La valeur par défaut est l'en-tête natif `x-api-key` ; ce champ n'est valable que pour les fournisseurs `anthropic` authentifiés par clé. |

‎docs-site/src/content/docs/fr/reference/proxy-formats.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -294,7 +294,7 @@ Les erreurs utilisent l'enveloppe du dialecte client lorsque cela est nécessair
294294
| 401 | `authentication_error` | Un identifiant requis pour l’admission au proxy est manquant ou invalide |
295295
| 403 | `origin_rejected` | Une demande de plan de données Réponses/OpenAI ou une mise à niveau WebSocket provient d'une origine non autorisée |
296296
| 503 | `combo_unavailable` | Chaque cible du combo sélectionné est indisponible, en temps de recharge, désactivée ou autrement inéligible |
297-
| 400 | `unreadable_encrypted_agent_task` | Une tâche de travail v2 chiffrée n'a pas de cible ChatGPT canonique ni de cible Responses explicitement approuvée pouvant la traiter |
297+
| 400 | `unreadable_encrypted_agent_task` | Une tâche de travail v2 chiffrée n'a pas de cible native éligible pouvant la consommer |
298298
| 426 | `upgrade_required` | Le transport Réponses WebSocket est désactivé ou la mise à niveau a échoué ; utiliser HTTP |
299299

300300
Les échecs d'origine Anthropic sont restitués dans l'enveloppe d'erreur de Anthropic, donc le rejet d'origine est un

‎docs-site/src/content/docs/guides/sub-agent-surface.md‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -137,12 +137,13 @@ Recovery options are to select a native ChatGPT child, add a native ChatGPT targ
137137
v1 for heterogeneous-provider delegation, or resend the task as plaintext v2 `agent_message`
138138
content when you control the caller.
139139

140-
If a non-canonical Responses endpoint has been verified to consume this ciphertext, enable
140+
If a non-canonical Responses endpoint has been verified to consume or relay this ciphertext, enable
141141
**Providers → Settings → Pass through encrypted V2 agent tasks** for that provider, or set
142142
`allowEncryptedV2AgentTasks: true` in its provider config. The option is disabled by default and is
143-
valid only with `adapter: "openai-responses"`. It passes the opaque task through unchanged; it does
144-
not decrypt it, recover plaintext, or prove provider compatibility. The canonical ChatGPT forward
145-
provider is always eligible and needs no flag. A provider opted into passthrough skips
143+
valid only when the selected model's final wire is `openai-responses`; a `modelAdapters` override to
144+
`openai-chat` remains ineligible. It passes the opaque task through unchanged; it does not decrypt,
145+
translate, or recover plaintext, and it does not prove provider compatibility. The canonical ChatGPT
146+
forward provider is always eligible and needs no flag. A provider opted into passthrough skips
146147
`agentTaskRecovery` for that route because recovery and opaque forwarding are separate trust modes.
147148

148149
An experimental, disabled-by-default `agentTaskRecovery` option can recover this specific native-

‎docs-site/src/content/docs/ja/guides/sub-agent-surface.md‎

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -72,24 +72,22 @@ v1 では、opencodex は、`max` または `ultra` の取り組みでアップ
7272

7373
重複するモデル ID は、最初に出現したモデル ID を保持しながら削除されます。選択中、opencodex は、無効になっている、ルーティングできない、無効なプロバイダーによってサポートされている、異常とマークされている、クールダウン中、使用可能なプールされた Codex アカウントがない、または設定されたクォータしきい値を超えている候補をスキップします。可用性プローブは `subagentModelFallbackPollMs` に対してキャッシュされます (デフォルトでは 60 秒)。
7474

75-
フォールバックでは、互換性のない暗号化タスクは読み取り可能になりません。子タスクが ChatGPT 用に暗号化されている場合、選択は正規のネイティブ ChatGPT ターゲット、または `allowEncryptedV2AgentTasks: true` が明示された Responses プロバイダーに制限されます。
75+
フォールバックでは、互換性のない暗号化タスクは読み取り可能になりません。子タスクが ChatGPT 用に暗号化されている場合、外部モデルがチェーンの前の方に表示されている場合でも、選択は正規のネイティブ ChatGPT ターゲットに制限されます。
7676

7777
## 暗号化された v2 タスク配信
7878

79-
Codex は、v2 ネイティブからルーティングされた子タスクを、バックエンドで暗号化された `encrypted_content` としてのみ送信できます。ネイティブ ChatGPT バックエンドは処理でき、一部の互換リレーも処理可能なバックエンドへ転送できますが、OpenCodex は名前や Base URL からこの能力を推測できません。これは既知の [#92限定](https://github.com/lidge-jun/opencodex/issues/92) です。
79+
Codex は、v2 ネイティブからルーティングされた子タスクを、バックエンドで暗号化された `encrypted_content` としてのみ送信できます。そのペイロードは、ネイティブ ChatGPT バックエンドによって読み取ることができますが、外部プロバイダーによっては読み取ることができません。これは既知の [#92限定](https://github.com/lidge-jun/opencodex/issues/92) です。
8080

8181
opencodex は、空のタスクまたは読み取り不可能なタスクを転送するのではなく、安全に失敗します。
8282

83-
- 明示的に信頼されていない直接の非ネイティブ ルートは HTTP 400 を返します。
83+
- 直接の非ネイティブ ルートは HTTP 400 を返します。
8484
`error.code = "unreadable_encrypted_agent_task"` であり、暗号文はエコーされません。
85-
- コンボでは、再試行を含む、そのタスクの正規のネイティブ ChatGPT ターゲットと明示的に信頼された Responses ターゲットのみが考慮されます。何もない場合
85+
- コンボでは、再試行を含む、そのタスクの正規のネイティブ ChatGPT ターゲットのみが考慮されます。何もない場合
8686
が利用可能な場合は、同じ 400 エラーが返されます。
8787
- 読み取り可能なプレーンテキストのタスクは、通常のルートとフォールバック動作を維持します。
8888

8989
回復オプションは、ネイティブ ChatGPT 子の選択、コンボへのネイティブ ChatGPT ターゲットの追加、異種プロバイダーの委任に v1 を使用する、または呼び出し元を制御するときにタスクをプレーンテキスト v2 `agent_message` コンテンツとして再送信することです。
9090

91-
非標準 Responses エンドポイントがこの暗号文を処理できると確認した場合、プロバイダー設定で **暗号化された V2 エージェントタスクを転送** を有効にするか、`allowEncryptedV2AgentTasks: true` を設定します。既定では無効で、`adapter: "openai-responses"` でのみ有効です。不透明なタスクを変更せずに転送するだけで、復号、平文復元、互換性の証明は行わず、このルートでは `agentTaskRecovery` をスキップします。
92-
9391
実験的な `agentTaskRecovery` はデフォルトで無効です。明示的に有効にすると、固定された ChatGPT エンドポイントへの追加の認証済みリクエストでこの形式を回復できますが、クォータと待ち時間が増え、非公開のバックエンド動作に依存します。失敗時は従来の `unreadable_encrypted_agent_task` を維持します。詳細は[英語版の設定リファレンス](/reference/configuration/agents/#encrypted-v2-task-recovery)を参照してください。
9492

9593
## モードを変更する

‎docs-site/src/content/docs/ja/reference/configuration/providers.md‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,6 @@ account を削除しても mapping は保持され、同じ id を再追加す
6060
| `responsesPath?` | `string` |キー認証 `openai-responses` リクエストの相対リソース パス。 `/` で始まり、スキーム、クエリ、またはフラグメントが含まれていない必要があります。 |
6161
| `supportsServiceTier?` | `boolean` | `service_tier` ケイパビリティの 3 状態です。`true`: fast モードが注入でき、呼び出し元の値も保持されます。`false`: フィールドは削除され、注入もされません (非対応と文書化されたアップストリームには送りません)。未設定: 未分類 — 呼び出し元の値はそのまま保持され、fast モードは注入しません。レジストリは正規 OpenAI (`true`)、DeepSeek、Volcengine Ark (`false`) を分類します。実際にティアをサポートするカスタム ゲートウェイにのみ明示的に設定してください。 |
6262
| `preserveResponsesReasoningContent?` | `boolean` | リプレイされる Responses reasoning アイテムの平文 reasoning コンテンツを消去せずに保持します (消去は ChatGPT バックエンドのルールです)。DeepSeek のように reasoning リプレイを受け入れるアップストリームで有効にしてください。プロキシ生成の `ocxr1` エンベロープは常に削除されます。 |
63-
| `allowEncryptedV2AgentTasks?` | `boolean` | 既定では無効です。この非標準 `openai-responses` プロバイダーが不透明な暗号化 V2 サブエージェントタスクを処理できるものとして信頼します。有効にすると `encrypted_content` を変更せずに転送し、このルートの平文復元をスキップします。互換性や復号能力を保証するものではないため、アップストリームを検証してから有効にしてください。標準 ChatGPT 転送では不要です。 |
6463
| `disabled?` | `boolean` |プロバイダーをディスク上に保持しますが、ルーティングおよびモデル/カタログのリストからは除外します。 |
6564
| `apiKey?` | `string` | API キー、またはリクエスト時に解決される `${ENV_VAR}` / `$ENV_VAR` 参照。 |
6665
| `apiKeyTransport?` | `"x-api-key" \| "bearer"` | Anthropic キーのヘッダー スタイル。デフォルトはネイティブ `x-api-key` です。キー認証 `anthropic` プロバイダーにのみ有効です。 |

‎docs-site/src/content/docs/ja/reference/proxy-formats.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -209,7 +209,7 @@ Responses-family および Chat リクエストは、プロバイダーまたは
209209
| 401 | `authentication_error` |必要なプロキシ アドミッション資格情報が見つからないか無効です。
210210
| 403 | `origin_rejected` | Responses/OpenAI データプレーン リクエストまたは WebSocket アップグレードが、許可されていないオリジンから送信されました。
211211
| 503 | `combo_unavailable` |選択したコンボ内のすべてのターゲットは使用不可、クールダウン中、無効、またはその他の理由で不適格です。
212-
| 400 | `unreadable_encrypted_agent_task` | 暗号化された v2 ワーカータスクを処理できる正規 ChatGPT ターゲットまたは明示的に信頼された Responses ターゲットがありません。 |
212+
| 400 | `unreadable_encrypted_agent_task` |暗号化された v2 ワーカー タスクには、それを使用できる適格なネイティブ ChatGPT ターゲットがありません。
213213
| 426 | `upgrade_required` |応答 WebSocket トランスポートが無効になっているか、アップグレードが失敗しました。 HTTP を使用する |
214214

215215
Anthropic オリジンの失敗は Anthropic のエラー エンベロープでレンダリングされるため、オリジンの拒否は OpenAI スタイルの `origin_rejected` 本体ではなく、その方言上の 403 `permission_error` になります。

0 commit comments

Comments
 (0)