@modelprofile.com/authswitch 3.0.0 → 3.1.0

package/ts/interfaces.harness.ts

@@ -108,20 +108,32 @@ export interface IHarnessStatusFact {
   summaryKey?: 'subscription' | 'billing' | 'usageWindows' | 'resets' | 'resetDetails';
 }
 
+/** The provider's own reading of a usage window. Adapters set it only when the provider reports one of these. */
+export type TUsageSeverity = 'normal' | 'warning' | 'critical';
+
+export interface IHarnessUsageWindow {
+  label: string;
+  /**
+   * Feature-specific quotas (a model, a surface, a product feature) do not determine the general
+   * account summary unless the provider picks one as its headline. Omission means account.
+   */
+  scope?: 'account' | 'feature';
+  durationSeconds: number;
+  usedPercent: number;
+  resetAt: string | null;
+  /** Omitted when the provider gives no reading; consumers then apply their own thresholds. */
+  severity?: TUsageSeverity;
+  /** Set when the provider picks this window as the one a single-value summary shows. */
+  headline?: true;
+}
+
 export interface IHarnessStatusSummary {
   /** A plan name does not imply an active billing status. */
   subscription?: { plan: string; source: 'live' | 'stored' };
   /** Live billing information only. Never infer these fields from a plan or entitlement expiry. */
   billing?: { hasActiveSubscription?: boolean; autoRenew?: boolean; renewsAt?: string; cancelsAt?: string; expiresAt?: string };
   /** Missing windows are unknown, not unused. Times are ISO 8601 UTC. */
-  usageWindows?: {
-    label: string;
-    /** Feature-specific quotas do not determine the general account summary. Omission means account. */
-    scope?: 'account' | 'feature';
-    durationSeconds: number;
-    usedPercent: number;
-    resetAt: string | null;
-  }[];
+  usageWindows?: IHarnessUsageWindow[];
   resets?: {
     available: number;
     /** May be a partial list. Omission means the detail lookup was unavailable. */

package/ts/interfaces.list.ts

@@ -1,4 +1,4 @@
-import type { IHarnessAccount, IHarnessAccountStatus, IHarnessCredentialDrift } from './interfaces.harness.js';
+import type { IHarnessAccount, IHarnessAccountStatus, IHarnessCredentialDrift, TUsageSeverity } from './interfaces.harness.js';
 
 /** Credential-free, versioned output of list --json. Missing status fields stay omitted. */
 export interface IAccountList {
@@ -48,6 +48,10 @@ export interface IAccountLimitRow {
   resetAt: string | null;
   /** Human countdown for the same `resetAt`, relative to `generatedAt`. */
   resetsIn: string;
+  /** The provider's reading of this window; null when it gave none or the row has no window. */
+  severity: TUsageSeverity | null;
+  /** Whether the provider picks this window as the one a single-value summary shows. */
+  headline: boolean;
   unavailableReason: string | null;
 }