Enum FetchError 

#[non_exhaustive]
pub enum FetchError {
    NotEligible {
        source_key: String,
    },
    NoOaAvailable,
    Http(HttpError),
    Log(LogError),
    InvalidRef(RefParseError),
    SourceSchema {
        hint: String,
    },
    TooManyRefs {
        got: usize,
        max: usize,
    },
}

Errors returned by Source::fetch.

At the public CLI / MCP boundary, every variant collapses to an crate::ErrorCode via the From<FetchError> impl below — mirroring the RefParseError → crate::ErrorCode::InvalidRef collapse from PR #55.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NotEligible

The source does not handle the given ref under the runtime capability profile (covers both can_serve = false outcomes and runtime denials raised inside fetch).

Fields

source_key: String

The source key that declined.

NoOaAvailable

Tier 1 sources reported no OA URL for this ref.

Http(HttpError)

Underlying HTTP / network failure. See HttpError.

Log(LogError)

Provenance log write failed. Per docs/SECURITY.md §1.8 this is a fail-closed signal; the surrounding fetch MUST be aborted.

InvalidRef(RefParseError)

Ref re-parse / validation failed inside the source (e.g. when a source receives a borrowed string from upstream and re-validates).

SourceSchema

Source-side schema mismatch (unexpected JSON shape, missing required field). Surfaces to crate::ErrorCode::InternalError at the public boundary.

Fields

hint: String

Human-readable hint at the offending field/path; not parsed.

TooManyRefs

Batch orchestrator received more refs than crate::MAX_BATCH_REFS. Surfaced to the MCP doiget_batch_fetch tool as ErrorCode::InvalidRef (closest closed-set fit — the request shape itself is invalid; no denial_context channel applies). Slice 2 / docs/MCP_TOOLS.md §1.

Fields

got: usize

Number of refs the batch orchestrator was handed.

max: usize

The hard cap (crate::MAX_BATCH_REFS).

Trait Implementations

impl Debug for FetchError

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

Formats the value using the given formatter.

impl Display for FetchError

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

Formats the value using the given formatter.

impl Error for FetchError

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<&FetchError> for ErrorCode

Borrow-form of the collapse above, so a caller that still needs the error for its Display message / denial_context side-channel (notably the CLI human-persona renderer, issue #119) can obtain the closed code without consuming it. The owned impl delegates here so the mapping table lives in exactly one place.

fn from(e: &FetchError) -> ErrorCode

Converts to this type from the input type.

impl From<&FetchError> for Option<DenialContext>

Map a FetchError reference to the structured crate::DenialContext channel introduced by ADR-0023 §4.

&FetchError (rather than FetchError) so the orchestrator can produce the structured side-channel without consuming the error it still needs for error.message and the From<FetchError> for ErrorCode collapse above. The Http arm delegates to the From<&HttpError> for Option<DenialContext> impl in crate::http.

fn from(e: &FetchError) -> Self

Converts to this type from the input type.

impl From<FetchError> for ErrorCode

Map FetchError to the closed crate::ErrorCode set surfaced at the public CLI / MCP boundary. Mirrors the From<RefParseError> for ErrorCode collapse from PR #55.

fn from(e: FetchError) -> ErrorCode

Converts to this type from the input type.

impl From<HttpError> for FetchError

fn from(source: HttpError) -> Self

Converts to this type from the input type.

impl From<LogError> for FetchError

fn from(source: LogError) -> Self

Converts to this type from the input type.

impl From<RefParseError> for FetchError

fn from(source: RefParseError) -> Self

Converts to this type from the input type.