@stndrds/cli 1.0.0-alpha.295 → 1.0.0-alpha.296

package/dist/bin.mjs

@@ -16,62 +16,11 @@ function createClient(config) {
   });
 }
 
-// src/commands/auth.ts
-import chalk from "chalk";
-
-// src/commands/common.ts
-function getGlobalOptions(cmd) {
-  return cmd.optsWithGlobals();
-}
-function getFormat(cmd) {
-  return getGlobalOptions(cmd).format;
-}
-function parseCsvList(value) {
-  return value.split(",").map((item) => item.trim()).filter((item) => item.length > 0);
-}
-function getClientFromCommand(cmd) {
-  const root = getGlobalOptions(cmd);
-  if (!(root.apiUrl && root.apiKey)) {
-    throw new Error('No Standards instance configured. Run "standards login" or pass --api-key.');
-  }
-  return createClient({ apiUrl: root.apiUrl, apiKey: root.apiKey, tenantId: root.tenant });
-}
-function requireTenant(cmd, message) {
-  const { tenant } = getGlobalOptions(cmd);
-  if (!tenant) {
-    throw new Error(message);
-  }
-  return tenant;
-}
-function messageOf(error) {
-  return error instanceof Error ? error.message : String(error);
-}
-
-// src/commands/auth.ts
-function registerAuthCommand(program) {
-  const auth = program.command("auth").description("Inspect CLI authentication");
-  auth.command("whoami").description("Show current configuration and validate API key").action(async (_opts, cmd) => {
-    const root = getGlobalOptions(cmd);
-    const client = getClientFromCommand(cmd);
-    const write = (msg) => process.stdout.write(`${msg}
-`);
-    write(chalk.bold("Standards CLI Configuration"));
-    write(`  API URL:  ${root.apiUrl}`);
-    write(`  API Key:  ${root.apiKey ? `${root.apiKey.slice(0, 8)}...` : chalk.red("not set")}`);
-    write("");
-    const keys = await client.get("/api-keys");
-    write(chalk.green("\u2713 API key is valid"));
-    if (Array.isArray(keys) && keys.length > 0) {
-      const activeKeys = keys.filter(
-        (key) => typeof key === "object" && key !== null && !("revokedAt" in key && key.revokedAt)
-      );
-      write(`  Active keys: ${activeKeys.length}`);
-    }
-  });
-}
+// src/commands/ai.ts
+import { ValidationError } from "@stndrds/schema";
 
 // src/output.ts
-import chalk2 from "chalk";
+import chalk from "chalk";
 import Table from "cli-table3";
 var MAX_CELL_WIDTH = 50;
 function truncate(value, maxLength) {
@@ -100,7 +49,7 @@ function formatTable(items) {
   if (items.length === 0) return "No results.";
   const headers = Object.keys(items[0]);
   const table = new Table({
-    head: headers.map((h) => chalk2.bold(h)),
+    head: headers.map((h) => chalk.bold(h)),
     style: { head: [], border: [] }
   });
   for (const item of items) {
@@ -130,6 +79,90 @@ function formatOutput(data, format) {
 `);
 }
 
+// src/commands/common.ts
+function getGlobalOptions(cmd) {
+  return cmd.optsWithGlobals();
+}
+function getFormat(cmd) {
+  return getGlobalOptions(cmd).format;
+}
+function parseCsvList(value) {
+  return value.split(",").map((item) => item.trim()).filter((item) => item.length > 0);
+}
+function getClientFromCommand(cmd) {
+  const root = getGlobalOptions(cmd);
+  if (!(root.apiUrl && root.apiKey)) {
+    throw new Error('No Standards instance configured. Run "standards login" or pass --api-key.');
+  }
+  return createClient({ apiUrl: root.apiUrl, apiKey: root.apiKey, tenantId: root.tenant });
+}
+function requireTenant(cmd, message) {
+  const { tenant } = getGlobalOptions(cmd);
+  if (!tenant) {
+    throw new Error(message);
+  }
+  return tenant;
+}
+function messageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+// src/commands/ai.ts
+var SCOPES = ["me", "workspace"];
+var ISO_DAY = /^\d{4}-\d{2}-\d{2}$/u;
+function parseDay(flag, value) {
+  if (!ISO_DAY.test(value)) {
+    throw new ValidationError(`${flag} must be a YYYY-MM-DD date`, []);
+  }
+  return value;
+}
+function parseScope(scope) {
+  if (SCOPES.includes(scope)) return scope;
+  throw new ValidationError(`--scope must be one of: ${SCOPES.join(", ")}`, []);
+}
+function registerAiCommand(program) {
+  const ai = program.command("ai").description("Inspect AI usage and credit state");
+  ai.command("usage").description("Aggregate the AI journal over an inclusive UTC day window").requiredOption("--from <day>", "first day of the window (YYYY-MM-DD)").requiredOption("--to <day>", "last day of the window, inclusive (YYYY-MM-DD)").option("--scope <scope>", "me or workspace", "me").action(async (opts, cmd) => {
+    const params = {
+      from: parseDay("--from", opts.from),
+      to: parseDay("--to", opts.to),
+      scope: parseScope(opts.scope ?? "me")
+    };
+    const client = getClientFromCommand(cmd);
+    const result = await client.get("/ai/usage", params);
+    formatOutput(result, getFormat(cmd));
+  });
+  ai.command("wallet").description("Show the tenant's billing mode and AI credit state").action(async (_opts, cmd) => {
+    const client = getClientFromCommand(cmd);
+    const result = await client.get("/ai/wallet");
+    formatOutput(result, getFormat(cmd));
+  });
+}
+
+// src/commands/auth.ts
+import chalk2 from "chalk";
+function registerAuthCommand(program) {
+  const auth = program.command("auth").description("Inspect CLI authentication");
+  auth.command("whoami").description("Show current configuration and validate API key").action(async (_opts, cmd) => {
+    const root = getGlobalOptions(cmd);
+    const client = getClientFromCommand(cmd);
+    const write = (msg) => process.stdout.write(`${msg}
+`);
+    write(chalk2.bold("Standards CLI Configuration"));
+    write(`  API URL:  ${root.apiUrl}`);
+    write(`  API Key:  ${root.apiKey ? `${root.apiKey.slice(0, 8)}...` : chalk2.red("not set")}`);
+    write("");
+    const keys = await client.get("/api-keys");
+    write(chalk2.green("\u2713 API key is valid"));
+    if (Array.isArray(keys) && keys.length > 0) {
+      const activeKeys = keys.filter(
+        (key) => typeof key === "object" && key !== null && !("revokedAt" in key && key.revokedAt)
+      );
+      write(`  Active keys: ${activeKeys.length}`);
+    }
+  });
+}
+
 // src/commands/bundles.ts
 function registerBundlesCommand(program) {
   const bundles = program.command("bundles").description("Manage system bundles assigned to the current tenant (admin)");
@@ -164,7 +197,7 @@ function registerBundlesCommand(program) {
 }
 
 // src/commands/connectors.ts
-import { ValidationError } from "@stndrds/schema";
+import { ValidationError as ValidationError2 } from "@stndrds/schema";
 import chalk3 from "chalk";
 var PROVIDER_IDS = {
   gmail: true,
@@ -195,7 +228,7 @@ function registerConnectorsCommand(program) {
     `connector provider (${PROVIDERS.join(", ")}); run "connectors providers" for the ones this deployment configured`
   ).option("--scope <scope>", "connection scope (tenant or actor)", "tenant").action(async (opts, cmd) => {
     if (!PROVIDERS.includes(opts.provider)) {
-      throw new ValidationError(`--provider must be one of: ${PROVIDERS.join(", ")}`, []);
+      throw new ValidationError2(`--provider must be one of: ${PROVIDERS.join(", ")}`, []);
     }
     const client = getClientFromCommand(cmd);
     const result = await client.post("/connectors/auth/start", {
@@ -1202,19 +1235,19 @@ function registerKeysCommand(program) {
 }
 
 // src/commands/mcp.ts
-import { RESOURCE_VISIBILITIES, ValidationError as ValidationError2 } from "@stndrds/schema";
+import { RESOURCE_VISIBILITIES, ValidationError as ValidationError3 } from "@stndrds/schema";
 import chalk6 from "chalk";
 var AUTH_TYPES = ["none", "header"];
 function buildAuth(opts) {
   const type = opts.authType ?? "none";
   if (!AUTH_TYPES.includes(type)) {
-    throw new ValidationError2(`--auth-type must be one of: ${AUTH_TYPES.join(", ")}`, []);
+    throw new ValidationError3(`--auth-type must be one of: ${AUTH_TYPES.join(", ")}`, []);
   }
   if (type === "none") {
     return { type: "none" };
   }
   if (!(opts.headerName && opts.secret)) {
-    throw new ValidationError2('--auth-type "header" requires both --header-name and --secret.', []);
+    throw new ValidationError3('--auth-type "header" requires both --header-name and --secret.', []);
   }
   return { type: "header", headerName: opts.headerName, secret: opts.secret };
 }
@@ -1223,7 +1256,7 @@ function resolveVisibility(visibility) {
     return "workspace";
   }
   if (!RESOURCE_VISIBILITIES.includes(visibility)) {
-    throw new ValidationError2(
+    throw new ValidationError3(
       `--visibility must be one of: ${RESOURCE_VISIBILITIES.join(", ")}`,
       []
     );
@@ -1272,7 +1305,7 @@ function registerMcpCommand(program) {
   });
   mcp.command("disconnect").description("Disconnect (delete) an MCP server").argument("<id>", "MCP server ID").option("--yes", "disconnect without confirmation").action(async (id, opts, cmd) => {
     if (!opts.yes) {
-      throw new ValidationError2(
+      throw new ValidationError3(
         'Disconnecting an MCP server is explicit. Re-run with "--yes" to confirm.',
         []
       );
@@ -1289,17 +1322,17 @@ import { createHmac } from "crypto";
 import {
   FAKE_MEETING_BOT_SIGNATURE_HEADER,
   RECORDING_OVERRIDES,
-  ValidationError as ValidationError3
+  ValidationError as ValidationError4
 } from "@stndrds/schema";
 var ORDERS = ["asc", "desc"];
 function parseOrder(order) {
   if (ORDERS.includes(order)) return order;
-  throw new ValidationError3(`--order must be one of: ${ORDERS.join(", ")}`, []);
+  throw new ValidationError4(`--order must be one of: ${ORDERS.join(", ")}`, []);
 }
 function parseCount(flag, value) {
   const parsed = Number(value);
   if (!Number.isInteger(parsed) || parsed < 0) {
-    throw new ValidationError3(`${flag} must be a non-negative integer`, []);
+    throw new ValidationError4(`${flag} must be a non-negative integer`, []);
   }
   return parsed;
 }
@@ -1321,7 +1354,7 @@ function parseOverride(opts) {
   );
   if (opts.auto) chosen.push(null);
   if (chosen.length !== 1) {
-    throw new ValidationError3("record needs exactly one of --force, --skip or --auto", []);
+    throw new ValidationError4("record needs exactly one of --force, --skip or --auto", []);
   }
   return chosen[0] ?? null;
 }
@@ -1406,15 +1439,15 @@ function registerMeetingsCommand(program) {
   ).action(async (id, opts, cmd) => {
     const secret = process.env.MEETING_BOT_FAKE_SECRET;
     if (!secret) {
-      throw new ValidationError3("MEETING_BOT_FAKE_SECRET is not set in this shell", []);
+      throw new ValidationError4("MEETING_BOT_FAKE_SECRET is not set in this shell", []);
     }
     const lines = parseCount("--lines", opts.lines);
-    if (lines < 1) throw new ValidationError3("--lines must be at least 1", []);
+    if (lines < 1) throw new ValidationError4("--lines must be at least 1", []);
     const client = getClientFromCommand(cmd);
     const meeting = await client.get(`/meetings/${id}`);
     const { status, botId } = meeting.recording;
     if (status !== "scheduled" && status !== "recording" || botId === null) {
-      throw new ValidationError3(`Meeting ${id} has no bot to complete (status: ${status})`, []);
+      throw new ValidationError4(`Meeting ${id} has no bot to complete (status: ${status})`, []);
     }
     const segments = buildSimulatedSegments(simulatedSpeakers(meeting), lines);
     const startedAt = meeting.startsAt ?? (/* @__PURE__ */ new Date()).toISOString();
@@ -1443,7 +1476,7 @@ function registerMeetingsCommand(program) {
       }
     );
     if (!response.ok) {
-      throw new ValidationError3(`webhook answered ${response.status}`, []);
+      throw new ValidationError4(`webhook answered ${response.status}`, []);
     }
     formatOutput({ botId, segments: segments.length }, getFormat(cmd));
   });
@@ -1595,6 +1628,16 @@ function registerPullCommand(program) {
   });
 }
 
+// src/commands/quotas.ts
+function registerQuotasCommand(program) {
+  const quotas = program.command("quotas").description("Inspect the tenant's remaining capacity");
+  quotas.command("list").description("List one state per quota key (limit is null when nothing is enforced)").action(async (_opts, cmd) => {
+    const client = getClientFromCommand(cmd);
+    const result = await client.get("/quotas");
+    formatOutput(result, getFormat(cmd));
+  });
+}
+
 // src/commands/records.ts
 import { readFile as readFile3 } from "fs/promises";
 import { basename } from "path";
@@ -1819,6 +1862,8 @@ function createProgram() {
   registerMeetingsCommand(program);
   registerSearchCommand(program);
   registerEmbeddingsCommand(program);
+  registerAiCommand(program);
+  registerQuotasCommand(program);
   program.hook("preAction", async (_thisCommand, actionCommand) => {
     const raw = program.opts();
     const resolved = await resolveCliConfig({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stndrds/cli",
-  "version": "1.0.0-alpha.295",
+  "version": "1.0.0-alpha.296",
   "description": "CLI tool to interact with Standards API",
   "type": "module",
   "bin": {
@@ -15,8 +15,8 @@
     "chalk": "^5.4.1",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
-    "@stndrds/client": "1.0.0-alpha.295",
-    "@stndrds/schema": "1.0.0-alpha.295"
+    "@stndrds/client": "1.0.0-alpha.296",
+    "@stndrds/schema": "1.0.0-alpha.296"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",