runloop_api_client 1.20.3__tar.gz → 1.21.0__tar.gz

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

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

{runloop_api_client-1.20.3 → runloop_api_client-1.21.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.21.0 (2026-05-13)
+
+Full Changelog: [v1.20.3...v1.21.0](https://github.com/runloopai/api-client-python/compare/v1.20.3...v1.21.0)
+
+### Features
+
+* **internal/types:** support eagerly validating pydantic iterators ([f089d05](https://github.com/runloopai/api-client-python/commit/f089d05c5e00c2ba980d0afdea79ed026242a174))
+* **metadata:** add object metadata viewing, discovery, and validation ([#9124](https://github.com/runloopai/api-client-python/issues/9124)) ([ba0b5dc](https://github.com/runloopai/api-client-python/commit/ba0b5dc873a47073c453b168fe4d966754cccc0e))
+
+
+### Bug Fixes
+
+* **client:** add missing f-string prefix in file type error message ([930b1e2](https://github.com/runloopai/api-client-python/commit/930b1e2d169a291415007f2897fec5a410ecf993))
+* update openapi.stainless.yaml for PTY server methods ([#9218](https://github.com/runloopai/api-client-python/issues/9218)) ([ac1cb22](https://github.com/runloopai/api-client-python/commit/ac1cb2264b8e39da8aa65d8fdcd4595bce55def6))
+* update types for pty control, use int instead of str  ([#9235](https://github.com/runloopai/api-client-python/issues/9235)) ([7ceb2bf](https://github.com/runloopai/api-client-python/commit/7ceb2bf09c3241a27892fbab2272d63ef76b1a8a))
+
 ## 1.20.3 (2026-05-08)
 
 Full Changelog: [v1.20.2...v1.20.3](https://github.com/runloopai/api-client-python/compare/v1.20.2...v1.20.3)

{runloop_api_client-1.20.3 → runloop_api_client-1.21.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.20.3
+Version: 1.21.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-1.20.3 → runloop_api_client-1.21.0}/api.md

@@ -198,6 +198,7 @@ from runloop_api_client.types import (
     DevboxSnapshotListView,
     DevboxSnapshotView,
     DevboxView,
+    PtyTunnelView,
     TunnelView,
     DevboxCreateSSHKeyResponse,
     DevboxReadFileContentsResponse,
@@ -211,6 +212,7 @@ Methods:
 - <code title="get /v1/devboxes/{id}">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">retrieve</a>(id) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>
 - <code title="post /v1/devboxes/{id}">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">update</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_update_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>
 - <code title="get /v1/devboxes">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">list</a>(\*\*<a href="src/runloop_api_client/types/devbox_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_view.py">SyncDevboxesCursorIDPage[DevboxView]</a></code>
+- <code title="post /v1/devboxes/{id}/create_pty_tunnel">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">create_pty_tunnel</a>(id) -> <a href="./src/runloop_api_client/types/pty_tunnel_view.py">PtyTunnelView</a></code>
 - <code title="post /v1/devboxes/{id}/create_ssh_key">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">create_ssh_key</a>(id) -> <a href="./src/runloop_api_client/types/devbox_create_ssh_key_response.py">DevboxCreateSSHKeyResponse</a></code>
 - <code title="post /v1/devboxes/disk_snapshots/{id}/delete">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">delete_disk_snapshot</a>(id) -> object</code>
 - <code title="post /v1/devboxes/{id}/download_file">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">download_file</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_download_file_params.py">params</a>) -> BinaryAPIResponse</code>
@@ -278,6 +280,19 @@ Methods:
 - <code title="get /v1/devboxes/{devbox_id}/executions/{execution_id}/stream_stderr_updates">client.devboxes.executions.<a href="./src/runloop_api_client/resources/devboxes/executions.py">stream_stderr_updates</a>(execution_id, \*, devbox_id, \*\*<a href="src/runloop_api_client/types/devboxes/execution_stream_stderr_updates_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devboxes/execution_update_chunk.py">ExecutionUpdateChunk</a></code>
 - <code title="get /v1/devboxes/{devbox_id}/executions/{execution_id}/stream_stdout_updates">client.devboxes.executions.<a href="./src/runloop_api_client/resources/devboxes/executions.py">stream_stdout_updates</a>(execution_id, \*, devbox_id, \*\*<a href="src/runloop_api_client/types/devboxes/execution_stream_stdout_updates_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devboxes/execution_update_chunk.py">ExecutionUpdateChunk</a></code>
 
+# Pty
+
+Types:
+
+```python
+from runloop_api_client.types import PtyConnectView, PtyControlParams, PtyControlResultView
+```
+
+Methods:
+
+- <code title="get /pty/{session_name}">client.pty.<a href="./src/runloop_api_client/resources/pty.py">connect</a>(session_name, \*\*<a href="src/runloop_api_client/types/pty_connect_params.py">params</a>) -> <a href="./src/runloop_api_client/types/pty_connect_view.py">PtyConnectView</a></code>
+- <code title="post /pty/{session_name}/control">client.pty.<a href="./src/runloop_api_client/resources/pty.py">control</a>(session_name, \*\*<a href="src/runloop_api_client/types/pty_control_params.py">params</a>) -> <a href="./src/runloop_api_client/types/pty_control_result_view.py">PtyControlResultView</a></code>
+
 # Scenarios
 
 Types:

{runloop_api_client-1.20.3 → runloop_api_client-1.21.0}/pyproject.toml

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

{runloop_api_client-1.20.3 → runloop_api_client-1.21.0}/src/runloop_api_client/_client.py

@@ -36,6 +36,7 @@ from ._base_client import (
 
 if TYPE_CHECKING:
     from .resources import (
+        pty,
         axons,
         agents,
         apikeys,
@@ -52,6 +53,7 @@ if TYPE_CHECKING:
         restricted_keys,
         network_policies,
     )
+    from .resources.pty import PtyResource, AsyncPtyResource
     from .resources.agents import AgentsResource, AsyncAgentsResource
     from .resources.apikeys import ApikeysResource, AsyncApikeysResource
     from .resources.objects import ObjectsResource, AsyncObjectsResource
@@ -184,6 +186,12 @@ class Runloop(SyncAPIClient):
 
         return DevboxesResource(self)
 
+    @cached_property
+    def pty(self) -> PtyResource:
+        from .resources.pty import PtyResource
+
+        return PtyResource(self)
+
     @cached_property
     def scenarios(self) -> ScenariosResource:
         from .resources.scenarios import ScenariosResource
@@ -466,6 +474,12 @@ class AsyncRunloop(AsyncAPIClient):
 
         return AsyncDevboxesResource(self)
 
+    @cached_property
+    def pty(self) -> AsyncPtyResource:
+        from .resources.pty import AsyncPtyResource
+
+        return AsyncPtyResource(self)
+
     @cached_property
     def scenarios(self) -> AsyncScenariosResource:
         from .resources.scenarios import AsyncScenariosResource
@@ -683,6 +697,12 @@ class RunloopWithRawResponse:
 
         return DevboxesResourceWithRawResponse(self._client.devboxes)
 
+    @cached_property
+    def pty(self) -> pty.PtyResourceWithRawResponse:
+        from .resources.pty import PtyResourceWithRawResponse
+
+        return PtyResourceWithRawResponse(self._client.pty)
+
     @cached_property
     def scenarios(self) -> scenarios.ScenariosResourceWithRawResponse:
         from .resources.scenarios import ScenariosResourceWithRawResponse
@@ -780,6 +800,12 @@ class AsyncRunloopWithRawResponse:
 
         return AsyncDevboxesResourceWithRawResponse(self._client.devboxes)
 
+    @cached_property
+    def pty(self) -> pty.AsyncPtyResourceWithRawResponse:
+        from .resources.pty import AsyncPtyResourceWithRawResponse
+
+        return AsyncPtyResourceWithRawResponse(self._client.pty)
+
     @cached_property
     def scenarios(self) -> scenarios.AsyncScenariosResourceWithRawResponse:
         from .resources.scenarios import AsyncScenariosResourceWithRawResponse
@@ -877,6 +903,12 @@ class RunloopWithStreamedResponse:
 
         return DevboxesResourceWithStreamingResponse(self._client.devboxes)
 
+    @cached_property
+    def pty(self) -> pty.PtyResourceWithStreamingResponse:
+        from .resources.pty import PtyResourceWithStreamingResponse
+
+        return PtyResourceWithStreamingResponse(self._client.pty)
+
     @cached_property
     def scenarios(self) -> scenarios.ScenariosResourceWithStreamingResponse:
         from .resources.scenarios import ScenariosResourceWithStreamingResponse
@@ -974,6 +1006,12 @@ class AsyncRunloopWithStreamedResponse:
 
         return AsyncDevboxesResourceWithStreamingResponse(self._client.devboxes)
 
+    @cached_property
+    def pty(self) -> pty.AsyncPtyResourceWithStreamingResponse:
+        from .resources.pty import AsyncPtyResourceWithStreamingResponse
+
+        return AsyncPtyResourceWithStreamingResponse(self._client.pty)
+
     @cached_property
     def scenarios(self) -> scenarios.AsyncScenariosResourceWithStreamingResponse:
         from .resources.scenarios import AsyncScenariosResourceWithStreamingResponse

{runloop_api_client-1.20.3 → runloop_api_client-1.21.0}/src/runloop_api_client/_files.py

@@ -99,7 +99,7 @@ async def async_to_httpx_files(files: RequestFiles | None) -> HttpxRequestFiles
     elif is_sequence_t(files):
         files = [(key, await _async_transform_file(file)) for key, file in files]
     else:
-        raise TypeError("Unexpected file type input {type(files)}, expected mapping or sequence")
+        raise TypeError(f"Unexpected file type input {type(files)}, expected mapping or sequence")
 
     return files
 

{runloop_api_client-1.20.3 → runloop_api_client-1.21.0}/src/runloop_api_client/_models.py

@@ -25,7 +25,9 @@ from typing_extensions import (
     ClassVar,
     Protocol,
     Required,
+    Annotated,
     ParamSpec,
+    TypeAlias,
     TypedDict,
     TypeGuard,
     final,
@@ -79,7 +81,15 @@ from ._compat import (
 from ._constants import RAW_RESPONSE_HEADER
 
 if TYPE_CHECKING:
+    from pydantic import GetCoreSchemaHandler, ValidatorFunctionWrapHandler
+    from pydantic_core import CoreSchema, core_schema
     from pydantic_core.core_schema import ModelField, ModelSchema, LiteralSchema, ModelFieldsSchema
+else:
+    try:
+        from pydantic_core import CoreSchema, core_schema
+    except ImportError:
+        CoreSchema = None
+        core_schema = None
 
 __all__ = ["BaseModel", "GenericModel"]
 
@@ -396,6 +406,76 @@ class BaseModel(pydantic.BaseModel):
             )
 
 
+class _EagerIterable(list[_T], Generic[_T]):
+    """
+    Accepts any Iterable[T] input (including generators), consumes it
+    eagerly, and validates all items upfront.
+
+    Validation preserves the original container type where possible
+    (e.g. a set[T] stays a set[T]).  Serialization (model_dump / JSON)
+    always emits a list — round-tripping through model_dump() will not
+    restore the original container type.
+    """
+
+    @classmethod
+    def __get_pydantic_core_schema__(
+        cls,
+        source_type: Any,
+        handler: GetCoreSchemaHandler,
+    ) -> CoreSchema:
+        (item_type,) = get_args(source_type) or (Any,)
+        item_schema: CoreSchema = handler.generate_schema(item_type)
+        list_of_items_schema: CoreSchema = core_schema.list_schema(item_schema)
+
+        return core_schema.no_info_wrap_validator_function(
+            cls._validate,
+            list_of_items_schema,
+            serialization=core_schema.plain_serializer_function_ser_schema(
+                cls._serialize,
+                info_arg=False,
+            ),
+        )
+
+    @staticmethod
+    def _validate(v: Iterable[_T], handler: "ValidatorFunctionWrapHandler") -> Any:
+        original_type: type[Any] = type(v)
+
+        # Normalize to list so list_schema can validate each item
+        if isinstance(v, list):
+            items: list[_T] = v
+        else:
+            try:
+                items = list(v)
+            except TypeError as e:
+                raise TypeError("Value is not iterable") from e
+
+        # Validate items against the inner schema
+        validated: list[_T] = handler(items)
+
+        # Reconstruct original container type
+        if original_type is list:
+            return validated
+        # str(list) produces the list's repr, not a string built from items,
+        # so skip reconstruction for str and its subclasses.
+        if issubclass(original_type, str):
+            return validated
+        try:
+            return original_type(validated)
+        except (TypeError, ValueError):
+            # If the type cannot be reconstructed, just return the validated list
+            return validated
+
+    @staticmethod
+    def _serialize(v: Iterable[_T]) -> list[_T]:
+        """Always serialize as a list so Pydantic's JSON encoder is happy."""
+        if isinstance(v, list):
+            return v
+        return list(v)
+
+
+EagerIterable: TypeAlias = Annotated[Iterable[_T], _EagerIterable]
+
+
 def _construct_field(value: object, field: FieldInfo, key: str) -> object:
     if value is None:
         return field_get_default(field)

{runloop_api_client-1.20.3 → runloop_api_client-1.21.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__ = "1.20.3"  # x-release-please-version
+__version__ = "1.21.0"  # x-release-please-version

{runloop_api_client-1.20.3 → runloop_api_client-1.21.0}/src/runloop_api_client/resources/__init__.py

@@ -1,5 +1,13 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from .pty import (
+    PtyResource,
+    AsyncPtyResource,
+    PtyResourceWithRawResponse,
+    AsyncPtyResourceWithRawResponse,
+    PtyResourceWithStreamingResponse,
+    AsyncPtyResourceWithStreamingResponse,
+)
 from .axons import (
     AxonsResource,
     AsyncAxonsResource,
@@ -164,6 +172,12 @@ __all__ = [
     "AsyncDevboxesResourceWithRawResponse",
     "DevboxesResourceWithStreamingResponse",
     "AsyncDevboxesResourceWithStreamingResponse",
+    "PtyResource",
+    "AsyncPtyResource",
+    "PtyResourceWithRawResponse",
+    "AsyncPtyResourceWithRawResponse",
+    "PtyResourceWithStreamingResponse",
+    "AsyncPtyResourceWithStreamingResponse",
     "ScenariosResource",
     "AsyncScenariosResource",
     "ScenariosResourceWithRawResponse",

{runloop_api_client-1.20.3 → runloop_api_client-1.21.0}/src/runloop_api_client/resources/devboxes/devboxes.py

@@ -86,6 +86,7 @@ from ...lib.polling_async import async_poll_until
 from ...types.devbox_view import DevboxView
 from ...types.tunnel_view import TunnelView
 from ...lib.wait_for_status import wait_for_status, async_wait_for_status
+from ...types.pty_tunnel_view import PtyTunnelView
 from ...types.shared_params.mount import Mount
 from ...types.devbox_snapshot_view import DevboxSnapshotView
 from ...types.shared.launch_parameters import LaunchParameters as SharedLaunchParameters
@@ -582,6 +583,50 @@ class DevboxesResource(SyncAPIResource):
             model=DevboxView,
         )
 
+    def create_pty_tunnel(
+        self,
+        id: str,
+        *,
+        # 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
+    ) -> PtyTunnelView:
+        """Create an ephemeral authenticated tunnel for terminal access to a running
+        Devbox.
+
+        This tunnel is not persisted on the Devbox and is generated fresh on
+        each request. The returned auth_token must be passed as a Bearer token in the
+        Authorization header.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._post(
+            path_template("/v1/devboxes/{id}/create_pty_tunnel", id=id),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=PtyTunnelView,
+        )
+
     def create_ssh_key(
         self,
         id: str,
@@ -2200,6 +2245,50 @@ class AsyncDevboxesResource(AsyncAPIResource):
             model=DevboxView,
         )
 
+    async def create_pty_tunnel(
+        self,
+        id: str,
+        *,
+        # 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
+    ) -> PtyTunnelView:
+        """Create an ephemeral authenticated tunnel for terminal access to a running
+        Devbox.
+
+        This tunnel is not persisted on the Devbox and is generated fresh on
+        each request. The returned auth_token must be passed as a Bearer token in the
+        Authorization header.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._post(
+            path_template("/v1/devboxes/{id}/create_pty_tunnel", id=id),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=PtyTunnelView,
+        )
+
     async def create_ssh_key(
         self,
         id: str,
@@ -3375,6 +3464,9 @@ class DevboxesResourceWithRawResponse:
         self.list = to_raw_response_wrapper(
             devboxes.list,
         )
+        self.create_pty_tunnel = to_raw_response_wrapper(
+            devboxes.create_pty_tunnel,
+        )
         self.create_ssh_key = to_raw_response_wrapper(
             devboxes.create_ssh_key,
         )
@@ -3468,6 +3560,9 @@ class AsyncDevboxesResourceWithRawResponse:
         self.list = async_to_raw_response_wrapper(
             devboxes.list,
         )
+        self.create_pty_tunnel = async_to_raw_response_wrapper(
+            devboxes.create_pty_tunnel,
+        )
         self.create_ssh_key = async_to_raw_response_wrapper(
             devboxes.create_ssh_key,
         )
@@ -3561,6 +3656,9 @@ class DevboxesResourceWithStreamingResponse:
         self.list = to_streamed_response_wrapper(
             devboxes.list,
         )
+        self.create_pty_tunnel = to_streamed_response_wrapper(
+            devboxes.create_pty_tunnel,
+        )
         self.create_ssh_key = to_streamed_response_wrapper(
             devboxes.create_ssh_key,
         )
@@ -3654,6 +3752,9 @@ class AsyncDevboxesResourceWithStreamingResponse:
         self.list = async_to_streamed_response_wrapper(
             devboxes.list,
         )
+        self.create_pty_tunnel = async_to_streamed_response_wrapper(
+            devboxes.create_pty_tunnel,
+        )
         self.create_ssh_key = async_to_streamed_response_wrapper(
             devboxes.create_ssh_key,
         )