Struct SessionOptions 

pub struct SessionOptions {

    pub provider: Option<String>,
    pub model: Option<String>,
    pub api_key: Option<String>,
    pub thinking: Option<ThinkingLevel>,
    pub system_prompt: Option<String>,
    pub append_system_prompt: Option<String>,
    pub enabled_tools: Option<Vec<String>>,
    pub working_directory: Option<PathBuf>,
    pub no_session: bool,
    pub session_path: Option<PathBuf>,
    pub session_dir: Option<PathBuf>,
    pub extension_paths: Vec<PathBuf>,
    pub extension_policy: Option<String>,
    pub repair_policy: Option<String>,
    pub max_tool_iterations: usize,
    pub on_event: Option<Arc<dyn Fn(AgentEvent) + Send + Sync>>,
    pub on_tool_start: Option<OnToolStart>,
    pub on_tool_end: Option<OnToolEnd>,
    pub on_stream_event: Option<OnStreamEvent>,
}

SDK session construction options.

These options provide the programmatic equivalent of the core CLI startup path used in src/main.rs.

Fields

provider: Option<String>

model: Option<String>

api_key: Option<String>

thinking: Option<ThinkingLevel>

system_prompt: Option<String>

append_system_prompt: Option<String>

enabled_tools: Option<Vec<String>>

working_directory: Option<PathBuf>

no_session: bool

session_path: Option<PathBuf>

session_dir: Option<PathBuf>

extension_paths: Vec<PathBuf>

extension_policy: Option<String>

repair_policy: Option<String>

max_tool_iterations: usize

on_event: Option<Arc<dyn Fn(AgentEvent) + Send + Sync>>

Session-level event listener invoked for every AgentEvent.

Unlike the per-prompt callback passed to AgentSessionHandle::prompt, this fires for all prompts throughout the session lifetime.

on_tool_start: Option<OnToolStart>

Typed callback invoked when tool execution starts.

on_tool_end: Option<OnToolEnd>

Typed callback invoked when tool execution ends.

on_stream_event: Option<OnStreamEvent>

Callback for raw provider StreamEvents.

Trait Implementations

impl Clone for SessionOptions

fn clone(&self) -> SessionOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for SessionOptions

fn default() -> Self

Returns the “default value” for a type.