use std::path::PathBuf;
use anyhow::Context;
use super::common;
use super::{exec_with_env, find_on_path, server};
pub(super) fn launch_hermes(
model: &str,
vision: bool,
extra_args: &[String],
) -> anyhow::Result<()> {
let bin = find_on_path("hermes").ok_or_else(|| anyhow::anyhow!("hermes is not installed"))?;
write_hermes_config(if model.is_empty() { "default" } else { model }, vision)?;
exec_with_env(&bin, extra_args, &[])
}
pub(super) fn hermes_home() -> anyhow::Result<PathBuf> {
if let Ok(dir) = std::env::var("HERMES_HOME") {
if !dir.trim().is_empty() {
return Ok(PathBuf::from(dir));
}
}
if cfg!(windows) {
if let Ok(local_app_data) = std::env::var("LOCALAPPDATA") {
if !local_app_data.trim().is_empty() {
return Ok(PathBuf::from(local_app_data).join("hermes"));
}
}
let home = dirs::home_dir().context("no home directory")?;
return Ok(home.join("AppData").join("Local").join("hermes"));
}
let home = dirs::home_dir().context("no home directory")?;
Ok(home.join(".hermes"))
}
fn write_hermes_config(model: &str, vision: bool) -> anyhow::Result<()> {
let config_dir = hermes_home()?;
std::fs::create_dir_all(&config_dir)?;
let config_path = config_dir.join("config.yaml");
let existing = std::fs::read_to_string(&config_path).unwrap_or_default();
let preserved =
strip_yaml_top_level_key(&strip_yaml_top_level_key(&existing, "model"), "providers");
let ours = hermes_config_blocks(model, &format!("{}/v1", server()), vision);
std::fs::write(&config_path, format!("{preserved}{ours}"))?;
Ok(())
}
fn hermes_config_blocks(model: &str, base_url: &str, vision: bool) -> String {
let model = common::yaml_quote(model);
let base_url = common::yaml_quote(base_url);
let vision = if vision {
" supports_vision: true\n"
} else {
""
};
format!(
"model:\n provider: llmman\n default: {model}\n base_url: {base_url}\n api_key: llmman\n{vision}\
providers:\n llmman:\n name: llmman\n api: {base_url}\n default_model: {model}\n models:\n - {model}\n"
)
}
fn strip_yaml_top_level_key(existing: &str, key: &str) -> String {
let header = format!("{key}:");
let mut out = String::new();
let mut skipping = false;
for line in existing.lines() {
let trimmed = line.trim_start();
if trimmed.is_empty() || trimmed.starts_with('#') {
if !skipping {
out.push_str(line);
out.push('\n');
}
continue;
}
if !line.starts_with([' ', '\t']) {
skipping = line.trim_end() == header;
if skipping {
continue;
}
} else if skipping {
continue;
}
out.push_str(line);
out.push('\n');
}
out
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn strip_yaml_top_level_key_removes_only_that_key_and_its_block() {
let existing = "\
toolsets:\n - web\nmodel:\n provider: llmman\n default: old-model\nproviders:\n llmman:\n name: llmman\nchannels:\n telegram: {}\n";
let cleaned =
strip_yaml_top_level_key(&strip_yaml_top_level_key(existing, "model"), "providers");
assert!(!cleaned.contains("model:"));
assert!(!cleaned.contains("provider: llmman"));
assert!(!cleaned.contains("providers:"));
assert!(cleaned.contains("toolsets:"));
assert!(cleaned.contains(" - web"));
assert!(cleaned.contains("channels:"));
assert!(cleaned.contains(" telegram: {}"));
}
#[test]
fn hermes_config_declares_image_input_only_for_a_vision_model() {
let vision = hermes_config_blocks("m", "http://h/v1", true);
let model_block = strip_yaml_top_level_key(&vision, "providers");
assert!(
model_block.contains("\n supports_vision: true\n"),
"{vision}"
);
let text_only = hermes_config_blocks("m", "http://h/v1", false);
assert!(!text_only.contains("supports_vision"), "{text_only}");
assert_eq!(text_only, vision.replace(" supports_vision: true\n", ""));
}
#[test]
fn strip_yaml_top_level_key_is_a_no_op_without_that_key() {
let existing = "toolsets:\n - web\n";
assert_eq!(strip_yaml_top_level_key(existing, "model"), existing);
}
#[test]
fn strip_yaml_top_level_key_handles_blank_lines_inside_the_removed_block() {
let existing = "toolsets:\n - web\n\nmodel:\n provider: llmman\n\n default: old-model\n\nchannels:\n telegram: {}\n";
let cleaned = strip_yaml_top_level_key(existing, "model");
assert!(!cleaned.contains("model:"));
assert!(!cleaned.contains("provider: llmman"));
assert!(!cleaned.contains("default: old-model"));
assert!(cleaned.contains("toolsets:"));
assert!(cleaned.contains("channels:"));
assert!(cleaned.contains(" telegram: {}"));
}
#[test]
fn strip_yaml_top_level_key_handles_a_comment_inside_the_removed_block() {
let existing = "toolsets:\n - web\n# a comment\nmodel:\n provider: llmman\n# another comment\n default: old-model\nchannels:\n telegram: {}\n";
let cleaned = strip_yaml_top_level_key(existing, "model");
assert!(!cleaned.contains("model:"));
assert!(!cleaned.contains("provider: llmman"));
assert!(!cleaned.contains("default: old-model"));
assert!(!cleaned.contains("another comment"));
assert!(cleaned.contains("toolsets:"));
assert!(cleaned.contains("# a comment"));
assert!(cleaned.contains("channels:"));
assert!(cleaned.contains(" telegram: {}"));
}
}