@tonbo/cli 0.1.1 → 0.1.2

package/README.md

@@ -44,7 +44,7 @@ Use the arrow keys and Enter to select a supported Harness and either create or
 The generated `.tonbo` is TOML:
 
 ```toml
-# Tonbo Agent Agent configuration.
+# Tonbo Agent configuration.
 # Edit this file directly or run `tonbo init` to reconfigure.
 version = 2
 agent = "my-agent-my-account.tonbo.sh"
@@ -61,7 +61,7 @@ model = "claude-sonnet-4-5"
 
 The immutable full Agent hostname is the only durable Agent authority in the source tree; it is not a credential. This keeps Agents with the same name in different Organizations unambiguous. `deploy`, `run`, `ssh` and `secret` refuse an unbound declaration. `tonbo agent use <name-hostname-or-id>` accepts any convenient selector, resolves it through the signed-in account and writes the selected `project-organization.tonbo.sh` hostname into `.tonbo`; rebinding an existing declaration requires interactive confirmation or `--force`. UUIDs remain internal API identities and are never committed by the CLI.
 
-The default inference model is written without prompting. Override it explicitly with `--model`. Headless initialization makes Harness and driver choices explicit and may bind the resulting declaration with `project use`:
+The default inference model is written without prompting. Override it explicitly with `--model`. Headless initialization makes Harness and driver choices explicit and may bind the resulting declaration with `agent use`:
 
 ```console
 tonbo init --harness pi --driver native
@@ -200,3 +200,21 @@ Node.js 22 or newer is required. Human OAuth tokens are stored at `${XDG_CONFIG_
 - [Agent Deployments, Production and Rollouts](../../docs/design/project-deployments.md)
 - [ADR-0008: Tonbo CLI onboarding and credential boundaries](../../apps/user-center/docs/decisions/adr-0008-tonbo-cli-onboarding.md)
 - [Management API v1](../../contracts/management/openapi-v1.yaml)
+
+## Machines
+
+Machines belong to an Account independently of Agents. Allocate in `us-east-1`, bind an available Machine from Agent detail or the CLI, inspect measured metrics, and release it when no longer needed. Allocation starts no compute. The platform handles idle pause/resume automatically; there are no customer power controls or arbitrary Machine command/upload APIs.
+
+```console
+tonbo --json machine allocate --account <account-uuid> --region us-east-1
+tonbo --json machine list --account <account-uuid>
+tonbo --json machine bind <machine-uuid> --agent <agent-uuid>
+tonbo --json machine show <machine-uuid>
+tonbo --json machine metrics <machine-uuid>
+tonbo --json machine unbind <machine-uuid>
+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 `project` output alias.

package/dist/bin/tonbo.js

@@ -1734,7 +1734,7 @@ function initSaveLabel(exists, project) {
 }
 async function selectInitProject(deps, root) {
   for (; ; ) {
-    const action = await deps.select("How should this Agent connect to Tonbo?", [
+    const action = await deps.select("How should this directory connect to Tonbo?", [
       {
         description: "Create it only after you confirm the complete configuration.",
         name: "Create a new agent",
@@ -1782,7 +1782,7 @@ async function selectInitProject(deps, root) {
       continue;
     }
     const id = await deps.select(
-      "Which agent should this Agent use?",
+      "Which agent should this directory use?",
       projects.map((project2) => ({
         name: project2.name,
         description: `Organization: ${project2.organizationName} \xB7 ${project2.publicHostname} \xB7 ${project2.id}`,
@@ -1935,7 +1935,10 @@ async function projectUseCommand(deps, selector, force = false) {
   const projects = await deps.api.listProjects(oauthToken);
   const project = selectProject(projects, selector);
   if (declaration.agent === project.publicHostname) {
-    deps.output({ message: `.tonbo already uses agent ${project.publicHostname}.`, project });
+    deps.output({
+      message: `.tonbo already uses agent ${project.publicHostname}.`,
+      agent: project
+    });
     return;
   }
   if (declaration.agent && !force) {
@@ -1959,7 +1962,7 @@ async function projectUseCommand(deps, selector, force = false) {
     }
   }
   await bindDeclarationProject(root, project.publicHostname);
-  deps.output({ message: `Bound .tonbo to agent ${project.publicHostname}.`, project });
+  deps.output({ message: `Bound .tonbo to agent ${project.publicHostname}.`, agent: project });
 }
 async function projectCreateCommand(deps, name) {
   const root = await findDeclarationRoot(deps.cwd());
@@ -1980,7 +1983,7 @@ async function projectCreateCommand(deps, name) {
       { cause: error }
     );
   }
-  deps.output({ message: `Created agent ${project.name} and bound it in .tonbo.`, project });
+  deps.output({ message: `Created agent ${project.name} and bound it in .tonbo.`, agent: project });
 }
 async function deployCommand(deps, options = { promote: true }) {
   const { declaration, oauthToken, project, root } = await resolveProject(deps);
@@ -2023,7 +2026,7 @@ async function deployCommand(deps, options = { promote: true }) {
       `  ssh ${project.sshDestination}`
     );
   }
-  deps.output({ message: lines.join("\n"), project, ...result });
+  deps.output({ message: lines.join("\n"), agent: project, ...result });
 }
 async function runCommand(deps, prompt, options) {
   const { oauthToken, project } = await resolveProject(deps);
@@ -2036,10 +2039,17 @@ async function runCommand(deps, prompt, options) {
   });
   deps.output({
     message: result.turn.assistant_text,
-    project,
+    agent: project,
     ...result
   });
 }
+async function agentListCommand(deps) {
+  const agents = await deps.api.listProjects(await deps.auth.accessToken());
+  deps.output({
+    message: agents.length ? agents.map((agent) => `${agent.name} \xB7 ${agent.publicHostname}`).join("\n") : "No agents are available.",
+    agents
+  });
+}
 async function projectShowCommand(deps) {
   const { project, token } = await projectManagement(deps);
   const production = await deps.api.getProduction(project.id, token);
@@ -2055,7 +2065,7 @@ async function projectShowCommand(deps) {
       `production: ${deploymentName(deployment)} (${shortDeploymentId(deployment.id)}) ${productionStateLabel(deployment)}`
     );
   }
-  deps.output({ message: lines.join("\n"), project, production, deployment });
+  deps.output({ message: lines.join("\n"), agent: project, production, deployment });
 }
 function shortDeploymentId(id) {
   return id.replace(/-/g, "").slice(0, 8);
@@ -2125,7 +2135,7 @@ async function deploymentsListCommand(deps) {
       deployment.created_by_user_id ? shortDeploymentId(deployment.created_by_user_id) : ""
     ])
   ) : `No Deployments exist for agent ${project.name}. Run \`tonbo deploy\` to create one.`;
-  deps.output({ message, project, production, deployments });
+  deps.output({ message, agent: project, production, deployments });
 }
 async function deploymentsShowCommand(deps, prefix) {
   const { project, token } = await projectManagement(deps);
@@ -2135,7 +2145,7 @@ async function deploymentsShowCommand(deps, prefix) {
   );
   deps.output({
     message: renderDeploymentDetail(deployment, rollouts),
-    project,
+    agent: project,
     deployment,
     rollouts
   });
@@ -2181,7 +2191,7 @@ async function deploymentsPromoteCommand(deps, prefix) {
   const result = await moveProduction(deps, project.id, target, token);
   deps.output({
     message: describeProductionMove(project, result, "Promoted"),
-    project,
+    agent: project,
     ...result
   });
 }
@@ -2205,7 +2215,7 @@ async function deploymentsRollbackCommand(deps, prefix) {
   const result = await moveProduction(deps, project.id, target, token);
   deps.output({
     message: describeProductionMove(project, result, "Rolled back"),
-    project,
+    agent: project,
     ...result
   });
 }
@@ -2246,7 +2256,7 @@ async function secretListCommand(deps) {
   const secrets = await deps.api.listProjectSecrets(project.id, token);
   deps.output({
     message: secrets.length ? secrets.map((secret) => secret.name).join("\n") : "No agent secrets are configured.",
-    project,
+    agent: project,
     secrets
   });
 }
@@ -2256,14 +2266,14 @@ async function secretSetCommand(deps, name, options) {
   const secret = await deps.api.setProjectSecret(project.id, name, value, token);
   deps.output({
     message: `Set agent secret ${secret.name}. Redeploy to replace the active runtime with this value.`,
-    project,
+    agent: project,
     secret
   });
 }
 async function secretRemoveCommand(deps, name) {
   const { project, token } = await projectManagement(deps);
   await deps.api.deleteProjectSecret(project.id, name, token);
-  deps.output({ message: `Removed agent secret ${name}.`, project, name });
+  deps.output({ message: `Removed agent secret ${name}.`, agent: project, name });
 }
 
 // src/credentials.ts
@@ -2523,7 +2533,7 @@ function jsonOutput(program) {
   return program.opts().json === true;
 }
 function createProgram(dependencies = createDependencies) {
-  const program = new Command().name("tonbo").description("Deploy a persistent Agent Agent to Tonbo.").version(packageVersion.version).option("--json", "print machine-readable JSON");
+  const program = new Command().name("tonbo").description("Deploy a persistent Agent to Tonbo.").version(packageVersion.version).option("--json", "print machine-readable JSON");
   program.command("init").description("interactively create a Tonbo Agent declaration in this directory").option("--harness <harness>", "Agent Harness (currently pi)").option("--model <model>", "inference model").option("--driver <driver>", "PI driver: native or command").option("--agent-entry <file>", "Node entry file for the command driver").option("--build-command <argv...>", "build command argv for the command driver").option("--force", `replace an existing ${DECLARATION_FILENAME}`).action(
     async (options) => initCommand(dependencies(jsonOutput(program)), options)
   );
@@ -2583,17 +2593,18 @@ function createProgram(dependencies = createDependencies) {
       })
     );
   });
-  const project = program.command("agent").description("manage the agent bound to this Agent directory");
-  project.command("create <name>").description("create and bind a agent to this Agent directory").action(async (name) => projectCreateCommand(dependencies(jsonOutput(program)), name));
+  const project = program.command("agent").description("manage the Agent bound to this source directory");
+  project.command("create <name>").description("create an agent and bind this directory to it").action(async (name) => projectCreateCommand(dependencies(jsonOutput(program)), name));
+  project.command("list").description("list the agents available to your account").action(async () => agentListCommand(dependencies(jsonOutput(program))));
   const sshKey = program.command("ssh-key").description("manage public keys used by native agent SSH");
   sshKey.command("add <public-key>").description("register an OpenSSH public key with the current Tonbo account").action(async (path6) => sshKeyAddCommand(dependencies(jsonOutput(program)), path6));
   sshKey.command("remove <fingerprint>").description("revoke an SSH public key from the current Tonbo account").action(
     async (fingerprint) => sshKeyRemoveCommand(dependencies(jsonOutput(program)), fingerprint)
   );
-  project.command("use <agent>").description("write a agent ID into this Agent's .tonbo declaration").option("--force", "replace an existing agent binding without confirmation").action(
+  project.command("use <agent>").description("write the agent hostname into this directory's .tonbo declaration").option("--force", "replace an existing agent binding without confirmation").action(
     async (selector, options) => projectUseCommand(dependencies(jsonOutput(program)), selector, options.force === true)
   );
-  project.command("show").description("show the agent bound to this Agent directory and its connection addresses").action(async () => projectShowCommand(dependencies(jsonOutput(program))));
+  project.command("show").description("show the agent bound to this directory and its connection addresses").action(async () => projectShowCommand(dependencies(jsonOutput(program))));
   program.command("deploy").description("upload this directory as a new Deployment and promote it to Production").option("--no-promote", "create the Deployment without moving Production").action(
     async (options) => deployCommand(dependencies(jsonOutput(program)), { promote: options.promote })
   );

package/package.json

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