Struct AgentWire 

pub struct AgentWire {

    pub slot: SessionSlot,
    pub label: String,
    pub lifecycle: SessionLifecycleState,
    pub heal_attempt: Option<u32>,
    pub heal_attempts: Option<u32>,
    pub has_background_work: bool,
    pub pending: Option<PendingInteractionKind>,
    pub pending_depth: usize,
    pub pending_seq: u64,
    pub last_activity: Option<SystemTime>,
    pub reason: Option<String>,
    pub failed_turn: Option<SystemTime>,
    pub died: bool,
    pub tree: Option<String>,
    pub work: Option<WorkState>,
}

One seat’s row: the surface’s own AgentRow, plus the read that is per SEAT rather than per project.

A home row is a seat, and its where cell is that seat’s own working tree. ProjectWire::work cannot answer it - that read is the project’s own path from the lead’s seat - so a worker row drew the project’s branch, and on a fleet with workers in worktrees that is eight rows reading main.

The fields are spelled out rather than the row being carried whole, so a field added to AgentRow has to be carried here deliberately rather than reaching a client by accident.

Fields

slot: SessionSlot

label: String

lifecycle: SessionLifecycleState

heal_attempt: Option<u32>

Which heal attempt is next while the seat is Restarting; None for every other lifecycle.

heal_attempts: Option<u32>

How many restarts a heal may make, so the row can say “1 of 3”.

has_background_work: bool

pending: Option<PendingInteractionKind>

pending_depth: usize

pending_seq: u64

The ask’s identity: how many asks have ever arrived for the seat. A client announces a new ask by this number, so a re-read is not news and an ask replacing another is.

last_activity: Option<SystemTime>

reason: Option<String>

failed_turn: Option<SystemTime>

When the seat’s newest turn ended in failure, filtered by what has been shown: None once the seat has been shown since the failure, or while it is being shown now.

died: bool

Whether a session on the seat ended and no reader has been shown it since: the row’s failure is the durable trace of a crash nobody watched.

tree: Option<String>

The seat’s own tree as a NAME, home-shortened, when the worker runs somewhere other than its project’s directory: the fact the row’s where cell says. None for a seat in its project’s own tree.

work: Option<WorkState>

The same tree’s STATE - branch, changed count, gate - None for a seat forge holds no directory for.

Read through the same shared cache the project rows use, so a lead’s tree is one read drawn twice rather than two reads.

Trait Implementations

impl<'de> Deserialize<'de> for AgentWire

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&AgentRow> for AgentWire

fn from(row: &AgentRow) -> Self

Converts to this type from the input type.

impl Serialize for AgentWire

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

where __S: Serializer,

Serialize this value into the given Serde serializer.