agent-first-http 0.8.0

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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

//! Integration test: `--browser chrome_shell` launches chrome-headless-shell
//! and exposes the same capability matrix as the default chromium backend.
//! Gated on `AFHTTP_TEST_CHROME_SHELL_BIN` (or the standard install path);
//! Dockerfile.test pre-installs it on linux64.

#![cfg(feature = "host")]
#![allow(
    clippy::unwrap_used,
    clippy::expect_used,
    clippy::panic,
    clippy::disallowed_methods,
    clippy::disallowed_macros,
    clippy::err_expect,
    clippy::print_stdout,
    clippy::useless_conversion
)]

mod support;

use std::sync::Arc;
use std::time::Duration;

use agent_first_http::host::bootstrap::{
    BrowserChoice, DisplayMode, HealthPublic, HostArgs, ProfileChoice, Takeover,
};
use agent_first_http::host::{browser, listener::router_for_tests, listener::test_state};
use agent_first_http::sdk::Client;
use agent_first_http::sdk::fetch::RenderMode;
use agent_first_http::shared::artifacts::Artifact;
use tokio::net::TcpListener;

async fn spawn_host_with_chrome_shell() -> Option<(String, tempfile::TempDir)> {
    support::ensure_rustls_provider();
    let bin = support::env::discover_chrome_shell()?;
    let args = HostArgs {
        listen: "tcp:127.0.0.1:0".into(),
        profile: ProfileChoice::Ephemeral,
        display: DisplayMode::Headless,
        takeover: Takeover::Off,
        display_quality: 100,
        browser: BrowserChoice::ChromeShell,
        browser_bin: Some(bin),
        token: None,
        takeover_enabled: true,
        health_enabled: true,
        health_public: HealthPublic::Off,
        engine_envs: Vec::new(),
        browser_args: Vec::new(),
        proxy: None,
        recent_requests_cap: 0,
    };
    let handle = browser::launch(&args).await.expect("chrome-shell launch");
    let state = test_state(None, HealthPublic::Off).with_default_browser(Arc::new(handle));
    let app = router_for_tests(state);
    let listener = TcpListener::bind("127.0.0.1:0").await.expect("bind");
    let addr = listener.local_addr().expect("local_addr");
    tokio::spawn(async move {
        let _ = axum::serve(listener, app).await;
    });
    tokio::time::sleep(Duration::from_millis(50)).await;
    let tmp = tempfile::tempdir().expect("tmpdir");
    Some((format!("ws://{addr}"), tmp))
}

#[tokio::test]
async fn chrome_shell_exposes_full_capability_matrix() {
    let Some((endpoint, _tmp)) = spawn_host_with_chrome_shell().await else {
        println!("(skipping: no chrome-headless-shell binary; set AFHTTP_TEST_CHROME_SHELL_BIN)");
        return;
    };
    let client = Client::connect(&endpoint).expect("client");
    let caps = client.capabilities().await.expect("capabilities");
    // chrome-headless-shell is the same engine as chromium; full matrix expected.
    assert!(
        caps.artifacts["body"].supported,
        "body artifact must be supported on chrome-headless-shell",
    );
    assert!(
        caps.artifacts["rendered_html"].supported,
        "rendered_html must be supported on chrome-headless-shell",
    );
    assert!(
        caps.artifacts["screenshot"].supported,
        "screenshot must be supported on chrome-headless-shell",
    );
    assert!(
        caps.artifacts["observation"].supported,
        "observation must be supported on chrome-headless-shell",
    );
    assert!(
        caps.artifacts["network"].supported,
        "network must be supported on chrome-headless-shell",
    );
}

#[tokio::test]
async fn chrome_shell_browser_fetch_returns_rendered_html() {
    let Some((endpoint, tmp)) = spawn_host_with_chrome_shell().await else {
        println!("(skipping: no chrome-headless-shell binary; set AFHTTP_TEST_CHROME_SHELL_BIN)");
        return;
    };
    let fixture = support::fixture_server::spawn().await;
    let url = format!("{}/plain.html", fixture.base_url());
    let client = Client::connect(&endpoint).expect("client");
    let result = client
        .fetch(url)
        .render(RenderMode::Always)
        .timeout(Duration::from_secs(15))
        .want([Artifact::RenderedHtml])
        .out_dir(tmp.path().to_path_buf())
        .send()
        .await
        .expect("browser fetch via chrome-headless-shell");
    assert_eq!(result.status, 200);
    let path = result
        .rendered_html_file
        .as_ref()
        .expect("rendered_html_file");
    let html = std::fs::read_to_string(path).expect("read rendered");
    assert!(
        html.contains("Hello"),
        "rendered HTML should include fixture body, got: {html}"
    );
}