sidekick-shared 0.28.1 → 0.28.3

package/dist/quotaSnapshots.js

@@ -83,6 +83,27 @@ function windowResetMs(value) {
     const ms = Date.parse(value);
     return Number.isFinite(ms) ? ms : 0;
 }
+/**
+ * Rank two samples by one window's reset time. A later reset means a newer
+ * window, so it wins — except that an existing window which had already reset
+ * by the time the newer sample was captured is obsolete and always yields.
+ * Without that exception a pre-reset sample outranks every later sample whose
+ * window has not started yet (empty reset), and the snapshot freezes.
+ * Returns `undefined` when the reset times tie.
+ */
+function compareWindowResets(existing, next, asOfMs) {
+    const existingReset = windowResetMs(existing.resetsAt);
+    const nextReset = windowResetMs(next.resetsAt);
+    if (existingReset === nextReset)
+        return undefined;
+    if (existingReset > 0 && asOfMs > 0 && existingReset <= asOfMs)
+        return false;
+    return existingReset > nextReset;
+}
+function windowPresenceChanged(existing, next) {
+    return (Boolean(existing.fiveHour.absent) !== Boolean(next.fiveHour.absent) ||
+        Boolean(existing.sevenDay.absent) !== Boolean(next.sevenDay.absent));
+}
 // Preserve the best-known same-window snapshot while still allowing lower
 // utilization after Codex advances to a newer reset window.
 function shouldKeepExistingSnapshot(existing, next) {
@@ -95,20 +116,50 @@ function shouldKeepExistingSnapshot(existing, next) {
     const nextAggregate = (0, codex_1.isAggregateCodexLimit)(next.limitId);
     if (existingAggregate !== nextAggregate)
         return existingAggregate;
-    const existingPrimaryReset = windowResetMs(existing.fiveHour.resetsAt);
-    const nextPrimaryReset = windowResetMs(next.fiveHour.resetsAt);
-    if (existingPrimaryReset !== nextPrimaryReset)
-        return existingPrimaryReset > nextPrimaryReset;
-    const existingSecondaryReset = windowResetMs(existing.sevenDay.resetsAt);
-    const nextSecondaryReset = windowResetMs(next.sevenDay.resetsAt);
-    if (existingSecondaryReset !== nextSecondaryReset)
-        return existingSecondaryReset > nextSecondaryReset;
+    // The plan's window layout changed (a window appeared or disappeared): the
+    // reset times are not comparable, so the newer capture wins.
+    if (windowPresenceChanged(existing, next)) {
+        return snapshotTimeMs(existing) > snapshotTimeMs(next);
+    }
+    const asOfMs = snapshotTimeMs(next);
+    const primary = compareWindowResets(existing.fiveHour, next.fiveHour, asOfMs);
+    if (primary !== undefined)
+        return primary;
+    const secondary = compareWindowResets(existing.sevenDay, next.sevenDay, asOfMs);
+    if (secondary !== undefined)
+        return secondary;
     const existingUtilization = existing.fiveHour.utilization + existing.sevenDay.utilization;
     const nextUtilization = next.fiveHour.utilization + next.sevenDay.utilization;
     if (existingUtilization !== nextUtilization)
         return existingUtilization > nextUtilization;
     return snapshotTimeMs(existing) > snapshotTimeMs(next);
 }
+/**
+ * Status-line and history samples only know the two headline windows. Keep
+ * the plan label, extra usage, and still-running extra meters (e.g. a Fable
+ * weekly cap) an earlier API sample recorded, so a fresh status-line write
+ * does not erase them from every snapshot reader.
+ */
+function carryApiOnlyFields(existing, next) {
+    const merged = { ...next };
+    if (merged.planLabel === undefined && existing.planLabel !== undefined) {
+        merged.planLabel = existing.planLabel;
+    }
+    if (merged.planType === undefined && existing.planType !== undefined) {
+        merged.planType = existing.planType;
+    }
+    if (merged.extraUsage === undefined && existing.extraUsage !== undefined) {
+        merged.extraUsage = existing.extraUsage;
+    }
+    if (merged.limits === undefined && existing.limits !== undefined) {
+        const asOfMs = snapshotTimeMs(next);
+        // Headline meters duplicate the fresher windows on `next`; carry only the extras.
+        const running = (0, quota_1.extraQuotaRows)(existing).filter((row) => windowResetMs(row.resetsAt) > asOfMs);
+        if (running.length > 0)
+            merged.limits = running;
+    }
+    return merged;
+}
 function writeQuotaSnapshot(providerId, accountId, quota) {
     withSnapshotStoreLock(() => {
         const store = readStore();
@@ -130,7 +181,11 @@ function writeQuotaSnapshot(providerId, accountId, quota) {
         };
         if (index >= 0 && shouldKeepExistingSnapshot(store.snapshots[index].quota, snapshot))
             return;
-        const record = { providerId, accountId, quota: snapshot };
+        const record = {
+            providerId,
+            accountId,
+            quota: existingQuota ? carryApiOnlyFields(existingQuota, snapshot) : snapshot,
+        };
         if (index >= 0)
             store.snapshots[index] = record;
         else

package/dist/quotaThresholds.js

@@ -55,8 +55,13 @@ function evaluateWindow(window, quota, thresholds, previous) {
 function evaluateQuotaThresholds(quota, config = exports.DEFAULT_QUOTA_THRESHOLDS, memory = {}) {
     if (!quota.available)
         return { alerts: [], memory };
-    const fiveHour = evaluateWindow('fiveHour', quota.fiveHour, config.fiveHour, memory.fiveHour);
-    const sevenDay = evaluateWindow('sevenDay', quota.sevenDay, config.sevenDay, memory.sevenDay);
+    // A window the plan does not have (Ultra's missing five-hour limit) never alerts.
+    const fiveHour = quota.fiveHour.absent
+        ? { alert: null, memory: memory.fiveHour ?? { resetsAt: '', level: 0 } }
+        : evaluateWindow('fiveHour', quota.fiveHour, config.fiveHour, memory.fiveHour);
+    const sevenDay = quota.sevenDay.absent
+        ? { alert: null, memory: memory.sevenDay ?? { resetsAt: '', level: 0 } }
+        : evaluateWindow('sevenDay', quota.sevenDay, config.sevenDay, memory.sevenDay);
     return {
         alerts: [fiveHour.alert, sevenDay.alert].filter((alert) => alert !== null),
         memory: { fiveHour: fiveHour.memory, sevenDay: sevenDay.memory },

package/dist/schemas/index.d.ts

@@ -23,7 +23,7 @@ export { transcriptSourceProvenanceSchema, canonicalTranscriptBlockSchema, canon
 export type { CanonicalSessionTranscript, CanonicalTranscriptMessage, CanonicalToolCall, TranscriptSourceProvenance, } from '../transcript';
 export { observationProvenanceV1Schema, observedAgentSessionV1Schema, observedValueV1Schema, pendingUserRequestV1Schema, providerCapabilitiesV1Schema, providerSessionAdapterV1Schema, sessionEvidenceRefV1Schema, } from './observedSessionV1';
 export type { ObservationProvenanceV1, ObservedAgentSessionV1, ObservedValueV1, PendingUserRequestV1, ProviderCapabilitiesV1, ProviderSessionAdapterV1, SessionEvidenceRefV1, } from '../types/observedSessionV1';
-export { quotaWindowSchema, quotaStateSchema, quotaFailureKindSchema, quotaProviderIdSchema, quotaSourceSchema, codexResetCreditSchema, codexResetCreditsSnapshotSchema, peakHoursStateSchema, quotaFailureDescriptorSchema, runtimeQuotaProviderSchema, providerQuotaStateSchema, claudeProviderQuotaStateSchema, codexProviderQuotaStateSchema, zaiProviderQuotaStateSchema, providerQuotaMapSchema, } from './quota';
+export { quotaWindowSchema, quotaStateSchema, quotaLimitRowSchema, quotaExtraUsageSchema, quotaFailureKindSchema, quotaProviderIdSchema, quotaSourceSchema, codexResetCreditSchema, codexResetCreditsSnapshotSchema, peakHoursStateSchema, quotaFailureDescriptorSchema, runtimeQuotaProviderSchema, providerQuotaStateSchema, claudeProviderQuotaStateSchema, codexProviderQuotaStateSchema, zaiProviderQuotaStateSchema, providerQuotaMapSchema, } from './quota';
 export type { CodexResetCredit, CodexResetCreditsSnapshot, QuotaWindow, QuotaState, } from '../quota';
 export type { PeakHoursState } from '../peakHours';
 export type { QuotaFailureDescriptor } from '../quotaPresentation';
@@ -43,5 +43,5 @@ export type { AccountLaunchEnv } from '../accountLaunch';
 export type { RunningAccountConsumer, RunningProcess } from '../processDetection';
 export { assistantTurnEventSchema, assistantTurnEventTypeSchema, assistantTurnNarrationStepSchema, assistantTurnProcessSchema, assistantTurnProcessStepSchema, assistantTurnProjectionSchema, assistantTurnReasoningTimelineItemSchema, assistantTurnSubagentSchema, assistantTurnSubagentStatusSchema, assistantTurnTimelineItemSchema, assistantTurnToolGroupStepSchema, assistantTurnToolRefSchema, } from './assistantTurn';
 export type { AssistantTurnEvent, AssistantTurnEventType, AssistantTurnProcess, AssistantTurnProcessStep, AssistantTurnProjection, AssistantTurnSubagent, AssistantTurnSubagentStatus, AssistantTurnTimelineItem, AssistantTurnToolRef, } from '../turns/assistantTurn';
-export { sidekickStateFileSchema, stateFileAccountSchema, stateFileBillingBlockSchema, stateFileContextSchema, stateFileQuotaSchema, stateFileQuotaWindowSchema, stateFileSessionSchema, stateFileWriterSchema, } from './stateFile';
-export type { SidekickStateFile, StateFileAccount, StateFileBillingBlock, StateFileContext, StateFileQuota, StateFileQuotaWindow, StateFileSession, StateFileWriter, } from '../stateFile';
+export { sidekickStateFileSchema, stateFileAccountSchema, stateFileBillingBlockSchema, stateFileContextSchema, stateFileQuotaSchema, stateFileQuotaWindowSchema, stateFileQuotaLimitSchema, stateFileSessionSchema, stateFileWriterSchema, } from './stateFile';
+export type { SidekickStateFile, StateFileAccount, StateFileBillingBlock, StateFileContext, StateFileQuota, StateFileQuotaWindow, StateFileQuotaLimit, StateFileSession, StateFileWriter, } from '../stateFile';

package/dist/schemas/index.js

@@ -12,8 +12,8 @@
  * subpath is self-sufficient for boundary-validation modules.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.quotaHistoryRuntimeProviderSchema = exports.providerQuotaMapSchema = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaStateSchema = exports.quotaWindowSchema = exports.sessionEvidenceRefV1Schema = exports.providerSessionAdapterV1Schema = exports.providerCapabilitiesV1Schema = exports.pendingUserRequestV1Schema = exports.observedValueV1Schema = exports.observedAgentSessionV1Schema = exports.observationProvenanceV1Schema = exports.canonicalSessionTranscriptSchema = exports.canonicalTranscriptMessageSchema = exports.canonicalToolCallSchema = exports.canonicalTranscriptBlockSchema = exports.transcriptSourceProvenanceSchema = exports.providerFailureDiagnosisSchema = exports.providerRetryAfterSchema = exports.providerFailureEvidenceSchema = exports.providerAuthenticationEvidenceSchema = exports.tokenEstimateSchema = exports.normalizedUsageCostSchema = exports.normalizedUsageSchema = exports.toolResultSessionEventSchema = exports.toolUseSessionEventSchema = exports.systemSessionEventSchema = exports.summarySessionEventSchema = exports.assistantSessionEventSchema = exports.userSessionEventSchema = exports.extractSessionEvents = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = exports.SESSION_PROVIDER_IDS = exports.RUNTIME_QUOTA_PROVIDER_IDS = exports.QUOTA_PROVIDER_IDS = exports.ACCOUNT_PROVIDER_IDS = void 0;
-exports.stateFileWriterSchema = exports.stateFileSessionSchema = exports.stateFileQuotaWindowSchema = exports.stateFileQuotaSchema = exports.stateFileContextSchema = exports.stateFileBillingBlockSchema = exports.stateFileAccountSchema = exports.sidekickStateFileSchema = exports.assistantTurnToolRefSchema = exports.assistantTurnToolGroupStepSchema = exports.assistantTurnTimelineItemSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnReasoningTimelineItemSchema = exports.assistantTurnProjectionSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnProcessSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnEventTypeSchema = exports.assistantTurnEventSchema = exports.accountLaunchEnvSchema = exports.syncReportSchema = exports.providerSyncReportSchema = exports.lastSwitchRecordSchema = exports.switchAccountResultSchema = exports.runningAccountConsumerSchema = exports.accountConsumerKindSchema = exports.runningProcessSchema = exports.accountViewSchema = exports.accountHealthSchema = exports.accountHealthSidecarSchema = exports.accountHealthSourceSchema = exports.accountHealthStateSchema = exports.listAllAccountsResultSchema = exports.savedAccountProfileSchema = exports.accountEntrySchema = exports.accountLoginStatusSchema = exports.beginAccountLoginResultSchema = exports.accountManagerResultSchema = exports.accountProviderIdSchema = exports.activeAccountStatusSchema = exports.activeProviderAccountStatusSchema = exports.quotaHistoryDailyBucketSchema = exports.quotaHistorySampleSchema = void 0;
+exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaExtraUsageSchema = exports.quotaLimitRowSchema = exports.quotaStateSchema = exports.quotaWindowSchema = exports.sessionEvidenceRefV1Schema = exports.providerSessionAdapterV1Schema = exports.providerCapabilitiesV1Schema = exports.pendingUserRequestV1Schema = exports.observedValueV1Schema = exports.observedAgentSessionV1Schema = exports.observationProvenanceV1Schema = exports.canonicalSessionTranscriptSchema = exports.canonicalTranscriptMessageSchema = exports.canonicalToolCallSchema = exports.canonicalTranscriptBlockSchema = exports.transcriptSourceProvenanceSchema = exports.providerFailureDiagnosisSchema = exports.providerRetryAfterSchema = exports.providerFailureEvidenceSchema = exports.providerAuthenticationEvidenceSchema = exports.tokenEstimateSchema = exports.normalizedUsageCostSchema = exports.normalizedUsageSchema = exports.toolResultSessionEventSchema = exports.toolUseSessionEventSchema = exports.systemSessionEventSchema = exports.summarySessionEventSchema = exports.assistantSessionEventSchema = exports.userSessionEventSchema = exports.extractSessionEvents = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = exports.SESSION_PROVIDER_IDS = exports.RUNTIME_QUOTA_PROVIDER_IDS = exports.QUOTA_PROVIDER_IDS = exports.ACCOUNT_PROVIDER_IDS = void 0;
+exports.stateFileWriterSchema = exports.stateFileSessionSchema = exports.stateFileQuotaLimitSchema = exports.stateFileQuotaWindowSchema = exports.stateFileQuotaSchema = exports.stateFileContextSchema = exports.stateFileBillingBlockSchema = exports.stateFileAccountSchema = exports.sidekickStateFileSchema = exports.assistantTurnToolRefSchema = exports.assistantTurnToolGroupStepSchema = exports.assistantTurnTimelineItemSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnReasoningTimelineItemSchema = exports.assistantTurnProjectionSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnProcessSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnEventTypeSchema = exports.assistantTurnEventSchema = exports.accountLaunchEnvSchema = exports.syncReportSchema = exports.providerSyncReportSchema = exports.lastSwitchRecordSchema = exports.switchAccountResultSchema = exports.runningAccountConsumerSchema = exports.accountConsumerKindSchema = exports.runningProcessSchema = exports.accountViewSchema = exports.accountHealthSchema = exports.accountHealthSidecarSchema = exports.accountHealthSourceSchema = exports.accountHealthStateSchema = exports.listAllAccountsResultSchema = exports.savedAccountProfileSchema = exports.accountEntrySchema = exports.accountLoginStatusSchema = exports.beginAccountLoginResultSchema = exports.accountManagerResultSchema = exports.accountProviderIdSchema = exports.activeAccountStatusSchema = exports.activeProviderAccountStatusSchema = exports.quotaHistoryDailyBucketSchema = exports.quotaHistorySampleSchema = exports.quotaHistoryRuntimeProviderSchema = exports.providerQuotaMapSchema = void 0;
 var providerIds_1 = require("../providerIds");
 Object.defineProperty(exports, "ACCOUNT_PROVIDER_IDS", { enumerable: true, get: function () { return providerIds_1.ACCOUNT_PROVIDER_IDS; } });
 Object.defineProperty(exports, "QUOTA_PROVIDER_IDS", { enumerable: true, get: function () { return providerIds_1.QUOTA_PROVIDER_IDS; } });
@@ -58,6 +58,8 @@ Object.defineProperty(exports, "sessionEvidenceRefV1Schema", { enumerable: true,
 var quota_1 = require("./quota");
 Object.defineProperty(exports, "quotaWindowSchema", { enumerable: true, get: function () { return quota_1.quotaWindowSchema; } });
 Object.defineProperty(exports, "quotaStateSchema", { enumerable: true, get: function () { return quota_1.quotaStateSchema; } });
+Object.defineProperty(exports, "quotaLimitRowSchema", { enumerable: true, get: function () { return quota_1.quotaLimitRowSchema; } });
+Object.defineProperty(exports, "quotaExtraUsageSchema", { enumerable: true, get: function () { return quota_1.quotaExtraUsageSchema; } });
 Object.defineProperty(exports, "quotaFailureKindSchema", { enumerable: true, get: function () { return quota_1.quotaFailureKindSchema; } });
 Object.defineProperty(exports, "quotaProviderIdSchema", { enumerable: true, get: function () { return quota_1.quotaProviderIdSchema; } });
 Object.defineProperty(exports, "quotaSourceSchema", { enumerable: true, get: function () { return quota_1.quotaSourceSchema; } });
@@ -119,5 +121,6 @@ Object.defineProperty(exports, "stateFileBillingBlockSchema", { enumerable: true
 Object.defineProperty(exports, "stateFileContextSchema", { enumerable: true, get: function () { return stateFile_1.stateFileContextSchema; } });
 Object.defineProperty(exports, "stateFileQuotaSchema", { enumerable: true, get: function () { return stateFile_1.stateFileQuotaSchema; } });
 Object.defineProperty(exports, "stateFileQuotaWindowSchema", { enumerable: true, get: function () { return stateFile_1.stateFileQuotaWindowSchema; } });
+Object.defineProperty(exports, "stateFileQuotaLimitSchema", { enumerable: true, get: function () { return stateFile_1.stateFileQuotaLimitSchema; } });
 Object.defineProperty(exports, "stateFileSessionSchema", { enumerable: true, get: function () { return stateFile_1.stateFileSessionSchema; } });
 Object.defineProperty(exports, "stateFileWriterSchema", { enumerable: true, get: function () { return stateFile_1.stateFileWriterSchema; } });

package/dist/schemas/quota.d.ts

@@ -12,6 +12,32 @@ import { z } from 'zod';
 export declare const quotaWindowSchema: z.ZodObject<{
     utilization: z.ZodNumber;
     resetsAt: z.ZodString;
+    absent: z.ZodOptional<z.ZodBoolean>;
+    windowMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const quotaLimitRowSchema: z.ZodObject<{
+    kind: z.ZodString;
+    group: z.ZodString;
+    label: z.ZodString;
+    utilization: z.ZodNumber;
+    resetsAt: z.ZodString;
+    windowMs: z.ZodOptional<z.ZodNumber>;
+    projected: z.ZodOptional<z.ZodNumber>;
+    scopeModel: z.ZodOptional<z.ZodString>;
+    scopeSurface: z.ZodOptional<z.ZodString>;
+    severity: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    allowancePercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+    usedPercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const quotaExtraUsageSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    monthlyLimit: z.ZodNullable<z.ZodNumber>;
+    usedCredits: z.ZodNullable<z.ZodNumber>;
+    utilization: z.ZodNullable<z.ZodNumber>;
+    currency: z.ZodOptional<z.ZodString>;
+    decimalPlaces: z.ZodOptional<z.ZodNumber>;
+    disabledReason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const quotaFailureKindSchema: z.ZodEnum<{
     unknown: "unknown";
@@ -68,10 +94,14 @@ export declare const quotaStateSchema: z.ZodObject<{
     fiveHour: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
+        windowMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     sevenDay: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
+        windowMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     available: z.ZodBoolean;
     error: z.ZodOptional<z.ZodString>;
@@ -132,7 +162,32 @@ export declare const quotaStateSchema: z.ZodObject<{
         capturedAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     planType: z.ZodOptional<z.ZodString>;
+    planLabel: z.ZodOptional<z.ZodString>;
     rateLimitReachedType: z.ZodOptional<z.ZodString>;
+    limits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        group: z.ZodString;
+        label: z.ZodString;
+        utilization: z.ZodNumber;
+        resetsAt: z.ZodString;
+        windowMs: z.ZodOptional<z.ZodNumber>;
+        projected: z.ZodOptional<z.ZodNumber>;
+        scopeModel: z.ZodOptional<z.ZodString>;
+        scopeSurface: z.ZodOptional<z.ZodString>;
+        severity: z.ZodOptional<z.ZodString>;
+        isActive: z.ZodOptional<z.ZodBoolean>;
+        allowancePercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+        usedPercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    extraUsage: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        monthlyLimit: z.ZodNullable<z.ZodNumber>;
+        usedCredits: z.ZodNullable<z.ZodNumber>;
+        utilization: z.ZodNullable<z.ZodNumber>;
+        currency: z.ZodOptional<z.ZodString>;
+        decimalPlaces: z.ZodOptional<z.ZodNumber>;
+        disabledReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const peakHoursStateSchema: z.ZodObject<{
     status: z.ZodEnum<{
@@ -180,10 +235,14 @@ export declare const providerQuotaStateSchema: z.ZodObject<{
     fiveHour: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
+        windowMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     sevenDay: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
+        windowMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     available: z.ZodBoolean;
     error: z.ZodOptional<z.ZodString>;
@@ -244,7 +303,32 @@ export declare const providerQuotaStateSchema: z.ZodObject<{
         capturedAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     planType: z.ZodOptional<z.ZodString>;
+    planLabel: z.ZodOptional<z.ZodString>;
     rateLimitReachedType: z.ZodOptional<z.ZodString>;
+    limits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        group: z.ZodString;
+        label: z.ZodString;
+        utilization: z.ZodNumber;
+        resetsAt: z.ZodString;
+        windowMs: z.ZodOptional<z.ZodNumber>;
+        projected: z.ZodOptional<z.ZodNumber>;
+        scopeModel: z.ZodOptional<z.ZodString>;
+        scopeSurface: z.ZodOptional<z.ZodString>;
+        severity: z.ZodOptional<z.ZodString>;
+        isActive: z.ZodOptional<z.ZodBoolean>;
+        allowancePercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+        usedPercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    extraUsage: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        monthlyLimit: z.ZodNullable<z.ZodNumber>;
+        usedCredits: z.ZodNullable<z.ZodNumber>;
+        utilization: z.ZodNullable<z.ZodNumber>;
+        currency: z.ZodOptional<z.ZodString>;
+        decimalPlaces: z.ZodOptional<z.ZodNumber>;
+        disabledReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     accountLabel: z.ZodOptional<z.ZodString>;
     accountDetail: z.ZodOptional<z.ZodString>;
     peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -294,10 +378,14 @@ export declare const claudeProviderQuotaStateSchema: z.ZodObject<{
     fiveHour: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
+        windowMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     sevenDay: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
+        windowMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     available: z.ZodBoolean;
     error: z.ZodOptional<z.ZodString>;
@@ -358,7 +446,32 @@ export declare const claudeProviderQuotaStateSchema: z.ZodObject<{
         capturedAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     planType: z.ZodOptional<z.ZodString>;
+    planLabel: z.ZodOptional<z.ZodString>;
     rateLimitReachedType: z.ZodOptional<z.ZodString>;
+    limits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        group: z.ZodString;
+        label: z.ZodString;
+        utilization: z.ZodNumber;
+        resetsAt: z.ZodString;
+        windowMs: z.ZodOptional<z.ZodNumber>;
+        projected: z.ZodOptional<z.ZodNumber>;
+        scopeModel: z.ZodOptional<z.ZodString>;
+        scopeSurface: z.ZodOptional<z.ZodString>;
+        severity: z.ZodOptional<z.ZodString>;
+        isActive: z.ZodOptional<z.ZodBoolean>;
+        allowancePercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+        usedPercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    extraUsage: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        monthlyLimit: z.ZodNullable<z.ZodNumber>;
+        usedCredits: z.ZodNullable<z.ZodNumber>;
+        utilization: z.ZodNullable<z.ZodNumber>;
+        currency: z.ZodOptional<z.ZodString>;
+        decimalPlaces: z.ZodOptional<z.ZodNumber>;
+        disabledReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     accountLabel: z.ZodOptional<z.ZodString>;
     accountDetail: z.ZodOptional<z.ZodString>;
     peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -404,10 +517,14 @@ export declare const codexProviderQuotaStateSchema: z.ZodObject<{
     fiveHour: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
+        windowMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     sevenDay: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
+        windowMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     available: z.ZodBoolean;
     error: z.ZodOptional<z.ZodString>;
@@ -468,7 +585,32 @@ export declare const codexProviderQuotaStateSchema: z.ZodObject<{
         capturedAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     planType: z.ZodOptional<z.ZodString>;
+    planLabel: z.ZodOptional<z.ZodString>;
     rateLimitReachedType: z.ZodOptional<z.ZodString>;
+    limits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        group: z.ZodString;
+        label: z.ZodString;
+        utilization: z.ZodNumber;
+        resetsAt: z.ZodString;
+        windowMs: z.ZodOptional<z.ZodNumber>;
+        projected: z.ZodOptional<z.ZodNumber>;
+        scopeModel: z.ZodOptional<z.ZodString>;
+        scopeSurface: z.ZodOptional<z.ZodString>;
+        severity: z.ZodOptional<z.ZodString>;
+        isActive: z.ZodOptional<z.ZodBoolean>;
+        allowancePercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+        usedPercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    extraUsage: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        monthlyLimit: z.ZodNullable<z.ZodNumber>;
+        usedCredits: z.ZodNullable<z.ZodNumber>;
+        utilization: z.ZodNullable<z.ZodNumber>;
+        currency: z.ZodOptional<z.ZodString>;
+        decimalPlaces: z.ZodOptional<z.ZodNumber>;
+        disabledReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     accountLabel: z.ZodOptional<z.ZodString>;
     accountDetail: z.ZodOptional<z.ZodString>;
     peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -514,10 +656,14 @@ export declare const zaiProviderQuotaStateSchema: z.ZodObject<{
     fiveHour: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
+        windowMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     sevenDay: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
+        windowMs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     available: z.ZodBoolean;
     error: z.ZodOptional<z.ZodString>;
@@ -578,7 +724,32 @@ export declare const zaiProviderQuotaStateSchema: z.ZodObject<{
         capturedAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     planType: z.ZodOptional<z.ZodString>;
+    planLabel: z.ZodOptional<z.ZodString>;
     rateLimitReachedType: z.ZodOptional<z.ZodString>;
+    limits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        group: z.ZodString;
+        label: z.ZodString;
+        utilization: z.ZodNumber;
+        resetsAt: z.ZodString;
+        windowMs: z.ZodOptional<z.ZodNumber>;
+        projected: z.ZodOptional<z.ZodNumber>;
+        scopeModel: z.ZodOptional<z.ZodString>;
+        scopeSurface: z.ZodOptional<z.ZodString>;
+        severity: z.ZodOptional<z.ZodString>;
+        isActive: z.ZodOptional<z.ZodBoolean>;
+        allowancePercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+        usedPercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    extraUsage: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        monthlyLimit: z.ZodNullable<z.ZodNumber>;
+        usedCredits: z.ZodNullable<z.ZodNumber>;
+        utilization: z.ZodNullable<z.ZodNumber>;
+        currency: z.ZodOptional<z.ZodString>;
+        decimalPlaces: z.ZodOptional<z.ZodNumber>;
+        disabledReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     accountLabel: z.ZodOptional<z.ZodString>;
     accountDetail: z.ZodOptional<z.ZodString>;
     peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -625,10 +796,14 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
         fiveHour: z.ZodObject<{
             utilization: z.ZodNumber;
             resetsAt: z.ZodString;
+            absent: z.ZodOptional<z.ZodBoolean>;
+            windowMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
         sevenDay: z.ZodObject<{
             utilization: z.ZodNumber;
             resetsAt: z.ZodString;
+            absent: z.ZodOptional<z.ZodBoolean>;
+            windowMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
         available: z.ZodBoolean;
         error: z.ZodOptional<z.ZodString>;
@@ -689,7 +864,32 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
             capturedAt: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         planType: z.ZodOptional<z.ZodString>;
+        planLabel: z.ZodOptional<z.ZodString>;
         rateLimitReachedType: z.ZodOptional<z.ZodString>;
+        limits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            group: z.ZodString;
+            label: z.ZodString;
+            utilization: z.ZodNumber;
+            resetsAt: z.ZodString;
+            windowMs: z.ZodOptional<z.ZodNumber>;
+            projected: z.ZodOptional<z.ZodNumber>;
+            scopeModel: z.ZodOptional<z.ZodString>;
+            scopeSurface: z.ZodOptional<z.ZodString>;
+            severity: z.ZodOptional<z.ZodString>;
+            isActive: z.ZodOptional<z.ZodBoolean>;
+            allowancePercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+            usedPercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        extraUsage: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            monthlyLimit: z.ZodNullable<z.ZodNumber>;
+            usedCredits: z.ZodNullable<z.ZodNumber>;
+            utilization: z.ZodNullable<z.ZodNumber>;
+            currency: z.ZodOptional<z.ZodString>;
+            decimalPlaces: z.ZodOptional<z.ZodNumber>;
+            disabledReason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         accountLabel: z.ZodOptional<z.ZodString>;
         accountDetail: z.ZodOptional<z.ZodString>;
         peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -735,10 +935,14 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
         fiveHour: z.ZodObject<{
             utilization: z.ZodNumber;
             resetsAt: z.ZodString;
+            absent: z.ZodOptional<z.ZodBoolean>;
+            windowMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
         sevenDay: z.ZodObject<{
             utilization: z.ZodNumber;
             resetsAt: z.ZodString;
+            absent: z.ZodOptional<z.ZodBoolean>;
+            windowMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
         available: z.ZodBoolean;
         error: z.ZodOptional<z.ZodString>;
@@ -799,7 +1003,32 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
             capturedAt: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         planType: z.ZodOptional<z.ZodString>;
+        planLabel: z.ZodOptional<z.ZodString>;
         rateLimitReachedType: z.ZodOptional<z.ZodString>;
+        limits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            group: z.ZodString;
+            label: z.ZodString;
+            utilization: z.ZodNumber;
+            resetsAt: z.ZodString;
+            windowMs: z.ZodOptional<z.ZodNumber>;
+            projected: z.ZodOptional<z.ZodNumber>;
+            scopeModel: z.ZodOptional<z.ZodString>;
+            scopeSurface: z.ZodOptional<z.ZodString>;
+            severity: z.ZodOptional<z.ZodString>;
+            isActive: z.ZodOptional<z.ZodBoolean>;
+            allowancePercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+            usedPercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        extraUsage: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            monthlyLimit: z.ZodNullable<z.ZodNumber>;
+            usedCredits: z.ZodNullable<z.ZodNumber>;
+            utilization: z.ZodNullable<z.ZodNumber>;
+            currency: z.ZodOptional<z.ZodString>;
+            decimalPlaces: z.ZodOptional<z.ZodNumber>;
+            disabledReason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         accountLabel: z.ZodOptional<z.ZodString>;
         accountDetail: z.ZodOptional<z.ZodString>;
         peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -845,10 +1074,14 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
         fiveHour: z.ZodObject<{
             utilization: z.ZodNumber;
             resetsAt: z.ZodString;
+            absent: z.ZodOptional<z.ZodBoolean>;
+            windowMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
         sevenDay: z.ZodObject<{
             utilization: z.ZodNumber;
             resetsAt: z.ZodString;
+            absent: z.ZodOptional<z.ZodBoolean>;
+            windowMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
         available: z.ZodBoolean;
         error: z.ZodOptional<z.ZodString>;
@@ -909,7 +1142,32 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
             capturedAt: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         planType: z.ZodOptional<z.ZodString>;
+        planLabel: z.ZodOptional<z.ZodString>;
         rateLimitReachedType: z.ZodOptional<z.ZodString>;
+        limits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            group: z.ZodString;
+            label: z.ZodString;
+            utilization: z.ZodNumber;
+            resetsAt: z.ZodString;
+            windowMs: z.ZodOptional<z.ZodNumber>;
+            projected: z.ZodOptional<z.ZodNumber>;
+            scopeModel: z.ZodOptional<z.ZodString>;
+            scopeSurface: z.ZodOptional<z.ZodString>;
+            severity: z.ZodOptional<z.ZodString>;
+            isActive: z.ZodOptional<z.ZodBoolean>;
+            allowancePercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+            usedPercentOfWeekly: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        extraUsage: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            monthlyLimit: z.ZodNullable<z.ZodNumber>;
+            usedCredits: z.ZodNullable<z.ZodNumber>;
+            utilization: z.ZodNullable<z.ZodNumber>;
+            currency: z.ZodOptional<z.ZodString>;
+            decimalPlaces: z.ZodOptional<z.ZodNumber>;
+            disabledReason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         accountLabel: z.ZodOptional<z.ZodString>;
         accountDetail: z.ZodOptional<z.ZodString>;
         peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{

package/dist/schemas/quota.js

@@ -10,13 +10,40 @@
  * @module schemas/quota
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.providerQuotaMapSchema = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaFreshnessSchema = exports.quotaCapturedSourceSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaWindowSchema = void 0;
+exports.providerQuotaMapSchema = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaFreshnessSchema = exports.quotaCapturedSourceSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaExtraUsageSchema = exports.quotaLimitRowSchema = exports.quotaWindowSchema = void 0;
 const zod_1 = require("zod");
 const providerIds_1 = require("../providerIds");
 // ── QuotaWindow ──
 exports.quotaWindowSchema = zod_1.z.object({
     utilization: zod_1.z.number(),
     resetsAt: zod_1.z.string(),
+    absent: zod_1.z.boolean().optional(),
+    windowMs: zod_1.z.number().optional(),
+});
+// ── QuotaLimitRow / QuotaExtraUsage ──
+exports.quotaLimitRowSchema = zod_1.z.object({
+    kind: zod_1.z.string(),
+    group: zod_1.z.string(),
+    label: zod_1.z.string(),
+    utilization: zod_1.z.number(),
+    resetsAt: zod_1.z.string(),
+    windowMs: zod_1.z.number().optional(),
+    projected: zod_1.z.number().optional(),
+    scopeModel: zod_1.z.string().optional(),
+    scopeSurface: zod_1.z.string().optional(),
+    severity: zod_1.z.string().optional(),
+    isActive: zod_1.z.boolean().optional(),
+    allowancePercentOfWeekly: zod_1.z.number().optional(),
+    usedPercentOfWeekly: zod_1.z.number().optional(),
+});
+exports.quotaExtraUsageSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean(),
+    monthlyLimit: zod_1.z.number().nullable(),
+    usedCredits: zod_1.z.number().nullable(),
+    utilization: zod_1.z.number().nullable(),
+    currency: zod_1.z.string().optional(),
+    decimalPlaces: zod_1.z.number().optional(),
+    disabledReason: zod_1.z.string().optional(),
 });
 // ── QuotaState ──
 exports.quotaFailureKindSchema = zod_1.z.enum([
@@ -77,7 +104,10 @@ exports.quotaStateSchema = zod_1.z.object({
     credits: zod_1.z.unknown().optional(),
     resetCredits: exports.codexResetCreditsSnapshotSchema.optional(),
     planType: zod_1.z.string().optional(),
+    planLabel: zod_1.z.string().optional(),
     rateLimitReachedType: zod_1.z.string().optional(),
+    limits: zod_1.z.array(exports.quotaLimitRowSchema).optional(),
+    extraUsage: exports.quotaExtraUsageSchema.optional(),
 });
 // ── PeakHoursState ──
 exports.peakHoursStateSchema = zod_1.z.object({

package/dist/schemas/quotaHistory.d.ts

@@ -26,10 +26,12 @@ export declare const quotaHistorySampleSchema: z.ZodObject<{
     fiveHour: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     sevenDay: z.ZodObject<{
         utilization: z.ZodNumber;
         resetsAt: z.ZodString;
+        absent: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     available: z.ZodBoolean;
     error: z.ZodOptional<z.ZodString>;