ππΌββοΈ The blackboard for coding agents - agentic development environment for claude code, codex, cursor, opencode, grok and more.
Rust adeai-agentsclaudeclaude-codecodexcursorgeminigrokopencodespec-driven-developmentvibe-codingvim
use agtx::agent::{known_agents, parse_agent_selection, AgentOperations, CodingAgent};
use agtx::skills::{agent_native_skill_dir, transform_plugin_command};
#[test]
fn test_parse_agent_selection_empty_defaults_to_first() {
assert_eq!(parse_agent_selection("", 3), Some(0));
assert_eq!(parse_agent_selection(" ", 3), Some(0));
assert_eq!(parse_agent_selection("\n", 3), Some(0));
}
#[test]
fn test_parse_agent_selection_valid_numbers() {
assert_eq!(parse_agent_selection("1", 3), Some(0));
assert_eq!(parse_agent_selection("2", 3), Some(1));
assert_eq!(parse_agent_selection("3", 3), Some(2));
}
#[test]
fn test_parse_agent_selection_trims_whitespace() {
assert_eq!(parse_agent_selection(" 2 ", 3), Some(1));
assert_eq!(parse_agent_selection("1\n", 3), Some(0));
}
#[test]
fn test_parse_agent_selection_out_of_range() {
assert_eq!(parse_agent_selection("0", 3), None);
assert_eq!(parse_agent_selection("4", 3), None);
assert_eq!(parse_agent_selection("100", 3), None);
}
#[test]
fn test_parse_agent_selection_invalid_input() {
assert_eq!(parse_agent_selection("abc", 3), None);
assert_eq!(parse_agent_selection("-1", 3), None);
assert_eq!(parse_agent_selection("1.5", 3), None);
}
#[test]
fn test_parse_agent_selection_single_agent() {
assert_eq!(parse_agent_selection("1", 1), Some(0));
assert_eq!(parse_agent_selection("2", 1), None);
assert_eq!(parse_agent_selection("", 1), Some(0));
}
// =============================================================================
// Tests for known_agents and build_interactive_command
// =============================================================================
#[test]
fn test_known_agents_includes_cursor() {
let agents = known_agents();
let cursor = agents.iter().find(|a| a.name == "cursor");
assert!(cursor.is_some(), "cursor should be in known_agents");
let cursor = cursor.unwrap();
assert_eq!(cursor.command, "agent");
assert_eq!(cursor.co_author, "Cursor Agent <[email protected]>");
}
#[test]
fn test_known_agents_includes_all_expected() {
let agents = known_agents();
let names: Vec<&str> = agents.iter().map(|a| a.name.as_str()).collect();
for expected in &[
"claude",
"codex",
"copilot",
"gemini",
"opencode",
"cursor",
"grok",
"antigravity",
] {
assert!(names.contains(expected), "missing agent: {}", expected);
}
}
#[test]
fn test_build_interactive_command_cursor_no_prompt() {
let agents = known_agents();
let cursor = agents.iter().find(|a| a.name == "cursor").unwrap();
assert_eq!(cursor.build_interactive_command(""), "agent --yolo --trust");
}
#[test]
fn test_build_interactive_command_cursor_with_prompt() {
let agents = known_agents();
let cursor = agents.iter().find(|a| a.name == "cursor").unwrap();
assert_eq!(
cursor.build_interactive_command("do something"),
"agent --yolo --trust 'do something'"
);
}
#[test]
fn test_build_interactive_command_cursor_escapes_single_quotes() {
let agents = known_agents();
let cursor = agents.iter().find(|a| a.name == "cursor").unwrap();
let cmd = cursor.build_interactive_command("it's a test");
assert!(cmd.contains("agent --yolo"), "should use agent --yolo");
assert!(cmd.contains("it"), "prompt content should be present");
}
#[test]
fn test_build_interactive_command_existing_agents_unchanged() {
let agents = known_agents();
let by_name = |n: &str| agents.iter().find(|a| a.name == n).unwrap().clone();
assert_eq!(
by_name("claude").build_interactive_command(""),
"claude --dangerously-skip-permissions"
);
assert_eq!(
by_name("codex").build_interactive_command(""),
"codex --sandbox workspace-write"
);
assert_eq!(
by_name("gemini").build_interactive_command(""),
"GEMINI_TRUST_WORKSPACE=true gemini --approval-mode yolo"
);
assert_eq!(
by_name("opencode").build_interactive_command(""),
"opencode"
);
}
// =============================================================================
// Tests for build_resume_command
// =============================================================================
#[test]
fn test_build_resume_command_all_agents() {
let agents = known_agents();
let by_name = |n: &str| agents.iter().find(|a| a.name == n).unwrap().clone();
assert_eq!(
by_name("claude").build_resume_command(),
"claude --dangerously-skip-permissions --continue"
);
assert_eq!(
by_name("codex").build_resume_command(),
"codex resume --last"
);
assert_eq!(
by_name("copilot").build_resume_command(),
"copilot --allow-all-tools --continue"
);
assert_eq!(
by_name("gemini").build_resume_command(),
"GEMINI_TRUST_WORKSPACE=true gemini --approval-mode yolo --resume"
);
assert_eq!(
by_name("opencode").build_resume_command(),
"opencode --continue"
);
assert_eq!(
by_name("cursor").build_resume_command(),
"agent --yolo --trust --continue"
);
assert_eq!(
by_name("grok").build_resume_command(),
"grok --yolo --trust --continue"
);
assert_eq!(
by_name("antigravity").build_resume_command(),
"agy --dangerously-skip-permissions --mode accept-edits --continue"
);
}
#[test]
fn test_build_resume_command_unknown_agent_falls_back_to_interactive() {
use agtx::agent::Agent;
let agent = Agent::new(
"custom-agent",
"my-agent",
"A custom agent",
"Custom <[email protected]>",
);
// Unknown agent should fall back to build_interactive_command("")
assert_eq!(
agent.build_resume_command(),
agent.build_interactive_command("")
);
}
// === build_orchestrator_command ===
#[test]
fn test_build_orchestrator_command_claude_is_idempotent() {
let agents = known_agents();
let claude = agents.iter().find(|a| a.name == "claude").unwrap().clone();
let ops = CodingAgent::new(claude);
let cmd = ops.build_orchestrator_command("{\"type\":\"stdio\"}", "/usr/bin/agtx");
let pre_remove_idx = cmd
.find("claude mcp remove agtx-orchestrator")
.expect("pre-remove stale registration");
let add_idx = cmd
.find("claude mcp add-json agtx-orchestrator")
.expect("register MCP");
assert!(
pre_remove_idx < add_idx,
"pre-remove must precede add-json:\n{cmd}"
);
// Must NOT register under the bare `agtx` name: that collides with an `agtx`
// server defined in another scope (plugin / user / .mcp.json) and makes
// Claude Code report a configuration conflict and refuse to connect.
assert!(
!cmd.contains("add-json agtx "),
"must register under a unique name, not bare `agtx`:\n{cmd}"
);
// The JSON is a plainly single-quoted word. Pre-escaping it as
// `'\''{json}'\''` because `create_window` interpolated this command raw into
// `sh -c 'β¦'`; that wrapper now quotes what it is given, so pre-escaping here
// double-escapes and the pane dies on an unterminated quote before
// `add-json` ever runs. The end-to-end guarantee β the JSON reaching `claude`
// as one intact argument through both layers β is asserted in
// `tmux::operations::tests::the_orchestrator_command_reaches_claude_with_its_json_intact`.
assert!(
!cmd.contains(r"'\''"),
"JSON quotes must not be pre-escaped; the tmux wrapper quotes this command:\n{cmd}"
);
assert!(
cmd.contains(r#"add-json agtx-orchestrator '{"type":"stdio"}'"#),
"JSON must be a plainly single-quoted word:\n{cmd}"
);
let pre_section = &cmd[..add_idx];
assert!(
pre_section.contains("|| true") || pre_section.contains("2>/dev/null"),
"pre-remove must tolerate missing prior state:\n{cmd}"
);
assert!(
cmd.contains("&& claude"),
"&& must gate interactive claude:\n{cmd}"
);
}
// =============================================================================
// Tests for cursor skill integration
// =============================================================================
#[test]
fn test_cursor_has_native_skill_dir() {
let dir = agent_native_skill_dir("cursor");
assert_eq!(dir, Some((".cursor/skills", "")));
}
#[test]
fn test_cursor_transform_plugin_command() {
// Cursor: colon β hyphen, slash kept
assert_eq!(
transform_plugin_command("/agtx:plan", "cursor"),
Some("/agtx-plan".to_string())
);
assert_eq!(
transform_plugin_command("/gsd:plan-phase", "cursor"),
Some("/gsd-plan-phase".to_string())
);
}
#[test]
fn test_codex_transform_plugin_command_unchanged() {
// Codex: slash β dollar, colon β hyphen
assert_eq!(
transform_plugin_command("/agtx:plan", "codex"),
Some("$agtx-plan".to_string())
);
}
#[test]
fn test_copilot_has_no_transform() {
// Copilot: no interactive command transform
assert_eq!(transform_plugin_command("/agtx:plan", "copilot"), None);
}
// =============================================================================
// Tests for grok (xAI Grok Build) integration
// =============================================================================
#[test]
fn test_known_agents_includes_grok() {
let agents = known_agents();
let grok = agents.iter().find(|a| a.name == "grok");
assert!(grok.is_some(), "grok should be in known_agents");
let grok = grok.unwrap();
assert_eq!(grok.command, "grok");
assert_eq!(grok.co_author, "Grok <[email protected]>");
}
#[test]
fn test_build_interactive_command_grok_no_prompt() {
let agents = known_agents();
let grok = agents.iter().find(|a| a.name == "grok").unwrap();
assert_eq!(grok.build_interactive_command(""), "grok --yolo --trust");
}
#[test]
fn test_build_interactive_command_grok_with_prompt() {
let agents = known_agents();
let grok = agents.iter().find(|a| a.name == "grok").unwrap();
assert_eq!(
grok.build_interactive_command("do something"),
"grok --yolo --trust 'do something'"
);
}
#[test]
fn test_build_interactive_command_grok_escapes_single_quotes() {
let agents = known_agents();
let grok = agents.iter().find(|a| a.name == "grok").unwrap();
let cmd = grok.build_interactive_command("it's a test");
assert!(
cmd.starts_with("grok --yolo --trust "),
"should use grok --yolo --trust: {cmd}"
);
// The quote must be escaped for the outer sh -c wrapper, not left bare.
assert!(
cmd.contains("'\"'\"'"),
"single quote must be escaped: {cmd}"
);
}
#[test]
fn test_grok_has_native_skill_dir() {
let dir = agent_native_skill_dir("grok");
assert_eq!(dir, Some((".grok/skills", "")));
}
#[test]
fn test_grok_transform_plugin_command() {
// Grok: colon β hyphen, slash kept (same as Cursor)
assert_eq!(
transform_plugin_command("/agtx:plan", "grok"),
Some("/agtx-plan".to_string())
);
assert_eq!(
transform_plugin_command("/gsd:plan-phase 1", "grok"),
Some("/gsd-plan-phase 1".to_string())
);
}
// =============================================================================
// Tests for antigravity (Google Antigravity CLI) integration
// =============================================================================
#[test]
fn test_known_agents_includes_antigravity() {
let agents = known_agents();
let agy = agents.iter().find(|a| a.name == "antigravity");
assert!(agy.is_some(), "antigravity should be in known_agents");
let agy = agy.unwrap();
// Agent name and binary differ, like Cursor (`cursor` / `agent`).
assert_eq!(agy.command, "agy");
assert_eq!(agy.co_author, "Antigravity <[email protected]>");
}
#[test]
fn test_build_interactive_command_antigravity_no_prompt() {
let agents = known_agents();
let agy = agents.iter().find(|a| a.name == "antigravity").unwrap();
// Both permission controls are needed: --mode governs the file-edit diff
// review, --dangerously-skip-permissions governs shell/MCP/URL approvals.
assert_eq!(
agy.build_interactive_command(""),
"agy --dangerously-skip-permissions --mode accept-edits"
);
}
#[test]
fn test_build_interactive_command_antigravity_with_prompt() {
let agents = known_agents();
let agy = agents.iter().find(|a| a.name == "antigravity").unwrap();
assert_eq!(
agy.build_interactive_command("do something"),
"agy --dangerously-skip-permissions --mode accept-edits -i 'do something'"
);
}
#[test]
fn test_build_interactive_command_antigravity_escapes_single_quotes() {
let agents = known_agents();
let agy = agents.iter().find(|a| a.name == "antigravity").unwrap();
let cmd = agy.build_interactive_command("it's a test");
assert!(
cmd.starts_with("agy --dangerously-skip-permissions --mode accept-edits -i "),
"should use the agy flags: {cmd}"
);
assert!(
cmd.contains("'\"'\"'"),
"single quote must be escaped: {cmd}"
);
}
#[test]
fn test_antigravity_has_native_skill_dir() {
// Antigravity uses the vendor-neutral `.agents/` tree, not an agent dotdir.
let dir = agent_native_skill_dir("antigravity");
assert_eq!(dir, Some((".agents/skills", "")));
}
#[test]
fn test_antigravity_transform_plugin_command() {
// Antigravity: colon β hyphen, slash kept (same as Cursor/Grok)
assert_eq!(
transform_plugin_command("/agtx:plan", "antigravity"),
Some("/agtx-plan".to_string())
);
assert_eq!(
transform_plugin_command("/gsd:plan-phase 1", "antigravity"),
Some("/gsd-plan-phase 1".to_string())
);
}