@astrosheep/pi-quota 0.5.3 → 0.5.5

package/README.md

@@ -1,12 +1,12 @@
 # @astrosheep/pi-quota
 
-Compact quota status for Pi: Codex, Kimi and OpenCode Go work out of the box; new-api, DeepSeek and Sub2API use explicit provider bindings.
+Compact quota status for Pi: Codex, Kimi, OpenCode Go and DeepSeek work out of the box; new-api and Sub2API use explicit provider bindings.
 
 ```bash
 pi install npm:@astrosheep/pi-quota
 ```
 
-Reload Pi after installing or changing settings. Use `/usage` for a persistent, context-free snapshot covering every configured provider with a quota adapter, including the current one. Automatic footer polling never adds chat items.
+Reload Pi after installing or changing settings. Use `/usage` for a persistent, context-free snapshot of providers with available quota data, including the current one. Use `/usage --all` to inspect provider errors. Automatic footer polling never adds chat items.
 
 ## What it shows
 
@@ -18,7 +18,7 @@ Reload Pi after installing or changing settings. Use `/usage` for a persistent,
 
 A percentage always means **remaining**, not used. Unknown is `[?] ?`; an expired reset is `↺ due` with the stale percentage hidden until the next successful query. A wallet balance never becomes a percentage. Historical spend is not a quota.
 
-The footer shows at most two windows and `+N` for additional ones, for the current provider only. `/usage` queries all configured supported providers and includes all windows, grouped by provider; it does not open a modal or send messages to the model. Snapshots remain frozen at capture time. Errors replace stale values and are shown per provider.
+The footer shows at most two windows and `+N` for additional ones, for the current provider only. `/usage` queries all configured supported providers and shows successful results with all windows, grouped by provider; it does not open a modal or send messages to the model. Snapshots remain frozen at capture time. Query failures replace stale values in the footer and appear in `/usage --all`.
 
 ## Configure providers
 
@@ -36,7 +36,7 @@ Add bindings in global `~/.pi/agent/settings.json` under `quotaUsage` (not proje
 }
 ```
 
-Use the **exact Pi provider ID**. Only selected, explicitly bound providers are queried; built-in `openai-codex`, `kimi-coding` and `opencode-go` cannot be overridden. Unknown keys or adapter options are rejected. The API key and model `baseUrl` come from Pi's active provider auth; do not put model API keys in `quotaUsage`.
+Use the **exact Pi provider ID**. Built-in providers and explicitly bound providers are queried; explicit bindings replace a built-in adapter with the same ID. Unknown keys or adapter options are rejected. The API key and model `baseUrl` come from Pi's active provider auth; do not put model API keys in `quotaUsage`.
 
 | Adapter | Endpoint | Result |
 |---|---|---|
@@ -63,7 +63,7 @@ Pi model/auth → adapter → QuotaSnapshot → controller → footer / /usage /
 
 `QuotaSnapshot` separates `balance` (wallet), `allowance` (finite key quota), `windows` (renewable limits), and optional `spend` (Today/Lifetime actual charge). This prevents unrelated amounts from sharing an ambiguous `Used` label. Custom adapters can be passed to `createQuotaExtension({ adapters: [...] })`; see `examples/custom-provider.ts`. Provider aliases are never inferred.
 
-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. Switching provider discards old footer values immediately.
+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.
 
 ## Development
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/pi-quota",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "publishConfig": {
     "access": "public"
   },

package/src/bar/card.ts

@@ -24,7 +24,7 @@ export function captureAllUsage(states: readonly QuotaState[], now = Date.now())
 
 export function usageLines(card: UsageCard, paint?: Paint, barWidth = 20): string[] {
   if (card.version === 1) return renderUsage(card.state, paint, card.capturedAt, barWidth);
-  if (card.states.length === 0) return ['No supported quota providers available.'];
+  if (card.states.length === 0) return ['No quota data available. Run /usage --all for details.'];
   return card.states.flatMap((state, index) => [
     ...(index ? ['', ''] : []), ...renderUsage(state, paint, card.capturedAt, barWidth),
   ]);

package/src/bar/quota.ts

@@ -46,11 +46,9 @@ export function renderFooter(state: QuotaState, paint: Paint = plain, now = Date
   return renderBar([quotaElement(state, now)], paint);
 }
 
-const displayLabel: Record<string, string> = { deepseek: 'DeepSeek' };
-
 export function renderUsage(state: QuotaState, paint: Paint = plain, now = Date.now(), barWidth = 16): string[] {
   if (state.kind === 'hidden') return ['No quota adapter for the current provider.'];
-  const title = displayLabel[state.provider] ?? state.label;
+  const title = state.label;
   const indent = (line: string) => line ? `  ${line}` : line;
   if (state.kind === 'loading') return [title, '', indent('Loading…')];
   if (state.kind === 'error') return [title, '', indent(errorText[state.code])];

package/src/extension.ts

@@ -16,7 +16,8 @@ const STATUS_KEY = 'quota-bar';
 const USAGE_WIDGET = 'quota-bar:usage';
 
 export interface QuotaExtensionOptions {
-  adapters?: readonly QuotaAdapter[]; // Extra adapters; duplicate IDs are rejected.
+  // Explicit adapters replace matching built-ins; duplicate explicit IDs are rejected.
+  adapters?: readonly QuotaAdapter[];
   providers?: readonly string[]; // Extra configured quota providers to include in /usage
   footer?: boolean; // false: query + /usage + structured events only
   intervalMs?: number;
@@ -25,8 +26,13 @@ export interface QuotaExtensionOptions {
 
 export function createQuotaExtension(options: QuotaExtensionOptions = {}) {
   return (pi: ExtensionAPI): void => {
-    const registry = new AdapterRegistry([codexAdapter, kimiAdapter, openCodeGoAdapter,
-      createDeepSeekAdapter('deepseek'), ...(options.adapters ?? [])]);
+    const explicitAdapters = options.adapters ?? [];
+    const explicitProviderIds = new Set(explicitAdapters.map(adapter => adapter.provider));
+    // 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));
     let current: ExtensionContext | undefined;
     let selectedProvider: string | undefined;
     let timer: ReturnType<typeof setInterval> | undefined;
@@ -161,8 +167,8 @@ export function createQuotaExtension(options: QuotaExtensionOptions = {}) {
     });
 
     pi.registerCommand('usage', {
-      description: 'Query quota for every configured supported provider and add snapshots to the chat history',
-      handler: async (_args, ctx) => {
+      description: 'Show available quotas; use /usage --all to include provider errors',
+      handler: async (args, ctx) => {
         if (!ctx.hasUI) return;
         bind(ctx);
         const generation = ++commandGeneration;
@@ -174,7 +180,9 @@ export function createQuotaExtension(options: QuotaExtensionOptions = {}) {
           // Never append via a stale Pi runtime, or label a replacement model's data
           // as the result of the original command. A newer command owns its result.
           if (!current || generation !== commandGeneration) return;
-          const card = captureAllUsage(states);
+          const visibleStates = args.trim() === '--all'
+            ? states : states.filter(state => state.kind === 'ready');
+          const card = captureAllUsage(visibleStates);
           pi.appendEntry<UsageCard>(USAGE_ENTRY, card);
           // Custom entry renderers are TUI-only; RPC clients still get readable output.
           if (ctx.mode !== 'tui') {

package/src/query/deepseek.ts

@@ -24,7 +24,7 @@ export function parseDeepSeekBalance(payload: unknown): AccountBalance {
 
 export function createDeepSeekAdapter(provider: string): QuotaAdapter {
   return {
-    provider, label: provider,
+    provider, label: provider === 'deepseek' ? 'DeepSeek' : provider,
     async query(context) {
       const auth = await officialAuth(context, DEEPSEEK_ORIGIN);
       const payload = await context.getJson(`${DEEPSEEK_ORIGIN}/user/balance`,