Enum HookDecision 

pub enum HookDecision {
    Allow,
    Modify(ModifyPayload),
    Deny {
        reason: String,
        code: i32,
    },
    AskUser {
        prompt: String,
        options: Vec<String>,
        default: Option<String>,
    },
}

The four decision shapes a hook subprocess may return.

See the module-level documentation for the JSON wire contract and the runtime validation rules.

#969 — PartialEq is now derived. Pre-#969 it was hand-rolled on the (mistaken) premise that serde_json::Value was not PartialEq; it IS (serde_json 1.0 derives Eq + PartialEq + Hash on Value). The real blocker for derive(Eq) is Option<f64> inside MemoryDelta, which is PartialEq but not Eq.

Variants

Allow

Continue the memory operation unchanged. Wire shape: {"action":"allow"} (or empty {} / empty stdout).

Modify(ModifyPayload)

Rewrite the in-flight payload before the memory operation runs. Only valid on pre- events; on post- events the dispatcher logs a warning and degrades to Allow.

Deny

Halt the memory operation. reason surfaces in the operator log and (when G7+ wires the executor into the request path) the API response. code is an HTTP-style integer the API surface translates to a status code.

Fields

reason: String

code: i32

AskUser

Pause the chain and surface prompt to the operator alongside options. The chain runner (G5) resumes once the human picks one. default (if present) names the option the runner falls back to on operator timeout.

Fields

prompt: String

options: Vec<String>

default: Option<String>

Implementations

impl HookDecision

pub fn parse(line: &str) -> Result<Self, DecisionParseError>

pub fn degrade_modify_for_post_event(self, event: HookEvent) -> Self

Runtime guard for the pre-event-only constraint on Modify. If self is Modify and event is a post- event, log a warning and return Allow. Otherwise return self unchanged.

The dispatcher (G5) calls this after parsing the child’s decision but before applying the delta, so a misbehaving hook can’t sneak a Modify past a post- event.

Trait Implementations

impl Clone for HookDecision

fn clone(&self) -> HookDecision

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HookDecision

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HookDecision

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for HookDecision

fn eq(&self, other: &HookDecision) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for HookDecision

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for HookDecision