intr-providers 0.1.0

Intentry model provider abstraction - Anthropic, OpenAI, Google, Ollama
Documentation 
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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! Provider error types.

use thiserror::Error;

#[derive(Debug, Error)]
pub enum ProviderError {
    /// HTTP 401/403 - bad API key or access denied. Do not retry.
    #[error("authentication failed for provider '{provider}': {message}")]
    AuthError {
        provider: &'static str,
        message: String,
    },

    /// HTTP 400/422 - we sent bad input. Do not retry.
    #[error("bad request to provider '{provider}': {message}")]
    BadRequest {
        provider: &'static str,
        message: String,
    },

    /// HTTP 429 - rate limited. Retryable.
    #[error("rate limited by provider '{provider}'")]
    RateLimited { provider: &'static str },

    /// HTTP 5xx or network/timeout error. Retryable.
    #[error("provider '{provider}' unavailable: {message}")]
    Unavailable {
        provider: &'static str,
        message: String,
    },

    /// The provider returned a response we couldn't parse.
    #[error("provider '{provider}' returned unparseable response: {message}")]
    ParseError {
        provider: &'static str,
        message: String,
    },

    /// No key was configured for IntentryOwned variant.
    #[error("no API key configured for provider '{provider}'; set {env_var}")]
    MissingApiKey {
        provider: &'static str,
        env_var: &'static str,
    },

    /// Unknown / catch-all.
    #[error("provider error: {0}")]
    Other(#[from] anyhow::Error),
}

impl ProviderError {
    /// Returns `true` if the error is transient and the caller should retry.
    pub fn is_retryable(&self) -> bool {
        matches!(self, Self::RateLimited { .. } | Self::Unavailable { .. })
    }
}