runloop_api_client 1.28.0__tar.gz → 1.30.0__tar.gz

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

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

{runloop_api_client-1.28.0 → runloop_api_client-1.30.0}/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 1.30.0 (2026-08-20)
+
+Full Changelog: [v1.29.0...v1.30.0](https://github.com/runloopai/api-client-python/compare/v1.29.0...v1.30.0)
+
+### Features
+
+* **devboxes:** use optimistic create endpoint ([#829](https://github.com/runloopai/api-client-python/issues/829)) ([3f47b22](https://github.com/runloopai/api-client-python/commit/3f47b2256189b1aca4c4137134df2643dd3d7ca5))
+
+
+### Chores
+
+* **internal:** allow the mock server port to be set with STAINLESS_MOCK_PORT ([b7a3d87](https://github.com/runloopai/api-client-python/commit/b7a3d87997538ff6d4658df77d68177f83811eb3))
+
+## 1.29.0 (2026-08-20)
+
+Full Changelog: [v1.28.0...v1.29.0](https://github.com/runloopai/api-client-python/compare/v1.28.0...v1.29.0)
+
+### Features
+
+* **axon:** add registry delete endpoint ([#10769](https://github.com/runloopai/api-client-python/issues/10769)) ([c63f011](https://github.com/runloopai/api-client-python/commit/c63f01108d98785b358357e4e65e5e517dd0805e))
+* **broker:** plumb Pi protocol selection ([#10256](https://github.com/runloopai/api-client-python/issues/10256)) ([974d52b](https://github.com/runloopai/api-client-python/commit/974d52b8743ceda8a7127e3a3432ce51e71b1bfd))
+* **config:** custom_headers on McpConfig/GatewayConfig — persistence, REST, validation, provisioner, OpenAPI ([#11096](https://github.com/runloopai/api-client-python/issues/11096)) ([9482e47](https://github.com/runloopai/api-client-python/commit/9482e475d0ad6e2b1989ee25f66a759fe839065f))
+* **converter:** add Helm chart, container image, and enable in dev ([#10405](https://github.com/runloopai/api-client-python/issues/10405)) ([0d5ca34](https://github.com/runloopai/api-client-python/commit/0d5ca3438ac4cbcafdfaf7584042bd78a956e3ae))
+* **devbox:** recover resume provisioning failures ([#10597](https://github.com/runloopai/api-client-python/issues/10597)) ([518301e](https://github.com/runloopai/api-client-python/commit/518301e444b95bc5fa73cc0f13be67cf3f750024))
+* **gateway:** first-class BASIC auth mechanism ([#11063](https://github.com/runloopai/api-client-python/issues/11063)) ([1f50f93](https://github.com/runloopai/api-client-python/commit/1f50f93c26c6696d2a9f81b1b677eb9b7282601a))
+* **mcp:** configurable auth_mechanism on McpConfig, shared shape with gateway ([#11113](https://github.com/runloopai/api-client-python/issues/11113)) ([4dd9edd](https://github.com/runloopai/api-client-python/commit/4dd9edd5abbdfab0466826db8d18cbd2efae7b31))
+
+
+### Bug Fixes
+
+* **devbox:** make Devbox update API patch-like ([#10582](https://github.com/runloopai/api-client-python/issues/10582)) ([0a74521](https://github.com/runloopai/api-client-python/commit/0a7452145ee6d1689d8635e65f88b8f778a84820))
+* **gateway:** reject keyless HEADER auth_mechanism at admission and in looper ([#11120](https://github.com/runloopai/api-client-python/issues/11120)) ([194c060](https://github.com/runloopai/api-client-python/commit/194c060f4c95a85d895fc4e0d701e48b5222646c))
+
 ## 1.28.0 (2026-07-29)
 
 Full Changelog: [v1.27.0...v1.28.0](https://github.com/runloopai/api-client-python/compare/v1.27.0...v1.28.0)

{runloop_api_client-1.28.0 → runloop_api_client-1.30.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.28.0
+Version: 1.30.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.28.0 → runloop_api_client-1.30.0}/api.md

@@ -5,8 +5,10 @@ from runloop_api_client.types import (
     AfterIdle,
     AgentMount,
     AgentSource,
+    AuthMechanism,
     BrokerMount,
     CodeMountParameters,
+    CustomHeader,
     LaunchParameters,
     LifecycleConfiguration,
     LifecycleHooks,
@@ -131,6 +133,7 @@ Methods:
 - <code title="post /v1/axons">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">create</a>(\*\*<a href="src/runloop_api_client/types/axon_create_params.py">params</a>) -> <a href="./src/runloop_api_client/types/axon_view.py">AxonView</a></code>
 - <code title="get /v1/axons/{id}">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">retrieve</a>(id) -> <a href="./src/runloop_api_client/types/axon_view.py">AxonView</a></code>
 - <code title="get /v1/axons">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">list</a>(\*\*<a href="src/runloop_api_client/types/axon_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/axon_view.py">SyncAxonsCursorIDPage[AxonView]</a></code>
+- <code title="delete /v1/axons/{id}">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">delete</a>(id) -> object</code>
 - <code title="post /v1/axons/{id}/publish">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">publish</a>(id, \*\*<a href="src/runloop_api_client/types/axon_publish_params.py">params</a>) -> <a href="./src/runloop_api_client/types/publish_result_view.py">PublishResultView</a></code>
 - <code title="get /v1/axons/{id}/subscribe/sse">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">subscribe_sse</a>(id, \*\*<a href="src/runloop_api_client/types/axon_subscribe_sse_params.py">params</a>) -> <a href="./src/runloop_api_client/types/axon_event_view.py">AxonEventView</a></code>
 

{runloop_api_client-1.28.0 → runloop_api_client-1.30.0}/pyproject.toml

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

{runloop_api_client-1.28.0 → runloop_api_client-1.30.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.28.0"  # x-release-please-version
+__version__ = "1.30.0"  # x-release-please-version

{runloop_api_client-1.28.0 → runloop_api_client-1.30.0}/src/runloop_api_client/resources/axons/axons.py

@@ -210,6 +210,46 @@ class AxonsResource(SyncAPIResource):
             model=AxonView,
         )
 
+    def delete(
+        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,
+    ) -> object:
+        """
+        [Beta] Mark an axon deleted.
+
+        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._delete(
+            path_template("/v1/axons/{id}", 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=object,
+        )
+
     def publish(
         self,
         id: str,
@@ -485,6 +525,46 @@ class AsyncAxonsResource(AsyncAPIResource):
             model=AxonView,
         )
 
+    async def delete(
+        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,
+    ) -> object:
+        """
+        [Beta] Mark an axon deleted.
+
+        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._delete(
+            path_template("/v1/axons/{id}", 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=object,
+        )
+
     async def publish(
         self,
         id: str,
@@ -607,6 +687,9 @@ class AxonsResourceWithRawResponse:
         self.list = to_raw_response_wrapper(
             axons.list,
         )
+        self.delete = to_raw_response_wrapper(
+            axons.delete,
+        )
         self.publish = to_raw_response_wrapper(
             axons.publish,
         )
@@ -636,6 +719,9 @@ class AsyncAxonsResourceWithRawResponse:
         self.list = async_to_raw_response_wrapper(
             axons.list,
         )
+        self.delete = async_to_raw_response_wrapper(
+            axons.delete,
+        )
         self.publish = async_to_raw_response_wrapper(
             axons.publish,
         )
@@ -665,6 +751,9 @@ class AxonsResourceWithStreamingResponse:
         self.list = to_streamed_response_wrapper(
             axons.list,
         )
+        self.delete = to_streamed_response_wrapper(
+            axons.delete,
+        )
         self.publish = to_streamed_response_wrapper(
             axons.publish,
         )
@@ -694,6 +783,9 @@ class AsyncAxonsResourceWithStreamingResponse:
         self.list = async_to_streamed_response_wrapper(
             axons.list,
         )
+        self.delete = async_to_streamed_response_wrapper(
+            axons.delete,
+        )
         self.publish = async_to_streamed_response_wrapper(
             axons.publish,
         )

{runloop_api_client-1.28.0 → runloop_api_client-1.30.0}/src/runloop_api_client/resources/devboxes/devboxes.py

@@ -338,14 +338,17 @@ class DevboxesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> DevboxView:
-        """
-        Updates a devbox by doing a complete update the existing name,metadata fields.
-        It does not patch partial values.
+        """Updates the specified Devbox fields.
+
+        Omitted fields are left unchanged. An empty
+        name clears the name, and an empty metadata map clears the metadata.
 
         Args:
-          metadata: User defined metadata to attach to the devbox for organization.
+          metadata: User defined metadata to replace the Devbox metadata. Omit to leave unchanged or
+              set to an empty map to clear it.
 
-          name: (Optional) A user specified name to give the Devbox.
+          name: A user specified name to give the Devbox. Omit to leave unchanged or set to an
+              empty string to clear it.
 
           extra_headers: Send extra headers
 
@@ -497,30 +500,41 @@ class DevboxesResource(SyncAPIResource):
             PollingTimeout: If polling times out before devbox is running
             RunloopError: If devbox enters a non-running terminal state
         """
-        # Pass all create_args to the underlying create method
-        devbox = self.create(
-            blueprint_id=blueprint_id,
-            blueprint_name=blueprint_name,
-            code_mounts=code_mounts,
-            entrypoint=entrypoint,
-            environment_variables=environment_variables,
-            file_mounts=file_mounts,
-            gateways=gateways,
-            launch_parameters=launch_parameters,
-            mcp=mcp,
-            metadata=metadata,
-            mounts=mounts,
-            name=name,
-            secrets=secrets,
-            snapshot_id=snapshot_id,
-            tunnel=tunnel,
-            extra_headers=extra_headers,
-            extra_query=extra_query,
-            extra_body=extra_body,
-            timeout=timeout,
-            idempotency_key=idempotency_key,
+        devbox = self._post(
+            "/v1/devboxes/create_and_await_running",
+            body=maybe_transform(
+                {
+                    "blueprint_id": blueprint_id,
+                    "blueprint_name": blueprint_name,
+                    "code_mounts": code_mounts,
+                    "entrypoint": entrypoint,
+                    "environment_variables": environment_variables,
+                    "file_mounts": file_mounts,
+                    "gateways": gateways,
+                    "launch_parameters": launch_parameters,
+                    "mcp": mcp,
+                    "metadata": metadata,
+                    "mounts": mounts,
+                    "name": name,
+                    "secrets": secrets,
+                    "snapshot_id": snapshot_id,
+                    "tunnel": tunnel,
+                },
+                devbox_create_params.DevboxCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=DevboxView,
         )
 
+        if devbox.status == "running":
+            return devbox
+
         return self.await_running(
             devbox.id,
             polling_config=polling_config,
@@ -2068,30 +2082,41 @@ class AsyncDevboxesResource(AsyncAPIResource):
             RunloopError: If devbox enters a non-running terminal state
         """
 
-        # Pass all create_args, relevant request args to the underlying create method
-        devbox = await self.create(
-            blueprint_id=blueprint_id,
-            blueprint_name=blueprint_name,
-            code_mounts=code_mounts,
-            entrypoint=entrypoint,
-            environment_variables=environment_variables,
-            file_mounts=file_mounts,
-            gateways=gateways,
-            launch_parameters=launch_parameters,
-            mcp=mcp,
-            metadata=metadata,
-            mounts=mounts,
-            name=name,
-            secrets=secrets,
-            snapshot_id=snapshot_id,
-            tunnel=tunnel,
-            extra_headers=extra_headers,
-            extra_query=extra_query,
-            extra_body=extra_body,
-            timeout=timeout,
-            idempotency_key=idempotency_key,
+        devbox = await self._post(
+            "/v1/devboxes/create_and_await_running",
+            body=await async_maybe_transform(
+                {
+                    "blueprint_id": blueprint_id,
+                    "blueprint_name": blueprint_name,
+                    "code_mounts": code_mounts,
+                    "entrypoint": entrypoint,
+                    "environment_variables": environment_variables,
+                    "file_mounts": file_mounts,
+                    "gateways": gateways,
+                    "launch_parameters": launch_parameters,
+                    "mcp": mcp,
+                    "metadata": metadata,
+                    "mounts": mounts,
+                    "name": name,
+                    "secrets": secrets,
+                    "snapshot_id": snapshot_id,
+                    "tunnel": tunnel,
+                },
+                devbox_create_params.DevboxCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=DevboxView,
         )
 
+        if devbox.status == "running":
+            return devbox
+
         return await self.await_running(
             devbox.id,
             polling_config=polling_config,
@@ -2188,14 +2213,17 @@ class AsyncDevboxesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> DevboxView:
-        """
-        Updates a devbox by doing a complete update the existing name,metadata fields.
-        It does not patch partial values.
+        """Updates the specified Devbox fields.
+
+        Omitted fields are left unchanged. An empty
+        name clears the name, and an empty metadata map clears the metadata.
 
         Args:
-          metadata: User defined metadata to attach to the devbox for organization.
+          metadata: User defined metadata to replace the Devbox metadata. Omit to leave unchanged or
+              set to an empty map to clear it.
 
-          name: (Optional) A user specified name to give the Devbox.
+          name: A user specified name to give the Devbox. Omit to leave unchanged or set to an
+              empty string to clear it.
 
           extra_headers: Send extra headers
 

{runloop_api_client-1.28.0 → runloop_api_client-1.30.0}/src/runloop_api_client/resources/gateway_configs.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Iterable, Optional
 
 import httpx
 
@@ -20,6 +20,8 @@ from .._response import (
 from ..pagination import SyncGatewayConfigsCursorIDPage, AsyncGatewayConfigsCursorIDPage
 from .._base_client import AsyncPaginator, make_request_options
 from ..types.gateway_config_view import GatewayConfigView
+from ..types.shared_params.custom_header import CustomHeader
+from ..types.shared_params.auth_mechanism import AuthMechanism
 
 __all__ = ["GatewayConfigsResource", "AsyncGatewayConfigsResource"]
 
@@ -47,9 +49,10 @@ class GatewayConfigsResource(SyncAPIResource):
     def create(
         self,
         *,
-        auth_mechanism: gateway_config_create_params.AuthMechanism,
+        auth_mechanism: AuthMechanism,
         endpoint: str,
         name: str,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: Optional[str] | Omit = omit,
         # 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.
@@ -73,6 +76,9 @@ class GatewayConfigsResource(SyncAPIResource):
           name: The human-readable name for the GatewayConfig. Must be unique within your
               account.
 
+          custom_headers: Additional headers applied to proxied requests after the auth mechanism. At most
+              8 entries.
+
           description: Optional description for this gateway configuration.
 
           extra_headers: Send extra headers
@@ -92,6 +98,7 @@ class GatewayConfigsResource(SyncAPIResource):
                     "auth_mechanism": auth_mechanism,
                     "endpoint": endpoint,
                     "name": name,
+                    "custom_headers": custom_headers,
                     "description": description,
                 },
                 gateway_config_create_params.GatewayConfigCreateParams,
@@ -143,7 +150,8 @@ class GatewayConfigsResource(SyncAPIResource):
         self,
         id: str,
         *,
-        auth_mechanism: Optional[gateway_config_update_params.AuthMechanism] | Omit = omit,
+        auth_mechanism: Optional[AuthMechanism] | Omit = omit,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: Optional[str] | Omit = omit,
         endpoint: Optional[str] | Omit = omit,
         name: Optional[str] | Omit = omit,
@@ -160,8 +168,11 @@ class GatewayConfigsResource(SyncAPIResource):
         All fields are optional.
 
         Args:
-          auth_mechanism: Defines how credentials are applied to HTTP requests when proxying through the
-              gateway.
+          auth_mechanism: Defines how the primary credential is applied to requests proxied to the
+              upstream.
+
+          custom_headers: New list of additional headers. Replaces the existing list entirely; use an
+              empty list to clear all custom headers. At most 8 entries.
 
           description: New description for this gateway configuration.
 
@@ -186,6 +197,7 @@ class GatewayConfigsResource(SyncAPIResource):
             body=maybe_transform(
                 {
                     "auth_mechanism": auth_mechanism,
+                    "custom_headers": custom_headers,
                     "description": description,
                     "endpoint": endpoint,
                     "name": name,
@@ -332,9 +344,10 @@ class AsyncGatewayConfigsResource(AsyncAPIResource):
     async def create(
         self,
         *,
-        auth_mechanism: gateway_config_create_params.AuthMechanism,
+        auth_mechanism: AuthMechanism,
         endpoint: str,
         name: str,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: Optional[str] | Omit = omit,
         # 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.
@@ -358,6 +371,9 @@ class AsyncGatewayConfigsResource(AsyncAPIResource):
           name: The human-readable name for the GatewayConfig. Must be unique within your
               account.
 
+          custom_headers: Additional headers applied to proxied requests after the auth mechanism. At most
+              8 entries.
+
           description: Optional description for this gateway configuration.
 
           extra_headers: Send extra headers
@@ -377,6 +393,7 @@ class AsyncGatewayConfigsResource(AsyncAPIResource):
                     "auth_mechanism": auth_mechanism,
                     "endpoint": endpoint,
                     "name": name,
+                    "custom_headers": custom_headers,
                     "description": description,
                 },
                 gateway_config_create_params.GatewayConfigCreateParams,
@@ -428,7 +445,8 @@ class AsyncGatewayConfigsResource(AsyncAPIResource):
         self,
         id: str,
         *,
-        auth_mechanism: Optional[gateway_config_update_params.AuthMechanism] | Omit = omit,
+        auth_mechanism: Optional[AuthMechanism] | Omit = omit,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: Optional[str] | Omit = omit,
         endpoint: Optional[str] | Omit = omit,
         name: Optional[str] | Omit = omit,
@@ -445,8 +463,11 @@ class AsyncGatewayConfigsResource(AsyncAPIResource):
         All fields are optional.
 
         Args:
-          auth_mechanism: Defines how credentials are applied to HTTP requests when proxying through the
-              gateway.
+          auth_mechanism: Defines how the primary credential is applied to requests proxied to the
+              upstream.
+
+          custom_headers: New list of additional headers. Replaces the existing list entirely; use an
+              empty list to clear all custom headers. At most 8 entries.
 
           description: New description for this gateway configuration.
 
@@ -471,6 +492,7 @@ class AsyncGatewayConfigsResource(AsyncAPIResource):
             body=await async_maybe_transform(
                 {
                     "auth_mechanism": auth_mechanism,
+                    "custom_headers": custom_headers,
                     "description": description,
                     "endpoint": endpoint,
                     "name": name,