Module shell_sessions 

PTY-backed reusable interactive shell sessions. PTY-backed shell sessions for reusable agent execution and interactive terminals.

This module manages two related session types:

• automation sessions used by the agent for reusable shell execution
• interactive sessions used by the GUI terminal manager for real typing

Structs

ShellExecutionOptions

Execution policy for PTY-backed shell commands.

ShellSessionHandle

Public summary for a managed PTY shell session.

ShellSessionMetadata

Public metadata for a managed PTY shell session.

Functions

claim_session

Claim a PTY shell session for direct user management.

create_session

Start a long-lived interactive PTY shell session immediately.

describe_session

Describe a PTY shell session for frontend/UI enrichment.

execute_in_session

Execute a shell command inside a reusable PTY-backed session.

execute_in_session_with_options

Execute a shell command inside a reusable PTY-backed session with an explicit policy.

resize_session

Resize a PTY shell session to the given column and row dimensions.

send_input

Send raw input bytes to a PTY shell session.

shutdown_session

Shut down all PTY-backed shell sessions associated with a pool key.

stop_process

Stop an active PTY-managed command by its command run id.

stop_session

Stop and remove a long-lived PTY shell session.

subscribe_session

Subscribe to lifecycle/output events for an existing PTY shell session.