a2a-rs 0.10.0

Rust implementation of the Agent-to-Agent (A2A) Protocol
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

//! Error types for client adapters

use crate::adapter::error::describe_transport_error;
use crate::domain::A2AError;
use std::io;
use thiserror::Error;

/// Error type for HTTP client adapter
#[derive(Error, Debug)]
#[cfg(any(feature = "http-client", feature = "jsonrpc-client", feature = "auth"))]
pub enum HttpClientError {
    /// Reqwest client error
    #[error("HTTP client error: {0}")]
    Reqwest(#[from] reqwest::Error),

    /// IO error during HTTP operations
    #[error("IO error: {0}")]
    Io(#[from] io::Error),

    /// Error during request processing
    #[error("Request error: {0}")]
    Request(String),

    /// Error with HTTP response
    #[error("Response error: {status} - {message}")]
    Response { status: u16, message: String },

    /// Connection timeout
    #[error("Connection timeout")]
    Timeout,
}

/// A `reqwest::Client`, built rather than `Client::new()`-ed. `new()` unwraps
/// the builder, and since reqwest 0.13 the builder fails on a machine with no
/// CA bundle ("No CA certificates were loaded from the system") — a
/// deployment fault, which is an error to report, not a panic to hit in a
/// constructor. Every reqwest client in this crate comes through here.
#[cfg(any(feature = "http-client", feature = "jsonrpc-client", feature = "auth"))]
pub(crate) fn http_client() -> Result<reqwest::Client, A2AError> {
    reqwest::Client::builder()
        .build()
        .map_err(|e| HttpClientError::Reqwest(e).into())
}

// Conversion from adapter errors to domain errors
#[cfg(any(feature = "http-client", feature = "jsonrpc-client", feature = "auth"))]
impl From<HttpClientError> for A2AError {
    fn from(error: HttpClientError) -> Self {
        match error {
            // Flattened to a string here, so the cause has to come with it —
            // `reqwest::Error` prints none of it on its own.
            HttpClientError::Reqwest(e) => A2AError::Internal(format!(
                "HTTP client error: {}",
                describe_transport_error(&e)
            )),
            HttpClientError::Io(e) => A2AError::Io(e),
            HttpClientError::Request(msg) => {
                A2AError::Internal(format!("HTTP request error: {}", msg))
            }
            HttpClientError::Response { status, message } => {
                A2AError::Internal(format!("HTTP response error: {} - {}", status, message))
            }
            HttpClientError::Timeout => A2AError::Internal("HTTP request timeout".to_string()),
        }
    }
}