Merge remote-tracking branch 'origin/main' into dines/mcp-hub-sdk

dines-rl · dines-rl · commit 0328b0e0cda3 · 2026-02-23T15:33:41.000-08:00
diff --git a/.github/workflows/publish-docs.yml b/.github/workflows/publish-docs.yml
@@ -42,7 +42,13 @@ jobs:
         uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53
         with:
           name: documentation
-      - run: tar -xf documentation.tar ./docs -C ./docs
+      - run: tar -xf documentation.tar
+      - name: Remove any legacy nested docs trees
+        run: |
+          if [ -d ./docs/docs ]; then
+            echo "Removing legacy nested docs content from prior malformed extraction"
+            rm -rf ./docs/docs
+          fi
 
       - name: Build
         uses: runloopai/setup-node@main
@@ -78,7 +84,7 @@ jobs:
         uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53
         with:
           name: newdocumentation
-      - run: tar -xf newdocumentation.tar ./docs -C ./docs
+      - run: tar -xf newdocumentation.tar
 
       - name: commit
         run: |
diff --git a/.github/workflows/publish-npm.yml b/.github/workflows/publish-npm.yml
@@ -34,6 +34,7 @@ jobs:
 
       - name: Add stable tag to NPM release
         run: |
+          npm config set '//registry.npmjs.org/:_authToken' "$NPM_TOKEN"
           cd dist
           PACKAGE_NAME="$(jq -r -e '.name' ./package.json)"
           VERSION="$(jq -r -e '.version' ./package.json)"
@@ -45,3 +46,5 @@ jobs:
           else
             echo "Skipping stable tag for prerelease version $VERSION"
           fi
+        env:
+          NPM_TOKEN: ${{ secrets.RUNLOOP_NPM_TOKEN || secrets.NPM_TOKEN }}
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "1.7.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-15b7fd06098d8cb3639efb3b401a03d7d97a8ab4960b08077aa871f0cacb33d3.yml
-openapi_spec_hash: 93ab2fe88f9e57d8f262ad6d1179190e
+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,37 @@
 # 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)
+
+### Features
+
+* **benchmarks:** scenario scoring timeout ([#7300](https://github.com/runloopai/api-client-ts/issues/7300)) ([893cd00](https://github.com/runloopai/api-client-ts/commit/893cd0057d67f98f5e9ed2f453aae31e20728db0))
+* **devbox:** expose snapshot size (in bytes) ([#7444](https://github.com/runloopai/api-client-ts/issues/7444)) ([54aa338](https://github.com/runloopai/api-client-ts/commit/54aa338efb7935509bc6b7a47d892f8cddcb7164))
+
+
+### Bug Fixes
+
+* remove duplicate operationId createDevboxTunnel in openapi ([#7397](https://github.com/runloopai/api-client-ts/issues/7397)) ([99b8c23](https://github.com/runloopai/api-client-ts/commit/99b8c23fd3fc44bee446d97f701d3acd0a73a27f))
+
+
+### Chores
+
+* **internal:** avoid type checking errors with ts-reset ([1e3ed19](https://github.com/runloopai/api-client-ts/commit/1e3ed1959f5afbe8235b8f37742e3fb04c9fb877))
+
 ## 1.7.0 (2026-02-05)
 
 Full Changelog: [v1.6.0...v1.7.0](https://github.com/runloopai/api-client-ts/compare/v1.6.0...v1.7.0)
diff --git a/README.md b/README.md
@@ -61,7 +61,7 @@ The SDK provides object-oriented interfaces for all major Runloop resources:
 - **[`runloop.storageObject`](https://runloopai.github.io/api-client-ts/stable/classes/StorageObjectOps.html)** - Storage object management (upload, download, list objects)
 - **[`runloop.agent`](https://runloopai.github.io/api-client-ts/stable/classes/AgentOps.html)** - Agent management (create, list agents from npm/pip/git)
 - **[`runloop.scenario`](https://runloopai.github.io/api-client-ts/stable/classes/ScenarioOps.html)** - Scenario management (list scenarios, start runs)
-- **[`runloop.scorer`](https://runloopai.github.io/api-client-ts/stable/classes/ScorerOps.html)** - Scorer management (create, list, validate, update)
+- **[`runloop.scorer`](https://runloopai.github.io/api-client-ts/stable/classes/ScorerOps.html)** - Scorer management (create, list, update)
 - **[`runloop.api`](https://runloopai.github.io/api-client-ts/stable/classes/Runloop.html)** - Direct access to the REST API client
 
 ## TypeScript Support
@@ -88,7 +88,7 @@ const devbox = await blueprint.createDevbox({ name: 'my-devbox' });
 
 ### Scorers
 
-Scorers are custom scoring functions used to evaluate scenario outputs. Create scorers via `runloop.scorer.create()`, then update or validate them with the returned `Scorer` instance:
+Scorers are custom scoring functions used to evaluate scenario outputs. Create scorers via `runloop.scorer.create()`, then update them with the returned `Scorer` instance:
 
 ```typescript
 import { RunloopSDK } from '@runloop/api-client';
@@ -101,8 +101,6 @@ const scorer = await runloop.scorer.create({
 });
 
 await scorer.update({ bash_script: 'echo "0.5"' });
-const result = await scorer.validate({ scoring_context: { output: 'hello' } });
-console.log(result.scoring_result.score);
 ```
 
 ### Scenarios
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.7.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
@@ -231,9 +231,9 @@ export class Devboxes extends APIResource {
   }
 
   /**
-   * Create a V2 tunnel for an existing running Devbox. Tunnels provide encrypted
+   * Enable a V2 tunnel for an existing running Devbox. Tunnels provide encrypted
    * URL-based access to the Devbox without exposing internal IDs. The tunnel URL
-   * format is: https://{port}-{tunnel_key}.tunnel.runloop.ai
+   * format is: https://&#123;port&#125;-&#123;tunnel_key&#125;.tunnel.runloop.ai
    *
    * Each Devbox can have one tunnel.
    */
@@ -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;
 }
 
 /**
@@ -808,6 +824,11 @@ export interface DevboxSnapshotView {
    */
   name?: string | null;
 
+  /**
+   * (Optional) The size of the snapshot in bytes, relative to the base blueprint.
+   */
+  size_bytes?: number | null;
+
   /**
    * (Optional) The source Blueprint ID this snapshot was created from.
    */
@@ -1375,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)
@@ -1495,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
diff --git a/src/resources/repositories.ts b/src/resources/repositories.ts
diff --git a/src/resources/scenarios/scenarios.ts b/src/resources/scenarios/scenarios.ts
diff --git a/src/resources/secrets.ts b/src/resources/secrets.ts
diff --git a/src/sdk.ts b/src/sdk.ts
diff --git a/src/streaming.ts b/src/streaming.ts
diff --git a/src/version.ts b/src/version.ts
diff --git a/tests/api-resources/devboxes/devboxes.test.ts b/tests/api-resources/devboxes/devboxes.test.ts
diff --git a/tests/api-resources/scenarios/scenarios.test.ts b/tests/api-resources/scenarios/scenarios.test.ts
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.7.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.7.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",`