@pify/usage 0.10.0 → 0.11.0

package/README.md

@@ -20,6 +20,8 @@ Folded from each message's `usage.cost`, which pi already computes. It survives
 
 When [`@pify/subagent`](https://github.com/pifydev/subagent), [`@pify/swarm`](https://github.com/pifydev/swarm) or [`@pify/workflow`](https://github.com/pifydev/workflow) run child agents, those children are separate in-memory sessions whose spend never reaches this branch — a session that delegates used to look cheaper than it was. Those packages now add every child message's cost to a process-wide tally, and the footer shows it as a separate ` · agents $0.12` beside the session's own figure (the `/usage` session block has the same line, with tokens). It is kept apart on purpose: the session numbers stay what the branch says, and the agents figure is what the delegation cost on top. The tally survives `/reload` and starts over with a new session.
 
+On a Claude subscription (OAuth Pro/Max) the footer also carries the wall you are approaching: the headers `/usage quota` reads were already captured on every response, but only that command showed them, so the weekly or 5-hour limit used to arrive as a stalled turn. Now a `⚠ 7d 8% · resets 14:05` segment appears once the binding window is below 15%, or whenever Anthropic marks the subscription as anything but allowed, and stays out of the way otherwise. Other providers carry no such headers, so they never show it.
+
 The gauge on the right is how full the context window is — the third mid-session question, next to tokens and cost. It was computed for the `/usage` dashboard but shown only there; now it is live. It appears once there is a window to measure against (so not under `-p`) and turns to `⚠` past 90%, the point where "how full" stops being trivia and becomes a decision. For the breakdown of what filled it, run `/context`.
 
 ## `/usage`

package/extensions/usage.ts

@@ -35,7 +35,7 @@ import { childSpendTotal, onChildSpend, resetChildSpend } from "../src/child-cos
 import { QUOTA_PROVIDERS, fetchQuota, quotaReport, type QuotaResult } from "../src/quota.ts";
 import { redact } from "../src/redact.ts";
 import { scanSessions } from "../src/sessions.ts";
-import { parseRateLimit, formatRateLimit, type RateLimitSnapshot } from "../src/ratelimit.ts";
+import { parseRateLimit, formatRateLimit, type RateLimitSnapshot, footerQuotaSegment } from "../src/ratelimit.ts";
 import { emptyTotals, isRecord, type UsageTotals } from "../src/types.ts";
 
 type UiContext = ExtensionContext;
@@ -83,7 +83,10 @@ export default function usage(pi: ExtensionAPI) {
       return;
     }
     const gauge = contextGauge(contextInfo(ctx).pct);
-    ctx.ui.setStatus("usage", gauge ? `${base} · ${gauge}` : base);
+    // The subscription wall, from the headers already captured for this
+    // provider: quiet while healthy, a short warning once it is close.
+    const quota = footerQuotaSegment(rateLimits.get((ctx.model as { provider?: string } | null)?.provider ?? ""));
+    ctx.ui.setStatus("usage", [base, gauge, quota].filter(Boolean).join(" · "));
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pify/usage",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Token and cost reporting for pi sessions: live footer, local-history dashboard with per-project costs, opt-in provider quota",
   "keywords": [
     "pi-package",

package/src/ratelimit.ts

@@ -166,6 +166,46 @@ function formatReset(snap: RateLimitSnapshot): string {
   return raw;
 }
 
+/** A reset time short enough for the footer: HH:MM today, otherwise MM-DD HH:MM; "" when unknown or unwieldy. */
+export function shortReset(snap: RateLimitSnapshot, now: number = Date.now()): string {
+  const raw = snap.resets;
+  if (!raw) return "";
+  if (snap.source === "anthropic" && /^\d{9,}$/.test(raw)) {
+    const d = new Date(Number.parseInt(raw, 10) * 1000);
+    if (!Number.isFinite(d.getTime())) return "";
+    const hm = `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`;
+    const sameDay = new Date(now).toDateString() === d.toDateString();
+    return sameDay ? hm : `${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")} ${hm}`;
+  }
+  return raw.length <= 12 ? raw : "";
+}
+
+/** Below this share of the binding window left, the footer starts warning. */
+export const FOOTER_WARN_FRACTION = 0.15;
+
+/**
+ * The footer's quota warning, or "" while the session is healthy. A Claude
+ * subscription user used to learn about the 5h/7d wall only when a turn
+ * stalled, or by opening `/usage quota` — the headers were captured either
+ * way. This shows the binding window once it is nearly gone, or whenever
+ * Anthropic marks the subscription as anything but "allowed". Non-Anthropic
+ * providers carry none of these fields, so it stays empty for them.
+ */
+export function footerQuotaSegment(snap: RateLimitSnapshot | null | undefined, now: number = Date.now()): string {
+  if (!snap) return "";
+  const binding =
+    snap.unifiedBinding ?? (snap.unified7dRemaining !== null ? "7d" : snap.unified5hRemaining !== null ? "5h" : null);
+  const remaining = binding === "7d" ? snap.unified7dRemaining : binding === "5h" ? snap.unified5hRemaining : null;
+  const walled = Boolean(snap.unifiedStatus && snap.unifiedStatus !== "allowed");
+  const low = remaining !== null && remaining < FOOTER_WARN_FRACTION;
+  if (!walled && !low) return "";
+  const parts = [`⚠ ${binding ?? "subscription"}`];
+  if (remaining !== null) parts.push(`${Math.max(0, Math.round(remaining * 100))}%`);
+  if (walled) parts.push(snap.unifiedStatus!.replace(/_/g, " "));
+  const reset = shortReset(snap, now);
+  return reset ? `${parts.join(" ")} · resets ${reset}` : parts.join(" ");
+}
+
 /** One human line for the /usage quota report; null when nothing was captured. */
 export function formatRateLimit(snap: RateLimitSnapshot | null): string | null {
   if (!snap) return null;