Struct ToolHooks 

#[non_exhaustive]
pub struct ToolHooks {
    pub max_result_bytes: Option<usize>,
    pub before: Option<BeforeHook>,
    pub after: Option<AfterHook>,
}

Opt-in hooks applied by crate::tool_hooks::HookedHandler.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

max_result_bytes: Option<usize>

Hard cap on serialized CallToolResult size in bytes. When exceeded, the result is replaced with an is_error=true result carrying a result_too_large structured error. None disables the cap.

before: Option<BeforeHook>

Optional before-hook invoked after arg deserialization, before the wrapped handler is called.

after: Option<AfterHook>

Optional after-hook invoked once per normally-resolved call - that is, on the Deny / Replace / Ok / Err paths. Spawned via tokio::spawn and never blocks the response path.

Not guaranteed under cancellation. If the call_tool future is dropped after a before-hook has run but before the call resolves, the paired after-hook is never spawned. Do not use before/after pairing as a mandatory resource guard; make the after-hook idempotent or tolerant of missing closes (see crate::cancel).

Implementations

impl ToolHooks

pub fn new() -> Self

Construct an empty ToolHooks with no cap and no hooks.

Use the with_* builder methods to populate fields; this avoids the #[non_exhaustive] restriction that prevents struct-literal construction from outside the crate.

pub fn with_max_result_bytes(self, max: usize) -> Self

Set the serialized result size cap in bytes.

pub fn with_before(self, before: BeforeHook) -> Self

Set the before-hook.

pub fn with_after(self, after: AfterHook) -> Self

Set the after-hook.

Trait Implementations

impl Clone for ToolHooks

fn clone(&self) -> ToolHooks

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolHooks

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

Formats the value using the given formatter.

impl Default for ToolHooks

fn default() -> ToolHooks

Returns the “default value” for a type.