alith_interface/llms/api/
error.rs

1use serde::Deserialize;
2
3#[derive(Debug, thiserror::Error)]
4pub enum ClientError {
5    /// Underlying error from reqwest library after an API call was made
6    #[error("http error: {0}")]
7    Reqwest(#[from] reqwest::Error),
8    /// API returns error object with details of API call failure
9    #[error("{:?}: {}", .0.r#type, .0.message)]
10    ApiError(ApiError),
11    /// Error when API returns 503 status code
12    #[error("Service unavailable: {message}")]
13    ServiceUnavailable { message: String },
14    /// Generic error message
15    #[error("Generic error: {message}")]
16    GenericError { message: String },
17    /// Error when a response cannot be deserialized into a Rust type
18    #[error("failed to serialize api request: {0}")]
19    JSONSerialize(serde_json::Error),
20    /// Error when a response cannot be deserialized into a Rust type
21    #[error("failed to deserialize api response: {0}")]
22    JSONDeserialize(serde_json::Error),
23    /// Error from client side validation
24    /// or when builder fails to build request before making API call
25    #[error("invalid args: {0}")]
26    InvalidArgument(String),
27}
28
29/// Wrapper to deserialize the error object nested in "error" JSON key
30#[derive(Debug, Deserialize)]
31pub(crate) struct WrappedError {
32    pub(crate) error: ApiError,
33}
34
35pub(crate) fn map_deserialization_error(e: serde_json::Error, bytes: &[u8]) -> ClientError {
36    tracing::error!(
37        "failed deserialization of: {}",
38        String::from_utf8_lossy(bytes)
39    );
40    ClientError::JSONDeserialize(e)
41}
42
43pub(crate) fn map_serialization_error(e: serde_json::Error) -> ClientError {
44    tracing::error!("failed serialization: {}", e);
45    ClientError::JSONSerialize(e)
46}
47
48#[derive(Debug, Deserialize, Clone)]
49pub struct ApiError {
50    pub message: String,
51    pub r#type: Option<String>,
52    pub param: Option<String>,
53    pub code: Option<String>,
54}