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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: use-computer
-Version: 0.0.17
+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
@@ -57,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.17 → use_computer-0.0.18}/README.md

@@ -35,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.17 → use_computer-0.0.18}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "use-computer"
-version = "0.0.17"
+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.17/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)")