@kvbox/cli 0.5.11 → 0.5.12

package/dist/kvbox.js

@@ -162,7 +162,7 @@ function versionOf(srcFileUrl, injected) {
 }
 
 // src/version.ts
-var VERSION = versionOf(import.meta.url, true ? "0.5.11" : void 0);
+var VERSION = versionOf(import.meta.url, true ? "0.5.12" : void 0);
 
 // src/commands/vm/index.ts
 import { Command as Command17 } from "commander";
@@ -820,6 +820,7 @@ async function resolveTarget(opts, p = paths()) {
   }
   return { kind: "local", socketPath: p.serverSock };
 }
+var allQuery = (opts) => opts.all ? "?all=1" : "";
 var ServerClient = class {
   constructor(target, opts = {}) {
     this.target = target;
@@ -886,9 +887,12 @@ var ServerClient = class {
   capacity() {
     return this.call("GET", "/capacity", CapacitySchema);
   }
-  /** Through a control plane: every box the user can see, or the `--org` org's. */
-  listMachines() {
-    return this.call("GET", "/machines", z3.array(MachineSchema));
+  /**
+   * Through a control plane: the user's boxes and their orgs', the `--org` org's, or `org`'s;
+   * `all`: every box on the platform (platform admins only, #78).
+   */
+  listMachines(opts = {}) {
+    return this.call("GET", `/machines${allQuery(opts)}`, z3.array(MachineSchema), void 0, opts.org);
   }
   createMachine(req) {
     return this.call("POST", "/machines", MachineSchema, req);
@@ -930,8 +934,9 @@ var ServerClient = class {
     return this.call("GET", `/machines/${encodeURIComponent(name)}/usage${query}`, MachineUsageSchema);
   }
   /** Every box of the caller over the window (#41 on a host, #42 through a control plane); dates as the user wrote them. */
-  usageReport(since, until) {
+  usageReport(since, until, all = false) {
     const q = new URLSearchParams();
+    if (all) q.set("all", "1");
     if (since !== void 0) q.set("since", since);
     if (until !== void 0) q.set("until", until);
     const query = q.size === 0 ? "" : `?${q.toString()}`;
@@ -944,8 +949,9 @@ var ServerClient = class {
   deleteMachine(name) {
     return this.call("DELETE", `/machines/${encodeURIComponent(name)}`, z3.undefined());
   }
-  listSnapshots() {
-    return this.call("GET", "/snapshots", z3.array(SnapshotSchema));
+  /** Like `listMachines`, for snapshots. */
+  listSnapshots(opts = {}) {
+    return this.call("GET", `/snapshots${allQuery(opts)}`, z3.array(SnapshotSchema), void 0, opts.org);
   }
   createSnapshot(req) {
     return this.call("POST", "/snapshots", SnapshotSchema, req);
@@ -1031,6 +1037,11 @@ async function wakeUp(client, box, name) {
       return box;
   }
 }
+function boxesFor(client, text) {
+  const slash = text.indexOf("/");
+  if (slash === -1 || client.target.kind !== "cloud") return client.listMachines();
+  return client.listMachines({ org: text.slice(0, slash).split("@")[0] });
+}
 var me = (client) => client.target.kind === "cloud" ? client.target.user : void 0;
 async function clientFor(opts, client = {}) {
   return new ServerClient(await resolveTarget(opts), client);
@@ -1200,7 +1211,7 @@ var connectCommand = new Command2("connect").alias("cn").description("open a she
   let cert;
   let owner;
   try {
-    let box = pickRef(await client.listMachines(), name, me(client));
+    let box = pickRef(await boxesFor(client, name), name, me(client));
     if (!box) throw new KvboxError(`box ${name}: not found (kvbox ls)`);
     cert = await ensureCert(client, void 0, void 0, { owner: box.owner });
     owner = box.owner;
@@ -1278,7 +1289,7 @@ var execCommand = new Command3("exec").description("run a command in a box and e
   let cert;
   let owner;
   try {
-    let box = pickRef(await client.listMachines(), name, me(client));
+    let box = pickRef(await boxesFor(client, name), name, me(client));
     if (!box) throw new KvboxError(`box ${name}: not found (kvbox ls)`);
     if (box.status === "stopped") throw new KvboxError(`box ${name} is stopped (kvbox start ${name})`);
     cert = await ensureCert(client, void 0, void 0, { owner: box.owner });
@@ -1334,7 +1345,7 @@ var hibernateCommand = new Command4("hibernate").description("save a box's memor
 });
 
 // src/commands/vm/ls.ts
-import { Command as Command5, Option as Option2 } from "commander";
+import { Command as Command5 } from "commander";
 function ownerCell(b, me2) {
   const slug = slugOf(b.owner);
   if (slug === me2) return "private";
@@ -1344,10 +1355,10 @@ function addressOf(b) {
   if (b.ssh !== void 0) return `${b.ssh.host}:${b.ssh.port}`;
   return b.ip === "" ? "-" : b.ip;
 }
-var lsCommand = new Command5("ls").description("list boxes with status and address (yours and your orgs'; --org <slug> for one org)").addOption(new Option2("-a, --all", "kept for older scripts: the listing covers everything you can see anyway").hideHelp()).option("--json", "print as JSON").action(async (opts, cmd) => {
+var lsCommand = new Command5("ls").description("list boxes with status and address (yours and your orgs'; --org <slug> for one org)").option("-a, --all", "every box on the platform (platform admins only)").option("--json", "print as JSON").action(async (opts, cmd) => {
   const client = await clientFor(cmd.optsWithGlobals());
   try {
-    const boxes = await client.listMachines();
+    const boxes = await client.listMachines({ all: opts.all });
     if (opts.json) {
       json(boxes);
       return;
@@ -1388,8 +1399,8 @@ var pauseCommand = new Command6("pause").description("freeze a box in place (mem
 });
 
 // src/commands/vm/rescale.ts
-import { Command as Command7, Option as Option3 } from "commander";
-var rescaleCommand = new Command7("rescale").description("change a box's vCPUs, memory or disk (e.g. --vcpu 4 --mem 16GB); a running box restarts").argument("<name>", "box name").addOption(new Option3("-s, --size <size>", "a preset to start from").choices(SIZE_NAMES)).option("--vcpu <n>", "number of vCPUs").option("--mem <size>", "memory, e.g. 16GB or 4096MB").option("--disk <size>", "disk size, e.g. 32GB (grow only)").option("--json", "print the box as JSON").action(async (name, opts, cmd) => {
+import { Command as Command7, Option as Option2 } from "commander";
+var rescaleCommand = new Command7("rescale").description("change a box's vCPUs, memory or disk (e.g. --vcpu 4 --mem 16GB); a running box restarts").argument("<name>", "box name").addOption(new Option2("-s, --size <size>", "a preset to start from").choices(SIZE_NAMES)).option("--vcpu <n>", "number of vCPUs").option("--mem <size>", "memory, e.g. 16GB or 4096MB").option("--disk <size>", "disk size, e.g. 32GB (grow only)").option("--json", "print the box as JSON").action(async (name, opts, cmd) => {
   const req = {
     ...opts.size !== void 0 ? { size: opts.size } : {},
     ...opts.vcpu !== void 0 ? { vcpu: parseCount(opts.vcpu) } : {},
@@ -1399,7 +1410,7 @@ var rescaleCommand = new Command7("rescale").description("change a box's vCPUs,
   if (Object.keys(req).length === 0) throw new KvboxError("nothing to change: give --size, --vcpu, --mem or --disk");
   const client = await clientFor(cmd.optsWithGlobals());
   try {
-    const before = pickRef(await client.listMachines(), name, me(client));
+    const before = pickRef(await boxesFor(client, name), name, me(client));
     if (!before) throw new KvboxError(`box ${name}: not found (kvbox ls)`);
     const box = await spin(`rescaling ${name}\u2026`, client.rescaleMachine(displayName(before, me(client)), req));
     if (opts.json) {
@@ -1451,7 +1462,7 @@ import { Command as Command9 } from "commander";
 var rmCommand = new Command9("rm").description("destroy a box (its disk is deleted; snapshots are kept)").argument("<name>", "box name").option("-y, --yes", "do not ask for confirmation").action(async (name, opts, cmd) => {
   const client = await clientFor(cmd.optsWithGlobals());
   try {
-    const box = pickRef(await client.listMachines(), name, me(client));
+    const box = pickRef(await boxesFor(client, name), name, me(client));
     if (!box) throw new KvboxError(`box ${name}: not found (kvbox ls)`);
     const ref = displayName(box, me(client));
     if (!await confirm(`Destroy box ${ref} and its disk?`, opts.yes ?? false)) {
@@ -1473,7 +1484,7 @@ var setCommand = new Command10("set").description("change a box's settings, e.g.
   const autoHibernateSec = parseIdleTimeout(opts.autoHibernate);
   const client = await clientFor(cmd.optsWithGlobals());
   try {
-    const found = pickRef(await client.listMachines(), name, me(client));
+    const found = pickRef(await boxesFor(client, name), name, me(client));
     if (!found) throw new KvboxError(`box ${name}: not found (kvbox ls)`);
     const box = await spin(`updating ${name}\u2026`, client.setMachine(displayName(found, me(client)), { autoHibernateSec }));
     if (opts.json) {
@@ -1514,10 +1525,10 @@ var stopCommand = new Command12("stop").description("shut a box down (its disk i
 
 // src/commands/vm/top.ts
 import { Command as Command13 } from "commander";
-var topCommand = new Command13("top").description("load, memory and disk of each running box, as the box itself sees them").option("--json", "print as JSON").action(async (opts, cmd) => {
+var topCommand = new Command13("top").description("load, memory and disk of each running box, as the box itself sees them").option("-a, --all", "every running box on the platform (platform admins only)").option("--json", "print as JSON").action(async (opts, cmd) => {
   const client = await clientFor(cmd.optsWithGlobals());
   try {
-    const running = (await client.listMachines()).filter((b) => b.status === "running");
+    const running = (await client.listMachines({ all: opts.all })).filter((b) => b.status === "running");
     const entries = await mapLimit(running, ASK_AT_ONCE, async (b) => {
       const who = { name: b.name, owner: b.owner, ...b.ownerKind === void 0 ? {} : { ownerKind: b.ownerKind } };
       try {
@@ -1578,7 +1589,7 @@ import { Command as Command14 } from "commander";
 var updateCommand = new Command14("update").description("move a box onto the current base image (its files stay; a running box restarts)").argument("<name>", "box name").option("--json", "print the box as JSON").action(async (name, opts, cmd) => {
   const client = await clientFor(cmd.optsWithGlobals());
   try {
-    const before = pickRef(await client.listMachines(), name, me(client));
+    const before = pickRef(await boxesFor(client, name), name, me(client));
     if (!before) throw new KvboxError(`box ${name}: not found (kvbox ls)`);
     const box = await spin(`updating ${name}\u2026`, client.updateMachine(displayName(before, me(client))));
     if (opts.json) {
@@ -2009,12 +2020,12 @@ function describeSession(session) {
 import { Command as Command32 } from "commander";
 
 // src/commands/snapshots/ls.ts
-import { Command as Command29, Option as Option4 } from "commander";
-var lsCommand2 = new Command29("ls").description("list snapshots (yours and your orgs'; --org <slug> for one org)").addOption(new Option4("-a, --all", "kept for older scripts: the listing covers everything you can see anyway").hideHelp()).option("--json", "print as JSON").action(async (opts, cmd) => {
+import { Command as Command29 } from "commander";
+var lsCommand2 = new Command29("ls").description("list snapshots (yours and your orgs'; --org <slug> for one org)").option("-a, --all", "every snapshot on the platform (platform admins only)").option("--json", "print as JSON").action(async (opts, cmd) => {
   const client = await clientFor(cmd.optsWithGlobals());
   try {
     const cloud = client.target.kind === "cloud";
-    const snaps = await client.listSnapshots();
+    const snaps = await client.listSnapshots({ all: opts.all });
     if (opts.json) {
       json(snaps);
       return;
@@ -2120,7 +2131,7 @@ function orgRows(orgs) {
 }
 
 // src/commands/org/members.ts
-import { Command as Command34, Option as Option5 } from "commander";
+import { Command as Command34, Option as Option3 } from "commander";
 var lsCommand4 = new Command34("ls").description("list an org's members and their roles").option("-o, --org <slug>", "the org (or --org before the command)").option("--json", "print as JSON").action(async (opts, cmd) => {
   const client = await cloudClientFor(cmd.optsWithGlobals());
   try {
@@ -2135,7 +2146,7 @@ var lsCommand4 = new Command34("ls").description("list an org's members and thei
     await client.close();
   }
 });
-var addCommand = new Command34("add").description("add a user to an org (admins and owners; only an owner can add an owner)").argument("<user>", "their username").addOption(new Option5("-r, --role <role>", "their role").choices(ORG_ROLES).default("member")).option("-o, --org <slug>", "the org (or --org before the command)").action(async (user, opts, cmd) => {
+var addCommand = new Command34("add").description("add a user to an org (admins and owners; only an owner can add an owner)").argument("<user>", "their username").addOption(new Option3("-r, --role <role>", "their role").choices(ORG_ROLES).default("member")).option("-o, --org <slug>", "the org (or --org before the command)").action(async (user, opts, cmd) => {
   const client = await cloudClientFor(cmd.optsWithGlobals());
   try {
     const slug = orgFor(opts, client.target);
@@ -2215,7 +2226,7 @@ var orgCommand = new Command38("org").description("orgs: shared slugs that own b
 
 // src/commands/usage.ts
 import { Command as Command39 } from "commander";
-var usageCommand2 = new Command39("usage").description("what your boxes used this month (or --since/--until): running time, vCPU-h, RAM and disk GiB-h, cost").option("--since <date>", "count from this date, e.g. 2026-10-01 (default: the 1st of this month)").option("--until <date>", "count up to this date (default: now)").option("--org <slug>", "one org's boxes only").option("--json", "print as JSON").action(async (opts, cmd) => {
+var usageCommand2 = new Command39("usage").description("what your boxes used this month (or --since/--until): running time, vCPU-h, RAM and disk GiB-h, cost").option("--since <date>", "count from this date, e.g. 2026-10-01 (default: the 1st of this month)").option("--until <date>", "count up to this date (default: now)").option("--org <slug>", "one org's boxes only").option("-a, --all", "every box on the platform (platform admins only)").option("--json", "print as JSON").action(async (opts, cmd) => {
   for (const [name, value] of [
     ["since", opts.since],
     ["until", opts.until]
@@ -2225,7 +2236,7 @@ var usageCommand2 = new Command39("usage").description("what your boxes used thi
   const client = await clientFor(cmd.optsWithGlobals());
   try {
     if (client.target.kind === "local" && cmd.optsWithGlobals().org) throw new KvboxError("--org needs a control plane: kvbox login, or drop --org");
-    const report = await client.usageReport(opts.since, opts.until);
+    const report = await client.usageReport(opts.since, opts.until, opts.all);
     if (opts.json) {
       json(report);
       return;