Struct TurnSnapshot 

pub struct TurnSnapshot {
    pub turn_index: usize,
    pub messages: Arc<Vec<LlmMessage>>,
    pub usage: Usage,
    pub cost: Cost,
    pub stop_reason: StopReason,
    pub state_delta: Option<StateDelta>,
}

A point-in-time snapshot of agent state at a turn boundary.

Emitted as part of TurnEnd events to support external replay, auditing, and debugging. Contains the full context at the moment the turn completed.

Fields

turn_index: usize

Zero-based index of this turn within the current agent loop run.

messages: Arc<Vec<LlmMessage>>

The LLM messages present in the context at the turn boundary.

Wrapped in Arc to avoid cloning the full message list when the snapshot is forwarded to multiple subscribers.

usage: Usage

Accumulated token usage up to and including this turn.

cost: Cost

Accumulated cost up to and including this turn.

stop_reason: StopReason

Stop reason from the assistant message that ended this turn.

state_delta: Option<StateDelta>

Session state changes during this turn, if any.

Trait Implementations

impl Clone for TurnSnapshot

fn clone(&self) -> TurnSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnSnapshot

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TurnSnapshot

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TurnSnapshot

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

where __S: Serializer,

Serialize this value into the given Serde serializer.