Releases: pwrdrvr/codex-app-server-protocol
Releases · pwrdrvr/codex-app-server-protocol
Release list
0.153.4
Generated from exact released codex-cli 0.153.4 with the experimental surface.
827 generated TypeScript files, up from 671 in 0.144.0. The client request union
adds 33 methods and the server notification union adds 14 methods; neither
union removes a method.
Added
ServerNotificationEnvelopewith optionalemittedAtMs(Unix milliseconds)
for server emission time; older servers may omit it. This is live notification
timing, not historical item timing.- Server-managed thread queue add, update, delete, reorder, list, and start
RPCs, plus queue change notifications andturn/settings/update. - Project CRUD, import, and move RPCs; thread section management; project and
section assignments on threads; thread revert and occurrence search. - Experimental
thread/timeline/list, combining ordinary items, realtime
items, and turn boundaries, plus backwards hydration cursors on resume. - Agent-message delivery and asynchronous question metadata, a
functionCallOutputthread-item variant, andtoolOutputon turn start. - Audio and local-audio user input, realtime item lifecycle/transcript
notifications, and anexistingCallrealtime transport. - Bedrock discovery/setup, provider auth recovery notifications, environment
status and connection notifications, and server diagnostics. - MCP event streams, client extension declarations, expanded MCP metadata,
plugin search/reconciliation, app reads, and installed-app queries. - Thread model/reasoning-effort/direct-input metadata, per-turn service tier,
fork-before-turn support, deferred fork goal continuation, model multi-agent
metadata, cache-write token accounting, and raw response usage notifications.
Changed / consumer migration
ThreadItemsListResponse.datanow containsThreadItemEntryenvelopes
({ turnId, item }) instead of bareThreadItemvalues. Consumers must
unwrapentry.itemand can useentry.turnIdfor attribution.ToolRequestUserInputParamsadds requiredisBlocking; use it instead of
deprecatedautoResolutionMsto decide whether a question blocks.- Removed
AmazonBedrockCredentialSource; the Bedrock account variant now
reportsusesCodexManagedCredentialsinstead ofcredentialSource. ReviewDecisionchanges"denied"to{ denied: { rejection: string } }
and adds"approved_mcp_policy_amendment".- Many response types add required nullable fields, including
Thread,
Model, agent messages, and resume responses. Update typed fixtures and
exhaustive union handling; newer declarations do not upgrade older servers. - Full-history hydration is deprecated for paginated threads; prefer metadata
reads andthread/turns/list/thread/items/listpagination. - Historical per-item timestamps are still absent, including item-list
envelopes and ordinary timeline entries. Preserve known live lifecycle times
and leave unknown historical times absent. See the README for the upstream
investigation and proposal.
Full changes: v0.144.0...v0.153.4
v0.144.0
Generated from codex-cli 0.144.0.
Added
- Remote control pairing and client-management RPCs:
remoteControl/pairing/start,remoteControl/pairing/status,
remoteControl/client/list, andremoteControl/client/revoke. - Thread lifecycle support for deletion via
thread/deleteand the
thread/deletednotification. - Background terminal listing and termination RPCs for threads.
- Thread hierarchy and subagent metadata, including
parentThreadId,
historyMode,extra,recencyAt, and list filters for parent or ancestor
thread IDs. - Account usage and rate-limit reset-credit types and RPCs, including
account/usage/read,account/rateLimitResetCredit/consume, reset-credit
summaries, and spend-control limit snapshots. - Realtime session controls for speech append, handoff behavior, startup
context, realtime model override, and realtime protocol version override. - Dynamic tool namespace specs alongside function specs.
- External-agent config import progress notifications and import history reads.
- Server-to-client
currentTime/readrequests. - Skills extra-root configuration, npm plugin source metadata, app template
summaries, and plugin install policy source metadata. - Turn moderation metadata and model safety-buffering notifications.
Changed
thread/turns/items/listwas renamed tothread/items/list, with
ThreadTurnsItemsList*types renamed toThreadItemsList*.ReasoningEffortwidened from a fixed string union tostring.- Runtime workspace roots now use
AbsolutePathBuf[]in thread start, resume,
fork, and turn start params. ThreadItempath fields now useLegacyAppPathStringin several places and
gained updated web-search, image-generation, sleep, subagent-activity, and
MCP app-context item shapes.AskForApprovalno longer includes"on-failure".AuthModegainedheaders,personalAccessToken, andbedrockApiKey.WebSearchModegainedindexed.ThreadSortKeygainedrecency_at.
v0.135.0
TypeScript types for the Codex App Server JSON-RPC protocol, generated from
codex-cli 0.135.0 (codex app-server generate-ts --experimental).
The package version mirrors the codex-cli version that generated src/.
Protocol changes vs 0.133.0 (src/v2/, 587 → 591 files)
- Removed:
ProfileV2 - Added:
AdditionalContextEntry,AdditionalContextKind,ThreadSearchParams,ThreadSearchResponse,ThreadSearchResult - Modified: 15 files — e.g.
ThreadStartParams.experimentalRawEventsandpersistExtendedHistoryare now optional
Also in this release
- Clean-room regeneration procedure (
pnpm regenerate+scripts/regenerate.sh) that deletessrc/first so removed/renamed types surface in the diff; documented inAGENTS.md/CLAUDE.md. - CI: GitHub Actions bumped off the deprecated Node 20 runtime (checkout/setup-node/pnpm-action-setup → v5); added a pinned
publintpackaging check.
Generated from the exact rust-v0.135.0 release binary (not the 0.135.0-alpha.1 Codex Desktop build).