sidekick-shared 0.24.5 → 0.25.0

package/dist/modelContext.js

@@ -10,13 +10,19 @@
  *      model, persisted across runs by `observedContextWindows.ts`. Reflects the
  *      effective window for this account/tier, which can be well below the
  *      model's published maximum.
- *   3. Catalog overrides — `max_input_tokens` from the LiteLLM catalog, hydrated
+ *   3. Imported resolutions — exact entries hydrated from another realm via
+ *      `importResolvedModelCatalog()`. Below local observed data (a window this
+ *      realm saw first-hand is fresher than a transferred snapshot), above the
+ *      catalog.
+ *   4. Catalog overrides — `max_input_tokens` from the LiteLLM catalog, hydrated
  *      by `pricingCatalog.ts`. Keeps new models correct without a code change.
- *   4. The static table below — offline baseline of last resort.
+ *   5. The static table below — offline baseline of last resort.
  *
  * Within that order, match quality comes first: every layer is tried for an
  * exact hit before any layer is tried for a prefix hit. See
- * `getModelContextWindowSize`.
+ * `getModelContextWindowSize`. The raw (alias) id is tried before its
+ * canonical target at every step, so registering an alias never orphans data
+ * recorded under the alias itself.
  *
  * Layers 2 and 3 are pushed in by Node-only modules through the `_set*` hooks,
  * so this file stays browser-safe (no node:fs, no fetch) and can be bundled for
@@ -30,7 +36,12 @@ exports._clearObservedContextWindows = _clearObservedContextWindows;
 exports._setCatalogContextWindows = _setCatalogContextWindows;
 exports._getCatalogContextWindows = _getCatalogContextWindows;
 exports._clearCatalogContextWindows = _clearCatalogContextWindows;
+exports._setImportedResolvedContextWindows = _setImportedResolvedContextWindows;
+exports._clearImportedResolvedContextWindows = _clearImportedResolvedContextWindows;
+exports._getModelContextIds = _getModelContextIds;
+exports.resolveModelContextWindow = resolveModelContextWindow;
 exports.getModelContextWindowSize = getModelContextWindowSize;
+const modelAliases_1 = require("./modelAliases");
 /** Known model context window sizes (in tokens). */
 const MODEL_CONTEXT_SIZES = {
     // Claude — native 1M context (Fable 5, Opus 4.6+, Sonnet 4.6+)
@@ -92,6 +103,7 @@ let observedTable = {};
 let observedSortedKeys = [];
 let catalogTable = {};
 let catalogSortedKeys = [];
+let importedTable = {};
 function sortKeysLongestFirst(table) {
     return Object.keys(table).sort((a, b) => b.length - a.length);
 }
@@ -145,20 +157,109 @@ function _clearCatalogContextWindows() {
     catalogTable = {};
     catalogSortedKeys = [];
 }
+/**
+ * Internal: hydrate exact, already-resolved context data from another realm.
+ * Merges so successive partial imports accumulate (aliases already merge);
+ * use `_clearImportedResolvedContextWindows` to reset.
+ */
+function _setImportedResolvedContextWindows(values) {
+    importedTable = { ...importedTable, ...values };
+}
+/** Internal test hook. */
+function _clearImportedResolvedContextWindows() {
+    importedTable = {};
+}
+/** Internal: list every ID known to the context resolver. */
+function _getModelContextIds() {
+    return Array.from(new Set([
+        ...Object.keys(MODEL_CONTEXT_SIZES),
+        ...Object.keys(catalogTable),
+        ...Object.keys(observedTable),
+        ...Object.keys(importedTable),
+    ]));
+}
 // ── Lookup ──
 /** Exact match against one table. */
 function exactWindow(table, modelId) {
     const hit = table[modelId];
     return hit === undefined ? null : hit;
 }
-/** Longest-prefix match against one table. */
-function prefixWindow(table, sortedKeys, modelId) {
+function exactWindowMatch(table, modelId) {
+    const exact = exactWindow(table, modelId);
+    return exact === null ? null : { value: exact, match: 'exact', matchedModelId: modelId };
+}
+function prefixWindowMatch(table, sortedKeys, modelId) {
     for (const key of sortedKeys) {
-        if (modelId.startsWith(key))
-            return table[key];
+        if (modelId !== key && modelId.startsWith(key)) {
+            return { value: table[key], match: 'prefix', matchedModelId: key };
+        }
     }
     return null;
 }
+/** Resolve published, observed, and tier-effective context windows with provenance. */
+function resolveModelContextWindow(modelId) {
+    const rawModelId = modelId ?? '';
+    const stripped = rawModelId
+        .replace(/\[1m\]/gi, '')
+        .trim()
+        .toLowerCase();
+    const canonicalModelId = (0, modelAliases_1.resolveModelAlias)(stripped);
+    if (/\[1m\]/i.test(rawModelId) || /\[1m\]/i.test(canonicalModelId)) {
+        return {
+            modelId: rawModelId,
+            canonicalModelId: canonicalModelId.replace(/\[1m\]/gi, ''),
+            published: 1_000_000,
+            observed: null,
+            tierEffective: 1_000_000,
+            provenance: { source: 'explicit-1m', match: 'exact', matchedModelId: canonicalModelId },
+        };
+    }
+    // The raw id is tried before its alias target at every step: data recorded
+    // for the alias id itself is more specific than the canonical fallback.
+    const candidateIds = stripped === canonicalModelId ? [canonicalModelId] : [stripped, canonicalModelId];
+    const firstMatch = (lookup) => {
+        for (const id of candidateIds) {
+            const hit = lookup(id);
+            if (hit)
+                return hit;
+        }
+        return null;
+    };
+    const observedExact = firstMatch((id) => exactWindowMatch(observedTable, id));
+    // Imported resolutions rank below local observed data: a window this realm
+    // saw first-hand is fresher than a snapshot transferred from another realm.
+    if (!observedExact) {
+        const imported = importedTable[stripped] ?? importedTable[canonicalModelId];
+        if (imported) {
+            return { ...imported, modelId: rawModelId, canonicalModelId };
+        }
+    }
+    const catalogExact = firstMatch((id) => exactWindowMatch(catalogTable, id));
+    const staticExact = firstMatch((id) => exactWindowMatch(MODEL_CONTEXT_SIZES, id));
+    const observedPrefix = firstMatch((id) => prefixWindowMatch(observedTable, observedSortedKeys, id));
+    const catalogPrefix = firstMatch((id) => prefixWindowMatch(catalogTable, catalogSortedKeys, id));
+    const staticPrefix = firstMatch((id) => prefixWindowMatch(MODEL_CONTEXT_SIZES, SORTED_KEYS, id));
+    const published = catalogExact ?? staticExact ?? catalogPrefix ?? staticPrefix;
+    const effective = observedExact ?? catalogExact ?? staticExact ?? observedPrefix ?? catalogPrefix ?? staticPrefix;
+    return {
+        modelId: rawModelId,
+        canonicalModelId,
+        published: published?.value ?? null,
+        observed: (observedExact ?? observedPrefix)?.value ?? null,
+        tierEffective: effective?.value ?? exports.DEFAULT_CONTEXT_WINDOW,
+        provenance: effective
+            ? {
+                source: effective === observedExact || effective === observedPrefix
+                    ? 'observed'
+                    : effective === catalogExact || effective === catalogPrefix
+                        ? 'catalog'
+                        : 'static',
+                match: effective.match,
+                matchedModelId: effective.matchedModelId,
+            }
+            : { source: 'default', match: 'default' },
+    };
+}
 /**
  * Returns the context window size for a model ID.
  *
@@ -180,31 +281,5 @@ function prefixWindow(table, sortedKeys, modelId) {
  * of the static table's exact 1M.
  */
 function getModelContextWindowSize(modelId) {
-    if (!modelId)
-        return exports.DEFAULT_CONTEXT_WINDOW;
-    // Claude Code tags the 1M-context variant with a "[1m]" suffix on the
-    // model ID. If we see it, honor it regardless of the base family.
-    if (/\[1m\]/i.test(modelId))
-        return 1_000_000;
-    // Strip the suffix if present, so the normal lookup still succeeds when
-    // a caller passes e.g. "claude-opus-5[1m]" and we've already handled it.
-    // Trim/lowercase so padded or mixed-case IDs match the lowercase table keys.
-    const normalized = modelId
-        .replace(/\[1m\]/gi, '')
-        .trim()
-        .toLowerCase();
-    // Pass 1 — exact matches, most-trusted layer first.
-    const exact = exactWindow(observedTable, normalized) ??
-        exactWindow(catalogTable, normalized) ??
-        exactWindow(MODEL_CONTEXT_SIZES, normalized);
-    if (exact !== null)
-        return exact;
-    // Pass 2 — longest-prefix matches, same layer order. Resolves versioned IDs
-    // that no layer spells out, e.g. "claude-opus-4-6-20250414".
-    const prefix = prefixWindow(observedTable, observedSortedKeys, normalized) ??
-        prefixWindow(catalogTable, catalogSortedKeys, normalized) ??
-        prefixWindow(MODEL_CONTEXT_SIZES, SORTED_KEYS, normalized);
-    if (prefix !== null)
-        return prefix;
-    return exports.DEFAULT_CONTEXT_WINDOW;
+    return resolveModelContextWindow(modelId).tierEffective;
 }

package/dist/modelInfo.d.ts

@@ -17,6 +17,8 @@
  *
  * @module modelInfo
  */
+import type { ModelProviderId } from './providerIds';
+export { MODEL_PROVIDER_IDS } from './providerIds';
 /** Pricing information for a model. All costs are per million tokens in USD. */
 export interface ModelPricing {
     inputCostPerMillion: number;
@@ -24,6 +26,21 @@ export interface ModelPricing {
     cacheWriteCostPerMillion: number;
     cacheReadCostPerMillion: number;
 }
+export type ModelPricingSource = 'imported' | 'catalog' | 'static' | 'none';
+export type ModelPricingMatch = 'exact' | 'prefix' | 'none';
+export interface ModelPricingProvenance {
+    source: ModelPricingSource;
+    match: ModelPricingMatch;
+    matchedModelId?: string;
+    /** True when the price was inherited from a shorter model-ID prefix. */
+    inheritedByPrefix: boolean;
+}
+export interface ResolvedModelPricing {
+    modelId: string;
+    canonicalModelId: string;
+    pricing: ModelPricing | null;
+    provenance: ModelPricingProvenance;
+}
 /**
  * Token usage for the legacy cost calculation contract.
  * @deprecated Use NormalizedUsage and calculateNormalizedUsageCost. This shape
@@ -42,7 +59,7 @@ export interface CostTokenUsage {
     reasoningTokens?: number;
 }
 /** Provider that hosts a model. "unknown" means we couldn't classify it. */
-export type ModelProvider = 'anthropic' | 'openai' | 'google' | 'unknown';
+export type ModelProvider = ModelProviderId;
 /** Structured result of parsing a raw model ID. */
 export interface ParsedModelId {
     provider: ModelProvider;
@@ -93,6 +110,16 @@ export declare function _setPricingOverrides(overrides: Record<string, ModelPric
 export declare function _getPricingOverrides(): Record<string, ModelPricing>;
 /** Internal: clear overrides (used by tests and when disabling hydration). */
 export declare function _clearPricingOverrides(): void;
+/**
+ * Internal: hydrate exact pricing resolutions exported by another realm.
+ * Merges so successive partial imports accumulate (aliases already merge);
+ * use `_clearImportedResolvedPricing` to reset.
+ */
+export declare function _setImportedResolvedPricing(values: Record<string, ResolvedModelPricing>): void;
+/** Internal test hook. */
+export declare function _clearImportedResolvedPricing(): void;
+/** Internal: list every ID known to the pricing resolver. */
+export declare function _getModelPricingIds(): string[];
 /**
  * Parses a model ID into {provider, family, version}.
  *
@@ -103,6 +130,8 @@ export declare function _clearPricingOverrides(): void;
  * Returns null for anything else — callers should treat that as "unknown model".
  */
 export declare function parseModelId(modelId: string): ParsedModelId | null;
+/** Resolve pricing and disclose whether the result was inherited by prefix. */
+export declare function resolveModelPricing(modelId: string): ResolvedModelPricing;
 /**
  * Gets pricing for a model ID.
  *

package/dist/modelInfo.js

@@ -19,10 +19,15 @@
  * @module modelInfo
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_PROVIDER_IDS = void 0;
 exports._setPricingOverrides = _setPricingOverrides;
 exports._getPricingOverrides = _getPricingOverrides;
 exports._clearPricingOverrides = _clearPricingOverrides;
+exports._setImportedResolvedPricing = _setImportedResolvedPricing;
+exports._clearImportedResolvedPricing = _clearImportedResolvedPricing;
+exports._getModelPricingIds = _getModelPricingIds;
 exports.parseModelId = parseModelId;
+exports.resolveModelPricing = resolveModelPricing;
 exports.getModelPricing = getModelPricing;
 exports.getModelInfo = getModelInfo;
 exports.calculateCostWithPricing = calculateCostWithPricing;
@@ -35,6 +40,9 @@ exports.compareModelIds = compareModelIds;
 exports.sortModelIds = sortModelIds;
 exports.formatCost = formatCost;
 const modelContext_1 = require("./modelContext");
+const modelAliases_1 = require("./modelAliases");
+var providerIds_1 = require("./providerIds");
+Object.defineProperty(exports, "MODEL_PROVIDER_IDS", { enumerable: true, get: function () { return providerIds_1.MODEL_PROVIDER_IDS; } });
 // ── Static Pricing Table ──
 /**
  * Static baseline pricing. Keys are model-ID prefixes; lookup uses
@@ -412,6 +420,7 @@ const STATIC_SORTED_KEYS = Object.keys(PRICING_TABLE).sort((a, b) => b.length -
 // ── Override Table (populated at runtime by pricingCatalog) ──
 let overrideTable = {};
 let overrideSortedKeys = [];
+let importedTable = {};
 /**
  * Internal: replace the runtime override map. Called by `pricingCatalog.ts`
  * after a successful LiteLLM hydration. Not part of the stable public API,
@@ -419,7 +428,7 @@ let overrideSortedKeys = [];
  * creating a circular import.
  */
 function _setPricingOverrides(overrides) {
-    overrideTable = { ...overrides };
+    overrideTable = Object.fromEntries(Object.entries(overrides).map(([key, value]) => [key.trim().toLowerCase(), { ...value }]));
     overrideSortedKeys = Object.keys(overrideTable).sort((a, b) => b.length - a.length);
 }
 /** Internal: snapshot current overrides (test + diagnostics). */
@@ -431,6 +440,26 @@ function _clearPricingOverrides() {
     overrideTable = {};
     overrideSortedKeys = [];
 }
+/**
+ * Internal: hydrate exact pricing resolutions exported by another realm.
+ * Merges so successive partial imports accumulate (aliases already merge);
+ * use `_clearImportedResolvedPricing` to reset.
+ */
+function _setImportedResolvedPricing(values) {
+    importedTable = { ...importedTable, ...values };
+}
+/** Internal test hook. */
+function _clearImportedResolvedPricing() {
+    importedTable = {};
+}
+/** Internal: list every ID known to the pricing resolver. */
+function _getModelPricingIds() {
+    return Array.from(new Set([
+        ...Object.keys(PRICING_TABLE),
+        ...Object.keys(overrideTable),
+        ...Object.keys(importedTable),
+    ]));
+}
 // ── Model ID Parsing ──
 // Anthropic writes the minor version with a hyphen in modern IDs
 // (`claude-sonnet-4-6-20260321`) and a dot in older ones
@@ -454,10 +483,7 @@ const GEMINI_RE = /^gemini-([0-9][0-9.A-Za-z-]*)/i;
 function parseModelId(modelId) {
     if (!modelId)
         return null;
-    const normalized = modelId
-        .replace(/\[1m\]/gi, '')
-        .trim()
-        .toLowerCase();
+    const normalized = (0, modelAliases_1.resolveModelAlias)(modelId.replace(/\[1m\]/gi, ''));
     const claude = normalized.match(CLAUDE_RE);
     if (claude) {
         return {
@@ -490,27 +516,96 @@ function parseModelId(modelId) {
     return null;
 }
 // ── Pricing Lookup ──
-/** Find the longest key in `keys` that is a prefix of `modelId`, or null. */
+/** Find the longest shorter key in `keys` that is a prefix of `modelId`, or null. */
 function findLongestPrefix(keys, modelId) {
     for (const key of keys) {
-        if (modelId === key || modelId.startsWith(key))
+        if (modelId !== key && modelId.startsWith(key))
             return key;
     }
     return null;
 }
-/** Override-then-static lookup, exact then longest-prefix at each stage. */
-function lookupPricing(modelId) {
-    if (overrideTable[modelId])
-        return overrideTable[modelId];
-    const overridePrefix = findLongestPrefix(overrideSortedKeys, modelId);
-    if (overridePrefix)
-        return overrideTable[overridePrefix];
-    if (PRICING_TABLE[modelId])
-        return PRICING_TABLE[modelId];
-    const staticPrefix = findLongestPrefix(STATIC_SORTED_KEYS, modelId);
-    if (staticPrefix)
-        return PRICING_TABLE[staticPrefix];
-    return null;
+/** Resolve pricing and disclose whether the result was inherited by prefix. */
+function resolveModelPricing(modelId) {
+    const stripped = modelId.replace(/\[1m\]/gi, '');
+    const rawId = stripped.trim().toLowerCase();
+    const canonicalModelId = (0, modelAliases_1.resolveModelAlias)(stripped);
+    // The raw id is tried before its alias target at every step: pricing
+    // recorded for the alias id itself is more specific than the canonical
+    // fallback, so registering an alias never orphans it.
+    const candidateIds = rawId === canonicalModelId ? [canonicalModelId] : [rawId, canonicalModelId];
+    const imported = importedTable[rawId] ?? importedTable[canonicalModelId];
+    if (imported)
+        return { ...imported, modelId, canonicalModelId };
+    for (const id of candidateIds) {
+        const exactOverride = overrideTable[id];
+        if (exactOverride) {
+            return {
+                modelId,
+                canonicalModelId,
+                pricing: exactOverride,
+                provenance: {
+                    source: 'catalog',
+                    match: 'exact',
+                    matchedModelId: id,
+                    inheritedByPrefix: false,
+                },
+            };
+        }
+    }
+    for (const id of candidateIds) {
+        const exactStatic = PRICING_TABLE[id];
+        if (exactStatic) {
+            return {
+                modelId,
+                canonicalModelId,
+                pricing: exactStatic,
+                provenance: {
+                    source: 'static',
+                    match: 'exact',
+                    matchedModelId: id,
+                    inheritedByPrefix: false,
+                },
+            };
+        }
+    }
+    for (const id of candidateIds) {
+        const overridePrefix = findLongestPrefix(overrideSortedKeys, id);
+        if (overridePrefix) {
+            return {
+                modelId,
+                canonicalModelId,
+                pricing: overrideTable[overridePrefix],
+                provenance: {
+                    source: 'catalog',
+                    match: 'prefix',
+                    matchedModelId: overridePrefix,
+                    inheritedByPrefix: true,
+                },
+            };
+        }
+    }
+    for (const id of candidateIds) {
+        const staticPrefix = findLongestPrefix(STATIC_SORTED_KEYS, id);
+        if (staticPrefix) {
+            return {
+                modelId,
+                canonicalModelId,
+                pricing: PRICING_TABLE[staticPrefix],
+                provenance: {
+                    source: 'static',
+                    match: 'prefix',
+                    matchedModelId: staticPrefix,
+                    inheritedByPrefix: true,
+                },
+            };
+        }
+    }
+    return {
+        modelId,
+        canonicalModelId,
+        pricing: null,
+        provenance: { source: 'none', match: 'none', inheritedByPrefix: false },
+    };
 }
 /**
  * Gets pricing for a model ID.
@@ -530,12 +625,7 @@ function lookupPricing(modelId) {
 function getModelPricing(modelId) {
     if (!modelId)
         return null;
-    const stripped = modelId.replace(/\[1m\]/gi, '');
-    const direct = lookupPricing(stripped);
-    if (direct)
-        return direct;
-    const normalized = stripped.trim().toLowerCase();
-    return normalized === stripped ? null : lookupPricing(normalized);
+    return resolveModelPricing(modelId).pricing;
 }
 /**
  * Returns comprehensive metadata for a model ID.

package/dist/multiProviderQuotaService.d.ts

@@ -4,6 +4,7 @@ import type { PeakHoursState } from './peakHours';
 import type { QuotaState } from './quota';
 import type { Disposable } from './quotaPoller';
 import type { ProviderQuotaMap, ProviderQuotaState } from './providerQuota';
+import { type AccountsChangedEvent } from './accountChanges';
 type Logger = (message: string, error?: unknown) => void;
 interface CodexWatcherLike extends Disposable {
     start(): void;
@@ -28,6 +29,7 @@ export interface MultiProviderQuotaServiceOptions {
     readClaudeAccount?: typeof resolveActiveClaudeAccount;
     fetchClaudeQuota?: (accessToken: string) => Promise<QuotaState>;
     fetchPeakHours?: () => Promise<PeakHoursState>;
+    subscribeAccountsChanged?: (listener: (event: AccountsChangedEvent) => void) => Disposable;
     log?: Logger;
 }
 export declare class MultiProviderQuotaService implements Disposable {
@@ -41,6 +43,7 @@ export declare class MultiProviderQuotaService implements Disposable {
     private readonly fetchClaudeQuota;
     private readonly fetchPeakHours;
     private readonly log?;
+    private readonly subscribeAccountsChanged;
     private readonly listeners;
     private readonly codexWatcher;
     private readonly ownsCodexWatcher;
@@ -60,6 +63,10 @@ export declare class MultiProviderQuotaService implements Disposable {
     private currentPeakHours;
     private lastFreshPeakHoursAt;
     private peakHoursErrorLogged;
+    private claudeDormant;
+    private accountSubscription;
+    private pollInFlight;
+    private pendingWake;
     constructor(options?: MultiProviderQuotaServiceOptions);
     startPolling(): void;
     stopPolling(): void;
@@ -73,6 +80,7 @@ export declare class MultiProviderQuotaService implements Disposable {
     dispose(): void;
     private refreshPeakHours;
     private poll;
+    private wakeForAccountChange;
     private emitClaudeState;
     private handleUnavailableState;
     private handleTransientFailure;

package/dist/multiProviderQuotaService.js

@@ -7,10 +7,12 @@ const credentials_1 = require("./credentials");
 const peakHours_1 = require("./peakHours");
 const quota_1 = require("./quota");
 const quotaPresentation_1 = require("./quotaPresentation");
+const accountChanges_1 = require("./accountChanges");
 const ACTIVE_POLL_INTERVAL_MS = 60_000;
 const IDLE_POLL_INTERVAL_MS = 300_000;
 const TRANSIENT_FAILURE_BACKOFF_MS = [30_000, 60_000, 120_000, 240_000, 300_000];
 const PEAK_HOURS_CACHE_MAX_AGE_MS = 10 * 60 * 1000;
+const SIGNED_OUT_ERROR = 'Sign in to a Claude account to view quota';
 function makeUnavailableClaudeState(error, failureKind) {
     return {
         runtimeProvider: 'claude',
@@ -55,6 +57,7 @@ class MultiProviderQuotaService {
     fetchClaudeQuota;
     fetchPeakHours;
     log;
+    subscribeAccountsChanged;
     listeners = [];
     codexWatcher;
     ownsCodexWatcher;
@@ -74,6 +77,10 @@ class MultiProviderQuotaService {
     currentPeakHours;
     lastFreshPeakHoursAt = 0;
     peakHoursErrorLogged = false;
+    claudeDormant = false;
+    accountSubscription = null;
+    pollInFlight = false;
+    pendingWake = false;
     constructor(options = {}) {
         this.activeIntervalMs = options.activeIntervalMs ?? ACTIVE_POLL_INTERVAL_MS;
         this.idleIntervalMs = options.idleIntervalMs ?? IDLE_POLL_INTERVAL_MS;
@@ -85,6 +92,7 @@ class MultiProviderQuotaService {
         this.readClaudeAccount = options.readClaudeAccount ?? accounts_1.resolveActiveClaudeAccount;
         this.fetchClaudeQuota = options.fetchClaudeQuota ?? quota_1.fetchQuota;
         this.fetchPeakHours = options.fetchPeakHours ?? peakHours_1.fetchPeakHoursStatus;
+        this.subscribeAccountsChanged = options.subscribeAccountsChanged ?? accountChanges_1.onAccountsChanged;
         this.log = options.log;
         if (options.codexWatcher !== undefined) {
             this.codexWatcher = options.codexWatcher;
@@ -119,21 +127,25 @@ class MultiProviderQuotaService {
         if (this.polling)
             return;
         this.polling = true;
+        this.accountSubscription ??= this.subscribeAccountsChanged(() => this.wakeForAccountChange());
         this.codexWatcher?.start();
         this.zaiWatcher?.start();
-        void this.poll();
+        this.wakeForAccountChange();
         this.log?.('[Quota] Polling started');
     }
     stopPolling() {
         if (!this.polling)
             return;
         this.polling = false;
+        this.claudeDormant = false;
         if (this.timer) {
             clearTimeout(this.timer);
             this.timer = undefined;
         }
         this.codexWatcher?.stop();
         this.zaiWatcher?.stop();
+        this.accountSubscription?.dispose();
+        this.accountSubscription = null;
         this.log?.('[Quota] Polling stopped');
     }
     setPollingMode(mode) {
@@ -250,8 +262,35 @@ class MultiProviderQuotaService {
         this.currentPeakHours = result;
     }
     async poll() {
-        await this.refreshPeakHours();
+        if (!this.polling || this.pollInFlight) {
+            this.pendingWake = this.polling;
+            return;
+        }
+        this.pollInFlight = true;
+        this.pendingWake = false;
         try {
+            let accountPresent = false;
+            try {
+                accountPresent = this.readClaudeAccount().source !== 'none';
+            }
+            catch {
+                accountPresent = false;
+            }
+            if (!accountPresent) {
+                this.claudeDormant = true;
+                this.resetTransientFailureState();
+                this.authUnavailableActive = false;
+                this.lastSuccessfulClaudeState = null;
+                // Stay visible while dormant: consumers render their sign-in prompt
+                // from an unavailable auth entry, not from a missing map key.
+                if (this.quotaByProvider.claude?.error !== SIGNED_OUT_ERROR) {
+                    this.lastEmittedClaudeState = null;
+                    this.emitClaudeState(makeUnavailableClaudeState(SIGNED_OUT_ERROR, 'auth'));
+                }
+                return;
+            }
+            this.claudeDormant = false;
+            await this.refreshPeakHours();
             const creds = await this.readClaudeCredentials();
             if (!creds) {
                 this.handleUnavailableState(makeUnavailableClaudeState('Renew your Claude Max OAuth to view quota', 'auth'));
@@ -289,9 +328,31 @@ class MultiProviderQuotaService {
             this.handleTransientFailure(makeUnavailableClaudeState(message));
         }
         finally {
-            this.scheduleNextPoll();
+            this.pollInFlight = false;
+            if (this.pendingWake) {
+                this.pendingWake = false;
+                void this.poll();
+            }
+            else if (!this.claudeDormant) {
+                this.scheduleNextPoll();
+            }
         }
     }
+    wakeForAccountChange() {
+        if (!this.polling)
+            return;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        this.codexWatcher?.start();
+        this.zaiWatcher?.start();
+        if (this.pollInFlight) {
+            this.pendingWake = true;
+            return;
+        }
+        void this.poll();
+    }
     emitClaudeState(state) {
         const withPeakHours = this.currentPeakHours !== undefined ? { ...state, peakHours: this.currentPeakHours } : state;
         const withFailure = {

package/dist/node.d.ts

@@ -15,7 +15,7 @@ export { findCodexRolloutFile } from './providers/codex';
 export type { FindCodexRolloutFileOptions } from './providers/codex';
 export { readCodexHistory } from './parsers/codexHistory';
 export type { CodexHistoryEntry, ReadCodexHistoryOptions } from './parsers/codexHistory';
-export { listSessionPreviews, readSessionPreview } from './sessionPreviews';
-export type { ListSessionPreviewsOptions, ReadSessionPreviewOptions, SessionPreview, } from './sessionPreviews';
-export { ObservedSessionCollector, observedSessionSourceFromProvider, fileFingerprint, } from './observedSessionCollector';
-export type { ObservedSessionReference, ObservedSessionCollectionSource, ProviderObservedSessionCollectionSource, ObservedSessionDiagnosticKind, ObservedSessionDiagnostic, ObservedSessionCollection, ObservedSessionCollectorOptions, } from './observedSessionCollector';
+export { listSessionPreviews, listSessionPreviewsAsync, readSessionPreview, readSessionPreviewAsync, } from './sessionPreviews';
+export type { AsyncSessionPreviewOptions, ListSessionPreviewsAsyncOptions, ListSessionPreviewsOptions, ReadSessionPreviewAsyncOptions, ReadSessionPreviewOptions, SessionPreview, SessionPreviewListResult, SessionPreviewReadResult, } from './sessionPreviews';
+export { ObservedSessionCollector, observedSessionSourceFromProvider, fileFingerprint, fileFingerprintParts, } from './observedSessionCollector';
+export type { KnownObservedSessionFingerprint, ObservedSessionChange, ObservedSessionChangeBatch, ObservedSessionChangeType, ObservedSessionReference, ObservedSessionFingerprintParts, ObservedSessionSourceSubscribeOptions, ObservedSessionSubscribeOptions, ObservedSessionCollectionSource, ProviderObservedSessionCollectionSource, ObservedSessionDiagnosticKind, ObservedSessionDiagnosticPhase, ObservedSessionDiagnosticSeverity, ObservedSessionDiagnostic, ObservedSessionCollection, ObservedSessionCollectorOptions, } from './observedSessionCollector';

package/dist/node.js

@@ -7,7 +7,7 @@
  * for browser bundles — use `sidekick-shared/browser` there.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fileFingerprint = exports.observedSessionSourceFromProvider = exports.ObservedSessionCollector = exports.readSessionPreview = exports.listSessionPreviews = exports.readCodexHistory = exports.findCodexRolloutFile = exports.readSessionTranscript = exports.listRecentSessions = exports.getObservedContextWindowPath = exports.recordObservedContextWindow = exports.loadObservedContextWindows = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmContextWindows = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = void 0;
+exports.fileFingerprintParts = exports.fileFingerprint = exports.observedSessionSourceFromProvider = exports.ObservedSessionCollector = exports.readSessionPreviewAsync = exports.readSessionPreview = exports.listSessionPreviewsAsync = exports.listSessionPreviews = exports.readCodexHistory = exports.findCodexRolloutFile = exports.readSessionTranscript = exports.listRecentSessions = exports.getObservedContextWindowPath = exports.recordObservedContextWindow = exports.loadObservedContextWindows = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmContextWindows = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = void 0;
 var pricingCatalog_1 = require("./pricingCatalog");
 Object.defineProperty(exports, "hydratePricingCatalog", { enumerable: true, get: function () { return pricingCatalog_1.hydratePricingCatalog; } });
 Object.defineProperty(exports, "normalizeLiteLlmCatalog", { enumerable: true, get: function () { return pricingCatalog_1.normalizeLiteLlmCatalog; } });
@@ -26,8 +26,11 @@ var codexHistory_1 = require("./parsers/codexHistory");
 Object.defineProperty(exports, "readCodexHistory", { enumerable: true, get: function () { return codexHistory_1.readCodexHistory; } });
 var sessionPreviews_1 = require("./sessionPreviews");
 Object.defineProperty(exports, "listSessionPreviews", { enumerable: true, get: function () { return sessionPreviews_1.listSessionPreviews; } });
+Object.defineProperty(exports, "listSessionPreviewsAsync", { enumerable: true, get: function () { return sessionPreviews_1.listSessionPreviewsAsync; } });
 Object.defineProperty(exports, "readSessionPreview", { enumerable: true, get: function () { return sessionPreviews_1.readSessionPreview; } });
+Object.defineProperty(exports, "readSessionPreviewAsync", { enumerable: true, get: function () { return sessionPreviews_1.readSessionPreviewAsync; } });
 var observedSessionCollector_1 = require("./observedSessionCollector");
 Object.defineProperty(exports, "ObservedSessionCollector", { enumerable: true, get: function () { return observedSessionCollector_1.ObservedSessionCollector; } });
 Object.defineProperty(exports, "observedSessionSourceFromProvider", { enumerable: true, get: function () { return observedSessionCollector_1.observedSessionSourceFromProvider; } });
 Object.defineProperty(exports, "fileFingerprint", { enumerable: true, get: function () { return observedSessionCollector_1.fileFingerprint; } });
+Object.defineProperty(exports, "fileFingerprintParts", { enumerable: true, get: function () { return observedSessionCollector_1.fileFingerprintParts; } });