Struct ServiceDescriptor 

#[non_exhaustive]
pub struct ServiceDescriptor {

    pub id: String,
    pub display_name: String,
    pub description: String,
    pub category: String,
    pub family: String,
    pub auth_mode: String,
    pub key_var: String,
    pub literal_auth_token: String,
    pub base_url: String,
    pub default_model: String,
    pub model_tiers: HashMap<String, String>,
    pub model_choices: Vec<ModelChoice>,
    pub test_url: String,
    pub setup: Vec<String>,
    pub usage: Vec<String>,
    pub api_base_url: Option<String>,
    pub npm_package: Option<String>,
    pub doc_url: Option<String>,
    pub models: Vec<ModelDescriptor>,
}

Describes an LLM provider service with all metadata needed to connect and use it.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: String

Unique provider identifier (e.g. "openai", "anthropic").

display_name: String

Human-readable display name.

description: String

Short description of the provider.

category: String

Provider category (e.g. "cloud", "local").

family: String

Provider family used to group related providers.

auth_mode: String

Authentication mode: "none", "literal", or "secret".

key_var: String

Environment variable name that holds the API key (empty if not required).

literal_auth_token: String

Literal auth token embedded in the catalog (only set when auth_mode = "literal").

base_url: String

Base URL for the provider’s web interface.

default_model: String

Default model ID used when no model override is specified.

model_tiers: HashMap<String, String>

Named model tiers mapping tier name → model ID (e.g. "fast" → "gpt-4o-mini").

model_choices: Vec<ModelChoice>

Legacy list of available model choices (claudy-specific).

test_url: String

URL used to test connectivity to the provider.

setup: Vec<String>

Setup instructions shown to the user during first-time configuration.

usage: Vec<String>

Usage examples shown to the user in the install wizard.

api_base_url: Option<String>

API base URL override (models.dev-compatible field).

npm_package: Option<String>

npm package name (models.dev-compatible field, for AI coding tools).

doc_url: Option<String>

Link to provider documentation.

models: Vec<ModelDescriptor>

Full list of models offered by this provider.

Trait Implementations

impl CapabilityProfile for ServiceDescriptor

fn auth_strategy(&self) -> AuthStrategy

How the provider authenticates API requests.

fn clears_anthropic_api_key(&self) -> bool

Whether the Anthropic API key should be cleared before calling this provider.

fn supports_model_tiers(&self) -> bool

Whether the provider supports model tiers (e.g. fast vs. powerful model aliases).

fn supports_tool_calling(&self) -> bool

Returns true if any model offered by this provider supports tool/function calling.

fn supports_vision(&self) -> bool

Returns true if any model offered by this provider accepts image input.

fn supports_streaming(&self) -> bool

Returns true if the provider supports streaming completions.

fn context_limit(&self) -> Option<u64>

Maximum context window in tokens across all models, or None if unknown.

impl Clone for ServiceDescriptor

fn clone(&self) -> ServiceDescriptor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceDescriptor

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

Formats the value using the given formatter.

impl Default for ServiceDescriptor

fn default() -> ServiceDescriptor

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ServiceDescriptor

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ServiceDescriptor

fn eq(&self, other: &ServiceDescriptor) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ServiceDescriptor

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ServiceDescriptor