Struct AgentEnvelope 

pub struct AgentEnvelope {
    pub schema_version: u16,
    pub relay_id: String,
    pub context: OclaRequestContext,
    pub from_agent_id: String,
    pub to_agent_id: String,
    pub capsule_ref: String,
    pub budget_tokens: u64,
}

Canonical, payload-free admission contract for one A2A relay.

budget_tokens is an authorization ceiling, never observed delivery or savings evidence. A transport must create its own measured token envelope only after it actually materializes and delivers the handoff.

Fields

schema_version: u16

[PUBLIC] Agent-envelope schema version.

relay_id: String

[PII] Content-derived relay identifier for idempotent admission and event joins.

context: OclaRequestContext

[PII] Request context containing correlation identifiers.

from_agent_id: String

[PII] Sending agent identifier.

to_agent_id: String

[PII] Receiving agent identifier.

capsule_ref: String

[PII] Capsule reference that can identify workspace content.

budget_tokens: u64

[INTERNAL] Authorized token budget.

Implementations

impl AgentEnvelope

pub fn assign_relay_id(&mut self) -> OclaResult<()>

Assigns the deterministic identity after all relay fields are set.

pub fn computed_relay_id(&self) -> OclaResult<String>

Derives a stable relay ID without including payload bytes or the ID itself.

pub fn validate(&self) -> OclaResult<()>

Trait Implementations

impl Clone for AgentEnvelope

fn clone(&self) -> AgentEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentEnvelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AgentEnvelope

impl PartialEq for AgentEnvelope

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AgentEnvelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AgentEnvelope