Struct ExtensionRegistry 

pub struct ExtensionRegistry { /* private fields */ }

Registry that manages extensions and provides integration wrappers.

Extensions are registered before the agent loop starts. Once hooks or event sinks are wrapped via wrap_hooks or wrap_event_sink, the registry should not be modified further.

Implementations

impl ExtensionRegistry

pub fn new() -> Self

Create an empty registry.

pub fn register( &mut self, ext: Box<dyn Extension>, ) -> Result<(), ExtensionError>

Register an extension.

Returns an error if an extension with the same name already exists. Returns ExtensionError::RegistryLocked if called after wrap_hooks() or wrap_event_sink() has been called (i.e., the extension list is shared).

pub fn is_empty(&self) -> bool

Returns true if no extensions are registered.

pub fn len(&self) -> usize

Returns the number of registered extensions.

pub fn names(&self) -> Vec<&str>

Return extension names in registration order.

pub fn get(&self, name: &str) -> Option<&dyn Extension>

Look up an extension by name.

pub fn collect_tools(&self) -> Vec<Box<dyn Tool>>

Collect all tools from all registered extensions.

pub fn collect_providers(&self) -> Vec<Box<dyn Provider>>

Collect all custom providers from all registered extensions.

Each extension’s providers method is called and the results are concatenated. Extensions should return fresh provider instances since Box<dyn Provider> is not Clone.

pub fn collect_model_overrides(&self) -> Vec<(String, ModelInfo)>

Collect all model overrides from all registered extensions.

Each extension’s model_overrides method is called and the results are concatenated.

pub fn dispatch_event(&self, event: &AgentEvent)

Dispatch an event to all registered extensions.

pub async fn dispatch_command( &self, command: &ExtensionCommand, ) -> Result<Option<Value>, ExtensionError>

Dispatch a custom command to extensions in registration order.

Returns the first Some response, or None if no extension handled the command.

pub fn serialize_states(&self) -> Result<Value, ExtensionError>

Serialize all extension states into a JSON object keyed by extension name.

pub fn restore_states(&self, states: Value) -> Result<(), ExtensionError>

Restore extension states from a JSON object keyed by extension name.

pub fn wrap_hooks(&self, base: Box<dyn AgentHooks>) -> Box<dyn AgentHooks>

Create a composite AgentHooks that wraps the base hooks with extension lifecycle callbacks.

Extension hooks are called after the base hooks. If any extension returns ExtensionHookResult::Block, the chain stops and the block propagates as a denial.

pub fn wrap_event_sink(&self, base_sink: AgentEventSink) -> AgentEventSink

Wrap an event sink to dispatch events to all registered extensions before forwarding to the base sink.

Trait Implementations

impl Clone for ExtensionRegistry

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ExtensionRegistry

fn default() -> Self

Returns the “default value” for a type.