maxpool 1.13.0 → 1.13.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maxpool",
-  "version": "1.13.0",
+  "version": "1.13.2",
   "description": "Multi-account Claude Code proxy with adaptive, rate-aware load balancing across Claude accounts",
   "type": "module",
   "main": "src/index.js",

package/src/account-manager.js

@@ -1,5 +1,5 @@
 import { refreshAccessToken, isTokenExpiringSoon, modelFamily, tokenFingerprint } from './oauth.js';
-import { CapacityLedger } from './capacity-ledger.js';
+import { CapacityLedger, TANK_MIN_UTIL } from './capacity-ledger.js';
 
 // Nominal window length per kind — mirrors capacity-ledger's WINDOW_MS (kept here as a
 // local table so account-manager does not import a private constant).
@@ -3299,6 +3299,10 @@ export class AccountManager {
     if (measured) return { ...measured, source: 'cycles' };
     const est = this.capacityEstimate(accountIndex, window);
     if (!est) return null;
+    // Same rounding-noise guard as tankStats: a 1%-full window divides by vendor
+    // whole-percent rounding and can read absurd (measured live: 455k ÷ 1% = "≥45M").
+    // Below the floor the reading is noise — withhold rather than print a fiction.
+    if (est.utilization < TANK_MIN_UTIL) return null;
     return {
       avg: est.tokens, last: est.tokens, n: 0, exact: est.lowerBound ? 0 : 1,
       bounded: est.lowerBound ? 1 : 0, lowerBound: Boolean(est.lowerBound),

package/src/capacity-ledger.js

@@ -35,6 +35,14 @@ const SAME_BOUNDARY_MS = 5_000;
 // The minimum span of a COMPLETE cycle per window (80% of nominal): a real one is
 // flagged partial by the writer, so a complete cycle below this is corrupt history.
 const READ_FLOOR_MS = { ses: 4 * 3600_000, wk: 5 * 86400_000 };
+
+// TANK floor. tank = tokens ÷ utilization, and vendors report WHOLE percents — so at
+// 1% full, one percentage point of rounding swings the answer by 100% (measured live
+// 2026-08-25: a 1%-full window read "≥45M"). Below this the reading is rounding noise,
+// not a measurement. Exported because BOTH the closed-cycle average and the live
+// in-window estimate must apply the same floor; one guarding without the other is how
+// the absurd number reached the screen in the first place.
+export const TANK_MIN_UTIL = 0.05;
 const MAX_CYCLES_PER_WINDOW = 50;
 const MAX_DAY_BUCKETS = 10;
 
@@ -401,17 +409,31 @@ export class CapacityLedger {
   tankStats(name, window) {
     const rec = this._accounts.get(name);
     const floor = (this._readFloorOverride ?? READ_FLOOR_MS)[window] ?? 0;
-    const usable = (rec?.[window]?.closed || []).filter(c =>
-      c.complete && !c.disabledDuring
-      && Number.isFinite(c.finalUtilization)
-      && c.finalUtilization >= 0.05
-      && (c.endedAt - c.startedAt) >= floor - 1_000);
+    const closed = (rec?.[window]?.closed || []).filter(c =>
+      c.complete && !c.disabledDuring && (c.endedAt - c.startedAt) >= floor - 1_000);
+    // PHYSICAL FLOOR: a tank can never be smaller than the most tokens ever
+    // delivered in one complete window — every token we count is a vendor token
+    // (C ≤ V ≤ tank), so maxDelivered ≤ tank is an invariant, not a heuristic.
+    // A reading implying a smaller tank is contaminated: the vendor % counted
+    // spend maxpool never saw (usage outside the proxy — an account also used
+    // directly), or the reading was stale. Measured live 2026-08-26: a window
+    // that delivered 497k at a reported "95% full" implied a 523k tank while an
+    // earlier window of the SAME account had delivered 1.53M — impossible, and
+    // the understated reading silently dragged the average down 3.6x.
+    // CLAMP, never discard: the contaminated reading is still a real lower bound
+    // (the tank is at least the tokens we saw), so it joins the average AT the
+    // floor rather than being thrown away — discarding left an account whose
+    // every reading was contaminated with NOTHING to show. After a plan
+    // downgrade the floor over-states until old cycles age out — conservative.
+    const maxDelivered = closed.reduce((m, c) => Math.max(m, c.tokens), 0);
+    const usable = closed.filter(c =>
+      Number.isFinite(c.finalUtilization) && c.finalUtilization >= TANK_MIN_UTIL);
     if (!usable.length) return null;
     let sum = 0, exact = 0, bounded = 0;
     for (const c of usable) {
       const observedFromStart = c.startedAt != null && c.windowStartedAt != null
         && c.startedAt <= c.windowStartedAt + 60_000;
-      sum += c.tokens / c.finalUtilization;
+      sum += Math.max(c.tokens / c.finalUtilization, maxDelivered);
       if (observedFromStart) exact++; else bounded++;
     }
     const last = usable[usable.length - 1];

package/src/tui.js

@@ -2089,13 +2089,14 @@ export class TUI {
         continue;
       }
       const st = ledger.windowStats(a.name, win);
-      let tank = this.am.capacityTank?.(i, win);
+      const tank = this.am.capacityTank?.(i, win);
       const nowOpen = ledger.openCycle(a.name, win);
       const util = this.am._windowUtilization?.(a, win);
-      // A reading we cannot prove is from THIS window must not badge the capacity
-      // number as "live" — it may describe the previous window entirely (the estimate
-      // still renders; the basis line just stops claiming freshness it can't prove).
-      if (tank?.source === 'live' && tank.fresh === false) tank = null;
+      // A reading we cannot prove is from THIS window may describe the previous one —
+      // the basis line says "unproven" instead of "live", but the number still renders:
+      // a restored reading after a restart is real data, and suppressing it would blank
+      // the page at exactly the moment the user opens it.
+      const unproven = tank?.source === 'live' && tank.fresh === false;
 
       // A row with NEITHER a tank nor any delivery has genuinely nothing to say. Say
       // WHY in the account's own terms — "no completed cycle yet" was true and useless
@@ -2131,7 +2132,7 @@ export class TUI {
       const basis = !tank ? dim('no capacity reading yet')
         : tank.source === 'cycles'
           ? dim(`${tank.n} full ${tank.n === 1 ? 'window' : 'windows'}`)
-          : dim(`live · ${((tank.utilization ?? 0) * 100).toFixed(0)}% used`);
+          : dim(`${unproven ? 'from an older reading' : 'live'} · ${((tank.utilization ?? 0) * 100).toFixed(0)}% used`);
       const pct = util != null && tank?.source !== 'live' ? dim(` (${(util * 100).toFixed(0)}% full now)`) : '';
       out.push('  ' + name + ' ' + prov + ' ' + cyan(cells) + '  ' + basis + pct);
     }