Module shell 

Interactive PTY-based shell sessions for agents.

Provides three tools: shell_start, shell_send, shell_end that let agents drive persistent interactive terminal sessions (SSH, REPLs, debuggers, etc).

Modules

config

Shell session configuration — re-exported from core::shell_config. All existing paths (tools::shell::config::ShellConfig) remain valid.

pty

PTY abstraction — spawn processes on a pseudo-terminal, async read/write.

readiness

Output readiness detection — determines when a shell is waiting for input.

session

Session manager — owns and manages active shell sessions.

Structs

SendResult

Result of sending input to a session.

SessionManager

Thread-safe manager for all active shell sessions.

SessionOpts

Options for creating a new session.

ShellConfig

Configuration for interactive shell sessions.

ShellEndTool

ShellSendTool

ShellStartTool

Functions

start_reaper

Spawn a background task that periodically reaps idle sessions.