Struct EventEnvelope 

pub struct EventEnvelope { /* private fields */ }

A versioned observable event envelope.

Implementations

impl EventEnvelope

pub fn new( event_id: EventId, session_id: SessionId, run_id: Option<RunId>, turn_id: Option<TurnId>, sequence: SessionSequence, timestamp: ProtocolTimestamp, metadata: ProtocolMetadata, event: AgentEvent, ) -> Result<Self, EventValidationError>

Creates a validated current-version event envelope.

Errors

Returns an error when references do not match the event kind or the payload exceeds protocol bounds.

pub fn inspect_value(value: Value) -> Result<EventInspection, EventDecodeError>

Inspects untrusted event JSON with explicit unknown-event behavior.

Errors

Returns an error for malformed known events, unknown state-bearing events, invalid compatibility markers, or unsupported protocol majors.

pub const fn protocol_version(&self) -> ProtocolVersion

Returns the envelope protocol version.

pub const fn event_id(&self) -> EventId

Returns the observable event identifier.

pub const fn session_id(&self) -> SessionId

Returns the session identifier.

pub const fn run_id(&self) -> Option<RunId>

Returns the related run identifier when present.

pub const fn turn_id(&self) -> Option<TurnId>

Returns the related turn identifier when present.

pub const fn sequence(&self) -> SessionSequence

Returns the authoritative session-local event sequence.

pub const fn timestamp(&self) -> ProtocolTimestamp

Returns the event timestamp.

pub const fn metadata(&self) -> &ProtocolMetadata

Returns bounded extension metadata.

pub const fn event(&self) -> &AgentEvent

Returns the typed event payload.

pub const fn event_type(&self) -> AgentEventType

Returns the stable event discriminator.

Trait Implementations

impl Clone for EventEnvelope

fn clone(&self) -> EventEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EventEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EventEnvelope

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for EventEnvelope

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for EventEnvelope

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 EventEnvelope