Struct Turn 

pub struct Turn {
    pub context: TurnContext,
    pub input: TurnInput,
    pub metrics: TurnMetrics,
}

Complete state of a single agent turn from input through metrics capture.

Created at the start of process_user_message, populated through the turn lifecycle, and consumed at the end for metrics emission and trace completion.

Ownership: Turn is stack-owned — created in begin_turn, passed through sub-methods by &mut Turn, and consumed in end_turn. It is never stored on the Agent struct.

Phase 1 scope: carries context (id, cancel token, timeouts), input, and metrics.

Fields

context: TurnContext

Per-turn execution context (id, cancel token, timeouts).

input: TurnInput

Resolved user input for this turn.

metrics: TurnMetrics

Per-turn metrics accumulated during the turn lifecycle.

Implementations

impl Turn

pub fn new(context: TurnContext, input: TurnInput) -> Self

Create a new turn with the given context and input.

Examples

let ctx = TurnContext::new(TurnId(0), CancellationToken::new(), TimeoutConfig::default());
let input = TurnInput::new("hello".to_owned(), vec![]);
let turn = Turn::new(ctx, input);
assert_eq!(turn.id(), TurnId(0));

pub fn id(&self) -> TurnId

Return the turn ID.

pub fn cancel_token(&self) -> &CancellationToken

Return an immutable reference to the per-turn cancellation token.

pub fn metrics_snapshot(&self) -> &TurnMetrics

Return an immutable reference to the turn metrics.

pub fn metrics_mut(&mut self) -> &mut TurnMetrics

Return a mutable reference to the turn metrics.