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
114
115
116
117
118
119

use super::*;

fn capabilities_with_version(raw_version: &str) -> CodexCapabilities {
    CodexCapabilities {
        cache_key: CapabilityCacheKey {
            binary_path: PathBuf::from("codex"),
        },
        fingerprint: None,
        version: Some(version::parse_version_output(raw_version)),
        features: CodexFeatureFlags::default(),
        probe_plan: CapabilityProbePlan::default(),
        collected_at: SystemTime::now(),
    }
}

fn capabilities_without_version() -> CodexCapabilities {
    CodexCapabilities {
        cache_key: CapabilityCacheKey {
            binary_path: PathBuf::from("codex"),
        },
        fingerprint: None,
        version: None,
        features: CodexFeatureFlags::default(),
        probe_plan: CapabilityProbePlan::default(),
        collected_at: SystemTime::now(),
    }
}

fn capabilities_with_feature_flags(features: CodexFeatureFlags) -> CodexCapabilities {
    CodexCapabilities {
        cache_key: CapabilityCacheKey {
            binary_path: PathBuf::from("codex"),
        },
        fingerprint: None,
        version: None,
        features,
        probe_plan: CapabilityProbePlan::default(),
        collected_at: SystemTime::now(),
    }
}

fn sample_capabilities_snapshot() -> CodexCapabilities {
    CodexCapabilities {
        cache_key: CapabilityCacheKey {
            binary_path: PathBuf::from("/tmp/codex"),
        },
        fingerprint: Some(BinaryFingerprint {
            canonical_path: Some(PathBuf::from("/tmp/codex")),
            modified: Some(SystemTime::UNIX_EPOCH + Duration::from_secs(5)),
            len: Some(1234),
        }),
        version: Some(CodexVersionInfo {
            raw: "codex 3.4.5-beta (commit cafe)".to_string(),
            semantic: Some((3, 4, 5)),
            commit: Some("cafe".to_string()),
            channel: CodexReleaseChannel::Beta,
        }),
        features: CodexFeatureFlags {
            supports_features_list: true,
            supports_output_schema: true,
            supports_add_dir: false,
            supports_mcp_login: true,
        },
        probe_plan: CapabilityProbePlan {
            steps: vec![
                CapabilityProbeStep::VersionFlag,
                CapabilityProbeStep::FeaturesListJson,
                CapabilityProbeStep::ManualOverride,
            ],
        },
        collected_at: SystemTime::UNIX_EPOCH + Duration::from_secs(10),
    }
}

fn sample_capability_overrides() -> CapabilityOverrides {
    CapabilityOverrides {
        snapshot: Some(sample_capabilities_snapshot()),
        version: Some(version::parse_version_output("codex 9.9.9-nightly")),
        features: CapabilityFeatureOverrides {
            supports_features_list: Some(true),
            supports_output_schema: Some(true),
            supports_add_dir: Some(true),
            supports_mcp_login: None,
        },
    }
}

fn capability_snapshot_with_metadata(
    collected_at: SystemTime,
    fingerprint: Option<BinaryFingerprint>,
) -> CodexCapabilities {
    CodexCapabilities {
        cache_key: CapabilityCacheKey {
            binary_path: PathBuf::from("/tmp/codex"),
        },
        fingerprint,
        version: None,
        features: CodexFeatureFlags::default(),
        probe_plan: CapabilityProbePlan::default(),
        collected_at,
    }
}

#[cfg(unix)]
mod exec_and_login;
#[cfg(unix)]
mod feature_parsing_and_guards;
#[cfg(unix)]
mod overrides_and_probe;
#[cfg(unix)]
mod probe_cache_policy;
#[cfg(unix)]
mod probe_working_dir;
#[cfg(unix)]
mod snapshots_and_cache;
#[cfg(unix)]
mod version_and_advisory;
#[cfg(windows)]
mod windows_path_overrides;