Enum ErrorCode 

pub enum ErrorCode {
    InvalidRequest,
    MultiQueryLimitExceeded,
    Unauthorized,
    Forbidden,
    NotFound,
    EmbeddingModelMismatch,
    RunAborted,
    RateLimited,
    Internal,
    ServiceUnavailable,
    CloudUnreachable,
    ModelsMissing,
    TelemetrySchemaInvalid,
}

Canonical machine-readable error codes.

New variants are additive (MINOR bump per Constitution X). Removing or renaming a variant is a MAJOR contract break.

Variants

InvalidRequest

Generic 400 — payload failed validation. context should name the field.

MultiQueryLimitExceeded

400 — queries.length > MIDNIGHT_MANUAL_MAX_QUERIES_PER_REQUEST (D25, FR-088).

Unauthorized

401 — JWT missing, signature invalid, or token expired. Remediation: mnm login.

Forbidden

403 — caller authenticated but lacks the required role for this endpoint.

NotFound

404 — resource not found (source slug, chunk id, etc.).

EmbeddingModelMismatch

409 — client_embedding_model disagrees with the corpus’s active model (D12, FR-038).

RunAborted

409 — write attempted against an ingest_run already in aborted state (FR-022).

RateLimited

429 — per-IP / SSO / CIDR rate-limit budget exhausted (D11, FR-031).

Internal

500 — internal invariant violated. Should be rare; logged with request_id.

ServiceUnavailable

503 — transient backend unavailability (DB down, model not yet loaded). Caller should retry per the Retry-After header (Constitution VI, FR-035).

CloudUnreachable

503 — MCP-tool-side: the local cloud client could not reach the server.

ModelsMissing

503 — MCP-tool-side: local ML model file missing or corrupt; remediation: retry — the reranker loads lazily on first use (or pre-fetch via mnm models pull).

TelemetrySchemaInvalid

500 — telemetry event failed schema validation; dropped server-side (FR-109).

Implementations

impl ErrorCode

pub const fn as_str(self) -> &'static str

Returns the canonical lower_snake_case wire name.

pub const fn http_status(self) -> u16

HTTP status code mapping (server side only; CLI maps codes to exit codes).

Trait Implementations

impl Clone for ErrorCode

fn clone(&self) -> ErrorCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorCode

impl Debug for ErrorCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorCode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ErrorCode

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

Formats the value using the given formatter.

impl Eq for ErrorCode

impl Hash for ErrorCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ErrorCode

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ErrorCode