Struct Provider 

pub struct Provider { /* private fields */ }

Cloneable opaque provider handle.

Provider and Model clones share one lifecycle. Shutdown seals model admission, drains accepted work, and publishes one terminal result to every waiter; cancelling a waiter cannot cancel owned cleanup. Models have no independent shutdown. Caller implementations retain their concrete associated children directly.

Examples

use providers_kit::{Provider, ProviderBackend, ProviderConfig, ModelBackend, ModelId, config::{ProviderKind, OllamaConfig, TransportConfig}};
let provider = Provider::from_config(ProviderConfig::new(ProviderKind::Ollama(OllamaConfig::local()), TransportConfig::default()))?;
let model = provider.model(ModelId::new("exact-model")?)?;
assert_eq!(model.model_id().as_str(), "exact-model");
provider.shutdown().await?;

Implementations

impl Provider

pub fn from_config(config: ProviderConfig) -> Result<Self, KitError>

Constructs a built-in provider from validated configuration.

Construction creates clients locally and does not probe credentials or model availability.

Errors

Returns a configuration or client-construction error for invalid endpoints, transport settings, or HTTP/TLS client setup. Service authentication is checked by subsequent operations.

Examples

use providers_kit::{Provider, ProviderBackend, ProviderConfig, ModelBackend, ModelId, config::{ProviderKind, OllamaConfig, TransportConfig}};
let provider = Provider::from_config(ProviderConfig::new(ProviderKind::Ollama(OllamaConfig::local()), TransportConfig::default()))?;
let model = provider.model(ModelId::new("exact-model")?)?;
assert_eq!(model.model_id().as_str(), "exact-model");
provider.shutdown().await?;

Trait Implementations

impl Clone for Provider

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Provider

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

Formats the value using the given formatter.

impl ProviderBackend for Provider

type Model = Model

Exact model child returned by this provider.

fn model(&self, id: ModelId) -> Result<Model, KitError>

Selects one exact provider-local model.

async fn list_models( &self, request: ModelListRequest, ) -> Result<ModelPage, KitError>

Lists provider-visible models.

async fn model_info(&self, id: ModelId) -> Result<ModelSummary, KitError>

Fetches descriptive metadata for one exact provider-local model.

async fn upload_file( &self, request: FileUploadRequest, ) -> Result<FileObject, KitError>

Uploads one provider-managed file.

async fn list_files( &self, request: FileListRequest, ) -> Result<FilePage, KitError>

Lists provider-managed files.

async fn file_info(&self, id: String) -> Result<FileObject, KitError>

Fetches metadata for one provider-managed file.

async fn delete_file(&self, id: String) -> Result<(), KitError>

Deletes one provider-managed file.

async fn download_file( &self, id: String, max_bytes: NonZeroUsize, ) -> Result<Vec<u8>, KitError>

Downloads one provider-managed file under the caller’s byte limit.

async fn batch_status(&self, id: String) -> Result<BatchJob, KitError>

Fetches one batch job.

async fn cancel_batch(&self, id: String) -> Result<BatchJob, KitError>

Cancels one batch job.

async fn batch_results( &self, id: String, max_bytes: NonZeroUsize, ) -> Result<Vec<BatchResult<GenerationContinuation>>, KitError>

Downloads and normalizes batch result rows under the caller’s byte limit.

async fn list_batches( &self, request: BatchListRequest, ) -> Result<BatchPage, KitError>

Lists provider batch jobs.

async fn health(&self) -> Result<HealthStatus, KitError>

Probes provider runtime health.

async fn shutdown(&self) -> Result<(), KitError>

Shuts down backend-owned resources.