Module terminal 

The terminal family: the seat’s own terminal, driven by bytes and keys.

The agent drives it like a human. There is no agent mode, no automation flag and no wrapper around the shell: text is typed as bytes, Enter is its own key, Ctrl-C is 0x03, and the shell sees an ordinary xterm-256color terminal. Nothing the terminal adds says an agent is behind the keys.

The family is any-caller and it is always on. The terminal is one per seat on the machine, not a scope like reviews or crons, so every session may drive its own. No approval gate: Bash through the CLI already reaches the shell here. The one thing gated is the person’s input, through a hand-off or their own take-control of the raised surface.

Re-exports

use std::sync::Arc; 🔒

use forge_primitives::SessionSlot; 🔒

use forge_primitives::browser::HandOffEnding; 🔒

use forge_sdk::mcp::server::McpServerBuilder; 🔒

use forge_sdk::mcp::tool::Tool; 🔒

use forge_sdk::mcp::tool::ToolInput; 🔒

use forge_sdk::mcp::tool::ToolOutput; 🔒

use forge_sdk::mcp::tool::ToolOutputBlock; 🔒

use forge_terminal::Key; 🔒

use serde_json::Value; 🔒

use crate::mcp::terminal::facade::OpenRequest; 🔒

use crate::mcp::terminal::facade::TerminalFacade; 🔒

use crate::mcp::terminal::facade::WaitUntil; 🔒

Modules

facade

The narrow surface the terminal tools call: the seat’s terminal, driven by bytes and keys and read as text.

Structs

Registered 🔒

One registered tool, plus the caller it acts for.

Enums

TerminalTool 🔒

One tool of the family.

Constants

DEFAULT_MAX_BYTES 🔒

DEFAULT_MAX_LINES 🔒

The most lines and bytes one read returns unless the caller asks for less.

DEFAULT_TIMEOUT_MS 🔒

The longest a wait or a run may hold before it answers unmatched.

Functions

add_tools 🔒

Attach the terminal tools to an existing builder.

optional_string 🔒

optional_u16 🔒

optional_u64 🔒

optional_usize 🔒

parse_keys 🔒

parse_until 🔒

required_u16 🔒