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 82311ba
Browse filesBrowse the repository at this point in the historyBrowse files
docs(test): reflect comment-line keep-alive and responses backend
Keep-alives are now SSE comment lines (': opencodex heartbeat') instead of
response.heartbeat events, so the bridge-lifecycle RC3 test and the transport
architecture docs no longer describe a parser-ignored response.heartbeat event.
The grok-build guides' api_backend examples were still chat_completions; they
now match the Responses backend the proxy emits.
base_url = "http://192.168.1.10:10100/v1"# the reachable host, not 127.0.0.1
118
-
api_backend = "chat_completions"
118
+
api_backend = "responses"
119
119
api_key = "your-OPENCODEX_API_AUTH_TOKEN"
120
120
```
121
121
@@ -129,11 +129,6 @@ l'identifiant `grok-4.5`. Les alias générés évitent entièrement les points
129
129
130
130
## Limitations connues
131
131
132
-
-**Réponses backend et keep-alives:** opencodex émet un `response.heartbeat` keep-alive
133
-
dans les flux `/v1/responses` pendant les périodes de silence en amont. Le décodeur Responses de Grok Build
134
-
rejette les types d'événements inconnus, donc un modèle `api_backend = "responses"` configuré manuellement
135
-
peut échouer à mi-tour sur des amonts lents. Le code PIN des entrées enregistrées automatiquement
136
-
`api_backend = "chat_completions"`, qui ne fait jamais apparaître les images de battements de cœur bruts.
137
132
-**Installé par le service `ocx restart` :** le proxy en cours d'exécution possède l'autorisation de redémarrage et la vidange
138
133
coordination, tandis que le gestionnaire de service installé lance le remplacement après l'ancien processus
139
134
sorties. La supervision du service reste installée. Lors de l'enregistrement automatique en boucle, le bloc géré
Le pont émet également un **signal de maintien en vie** (RC3) : lorsque le service en amont reste silencieux, il envoie toutes les 2 secondes un événement SSE `response.heartbeat`, ignoré par l’analyseur, afin de réarmer la minuterie d’inactivité de Codex. Le **délai maximal de blocage** est de 300 secondes par défaut (`stallTimeoutSec`). Une fois ce délai atteint, le service en amont est interrompu et `response.incomplete` est émis avec le motif `upstream_stall_timeout`, ce qui empêche une connexion bloquée d’immobiliser Codex indéfiniment.
76
+
Le pont émet également un **signal de maintien en vie** (RC3) : lorsque le service en amont reste silencieux, il envoie toutes les 2 secondes une ligne de commentaire SSE (`: opencodex heartbeat`), ignorée par l’analyseur, afin de réarmer la minuterie d’inactivité de Codex. Une ligne de commentaire est ignorée par tous les analyseurs eventsource sans produire d’événement, donc les décodeurs Responses stricts ne voient jamais de variante inconnue. Le **délai maximal de blocage** est de 300 secondes par défaut (`stallTimeoutSec`). Une fois ce délai atteint, le service en amont est interrompu et `response.incomplete` est émis avec le motif `upstream_stall_timeout`, ce qui empêche une connexion bloquée d’immobiliser Codex indéfiniment.
77
77
78
78
Les appels d’outils sont répartis entre trois types d’éléments Responses à l’aide de la table des espaces de noms, de l’ensemble des outils libres et de l’ensemble des outils de recherche capturés par l’analyseur. Les espaces de noms MCP, les outils libres tels que `apply_patch` et les appels `tool_search` exécutés par le client peuvent ainsi effectuer un aller-retour complet. Une variante `buildResponseJSON()` produit à partir des mêmes événements un objet de réponse unique hors flux.
@@ -115,7 +115,7 @@ dial and use your admission token:
115
115
[model.ocx-opus]
116
116
model = "anthropic/claude-opus-4-8"
117
117
base_url = "http://192.168.1.10:10100/v1"# the reachable host, not 127.0.0.1
118
-
api_backend = "chat_completions"
118
+
api_backend = "responses"
119
119
api_key = "your-OPENCODEX_API_AUTH_TOKEN"
120
120
```
121
121
@@ -129,11 +129,6 @@ the id `grok-4.5`. Generated aliases avoid dots entirely for this reason.
129
129
130
130
## Known limitations
131
131
132
-
-**Responses backend and keep-alives:** opencodex emits a `response.heartbeat` keep-alive
133
-
on `/v1/responses` streams during upstream silence. Grok Build's Responses decoder
134
-
rejects unknown event types, so a manually configured `api_backend = "responses"` model
135
-
can fail mid-turn on slow upstreams. The auto-registered entries pin
136
-
`api_backend = "chat_completions"`, which never surfaces raw heartbeat frames.
137
132
-**Service-installed `ocx restart`:** the running proxy owns restart authorization and drain
138
133
coordination, while the installed service manager launches the replacement after the old process
139
134
exits. Service supervision remains installed. On loopback auto-registration, the managed block
base_url = "http://192.168.1.10:10100/v1"# the reachable host, not 127.0.0.1
base_url = "http://192.168.1.10:10100/v1"# the reachable host, not 127.0.0.1
-**Responses 백엔드와 keep-alive:** 상위 업스트림이 조용한 동안 opencodex는 `/v1/responses` 스트림에 `response.heartbeat` keep-alive를 보냅니다. Grok Build의 Responses 디코더는 알 수 없는 이벤트 타입을 거부하므로, 수동으로 설정한 `api_backend = "responses"` 모델은 느린 업스트림에서 턴 도중 실패할 수 있습니다. 자동 등록된 항목은 `api_backend = "chat_completions"`로 고정되며, 원시 heartbeat 프레임을 노출하지 않습니다.
76
75
-**서비스 설치된 `ocx restart`:** 실행 중인 프록시는 재시작 권한 확인과 드레인 조정을 담당하고, 기존 프로세스가 종료된 뒤 설치된 서비스 관리자가 교체 프로세스를 시작합니다. 서비스 감독은 그대로 유지됩니다. 루프백 자동 등록을 사용하는 경우에만 관리 블록도 핸드오프 동안 유지되며, 비루프백 배포에서는 Grok 설정을 수동으로 관리합니다. 같은 포트에서 신원이 확인된 다른 프로세스가 정상 상태가 된 뒤에만 명령이 성공합니다.
77
76
-**설정 읽기 시점:** 가장 예측 가능한 결과를 얻으려면 opencodex를 먼저 시작하고 그다음 `grok`를 실행합니다. Grok Build는 `~/.grok/config.toml`을 감시하다가 `[model]` 테이블이 실제로 바뀔 때 다시 불러옵니다(내용을 기준으로 비교하는 약 1초 디바운스). 그래서 새로 고친 블록은 재시작 없이 열린 세션에도 들어갑니다. Grok가 무엇을 파싱했는지 확인하려면 `grok inspect`를 실행합니다. 이 명령은 로드한 설정 원본을 나열하고 거부한 필드가 있으면 경고합니다. 해석된 모델 목록은 출력하지 않습니다. TOML 오류 하나만으로도 사용자 설정 레이어 전체가 무효가 되므로, opencodex가 파일을 원자적으로 쓰는 이유도 여기에 있습니다. Grok는 절반만 써진 설정을 보지 않습니다.
78
77
-**카탈로그 업데이트:** 펜스 블록은 주입 시점의 카탈로그를 반영합니다. 공급자나 모델을 추가한 뒤에는 `ocx ensure`를 실행하거나 프록시를 재시작해 갱신합니다.
base_url = "http://192.168.1.10:10100/v1"# the reachable host, not 127.0.0.1
0 commit comments