use-computer 0.0.42__tar.gz → 0.0.44__tar.gz

{use_computer-0.0.42 → use_computer-0.0.44}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: use-computer
-Version: 0.0.42
+Version: 0.0.44
 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
@@ -53,6 +53,11 @@ Base installs only the SDK client and `httpx`. The `agents` extra installs the
 agent runtime plus model-provider dependencies; `harbor` installs Harbor for
 `use_computer.harbor.agents`.
 
+Sandboxes default to `ephemeral=True`, so they are deleted after roughly 2
+minutes without activity. Use `ephemeral=False` when a sandbox should persist
+until manual deletion, or call `sandbox.start_keepalive(interval=30)` during
+long model-think/install periods.
+
 ```python
 from use_computer.agents import AnthropicComputerAgent
 ```
@@ -202,7 +207,7 @@ visionOS yet. Use it for read-only flows for now.
 | [`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/_5_keepalive.py`](examples/_5_keepalive.py)         | heartbeat for ephemeral sessions idle > 2 min  |
 | [`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          |

{use_computer-0.0.42 → use_computer-0.0.44}/README.md

@@ -19,6 +19,11 @@ Base installs only the SDK client and `httpx`. The `agents` extra installs the
 agent runtime plus model-provider dependencies; `harbor` installs Harbor for
 `use_computer.harbor.agents`.
 
+Sandboxes default to `ephemeral=True`, so they are deleted after roughly 2
+minutes without activity. Use `ephemeral=False` when a sandbox should persist
+until manual deletion, or call `sandbox.start_keepalive(interval=30)` during
+long model-think/install periods.
+
 ```python
 from use_computer.agents import AnthropicComputerAgent
 ```
@@ -168,7 +173,7 @@ visionOS yet. Use it for read-only flows for now.
 | [`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/_5_keepalive.py`](examples/_5_keepalive.py)         | heartbeat for ephemeral sessions idle > 2 min  |
 | [`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          |

{use_computer-0.0.42 → use_computer-0.0.44}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "use-computer"
-version = "0.0.42"
+version = "0.0.44"
 description = "Python SDK for use.computer sandboxes across macOS, iOS simulators, Windows, and Ubuntu"
 readme = "README.md"
 requires-python = ">=3.10"

{use_computer-0.0.42 → use_computer-0.0.44}/use_computer/core/client.py

@@ -298,7 +298,11 @@ class Computer:
         sid = data["sandbox_id"]
 
         if sandbox_type == SandboxType.IOS:
-            return IOSSandbox(sandbox_id=sid, http=self._http)
+            return IOSSandbox(
+                sandbox_id=sid,
+                http=self._http,
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
+            )
         if sandbox_type == SandboxType.WINDOWS:
             return WindowsSandbox(
                 sandbox_id=sid,
@@ -333,7 +337,11 @@ class Computer:
         data = resp.json()
         sb_type = SandboxType(data.get("type", "macos"))
         if sb_type == SandboxType.IOS:
-            return IOSSandbox(sandbox_id=data["sandbox_id"], http=self._http)
+            return IOSSandbox(
+                sandbox_id=data["sandbox_id"],
+                http=self._http,
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
+            )
         if sb_type == SandboxType.WINDOWS:
             return WindowsSandbox(
                 sandbox_id=data["sandbox_id"],
@@ -574,7 +582,11 @@ class AsyncComputer:
         sid = data["sandbox_id"]
 
         if sandbox_type == SandboxType.IOS:
-            return AsyncIOSSandbox(sandbox_id=sid, http=self._http)
+            return AsyncIOSSandbox(
+                sandbox_id=sid,
+                http=self._http,
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
+            )
         if sandbox_type == SandboxType.WINDOWS:
             return AsyncWindowsSandbox(
                 sandbox_id=sid,
@@ -609,7 +621,11 @@ class AsyncComputer:
         data = resp.json()
         sb_type = SandboxType(data.get("type", "macos"))
         if sb_type == SandboxType.IOS:
-            return AsyncIOSSandbox(sandbox_id=data["sandbox_id"], http=self._http)
+            return AsyncIOSSandbox(
+                sandbox_id=data["sandbox_id"],
+                http=self._http,
+                vnc_url=_absolute_url(self._base_url, data.get("vnc_url", "")),
+            )
         if sb_type == SandboxType.WINDOWS:
             return AsyncWindowsSandbox(
                 sandbox_id=data["sandbox_id"],

{use_computer-0.0.42 → use_computer-0.0.44}/use_computer/core/sandbox.py

@@ -101,6 +101,17 @@ def _stop_keepalive_thread(
         thread.join(timeout=2)
 
 
+class _CompletedAwaitable:
+    def __await__(self):
+        if False:
+            yield None
+        return None
+
+
+def _keepalive_running(thread: threading.Thread | None) -> bool:
+    return thread is not None and thread.is_alive()
+
+
 # ---------------------------------------------------------------------------
 # Sync
 # ---------------------------------------------------------------------------
@@ -177,10 +188,17 @@ class Sandbox:
 
     def start_keepalive(self, interval: float = 30.0) -> None:
         """Start a background thread that pings the gateway every `interval` seconds."""
+        if _keepalive_running(self._keepalive_thread):
+            return
         self._keepalive_stop, self._keepalive_thread = _start_keepalive_thread(
             self._http, self._prefix, interval
         )
 
+    def keepalive(self) -> None:
+        """Reset the gateway idle timer once."""
+        resp = self._http.post(f"{self._prefix}/keepalive")
+        resp.raise_for_status()
+
     def stop_keepalive(self) -> None:
         """Stop the keepalive background thread."""
         _stop_keepalive_thread(self._keepalive_stop, self._keepalive_thread)
@@ -296,8 +314,8 @@ class MacOSSandbox(Sandbox):
 class IOSSandbox(Sandbox):
     """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)
+    def __init__(self, sandbox_id: str, http: httpx.Client, vnc_url: str = ""):
+        super().__init__(sandbox_id, SandboxType.IOS, http, vnc_url=vnc_url)
         self.input = Input(http, self._prefix)
         self.apps = Apps(http, self._prefix)
         self.environment = Environment(http, self._prefix)
@@ -602,21 +620,30 @@ class AsyncSandbox:
             platform=data.get("platform", self.type.value),
         )
 
-    async def start_keepalive(self, interval: float = 30.0) -> None:
+    def start_keepalive(self, interval: float = 30.0) -> _CompletedAwaitable:
         """Start a background OS thread that pings the gateway every `interval` seconds.
 
         Uses a real thread (not an asyncio task) so it fires reliably even when
         the event loop is blocked by sync calls (e.g. sync Anthropic client).
         """
+        if _keepalive_running(self._keepalive_thread):
+            return _CompletedAwaitable()
         self._keepalive_stop, self._keepalive_thread = _start_keepalive_thread(
             self._http, self._prefix, interval
         )
+        return _CompletedAwaitable()
+
+    async def keepalive(self) -> None:
+        """Reset the gateway idle timer once."""
+        resp = await self._http.post(f"{self._prefix}/keepalive")
+        resp.raise_for_status()
 
-    async def stop_keepalive(self) -> None:
+    def stop_keepalive(self) -> _CompletedAwaitable:
         """Stop the keepalive background thread."""
         _stop_keepalive_thread(self._keepalive_stop, self._keepalive_thread)
         self._keepalive_stop = None
         self._keepalive_thread = None
+        return _CompletedAwaitable()
 
     async def close(self):
         await self.stop_keepalive()
@@ -717,8 +744,8 @@ class AsyncMacOSSandbox(AsyncSandbox):
 class AsyncIOSSandbox(AsyncSandbox):
     """Async iOS simulator sandbox."""
 
-    def __init__(self, sandbox_id: str, http: httpx.AsyncClient):
-        super().__init__(sandbox_id, SandboxType.IOS, http)
+    def __init__(self, sandbox_id: str, http: httpx.AsyncClient, vnc_url: str = ""):
+        super().__init__(sandbox_id, SandboxType.IOS, http, vnc_url=vnc_url)
         self.input = AsyncInput(http, self._prefix)
         self.apps = AsyncApps(http, self._prefix)
         self.environment = AsyncEnvironment(http, self._prefix)