Struct LiveState 

pub struct LiveState {
    pub output_lines: Vec<String>,
    pub updated_at: DateTime<Utc>,
    pub machine_state: MachineState,
    pub last_heartbeat: DateTime<Utc>,
}

Live streaming state for a session, written frequently during Claude runs.

This struct holds the most recent output lines and current state, enabling the monitor command to display real-time output without reading the full state. Written atomically to prevent partial reads.

The last_heartbeat field is the authoritative indicator of whether a run is still active. GUI/TUI should consider a run “active” if heartbeat is recent (< 10 seconds old).

Fields

output_lines: Vec<String>

Recent output lines from Claude (max 50 lines, newest last)

updated_at: DateTime<Utc>

When this live state was last updated (by output or state change)

machine_state: MachineState

Current machine state

last_heartbeat: DateTime<Utc>

Heartbeat timestamp - updated every 2-3 seconds while run is active. This is the authoritative indicator of whether the run is still alive. GUI/TUI should consider a run “active” if this is < 10 seconds old.

Implementations

impl LiveState

pub fn new(machine_state: MachineState) -> Self

Create a new LiveState with the given machine state.

pub fn append_line(&mut self, line: String)

Append a line to the output, keeping at most 50 lines. Updates the updated_at timestamp.

pub fn update_heartbeat(&mut self)

Update the heartbeat timestamp to indicate the run is still active. This should be called every 2-3 seconds during an active run.

pub fn update_state(&mut self, new_state: MachineState)

Update the machine state and refresh timestamps. Called when the state machine transitions to a new state.

pub fn is_heartbeat_fresh(&self) -> bool

Check if the heartbeat is recent enough to consider the run active. Returns true if the heartbeat is less than HEARTBEAT_STALE_THRESHOLD_SECS old.

Trait Implementations

impl Clone for LiveState

fn clone(&self) -> LiveState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LiveState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LiveState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LiveState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.