use-computer 0.0.26__tar.gz → 0.0.27__tar.gz

{use_computer-0.0.26 → use_computer-0.0.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: use-computer
-Version: 0.0.26
+Version: 0.0.27
 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
@@ -60,18 +60,62 @@ recording/file surface as macOS; exec runs in-guest via PowerShell/cmd
 (`win.run` / `win.shell`) instead of SSH. `AsyncWindowsSandbox` mirrors it.
 See [docs.use.computer/docs/windows](https://docs.use.computer/docs/windows).
 
+Selectable Windows images are exposed by `Computer().platforms()["windows"]`.
+Prefer `version="windows-11"` plus `resources={"cpus": 4, "memory_mb": 4096,
+"disk_gb": 40}` to select a resource profile. Explicit image IDs such as
+`windows-11-4c4g40g` still work. The image metadata includes CPU/RAM/disk and
+display size.
+
 ### Ubuntu (Beta)
 
 ```python
 with Computer().create(type="ubuntu", version="ubuntu-24.04") as ubuntu:
     print(ubuntu.run("uname -a").stdout)  # bash exec (no SSH)
+    print(ubuntu.display.get_info())
     ubuntu.keyboard.type("hello")
     ubuntu.screenshot.take_full_screen()
 ```
 
 Ubuntu sandboxes are **Beta** (admin-only). They use the same KVM/noVNC backend
-as Windows; pass `version="ubuntu-24.04"` to select a specific image. Exec
-defaults to bash and the macOS accessibility tree is not available yet.
+as Windows; pass `version="ubuntu-24.04"` plus `resources` to select CPU/RAM/disk.
+
+Selectable Ubuntu images are exposed by `Computer().platforms()["ubuntu"]`.
+Current examples include `ubuntu-24.04`, `ubuntu-24.04-4c4g80g`,
+`ubuntu-24.04-4c4g40g`, and `ubuntu-24.04-2c4g40g`.
+
+```python
+client = Computer()
+platforms = client.platforms()
+for image in platforms["ubuntu"]["images"]:
+    print(image["version"], image["resources"], image["display"])
+
+with client.create(
+    type="ubuntu",
+    version="ubuntu-24.04",
+    resources={"cpus": 2, "memory_mb": 4096, "disk_gb": 40},
+) as ubuntu:
+    print(ubuntu.display.get_info())
+```
+
+### Snapshots (Beta)
+
+Windows and Ubuntu snapshots preserve disk + RAM state, including open apps and
+running processes. Seed a VM once, snapshot it, then create new sandboxes from
+that snapshot version.
+
+```python
+client = Computer()
+
+with client.create(type="ubuntu", version="ubuntu-24.04") as ubuntu:
+    ubuntu.run("google-chrome-stable --no-first-run https://example.com >/tmp/chrome.log 2>&1 &")
+    snapshot = ubuntu.snapshot("chrome-seeded-ubuntu")
+
+with client.create(type="ubuntu", snapshot=snapshot.version) as seeded:
+    print(seeded.run("pgrep -af 'chrome|chromium' | head").stdout)
+```
+
+Use `client.snapshots("ubuntu")` or `client.snapshots("windows")` to list saved
+snapshot versions.
 
 Full DSL reference: [docs.use.computer/docs/sdk](https://docs.use.computer/docs/sdk)
 
@@ -107,6 +151,8 @@ visionOS yet. Use it for read-only flows for now.
 | [`examples/_6_hello_tvos.py`](examples/_6_hello_tvos.py)       | tvOS: pick TV family + drive the Apple Remote  |
 | [`examples/_7_hello_windows.py`](examples/_7_hello_windows.py) | create Windows → run PowerShell → screenshot   |
 | [`examples/_8_hello_ubuntu.py`](examples/_8_hello_ubuntu.py)   | create Ubuntu → run bash → screenshot          |
+| [`examples/_9_seeding.py`](examples/_9_seeding.py)             | typed setup: files, hosts, open URLs/apps      |
+| [`examples/_10_snapshots.py`](examples/_10_snapshots.py)       | snapshot seeded Ubuntu/Windows desktop state   |
 
 For agent loops and evals: [use-computer-cookbook](https://github.com/josancamon19/use-computer-cookbook).
 

{use_computer-0.0.26 → use_computer-0.0.27}/README.md

@@ -38,18 +38,62 @@ recording/file surface as macOS; exec runs in-guest via PowerShell/cmd
 (`win.run` / `win.shell`) instead of SSH. `AsyncWindowsSandbox` mirrors it.
 See [docs.use.computer/docs/windows](https://docs.use.computer/docs/windows).
 
+Selectable Windows images are exposed by `Computer().platforms()["windows"]`.
+Prefer `version="windows-11"` plus `resources={"cpus": 4, "memory_mb": 4096,
+"disk_gb": 40}` to select a resource profile. Explicit image IDs such as
+`windows-11-4c4g40g` still work. The image metadata includes CPU/RAM/disk and
+display size.
+
 ### Ubuntu (Beta)
 
 ```python
 with Computer().create(type="ubuntu", version="ubuntu-24.04") as ubuntu:
     print(ubuntu.run("uname -a").stdout)  # bash exec (no SSH)
+    print(ubuntu.display.get_info())
     ubuntu.keyboard.type("hello")
     ubuntu.screenshot.take_full_screen()
 ```
 
 Ubuntu sandboxes are **Beta** (admin-only). They use the same KVM/noVNC backend
-as Windows; pass `version="ubuntu-24.04"` to select a specific image. Exec
-defaults to bash and the macOS accessibility tree is not available yet.
+as Windows; pass `version="ubuntu-24.04"` plus `resources` to select CPU/RAM/disk.
+
+Selectable Ubuntu images are exposed by `Computer().platforms()["ubuntu"]`.
+Current examples include `ubuntu-24.04`, `ubuntu-24.04-4c4g80g`,
+`ubuntu-24.04-4c4g40g`, and `ubuntu-24.04-2c4g40g`.
+
+```python
+client = Computer()
+platforms = client.platforms()
+for image in platforms["ubuntu"]["images"]:
+    print(image["version"], image["resources"], image["display"])
+
+with client.create(
+    type="ubuntu",
+    version="ubuntu-24.04",
+    resources={"cpus": 2, "memory_mb": 4096, "disk_gb": 40},
+) as ubuntu:
+    print(ubuntu.display.get_info())
+```
+
+### Snapshots (Beta)
+
+Windows and Ubuntu snapshots preserve disk + RAM state, including open apps and
+running processes. Seed a VM once, snapshot it, then create new sandboxes from
+that snapshot version.
+
+```python
+client = Computer()
+
+with client.create(type="ubuntu", version="ubuntu-24.04") as ubuntu:
+    ubuntu.run("google-chrome-stable --no-first-run https://example.com >/tmp/chrome.log 2>&1 &")
+    snapshot = ubuntu.snapshot("chrome-seeded-ubuntu")
+
+with client.create(type="ubuntu", snapshot=snapshot.version) as seeded:
+    print(seeded.run("pgrep -af 'chrome|chromium' | head").stdout)
+```
+
+Use `client.snapshots("ubuntu")` or `client.snapshots("windows")` to list saved
+snapshot versions.
 
 Full DSL reference: [docs.use.computer/docs/sdk](https://docs.use.computer/docs/sdk)
 
@@ -85,6 +129,8 @@ visionOS yet. Use it for read-only flows for now.
 | [`examples/_6_hello_tvos.py`](examples/_6_hello_tvos.py)       | tvOS: pick TV family + drive the Apple Remote  |
 | [`examples/_7_hello_windows.py`](examples/_7_hello_windows.py) | create Windows → run PowerShell → screenshot   |
 | [`examples/_8_hello_ubuntu.py`](examples/_8_hello_ubuntu.py)   | create Ubuntu → run bash → screenshot          |
+| [`examples/_9_seeding.py`](examples/_9_seeding.py)             | typed setup: files, hosts, open URLs/apps      |
+| [`examples/_10_snapshots.py`](examples/_10_snapshots.py)       | snapshot seeded Ubuntu/Windows desktop state   |
 
 For agent loops and evals: [use-computer-cookbook](https://github.com/josancamon19/use-computer-cookbook).
 

{use_computer-0.0.26 → use_computer-0.0.27}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "use-computer"
-version = "0.0.26"
+version = "0.0.27"
 description = "Python SDK for use.computer sandboxes across macOS, iOS simulators, Windows, and Ubuntu"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -48,9 +48,12 @@ exclude = [
     "/.venv",
     "/dist",
     "/results",
-    "/use_computer/test_*.py",
+    "/tests",
 ]
 
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
 [tool.ruff]
 target-version = "py310"
 line-length = 100

use_computer-0.0.27/use_computer/accessibility.py

@@ -0,0 +1,3 @@
+from use_computer.resources.accessibility import Accessibility, AsyncAccessibility
+
+__all__ = ["Accessibility", "AsyncAccessibility"]

{use_computer-0.0.26 → use_computer-0.0.27}/use_computer/client.py

@@ -41,6 +41,12 @@ def _resolve_base_url(base_url: str | None) -> str:
     return (base_url or os.getenv("USE_COMPUTER_BASE_URL") or DEFAULT_BASE_URL).rstrip("/")
 
 
+def _absolute_url(base_url: str, value: str) -> str:
+    if not value or value.startswith(("http://", "https://")):
+        return value
+    return f"{base_url}{'' if value.startswith('/') else '/'}{value}"
+
+
 def _normalize_sandbox_type(type: SandboxTypeInput) -> SandboxType:
     if isinstance(type, SandboxType):
         return type
@@ -146,6 +152,7 @@ class Computer:
         type: Literal["windows", SandboxType.WINDOWS],
         version: str = ...,
         snapshot: str = ...,
+        resources: dict[str, int] | None = ...,
         host: str = ...,
     ) -> WindowsSandbox: ...
 
@@ -156,6 +163,7 @@ class Computer:
         type: Literal["ubuntu", SandboxType.UBUNTU],
         version: str = ...,
         snapshot: str = ...,
+        resources: dict[str, int] | None = ...,
         host: str = ...,
     ) -> UbuntuSandbox: ...
 
@@ -169,6 +177,7 @@ class Computer:
         runtime: str = "",
         version: str = "",
         snapshot: str = "",
+        resources: dict[str, int] | None = None,
     ) -> MacOSSandbox | IOSSandbox | WindowsSandbox | UbuntuSandbox:
         """Create a new sandbox.
 
@@ -181,6 +190,8 @@ class Computer:
             version: KVM desktop image version, for example "windows-11",
                 "windows-10", or "ubuntu-24.04".
             snapshot: Windur snapshot version returned by sandbox.snapshot().
+            resources: KVM CPU/RAM/disk request used to select the baked image
+                profile, for example {"cpus": 4, "memory_mb": 4096, "disk_gb": 40}.
         """
         sandbox_type = _normalize_sandbox_type(type)
         body: dict = {"type": sandbox_type.value}
@@ -193,6 +204,8 @@ class Computer:
                 body["snapshot"] = snapshot
             elif version:
                 body["version"] = version
+            if resources:
+                body["resources"] = resources
         if sandbox_type == SandboxType.IOS:
             if family and (not device_type or not runtime):
                 choice = select_simulator(self.platforms(), family)
@@ -214,7 +227,7 @@ class Computer:
             return WindowsSandbox(
                 sandbox_id=sid,
                 http=self._http,
-                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
                 host=data.get("host", ""),
                 version=data.get("version", ""),
             )
@@ -222,17 +235,17 @@ class Computer:
             return UbuntuSandbox(
                 sandbox_id=sid,
                 http=self._http,
-                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
                 host=data.get("host", ""),
                 version=data.get("version", ""),
             )
         return MacOSSandbox(
             sandbox_id=sid,
             http=self._http,
-            vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+            vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
             vm_ip=data.get("vm_ip", ""),
             host=data.get("host", ""),
-            ssh_url=f"{self._base_url}{data.get('ssh_url', '')}",
+            ssh_url=_absolute_url(self._base_url, data.get("ssh_url", "")),
         )
 
     def get(self, sandbox_id: str) -> Sandbox:
@@ -247,7 +260,7 @@ class Computer:
             return WindowsSandbox(
                 sandbox_id=data["sandbox_id"],
                 http=self._http,
-                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
                 host=data.get("host", ""),
                 version=data.get("version", ""),
             )
@@ -255,15 +268,15 @@ class Computer:
             return UbuntuSandbox(
                 sandbox_id=data["sandbox_id"],
                 http=self._http,
-                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
                 host=data.get("host", ""),
                 version=data.get("version", ""),
             )
         return MacOSSandbox(
             sandbox_id=data["sandbox_id"],
             http=self._http,
-            vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
-            ssh_url=f"{self._base_url}{data.get('ssh_url', '')}",
+            vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
+            ssh_url=_absolute_url(self._base_url, data.get("ssh_url", "")),
         )
 
     def adhoc_run(
@@ -281,7 +294,7 @@ class Computer:
 
         Args:
             instruction: What the agent should do.
-            platform: "macos" or "ios".
+            platform: "macos", "ios", "windows", or "ubuntu".
             model: Model to use.
             max_steps: Max agent steps.
             files: Optional list of {remote_path, content_b64} to pre-upload.
@@ -381,6 +394,7 @@ class AsyncComputer:
         type: Literal["windows", SandboxType.WINDOWS],
         version: str = ...,
         snapshot: str = ...,
+        resources: dict[str, int] | None = ...,
         host: str = ...,
     ) -> AsyncWindowsSandbox: ...
 
@@ -391,6 +405,7 @@ class AsyncComputer:
         type: Literal["ubuntu", SandboxType.UBUNTU],
         version: str = ...,
         snapshot: str = ...,
+        resources: dict[str, int] | None = ...,
         host: str = ...,
     ) -> AsyncUbuntuSandbox: ...
 
@@ -404,6 +419,7 @@ class AsyncComputer:
         runtime: str = "",
         version: str = "",
         snapshot: str = "",
+        resources: dict[str, int] | None = None,
     ) -> AsyncMacOSSandbox | AsyncIOSSandbox | AsyncWindowsSandbox | AsyncUbuntuSandbox:
         """Create a new sandbox.
 
@@ -416,6 +432,8 @@ class AsyncComputer:
             version: KVM desktop image version, for example "windows-11",
                 "windows-10", or "ubuntu-24.04".
             snapshot: Windur snapshot version returned by sandbox.snapshot().
+            resources: KVM CPU/RAM/disk request used to select the baked image
+                profile, for example {"cpus": 4, "memory_mb": 4096, "disk_gb": 40}.
         """
         sandbox_type = _normalize_sandbox_type(type)
         body: dict = {"type": sandbox_type.value}
@@ -428,6 +446,8 @@ class AsyncComputer:
                 body["snapshot"] = snapshot
             elif version:
                 body["version"] = version
+            if resources:
+                body["resources"] = resources
         if sandbox_type == SandboxType.IOS:
             if family and (not device_type or not runtime):
                 choice = select_simulator(await self.platforms(), family)
@@ -449,7 +469,7 @@ class AsyncComputer:
             return AsyncWindowsSandbox(
                 sandbox_id=sid,
                 http=self._http,
-                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
                 host=data.get("host", ""),
                 version=data.get("version", ""),
             )
@@ -457,15 +477,15 @@ class AsyncComputer:
             return AsyncUbuntuSandbox(
                 sandbox_id=sid,
                 http=self._http,
-                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
                 host=data.get("host", ""),
                 version=data.get("version", ""),
             )
         return AsyncMacOSSandbox(
             sandbox_id=sid,
             http=self._http,
-            vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
-            ssh_url=f"{self._base_url}{data.get('ssh_url', '')}",
+            vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
+            ssh_url=_absolute_url(self._base_url, data.get("ssh_url", "")),
             vm_ip=data.get("vm_ip", ""),
             host=data.get("host", ""),
         )
@@ -482,7 +502,7 @@ class AsyncComputer:
             return AsyncWindowsSandbox(
                 sandbox_id=data["sandbox_id"],
                 http=self._http,
-                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
                 host=data.get("host", ""),
                 version=data.get("version", ""),
             )
@@ -490,15 +510,15 @@ class AsyncComputer:
             return AsyncUbuntuSandbox(
                 sandbox_id=data["sandbox_id"],
                 http=self._http,
-                vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
                 host=data.get("host", ""),
                 version=data.get("version", ""),
             )
         return AsyncMacOSSandbox(
             sandbox_id=data["sandbox_id"],
             http=self._http,
-            vnc_url=f"{self._base_url}{data.get('vnc_url', '')}",
-            ssh_url=f"{self._base_url}{data.get('ssh_url', '')}",
+            vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
+            ssh_url=_absolute_url(self._base_url, data.get("ssh_url", "")),
         )
 
     async def adhoc_run(

use_computer-0.0.27/use_computer/display.py

@@ -0,0 +1,3 @@
+from use_computer.resources.display import AsyncDisplay, Display
+
+__all__ = ["AsyncDisplay", "Display"]

use_computer-0.0.27/use_computer/recording.py

@@ -0,0 +1,3 @@
+from use_computer.resources.recording import AsyncRecording, Recording
+
+__all__ = ["AsyncRecording", "Recording"]

use_computer-0.0.27/use_computer/resources/__init__.py

@@ -0,0 +1,17 @@
+"""Shared sandbox resource clients."""
+
+from use_computer.resources.accessibility import Accessibility, AsyncAccessibility
+from use_computer.resources.display import AsyncDisplay, Display
+from use_computer.resources.recording import AsyncRecording, Recording
+from use_computer.resources.screenshot import AsyncScreenshot, Screenshot
+
+__all__ = [
+    "Accessibility",
+    "AsyncAccessibility",
+    "AsyncDisplay",
+    "AsyncRecording",
+    "AsyncScreenshot",
+    "Display",
+    "Recording",
+    "Screenshot",
+]

{use_computer-0.0.26 → use_computer-0.0.27}/use_computer/sandbox.py

@@ -11,8 +11,6 @@ from pathlib import Path
 
 import httpx
 
-from use_computer.accessibility import Accessibility, AsyncAccessibility
-from use_computer.display import AsyncDisplay, Display
 from use_computer.errors import PlatformNotSupportedError
 from use_computer.ios.apps import Apps, AsyncApps
 from use_computer.ios.environment import AsyncEnvironment, Environment
@@ -20,8 +18,16 @@ from use_computer.ios.input import AsyncInput, Input
 from use_computer.macos.keyboard import AsyncKeyboard, Keyboard
 from use_computer.macos.mouse import AsyncMouse, Mouse
 from use_computer.models import ActResult, ExecResult
-from use_computer.recording import AsyncRecording, Recording
-from use_computer.screenshot import AsyncScreenshot, Screenshot
+from use_computer.resources import (
+    Accessibility,
+    AsyncAccessibility,
+    AsyncDisplay,
+    AsyncRecording,
+    AsyncScreenshot,
+    Display,
+    Recording,
+    Screenshot,
+)
 from use_computer.windows.shell import AsyncShell, Shell, ShellKind
 
 

use_computer-0.0.27/use_computer/screenshot.py

@@ -0,0 +1,3 @@
+from use_computer.resources.screenshot import AsyncScreenshot, Screenshot
+
+__all__ = ["AsyncScreenshot", "Screenshot"]

{use_computer-0.0.26 → use_computer-0.0.27}/use_computer/tasks/__init__.py

@@ -87,8 +87,13 @@ class TasksClient:
     def __init__(self, http: httpx.Client):
         self._http = http
 
-    def list(self, limit: int = 50, offset: int = 0) -> builtins.list[TaskSummary]:
-        resp = self._http.get("/admin/tasks", params={"limit": limit, "offset": offset})
+    def list(
+        self, limit: int = 50, offset: int = 0, platform: str | None = None
+    ) -> builtins.list[TaskSummary]:
+        params: dict[str, int | str] = {"limit": limit, "offset": offset}
+        if platform:
+            params["platform"] = platform
+        resp = self._http.get("/admin/tasks", params=params)
         resp.raise_for_status()
         return [
             TaskSummary(
@@ -149,9 +154,13 @@ class TasksClient:
 
 
 def _build_test_sh(task: Task) -> str:
-    """iOS = JSON checker DSL POSTed to /grade. macOS = bash with perl-alarm wrap."""
+    """Build verifier script for the task's platform."""
     if task.platform == "ios":
         return _build_test_sh_ios(task)
+    if task.platform == "windows":
+        return _build_test_sh_windows(task)
+    if task.platform == "ubuntu":
+        return _build_test_sh_ubuntu(task)
     return _build_test_sh_macos(task)
 
 
@@ -175,6 +184,24 @@ def _build_test_sh_macos(task: Task) -> str:
     return out
 
 
+def _build_test_sh_windows(task: Task) -> str:
+    grader = (task.grader or "").strip()
+    if not grader:
+        return _tpl("test_windows_nograder.sh")
+    check_tpl = _tpl("test_windows_check.sh")
+    checks = _render(check_tpl, N="1", CMD=grader.replace("'", "'\\''"))
+    return _render(_tpl("test_windows.sh"), CHECKS=checks)
+
+
+def _build_test_sh_ubuntu(task: Task) -> str:
+    grader = (task.grader or "").strip()
+    if not grader:
+        return _tpl("test_ubuntu_nograder.sh")
+    check_tpl = _tpl("test_ubuntu_check.sh")
+    checks = _render(check_tpl, N="1", CMD=grader.replace("'", "'\\''"))
+    return _render(_tpl("test_ubuntu.sh"), CHECKS=checks)
+
+
 def _build_pre_command_sh(task: Task) -> str | None:
     # `defaults delete` fails on fresh VMs (key never set). Tasks recording such
     # commands likely rely on the cleanup; skip the whole task instead of
@@ -189,6 +216,19 @@ def _build_pre_command_sh(task: Task) -> str | None:
     return _render(_tpl("pre_command.sh"), COMMANDS="\n".join(task.setup_commands))
 
 
+def _build_pre_command(task: Task) -> tuple[str, str] | None:
+    if task.platform == "windows":
+        if not task.setup_commands:
+            return None
+        return "pre_command.ps1", _render(
+            _tpl("pre_command.ps1"), COMMANDS="\n".join(task.setup_commands)
+        )
+    pre = _build_pre_command_sh(task)
+    if not pre:
+        return None
+    return "pre_command.sh", pre
+
+
 def task_to_harbor(
     task: Task,
     output_root: Path,
@@ -206,7 +246,7 @@ def task_to_harbor(
             tests/
                 test.sh
                 setup/
-                    pre_command.sh
+                    pre_command.sh | pre_command.ps1
                     files/
                         manifest.json
                         <local_name>...
@@ -225,7 +265,7 @@ def task_to_harbor(
 
     # Build pre_command early so we fail before creating any dirs if all setup
     # commands got stripped (raises ValueError).
-    pre_cmd = _build_pre_command_sh(task)
+    pre_cmd = _build_pre_command(task)
 
     if task_dir.exists():
         shutil.rmtree(task_dir)
@@ -277,13 +317,15 @@ def task_to_harbor(
         json.dumps({"steps": actions}, indent=2) + "\n", encoding="utf-8"
     )
 
-    # tests/setup/pre_command.sh — skip directory entirely if no setup commands
+    # tests/setup/pre_command.* — skip directory entirely if no setup commands
     setup_dir = tests_dir / "setup"
     if pre_cmd:
+        pre_cmd_name, pre_cmd_text = pre_cmd
         setup_dir.mkdir(exist_ok=True)
-        pre_cmd_path = setup_dir / "pre_command.sh"
-        pre_cmd_path.write_text(pre_cmd, encoding="utf-8")
-        pre_cmd_path.chmod(0o755)
+        pre_cmd_path = setup_dir / pre_cmd_name
+        pre_cmd_path.write_text(pre_cmd_text, encoding="utf-8")
+        if pre_cmd_name.endswith(".sh"):
+            pre_cmd_path.chmod(0o755)
 
     # tests/setup/files/<local_name> + manifest.json — files captured at
     # collect time. The runner's setup.py reads manifest.json and uploads
@@ -315,7 +357,10 @@ def task_to_harbor(
                     logger.warning("collected file missing on gateway: %s", local_name)
                     continue
                 (files_dir / local_name).write_bytes(data)
-                manifest.append({"remote_path": remote_path, "local_name": local_name})
+                entry = {"remote_path": remote_path, "local_name": local_name}
+                if task.platform in ("windows", "ubuntu"):
+                    entry["vm_path"] = remote_path
+                manifest.append(entry)
                 logger.info("exported file %s → %s (%dB)", local_name, remote_path, len(data))
             if manifest:
                 (files_dir / "manifest.json").write_text(

use_computer-0.0.27/use_computer/tasks/templates/pre_command.ps1

@@ -0,0 +1 @@
+{{COMMANDS}}

use_computer-0.0.27/use_computer/tasks/templates/test_ubuntu.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# Ubuntu test.sh runs on the runner host. Use the gateway SDK/API to inspect
+# the live sandbox; bash state setup runs separately in pre_command.sh.
+REWARD="${HARBOR_REWARD_FILE:-/logs/verifier/reward.txt}"
+GRADER_LOG="${HARBOR_GRADER_LOG:-/logs/verifier/grader.log}"
+: "${GATEWAY_URL:?GATEWAY_URL is required}"
+: "${SANDBOX_ID:?SANDBOX_ID is required}"
+: "${USE_COMPUTER_API_KEY:?USE_COMPUTER_API_KEY is required}"
+export MMINI_API_KEY="${MMINI_API_KEY:-$USE_COMPUTER_API_KEY}"
+mkdir -p "$(dirname "$GRADER_LOG")" 2>/dev/null || true
+
+write_reward() {
+  mkdir -p "$(dirname "$REWARD")" 2>/dev/null || true
+  echo "$1" > "$REWARD" 2>/dev/null || true
+  echo "REWARD=$1"
+}
+
+{{CHECKS}}
+write_reward 0
+echo "Score: 0"

use_computer-0.0.27/use_computer/tasks/templates/test_ubuntu_check.sh

@@ -0,0 +1,10 @@
+# Check {{N}}
+_r=$(mktemp)
+bash -c '{{CMD}}' > "$_r" 2>>"$GRADER_LOG"
+if grep -qi "true" "$_r" 2>/dev/null; then
+  rm -f "$_r"
+  write_reward 1
+  echo "Score: 1"
+  exit 0
+fi
+rm -f "$_r"

use_computer-0.0.27/use_computer/tasks/templates/test_ubuntu_nograder.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+REWARD="${HARBOR_REWARD_FILE:-/logs/verifier/reward.txt}"
+mkdir -p "$(dirname "$REWARD")" 2>/dev/null || true
+echo "0" > "$REWARD" 2>/dev/null || true
+echo "REWARD=0"
+echo "Score: 0 (no grader)"

use_computer-0.0.27/use_computer/tasks/templates/test_windows.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# Windows test.sh runs on the runner host. Use the gateway SDK/API to inspect
+# the live sandbox; PowerShell state setup runs separately in pre_command.ps1.
+REWARD="${HARBOR_REWARD_FILE:-/logs/verifier/reward.txt}"
+GRADER_LOG="${HARBOR_GRADER_LOG:-/logs/verifier/grader.log}"
+: "${GATEWAY_URL:?GATEWAY_URL is required}"
+: "${SANDBOX_ID:?SANDBOX_ID is required}"
+: "${USE_COMPUTER_API_KEY:?USE_COMPUTER_API_KEY is required}"
+export MMINI_API_KEY="${MMINI_API_KEY:-$USE_COMPUTER_API_KEY}"
+mkdir -p "$(dirname "$GRADER_LOG")" 2>/dev/null || true
+
+write_reward() {
+  mkdir -p "$(dirname "$REWARD")" 2>/dev/null || true
+  echo "$1" > "$REWARD" 2>/dev/null || true
+  echo "REWARD=$1"
+}
+
+{{CHECKS}}
+write_reward 0
+echo "Score: 0"

use_computer-0.0.27/use_computer/tasks/templates/test_windows_check.sh

@@ -0,0 +1,10 @@
+# Check {{N}}
+_r=$(mktemp)
+bash -c '{{CMD}}' > "$_r" 2>>"$GRADER_LOG"
+if grep -qi "true" "$_r" 2>/dev/null; then
+  rm -f "$_r"
+  write_reward 1
+  echo "Score: 1"
+  exit 0
+fi
+rm -f "$_r"

use_computer-0.0.27/use_computer/tasks/templates/test_windows_nograder.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+REWARD="${HARBOR_REWARD_FILE:-/logs/verifier/reward.txt}"
+mkdir -p "$(dirname "$REWARD")" 2>/dev/null || true
+echo "0" > "$REWARD" 2>/dev/null || true
+echo "REWARD=0"
+echo "Score: 0 (no grader)"