eve 0.51.0 → 0.52.0

package/dist/src/compiled/@vercel/sandbox/sandbox.d.ts

@@ -2,8 +2,8 @@ import { Paginator } from "./utils/paginator.js";
 import { SandboxMetaData, SandboxRouteData, SessionMetaData, SnapshotMetadata } from "./api-client/validators.js";
 import { NetworkPolicy, NetworkPolicyKeyValueMatcher, NetworkPolicyMatch, NetworkPolicyMatcher } from "./network-policy.js";
 import { WithPrivate } from "./utils/types.js";
-import { RUNTIMES } from "./constants.js";
-import { APIClient, WithFetchOptions } from "./api-client/api-client.js";
+import { ManagedImage, RUNTIMES, SandboxRegion } from "./constants.js";
+import { APIClient, SingleTagFilter, WithFetchOptions } from "./api-client/api-client.js";
 import "./api-client/index.js";
 import { Credentials } from "./utils/get-credentials.js";
 import { Command, CommandFinished } from "./command.js";
@@ -49,7 +49,7 @@ interface BaseCreateSandboxParams {
   };
   /**
    * Array of port numbers to expose from the sandbox. Sandboxes can
-   * expose up to 4 ports.
+   * expose up to 15 ports.
    */
   ports?: number[];
   /**
@@ -89,29 +89,15 @@ interface BaseCreateSandboxParams {
    */
   tags?: Record<string, string>;
   /**
-   * List of drives to attach to the sandbox, keyed by the desired mount path.
-   * The drive must be created beforehand with `Drive.getOrCreate`.
-   *
-   * The mount paths must be absolute and cannot overlap with each other.
-   *
-   * @example
-   * const drive = await Drive.getOrCreate({ name: "my-drive" });
-   * const sandbox = await Sandbox.create({
-   *   mounts: {
-   *     "/data": { drive: drive.name, mode: "read-write" },
-   *   },
-   * });
+   * The region to create the sandbox in. Defaults to `iad1`.
+   * See the Vercel documentation for the available regions.
    */
-  mounts?: Record<string, {
-    /**
-     * The drive name to mount.
-     */
-    drive: string;
-    /**
-     * Mount mode. Defaults to `read-write` if unspecified.
-     */
-    mode?: "read-only" | "read-write";
-  }>;
+  region?: SandboxRegion;
+  /**
+   * Additional regions the sandbox can fail over to. Must not include
+   * `region`.
+   */
+  failoverRegions?: SandboxRegion[];
   /**
    * An AbortSignal to cancel sandbox creation.
    */
@@ -152,37 +138,39 @@ interface BaseCreateSandboxParams {
    */
   onResume?: (sandbox: Sandbox) => Promise<void>;
 }
-type SandboxMounts = NonNullable<BaseCreateSandboxParams["mounts"]>;
-type SandboxMountMode = NonNullable<SandboxMounts[string]["mode"]>;
 /**
- * `runtime` and `image` are mutually exclusive: a sandbox starts from either a
- * stock runtime or a custom VCR image, never both. The `never` counterpart in
- * each branch makes passing both a compile-time error.
+ * A VCR image reference.
+ */
+type SandboxImage = `vercel/sandbox/${ManagedImage}` | (string & {});
+/**
+ * Sandbox environment selection options.
  * @inline
  */
 type RuntimeOrImage = {
   /**
-   * The runtime of the sandbox, currently only `node24`, `node22`, `node26`
-   * and `python3.13` are supported.
-   * If not specified, the default runtime `node24` will be used.
+   * A legacy Vercel-managed runtime.
+   *
+   * @deprecated Use `image` instead.
    */
   runtime?: RUNTIMES | (string & {});
   image?: never;
 } | {
+  runtime?: never;
   /**
    * A Vercel Container Registry (VCR) image to start the sandbox from,
    * scoped to the sandbox's project or a shared image from any project. Accepts a repository name, an
    * optional tag or digest, or a fully-qualified VCR URL. A bare
-   * repository name resolves to the `latest` tag.
+   * repository name resolves to the `latest` tag. If omitted, the sandbox
+   * uses `vercel/sandbox/universal:latest`.
    *
+   * @example "vercel/sandbox/universal" // Vercel managed image, latest tag
    * @example "my-repo" // latest tag
    * @example "my-repo:v1" // specific tag
    * @example "my-repo@sha256:..." // specific digest
    * @example "other-team/other-project/repo:v1" // Shared image from another team
    * @example "vcr.vercel.com/my-team/my-project/repo:v1" // fully-qualified
    */
-  image?: string;
-  runtime?: never;
+  image?: SandboxImage;
 };
 type CreateSandboxParams = (BaseCreateSandboxParams & RuntimeOrImage) | (Omit<BaseCreateSandboxParams, "source"> & {
   source: {
@@ -198,12 +186,11 @@ type CreateSandboxParams = (BaseCreateSandboxParams & RuntimeOrImage) | (Omit<Ba
  * The fork inherits the source sandbox's current filesystem snapshot and the
  * server copies its config — resources, timeout, ports, tags, network policy,
  * image, persistence, snapshot settings, and environment variables. Any field
- * set here acts as an override of the copied value. `runtime` is not exposed:
- * when the source has a snapshot it is inherited, otherwise the source's
- * runtime/image is copied.
+ * set here acts as an override of the copied value. When the source has no
+ * snapshot, its base environment is copied.
  * @inline
  */
-type ForkSandboxParams = Omit<BaseCreateSandboxParams, "source" | "runtime"> & {
+type ForkSandboxParams = Omit<BaseCreateSandboxParams, "source"> & {
   /**
    * Name of the source sandbox to fork from.
    */
@@ -212,7 +199,7 @@ type ForkSandboxParams = Omit<BaseCreateSandboxParams, "source" | "runtime"> & {
    * A Vercel Container Registry (VCR) image to start the fork from, overriding
    * the image copied from the source.
    */
-  image?: string;
+  image?: SandboxImage;
 };
 /** @inline */
 interface GetSandboxParams {
@@ -221,7 +208,9 @@ interface GetSandboxParams {
    */
   name: string;
   /**
-   * Whether to resume an existing session. Defaults to true.
+   * Whether to resume an existing session immediately. Defaults to false;
+   * a persistent sandbox still auto-resumes on the first SDK call that
+   * needs a running session (such as `runCommand`).
    */
   resume?: boolean;
   /**
@@ -241,7 +230,9 @@ interface GetSandboxParams {
  */
 type GetOrCreateSandboxParams = CreateSandboxParams & {
   /**
-   * Whether to resume an existing session. Defaults to true.
+   * Whether to resume an existing session immediately. Defaults to false;
+   * a persistent sandbox still auto-resumes on the first SDK call that
+   * needs a running session (such as `runCommand`).
    */
   resume?: boolean;
   /**
@@ -321,9 +312,15 @@ declare class Sandbox implements ExecutionContext {
    */
   get persistent(): boolean;
   /**
-   * The region this sandbox runs in.
+   * The region this sandbox is configured to run in. Where the running session
+   * actually landed is reported by {@link Session.region}.
    */
-  get region(): string | undefined;
+  get region(): string;
+  /**
+   * The additional regions this sandbox can fail over to, in order. Empty when
+   * it does not fail over.
+   */
+  get failoverRegions(): string[];
   /**
    * Number of virtual CPUs allocated.
    */
@@ -333,14 +330,14 @@ declare class Sandbox implements ExecutionContext {
    */
   get memory(): number | undefined;
   /**
-   * Runtime identifier (e.g. "node24", "python3.13").
-   * Mutually exclusive with {@link Sandbox.image}.
+   * Legacy runtime identifier, when the sandbox was created with `runtime`.
+   *
+   * @deprecated Use {@link Sandbox.image} for image-backed sandboxes.
    */
   get runtime(): string | undefined;
   /**
    * Digest-pinned reference of the container image the sandbox was created
    * from, when it was created from an image (`"{repository}@{manifestDigest}"`).
-   * Mutually exclusive with {@link Sandbox.runtime}.
    */
   get image(): string | undefined;
   /**
@@ -396,10 +393,6 @@ declare class Sandbox implements ExecutionContext {
    * Key-value tags attached to the sandbox.
    */
   get tags(): Record<string, string> | undefined;
-  /**
-   * Drives mounted on the sandbox, keyed by mount path.
-   */
-  get mounts(): SandboxMounts | undefined;
   /**
    * The default network policy of this sandbox.
    */
@@ -450,7 +443,14 @@ declare class Sandbox implements ExecutionContext {
    * // or: for await (const page of result.pages()) { ... }
    * ```
    */
-  static list(params?: Partial<Parameters<APIClient["listSandboxes"]>[0]> & Partial<Credentials> & WithFetchOptions): Promise<Paginator<{
+  static list<Tags extends Record<string, string>>(params?: Partial<Omit<Parameters<APIClient["listSandboxes"]>[0], "tags">> & {
+    /**
+     * Filter sandboxes by tag. Only a single `{ key: value }` tag filter
+     * is currently supported.
+     * @example { env: "staging" }
+     */
+    tags?: Tags & SingleTagFilter<Tags>;
+  } & Partial<Credentials> & WithFetchOptions): Promise<Paginator<{
     sandboxes: {
       name: string;
       persistent: boolean;
@@ -459,6 +459,7 @@ declare class Sandbox implements ExecutionContext {
       currentSessionId: string;
       status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
       region?: string | undefined;
+      failoverRegions?: string[] | undefined;
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;
@@ -559,10 +560,6 @@ declare class Sandbox implements ExecutionContext {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
-      mounts?: Record<string, {
-        drive: string;
-        mode?: "read-only" | "read-write" | undefined;
-      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;
@@ -595,6 +592,10 @@ declare class Sandbox implements ExecutionContext {
   /**
    * Create a new sandbox.
    *
+   * By default, the sandbox uses `vercel/sandbox/universal:latest`, an
+   * Ubuntu-based image with Node.js 24, Bun, Python 3.14, coding agents, and
+   * common development utilities.
+   *
    * @param params - Creation parameters and optional credentials.
    * @returns A promise resolving to the created {@link Sandbox}.
    * @example
@@ -612,8 +613,8 @@ declare class Sandbox implements ExecutionContext {
   /**
    * Fork an existing sandbox into a new one.
    *
-   * The server restores the fork from the source's current snapshot (or the
-   * source's runtime/image when it has none) and copies its config — resources,
+   * The server restores the fork from the source's current snapshot (or its
+   * base environment when it has none) and copies its config — resources,
    * timeout, ports, tags, network policy, image, persistence, snapshot
    * settings, and environment variables. Any field passed in `params` overrides
    * the copied value.
@@ -831,7 +832,7 @@ declare class Sandbox implements ExecutionContext {
   /**
    * Write files to the filesystem of this sandbox.
    * Defaults to writing to /vercel/sandbox unless an absolute path is specified.
-   * Writes files using the `vercel-sandbox` user.
+   * Writes files using the sandbox's default user.
    *
    * @param files - Array of files with path, content, and optional mode (permissions)
    * @param opts - Optional parameters.
@@ -928,11 +929,10 @@ declare class Sandbox implements ExecutionContext {
   }): Promise<void>;
   /**
    * The user that non-`sudo` commands and the HTTP file API run as, together
-   * with that user's primary group. This depends on the sandbox image: stock
-   * runtimes default to `vercel-sandbox`, while Ubuntu-based images default to
-   * `root`. The multi-user helpers group-own home and shared directories by
-   * this user's group so the file API can traverse them, so we resolve it from
-   * the running sandbox rather than assuming a fixed name.
+   * with that user's primary group. This depends on the sandbox image. The
+   * multi-user helpers group-own home and shared directories by this user's
+   * group so the file API can traverse them, so we resolve it from the running
+   * sandbox rather than assuming a fixed name.
    *
    * The result is memoized for the lifetime of this instance.
    *
@@ -1056,6 +1056,10 @@ declare class Sandbox implements ExecutionContext {
    * When `timeout` is increased and a session is currently running, the running
    * session's deadline is also extended.
    *
+   * `region` and `failoverRegions` apply to the next session; the currently
+   * running session keeps the region it started in. Pass an empty
+   * `failoverRegions` array to remove all failover regions.
+   *
    * @param params - Fields to update.
    * @param opts - Optional abort signal.
    */
@@ -1075,6 +1079,8 @@ declare class Sandbox implements ExecutionContext {
       deleteEvicted?: boolean;
     } | null;
     currentSnapshotId?: string;
+    region?: SandboxRegion;
+    failoverRegions?: SandboxRegion[];
   }, opts?: {
     signal?: AbortSignal;
   }): Promise<void>;
@@ -1083,8 +1089,13 @@ declare class Sandbox implements ExecutionContext {
    *
    * After deletion the instance becomes inert — all further API calls will
    * throw immediately.
+   *
+   * @param opts.deleteOrphanSnapshots - When true, the snapshots of this
+   * sandbox that are not used by any other sandbox are deleted asynchronously
+   * too. Defaults to false, which keeps them until they expire.
    */
   delete(opts?: {
+    deleteOrphanSnapshots?: boolean;
     signal?: AbortSignal;
   }): Promise<void>;
   /**
@@ -1105,13 +1116,13 @@ declare class Sandbox implements ExecutionContext {
       memory: number;
       vcpus: number;
       region: string;
-      runtime: string;
       timeout: number;
       status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
       requestedAt: number;
       createdAt: number;
       cwd: string;
       updatedAt: number;
+      runtime?: string | undefined;
       startedAt?: number | undefined;
       requestedStopAt?: number | undefined;
       stoppedAt?: number | undefined;
@@ -1237,6 +1248,7 @@ declare class Sandbox implements ExecutionContext {
       sizeBytes: number;
       createdAt: number;
       updatedAt: number;
+      regions?: string[] | undefined;
       expiresAt?: number | undefined;
       lastUsedAt?: number | undefined;
       creationMethod?: string | undefined;
@@ -1249,5 +1261,5 @@ declare class Sandbox implements ExecutionContext {
   }, "snapshots">>;
 }
 //#endregion
-export { BaseCreateSandboxParams, Sandbox, SandboxMountMode, SandboxMounts, SerializedSandbox };
+export { Sandbox, SerializedSandbox };
 //# sourceMappingURL=sandbox.d.ts.map

package/dist/src/compiled/@vercel/sandbox/session.d.ts

@@ -127,9 +127,11 @@ declare class Session implements ExecutionContext {
    */
   get region(): string;
   /**
-   * Runtime identifier (e.g. "node24", "python3.13").
+   * Legacy runtime identifier, when available.
+   *
+   * @deprecated Use the parent sandbox's image metadata instead.
    */
-  get runtime(): string;
+  get runtime(): string | undefined;
   /**
    * The working directory of this session.
    */
@@ -316,7 +318,7 @@ declare class Session implements ExecutionContext {
   /**
    * Write files to the filesystem of this session.
    * Defaults to writing to /vercel/sandbox unless an absolute path is specified.
-   * Writes files using the `vercel-sandbox` user.
+   * Writes files using the sandbox's default user.
    *
    * @param files - Array of files with path and stream/buffer contents
    * @param opts - Optional parameters.

package/dist/src/compiled/@vercel/sandbox/snapshot.d.ts

@@ -43,6 +43,10 @@ declare class Snapshot {
    * The ID of the session from which this snapshot was created.
    */
   get sourceSessionId(): string;
+  /**
+   * All regions where this snapshot is available.
+   */
+  get regions(): string[];
   /**
    * The status of the snapshot.
    */
@@ -114,6 +118,7 @@ declare class Snapshot {
       sizeBytes: number;
       createdAt: number;
       updatedAt: number;
+      regions?: string[] | undefined;
       expiresAt?: number | undefined;
       lastUsedAt?: number | undefined;
       creationMethod?: string | undefined;
@@ -152,6 +157,7 @@ declare class Snapshot {
         sizeBytes: number;
         createdAt: number;
         updatedAt: number;
+        regions?: string[] | undefined;
         expiresAt?: number | undefined;
         lastUsedAt?: number | undefined;
         creationMethod?: string | undefined;
@@ -165,6 +171,7 @@ declare class Snapshot {
         sizeBytes: number;
         createdAt: number;
         updatedAt: number;
+        regions?: string[] | undefined;
         expiresAt?: number | undefined;
         lastUsedAt?: number | undefined;
         creationMethod?: string | undefined;
@@ -185,6 +192,7 @@ declare class Snapshot {
         sizeBytes: number;
         createdAt: number;
         updatedAt: number;
+        regions?: string[] | undefined;
         expiresAt?: number | undefined;
         lastUsedAt?: number | undefined;
         creationMethod?: string | undefined;
@@ -198,6 +206,7 @@ declare class Snapshot {
         sizeBytes: number;
         createdAt: number;
         updatedAt: number;
+        regions?: string[] | undefined;
         expiresAt?: number | undefined;
         lastUsedAt?: number | undefined;
         creationMethod?: string | undefined;

package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/api-client/api-client.d.ts

@@ -4,6 +4,7 @@ import { FileWriter } from "./file-writer.js";
 import { NetworkPolicy } from "../network-policy.js";
 import { WithPrivate } from "../utils/types.js";
 import { RUNTIMES, SandboxRegion } from "../constants.js";
+import { BaseCreateSandboxParams } from "../sandbox.js";
 import { z } from "#compiled/zod/index.js";
 import { Readable } from "stream";
 
@@ -180,6 +181,7 @@ declare class APIClient extends BaseClient {
       expiration?: number;
       deleteEvicted?: boolean;
     };
+    mounts?: BaseCreateSandboxParams["mounts"];
     region?: SandboxRegion;
     failoverRegions?: SandboxRegion[];
     signal?: AbortSignal;
@@ -293,6 +295,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode?: "read-only" | "read-write" | undefined;
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;
@@ -553,6 +559,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode?: "read-only" | "read-write" | undefined;
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;
@@ -1010,6 +1020,50 @@ declare class APIClient extends BaseClient {
       count: string;
     } | undefined;
   }>>;
+  listDrives(params: {
+    projectId: string;
+    limit?: number;
+    cursor?: string | number;
+    since?: number | string;
+    until?: number | string;
+    sortBy?: "createdAt" | "updatedAt" | "name";
+    sortOrder?: "asc" | "desc";
+    namePrefix?: string;
+    signal?: AbortSignal;
+  }): Promise<Parsed<{
+    drives: {
+      name: string;
+      projectId: string;
+      region: string;
+      maxSizeBytes: number;
+      createdAt: number;
+      updatedAt: number;
+      currentSessionId?: string | undefined;
+      currentSandboxName?: string | undefined;
+    }[];
+    pagination: {
+      count: number;
+      next: string | null;
+    };
+  }>>;
+  getOrCreateDrive(params: {
+    projectId: string;
+    name: string;
+    region?: string;
+    maxSizeBytes?: number;
+    signal?: AbortSignal;
+  }): Promise<Parsed<{
+    drive: {
+      name: string;
+      projectId: string;
+      region: string;
+      maxSizeBytes: number;
+      createdAt: number;
+      updatedAt: number;
+      currentSessionId?: string | undefined;
+      currentSandboxName?: string | undefined;
+    };
+  }>>;
   writeFiles(params: {
     sessionId: string;
     cwd: string;
@@ -1193,6 +1247,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode?: "read-only" | "read-write" | undefined;
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;
@@ -1439,6 +1497,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode?: "read-only" | "read-write" | undefined;
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;
@@ -1451,6 +1513,22 @@ declare class APIClient extends BaseClient {
       next: string | null;
     };
   }>>;
+  deleteDrive(params: {
+    projectId: string;
+    name: string;
+    signal?: AbortSignal;
+  }): Promise<Parsed<{
+    drive: {
+      name: string;
+      projectId: string;
+      region: string;
+      maxSizeBytes: number;
+      createdAt: number;
+      updatedAt: number;
+      currentSessionId?: string | undefined;
+      currentSandboxName?: string | undefined;
+    };
+  }>>;
   updateSandbox(params: {
     name: string;
     projectId: string;
@@ -1583,6 +1661,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode?: "read-only" | "read-write" | undefined;
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;
@@ -1599,7 +1681,6 @@ declare class APIClient extends BaseClient {
   deleteSandbox(params: {
     name: string;
     projectId: string;
-    deleteOrphanSnapshots?: boolean;
     signal?: AbortSignal;
   }): Promise<Parsed<{
     sandbox: {
@@ -1711,6 +1792,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode?: "read-only" | "read-write" | undefined;
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;

package/dist/src/compiled/@vercel/sandbox-drives/api-client/index.d.ts

@@ -0,0 +1,2 @@
+import { Command, CommandData, CommandFinishedData, CommandFinishedResponse, CommandResponse, CreateSnapshotResponse, Drive, DriveMetadata, InteractiveSessionResponse, LogError, LogLine, LogLineData, LogOutputLine, Sandbox, SandboxMetaData, SandboxRoute, SandboxRouteData, Session, SessionMetaData, SessionResponse, Snapshot, SnapshotMetadata, SnapshotResponse, SnapshotTreeNode, SnapshotTreeNodeData, StopSessionResponse } from "./validators.js";
+import { APIClient } from "./api-client.js";

package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/api-client/validators.d.ts

@@ -522,6 +522,17 @@ declare const SnapshotResponse: z.ZodObject<{
     parentId: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
 }, z.core.$strip>;
+declare const Drive: z.ZodObject<{
+  name: z.ZodString;
+  projectId: z.ZodString;
+  region: z.ZodString;
+  maxSizeBytes: z.ZodNumber;
+  currentSessionId: z.ZodOptional<z.ZodString>;
+  currentSandboxName: z.ZodOptional<z.ZodString>;
+  createdAt: z.ZodNumber;
+  updatedAt: z.ZodNumber;
+}, z.core.$strip>;
+type DriveMetadata = z.infer<typeof Drive>;
 declare const Sandbox: z.ZodObject<{
   name: z.ZodString;
   persistent: z.ZodBoolean;
@@ -636,6 +647,13 @@ declare const Sandbox: z.ZodObject<{
   statusUpdatedAt: z.ZodOptional<z.ZodNumber>;
   cwd: z.ZodOptional<z.ZodString>;
   tags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  mounts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    drive: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+      "read-only": "read-only";
+      "read-write": "read-write";
+    }>>;
+  }, z.core.$strip>>>;
   snapshotExpiration: z.ZodOptional<z.ZodNumber>;
   keepLastSnapshots: z.ZodOptional<z.ZodObject<{
     count: z.ZodNumber;
@@ -876,6 +894,13 @@ declare const StopSessionResponse: z.ZodObject<{
     statusUpdatedAt: z.ZodOptional<z.ZodNumber>;
     cwd: z.ZodOptional<z.ZodString>;
     tags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    mounts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+      drive: z.ZodString;
+      mode: z.ZodOptional<z.ZodEnum<{
+        "read-only": "read-only";
+        "read-write": "read-write";
+      }>>;
+    }, z.core.$strip>>>;
     snapshotExpiration: z.ZodOptional<z.ZodNumber>;
     keepLastSnapshots: z.ZodOptional<z.ZodObject<{
       count: z.ZodNumber;
@@ -903,5 +928,5 @@ declare const StopSessionResponse: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 //#endregion
-export { Command, CommandData, CommandFinishedData, CommandFinishedResponse, CommandResponse, CreateSnapshotResponse, InteractiveSessionResponse, LogError, LogLine, LogLineData, LogOutputLine, Sandbox, SandboxMetaData, SandboxRoute, SandboxRouteData, Session, SessionMetaData, SessionResponse, Snapshot, SnapshotMetadata, SnapshotResponse, SnapshotTreeNode, SnapshotTreeNodeData, StopSessionResponse };
+export { Command, CommandData, CommandFinishedData, CommandFinishedResponse, CommandResponse, CreateSnapshotResponse, Drive, DriveMetadata, InteractiveSessionResponse, LogError, LogLine, LogLineData, LogOutputLine, Sandbox, SandboxMetaData, SandboxRoute, SandboxRouteData, Session, SessionMetaData, SessionResponse, Snapshot, SnapshotMetadata, SnapshotResponse, SnapshotTreeNode, SnapshotTreeNodeData, StopSessionResponse };
 //# sourceMappingURL=validators.d.ts.map

package/dist/src/compiled/@vercel/{sandbox-delete → sandbox-drives}/constants.d.ts

@@ -2,8 +2,8 @@
 type RUNTIMES = "node26" | "node24" | "node22" | "python3.13";
 type ManagedImage = "universal" | "node:22" | "node:24" | "node:26" | "python:3.14" | "ubuntu" | "arch";
 /**
- * Regions a sandbox can run in. More regions may become available, so any
- * other region string is accepted too.
+ * Regions a sandbox, snapshot, or drive can live in. More regions may
+ * become available, so any other region string is accepted too.
  */
 type SandboxRegion = "iad1" | "sfo1" | "cle1" | "cdg1" | (string & {});
 /**

package/dist/src/compiled/@vercel/{sandbox → sandbox-drives}/drive.d.ts

@@ -1,5 +1,6 @@
 import { Paginator } from "./utils/paginator.js";
 import { DriveMetadata } from "./api-client/validators.js";
+import { SandboxRegion } from "./constants.js";
 import { APIClient, WithFetchOptions } from "./api-client/api-client.js";
 import "./api-client/index.js";
 import { Credentials } from "./utils/get-credentials.js";
@@ -16,6 +17,11 @@ interface GetOrCreateDriveParams {
    * The name of the drive to get or create. Must be unique within the project.
    */
   name: string;
+  /**
+   * The region where the drive is created and stores its data. Defaults to `iad1`.
+   * See the Vercel documentation for the available regions.
+   */
+  region?: SandboxRegion;
   /**
    * Maximum drive size in bytes. If omitted, a default of 100 GiB is used.
    */
@@ -49,6 +55,10 @@ declare class Drive {
    * The project ID that owns the drive.
    */
   get projectId(): string;
+  /**
+   * The region where the drive data is stored.
+   */
+  get region(): string;
   /**
    * The maximum drive size in bytes.
    */