Struct AgentSessionHost 

pub struct AgentSessionHost { /* private fields */ }

Production SessionHost over a live Arc<AgentSession> and the owning Arc<AgentSessionRuntime>.

All async session methods route to the real AgentSession. New / fork / switch / clone go through AgentSessionRuntime so the replacement pipeline runs (teardown → apply → rebind). The host clones the Arcs so it is 'static and cheap to share with the runtime.

Implementations

impl AgentSessionHost

pub fn new(runtime: Arc<AgentSessionRuntime>) -> Self

Construct a new host around the live runtime + its current session.

pub fn session(&self) -> Arc<AgentSession>

Snapshot the underlying session Arc (for rebind wiring).

pub fn refresh(&self)

Refresh the cached session Arc from the runtime (after a replacement).

Trait Implementations

impl Clone for AgentSessionHost

fn clone(&self) -> AgentSessionHost

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl SessionHost for AgentSessionHost

fn snapshot(&self) -> SessionSnapshot

Snapshot of synchronous state for view projection.

fn footer_snapshot(&self) -> BoxFuture<'_, SessionFooterSnapshot>

Snapshot persisted token/cost/context state for the footer.

fn subscribe(&self) -> EventSubscription

Subscribe to public session events. The returned EventSubscription owns an mpsc receiver plus the unsubscribe token.

fn partial_rx(&self) -> Receiver<Option<Arc<AssistantMessage>>>

Receiver for the latest partial assistant message (None when idle).

fn prompt( &self, text: &str, opts: PromptOptions, ) -> BoxFuture<'_, Result<(), String>>

Submit a prompt.

fn steer(&self, text: &str) -> BoxFuture<'_, Result<(), String>>

Steer the in-flight stream (mid-turn injection).

fn follow_up(&self, text: &str) -> BoxFuture<'_, Result<(), String>>

Queue a follow-up message for the next turn.

fn abort(&self) -> BoxFuture<'static, Result<(), String>>

Abort the active run, retry, compaction, bash, or branch summary.

fn compact( &self, instructions: Option<&str>, ) -> BoxFuture<'_, Result<(), String>>

Manually compact the context with optional custom instructions.

fn cycle_thinking_level(&self) -> BoxFuture<'_, Result<(), String>>

Cycle the thinking level forward.

fn cycle_model(&self, forward: bool) -> BoxFuture<'_, Result<(), String>>

Cycle the active model in the given direction.

fn reload(&self) -> BoxFuture<'_, Result<(), String>>

Reload extensions / resources / keybindings.

fn messages(&self) -> Vec<AgentMessage>

Returns the full transcript for the current session (used on rebind).

fn host_extension_runner(&self) -> Option<Arc<HostExtensionRunner>>

Concrete extension host for interactive UI bridging, when enabled.

fn hide_thinking_block(&self) -> bool

Initial persisted thinking-block visibility.

fn set_hide_thinking_block(&self, hide: bool) -> Result<(), String>

Persist thinking-block visibility.

fn external_editor_command(&self) -> String

Configured external editor command.

fn get_model_entries( &self, ) -> BoxFuture<'_, Result<Vec<ModelSelectorEntry>, String>>

Fetch the model list for the model selector.

fn get_session_entries( &self, ) -> BoxFuture<'_, Result<Vec<SessionPickerEntry>, String>>

Fetch the recent sessions for the session picker.

fn get_tree_entries(&self) -> BoxFuture<'_, Result<Vec<TreeEntry>, String>>

Fetch the session tree (entries with depth) for the tree selector.

fn get_fork_entries(&self) -> BoxFuture<'_, Result<Vec<TreeEntry>, String>>

Fetch the user-message fork list (tree entries, only user messages).

fn get_trust_entries(&self) -> BoxFuture<'_, Result<Vec<SettingsRow>, String>>

Fetch the trust-state settings rows.

fn get_auth_entries( &self, ) -> BoxFuture<'_, Result<Vec<AuthSelectorEntry>, String>>

Fetch the auth selector entries (provider list).

fn get_scoped_models_entries( &self, ) -> BoxFuture<'_, Result<ScopedModelEntries, String>>

Fetch the scoped-models selector entries with current enabled map.

fn get_settings_entries( &self, ) -> BoxFuture<'_, Result<Vec<SettingsRow>, String>>

Fetch the settings selector rows.

fn get_config_entries(&self) -> BoxFuture<'_, Result<Vec<SettingsRow>, String>>

Fetch the config selector rows.

fn execute_bash( &self, command: &str, exclude_from_context: bool, ) -> BoxFuture<'_, Result<(), String>>

Execute a bash command (the runtime passes the typed command minus the ! / !! prefix).

fn new_session(&self) -> BoxFuture<'_, Result<(), String>>

Start a new session (replacement pipeline).

fn fork(&self, entry_id: &str) -> BoxFuture<'_, Result<(), String>>

Open the fork selector’s confirmation; runtime supplies the entry id.

fn clone(&self) -> BoxFuture<'_, Result<(), String>>

Clone the session at the current leaf.

fn switch_session(&self, path: &str) -> BoxFuture<'_, Result<(), String>>

Switch to a different session file (resume).

fn export_html( &self, path: Option<&str>, ) -> BoxFuture<'_, Result<String, String>>

Export the current session to HTML; runtime passes an optional path.

fn set_session_name(&self, name: &str) -> BoxFuture<'_, Result<(), String>>

Set the session display name.

fn logout(&self) -> BoxFuture<'_, Result<(), String>>

Log out of the active auth / open the login selector.

fn last_assistant_text(&self) -> BoxFuture<'_, Result<Option<String>, String>>

Copy the last assistant text (returns the text so the runtime can resolve the platform clipboard).