Enum PrefetchOutcome 

pub enum PrefetchOutcome {
    Settled {
        tool: String,
        args: Value,
        body: String,
        predicted_cost_tokens: u32,
    },
    Failed {
        tool: String,
        error: PrefetchError,
    },
    Skipped {
        tool: String,
        reason: SkipReason,
    },
}

Outcome of a single prefetch task as observed by SpeculationEngine::wait_within.

Variants

Settled

Prefetch landed within the timeout. The body is ready to write into the dedup cache. predicted_cost_tokens carries the planner’s admit-time estimate so callers can pass it through to telemetry (PipelineEvent.enricher_predicted_cost_tokens).

Fields

tool: String

args: Value

body: String

predicted_cost_tokens: u32

Failed

Prefetch returned an error. Counted as wasted; logged at WARN.

Fields

tool: String

error: PrefetchError

Underlying prefetch error.

Skipped

Prefetch was rate-limited at scheduling time — the engine never even spawned it. Used by callers to attribute the prefetch_dispatched gap.

Fields

tool: String

Tool name.

reason: SkipReason

Reason the dispatch was skipped.

Trait Implementations

impl Debug for PrefetchOutcome

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

Formats the value using the given formatter.