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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: use-computer
-Version: 0.0.43
+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.43 → 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.43 → use_computer-0.0.44}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "use-computer"
-version = "0.0.43"
+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.43 → 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)
@@ -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()