release: 1.8.1 (#717)

stainless-app[bot] · alb-rl · web-flow · commit 7bcc3fcad2f7 · 2026-02-19T17:55:03.000Z
Co-authored-by: stainless-app[bot] &lt;142633134+stainless-app[bot]@users.noreply.github.com&gt;
Co-authored-by: Albert Li &lt;albert@runloop.ai&gt;
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "1.8.0"
+  ".": "1.8.1"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 117
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-c8d61a0c8b88fa30666ba021d1239eb0d549902354513c4741e9216bcbfa8e6d.yml
-openapi_spec_hash: 433e6fb4ce076012b696f69ae7596c67
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-8704a652545c3831c8b7e246ec17f1a626b59911eb5701ddc922ca6cae1c8d57.yml
+openapi_spec_hash: e609bc5ed3fdce498bc7d16921bbba5e
 config_hash: eb28692edd68a6ae95cf92af931c9976
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.8.1 (2026-02-19)
+
+Full Changelog: [v1.8.0...v1.8.1](https://github.com/runloopai/api-client-ts/compare/v1.8.0...v1.8.1)
+
+### Chores
+
+* **benchmarks:** removed unused validate scorer endpoint ([#716](https://github.com/runloopai/api-client-ts/issues/716)) ([54bb583](https://github.com/runloopai/api-client-ts/commit/54bb5834f011ad10f9cdb086cddca9810c05f13e))
+
+
+### Refactors
+
+* deprecate and make Nullable total_count and remaining_count of ListViews ([#7533](https://github.com/runloopai/api-client-ts/issues/7533)) ([1af5508](https://github.com/runloopai/api-client-ts/commit/1af55086d738d85db55ac5a1116bd01950665902))
+
 ## 1.8.0 (2026-02-12)
 
 Full Changelog: [v1.7.0...v1.8.0](https://github.com/runloopai/api-client-ts/compare/v1.7.0...v1.8.0)
diff --git a/api.md b/api.md
@@ -144,7 +144,7 @@ Methods:
 - <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}/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) -> DevboxView</code>
+- <code title="post /v1/devboxes/{id}/shutdown">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">shutdown</a>(id, { ...params }) -> DevboxView</code>
 - <code title="post /v1/devboxes/{id}/snapshot_disk">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">snapshotDisk</a>(id, { ...params }) -> DevboxSnapshotView</code>
 - <code title="post /v1/devboxes/{id}/snapshot_disk_async">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">snapshotDiskAsync</a>(id, { ...params }) -> DevboxSnapshotView</code>
 - <code title="post /v1/devboxes/{id}/suspend">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">suspend</a>(id) -> DevboxView</code>
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@runloop/api-client",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "The official TypeScript library for the Runloop API",
   "author": "Runloop <support@runloop.ai>",
   "types": "dist/sdk.d.ts",
diff --git a/src/index.ts b/src/index.ts
@@ -197,6 +197,7 @@ import {
   DevboxResourceUsageView,
   DevboxSendStdInRequest,
   DevboxSendStdInResult,
+  DevboxShutdownParams,
   DevboxSnapshotDiskAsyncParams,
   DevboxSnapshotDiskParams,
   DevboxSnapshotListView,
@@ -630,6 +631,7 @@ export declare namespace Runloop {
     type DevboxListDiskSnapshotsParams as DevboxListDiskSnapshotsParams,
     type DevboxReadFileContentsParams as DevboxReadFileContentsParams,
     type DevboxRemoveTunnelParams as DevboxRemoveTunnelParams,
+    type DevboxShutdownParams as DevboxShutdownParams,
     type DevboxSnapshotDiskParams as DevboxSnapshotDiskParams,
     type DevboxSnapshotDiskAsyncParams as DevboxSnapshotDiskAsyncParams,
     type DevboxUploadFileParams as DevboxUploadFileParams,
diff --git a/src/resources/agents.ts b/src/resources/agents.ts
@@ -78,14 +78,16 @@ export interface AgentListView {
   has_more: boolean;
 
   /**
-   * The count of remaining Agents.
+   * The count of remaining Agents. Deprecated: will be removed in a future breaking
+   * change.
    */
-  remaining_count: number;
+  remaining_count?: number | null;
 
   /**
-   * The total count of Agents.
+   * The total count of Agents. Deprecated: will be removed in a future breaking
+   * change.
    */
-  total_count: number;
+  total_count?: number | null;
 }
 
 /**
diff --git a/src/resources/benchmark-jobs.ts b/src/resources/benchmark-jobs.ts
@@ -308,9 +308,9 @@ export interface BenchmarkJobListView {
    */
   jobs: Array<BenchmarkJobView>;
 
-  remaining_count: number;
+  remaining_count?: number | null;
 
-  total_count: number;
+  total_count?: number | null;
 }
 
 /**
diff --git a/src/resources/benchmark-runs.ts b/src/resources/benchmark-runs.ts
@@ -85,14 +85,14 @@ export class BenchmarkRunViewsBenchmarkRunsCursorIDPage extends BenchmarkRunsCur
 export interface BenchmarkRunListView {
   has_more: boolean;
 
-  remaining_count: number;
-
   /**
    * List of BenchmarkRuns matching filter.
    */
   runs: Array<BenchmarkRunView>;
 
-  total_count: number;
+  remaining_count?: number | null;
+
+  total_count?: number | null;
 }
 
 /**
diff --git a/src/resources/benchmarks.ts b/src/resources/benchmarks.ts
@@ -299,14 +299,14 @@ export interface BenchmarkView {
 export interface ScenarioDefinitionListView {
   has_more: boolean;
 
-  remaining_count: number;
-
   /**
    * List of Scenarios matching filter.
    */
   scenarios: Array<ScenariosAPI.ScenarioView>;
 
-  total_count: number;
+  remaining_count?: number | null;
+
+  total_count?: number | null;
 }
 
 export interface StartBenchmarkRunParameters {
diff --git a/src/resources/blueprints.ts b/src/resources/blueprints.ts
@@ -456,9 +456,9 @@ export interface BlueprintListView {
 
   has_more: boolean;
 
-  remaining_count: number;
+  remaining_count?: number | null;
 
-  total_count: number;
+  total_count?: number | null;
 }
 
 export interface BlueprintPreviewView {
diff --git a/src/resources/devboxes/devboxes.ts b/src/resources/devboxes/devboxes.ts
@@ -450,10 +450,26 @@ export class Devboxes extends APIResource {
   /**
    * Shutdown a running Devbox. This will permanently stop the Devbox. If you want to
    * save the state of the Devbox, you should take a snapshot before shutting down or
-   * should suspend the Devbox instead of shutting down.
+   * should suspend the Devbox instead of shutting down. If the Devbox has any
+   * in-progress snapshots, the shutdown will be rejected with a 409 Conflict unless
+   * force=true is specified.
    */
-  shutdown(id: string, options?: Core.RequestOptions): Core.APIPromise<DevboxView> {
-    return this._client.post(`/v1/devboxes/${id}/shutdown`, options);
+  shutdown(
+    id: string,
+    params?: DevboxShutdownParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DevboxView>;
+  shutdown(id: string, options?: Core.RequestOptions): Core.APIPromise<DevboxView>;
+  shutdown(
+    id: string,
+    params: DevboxShutdownParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DevboxView> {
+    if (isRequestOptions(params)) {
+      return this.shutdown(id, {}, params);
+    }
+    const { force } = params;
+    return this._client.post(`/v1/devboxes/${id}/shutdown`, { query: { force }, ...options });
   }
 
   /**
@@ -674,9 +690,9 @@ export interface DevboxListView {
 
   has_more: boolean;
 
-  remaining_count: number;
+  remaining_count?: number | null;
 
-  total_count: number;
+  total_count?: number | null;
 }
 
 export interface DevboxResourceUsageView {
@@ -762,14 +778,14 @@ export interface DevboxSendStdInResult {
 export interface DevboxSnapshotListView {
   has_more: boolean;
 
-  remaining_count: number;
-
   /**
    * List of snapshots matching filter.
    */
   snapshots: Array<DevboxSnapshotView>;
 
-  total_count: number;
+  remaining_count?: number | null;
+
+  total_count?: number | null;
 }
 
 /**
@@ -1380,6 +1396,13 @@ export interface DevboxRemoveTunnelParams {
   port: number;
 }
 
+export interface DevboxShutdownParams {
+  /**
+   * If true, force shutdown even if snapshots are in progress. Defaults to false.
+   */
+  force?: string;
+}
+
 export interface DevboxSnapshotDiskParams {
   /**
    * (Optional) Commit message associated with the snapshot (max 1000 characters)
@@ -1500,6 +1523,7 @@ export declare namespace Devboxes {
     type DevboxListDiskSnapshotsParams as DevboxListDiskSnapshotsParams,
     type DevboxReadFileContentsParams as DevboxReadFileContentsParams,
     type DevboxRemoveTunnelParams as DevboxRemoveTunnelParams,
+    type DevboxShutdownParams as DevboxShutdownParams,
     type DevboxSnapshotDiskParams as DevboxSnapshotDiskParams,
     type DevboxSnapshotDiskAsyncParams as DevboxSnapshotDiskAsyncParams,
     type DevboxUploadFileParams as DevboxUploadFileParams,
diff --git a/src/resources/devboxes/index.ts b/src/resources/devboxes/index.ts
@@ -46,6 +46,7 @@ export {
   type DevboxListDiskSnapshotsParams,
   type DevboxReadFileContentsParams,
   type DevboxRemoveTunnelParams,
+  type DevboxShutdownParams,
   type DevboxSnapshotDiskParams,
   type DevboxSnapshotDiskAsyncParams,
   type DevboxUploadFileParams,
diff --git a/src/resources/gateway-configs.ts b/src/resources/gateway-configs.ts
@@ -140,9 +140,10 @@ export interface GatewayConfigListView {
   has_more: boolean;
 
   /**
-   * Total count of GatewayConfigs that match the query.
+   * Total count of GatewayConfigs that match the query. Deprecated: will be removed
+   * in a future breaking change.
    */
-  total_count: number;
+  total_count?: number | null;
 }
 
 /**
diff --git a/src/resources/index.ts b/src/resources/index.ts
@@ -95,6 +95,7 @@ export {
   type DevboxListDiskSnapshotsParams,
   type DevboxReadFileContentsParams,
   type DevboxRemoveTunnelParams,
+  type DevboxShutdownParams,
   type DevboxSnapshotDiskParams,
   type DevboxSnapshotDiskAsyncParams,
   type DevboxUploadFileParams,
diff --git a/src/resources/mcp-configs.ts b/src/resources/mcp-configs.ts
@@ -120,9 +120,10 @@ export interface McpConfigListView {
   mcp_configs: Array<McpConfigView>;
 
   /**
-   * Total count of McpConfigs that match the query.
+   * Total count of McpConfigs that match the query. Deprecated: will be removed in a
+   * future breaking change.
    */
-  total_count: number;
+  total_count?: number | null;
 }
 
 /**
diff --git a/src/resources/network-policies.ts b/src/resources/network-policies.ts
@@ -128,9 +128,10 @@ export interface NetworkPolicyListView {
   network_policies: Array<NetworkPolicyView>;
 
   /**
-   * Total count of items in this response.
+   * Total count of items in this response. Deprecated: will be removed in a future
+   * breaking change.
    */
-  total_count: number;
+  total_count?: number | null;
 }
 
 /**
diff --git a/src/resources/objects.ts b/src/resources/objects.ts
@@ -159,14 +159,16 @@ export interface ObjectListView {
   objects: Array<ObjectView>;
 
   /**
-   * Number of Objects remaining after this page.
+   * Number of Objects remaining after this page. Deprecated: will be removed in a
+   * future breaking change.
    */
-  remaining_count: number;
+  remaining_count?: number | null;
 
   /**
-   * Total number of Objects across all pages.
+   * Total number of Objects across all pages. Deprecated: will be removed in a
+   * future breaking change.
    */
-  total_count: number;
+  total_count?: number | null;
 }
 
 /**
diff --git a/src/resources/repositories.ts b/src/resources/repositories.ts
@@ -128,14 +128,14 @@ export class RepositoryConnectionViewsRepositoriesCursorIDPage extends Repositor
 export interface RepositoryConnectionListView {
   has_more: boolean;
 
-  remaining_count: number;
-
   /**
    * List of repositories matching filter.
    */
   repositories: Array<RepositoryConnectionView>;
 
-  total_count: number;
+  remaining_count?: number | null;
+
+  total_count?: number | null;
 }
 
 /**
diff --git a/src/resources/scenarios/scenarios.ts b/src/resources/scenarios/scenarios.ts
@@ -251,14 +251,14 @@ export interface ScenarioEnvironment {
 export interface ScenarioRunListView {
   has_more: boolean;
 
-  remaining_count: number;
-
   /**
    * List of ScenarioRuns matching filter.
    */
   runs: Array<ScenarioRunView>;
 
-  total_count: number;
+  remaining_count?: number | null;
+
+  total_count?: number | null;
 }
 
 /**
@@ -421,6 +421,11 @@ export interface ScenarioView {
    */
   scoring_contract: ScoringContract;
 
+  /**
+   * The state of the scenario.
+   */
+  status: string;
+
   /**
    * The Environment in which the Scenario is run.
    */
diff --git a/src/resources/secrets.ts b/src/resources/secrets.ts
@@ -77,19 +77,21 @@ export interface SecretListView {
   has_more: boolean;
 
   /**
-   * Number of Secrets remaining after this page.
+   * List of Secret objects. Values are omitted for security.
    */
-  remaining_count: number;
+  secrets: Array<SecretView>;
 
   /**
-   * List of Secret objects. Values are omitted for security.
+   * Number of Secrets remaining after this page. Deprecated: will be removed in a
+   * future breaking change.
    */
-  secrets: Array<SecretView>;
+  remaining_count?: number | null;
 
   /**
-   * Total number of Secrets across all pages.
+   * Total number of Secrets across all pages. Deprecated: will be removed in a
+   * future breaking change.
    */
-  total_count: number;
+  total_count?: number | null;
 }
 
 /**
diff --git a/src/version.ts b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '1.8.0'; // x-release-please-version
+export const VERSION = '1.8.1'; // x-release-please-version
diff --git a/tests/api-resources/devboxes/devboxes.test.ts b/tests/api-resources/devboxes/devboxes.test.ts
@@ -440,6 +440,13 @@ describe('resource devboxes', () => {
     );
   });
 
+  test('shutdown: 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.devboxes.shutdown('id', { force: 'force' }, { path: '/_stainless_unknown_path' }),
+    ).rejects.toThrow(Runloop.NotFoundError);
+  });
+
   test('snapshotDisk', async () => {
     const responsePromise = client.devboxes.snapshotDisk('id');
     const rawResponse = await responsePromise.asResponse();
diff --git a/tests/objects/scenario.test.ts b/tests/objects/scenario.test.ts

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "1.8.0"`
	`2`	`+ ".": "1.8.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.8.0",`
	`3`	`+ "version": "1.8.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
`@@ -308,9 +308,9 @@ export interface BenchmarkJobListView {`
`308`	`308`	`*/`
`309`	`309`	`jobs: Array<BenchmarkJobView>;`
`310`	`310`
`311`		`- remaining_count: number;`
	`311`	`+ remaining_count?: number \| null;`
`312`	`312`
`313`		`- total_count: number;`
	`313`	`+ total_count?: number \| null;`
`314`	`314`	`}`
`315`	`315`
`316`	`316`	`/**`