ConfigurationException class final
The framework was assembled incorrectly.
A missing API key, a provider registered under a name nothing resolves, a vector store pointed at a dimension that disagrees with its embedder. These are deployment or wiring mistakes: retrying cannot fix them, and failing loudly at startup is far better than degrading at request time.
- Inheritance
-
- Object
- AgenticException
- ConfigurationException
Constructors
-
ConfigurationException(String message, {String? setting, Object? cause, StackTrace? causeStackTrace, Map<
String, Object?> details = const <String, Object?>{}}) -
Creates a configuration failure describing the misconfigured
setting.
Properties
-
annotations
→ Map<
String, Object?> -
Context added by layers the error passed through on its way out.
finalinherited
- cause → Object?
-
The lower-level error that triggered this failure, when there was one.
finalinherited
- causeStackTrace → StackTrace?
-
The stack trace captured where cause was caught.
finalinherited
- code → String
-
Stable machine-readable identifier for this class of failure.
no setteroverride
-
details
→ Map<
String, Object?> -
Structured, unmodifiable diagnostic context supplied at construction.
finalinherited
- hashCode → int
-
The hash code for this object.
no setterinherited
- isRetryable → bool
-
Whether retrying the identical operation could plausibly succeed.
no setteroverride
- message → String
-
Human-readable description of what went wrong.
finalinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- setting → String?
-
Dotted path of the offending setting, such as
openai.apiKey.final
Methods
-
annotate(
String key, Object? value) → void -
Records
valueunderkeyunlesskeyis already present.inherited -
annotateAll(
Map< String, Object?> context) → void -
Records every entry of
contextthrough annotate.inherited -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toJson(
) → Map< String, Object?> -
Serialises this exception for logs, traces and crash reports.
override
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited