Module lifecycle 

Lifecycle module — agent lifecycle management.

Provides AgentHandle, AgentSupervisor, and SnapshotStore for spawn / suspend / resume / checkpoint / terminate operations.

Module layout

File	Responsibility
mod.rs	AgentStatus, AgentLifecycleEvent, MetricsSnapshot, re-exports
supervisor.rs	AgentSupervisor, SupervisorPolicy, RestartBackoff, AgentHandle
snapshot.rs	AgentSnapshot, ToolManifest, SnapshotStore, FileSnapshotStore

Re-exports

pub use hub::HubKind;

pub use hub::HubStatus;

pub use crate::metrics::MetricsSnapshot;

Modules

hub

Display metadata for the Agent Hub overlay (advisor + subagent monitoring). Kept separate from supervisor.rs (lifecycle state machine) so display concerns don’t pollute the supervisor API.

Structs

AgentHandle

Agent execution handle returned by AgentSupervisor::spawn().

AgentPool

Pool of live Agent instances keyed by string ID.

AgentSnapshot

A complete snapshot of an agent at a point in time.

AgentSupervisor

Manages a pool of agents with lifecycle operations.

FileSnapshotStore

Snapshot store backed by the local filesystem.

SubagentCoordinator

Subagent coordinator.

SubagentSpawnRequest

Inputs to SubagentCoordinator::spawn.

SubagentTracker

Per-subagent tracker — exposes cancellation and completion polling.

SupervisorPolicy

Supervisor restart policy.

ToolManifest

A serializable manifest of tools registered in an agent.

Enums

AgentLifecycleEvent

Events emitted during agent lifecycle transitions.

AgentStatus

Lifecycle status of an agent.

RestartBackoff

Restart backoff strategy.

SubagentCoordinatorError

Coordinator error.

SubagentState

One subagent’s lifecycle state.

Constants

DEFAULT_MAX_SUBAGENT_DEPTH

Default ceiling on subagent nesting depth.

Traits

SnapshotStore

Trait for persisting and retrieving agent snapshots.