npm - pi-antigravity-rotator - Versions diffs - 1.4.0 → 1.4.5 - Mend

pi-antigravity-rotator 1.4.0 → 1.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -2,6 +2,20 @@
 ## [Unreleased]
+## [1.4.5] - 2026-04-28
+### Added
+- **Extended Token Views**: Added `2h`, `4h`, `8h`, and `12h` options to the Token Usage chart. The backend now retains up to 12 hours of minute-level resolution for accurate high-fidelity zooming.
+### Changed
+- **Activity Heatmap Scaling**: Expanded the heatmap to cover the last 60 days. The grid is now responsive, taking up the full width of the screen without distorting cell proportions, and the Y-axis now orders hours naturally from 00 to 23.
+- **Timezone Alignment**: X-axis labels on the Token Usage chart and the Heatmap now correctly reflect the browser's local time instead of UTC.
+## [1.4.1] - 2026-04-28
+### Added
+- **Export Data**: Added `CSV` and `JSON` export buttons to the Token Usage panel on the dashboard to easily download token metrics for external reporting.
 ## [1.4.0] - 2026-04-28
 ### Added

package/README.md CHANGED Viewed

@@ -94,15 +94,14 @@ After starting the proxy, open `http://localhost:51200/dashboard` or `http://<yo
 The dashboard shows:
-- **Model Routing table** -- Which account each model (Gemini Pro, Flash, Claude) is currently routed to
-- **Account cards** sorted by total quota (highest first), flagged/disabled last:
-  - Status badge: `active`, `ready`, `cooldown`, `flagged`, `disabled`, or `error`
-  - Model badges: which models this account is currently serving
-  - Per-model quota bars with timer type (`idle`/`7d`/`5h`) and reset countdown
-  - Request counts, last used time, token status
-  - Fresh-window policy status plus a per-account override button
-  - Error messages for flagged/errored accounts
-  - Re-enable button for disabled accounts
+- **Top Status & Controls** -- Real-time routing state, uptime, requests, and PII masking toggle.
+- **Token Usage & Savings** -- Interactive chart (`1h`, `2h`, `4h`, `8h`, `12h`, `1d`, `7d`, `1m`) showing token consumption by model, with estimated USD savings and `CSV`/`JSON` export options.
+- **Activity Heatmap** -- 60-day responsive GitHub-style contribution grid showing request intensity hour by hour.
+- **Latency (p50/p95)** -- Real-time median and 95th percentile tracking for Time-to-First-Byte (TTFB) and Total Duration per model.
+- **Quota Forecast** -- Predictive modeling showing when each model's quota will run out based on the current requests/hour burn rate.
+- **Searchable Request Log** -- Live feed of the last 200 requests with exact timestamps, models, masked accounts, status codes, and latency.
+- **Account Cards** -- Sorted by total quota. Shows status (`active`, `ready`, `cooldown`, `flagged`, `disabled`), served models, quota bars with timers, and precise error messages.
+- **Operator Panels** -- "Attention Needed" summaries for quarantined accounts and a real-time event feed of rotator actions.
 ![Dashboard](dashboard.png)

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "pi-antigravity-rotator",
-  "version": "1.4.0",
+  "version": "1.4.5",
   "description": "Multi-account rotation proxy for Google Antigravity with per-model routing, real-time quota tracking, and infringement detection",
   "license": "MIT",
   "type": "module",

package/src/dashboard.ts CHANGED Viewed

@@ -835,11 +835,18 @@ const DASHBOARD_HTML = `<!DOCTYPE html>
 <div class="routing-panel state-stopped" id="routingHealth"></div>
 <div class="routing-panel" id="tokenUsagePanel" style="margin-top:12px">
-  <div style="display:flex;justify-content:space-between;align-items:center;margin-bottom:12px">
-    <strong>Token Usage</strong>
-    <div style="display:flex;gap:6px;align-items:center">
+  <div style="display:flex;justify-content:space-between;align-items:center;margin-bottom:12px;flex-wrap:wrap;gap:8px">
+    <strong style="min-width:max-content">Token Usage</strong>
+    <div style="display:flex;gap:6px;align-items:center;flex-wrap:wrap">
       <div id="tokenTotals" style="font-family:JetBrains Mono,monospace;font-size:0.85rem;color:var(--text-dim);margin-right:12px"></div>
+      <button class="btn-secondary btn-sm" onclick="exportData('csv')" title="Export CSV" style="padding:2px 6px">CSV</button>
+      <button class="btn-secondary btn-sm" onclick="exportData('json')" title="Export JSON" style="padding:2px 6px;margin-right:8px">JSON</button>
+      <div style="width:1px;height:16px;background:var(--border);margin-right:8px"></div>
       <button class="btn-secondary btn-sm" onclick="setTokenView('1h')" id="tbtn-1h">1h</button>
+      <button class="btn-secondary btn-sm" onclick="setTokenView('2h')" id="tbtn-2h">2h</button>
+      <button class="btn-secondary btn-sm" onclick="setTokenView('4h')" id="tbtn-4h">4h</button>
+      <button class="btn-secondary btn-sm" onclick="setTokenView('8h')" id="tbtn-8h">8h</button>
+      <button class="btn-secondary btn-sm" onclick="setTokenView('12h')" id="tbtn-12h">12h</button>
       <button class="btn-secondary btn-sm" onclick="setTokenView('1d')" id="tbtn-1d">1d</button>
       <button class="btn-secondary btn-sm" onclick="setTokenView('7d')" id="tbtn-7d">7d</button>
       <button class="btn-secondary btn-sm" onclick="setTokenView('1m')" id="tbtn-1m">1m</button>
@@ -863,7 +870,7 @@ const DASHBOARD_HTML = `<!DOCTYPE html>
 <div class="routing-panel" id="heatmapPanel" style="margin-top:12px;display:none">
   <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:8px">
-    <strong>Activity Heatmap (last 7d)</strong>
+    <strong>Activity Heatmap (last 60d)</strong>
     <span style="color:var(--text-dim);font-size:0.75rem">rows: hour · cols: day</span>
   </div>
   <div id="heatmapGrid"></div>
@@ -1200,15 +1207,54 @@ function formatTokenCount(n) {
 window.__tokenView = '1h';
+function exportData(format) {
+  if (!window.__lastData || !window.__lastData.tokenUsage) return;
+  var usage = window.__lastData.tokenUsage;
+  if (format === 'json') {
+    var dataStr = "data:text/json;charset=utf-8," + encodeURIComponent(JSON.stringify(usage, null, 2));
+    var a = document.createElement('a');
+    a.href = dataStr;
+    a.download = "rotator-token-usage.json";
+    a.click();
+  } else if (format === 'csv') {
+    var csv = "Tier,Period,Model,InputTokens,OutputTokens,Requests\\n";
+    ['months', 'days', 'hours', 'minutes'].forEach(function(tier) {
+      (usage[tier] || []).forEach(function(b) {
+        if (!b.byModel) return;
+        Object.keys(b.byModel).forEach(function(m) {
+          var d = b.byModel[m];
+          csv += tier + "," + b.period + "," + m + "," + d.inputTokens + "," + d.outputTokens + "," + d.requests + "\\n";
+        });
+      });
+    });
+    var dataStrCSV = "data:text/csv;charset=utf-8," + encodeURIComponent(csv);
+    var a2 = document.createElement('a');
+    a2.href = dataStrCSV;
+    a2.download = "rotator-token-usage.csv";
+    a2.click();
+  }
+}
 function setTokenView(view) {
   window.__tokenView = view;
   refresh();
 }
 function formatBucketLabel(period, view) {
-  if (view === '1h') return ':' + period.slice(14); // ":05"
-  if (view === '1d') return period.slice(11, 13) + 'h'; // "12h"
-  if (view === '7d' || view === '1m') return period.slice(5, 10); // "04-28"
+  try {
+    if (view.endsWith('h') && view !== '1d') {
+      var d;
+      if (period.length === 16) d = new Date(period + ':00Z');
+      else d = new Date(period);
+      if (!isNaN(d.getTime())) {
+        if (view === '1h') return ':' + String(d.getMinutes()).padStart(2, '0');
+        return String(d.getHours()).padStart(2, '0') + ':' + String(d.getMinutes()).padStart(2, '0');
+      }
+    }
+    if (view === '1d') return period.slice(11, 13) + 'h';
+    if (view === '7d' || view === '1m') return period.slice(5, 10);
+  } catch(e) {}
   return period;
 }
@@ -1220,7 +1266,7 @@ function renderTokenChart(tokenUsage) {
   var view = window.__tokenView || '1h';
   // Highlight active button
-  ['1h', '1d', '7d', '1m'].forEach(function(v) {
+  ['1h', '2h', '4h', '8h', '12h', '1d', '7d', '1m'].forEach(function(v) {
     var btn = document.getElementById('tbtn-' + v);
     if (btn) btn.className = 'btn-secondary btn-sm' + (v === view ? ' active' : '');
   });
@@ -1230,11 +1276,12 @@ function renderTokenChart(tokenUsage) {
     return;
   }
-  // Helper: merge buckets into a map by truncated period key
-  function mergeBucketsBy(sources, sliceLen, limit) {
+  // Helper: merge buckets into a map by a grouping key
+  function mergeBucketsBy(sources, keyFn, limit) {
     var map = {};
     sources.forEach(function(b) {
-      var key = b.period.slice(0, sliceLen);
+      var key = keyFn(b.period);
+      if (!key) return;
       if (!map[key]) map[key] = { period: key, inputTokens: 0, outputTokens: 0, requests: 0, byModel: {} };
       map[key].inputTokens += b.inputTokens;
       map[key].outputTokens += b.outputTokens;
@@ -1249,19 +1296,50 @@ function renderTokenChart(tokenUsage) {
     return Object.keys(map).sort().map(function(k) { return map[k]; }).slice(-limit);
   }
+  function getLocalKey(periodStr, type) {
+    try {
+      var d;
+      if (periodStr.length === 10) d = new Date(periodStr + 'T00:00:00Z');
+      else if (periodStr.length === 13) d = new Date(periodStr + ':00:00Z');
+      else if (periodStr.length === 16) d = new Date(periodStr + ':00Z');
+      else d = new Date(periodStr);
+      if (isNaN(d.getTime())) return periodStr;
+      var y = d.getFullYear();
+      var mo = String(d.getMonth() + 1).padStart(2, '0');
+      var da = String(d.getDate()).padStart(2, '0');
+      var h = String(d.getHours()).padStart(2, '0');
+      var mi = d.getMinutes();
+      if (type === 'day') return y + '-' + mo + '-' + da;
+      if (type === 'hour') return y + '-' + mo + '-' + da + 'T' + h;
+      if (type === '5min') return y + '-' + mo + '-' + da + 'T' + h + ':' + String(Math.floor(mi/5)*5).padStart(2, '0');
+      if (type === '4min') return y + '-' + mo + '-' + da + 'T' + h + ':' + String(Math.floor(mi/4)*4).padStart(2, '0');
+      if (type === '2min') return y + '-' + mo + '-' + da + 'T' + h + ':' + String(Math.floor(mi/2)*2).padStart(2, '0');
+    } catch(e) {}
+    return periodStr;
+  }
   var allTiers = (tokenUsage.months || []).concat(tokenUsage.days || []).concat(tokenUsage.hours || []).concat(tokenUsage.minutes || []);
   // Pick tier based on view
   var buckets;
   if (view === '1h') {
     buckets = (tokenUsage.minutes || []).slice(-60);
+  } else if (view === '2h') {
+    buckets = (tokenUsage.minutes || []).slice(-120);
+  } else if (view === '4h') {
+    buckets = mergeBucketsBy((tokenUsage.minutes || []), function(p) { return getLocalKey(p, '2min'); }, 120);
+  } else if (view === '8h') {
+    buckets = mergeBucketsBy((tokenUsage.minutes || []), function(p) { return getLocalKey(p, '4min'); }, 120);
+  } else if (view === '12h') {
+    buckets = mergeBucketsBy((tokenUsage.minutes || []), function(p) { return getLocalKey(p, '5min'); }, 144);
   } else if (view === '1d') {
-    // Merge hours + minutes into hourly buckets, last 24h
-    buckets = mergeBucketsBy((tokenUsage.hours || []).concat(tokenUsage.minutes || []), 13, 24);
+    buckets = mergeBucketsBy((tokenUsage.hours || []).concat(tokenUsage.minutes || []), function(p) { return getLocalKey(p, 'hour'); }, 24);
   } else if (view === '7d') {
-    buckets = mergeBucketsBy(allTiers, 10, 7);
+    buckets = mergeBucketsBy(allTiers, function(p) { return getLocalKey(p, 'day'); }, 7);
   } else {
-    buckets = mergeBucketsBy(allTiers, 10, 30);
+    buckets = mergeBucketsBy(allTiers, function(p) { return getLocalKey(p, 'day'); }, 30);
   }
   if (!buckets || buckets.length === 0) {
@@ -1287,14 +1365,17 @@ function renderTokenChart(tokenUsage) {
   });
   if (maxTokens === 0) maxTokens = 1;
-  var barWidth = Math.max(16, Math.min(36, Math.floor(600 / buckets.length) - 4));
-  var gap = 4;
+  var chartWidth = chart.clientWidth || 800;
+  var minSvgWidth = buckets.length * 16 + 40;
+  var svgWidth = Math.max(chartWidth, minSvgWidth);
+  var availableWidth = svgWidth - 50;
+  var step = availableWidth / Math.max(1, buckets.length);
+  var barWidth = Math.min(36, step * 0.8);
   var chartHeight = 140;
-  var svgWidth = buckets.length * (barWidth + gap) + 60;
   var bars = '';
   buckets.forEach(function(b, i) {
-    var x = 40 + i * (barWidth + gap);
+    var x = 40 + i * step + (step - barWidth) / 2;
     // Stack by model
     var yOffset = chartHeight;
@@ -1365,12 +1446,14 @@ function renderHeatmap(tokenUsage) {
   var hours = tokenUsage.hours || [];
   var minutes = tokenUsage.minutes || [];
   var now = new Date();
+  var daysCount = 60;
   var days = [];
-  for (var i = 6; i >= 0; i--) {
+  for (var i = daysCount - 1; i >= 0; i--) {
     var d = new Date(now);
     d.setDate(now.getDate() - i);
-    var key = d.toISOString().slice(0, 10);
-    days.push({ key: key, label: key.slice(5) });
+    var key = d.getFullYear() + '-' + String(d.getMonth() + 1).padStart(2, '0') + '-' + String(d.getDate()).padStart(2, '0');
+    // show label only for every 7th day to avoid crowding
+    days.push({ key: key, label: (i % 7 === 0) ? key.slice(5) : '' });
   }
   var cellMap = {}; // day|hour -> requests
@@ -1380,18 +1463,30 @@ function renderHeatmap(tokenUsage) {
     cellMap[k] += reqs || 0;
   }
+  function parseLocal(periodStr) {
+    var d;
+    if (periodStr.length === 10) d = new Date(periodStr + 'T00:00:00Z');
+    else if (periodStr.length === 13) d = new Date(periodStr + ':00:00Z');
+    else if (periodStr.length === 16) d = new Date(periodStr + ':00Z');
+    else d = new Date(periodStr);
+    if (isNaN(d.getTime())) return null;
+    return {
+      dayKey: d.getFullYear() + '-' + String(d.getMonth() + 1).padStart(2, '0') + '-' + String(d.getDate()).padStart(2, '0'),
+      hour: d.getHours()
+    };
+  }
   hours.forEach(function(b) {
-    if (!b.period || b.period.length < 13) return;
-    var dayKey = b.period.slice(0, 10);
-    var hour = Number(b.period.slice(11, 13));
-    addBucket(dayKey, hour, b.requests);
+    if (!b.period) return;
+    var loc = parseLocal(b.period);
+    if (loc) addBucket(loc.dayKey, loc.hour, b.requests);
   });
   minutes.forEach(function(b) {
-    if (!b.period || b.period.length < 16) return;
-    var dayKey = b.period.slice(0, 10);
-    var hour = Number(b.period.slice(11, 13));
-    addBucket(dayKey, hour, b.requests);
+    if (!b.period) return;
+    var loc = parseLocal(b.period);
+    if (loc) addBucket(loc.dayKey, loc.hour, b.requests);
   });
   var max = 0;
@@ -1412,17 +1507,17 @@ function renderHeatmap(tokenUsage) {
     return 'rgba(56,189,248,0.92)';
   }
-  var html = '<div style="overflow-x:auto"><table style="border-collapse:separate;border-spacing:3px;font-family:JetBrains Mono,monospace;font-size:0.7rem">';
-  html += '<tr><th style="color:var(--text-dim);padding-right:6px">h</th>';
-  days.forEach(function(d) { html += '<th style="color:var(--text-dim);font-weight:500">' + d.label + '</th>'; });
+  var html = '<div style="overflow-x:auto"><table style="width:100%;min-width:800px;border-collapse:separate;border-spacing:2px;table-layout:fixed;font-family:JetBrains Mono,monospace;font-size:0.6rem">';
+  html += '<tr><th style="color:var(--text-dim);padding-right:6px;width:20px">h</th>';
+  days.forEach(function(d) { html += '<th style="color:var(--text-dim);font-weight:500;text-align:left;white-space:nowrap;overflow:visible">' + d.label + '</th>'; });
   html += '</tr>';
-  for (var hour = 23; hour >= 0; hour--) {
-    html += '<tr><td style="color:var(--text-dim);padding-right:6px">' + String(hour).padStart(2, '0') + '</td>';
+  for (var hour = 0; hour < 24; hour++) {
+    html += '<tr><td style="color:var(--text-dim);padding-right:6px;text-align:right">' + String(hour).padStart(2, '0') + '</td>';
     for (var j = 0; j < days.length; j++) {
       var day = days[j].key;
       var val = cellMap[day + '|' + hour] || 0;
-      html += '<td title="' + day + ' ' + String(hour).padStart(2, '0') + ':00 · ' + val + ' req" style="width:13px;height:13px;border-radius:3px;background:' + colorFor(val) + ';border:1px solid rgba(255,255,255,0.08)"></td>';
+      html += '<td title="' + day + ' ' + String(hour).padStart(2, '0') + ':00 · ' + val + ' req" style="height:14px;border-radius:2px;background:' + colorFor(val) + ';border:1px solid rgba(255,255,255,0.05)"></td>';
     }
     html += '</tr>';
   }
@@ -1637,6 +1732,22 @@ function renderRequestLog(log) {
   });
 })();
+function maskEventMessage(msg) {
+  if (!MASK_MODE) return escapeHtml(msg);
+  var out = msg;
+  if (window.__lastData && window.__lastData.accounts) {
+    window.__lastData.accounts.forEach(function(a) {
+      if (a.label && out.indexOf(a.label) !== -1) {
+        out = out.split(a.label).join('***');
+      }
+      if (a.email && out.indexOf(a.email) !== -1) {
+        out = out.split(a.email).join('***');
+      }
+    });
+  }
+  return escapeHtml(out);
+}
 function renderRecentEvents(events) {
   var panel = document.getElementById('recentEventsPanel');
   var allEvents = events || [];
@@ -1658,7 +1769,7 @@ function renderRecentEvents(events) {
     return '<div class="event-item level-' + (event.level || 'info') + '">' +
       '<div class="event-time">' + formatTime(event.timestamp) + '</div>' +
       '<div class="event-source ' + event.source + '">' + escapeHtml(event.source) + '</div>' +
-      '<div class="event-message">' + escapeHtml(event.message) + '</div>' +
+      '<div class="event-message">' + maskEventMessage(event.message) + '</div>' +
     '</div>';
   }).join('');

package/src/rotator.ts CHANGED Viewed

@@ -719,8 +719,8 @@ export class AccountRotator {
 	private consolidateTokenBuckets(now: Date): void {
 		const nowMs = now.getTime();
-		const KEEP_MINUTES_MS = 120 * 60 * 1000;  // keep 2h of minutes
-		const KEEP_HOURS_MS = 48 * 3600 * 1000;   // keep 48h of hours
+		const KEEP_MINUTES_MS = 12 * 3600 * 1000; // keep 12h of minutes
+		const KEEP_HOURS_MS = 60 * 86400 * 1000;  // keep 60d of hours
 		const KEEP_DAYS_MS = 60 * 86400 * 1000;   // keep 60d of days
 		// Helper: parse period string to epoch ms (approximate, enough for cutoff)