Struct Session 

pub struct Session {
    pub id: SessionId,
    pub command: String,
    pub created_at: DateTime<Utc>,
    /* private fields */
}

Session state

Fields

id: SessionId

command: String

created_at: DateTime<Utc>

Implementations

impl Session

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

Get process ID

pub fn is_running(&mut self) -> bool

Check if process is running

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

Get terminal size

pub fn update(&mut self) -> Result<(), SessionError>

Process any pending PTY output and update the terminal

pub fn screen_text(&self) -> String

Get screen text

pub fn screen_buffer(&self) -> ScreenBuffer

Get screen buffer with style data

pub fn cursor(&self) -> CursorPosition

Get cursor position

pub fn detect_elements(&mut self) -> &[Element]

Detect elements and cache them

pub fn elements(&self) -> &[Element]

Get cached elements

pub fn find_element(&self, element_ref: &str) -> Option<&Element>

Find element by ref

pub fn keystroke(&self, key: &str) -> Result<(), SessionError>

Send a keystroke

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

Hold a modifier key down

This tracks the modifier state for subsequent keystrokes. In PTY terminals, modifier keys don’t have separate “down” events - they’re combined with other keys. This method allows sequences like: keydown(“Shift”) -> click(@item1) -> click(@item2) -> keyup(“Shift”)

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

Release a held modifier key

pub fn type_text(&self, text: &str) -> Result<(), SessionError>

Type text

pub fn click(&mut self, element_ref: &str) -> Result<(), SessionError>

Click an element (move cursor and press Enter/Space)

pub fn fill( &mut self, element_ref: &str, value: &str, ) -> Result<(), SessionError>

Fill an input with a value

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

Resize the terminal

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

Kill the session

pub fn pty_write(&self, data: &[u8]) -> Result<(), SessionError>

Write raw bytes to the PTY

pub fn pty_try_read( &self, buf: &mut [u8], timeout_ms: i32, ) -> Result<usize, SessionError>

Read from PTY with timeout (for attach mode)

pub fn pty_reader_fd(&self) -> RawFd

Get the PTY reader file descriptor (for polling in attach mode)

pub fn start_recording(&mut self)

Start recording

pub fn stop_recording(&mut self) -> Vec<RecordingFrame>

Stop recording and return captured frames

pub fn recording_status(&self) -> RecordingStatus

Get recording status

pub fn capture_frame(&mut self)

Capture a recording frame if recording is active

pub fn start_trace(&mut self)

Start tracing

pub fn stop_trace(&mut self)

Stop tracing

pub fn is_tracing(&self) -> bool

Check if tracing is active

pub fn add_trace_entry(&mut self, action: &str, details: Option<&str>)

Add a trace entry

pub fn get_trace_entries(&self, count: usize) -> Vec<TraceEntry>

Get recent trace entries

pub fn add_error(&mut self, message: &str, source: &str)

Add an error entry

pub fn get_errors(&self, count: usize) -> Vec<ErrorEntry>

Get recent errors

pub fn error_count(&self) -> usize

Get total error count

pub fn clear_errors(&mut self)

Clear all errors

pub fn clear_console(&mut self)

Clear console (resets terminal screen buffer)