@tonbo/cli 0.3.2 → 0.3.3

package/README.md

@@ -207,7 +207,8 @@ Machines belong to an Account independently of Agents. Allocate in `us-east-1`,
 
 ```console
 tonbo --json region list
-tonbo --json machine allocate --account <account-uuid> --region us-east-1
+tonbo --json machine allocate --account <account-uuid> --region us-east-1 --request-id <request-uuid>
+tonbo --json machine allocation <request-uuid> --account <account-uuid>
 tonbo --json machine list --account <account-uuid>
 tonbo --json machine bind <machine-uuid> --agent <agent-uuid>
 tonbo --json machine show <machine-uuid>
@@ -219,3 +220,5 @@ tonbo --json machine release <machine-uuid>
 Only one active Agent binding per Machine and one Machine per Agent are currently supported. Unbinding drains execution and completes physical deletion, final usage settlement and storage credential revocation before the Machine becomes available. Wait for `available: true` in `machine show` before rebinding. Cross-Agent reassignment resets rootfs; the destination mounts its own Agent Workspace and Sessions. Hidden pause/resume within the same Agent retains rootfs and process state. Release also drains an existing binding automatically; it does not delete Agent files or Sessions.
 
 `tonbo agent list` lists accessible Agents without requiring a local `.tonbo` file. JSON command output uses `agent` for one Agent and `agents` for the list; there is no duplicate `agent` output alias.
+
+Persist the allocation request UUID before sending when automating. Reuse it with the same account and region after a lost response; lookup returns the original Machine even after release. Omitting `--request-id` generates one, included in the success output or retry error.

package/dist/bin/tonbo.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 // src/app.ts
+import { randomUUID as randomUUID4 } from "node:crypto";
 import { Command } from "commander";
 import { readFileSync } from "node:fs";
 
@@ -2719,13 +2720,33 @@ function createProgram(dependencies = createDependencies) {
       )
     );
   });
-  machine.command("allocate").requiredOption("--account <account>", "owning account UUID").requiredOption("--region <region>", "compute region (see tonbo region list)").action(async (options) => {
+  machine.command("allocate").requiredOption("--account <account>", "owning account UUID").requiredOption("--region <region>", "compute region (see tonbo region list)").option(
+    "--request-id <uuid>",
+    "stable allocation request UUID; reuse it after an uncertain response"
+  ).action(async (options) => {
     const deps = dependencies(jsonOutput(program));
-    deps.output(
-      await deps.api.machineRequest(await deps.auth.accessToken(), "", "POST", {
+    const requestId = options.requestId ?? randomUUID4();
+    try {
+      const result = await deps.api.machineRequest(await deps.auth.accessToken(), "", "POST", {
         accountId: options.account,
-        region: options.region
-      })
+        region: options.region,
+        requestId
+      });
+      deps.output({ ...result, requestId });
+    } catch (cause) {
+      throw new Error(
+        `Machine allocation was not confirmed. Retry with --request-id ${requestId} and the same account and region.`,
+        { cause }
+      );
+    }
+  });
+  machine.command("allocation <requestId>").description("query the original Machine for an allocation request").requiredOption("--account <account>", "owning account UUID").action(async (requestId, options) => {
+    const deps = dependencies(jsonOutput(program));
+    deps.output(
+      await deps.api.machineRequest(
+        await deps.auth.accessToken(),
+        `/allocations/${encodeURIComponent(requestId)}?account=${encodeURIComponent(options.account)}`
+      )
     );
   });
   for (const operation of ["show", "metrics", "release"]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonbo/cli",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Deploy persistent Agents and manage their Machines from the command line.",
   "homepage": "https://tonbo.dev",
   "bugs": {