Campaign map: Gateway deep modules & Codex↔Chat #441

Notes

Campaign: Gateway Deep Modules & Codex↔Chat Bridge.
Label: campaign:gateway-chat.
No version number until the standard Chat floor is green.

Two tracks after this map exists:

• Track 0 — finish the already-started 0.1.9 Provider Injection / DSH campaign. Client migrations do not block Python module extraction.
• Track 1 — extract deep modules from codex_proxy.py and deepen protocol_translation.py so Codex Responses can ride third-party Chat Completions without a second adapter.

Hard gates only:

1. This tracker rewrite (WP0).
2. Cleanup: remove unused Level-3 dynamic-DAG subagent machinery from production path #414 before Refactor: extract route-plan and SSE helper clusters from codex_proxy.py monolith #413, so dead Level-3 DAG names are not frozen into the facade.
3. 0.1.8 Beta6: Generate the runtime-derived Chat and Collaboration V2 conversion matrix #66 → 0.1.8 Beta6: Define the real Codex-to-Chat runtime-field and V2 item contract #253/0.1.8 Beta6: Define progressive Chat and Collaboration V2 streaming #254 before protocol-interface behavior.
4. Standard Chat floor before Collaboration V2.

codex_proxy.py stays the process entry and re-export facade. Extracted modules must not import it. Official passthrough stays unchanged. No hidden Responses / Official / model / Provider fallback.

Decisions-so-far

• Product term remains Gateway.
• Do not create upstream_plumbing.py. gateway_sse.py owns framing/commit/terminal only, not Chat codec semantics.
• _responses_request_to_chat_completion_body stays a thin wrapper over protocol_translation.
• Cleanup: remove unused Level-3 dynamic-DAG subagent machinery from production path #414 default is delete the Level-3 dynamic-DAG scenario, not relocate it.
• 0.1.8 Beta6: Generate the runtime-derived Chat and Collaboration V2 conversion matrix #66 is no longer blocked by stale 0.1.8 Beta5 gate: Publish the three-route maintained-Provider Responses candidate #351 (0.1.8 Beta5 release train).
• 0.1.8 Beta6: Define the real Codex-to-Chat runtime-field and V2 item contract #253 / 0.1.8 Beta6: Define progressive Chat and Collaboration V2 streaming #254 define contracts and are consumed by Provider qualification; they must not be blocked by 0.1.8 Beta6: Complete the GLM-5.2 Ollama Chat and V2 CLI path #285/0.1.8 Beta6: Complete the K2.7 Code Ollama Chat and V2 CLI path #286/0.1.8 Beta6: Complete the DeepSeek V4 Flash 0731 Chat CLI path #396.
• 0.1.8 Beta6 gate: Publish usable Ollama Chat with complete Collaboration V2 #259 is a historical Beta6 gate and is superseded by this map.
• Unify provider model metadata: pricing channel and reasoning-effort mappings as providers.toml data #179 owns reasoning/pricing metadata; Refactor: extract route-plan and SSE helper clusters from codex_proxy.py monolith #413 must not move those constants.
• 0.1.8 Beta6: Verify the complete generic Chat Collaboration V2 lifecycle #395 splits into completable third-party Chat Gateway lifecycle (A) and upstream-blocked Official-parent encrypted handoff (B). Only A is a campaign blocker.

Fog

• Exact post-0.1.9 version number for the Chat release.
• Whether 0.1.9-beta4 is the last 0.1.9 ship or a stable v0.1.9 is tagged.
• Whether any remaining Block-fingerprint readback for injected clients (replace byte-compare) #433 / Spec: Connection-metaphor client UI for the Gateway page #438 acceptance gaps need child tickets after the beta1.x audit.

Work packages

Track 0 — 0.1.9 closeout (parallel with Track 1 after WP0)

• 0A. Reconcile landed-but-open issues (Random request-scoped tool aliases invalidate prompt-cache prefixes #424, Official 15-second connect timeout also caps large request-body writes and causes repeated 502s #426, Fix ordinary DSH tools being misclassified as Codex Collaboration V2 #429, Block-fingerprint readback for injected clients (replace byte-compare) #433, Spec: Connection-metaphor client UI for the Gateway page #438) against current main
• 0B. Changing the local Gateway client key is not applied transactionally to the running Gateway and managed Codex client #428 + remaining Add DeepSeek Harness (DSH) as CodexHub's fifth fully supported managed client #430 (DSH real-client / key rotation) and optional beta2
• 0C. Migrate pi + codex clients to Provider Injection #434 pi + codex injection migration
• 0D. Migrate opencode + omp + zcode clients to Provider Injection #435 opencode + omp + zcode injection migration
• 0E. Close Campaign map: 0.1.9 coexistence Provider Injection & DSH #436 / Spec: Coexistence Provider Injection (campaign 0.1.9) #437 with a published v0.1.9 or a written beta4-is-final decision

Track 1 — Gateway modules + Chat bridge

• WP1. Cleanup: remove unused Level-3 dynamic-DAG subagent machinery from production path #414 delete unused Level-3 dynamic-DAG machinery
• WP2. Refactor: extract route-plan and SSE helper clusters from codex_proxy.py monolith #413 facade freeze + primitives + RoutePlan extraction
• WP3. Refactor: extract route-plan and SSE helper clusters from codex_proxy.py monolith #413 SSE framing extraction (no Chat codec)
• WP4. 0.1.8 Beta6: Generate the runtime-derived Chat and Collaboration V2 conversion matrix #66 matrix, then 0.1.8 Beta6: Define the real Codex-to-Chat runtime-field and V2 item contract #253 request/item contract and 0.1.8 Beta6: Define progressive Chat and Collaboration V2 streaming #254 streaming contract
• WP5. Deepen protocol_translation behind prepare_exchange and land the standard Chat floor
• WP6. 0.1.8 Beta6: Implement generic Collaboration V2 over Chat Completions #394 V2 implementation, narrowed 0.1.8 Beta6: Verify the complete generic Chat Collaboration V2 lifecycle #395-A, then 0.1.8 Beta6: Complete the GLM-5.2 Ollama Chat and V2 CLI path #285 / 0.1.8 Beta6: Complete the K2.7 Code Ollama Chat and V2 CLI path #286 / 0.1.8 Beta6: Complete the DeepSeek V4 Flash 0731 Chat CLI path #396
• WP7. Release gate owned by this map (replaces 0.1.8 Beta6 gate: Publish usable Ollama Chat with complete Collaboration V2 #259)

Child tickets

• Track 0 map: Campaign map: 0.1.9 coexistence Provider Injection & DSH #436
• Cleanup: remove unused Level-3 dynamic-DAG subagent machinery from production path #414
• Refactor: extract route-plan and SSE helper clusters from codex_proxy.py monolith #413
• 0.1.8 Beta6: Generate the runtime-derived Chat and Collaboration V2 conversion matrix #66
• 0.1.8 Beta6: Define the real Codex-to-Chat runtime-field and V2 item contract #253
• 0.1.8 Beta6: Define progressive Chat and Collaboration V2 streaming #254
• protocol-interface ticket (created with this campaign)
• 0.1.8 Beta6: Implement generic Collaboration V2 over Chat Completions #394
• 0.1.8 Beta6: Verify the complete generic Chat Collaboration V2 lifecycle #395
• 0.1.8 Beta6: Complete the GLM-5.2 Ollama Chat and V2 CLI path #285
• 0.1.8 Beta6: Complete the K2.7 Code Ollama Chat and V2 CLI path #286
• 0.1.8 Beta6: Complete the DeepSeek V4 Flash 0731 Chat CLI path #396