runloop_api_client 1.18.1__tar.gz → 1.20.0__tar.gz

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

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

{runloop_api_client-1.18.1 → runloop_api_client-1.20.0}/CHANGELOG.md

@@ -1,5 +1,47 @@
 # Changelog
 
+## 1.20.0 (2026-04-21)
+
+Full Changelog: [v1.19.0...v1.20.0](https://github.com/runloopai/api-client-python/compare/v1.19.0...v1.20.0)
+
+### Features
+
+* add OO SDK support for new Agent API calls ([#786](https://github.com/runloopai/api-client-python/issues/786)) ([6197567](https://github.com/runloopai/api-client-python/commit/6197567bee84193beca7699b8616b46479607510))
+* **axon:** add working directory / directory to launch agent ([#8689](https://github.com/runloopai/api-client-python/issues/8689)) ([2097995](https://github.com/runloopai/api-client-python/commit/2097995f63b3e4334c6e6edb7d1c915f5447a9c9))
+
+
+### Performance Improvements
+
+* **client:** optimize file structure copying in multipart requests ([64f27ad](https://github.com/runloopai/api-client-python/commit/64f27adfc44ef5242b19637377c50073c8240538))
+
+
+### Chores
+
+* **tests:** bump steady to v0.22.1 ([c72f34d](https://github.com/runloopai/api-client-python/commit/c72f34dca3653010eb76a762a68519c996e74860))
+
+## 1.19.0 (2026-04-13)
+
+Full Changelog: [v1.18.1...v1.19.0](https://github.com/runloopai/api-client-python/compare/v1.18.1...v1.19.0)
+
+### Features
+
+* Add wake on axon event as an API primitive ([#8681](https://github.com/runloopai/api-client-python/issues/8681)) ([255099a](https://github.com/runloopai/api-client-python/commit/255099a940a7892f3c66e6534517e3545d7daccb))
+* Allow API keys to create API and restricted keys ([#8663](https://github.com/runloopai/api-client-python/issues/8663)) ([2e03b55](https://github.com/runloopai/api-client-python/commit/2e03b55638a83a8354481f47a30910e94ff57fc3))
+
+
+### Bug Fixes
+
+* add missing agent API paths to stainless config ([#8699](https://github.com/runloopai/api-client-python/issues/8699)) ([4f6fe60](https://github.com/runloopai/api-client-python/commit/4f6fe60a63fd31c049e54febb81801031dce2325))
+* ensure file data are only sent as 1 parameter ([f7ca2cc](https://github.com/runloopai/api-client-python/commit/f7ca2cc280f1e7a4ab73f331be8fe3e33ae1c611))
+
+
+### Documentation
+
+* add snapshot, suspend & resume example ([#764](https://github.com/runloopai/api-client-python/issues/764)) ([f4b942b](https://github.com/runloopai/api-client-python/commit/f4b942b3329e98a4ea5182c04d6db90fd0b70308))
+* added Async vs Sync tabs, removed top-level class descriptions ([#783](https://github.com/runloopai/api-client-python/issues/783)) ([6a99c56](https://github.com/runloopai/api-client-python/commit/6a99c569914d93e07087ed5003ee7c77f2ab88ff))
+* restructure sphinx docs with async-first API reference and full type coverage ([#782](https://github.com/runloopai/api-client-python/issues/782)) ([514cf93](https://github.com/runloopai/api-client-python/commit/514cf93e8ff8b97bfde171a83cf9abf211193e7f))
+* show full field descriptions for SDK parameter types ([#784](https://github.com/runloopai/api-client-python/issues/784)) ([f04a506](https://github.com/runloopai/api-client-python/commit/f04a5069c33fceb7a4d3db634bfd77ab789314dc))
+
 ## 1.18.1 (2026-04-10)
 
 Full Changelog: [v1.17.0...v1.18.1](https://github.com/runloopai/api-client-python/compare/v1.17.0...v1.18.1)

{runloop_api_client-1.18.1 → runloop_api_client-1.20.0}/EXAMPLES.md

@@ -10,6 +10,7 @@ Runnable examples live in [`examples/`](./examples).
 - [Blueprint with Build Context](#blueprint-with-build-context)
 - [Devbox From Blueprint (Run Command, Shutdown)](#devbox-from-blueprint-lifecycle)
 - [Devbox Snapshot and Resume](#devbox-snapshot-resume)
+- [Devbox Snapshots (Suspend, Resume, Restore, Delete)](#devbox-snapshots)
 - [Devbox Tunnel (HTTP Server Access)](#devbox-tunnel)
 - [MCP Hub + Claude Code + GitHub](#mcp-github-tools)
 - [Secrets with Devbox and Agent Gateway](#secrets-with-devbox)
@@ -106,6 +107,37 @@ uv run pytest -m smoketest tests/smoketests/examples/
 
 **Source:** [`examples/devbox_snapshot_resume.py`](./examples/devbox_snapshot_resume.py)
 
+<a id="devbox-snapshots"></a>
+## Devbox Snapshots (Suspend, Resume, Restore, Delete)
+
+**Use case:** Upload a file to a devbox, preserve it across suspend and resume, create a disk snapshot, restore multiple devboxes from that snapshot, mutate each copy independently, and delete the snapshot when finished.
+
+**Tags:** `devbox`, `snapshot`, `suspend`, `resume`, `files`, `cleanup`
+
+### Workflow
+- Create a source devbox
+- Upload a file and mutate it into a shared baseline
+- Suspend and resume the source devbox
+- Create a disk snapshot from the resumed devbox
+- Restore two additional devboxes from the same snapshot baseline
+- Mutate the same file differently in each devbox to prove isolation
+- Shutdown the devboxes and delete the snapshot
+
+### Prerequisites
+- `RUNLOOP_API_KEY`
+
+### Run
+```sh
+uv run python -m examples.devbox_snapshots
+```
+
+### Test
+```sh
+uv run pytest -m smoketest tests/smoketests/examples/
+```
+
+**Source:** [`examples/devbox_snapshots.py`](./examples/devbox_snapshots.py)
+
 <a id="devbox-tunnel"></a>
 ## Devbox Tunnel (HTTP Server Access)
 

{runloop_api_client-1.18.1 → runloop_api_client-1.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.18.1
+Version: 1.20.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
@@ -325,7 +325,7 @@ 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 for GET requests. For POST requests, only 
+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:

{runloop_api_client-1.18.1 → runloop_api_client-1.20.0}/README.md

@@ -288,7 +288,7 @@ 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 for GET requests. For POST requests, only 
+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:

{runloop_api_client-1.18.1 → runloop_api_client-1.20.0}/api.md

@@ -79,7 +79,12 @@ Methods:
 Types:
 
 ```python
-from runloop_api_client.types import AgentCreateParameters, AgentListView, AgentView
+from runloop_api_client.types import (
+    AgentCreateParameters,
+    AgentDevboxCountsView,
+    AgentListView,
+    AgentView,
+)
 ```
 
 Methods:
@@ -87,6 +92,9 @@ Methods:
 - <code title="post /v1/agents">client.agents.<a href="./src/runloop_api_client/resources/agents.py">create</a>(\*\*<a href="src/runloop_api_client/types/agent_create_params.py">params</a>) -> <a href="./src/runloop_api_client/types/agent_view.py">AgentView</a></code>
 - <code title="get /v1/agents/{id}">client.agents.<a href="./src/runloop_api_client/resources/agents.py">retrieve</a>(id) -> <a href="./src/runloop_api_client/types/agent_view.py">AgentView</a></code>
 - <code title="get /v1/agents">client.agents.<a href="./src/runloop_api_client/resources/agents.py">list</a>(\*\*<a href="src/runloop_api_client/types/agent_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/agent_view.py">SyncAgentsCursorIDPage[AgentView]</a></code>
+- <code title="post /v1/agents/{id}/delete">client.agents.<a href="./src/runloop_api_client/resources/agents.py">delete</a>(id) -> object</code>
+- <code title="get /v1/agents/devbox_counts">client.agents.<a href="./src/runloop_api_client/resources/agents.py">devbox_counts</a>() -> <a href="./src/runloop_api_client/types/agent_devbox_counts_view.py">AgentDevboxCountsView</a></code>
+- <code title="get /v1/agents/list_public">client.agents.<a href="./src/runloop_api_client/resources/agents.py">list_public</a>(\*\*<a href="src/runloop_api_client/types/agent_list_public_params.py">params</a>) -> <a href="./src/runloop_api_client/types/agent_view.py">SyncAgentsCursorIDPage[AgentView]</a></code>
 
 # Axons
 
@@ -439,3 +447,31 @@ Methods:
 - <code title="post /v1/mcp-configs/{id}">client.mcp_configs.<a href="./src/runloop_api_client/resources/mcp_configs.py">update</a>(id, \*\*<a href="src/runloop_api_client/types/mcp_config_update_params.py">params</a>) -> <a href="./src/runloop_api_client/types/mcp_config_view.py">McpConfigView</a></code>
 - <code title="get /v1/mcp-configs">client.mcp_configs.<a href="./src/runloop_api_client/resources/mcp_configs.py">list</a>(\*\*<a href="src/runloop_api_client/types/mcp_config_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/mcp_config_view.py">SyncMcpConfigsCursorIDPage[McpConfigView]</a></code>
 - <code title="post /v1/mcp-configs/{id}/delete">client.mcp_configs.<a href="./src/runloop_api_client/resources/mcp_configs.py">delete</a>(id) -> <a href="./src/runloop_api_client/types/mcp_config_view.py">McpConfigView</a></code>
+
+# Apikeys
+
+Types:
+
+```python
+from runloop_api_client.types import APIKeyCreatedView, APIKeyCreateParameters
+```
+
+Methods:
+
+- <code title="post /v1/apikeys">client.apikeys.<a href="./src/runloop_api_client/resources/apikeys.py">create</a>(\*\*<a href="src/runloop_api_client/types/apikey_create_params.py">params</a>) -> <a href="./src/runloop_api_client/types/api_key_created_view.py">APIKeyCreatedView</a></code>
+
+# RestrictedKeys
+
+Types:
+
+```python
+from runloop_api_client.types import (
+    RestrictedKeyCreatedView,
+    RestrictedKeyCreateParameters,
+    ScopeEntryView,
+)
+```
+
+Methods:
+
+- <code title="post /v1/restricted_keys">client.restricted_keys.<a href="./src/runloop_api_client/resources/restricted_keys.py">create</a>(\*\*<a href="src/runloop_api_client/types/restricted_key_create_params.py">params</a>) -> <a href="./src/runloop_api_client/types/restricted_key_created_view.py">RestrictedKeyCreatedView</a></code>

runloop_api_client-1.20.0/examples/devbox_snapshots.py

@@ -0,0 +1,172 @@
+#!/usr/bin/env -S uv run python
+"""
+---
+title: Devbox Snapshots (Suspend, Resume, Restore, Delete)
+slug: devbox-snapshots
+use_case: Upload a file to a devbox, preserve it across suspend and resume, create a disk snapshot, restore multiple devboxes from that snapshot, mutate each copy independently, and delete the snapshot when finished.
+workflow:
+  - Create a source devbox
+  - Upload a file and mutate it into a shared baseline
+  - Suspend and resume the source devbox
+  - Create a disk snapshot from the resumed devbox
+  - Restore two additional devboxes from the same snapshot baseline
+  - Mutate the same file differently in each devbox to prove isolation
+  - Shutdown the devboxes and delete the snapshot
+tags:
+  - devbox
+  - snapshot
+  - suspend
+  - resume
+  - files
+  - cleanup
+prerequisites:
+  - RUNLOOP_API_KEY
+run: uv run python -m examples.devbox_snapshots
+test: uv run pytest -m smoketest tests/smoketests/examples/
+---
+"""
+
+from __future__ import annotations
+
+import tempfile
+from pathlib import Path
+
+from runloop_api_client import AsyncRunloopSDK
+from runloop_api_client.lib.polling import PollingConfig
+
+from ._harness import run_as_cli, unique_name, wrap_recipe
+from .example_types import ExampleCheck, RecipeOutput, RecipeContext
+
+FILE_PATH = "/tmp/snapshot-demo.txt"
+POLLING_CONFIG = PollingConfig(timeout_seconds=120.0, interval_seconds=5.0)
+
+
+async def recipe(ctx: RecipeContext) -> RecipeOutput:
+    """Demonstrate suspend/resume and shared snapshot restoration with isolated mutations."""
+    cleanup = ctx.cleanup
+    sdk = AsyncRunloopSDK()
+
+    resources_created: list[str] = []
+
+    uploaded_contents = "uploaded-from-local-file"
+    baseline_contents = "baseline-after-upload-and-mutation"
+    source_contents = "source-devbox-after-isolated-mutation"
+    clone_a_contents = "clone-a-after-isolated-mutation"
+    clone_b_contents = "clone-b-after-isolated-mutation"
+
+    with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".txt") as tmp_file:
+        tmp_file.write(uploaded_contents)
+        local_file_path = Path(tmp_file.name)
+    cleanup.add("local-file:snapshot-demo", lambda: local_file_path.unlink(missing_ok=True))
+
+    source_devbox = await sdk.devbox.create(
+        name=unique_name("snapshot-source"),
+        launch_parameters={
+            "resource_size_request": "X_SMALL",
+            "keep_alive_time_seconds": 60 * 5,
+        },
+    )
+    cleanup.add(f"devbox:{source_devbox.id}", source_devbox.shutdown)
+    resources_created.append(f"devbox:{source_devbox.id}")
+
+    await source_devbox.file.upload(path=FILE_PATH, file=local_file_path)
+    uploaded_readback = await source_devbox.file.read(file_path=FILE_PATH)
+
+    await source_devbox.file.write(file_path=FILE_PATH, contents=baseline_contents)
+
+    await source_devbox.suspend()
+    suspended_info = await source_devbox.await_suspended(polling_config=POLLING_CONFIG)
+
+    resumed_info = await source_devbox.resume(polling_config=POLLING_CONFIG)
+    resumed_readback = await source_devbox.file.read(file_path=FILE_PATH)
+
+    snapshot = await source_devbox.snapshot_disk(
+        name=unique_name("snapshot-baseline"),
+        commit_message="Capture the shared baseline after suspend and resume.",
+        polling_config=POLLING_CONFIG,
+    )
+    cleanup.add(f"snapshot:{snapshot.id}", snapshot.delete)
+    resources_created.append(f"snapshot:{snapshot.id}")
+
+    clone_a = await snapshot.create_devbox(
+        name=unique_name("snapshot-clone-a"),
+        launch_parameters={
+            "resource_size_request": "X_SMALL",
+            "keep_alive_time_seconds": 60 * 5,
+        },
+    )
+    cleanup.add(f"devbox:{clone_a.id}", clone_a.shutdown)
+    resources_created.append(f"devbox:{clone_a.id}")
+
+    # clone_a used snapshot.create_devbox(); clone_b uses sdk.devbox.create_from_snapshot()
+    # to demonstrate both entry points for restoring a devbox from a snapshot.
+    clone_b = await sdk.devbox.create_from_snapshot(
+        snapshot.id,
+        name=unique_name("snapshot-clone-b"),
+        launch_parameters={
+            "resource_size_request": "X_SMALL",
+            "keep_alive_time_seconds": 60 * 5,
+        },
+    )
+    cleanup.add(f"devbox:{clone_b.id}", clone_b.shutdown)
+    resources_created.append(f"devbox:{clone_b.id}")
+
+    clone_a_baseline_readback = await clone_a.file.read(file_path=FILE_PATH)
+    clone_b_baseline_readback = await clone_b.file.read(file_path=FILE_PATH)
+
+    await source_devbox.file.write(file_path=FILE_PATH, contents=source_contents)
+    await clone_a.file.write(file_path=FILE_PATH, contents=clone_a_contents)
+    await clone_b.file.write(file_path=FILE_PATH, contents=clone_b_contents)
+
+    source_isolated_readback = await source_devbox.file.read(file_path=FILE_PATH)
+    clone_a_isolated_readback = await clone_a.file.read(file_path=FILE_PATH)
+    clone_b_isolated_readback = await clone_b.file.read(file_path=FILE_PATH)
+
+    return RecipeOutput(
+        resources_created=resources_created,
+        checks=[
+            ExampleCheck(
+                name="uploaded file is readable on the source devbox",
+                passed=uploaded_readback == uploaded_contents,
+                details=uploaded_readback,
+            ),
+            ExampleCheck(
+                name="suspend reaches the suspended state",
+                passed=suspended_info.status == "suspended",
+                details=f"status={suspended_info.status}",
+            ),
+            ExampleCheck(
+                name="resume preserves the baseline file contents",
+                passed=resumed_info.status == "running" and resumed_readback == baseline_contents,
+                details=f"status={resumed_info.status}, contents={resumed_readback}",
+            ),
+            ExampleCheck(
+                name="multiple devboxes can use the same snapshot baseline",
+                passed=(
+                    clone_a_baseline_readback == baseline_contents and clone_b_baseline_readback == baseline_contents
+                ),
+                details=(f"clone_a={clone_a_baseline_readback}, clone_b={clone_b_baseline_readback}"),
+            ),
+            ExampleCheck(
+                name="devboxes diverge after isolated mutations",
+                passed=(
+                    source_isolated_readback == source_contents
+                    and clone_a_isolated_readback == clone_a_contents
+                    and clone_b_isolated_readback == clone_b_contents
+                ),
+                details=(
+                    "source="
+                    f"{source_isolated_readback}, "
+                    f"clone_a={clone_a_isolated_readback}, "
+                    f"clone_b={clone_b_isolated_readback}"
+                ),
+            ),
+        ],
+    )
+
+
+run_devbox_snapshots_example = wrap_recipe(recipe)
+
+
+if __name__ == "__main__":
+    run_as_cli(run_devbox_snapshots_example)

{runloop_api_client-1.18.1 → runloop_api_client-1.20.0}/examples/registry.py

@@ -9,6 +9,7 @@ from typing import Any, Callable, cast
 
 from .devbox_tunnel import run_devbox_tunnel_example
 from .example_types import ExampleResult
+from .devbox_snapshots import run_devbox_snapshots_example
 from .mcp_github_tools import run_mcp_github_tools_example
 from .secrets_with_devbox import run_secrets_with_devbox_example
 from .devbox_snapshot_resume import run_devbox_snapshot_resume_example
@@ -39,6 +40,13 @@ example_registry: list[ExampleRegistryEntry] = [
         "required_env": ["RUNLOOP_API_KEY"],
         "run": run_devbox_snapshot_resume_example,
     },
+    {
+        "slug": "devbox-snapshots",
+        "title": "Devbox Snapshots (Suspend, Resume, Restore, Delete)",
+        "file_name": "devbox_snapshots.py",
+        "required_env": ["RUNLOOP_API_KEY"],
+        "run": run_devbox_snapshots_example,
+    },
     {
         "slug": "devbox-tunnel",
         "title": "Devbox Tunnel (HTTP Server Access)",

{runloop_api_client-1.18.1 → runloop_api_client-1.20.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runloop_api_client"
-version = "1.18.1"
+version = "1.20.0"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"
@@ -72,6 +72,7 @@ docs = [
     "furo>=2025.9.25",
     "sphinx>=7.4.7",
     "sphinx-autodoc-typehints>=2.3.0",
+    "sphinx-tabs>=3.4.0",
     "sphinx-toolbox>=4.0.0",
 ]
 

{runloop_api_client-1.18.1 → runloop_api_client-1.20.0}/src/runloop_api_client/_client.py

@@ -34,6 +34,7 @@ if TYPE_CHECKING:
     from .resources import (
         axons,
         agents,
+        apikeys,
         objects,
         secrets,
         devboxes,
@@ -44,9 +45,11 @@ if TYPE_CHECKING:
         benchmark_jobs,
         benchmark_runs,
         gateway_configs,
+        restricted_keys,
         network_policies,
     )
     from .resources.agents import AgentsResource, AsyncAgentsResource
+    from .resources.apikeys import ApikeysResource, AsyncApikeysResource
     from .resources.objects import ObjectsResource, AsyncObjectsResource
     from .resources.secrets import SecretsResource, AsyncSecretsResource
     from .resources.benchmarks import BenchmarksResource, AsyncBenchmarksResource
@@ -56,6 +59,7 @@ if TYPE_CHECKING:
     from .resources.benchmark_jobs import BenchmarkJobsResource, AsyncBenchmarkJobsResource
     from .resources.benchmark_runs import BenchmarkRunsResource, AsyncBenchmarkRunsResource
     from .resources.gateway_configs import GatewayConfigsResource, AsyncGatewayConfigsResource
+    from .resources.restricted_keys import RestrictedKeysResource, AsyncRestrictedKeysResource
     from .resources.network_policies import NetworkPoliciesResource, AsyncNetworkPoliciesResource
     from .resources.devboxes.devboxes import DevboxesResource, AsyncDevboxesResource
     from .resources.scenarios.scenarios import ScenariosResource, AsyncScenariosResource
@@ -198,6 +202,18 @@ class Runloop(SyncAPIClient):
 
         return McpConfigsResource(self)
 
+    @cached_property
+    def apikeys(self) -> ApikeysResource:
+        from .resources.apikeys import ApikeysResource
+
+        return ApikeysResource(self)
+
+    @cached_property
+    def restricted_keys(self) -> RestrictedKeysResource:
+        from .resources.restricted_keys import RestrictedKeysResource
+
+        return RestrictedKeysResource(self)
+
     @cached_property
     def with_raw_response(self) -> RunloopWithRawResponse:
         return RunloopWithRawResponse(self)
@@ -446,6 +462,18 @@ class AsyncRunloop(AsyncAPIClient):
 
         return AsyncMcpConfigsResource(self)
 
+    @cached_property
+    def apikeys(self) -> AsyncApikeysResource:
+        from .resources.apikeys import AsyncApikeysResource
+
+        return AsyncApikeysResource(self)
+
+    @cached_property
+    def restricted_keys(self) -> AsyncRestrictedKeysResource:
+        from .resources.restricted_keys import AsyncRestrictedKeysResource
+
+        return AsyncRestrictedKeysResource(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncRunloopWithRawResponse:
         return AsyncRunloopWithRawResponse(self)
@@ -643,6 +671,18 @@ class RunloopWithRawResponse:
 
         return McpConfigsResourceWithRawResponse(self._client.mcp_configs)
 
+    @cached_property
+    def apikeys(self) -> apikeys.ApikeysResourceWithRawResponse:
+        from .resources.apikeys import ApikeysResourceWithRawResponse
+
+        return ApikeysResourceWithRawResponse(self._client.apikeys)
+
+    @cached_property
+    def restricted_keys(self) -> restricted_keys.RestrictedKeysResourceWithRawResponse:
+        from .resources.restricted_keys import RestrictedKeysResourceWithRawResponse
+
+        return RestrictedKeysResourceWithRawResponse(self._client.restricted_keys)
+
 
 class AsyncRunloopWithRawResponse:
     _client: AsyncRunloop
@@ -728,6 +768,18 @@ class AsyncRunloopWithRawResponse:
 
         return AsyncMcpConfigsResourceWithRawResponse(self._client.mcp_configs)
 
+    @cached_property
+    def apikeys(self) -> apikeys.AsyncApikeysResourceWithRawResponse:
+        from .resources.apikeys import AsyncApikeysResourceWithRawResponse
+
+        return AsyncApikeysResourceWithRawResponse(self._client.apikeys)
+
+    @cached_property
+    def restricted_keys(self) -> restricted_keys.AsyncRestrictedKeysResourceWithRawResponse:
+        from .resources.restricted_keys import AsyncRestrictedKeysResourceWithRawResponse
+
+        return AsyncRestrictedKeysResourceWithRawResponse(self._client.restricted_keys)
+
 
 class RunloopWithStreamedResponse:
     _client: Runloop
@@ -813,6 +865,18 @@ class RunloopWithStreamedResponse:
 
         return McpConfigsResourceWithStreamingResponse(self._client.mcp_configs)
 
+    @cached_property
+    def apikeys(self) -> apikeys.ApikeysResourceWithStreamingResponse:
+        from .resources.apikeys import ApikeysResourceWithStreamingResponse
+
+        return ApikeysResourceWithStreamingResponse(self._client.apikeys)
+
+    @cached_property
+    def restricted_keys(self) -> restricted_keys.RestrictedKeysResourceWithStreamingResponse:
+        from .resources.restricted_keys import RestrictedKeysResourceWithStreamingResponse
+
+        return RestrictedKeysResourceWithStreamingResponse(self._client.restricted_keys)
+
 
 class AsyncRunloopWithStreamedResponse:
     _client: AsyncRunloop
@@ -898,6 +962,18 @@ class AsyncRunloopWithStreamedResponse:
 
         return AsyncMcpConfigsResourceWithStreamingResponse(self._client.mcp_configs)
 
+    @cached_property
+    def apikeys(self) -> apikeys.AsyncApikeysResourceWithStreamingResponse:
+        from .resources.apikeys import AsyncApikeysResourceWithStreamingResponse
+
+        return AsyncApikeysResourceWithStreamingResponse(self._client.apikeys)
+
+    @cached_property
+    def restricted_keys(self) -> restricted_keys.AsyncRestrictedKeysResourceWithStreamingResponse:
+        from .resources.restricted_keys import AsyncRestrictedKeysResourceWithStreamingResponse
+
+        return AsyncRestrictedKeysResourceWithStreamingResponse(self._client.restricted_keys)
+
 
 Client = Runloop
 

{runloop_api_client-1.18.1 → runloop_api_client-1.20.0}/src/runloop_api_client/_files.py

@@ -3,8 +3,8 @@ from __future__ import annotations
 import io
 import os
 import pathlib
-from typing import overload
-from typing_extensions import TypeGuard
+from typing import Sequence, cast, overload
+from typing_extensions import TypeVar, TypeGuard
 
 import anyio
 
@@ -17,7 +17,9 @@ from ._types import (
     HttpxFileContent,
     HttpxRequestFiles,
 )
-from ._utils import is_tuple_t, is_mapping_t, is_sequence_t
+from ._utils import is_list, is_mapping, is_tuple_t, is_mapping_t, is_sequence_t
+
+_T = TypeVar("_T")
 
 
 def is_base64_file_input(obj: object) -> TypeGuard[Base64FileInput]:
@@ -121,3 +123,51 @@ async def async_read_file_content(file: FileContent) -> HttpxFileContent:
         return await anyio.Path(file).read_bytes()
 
     return file
+
+
+def deepcopy_with_paths(item: _T, paths: Sequence[Sequence[str]]) -> _T:
+    """Copy only the containers along the given paths.
+
+    Used to guard against mutation by extract_files without copying the entire structure.
+    Only dicts and lists that lie on a path are copied; everything else
+    is returned by reference.
+
+    For example, given paths=[["foo", "files", "file"]] and the structure:
+        {
+            "foo": {
+                "bar": {"baz": {}},
+                "files": {"file": <content>}
+            }
+        }
+    The root dict, "foo", and "files" are copied (they lie on the path).
+    "bar" and "baz" are returned by reference (off the path).
+    """
+    return _deepcopy_with_paths(item, paths, 0)
+
+
+def _deepcopy_with_paths(item: _T, paths: Sequence[Sequence[str]], index: int) -> _T:
+    if not paths:
+        return item
+    if is_mapping(item):
+        key_to_paths: dict[str, list[Sequence[str]]] = {}
+        for path in paths:
+            if index < len(path):
+                key_to_paths.setdefault(path[index], []).append(path)
+
+        # if no path continues through this mapping, it won't be mutated and copying it is redundant
+        if not key_to_paths:
+            return item
+
+        result = dict(item)
+        for key, subpaths in key_to_paths.items():
+            if key in result:
+                result[key] = _deepcopy_with_paths(result[key], subpaths, index + 1)
+        return cast(_T, result)
+    if is_list(item):
+        array_paths = [path for path in paths if index < len(path) and path[index] == "<array>"]
+
+        # if no path expects a list here, nothing will be mutated inside it - return by reference
+        if not array_paths:
+            return cast(_T, item)
+        return cast(_T, [_deepcopy_with_paths(entry, array_paths, index + 1) for entry in item])
+    return item

{runloop_api_client-1.18.1 → runloop_api_client-1.20.0}/src/runloop_api_client/_utils/__init__.py

@@ -25,7 +25,6 @@ from ._utils import (
     coerce_integer as coerce_integer,
     file_from_path as file_from_path,
     strip_not_given as strip_not_given,
-    deepcopy_minimal as deepcopy_minimal,
     get_async_library as get_async_library,
     maybe_coerce_float as maybe_coerce_float,
     get_required_header as get_required_header,

{runloop_api_client-1.18.1 → runloop_api_client-1.20.0}/src/runloop_api_client/_utils/_utils.py

@@ -86,8 +86,9 @@ def _extract_items(
     index += 1
     if is_dict(obj):
         try:
-            # We are at the last entry in the path so we must remove the field
-            if (len(path)) == index:
+            # Remove the field if there are no more dict keys in the path,
+            # only "<array>" traversal markers or end.
+            if all(p == "<array>" for p in path[index:]):
                 item = obj.pop(key)
             else:
                 item = obj[key]
@@ -176,21 +177,6 @@ def is_iterable(obj: object) -> TypeGuard[Iterable[object]]:
     return isinstance(obj, Iterable)
 
 
-def deepcopy_minimal(item: _T) -> _T:
-    """Minimal reimplementation of copy.deepcopy() that will only copy certain object types:
-
-    - mappings, e.g. `dict`
-    - list
-
-    This is done for performance reasons.
-    """
-    if is_mapping(item):
-        return cast(_T, {k: deepcopy_minimal(v) for k, v in item.items()})
-    if is_list(item):
-        return cast(_T, [deepcopy_minimal(entry) for entry in item])
-    return item
-
-
 # copied from https://github.com/Rapptz/RoboDanny
 def human_join(seq: Sequence[str], *, delim: str = ", ", final: str = "or") -> str:
     size = len(seq)

{runloop_api_client-1.18.1 → runloop_api_client-1.20.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.18.1"  # x-release-please-version
+__version__ = "1.20.0"  # x-release-please-version