Struct ProviderIndex 

pub struct ProviderIndex { /* private fields */ }

Immutable provider catalog with O(1) lookup by id.

The catalog is compiled into the binary from catalog.json via include_str!. Access it through ProviderIndex::embedded().

Implementations

impl ProviderIndex

pub fn from_providers(providers: Vec<ServiceDescriptor>) -> Self

Build a ProviderIndex from an explicit list of providers.

Useful for tests, overlays, or merging discovered providers into the embedded catalog. Provider order is preserved. The embedded catalog has no duplicate ids; if duplicates are passed, ProviderIndex::get resolves to the last occurrence while ProviderIndex::all retains every entry.

pub fn embedded() -> &'static ProviderIndex

Access the static catalog embedded at compile time.

pub fn with_discovered(&self, discovered: &[ModelEntry]) -> ProviderIndex

Return a new catalog where discovered model entries overlay this one.

For a discovered entry whose provider_id matches an existing provider, its model is merged into that provider (replacing on id collision, appending otherwise). Entries whose provider_id is not in the catalog are gathered under a synthetic "discovered" provider.

This resolves the catalog↔discovery gap: once merged, discovered models are visible to ProviderIndex::find_model and ProviderIndex::estimate_cost. The catalog is not mutated; an owned ProviderIndex is returned.

pub fn all(&self) -> &[ServiceDescriptor]

Return all providers in catalog order.

pub fn ids(&self) -> Vec<String>

Return all provider IDs.

pub fn get(&self, id: &str) -> Option<&ServiceDescriptor>

Look up a provider by ID. O(1).

pub fn categories(&self) -> Vec<String>

Unique categories in catalog order.

pub fn providers_by_category(&self, category: &str) -> Vec<&ServiceDescriptor>

Filter providers by category.

pub fn builtin_secret_keys(&self) -> HashSet<String>

Collect all secret key variable names from providers that require one.

pub fn models_for(&self, provider_id: &str) -> &[ModelDescriptor]

Get models for a specific provider.

pub fn find_model( &self, model_id: &str, ) -> Option<(&ServiceDescriptor, &ModelDescriptor)>

Find a model by ID across all providers. Returns the first match (provider, model).

pub fn estimate_cost( &self, model_id: &str, prompt_tokens: u32, completion_tokens: u32, ) -> Option<f64>

Estimate the USD cost of an LLM call given token counts.

Looks up model_id across all providers and computes: (input_price * prompt_tokens + output_price * completion_tokens) / 1_000_000

Returns None if the model is not found or has no pricing data.

Trait Implementations

impl Clone for ProviderIndex

fn clone(&self) -> ProviderIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderIndex

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

Formats the value using the given formatter.