@astrosheep/pi-quota 0.11.0 → 0.12.0

package/README.md

@@ -81,6 +81,28 @@ Pi model/auth → adapter → QuotaSnapshot → controller → footer / /usage /
 
 The extension publishes structured state on `quota-bar:state:v1`. Use `createQuotaExtension({ footer: false })` to consume it without this extension's footer. Normal queries are throttled, cancellable, timeout-bounded and backed off after errors. `/usage` forces a fresh query for every configured supported provider, then omits failed results from its default view. Switching provider discards old footer values immediately.
 
+## Standalone query layer
+
+Non-Pi consumers (bridges, plugins, scripts) can import the query layer without pulling in the Pi extension or its peer dependencies:
+
+```ts
+import {
+  AdapterRegistry, codexAdapter, createJsonClient, createPostJsonClient,
+} from '@astrosheep/pi-quota/query';
+
+const registry = new AdapterRegistry([codexAdapter]);
+const snapshot = await registry.get('openai-codex')!.query({
+  provider: 'openai-codex',
+  signal: AbortSignal.timeout(10_000),
+  now: () => Date.now(),
+  getAuth: myAuthResolver,      // you supply credentials
+  getJson: createJsonClient(),
+  postJson: createPostJsonClient(),
+});
+```
+
+The subpath exports every adapter, the registry/controller, option validators, HTTP/exec plumbing, and all query types. Peer dependencies are marked optional, so installing for the query layer alone stays light.
+
 ## Development
 
 Requires Node ≥22.18 and a compatible Pi installation.

package/package.json

@@ -1,10 +1,15 @@
 {
   "name": "@astrosheep/pi-quota",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "publishConfig": {
     "access": "public"
   },
   "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./query": "./src/query/index.ts",
+    "./package.json": "./package.json"
+  },
   "description": "Composable quota bar with Codex, Kimi, OpenCode Go, new-api, DeepSeek, Sub2API and YesCode adapters",
   "keywords": [
     "pi-package"
@@ -31,6 +36,10 @@
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*"
   },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": { "optional": true },
+    "@earendil-works/pi-tui": { "optional": true }
+  },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "typescript": "^6.0.3"

package/src/bar/quota.ts

@@ -3,6 +3,7 @@ import { duration, formatPercent, horizontalBar, plain, remainingTone, renderBar
 import type { BarElement, Paint, Span } from './bar.ts';
 import { allowanceLines, allowanceSpans, balanceLines, balanceSpans, money, spendLines } from './balance.ts';
 import type { QuotaErrorCode, QuotaState, QuotaWindow } from '../query/types.ts';
+import type { FooterWindows } from '../query/settings.ts';
 
 const errorText: Record<QuotaErrorCode, string> = {
   auth: 'Sign in with /login',
@@ -25,7 +26,7 @@ function windowSpans(window: QuotaWindow, now: number): Span[] {
 }
 
 // Footer window cap: a positive count, or 'all' for every shared window.
-export type FooterWindows = number | 'all';
+export type { FooterWindows };
 
 export function quotaElement(state: QuotaState, now = Date.now(), maxWindows: FooterWindows = 2): BarElement {
   const element: BarElement = { id: 'quota', spans: [] };

package/src/config.ts

@@ -1,140 +1,11 @@
-import { createDeepSeekAdapter } from './query/deepseek.ts';
-import { createExecAdapter, validateExecOptions } from './query/exec.ts';
-import { createNewApiAdapter, validateNewApiOptions } from './query/new-api.ts';
-import { createOpenCodeGoAdapter } from './query/opencode-go.ts';
-import { createSub2ApiAdapter } from './query/sub2api.ts';
-import { createYesCodeAdapter, validateYesCodeOptions } from './query/yescode.ts';
-import type { NewApiOptions } from './query/new-api.ts';
-import type { YesCodeOptions } from './query/yescode.ts';
-import type { QuotaAdapter } from './query/types.ts';
-import type { FooterWindows } from './bar/quota.ts';
-
-export type ProviderQuotaConfig =
-  | ({ adapter: 'new-api'; quotaPerUnit: number; currency: string } & Pick<NewApiOptions, 'dashboardAccessToken' | 'dashboardUserId'>)
-  | ({ adapter: 'yescode' } & YesCodeOptions)
-  | { adapter: 'exec'; command: string[]; label: string }
-  | { adapter: 'alias'; of: string }
-  | { adapter: 'deepseek' | 'sub2api' | 'opencode-go' };
-export interface QuotaConfig { providers: Record<string, ProviderQuotaConfig>; footerWindows?: FooterWindows }
-
-const DASHBOARD_KEYS = ['dashboardAccessToken', 'dashboardUserId'] as const;
-
-function parseDashboardOptions(item: Record<string, unknown>): Pick<NewApiOptions, 'dashboardAccessToken' | 'dashboardUserId'> {
-  const result: Pick<NewApiOptions, 'dashboardAccessToken' | 'dashboardUserId'> = {};
-  if (item.dashboardAccessToken !== undefined) {
-    if (typeof item.dashboardAccessToken !== 'string' || item.dashboardAccessToken.trim() === '') throw new QuotaConfigError();
-    result.dashboardAccessToken = item.dashboardAccessToken;
-  }
-  if (item.dashboardUserId !== undefined) {
-    if (typeof item.dashboardUserId !== 'number'
-      || !Number.isSafeInteger(item.dashboardUserId) || item.dashboardUserId <= 0) throw new QuotaConfigError();
-    result.dashboardUserId = item.dashboardUserId;
-  }
-  return result;
-}
-
-function parseFooterWindows(value: unknown): FooterWindows {
-  if (value === 'all') return value;
-  if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 1) return value;
-  throw new QuotaConfigError();
-}
-
-export class QuotaConfigError extends Error {
-  constructor() {
-    // Settings may accidentally contain secrets. Never echo content/values.
-    super('Invalid settings.json quotaUsage. Use providers with adapter "new-api", "deepseek", "sub2api", "opencode-go", "yescode", "exec" or "alias", and optionally footerWindows as a positive integer or "all".');
-  }
-}
-
-function record(value: unknown): value is Record<string, unknown> {
-  return value !== null && typeof value === 'object' && !Array.isArray(value);
-}
-
-export function parseQuotaConfig(value: unknown): QuotaConfig {
-  if (!record(value) || Object.keys(value).some(key => key !== 'providers' && key !== 'footerWindows')
-    || !record(value.providers) || Object.keys(value.providers).length > 64) throw new QuotaConfigError();
-  const providers: Record<string, ProviderQuotaConfig> = Object.create(null);
-  for (const [provider, item] of Object.entries(value.providers)) {
-    if (!/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/.test(provider)
-      || ['openai-codex', 'kimi-coding', 'opencode-go'].includes(provider)
-      || !record(item)) throw new QuotaConfigError();
-    if (item.adapter === 'deepseek') {
-      if (Object.keys(item).some(key => key !== 'adapter')) throw new QuotaConfigError();
-      providers[provider] = { adapter: 'deepseek' };
-      continue;
-    }
-    if (item.adapter === 'sub2api' || item.adapter === 'opencode-go') {
-      if (Object.keys(item).length !== 1) throw new QuotaConfigError();
-      providers[provider] = { adapter: item.adapter };
-      continue;
-    }
-    if (item.adapter === 'yescode') {
-      if (Object.keys(item).some(key => !['adapter', 'username', 'password'].includes(key))
-        || typeof item.username !== 'string' || typeof item.password !== 'string') throw new QuotaConfigError();
-      try {
-        providers[provider] = { adapter: 'yescode',
-          ...validateYesCodeOptions({ username: item.username, password: item.password }) };
-      } catch { throw new QuotaConfigError(); }
-      continue;
-    }
-    if (item.adapter === 'exec') {
-      if (Object.keys(item).some(key => !['adapter', 'command', 'label'].includes(key))) throw new QuotaConfigError();
-      try {
-        providers[provider] = { adapter: 'exec', ...validateExecOptions(item) };
-      } catch { throw new QuotaConfigError(); }
-      continue;
-    }
-    if (item.adapter === 'alias') {
-      if (Object.keys(item).some(key => key !== 'adapter' && key !== 'of')
-        || typeof item.of !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/.test(item.of)
-        || item.of === provider) throw new QuotaConfigError();
-      providers[provider] = { adapter: 'alias', of: item.of };
-      continue;
-    }
-    if (item.adapter !== 'new-api'
-      || Object.keys(item).some(key => !['adapter', 'quotaPerUnit', 'currency', ...DASHBOARD_KEYS].includes(key))
-      || (item.quotaPerUnit !== undefined && typeof item.quotaPerUnit !== 'number')
-      || (item.currency !== undefined && typeof item.currency !== 'string')) throw new QuotaConfigError();
-    try {
-      const settings = validateNewApiOptions({ quotaPerUnit: item.quotaPerUnit, currency: item.currency });
-      providers[provider] = { adapter: 'new-api', ...settings, ...parseDashboardOptions(item) };
-    } catch { throw new QuotaConfigError(); }
-  }
-  const config: QuotaConfig = { providers };
-  if (value.footerWindows !== undefined) config.footerWindows = parseFooterWindows(value.footerWindows);
-  return config;
-}
-
-export function loadQuotaFooterWindows(settings: unknown): FooterWindows | undefined {
-  if (!record(settings) || settings.quotaUsage === undefined) return undefined;
-  return parseQuotaConfig(settings.quotaUsage).footerWindows;
-}
-
-export function loadQuotaAdaptersFromSettings(settings: unknown): QuotaAdapter[] {
-  if (!record(settings) || settings.quotaUsage === undefined) return [];
-  const config = parseQuotaConfig(settings.quotaUsage);
-  return Object.entries(config.providers).flatMap(([provider, options]) => {
-    switch (options.adapter) {
-      case 'alias': return []; // Aliases declare no adapter; extension.ts wires them.
-      case 'deepseek': return createDeepSeekAdapter(provider);
-      case 'sub2api': return createSub2ApiAdapter(provider);
-      case 'opencode-go': return createOpenCodeGoAdapter(provider);
-      case 'yescode': return createYesCodeAdapter(provider, options);
-      case 'exec': return createExecAdapter(provider, options);
-      case 'new-api': return createNewApiAdapter(provider, options);
-    }
-  });
-}
-
-export function loadQuotaAliasesFromSettings(settings: unknown): Record<string, string> {
-  if (!record(settings) || settings.quotaUsage === undefined) return {};
-  const config = parseQuotaConfig(settings.quotaUsage);
-  const aliases: Record<string, string> = Object.create(null);
-  for (const [provider, options] of Object.entries(config.providers)) {
-    if (options.adapter === 'alias') aliases[provider] = options.of;
-  }
-  return aliases;
-}
-
-  // Explicit adapter bindings from quotaUsage already have adapters registered; listing every
-  // registered adapter is the boundary between quota providers and ordinary model providers.
+// Back-compatible surface: the implementation lives in the Pi-free query layer
+// (src/query/settings.ts) so non-Pi consumers can compose the same registry.
+export {
+  composeQuotaRegistry,
+  loadQuotaAdaptersFromSettings,
+  loadQuotaAliasesFromSettings,
+  loadQuotaFooterWindows,
+  parseQuotaConfig,
+  QuotaConfigError,
+} from './query/settings.ts';
+export type { ComposedQuota, FooterWindows, ProviderQuotaConfig, QuotaConfig } from './query/settings.ts';

package/src/extension.ts

@@ -3,14 +3,9 @@ import { renderFooter } from './bar/quota.ts';
 import type { FooterWindows } from './bar/quota.ts';
 import { captureAllUsage, USAGE_ENTRY, usageCardComponent, usageLines, compactUsageLines } from './bar/card.ts';
 import type { UsageCard } from './bar/card.ts';
-import { codexAdapter } from './query/codex.ts';
-import { createDeepSeekAdapter } from './query/deepseek.ts';
-import { kimiAdapter } from './query/kimi.ts';
-import { openCodeGoAdapter } from './query/opencode-go.ts';
 import { QuotaController } from './query/controller.ts';
 import { createJsonClient, createPostJsonClient } from './query/http.ts';
-import { AdapterRegistry } from './query/registry.ts';
-import { createAliasAdapter, createDanglingAliasAdapter } from './query/alias.ts';
+import { composeQuotaRegistry } from './query/settings.ts';
 import type { ProviderAuth, QuotaAdapter, QuotaState } from './query/types.ts';
 
 export const STATUS_EVENT = 'quota-bar:state:v1';
@@ -33,21 +28,8 @@ export interface QuotaExtensionOptions {
 
 export function createQuotaExtension(options: QuotaExtensionOptions = {}) {
   return (pi: ExtensionAPI): void => {
-    const explicitAdapters = options.adapters ?? [];
-    const aliases = options.aliases ?? {};
-    const explicitProviderIds = new Set([...explicitAdapters.map(adapter => adapter.provider), ...Object.keys(aliases)]);
     // Settings are deliberate user bindings, so they take precedence over defaults.
-    // AdapterRegistry still detects an ambiguous duplicate among explicit adapters.
-    const registry = new AdapterRegistry([
-      codexAdapter, kimiAdapter, openCodeGoAdapter, createDeepSeekAdapter('deepseek'),
-    ].filter(adapter => !explicitProviderIds.has(adapter.provider)).concat(explicitAdapters));
-    // Alias providers share their target's account: register a delegating adapter
-    // under the alias ID. One hop only — an alias of an alias never resolves, and
-    // a dangling alias stays visible as an error instead of vanishing silently.
-    for (const [alias, targetId] of Object.entries(aliases)) {
-      const target = aliases[targetId] === undefined ? registry.get(targetId) : undefined;
-      registry.register(target ? createAliasAdapter(alias, target) : createDanglingAliasAdapter(alias));
-    }
+    const { registry, aliases } = composeQuotaRegistry({ adapters: options.adapters, aliases: options.aliases });
     let current: ExtensionContext | undefined;
     let selectedProvider: string | undefined;
     let timer: ReturnType<typeof setInterval> | undefined;

package/src/query/index.ts

@@ -0,0 +1,23 @@
+// Public entry for the standalone query layer — no Pi, terminal, or rendering
+// dependencies. Consumers supply auth and transport through QueryContext.
+export * from './types.ts';
+export { AdapterRegistry, validateSnapshot } from './registry.ts';
+export { QuotaController } from './controller.ts';
+export { createJsonClient, createPostJsonClient, officialAuth, bearer, header } from './http.ts';
+export { createAliasAdapter, createDanglingAliasAdapter } from './alias.ts';
+export { createExecAdapter, validateExecOptions } from './exec.ts';
+export type { ExecOptions } from './exec.ts';
+export { codexAccountId, codexAdapter } from './codex.ts';
+export { kimiAdapter } from './kimi.ts';
+export { openCodeGoAdapter, createOpenCodeGoAdapter } from './opencode-go.ts';
+export { createDeepSeekAdapter, DEEPSEEK_ORIGIN } from './deepseek.ts';
+export { createNewApiAdapter, validateNewApiOptions } from './new-api.ts';
+export type { NewApiOptions } from './new-api.ts';
+export { createSub2ApiAdapter } from './sub2api.ts';
+export { createYesCodeAdapter, validateYesCodeOptions, YESCODE_ORIGIN } from './yescode.ts';
+export type { YesCodeOptions } from './yescode.ts';
+export {
+  composeQuotaRegistry, loadQuotaAdaptersFromSettings, loadQuotaAliasesFromSettings,
+  loadQuotaFooterWindows, parseQuotaConfig, QuotaConfigError,
+} from './settings.ts';
+export type { ComposedQuota, FooterWindows, ProviderQuotaConfig, QuotaConfig } from './settings.ts';

package/src/query/settings.ts

@@ -0,0 +1,179 @@
+import { createAliasAdapter, createDanglingAliasAdapter } from './alias.ts';
+import { codexAdapter } from './codex.ts';
+import { createDeepSeekAdapter } from './deepseek.ts';
+import { createExecAdapter, validateExecOptions } from './exec.ts';
+import { kimiAdapter } from './kimi.ts';
+import { createNewApiAdapter, validateNewApiOptions } from './new-api.ts';
+import { createOpenCodeGoAdapter, openCodeGoAdapter } from './opencode-go.ts';
+import { AdapterRegistry } from './registry.ts';
+import { createSub2ApiAdapter } from './sub2api.ts';
+import { createYesCodeAdapter, validateYesCodeOptions } from './yescode.ts';
+import type { NewApiOptions } from './new-api.ts';
+import type { YesCodeOptions } from './yescode.ts';
+import type { QuotaAdapter } from './types.ts';
+
+export type FooterWindows = number | 'all';
+
+export type ProviderQuotaConfig =
+  | ({ adapter: 'new-api'; quotaPerUnit: number; currency: string } & Pick<NewApiOptions, 'dashboardAccessToken' | 'dashboardUserId'>)
+  | ({ adapter: 'yescode' } & YesCodeOptions)
+  | { adapter: 'exec'; command: string[]; label: string }
+  | { adapter: 'alias'; of: string }
+  | { adapter: 'deepseek' | 'sub2api' | 'opencode-go' };
+export interface QuotaConfig { providers: Record<string, ProviderQuotaConfig>; footerWindows?: FooterWindows }
+
+const DASHBOARD_KEYS = ['dashboardAccessToken', 'dashboardUserId'] as const;
+
+function parseDashboardOptions(item: Record<string, unknown>): Pick<NewApiOptions, 'dashboardAccessToken' | 'dashboardUserId'> {
+  const result: Pick<NewApiOptions, 'dashboardAccessToken' | 'dashboardUserId'> = {};
+  if (item.dashboardAccessToken !== undefined) {
+    if (typeof item.dashboardAccessToken !== 'string' || item.dashboardAccessToken.trim() === '') throw new QuotaConfigError();
+    result.dashboardAccessToken = item.dashboardAccessToken;
+  }
+  if (item.dashboardUserId !== undefined) {
+    if (typeof item.dashboardUserId !== 'number'
+      || !Number.isSafeInteger(item.dashboardUserId) || item.dashboardUserId <= 0) throw new QuotaConfigError();
+    result.dashboardUserId = item.dashboardUserId;
+  }
+  return result;
+}
+
+function parseFooterWindows(value: unknown): FooterWindows {
+  if (value === 'all') return value;
+  if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 1) return value;
+  throw new QuotaConfigError();
+}
+
+export class QuotaConfigError extends Error {
+  constructor() {
+    // Settings may accidentally contain secrets. Never echo content/values.
+    super('Invalid settings.json quotaUsage. Use providers with adapter "new-api", "deepseek", "sub2api", "opencode-go", "yescode", "exec" or "alias", and optionally footerWindows as a positive integer or "all".');
+  }
+}
+
+function record(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+export function parseQuotaConfig(value: unknown): QuotaConfig {
+  if (!record(value) || Object.keys(value).some(key => key !== 'providers' && key !== 'footerWindows')
+    || !record(value.providers) || Object.keys(value.providers).length > 64) throw new QuotaConfigError();
+  const providers: Record<string, ProviderQuotaConfig> = Object.create(null);
+  for (const [provider, item] of Object.entries(value.providers)) {
+    if (!/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/.test(provider)
+      || ['openai-codex', 'kimi-coding', 'opencode-go'].includes(provider)
+      || !record(item)) throw new QuotaConfigError();
+    if (item.adapter === 'deepseek') {
+      if (Object.keys(item).some(key => key !== 'adapter')) throw new QuotaConfigError();
+      providers[provider] = { adapter: 'deepseek' };
+      continue;
+    }
+    if (item.adapter === 'sub2api' || item.adapter === 'opencode-go') {
+      if (Object.keys(item).length !== 1) throw new QuotaConfigError();
+      providers[provider] = { adapter: item.adapter };
+      continue;
+    }
+    if (item.adapter === 'yescode') {
+      if (Object.keys(item).some(key => !['adapter', 'username', 'password'].includes(key))
+        || typeof item.username !== 'string' || typeof item.password !== 'string') throw new QuotaConfigError();
+      try {
+        providers[provider] = { adapter: 'yescode',
+          ...validateYesCodeOptions({ username: item.username, password: item.password }) };
+      } catch { throw new QuotaConfigError(); }
+      continue;
+    }
+    if (item.adapter === 'exec') {
+      if (Object.keys(item).some(key => !['adapter', 'command', 'label'].includes(key))) throw new QuotaConfigError();
+      try {
+        providers[provider] = { adapter: 'exec', ...validateExecOptions(item) };
+      } catch { throw new QuotaConfigError(); }
+      continue;
+    }
+    if (item.adapter === 'alias') {
+      if (Object.keys(item).some(key => key !== 'adapter' && key !== 'of')
+        || typeof item.of !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/.test(item.of)
+        || item.of === provider) throw new QuotaConfigError();
+      providers[provider] = { adapter: 'alias', of: item.of };
+      continue;
+    }
+    if (item.adapter !== 'new-api'
+      || Object.keys(item).some(key => !['adapter', 'quotaPerUnit', 'currency', ...DASHBOARD_KEYS].includes(key))
+      || (item.quotaPerUnit !== undefined && typeof item.quotaPerUnit !== 'number')
+      || (item.currency !== undefined && typeof item.currency !== 'string')) throw new QuotaConfigError();
+    try {
+      const settings = validateNewApiOptions({ quotaPerUnit: item.quotaPerUnit, currency: item.currency });
+      providers[provider] = { adapter: 'new-api', ...settings, ...parseDashboardOptions(item) };
+    } catch { throw new QuotaConfigError(); }
+  }
+  const config: QuotaConfig = { providers };
+  if (value.footerWindows !== undefined) config.footerWindows = parseFooterWindows(value.footerWindows);
+  return config;
+}
+
+export function loadQuotaFooterWindows(settings: unknown): FooterWindows | undefined {
+  if (!record(settings) || settings.quotaUsage === undefined) return undefined;
+  return parseQuotaConfig(settings.quotaUsage).footerWindows;
+}
+
+export function loadQuotaAdaptersFromSettings(settings: unknown): QuotaAdapter[] {
+  if (!record(settings) || settings.quotaUsage === undefined) return [];
+  const config = parseQuotaConfig(settings.quotaUsage);
+  return Object.entries(config.providers).flatMap(([provider, options]) => {
+    switch (options.adapter) {
+      case 'alias': return []; // Aliases declare no adapter; extension.ts wires them.
+      case 'deepseek': return createDeepSeekAdapter(provider);
+      case 'sub2api': return createSub2ApiAdapter(provider);
+      case 'opencode-go': return createOpenCodeGoAdapter(provider);
+      case 'yescode': return createYesCodeAdapter(provider, options);
+      case 'exec': return createExecAdapter(provider, options);
+      case 'new-api': return createNewApiAdapter(provider, options);
+    }
+  });
+}
+
+export function loadQuotaAliasesFromSettings(settings: unknown): Record<string, string> {
+  if (!record(settings) || settings.quotaUsage === undefined) return {};
+  const config = parseQuotaConfig(settings.quotaUsage);
+  const aliases: Record<string, string> = Object.create(null);
+  for (const [provider, options] of Object.entries(config.providers)) {
+    if (options.adapter === 'alias') aliases[provider] = options.of;
+  }
+  return aliases;
+}
+
+export interface ComposedQuota {
+  registry: AdapterRegistry;
+  aliases: Record<string, string>;
+  footerWindows: FooterWindows | undefined;
+}
+
+/**
+ * The full quota surface in one place: built-in adapters, settings-bound adapters
+ * and aliases wired exactly as the Pi extension does. Settings are deliberate user
+ * bindings, so they take precedence over defaults; AdapterRegistry still detects an
+ * ambiguous duplicate among explicit adapters. Alias providers share their target's
+ * account: one hop only, and a dangling alias stays visible as an error instead of
+ * vanishing silently.
+ */
+export function composeQuotaRegistry(input: {
+  settings?: unknown;
+  adapters?: readonly QuotaAdapter[];
+  aliases?: Record<string, string>;
+} = {}): ComposedQuota {
+  const settingsAdapters = input.settings === undefined ? [] : loadQuotaAdaptersFromSettings(input.settings);
+  const explicitAdapters = [...settingsAdapters, ...(input.adapters ?? [])];
+  const aliases = { ...loadQuotaAliasesFromSettings(input.settings ?? {}), ...(input.aliases ?? {}) };
+  const explicitProviderIds = new Set([...explicitAdapters.map(adapter => adapter.provider), ...Object.keys(aliases)]);
+  const registry = new AdapterRegistry([
+    codexAdapter, kimiAdapter, openCodeGoAdapter, createDeepSeekAdapter('deepseek'),
+  ].filter(adapter => !explicitProviderIds.has(adapter.provider)).concat(explicitAdapters));
+  for (const [alias, targetId] of Object.entries(aliases)) {
+    const target = aliases[targetId] === undefined ? registry.get(targetId) : undefined;
+    registry.register(target ? createAliasAdapter(alias, target) : createDanglingAliasAdapter(alias));
+  }
+  return {
+    registry,
+    aliases,
+    footerWindows: input.settings === undefined ? undefined : loadQuotaFooterWindows(input.settings),
+  };
+}