runloop-api-client 0.47.1__tar.gz → 0.48.1__tar.gz

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

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

{runloop_api_client-0.47.1 → runloop_api_client-0.48.1}/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.48.1 (2025-07-10)
+
+Full Changelog: [v0.48.0...v0.48.1](https://github.com/runloopai/api-client-python/compare/v0.48.0...v0.48.1)
+
+### Bug Fixes
+
+* **parsing:** correctly handle nested discriminated unions ([3312be9](https://github.com/runloopai/api-client-python/commit/3312be9e751dd58396884644be4ceabbaba11014))
+
+
+### Chores
+
+* **internal:** bump pinned h11 dep ([80ff87c](https://github.com/runloopai/api-client-python/commit/80ff87cde91eedd2169bd3b3e563545291928cbd))
+* **package:** mark python 3.13 as supported ([7043864](https://github.com/runloopai/api-client-python/commit/70438649e40206746ea1543fc6c29b3c9fb47bd3))
+
+## 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)

{runloop_api_client-0.47.1 → runloop_api_client-0.48.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 0.47.1
+Version: 0.48.1
 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
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.8
@@ -281,7 +282,8 @@ Error codes are as follows:
 
 Certain errors are automatically retried 5 times by default, with a short exponential backoff.
 Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 409 Conflict,
-429 Rate Limit, and >=500 Internal errors are all retried by default.
+429 Rate Limit, and >=500 Internal errors are all retried by default for GET requests. For POST requests, only 
+429 errors will be retried.
 
 You can use the `max_retries` option to configure or disable retry settings:
 
@@ -290,12 +292,12 @@ from runloop_api_client import Runloop
 
 # Configure the default for all requests:
 client = Runloop(
-    # default is 2
+    # default is 5
     max_retries=0,
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).devboxes.create()
+client.with_options(max_retries=10).devboxes.create()
 ```
 
 ### Timeouts

{runloop_api_client-0.47.1 → runloop_api_client-0.48.1}/README.md

@@ -247,7 +247,8 @@ Error codes are as follows:
 
 Certain errors are automatically retried 5 times by default, with a short exponential backoff.
 Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 409 Conflict,
-429 Rate Limit, and >=500 Internal errors are all retried by default.
+429 Rate Limit, and >=500 Internal errors are all retried by default for GET requests. For POST requests, only 
+429 errors will be retried.
 
 You can use the `max_retries` option to configure or disable retry settings:
 
@@ -256,12 +257,12 @@ from runloop_api_client import Runloop
 
 # Configure the default for all requests:
 client = Runloop(
-    # default is 2
+    # default is 5
     max_retries=0,
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).devboxes.create()
+client.with_options(max_retries=10).devboxes.create()
 ```
 
 ### Timeouts

{runloop_api_client-0.47.1 → runloop_api_client-0.48.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runloop_api_client"
-version = "0.47.1"
+version = "0.48.1"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"
@@ -24,6 +24,7 @@ classifiers = [
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
   "Operating System :: OS Independent",
   "Operating System :: POSIX",
   "Operating System :: MacOS",
@@ -135,6 +136,9 @@ asyncio_default_fixture_loop_scope = "session"
 filterwarnings = [
   "error"
 ]
+markers = [
+  "skip_if_strict: skip test if using strict validation (for prism mock server issues)"
+]
 
 [tool.pyright]
 # this enables practically every flag given by pyright.

{runloop_api_client-0.47.1 → runloop_api_client-0.48.1}/requirements-dev.lock

@@ -48,9 +48,9 @@ filelock==3.12.4
 frozenlist==1.6.2
     # via aiohttp
     # via aiosignal
-h11==0.14.0
+h11==0.16.0
     # via httpcore
-httpcore==1.0.2
+httpcore==1.0.9
     # via httpx
 httpx==0.28.1
     # via httpx-aiohttp

{runloop_api_client-0.47.1 → runloop_api_client-0.48.1}/requirements.lock

@@ -36,9 +36,9 @@ exceptiongroup==1.2.2
 frozenlist==1.6.2
     # via aiohttp
     # via aiosignal
-h11==0.14.0
+h11==0.16.0
     # via httpcore
-httpcore==1.0.2
+httpcore==1.0.9
     # via httpx
 httpx==0.28.1
     # via httpx-aiohttp

{runloop_api_client-0.47.1 → runloop_api_client-0.48.1}/src/runloop_api_client/_models.py

@@ -2,9 +2,10 @@ from __future__ import annotations
 
 import os
 import inspect
-from typing import TYPE_CHECKING, Any, Type, Union, Generic, TypeVar, Callable, cast
+from typing import TYPE_CHECKING, Any, Type, Union, Generic, TypeVar, Callable, Optional, cast
 from datetime import date, datetime
 from typing_extensions import (
+    List,
     Unpack,
     Literal,
     ClassVar,
@@ -366,7 +367,7 @@ def _construct_field(value: object, field: FieldInfo, key: str) -> object:
     if type_ is None:
         raise RuntimeError(f"Unexpected field type is None for {key}")
 
-    return construct_type(value=value, type_=type_)
+    return construct_type(value=value, type_=type_, metadata=getattr(field, "metadata", None))
 
 
 def is_basemodel(type_: type) -> bool:
@@ -420,7 +421,7 @@ def construct_type_unchecked(*, value: object, type_: type[_T]) -> _T:
     return cast(_T, construct_type(value=value, type_=type_))
 
 
-def construct_type(*, value: object, type_: object) -> object:
+def construct_type(*, value: object, type_: object, metadata: Optional[List[Any]] = None) -> object:
     """Loose coercion to the expected type with construction of nested values.
 
     If the given value does not match the expected type then it is returned as-is.
@@ -438,8 +439,10 @@ def construct_type(*, value: object, type_: object) -> object:
         type_ = type_.__value__  # type: ignore[unreachable]
 
     # unwrap `Annotated[T, ...]` -> `T`
-    if is_annotated_type(type_):
-        meta: tuple[Any, ...] = get_args(type_)[1:]
+    if metadata is not None:
+        meta: tuple[Any, ...] = tuple(metadata)
+    elif is_annotated_type(type_):
+        meta = get_args(type_)[1:]
         type_ = extract_type_arg(type_, 0)
     else:
         meta = tuple()

{runloop_api_client-0.47.1 → runloop_api_client-0.48.1}/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.1"  # x-release-please-version
+__version__ = "0.48.1"  # x-release-please-version

{runloop_api_client-0.47.1 → runloop_api_client-0.48.1}/src/runloop_api_client/lib/polling.py

@@ -2,21 +2,26 @@ import time
 from typing import Any, TypeVar, Callable, Optional
 from dataclasses import dataclass
 
-T = TypeVar('T')
+T = TypeVar("T")
+
 
 @dataclass
 class PollingConfig:
     """Configuration for polling behavior"""
+
     interval_seconds: float = 1.0
     max_attempts: int = 120
     timeout_seconds: Optional[float] = None
 
+
 class PollingTimeout(Exception):
     """Raised when polling exceeds max attempts or timeout"""
+
     def __init__(self, message: str, last_value: Any):
         self.last_value = last_value
         super().__init__(f"{message}. Last retrieved value: {last_value}")
 
+
 def poll_until(
     retriever: Callable[[], T],
     is_terminal: Callable[[T], bool],
@@ -25,27 +30,27 @@ def poll_until(
 ) -> T:
     """
     Poll until a condition is met or timeout/max attempts are reached.
-    
+
     Args:
         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
-        
+
     Raises:
         PollingTimeout: When max attempts or timeout is reached
     """
     if config is None:
         config = PollingConfig()
-    
+
     attempts = 0
     start_time = time.time()
     last_result = None
-    
+
     while True:
         try:
             last_result = retriever()
@@ -54,23 +59,17 @@ def poll_until(
                 last_result = on_error(e)
             else:
                 raise
-        
+
         if is_terminal(last_result):
             return last_result
-            
+
         attempts += 1
         if attempts >= config.max_attempts:
-            raise PollingTimeout(
-                f"Exceeded maximum attempts ({config.max_attempts})",
-                last_result
-            )
-            
+            raise PollingTimeout(f"Exceeded maximum attempts ({config.max_attempts})", last_result)
+
         if config.timeout_seconds is not None:
             elapsed = time.time() - start_time
             if elapsed >= config.timeout_seconds:
-                raise PollingTimeout(
-                    f"Exceeded timeout of {config.timeout_seconds} seconds",
-                    last_result
-                )
-                
+                raise PollingTimeout(f"Exceeded timeout of {config.timeout_seconds} seconds", last_result)
+
         time.sleep(config.interval_seconds)

{runloop_api_client-0.47.1 → runloop_api_client-0.48.1}/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 (
@@ -400,7 +400,7 @@ class DevboxesResource(SyncAPIResource):
 
         def handle_timeout_error(error: Exception) -> DevboxView:
             # Handle 408 timeout errors by returning current devbox state to continue polling
-            if isinstance(error, httpx.HTTPStatusError) and error.response.status_code == 408:
+            if isinstance(error, APIStatusError) and error.response.status_code == 408:
                 # Return a placeholder result to continue polling
                 return DevboxView(
                     id=id,
@@ -1710,7 +1710,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
                     ),
                     cast_to=DevboxView,
                 )
-            except httpx.HTTPStatusError as error:
+            except APIStatusError as error:
                 if error.response.status_code == 408:
                     # Handle 408 timeout errors by returning a placeholder result to continue polling
                     return DevboxView(

{runloop_api_client-0.47.1 → runloop_api_client-0.48.1}/src/runloop_api_client/resources/devboxes/executions.py

@@ -17,6 +17,7 @@ from ..._response import (
     async_to_streamed_response_wrapper,
 )
 from ..._constants import DEFAULT_TIMEOUT
+from ..._exceptions import APIStatusError
 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
@@ -105,7 +106,7 @@ class ExecutionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> DevboxAsyncExecutionDetailView:
         """Wait for an execution to complete.
-        
+
         Args:
             execution_id: The ID of the execution to wait for
             id: The ID of the devbox
@@ -121,20 +122,37 @@ class ExecutionsResource(SyncAPIResource):
         Raises:
             PollingTimeout: If polling times out before execution completes
         """
-        def retrieve_execution() -> DevboxAsyncExecutionDetailView:
-            return self.retrieve(
-                execution_id,
-                devbox_id=devbox_id,
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout
+
+        def wait_for_execution_status() -> DevboxAsyncExecutionDetailView:
+            # This wait_for_status endpoint polls the execution status for 60 seconds until it reaches either completed.
+            return self._post(
+                f"/v1/devboxes/{devbox_id}/executions/{execution_id}/wait_for_status",
+                body={"statuses": ["completed"]},
+                options=make_request_options(
+                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                ),
+                cast_to=DevboxAsyncExecutionDetailView,
             )
 
+        def handle_timeout_error(error: Exception) -> DevboxAsyncExecutionDetailView:
+            # Handle 408 timeout errors by returning current execution state to continue polling
+            if isinstance(error, APIStatusError) and error.response.status_code == 408:
+                # Return a placeholder result to continue polling
+                return DevboxAsyncExecutionDetailView(
+                    devbox_id=devbox_id,
+                    execution_id=execution_id,
+                    status="queued",
+                    stdout="",
+                    stderr="",
+                )
+            else:
+                # Re-raise other errors to stop polling
+                raise error
+
         def is_done(execution: DevboxAsyncExecutionDetailView) -> bool:
-            return execution.status == 'completed'
+            return execution.status == "completed"
 
-        return poll_until(retrieve_execution, is_done, config)    
+        return poll_until(wait_for_execution_status, is_done, config, handle_timeout_error)
 
     def execute_async(
         self,
@@ -369,7 +387,7 @@ class AsyncExecutionsResource(AsyncAPIResource):
 
     async def await_completed(
         self,
-        execution_id: str,        
+        execution_id: str,
         *,
         devbox_id: str,
         polling_config: PollingConfig | None = None,
@@ -381,7 +399,7 @@ class AsyncExecutionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> DevboxAsyncExecutionDetailView:
         """Wait for an execution to complete.
-        
+
         Args:
             execution_id: The ID of the execution to wait for
             id: The ID of the devbox
@@ -397,20 +415,35 @@ class AsyncExecutionsResource(AsyncAPIResource):
         Raises:
             PollingTimeout: If polling times out before execution completes
         """
-        async def retrieve_execution() -> DevboxAsyncExecutionDetailView:
-            return await self.retrieve(
-                execution_id,
-                devbox_id=devbox_id,
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-            )
+
+        async def wait_for_execution_status() -> DevboxAsyncExecutionDetailView:
+            try:
+                return await self._post(
+                    f"/v1/devboxes/{devbox_id}/executions/{execution_id}/wait_for_status",
+                    body={"statuses": ["completed"]},
+                    options=make_request_options(
+                        extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                    ),
+                    cast_to=DevboxAsyncExecutionDetailView,
+                )
+            except APIStatusError as error:
+                if error.response.status_code == 408:
+                    # Handle 408 timeout errors by returning current execution state to continue polling
+                    return DevboxAsyncExecutionDetailView(
+                        devbox_id=devbox_id,
+                        execution_id=execution_id,
+                        status="queued",
+                        stdout="",
+                        stderr="",
+                    )
+                else:
+                    # Re-raise other errors to stop polling
+                    raise
 
         def is_done(execution: DevboxAsyncExecutionDetailView) -> bool:
-            return execution.status == 'completed'
+            return execution.status == "completed"
 
-        return await async_poll_until(retrieve_execution, is_done, polling_config)
+        return await async_poll_until(wait_for_execution_status, is_done, polling_config)
 
     async def execute_async(
         self,