Struct PreToolUseHookAdapter 

pub struct PreToolUseHookAdapter { /* private fields */ }

Adapter that implements PreToolUseHook for a single UserHookSpec whose event is pre_tool_use.

Lifecycle per before_exec call:

1. Skip when the matcher rejects the (tool_name, arguments) pair — Continue(tool_call) with no mutation.
2. Build a HookPayload from the tool call.
3. Run the executor with the spec’s timeout_ms.
4. On Allow, return Continue(tool_call) unchanged.
5. On Mutate { patch }, merge patch.arguments into tool_call.arguments and return Continue.
6. On Block { reason, user_message }, return Block — ActAtom short-circuits the tool call.
7. On Error, apply the spec’s on_error policy:
   • Block → Block { reason = "hook errored: …" }
   • Warn / Allow → log + Continue(tool_call) unchanged.

Implementations

impl PreToolUseHookAdapter

pub fn new(spec: UserHookSpec, executor: Arc<dyn HookExecutor>) -> Self

pub fn with_index( spec: UserHookSpec, executor: Arc<dyn HookExecutor>, index: usize, ) -> Self

Trait Implementations

impl PreToolUseHook for PreToolUseHookAdapter

fn before_exec<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, tool_call: ToolCall, _tool_def: &'life1 ToolDefinition, context: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = PreToolUseDecision> + Send + 'async_trait>>

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