hermes-agent/tests/tui_gateway/test_interim_assistant_callback.py

"""Tests for the interim_assistant_callback config gating in tui_gateway.

These tests exercise the real _agent_cbs() wiring rather than a local
imitation, so a break in the production callback registration is caught.
"""

from __future__ import annotations

from unittest.mock import patch


def test_load_interim_assistant_messages_defaults_true():
    from tui_gateway.server import _load_interim_assistant_messages

    with patch("tui_gateway.server._load_cfg", return_value={}):
        assert _load_interim_assistant_messages() is True


def test_load_interim_assistant_messages_explicit_true():
    from tui_gateway.server import _load_interim_assistant_messages

    with patch("tui_gateway.server._load_cfg", return_value={"display": {"interim_assistant_messages": True}}):
        assert _load_interim_assistant_messages() is True


def test_load_interim_assistant_messages_explicit_false():
    from tui_gateway.server import _load_interim_assistant_messages

    with patch("tui_gateway.server._load_cfg", return_value={"display": {"interim_assistant_messages": False}}):
        assert _load_interim_assistant_messages() is False


def test_load_interim_assistant_messages_string_off():
    from tui_gateway.server import _load_interim_assistant_messages

    with patch("tui_gateway.server._load_cfg", return_value={"display": {"interim_assistant_messages": "off"}}):
        assert _load_interim_assistant_messages() is False


def test_agent_cbs_includes_interim_callback_when_enabled():
    """_agent_cbs() includes interim_assistant_callback when the config is on.

    Exercises the real _agent_cbs() wiring: the callback must be present in
    the returned dict and, when invoked, must emit a message.interim event
    with the text and already_streamed flag passed through.
    """
    from tui_gateway.server import _agent_cbs

    emitted: list[tuple] = []

    def fake_emit(event_type, sid, payload=None):
        emitted.append((event_type, sid, payload))

    with patch("tui_gateway.server._load_cfg", return_value={}), \
         patch("tui_gateway.server._emit", side_effect=fake_emit):
        cbs = _agent_cbs("test-session")

        assert "interim_assistant_callback" in cbs
        cb = cbs["interim_assistant_callback"]
        assert callable(cb)

        # Invoke the real callback inside the patch context — the lambda
        # resolves _emit by name at call time, so it must be called while
        # the patch is active.
        cb("hello world", already_streamed=True)

    assert len(emitted) == 1
    assert emitted[0][0] == "message.interim"
    assert emitted[0][1] == "test-session"
    assert emitted[0][2]["text"] == "hello world"
    assert emitted[0][2]["already_streamed"] is True


def test_agent_cbs_omits_interim_callback_when_disabled():
    """_agent_cbs() omits interim_assistant_callback when the config is off.

    Exercises the real _agent_cbs() wiring: the callback must NOT be present
    in the returned dict when display.interim_assistant_messages is false.
    """
    from tui_gateway.server import _agent_cbs

    with patch("tui_gateway.server._load_cfg", return_value={"display": {"interim_assistant_messages": False}}):
        cbs = _agent_cbs("test-session")

    assert "interim_assistant_callback" not in cbs


def test_agent_cbs_interim_callback_passes_already_streamed_false():
    """The real callback passes already_streamed=False by default."""
    from tui_gateway.server import _agent_cbs

    emitted: list[tuple] = []

    def fake_emit(event_type, sid, payload=None):
        emitted.append((event_type, sid, payload))

    with patch("tui_gateway.server._load_cfg", return_value={}), \
         patch("tui_gateway.server._emit", side_effect=fake_emit):
        cbs = _agent_cbs("test-session")

        cb = cbs["interim_assistant_callback"]
        cb("interim text")

    assert emitted[0][2]["already_streamed"] is False
    assert emitted[0][2]["text"] == "interim text"