Module protocol 

App-server v2 protocol types for the Codex CLI.

These types represent the JSON-RPC request parameters, response payloads, and notification bodies used by codex app-server. All wire types use camelCase field names via #[serde(rename_all = "camelCase")].

Organization

• Request/Response pairs — ThreadStartParams/ThreadStartResponse, TurnStartParams/TurnStartResponse, etc.
• Server notifications — Structs like TurnCompletedNotification, AgentMessageDeltaNotification that can be deserialized from the params field of a [ServerMessage::Notification]
• Approval flow types — CommandExecutionApprovalParams and FileChangeApprovalParams for server-to-client requests that need a response
• Method constants — The methods module contains all JSON-RPC method name strings

Parsing notifications

Prefer the typed dispatch in crate::messages over manual method checks:

use codex_codes::{Notification, ServerMessage};

fn handle(msg: ServerMessage) {
    if let ServerMessage::Notification(Notification::TurnCompleted(c)) = msg {
        println!("Turn {} on thread {} completed", c.turn.id, c.thread_id);
    }
}

Modules

methods

JSON-RPC method names used by the app-server protocol.

Structs

AccountRateLimitsUpdatedNotification

account/rateLimits/updated notification.

AgentMessageDeltaNotification

item/agentMessage/delta notification.

ClientInfo

Client info sent during the initialize handshake.

CmdOutputDeltaNotification

item/commandExecution/outputDelta notification.

CommandExecutionApprovalParams

Parameters for item/commandExecution/requestApproval (server → client).

CommandExecutionApprovalResponse

Response for item/commandExecution/requestApproval.

ErrorNotification

error notification.

FileChangeApprovalParams

Parameters for item/fileChange/requestApproval (server → client).

FileChangeApprovalResponse

Response for item/fileChange/requestApproval.

FileChangeOutputDeltaNotification

item/fileChange/outputDelta notification.

InitializeCapabilities

Client capabilities negotiated during initialize.

InitializeParams

Parameters for the initialize request.

InitializeResponse

Response from the initialize request.

ItemCompletedNotification

item/completed notification.

ItemStartedNotification

item/started notification.

McpServerStartupStatusUpdatedNotification

mcpServer/startupStatus/updated notification.

RateLimitWindow

A rate-limit window descriptor used inside RateLimits.

RateLimits

Rate-limit envelope sent in AccountRateLimitsUpdatedNotification.

ReasoningDeltaNotification

item/reasoning/summaryTextDelta notification.

RemoteControlStatusChangedNotification

remoteControl/status/changed notification.

ThreadArchiveParams

Parameters for thread/archive.

ThreadArchiveResponse

Response from thread/archive.

ThreadInfo

Thread metadata returned inside a ThreadStartResponse.

ThreadStartParams

Parameters for thread/start.

ThreadStartResponse

Response from thread/start.

ThreadStartedNotification

thread/started notification.

ThreadStatusChangedNotification

thread/status/changed notification.

ThreadTokenUsageUpdatedNotification

thread/tokenUsage/updated notification.

TokenCounts

A snapshot of token counts within a single turn or aggregated across a thread. Sub-field of TokenUsage.

TokenUsage

Cumulative token usage for a thread.

Turn

A completed turn with its items and final status.

TurnCompletedNotification

turn/completed notification.

TurnError

Error information from a failed turn.

TurnInterruptParams

Parameters for turn/interrupt.

TurnInterruptResponse

Response from turn/interrupt.

TurnStartParams

Parameters for turn/start.

TurnStartResponse

Response from turn/start.

TurnStartedNotification

turn/started notification.

Enums

CommandApprovalDecision

Decision for command execution approval.

FileChangeApprovalDecision

Decision for file change approval.

ThreadStatus

Status of a thread, sent via ThreadStatusChangedNotification.

TurnStatus

Status of a turn within a Turn.

UserInput

User input sent as part of a TurnStartParams.