@usenaive-sdk/cli 0.13.0 → 0.14.0

package/dist/commands/phone.js

@@ -6,6 +6,7 @@ export const phoneCmd = new Command("phone")
     .addHelpText("after", `
 Subcommands:
   naive phone provision        Buy a US number + register the carrier campaign
+  naive phone resend-otp       Resend the sole-prop brand-verification SMS OTP
   naive phone list             List phone numbers for your company
   naive phone status           Show the carrier-registration pipeline
   naive phone send             Send an outbound SMS from a provisioned number
@@ -16,11 +17,17 @@ Subcommands:
   naive phone release <id>     Release a number back to the provider (stops billing)
 
 Prerequisites:
-  Provisioning requires a completed LLC formation (numbers are carrier-registered
-  against your business). The full chain is:
+  Standard provisioning requires a completed LLC formation (numbers are
+  carrier-registered against your business). The full chain is:
     1. naive verification start    (KYC for company members)
     2. naive formation submit      (LLC formation)
-    3. naive phone provision       (this command)
+    3. naive phone provision       (this command, with --ein)
+
+  Sole proprietors (no LLC/EIN) can provision with --sole-prop after passing
+  KYC. The brand is registered against the verified individual; Surge texts an
+  SMS OTP to their verified mobile to confirm brand identity ('naive phone
+  resend-otp' re-sends it). Sole-prop brands have lower carrier throughput
+  than EIN-registered brands.
 
 How SMS gating works:
   Inbound SMS works immediately on provisioning. Outbound SMS is blocked by the
@@ -34,7 +41,9 @@ Governance:
   status "pending_approval" and the action runs after 'naive approvals approve <id>'.
 
 Examples:
-  $ naive phone provision --area-code 415 --label "support line"
+  $ naive phone provision --ein 12-3456789 --area-code 415 --label "support line"
+  $ naive phone provision --sole-prop --area-code 415
+  $ naive phone resend-otp
   $ naive phone status
   $ naive phone send --from <phone_id> --to +14155551234 --body "Hello"
   $ naive phone messages <phone_id> --limit 50
@@ -42,13 +51,16 @@ Examples:
 phoneCmd
     .command("provision")
     .description("Buy a US number and register the carrier (10DLC) campaign")
-    .requiredOption("--ein <ein>", "Company EIN / tax id (9 digits, e.g. 12-3456789) — required for carrier registration")
+    .option("--ein <ein>", "Company EIN / tax id (9 digits, e.g. 12-3456789) — required for standard (formation-backed) registration")
+    .option("--sole-prop", "Register as a sole proprietor (passed KYC, no LLC/EIN; brand verified via SMS OTP)")
     .option("--area-code <code>", "Preferred US area code (3 digits, e.g. 415)")
     .option("--type <type>", "Number type: local (default) or toll_free")
     .option("--label <label>", "Friendly label for the number")
     .option("--agent-id <agentId>", "Connect an agent to the number on creation")
     .action(async (opts) => {
     const body = {};
+    if (opts.soleProp)
+        body.tier = "sole_proprietor";
     if (opts.ein)
         body.ein = opts.ein;
     if (opts.areaCode)
@@ -70,14 +82,34 @@ phoneCmd
         next_steps: [
             { command: "naive phone status", description: "Check carrier campaign progress" },
             { command: "naive phone list", description: "List all phone numbers" },
+            ...(data.brand_verification === "pending_otp"
+                ? [{ command: "naive phone resend-otp", description: "Resend the brand-verification SMS OTP if it didn't arrive" }]
+                : []),
         ],
         hints: [
             data.phone ? `Number ${data.phone.e164} is live for inbound SMS now.` : "Number provisioned.",
             `Outbound SMS unlocks when the campaign is approved (${data.campaign?.eta ?? "~1-2 business days"}) — automatic, no action needed.`,
+            ...(data.brand_verification === "pending_otp"
+                ? ["Sole-prop brand verification: an SMS OTP was sent to the verified mobile — confirm it to complete carrier registration."]
+                : []),
         ],
         related_commands: ["naive phone status", "naive phone list", "naive phone send"],
     });
 });
+phoneCmd
+    .command("resend-otp")
+    .description("Resend the sole-proprietor brand-verification SMS OTP")
+    .action(async () => {
+    const resp = await apiRequest("POST", "/v1/phone/brand-verification/resend");
+    handleApiError("phone.resend_otp", resp);
+    agentOutput({
+        action: "phone.resend_otp",
+        result: resp.data,
+        next_steps: [{ command: "naive phone status", description: "Check carrier campaign progress" }],
+        hints: ["A new verification code was texted to the verified mobile number."],
+        related_commands: ["naive phone provision", "naive phone status"],
+    });
+});
 phoneCmd
     .command("list", { isDefault: true })
     .description("List phone numbers for your company")

package/dist/commands/phone.js.map

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

package/dist/commands/sandbox.js

@@ -2,6 +2,61 @@ import { Command } from "commander";
 import { readFileSync } from "node:fs";
 import { apiRequest, handleApiError } from "../client.js";
 import { agentOutput } from "../output.js";
+/**
+ * THE SUCCESS ENVELOPE.
+ *
+ * `naive --help` promises "every command returns structured JSON with result
+ * data, next steps, and contextual guidance for autonomous operation"
+ * (index.ts), and /cli/overview documents the same shape. `sandbox` shipped with
+ * 16 of its 20 success envelopes passing `next_steps: []` and none carrying
+ * `hints`, so an agent that created a sandbox and ran a command in it got the
+ * data and no route onward — on the one primitive where the route onward
+ * (`park`, `sleep`, `destroy`) is what stops the meter.
+ *
+ * Both are DERIVED from the response the API just returned — the id in a
+ * suggested command is the id the API echoed, a hint restates a field it
+ * actually sent — so neither can drift from what the platform did. Same rule as
+ * `creditCostHint` in output.ts. The API's own advisory `note` (`sleep` explains
+ * what wakes the sandbox) is lifted into `hints` rather than left buried inside
+ * `result`.
+ */
+/** The sandbox id for a suggested command: the one the API echoed (top level or
+ *  nested under `sandbox`), else what the caller typed, so a next step is
+ *  copy-pasteable rather than a `<id>` placeholder. */
+function sid(data, typed) {
+    const d = (data ?? {});
+    const id = d.sandbox_id ?? d.sandbox?.sandbox_id;
+    return typeof id === "string" && id ? id : (typed ?? "<id>");
+}
+/** Hints echoed off a sandbox the API returned — restated, never asserted. */
+function sandboxHints(data) {
+    const d = (data ?? {});
+    const sb = (d.sandbox && typeof d.sandbox === "object" ? d.sandbox : d);
+    const out = [];
+    if (typeof sb.status === "string")
+        out.push(`Status: ${sb.status}`);
+    if (typeof sb.size === "string")
+        out.push(`Size: ${sb.size}`);
+    if (typeof sb.metered_credits === "number" && Number.isFinite(sb.metered_credits)) {
+        const credits = Math.round(sb.metered_credits * 10000) / 10000;
+        out.push(`Metered so far: ${credits} ${credits === 1 ? "credit" : "credits"}`);
+    }
+    // Why a sandbox is in its current status ("Auto-destroyed: credits exhausted…")
+    // — the only way a tenant learns why one stopped, so it belongs in `hints`.
+    if (typeof sb.error === "string" && sb.error)
+        out.push(sb.error);
+    return out;
+}
+/** The API's own advisory `note`/`hint`, lifted out of `result` where it sent one. */
+function apiNote(data) {
+    const d = (data ?? {});
+    const out = [];
+    if (typeof d.note === "string" && d.note)
+        out.push(d.note);
+    if (typeof d.hint === "string" && d.hint)
+        out.push(d.hint);
+    return out;
+}
 export const sandboxCmd = new Command("sandbox")
     .description("Sandbox — disposable micro-VM code sandboxes (usage billed from credits)")
     .addHelpText("after", `
@@ -35,7 +90,6 @@ Billing:
 Sizes (ceilings, not reservations — you pay only for what you use):
   s   1 vCPU · up to 16 GiB memory · up to 32 GiB disk
   m   4 vCPU · up to 32 GiB memory · up to 128 GiB disk   (default)
-  l   8 vCPU · up to 64 GiB memory · up to 256 GiB disk
 
 Examples:
   $ naive sandbox create --name scratch --size s
@@ -52,7 +106,22 @@ sandboxCmd
     .action(async () => {
     const resp = await apiRequest("GET", "/v1/sandboxes/status");
     handleApiError("sandbox.status", resp);
-    agentOutput({ action: "sandbox.status", result: resp.data, next_steps: [] });
+    const s = (resp.data ?? {});
+    agentOutput({
+        action: "sandbox.status",
+        result: resp.data,
+        next_steps: [
+            { command: "naive sandbox list", description: "List the sandboxes you have" },
+            { command: "naive sandbox create --size s", description: "Create one", when: "configured and reachable" },
+        ],
+        hints: [
+            `Provider configured: ${s.configured === true}; reachable: ${s.reachable === true}.`,
+            `${s.sandboxes ?? 0} sandbox(es), ${s.running_sandboxes ?? 0} running.`,
+            ...(s.error ? [s.error] : []),
+            "`rates` in the result are the per-hour usage rates the meter actually charges.",
+        ],
+        related_commands: ["naive sandbox list", "naive sandbox create"],
+    });
 });
 sandboxCmd
     .command("list", { isDefault: true })
@@ -60,7 +129,25 @@ sandboxCmd
     .action(async () => {
     const resp = await apiRequest("GET", "/v1/sandboxes");
     handleApiError("sandbox.list", resp);
-    agentOutput({ action: "sandbox.list", result: resp.data, next_steps: [] });
+    const boxes = (resp.data?.sandboxes ?? []);
+    const first = boxes[0]?.sandbox_id ?? "<id>";
+    const running = boxes.filter((b) => b.status === "running").length;
+    agentOutput({
+        action: "sandbox.list",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox show ${first}`, description: "Inspect one — status, size, metered credits" },
+            { command: `naive sandbox exec ${first} "<command>"`, description: "Run a shell command in it" },
+            { command: `naive sandbox park ${first}`, description: "Checkpoint and stop its meter", when: "it is running and idle" },
+        ],
+        hints: [
+            `${boxes.length} sandbox${boxes.length === 1 ? "" : "es"}, ${running} running.`,
+            ...(running > 0
+                ? ["Running sandboxes bill observed usage — `park` or `sleep` stops the meter without losing state."]
+                : ["Nothing is metering right now."]),
+        ],
+        related_commands: ["naive sandbox show", "naive sandbox park", "naive sandbox destroy"],
+    });
 });
 sandboxCmd
     .command("create")
@@ -77,13 +164,20 @@ sandboxCmd
         disk_gib: opts.disk ? Number(opts.disk) : undefined,
     });
     handleApiError("sandbox.create", resp);
+    const id = sid(resp.data);
     agentOutput({
         action: "sandbox.create",
         result: resp.data,
         next_steps: [
-            { command: "naive sandbox exec <id> <command>", description: "Run a shell command in the sandbox" },
-            { command: "naive sandbox park <id>", description: "Checkpoint and stop the usage meter", when: "done for now" },
+            { command: `naive sandbox exec ${id} "<command>"`, description: "Run a shell command in the sandbox" },
+            { command: `naive sandbox write ${id} <path> --file <local>`, description: "Upload a file into it" },
+            { command: `naive sandbox park ${id}`, description: "Checkpoint and stop the usage meter", when: "done for now" },
+        ],
+        hints: [
+            ...sandboxHints(resp.data),
+            "The meter runs while the sandbox is running — `park` or `sleep` is free, `destroy` is final.",
         ],
+        related_commands: ["naive sandbox exec", "naive sandbox park", "naive sandbox destroy"],
     });
 });
 sandboxCmd
@@ -92,7 +186,21 @@ sandboxCmd
     .action(async (id) => {
     const resp = await apiRequest("GET", `/v1/sandboxes/${id}`);
     handleApiError("sandbox.show", resp);
-    agentOutput({ action: "sandbox.show", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    agentOutput({
+        action: "sandbox.show",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox exec ${sb} "<command>"`, description: "Run a shell command in it" },
+            { command: `naive sandbox ports ${sb}`, description: "See which guest ports are exposed" },
+            { command: `naive sandbox park ${sb}`, description: "Checkpoint and stop the meter", when: "it is running and idle" },
+        ],
+        hints: [
+            ...sandboxHints(resp.data),
+            "`metered_credits` is what this sandbox has cost so far, not a forecast.",
+        ],
+        related_commands: ["naive sandbox exec", "naive sandbox park", "naive sandbox destroy"],
+    });
 });
 sandboxCmd
     .command("exec <id> <command...>")
@@ -106,7 +214,24 @@ sandboxCmd
         timeout_ms: opts.timeout ? Number(opts.timeout) : undefined,
     });
     handleApiError("sandbox.exec", resp);
-    agentOutput({ action: "sandbox.exec", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    const exit = resp.data?.exit_code;
+    agentOutput({
+        action: "sandbox.exec",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox exec ${sb} "<command>"`, description: "Run the next command" },
+            { command: `naive sandbox ls ${sb} <path>`, description: "Inspect what the command wrote" },
+            { command: `naive sandbox park ${sb}`, description: "Checkpoint and stop the meter", when: "done for now" },
+        ],
+        hints: [
+            typeof exit === "number"
+                ? `Exit code: ${exit}${exit === 0 ? "" : " — stderr in the result has the reason"}.`
+                : "The command ran; `stdout`/`stderr` are in the result.",
+            "Output is truncated past 256 KiB — write large output to a file and `sandbox read` it.",
+        ],
+        related_commands: ["naive sandbox read", "naive sandbox ls", "naive sandbox park"],
+    });
 });
 sandboxCmd
     .command("write <id> <path>")
@@ -117,7 +242,21 @@ sandboxCmd
     const content = opts.file ? readFileSync(opts.file, "utf8") : (opts.content ?? "");
     const resp = await apiRequest("POST", `/v1/sandboxes/${id}/files`, { path, content });
     handleApiError("sandbox.write", resp);
-    agentOutput({ action: "sandbox.write", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    const size = resp.data?.size;
+    agentOutput({
+        action: "sandbox.write",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox read ${sb} ${path}`, description: "Read it back" },
+            { command: `naive sandbox exec ${sb} "<command>"`, description: "Run it" },
+        ],
+        hints: [
+            typeof size === "number" ? `Wrote ${size} byte${size === 1 ? "" : "s"} to ${path}.` : `Wrote ${path}.`,
+            "This surface caps a file at 4 MiB — use `sandbox exec` to fetch anything larger inside the VM.",
+        ],
+        related_commands: ["naive sandbox read", "naive sandbox ls", "naive sandbox exec"],
+    });
 });
 sandboxCmd
     .command("read <id> <path>")
@@ -125,7 +264,21 @@ sandboxCmd
     .action(async (id, path) => {
     const resp = await apiRequest("GET", `/v1/sandboxes/${id}/files?path=${encodeURIComponent(path)}`);
     handleApiError("sandbox.read", resp);
-    agentOutput({ action: "sandbox.read", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    const size = resp.data?.size;
+    agentOutput({
+        action: "sandbox.read",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox write ${sb} ${path} --content "<text>"`, description: "Overwrite it" },
+            { command: `naive sandbox ls ${sb} <dir>`, description: "List the directory it lives in" },
+        ],
+        hints: [
+            typeof size === "number" ? `${size} byte${size === 1 ? "" : "s"} from ${path}.` : `Read ${path}.`,
+            "Content comes back inside the envelope — binary files should be base64-encoded in the sandbox first.",
+        ],
+        related_commands: ["naive sandbox write", "naive sandbox ls"],
+    });
 });
 sandboxCmd
     .command("ls <id> <path>")
@@ -133,7 +286,21 @@ sandboxCmd
     .action(async (id, path) => {
     const resp = await apiRequest("GET", `/v1/sandboxes/${id}/files/ls?path=${encodeURIComponent(path)}`);
     handleApiError("sandbox.ls", resp);
-    agentOutput({ action: "sandbox.ls", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    const entries = (resp.data?.entries ?? []);
+    agentOutput({
+        action: "sandbox.ls",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox read ${sb} ${path}/<name>`, description: "Read one of the entries" },
+            { command: `naive sandbox rm ${sb} ${path}/<name>`, description: "Remove one", when: "you are cleaning up" },
+        ],
+        hints: [
+            `${entries.length} entr${entries.length === 1 ? "y" : "ies"} in ${path}.`,
+            "This lists immediate entries only — it does not recurse.",
+        ],
+        related_commands: ["naive sandbox read", "naive sandbox mkdir", "naive sandbox rm"],
+    });
 });
 sandboxCmd
     .command("mkdir <id> <path>")
@@ -141,7 +308,20 @@ sandboxCmd
     .action(async (id, path) => {
     const resp = await apiRequest("POST", `/v1/sandboxes/${id}/files/mkdir`, { path });
     handleApiError("sandbox.mkdir", resp);
-    agentOutput({ action: "sandbox.mkdir", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    agentOutput({
+        action: "sandbox.mkdir",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox write ${sb} ${path}/<name> --file <local>`, description: "Put a file in it" },
+            { command: `naive sandbox ls ${sb} ${path}`, description: "Confirm what is there" },
+        ],
+        hints: [
+            `Created ${path} (and any missing parents).`,
+            "It behaves like `mkdir -p` — creating an existing directory is not an error.",
+        ],
+        related_commands: ["naive sandbox write", "naive sandbox ls"],
+    });
 });
 sandboxCmd
     .command("rm <id> <path>")
@@ -149,7 +329,20 @@ sandboxCmd
     .action(async (id, path) => {
     const resp = await apiRequest("DELETE", `/v1/sandboxes/${id}/files?path=${encodeURIComponent(path)}`);
     handleApiError("sandbox.rm", resp);
-    agentOutput({ action: "sandbox.rm", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    agentOutput({
+        action: "sandbox.rm",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox ls ${sb} <dir>`, description: "Confirm what is left" },
+            { command: `naive sandbox destroy ${sb}`, description: "Throw the whole sandbox away", when: "you are done with it" },
+        ],
+        hints: [
+            `Removed ${path}.`,
+            "This is recursive, like `rm -rf` — a checkpoint taken before it is the only way back.",
+        ],
+        related_commands: ["naive sandbox ls", "naive sandbox checkpoint"],
+    });
 });
 sandboxCmd
     .command("expose <id> <port>")
@@ -161,7 +354,21 @@ sandboxCmd
         protocol: opts.protocol,
     });
     handleApiError("sandbox.expose", resp);
-    agentOutput({ action: "sandbox.expose", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    const url = resp.data?.url;
+    agentOutput({
+        action: "sandbox.expose",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox ports ${sb}`, description: "See every port this sandbox exposes" },
+            { command: `naive sandbox unexpose ${sb} ${port}`, description: "Take it down again", when: "you are done" },
+        ],
+        hints: [
+            typeof url === "string" && url ? `Reachable at ${url}` : `Port ${port} is exposed; the URL is in the result.`,
+            "A public port is reachable by anyone who has the URL — unexpose it when you are finished.",
+        ],
+        related_commands: ["naive sandbox ports", "naive sandbox unexpose"],
+    });
 });
 sandboxCmd
     .command("unexpose <id> <port>")
@@ -169,7 +376,20 @@ sandboxCmd
     .action(async (id, port) => {
     const resp = await apiRequest("DELETE", `/v1/sandboxes/${id}/expose/${Number(port)}`);
     handleApiError("sandbox.unexpose", resp);
-    agentOutput({ action: "sandbox.unexpose", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    agentOutput({
+        action: "sandbox.unexpose",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox ports ${sb}`, description: "Confirm what is still exposed" },
+            { command: `naive sandbox expose ${sb} ${port}`, description: "Expose it again", when: "you need it back" },
+        ],
+        hints: [
+            `Port ${port} is no longer exposed.`,
+            "The process inside the sandbox keeps running — only the public listener is gone.",
+        ],
+        related_commands: ["naive sandbox ports", "naive sandbox expose"],
+    });
 });
 sandboxCmd
     .command("ports <id>")
@@ -177,7 +397,24 @@ sandboxCmd
     .action(async (id) => {
     const resp = await apiRequest("GET", `/v1/sandboxes/${id}/expose`);
     handleApiError("sandbox.ports", resp);
-    agentOutput({ action: "sandbox.ports", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    const ports = (resp.data?.ports ?? []);
+    agentOutput({
+        action: "sandbox.ports",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox expose ${sb} <port>`, description: "Expose another guest port" },
+            ...(ports.length > 0
+                ? [{ command: `naive sandbox unexpose ${sb} ${ports[0].port ?? "<port>"}`, description: "Take one down" }]
+                : []),
+            { command: `naive sandbox show ${sb}`, description: "Check the sandbox's status" },
+        ],
+        hints: [
+            `${ports.length} exposed port${ports.length === 1 ? "" : "s"}.`,
+            "Listing ports does not wake a sleeping sandbox.",
+        ],
+        related_commands: ["naive sandbox expose", "naive sandbox unexpose"],
+    });
 });
 sandboxCmd
     .command("checkpoint <id>")
@@ -186,10 +423,21 @@ sandboxCmd
     .action(async (id, opts) => {
     const resp = await apiRequest("POST", `/v1/sandboxes/${id}/checkpoints`, { name: opts.name });
     handleApiError("sandbox.checkpoint", resp);
+    const sb = sid(resp.data, id);
+    const cp = resp.data ?? {};
     agentOutput({
         action: "sandbox.checkpoint",
         result: resp.data,
-        next_steps: [{ command: "naive sandbox fork <id>", description: "Start a new sandbox from the checkpoint" }],
+        next_steps: [
+            { command: `naive sandbox fork ${sb}`, description: "Start a new sandbox from the checkpoint" },
+            { command: `naive sandbox park ${sb}`, description: "Checkpoint and stop the meter", when: "done for now" },
+        ],
+        hints: [
+            typeof cp.checkpoint_id === "string" ? `Checkpoint ${cp.checkpoint_id}.` : "Checkpoint taken.",
+            ...(typeof cp.expires_at === "string" ? [`Expires ${cp.expires_at}.`] : []),
+            "The sandbox keeps running — checkpointing does not stop the meter, `park` does.",
+        ],
+        related_commands: ["naive sandbox fork", "naive sandbox park"],
     });
 });
 sandboxCmd
@@ -203,7 +451,21 @@ sandboxCmd
         checkpoint_id: opts.checkpoint,
     });
     handleApiError("sandbox.fork", resp);
-    agentOutput({ action: "sandbox.fork", result: resp.data, next_steps: [] });
+    const forked = sid(resp.data);
+    agentOutput({
+        action: "sandbox.fork",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox exec ${forked} "<command>"`, description: "Run a command in the fork" },
+            { command: `naive sandbox park ${forked}`, description: "Checkpoint and stop the fork's meter", when: "done for now" },
+            { command: "naive sandbox list", description: "See the original and the fork side by side" },
+        ],
+        hints: [
+            ...sandboxHints(resp.data),
+            `The fork is a separate sandbox with its own meter — ${id} keeps running independently.`,
+        ],
+        related_commands: ["naive sandbox list", "naive sandbox exec", "naive sandbox park"],
+    });
 });
 sandboxCmd
     .command("park <id>")
@@ -211,10 +473,20 @@ sandboxCmd
     .action(async (id) => {
     const resp = await apiRequest("POST", `/v1/sandboxes/${id}/park`, {});
     handleApiError("sandbox.park", resp);
+    const sb = sid(resp.data, id);
     agentOutput({
         action: "sandbox.park",
         result: resp.data,
-        next_steps: [{ command: "naive sandbox resume <id>", description: "Restore the checkpoint and restart the meter" }],
+        next_steps: [
+            { command: `naive sandbox resume ${sb}`, description: "Restore the checkpoint and restart the meter" },
+            { command: `naive sandbox destroy ${sb}`, description: "Throw it away for good", when: "you will not come back to it" },
+        ],
+        hints: [
+            ...sandboxHints(resp.data),
+            ...apiNote(resp.data),
+            "Parked sandboxes are free — the meter is stopped, the checkpointed state is kept.",
+        ],
+        related_commands: ["naive sandbox resume", "naive sandbox destroy"],
     });
 });
 sandboxCmd
@@ -224,7 +496,23 @@ sandboxCmd
     .action(async (id, opts) => {
     const resp = await apiRequest("POST", `/v1/sandboxes/${id}/sleep`, opts.wakeAt ? { wake_at: opts.wakeAt } : {});
     handleApiError("sandbox.sleep", resp);
-    agentOutput({ action: "sandbox.sleep", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    const wakeAt = resp.data?.wake_at;
+    agentOutput({
+        action: "sandbox.sleep",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox resume ${sb}`, description: "Wake it now and restart the meter" },
+            { command: `naive sandbox ports ${sb}`, description: "Check its exposed ports without waking it" },
+        ],
+        hints: [
+            ...sandboxHints(resp.data),
+            // The API explains what wakes it; that advisory is the point of the call.
+            ...apiNote(resp.data),
+            ...(typeof wakeAt === "string" ? [`Scheduled wake: ${wakeAt}.`] : []),
+        ],
+        related_commands: ["naive sandbox resume", "naive sandbox park"],
+    });
 });
 sandboxCmd
     .command("resume <id>")
@@ -232,7 +520,20 @@ sandboxCmd
     .action(async (id) => {
     const resp = await apiRequest("POST", `/v1/sandboxes/${id}/resume`, {});
     handleApiError("sandbox.resume", resp);
-    agentOutput({ action: "sandbox.resume", result: resp.data, next_steps: [] });
+    const sb = sid(resp.data, id);
+    agentOutput({
+        action: "sandbox.resume",
+        result: resp.data,
+        next_steps: [
+            { command: `naive sandbox exec ${sb} "<command>"`, description: "Carry on where you left off" },
+            { command: `naive sandbox park ${sb}`, description: "Stop the meter again", when: "done for now" },
+        ],
+        hints: [
+            ...sandboxHints(resp.data),
+            "The meter restarts from the resume time — park or sleep it again when you stop working.",
+        ],
+        related_commands: ["naive sandbox exec", "naive sandbox park"],
+    });
 });
 sandboxCmd
     .command("destroy <id>")
@@ -240,6 +541,18 @@ sandboxCmd
     .action(async (id) => {
     const resp = await apiRequest("DELETE", `/v1/sandboxes/${id}`);
     handleApiError("sandbox.destroy", resp);
-    agentOutput({ action: "sandbox.destroy", result: resp.data, next_steps: [] });
+    agentOutput({
+        action: "sandbox.destroy",
+        result: resp.data,
+        next_steps: [
+            { command: "naive sandbox list", description: "Confirm what is left" },
+            { command: "naive sandbox create --size s", description: "Start a fresh one", when: "you need another" },
+        ],
+        hints: [
+            ...sandboxHints(resp.data),
+            "Destroy is final and stops billing — un-checkpointed state is gone.",
+        ],
+        related_commands: ["naive sandbox list", "naive sandbox create"],
+    });
 });
 //# sourceMappingURL=sandbox.js.map