feat(voice): route wake phrases to their profile — "hey <profile>" wakes that profile

One sherpa listener now enrolls every wake-enabled profile's phrase
(defaulting to "hey <profile name>") and reports WHICH phrase fired.
wake.detected gains a profile field; the desktop live-switches to the
matching profile (same path as the profile rail), opens a fresh session
there, and starts hands-free voice. The single-profile CLI/TUI print the
hermes -p switch command for foreign-profile phrases instead of
answering as the wrong profile. Opt out per listener with
wake_word.profile_routing: false.
This commit is contained in:
Hermes Agent 2026-07-24 09:52:00 -07:00 committed by Teknium
parent 567f47f01f
commit 2a35c8f0b8
No known key found for this signature in database
10 changed files with 274 additions and 16 deletions

View file

@ -1426,7 +1426,7 @@ def test_wake_owner_is_sticky_and_routes_detection_to_first_transport(monkeypatc
assert emitted == [(
"wake.detected",
"first-session",
{"phrase": "hey hermes", "start_new_session": True},
{"phrase": "hey hermes", "profile": None, "start_new_session": True},
first,
)]
assert state["paused"] is True
@ -1459,7 +1459,7 @@ def test_wake_owner_is_sticky_and_routes_detection_to_first_transport(monkeypatc
assert emitted[-1] == (
"wake.detected",
"second-session",
{"phrase": "hey hermes", "start_new_session": True},
{"phrase": "hey hermes", "profile": None, "start_new_session": True},
second,
)

View file

@ -302,6 +302,106 @@ def test_sherpa_requirements_probe_uses_sherpa_feature(monkeypatch):
assert r["phrase"] == "anything at all"
# ── Multi-profile phrase routing ─────────────────────────────────────────
def test_sherpa_engine_enrolls_all_profile_phrases(monkeypatch, tmp_path):
calls, model_dir = _install_fake_sherpa(monkeypatch, tmp_path)
monkeypatch.setattr(ww, "_active_profile_name", lambda: "default")
monkeypatch.setattr(
ww, "enrolled_profile_phrases",
lambda: {"coder": "hey coder", "trader": "hey trader"},
)
eng = ww._SherpaKwsEngine({
"provider": "sherpa", "phrase": "hey hermes",
"sherpa": {"model_dir": str(model_dir)},
})
with open(eng._keywords_file, encoding="utf-8") as f:
lines = f.read().strip().splitlines()
assert len(lines) == 3
assert eng._display_to_profile == {
"HEY_HERMES": "default",
"HEY_CODER": "coder",
"HEY_TRADER": "trader",
}
eng.close()
def test_sherpa_engine_profile_routing_can_be_disabled(monkeypatch, tmp_path):
calls, model_dir = _install_fake_sherpa(monkeypatch, tmp_path)
monkeypatch.setattr(ww, "_active_profile_name", lambda: "default")
monkeypatch.setattr(
ww, "enrolled_profile_phrases", lambda: {"coder": "hey coder"}
)
eng = ww._SherpaKwsEngine({
"provider": "sherpa", "phrase": "hey hermes", "profile_routing": False,
"sherpa": {"model_dir": str(model_dir)},
})
assert eng._display_to_profile == {"HEY_HERMES": "default"}
eng.close()
def test_sherpa_engine_match_maps_back_to_profile(monkeypatch, tmp_path):
calls, model_dir = _install_fake_sherpa(monkeypatch, tmp_path)
monkeypatch.setattr(ww, "_active_profile_name", lambda: "default")
monkeypatch.setattr(
ww, "enrolled_profile_phrases", lambda: {"coder": "hey coder"}
)
eng = ww._SherpaKwsEngine({
"provider": "sherpa", "phrase": "hey hermes",
"sherpa": {"model_dir": str(model_dir)},
})
frame = [0] * eng.frame_length
calls["results"].append("HEY_CODER")
assert eng.process(frame) is True
assert eng.last_match == ("hey coder", "coder")
calls["results"].append("HEY_HERMES")
assert eng.process(frame) is True
assert eng.last_match == ("hey hermes", "default")
def test_enrolled_profile_phrases_reads_profile_configs(monkeypatch, tmp_path):
profiles_root = tmp_path / "profiles"
for name, body in (
("coder", "wake_word:\n enabled: true\n phrase: hey coder\n"),
("trader", "wake_word:\n enabled: true\n"), # phrase defaults
("quiet", "wake_word:\n enabled: false\n"), # not enrolled
("empty", ""), # no wake_word at all
):
d = profiles_root / name
d.mkdir(parents=True)
(d / "config.yaml").write_text(body, encoding="utf-8")
class _Info:
def __init__(self, name):
self.name = name
import types as _types
fake_profiles = _types.ModuleType("hermes_cli.profiles")
fake_profiles.list_profiles = lambda: [
_Info(p.name) for p in sorted(profiles_root.iterdir())
]
fake_profiles.get_profile_dir = lambda name: str(profiles_root / name)
fake_profiles.get_active_profile_name = lambda: "default"
monkeypatch.setitem(sys.modules, "hermes_cli.profiles", fake_profiles)
phrases = ww.enrolled_profile_phrases()
assert phrases == {"coder": "hey coder", "trader": "hey trader"}
def test_get_last_match_reads_detector_engine(monkeypatch):
class _Eng:
last_match = ("hey coder", "coder")
class _Det:
engine = _Eng()
monkeypatch.setattr(ww, "_detector", _Det())
assert ww.get_last_match() == ("hey coder", "coder")
monkeypatch.setattr(ww, "_detector", None)
assert ww.get_last_match() is None
# ── Detector loop ────────────────────────────────────────────────────────