switchroom 0.10.0 → 0.11.0

package/telegram-plugin/tests/auth-snapshot-format.test.ts

@@ -0,0 +1,429 @@
+/**
+ * Tests for auth-snapshot-format.ts — Format 2 + causal auto-fallback
+ * announcement. Pure functions, fully covered by frozen-clock tests
+ * with hand-crafted QuotaUtilization fixtures.
+ */
+import { describe, it, expect } from 'vitest';
+import {
+  classifyHealth,
+  bindingWindow,
+  formatRelative,
+  formatAbsolute,
+  fmtPct,
+  recommendation,
+  renderAuthSnapshotFormat2,
+  renderFallbackAnnouncement,
+  buildSnapshotKeyboard,
+  buildSnapshotsFromState,
+  THROTTLING_THRESHOLD_PCT,
+  type AccountSnapshot,
+} from '../auth-snapshot-format.js';
+import type { QuotaUtilization } from '../quota-check.js';
+import type { ListStateData } from '../../src/auth/broker/client.js';
+
+// Frozen "now" for all reset-time math. Friday May 15 2026 10:53 AM Melbourne
+// = 2026-05-15T00:53:00Z. Reset epochs in fixtures are in seconds.
+const NOW = new Date('2026-05-15T00:53:00Z');
+
+function quota(part: Partial<QuotaUtilization>): QuotaUtilization {
+  return {
+    fiveHourUtilizationPct: 0,
+    sevenDayUtilizationPct: 0,
+    fiveHourResetAt: null,
+    sevenDayResetAt: null,
+    representativeClaim: null,
+    overageStatus: null,
+    overageDisabledReason: null,
+    ...part,
+  };
+}
+
+function snap(part: Partial<AccountSnapshot>): AccountSnapshot {
+  return {
+    label: 'unset@example.com',
+    isActive: false,
+    quota: null,
+    ...part,
+  };
+}
+
+// ── classifyHealth ───────────────────────────────────────────────────
+
+describe('classifyHealth', () => {
+  it('returns healthy for low utilization on both windows', () => {
+    expect(classifyHealth(snap({ quota: quota({ fiveHourUtilizationPct: 8, sevenDayUtilizationPct: 20 }) }))).toBe('healthy');
+  });
+  it('returns throttling when either window crosses the 80% threshold', () => {
+    expect(classifyHealth(snap({ quota: quota({ fiveHourUtilizationPct: 85, sevenDayUtilizationPct: 20 }) }))).toBe('throttling');
+    expect(classifyHealth(snap({ quota: quota({ fiveHourUtilizationPct: 5, sevenDayUtilizationPct: 95 }) }))).toBe('throttling');
+  });
+  it('returns blocked at 99.5%+ utilization on either window', () => {
+    expect(classifyHealth(snap({ quota: quota({ fiveHourUtilizationPct: 100, sevenDayUtilizationPct: 0 }) }))).toBe('blocked');
+    expect(classifyHealth(snap({ quota: quota({ fiveHourUtilizationPct: 0, sevenDayUtilizationPct: 100 }) }))).toBe('blocked');
+    expect(classifyHealth(snap({ quota: quota({ fiveHourUtilizationPct: 99.6, sevenDayUtilizationPct: 0 }) }))).toBe('blocked');
+  });
+  it('returns unknown when quota probe failed', () => {
+    expect(classifyHealth(snap({ quota: null, quotaError: 'HTTP 401' }))).toBe('unknown');
+  });
+  it('THROTTLING_THRESHOLD_PCT is 80 (regression — design choice, see jtbd)', () => {
+    // If this number changes, the recommendation footer + button visibility
+    // shift; bump it deliberately.
+    expect(THROTTLING_THRESHOLD_PCT).toBe(80);
+  });
+});
+
+// ── bindingWindow ────────────────────────────────────────────────────
+
+describe('bindingWindow', () => {
+  it('respects representative_claim when present (server-authoritative)', () => {
+    expect(bindingWindow(quota({ representativeClaim: 'five_hour', fiveHourUtilizationPct: 10, sevenDayUtilizationPct: 90 }))).toBe('5h');
+    expect(bindingWindow(quota({ representativeClaim: 'seven_day', fiveHourUtilizationPct: 90, sevenDayUtilizationPct: 10 }))).toBe('7d');
+  });
+  it('falls back to higher window when no claim is present', () => {
+    expect(bindingWindow(quota({ fiveHourUtilizationPct: 10, sevenDayUtilizationPct: 90 }))).toBe('7d');
+    expect(bindingWindow(quota({ fiveHourUtilizationPct: 90, sevenDayUtilizationPct: 10 }))).toBe('5h');
+  });
+});
+
+// ── formatRelative ───────────────────────────────────────────────────
+
+describe('formatRelative', () => {
+  it('renders sub-hour countdowns in minutes', () => {
+    expect(formatRelative(new Date('2026-05-15T01:00:00Z'), NOW)).toBe('7m');
+  });
+  it('renders sub-day countdowns in h+m', () => {
+    expect(formatRelative(new Date('2026-05-15T05:50:00Z'), NOW)).toBe('4h 57m');
+  });
+  it('renders multi-day countdowns in d+h', () => {
+    expect(formatRelative(new Date('2026-05-17T10:00:00Z'), NOW)).toBe('2d 9h');
+  });
+  it('returns "—" for null and "now" for past targets', () => {
+    expect(formatRelative(null, NOW)).toBe('—');
+    expect(formatRelative(new Date('2026-05-14T00:00:00Z'), NOW)).toBe('now');
+  });
+});
+
+// ── fmtPct ───────────────────────────────────────────────────────────
+
+describe('fmtPct', () => {
+  it('rounds to nearest integer percent', () => {
+    expect(fmtPct(8.4)).toBe('8%');
+    expect(fmtPct(8.6)).toBe('9%');
+    expect(fmtPct(99.6)).toBe('100%');
+  });
+});
+
+// ── formatAbsolute ───────────────────────────────────────────────────
+
+describe('formatAbsolute', () => {
+  it('renders weekday + hour + minute in the given timezone', () => {
+    const out = formatAbsolute(new Date('2026-05-15T05:50:00Z'), 'Australia/Melbourne');
+    // Just sanity-check the contract: weekday name, hour:minute, AM/PM
+    expect(out).toMatch(/^(Sun|Mon|Tue|Wed|Thu|Fri|Sat)\b/);
+    expect(out).toMatch(/\d{1,2}:\d{2}\s?(AM|PM)/);
+  });
+  it('returns "—" for null', () => {
+    expect(formatAbsolute(null, 'UTC')).toBe('—');
+  });
+});
+
+// ── renderAuthSnapshotFormat2 ────────────────────────────────────────
+
+describe('renderAuthSnapshotFormat2', () => {
+  // Matches the live snapshot we proved against claude.ai for the user's
+  // own three accounts (15 May 2026, 10:53 AM Mel) — this is the gold
+  // fixture. If the formatter changes shape, update these expectations.
+  const fixtureSnaps: AccountSnapshot[] = [
+    snap({
+      label: 'ken.thompson@outlook.com.au',
+      isActive: false,
+      quota: quota({
+        fiveHourUtilizationPct: 0,
+        sevenDayUtilizationPct: 23,
+        fiveHourResetAt: new Date('2026-05-15T05:50:00Z'),
+        sevenDayResetAt: new Date('2026-05-18T19:00:00Z'),
+        representativeClaim: 'five_hour',
+      }),
+    }),
+    snap({
+      label: 'me@kenthompson.com.au',
+      isActive: false,
+      quota: quota({
+        fiveHourUtilizationPct: 0,
+        sevenDayUtilizationPct: 100,
+        fiveHourResetAt: new Date('2026-05-15T00:50:00Z'),
+        sevenDayResetAt: new Date('2026-05-17T10:00:00Z'),
+        representativeClaim: 'seven_day',
+      }),
+    }),
+    snap({
+      label: 'pixsoul@gmail.com',
+      isActive: true,
+      quota: quota({
+        fiveHourUtilizationPct: 8,
+        sevenDayUtilizationPct: 20,
+        fiveHourResetAt: new Date('2026-05-15T01:00:00Z'),
+        sevenDayResetAt: new Date('2026-05-17T01:00:00Z'),
+        representativeClaim: 'five_hour',
+      }),
+    }),
+  ];
+
+  it('renders three health-grouped sections (BLOCKED first, then HEALTHY)', () => {
+    const out = renderAuthSnapshotFormat2(fixtureSnaps, { now: NOW, tz: 'UTC' });
+    // Headers present
+    expect(out).toContain('🔋 <b>Auth — fleet status</b>');
+    expect(out).toContain('🔴 <b>BLOCKED</b> (1)');
+    expect(out).toContain('🟢 <b>HEALTHY</b> (2)');
+    // Order: BLOCKED before HEALTHY
+    expect(out.indexOf('🔴')).toBeLessThan(out.indexOf('🟢'));
+  });
+
+  it('marks the active account with ●', () => {
+    const out = renderAuthSnapshotFormat2(fixtureSnaps, { now: NOW, tz: 'UTC' });
+    expect(out).toMatch(/●\s*<code>pixsoul@gmail\.com<\/code>/);
+  });
+
+  it('shows "back …" for blocked accounts with binding-window word', () => {
+    const out = renderAuthSnapshotFormat2(fixtureSnaps, { now: NOW, tz: 'UTC' });
+    // me@kenthompson is blocked on 7d, recovers Sun
+    expect(out).toMatch(/me@kenthompson\.com\.au[\s\S]*back .* 7-day cap/);
+  });
+
+  it('puts the imminent window first on healthy/throttling rows', () => {
+    const out = renderAuthSnapshotFormat2(fixtureSnaps, { now: NOW, tz: 'UTC' });
+    // pixsoul: 5h reset is in 7m, 7d reset is in 2d. 5h should come first.
+    const pixRow = out.split('\n').find((l) => l.includes('5h refills') && l.includes('7d resets'));
+    expect(pixRow).toBeDefined();
+    expect(pixRow!.indexOf('5h refills')).toBeLessThan(pixRow!.indexOf('7d resets'));
+  });
+
+  it('emits a recommendation footer that names a healthy alternative when active is throttling', () => {
+    const throttlingSnaps: AccountSnapshot[] = [
+      snap({ label: 'a@x', isActive: true, quota: quota({ fiveHourUtilizationPct: 90 }) }),
+      snap({ label: 'b@x', quota: quota({ fiveHourUtilizationPct: 5 }) }),
+    ];
+    const out = renderAuthSnapshotFormat2(throttlingSnaps, { now: NOW });
+    expect(out).toMatch(/Recommendation:.*active a@x is throttling.*Switch to b@x/);
+  });
+
+  it('"stay on" when active is healthy', () => {
+    const happySnaps: AccountSnapshot[] = [
+      snap({ label: 'a@x', isActive: true, quota: quota({ fiveHourUtilizationPct: 5 }) }),
+    ];
+    const out = renderAuthSnapshotFormat2(happySnaps, { now: NOW });
+    expect(out).toMatch(/Recommendation: stay on a@x\./);
+  });
+
+  it('falls back gracefully when quota probe failed', () => {
+    const errSnaps: AccountSnapshot[] = [
+      snap({ label: 'broken@x', isActive: true, quota: null, quotaError: 'HTTP 401' }),
+    ];
+    const out = renderAuthSnapshotFormat2(errSnaps, { now: NOW });
+    expect(out).toContain('quota probe failed');
+    expect(out).toContain('HTTP 401');
+    expect(out).toContain('⚪ <b>UNKNOWN</b>');
+  });
+
+  it('renders refresh stamp when liveProbedAtMs given', () => {
+    const out = renderAuthSnapshotFormat2(fixtureSnaps.slice(0, 1), {
+      now: NOW,
+      liveProbedAtMs: Date.now() - 12_000,
+    });
+    expect(out).toMatch(/<i>Live · refreshed \d+s ago<\/i>/);
+  });
+});
+
+// ── renderFallbackAnnouncement ───────────────────────────────────────
+
+describe('renderFallbackAnnouncement', () => {
+  const KEN_5H_BLOWN = quota({
+    fiveHourUtilizationPct: 100,
+    sevenDayUtilizationPct: 23,
+    fiveHourResetAt: new Date('2026-05-15T05:50:00Z'),
+    sevenDayResetAt: new Date('2026-05-18T19:00:00Z'),
+    representativeClaim: 'five_hour',
+  });
+
+  const PIXSOUL_HEALTHY = quota({
+    fiveHourUtilizationPct: 8,
+    sevenDayUtilizationPct: 20,
+    fiveHourResetAt: new Date('2026-05-15T01:00:00Z'),
+    sevenDayResetAt: new Date('2026-05-17T01:00:00Z'),
+  });
+
+  it('headlines the limit type explicitly (5-hour vs 7-day) — JTBD core', () => {
+    const out5 = renderFallbackAnnouncement({
+      oldLabel: 'ken@x',
+      oldQuota: KEN_5H_BLOWN,
+      newLabel: 'pixsoul@x',
+      newQuota: PIXSOUL_HEALTHY,
+      triggerAgent: 'carrie',
+      now: NOW,
+      tz: 'UTC',
+    });
+    expect(out5).toContain('5-hour limit on ken@x');
+    expect(out5).not.toContain('quota exhausted');
+
+    const out7 = renderFallbackAnnouncement({
+      oldLabel: 'me@x',
+      oldQuota: quota({
+        sevenDayUtilizationPct: 100,
+        sevenDayResetAt: new Date('2026-05-17T10:00:00Z'),
+        representativeClaim: 'seven_day',
+      }),
+      newLabel: 'pixsoul@x',
+      newQuota: PIXSOUL_HEALTHY,
+      triggerAgent: 'clerk',
+      now: NOW,
+      tz: 'UTC',
+    });
+    expect(out7).toContain('7-day limit on me@x');
+  });
+
+  it('names the triggering agent + recovery countdown for the old account', () => {
+    const out = renderFallbackAnnouncement({
+      oldLabel: 'ken@x',
+      oldQuota: KEN_5H_BLOWN,
+      newLabel: 'pixsoul@x',
+      newQuota: PIXSOUL_HEALTHY,
+      triggerAgent: 'carrie',
+      now: NOW,
+      tz: 'UTC',
+    });
+    expect(out).toContain('Triggered by: agent <b>carrie</b>');
+    expect(out).toMatch(/ken@x.*recovers.*in 4h 57m/);
+  });
+
+  it('reports new-account headroom verdict', () => {
+    const happy = renderFallbackAnnouncement({
+      oldLabel: 'ken@x',
+      oldQuota: KEN_5H_BLOWN,
+      newLabel: 'pixsoul@x',
+      newQuota: PIXSOUL_HEALTHY,
+      triggerAgent: 'carrie',
+      now: NOW,
+      tz: 'UTC',
+    });
+    expect(happy).toContain('plenty of headroom');
+
+    const tight = renderFallbackAnnouncement({
+      oldLabel: 'ken@x',
+      oldQuota: KEN_5H_BLOWN,
+      newLabel: 'pixsoul@x',
+      newQuota: quota({ fiveHourUtilizationPct: 85 }),
+      triggerAgent: 'carrie',
+      now: NOW,
+      tz: 'UTC',
+    });
+    expect(tight).toContain('near limit — watch this');
+  });
+
+  it('handles all-blocked: no swap, surface earliest reset + /auth add hint', () => {
+    const out = renderFallbackAnnouncement({
+      oldLabel: 'ken@x',
+      oldQuota: KEN_5H_BLOWN,
+      newLabel: null,
+      newQuota: null,
+      triggerAgent: 'carrie',
+      now: NOW,
+      tz: 'UTC',
+    });
+    expect(out).toContain('🔴 <b>All accounts blocked');
+    expect(out).toMatch(/ken@x recovers.*in 4h 57m/);
+    expect(out).toContain('/auth add');
+  });
+});
+
+// ── buildSnapshotKeyboard ────────────────────────────────────────────
+
+describe('buildSnapshotKeyboard', () => {
+  it('hides switch buttons for BLOCKED accounts (no temptation to swap into a wall)', () => {
+    const snaps: AccountSnapshot[] = [
+      snap({ label: 'a@x', isActive: true, quota: quota({ fiveHourUtilizationPct: 5 }) }),
+      snap({ label: 'b@x', quota: quota({ fiveHourUtilizationPct: 100 }) }), // blocked
+      snap({ label: 'c@x', quota: quota({ fiveHourUtilizationPct: 5 }) }),  // healthy
+    ];
+    const rows = buildSnapshotKeyboard(snaps);
+    const allText = rows.flat().map((b) => b.text);
+    expect(allText).toContain('Switch fleet → c@x');
+    expect(allText).not.toContain('Switch fleet → b@x');
+  });
+
+  it('hides switch buttons for UNKNOWN-health accounts (probe failed = unsafe)', () => {
+    const snaps: AccountSnapshot[] = [
+      snap({ label: 'a@x', isActive: true, quota: quota({ fiveHourUtilizationPct: 5 }) }),
+      snap({ label: 'broken@x', quota: null, quotaError: 'HTTP 401' }),
+    ];
+    const rows = buildSnapshotKeyboard(snaps);
+    const allText = rows.flat().map((b) => b.text);
+    expect(allText).not.toContain('Switch fleet → broken@x');
+  });
+
+  it('always includes ↻ Refresh, /usage, + Add in the bottom row', () => {
+    const rows = buildSnapshotKeyboard([
+      snap({ label: 'a@x', isActive: true, quota: quota({}) }),
+    ]);
+    const last = rows[rows.length - 1]!.map((b) => b.text);
+    expect(last).toEqual(['↻ Refresh', '/usage', '+ Add']);
+  });
+
+  it('caps switch buttons via maxSwitchButtons option', () => {
+    const snaps: AccountSnapshot[] = Array.from({ length: 10 }, (_, i) =>
+      snap({ label: `acc${i}@x`, isActive: i === 0, quota: quota({ fiveHourUtilizationPct: 5 }) }),
+    );
+    const rows = buildSnapshotKeyboard(snaps, { maxSwitchButtons: 2 });
+    const switchRows = rows.slice(0, -1);
+    expect(switchRows.length).toBe(2);
+  });
+});
+
+// ── buildSnapshotsFromState ──────────────────────────────────────────
+
+describe('buildSnapshotsFromState', () => {
+  it('zips broker accounts with parallel quota results, marks the active', () => {
+    const state: ListStateData = {
+      active: 'b@x',
+      fallback_order: ['a@x', 'b@x', 'c@x'],
+      accounts: [
+        { label: 'a@x', exhausted: false },
+        { label: 'b@x', exhausted: false },
+        { label: 'c@x', exhausted: false },
+      ],
+      agents: [],
+      consumers: [],
+    };
+    const snaps = buildSnapshotsFromState(state, [
+      { ok: true, data: quota({ fiveHourUtilizationPct: 5 }) },
+      { ok: true, data: quota({ fiveHourUtilizationPct: 50 }) },
+      { ok: false, reason: 'HTTP 401' },
+    ]);
+    expect(snaps.map((s) => s.label)).toEqual(['a@x', 'b@x', 'c@x']);
+    expect(snaps.map((s) => s.isActive)).toEqual([false, true, false]);
+    expect(snaps[0]!.quota?.fiveHourUtilizationPct).toBe(5);
+    expect(snaps[2]!.quota).toBeNull();
+    expect(snaps[2]!.quotaError).toBe('HTTP 401');
+  });
+});
+
+// ── recommendation logic edge cases ──────────────────────────────────
+
+describe('recommendation', () => {
+  it('warns "all blocked" when no healthy alternative exists', () => {
+    const snaps: AccountSnapshot[] = [
+      snap({ label: 'a@x', isActive: true, quota: quota({ fiveHourUtilizationPct: 100 }) }),
+      snap({ label: 'b@x', quota: quota({ sevenDayUtilizationPct: 100, sevenDayResetAt: new Date('2026-05-17T00:00:00Z') }) }),
+    ];
+    const out = recommendation(snaps, NOW);
+    expect(out).toMatch(/All accounts blocked\. Earliest recovery: b@x in 1d/);
+  });
+
+  it('reports throttling-with-no-alt when active is throttling and others are too', () => {
+    const snaps: AccountSnapshot[] = [
+      snap({ label: 'a@x', isActive: true, quota: quota({ fiveHourUtilizationPct: 90 }) }),
+      snap({ label: 'b@x', quota: quota({ fiveHourUtilizationPct: 85 }) }),
+    ];
+    const out = recommendation(snaps, NOW);
+    expect(out).toContain('throttling; no healthy alternative');
+  });
+});

package/telegram-plugin/tests/auth-status-adapter.test.ts

@@ -0,0 +1,129 @@
+import { describe, expect, it } from 'vitest'
+import {
+  type BrokerStateView,
+  type ClaudeJsonView,
+  buildAuthSummaryFromBroker,
+  formatExpiresInRelative,
+} from '../gateway/auth-status-adapter.js'
+
+const NOW = 1_700_000_000_000
+
+function state(over: Partial<BrokerStateView> = {}): BrokerStateView {
+  return {
+    active: 'ken@example.com',
+    fallback_order: ['ken@example.com'],
+    accounts: [
+      { label: 'ken@example.com', expiresAt: NOW + 29 * 86_400_000, exhausted: false },
+    ],
+    agents: [{ name: 'clerk', account: 'ken@example.com', override: null }],
+    ...over,
+  }
+}
+
+const claudeMax: ClaudeJsonView = { oauthAccount: { billingType: 'claude_max' } }
+
+describe('formatExpiresInRelative', () => {
+  it('returns null for missing / non-finite', () => {
+    expect(formatExpiresInRelative(undefined, NOW)).toBeNull()
+    expect(formatExpiresInRelative(NaN, NOW)).toBeNull()
+  })
+
+  it('returns "expired" when in the past', () => {
+    expect(formatExpiresInRelative(NOW - 1, NOW)).toBe('expired')
+    expect(formatExpiresInRelative(NOW - 86_400_000, NOW)).toBe('expired')
+  })
+
+  it('formats days for ≥ 24h', () => {
+    expect(formatExpiresInRelative(NOW + 29 * 86_400_000, NOW)).toBe('in 29 days')
+    expect(formatExpiresInRelative(NOW + 86_400_000, NOW)).toBe('in 1 day')
+  })
+
+  it('formats hours when < 24h but ≥ 1h', () => {
+    expect(formatExpiresInRelative(NOW + 5 * 3_600_000, NOW)).toBe('in 5 hours')
+    expect(formatExpiresInRelative(NOW + 3_600_000, NOW)).toBe('in 1 hour')
+  })
+
+  it('formats minutes when < 1h', () => {
+    expect(formatExpiresInRelative(NOW + 30 * 60_000, NOW)).toBe('in 30 minutes')
+    expect(formatExpiresInRelative(NOW + 60_000, NOW)).toBe('in 1 minute')
+  })
+})
+
+describe('buildAuthSummaryFromBroker', () => {
+  it('returns null when state is null', () => {
+    expect(buildAuthSummaryFromBroker(null, 'clerk', claudeMax, NOW)).toBeNull()
+  })
+
+  it('happy path — agent bound to a known account with future expiry', () => {
+    const summary = buildAuthSummaryFromBroker(state(), 'clerk', claudeMax, NOW)
+    expect(summary).toEqual({
+      authenticated: true,
+      subscription_type: 'Max',
+      expires_in: 'in 29 days',
+      auth_source: 'ken@example.com',
+    })
+  })
+
+  it('agent missing from broker.agents → not authenticated, no source', () => {
+    const summary = buildAuthSummaryFromBroker(state(), 'unknown-agent', claudeMax, NOW)
+    expect(summary).toEqual({
+      authenticated: false,
+      subscription_type: 'Max',
+      expires_in: null,
+      auth_source: null,
+    })
+  })
+
+  it('agent bound to an account broker has no record of → not authenticated', () => {
+    const s = state({
+      accounts: [], // no matching account
+      agents: [{ name: 'clerk', account: 'ghost@example.com', override: null }],
+    })
+    const summary = buildAuthSummaryFromBroker(s, 'clerk', claudeMax, NOW)
+    expect(summary?.authenticated).toBe(false)
+    expect(summary?.auth_source).toBe('ghost@example.com')
+    expect(summary?.expires_in).toBeNull()
+  })
+
+  it('expired account → authenticated stays true; expires_in says "expired"', () => {
+    const s = state({
+      accounts: [{ label: 'ken@example.com', expiresAt: NOW - 1, exhausted: false }],
+    })
+    const summary = buildAuthSummaryFromBroker(s, 'clerk', claudeMax, NOW)
+    expect(summary?.authenticated).toBe(true)
+    expect(summary?.expires_in).toBe('expired')
+  })
+
+  it('subscription_type pulled from claude.json — Pro tier', () => {
+    const summary = buildAuthSummaryFromBroker(
+      state(),
+      'clerk',
+      { oauthAccount: { billingType: 'claude_pro' } },
+      NOW,
+    )
+    expect(summary?.subscription_type).toBe('Pro')
+  })
+
+  it('subscription_type is null when claudeJson is missing', () => {
+    const summary = buildAuthSummaryFromBroker(state(), 'clerk', null, NOW)
+    expect(summary?.subscription_type).toBeNull()
+  })
+
+  it('passes through unknown billingType verbatim', () => {
+    const summary = buildAuthSummaryFromBroker(
+      state(),
+      'clerk',
+      { oauthAccount: { billingType: 'team' } },
+      NOW,
+    )
+    expect(summary?.subscription_type).toBe('team')
+  })
+
+  it('exhausted account still authenticated (quota state separate from auth state)', () => {
+    const s = state({
+      accounts: [{ label: 'ken@example.com', expiresAt: NOW + 86_400_000, exhausted: true }],
+    })
+    const summary = buildAuthSummaryFromBroker(s, 'clerk', claudeMax, NOW)
+    expect(summary?.authenticated).toBe(true)
+  })
+})