Struct RunState 

pub struct RunState {

    pub run_id: RunId,
    pub session_id: Uuid,
    pub status: RunStatus,
    pub provider: ProviderId,
    pub model: ModelName,
    pub metadata: Value,
    pub iteration: usize,
    pub total_usage: TokenUsage,
    pub last_finish: Option<FinishReason>,
    pub last_error: Option<String>,
    pub event_count: usize,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Projected state of a run, reconstructed from its event log.

Unlike RunRecord which is a static metadata snapshot, RunState is a fully materialized view derived by folding every recorded event via apply. This enables replay-based state recovery and batch inspection of run progress without scanning raw events.

Fields

run_id: RunId

Run identifier.

session_id: Uuid

Session this run belongs to.

status: RunStatus

Current status.

provider: ProviderId

Provider used for model calls.

model: ModelName

Model used for generation.

metadata: Value

Run metadata.

iteration: usize

Current iteration (0 before first model call).

total_usage: TokenUsage

Aggregated token usage across all provider calls.

last_finish: Option<FinishReason>

Finish reason from the last model response.

last_error: Option<String>

Error message if the run failed.

event_count: usize

Number of events folded into this state.

created_at: DateTime<Utc>

When the run was created.

updated_at: DateTime<Utc>

When the last event was recorded.

Implementations

impl RunState

pub fn create(record: &RunRecord, events: &[RunEventRecord]) -> Self

Creates a RunState by folding the run record metadata with its event log.

The record provides static metadata (provider, model, created_at) while events drive the dynamic state projection by applying each event in order via apply.

pub fn apply(&mut self, event: &AgentEvent)

Incrementally updates the projected state by applying a single event.

Handles all AgentEvent variants: RunStarted sets provider/model, ModelStarted advances iteration, UsageRecorded accumulates tokens, terminal events set the final status, while informational events only update the timestamp.

Trait Implementations

impl Clone for RunState

fn clone(&self) -> RunState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunState

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

Formats the value using the given formatter.