Struct PtySession 

pub struct PtySession { /* private fields */ }

A live PTY-managed child plus its output drainer. The owner (a worker process under Outcome B) holds this for the child’s lifetime.

Implementations

impl PtySession

pub fn spawn( cmd: CommandBuilder, rows: u16, cols: u16, ring_bytes: usize, ) -> Result<PtySession, PtyError>

Spawn cmd on a fresh PTY of rowsxcols with an output ring of ring_bytes, and start the drainer thread.

pub fn drain_outcome(&self) -> DrainOutcome

Why the drainer stopped (or DrainOutcome::Running if still draining). The daemon turns an Errored outcome into a pty_drainer_errored event.

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

PID of the spawned child, if the platform reported one.

pub fn write_input(&self, bytes: &[u8]) -> Result<(), PtyError>

Write bytes to the child’s stdin (PTY master). The caller is responsible for any envelope wrapping (non-Claude providers).

pub fn resize(&self, rows: u16, cols: u16) -> Result<(), PtyError>

Resize the PTY (drive resize handshake, terminal change).

pub fn snapshot(&self) -> Vec<u8>

Snapshot the current ring contents (oldest-to-newest).

pub fn dropped_bytes(&self) -> u64

Bytes dropped from the ring due to overflow.

pub fn read_since(&self, cursor: u64) -> ReadSince

Incrementally read PTY output appended after cursor (drive streaming). See BoundedRing::read_since. A poisoned ring recovers in place rather than propagating a panic onto the drive output pump.

pub fn is_child_alive(&self) -> bool

True if the child has not yet exited.

On a poisoned child mutex this returns true (assume alive), NOT false: the primary consumer is Drop, which kills the child only when this reports alive. Reporting false on poison would skip the kill and leak a still-running child. Erring toward “alive” makes Drop attempt the (idempotent) kill instead.

pub fn wait(&self) -> Result<u32, PtyError>

Block until the child exits, returning its exit code (if known).

pub fn kill(&self) -> Result<(), PtyError>

Kill the child (SIGKILL-equivalent via portable-pty).

Trait Implementations

impl Drop for PtySession

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.