Struct BeforeIngest 

pub struct BeforeIngest {
    pub source: IngestSource,
    pub input: Vec<ContentBlock>,
}

before Ingest: called before ingesting the current turn’s input. Can rewrite the entire pending input or Break to reject the turn.

This is a mutation hook — the short-circuit is Break (reject), not “fill a result” (there is no separable output). On an empty ingestion turn, input is empty.

The verdict supports two rewriting modes (not mutually exclusive; both can be given):

• input (String / array of String): fully replace the pending input.
• prepend_input (String / array of String): prepend text blocks before the existing input, preserving original blocks (including non-text blocks like images). Used to inject context (e.g., a skill’s auto-activated L1 prompt) before the user’s prompt without losing the original multimodal content.

Fields

source: IngestSource

input: Vec<ContentBlock>

The input to be ingested, which can be rewritten.

Trait Implementations

impl Clone for BeforeIngest

fn clone(&self) -> BeforeIngest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BeforeIngest

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

Formats the value using the given formatter.

impl HookStep for BeforeIngest

fn event_name(&self) -> &'static str

Event name (snake_case). Used in envelope headers and matchers.

fn to_envelope(&self) -> Value

Projects the step into an input envelope — fed to command stdin / prompt templates. Contains a common header plus step-specific fields.

fn apply_verdict( &mut self, verdict: &Value, ) -> Result<HookControl, VerdictError>

Apply the handler’s output verdict (JSON) back to this step: parse the common control / additional_context fields, then handle the step-specific “fill output” fields. Returns a control directive.