aether_project/
error.rs

1//! Error types for settings loading and validation.
2
3use aether_core::core::PromptSourceError;
4use thiserror::Error;
5
6/// Errors that can occur during settings loading and agent resolution.
7#[derive(Debug, Error)]
8pub enum SettingsError {
9    /// The settings file exists but could not be parsed.
10    #[error("Failed to parse settings file: {0}")]
11    ParseError(String),
12
13    /// An agent entry has an invalid model string.
14    #[error("Invalid model '{model}' for agent '{agent}': {error}")]
15    InvalidModel { agent: String, model: String, error: String },
16
17    /// An agent entry is missing required fields.
18    #[error("Agent '{agent}' is missing required field: {field}")]
19    MissingField { agent: String, field: String },
20
21    /// An agent entry has an invalid context window.
22    #[error("Agent '{agent}' has invalid contextWindow {context_window}; expected a positive integer")]
23    InvalidContextWindow { agent: String, context_window: u32 },
24
25    /// An agent entry has an empty name.
26    #[error("Agent at index {index} has an empty name")]
27    EmptyAgentName { index: usize },
28
29    /// An agent entry uses a reserved name.
30    #[error("Agent name '{name}' is reserved and cannot be used")]
31    ReservedAgentName { name: String },
32
33    /// Duplicate agent names.
34    #[error("Duplicate agent name: '{name}'")]
35    DuplicateAgentName { name: String },
36
37    /// An agent has no invocation surface enabled.
38    #[error("Agent '{agent}' must have at least one invocation flag (userInvocable or agentInvocable)")]
39    NoInvocationSurface { agent: String },
40
41    /// A prompt source on a specific agent failed validation.
42    #[error("Agent '{agent}': {source}")]
43    AgentPromptSource {
44        agent: String,
45        #[source]
46        source: PromptSourceError,
47    },
48
49    /// A prompt source failed validation outside an agent context.
50    #[error(transparent)]
51    PromptSource(#[from] PromptSourceError),
52
53    /// An agent has no prompts declared (neither inherited nor local).
54    #[error("Agent '{agent}' has no prompts declared (neither inherited nor local)")]
55    NoPromptsDeclared { agent: String },
56
57    /// An agent declared prompts but every entry was optional and matched no files.
58    #[error("Agent '{agent}': all prompt entries were optional and matched no files")]
59    AllOptionalPromptsMissing { agent: String },
60
61    /// An MCP config path does not exist or is invalid.
62    #[error("MCP config path '{path}' does not exist or is not a file")]
63    InvalidMcpConfigPath { path: String },
64
65    /// A `${VAR}` reference in an MCP config path could not be resolved.
66    #[error("MCP config path '{path}' references undefined variable '{variable}'")]
67    UnresolvedMcpConfigVariable { path: String, variable: String },
68
69    /// I/O error while reading files.
70    #[error("I/O error: {0}")]
71    IoError(String),
72
73    /// An agent was not found in the catalog.
74    #[error("Agent '{name}' not found")]
75    AgentNotFound { name: String },
76
77    /// The authored config contains no agents.
78    #[error("Aether config must contain at least one agent")]
79    EmptyAgents,
80
81    /// The authored config contains no user-invocable agents.
82    #[error("Aether config must contain at least one user-invocable agent")]
83    NoUserInvocableAgents,
84
85    /// The configured agent selector did not match an agent.
86    #[error("Configured agent selector '{name}' did not match any agent")]
87    InvalidAgentSelector { name: String },
88
89    /// The configured agent selector matched an agent that users cannot invoke.
90    #[error("Configured agent selector '{name}' is not user-invocable")]
91    NonUserInvocableAgentSelector { name: String },
92
93    /// Duplicate prompt names in the catalog.
94    #[error("Duplicate prompt name: '{name}'")]
95    DuplicatePromptName { name: String },
96}
aether_project/error.rs

aether_project/
error.rs
