#[non_exhaustive]pub enum FailureKind {
Transcript,
ToolResolution,
Request,
Model,
Stream,
Event,
Hook,
ToolExecution,
ToolCommit,
Input,
Internal,
}Expand description
The portable classification of a failed Run.
A Run can fail for reasons that call for very different handling — a
provider outage, a malformed provider stream, a hook defect, a transcript
conflict — and the concrete failure types belong to crate-private stages that
a consumer could not downcast to even if they were exposed. This enum is the
stable, matchable summary; Terminal::failure carries the exact text.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
Transcript
A transcript snapshot or mutation failed.
ToolResolution
Resolving the Step’s tools failed, usually a name collision.
Request
The transcript could not be frozen into a valid model request.
Model
The provider adapter itself failed.
Stream
The provider’s normalized event stream violated the grammar.
Event
An outward event could not be constructed or delivered.
Hook
A hook callback failed.
ToolExecution
Routing or executing a tool batch failed.
ToolCommit
Committing a tool batch failed.
Input
A claimed input batch produced an invalid admission decision.
Internal
A runtime invariant produced a failure with no external cause.
This is a defect in Reef, not in the caller or the provider.