Struct DriverRegistry 

pub struct DriverRegistry { /* private fields */ }

Registry for LLM drivers

Enables dependency inversion: provider crates (everruns-anthropic, everruns-openai) register their drivers at startup. The core has no direct knowledge of implementations.

Example

use everruns_core::{DriverRegistry, DriverId};
use everruns_anthropic::register_driver;
use everruns_openai::register_driver as register_openai;

let mut registry = DriverRegistry::new();
everruns_anthropic::register_driver(&mut registry);
everruns_openai::register_driver(&mut registry);

// Later, create a driver from config
let driver = registry.create_chat_driver(&config)?;

Implementations

impl DriverRegistry

pub fn new() -> DriverRegistry

Create a new empty registry

pub fn register_descriptor(&mut self, descriptor: DriverDescriptor)

Register a full driver descriptor.

Panics if a descriptor is already registered for the same driver id — silent overwrites hide double-registration bugs. Use Self::register_descriptor_or_replace to overwrite intentionally.

pub fn register_descriptor_or_replace(&mut self, descriptor: DriverDescriptor)

Register a full driver descriptor, replacing any existing one.

pub fn register<F>(&mut self, provider_type: impl Into<DriverId>, factory: F)

where F: Fn(&DriverConfig) -> Box<dyn ChatDriver> + Send + Sync + 'static,

Register a driver factory for a provider type.

Panics if a factory is already registered for provider_type — silent overwrites hide double-registration bugs. Use Self::register_or_replace to overwrite intentionally.

pub fn register_or_replace<F>( &mut self, provider_type: impl Into<DriverId>, factory: F, )

where F: Fn(&DriverConfig) -> Box<dyn ChatDriver> + Send + Sync + 'static,

Register a driver factory, replacing any existing one for the provider.

Use when overwriting is intentional (e.g. swapping in an LlmSim driver for tests). Prefer Self::register otherwise so duplicates surface.

pub fn register_external<F>(&mut self, id: impl Into<Arc<str>>, factory: F)

where F: Fn(&DriverConfig) -> Box<dyn ChatDriver> + Send + Sync + 'static,

Register a driver factory for an embedder-defined external provider, keyed by its canonical id. The id is normalized to lowercase (via DriverId::external) so it matches parsed lookups regardless of the casing stored in the database or sent on the wire.

pub fn create_chat_driver( &self, config: &ProviderConfig, ) -> Result<Box<dyn ChatDriver>, AgentLoopError>

Create an LLM driver based on configuration

API keys must be provided in the config for real providers. This function does NOT fall back to environment variables. Keys should be decrypted from the database and passed here. Exception: LlmSim and External providers do not require an API key (external providers may authenticate via ProviderMetadata).

Returns DriverNotRegistered error if no driver is registered for the provider type.

pub fn has_driver(&self, provider_type: &DriverId) -> bool

Check if a driver is registered for a provider type

pub fn descriptor(&self, provider_type: &DriverId) -> Option<&DriverDescriptor>

Get the registered descriptor for a provider type.

pub fn supports(&self, provider_type: &DriverId, service: ServiceKind) -> bool

Whether the registered driver declares the given service.

pub fn providers_for(&self, service: ServiceKind) -> Vec<DriverId>

Driver ids whose descriptors declare the given service.

pub fn registered_providers(&self) -> Vec<DriverId>

Get the list of registered provider types

pub fn create_embeddings_driver( &self, config: &ProviderConfig, ) -> Result<Box<dyn EmbeddingsDriver>, EmbeddingsDriverError>

Create an embeddings driver based on configuration.

API keys must be provided in the config for real providers. Exception: LlmSim and External providers do not require an API key.

Returns an error if the driver is not registered or does not implement the embeddings service.

Trait Implementations

impl Clone for DriverRegistry

fn clone(&self) -> DriverRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for DriverRegistry

fn default() -> DriverRegistry

Returns the “default value” for a type.