Struct LoopContext 

pub struct LoopContext<T: Clone + Send + Sync = ()> {
    pub state: T,
    /* private fields */
}

Generic context wrapper with built-in depth tracking.

Wraps any Clone + Send + Sync state and automatically implements LoopDepth, eliminating the boilerplate of storing a depth field and writing the trait impl yourself.

Examples

use llm_stack::tool::{LoopContext, LoopDepth, ToolRegistry};

#[derive(Clone)]
struct AppState {
    user_id: String,
    api_key: String,
}

let ctx = LoopContext::new(AppState {
    user_id: "user_123".into(),
    api_key: "sk-secret".into(),
});

assert_eq!(ctx.loop_depth(), 0);
assert_eq!(ctx.state.user_id, "user_123");

// Use with a typed registry
let registry: ToolRegistry<LoopContext<AppState>> = ToolRegistry::new();

For the zero-state case, use LoopContext<()>:

use llm_stack::tool::{LoopContext, LoopDepth};

let ctx = LoopContext::empty();
assert_eq!(ctx.loop_depth(), 0);

let nested = ctx.with_depth(1);
assert_eq!(nested.loop_depth(), 1);

Fields

state: T

The application state accessible from tool handlers.

Implementations

impl<T: Clone + Send + Sync> LoopContext<T>

pub fn new(state: T) -> Self

Create a new context wrapping the given state at depth 0.

impl LoopContext<()>

pub fn empty() -> Self

Create a stateless context at depth 0.

Trait Implementations

impl<T: Clone + Clone + Send + Sync> Clone for LoopContext<T>

fn clone(&self) -> LoopContext<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Clone + Send + Sync> Debug for LoopContext<T>

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

Formats the value using the given formatter.

impl<T: Clone + Send + Sync> LoopDepth for LoopContext<T>

fn loop_depth(&self) -> u32

Returns the current nesting depth (0 = top-level, not nested).

fn with_depth(&self, depth: u32) -> Self

Returns a new context with the specified depth.