Struct FileModelCatalog 

pub struct FileModelCatalog { /* private fields */ }

File-based catalog backed by models.dev SNAP + runtime cache + user overrides. This is the reference impl of ModelCatalog used by oxicode-cli and similar products.

Implementations

impl FileModelCatalog

pub async fn init(config: CatalogConfig) -> Result<Arc<Self>>

Build the catalog by loading SNAP + cache + overrides. If the cache is stale and fetch_enabled, attempt one refresh (failure is silent — SNAP serves as fallback).

Trait Implementations

impl Debug for FileModelCatalog

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

Formats the value using the given formatter.

impl ModelCatalog for FileModelCatalog

fn list_providers( &self, ) -> Pin<Box<dyn Future<Output = SdkResult<Vec<String>>> + Send + '_>>

List all known provider IDs (sorted, no duplicates).

fn get_provider( &self, provider_id: &str, ) -> Pin<Box<dyn Future<Output = SdkResult<Option<CatalogProviderEntry>>> + Send + '_>>

Look up a single provider by ID.

fn list_models( &self, provider_id: &str, ) -> Pin<Box<dyn Future<Output = SdkResult<Vec<CatalogModelEntry>>> + Send + '_>>

List all models for a provider (order unspecified).

fn get_model( &self, provider_id: &str, model_id: &str, ) -> Pin<Box<dyn Future<Output = SdkResult<Option<CatalogModelEntry>>> + Send + '_>>

Look up a single model by (provider, model_id).

fn search( &self, pattern: &str, ) -> Pin<Box<dyn Future<Output = SdkResult<Vec<CatalogModelEntry>>> + Send + '_>>

Search models by case-insensitive substring of provider, model_id, or name. Empty pattern returns all.

fn model_count( &self, ) -> Pin<Box<dyn Future<Output = SdkResult<usize>> + Send + '_>>

Total number of models across all providers.

fn refresh( &self, ) -> Pin<Box<dyn Future<Output = SdkResult<RefreshOutcome>> + Send + '_>>

Force a refresh. The implementation decides what “refresh” means (HTTP fetch, file re-read, etc.).

fn subscribe(&self) -> Receiver<CatalogEvent>

Subscribe to catalog lifecycle events. Multiple consumers supported.

fn list_providers_sync(&self) -> Vec<String>

Sync equivalent of list_providers.

fn get_provider_sync(&self, provider_id: &str) -> Option<CatalogProviderEntry>

Sync equivalent of get_provider.

fn list_models_sync(&self, provider_id: &str) -> Vec<CatalogModelEntry>

Sync equivalent of list_models.

fn get_model_sync( &self, provider_id: &str, model_id: &str, ) -> Option<CatalogModelEntry>

Sync equivalent of get_model.

fn search_sync(&self, pattern: &str) -> Vec<CatalogModelEntry>

Sync equivalent of search.

fn model_count_sync(&self) -> usize

Sync equivalent of model_count.