Skip to content

Your lightweight open-source personal agent.

13.2 KB
Raw Blame
import asyncio
from contextlib import nullcontext
from io import StringIO
from unittest.mock import AsyncMock, MagicMock, call, patch

import pytest
from prompt_toolkit.formatted_text import HTML

from nanobot.cli import stream as stream_mod
from nanobot.cli import terminal


@pytest.fixture(autouse=True)
def isolate_prompt_session(tmp_path, monkeypatch):
    """Keep real parser tests out of user history and other prompt sessions."""
    monkeypatch.setattr("nanobot.config.paths.get_cli_history_path", lambda: tmp_path / "history")
    monkeypatch.setattr(terminal, "_prompt_session", None)
    monkeypatch.setattr(terminal, "_saved_term_attrs", None)


@pytest.fixture
def mock_prompt_session():
    """Mock the global prompt session."""
    mock_session = MagicMock()
    mock_session.prompt_async = AsyncMock()
    with patch("nanobot.cli.terminal._prompt_session", mock_session), \
         patch("nanobot.cli.terminal.patch_stdout"):
        yield mock_session


@pytest.mark.asyncio
async def test_read_interactive_input_async_returns_input(mock_prompt_session):
    mock_prompt_session.prompt_async.return_value = "hello world"

    result = await terminal._read_interactive_input_async()

    assert result == "hello world"
    mock_prompt_session.prompt_async.assert_called_once()
    args, _ = mock_prompt_session.prompt_async.call_args
    assert isinstance(args[0], HTML)


@pytest.mark.asyncio
async def test_read_interactive_input_async_handles_eof(mock_prompt_session):
    mock_prompt_session.prompt_async.side_effect = EOFError()

    with pytest.raises(KeyboardInterrupt):
        await terminal._read_interactive_input_async()


def test_init_prompt_session_creates_session():
    terminal._prompt_session = None

    with patch("nanobot.cli.terminal.PromptSession") as mock_session_cls, \
         patch("nanobot.cli.terminal.FileHistory"), \
         patch("pathlib.Path.home") as mock_home:

        mock_home.return_value = MagicMock()

        terminal._init_prompt_session()

        assert terminal._prompt_session is not None
        mock_session_cls.assert_called_once()
        _, kwargs = mock_session_cls.call_args
        assert kwargs["multiline"] is True
        assert kwargs["enable_open_in_editor"] is False
        assert kwargs.get("key_bindings") is not None


def test_cli_key_bindings_enter_submits_and_alt_enter_newlines():
    from prompt_toolkit.keys import Keys

    kb = terminal._build_cli_key_bindings()

    def _keys(binding):
        return tuple(getattr(k, "value", k) for k in binding.keys)

    bound = {_keys(b): b for b in kb.bindings}

    enter = bound[(Keys.Enter.value,)]
    buf = MagicMock()
    enter.call(MagicMock(current_buffer=buf))
    buf.validate_and_handle.assert_called_once()
    buf.insert_text.assert_not_called()

    alt_enter = bound[(Keys.Escape.value, Keys.Enter.value)]
    buf = MagicMock()
    alt_enter.call(MagicMock(current_buffer=buf))
    buf.insert_text.assert_called_once_with("\n")


@pytest.mark.asyncio
async def test_raw_lf_enter_still_submits_like_wsl_terminals():
    """A raw LF byte (\\x0a) is what some terminals -- e.g. WSL -- send for a
    plain Enter keypress. It must submit the buffer, not insert a newline;
    a mock buffer can't catch a key binding shadowing prompt_toolkit's own
    default \\n-as-\\r handling, so this drives a real PromptSession/parser.
    """
    from prompt_toolkit.application import create_app_session
    from prompt_toolkit.input import create_pipe_input
    from prompt_toolkit.output import DummyOutput

    with create_pipe_input() as pipe_input:
        with create_app_session(input=pipe_input, output=DummyOutput()):
            terminal._init_prompt_session()
            session = terminal._prompt_session
            pipe_input.send_text("hello\x0aworld\r")
            # CI has no user to acknowledge prompt_toolkit's exception prompt.
            result = await asyncio.wait_for(
                session.prompt_async("> ", set_exception_handler=False), timeout=10,
            )

    assert result == "hello"


@pytest.mark.asyncio
async def test_alt_enter_inserts_newline_on_lf_terminals():
    from prompt_toolkit.application import create_app_session
    from prompt_toolkit.input import create_pipe_input
    from prompt_toolkit.output import DummyOutput

    with create_pipe_input() as pipe_input:
        with create_app_session(input=pipe_input, output=DummyOutput()):
            terminal._init_prompt_session()
            session = terminal._prompt_session
            pipe_input.send_text("foo\x1b\x0abar\r")
            result = await asyncio.wait_for(
                session.prompt_async("> ", set_exception_handler=False), timeout=10,
            )

    assert result == "foo\nbar"


@pytest.mark.asyncio
async def test_csi_u_shift_enter_inserts_newline_not_raw_escape():
    from prompt_toolkit.application import create_app_session
    from prompt_toolkit.input import create_pipe_input
    from prompt_toolkit.output import DummyOutput

    with create_pipe_input() as pipe_input:
        with create_app_session(input=pipe_input, output=DummyOutput()):
            terminal._init_prompt_session()
            session = terminal._prompt_session
            pipe_input.send_text("foo\x1b[13;2ubar\r")
            result = await asyncio.wait_for(
                session.prompt_async("> ", set_exception_handler=False), timeout=10,
            )

    assert result == "foo\nbar"


def test_thinking_spinner_pause_stops_and_restarts():
    spinner = MagicMock()
    mock_console = MagicMock()
    mock_console.status.return_value = spinner

    thinking = stream_mod.ThinkingSpinner(console=mock_console)
    with thinking:
        with thinking.pause():
            pass

    assert spinner.method_calls == [
        call.start(),
        call.stop(),
        call.start(),
        call.stop(),
    ]


def test_print_cli_progress_line_pauses_spinner_before_printing():
    order: list[str] = []
    spinner = MagicMock()
    spinner.start.side_effect = lambda: order.append("start")
    spinner.stop.side_effect = lambda: order.append("stop")
    mock_console = MagicMock()
    mock_console.status.return_value = spinner

    with patch.object(terminal.console, "print", side_effect=lambda *_args, **_kwargs: order.append("print")):
        thinking = stream_mod.ThinkingSpinner(console=mock_console)
        with thinking:
            terminal._print_cli_progress_line("tool running", thinking)

    assert order == ["start", "stop", "print", "start", "stop"]


def test_thinking_spinner_clears_status_line_when_paused():
    stream = StringIO()
    stream.isatty = lambda: True  # type: ignore[method-assign]
    mock_console = MagicMock()
    mock_console.file = stream
    spinner = MagicMock()
    mock_console.status.return_value = spinner

    thinking = stream_mod.ThinkingSpinner(console=mock_console)
    with thinking:
        with thinking.pause():
            pass

    assert "\r\x1b[2K" in stream.getvalue()


def test_stream_renderer_stops_spinner_even_after_header_printed():
    stream = StringIO()
    stream.isatty = lambda: True  # type: ignore[method-assign]
    mock_console = MagicMock()
    mock_console.file = stream
    spinner = MagicMock()
    mock_console.status.return_value = spinner

    with patch.object(stream_mod, "_make_console", return_value=mock_console):
        renderer = stream_mod.StreamRenderer(show_spinner=True)
        renderer._header_printed = True
        renderer.ensure_header()

    spinner.stop.assert_called_once()
    assert "\r\x1b[2K" in stream.getvalue()


def test_print_cli_progress_line_opens_renderer_header_before_trace():
    order: list[str] = []
    renderer = MagicMock()
    renderer.console.print.side_effect = lambda *_args, **_kwargs: order.append("print")
    renderer.ensure_header.side_effect = lambda: order.append("header")
    renderer.pause_spinner.return_value = nullcontext()

    terminal._print_cli_progress_line("tool running", None, renderer)

    assert order == ["header", "print"]


def test_print_cli_progress_line_stops_live_before_trace():
    mock_live = MagicMock()
    renderer = stream_mod.StreamRenderer(show_spinner=False)
    renderer._live = mock_live

    terminal._print_cli_progress_line("tool running", None, renderer)

    mock_live.stop.assert_called_once()
    assert renderer._live is None


@pytest.mark.asyncio
async def test_print_interactive_progress_line_pauses_spinner_before_printing():
    order: list[str] = []
    spinner = MagicMock()
    spinner.start.side_effect = lambda: order.append("start")
    spinner.stop.side_effect = lambda: order.append("stop")
    mock_console = MagicMock()
    mock_console.status.return_value = spinner

    async def fake_print(_text: str) -> None:
        order.append("print")

    with patch("nanobot.cli.terminal._print_interactive_line", side_effect=fake_print):
        thinking = stream_mod.ThinkingSpinner(console=mock_console)
        with thinking:
            await terminal._print_interactive_progress_line("tool running", thinking)

    assert order == ["start", "stop", "print", "start", "stop"]


def test_response_renderable_uses_text_for_explicit_plain_rendering():
    status = (
        "🐈 nanobot v0.1.4.post5\n"
        "🧠 Model: MiniMax-M2.7\n"
        "πŸ“Š Tokens: 20639 in / 29 out"
    )

    renderable = terminal._response_renderable(
        status,
        render_markdown=True,
        metadata={"render_as": "text"},
    )

    assert renderable.__class__.__name__ == "Text"


def test_response_renderable_preserves_normal_markdown_rendering():
    renderable = terminal._response_renderable("**bold**", render_markdown=True)

    assert renderable.__class__.__name__ == "Markdown"


def test_response_renderable_without_metadata_keeps_markdown_path():
    help_text = "🐈 nanobot commands:\n/status β€” Show bot status\n/help β€” Show available commands"

    renderable = terminal._response_renderable(help_text, render_markdown=True)

    assert renderable.__class__.__name__ == "Markdown"


def test_stream_renderer_stop_for_input_stops_spinner():
    spinner = MagicMock()
    mock_console = MagicMock()
    mock_console.status.return_value = spinner

    with patch.object(stream_mod, "_make_console", return_value=mock_console):
        renderer = stream_mod.StreamRenderer(show_spinner=True)

        spinner.start.assert_called_once()

        renderer.stop_for_input()

        spinner.stop.assert_called_once()


@pytest.mark.asyncio
async def test_on_end_writes_final_content_to_stdout_after_stopping_live():
    mock_live = MagicMock()
    mock_console = MagicMock()
    mock_console.capture.return_value.__enter__ = MagicMock(
        return_value=MagicMock(get=lambda: "final output\n")
    )
    mock_console.capture.return_value.__exit__ = MagicMock(return_value=False)

    with patch.object(stream_mod, "_make_console", return_value=mock_console):
        renderer = stream_mod.StreamRenderer(show_spinner=False)
        renderer._live = mock_live
        renderer._buf = "final output"

        written: list[str] = []
        with patch("sys.stdout") as mock_stdout:
            mock_stdout.write = lambda s: written.append(s)
            mock_stdout.flush = MagicMock()
            await renderer.on_end()

    mock_live.stop.assert_called_once()
    assert renderer._live is None
    assert written == ["final output\n"]


@pytest.mark.asyncio
async def test_on_end_resuming_clears_buffer_and_restarts_spinner():
    spinner = MagicMock()
    mock_console = MagicMock()
    mock_console.status.return_value = spinner
    mock_console.capture.return_value.__enter__ = MagicMock(
        return_value=MagicMock(get=lambda: "")
    )
    mock_console.capture.return_value.__exit__ = MagicMock(return_value=False)

    with patch.object(stream_mod, "_make_console", return_value=mock_console):
        renderer = stream_mod.StreamRenderer(show_spinner=True)
        renderer._buf = "some content"

        await renderer.on_end(resuming=True)

    assert renderer._buf == ""
    assert spinner.start.call_count == 2


def test_make_console_force_terminal_when_stdout_is_tty():
    import sys
    with patch.object(sys.stdout, "isatty", return_value=True):
        console = stream_mod._make_console()
        assert console._force_terminal is True


def test_make_console_force_terminal_false_when_stdout_is_not_tty():
    """Console should set force_terminal=False when stdout is not a TTY so that
    ANSI escape codes (cursor visibility, braille spinner frames) don't pollute
    piped output such as `docker exec -i` (#3265)."""
    import sys
    with patch.object(sys.stdout, "isatty", return_value=False):
        console = stream_mod._make_console()
        assert console._force_terminal is False


def test_render_interactive_ansi_force_terminal_follows_isatty():
    """Mirror of _make_console: the capture console used to produce ANSI for
    prompt_toolkit must also defer to sys.stdout.isatty(), otherwise cursor
    escapes and spinner frames leak into piped output (#3265, #3370)."""
    import sys
    captured: dict = {}

    def render_fn(c):
        captured["console"] = c

    with patch.object(sys.stdout, "isatty", return_value=True):
        terminal._render_interactive_ansi(render_fn)
        assert captured["console"]._force_terminal is True

    with patch.object(sys.stdout, "isatty", return_value=False):
        terminal._render_interactive_ansi(render_fn)
        assert captured["console"]._force_terminal is False