Enum JsonRpcRequestId 

pub enum JsonRpcRequestId {
    Absent,
    Null,
    Value(Value),
}

A JSON-RPC 2.0 request identifier with three distinct states.

JSON-RPC 2.0 distinguishes an absent id member (the request is a notification — no response is expected) from an explicit null id (a call — discouraged by the spec, but a call nonetheless, answered with a null-id response). Modeling the id as Option<Value> collapses these two states, so an explicit "id": null would round-trip into a notification.

Variants

Absent

The id member was absent: the request is a notification.

Null

The id member was an explicit null: a call with a null id.

Value(Value)

A string or number id. (Kept permissive as a raw JSON value, matching the previous behavior of accepting any JSON type here.)

Implementations

impl JsonRpcRequestId

pub const fn is_absent(&self) -> bool

Returns true when the id member is absent (a notification).

pub const fn as_value(&self) -> Option<&Value>

Returns the id value, if this is a Self::Value.

pub fn to_response_id(&self) -> Option<Value>

Converts to the id a response to this request must carry: the request value, or null for a null-id call.

A notification (Self::Absent) expects no response at all; callers that respond anyway (as this SDK’s HTTP dispatch does, treating every A2A request as a call) get null, mirroring the spec’s rule for requests whose id could not be determined.

Trait Implementations

impl Clone for JsonRpcRequestId

fn clone(&self) -> JsonRpcRequestId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JsonRpcRequestId

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

Formats the value using the given formatter.

impl Default for JsonRpcRequestId

fn default() -> JsonRpcRequestId

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for JsonRpcRequestId

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for JsonRpcRequestId

impl From<Value> for JsonRpcRequestId

fn from(value: Value) -> JsonRpcRequestId

Converts to this type from the input type.

impl PartialEq for JsonRpcRequestId

fn eq(&self, other: &JsonRpcRequestId) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for JsonRpcRequestId

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.

impl StructuralPartialEq for JsonRpcRequestId