sandbox 2.5.4 → 3.0.0-beta.1

package/dist/{app-6okY2haN.mjs → app-AqqXdE-N.mjs}

@@ -478,7 +478,7 @@ var init_source = __esm({ "../../node_modules/.pnpm/chalk@5.6.0/node_modules/cha
 var require_didYouMean_1_2_1 = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/didyoumean@1.2.2/node_modules/didyoumean/didYouMean-1.2.1.js": ((exports, module) => {
 	(function() {
 		"use strict";
-		function didYouMean(str, list$2, key) {
+		function didYouMean(str, list$3, key) {
 			if (!str) return null;
 			if (!didYouMean.caseSensitive) str = str.toLowerCase();
 			var thresholdRelative = didYouMean.threshold === null ? null : didYouMean.threshold * str.length, thresholdAbsolute = didYouMean.thresholdAbsolute, winningVal;
@@ -486,9 +486,9 @@ var require_didYouMean_1_2_1 = /* @__PURE__ */ __commonJS$1({ "../../node_module
 			else if (thresholdRelative !== null) winningVal = thresholdRelative;
 			else if (thresholdAbsolute !== null) winningVal = thresholdAbsolute;
 			else winningVal = null;
-			var winner, candidate, testCandidate, val, i, len = list$2.length;
+			var winner, candidate, testCandidate, val, i, len = list$3.length;
 			for (i = 0; i < len; i++) {
-				candidate = list$2[i];
+				candidate = list$3[i];
 				if (key) candidate = candidate[key];
 				if (!candidate) continue;
 				if (!didYouMean.caseSensitive) testCandidate = candidate.toLowerCase();
@@ -496,7 +496,7 @@ var require_didYouMean_1_2_1 = /* @__PURE__ */ __commonJS$1({ "../../node_module
 				val = getEditDistance(str, testCandidate, winningVal);
 				if (winningVal === null || val < winningVal) {
 					winningVal = val;
-					if (key && didYouMean.returnWinningObject) winner = list$2[i];
+					if (key && didYouMean.returnWinningObject) winner = list$3[i];
 					else winner = candidate;
 					if (didYouMean.returnFirstMatch) return winner;
 				}
@@ -1446,7 +1446,7 @@ var require_subcommands = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pn
 		return mod && mod.__esModule ? mod : { "default": mod };
 	};
 	Object.defineProperty(exports, "__esModule", { value: true });
-	exports.subcommands = subcommands$2;
+	exports.subcommands = subcommands$3;
 	const chalk_1$3 = __importDefault$4((init_source(), __toCommonJS$3(source_exports)));
 	const didyoumean_1 = __importDefault$4(require_didYouMean_1_2_1());
 	const Result$7 = __importStar$7(require_Result());
@@ -1456,7 +1456,7 @@ var require_subcommands = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pn
 	/**
 	* Combine multiple `command`s into one
 	*/
-	function subcommands$2(config$1) {
+	function subcommands$3(config$1) {
 		const circuitbreaker = (0, circuitbreaker_1$1.createCircuitBreaker)(!!config$1.version);
 		const subcommand = (0, positional_1$1.positional)({
 			displayName: "subcommand",
@@ -2997,17 +2997,18 @@ var require_cjs = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-t
 
 //#endregion
 //#region src/args/runtime.ts
-var import_cjs$23 = /* @__PURE__ */ __toESM(require_cjs());
-const runtime = import_cjs$23.option({
+var import_cjs$26 = /* @__PURE__ */ __toESM(require_cjs());
+const runtimeType = {
+	...import_cjs$26.oneOf([
+		"node22",
+		"node24",
+		"python3.13"
+	]),
+	displayName: "runtime"
+};
+const runtime = import_cjs$26.option({
 	long: "runtime",
-	type: {
-		...import_cjs$23.oneOf([
-			"node22",
-			"node24",
-			"python3.13"
-		]),
-		displayName: "runtime"
-	},
+	type: runtimeType,
 	defaultValue: () => "node24",
 	defaultValueIsSerializable: true
 });
@@ -3099,13 +3100,13 @@ var require_ms = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/ms@2.1
 	* @return {String}
 	* @api private
 	*/
-	function fmtShort(ms$3) {
-		var msAbs = Math.abs(ms$3);
-		if (msAbs >= d) return Math.round(ms$3 / d) + "d";
-		if (msAbs >= h) return Math.round(ms$3 / h) + "h";
-		if (msAbs >= m) return Math.round(ms$3 / m) + "m";
-		if (msAbs >= s) return Math.round(ms$3 / s) + "s";
-		return ms$3 + "ms";
+	function fmtShort(ms$4) {
+		var msAbs = Math.abs(ms$4);
+		if (msAbs >= d) return Math.round(ms$4 / d) + "d";
+		if (msAbs >= h) return Math.round(ms$4 / h) + "h";
+		if (msAbs >= m) return Math.round(ms$4 / m) + "m";
+		if (msAbs >= s) return Math.round(ms$4 / s) + "s";
+		return ms$4 + "ms";
 	}
 	/**
 	* Long format for `ms`.
@@ -3114,28 +3115,28 @@ var require_ms = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/ms@2.1
 	* @return {String}
 	* @api private
 	*/
-	function fmtLong(ms$3) {
-		var msAbs = Math.abs(ms$3);
-		if (msAbs >= d) return plural(ms$3, msAbs, d, "day");
-		if (msAbs >= h) return plural(ms$3, msAbs, h, "hour");
-		if (msAbs >= m) return plural(ms$3, msAbs, m, "minute");
-		if (msAbs >= s) return plural(ms$3, msAbs, s, "second");
-		return ms$3 + " ms";
+	function fmtLong(ms$4) {
+		var msAbs = Math.abs(ms$4);
+		if (msAbs >= d) return plural(ms$4, msAbs, d, "day");
+		if (msAbs >= h) return plural(ms$4, msAbs, h, "hour");
+		if (msAbs >= m) return plural(ms$4, msAbs, m, "minute");
+		if (msAbs >= s) return plural(ms$4, msAbs, s, "second");
+		return ms$4 + " ms";
 	}
 	/**
 	* Pluralization helper.
 	*/
-	function plural(ms$3, msAbs, n, name) {
+	function plural(ms$4, msAbs, n, name) {
 		var isPlural = msAbs >= n * 1.5;
-		return Math.round(ms$3 / n) + " " + name + (isPlural ? "s" : "");
+		return Math.round(ms$4 / n) + " " + name + (isPlural ? "s" : "");
 	}
 }) });
 
 //#endregion
 //#region src/types/duration.ts
-var import_cjs$22 = require_cjs();
+var import_cjs$25 = require_cjs();
 init_source();
-const Duration = (0, import_cjs$22.extendType)(import_cjs$22.string, {
+const Duration = (0, import_cjs$25.extendType)(import_cjs$25.string, {
 	displayName: "num UNIT",
 	description: "A duration, e.g. 5m, 10s, 1h",
 	async from(string$1) {
@@ -3151,8 +3152,8 @@ const Duration = (0, import_cjs$22.extendType)(import_cjs$22.string, {
 
 //#endregion
 //#region src/args/timeout.ts
-var import_cjs$21 = /* @__PURE__ */ __toESM(require_cjs());
-const timeout = import_cjs$21.option({
+var import_cjs$24 = /* @__PURE__ */ __toESM(require_cjs());
+const timeout = import_cjs$24.option({
 	long: "timeout",
 	type: Duration,
 	description: "The maximum duration a sandbox can run for. Example: 5m, 1h",
@@ -3162,10 +3163,10 @@ const timeout = import_cjs$21.option({
 
 //#endregion
 //#region src/args/vcpus.ts
-var import_cjs$20 = /* @__PURE__ */ __toESM(require_cjs());
-const vcpus = import_cjs$20.option({
+var import_cjs$23 = /* @__PURE__ */ __toESM(require_cjs());
+const vcpus = import_cjs$23.option({
 	long: "vcpus",
-	type: import_cjs$20.optional(import_cjs$20.extendType(import_cjs$20.number, {
+	type: import_cjs$23.optional(import_cjs$23.extendType(import_cjs$23.number, {
 		displayName: "COUNT",
 		async from(n) {
 			if (!Number.isInteger(n) || n < 1) throw new Error(`Invalid vCPU count: ${n}. Must be a positive integer.`);
@@ -6950,10 +6951,10 @@ function _usingCtx() {
 
 //#endregion
 //#region src/commands/login.ts
-var import_cjs$19 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$22 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
 const debug$5 = createDebugger("sandbox:login");
-const login = import_cjs$19.command({
+const login = import_cjs$22.command({
 	name: "login",
 	description: "Log in to the Sandbox CLI",
 	args: {},
@@ -7163,15 +7164,15 @@ var require_dist = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/@ver
 
 //#endregion
 //#region src/args/auth.ts
-var import_cjs$18 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$21 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
 var import_dist = require_dist();
 const debug$4 = createDebugger("sandbox:args:auth");
-const token = import_cjs$18.option({
+const token = import_cjs$21.option({
 	long: "token",
 	description: "A Vercel authentication token. If not provided, will use the token stored in your system from `VERCEL_AUTH_TOKEN` or will start a log in process.",
 	type: {
-		...import_cjs$18.string,
+		...import_cjs$21.string,
 		displayName: "pat_or_oidc",
 		defaultValueIsSerializable: false,
 		onMissing: async () => {
@@ -7314,29 +7315,29 @@ async function inferFromToken(token$1, requestedTeam) {
 
 //#endregion
 //#region src/args/scope.ts
-var import_cjs$17 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$20 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-const project = import_cjs$17.option({
+const project = import_cjs$20.option({
 	long: "project",
 	type: {
-		...import_cjs$17.optional(import_cjs$17.string),
+		...import_cjs$20.optional(import_cjs$20.string),
 		displayName: "my-project"
 	},
 	description: "The project name or ID to associate with the command. Can be inferred from VERCEL_OIDC_TOKEN."
 });
 /** Parser for the `--team` option. */
-const teamParser = import_cjs$17.option({
+const teamParser = import_cjs$20.option({
 	long: "team",
 	type: {
-		...import_cjs$17.optional(import_cjs$17.string),
+		...import_cjs$20.optional(import_cjs$20.string),
 		displayName: "my-team"
 	}
 });
 /** Parser for the `--scope` option. */
-const scopeParser = import_cjs$17.option({
+const scopeParser = import_cjs$20.option({
 	long: "scope",
 	type: {
-		...import_cjs$17.optional(import_cjs$17.string),
+		...import_cjs$20.optional(import_cjs$20.string),
 		displayName: "my-team"
 	},
 	description: "The scope/team to associate with the command. Can be inferred from VERCEL_OIDC_TOKEN. [alias: --team]"
@@ -7425,7 +7426,7 @@ const scope = {
 
 //#endregion
 //#region package.json
-var version = "2.5.4";
+var version = "3.0.0-beta.1";
 
 //#endregion
 //#region src/error.ts
@@ -7446,6 +7447,7 @@ init_source();
 const sandboxClient = {
 	get: (params) => withErrorHandling(Sandbox.get({
 		fetch: fetchWithUserAgent,
+		resume: false,
 		...params
 	})),
 	create: (params) => withErrorHandling(Sandbox.create({
@@ -7515,9 +7517,9 @@ async function writeResponseToTemp({ response, text }) {
 
 //#endregion
 //#region src/args/snapshot-id.ts
-var import_cjs$16 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$19 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-const snapshotId = import_cjs$16.extendType(import_cjs$16.string, {
+const snapshotId = import_cjs$19.extendType(import_cjs$19.string, {
 	displayName: "snapshot_id",
 	description: "The ID of the snapshot",
 	async from(s$1) {
@@ -7527,16 +7529,16 @@ const snapshotId = import_cjs$16.extendType(import_cjs$16.string, {
 });
 
 //#endregion
-//#region src/args/sandbox-id.ts
-var import_cjs$15 = /* @__PURE__ */ __toESM(require_cjs());
+//#region src/args/sandbox-name.ts
+var import_cjs$18 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-const sandboxId = import_cjs$15.extendType(import_cjs$15.string, {
-	displayName: "sandbox_id",
-	description: "The ID of the sandbox to execute the command in",
+const sandboxName = import_cjs$18.extendType(import_cjs$18.string, {
+	displayName: "name",
+	description: "The name of the sandbox",
 	async from(s$1) {
-		if (!s$1.startsWith("sbx_")) throw new Error([
-			`Malformed sandbox ID: "${s$1}".`,
-			`${source_default.bold("hint:")} Sandbox IDs must start with 'sbx_' (e.g., sbx_abc123def456).`,
+		if (!s$1 || s$1.trim().length === 0) throw new Error([
+			`Sandbox name cannot be empty.`,
+			`${source_default.bold("hint:")} Provide a sandbox name.`,
 			"╰▶ run `sandbox list` to see available sandboxes."
 		].join("\n"));
 		return s$1;
@@ -7579,13 +7581,13 @@ var require_buffer_util = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pn
 	* @return {Buffer} The resulting buffer
 	* @public
 	*/
-	function concat$1(list$2, totalLength) {
-		if (list$2.length === 0) return EMPTY_BUFFER$3;
-		if (list$2.length === 1) return list$2[0];
+	function concat$1(list$3, totalLength) {
+		if (list$3.length === 0) return EMPTY_BUFFER$3;
+		if (list$3.length === 1) return list$3[0];
 		const target = Buffer.allocUnsafe(totalLength);
 		let offset = 0;
-		for (let i = 0; i < list$2.length; i++) {
-			const buf = list$2[i];
+		for (let i = 0; i < list$3.length; i++) {
+			const buf = list$3[i];
 			target.set(buf, offset);
 			offset += buf.length;
 		}
@@ -9154,13 +9156,13 @@ var require_sender = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/ws
 		* @param {Function} [cb] Callback
 		* @private
 		*/
-		sendFrame(list$2, cb) {
-			if (list$2.length === 2) {
+		sendFrame(list$3, cb) {
+			if (list$3.length === 2) {
 				this._socket.cork();
-				this._socket.write(list$2[0]);
-				this._socket.write(list$2[1], cb);
+				this._socket.write(list$3[0]);
+				this._socket.write(list$3[1], cb);
 				this._socket.uncork();
-			} else this._socket.write(list$2[0], cb);
+			} else this._socket.write(list$3[0], cb);
 		}
 	};
 	module.exports = Sender$2;
@@ -11244,9 +11246,9 @@ function printCommand(command$1, args$4) {
 
 //#endregion
 //#region src/interactive-shell/extend-sandbox-timeout.ts
-var import_ms$2 = /* @__PURE__ */ __toESM(require_ms());
+var import_ms$3 = /* @__PURE__ */ __toESM(require_ms());
 const debug$2 = createDebugger("sandbox:timeout");
-const BUFFER = (0, import_ms$2.default)("10 seconds");
+const BUFFER = (0, import_ms$3.default)("10 seconds");
 async function extendSandboxTimeoutPeriodically(sandbox, signal) {
 	const nextTick = sandbox.createdAt.getTime() + sandbox.timeout;
 	debug$2(`next tick: ${new Date(nextTick).toISOString()}`);
@@ -11256,7 +11258,7 @@ async function extendSandboxTimeoutPeriodically(sandbox, signal) {
 			debug$2(`sleeping for ${timeout$1}ms until next timeout extension`);
 			await setTimeout$1(timeout$1, null, { signal });
 		}
-		await sandbox.extendTimeout((0, import_ms$2.default)("5 minutes"));
+		await sandbox.extendTimeout((0, import_ms$3.default)("5 minutes"));
 		const nextTick$1 = sandbox.createdAt.getTime() + sandbox.timeout;
 		debug$2(`extended sandbox timeout by 5 minutes. next tick: ${new Date(nextTick$1).toISOString()}`);
 	}
@@ -11455,7 +11457,7 @@ async function attach({ progress, listener, printCommand: printCommand$1, sandbo
 		});
 		extensionController.abort("client disconnected");
 		client.close();
-		console.error(source_default.dim(`\n╰▶ connection to ▲ ${sandbox.sandboxId} closed.`));
+		console.error(source_default.dim(`\n╰▶ connection to ▲ ${sandbox.name} closed.`));
 	} catch (_) {
 		_usingCtx4.e = _;
 	} finally {
@@ -11522,9 +11524,9 @@ function getStderrStream() {
 
 //#endregion
 //#region src/args/key-value-pair.ts
-var import_cjs$14 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$17 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-const KeyValuePair = import_cjs$14.extendType(import_cjs$14.string, {
+const KeyValuePair = import_cjs$17.extendType(import_cjs$17.string, {
 	displayName: "key=value",
 	async from(input) {
 		if (!input.includes("=")) return {
@@ -11538,7 +11540,7 @@ const KeyValuePair = import_cjs$14.extendType(import_cjs$14.string, {
 		};
 	}
 });
-const ObjectFromKeyValue = import_cjs$14.extendType(import_cjs$14.array(KeyValuePair), { async from(input) {
+const ObjectFromKeyValue = import_cjs$17.extendType(import_cjs$17.array(KeyValuePair), { async from(input) {
 	const obj = Object.create(null);
 	const missingVars = [];
 	for (const { key, value } of input) if (value === void 0) missingVars.push(key);
@@ -11552,27 +11554,27 @@ const ObjectFromKeyValue = import_cjs$14.extendType(import_cjs$14.array(KeyValue
 
 //#endregion
 //#region src/commands/exec.ts
-var import_cjs$13 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$16 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
 const args$3 = {
-	sandbox: import_cjs$13.positional({ type: sandboxId }),
-	command: import_cjs$13.positional({
+	sandbox: import_cjs$16.positional({ type: sandboxName }),
+	command: import_cjs$16.positional({
 		displayName: "command",
 		description: "The executable to invoke"
 	}),
-	args: import_cjs$13.rest({
+	args: import_cjs$16.rest({
 		displayName: "args",
 		description: "arguments to pass to the command"
 	}),
-	asSudo: import_cjs$13.flag({
+	asSudo: import_cjs$16.flag({
 		long: "sudo",
 		description: "Give extended privileges to the command."
 	}),
-	interactive: import_cjs$13.flag({
+	interactive: import_cjs$16.flag({
 		long: "interactive",
 		short: "i",
 		description: "Run the command in a secure interactive shell",
-		type: import_cjs$13.extendType(import_cjs$13.boolean, {
+		type: import_cjs$16.extendType(import_cjs$16.boolean, {
 			defaultValue() {
 				return false;
 			},
@@ -11582,22 +11584,22 @@ const args$3 = {
 			}
 		})
 	}),
-	skipExtendingTimeout: import_cjs$13.flag({
+	skipExtendingTimeout: import_cjs$16.flag({
 		long: "no-extend-timeout",
 		description: "Do not extend the sandbox timeout while running an interactive command. Only affects interactive executions."
 	}),
-	tty: import_cjs$13.flag({
+	tty: import_cjs$16.flag({
 		long: "tty",
 		short: "t",
 		description: "Allocate a tty for an interactive command. This is a no-op."
 	}),
-	cwd: import_cjs$13.option({
+	cwd: import_cjs$16.option({
 		long: "workdir",
 		short: "w",
 		description: "The working directory to run the command in",
-		type: import_cjs$13.optional(import_cjs$13.string)
+		type: import_cjs$16.optional(import_cjs$16.string)
 	}),
-	envVars: import_cjs$13.multioption({
+	envVars: import_cjs$16.multioption({
 		long: "env",
 		short: "e",
 		type: ObjectFromKeyValue,
@@ -11605,28 +11607,18 @@ const args$3 = {
 	}),
 	scope
 };
-const exec = import_cjs$13.command({
+const exec = import_cjs$16.command({
 	name: "exec",
 	description: "Execute a command in an existing sandbox",
 	args: args$3,
-	async handler({ command: command$1, cwd, args: args$4, asSudo, sandbox: sandboxId$1, scope: { token: token$1, team: team$1, project: project$1 }, interactive, envVars, skipExtendingTimeout }) {
-		const sandbox = typeof sandboxId$1 !== "string" ? sandboxId$1 : await sandboxClient.get({
-			sandboxId: sandboxId$1,
+	async handler({ command: command$1, cwd, args: args$4, asSudo, sandbox: sandboxName$1, scope: { token: token$1, team: team$1, project: project$1 }, interactive, envVars, skipExtendingTimeout }) {
+		const sandbox = typeof sandboxName$1 !== "string" ? sandboxName$1 : await sandboxClient.get({
+			name: sandboxName$1,
 			projectId: project$1,
 			teamId: team$1,
 			token: token$1,
 			__includeSystemRoutes: true
 		});
-		if (!["pending", "running"].includes(sandbox.status)) {
-			console.error([
-				`Sandbox ${sandbox.sandboxId} is not available (status: ${sandbox.status}).`,
-				`${source_default.bold("hint:")} Only 'pending' or 'running' sandboxes can execute commands.`,
-				"├▶ Use `sandbox list` to check sandbox status.",
-				"╰▶ Use `sandbox create` to create a new sandbox."
-			].join("\n"));
-			process.exitCode = 1;
-			return;
-		}
 		if (!interactive) {
 			console.error(printCommand(command$1, args$4));
 			const result = await sandbox.runCommand({
@@ -11652,9 +11644,9 @@ const exec = import_cjs$13.command({
 
 //#endregion
 //#region src/args/network-policy.ts
-var import_cjs$12 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$15 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-const networkPolicyMode = import_cjs$12.extendType(import_cjs$12.string, {
+const networkPolicyMode = import_cjs$15.extendType(import_cjs$15.string, {
 	displayName: "MODE",
 	async from(value) {
 		const validModes = ["allow-all", "deny-all"];
@@ -11662,28 +11654,28 @@ const networkPolicyMode = import_cjs$12.extendType(import_cjs$12.string, {
 		return value;
 	}
 });
-const networkPolicy = import_cjs$12.option({
+const networkPolicy = import_cjs$15.option({
 	long: "network-policy",
 	description: `Network policy mode: "allow-all" or "deny-all"
       - allow-all: sandbox can access any website/domain
       - deny-all: sandbox has no network access
     Omit this option and use --allowed-domain / --allowed-cidr / --denied-cidr for custom policies.`,
-	type: import_cjs$12.optional(networkPolicyMode)
+	type: import_cjs$15.optional(networkPolicyMode)
 });
-const allowedDomains = import_cjs$12.multioption({
+const allowedDomains = import_cjs$15.multioption({
 	long: "allowed-domain",
 	description: `Domain to allow traffic to (creates a custom network policy). Supports "*" for wildcards for a segment (e.g. '*.vercel.com', 'www.*.com'). If used as the first segment, will match any subdomain.`,
-	type: import_cjs$12.array(import_cjs$12.string)
+	type: import_cjs$15.array(import_cjs$15.string)
 });
-const allowedCIDRs = import_cjs$12.multioption({
+const allowedCIDRs = import_cjs$15.multioption({
 	long: "allowed-cidr",
 	description: `CIDR to allow traffic to (creates a custom network policy). Takes precedence over 'allowed-domain'.`,
-	type: import_cjs$12.array(import_cjs$12.string)
+	type: import_cjs$15.array(import_cjs$15.string)
 });
-const deniedCIDRs = import_cjs$12.multioption({
+const deniedCIDRs = import_cjs$15.multioption({
 	long: "denied-cidr",
 	description: `CIDR to deny traffic to (creates a custom network policy). Takes precedence over allowed domains/CIDRs.`,
-	type: import_cjs$12.array(import_cjs$12.string)
+	type: import_cjs$15.array(import_cjs$15.string)
 });
 const networkPolicyArgs = {
 	networkPolicy,
@@ -11722,18 +11714,27 @@ function buildNetworkPolicy(args$4) {
 
 //#endregion
 //#region src/commands/create.ts
-var import_cjs$11 = /* @__PURE__ */ __toESM(require_cjs());
-var import_ms$1 = /* @__PURE__ */ __toESM(require_ms());
+var import_cjs$14 = /* @__PURE__ */ __toESM(require_cjs());
+var import_ms$2 = /* @__PURE__ */ __toESM(require_ms());
 init_source();
 const args$2 = {
+	name: import_cjs$14.option({
+		long: "name",
+		description: "A user-chosen name for the sandbox. It must be unique per project.",
+		type: import_cjs$14.optional(import_cjs$14.string)
+	}),
+	nonPersistent: import_cjs$14.flag({
+		long: "non-persistent",
+		description: "Disable automatic restore of the filesystem between sessions."
+	}),
 	runtime,
 	timeout,
 	vcpus,
-	ports: import_cjs$11.multioption({
+	ports: import_cjs$14.multioption({
 		long: "publish-port",
 		short: "p",
 		description: "Publish sandbox port(s) to DOMAIN.vercel.run",
-		type: import_cjs$11.array(import_cjs$11.extendType(import_cjs$11.number, {
+		type: import_cjs$14.array(import_cjs$14.extendType(import_cjs$14.number, {
 			displayName: "PORT",
 			async from(number) {
 				if (number < 1024 || number > 65535) throw new Error([
@@ -11745,21 +11746,21 @@ const args$2 = {
 			}
 		}))
 	}),
-	silent: import_cjs$11.flag({
+	silent: import_cjs$14.flag({
 		long: "silent",
-		description: "Don't write sandbox ID to stdout"
+		description: "Don't write sandbox name to stdout"
 	}),
-	snapshot: import_cjs$11.option({
+	snapshot: import_cjs$14.option({
 		long: "snapshot",
 		short: "s",
 		description: "Start the sandbox from a snapshot ID",
-		type: import_cjs$11.optional(snapshotId)
+		type: import_cjs$14.optional(snapshotId)
 	}),
-	connect: import_cjs$11.flag({
+	connect: import_cjs$14.flag({
 		long: "connect",
 		description: "Start an interactive shell session after creating the sandbox"
 	}),
-	envVars: import_cjs$11.multioption({
+	envVars: import_cjs$14.multioption({
 		long: "env",
 		short: "e",
 		type: ObjectFromKeyValue,
@@ -11768,7 +11769,7 @@ const args$2 = {
 	...networkPolicyArgs,
 	scope
 };
-const create = import_cjs$11.command({
+const create = import_cjs$14.command({
 	name: "create",
 	description: "Create a sandbox in the specified account and project.",
 	args: args$2,
@@ -11776,16 +11777,18 @@ const create = import_cjs$11.command({
 		description: "Create and connect to a sandbox without a network access",
 		command: `sandbox run --network-policy=none --connect`
 	}],
-	async handler({ ports, scope: scope$1, runtime: runtime$1, timeout: timeout$1, vcpus: vcpus$1, silent, snapshot: snapshot$1, connect: connect$2, envVars, networkPolicy: networkPolicyMode$1, allowedDomains: allowedDomains$1, allowedCIDRs: allowedCIDRs$1, deniedCIDRs: deniedCIDRs$1 }) {
+	async handler({ name, nonPersistent, ports, scope: scope$1, runtime: runtime$1, timeout: timeout$1, vcpus: vcpus$1, silent, snapshot: snapshot$1, connect: connect$2, envVars, networkPolicy: networkPolicyMode$1, allowedDomains: allowedDomains$1, allowedCIDRs: allowedCIDRs$1, deniedCIDRs: deniedCIDRs$1 }) {
 		const networkPolicy$1 = buildNetworkPolicy({
 			networkPolicy: networkPolicyMode$1,
 			allowedDomains: allowedDomains$1,
 			allowedCIDRs: allowedCIDRs$1,
 			deniedCIDRs: deniedCIDRs$1
 		});
+		const persistent = !nonPersistent;
 		const resources = vcpus$1 ? { vcpus: vcpus$1 } : void 0;
 		const spinner = silent ? void 0 : ora("Creating sandbox...").start();
 		const sandbox = snapshot$1 ? await sandboxClient.create({
+			name,
 			source: {
 				type: "snapshot",
 				snapshotId: snapshot$1
@@ -11794,21 +11797,24 @@ const create = import_cjs$11.command({
 			projectId: scope$1.project,
 			token: scope$1.token,
 			ports,
-			timeout: (0, import_ms$1.default)(timeout$1),
+			timeout: (0, import_ms$2.default)(timeout$1),
 			resources,
 			networkPolicy: networkPolicy$1,
 			env: envVars,
+			persistent,
 			__interactive: true
 		}) : await sandboxClient.create({
+			name,
 			teamId: scope$1.team,
 			projectId: scope$1.project,
 			token: scope$1.token,
 			ports,
 			runtime: runtime$1,
-			timeout: (0, import_ms$1.default)(timeout$1),
+			timeout: (0, import_ms$2.default)(timeout$1),
 			resources,
 			networkPolicy: networkPolicy$1,
 			env: envVars,
+			persistent,
 			__interactive: true
 		});
 		spinner?.stop();
@@ -11823,7 +11829,7 @@ const create = import_cjs$11.command({
 			const projectDisplay = scope$1.projectSlug ?? scope$1.project;
 			const hasPorts = routes.length > 0;
 			process.stderr.write("✅ Sandbox ");
-			process.stdout.write(source_default.cyan(sandbox.sandboxId));
+			process.stdout.write(source_default.cyan(sandbox.name));
 			process.stderr.write(" created.\n");
 			process.stderr.write(source_default.dim("   │ ") + "team: " + source_default.cyan(teamDisplay) + "\n");
 			if (hasPorts) {
@@ -11862,49 +11868,73 @@ function omit(obj, ...keys) {
 
 //#endregion
 //#region src/commands/run.ts
-var import_cjs$10 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$13 = /* @__PURE__ */ __toESM(require_cjs());
 const args$1 = {
 	...args$2,
 	...omit(args$3, "sandbox"),
-	removeAfterUse: import_cjs$10.flag({
+	removeAfterUse: import_cjs$13.flag({
 		long: "rm",
 		description: "Automatically remove the sandbox when the command exits."
 	})
 };
-const run = import_cjs$10.command({
+const run = import_cjs$13.command({
 	name: "run",
 	description: "Create and run a command in a sandbox",
 	args: args$1,
 	async handler({ removeAfterUse, ...rest$1 }) {
-		const sandbox = await create.handler({ ...rest$1 });
+		let sandbox;
+		if (rest$1.name) try {
+			sandbox = await sandboxClient.get({
+				name: rest$1.name,
+				projectId: rest$1.scope.project,
+				teamId: rest$1.scope.team,
+				token: rest$1.scope.token,
+				resume: true,
+				__includeSystemRoutes: true
+			});
+		} catch (error) {
+			if (error instanceof StyledError && error.cause instanceof APIError && error.cause.response.status === 404) sandbox = await create.handler({ ...rest$1 });
+			else throw error;
+		}
+		else sandbox = await create.handler({ ...rest$1 });
 		try {
 			await exec.handler({
 				...rest$1,
 				sandbox
 			});
 		} finally {
-			if (removeAfterUse) await sandbox.stop();
+			if (removeAfterUse) await sandbox.delete();
 		}
 	}
 });
 
 //#endregion
 //#region src/commands/list.ts
-var import_cjs$9 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$12 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-const list = import_cjs$9.command({
+const list = import_cjs$12.command({
 	name: "list",
 	aliases: ["ls"],
 	description: "List all sandboxes for the specified account and project.",
 	args: {
-		all: import_cjs$9.flag({
+		all: import_cjs$12.flag({
 			long: "all",
 			short: "a",
 			description: "Show all sandboxes (default shows just running)"
 		}),
+		namePrefix: import_cjs$12.option({
+			long: "name-prefix",
+			description: "Filter sandboxes by name prefix",
+			type: import_cjs$12.optional(import_cjs$12.string)
+		}),
+		sortBy: import_cjs$12.option({
+			long: "sort-by",
+			description: "Sort sandboxes by field. Options: createdAt (default), name",
+			type: import_cjs$12.optional(import_cjs$12.oneOf(["createdAt", "name"]))
+		}),
 		scope
 	},
-	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, all }) {
+	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, all, namePrefix, sortBy }) {
 		const sandboxes = await (async () => {
 			try {
 				var _usingCtx$1 = _usingCtx();
@@ -11913,7 +11943,9 @@ const list = import_cjs$9.command({
 					token: token$1,
 					teamId: team$1,
 					projectId: project$1,
-					limit: 100
+					limit: 100,
+					...namePrefix && { namePrefix },
+					...sortBy && { sortBy }
 				});
 				let sandboxes$1 = json.sandboxes;
 				if (!all) sandboxes$1 = sandboxes$1.filter((x) => x.status === "running");
@@ -11929,7 +11961,7 @@ const list = import_cjs$9.command({
 			unit: "megabyte"
 		});
 		const columns = {
-			ID: { value: (s$1) => s$1.id },
+			NAME: { value: (s$1) => s$1.name },
 			STATUS: {
 				value: (s$1) => s$1.status,
 				color: (s$1) => SandboxStatusColor[s$1.status] ?? source_default.reset
@@ -11939,11 +11971,11 @@ const list = import_cjs$9.command({
 			VCPUS: { value: (s$1) => s$1.vcpus },
 			RUNTIME: { value: (s$1) => s$1.runtime },
 			TIMEOUT: { value: (s$1) => timeAgo(s$1.createdAt + s$1.timeout) },
-			SNAPSHOT: { value: (s$1) => s$1.sourceSnapshotId ?? "-" }
+			SNAPSHOT: { value: (s$1) => s$1.currentSnapshotId ?? "-" }
 		};
 		if (all) {
-			columns.CPU = { value: (s$1) => s$1.activeCpuDurationMs ? formatRunDuration(s$1.activeCpuDurationMs) : "-" };
-			columns["NETWORK (OUT/IN)"] = { value: (s$1) => s$1.networkTransfer ? `${formatBytes(s$1.networkTransfer.egress)} / ${formatBytes(s$1.networkTransfer.ingress)}` : "- / -" };
+			columns.CPU = { value: (s$1) => s$1.totalActiveCpuDurationMs ? formatRunDuration(s$1.totalActiveCpuDurationMs) : "-" };
+			columns["NETWORK (OUT/IN)"] = { value: (s$1) => s$1.totalEgressBytes || s$1.totalIngressBytes ? `${formatBytes(s$1.totalEgressBytes ?? 0)} / ${formatBytes(s$1.totalIngressBytes ?? 0)}` : "- / -" };
 		}
 		console.log(table({
 			rows: sandboxes,
@@ -11963,8 +11995,8 @@ const SandboxStatusColor = {
 
 //#endregion
 //#region src/commands/connect.ts
-var import_cjs$8 = /* @__PURE__ */ __toESM(require_cjs());
-const connect = import_cjs$8.command({
+var import_cjs$11 = /* @__PURE__ */ __toESM(require_cjs());
+const connect = import_cjs$11.command({
 	name: "connect",
 	aliases: ["ssh", "shell"],
 	description: "Start an interactive shell in an existing sandbox",
@@ -14265,32 +14297,31 @@ var Listr = class {
 
 //#endregion
 //#region src/commands/stop.ts
-var import_cjs$7 = /* @__PURE__ */ __toESM(require_cjs());
-const stop = import_cjs$7.command({
+var import_cjs$10 = /* @__PURE__ */ __toESM(require_cjs());
+const stop = import_cjs$10.command({
 	name: "stop",
-	aliases: ["rm", "remove"],
-	description: "Stop one or more running sandboxes",
+	description: "Stop the current session of one or more sandboxes",
 	args: {
-		sandboxId: import_cjs$7.positional({
-			type: sandboxId,
-			description: "a sandbox ID to stop"
+		sandboxName: import_cjs$10.positional({
+			type: sandboxName,
+			description: "A sandbox name to stop"
 		}),
-		sandboxIds: import_cjs$7.restPositionals({
-			type: sandboxId,
-			description: "more sandboxes to stop"
+		sandboxNames: import_cjs$10.restPositionals({
+			type: sandboxName,
+			description: "More sandboxes to stop"
 		}),
 		scope
 	},
-	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandboxId: sandboxId$1, sandboxIds }) {
-		await new Listr(Array.from(new Set([sandboxId$1, ...sandboxIds]), (sandboxId$2) => {
+	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandboxName: sandboxName$1, sandboxNames }) {
+		await new Listr(Array.from(new Set([sandboxName$1, ...sandboxNames]), (sandboxName$2) => {
 			return {
-				title: `Stopping sandbox ${sandboxId$2}`,
+				title: `Stopping sandbox ${sandboxName$2}`,
 				async task() {
 					await (await sandboxClient.get({
 						token: token$1,
 						teamId: team$1,
 						projectId: project$1,
-						sandboxId: sandboxId$2
+						name: sandboxName$2
 					})).stop();
 				}
 			};
@@ -14298,9 +14329,46 @@ const stop = import_cjs$7.command({
 	}
 });
 
+//#endregion
+//#region src/commands/remove.ts
+var import_cjs$9 = /* @__PURE__ */ __toESM(require_cjs());
+const remove = import_cjs$9.command({
+	name: "remove",
+	aliases: ["rm"],
+	description: "Permanently remove one or more sandboxes",
+	args: {
+		sandboxName: import_cjs$9.positional({
+			type: sandboxName,
+			description: "a sandbox name to remove"
+		}),
+		sandboxNames: import_cjs$9.restPositionals({
+			type: sandboxName,
+			description: "more sandboxes to remove"
+		}),
+		preserveSnapshots: import_cjs$9.flag({
+			long: "preserve-snapshots",
+			description: "Keep snapshots when removing the sandbox"
+		}),
+		scope
+	},
+	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandboxName: sandboxName$1, sandboxNames, preserveSnapshots }) {
+		await new Listr(Array.from(new Set([sandboxName$1, ...sandboxNames]), (name) => ({
+			title: `Removing sandbox ${name}`,
+			async task() {
+				await (await sandboxClient.get({
+					token: token$1,
+					teamId: team$1,
+					projectId: project$1,
+					name
+				})).delete({ preserveSnapshots });
+			}
+		})), { concurrent: true }).run();
+	}
+});
+
 //#endregion
 //#region src/commands/cp.ts
-var import_cjs$6 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$8 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
 const parseLocalOrRemotePath = async (input) => {
 	const parts = input.split(":");
@@ -14308,12 +14376,12 @@ const parseLocalOrRemotePath = async (input) => {
 		const [id, path$1] = parts;
 		if (!id || !path$1) throw new Error([
 			`Invalid copy path format: "${input}".`,
-			`${source_default.bold("hint:")} Expected format: SANDBOX_ID:PATH (e.g., sbx_abc123:/home/user/file.txt).`,
+			`${source_default.bold("hint:")} Expected format: SANDBOX_NAME:PATH (e.g., my-sandbox:/home/user/file.txt).`,
 			"╰▶ Local paths should not contain colons."
 		].join("\n"));
 		return {
 			type: "remote",
-			sandboxId: await sandboxId.from(id),
+			sandboxName: await sandboxName.from(id),
 			path: path$1
 		};
 	}
@@ -14322,20 +14390,20 @@ const parseLocalOrRemotePath = async (input) => {
 		path: input
 	};
 };
-const localOrRemote = import_cjs$6.extendType(import_cjs$6.string, { from: parseLocalOrRemotePath });
-const cp = import_cjs$6.command({
+const localOrRemote = import_cjs$8.extendType(import_cjs$8.string, { from: parseLocalOrRemotePath });
+const cp = import_cjs$8.command({
 	name: "copy",
 	description: "Copy files between your local filesystem and a remote sandbox",
 	aliases: ["cp"],
 	args: {
-		source: import_cjs$6.positional({
+		source: import_cjs$8.positional({
 			displayName: `src`,
-			description: `The source file to copy from local file system, or or a sandbox_id:path from a remote sandbox`,
+			description: `The source file to copy from local file system, or a sandbox_name:path from a remote sandbox`,
 			type: localOrRemote
 		}),
-		dest: import_cjs$6.positional({
+		dest: import_cjs$8.positional({
 			displayName: `dst`,
-			description: `The destination file to copy to local file system, or or a sandbox_id:path to a remote sandbox`,
+			description: `The destination file to copy to local file system, or a sandbox_name:path to a remote sandbox`,
 			type: localOrRemote
 		}),
 		scope
@@ -14349,7 +14417,7 @@ const cp = import_cjs$6.command({
 		});
 		else {
 			const file = await (await sandboxClient.get({
-				sandboxId: source.sandboxId,
+				name: source.sandboxName,
 				teamId: scope$1.team,
 				token: scope$1.token,
 				projectId: scope$1.project
@@ -14359,14 +14427,14 @@ const cp = import_cjs$6.command({
 		if (!sourceFile) {
 			if (source.type === "remote") {
 				const dir = path.dirname(source.path);
-				spinner.fail([`File not found: ${source.path} in sandbox ${source.sandboxId}.`, `${source_default.bold("hint:")} Verify the file path exists using \`sandbox exec ${source.sandboxId} ls ${dir}\`.`].join("\n"));
+				spinner.fail([`File not found: ${source.path} in sandbox ${source.sandboxName}.`, `${source_default.bold("hint:")} Verify the file path exists using \`sandbox exec ${source.sandboxName} ls ${dir}\`.`].join("\n"));
 			} else spinner.fail(`Source file (${source.path}) not found.`);
 			return;
 		}
 		spinner.text = `Writing to destination file (${dest.path})...`;
 		if (dest.type === "local") await fs.writeFile(dest.path, sourceFile);
 		else await (await sandboxClient.get({
-			sandboxId: dest.sandboxId,
+			name: dest.sandboxName,
 			teamId: scope$1.team,
 			projectId: scope$1.project,
 			token: scope$1.token
@@ -14380,10 +14448,10 @@ const cp = import_cjs$6.command({
 
 //#endregion
 //#region src/commands/logout.ts
-var import_cjs$5 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$7 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
 const debug = createDebugger("sandbox:logout");
-const logout = import_cjs$5.command({
+const logout = import_cjs$7.command({
 	name: "logout",
 	description: "Log out of the Sandbox CLI",
 	args: {},
@@ -14402,45 +14470,45 @@ const logout = import_cjs$5.command({
 
 //#endregion
 //#region src/commands/snapshot.ts
-var import_cjs$4 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$6 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-var import_ms = /* @__PURE__ */ __toESM(require_ms());
+var import_ms$1 = /* @__PURE__ */ __toESM(require_ms());
 const args = {
-	stop: import_cjs$4.flag({
+	stop: import_cjs$6.flag({
 		long: "stop",
 		description: "Confirm that the sandbox will be stopped when snapshotting"
 	}),
-	silent: import_cjs$4.flag({
+	silent: import_cjs$6.flag({
 		long: "silent",
 		description: "Don't write snapshot ID to stdout"
 	}),
-	expiration: import_cjs$4.option({
+	expiration: import_cjs$6.option({
 		long: "expiration",
-		type: import_cjs$4.optional(Duration),
+		type: import_cjs$6.optional(Duration),
 		description: "The expiration time of the snapshot. Use 0 for no expiration."
 	}),
-	sandbox: import_cjs$4.positional({ type: sandboxId }),
+	sandbox: import_cjs$6.positional({ type: sandboxName }),
 	scope
 };
-const snapshot = import_cjs$4.command({
+const snapshot = import_cjs$6.command({
 	name: "snapshot",
 	description: "Take a snapshot of the filesystem of a sandbox",
 	args,
-	async handler({ sandbox: sandboxId$1, stop: stop$1, scope: { token: token$1, team: team$1, project: project$1 }, silent, expiration }) {
+	async handler({ sandbox: sandboxName$1, stop: stop$1, scope: { token: token$1, team: team$1, project: project$1 }, silent, expiration }) {
 		if (!stop$1) {
-			console.error(["Snapshotting a sandbox will automatically stop it.", `${source_default.bold("hint:")} Confirm with --stop to continue.`].join("\n"));
+			console.error(["Snapshotting will stop the current session of this sandbox.", `${source_default.bold("hint:")} Confirm with --stop to continue.`].join("\n"));
 			process.exitCode = 1;
 			return;
 		}
-		const sandbox = typeof sandboxId$1 !== "string" ? sandboxId$1 : await sandboxClient.get({
-			sandboxId: sandboxId$1,
+		const sandbox = typeof sandboxName$1 !== "string" ? sandboxName$1 : await sandboxClient.get({
+			name: sandboxName$1,
 			projectId: project$1,
 			teamId: team$1,
 			token: token$1
 		});
 		if (!["running"].includes(sandbox.status)) {
 			console.error([
-				`Sandbox ${sandbox.sandboxId} is not available (status: ${sandbox.status}).`,
+				`Sandbox ${sandbox.name} is not available (status: ${sandbox.status}).`,
 				`${source_default.bold("hint:")} Only 'running' sandboxes can be snapshotted.`,
 				"├▶ Use `sandbox list` to check sandbox status.",
 				"╰▶ Use `sandbox create` to create a new sandbox."
@@ -14449,17 +14517,17 @@ const snapshot = import_cjs$4.command({
 			return;
 		}
 		const spinner = silent ? void 0 : ora("Creating snapshot...").start();
-		const snapshot$1 = await sandbox.snapshot({ expiration: expiration === void 0 ? void 0 : (0, import_ms.default)(expiration) });
+		const snapshot$1 = await sandbox.snapshot({ expiration: expiration === void 0 ? void 0 : (0, import_ms$1.default)(expiration) });
 		spinner?.succeed(`Snapshot ${snapshot$1.snapshotId} created.`);
 	}
 });
 
 //#endregion
 //#region src/commands/snapshots.ts
-var import_cjs$2 = /* @__PURE__ */ __toESM(require_cjs());
-var import_cjs$3 = require_cjs();
+var import_cjs$4 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$5 = require_cjs();
 init_source();
-const list$1 = import_cjs$2.command({
+const list$2 = import_cjs$4.command({
 	name: "list",
 	aliases: ["ls"],
 	description: "List snapshots for the specified account and project.",
@@ -14493,19 +14561,19 @@ const list$1 = import_cjs$2.command({
 				CREATED: { value: (s$1) => timeAgo(s$1.createdAt) },
 				EXPIRATION: { value: (s$1) => s$1.status === "deleted" ? source_default.gray.dim("deleted") : timeAgo(s$1.expiresAt) },
 				SIZE: { value: (s$1) => formatBytes(s$1.sizeBytes) },
-				["SOURCE SANDBOX"]: { value: (s$1) => s$1.sourceSandboxId }
+				["SOURCE SESSION"]: { value: (s$1) => s$1.sourceSandboxId }
 			}
 		}));
 	}
 });
-const get = import_cjs$2.command({
+const get = import_cjs$4.command({
 	name: "get",
 	description: "Get details of a snapshot.",
 	args: {
 		scope,
-		snapshotId: import_cjs$2.positional({
+		snapshotId: import_cjs$4.positional({
 			type: snapshotId,
-			description: "snapshot ID to retrieve"
+			description: "Snapshot ID to retrieve"
 		})
 	},
 	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, snapshotId: id }) {
@@ -14536,21 +14604,21 @@ const get = import_cjs$2.command({
 				CREATED: { value: (s$1) => timeAgo(s$1.createdAt) },
 				EXPIRATION: { value: (s$1) => s$1.status === "deleted" ? source_default.gray.dim("deleted") : timeAgo(s$1.expiresAt) },
 				SIZE: { value: (s$1) => formatBytes(s$1.sizeBytes) },
-				["SOURCE SANDBOX"]: { value: (s$1) => s$1.sourceSandboxId }
+				["SOURCE SESSION"]: { value: (s$1) => s$1.sourceSandboxId }
 			}
 		}));
 	}
 });
-const remove = import_cjs$2.command({
+const remove$1 = import_cjs$4.command({
 	name: "delete",
 	aliases: ["rm", "remove"],
 	description: "Delete one or more snapshots.",
 	args: {
-		snapshotId: import_cjs$2.positional({
+		snapshotId: import_cjs$4.positional({
 			type: snapshotId,
-			description: "snapshot ID to delete"
+			description: "Snapshot ID to delete"
 		}),
-		snapshotIds: import_cjs$2.restPositionals({
+		snapshotIds: import_cjs$4.restPositionals({
 			type: snapshotId,
 			description: "More snapshots IDs to delete"
 		}),
@@ -14574,13 +14642,13 @@ const remove = import_cjs$2.command({
 		}), { concurrent: true }).run();
 	}
 });
-const snapshots = (0, import_cjs$3.subcommands)({
+const snapshots = (0, import_cjs$5.subcommands)({
 	name: "snapshots",
 	description: "Manage sandbox snapshots",
 	cmds: {
-		list: list$1,
+		list: list$2,
 		get,
-		delete: remove
+		delete: remove$1
 	}
 });
 const SnapshotStatusColor = new Map([
@@ -14589,16 +14657,201 @@ const SnapshotStatusColor = new Map([
 	["failed", source_default.red]
 ]);
 
+//#endregion
+//#region src/commands/sessions.ts
+var import_cjs$2 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$3 = require_cjs();
+init_source();
+const list$1 = import_cjs$2.command({
+	name: "list",
+	aliases: ["ls"],
+	description: "List sessions from a sandbox",
+	args: {
+		sandbox: import_cjs$2.positional({
+			type: sandboxName,
+			description: "Sandbox name to list sessions for"
+		}),
+		scope
+	},
+	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandbox: name }) {
+		const sandbox = await sandboxClient.get({
+			name,
+			projectId: project$1,
+			teamId: team$1,
+			token: token$1
+		});
+		const sessions$1 = (await (async () => {
+			try {
+				var _usingCtx$1 = _usingCtx();
+				const _spinner$1 = _usingCtx$1.u(acquireRelease(() => ora("Fetching sessions...").start(), (s$1) => s$1.stop()));
+				return sandbox.listSessions();
+			} catch (_) {
+				_usingCtx$1.e = _;
+			} finally {
+				_usingCtx$1.d();
+			}
+		})()).json.sandboxes;
+		console.log(table({
+			rows: sessions$1,
+			columns: {
+				ID: { value: (s$1) => s$1.id },
+				STATUS: {
+					value: (s$1) => s$1.status,
+					color: (s$1) => SessionStatusColor[s$1.status] ?? source_default.reset
+				},
+				CREATED: { value: (s$1) => timeAgo(s$1.createdAt) },
+				MEMORY: { value: (s$1) => s$1.memory },
+				VCPUS: { value: (s$1) => s$1.vcpus },
+				RUNTIME: { value: (s$1) => s$1.runtime },
+				TIMEOUT: { value: (s$1) => timeAgo(s$1.createdAt + s$1.timeout) },
+				DURATION: { value: (s$1) => s$1.duration ? formatRunDuration(s$1.duration) : "-" }
+			}
+		}));
+	}
+});
+const sessions = (0, import_cjs$3.subcommands)({
+	name: "sessions",
+	description: "Manage sandbox sessions",
+	cmds: { list: list$1 }
+});
+const SessionStatusColor = {
+	running: source_default.cyan,
+	failed: source_default.red,
+	stopped: source_default.gray.dim,
+	stopping: source_default.gray,
+	pending: source_default.magenta,
+	snapshotting: source_default.blue,
+	aborted: source_default.gray.dim
+};
+
 //#endregion
 //#region src/commands/config.ts
 var import_cjs$1 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
+var import_ms = /* @__PURE__ */ __toESM(require_ms());
+const setCommand = import_cjs$1.command({
+	name: "set",
+	description: "Update the configuration of a sandbox",
+	args: {
+		sandbox: import_cjs$1.positional({
+			type: sandboxName,
+			description: "Sandbox name to update"
+		}),
+		vcpus,
+		runtime: import_cjs$1.option({
+			long: "runtime",
+			type: import_cjs$1.optional(runtimeType),
+			description: "Runtime to use: node22, node24, or python3.13"
+		}),
+		timeout: import_cjs$1.option({
+			long: "timeout",
+			type: import_cjs$1.optional(Duration),
+			description: "The maximum duration a sandbox can run for. Example: 5m, 1h"
+		}),
+		...networkPolicyArgs,
+		scope
+	},
+	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandbox: name, vcpus: vcpus$1, runtime: runtime$1, timeout: timeout$1, networkPolicy: networkPolicyMode$1, allowedDomains: allowedDomains$1, allowedCIDRs: allowedCIDRs$1, deniedCIDRs: deniedCIDRs$1 }) {
+		const hasNetworkPolicyArgs = networkPolicyMode$1 !== void 0 || allowedDomains$1.length > 0 || allowedCIDRs$1.length > 0 || deniedCIDRs$1.length > 0;
+		if (vcpus$1 === void 0 && runtime$1 === void 0 && timeout$1 === void 0 && !hasNetworkPolicyArgs) throw new Error([`At least one option must be provided.`, `${source_default.bold("hint:")} Use --vcpus, --runtime, --timeout, or --network-policy to update the sandbox configuration.`].join("\n"));
+		const networkPolicy$1 = hasNetworkPolicyArgs ? buildNetworkPolicy({
+			networkPolicy: networkPolicyMode$1,
+			allowedDomains: allowedDomains$1,
+			allowedCIDRs: allowedCIDRs$1,
+			deniedCIDRs: deniedCIDRs$1
+		}) : void 0;
+		const sandbox = await sandboxClient.get({
+			name,
+			projectId: project$1,
+			teamId: team$1,
+			token: token$1
+		});
+		const spinner = ora("Updating sandbox configuration...").start();
+		try {
+			await sandbox.update({
+				...vcpus$1 !== void 0 && { resources: { vcpus: vcpus$1 } },
+				...runtime$1 !== void 0 && { runtime: runtime$1 },
+				...timeout$1 !== void 0 && { timeout: (0, import_ms.default)(timeout$1) },
+				...networkPolicy$1 !== void 0 && { networkPolicy: networkPolicy$1 }
+			});
+			spinner.succeed("Configuration updated for sandbox " + source_default.cyan(name));
+		} catch (error) {
+			spinner.stop();
+			throw error;
+		}
+	}
+});
+const getCommand = import_cjs$1.command({
+	name: "get",
+	description: "Display the current configuration of a sandbox",
+	args: {
+		sandbox: import_cjs$1.positional({
+			type: sandboxName,
+			description: "Sandbox name to inspect"
+		}),
+		scope
+	},
+	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandbox: name }) {
+		const sandbox = await (async () => {
+			try {
+				var _usingCtx$1 = _usingCtx();
+				const _spinner$1 = _usingCtx$1.u(acquireRelease(() => ora("Fetching sandbox configuration...").start(), (s$1) => s$1.stop()));
+				return sandboxClient.get({
+					name,
+					projectId: project$1,
+					teamId: team$1,
+					token: token$1
+				});
+			} catch (_) {
+				_usingCtx$1.e = _;
+			} finally {
+				_usingCtx$1.d();
+			}
+		})();
+		const memoryFormatter = new Intl.NumberFormat(void 0, {
+			style: "unit",
+			unit: "megabyte"
+		});
+		const rows = [
+			{
+				field: "Runtime",
+				value: sandbox.runtime
+			},
+			{
+				field: "vCPUs",
+				value: String(sandbox.vcpus)
+			},
+			{
+				field: "Memory",
+				value: memoryFormatter.format(sandbox.memory)
+			},
+			{
+				field: "Timeout",
+				value: (0, import_ms.default)(sandbox.timeout, { long: true })
+			},
+			{
+				field: "Region",
+				value: sandbox.region
+			}
+		];
+		console.log(table({
+			rows,
+			columns: {
+				FIELD: {
+					value: (r) => r.field,
+					color: () => source_default.bold
+				},
+				VALUE: { value: (r) => r.value }
+			}
+		}));
+	}
+});
 const networkPolicyCommand = import_cjs$1.command({
 	name: "network-policy",
 	description: `Update the network policy of a sandbox.
   This will fully override the previous configuration.`,
 	args: {
-		sandbox: import_cjs$1.positional({ type: sandboxId }),
+		sandbox: import_cjs$1.positional({ type: sandboxName }),
 		...networkPolicyArgs,
 		mode: import_cjs$1.option({
 			long: "mode",
@@ -14607,7 +14860,8 @@ const networkPolicyCommand = import_cjs$1.command({
 		}),
 		scope
 	},
-	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandbox: sandboxId$1, networkPolicy: networkPolicyFlag, mode: modeFlag, allowedDomains: allowedDomains$1, allowedCIDRs: allowedCIDRs$1, deniedCIDRs: deniedCIDRs$1 }) {
+	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandbox: sandboxName$1, networkPolicy: networkPolicyFlag, mode: modeFlag, allowedDomains: allowedDomains$1, allowedCIDRs: allowedCIDRs$1, deniedCIDRs: deniedCIDRs$1 }) {
+		process.stderr.write(source_default.yellow("Warning: 'config network-policy' is deprecated. Use 'config set --network-policy=...' instead.\n"));
 		const networkPolicyMode$1 = resolveMode(networkPolicyFlag, modeFlag);
 		if (networkPolicyMode$1 === void 0 && allowedDomains$1.length === 0 && allowedCIDRs$1.length === 0 && deniedCIDRs$1.length === 0) throw new Error(`Network policy mode or custom rules must be set.`);
 		const networkPolicy$1 = buildNetworkPolicy({
@@ -14616,27 +14870,17 @@ const networkPolicyCommand = import_cjs$1.command({
 			allowedCIDRs: allowedCIDRs$1,
 			deniedCIDRs: deniedCIDRs$1
 		});
-		const sandbox = typeof sandboxId$1 !== "string" ? sandboxId$1 : await sandboxClient.get({
-			sandboxId: sandboxId$1,
+		const sandbox = typeof sandboxName$1 !== "string" ? sandboxName$1 : await sandboxClient.get({
+			name: sandboxName$1,
 			projectId: project$1,
 			teamId: team$1,
 			token: token$1
 		});
-		if (!["pending", "running"].includes(sandbox.status)) {
-			console.error([
-				`Sandbox ${sandbox.sandboxId} is not available (status: ${sandbox.status}).`,
-				`${source_default.bold("hint:")} Only 'pending' or 'running' sandboxes can execute commands.`,
-				"├▶ Use `sandbox list` to check sandbox status.",
-				"╰▶ Use `sandbox create` to create a new sandbox."
-			].join("\n"));
-			process.exitCode = 1;
-			return;
-		}
 		const spinner = ora("Updating network policy...").start();
 		try {
 			const response = await sandbox.updateNetworkPolicy(networkPolicy$1);
 			spinner.stop();
-			process.stderr.write("✅ Network policy updated for sandbox " + source_default.cyan(sandbox.sandboxId) + "\n");
+			process.stderr.write("✅ Network policy updated for sandbox " + source_default.cyan(sandbox.name) + "\n");
 			const mode = typeof response === "string" ? response : "restricted";
 			process.stderr.write(source_default.dim("   ╰ ") + "mode: " + source_default.cyan(mode) + "\n");
 		} catch (error) {
@@ -14647,8 +14891,12 @@ const networkPolicyCommand = import_cjs$1.command({
 });
 const config = import_cjs$1.subcommands({
 	name: "config",
-	description: "Update a sandbox configuration",
-	cmds: { "network-policy": networkPolicyCommand }
+	description: "View and update sandbox configuration",
+	cmds: {
+		set: setCommand,
+		get: getCommand,
+		"network-policy": networkPolicyCommand
+	}
 });
 
 //#endregion
@@ -14666,9 +14914,11 @@ const app = (opts) => (0, import_cjs.subcommands)({
 		exec,
 		connect,
 		stop,
+		remove,
 		run,
 		snapshot,
 		snapshots,
+		sessions,
 		...!opts?.withoutAuth && {
 			login,
 			logout
@@ -14685,11 +14935,11 @@ const app = (opts) => (0, import_cjs.subcommands)({
 		},
 		{
 			description: "Execute command in an existing sandbox",
-			command: `sandbox exec <sandbox-id> -- npm test`
+			command: `sandbox exec <name> -- npm test`
 		}
 	]
 });
 
 //#endregion
 export { source_exports as a, init_source as i, StyledError as n, require_cjs as r, app as t };
-//# sourceMappingURL=app-6okY2haN.mjs.map
+//# sourceMappingURL=app-AqqXdE-N.mjs.map