release: 1.18.1 (#778)

stainless-app[bot] · web-flow · commit 3d7c9aa281b8 · 2026-04-10T02:18:27.000Z
Co-authored-by: stainless-app[bot] &lt;142633134+stainless-app[bot]@users.noreply.github.com&gt;
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "1.18.0"
+  ".": "1.18.1"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 109
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-a1c7e69cbbf7a7cf63893358470cee52714633e6d31ce6dff2e7255c7445a1aa.yml
-openapi_spec_hash: a0e88c05a9b74c2bc9192bd7d94de3c0
-config_hash: ecb1ff09d29b565ed1452b5e0362e64d
+configured_endpoints: 110
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-f0eb12cf4df4fa3046bd88aae4966062eb6e9703768a07a0136da2f26a2ebd56.yml
+openapi_spec_hash: cdbd63a8162f1e987e937042cbd60eea
+config_hash: 526cf0707adc54c690fc687a1c6db728
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+## 1.18.1 (2026-04-10)
+
+Full Changelog: [v1.18.0...v1.18.1](https://github.com/runloopai/api-client-ts/compare/v1.18.0...v1.18.1)
+
+### Bug Fixes
+
+* add list events to axon ([#8648](https://github.com/runloopai/api-client-ts/issues/8648)) ([413113e](https://github.com/runloopai/api-client-ts/commit/413113e1ffae4864ec742c43a01569b8ad134047))
+* TTL shutdown showed non-standard reason in devbox logs ([#8636](https://github.com/runloopai/api-client-ts/issues/8636)) ([16c33d5](https://github.com/runloopai/api-client-ts/commit/16c33d5cba17dbbf8fc58a4f4e88ac206c732411))
+
+
+### Documentation
+
+* clarify that we don't support git commit SHA in git agents/blueprint builds ([#8638](https://github.com/runloopai/api-client-ts/issues/8638)) ([0d635d1](https://github.com/runloopai/api-client-ts/commit/0d635d18dfe56aa75dfedabbe47fb45cd376bbef))
+
 ## 1.18.0 (2026-04-09)
 
 Full Changelog: [v1.17.0...v1.18.0](https://github.com/runloopai/api-client-ts/compare/v1.17.0...v1.18.0)
diff --git a/api.md b/api.md
@@ -96,6 +96,16 @@ Methods:
 - <code title="post /v1/axons/{id}/publish">client.axons.<a href="./src/resources/axons/axons.ts">publish</a>(id, { ...params }) -> PublishResultView</code>
 - <code title="get /v1/axons/{id}/subscribe/sse">client.axons.<a href="./src/resources/axons/axons.ts">subscribeSse</a>(id, { ...params }) -> AxonEventView</code>
 
+## Events
+
+Types:
+
+- <code><a href="./src/resources/axons/events.ts">AxonEventListView</a></code>
+
+Methods:
+
+- <code title="get /v1/axons/{id}/events">client.axons.events.<a href="./src/resources/axons/events.ts">list</a>(id, { ...params }) -> AxonEventListView</code>
+
 ## Sql
 
 Types:
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@runloop/api-client",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "The official TypeScript library for the Runloop API",
   "author": "Runloop <support@runloop.ai>",
   "types": "dist/sdk.d.ts",
diff --git a/packages/mcp-server/manifest.json b/packages/mcp-server/manifest.json
@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "@runloop/api-client-mcp",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "The official MCP Server for the Runloop API",
   "author": {
     "name": "Runloop",
diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@runloop/api-client-mcp",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "The official MCP Server for the Runloop API",
   "author": "Runloop <support@runloop.ai>",
   "types": "dist/index.d.ts",
diff --git a/packages/mcp-server/src/server.ts b/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.18.0',
+      version: '1.18.1',
     },
     {
       instructions: await getInstructions(stainlessApiKey),
diff --git a/src/resources/axons/axons.ts b/src/resources/axons/axons.ts
@@ -4,6 +4,8 @@ import { APIResource } from '../../resource';
 import { isRequestOptions } from '../../core';
 import { APIPromise } from '../../core';
 import * as Core from '../../core';
+import * as EventsAPI from './events';
+import { AxonEventListView, EventListParams, Events } from './events';
 import * as SqlAPI from './sql';
 import {
   Sql,
@@ -22,6 +24,7 @@ import { Stream } from '../../streaming';
 import { withStreamAutoReconnect } from '@runloop/api-client/lib/streaming-reconnection';
 
 export class Axons extends APIResource {
+  events: EventsAPI.Events = new EventsAPI.Events(this._client);
   sql: SqlAPI.Sql = new SqlAPI.Sql(this._client);
 
   /**
@@ -273,6 +276,7 @@ export interface AxonSubscribeSseParams {
 }
 
 Axons.AxonViewsAxonsCursorIDPage = AxonViewsAxonsCursorIDPage;
+Axons.Events = Events;
 Axons.Sql = Sql;
 
 export declare namespace Axons {
@@ -289,6 +293,12 @@ export declare namespace Axons {
     type AxonSubscribeSseParams as AxonSubscribeSseParams,
   };
 
+  export {
+    Events as Events,
+    type AxonEventListView as AxonEventListView,
+    type EventListParams as EventListParams,
+  };
+
   export {
     Sql as Sql,
     type SqlBatchParams as SqlBatchParams,
diff --git a/src/resources/axons/events.ts b/src/resources/axons/events.ts
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../resource';
+import { isRequestOptions } from '../../core';
+import * as Core from '../../core';
+import * as AxonsAPI from './axons';
+
+export class Events extends APIResource {
+  /**
+   * [Beta] List events from an axon's event stream, ordered by sequence descending.
+   */
+  list(
+    id: string,
+    query?: EventListParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AxonEventListView>;
+  list(id: string, options?: Core.RequestOptions): Core.APIPromise<AxonEventListView>;
+  list(
+    id: string,
+    query: EventListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AxonEventListView> {
+    if (isRequestOptions(query)) {
+      return this.list(id, {}, query);
+    }
+    return this._client.get(`/v1/axons/${id}/events`, { query, ...options });
+  }
+}
+
+export interface AxonEventListView {
+  /**
+   * List of axon events.
+   */
+  events: Array<AxonsAPI.AxonEventView>;
+
+  has_more: boolean;
+
+  total_count?: number | null;
+}
+
+export interface EventListParams {
+  /**
+   * 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;
+
+  /**
+   * The limit of items to return. Default is 20. Max is 5000.
+   */
+  limit?: number;
+
+  /**
+   * Load the next page of data starting after the item with the given ID.
+   */
+  starting_after?: string;
+}
+
+export declare namespace Events {
+  export { type AxonEventListView as AxonEventListView, type EventListParams as EventListParams };
+}
diff --git a/src/resources/axons/index.ts b/src/resources/axons/index.ts
@@ -13,6 +13,7 @@ export {
   type AxonPublishParams,
   type AxonSubscribeSseParams,
 } from './axons';
+export { Events, type AxonEventListView, type EventListParams } from './events';
 export {
   Sql,
   type SqlBatchParams,
diff --git a/src/resources/devboxes/devboxes.ts b/src/resources/devboxes/devboxes.ts
@@ -893,7 +893,7 @@ export interface DevboxView {
    * The shutdown reason if the Devbox shutdown, if the Devbox has a 'shutdown'
    * status.
    */
-  shutdown_reason?: 'api_shutdown' | 'keep_alive_timeout' | 'entrypoint_exit' | 'idle' | null;
+  shutdown_reason?: 'api_shutdown' | 'keep_alive_timeout' | 'entrypoint_exit' | 'idle' | 'ttl_expired' | null;
 
   /**
    * The Snapshot ID used in creation of the Devbox, if the devbox was created from a
diff --git a/src/resources/shared.ts b/src/resources/shared.ts
@@ -203,8 +203,8 @@ export interface CodeMountParameters {
   token?: string | null;
 
   /**
-   * Optional git ref (branch, tag, or commit SHA) to checkout. Defaults to the
-   * repository default branch.
+   * Optional git ref (branch or tag) to checkout. Defaults to the repository default
+   * branch.
    */
   git_ref?: string | null;
 
@@ -388,8 +388,8 @@ export namespace Mount {
     token?: string | null;
 
     /**
-     * Optional git ref (branch, tag, or commit SHA) to checkout. Defaults to the
-     * repository default branch.
+     * Optional git ref (branch or tag) to checkout. Defaults to the repository default
+     * branch.
      */
     git_ref?: string | null;
 
diff --git a/src/version.ts b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '1.18.0'; // x-release-please-version
+export const VERSION = '1.18.1'; // x-release-please-version
diff --git a/tests/api-resources/axons/events.test.ts b/tests/api-resources/axons/events.test.ts
@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import Runloop from '@runloop/api-client';
+import { Response } from 'node-fetch';
+
+const client = new Runloop({
+  bearerToken: 'My Bearer Token',
+  baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010',
+});
+
+describe('resource events', () => {
+  test('list', async () => {
+    const responsePromise = client.axons.events.list('id');
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  test('list: request options instead of params are passed correctly', async () => {
+    // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
+    await expect(client.axons.events.list('id', { path: '/_stainless_unknown_path' })).rejects.toThrow(
+      Runloop.NotFoundError,
+    );
+  });
+
+  test('list: request options and params are passed correctly', async () => {
+    // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
+    await expect(
+      client.axons.events.list(
+        'id',
+        {
+          include_total_count: true,
+          limit: 0,
+          starting_after: 'starting_after',
+        },
+        { path: '/_stainless_unknown_path' },
+      ),
+    ).rejects.toThrow(Runloop.NotFoundError);
+  });
+});

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "1.18.0"`
	`2`	`+ ".": "1.18.1"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@runloop/api-client",`
`3`		`- "version": "1.18.0",`
	`3`	`+ "version": "1.18.1",`
`4`	`4`	`"description": "The official TypeScript library for the Runloop API",`
`5`	`5`	`"author": "Runloop <support@runloop.ai>",`
`6`	`6`	`"types": "dist/sdk.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"dxt_version": "0.2",`
`3`	`3`	`"name": "@runloop/api-client-mcp",`
`4`		`- "version": "1.18.0",`
	`4`	`+ "version": "1.18.1",`
`5`	`5`	`"description": "The official MCP Server for the Runloop API",`
`6`	`6`	`"author": {`
`7`	`7`	`"name": "Runloop",`
Original file line number	Diff line number	Diff line change
`@@ -16,7 +16,7 @@ export const newMcpServer = async (stainlessApiKey: string \| undefined) =>`
`16`	`16`	`new McpServer(`
`17`	`17`	`{`
`18`	`18`	`name: 'runloop_api_client_api',`
`19`		`- version: '1.18.0',`
	`19`	`+ version: '1.18.1',`
`20`	`20`	`},`
`21`	`21`	`{`
`22`	`22`	`instructions: await getInstructions(stainlessApiKey),`