behest 0.3.0

A Rust-native cloud agent runtime with typed tools, pluggable memory, queues, and observability.
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

//! Shared HTTP client construction and request helpers.

use std::time::Duration;

use reqwest::{Client, ClientBuilder, RequestBuilder, StatusCode};
use secrecy::ExposeSecret;

use crate::error::ProviderError;
use crate::provider::ProviderHttpConfig;
use crate::provider::ProviderId;

/// Builds a configured [`reqwest::Client`] from provider HTTP settings.
///
/// # Errors
///
/// Returns [`ProviderError::Transport`] when the underlying client builder fails.
pub(crate) fn build_client(config: &ProviderHttpConfig) -> Result<Client, ProviderError> {
    ClientBuilder::new()
        .timeout(config.timeout)
        .connect_timeout(config.connect_timeout)
        .build()
        .map_err(|source| ProviderError::Transport {
            provider: config.id.clone(),
            source,
        })
}

/// Applies a bearer token authorization header when an API key is configured.
pub(crate) fn with_bearer_auth(
    builder: RequestBuilder,
    config: &ProviderHttpConfig,
) -> RequestBuilder {
    match &config.api_key {
        Some(key) => {
            let header_value = format!("Bearer {}", key.expose_secret());
            builder.header("Authorization", header_value)
        }
        None => builder,
    }
}

/// Maps an HTTP response status code to a [`ProviderError`].
///
/// The `retry_after_secs` parameter is extracted from the `Retry-After` response
/// header by the caller and passed explicitly because this function operates on
/// body text only.
pub(crate) fn status_to_error(
    provider: &ProviderId,
    status: StatusCode,
    body_text: &str,
    retry_after_secs: Option<u64>,
) -> ProviderError {
    let retry_after = retry_after_secs.map(Duration::from_secs);
    match status.as_u16() {
        401 | 403 => ProviderError::Authentication {
            provider: provider.clone(),
        },
        400 => ProviderError::BadRequest {
            provider: provider.clone(),
            message: truncate_body(body_text),
        },
        429 => ProviderError::RateLimited {
            provider: provider.clone(),
            retry_after,
        },
        500..=599 => ProviderError::Overloaded {
            provider: provider.clone(),
        },
        _ => ProviderError::Provider {
            provider: provider.clone(),
            status: Some(status.as_u16()),
            message: truncate_body(body_text),
        },
    }
}

/// Extracts the `Retry-After` header value as seconds, if present.
///
/// Supports the integer form (e.g. `120`). The HTTP-date form is not
/// yet parsed and returns `None`.
pub(crate) fn parse_retry_after(headers: &reqwest::header::HeaderMap) -> Option<u64> {
    headers
        .get(reqwest::header::RETRY_AFTER)
        .and_then(|v| v.to_str().ok())
        .and_then(|s| s.parse::<u64>().ok())
}

fn truncate_body(body: &str) -> String {
    if body.len() <= 512 {
        return body.to_owned();
    }
    let mut end = 512;
    while end > 0 && !body.is_char_boundary(end) {
        end -= 1;
    }
    format!("{}...", &body[..end])
}