Struct PersistentShellTool 

pub struct PersistentShellTool { /* private fields */ }

A long-lived shell whose state (working directory, environment variables, shell functions) persists across calls — unlike the one-shot BashTool. Also supports write_stdin to feed raw input to the shell, for driving interactive programs. This is the analog of Codex’s persistent exec session.

Known limitation (documented, not fixed — see UX-29.md “Known limitations”): if a REPL turn is hard-cancelled (race_ctrl_c in crates/cli/src/main.rs) while execute() below is mid-.await waiting for the completion sentinel, only that .await is dropped — the child held in ShellState is untouched (by design: it must survive to serve the NEXT call in this REPL session) and keeps running the in-flight command to completion on its own schedule. The cancelled command’s eventual output (and sentinel line) still lands in the shared stdout pipe, so the next shell call in the same session can either block behind the stale command finishing or read a garbage prefix ahead of its own sentinel. This is no worse than the pre-existing hard-kill behavior this ticket replaced (which would have torn down the whole process), and the on-disk session file itself is unaffected — only the persistent shell’s own child-process state can go stale.

Trait Implementations

impl Default for PersistentShellTool

fn default() -> Self

Returns the “default value” for a type.

impl Tool for PersistentShellTool

fn name(&self) -> &str

Stable, unique tool name (what the model calls).

fn description(&self) -> &str

The built-in description. May be overridden via crate::Config.

fn parameters(&self) -> Value

JSON Schema describing the tool’s input object.

fn execute<'life0, 'life1, 'async_trait>( &'life0 self, args: Value, ctx: &'life1 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Run the tool. Returns text to feed back to the model.