You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit b2c2054
Browse filesBrowse the repository at this point in the historyBrowse files
fix(web-search): close xai executor review blockers
Attach abort-driven body cancellation immediately after the xAI fetch, cancel oversized SSE readers upstream, and cover transport release.
Stage and validate complete web-search management candidates before commit; reject malformed xSearch types without partial mutation or broadened searches.
Document the live Grok OAuth/x_search backend across canonical docs, locales, type comments, and structure sources. Evidence: 47 focused tests pass; bun x tsc --noEmit; docs Astro build 393 pages.
Copy file name to clipboardExpand all lines: docs-site/src/content/docs/fr/guides/sidecars.md
+6-5Lines changed: 6 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,13 +5,13 @@ description: Dotez les modèles routés d’une véritable recherche web et donn
5
5
6
6
Tous les modèles routés ne proposent pas une **recherche web** hébergée ni une **entrée d’image** native. opencodex complète
7
7
ces capacités au moyen de deux services auxiliaires. Chacun peut s’appuyer sur un fournisseur connecté à ChatGPT (`forward`) ou sur un
8
-
fournisseur Anthropic OAuth enregistré. Les erreurs des services auxiliaires sont converties en résultats d’outil limités ou en marqueurs d’image,
8
+
fournisseur Anthropic OAuth enregistré ; la recherche web peut aussi utiliser un OAuth Grok enregistré via le moteur `xai` explicite. Les erreurs des services auxiliaires sont converties en résultats d’outil limités ou en marqueurs d’image,
9
9
au lieu de faire échouer l’intégralité du tour.
10
10
11
11
:::note[Sélection automatique du moteur]
12
-
Une valeur `backend` explicite est prioritaire. Lorsqu'elle est omise, opencodex utilise `anthropic` si un fournisseur OAuth Anthropic actif
13
-
possède un compte actif qui n'est pas marqué `needsReauth` ; sinon, il utilise`openai`. Une sélection explicite de
14
-
`anthropic`sans ces identifiants échoue de manière sûre. `openai` exige à la fois une connexion ChatGPT et un
12
+
Une valeur `backend` explicite est prioritaire. Sans valeur, la recherche web utilise toujours `openai` ; Vision utilise
13
+
`anthropic` si un compte OAuth Anthropic utilisable existe, sinon`openai`. Une sélection explicite de
14
+
`anthropic`ou `xai` sans identifiants utilisables échoue sans repli. `openai` exige à la fois une connexion ChatGPT et un
15
15
fournisseur `forward` actif.
16
16
:::
17
17
@@ -24,7 +24,8 @@ Lorsque Codex demande un hébergement `web_search` pour un modèle routé sans p
24
24
2. Exécute le modèle routé dans une petite **boucle d'agent**. Lorsqu'il appelle `web_search`, opencodex utilise le
25
25
moteur du service auxiliaire sélectionné : OpenAI exécute l'outil hébergé `web_search` avec `gpt-5.6-luna` par défaut ;
26
26
Anthropic exécute `web_search_20250305` avec `claude-sonnet-5` par défaut. La réponse en streaming et
27
-
les citations deviennent le résultat d’un outil.
27
+
les citations deviennent le résultat d’un outil. xAI exécute `web_search` avec `grok-4.6` par défaut et ajoute
28
+
`x_search` à la même requête lorsque `xSearch.enabled` vaut true.
28
29
3.**Répète la boucle** jusqu'à ce que le modèle réponde ou que le nombre total de recherches réelles atteigne `maxSearchesPerTurn`
29
30
(par défaut 3), supprime ensuite l'outil de recherche et force une réponse finale. De vrais outils clients tels que
30
31
`apply_patch` ou le shell mettent fin au tour afin que ces appels parviennent à Codex.
Copy file name to clipboardExpand all lines: docs-site/src/content/docs/fr/reference/configuration/server.md
+3-2Lines changed: 3 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -209,8 +209,9 @@ l'API Images d'OpenAI et la forme de réponse attendue par Codex.
209
209
| Champ | Type | Par défaut | Signification |
210
210
| --- | --- | --- | --- |
211
211
|`enabled?`|`boolean`| activé lorsqu'il est utilisable | Interrupteur principal. |
212
-
|`backend?`|`"openai" \| "anthropic"`| automatique | Une valeur explicite est prioritaire ; sinon, la présence d'identifiants OAuth Anthropic stockés et utilisables sélectionne `anthropic`, puis `openai`. |
213
-
|`model?`|`string`| dépendant du backend |`gpt-5.6-luna` pour OpenAI ou `claude-sonnet-5` pour Anthropic. L'héritage explicite `gpt-5.4-mini` migre au démarrage. |
212
+
|`backend?`|`"openai" \| "anthropic" \| "xai" \| "gemini" \| "exa"`|`openai`| Une valeur explicite est prioritaire ; l'absence de valeur sélectionne toujours `openai`. `anthropic` et `xai` ne s'exécutent que s'ils sont configurés explicitement ; `gemini` et `exa` restent réservés jusqu'à la livraison de leur executor. |
213
+
|`model?`|`string`| dépendant du backend |`gpt-5.6-luna` pour OpenAI, `claude-sonnet-5` pour Anthropic ou `grok-4.6` pour xAI. L'héritage explicite `gpt-5.4-mini` migre au démarrage. |
214
+
|`xSearch?`|`object`| omis | Activation facultative de `x_search` hébergé, propre à xAI : `enabled`, tableaux mutuellement exclusifs `allowedXHandles` / `excludedXHandles` (20 au maximum), et dates ISO `fromDate` / `toDate` (`YYYY-MM-DD`). |
214
215
|`reasoning?`|`string`|`low`| Effort secondaire. `minimal` est rejeté lors de la recherche sur le Web. |
215
216
|`maxSearchesPerTurn?`|`number`|`3`| Recherches réelles autorisées par tour de modèle principal. |
216
217
|`routedModelStallTimeoutMs?`|`number`|`200000`| Date limite d'inactivité du corps brut du modèle routé uniquement pour les fichiers de configuration. Entier 1–2147483647 ; chaque morceau non vide le réinitialise. |
Copy file name to clipboardExpand all lines: docs-site/src/content/docs/reference/configuration/server.md
+6-3Lines changed: 6 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -205,8 +205,9 @@ Images API paths and response shape expected by Codex.
205
205
| Field | Type | Default | Meaning |
206
206
| --- | --- | --- | --- |
207
207
|`enabled?`|`boolean`| on when usable | Master switch. |
208
-
|`backend?`|`"openai" \| "anthropic"`|`openai`| Explicit wins; unset always resolves to `openai`. `anthropic` runs only when explicitly configured. |
209
-
|`model?`|`string`| backend-dependent |`gpt-5.6-luna` for OpenAI or `claude-sonnet-5` for Anthropic. Legacy explicit `gpt-5.4-mini` migrates on start. |
208
+
|`backend?`|`"openai" \| "anthropic" \| "xai" \| "gemini" \| "exa"`|`openai`| Explicit wins; unset always resolves to `openai`. `anthropic` and `xai` run only when explicitly configured; `gemini` and `exa` remain reserved until their executors ship. |
209
+
|`model?`|`string`| backend-dependent |`gpt-5.6-luna` for OpenAI, `claude-sonnet-5` for Anthropic, or `grok-4.6` for xAI. Legacy explicit `gpt-5.4-mini` migrates on start. |
210
+
|`xSearch?`|`object`| omitted | xAI-only opt-in for hosted `x_search`: `enabled`, mutually exclusive `allowedXHandles` / `excludedXHandles` arrays (maximum 20), and ISO `fromDate` / `toDate` (`YYYY-MM-DD`). |
210
211
|`reasoning?`|`string`|`low`| Sidecar effort. `minimal` is rejected with web search. |
211
212
|`maxSearchesPerTurn?`|`number`|`3`| Real searches allowed per main-model turn. |
212
213
|`routedModelStallTimeoutMs?`|`number`|`200000`| Config-file-only routed-model raw-body inactivity deadline. Integer 1–2147483647; every non-empty chunk resets it. |
@@ -216,7 +217,9 @@ The OpenAI backend requires a ChatGPT login and enabled ChatGPT `forward` provid
216
217
routed replays inject main ChatGPT auth into the internal request. The Anthropic backend uses the
217
218
active stored credential from an enabled Anthropic OAuth provider. An explicitly selected Anthropic
218
219
backend with no usable account fails closed instead of falling back. The Anthropic executor uses its
219
-
native `web_search_20250305` tool.
220
+
native `web_search_20250305` tool. The xAI backend requires a usable stored Grok OAuth account, uses
221
+
hosted `web_search`, and adds hosted `x_search` when `xSearch.enabled` is true. Malformed `xSearch`
222
+
management input returns `400`; a malformed persisted block fails closed during planning.
220
223
221
224
Four clocks govern search: base `stallTimeoutSec`, `connectTimeoutMs`, routed-model inactivity, and
222
225
hosted-search timeout. The effective bridge watchdog is the maximum plus 30 seconds. Routed stall is
0 commit comments