Struct InterceptorStack 

pub struct InterceptorStack<T: Interceptable> { /* private fields */ }

A composable stack of interceptors.

Interceptors are executed in the order they are added:

• First added = outermost = sees request first, sees response last
• Last added = innermost = sees request last, sees response first

Example

use llm_stack::intercept::{InterceptorStack, Retry, ToolExec};

let stack = InterceptorStack::<ToolExec<()>>::new()
    .with(Retry::default());

Implementations

impl<T: Interceptable> InterceptorStack<T>

pub fn new() -> Self

Create an empty interceptor stack.

pub fn with<I: Interceptor<T> + 'static>(self, interceptor: I) -> Self

Add an interceptor to the stack.

Interceptors are executed in the order added (first = outermost).

pub fn with_shared(self, interceptor: Arc<dyn Interceptor<T>>) -> Self

Add a shared interceptor instance.

Useful when the same interceptor instance needs to be used across multiple stacks (e.g., for shared metrics collection).

pub fn is_empty(&self) -> bool

Check if the stack has any interceptors.

pub fn len(&self) -> usize

Get the number of interceptors in the stack.

pub async fn execute<'a, O>( &'a self, input: &'a T::Input, operation: &'a O, ) -> T::Output

where T::Input: Sync, O: Operation<T>,

Execute an operation through the interceptor stack.

pub async fn execute_fn<'a, F>(&'a self, input: &'a T::Input, f: F) -> T::Output

where T::Input: Sync, F: Fn(&T::Input) -> Pin<Box<dyn Future<Output = T::Output> + Send + '_>> + Send + Sync,

Execute with a closure as the operation.

Trait Implementations

impl<T: Interceptable> Clone for InterceptorStack<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Interceptable> Default for InterceptorStack<T>

fn default() -> Self

Returns the “default value” for a type.