#[non_exhaustive]pub struct SubagentRosterEntry {Show 15 fields
pub subagent_id: String,
pub child_session_id: Option<String>,
pub agent_path: String,
pub name: Option<String>,
pub definition_name: Option<String>,
pub parent_path: Option<String>,
pub parent_subagent_id: Option<String>,
pub depth: u32,
pub role: Option<String>,
pub objective: Option<String>,
pub workflow_run_id: Option<String>,
pub control_status: SubagentControlStatus,
pub result_ready: bool,
pub terminal_reason: Option<String>,
pub duration_ms: Option<u64>,
}Expand description
One roster row: a durable child’s identity, place, and state, projected
from its control records. Rows carry no result content — the transcript
stays on the child session / subagent/readResult.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.subagent_id: StringThe durable child identity (subagent_id). Rows without one are not
roster rows: a rejected spawn names no child.
child_session_id: Option<String>The child’s own session id, readable via session/read/view/page.
Additive-optional: absent until the child’s start is attested.
agent_path: StringThe agent definition path (agent_path), verbatim from the spawn.
name: Option<String>The child’s display name: the spawn description, falling back to
the spawn role. Additive-optional: absent when neither carries
one; never parsed from agentPath.
definition_name: Option<String>The granted definition’s name (definition_grant_audit
definition_name). Additive-optional: absent on spawns without
a grant audit (historical records). The resolved definition id is
not persisted on the spawn record, so the name is what the roster
can truthfully carry.
parent_path: Option<String>The parent row’s agentPath. Additive-optional: absent whenever
parentSubagentId is.
parent_subagent_id: Option<String>The parent’s subagentId: the roster row whose child session issued
this child’s spawn. Additive-optional: absent when the parent is
the root session, or when the parent row is not in the roster or not
yet attested — never guessed, never derived from agentPath.
depth: u32The spawn depth (1 = a root-session child).
role: Option<String>The spawn role. Additive-optional: absent when the spawn carried none.
objective: Option<String>The spawn objective. Additive-optional: absent when the spawn carried none.
workflow_run_id: Option<String>The owning dynamic workflow run id, when the child was workflow-admitted. Additive-optional: absent for native spawns.
control_status: SubagentControlStatusThe child’s control status: Accepted at spawn, then the latest
StatusUpdated / Closed / ResultReady / RecoveryAvailable /
RecoveryDecision (Accepted | Starting | Running | ResultReady | Closing | Closed | RecoveryPending | ManualReconciliation).
result_ready: boolWhether the child’s latest attempt’s result is ready (a
ResultReady for the latest admitted attempt seen).
terminal_reason: Option<String>The terminal reason: the result envelope’s errorKind when present,
else the cancel outcome’s reason. Additive-optional: absent on
live rows and on terminals that carry no reason — never fabricated
from the close outcome’s status word.
duration_ms: Option<u64>The child’s observed wall-clock duration in ms, when the runtime observed one. Additive-optional: absent until first observation.