Struct PTYSession 

pub struct PTYSession {
    pub id: String,
    pub slot_id: String,
    pub cwd: PathBuf,
    pub cols: u16,
    pub rows: u16,
    /* private fields */
}

Interactive PTY session for Claude Code

Manages a single Claude Code process with terminal emulation, state detection, and streaming text extraction.

Fields

id: String

Unique session ID

slot_id: String

Slot ID this session belongs to

cwd: PathBuf

Working directory

cols: u16

Terminal dimensions

rows: u16

Implementations

impl PTYSession

pub fn new(options: PTYSessionOptions) -> Result<Self>

Create a new PTY session

pub async fn state(&self) -> SessionState

Get current state

pub async fn history(&self) -> Vec<Message>

Get chat history

pub fn is_running(&self) -> bool

Check if session is running

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

Get process ID

pub async fn pending_tool_confirm(&self) -> Option<ConfirmInfo>

Get pending tool confirmation

pub async fn terminal_title(&self) -> String

Get terminal title

pub async fn get_screen_text(&self) -> String

Get current screen text

pub async fn get_last_lines(&self, n: usize) -> Vec<String>

Get last N lines

pub async fn start(&mut self) -> Result<()>

Start the PTY session

pub async fn write(&self, data: &str) -> Result<()>

Write data to PTY

pub async fn send(&self, message: &str, timeout_ms: u64) -> Result<String>

Send message and wait for response

pub async fn confirm(&self, response: ConfirmResponse) -> Result<()>

Send confirmation response

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

Send interrupt (Ctrl+C)

pub async fn set_permission_check<F>(&self, callback: F)

where F: Fn(&ConfirmInfo) -> PermissionDecision + Send + Sync + 'static,

Set permission check callback

pub fn subscribe(&self) -> Receiver<SessionEvent>

Subscribe to session events

pub fn subscribe_state_changes(&self) -> Receiver<(SessionState, SessionState)>

Subscribe to state changes

pub async fn wait_for_state( &self, target: SessionState, timeout_duration: Duration, ) -> Result<()>

Wait for specific state

pub async fn close(&mut self) -> Result<()>

Close session gracefully

pub async fn kill(&mut self)

Force kill session