docs(vrs): specify Codex native DING delivery - #233
Closed
myobie wants to merge 2 commits into
Closed
Conversation
This was referenced Aug 10, 2026
Contributor
Author
|
Folded into the reviewable specification replacement #242 at exact head |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
deliver "app-server"Codex transportturn/start, active regularturn/steer, and fail-closed hold statesuserMessageacceptance and st2-owned duplicate controldingscreen grammar unchangedDependency
This change is stacked on #229. Review this pull request as the Codex-specific addition to that shared DING contract.
Current protocol evidence
I verified Codex CLI 0.145.0 through its generated app-server v2 JSON Schema and one ephemeral live app-server thread.
turn/startandturn/steeracceptclientUserMessageId.turn/steerrequires exactexpectedTurnId.turn/startresponse was followed byitem/completedwithitem.type = "userMessage"anditem.clientIdequal to the supplied client ID.turn/steerwhile idle failed withno active turn to steer.The contract follows the current official Codex App Server manual. It also states that this is an experimental provider surface and must fail closed on an incompatible schema.
Validation
codex app-server generate-json-schemaon Codex CLI 0.145.0git diff --check37a14daReview
Please review the exact head
37a14da. This pull request remains draft and must not merge before Nathan reviews it.