mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-11-20 18:50:12 +03:00
0173fb57b4
The attached-client page listed a hand-picked "Method catalog (selected)" that included methods the shared gateway's /api/ws socket refuses (session.title, session.usage, session.activate, session.compress, session.branch, session.close, session.status). Nothing told a client author that `x-canonical-methods` (53 names) is the set of methods with a hermes-gateway-v1 wire model of their own, not the set the gateway serves (it serves 114), or that some methods only reach an older handler. `scripts/gen_serve_handler_ledger.py` already derives, per method, how /api/ws answers it. It now also writes that split into the page between markers, and its `--check` and test fail when the page is stale. The page explains the authority-first dispatch, the older-handler rule, and what `x-canonical-methods` means, and the live-session paragraph names the methods to use on the shared gateway.
49 lines
2.8 KiB
Python
49 lines
2.8 KiB
Python
"""The serve handler ledger has one row per live serve handler and is regenerated with the code."""
|
|
import importlib.util
|
|
import json
|
|
from pathlib import Path
|
|
|
|
ROOT = Path(__file__).resolve().parents[2]
|
|
|
|
|
|
def _generator():
|
|
spec = importlib.util.spec_from_file_location("gen_serve_handler_ledger",
|
|
ROOT / "scripts" / "gen_serve_handler_ledger.py")
|
|
assert spec is not None and spec.loader is not None
|
|
module = importlib.util.module_from_spec(spec)
|
|
spec.loader.exec_module(module)
|
|
return module
|
|
|
|
|
|
def test_committed_ledger_lists_every_live_handler():
|
|
"""A route or RPC method added or removed without regenerating the ledger is named here."""
|
|
gen = _generator()
|
|
facts = gen._facts()
|
|
live = {row["handler"] for row in gen.rows(facts)}
|
|
committed = gen.OUT.read_text(encoding="utf-8-sig")
|
|
listed = [row["handler"] for row in json.loads(committed)["handlers"]]
|
|
assert len(listed) == len(set(listed))
|
|
assert sorted(live - set(listed)) == [], "handlers with no ledger row: run scripts/gen_serve_handler_ledger.py"
|
|
assert sorted(set(listed) - live) == [], "ledger rows for removed handlers: run scripts/gen_serve_handler_ledger.py"
|
|
assert sorted(set(gen.DECISIONS) - live) == [], "DECISIONS names a handler that no longer exists"
|
|
assert {decision for decision, _ in gen.DECISIONS.values()} <= set(gen.DECISION_VALUES)
|
|
assert committed == gen.render(facts), "tests/hermes_cli/serve_handler_ledger.json is stale: run scripts/gen_serve_handler_ledger.py"
|
|
assert gen.DOC.read_text(encoding="utf-8-sig") == gen._doc_text(gen.render_doc(facts)), \
|
|
"the method list in programmatic-integration.md is stale: run scripts/gen_serve_handler_ledger.py"
|
|
|
|
|
|
def test_rpc_rows_follow_the_ws_dispatch_tables():
|
|
"""Served verbs are authority-owned; a legacy-only verb is a fallback or refused, never decided;
|
|
a verb served only for session-owned calls keeps its account-owned fallback undecided."""
|
|
gen = _generator()
|
|
facts = {"routes": [], "legacy": ["pet.get", "session.title", "session.list", "connectors.connect"],
|
|
"served": ["session.list", "connectors.connect"], "refused": ["session.title"],
|
|
"account_owned_fallback": ["connectors.connect"]}
|
|
by_name = {row["handler"]: row for row in gen.rows(facts)}
|
|
assert by_name["session.list"]["decision"] == "authority"
|
|
assert by_name["pet.get"]["current_path"].startswith("legacy fallback")
|
|
assert by_name["session.title"]["current_path"].startswith("authority refuses (-32601)")
|
|
assert "account-owned: legacy fallback" in by_name["connectors.connect"]["current_path"]
|
|
assert {by_name[m]["decision"] for m in ("pet.get", "session.title", "connectors.connect")} == {"undecided"}
|
|
assert {row["decision"] for row in by_name.values()} <= set(gen.DECISION_VALUES)
|