Struct BgTaskSnapshot 

pub struct BgTaskSnapshot {
    pub task_id: u32,
    pub agent_name: String,
    pub prompt: String,
    pub age: Duration,
    pub status: AgentStatus,
    pub spawner: Option<u32>,
}

Snapshot of a pending bg-agent task — what /agents and the ListBackgroundTasks LLM tool will render.

Cloned out of the registry under the lock so callers can format/display without holding it. age is computed from started_at at snapshot time.

Fields

task_id: u32

Monotonic id assigned at reserve() time. Stable for the lifetime of the task; reused across snapshots.

agent_name: String

Configured agent name (explore, verify, …).

prompt: String

The prompt the parent delegated. Surfaced verbatim by /agents -v; truncation is the renderer’s job.

age: Duration

Wall-clock duration since the task was attached. Computed at snapshot time, so successive snapshots of the same task report different ages.

status: AgentStatus

Latest value from the task’s watch::Receiver<AgentStatus>.

spawner: Option<u32>

Sub-agent task that spawned this bg-agent. None = top-level (the user’s main conversation).

#996 Layer 2 / Model D: tracked so that when a sub-agent exits, BgAgentRegistry::cancel_for_spawner can fire the cancel token on every bg-agent it left behind. Mirrors Claude Code’s agentId field on LocalShellTaskState (prevents 10-day fake-logs.sh zombies).

We don’t use this for permission scoping — any caller with a task_id can manage any task. Spawner is only a cleanup hook (matching Claude Code’s flat-permissions design).

Trait Implementations

impl Clone for BgTaskSnapshot

fn clone(&self) -> BgTaskSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BgTaskSnapshot

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

Formats the value using the given formatter.

impl PartialEq for BgTaskSnapshot

fn eq(&self, other: &BgTaskSnapshot) -> 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 Eq for BgTaskSnapshot

impl StructuralPartialEq for BgTaskSnapshot