Struct SidecarManager 

pub struct SidecarManager { /* private fields */ }

Supervises one sidecar process and its line-JSON streams.

Construct via SidecarManager::spawn; drive with [press], [release], [shutdown]. Receive events with [next_event].

Implementations

impl SidecarManager

pub async fn spawn( bin: &Path, args: &[String], config: Value, ) -> Result<Self, SidecarError>

Spawn bin with args, wait for Hello, send Init, and start the background reader task. Hello is readiness; no post-Init status is required. Hello has a 10s deadline and command writes have a 2s deadline. Cancelling startup drops the child and reader tasks.

pub fn ready_after_init(&self) -> bool

Optional initialization contract. Without it Hello+Init is the legacy protocol-ready boundary, not proof that model/device loading finished.

pub fn try_next_event(&mut self) -> Option<SidecarLifecycleEvent>

Nonblocking drain for hosts about to publish readiness or activate.

pub async fn press(&mut self) -> Result<(), SidecarError>

Send a trigger press command.

pub async fn release(&mut self) -> Result<(), SidecarError>

Send a trigger release command.

pub async fn shutdown(&mut self) -> Result<(), SidecarError>

Send a graceful shutdown command and reap the child process. A write error is returned only after cleanup; an already closed input still permits cleanup and repeated shutdown calls.

pub async fn next_event(&mut self) -> Option<SidecarLifecycleEvent>

Receive the next high-level event, or None if the channel closed (sidecar exited and reader task drained).

Trait Implementations

impl Drop for SidecarManager

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.