@vercel/sandbox 1.8.0 → 2.0.0-beta.0

package/dist/api-client/validators.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SnapshotResponse = exports.CreateSnapshotResponse = exports.UpdateNetworkPolicyResponse = exports.ExtendTimeoutResponse = exports.SnapshotsResponse = exports.SandboxesResponse = exports.LogLine = exports.LogError = exports.LogLineStderr = exports.LogLineStdout = exports.EmptyResponse = exports.CommandFinishedResponse = exports.CommandResponse = exports.SandboxAndRoutesResponse = exports.SandboxResponse = exports.Command = exports.Pagination = exports.Snapshot = exports.SandboxRoute = exports.Sandbox = exports.NetworkPolicyValidator = exports.InjectionRuleValidator = void 0;
+exports.UpdateNamedSandboxResponse = exports.NamedSandboxesPaginationResponse = exports.CursorPagination = exports.NamedSandboxAndSessionResponse = exports.NamedSandbox = exports.SnapshotResponse = exports.CreateSnapshotResponse = exports.UpdateNetworkPolicyResponse = exports.ExtendTimeoutResponse = exports.SnapshotsResponse = exports.SandboxesResponse = exports.LogLine = exports.LogError = exports.LogLineStderr = exports.LogLineStdout = exports.EmptyResponse = exports.CommandFinishedResponse = exports.CommandResponse = exports.SandboxAndRoutesResponse = exports.SandboxResponse = exports.Command = exports.Pagination = exports.Snapshot = exports.SandboxRoute = exports.Sandbox = exports.NetworkPolicyValidator = exports.InjectionRuleValidator = void 0;
 const zod_1 = require("zod");
 exports.InjectionRuleValidator = zod_1.z.object({
     domain: zod_1.z.string(),
@@ -154,4 +154,40 @@ exports.CreateSnapshotResponse = zod_1.z.object({
 exports.SnapshotResponse = zod_1.z.object({
     snapshot: exports.Snapshot,
 });
+exports.NamedSandbox = zod_1.z.object({
+    name: zod_1.z.string(),
+    snapshotOnShutdown: zod_1.z.boolean(),
+    region: zod_1.z.string(),
+    vcpus: zod_1.z.number(),
+    memory: zod_1.z.number(),
+    runtime: zod_1.z.string(),
+    timeout: zod_1.z.number(),
+    networkPolicy: exports.NetworkPolicyValidator.optional(),
+    totalEgressBytes: zod_1.z.number().optional(),
+    totalIngressBytes: zod_1.z.number().optional(),
+    totalActiveCpuDurationMs: zod_1.z.number().optional(),
+    totalDurationMs: zod_1.z.number().optional(),
+    createdAt: zod_1.z.number(),
+    updatedAt: zod_1.z.number(),
+    currentSandboxId: zod_1.z.string(),
+    currentSnapshotId: zod_1.z.string().optional(),
+    status: exports.Sandbox.shape.status,
+});
+exports.NamedSandboxAndSessionResponse = zod_1.z.object({
+    namedSandbox: exports.NamedSandbox,
+    sandbox: exports.Sandbox,
+    routes: zod_1.z.array(exports.SandboxRoute),
+});
+exports.CursorPagination = zod_1.z.object({
+    count: zod_1.z.number(),
+    next: zod_1.z.string().nullable(),
+    total: zod_1.z.number(),
+});
+exports.NamedSandboxesPaginationResponse = zod_1.z.object({
+    namedSandboxes: zod_1.z.array(exports.NamedSandbox),
+    pagination: exports.CursorPagination,
+});
+exports.UpdateNamedSandboxResponse = zod_1.z.object({
+    namedSandbox: exports.NamedSandbox,
+});
 //# sourceMappingURL=validators.js.map

package/dist/api-client/validators.js.map

@@ -1 +1 @@
-{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/api-client/validators.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/api-client/validators.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { Sandbox, type NetworkPolicy, type NetworkPolicyRule, type NetworkTransformer, } from "./sandbox";
+export { type NetworkPolicy, Sandbox, } from "./sandbox";
+export { Session, type NetworkPolicyRule, type NetworkTransformer, } from "./session";
 export { Snapshot } from "./snapshot";
 export { Command, CommandFinished } from "./command";
 export { StreamError } from "./api-client/api-error";

package/dist/index.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.APIError = exports.StreamError = exports.CommandFinished = exports.Command = exports.Snapshot = exports.Sandbox = void 0;
+exports.APIError = exports.StreamError = exports.CommandFinished = exports.Command = exports.Snapshot = exports.Session = exports.Sandbox = void 0;
 var sandbox_1 = require("./sandbox");
 Object.defineProperty(exports, "Sandbox", { enumerable: true, get: function () { return sandbox_1.Sandbox; } });
+var session_1 = require("./session");
+Object.defineProperty(exports, "Session", { enumerable: true, get: function () { return session_1.Session; } });
 var snapshot_1 = require("./snapshot");
 Object.defineProperty(exports, "Snapshot", { enumerable: true, get: function () { return snapshot_1.Snapshot; } });
 var command_1 = require("./command");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAKmB;AAJjB,kGAAA,OAAO,OAAA;AAKT,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,qCAAqD;AAA5C,kGAAA,OAAO,OAAA;AAAE,0GAAA,eAAe,OAAA;AACjC,oDAAqD;AAA5C,wGAAA,WAAW,OAAA;AACpB,oDAAkD;AAAzC,qGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAGmB;AADjB,kGAAA,OAAO,OAAA;AAET,qCAImB;AAHjB,kGAAA,OAAO,OAAA;AAIT,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,qCAAqD;AAA5C,kGAAA,OAAO,OAAA;AAAE,0GAAA,eAAe,OAAA;AACjC,oDAAqD;AAA5C,wGAAA,WAAW,OAAA;AACpB,oDAAkD;AAAzC,qGAAA,QAAQ,OAAA"}

package/dist/sandbox.d.ts

@@ -1,17 +1,21 @@
-import type { SandboxMetaData, SandboxRouteData } from "./api-client";
-import { type Writable } from "stream";
+import type { SandboxMetaData, SandboxRouteData, NamedSandboxMetaData } from "./api-client";
 import { APIClient } from "./api-client";
-import { Command, CommandFinished } from "./command";
 import { type Credentials } from "./utils/get-credentials";
-import { WithPrivate } from "./utils/types";
-import { WithFetchOptions } from "./api-client/api-client";
-import { RUNTIMES } from "./constants";
-import { Snapshot } from "./snapshot";
-import { type NetworkPolicy, type NetworkPolicyRule, type NetworkTransformer } from "./network-policy";
-import { type ConvertedSandbox } from "./utils/convert-sandbox";
-export type { NetworkPolicy, NetworkPolicyRule, NetworkTransformer };
+import { type WithPrivate } from "./utils/types";
+import type { WithFetchOptions } from "./api-client/api-client";
+import type { RUNTIMES } from "./constants";
+import { Session, type RunCommandParams } from "./session";
+import type { Command, CommandFinished } from "./command";
+import type { Snapshot } from "./snapshot";
+import type { ConvertedSandbox } from "./utils/convert-sandbox";
+import type { NetworkPolicy } from "./network-policy";
+export type { NetworkPolicy };
 /** @inline */
 export interface BaseCreateSandboxParams {
+    /**
+     * The name of the sandbox. If omitted, a random name will be generated.
+     */
+    name?: string;
     /**
      * The source of the sandbox.
      *
@@ -82,6 +86,10 @@ export interface BaseCreateSandboxParams {
      * An AbortSignal to cancel sandbox creation.
      */
     signal?: AbortSignal;
+    /**
+     * Whether to enable snapshots on shutdown. Defaults to true.
+     */
+    snapshotOnShutdown?: boolean;
 }
 export type CreateSandboxParams = BaseCreateSandboxParams | (Omit<BaseCreateSandboxParams, "runtime" | "source"> & {
     source: {
@@ -92,167 +100,177 @@ export type CreateSandboxParams = BaseCreateSandboxParams | (Omit<BaseCreateSand
 /** @inline */
 interface GetSandboxParams {
     /**
-     * Unique identifier of the sandbox.
+     * The name of the sandbox.
+     */
+    name: string;
+    /**
+     * Whether to resume an existing session. Defaults to true.
      */
-    sandboxId: string;
+    resume?: boolean;
     /**
      * An AbortSignal to cancel the operation.
      */
     signal?: AbortSignal;
 }
-/** @inline */
-interface RunCommandParams {
+/**
+ * A Sandbox is a persistent, isolated Linux MicroVMs to run commands in.
+ * Use {@link Sandbox.create} or {@link Sandbox.get} to construct.
+ * @hideconstructor
+ */
+export declare class Sandbox {
+    private readonly client;
+    private readonly projectId;
     /**
-     * The command to execute
+     * Internal Session instance for the current VM.
      */
-    cmd: string;
+    private session;
     /**
-     * Arguments to pass to the command
+     * Internal metadata about the named sandbox.
      */
-    args?: string[];
+    private namedSandbox;
     /**
-     * Working directory to execute the command in
+     * The name of this sandbox.
      */
-    cwd?: string;
+    get name(): string;
     /**
-     * Environment variables to set for this command
+     * Routes from ports to subdomains.
+     * @hidden
      */
-    env?: Record<string, string>;
+    get routes(): SandboxRouteData[];
     /**
-     * If true, execute this command with root privileges. Defaults to false.
+     * Whether this sandbox snapshots on shutdown.
      */
-    sudo?: boolean;
+    get snapshotOnShutdown(): boolean;
     /**
-     * If true, the command will return without waiting for `exitCode`
+     * The region this sandbox runs in.
      */
-    detached?: boolean;
+    get region(): string;
     /**
-     * A `Writable` stream where `stdout` from the command will be piped
+     * Number of virtual CPUs allocated.
      */
-    stdout?: Writable;
+    get vcpus(): number;
     /**
-     * A `Writable` stream where `stderr` from the command will be piped
+     * Memory allocated in MB.
      */
-    stderr?: Writable;
+    get memory(): number;
+    /** Runtime identifier (e.g. "node24", "python3.13"). */
+    get runtime(): string;
     /**
-     * An AbortSignal to cancel the command execution
+     * Cumulative egress bytes across all sessions.
      */
-    signal?: AbortSignal;
-}
-/**
- * A Sandbox is an isolated Linux MicroVM to run commands in.
- *
- * Use {@link Sandbox.create} or {@link Sandbox.get} to construct.
- * @hideconstructor
- */
-export declare class Sandbox {
-    private readonly client;
+    get totalEgressBytes(): number | undefined;
     /**
-     * Routes from ports to subdomains.
-    /* @hidden
+     * Cumulative ingress bytes across all sessions.
      */
-    readonly routes: SandboxRouteData[];
+    get totalIngressBytes(): number | undefined;
     /**
-     * Unique ID of this sandbox.
+     * Cumulative active CPU duration in milliseconds across all sessions.
      */
-    get sandboxId(): string;
-    get interactivePort(): number | undefined;
+    get totalActiveCpuDurationMs(): number | undefined;
     /**
-     * The status of the sandbox.
+     * Cumulative wall-clock duration in milliseconds across all sessions.
      */
-    get status(): SandboxMetaData["status"];
+    get totalDurationMs(): number | undefined;
+    /**
+     * When this sandbox was last updated.
+     */
+    get updatedAt(): Date;
     /**
-     * The creation date of the sandbox.
+     * When this sandbox was created.
      */
     get createdAt(): Date;
     /**
-     * The timeout of the sandbox in milliseconds.
+     * Interactive port.
+     */
+    get interactivePort(): number | undefined;
+    /**
+     * The status of the current session.
+     */
+    get status(): SandboxMetaData["status"];
+    /**
+     * The default timeout of this sandbox in milliseconds.
      */
     get timeout(): number;
     /**
-     * The network policy of the sandbox.
+     * The default network policy of this sandbox.
      */
     get networkPolicy(): NetworkPolicy | undefined;
     /**
-     * If the sandbox was created from a snapshot, the ID of that snapshot.
+     * If the session was created from a snapshot, the ID of that snapshot.
      */
     get sourceSnapshotId(): string | undefined;
     /**
-     * The amount of CPU used by the sandbox. Only reported once the VM is stopped.
+     * The current snapshot ID of this sandbox, if any.
+     */
+    get currentSnapshotId(): string | undefined;
+    /**
+     * The amount of CPU used by the session. Only reported once the VM is stopped.
      */
     get activeCpuUsageMs(): number | undefined;
     /**
-     * The amount of network data used by the sandbox. Only reported once the VM is stopped.
+     * The amount of network data used by the session. Only reported once the VM is stopped.
      */
     get networkTransfer(): {
         ingress: number;
         egress: number;
     } | undefined;
-    /**
-     * Internal metadata about this sandbox.
-     */
-    private sandbox;
     /**
      * Allow to get a list of sandboxes for a team narrowed to the given params.
      * It returns both the sandboxes and the pagination metadata to allow getting
      * the next page of results.
      */
-    static list(params?: Partial<Parameters<APIClient["listSandboxes"]>[0]> & Partial<Credentials> & WithFetchOptions): Promise<import("./api-client/base-client").Parsed<{
-        sandboxes: {
-            id: string;
-            memory: number;
-            vcpus: number;
-            region: string;
-            runtime: string;
-            timeout: number;
-            status: "aborted" | "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
-            requestedAt: number;
-            createdAt: number;
-            cwd: string;
-            updatedAt: number;
-            startedAt?: number | undefined;
-            requestedStopAt?: number | undefined;
-            stoppedAt?: number | undefined;
-            abortedAt?: number | undefined;
-            duration?: number | undefined;
-            sourceSnapshotId?: string | undefined;
-            snapshottedAt?: number | undefined;
-            interactivePort?: number | undefined;
-            networkPolicy?: import("zod").objectInputType<{
-                mode: import("zod").ZodLiteral<"allow-all">;
-            }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectInputType<{
-                mode: import("zod").ZodLiteral<"deny-all">;
-            }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectInputType<{
-                mode: import("zod").ZodLiteral<"custom">;
-                allowedDomains: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
-                allowedCIDRs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
-                deniedCIDRs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
-                injectionRules: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
-                    domain: import("zod").ZodString;
-                    headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
-                    headerNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
-                }, "strip", import("zod").ZodTypeAny, {
-                    domain: string;
-                    headers?: Record<string, string> | undefined;
-                    headerNames?: string[] | undefined;
-                }, {
-                    domain: string;
-                    headers?: Record<string, string> | undefined;
-                    headerNames?: string[] | undefined;
-                }>, "many">>;
-            }, import("zod").ZodTypeAny, "passthrough"> | undefined;
-            activeCpuDurationMs?: number | undefined;
-            networkTransfer?: {
-                ingress: number;
-                egress: number;
-            } | undefined;
-        }[];
-        pagination: {
-            count: number;
-            next: number | null;
-            prev: number | null;
+    static list(params?: Partial<Parameters<APIClient["listNamedSandboxes"]>[0]> & Partial<Credentials> & WithFetchOptions): Promise<{
+        json: {
+            sandboxes: {
+                memory: number;
+                vcpus: number;
+                region: string;
+                runtime: string;
+                timeout: number;
+                status: "aborted" | "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
+                createdAt: number;
+                updatedAt: number;
+                name: string;
+                snapshotOnShutdown: boolean;
+                currentSandboxId: string;
+                networkPolicy?: import("zod").objectInputType<{
+                    mode: import("zod").ZodLiteral<"allow-all">;
+                }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectInputType<{
+                    mode: import("zod").ZodLiteral<"deny-all">;
+                }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectInputType<{
+                    mode: import("zod").ZodLiteral<"custom">;
+                    allowedDomains: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+                    allowedCIDRs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+                    deniedCIDRs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+                    injectionRules: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                        domain: import("zod").ZodString;
+                        headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+                        headerNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+                    }, "strip", import("zod").ZodTypeAny, {
+                        domain: string;
+                        headers?: Record<string, string> | undefined;
+                        headerNames?: string[] | undefined;
+                    }, {
+                        domain: string;
+                        headers?: Record<string, string> | undefined;
+                        headerNames?: string[] | undefined;
+                    }>, "many">>;
+                }, import("zod").ZodTypeAny, "passthrough"> | undefined;
+                totalEgressBytes?: number | undefined;
+                totalIngressBytes?: number | undefined;
+                totalActiveCpuDurationMs?: number | undefined;
+                totalDurationMs?: number | undefined;
+                currentSnapshotId?: string | undefined;
+            }[];
+            pagination: {
+                count: number;
+                next: string | null;
+                total: number;
+            };
         };
-    }>>;
+        response: Response;
+        text: string;
+    }>;
     /**
      * Create a new sandbox.
      *
@@ -267,28 +285,37 @@ export declare class Sandbox {
      */
     static create(params?: WithPrivate<CreateSandboxParams | (CreateSandboxParams & Credentials)> & WithFetchOptions): Promise<Sandbox & AsyncDisposable>;
     /**
-     * Retrieve an existing sandbox.
+     * Retrieve an existing sandbox and resume its session.
      *
      * @param params - Get parameters and optional credentials.
      * @returns A promise resolving to the {@link Sandbox}.
      */
     static get(params: WithPrivate<GetSandboxParams | (GetSandboxParams & Credentials)> & WithFetchOptions): Promise<Sandbox>;
-    constructor({ client, routes, sandbox, }: {
+    constructor({ client, routes, session, namedSandbox, projectId, }: {
         client: APIClient;
         routes: SandboxRouteData[];
-        sandbox: SandboxMetaData;
+        session: SandboxMetaData;
+        namedSandbox: NamedSandboxMetaData;
+        projectId: string;
     });
     /**
-     * Get a previously run command by its ID.
+     * Get the current session (the running VM) for this sandbox.
      *
-     * @param cmdId - ID of the command to retrieve
-     * @param opts - Optional parameters.
-     * @param opts.signal - An AbortSignal to cancel the operation.
-     * @returns A {@link Command} instance representing the command
+     * @returns The {@link Session} instance.
      */
-    getCommand(cmdId: string, opts?: {
-        signal?: AbortSignal;
-    }): Promise<Command>;
+    currentSession(): Session;
+    /**
+     * Resume this sandbox by creating a new session via `getNamedSandbox`.
+     */
+    private resume;
+    /**
+     * Poll until the current session reaches a terminal state, then resume.
+     */
+    private waitForStopAndResume;
+    /**
+     * Execute `fn`, and if the session is stopped/stopping, resume and retry.
+     */
+    private withResume;
     /**
      * Start executing a command in this sandbox.
      *
@@ -324,7 +351,9 @@ export declare class Sandbox {
      * @returns A {@link Command} or {@link CommandFinished}, depending on `detached`.
      * @internal
      */
-    _runCommand(params: RunCommandParams): Promise<Command>;
+    getCommand(cmdId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<Command>;
     /**
      * Create a directory in the filesystem of this sandbox.
      *
@@ -487,4 +516,126 @@ export declare class Sandbox {
         expiration?: number;
         signal?: AbortSignal;
     }): Promise<Snapshot>;
+    /**
+     * Update the named sandbox configuration. Only provided fields are modified.
+     *
+     * @param params - Fields to update.
+     * @param opts - Optional abort signal.
+     */
+    update(params: {
+        resources?: {
+            vcpus?: number;
+            memory?: number;
+        };
+        runtime?: RUNTIMES | (string & {});
+        timeout?: number;
+        networkPolicy?: NetworkPolicy;
+    }, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Delete this named sandbox.
+     *
+     * After deletion the instance becomes inert — all further API calls will
+     * throw immediately.
+     */
+    delete(opts?: {
+        preserveSnapshots?: boolean;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * List sessions (VMs) that have been created for this named sandbox.
+     *
+     * @param params - Optional pagination parameters.
+     * @returns The list of sessions and pagination metadata.
+     */
+    listSessions(params?: {
+        limit?: number;
+        since?: number | Date;
+        until?: number | Date;
+        signal?: AbortSignal;
+    }): Promise<import("./api-client/base-client").Parsed<{
+        sandboxes: {
+            id: string;
+            memory: number;
+            vcpus: number;
+            region: string;
+            runtime: string;
+            timeout: number;
+            status: "aborted" | "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
+            requestedAt: number;
+            createdAt: number;
+            cwd: string;
+            updatedAt: number;
+            startedAt?: number | undefined;
+            requestedStopAt?: number | undefined;
+            stoppedAt?: number | undefined;
+            abortedAt?: number | undefined;
+            duration?: number | undefined;
+            sourceSnapshotId?: string | undefined;
+            snapshottedAt?: number | undefined;
+            interactivePort?: number | undefined;
+            networkPolicy?: import("zod").objectInputType<{
+                mode: import("zod").ZodLiteral<"allow-all">;
+            }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectInputType<{
+                mode: import("zod").ZodLiteral<"deny-all">;
+            }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectInputType<{
+                mode: import("zod").ZodLiteral<"custom">;
+                allowedDomains: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+                allowedCIDRs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+                deniedCIDRs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+                injectionRules: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                    domain: import("zod").ZodString;
+                    headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+                    headerNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+                }, "strip", import("zod").ZodTypeAny, {
+                    domain: string;
+                    headers?: Record<string, string> | undefined;
+                    headerNames?: string[] | undefined;
+                }, {
+                    domain: string;
+                    headers?: Record<string, string> | undefined;
+                    headerNames?: string[] | undefined;
+                }>, "many">>;
+            }, import("zod").ZodTypeAny, "passthrough"> | undefined;
+            activeCpuDurationMs?: number | undefined;
+            networkTransfer?: {
+                ingress: number;
+                egress: number;
+            } | undefined;
+        }[];
+        pagination: {
+            count: number;
+            next: number | null;
+            prev: number | null;
+        };
+    }>>;
+    /**
+     * List snapshots that belong to this named sandbox.
+     *
+     * @param params - Optional pagination parameters.
+     * @returns The list of snapshots and pagination metadata.
+     */
+    listSnapshots(params?: {
+        limit?: number;
+        since?: number | Date;
+        until?: number | Date;
+        signal?: AbortSignal;
+    }): Promise<import("./api-client/base-client").Parsed<{
+        pagination: {
+            count: number;
+            next: number | null;
+            prev: number | null;
+        };
+        snapshots: {
+            id: string;
+            region: string;
+            status: "failed" | "created" | "deleted";
+            createdAt: number;
+            updatedAt: number;
+            sourceSandboxId: string;
+            sizeBytes: number;
+            expiresAt?: number | undefined;
+        }[];
+    }>>;
 }