Enum ErrorCode 

pub enum ErrorCode {
    HyperdNotFound,
    FileNotFound,
    UnsupportedFormat,
    SchemaMismatch,
    SqlError,
    TableNotFound,
    EmptyData,
    DiskFull,
    PermissionDenied,
    ReadOnlyViolation,
    ConnectionLost,
    InvalidArgument,
    ResourceBusy,
    InternalError,
}

Machine-readable error codes returned in MCP tool error responses.

Serialized as SCREAMING_SNAKE_CASE (e.g. HYPERD_NOT_FOUND) so LLM clients can pattern-match without parsing prose.

Variants

HyperdNotFound

The hyperd binary was not found at HYPERD_PATH or on PATH.

FileNotFound

A file path argument points to a nonexistent or unreadable file.

UnsupportedFormat

The file extension or explicit format string is not one we handle.

SchemaMismatch

Data doesn’t match the inferred or user-provided schema.

SqlError

SQL syntax error or reference to a nonexistent column.

TableNotFound

A referenced table does not exist in the workspace.

EmptyData

The input data is empty (zero rows or zero columns).

DiskFull

Workspace disk is full or write quota exceeded.

PermissionDenied

Filesystem permission denied on a source or target path.

ReadOnlyViolation

Server is running in read-only mode and the requested operation would mutate state.

ConnectionLost

The connection to hyperd was lost (crash, broken pipe, EOF) or the wire protocol fell out of sync (a bounded drain exhausted without reaching ReadyForQuery, surfacing as a "desynchronized" error message from the hyper-client layer). Either way, the connection is unusable and the MCP server will automatically tear down the crate::engine::Engine and reconnect on the next call.

InvalidArgument

A tool argument is malformed or violates a precondition that the caller can fix (bad alias shape, wrong mode string, reserved name, etc.). Distinct from Self::SchemaMismatch in that the argument itself is wrong, not the data it refers to.

ResourceBusy

A resource (typically a .hyper file) is held by another process and cannot be opened exclusively. Surfaced when ATTACH DATABASE fails because another MCP server or hyperd owns the file.

InternalError

Catch-all for unexpected failures (panics, I/O, lock poisoning).

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 Debug for ErrorCode

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

Formats the value using the given formatter.

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 Copy for ErrorCode

impl Eq for ErrorCode

impl StructuralPartialEq for ErrorCode