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 (UUID v4) for this event emission.

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) -> Self

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

Formats the value using the given formatter.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.