use-computer 0.0.30__tar.gz → 0.0.32__tar.gz

{use_computer-0.0.30 → use_computer-0.0.32}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: use-computer
-Version: 0.0.30
+Version: 0.0.32
 Summary: Python SDK for use.computer sandboxes across macOS, iOS simulators, Windows, and Ubuntu
 Project-URL: Homepage, https://use.computer
 Project-URL: Documentation, https://api.use.computer/docs
@@ -19,25 +19,11 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27
 Provides-Extra: agents
+Requires-Dist: anthropic>=0.86; extra == 'agents'
+Requires-Dist: google-genai>=1; extra == 'agents'
+Requires-Dist: litellm>=1; extra == 'agents'
+Requires-Dist: openai>=1; extra == 'agents'
 Requires-Dist: pillow>=10; extra == 'agents'
-Provides-Extra: agents-all
-Requires-Dist: anthropic>=0.86; extra == 'agents-all'
-Requires-Dist: google-genai>=1; extra == 'agents-all'
-Requires-Dist: litellm>=1; extra == 'agents-all'
-Requires-Dist: openai>=1; extra == 'agents-all'
-Requires-Dist: pillow>=10; extra == 'agents-all'
-Provides-Extra: agents-anthropic
-Requires-Dist: anthropic>=0.86; extra == 'agents-anthropic'
-Requires-Dist: pillow>=10; extra == 'agents-anthropic'
-Provides-Extra: agents-gemini
-Requires-Dist: google-genai>=1; extra == 'agents-gemini'
-Requires-Dist: pillow>=10; extra == 'agents-gemini'
-Provides-Extra: agents-litellm
-Requires-Dist: litellm>=1; extra == 'agents-litellm'
-Requires-Dist: pillow>=10; extra == 'agents-litellm'
-Provides-Extra: agents-openai
-Requires-Dist: openai>=1; extra == 'agents-openai'
-Requires-Dist: pillow>=10; extra == 'agents-openai'
 Provides-Extra: harbor
 Requires-Dist: harbor>=0.4.0; (python_version >= '3.12') and extra == 'harbor'
 Requires-Dist: pyyaml>=6; extra == 'harbor'
@@ -56,15 +42,14 @@ export USE_COMPUTER_API_KEY=mk_live_...
 Optional agent and Harbor integrations are installed explicitly:
 
 ```bash
-pip install "use-computer[agents]"            # shared agent helpers + debug agent
-pip install "use-computer[agents-openai]"     # or agents-anthropic / agents-gemini / agents-litellm / agents-all
-pip install "use-computer[harbor]"            # Harbor environment adapter (Python 3.12+)
-pip install "use-computer[harbor,agents-all]" # Harbor adapter plus all provider deps
+pip install "use-computer[agents]"        # computer-use agents and provider SDKs
+pip install "use-computer[harbor]"        # Harbor environment adapter (Python 3.12+)
+pip install "use-computer[harbor,agents]" # Harbor adapter plus agents
 ```
 
-Base installs only the SDK client and `httpx`. The `agents-*` extras install
-model-provider dependencies; `harbor` installs Harbor plus the environment
-adapter dependencies, but no provider SDKs.
+Base installs only the SDK client and `httpx`. The `agents` extra installs the
+agent runtime plus model-provider dependencies; `harbor` installs Harbor plus
+the environment adapter dependencies.
 
 ```python
 from use_computer.agents import AnthropicComputerAgent

{use_computer-0.0.30 → use_computer-0.0.32}/README.md

@@ -10,15 +10,14 @@ export USE_COMPUTER_API_KEY=mk_live_...
 Optional agent and Harbor integrations are installed explicitly:
 
 ```bash
-pip install "use-computer[agents]"            # shared agent helpers + debug agent
-pip install "use-computer[agents-openai]"     # or agents-anthropic / agents-gemini / agents-litellm / agents-all
-pip install "use-computer[harbor]"            # Harbor environment adapter (Python 3.12+)
-pip install "use-computer[harbor,agents-all]" # Harbor adapter plus all provider deps
+pip install "use-computer[agents]"        # computer-use agents and provider SDKs
+pip install "use-computer[harbor]"        # Harbor environment adapter (Python 3.12+)
+pip install "use-computer[harbor,agents]" # Harbor adapter plus agents
 ```
 
-Base installs only the SDK client and `httpx`. The `agents-*` extras install
-model-provider dependencies; `harbor` installs Harbor plus the environment
-adapter dependencies, but no provider SDKs.
+Base installs only the SDK client and `httpx`. The `agents` extra installs the
+agent runtime plus model-provider dependencies; `harbor` installs Harbor plus
+the environment adapter dependencies.
 
 ```python
 from use_computer.agents import AnthropicComputerAgent

{use_computer-0.0.30 → use_computer-0.0.32}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "use-computer"
-version = "0.0.30"
+version = "0.0.32"
 description = "Python SDK for use.computer sandboxes across macOS, iOS simulators, Windows, and Ubuntu"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -24,12 +24,7 @@ classifiers = [
 ]
 
 [project.optional-dependencies]
-agents = ["Pillow>=10"]
-agents-openai = ["Pillow>=10", "openai>=1"]
-agents-anthropic = ["Pillow>=10", "anthropic>=0.86"]
-agents-litellm = ["Pillow>=10", "litellm>=1"]
-agents-gemini = ["Pillow>=10", "google-genai>=1"]
-agents-all = [
+agents = [
     "Pillow>=10",
     "openai>=1",
     "anthropic>=0.86",

{use_computer-0.0.30 → use_computer-0.0.32}/scripts/smoke_wheel.py

@@ -25,12 +25,89 @@ for name in ["PIL", "openai", "anthropic", "google.genai", "litellm", "harbor",
 """
 
 AGENTS_SMOKE = r"""
+import asyncio
 import importlib
 import importlib.util
+import tempfile
+from pathlib import Path
 
 assert importlib.util.find_spec("PIL") is not None
+for name in ["openai", "anthropic", "google.genai", "litellm"]:
+    assert importlib.util.find_spec(name) is not None, name
 for path in ["use_computer.agents", "use_computer.agents.debug"]:
     importlib.import_module(path)
+
+from use_computer.agents import (
+    AnthropicComputerAgent,
+    GeminiComputerAgent,
+    GenericComputerAgent,
+    IOSComputerAgent,
+    OpenAIComputerAgent,
+)
+from use_computer.agents.debug import DebugComputerAgent
+from use_computer.models import ExecResult
+
+PNG_BYTES = (
+    b"\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x01\x00\x00\x00\x01"
+    b"\x08\x02\x00\x00\x00\x90wS\xde\x00\x00\x00\x0cIDAT\x08\xd7c\xf8\xff"
+    b"\xff?\x00\x05\xfe\x02\xfeA\xe2`\\\x00\x00\x00\x00IEND\xaeB`\x82"
+)
+
+class Recording:
+    async def start(self, name="trial"):
+        raise RuntimeError("recording disabled")
+
+class Screenshot:
+    async def take_full_screen(self):
+        return PNG_BYTES
+
+class Display:
+    async def get_windows(self):
+        return [{"role": "window", "title": "Fake"}]
+
+class Mouse:
+    def __init__(self):
+        self.clicks = []
+
+    async def click(self, x, y, button="left", double=False):
+        self.clicks.append((x, y, button, double))
+
+class Sandbox:
+    def __init__(self):
+        self.sandbox_id = "fake"
+        self.screenshot = Screenshot()
+        self.recording = Recording()
+        self.display = Display()
+        self.mouse = Mouse()
+        self.commands = []
+
+    async def exec_ssh(self, command, timeout=120):
+        self.commands.append(command)
+        return ExecResult(return_code=0, stdout="ok", stderr="")
+
+with tempfile.TemporaryDirectory() as tmp:
+    root = Path(tmp)
+    sandbox = Sandbox()
+    result = asyncio.run(
+        DebugComputerAgent(max_steps=1).run(
+            "smoke",
+            sandbox=sandbox,
+            logs_dir=root / "agent",
+            task_dir=root / "task",
+        )
+    )
+    assert sandbox.mouse.clicks == [(960, 540, "left", False)]
+    assert sandbox.commands == ["echo hello world"]
+    assert result.final_message == "smoke"
+
+for agent_cls, model_name in [
+    (AnthropicComputerAgent, "anthropic/claude-sonnet-4-6"),
+    (OpenAIComputerAgent, "openai/computer-use-preview"),
+    (GeminiComputerAgent, "gemini/gemini-2.5-computer-use-preview-10-2025"),
+    (GenericComputerAgent, "openai/gpt-4o"),
+    (IOSComputerAgent, "anthropic/claude-sonnet-4-6"),
+]:
+    assert agent_cls(model_name=model_name, max_steps=1).max_steps == 1
 """
 
 HARBOR_SMOKE = r"""
@@ -39,6 +116,13 @@ import importlib.util
 
 for name in ["harbor", "yaml", "tomli"]:
     assert importlib.util.find_spec(name) is not None, name
+for path in ["use_computer.harbor", "use_computer.harbor.environment"]:
+    importlib.import_module(path)
+"""
+
+HARBOR_AGENTS_SMOKE = r"""
+import importlib
+
 for path in ["use_computer.harbor.environment", "use_computer.harbor.agents"]:
     importlib.import_module(path)
 """
@@ -58,6 +142,7 @@ def main() -> None:
     _smoke_install(wheel, None, BASE_SMOKE)
     _smoke_install(wheel, "agents", AGENTS_SMOKE)
     _smoke_install(wheel, "harbor", HARBOR_SMOKE)
+    _smoke_install(wheel, "harbor,agents", HARBOR_AGENTS_SMOKE)
 
 
 def _check_wheel_contents(wheel: Path) -> None:
@@ -92,18 +177,25 @@ def _check_metadata(wheel: Path) -> None:
 
     required = [
         "Provides-Extra: agents",
-        "Provides-Extra: agents-openai",
-        "Provides-Extra: agents-anthropic",
-        "Provides-Extra: agents-litellm",
-        "Provides-Extra: agents-gemini",
-        "Provides-Extra: agents-all",
         "Provides-Extra: harbor",
         "Requires-Dist: pillow>=10; extra == 'agents'",
+        "Requires-Dist: openai>=1; extra == 'agents'",
+        "Requires-Dist: anthropic>=0.86; extra == 'agents'",
+        "Requires-Dist: litellm>=1; extra == 'agents'",
+        "Requires-Dist: google-genai>=1; extra == 'agents'",
     ]
     missing = [line for line in required if line not in metadata]
     if missing:
         raise SystemExit(f"wheel metadata is missing: {missing}")
 
+    forbidden = [
+        f"Provides-Extra: agents-{name}"
+        for name in ("openai", "anthropic", "litellm", "gemini", "all")
+    ]
+    present = [line for line in forbidden if line in metadata]
+    if present:
+        raise SystemExit(f"wheel metadata still has provider-specific extras: {present}")
+
     harbor_lines = [
         line for line in metadata.splitlines() if line.startswith("Requires-Dist: harbor>=0.4.0;")
     ]
@@ -112,6 +204,18 @@ def _check_metadata(wheel: Path) -> None:
     ):
         raise SystemExit("wheel metadata is missing the Python 3.12+ Harbor extra")
 
+    forbidden_harbor_deps = [
+        line
+        for line in metadata.splitlines()
+        if "extra == 'harbor'" in line
+        and any(
+            f"Requires-Dist: {name}" in line
+            for name in ("pillow", "openai", "anthropic", "litellm", "google-genai")
+        )
+    ]
+    if forbidden_harbor_deps:
+        raise SystemExit(f"harbor extra should not install agent deps: {forbidden_harbor_deps}")
+
 
 def _smoke_install(wheel: Path, extra: str | None, code: str) -> None:
     with tempfile.TemporaryDirectory(prefix="use-computer-wheel-") as tmp:

{use_computer-0.0.30 → use_computer-0.0.32}/use_computer/agents/__init__.py

@@ -1,9 +1,6 @@
 """Optional computer-use agents.
 
-Install extras for provider-backed agents:
-    use-computer[agents-openai], use-computer[agents-anthropic],
-    use-computer[agents-litellm], use-computer[agents-gemini], or
-    use-computer[agents-all].
+Install provider-backed agents with `use-computer[agents]`.
 """
 
 from __future__ import annotations
@@ -48,10 +45,7 @@ def __getattr__(name: str) -> Any:
         module = import_module(module_name)
     except ModuleNotFoundError as exc:
         raise ModuleNotFoundError(
-            f"{name} requires an optional agent extra. Install one of "
-            "`use-computer[agents]`, `use-computer[agents-openai]`, "
-            "`use-computer[agents-anthropic]`, `use-computer[agents-litellm]`, "
-            "`use-computer[agents-gemini]`, or `use-computer[agents-all]`."
+            f"{name} requires optional agent dependencies. Install `use-computer[agents]`."
         ) from exc
     value = getattr(module, attr)
     globals()[name] = value

{use_computer-0.0.30 → use_computer-0.0.32}/use_computer/agents/debug/README.md

@@ -6,5 +6,5 @@
 - `realistic: true` emits deterministic screenshot/action/exec traffic.
 - Default mode takes a screenshot, performs one simple action, and runs one exec.
 
-Direct SDK import path: `use_computer.agents.debug:DebugCUAAgent`.
+Direct SDK import path: `use_computer.agents.debug:DebugComputerAgent`.
 Harbor wrapper import path: `use_computer.harbor.agents:DebugCUAAgent`.

use_computer-0.0.32/use_computer/agents/debug/__init__.py

@@ -0,0 +1,5 @@
+"""Debug agent package."""
+
+from use_computer.agents.debug.agent import DebugComputerAgent, DebugCUAAgent
+
+__all__ = ["DebugComputerAgent", "DebugCUAAgent"]

{use_computer-0.0.30 → use_computer-0.0.32}/use_computer/agents/debug/agent.py

@@ -70,6 +70,7 @@ class DebugCUAAgent(BaseCUAAgent):
         context: Any,
     ) -> None:
         sandbox = await self.pre_run(environment)
+        self.steps[0]["message"] = instruction
 
         if self.replay:
             await self._run_replay(sandbox)

{use_computer-0.0.30 → use_computer-0.0.32}/use_computer/harbor/agents.py

@@ -32,7 +32,13 @@ class _HarborAgent(BaseAgent):
             mcp_servers=mcp_servers,
             skills_dir=skills_dir,
         )
-        cls = getattr(import_module(self.agent_module), self.agent_name)
+        try:
+            cls = getattr(import_module(self.agent_module), self.agent_name)
+        except ModuleNotFoundError as exc:
+            raise ModuleNotFoundError(
+                f"{type(self).__name__} requires agent dependencies. "
+                "Install `use-computer[harbor,agents]`."
+            ) from exc
         self._agent = cls(
             logs_dir=logs_dir,
             model_name=model_name,

{use_computer-0.0.30 → use_computer-0.0.32}/uv.lock

@@ -4769,28 +4769,9 @@ dependencies = [
 
 [package.optional-dependencies]
 agents = [
-    { name = "pillow" },
-]
-agents-all = [
-    { name = "anthropic" },
-    { name = "google-genai" },
-    { name = "litellm" },
-    { name = "openai" },
-    { name = "pillow" },
-]
-agents-anthropic = [
     { name = "anthropic" },
-    { name = "pillow" },
-]
-agents-gemini = [
     { name = "google-genai" },
-    { name = "pillow" },
-]
-agents-litellm = [
     { name = "litellm" },
-    { name = "pillow" },
-]
-agents-openai = [
     { name = "openai" },
     { name = "pillow" },
 ]
@@ -4819,26 +4800,17 @@ dev = [
 
 [package.metadata]
 requires-dist = [
-    { name = "anthropic", marker = "extra == 'agents-all'", specifier = ">=0.86" },
-    { name = "anthropic", marker = "extra == 'agents-anthropic'", specifier = ">=0.86" },
-    { name = "google-genai", marker = "extra == 'agents-all'", specifier = ">=1" },
-    { name = "google-genai", marker = "extra == 'agents-gemini'", specifier = ">=1" },
+    { name = "anthropic", marker = "extra == 'agents'", specifier = ">=0.86" },
+    { name = "google-genai", marker = "extra == 'agents'", specifier = ">=1" },
     { name = "harbor", marker = "python_full_version >= '3.12' and extra == 'harbor'", specifier = ">=0.4.0" },
     { name = "httpx", specifier = ">=0.27" },
-    { name = "litellm", marker = "extra == 'agents-all'", specifier = ">=1" },
-    { name = "litellm", marker = "extra == 'agents-litellm'", specifier = ">=1" },
-    { name = "openai", marker = "extra == 'agents-all'", specifier = ">=1" },
-    { name = "openai", marker = "extra == 'agents-openai'", specifier = ">=1" },
+    { name = "litellm", marker = "extra == 'agents'", specifier = ">=1" },
+    { name = "openai", marker = "extra == 'agents'", specifier = ">=1" },
     { name = "pillow", marker = "extra == 'agents'", specifier = ">=10" },
-    { name = "pillow", marker = "extra == 'agents-all'", specifier = ">=10" },
-    { name = "pillow", marker = "extra == 'agents-anthropic'", specifier = ">=10" },
-    { name = "pillow", marker = "extra == 'agents-gemini'", specifier = ">=10" },
-    { name = "pillow", marker = "extra == 'agents-litellm'", specifier = ">=10" },
-    { name = "pillow", marker = "extra == 'agents-openai'", specifier = ">=10" },
     { name = "pyyaml", marker = "extra == 'harbor'", specifier = ">=6" },
     { name = "tomli", marker = "extra == 'harbor'", specifier = ">=2" },
 ]
-provides-extras = ["agents", "agents-openai", "agents-anthropic", "agents-litellm", "agents-gemini", "agents-all", "harbor"]
+provides-extras = ["agents", "harbor"]
 
 [package.metadata.requires-dev]
 dev = [

use_computer-0.0.30/use_computer/agents/debug/__init__.py

@@ -1,5 +0,0 @@
-"""Debug agent package."""
-
-from use_computer.agents.debug.agent import DebugCUAAgent
-
-__all__ = ["DebugCUAAgent"]