Enum ExitReason 

#[non_exhaustive]
pub enum ExitReason {
    Complete,
    MaxTurns,
    BudgetExhausted,
    CircuitBreaker,
    Timeout,
    InterceptorHalt {
        reason: String,
    },
    Error,
    SafetyStop {
        reason: String,
    },
    AwaitingApproval,
    Custom(String),
}

Why an operator invocation ended. The caller needs to know this to decide what happens next (retry? continue? escalate?).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Complete

Model produced a final text response (natural completion).

MaxTurns

Hit the max_turns limit.

BudgetExhausted

Hit the cost budget (max_cost) or the tool-call step limit (max_tool_calls). Use BudgetEvent sink notifications to distinguish the two causes.

CircuitBreaker

Circuit breaker tripped (consecutive failures).

Timeout

Wall-clock timeout.

InterceptorHalt

Interceptor/middleware halted execution.

Fields

reason: String

The reason the interceptor halted execution.

Error

Unrecoverable error during execution.

SafetyStop

Provider safety system stopped generation (HTTP 200, content filtered).

Semantically distinct from Error (not a transport or execution failure) and Complete (model did not finish naturally). Arrives via StopReason::ContentFilter in the provider response — the provider acknowledged the request but refused to complete it. Not retriable without modification to the context or request.

Fields

reason: String

Human-readable reason string supplied by the provider or runtime.

AwaitingApproval

One or more tool calls require human approval before execution. The calling layer should inspect OperatorOutput::effects for Effect::ToolApprovalRequired entries, obtain approval, then either execute the tools and re-enter the loop, or inject a denial message and re-enter.

Custom(String)

Future exit reasons.

Trait Implementations

impl Clone for ExitReason

fn clone(&self) -> ExitReason

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExitReason

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ExitReason

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ExitReason

fn eq(&self, other: &ExitReason) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ExitReason

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ExitReason