fix(hermes): expose Agency tool parameters (#717)

Co-authored-by: Michael Sitarzewski <michael@sitarzewski.com>
This commit is contained in:
Pip, Agent Pip
2026-07-15 09:55:50 -05:00
committed by GitHub
parent 00fb28a4cf
commit 6e45066041
4 changed files with 170 additions and 31 deletions
+21 -2
View File
@@ -3,11 +3,11 @@
Generated by `scripts/convert.sh --tool hermes`.
This integration installs one Hermes plugin named `agency-agents-router` instead
of adding 232+ generated skills to `skills.external_dirs`. Hermes sees a
of adding hundreds of generated skills to `skills.external_dirs`. Hermes sees a
small fixed tool surface at startup, while the complete Agency roster is
stored on disk in `data/agents.json` and searched/loaded lazily.
Generated agent count: 232
Generated agent count: 254
## Tools exposed to Hermes
@@ -16,6 +16,20 @@ Generated agent count: 232
- `agency_agents_load` — compose one specialist prompt for the current task.
- `agency_agents_delegate` — delegate through Hermes `delegate_task` when available.
Each tool is registered with Hermes' complete function-tool schema, including
its name, description, and JSON `parameters`. The available arguments are:
| Tool | Arguments |
| --- | --- |
| `agency_agents_search` | `query` (required), optional `division` and `limit` |
| `agency_agents_inspect` | `agent` or `slug`, optional `include_body` |
| `agency_agents_load` | `agent` or `slug`, optional `task` |
| `agency_agents_delegate` | `agent` or `slug`, `task` (required), optional `toolsets` |
A normal flow is: search by capability, take a returned `slug`, then inspect,
load, or delegate to that specialist. You can ask Hermes to do this in natural
language; direct tool calls are not required.
## Specialist usage instruction for Hermes
When a Hermes project needs Agency specialists, explicitly ask Hermes to use
@@ -58,3 +72,8 @@ ${HERMES_HOME:-~/.hermes}/plugins/agency-agents-router
It then enables `agency-agents-router` under `plugins.enabled` in the Hermes
config. It does **not** write to `skills.external_dirs`.
Restart Hermes or start a new session after installing so the plugin and its
tool schemas are loaded. If Hermes displays these tools without their documented
arguments, regenerate and reinstall the plugin from the latest Agency Agents
checkout, then restart Hermes.