Enum BootstrapError 

pub enum BootstrapError {
    UnknownTarget {
        target_name: String,
        available: Vec<String>,
    },
    UnknownSlot {
        slot_id: u32,
        available: Vec<u32>,
    },
    AlreadyTransitivelyQueued {
        target_name: String,
    },
    UnknownInput {
        target_name: String,
        input_name: String,
        declared: Vec<String>,
    },
    MissingInput {
        target_name: String,
        input_name: String,
    },
    AllocationFailed {
        target_name: String,
        byte_count: usize,
        budget_remaining: usize,
    },
}

Errors surfaced by host-facing bootstrap staging methods on Node. F3 lands the Node API + validation logic; this commit defines the error taxonomy + display only.

Variants

UnknownTarget

run_bootstrap(BootstrapTarget::ModuleRequests|ModuleNames|Slots) named a target the engine has no bootstrap registration for. Carries the queue snapshot so callers can present the legal set.

Fields

target_name: String

Target name the caller supplied.

available: Vec<String>

Target names currently queued, in install order.

UnknownSlot

run_bootstrap(BootstrapTarget::Slots(...)) named a slot id that does not exist on the target’s input site map. Carries the legal ids so callers can correct the mapping.

Fields

slot_id: u32

Slot id the caller supplied.

available: Vec<u32>

Slot ids declared on the target’s input site map.

AlreadyTransitivelyQueued

The host called run_bootstrap with a target whose inputs are already staged + queued. The host must drive the pending request through to completion (or cancel it) before re-targeting the same name.

Fields

target_name: String

Target name that was already queued.

UnknownInput

run_bootstrap(BootstrapTarget::ModuleRequests(...)) named an input the target does not declare as a formal. Carries the declared set so callers can correct the request.

Fields

target_name: String

Target name the request targeted.

input_name: String

Input name the caller supplied.

declared: Vec<String>

Input names declared as formals on the target.

MissingInput

run_bootstrap(BootstrapTarget::ModuleRequests(...)) is missing a required formal input. Validation fails atomically — no inputs stage when this fires.

Fields

target_name: String

Target name the request targeted.

input_name: String

Input name declared as a formal but not supplied.

AllocationFailed

Bootstrap input staging hit the engine’s ingress_byte_budget cap or the try_reserve_exact seam returned TryReserveError. Carries the offending input’s byte count + the remaining budget at the point of rejection so the host can decide whether to back off, shrink the payload, or raise the cap. Any per-input charges that landed earlier in the same request are released before the engine surfaces this error — the bootstrap state stays untouched.

Fields

target_name: String

Target name the request targeted.

byte_count: usize

Bytes the staging step tried to admit when the cap or allocator rejected the request.

budget_remaining: usize

Bytes still available under ingress_byte_budget at the point of the rejection.

Trait Implementations

impl Clone for BootstrapError

fn clone(&self) -> BootstrapError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BootstrapError

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

Formats the value using the given formatter.

impl Display for BootstrapError

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

Formats the value using the given formatter.

impl Eq for BootstrapError

impl Error for BootstrapError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for BootstrapError

fn eq(&self, other: &BootstrapError) -> 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 StructuralPartialEq for BootstrapError