Struct TurnContext 

pub struct TurnContext {
    pub session_id: SessionId,
    pub turn_id: TurnId,
    pub input_message_id: MessageId,
    pub agent_id: AgentId,
    pub org_id: i64,
}

Context for a turn, created once and carried throughout execution.

This struct is the single source of truth for turn-scoped identifiers. It is created when the turn begins and passed to all atoms.

Fields

session_id: SessionId

Session this turn belongs to

turn_id: TurnId

Unique identifier for this turn.

Created once at turn start, never changes. All events emitted during this turn use this ID for correlation.

input_message_id: MessageId

Message that initiated this turn (the user’s input message)

agent_id: AgentId

Agent executing this turn

org_id: i64

Organization ID (for multi-tenancy)

Implementations

impl TurnContext

pub fn new( session_id: SessionId, input_message_id: MessageId, agent_id: AgentId, org_id: i64, ) -> Self

Create a new turn context with a fresh turn ID.

pub fn with_turn_id( session_id: SessionId, turn_id: TurnId, input_message_id: MessageId, agent_id: AgentId, org_id: i64, ) -> Self

Create a turn context with an existing turn ID.

Use this when resuming a turn (e.g., in durable execution).

Trait Implementations

impl Clone for TurnContext

fn clone(&self) -> TurnContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnContext

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

Formats the value using the given formatter.