Struct PreToolOutcome 

pub struct PreToolOutcome {
    pub decision: HookDecision,
    pub reason: Option<String>,
    pub updated_args: Option<Value>,
}

BP-10: everything a pre-tool hook can say about one call — a decision, a human-readable reason, and (the rewrite half of the row) REPLACEMENT arguments.

Fields

decision: HookDecision

The hook’s verdict — see HookDecision.

reason: Option<String>

Why, in words. Fed back to the model on a denial; carried to the approval door otherwise.

updated_args: Option<Value>

BP-10 (the “rewrite” half): arguments to run the tool with INSTEAD of the model’s own. None (the default) leaves the call untouched. The rewritten arguments are what the permissions engine then evaluates and what the tool finally receives — a hook cannot launder a denied command by rewriting it past the gate, because the gate runs on the REWRITTEN args.

Implementations

impl PreToolOutcome

pub fn pass() -> Self

No opinion — the pre-BP-10 None return.

pub fn deny(reason: impl Into<String>) -> Self

Refuse the call — the pre-BP-10 Some(reason) return.

pub fn allow(reason: Option<String>) -> Self

Answer an Ask on the user’s behalf.

pub fn ask(reason: Option<String>) -> Self

Force the call to the Ask tier.

pub fn rewrite(args: Value) -> Self

Run the tool with args instead of the model’s own.

Trait Implementations

impl Clone for PreToolOutcome

fn clone(&self) -> PreToolOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PreToolOutcome

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

Formats the value using the given formatter.

impl Default for PreToolOutcome

fn default() -> PreToolOutcome

Returns the “default value” for a type.