Feature request: version marker (or stability guarantee) for the `codex exec --json` event schema — 0.144 "canonical turn items" silently broke downstream parsers
Open 💬 0 comments Opened Aug 27, 2026 by cyl-castillo
Context: I maintain Agent Console, a desktop console that runs Codex and Claude Code side by side. Multi-agent "room" sessions consume codex exec --json (thread.started / item.completed / turn.completed).
What happened: 0.144 restructured the event schema ("canonical turn items"). The change itself is fine — but there's no version marker in the stream and no schema changelog, so downstream parsers fail silently on upgrade instead of failing fast. Anyone consuming exec --json (CI integrations, wrappers, dashboards) has the same problem on every schema change.
Ask: one of:
- a
schema_versionfield in the first event of the stream (cheapest, unblocks everyone), or --json-schema-version Nflag with N frozen per major, or- if
codex app-serveris the intended stable surface for integrators, saying so explicitly in the docs would let us migrate deliberately instead of chasing TUI/CLI churn.
Happy to beta-test whichever direction you pick against a real multi-engine integration.