"""Tests for the GUI-surface ``tour`` tool."""

import json

from tools import tour_tool as tt
from tools.registry import registry


def _run(**kwargs):
    kwargs.setdefault("callback", lambda _payload: json.dumps({"success": True}))
    return json.loads(tt.tour_tool(**kwargs))


def test_lives_in_the_gui_surface_toolset(monkeypatch):
    """Scoped by toolset, not by the backend's env — see AGENTS.md."""
    monkeypatch.delenv("HERMES_DESKTOP", raising=False)
    entry = registry.get_entry("tour")

    assert entry is not None
    assert entry.toolset == "desktop_ui"
    assert entry.check_fn is None


def test_requires_callback():
    """Outside the desktop GUI there is no bridge — a clear error, no crash."""
    assert "desktop" in json.loads(tt.tour_tool(action="targets", callback=None))["error"]


def test_rejects_unknown_action_and_surface():
    assert "action must be one of" in _run(action="dance")["error"]
    assert "surface must be one of" in _run(action="targets", surface="hologram")["error"]
    assert "side must be one of" in _run(action="show", selector="#a", side="diagonal")["error"]


def test_show_needs_something_to_point_at_or_say():
    assert "show needs" in _run(action="show")["error"]
    assert "error" not in _run(action="show", text="just narration")


def test_start_validates_its_steps():
    assert "non-empty steps" in _run(action="start")["error"]
    assert "non-empty steps" in _run(action="start", steps=[])["error"]
    assert "steps[1] must be an object" in _run(action="start", steps=[{"selector": "#a"}, "nope"])["error"]
    assert "steps[1] needs" in _run(action="start", steps=[{"selector": "#a"}, {}])["error"]


def test_payload_omits_unset_fields_and_defaults_the_surface():
    seen = {}

    def cb(payload):
        seen.update(payload)
        return json.dumps({"success": True})

    tt.tour_tool(action="show", selector="#composer", title="Composer", callback=cb)
    assert seen == {
        "action": "show",
        "surface": "app",
        "selector": "#composer",
        "title": "Composer",
    }


def test_unanswered_bridge_is_reported_rather_than_faked_as_success():
    assert "error" in _run(action="targets", callback=lambda _p: "")


def test_passes_renderer_json_through():
    payload = {"success": True, "matched": True, "step": 2}
    assert _run(action="next", callback=lambda _p: json.dumps(payload)) == payload


def test_wraps_non_json_text():
    assert _run(action="stop", callback=lambda _p: "stopped") == {"text": "stopped"}


def test_callback_failure_is_reported():
    def _boom(_payload):
        raise RuntimeError("renderer went away")

    assert "renderer went away" in _run(action="stop", callback=_boom)["error"]