charness 3.0.0 → 3.1.0

package/dist/utils/claudeUsage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeUsage.d.ts","sourceRoot":"","sources":["../../src/utils/claudeUsage.ts"],"names":[],"mappings":"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"}

package/dist/utils/claudeUsage.js

@@ -0,0 +1,413 @@
+"use strict";
+/**
+ * @description Per-profile Claude USAGE — how much of each subscription window an account profile
+ * (`utils/claudeProfiles.ts`) has used, and which profile a new process should run on.
+ *
+ * Two sources feed one snapshot per profile (`ClaudeProfileRecord.usage`):
+ *   - the OAuth usage endpoint (`GET https://api.anthropic.com/api/oauth/usage`, the profile's own access
+ *     token off its `.credentials.json`), polled by the bot (`claudeUsageRefresher.ts`) and on demand — its
+ *     `limits[]` carry the three windows: `session` (five hours), `weekly_all` (seven days, every model) and
+ *     `weekly_scoped` (seven days, ONE model — Fable; `scope.model.display_name`), measured on 2026-10-12;
+ *   - the `rate_limit_event` frames of a json-stream session, one per API request, whose `unifiedWindows`
+ *     carry the same windows under their CLI names (`five_hour`, `seven_day`, `seven_day_overage_included`
+ *     — the last one IS the Fable window: same utilization and reset instant as the endpoint's scoped limit).
+ *
+ * Token refresh is the CLI's job: a token past its `expiresAt` is never used (nor refreshed here) — the
+ * snapshot is marked stale and the next CLI run renews it. The token itself is never logged or returned.
+ *
+ * Pure except {@link readClaudeOAuthToken} (one file read) and {@link fetchClaudeUsage} (one GET through an
+ * injectable `fetch`), so the rest is unit-tested without the network.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.englishRelativeResetWords = exports.claudeUsageBucketKinds = exports.claudeUsageFetchTimeoutMs = exports.claudeUsageEndpoint = void 0;
+exports.readClaudeOAuthToken = readClaudeOAuthToken;
+exports.checkIsClaudeTokenExpired = checkIsClaudeTokenExpired;
+exports.fetchClaudeUsage = fetchClaudeUsage;
+exports.parseClaudeUsageResponse = parseClaudeUsageResponse;
+exports.buildBucketsFromRateLimitWindows = buildBucketsFromRateLimitWindows;
+exports.mergeClaudeUsageSnapshot = mergeClaudeUsageSnapshot;
+exports.markClaudeUsageSnapshotStale = markClaudeUsageSnapshotStale;
+exports.checkClaudeUsageBucketsChanged = checkClaudeUsageBucketsChanged;
+exports.getClaudeUsageBucket = getClaudeUsageBucket;
+exports.checkIsScopedWeeklyModel = checkIsScopedWeeklyModel;
+exports.getRelevantClaudeUsageKinds = getRelevantClaudeUsageKinds;
+exports.buildClaudeProfilesReport = buildClaudeProfilesReport;
+exports.buildClaudeProfileUsageViews = buildClaudeProfileUsageViews;
+exports.readClaudeProfileRecordsFromStateFile = readClaudeProfileRecordsFromStateFile;
+exports.formatClaudeUsageResetAt = formatClaudeUsageResetAt;
+exports.formatClaudeUsageRelativeReset = formatClaudeUsageRelativeReset;
+exports.formatClaudeUsageBucket = formatClaudeUsageBucket;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const claudeProfiles_1 = require("./claudeProfiles");
+exports.claudeUsageEndpoint = 'https://api.anthropic.com/api/oauth/usage';
+/** The OAuth beta header the CLI sends with its subscription token. */
+const claudeOAuthBetaHeader = 'oauth-2025-04-20';
+exports.claudeUsageFetchTimeoutMs = 15_000;
+exports.claudeUsageBucketKinds = ['session', 'weekly_all', 'weekly_scoped'];
+/**
+ * @description The subscription access token of a profile, off `<configDir>/.credentials.json`
+ * (`~/.claude/.credentials.json` for the default profile). `null` when the file or the OAuth entry is absent —
+ * a logged-out directory. The caller never logs the result.
+ */
+function readClaudeOAuthToken(configDir, homeClaudeDir = (0, claudeProfiles_1.resolveHomeClaudeDir)()) {
+    const file = path.join(configDir ?? homeClaudeDir, '.credentials.json');
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+    const oauth = checkIsRecord(parsed) && checkIsRecord(parsed.claudeAiOauth) ? parsed.claudeAiOauth : null;
+    if (!oauth || typeof oauth.accessToken !== 'string' || oauth.accessToken === '')
+        return null;
+    return { accessToken: oauth.accessToken, expiresAtMs: typeof oauth.expiresAt === 'number' ? oauth.expiresAt : null };
+}
+/** Whether the token is past its expiry at `nowMs` (a token without expiry counts as live). */
+function checkIsClaudeTokenExpired(token, nowMs) {
+    return token.expiresAtMs !== null && token.expiresAtMs <= nowMs;
+}
+/**
+ * @description One GET of the usage endpoint with the profile's token. A 401/403 is an auth error (the
+ * token is no longer accepted — the CLI's next run renews it); anything else is a plain failure. Never
+ * throws; never includes the token in the result.
+ */
+async function fetchClaudeUsage(token, options = {}) {
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), options.timeoutMs ?? exports.claudeUsageFetchTimeoutMs);
+    try {
+        const response = await fetchImpl(exports.claudeUsageEndpoint, {
+            headers: { Authorization: `Bearer ${token}`, 'anthropic-beta': claudeOAuthBetaHeader, Accept: 'application/json' },
+            signal: controller.signal,
+        });
+        if (response.status === 401 || response.status === 403)
+            return { ok: false, error: `http ${response.status}`, isAuthError: true };
+        if (response.status !== 200)
+            return { ok: false, error: `http ${response.status}`, isAuthError: false };
+        const buckets = parseClaudeUsageResponse(await response.json());
+        if (buckets.length === 0)
+            return { ok: false, error: 'no limits in the response', isAuthError: false };
+        return { ok: true, buckets };
+    }
+    catch (e) {
+        const reason = e instanceof Error ? (e.name === 'AbortError' ? 'timeout' : e.message) : String(e);
+        return { ok: false, error: reason.slice(0, 120), isAuthError: false };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * @description The buckets of a usage response. Reads `limits[]` (`kind` session / weekly_all /
+ * weekly_scoped, `percent`, `resets_at`, `scope.model.display_name`); a response without it (an older
+ * shape) falls back to the top-level `five_hour` / `seven_day` objects (`utilization` already 0..100).
+ * Unknown kinds are dropped, so a window the API adds later never breaks a reader.
+ */
+function parseClaudeUsageResponse(body) {
+    if (!checkIsRecord(body))
+        return [];
+    if (Array.isArray(body.limits)) {
+        const buckets = [];
+        for (const limit of body.limits) {
+            if (!checkIsRecord(limit))
+                continue;
+            const kind = readBucketKind(limit.kind);
+            if (!kind || typeof limit.percent !== 'number')
+                continue;
+            const scope = checkIsRecord(limit.scope) && checkIsRecord(limit.scope.model) ? limit.scope.model : null;
+            buckets.push({
+                kind,
+                percent: clampPercent(limit.percent),
+                resetsAt: readIso(limit.resets_at),
+                scopeModel: scope && typeof scope.display_name === 'string' ? scope.display_name : null,
+            });
+        }
+        if (buckets.length > 0)
+            return buckets;
+    }
+    const buckets = [];
+    for (const [field, kind] of [['five_hour', 'session'], ['seven_day', 'weekly_all']]) {
+        const window = body[field];
+        if (!checkIsRecord(window) || typeof window.utilization !== 'number')
+            continue;
+        buckets.push({ kind, percent: clampPercent(window.utilization), resetsAt: readIso(window.resets_at), scopeModel: null });
+    }
+    return buckets;
+}
+function readBucketKind(value) {
+    return value === 'session' || value === 'weekly_all' || value === 'weekly_scoped' ? value : null;
+}
+/** The CLI's window names → bucket kinds; `seven_day_overage_included` is the Fable window (see the module doc). */
+const rateLimitWindowKinds = {
+    five_hour: { kind: 'session', scopeModel: null },
+    seven_day: { kind: 'weekly_all', scopeModel: null },
+    seven_day_overage_included: { kind: 'weekly_scoped', scopeModel: 'Fable' },
+};
+/** The buckets a frame's windows carry (unknown window names are dropped). */
+function buildBucketsFromRateLimitWindows(windows) {
+    const buckets = [];
+    for (const window of windows) {
+        const mapping = rateLimitWindowKinds[window.name];
+        if (!mapping)
+            continue;
+        buckets.push({
+            kind: mapping.kind,
+            percent: clampPercent(window.utilization * 100),
+            resetsAt: window.resetsAtMs === null ? null : new Date(window.resetsAtMs).toISOString(),
+            scopeModel: mapping.scopeModel,
+        });
+    }
+    return buckets;
+}
+// ── the snapshot ──
+/**
+ * @description Fold fresh buckets into a profile's snapshot. The endpoint answers with EVERY window, so an
+ * `api` read replaces the set; a frame carries only the windows the request touched, so a `stream` read
+ * upserts those and keeps the rest. Either way the snapshot is fresh (not stale) afterwards.
+ */
+function mergeClaudeUsageSnapshot(previous, incoming, source, nowMs) {
+    let buckets;
+    if (source === 'api' || !previous) {
+        buckets = [...incoming];
+    }
+    else {
+        buckets = previous.buckets.filter((bucket) => !incoming.some((fresh) => fresh.kind === bucket.kind));
+        buckets.push(...incoming);
+    }
+    buckets.sort((a, b) => exports.claudeUsageBucketKinds.indexOf(a.kind) - exports.claudeUsageBucketKinds.indexOf(b.kind));
+    return { fetchedAt: new Date(nowMs).toISOString(), source, buckets };
+}
+/** The snapshot kept as it was, marked stale with the reason (a failed or impossible poll). */
+function markClaudeUsageSnapshotStale(previous, error, nowMs) {
+    return { fetchedAt: previous?.fetchedAt ?? new Date(nowMs).toISOString(), source: previous?.source ?? 'api', buckets: previous?.buckets ?? [], isStale: true, error };
+}
+/** Whether `next` says anything `previous` did not — a stream frame per API request must not rewrite state.json each time. */
+function checkClaudeUsageBucketsChanged(previous, next) {
+    if (!previous || previous.isStale)
+        return true;
+    return next.some((bucket) => {
+        const old = previous.buckets.find((candidate) => candidate.kind === bucket.kind);
+        return !old || old.percent !== bucket.percent || old.resetsAt !== bucket.resetsAt;
+    });
+}
+function getClaudeUsageBucket(snapshot, kind) {
+    return snapshot?.buckets.find((bucket) => bucket.kind === kind) ?? null;
+}
+// ── which profile for a model ──
+/** Whether a model name (`fable`, `claude-fable-5-1`, …) runs on the scoped weekly window. */
+function checkIsScopedWeeklyModel(model) {
+    return model !== null && /fable/i.test(model);
+}
+/** The windows that bound a launch of `model`: the session window plus the weekly one the model drains. */
+function getRelevantClaudeUsageKinds(model) {
+    return ['session', checkIsScopedWeeklyModel(model) ? 'weekly_scoped' : 'weekly_all'];
+}
+/**
+ * @description Rank the profiles for a launch of `model`: a profile that is signed out, marked limited
+ * (`limitedUntil` in the future) or at 100 % on a relevant window is out; the rest are ordered by headroom on
+ * the relevant windows (most first; unknown usage ranks after any known one; a tie goes to the lower total of
+ * the relevant percentages). The first in that order is `recommended`. The entries keep the input order.
+ */
+function buildClaudeProfilesReport(profiles, model, nowMs) {
+    const relevantBuckets = getRelevantClaudeUsageKinds(model);
+    const entries = profiles.map((profile) => {
+        const relevant = relevantBuckets
+            .map((kind) => getClaudeUsageBucket(profile.usage, kind))
+            .filter((bucket) => bucket !== null);
+        const maxPercent = relevant.length === 0 ? null : Math.max(...relevant.map((bucket) => bucket.percent));
+        const isLimited = profile.limitedUntil !== null && Date.parse(profile.limitedUntil) > nowMs;
+        const isEligible = profile.loggedIn !== false && !isLimited && (maxPercent === null || maxPercent < 100);
+        return {
+            name: profile.name,
+            configDir: profile.configDir,
+            email: profile.email,
+            kind: (0, claudeProfiles_1.getClaudeAccountKind)(profile.subscriptionType),
+            subscriptionType: profile.subscriptionType,
+            loggedIn: profile.loggedIn ?? null,
+            buckets: profile.usage?.buckets ?? [],
+            usageFetchedAt: profile.usage?.fetchedAt ?? null,
+            isUsageStale: profile.usage?.isStale === true,
+            limitedUntil: profile.limitedUntil,
+            isEligible,
+            headroomPercent: maxPercent === null ? null : 100 - maxPercent,
+            isRecommended: false,
+        };
+    });
+    const ranked = entries
+        .filter((entry) => entry.isEligible)
+        .sort((a, b) => {
+        if (a.headroomPercent === null || b.headroomPercent === null) {
+            return (a.headroomPercent === null ? 1 : 0) - (b.headroomPercent === null ? 1 : 0);
+        }
+        if (a.headroomPercent !== b.headroomPercent)
+            return b.headroomPercent - a.headroomPercent;
+        return sumRelevantPercent(a, relevantBuckets) - sumRelevantPercent(b, relevantBuckets);
+    });
+    const recommended = ranked[0] ?? null;
+    if (recommended)
+        recommended.isRecommended = true;
+    return { model, relevantBuckets, recommended: recommended?.name ?? null, profiles: entries };
+}
+function sumRelevantPercent(entry, kinds) {
+    return entry.buckets.filter((bucket) => kinds.includes(bucket.kind)).reduce((sum, bucket) => sum + bucket.percent, 0);
+}
+/**
+ * @description The ranking's view of every profile off the registry: `default` (its hidden record, when the
+ * bot has written one) first, then the added profiles in creation order. Shared by the bot (live state) and
+ * the CLI (`state.json` read directly).
+ */
+function buildClaudeProfileUsageViews(input) {
+    // A `default` the operator signed out through /accounts stays out of every ranking until it is signed in again.
+    const isDefaultRemoved = input.records.default?.isRemoved === true;
+    const toView = (name, record) => ({
+        name,
+        configDir: (0, claudeProfiles_1.resolveClaudeProfileDir)(input.dataDir, name),
+        loggedIn: record?.loggedIn,
+        email: record?.email ?? null,
+        subscriptionType: record?.subscriptionType ?? null,
+        usage: record?.usage,
+        limitedUntil: record?.limitedUntil ?? null,
+    });
+    const added = Object.entries(input.records)
+        .filter(([name]) => name !== 'default')
+        .sort(([, a], [, b]) => a.createdAt.localeCompare(b.createdAt));
+    return [...(isDefaultRemoved ? [] : [toView('default', input.records.default)]), ...added.map(([name, record]) => toView(name, record))];
+}
+/** The profile registry as `state.json` holds it — the CLI's read, no `StateStore` (which would migrate and lock). */
+function readClaudeProfileRecordsFromStateFile(dataDir) {
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(path.join(dataDir, 'state.json'), 'utf8'));
+    }
+    catch {
+        return {};
+    }
+    const records = checkIsRecord(parsed) && checkIsRecord(parsed.claudeProfiles) ? parsed.claudeProfiles : {};
+    const result = {};
+    for (const [name, record] of Object.entries(records)) {
+        if (checkIsRecord(record) && typeof record.createdAt === 'string')
+            result[name] = record;
+    }
+    return result;
+}
+// ── rendering ──
+/**
+ * @description A reset instant for a human, in the instance zone: `16:00` when it is today there, `Sat 00:00`
+ * within the week, `17.10 00:00` beyond. The weekday is English on purpose (a three-letter token every locale
+ * reads; the surrounding line is localised).
+ */
+function formatClaudeUsageResetAt(resetsAt, timezone, nowMs) {
+    if (resetsAt === null)
+        return '?';
+    const exact = Date.parse(resetsAt);
+    if (Number.isNaN(exact))
+        return '?';
+    // Windows reset on a minute boundary; the endpoint's instant carries jitter below a second (`13:00:00.40`,
+    // once `12:59:59.9`), which must not read as a minute earlier.
+    const at = Math.round(exact / 60_000) * 60_000;
+    const read = (options, instant) => new Intl.DateTimeFormat('en-GB', { timeZone: timezone, hourCycle: 'h23', ...options }).format(instant);
+    const time = read({ hour: '2-digit', minute: '2-digit' }, at);
+    const dayOf = (instant) => read({ year: 'numeric', month: '2-digit', day: '2-digit' }, instant);
+    if (dayOf(at) === dayOf(nowMs))
+        return time;
+    if (at - nowMs < 6 * 24 * 3_600_000)
+        return `${read({ weekday: 'short' }, at)} ${time}`;
+    return `${read({ day: '2-digit' }, at)}.${read({ month: '2-digit' }, at)} ${time}`;
+}
+/** English words, the CLI's (the bot passes its localised ones). */
+exports.englishRelativeResetWords = { pattern: '🔄 in {time}', day: 'd', hour: 'h', minute: 'm' };
+/**
+ * @description A reset instant as a time from now: `🔄 in 2d 1h`, `🔄 in 2h`, `🔄 in 30m`. The two largest
+ * units at most, minutes only under an hour: from a day up it is days + hours (hours dropped when zero), from
+ * an hour up whole hours (rounded), below that minutes (at least one). An instant already past reads as
+ * `🔄 in 1m` (the window is about to roll over). `?` for a missing or unparseable instant.
+ */
+function formatClaudeUsageRelativeReset(resetsAt, nowMs, words = exports.englishRelativeResetWords) {
+    if (resetsAt === null)
+        return '?';
+    const at = Date.parse(resetsAt);
+    if (Number.isNaN(at))
+        return '?';
+    const totalMinutes = Math.max(1, Math.round((at - nowMs) / 60_000));
+    let time;
+    if (totalMinutes < 60) {
+        time = `${totalMinutes}${words.minute}`;
+    }
+    else if (totalMinutes < 24 * 60) {
+        // 23h40m rounds to 24h: that is a day.
+        time = totalMinutes / 60 >= 23.5 ? `1${words.day}` : `${Math.round(totalMinutes / 60)}${words.hour}`;
+    }
+    else {
+        let days = Math.floor(totalMinutes / 1440);
+        let hours = Math.round((totalMinutes % 1440) / 60);
+        if (hours === 24) {
+            days += 1;
+            hours = 0;
+        }
+        time = hours === 0 ? `${days}${words.day}` : `${days}${words.day} ${hours}${words.hour}`;
+    }
+    return words.pattern.replace('{time}', time);
+}
+/**
+ * @description `81% 🔄 in 2h` for a bucket, `—` for a missing one. A bucket whose reset is unknown shows
+ * `fallbackResetsAt` instead (the session window's reset is often missing while the weekly one is known);
+ * with neither it is the bare percent — a «?» after a number would read as a doubt about the number.
+ */
+function formatClaudeUsageBucket(bucket, nowMs, options = {}) {
+    if (bucket === null)
+        return '—';
+    const known = bucket.resetsAt !== null && !Number.isNaN(Date.parse(bucket.resetsAt));
+    const resetsAt = known ? bucket.resetsAt : options.fallbackResetsAt ?? null;
+    if (resetsAt === null || Number.isNaN(Date.parse(resetsAt)))
+        return `${bucket.percent}%`;
+    return `${bucket.percent}% ${formatClaudeUsageRelativeReset(resetsAt, nowMs, options.words)}`;
+}
+// ── small readers ──
+function checkIsRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readIso(value) {
+    if (typeof value !== 'string')
+        return null;
+    const ms = Date.parse(value);
+    return Number.isNaN(ms) ? null : new Date(ms).toISOString();
+}
+function clampPercent(value) {
+    return Math.max(0, Math.min(100, Math.round(value)));
+}
+//# sourceMappingURL=claudeUsage.js.map

package/dist/utils/claudeUsage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeUsage.js","sourceRoot":"","sources":["../../src/utils/claudeUsage.ts"],"names":[],"mappings":"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"}

package/dist/utils/claudeUsageRefresher.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @description The usage poller behind `/account`, the `claude_profiles` MCP tool and the stream frames: keeps
+ * one `ClaudeUsageSnapshot` per account profile current (`utils/claudeUsage.ts`), reading every signed-in
+ * profile's own token. Runs on a modest timer (`claudeUsageRefreshIntervalMs`), on `/account` open and on
+ * demand (`refreshAll({ maxAgeMs })` skips a snapshot fresher than that), and folds in the `rate_limit_event`
+ * windows a json-stream session reports (`noteStreamWindows`), persisting only when a bucket actually moved.
+ *
+ * A profile whose token has expired is NOT refreshed here (the CLI renews tokens; a bot-side refresh would
+ * race it and could invalidate the CLI's own) — its snapshot is marked stale instead. Every dependency is
+ * injected, so the unit test drives it without the network, the file system or a `StateStore`.
+ */
+import { type ClaudeOAuthToken, type ClaudeRateLimitWindow, type ClaudeUsageFetchResult, type ClaudeUsageSnapshot } from './claudeUsage';
+export declare const claudeUsageRefreshIntervalMs: number;
+/** A snapshot younger than this is served as is by the on-demand readers (`/account`, the MCP tool). */
+export declare const claudeUsageOnDemandMaxAgeMs = 60000;
+export interface ClaudeUsageRefresherProfile {
+    name: string;
+    configDir: string | null;
+    /** The last auth probe; a profile known to be signed out is skipped. */
+    loggedIn: boolean | undefined;
+}
+export interface ClaudeUsageRefresherDeps {
+    listProfiles: () => ClaudeUsageRefresherProfile[];
+    getSnapshot: (name: string) => ClaudeUsageSnapshot | undefined;
+    saveSnapshot: (name: string, snapshot: ClaudeUsageSnapshot) => void;
+    readToken: (configDir: string | null) => ClaudeOAuthToken | null;
+    fetchUsage: (accessToken: string) => Promise<ClaudeUsageFetchResult>;
+    now?: () => number;
+    log?: (line: string) => void;
+}
+export interface ClaudeUsageRefresher {
+    /** Poll every signed-in profile; with `maxAgeMs`, only those whose snapshot is older (or stale). One poll in flight at a time. */
+    refreshAll: (options?: {
+        maxAgeMs?: number;
+    }) => Promise<void>;
+    /** Poll one profile now (a fresh sign-in, a tap). */
+    refreshOne: (name: string) => Promise<void>;
+    /** A json-stream frame's windows for the profile the session runs on. */
+    noteStreamWindows: (name: string, windows: readonly ClaudeRateLimitWindow[]) => void;
+    start: (intervalMs?: number) => void;
+    stop: () => void;
+}
+export declare function createClaudeUsageRefresher(deps: ClaudeUsageRefresherDeps): ClaudeUsageRefresher;
+//# sourceMappingURL=claudeUsageRefresher.d.ts.map

package/dist/utils/claudeUsageRefresher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeUsageRefresher.d.ts","sourceRoot":"","sources":["../../src/utils/claudeUsageRefresher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACzB,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,4BAA4B,QAAc,CAAC;AAExD,wGAAwG;AACxG,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wEAAwE;IACxE,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,2BAA2B,EAAE,CAAC;IAClD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,mBAAmB,GAAG,SAAS,CAAC;IAC/D,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACpE,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,gBAAgB,GAAG,IAAI,CAAC;IACjE,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,kIAAkI;IAClI,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,qDAAqD;IACrD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,yEAAyE;IACzE,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,qBAAqB,EAAE,KAAK,IAAI,CAAC;IACrF,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG,oBAAoB,CAyE/F"}

package/dist/utils/claudeUsageRefresher.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * @description The usage poller behind `/account`, the `claude_profiles` MCP tool and the stream frames: keeps
+ * one `ClaudeUsageSnapshot` per account profile current (`utils/claudeUsage.ts`), reading every signed-in
+ * profile's own token. Runs on a modest timer (`claudeUsageRefreshIntervalMs`), on `/account` open and on
+ * demand (`refreshAll({ maxAgeMs })` skips a snapshot fresher than that), and folds in the `rate_limit_event`
+ * windows a json-stream session reports (`noteStreamWindows`), persisting only when a bucket actually moved.
+ *
+ * A profile whose token has expired is NOT refreshed here (the CLI renews tokens; a bot-side refresh would
+ * race it and could invalidate the CLI's own) — its snapshot is marked stale instead. Every dependency is
+ * injected, so the unit test drives it without the network, the file system or a `StateStore`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudeUsageOnDemandMaxAgeMs = exports.claudeUsageRefreshIntervalMs = void 0;
+exports.createClaudeUsageRefresher = createClaudeUsageRefresher;
+const claudeUsage_1 = require("./claudeUsage");
+exports.claudeUsageRefreshIntervalMs = 10 * 60_000;
+/** A snapshot younger than this is served as is by the on-demand readers (`/account`, the MCP tool). */
+exports.claudeUsageOnDemandMaxAgeMs = 60_000;
+function createClaudeUsageRefresher(deps) {
+    const now = deps.now ?? (() => Date.now());
+    const log = deps.log ?? ((line) => console.log(line));
+    let inFlight = null;
+    let timer = null;
+    async function pollProfile(profile) {
+        const previous = deps.getSnapshot(profile.name);
+        const token = deps.readToken(profile.configDir);
+        if (token === null) {
+            // No credentials on disk: nothing to poll, nothing to keep — an old snapshot of a signed-out directory is noise.
+            if (previous && !previous.isStale)
+                deps.saveSnapshot(profile.name, (0, claudeUsage_1.markClaudeUsageSnapshotStale)(previous, 'not signed in', now()));
+            return;
+        }
+        if ((0, claudeUsage_1.checkIsClaudeTokenExpired)(token, now())) {
+            if (!previous?.isStale || previous.error !== 'token expired') {
+                deps.saveSnapshot(profile.name, (0, claudeUsage_1.markClaudeUsageSnapshotStale)(previous, 'token expired', now()));
+            }
+            return;
+        }
+        const result = await deps.fetchUsage(token.accessToken);
+        if (!result.ok) {
+            log(`[usage] ${profile.name}: usage poll failed (${result.error})`);
+            deps.saveSnapshot(profile.name, (0, claudeUsage_1.markClaudeUsageSnapshotStale)(previous, result.error, now()));
+            return;
+        }
+        deps.saveSnapshot(profile.name, (0, claudeUsage_1.mergeClaudeUsageSnapshot)(previous, result.buckets, 'api', now()));
+    }
+    function checkNeedsPoll(profile, maxAgeMs) {
+        if (profile.loggedIn === false)
+            return false;
+        if (maxAgeMs === undefined)
+            return true;
+        const snapshot = deps.getSnapshot(profile.name);
+        if (!snapshot || snapshot.isStale)
+            return true;
+        return now() - Date.parse(snapshot.fetchedAt) >= maxAgeMs;
+    }
+    async function refreshAll(options = {}) {
+        if (inFlight)
+            return inFlight;
+        inFlight = (async () => {
+            const due = deps.listProfiles().filter((profile) => checkNeedsPoll(profile, options.maxAgeMs));
+            await Promise.all(due.map((profile) => pollProfile(profile).catch((e) => {
+                log(`[usage] ${profile.name}: usage poll threw: ${e instanceof Error ? e.message : String(e)}`);
+            })));
+        })().finally(() => { inFlight = null; });
+        return inFlight;
+    }
+    async function refreshOne(name) {
+        const profile = deps.listProfiles().find((candidate) => candidate.name === name);
+        if (profile)
+            await pollProfile(profile);
+    }
+    function noteStreamWindows(name, windows) {
+        const buckets = (0, claudeUsage_1.buildBucketsFromRateLimitWindows)(windows);
+        if (buckets.length === 0)
+            return;
+        const previous = deps.getSnapshot(name);
+        if (!(0, claudeUsage_1.checkClaudeUsageBucketsChanged)(previous, buckets))
+            return;
+        deps.saveSnapshot(name, (0, claudeUsage_1.mergeClaudeUsageSnapshot)(previous, buckets, 'stream', now()));
+    }
+    function start(intervalMs = exports.claudeUsageRefreshIntervalMs) {
+        stop();
+        timer = setInterval(() => { void refreshAll(); }, intervalMs);
+        timer.unref?.();
+    }
+    function stop() {
+        if (timer)
+            clearInterval(timer);
+        timer = null;
+    }
+    return { refreshAll, refreshOne, noteStreamWindows, start, stop };
+}
+//# sourceMappingURL=claudeUsageRefresher.js.map

package/dist/utils/claudeUsageRefresher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeUsageRefresher.js","sourceRoot":"","sources":["../../src/utils/claudeUsageRefresher.ts"],"names":[],"mappings":"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"}

package/dist/utils/fallbackBridge.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @description The CONTEXT BRIDGE a cross-backend fallback switch hands the new agent (`utils/fallbackChain.ts`):
+ * when a topic moves between Claude Code and OpenCode the adapter changes, the new session cannot read the
+ * old transcript, and the only thing it knows is what its first prompt tells it. That prompt is built here:
+ * why it takes over, the folder it shares with its predecessor, the predecessor's last turns verbatim
+ * (user and assistant), and the instruction to establish the state of the work from the project itself
+ * before carrying on — then to say in one short message what the task is, what is done and what remains.
+ *
+ * English on purpose (an agent-facing template, like the thread-context preamble) with a baked reply-language
+ * directive. Pure: the turns and labels come from the caller, so the shape is unit-tested.
+ */
+import type { RecentTurn } from '../types';
+/** How many of the previous agent's last turns the bridge carries (user and assistant turns alike). */
+export declare const fallbackBridgeTurnLimit = 6;
+/** A single turn longer than this is cut in the middle — the bridge is a hand-over, not a transcript copy. */
+export declare const fallbackBridgeTurnMaxChars = 2500;
+/**
+ * @description The bridge prompt. `turns` are chronological (oldest first), already capped by the caller;
+ * `resetsAtText` names when the exhausted account comes back (omitted when unknown).
+ */
+export declare function buildFallbackBridgePrompt(input: {
+    fromLabel: string;
+    toLabel: string;
+    turns: readonly RecentTurn[];
+    resetsAtText: string | null;
+    replyLanguage: string;
+}): string;
+/** Cut the middle of an over-long turn, keeping its head and tail (the ask and the outcome are at the ends). */
+export declare function truncateTurnText(text: string, maxChars?: number): string;
+/** Whether a prompt is a bridge (the request ledger and the trace must not read it as the user's own text). */
+export declare function checkIsFallbackBridgePrompt(text: string): boolean;
+//# sourceMappingURL=fallbackBridge.d.ts.map

package/dist/utils/fallbackBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallbackBridge.d.ts","sourceRoot":"","sources":["../../src/utils/fallbackBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,uGAAuG;AACvG,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,8GAA8G;AAC9G,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAI/C;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAsBT;AAED,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAmC,GAAG,MAAM,CAIpG;AAED,+GAA+G;AAC/G,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE"}