runloop-api-client 0.47.0__tar.gz → 0.48.0__tar.gz

runloop_api_client-0.48.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.48.0"
+}

{runloop_api_client-0.47.0 → runloop_api_client-0.48.0}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.48.0 (2025-07-09)
+
+Full Changelog: [v0.47.1...v0.48.0](https://github.com/runloopai/api-client-python/compare/v0.47.1...v0.48.0)
+
+## 0.47.1 (2025-07-08)
+
+Full Changelog: [v0.47.0...v0.47.1](https://github.com/runloopai/api-client-python/compare/v0.47.0...v0.47.1)
+
+### Chores
+
+* **ci:** change upload type ([e8af7c3](https://github.com/runloopai/api-client-python/commit/e8af7c350cf848f0255ffc3ebcaeb339ebcb8ba9))
+* **internal:** codegen related update ([402126e](https://github.com/runloopai/api-client-python/commit/402126e45fbb32556f59b1504ded9581910ee7dd))
+
 ## 0.47.0 (2025-07-01)
 
 Full Changelog: [v0.46.0...v0.47.0](https://github.com/runloopai/api-client-python/compare/v0.46.0...v0.47.0)

{runloop_api_client-0.47.0 → runloop_api_client-0.48.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 0.47.0
+Version: 0.48.0
 Summary: The official Python library for the runloop API
 Project-URL: Homepage, https://github.com/runloopai/api-client-python
 Project-URL: Repository, https://github.com/runloopai/api-client-python

{runloop_api_client-0.47.0 → runloop_api_client-0.48.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runloop_api_client"
-version = "0.47.0"
+version = "0.48.0"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"

{runloop_api_client-0.47.0 → runloop_api_client-0.48.0}/requirements-dev.lock

@@ -56,7 +56,7 @@ httpx==0.28.1
     # via httpx-aiohttp
     # via respx
     # via runloop-api-client
-httpx-aiohttp==0.1.6
+httpx-aiohttp==0.1.8
     # via runloop-api-client
 idna==3.4
     # via anyio

{runloop_api_client-0.47.0 → runloop_api_client-0.48.0}/requirements.lock

@@ -43,7 +43,7 @@ httpcore==1.0.2
 httpx==0.28.1
     # via httpx-aiohttp
     # via runloop-api-client
-httpx-aiohttp==0.1.6
+httpx-aiohttp==0.1.8
     # via runloop-api-client
 idna==3.4
     # via anyio

{runloop_api_client-0.47.0 → runloop_api_client-0.48.0}/src/runloop_api_client/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "runloop_api_client"
-__version__ = "0.47.0"  # x-release-please-version
+__version__ = "0.48.0"  # x-release-please-version

{runloop_api_client-0.47.0 → runloop_api_client-0.48.0}/src/runloop_api_client/lib/polling.py

@@ -21,6 +21,7 @@ def poll_until(
     retriever: Callable[[], T],
     is_terminal: Callable[[T], bool],
     config: Optional[PollingConfig] = None,
+    on_error: Optional[Callable[[Exception], T]] = None,
 ) -> T:
     """
     Poll until a condition is met or timeout/max attempts are reached.
@@ -29,6 +30,8 @@ def poll_until(
         retriever: Callable that returns the object to check
         is_terminal: Callable that returns True when polling should stop
         config: Optional polling configuration
+        on_error: Optional error handler that can return a value to continue polling
+                 or re-raise the exception to stop polling
         
     Returns:
         The final state of the polled object
@@ -44,7 +47,13 @@ def poll_until(
     last_result = None
     
     while True:
-        last_result = retriever()
+        try:
+            last_result = retriever()
+        except Exception as e:
+            if on_error is not None:
+                last_result = on_error(e)
+            else:
+                raise
         
         if is_terminal(last_result):
             return last_result

{runloop_api_client-0.47.0 → runloop_api_client-0.48.0}/src/runloop_api_client/lib/polling_async.py

@@ -10,6 +10,7 @@ async def async_poll_until(
     retriever: Callable[[], Awaitable[T]],
     is_terminal: Callable[[T], bool],
     config: Optional[PollingConfig] = None,
+    on_error: Optional[Callable[[Exception], T]] = None,
 ) -> T:
     """
     Poll until a condition is met or timeout/max attempts are reached.
@@ -18,6 +19,8 @@ async def async_poll_until(
         retriever: Async or sync callable that returns the object to check
         is_terminal: Callable that returns True when polling should stop
         config: Optional polling configuration
+        on_error: Optional error handler that can return a value to continue polling
+                 or re-raise the exception to stop polling
         
     Returns:
         The final state of the polled object
@@ -33,7 +36,13 @@ async def async_poll_until(
     last_result: Union[T, None] = None
     
     while True:
-        last_result = await retriever()
+        try:
+            last_result = await retriever()
+        except Exception as e:
+            if on_error is not None:
+                last_result = on_error(e)
+            else:
+                raise
         
         if is_terminal(last_result):
             return last_result

{runloop_api_client-0.47.0 → runloop_api_client-0.48.0}/src/runloop_api_client/resources/devboxes/devboxes.py

@@ -88,7 +88,7 @@ from ...pagination import (
     SyncDiskSnapshotsCursorIDPage,
     AsyncDiskSnapshotsCursorIDPage,
 )
-from ..._exceptions import RunloopError
+from ..._exceptions import RunloopError, APIStatusError
 from ...lib.polling import PollingConfig, poll_until
 from ..._base_client import AsyncPaginator, make_request_options
 from .disk_snapshots import (
@@ -103,6 +103,7 @@ from ...lib.polling_async import async_poll_until
 from ...types.devbox_view import DevboxView
 from ...types.devbox_tunnel_view import DevboxTunnelView
 from ...types.devbox_snapshot_view import DevboxSnapshotView
+from ...types.shared.launch_parameters import LaunchParameters as SharedLaunchParameters
 from ...types.devbox_execution_detail_view import DevboxExecutionDetailView
 from ...types.devbox_create_ssh_key_response import DevboxCreateSSHKeyResponse
 from ...types.shared_params.launch_parameters import LaunchParameters
@@ -111,7 +112,8 @@ from ...types.shared_params.code_mount_parameters import CodeMountParameters
 
 __all__ = ["DevboxesResource", "AsyncDevboxesResource"]
 
-DEVBOX_BOOTING_STATES = frozenset(('provisioning', 'initializing'))
+DEVBOX_BOOTING_STATES = frozenset(("provisioning", "initializing"))
+
 
 class DevboxesResource(SyncAPIResource):
     @cached_property
@@ -357,7 +359,7 @@ class DevboxesResource(SyncAPIResource):
     def await_running(
         self,
         id: str,
-        *,        
+        *,
         polling_config: PollingConfig | None = None,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -367,7 +369,7 @@ class DevboxesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> DevboxView:
         """Wait for a devbox to be in running state.
-        
+
         Args:
             id: The ID of the devbox to wait for
             config: Optional polling configuration
@@ -383,24 +385,43 @@ class DevboxesResource(SyncAPIResource):
             PollingTimeout: If polling times out before devbox is running
             RunloopError: If devbox enters a non-running terminal state
         """
-        def retrieve_devbox() -> DevboxView:
-            return self.retrieve(
-                id,
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout
+
+        def wait_for_devbox_status() -> DevboxView:
+            # This wait_for_status endpoint polls the devbox status for 10 seconds until it reaches either running or failure.
+            # If it's neither, it will throw an error.
+            return self._post(
+                f"/v1/devboxes/{id}/wait_for_status",
+                body={"statuses": ["running", "failure"]},
+                options=make_request_options(
+                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                ),
+                cast_to=DevboxView,
             )
 
+        def handle_timeout_error(error: Exception) -> DevboxView:
+            # Handle 408 timeout errors by returning current devbox state to continue polling
+            if isinstance(error, APIStatusError) and error.response.status_code == 408:
+                # Return a placeholder result to continue polling
+                return DevboxView(
+                    id=id,
+                    status="provisioning",
+                    capabilities=[],
+                    create_time_ms=0,
+                    launch_parameters=SharedLaunchParameters(),
+                    metadata={},
+                    state_transitions=[],
+                )
+            else:
+                # Re-raise other errors to stop polling
+                raise error
+
         def is_done_booting(devbox: DevboxView) -> bool:
             return devbox.status not in DEVBOX_BOOTING_STATES
 
-        devbox = poll_until(retrieve_devbox, is_done_booting, polling_config)
+        devbox = poll_until(wait_for_devbox_status, is_done_booting, polling_config, handle_timeout_error)
 
         if devbox.status != "running":
-            raise RunloopError(
-                f"Devbox entered non-running terminal state: {devbox.status}"
-            )
+            raise RunloopError(f"Devbox entered non-running terminal state: {devbox.status}")
 
         return devbox
 
@@ -427,7 +448,7 @@ class DevboxesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> DevboxView:
         """Create a new devbox and wait for it to be in running state.
-        
+
         Args:
             blueprint_id: The ID of the blueprint to use
             blueprint_name: The name of the blueprint to use
@@ -1660,7 +1681,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> DevboxView:
         """Wait for a devbox to be in running state.
-        
+
         Args:
             id: The ID of the devbox to wait for
             config: Optional polling configuration
@@ -1676,27 +1697,45 @@ class AsyncDevboxesResource(AsyncAPIResource):
             PollingTimeout: If polling times out before devbox is running
             RunloopError: If devbox enters a non-running terminal state
         """
-        async def retrieve_devbox() -> DevboxView:
-            return await self.retrieve(
-                id,
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout
-            )
-        
+
+        async def wait_for_devbox_status() -> DevboxView:
+            # This wait_for_status endpoint polls the devbox status for 10 seconds until it reaches either running or failure.
+            # If it's neither, it will throw an error.
+            try:
+                return await self._post(
+                    f"/v1/devboxes/{id}/wait_for_status",
+                    body={"statuses": ["running", "failure"]},
+                    options=make_request_options(
+                        extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                    ),
+                    cast_to=DevboxView,
+                )
+            except APIStatusError as error:
+                if error.response.status_code == 408:
+                    # Handle 408 timeout errors by returning a placeholder result to continue polling
+                    return DevboxView(
+                        id=id,
+                        status="provisioning",
+                        capabilities=[],
+                        create_time_ms=0,
+                        launch_parameters=SharedLaunchParameters(),
+                        metadata={},
+                        state_transitions=[],
+                    )
+                else:
+                    # Re-raise other errors to stop polling
+                    raise
+
         def is_done_booting(devbox: DevboxView) -> bool:
             return devbox.status not in DEVBOX_BOOTING_STATES
 
-        devbox = await async_poll_until(retrieve_devbox, is_done_booting, polling_config)
+        devbox = await async_poll_until(wait_for_devbox_status, is_done_booting, polling_config)
 
         if devbox.status != "running":
-            raise RunloopError(
-                f"Devbox entered non-running terminal state: {devbox.status}"
-            )        
+            raise RunloopError(f"Devbox entered non-running terminal state: {devbox.status}")
 
         return devbox
-    
+
     async def update(
         self,
         id: str,

{runloop_api_client-0.47.0 → runloop_api_client-0.48.0}/src/runloop_api_client/resources/devboxes/executions.py

@@ -16,8 +16,8 @@ from ..._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from ...lib.polling import PollingConfig, poll_until
 from ..._constants import DEFAULT_TIMEOUT
+from ...lib.polling import PollingConfig, poll_until
 from ..._base_client import make_request_options
 from ...types.devboxes import execution_retrieve_params, execution_execute_sync_params, execution_execute_async_params
 from ...lib.polling_async import async_poll_until
@@ -103,7 +103,6 @@ class ExecutionsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-        idempotency_key: str | None = None,
     ) -> DevboxAsyncExecutionDetailView:
         """Wait for an execution to complete.
         
@@ -380,7 +379,6 @@ class AsyncExecutionsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-        idempotency_key: str | None = None,
     ) -> DevboxAsyncExecutionDetailView:
         """Wait for an execution to complete.
         
@@ -406,7 +404,7 @@ class AsyncExecutionsResource(AsyncAPIResource):
                 extra_headers=extra_headers,
                 extra_query=extra_query,
                 extra_body=extra_body,
-                timeout=timeout
+                timeout=timeout,
             )
 
         def is_done(execution: DevboxAsyncExecutionDetailView) -> bool:

runloop_api_client-0.47.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.47.0"
-}