runloop-api-client 1.30.0__tar.gz → 1.32.0__tar.gz

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

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

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

@@ -1,5 +1,52 @@
 # Changelog
 
+## [1.32.0](https://github.com/runloopai/api-client-python/compare/v1.31.0...v1.32.0) (2026-09-08)
+
+
+### Features
+
+* **axon:** accept user metadata at creation ([d2a4242](https://github.com/runloopai/api-client-python/commit/d2a42420be6a0b355a5511eefedc83044d7f11fe))
+* **axon:** add axon metadata update endpoint ([f66ff15](https://github.com/runloopai/api-client-python/commit/f66ff15436bf522020ebc8dd5b891fd21f0081af))
+* **axon:** filter axon lists by metadata and add metadata discovery endpoints ([a8dc212](https://github.com/runloopai/api-client-python/commit/a8dc212b840327a430d7f98f45172fd110f7a9f6))
+* **stlc:** automate SDK generation ([a33c2a4](https://github.com/runloopai/api-client-python/commit/a33c2a470b6701da37a2c9869d9216d67daa0d2a))
+
+
+### Bug Fixes
+
+* **ci:** authenticate SDK back-sync pushes ([#4](https://github.com/runloopai/api-client-python/issues/4)) ([04cae15](https://github.com/runloopai/api-client-python/commit/04cae15abe12cbf205b1d645592a89c9a530752f))
+* **docs:** deploy documentation for releases ([#835](https://github.com/runloopai/api-client-python/issues/835)) ([68023fb](https://github.com/runloopai/api-client-python/commit/68023fb7c86dd5c9d23360fb8f4e680914d99e52))
+
+
+### Chores
+
+* **stlc:** run Promote SDKs on a daily schedule ([582ab9d](https://github.com/runloopai/api-client-python/commit/582ab9d957684efadcf585f3632ec58084232bcc))
+* **stlc:** run Promote SDKs on a daily schedule ([63c6ef1](https://github.com/runloopai/api-client-python/commit/63c6ef146a0ec0ea5cf5487f01e4ae51ca0e2b54))
+
+
+### Documentation
+
+* **readme:** lead with the sandbox category and add package keywords ([#840](https://github.com/runloopai/api-client-python/issues/840)) ([8353d09](https://github.com/runloopai/api-client-python/commit/8353d097d2ae185cf9082f4c59db468a6fcd15c8))
+
+## [1.31.0](https://github.com/runloopai/api-client-python/compare/v1.30.0...v1.31.0) (2026-08-25)
+
+
+### Features
+
+* initial stlc build ([9591d74](https://github.com/runloopai/api-client-python/commit/9591d741d3e840a7f7eadb0935989af1ea78d337))
+* **mux:** mint agent gateway tokens for running devboxes ([#10872](https://github.com/runloopai/api-client-python/issues/10872)) ([8ca74f9](https://github.com/runloopai/api-client-python/commit/8ca74f9390524e2b99791a6967dd8e355df0cff8))
+* **mux:** mint MCP tokens for running devboxes ([#10871](https://github.com/runloopai/api-client-python/issues/10871)) ([7edf2e9](https://github.com/runloopai/api-client-python/commit/7edf2e9daa607705070df22c02d3e95a1fb13a60))
+
+
+### Bug Fixes
+
+* **lint:** sort the devboxes import block ([22bc6c2](https://github.com/runloopai/api-client-python/commit/22bc6c22f41c0db8b50df3f264e47e9b6b5e1e11))
+* **release:** use stable versioning instead of prerelease ([3d2cf64](https://github.com/runloopai/api-client-python/commit/3d2cf6463a9556dcc0bb2eddc397e5d2bdf7d69b))
+
+
+### Chores
+
+* sync uv.lock to 1.30.0 ([d7d2993](https://github.com/runloopai/api-client-python/commit/d7d29930aa3a460d9a0dac9651860b11292c8769))
+
 ## 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)

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

@@ -1,12 +1,14 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.30.0
-Summary: The official Python library for the runloop API
-Project-URL: Homepage, https://github.com/runloopai/api-client-python
+Version: 1.32.0
+Summary: Official Python SDK for Runloop — secure Linux sandboxes (Devboxes) where AI agents run code, edit files, and expose ports
+Project-URL: Homepage, https://runloop.ai
 Project-URL: Repository, https://github.com/runloopai/api-client-python
-Project-URL: Documentation, https://runloopai.github.io/api-client-python/
+Project-URL: Documentation, https://docs.runloop.ai
+Project-URL: API Reference, https://runloopai.github.io/api-client-python/
 Author-email: Runloop <support@runloop.ai>
 License: MIT
+Keywords: agent-runtime,ai-agents,code-execution,code-interpreter,devbox,llm,microvm,runloop,sandbox
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: MacOS
@@ -20,6 +22,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.9
@@ -35,54 +38,75 @@ Requires-Dist: aiohttp; extra == 'aiohttp'
 Requires-Dist: httpx-aiohttp>=0.1.9; extra == 'aiohttp'
 Description-Content-Type: text/markdown
 
-# Runloop Python API library
+# Runloop Python SDK — secure sandboxes for AI agents
 
 <!-- prettier-ignore -->
 [![PyPI version](https://img.shields.io/pypi/v/runloop_api_client.svg?label=pypi%20(stable))](https://pypi.org/project/runloop_api_client/)
 
-The Runloop Python library provides convenient access to the Runloop REST API from any Python 3.9+
-application. The library includes type definitions for all request params and response fields,
-and offers both synchronous and asynchronous clients powered by [httpx](https://github.com/encode/httpx).
+Run AI agents and AI-generated code in **Devboxes**: isolated Linux sandboxes with a shell, a
+filesystem, networking, and optional GPUs. Use this library to create a sandbox, run commands in it,
+read and write files, expose ports over HTTPS, and snapshot the whole machine so you can pause and
+resume it later.
 
-It is generated with [Stainless](https://www.stainless.com/).
+Why teams pick Runloop:
 
-## Documentation
-
-The REST API documentation can be found on
-[runloop.ai](https://runloop.ai). The full API of this library can be found in
-[api.md](https://github.com/runloopai/api-client-python/blob/main/api.md).
+- **Safe by default.** Every devbox is isolated at both the VM and container level, so untrusted
+  agent output never touches your infrastructure.
+- **Built for long-running agents.** Devboxes persist for as long as you need, and snapshots let you
+  suspend, resume, and branch an agent's machine state.
+- **Fast starts.** Blueprints bake your dependencies into a reusable image so agents boot in seconds
+  instead of installing tooling every run.
+- **Ready for production.** Secrets injection, AI gateways, network policies, and VPC deployment are
+  part of the platform.
+- **Measurable.** Built-in benchmarks and evaluations score agent runs so you can tell whether a
+  change actually helped.
 
 ## Installation
 
 ```sh
-# install from PyPI
 pip install runloop_api_client
 ```
 
-## Usage
-
-The full API of this library can be found in [api.md](api.md).
-
-### Object-Oriented SDK
+## Quickstart
 
-For a higher-level, Pythonic interface, check out the new [`RunloopSDK`](README-SDK.md) which layers an object-oriented API on top of the generated client (including synchronous and asynchronous variants).
+Set `RUNLOOP_API_KEY` in your environment ([get a free key](https://runloop.ai) — new accounts start
+with $50 in credits), then:
 
 ```python
 from runloop_api_client import RunloopSDK
 
 runloop = RunloopSDK()  # Uses RUNLOOP_API_KEY environment variable by default
 
-# Create a devbox and execute commands with a clean, object-oriented interface
+# Create a sandbox, run a command in it, and clean it up on exit.
 with runloop.devbox.create(name="my-devbox") as devbox:
-    result = devbox.cmd.exec("echo 'Hello from Runloop!'")
+    devbox.file.write(file_path="main.py", contents="print('hello from a sandbox')")
+    result = devbox.cmd.exec("python main.py")
     print(result.stdout())
 ```
 
-**See the [SDK documentation](README-SDK.md) for complete examples and API reference.**
+**See the [SDK documentation](README-SDK.md) for complete examples and API reference**, and
+[docs.runloop.ai](https://docs.runloop.ai) for platform guides. Agents and LLM tooling can read
+[llms.txt](llms.txt) for a condensed overview of the whole platform.
+
+## Documentation
+
+- [Platform documentation](https://docs.runloop.ai) — devboxes, blueprints, snapshots, tunnels, agents, benchmarks
+- [`RunloopSDK` reference](README-SDK.md) — the high-level, object-oriented Python interface
+- [api.md](https://github.com/runloopai/api-client-python/blob/main/api.md) — the full generated REST surface
+- [examples/](examples) — runnable end-to-end scripts
+- [llms.txt](llms.txt) — condensed platform summary for AI coding agents
+
+## Usage
+
+This library ships two layers: the object-oriented `RunloopSDK` shown above, and the generated REST
+client it is built on. Both have synchronous and asynchronous variants, include type definitions for
+all request params and response fields, and are powered by
+[httpx](https://github.com/encode/httpx). The generated client is produced with
+[Stainless](https://www.stainless.com/).
 
 ### REST API Client
 
-Alternatively, you can use the generated REST API client directly:
+To use the generated REST API client directly:
 
 ```python
 import os

{runloop_api_client-1.30.0 → runloop_api_client-1.32.0}/README.md

@@ -1,51 +1,72 @@
-# Runloop Python API library
+# Runloop Python SDK — secure sandboxes for AI agents
 
 <!-- prettier-ignore -->
 [![PyPI version](https://img.shields.io/pypi/v/runloop_api_client.svg?label=pypi%20(stable))](https://pypi.org/project/runloop_api_client/)
 
-The Runloop Python library provides convenient access to the Runloop REST API from any Python 3.9+
-application. The library includes type definitions for all request params and response fields,
-and offers both synchronous and asynchronous clients powered by [httpx](https://github.com/encode/httpx).
+Run AI agents and AI-generated code in **Devboxes**: isolated Linux sandboxes with a shell, a
+filesystem, networking, and optional GPUs. Use this library to create a sandbox, run commands in it,
+read and write files, expose ports over HTTPS, and snapshot the whole machine so you can pause and
+resume it later.
 
-It is generated with [Stainless](https://www.stainless.com/).
+Why teams pick Runloop:
 
-## Documentation
-
-The REST API documentation can be found on
-[runloop.ai](https://runloop.ai). The full API of this library can be found in
-[api.md](https://github.com/runloopai/api-client-python/blob/main/api.md).
+- **Safe by default.** Every devbox is isolated at both the VM and container level, so untrusted
+  agent output never touches your infrastructure.
+- **Built for long-running agents.** Devboxes persist for as long as you need, and snapshots let you
+  suspend, resume, and branch an agent's machine state.
+- **Fast starts.** Blueprints bake your dependencies into a reusable image so agents boot in seconds
+  instead of installing tooling every run.
+- **Ready for production.** Secrets injection, AI gateways, network policies, and VPC deployment are
+  part of the platform.
+- **Measurable.** Built-in benchmarks and evaluations score agent runs so you can tell whether a
+  change actually helped.
 
 ## Installation
 
 ```sh
-# install from PyPI
 pip install runloop_api_client
 ```
 
-## Usage
-
-The full API of this library can be found in [api.md](api.md).
-
-### Object-Oriented SDK
+## Quickstart
 
-For a higher-level, Pythonic interface, check out the new [`RunloopSDK`](README-SDK.md) which layers an object-oriented API on top of the generated client (including synchronous and asynchronous variants).
+Set `RUNLOOP_API_KEY` in your environment ([get a free key](https://runloop.ai) — new accounts start
+with $50 in credits), then:
 
 ```python
 from runloop_api_client import RunloopSDK
 
 runloop = RunloopSDK()  # Uses RUNLOOP_API_KEY environment variable by default
 
-# Create a devbox and execute commands with a clean, object-oriented interface
+# Create a sandbox, run a command in it, and clean it up on exit.
 with runloop.devbox.create(name="my-devbox") as devbox:
-    result = devbox.cmd.exec("echo 'Hello from Runloop!'")
+    devbox.file.write(file_path="main.py", contents="print('hello from a sandbox')")
+    result = devbox.cmd.exec("python main.py")
     print(result.stdout())
 ```
 
-**See the [SDK documentation](README-SDK.md) for complete examples and API reference.**
+**See the [SDK documentation](README-SDK.md) for complete examples and API reference**, and
+[docs.runloop.ai](https://docs.runloop.ai) for platform guides. Agents and LLM tooling can read
+[llms.txt](llms.txt) for a condensed overview of the whole platform.
+
+## Documentation
+
+- [Platform documentation](https://docs.runloop.ai) — devboxes, blueprints, snapshots, tunnels, agents, benchmarks
+- [`RunloopSDK` reference](README-SDK.md) — the high-level, object-oriented Python interface
+- [api.md](https://github.com/runloopai/api-client-python/blob/main/api.md) — the full generated REST surface
+- [examples/](examples) — runnable end-to-end scripts
+- [llms.txt](llms.txt) — condensed platform summary for AI coding agents
+
+## Usage
+
+This library ships two layers: the object-oriented `RunloopSDK` shown above, and the generated REST
+client it is built on. Both have synchronous and asynchronous variants, include type definitions for
+all request params and response fields, and are powered by
+[httpx](https://github.com/encode/httpx). The generated client is produced with
+[Stainless](https://www.stainless.com/).
 
 ### REST API Client
 
-Alternatively, you can use the generated REST API client directly:
+To use the generated REST API client directly:
 
 ```python
 import os

{runloop_api_client-1.30.0 → runloop_api_client-1.32.0}/api.md

@@ -122,6 +122,7 @@ from runloop_api_client.types import (
     AxonCreateParams,
     AxonEventView,
     AxonListView,
+    AxonUpdateParams,
     AxonView,
     PublishParams,
     PublishResultView,
@@ -132,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="post /v1/axons/{id}">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">update</a>(id, \*\*<a href="src/runloop_api_client/types/axon_update_params.py">params</a>) -> <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>
@@ -214,6 +216,8 @@ from runloop_api_client.types import (
     DevboxSnapshotListView,
     DevboxSnapshotView,
     DevboxView,
+    GatewayTokenView,
+    McpTokenView,
     PtyTunnelView,
     TunnelView,
     DevboxCreateSSHKeyResponse,
@@ -228,6 +232,8 @@ 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_gateway_token">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">create_gateway_token</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_create_gateway_token_params.py">params</a>) -> <a href="./src/runloop_api_client/types/gateway_token_view.py">GatewayTokenView</a></code>
+- <code title="post /v1/devboxes/{id}/create_mcp_token">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">create_mcp_token</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_create_mcp_token_params.py">params</a>) -> <a href="./src/runloop_api_client/types/mcp_token_view.py">McpTokenView</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>

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

@@ -1,8 +1,19 @@
 [project]
 name = "runloop_api_client"
-version = "1.30.0"
-description = "The official Python library for the runloop API"
+version = "1.32.0"
+description = "Official Python SDK for Runloop — secure Linux sandboxes (Devboxes) where AI agents run code, edit files, and expose ports"
 dynamic = ["readme"]
+keywords = [
+  "runloop",
+  "sandbox",
+  "devbox",
+  "ai-agents",
+  "code-execution",
+  "code-interpreter",
+  "agent-runtime",
+  "microvm",
+  "llm",
+]
 license = "MIT"
 authors = [
 { name = "Runloop", email = "support@runloop.ai" },
@@ -34,13 +45,15 @@ classifiers = [
   "Operating System :: POSIX :: Linux",
   "Operating System :: Microsoft :: Windows",
   "Topic :: Software Development :: Libraries :: Python Modules",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
   "License :: OSI Approved :: MIT License"
 ]
 
 [project.urls]
-Homepage = "https://github.com/runloopai/api-client-python"
+Homepage = "https://runloop.ai"
 Repository = "https://github.com/runloopai/api-client-python"
-Documentation = "https://runloopai.github.io/api-client-python/"
+Documentation = "https://docs.runloop.ai"
+"API Reference" = "https://runloopai.github.io/api-client-python/"
 
 [project.optional-dependencies]
 aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.9"]

{runloop_api_client-1.30.0 → runloop_api_client-1.32.0}/release-please-config.json

@@ -2,11 +2,11 @@
   "packages": {
     ".": {}
   },
-  "$schema": "https://raw.githubusercontent.com/stainless-api/release-please/main/schemas/config.json",
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
   "include-v-in-tag": true,
   "include-component-in-tag": false,
-  "versioning": "prerelease",
-  "prerelease": true,
+  "versioning": "default",
+  "prerelease": false,
   "bump-minor-pre-major": true,
   "bump-patch-for-minor-pre-major": false,
   "pull-request-header": "Automated Release PR",

{runloop_api_client-1.30.0 → runloop_api_client-1.32.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.30.0"  # x-release-please-version
+__version__ = "1.32.0"  # x-release-please-version