Struct EventContext 

pub struct EventContext {
    pub turn_id: Option<TurnId>,
    pub input_message_id: Option<MessageId>,
    pub exec_id: Option<ExecId>,
    pub trace_id: Option<String>,
    pub span_id: Option<String>,
    pub parent_span_id: Option<String>,
}

Context for event correlation and tracing

Uses OpenTelemetry-style trace/span IDs for observability correlation:

• trace_id: Root of the trace (typically the turn_id string)
• span_id: This event’s unique span identifier
• parent_span_id: The parent span’s identifier for hierarchical linking

Fields

turn_id: Option<TurnId>

Turn identifier (for turn-scoped events)

input_message_id: Option<MessageId>

User message that triggered this turn

exec_id: Option<ExecId>

Atom execution identifier

trace_id: Option<String>

Trace ID for observability (OTel-style). Groups related spans into a single trace. For agent turns, this is typically the turn_id string.

span_id: Option<String>

This event’s span ID for observability (OTel-style). Uniquely identifies this span within the trace.

parent_span_id: Option<String>

Parent span ID for hierarchical linking (OTel-style). Links this span to its parent in the trace hierarchy.

Implementations

impl EventContext

pub fn empty() -> Self

Create an empty context (for session-level events)

pub fn from_atom_context(ctx: &AtomContext) -> Self

Create a full context from an AtomContext

pub fn turn(turn_id: TurnId, input_message_id: MessageId) -> Self

Create a context for turn-scoped events (without exec_id)

pub fn with_span( self, trace_id: String, span_id: String, parent_span_id: Option<String>, ) -> Self

Set OTel-style span context for hierarchical tracing

Trait Implementations

impl Clone for EventContext

fn clone(&self) -> EventContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EventContext

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

Formats the value using the given formatter.

impl Default for EventContext

fn default() -> EventContext

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EventContext

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for EventContext

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

where __S: Serializer,

Serialize this value into the given Serde serializer.