clauddy 1.21.2 → 1.22.0

package/README.md

@@ -46,7 +46,7 @@ Knowing you're at **82%** with **1h 12m** left on the window still leaves you do
 - **`~35m left at this pace`** (in coral) — you'd run out before the window resets. Ease off, or wrap up.
 - **`resets before you run out`** — the reset gets there first. Carry on.
 
-The slope is fitted over your **session tokens** rather than the account %. The % is the number you care about, but it arrives as a whole number every ~5 minutes — over a short window the whole signal is a single `16 → 17` step, which throws the fitted pace off by multiples. Local-log tokens step too — one jump per assistant turn — but in increments some 10–20× finer, so the slope is far steadier; the account % then anchors it, converting tokens into % and re-calibrating on every poll.
+The slope is fitted over your **session tokens** rather than the account %. The % is the number you care about, but it arrives as a whole number every few minutes — over a short window the whole signal is a single `16 → 17` step, which throws the fitted pace off by multiples. Local-log tokens step too — one jump per assistant turn — but in increments some 10–20× finer, so the slope is far steadier; the account % then anchors it, converting tokens into % and re-calibrating on every poll.
 
 It reads your **recent** pace, not the session average: go quiet for a few minutes and the projection eases off, which is the point.
 

package/auth.js

@@ -211,6 +211,24 @@ function scopedWeeks(j) {
   return out
 }
 
+// What the endpoint says its own budget is. Undocumented, so we only ever read
+// it — nothing depends on it yet. Knowing the real numbers is what tells us how
+// close the activity poll's floor can get.
+let rateLimit = null
+function readRateLimit(res) {
+  const out = {}
+  try {
+    for (const [k, v] of res.headers) {
+      if (k.startsWith('anthropic-ratelimit-')) out[k.slice(20)] = v
+    }
+  } catch {
+    return // no headers to read — nothing here is worth failing a fetch over
+  }
+  if (!Object.keys(out).length) return
+  if (JSON.stringify(out) !== JSON.stringify(rateLimit)) console.log('usage rate limit', out)
+  rateLimit = out
+}
+
 // Step 3: fetch the authoritative usage
 async function fetchUsage() {
   const token = await validToken()
@@ -228,6 +246,7 @@ async function fetchUsage() {
       status: res.status,
     })
   }
+  readRateLimit(res)
   const j = await res.json()
   return {
     session: win(j.five_hour) || { pct: 0, resetMs: null },
@@ -261,4 +280,13 @@ async function fetchProfile() {
   return profile
 }
 
-module.exports = { begin, complete, fetchUsage, fetchProfile, clear, isConnected, setDataDir }
+module.exports = {
+  rateLimit: () => rateLimit,
+  begin,
+  complete,
+  fetchUsage,
+  fetchProfile,
+  clear,
+  isConnected,
+  setDataDir,
+}

package/main.js

@@ -234,6 +234,7 @@ function applyAccount(acc) {
   usage.setClaudeDir(acc.claudeDir)
   armed = new Set()
   lastSessionPct = null
+  lastSeenTokens = null // the new account's first read is a baseline, not a spend
   loadAlertState()
 }
 
@@ -402,6 +403,7 @@ function createWindow() {
       const data = getUsage(config)
       win.webContents.send('usage', data)
       checkAlerts(config, data)
+      onLocalActivity(data)
     } catch (err) {
       win.webContents.send('usage-error', String(err))
     }
@@ -651,11 +653,32 @@ function watchDebug() {
 let usageTimer = null
 let usageBackoff = 5 * 60 * 1000
 let authFails = 0 // consecutive 401s — see pollUsage
+let lastPollAt = 0
+
+// The authoritative % only moves when tokens are actually spent, and the local
+// logs show that within a tick. Polling off that beats a faster clock: it
+// answers while the user is working and asks for nothing while they are not.
+// The floor is what bounds the cost — never more than one call per 90s, well
+// under what a fixed one-minute poll would spend.
+const POLL_FLOOR_MS = 90 * 1000
+let lastSeenTokens = null
+function onLocalActivity(data) {
+  const t = data?.session?.tokens
+  if (typeof t !== 'number') return
+  const grew = lastSeenTokens != null && t > lastSeenTokens
+  lastSeenTokens = t
+  if (!grew || !auth.isConnected()) return
+  if (Date.now() - lastPollAt < POLL_FLOOR_MS) return
+  clearTimeout(usageTimer) // pollUsage schedules the next heartbeat itself
+  pollUsage()
+}
+
 function scheduleUsagePoll() {
   clearTimeout(usageTimer)
   if (auth.isConnected()) usageTimer = setTimeout(pollUsage, usageBackoff)
 }
 async function pollUsage() {
+  lastPollAt = Date.now()
   try {
     const u = await auth.fetchUsage()
     usageBackoff = 5 * 60 * 1000

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clauddy",
   "desktopName": "clauddy.desktop",
-  "version": "1.21.2",
+  "version": "1.22.0",
   "description": "A cute desktop pet that tracks your Claude Code usage",
   "main": "main.js",
   "bin": {