@tonbo/cli 0.29.0 → 0.30.0

package/dist/bin/tonbo.js

@@ -6225,6 +6225,25 @@ function sleepText(machine) {
   if (action !== "release") return `${when2}; it then ${action}s`;
   return `${when2}; the disk resets at every sleep${reason2 === "suspend_unavailable" ? " until suspend ships" : ""}`;
 }
+var RESTORE_WORDS = {
+  snapshot_evicted: "Snapshot expired",
+  host_unavailable: "Its host was unavailable",
+  spec_changed: "Its configuration changed",
+  stopped: "It was stopped",
+  domain_mismatch: "Snapshot did not fit the host",
+  memory_missing: "Snapshot was incomplete",
+  generation_absent: "Snapshot was not found",
+  generation_unfit: "Snapshot could not be used",
+  failed_after_load: "Resume failed"
+};
+function restoreFields(machine) {
+  const restore = machine.status.restore;
+  if (!restore) return [];
+  if (restore.outcome === "restored") return [["Last wake", "resumed where it slept"]];
+  const fresh = restore.outcome === "fresh_retained_disks" ? "booted fresh, disk kept" : "booted fresh";
+  const why = restore.reason ? RESTORE_WORDS[restore.reason] ?? restore.reason : null;
+  return [["Last wake", why ? `${why}; ${fresh}` : fresh]];
+}
 function activationFields(machine) {
   const { activation } = machine;
   if (!activation) return [];
@@ -6332,6 +6351,7 @@ function machineFields(machine, billing, etag = null, lastEnd = null, volumeName
     ["Power", powerText(machine)],
     ...awakeFields(machine),
     ...activationFields(machine),
+    ...restoreFields(machine),
     ...lastEnd ? [["Last end", endText(lastEnd)]] : [],
     ...conditionFields(machine, billing),
     ["Sleeps", sleepText(machine)],
@@ -7649,7 +7669,7 @@ var COMMAND_HELP = {
   },
   "tonbo machine create": {
     about: [
-      "Creates a Machine, a VM booted from an image in one region. It has no database of its own: `--database <name>` binds one of the account's databases of its region, which it then reaches at `TONBO_DATABASE_URL`, and a database binds one Machine at a time; its disk can last on a Volume (`--volume <name>` keeps the Machine's whole disk on it, and `--volume <name>:<path>` mounts it at a path instead), and its program can open any other database by URL with a key. The image is a public OCI image with a linux/arm64 variant, from Docker Hub or another public registry (`nginx:1.27`, `ghcr.io/org/app:v1`, or one pinned by digest), or `tonbo.dev/platform`, the platform image. A registry reachable only over IPv6, one named by an IP address, and one that redirects its manifests are refused. The CLI resolves a registry image to its linux/arm64 digest, and the image is pulled before the Machine leaves `creating`.",
+      "Creates a Machine, a VM booted from an image in one region. It has no database of its own: `--database <name>` binds one of the account's databases of its region, which it then reaches at `TONBO_DATABASE_URL`, and a database binds one Machine at a time; its disk can last on a Volume (`--volume <name>` keeps the Machine's whole disk on it, and `--volume <name>:<path>` mounts it at a path instead), and its program can open any other database by URL with a key. The image is a public OCI image, multi-arch (as the official Docker Hub images are) or built for linux/arm64, from Docker Hub or another public registry (`nginx:1.27`, `ghcr.io/org/app:v1`, or one pinned by digest), or `tonbo.dev/platform`, the platform image. A registry reachable only over IPv6, one named by an IP address, and one that redirects its manifests are refused. The CLI resolves a registry image to its linux/arm64 digest, and the image is pulled before the Machine leaves `creating`.",
       "The Machine is served at `https://<name>-<account>.tonbo.sh` on its default port. `--port <port>` serves a private port, which takes a member's token, and `--port <port>:public` an open one, which needs the `machines.public` capability. A command after `--` replaces the image's CMD. `--secret-env KEY=FILE` and `--secret-file KEY=FILE` read initial secrets from local files and store them with the Machine before its first boot; their values are never returned. The CLI warns on stderr when the Machine has no port, since nothing can wake it then, and when an `--env` key looks secret: env values are readable by every member through the API.",
       "`--move-from <machine>` takes the `--volume` from the Machine that has it now, in the same write as the create: that Machine's binding is removed (its ETag changes) and it boots without the Volume. It is refused while that Machine is awake with the Volume attached (`volume_attached`: `tonbo machine sleep <machine>` first), or when another Machine has the Volume (`volume_holder_changed`); either way nothing is created or changed. Without it, a Volume another Machine has is refused.",
       "The answer is the Machine while it is `creating`. With `--wait` the CLI reads it until it is `active` or `failed`, or `--timeout` passes: a failure prints what to do and exits 1, and a timeout says it is still creating and undoes nothing. A creation the network or a 5xx answer did not confirm is sent at most three times with the same idempotency key, each retry after its `Retry-After` (at most 30 s) or a short backoff; a `name_taken` refusal says which Machine holds the name and how old it is, in case it is yours from a lost reply. In a region not open for Machines the creation is refused with `region_not_offered`, and nothing is created."
@@ -9766,7 +9786,7 @@ function createProgram(makeDependencies = createDependencies) {
         "create a Machine from an image; [command...] after -- replaces the image's CMD"
       ).requiredOption(
         "--image <reference>",
-        "the image the Machine boots: a public OCI image with a linux/arm64 variant (nginx:1.27, ghcr.io/org/app@sha256:...), or tonbo.dev/platform"
+        "the image the Machine boots: a public OCI image, multi-arch or built for linux/arm64 (nginx:1.27, ghcr.io/org/app@sha256:...), or tonbo.dev/platform"
       ).option("--region <region>", "the Machine's region, fixed for its life").option(
         "--database <name>",
         "bind the account's database <name> (see tonbo database list), of the Machine's region: its URL is TONBO_DATABASE_URL and the Machine writes it"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonbo/cli",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "The Tonbo CLI. Compute, disks, databases and streams for AI agents: your agent picks what it needs, sets it up, and knows what it costs, from the command line.",
   "homepage": "https://tonbo.dev",
   "bugs": {