@miosa/cli 1.0.91 → 1.0.93

package/dist/commands/devices.js

@@ -1,18 +1,8 @@
 import chalk from "chalk";
-import { readFileSync, writeFileSync } from "node:fs";
+import { apiPath, client, unwrap } from "./enterprise-util.js";
 import { isJsonMode } from "../cli-env.js";
 import { renderTable } from "../ui/table.js";
-import { apiPath, client, unwrap } from "./enterprise-util.js";
 import { handleError } from "./util.js";
-const RUNTIME_BINARIES = {
-    "claude-code": ["claude-code", "claude"],
-    claude: ["claude"],
-    codex: ["codex"],
-    hermes: ["hermes"],
-    osa: ["osa"],
-    pi: ["pi"],
-    custom: [],
-};
 const DEVICE_CATALOG = [
     {
         kind: "sandbox_worker",
@@ -22,25 +12,25 @@ const DEVICE_CATALOG = [
         persistence: "Use --timeout 1h or sandbox extend during active work. Use snapshot/checkpoint/fork for durable recovery points.",
         primary_commands: [
             "miosa sandbox create --template nextjs --timeout 1h --wait --json",
-            "miosa sandbox prompt <id> --provider codex --json -- <task>",
+            "miosa sandbox run-agent <id> --runner codex --json -- <task>",
             "miosa sandbox exec <id> -- sh -lc '<command>'",
             "miosa sandbox write-file <id> /workspace/file ./file --json",
             "miosa sandbox publish <id> --wait --json",
         ],
         use_when: [
             "Coding agents should build inside the remote workspace.",
-            "You need filesystem, command execution, package installs, preview ports, artifacts, or app publish.",
+            "You need filesystem, command execution, package installs, preview ports, files, or app publish.",
             "You want Polsia/Nebula-style virtual device behavior without a GUI desktop.",
         ],
         avoid_when: [
-            "The task requires a full desktop browser session with VNC/CUA.",
+            "The task requires a full desktop browser session with VNC and desktop control.",
             "You need a long-lived production app; publish it after preview is ready.",
         ],
     },
     {
         kind: "computer",
         label: "Computer",
-        purpose: "Durable VM/desktop device for browser automation, CUA sessions, SSH, tunnels, and persistent agent control.",
+        purpose: "Durable VM/desktop device for browser automation, computer control sessions, SSH, tunnels, and persistent agent control.",
         lifecycle: "Managed as a Computer. It is the correct target for GUI/browser-heavy work and remote operator sessions.",
         persistence: "Use computer checkpoints, volumes, tunnels, and agent sessions for long-lived desktop workflows.",
         primary_commands: [
@@ -52,12 +42,12 @@ const DEVICE_CATALOG = [
         ],
         use_when: [
             "The agent must use Chromium or a full desktop.",
-            "The workflow needs login to dashboards, form filling, screenshots, or CUA-style control.",
+            "The workflow needs login to dashboards, form filling, screenshots, or desktop control.",
             "A human and agent need to share the same persistent machine state.",
         ],
         avoid_when: [
             "Simple code generation/build/test work fits a cheaper sandbox worker.",
-            "The output is a production deployment; use Docker Deploy or standard deploy after build.",
+            "The output is a production deployment; use App Engine or standard deploy after build.",
         ],
     },
     {
@@ -82,7 +72,7 @@ const DEVICE_CATALOG = [
     },
     {
         kind: "docker_deploy_host",
-        label: "Docker Deploy Host",
+        label: "App Engine Host",
         purpose: "Workspace appliance VM that runs Docker containers for durable apps published from sandboxes.",
         lifecycle: "Always-on deployment capacity. Apps are versioned releases, not interactive coding workspaces.",
         persistence: "App releases and routing are durable; use sandbox workers for edits, then publish to the host.",
@@ -97,22 +87,22 @@ const DEVICE_CATALOG = [
         ],
         avoid_when: [
             "Interactive agent work is still happening; finish in a sandbox first.",
-            "The app needs the standard MIOSA Deploy runtime instead of Docker Deploy.",
+            "The app needs the standard MIOSA Deploy runtime instead of App Engine.",
         ],
     },
 ];
 const ROUTING = {
-    build_code: "Use sandbox_worker. Run the coding agent inside it with sandbox prompt/exec and publish after HTTP 200.",
-    browser_automation: "Use computer. It has the desktop/browser/CUA surface needed for dashboards, clicks, and visual inspection.",
+    build_code: "Use sandbox_worker. Run the coding agent inside it with sandbox run-agent/exec and publish after HTTP 200.",
+    browser_automation: "Use computer. It has the desktop/browser control surface needed for dashboards, clicks, and visual inspection.",
     durable_app: "Use docker_deploy_host after the app is ready. Publish from the sandbox into a versioned deployment.",
     local_private_context: "Use local_device only for local discovery or user-owned files, then move execution into a sandbox/computer.",
-    massive_parallel_agents: "Use one sandbox_worker per isolated code/task shard, computers only where GUI/browser state is required, and Docker Deploy for durable outputs.",
+    massive_parallel_agents: "Use one sandbox_worker per isolated code/task shard, computers only where GUI/browser state is required, and App Engine for durable outputs.",
 };
 export function register(program) {
     const devices = program
         .command("devices")
         .alias("device")
-        .description("Inspect MIOSA device types: sandboxes, computers, local devices, and Docker Deploy hosts");
+        .description("Inspect MIOSA device types: sandboxes, computers, local devices, and App Engine hosts");
     devices
         .command("catalog")
         .description("Print the MIOSA device catalog and routing guidance")
@@ -143,8 +133,8 @@ export function register(program) {
         .option("--json", "Output as JSON")
         .action((opts) => runDeviceAction(async () => {
         const filter = normalizeKindFilter(opts.type ?? "all");
-        const records = unwrapList(await client().apiGet(apiPath(`/devices${queryString({ kind: apiKindFilter(filter) })}`)), ["devices"]).map(normalizeDevice);
-        const output = { devices: records };
+        const { devices: records, errors } = await listDevices(filter);
+        const output = { devices: records, errors };
         if (isJsonMode(opts)) {
             console.log(JSON.stringify(output, null, 2));
             return;
@@ -156,303 +146,54 @@ export function register(program) {
             renderTable(records, [
                 { header: "ID", key: (row) => row.id, width: 12 },
                 { header: "KIND", key: (row) => row.kind },
-                { header: "NAME", key: (row) => row.name ?? "-" },
-                { header: "STATE", key: (row) => row.state ?? "-" },
+                { header: "NAME", key: (row) => row.name ?? "—" },
+                { header: "STATE", key: (row) => row.state ?? "—" },
                 {
                     header: "READY",
-                    key: (row) => row.ready == null ? "-" : row.ready ? "yes" : "no",
+                    key: (row) => row.ready == null ? "—" : row.ready ? "yes" : "no",
                 },
                 {
                     header: "PERSISTENT",
                     key: (row) => row.persistent == null
-                        ? "-"
+                        ? "—"
                         : row.persistent
                             ? "yes"
                             : "no",
                 },
-                { header: "PREVIEW", key: (row) => row.preview_url ?? "-" },
+                { header: "PREVIEW", key: (row) => row.preview_url ?? "—" },
             ]);
         }
-    }));
-    devices
-        .command("show <id>")
-        .description("Show one hosted device")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const raw = unwrap(await client().apiGet(apiPath(`/devices/${encodeURIComponent(id)}`)));
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(raw, null, 2));
-            return;
-        }
-        printObject(raw);
-    }));
-    devices
-        .command("capabilities <id>")
-        .description("Show what a device supports")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const raw = unwrap(await client().apiGet(apiPath(`/devices/${encodeURIComponent(id)}/capabilities`)));
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(raw, null, 2));
-            return;
+        if (errors.length > 0) {
+            console.log();
+            console.log(chalk.yellow("Partial inventory errors:"));
+            for (const error of errors) {
+                console.log(`- ${error.source}: ${error.message}`);
+            }
         }
-        printObject(raw);
     }));
-    devices
-        .command("exec <id>")
-        .description("Run a command inside a sandbox/computer device")
-        .requiredOption("-c, --command <command>", "Command to run")
-        .option("--timeout-ms <ms>", "Command timeout in milliseconds")
-        .option("--cwd <path>", "Working directory")
-        .option("--env <KEY=VALUE>", "Environment variable. Repeatable.", collect, [])
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const raw = unwrap(await client().apiPost(apiPath(`/devices/${encodeURIComponent(id)}/exec`), {
-            command: opts.command,
-            timeout_ms: opts.timeoutMs ? Number.parseInt(opts.timeoutMs, 10) : undefined,
-            cwd: opts.cwd,
-            env: parseEnv(opts.env ?? []),
-        }));
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(raw, null, 2));
-            return;
-        }
-        printObject(raw);
-    }));
-    devices
-        .command("doctor <id>")
-        .description("Run an agent-friendly health probe against a device")
-        .option("--port <port>", "Also verify a port can be exposed")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const encoded = encodeURIComponent(id);
-        const checks = [];
-        await recordCheck(checks, "capabilities", async () => unwrap(await client().apiGet(apiPath(`/devices/${encoded}/capabilities`))));
-        await recordCheck(checks, "exec", async () => unwrap(await client().apiPost(apiPath(`/devices/${encoded}/exec`), {
-            command: "pwd && uname -s",
-            timeout_ms: 30_000,
-        })));
-        await recordCheck(checks, "files", async () => unwrapList(await client().apiGet(apiPath(`/devices/${encoded}/files${queryString({ path: "/workspace" })}`)), ["entries", "files"]));
-        if (opts.port) {
-            await recordCheck(checks, "expose", async () => unwrap(await client().apiPost(apiPath(`/devices/${encoded}/expose`), {
-                port: Number.parseInt(opts.port ?? "", 10),
-            })));
-        }
-        const output = {
-            device_id: id,
-            ok: checks.every((check) => check.ok),
-            checks,
-        };
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(output, null, 2));
-            return;
-        }
-        console.log(chalk.bold(`Device doctor ${id}`));
-        for (const check of checks) {
-            const status = check.ok ? chalk.green("ok") : chalk.red("fail");
-            console.log(`${status.padEnd(12)} ${check.name}`);
-            if (!check.ok && check.error)
-                console.log(chalk.red(`  ${check.error}`));
-        }
-    }));
-    devices
-        .command("bootstrap <id>")
-        .description("Prepare a device for an agent runtime and write a MIOSA runtime manifest")
-        .requiredOption("--runtime <runtime>", "osa, claude-code, claude, codex, hermes, pi, or custom")
-        .option("--cwd <path>", "Runtime working directory", "/workspace")
-        .option("--connector <uid>", "Required connector UID. Repeatable.", collect, [])
-        .option("--env <KEY=VALUE>", "Runtime env default. Repeatable.", collect, [])
-        .option("--mcp <name=url>", "Runtime MCP server hint. Repeatable.", collect, [])
-        .option("--install-command <command>", "Optional command to install/bootstrap the runtime")
-        .option("--skip-probe", "Do not run a binary/runtime probe after writing manifest")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const runtime = normalizeRuntime(opts.runtime);
-        const cwd = opts.cwd ?? "/workspace";
-        const manifestPath = `${cwd.replace(/\/$/, "")}/.miosa/runtime-bootstrap.json`;
-        const manifest = {
-            version: 1,
-            runtime,
-            cwd,
-            expected_binaries: RUNTIME_BINARIES[runtime] ?? [],
-            connectors: opts.connector ?? [],
-            env: parseEnv(opts.env ?? []) ?? {},
-            mcp: parseMcp(opts.mcp ?? []),
-            created_by: "miosa-cli",
-        };
-        const steps = [];
-        await recordCheck(steps, "write_manifest", async () => unwrap(await client().apiPost(apiPath(`/devices/${encodeURIComponent(id)}/files/write`), {
-            path: manifestPath,
-            content: `${JSON.stringify(manifest, null, 2)}\n`,
-        })));
-        if (opts.installCommand) {
-            await recordCheck(steps, "install", async () => unwrap(await client().apiPost(apiPath(`/devices/${encodeURIComponent(id)}/exec`), {
-                command: opts.installCommand,
-                cwd,
-                timeout_ms: 600_000,
-            })));
-        }
-        if (!opts.skipProbe) {
-            await recordCheck(steps, "probe", async () => unwrap(await client().apiPost(apiPath(`/devices/${encodeURIComponent(id)}/exec`), {
-                command: runtimeProbeCommand(runtime),
-                cwd,
-                timeout_ms: 60_000,
-            })));
-        }
-        const output = {
-            device_id: id,
-            ok: steps.every((step) => step.ok),
-            runtime,
-            manifest_path: manifestPath,
-            steps,
-        };
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(output, null, 2));
-            return;
-        }
-        console.log(chalk.bold(`Bootstrapped ${runtime} on ${id}`));
-        console.log(`${chalk.bold("manifest")} ${manifestPath}`);
-        for (const step of steps) {
-            const status = step.ok ? chalk.green("ok") : chalk.red("fail");
-            console.log(`${status.padEnd(12)} ${step.name}`);
-            if (!step.ok && step.error)
-                console.log(chalk.red(`  ${step.error}`));
-        }
-    }));
-    const files = devices
-        .command("files")
-        .description("Read, write, and list files inside a device");
-    files
-        .command("list <id>")
-        .description("List files inside a device")
-        .option("--path <path>", "Directory path", "/workspace")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const raw = unwrapList(await client().apiGet(apiPath(`/devices/${encodeURIComponent(id)}/files${queryString({ path: opts.path })}`)), ["entries", "files"]);
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(raw, null, 2));
-            return;
-        }
-        renderTable(raw, [
-            { header: "PATH", key: (row) => optionalString(row, "path") ?? "" },
-            { header: "TYPE", key: (row) => optionalString(row, "type") ?? "-" },
-            { header: "SIZE", key: (row) => String(optionalNumber(row, "size") ?? "-") },
-        ]);
-    }));
-    files
-        .command("read <id>")
-        .description("Read a file from a device")
-        .requiredOption("--path <path>", "File path")
-        .option("-o, --output <path>", "Write decoded bytes to a local file")
-        .option("--decode", "Print decoded text instead of the JSON/base64 envelope")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const raw = unwrap(await client().apiGet(apiPath(`/devices/${encodeURIComponent(id)}/files/read${queryString({ path: opts.path })}`)));
-        if (opts.output) {
-            writeFileSync(opts.output, decodeFileContent(raw));
-            if (!isJsonMode(opts))
-                console.log(chalk.green(`Wrote ${opts.output}`));
-            else
-                console.log(JSON.stringify({ output: opts.output }, null, 2));
-            return;
-        }
-        if (opts.decode) {
-            console.log(decodeFileContent(raw).toString("utf8"));
-            return;
-        }
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(raw, null, 2));
-            return;
-        }
-        printObject(raw);
-    }));
-    files
-        .command("write <id>")
-        .description("Write a file into a device")
-        .requiredOption("--path <path>", "Destination file path")
-        .option("--content <text>", "Text content to write")
-        .option("--content-base64 <base64>", "Base64 content to write")
-        .option("--file <path>", "Read local file bytes and upload as base64")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const body = writeFileBody(opts);
-        const raw = unwrap(await client().apiPost(apiPath(`/devices/${encodeURIComponent(id)}/files/write`), body));
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(raw, null, 2));
-            return;
-        }
-        printObject(raw);
-    }));
-    devices
-        .command("expose <id>")
-        .description("Expose a device port through MIOSA routing")
-        .requiredOption("--port <port>", "Port to expose")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const raw = unwrap(await client().apiPost(apiPath(`/devices/${encodeURIComponent(id)}/expose`), {
-            port: Number.parseInt(opts.port, 10),
-        }));
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(raw, null, 2));
-            return;
+}
+async function listDevices(filter) {
+    const records = [];
+    const errors = [];
+    if (filter === "all" || filter === "sandbox_worker") {
+        try {
+            const sandboxes = unwrapList(await client().apiGet(apiPath("/sandboxes")), ["sandboxes"]);
+            records.push(...sandboxes.map(normalizeSandbox));
         }
-        printObject(raw);
-    }));
-    devices
-        .command("browser <id>")
-        .description("Return browser/desktop connection details for a computer-backed device")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const raw = unwrap(await client().apiGet(apiPath(`/devices/${encodeURIComponent(id)}/browser`)));
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(raw, null, 2));
-            return;
+        catch (err) {
+            errors.push(deviceListError("sandboxes", err));
         }
-        printObject(raw);
-    }));
-    devices
-        .command("pause <id>")
-        .description("Pause a device session when supported")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => postDeviceLifecycle(id, "pause", opts));
-    devices
-        .command("stop <id>")
-        .description("Stop a device session when supported")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => postDeviceLifecycle(id, "stop", opts));
-    devices
-        .command("resume <id>")
-        .description("Resume a device session when supported")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => postDeviceLifecycle(id, "resume", opts));
-    devices
-        .command("extend <id>")
-        .description("Extend a device timeout when supported")
-        .requiredOption("--timeout-sec <seconds>", "New timeout in seconds")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const raw = unwrap(await client().apiPost(apiPath(`/devices/${encodeURIComponent(id)}/extend`), {
-            timeout_sec: Number.parseInt(opts.timeoutSec, 10),
-        }));
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(raw, null, 2));
-            return;
+    }
+    if (filter === "all" || filter === "computer") {
+        try {
+            const computers = unwrapList(await client().apiGet(apiPath("/computers")), ["computers"]);
+            records.push(...computers.map(normalizeComputer));
         }
-        printObject(raw);
-    }));
-    devices
-        .command("destroy <id>")
-        .alias("delete")
-        .description("Destroy/delete a device when supported")
-        .option("--json", "Output as JSON")
-        .action((id, opts) => runDeviceAction(async () => {
-        const raw = unwrap(await client().apiDelete(apiPath(`/devices/${encodeURIComponent(id)}`)));
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(raw, null, 2));
-            return;
+        catch (err) {
+            errors.push(deviceListError("computers", err));
         }
-        printObject(raw);
-    }));
+    }
+    return { devices: records, errors };
 }
 function normalizeKindFilter(value) {
     const normalized = value.trim().toLowerCase().replaceAll("-", "_");
@@ -466,19 +207,6 @@ function normalizeKindFilter(value) {
         return "computer";
     throw new Error(`Unsupported device type "${value}". Use: all, sandbox_worker, sandbox, computer`);
 }
-function apiKindFilter(filter) {
-    if (filter === "all")
-        return undefined;
-    if (filter === "sandbox_worker")
-        return "sandbox";
-    return filter;
-}
-function normalizeDevice(row) {
-    const kind = optionalString(row, "kind") ?? optionalString(row, "type") ?? "";
-    if (kind === "computer")
-        return normalizeComputer(row);
-    return normalizeSandbox(row);
-}
 function normalizeSandbox(row) {
     return {
         id: stringField(row, "id"),
@@ -519,6 +247,14 @@ function unwrapList(payload, keys) {
     }
     return [];
 }
+function deviceListError(source, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        source,
+        message,
+        retryable: /fetch failed|ECONNRESET|HTTP 502|other side closed|socket hang up|bad gateway/i.test(message),
+    };
+}
 function stringField(row, key) {
     const value = row[key];
     return typeof value === "string" ? value : String(value ?? "");
@@ -536,117 +272,6 @@ function optionalNumber(row, key) {
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }
-function queryString(params) {
-    const search = new URLSearchParams();
-    for (const [key, value] of Object.entries(params)) {
-        if (value !== undefined && value !== "")
-            search.set(key, value);
-    }
-    const encoded = search.toString();
-    return encoded ? `?${encoded}` : "";
-}
-function printObject(value) {
-    if (!isRecord(value)) {
-        console.log(String(value ?? ""));
-        return;
-    }
-    for (const [key, cell] of Object.entries(value)) {
-        const printable = cell === null || cell === undefined
-            ? "-"
-            : typeof cell === "object"
-                ? JSON.stringify(cell)
-                : String(cell);
-        console.log(`${chalk.bold(key.padEnd(18))} ${printable}`);
-    }
-}
-function collect(value, previous) {
-    previous.push(value);
-    return previous;
-}
-function parseEnv(entries) {
-    if (entries.length === 0)
-        return undefined;
-    const out = {};
-    for (const entry of entries) {
-        const index = entry.indexOf("=");
-        if (index <= 0)
-            throw new Error(`Invalid --env value "${entry}". Use KEY=VALUE.`);
-        out[entry.slice(0, index)] = entry.slice(index + 1);
-    }
-    return out;
-}
-function parseMcp(entries) {
-    return entries.map((entry) => {
-        const index = entry.indexOf("=");
-        if (index <= 0)
-            throw new Error(`Invalid --mcp value "${entry}". Use name=url.`);
-        return { name: entry.slice(0, index), url: entry.slice(index + 1) };
-    });
-}
-function normalizeRuntime(value) {
-    const runtime = value.trim().toLowerCase();
-    if (!(runtime in RUNTIME_BINARIES)) {
-        throw new Error(`Unsupported runtime "${value}". Use: osa, claude-code, claude, codex, hermes, pi, custom`);
-    }
-    return runtime;
-}
-function runtimeProbeCommand(runtime) {
-    const binaries = RUNTIME_BINARIES[runtime] ?? [];
-    if (binaries.length === 0) {
-        return "printf 'custom runtime manifest written\\n'";
-    }
-    const checks = binaries
-        .map((binary) => `command -v ${shellWord(binary)} >/dev/null 2>&1`)
-        .join(" || ");
-    const display = binaries.join(" or ");
-    return `${checks} && printf 'runtime available: ${display}\\n' || { printf 'runtime missing: ${display}\\n' >&2; exit 127; }`;
-}
-function shellWord(value) {
-    if (/^[A-Za-z0-9_./:-]+$/.test(value))
-        return value;
-    return `'${value.replaceAll("'", "'\"'\"'")}'`;
-}
-function decodeFileContent(row) {
-    const content = optionalString(row, "content") ?? "";
-    const encoding = optionalString(row, "encoding") ?? "base64";
-    return encoding === "base64"
-        ? Buffer.from(content, "base64")
-        : Buffer.from(content, "utf8");
-}
-function writeFileBody(opts) {
-    const provided = [opts.content, opts.contentBase64, opts.file].filter((value) => value !== undefined);
-    if (provided.length !== 1) {
-        throw new Error("Use exactly one of --content, --content-base64, or --file");
-    }
-    return {
-        path: opts.path,
-        content: opts.content,
-        content_base64: opts.contentBase64 ??
-            (opts.file ? readFileSync(opts.file).toString("base64") : undefined),
-    };
-}
-async function recordCheck(checks, name, fn) {
-    try {
-        checks.push({ name, ok: true, detail: await fn() });
-    }
-    catch (err) {
-        checks.push({
-            name,
-            ok: false,
-            error: err instanceof Error ? err.message : String(err),
-        });
-    }
-}
-function postDeviceLifecycle(id, action, opts) {
-    return runDeviceAction(async () => {
-        const raw = unwrap(await client().apiPost(apiPath(`/devices/${encodeURIComponent(id)}/${action}`), {}));
-        if (isJsonMode(opts)) {
-            console.log(JSON.stringify(raw, null, 2));
-            return;
-        }
-        printObject(raw);
-    });
-}
 async function runDeviceAction(fn) {
     try {
         await fn();