Struct AgentEventEnvelope 

pub struct AgentEventEnvelope {
    pub event_id: Uuid,
    pub sequence: u64,
    pub timestamp: OffsetDateTime,
    pub event: AgentEvent,
}

Envelope wrapping every AgentEvent with idempotency metadata.

Mobile clients can use event_id for deduplication on retry, sequence for ordering after persistence, and timestamp for display.

The event field is flattened in JSON so that event_id, sequence, timestamp, and the event’s type discriminant all appear at the same level.

Fields

event_id: Uuid

Unique identifier for this event emission.

UUID v4 when created via AgentEventEnvelope::wrap (SDK-local path), UUID v7 when created via server-committed CommittedEvent::into_envelope.

sequence: u64

Monotonically increasing sequence number within a single run.

timestamp: OffsetDateTime

UTC timestamp of when the event was emitted.

event: AgentEvent

The actual event payload.

Implementations

impl AgentEventEnvelope

pub fn wrap(event: AgentEvent, seq: &SequenceCounter) -> AgentEventEnvelope

Wrap an AgentEvent in an envelope, assigning it a unique ID, the next sequence number, and the current UTC timestamp.

Trait Implementations

impl Clone for AgentEventEnvelope

fn clone(&self) -> AgentEventEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentEventEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentEventEnvelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentEventEnvelope

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.