Enum TerminationReason 

pub enum TerminationReason {
    Complete,
    StopCondition {
        reason: Option<String>,
    },
    MaxIterations {
        limit: u32,
    },
    LoopDetected {
        tool_name: String,
        count: u32,
    },
    Timeout {
        limit: Duration,
    },
}

Why a tool loop terminated.

Used for observability and debugging. Each variant captures specific information about why the loop ended.

Example

use llm_stack::tool::TerminationReason;
use std::time::Duration;

match reason {
    TerminationReason::Complete => println!("Task completed naturally"),
    TerminationReason::StopCondition { reason } => {
        println!("Custom stop: {}", reason.as_deref().unwrap_or("no reason"));
    }
    TerminationReason::MaxIterations { limit } => {
        println!("Hit iteration limit: {limit}");
    }
    TerminationReason::LoopDetected { tool_name, count } => {
        println!("Stuck calling {tool_name} {count} times");
    }
    TerminationReason::Timeout { limit } => {
        println!("Exceeded timeout: {limit:?}");
    }
}

Variants

Complete

LLM returned a response with no tool calls (natural completion).

StopCondition

Custom stop condition returned StopDecision::Stop or StopDecision::StopWithReason.

Fields

reason: Option<String>

The reason provided via StopDecision::StopWithReason, if any.

MaxIterations

Hit the max_iterations limit.

Fields

limit: u32

The configured limit that was reached.

LoopDetected

Loop detection triggered with LoopAction::Stop.

Fields

tool_name: String

Name of the tool being called repeatedly.

count: u32

Number of consecutive identical calls.

Timeout

Wall-clock timeout exceeded.

Fields

limit: Duration

The configured timeout that was exceeded.

Trait Implementations

impl Clone for TerminationReason

fn clone(&self) -> TerminationReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TerminationReason

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

Formats the value using the given formatter.

impl PartialEq for TerminationReason

fn eq(&self, other: &TerminationReason) -> 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 Eq for TerminationReason

impl StructuralPartialEq for TerminationReason