aether_project/
error.rs

1//! Error types for settings loading and validation.
2
3use thiserror::Error;
4
5/// Errors that can occur during settings loading and agent resolution.
6#[derive(Debug, Error)]
7pub enum SettingsError {
8    /// The settings file exists but could not be parsed.
9    #[error("Failed to parse settings file: {0}")]
10    ParseError(String),
11
12    /// An agent entry has an invalid model string.
13    #[error("Invalid model '{model}' for agent '{agent}': {error}")]
14    InvalidModel { agent: String, model: String, error: String },
15
16    /// An agent entry has an invalid reasoning effort string.
17    #[error("Invalid reasoningEffort '{effort}' for agent '{agent}': {error}")]
18    InvalidReasoningEffort { agent: String, effort: String, error: String },
19
20    /// An agent entry is missing required fields.
21    #[error("Agent '{agent}' is missing required field: {field}")]
22    MissingField { agent: String, field: String },
23
24    /// An agent entry has an empty name.
25    #[error("Agent at index {index} has an empty name")]
26    EmptyAgentName { index: usize },
27
28    /// An agent entry uses a reserved name.
29    #[error("Agent name '{name}' is reserved and cannot be used")]
30    ReservedAgentName { name: String },
31
32    /// Duplicate agent names.
33    #[error("Duplicate agent name: '{name}'")]
34    DuplicateAgentName { name: String },
35
36    /// An agent has no invocation surface enabled.
37    #[error("Agent '{agent}' must have at least one invocation flag (userInvocable or agentInvocable)")]
38    NoInvocationSurface { agent: String },
39
40    /// A prompt glob pattern is syntactically invalid.
41    #[error("Invalid glob pattern '{pattern}' for agent '{agent}': {error}")]
42    InvalidGlobPattern { agent: String, pattern: String, error: String },
43
44    /// An inherited prompt glob pattern is syntactically invalid.
45    #[error("Invalid inherited glob pattern '{pattern}': {error}")]
46    InvalidInheritedGlobPattern { pattern: String, error: String },
47
48    /// A prompt entry resolves to zero files.
49    #[error("Prompt entry '{pattern}' for agent '{agent}' resolves to no files")]
50    ZeroMatchPrompt { agent: String, pattern: String },
51
52    /// An inherited prompt entry resolves to zero files.
53    #[error("Inherited prompt entry '{pattern}' resolves to no files")]
54    ZeroMatchInheritedPrompt { pattern: String },
55
56    /// An agent has no prompts after inheritance.
57    #[error("Agent '{agent}' has no prompts after inheritance (neither inherited nor local)")]
58    NoPrompts { agent: String },
59
60    /// An MCP config path does not exist or is invalid.
61    #[error("MCP config path '{path}' does not exist or is not a file")]
62    InvalidMcpConfigPath { path: String },
63
64    /// I/O error while reading files.
65    #[error("I/O error: {0}")]
66    IoError(String),
67
68    /// An agent was not found in the catalog.
69    #[error("Agent '{name}' not found")]
70    AgentNotFound { name: String },
71
72    /// Duplicate prompt names in the catalog.
73    #[error("Duplicate prompt name: '{name}'")]
74    DuplicatePromptName { name: String },
75}
aether_project/error.rs

aether_project/
error.rs
