Skip to content

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.rs
index 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.rs
index 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.rs
new file mode 100644
index 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.rs
index 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"]"#);
}
}