rig-model-meta 0.1.0

Provider-agnostic model metadata (context window, capabilities, quantization) and probe traits for Rig agents.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

//! Typed error variants for probe failures.
//!
//! The probe trait returns `Result<Option<ModelDescriptor>, ProbeError>`:
//! `Ok(None)` means "this probe does not know that model" (the common case),
//! while `Err(ProbeError::...)` is reserved for hard failures (transport
//! down, malformed response, auth rejection).

use thiserror::Error;

/// Errors surfaced by [`crate::ModelMetaProbe`] implementations.
///
/// "Unknown model" is **not** an error — probes return `Ok(None)` for that.
/// `ProbeError` exists for cases where the probe could not even attempt the
/// lookup (network failure, malformed manifest, etc.).
#[derive(Debug, Error)]
#[non_exhaustive]
pub enum ProbeError {
    /// The underlying transport (HTTP, IPC, file) failed before a response
    /// could be parsed.
    #[error("transport error: {0}")]
    Transport(String),

    /// A response was received but could not be parsed into a known shape.
    #[error("parse error: {0}")]
    Parse(String),

    /// The provider rejected the request (e.g. missing credentials, 401, 403).
    #[error("unauthorized")]
    Unauthorized,

    /// Catch-all for provider-specific failures that don't map to the above.
    #[error("{0}")]
    Other(String),
}