hud-python 0.4.21__py3-none-any.whl → 0.4.22__py3-none-any.whl

hud/tools/grounding/tests/test_grounded_tool.py

@@ -0,0 +1,196 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+import mcp.types as types
+import pytest
+
+from hud.tools.grounding.grounded_tool import GroundedComputerTool
+from hud.types import MCPToolCall, MCPToolResult
+
+
+@dataclass
+class FakeResult:
+    content: list[types.ContentBlock]
+    isError: bool = False
+    structuredContent: dict | None = None
+
+
+class FakeMCPClient:
+    """Fake MCP client that implements AgentMCPClient protocol."""
+
+    _initialized: bool
+
+    def __init__(self) -> None:
+        self.calls: list[tuple[str, dict[str, Any]]] = []
+        self._initialized = False
+
+    @property
+    def mcp_config(self) -> dict[str, dict[str, Any]]:
+        return {"test": {"command": "echo", "args": ["test"]}}
+
+    @property
+    def is_connected(self) -> bool:
+        return self._initialized
+
+    async def initialize(self, mcp_config: dict[str, dict[str, Any]] | None = None) -> None:
+        self._initialized = True
+
+    async def list_tools(self) -> list[types.Tool]:
+        return [types.Tool(name="computer", description="Test tool", inputSchema={})]
+
+    async def call_tool(self, tool_call: MCPToolCall) -> MCPToolResult:
+        self.calls.append((tool_call.name, tool_call.arguments or {}))
+        return MCPToolResult(content=[types.TextContent(text="ok", type="text")], isError=False)
+
+    async def shutdown(self) -> None:
+        self._initialized = False
+
+
+class FakeGrounder:
+    """Fake grounder that implements Grounder interface."""
+
+    def __init__(self, coords: tuple[int, int] | None = (10, 20)) -> None:
+        self.coords = coords
+        self.calls: list[tuple[str, str]] = []
+
+    async def predict_click(
+        self, *, image_b64: str, instruction: str, max_retries: int = 3
+    ) -> tuple[int, int] | None:
+        self.calls.append((image_b64[:10], instruction))
+        return self.coords
+
+
+def _png_b64() -> str:
+    # 1x1 transparent PNG base64 (valid minimal image)
+    return (
+        "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR4nGMAAQAABQAB"
+        "J2n0mQAAAABJRU5ErkJggg=="
+    )
+
+
+@pytest.mark.asyncio
+async def test_click_action_grounds_and_calls_mcp() -> None:
+    client = FakeMCPClient()
+    grounder = FakeGrounder(coords=(123, 456))
+    tool = GroundedComputerTool(grounder=grounder, mcp_client=client)  # type: ignore
+
+    blocks = await tool(
+        action="click",
+        element_description="red button",
+        screenshot_b64=_png_b64(),
+        button="left",
+    )
+
+    assert isinstance(blocks, list)
+    # Grounder called once
+    assert len(grounder.calls) == 1
+    # MCP called with resolved coordinates
+    assert client.calls == [("computer", {"action": "click", "x": 123, "y": 456, "button": "left"})]
+
+
+@pytest.mark.asyncio
+async def test_move_and_scroll_require_element_description_and_screenshot() -> None:
+    client = FakeMCPClient()
+    grounder = FakeGrounder(coords=(5, 6))
+    tool = GroundedComputerTool(grounder=grounder, mcp_client=client)  # type: ignore
+
+    # Missing element_description
+    with pytest.raises(Exception) as ei:
+        await tool(action="move", screenshot_b64=_png_b64())
+    assert "element_description is required" in str(ei.value)
+
+    # Missing screenshot
+    with pytest.raises(Exception) as ei2:
+        await tool(action="scroll", element_description="list", scroll_y=100)
+    assert "No screenshot available" in str(ei2.value)
+
+
+@pytest.mark.asyncio
+async def test_drag_grounds_both_points_and_calls_mcp() -> None:
+    client = FakeMCPClient()
+    grounder = FakeGrounder(coords=(10, 20))
+    tool = GroundedComputerTool(grounder=grounder, mcp_client=client)  # type: ignore
+
+    await tool(
+        action="drag",
+        start_element_description="source",
+        end_element_description="target",
+        screenshot_b64=_png_b64(),
+        button="left",
+    )
+
+    # Two grounding calls (start and end)
+    assert len(grounder.calls) == 2
+    # Drag path contains two points, same coords from fake grounder
+    name, args = client.calls[0]
+    assert name == "computer"
+    assert args["action"] == "drag"
+    assert args["button"] == "left"
+    assert args["path"] == [(10, 20), (10, 20)]
+
+
+@pytest.mark.asyncio
+async def test_drag_requires_both_descriptions_and_screenshot() -> None:
+    client = FakeMCPClient()
+    grounder = FakeGrounder()
+    tool = GroundedComputerTool(grounder=grounder, mcp_client=client)  # type: ignore
+
+    with pytest.raises(Exception) as ei:
+        await tool(action="drag", start_element_description="a", screenshot_b64=_png_b64())
+    assert "start_element_description and end_element_description" in str(ei.value)
+
+    with pytest.raises(Exception) as ei2:
+        await tool(
+            action="drag",
+            start_element_description="a",
+            end_element_description="b",
+        )
+    assert "No screenshot available" in str(ei2.value)
+
+
+@pytest.mark.asyncio
+async def test_direct_actions_bypass_grounding_and_call_mcp() -> None:
+    client = FakeMCPClient()
+    grounder = FakeGrounder()
+    tool = GroundedComputerTool(grounder=grounder, mcp_client=client)  # type: ignore
+
+    # Actions that bypass grounding
+    for action, extra in [
+        ("screenshot", {}),
+        ("type", {"text": "hello"}),
+        ("keypress", {"keys": ["ctrl", "a"]}),
+        ("wait", {}),
+        ("get_current_url", {}),
+        ("get_dimensions", {}),
+        ("get_environment", {}),
+    ]:
+        client.calls.clear()
+        _ = await tool(action=action, **extra)
+        assert client.calls and client.calls[0][0] == "computer"
+        assert client.calls[0][1]["action"] == action
+    # Grounder not invoked for these
+    assert grounder.calls == []
+
+
+@pytest.mark.asyncio
+async def test_unsupported_action_raises() -> None:
+    client = FakeMCPClient()
+    grounder = FakeGrounder()
+    tool = GroundedComputerTool(grounder=grounder, mcp_client=client)  # type: ignore
+
+    with pytest.raises(Exception) as ei:
+        await tool(action="zoom")
+    assert "Unsupported action" in str(ei.value)
+
+
+@pytest.mark.asyncio
+async def test_grounding_failure_propagates_as_error() -> None:
+    client = FakeMCPClient()
+    grounder = FakeGrounder(coords=None)
+    tool = GroundedComputerTool(grounder=grounder, mcp_client=client)  # type: ignore
+
+    with pytest.raises(Exception) as ei:
+        await tool(action="click", element_description="x", screenshot_b64=_png_b64())
+    assert "Could not locate element" in str(ei.value)

hud/tools/tests/test_playwright_tool.py

@@ -52,7 +52,7 @@ class TestPlaywrightTool:
             assert any(isinstance(b, TextContent) for b in blocks)
             # The actual call includes wait_until parameter with a Field object
             mock_page.goto.assert_called_once()
-            args, kwargs = mock_page.goto.call_args
+            args, _kwargs = mock_page.goto.call_args
             assert args[0] == "https://example.com"
             mock_ensure.assert_called_once()
 

hud/tools/tests/test_tools_init.py

@@ -33,7 +33,7 @@ class TestToolsInit:
         """Test lazy import with invalid attribute name."""
         import hud.tools as tools_module
 
-        with pytest.raises(AttributeError, match="module '.*' has no attribute 'InvalidTool'"):
+        with pytest.raises(AttributeError, match=r"module '.*' has no attribute 'InvalidTool'"):
             _ = tools_module.InvalidTool
 
     def test_direct_imports_available(self):

hud/tools/tests/test_utils.py

@@ -58,7 +58,7 @@ class TestRun:
         mock_proc.communicate = AsyncMock(return_value=(b"processed", b""))
 
         with patch("asyncio.create_subprocess_shell", return_value=mock_proc):
-            return_code, stdout, stderr = await run("cat", input="test input")
+            return_code, stdout, _stderr = await run("cat", input="test input")
 
             assert return_code == 0
             assert stdout == "processed"
@@ -91,7 +91,7 @@ class TestRun:
         ):
             mock_wait_for.return_value = (b"done", b"")
 
-            return_code, stdout, stderr = await run("sleep 1", timeout=5.0)
+            _return_code, _stdout, _stderr = await run("sleep 1", timeout=5.0)
 
             # Check that wait_for was called with the correct timeout
             mock_wait_for.assert_called_once()

hud/utils/agent_factories.py

@@ -0,0 +1,86 @@
+"""Factory functions for creating agents compatible with run_dataset."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from openai import AsyncOpenAI
+
+from hud.agents.grounded_openai import GroundedOpenAIChatAgent
+from hud.agents.openai_chat_generic import GenericOpenAIChatAgent
+from hud.tools.grounding import GrounderConfig
+
+
+def create_openai_agent(**kwargs: Any) -> GenericOpenAIChatAgent:
+    """Factory for GenericOpenAIChatAgent with run_dataset compatibility.
+
+    Args:
+        api_key: OpenAI API key
+        base_url: Optional custom API endpoint
+        model_name: Model to use (e.g., "gpt-4o-mini")
+        **kwargs: Additional arguments passed to GenericOpenAIChatAgent
+
+    Returns:
+        Configured GenericOpenAIChatAgent instance
+
+    Example:
+        >>> from hud.datasets import run_dataset
+        >>> from hud.utils.agent_factories import create_openai_agent
+        >>> results = await run_dataset(
+        ...     "My Eval",
+        ...     "hud-evals/SheetBench-50",
+        ...     create_openai_agent,
+        ...     {"api_key": "your-key", "model_name": "gpt-4o-mini"},
+        ... )
+    """
+    api_key = kwargs.pop("api_key", None)
+    base_url = kwargs.pop("base_url", None)
+
+    openai_client = AsyncOpenAI(api_key=api_key, base_url=base_url)
+
+    return GenericOpenAIChatAgent(openai_client=openai_client, **kwargs)
+
+
+def create_grounded_agent(**kwargs: Any) -> GroundedOpenAIChatAgent:
+    """Factory for GroundedOpenAIChatAgent with run_dataset compatibility.
+
+    Args:
+        api_key: OpenAI API key for planning model
+        base_url: Optional custom API endpoint for planning model
+        model_name: Planning model to use (e.g., "gpt-4o-mini")
+        grounder_api_key: API key for grounding model
+        grounder_api_base: API base URL for grounding model (default: OpenRouter)
+        grounder_model: Grounding model to use (default: qwen/qwen-2.5-vl-7b-instruct)
+        **kwargs: Additional arguments passed to GroundedOpenAIChatAgent
+
+    Returns:
+        Configured GroundedOpenAIChatAgent instance
+
+    Example:
+        >>> from hud.datasets import run_dataset
+        >>> from hud.utils.agent_factories import create_grounded_agent
+        >>> results = await run_dataset(
+        ...     "Grounded Eval",
+        ...     dataset,
+        ...     create_grounded_agent,
+        ...     {
+        ...         "api_key": "openai-key",
+        ...         "grounder_api_key": "openrouter-key",
+        ...         "model_name": "gpt-4o-mini",
+        ...     },
+        ... )
+    """
+    api_key = kwargs.pop("api_key", None)
+    base_url = kwargs.pop("base_url", None)
+    grounder_api_key = kwargs.pop("grounder_api_key", None)
+    grounder_api_base = kwargs.pop("grounder_api_base", "https://openrouter.ai/api/v1")
+    grounder_model = kwargs.pop("grounder_model", "qwen/qwen-2.5-vl-7b-instruct")
+
+    openai_client = AsyncOpenAI(api_key=api_key, base_url=base_url)
+    grounder_config = GrounderConfig(
+        api_base=grounder_api_base, model=grounder_model, api_key=grounder_api_key
+    )
+
+    return GroundedOpenAIChatAgent(
+        openai_client=openai_client, grounder_config=grounder_config, **kwargs
+    )

hud/utils/tests/test_version.py

@@ -5,4 +5,4 @@ def test_import():
     """Test that the package can be imported."""
     import hud
 
-    assert hud.__version__ == "0.4.21"
+    assert hud.__version__ == "0.4.22"

hud/version.py

@@ -4,4 +4,4 @@ Version information for the HUD SDK.
 
 from __future__ import annotations
 
-__version__ = "0.4.21"
+__version__ = "0.4.22"

{hud_python-0.4.21.dist-info → hud_python-0.4.22.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hud-python
-Version: 0.4.21
+Version: 0.4.22
 Summary: SDK for the HUD platform.
 Project-URL: Homepage, https://github.com/hud-evals/hud-python
 Project-URL: Bug Tracker, https://github.com/hud-evals/hud-python/issues

{hud_python-0.4.21.dist-info → hud_python-0.4.22.dist-info}/RECORD

@@ -1,11 +1,12 @@
 hud/__init__.py,sha256=KU7G-_Mj6Mjf7trXA6X0ufN6QUmqhVi19NKbnNIvD74,532
 hud/__main__.py,sha256=YR8Dq8OhINOsVfQ55PmRXXg4fEK84Rt_-rMtJ5rvhWo,145
-hud/settings.py,sha256=q9aZiHjvbL4oLE-N8AttTW4rmzS8zPMnsca-iMGyEGc,2362
+hud/settings.py,sha256=bgq_zstNGlan7UDZOiElY8Aw5ZU4xL7Ds5HP_Xzph1A,2535
 hud/types.py,sha256=DDK7-jcoI0iZbyIOfXlGJy9MpHAGcw_4napLs-v-8vY,6077
-hud/version.py,sha256=888JgQ-gt1NqBeShBZC3JqfOBDr4dkkOuQ33EZpv7yA,105
+hud/version.py,sha256=T_tMaYLlvl2YQTkRh6f_ODEmmcIi1QPFX6xOChwfcCA,105
 hud/agents/__init__.py,sha256=UoIkljWdbq4bM0LD-mSaw6w826EqdEjOk7r6glNYwYQ,286
-hud/agents/base.py,sha256=2kZ8KOuNk_RQGqE7MvdMPm_jrlAkiaNNBz1tEW0Uxpg,30937
-hud/agents/claude.py,sha256=upWnGGwLz88k8i6zg0A6l1rK7DSTwJEU8pRevnR3irc,15314
+hud/agents/base.py,sha256=kvHimAckIMGl4mge6KajxjQKd_v1PmUYRZUNRtcggHs,30965
+hud/agents/claude.py,sha256=Ixc05qg-r0H1OoC_DE5Ov6RtODWp7uJcTJJqpmoIob0,15478
+hud/agents/grounded_openai.py,sha256=bUB0sOYkWPx1NfASI97gVixV6CM5GY3K61S_upCSPm8,11176
 hud/agents/langchain.py,sha256=1EgCy8jfjunsWxlPC5XfvfLS6_XZVrIF1ZjtHcrvhYw,9584
 hud/agents/openai.py,sha256=tvFYsZ5yaoLkfjMnHe-COxRttMsLRXBLPdSqgeipQRk,14257
 hud/agents/openai_chat_generic.py,sha256=PQAD4GGE6sHs8R95qpgDBHEbSOJ7WXCYGYFmd3Nic1g,10628
@@ -14,7 +15,8 @@ hud/agents/misc/response_agent.py,sha256=pnaomb4H-QJm1YKU3tC1YnZXxOlDbTHIXaIH-6N
 hud/agents/tests/__init__.py,sha256=W-O-_4i34d9TTyEHV-O_q1Ai1gLhzwDaaPo02_TWQIY,34
 hud/agents/tests/test_base.py,sha256=F39ajSqASGUbPyPoWSY9KARFav62qNTK74W11Tr1Tg4,28970
 hud/agents/tests/test_claude.py,sha256=wqEKlzEvx8obz1sSm4NY0j-Zyt1qWNfDOmRqYIuAEd0,13069
-hud/agents/tests/test_client.py,sha256=fZoT22awa-Q84kAZ0CGiFGLNDEjBQ75rf6lImmVDsoQ,13120
+hud/agents/tests/test_client.py,sha256=uikgh6yhjPPX2RBU4XJQMz1mNox9uXjuwsP8t93id18,13337
+hud/agents/tests/test_grounded_openai_agent.py,sha256=VK8lUvHIjWicMX00VKPE-FZyjiJqTEhb80MuRRa9fVc,5437
 hud/agents/tests/test_openai.py,sha256=lhHowQyLp09oDVwBUjUECoPeH01F16i4O9YIHeugK6E,7028
 hud/cli/__init__.py,sha256=W4McbKAvs8cMIYlruzjV8Z_nxkmOK9ktYWP-WBnD6xo,35804
 hud/cli/__main__.py,sha256=fDH7XITyuDITwSDIVwRso06aouADO0CzTHKqp5TOwJE,143
@@ -23,7 +25,7 @@ hud/cli/build.py,sha256=_3rNFhNDNAChE95Ou5AqblVfD6QlUwKtcpgrPFChuq8,17742
 hud/cli/clone.py,sha256=AwVDIuhr8mHb1oT2Af2HrD25SiTdwATpE6zd93vzLgA,6099
 hud/cli/debug.py,sha256=FNzg9-_ZzUJA1nJfubmop7_2OT5mqnWsdpZyi4AVSXA,14163
 hud/cli/dev.py,sha256=R7YJWIZCUURXzs8ovOCF9V1FwOhsAJT5D3mZQkFmTI4,31134
-hud/cli/eval.py,sha256=v_uvzkS-J_dsxzVqszPkotOfUsNoq501-Ygdqi9BhKA,15770
+hud/cli/eval.py,sha256=3ASGiQ4IZPB5EdMoNtwsPmmhO7v3lRmq8uoQCIsf5dM,15770
 hud/cli/hf.py,sha256=EYWL-fEN9SS2QJYU7iIBXs0qa9JIvmMWOMh9a8Ewt9s,15179
 hud/cli/init.py,sha256=7Yqp3gUVmK-vVE_6A9RKhZlSTlwxxb2ylJn1H22TYSY,19573
 hud/cli/list_func.py,sha256=ENxLL4X5uuqAASWZdQuI0k-tEzmlhUn5LATgz3QPQqQ,7065
@@ -57,7 +59,7 @@ hud/cli/utils/__init__.py,sha256=L6s0oNzY2LugGp9faodCPnjzM-ZUorUH05-HmYOq5hY,35
 hud/cli/utils/cursor.py,sha256=fy850p0rVp5k_1wwOCI7rK1SggbselJrywFInSQ2gio,3009
 hud/cli/utils/docker.py,sha256=VTUcoPqxh3uXOgvL6NSqYiSDhyCPRp3jTfFbnIDwumg,3774
 hud/cli/utils/environment.py,sha256=-Z8UkXlRpdGsBkjw-x1EJ2IwcSCrlWaaf25ZoPDMrtw,4225
-hud/cli/utils/interactive.py,sha256=QiKL14rRdzuU_wBgCYEoA3JVMO6eJUezAZxX0GjZKRU,16526
+hud/cli/utils/interactive.py,sha256=qD25ZhDHI037EAhZUBFUXUpuERM979PnsxFTfpvNxhk,16523
 hud/cli/utils/logging.py,sha256=ZgjjKVPAa7dcfJ6SMBrdfZ63d1UnnhYC-zeh7gFBXsI,8841
 hud/cli/utils/metadata.py,sha256=VBvNNqHS5-sH97H3PhVmdOcyzZ2NGH47fVUUtHBoGLQ,7808
 hud/cli/utils/registry.py,sha256=N49cDHOWDp85EawIhQFQItt-yvFZpfLm74m8l4-LQy4,4349
@@ -135,10 +137,16 @@ hud/tools/computer/settings.py,sha256=b1XJsEQjB9qhN1xHfVENATkzinEebe0ZPyLzMgCGkK
 hud/tools/executors/__init__.py,sha256=jHxfus9SLhkL6YGtebR5RyKYyVAix3yu5EkUp2Q27Kg,732
 hud/tools/executors/base.py,sha256=VP2SiIEBSXvklnkasGxVuy-OmDMd9rjuxZh_YuUQH7A,14481
 hud/tools/executors/pyautogui.py,sha256=11eUQJAgFmHxwd9INAb2L9tgBmEv2Vgn0cwhwvGKlC8,22361
-hud/tools/executors/xdo.py,sha256=vc3ciSojmJ58HoL1VC2MC-F_KFrk4_YQHmoJp4rgv1k,18136
+hud/tools/executors/xdo.py,sha256=UF53DbMX-bRGiHd-O7cCJmCrVaYuP83xiJggER7HcDk,18137
 hud/tools/executors/tests/__init__.py,sha256=opFpGSH6cEqIZgt9izXd3Yt85pC7xkxiYmOZQTHf4AY,32
-hud/tools/executors/tests/test_base_executor.py,sha256=crTXzxsMF7cnUihCpTzpqOYSjXpZWMj-nofcqC4Nu8U,13548
+hud/tools/executors/tests/test_base_executor.py,sha256=ovh99to5jbQfrCKfCUnDbY-q3oDk_cMmHOVSv7Sn02E,13549
 hud/tools/executors/tests/test_pyautogui_executor.py,sha256=Shv6pnWtlsMXBMlN5DjlttCu6rZ1H447d1QZumduOnU,6640
+hud/tools/grounding/__init__.py,sha256=oazR_qTJqkeGtjy_0w1QW58PQ872PkVwtYI-v2KIX3k,311
+hud/tools/grounding/config.py,sha256=Vsd5ASDZFL7kW7toKkgrYN5D-ZV6ovKZyX4nxRrHvRs,1869
+hud/tools/grounding/grounded_tool.py,sha256=L3O8FzpDoC8ZrnT0xkjlUwAkg7mAbnhK3ju0nE2zCiQ,12679
+hud/tools/grounding/grounder.py,sha256=DwRp7I30ldgdDjxtUJuBh3GWESNUyHbRhCXT28m3xLk,11060
+hud/tools/grounding/tests/__init__.py,sha256=jLw4nmvvvZu2ln2_yEUUKg72IewQ4HaXCUWJuX3ECZY,33
+hud/tools/grounding/tests/test_grounded_tool.py,sha256=kr-wOOJZcfdYfhRSNFnhv8EuIsjbwgHDQbUSH9WnxMw,6446
 hud/tools/tests/__init__.py,sha256=eEYYkxX5Hz9woXVOBJ2H2_CQoEih0vH6nRt3sH2Z8v8,49
 hud/tools/tests/test_base.py,sha256=m6EelJ47F_hMqvRjrr6vEdiW1AtLgz3ZH1V1IUzTxzI,8983
 hud/tools/tests/test_bash.py,sha256=-g9a6sYgKKXRXmqYGYQBgpKEF_OlKE_uDDQXYMx6rT0,5113
@@ -147,12 +155,13 @@ hud/tools/tests/test_computer.py,sha256=BmrX2PV3wzHC4-xPJnWvenDV_kWt8LF8ia0kELBg
 hud/tools/tests/test_computer_actions.py,sha256=YtUNFL7anhpXrcvg8EoUY1CqIV-TAAyaNFLZO9CiJ40,1194
 hud/tools/tests/test_edit.py,sha256=pHw1MSs-P8mDKrwKUDW77vQfoMNwmbrEBt_MkKr2rE0,9734
 hud/tools/tests/test_init.py,sha256=fl4Tf4IUUFOKhdSRHu9GE4mkaTDiXw-2auxj4s84HuE,698
-hud/tools/tests/test_playwright_tool.py,sha256=0va9IuZ7P5vXZDzan_sn-89ahu3piQMQDaiREzEvXNc,6736
+hud/tools/tests/test_playwright_tool.py,sha256=TG0uieerc5wXq_JX66BLfXxphbSYGlDPhSbuoeizMu4,6737
 hud/tools/tests/test_response.py,sha256=pEv3p0k1reSKtjbA8xneu--OuCHydbHHl6YWorV4zOg,2212
 hud/tools/tests/test_tools.py,sha256=paz28V98Am-oR7MBJPDgY-BRV14HQo_0F6X5JIC8aic,4563
-hud/tools/tests/test_tools_init.py,sha256=qbUCNWbswlkbsSJR-CBnRk_h_l1CLasRffIhp8tMG84,1726
-hud/tools/tests/test_utils.py,sha256=oYxEnLpSA5sEeYFGUTj74QRNv0AHP3AjmYYHXgIW0BY,5496
+hud/tools/tests/test_tools_init.py,sha256=aOX9IKji-4ThHEiRYULa7YlIajP0lj3eFPjgzlEg9TI,1727
+hud/tools/tests/test_utils.py,sha256=qaujM1uyTMaKqWIeEgxty5GOFyfSUtrYCEHhmIazoy4,5500
 hud/utils/__init__.py,sha256=ckuIzwqgTxkzASa04XTPsOu_TqsRYUKBWUYfcSi3Xnc,164
+hud/utils/agent_factories.py,sha256=cvfXByqG6gOYHtm1VGeJjCpxoLxM4aJez8rH-AerP_A,3186
 hud/utils/async_utils.py,sha256=5cKrJcnaHV2eJNxeyx0r7fPcdPTDBK7kM9-nLaF51X4,2409
 hud/utils/design.py,sha256=Ymz29qdgqmnXCupDmASCqgkoW8fS6_cg5COXiFUUl50,17621
 hud/utils/mcp.py,sha256=jvCWb5MXlMMObhrbYoiTlI-L9HNkEjLVx8GJ-HbdQ7U,2626
@@ -165,10 +174,10 @@ hud/utils/tests/test_init.py,sha256=2QLQSGgyP9wJhOvPCusm_zjJad0qApOZi1BXpxcdHXQ,
 hud/utils/tests/test_mcp.py,sha256=0pUa16mL-bqbZDXp5NHBnt1gO5o10BOg7zTMHZ1DNPM,4023
 hud/utils/tests/test_progress.py,sha256=QSF7Kpi03Ff_l3mAeqW9qs1nhK50j9vBiSobZq7T4f4,7394
 hud/utils/tests/test_telemetry.py,sha256=5jl7bEx8C8b-FfFUko5pf4UY-mPOR-9HaeL98dGtVHM,2781
-hud/utils/tests/test_version.py,sha256=5ReSod83u8tP-ZJBhZwzeY-rFMhIy8Mpt-zP-v7YeEA,160
+hud/utils/tests/test_version.py,sha256=rjNpZ8hUWFWMassBYVxeyCM-03Rdz8W0C7HPDQuBJfo,160
 hud/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hud_python-0.4.21.dist-info/METADATA,sha256=Np2Ririw3UDdAAiaOIa0QSyDdYdjjAypm25ZoSK8KPg,20142
-hud_python-0.4.21.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-hud_python-0.4.21.dist-info/entry_points.txt,sha256=jJbodNFg1m0-CDofe5AHvB4zKBq7sSdP97-ohaQ3ae4,63
-hud_python-0.4.21.dist-info/licenses/LICENSE,sha256=yIzBheVUf86FC1bztAcr7RYWWNxyd3B-UJQ3uddg1HA,1078
-hud_python-0.4.21.dist-info/RECORD,,
+hud_python-0.4.22.dist-info/METADATA,sha256=bX0ATTSO7oM9laQrrha-tEityugKU2JbFcAm7m5AGA0,20142
+hud_python-0.4.22.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+hud_python-0.4.22.dist-info/entry_points.txt,sha256=jJbodNFg1m0-CDofe5AHvB4zKBq7sSdP97-ohaQ3ae4,63
+hud_python-0.4.22.dist-info/licenses/LICENSE,sha256=yIzBheVUf86FC1bztAcr7RYWWNxyd3B-UJQ3uddg1HA,1078
+hud_python-0.4.22.dist-info/RECORD,,