@openai/agents-extensions 0.8.5 → 0.9.0

package/dist/sandbox/shared/snapshots.mjs

@@ -0,0 +1,57 @@
+import { SandboxSnapshotError } from '@openai/agents-core/sandbox';
+import { toWorkspaceArchiveBytes } from "./archive.mjs";
+const NATIVE_SNAPSHOT_PREFIXES = {
+    e2b: 'E2B_SANDBOX_SNAPSHOT_V1\n',
+    modal_snapshot_directory: 'MODAL_SANDBOX_DIR_SNAPSHOT_V1\n',
+    modal_snapshot_filesystem: 'MODAL_SANDBOX_FS_SNAPSHOT_V1\n',
+    runloop: 'RUNLOOP_SANDBOX_SNAPSHOT_V1\n',
+    vercel: 'UC_VERCEL_SNAPSHOT_V1\n',
+};
+export function encodeNativeSnapshotRef(ref) {
+    const prefix = NATIVE_SNAPSHOT_PREFIXES[ref.provider];
+    const body = JSON.stringify({
+        snapshot_id: ref.snapshotId,
+        ...(ref.workspacePersistence
+            ? { workspace_persistence: ref.workspacePersistence }
+            : {}),
+    }, Object.keys({
+        snapshot_id: ref.snapshotId,
+        workspace_persistence: ref.workspacePersistence,
+    }).sort());
+    return new TextEncoder().encode(`${prefix}${body}`);
+}
+export function decodeNativeSnapshotRef(data) {
+    const text = new TextDecoder().decode(toWorkspaceArchiveBytes(data));
+    for (const [provider, prefix] of Object.entries(NATIVE_SNAPSHOT_PREFIXES)) {
+        if (!text.startsWith(prefix)) {
+            continue;
+        }
+        try {
+            const payload = JSON.parse(text.slice(prefix.length));
+            if (typeof payload.snapshot_id !== 'string' || !payload.snapshot_id) {
+                return undefined;
+            }
+            return {
+                provider,
+                snapshotId: payload.snapshot_id,
+                workspacePersistence: typeof payload.workspace_persistence === 'string'
+                    ? payload.workspace_persistence
+                    : undefined,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+export function requireNativeSnapshotRef(data, provider) {
+    const ref = decodeNativeSnapshotRef(data);
+    if (!ref || ref.provider !== provider) {
+        throw new SandboxSnapshotError(`Expected a ${provider} native snapshot reference.`, {
+            provider,
+        });
+    }
+    return ref;
+}
+//# sourceMappingURL=snapshots.mjs.map

package/dist/sandbox/shared/snapshots.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.mjs","sourceRoot":"","sources":["../../../src/sandbox/shared/snapshots.ts"],"names":[],"mappings":"OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B;OAC3D,EAAE,uBAAuB,EAAE;AAelC,MAAM,wBAAwB,GAA2C;IACvE,GAAG,EAAE,2BAA2B;IAChC,wBAAwB,EAAE,iCAAiC;IAC3D,yBAAyB,EAAE,gCAAgC;IAC3D,OAAO,EAAE,+BAA+B;IACxC,MAAM,EAAE,yBAAyB;CAClC,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,GAAsB;IAC5D,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CACzB;QACE,WAAW,EAAE,GAAG,CAAC,UAAU;QAC3B,GAAG,CAAC,GAAG,CAAC,oBAAoB;YAC1B,CAAC,CAAC,EAAE,qBAAqB,EAAE,GAAG,CAAC,oBAAoB,EAAE;YACrD,CAAC,CAAC,EAAE,CAAC;KACR,EACD,MAAM,CAAC,IAAI,CAAC;QACV,WAAW,EAAE,GAAG,CAAC,UAAU;QAC3B,qBAAqB,EAAE,GAAG,CAAC,oBAAoB;KAChD,CAAC,CAAC,IAAI,EAAE,CACV,CAAC;IACF,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAAuC;IAEvC,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;IAErE,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAGrE,EAAE,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAGnD,CAAC;YACF,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBACpE,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,OAAO;gBACL,QAAQ;gBACR,UAAU,EAAE,OAAO,CAAC,WAAW;gBAC/B,oBAAoB,EAClB,OAAO,OAAO,CAAC,qBAAqB,KAAK,QAAQ;oBAC/C,CAAC,CAAC,OAAO,CAAC,qBAAqB;oBAC/B,CAAC,CAAC,SAAS;aAChB,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,IAAuC,EACvC,QAAgC;IAEhC,MAAM,GAAG,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,oBAAoB,CAC5B,cAAc,QAAQ,6BAA6B,EACnD;YACE,QAAQ;SACT,CACF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/sandbox/shared/typeGuards.d.ts

@@ -0,0 +1,10 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isStringRecord(value: unknown): value is Record<string, string>;
+export declare function readOptionalString(value: Record<string, unknown> | undefined, key: string): string | undefined;
+export declare function readOptionalRecord(value: unknown): Record<string, unknown> | undefined;
+export declare function readString(value: Record<string, unknown>, key: string, fallback?: string): string;
+export declare function readOptionalNumber(value: Record<string, unknown>, key: string): number | undefined;
+export declare function readOptionalBoolean(value: Record<string, unknown>, key: string): boolean | undefined;
+export declare function readOptionalNumberArray(value: unknown): number[] | undefined;
+export declare function readOptionalRecordArray(value: unknown): Array<Record<string, unknown>> | undefined;
+export declare function readOptionalStringRecord(value: unknown): Record<string, string> | undefined;

package/dist/sandbox/shared/typeGuards.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRecord = isRecord;
+exports.isStringRecord = isStringRecord;
+exports.readOptionalString = readOptionalString;
+exports.readOptionalRecord = readOptionalRecord;
+exports.readString = readString;
+exports.readOptionalNumber = readOptionalNumber;
+exports.readOptionalBoolean = readOptionalBoolean;
+exports.readOptionalNumberArray = readOptionalNumberArray;
+exports.readOptionalRecordArray = readOptionalRecordArray;
+exports.readOptionalStringRecord = readOptionalStringRecord;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isStringRecord(value) {
+    return (isRecord(value) &&
+        Object.values(value).every((entry) => typeof entry === 'string'));
+}
+function readOptionalString(value, key) {
+    const result = value?.[key];
+    return typeof result === 'string' ? result : undefined;
+}
+function readOptionalRecord(value) {
+    return isRecord(value) ? value : undefined;
+}
+function readString(value, key, fallback = '') {
+    const result = value[key];
+    return result === undefined || result === null ? fallback : String(result);
+}
+function readOptionalNumber(value, key) {
+    const result = value[key];
+    return typeof result === 'number' ? result : undefined;
+}
+function readOptionalBoolean(value, key) {
+    const result = value[key];
+    return typeof result === 'boolean' ? result : undefined;
+}
+function readOptionalNumberArray(value) {
+    return Array.isArray(value)
+        ? value.filter((entry) => typeof entry === 'number')
+        : undefined;
+}
+function readOptionalRecordArray(value) {
+    return Array.isArray(value) ? value.filter(isRecord) : undefined;
+}
+function readOptionalStringRecord(value) {
+    return isStringRecord(value) ? value : undefined;
+}
+//# sourceMappingURL=typeGuards.js.map

package/dist/sandbox/shared/typeGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.js","sourceRoot":"","sources":["../../../src/sandbox/shared/typeGuards.ts"],"names":[],"mappings":";;AAAA,4BAEC;AAED,wCAOC;AAED,gDAMC;AAED,gDAIC;AAED,gCAOC;AAED,gDAMC;AAED,kDAMC;AAED,0DAIC;AAED,0DAIC;AAED,4DAIC;AApED,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAgB,cAAc,CAC5B,KAAc;IAEd,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CACjE,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAChC,KAA0C,EAC1C,GAAW;IAEX,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,SAAgB,kBAAkB,CAChC,KAAc;IAEd,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC;AAED,SAAgB,UAAU,CACxB,KAA8B,EAC9B,GAAW,EACX,WAAmB,EAAE;IAErB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,kBAAkB,CAChC,KAA8B,EAC9B,GAAW;IAEX,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,SAAgB,mBAAmB,CACjC,KAA8B,EAC9B,GAAW;IAEX,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,SAAgB,uBAAuB,CAAC,KAAc;IACpD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QACrE,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAgB,uBAAuB,CACrC,KAAc;IAEd,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC;AAED,SAAgB,wBAAwB,CACtC,KAAc;IAEd,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC"}

package/dist/sandbox/shared/typeGuards.mjs

@@ -0,0 +1,38 @@
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function isStringRecord(value) {
+    return (isRecord(value) &&
+        Object.values(value).every((entry) => typeof entry === 'string'));
+}
+export function readOptionalString(value, key) {
+    const result = value?.[key];
+    return typeof result === 'string' ? result : undefined;
+}
+export function readOptionalRecord(value) {
+    return isRecord(value) ? value : undefined;
+}
+export function readString(value, key, fallback = '') {
+    const result = value[key];
+    return result === undefined || result === null ? fallback : String(result);
+}
+export function readOptionalNumber(value, key) {
+    const result = value[key];
+    return typeof result === 'number' ? result : undefined;
+}
+export function readOptionalBoolean(value, key) {
+    const result = value[key];
+    return typeof result === 'boolean' ? result : undefined;
+}
+export function readOptionalNumberArray(value) {
+    return Array.isArray(value)
+        ? value.filter((entry) => typeof entry === 'number')
+        : undefined;
+}
+export function readOptionalRecordArray(value) {
+    return Array.isArray(value) ? value.filter(isRecord) : undefined;
+}
+export function readOptionalStringRecord(value) {
+    return isStringRecord(value) ? value : undefined;
+}
+//# sourceMappingURL=typeGuards.mjs.map

package/dist/sandbox/shared/typeGuards.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.mjs","sourceRoot":"","sources":["../../../src/sandbox/shared/typeGuards.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAc;IAEd,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CACjE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAA0C,EAC1C,GAAW;IAEX,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAc;IAEd,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAA8B,EAC9B,GAAW,EACX,WAAmB,EAAE;IAErB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAA8B,EAC9B,GAAW;IAEX,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAA8B,EAC9B,GAAW;IAEX,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QACrE,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAc;IAEd,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAc;IAEd,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC"}

package/dist/sandbox/shared/types.d.ts

@@ -0,0 +1,24 @@
+export type RemoteManifestWriter = {
+    mkdir(path: string): Promise<void>;
+    writeFile(path: string, content: string | Uint8Array): Promise<void>;
+};
+export type RemoteEditorIo = {
+    mkdir?(path: string): Promise<void>;
+    resolvePath?(path: string, options?: RemoteSandboxPathOptions): Promise<string>;
+    pathExists?(path: string): Promise<boolean>;
+    readText(path: string): Promise<string>;
+    writeText(path: string, content: string): Promise<void>;
+    deletePath(path: string): Promise<void>;
+};
+export type RemoteSandboxPathOptions = {
+    forWrite?: boolean;
+};
+export type RemoteSandboxPathResolver = (path: string, options?: RemoteSandboxPathOptions) => Promise<string>;
+export type SandboxManifestMetadataSupport = {
+    users?: boolean;
+    groups?: boolean;
+    entryPermissions?: boolean;
+    entryGroups?: boolean;
+    extraPathGrants?: boolean;
+    mounts?: boolean;
+};

package/dist/sandbox/shared/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/sandbox/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sandbox/shared/types.ts"],"names":[],"mappings":""}

package/dist/sandbox/shared/types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.mjs.map

package/dist/sandbox/shared/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../../src/sandbox/shared/types.ts"],"names":[],"mappings":""}

package/dist/sandbox/vercel/index.d.ts

@@ -0,0 +1 @@
+export * from './sandbox';

package/dist/sandbox/vercel/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./sandbox.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/sandbox/vercel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sandbox/vercel/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA0B"}

package/dist/sandbox/vercel/index.mjs

@@ -0,0 +1,2 @@
+export * from "./sandbox.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/sandbox/vercel/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/sandbox/vercel/index.ts"],"names":[],"mappings":""}

package/dist/sandbox/vercel/sandbox.d.ts

@@ -0,0 +1,135 @@
+import { Manifest, type SandboxClient, type SandboxClientCreateArgs, type SandboxClientOptions, type SandboxConcurrencyLimits, type SandboxSessionSerializationOptions, type SandboxSessionState, type WorkspaceArchiveData } from '@openai/agents-core/sandbox';
+import { RemoteSandboxSessionBase, type RemoteSandboxCommandOptions, type RemoteSandboxCommandResult } from '../shared';
+type VercelSandboxRunCommandParams = Record<string, unknown> & {
+    cmd: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    sudo?: boolean;
+    detached?: boolean;
+};
+type VercelSandboxInstance = {
+    sandboxId: string;
+    runCommand(params: VercelSandboxRunCommandParams): Promise<VercelCommandFinishedLike>;
+    mkDir(path: string): Promise<void>;
+    readFileToBuffer(file: {
+        path: string;
+        cwd?: string;
+    }): Promise<Buffer | Uint8Array | null>;
+    writeFiles(files: {
+        path: string;
+        content: string | Uint8Array;
+        mode?: number;
+    }[]): Promise<void>;
+    domain?(port: number): string;
+    stop?(): Promise<unknown>;
+    snapshot?(params?: {
+        expiration?: number;
+    }): Promise<{
+        snapshotId?: string;
+    }>;
+};
+type VercelCommandFinishedLike = {
+    exitCode: number | null;
+    output(stream?: 'stdout' | 'stderr' | 'both'): Promise<string>;
+};
+export type VercelWorkspacePersistence = 'tar' | 'snapshot';
+export interface VercelSandboxClientOptions extends SandboxClientOptions {
+    projectId?: string;
+    teamId?: string;
+    token?: string;
+    runtime?: string;
+    resources?: Record<string, unknown>;
+    exposedPorts?: number[];
+    interactive?: boolean;
+    networkPolicy?: Record<string, unknown>;
+    timeoutMs?: number;
+    workspacePersistence?: VercelWorkspacePersistence;
+    snapshotExpirationMs?: number;
+    env?: Record<string, string>;
+}
+export interface VercelSandboxSessionState extends SandboxSessionState {
+    sandboxId: string;
+    projectId?: string;
+    teamId?: string;
+    token?: string;
+    runtime?: string;
+    resources?: Record<string, unknown>;
+    configuredExposedPorts?: number[];
+    interactive?: boolean;
+    networkPolicy?: Record<string, unknown>;
+    timeoutMs?: number;
+    workspacePersistence: VercelWorkspacePersistence;
+    snapshotExpirationMs?: number;
+    environment: Record<string, string>;
+    snapshotId?: string;
+    snapshotSandboxId?: string;
+    snapshotSupported?: boolean;
+}
+export declare class VercelSandboxSession extends RemoteSandboxSessionBase<VercelSandboxSessionState> {
+    private sandbox;
+    private readonly knownDirs;
+    private readonly pendingDirCreates;
+    private closePromise?;
+    private closeCompleted;
+    private readonly credentials;
+    constructor(args: {
+        state: VercelSandboxSessionState;
+        sandbox: VercelSandboxInstance;
+        credentials?: Pick<VercelSandboxClientOptions, 'projectId' | 'teamId' | 'token'>;
+        concurrencyLimits?: SandboxConcurrencyLimits;
+    });
+    supportsPty(): boolean;
+    protected assertExecRunAs(runAs?: string): void;
+    protected assertFilesystemRunAs(runAs?: string): void;
+    protected resolveManifestForApply(manifest: Manifest): Manifest;
+    protected beforeFilesystemMutation(): Promise<void>;
+    protected beforeExecCommand(): Promise<void>;
+    protected beforeMaterializeEntry(): Promise<void>;
+    protected beforeApplyManifest(): Promise<void>;
+    protected runningWorkdir(): string;
+    protected exposedPortSource(): string;
+    protected resolveRemoteExposedPort(requestedPort: number): Promise<string>;
+    materializeInitialManifest(manifest: Manifest): Promise<void>;
+    prepareWorkspaceRoot(): Promise<void>;
+    persistWorkspace(): Promise<Uint8Array>;
+    hydrateWorkspace(data: WorkspaceArchiveData): Promise<void>;
+    close(): Promise<void>;
+    private closeOnce;
+    shutdown(): Promise<void>;
+    delete(): Promise<void>;
+    private execShell;
+    private replaceSandboxFromSnapshot;
+    private recoverSandboxAfterSnapshotRestoreFailure;
+    private resolveSnapshotCredentials;
+    private createAndPrepareSandboxFromSnapshot;
+    private createSandboxFromSnapshot;
+    private bindRestoredSandbox;
+    private resetKnownDirs;
+    private markWorkspaceMutated;
+    private clearExposedPortCache;
+    private ensureDir;
+    protected runRemoteCommand(command: string, options: RemoteSandboxCommandOptions): Promise<RemoteSandboxCommandResult>;
+    protected mkdirRemote(path: string): Promise<void>;
+    protected readRemoteText(path: string): Promise<string>;
+    protected readRemoteFile(path: string): Promise<Uint8Array>;
+    protected writeRemoteFile(path: string, content: string | Uint8Array): Promise<void>;
+    protected deleteRemotePath(path: string): Promise<void>;
+}
+/**
+ * @see {@link https://vercel.com/docs/vercel-sandbox | Vercel Sandbox overview}.
+ * @see {@link https://vercel.com/docs/vercel-sandbox/sdk-reference | Sandbox SDK reference}.
+ * @see {@link https://vercel.com/docs/vercel-sandbox/working-with-sandbox | Working with Sandbox examples}.
+ */
+export declare class VercelSandboxClient implements SandboxClient<VercelSandboxClientOptions, VercelSandboxSessionState> {
+    readonly backendId = "vercel";
+    private readonly options;
+    constructor(options?: VercelSandboxClientOptions);
+    create(args?: SandboxClientCreateArgs<VercelSandboxClientOptions> | Manifest, manifestOptions?: VercelSandboxClientOptions): Promise<VercelSandboxSession>;
+    serializeSessionState(state: VercelSandboxSessionState, options?: SandboxSessionSerializationOptions): Promise<Record<string, unknown>>;
+    canPersistOwnedSessionState(state: VercelSandboxSessionState): boolean;
+    canReusePreservedOwnedSession(state: VercelSandboxSessionState): boolean;
+    deserializeSessionState(state: Record<string, unknown>): Promise<VercelSandboxSessionState>;
+    resume(state: VercelSandboxSessionState): Promise<VercelSandboxSession>;
+}
+export {};