@miosa/cli 1.0.63 → 1.0.65

package/dist/commands/devices.js

@@ -0,0 +1,283 @@
+import chalk from "chalk";
+import { apiPath, client, unwrap } from "./enterprise-util.js";
+import { isJsonMode } from "../cli-env.js";
+import { renderTable } from "../ui/table.js";
+import { handleError } from "./util.js";
+const DEVICE_CATALOG = [
+    {
+        kind: "sandbox_worker",
+        label: "Sandbox Worker",
+        purpose: "Isolated Linux workspace for agents to create files, run code, preview apps, snapshot, fork, and publish.",
+        lifecycle: "Persistent by default. Stop snapshots state; resume/fork continues from saved filesystem when backend snapshots are available.",
+        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 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 want Polsia/Nebula-style virtual device behavior without a GUI desktop.",
+        ],
+        avoid_when: [
+            "The task requires a full desktop browser session with VNC/CUA.",
+            "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.",
+        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: [
+            "miosa computers list --json",
+            "miosa up --computer --json",
+            "miosa agent <computer-id> '<task>'",
+            "miosa desktop open <computer-id>",
+            "miosa tunnel open <computer-id> --port 3000",
+        ],
+        use_when: [
+            "The agent must use Chromium or a full desktop.",
+            "The workflow needs login to dashboards, form filling, screenshots, or CUA-style 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.",
+        ],
+    },
+    {
+        kind: "local_device",
+        label: "Local Device",
+        purpose: "A developer-owned machine connected through MIOSA CLI/MCP for local files, diagnostics, and private tools.",
+        lifecycle: "Not hosted by MIOSA. The user owns uptime, filesystem state, and local credentials.",
+        persistence: "State is whatever exists on the developer machine; do not assume cloud resume semantics.",
+        primary_commands: [
+            "miosa mcp install --client claude --scope user",
+            "miosa doctor --json",
+            "miosa status --json",
+        ],
+        use_when: [
+            "The user wants to connect an existing local coding environment.",
+            "The agent needs local repository context before creating a cloud device.",
+        ],
+        avoid_when: [
+            "Customer code must stay isolated in MIOSA-hosted infrastructure.",
+            "The workflow needs reproducible shared cloud state.",
+        ],
+    },
+    {
+        kind: "docker_deploy_host",
+        label: "Docker Deploy 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.",
+        primary_commands: [
+            "miosa docker-deploy hosts list --json",
+            "miosa sandbox publish <id> --docker-deploy --wait --json",
+            "miosa deploy --docker-deploy --wait --json",
+        ],
+        use_when: [
+            "You need many small apps, APIs, funnels, or client sites in one workspace appliance.",
+            "You want stable public URLs backed by Docker containers.",
+        ],
+        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.",
+        ],
+    },
+];
+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.",
+    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.",
+};
+export function register(program) {
+    const devices = program
+        .command("devices")
+        .alias("device")
+        .description("Inspect MIOSA device types: sandboxes, computers, local devices, and Docker Deploy hosts");
+    devices
+        .command("catalog")
+        .description("Print the MIOSA device catalog and routing guidance")
+        .option("--json", "Output as JSON")
+        .action((opts) => runDeviceAction(async () => {
+        const output = { devices: DEVICE_CATALOG, routing: ROUTING };
+        if (isJsonMode(opts)) {
+            console.log(JSON.stringify(output, null, 2));
+            return;
+        }
+        console.log(chalk.bold("MIOSA devices"));
+        console.log();
+        renderTable(DEVICE_CATALOG, [
+            { header: "KIND", key: (row) => row.kind },
+            { header: "LABEL", key: (row) => row.label },
+            { header: "PURPOSE", key: (row) => row.purpose, width: 72 },
+        ]);
+        console.log();
+        console.log(chalk.bold("Routing"));
+        for (const [job, guidance] of Object.entries(ROUTING)) {
+            console.log(`${chalk.cyan(job.padEnd(24))} ${guidance}`);
+        }
+    }));
+    devices
+        .command("list")
+        .description("List active hosted devices from sandboxes and computers")
+        .option("--type <kind>", "Filter: all, sandbox_worker, sandbox, computer", "all")
+        .option("--json", "Output as JSON")
+        .action((opts) => runDeviceAction(async () => {
+        const filter = normalizeKindFilter(opts.type ?? "all");
+        const { devices: records, errors } = await listDevices(filter);
+        const output = { devices: records, errors };
+        if (isJsonMode(opts)) {
+            console.log(JSON.stringify(output, null, 2));
+            return;
+        }
+        if (records.length === 0) {
+            console.log(chalk.dim("No hosted devices found."));
+        }
+        else {
+            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: "READY",
+                    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 ?? "—" },
+            ]);
+        }
+        if (errors.length > 0) {
+            console.log();
+            console.log(chalk.yellow("Partial inventory errors:"));
+            for (const error of errors) {
+                console.log(`- ${error.source}: ${error.message}`);
+            }
+        }
+    }));
+}
+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));
+        }
+        catch (err) {
+            errors.push(deviceListError("sandboxes", err));
+        }
+    }
+    if (filter === "all" || filter === "computer") {
+        try {
+            const computers = unwrapList(await client().apiGet(apiPath("/computers")), ["computers"]);
+            records.push(...computers.map(normalizeComputer));
+        }
+        catch (err) {
+            errors.push(deviceListError("computers", err));
+        }
+    }
+    return { devices: records, errors };
+}
+function normalizeKindFilter(value) {
+    const normalized = value.trim().toLowerCase().replaceAll("-", "_");
+    if (normalized === "all")
+        return "all";
+    if (normalized === "sandbox")
+        return "sandbox_worker";
+    if (normalized === "sandbox_worker")
+        return "sandbox_worker";
+    if (normalized === "computer")
+        return "computer";
+    throw new Error(`Unsupported device type "${value}". Use: all, sandbox_worker, sandbox, computer`);
+}
+function normalizeSandbox(row) {
+    return {
+        id: stringField(row, "id"),
+        kind: "sandbox_worker",
+        source: "sandboxes",
+        name: optionalString(row, "name"),
+        state: optionalString(row, "state") ?? optionalString(row, "status"),
+        ready: optionalBoolean(row, "ready"),
+        persistent: optionalBoolean(row, "persistent"),
+        always_on: optionalBoolean(row, "always_on"),
+        template: optionalString(row, "template_id") ?? optionalString(row, "template"),
+        preview_url: optionalString(row, "preview_url"),
+        timeout_remaining_ms: optionalNumber(row, "timeout_remaining_ms"),
+    };
+}
+function normalizeComputer(row) {
+    return {
+        id: stringField(row, "id"),
+        kind: "computer",
+        source: "computers",
+        name: optionalString(row, "name"),
+        state: optionalString(row, "status") ?? optionalString(row, "state"),
+        ready: optionalBoolean(row, "ready"),
+        region: optionalString(row, "region"),
+        template: optionalString(row, "template_type") ?? optionalString(row, "template"),
+    };
+}
+function unwrapList(payload, keys) {
+    const value = unwrap(payload);
+    if (Array.isArray(value))
+        return value.filter(isRecord);
+    if (isRecord(value)) {
+        for (const key of keys) {
+            const nested = value[key];
+            if (Array.isArray(nested))
+                return nested.filter(isRecord);
+        }
+    }
+    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 ?? "");
+}
+function optionalString(row, key) {
+    const value = row[key];
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function optionalBoolean(row, key) {
+    return typeof row[key] === "boolean" ? row[key] : undefined;
+}
+function optionalNumber(row, key) {
+    return typeof row[key] === "number" ? row[key] : undefined;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+async function runDeviceAction(fn) {
+    try {
+        await fn();
+    }
+    catch (err) {
+        handleError(err);
+    }
+}
+//# sourceMappingURL=devices.js.map

package/dist/commands/devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.js","sourceRoot":"","sources":["../../src/commands/devices.ts"],"names":[],"mappings":"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"}

package/dist/commands/sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/commands/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2DzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAksE/C"}
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/commands/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2DzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2sE/C"}

package/dist/commands/sandbox.js

@@ -362,11 +362,12 @@ export function register(program) {
     }));
     registerSandboxConnectorCommands(sandbox);
     // prompt — invoke an in-Sandbox AI agent CLI (mirrors `box prompt`).
-    // Implemented as `exec claude/codex/claude-code <instruction>`.
+    // Implemented as sandbox exec so agents work inside the remote filesystem.
     sandbox
         .command("prompt <sandbox-id> <instruction...>")
-        .description("Run an in-Sandbox AI agent (claude/codex) with the given instruction")
-        .option("--provider <name>", "AI provider: claude (default), codex, claude-code")
+        .description("Run an in-Sandbox AI agent runtime with the given instruction")
+        .option("--provider <name>", "Agent runtime: claude (default), claude-code, codex, pi, hermes, osa, custom")
+        .option("--runtime-command <command>", "Executable command for --provider custom, e.g. 'hermes-agent run'")
         .option("--model <name>", "Provider-specific model name")
         .option("--connector <uid>", "MIOSA Connect connector UID to preflight before running the agent")
         .option("--preflight", "Verify the Sandbox has the requested provider connector before exec")
@@ -375,8 +376,9 @@ export function register(program) {
         .option("--json", "Output as JSON")
         .action((id, words, opts) => runAction(async () => {
         const provider = opts.provider ?? "claude";
-        const allowedProviders = ["claude", "codex", "claude-code"];
-        if (!allowedProviders.includes(provider)) {
+        const runtimeCommand = runtimeCommandForProvider(provider, opts.runtimeCommand);
+        if (!runtimeCommand) {
+            const allowedProviders = supportedPromptProviders();
             throw new Error(`Unsupported provider "${provider}". Use: ${allowedProviders.join(", ")}`);
         }
         if (opts.connector || opts.preflight) {
@@ -391,7 +393,7 @@ export function register(program) {
         const modelFlag = opts.model
             ? ` --model ${`'${opts.model.replace(/'/g, "'\\''")}'`}`
             : "";
-        const command = commandInCwd(`${provider}${modelFlag} ${shellQuote(instruction)}`, opts.cwd);
+        const command = commandInCwd(`${runtimeCommand}${modelFlag} ${shellQuote(instruction)}`, opts.cwd);
         const body = { command };
         if (opts.cwd) {
             body["cwd"] = opts.cwd;
@@ -3027,6 +3029,35 @@ function commandInCwd(command, cwd) {
         return command;
     return `cd ${shellQuote(cwd)} && ${command}`;
 }
+function supportedPromptProviders() {
+    return [
+        "claude",
+        "claude-code",
+        "codex",
+        "pi",
+        "hermes",
+        "osa",
+        "custom",
+    ];
+}
+function runtimeCommandForProvider(provider, runtimeCommand) {
+    const normalized = provider.trim().toLowerCase();
+    if (normalized === "custom") {
+        if (!runtimeCommand?.trim()) {
+            throw new Error("--provider custom requires --runtime-command, e.g. --runtime-command 'hermes-agent run'");
+        }
+        return runtimeCommand.trim();
+    }
+    const builtIns = {
+        claude: "claude",
+        "claude-code": "claude",
+        codex: "codex",
+        pi: "pi",
+        hermes: "hermes",
+        osa: "osa",
+    };
+    return builtIns[normalized] ?? null;
+}
 function backgroundCommand(command) {
     if (!command.trim())
         return command;