Skip to content

Automate browser based workflows with AI

14.2 KB
Raw Blame
"""The argument-validation middleware rejects malformed tool calls with a clear,
structured error instead of letting FastMCP raise a raw pydantic ValidationError.

Each case mirrors a real production error signature where a caller sent argument
names that don't match the tool's contract.
"""

from __future__ import annotations

from types import SimpleNamespace
from unittest.mock import AsyncMock, MagicMock

import pytest

from skyvern.cli.core.browser_ops import NavigateResult
from skyvern.cli.core.result import BrowserContext
from skyvern.cli.mcp_tools import browser as mcp_browser
from skyvern.cli.mcp_tools import mcp
from skyvern.cli.mcp_tools import session as mcp_session
from skyvern.cli.mcp_tools import workflow as mcp_workflow
from skyvern.cli.mcp_tools.argument_validation import _repair_argument_types, _split_comma_separated_list
from tests.unit._mcp_browser_fakes import make_mock_page, make_skyvern_page
from tests.unit._mcp_test_helpers import patch_skyvern_client


def _structured(result: object) -> dict:
    payload = getattr(result, "structured_content", None)
    assert isinstance(payload, dict), f"expected structured content dict, got {result!r}"
    return payload


async def _call(tool_name: str, arguments: dict) -> dict:
    result = await mcp.call_tool(tool_name, arguments)
    return _structured(result)


def _awaited_kwargs(mock: AsyncMock) -> dict:
    awaited = mock.await_args
    assert awaited is not None
    return dict(awaited.kwargs)


def _mock_navigation(monkeypatch: pytest.MonkeyPatch) -> AsyncMock:
    page = make_skyvern_page(make_mock_page())
    context = BrowserContext(mode="cloud_session", session_id="pbs_test")
    monkeypatch.setattr(mcp_browser, "get_page", AsyncMock(return_value=(page, context)))
    navigate = AsyncMock(return_value=NavigateResult(url="https://example.com", title="Example"))
    monkeypatch.setattr(mcp_browser, "do_navigate", navigate)
    return navigate


@pytest.mark.asyncio
@pytest.mark.parametrize(
    ("tool_name", "arguments", "unsupported", "missing"),
    [
        ("skyvern_get_errors", {"run_id": "wr_1"}, ["run_id"], []),
        ("skyvern_get_errors", {"workflow_run_id": "wr_1"}, ["workflow_run_id"], []),
        ("skyvern_wait", {"seconds": "3", "reason": "login"}, ["reason", "seconds"], []),
        ("skyvern_execute", {"tools": [{"tool": "navigate"}]}, ["tools"], ["steps"]),
        ("skyvern_script_get_code", {"workflow_id": "wpid_1"}, ["workflow_id"], ["script_id"]),
        (
            "skyvern_workflow_run",
            {"workflow_id": "wpid_1", "max_steps": 5, "timeout": 2700},
            ["max_steps", "timeout"],
            [],
        ),
    ],
)
async def test_bad_arguments_rejected_with_structured_error(
    tool_name: str, arguments: dict, unsupported: list[str], missing: list[str]
) -> None:
    payload = await _call(tool_name, arguments)

    assert payload["ok"] is False
    error = payload["error"]
    assert error["code"] == "INVALID_INPUT"
    details = error["details"]
    assert details["unsupported_arguments"] == unsupported
    assert details["missing_required_arguments"] == missing
    # The rejection names the accepted arguments so the model can self-correct.
    assert details["expected_arguments"]
    for bad in unsupported:
        assert bad not in details["expected_arguments"]


@pytest.mark.asyncio
async def test_valid_argument_shape_is_not_blocked() -> None:
    """A validly-shaped call is not short-circuited by the middleware.

    ``skyvern_get_errors`` accepts ``text``; with no browser session it fails
    downstream, but with a tool-owned error (not the middleware's INVALID_INPUT
    unsupported-argument rejection), proving the pre-check let it through.
    """
    payload = await _call("skyvern_get_errors", {"text": "boom"})

    error = payload.get("error")
    if error is not None:
        assert "unsupported_arguments" not in error.get("details", {})


@pytest.mark.asyncio
async def test_session_create_null_profile_flag_uses_published_default(monkeypatch: pytest.MonkeyPatch) -> None:
    fake_skyvern = MagicMock()
    fake_skyvern.create_browser_session = AsyncMock(
        return_value=SimpleNamespace(browser_session_id="pbs_test", app_url=None)
    )
    monkeypatch.setattr(mcp_session, "get_skyvern", lambda: fake_skyvern)
    monkeypatch.setattr(mcp_session, "is_stateless_http_mode", lambda: True)

    payload = await _call("skyvern_browser_session_create", {"generate_browser_profile": None})

    assert payload["ok"] is True
    fake_skyvern.create_browser_session.assert_awaited_once_with(timeout=60, proxy_location=None)


@pytest.mark.asyncio
async def test_workflow_run_list_comma_separated_status_is_split_for_list_parameter_before_validation(
    monkeypatch: pytest.MonkeyPatch,
) -> None:
    list_runs = AsyncMock(return_value=[])
    monkeypatch.setattr(mcp_workflow, "list_workflow_runs_raw", list_runs)

    payload = await _call(
        "skyvern_workflow_run_list",
        {"workflow_id": "wpid_test", "status": "terminated, failed"},
    )

    assert payload["ok"] is True
    assert _awaited_kwargs(list_runs)["status"] == ["terminated", "failed"]


@pytest.mark.asyncio
async def test_workflow_run_list_bare_status_string_is_wrapped_into_list_before_validation(
    monkeypatch: pytest.MonkeyPatch,
) -> None:
    list_runs = AsyncMock(return_value=[])
    monkeypatch.setattr(mcp_workflow, "list_workflow_runs_raw", list_runs)

    payload = await _call("skyvern_workflow_run_list", {"workflow_id": "wpid_test", "status": "completed"})

    assert payload["ok"] is True
    assert _awaited_kwargs(list_runs)["status"] == ["completed"]


@pytest.mark.asyncio
async def test_workflow_run_object_parameters_are_json_encoded_before_validation(
    monkeypatch: pytest.MonkeyPatch,
) -> None:
    fake_client = SimpleNamespace(
        run_workflow=AsyncMock(return_value=SimpleNamespace(run_id="wr_test", status="queued"))
    )
    patch_skyvern_client(monkeypatch, fake_client)
    workflow_parameters = {"account_id": "acct_1", "reference": "REF-0001"}

    payload = await _call("skyvern_workflow_run", {"workflow_id": "wpid_test", "parameters": workflow_parameters})

    assert payload["ok"] is True
    assert _awaited_kwargs(fake_client.run_workflow)["parameters"] == workflow_parameters


@pytest.mark.asyncio
async def test_object_value_is_not_json_encoded_for_unapproved_string_parameter() -> None:
    tool = await mcp.get_tool("skyvern_workflow_create")
    arguments = {"title": "Example", "definition": {"workflow_definition": {"blocks": []}}}

    _repair_argument_types("skyvern_workflow_create", tool, arguments)

    assert arguments["definition"] == {"workflow_definition": {"blocks": []}}


@pytest.mark.asyncio
async def test_comma_separated_string_is_not_split_for_non_list_parameter(monkeypatch: pytest.MonkeyPatch) -> None:
    list_runs = AsyncMock(return_value=[])
    monkeypatch.setattr(mcp_workflow, "list_workflow_runs_raw", list_runs)

    payload = await _call(
        "skyvern_workflow_run_list",
        {"workflow_id": "wpid_test", "search_key": "terminated,failed"},
    )

    assert payload["ok"] is True
    assert _awaited_kwargs(list_runs)["search_key"] == "terminated,failed"


@pytest.mark.asyncio
async def test_comma_separated_string_is_not_split_for_unapproved_list_parameter() -> None:
    tool = await mcp.get_tool("skyvern_file_upload")
    arguments = {"file_paths": "/tmp/Last, First.pdf"}

    _repair_argument_types("skyvern_file_upload", tool, arguments)

    assert arguments["file_paths"] == "/tmp/Last, First.pdf"


@pytest.mark.parametrize(
    "value",
    ['["terminated","failed"]', "terminated,,failed", ""],
)
def test_csv_list_repair_leaves_structured_or_ambiguous_strings_for_other_validation(value: str) -> None:
    assert _split_comma_separated_list(value) == value


def test_csv_list_repair_leaves_excessive_item_count_for_other_validation() -> None:
    value = ",".join(["terminated"] * 101)

    assert _split_comma_separated_list(value) == value


@pytest.mark.asyncio
@pytest.mark.usefixtures("public_dns")
async def test_navigate_sub_1000_timeout_is_treated_as_seconds_and_converted_to_milliseconds(
    monkeypatch: pytest.MonkeyPatch,
) -> None:
    navigate = _mock_navigation(monkeypatch)

    payload = await _call("skyvern_navigate", {"url": "https://example.com", "timeout": 60})

    assert payload["ok"] is True
    assert _awaited_kwargs(navigate)["timeout"] == 60000


@pytest.mark.asyncio
@pytest.mark.parametrize(("timeout_seconds", "timeout_ms"), [(1.5, 1500)])
async def test_navigate_fractional_seconds_with_whole_milliseconds_are_converted_to_int(
    timeout_seconds: float,
    timeout_ms: int,
) -> None:
    tool = await mcp.get_tool("skyvern_navigate")
    arguments = {"timeout": timeout_seconds}

    _repair_argument_types("skyvern_navigate", tool, arguments)

    assert arguments["timeout"] == timeout_ms
    assert type(arguments["timeout"]) is int


@pytest.mark.asyncio
async def test_navigate_fractional_seconds_stay_unchanged_when_rescaling_is_still_below_minimum() -> None:
    tool = await mcp.get_tool("skyvern_navigate")
    arguments = {"timeout": 0.5}

    _repair_argument_types("skyvern_navigate", tool, arguments)

    assert arguments["timeout"] == 0.5


@pytest.mark.asyncio
@pytest.mark.usefixtures("public_dns")
async def test_navigate_timeout_at_millisecond_threshold_is_not_scaled(monkeypatch: pytest.MonkeyPatch) -> None:
    navigate = _mock_navigation(monkeypatch)

    payload = await _call("skyvern_navigate", {"url": "https://example.com", "timeout": 1000})

    assert payload["ok"] is True
    assert _awaited_kwargs(navigate)["timeout"] == 1000


@pytest.mark.asyncio
async def test_composite_navigate_sub_1000_timeout_reaches_the_navigate_step_as_milliseconds(
    monkeypatch: pytest.MonkeyPatch,
) -> None:
    paired_capture = AsyncMock(return_value={"ok": True, "action": "navigate_extract_and_screenshot"})
    monkeypatch.setattr(mcp_browser, "_run_paired_capture", paired_capture)

    payload = await _call(
        "skyvern_navigate_extract_and_screenshot",
        {"url": "https://example.com", "prompt": "read the page", "timeout": 45},
    )

    assert payload["ok"] is True
    operations = dict(paired_capture.await_args.args[1])
    assert operations["navigate"]["timeout"] == 45000


@pytest.mark.asyncio
@pytest.mark.parametrize(
    ("timeout", "expected_timeout", "expected_error"),
    [
        (60, 60000, None),
        (90, None, "timeout is in milliseconds (1000-60000); got 90 - for seconds, use 1-60"),
        (100, None, "timeout is in milliseconds (1000-60000); got 100 - for seconds, use 1-60"),
        (500, None, "timeout is in milliseconds (1000-60000); got 500 - for seconds, use 1-60"),
    ],
)
async def test_click_timeout_repairs_valid_seconds_and_rejects_ambiguous_values_at_mcp_dispatch(
    monkeypatch: pytest.MonkeyPatch, timeout: int, expected_timeout: int | None, expected_error: str | None
) -> None:
    click = AsyncMock(return_value="#submit")
    page = make_skyvern_page(make_mock_page())
    page.click = click
    context = BrowserContext(mode="cloud_session", session_id="pbs_test")
    monkeypatch.setattr(mcp_browser, "get_page", AsyncMock(return_value=(page, context)))

    payload = await _call("skyvern_click", {"selector": "#submit", "selector_mode": "direct", "timeout": timeout})

    if expected_error is not None:
        assert payload["ok"] is False
        assert payload["error"]["code"] == "INVALID_INPUT"
        assert payload["error"]["message"] == expected_error
        assert payload["error"]["hint"] == "For seconds, pass 1-60; otherwise provide milliseconds from 1000-60000."
        click.assert_not_awaited()
    else:
        assert payload["ok"] is True
        assert _awaited_kwargs(click)["timeout"] == expected_timeout


@pytest.mark.asyncio
@pytest.mark.parametrize(
    ("tool_name", "argument", "sent", "expected"),
    [
        # Sub-floor values on millisecond-named parameters are interpreted as seconds.
        ("skyvern_navigate_extract_and_screenshot", "timeout", 45, 45000),
        ("skyvern_navigate_and_screenshot", "timeout", 30, 30000),
        ("skyvern_click", "timeout", 10, 10000),
        ("skyvern_wait", "poll_interval_ms", 5, 5000),
        ("skyvern_tab_wait_for_new", "timeout_ms", 20, 20000),
        ("skyvern_open_tabs", "per_tab_timeout_ms", 15, 15000),
        # Second- and minute-denominated parameters mean what they say and must survive untouched.
        ("skyvern_browser_session_create", "timeout", 5, 5),
        ("skyvern_run_task", "timeout_seconds", 45, 45),
        ("skyvern_workflow_run", "timeout_seconds", 30, 30),
        ("skyvern_login", "timeout_seconds", 60, 60),
        # Seconds are converted only when the result fits the schema's millisecond range.
        ("skyvern_click", "timeout", 45, 45000),
        ("skyvern_click", "timeout", 60, 60000),
    ],
)
async def test_timeout_repair_rescales_millisecond_parameters_only(
    tool_name: str, argument: str, sent: int, expected: int
) -> None:
    tool = await mcp.get_tool(tool_name)
    arguments = {argument: sent}

    _repair_argument_types(tool_name, tool, arguments)

    assert arguments[argument] == expected


@pytest.mark.asyncio
async def test_type_repair_preserves_structured_missing_key_rejection() -> None:
    payload = await _call("skyvern_workflow_run_list", {"status": "terminated,failed"})

    assert payload["ok"] is False
    error = payload["error"]
    assert error["code"] == "INVALID_INPUT"
    assert error["details"]["unsupported_arguments"] == []
    assert error["details"]["missing_required_arguments"] == ["workflow_id"]


@pytest.mark.asyncio
async def test_out_of_schema_value_gets_structured_error_instead_of_raising(monkeypatch: pytest.MonkeyPatch) -> None:
    list_runs = AsyncMock(return_value=[])
    monkeypatch.setattr(mcp_workflow, "list_workflow_runs_raw", list_runs)

    # SKY-15319: page below the tool's documented 1-based minimum. Before the fix, FastMCP's own
    # pydantic validation raised fastmcp.exceptions.ValidationError out of call_next, uncaught here.
    payload = await _call("skyvern_workflow_run_list", {"workflow_id": "wpid_test", "page": 0})

    assert payload["ok"] is False
    error = payload["error"]
    assert error["code"] == "INVALID_INPUT"
    assert "page" in error["message"]
    assert "skyvern_workflow_run_list" in error["hint"]
    list_runs.assert_not_awaited()