Struct PtyShell 

pub struct PtyShell {
    pub last_command: String,
    pub output_buffer: String,
    pub command_running: bool,
    pub output_truncated: bool,
    pub line_ring: VecDeque<String>,
    pub last_returned_hash: Option<u64>,
    pub attach_hint: Option<String>,
    /* private fields */
}

Real PTY-based interactive shell

Uses portable-pty for true pseudo-terminal functionality, enabling proper handling of interactive programs like sudo, vim, etc.

Fields

last_command: String

Last command executed

output_buffer: String

Accumulated output buffer

command_running: bool

Whether a command is currently running

output_truncated: bool

Flag for output truncation

line_ring: VecDeque<String>

Rolling buffer of fully-emitted lines for opt-in scrollback. The newest line is at the back; capped at RING_BUFFER_LINES.

last_returned_hash: Option<u64>

Hash of the last rendered output we shipped to the caller. Used by the delta path in status_check to elide repeats when the screen is idle.

attach_hint: Option<String>

Optional command a human can run to attach to the same terminal session.

Implementations

impl PtyShell

pub fn new(initial_dir: &Path, restricted_mode: bool) -> Result<Self>

Create a new PTY shell session

Arguments

• initial_dir - Starting directory for the shell
• restricted_mode - Whether to use bash restricted mode (-r)

Returns

A new PtyShell instance with an active bash session

pub fn clear_to_run(&mut self, max_wait_secs: f32) -> Result<bool>

Drain any pending output and, if a previous command still seems to be running, send a Ctrl-C to flush it. Mirrors wcgw’s clear_to_run so a new command never inherits stale prompt fragments or a half-typed line.

Returns true if the shell looks idle (prompt seen), false if it still wouldn’t yield after the Ctrl-C — caller may want to reset.

pub fn send_command(&mut self, command: &str) -> Result<()>

Send a command to the shell and start reading output

pub fn collect_scrollback(&self, lines: usize) -> String

Return up to lines recent lines from the ringbuffer, oldest first. Includes any in-flight partial line.

pub fn fingerprint(text: &str) -> u64

Hash arbitrary rendered output into a u64 dedup key.

pub fn read_output(&mut self, timeout_secs: f32) -> Result<(String, bool)>

Read output from the PTY with timeout

Returns (output, is_complete) tuple where is_complete indicates whether the command has finished (prompt detected)

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

Send Ctrl+C (interrupt) to the PTY

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

Send Ctrl+D (EOF) to the PTY

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

Send Ctrl+Z (suspend) to the PTY

pub fn send_text(&mut self, text: &str) -> Result<()>

Send text directly to the PTY (for interactive input)

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

Send raw bytes directly to the PTY.

pub fn send_special_key(&mut self, key: &str) -> Result<()>

Send a special key sequence

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

Resize the terminal

pub fn get_size(&self) -> (u16, u16)

Get current terminal size

pub fn is_alive(&mut self) -> bool

Check if the shell is still alive

Trait Implementations

impl Debug for PtyShell

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

Formats the value using the given formatter.