release: 1.12.0

.gitignore

@@ -1,5 +1,6 @@
 .vscode
 .prism.log
+.stdy.log
 node_modules
 yarn-error.log
 codegen.log

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.11.2"
+  ".": "1.12.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 117
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-0568973e19e8af9fa953b2ded109ab2b69e76e90e2b74f33617dbf7092e26274.yml
-openapi_spec_hash: 10ba804ce69510d7985e05c77d0ffcf6
-config_hash: de99cfce88e2d1f02246dc6c2f43bc6c
+configured_endpoints: 122
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-32e4b2dfb75745be076697d252bd80aff21c08464750928ffe2b7dd997d0b443.yml
+openapi_spec_hash: eb0ccabfcda0fb8c56b53939b56f6d80
+config_hash: c422b761c745873bce8fa5ccf03b7b98

CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 1.12.0 (2026-03-24)
+
+Full Changelog: [v1.11.2...v1.12.0](https://github.com/runloopai/api-client-ts/compare/v1.11.2...v1.12.0)
+
+### Features
+
+* [beta] adding axon, an event communication channel ([#8268](https://github.com/runloopai/api-client-ts/issues/8268)) ([81f048a](https://github.com/runloopai/api-client-ts/commit/81f048a2ebc688a60fddcf3e047bb12ee60dc41a))
+* tunnel example ([#741](https://github.com/runloopai/api-client-ts/issues/741)) ([222e123](https://github.com/runloopai/api-client-ts/commit/222e123673b1e74dda6a76c55cacbbfbebde0221))
+
+
+### Bug Fixes
+
+* add AxonEventView schema to OpenAPI spec for SSE subscribe endpoint ([#8274](https://github.com/runloopai/api-client-ts/issues/8274)) ([6966e67](https://github.com/runloopai/api-client-ts/commit/6966e67e79a5a605cf7e4a6b60cccf851961eb60))
+* add name to Axon ([#8277](https://github.com/runloopai/api-client-ts/issues/8277)) ([3e9232b](https://github.com/runloopai/api-client-ts/commit/3e9232ba1ba650a4deed68ade5de97a3f80436bf))
+* avoid actually calling claude in example ([#753](https://github.com/runloopai/api-client-ts/issues/753)) ([7425502](https://github.com/runloopai/api-client-ts/commit/742550288e6d83a55635feda2ca3496ea1d70115))
+* **tunnels:** allow tunnel removal ([#8257](https://github.com/runloopai/api-client-ts/issues/8257)) ([049b89c](https://github.com/runloopai/api-client-ts/commit/049b89c2c7ee56ce50794ab21bdc29ffd82d0e0f))
+
+
+### Chores
+
+* **internal:** update gitignore ([52bd497](https://github.com/runloopai/api-client-ts/commit/52bd497f637f69df7c4d0b1b5252e0ebf6e185e5))
+* remove dead port configuration code, mark deprecated / ignored in the API ([#8195](https://github.com/runloopai/api-client-ts/issues/8195)) ([960a249](https://github.com/runloopai/api-client-ts/commit/960a249773062d0b9c3835b6a10edcd16cb0e812))
+* **tests:** bump steady to v0.19.4 ([3b49bf8](https://github.com/runloopai/api-client-ts/commit/3b49bf814b0e2fdb6695f3c1afe84a454af7a28b))
+* **tests:** bump steady to v0.19.5 ([c7d6cc2](https://github.com/runloopai/api-client-ts/commit/c7d6cc25481ee89dab3310885d1cb4d5521a62aa))
+* **tests:** bump steady to v0.19.6 ([695a7d2](https://github.com/runloopai/api-client-ts/commit/695a7d2a8c77c1bb3300a3e9be7e5395273a1bc2))
+
+
+### Documentation
+
+* add mounts example ([#752](https://github.com/runloopai/api-client-ts/issues/752)) ([8b8eda2](https://github.com/runloopai/api-client-ts/commit/8b8eda2764d980a372f8f0d76898e83fceb64f97))
+* add suspend, resume & snapshot documentation ([#754](https://github.com/runloopai/api-client-ts/issues/754)) ([0295cc6](https://github.com/runloopai/api-client-ts/commit/0295cc645201a5c3abae489ae08ad689c5dfadb1))
+
+
+### Refactors
+
+* **tests:** switch from prism to steady ([1ad5e76](https://github.com/runloopai/api-client-ts/commit/1ad5e7623d62f06c3aef1f6f11c57fb1fb6ff162))
+* undeprecate total_count from pagination API, remove remaining_count ([#8084](https://github.com/runloopai/api-client-ts/issues/8084)) ([6d2a604](https://github.com/runloopai/api-client-ts/commit/6d2a6041e49f1f9ca85ae1f43d7be94041e87610))
+
 ## 1.11.2 (2026-03-19)
 
 Full Changelog: [v1.11.1...v1.11.2](https://github.com/runloopai/api-client-ts/compare/v1.11.1...v1.11.2)

CONTRIBUTING.md

@@ -65,7 +65,7 @@ $ pnpm link --global @runloop/api-client
 
 ## Running tests
 
-Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
+Most tests require you to [set up a mock server](https://github.com/dgellow/steady) against the OpenAPI spec to run the tests.
 
 ```sh
 $ ./scripts/mock

api.md

@@ -76,6 +76,25 @@ Methods:
 - <code title="get /v1/agents/{id}">client.agents.<a href="./src/resources/agents.ts">retrieve</a>(id) -> AgentView</code>
 - <code title="get /v1/agents">client.agents.<a href="./src/resources/agents.ts">list</a>({ ...params }) -> AgentViewsAgentsCursorIDPage</code>
 
+# Axons
+
+Types:
+
+- <code><a href="./src/resources/axons.ts">AxonCreateParams</a></code>
+- <code><a href="./src/resources/axons.ts">AxonEventView</a></code>
+- <code><a href="./src/resources/axons.ts">AxonListView</a></code>
+- <code><a href="./src/resources/axons.ts">AxonView</a></code>
+- <code><a href="./src/resources/axons.ts">PublishParams</a></code>
+- <code><a href="./src/resources/axons.ts">PublishResultView</a></code>
+
+Methods:
+
+- <code title="post /v1/axons">client.axons.<a href="./src/resources/axons.ts">create</a>({ ...params }) -> AxonView</code>
+- <code title="get /v1/axons/{id}">client.axons.<a href="./src/resources/axons.ts">retrieve</a>(id) -> AxonView</code>
+- <code title="get /v1/axons">client.axons.<a href="./src/resources/axons.ts">list</a>() -> AxonListView</code>
+- <code title="post /v1/axons/{id}/publish">client.axons.<a href="./src/resources/axons.ts">publish</a>(id, { ...params }) -> PublishResultView</code>
+- <code title="get /v1/axons/{id}/subscribe/sse">client.axons.<a href="./src/resources/axons.ts">subscribeSse</a>(id) -> AxonEventView</code>
+
 # Blueprints
 
 Types:
@@ -139,7 +158,7 @@ Methods:
 - <code title="post /v1/devboxes/{id}/keep_alive">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">keepAlive</a>(id) -> unknown</code>
 - <code title="get /v1/devboxes/disk_snapshots">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">listDiskSnapshots</a>({ ...params }) -> DevboxSnapshotViewsDiskSnapshotsCursorIDPage</code>
 - <code title="post /v1/devboxes/{id}/read_file_contents">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">readFileContents</a>(id, { ...params }) -> string</code>
-- <code title="post /v1/devboxes/{id}/remove_tunnel">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">removeTunnel</a>(id, { ...params }) -> unknown</code>
+- <code title="post /v1/devboxes/{id}/remove_tunnel">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">removeTunnel</a>(id) -> unknown</code>
 - <code title="post /v1/devboxes/{id}/resume">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">resume</a>(id) -> DevboxView</code>
 - <code title="get /v1/devboxes/{id}/usage">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">retrieveResourceUsage</a>(id) -> DevboxResourceUsageView</code>
 - <code title="post /v1/devboxes/{id}/shutdown">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">shutdown</a>(id, { ...params }) -> DevboxView</code>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runloop/api-client",
-  "version": "1.11.2",
+  "version": "1.12.0",
   "description": "The official TypeScript library for the Runloop API",
   "author": "Runloop <support@runloop.ai>",
   "types": "dist/sdk.d.ts",

packages/mcp-server/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "@runloop/api-client-mcp",
-  "version": "1.11.2",
+  "version": "1.12.0",
   "description": "The official MCP Server for the Runloop API",
   "author": {
     "name": "Runloop",

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runloop/api-client-mcp",
-  "version": "1.11.2",
+  "version": "1.12.0",
   "description": "The official MCP Server for the Runloop API",
   "author": "Runloop <support@runloop.ai>",
   "types": "dist/index.d.ts",

packages/mcp-server/src/server.ts

@@ -16,7 +16,7 @@ export const newMcpServer = async (stainlessApiKey: string | undefined) =>
   new McpServer(
     {
       name: 'runloop_api_client_api',
-      version: '1.11.2',
+      version: '1.12.0',
     },
     {
       instructions: await getInstructions(stainlessApiKey),

scripts/mock

@@ -19,34 +19,34 @@ fi
 
 echo "==> Starting mock server with URL ${URL}"
 
-# Run prism mock on the given spec
+# Run steady mock on the given spec
 if [ "$1" == "--daemon" ]; then
   # Pre-install the package so the download doesn't eat into the startup timeout
-  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism --version
+  npm exec --package=@stdy/cli@0.19.6 -- steady --version
 
-  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL" &> .prism.log &
+  npm exec --package=@stdy/cli@0.19.6 -- steady --host 127.0.0.1 -p 4010 --validator-form-array-format=comma --validator-query-array-format=comma --validator-form-object-format=brackets --validator-query-object-format=brackets "$URL" &> .stdy.log &
 
-  # Wait for server to come online (max 30s)
+  # Wait for server to come online via health endpoint (max 30s)
   echo -n "Waiting for server"
   attempts=0
-  while ! grep -q "✖  fatal\|Prism is listening" ".prism.log" ; do
+  while ! curl --silent --fail "http://127.0.0.1:4010/_x-steady/health" >/dev/null 2>&1; do
+    if ! kill -0 $! 2>/dev/null; then
+      echo
+      cat .stdy.log
+      exit 1
+    fi
     attempts=$((attempts + 1))
     if [ "$attempts" -ge 300 ]; then
       echo
-      echo "Timed out waiting for Prism server to start"
-      cat .prism.log
+      echo "Timed out waiting for Steady server to start"
+      cat .stdy.log
       exit 1
     fi
     echo -n "."
     sleep 0.1
   done
 
-  if grep -q "✖  fatal" ".prism.log"; then
-    cat .prism.log
-    exit 1
-  fi
-
   echo
 else
-  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL"
+  npm exec --package=@stdy/cli@0.19.6 -- steady --host 127.0.0.1 -p 4010 --validator-form-array-format=comma --validator-query-array-format=comma --validator-form-object-format=brackets --validator-query-object-format=brackets "$URL"
 fi

scripts/test

@@ -9,6 +9,10 @@ GREEN='\033[0;32m'
 YELLOW='\033[0;33m'
 NC='\033[0m' # No Color
 
+function steady_is_running() {
+  curl --silent "http://127.0.0.1:4010/_x-steady/health" >/dev/null 2>&1
+}
+
 # Parse command line arguments
 RUN_SMOKE_TESTS=false
 JEST_ARGS=()
@@ -26,10 +30,6 @@ while [[ $# -gt 0 ]]; do
   esac
 done
 
-function prism_is_running() {
-  curl --silent "http://localhost:4010" >/dev/null 2>&1
-}
-
 kill_server_on_port() {
   pids=$(lsof -t -i tcp:"$1" || echo "")
   if [ "$pids" != "" ]; then
@@ -42,7 +42,7 @@ function is_overriding_api_base_url() {
   [ -n "$TEST_API_BASE_URL" ]
 }
 
-if ! is_overriding_api_base_url && ! prism_is_running ; then
+if ! is_overriding_api_base_url && ! steady_is_running ; then
   # When we exit this script, make sure to kill the background mock server process
   trap 'kill_server_on_port 4010' EXIT
 
@@ -53,19 +53,19 @@ fi
 if is_overriding_api_base_url ; then
   echo -e "${GREEN}✔ Running tests against ${TEST_API_BASE_URL}${NC}"
   echo
-elif ! prism_is_running ; then
-  echo -e "${RED}ERROR:${NC} The test suite will not run without a mock Prism server"
+elif ! steady_is_running ; then
+  echo -e "${RED}ERROR:${NC} The test suite will not run without a mock Steady server"
   echo -e "running against your OpenAPI spec."
   echo
   echo -e "To run the server, pass in the path or url of your OpenAPI"
-  echo -e "spec to the prism command:"
+  echo -e "spec to the steady command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock path/to/your.openapi.yml${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.19.6 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-form-array-format=comma --validator-query-array-format=comma --validator-form-object-format=brackets --validator-query-object-format=brackets${NC}"
   echo
 
   exit 1
 else
-  echo -e "${GREEN}✔ Mock prism server is running with your OpenAPI spec${NC}"
+  echo -e "${GREEN}✔ Mock steady server is running with your OpenAPI spec${NC}"
   echo
 fi
 

src/index.ts

@@ -45,6 +45,16 @@ import {
   AgentViewsAgentsCursorIDPage,
   Agents,
 } from './resources/agents';
+import {
+  AxonCreateParams,
+  AxonEventView,
+  AxonListView,
+  AxonPublishParams,
+  AxonView,
+  Axons,
+  PublishParams,
+  PublishResultView,
+} from './resources/axons';
 import {
   BenchmarkJobCreateParameters,
   BenchmarkJobCreateParams,
@@ -191,7 +201,6 @@ import {
   DevboxListView,
   DevboxReadFileContentsParams,
   DevboxReadFileContentsResponse,
-  DevboxRemoveTunnelParams,
   DevboxRemoveTunnelResponse,
   DevboxResourceUsageView,
   DevboxSendStdInRequest,
@@ -364,6 +373,7 @@ export class Runloop extends Core.APIClient {
   benchmarkRuns: API.BenchmarkRuns = new API.BenchmarkRuns(this);
   benchmarkJobs: API.BenchmarkJobs = new API.BenchmarkJobs(this);
   agents: API.Agents = new API.Agents(this);
+  axons: API.Axons = new API.Axons(this);
   blueprints: API.Blueprints = new API.Blueprints(this);
   devboxes: API.Devboxes = new API.Devboxes(this);
   scenarios: API.Scenarios = new API.Scenarios(this);
@@ -424,6 +434,7 @@ Runloop.BenchmarkRunViewsBenchmarkRunsCursorIDPage = BenchmarkRunViewsBenchmarkR
 Runloop.BenchmarkJobs = BenchmarkJobs;
 Runloop.Agents = Agents;
 Runloop.AgentViewsAgentsCursorIDPage = AgentViewsAgentsCursorIDPage;
+Runloop.Axons = Axons;
 Runloop.Blueprints = Blueprints;
 Runloop.BlueprintViewsBlueprintsCursorIDPage = BlueprintViewsBlueprintsCursorIDPage;
 Runloop.Devboxes = Devboxes;
@@ -576,6 +587,17 @@ export declare namespace Runloop {
     type AgentListParams as AgentListParams,
   };
 
+  export {
+    Axons as Axons,
+    type AxonCreateParams as AxonCreateParams,
+    type AxonEventView as AxonEventView,
+    type AxonListView as AxonListView,
+    type AxonView as AxonView,
+    type PublishParams as PublishParams,
+    type PublishResultView as PublishResultView,
+    type AxonPublishParams as AxonPublishParams,
+  };
+
   export {
     Blueprints as Blueprints,
     type BlueprintBuildFromInspectionParameters as BlueprintBuildFromInspectionParameters,
@@ -626,7 +648,6 @@ export declare namespace Runloop {
     type DevboxExecuteSyncParams as DevboxExecuteSyncParams,
     type DevboxListDiskSnapshotsParams as DevboxListDiskSnapshotsParams,
     type DevboxReadFileContentsParams as DevboxReadFileContentsParams,
-    type DevboxRemoveTunnelParams as DevboxRemoveTunnelParams,
     type DevboxShutdownParams as DevboxShutdownParams,
     type DevboxSnapshotDiskParams as DevboxSnapshotDiskParams,
     type DevboxSnapshotDiskAsyncParams as DevboxSnapshotDiskAsyncParams,

src/resources/agents.ts

@@ -78,14 +78,7 @@ export interface AgentListView {
   has_more: boolean;
 
   /**
-   * The count of remaining Agents. Deprecated: will be removed in a future breaking
-   * change.
-   */
-  remaining_count?: number | null;
-
-  /**
-   * The total count of Agents. Deprecated: will be removed in a future breaking
-   * change.
+   * The total count of Agents.
    */
   total_count?: number | null;
 }
@@ -150,6 +143,12 @@ export interface AgentCreateParams {
 }
 
 export interface AgentListParams extends AgentsCursorIDPageParams {
+  /**
+   * If true (default), includes total_count in the response. Set to false to skip
+   * the count query for better performance on large datasets.
+   */
+  include_total_count?: boolean;
+
   /**
    * Filter agents by public visibility.
    */