rpc-agent 0.1.5

A modular Rust framework for building RPC-based agents with pluggable provider integrations
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

use std::fmt::Display;

use serde::{Deserialize, Serialize};
use thiserror::Error;

/// Error type used throughout the crate.
#[derive(Error, Debug)]
pub enum Error {
    /// Provider error: the provider returned an error response.
    #[error("provider error: {0}")]
    ProviderError(String),
    /// Authentication error: the provider returned an authentication error.
    #[error("authentication error: {0}")]
    AuthenticationError(String),
    /// Client error: the HTTP client returned an error.
    #[error("client error: {0}")]
    HttpError(#[from] rig::http_client::Error),
    /// Prompt error: the prompt returned an error.
    #[error("prompt error: {0}")]
    PromptError(#[from] rig::completion::PromptError),
    /// IO error: an I/O error occurred.
    #[error("io error: {0}")]
    Io(#[from] std::io::Error),
    /// RPC error: a remote procedure call error occurred.
    #[error("rpc error: {0}")]
    RpcError(#[from] tarpc::client::RpcError),
    /// Invalid JWT credentials: the JWT token is invalid or expired.
    #[error("invalid jwt credentials: {0}")]
    InvalidJWTCredentials(#[from] jsonwebtoken::errors::Error),
    /// No JWT secret found: the JWT secret is not configured.
    #[error("no jwt secret found")]
    NoJWTSecretFound,
}

impl Error {
    fn status(&self) -> u16 {
        match self {
            Error::AuthenticationError(_) | Error::InvalidJWTCredentials(_) => 401,
            Error::HttpError(_)
            | Error::Io(_)
            | Error::PromptError(_)
            | Error::RpcError(_)
            | Error::ProviderError(_)
            | Error::NoJWTSecretFound => 500,
        }
    }
}

/// API error type used for provider-specific error responses.
#[derive(Debug, Deserialize, Serialize)]
pub struct ApiError {
    status: u16,
    message: String,
}

impl Display for ApiError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}: {}", self.status, self.message)
    }
}

impl From<Error> for ApiError {
    fn from(value: Error) -> Self {
        Self {
            status: value.status(),
            message: value.to_string(),
        }
    }
}

impl std::error::Error for ApiError {}