Enum AgentTerminalKind 

pub enum AgentTerminalKind {
    Natural,
    UserCancelled,
    PolicyBudget,
    PolicyNoProgress,
    PolicyGuardrail,
    PolicyStop,
    ProviderError,
    RuntimeError,
    Suspended,
    Unknown,
}

Coarse, typed classification of why an agent-loop session terminated. Serialized snake_case. The vocabulary is deliberately extensible — Self::Unknown is the honest fallback when no rule matched and the raw reason is authoritative.

Variants

Natural

The model/agent finished naturally — a clean completion or a verified done judgement, with no policy stop and no error.

UserCancelled

A user or host explicitly cancelled the in-flight turn.

PolicyBudget

A budget/cap policy stopped the loop: max iterations, a token/cost budget, a circuit breaker, or an exhausted verification cap.

PolicyNoProgress

A no-progress policy stopped the loop: a thrash/stall hard stop or the text-only nudge budget.

PolicyGuardrail

A guardrail policy stopped the loop: an input tripwire or an out-of-scope alert.

PolicyStop

A custom post-turn / terminal callback requested a stop that is not one of the specific policy kinds above. The raw reason names it; a future typed callback contract can attribute a finer owner.

ProviderError

The provider/transport failed terminally: rate limit, timeout, context overflow, or provider misconfiguration.

RuntimeError

The harness/runtime failed terminally: a host-bridge gap, an internal protocol failure, an uncaught throw, or a turn that made no LLM call.

Suspended

The session suspended at a waitpoint and may resume later — its work is not finished and was not abandoned.

Unknown

No rule matched; the raw reason is authoritative.

Implementations

impl AgentTerminalKind

pub const ALL: [Self; 10]

pub fn as_str(self) -> &'static str

pub fn owner(self) -> &'static str

The party responsible for the stop — a stable, coarse attribution that pairs with the kind so hosts can bucket outcomes (agent-driven vs user vs provider vs harness vs policy) without re-deriving it.

Trait Implementations

impl Clone for AgentTerminalKind

fn clone(&self) -> AgentTerminalKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AgentTerminalKind

impl Debug for AgentTerminalKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentTerminalKind

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AgentTerminalKind

impl Hash for AgentTerminalKind

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for AgentTerminalKind

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AgentTerminalKind

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 AgentTerminalKind