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 b29edeb
Browse filesBrowse the repository at this point in the historyBrowse files
* feat(web-search): xai executor with opt-in x_search (lidge-jun#2188 L7)
runXaiWebSearch POSTs the pinned api.x.ai Responses endpoint with the
stored Grok OAuth credential, hosted web_search (+ opt-in x_search with
doc-validated handle/date limits), and reduces the SSE stream to
text + deduped sources from url_citation annotations unioned with
web_search_call action.sources. custom_tool_call items and skeleton
action are tolerated per live captures. planWebSearch's xai arm goes
live fail-closed; the loop dispatches it without touching forward
headers; the registry activates the backend on OAuth presence; PUT
validates the xSearch block before persisting.
* fix(web-search): pin the xai origin exactly, fail the loop arm closed, round-trip xSearch
Origin pinning by prefix admitted https://api.x.ai.evil — parse and
compare url.origin, falling back to the canonical endpoint (Critical).
A missing xaiSidecar on the xai loop arm now yields an error outcome
instead of falling through to the forward-header OpenAI executor
(High). GET and the PUT response now carry the persisted xSearch block
so a dashboard reload cannot lose visible configuration (High). Tests:
lookalike-origin bearer containment, xSearch 400/round-trip/clear.
* test(web-search): loop-level regression for the xai fail-closed arm
* 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.
* fix(web-search): reject unknown xSearch fields
* fix(web-search): unify WebSearchBackend with the five-value union after rebase
Cross-layer reconciliation: lidge-jun#2209 introduced the (backend, model) pair contract typed as openai|anthropic; lidge-jun#2238 widened the configured union to five backends. The options module now re-exports WebSearchBackendId and passes config into isActive, so inert arms simply never produce rows. tsc clean; 48/0 across the three web-search suites.
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
+9-3Lines changed: 9 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -209,8 +209,10 @@ 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" \| "xai" \| "gemini" \| "exa"`|`openai`| Une valeur explicite est prioritaire ; sans valeur, `openai` est toujours utilisé. `xai`, `gemini` et `exa` ne s'activent que s'ils sont configurés explicitement. |
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
+
|`exaApiKey?`|`string`| aucun | Clé opérateur pour le backend `exa`. Écriture seule : les lectures de gestion ne renvoient jamais la valeur stockée. |
215
+
|`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
216
|`reasoning?`|`string`|`low`| Effort secondaire. `minimal` est rejeté lors de la recherche sur le Web. |
215
217
|`maxSearchesPerTurn?`|`number`|`3`| Recherches réelles autorisées par tour de modèle principal. |
216
218
|`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. |
@@ -220,7 +222,11 @@ Le moteur OpenAI nécessite une connexion à ChatGPT et un fournisseur ChatGPT `
220
222
entrantes depuis Claude injectent l'authentification ChatGPT principale dans la requête interne. Le moteur Anthropic utilise les
221
223
identifiants actifs stockés auprès d'un fournisseur Anthropic OAuth activé. Si le moteur Anthropic est sélectionné explicitement
222
224
mais qu'aucun compte n'est utilisable, l'opération échoue de manière sûre au lieu de se rabattre sur un autre moteur. L'exécuteur Anthropic utilise son
223
-
outil `web_search_20250305` natif.
225
+
outil `web_search_20250305` natif. Le backend xAI nécessite un compte OAuth Grok stocké et utilisable, emploie
226
+
`web_search` hébergé et ajoute `x_search` hébergé lorsque `xSearch.enabled` vaut true. Une entrée de gestion
227
+
`xSearch` mal formée renvoie `400` ; un bloc persistant mal formé échoue de manière sûre pendant la planification.
228
+
Les voies `gemini` et `exa` ne s'activent jamais par découverte d'identifiants ni par fallback ; l'opérateur doit
229
+
les sélectionner explicitement. `exaApiKey` est accepté en écriture mais omis des réponses de gestion.
224
230
225
231
Quatre horloges régissent la recherche : base `stallTimeoutSec`, `connectTimeoutMs`, inactivité du modèle routé et
226
232
délai d'expiration de la recherche hébergée. Le chien de garde efficace du pont est le maximum plus 30 secondes. Le décrochage routé est
0 commit comments