Struct ExtensionContext 

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

Context provided to extension lifecycle hooks and event handlers.

This is the primary interface through which extensions interact with the host application.

Fields

cwd: PathBuf

Current working directory.

config: Value

Extension-specific configuration (validated against manifest schema).

session_id: Option<String>

Session ID for the current session (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(Arc<dyn AgentTool>) + Send + Sync>, message_sender: Arc<dyn Fn(&str) + Send + Sync>, errors: Arc<RwLock<Vec<ExtensionErrorRecord>>>, ) -> Self

Create a new extension context.

Most callers should use ExtensionContextBuilder instead.

pub fn settings(&self) -> Settings

Read the current application settings.

pub fn is_idle(&self) -> bool

Whether the agent is currently idle (not streaming).

pub fn register_tool(&self, tool: Arc<dyn AgentTool>)

Register a tool that the agent can call.

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

Send a text message to the agent / conversation.

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

Record an error that occurred inside an extension hook.

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

Get all recorded extension errors.

pub fn clear_errors(&self)

Clear all recorded extension errors.

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

Read the extension-specific configuration value at the given path.

Returns None if the path doesn’t exist.

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

Read the filesystem — access files relative to cwd.

Trait Implementations

impl Debug for ExtensionContext

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

Formats the value using the given formatter.