@hanzo/ui 8.27.54 → 8.27.55

package/dist/product/UsageMeter.d.ts

@@ -0,0 +1,18 @@
+import { type LimitClass, type Limits } from './limits.js';
+/** The status rung each state paints its bar in. */
+export declare const STATE_COLOR: {
+    readonly ok: '$good';
+    readonly near: '$yellow10';
+    readonly limited: '$bad';
+};
+export interface UsageMeterProps {
+    limits: Limits;
+    /** Which classes to draw, in order; those the limits do not name are skipped. */
+    classes?: readonly LimitClass[];
+    /** `sm` for a composer's foot, `md` for a page. */
+    size?: 'sm' | 'md';
+    /** The clock resets are read against; tests pin it. */
+    now?: number;
+}
+export declare function UsageMeter({ limits, classes, size, now }: UsageMeterProps): import("react").JSX.Element | null;
+//# sourceMappingURL=UsageMeter.d.ts.map

package/dist/product/UsageMeter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageMeter.d.ts","sourceRoot":"","sources":["../../src/product/UsageMeter.tsx"],"names":[],"mappings":"AAUA,OAAO,EAA+C,KAAK,UAAU,EAAqC,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAEvI,oDAAoD;AACpD,eAAO,MAAM,WAAW;iBAAS,OAAO;mBAAQ,WAAW;sBAAW,MAAM;CAAgD,CAAA;AAiC5H,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;IAC/B,mDAAmD;IACnD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,OAAiB,EAAE,IAAW,EAAE,GAAG,EAAE,EAAE,eAAe,sCAgD1F"}

package/dist/product/UsageMeter.js

@@ -0,0 +1,45 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * UsageMeter — one row per class of model: its name, a bar of the percent used
+ * in its state's colour, and when it resets. Shares only; no amount or count is
+ * ever drawn. A class with a short window carries it as a second, slimmer bar.
+ */
+import { Text, XStack, YStack } from '@hanzo/gui';
+import { Progress } from '../backends/gui/progress.js';
+import { slot } from '../backends/gui/slot.js';
+import { CLASSES, CLASS_LABEL, when } from './limits.js';
+/** The status rung each state paints its bar in. */
+export const STATE_COLOR = { ok: '$good', near: '$yellow10', limited: '$bad' };
+/** What a class row says under its bar about who pays now. */
+function caption(c) {
+    if (c.state === 'limited' && c.paying === 'none')
+        return 'Paused';
+    if (c.paying === 'prepaid')
+        return 'Paid from prepaid credit';
+    if (c.paying === 'credits')
+        return 'Paid from credits';
+    if (c.state === 'near')
+        return 'Almost used';
+    return '';
+}
+function Session({ label, w, now }) {
+    const resets = when(w.resets_at, now);
+    return (_jsxs(XStack, { items: "center", gap: "$2", minW: 0, "data-state": w.state, ...slot('usage-meter-window'), children: [_jsx(Text, { fontSize: "$1", color: "$soft", shrink: 0, children: "Session" }), _jsx(Progress, { value: w.percent, height: 4, flex: 1, minW: 0, indicatorColor: STATE_COLOR[w.state], "aria-label": `${label} session: ${w.percent}% used` }), _jsxs(Text, { fontSize: "$1", color: "$soft", shrink: 0, fontVariant: ['tabular-nums'], children: [w.percent, "%", resets ? ` · Resets ${resets}` : ''] })] }));
+}
+export function UsageMeter({ limits, classes = CLASSES, size = 'md', now }) {
+    const rows = classes.flatMap((c) => {
+        const k = limits.classes[c];
+        return k ? [{ c, k }] : [];
+    });
+    if (!rows.length)
+        return null;
+    const sm = size === 'sm';
+    return (_jsx(YStack, { gap: sm ? '$2.5' : '$5', width: "100%", minW: 0, ...slot('usage-meter'), children: rows.map(({ c, k }) => {
+            const label = CLASS_LABEL[c];
+            const resets = when(k.resets_at, now);
+            const note = caption(k);
+            return (_jsxs(YStack, { gap: sm ? '$1.5' : '$2', minW: 0, "data-class": c, "data-state": k.state, ...slot('usage-meter-row'), children: [_jsxs(XStack, { justify: "space-between", items: "baseline", gap: "$3", minW: 0, children: [_jsx(Text, { fontSize: sm ? '$2' : '$3', color: "$ink", fontWeight: "500", numberOfLines: 1, children: label }), _jsxs(Text, { fontSize: sm ? '$2' : '$3', color: "$ink", fontVariant: ['tabular-nums'], shrink: 0, children: [k.percent, "% used"] })] }), _jsx(Progress, { value: k.percent, height: sm ? 4 : 8, minW: 0, indicatorColor: STATE_COLOR[k.state], "aria-label": `${label}: ${k.percent}% used` }), resets || note ? (_jsxs(XStack, { justify: "space-between", gap: "$3", flexWrap: "wrap", minW: 0, children: [_jsx(Text, { fontSize: sm ? '$1' : '$2', color: "$soft", children: resets ? `Resets ${resets}` : '' }), note ? (_jsx(Text, { fontSize: sm ? '$1' : '$2', color: k.state === 'limited' ? '$bad' : '$soft', children: note })) : null] })) : null, k.window ? _jsx(Session, { label: label, w: k.window, now: now }) : null] }, c));
+        }) }));
+}
+//# sourceMappingURL=UsageMeter.js.map

package/dist/product/UsageMeter.js.map

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

package/dist/product/index.cjs

@@ -202,3 +202,9 @@ var data_1 = require("@hanzo/data");
 Object.defineProperty(exports, "tokens", { enumerable: true, get: function () { return data_1.tokens; } });
 Object.defineProperty(exports, "TAG_TONES", { enumerable: true, get: function () { return data_1.TAG_TONES; } });
 Object.defineProperty(exports, "tagTone", { enumerable: true, get: function () { return data_1.tagTone; } });
+// Plan usage limits — `GET /v1/ai/limits` and the served-call headers, held by
+// `useLimits`; `UsageMeter` draws a class's share, `LimitedBanner` a pause.
+__exportStar(require("./limits.cjs"), exports);
+__exportStar(require("./useLimits.cjs"), exports);
+__exportStar(require("./UsageMeter.cjs"), exports);
+__exportStar(require("./LimitedBanner.cjs"), exports);

package/dist/product/index.d.ts

@@ -64,4 +64,8 @@ export * from './accent.js';
 export * from './color.js';
 export * from './social/index.js';
 export { tokens, TAG_TONES, tagTone, type TagTone } from '@hanzo/data';
+export * from './limits.js';
+export * from './useLimits.js';
+export * from './UsageMeter.js';
+export * from './LimitedBanner.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/product/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/product/index.ts"],"names":[],"mappings":"AAaA,cAAc,UAAU,CAAA;AAKxB,OAAO,EACL,MAAM,EACN,aAAa,EACb,SAAS,EACT,SAAS,IAAI,eAAe,EAC5B,QAAQ,EACR,OAAO,EACP,SAAS,EACT,UAAU,EACV,UAAU,EACV,KAAK,GACN,MAAM,UAAU,CAAA;AAGjB,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AAK/D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,cAAc,mBAAmB,CAAA;AAKjC,OAAO,EACL,UAAU,EACV,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,KAAK,EACL,KAAK,EACL,GAAG,EACH,MAAM,EACN,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,IAAI,GACV,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,UAAU,EACV,UAAU,EACV,OAAO,EACP,UAAU,EACV,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAS/G,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AAKvB,cAAc,QAAQ,CAAA;AAKtB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAK5B,cAAc,QAAQ,CAAA;AACtB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AAOzB,cAAc,cAAc,CAAA;AAK5B,cAAc,YAAY,CAAA;AAO1B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAI7B,cAAc,cAAc,CAAA;AAG5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AAGvB,cAAc,QAAQ,CAAA;AACtB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAM5B,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAG3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAM7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAK/B,cAAc,cAAc,CAAA;AAc5B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AASvB,cAAc,UAAU,CAAA;AAKxB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/product/index.ts"],"names":[],"mappings":"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"}

package/dist/product/index.js

@@ -155,4 +155,10 @@ export * from './social/index.js';
 // @hanzo/data) — the theme this layer renders against. Design-token PRIMITIVES
 // (colors, dark/light, radii, spacing) are the runtime-free `@hanzo/ui/core`.
 export { tokens, TAG_TONES, tagTone } from '@hanzo/data';
+// Plan usage limits — `GET /v1/ai/limits` and the served-call headers, held by
+// `useLimits`; `UsageMeter` draws a class's share, `LimitedBanner` a pause.
+export * from './limits.js';
+export * from './useLimits.js';
+export * from './UsageMeter.js';
+export * from './LimitedBanner.js';
 //# sourceMappingURL=index.js.map

package/dist/product/index.js.map

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

package/dist/product/limits.cjs

@@ -0,0 +1,246 @@
+"use strict";
+// Plan usage limits — `GET /v1/ai/limits`, the served-call headers and the
+// billing refusals, read into one shape. Shares only: a percent per class and
+// when it resets, never an amount or a count.
+//
+// Classes: `premium` is third-party frontier models, `ours` is Hanzo models
+// (zen, enso, kai, jev), `free` is the free lane. State is `ok` below 80 %,
+// `near` from 80 to 99 %, and `limited` when the class is used up and nothing
+// else pays.
+//
+// No React, no gui: this loads in Node and in a server component.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.worst = exports.CLASS_LABEL = exports.CLASSES = void 0;
+exports.actionsOf = actionsOf;
+exports.limitsOf = limitsOf;
+exports.servedOf = servedOf;
+exports.refusalOf = refusalOf;
+exports.classOf = classOf;
+exports.overlay = overlay;
+exports.classesLabel = classesLabel;
+exports.when = when;
+exports.noticeOf = noticeOf;
+exports.nearOf = nearOf;
+exports.CLASSES = ['premium', 'ours', 'free'];
+exports.CLASS_LABEL = {
+    premium: 'Premium models',
+    ours: 'Hanzo models',
+    free: 'Free models',
+};
+const STATES = ['ok', 'near', 'limited'];
+const PAYERS = ['plan', 'prepaid', 'credits', 'none'];
+const PAID = ['plan', 'prepaid', 'credits', 'free'];
+const RANK = { ok: 0, near: 1, limited: 2 };
+const text = (v) => (typeof v === 'string' ? v : null);
+const one = (set, v) => typeof v === 'string' && set.includes(v) ? v : null;
+const record = (v) => v && typeof v === 'object' && !Array.isArray(v) ? v : null;
+/** The worse of two states. */
+const worst = (a, b) => (RANK[b] > RANK[a] ? b : a);
+exports.worst = worst;
+/** A percent as the bar draws it: a whole number from 0 to 100. */
+const share = (v) => typeof v === 'number' && Number.isFinite(v) ? Math.min(100, Math.max(0, Math.round(v))) : null;
+function windowOf(v) {
+    const o = record(v);
+    const percent = share(o?.percent);
+    if (percent === null)
+        return null;
+    return {
+        percent,
+        state: one(STATES, o?.state) ?? (percent >= 80 ? 'near' : 'ok'),
+        resets_at: text(o?.resets_at),
+    };
+}
+function classOfBody(v) {
+    const w = windowOf(v);
+    if (!w)
+        return null;
+    const o = record(v);
+    const short = windowOf(o?.window);
+    return { ...w, paying: one(PAYERS, o?.paying) ?? 'plan', ...(short ? { window: short } : {}) };
+}
+function actionsOf(v) {
+    if (!Array.isArray(v))
+        return [];
+    return v.flatMap((a) => {
+        const o = record(a);
+        const kind = one(['upgrade', 'topup'], o?.kind);
+        const url = text(o?.url);
+        if (!kind || !url)
+            return [];
+        const plan = text(o?.plan);
+        return [{ kind, label: text(o?.label) || (kind === 'upgrade' ? 'Upgrade' : 'Add prepaid credit'), url, ...(plan ? { plan } : {}) }];
+    });
+}
+const classList = (v) => Array.isArray(v) ? v.flatMap((c) => (one(exports.CLASSES, c) ? [c] : [])) : [];
+/**
+ * `GET /v1/ai/limits`, checked field by field. A body without a string `plan`
+ * is not an answer; a class without a numeric percent is left out rather than
+ * drawn full or empty.
+ */
+function limitsOf(body) {
+    const o = record(body);
+    const plan = text(o?.plan);
+    if (plan === null)
+        return null;
+    const classes = {};
+    const raw = record(o?.classes);
+    for (const c of exports.CLASSES) {
+        const got = classOfBody(raw?.[c]);
+        if (got)
+            classes[c] = got;
+    }
+    const lim = record(o?.limited);
+    const limited = lim
+        ? { reason: text(lim.reason) ?? '', classes: classList(lim.classes), message: text(lim.message) ?? '' }
+        : undefined;
+    const state = one(STATES, o?.state) ??
+        Object.values(classes).reduce((s, c) => (0, exports.worst)(s, c ? (0, exports.worst)(c.state, c.window?.state ?? 'ok') : 'ok'), 'ok');
+    return {
+        plan,
+        period_start: text(o?.period_start) ?? undefined,
+        period_end: text(o?.period_end) ?? undefined,
+        state,
+        classes,
+        ...(limited ? { limited } : {}),
+        actions: actionsOf(o?.actions),
+        upgrade: text(o?.upgrade) ?? undefined,
+    };
+}
+/** The usage headers on a served call, or null when it carries none. */
+function servedOf(headers) {
+    const usage = one(STATES, headers.get('x-hanzo-usage'));
+    const fallback = headers.get('x-hanzo-fallback') || null;
+    if (!usage && !fallback)
+        return null;
+    return {
+        state: usage ?? 'limited',
+        class: one(exports.CLASSES, headers.get('x-hanzo-usage-class')),
+        paidBy: one(PAID, headers.get('x-hanzo-paid-by')),
+        fallback,
+        reason: headers.get('x-hanzo-usage-reason') || null,
+    };
+}
+/** A billing refusal's envelope, or null for any other error. */
+function refusalOf(body, status, retryAfter) {
+    const e = record(record(body)?.error);
+    if (!e || e.type !== 'billing_error')
+        return null;
+    const retry = retryAfter ? Number(retryAfter) : NaN;
+    return {
+        status,
+        code: text(e.code) ?? '',
+        message: text(e.message) ?? '',
+        class: one(exports.CLASSES, e.class),
+        resets_at: text(e.resets_at),
+        actions: actionsOf(e.actions),
+        retry: Number.isFinite(retry) ? retry : null,
+    };
+}
+/**
+ * Which class a model id bills to. Hanzo's own families are `ours`, anything
+ * naming the free lane is `free`, and every other model is `premium`.
+ */
+function classOf(id) {
+    const bare = id.toLowerCase().replace(/^hanzo\//, '');
+    if (bare === 'free' || /(^|[-/:])free($|[-/:])/.test(bare))
+        return 'free';
+    if (/^(zen|enso|kai|jev)([-.:/0-9]|$)/.test(bare))
+        return 'ours';
+    return 'premium';
+}
+/** The limits with what served calls said since they were read laid over them. */
+function overlay(limits, heard) {
+    if (!limits)
+        return null;
+    const classes = { ...limits.classes };
+    const { served, refusal } = heard;
+    if (served?.class && classes[served.class]) {
+        const c = classes[served.class];
+        classes[served.class] = { ...c, state: served.state };
+    }
+    if (refusal?.class && classes[refusal.class]) {
+        const c = classes[refusal.class];
+        classes[refusal.class] = { ...c, state: 'limited', paying: 'none', resets_at: refusal.resets_at ?? c.resets_at };
+    }
+    const state = Object.values(classes).reduce((s, c) => (0, exports.worst)(s, c ? (0, exports.worst)(c.state, c.window?.state ?? 'ok') : 'ok'), heard.served || heard.refusal ? 'ok' : limits.state);
+    return { ...limits, classes, state: (0, exports.worst)(state, refusal ? 'limited' : 'ok') };
+}
+/** The binding reset of a class: its short window's when that is the one used up. */
+const resetOf = (c) => !c ? null : c.window && RANK[c.window.state] > RANK[c.state] ? c.window.resets_at : c.resets_at;
+const earliest = (all) => all.reduce((a, b) => (!b ? a : !a || Date.parse(b) < Date.parse(a) ? b : a), null);
+/** "Premium models", "Premium and Hanzo models". */
+function classesLabel(classes) {
+    const names = exports.CLASSES.filter((c) => classes.includes(c)).map((c) => exports.CLASS_LABEL[c].replace(/ models$/, ''));
+    if (!names.length)
+        return 'Models';
+    const last = names.pop();
+    return `${names.length ? `${names.join(', ')} and ${last}` : last} models`;
+}
+/**
+ * When a reset lands, as a sentence says it: a time for one within a day
+ * ("5:00 PM"), else a date ("Oct 30"), periods being UTC days. "" for none.
+ */
+function when(iso, now = Date.now()) {
+    const t = iso ? Date.parse(iso) : NaN;
+    if (Number.isNaN(t))
+        return '';
+    const d = new Date(t);
+    return t - now < 86_400_000
+        ? d.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit' })
+        : d.toLocaleDateString('en-US', { timeZone: 'UTC', month: 'short', day: 'numeric' });
+}
+const PLAIN = {
+    paid_plan_required: 'Premium models need a paid plan.',
+    free_plan_cap: "You've used the free plan's usage for now.",
+    insufficient_balance: 'Your prepaid credit has run out.',
+};
+/**
+ * What to tell a reader whose usage is paused or refused, or null when nothing
+ * is. A plan's included usage being used up reads as a pause until the reset;
+ * any other reason is the server's own message. A fallback reply adds the free
+ * model it was answered on, named by `name`.
+ */
+function noticeOf(limits, heard, name = (id) => id, now = Date.now()) {
+    const { served, refusal } = heard;
+    const fallback = served?.fallback ?? null;
+    const classes = new Set(limits?.limited?.classes ?? []);
+    for (const c of exports.CLASSES)
+        if (c !== 'free' && limits?.classes[c]?.state === 'limited')
+            classes.add(c);
+    if (refusal?.class)
+        classes.add(refusal.class);
+    if (fallback && served?.class && served.class !== 'free')
+        classes.add(served.class);
+    if (!refusal && !fallback && !limits?.limited && limits?.state !== 'limited')
+        return null;
+    const list = exports.CLASSES.filter((c) => classes.has(c));
+    const reason = refusal?.code || limits?.limited?.reason || served?.reason || '';
+    const resets = earliest([...list.map((c) => resetOf(limits?.classes[c])), refusal?.resets_at ?? null]);
+    const paused = reason === 'plan_allowance_used' || (!reason && list.length > 0);
+    const until = when(resets, now);
+    const said = paused
+        ? `${classesLabel(list)} are paused${until ? ` until ${until}` : ''}.`
+        : refusal?.message || limits?.limited?.message || PLAIN[reason] || 'Usage is paused for now.';
+    return {
+        reason,
+        classes: list,
+        message: fallback ? `${said} You're chatting on ${name(fallback)}.` : said,
+        actions: limits?.actions.length ? limits.actions : (refusal?.actions ?? []),
+        resets_at: resets,
+        fallback,
+    };
+}
+/** The one-line note for a class close to its included usage, or null. */
+function nearOf(limits, now = Date.now()) {
+    if (!limits || limits.state === 'limited')
+        return null;
+    const near = exports.CLASSES.filter((c) => {
+        const k = limits.classes[c];
+        return c !== 'free' && k && (k.state === 'near' || k.window?.state === 'near');
+    });
+    if (!near.length)
+        return null;
+    const until = when(earliest(near.map((c) => resetOf(limits.classes[c]))), now);
+    const what = classesLabel(near).replace(/ models$/, '').replace('Premium', 'premium');
+    return `You're close to your plan's included ${what} model usage.${until ? ` Resets ${until}.` : ''}`;
+}

package/dist/product/limits.d.ts

@@ -0,0 +1,113 @@
+export type LimitState = 'ok' | 'near' | 'limited';
+export type LimitClass = 'premium' | 'ours' | 'free';
+export type LimitPayer = 'plan' | 'prepaid' | 'credits' | 'none';
+export type PaidBy = 'plan' | 'prepaid' | 'credits' | 'free';
+export type LimitReason = 'plan_allowance_used' | 'paid_plan_required' | 'free_plan_cap' | 'insufficient_balance';
+/** A share of one window: percent used, its state, and when it starts over. */
+export interface LimitWindow {
+    percent: number;
+    state: LimitState;
+    resets_at: string | null;
+}
+/** One class over the billing period, who pays for it now, and its short window if any. */
+export interface ClassLimit extends LimitWindow {
+    paying: LimitPayer;
+    window?: LimitWindow;
+}
+export interface LimitAction {
+    kind: 'upgrade' | 'topup';
+    label: string;
+    plan?: string;
+    url: string;
+}
+export interface Limited {
+    reason: string;
+    classes: LimitClass[];
+    message: string;
+}
+export interface Limits {
+    /** The plan slug, or "" for a caller with no plan. */
+    plan: string;
+    period_start?: string;
+    period_end?: string;
+    state: LimitState;
+    classes: Partial<Record<LimitClass, ClassLimit>>;
+    limited?: Limited;
+    actions: LimitAction[];
+    upgrade?: string;
+}
+/** What a served call's headers say. */
+export interface Served {
+    state: LimitState;
+    class: LimitClass | null;
+    paidBy: PaidBy | null;
+    /** The free model that answered in place of the one asked for. */
+    fallback: string | null;
+    reason: string | null;
+}
+/** A billing refusal: `{"error":{"type":"billing_error",…}}` on a 402 or 429. */
+export interface Refusal {
+    status: number;
+    code: string;
+    message: string;
+    class: LimitClass | null;
+    resets_at: string | null;
+    actions: LimitAction[];
+    /** Seconds, from Retry-After on a 429. */
+    retry: number | null;
+}
+/** What the reader is told when a class is paused or refused. */
+export interface LimitNotice {
+    reason: string;
+    classes: LimitClass[];
+    message: string;
+    actions: LimitAction[];
+    resets_at: string | null;
+    fallback: string | null;
+}
+export declare const CLASSES: readonly LimitClass[];
+export declare const CLASS_LABEL: Record<LimitClass, string>;
+/** The worse of two states. */
+export declare const worst: (a: LimitState, b: LimitState) => LimitState;
+export declare function actionsOf(v: unknown): LimitAction[];
+/**
+ * `GET /v1/ai/limits`, checked field by field. A body without a string `plan`
+ * is not an answer; a class without a numeric percent is left out rather than
+ * drawn full or empty.
+ */
+export declare function limitsOf(body: unknown): Limits | null;
+/** The usage headers on a served call, or null when it carries none. */
+export declare function servedOf(headers: {
+    get(name: string): string | null;
+}): Served | null;
+/** A billing refusal's envelope, or null for any other error. */
+export declare function refusalOf(body: unknown, status: number, retryAfter?: string | null): Refusal | null;
+/**
+ * Which class a model id bills to. Hanzo's own families are `ours`, anything
+ * naming the free lane is `free`, and every other model is `premium`.
+ */
+export declare function classOf(id: string): LimitClass;
+/** The headers and refusal heard since the limits were last read. */
+export interface Heard {
+    served: Served | null;
+    refusal: Refusal | null;
+}
+/** The limits with what served calls said since they were read laid over them. */
+export declare function overlay(limits: Limits | null, heard: Heard): Limits | null;
+/** "Premium models", "Premium and Hanzo models". */
+export declare function classesLabel(classes: LimitClass[]): string;
+/**
+ * When a reset lands, as a sentence says it: a time for one within a day
+ * ("5:00 PM"), else a date ("Oct 30"), periods being UTC days. "" for none.
+ */
+export declare function when(iso: string | null | undefined, now?: number): string;
+/**
+ * What to tell a reader whose usage is paused or refused, or null when nothing
+ * is. A plan's included usage being used up reads as a pause until the reset;
+ * any other reason is the server's own message. A fallback reply adds the free
+ * model it was answered on, named by `name`.
+ */
+export declare function noticeOf(limits: Limits | null, heard: Heard, name?: (id: string) => string, now?: number): LimitNotice | null;
+/** The one-line note for a class close to its included usage, or null. */
+export declare function nearOf(limits: Limits | null, now?: number): string | null;
+//# sourceMappingURL=limits.d.ts.map

package/dist/product/limits.d.ts.map

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