Struct TurnResult 

pub struct TurnResult {
    pub state: SessionSnapshot,
    pub outcome: TurnOutcome,
    pub assistant_output: AssistantOutput,
    pub usage: TokenUsage,
    pub children_usage: Vec<TokenLedgerEntry>,
    pub llm_calls: Vec<LlmCallRecord>,
    pub tool_calls: Vec<ToolCallRecord>,
    pub execution: ExecutionSummary,
    pub errors: Vec<TurnIssue>,
}

Fields

state: SessionSnapshot

outcome: TurnOutcome

assistant_output: AssistantOutput

usage: TokenUsage

Parent’s own LLM tokens for this turn. Does not include child sessions; see children_usage and total_usage.

children_usage: Vec<TokenLedgerEntry>

Per-(source, model) ledger entries for child sessions whose LLM calls completed during this turn (subagents, compaction, observers, etc.). Empty unless the turn spawned children.

llm_calls: Vec<LlmCallRecord>

Provider calls made by the parent session during this turn, in protocol order. Child-session calls remain on each child’s result. This is the complete lash-side model attribution surface: a turn has no single producing model, so lash exposes the per-call ledger and the host composes any higher-level view from it (ADR 0033).

tool_calls: Vec<ToolCallRecord>

execution: ExecutionSummary

errors: Vec<TurnIssue>

Implementations

impl TurnResult

pub fn total_usage(&self) -> TokenUsage

Sum of parent’s own LLM tokens and every child session’s LLM tokens for this turn.

pub fn started_at(&self) -> SystemTime

Wall-clock instant the runtime started this turn (claim of the session-execution lease / queued-work claim), read from the runtime clock. Backed by ExecutionSummary::started_at_ms on execution.

pub fn duration(&self) -> Duration

Whole-turn duration — claim through final commit and post-persist hooks — measured on the runtime clock’s monotonic source. Backed by ExecutionSummary::duration_ms on execution.

pub fn assistant_message(&self) -> Option<&str>

pub fn final_value(&self) -> Option<&Value>

pub fn tool_value(&self) -> Option<(&str, &Value)>

pub fn is_success(&self) -> bool

Trait Implementations

impl Clone for TurnResult

fn clone(&self) -> TurnResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnResult

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TurnResult

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TurnResult

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

where __S: Serializer,

Serialize this value into the given Serde serializer.