Struct ModelSettings 

pub struct ModelSettings {
    pub model: String,
    pub inner: ModelSettingsInner,
}

Model settings configuration. A ModelSettings always has a valid model string. Use Option<ModelSettings> when no model is configured yet.

Fields

model: String

inner: ModelSettingsInner

Implementations

impl ModelSettings

pub fn new(model: impl Into<String>) -> Self

Create a new ModelSettings with the given model and default inner settings.

pub fn from_provider_model_str(s: &str) -> Result<Option<Self>, String>

Parse a “provider/model” string (e.g. “anthropic/claude-sonnet-4”) into ModelSettings. Returns None if the format is invalid. For custom providers (prefixed with “custom_”), returns an OpenAICompatible provider with empty base_url/api_key — the caller must fill these from secrets/config. Parse “provider/model” string into ModelSettings. Returns Err with a descriptive message if the provider is not recognized. Returns Ok(None) if the input is empty or has no slash.

pub fn merge(&self, override_settings: &ModelSettings) -> Option<ModelSettings>

Merge base (workspace) model settings with agent/request-level overrides.

Provider resolution:

• If the override explicitly sets a provider (not the default OpenAI), the override’s provider and model are used.
• If only the base has a non-default provider and the override uses default OpenAI, the base’s provider AND model win — the override’s bare model name is ignored because it may not exist on the base provider.
• Otherwise, the override’s model wins if non-empty.

Scalar fields (temperature, max_tokens, etc.) use override if present, else base.

Returns None if the final model string is empty.

Trait Implementations

impl Clone for ModelSettings

fn clone(&self) -> ModelSettings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelSettings

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ModelSettings

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ModelSettings

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for ModelSettings

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

where __S: Serializer,

Serialize this value into the given Serde serializer.