Enum SettingsError 

pub enum SettingsError {
    ParseError(String),
    InvalidModel {
        agent: String,
        model: String,
        error: String,
    },
    MissingField {
        agent: String,
        field: String,
    },
    InvalidContextWindow {
        agent: String,
        context_window: u32,
    },
    EmptyAgentName {
        index: usize,
    },
    ReservedAgentName {
        name: String,
    },
    DuplicateAgentName {
        name: String,
    },
    NoInvocationSurface {
        agent: String,
    },
    AgentPromptSource {
        agent: String,
        source: PromptSourceError,
    },
    PromptSource(PromptSourceError),
    NoPromptsDeclared {
        agent: String,
    },
    AllOptionalPromptsMissing {
        agent: String,
    },
    InvalidMcpConfigPath {
        path: String,
    },
    UnresolvedMcpConfigVariable {
        path: String,
        variable: String,
    },
    IoError(String),
    AgentNotFound {
        name: String,
    },
    EmptyAgents,
    NoUserInvocableAgents,
    InvalidAgentSelector {
        name: String,
    },
    NonUserInvocableAgentSelector {
        name: String,
    },
    DuplicatePromptName {
        name: String,
    },
}

Errors that can occur during settings loading and agent resolution.

Variants

ParseError(String)

The settings file exists but could not be parsed.

InvalidModel

An agent entry has an invalid model string.

Fields

agent: String

model: String

error: String

MissingField

An agent entry is missing required fields.

Fields

agent: String

field: String

InvalidContextWindow

An agent entry has an invalid context window.

Fields

agent: String

context_window: u32

EmptyAgentName

An agent entry has an empty name.

Fields

index: usize

ReservedAgentName

An agent entry uses a reserved name.

Fields

name: String

DuplicateAgentName

Duplicate agent names.

Fields

name: String

NoInvocationSurface

An agent has no invocation surface enabled.

Fields

agent: String

AgentPromptSource

A prompt source on a specific agent failed validation.

Fields

agent: String

source: PromptSourceError

PromptSource(PromptSourceError)

A prompt source failed validation outside an agent context.

NoPromptsDeclared

An agent has no prompts declared (neither inherited nor local).

Fields

agent: String

AllOptionalPromptsMissing

An agent declared prompts but every entry was optional and matched no files.

Fields

agent: String

InvalidMcpConfigPath

An MCP config path does not exist or is invalid.

Fields

path: String

UnresolvedMcpConfigVariable

A ${VAR} reference in an MCP config path could not be resolved.

Fields

path: String

variable: String

IoError(String)

I/O error while reading files.

AgentNotFound

An agent was not found in the catalog.

Fields

name: String

EmptyAgents

The authored config contains no agents.

NoUserInvocableAgents

The authored config contains no user-invocable agents.

InvalidAgentSelector

The configured agent selector did not match an agent.

Fields

name: String

NonUserInvocableAgentSelector

The configured agent selector matched an agent that users cannot invoke.

Fields

name: String

DuplicatePromptName

Duplicate prompt names in the catalog.

Fields

name: String

Trait Implementations

impl Debug for SettingsError

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

Formats the value using the given formatter.

impl Display for SettingsError

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

Formats the value using the given formatter.

impl Error for SettingsError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<PromptSourceError> for SettingsError

fn from(source: PromptSourceError) -> Self

Converts to this type from the input type.