withruntime 0.11.2 → 0.12.0

package/dist/cli-extras.js

@@ -13,12 +13,12 @@ export async function recordCommand(sbx, argv, out, kit) {
                 ...(integer(args, "max-seconds") ? { maxSeconds: integer(args, "max-seconds") } : {}),
                 ...(integer(args, "max-mib") ? { maxMiB: integer(args, "max-mib") } : {}),
             });
-            print(`Recording ${rec.id}. Stop it: ${me} sandbox desktop ${sbx.id} record stop ${rec.id}`, rec);
+            print(`Recording ${rec.id}. Stop it: ${me} sandboxes desktop ${sbx.id} record stop ${rec.id}`, rec);
             return 0;
         }
         case "stop": {
             const rec = await r.stop(need(rest[0], "the recording id"));
-            print(`Stopped ${rec.id}: ${(rec.bytes / 1_048_576).toFixed(1)} MiB (${rec.reason ?? "stopped"}). Fetch it: ${me} sandbox desktop ${sbx.id} record fetch ${rec.id}`, rec);
+            print(`Stopped ${rec.id}: ${(rec.bytes / 1_048_576).toFixed(1)} MiB (${rec.reason ?? "stopped"}). Fetch it: ${me} sandboxes desktop ${sbx.id} record fetch ${rec.id}`, rec);
             return 0;
         }
         case "ls": {
@@ -47,7 +47,7 @@ export async function recordCommand(sbx, argv, out, kit) {
             print("Deleted.", await r.delete(need(rest[0], "the recording id")));
             return 0;
     }
-    throw usage(`${me} sandbox desktop <id> record start|stop|ls|fetch|rm`);
+    throw usage(`${me} sandboxes desktop <id> record start|stop|ls|fetch|rm`);
 }
 export async function watchCommand(sbx, argv, out, kit) {
     const { parse, flag, has, need } = kit;
@@ -110,7 +110,7 @@ export async function mcpCommand(sbx, argv, out, kit) {
         case "start": {
             const args = parse(rest, ["replace"], ["secret", "env", "option", "port"]);
             if (!args.positional.length)
-                throw usage("Name the servers: runtime sandbox mcp <id> start github fetch");
+                throw usage("Name the servers: runtime sandboxes mcp <id> start github fetch");
             const scoped = (name) => {
                 const found = {};
                 for (const [key, value] of Object.entries(pairs(args, name))) {
@@ -134,7 +134,7 @@ export async function mcpCommand(sbx, argv, out, kit) {
                 ...(integer(args, "port") ? { port: integer(args, "port") } : {}),
                 ...(has(args, "replace") ? { replace: true } : {}),
             });
-            print(`${show(gw)}\nServers are installing; \`${me} sandbox mcp ${sbx.id}\` shows when they are ready.`, gw);
+            print(`${show(gw)}\nServers are installing; \`${me} sandboxes mcp ${sbx.id}\` shows when they are ready.`, gw);
             return 0;
         }
         case "status": {
@@ -146,7 +146,7 @@ export async function mcpCommand(sbx, argv, out, kit) {
             print("Stopped.", await sbx.mcp.stop());
             return 0;
     }
-    throw usage(`${me} sandbox mcp <id> start|status|stop, or ${me} sandbox mcp catalog`);
+    throw usage(`${me} sandboxes mcp <id> start|status|stop, or ${me} sandboxes mcp catalog`);
 }
 /** Standard input when it is piped or redirected from a file, read whole, up
  * to the API's 1 MiB; undefined for a terminal. A pipe that says nothing for
@@ -184,7 +184,7 @@ export async function pipedStdin(options = {}) {
             clearTimeout(quiet);
             size += chunk.length;
             if (size > limit)
-                return done(undefined, Object.assign(new Error(`Standard input is over ${limit / 1_048_576} MiB. Copy the file in with \`${me} sandbox cp\` and read it there.`), { code: "usage" }));
+                return done(undefined, Object.assign(new Error(`Standard input is over ${limit / 1_048_576} MiB. Copy the file in with \`${me} sandboxes cp\` and read it there.`), { code: "usage" }));
             chunks.push(chunk);
         };
         const onEnd = () => done(size ? new Uint8Array(Buffer.concat(chunks)) : undefined);
@@ -201,11 +201,11 @@ export async function pipedStdin(options = {}) {
 export function lostOutput(result, id) {
     if (!result.stdoutTruncated && !result.stderrTruncated)
         return undefined;
-    return `runtime: some of the command's output was lost: it wrote faster than it was read, and the sandbox keeps the latest 1 MiB. Write it to a file and copy it out: ${me} sandbox cp ${id}:/workspace/out.txt .`;
+    return `runtime: some of the command's output was lost: it wrote faster than it was read, and the sandbox keeps the latest 1 MiB. Write it to a file and copy it out: ${me} sandboxes cp ${id}:/workspace/out.txt .`;
 }
-/** Feeds `runtime sandbox shell` from standard input. When piped input ends,
+/** Feeds `runtime sandboxes shell` from standard input. When piped input ends,
  * the shell is told so the way a terminal says it, Ctrl-D, after a newline
- * if the last line had none: `echo ls | runtime sandbox shell <id>` runs `ls`
+ * if the last line had none: `echo ls | runtime sandboxes shell <id>` runs `ls`
  * and exits, as ssh does, where it used to wait forever (25 September 2026).
  * A keyboard never ends, so a terminal's input is left alone. Returns the
  * function that unhooks it. */
@@ -229,7 +229,7 @@ export function pipeShellInput(stdin, terminal) {
         stdin.off("end", onEnd);
     };
 }
-/** `runtime snapshot get`, as `runtime sandbox get` reads: one fact a line.
+/** `runtime snapshots get`, as `runtime sandboxes get` reads: one fact a line.
  * It printed raw JSON until 25 September 2026; `--json` still does. */
 export function describeSnapshot(s, table) {
     const mib = (bytes) => bytes === null ? "-" : `${Math.ceil(bytes / 1_048_576).toLocaleString("en-US")} MiB`;
@@ -249,7 +249,12 @@ export function describeSnapshot(s, table) {
                 : s.durability.state,
         ],
         ["created", s.createdAt],
-        ["kept until", `${s.expiresAt} (${s.retentionDays} days)`],
+        [
+            "kept until",
+            s.expiresAt === null
+                ? "kept while you have credit"
+                : `${s.expiresAt} (${s.retentionDays} days)`,
+        ],
         [
             "labels",
             Object.entries(labels)

package/dist/cli-words.d.ts

@@ -1,4 +1,5 @@
-import type { RuntimeError } from "./errors.js";
+import { RuntimeError } from "./errors.js";
+import type { ProductName } from "./product-names.js";
 import type { SandboxMetrics } from "./products/observability.js";
 /** A refusal of what a command sent, reworded for the command line: every
  * issue named by its option, since the CLI never prints details.issues, and
@@ -25,3 +26,11 @@ export declare function newestCpu(m: SandboxMetrics, now?: number): {
  * help` filed "help" as feedback, and `runtime support help` sent it to
  * support, until 30 September 2026. */
 export declare function topicHelp(help: string, command: string): string | null;
+/** A command line's product words (CLOUD.md section 4): the plural, or the
+ * singular as a typing shortcut, reach the product silently; an old word
+ * reaches it with `warning` to print, and from its date throws name_retired
+ * naming the new command. Anything else passes through. */
+export declare function productWords(argv: string[], now?: Date, table?: readonly ProductName[]): {
+    argv: string[];
+    warning?: string;
+};

package/dist/cli-words.js

@@ -1,3 +1,5 @@
+import { RuntimeError } from "./errors.js";
+import { cliWords } from "./product-renames.js";
 /* What the CLI says in its own words where the API's would mislead: the
    option a refusal is about rather than the request field it was sent as,
    one fact a line for a resource read, and the newest CPU reading a
@@ -133,3 +135,19 @@ export function topicHelp(help, command) {
     }
     return out.length ? out.join("\n") : null;
 }
+/** A command line's product words (CLOUD.md section 4): the plural, or the
+ * singular as a typing shortcut, reach the product silently; an old word
+ * reaches it with `warning` to print, and from its date throws name_retired
+ * naming the new command. Anything else passes through. */
+export function productWords(argv, now = new Date(), table) {
+    const found = cliWords(argv, now, table);
+    if (!found)
+        return { argv };
+    const { use } = found;
+    if (use.kind === "retired")
+        throw new RuntimeError({ ...use.error });
+    return {
+        argv: found.args,
+        ...(use.kind === "renamed" ? { warning: use.warning } : {}),
+    };
+}

package/dist/cli.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { RuntimeError } from "./errors.js";
-import type { Usage } from "./types.js";
+import type { OutOfMemory, Usage } from "./types.js";
 import type { SwitchProvider } from "./products/switching.js";
 import type { SecretRule } from "./products/secrets.js";
 type Out = {
@@ -38,6 +38,10 @@ export declare function run(argv: string[], env?: NodeJS.ProcessEnv, out?: Out):
  * microdollar (the API's integer microdollars moved six places), so a column
  * sums to the ledger to the last digit. */
 export declare function usageCsv(u: Usage): string;
+/** What a person reads when the sandbox's out-of-memory killer ended a
+ * command: the API's message and hint, on standard error. A bare exit -9 (or
+ * 137) said nothing of memory until 9 October 2026. */
+export declare function outOfMemoryLines(memory: OutOfMemory | undefined): string | undefined;
 /** How to move a rival's code across, when one import does it. */
 export declare function dropInLines(provider: SwitchProvider | undefined): string[];
 /** `--allow` values as secret rules: each is `[METHOD[,METHOD]...] PATH`, and