sandbox 3.0.0-beta.23 → 3.0.0-beta.25

package/dist/{app-BjVyEIk1.mjs → app-BdOGNXsw.mjs}

@@ -2998,9 +2998,9 @@ var require_cjs = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-t
 
 //#endregion
 //#region src/args/runtime.ts
-var import_cjs$27 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$28 = /* @__PURE__ */ __toESM(require_cjs());
 const runtimeType = {
-	...import_cjs$27.oneOf([
+	...import_cjs$28.oneOf([
 		"node22",
 		"node24",
 		"node26",
@@ -3008,7 +3008,7 @@ const runtimeType = {
 	]),
 	displayName: "runtime"
 };
-const runtime = import_cjs$27.option({
+const runtime = import_cjs$28.option({
 	long: "runtime",
 	type: runtimeType,
 	defaultValue: () => "node24",
@@ -3136,9 +3136,9 @@ var require_ms = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/ms@2.1
 
 //#endregion
 //#region src/types/duration.ts
-var import_cjs$26 = require_cjs();
+var import_cjs$27 = require_cjs();
 init_source();
-const Duration = (0, import_cjs$26.extendType)(import_cjs$26.string, {
+const Duration = (0, import_cjs$27.extendType)(import_cjs$27.string, {
 	displayName: "num UNIT",
 	description: "A duration, e.g. 5m, 10s, 1h",
 	async from(string$2) {
@@ -3154,8 +3154,8 @@ const Duration = (0, import_cjs$26.extendType)(import_cjs$26.string, {
 
 //#endregion
 //#region src/args/timeout.ts
-var import_cjs$25 = /* @__PURE__ */ __toESM(require_cjs());
-const timeout = import_cjs$25.option({
+var import_cjs$26 = /* @__PURE__ */ __toESM(require_cjs());
+const timeout = import_cjs$26.option({
 	long: "timeout",
 	type: Duration,
 	description: "The maximum duration a sandbox can run for. Example: 5m, 30m",
@@ -3165,17 +3165,17 @@ const timeout = import_cjs$25.option({
 
 //#endregion
 //#region src/args/vcpus.ts
-var import_cjs$24 = /* @__PURE__ */ __toESM(require_cjs());
-const vcpusType = import_cjs$24.extendType(import_cjs$24.number, {
+var import_cjs$25 = /* @__PURE__ */ __toESM(require_cjs());
+const vcpusType = import_cjs$25.extendType(import_cjs$25.number, {
 	displayName: "COUNT",
 	async from(n) {
 		if (!Number.isInteger(n) || n < 1) throw new Error(`Invalid vCPU count: ${n}. Must be a positive integer.`);
 		return n;
 	}
 });
-const vcpus = import_cjs$24.option({
+const vcpus = import_cjs$25.option({
 	long: "vcpus",
-	type: import_cjs$24.optional(vcpusType),
+	type: import_cjs$25.optional(vcpusType),
 	description: "Number of vCPUs to allocate (each vCPU includes 2048 MB of memory)"
 });
 
@@ -6754,10 +6754,10 @@ function _usingCtx() {
 
 //#endregion
 //#region src/commands/login.ts
-var import_cjs$23 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$24 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
 const debug$6 = createDebugger("sandbox:login");
-const login = import_cjs$23.command({
+const login = import_cjs$24.command({
 	name: "login",
 	description: "Log in to the Sandbox CLI",
 	args: {},
@@ -6975,7 +6975,7 @@ var require_dist = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/@ver
 
 //#endregion
 //#region src/args/auth.ts
-var import_cjs$22 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$23 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
 var import_dist = require_dist();
 const debug$5 = createDebugger("sandbox:args:auth");
@@ -6992,11 +6992,11 @@ function isTokenFresh() {
 function markTokenAsFresh() {
 	freshTokenAcquiredAt = Date.now();
 }
-const token = import_cjs$22.option({
+const token = import_cjs$23.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$22.string,
+		...import_cjs$23.string,
 		displayName: "pat_or_oidc",
 		defaultValueIsSerializable: false,
 		onMissing: async () => {
@@ -7179,29 +7179,29 @@ function getAuthFailureStatus(error) {
 
 //#endregion
 //#region src/args/scope.ts
-var import_cjs$21 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$22 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-const project = import_cjs$21.option({
+const project = import_cjs$22.option({
 	long: "project",
 	type: {
-		...import_cjs$21.optional(import_cjs$21.string),
+		...import_cjs$22.optional(import_cjs$22.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$21.option({
+const teamParser = import_cjs$22.option({
 	long: "team",
 	type: {
-		...import_cjs$21.optional(import_cjs$21.string),
+		...import_cjs$22.optional(import_cjs$22.string),
 		displayName: "my-team"
 	}
 });
 /** Parser for the `--scope` option. */
-const scopeParser = import_cjs$21.option({
+const scopeParser = import_cjs$22.option({
 	long: "scope",
 	type: {
-		...import_cjs$21.optional(import_cjs$21.string),
+		...import_cjs$22.optional(import_cjs$22.string),
 		displayName: "my-team"
 	},
 	description: "The scope/team to associate with the command. Can be inferred from VERCEL_OIDC_TOKEN. [alias: --team]"
@@ -7290,7 +7290,7 @@ const scope = {
 
 //#endregion
 //#region package.json
-var version = "3.0.0-beta.23";
+var version = "3.0.0-beta.25";
 
 //#endregion
 //#region src/error.ts
@@ -7332,6 +7332,10 @@ const snapshotClient = {
 	fromSandbox: (name, opts) => withErrorHandling(() => Snapshot.fromSandbox(name, {
 		fetch: fetchWithUserAgent,
 		...opts
+	})),
+	tree: (params) => withErrorHandling(() => Snapshot.tree({
+		fetch: fetchWithUserAgent,
+		...params
 	}))
 };
 const fetchWithUserAgent = (input, init$1) => {
@@ -7385,9 +7389,9 @@ async function writeResponseToTemp({ response, text }) {
 
 //#endregion
 //#region src/args/snapshot-id.ts
-var import_cjs$20 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$21 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-const snapshotId = import_cjs$20.extendType(import_cjs$20.string, {
+const snapshotId = import_cjs$21.extendType(import_cjs$21.string, {
 	displayName: "snapshot_id",
 	description: "The ID of the snapshot",
 	async from(s$1) {
@@ -7398,9 +7402,9 @@ const snapshotId = import_cjs$20.extendType(import_cjs$20.string, {
 
 //#endregion
 //#region src/args/sandbox-name.ts
-var import_cjs$19 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$20 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-const sandboxName = import_cjs$19.extendType(import_cjs$19.string, {
+const sandboxName = import_cjs$20.extendType(import_cjs$20.string, {
 	displayName: "name",
 	description: "The name of the sandbox",
 	async from(s$1) {
@@ -11405,9 +11409,9 @@ function getStderrStream() {
 
 //#endregion
 //#region src/args/key-value-pair.ts
-var import_cjs$18 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$19 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-const KeyValuePair = import_cjs$18.extendType(import_cjs$18.string, {
+const KeyValuePair = import_cjs$19.extendType(import_cjs$19.string, {
 	displayName: "key=value",
 	async from(input) {
 		if (!input.includes("=")) return {
@@ -11421,7 +11425,7 @@ const KeyValuePair = import_cjs$18.extendType(import_cjs$18.string, {
 		};
 	}
 });
-const ObjectFromKeyValue = import_cjs$18.extendType(import_cjs$18.array(KeyValuePair), { async from(input) {
+const ObjectFromKeyValue = import_cjs$19.extendType(import_cjs$19.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);
@@ -11435,27 +11439,27 @@ const ObjectFromKeyValue = import_cjs$18.extendType(import_cjs$18.array(KeyValue
 
 //#endregion
 //#region src/commands/exec.ts
-var import_cjs$17 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$18 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
 const args$3 = {
-	sandbox: import_cjs$17.positional({ type: sandboxName }),
-	command: import_cjs$17.positional({
+	sandbox: import_cjs$18.positional({ type: sandboxName }),
+	command: import_cjs$18.positional({
 		displayName: "command",
 		description: "The executable to invoke"
 	}),
-	args: import_cjs$17.rest({
+	args: import_cjs$18.rest({
 		displayName: "args",
 		description: "arguments to pass to the command"
 	}),
-	asSudo: import_cjs$17.flag({
+	asSudo: import_cjs$18.flag({
 		long: "sudo",
 		description: "Give extended privileges to the command."
 	}),
-	interactive: import_cjs$17.flag({
+	interactive: import_cjs$18.flag({
 		long: "interactive",
 		short: "i",
 		description: "Run the command in a secure interactive shell",
-		type: import_cjs$17.extendType(import_cjs$17.boolean, {
+		type: import_cjs$18.extendType(import_cjs$18.boolean, {
 			defaultValue() {
 				return false;
 			},
@@ -11465,22 +11469,22 @@ const args$3 = {
 			}
 		})
 	}),
-	skipExtendingTimeout: import_cjs$17.flag({
+	skipExtendingTimeout: import_cjs$18.flag({
 		long: "no-extend-timeout",
 		description: "Do not extend the sandbox timeout while running an interactive command. Only affects interactive executions."
 	}),
-	tty: import_cjs$17.flag({
+	tty: import_cjs$18.flag({
 		long: "tty",
 		short: "t",
 		description: "Allocate a tty for an interactive command. This is a no-op."
 	}),
-	cwd: import_cjs$17.option({
+	cwd: import_cjs$18.option({
 		long: "workdir",
 		short: "w",
 		description: "The working directory to run the command in",
-		type: import_cjs$17.optional(import_cjs$17.string)
+		type: import_cjs$18.optional(import_cjs$18.string)
 	}),
-	envVars: import_cjs$17.multioption({
+	envVars: import_cjs$18.multioption({
 		long: "env",
 		short: "e",
 		type: ObjectFromKeyValue,
@@ -11488,7 +11492,7 @@ const args$3 = {
 	}),
 	scope
 };
-const exec = import_cjs$17.command({
+const exec = import_cjs$18.command({
 	name: "exec",
 	description: "Execute a command in an existing sandbox",
 	args: args$3,
@@ -11525,9 +11529,9 @@ const exec = import_cjs$17.command({
 
 //#endregion
 //#region src/args/network-policy.ts
-var import_cjs$16 = /* @__PURE__ */ __toESM(require_cjs());
+var import_cjs$17 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
-const networkPolicyMode = import_cjs$16.extendType(import_cjs$16.string, {
+const networkPolicyMode = import_cjs$17.extendType(import_cjs$17.string, {
 	displayName: "MODE",
 	async from(value) {
 		const validModes = ["allow-all", "deny-all"];
@@ -11535,28 +11539,28 @@ const networkPolicyMode = import_cjs$16.extendType(import_cjs$16.string, {
 		return value;
 	}
 });
-const networkPolicy = import_cjs$16.option({
+const networkPolicy = import_cjs$17.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$16.optional(networkPolicyMode)
+	type: import_cjs$17.optional(networkPolicyMode)
 });
-const allowedDomains = import_cjs$16.multioption({
+const allowedDomains = import_cjs$17.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$16.array(import_cjs$16.string)
+	type: import_cjs$17.array(import_cjs$17.string)
 });
-const allowedCIDRs = import_cjs$16.multioption({
+const allowedCIDRs = import_cjs$17.multioption({
 	long: "allowed-cidr",
 	description: `CIDR to allow traffic to (creates a custom network policy). Takes precedence over 'allowed-domain'.`,
-	type: import_cjs$16.array(import_cjs$16.string)
+	type: import_cjs$17.array(import_cjs$17.string)
 });
-const deniedCIDRs = import_cjs$16.multioption({
+const deniedCIDRs = import_cjs$17.multioption({
 	long: "denied-cidr",
 	description: `CIDR to deny traffic to (creates a custom network policy). Takes precedence over allowed domains/CIDRs.`,
-	type: import_cjs$16.array(import_cjs$16.string)
+	type: import_cjs$17.array(import_cjs$17.string)
 });
 const networkPolicyArgs = {
 	networkPolicy,
@@ -11595,8 +11599,8 @@ function buildNetworkPolicy(args$4) {
 
 //#endregion
 //#region src/types/snapshot-expiration.ts
-var import_cjs$15 = require_cjs();
-const SnapshotExpiration = (0, import_cjs$15.extendType)(import_cjs$15.string, {
+var import_cjs$16 = require_cjs();
+const SnapshotExpiration = (0, import_cjs$16.extendType)(import_cjs$16.string, {
 	displayName: "DURATION|none",
 	description: "A duration (e.g. 7d, 30d) or \"none\" for no expiration",
 	async from(value) {
@@ -11605,6 +11609,27 @@ const SnapshotExpiration = (0, import_cjs$15.extendType)(import_cjs$15.string, {
 	}
 });
 
+//#endregion
+//#region src/args/ports.ts
+var import_cjs$15 = /* @__PURE__ */ __toESM(require_cjs());
+init_source();
+const publishPorts = import_cjs$15.multioption({
+	long: "publish-port",
+	short: "p",
+	description: "Publish sandbox port(s) to DOMAIN.vercel.run",
+	type: import_cjs$15.array(import_cjs$15.extendType(import_cjs$15.number, {
+		displayName: "PORT",
+		async from(number) {
+			if (!Number.isInteger(number) || number < 1024 || number > 65535) throw new Error([
+				`Invalid port: ${number}.`,
+				`${source_default.bold("hint:")} Ports must be integers between 1024-65535 (privileged ports 0-1023 are reserved).`,
+				"Examples: 3000, 8443"
+			].join("\n"));
+			return number;
+		}
+	}))
+});
+
 //#endregion
 //#region src/commands/create.ts
 var import_cjs$14 = /* @__PURE__ */ __toESM(require_cjs());
@@ -11623,22 +11648,7 @@ const args$2 = {
 	runtime,
 	timeout,
 	vcpus,
-	ports: import_cjs$14.multioption({
-		long: "publish-port",
-		short: "p",
-		description: "Publish sandbox port(s) to DOMAIN.vercel.run",
-		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([
-					`Invalid port: ${number}.`,
-					`${source_default.bold("hint:")} Ports must be between 1024-65535 (privileged ports 0-1023 are reserved).`,
-					"╰▶ Examples: 3000, 8080, 8443"
-				].join("\n"));
-				return number;
-			}
-		}))
-	}),
+	ports: publishPorts,
 	silent: import_cjs$14.flag({
 		long: "silent",
 		description: "Don't write sandbox name to stdout"
@@ -14587,6 +14597,75 @@ const snapshot = import_cjs$6.command({
 	}
 });
 
+//#endregion
+//#region src/util/snapshot-tree.ts
+init_source();
+function formatExpires(expiresAt) {
+	if (expiresAt === void 0) return source_default.gray("never");
+	const ms$4 = expiresAt - Date.now();
+	if (ms$4 <= 0) return source_default.red("expired");
+	const formatted = timeAgo(expiresAt);
+	return ms$4 <= 3600 * 1e3 ? source_default.red(formatted) : source_default.green(formatted);
+}
+function renderNode(id, expiresAt, isCurrent) {
+	const bullet = isCurrent ? source_default.magenta.bold("●") : source_default.magenta("●");
+	const suffix = isCurrent ? `  ${source_default.green("◂ current")}` : "";
+	return `${bullet} ${source_default.yellow(id)}   expires: ${formatExpires(expiresAt)}${suffix}`;
+}
+function renderSiblings(siblings, count) {
+	const lines = [];
+	const shown = siblings.slice(0, 5);
+	const totalCount = parseInt(count, 10);
+	const hasPlus = count.endsWith("+");
+	const remaining = totalCount - 1 - shown.length;
+	for (let i = 0; i < shown.length; i++) {
+		const connector = i === shown.length - 1 && remaining <= 0 ? "╰──" : "├──";
+		lines.push(`│   ${connector} ${source_default.gray(shown[i].sourceSessionId)}`);
+	}
+	if (remaining > 0) {
+		const suffix = hasPlus ? "+" : "";
+		lines.push(`│   ╰── ${source_default.gray(`+${remaining}${suffix} more sandboxes`)}`);
+	}
+	return lines;
+}
+function renderSnapshotTree(params) {
+	const { ancestors, descendants } = params;
+	const hideCurrent = params.hideCurrent === true;
+	const currentSnapshotId = hideCurrent ? void 0 : params.currentSnapshotId;
+	const lines = [];
+	const pushNode = (node, isCurrent) => {
+		lines.push("│");
+		lines.push(renderNode(node.snapshot.id, node.snapshot.expiresAt, isCurrent));
+		if (node.siblings.length > 0) lines.push(...renderSiblings(node.siblings, node.count));
+	};
+	const descendantNodes = descendants.snapshots.filter((n) => n.snapshot.id !== currentSnapshotId);
+	if (descendantNodes.length > 0) for (const node of [...descendantNodes].reverse()) pushNode(node, false);
+	if (!hideCurrent) {
+		const { currentSnapshotId: id, currentSnapshotExpiresAt } = params;
+		pushNode(ancestors.snapshots.find((n) => n.snapshot.id === id) ?? descendants.snapshots.find((n) => n.snapshot.id === id) ?? {
+			snapshot: {
+				id,
+				sourceSessionId: "",
+				expiresAt: currentSnapshotExpiresAt
+			},
+			siblings: [],
+			count: "1"
+		}, true);
+	}
+	const ancestorNodes = ancestors.snapshots.filter((n) => n.snapshot.id !== currentSnapshotId);
+	for (const node of ancestorNodes) pushNode(node, false);
+	if (!hideCurrent) {
+		const lastAncestor = ancestorNodes[ancestorNodes.length - 1];
+		if (ancestors.pagination.next === null) {
+			if (lastAncestor && !lastAncestor.snapshot.parentId || ancestorNodes.length === 0) {
+				lines.push("│");
+				lines.push(`${source_default.white("○")} ${source_default.gray("(root)")}`);
+			}
+		}
+	}
+	return lines.join("\n");
+}
+
 //#endregion
 //#region src/commands/snapshots.ts
 var import_cjs$4 = /* @__PURE__ */ __toESM(require_cjs());
@@ -14737,12 +14816,154 @@ const remove$1 = import_cjs$4.command({
 		}
 	}
 });
+const tree = import_cjs$4.command({
+	name: "tree",
+	description: "Show the snapshot ancestry tree for a sandbox.",
+	args: {
+		scope,
+		sandboxName: import_cjs$4.positional({
+			type: sandboxName,
+			description: "Sandbox name"
+		}),
+		sortOrder: import_cjs$4.option({
+			long: "sort-order",
+			description: "Sort order. Options: asc, desc (default). 'desc' walks ancestors, 'asc' walks descendants. Requires --cursor.",
+			type: import_cjs$4.optional(import_cjs$4.oneOf(["asc", "desc"]))
+		}),
+		limit: import_cjs$4.option({
+			long: "limit",
+			description: "Maximum number of snapshots per page (1–10, default 10).",
+			type: import_cjs$4.optional(import_cjs$4.number)
+		}),
+		cursor: import_cjs$4.option({
+			long: "cursor",
+			description: "Pagination cursor from a previous 'More ancestors' or 'More descendants' hint.",
+			type: import_cjs$4.optional(import_cjs$4.string)
+		})
+	},
+	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandboxName: name, sortOrder, limit, cursor }) {
+		if (limit !== void 0 && (limit < 1 || limit > 10)) {
+			console.error(source_default.red("Error: --limit must be between 1 and 10."));
+			process.exitCode = 1;
+			return;
+		}
+		if (sortOrder !== void 0 && !cursor) {
+			console.error(source_default.red("Error: --sort-order requires --cursor."));
+			process.exitCode = 1;
+			return;
+		}
+		const pageLimit = limit ?? 10;
+		if (cursor) {
+			const effectiveSortOrder = sortOrder ?? "desc";
+			const page = await (async () => {
+				try {
+					var _usingCtx4 = _usingCtx();
+					const _spinner$1 = _usingCtx4.u(acquireRelease(() => ora("Fetching snapshot tree...").start(), (s$1) => s$1.stop()));
+					return snapshotClient.tree({
+						snapshotId: cursor,
+						sortOrder: effectiveSortOrder,
+						limit: pageLimit,
+						token: token$1,
+						teamId: team$1,
+						projectId: project$1
+					});
+				} catch (_) {
+					_usingCtx4.e = _;
+				} finally {
+					_usingCtx4.d();
+				}
+			})();
+			const ancestors = effectiveSortOrder === "desc" ? page : {
+				snapshots: [],
+				pagination: {
+					count: 0,
+					next: null
+				}
+			};
+			const descendants = effectiveSortOrder === "asc" ? page : {
+				snapshots: [],
+				pagination: {
+					count: 0,
+					next: null
+				}
+			};
+			console.log(renderSnapshotTree({
+				hideCurrent: true,
+				ancestors,
+				descendants
+			}));
+			if (page.pagination.next !== null) console.log(formatNextCursorHint(page.pagination.next));
+			return;
+		}
+		const result = await (async () => {
+			try {
+				var _usingCtx5 = _usingCtx();
+				const _spinner$1 = _usingCtx5.u(acquireRelease(() => ora("Fetching snapshot tree...").start(), (s$1) => s$1.stop()));
+				const currentSnapshotId = (await sandboxClient.get({
+					name,
+					token: token$1,
+					teamId: team$1,
+					projectId: project$1
+				})).currentSnapshotId;
+				if (!currentSnapshotId) return null;
+				const [currentSnap, ancestors, descendants] = await Promise.all([
+					snapshotClient.get({
+						snapshotId: currentSnapshotId,
+						token: token$1,
+						teamId: team$1,
+						projectId: project$1
+					}),
+					snapshotClient.tree({
+						snapshotId: currentSnapshotId,
+						sortOrder: "desc",
+						limit: pageLimit,
+						token: token$1,
+						teamId: team$1,
+						projectId: project$1
+					}),
+					snapshotClient.tree({
+						snapshotId: currentSnapshotId,
+						sortOrder: "asc",
+						limit: pageLimit,
+						token: token$1,
+						teamId: team$1,
+						projectId: project$1
+					})
+				]);
+				return {
+					currentSnap,
+					currentSnapshotId,
+					ancestors,
+					descendants
+				};
+			} catch (_) {
+				_usingCtx5.e = _;
+			} finally {
+				_usingCtx5.d();
+			}
+		})();
+		if (!result) {
+			console.log(source_default.yellow("No snapshots found for this sandbox."));
+			return;
+		}
+		console.log(renderSnapshotTree({
+			currentSnapshotId: result.currentSnapshotId,
+			currentSnapshotExpiresAt: result.currentSnap.expiresAt?.getTime(),
+			ancestors: result.ancestors,
+			descendants: result.descendants
+		}));
+		const limitArg = limit !== void 0 ? ` --limit ${limit}` : "";
+		if (result.ancestors.pagination.next !== null) console.log(`\nMore ancestors: sandbox snapshots tree ${name} --sort-order desc${limitArg} --cursor ${result.ancestors.pagination.next}`);
+		if (result.descendants.pagination.next !== null) console.log(`More descendants: sandbox snapshots tree ${name} --sort-order asc${limitArg} --cursor ${result.descendants.pagination.next}`);
+	}
+});
 const snapshots = (0, import_cjs$5.subcommands)({
 	name: "snapshots",
 	description: "Manage sandbox snapshots",
 	cmds: {
 		list: list$2,
 		get,
+		tree,
 		delete: remove$1
 	}
 });
@@ -15160,6 +15381,47 @@ const currentSnapshotCommand = import_cjs$1.command({
 		}
 	}
 });
+const portsCommand = import_cjs$1.command({
+	name: "ports",
+	description: "Update the published ports of a sandbox. Replaces all existing published ports.",
+	args: {
+		sandbox: import_cjs$1.positional({
+			type: sandboxName,
+			description: "Sandbox name to update"
+		}),
+		ports: publishPorts,
+		scope
+	},
+	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandbox: name, ports }) {
+		const sandbox = await sandboxClient.get({
+			name,
+			projectId: project$1,
+			teamId: team$1,
+			token: token$1
+		});
+		const spinner = ora("Updating sandbox ports...").start();
+		try {
+			await sandbox.update({ ports });
+			spinner.stop();
+			process.stderr.write("✅ Ports updated for sandbox " + source_default.cyan(name) + "\n");
+			if (ports.length === 0) process.stderr.write(source_default.dim("   ╰ ") + "all ports unpublished\n");
+			else {
+				const routes = getPublishedRoutes(sandbox);
+				process.stderr.write(source_default.dim("   │ ") + "ports:\n");
+				for (let i = 0; i < ports.length; i++) {
+					const port = ports[i];
+					const route = routes?.find((route$1) => route$1.port === port);
+					const prefix$1 = i === ports.length - 1 ? source_default.dim("   ╰ ") : source_default.dim("   │ ");
+					const url = route ? " -> " + source_default.cyan(route.url) : "";
+					process.stderr.write(prefix$1 + "• " + port + url + "\n");
+				}
+			}
+		} catch (error) {
+			spinner.stop();
+			throw error;
+		}
+	}
+});
 const listCommand = import_cjs$1.command({
 	name: "list",
 	description: "Display the current configuration of a sandbox",
@@ -15206,6 +15468,10 @@ const listCommand = import_cjs$1.command({
 				field: "Network policy",
 				value: String(networkPolicy$1)
 			},
+			{
+				field: "Ports",
+				value: formatPorts(sandbox)
+			},
 			{
 				field: "Snapshot expiration",
 				value: sandbox.snapshotExpiration != null && sandbox.snapshotExpiration > 0 ? (0, import_ms.default)(sandbox.snapshotExpiration, { long: true }) : sandbox.snapshotExpiration === 0 ? "none" : "-"
@@ -15325,6 +15591,14 @@ function formatKeepLastSnapshots(keepLastSnapshots) {
 	if (keepLastSnapshots.deleteEvicted !== void 0) parts.push(`delete-evicted-snapshots=${keepLastSnapshots.deleteEvicted}`);
 	return parts.join(", ");
 }
+function formatPorts(sandbox) {
+	const ports = getPublishedRoutes(sandbox)?.map((route) => route.port) ?? [];
+	if (ports.length === 0) return "-";
+	return ports.join(", ");
+}
+function getPublishedRoutes(sandbox) {
+	return sandbox.routes.filter((route) => route.port !== sandbox.interactivePort);
+}
 const config = import_cjs$1.subcommands({
 	name: "config",
 	description: "View and update sandbox configuration",
@@ -15339,6 +15613,7 @@ const config = import_cjs$1.subcommands({
 		"keep-last-snapshots-for": keepLastSnapshotsForCommand,
 		"delete-evicted-snapshots": deleteEvictedSnapshotsCommand,
 		"current-snapshot": currentSnapshotCommand,
+		ports: portsCommand,
 		tags: tagsCommand
 	}
 });
@@ -15386,4 +15661,4 @@ const app = (opts) => (0, import_cjs.subcommands)({
 
 //#endregion
 export { source_exports as a, init_source as i, StyledError as n, require_cjs as r, app as t };
-//# sourceMappingURL=app-BjVyEIk1.mjs.map
+//# sourceMappingURL=app-BdOGNXsw.mjs.map