Struct DispatchBudgetHook 

pub struct DispatchBudgetHook<G>
where
    G: BudgetGuard,
{ /* private fields */ }

Dispatch hook that gates each normalized tool invocation on a BudgetGuard.

The hook reserves cost_per_invocation before each call. If the budget denies the reservation, dispatch terminates before the tool runs. Successful reservations are released after the invocation completes, after a synthetic skip result is recorded, or when dispatch stops with an error.

Implementations

impl<G> DispatchBudgetHook<G>

where G: BudgetGuard,

pub fn new(guard: Arc<G>, cost_per_invocation: u64) -> Self

Create a dispatch-budget hook over guard.

pub fn cost_per_invocation(&self) -> u64

Units reserved for each invocation.

pub fn guard(&self) -> &Arc<G>

Underlying budget guard.

Trait Implementations

impl<G> Debug for DispatchBudgetHook<G>

where G: BudgetGuard + Debug,

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

Formats the value using the given formatter.

impl<G> ToolDispatchHook for DispatchBudgetHook<G>

where G: BudgetGuard,

fn before_invocation<'life0, 'life1, 'async_trait>( &'life0 self, invocation: &'life1 ToolInvocation, ) -> Pin<Box<dyn Future<Output = Result<ToolDispatchAction, KernelError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called before each invocation. Return ToolDispatchAction::Continue to invoke the tool, ToolDispatchAction::Skip to synthesize a result, or ToolDispatchAction::Terminate to stop the dispatch loop.

fn after_invocation<'life0, 'life1, 'async_trait>( &'life0 self, _result: &'life1 ToolInvocationResult, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called after a tool invocation or hook-provided skip result is recorded.

fn on_invocation_error<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _invocation: &'life1 ToolInvocation, _error: &'life2 KernelError, ) -> Pin<Box<dyn Future<Output = Result<(), KernelError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Called when dispatch stops after this hook may have observed the invocation in Self::before_invocation. Hooks that reserve resources before dispatch should release them here.