Enum CtlRequest 

pub enum CtlRequest {
    List,
    Spawn {
        spec: SpawnSpec,
    },
    Attach {
        id: String,
    },
    Kill {
        id: String,
    },
    Respawn {
        id: String,
    },
    Rm {
        id: String,
        force: bool,
    },
    Status,
    Shutdown,
    Drain {
        grace_secs: u64,
    },
    ReportStatus {
        id: String,
        status: AgentStatus,
    },
}

Control-plane requests from the CLI / parent agent to the daemon.

Variants

List

List all registered agents.

Spawn

Register and start a new agent.

Fields

spec: SpawnSpec

Spec describing the agent to create.

Attach

Return the dedicated socket for an agent so the caller can attach.

Fields

id: String

Target agent.

Kill

Terminate an agent (SIGTERM, escalating to SIGKILL after the configured grace).

Fields

id: String

Target agent.

Respawn

Kill + re-spawn with the same spec.

Fields

id: String

Target agent.

Rm

Remove an agent from the registry (must already be stopped unless force is set).

Fields

id: String

Target agent.

force: bool

Force-remove even if the agent is still running.

Status

Daemon health probe.

Shutdown

Ask the daemon to mark itself for shutdown after the current in-flight requests complete.

Drain

Gracefully drain + checkpoint every live agent before teardown/pause (#650, ADR 0057): each live worker is SIGTERM’d (not SIGKILL’d) so it flushes and exits cleanly within grace_secs, and its session directory is returned as a resume reference. Distinct from Kill (abrupt, one agent). Used by the operator drain finalizer + idle-pause reconcile.

Fields

grace_secs: u64

Budget, in seconds, within which a worker is expected to flush and exit after SIGTERM (the graceful window; no forced SIGKILL here).

ReportStatus

A worker reports a lifecycle transition (Running <-> Idle) for itself.

Fields

id: String

Reporting agent.

status: AgentStatus

New status (only Running/Idle are honored; see registry guard).

Trait Implementations

impl Clone for CtlRequest

fn clone(&self) -> CtlRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CtlRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CtlRequest

fn deserialize<__D>( __deserializer: __D, ) -> Result<CtlRequest, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CtlRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.