Struct BackgroundShellManager 

pub struct BackgroundShellManager { /* private fields */ }

Manages background shell sessions - matches WCGW Python’s background_shells dict

Implementations

impl BackgroundShellManager

pub fn new() -> Self

Create a new background shell manager

pub fn register_shell( &mut self, owner_thread_id: &str, shell: PtyShell, ) -> Result<String>

Start a new background shell and return its command ID Register an already-built shell and return its id.

The caller builds the PtyShell BEFORE taking the manager lock — PtyShell::new forks+execs and does a ~300ms blocking prompt init, which must not run under the global std::Mutex (it would serialize every other background-shell op behind one slow spawn).

pub fn get_shell( &self, owner_thread_id: &str, bg_command_id: &str, ) -> Option<SharedPtyShell>

Get a background shell by its command ID

pub fn remove_shell(&mut self, bg_command_id: &str) -> bool

Remove and cleanup a background shell

pub fn peek_tombstone( &self, owner_thread_id: &str, bg_command_id: &str, ) -> Option<ExitedShellInfo>

Look up the tombstone for a recently-exited shell, if any.

The entry stays in the map until the TTL expires (see prune_finished_shells), so repeated status_check calls on the same bg_command_id keep returning the cached final output instead of flipping to “shell not found” after the first read.

pub fn ids_for(&self, owner_thread_id: &str) -> Vec<String>

Get info about all running background shells - matches WCGW Python get_bg_running_commandsinfo Ids of the live background shells owned by owner_thread_id, sorted for stable output. Read-only: finished shells are not pruned here.

pub fn get_running_info(&mut self, owner_thread_id: &str) -> String

Trait Implementations

impl Debug for BackgroundShellManager

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BackgroundShellManager

fn default() -> Self

Returns the “default value” for a type.