Struct MultiCliManager 

pub struct MultiCliManager { /* private fields */ }

Manages agent sessions for all CLIs simultaneously.

Internally uses a HashMap<InstanceId, AgentInstance>. Three legacy instances (one per AgentCli) are pre-created in new() so that all existing callers using the cli: AgentCli API continue to work unchanged.

Implementations

impl MultiCliManager

pub fn new(config: ManagerConfig) -> Self

Create a new manager with the given configuration.

pub fn create_instance( &mut self, cli: AgentCli, mode: InstanceMode, workdir: PathBuf, ) -> Result<InstanceId, String>

Register a new agent instance. Does NOT spawn any process.

All 6 CLIs support Chat mode via TransportSession (pipe/daemon).

pub async fn remove_instance(&mut self, id: InstanceId)

Stop and remove an instance from the manager.

pub async fn start_pty_instance( &mut self, id: InstanceId, config: SessionConfig, ) -> Result<(), String>

Start a PTY session for the given instance.

pub async fn write_pty_instance( &mut self, id: InstanceId, text: &str, ) -> Result<(), String>

Write a string to the active PTY for the given instance.

Lazy-spawns a PTY session on the first call.

pub async fn send_chat_instance( &mut self, id: InstanceId, prompt: &str, ) -> Result<(), String>

Send a chat prompt to the pipe session for the given instance.

Only valid if the instance mode is Chat. Lazy-spawns on first call.

pub async fn stop_instance(&mut self, id: InstanceId)

Stop the session for a single instance.

pub fn snapshot_instance(&self, id: InstanceId) -> Option<AgentRenderSnapshot>

Build a render snapshot for the given instance.

Returns None if the instance doesn’t exist. Otherwise builds a PTY or Chat snapshot based on the instance’s mode.

pub fn is_instance_active(&self, id: InstanceId) -> bool

Returns true if the instance is active.

pub fn list_instances(&self) -> Vec<InstanceId>

Returns all registered instance IDs.

pub fn instance_cli(&self, id: InstanceId) -> Option<AgentCli>

Returns the AgentCli for an instance.

pub fn instance_mode(&self, id: InstanceId) -> Option<InstanceMode>

Returns the InstanceMode for an instance.

pub fn instance_workdir(&self, id: InstanceId) -> Option<&Path>

Returns the working directory for an instance.

pub async fn resize_instance(&mut self, id: InstanceId, cols: u16, rows: u16)

Resize the PTY for a single instance.

pub fn load_latest_history_instance(&mut self, id: InstanceId) -> bool

Load the latest history for an instance. Chat-mode only.

pub fn clear_chat_instance(&mut self, id: InstanceId)

Clear chat messages for an instance, starting a fresh session (display only).

Stops the running transport session (if any) and wipes the message list. The next send_chat_instance will begin a brand-new CLI session.

pub fn list_past_sessions_instance(&self, id: InstanceId) -> Vec<SessionMeta>

List past sessions for an instance by its workdir (newest-first, live disk read).

pub fn load_history_instance( &mut self, id: InstanceId, session_id: &str, ) -> bool

Load a specific history session for an instance. Chat-mode only.

pub fn cli_workdir(&self, cli: AgentCli) -> PathBuf

Returns the working directory for a given CLI.

Each CLI runs isolated in {sessions_dir}/{cli_name}/ so its dotfolder (.claude/, .codex/, .gemini/) lives there.

pub async fn start_pty( &mut self, cli: AgentCli, config: SessionConfig, ) -> Result<(), String>

Start a PTY session for the given CLI.

pub async fn start_pipe( &mut self, cli: AgentCli, config: SessionConfig, prompt: &str, ) -> Result<(), String>

Start a Pipe/Chat session for the given CLI.

Deprecated: prefer send_chat which lazy-spawns on the first message.

pub async fn stop(&mut self, cli: AgentCli)

Stop the session for a single CLI.

pub async fn stop_all(&mut self)

Stop all active sessions (called on app shutdown).

pub async fn write_pty( &mut self, cli: AgentCli, text: &str, ) -> Result<(), String>

Write a string to the active PTY for the given CLI.

Lazy-spawns a PTY session on the first call for this CLI.

pub async fn send_chat( &mut self, cli: AgentCli, prompt: &str, ) -> Result<(), String>

Send a chat prompt to the pipe session for the given CLI.

Lazy-spawns a pipe session on the first call for this CLI.

Routes all 6 CLIs through TransportSession. Legacy Claude-only restriction is lifted: all CLIs with a legacy slot can now use Chat/pipe mode.

pub async fn resize(&mut self, cols: u16, rows: u16)

Resize all active PTY sessions to the new dimensions.

pub fn drain_events(&mut self) -> bool

Drain events for all instances. Returns true if any events were processed.

pub fn snapshot_mode( &self, cli: AgentCli, want_pty: bool, ) -> AgentRenderSnapshot

Build a render snapshot for the given CLI, honoring the UI’s requested mode.

want_pty=true → return PTY grid if a PTY parser/session exists (even if exited), otherwise Idle. want_pty=false → return chat messages if any, otherwise Idle. This decouples snapshot mode from session liveness so mode switches don’t destroy the other view.

pub fn snapshot(&self, cli: AgentCli) -> AgentRenderSnapshot

Legacy snapshot — inferred from state. Prefer snapshot_mode.

pub fn is_active(&self, cli: AgentCli) -> bool

Returns true if either PTY or pipe session is alive for this CLI.

pub fn any_active(&self) -> bool

Returns true if any instance has an active session.

pub fn past_session_count(&self, cli: AgentCli) -> usize

Number of past sessions for this CLI (live disk read).

pub fn list_past_sessions(&self, cli: AgentCli) -> Vec<SessionMeta>

List past sessions (newest first, live disk read).

pub fn load_latest_history(&mut self, cli: AgentCli) -> bool

Load the latest past session into the chat view (display only — does NOT resume the CLI process).

Returns true if anything was loaded.

pub fn load_history(&mut self, cli: AgentCli, session_id: &str) -> bool

Load a specific past session into the chat view AND mark it as the resume target — the next send_chat will respawn the pipe with --resume <session_id>, so the user keeps writing into the chosen thread instead of accidentally starting a fresh session.

pub fn load_next_past_session(&mut self, cli: AgentCli) -> bool

Backwards-compatible wrapper — loads the latest past session.

Chart-app callers using load_next_past_session continue to work unchanged.

Trait Implementations

impl Default for MultiCliManager

fn default() -> Self

Returns the “default value” for a type.