tokenmaxxing 0.2.1__tar.gz → 0.2.2__tar.gz

{tokenmaxxing-0.2.1 → tokenmaxxing-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tokenmaxxing
-Version: 0.2.1
+Version: 0.2.2
 Summary: Menu bar app showing your live Claude Code session and weekly usage as a colored progress bar.
 Project-URL: Homepage, https://github.com/alvations/tokenmaxxing
 Project-URL: Repository, https://github.com/alvations/tokenmaxxing

{tokenmaxxing-0.2.1 → tokenmaxxing-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tokenmaxxing"
-version = "0.2.1"
+version = "0.2.2"
 description = "Menu bar app showing your live Claude Code session and weekly usage as a colored progress bar."
 readme = "README.md"
 requires-python = ">=3.9"

{tokenmaxxing-0.2.1 → tokenmaxxing-0.2.2}/src/tokenmaxxing/__init__.py

@@ -1,6 +1,6 @@
 """tokenmaxxing — menu bar app for Claude Code session and weekly usage."""
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 
 from tokenmaxxing.app import main
 

{tokenmaxxing-0.2.1 → tokenmaxxing-0.2.2}/src/tokenmaxxing/app.py

@@ -78,8 +78,6 @@ REFRESH_SECONDS = 1800  # 30 min: /api/oauth/usage tolerates ~hourly polling but
                         # at ~5 min cadence with a sticky multi-hour cooldown. 30 min keeps
                         # us well below the throttle threshold; on-demand menu opens still
                         # refresh instantly.
-SUSTAINED_429_THRESHOLD = 3  # after this many consecutive 429s, fall back to /v1/messages
-                             # headers (which cost ~10 tokens/poll) until /usage recovers
 STALE_AFTER_SECONDS = 600  # 10 min: only mark cached data "(stale)" past this age — one
                            # missed poll cycle (~5 min) shouldn't trigger the warning
 REFRESH_MAX_BACKOFF = 1800  # Max backoff: 30 minutes
@@ -724,6 +722,7 @@ class ClaudeMonitorApp(rumps.App):
         self._pending_lock = threading.Lock()
         self._wake = threading.Event()
         self._backoff_until = 0     # unix timestamp; worker won't poll until after this
+        self._force_fallback_next = False  # set by "Force fresh" menu; consumed by next poll
         self._history_lock = threading.Lock()
         self._history = _load_history()
 
@@ -773,6 +772,8 @@ class ClaudeMonitorApp(rumps.App):
         self.stats_item = rumps.MenuItem(HISTORY_COLLECTING)
         self._dashboard_item = rumps.MenuItem("Open Claude dashboard…", callback=self._open_dashboard)
         self._refresh_item = rumps.MenuItem("Refresh now", callback=self._manual_refresh)
+        self._refresh_paid_item = rumps.MenuItem(
+            "Force fresh (uses ~10 tokens)", callback=self._manual_refresh_paid)
 
         self.menu = self._build_menu_items()
 
@@ -800,12 +801,14 @@ class ClaudeMonitorApp(rumps.App):
                     continue
 
                 oauth_data = _get_oauth_data()
-                # After SUSTAINED_429_THRESHOLD consecutive /api/oauth/usage 429s,
-                # unstick the menu by falling back to the paid /v1/messages
-                # header path. We don't enable the fallback by default because it
-                # costs ~10 tokens/poll — we only pay that when the free endpoint
-                # is genuinely stuck in a multi-hour cooldown.
-                allow_fallback = consecutive_failures >= SUSTAINED_429_THRESHOLD
+                # /v1/messages fallback is opt-in only — the user explicitly
+                # triggers it via the "Force fresh (uses ~10 tokens)" menu item,
+                # which sets _force_fallback_next for exactly one poll. The
+                # default path stays zero-token even when /api/oauth/usage is
+                # stuck — we'd rather show stale data than silently bill the
+                # user's quota.
+                allow_fallback = self._force_fallback_next
+                self._force_fallback_next = False
                 payload, err, is_rate_limited, retry_after = fetch_usage(
                     oauth_data, allow_messages_fallback=allow_fallback)
                 # Drop any Refresh-now clicks that arrived during the poll — the
@@ -882,6 +885,17 @@ class ClaudeMonitorApp(rumps.App):
         # Without this, when the worker is in backoff (e.g. after sustained
         # 429s), the wake event fires but the loop top-checks _backoff_until
         # and goes right back to waiting — the click is swallowed.
+        # Zero token cost: hits /api/oauth/usage only.
+        self._backoff_until = 0
+        self._wake.set()
+
+    def _manual_refresh_paid(self, _sender):
+        # Opt-in escape hatch when /api/oauth/usage is stuck in a long
+        # cooldown. Costs ~10 tokens for one /v1/messages probe whose
+        # response headers carry the current rate-limit values. Consumed
+        # exactly once by the next poll; subsequent polls revert to the
+        # free path.
+        self._force_fallback_next = True
         self._backoff_until = 0
         self._wake.set()
 
@@ -962,6 +976,7 @@ class ClaudeMonitorApp(rumps.App):
             None,
             self.last_update_item,
             self._refresh_item,
+            self._refresh_paid_item,
         ])
         return items