Files
hermes-agent/tests/tools/test_focus_pane_tool.py
Brooklyn Nicholson 7ad9ace2cc fix(agent): the desktop's tools reach it on remote and cloud backends too
The pane, in-app browser, and reaction tools were gated on HERMES_DESKTOP=1 —
an env var set only on backends Electron spawns itself (local and SSH). A
desktop client connected to a plain URL gateway or Hermes Cloud lost all six:
they were stripped from the schema before the model saw them, on the same
backend whose platform hint was telling it "you are chatting inside the Hermes
desktop app". open_preview, read_preview, read_terminal, close_terminal,
focus_pane, and react_to_message were all silently absent.

The client is not the host. Capability now resolves from the session's own
source, which session.create already carries:

- The six tools move into a `desktop_ui` toolset, off _HERMES_CORE_TOOLS so no
  other platform pays their schema.
- _gui_surface_toolsets(platform) folds `desktop_ui` (and the existing
  `project` tools) into the GUI gateway's resolution when the session's
  platform is the desktop app — the same answer on every topology.
- check_fn drops the env probe. It kept the one thing that is genuinely a
  per-process/user fact: react_to_message's display.message_reactions opt-in,
  which the desktop mirrors onto whichever gateway it is connected to.

react_to_message was doubly broken: it read that toggle behind the env gate, so
even a local-backend user's Settings toggle could not reach a remote session.

The embedded terminal pane keeps working correctly the other way round: it runs
`hermes --tui` against a desktop-spawned backend, and a tui-sourced session
gets no GUI tools even though HERMES_DESKTOP=1 is set on that process.
2026-08-06 19:35:47 -06:00

39 lines
1.1 KiB
Python

"""Tests for the GUI-surface ``focus_pane`` tool."""
import json
import pytest
from tools import desktop_ui, focus_pane_tool as fp
from tools.registry import registry
@pytest.fixture(autouse=True)
def _reset_emitter():
desktop_ui.set_emitter(None)
yield
desktop_ui.set_emitter(None)
def test_lives_in_the_gui_surface_toolset(monkeypatch):
"""Surface eligibility is the toolset's job, not a process env var — the
desktop client can be driving a remote/cloud backend that never sees
HERMES_DESKTOP."""
monkeypatch.delenv("HERMES_DESKTOP", raising=False)
entry = registry.get_entry("focus_pane")
assert entry is not None
assert entry.toolset == "desktop_ui"
assert entry.check_fn is None
@pytest.mark.parametrize("pane", fp.PANES)
def test_emits_pane_reveal(pane):
calls = []
desktop_ui.set_emitter(lambda sid, event, payload: calls.append((event, payload)))
out = json.loads(fp.focus_pane_tool(f" {pane.upper()} "))
assert out == {"success": True, "pane": pane}
assert calls == [("pane.reveal", {"pane": pane})]