Struct ExecSessionManager 

pub struct ExecSessionManager { /* private fields */ }

Implementations

impl ExecSessionManager

pub fn new(workspace_root: PathBuf, pty_sessions: PtySessionManager) -> Self

pub fn subscribe_completion(&self) -> Receiver<ExecSessionCompletionEvent>

Subscribe to confirmed terminal transitions for background exec sessions.

pub fn completion_notify(&self) -> Arc<Notify>

Wake an idle interaction loop when a background exec session completes.

pub async fn background_session_snapshot( &self, session_id: &str, ) -> Result<ExecSessionUiSnapshot>

Return one retained background session snapshot for the Local Agents drawer.

pub async fn background_session_snapshots(&self) -> Vec<ExecSessionUiSnapshot>

Return all background raw command sessions, including exited sessions that have not been explicitly closed.

pub async fn send_input_to_session( &self, session_id: &str, data: &[u8], append_newline: bool, ) -> Result<usize>

pub async fn is_session_completed( &self, session_id: &str, ) -> Result<Option<i32>>

pub async fn terminate_session(&self, session_id: &str) -> Result<()>

pub async fn force_terminate_session(&self, session_id: &str) -> Result<()>

pub async fn close_session(&self, session_id: &str) -> Result<VTCodeExecSession>

pub async fn close_session_with_mode( &self, session_id: &str, mode: PtyCloseMode, ) -> Result<VTCodeExecSession>

Close with an explicit termination mode. Immediate is reserved for exit-driven teardown: it skips the exit\n courtesy and the SIGTERM grace window so a live PTY child cannot cost ~600 ms of shell-return latency per session. The OS reaps survivors at process exit.

pub async fn force_terminate_or_close(&self, session_id: &str) -> Result<bool>

Force-stop an active session, or close it when it has already exited. Returns true when the session was already complete and was closed.

pub async fn focus_background_session(&self, session_id: &str) -> Result<()>

Focus a running background session so subsequent submitted lines are written to its stdin instead of becoming a model prompt.

pub fn focused_session_id(&self) -> Option<String>

Return the focused background session, if any.

pub fn clear_focused_session(&self)

pub async fn force_cancel_foreground_sessions(&self) -> (usize, usize, usize)

Force-stop every foreground exec session and close it. Used by the TUI ForceCancel escape hatch so a stuck PTY cannot keep the composer locked. Closing after the kill is intentional: force_terminate_or_close alone leaves live sessions attached (“remains visible until closed”), which would keep the foreground counter elevated. Background sessions are user-owned and are left alone. Returns (stopped, closed, failed) counts where stopped are live kills and closed are already-exited sessions removed from the map.

pub fn active_background_processes(&self) -> usize

Return the number of currently live background process reservations.

pub fn request_foreground_background(&self) -> Option<BackgroundShortcutResult>

Request that the current foreground session be promoted to background.

The request is synchronous because it is called by the TUI key-event callback. The execution wait loop consumes the request asynchronously and performs the metadata transition without killing the process.

pub fn take_background_shortcut_result( &self, ) -> Option<BackgroundShortcutResult>

Consume the result associated with the queued Ctrl+B event.

Trait Implementations

impl Clone for ExecSessionManager

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.