Craft Anything: understand how any software works, and craft your own.
Rust
Hermes Agent builds and chats through its own adapter, and over ACP (#16)
vietanh210304233556ed1d64
diff --git a/crates/ai/src/cli_agents/acp.rs b/crates/ai/src/cli_agents/acp.rsindex a65a89b6..27e0461e 100644--- a/crates/ai/src/cli_agents/acp.rs+++ b/crates/ai/src/cli_agents/acp.rs@@ -23,7 +23,7 @@ use std::time::Duration;/// Agents known to speak ACP, and the arguments that start them in that mode.pub const ACP_AGENTS: &[(&str, &[&str])] =- &[("gemini-cli", &["--experimental-acp"]), ("qwen-code", &["--experimental-acp"]), ("opencode", &["acp"]), ("goose", &["acp"])];+ &[("gemini-cli", &["--experimental-acp"]), ("qwen-code", &["--experimental-acp"]), ("opencode", &["acp"]), ("goose", &["acp"]), ("hermes", &["acp"])];/// The ACP version we speak.const PROTOCOL_VERSION: u64 = 1;diff --git a/crates/ai/src/cli_agents/adapters.rs b/crates/ai/src/cli_agents/adapters.rsindex db1d35d6..b2a7763a 100644--- a/crates/ai/src/cli_agents/adapters.rs+++ b/crates/ai/src/cli_agents/adapters.rs@@ -6,8 +6,10 @@use super::*;mod antigravity;+mod hermes;mod opencode;pub use antigravity::Antigravity;+pub use hermes::Hermes;pub use opencode::OpenCode;/// What a run's arguments are built from.@@ -102,9 +104,11 @@ impl Default for AgentAdapters {}impl AgentAdapters {- /// Claude Code, Codex, Gemini CLI, OpenCode and Antigravity.+ /// Claude Code, Codex, Gemini CLI, OpenCode, Antigravity and Hermes.pub fn built_in() -> AgentAdapters {- AgentAdapters { adapters: vec![Arc::new(ClaudeCode), Arc::new(Codex), Arc::new(GeminiCli), Arc::new(OpenCode), Arc::new(Antigravity)] }+ AgentAdapters {+ adapters: vec![Arc::new(ClaudeCode), Arc::new(Codex), Arc::new(GeminiCli), Arc::new(OpenCode), Arc::new(Antigravity), Arc::new(Hermes)],+ }}/// Add an adapter; it takes over any ids it shares with one already registered.diff --git a/crates/ai/src/cli_agents/adapters/hermes.rs b/crates/ai/src/cli_agents/adapters/hermes.rsnew file mode 100644index 00000000..f7518dc4--- /dev/null+++ b/crates/ai/src/cli_agents/adapters/hermes.rs@@ -0,0 +1,57 @@+//! Hermes Agent (`hermes -z`).+//!+//! Hermes declares `-z/--oneshot` with `metavar="PROMPT"`, taking the prompt as its value.+//! Model `-m` and custom args come before `-z <prompt>`.++use super::*;++pub struct Hermes;++impl AgentAdapter for Hermes {+ fn ids(&self) -> &'static [&'static str] {+ &["hermes"]+ }++ fn args(&self, cx: &ArgsCx) -> Vec<String> {+ let mut v = Vec::new();+ if let Some(m) = &cx.options.cli_model {+ v.extend(["-m".into(), m.clone()]);+ }+ v.extend(cx.options.args.iter().cloned());+ v.extend(["-z".into(), format!("{}{}", cx.preamble, cx.prompt)]);+ v+ }++ fn required_flags(&self) -> (&'static [&'static str], &'static [&'static str]) {+ (&["--help"], &["--oneshot"])+ }++ /// Plain `hermes <prompt>` opens the interactive session; a failed flag check keeps this adapter.+ fn plain_fallback(&self) -> bool {+ false+ }++ fn streams_json(&self) -> bool {+ false+ }+}++#[cfg(test)]+mod tests {+ use super::*;++ fn args(builder: bool, options: &BackendOptions) -> Vec<String> {+ let mcp = McpCommand { command: "craft-anything-cli".into(), args: vec!["mcp".into()], notes: None };+ Hermes.args(&ArgsCx { options, prompt: "make a game", preamble: "PRE ", mcp: &mcp, resume: None, builder, reads_checked: false, question: false })+ }++ #[test]+ fn the_prompt_goes_to_oneshot_after_the_flags() {+ assert_eq!(args(false, &BackendOptions::default()), ["-z", "PRE make a game"]);+ let options = BackendOptions { cli_model: Some("custom/qwen-2.5-coder".into()), args: vec!["-t".into(), "0.2".into()], ..Default::default() };+ assert_eq!(args(true, &options), ["-m", "custom/qwen-2.5-coder", "-t", "0.2", "-z", "PRE make a game"]);+ assert!(AgentAdapters::built_in().for_agent("hermes").ids().contains(&"hermes"), "registered, not the plain adapter");+ assert_eq!(Hermes.required_flags(), (&["--help"][..], &["--oneshot"][..]));+ assert!(!Hermes.plain_fallback());+ }+}diff --git a/crates/ai/src/cli_agents/mod.rs b/crates/ai/src/cli_agents/mod.rsindex 8e5cf558..e6ca4437 100644--- a/crates/ai/src/cli_agents/mod.rs+++ b/crates/ai/src/cli_agents/mod.rs@@ -1175,6 +1175,6 @@ mod tests {assert!(reg.for_agent("claude").resumes() && !reg.for_agent("codex").resumes() && reg.for_agent("antigravity").resumes());// Registering an adapter for an existing id replaces that one.reg.register(Arc::new(EchoAgent));- assert_eq!(format!("{reg:?}"), r#"["claude-code", "codex", "gemini-cli", "opencode", "antigravity", "echo-agent"]"#);+ assert_eq!(format!("{reg:?}"), r#"["claude-code", "codex", "gemini-cli", "opencode", "antigravity", "hermes", "echo-agent"]"#);}}