@cortexkit/opencode-openai-auth 0.11.1 → 1.0.0

package/src/tui-compiled/raw/tui.tsx

@@ -1,13 +1,14 @@
 /** @jsxImportSource @opentui/solid */
 
-import { readFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { readFileSync } from "node:fs"
+import { dirname, join } from "node:path"
+import { fileURLToPath } from "node:url"
+import { formatQuota, quotaTextParts } from "./shared/d5a8f1061ee2f114-index.js"
 import type {
   TuiPlugin,
   TuiPluginApi,
   TuiPluginModule,
-} from '@opencode-ai/plugin/tui'
+} from "@opencode-ai/plugin/tui"
 import {
   createEffect,
   createSignal,
@@ -15,11 +16,11 @@ import {
   type JSX,
   onCleanup,
   Show,
-} from 'solid-js'
-import { createLogger } from './logger.ts'
-import type { ApplyRequest, CommandModalName } from './rpc-protocol.ts'
-import { createRpcClient } from './rpc-rpc-client.ts'
-import { resolveRpcDir } from './rpc-rpc-dir.ts'
+} from "solid-js"
+import { createLogger } from "./logger.js"
+import { type ApplyRequest, isNotifyPayload } from "./rpc/protocol.js"
+import { createRpcClient } from "./rpc/rpc-client.js"
+import { resolveRpcDir } from "./rpc/rpc-dir.js"
 import {
   type AccountQuota,
   computeQuotaPacing,
@@ -34,8 +35,9 @@ import {
   resolveSessionStickyAccount,
   type SidebarState,
   type SpendControlReading,
-} from './sidebar-state.ts'
-import { openCommandDialog } from './tui-command-dialogs.tsx'
+  sidebarQuotaProjection,
+} from "./sidebar-state.js"
+import { openCommandDialog } from "./tui/command-dialogs.tsx"
 import {
   type AppearancePrefs,
   computeEffectiveOrder,
@@ -46,7 +48,7 @@ import {
   readTuiPreferencesFile,
   resolveOpenaiAuthPrefs,
   watchTuiPreferences,
-} from './tui-preferences.ts'
+} from "./tui-preferences.js"
 
 const RPC_POLL_MS = 500
 let rpcPollStarted = false
@@ -54,14 +56,20 @@ const log = createLogger('rpc-tui')
 
 const ID = 'cortexkit.openai-auth'
 
+/** One drawer action as the RPC apply request carries it, with its session. */
 export function buildApplyRequest(
-  command: CommandModalName,
-  arguments_: string,
+  request: Omit<ApplyRequest, 'sessionId'>,
   sessionId?: string,
 ): ApplyRequest {
-  return { command, arguments: arguments_, sessionId }
+  return { ...request, ...(sessionId !== undefined ? { sessionId } : {}) }
 }
 
+/**
+ * How long the drawer waits for one action: a reset-credit redemption polls
+ * the provider and can take most of this.
+ */
+const MENU_APPLY_TIMEOUT_MS = 90_000
+
 // Read package metadata from the development source or either generated TUI
 // variant. Avoid a JSON import because package.json sits outside the declaration
 // build's rootDir.
@@ -245,6 +253,7 @@ export interface QuotaDisplayRow {
   key: 'primary' | 'secondary' | 'spendControl'
   label: string
   labelWidth: number
+  text: string
   window: QuotaWindow
   pacing: QuotaPacing | null
 }
@@ -276,7 +285,16 @@ function quotaRowLabels(quota: AccountQuota | null): string[] {
 export function renderedQuotas(state: {
   main?: { quota?: AccountQuota | null } | null
   fallbacks?: ReadonlyArray<{ enabled?: boolean; quota?: AccountQuota | null }>
+  vaultAccounts?: ReadonlyArray<{
+    enabled?: boolean
+    quota?: AccountQuota | null
+  }>
 }): ReadonlyArray<AccountQuota | null | undefined> {
+  // In vault mode only the vault accounts are rendered.
+  if (state.vaultAccounts !== undefined)
+    return state.vaultAccounts
+      .filter((account) => account.enabled)
+      .map((account) => account.quota)
   return [
     state.main?.quota ?? null,
     ...(state.fallbacks ?? [])
@@ -307,11 +325,20 @@ export function buildQuotaRowsForDisplay(
   pacingEnabled: boolean,
   labelWidth?: number,
 ): QuotaDisplayRow[] {
+  const projection = sidebarQuotaProjection(quota, now)
   const rows: Array<Omit<QuotaDisplayRow, 'labelWidth'>> =
     getPresentQuotaWindows(quota).map((row) => ({
       key: row.key,
       label: row.label,
       window: row.window,
+      text: formatQuota(
+        projection && {
+          ...projection,
+          budget: undefined,
+          limits: projection.limits.filter((limit) => limit.label === row.key),
+        },
+        { now, form: 'compact', staleAfterMs: Number.POSITIVE_INFINITY },
+      ),
       pacing:
         pacingEnabled && row.windowMs !== null
           ? computeQuotaPacing(row.window, row.windowMs, now)
@@ -322,6 +349,11 @@ export function buildQuotaRowsForDisplay(
     rows.push({
       key: 'spendControl',
       label: SPEND_CONTROL_LABEL,
+      text: formatQuota(projection && { ...projection, limits: [] }, {
+        now,
+        form: 'compact',
+        staleAfterMs: Number.POSITIVE_INFINITY,
+      }),
       window: {
         usedPercent: spendControl.usedPercent,
         remainingPercent: spendControl.remainingPercent,
@@ -332,6 +364,14 @@ export function buildQuotaRowsForDisplay(
   }
   const width =
     labelWidth ?? Math.max(3, ...rows.map((row) => row.label.length + 1))
+  const parts = quotaTextParts(projection, {
+    now,
+    form: 'compact',
+    staleAfterMs: Number.POSITIVE_INFINITY,
+  })
+  rows.sort(
+    (left, right) => parts.indexOf(left.text) - parts.indexOf(right.text),
+  )
   return rows.map((row) => ({ ...row, labelWidth: width }))
 }
 
@@ -385,8 +425,8 @@ export function getAccountMetadataRows(
   return rows
 }
 
-// Quota window row: muted label left, tone-colored bar + percentage right,
-// with an optional muted reset suffix. When pacing data is present, the bar
+// Quota window row: muted label left, tone-colored usage bar and shared quota text.
+// When pacing data is present, the bar
 // gains a pace segment and an off-pace window adds a muted subline with the
 // reserve/deficit delta and the projected runout.
 function QuotaRow(props: {
@@ -394,11 +434,11 @@ function QuotaRow(props: {
   appearance: AppearancePrefs
   label: string
   labelWidth: number
+  text: string
   window: { usedPercent: number; resetsAt?: string } | undefined
   pacing: QuotaPacing | null
 }) {
   const used = () => props.window?.usedPercent ?? 0
-  const reset = () => formatResetIn(props.window?.resetsAt)
   const paceLine = () => {
     const pacing = props.pacing
     if (!pacing || pacing.state === 'on-pace') return null
@@ -420,9 +460,7 @@ function QuotaRow(props: {
         </box>
       }
     >
-      {/* Left group (label · bar · pct) stays left-aligned in fixed columns so
-          bars and percentages line up across rows; the reset time is pushed to
-          the right edge so reset times align in their own right column. */}
+      {/* Bars show usage; the adjacent figure shows quota left, as in the dialog. */}
       <box width='100%' flexDirection='row' justifyContent='space-between'>
         <box flexDirection='row'>
           <text fg={props.theme.textMuted}>
@@ -438,12 +476,9 @@ function QuotaRow(props: {
           <text
             fg={toneColor(props.theme, usageTone(used(), props.appearance))}
           >
-            {` ${String(Math.round(used())).padStart(3)}%`}
+            {` ${props.text.slice(props.label.length + 1)}`}
           </text>
         </box>
-        <Show when={reset()}>
-          <text fg={props.theme.textMuted}>{reset()}</text>
-        </Show>
       </box>
       <Show when={paceLine()}>
         <box width='100%' flexDirection='row'>
@@ -513,6 +548,7 @@ function AccountBlock(props: {
                 appearance={props.appearance}
                 label={row.label}
                 labelWidth={row.labelWidth}
+                text={row.text}
                 window={row.window}
                 pacing={row.pacing}
               />
@@ -520,6 +556,14 @@ function AccountBlock(props: {
           </For>
         </Show>
       </Show>
+      <For
+        each={quotaTextParts(sidebarQuotaProjection(props.quota, Date.now()), {
+          now: Date.now(),
+          form: 'compact',
+        }).filter((part) => part.startsWith('checked '))}
+      >
+        {(age) => <text fg={props.theme.textMuted}>{age}</text>}
+      </For>
       <For
         each={getAccountMetadataRows(
           props.resetCredits,
@@ -539,77 +583,6 @@ function AccountBlock(props: {
   )
 }
 
-// --- Quota dialog content ---------------------------------------------------
-
-// Renders the same rich visualization as the sidebar (account blocks with
-// quota bars + pacing) so the modal matches the sidebar look.
-function QuotaDialogContent(props: {
-  api: TuiPluginApi
-  controller: SidebarController
-  sessionId: string | undefined
-}) {
-  const prefs = props.controller.prefs
-  const [state, setState] = createSignal<SidebarState>(DEFAULT_SIDEBAR_STATE)
-  let lastUpdated = 0
-  async function refresh() {
-    const next = await readStateFromFile()
-    if (next.lastUpdated !== lastUpdated) {
-      lastUpdated = next.lastUpdated
-      setState(next)
-    }
-  }
-  createEffect(() => {
-    const timer = setInterval(refresh, prefs().pollMs)
-    onCleanup(() => clearInterval(timer))
-  })
-  setTimeout(refresh, 0)
-  const theme = () => props.api.theme.current
-  const enabledFallbacks = () =>
-    (state().fallbacks ?? []).filter((f) => f.enabled)
-  const activeId = () => resolveQuotaDialogActiveId(state(), props.sessionId)
-  const quotaLabelWidth = () => computeQuotaLabelWidth(renderedQuotas(state()))
-  return (
-    <box flexDirection='column' padding={2} width='100%' alignItems='center'>
-      <box flexDirection='column' width={58}>
-        <box width='100%' justifyContent='center' marginBottom={1}>
-          <text fg={theme().text}>
-            <b>Codex Quota</b>
-          </text>
-        </box>
-        <AccountBlock
-          theme={theme()}
-          appearance={prefs().appearance}
-          name='main'
-          quota={state().main?.quota ?? null}
-          killed={state().main?.killed ?? false}
-          active={activeId() === 'main'}
-          pacingEnabled={prefs().sections.pacing}
-          labelWidth={quotaLabelWidth()}
-          resetCredits={state().main?.resetCredits}
-        />
-        <Show when={prefs().sections.fallbackAccounts}>
-          <For each={enabledFallbacks()}>
-            {(fb) => (
-              <AccountBlock
-                theme={theme()}
-                appearance={prefs().appearance}
-                name={fb.label ?? fb.id}
-                quota={fb.quota}
-                killed={fb.killed}
-                active={activeId() === fb.id}
-                pacingEnabled={prefs().sections.pacing}
-                labelWidth={quotaLabelWidth()}
-                resetCredits={fb.resetCredits}
-                marginTop={1}
-              />
-            )}
-          </For>
-        </Show>
-      </box>
-    </box>
-  )
-}
-
 // --- State plumbing ---------------------------------------------------------
 
 export async function readStateFromFile(): Promise<SidebarState> {
@@ -764,8 +737,15 @@ function QuotaSidebar(props: {
   const theme = () => props.api.theme.current
   const enabledFallbacks = () =>
     (state().fallbacks ?? []).filter((f) => f.enabled)
+  // Vault mode: the host uses only the vault's accounts, which the file lists
+  // in `vaultAccounts`; main and the local fallbacks are not shown.
+  const vaultMode = () => state().vaultAccounts !== undefined
+  const enabledVaultAccounts = () =>
+    (state().vaultAccounts ?? []).filter((account) => account.enabled)
   const hasData = () =>
-    state().main?.quota != null || enabledFallbacks().length > 0
+    vaultMode()
+      ? enabledVaultAccounts().length > 0
+      : state().main?.quota != null || enabledFallbacks().length > 0
 
   const headerLabel = () => {
     const name = prefs().header.label
@@ -904,34 +884,56 @@ function QuotaSidebar(props: {
           {/* Quota */}
           <Show when={prefs().sections.quota}>
             <SectionHeader theme={theme()} title='Quota' />
-            <AccountBlock
-              theme={theme()}
-              appearance={prefs().appearance}
-              name='main'
-              quota={state().main?.quota ?? null}
-              killed={state().main?.killed ?? false}
-              active={sessionRouting().activeId === 'main'}
-              pacingEnabled={prefs().sections.pacing}
-              labelWidth={quotaLabelWidth()}
-              resetCredits={state().main?.resetCredits}
-            />
-            <Show when={prefs().sections.fallbackAccounts}>
-              <For each={enabledFallbacks()}>
-                {(fb) => (
-                  <AccountBlock
-                    theme={theme()}
-                    appearance={prefs().appearance}
-                    name={fb.label ?? fb.id}
-                    quota={fb.quota}
-                    killed={fb.killed}
-                    active={sessionRouting().activeId === fb.id}
-                    pacingEnabled={prefs().sections.pacing}
-                    labelWidth={quotaLabelWidth()}
-                    resetCredits={fb.resetCredits}
-                    marginTop={1}
-                  />
-                )}
-              </For>
+            <Show
+              when={!vaultMode()}
+              fallback={
+                <For each={enabledVaultAccounts()}>
+                  {(account, index) => (
+                    <AccountBlock
+                      theme={theme()}
+                      appearance={prefs().appearance}
+                      name={account.label ?? account.id}
+                      quota={account.quota}
+                      killed={account.killed}
+                      active={sessionRouting().activeId === account.id}
+                      pacingEnabled={prefs().sections.pacing}
+                      labelWidth={quotaLabelWidth()}
+                      resetCredits={account.resetCredits}
+                      marginTop={index() === 0 ? 0 : 1}
+                    />
+                  )}
+                </For>
+              }
+            >
+              <AccountBlock
+                theme={theme()}
+                appearance={prefs().appearance}
+                name='main'
+                quota={state().main?.quota ?? null}
+                killed={state().main?.killed ?? false}
+                active={sessionRouting().activeId === 'main'}
+                pacingEnabled={prefs().sections.pacing}
+                labelWidth={quotaLabelWidth()}
+                resetCredits={state().main?.resetCredits}
+              />
+              <Show when={prefs().sections.fallbackAccounts}>
+                <For each={enabledFallbacks()}>
+                  {(fb) => (
+                    <AccountBlock
+                      theme={theme()}
+                      appearance={prefs().appearance}
+                      name={fb.label ?? fb.id}
+                      quota={fb.quota}
+                      killed={fb.killed}
+                      active={sessionRouting().activeId === fb.id}
+                      pacingEnabled={prefs().sections.pacing}
+                      labelWidth={quotaLabelWidth()}
+                      resetCredits={fb.resetCredits}
+                      marginTop={1}
+                    />
+                  )}
+                </For>
+              </Show>
             </Show>
           </Show>
         </Show>
@@ -1041,26 +1043,16 @@ const tui: TuiPlugin = async (api) => {
         .then((messages) => {
           for (const message of [...messages].sort((a, b) => a.id - b.id)) {
             lastNotificationId = Math.max(lastNotificationId, message.id)
-            if (message.payload.command === 'openai-quota') {
-              api.ui.dialog.setSize('xlarge')
-              api.ui.dialog.replace(() => (
-                <QuotaDialogContent
-                  api={api}
-                  controller={controller}
-                  sessionId={sessionId}
-                />
-              ))
+            const payload = message.payload
+            if (isNotifyPayload(payload)) {
+              api.ui.toast({ message: payload.notify.message })
               continue
             }
-            openCommandDialog(
-              api,
-              message.payload,
-              (command, args) =>
-                rpcClient.apply(
-                  buildApplyRequest(command, args, sessionId),
-                  command === 'openai-reset' ? 90_000 : undefined,
-                ),
-              sessionId,
+            openCommandDialog(api, payload, (request) =>
+              rpcClient.apply(
+                buildApplyRequest(request, sessionId),
+                MENU_APPLY_TIMEOUT_MS,
+              ),
             )
           }
         })

package/src/tui-compiled/runtime/logger.js

@@ -0,0 +1,24 @@
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import {
+  flushLogs,
+  initLogger
+} from "./shared/3c2d4169d00f907e-tui-support.js";
+export {
+  createLogger,
+  flushForTest,
+  flushLogs,
+  redact,
+  redactStrings,
+  setLogLevel
+} from "./shared/3c2d4169d00f907e-tui-support.js";
+const LEVELS = ["error", "warn", "info", "debug", "trace"];
+export function getLogFile() {
+  return process.env.OPENCODE_OPENAI_AUTH_LOG_FILE ?? join(tmpdir(), "opencode-openai-auth.log");
+}
+export function getEnvLogLevel() {
+  const env = process.env.OPENCODE_OPENAI_AUTH_LOG_LEVEL;
+  return env && LEVELS.includes(env) ? env : void 0;
+}
+initLogger({ file: getLogFile, level: getEnvLogLevel });
+process.on("exit", flushLogs);

package/src/tui-compiled/runtime/rpc/protocol.js

@@ -0,0 +1,3 @@
+export {
+  isNotifyPayload
+} from "../shared/3c2d4169d00f907e-tui-support.js";

package/src/tui-compiled/runtime/rpc/rpc-client.js

@@ -0,0 +1,7 @@
+import {
+  createRpcClient as createCommonRpcClient
+} from "../shared/46f3dff1266160e8-client.js";
+export { DEFAULT_RPC_TIMEOUT_MS } from "../shared/46f3dff1266160e8-client.js";
+export function createRpcClient(dir, expectedPid, onSelected) {
+  return createCommonRpcClient(dir, expectedPid, onSelected);
+}

package/src/tui-compiled/runtime/rpc/rpc-dir.js

@@ -0,0 +1,27 @@
+import { createHash } from "node:crypto";
+import { homedir, tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+const RPC_DIR_ENV = "OPENCODE_OPENAI_AUTH_RPC_DIR";
+export const RPC_DIRECTORY_PREFIX = "openai-auth-";
+function rpcHash(projectDirectory) {
+  return createHash("sha256").update(projectDirectory).digest("hex").slice(0, 16);
+}
+function defaultRpcRoot() {
+  const base = process.env.XDG_STATE_HOME || join(homedir(), ".local", "state");
+  return join(base, "cortexkit", "openai-auth", "rpc");
+}
+export function getRpcDir(projectDirectory) {
+  const override = process.env[RPC_DIR_ENV]?.trim();
+  if (override)
+    return resolve(projectDirectory, override);
+  return join(defaultRpcRoot(), `${RPC_DIRECTORY_PREFIX}${rpcHash(projectDirectory)}`);
+}
+export async function resolveRpcDir(projectDirectory) {
+  const override = process.env[RPC_DIR_ENV]?.trim();
+  if (override)
+    return { dir: resolve(projectDirectory, override), secureDir: !1 };
+  const dir = getRpcDir(projectDirectory);
+  return { dir, secureDir: !0, sweepRoot: dirname(dir) };
+}
+
+export { tmpdir };

package/src/tui-compiled/runtime/selector.js

@@ -0,0 +1,21 @@
+import { isAbsolute } from 'node:path';
+export async function loadTui({ rawEntry, runtimeEntry, importModule = (entry) => import(entry), }) {
+    for (const [option, entry] of Object.entries({ rawEntry, runtimeEntry })) {
+        if (!isAbsolute(entry) &&
+            !(entry.startsWith('file:') && new URL(entry).pathname.startsWith('/'))) {
+            throw new Error(`${option} must be an absolute path or file URL: ${entry}`);
+        }
+    }
+    let entry = runtimeEntry;
+    try {
+        await importModule(`opentui:runtime-module:${encodeURIComponent('@opentui/solid')}`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (!/Cannot find|Could not resolve|Module not found|Unable to resolve/.test(message) ||
+            !message.includes('opentui:runtime-module:'))
+            throw error;
+        entry = rawEntry;
+    }
+    return (await importModule(entry)).default;
+}

package/src/tui-compiled/runtime/shared/0332701351b3eeec-format.js

@@ -0,0 +1,138 @@
+// The one quota wording every surface shows: the command menu's dialogs on
+// OpenCode and Pi, the terminal auth menu, and the plugins' sidebars. Each of
+// them calls `formatQuota` (or `quotaTextParts` for one line per window), so
+// the wording cannot drift between plugins or between a dialog and a sidebar.
+//
+// The rules: a window is named by its length (`5h`, `7d`), or, for a window
+// that binds only one model family, by the label the plugin stored it under.
+// Every figure is "% left". A window the provider did not report (an absence
+// record or a retirement tombstone) is left out rather than written as "not
+// reported". A reset is a short time from now (`resets 2h`). A reading older
+// than fifteen minutes says how old it is (`checked 3h ago`).
+//
+// Like the rest of this module it reads no clock: `now` is a parameter.
+import { ALL_SCOPE } from "./905bffc0220f43d0-map.js";
+/** A reading older than this is marked with its age. */
+export const QUOTA_STALE_AFTER_MS = 15 * 60_000;
+/** What `formatQuota` returns when there is no reading at all. */
+export const NO_QUOTA_READING = 'no quota reading yet';
+/**
+ * What `formatQuota` returns when the provider answered but reported no
+ * limit for any window (every window is an absence record or a tombstone).
+ */
+export const NO_LIMITS_REPORTED = 'no limits reported';
+/**
+ * A length or a time span in its largest whole-ish unit: `45m`, `5h`, `3d`.
+ * Spans under an hour are minutes, under a day hours, otherwise days, each
+ * rounded to the nearest unit and never shown as zero.
+ */
+function shortSpan(ms) {
+    const minutes = Math.max(1, Math.round(ms / 60_000));
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.round(minutes / 60);
+    if (hours < 24)
+        return `${hours}h`;
+    return `${Math.max(1, Math.round(minutes / 1440))}d`;
+}
+/** A stored window length in minutes as its exact name: `5h`, `7d`, `90m`. */
+function lengthName(minutes) {
+    if (minutes % 1440 === 0)
+        return `${minutes / 1440}d`;
+    if (minutes % 60 === 0)
+        return `${minutes / 60}h`;
+    return `${minutes}m`;
+}
+/**
+ * The name a window is shown under. A general window (scope `all`) is named
+ * by its stored length; a model-scoped window keeps the label the plugin
+ * stored it under, which already names the model (`seven_day_opus`). A
+ * general window stored without a length (a snapshot from before lengths
+ * were recorded) falls back to its label.
+ */
+export function quotaWindowName(limit) {
+    if (limit.scope !== ALL_SCOPE || limit.windowMinutes === undefined)
+        return limit.label;
+    return lengthName(limit.windowMinutes);
+}
+function percentLeft(remaining) {
+    return `${Math.round(Math.min(100, Math.max(0, remaining)))}% left`;
+}
+function resetText(resetsAt, now) {
+    if (resetsAt === undefined)
+        return '';
+    const at = Date.parse(resetsAt);
+    // A reset already passed says nothing about the future; leave it out.
+    if (!Number.isFinite(at) || at <= now)
+        return '';
+    return `, resets ${shortSpan(at - now)}`;
+}
+/** Shortest window first, so `5h` reads before `7d`; unknown lengths last. */
+function displayOrder(left, right) {
+    const l = left.windowMinutes;
+    const r = right.windowMinutes;
+    if (l !== undefined && r !== undefined && l !== r)
+        return l - r;
+    if ((l === undefined) !== (r === undefined))
+        return l === undefined ? 1 : -1;
+    if (left.scope !== right.scope) {
+        if (left.scope === ALL_SCOPE)
+            return -1;
+        if (right.scope === ALL_SCOPE)
+            return 1;
+        return left.scope < right.scope ? -1 : 1;
+    }
+    return left.label < right.label ? -1 : left.label > right.label ? 1 : 0;
+}
+/**
+ * The pieces of a quota text, in order: one per reported window
+ * (`5h 58% left, resets 2h`), then the credit budget when there is one, then
+ * `checked 3h ago` when the oldest piece shown is stale. Empty when nothing
+ * was reported; `formatQuota` turns that into a sentence. A caller printing
+ * one line per window (the terminal auth menu) uses these directly.
+ */
+export function quotaTextParts(quota, options) {
+    if (!quota)
+        return [];
+    const { now } = options;
+    const full = (options.form ?? 'full') === 'full';
+    const parts = [];
+    const times = [];
+    const readings = quota.limits
+        .filter((limit) => limit.kind === 'reading' && limit.remainingPercent !== undefined)
+        .sort(displayOrder);
+    for (const limit of readings) {
+        times.push(limit.checkedAt);
+        parts.push(`${quotaWindowName(limit)} ${percentLeft(limit.remainingPercent ?? 0)}${full ? resetText(limit.resetsAt, now) : ''}`);
+    }
+    const budget = quota.budget;
+    if (budget) {
+        times.push(budget.checkedAt);
+        const figure = budget.reached
+            ? 'credits spent'
+            : budget.remainingPercent !== undefined
+                ? `credits ${percentLeft(budget.remainingPercent)}`
+                : 'credits available';
+        parts.push(`${figure}${full ? resetText(budget.resetsAt, now) : ''}`);
+    }
+    if (times.length > 0) {
+        const age = now - Math.min(...times);
+        if (age > (options.staleAfterMs ?? QUOTA_STALE_AFTER_MS))
+            parts.push(`checked ${shortSpan(age)} ago`);
+    }
+    return parts;
+}
+/**
+ * A row's quota as one line: `5h 58% left · 7d 90% left` in the compact
+ * form, with `, resets 2h` after each window in the full form. With nothing
+ * reported it is `NO_QUOTA_READING`, or `NO_LIMITS_REPORTED` when the
+ * provider answered without a limit for any window.
+ */
+export function formatQuota(quota, options) {
+    const parts = quotaTextParts(quota, options);
+    if (parts.length > 0)
+        return parts.join(' · ');
+    return quota && quota.limits.length > 0
+        ? NO_LIMITS_REPORTED
+        : NO_QUOTA_READING;
+}