Struct SessionState 

pub struct SessionState {

    pub version: u64,
    pub generation: u64,
    pub last_seq: u64,
    pub active_run: Option<RunId>,
    pub cwd_identity: Option<CwdIdentity>,
    pub context_tokens: Option<u64>,
    pub estimated_cost_usd: Option<f64>,
    pub run_agent: Option<AgentId>,
    pub creation_agent: Option<Box<AgentSnapshot>>,
    pub run_snapshot: Option<Box<AgentSnapshot>>,
    pub run_selected_suffix: Option<Vec<FrozenModelBinding>>,
    pub model_selection: SessionModelState,
    pub goal: Option<GoalState>,
    pub transcript: Vec<TranscriptItem>,
    pub pending_inputs: VecDeque<PendingInput>,
    pub voided_inputs: Vec<String>,
    pub thinking_durations: HashMap<(u64, u64), Duration>,
    pub tools: HashMap<ToolCallId, ToolCallState>,
    pub approvals: Vec<ApprovalState>,
    /* private fields */
}

Per-session projection of persisted events and live output.

Fields

version: u64

Changes whenever the visible projection mutates, for UI cache invalidation.

generation: u64

last_seq: u64

active_run: Option<RunId>

cwd_identity: Option<CwdIdentity>

context_tokens: Option<u64>

Total context occupied at the end of the latest committed turn (input_tokens + output_tokens); None when the turn reported no usage, so the bottom bar hides its context segment.

estimated_cost_usd: Option<f64>

Latest authoritative session usage cost fetched from the engine. None covers both not-yet-fetched and unpriced usage; both hide the bottom-bar segment.

run_agent: Option<AgentId>

Frozen producing agent of the latest accepted RunStarted.

creation_agent: Option<Box<AgentSnapshot>>

The complete frozen creation snapshot from SessionCreated, including the exact frozen fallback chain. Delegated draft projections derive only from this, never from live descriptors.

run_snapshot: Option<Box<AgentSnapshot>>

The complete frozen snapshot of the latest accepted RunStarted.

run_selected_suffix: Option<Vec<FrozenModelBinding>>

The authoritative exact suffix from the latest accepted RunStarted: after any run-selection variant override, this vector — never a reconstruction from the agent fallback chain — is what attempts and delegated pickers use.

model_selection: SessionModelState

goal: Option<GoalState>

transcript: Vec<TranscriptItem>

pending_inputs: VecDeque<PendingInput>

The engine’s pending-input lane for this session, reduced purely from admission/promotion/recall events: steered messages the model has not seen yet. Source of the queue strip between the conversation pane and the composer.

voided_inputs: Vec<String>

Pending inputs the engine voided at run end (no per-entry events), parked here until the UI restores their text into the composer — user text is never silently lost. Drained by the UI on sight.

thinking_durations: HashMap<(u64, u64), Duration>

Elapsed thinking time per sealed thinking part, keyed by (item_id, part_id) and derived from durable event timestamps.

tools: HashMap<ToolCallId, ToolCallState>

approvals: Vec<ApprovalState>

Implementations

impl SessionState

pub fn is_open_assistant_part(&self, item_id: u64, part_id: u64) -> bool

pub fn is_open_thinking(&self, item_id: u64, part_id: u64) -> bool

pub fn has_open_thinking(&self) -> bool

Whether any assistant part is still streaming thinking content.

pub fn has_running_tool(&self) -> bool

Whether any tool call in this session is still running.

pub fn has_pending_producers(&self) -> bool

Whether any producer message is waiting for a model run to claim it.

pub fn thinking_duration(&self, item_id: u64, part_id: u64) -> Option<Duration>

The sealed elapsed thinking duration for one part, when known.

Trait Implementations

impl Clone for SessionState

fn clone(&self) -> SessionState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionState

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

Formats the value using the given formatter.

impl Default for SessionState

fn default() -> SessionState

Returns the “default value” for a type.