Struct PtyManager 

pub struct PtyManager { /* private fields */ }

The shared PTY session registry + lifecycle manager.

Implementations

impl PtyManager

pub fn new(config: Arc<RwLock<PtyConfig>>) -> Self

pub fn config_snapshot(&self) -> PtyConfig

Read-only snapshot of the current config.

pub fn is_enabled(&self) -> bool

Check if PTY subsystem is enabled.

pub fn new_id() -> PtySessionId

Generate a fresh session id (ULID-style: timestamp + random hex).

pub fn open( self: &Arc<Self>, principal: &str, shell: Option<String>, size: PtySize, ) -> Result<Arc<PtySession>, PtyError>

Open a new PTY session. Performs shell allowlist check and per-principal cap.

pub fn attach( self: &Arc<Self>, principal: &str, session_id: &str, ) -> Result<Arc<PtySession>, PtyError>

Re-attach an existing session by id. Validates principal match.

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

Write bytes to PTY stdin.

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

Resize the PTY.

pub fn try_clone_reader( &self, session_id: &str, ) -> Result<Box<dyn Read + Send>, PtyError>

Take the master reader for streaming to a WS client.

pub fn list_sessions(&self, principal: &str) -> Vec<PtySessionInfo>

List sessions for a principal.

pub fn mark_attached(&self, session_id: &str) -> bool

Transition a session to Attached (called by WS handler on Open).

pub fn mark_detached(&self, session_id: &str) -> bool

Mark a session as Detached (called by WS handler on Close).

pub fn close(&self, session_id: &str) -> Result<(), PtyError>

Close + remove a session.

pub fn gc_tick(&self)

GC tick — close idle / past-max-lifetime sessions.

pub fn start_gc(self: Arc<Self>) -> JoinHandle<()>

Spawn the GC tick task.