eve 0.58.0 → 0.59.0

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

@@ -1,5 +1,5 @@
 import { BaseClient, Parsed, RequestParams } from "./base-client.js";
-import { CommandData, CommandFinishedData, CommandFinishedResponse, CommandResponse, CreateSnapshotResponse, InteractiveSessionResponse, LogOutputLine, SessionResponse, SnapshotResponse, StopSessionResponse } from "./validators.js";
+import { CommandData, CommandFinishedData, CommandFinishedResponse, CommandResponse, CreateSnapshotResponse, InteractiveSessionResponse, LogOutputLine, SandboxMetaData, SessionResponse, SnapshotResponse, StopSessionResponse } from "./validators.js";
 import { FileWriter } from "./file-writer.js";
 import { NetworkPolicy } from "../network-policy.js";
 import { WithPrivate } from "../utils/types.js";
@@ -180,6 +180,7 @@ declare class APIClient extends BaseClient {
       expiration?: number;
       deleteEvicted?: boolean;
     };
+    mounts?: SandboxMetaData["mounts"];
     region?: SandboxRegion;
     failoverRegions?: SandboxRegion[];
     signal?: AbortSignal;
@@ -293,6 +294,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode: "snapshot" | "read-write";
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;
@@ -553,6 +558,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode: "snapshot" | "read-write";
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;
@@ -1010,6 +1019,50 @@ declare class APIClient extends BaseClient {
       count: string;
     } | undefined;
   }>>;
+  listDrives(params: {
+    projectId: string;
+    limit?: number;
+    cursor?: string;
+    sortBy?: "createdAt" | "updatedAt" | "name";
+    sortOrder?: "asc" | "desc";
+    namePrefix?: string;
+    signal?: AbortSignal;
+  }): Promise<Parsed<{
+    drives: {
+      id: string;
+      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: {
+      id: string;
+      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 +1246,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode: "snapshot" | "read-write";
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;
@@ -1444,6 +1501,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode: "snapshot" | "read-write";
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;
@@ -1456,6 +1517,23 @@ declare class APIClient extends BaseClient {
       next: string | null;
     };
   }>>;
+  deleteDrive(params: {
+    projectId: string;
+    name: string;
+    signal?: AbortSignal;
+  }): Promise<Parsed<{
+    drive: {
+      id: string;
+      name: string;
+      projectId: string;
+      region: string;
+      maxSizeBytes: number;
+      createdAt: number;
+      updatedAt: number;
+      currentSessionId?: string | undefined;
+      currentSandboxName?: string | undefined;
+    };
+  }>>;
   updateSandbox(params: {
     name: string;
     projectId: string;
@@ -1477,6 +1555,7 @@ declare class APIClient extends BaseClient {
     currentSnapshotId?: string;
     region?: SandboxRegion;
     failoverRegions?: SandboxRegion[];
+    mounts?: SandboxMetaData["mounts"];
     signal?: AbortSignal;
   }): Promise<Parsed<{
     sandbox: {
@@ -1588,6 +1667,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode: "snapshot" | "read-write";
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;
@@ -1716,6 +1799,10 @@ declare class APIClient extends BaseClient {
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
       tags?: Record<string, string> | undefined;
+      mounts?: Record<string, {
+        drive: string;
+        mode: "snapshot" | "read-write";
+      }> | undefined;
       snapshotExpiration?: number | undefined;
       keepLastSnapshots?: {
         count: number;

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

@@ -1,2 +1,2 @@
-import { Command, CommandData, CommandFinishedData, CommandFinishedResponse, CommandResponse, CreateSnapshotResponse, InteractiveSessionResponse, LogError, LogLine, LogLineData, LogOutputLine, Sandbox, SandboxMetaData, SandboxRoute, SandboxRouteData, Session, SessionMetaData, SessionResponse, Snapshot, SnapshotMetadata, SnapshotResponse, SnapshotTreeNode, SnapshotTreeNodeData, StopSessionResponse } from "./validators.js";
+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/api-client/validators.d.ts

@@ -522,6 +522,18 @@ declare const SnapshotResponse: z.ZodObject<{
     parentId: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
 }, z.core.$strip>;
+declare const Drive: z.ZodObject<{
+  id: z.ZodString;
+  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 +648,20 @@ 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.ZodPipe<z.ZodObject<{
+    drive: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+      snapshot: "snapshot";
+      "read-write": "read-write";
+      "read-only": "read-only";
+    }>>;
+  }, z.core.$strip>, z.ZodTransform<{
+    drive: string;
+    mode: "snapshot" | "read-write";
+  }, {
+    drive: string;
+    mode?: "snapshot" | "read-write" | "read-only" | undefined;
+  }>>>>;
   snapshotExpiration: z.ZodOptional<z.ZodNumber>;
   keepLastSnapshots: z.ZodOptional<z.ZodObject<{
     count: z.ZodNumber;
@@ -876,6 +902,20 @@ 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.ZodPipe<z.ZodObject<{
+      drive: z.ZodString;
+      mode: z.ZodOptional<z.ZodEnum<{
+        snapshot: "snapshot";
+        "read-write": "read-write";
+        "read-only": "read-only";
+      }>>;
+    }, z.core.$strip>, z.ZodTransform<{
+      drive: string;
+      mode: "snapshot" | "read-write";
+    }, {
+      drive: string;
+      mode?: "snapshot" | "read-write" | "read-only" | undefined;
+    }>>>>;
     snapshotExpiration: z.ZodOptional<z.ZodNumber>;
     keepLastSnapshots: z.ZodOptional<z.ZodObject<{
       count: z.ZodNumber;
@@ -903,5 +943,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/constants.d.ts

@@ -2,10 +2,10 @@
 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 & {});
+type SandboxRegion = "iad1" | "sfo1" | "cle1" | "cdg1" | "fra1" | "arn1" | "sin1" | "pdx1" | "lhr1" | "icn1" | "bom1" | "cpt1" | "dub1" | "gru1" | "hkg1" | "syd1" | "yul1" | "hnd1" | "kix1" | (string & {});
 /**
  * Region a sandbox runs in when none is requested.
  */

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

@@ -23,7 +23,7 @@ interface GetOrCreateDriveParams {
    */
   region?: SandboxRegion;
   /**
-   * Maximum drive size in bytes. If omitted, a default of 100 GiB is used.
+   * Drive size in bytes. Defaults to 1 TiB.
    */
   maxSize?: number;
   /**
@@ -33,7 +33,7 @@ interface GetOrCreateDriveParams {
 }
 /**
  * A Drive is a persistent, bottomless storage that can be attached and detached to Sandboxes.
- * Drives can be mounted as read-write or read-only, at a configurable path with `Sandbox.create()`.
+ * Drives can be mounted as read-write or as read-only snapshots, at a configurable path with `Sandbox.create()`.
  *
  * Use {@link Drive.getOrCreate} to construct.
  * @hideconstructor
@@ -47,6 +47,10 @@ declare class Drive {
    * @internal
    */
   private ensureClient;
+  /**
+   * Unique ID of this drive.
+   */
+  get driveId(): string;
   /**
    * The name of the drive.
    */
@@ -79,6 +83,13 @@ declare class Drive {
    * Timestamp when the drive was last updated.
    */
   get updatedAt(): Date;
+  /**
+   * Mount this drive as a read-only snapshot.
+   */
+  snapshot(): {
+    drive: string;
+    mode: "snapshot";
+  };
   /**
    * Serialize a Drive instance to plain data for @workflow/serde.
    *

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

@@ -6,8 +6,9 @@ import { Command, CommandFinished, CommandOutput, SerializedCommand, SerializedC
 import { SerializedSnapshot, Snapshot } from "./snapshot.js";
 import { ExecutionContext } from "./execution-context.js";
 import { Session } from "./session.js";
+import { Drive, SerializedDrive } from "./drive.js";
 import { FileSystem } from "./filesystem.js";
 import { SandboxUser, SandboxUserAlreadyExistsError } from "./sandbox-user.js";
-import { Sandbox, SerializedSandbox } from "./sandbox.js";
+import { Sandbox, SandboxMountMode, SandboxMounts, SerializedSandbox } from "./sandbox.js";
 import { InvalidRequestProxyHandler, ProxyHandler, ProxyMeta, defineSandboxProxy } from "./proxy.js";
-export { APIError, Command, CommandFinished, type CommandOutput, DEFAULT_SANDBOX_REGION, type ExecutionContext, FileSystem, type InvalidRequestProxyHandler, type NetworkPolicy, type NetworkPolicyKeyValueMatcher, type NetworkPolicyMatch, type NetworkPolicyMatcher, type NetworkPolicyRule, type NetworkTransformer, type ProxyHandler, type ProxyMeta, Sandbox, type SandboxRegion, SandboxUser, SandboxUserAlreadyExistsError, type SerializedCommand, type SerializedCommandFinished, type SerializedSandbox, type SerializedSnapshot, Session, Snapshot, type SnapshotTreeNodeData, StreamError, defineSandboxProxy };
+export { APIError, Command, CommandFinished, type CommandOutput, DEFAULT_SANDBOX_REGION, Drive, type ExecutionContext, FileSystem, type InvalidRequestProxyHandler, type NetworkPolicy, type NetworkPolicyKeyValueMatcher, type NetworkPolicyMatch, type NetworkPolicyMatcher, type NetworkPolicyRule, type NetworkTransformer, type ProxyHandler, type ProxyMeta, Sandbox, type SandboxMountMode, type SandboxMounts, type SandboxRegion, SandboxUser, SandboxUserAlreadyExistsError, type SerializedCommand, type SerializedCommandFinished, type SerializedDrive, type SerializedSandbox, type SerializedSnapshot, Session, Snapshot, type SnapshotTreeNodeData, StreamError, defineSandboxProxy };