browser-automation-cli 0.1.1

One-shot browser automation CLI for AI agents via Chrome CDP. BORN EXECUTE FINALIZE DIE. No daemon, no npm, no telemetry.
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

//! Gate: success/error JSON envelopes expose stable agent fields.
//! Behavior-Closed DoD requires more than `--help` presence.

use assert_cmd::cargo::cargo_bin_cmd;
use serde_json::Value;

fn parse_stdout(assert: &assert_cmd::assert::Assert) -> Value {
    let stdout = &assert.get_output().stdout;
    serde_json::from_slice(stdout).expect("stdout must be JSON")
}

#[test]
fn version_envelope_has_schema_ok_data() {
    let assert = cargo_bin_cmd!("browser-automation-cli")
        .args(["--json", "version"])
        .assert()
        .success();
    let v = parse_stdout(&assert);
    assert_eq!(v["schema_version"], 1);
    assert_eq!(v["ok"], true);
    assert!(v.get("data").is_some());
    assert_eq!(v["data"]["name"], "browser-automation-cli");
}

#[test]
fn commands_json_includes_devtools_tool_map() {
    let assert = cargo_bin_cmd!("browser-automation-cli")
        .args(["commands", "--json"])
        .assert()
        .success();
    let v = parse_stdout(&assert);
    assert_eq!(v["ok"], true);
    let data = &v["data"];
    assert!(data["commands"]
        .as_array()
        .unwrap()
        .iter()
        .any(|c| c.as_str() == Some("text")));
    assert!(data["commands"]
        .as_array()
        .unwrap()
        .iter()
        .any(|c| c.as_str() == Some("scroll")));
    assert!(data["commands"]
        .as_array()
        .unwrap()
        .iter()
        .any(|c| c.as_str() == Some("cookie")));
    let map = data["devtools_tool_map"].as_array().expect("tool map");
    assert!(
        map.len() >= 50,
        "expected full DevTools map, got {}",
        map.len()
    );
    assert_eq!(data["binary"], "browser-automation-cli");
}

#[test]
fn global_flags_present_in_root_help() {
    let assert = cargo_bin_cmd!("browser-automation-cli")
        .args(["--help"])
        .assert()
        .success();
    let help = String::from_utf8_lossy(&assert.get_output().stdout);
    for needle in [
        "--quiet",
        "--verbose",
        "--debug",
        "--step-timeout",
        "--headed",
        "--json",
    ] {
        assert!(help.contains(needle), "root help missing {needle}");
    }
}

#[test]
fn text_scroll_cookie_registered_in_help() {
    for (cmd, needles) in [
        (&["text", "--help"][..], &["target"][..]),
        (&["scroll", "--help"][..], &["delta-x", "delta-y"][..]),
        (&["cookie", "--help"][..], &["list", "set", "clear"][..]),
        (&["page", "select", "--help"][..], &["page-id"][..]),
    ] {
        let assert = cargo_bin_cmd!("browser-automation-cli")
            .args(cmd)
            .assert()
            .success();
        let help = String::from_utf8_lossy(&assert.get_output().stdout);
        for n in needles {
            assert!(
                help.contains(n),
                "{} help missing `{n}`:\n{help}",
                cmd.join(" ")
            );
        }
    }
}

#[test]
fn usage_error_envelope_shape() {
    let assert = cargo_bin_cmd!("browser-automation-cli")
        .args(["--json", "schema", "--cmd", "___no_such_command___"])
        .assert()
        .failure();
    let v = parse_stdout(&assert);
    assert_eq!(v["schema_version"], 1);
    assert_eq!(v["ok"], false);
    assert!(v["error"]["kind"].is_string());
    assert!(v["error"]["message"].is_string());
    assert!(v["error"]["exit_code"].is_number());
}