unified-agent-api-codex 0.3.5

Async wrapper around the Codex CLI for programmatic prompting
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

use super::*;

#[cfg(unix)]
#[tokio::test]
async fn mcp_list_get_and_add_map_args_and_parse_json() {
    let dir = tempfile::tempdir().unwrap();
    let script_path = write_fake_codex(
        dir.path(),
        r#"#!/usr/bin/env bash
printf "%s\n" "$@" 1>&2
cat <<'JSON'
{"servers":[{"name":"files"}]}
JSON
"#,
    );

    let client = CodexClient::builder()
        .binary(&script_path)
        .mirror_stdout(false)
        .quiet(true)
        .build();

    let list = client
        .mcp_list(McpListRequest::new().json(true))
        .await
        .unwrap();
    assert_eq!(list.json, Some(json!({"servers": [{"name": "files"}]})));
    assert_eq!(
        list.stderr.lines().collect::<Vec<_>>(),
        vec!["mcp", "list", "--json"]
    );

    let get = client
        .mcp_get(McpGetRequest::new("files").json(true))
        .await
        .unwrap();
    assert_eq!(get.json, Some(json!({"servers": [{"name": "files"}]})));
    assert_eq!(
        get.stderr.lines().collect::<Vec<_>>(),
        vec!["mcp", "get", "--json", "files"]
    );
}

#[cfg(unix)]
#[tokio::test]
async fn mcp_add_maps_transports_and_validates_required_fields() {
    let dir = tempfile::tempdir().unwrap();
    let script_path = write_fake_codex(
        dir.path(),
        r#"#!/usr/bin/env bash
printf "%s\n" "$@"
"#,
    );

    let client = CodexClient::builder()
        .binary(&script_path)
        .mirror_stdout(false)
        .quiet(true)
        .build();

    let stdio = client
        .mcp_add(
            McpAddRequest::stdio("files", vec![OsString::from("node"), OsString::from("srv")])
                .env("TOKEN", "abc"),
        )
        .await
        .unwrap();
    assert_eq!(
        stdio.stdout.lines().collect::<Vec<_>>(),
        vec![
            "mcp",
            "add",
            "files",
            "--env",
            "TOKEN=abc",
            "--",
            "node",
            "srv"
        ]
    );

    let http = client
        .mcp_add(
            McpAddRequest::streamable_http("http", "https://example.test")
                .bearer_token_env_var("TOKEN_ENV"),
        )
        .await
        .unwrap();
    assert_eq!(
        http.stdout.lines().collect::<Vec<_>>(),
        vec![
            "mcp",
            "add",
            "http",
            "--url",
            "https://example.test",
            "--bearer-token-env-var",
            "TOKEN_ENV"
        ]
    );

    let err = client
        .mcp_add(McpAddRequest::stdio("files", Vec::new()))
        .await
        .unwrap_err();
    assert!(matches!(err, CodexError::EmptyMcpCommand));

    let err = client
        .mcp_add(McpAddRequest::streamable_http("bad", "  "))
        .await
        .unwrap_err();
    assert!(matches!(err, CodexError::EmptyMcpUrl));
}