Module facade 

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

Mirrors crate::mcp::browser::facade: the Tool impls hold an Arc<dyn TerminalFacade> so their tests drive a MockTerminalFacade instead of a live PTY.

Re-exports

use std::path::PathBuf; 🔒

use std::sync::Arc; 🔒

use std::time::Duration; 🔒

use async_trait::async_trait; 🔒

use forge_primitives::SessionSlot; 🔒

use forge_primitives::browser::HandOffEnding; 🔒

use forge_primitives::browser::HandOffSource; 🔒

use forge_primitives::terminal::TerminalExit; 🔒

use forge_primitives::terminal::TerminalState; 🔒

use forge_terminal::Key; 🔒

use tokio::time::Instant; 🔒

use tokio::time::timeout; 🔒

use crate::terminal::TerminalEntry; 🔒

use crate::terminal::wire_state; 🔒

use crate::workspace::Workspace; 🔒

Structs

CloseOnDrop 🔒

Closes a terminal when the run’s work is over, whatever path it took.

OpenAnswer

What terminal__open answers.

OpenRequest

What terminal__open asks for.

ProdTerminalFacade

Production impl: the workspace’s registry.

ReadAnswer

What terminal__read answers.

ResolveOnDrop 🔒

Resolves a parked hand-off when the awaiting handler goes - a session that died mid-wait, never a decision.

RunAnswer

What terminal__run answers.

WaitAnswer

What terminal__wait answers.

Enums

WaitUntil

What terminal__wait waits for.

Traits

TerminalFacade

The agent’s terminal, as one tool call sees it.

Functions

held_error 🔒

refusal_now 🔒

refuse_when_held 🔒

The screen and the PTY belong to the person while a hand-off is parked. Every tool that touches either is refused, so a parallel call or a subagent cannot read their typing or write into their prompt.

wait_exit 🔒

Wait for a command to finish: exact through the marks, the heuristic’s quiet prompt otherwise, and the shell’s own exit for either.

wait_pattern 🔒

Wait until the screen contains pattern.

wait_quiet 🔒

Wait until no output has arrived for the quiet window.

wait_ready 🔒

Wait until the shell has drawn something, so a typed command reaches a ready line editor rather than being buffered before its prompt exists.

Type Aliases

Blind 🔒

The seat a wait is polling, while it may be taken by the person - through a parked hand-off or through a client’s take-control. A wait that sees it owned stops rather than reading what they type.