Enum ArtifactError 

pub enum ArtifactError {
    TooShort {
        needed: usize,
        got: usize,
    },
    InvalidMagic {
        got: [u8; 4],
    },
    UnsupportedFormatVersion {
        found: u32,
        supported: u32,
    },
    ChecksumMismatch,
    CorruptPayload {
        at: usize,
        detail: String,
    },
    InconsistentVectorWidth {
        expected: usize,
        got: usize,
    },
    VectorNotNormalized {
        id: String,
    },
    NonEmptyZeroDim,
    InvalidVector {
        id: String,
        detail: String,
    },
    IncompatibleMerge {
        detail: String,
    },
    Embedder(EmbedderError),
}

Failure building or loading a binary embedding artifact.

Variants

TooShort

File shorter than the format prefix or declared payload length.

Fields

needed: usize

Minimum bytes required at this check.

got: usize

Bytes actually available.

InvalidMagic

Magic bytes were not RAT1.

Fields

got: [u8; 4]

Four bytes read where the magic should be.

UnsupportedFormatVersion

format_version is newer than this binary supports.

Fields

found: u32

Version stamped in the file.

supported: u32

Highest version this binary can read.

ChecksumMismatch

Payload SHA-256 did not match the checksum in the file prefix.

CorruptPayload

Payload bytes failed structural decode after a valid checksum.

Fields

at: usize

Byte offset into the payload where decode failed.

detail: String

Human-readable reason for the failure.

InconsistentVectorWidth

Embedder returned vectors of mixed widths in one build batch.

Fields

expected: usize

Width of the first vector in the batch.

got: usize

Width of the diverging vector.

VectorNotNormalized

Embedder returned a vector that is not L2-normalized.

Fields

id: String

Catalog id of the item whose vector failed the unit-norm check.

NonEmptyZeroDim

Non-empty artifact declared dim == 0 (invalid embedding space).

InvalidVector

A vector failed semantic checks (non-finite or not unit-normalized). Raised for embedder output during [build_artifact] and for vectors decoded from checksum-valid RAT1. Distinct from Self::VectorNotNormalized, which is the build-time failure for finite non-unit embedder vectors.

Fields

id: String

Catalog id of the failing entry.

detail: String

Short deterministic reason (non-finite component, not unit-normalized).

IncompatibleMerge

Valid artifacts that cannot be combined (header mismatch or duplicate (kind, id)). Not Self::CorruptPayload: each input may decode alone.

Fields

detail: String

Why the parts cannot be combined.

Embedder(EmbedderError)

Underlying embedder failure during [build_artifact].

Trait Implementations

impl Clone for ArtifactError

fn clone(&self) -> ArtifactError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArtifactError

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

Formats the value using the given formatter.

impl Display for ArtifactError

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

Formats the value using the given formatter.

impl Error for ArtifactError

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<ArtifactError> for WarmError

fn from(value: ArtifactError) -> Self

Converts to this type from the input type.

impl From<EmbedderError> for ArtifactError

fn from(value: EmbedderError) -> Self

Converts to this type from the input type.