docs(agents): reconcile Footprint Ladder rung 3 with the session-surface rule

Ladder rung 3 says a service-gated tool 'only appears when a prerequisite
is configured', while the SESSION-surface section below says check_fn must
not gate per-session surface. Both are correct but read as a contradiction
at the ladder; add the disambiguation inline with a pointer to the section.
This commit is contained in:
jupiterx0910
2026-09-12 17:13:30 +08:00
committed by Teknium
parent f2ee74d739
commit 683e8d382b
+4 -1
View File
@@ -138,7 +138,10 @@ Choose the highest (least-footprint) rung that correctly solves the problem:
`hermes <subcommand>` guided by a skill. Default for subscriptions, scheduled tasks,
service setup (`hermes webhook`, `hermes cron`, `hermes tools`).
3. **Service-gated tool (`check_fn`)** — needs structured params/returns AND only appears when
a prerequisite is configured (Home Assistant tools, memory-provider tools).
a prerequisite is configured (Home Assistant tools, memory-provider tools). This rung gates
reachability/opt-in process-wide; a capability that varies per SESSION (who is watching) is
a named toolset folded in by the toolset resolver, not a `check_fn` — see "Surface capability
is a property of the SESSION" below.
4. **Plugin** — third-party/niche/user-specific; lives in `~/.hermes/plugins/` or a pip
package, discovered at runtime.
5. **MCP server (in the catalog)** — genuinely a tool but not core-fundamental. Zero permanent