tokentracker-cli 0.18.1 → 0.20.0

package/src/commands/sync.js

@@ -14,7 +14,7 @@ const {
   readOpencodeDbMessages,
   resolveKiroDbPath,
   resolveKiroJsonlPath,
-  resolveHermesDbPath,
+  resolveHermesPath,
   resolveCopilotOtelPaths,
   parseRolloutIncremental,
   parseClaudeIncremental,
@@ -48,7 +48,6 @@ const {
   parseKilocodeIncremental,
   bucketKey,
   totalsKey,
-  groupBucketKey,
   claudeMessageDedupKey,
 } = require("../lib/rollout");
 const { computeClaudeGroundTruthBuckets } = require("../lib/claude-categorizer");
@@ -73,6 +72,7 @@ const { resolveRuntimeConfig } = require("../lib/runtime-config");
 const CURSOR_UNKNOWN_MIGRATION_KEY = "cursorUnknownPurge_2026_04";
 const ROLLOUT_CUMULATIVE_DELTA_MIGRATION_KEY = "rolloutCumulativeDeltaReparse_2026_05";
 const CLAUDE_MEM_OBSERVER_REINCLUDE_KEY = "claudeMemObserverReinclude_2026_05_v3";
+const GROK_APPEND_ONLY_REPAIR_MIGRATION_KEY = "grokAppendOnlyRepair_2026_05_v4";
 const CLAUDE_MEM_OBSERVER_PATH_SEGMENT = "--claude-mem-observer-sessions";
 // v1 had a cursor-format bug (wrote plain integer instead of {inode, offset,
 // updatedAt}), which made parseClaudeIncremental reread every jsonl from
@@ -500,13 +500,13 @@ async function cmdSync(argv) {
 
     // ── Hermes Agent (SQLite-based) ──
     let hermesResult = { recordsProcessed: 0, eventsAggregated: 0, bucketsQueued: 0 };
-    const hermesDbPath = resolveHermesDbPath();
-    if (fssync.existsSync(hermesDbPath)) {
+    const hermesPath = resolveHermesPath();
+    if (fssync.existsSync(hermesPath)) {
       if (progress?.enabled) {
         progress.start(`Parsing Hermes ${renderBar(0)} | buckets 0`);
       }
       hermesResult = await parseHermesIncremental({
-        dbPath: hermesDbPath,
+        hermesPath,
         cursors,
         queuePath,
         onProgress: (p) => {
@@ -681,18 +681,36 @@ async function cmdSync(argv) {
           ? grokHookSignal.sessionId.trim()
           : null;
       if (hookSessionId) {
+        const hookContextTokens =
+          grokHookSignal.contextTokensUsed != null
+            ? grokHookSignal.contextTokensUsed
+            : grokHookSignal.totalTokens;
+        const hookTotalTokens =
+          grokHookSignal.totalTokens != null
+            ? grokHookSignal.totalTokens
+            : hookContextTokens;
         grokSessionInputs.unshift({
           sessionId: hookSessionId,
+          sessionDir:
+            typeof grokHookSignal.sessionDir === "string" ? grokHookSignal.sessionDir : undefined,
+          updatesPath:
+            typeof grokHookSignal.updatesPath === "string" ? grokHookSignal.updatesPath : undefined,
+          signalsPath:
+            typeof grokHookSignal.signalsPath === "string" ? grokHookSignal.signalsPath : undefined,
+          summaryPath:
+            typeof grokHookSignal.summaryPath === "string" ? grokHookSignal.summaryPath : undefined,
           signals: {
-            contextTokensUsed: grokHookSignal.totalTokens,
+            contextTokensUsed: hookContextTokens,
+            totalTokens: hookTotalTokens,
+            totalTokensBeforeCompaction: grokHookSignal.totalTokensBeforeCompaction,
             assistantMessageCount: grokHookSignal.messageCount,
             primaryModelId: grokHookSignal.model,
             lastActiveAt: grokHookSignal.lastActive,
           },
           summary: { updated_at: grokHookSignal.lastActive },
         });
+        grokHookSignalConsumed = true;
       }
-      grokHookSignalConsumed = true;
     }
     if (grokSessionInputs.length > 0) {
       if (progress?.enabled) {
@@ -717,6 +735,9 @@ async function cmdSync(argv) {
         bucketsQueued: grokResult.bucketsQueued + grokScanResult.bucketsQueued,
       };
     }
+    if (opts.repairGrok) {
+      await repairGrokQueueFromSessionSnapshots({ cursors, queuePath, queueStatePath });
+    }
 
     // ── GitHub Copilot CLI (OTEL JSONL files) ──
     let copilotResult = { recordsProcessed: 0, eventsAggregated: 0, bucketsQueued: 0 };
@@ -899,6 +920,7 @@ function parseArgs(argv) {
     fromRetry: false,
     fromOpenclaw: false,
     drain: false,
+    repairGrok: false,
   };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
@@ -907,6 +929,7 @@ function parseArgs(argv) {
     else if (a === "--from-retry") out.fromRetry = true;
     else if (a === "--from-openclaw") out.fromOpenclaw = true;
     else if (a === "--drain") out.drain = true;
+    else if (a === "--repair-grok") out.repairGrok = true;
     else throw new Error(`Unknown option: ${a}`);
   }
   return out;
@@ -917,9 +940,11 @@ module.exports = {
   migrateCursorUnknownBuckets,
   migrateRolloutCumulativeDeltaBuckets,
   reincludeClaudeMemObserverFiles,
+  repairGrokQueueFromSessionSnapshots,
   CURSOR_UNKNOWN_MIGRATION_KEY,
   ROLLOUT_CUMULATIVE_DELTA_MIGRATION_KEY,
   CLAUDE_MEM_OBSERVER_REINCLUDE_KEY,
+  GROK_APPEND_ONLY_REPAIR_MIGRATION_KEY,
 };
 
 function normalizeString(value) {
@@ -1289,6 +1314,344 @@ async function readQueueBatch(queuePath, startOffset, maxBuckets) {
   return { buckets: Array.from(bucketMap.values()), nextOffset: offset };
 }
 
+function normalizeGrokRepairSource(value) {
+  return typeof value === "string" ? value.trim().toLowerCase() : "";
+}
+
+function normalizeGrokRepairModel(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : "grok-build";
+}
+
+function normalizeGrokRepairNumber(value) {
+  const n = Number(value);
+  return Number.isFinite(n) && n > 0 ? n : 0;
+}
+
+function toGrokRepairHalfHourStart(value) {
+  if (value == null) return null;
+  const millis =
+    typeof value === "number"
+      ? value < 10_000_000_000
+        ? value * 1000
+        : value
+      : Date.parse(String(value));
+  if (!Number.isFinite(millis)) return null;
+  const halfHourMs = 30 * 60 * 1000;
+  return new Date(Math.floor(millis / halfHourMs) * halfHourMs).toISOString();
+}
+
+function estimateGrokRepairTotals(totalTokens, conversationCount) {
+  const total = Math.trunc(normalizeGrokRepairNumber(totalTokens));
+  const inputTokens = Math.round(total * 0.8);
+  const outputTokens = Math.max(0, total - inputTokens);
+  return {
+    input_tokens: inputTokens,
+    cached_input_tokens: 0,
+    cache_creation_input_tokens: 0,
+    output_tokens: outputTokens,
+    reasoning_output_tokens: 0,
+    total_tokens: total,
+    billable_total_tokens: total,
+    conversation_count: Math.trunc(normalizeGrokRepairNumber(conversationCount)),
+  };
+}
+
+function addGrokRepairTotals(target, delta) {
+  target.input_tokens += delta.input_tokens;
+  target.cached_input_tokens += delta.cached_input_tokens;
+  target.cache_creation_input_tokens += delta.cache_creation_input_tokens;
+  target.output_tokens += delta.output_tokens;
+  target.reasoning_output_tokens += delta.reasoning_output_tokens;
+  target.total_tokens += delta.total_tokens;
+  target.billable_total_tokens += delta.billable_total_tokens;
+  target.conversation_count += delta.conversation_count;
+}
+
+function buildGrokRepairRowsFromSnapshots(sessionSnapshots) {
+  if (!sessionSnapshots || typeof sessionSnapshots !== "object") return [];
+
+  const buckets = new Map();
+  for (const snapshot of Object.values(sessionSnapshots)) {
+    if (!snapshot || typeof snapshot !== "object") continue;
+    const totalTokens = Math.trunc(normalizeGrokRepairNumber(snapshot.totalTokens));
+    if (totalTokens <= 0) continue;
+
+    const hourStart = toGrokRepairHalfHourStart(
+      snapshot.lastEventTimestamp || snapshot.updatedAt,
+    );
+    if (!hourStart) continue;
+
+    const model = normalizeGrokRepairModel(snapshot.model);
+    const key = bucketKey("grok", model, hourStart);
+    let totals = buckets.get(key);
+    if (!totals) {
+      totals = {
+        source: "grok",
+        model,
+        hour_start: hourStart,
+        input_tokens: 0,
+        cached_input_tokens: 0,
+        cache_creation_input_tokens: 0,
+        output_tokens: 0,
+        reasoning_output_tokens: 0,
+        total_tokens: 0,
+        billable_total_tokens: 0,
+        conversation_count: 0,
+      };
+      buckets.set(key, totals);
+    }
+    addGrokRepairTotals(
+      totals,
+      estimateGrokRepairTotals(totalTokens, snapshot.messageCount),
+    );
+  }
+
+  return Array.from(buckets.values()).sort((a, b) => {
+    const timeCompare = a.hour_start.localeCompare(b.hour_start);
+    return timeCompare || a.model.localeCompare(b.model);
+  });
+}
+
+function applyGrokRepairHourlyState(cursors, rows) {
+  const hourly = cursors.hourly && typeof cursors.hourly === "object" ? cursors.hourly : {};
+  const buckets = hourly.buckets && typeof hourly.buckets === "object" ? hourly.buckets : {};
+  const groupQueued =
+    hourly.groupQueued && typeof hourly.groupQueued === "object" ? hourly.groupQueued : {};
+
+  for (const key of Object.keys(buckets)) {
+    if (key.startsWith("grok|")) {
+      delete buckets[key];
+    }
+  }
+  for (const key of Object.keys(groupQueued)) {
+    if (key.startsWith("grok|")) {
+      delete groupQueued[key];
+    }
+  }
+
+  for (const row of rows) {
+    const totals = {
+      input_tokens: row.input_tokens,
+      cached_input_tokens: row.cached_input_tokens,
+      cache_creation_input_tokens: row.cache_creation_input_tokens,
+      output_tokens: row.output_tokens,
+      reasoning_output_tokens: row.reasoning_output_tokens,
+      total_tokens: row.total_tokens,
+      billable_total_tokens: row.billable_total_tokens,
+      conversation_count: row.conversation_count,
+    };
+    buckets[bucketKey("grok", row.model, row.hour_start)] = {
+      totals,
+      queuedKey: totalsKey(totals),
+      source: "grok",
+      hour_start: row.hour_start,
+    };
+  }
+
+  cursors.hourly = {
+    ...hourly,
+    version: 3,
+    buckets,
+    groupQueued,
+    updatedAt: typeof hourly.updatedAt === "string" ? hourly.updatedAt : null,
+  };
+}
+
+async function resetGrokRepairUploadOffset(queueStatePath) {
+  if (typeof queueStatePath !== "string" || !queueStatePath) return false;
+  let state = {};
+  try {
+    state = JSON.parse(await fs.readFile(queueStatePath, "utf8"));
+  } catch (_e) {
+    state = {};
+  }
+  state.offset = 0;
+  state.updatedAt = new Date().toISOString();
+  state.note = "reset_after_grok_append_only_repair_2026_05_v4";
+  await ensureDir(path.dirname(queueStatePath));
+  await fs.writeFile(queueStatePath, JSON.stringify(state, null, 2) + "\n", "utf8");
+  return true;
+}
+
+function hasAppliedGrokRepairMigration(value) {
+  if (!value) return false;
+  if (value === true) return true;
+  if (value && typeof value === "object") {
+    if (value.status === "applied" || value.status === "noop") return true;
+    if (value.status) return false;
+    return value.rowsWritten != null || value.rowsRemoved != null;
+  }
+  return false;
+}
+
+function serializeGrokRepairRow(row) {
+  return JSON.stringify({
+    source: "grok",
+    model: normalizeGrokRepairModel(row.model),
+    hour_start: row.hour_start,
+    input_tokens: row.input_tokens || 0,
+    cached_input_tokens: row.cached_input_tokens || 0,
+    cache_creation_input_tokens: row.cache_creation_input_tokens || 0,
+    output_tokens: row.output_tokens || 0,
+    reasoning_output_tokens: row.reasoning_output_tokens || 0,
+    total_tokens: row.total_tokens || 0,
+    billable_total_tokens: row.billable_total_tokens || 0,
+    conversation_count: row.conversation_count || 0,
+  });
+}
+
+async function backupExistingFile(filePath) {
+  if (typeof filePath !== "string" || !filePath) return null;
+  try {
+    const stat = await fs.stat(filePath);
+    if (!stat.isFile()) return null;
+  } catch (e) {
+    if (e?.code === "ENOENT" || e?.code === "ENOTDIR") return null;
+    throw e;
+  }
+  const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+  const backupPath = `${filePath}.bak.${stamp}`;
+  await fs.copyFile(filePath, backupPath);
+  return backupPath;
+}
+
+async function repairGrokQueueFromSessionSnapshots({ cursors, queuePath, queueStatePath } = {}) {
+  if (!cursors || typeof cursors !== "object") return false;
+  const grokState = (cursors.grok ||= {});
+  const migrations = (grokState.migrations ||= {});
+  if (hasAppliedGrokRepairMigration(migrations[GROK_APPEND_ONLY_REPAIR_MIGRATION_KEY])) {
+    return false;
+  }
+
+  let raw = "";
+  try {
+    raw = await fs.readFile(queuePath, "utf8");
+  } catch (e) {
+    if (e?.code !== "ENOENT") throw e;
+  }
+
+  const latestGrokRows = new Map();
+  let existingGrokRows = 0;
+  for (const line of raw.split("\n")) {
+    if (!line.trim()) continue;
+    let row;
+    try {
+      row = JSON.parse(line);
+    } catch (_e) {
+      continue;
+    }
+
+    if (normalizeGrokRepairSource(row?.source) === "grok") {
+      const model = normalizeGrokRepairModel(row.model);
+      const hourStart = typeof row.hour_start === "string" ? row.hour_start : null;
+      if (!hourStart) continue;
+      existingGrokRows += 1;
+      latestGrokRows.set(bucketKey("grok", model, hourStart), {
+        ...row,
+        source: "grok",
+        model,
+        hour_start: hourStart,
+      });
+    }
+  }
+
+  if (existingGrokRows === 0) {
+    migrations[GROK_APPEND_ONLY_REPAIR_MIGRATION_KEY] = {
+      status: "noop",
+      appliedAt: new Date().toISOString(),
+      existingGrokRows: 0,
+      rowsWritten: 0,
+      snapshotsUsed: 0,
+      uploadOffsetReset: false,
+    };
+    return false;
+  }
+
+  const repairRows = buildGrokRepairRowsFromSnapshots(grokState.sessionSnapshots);
+  if (repairRows.length === 0) {
+    migrations[GROK_APPEND_ONLY_REPAIR_MIGRATION_KEY] = {
+      status: "skipped",
+      appliedAt: new Date().toISOString(),
+      reason: "missing-session-snapshots",
+      existingGrokRows,
+      rowsWritten: 0,
+      snapshotsUsed: 0,
+      uploadOffsetReset: false,
+    };
+    return false;
+  }
+
+  applyGrokRepairHourlyState(cursors, repairRows);
+
+  const repairLines = [];
+  const repairKeys = new Set();
+  for (const row of repairRows) {
+    const key = bucketKey("grok", row.model, row.hour_start);
+    repairKeys.add(key);
+    const current = latestGrokRows.get(key);
+    if (current && totalsKey(current) === totalsKey(row)) continue;
+    repairLines.push(serializeGrokRepairRow(row));
+  }
+
+  const zeroTotals = {
+    input_tokens: 0,
+    cached_input_tokens: 0,
+    cache_creation_input_tokens: 0,
+    output_tokens: 0,
+    reasoning_output_tokens: 0,
+    total_tokens: 0,
+    billable_total_tokens: 0,
+    conversation_count: 0,
+  };
+  let staleRowsRetracted = 0;
+  for (const [key, row] of latestGrokRows.entries()) {
+    if (repairKeys.has(key)) continue;
+    if (totalsKey(row) === totalsKey(zeroTotals)) continue;
+    staleRowsRetracted += 1;
+    repairLines.push(serializeGrokRepairRow({
+      ...zeroTotals,
+      model: row.model,
+      hour_start: row.hour_start,
+    }));
+  }
+
+  if (repairLines.length === 0) {
+    migrations[GROK_APPEND_ONLY_REPAIR_MIGRATION_KEY] = {
+      status: "noop",
+      appliedAt: new Date().toISOString(),
+      existingGrokRows,
+      rowsWritten: 0,
+      staleRowsRetracted,
+      snapshotsUsed: repairRows.length,
+      uploadOffsetReset: false,
+    };
+    return false;
+  }
+
+  await ensureDir(path.dirname(queuePath));
+  const queueBackupPath = await backupExistingFile(queuePath);
+  const queueStateBackupPath = await backupExistingFile(queueStatePath);
+  await fs.appendFile(queuePath, `${repairLines.join("\n")}\n`, "utf8");
+
+  const uploadOffsetReset = await resetGrokRepairUploadOffset(queueStatePath);
+  migrations[GROK_APPEND_ONLY_REPAIR_MIGRATION_KEY] = {
+    status: "applied",
+    appliedAt: new Date().toISOString(),
+    existingGrokRows,
+    rowsWritten: repairLines.length,
+    staleRowsRetracted,
+    snapshotsUsed: Object.values(grokState.sessionSnapshots || {}).filter((snapshot) => {
+      if (!snapshot || typeof snapshot !== "object") return false;
+      if (Math.trunc(normalizeGrokRepairNumber(snapshot.totalTokens)) <= 0) return false;
+      return Boolean(toGrokRepairHalfHourStart(snapshot.lastEventTimestamp || snapshot.updatedAt));
+    }).length,
+    uploadOffsetReset,
+    queueBackupPath,
+    queueStateBackupPath,
+  };
+  return true;
+}
+
 async function migrateCursorUnknownBuckets({ cursors, queuePath }) {
   if (!cursors || typeof cursors !== "object") return;
   cursors.migrations = cursors.migrations || {};

package/src/lib/grok-hook.js

@@ -94,14 +94,15 @@ function buildGrokSessionEndHandler({ trackerDir }) {
   // It must be self-contained enough or rely on the copied runtime.
   // For simplicity and reliability we write a small script that:
   // 1. Reads GROK_SESSION_ID + GROK_WORKSPACE_ROOT from env
-  // 2. Locates the signals.json
-  // 3. Extracts usage
+  // 2. Locates the session metadata files
+  // 3. Extracts usage metadata only
   // 4. Writes a signal file under trackerDir that sync.js will pick up on next run
 
   return `#!/usr/bin/env node
 const fs = require('node:fs');
 const path = require('node:path');
 const os = require('node:os');
+const readline = require('node:readline');
 
 const GROK_HOME = process.env.TOKENTRACKER_GROK_HOME || process.env.GROK_HOME || path.join(os.homedir(), '.grok');
 const SESSION_ID = process.env.GROK_SESSION_ID;
@@ -120,14 +121,17 @@ const encodedCwd = encodeGrokCwd(WORKSPACE_ROOT);
 const sessionDir = path.join(GROK_HOME, 'sessions', encodedCwd, SESSION_ID);
 const signalsPath = path.join(sessionDir, 'signals.json');
 const summaryPath = path.join(sessionDir, 'summary.json');
+const updatesPath = path.join(sessionDir, 'updates.jsonl');
 
-let signals = null;
+let signals = {};
 try {
   const raw = fs.readFileSync(signalsPath, 'utf8');
   signals = JSON.parse(raw);
 } catch (err) {
-  // Session may still be active or signals not written yet; exit quietly
-  process.exit(0);
+  signals = {};
+}
+if (!signals || typeof signals !== 'object') {
+  signals = {};
 }
 
 const summary = (() => {
@@ -143,10 +147,74 @@ function toNonNegativeFiniteNumber(value) {
   return Number.isFinite(number) && number > 0 ? number : 0;
 }
 
-const totalTokens = toNonNegativeFiniteNumber(signals.contextTokensUsed);
+function timestampToIso(value) {
+  if (value == null) return null;
+  if (typeof value === 'number') {
+    if (!Number.isFinite(value) || value <= 0) return null;
+    const millis = value < 10000000000 ? value * 1000 : value;
+    const dt = new Date(millis);
+    return Number.isFinite(dt.getTime()) ? dt.toISOString() : null;
+  }
+  if (typeof value === 'string') {
+    const trimmed = value.trim();
+    if (!trimmed) return null;
+    if (/^[0-9]+(?:\\.[0-9]+)?$/.test(trimmed)) return timestampToIso(Number(trimmed));
+    const dt = new Date(trimmed);
+    return Number.isFinite(dt.getTime()) ? dt.toISOString() : null;
+  }
+  return null;
+}
+
+async function readUpdateTelemetry(filePath) {
+  let totalTokens = 0;
+  let lastEventId = null;
+  let lastEventTimestamp = null;
+  let lineNumber = 0;
+
+  try {
+    const input = fs.createReadStream(filePath, { encoding: 'utf8' });
+    const rl = readline.createInterface({ input, crlfDelay: Infinity });
+    try {
+      for await (const line of rl) {
+        lineNumber += 1;
+        if (!line || !line.trim()) continue;
+        let record = null;
+        try {
+          record = JSON.parse(line);
+        } catch {
+          continue;
+        }
+        const meta = record && record.params && record.params._meta ? record.params._meta : record && record._meta;
+        if (!meta || typeof meta !== 'object') continue;
+        const nextTotal = toNonNegativeFiniteNumber(meta.totalTokens);
+        if (nextTotal <= 0) continue;
+        totalTokens = Math.max(totalTokens, nextTotal);
+        lastEventId = meta.eventId != null ? String(meta.eventId) : String(lineNumber);
+        lastEventTimestamp =
+          timestampToIso(meta.agentTimestampMs) ||
+          timestampToIso(meta.timestampMs) ||
+          timestampToIso(record.timestamp_ms) ||
+          timestampToIso(record.timestamp) ||
+          lastEventTimestamp;
+      }
+    } finally {
+      rl.close();
+    }
+  } catch {
+    return { totalTokens, lastEventId, lastEventTimestamp };
+  }
+  return { totalTokens, lastEventId, lastEventTimestamp };
+}
+
+async function main() {
+const contextTokensUsed = toNonNegativeFiniteNumber(signals.contextTokensUsed ?? signals.totalTokens);
+const totalTokensBeforeCompaction = toNonNegativeFiniteNumber(signals.totalTokensBeforeCompaction);
+const signalTotalTokens = totalTokensBeforeCompaction + contextTokensUsed;
+const updateTelemetry = await readUpdateTelemetry(updatesPath);
+const totalTokens = Math.max(updateTelemetry.totalTokens, signalTotalTokens);
 const messageCount = toNonNegativeFiniteNumber(signals.assistantMessageCount || signals.num_chat_messages);
 const model = signals.primaryModelId || (Array.isArray(signals.modelsUsed) ? signals.modelsUsed[0] : 'grok-build');
-const lastActive = signals.lastActiveAt || summary.updated_at || new Date().toISOString();
+const lastActive = signals.lastActiveAt || updateTelemetry.lastEventTimestamp || summary.updated_at || new Date().toISOString();
 
 if (totalTokens <= 0) {
   process.exit(0);
@@ -163,8 +231,16 @@ const signal = {
   cwd: WORKSPACE_ROOT,
   model,
   totalTokens,
+  contextTokensUsed,
+  totalTokensBeforeCompaction,
   messageCount,
   lastActive,
+  sessionDir,
+  updatesPath,
+  signalsPath,
+  summaryPath,
+  lastEventId: updateTelemetry.lastEventId,
+  lastEventTimestamp: updateTelemetry.lastEventTimestamp,
   capturedAt: new Date().toISOString()
 };
 
@@ -177,6 +253,9 @@ try {
 } catch {}
 
 process.exit(0);
+}
+
+main().catch(() => process.exit(0));
 `;
 }
 

package/src/lib/pricing/curated-overrides.json

@@ -18,7 +18,7 @@
     "deepseek-v4-flash":{ "input": 0.14, "output": 0.28, "cache_read": 0.0028, "cache_write": 0.14 },
     "deepseek-v4-pro":  { "input": 0.435,"output": 0.87, "cache_read": 0.003625, "cache_write": 0.435 },
     "deepseek-chat":    { "input": 0.14, "output": 0.28, "cache_read": 0.0028, "cache_write": 0.14 },
-    "grok-build":       { "input": 1.25, "output": 2.50, "cache_read": 0.20, "note": "Grok Build TUI estimate. signals.json currently exposes contextTokensUsed snapshots, so TokenTracker estimates input/output split until Grok exposes per-call telemetry." },
+    "grok-build":       { "input": 1.25, "output": 2.50, "cache_read": 0.20, "note": "Grok Build TUI estimate. Local telemetry currently exposes totalTokens without a stable prompt/output/cache split, so TokenTracker estimates input/output split until Grok exposes per-call usage details." },
     "grok-4-0709":      { "input": 3.00, "output": 15.00, "cache_read": 0.75 },
     "grok-4":           { "input": 3.00, "output": 15.00, "cache_read": 0.75 },
     "grok-4-latest":    { "input": 3.00, "output": 15.00, "cache_read": 0.75 },