@miosa/cli 1.0.95 → 1.1.1

package/dist/commands/sandbox.js

@@ -23,6 +23,13 @@ import { registerSandboxDevCommands, runFullSandboxDoctor, } from "./sandbox-dev
 const DEFAULT_INTERACTIVE_SANDBOX_TIMEOUT_SEC = 3_600;
 const DEFAULT_CREATE_WAIT_TIMEOUT_SEC = 120;
 const EXPIRING_SANDBOX_THRESHOLD_SEC = 5 * 60;
+const SANDBOX_SIZE_CONTRACTS = {
+    xs: { cpu: 1, memory: 2_048, disk: 10_240 },
+    small: { cpu: 2, memory: 4_096, disk: 10_240 },
+    medium: { cpu: 4, memory: 8_192, disk: 20_480 },
+    large: { cpu: 8, memory: 16_384, disk: 40_960 },
+    xl: { cpu: 16, memory: 32_768, disk: 81_920 },
+};
 export function register(program) {
     // -------------------------------------------------------------------------
     // sandbox / sandboxes command group — built manually to avoid subcommand
@@ -67,7 +74,7 @@ export function register(program) {
             { header: "NAME", key: "name" },
             {
                 header: "STATUS",
-                key: "status",
+                key: "state",
                 color: (val) => statusColor(val.trim()),
             },
             {
@@ -116,7 +123,7 @@ export function register(program) {
             { label: "Name", value: str(sb["name"]) },
             {
                 label: "Status",
-                value: statusColor(str(sb["status"])),
+                value: statusColor(str(sb["state"])),
             },
         ];
         if (sb["template_id"]) {
@@ -174,10 +181,13 @@ export function register(program) {
         .description("Create a new Sandbox")
         .option("--template <template>", "Template / image ID (default: miosa-sandbox)")
         .option("--name <name>", "Human-readable name for the Sandbox")
+        .option("--size <size>", "Named size: xs, small, medium, large, or xl (default: small)", parseSandboxSize)
         .option("--cpu <n>", "vCPU count", parseIntegerOption)
         .option("--memory <size>", "Memory size, e.g. 4096mb or 4gb", parseSizeMb)
         .option("--disk <size>", "Disk size, e.g. 10240mb or 10gb", parseSizeMb)
         .option("--timeout <duration>", "Wall-clock timeout, e.g. 300s, 1h", parseDurationSec)
+        .option("--idle-timeout <duration>", "Idle timeout before pause; 0 disables it (default: 0)", parseDurationSec)
+        .option("--idempotency-key <key>", "Retry-safe create key retained by the service for 24 hours")
         .option("--publish-port <port>", "Expose this port after create", parseIntegerOption)
         .option("--wait", "Wait for sandbox running and published port readiness")
         .option("--probe-path <path>", "HTTP path to probe when --publish-port is set", "/")
@@ -217,19 +227,21 @@ Note:
             renderCreateSuccess(raw, Date.now() - t0);
             return;
         }
-        const body = {};
-        if (opts.template)
-            body["template_id"] = opts.template;
+        const body = {
+            template_id: opts.template ?? "miosa-sandbox",
+        };
         if (opts.name)
             body["name"] = opts.name;
-        if (opts.cpu != null)
-            body["cpu_count"] = opts.cpu;
-        if (opts.memory != null)
-            body["memory_mb"] = opts.memory;
-        if (opts.disk != null)
-            body["disk_size_mb"] = opts.disk;
+        const resources = resolveSandboxResources(opts);
+        body["size"] = resources.size;
+        if (resources.legacy) {
+            body["cpu_count"] = resources.legacy.cpu;
+            body["memory_mb"] = resources.legacy.memory;
+            body["disk_size_mb"] = resources.legacy.disk;
+        }
         const timeoutSec = opts.timeout ?? DEFAULT_INTERACTIVE_SANDBOX_TIMEOUT_SEC;
         body["timeout_sec"] = timeoutSec;
+        body["idle_timeout_sec"] = opts.idleTimeout ?? 0;
         if (opts.source)
             body["source"] = opts.source;
         if (opts.revision)
@@ -271,7 +283,9 @@ Note:
         body["persistent"] = opts.nonPersistent ? false : true;
         if (opts.autoStart)
             body["auto_start"] = true;
-        const raw = unwrap(await client().apiPost(apiPath("/sandboxes"), body));
+        const raw = unwrap(await client().apiPost(apiPath("/sandboxes"), body, opts.idempotencyKey
+            ? { "Idempotency-Key": opts.idempotencyKey }
+            : undefined));
         const sb = (raw ?? {});
         const id = String(sb["id"] ?? "");
         if (opts.publishPort != null && id) {
@@ -307,14 +321,16 @@ Note:
     // delete
     sandbox
         .command("delete <sandbox-id>")
-        .description("Delete a Sandbox")
+        .description("Permanently delete a Sandbox (legacy API extension)")
+        .requiredOption("--force", "Confirm permanent filesystem deletion")
         .option("--json", "Output as JSON")
         .action((id, opts) => runAction(() => deleteAndPrint(`/sandboxes/${enc(id)}`, opts)));
     // destroy / rm — aliases for delete
     sandbox
         .command("destroy <sandbox-id>")
         .alias("rm")
-        .description("Destroy a Sandbox (alias for delete)")
+        .description("Permanently destroy a Sandbox (legacy API extension)")
+        .requiredOption("--force", "Confirm permanent filesystem deletion")
         .option("--json", "Output as JSON")
         .action((id, opts) => runAction(() => deleteAndPrint(`/sandboxes/${enc(id)}`, opts)));
     // action — lifecycle operations: pause, resume
@@ -329,6 +345,11 @@ Note:
         }
         await postAndPrint(`/sandboxes/${enc(id)}/${enc(action)}`, opts, {});
     }));
+    sandbox
+        .command("pause <sandbox-id>")
+        .description("Pause a running persistent Sandbox and preserve its workspace")
+        .option("--json", "Output as JSON")
+        .action((id, opts) => runAction(() => postAndPrint(`/sandboxes/${enc(id)}/pause`, opts, {})));
     // stop — snapshot + pause (mirrors `box stop`)
     sandbox
         .command("stop <sandbox-id>")
@@ -336,7 +357,7 @@ Note:
         .option("--no-snapshot", "Deprecated compatibility flag; stop still preserves state server-side")
         .option("--json", "Output as JSON")
         .action((id, opts) => runAction(async () => {
-        const stopped = unwrap(await client().apiPost(apiPath(`/sandboxes/${enc(id)}/stop`), {}));
+        const stopped = unwrap(await client().apiPost(apiPath(`/sandboxes/${enc(id)}/pause`), {}));
         if (isJsonMode(opts)) {
             console.log(JSON.stringify(stopped, null, 2));
             return;
@@ -357,19 +378,27 @@ Note:
     sandbox
         .command("resume <sandbox-id>")
         .description("Resume a paused Sandbox")
+        .option("--idempotency-key <key>", "Retry-safe lifecycle key sent as Idempotency-Key")
         .option("--json", "Output as JSON")
         .action((id, opts) => runAction(() => resumeSandboxAndPrint(id, opts)));
     // fork — clone from snapshot in one call (mirrors `box fork`)
     sandbox
         .command("fork <sandbox-id>")
-        .description("Clone (fork) a Sandbox from its current state")
-        .option("--name <name>", "Optional name for the forked Sandbox")
+        .description("Snapshot and fork a running Sandbox into a new Sandbox")
+        .option("--template <template>", "Template or immutable image override")
+        .option("--timeout <duration>", "Fork timeout", parseDurationSec)
+        .option("--idempotency-key <key>", "Retry-safe fork key sent as Idempotency-Key")
         .option("--json", "Output as JSON")
         .action((id, opts) => runAction(async () => {
         const body = {};
-        if (opts.name)
-            body["name"] = opts.name;
-        await postAndPrint(`/sandboxes/${enc(id)}/fork`, opts, body);
+        if (opts.template)
+            body["template_id"] = opts.template;
+        if (opts.timeout != null)
+            body["timeout_sec"] = opts.timeout;
+        const result = unwrap(await client().apiPost(apiPath(`/sandboxes/${enc(id)}/fork`), body, opts.idempotencyKey
+            ? { "Idempotency-Key": opts.idempotencyKey }
+            : undefined));
+        printValue(result, opts);
     }));
     // desktop — open the Sandbox's web desktop URL (mirrors `box desktop`).
     // Sandboxes are headless by default; only templates that expose a desktop
@@ -2293,7 +2322,7 @@ function parsePublishDatabase(value) {
         normalized === "postgresql" ||
         normalized === "create:postgres" ||
         normalized === "create:postgresql") {
-        return { engine: "postgresql", engine_version: "15" };
+        return { engine: "postgresql", engine_version: "16" };
     }
     if (normalized.startsWith("existing:")) {
         return { existing_database_id: value.slice("existing:".length) };
@@ -2603,7 +2632,10 @@ async function waitForSandboxRunning(c, sandboxId, timeoutSec) {
 }
 async function resumeSandboxAndPrint(sandboxId, opts) {
     try {
-        await postAndPrint(`/sandboxes/${enc(sandboxId)}/resume`, opts, {});
+        const result = unwrap(await client().apiPost(apiPath(`/sandboxes/${enc(sandboxId)}/resume`), {}, opts.idempotencyKey
+            ? { "Idempotency-Key": opts.idempotencyKey }
+            : undefined));
+        printValue(result, opts);
     }
     catch (err) {
         if (err instanceof ApiResponseError && err.code === "SANDBOX_NOT_PAUSED") {
@@ -3387,6 +3419,36 @@ function parseIntegerOption(value) {
         throw new UserError(`Invalid integer: ${value}`);
     return n;
 }
+function parseSandboxSize(value) {
+    const size = String(value).trim().toLowerCase();
+    if (size in SANDBOX_SIZE_CONTRACTS)
+        return size;
+    throw new UserError(`Invalid sandbox size: ${value}. Expected xs, small, medium, large, or xl.`);
+}
+function resolveSandboxResources(opts) {
+    const legacyValues = [opts.cpu, opts.memory, opts.disk];
+    const legacyCount = legacyValues.filter((value) => value != null).length;
+    if (legacyCount === 0)
+        return { size: opts.size ?? "small" };
+    if (legacyCount !== legacyValues.length) {
+        throw new UserError("Legacy resource overrides require --cpu, --memory, and --disk together. Prefer --size.");
+    }
+    const legacy = {
+        cpu: opts.cpu,
+        memory: opts.memory,
+        disk: opts.disk,
+    };
+    const matchingSize = Object.entries(SANDBOX_SIZE_CONTRACTS).find(([, contract]) => contract.cpu === legacy.cpu &&
+        contract.memory === legacy.memory &&
+        contract.disk === legacy.disk)?.[0];
+    if (!matchingSize) {
+        throw new UserError("Legacy --cpu/--memory/--disk values must exactly match a named sandbox size. Prefer --size.");
+    }
+    if (opts.size && opts.size !== matchingSize) {
+        throw new UserError(`Legacy resource overrides match ${matchingSize}, not requested size ${opts.size}.`);
+    }
+    return { size: matchingSize, legacy };
+}
 function parseSizeMb(value) {
     const match = String(value)
         .trim()