@miosa/cli 1.0.91 → 1.0.92

package/dist/commands/sandbox.js

@@ -104,9 +104,8 @@ export function register(program) {
             console.log(JSON.stringify(data, null, 2));
             return;
         }
-        const sb = opts.port != null
-            ? await showSandboxWithPreview(id, opts.port, opts.probePath)
-            : (unwrap(await client().apiGet(apiPath(`/sandboxes/${enc(id)}`))) ?? {});
+        const raw = unwrap(await client().apiGet(apiPath(`/sandboxes/${enc(id)}`)));
+        const sb = (raw ?? {});
         printBanner({ subtitle: "Sandbox" });
         const rows = [
             { label: "ID", value: chalk.bold(str(sb["id"])), icon: icon.info },
@@ -143,23 +142,6 @@ export function register(program) {
                 value: chalk.cyan(str(sb["public_url"])),
             });
         }
-        const preview = asRecord(sb["preview"]);
-        if (preview?.["url"]) {
-            rows.push({
-                label: "Preview URL",
-                value: chalk.cyan(str(preview["url"])),
-            });
-            rows.push({
-                label: "URL class",
-                value: str(preview["url_class"] ?? "temporary_preview"),
-            });
-            rows.push({
-                label: "Embeddable",
-                value: preview["stable_for_embedding"] === true
-                    ? chalk.green("yes")
-                    : chalk.yellow("temporary"),
-            });
-        }
         if (sb["created_at"]) {
             rows.push({
                 label: "Created",
@@ -391,12 +373,14 @@ export function register(program) {
         }
     }));
     registerSandboxConnectorCommands(sandbox);
-    // prompt — invoke an in-Sandbox AI agent CLI through the Agent Runs API.
-    // This keeps the old CLI shape while returning a stable run response shape.
+    // prompt — invoke an in-Sandbox AI agent CLI (mirrors `box prompt`).
+    // Implemented through Agent Runs so callers get a stable run response while
+    // execution still happens inside the remote filesystem.
     sandbox
         .command("prompt <sandbox-id> <instruction...>")
-        .description("Run an in-Sandbox AI agent with the given instruction")
-        .option("--provider <name>", "AI provider: claude (default), claude-code, codex, hermes, osa, pi")
+        .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")
@@ -411,17 +395,13 @@ export function register(program) {
         .option("--json", "Output as JSON")
         .action((id, words, opts) => runAction(async () => {
         const provider = opts.provider ?? "claude";
-        const allowedProviders = [
-            "claude",
-            "claude-code",
-            "codex",
-            "hermes",
-            "osa",
-            "pi",
-        ];
-        if (!allowedProviders.includes(provider)) {
+        if (!isSupportedPromptProvider(provider)) {
+            const allowedProviders = supportedPromptProviders();
             throw new Error(`Unsupported provider "${provider}". Use: ${allowedProviders.join(", ")}`);
         }
+        if (opts.runtimeCommand && provider !== "custom") {
+            throw new Error("--runtime-command can only be used with --provider custom");
+        }
         if (opts.connector || opts.preflight) {
             await preflightSandboxConnector(id, {
                 provider,
@@ -437,6 +417,8 @@ export function register(program) {
             provider,
             prompt: instruction,
         };
+        if (opts.runtimeCommand)
+            body["command"] = opts.runtimeCommand;
         if (opts.model)
             body["model"] = opts.model;
         if (opts.cwd)
@@ -686,7 +668,6 @@ export function register(program) {
         .option("--sandbox <id>", "Existing sandbox ID. Creates one when omitted")
         .option("--template <template>", "Template for new sandbox", "miosa-sandbox")
         .option("--name <name>", "Name for a new sandbox")
-        .option("--always-on", "Create a new sandbox that keeps running instead of timing out")
         .option("--port <port>", "Preview port", parseIntegerOption)
         .option("--publish-port <port>", "Alias for --port", parseIntegerOption)
         .option("--start <command>", "Start command to run inside /workspace")
@@ -696,13 +677,6 @@ export function register(program) {
         .option("--revision <revision>", "Git revision/branch for --source git:...")
         .option("--depth <n>", "Git clone depth for --source git:...", parseIntegerOption)
         .option("--wait", "Wait until the public preview returns a good HTTP status")
-        .option("--publish", "Publish the workspace to a durable deployment after preview succeeds")
-        .option("--slug <slug>", "Deployment slug to use with --publish")
-        .option("--static", "Publish as a static deployment when using --publish")
-        .option("--deployment-type <type>", "Deployment runtime type for --publish: miosa_deploy, docker_deploy, dynamic, static")
-        .option("--domain <domain>", "Custom domain to attach when using --publish")
-        .option("--build-command <cmd>", "Build command to run before publish")
-        .option("--run-command <cmd>", "Run command for durable dynamic publish")
         .option("--timeout <duration>", "Wait timeout, e.g. 180s or 3m", parseDurationSec, 180)
         .option("--probe-path <path>", "HTTP path to probe")
         .option("--json", "Output as JSON")
@@ -717,16 +691,10 @@ export function register(program) {
             console.log(`  ${chalk.bold("Sandbox")}  ${result.sandbox_id}`);
             console.log(`  ${chalk.bold("Port")}     ${result.port}`);
             console.log(`  ${chalk.bold("Preview")}  ${chalk.cyan(result.preview_url)}`);
-            if (result.deployment?.url) {
-                console.log(`  ${chalk.bold("Durable")} ${chalk.cyan(result.deployment.url)}`);
-            }
             console.log(`  ${chalk.bold("Ready")}    ${result.preview_ready
                 ? chalk.green("yes")
                 : chalk.yellow("not verified")}`);
             console.log();
-            console.log(chalk.yellow("  This is a timed sandbox preview. Persistent keeps disk; always-on keeps the app running."));
-            console.log(chalk.dim(`  For a durable client link, publish it: miosa sandbox publish ${result.sandbox_id} --path /workspace --slug <slug> --wait`));
-            console.log();
         }
         catch (err) {
             handleSandboxDeployError(err, opts);
@@ -751,7 +719,6 @@ export function register(program) {
             return;
         }
         console.log(result.url);
-        printPreviewContractHint(result);
         if (!result.ready) {
             console.error(chalk.yellow(`Preview route created but not verified yet (${result.error ?? result.status ?? "pending"}).`));
         }
@@ -1829,9 +1796,6 @@ async function showSandboxWithPreview(sandboxId, port, probePath) {
     catch (err) {
         preview = {
             url: "",
-            url_class: "temporary_preview",
-            stable_for_embedding: false,
-            recommended_next_action: "create_alias_or_publish",
             ready: false,
             status: null,
             latency_ms: null,
@@ -1844,10 +1808,6 @@ async function showSandboxWithPreview(sandboxId, port, probePath) {
         preview: {
             url: preview?.url || null,
             port,
-            url_info: preview?.url_info ?? null,
-            url_class: preview?.url_class ?? "temporary_preview",
-            stable_for_embedding: preview?.stable_for_embedding ?? false,
-            recommended_next_action: preview?.recommended_next_action ?? "create_alias_or_publish",
             route_ready: Boolean(preview?.url),
             tls_ready: preview?.ready ?? false,
             last_status: preview?.status ?? null,
@@ -1870,28 +1830,12 @@ async function previewSandbox(sandboxId, port, opts) {
         : await probePublicPreview(url, opts.probePath);
     return {
         url,
-        url_class: stringField(exposed, "url_class") ??
-            stringField(exposed, "class") ??
-            "temporary_preview",
-        stable_for_embedding: booleanField(exposed, "stable_for_embedding") ?? false,
-        recommended_next_action: stringField(exposed, "recommended_next_action") ??
-            "create_alias_or_publish",
-        url_info: objectField(exposed, "url_info") ?? undefined,
         ready: edge.ok,
         status: edge.status,
         latency_ms: edge.latency_ms ?? null,
         error: edge.error,
     };
 }
-function printPreviewContractHint(result) {
-    const urlClass = result.url_class ?? "temporary_preview";
-    if (result.stable_for_embedding === true) {
-        console.error(chalk.dim(`URL class: ${urlClass}, stable for embedding.`));
-        return;
-    }
-    console.error(chalk.yellow(`URL class: ${urlClass}, temporary preview.`));
-    console.error(chalk.dim(`For durable client use, next action: ${result.recommended_next_action ?? "create_alias_or_publish"}.`));
-}
 async function waitSandboxReady(sandboxId, port, probePath, timeoutSec) {
     const c = client();
     await waitForSandboxRunning(c, sandboxId, Math.min(timeoutSec, 120));
@@ -2007,7 +1951,6 @@ async function deploySandbox(localDir, opts) {
                 source: opts.source,
                 revision: opts.revision,
                 depth: opts.depth,
-                alwaysOn: opts.alwaysOn,
             });
         }
         deployStep(opts, "Waiting for sandbox");
@@ -2048,53 +1991,20 @@ async function deploySandbox(localDir, opts) {
         const internal = await waitForInternalHttp(c, sandboxId, resolvedPort, resolvedProbePath, Math.min(opts.timeout, 60));
         deployStep(opts, "Creating public preview route");
         const exposed = await c.apiPost(apiPath(`/sandboxes/${enc(sandboxId)}/expose`), { port: resolvedPort, title: "app preview" });
-        const exposeData = unwrap(exposed);
-        const previewUrl = extractUrl(exposeData);
+        const previewUrl = extractUrl(unwrap(exposed));
         if (!previewUrl) {
             throw new UserError("Sandbox expose did not return a preview URL.");
         }
-        const previewUrlInfo = objectField(exposeData, "url_info") ?? undefined;
-        const previewUrlClass = stringField(exposeData, "url_class") ??
-            stringField(exposeData, "class") ??
-            "temporary_preview";
-        const stableForEmbedding = booleanField(exposeData, "stable_for_embedding") ?? false;
-        const recommendedNextAction = stringField(exposeData, "recommended_next_action") ??
-            "create_alias_or_publish";
         if (opts.wait)
             deployStep(opts, "Checking public preview readiness");
         const edge = opts.wait
             ? await waitForPublicPreview(previewUrl, resolvedProbePath, opts.timeout)
             : { ok: false, status: null };
-        const deployment = opts.publish
-            ? await publishSandbox(sandboxId, {
-                path: remoteWorkdir,
-                name: opts.name,
-                slug: opts.slug,
-                environment: "production",
-                buildCommand: opts.buildCommand,
-                runCommand: opts.runCommand,
-                domain: opts.domain,
-                deploymentType: opts.static
-                    ? "static"
-                    : (opts.deploymentType ?? "dynamic"),
-                port: resolvedPort,
-                wait: opts.wait,
-                timeout: opts.timeout,
-                json: opts.json,
-            })
-            : null;
         return {
             sandbox_id: sandboxId,
             port: resolvedPort,
             preview_url: previewUrl,
-            preview_url_info: previewUrlInfo,
-            preview_url_class: previewUrlClass,
-            stable_for_embedding: stableForEmbedding,
-            recommended_next_action: recommendedNextAction,
             preview_ready: edge.ok,
-            persistent: true,
-            always_on: Boolean(opts.alwaysOn),
-            deployment,
             internal_status: internal.status,
             edge_status: edge.status,
             latency_ms: edge.latency_ms ?? null,
@@ -2203,25 +2113,6 @@ async function publishSandbox(sandboxId, opts) {
         extractUrl(deployment) ??
         stringField(data, "url") ??
         null;
-    let urlInfo = objectField(response, "url_info") ??
-        objectField(deployment, "url_info") ??
-        objectField(data, "url_info") ??
-        null;
-    let urlClass = stringField(response, "url_class") ??
-        stringField(response, "class") ??
-        stringField(deployment, "url_class") ??
-        stringField(deployment, "class") ??
-        stringField(data, "url_class") ??
-        stringField(data, "class") ??
-        "durable_deployment";
-    let stableForEmbedding = booleanField(response, "stable_for_embedding") ??
-        booleanField(deployment, "stable_for_embedding") ??
-        booleanField(data, "stable_for_embedding") ??
-        true;
-    let recommendedNextAction = stringField(response, "recommended_next_action") ??
-        stringField(deployment, "recommended_next_action") ??
-        stringField(data, "recommended_next_action") ??
-        "attach_custom_domain";
     let deploymentProduct = stringField(response, "deployment_product") ??
         stringField(data, "deployment_product") ??
         stringField(deployment, "deployment_product") ??
@@ -2237,15 +2128,6 @@ async function publishSandbox(sandboxId, opts) {
         const waited = await waitForDeploymentReady(c, deploymentId, opts.timeout);
         state = stringField(waited, "state") ?? state;
         url = extractUrl(waited) ?? url;
-        urlInfo = objectField(waited, "url_info") ?? urlInfo;
-        urlClass =
-            stringField(waited, "url_class") ??
-                stringField(waited, "class") ??
-                urlClass;
-        stableForEmbedding =
-            booleanField(waited, "stable_for_embedding") ?? stableForEmbedding;
-        recommendedNextAction =
-            stringField(waited, "recommended_next_action") ?? recommendedNextAction;
         deploymentProduct =
             stringField(waited, "deployment_product") ??
                 stringField(asRecord(waited["metadata"]), "deployment_product") ??
@@ -2257,11 +2139,6 @@ async function publishSandbox(sandboxId, opts) {
         response["state"] = state;
         if (url)
             response["url"] = url;
-        if (urlInfo)
-            response["url_info"] = urlInfo;
-        response["url_class"] = urlClass;
-        response["stable_for_embedding"] = stableForEmbedding;
-        response["recommended_next_action"] = recommendedNextAction;
         data["deployment"] = waited;
         data["promotion_pending"] = false;
         data["app_consistency_pending"] = false;
@@ -2283,10 +2160,6 @@ async function publishSandbox(sandboxId, opts) {
         release_id: releaseId,
         version_id: versionId,
         url,
-        url_info: urlInfo ?? undefined,
-        url_class: urlClass,
-        stable_for_embedding: stableForEmbedding,
-        recommended_next_action: recommendedNextAction,
         state,
         deployment_product: deploymentProduct,
         docker_deploy_host_id: dockerDeployHostId,
@@ -2311,7 +2184,7 @@ async function waitForDeploymentReady(c, deploymentId, timeoutSec) {
         await sleep(2000);
     }
     const lastState = last ? String(last["state"] ?? "unknown") : "unknown";
-    throw new UserError(`Deployment still building after ${timeoutSec}s — it may still finish. Re-check with \`miosa deploy show ${deploymentId}\` or \`miosa deploy logs ${deploymentId}\`.`, `Last state: ${lastState}`);
+    throw new UserError(`Deployment still building after ${timeoutSec}s — it may still finish. Re-check with \`miosa sandbox show ${deploymentId}\` or \`miosa deploy logs\`.`, `Last state: ${lastState}`);
 }
 function parsePublishDatabase(value) {
     if (!value)
@@ -2349,12 +2222,6 @@ async function doctorSandbox(sandboxId, port, probePath) {
         exposeData = { error: err instanceof Error ? err.message : String(err) };
     }
     const previewUrl = extractUrl(exposeData);
-    const urlClass = stringField(exposeData, "url_class") ??
-        stringField(exposeData, "class") ??
-        "temporary_preview";
-    const stableForEmbedding = booleanField(exposeData, "stable_for_embedding") ?? false;
-    const recommendedNextAction = stringField(exposeData, "recommended_next_action") ??
-        "create_alias_or_publish";
     const edge = previewUrl
         ? await probePublicPreview(previewUrl, probePath)
         : { ok: false, status: null, error: "No preview URL returned" };
@@ -2372,10 +2239,6 @@ async function doctorSandbox(sandboxId, port, probePath) {
         edge_probe: edge,
         preview_ready: edge.ok,
         preview_url: previewUrl,
-        url_info: objectField(exposeData, "url_info") ?? null,
-        url_class: urlClass,
-        stable_for_embedding: stableForEmbedding,
-        recommended_next_action: recommendedNextAction,
         expose: exposeData,
     };
 }
@@ -2391,8 +2254,6 @@ function renderDoctorReport(report) {
     console.log(`  ${chalk.bold("Preview ready")} ${report["preview_ready"] ? chalk.green("yes") : chalk.red("no")}`);
     if (report["preview_url"]) {
         console.log(`  ${chalk.bold("Preview URL")}   ${chalk.cyan(String(report["preview_url"]))}`);
-        console.log(`  ${chalk.bold("URL class")}     ${report["url_class"]}`);
-        console.log(`  ${chalk.bold("Embeddable")}    ${report["stable_for_embedding"] === true ? chalk.green("yes") : chalk.yellow("temporary")}`);
     }
     console.log();
     if (!report["preview_ready"]) {
@@ -2588,8 +2449,6 @@ async function createSandboxForDeploy(c, template, name, source) {
     const body = { template_id: template };
     if (name)
         body["name"] = name;
-    if (source?.alwaysOn)
-        body["always_on"] = true;
     if (source?.source)
         body["source"] = source.source;
     if (source?.revision)
@@ -2860,8 +2719,6 @@ function recoveryCommandForSandboxDeploy(sandboxId, opts, localDir) {
         parts.push("--port", String(opts.port));
     if (opts.publishPort != null)
         parts.push("--publish-port", String(opts.publishPort));
-    if (opts.alwaysOn)
-        parts.push("--always-on");
     if (opts.installCommand)
         parts.push("--install-command", shellQuote(opts.installCommand));
     if (opts.install === false)
@@ -3217,29 +3074,11 @@ function extractUrl(value) {
         return null;
     const row = value;
     for (const key of ["url", "preview_url", "public_url"]) {
-        if (typeof row[key] === "string" && row[key]) {
-            return normalizePreviewUrl(row[key]);
-        }
+        if (typeof row[key] === "string" && row[key])
+            return row[key];
     }
     return null;
 }
-function normalizePreviewUrl(url) {
-    try {
-        const parsed = new URL(url);
-        parsed.hostname = parsed.hostname.replace(".sandbox.sandbox.preview.", ".sandbox.preview.");
-        const normalized = parsed.toString();
-        if (parsed.pathname === "/" &&
-            !parsed.search &&
-            !parsed.hash &&
-            !url.endsWith("/")) {
-            return normalized.replace(/\/$/, "");
-        }
-        return normalized;
-    }
-    catch {
-        return url.replace(".sandbox.sandbox.preview.", ".sandbox.preview.");
-    }
-}
 function asRecord(value) {
     if (!value || typeof value !== "object" || Array.isArray(value))
         return null;
@@ -3249,13 +3088,6 @@ function stringField(row, key) {
     const value = row?.[key];
     return typeof value === "string" && value.length > 0 ? value : null;
 }
-function booleanField(row, key) {
-    const value = row?.[key];
-    return typeof value === "boolean" ? value : null;
-}
-function objectField(row, key) {
-    return asRecord(row?.[key]);
-}
 function isSandboxTarget(value) {
     const idx = value.indexOf(":");
     if (idx <= 0)
@@ -3370,6 +3202,38 @@ 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 isSupportedPromptProvider(provider) {
+    return supportedPromptProviders().includes(provider.trim().toLowerCase());
+}
 function backgroundCommand(command) {
     if (!command.trim())
         return command;