use-computer 0.0.16__tar.gz → 0.0.18__tar.gz

{use_computer-0.0.16 → use_computer-0.0.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: use-computer
-Version: 0.0.16
+Version: 0.0.18
 Summary: Python SDK for the use.computer macOS and iOS Computer Use API
 Project-URL: Homepage, https://use.computer
 Project-URL: Documentation, https://api.use.computer/docs
@@ -40,6 +40,9 @@ with Computer().create() as mac:
 with Computer().create(type=SandboxType.IOS, family=SimulatorFamily.TV) as tv:
     tv.screenshot.take_full_screen()
     tv.input.press_remote("select")
+
+with Computer().create(type=SandboxType.IOS) as ios:
+    ios.input.long_press(120, 300, duration=1.0)
 ```
 
 Full DSL reference (macOS + simulator): [docs.use.computer/docs/sdk](https://docs.use.computer/docs/sdk)
@@ -54,15 +57,26 @@ iPhone 17 Pro on the latest installed iOS runtime.
 Known-incompatible simulator types are filtered from family selection,
 including the non-4K Apple Vision Pro type on current fleet runtimes.
 
+### Per-family input
+
+iPhone / iPad sims have full touch + on-screen keyboard. Apple Watch supports
+touch + crown / button (no `type_text` — watchOS keyboard isn't exposed). Apple
+TV has no touch — drive it with `input.press_remote(RemoteButton.SELECT)` (the
+remote D-pad, select, menu, home, play/pause). **Apple Vision (visionOS) is
+BETA**: sessions display and you can screenshot / launch apps, but
+`input.tap` is a no-op because there's no XCTest-free coordinate tap path on
+visionOS yet. Use it for read-only flows for now.
+
 ## Examples
 
-| File                                                           | What it shows                              |
-| -------------------------------------------------------------- | ------------------------------------------ |
-| [`examples/_1_hello_macos.py`](examples/_1_hello_macos.py)     | create → exec → keyboard → screenshot      |
-| [`examples/_2_hello_ios.py`](examples/_2_hello_ios.py)         | create simulator → open URL → screenshot   |
-| [`examples/_3_recording.py`](examples/_3_recording.py)         | start / stop / download a screen recording |
-| [`examples/_4_file_transfer.py`](examples/_4_file_transfer.py) | upload bytes, download a file back         |
-| [`examples/_5_keepalive.py`](examples/_5_keepalive.py)         | heartbeat for sessions idle > 2 min        |
+| File                                                           | What it shows                                  |
+| -------------------------------------------------------------- | ---------------------------------------------- |
+| [`examples/_1_hello_macos.py`](examples/_1_hello_macos.py)     | create → exec → keyboard → screenshot          |
+| [`examples/_2_hello_ios.py`](examples/_2_hello_ios.py)         | create iPhone sim → open URL → screenshot      |
+| [`examples/_3_recording.py`](examples/_3_recording.py)         | start / stop / download a screen recording     |
+| [`examples/_4_file_transfer.py`](examples/_4_file_transfer.py) | upload bytes, download a file back             |
+| [`examples/_5_keepalive.py`](examples/_5_keepalive.py)         | heartbeat for sessions idle > 2 min            |
+| [`examples/_6_hello_tvos.py`](examples/_6_hello_tvos.py)       | tvOS: pick TV family + drive the Apple Remote  |
 
 For agent loops and evals: [use-computer-cookbook](https://github.com/josancamon19/use-computer-cookbook).
 

{use_computer-0.0.16 → use_computer-0.0.18}/README.md

@@ -18,6 +18,9 @@ with Computer().create() as mac:
 with Computer().create(type=SandboxType.IOS, family=SimulatorFamily.TV) as tv:
     tv.screenshot.take_full_screen()
     tv.input.press_remote("select")
+
+with Computer().create(type=SandboxType.IOS) as ios:
+    ios.input.long_press(120, 300, duration=1.0)
 ```
 
 Full DSL reference (macOS + simulator): [docs.use.computer/docs/sdk](https://docs.use.computer/docs/sdk)
@@ -32,15 +35,26 @@ iPhone 17 Pro on the latest installed iOS runtime.
 Known-incompatible simulator types are filtered from family selection,
 including the non-4K Apple Vision Pro type on current fleet runtimes.
 
+### Per-family input
+
+iPhone / iPad sims have full touch + on-screen keyboard. Apple Watch supports
+touch + crown / button (no `type_text` — watchOS keyboard isn't exposed). Apple
+TV has no touch — drive it with `input.press_remote(RemoteButton.SELECT)` (the
+remote D-pad, select, menu, home, play/pause). **Apple Vision (visionOS) is
+BETA**: sessions display and you can screenshot / launch apps, but
+`input.tap` is a no-op because there's no XCTest-free coordinate tap path on
+visionOS yet. Use it for read-only flows for now.
+
 ## Examples
 
-| File                                                           | What it shows                              |
-| -------------------------------------------------------------- | ------------------------------------------ |
-| [`examples/_1_hello_macos.py`](examples/_1_hello_macos.py)     | create → exec → keyboard → screenshot      |
-| [`examples/_2_hello_ios.py`](examples/_2_hello_ios.py)         | create simulator → open URL → screenshot   |
-| [`examples/_3_recording.py`](examples/_3_recording.py)         | start / stop / download a screen recording |
-| [`examples/_4_file_transfer.py`](examples/_4_file_transfer.py) | upload bytes, download a file back         |
-| [`examples/_5_keepalive.py`](examples/_5_keepalive.py)         | heartbeat for sessions idle > 2 min        |
+| File                                                           | What it shows                                  |
+| -------------------------------------------------------------- | ---------------------------------------------- |
+| [`examples/_1_hello_macos.py`](examples/_1_hello_macos.py)     | create → exec → keyboard → screenshot          |
+| [`examples/_2_hello_ios.py`](examples/_2_hello_ios.py)         | create iPhone sim → open URL → screenshot      |
+| [`examples/_3_recording.py`](examples/_3_recording.py)         | start / stop / download a screen recording     |
+| [`examples/_4_file_transfer.py`](examples/_4_file_transfer.py) | upload bytes, download a file back             |
+| [`examples/_5_keepalive.py`](examples/_5_keepalive.py)         | heartbeat for sessions idle > 2 min            |
+| [`examples/_6_hello_tvos.py`](examples/_6_hello_tvos.py)       | tvOS: pick TV family + drive the Apple Remote  |
 
 For agent loops and evals: [use-computer-cookbook](https://github.com/josancamon19/use-computer-cookbook).
 

use_computer-0.0.18/examples/_2_hello_ios.py

@@ -0,0 +1,11 @@
+from use_computer import Computer, SandboxType, SimulatorFamily
+
+# iPhone is the default when family= is omitted. Pass family= to target a
+# different simulator family (iPad, Apple Watch, Apple TV, Apple Vision); the
+# SDK picks a compatible installed device_type + runtime pair for you. See
+# _6_hello_tvos.py for an Apple TV walkthrough.
+with Computer().create(type=SandboxType.IOS, family=SimulatorFamily.IPHONE) as ios:
+    ios.apps.open_url("https://example.com")
+    png = ios.screenshot.take_full_screen()
+    open("hello_ios.png", "wb").write(png)
+    print(f"saved hello_ios.png ({len(png)} bytes)")

use_computer-0.0.18/examples/_6_hello_tvos.py

@@ -0,0 +1,11 @@
+from use_computer import Computer, RemoteButton, SandboxType, SimulatorFamily
+
+# tvOS sims have no touch — drive them with the remote (D-pad + select / menu /
+# home). `press_remote` accepts the enum or a string.
+with Computer().create(type=SandboxType.IOS, family=SimulatorFamily.TV) as tv:
+    tv.input.press_remote(RemoteButton.DOWN)
+    tv.input.press_remote(RemoteButton.DOWN)
+    tv.input.press_remote(RemoteButton.SELECT)
+    png = tv.screenshot.take_full_screen()
+    open("hello_tvos.png", "wb").write(png)
+    print(f"saved hello_tvos.png ({len(png)} bytes)")

{use_computer-0.0.16 → use_computer-0.0.18}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "use-computer"
-version = "0.0.16"
+version = "0.0.18"
 description = "Python SDK for the use.computer macOS and iOS Computer Use API"
 readme = "README.md"
 requires-python = ">=3.10"

{use_computer-0.0.16 → use_computer-0.0.18}/use_computer/ios/input.py

@@ -65,6 +65,15 @@ class Input:
         resp.raise_for_status()
         return ActionResult.from_dict(resp.json())
 
+    def long_press(self, x: float, y: float, duration: float = 1.0) -> ActionResult:
+        """Hold a touch at coordinates for duration seconds."""
+        resp = self._http.post(
+            f"{self._prefix}/long_press",
+            json={"x": x, "y": y, "duration": duration},
+        )
+        resp.raise_for_status()
+        return ActionResult.from_dict(resp.json())
+
     def swipe(self, from_x: float, from_y: float, to_x: float, to_y: float) -> ActionResult:
         resp = self._http.post(
             f"{self._prefix}/swipe",
@@ -110,6 +119,15 @@ class AsyncInput:
         resp.raise_for_status()
         return ActionResult.from_dict(resp.json())
 
+    async def long_press(self, x: float, y: float, duration: float = 1.0) -> ActionResult:
+        """Hold a touch at coordinates for duration seconds."""
+        resp = await self._http.post(
+            f"{self._prefix}/long_press",
+            json={"x": x, "y": y, "duration": duration},
+        )
+        resp.raise_for_status()
+        return ActionResult.from_dict(resp.json())
+
     async def swipe(self, from_x: float, from_y: float, to_x: float, to_y: float) -> ActionResult:
         resp = await self._http.post(
             f"{self._prefix}/swipe",

{use_computer-0.0.16 → use_computer-0.0.18}/use_computer/sandbox.py

@@ -243,7 +243,7 @@ class MacOSSandbox(Sandbox):
 
 
 class IOSSandbox(Sandbox):
-    """iOS simulator sandbox — tap, swipe, hardware buttons, app management."""
+    """iOS simulator sandbox — tap, long press, swipe, buttons, apps."""
 
     def __init__(self, sandbox_id: str, http: httpx.Client):
         super().__init__(sandbox_id, SandboxType.IOS, http)

use_computer-0.0.16/examples/_2_hello_ios.py

@@ -1,7 +0,0 @@
-from use_computer import Computer, SandboxType
-
-with Computer().create(type=SandboxType.IOS) as ios:
-    ios.apps.open_url("https://example.com")
-    png = ios.screenshot.take_full_screen()
-    open("hello_ios.png", "wb").write(png)
-    print(f"saved hello_ios.png ({len(png)} bytes)")