Struct ExtensionContext 

pub struct ExtensionContext {
    pub cwd: PathBuf,
    pub config: Value,
    pub session_id: Option<String>,
    /* private fields */
}

Runtime context provided to extension hooks.

Gives extensions access to the session’s working directory, settings, configuration, and various control surfaces (tool registration, message sending, model switching, etc.).

Fields

cwd: PathBuf

Current working directory.

config: Value

Extension-specific configuration value.

session_id: Option<String>

Active session ID, if any.

Implementations

impl ExtensionContext

pub fn new( cwd: PathBuf, settings: Arc<RwLock<Settings>>, config: Value, session_id: Option<String>, idle: Arc<RwLock<bool>>, tool_registrar: Arc<dyn Fn(ExtensionToolArc) + Send + Sync>, message_sender: Arc<dyn Fn(&str) + Send + Sync>, errors: Arc<RwLock<Vec<ExtensionErrorRecord>>>, ) -> Self

Create a new extension context.

pub fn settings(&self) -> Settings

Get a snapshot of the current settings.

pub fn is_idle(&self) -> bool

Whether the agent is currently idle (not streaming).

pub fn register_tool(&self, tool: ExtensionToolArc)

Register a tool with the agent.

pub fn send_message(&self, text: &str)

Send a message as the extension.

pub fn record_error(&self, extension_name: &str, event: &str, error: &str)

Record an error from an extension.

pub fn errors(&self) -> Vec<ExtensionErrorRecord>

Get all recorded errors.

pub fn clear_errors(&self)

Clear all recorded errors.

pub fn config_get(&self, path: &str) -> Option<Value>

Look up a value in the extension configuration by dot-separated path.

pub fn read_file(&self, relative_path: &Path) -> Result<String>

Read a file relative to the working directory.

pub fn get_tools(&self) -> Vec<ExtensionToolArc>

Get all currently registered tools.

pub fn set_tools(&self, tools: Vec<ExtensionToolArc>)

Replace the full set of registered tools.

pub fn set_model(&self, model: &str)

Switch the active model.

pub fn set_thinking_level(&self, level: &str)

Set the thinking level.

pub fn append_system_prompt(&self, text: &str)

Append text to the system prompt.

pub fn set_session_name(&self, name: &str)

Set the session display name.

pub fn get_session_entries(&self) -> Vec<Value>

Get all session entries.

pub fn fork_session(&self, entry_id: &str) -> Result<String>

Fork the session at the given entry ID.

Trait Implementations

impl Debug for ExtensionContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.