@opencoredev/sandbox-sdk 0.1.0 → 0.2.0

package/dist/providers/railway/index.d.mts

@@ -0,0 +1,29 @@
+import "../../types-Bv6I2U1c.mjs";
+import { o as SandboxProvider } from "../../provider-DOBErkBO.mjs";
+import "../../index-Dh9xob2s.mjs";
+import "../../sandbox-DdEqoXJF.mjs";
+import { o as railwayCapabilities } from "../../capabilities-BWvOVFbH.mjs";
+import { Sandbox as RailwaySandbox, SandboxTemplate } from "railway";
+
+//#region src/providers/railway/index.d.ts
+interface RailwayBaseOptions {
+  /** Railway API token. Defaults to RAILWAY_API_TOKEN. */
+  token?: string;
+  /** Railway environment id. Defaults to RAILWAY_ENVIRONMENT_ID. */
+  environmentId?: string;
+  /** Minutes before Railway destroys an idle sandbox. */
+  idleTimeoutMinutes?: number;
+  /** Whether the sandbox can access the environment's private network. */
+  networkIsolation?: "ISOLATED" | "PRIVATE";
+}
+type RailwayOptions = RailwayBaseOptions & ({
+  checkpoint?: string;
+  template?: never;
+} | {
+  checkpoint?: never;
+  template?: SandboxTemplate;
+});
+declare function railway(options?: RailwayOptions): SandboxProvider<RailwaySandbox>;
+//#endregion
+export { RailwayOptions, type RailwaySandbox, type SandboxTemplate as RailwaySandboxTemplate, railway, railwayCapabilities };
+//# sourceMappingURL=index.d.mts.map

package/dist/providers/railway/index.mjs

@@ -0,0 +1,211 @@
+import { t as SandboxError } from "../../errors-BuF9bYOQ.mjs";
+import "../../capabilities-xs9kaHrK.mjs";
+import { o as railwayCapabilities } from "../../capabilities-CaSNd6J1.mjs";
+import { i as unsupported, t as commandString } from "../../provider-utils-CfB9nvJx.mjs";
+import { Sandbox } from "railway";
+
+//#region src/providers/railway/index.ts
+function railway(options = {}) {
+	const credentials = {
+		token: options.token,
+		environmentId: options.environmentId
+	};
+	return {
+		id: "railway",
+		capabilities: railwayCapabilities,
+		async create(createOptions) {
+			assertNotAborted(createOptions.signal);
+			const createConfig = {
+				...credentials,
+				idleTimeoutMinutes: options.idleTimeoutMinutes,
+				networkIsolation: options.networkIsolation,
+				env: { ...createOptions.env }
+			};
+			const raw = await awaitCreation(options.checkpoint ? Sandbox.create(options.checkpoint, createConfig) : options.template ? Sandbox.create(options.template, createConfig) : Sandbox.create(createConfig), createOptions.signal, createOptions.timeout);
+			try {
+				await raw.files.mkdir(createOptions.cwd);
+			} catch (error) {
+				await raw.destroy().catch(() => void 0);
+				throw error;
+			}
+			return {
+				id: raw.id,
+				raw,
+				capabilities: railwayCapabilities,
+				files: {
+					async write(path, value) {
+						await raw.files.write(path, value);
+					},
+					read: (path) => raw.files.read(path, { format: "bytes" }),
+					async list(path) {
+						return (await raw.files.list(path)).map((entry) => ({
+							name: entry.name,
+							path: `${path.replace(/\/$/, "")}/${entry.name}`,
+							type: entry.isDir ? "directory" : "file",
+							size: entry.isDir ? void 0 : entry.size
+						}));
+					},
+					mkdir: (path) => raw.files.mkdir(path),
+					async remove(path) {
+						const result = await raw.exec(commandString({
+							command: "rm",
+							args: [
+								"-rf",
+								"--",
+								path
+							]
+						}));
+						if (result.exitCode !== 0) throw new Error(`files.remove failed: ${result.stderr || result.stdout}`);
+					},
+					exists: (path) => raw.files.exists(path)
+				},
+				async run(command, runOptions) {
+					assertNotAborted(runOptions.signal);
+					const started = performance.now();
+					const handle = raw.exec(commandString(command), {
+						cwd: runOptions.cwd,
+						env: { ...runOptions.env },
+						timeoutSec: timeoutSeconds(runOptions.timeout)
+					});
+					const removeAbort = bindAbort(handle, runOptions.signal);
+					try {
+						const result = await handle;
+						if (result.timedOut) throw new SandboxError({
+							code: "timeout",
+							provider: "railway",
+							operation: "process.run",
+							message: `Command timed out after ${runOptions.timeout}ms`
+						});
+						return {
+							stdout: result.stdout,
+							stderr: result.stderr,
+							exitCode: result.exitCode ?? -1,
+							success: result.exitCode === 0,
+							signal: result.exitCode === null ? "unknown" : void 0,
+							durationMs: Math.round(performance.now() - started)
+						};
+					} finally {
+						removeAbort();
+					}
+				},
+				async start(command, runOptions) {
+					assertNotAborted(runOptions.signal);
+					const events = [];
+					const waiters = /* @__PURE__ */ new Set();
+					let state = "running";
+					const wake = () => {
+						for (const waiter of waiters) waiter();
+						waiters.clear();
+					};
+					const push = (stream, data) => {
+						events.push({
+							stream,
+							data,
+							timestamp: /* @__PURE__ */ new Date()
+						});
+						wake();
+					};
+					const handle = raw.exec(commandString(command), {
+						cwd: runOptions.cwd,
+						env: { ...runOptions.env },
+						timeoutSec: timeoutSeconds(runOptions.timeout),
+						onStdout: (chunk) => push("stdout", chunk),
+						onStderr: (chunk) => push("stderr", chunk)
+					});
+					const removeAbort = bindAbort(handle, runOptions.signal);
+					const completed = handle.then((result) => ({ exitCode: result.exitCode ?? -1 })).finally(() => {
+						if (state === "running") state = "exited";
+						removeAbort();
+						wake();
+					});
+					return {
+						id: await handle.sessionName,
+						async status() {
+							return state;
+						},
+						async *output() {
+							let index = 0;
+							while (state === "running" || index < events.length) {
+								while (index < events.length) yield events[index++];
+								if (state !== "running") break;
+								await new Promise((resolve) => waiters.add(resolve));
+							}
+						},
+						async write() {
+							unsupported("railway", "process.stdin");
+						},
+						wait: () => completed,
+						async kill(signal = "SIGTERM") {
+							const nativeSignal = signal.replace(/^SIG/, "");
+							await handle.kill(nativeSignal);
+							state = "killed";
+							wake();
+						}
+					};
+				},
+				async expose() {
+					unsupported("railway", "ports.expose");
+				},
+				snapshots: {
+					async create(snapshotOptions) {
+						const checkpoint = await raw.checkpoint(snapshotOptions?.name ?? `sandbox-sdk-${Date.now()}`);
+						return {
+							id: checkpoint.id,
+							name: checkpoint.key,
+							mode: "filesystem",
+							createdAt: new Date(checkpoint.createdAt)
+						};
+					},
+					async delete(snapshot) {
+						await Sandbox.deleteCheckpoint(typeof snapshot === "string" ? snapshot : snapshot.id, credentials);
+					},
+					async restore() {
+						unsupported("railway", "snapshot.restore");
+					}
+				},
+				async stop() {
+					await raw.destroy();
+				}
+			};
+		}
+	};
+}
+function timeoutSeconds(timeout) {
+	return timeout === void 0 ? void 0 : Math.max(1, Math.ceil(timeout / 1e3));
+}
+function bindAbort(handle, signal) {
+	if (!signal) return () => void 0;
+	const abort = () => void handle.kill("TERM").catch(() => void 0);
+	signal.addEventListener("abort", abort, { once: true });
+	return () => signal.removeEventListener("abort", abort);
+}
+async function awaitCreation(promise, signal, timeoutMs) {
+	if (!signal && timeoutMs === void 0) return promise;
+	return new Promise((resolve, reject) => {
+		let settled = false;
+		const finish = (callback) => {
+			if (settled) return;
+			settled = true;
+			signal?.removeEventListener("abort", onAbort);
+			if (timer) clearTimeout(timer);
+			callback();
+		};
+		const onAbort = () => finish(() => reject(signal?.reason ?? new DOMException("Aborted", "AbortError")));
+		const timer = timeoutMs ? setTimeout(() => finish(() => reject(/* @__PURE__ */ new Error(`Sandbox creation timed out after ${timeoutMs}ms`))), timeoutMs) : void 0;
+		signal?.addEventListener("abort", onAbort, { once: true });
+		promise.then((sandbox) => {
+			if (settled) {
+				sandbox.destroy().catch(() => void 0);
+				return;
+			}
+			finish(() => resolve(sandbox));
+		}, (error) => finish(() => reject(error)));
+	});
+}
+function assertNotAborted(signal) {
+	if (signal?.aborted) throw signal.reason ?? new DOMException("Aborted", "AbortError");
+}
+
+//#endregion
+export { railway, railwayCapabilities };
+//# sourceMappingURL=index.mjs.map

package/dist/providers/railway/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["RailwaySandbox","events: ProcessOutputEvent[]","state: \"running\" | \"exited\" | \"killed\""],"sources":["../../../src/providers/railway/index.ts"],"sourcesContent":["import {\n  Sandbox as RailwaySandbox,\n  type ExecHandle,\n  type ExecSignal,\n  type SandboxTemplate,\n} from \"railway\";\nimport { SandboxError } from \"../../core/errors\";\nimport type { SandboxProvider } from \"../../core/provider\";\nimport type { ProcessOutputEvent, SandboxProcess, SandboxSnapshot } from \"../../core/types\";\nimport { commandString, unsupported } from \"../../internal/provider-utils\";\nimport { railwayCapabilities } from \"../capabilities\";\n\ninterface RailwayBaseOptions {\n  /** Railway API token. Defaults to RAILWAY_API_TOKEN. */\n  token?: string;\n  /** Railway environment id. Defaults to RAILWAY_ENVIRONMENT_ID. */\n  environmentId?: string;\n  /** Minutes before Railway destroys an idle sandbox. */\n  idleTimeoutMinutes?: number;\n  /** Whether the sandbox can access the environment's private network. */\n  networkIsolation?: \"ISOLATED\" | \"PRIVATE\";\n}\n\nexport type RailwayOptions = RailwayBaseOptions &\n  ({ checkpoint?: string; template?: never } | { checkpoint?: never; template?: SandboxTemplate });\n\nexport { railwayCapabilities } from \"../capabilities\";\n\nexport function railway(options: RailwayOptions = {}): SandboxProvider<RailwaySandbox> {\n  const credentials = {\n    token: options.token,\n    environmentId: options.environmentId,\n  };\n\n  return {\n    id: \"railway\",\n    capabilities: railwayCapabilities,\n    async create(createOptions) {\n      assertNotAborted(createOptions.signal);\n      const createConfig = {\n        ...credentials,\n        idleTimeoutMinutes: options.idleTimeoutMinutes,\n        networkIsolation: options.networkIsolation,\n        env: { ...createOptions.env },\n      };\n      const pending = options.checkpoint\n        ? RailwaySandbox.create(options.checkpoint, createConfig)\n        : options.template\n          ? RailwaySandbox.create(options.template, createConfig)\n          : RailwaySandbox.create(createConfig);\n      const raw = await awaitCreation(pending, createOptions.signal, createOptions.timeout);\n      try {\n        await raw.files.mkdir(createOptions.cwd);\n      } catch (error) {\n        await raw.destroy().catch(() => undefined);\n        throw error;\n      }\n\n      return {\n        id: raw.id,\n        raw,\n        capabilities: railwayCapabilities,\n        files: {\n          async write(path, value) {\n            await raw.files.write(path, value);\n          },\n          read: (path) => raw.files.read(path, { format: \"bytes\" }),\n          async list(path) {\n            return (await raw.files.list(path)).map((entry) => ({\n              name: entry.name,\n              path: `${path.replace(/\\/$/, \"\")}/${entry.name}`,\n              type: entry.isDir ? (\"directory\" as const) : (\"file\" as const),\n              size: entry.isDir ? undefined : entry.size,\n            }));\n          },\n          mkdir: (path) => raw.files.mkdir(path),\n          async remove(path) {\n            const result = await raw.exec(\n              commandString({ command: \"rm\", args: [\"-rf\", \"--\", path] }),\n            );\n            if (result.exitCode !== 0) {\n              throw new Error(`files.remove failed: ${result.stderr || result.stdout}`);\n            }\n          },\n          exists: (path) => raw.files.exists(path),\n        },\n        async run(command, runOptions) {\n          assertNotAborted(runOptions.signal);\n          const started = performance.now();\n          const handle = raw.exec(commandString(command), {\n            cwd: runOptions.cwd,\n            env: { ...runOptions.env },\n            timeoutSec: timeoutSeconds(runOptions.timeout),\n          });\n          const removeAbort = bindAbort(handle, runOptions.signal);\n          try {\n            const result = await handle;\n            if (result.timedOut) {\n              throw new SandboxError({\n                code: \"timeout\",\n                provider: \"railway\",\n                operation: \"process.run\",\n                message: `Command timed out after ${runOptions.timeout}ms`,\n              });\n            }\n            return {\n              stdout: result.stdout,\n              stderr: result.stderr,\n              exitCode: result.exitCode ?? -1,\n              success: result.exitCode === 0,\n              signal: result.exitCode === null ? \"unknown\" : undefined,\n              durationMs: Math.round(performance.now() - started),\n            };\n          } finally {\n            removeAbort();\n          }\n        },\n        async start(command, runOptions) {\n          assertNotAborted(runOptions.signal);\n          const events: ProcessOutputEvent[] = [];\n          const waiters = new Set<() => void>();\n          let state: \"running\" | \"exited\" | \"killed\" = \"running\";\n          const wake = () => {\n            for (const waiter of waiters) waiter();\n            waiters.clear();\n          };\n          const push = (stream: \"stdout\" | \"stderr\", data: string) => {\n            events.push({ stream, data, timestamp: new Date() });\n            wake();\n          };\n          const handle = raw.exec(commandString(command), {\n            cwd: runOptions.cwd,\n            env: { ...runOptions.env },\n            timeoutSec: timeoutSeconds(runOptions.timeout),\n            onStdout: (chunk) => push(\"stdout\", chunk),\n            onStderr: (chunk) => push(\"stderr\", chunk),\n          });\n          const removeAbort = bindAbort(handle, runOptions.signal);\n          const completed = handle\n            .then((result) => ({ exitCode: result.exitCode ?? -1 }))\n            .finally(() => {\n              if (state === \"running\") state = \"exited\";\n              removeAbort();\n              wake();\n            });\n          const id = await handle.sessionName;\n\n          return {\n            id,\n            async status() {\n              return state;\n            },\n            async *output() {\n              let index = 0;\n              while (state === \"running\" || index < events.length) {\n                while (index < events.length) yield events[index++]!;\n                if (state !== \"running\") break;\n                await new Promise<void>((resolve) => waiters.add(resolve));\n              }\n            },\n            async write() {\n              unsupported(\"railway\", \"process.stdin\");\n            },\n            wait: () => completed,\n            async kill(signal = \"SIGTERM\") {\n              const nativeSignal = signal.replace(/^SIG/, \"\") as ExecSignal;\n              await handle.kill(nativeSignal);\n              state = \"killed\";\n              wake();\n            },\n          } satisfies SandboxProcess;\n        },\n        async expose() {\n          unsupported(\"railway\", \"ports.expose\");\n        },\n        snapshots: {\n          async create(snapshotOptions) {\n            const checkpoint = await raw.checkpoint(\n              snapshotOptions?.name ?? `sandbox-sdk-${Date.now()}`,\n            );\n            return {\n              id: checkpoint.id,\n              name: checkpoint.key,\n              mode: \"filesystem\",\n              createdAt: new Date(checkpoint.createdAt),\n            } satisfies SandboxSnapshot;\n          },\n          async delete(snapshot) {\n            await RailwaySandbox.deleteCheckpoint(\n              typeof snapshot === \"string\" ? snapshot : snapshot.id,\n              credentials,\n            );\n          },\n          async restore() {\n            unsupported(\"railway\", \"snapshot.restore\");\n          },\n        },\n        async stop() {\n          await raw.destroy();\n        },\n      };\n    },\n  };\n}\n\nfunction timeoutSeconds(timeout?: number): number | undefined {\n  return timeout === undefined ? undefined : Math.max(1, Math.ceil(timeout / 1_000));\n}\n\nfunction bindAbort(handle: ExecHandle, signal?: AbortSignal): () => void {\n  if (!signal) return () => undefined;\n  const abort = () => void handle.kill(\"TERM\").catch(() => undefined);\n  signal.addEventListener(\"abort\", abort, { once: true });\n  return () => signal.removeEventListener(\"abort\", abort);\n}\n\nasync function awaitCreation(\n  promise: Promise<RailwaySandbox>,\n  signal?: AbortSignal,\n  timeoutMs?: number,\n): Promise<RailwaySandbox> {\n  if (!signal && timeoutMs === undefined) return promise;\n  return new Promise<RailwaySandbox>((resolve, reject) => {\n    let settled = false;\n    const finish = (callback: () => void) => {\n      if (settled) return;\n      settled = true;\n      signal?.removeEventListener(\"abort\", onAbort);\n      if (timer) clearTimeout(timer);\n      callback();\n    };\n    const onAbort = () =>\n      finish(() => reject(signal?.reason ?? new DOMException(\"Aborted\", \"AbortError\")));\n    const timer = timeoutMs\n      ? setTimeout(\n          () => finish(() => reject(new Error(`Sandbox creation timed out after ${timeoutMs}ms`))),\n          timeoutMs,\n        )\n      : undefined;\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n    promise.then(\n      (sandbox) => {\n        if (settled) {\n          void sandbox.destroy().catch(() => undefined);\n          return;\n        }\n        finish(() => resolve(sandbox));\n      },\n      (error) => finish(() => reject(error)),\n    );\n  });\n}\n\nfunction assertNotAborted(signal?: AbortSignal): void {\n  if (signal?.aborted) throw signal.reason ?? new DOMException(\"Aborted\", \"AbortError\");\n}\n\nexport type { RailwaySandbox, SandboxTemplate as RailwaySandboxTemplate };\n"],"mappings":"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"}

package/dist/providers/upstash/index.d.mts

@@ -1,8 +1,8 @@
-import "../../types-BTagTtsp.mjs";
-import { o as SandboxProvider } from "../../provider-_caCV8kk.mjs";
-import "../../index-BMFkO6Fv.mjs";
-import "../../sandbox-BUYT-1C9.mjs";
-import { a as upstashCapabilities } from "../../capabilities-CMnszzpt.mjs";
+import "../../types-Bv6I2U1c.mjs";
+import { o as SandboxProvider } from "../../provider-DOBErkBO.mjs";
+import "../../index-Dh9xob2s.mjs";
+import "../../sandbox-DdEqoXJF.mjs";
+import { s as upstashCapabilities } from "../../capabilities-BWvOVFbH.mjs";
 import { Box, BoxConfig } from "@upstash/box";
 
 //#region src/providers/upstash/index.d.ts

package/dist/providers/upstash/index.mjs

@@ -1,8 +1,9 @@
-import { t as SandboxError } from "../../errors-Ch9PHKTd.mjs";
-import "../../capabilities-COKpwoFH.mjs";
-import "../../sandbox-BwyHcB_C.mjs";
-import { a as upstashCapabilities } from "../../capabilities-CEowrzRM.mjs";
-import { i as unsupported, n as portResult, o as withManagedSessions, r as toUint8Array, t as commandString } from "../../provider-utils-DilOYLBO.mjs";
+import { t as SandboxError } from "../../errors-BuF9bYOQ.mjs";
+import "../../capabilities-xs9kaHrK.mjs";
+import "../../sandbox-DgtY5hvt.mjs";
+import { s as upstashCapabilities } from "../../capabilities-CaSNd6J1.mjs";
+import { t as withManagedSessions } from "../../managed-provider-BsZGVQ4I.mjs";
+import { i as unsupported, n as portResult, r as toUint8Array, t as commandString } from "../../provider-utils-CfB9nvJx.mjs";
 import { Box } from "@upstash/box";
 
 //#region src/providers/upstash/index.ts

package/dist/providers/upstash/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["events: ProcessOutputEvent[]","status: \"running\" | \"exited\""],"sources":["../../../src/providers/upstash/index.ts"],"sourcesContent":["import { Box, type BoxConfig, type ExecStreamChunk } from \"@upstash/box\";\nimport { SandboxError } from \"../../core/errors\";\nimport type { SandboxNetworkPolicy, SandboxProvider } from \"../../core/provider\";\nimport type {\n  CommandInput,\n  ProcessOutputEvent,\n  RunOptions,\n  SandboxProcess,\n  SandboxSnapshot,\n} from \"../../core/types\";\nimport { withManagedSessions } from \"../../internal/managed-provider\";\nimport {\n  commandString,\n  portResult,\n  toUint8Array,\n  unsupported,\n} from \"../../internal/provider-utils\";\nimport { upstashCapabilities } from \"../capabilities\";\n\nexport type UpstashOptions = Omit<BoxConfig, \"env\"> & {\n  /** Expose ports publicly. Set to false to return bearer-token URLs. */\n  public?: boolean;\n};\n\nexport { upstashCapabilities } from \"../capabilities\";\n\nexport function upstash(options: UpstashOptions = {}): SandboxProvider<Box> {\n  const { public: publicPorts = true, ...boxOptions } = options;\n\n  return withManagedSessions(\n    {\n      id: \"upstash\",\n      capabilities: upstashCapabilities,\n      async create(createOptions) {\n        assertNotAborted(createOptions.signal);\n        const raw = await Box.create({\n          ...boxOptions,\n          env: { ...createOptions.env },\n          timeout: boxOptions.timeout ?? createOptions.timeout,\n        });\n        const remoteCwd = raw.cwd;\n        const toRemotePath = (path: string) =>\n          replacePathPrefix(path, createOptions.cwd, remoteCwd);\n        const toVirtualPath = (path: string) =>\n          replacePathPrefix(path, remoteCwd, createOptions.cwd);\n\n        return {\n          id: raw.id,\n          raw,\n          capabilities: upstashCapabilities,\n          files: {\n            async write(path, value) {\n              const content = Buffer.from(await toUint8Array(value)).toString(\"base64\");\n              await raw.files.write({\n                path: toRemotePath(path),\n                content,\n                encoding: \"base64\",\n              });\n            },\n            async read(path) {\n              const content = await raw.files.read(toRemotePath(path), {\n                encoding: \"base64\",\n              });\n              return new Uint8Array(Buffer.from(content, \"base64\"));\n            },\n            async list(path) {\n              return (await raw.files.list(toRemotePath(path))).map((entry) => ({\n                name: entry.name,\n                path: toVirtualPath(entry.path),\n                type: entry.is_dir ? (\"directory\" as const) : (\"file\" as const),\n                size: entry.size,\n              }));\n            },\n            async mkdir(path) {\n              const result = await raw.exec.command(`mkdir -p ${shellQuote(toRemotePath(path))}`);\n              assertCommandSucceeded(result.exitCode, result.result, \"files.mkdir\");\n            },\n            async remove(path) {\n              const result = await raw.exec.command(`rm -rf -- ${shellQuote(toRemotePath(path))}`);\n              assertCommandSucceeded(result.exitCode, result.result, \"files.remove\");\n            },\n            async exists(path) {\n              const result = await raw.exec.command(`test -e ${shellQuote(toRemotePath(path))}`);\n              return result.exitCode === 0;\n            },\n          },\n          async run(command, runOptions) {\n            assertNotAborted(runOptions.signal);\n            const started = performance.now();\n            const run = await raw.exec.command(\n              scopedCommand(command, runOptions, createOptions.cwd, remoteCwd),\n            );\n            if (runOptions.timeout !== undefined && run.exitCode === 124) {\n              throw new SandboxError({\n                code: \"timeout\",\n                provider: \"upstash\",\n                operation: \"process.run\",\n                message: `Command timed out after ${runOptions.timeout}ms`,\n              });\n            }\n            return {\n              stdout: run.result,\n              stderr: \"\",\n              exitCode: run.exitCode ?? 1,\n              success: run.exitCode === 0,\n              durationMs: Math.round(performance.now() - started),\n            };\n          },\n          async start(command, runOptions) {\n            assertNotAborted(runOptions.signal);\n            const handle = await raw.exec.stream(\n              scopedCommand(command, runOptions, createOptions.cwd, remoteCwd),\n            );\n            const events: ProcessOutputEvent[] = [];\n            const waiters = new Set<() => void>();\n            let status: \"running\" | \"exited\" = \"running\";\n            let exitCode = 1;\n            const wake = () => {\n              for (const waiter of waiters) waiter();\n              waiters.clear();\n            };\n            const streamCompleted = consumeStream(handle, (chunk) => {\n              if (chunk.type === \"output\") {\n                events.push({\n                  stream: \"stdout\",\n                  data: chunk.data,\n                  timestamp: new Date(),\n                });\n                wake();\n              } else {\n                exitCode = chunk.exitCode;\n              }\n            })\n              .then(() => {\n                if (status === \"running\") status = \"exited\";\n                return { exitCode };\n              })\n              .catch((error: unknown) => {\n                status = \"exited\";\n                throw error;\n              })\n              .finally(() => {\n                wake();\n              });\n\n            return {\n              id: handle.id,\n              async status() {\n                return status;\n              },\n              async *output() {\n                let index = 0;\n                while (status === \"running\" || index < events.length) {\n                  while (index < events.length) yield events[index++]!;\n                  if (status !== \"running\") break;\n                  await new Promise<void>((resolve) => waiters.add(resolve));\n                }\n              },\n              async write() {\n                unsupported(\"upstash\", \"process.stdin\");\n              },\n              wait: () => streamCompleted,\n              async kill() {\n                unsupported(\"upstash\", \"process.cancel\");\n              },\n            } satisfies SandboxProcess;\n          },\n          async expose(port) {\n            const preview = await raw.getPublicURL(\n              port,\n              publicPorts ? undefined : { bearerToken: true },\n            );\n            const token = preview.token;\n            return portResult(\n              port,\n              preview.url,\n              !token,\n              Boolean(token),\n              token\n                ? (path = \"/\", init = {}) =>\n                    fetch(new URL(path, preview.url), {\n                      ...init,\n                      headers: {\n                        ...Object.fromEntries(new Headers(init.headers)),\n                        authorization: `Bearer ${token}`,\n                      },\n                    })\n                : undefined,\n            );\n          },\n          snapshots: {\n            async create(snapshotOptions) {\n              const snapshot = await raw.snapshot({\n                name: snapshotOptions?.name ?? `sandbox-sdk-${Date.now()}`,\n              });\n              return {\n                id: snapshot.id,\n                name: snapshot.name,\n                mode: \"filesystem\",\n                createdAt: timestamp(snapshot.created_at),\n              } satisfies SandboxSnapshot;\n            },\n            async delete(snapshot) {\n              await raw.deleteSnapshot(typeof snapshot === \"string\" ? snapshot : snapshot.id);\n            },\n            async restore() {\n              unsupported(\"upstash\", \"snapshot.restore\");\n            },\n          },\n          async stop() {\n            await raw.delete();\n          },\n        };\n      },\n    },\n    [],\n    {\n      stop: (sandbox) => sandbox.raw.pause(),\n      resume: (sandbox) => sandbox.raw.resume(),\n      destroy: (sandbox) => sandbox.raw.delete(),\n      setNetworkPolicy: (sandbox, policy) => sandbox.raw.updateNetworkPolicy(networkPolicy(policy)),\n    },\n  );\n}\n\nasync function consumeStream(\n  stream: AsyncIterable<ExecStreamChunk>,\n  onChunk: (chunk: ExecStreamChunk) => void,\n): Promise<void> {\n  for await (const chunk of stream) onChunk(chunk);\n}\n\nfunction scopedCommand(\n  input: CommandInput,\n  options: RunOptions,\n  virtualCwd: string,\n  remoteCwd: string,\n): string {\n  const environment = Object.entries(options.env ?? {}).map(([key, value]) =>\n    shellQuote(`${key}=${value}`),\n  );\n  const command = commandString(input);\n  const shell = `sh -c ${shellQuote(command)}`;\n  const timed = options.timeout\n    ? `timeout ${Math.max(1, Math.ceil(options.timeout / 1_000))}s ${shell}`\n    : shell;\n  const cwd = replacePathPrefix(options.cwd ?? virtualCwd, virtualCwd, remoteCwd);\n  return `cd ${shellQuote(cwd)} && ${\n    environment.length ? `env ${environment.join(\" \")} ` : \"\"\n  }${timed} 2>&1`;\n}\n\nfunction replacePathPrefix(path: string, from: string, to: string): string {\n  if (path === from) return to;\n  if (path.startsWith(`${from}/`)) return `${to}${path.slice(from.length)}`;\n  return path;\n}\n\nfunction shellQuote(value: string): string {\n  return `'${value.replaceAll(\"'\", `'\"'\"'`)}'`;\n}\n\nfunction assertNotAborted(signal?: AbortSignal): void {\n  if (signal?.aborted) throw signal.reason ?? new DOMException(\"Aborted\", \"AbortError\");\n}\n\nfunction assertCommandSucceeded(exitCode: number | null, output: string, operation: string): void {\n  if (exitCode === 0) return;\n  throw new Error(`${operation} failed${output ? `: ${output}` : \"\"}`);\n}\n\nfunction timestamp(value: number): Date {\n  return new Date(value < 1_000_000_000_000 ? value * 1_000 : value);\n}\n\nfunction networkPolicy(policy: SandboxNetworkPolicy): import(\"@upstash/box\").NetworkPolicy {\n  if (policy.mode === \"allow-all\" || policy.mode === \"deny-all\") return { mode: policy.mode };\n  if (policy.mode === \"native\") return policy.value as import(\"@upstash/box\").NetworkPolicy;\n  return {\n    mode: \"custom\",\n    allowedDomains: [...(policy.allowedHosts ?? [])],\n    allowedCidrs: [...(policy.allowedCIDRs ?? [])],\n    deniedCidrs: [...(policy.deniedCIDRs ?? [])],\n  };\n}\n\nexport type UpstashBox = Box;\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["events: ProcessOutputEvent[]","status: \"running\" | \"exited\""],"sources":["../../../src/providers/upstash/index.ts"],"sourcesContent":["import { Box, type BoxConfig, type ExecStreamChunk } from \"@upstash/box\";\nimport { SandboxError } from \"../../core/errors\";\nimport type { SandboxNetworkPolicy, SandboxProvider } from \"../../core/provider\";\nimport type {\n  CommandInput,\n  ProcessOutputEvent,\n  RunOptions,\n  SandboxProcess,\n  SandboxSnapshot,\n} from \"../../core/types\";\nimport { withManagedSessions } from \"../../internal/managed-provider\";\nimport {\n  commandString,\n  portResult,\n  toUint8Array,\n  unsupported,\n} from \"../../internal/provider-utils\";\nimport { upstashCapabilities } from \"../capabilities\";\n\nexport type UpstashOptions = Omit<BoxConfig, \"env\"> & {\n  /** Expose ports publicly. Set to false to return bearer-token URLs. */\n  public?: boolean;\n};\n\nexport { upstashCapabilities } from \"../capabilities\";\n\nexport function upstash(options: UpstashOptions = {}): SandboxProvider<Box> {\n  const { public: publicPorts = true, ...boxOptions } = options;\n\n  return withManagedSessions(\n    {\n      id: \"upstash\",\n      capabilities: upstashCapabilities,\n      async create(createOptions) {\n        assertNotAborted(createOptions.signal);\n        const raw = await Box.create({\n          ...boxOptions,\n          env: { ...createOptions.env },\n          timeout: boxOptions.timeout ?? createOptions.timeout,\n        });\n        const remoteCwd = raw.cwd;\n        const toRemotePath = (path: string) =>\n          replacePathPrefix(path, createOptions.cwd, remoteCwd);\n        const toVirtualPath = (path: string) =>\n          replacePathPrefix(path, remoteCwd, createOptions.cwd);\n\n        return {\n          id: raw.id,\n          raw,\n          capabilities: upstashCapabilities,\n          files: {\n            async write(path, value) {\n              const content = Buffer.from(await toUint8Array(value)).toString(\"base64\");\n              await raw.files.write({\n                path: toRemotePath(path),\n                content,\n                encoding: \"base64\",\n              });\n            },\n            async read(path) {\n              const content = await raw.files.read(toRemotePath(path), {\n                encoding: \"base64\",\n              });\n              return new Uint8Array(Buffer.from(content, \"base64\"));\n            },\n            async list(path) {\n              return (await raw.files.list(toRemotePath(path))).map((entry) => ({\n                name: entry.name,\n                path: toVirtualPath(entry.path),\n                type: entry.is_dir ? (\"directory\" as const) : (\"file\" as const),\n                size: entry.size,\n              }));\n            },\n            async mkdir(path) {\n              const result = await raw.exec.command(`mkdir -p ${shellQuote(toRemotePath(path))}`);\n              assertCommandSucceeded(result.exitCode, result.result, \"files.mkdir\");\n            },\n            async remove(path) {\n              const result = await raw.exec.command(`rm -rf -- ${shellQuote(toRemotePath(path))}`);\n              assertCommandSucceeded(result.exitCode, result.result, \"files.remove\");\n            },\n            async exists(path) {\n              const result = await raw.exec.command(`test -e ${shellQuote(toRemotePath(path))}`);\n              return result.exitCode === 0;\n            },\n          },\n          async run(command, runOptions) {\n            assertNotAborted(runOptions.signal);\n            const started = performance.now();\n            const run = await raw.exec.command(\n              scopedCommand(command, runOptions, createOptions.cwd, remoteCwd),\n            );\n            if (runOptions.timeout !== undefined && run.exitCode === 124) {\n              throw new SandboxError({\n                code: \"timeout\",\n                provider: \"upstash\",\n                operation: \"process.run\",\n                message: `Command timed out after ${runOptions.timeout}ms`,\n              });\n            }\n            return {\n              stdout: run.result,\n              stderr: \"\",\n              exitCode: run.exitCode ?? 1,\n              success: run.exitCode === 0,\n              durationMs: Math.round(performance.now() - started),\n            };\n          },\n          async start(command, runOptions) {\n            assertNotAborted(runOptions.signal);\n            const handle = await raw.exec.stream(\n              scopedCommand(command, runOptions, createOptions.cwd, remoteCwd),\n            );\n            const events: ProcessOutputEvent[] = [];\n            const waiters = new Set<() => void>();\n            let status: \"running\" | \"exited\" = \"running\";\n            let exitCode = 1;\n            const wake = () => {\n              for (const waiter of waiters) waiter();\n              waiters.clear();\n            };\n            const streamCompleted = consumeStream(handle, (chunk) => {\n              if (chunk.type === \"output\") {\n                events.push({\n                  stream: \"stdout\",\n                  data: chunk.data,\n                  timestamp: new Date(),\n                });\n                wake();\n              } else {\n                exitCode = chunk.exitCode;\n              }\n            })\n              .then(() => {\n                if (status === \"running\") status = \"exited\";\n                return { exitCode };\n              })\n              .catch((error: unknown) => {\n                status = \"exited\";\n                throw error;\n              })\n              .finally(() => {\n                wake();\n              });\n\n            return {\n              id: handle.id,\n              async status() {\n                return status;\n              },\n              async *output() {\n                let index = 0;\n                while (status === \"running\" || index < events.length) {\n                  while (index < events.length) yield events[index++]!;\n                  if (status !== \"running\") break;\n                  await new Promise<void>((resolve) => waiters.add(resolve));\n                }\n              },\n              async write() {\n                unsupported(\"upstash\", \"process.stdin\");\n              },\n              wait: () => streamCompleted,\n              async kill() {\n                unsupported(\"upstash\", \"process.cancel\");\n              },\n            } satisfies SandboxProcess;\n          },\n          async expose(port) {\n            const preview = await raw.getPublicURL(\n              port,\n              publicPorts ? undefined : { bearerToken: true },\n            );\n            const token = preview.token;\n            return portResult(\n              port,\n              preview.url,\n              !token,\n              Boolean(token),\n              token\n                ? (path = \"/\", init = {}) =>\n                    fetch(new URL(path, preview.url), {\n                      ...init,\n                      headers: {\n                        ...Object.fromEntries(new Headers(init.headers)),\n                        authorization: `Bearer ${token}`,\n                      },\n                    })\n                : undefined,\n            );\n          },\n          snapshots: {\n            async create(snapshotOptions) {\n              const snapshot = await raw.snapshot({\n                name: snapshotOptions?.name ?? `sandbox-sdk-${Date.now()}`,\n              });\n              return {\n                id: snapshot.id,\n                name: snapshot.name,\n                mode: \"filesystem\",\n                createdAt: timestamp(snapshot.created_at),\n              } satisfies SandboxSnapshot;\n            },\n            async delete(snapshot) {\n              await raw.deleteSnapshot(typeof snapshot === \"string\" ? snapshot : snapshot.id);\n            },\n            async restore() {\n              unsupported(\"upstash\", \"snapshot.restore\");\n            },\n          },\n          async stop() {\n            await raw.delete();\n          },\n        };\n      },\n    },\n    [],\n    {\n      stop: (sandbox) => sandbox.raw.pause(),\n      resume: (sandbox) => sandbox.raw.resume(),\n      destroy: (sandbox) => sandbox.raw.delete(),\n      setNetworkPolicy: (sandbox, policy) => sandbox.raw.updateNetworkPolicy(networkPolicy(policy)),\n    },\n  );\n}\n\nasync function consumeStream(\n  stream: AsyncIterable<ExecStreamChunk>,\n  onChunk: (chunk: ExecStreamChunk) => void,\n): Promise<void> {\n  for await (const chunk of stream) onChunk(chunk);\n}\n\nfunction scopedCommand(\n  input: CommandInput,\n  options: RunOptions,\n  virtualCwd: string,\n  remoteCwd: string,\n): string {\n  const environment = Object.entries(options.env ?? {}).map(([key, value]) =>\n    shellQuote(`${key}=${value}`),\n  );\n  const command = commandString(input);\n  const shell = `sh -c ${shellQuote(command)}`;\n  const timed = options.timeout\n    ? `timeout ${Math.max(1, Math.ceil(options.timeout / 1_000))}s ${shell}`\n    : shell;\n  const cwd = replacePathPrefix(options.cwd ?? virtualCwd, virtualCwd, remoteCwd);\n  return `cd ${shellQuote(cwd)} && ${\n    environment.length ? `env ${environment.join(\" \")} ` : \"\"\n  }${timed} 2>&1`;\n}\n\nfunction replacePathPrefix(path: string, from: string, to: string): string {\n  if (path === from) return to;\n  if (path.startsWith(`${from}/`)) return `${to}${path.slice(from.length)}`;\n  return path;\n}\n\nfunction shellQuote(value: string): string {\n  return `'${value.replaceAll(\"'\", `'\"'\"'`)}'`;\n}\n\nfunction assertNotAborted(signal?: AbortSignal): void {\n  if (signal?.aborted) throw signal.reason ?? new DOMException(\"Aborted\", \"AbortError\");\n}\n\nfunction assertCommandSucceeded(exitCode: number | null, output: string, operation: string): void {\n  if (exitCode === 0) return;\n  throw new Error(`${operation} failed${output ? `: ${output}` : \"\"}`);\n}\n\nfunction timestamp(value: number): Date {\n  return new Date(value < 1_000_000_000_000 ? value * 1_000 : value);\n}\n\nfunction networkPolicy(policy: SandboxNetworkPolicy): import(\"@upstash/box\").NetworkPolicy {\n  if (policy.mode === \"allow-all\" || policy.mode === \"deny-all\") return { mode: policy.mode };\n  if (policy.mode === \"native\") return policy.value as import(\"@upstash/box\").NetworkPolicy;\n  return {\n    mode: \"custom\",\n    allowedDomains: [...(policy.allowedHosts ?? [])],\n    allowedCidrs: [...(policy.allowedCIDRs ?? [])],\n    deniedCidrs: [...(policy.deniedCIDRs ?? [])],\n  };\n}\n\nexport type UpstashBox = Box;\n"],"mappings":"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"}

package/dist/providers/vercel/index.d.mts

@@ -1,8 +1,8 @@
-import "../../types-BTagTtsp.mjs";
-import { o as SandboxProvider } from "../../provider-_caCV8kk.mjs";
-import "../../index-BMFkO6Fv.mjs";
-import "../../sandbox-BUYT-1C9.mjs";
-import { o as vercelCapabilities } from "../../capabilities-CMnszzpt.mjs";
+import "../../types-Bv6I2U1c.mjs";
+import { o as SandboxProvider } from "../../provider-DOBErkBO.mjs";
+import "../../index-Dh9xob2s.mjs";
+import "../../sandbox-DdEqoXJF.mjs";
+import { c as vercelCapabilities } from "../../capabilities-BWvOVFbH.mjs";
 import { Sandbox as VercelSandbox } from "@vercel/sandbox";
 
 //#region src/providers/vercel/index.d.ts
@@ -10,6 +10,7 @@ interface VercelBaseOptions {
   runtime?: "node24" | "node22" | "node26" | "python3.13" | (string & {});
   name?: string;
   ports?: number[];
+  /** Whether the sandbox persists across sessions. Defaults to true. */
   persistent?: boolean;
 }
 type VercelOptions = VercelBaseOptions & ({

package/dist/providers/vercel/index.mjs

@@ -1,8 +1,9 @@
-import { r as normalizeError, t as SandboxError } from "../../errors-Ch9PHKTd.mjs";
-import "../../capabilities-COKpwoFH.mjs";
-import "../../sandbox-BwyHcB_C.mjs";
-import { o as vercelCapabilities } from "../../capabilities-CEowrzRM.mjs";
-import { i as unsupported, n as portResult, o as withManagedSessions, r as toUint8Array } from "../../provider-utils-DilOYLBO.mjs";
+import { r as normalizeError, t as SandboxError } from "../../errors-BuF9bYOQ.mjs";
+import "../../capabilities-xs9kaHrK.mjs";
+import "../../sandbox-DgtY5hvt.mjs";
+import { c as vercelCapabilities } from "../../capabilities-CaSNd6J1.mjs";
+import { t as withManagedSessions } from "../../managed-provider-BsZGVQ4I.mjs";
+import { i as unsupported, n as portResult, r as toUint8Array } from "../../provider-utils-CfB9nvJx.mjs";
 import { Sandbox, Snapshot } from "@vercel/sandbox";
 
 //#region src/providers/vercel/index.ts

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["VercelSandbox","events: ProcessOutputEvent[]","VercelSnapshot"],"sources":["../../../src/providers/vercel/index.ts"],"sourcesContent":["import { Sandbox as VercelSandbox, Snapshot as VercelSnapshot } from \"@vercel/sandbox\";\nimport { normalizeError, SandboxError } from \"../../core/errors\";\nimport type { SandboxProvider } from \"../../core/provider\";\nimport type {\n  CommandInput,\n  ProcessOutputEvent,\n  SandboxProcess,\n  SandboxSnapshot,\n} from \"../../core/types\";\nimport { portResult, toUint8Array, unsupported } from \"../../internal/provider-utils\";\nimport { vercelCapabilities } from \"../capabilities\";\nimport { withManagedSessions } from \"../../internal/managed-provider\";\n\ninterface VercelBaseOptions {\n  runtime?: \"node24\" | \"node22\" | \"node26\" | \"python3.13\" | (string & {});\n  name?: string;\n  ports?: number[];\n  persistent?: boolean;\n}\n\nexport type VercelOptions = VercelBaseOptions &\n  (\n    | { token: string; teamId: string; projectId: string }\n    | { token?: never; teamId?: never; projectId?: never }\n  );\n\nexport { vercelCapabilities } from \"../capabilities\";\n\nexport function vercel(options: VercelOptions = {}): SandboxProvider<VercelSandbox> {\n  return withManagedSessions(\n    {\n      id: \"vercel\",\n      capabilities: vercelCapabilities,\n      async create(createOptions) {\n        const credentials =\n          options.token && options.teamId && options.projectId\n            ? {\n                token: options.token,\n                teamId: options.teamId,\n                projectId: options.projectId,\n              }\n            : {};\n        const exposed = new Set(options.ports ?? []);\n        const raw = await VercelSandbox.create({\n          ...credentials,\n          runtime: options.runtime ?? \"node24\",\n          name: options.name,\n          ports: [...exposed],\n          persistent: options.persistent,\n          timeout: createOptions.timeout,\n          env: { ...createOptions.env },\n          signal: createOptions.signal,\n        });\n        const snapshots = new Map<string, VercelSnapshot>();\n        await raw.fs.mkdir(createOptions.cwd, { recursive: true });\n        return {\n          id: raw.name,\n          raw,\n          capabilities: vercelCapabilities,\n          files: {\n            async write(path, value) {\n              await raw.fs.writeFile(path, await toUint8Array(value));\n            },\n            async read(path) {\n              return new Uint8Array(await raw.fs.readFile(path));\n            },\n            async list(path) {\n              const entries = await raw.fs.readdir(path, {\n                withFileTypes: true,\n              });\n              return Promise.all(\n                entries.map(async (entry) => {\n                  const entryPath = `${path.replace(/\\/$/, \"\")}/${entry.name}`;\n                  const info = await raw.fs.lstat(entryPath);\n                  return {\n                    name: entry.name,\n                    path: entryPath,\n                    type: entry.isFile()\n                      ? (\"file\" as const)\n                      : entry.isDirectory()\n                        ? (\"directory\" as const)\n                        : entry.isSymbolicLink()\n                          ? (\"symlink\" as const)\n                          : (\"unknown\" as const),\n                    size: entry.isFile() ? info.size : undefined,\n                  };\n                }),\n              );\n            },\n            async mkdir(path) {\n              await raw.fs.mkdir(path, { recursive: true });\n            },\n            async remove(path) {\n              await raw.fs.rm(path, { recursive: true, force: true });\n            },\n            exists: (path) => raw.fs.exists(path),\n          },\n          async run(command, runOptions) {\n            try {\n              const result = await runCommand(raw, command, runOptions, false);\n              const [stdout, stderr] = await Promise.all([\n                result.stdout({ signal: runOptions.signal }),\n                result.stderr({ signal: runOptions.signal }),\n              ]);\n              if (\n                runOptions.timeout !== undefined &&\n                result.exitCode === 137 &&\n                result.durationMs !== undefined &&\n                result.durationMs >= runOptions.timeout\n              ) {\n                throw new SandboxError({\n                  code: \"timeout\",\n                  provider: \"vercel\",\n                  operation: \"process.run\",\n                  message: `Command timed out after ${runOptions.timeout}ms`,\n                });\n              }\n              return {\n                stdout,\n                stderr,\n                exitCode: result.exitCode,\n                success: result.exitCode === 0,\n                durationMs: result.durationMs,\n              };\n            } catch (error) {\n              throw normalizeError(\"vercel\", \"process.run\", error);\n            }\n          },\n          async start(command, runOptions) {\n            const handle = await runCommand(raw, command, runOptions, true);\n            const events: ProcessOutputEvent[] = [];\n            let running = true;\n            const stream = handle.logs({ signal: runOptions.signal });\n            const completed = handle.wait().then((result) => ({ exitCode: result.exitCode }));\n            const process: SandboxProcess = {\n              id: handle.cmdId,\n              async status() {\n                return running ? \"running\" : \"exited\";\n              },\n              async *output() {\n                try {\n                  for await (const event of stream) {\n                    const normalized = {\n                      stream: event.stream,\n                      data: event.data,\n                      timestamp: new Date(),\n                    } satisfies ProcessOutputEvent;\n                    events.push(normalized);\n                    yield normalized;\n                  }\n                } finally {\n                  running = false;\n                }\n              },\n              async write() {\n                unsupported(\"vercel\", \"process.stdin\");\n              },\n              wait: () => completed,\n              async kill(signal = \"SIGTERM\") {\n                await handle.kill(signal as Parameters<typeof handle.kill>[0]);\n                running = false;\n              },\n            };\n            return process;\n          },\n          async expose(port) {\n            if (!exposed.has(port)) {\n              exposed.add(port);\n              await raw.update({ ports: [...exposed] });\n            }\n            const url = raw.domain(port);\n            return portResult(port, url, true, false);\n          },\n          snapshots: {\n            async create() {\n              const snapshot = await raw.snapshot();\n              snapshots.set(snapshot.snapshotId, snapshot);\n              return {\n                id: snapshot.snapshotId,\n                mode: \"filesystem\",\n                createdAt: snapshot.createdAt,\n              } satisfies SandboxSnapshot;\n            },\n            async delete(snapshot) {\n              const id = typeof snapshot === \"string\" ? snapshot : snapshot.id;\n              const native =\n                snapshots.get(id) ?? (await VercelSnapshot.get({ snapshotId: id, ...credentials }));\n              await native.delete();\n              snapshots.delete(id);\n            },\n            async restore() {\n              unsupported(\"vercel\", \"snapshot.restore\");\n            },\n          },\n          async stop() {\n            if (raw.status !== \"stopped\") await raw.stop();\n          },\n        };\n      },\n    },\n    options.ports,\n    {\n      stop: async (sandbox) => {\n        await sandbox.raw.stop();\n      },\n      destroy: (sandbox) => sandbox.raw.delete(),\n      setPorts: (sandbox, ports, signal) => sandbox.raw.update({ ports: [...ports] }, { signal }),\n      setNetworkPolicy: (sandbox, policy) =>\n        sandbox.raw.update({\n          networkPolicy:\n            policy.mode === \"allow-all\" || policy.mode === \"deny-all\"\n              ? policy.mode\n              : policy.mode === \"native\"\n                ? (policy.value as import(\"@vercel/sandbox\").NetworkPolicy)\n                : { allow: [...(policy.allowedHosts ?? [])] },\n        }),\n    },\n  );\n}\n\nasync function runCommand(\n  raw: VercelSandbox,\n  input: CommandInput,\n  options: import(\"../../core/types\").RunOptions,\n  detached: false,\n): Promise<import(\"@vercel/sandbox\").CommandFinished>;\nasync function runCommand(\n  raw: VercelSandbox,\n  input: CommandInput,\n  options: import(\"../../core/types\").RunOptions,\n  detached: true,\n): Promise<import(\"@vercel/sandbox\").Command>;\nasync function runCommand(\n  raw: VercelSandbox,\n  input: CommandInput,\n  options: import(\"../../core/types\").RunOptions,\n  detached: boolean,\n) {\n  const command = typeof input === \"string\" ? { command: \"/bin/sh\", args: [\"-lc\", input] } : input;\n  return raw.runCommand({\n    cmd: command.command,\n    args: [...(command.args ?? [])],\n    cwd: options.cwd,\n    env: { ...options.env },\n    signal: options.signal,\n    timeoutMs: options.timeout,\n    detached,\n  });\n}\n\nexport type { VercelSandbox };\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["VercelSandbox","events: ProcessOutputEvent[]","VercelSnapshot"],"sources":["../../../src/providers/vercel/index.ts"],"sourcesContent":["import { Sandbox as VercelSandbox, Snapshot as VercelSnapshot } from \"@vercel/sandbox\";\nimport { normalizeError, SandboxError } from \"../../core/errors\";\nimport type { SandboxProvider } from \"../../core/provider\";\nimport type {\n  CommandInput,\n  ProcessOutputEvent,\n  SandboxProcess,\n  SandboxSnapshot,\n} from \"../../core/types\";\nimport { portResult, toUint8Array, unsupported } from \"../../internal/provider-utils\";\nimport { vercelCapabilities } from \"../capabilities\";\nimport { withManagedSessions } from \"../../internal/managed-provider\";\n\ninterface VercelBaseOptions {\n  runtime?: \"node24\" | \"node22\" | \"node26\" | \"python3.13\" | (string & {});\n  name?: string;\n  ports?: number[];\n  /** Whether the sandbox persists across sessions. Defaults to true. */\n  persistent?: boolean;\n}\n\nexport type VercelOptions = VercelBaseOptions &\n  (\n    | { token: string; teamId: string; projectId: string }\n    | { token?: never; teamId?: never; projectId?: never }\n  );\n\nexport { vercelCapabilities } from \"../capabilities\";\n\nexport function vercel(options: VercelOptions = {}): SandboxProvider<VercelSandbox> {\n  return withManagedSessions(\n    {\n      id: \"vercel\",\n      capabilities: vercelCapabilities,\n      async create(createOptions) {\n        const credentials =\n          options.token && options.teamId && options.projectId\n            ? {\n                token: options.token,\n                teamId: options.teamId,\n                projectId: options.projectId,\n              }\n            : {};\n        const exposed = new Set(options.ports ?? []);\n        const raw = await VercelSandbox.create({\n          ...credentials,\n          runtime: options.runtime ?? \"node24\",\n          name: options.name,\n          ports: [...exposed],\n          persistent: options.persistent,\n          timeout: createOptions.timeout,\n          env: { ...createOptions.env },\n          signal: createOptions.signal,\n        });\n        const snapshots = new Map<string, VercelSnapshot>();\n        await raw.fs.mkdir(createOptions.cwd, { recursive: true });\n        return {\n          id: raw.name,\n          raw,\n          capabilities: vercelCapabilities,\n          files: {\n            async write(path, value) {\n              await raw.fs.writeFile(path, await toUint8Array(value));\n            },\n            async read(path) {\n              return new Uint8Array(await raw.fs.readFile(path));\n            },\n            async list(path) {\n              const entries = await raw.fs.readdir(path, {\n                withFileTypes: true,\n              });\n              return Promise.all(\n                entries.map(async (entry) => {\n                  const entryPath = `${path.replace(/\\/$/, \"\")}/${entry.name}`;\n                  const info = await raw.fs.lstat(entryPath);\n                  return {\n                    name: entry.name,\n                    path: entryPath,\n                    type: entry.isFile()\n                      ? (\"file\" as const)\n                      : entry.isDirectory()\n                        ? (\"directory\" as const)\n                        : entry.isSymbolicLink()\n                          ? (\"symlink\" as const)\n                          : (\"unknown\" as const),\n                    size: entry.isFile() ? info.size : undefined,\n                  };\n                }),\n              );\n            },\n            async mkdir(path) {\n              await raw.fs.mkdir(path, { recursive: true });\n            },\n            async remove(path) {\n              await raw.fs.rm(path, { recursive: true, force: true });\n            },\n            exists: (path) => raw.fs.exists(path),\n          },\n          async run(command, runOptions) {\n            try {\n              const result = await runCommand(raw, command, runOptions, false);\n              const [stdout, stderr] = await Promise.all([\n                result.stdout({ signal: runOptions.signal }),\n                result.stderr({ signal: runOptions.signal }),\n              ]);\n              if (\n                runOptions.timeout !== undefined &&\n                result.exitCode === 137 &&\n                result.durationMs !== undefined &&\n                result.durationMs >= runOptions.timeout\n              ) {\n                throw new SandboxError({\n                  code: \"timeout\",\n                  provider: \"vercel\",\n                  operation: \"process.run\",\n                  message: `Command timed out after ${runOptions.timeout}ms`,\n                });\n              }\n              return {\n                stdout,\n                stderr,\n                exitCode: result.exitCode,\n                success: result.exitCode === 0,\n                durationMs: result.durationMs,\n              };\n            } catch (error) {\n              throw normalizeError(\"vercel\", \"process.run\", error);\n            }\n          },\n          async start(command, runOptions) {\n            const handle = await runCommand(raw, command, runOptions, true);\n            const events: ProcessOutputEvent[] = [];\n            let running = true;\n            const stream = handle.logs({ signal: runOptions.signal });\n            const completed = handle.wait().then((result) => ({ exitCode: result.exitCode }));\n            const process: SandboxProcess = {\n              id: handle.cmdId,\n              async status() {\n                return running ? \"running\" : \"exited\";\n              },\n              async *output() {\n                try {\n                  for await (const event of stream) {\n                    const normalized = {\n                      stream: event.stream,\n                      data: event.data,\n                      timestamp: new Date(),\n                    } satisfies ProcessOutputEvent;\n                    events.push(normalized);\n                    yield normalized;\n                  }\n                } finally {\n                  running = false;\n                }\n              },\n              async write() {\n                unsupported(\"vercel\", \"process.stdin\");\n              },\n              wait: () => completed,\n              async kill(signal = \"SIGTERM\") {\n                await handle.kill(signal as Parameters<typeof handle.kill>[0]);\n                running = false;\n              },\n            };\n            return process;\n          },\n          async expose(port) {\n            if (!exposed.has(port)) {\n              exposed.add(port);\n              await raw.update({ ports: [...exposed] });\n            }\n            const url = raw.domain(port);\n            return portResult(port, url, true, false);\n          },\n          snapshots: {\n            async create() {\n              const snapshot = await raw.snapshot();\n              snapshots.set(snapshot.snapshotId, snapshot);\n              return {\n                id: snapshot.snapshotId,\n                mode: \"filesystem\",\n                createdAt: snapshot.createdAt,\n              } satisfies SandboxSnapshot;\n            },\n            async delete(snapshot) {\n              const id = typeof snapshot === \"string\" ? snapshot : snapshot.id;\n              const native =\n                snapshots.get(id) ?? (await VercelSnapshot.get({ snapshotId: id, ...credentials }));\n              await native.delete();\n              snapshots.delete(id);\n            },\n            async restore() {\n              unsupported(\"vercel\", \"snapshot.restore\");\n            },\n          },\n          async stop() {\n            if (raw.status !== \"stopped\") await raw.stop();\n          },\n        };\n      },\n    },\n    options.ports,\n    {\n      stop: async (sandbox) => {\n        await sandbox.raw.stop();\n      },\n      destroy: (sandbox) => sandbox.raw.delete(),\n      setPorts: (sandbox, ports, signal) => sandbox.raw.update({ ports: [...ports] }, { signal }),\n      setNetworkPolicy: (sandbox, policy) =>\n        sandbox.raw.update({\n          networkPolicy:\n            policy.mode === \"allow-all\" || policy.mode === \"deny-all\"\n              ? policy.mode\n              : policy.mode === \"native\"\n                ? (policy.value as import(\"@vercel/sandbox\").NetworkPolicy)\n                : { allow: [...(policy.allowedHosts ?? [])] },\n        }),\n    },\n  );\n}\n\nasync function runCommand(\n  raw: VercelSandbox,\n  input: CommandInput,\n  options: import(\"../../core/types\").RunOptions,\n  detached: false,\n): Promise<import(\"@vercel/sandbox\").CommandFinished>;\nasync function runCommand(\n  raw: VercelSandbox,\n  input: CommandInput,\n  options: import(\"../../core/types\").RunOptions,\n  detached: true,\n): Promise<import(\"@vercel/sandbox\").Command>;\nasync function runCommand(\n  raw: VercelSandbox,\n  input: CommandInput,\n  options: import(\"../../core/types\").RunOptions,\n  detached: boolean,\n) {\n  const command = typeof input === \"string\" ? { command: \"/bin/sh\", args: [\"-lc\", input] } : input;\n  return raw.runCommand({\n    cmd: command.command,\n    args: [...(command.args ?? [])],\n    cwd: options.cwd,\n    env: { ...options.env },\n    signal: options.signal,\n    timeoutMs: options.timeout,\n    detached,\n  });\n}\n\nexport type { VercelSandbox };\n"],"mappings":";;;;;;;;;AA6BA,SAAgB,OAAO,UAAyB,EAAE,EAAkC;AAClF,QAAO,oBACL;EACE,IAAI;EACJ,cAAc;EACd,MAAM,OAAO,eAAe;GAC1B,MAAM,cACJ,QAAQ,SAAS,QAAQ,UAAU,QAAQ,YACvC;IACE,OAAO,QAAQ;IACf,QAAQ,QAAQ;IAChB,WAAW,QAAQ;IACpB,GACD,EAAE;GACR,MAAM,UAAU,IAAI,IAAI,QAAQ,SAAS,EAAE,CAAC;GAC5C,MAAM,MAAM,MAAMA,QAAc,OAAO;IACrC,GAAG;IACH,SAAS,QAAQ,WAAW;IAC5B,MAAM,QAAQ;IACd,OAAO,CAAC,GAAG,QAAQ;IACnB,YAAY,QAAQ;IACpB,SAAS,cAAc;IACvB,KAAK,EAAE,GAAG,cAAc,KAAK;IAC7B,QAAQ,cAAc;IACvB,CAAC;GACF,MAAM,4BAAY,IAAI,KAA6B;AACnD,SAAM,IAAI,GAAG,MAAM,cAAc,KAAK,EAAE,WAAW,MAAM,CAAC;AAC1D,UAAO;IACL,IAAI,IAAI;IACR;IACA,cAAc;IACd,OAAO;KACL,MAAM,MAAM,MAAM,OAAO;AACvB,YAAM,IAAI,GAAG,UAAU,MAAM,MAAM,aAAa,MAAM,CAAC;;KAEzD,MAAM,KAAK,MAAM;AACf,aAAO,IAAI,WAAW,MAAM,IAAI,GAAG,SAAS,KAAK,CAAC;;KAEpD,MAAM,KAAK,MAAM;MACf,MAAM,UAAU,MAAM,IAAI,GAAG,QAAQ,MAAM,EACzC,eAAe,MAChB,CAAC;AACF,aAAO,QAAQ,IACb,QAAQ,IAAI,OAAO,UAAU;OAC3B,MAAM,YAAY,GAAG,KAAK,QAAQ,OAAO,GAAG,CAAC,GAAG,MAAM;OACtD,MAAM,OAAO,MAAM,IAAI,GAAG,MAAM,UAAU;AAC1C,cAAO;QACL,MAAM,MAAM;QACZ,MAAM;QACN,MAAM,MAAM,QAAQ,GACf,SACD,MAAM,aAAa,GAChB,cACD,MAAM,gBAAgB,GACnB,YACA;QACT,MAAM,MAAM,QAAQ,GAAG,KAAK,OAAO;QACpC;QACD,CACH;;KAEH,MAAM,MAAM,MAAM;AAChB,YAAM,IAAI,GAAG,MAAM,MAAM,EAAE,WAAW,MAAM,CAAC;;KAE/C,MAAM,OAAO,MAAM;AACjB,YAAM,IAAI,GAAG,GAAG,MAAM;OAAE,WAAW;OAAM,OAAO;OAAM,CAAC;;KAEzD,SAAS,SAAS,IAAI,GAAG,OAAO,KAAK;KACtC;IACD,MAAM,IAAI,SAAS,YAAY;AAC7B,SAAI;MACF,MAAM,SAAS,MAAM,WAAW,KAAK,SAAS,YAAY,MAAM;MAChE,MAAM,CAAC,QAAQ,UAAU,MAAM,QAAQ,IAAI,CACzC,OAAO,OAAO,EAAE,QAAQ,WAAW,QAAQ,CAAC,EAC5C,OAAO,OAAO,EAAE,QAAQ,WAAW,QAAQ,CAAC,CAC7C,CAAC;AACF,UACE,WAAW,YAAY,UACvB,OAAO,aAAa,OACpB,OAAO,eAAe,UACtB,OAAO,cAAc,WAAW,QAEhC,OAAM,IAAI,aAAa;OACrB,MAAM;OACN,UAAU;OACV,WAAW;OACX,SAAS,2BAA2B,WAAW,QAAQ;OACxD,CAAC;AAEJ,aAAO;OACL;OACA;OACA,UAAU,OAAO;OACjB,SAAS,OAAO,aAAa;OAC7B,YAAY,OAAO;OACpB;cACM,OAAO;AACd,YAAM,eAAe,UAAU,eAAe,MAAM;;;IAGxD,MAAM,MAAM,SAAS,YAAY;KAC/B,MAAM,SAAS,MAAM,WAAW,KAAK,SAAS,YAAY,KAAK;KAC/D,MAAMC,SAA+B,EAAE;KACvC,IAAI,UAAU;KACd,MAAM,SAAS,OAAO,KAAK,EAAE,QAAQ,WAAW,QAAQ,CAAC;KACzD,MAAM,YAAY,OAAO,MAAM,CAAC,MAAM,YAAY,EAAE,UAAU,OAAO,UAAU,EAAE;AA8BjF,YA7BgC;MAC9B,IAAI,OAAO;MACX,MAAM,SAAS;AACb,cAAO,UAAU,YAAY;;MAE/B,OAAO,SAAS;AACd,WAAI;AACF,mBAAW,MAAM,SAAS,QAAQ;SAChC,MAAM,aAAa;UACjB,QAAQ,MAAM;UACd,MAAM,MAAM;UACZ,2BAAW,IAAI,MAAM;UACtB;AACD,gBAAO,KAAK,WAAW;AACvB,eAAM;;iBAEA;AACR,kBAAU;;;MAGd,MAAM,QAAQ;AACZ,mBAAY,UAAU,gBAAgB;;MAExC,YAAY;MACZ,MAAM,KAAK,SAAS,WAAW;AAC7B,aAAM,OAAO,KAAK,OAA4C;AAC9D,iBAAU;;MAEb;;IAGH,MAAM,OAAO,MAAM;AACjB,SAAI,CAAC,QAAQ,IAAI,KAAK,EAAE;AACtB,cAAQ,IAAI,KAAK;AACjB,YAAM,IAAI,OAAO,EAAE,OAAO,CAAC,GAAG,QAAQ,EAAE,CAAC;;AAG3C,YAAO,WAAW,MADN,IAAI,OAAO,KAAK,EACC,MAAM,MAAM;;IAE3C,WAAW;KACT,MAAM,SAAS;MACb,MAAM,WAAW,MAAM,IAAI,UAAU;AACrC,gBAAU,IAAI,SAAS,YAAY,SAAS;AAC5C,aAAO;OACL,IAAI,SAAS;OACb,MAAM;OACN,WAAW,SAAS;OACrB;;KAEH,MAAM,OAAO,UAAU;MACrB,MAAM,KAAK,OAAO,aAAa,WAAW,WAAW,SAAS;AAG9D,aADE,UAAU,IAAI,GAAG,IAAK,MAAMC,SAAe,IAAI;OAAE,YAAY;OAAI,GAAG;OAAa,CAAC,EACvE,QAAQ;AACrB,gBAAU,OAAO,GAAG;;KAEtB,MAAM,UAAU;AACd,kBAAY,UAAU,mBAAmB;;KAE5C;IACD,MAAM,OAAO;AACX,SAAI,IAAI,WAAW,UAAW,OAAM,IAAI,MAAM;;IAEjD;;EAEJ,EACD,QAAQ,OACR;EACE,MAAM,OAAO,YAAY;AACvB,SAAM,QAAQ,IAAI,MAAM;;EAE1B,UAAU,YAAY,QAAQ,IAAI,QAAQ;EAC1C,WAAW,SAAS,OAAO,WAAW,QAAQ,IAAI,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,EAAE,EAAE,QAAQ,CAAC;EAC3F,mBAAmB,SAAS,WAC1B,QAAQ,IAAI,OAAO,EACjB,eACE,OAAO,SAAS,eAAe,OAAO,SAAS,aAC3C,OAAO,OACP,OAAO,SAAS,WACb,OAAO,QACR,EAAE,OAAO,CAAC,GAAI,OAAO,gBAAgB,EAAE,CAAE,EAAE,EACpD,CAAC;EACL,CACF;;AAeH,eAAe,WACb,KACA,OACA,SACA,UACA;CACA,MAAM,UAAU,OAAO,UAAU,WAAW;EAAE,SAAS;EAAW,MAAM,CAAC,OAAO,MAAM;EAAE,GAAG;AAC3F,QAAO,IAAI,WAAW;EACpB,KAAK,QAAQ;EACb,MAAM,CAAC,GAAI,QAAQ,QAAQ,EAAE,CAAE;EAC/B,KAAK,QAAQ;EACb,KAAK,EAAE,GAAG,QAAQ,KAAK;EACvB,QAAQ,QAAQ;EAChB,WAAW,QAAQ;EACnB;EACD,CAAC"}

package/dist/{sandbox-BUYT-1C9.d.mts → sandbox-DdEqoXJF.d.mts}

@@ -1,5 +1,5 @@
-import { f as Sandbox } from "./types-BTagTtsp.mjs";
-import { o as SandboxProvider } from "./provider-_caCV8kk.mjs";
+import { f as Sandbox } from "./types-Bv6I2U1c.mjs";
+import { o as SandboxProvider } from "./provider-DOBErkBO.mjs";
 
 //#region src/core/sandbox.d.ts
 interface CreateSandboxOptions<TProvider extends SandboxProvider<unknown>> {
@@ -10,8 +10,17 @@ interface CreateSandboxOptions<TProvider extends SandboxProvider<unknown>> {
   signal?: AbortSignal;
 }
 type RawOf<TProvider> = TProvider extends SandboxProvider<infer TRaw> ? TRaw : never;
+/**
+ * Creates a normalized sandbox. Prefer `await using` so cleanup runs when the scope exits.
+ */
 declare function createSandbox<TProvider extends SandboxProvider<unknown>>(options: CreateSandboxOptions<TProvider>): Promise<Sandbox<RawOf<TProvider>>>;
+/**
+ * Runs a callback with a sandbox and stops it afterward.
+ *
+ * Prefer `await using` with `createSandbox()` in new code. This helper remains useful for
+ * callback-style code and runtimes that do not parse explicit resource management syntax.
+ */
 declare function withSandbox<TProvider extends SandboxProvider<unknown>, TResult>(options: CreateSandboxOptions<TProvider>, callback: (sandbox: Sandbox<RawOf<TProvider>>) => TResult | Promise<TResult>): Promise<TResult>;
 //#endregion
 export { createSandbox as n, withSandbox as r, CreateSandboxOptions as t };
-//# sourceMappingURL=sandbox-BUYT-1C9.d.mts.map
+//# sourceMappingURL=sandbox-DdEqoXJF.d.mts.map

package/dist/{sandbox-BwyHcB_C.mjs → sandbox-DgtY5hvt.mjs}

@@ -1,4 +1,4 @@
-import { r as normalizeError, t as SandboxError } from "./errors-Ch9PHKTd.mjs";
+import { r as normalizeError, t as SandboxError } from "./errors-BuF9bYOQ.mjs";
 
 //#region src/core/sandbox.ts
 function validateCwd(cwd) {
@@ -20,6 +20,9 @@ function validatePath(cwd, value) {
 	if (value.startsWith("/")) return value.replace(/\/{2,}/g, "/");
 	return `${cwd}/${value}`.replace(/\/{2,}/g, "/");
 }
+/**
+* Creates a normalized sandbox. Prefer `await using` so cleanup runs when the scope exits.
+*/
 async function createSandbox(options) {
 	const cwd = validateCwd(options.cwd ?? "/workspace");
 	const env = options.env ?? {};
@@ -69,7 +72,8 @@ async function createSandbox(options) {
 			restore: (snapshot) => call("snapshot.restore", () => runtime.snapshots.restore(snapshot))
 		},
 		run: (command, runOptions = {}) => call("process.run", () => runtime.run(command, normalizeRunOptions(cwd, runOptions))),
-		stop
+		stop,
+		[Symbol.asyncDispose]: stop
 	};
 }
 function normalizeRunOptions(cwd, options) {
@@ -78,6 +82,12 @@ function normalizeRunOptions(cwd, options) {
 		cwd: options.cwd ? validatePath(cwd, options.cwd) : cwd
 	};
 }
+/**
+* Runs a callback with a sandbox and stops it afterward.
+*
+* Prefer `await using` with `createSandbox()` in new code. This helper remains useful for
+* callback-style code and runtimes that do not parse explicit resource management syntax.
+*/
 async function withSandbox(options, callback) {
 	const sandbox = await createSandbox(options);
 	try {
@@ -99,4 +109,4 @@ async function withSandbox(options, callback) {
 
 //#endregion
 export { withSandbox as n, createSandbox as t };
-//# sourceMappingURL=sandbox-BwyHcB_C.mjs.map
+//# sourceMappingURL=sandbox-DgtY5hvt.mjs.map

package/dist/sandbox-DgtY5hvt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-DgtY5hvt.mjs","names":["stopPromise: Promise<void> | undefined"],"sources":["../src/core/sandbox.ts"],"sourcesContent":["import { normalizeError, SandboxError } from \"./errors\";\nimport type { SandboxProvider } from \"./provider\";\nimport type { FileValue, RunOptions, Sandbox } from \"./types\";\n\nexport interface CreateSandboxOptions<TProvider extends SandboxProvider<unknown>> {\n  provider: TProvider;\n  cwd?: string;\n  env?: Readonly<Record<string, string>>;\n  timeout?: number;\n  signal?: AbortSignal;\n}\n\ntype RawOf<TProvider> = TProvider extends SandboxProvider<infer TRaw> ? TRaw : never;\n\nfunction validateCwd(cwd: string): string {\n  if (!cwd.startsWith(\"/\") || cwd.includes(\"\\0\")) {\n    throw new SandboxError({\n      code: \"invalid_input\",\n      provider: \"core\",\n      operation: \"create\",\n      message: \"cwd must be an absolute path\",\n    });\n  }\n  return cwd.replace(/\\/$/, \"\") || \"/\";\n}\n\nfunction validatePath(cwd: string, value: string): string {\n  if (!value || value.includes(\"\\0\") || value.split(\"/\").includes(\"..\")) {\n    throw new SandboxError({\n      code: \"invalid_input\",\n      provider: \"core\",\n      operation: \"path\",\n      message: `Invalid sandbox path: ${value}`,\n    });\n  }\n  if (value.startsWith(\"/\")) return value.replace(/\\/{2,}/g, \"/\");\n  return `${cwd}/${value}`.replace(/\\/{2,}/g, \"/\");\n}\n\n/**\n * Creates a normalized sandbox. Prefer `await using` so cleanup runs when the scope exits.\n */\nexport async function createSandbox<TProvider extends SandboxProvider<unknown>>(\n  options: CreateSandboxOptions<TProvider>,\n): Promise<Sandbox<RawOf<TProvider>>> {\n  const cwd = validateCwd(options.cwd ?? \"/workspace\");\n  const env = options.env ?? {};\n  let runtime;\n  try {\n    runtime = await options.provider.create({\n      cwd,\n      env,\n      timeout: options.timeout,\n      signal: options.signal,\n    });\n  } catch (error) {\n    throw normalizeError(options.provider.id, \"sandbox.create\", error);\n  }\n  let stopPromise: Promise<void> | undefined;\n  const stop = async () => {\n    stopPromise ??= call(\"sandbox.stop\", () => runtime.stop());\n    return stopPromise;\n  };\n  const call = async <T>(operation: string, fn: () => Promise<T>): Promise<T> => {\n    try {\n      return await fn();\n    } catch (error) {\n      throw normalizeError(options.provider.id, operation, error);\n    }\n  };\n  return {\n    id: runtime.id,\n    provider: options.provider.id,\n    cwd,\n    capabilities: runtime.capabilities,\n    raw: runtime.raw as RawOf<TProvider>,\n    files: {\n      write: async (path: string, value: FileValue) =>\n        call(\"files.write\", () => runtime.files.write(validatePath(cwd, path), value)),\n      read: async (path: string) =>\n        call(\"files.read\", () => runtime.files.read(validatePath(cwd, path))),\n      text: async (path: string) =>\n        new TextDecoder().decode(\n          await call(\"files.read\", () => runtime.files.read(validatePath(cwd, path))),\n        ),\n      list: async (path = \".\") =>\n        call(\"files.list\", () => runtime.files.list(path === \".\" ? cwd : validatePath(cwd, path))),\n      mkdir: async (path: string) =>\n        call(\"files.mkdir\", () => runtime.files.mkdir(validatePath(cwd, path))),\n      remove: async (path: string) =>\n        call(\"files.remove\", () => runtime.files.remove(validatePath(cwd, path))),\n      exists: async (path: string) =>\n        call(\"files.exists\", () => runtime.files.exists(validatePath(cwd, path))),\n    },\n    processes: {\n      start: (command, runOptions = {}) =>\n        call(\"process.start\", () => runtime.start(command, normalizeRunOptions(cwd, runOptions))),\n    },\n    ports: { expose: (port) => call(\"ports.expose\", () => runtime.expose(port)) },\n    snapshots: {\n      create: (snapshotOptions) =>\n        call(\"snapshot.create\", () => runtime.snapshots.create(snapshotOptions)),\n      delete: (snapshot) => call(\"snapshot.delete\", () => runtime.snapshots.delete(snapshot)),\n      restore: (snapshot) => call(\"snapshot.restore\", () => runtime.snapshots.restore(snapshot)),\n    },\n    run: (command, runOptions = {}) =>\n      call(\"process.run\", () => runtime.run(command, normalizeRunOptions(cwd, runOptions))),\n    stop,\n    [Symbol.asyncDispose]: stop,\n  };\n}\n\nfunction normalizeRunOptions(cwd: string, options: RunOptions): RunOptions {\n  return { ...options, cwd: options.cwd ? validatePath(cwd, options.cwd) : cwd };\n}\n\n/**\n * Runs a callback with a sandbox and stops it afterward.\n *\n * Prefer `await using` with `createSandbox()` in new code. This helper remains useful for\n * callback-style code and runtimes that do not parse explicit resource management syntax.\n */\nexport async function withSandbox<TProvider extends SandboxProvider<unknown>, TResult>(\n  options: CreateSandboxOptions<TProvider>,\n  callback: (sandbox: Sandbox<RawOf<TProvider>>) => TResult | Promise<TResult>,\n): Promise<TResult> {\n  const sandbox = await createSandbox(options);\n  try {\n    const result = await callback(sandbox);\n    await sandbox.stop();\n    return result;\n  } catch (error) {\n    try {\n      await sandbox.stop();\n    } catch (cleanupError) {\n      if (error instanceof Error) {\n        Object.defineProperty(error, \"cleanupError\", { value: cleanupError, enumerable: false });\n      }\n    }\n    throw error;\n  }\n}\n"],"mappings":"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"}

package/dist/testing/index.d.mts

@@ -1,6 +1,6 @@
-import "../types-BTagTtsp.mjs";
-import { o as SandboxProvider } from "../provider-_caCV8kk.mjs";
-import { t as CreateSandboxOptions } from "../sandbox-BUYT-1C9.mjs";
+import "../types-Bv6I2U1c.mjs";
+import { o as SandboxProvider } from "../provider-DOBErkBO.mjs";
+import { t as CreateSandboxOptions } from "../sandbox-DdEqoXJF.mjs";
 
 //#region src/testing/conformance.d.ts
 declare const conformanceCases: readonly ["create and stop", "idempotent stop", "text files", "binary files", "directories", "relative paths", "invalid paths", "successful command", "stdout", "stderr", "nonzero exit", "timeout", "background process", "stdin", "ports", "snapshot create", "snapshot delete", "snapshot restore", "cleanup after failure"];

package/dist/testing/index.mjs

@@ -1,6 +1,6 @@
-import "../errors-Ch9PHKTd.mjs";
-import { i as supports } from "../capabilities-COKpwoFH.mjs";
-import { t as createSandbox } from "../sandbox-BwyHcB_C.mjs";
+import "../errors-BuF9bYOQ.mjs";
+import { i as supports } from "../capabilities-xs9kaHrK.mjs";
+import { t as createSandbox } from "../sandbox-DgtY5hvt.mjs";
 
 //#region src/testing/conformance.ts
 const conformanceCases = [

package/dist/{types-BTagTtsp.d.mts → types-Bv6I2U1c.d.mts}

@@ -1,5 +1,5 @@
 //#region src/core/types.d.ts
-declare const providerNames: readonly ["local", "e2b", "daytona", "vercel", "upstash"];
+declare const providerNames: readonly ["local", "e2b", "daytona", "vercel", "upstash", "box", "railway"];
 type ProviderName = (typeof providerNames)[number];
 declare const capabilityNames: readonly ["files.read", "files.write", "files.list", "files.remove", "process.run", "process.stream", "process.background", "process.stdin", "process.cancel", "ports.expose", "ports.authenticatedRequest", "snapshot.create", "snapshot.delete", "snapshot.restore", "sandbox.resume", "filesystem.persistent", "image.custom", "network.policy", "process.pty", "compute.gpu"];
 type Capability = (typeof capabilityNames)[number];
@@ -93,8 +93,11 @@ interface Sandbox<TRaw = unknown> {
   readonly ports: SandboxPorts;
   readonly snapshots: SandboxSnapshots;
   run(command: CommandInput, options?: RunOptions): Promise<CommandResult>;
+  /** Stops the provider runtime. Repeated calls share the same cleanup operation. */
   stop(): Promise<void>;
+  /** Stops the sandbox when an `await using` scope exits. */
+  [Symbol.asyncDispose](): Promise<void>;
 }
 //#endregion
 export { SandboxProcesses as _, CommandResult as a, capabilityNames as b, ProcessOutputEvent as c, RunOptions as d, Sandbox as f, SandboxProcess as g, SandboxPorts as h, CommandInput as i, ProcessStatus as l, SandboxFiles as m, CapabilityMap as n, ExposedPort as o, SandboxDirectoryEntry as p, CapabilityMode as r, FileValue as s, Capability as t, ProviderName as u, SandboxSnapshot as v, providerNames as x, SandboxSnapshots as y };
-//# sourceMappingURL=types-BTagTtsp.d.mts.map
+//# sourceMappingURL=types-Bv6I2U1c.d.mts.map