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

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 value under key unless key is already present.
inherited
annotateAll(Map<String, Object?> context) → void
Records every entry of context through 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