Enum ParserSupervisorError 

pub enum ParserSupervisorError {
    UnsupportedContainment {
        os: &'static str,
        architecture: &'static str,
    },
    PackPath {
        path: PathBuf,
        source: Error,
    },
    InvalidPackPath {
        path: PathBuf,
        reason: &'static str,
    },
    ArtifactRead {
        path: PathBuf,
        source: Error,
    },
    LinuxLaunchAuthority {
        role: &'static str,
        source: Error,
    },
    ArtifactFileTooLarge {
        path: PathBuf,
        actual: u64,
        maximum: u64,
    },
    ArtifactManifestJson {
        source: Error,
    },
    ManifestValidation {
        source: OptionalParserPackManifestError,
    },
    PayloadMismatch {
        path: PathBuf,
        reason: &'static str,
    },
    GrammarNotAccepted {
        language_id: String,
    },
    FixtureExpectationMismatch {
        language_id: String,
        case_name: String,
        actual: bool,
        expected: bool,
    },
    InvalidMemoryLimits {
        process_bytes: u64,
        process_tree_bytes: u64,
    },
    MemoryProbeDidNotBreach {
        process_bytes: u64,
    },
    Protocol {
        source: ParserProtocolError,
    },
    EntropyUnavailable,
    Spawn {
        program: PathBuf,
        source: Error,
    },
    MissingPipe {
        stream: &'static str,
    },
    InvalidAdmission,
    IoThread {
        phase: &'static str,
        message: String,
    },
    Cancelled {
        phase: &'static str,
    },
    DeadlineExceeded {
        phase: &'static str,
    },
    NoProgress {
        phase: &'static str,
    },
    ChildExited {
        phase: &'static str,
        code: Option<i32>,
    },
    ResidentMemoryLimitExceeded {
        phase: &'static str,
        accounting: ParserMemoryAccountingKind,
        observed_bytes: u64,
        maximum_bytes: u64,
        observation_interval_millis: u64,
    },
    ResidentMemoryObservationFailed {
        phase: &'static str,
        accounting: ParserMemoryAccountingKind,
        message: String,
    },
    WorkerFailure {
        code: ParserFailureCode,
    },
    RequestIdentityExhausted,
    Cleanup {
        message: String,
    },
    OperationAndCleanup {
        operation: Box<Self>,
        cleanup: Box<Self>,
    },
}

Failure while validating, running, or cleaning up the optional parser supervisor.

Variants

UnsupportedContainment

The current host has no accepted optional-pack containment adapter.

Fields

os: &'static str

Host operating-system identity.

architecture: &'static str

Host architecture identity.

PackPath

A required pack path could not be canonicalized or inspected.

Fields

path: PathBuf

Path being inspected.

source: Error

Filesystem failure.

InvalidPackPath

A required pack path violated the immutable artifact boundary.

Fields

path: PathBuf

Rejected path.

reason: &'static str

Stable rejection reason.

ArtifactRead

One bounded artifact file could not be read.

Fields

path: PathBuf

Artifact file being read.

source: Error

Filesystem failure.

LinuxLaunchAuthority

Linux could not construct one immutable launch payload.

Fields

role: &'static str

Stable payload responsibility.

source: Error

Operating-system failure.

ArtifactFileTooLarge

One artifact file exceeded its declared byte ceiling.

Fields

path: PathBuf

Oversized file.

actual: u64

Observed bytes.

maximum: u64

Inclusive maximum.

ArtifactManifestJson

The strict artifact manifest could not be decoded.

Fields

source: Error

Strict JSON decoding failure.

ManifestValidation

A logical or artifact manifest invariant failed.

Fields

source: OptionalParserPackManifestError

Typed manifest failure.

PayloadMismatch

An artifact payload did not match its immutable manifest row.

Fields

path: PathBuf

Rejected payload path.

reason: &'static str

Stable rejection reason.

GrammarNotAccepted

A requested grammar is absent from the accepted capability manifest.

Fields

language_id: String

Rejected language identity.

FixtureExpectationMismatch

One accepted fixture produced the opposite root-error state.

Fields

language_id: String

Accepted grammar identity under admission.

case_name: String

Manifest-owned fixture case name.

actual: bool

Identity-validated worker result.

expected: bool

Manifest-declared positive or negative expectation.

InvalidMemoryLimits

An internal release probe requested invalid worker or process-tree ceilings.

Fields

process_bytes: u64

Requested per-worker ceiling.

process_tree_bytes: u64

Requested aggregate process-tree ceiling.

MemoryProbeDidNotBreach

The exact worker completed under a deliberately reduced release-probe ceiling.

Fields

process_bytes: u64

Deliberately reduced ceiling that should be below exact-worker residency.

Protocol

A parser protocol invariant failed.

Fields

source: ParserProtocolError

Typed protocol failure.

EntropyUnavailable

Operating-system entropy was unavailable for a fresh worker session.

Spawn

The exact worker or containment broker could not be started.

Fields

program: PathBuf

Exact verified executable.

source: Error

Process creation failure.

MissingPipe

A required child protocol pipe was not created.

Fields

stream: &'static str

Missing standard-stream identity.

InvalidAdmission

The Windows broker did not emit the exact admission record.

IoThread

A bounded I/O thread failed.

Fields

phase: &'static str

Stable I/O phase.

message: String

Bounded failure detail.

Cancelled

The caller requested cooperative cancellation.

Fields

phase: &'static str

Stable operation phase.

DeadlineExceeded

The caller-owned absolute deadline elapsed.

Fields

phase: &'static str

Stable operation phase.

NoProgress

No meaningful progress occurred within the caller limit.

Fields

phase: &'static str

Stable operation phase.

ChildExited

The direct child exited before completing its protocol operation.

Fields

phase: &'static str

Stable operation phase.

code: Option<i32>

Portable process exit code when available.

ResidentMemoryLimitExceeded

Linux resident memory reached its configured ceiling and the worker group was terminated.

Fields

phase: &'static str

Stable operation phase.

accounting: ParserMemoryAccountingKind

Active Linux accounting path.

observed_bytes: u64

Last observed resident or cgroup memory bytes.

maximum_bytes: u64

Inclusive configured ceiling.

observation_interval_millis: u64

Declared maximum sampling interval.

ResidentMemoryObservationFailed

Linux resident-memory accounting became unreadable while the worker was live.

Fields

phase: &'static str

Stable operation phase.

accounting: ParserMemoryAccountingKind

Accounting path that failed closed.

message: String

Bounded failure detail.

WorkerFailure

The worker returned an identity-validated closed failure.

Fields

code: ParserFailureCode

Closed worker failure code.

RequestIdentityExhausted

The session-local request identity space was exhausted.

Cleanup

Child-tree termination, pipe draining, reaping, or thread joining failed.

Fields

message: String

Bounded cleanup detail.

OperationAndCleanup

An operation failed and its mandatory cleanup also failed.

Fields

operation: Box<Self>

Original typed operation failure.

cleanup: Box<Self>

Typed cleanup failure.

Implementations

impl ParserSupervisorError

pub const fn has_mandatory_cleanup_failure(&self) -> bool

Return whether mandatory process, pipe, reap, or thread cleanup failed.

Self::OperationAndCleanup is itself a cleanup failure even when its operation or cleanup branch contains another nested combined failure.

Trait Implementations

impl Debug for ParserSupervisorError

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

Formats the value using the given formatter.

impl Display for ParserSupervisorError

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

Formats the value using the given formatter.

impl Error for ParserSupervisorError

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 From<OptionalParserPackManifestError> for ParserSupervisorError

fn from(source: OptionalParserPackManifestError) -> Self

Converts to this type from the input type.

impl From<ParserProtocolError> for ParserSupervisorError

fn from(source: ParserProtocolError) -> Self

Converts to this type from the input type.

impl From<ParserSupervisorError> for OptionalParserPackLifecycleError

fn from(source: ParserSupervisorError) -> Self

Converts to this type from the input type.