Struct AgentInfo 

pub struct AgentInfo {
    pub id: String,
    pub agent: String,
    pub project: String,
    pub tmux_session: String,
    pub state: AgentState,
    pub unread_mail: u32,
    pub pending_approvals: u32,
    pub is_manager: bool,
    pub display_name: Option<String>,
    pub rate_limit_resets_at: Option<f64>,
    pub last_activity_at: Option<f64>,
    pub reports_to: Option<String>,
}

Per-agent fields the UI reads to render the roster + drive selection / detail-pane streaming.

Fields

id: String

<project>:<agent> — the canonical id used in teamctl send targets, MCP tool calls, and reports_to chains.

agent: String

Short agent name within the project (the YAML key).

project: String

Project id this agent belongs to.

tmux_session: String

Resolved tmux session name (<prefix><project>-<agent>) — fed to the pane-capture call so the detail pane targets the right session even when tmux_prefix rotates.

state: AgentState

Process state — Running, Stopped, or Unknown per the supervisor trait. Drives the primary glyph in the roster.

unread_mail: u32

Count of mailbox messages addressed to this agent that haven’t been ack’d yet. Sourced from the mailbox DB. No longer drives a roster glyph (the ✉ unread glyph was dropped in #429); retained for future unread surfacing.

pending_approvals: u32

Count of request_approval rows still in pending state for this agent. Surfaces the ! glyph when nonzero (highest priority — overrides the process-state glyph).

is_manager: bool

true for managers (is_manager: true in compose), used when the roster wants to draw a tier separator. Read but unused in PR-UI-2; kept on the struct so PR-UI-4’s approvals modal can route based on tier without a second compose lookup.

display_name: Option<String>

T-160: optional human-friendly label from team-compose.yaml. When Some, the TUI renders this in place of id everywhere an agent label surfaces to the operator (roster, detail header, mailbox attribution, statusline, approvals, compose modal). When None, label falls back to id. The id stays canonical for routing/tmux/CLI.

rate_limit_resets_at: Option<f64>

T-212: most recent rate-limit reset timestamp (unix epoch seconds) for this agent, sourced from the rate_limits table populated by teamctl rl-watch. None when rl-watch has never recorded a resets_at for this agent. The TUI status bar formats this against now() via format_rate_limit_window to render “5m 12s” / “1h 23m” — past timestamps render as None (no active limit).

last_activity_at: Option<f64>

#428: unix epoch seconds of this agent’s activity-heartbeat marker mtime (see team_core::render::heartbeat_path), or None when the marker is absent — the agent has done nothing since boot, or is a non-claude runtime that gets no heartbeat hooks. The agent is Working when this is fresh within HEARTBEAT_FRESH_SECS (see is_working), else Idle — a UI sub-state of Running. #429 (C2b) renders the working/idle glyph from it.

reports_to: Option<String>

T-211: short agent name (the YAML key in the manager’s project) this agent reports to. None for top-level agents (no parent) — they render at depth 0 in the Agents pane. When Some, the renderer nests this row under its manager with a tree glyph. Schema validation (team-core/src/validate.rs) guarantees the referenced name resolves to an existing agent.

Trait Implementations

impl Clone for AgentInfo

fn clone(&self) -> AgentInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentInfo

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

Formats the value using the given formatter.