sandbox 2.2.0 → 2.4.0

package/dist/{app-BNIol84k.mjs → app-uOMbKaBL.mjs}

@@ -7,7 +7,7 @@ import process$1 from "node:process";
 import os, { tmpdir } from "node:os";
 import tty, { isatty } from "node:tty";
 import createDebugger from "debug";
-import { promisify } from "node:util";
+import { promisify, stripVTControlCharacters } from "node:util";
 import { Buffer as Buffer$1 } from "node:buffer";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -542,8 +542,8 @@ var require_didYouMean_1_2_1 = /* @__PURE__ */ __commonJS$1({ "../../node_module
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/Result.js
-var require_Result = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/Result.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/Result.js
+var require_Result = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/Result.js": ((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.ok = ok;
 	exports.err = err;
@@ -590,8 +590,8 @@ var require_Result = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cm
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/effects.js
-var require_effects = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/effects.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/effects.js
+var require_effects = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/effects.js": ((exports) => {
 	/**
 	* "Effects" are custom exceptions that can do stuff.
 	* The concept comes from React, where they throw a `Promise` to provide the ability to write
@@ -642,8 +642,8 @@ var require_effects = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/c
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/newparser/findOption.js
-var require_findOption = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/newparser/findOption.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/newparser/findOption.js
+var require_findOption = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/newparser/findOption.js": ((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.findOption = findOption;
 	/**
@@ -668,8 +668,8 @@ var require_findOption = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnp
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/from.js
-var require_from = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/from.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/from.js
+var require_from = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/from.js": ((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.identity = identity;
 	/**
@@ -683,8 +683,8 @@ var require_from = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/type.js
-var require_type = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/type.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/type.js
+var require_type = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/type.js": ((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.identity = void 0;
 	exports.typeDef = typeDef;
@@ -736,8 +736,8 @@ var require_type = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/types.js
-var require_types = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/types.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/types.js
+var require_types = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/types.js": ((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.boolean = exports.string = exports.number = void 0;
 	exports.optional = optional;
@@ -799,8 +799,8 @@ var require_types = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/flag.js
-var require_flag = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/flag.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/flag.js
+var require_flag = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/flag.js": ((exports) => {
 	var __createBinding$11 = exports && exports.__createBinding || (Object.create ? (function(o, m$1, k, k2) {
 		if (k2 === void 0) k2 = k;
 		var desc = Object.getOwnPropertyDescriptor(m$1, k);
@@ -974,8 +974,8 @@ var require_flag = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/circuitbreaker.js
-var require_circuitbreaker = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/circuitbreaker.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/circuitbreaker.js
+var require_circuitbreaker = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/circuitbreaker.js": ((exports) => {
 	var __createBinding$10 = exports && exports.__createBinding || (Object.create ? (function(o, m$1, k, k2) {
 		if (k2 === void 0) k2 = k;
 		var desc = Object.getOwnPropertyDescriptor(m$1, k);
@@ -1095,8 +1095,208 @@ var require_circuitbreaker = /* @__PURE__ */ __commonJS$1({ "../../node_modules/
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/positional.js
-var require_positional = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/positional.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/utils.js
+var require_utils = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/utils.js": ((exports) => {
+	var __importDefault$8 = exports && exports.__importDefault || function(mod) {
+		return mod && mod.__esModule ? mod : { "default": mod };
+	};
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.padNoAnsi = padNoAnsi;
+	exports.groupBy = groupBy;
+	exports.entries = entries;
+	exports.enumerate = enumerate;
+	exports.flatMap = flatMap$1;
+	exports.flatten = flatten;
+	const strip_ansi_1$1 = __importDefault$8((init_strip_ansi(), __toCommonJS$3(strip_ansi_exports)));
+	/**
+	* @ignore
+	*/
+	function padNoAnsi(str, length, place) {
+		const noAnsiStr = (0, strip_ansi_1$1.default)(str);
+		if (length < noAnsiStr.length) return str;
+		const pad = Array(length - noAnsiStr.length + 1).join(" ");
+		if (place === "end") return str + pad;
+		return pad + str;
+	}
+	/**
+	* Group an array by a function that returns the key
+	*
+	* @ignore
+	*/
+	function groupBy(objs, f) {
+		var _a;
+		const result = {};
+		for (const obj of objs) {
+			const key = f(obj);
+			result[key] = (_a = result[key]) !== null && _a !== void 0 ? _a : [];
+			result[key].push(obj);
+		}
+		return result;
+	}
+	/**
+	* A better typed version of `Object.entries`
+	*
+	* @ignore
+	*/
+	function entries(obj) {
+		return Object.entries(obj);
+	}
+	/**
+	* Enumerate over a list, to get a pair of [index, value]
+	*
+	* @ignore
+	*/
+	function* enumerate(arr) {
+		for (let i = 0; i < arr.length; i++) yield [i, arr[i]];
+	}
+	/**
+	* Array#flatMap polyfill
+	*
+	* @ignore
+	*/
+	function flatMap$1(xs, fn) {
+		const results = [];
+		for (const x of xs) results.push(...fn(x));
+		return results;
+	}
+	/**
+	* Flatten an array
+	*
+	* @ignore
+	*/
+	function flatten(xs) {
+		const results = [];
+		for (const x of xs) results.push(...x);
+		return results;
+	}
+}) });
+
+//#endregion
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/helpFormatter.js
+var require_helpFormatter = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/helpFormatter.js": ((exports) => {
+	var __importDefault$7 = exports && exports.__importDefault || function(mod) {
+		return mod && mod.__esModule ? mod : { "default": mod };
+	};
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.defaultHelpFormatter = void 0;
+	exports.setDefaultHelpFormatter = setDefaultHelpFormatter;
+	exports.resetHelpFormatter = resetHelpFormatter;
+	exports.getHelpFormatter = getHelpFormatter;
+	const chalk_1$5 = __importDefault$7((init_source(), __toCommonJS$3(source_exports)));
+	const utils_1$3 = require_utils();
+	let currentFormatter = null;
+	/**
+	* Set a custom help formatter to be used for all commands.
+	*
+	* @example
+	* ```ts
+	* import { setDefaultHelpFormatter } from "cmd-ts";
+	*
+	* setDefaultHelpFormatter({
+	*   formatCommand(data, context) {
+	*     return `My CLI ${data.version}\n${data.description}`;
+	*   },
+	*   formatSubcommands(data, context) {
+	*     return `Commands: ${data.commands.map(c => c.name).join(", ")}`;
+	*   },
+	* });
+	* ```
+	*/
+	function setDefaultHelpFormatter(formatter) {
+		currentFormatter = formatter;
+	}
+	/**
+	* Reset the help formatter to the default.
+	* Useful for testing.
+	*/
+	function resetHelpFormatter() {
+		currentFormatter = null;
+	}
+	/**
+	* Get the current help formatter (custom or default).
+	* @internal
+	*/
+	function getHelpFormatter() {
+		return currentFormatter !== null && currentFormatter !== void 0 ? currentFormatter : exports.defaultHelpFormatter;
+	}
+	/**
+	* The default help formatter that matches cmd-ts's original output style.
+	*/
+	exports.defaultHelpFormatter = {
+		formatCommand(data, _context) {
+			const lines = [];
+			let name = data.path.length > 0 ? data.path.join(" ") : data.name;
+			name = chalk_1$5.default.bold(name);
+			if (data.version) name += ` ${chalk_1$5.default.dim(data.version)}`;
+			lines.push(name);
+			if (data.description) lines.push(chalk_1$5.default.dim("> ") + data.description);
+			const usageBreakdown = (0, utils_1$3.groupBy)(data.helpTopics, (x) => x.category);
+			for (const [category, helpTopics] of (0, utils_1$3.entries)(usageBreakdown)) {
+				lines.push("");
+				lines.push(`${category.toUpperCase()}:`);
+				const widestUsage = helpTopics.reduce((len, curr) => {
+					return Math.max(len, curr.usage.length);
+				}, 0);
+				for (const helpTopic of helpTopics) {
+					let line = "";
+					line += `  ${(0, utils_1$3.padNoAnsi)(helpTopic.usage, widestUsage, "end")}`;
+					line += " - ";
+					line += helpTopic.description;
+					for (const defaultValue of helpTopic.defaults) line += chalk_1$5.default.dim(` [${defaultValue}]`);
+					lines.push(line);
+				}
+			}
+			if (data.examples && data.examples.length > 0) {
+				lines.push("");
+				lines.push("EXAMPLES:");
+				for (const example of data.examples) {
+					lines.push("");
+					lines.push(`  ${example.description}`);
+					lines.push(chalk_1$5.default.dim(`  $ ${example.command}`));
+				}
+			}
+			return lines.join("\n");
+		},
+		formatSubcommands(data, _context) {
+			var _a, _b;
+			const lines = [];
+			const argsSoFar = data.path.length > 0 ? data.path.join(" ") : data.name;
+			lines.push(chalk_1$5.default.bold(argsSoFar + chalk_1$5.default.italic(" <subcommand>")));
+			if (data.description) lines.push(chalk_1$5.default.dim("> ") + data.description);
+			lines.push("");
+			lines.push(`where ${chalk_1$5.default.italic("<subcommand>")} can be one of:`);
+			lines.push("");
+			for (const cmd of data.commands) {
+				let description = (_a = cmd.description) !== null && _a !== void 0 ? _a : "";
+				description = description && ` - ${description} `;
+				if ((_b = cmd.aliases) === null || _b === void 0 ? void 0 : _b.length) {
+					const aliasTxt = cmd.aliases.length === 1 ? "alias" : "aliases";
+					const aliases = cmd.aliases.join(", ");
+					description += chalk_1$5.default.dim(`[${aliasTxt}: ${aliases}]`);
+				}
+				const row = chalk_1$5.default.dim("- ") + cmd.name + description;
+				lines.push(row.trim());
+			}
+			const helpCommand = chalk_1$5.default.yellow(`${argsSoFar} <subcommand> --help`);
+			lines.push("");
+			lines.push(chalk_1$5.default.dim(`For more help, try running \`${helpCommand}\``));
+			if (data.examples && data.examples.length > 0) {
+				lines.push("");
+				lines.push("EXAMPLES:");
+				for (const example of data.examples) {
+					lines.push("");
+					lines.push(`  ${example.description}`);
+					lines.push(chalk_1$5.default.dim(`  $ ${example.command}`));
+				}
+			}
+			return lines.join("\n");
+		}
+	};
+}) });
+
+//#endregion
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/positional.js
+var require_positional = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/positional.js": ((exports) => {
 	var __createBinding$9 = exports && exports.__createBinding || (Object.create ? (function(o, m$1, k, k2) {
 		if (k2 === void 0) k2 = k;
 		var desc = Object.getOwnPropertyDescriptor(m$1, k);
@@ -1138,12 +1338,12 @@ var require_positional = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnp
 			return result;
 		};
 	})();
-	var __importDefault$8 = exports && exports.__importDefault || function(mod) {
+	var __importDefault$6 = exports && exports.__importDefault || function(mod) {
 		return mod && mod.__esModule ? mod : { "default": mod };
 	};
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.positional = positional;
-	const chalk_1$5 = __importDefault$8((init_source(), __toCommonJS$3(source_exports)));
+	const chalk_1$4 = __importDefault$6((init_source(), __toCommonJS$3(source_exports)));
 	const Result$8 = __importStar$8(require_Result());
 	const types_1$2 = require_types();
 	function fullPositional(config$1) {
@@ -1157,7 +1357,7 @@ var require_positional = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnp
 				const defaultValueFn = (_a$1 = config$1.defaultValue) !== null && _a$1 !== void 0 ? _a$1 : config$1.type.defaultValue;
 				if (defaultValueFn) try {
 					const defaultValue = defaultValueFn();
-					if ((_b$1 = config$1.defaultValueIsSerializable) !== null && _b$1 !== void 0 ? _b$1 : config$1.type.defaultValueIsSerializable) defaults.push(`default: ${chalk_1$5.default.italic(defaultValue)}`);
+					if ((_b$1 = config$1.defaultValueIsSerializable) !== null && _b$1 !== void 0 ? _b$1 : config$1.type.defaultValueIsSerializable) defaults.push(`default: ${chalk_1$4.default.italic(defaultValue)}`);
 					else defaults.push("optional");
 				} catch (e) {}
 				return [{
@@ -1199,8 +1399,8 @@ var require_positional = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnp
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/subcommands.js
-var require_subcommands = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/subcommands.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/subcommands.js
+var require_subcommands = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/subcommands.js": ((exports) => {
 	var __createBinding$8 = exports && exports.__createBinding || (Object.create ? (function(o, m$1, k, k2) {
 		if (k2 === void 0) k2 = k;
 		var desc = Object.getOwnPropertyDescriptor(m$1, k);
@@ -1242,15 +1442,16 @@ var require_subcommands = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pn
 			return result;
 		};
 	})();
-	var __importDefault$7 = exports && exports.__importDefault || function(mod) {
+	var __importDefault$5 = exports && exports.__importDefault || function(mod) {
 		return mod && mod.__esModule ? mod : { "default": mod };
 	};
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.subcommands = subcommands$2;
-	const chalk_1$4 = __importDefault$7((init_source(), __toCommonJS$3(source_exports)));
-	const didyoumean_1 = __importDefault$7(require_didYouMean_1_2_1());
+	const chalk_1$3 = __importDefault$5((init_source(), __toCommonJS$3(source_exports)));
+	const didyoumean_1 = __importDefault$5(require_didYouMean_1_2_1());
 	const Result$7 = __importStar$7(require_Result());
 	const circuitbreaker_1$1 = require_circuitbreaker();
+	const helpFormatter_1$2 = require_helpFormatter();
 	const positional_1$1 = require_positional();
 	/**
 	* Combine multiple `command`s into one
@@ -1271,10 +1472,10 @@ var require_subcommands = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pn
 				const cmd = commands.find((x) => x.names.includes(str));
 				if (cmd) return cmd.cmdName;
 				let errorMessage = "Not a valid subcommand name";
-				const closeOptions = (0, didyoumean_1.default)(str, flatMap$1(commands, (x) => x.names));
+				const closeOptions = (0, didyoumean_1.default)(str, flatMap(commands, (x) => x.names));
 				if (closeOptions) {
 					const option$1 = Array.isArray(closeOptions) ? closeOptions[0] : closeOptions;
-					errorMessage += `\nDid you mean ${chalk_1$4.default.italic(option$1)}?`;
+					errorMessage += `\nDid you mean ${chalk_1$3.default.italic(option$1)}?`;
 				}
 				throw new Error(errorMessage);
 			} }
@@ -1301,30 +1502,24 @@ var require_subcommands = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pn
 				circuitbreaker.register(opts);
 			},
 			printHelp(context) {
-				var _a, _b, _c, _d;
-				const lines = [];
-				const argsSoFar = (_b = (_a = context.hotPath) === null || _a === void 0 ? void 0 : _a.join(" ")) !== null && _b !== void 0 ? _b : "cli";
-				lines.push(chalk_1$4.default.bold(argsSoFar + chalk_1$4.default.italic(" <subcommand>")));
-				if (config$1.description) lines.push(chalk_1$4.default.dim("> ") + config$1.description);
-				lines.push("");
-				lines.push(`where ${chalk_1$4.default.italic("<subcommand>")} can be one of:`);
-				lines.push("");
-				for (const key of Object.keys(config$1.cmds)) {
-					const cmd = config$1.cmds[key];
-					let description = (_c = cmd.description) !== null && _c !== void 0 ? _c : "";
-					description = description && ` - ${description} `;
-					if ((_d = cmd.aliases) === null || _d === void 0 ? void 0 : _d.length) {
-						const aliasTxt = cmd.aliases.length === 1 ? "alias" : "aliases";
-						const aliases = cmd.aliases.join(", ");
-						description += chalk_1$4.default.dim(`[${aliasTxt}: ${aliases}]`);
-					}
-					const row = chalk_1$4.default.dim("- ") + key + description;
-					lines.push(row.trim());
-				}
-				const helpCommand = chalk_1$4.default.yellow(`${argsSoFar} <subcommand> --help`);
-				lines.push("");
-				lines.push(chalk_1$4.default.dim(`For more help, try running \`${helpCommand}\``));
-				return lines.join("\n");
+				var _a;
+				const data = {
+					name: config$1.name,
+					path: (_a = context.hotPath) !== null && _a !== void 0 ? _a : [config$1.name],
+					version: config$1.version,
+					description: config$1.description,
+					commands: Object.entries(config$1.cmds).map(([name, cmd]) => {
+						var _a$1, _b;
+						return {
+							name,
+							description: cmd.description,
+							aliases: cmd.aliases,
+							helpTopics: (_b = (_a$1 = cmd.helpTopics) === null || _a$1 === void 0 ? void 0 : _a$1.call(cmd)) !== null && _b !== void 0 ? _b : []
+						};
+					}),
+					examples: config$1.examples
+				};
+				return (0, helpFormatter_1$2.getHelpFormatter)().formatSubcommands(data, context);
 			},
 			async parse(context) {
 				var _a;
@@ -1376,7 +1571,7 @@ var require_subcommands = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pn
 			}
 		};
 	}
-	function flatMap$1(array$1, f) {
+	function flatMap(array$1, f) {
 		const rs = [];
 		for (const item of array$1) rs.push(...f(item));
 		return rs;
@@ -1384,8 +1579,8 @@ var require_subcommands = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pn
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/binary.js
-var require_binary = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/binary.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/binary.js
+var require_binary = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/binary.js": ((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.binary = binary;
 	/**
@@ -1410,85 +1605,8 @@ var require_binary = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cm
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/utils.js
-var require_utils = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/utils.js": ((exports) => {
-	var __importDefault$6 = exports && exports.__importDefault || function(mod) {
-		return mod && mod.__esModule ? mod : { "default": mod };
-	};
-	Object.defineProperty(exports, "__esModule", { value: true });
-	exports.padNoAnsi = padNoAnsi;
-	exports.groupBy = groupBy;
-	exports.entries = entries;
-	exports.enumerate = enumerate;
-	exports.flatMap = flatMap;
-	exports.flatten = flatten;
-	const strip_ansi_1$1 = __importDefault$6((init_strip_ansi(), __toCommonJS$3(strip_ansi_exports)));
-	/**
-	* @ignore
-	*/
-	function padNoAnsi(str, length, place) {
-		const noAnsiStr = (0, strip_ansi_1$1.default)(str);
-		if (length < noAnsiStr.length) return str;
-		const pad = Array(length - noAnsiStr.length + 1).join(" ");
-		if (place === "end") return str + pad;
-		return pad + str;
-	}
-	/**
-	* Group an array by a function that returns the key
-	*
-	* @ignore
-	*/
-	function groupBy(objs, f) {
-		var _a;
-		const result = {};
-		for (const obj of objs) {
-			const key = f(obj);
-			result[key] = (_a = result[key]) !== null && _a !== void 0 ? _a : [];
-			result[key].push(obj);
-		}
-		return result;
-	}
-	/**
-	* A better typed version of `Object.entries`
-	*
-	* @ignore
-	*/
-	function entries(obj) {
-		return Object.entries(obj);
-	}
-	/**
-	* Enumerate over a list, to get a pair of [index, value]
-	*
-	* @ignore
-	*/
-	function* enumerate(arr) {
-		for (let i = 0; i < arr.length; i++) yield [i, arr[i]];
-	}
-	/**
-	* Array#flatMap polyfill
-	*
-	* @ignore
-	*/
-	function flatMap(xs, fn) {
-		const results = [];
-		for (const x of xs) results.push(...fn(x));
-		return results;
-	}
-	/**
-	* Flatten an array
-	*
-	* @ignore
-	*/
-	function flatten(xs) {
-		const results = [];
-		for (const x of xs) results.push(...x);
-		return results;
-	}
-}) });
-
-//#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/command.js
-var require_command = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/command.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/command.js
+var require_command = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/command.js": ((exports) => {
 	var __createBinding$7 = exports && exports.__createBinding || (Object.create ? (function(o, m$1, k, k2) {
 		if (k2 === void 0) k2 = k;
 		var desc = Object.getOwnPropertyDescriptor(m$1, k);
@@ -1530,14 +1648,11 @@ var require_command = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/c
 			return result;
 		};
 	})();
-	var __importDefault$5 = exports && exports.__importDefault || function(mod) {
-		return mod && mod.__esModule ? mod : { "default": mod };
-	};
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.command = command;
-	const chalk_1$3 = __importDefault$5((init_source(), __toCommonJS$3(source_exports)));
 	const Result$6 = __importStar$6(require_Result());
 	const circuitbreaker_1 = require_circuitbreaker();
+	const helpFormatter_1$1 = require_helpFormatter();
 	const utils_1$2 = require_utils();
 	/**
 	* A command line utility.
@@ -1561,31 +1676,17 @@ var require_command = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/c
 				});
 			},
 			printHelp(context) {
-				var _a, _b;
-				const lines = [];
-				let name = (_b = (_a = context.hotPath) === null || _a === void 0 ? void 0 : _a.join(" ")) !== null && _b !== void 0 ? _b : "";
-				if (!name) name = config$1.name;
-				name = chalk_1$3.default.bold(name);
-				if (config$1.version) name += ` ${chalk_1$3.default.dim(config$1.version)}`;
-				lines.push(name);
-				if (config$1.description) lines.push(chalk_1$3.default.dim("> ") + config$1.description);
-				const usageBreakdown = (0, utils_1$2.groupBy)(this.helpTopics(), (x) => x.category);
-				for (const [category, helpTopics] of (0, utils_1$2.entries)(usageBreakdown)) {
-					lines.push("");
-					lines.push(`${category.toUpperCase()}:`);
-					const widestUsage = helpTopics.reduce((len, curr) => {
-						return Math.max(len, curr.usage.length);
-					}, 0);
-					for (const helpTopic of helpTopics) {
-						let line = "";
-						line += `  ${(0, utils_1$2.padNoAnsi)(helpTopic.usage, widestUsage, "end")}`;
-						line += " - ";
-						line += helpTopic.description;
-						for (const defaultValue of helpTopic.defaults) line += chalk_1$3.default.dim(` [${defaultValue}]`);
-						lines.push(line);
-					}
-				}
-				return lines.join("\n");
+				var _a;
+				const data = {
+					name: config$1.name,
+					path: (_a = context.hotPath) !== null && _a !== void 0 ? _a : [config$1.name],
+					version: config$1.version,
+					description: config$1.description,
+					aliases: config$1.aliases,
+					helpTopics: this.helpTopics(),
+					examples: config$1.examples
+				};
+				return (0, helpFormatter_1$1.getHelpFormatter)().formatCommand(data, context);
 			},
 			register(opts) {
 				var _a;
@@ -1632,8 +1733,8 @@ var require_command = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/c
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/option.js
-var require_option = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/option.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/option.js
+var require_option = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/option.js": ((exports) => {
 	var __createBinding$6 = exports && exports.__createBinding || (Object.create ? (function(o, m$1, k, k2) {
 		if (k2 === void 0) k2 = k;
 		var desc = Object.getOwnPropertyDescriptor(m$1, k);
@@ -1789,8 +1890,8 @@ var require_option = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cm
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/errorBox.js
-var require_errorBox = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/errorBox.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/errorBox.js
+var require_errorBox = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/errorBox.js": ((exports) => {
 	var __importDefault$3 = exports && exports.__importDefault || function(mod) {
 		return mod && mod.__esModule ? mod : { "default": mod };
 	};
@@ -1874,8 +1975,11 @@ var require_errorBox = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/
 			else if (withNoHighlight.length > 1) errorMessages.push("Along with the following errors:");
 		}
 		withNoHighlight.forEach(({ message }) => {
+			var _a;
 			const num = chalk_1$1.default.red.bold(`${(0, utils_1$1.padNoAnsi)(number.toString(), maxNumberWidth, "start")}.`);
-			errorMessages.push(`  ${num} ${chalk_1$1.default.red(message)}`);
+			const lines = message.split("\n");
+			errorMessages.push(`  ${num} ${chalk_1$1.default.red((_a = lines[0]) !== null && _a !== void 0 ? _a : "")}`);
+			for (const line of lines.slice(1)) errorMessages.push(` ${"".padStart(maxNumberWidth + 1)}  ${chalk_1$1.default.red(line)}`);
 			number++;
 		});
 		const helpCmd = chalk_1$1.default.yellow(`${breadcrumbs.join(" ")} --help`);
@@ -1886,8 +1990,8 @@ var require_errorBox = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/newparser/parser.js
-var require_parser$1 = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/newparser/parser.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/newparser/parser.js
+var require_parser$1 = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/newparser/parser.js": ((exports) => {
 	var __importDefault$2 = exports && exports.__importDefault || function(mod) {
 		return mod && mod.__esModule ? mod : { "default": mod };
 	};
@@ -2079,8 +2183,8 @@ var require_parser$1 = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/newparser/tokenizer.js
-var require_tokenizer = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/newparser/tokenizer.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/newparser/tokenizer.js
+var require_tokenizer = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/newparser/tokenizer.js": ((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.tokenize = tokenize;
 	const utils_1 = require_utils();
@@ -2126,8 +2230,8 @@ var require_tokenizer = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/runner.js
-var require_runner = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/runner.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/runner.js
+var require_runner = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/runner.js": ((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.run = run$1;
 	exports.runSafely = runSafely;
@@ -2203,8 +2307,8 @@ var require_runner = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cm
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/restPositionals.js
-var require_restPositionals = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/restPositionals.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/restPositionals.js
+var require_restPositionals = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/restPositionals.js": ((exports) => {
 	var __createBinding$5 = exports && exports.__createBinding || (Object.create ? (function(o, m$1, k, k2) {
 		if (k2 === void 0) k2 = k;
 		var desc = Object.getOwnPropertyDescriptor(m$1, k);
@@ -2294,8 +2398,8 @@ var require_restPositionals = /* @__PURE__ */ __commonJS$1({ "../../node_modules
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/multiflag.js
-var require_multiflag = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/multiflag.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/multiflag.js
+var require_multiflag = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/multiflag.js": ((exports) => {
 	var __createBinding$4 = exports && exports.__createBinding || (Object.create ? (function(o, m$1, k, k2) {
 		if (k2 === void 0) k2 = k;
 		var desc = Object.getOwnPropertyDescriptor(m$1, k);
@@ -2393,8 +2497,8 @@ var require_multiflag = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/multioption.js
-var require_multioption = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/multioption.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/multioption.js
+var require_multioption = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/multioption.js": ((exports) => {
 	var __createBinding$3 = exports && exports.__createBinding || (Object.create ? (function(o, m$1, k, k2) {
 		if (k2 === void 0) k2 = k;
 		var desc = Object.getOwnPropertyDescriptor(m$1, k);
@@ -2535,8 +2639,8 @@ var require_multioption = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pn
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/union.js
-var require_union = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/union.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/union.js
+var require_union = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/union.js": ((exports) => {
 	var __createBinding$2 = exports && exports.__createBinding || (Object.create ? (function(o, m$1, k, k2) {
 		if (k2 === void 0) k2 = k;
 		var desc = Object.getOwnPropertyDescriptor(m$1, k);
@@ -2603,8 +2707,8 @@ var require_union = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/oneOf.js
-var require_oneOf = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/oneOf.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/oneOf.js
+var require_oneOf = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/oneOf.js": ((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.oneOf = oneOf;
 	const node_util_1 = __require$1("node:util");
@@ -2625,8 +2729,8 @@ var require_oneOf = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/rest.js
-var require_rest = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/rest.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/rest.js
+var require_rest = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/rest.js": ((exports) => {
 	var __createBinding$1 = exports && exports.__createBinding || (Object.create ? (function(o, m$1, k, k2) {
 		if (k2 === void 0) k2 = k;
 		var desc = Object.getOwnPropertyDescriptor(m$1, k);
@@ -2727,8 +2831,8 @@ var require_rest = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-
 }) });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/index.js
-var require_cjs = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/index.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/index.js
+var require_cjs = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/index.js": ((exports) => {
 	/**
 	* The index module: the entrance to the world of cmd-ts 😎
 	*
@@ -2752,7 +2856,7 @@ var require_cjs = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-t
 		for (var p in m$1) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports$1, p)) __createBinding(exports$1, m$1, p);
 	};
 	Object.defineProperty(exports, "__esModule", { value: true });
-	exports.rest = exports.oneOf = exports.union = exports.multioption = exports.multiflag = exports.restPositionals = exports.parse = exports.run = exports.runSafely = exports.dryRun = exports.positional = exports.option = exports.flag = exports.command = exports.binary = exports.extendType = exports.subcommands = void 0;
+	exports.rest = exports.oneOf = exports.union = exports.multioption = exports.multiflag = exports.restPositionals = exports.parse = exports.run = exports.runSafely = exports.dryRun = exports.positional = exports.option = exports.defaultHelpFormatter = exports.resetHelpFormatter = exports.setDefaultHelpFormatter = exports.flag = exports.command = exports.binary = exports.extendType = exports.subcommands = void 0;
 	var subcommands_1 = require_subcommands();
 	Object.defineProperty(exports, "subcommands", {
 		enumerable: true,
@@ -2789,6 +2893,25 @@ var require_cjs = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-t
 			return flag_1.flag;
 		}
 	});
+	var helpFormatter_1 = require_helpFormatter();
+	Object.defineProperty(exports, "setDefaultHelpFormatter", {
+		enumerable: true,
+		get: function() {
+			return helpFormatter_1.setDefaultHelpFormatter;
+		}
+	});
+	Object.defineProperty(exports, "resetHelpFormatter", {
+		enumerable: true,
+		get: function() {
+			return helpFormatter_1.resetHelpFormatter;
+		}
+	});
+	Object.defineProperty(exports, "defaultHelpFormatter", {
+		enumerable: true,
+		get: function() {
+			return helpFormatter_1.defaultHelpFormatter;
+		}
+	});
 	var option_1 = require_option();
 	Object.defineProperty(exports, "option", {
 		enumerable: true,
@@ -2976,13 +3099,13 @@ var require_ms = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/ms@2.1
 	* @return {String}
 	* @api private
 	*/
-	function fmtShort(ms$2) {
-		var msAbs = Math.abs(ms$2);
-		if (msAbs >= d) return Math.round(ms$2 / d) + "d";
-		if (msAbs >= h) return Math.round(ms$2 / h) + "h";
-		if (msAbs >= m) return Math.round(ms$2 / m) + "m";
-		if (msAbs >= s) return Math.round(ms$2 / s) + "s";
-		return ms$2 + "ms";
+	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";
 	}
 	/**
 	* Long format for `ms`.
@@ -2991,20 +3114,20 @@ var require_ms = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/ms@2.1
 	* @return {String}
 	* @api private
 	*/
-	function fmtLong(ms$2) {
-		var msAbs = Math.abs(ms$2);
-		if (msAbs >= d) return plural(ms$2, msAbs, d, "day");
-		if (msAbs >= h) return plural(ms$2, msAbs, h, "hour");
-		if (msAbs >= m) return plural(ms$2, msAbs, m, "minute");
-		if (msAbs >= s) return plural(ms$2, msAbs, s, "second");
-		return ms$2 + " ms";
+	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";
 	}
 	/**
 	* Pluralization helper.
 	*/
-	function plural(ms$2, msAbs, n, name) {
+	function plural(ms$3, msAbs, n, name) {
 		var isPlural = msAbs >= n * 1.5;
-		return Math.round(ms$2 / n) + " " + name + (isPlural ? "s" : "");
+		return Math.round(ms$3 / n) + " " + name + (isPlural ? "s" : "");
 	}
 }) });
 
@@ -4280,20 +4403,26 @@ function formatBytes(bytes) {
 	return `${new Intl.NumberFormat(void 0, { maximumFractionDigits: value < 10 && unitIndex > 0 ? 1 : 0 }).format(value)} ${units[unitIndex]}`;
 }
 function timeAgo(date) {
+	if (date === void 0) return "-";
 	return formatDistance(date, /* @__PURE__ */ new Date(), { addSuffix: true }).replace("about ", "").replace("less than ", "");
 }
 function table(opts) {
 	const titles = Object.keys(opts.columns);
-	const maxWidths = titles.map((title) => title.length);
+	const visibleLength = (value) => stripVTControlCharacters(value).length;
+	const maxWidths = titles.map((title) => visibleLength(title));
 	const data = opts.rows.map((row) => {
 		return titles.map((title, i) => {
 			let value = String(opts.columns[title].value(row));
-			if (value.length > maxWidths[i]) maxWidths[i] = value.length;
+			const width = visibleLength(value);
+			if (width > maxWidths[i]) maxWidths[i] = width;
 			if (opts.columns[title].color) value = opts.columns[title].color(row)(value);
 			return value;
 		});
 	});
-	const padded = (t, i) => t.padEnd(maxWidths[i], " ");
+	const padded = (value, i) => {
+		const padding = maxWidths[i] - visibleLength(value);
+		return padding > 0 ? `${value}${" ".repeat(padding)}` : value;
+	};
 	const space = "   ";
 	return [source_default.bold(titles.map(padded).join(space)), ...data.map((row) => row.map(padded).join(space))].join("\n");
 }
@@ -7286,13 +7415,16 @@ const scope = {
 			...token.helpTopics(),
 			...project.helpTopics(),
 			...team.helpTopics()
-		];
+		].map((x) => ({
+			...x,
+			category: "Auth & Scope"
+		}));
 	}
 };
 
 //#endregion
 //#region package.json
-var version = "2.2.0";
+var version = "2.4.0";
 
 //#endregion
 //#region src/error.ts
@@ -11111,9 +11243,9 @@ function printCommand(command$1, args$4) {
 
 //#endregion
 //#region src/interactive-shell/extend-sandbox-timeout.ts
-var import_ms$1 = /* @__PURE__ */ __toESM(require_ms());
+var import_ms$2 = /* @__PURE__ */ __toESM(require_ms());
 const debug$2 = createDebugger("sandbox:timeout");
-const BUFFER = (0, import_ms$1.default)("10 seconds");
+const BUFFER = (0, import_ms$2.default)("10 seconds");
 async function extendSandboxTimeoutPeriodically(sandbox, signal) {
 	const nextTick = sandbox.createdAt.getTime() + sandbox.timeout;
 	debug$2(`next tick: ${new Date(nextTick).toISOString()}`);
@@ -11123,7 +11255,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$1.default)("5 minutes"));
+		await sandbox.extendTimeout((0, import_ms$2.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()}`);
 	}
@@ -11422,12 +11554,7 @@ const ObjectFromKeyValue = import_cjs$14.extendType(import_cjs$14.array(KeyValue
 var import_cjs$13 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
 const args$3 = {
-	scope,
 	sandbox: import_cjs$13.positional({ type: sandboxId }),
-	asSudo: import_cjs$13.flag({
-		long: "sudo",
-		description: "Give extended privileges to the command."
-	}),
 	command: import_cjs$13.positional({
 		displayName: "command",
 		description: "The executable to invoke"
@@ -11436,11 +11563,9 @@ const args$3 = {
 		displayName: "args",
 		description: "arguments to pass to the command"
 	}),
-	cwd: import_cjs$13.option({
-		long: "workdir",
-		short: "w",
-		description: "The working directory to run the command in",
-		type: import_cjs$13.optional(import_cjs$13.string)
+	asSudo: import_cjs$13.flag({
+		long: "sudo",
+		description: "Give extended privileges to the command."
 	}),
 	interactive: import_cjs$13.flag({
 		long: "interactive",
@@ -11460,17 +11585,24 @@ const args$3 = {
 		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({
+		long: "tty",
+		short: "t",
+		description: "Allocate a tty for an interactive command. This is a no-op."
+	}),
+	cwd: import_cjs$13.option({
+		long: "workdir",
+		short: "w",
+		description: "The working directory to run the command in",
+		type: import_cjs$13.optional(import_cjs$13.string)
+	}),
 	envVars: import_cjs$13.multioption({
 		long: "env",
 		short: "e",
 		type: ObjectFromKeyValue,
 		description: "Environment variables to set for the command"
 	}),
-	tty: import_cjs$13.flag({
-		long: "tty",
-		short: "t",
-		description: "Allocate a tty for an interactive command. This is a no-op."
-	})
+	scope
 };
 const exec = import_cjs$13.command({
 	name: "exec",
@@ -11524,45 +11656,32 @@ init_source();
 const networkPolicyMode = import_cjs$12.extendType(import_cjs$12.string, {
 	displayName: "MODE",
 	async from(value) {
-		const validModes = [
-			"internet-access",
-			"no-access",
-			"restricted"
-		];
+		const validModes = ["allow-all", "deny-all"];
 		if (!validModes.includes(value)) throw new Error([`Invalid network policy mode: ${value}.`, `${source_default.bold("hint:")} Valid modes are: ${validModes.join(", ")}`].join("\n"));
 		return value;
 	}
 });
 const networkPolicy = import_cjs$12.option({
 	long: "network-policy",
-	description: `Network policy mode: "internet-access", "no-access", or "restricted"
-    
-internet-access: sandbox can access any website/domain
-no-access: sandbox has no network access
-restricted: sandbox can only access websites and domains explicitly allowed`,
+	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)
 });
 const allowedDomains = import_cjs$12.multioption({
 	long: "allowed-domain",
-	description: `Domain to allow traffic to (requires --network-policy=restricted)
-
-Supports "*" for wildcards for a segment (e.g. '*.vercel.com', 'www.*.com')
-If used as the first segment, will match any subdomain.`,
+	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)
 });
 const allowedCIDRs = import_cjs$12.multioption({
 	long: "allowed-cidr",
-	description: `CIDR to allow traffic to (requires --network-policy=restricted)
-
-Takes precedence over 'allowed-domain'.
-`,
+	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)
 });
 const deniedCIDRs = import_cjs$12.multioption({
 	long: "denied-cidr",
-	description: `CIDR to deny traffic to (requires --network-policy=restricted)
-    
-Takes precedence over allowed domains/CIDRs.`,
+	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)
 });
 const networkPolicyArgs = {
@@ -11576,33 +11695,36 @@ const networkPolicyArgs = {
 //#region src/util/network-policy.ts
 init_source();
 /**
-* Builds a NetworkPolicy from CLI arguments (optional mode for create).
+* Resolves the network policy mode from --network-policy and --mode flags.
+* Errors if both are provided with conflicting values.
+*/
+function resolveMode(networkPolicy$1, mode) {
+	if (networkPolicy$1 && mode && networkPolicy$1 !== mode) throw new Error([`Conflicting network policy modes: --network-policy=${networkPolicy$1} and --mode=${mode}.`, `${source_default.bold("hint:")} Use only one of --network-policy or --mode.`].join("\n"));
+	return networkPolicy$1 ?? mode;
+}
+/**
+* Builds a NetworkPolicy from CLI arguments.
 */
 function buildNetworkPolicy(args$4) {
 	const { networkPolicy: networkPolicy$1, allowedDomains: allowedDomains$1, allowedCIDRs: allowedCIDRs$1, deniedCIDRs: deniedCIDRs$1 } = args$4;
-	if (!networkPolicy$1 || networkPolicy$1 !== "restricted") {
-		if (allowedDomains$1.length > 0 || allowedCIDRs$1.length > 0 || deniedCIDRs$1.length > 0) throw new Error(["Network policy options require --network-policy to be set to restricted.", `${source_default.bold("hint:")} Use --network-policy=restricted to allow/deny specific domains or CIDRs.`].join("\n"));
-	}
-	switch (networkPolicy$1) {
-		case void 0:
-		case "internet-access": return { type: "internet-access" };
-		case "no-access": return { type: "no-access" };
-		case "restricted": return {
-			type: "restricted",
-			allowedDomains: allowedDomains$1.length > 0 ? allowedDomains$1 : void 0,
-			allowedCIDRs: allowedCIDRs$1.length > 0 ? allowedCIDRs$1 : void 0,
-			deniedCIDRs: deniedCIDRs$1.length > 0 ? deniedCIDRs$1 : void 0
-		};
-	}
+	const hasListOptions = allowedDomains$1.length > 0 || allowedCIDRs$1.length > 0 || deniedCIDRs$1.length > 0;
+	if (networkPolicy$1 && hasListOptions) throw new Error([`Cannot combine --network-policy=${networkPolicy$1} with --allowed-domain, --allowed-cidr, or --denied-cidr.`, `${source_default.bold("hint:")} Use --allowed-domain / --allowed-cidr / --denied-cidr without --network-policy for custom policies.`].join("\n"));
+	if (hasListOptions) return {
+		...allowedDomains$1.length > 0 && { allow: allowedDomains$1 },
+		...(allowedCIDRs$1.length > 0 || deniedCIDRs$1.length > 0) && { subnets: {
+			...allowedCIDRs$1.length > 0 && { allow: allowedCIDRs$1 },
+			...deniedCIDRs$1.length > 0 && { deny: deniedCIDRs$1 }
+		} }
+	};
+	return networkPolicy$1 ?? "allow-all";
 }
 
 //#endregion
 //#region src/commands/create.ts
 var import_cjs$11 = /* @__PURE__ */ __toESM(require_cjs());
-var import_ms = /* @__PURE__ */ __toESM(require_ms());
+var import_ms$1 = /* @__PURE__ */ __toESM(require_ms());
 init_source();
 const args$2 = {
-	scope,
 	runtime,
 	timeout,
 	ports: import_cjs$11.multioption({
@@ -11635,12 +11757,17 @@ const args$2 = {
 		long: "connect",
 		description: "Start an interactive shell session after creating the sandbox"
 	}),
-	...networkPolicyArgs
+	...networkPolicyArgs,
+	scope
 };
 const create = import_cjs$11.command({
 	name: "create",
 	description: "Create a sandbox in the specified account and project.",
 	args: args$2,
+	examples: [{
+		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, silent, snapshot: snapshot$1, connect: connect$2, networkPolicy: networkPolicyMode$1, allowedDomains: allowedDomains$1, allowedCIDRs: allowedCIDRs$1, deniedCIDRs: deniedCIDRs$1 }) {
 		const networkPolicy$1 = buildNetworkPolicy({
 			networkPolicy: networkPolicyMode$1,
@@ -11658,7 +11785,7 @@ const create = import_cjs$11.command({
 			projectId: scope$1.project,
 			token: scope$1.token,
 			ports,
-			timeout: (0, import_ms.default)(timeout$1),
+			timeout: (0, import_ms$1.default)(timeout$1),
 			networkPolicy: networkPolicy$1,
 			__interactive: true
 		}) : await sandboxClient.create({
@@ -11667,7 +11794,7 @@ const create = import_cjs$11.command({
 			token: scope$1.token,
 			ports,
 			runtime: runtime$1,
-			timeout: (0, import_ms.default)(timeout$1),
+			timeout: (0, import_ms$1.default)(timeout$1),
 			networkPolicy: networkPolicy$1,
 			__interactive: true
 		});
@@ -11757,12 +11884,12 @@ const list = import_cjs$9.command({
 	aliases: ["ls"],
 	description: "List all sandboxes for the specified account and project.",
 	args: {
-		scope,
 		all: import_cjs$9.flag({
 			long: "all",
 			short: "a",
 			description: "Show all sandboxes (default shows just running)"
-		})
+		}),
+		scope
 	},
 	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, all }) {
 		const sandboxes = await (async () => {
@@ -11794,7 +11921,7 @@ const list = import_cjs$9.command({
 				ID: { value: (s$1) => s$1.id },
 				STATUS: {
 					value: (s$1) => s$1.status,
-					color: (s$1) => SandboxStatusColor.get(s$1.status) ?? source_default.reset
+					color: (s$1) => SandboxStatusColor[s$1.status] ?? source_default.reset
 				},
 				CREATED: { value: (s$1) => timeAgo(s$1.createdAt) },
 				MEMORY: { value: (s$1) => memoryFormatter.format(s$1.memory) },
@@ -11806,13 +11933,15 @@ const list = import_cjs$9.command({
 		}));
 	}
 });
-const SandboxStatusColor = new Map([
-	["running", source_default.cyan],
-	["failed", source_default.red],
-	["stopped", source_default.gray.dim],
-	["stopping", source_default.gray],
-	["pending", source_default.magenta]
-]);
+const SandboxStatusColor = {
+	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/connect.ts
@@ -14124,7 +14253,6 @@ const stop = import_cjs$7.command({
 	aliases: ["rm", "remove"],
 	description: "Stop one or more running sandboxes",
 	args: {
-		scope,
 		sandboxId: import_cjs$7.positional({
 			type: sandboxId,
 			description: "a sandbox ID to stop"
@@ -14132,7 +14260,8 @@ const stop = import_cjs$7.command({
 		sandboxIds: import_cjs$7.restPositionals({
 			type: sandboxId,
 			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) => {
@@ -14152,8 +14281,8 @@ const stop = import_cjs$7.command({
 });
 
 //#endregion
-//#region ../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/batteries/fs.js
-var require_fs = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.14.3/node_modules/cmd-ts/dist/cjs/batteries/fs.js": ((exports) => {
+//#region ../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/batteries/fs.js
+var require_fs = /* @__PURE__ */ __commonJS$1({ "../../node_modules/.pnpm/cmd-ts@0.15.0/node_modules/cmd-ts/dist/cjs/batteries/fs.js": ((exports) => {
 	var __importDefault = exports && exports.__importDefault || function(mod) {
 		return mod && mod.__esModule ? mod : { "default": mod };
 	};
@@ -14230,17 +14359,17 @@ const cp = import_cjs$6.command({
 	description: "Copy files between your local filesystem and a remote sandbox",
 	aliases: ["cp"],
 	args: {
-		scope,
 		source: import_cjs$6.positional({
-			displayName: `SANDBOX_ID:PATH`,
+			displayName: `src`,
 			description: `The source file to copy from local file system, or or a sandbox_id:path from a remote sandbox`,
 			type: localOrRemote
 		}),
 		dest: import_cjs$6.positional({
-			displayName: `SANDBOX_ID:PATH`,
+			displayName: `dst`,
 			description: `The destination file to copy to local file system, or or a sandbox_id:path to a remote sandbox`,
 			type: localOrRemote
-		})
+		}),
+		scope
 	},
 	async handler({ scope: scope$1, source, dest }) {
 		const spinner = ora({ text: "reading file..." }).start();
@@ -14302,8 +14431,8 @@ const logout = import_cjs$5.command({
 //#region src/commands/snapshot.ts
 var import_cjs$4 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
+var import_ms = /* @__PURE__ */ __toESM(require_ms());
 const args = {
-	scope,
 	stop: import_cjs$4.flag({
 		long: "stop",
 		description: "Confirm that the sandbox will be stopped when snapshotting"
@@ -14312,13 +14441,19 @@ const args = {
 		long: "silent",
 		description: "Don't write snapshot ID to stdout"
 	}),
-	sandbox: import_cjs$4.positional({ type: sandboxId })
+	expiration: import_cjs$4.option({
+		long: "expiration",
+		type: import_cjs$4.optional(Duration),
+		description: "The expiration time of the snapshot. Use 0 for no expiration."
+	}),
+	sandbox: import_cjs$4.positional({ type: sandboxId }),
+	scope
 };
 const snapshot = import_cjs$4.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 }) {
+	async handler({ sandbox: sandboxId$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"));
 			process.exitCode = 1;
@@ -14341,7 +14476,7 @@ const snapshot = import_cjs$4.command({
 			return;
 		}
 		const spinner = silent ? void 0 : ora("Creating snapshot...").start();
-		const snapshot$1 = await sandbox.snapshot();
+		const snapshot$1 = await sandbox.snapshot({ expiration: expiration === void 0 ? void 0 : (0, import_ms.default)(expiration) });
 		spinner?.succeed(`Snapshot ${snapshot$1.snapshotId} created.`);
 	}
 });
@@ -14390,12 +14525,54 @@ const list$1 = import_cjs$2.command({
 		}));
 	}
 });
+const get = import_cjs$2.command({
+	name: "get",
+	description: "Get details of a snapshot.",
+	args: {
+		scope,
+		snapshotId: import_cjs$2.positional({
+			type: snapshotId,
+			description: "snapshot ID to retrieve"
+		})
+	},
+	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, snapshotId: id }) {
+		const snapshot$1 = await (async () => {
+			try {
+				var _usingCtx3 = _usingCtx();
+				const _spinner$1 = _usingCtx3.u(acquireRelease(() => ora("Fetching snapshot...").start(), (s$1) => s$1.stop()));
+				return snapshotClient.get({
+					token: token$1,
+					teamId: team$1,
+					projectId: project$1,
+					snapshotId: id
+				});
+			} catch (_) {
+				_usingCtx3.e = _;
+			} finally {
+				_usingCtx3.d();
+			}
+		})();
+		console.log(table({
+			rows: [snapshot$1],
+			columns: {
+				ID: { value: (s$1) => s$1.snapshotId },
+				STATUS: {
+					value: (s$1) => s$1.status,
+					color: (s$1) => SnapshotStatusColor.get(s$1.status) ?? source_default.reset
+				},
+				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 }
+			}
+		}));
+	}
+});
 const remove = import_cjs$2.command({
 	name: "delete",
 	aliases: ["rm", "remove"],
 	description: "Delete one or more snapshots.",
 	args: {
-		scope,
 		snapshotId: import_cjs$2.positional({
 			type: snapshotId,
 			description: "snapshot ID to delete"
@@ -14403,7 +14580,8 @@ const remove = import_cjs$2.command({
 		snapshotIds: import_cjs$2.restPositionals({
 			type: snapshotId,
 			description: "More snapshots IDs to delete"
-		})
+		}),
+		scope
 	},
 	async handler({ scope: { team: team$1, token: token$1, project: project$1 }, snapshotId: snapshotId$1, snapshotIds }) {
 		await new Listr(Array.from(new Set([snapshotId$1, ...snapshotIds]), (snapshotId$2) => {
@@ -14428,6 +14606,7 @@ const snapshots = (0, import_cjs$3.subcommands)({
 	description: "Manage sandbox snapshots",
 	cmds: {
 		list: list$1,
+		get,
 		delete: remove
 	}
 });
@@ -14443,16 +14622,21 @@ var import_cjs$1 = /* @__PURE__ */ __toESM(require_cjs());
 init_source();
 const networkPolicyCommand = import_cjs$1.command({
 	name: "network-policy",
-	description: `Update the network policy of a sandbox
-  
-This is a full update, fully overriding the pre-existing configuration.`,
+	description: `Update the network policy of a sandbox.
+  This will fully override the previous configuration.`,
 	args: {
-		scope,
 		sandbox: import_cjs$1.positional({ type: sandboxId }),
-		...networkPolicyArgs
+		...networkPolicyArgs,
+		mode: import_cjs$1.option({
+			long: "mode",
+			description: `Alias for --network-policy.`,
+			type: import_cjs$1.optional(networkPolicyMode)
+		}),
+		scope
 	},
-	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandbox: sandboxId$1, networkPolicy: networkPolicyMode$1, allowedDomains: allowedDomains$1, allowedCIDRs: allowedCIDRs$1, deniedCIDRs: deniedCIDRs$1 }) {
-		if (networkPolicyMode$1 === void 0) throw new Error(`Network policy mode must be set.`);
+	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 }) {
+		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({
 			networkPolicy: networkPolicyMode$1,
 			allowedDomains: allowedDomains$1,
@@ -14477,10 +14661,11 @@ This is a full update, fully overriding the pre-existing configuration.`,
 		}
 		const spinner = ora("Updating network policy...").start();
 		try {
-			await sandbox.updateNetworkPolicy(networkPolicy$1);
+			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(source_default.dim("   ╰ ") + "mode: " + source_default.cyan(networkPolicy$1.type) + "\n");
+			const mode = typeof response === "string" ? response : "restricted";
+			process.stderr.write(source_default.dim("   ╰ ") + "mode: " + source_default.cyan(mode) + "\n");
 		} catch (error) {
 			spinner.stop();
 			throw error;
@@ -14515,9 +14700,23 @@ const app = (opts) => (0, import_cjs.subcommands)({
 			login,
 			logout
 		}
-	}
+	},
+	examples: [
+		{
+			description: "Create a sandbox and start a shell",
+			command: "sandbox create --connect"
+		},
+		{
+			description: "Run a command in a new sandbox",
+			command: `sandbox run -- node -e "console.log('hello')"`
+		},
+		{
+			description: "Execute command in an existing sandbox",
+			command: `sandbox exec <sandbox-id> -- npm test`
+		}
+	]
 });
 
 //#endregion
-export { StyledError as n, require_cjs as r, app as t };
-//# sourceMappingURL=app-BNIol84k.mjs.map
+export { source_exports as a, init_source as i, StyledError as n, require_cjs as r, app as t };
+//# sourceMappingURL=app-uOMbKaBL.mjs.map