runloop-api-client

1.31.0 (2026-08-25)

Features

• initial stlc build (9591d74)
• mux: mint agent gateway tokens for running devboxes (#10872) (8ca74f9)
• mux: mint MCP tokens for running devboxes (#10871) (7edf2e9)

Bug Fixes

• lint: sort the devboxes import block (22bc6c2)
• release: use stable versioning instead of prerelease (3d2cf64)

Chores

• sync uv.lock to 1.30.0 (d7d2993)

1.30.0 (2026-08-20)

Full Changelog: v1.29.0...v1.30.0

Features

• devboxes: use optimistic create endpoint (#829) (3f47b22)

Chores

• internal: allow the mock server port to be set with STAINLESS_MOCK_PORT (b7a3d87)

1.29.0 (2026-08-20)

Full Changelog: v1.28.0...v1.29.0

Features

• axon: add registry delete endpoint (#10769) (c63f011)
• broker: plumb Pi protocol selection (#10256) (974d52b)
• config: custom_headers on McpConfig/GatewayConfig — persistence, REST, validation, provisioner, OpenAPI (#11096) (9482e47)
• converter: add Helm chart, container image, and enable in dev (#10405) (0d5ca34)
• devbox: recover resume provisioning failures (#10597) (518301e)
• gateway: first-class BASIC auth mechanism (#11063) (1f50f93)
• mcp: configurable auth_mechanism on McpConfig, shared shape with gateway (#11113) (4dd9edd)

Bug Fixes

• devbox: make Devbox update API patch-like (#10582) (0a74521)
• gateway: reject keyless HEADER auth_mechanism at admission and in looper (#11120) (194c060)

1.28.0 (2026-07-29)

Full Changelog: v1.27.0...v1.28.0

Features

• devbox: queue devboxes until node assignment (#10320) (1837c34)

1.27.0 (2026-07-28)

Full Changelog: v1.24.0...v1.27.0

Features

• mux: wait_for_eviction endpoint for flex eviction notifications (#10325) (7e86af9)

Bug Fixes

• mux: field-level merge on network policy egress updates (#10338) (366a3ee)
• mux: move eviction-watch SSE route off the /{id} slot (#10409) (61f4143)

Chores

• stainless: generate watch_evictions as an SSE stream (#10404) (cb82bca)

1.24.0 (2026-07-22)

Full Changelog: v1.23.3...v1.24.0

Features

• add HTTP/2 load testing infrastructure (#819) (4ef3c65)
• api: add codex broker mount protocol and axon attach enum value (#10186) (b3a0a91)
• devbox: rename scheduled -> queued (#10217) (f6cc5b7)
• loadtest: add pool_check.py to verify shared sync connection pool (#822) (0000c52)
• mux: expose CIDR egress rules on the network policy API (#10269) (b77a065)
• network: add allow_runloop_mirrors egress flag to network policies (#10350) (c042398)
• stlc: configurable CI runner and private-production-repo support in workflow templates (6a762cb)

Bug Fixes

• internal: resolve build failures (a5b61f3)
• mux: uniform id/name search across list endpoints, close cross-tenant IDOR (#10267) (4a40176)

What's Changed

• docs: add agent PR guidance by @tode-rl in #814
• fix: update test script to work without lsof on CI by @jrvb-rl in #798
• fix: retry polling on HTTP/2 GOAWAY connection errors by @yoon-park-rl in #817
• chore(devbox): cap forwarded long-poll timeout and add client read margin by @gautam-rl in #818
• release: 1.23.3 by @stainless-app[bot] in #812

New Contributors

• @yoon-park-rl made their first contribution in #817

Full Changelog: v1.23.2...v1.23.3

1.23.2 (2026-06-09)

Full Changelog: v1.23.1...v1.23.2

Features

• devbox: expose provisioning_tier=flex in API + SDKs (alpha) (#9700) (139bef6)

1.23.1 (2026-06-09)

Full Changelog: v1.23.0...v1.23.1

Features

• devbox: add provisioning_tier (flex) to LaunchParameters (alpha) (#808) (cb59e8b)

1.23.0 (2026-06-05)

Full Changelog: v1.22.1...v1.23.0

Features

• devbox: add SCHEDULED status to the data model (#9654) (8f45663)
• portal: support tunnel authorization header (#9597) (8ca990e)

1.22.1 (2026-06-01)

Full Changelog: v1.22.0...v1.22.1

Build System

• stainless: map /v1/accounts/me to accounts.me in the SDK (#9569) (3f9cbe1)

1.22.0 (2026-05-27)

Full Changelog: v1.21.0...v1.22.0

Features

• add reflex initiator type, hidden param (#9350) (5922abf)
• api: expose lifecycle_hooks on LaunchParameters lifecycle (#9115) (c9c7c37)
• mux: initial changes to enable http/2 (#8936) (71ce0bf)

Bug Fixes

• clean up PTY and lifecycle hook OpenAPI descriptions (#9502) (f986282)
• mux: strip internal stub note from PTY OpenAPI descriptions (#9315) (214629e)
• revert workflow actions to runloopai forks (#805) (88a9632)

Chores

• Update stainless.yml, bump AGENTS.md to keep this updated (#9268) (5d86ef5)

1.21.0 (2026-05-13)

Full Changelog: v1.20.3...v1.21.0

Features

• internal/types: support eagerly validating pydantic iterators (f089d05)
• metadata: add object metadata viewing, discovery, and validation (#9124) (ba0b5dc)

Bug Fixes

• client: add missing f-string prefix in file type error message (930b1e2)
• update openapi.stainless.yaml for PTY server methods (#9218) (ac1cb22)
• update types for pty control, use int instead of str (#9235) (7ceb2bf)

1.20.3 (2026-05-08)

Full Changelog: v1.20.2...v1.20.3

Features

• make agent version optional in API (#8858) (7e11a9d)
• share HTTP connection pool across SDK instances; refactor polling (#797) (4f2fc4c)
• support setting headers via env (54ead49)

Bug Fixes

• use correct field name format for multipart file arrays (c564da8)

Chores

• add get secret to stainless (#7833) (ce39778)
• internal: more robust bootstrap script (115744e)
• internal: reformat pyproject.toml (89e8401)

1.20.2 (2026-05-01)

Full Changelog: v1.20.1...v1.20.2

Bug Fixes

• additional polling updates (#794) (26e409a)

1.20.1 (2026-05-01)

Full Changelog: v1.20.0...v1.20.1

Documentation

• add missing SDK operations to README-SDK (#791) (98a746a)

1.20.0 (2026-04-21)

Full Changelog: v1.19.0...v1.20.0

Features

• add OO SDK support for new Agent API calls (#786) (6197567)
• axon: add working directory / directory to launch agent (#8689) (2097995)

Performance Improvements

• client: optimize file structure copying in multipart requests (64f27ad)

Chores

• tests: bump steady to v0.22.1 (c72f34d)

1.19.0 (2026-04-13)

Full Changelog: v1.18.1...v1.19.0

Features

• Add wake on axon event as an API primitive (#8681) (255099a)
• Allow API keys to create API and restricted keys (#8663) (2e03b55)

Bug Fixes

• add missing agent API paths to stainless config (#8699) (4f6fe60)
• ensure file data are only sent as 1 parameter (f7ca2cc)

Documentation

• add snapshot, suspend & resume example (#764) (f4b942b)
• added Async vs Sync tabs, removed top-level class descriptions (#783) (6a99c56)
• restructure sphinx docs with async-first API reference and full type coverage (#782) (514cf93)
• show full field descriptions for SDK parameter types (#784) (f04a506)

1.18.1 (2026-04-10)

Full Changelog: v1.17.0...v1.18.1

Bug Fixes

• add list events to axon (#8648) (1203b57)
• TTL shutdown showed non-standard reason in devbox logs (#8636) (8ac5cc5)

Documentation

• clarify that we don't support git commit SHA in git agents/blueprint builds (#8638) (66b0895)

1.17.0 (2026-04-09)

Full Changelog: v1.16.0...v1.17.0

Features

• Add protocol, launch etc arguments to attach axon grpc, persist them in the db (#8564) (76ad33d)
• api: add lifecycle configuration to launch parameters (#8606) (1dd716d)
• stream kernel messages (kmsg) to devbox logs (#8588) (8f0ad67)

Bug Fixes

• broker: remove codex in favor of codex via acp (#8602) (118162e)
• client: preserve hardcoded query params when merging with user params (5ce9b5d)
• propagate git ref to maverick for git-based agents (#8608) (fc633d6)

Chores

• Cleanup remaining junk left over from browser and computer use (#8553) (ddccee2)

Documentation

• fix typo, fix repoc/git-based agent mounts ignoring custom mount paths (#8537) (638bc7a)

1.16.0 (2026-04-03)

Full Changelog: v1.15.0...v1.16.0

Features

• add specific message when a devbox fails due to missing its health checks (#8535) (2b27148)

Chores

• blueprints: deprecate blueprints.preview() method (#8526) (b7a2ce9)
• Remove computer and browser use controllers (#8530) (b5bfa7d)

1.15.0 (2026-04-02)

Full Changelog: v1.14.1...v1.15.0

Features

• benchmark-runs: add state filter and multi-value benchmark_id support to listBenchmarkRuns (#8480) (08e6a25)

Bug Fixes

• Add after_sequence param to axon subscribe (#8497) (454cce4)

1.14.1 (2026-04-01)

Full Changelog: v1.14.0...v1.14.1

Bug Fixes

• sdk: remove incorrect remove_tunnel DeprecationWarning (#775) (925c735)

Chores

• Hide repository connection APIs from public OpenAPI spec (#8462) (2eac1fc)
• tests: bump steady to v0.20.1 (c19d63d)
• tests: bump steady to v0.20.2 (3c0beeb)

1.14.0 (2026-03-31)

Full Changelog: v1.13.3...v1.14.0

Features

• add archive / unarchive to benchmarks (#8391) (31ebb2c)
• Add axon list filters by id and name (#8384) (cd722b3)
• Add pagination to list active axons (#8359) (1937bc9)
• internal: implement indices array format for query and form serialization (1239661)

Bug Fixes

• sdk: expose axon list params (#773) (47e208d)
• tests: poll for logs in smoke tests to handle CloudWatch ingestion latency (#774) (5f1e187)

Chores

• axon: add axon auto-pagination to stainless sdks (#8420) (14806e1)

Documentation

• api: document vCPU, RAM, and disk for resource_size_request (#8368) (1edfb84)

1.13.3 (2026-03-26)

Full Changelog: v1.13.2...v1.13.3

Bug Fixes

• api: surface scenario setup failures instead of silently dropping them (#8300) (dd910d0)
• devbox: get_tunnel_url now derives tunnel domain from base url (#771) (2634c64)

Chores

• axon: add axon to sdk readme (#769) (68afe5a)

1.13.2 (2026-03-25)

Full Changelog: v1.13.1...v1.13.2

Bug Fixes

• adding axon SQL to sdk (#767) (d683fd1)

1.13.1 (2026-03-25)

Full Changelog: v1.13.0...v1.13.1

Features

• Add axon rest endpoints for raw SQL access (#8287) (d3135f4)
• add BrokerMount to OpenAPI spec (#8282) (fc41e95)
• sdk: add axons to OO SDK (#766) (821cf30)

Bug Fixes

• broker: broker protocol renames for clarity / future proof (#8285) (4f07960)

Chores

• ci: skip lint on metadata-only changes (b276bc4)
• tests: bump steady to v0.19.7 (2f380b6)

1.13.0 (2026-03-24)

Full Changelog: v1.12.1...v1.13.0

Features

• example for using tunnels (#754) (97bcd70)

Bug Fixes

• add AxonEventView schema to OpenAPI spec for SSE subscribe endpoint (#8274) (618f1bb)
• add name to Axon (#8277) (7bdb527)
• sanitize endpoint path params (5182d36)
• sanitize endpoint path params (0993026)
• tunnels: allow tunnel removal (#8257) (6cff97e)

Chores

• internal: update gitignore (96bd6fd)
• remove dead port configuration code, mark deprecated / ignored in the API (#8195) (e565324)
• tests: bump steady to v0.19.4 (66cb637)
• tests: bump steady to v0.19.5 (601c93a)
• tests: bump steady to v0.19.6 (95b2ffc)

Refactors

• tests: switch from prism to steady (dd8fe60)
• undeprecate total_count from pagination API, remove remaining_count (#8084) (4bd524f)

1.12.1 (2026-03-19)

Full Changelog: v1.12.0...v1.12.1

Chores

• remove create_tunnel endpoint (627c994)

1.12.0 (2026-03-18)

Full Changelog: v1.11.0...v1.12.0

Features

• add secrets to oo-sdk (#756) (09c4997)

Bug Fixes

• deps: bump minimum typing-extensions version (a873aad)
• pydantic: do not pass by_alias unless set (baf3a9a)

Chores

• configure new SDK language (13d3ada)
• internal: tweak CI branches (b374486)

1.11.0 (2026-03-10)

Full Changelog: v1.10.3...v1.11.0

Features

• add snapshots example (#753) (f13916a)
• documentation: added llms.txt, examples and referenced these artifacts via README (#748) (bceb953)

Bug Fixes

• add logs to devboxes, smoke tests & examples (#755) (da5faa4)

Chores

• ci: skip uploading artifacts on stainless-internal branches (6874252)
• documentation: correct exec advice (#752) (fa16c1d)
• test: do not count install time for mock server timeout (f6fde05)
• update placeholder string (5dfcd93)

1.10.3 (2026-02-27)

Full Changelog: v1.10.2...v1.10.3

Bug Fixes

• switching to MCP definition to specify a secret name per MCP server (#7715) (01f4b3d)

Chores

• ci: bump uv version (b0fad50)

1.10.2 (2026-02-26)

Full Changelog: v1.10.1...v1.10.2

Bug Fixes

• remove beta docs from gateway-config (#7677) (0c64614)

Chores

• rename AI Gateway to Agent Gateway (#7687) (6e96bda)

1.10.1 (2026-02-26)

Full Changelog: v1.10.0...v1.10.1

Bug Fixes

• devbox: add mcp configs to DevboxView (#7680) (ad62b28)

1.10.0 (2026-02-26)

Full Changelog: v1.9.0...v1.10.0

Features

• add MCP Hub to sdk (#742) (e9f6756)

1.9.0 (2026-02-25)

Full Changelog: v1.8.0...v1.9.0

Features

• Add AI gateway and MCP gateway flags to network policy create (#7638) (85f2146)

Chores

• Add archive method to stainless (#7537) (836f18d)
• benchmarks: removed scorer (#740) (1033264)
• format all api.md files (ee5d577)
• internal: add request options to SSE classes (e636aca)
• internal: make test_proxy_environment_variables more resilient (564cd57)
• internal: make test_proxy_environment_variables more resilient to env (21d4ce8)
• scenarios: make scenario status enum instead of string (#7552) (e6e5208)
• update mock server docs (273fb5e)

Refactors

• deprecate and make Nullable total_count and remaining_count of ListViews (#7533) (8b16ebe)

1.8.0 (2026-02-12)

Full Changelog: v1.7.0...v1.8.0

Features

• benchmarks: scenario scoring timeout (#7300) (6615183)
• devbox: expose snapshot size (in bytes) (#7444) (b25c3f7)

Bug Fixes

• remove duplicate operationId createDevboxTunnel in openapi (#7397) (bb2cd8f)

Chores

• internal: bump dependencies (94e6c44)
• internal: fix lint error on Python 3.14 (37ab1b7)

1.7.0 (2026-02-05)

Full Changelog: v1.5.1...v1.7.0

Features

• add api to query devbox usage (#7296) (ab903f5)
• adding MCP Config routes (#7331) (79d05c0)
• devbox: add mcp configuration to devbox create (#7341) (0b81e31)
• devbox: adding gateway config (#736) (9f4b49d)

Bug Fixes

• sdk: fixed pagination for scorer, scenario and network policy list methods (#731) (d55fceb)

Chores

• Mark legacy tunnel methods deprecated (#737) (764b445)

1.5.1 (2026-01-30)

Full Changelog: v1.5.0...v1.5.1

Chores

• devbox: rename tunnel auth enum (#7239) (7a9b7a4)

1.5.0 (2026-01-30)

Full Changelog: v1.4.0...v1.5.0

Features

• devbox: add enable_tunnel API (#7236) (bb58bfc)

1.4.0 (2026-01-30)

Full Changelog: v1.3.2...v1.4.0

Features

• client: add custom JSON encoder for extended type support (840addd)
• devbox: add gateway routes (#7212) (2527bb7)
• devbox: add new tunnel APIs and deprecate old tunnel API (#7227) (71620a1)

Chores

• devbox: deprecate remove tunnel API (#7230) (d48832d)
• documentation: made warning message language more accurate (#7215) (08e0586)

1.3.2 (2026-01-30)

Full Changelog: v1.3.1...v1.3.2

Bug Fixes

• blueprint: blueprint state queued handled by is ready (#726) (77e91ab)

1.3.1 (2026-01-28)

Full Changelog: v1.3.0...v1.3.1

Features

• benchmark: adding in progress benchmark runs for benchmark jobs (#7183) (2f11e9f)

Chores

• ci: upgrade actions/github-script (7ba3962)

1.3.0 (2026-01-22)

Full Changelog: v1.3.0-alpha...v1.3.0

Features

• network-policy: add network policies (#720) (9b31116)

Chores

• fix stainless spec / remove deprecated benchmark/runs (#7074) (3ed7d80)
• fix tests and linting (#719) (74db814)
• update network policy create params descriptions (#7069) (b151692)

1.3.0-alpha (2026-01-20)

Full Changelog: v1.2.0...v1.3.0-alpha

⚠ BREAKING CHANGES

• remove support for pydantic-v1, pydantic-v2 is now default (#710)

Features

• benchmarks: add update_scenarios method to benchmarks resource (71ec221)
• blueprint: Set cilium network policy on blueprint build (#7006) (95c62ac)
• client: add support for binary request streaming (d6c2200)
• devbox: added stdin streaming endpoint (83ae56a)
• devbox: remove this one (91854d5)
• network-policy: add network policies to api (1d98bb1)
• scenarios: add scenario builder to sdk (#706) (2d41a15)
• sdk: add Benchmark and AsyncBenchmark classes (#714) (8909d8a)
• sdk: add BenchmarkOps and AsyncBenchmarkOps to SDK (#716) (9b434d9)
• sdk: add BenchmarkRun and AsyncBenchmarkRun classes (#712) (6aa83e2)

Bug Fixes

• benchmarks: update() for benchmarks and scenarios replaces all provided fields and does not modify unspecified fields (#6702) (cfd04b6)
• types: allow pyright to infer TypedDict types within SequenceNotStr (3241717)
• use async_to_httpx_files in patch method (88f8fb9)

Chores

• add documentation url to pypi project page (#711) (7afb327)
• add missing docstrings (a198632)
• devbox: Remove network policy from devbox view; use launch params instead (#7025) (d53af14)
• internal: add --fix argument to lint script (c381201)
• internal: add missing files argument to base client (b7065e2)
• internal: codegen related update (75fecdf)
• internal: update actions/checkout version (7a57030)
• remove support for pydantic-v1, pydantic-v2 is now default (#710) (fb3cc3d)

Documentation

• reformat sidebar and index pages to be more transparent, add favicon to browser tab (#715) (1161b8f)

Refactors

• benchmark: Deprecate /benchmark/{id}/runs in favor of /benchmark_runs (#7019) (793507a)

1.2.0 (2025-12-09)

Full Changelog: v1.1.0...v1.2.0

Features

• devbox: default to x86 arch (501de0b)
• devbox: return user for createSshKey (f094bf7)

Bug Fixes

• ensure streams are always closed (d01aae2)

Chores

• bump required uv version (8ad519f)
• deps: mypy 1.18.1 has a regression, pin to 1.17 (e56582a)
• docs: use environment variables for authentication in code snippets (55cf613)
• internal: version bump (2fa85c6)
• remove some unnecessary changes to reduce diff from Stainless (#705) (715c9d0)
• update lockfile (7e0136d)
• update requirements-dev.lock (#707) (a2d5326)
• update uv.lock (b9e0729)

1.1.0 (2025-12-06)

Full Changelog: v1.0.0...v1.1.0

Features

• scenarios: added scenario class to sdk (#701) (121f0fc)
• SDK: Build context helpers for the python clients and SDKs (#684) (42849d6)

Chores

• smoketests: fixed smoketests and cleaned up typing/formatting (#699) (f57aae7)

1.0.0 (2025-12-02)

Full Changelog: v0.69.0...v1.0.0

⚠ BREAKING CHANGES

• devbox: made command positional arg in exec and exec_async (#695)

Features

• blueprints: Add build context to the OpenAPI spec (#6494) (d202b94)
• devbox: added devbox.shell(shellName) command and stateful shell class to SDK (#696) (c1e8f09)
• devbox: made command positional arg in exec and exec_async (#695) (6cc8c2f)
• sdk: added scorer classes to sdk (#698) (85f798f)

Bug Fixes

• api: don't ignore devbox keep_alive, suspend and resume in api (fe3589f)
• devbox: launch parameter typo (1c9c346)
• scenarios: update parameters for manually maintained start_run_and_await_env_ready methods (#692) (8000495)
• scorer: fixed RL_TEST_CONTEXT to RL_SCORER_CONTEXT (df43a42)

Chores

• blueprints: Add build context examples (#694) (6e63928)
• hide build context APIs (159a38f)
• mounts: Update documentation for deprecated fields to direct the user to the replacement API (4936844)

0.69.0 (2025-11-21)

Full Changelog: v0.68.0...v0.69.0

Features

• blueprints: blueprints create_and_await_build_complete now take in build_context and named_build_context arguments (#681) (1febe28)
• devbox: unify api for devbox mounts (01c7d14)
• docs: add documentation for the object oriented sdk, rendered with sphinx (#677) (e8d1053)
• storage-objects: Add upload_from_dir helper method (#680) (be5d99e)

Documentation

• restructured sync vs async sdk and resources, added support for more type references (#679) (6af891e)

0.68.0 (2025-11-19)

Full Changelog: v0.67.0...v0.68.0

Features

• blueprints: Cleanup the BuildContext API (#6407)\n\nTest (c87b986)
• blueprints: prevent deletion of blueprints with dependent snapshots (ce55350)
• object: Added ability to give objects a Time To Live, after which they are automatically deleted.\nfeat(blueprints): Added the ability to attach objects as build contexts that can be referenced in your Dockerfile. (f2bc83c)

Bug Fixes

• compat with Python 3.14 (a52802a)
• compat: update signatures of model_dump and model_dump_json for Pydantic v1 (50340b2)
• snapshot: added "deleted" status to DevboxSnapshotStatus enum \n fix(storage-object): added ObjectState enum, fixed createObject() to appropriately type content_type and state as the respective enums (7c26593)

Chores

• package: drop Python 3.8 support (d67abf1)

0.67.0 (2025-11-14)

Full Changelog: v0.66.1...v0.67.0

Features

• api: api update (516c20b)
• blueprint: adds queued state (5893559)

Bug Fixes

• client: close streams without requiring full consumption (30f9ee5)

Chores

• internal/tests: avoid race condition with implicit client cleanup (7152280)
• internal: grammar fix (it's -> its) (fd6963f)
• package: drop Python 3.8 support (5026669)

0.66.1 (2025-10-23)

Full Changelog: v0.66.0...v0.66.1

0.66.0 (2025-10-23)

Full Changelog: v0.65.0...v0.66.0

Features

• api: api update (a0f1f40)

Chores

• bump httpx-aiohttp version to 0.1.9 (8d29288)

0.65.0 (2025-10-15)

Full Changelog: v0.64.0...v0.65.0

Features

• api: api update (e6de5c0)

Chores

• internal: detect missing future annotations with ruff (e8914e3)

0.64.0 (2025-10-06)

Full Changelog: v0.63.0...v0.64.0

Features

• api: api update (b13e49f)
• api: api update (736c122)
• api: api update (c4dbcf3)

0.63.0 (2025-10-02)

Full Changelog: v0.62.0...v0.63.0

Features

• api: api update (dbf7a2e)
• api: api update (fff1e21)

0.62.0 (2025-10-01)

Full Changelog: v0.61.0...v0.62.0

Features

• api: api update (a2ed6d7)
• api: api update (59b9486)
• api: api update (8d62f4b)

0.61.0 (2025-09-29)

Full Changelog: v0.60.1...v0.61.0

Features

• api: api update (6c66922)
• api: api update (249f9d2)
• api: api update (6c9ba20)

Chores

• do not install brew dependencies in ./scripts/bootstrap by default (d5ba1be)
• internal: update pydantic dependency (baecb39)
• types: change optional parameter type from NotGiven to Omit (783fea5)

0.60.1 (2025-09-11)

Full Changelog: v0.60.0...v0.60.1