mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-05-30 06:41:51 +00:00
b5c1fe78aa
Skill bundles are tiny YAML files in ~/.hermes/skill-bundles/ that
group several skills under one slash command. Invoking /<bundle-name>
from any surface (CLI, TUI, dashboard, any gateway platform) loads
every referenced skill into a single combined user message.
Use cases:
- /backend-dev → loads github-code-review + test-driven-development
+ github-pr-workflow as one bundle.
- /research → loads several research skills together.
- Team task profiles shared via dotfiles.
Behavior:
- Bundles take precedence over individual skills when slugs collide.
- Missing skills are skipped with a note, not fatal.
- No system-prompt mutation — bundles generate a fresh user message
at invocation time, the same way /<skill> does. Prompt cache stays
intact.
- Works in CLI dispatch, gateway dispatch, autocomplete (CLI + TUI),
/help display.
Schema (~/.hermes/skill-bundles/<slug>.yaml):
name: backend-dev
description: Backend feature work.
skills:
- github-code-review
- test-driven-development
instruction: |
Optional extra guidance prepended to the loaded skills.
New module: agent/skill_bundles.py — load, scan, resolve, build
invocation message, save, delete. yaml.safe_load only; broken
bundles log a warning and are skipped, never raise.
New CLI subcommand: hermes bundles {list,show,create,delete,reload}.
Implementation in hermes_cli/bundles.py; wired in hermes_cli/main.py.
'bundles' added to _BUILTIN_SUBCOMMANDS so plugin discovery skips it.
New in-session slash command: /bundles lists installed bundles in
both CLI and gateway. /<bundle-name> dispatch added to CLI (cli.py)
and gateway (gateway/run.py) before the existing /<skill-name> path.
Autocomplete: SlashCommandCompleter gained an optional
skill_bundles_provider parameter that defaults to None — the prompt
shows '▣ <description> (N skills)' for bundles vs '⚡' for skills.
Tests:
- tests/agent/test_skill_bundles.py — 33 tests covering slugify,
scan/cache freshness, resolve (including underscore→hyphen
Telegram alias), build_bundle_invocation_message (loading, missing
skills, user/bundle instruction injection, dedup), save/delete,
reload diff, list sort.
- tests/hermes_cli/test_bundles.py — 8 tests for the CLI
subcommand (create/list/show/delete/reload, --force, missing
bundle errors).
- tests/gateway/test_bundles_command.py — 4 tests for the gateway
handler and bundle resolution priority.
Live E2E: verified subprocess invocations of hermes bundles
{list,create,show,reload,delete} round-trip correctly against an
isolated HERMES_HOME.
Docs:
- website/docs/user-guide/features/skills.md — new 'Skill Bundles'
section with quick example, YAML schema, management commands,
behavior notes.
- website/docs/reference/cli-commands.md — 'hermes bundles' added to
the top-level command table and given its own subcommand section.
94 lines
3.3 KiB
Python
94 lines
3.3 KiB
Python
"""Tests for hermes_cli/bundles.py — the `hermes bundles` CLI subcommand."""
|
|
|
|
import argparse
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
import pytest
|
|
|
|
from hermes_cli.bundles import (
|
|
bundles_command,
|
|
register_cli,
|
|
)
|
|
|
|
|
|
@pytest.fixture
|
|
def bundles_env(tmp_path, monkeypatch):
|
|
bundles_dir = tmp_path / "skill-bundles"
|
|
monkeypatch.setenv("HERMES_BUNDLES_DIR", str(bundles_dir))
|
|
# Reset module-level cache between tests.
|
|
import agent.skill_bundles as mod
|
|
mod._bundles_cache = {}
|
|
mod._bundles_cache_mtime = None
|
|
return bundles_dir
|
|
|
|
|
|
def _parse(argv):
|
|
parser = argparse.ArgumentParser()
|
|
register_cli(parser)
|
|
return parser.parse_args(argv)
|
|
|
|
|
|
class TestBundlesCli:
|
|
def test_create_and_list(self, bundles_env, capsys):
|
|
args = _parse(["create", "my-bundle", "--skill", "a", "--skill", "b", "-d", "desc"])
|
|
bundles_command(args)
|
|
out = capsys.readouterr().out
|
|
assert "Created bundle" in out
|
|
# File should exist
|
|
assert (bundles_env / "my-bundle.yaml").exists()
|
|
|
|
args = _parse(["list"])
|
|
bundles_command(args)
|
|
out = capsys.readouterr().out
|
|
assert "my-bundle" in out
|
|
|
|
def test_show(self, bundles_env, capsys):
|
|
bundles_command(_parse(["create", "x", "--skill", "s1", "--skill", "s2"]))
|
|
capsys.readouterr() # clear
|
|
bundles_command(_parse(["show", "x"]))
|
|
out = capsys.readouterr().out
|
|
assert "/x" in out
|
|
assert "s1" in out
|
|
assert "s2" in out
|
|
|
|
def test_delete(self, bundles_env, capsys):
|
|
bundles_command(_parse(["create", "doomed", "--skill", "s1"]))
|
|
capsys.readouterr()
|
|
bundles_command(_parse(["delete", "doomed"]))
|
|
out = capsys.readouterr().out
|
|
assert "Deleted bundle" in out
|
|
assert not (bundles_env / "doomed.yaml").exists()
|
|
|
|
def test_create_refuses_overwrite(self, bundles_env, capsys):
|
|
bundles_command(_parse(["create", "dup", "--skill", "s1"]))
|
|
capsys.readouterr()
|
|
with pytest.raises(SystemExit) as ei:
|
|
bundles_command(_parse(["create", "dup", "--skill", "s2"]))
|
|
assert ei.value.code == 1
|
|
out = capsys.readouterr().out
|
|
assert "already exists" in out.lower() or "--force" in out.lower()
|
|
|
|
def test_create_force_overwrites(self, bundles_env, capsys):
|
|
bundles_command(_parse(["create", "dup", "--skill", "s1"]))
|
|
capsys.readouterr()
|
|
bundles_command(_parse(["create", "dup", "--skill", "s2", "--force"]))
|
|
out = capsys.readouterr().out
|
|
assert "Created bundle" in out
|
|
|
|
def test_create_requires_skills(self, bundles_env, capsys, monkeypatch):
|
|
# Simulate user pressing Ctrl-D immediately at the interactive prompt.
|
|
monkeypatch.setattr("builtins.input", lambda *_a, **_kw: (_ for _ in ()).throw(EOFError()))
|
|
with pytest.raises(SystemExit):
|
|
bundles_command(_parse(["create", "empty"]))
|
|
|
|
def test_show_missing(self, bundles_env, capsys):
|
|
with pytest.raises(SystemExit) as ei:
|
|
bundles_command(_parse(["show", "ghost"]))
|
|
assert ei.value.code == 1
|
|
|
|
def test_reload(self, bundles_env, capsys):
|
|
# Reload on an empty dir reports no changes.
|
|
bundles_command(_parse(["reload"]))
|
|
out = capsys.readouterr().out
|
|
assert "No changes" in out or "0" in out
|