Enum DisplayState 

pub enum DisplayState {
    Working,
    Compacting,
    NeedsInput,
    Idle,
    Stale,
}

Visual display state for a session in the TUI.

Represents the simplified user-facing state of a session, derived from the underlying SessionStatus and activity timing. This provides clear visual feedback about whether the user needs to take action.

State Definitions

• Working: Claude is actively processing (recent activity within 5s)
• Compacting: Working after significant context reduction
• NeedsInput: User’s turn - either permission needed or awaiting next message
• Stale: No activity for extended period (>8 hours)

Key Insight

If Claude isn’t actively generating or running a tool with recent activity, the session needs user input. Tool execution without updates likely means Claude is waiting for user confirmation (“Do you want to proceed?”).

Variants

Working

Actively processing with recent activity

Compacting

Working after context reduction (compaction detected)

NeedsInput

Waiting for user input or permission (blocked, urgent)

Idle

Idle - no recent activity but not stale (relaxed, non-urgent)

Stale

No activity for extended period (>8 hours)

Implementations

impl DisplayState

pub fn label(&self) -> &'static str

Returns the display label for this state.

pub fn icon(&self) -> &'static str

Returns the ASCII icon for this state.

Uses ASCII characters for terminal compatibility:

• > Working (active indicator)
• ~ Compacting (context shrinking)
• ! NeedsInput (attention needed)
• - Idle (relaxed, waiting)
• z Stale (sleeping)

pub fn description(&self) -> &'static str

Returns a description of this state.

pub fn should_blink(&self) -> bool

Returns true if this state should blink in the UI.

Only truly urgent/blocked states blink:

• NeedsInput: Blocked, waiting for permission (urgent)

States that do NOT blink:

• Idle: Relaxed “waiting for user” state
• Stale: Old session, low priority, doesn’t need attention

pub fn from_session( time_since_activity_secs: i64, status: &SessionStatus, context_percentage: f64, previous_context_percentage: Option<f64>, ) -> Self

Determines display state from session data.

Algorithm

1. Stale check: >8 hours idle → Stale
2. Permission check: waiting for permission → NeedsInput (urgent, blocked)
3. Explicit Thinking/RunningTool status → Working (trust these regardless of activity)
4. Generic Active status with recent activity (<5s) → Working/Compacting
5. Generic Active status without recent activity → Idle (relaxed, non-urgent)
6. Otherwise → Idle

Arguments

• time_since_activity_secs - Seconds since last activity
• status - Current session status
• context_percentage - Current context usage percentage
• previous_context_percentage - Previous context percentage for compaction detection

Trait Implementations

impl Clone for DisplayState

fn clone(&self) -> DisplayState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DisplayState

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

Formats the value using the given formatter.

impl Default for DisplayState

fn default() -> DisplayState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DisplayState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for DisplayState

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

Formats the value using the given formatter.

impl PartialEq for DisplayState

fn eq(&self, other: &DisplayState) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for DisplayState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for DisplayState

impl Eq for DisplayState

impl StructuralPartialEq for DisplayState