agent-first-http 0.7.3

Give your AI agent its own private browser — so it reads the real page, past logins and bot walls, without ever touching yours.
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
98
99
100
101
102
103
104
105
106
107
108
109

//! `/capabilities` client. Shape from `architecture.md §6`.

use std::collections::BTreeMap;

use serde::{Deserialize, Serialize};

use crate::sdk::client::Client;
use crate::shared::error::{Error, ErrorCode};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CapabilitiesResponse {
    pub code: String,
    pub backend: BackendFamily,
    pub artifacts: BTreeMap<String, ArtifactSupport>,
    pub wait_modes: Vec<String>,
    pub takeover: TakeoverSupport,
    pub profile: ProfileSupport,
    #[serde(default, skip_serializing_if = "BTreeMap::is_empty")]
    pub features: BTreeMap<String, FeatureSupport>,
    pub limits: BTreeMap<String, serde_json::Value>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BackendFamily {
    pub family: String,
    pub version: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ArtifactSupport {
    pub supported: bool,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub source: Option<String>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub body_capture: Vec<String>,
}

/// Human-takeover panel support. `provider` names the concrete screen-share
/// method (`kasmvnc`, …) — open-ended like `BackendFamily.family`, so adding a
/// provider does not change this shape.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TakeoverSupport {
    /// Whether this backend can expose a takeover panel at all when the host is
    /// started with `--takeover-provider <provider>` (false for lightpanda).
    #[serde(default)]
    pub backend_capable: bool,
    /// Whether this host actually has a takeover panel enabled right now.
    pub supported: bool,
    #[serde(default)]
    pub panel_url: Option<String>,
    #[serde(default)]
    pub provider: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ProfileSupport {
    pub persistent: bool,
    pub ephemeral: bool,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct FeatureSupport {
    pub supported: bool,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub detail: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub risk: Option<String>,
}

impl Client {
    pub async fn capabilities(&self) -> Result<CapabilitiesResponse, Error> {
        let endpoint = self.effective_endpoint().await?;
        let base = endpoint.http_base();
        let url = format!("{base}/capabilities");
        let mut req = self.http().get(&url);
        if let Some(token) = self.token() {
            req = req.bearer_auth(token);
        }
        let resp = req
            .send()
            .await
            .map_err(|e| Error::new(ErrorCode::HostUnreachable, format!("GET {url}: {e}")))?;
        let status = resp.status();
        let bytes = resp.bytes().await.map_err(|e| {
            Error::new(
                ErrorCode::InternalError,
                format!("capabilities: read response: {e}"),
            )
        })?;
        if !status.is_success() {
            if let Ok(err) = crate::shared::afdata::decode_error(&bytes) {
                return Err(err);
            }
            return Err(Error::new(
                ErrorCode::InternalError,
                format!(
                    "capabilities: status {status}; failed to decode error envelope: {}",
                    String::from_utf8_lossy(&bytes)
                ),
            ));
        }
        crate::shared::afdata::decode_result(&bytes)
    }

    /// Build a raw CDP request. Returns a [`crate::sdk::cdp::CdpBuilder`].
    pub fn cdp(&self, method: impl Into<String>) -> crate::sdk::cdp::CdpBuilder {
        crate::sdk::cdp::CdpBuilder::new(self.clone(), method)
    }
}