Enum AgentNotification 

#[non_exhaustive]
pub enum AgentNotification {
    SessionNotification(SessionNotification),
    CompleteElicitationNotification(CompleteElicitationNotification),
    MessageMcpNotification(MessageMcpNotification),
    ExtNotification(ExtNotification),
}

All possible notifications that an agent can send to a client.

This enum is used internally for routing RPC notifications. You typically won’t need to use this directly.

Notifications do not expect a response.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

SessionNotification(SessionNotification)

Handles session update notifications from the agent.

This is a notification endpoint (no response expected) that receives real-time updates about session progress, including message chunks, tool calls, and execution plans.

Note: Clients SHOULD continue accepting tool call updates even after sending a session/cancel notification, as the agent may send final updates before responding with the cancelled stop reason.

See protocol docs: Agent Reports Output

CompleteElicitationNotification(CompleteElicitationNotification)

Available on crate feature unstable_elicitation only.

UNSTABLE

This capability is not part of the spec yet, and may be removed or changed at any point.

Notification that a URL-based elicitation has completed.

MessageMcpNotification(MessageMcpNotification)

Available on crate feature unstable_mcp_over_acp only.

UNSTABLE

This capability is not part of the spec yet, and may be removed or changed at any point.

Receives an MCP-over-ACP notification.

ExtNotification(ExtNotification)

Handles extension notifications from the agent.

Allows the Agent to send an arbitrary notification that is not part of the ACP spec. Extension notifications provide a way to send one-way messages for custom functionality while maintaining protocol compatibility.

See protocol docs: Extensibility

Implementations

impl AgentNotification

pub fn method(&self) -> &str

Returns the corresponding method name of the notification.

Trait Implementations

impl Clone for AgentNotification

fn clone(&self) -> AgentNotification

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentNotification

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentNotification

fn deserialize<__D>( __deserializer: __D, ) -> Result<AgentNotification, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl IntoV2 for AgentNotification

type Output = AgentNotification

The corresponding v2 draft type.

fn into_v2( self, ) -> Result<<AgentNotification as IntoV2>::Output, ProtocolConversionError>

Converts this value into the corresponding v2 draft type.

impl JsonRpcMessage for AgentNotification

fn matches_method(_method: &str) -> bool

Check if this message type matches the given method name.

fn method(&self) -> &str

The method name for the message.

fn to_untyped_message(&self) -> Result<UntypedMessage, Error>

Convert this message into an untyped message.

fn parse_message(method: &str, params: &impl Serialize) -> Result<Self, Error>

Parse this type from a method name and parameters.

impl JsonRpcNotification for AgentNotification

impl JsonSchema for AgentNotification

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for AgentNotification

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.