@xtruder/opencode-claude-max-plugin 0.4.4 → 2.0.0-rc.1

package/build/tui-state.d.ts

@@ -0,0 +1,12 @@
+import { fetchUsage, readUsageCache, writeUsageCache, type UsageData } from "./usage.ts";
+export declare function createUsageStore(intervalMs?: number, io?: {
+    read: typeof readUsageCache;
+    write: typeof writeUsageCache;
+    fetch: typeof fetchUsage;
+}, credentialsPath?: string): {
+    usage: import("solid-js").Accessor<UsageData | null>;
+    status: import("solid-js").Accessor<string>;
+    refresh: () => Promise<void>;
+    dispose: () => void;
+};
+//# sourceMappingURL=tui-state.d.ts.map

package/build/tui-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-state.d.ts","sourceRoot":"","sources":["../src/tui-state.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,UAAU,EACV,cAAc,EAEd,eAAe,EACf,KAAK,SAAS,EACf,MAAM,YAAY,CAAA;AAGnB,wBAAgB,gBAAgB,CAAC,UAAU,SAAS,EAAE,EAAE;;;;CAAW,EAAE,eAAe,CAAC,EAAE,MAAM;;;mBAQvE,OAAO,CAAC,IAAI,CAAC;;EA8ClC"}

package/build/tui.d.ts

@@ -1,7 +1,15 @@
 /** @jsxImportSource @opentui/solid */
-import type { TuiPluginModule } from "@opencode-ai/plugin/tui";
-declare const plugin: TuiPluginModule & {
+import type { Plugin } from "@opencode/plugin/tui";
+import { createUsageStore } from "./tui-state.ts";
+type Store = Pick<ReturnType<typeof createUsageStore>, "usage" | "status">;
+export declare function UsageView(props: {
+    store: Store;
+    theme: Plugin.Context["theme"];
+    detail?: boolean;
+}): any;
+declare const _default: {
     id: string;
+    setup(ctx: Plugin.Context): (() => void) | undefined;
 };
-export default plugin;
+export default _default;
 //# sourceMappingURL=tui.d.ts.map

package/build/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.tsx"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,KAAK,EAGV,eAAe,EAEhB,MAAM,yBAAyB,CAAA;AAujBhC,QAAA,MAAM,MAAM,EAAE,eAAe,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAG3C,CAAA;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.tsx"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAMjD,KAAK,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAA;AAC1E,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAC/B,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,OAqEA;;;;;AAED,wBA8C6B"}

package/build/tui.js

@@ -0,0 +1,239 @@
+import { c as writeUsageCache, i as formatReset, o as readUsageCache, r as fetchUsage, s as shouldFetchApi, t as bestUsageFromCache } from "./usage-pZdEiX94.js";
+import { createComponent, createElement, createTextNode, effect, insert, insertNode, memo, setProp } from "@opentui/solid";
+import { For, Show, createSignal } from "solid-js";
+//#region src/tui-state.ts
+var defaults = {
+	read: readUsageCache,
+	write: writeUsageCache,
+	fetch: fetchUsage
+};
+function createUsageStore(intervalMs = 6e4, io = defaults, credentialsPath) {
+	const [usage, setUsage] = createSignal(null);
+	const [status, setStatus] = createSignal("loading");
+	let pending;
+	let disposed = false;
+	const controller = new AbortController();
+	const unavailable = (message) => setStatus(usage() ? `Showing cached usage. ${message}` : message);
+	const refresh = () => {
+		if (disposed) return Promise.resolve();
+		if (pending) return pending;
+		pending = (async () => {
+			try {
+				const cache = io.read();
+				const cached = bestUsageFromCache(cache);
+				if (cached) setUsage(cached);
+				if (!shouldFetchApi(cache)) {
+					if (cache.apiRateLimitUntil > Date.now()) unavailable("Rate limited; retrying later.");
+					else setStatus(cached ? "ready" : "Usage temporarily unavailable; retrying later.");
+					return;
+				}
+				const result = await io.fetch(credentialsPath, AbortSignal.any([controller.signal, AbortSignal.timeout(15e3)]));
+				if (disposed) return;
+				if (result.data) {
+					setUsage(result.data);
+					setStatus("ready");
+					io.write({
+						api: result.data,
+						apiFetchedAt: Date.now(),
+						apiRateLimitUntil: 0
+					});
+				} else if (result.retryAfterMs > 0) {
+					io.write({ apiRateLimitUntil: Date.now() + result.retryAfterMs });
+					unavailable("Rate limited; retrying later.");
+				} else unavailable("Usage unavailable. Check Claude login: claude auth login");
+			} catch {
+				if (!disposed) unavailable("Usage request failed; retrying later.");
+			}
+		})().finally(() => {
+			pending = void 0;
+		});
+		return pending;
+	};
+	refresh();
+	const timer = setInterval(() => void refresh(), intervalMs);
+	return {
+		usage,
+		status,
+		refresh,
+		dispose: () => {
+			disposed = true;
+			clearInterval(timer);
+			controller.abort();
+		}
+	};
+}
+//#endregion
+//#region src/tui.tsx
+var percent = (value) => Math.round(Math.max(0, Math.min(100, Number.isFinite(value) ? value : 0)));
+function UsageView(props) {
+	const rows = () => {
+		const data = props.store.usage();
+		return [
+			["5h", data?.five_hour],
+			["7d", data?.seven_day],
+			...props.detail ? [
+				["Sonnet (7d)", data?.seven_day_sonnet],
+				["Opus (7d)", data?.seven_day_opus],
+				["OAuth apps (7d)", data?.seven_day_oauth_apps],
+				["Cowork (7d)", data?.seven_day_cowork]
+			] : []
+		].filter(([, window]) => window);
+	};
+	return (() => {
+		var _el$ = createElement("box"), _el$2 = createElement("text"), _el$3 = createElement("b");
+		insertNode(_el$, _el$2);
+		setProp(_el$, "width", "100%");
+		setProp(_el$, "flexDirection", "column");
+		setProp(_el$, "gap", 0);
+		insertNode(_el$2, _el$3);
+		insert(_el$3, () => props.detail ? "Claude Subscription Usage" : "Claude Usage");
+		insert(_el$, createComponent(For, {
+			get each() {
+				return rows();
+			},
+			children: ([label, window]) => {
+				const [width, setWidth] = createSignal(0);
+				const line = () => {
+					const suffix = `] ${percent(window.utilization)}%`;
+					const prefix = `${label} [`;
+					const size = Math.max(0, width() - prefix.length - suffix.length);
+					const filled = Math.round(percent(window.utilization) * size / 100);
+					return prefix + "█".repeat(filled) + "░".repeat(size - filled) + suffix;
+				};
+				return (() => {
+					var _el$9 = createElement("box"), _el$0 = createElement("text");
+					insertNode(_el$9, _el$0);
+					setProp(_el$9, "width", "100%");
+					setProp(_el$9, "flexDirection", "column");
+					setProp(_el$9, "onSizeChange", function() {
+						setWidth(this.width);
+					});
+					insert(_el$0, line);
+					insert(_el$9, createComponent(Show, {
+						get when() {
+							return window?.resets_at;
+						},
+						get children() {
+							var _el$1 = createElement("text");
+							insert(_el$1, () => formatReset(window.resets_at));
+							effect((_$p) => setProp(_el$1, "fg", props.theme.text.muted, _$p));
+							return _el$1;
+						}
+					}), null);
+					effect((_$p) => setProp(_el$0, "fg", props.theme.text.action.primary.base, _$p));
+					return _el$9;
+				})();
+			}
+		}), null);
+		insert(_el$, createComponent(Show, {
+			get when() {
+				return memo(() => !!props.detail)() && props.store.usage()?.extra_usage;
+			},
+			children: (extra) => (() => {
+				var _el$10 = createElement("text");
+				insert(_el$10, (() => {
+					var _c$2 = memo(() => !!extra().is_enabled);
+					return () => _c$2() ? `Extra usage: ${extra().utilization == null ? "enabled" : `${percent(extra().utilization)}% used`}` : "Extra usage: disabled";
+				})());
+				effect((_$p) => setProp(_el$10, "fg", props.theme.text.muted, _$p));
+				return _el$10;
+			})()
+		}), null);
+		insert(_el$, createComponent(Show, {
+			get when() {
+				return props.store.status() !== "ready";
+			},
+			get children() {
+				var _el$4 = createElement("text");
+				insert(_el$4, (() => {
+					var _c$ = memo(() => props.store.status() === "loading");
+					return () => _c$() ? "Loading usage…" : props.store.status();
+				})());
+				effect((_$p) => setProp(_el$4, "fg", props.theme.text.muted, _$p));
+				return _el$4;
+			}
+		}), null);
+		insert(_el$, createComponent(Show, {
+			get when() {
+				return memo(() => props.store.status() === "ready")() && rows().length === 0;
+			},
+			get children() {
+				var _el$5 = createElement("text");
+				insertNode(_el$5, createTextNode(`No usage windows available.`));
+				effect((_$p) => setProp(_el$5, "fg", props.theme.text.muted, _$p));
+				return _el$5;
+			}
+		}), null);
+		insert(_el$, createComponent(Show, {
+			get when() {
+				return props.detail;
+			},
+			get children() {
+				var _el$7 = createElement("text");
+				insertNode(_el$7, createTextNode(`Esc to close · /usage refreshes (API cache: 5m)`));
+				effect((_$p) => setProp(_el$7, "fg", props.theme.text.muted, _$p));
+				return _el$7;
+			}
+		}), null);
+		effect((_p$) => {
+			var _v$ = props.detail ? 1 : 0, _v$2 = props.theme.text.base;
+			_v$ !== _p$.e && (_p$.e = setProp(_el$, "padding", _v$, _p$.e));
+			_v$2 !== _p$.t && (_p$.t = setProp(_el$2, "fg", _v$2, _p$.t));
+			return _p$;
+		}, {
+			e: void 0,
+			t: void 0
+		});
+		return _el$;
+	})();
+}
+var tui_default = {
+	id: "anthropic-sdk-usage",
+	setup(ctx) {
+		if (ctx.options.enabled === false || ctx.options.enabled === "false") return;
+		const seconds = Number(ctx.options.poll_interval ?? 60);
+		const store = createUsageStore((Number.isFinite(seconds) ? Math.max(10, seconds) : 60) * 1e3, void 0, ctx.options.credentialsPath);
+		const offCommand = ctx.ui.slot({
+			append: "app",
+			render: () => {
+				ctx.keymap.layer(() => ({
+					mode: "global",
+					commands: [{
+						id: "anthropic-sdk.usage",
+						title: "Claude subscription usage",
+						group: "Claude",
+						palette: true,
+						slash: { name: "usage" },
+						run() {
+							store.refresh();
+							ctx.ui.dialog.show(() => createComponent(UsageView, {
+								store,
+								get theme() {
+									return ctx.theme;
+								},
+								detail: true
+							}));
+						}
+					}]
+				}));
+				return null;
+			}
+		});
+		const offSidebar = ctx.options.sidebar === false || ctx.options.sidebar === "false" ? () => {} : ctx.ui.slot({
+			append: "sidebar.content",
+			render: () => createComponent(UsageView, {
+				store,
+				get theme() {
+					return ctx.theme;
+				}
+			})
+		});
+		return () => {
+			store.dispose();
+			offCommand();
+			offSidebar();
+		};
+	}
+};
+//#endregion
+export { UsageView, tui_default as default };

package/build/usage-pZdEiX94.js

@@ -0,0 +1,336 @@
+import { execSync } from "node:child_process";
+import { closeSync, constants, existsSync, mkdirSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+//#region src/credentials.ts
+/**
+* How long to cache credentials in memory before re-reading from disk.
+*/
+var CREDENTIAL_CACHE_TTL_MS = 3e4;
+/**
+* Buffer before expiry at which we consider the token "near expiry"
+* and trigger a CLI refresh. 60 seconds matches opencode-claude-auth.
+*/
+var EXPIRY_BUFFER_MS = 6e4;
+var cachedCreds = null;
+var cachedAt = 0;
+var cachedPath;
+/**
+* Default path to Claude Code credentials file.
+*/
+function getCredentialsPath() {
+	return join(homedir(), ".claude", ".credentials.json");
+}
+/**
+* Read OAuth credentials from Claude Code's credentials file.
+* Returns null if the file doesn't exist or can't be parsed.
+*/
+function readClaudeCredentials(path) {
+	const credPath = path ?? getCredentialsPath();
+	if (!existsSync(credPath)) return null;
+	try {
+		const raw = readFileSync(credPath, "utf-8");
+		const parsed = JSON.parse(raw);
+		if (!parsed.claudeAiOauth?.accessToken) return null;
+		return parsed.claudeAiOauth;
+	} catch {
+		return null;
+	}
+}
+/**
+* Check if credentials are expired (with 60s buffer).
+*/
+function isExpired(creds) {
+	return Date.now() > creds.expiresAt - EXPIRY_BUFFER_MS;
+}
+/**
+* Run the Claude CLI to trigger an OAuth token refresh.
+* The CLI writes refreshed credentials to ~/.claude/.credentials.json.
+* Retries once on failure (matching opencode-claude-auth behavior).
+*/
+function refreshViaCli() {
+	const maxAttempts = 2;
+	for (let i = 0; i < maxAttempts; i++) try {
+		execSync("claude -p . --model haiku", {
+			timeout: 6e4,
+			encoding: "utf-8",
+			env: {
+				...process.env,
+				TERM: "dumb"
+			},
+			stdio: "ignore"
+		});
+		return true;
+	} catch {}
+	return false;
+}
+/**
+* Read credentials, refreshing via Claude CLI if the token is near expiry.
+* Returns null only if credentials are completely unavailable.
+*/
+function refreshIfNeeded(path) {
+	const creds = readClaudeCredentials(path);
+	if (!creds) return null;
+	if (!isExpired(creds)) return creds;
+	console.warn("[anthropic-sdk-provider] OAuth token near expiry, refreshing via Claude CLI...");
+	if (!refreshViaCli()) {
+		console.warn("[anthropic-sdk-provider] CLI refresh failed. Token may be expired.");
+		return creds;
+	}
+	const fresh = readClaudeCredentials(path);
+	if (fresh && !isExpired(fresh)) {
+		console.warn("[anthropic-sdk-provider] Token refreshed successfully.");
+		return fresh;
+	}
+	return fresh ?? creds;
+}
+/**
+* Get cached credentials with automatic refresh.
+* Uses in-memory caching with a 30-second TTL to avoid
+* hitting the filesystem on every request.
+* When the cached token is near expiry, triggers a CLI refresh.
+*/
+function getCachedCredentials(path) {
+	const now = Date.now();
+	const resolvedPath = path ?? cachedPath;
+	if (cachedCreds && now - cachedAt < CREDENTIAL_CACHE_TTL_MS && !isExpired(cachedCreds)) return cachedCreds;
+	const fresh = refreshIfNeeded(resolvedPath);
+	if (fresh) {
+		cachedCreds = fresh;
+		cachedAt = now;
+		cachedPath = resolvedPath;
+	} else cachedCreds = null;
+	return cachedCreds;
+}
+//#endregion
+//#region src/usage.ts
+/**
+* Claude subscription usage tracking.
+*
+* Two data sources:
+* 1. Usage API (GET /api/oauth/usage) — full per-model breakdown, rate limited
+* 2. Response headers (anthropic-ratelimit-unified-*) — 5h/7d only, every inference call
+*
+* Both are persisted to a shared cache file (~/.local/state/opencode/usage-cache.json)
+* so the TUI plugin (main process) can read data written by the server plugin (worker process).
+*/
+/**
+* In-memory header usage, updated on every inference call.
+* Only meaningful in the server/worker process.
+*/
+var cachedUsage = {};
+var XDG_STATE = process.env.XDG_STATE_HOME || join(homedir(), ".local", "state");
+var USAGE_CACHE_DIR = join(XDG_STATE, "opencode");
+var USAGE_CACHE_FILE = join(USAGE_CACHE_DIR, "usage-cache.json");
+function emptyCache() {
+	return {
+		api: null,
+		headers: null,
+		updatedAt: 0,
+		apiFetchedAt: 0,
+		apiRateLimitUntil: 0
+	};
+}
+var USAGE_LOCK_FILE = USAGE_CACHE_FILE + ".lock";
+var USAGE_TMP_FILE = USAGE_CACHE_FILE + ".tmp";
+/** Max time a lock can be held before we consider it stale (ms). */
+var LOCK_STALE_MS = 5e3;
+/**
+* Acquire an exclusive lock using O_CREAT|O_EXCL (atomic on all filesystems).
+* Returns true if acquired, false if another process holds it.
+* Stale locks (older than LOCK_STALE_MS) are automatically broken.
+*/
+function acquireLock() {
+	try {
+		mkdirSync(USAGE_CACHE_DIR, { recursive: true });
+		const fd = openSync(USAGE_LOCK_FILE, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY);
+		writeFileSync(fd, `${process.pid}\n${Date.now()}`);
+		closeSync(fd);
+		return true;
+	} catch (err) {
+		if (err?.code !== "EEXIST") return false;
+		try {
+			const text = readFileSync(USAGE_LOCK_FILE, "utf-8");
+			const ts = parseInt(text.split("\n")[1] ?? "0");
+			if (Date.now() - ts > LOCK_STALE_MS) {
+				unlinkSync(USAGE_LOCK_FILE);
+				return acquireLock();
+			}
+		} catch {
+			try {
+				unlinkSync(USAGE_LOCK_FILE);
+			} catch {}
+			return acquireLock();
+		}
+		return false;
+	}
+}
+function releaseLock() {
+	try {
+		unlinkSync(USAGE_LOCK_FILE);
+	} catch {}
+}
+/**
+* Read the shared cache file. Returns empty cache if not found.
+*/
+function readUsageCache() {
+	try {
+		const text = readFileSync(USAGE_CACHE_FILE, "utf-8");
+		const data = JSON.parse(text);
+		if (data && typeof data.updatedAt === "number") return data;
+	} catch {}
+	return emptyCache();
+}
+/**
+* Transactional read-modify-write of the cache file.
+* Uses a lockfile for mutual exclusion and write-to-tmp+rename for atomicity.
+*/
+function writeUsageCache(update) {
+	if (!acquireLock()) return;
+	try {
+		const merged = {
+			...readUsageCache(),
+			...update,
+			updatedAt: Date.now()
+		};
+		mkdirSync(USAGE_CACHE_DIR, { recursive: true });
+		writeFileSync(USAGE_TMP_FILE, JSON.stringify(merged));
+		renameSync(USAGE_TMP_FILE, USAGE_CACHE_FILE);
+	} catch {
+		try {
+			unlinkSync(USAGE_TMP_FILE);
+		} catch {}
+	} finally {
+		releaseLock();
+	}
+}
+/**
+* Persist current in-memory header usage to the cache file.
+* Called from the server plugin's wrappedFetch after parsing response headers.
+*/
+function persistCachedUsage() {
+	if (cachedUsage.fiveHourUtil == null && cachedUsage.sevenDayUtil == null) return;
+	writeUsageCache({ headers: { ...cachedUsage } });
+}
+var USAGE_URL = "https://api.anthropic.com/api/oauth/usage";
+/**
+* Fetch current Claude subscription usage from the API.
+* Returns { data, retryAfterMs } so callers can track rate limit state.
+* retryAfterMs > 0 means the API returned 429 with a Retry-After header.
+*/
+async function fetchUsage(credentialsPath, signal) {
+	const creds = readClaudeCredentials(credentialsPath);
+	if (!creds) return {
+		data: null,
+		retryAfterMs: 0
+	};
+	if (creds.expiresAt && creds.expiresAt < Date.now()) return {
+		data: null,
+		retryAfterMs: 0
+	};
+	const resp = await fetch(USAGE_URL, {
+		signal,
+		headers: {
+			authorization: `Bearer ${creds.accessToken}`,
+			"anthropic-beta": "claude-code-20250219,oauth-2025-04-20",
+			"content-type": "application/json",
+			"user-agent": "claude-cli/2.1.81 (external, sdk-cli)",
+			"x-app": "cli"
+		}
+	});
+	if (resp.status === 429) {
+		const retryAfter = parseInt(resp.headers.get("retry-after") ?? "60");
+		return {
+			data: null,
+			retryAfterMs: Math.max(6e4, retryAfter * 1e3)
+		};
+	}
+	if (!resp.ok) return {
+		data: null,
+		retryAfterMs: 0
+	};
+	return {
+		data: await resp.json(),
+		retryAfterMs: 0
+	};
+}
+/**
+* Convert HeaderUsage (from response headers) to UsageData (API format).
+* Provides a partial view — only 5h and 7d windows are available.
+*/
+function headerUsageToUsageData(h) {
+	return {
+		five_hour: h.fiveHourUtil != null ? {
+			utilization: h.fiveHourUtil * 100,
+			resets_at: h.fiveHourReset ? (/* @__PURE__ */ new Date(h.fiveHourReset * 1e3)).toISOString() : null
+		} : null,
+		seven_day: h.sevenDayUtil != null ? {
+			utilization: h.sevenDayUtil * 100,
+			resets_at: h.sevenDayReset ? (/* @__PURE__ */ new Date(h.sevenDayReset * 1e3)).toISOString() : null
+		} : null,
+		seven_day_sonnet: null,
+		seven_day_opus: null,
+		seven_day_oauth_apps: null,
+		seven_day_cowork: null,
+		extra_usage: null
+	};
+}
+/**
+* Get the best available UsageData from the cache by merging both sources.
+* - Headers provide the freshest 5h/7d numbers (updated every inference call)
+* - API provides per-model breakdown and extra usage (updated less frequently)
+* When both exist, header 5h/7d values override API values since they're fresher.
+*/
+function bestUsageFromCache(cache) {
+	if (!cache.api && !cache.headers) return null;
+	const fromHeaders = cache.headers ? headerUsageToUsageData(cache.headers) : null;
+	const fromApi = cache.api;
+	if (!fromApi) return fromHeaders;
+	if (!fromHeaders) return fromApi;
+	return {
+		five_hour: fromHeaders.five_hour ?? fromApi.five_hour,
+		seven_day: fromHeaders.seven_day ?? fromApi.seven_day,
+		seven_day_sonnet: fromApi.seven_day_sonnet,
+		seven_day_opus: fromApi.seven_day_opus,
+		seven_day_oauth_apps: fromApi.seven_day_oauth_apps,
+		seven_day_cowork: fromApi.seven_day_cowork,
+		extra_usage: fromApi.extra_usage
+	};
+}
+/** How long API data is considered fresh before re-fetching (5 minutes). */
+var API_TTL_MS = 3e5;
+/**
+* Check if the API should be called.
+* Returns true when not rate limited AND either never fetched or TTL expired.
+*/
+function shouldFetchApi(cache) {
+	if (cache.apiRateLimitUntil && Date.now() < cache.apiRateLimitUntil) return false;
+	if (!cache.apiFetchedAt) return true;
+	return Date.now() - cache.apiFetchedAt > API_TTL_MS;
+}
+/**
+* Format a reset timestamp as relative time.
+*/
+function formatReset(resetsAt) {
+	if (!resetsAt) return "";
+	const reset = new Date(resetsAt);
+	const now = /* @__PURE__ */ new Date();
+	const diffMs = reset.getTime() - now.getTime();
+	if (diffMs <= 0) return "Reset now";
+	const diffMin = Math.floor(diffMs / 6e4);
+	const diffHour = Math.floor(diffMin / 60);
+	const timeStr = reset.toLocaleTimeString("en-US", {
+		hour: "numeric",
+		minute: "2-digit",
+		timeZoneName: "short"
+	});
+	const dateStr = reset.toLocaleDateString("en-US", {
+		month: "short",
+		day: "numeric"
+	});
+	if (diffHour < 1) return `Resets in ${diffMin}m`;
+	if (diffHour < 24) return `Resets ${timeStr}`;
+	return `Resets ${dateStr}, ${timeStr}`;
+}
+//#endregion
+export { persistCachedUsage as a, writeUsageCache as c, formatReset as i, getCachedCredentials as l, cachedUsage as n, readUsageCache as o, fetchUsage as r, shouldFetchApi as s, bestUsageFromCache as t, readClaudeCredentials as u };

package/build/usage.d.ts

@@ -67,7 +67,7 @@ export declare function persistCachedUsage(): void;
  * Returns { data, retryAfterMs } so callers can track rate limit state.
  * retryAfterMs > 0 means the API returned 429 with a Retry-After header.
  */
-export declare function fetchUsage(credentialsPath?: string): Promise<{
+export declare function fetchUsage(credentialsPath?: string, signal?: AbortSignal): Promise<{
     data: UsageData | null;
     retryAfterMs: number;
 }>;

package/build/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IAC7B,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IAC7B,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAA;IACpC,cAAc,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,oBAAoB,EAAE,WAAW,GAAG,IAAI,CAAA;IACxC,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAA;IACpC,WAAW,EAAE;QACX,UAAU,EAAE,OAAO,CAAA;QACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAC3B,GAAG,IAAI,CAAA;CACT;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,GAAG,EAAE,SAAS,GAAG,IAAI,CAAA;IACrB,iEAAiE;IACjE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAID;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,WAAgB,CAAA;AA8D1C;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAS3C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAoBjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAMD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B3D;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,CAsBhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAmBtE;AAKD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAMzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAwB3D"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IAC7B,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IAC7B,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAA;IACpC,cAAc,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,oBAAoB,EAAE,WAAW,GAAG,IAAI,CAAA;IACxC,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAA;IACpC,WAAW,EAAE;QACX,UAAU,EAAE,OAAO,CAAA;QACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAC3B,GAAG,IAAI,CAAA;CACT;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,GAAG,EAAE,SAAS,GAAG,IAAI,CAAA;IACrB,iEAAiE;IACjE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAID;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,WAAgB,CAAA;AA8D1C;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAS3C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAoBjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAMD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,eAAe,CAAC,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CA2B3D;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,CAsBhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAmBtE;AAKD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAMzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAwB3D"}