Struct AgentHandle 

pub struct AgentHandle {
    pub process_id: ProcessId,
    pub provider: Provider,
    /* private fields */
}

Handle to a spawned agent process

Fields

process_id: ProcessId

Process ID

provider: Provider

Provider configuration

Implementations

impl AgentHandle

pub fn process_id(&self) -> ProcessId

Get the process ID

pub async fn is_healthy(&self) -> bool

Check if the agent is healthy

pub fn health_status(&self) -> HealthStatus

Get the last health status

pub fn output_capture(&self) -> &OutputCapture

Get the output capture handle

pub fn subscribe_output(&self) -> Receiver<OutputEvent>

Subscribe to live output events via broadcast channel.

Returns a receiver that gets a clone of every output event, suitable for streaming to WebSocket clients.

pub async fn shutdown( &mut self, grace_period: Duration, ) -> Result<bool, SpawnerError>

Graceful shutdown: SIGTERM, wait for grace_period, then SIGKILL if still alive.

Returns Ok(true) if the process exited gracefully, Ok(false) if it required a SIGKILL, or Err on I/O failure.

pub async fn kill(self) -> Result<(), SpawnerError>

Hard kill the agent process (immediate SIGKILL).

pub fn try_wait(&mut self) -> Result<Option<ExitStatus>, SpawnerError>

Check if the process has exited (non-blocking).

Trait Implementations

impl Debug for AgentHandle

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

Formats the value using the given formatter.