Struct AgentSession 

pub struct AgentSession {
    pub manager: Mutex<SessionManager>,
    pub registry: Arc<Registry>,
    /* private fields */
}

Fields

manager: Mutex<SessionManager>

registry: Arc<Registry>

Implementations

impl AgentSession

pub fn new( manager: SessionManager, tools: Vec<DynTool>, registry: impl Into<Arc<Registry>>, settings: Settings, system_prompt: String, model: Model, thinking: ThinkingLevel, api_key_override: Option<(String, String)>, sink: SessionEventSink, ) -> Arc<Self>

pub fn new_with_subagents_allowed( manager: SessionManager, tools: Vec<DynTool>, registry: impl Into<Arc<Registry>>, settings: Settings, system_prompt: String, model: Model, thinking: ThinkingLevel, api_key_override: Option<(String, String)>, sink: SessionEventSink, subagents_allowed: bool, ) -> Arc<Self>

pub fn set_stream_fn(&self, stream_fn: Option<StreamFn>)

Replace the provider streaming function used by every later request.

Pass None to restore the real provider. Child sessions created after this call inherit the override so a scripted fake model also serves subagents and compaction.

pub fn model(&self) -> Model

pub fn thinking_level(&self) -> ThinkingLevel

pub fn fast_mode(&self) -> bool

pub fn set_fast_mode(&self, enabled: bool)

pub fn totals(&self) -> Usage

pub fn is_running(&self) -> bool

pub fn settings(&self) -> Settings

pub fn update_settings(&self, settings: Settings)

pub fn reload_runtime( &self, settings: Settings, system_prompt: String, tools: Vec<DynTool>, )

Replace resources used by the next model request.

pub fn install_session_tool(&self, tool: DynTool)

Add or replace one tool for this process without changing saved tool configuration.

pub fn remove_session_tool(&self, name: &str) -> bool

Remove one process-only tool. Return true when a tool was removed.

pub fn workflows_enabled(&self) -> bool

Dynamic workflows are built on child agents, so they need subagents on as well as their own setting.

pub fn prompt_mode_for(&self, text: &str) -> PromptMode

Select workflow mode from one submitted user prompt.

pub fn workflows(&self) -> Option<Arc<WorkflowRuntime>>

pub fn iterative_jobs(&self) -> Option<Arc<IterativeRuntime>>

pub fn set_workflow_approver(&self, approver: WorkflowApprover)

Install the callback that asks the user to approve a run.

pub fn available_tool_names(&self) -> Vec<String>

pub fn replace_manager(&self, manager: SessionManager)

Switch the active session without appending synthetic history.

pub fn set_model(&self, model: Model)

pub fn set_thinking_level(&self, level: ThinkingLevel)

pub async fn navigate_tree( self: &Arc<Self>, target_id: &str, summarize: bool, custom_instructions: Option<String>, cancel: CancellationToken, ) -> Result<TreeNavigationOutcome>

Move the active leaf in the current session tree, with an optional summary of the branch that is no longer active.

pub fn queue_steering(&self, message: AgentMessage)

pub fn queue_steering_with_mode(&self, message: AgentMessage, mode: PromptMode)

pub fn queue_follow_up(&self, message: AgentMessage)

pub fn queue_follow_up_with_mode(&self, message: AgentMessage, mode: PromptMode)

pub fn reclaim_queued(&self) -> Vec<AgentMessage>

Drain both queues back to the caller (Escape restores to editor).

pub fn abort(&self)

pub async fn answer_btw( self: &Arc<Self>, question: &str, cancel: CancellationToken, ) -> Result<EphemeralResponse>

Answer a short side question without changing the active session.

pub async fn generate_session_title( self: &Arc<Self>, prompt: &str, cancel: CancellationToken, ) -> Result<String>

Generate a short session title without changing conversation history.

pub async fn generate_recap( self: &Arc<Self>, previous_recap: Option<&str>, cancel: CancellationToken, ) -> Result<EphemeralResponse>

Create a one-line recap without changing the active session.

pub async fn prompt(self: &Arc<Self>, prompts: Vec<AgentMessage>)

Run one prompt to completion, including retry and auto-compaction.

pub async fn prompt_with_mode( self: &Arc<Self>, prompts: Vec<AgentMessage>, prompt_mode: PromptMode, )

Run one prompt with tools and instructions selected for this turn.

pub async fn compact( self: &Arc<Self>, custom_instructions: Option<String>, auto: bool, )

Manual or automatic compaction.

pub fn context_usage(&self) -> (u64, u64)

Current estimated context tokens and window fraction.