Enum Eagle3SessionError 

pub enum Eagle3SessionError {
    Init,
    Process,
    Begin,
    Draft,
    Accept,
    PromptTooLong {
        size: usize,
        maximum: usize,
    },
    IncompatibleContexts(&'static str),
    BadSeqId {
        seq_id: i32,
        n_seq: u32,
    },
    InvalidConfig(&'static str),
    Decode(DecodeError),
    ProposalPending {
        seq_id: i32,
    },
    NoPendingProposal {
        seq_id: i32,
    },
    AcceptedTooMany {
        accepted: u16,
        proposed: usize,
    },
    State(SpeculativeStateError),
}

Errors raised by the EAGLE-3 draft session.

Variants

Init

Returned when session init fails. The most common cause is that draft was not built from a valid EAGLE-3 draft model (upstream expects a draft model exposing exactly 3 target-extract layers), or that one of the contexts is incompatible.

Process

process returned false on the underlying speculative context.

Begin

Native prompt initialization failed or raised a contained exception.

Draft

Native draft generation failed or raised a contained exception.

Accept

Native proposal acceptance failed or raised a contained exception.

PromptTooLong

Prompt storage exceeds the safe speculative-session bound.

Fields

size: usize

Caller-supplied prompt-token count.

maximum: usize

Inclusive safe prompt-token bound.

IncompatibleContexts(&'static str)

The supplied contexts do not satisfy the native EAGLE-3 contract.

BadSeqId

Caller passed a sequence id outside [0, n_seq).

Fields

seq_id: i32

the offending seq id

n_seq: u32

configured number of sequences

InvalidConfig(&'static str)

Invalid session configuration (e.g. n_draft_max <= 0).

Decode(DecodeError)

The target context failed to decode.

ProposalPending

An operation requires all draft proposals to be completed first.

Fields

seq_id: i32

Sequence with a pending proposal.

NoPendingProposal

accept was called without a preceding nonempty draft.

Fields

seq_id: i32

Sequence without a pending proposal.

AcceptedTooMany

The accepted prefix exceeds the proposal length.

Fields

accepted: u16

Accepted prefix length.

proposed: usize

Exact proposal length.

State(SpeculativeStateError)

Exact speculative-state capture or restore failed.

Trait Implementations

impl Debug for Eagle3SessionError

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

Formats the value using the given formatter.

impl Display for Eagle3SessionError

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

Formats the value using the given formatter.

impl Error for Eagle3SessionError

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<DecodeError> for Eagle3SessionError

fn from(source: DecodeError) -> Self

Converts to this type from the input type.

impl From<SpeculativeStateError> for Eagle3SessionError

fn from(source: SpeculativeStateError) -> Self

Converts to this type from the input type.