aether-agent-cli 0.3.3

CLI and ACP server for the Aether AI coding agent
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

use crate::error::CliError;
use aether_core::agent_spec::AgentSpec;
use aether_project::AgentCatalog;

pub fn resolve_agent_spec(catalog: &AgentCatalog, agent_name: Option<&str>) -> Result<AgentSpec, CliError> {
    match agent_name {
        Some(name) => catalog.resolve(name).map_err(|e| CliError::AgentError(e.to_string())),

        None => {
            if let Some(selected) = catalog.default_agent() {
                catalog.resolve(&selected.name).map_err(|e| CliError::AgentError(e.to_string()))
            } else {
                let model = "anthropic:claude-sonnet-4-5".parse().map_err(|e: String| CliError::ModelError(e))?;

                Ok(AgentSpec::default_spec(&model, None, Vec::new()))
            }
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    fn write_file(dir: &std::path::Path, path: &str, content: &str) {
        let full = dir.join(path);
        if let Some(parent) = full.parent() {
            std::fs::create_dir_all(parent).unwrap();
        }
        std::fs::write(full, content).unwrap();
    }

    fn setup_catalog(settings_json: &str) -> (tempfile::TempDir, AgentCatalog) {
        let dir = tempfile::tempdir().unwrap();
        write_file(dir.path(), "PROMPT.md", "Be helpful");
        write_file(dir.path(), ".aether/settings.json", settings_json);
        let config = aether_project::AetherSettings::load_default(dir.path()).unwrap();
        let catalog = AgentCatalog::from_settings(dir.path(), config).unwrap();
        (dir, catalog)
    }

    #[test]
    fn resolve_with_explicit_name() {
        let (_dir, catalog) = setup_catalog(
            r#"{"agents": [
                {"name": "first", "description": "First", "model": "anthropic:claude-sonnet-4-5", "userInvocable": true, "prompts": [{"type":"file","path":"PROMPT.md"}]},
                {"name": "second", "description": "Second", "model": "anthropic:claude-sonnet-4-5", "userInvocable": true, "prompts": [{"type":"file","path":"PROMPT.md"}]}
            ]}"#,
        );
        let spec = resolve_agent_spec(&catalog, Some("second")).unwrap();
        assert_eq!(spec.name, "second");
    }

    #[test]
    fn resolve_auto_selects_first_user_invocable() {
        let (_dir, catalog) = setup_catalog(
            r#"{"agents": [
                {"name": "internal", "description": "Internal", "model": "anthropic:claude-sonnet-4-5", "agentInvocable": true, "prompts": [{"type":"file","path":"PROMPT.md"}]},
                {"name": "visible", "description": "Visible", "model": "anthropic:claude-sonnet-4-5", "userInvocable": true, "prompts": [{"type":"file","path":"PROMPT.md"}]}
            ]}"#,
        );
        let spec = resolve_agent_spec(&catalog, None).unwrap();
        assert_eq!(spec.name, "visible");
    }

    #[test]
    fn resolve_falls_back_to_default() {
        let dir = tempfile::tempdir().unwrap();
        let catalog = AgentCatalog::empty(dir.path().to_path_buf());
        let spec = resolve_agent_spec(&catalog, None).unwrap();
        assert_eq!(spec.name, "__default__");
    }

    #[test]
    fn resolve_unknown_name_errors() {
        let (_dir, catalog) = setup_catalog(
            r#"{"agents": [
                {"name": "alpha", "description": "Alpha", "model": "anthropic:claude-sonnet-4-5", "userInvocable": true, "prompts": [{"type":"file","path":"PROMPT.md"}]}
            ]}"#,
        );
        let result = resolve_agent_spec(&catalog, Some("nonexistent"));
        assert!(result.is_err());
    }
}