@tonbo/cli 0.19.0 → 0.20.0

package/dist/bin/tonbo.js

@@ -364,6 +364,20 @@ var managementOperations = {
     "idempotencyKey": false,
     "cli": "tonbo usage series"
   },
+  "getVolumeMetrics": {
+    "method": "GET",
+    "path": "/metrics/volumes",
+    "pathParams": [],
+    "query": [
+      "series",
+      "window",
+      "granularity",
+      "from",
+      "to"
+    ],
+    "idempotencyKey": false,
+    "cli": "tonbo metrics volumes"
+  },
   "getUsageToday": {
     "method": "GET",
     "path": "/usage/today",
@@ -414,6 +428,7 @@ var managementOperations = {
     "pathParams": [],
     "query": [
       "device_id",
+      "project",
       "cursor",
       "limit"
     ],
@@ -2316,6 +2331,10 @@ var ManagementApi = class {
   getUsageSeries(key, query = {}) {
     return this.call("getUsageSeries", key, { query });
   }
+  /** The account's Volume metrics over a window, such as what they stored each day. */
+  getVolumeMetrics(key, query = {}) {
+    return this.call("getVolumeMetrics", key, { query });
+  }
   /** The account's writes of yesterday and today, hourly, per lane. */
   getUsageToday(key) {
     return this.call("getUsageToday", key);
@@ -2819,7 +2838,8 @@ function accountLogins(login) {
     ...entry,
     account_id,
     kind: entry.kind ?? null,
-    name: entry.name ?? null
+    name: entry.name ?? null,
+    role: entry.role ?? null
   }));
   if (!entries.some((entry) => entry.account_id === login.account_id))
     entries.unshift({
@@ -2828,12 +2848,18 @@ function accountLogins(login) {
       key: login.key,
       expires_at: login.expires_at,
       kind: null,
-      name: null
+      name: null,
+      role: null
     });
   return entries;
 }
 function personalLogin(login) {
-  return accountLogins(login).find((entry) => entry.kind === "user") ?? null;
+  const logins = accountLogins(login);
+  const personal = login.session?.personalAccountId;
+  return (personal ? logins.find((entry) => entry.account_id === personal) : void 0) ?? logins.find((entry) => entry.kind === "user" && !isGuestLogin(entry)) ?? null;
+}
+function isGuestLogin(login) {
+  return login.role === "collaborator";
 }
 async function preparePrivateDirectory(directory) {
   const stat3 = await lstat(directory);
@@ -3387,7 +3413,8 @@ var LoginStore = class {
       key: client.bearer(id),
       expires_at: current.session.expires_at,
       kind: current.accounts?.[id]?.kind ?? (id === current.personal_account_id ? "user" : null),
-      name: current.accounts?.[id]?.name ?? null
+      name: current.accounts?.[id]?.name ?? null,
+      role: current.accounts?.[id]?.role ?? null
     });
     accounts[current.personal_account_id] = entry(current.personal_account_id);
     for (const id of Object.keys(current.accounts ?? {}))
@@ -5272,6 +5299,37 @@ async function usageSeriesCommand(deps, options = {}) {
     );
   print(deps, options.json, series, lines.join("\n"));
 }
+async function metricsVolumesCommand(deps, options = {}) {
+  const metrics = await deps.api.getVolumeMetrics(await deps.auth.apiKey(), {
+    series: "stored_bytes",
+    window: options.window,
+    granularity: options.from || options.to ? "day" : void 0,
+    from: options.from,
+    to: options.to
+  });
+  const points = metrics.total.points;
+  const lines = [
+    `What the Volumes stored from ${metrics.from.slice(0, 10)} to ${metrics.to.slice(0, 10)} (UTC, average per day)`,
+    table(
+      ["DAY", "STORED", ""],
+      points.map((point) => [
+        point.start.slice(0, 10),
+        bytes(point.stored_bytes),
+        point.partial ? "so far" : ""
+      ])
+    )
+  ];
+  const complete = points.filter((point) => !point.partial);
+  if (complete.length > 1) {
+    const change = complete[complete.length - 1].stored_bytes - complete[0].stored_bytes;
+    lines.push(
+      `Change over its complete days: ${change < 0 ? "-" : "+"}${bytes(Math.abs(change))}`
+    );
+  }
+  if (metrics.unavailable_regions.length > 0)
+    lines.push(`Not read: ${metrics.unavailable_regions.join(", ")}`);
+  print(deps, options.json, metrics, lines.join("\n"));
+}
 async function streamActivityCommand(deps, name, options = {}) {
   const activity = await deps.api.getStreamActivity(
     await deps.auth.apiKey(),
@@ -7282,6 +7340,14 @@ var COMMAND_HELP = {
     examples: ["tonbo usage series --days 7 --compare"],
     defaults: { "--days": "30" }
   },
+  "tonbo metrics volumes": {
+    about: [
+      "Prints what the account's Volumes stored, one line per UTC day of the window: the average bytes their files held that day, compressed, summed over every region, which is what they are billed for. Today, and a day not fully rated yet, is marked `so far`. Then the change between the window's first and last complete days.",
+      "Give `--window`, or `--from` and `--to` (at most 92 days); the last 30 days when neither is given."
+    ],
+    examples: ["tonbo metrics volumes --window 7d"],
+    defaults: { "--window": "30d" }
+  },
   "tonbo usage today": {
     about: [
       "Prints the account's write units per UTC hour of yesterday and today, in three columns: databases, streams and other."
@@ -9247,6 +9313,13 @@ function createProgram(makeDependencies = createDependencies) {
     ),
     "getUsageToday"
   ).action(async (options) => usageTodayCommand(dependencies(), options));
+  const metrics = program.command("metrics").description("show how the account's resources are used over time");
+  operationOptions(
+    metrics.command("volumes").description("show what the account's Volumes stored, day by day").option("--window <window>", "the last 7d, 30d or 90d, today included").option("--from <day>", "with --to, the first UTC day, as YYYY-MM-DD").option("--to <day>", "with --from, the UTC day the window ends before, as YYYY-MM-DD"),
+    "getVolumeMetrics"
+  ).action(
+    async (options) => metricsVolumesCommand(dependencies(), options)
+  );
   const ssh = program.command("ssh").description("open a terminal on a Machine, or run a command there, over SSH").argument("<machine>", "the Machine's name").argument("[command...]", "a command to run instead of a shell, after --").action(async (name, command) => sshCommand(dependencies(), name, command));
   ssh.command("config").description(
     "print the ssh_config block that lets ssh, scp, sftp and Remote-SSH reach every Machine"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonbo/cli",
-  "version": "0.19.0",
+  "version": "0.20.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": {