Files
hermes-agent/tests/tools/test_drive_preview_tool.py
Brooklyn Nicholson 0242946697 fix(tools): split the merged preview/terminal bridge timeout errors into the two cases they conflate
An empty bridge answer produced one string that blamed a closed tab
('The action timed out, or no GUI window answered. Open a page with
open_preview first.') even when the pane was open on an app older than
this backend — two cases with different remedies. drive_preview /
annotate_preview now lead with 'no preview tab is open' and name the
older-app possibility; read_preview / read_terminal name both the
nothing-open and bridge-timeout cases and the update-the-app remedy.

Refs #94272
Refs #95104
Refs #119333

Co-authored-by: lesseradmin <veeman961@gmail.com>
2026-09-29 12:25:29 -05:00

122 lines
4.0 KiB
Python

"""Tests for the GUI-surface ``drive_preview`` tool."""
import json
from tools import drive_preview_tool as ap
def test_requires_callback():
"""Outside the desktop GUI there is no bridge — a clear error, no crash."""
result = json.loads(ap.drive_preview_tool(action="elements", callback=None))
assert "desktop" in result["error"]
def test_rejects_an_unknown_action():
result = json.loads(ap.drive_preview_tool(action="teleport", callback=lambda _p: "{}"))
assert "action must be one of" in result["error"]
def test_interaction_verbs_need_a_target():
"""A click with nowhere to land is a mistake worth naming before the bridge."""
for verb in ("click", "type", "press"):
result = json.loads(ap.drive_preview_tool(action=verb, text="x", key="Enter", callback=lambda _p: "{}"))
assert "ref" in result["error"], verb
def test_type_needs_text_and_press_needs_a_key():
calls = []
def cb(payload):
calls.append(payload)
return json.dumps({"success": True})
assert "text" in json.loads(ap.drive_preview_tool(action="type", ref="@e1", callback=cb))["error"]
assert "key" in json.loads(ap.drive_preview_tool(action="press", ref="@e1", callback=cb))["error"]
assert calls == []
def test_typing_an_empty_string_is_allowed():
"""Clearing a field is a real intent — only a missing `text` is an error."""
seen = {}
ap.drive_preview_tool(action="type", ref="@e1", text="", callback=lambda p: seen.update(p) or "{}")
assert seen["text"] == ""
def test_scroll_needs_no_target_and_validates_its_destination():
seen = {}
def cb(payload):
seen.clear()
seen.update(payload)
return json.dumps({"success": True})
ap.drive_preview_tool(action="scroll", callback=cb)
assert seen == {"action": "scroll"}
result = json.loads(ap.drive_preview_tool(action="scroll", to="sideways", callback=cb))
assert "to must be one of" in result["error"]
def test_payload_forwards_only_what_was_given():
seen = {}
ap.drive_preview_tool(
action="type",
ref="inp-password",
text="hunter2",
submit=True,
callback=lambda p: seen.update(p) or json.dumps({"success": True}),
)
assert seen == {"action": "type", "ref": "inp-password", "text": "hunter2", "submit": True}
def test_numeric_arguments_are_validated():
result = json.loads(ap.drive_preview_tool(action="scroll", amount="lots", callback=lambda _p: "{}"))
assert "integers" in result["error"]
def test_empty_answer_means_nothing_open():
result = json.loads(ap.drive_preview_tool(action="elements", callback=lambda _p: ""))
assert "open_preview" in result["error"]
def test_passes_the_renderer_answer_through():
payload = {
"success": True,
"acted": 'clicked button "Sign in"',
"url": "https://example.com/app",
"elements": [{"ref": "@e1", "role": "button", "label": "Log out", "selector": "#out"}],
}
result = json.loads(ap.drive_preview_tool(action="click", ref="@e2", callback=lambda _p: json.dumps(payload)))
assert result == payload
def test_wraps_non_json_text():
result = json.loads(ap.drive_preview_tool(action="elements", callback=lambda _p: "plain words"))
assert result == {"text": "plain words"}
def test_callback_failure_is_reported():
def _boom(_payload):
raise RuntimeError("renderer went away")
result = json.loads(ap.drive_preview_tool(action="elements", callback=_boom))
assert "renderer went away" in result["error"]
def test_empty_answer_distinguishes_no_tab_from_a_stale_app():
"""An empty bridge answer used to be one merged "timed out, or no window
answered" string that blamed a closed tab even when the pane was open on an
app older than this backend (#94272): the two cases need different next
steps (open a tab vs update the app)."""
result = json.loads(ap.drive_preview_tool(action="elements", callback=lambda _p: ""))
assert "no preview tab is open" in result["error"]
assert "older than this backend" in result["error"]