From b1fb3ec0fa739b245d1896cb4b70ec345366842b Mon Sep 17 00:00:00 2001 From: Hare Date: Thu, 28 May 2026 02:05:49 +0900 Subject: [PATCH] ticket: complete codex oauth wire compatibility --- TODO.md | 1 - tickets/codex-oauth-wire-compatibility.md | 43 ----------------------- 2 files changed, 44 deletions(-) delete mode 100644 tickets/codex-oauth-wire-compatibility.md diff --git a/TODO.md b/TODO.md index 02bdf3f0..2461e4d9 100644 --- a/TODO.md +++ b/TODO.md @@ -11,7 +11,6 @@ - Pod: scope 永続化 authority の整理 → [tickets/pod-scope-persistence-authority.md](tickets/pod-scope-persistence-authority.md) - SpawnPod 初回 task delivery の受理確認 → [tickets/spawnpod-initial-run-confirmation.md](tickets/spawnpod-initial-run-confirmation.md) - E2E テストハーネス（`tests/e2e/`、opt-in） → [tickets/e2e-harness.md](tickets/e2e-harness.md) -- CodexOAuth: Codex CLI との wire 互換性を揃える → [tickets/codex-oauth-wire-compatibility.md](tickets/codex-oauth-wire-compatibility.md) - メモリ機構 - consolidation skip 表示と invalid staging の観測性 → [tickets/memory-consolidation-skip-observability.md](tickets/memory-consolidation-skip-observability.md) - memory / knowledge tool 利用タイミングのプロンプトガイダンス → [tickets/memory-tool-guidance-prompt.md](tickets/memory-tool-guidance-prompt.md) diff --git a/tickets/codex-oauth-wire-compatibility.md b/tickets/codex-oauth-wire-compatibility.md deleted file mode 100644 index 16bb4713..00000000 --- a/tickets/codex-oauth-wire-compatibility.md +++ /dev/null @@ -1,43 +0,0 @@ -# CodexOAuth: Codex CLI との wire 互換性を揃える - -## 背景 - -CodexOAuth / OpenAI Responses 経路で、tool result 後の次 LLM request が `stream_open_start` のまま戻らず、Pause / Resume または cancel まで進まない症状が複数回観測された。直近の trace では local の prune / request build は完了しており、停止位置は `client.stream(request).await` 内、つまり ChatGPT backend への stream open 前後だった。 - -同時に、公式 Codex CLI 実装と insomnia の CodexOAuth transport には wire level の差分がある。 - -- insomnia は streaming request に `Accept: text/event-stream` を明示していない。 -- insomnia は `prompt_cache_key` は body に送るが、Codex CLI が送る `session_id` / `x-client-request-id` header を送っていない。 -- insomnia は Codex backend 向け request body compression を行っていない。 -- insomnia は Codex backend request の stream open / token refresh に hard timeout を持たない。 -- 公式 Codex 側には 401 recovery や request telemetry があるが、insomnia 側の CodexOAuth は最小実装に留まっている。 - -Prune 発火後に prompt cache が効かない cold request になり、巨大 request が非圧縮で ChatGPT backend に送られている可能性がある。まずは timeout / trace の追加調査より前に、Codex CLI と明確に異なる wire behavior を揃える。 - -## 要件 - -- CodexOAuth / ChatGPT backend 向け Responses streaming request を Codex CLI の wire behavior に近づける。 - - `Accept: text/event-stream` を送る。 - - stable conversation key がある場合、body の `prompt_cache_key` だけでなく header にも `session_id` と `x-client-request-id` を送る。 - - CodexOAuth request では request body compression を利用する。 -- 公式 OpenAI API key 経路や Anthropic / Gemini / Ollama 経路に不要な Codex 専用 header / compression を混ぜない。 -- CodexOAuth 判定は llm-worker が provider crate の具象型に依存しない形で行う。 -- wire 互換性の regression test を追加する。 - - CodexOAuth 相当の custom auth では streaming request が `Accept: text/event-stream` / `session_id` / `x-client-request-id` / `Content-Encoding: zstd` を送る。 - - non-Codex auth では Codex 専用 header / compression を送らない。 -- timeout は全体方針として必要だが、この ticket では Codex CLI との差分解消を優先する。timeout は別 ticket / 後続対応で扱う。 -- pre-stream lifecycle trace の追加は、Codex wire behavior を揃えた後も再発する場合に行う。 - -## 完了条件 - -- CodexOAuth 相当 request の wire headers / compression が test で確認されている。 -- non-Codex request に Codex 専用 wire behavior が漏れない test がある。 -- `cargo fmt --check` と関連 crate の test が通る。 - -## 範囲外 - -- Prune の閾値調整。 -- stream open / request 全体 timeout の設計実装。 -- 401 recovery の本格実装。 -- Codex WebSocket transport への移行。 -- 追加 trace instrumentation。