Struct SessionHandle 

pub struct SessionHandle {
    pub task_id: String,
    pub session_id: Option<String>,
    pub events: Receiver<StreamEvent>,
    /* private fields */
}

Handle to a running headless session

Fields

task_id: String

Task ID this session is for

session_id: Option<String>

Harness session ID (for continuation)

events: Receiver<StreamEvent>

Event receiver

Implementations

impl SessionHandle

pub fn from_child( task_id: String, child: Child, events: Receiver<StreamEvent>, ) -> Self

Create a SessionHandle backed by a child process

pub async fn wait(self) -> Result<bool>

Wait for the session to complete

pub fn interrupt(&mut self) -> Result<()>

Interrupt the session (send SIGINT)

pub fn kill(&mut self) -> Result<()>

Kill the session immediately

pub fn into_parts(self) -> (Receiver<StreamEvent>, SessionProcess)

Decompose the session into its event receiver and a killable process handle.

This allows the caller to own the events stream and process separately, e.g. for bridging events to a different channel while retaining the ability to kill the subprocess on cancellation.

pub fn pid(&self) -> Option<u32>

Get the process ID