@inerrata-corporation/errata 2.0.0-dev.51 → 2.0.0-dev.52

package/errata.mjs

@@ -20934,6 +20934,11 @@ var init_client = __esm({
       async me() {
         return this.json("GET", "/v2/me");
       }
+      /** Current plan/quota/cost status through the gateway. The gateway flushes
+       *  this replica's ≤2s usage batch before reading the canonical Hono ledger. */
+      async usage() {
+        return this.json("GET", "/v2/usage");
+      }
       // ─── acting-agent switching (gateway control plane, #898) ───────────
       /** Agents the authenticated user may act as, plus their default agent.
        *  Authenticated with the caller's console-signed gateway JWT. */
@@ -42754,7 +42759,7 @@ function startLoopLagMonitor(thresholdMs = 1e3) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.0-dev.51" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.0-dev.52" : "2.0.0-alpha.0";
 var IGNORED_PATH = /[\\/](?:\.git|node_modules|\.errata|\.claude|\.codex|\.cursor|\.turbo|\.next|dist|coverage|test-results|playwright-report|__pycache__)(?:[\\/]|$)/;
 var IGNORED_NOISE = /castalia\.db|eventlog\.sqlite|turn-cursors/;
 var GIT_OP_MUTE_MS = 4e3;
@@ -45967,6 +45972,8 @@ async function main() {
       return cmdStop();
     case "status":
       return cmdStatus();
+    case "usage":
+      return cmdUsage();
     case "login":
       return cmdLogin();
     case "logout":
@@ -46053,6 +46060,8 @@ Commands:
   start               Run the daemon (FS watchers + hook receiver + tick loop)
   stop                Stop a running daemon (reads .errata/daemon.lock for the pid)
   status              Print workspace + cloud status (incl. version + pending update)
+  usage               Show current cloud plan, units remaining, estimated cost,
+                      and per-tool usage (reads the gateway's batched Hono ledger)
   update [--channel dev|latest] [--check]
                       Pull the newest build on this machine's channel via npm.
                       --check only reports; --channel switches + persists channel.
@@ -46458,6 +46467,37 @@ function applyCloudUrl(cfg, url2) {
 function cloudPolicyMessage(cfg, inspection) {
   return formatCloudEndpointBlock(cfg.cloudUrl, evaluateCloudEndpoint(cfg.cloudUrl, inspection));
 }
+async function cmdUsage() {
+  const cfg = loadConfig();
+  if (!hasCloudCredential(cfg)) {
+    console.error("not logged in \u2014 run `errata login` first");
+    process.exitCode = 1;
+    return;
+  }
+  try {
+    const status = await authedCloudClient(cfg).usage();
+    const quota = status.quota.unlimited ? `${status.quota.units_used.toLocaleString()} used \xB7 unlimited` : `${status.quota.units_used.toLocaleString()} / ${status.quota.effective_unit_limit?.toLocaleString()} used \xB7 ${status.quota.units_remaining?.toLocaleString()} remaining`;
+    console.log(`inErrata usage \u2014 ${status.plan}`);
+    console.log(`  period: ${status.period_start.slice(0, 10)} \u2192 ${status.period_end.slice(0, 10)}`);
+    console.log(`  units:  ${quota}`);
+    console.log(`  calls:  ${status.totals.event_count.toLocaleString()}`);
+    if (status.quota.units_reserved > 0) {
+      console.log(`  held:   ${status.quota.units_reserved.toLocaleString()} units reserved by in-flight calls`);
+    }
+    console.log(`  cost:   $${(status.quota.estimated_cents_current / 100).toFixed(2)} estimated`);
+    console.log(`  rate:   $${(status.pricing.cents_per_1000_units / 100).toFixed(2)} / 1,000 units${status.pricing.estimate_only ? " (estimate, not an invoice)" : ""}`);
+    if (status.by_tool.length > 0) {
+      console.log("  tools:");
+      for (const row of [...status.by_tool].sort((a, b) => b.units - a.units).slice(0, 10)) {
+        console.log(`    ${row.tool.padEnd(24)} ${row.units.toLocaleString().padStart(8)} units  ${row.event_count.toLocaleString().padStart(6)} calls`);
+      }
+    }
+    console.log(`  as of:  ${status.as_of} (ledger + live reservations; poll again after ${Math.ceil(status.poll_after_ms / 1e3)}s)`);
+  } catch (err2) {
+    console.error(`usage unavailable: ${err2 instanceof Error ? err2.message : err2}`);
+    process.exitCode = 1;
+  }
+}
 async function applyToken(cfg, token) {
   const inspection = await inspectCloudEndpoint(cfg.cloudUrl);
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inerrata-corporation/errata",
-  "version": "2.0.0-dev.51",
+  "version": "2.0.0-dev.52",
   "description": "errata - local-first observation engine for AI coding agents",
   "type": "module",
   "bin": {