release: 1.18.0 (#774)

stainless-app[bot] · web-flow · commit bdffdb83ba37 · 2026-04-09T19:17:24.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.17.0"
+  ".": "1.18.0"
 }
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-b0d4f639559e78ee64d536a35464cff1ef1928e92c2a32a0384dc887da662ef3.yml
-openapi_spec_hash: a822f02fec32ae89e2bc6a6f95b8845f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-a1c7e69cbbf7a7cf63893358470cee52714633e6d31ce6dff2e7255c7445a1aa.yml
+openapi_spec_hash: a0e88c05a9b74c2bc9192bd7d94de3c0
 config_hash: ecb1ff09d29b565ed1452b5e0362e64d
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,33 @@
 # Changelog
 
+## 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)
+
+### Features
+
+* Add protocol, launch etc arguments to attach axon grpc, persist them in the db ([#8564](https://github.com/runloopai/api-client-ts/issues/8564)) ([76f0a17](https://github.com/runloopai/api-client-ts/commit/76f0a1764044e81f8a7484ea1217833e040a5d3d))
+* **api:** add lifecycle configuration to launch parameters ([#8606](https://github.com/runloopai/api-client-ts/issues/8606)) ([83e7cfa](https://github.com/runloopai/api-client-ts/commit/83e7cfa0eb34eecb85a106e1f62c7515b28a4796))
+* stream kernel messages (kmsg) to devbox logs ([#8588](https://github.com/runloopai/api-client-ts/issues/8588)) ([6350865](https://github.com/runloopai/api-client-ts/commit/63508655a22a511a518f578b7307cb9abe778af6))
+
+
+### Bug Fixes
+
+* **broker:** remove codex in favor of codex via acp ([#8602](https://github.com/runloopai/api-client-ts/issues/8602)) ([2b4f672](https://github.com/runloopai/api-client-ts/commit/2b4f6721930fe9ffa66bd146f382d5c5d13793cd))
+* propagate git ref to maverick for git-based agents ([#8608](https://github.com/runloopai/api-client-ts/issues/8608)) ([5ae92ae](https://github.com/runloopai/api-client-ts/commit/5ae92ae53fe7f0435eccce602c673cca758293dc))
+
+
+### Chores
+
+* Cleanup remaining junk left over from browser and computer use ([#8553](https://github.com/runloopai/api-client-ts/issues/8553)) ([3aae2ca](https://github.com/runloopai/api-client-ts/commit/3aae2cade2fb3cc6e5fa4b84fa4c249bbfc88265))
+* **internal:** codegen related update ([81db5f0](https://github.com/runloopai/api-client-ts/commit/81db5f05681c16696c9cd513c8aab7fcb6b467e5))
+* make smoketests faster via test.concurrent, no sharding, 800% workers ([#773](https://github.com/runloopai/api-client-ts/issues/773)) ([d5d7a29](https://github.com/runloopai/api-client-ts/commit/d5d7a29c881c6bbd6a8158a2785327ec6ab911e3))
+
+
+### Documentation
+
+* fix typo, fix repoc/git-based agent mounts ignoring custom mount paths ([#8537](https://github.com/runloopai/api-client-ts/issues/8537)) ([eedbc55](https://github.com/runloopai/api-client-ts/commit/eedbc55f6b1a40cb55614d64978c1ff4c43aa84b))
+
 ## 1.17.0 (2026-04-03)
 
 Full Changelog: [v1.16.2...v1.17.0](https://github.com/runloopai/api-client-ts/compare/v1.16.2...v1.17.0)
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@runloop/api-client",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "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.17.0",
+  "version": "1.18.0",
   "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.17.0",
+  "version": "1.18.0",
   "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.17.0',
+      version: '1.18.0',
     },
     {
       instructions: await getInstructions(stainlessApiKey),
diff --git a/src/core.ts b/src/core.ts
@@ -1085,10 +1085,10 @@ export const ensurePresent = <T>(value: T | null | undefined): T => {
  */
 export const readEnv = (env: string): string | undefined => {
   if (typeof process !== 'undefined') {
-    return process.env?.[env]?.trim() ?? undefined;
+    return process.env?.[env]?.trim() || undefined;
   }
   if (typeof Deno !== 'undefined') {
-    return Deno.env?.get?.(env)?.trim();
+    return Deno.env?.get?.(env)?.trim() || undefined;
   }
   return undefined;
 };
diff --git a/src/resources/blueprints.ts b/src/resources/blueprints.ts
@@ -530,7 +530,7 @@ export interface BlueprintView {
   /**
    * Capabilities that will be available on Devbox.
    */
-  devbox_capabilities?: Array<'unknown' | 'computer_usage' | 'browser_usage' | 'docker_in_docker'> | null;
+  devbox_capabilities?: Array<'unknown' | 'docker_in_docker'> | null;
 
   /**
    * The failure reason if the Blueprint build failed, if any.
diff --git a/src/resources/devboxes/devboxes.ts b/src/resources/devboxes/devboxes.ts
@@ -807,10 +807,9 @@ export interface DevboxView {
   id: string;
 
   /**
-   * A list of capability groups this devbox has access to. This allows devboxes to
-   * be compatible with certain tools sets like computer usage APIs.
+   * A list of capability groups this devbox has access to.
    */
-  capabilities: Array<'unknown' | 'computer_usage' | 'browser_usage' | 'docker_in_docker'>;
+  capabilities: Array<'unknown' | 'docker_in_docker'>;
 
   /**
    * Creation time of the Devbox (Unix timestamp milliseconds).
@@ -1203,7 +1202,9 @@ export namespace DevboxCreateParams {
 
     /**
      * When true, HTTP traffic to a suspended devbox will automatically trigger a
-     * resume. Defaults to false if not specified.
+     * resume. Defaults to false if not specified. Prefer
+     * lifecycle.resume_triggers.http on launch_parameters for new integrations. If
+     * both are set, lifecycle.resume_triggers.http takes precedence.
      */
     wake_on_http?: boolean | null;
   }
@@ -1264,7 +1265,9 @@ export interface DevboxEnableTunnelParams {
 
   /**
    * When true, HTTP traffic to a suspended devbox will automatically trigger a
-   * resume. Defaults to false if not specified.
+   * resume. Defaults to false if not specified. Prefer
+   * lifecycle.resume_triggers.http on launch_parameters for new integrations. If
+   * both are set, lifecycle.resume_triggers.http takes precedence.
    */
   wake_on_http?: boolean | null;
 }
diff --git a/src/resources/devboxes/logs.ts b/src/resources/devboxes/logs.ts
@@ -39,7 +39,7 @@ export namespace DevboxLogsListView {
     /**
      * The source of the log.
      */
-    source: 'setup_commands' | 'entrypoint' | 'exec' | 'files' | 'stats';
+    source: 'setup_commands' | 'entrypoint' | 'exec' | 'files' | 'stats' | 'kmsg';
 
     /**
      * Time of log (Unix timestamp milliseconds).
diff --git a/src/resources/shared.ts b/src/resources/shared.ts
@@ -1,5 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import * as Shared from './shared';
+
 /**
  * Configuration for automatic Devbox behavior after idle time.
  *
@@ -161,19 +163,21 @@ export interface BrokerMount {
   type: 'broker_mount';
 
   /**
-   * Binary to launch the agent (e.g., 'opencode'). Used by ACP broker.
+   * Binary to launch the agent (e.g., 'opencode'). Used by protocols that launch a
+   * subprocess (acp, claude_json).
    */
   agent_binary?: string | null;
 
   /**
-   * Arguments to pass to the agent command (e.g., ['acp']). Used by ACP broker.
+   * Arguments to pass to the agent command (e.g., ['acp']). Used by protocols that
+   * launch a subprocess (acp, claude_json).
    */
   launch_args?: Array<string> | null;
 
   /**
    * The protocol used by the broker to deliver events to the agent.
    */
-  protocol?: 'acp' | 'claude_json' | 'codex_app_server' | null;
+  protocol?: 'acp' | 'claude_json' | null;
 }
 
 /**
@@ -184,7 +188,7 @@ export interface BrokerMount {
 export interface CodeMountParameters {
   /**
    * The name of the repo to mount. By default, code will be mounted at
-   * /home/user/{repo_name}s.
+   * /home/user/{repo_name}.
    */
   repo_name: string;
 
@@ -198,6 +202,12 @@ export interface CodeMountParameters {
    */
   token?: string | null;
 
+  /**
+   * Optional git ref (branch, tag, or commit SHA) to checkout. Defaults to the
+   * repository default branch.
+   */
+  git_ref?: string | null;
+
   /**
    * Installation command to install and setup repository.
    */
@@ -214,7 +224,8 @@ export interface CodeMountParameters {
 export interface LaunchParameters {
   /**
    * Configure Devbox lifecycle based on idle activity. If after_idle is set, Devbox
-   * will ignore keep_alive_time_seconds.
+   * will ignore keep_alive_time_seconds. If both after_idle and lifecycle.after_idle
+   * are set, they must have the same value. Use lifecycle.after_idle instead.
    */
   after_idle?: AfterIdle | null;
 
@@ -255,6 +266,13 @@ export interface LaunchParameters {
    */
   launch_commands?: Array<string> | null;
 
+  /**
+   * Lifecycle configuration for idle and resume behavior. Configure idle policy via
+   * lifecycle.after_idle (if both this and the top-level after_idle are set, they
+   * must match) and resume triggers via lifecycle.resume_triggers.
+   */
+  lifecycle?: LaunchParameters.Lifecycle | null;
+
   /**
    * (Optional) ID of the network policy to apply to Devboxes launched with these
    * parameters. When set on a Blueprint launch parameters, Devboxes created from it
@@ -294,6 +312,37 @@ export interface LaunchParameters {
 }
 
 export namespace LaunchParameters {
+  /**
+   * Lifecycle configuration for idle and resume behavior. Configure idle policy via
+   * lifecycle.after_idle (if both this and the top-level after_idle are set, they
+   * must match) and resume triggers via lifecycle.resume_triggers.
+   */
+  export interface Lifecycle {
+    /**
+     * Configure Devbox lifecycle based on idle activity. If both this and the
+     * top-level after_idle are set, they must have the same value. Prefer this field
+     * for new integrations.
+     */
+    after_idle?: Shared.AfterIdle | null;
+
+    /**
+     * Triggers that can resume a suspended Devbox.
+     */
+    resume_triggers?: Lifecycle.ResumeTriggers | null;
+  }
+
+  export namespace Lifecycle {
+    /**
+     * Triggers that can resume a suspended Devbox.
+     */
+    export interface ResumeTriggers {
+      /**
+       * When true, HTTP traffic to a suspended Devbox via tunnel will trigger a resume.
+       */
+      http?: boolean | null;
+    }
+  }
+
   /**
    * Specify the user for execution on Devbox. If not set, default `user` will be
    * used.
@@ -322,7 +371,7 @@ export namespace Mount {
   export interface CodeMount {
     /**
      * The name of the repo to mount. By default, code will be mounted at
-     * /home/user/{repo_name}s.
+     * /home/user/{repo_name}.
      */
     repo_name: string;
 
@@ -338,6 +387,12 @@ export namespace Mount {
      */
     token?: string | null;
 
+    /**
+     * Optional git ref (branch, tag, or commit SHA) to checkout. Defaults to the
+     * repository default branch.
+     */
+    git_ref?: string | null;
+
     /**
      * Installation command to install and setup repository.
      */
diff --git a/src/version.ts b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '1.17.0'; // x-release-please-version
+export const VERSION = '1.18.0'; // x-release-please-version
diff --git a/tests/api-resources/benchmarks.test.ts b/tests/api-resources/benchmarks.test.ts
@@ -208,6 +208,10 @@ describe('resource benchmarks', () => {
           custom_gb_memory: 0,
           keep_alive_time_seconds: 0,
           launch_commands: ['string'],
+          lifecycle: {
+            after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+            resume_triggers: { http: true },
+          },
           network_policy_id: 'network_policy_id',
           required_services: ['string'],
           resource_size_request: 'X_SMALL',
diff --git a/tests/api-resources/blueprints.test.ts b/tests/api-resources/blueprints.test.ts
@@ -32,6 +32,7 @@ describe('resource blueprints', () => {
           repo_name: 'repo_name',
           repo_owner: 'repo_owner',
           token: 'token',
+          git_ref: 'git_ref',
           install_command: 'install_command',
         },
       ],
@@ -46,6 +47,10 @@ describe('resource blueprints', () => {
         custom_gb_memory: 0,
         keep_alive_time_seconds: 0,
         launch_commands: ['string'],
+        lifecycle: {
+          after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+          resume_triggers: { http: true },
+        },
         network_policy_id: 'network_policy_id',
         required_services: ['string'],
         resource_size_request: 'X_SMALL',
@@ -191,6 +196,10 @@ describe('resource blueprints', () => {
         custom_gb_memory: 0,
         keep_alive_time_seconds: 0,
         launch_commands: ['string'],
+        lifecycle: {
+          after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+          resume_triggers: { http: true },
+        },
         network_policy_id: 'network_policy_id',
         required_services: ['string'],
         resource_size_request: 'X_SMALL',
@@ -277,6 +286,7 @@ describe('resource blueprints', () => {
           repo_name: 'repo_name',
           repo_owner: 'repo_owner',
           token: 'token',
+          git_ref: 'git_ref',
           install_command: 'install_command',
         },
       ],
@@ -291,6 +301,10 @@ describe('resource blueprints', () => {
         custom_gb_memory: 0,
         keep_alive_time_seconds: 0,
         launch_commands: ['string'],
+        lifecycle: {
+          after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+          resume_triggers: { http: true },
+        },
         network_policy_id: 'network_policy_id',
         required_services: ['string'],
         resource_size_request: 'X_SMALL',
diff --git a/tests/api-resources/devboxes/devboxes.test.ts b/tests/api-resources/devboxes/devboxes.test.ts
@@ -40,6 +40,7 @@ describe('resource devboxes', () => {
               repo_name: 'repo_name',
               repo_owner: 'repo_owner',
               token: 'token',
+              git_ref: 'git_ref',
               install_command: 'install_command',
             },
           ],
@@ -56,6 +57,10 @@ describe('resource devboxes', () => {
             custom_gb_memory: 0,
             keep_alive_time_seconds: 0,
             launch_commands: ['string'],
+            lifecycle: {
+              after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+              resume_triggers: { http: true },
+            },
             network_policy_id: 'network_policy_id',
             required_services: ['string'],
             resource_size_request: 'X_SMALL',
diff --git a/tests/api-resources/scenarios/scenarios.test.ts b/tests/api-resources/scenarios/scenarios.test.ts
@@ -68,6 +68,10 @@ describe('resource scenarios', () => {
           custom_gb_memory: 0,
           keep_alive_time_seconds: 0,
           launch_commands: ['string'],
+          lifecycle: {
+            after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+            resume_triggers: { http: true },
+          },
           network_policy_id: 'network_policy_id',
           required_services: ['string'],
           resource_size_request: 'X_SMALL',
@@ -138,6 +142,10 @@ describe('resource scenarios', () => {
               custom_gb_memory: 0,
               keep_alive_time_seconds: 0,
               launch_commands: ['string'],
+              lifecycle: {
+                after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+                resume_triggers: { http: true },
+              },
               network_policy_id: 'network_policy_id',
               required_services: ['string'],
               resource_size_request: 'X_SMALL',
@@ -291,6 +299,10 @@ describe('resource scenarios', () => {
           custom_gb_memory: 0,
           keep_alive_time_seconds: 0,
           launch_commands: ['string'],
+          lifecycle: {
+            after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+            resume_triggers: { http: true },
+          },
           network_policy_id: 'network_policy_id',
           required_services: ['string'],
           resource_size_request: 'X_SMALL',

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "1.17.0"`
	`2`	`+ ".": "1.18.0"`
`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.17.0",`
	`3`	`+ "version": "1.18.0",`
`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.17.0",`
	`4`	`+ "version": "1.18.0",`
`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.17.0',`
	`19`	`+ version: '1.18.0',`
`20`	`20`	`},`
`21`	`21`	`{`
`22`	`22`	`instructions: await getInstructions(stainlessApiKey),`
Original file line number	Diff line number	Diff line change
`@@ -1085,10 +1085,10 @@ export const ensurePresent = <T>(value: T \| null \| undefined): T => {`
`1085`	`1085`	`*/`
`1086`	`1086`	`export const readEnv = (env: string): string \| undefined => {`
`1087`	`1087`	`if (typeof process !== 'undefined') {`
`1088`		`- return process.env?.[env]?.trim() ?? undefined;`
	`1088`	`+ return process.env?.[env]?.trim() \|\| undefined;`
`1089`	`1089`	`}`
`1090`	`1090`	`if (typeof Deno !== 'undefined') {`
`1091`		`- return Deno.env?.get?.(env)?.trim();`
	`1091`	`+ return Deno.env?.get?.(env)?.trim() \|\| undefined;`
`1092`	`1092`	`}`
`1093`	`1093`	`return undefined;`
`1094`	`1094`	`};`