tokentracker-cli 1.5.2 → 1.5.4

package/src/lib/accept-encoding.js

@@ -0,0 +1,59 @@
+// Pick a content encoding from an Accept-Encoding header. Keep this shared
+// between the static file server and the JSON API so both agree on q-values,
+// explicit identity exclusions and the "*" wildcard.
+function parseAcceptEncoding(header) {
+  const values = String(header || "").toLowerCase().split(",");
+  const explicit = new Map();
+  let wildcard = null;
+  for (const raw of values) {
+    const parts = raw.trim().split(";");
+    const name = parts.shift()?.trim();
+    if (!name) continue;
+    let quality = 1;
+    for (const part of parts) {
+      const [key, value] = part.trim().split("=");
+      if (key === "q") {
+        const parsed = Number.parseFloat(value);
+        quality = Number.isFinite(parsed) ? parsed : 0;
+      }
+    }
+    const normalized = name === "x-gzip" ? "gzip" : name;
+    if (normalized !== "br" && normalized !== "gzip" && normalized !== "identity" && normalized !== "*") continue;
+    if (normalized === "*") {
+      wildcard = Math.max(wildcard ?? 0, quality);
+      continue;
+    }
+    explicit.set(normalized, Math.max(explicit.get(normalized) ?? 0, quality));
+  }
+  return { explicit, wildcard };
+}
+
+function selectEncoding({ explicit, wildcard }) {
+  let best = null;
+  let bestQuality = 0;
+  for (const name of ["br", "gzip"]) {
+    const quality = explicit.has(name) ? explicit.get(name) : wildcard;
+    if (quality !== null && quality > bestQuality) {
+      best = name;
+      bestQuality = quality;
+    }
+  }
+  return best;
+}
+
+function acceptsIdentity({ explicit, wildcard }) {
+  if (explicit.has("identity")) return explicit.get("identity") > 0;
+  if (wildcard !== null) return wildcard > 0;
+  return true;
+}
+
+function pickEncoding(header) {
+  return selectEncoding(parseAcceptEncoding(header));
+}
+
+function negotiateEncoding(header) {
+  const parsed = parseAcceptEncoding(header);
+  return { encoding: selectEncoding(parsed), identityAllowed: acceptsIdentity(parsed) };
+}
+
+module.exports = { pickEncoding, negotiateEncoding };

package/src/lib/cursor-config.js

@@ -242,7 +242,9 @@ function fetchCursorUsageSummary({ cookie, timeoutMs = 30000, fetchImpl = fetch
     signal: AbortSignal.timeout(timeoutMs),
   }).then(async (res) => {
     if (res.status === 401 || res.status === 403) {
-      throw new Error("Cursor session expired — re-login in Cursor to refresh");
+      const error = new Error("Cursor session expired — re-login in Cursor to refresh");
+      error.code = "AUTH_EXPIRED";
+      throw error;
     }
     if (!res.ok) {
       throw new Error(`Cursor API returned ${res.status}`);

package/src/lib/deepseek-limits.js

@@ -0,0 +1,280 @@
+"use strict";
+
+// DeepSeek (platform.deepseek.com, pay-as-you-go) balance monitoring.
+//
+// DeepSeek has no quota windows at all: it is a prepaid API platform, and the
+// only documented programmatic data source is the balance endpoint
+// (GET https://api.deepseek.com/user/balance, Bearer API key). It returns
+// `is_available` plus `balance_infos[]` entries whose numeric fields are all
+// STRINGS ("110.02"), and more than one currency (CNY + USD) can be present
+// at the same time. Concurrency rate limits (flash 2500 / v4-pro 500, 429)
+// are not quota windows, so nothing here produces a window bar — the panel
+// renders a balance card instead (issue #960).
+//
+// The API key comes from DEEPSEEK_API_KEY when set, otherwise from the key
+// saved in the Limits panel (provider-api-key-store.js). The stored key exists
+// so users never need a machine-wide `launchctl setenv`, which reaches every
+// launchd app on macOS and not just TokenTracker (#837).
+//
+// Balance only decreases between top-ups and there is no reset instant to
+// check, so the last-good disk-cache fallback (0600 JSON, written only on a
+// live success) is gated by a pure TTL — the same "unknown reset" rule the
+// ark providers use — and by a fingerprint of the API key that produced it,
+// so a swapped key can never serve the previous account's balance.
+
+const crypto = require("node:crypto");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { readStoredApiKey } = require("./provider-api-key-store");
+
+const DEEPSEEK_BALANCE_URL = "https://api.deepseek.com/user/balance";
+const DEEPSEEK_LIMITS_CACHE_FILE = "deepseek-limits-cache.json";
+const DEEPSEEK_ENV_NAME = "DEEPSEEK_API_KEY";
+const DEEPSEEK_REQUEST_TIMEOUT_MS = 10_000;
+const DEEPSEEK_BALANCE_CACHE_TTL_MS = 12 * 60 * 60 * 1000;
+
+function readDeepseekApiKey({ home, trackerDir, env = process.env } = {}) {
+  const envKey =
+    env && typeof env === "object" && typeof env[DEEPSEEK_ENV_NAME] === "string"
+      ? env[DEEPSEEK_ENV_NAME].trim()
+      : "";
+  if (envKey) return { apiKey: envKey, source: "env" };
+  const stored = readStoredApiKey({ provider: "deepseek", trackerDir, home });
+  return stored ? { apiKey: stored, source: "stored" } : null;
+}
+
+// Balance payloads are strings; a malformed or negative entry must drop out
+// rather than coerce into a misleading 0 ("" and " " both coerce to 0).
+function balanceNumber(value) {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (!trimmed) return null;
+    const n = Number(trimmed);
+    return Number.isFinite(n) && n >= 0 ? n : null;
+  }
+  if (typeof value !== "number") return null;
+  return Number.isFinite(value) && value >= 0 ? value : null;
+}
+
+/**
+ * Normalize the GET /user/balance payload into one row per currency, API
+ * order preserved (the panel renders each currency side by side; picking a
+ * single "primary" currency is an owner decision, not a parser concern).
+ * Throws when the payload shape is unusable so the caller can fall back to
+ * the disk cache.
+ */
+function normalizeDeepseekBalanceResponse(body) {
+  if (!body || typeof body !== "object") {
+    throw new Error("DeepSeek balance response is not an object.");
+  }
+  if (typeof body.is_available !== "boolean") {
+    throw new Error("DeepSeek balance response is missing is_available.");
+  }
+  const entries = Array.isArray(body.balance_infos) ? body.balance_infos : [];
+  const balances = [];
+  for (const entry of entries) {
+    const currency = typeof entry?.currency === "string" ? entry.currency.trim() : "";
+    const total = balanceNumber(entry?.total_balance);
+    if (!currency || total === null) continue;
+    balances.push({
+      currency,
+      total,
+      granted: balanceNumber(entry?.granted_balance) ?? 0,
+      topped_up: balanceNumber(entry?.topped_up_balance) ?? 0,
+    });
+  }
+  if (balances.length === 0) {
+    throw new Error("DeepSeek balance response contains no usable balance entries.");
+  }
+  return balances;
+}
+
+// The fingerprint labels a credential, so it must come from a memory-hard
+// KDF rather than a bare fast hash (CodeQL flags sha256 over key-store/env
+// credentials; the ark apiKey-prefix label hit the same alert before #950).
+// Memoized per key: scrypt is intentionally slow.
+const DEEPSEEK_FINGERPRINT_SALT = "tokentracker/deepseek-limits-cache/v1";
+let fingerprintMemo = null;
+
+function keyFingerprint(apiKey) {
+  const key = String(apiKey);
+  if (fingerprintMemo?.key === key) return fingerprintMemo.hex;
+  const hex = crypto
+    .scryptSync(key, DEEPSEEK_FINGERPRINT_SALT, 16, {
+      N: 2 ** 15,
+      r: 8,
+      p: 1,
+      maxmem: 128 * 2 ** 15 * 8 * 2,
+    })
+    .toString("hex");
+  fingerprintMemo = { key, hex };
+  return hex;
+}
+
+function resolveDeepseekLimitsCachePath({ trackerDir, home } = {}) {
+  const dir =
+    typeof trackerDir === "string" && trackerDir.trim()
+      ? trackerDir.trim()
+      : path.join(home || os.homedir(), ".tokentracker", "tracker");
+  return path.join(dir, DEEPSEEK_LIMITS_CACHE_FILE);
+}
+
+/**
+ * Last-good balance snapshot. `keyFingerprint` (when given) must match the
+ * key that produced the cache — a different key is a different account, and
+ * its balance would be a wrong answer, not a stale one.
+ */
+function readDeepseekLimitsCache({ trackerDir, home, nowMs = Date.now(), keyFingerprint: expectedFingerprint } = {}) {
+  const cachePath = resolveDeepseekLimitsCachePath({ trackerDir, home });
+  let parsed;
+  try {
+    parsed = JSON.parse(fs.readFileSync(cachePath, "utf8"))?.deepseek;
+  } catch (_error) {
+    return null;
+  }
+  const cachedAtMs = Date.parse(parsed?.cached_at || "");
+  if (!Number.isFinite(cachedAtMs)) return null;
+  if (cachedAtMs > nowMs + 60_000) return null;
+  // Pure TTL: balances have no reset instant, so freshness decays with age
+  // alone (ark's unknown-reset rule).
+  if (nowMs - cachedAtMs > DEEPSEEK_BALANCE_CACHE_TTL_MS) return null;
+  if (expectedFingerprint && parsed?.key_fingerprint !== expectedFingerprint) return null;
+  const balances = Array.isArray(parsed?.balances)
+    ? parsed.balances.filter(
+      (entry) =>
+        entry &&
+        typeof entry.currency === "string" &&
+        entry.currency.trim() &&
+        balanceNumber(entry.total) !== null,
+    )
+    : [];
+  if (balances.length === 0) return null;
+  return {
+    configured: true,
+    error: null,
+    is_available: parsed.is_available === true,
+    balances,
+    source: "disk-cache",
+    stale: true,
+    cached_at: parsed.cached_at,
+  };
+}
+
+function writeDeepseekLimitsCache(limits, { trackerDir, home, nowMs = Date.now(), keyFingerprint: fingerprint } = {}) {
+  if (!limits?.configured || limits.error || !Array.isArray(limits.balances) || limits.balances.length === 0) return;
+  const cachePath = resolveDeepseekLimitsCachePath({ trackerDir, home });
+  const payload = {
+    deepseek: {
+      is_available: limits.is_available === true,
+      balances: limits.balances,
+      key_fingerprint: fingerprint || null,
+      cached_at: new Date(nowMs).toISOString(),
+    },
+  };
+  try {
+    fs.mkdirSync(path.dirname(cachePath), { recursive: true });
+    const tmpPath = `${cachePath}.${process.pid}.tmp`;
+    fs.writeFileSync(tmpPath, JSON.stringify(payload, null, 2), { encoding: "utf8", mode: 0o600 });
+    fs.renameSync(tmpPath, cachePath);
+  } catch (_error) {}
+}
+
+/**
+ * One live GET /user/balance read. Returns {ok, is_available, balances} on a
+ * usable payload, {auth_error: true, error} when the key itself is rejected
+ * (actionable — must not be masked by stale cache), {error} otherwise.
+ */
+async function fetchDeepseekBalance({ apiKey, fetchImpl, timeoutMs = DEEPSEEK_REQUEST_TIMEOUT_MS } = {}) {
+  let response;
+  try {
+    response = await fetchImpl(DEEPSEEK_BALANCE_URL, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        Accept: "application/json",
+      },
+    });
+  } catch (err) {
+    return { error: `DeepSeek balance request failed: ${err?.message || err}` };
+  }
+  if (response.status === 401 || response.status === 403) {
+    return {
+      auth_error: true,
+      error: `DeepSeek API key was rejected (${response.status}). Check the key in the DeepSeek platform console.`,
+    };
+  }
+  if (!response.ok) {
+    return { error: `DeepSeek balance API returned ${response.status}` };
+  }
+  let body;
+  try {
+    body = JSON.parse(await response.text());
+  } catch (err) {
+    return { error: `Could not parse DeepSeek balance response: ${err?.message || err}` };
+  }
+  try {
+    return { ok: true, is_available: body.is_available === true, balances: normalizeDeepseekBalanceResponse(body) };
+  } catch (err) {
+    return { error: err?.message || "DeepSeek balance response could not be parsed." };
+  }
+}
+
+/**
+ * Fetch the DeepSeek balance card. `persistCache: false` lets the caller
+ * suppress the disk write while its aggregate cache generation is stale
+ * (a provider-key save mid-fetch must not republish pre-save data, #837).
+ */
+async function fetchDeepseekLimits({
+  home = os.homedir(),
+  trackerDir,
+  env = process.env,
+  fetchImpl = fetch,
+  nowMs = Date.now(),
+  timeoutMs = DEEPSEEK_REQUEST_TIMEOUT_MS,
+  persistCache = true,
+} = {}) {
+  const credential = readDeepseekApiKey({ home, trackerDir, env });
+  if (!credential) return { configured: false };
+  const fingerprint = keyFingerprint(credential.apiKey);
+
+  const live = await fetchDeepseekBalance({ apiKey: credential.apiKey, fetchImpl, timeoutMs });
+  if (live.ok) {
+    const result = {
+      configured: true,
+      error: null,
+      is_available: live.is_available,
+      balances: live.balances,
+      credential_source: credential.source,
+      source: "provider-api",
+      stale: false,
+      cached_at: new Date(nowMs).toISOString(),
+    };
+    if (persistCache) {
+      writeDeepseekLimitsCache(result, { trackerDir, home, nowMs, keyFingerprint: fingerprint });
+    }
+    return result;
+  }
+  if (live.auth_error) {
+    return { configured: true, error: live.error, auth_error: true, credential_source: credential.source };
+  }
+  const cached = readDeepseekLimitsCache({ trackerDir, home, nowMs, keyFingerprint: fingerprint });
+  if (cached) return { ...cached, credential_source: credential.source };
+  return { configured: true, error: live.error, credential_source: credential.source };
+}
+
+module.exports = {
+  DEEPSEEK_BALANCE_URL,
+  DEEPSEEK_LIMITS_CACHE_FILE,
+  DEEPSEEK_ENV_NAME,
+  DEEPSEEK_BALANCE_CACHE_TTL_MS,
+  balanceNumber,
+  fetchDeepseekBalance,
+  fetchDeepseekLimits,
+  keyFingerprint,
+  normalizeDeepseekBalanceResponse,
+  readDeepseekApiKey,
+  readDeepseekLimitsCache,
+  resolveDeepseekLimitsCachePath,
+  writeDeepseekLimitsCache,
+};

package/src/lib/deepseek-status.js

@@ -0,0 +1,157 @@
+// DeepSeek service-status probe.
+//
+// status.deepseek.com is a Flashcat(快猫)-hosted Next.js app. Unlike Statuspage.io
+// it exposes no public JSON API and sends no CORS headers, so a browser cannot
+// read it directly. The page state is, however, inlined in the server render as
+// React Server Component "flight" data: the client script pushes JSON chunks via
+// self.__next_f.push([1, "<json string>"]). We concatenate those chunks and read
+// the single machine-readable signal — the live `active_changes` array.
+//
+// Semantics (Flashcat change status -> Statuspage.io indicator):
+//   operational                                      -> none
+//   degraded / degraded_performance / maintenance    -> minor
+//   partial_outage                                   -> major
+//   major_outage / full_outage                       -> critical
+// An empty active_changes array means everything is operational. Anything we
+// cannot parse throws, so the caller falls back instead of inventing "all good".
+
+const DEEPSEEK_STATUS_URL = "https://status.deepseek.com/";
+
+const RSC_PUSH_RE = /self\.__next_f\.push\(\[1,("(?:[^"\\]|\\.)*")\]\)/g;
+
+const CHANGE_STATUS_TO_INDICATOR = {
+  operational: "none",
+  degraded: "minor",
+  degraded_performance: "minor",
+  maintenance: "minor",
+  under_maintenance: "minor",
+  partial_outage: "major",
+  major_outage: "critical",
+  full_outage: "critical",
+  outage: "critical",
+};
+
+const INDICATOR_RANK = { none: 0, minor: 1, major: 2, critical: 3 };
+
+function extractFlight(html) {
+  if (typeof html !== "string" || html.length === 0) {
+    throw new Error("DeepSeek status: expected an HTML document");
+  }
+  let flight = "";
+  let chunks = 0;
+  RSC_PUSH_RE.lastIndex = 0;
+  let match;
+  while ((match = RSC_PUSH_RE.exec(html))) {
+    try {
+      flight += JSON.parse(match[1]);
+    } catch (_error) {
+      throw new Error("DeepSeek status: malformed RSC chunk");
+    }
+    chunks += 1;
+  }
+  if (chunks === 0) {
+    throw new Error("DeepSeek status: no RSC data found");
+  }
+  return flight;
+}
+
+// Return the balanced JSON array that starts at `start` (a '[' in flight).
+function sliceJsonArray(flight, start) {
+  let depth = 0;
+  let inString = false;
+  let escaped = false;
+  for (let i = start; i < flight.length; i += 1) {
+    const ch = flight[i];
+    if (inString) {
+      if (escaped) escaped = false;
+      else if (ch === "\\") escaped = true;
+      else if (ch === '"') inString = false;
+      continue;
+    }
+    if (ch === '"') inString = true;
+    else if (ch === "[") depth += 1;
+    else if (ch === "]") {
+      depth -= 1;
+      if (depth === 0) return flight.slice(start, i + 1);
+    }
+  }
+  throw new Error("DeepSeek status: unterminated active_changes array");
+}
+
+function readUpdatedAt(flight) {
+  const match = /"initialDataUpdatedAt":(\d{10,})/.exec(flight);
+  if (!match) return undefined;
+  const ms = Number(match[1]);
+  return Number.isFinite(ms) ? new Date(ms).toISOString() : undefined;
+}
+
+/**
+ * Parse the status.deepseek.com HTML into a Statuspage.io-shaped payload:
+ *   { status: { indicator, description }, page: { updated_at } }
+ * Throws when the page structure is not understood, so callers fall back
+ * instead of reporting a false "operational".
+ */
+function parseDeepSeekStatusPage(html) {
+  const flight = extractFlight(html);
+  const marker = '"active_changes":';
+  const markerIndex = flight.indexOf(marker);
+  if (markerIndex === -1) {
+    throw new Error("DeepSeek status: active_changes not found");
+  }
+  // The value must be an array. If upstream ever reports null / an object /
+  // anything else, refuse to guess a healthier-looking array further along the
+  // document — throwing keeps the caller on its last-good / "unknown" path
+  // instead of inventing a false "operational".
+  let arrayStart = markerIndex + marker.length;
+  while (arrayStart < flight.length && /\s/.test(flight[arrayStart])) arrayStart += 1;
+  if (flight[arrayStart] !== "[") {
+    throw new Error("DeepSeek status: active_changes is not an array");
+  }
+  let changes;
+  try {
+    changes = JSON.parse(sliceJsonArray(flight, arrayStart));
+  } catch (error) {
+    throw new Error("DeepSeek status: cannot parse active_changes (" + error.message + ")");
+  }
+  if (!Array.isArray(changes)) {
+    throw new Error("DeepSeek status: active_changes is not an array");
+  }
+
+  const updatedAt = readUpdatedAt(flight);
+  if (changes.length === 0) {
+    return { status: { indicator: "none", description: "" }, page: { updated_at: updatedAt } };
+  }
+
+  let worstIndicator = "none";
+  let worstRank = -1;
+  let descriptions = [];
+  for (const change of changes) {
+    if (!change || typeof change !== "object") continue;
+    const rawStatus = String(change.status || change.change_status || change.impact || "").toLowerCase();
+    const indicator = CHANGE_STATUS_TO_INDICATOR[rawStatus] || "minor";
+    const rank = INDICATOR_RANK[indicator];
+    const description = typeof change.name === "string" ? change.name
+      : typeof change.title === "string" ? change.title
+      : typeof change.description === "string" ? change.description
+      : "";
+    if (rank > worstRank) {
+      worstRank = rank;
+      worstIndicator = indicator;
+      descriptions = description ? [description] : [];
+    } else if (rank === worstRank && description) {
+      descriptions.push(description);
+    }
+  }
+  // A non-empty array with no readable change is still "something is wrong".
+  if (worstRank < 0) worstIndicator = "minor";
+
+  return {
+    status: { indicator: worstIndicator, description: descriptions.join("; ") },
+    page: { updated_at: updatedAt },
+  };
+}
+
+module.exports = {
+  parseDeepSeekStatusPage,
+  DEEPSEEK_STATUS_URL,
+};

package/src/lib/grok-limits.js

@@ -264,6 +264,29 @@ function grokEntryAccessToken(entry) {
   return entry && typeof entry.key === "string" ? entry.key.trim() : "";
 }
 
+// Non-secret account id for cache partitioning: the OIDC `sub` claim inside the
+// access token, read with an unverified decode (only "who is this token for" —
+// never trusted for auth). Opaque tokens return null.
+function grokTokenSubject(token) {
+  if (typeof token !== "string" || !token.trim()) return null;
+  try {
+    const parts = token.split(".");
+    if (parts.length !== 3) return null;
+    const payload = JSON.parse(Buffer.from(parts[1], "base64url").toString("utf8"));
+    const subject = payload?.sub;
+    return typeof subject === "string" && subject.trim() ? subject.trim() : null;
+  } catch (_error) {
+    return null;
+  }
+}
+
+// Errors that tell the user to re-login. They are actionable and must surface
+// instead of being masked by the stale disk-cache fallback (opencode-go
+// auth_error precedent).
+function isGrokAuthErrorCode(error) {
+  return error?.code === "GROK_AUTH_REQUIRED" || error?.code === "GROK_REAUTH_REQUIRED";
+}
+
 /**
  * Public xAI OIDC client refresh (auth method "none").
  * Matches Grok Build CLI's refresh against https://auth.x.ai/oauth2/token.
@@ -776,6 +799,10 @@ async function fetchGrokLimits({ home, env, fetchImpl = fetch, timeoutMs, nowMs
     return {
       configured: true,
       error: error?.message || "Unknown error",
+      // A rejected refresh is actionable (re-login) and must not be hidden
+      // behind the stale disk-cache fallback. Internal marker — stripped
+      // before the payload is served.
+      ...(isGrokAuthErrorCode(error) ? { auth_error: true } : {}),
     };
   }
 
@@ -786,13 +813,16 @@ async function fetchGrokLimits({ home, env, fetchImpl = fetch, timeoutMs, nowMs
     return {
       configured: true,
       error: resolved.error?.message || grokAuthError().message,
+      ...(isGrokAuthErrorCode(resolved.error) ? { auth_error: true } : {}),
     };
   }
 
   const startedAtMs = Date.now();
+  // Hoisted so the catch below can still derive the cache identity from the
+  // token the failing attempt used.
+  let accessToken = resolved.accessToken;
   try {
     let body;
-    let accessToken = resolved.accessToken;
     try {
       body = await fetchGrokBilling(resolved.accessToken, { fetchImpl, env, timeoutMs });
     } catch (error) {
@@ -831,11 +861,19 @@ async function fetchGrokLimits({ home, env, fetchImpl = fetch, timeoutMs, nowMs
       configured: true,
       error: null,
       ...limits,
+      // Internal cache-partition key (stripped before the payload is served).
+      // An opaque token yields null → the cache write/read is refused, so an
+      // unattributable login can never pin another account's bars (no token
+      // fingerprint fallback: credentials must not enter even a label hash —
+      // CodeQL js/insufficient-password-hash precedent).
+      cache_identity: grokTokenSubject(accessToken),
     };
   } catch (error) {
     return {
       configured: true,
       error: error?.message || "Unknown error",
+      ...(isGrokAuthErrorCode(error) ? { auth_error: true } : {}),
+      cache_identity: grokTokenSubject(accessToken),
     };
   }
 }
@@ -849,6 +887,7 @@ module.exports = {
   loadGrokAuthEntry,
   readGrokAccessToken,
   isGrokAccessTokenExpired,
+  grokTokenSubject,
   resolveGrokOidcClientId,
   resolveGrokOidcIssuer,
   resolveGrokTokenEndpoint,