Struct MessageEnvelope 

pub struct MessageEnvelope {
    pub protocol_version: String,
    pub message: A2AMessage,
    pub trace: Option<TraceContext>,
    pub owner: Option<String>,
    pub headers: HashMap<String, String>,
}

Transport-neutral message envelope shared across HTTP and gRPC (P2-8).

A2A messages carry identical semantics over JSON-RPC/HTTP and (future) gRPC; this envelope is the common representation so a message produced on one transport can be handed to the other without reshaping. It bundles the message with the cross-cutting metadata that would otherwise live in an HTTP header or a gRPC field: W3C trace context, caller identity, and arbitrary application headers.

Fields

protocol_version: String

Protocol version this envelope conforms to.

message: A2AMessage

The message payload.

trace: Option<TraceContext>

W3C trace context carried on the message (P2-8).

owner: Option<String>

Caller / organization identity (P1-4).

headers: HashMap<String, String>

Arbitrary application-defined headers.

Implementations

impl MessageEnvelope

pub fn new(message: A2AMessage) -> Self

Wrap a message in a fresh envelope for the current protocol version.

pub fn with_trace(self, trace: TraceContext) -> Self

Attach the W3C trace context (P2-8).

pub fn with_owner(self, owner: impl Into<String>) -> Self

Attach the caller / organization identity (P1-4).

pub fn with_header( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Attach an application-defined header.

pub fn into_message(self) -> A2AMessage

Unwrap into the bare message.

Trait Implementations

impl Clone for MessageEnvelope

fn clone(&self) -> MessageEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MessageEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MessageEnvelope

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MessageEnvelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.