Enum Notification 

pub enum Notification {
    ThreadStarted(ThreadStartedNotification),
    ThreadStatusChanged(ThreadStatusChangedNotification),
    ThreadTokenUsageUpdated(ThreadTokenUsageUpdatedNotification),
    TurnStarted(TurnStartedNotification),
    TurnCompleted(TurnCompletedNotification),
    ItemStarted(ItemStartedNotification),
    ItemCompleted(ItemCompletedNotification),
    AgentMessageDelta(AgentMessageDeltaNotification),
    CmdOutputDelta(CmdOutputDeltaNotification),
    FileChangeOutputDelta(FileChangeOutputDeltaNotification),
    ReasoningDelta(ReasoningDeltaNotification),
    Error(ErrorNotification),
    AccountRateLimitsUpdated(AccountRateLimitsUpdatedNotification),
    McpServerStartupStatusUpdated(McpServerStartupStatusUpdatedNotification),
    RemoteControlStatusChanged(RemoteControlStatusChangedNotification),
    Unknown {
        method: String,
        params: Option<Value>,
    },
}

A server-to-client notification.

Each variant maps to a single method string on the wire. The Unknown variant captures methods this crate version doesn’t model yet, preserving the raw payload for inspection.

Variants

ThreadStarted(ThreadStartedNotification)

thread/started

ThreadStatusChanged(ThreadStatusChangedNotification)

thread/status/changed

ThreadTokenUsageUpdated(ThreadTokenUsageUpdatedNotification)

thread/tokenUsage/updated

TurnStarted(TurnStartedNotification)

turn/started

TurnCompleted(TurnCompletedNotification)

turn/completed

ItemStarted(ItemStartedNotification)

item/started

ItemCompleted(ItemCompletedNotification)

item/completed

AgentMessageDelta(AgentMessageDeltaNotification)

item/agentMessage/delta

CmdOutputDelta(CmdOutputDeltaNotification)

item/commandExecution/outputDelta

FileChangeOutputDelta(FileChangeOutputDeltaNotification)

item/fileChange/outputDelta

ReasoningDelta(ReasoningDeltaNotification)

item/reasoning/summaryTextDelta

Error(ErrorNotification)

error

AccountRateLimitsUpdated(AccountRateLimitsUpdatedNotification)

account/rateLimits/updated

McpServerStartupStatusUpdated(McpServerStartupStatusUpdatedNotification)

mcpServer/startupStatus/updated

RemoteControlStatusChanged(RemoteControlStatusChangedNotification)

remoteControl/status/changed

Unknown

A method this crate version does not yet model. The raw params are preserved for caller inspection. Encountering this typically means the installed codex CLI is newer than the bindings.

Fields

method: String

params: Option<Value>

Implementations

impl Notification

pub fn method(&self) -> &str

Return the wire method string for this notification.

pub fn is_unknown(&self) -> bool

true if this notification’s method isn’t modeled by the crate.

pub fn from_envelope(method: &str, params: Option<Value>) -> Result<Self, Error>

Construct a Notification from a method + params envelope.

Returns an error if method is recognized but params doesn’t deserialize into the typed struct. Unknown methods route to Notification::Unknown without error.

pub fn into_envelope(self) -> Result<(String, Option<Value>), Error>

Decompose this notification back into a (method, params) pair.

Trait Implementations

impl Clone for Notification

fn clone(&self) -> Notification

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Notification

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Notification

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Serialize for Notification

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.