agent-shim 9.2.0 → 9.3.0

package/dist/cli.cjs

@@ -32540,7 +32540,7 @@ function isRateLimitHeader(name) {
   const lower = name.toLowerCase();
   return lower === "retry-after" || lower.startsWith("anthropic-ratelimit-") || lower.startsWith("x-ratelimit-") || lower.startsWith("ratelimit") || lower.startsWith("x-codex-");
 }
-var USAGE_SCHEMA_VERSION, VersionSchema, InstantSchema, TokenCountSchema, TokenUsageSchema, LIMIT_KINDS, LimitClassificationSchema, UsageRecordSchema, QuotaWindowSchema, UnifiedRateLimitSchema, RateLimitStateSchema, LimitEventSchema, ProviderQuotaWindowSchema, ProviderQuotaSchema, ProviderUsageStateSchema, AccountMetadataSchema, UsageSnapshotSchema;
+var USAGE_SCHEMA_VERSION, VersionSchema, InstantSchema, TokenCountSchema, TokenUsageSchema, LIMIT_KINDS, LimitClassificationSchema, UsageRecordSchema, QuotaWindowSchema, ExtraUsageSpendSchema, UnifiedRateLimitSchema, RateLimitStateSchema, LimitEventSchema, ProviderQuotaWindowSchema, ProviderQuotaSchema, ProviderUsageStateSchema, AccountMetadataSchema, UsageSnapshotSchema;
 var init_schema2 = __esm({
   "src/usage/schema.ts"() {
     "use strict";
@@ -32605,13 +32605,25 @@ var init_schema2 = __esm({
       utilization: external_exports.number().nonnegative().optional(),
       resetsAt: InstantSchema.optional(),
       /** The window's own status (`allowed`, `allowed_warning`, `rejected`). */
-      status: external_exports.string().optional()
+      status: external_exports.string().optional(),
+      /** The fraction of the window's grace allowance used, while the upstream reports the window in grace (the five-hour window only). Requests are served beyond the window's own full mark while it grows, but refusals have been seen at a small value, so nothing ranks on it. */
+      graceUtilization: external_exports.number().nonnegative().optional()
+    });
+    ExtraUsageSpendSchema = external_exports.strictObject({
+      /** Spent so far in the allowance's period, in the currency's minor units (pence, cents). */
+      usedMinor: external_exports.number().nonnegative(),
+      /** The allowance's cap in the same units, when it has one. */
+      limitMinor: external_exports.number().nonnegative().optional(),
+      /** The ISO 4217 currency code. */
+      currency: external_exports.string()
     });
     UnifiedRateLimitSchema = external_exports.strictObject({
       /** The overall status: `allowed`, `allowed_warning` or `rejected`. */
       status: external_exports.string().optional(),
       fiveHour: QuotaWindowSchema.optional(),
       sevenDay: QuotaWindowSchema.optional(),
+      /** The weekly window of the models whose usage may continue as extra usage (`7d_oi`), reported by some plans beside the all-models weekly window. */
+      sevenDayOverageIncluded: QuotaWindowSchema.optional(),
       /** The window that currently binds. */
       representativeClaim: external_exports.string().optional(),
       /** When the binding window resets. */
@@ -32623,13 +32635,21 @@ var init_schema2 = __esm({
       /** When the extra-usage allowance resets. */
       overageResetsAt: InstantSchema.optional(),
       /** Why extra usage is unavailable, as the upstream names it (`out_of_credits`, for one). */
-      overageDisabledReason: external_exports.string().optional()
+      overageDisabledReason: external_exports.string().optional(),
+      /** Whether the response was served on extra usage, as the upstream states it. */
+      overageInUse: external_exports.boolean().optional(),
+      /** The allowance in money, from the usage endpoint (the response headers state only the fraction). */
+      extraUsageSpend: ExtraUsageSpendSchema.optional(),
+      /** True when the upstream offers a fallback while a window is rejected: some requests, by model, are still served, though the rest are refused. */
+      fallbackAvailable: external_exports.boolean().optional()
     });
     RateLimitStateSchema = external_exports.strictObject({
       observedAt: InstantSchema,
       /** Every quota and rate-limit header on that response, by name. */
       headers: external_exports.record(external_exports.string(), external_exports.string()),
-      unified: UnifiedRateLimitSchema.optional()
+      unified: UnifiedRateLimitSchema.optional(),
+      /** When the usage endpoint last answered that it has no plan windows for the account, which a later response replaces. Its answer leaves the recorded `unified` state alone (a response's headers may be the only source of it), so this alone says the question was asked. */
+      planWindowsUnavailableAt: InstantSchema.optional()
     });
     LimitEventSchema = LimitClassificationSchema.extend({
       observedAt: InstantSchema,
@@ -32723,6 +32743,13 @@ function nonNegativeNumber(value2) {
   const parsed = Number(value2);
   return Number.isFinite(parsed) && parsed >= 0 ? parsed : void 0;
 }
+function booleanHeader(value2) {
+  return value2 === "true" ? true : value2 === "false" ? false : void 0;
+}
+function withGrace(window, headers) {
+  const graceUtilization = headers[`${UNIFIED_PREFIX}grace-status`] === "active" ? nonNegativeNumber(headers[`${UNIFIED_PREFIX}grace-5h-utilization`]) : void 0;
+  return window === void 0 || graceUtilization === void 0 ? window : { ...window, graceUtilization };
+}
 function unifiedWindow(headers, window) {
   const utilization = nonNegativeNumber(headers[`${UNIFIED_PREFIX}${window}-utilization`]);
   const resetsAt = epochSecondsToIso(headers[`${UNIFIED_PREFIX}${window}-reset`]);
@@ -32737,33 +32764,39 @@ function parseUnifiedRateLimit(headers) {
     return void 0;
   }
   const status = headers[`${UNIFIED_PREFIX}status`];
-  const fiveHour = unifiedWindow(headers, "5h");
+  const fiveHour = withGrace(unifiedWindow(headers, "5h"), headers);
   const sevenDay = unifiedWindow(headers, "7d");
+  const sevenDayOverageIncluded = unifiedWindow(headers, "7d_oi");
   const representativeClaim = headers[`${UNIFIED_PREFIX}representative-claim`];
   const resetAt = epochSecondsToIso(headers[`${UNIFIED_PREFIX}reset`]);
   const overageStatus = headers[`${UNIFIED_PREFIX}overage-status`];
   const overageUtilization = nonNegativeNumber(headers[`${UNIFIED_PREFIX}overage-utilization`]);
   const overageResetsAt = epochSecondsToIso(headers[`${UNIFIED_PREFIX}overage-reset`]);
   const overageDisabledReason = headers[`${UNIFIED_PREFIX}overage-disabled-reason`];
+  const overageInUse = booleanHeader(headers[`${UNIFIED_PREFIX}overage-in-use`]);
   return {
     ...status === void 0 ? {} : { status },
     ...fiveHour === void 0 ? {} : { fiveHour },
     ...sevenDay === void 0 ? {} : { sevenDay },
+    ...sevenDayOverageIncluded === void 0 ? {} : { sevenDayOverageIncluded },
     ...representativeClaim === void 0 ? {} : { representativeClaim },
     ...resetAt === void 0 ? {} : { resetAt },
     ...overageStatus === void 0 ? {} : { overageStatus },
     ...overageUtilization === void 0 ? {} : { overageUtilization },
     ...overageResetsAt === void 0 ? {} : { overageResetsAt },
-    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason }
+    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason },
+    ...overageInUse === void 0 ? {} : { overageInUse },
+    ...headers[`${UNIFIED_PREFIX}fallback`] === "available" ? { fallbackAvailable: true } : {}
   };
 }
 function overageFactsOf(unified) {
-  const { overageStatus, overageUtilization, overageResetsAt, overageDisabledReason } = unified;
+  const { overageStatus, overageUtilization, overageResetsAt, overageDisabledReason, overageInUse } = unified;
   return {
     ...overageStatus === void 0 ? {} : { overageStatus },
     ...overageUtilization === void 0 ? {} : { overageUtilization },
     ...overageResetsAt === void 0 ? {} : { overageResetsAt },
-    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason }
+    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason },
+    ...overageInUse === void 0 ? {} : { overageInUse }
   };
 }
 function overageWindowOf(unified) {
@@ -33191,7 +33224,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "agent-shim",
-      version: "9.2.0",
+      version: "9.3.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -33377,7 +33410,11 @@ var init_account = __esm({
 
 // src/usage/plan.ts
 function planOf(account) {
-  const tier = account?.organizationRateLimitTier ?? account?.userRateLimitTier;
+  const userTier = account?.userRateLimitTier;
+  if (userTier !== void 0 && ZERO_TIER.test(userTier)) {
+    return { kind: "pay-per-use", tier: userTier };
+  }
+  const tier = account?.organizationRateLimitTier ?? userTier;
   const tierField = tier === void 0 ? {} : { tier };
   if (tier === void 0) {
     return { kind: "subscription", capacity: 1, recognised: false };
@@ -34039,7 +34076,7 @@ function assessIdentity(member, nowMs) {
     if (unified.overageStatus === "allowed") {
       return { candidate: { ...base, class: "pay-per-use", reasons: [`plan exhausted until ${new Date(blockedUntil).toISOString()}, continues as extra usage`, ...windowReasons, ...planReasons] } };
     }
-    return { candidate: { ...base, class: "ineligible", blockedUntilMs: blockedUntil, reasons: [`refused until ${new Date(blockedUntil).toISOString()} (in ${formatAge(blockedUntil - nowMs)})`, ...windowReasons, ...overageReasons, ...planReasons] } };
+    return { candidate: { ...base, class: "ineligible", blockedUntilMs: blockedUntil, reasons: [`refused until ${new Date(blockedUntil).toISOString()} (in ${formatAge(blockedUntil - nowMs)})`, ...unified.fallbackAvailable === true ? ["a fallback is on offer, so requests for some models may still be served"] : [], ...windowReasons, ...overageReasons, ...planReasons] } };
   }
   if (plan.kind === "pay-per-use" || fiveHourWindow === void 0 && sevenDayWindow === void 0) {
     const headroom = overage?.utilization === void 0 ? void 0 : Math.max(0, 1 - overage.utilization);
@@ -34438,9 +34475,8 @@ function createUsageStore(deps) {
     recordRateLimit: (identity, provider, rateLimit) => rewriteSnapshot(identity, (current) => {
       const state = current?.providers[provider] ?? {};
       const keep = state.rateLimit !== void 0 && state.rateLimit.observedAt.localeCompare(rateLimit.observedAt) > 0;
-      const earlier = state.rateLimit?.unified;
-      const carried = rateLimit.unified === void 0 || rateLimit.unified.overageStatus !== void 0 || earlier === void 0 ? void 0 : overageFactsOf(earlier);
-      const merged = carried === void 0 || rateLimit.unified === void 0 ? rateLimit : { ...rateLimit, unified: { ...rateLimit.unified, ...carried } };
+      const earlier = state.rateLimit;
+      const merged = rateLimit.unified === void 0 ? { ...earlier ?? rateLimit, planWindowsUnavailableAt: rateLimit.observedAt } : { ...rateLimit, unified: { ...earlier?.unified === void 0 ? {} : overageFactsOf(earlier.unified), ...rateLimit.unified } };
       return { ...current?.providers, [provider]: { ...state, rateLimit: keep ? state.rateLimit : merged } };
     })
   };
@@ -60957,22 +60993,38 @@ function windowOf(reported) {
     ...utilization !== void 0 && utilization >= 1 ? { status: "rejected" } : {}
   };
 }
+function extraUsageOf(reported) {
+  const extra = reported?.extra_usage;
+  if (extra === null || extra === void 0) {
+    return void 0;
+  }
+  const utilization = extra.utilization === null ? void 0 : extra.utilization / PERCENT2;
+  const currency = extra.currency ?? void 0;
+  const spend = extra.used_credits === null || currency === void 0 ? void 0 : { usedMinor: extra.used_credits, ...extra.monthly_limit === null ? {} : { limitMinor: extra.monthly_limit }, currency };
+  return {
+    overageStatus: !extra.is_enabled || utilization !== void 0 && utilization >= 1 ? "rejected" : "allowed",
+    ...utilization === void 0 ? {} : { overageUtilization: utilization },
+    ...spend === void 0 ? {} : { extraUsageSpend: spend }
+  };
+}
 function unifiedFromReportedLimits(reported) {
   const fiveHour = windowOf(reported?.five_hour);
   const sevenDay = windowOf(reported?.seven_day);
-  if (fiveHour === void 0 && sevenDay === void 0) {
+  const extraUsage = extraUsageOf(reported);
+  if (fiveHour === void 0 && sevenDay === void 0 && extraUsage === void 0) {
     return void 0;
   }
-  return { ...fiveHour === void 0 ? {} : { fiveHour }, ...sevenDay === void 0 ? {} : { sevenDay } };
+  return { ...fiveHour === void 0 ? {} : { fiveHour }, ...sevenDay === void 0 ? {} : { sevenDay }, ...extraUsage };
 }
 function isAnthropicUsageProbeable(member) {
-  const unified = member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit?.unified;
-  return planOf(member.account ?? member.snapshot?.account).kind === "subscription" && (unified === void 0 || soleOverageWindow(unified) === void 0);
+  return planOf(member.account ?? member.snapshot?.account).kind === "subscription";
 }
 function isAnthropicUsageStale(member, nowMs) {
   const rateLimit = member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit;
-  const freshnessMs = rateLimit?.unified === void 0 ? NO_PLAN_WINDOWS_FRESHNESS_MS : ANTHROPIC_USAGE_FRESHNESS_MS;
-  return isAnthropicUsageProbeable(member) && (rateLimit === void 0 || nowMs - Date.parse(rateLimit.observedAt) >= freshnessMs);
+  const answeredNothing = rateLimit?.unified === void 0 || rateLimit.planWindowsUnavailableAt !== void 0;
+  const freshnessMs = answeredNothing ? NO_PLAN_WINDOWS_FRESHNESS_MS : ANTHROPIC_USAGE_FRESHNESS_MS;
+  const checkedAt = rateLimit === void 0 ? void 0 : Date.parse(rateLimit.planWindowsUnavailableAt ?? rateLimit.observedAt);
+  return isAnthropicUsageProbeable(member) && (checkedAt === void 0 || nowMs - checkedAt >= freshnessMs);
 }
 function poolIdentityNames(pools, poolName) {
   const seenPools = /* @__PURE__ */ new Set();
@@ -61053,7 +61105,6 @@ var init_anthropicUsageRefresh = __esm({
     init_middleware();
     init_pick();
     init_plan2();
-    init_rateLimit();
     PERCENT2 = 100;
     ANTHROPIC_USAGE_FRESHNESS_MS = FIVE_HOUR_WINDOW_MS / PERCENT2;
     NO_PLAN_WINDOWS_FRESHNESS_MS = SEVEN_DAY_WINDOW_MS / PERCENT2;
@@ -119099,26 +119150,40 @@ function collectUsageReport(fs21, paths, filters) {
   };
 }
 var PERCENT4 = 100;
+var DECIMAL_RADIX = 10;
 function formatWindow(label, window) {
   if (window === void 0) {
     return void 0;
   }
   const used = window.utilization === void 0 ? "usage unknown" : `${String(Math.round(window.utilization * PERCENT4))}% used`;
-  return `${label} ${used}${window.resetsAt === void 0 ? "" : `, resets ${window.resetsAt}`}${window.status === void 0 ? "" : ` (${window.status})`}`;
+  const grace = window.graceUtilization === void 0 ? "" : `, in grace, ${String(Math.round(window.graceUtilization * PERCENT4))}% of the allowance used`;
+  return `${label} ${used}${grace}${window.resetsAt === void 0 ? "" : `, resets ${window.resetsAt}`}${window.status === void 0 ? "" : ` (${window.status})`}`;
+}
+function formatMoney(minor, currency) {
+  const format = new Intl.NumberFormat("en-GB", { style: "currency", currency });
+  const { maximumFractionDigits } = format.resolvedOptions();
+  return format.format(minor / DECIMAL_RADIX ** (maximumFractionDigits ?? 0));
 }
 function extraUsageParts(unified) {
   const window = overageWindowOf(unified);
   const measured = window?.utilization !== void 0 || window?.resetsAt !== void 0;
   const fact = window === void 0 ? void 0 : measured ? formatWindow("extra usage", window) : `extra usage ${window.status ?? "unknown"}`;
-  return [...fact === void 0 ? [] : [fact], ...unified.overageDisabledReason === void 0 ? [] : [`extra usage disabled: ${unified.overageDisabledReason}`]];
+  const spend = unified.extraUsageSpend;
+  const money = spend === void 0 ? void 0 : `extra usage spend ${formatMoney(spend.usedMinor, spend.currency)}${spend.limitMinor === void 0 ? "" : ` of ${formatMoney(spend.limitMinor, spend.currency)}`}`;
+  return [
+    ...fact === void 0 ? [] : [fact],
+    ...money === void 0 ? [] : [money],
+    ...unified.overageInUse === true ? ["served on extra usage"] : [],
+    ...unified.overageDisabledReason === void 0 ? [] : [`extra usage disabled: ${unified.overageDisabledReason}`]
+  ];
 }
 function formatRateLimit(state) {
   const { unified } = state;
   if (unified === void 0) {
     return `rate-limit headers (as of ${state.observedAt}): ${Object.entries(state.headers).map(([name, value2]) => `${name}=${value2}`).join(", ")}`;
   }
-  const parts = [formatWindow("5h", unified.fiveHour), formatWindow("7d", unified.sevenDay)].filter((part) => part !== void 0);
-  return `quota (as of ${state.observedAt}): ${[...parts, `status ${unified.status ?? "unknown"}`, ...extraUsageParts(unified)].join("; ")}`;
+  const parts = [formatWindow("5h", unified.fiveHour), formatWindow("7d", unified.sevenDay), formatWindow("7d overage-included", unified.sevenDayOverageIncluded)].filter((part) => part !== void 0);
+  return `quota (as of ${state.observedAt}): ${[...parts, `status ${unified.status ?? "unknown"}`, ...unified.fallbackAvailable === true ? ["fallback available"] : [], ...extraUsageParts(unified)].join("; ")}`;
 }
 function formatLimit(limit) {
   const wait2 = [

package/dist/index.cjs

@@ -2649,7 +2649,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "agent-shim",
-      version: "9.2.0",
+      version: "9.3.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -4025,7 +4025,7 @@ var init_identity = __esm({
 });
 
 // src/usage/schema.ts
-var import_zod7, USAGE_SCHEMA_VERSION, VersionSchema, InstantSchema, TokenCountSchema, TokenUsageSchema, LIMIT_KINDS, LimitClassificationSchema, UsageRecordSchema, QuotaWindowSchema, UnifiedRateLimitSchema, RateLimitStateSchema, LimitEventSchema, ProviderQuotaWindowSchema, ProviderQuotaSchema, ProviderUsageStateSchema, AccountMetadataSchema, UsageSnapshotSchema;
+var import_zod7, USAGE_SCHEMA_VERSION, VersionSchema, InstantSchema, TokenCountSchema, TokenUsageSchema, LIMIT_KINDS, LimitClassificationSchema, UsageRecordSchema, QuotaWindowSchema, ExtraUsageSpendSchema, UnifiedRateLimitSchema, RateLimitStateSchema, LimitEventSchema, ProviderQuotaWindowSchema, ProviderQuotaSchema, ProviderUsageStateSchema, AccountMetadataSchema, UsageSnapshotSchema;
 var init_schema2 = __esm({
   "src/usage/schema.ts"() {
     "use strict";
@@ -4090,13 +4090,25 @@ var init_schema2 = __esm({
       utilization: import_zod7.z.number().nonnegative().optional(),
       resetsAt: InstantSchema.optional(),
       /** The window's own status (`allowed`, `allowed_warning`, `rejected`). */
-      status: import_zod7.z.string().optional()
+      status: import_zod7.z.string().optional(),
+      /** The fraction of the window's grace allowance used, while the upstream reports the window in grace (the five-hour window only). Requests are served beyond the window's own full mark while it grows, but refusals have been seen at a small value, so nothing ranks on it. */
+      graceUtilization: import_zod7.z.number().nonnegative().optional()
+    });
+    ExtraUsageSpendSchema = import_zod7.z.strictObject({
+      /** Spent so far in the allowance's period, in the currency's minor units (pence, cents). */
+      usedMinor: import_zod7.z.number().nonnegative(),
+      /** The allowance's cap in the same units, when it has one. */
+      limitMinor: import_zod7.z.number().nonnegative().optional(),
+      /** The ISO 4217 currency code. */
+      currency: import_zod7.z.string()
     });
     UnifiedRateLimitSchema = import_zod7.z.strictObject({
       /** The overall status: `allowed`, `allowed_warning` or `rejected`. */
       status: import_zod7.z.string().optional(),
       fiveHour: QuotaWindowSchema.optional(),
       sevenDay: QuotaWindowSchema.optional(),
+      /** The weekly window of the models whose usage may continue as extra usage (`7d_oi`), reported by some plans beside the all-models weekly window. */
+      sevenDayOverageIncluded: QuotaWindowSchema.optional(),
       /** The window that currently binds. */
       representativeClaim: import_zod7.z.string().optional(),
       /** When the binding window resets. */
@@ -4108,13 +4120,21 @@ var init_schema2 = __esm({
       /** When the extra-usage allowance resets. */
       overageResetsAt: InstantSchema.optional(),
       /** Why extra usage is unavailable, as the upstream names it (`out_of_credits`, for one). */
-      overageDisabledReason: import_zod7.z.string().optional()
+      overageDisabledReason: import_zod7.z.string().optional(),
+      /** Whether the response was served on extra usage, as the upstream states it. */
+      overageInUse: import_zod7.z.boolean().optional(),
+      /** The allowance in money, from the usage endpoint (the response headers state only the fraction). */
+      extraUsageSpend: ExtraUsageSpendSchema.optional(),
+      /** True when the upstream offers a fallback while a window is rejected: some requests, by model, are still served, though the rest are refused. */
+      fallbackAvailable: import_zod7.z.boolean().optional()
     });
     RateLimitStateSchema = import_zod7.z.strictObject({
       observedAt: InstantSchema,
       /** Every quota and rate-limit header on that response, by name. */
       headers: import_zod7.z.record(import_zod7.z.string(), import_zod7.z.string()),
-      unified: UnifiedRateLimitSchema.optional()
+      unified: UnifiedRateLimitSchema.optional(),
+      /** When the usage endpoint last answered that it has no plan windows for the account, which a later response replaces. Its answer leaves the recorded `unified` state alone (a response's headers may be the only source of it), so this alone says the question was asked. */
+      planWindowsUnavailableAt: InstantSchema.optional()
     });
     LimitEventSchema = LimitClassificationSchema.extend({
       observedAt: InstantSchema,
@@ -4268,7 +4288,11 @@ var init_account = __esm({
 
 // src/usage/plan.ts
 function planOf(account) {
-  const tier = account?.organizationRateLimitTier ?? account?.userRateLimitTier;
+  const userTier = account?.userRateLimitTier;
+  if (userTier !== void 0 && ZERO_TIER.test(userTier)) {
+    return { kind: "pay-per-use", tier: userTier };
+  }
+  const tier = account?.organizationRateLimitTier ?? userTier;
   const tierField = tier === void 0 ? {} : { tier };
   if (tier === void 0) {
     return { kind: "subscription", capacity: 1, recognised: false };
@@ -4323,6 +4347,13 @@ function nonNegativeNumber(value) {
   const parsed = Number(value);
   return Number.isFinite(parsed) && parsed >= 0 ? parsed : void 0;
 }
+function booleanHeader(value) {
+  return value === "true" ? true : value === "false" ? false : void 0;
+}
+function withGrace(window, headers) {
+  const graceUtilization = headers[`${UNIFIED_PREFIX}grace-status`] === "active" ? nonNegativeNumber(headers[`${UNIFIED_PREFIX}grace-5h-utilization`]) : void 0;
+  return window === void 0 || graceUtilization === void 0 ? window : { ...window, graceUtilization };
+}
 function unifiedWindow(headers, window) {
   const utilization = nonNegativeNumber(headers[`${UNIFIED_PREFIX}${window}-utilization`]);
   const resetsAt = epochSecondsToIso(headers[`${UNIFIED_PREFIX}${window}-reset`]);
@@ -4337,33 +4368,39 @@ function parseUnifiedRateLimit(headers) {
     return void 0;
   }
   const status = headers[`${UNIFIED_PREFIX}status`];
-  const fiveHour = unifiedWindow(headers, "5h");
+  const fiveHour = withGrace(unifiedWindow(headers, "5h"), headers);
   const sevenDay = unifiedWindow(headers, "7d");
+  const sevenDayOverageIncluded = unifiedWindow(headers, "7d_oi");
   const representativeClaim = headers[`${UNIFIED_PREFIX}representative-claim`];
   const resetAt = epochSecondsToIso(headers[`${UNIFIED_PREFIX}reset`]);
   const overageStatus = headers[`${UNIFIED_PREFIX}overage-status`];
   const overageUtilization = nonNegativeNumber(headers[`${UNIFIED_PREFIX}overage-utilization`]);
   const overageResetsAt = epochSecondsToIso(headers[`${UNIFIED_PREFIX}overage-reset`]);
   const overageDisabledReason = headers[`${UNIFIED_PREFIX}overage-disabled-reason`];
+  const overageInUse = booleanHeader(headers[`${UNIFIED_PREFIX}overage-in-use`]);
   return {
     ...status === void 0 ? {} : { status },
     ...fiveHour === void 0 ? {} : { fiveHour },
     ...sevenDay === void 0 ? {} : { sevenDay },
+    ...sevenDayOverageIncluded === void 0 ? {} : { sevenDayOverageIncluded },
     ...representativeClaim === void 0 ? {} : { representativeClaim },
     ...resetAt === void 0 ? {} : { resetAt },
     ...overageStatus === void 0 ? {} : { overageStatus },
     ...overageUtilization === void 0 ? {} : { overageUtilization },
     ...overageResetsAt === void 0 ? {} : { overageResetsAt },
-    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason }
+    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason },
+    ...overageInUse === void 0 ? {} : { overageInUse },
+    ...headers[`${UNIFIED_PREFIX}fallback`] === "available" ? { fallbackAvailable: true } : {}
   };
 }
 function overageFactsOf(unified) {
-  const { overageStatus, overageUtilization, overageResetsAt, overageDisabledReason } = unified;
+  const { overageStatus, overageUtilization, overageResetsAt, overageDisabledReason, overageInUse } = unified;
   return {
     ...overageStatus === void 0 ? {} : { overageStatus },
     ...overageUtilization === void 0 ? {} : { overageUtilization },
     ...overageResetsAt === void 0 ? {} : { overageResetsAt },
-    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason }
+    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason },
+    ...overageInUse === void 0 ? {} : { overageInUse }
   };
 }
 function overageWindowOf(unified) {
@@ -4602,7 +4639,7 @@ function assessIdentity(member, nowMs) {
     if (unified.overageStatus === "allowed") {
       return { candidate: { ...base, class: "pay-per-use", reasons: [`plan exhausted until ${new Date(blockedUntil).toISOString()}, continues as extra usage`, ...windowReasons, ...planReasons] } };
     }
-    return { candidate: { ...base, class: "ineligible", blockedUntilMs: blockedUntil, reasons: [`refused until ${new Date(blockedUntil).toISOString()} (in ${formatAge(blockedUntil - nowMs)})`, ...windowReasons, ...overageReasons, ...planReasons] } };
+    return { candidate: { ...base, class: "ineligible", blockedUntilMs: blockedUntil, reasons: [`refused until ${new Date(blockedUntil).toISOString()} (in ${formatAge(blockedUntil - nowMs)})`, ...unified.fallbackAvailable === true ? ["a fallback is on offer, so requests for some models may still be served"] : [], ...windowReasons, ...overageReasons, ...planReasons] } };
   }
   if (plan.kind === "pay-per-use" || fiveHourWindow === void 0 && sevenDayWindow === void 0) {
     const headroom = overage?.utilization === void 0 ? void 0 : Math.max(0, 1 - overage.utilization);
@@ -4952,9 +4989,8 @@ function createUsageStore(deps) {
     recordRateLimit: (identity, provider, rateLimit) => rewriteSnapshot(identity, (current) => {
       const state = current?.providers[provider] ?? {};
       const keep = state.rateLimit !== void 0 && state.rateLimit.observedAt.localeCompare(rateLimit.observedAt) > 0;
-      const earlier = state.rateLimit?.unified;
-      const carried = rateLimit.unified === void 0 || rateLimit.unified.overageStatus !== void 0 || earlier === void 0 ? void 0 : overageFactsOf(earlier);
-      const merged = carried === void 0 || rateLimit.unified === void 0 ? rateLimit : { ...rateLimit, unified: { ...rateLimit.unified, ...carried } };
+      const earlier = state.rateLimit;
+      const merged = rateLimit.unified === void 0 ? { ...earlier ?? rateLimit, planWindowsUnavailableAt: rateLimit.observedAt } : { ...rateLimit, unified: { ...earlier?.unified === void 0 ? {} : overageFactsOf(earlier.unified), ...rateLimit.unified } };
       return { ...current?.providers, [provider]: { ...state, rateLimit: keep ? state.rateLimit : merged } };
     })
   };
@@ -7409,22 +7445,38 @@ function windowOf(reported) {
     ...utilization !== void 0 && utilization >= 1 ? { status: "rejected" } : {}
   };
 }
+function extraUsageOf(reported) {
+  const extra = reported?.extra_usage;
+  if (extra === null || extra === void 0) {
+    return void 0;
+  }
+  const utilization = extra.utilization === null ? void 0 : extra.utilization / PERCENT2;
+  const currency = extra.currency ?? void 0;
+  const spend = extra.used_credits === null || currency === void 0 ? void 0 : { usedMinor: extra.used_credits, ...extra.monthly_limit === null ? {} : { limitMinor: extra.monthly_limit }, currency };
+  return {
+    overageStatus: !extra.is_enabled || utilization !== void 0 && utilization >= 1 ? "rejected" : "allowed",
+    ...utilization === void 0 ? {} : { overageUtilization: utilization },
+    ...spend === void 0 ? {} : { extraUsageSpend: spend }
+  };
+}
 function unifiedFromReportedLimits(reported) {
   const fiveHour = windowOf(reported?.five_hour);
   const sevenDay = windowOf(reported?.seven_day);
-  if (fiveHour === void 0 && sevenDay === void 0) {
+  const extraUsage = extraUsageOf(reported);
+  if (fiveHour === void 0 && sevenDay === void 0 && extraUsage === void 0) {
     return void 0;
   }
-  return { ...fiveHour === void 0 ? {} : { fiveHour }, ...sevenDay === void 0 ? {} : { sevenDay } };
+  return { ...fiveHour === void 0 ? {} : { fiveHour }, ...sevenDay === void 0 ? {} : { sevenDay }, ...extraUsage };
 }
 function isAnthropicUsageProbeable(member) {
-  const unified = member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit?.unified;
-  return planOf(member.account ?? member.snapshot?.account).kind === "subscription" && (unified === void 0 || soleOverageWindow(unified) === void 0);
+  return planOf(member.account ?? member.snapshot?.account).kind === "subscription";
 }
 function isAnthropicUsageStale(member, nowMs) {
   const rateLimit = member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit;
-  const freshnessMs = rateLimit?.unified === void 0 ? NO_PLAN_WINDOWS_FRESHNESS_MS : ANTHROPIC_USAGE_FRESHNESS_MS;
-  return isAnthropicUsageProbeable(member) && (rateLimit === void 0 || nowMs - Date.parse(rateLimit.observedAt) >= freshnessMs);
+  const answeredNothing = rateLimit?.unified === void 0 || rateLimit.planWindowsUnavailableAt !== void 0;
+  const freshnessMs = answeredNothing ? NO_PLAN_WINDOWS_FRESHNESS_MS : ANTHROPIC_USAGE_FRESHNESS_MS;
+  const checkedAt = rateLimit === void 0 ? void 0 : Date.parse(rateLimit.planWindowsUnavailableAt ?? rateLimit.observedAt);
+  return isAnthropicUsageProbeable(member) && (checkedAt === void 0 || nowMs - checkedAt >= freshnessMs);
 }
 function poolIdentityNames(pools, poolName) {
   const seenPools = /* @__PURE__ */ new Set();
@@ -7505,7 +7557,6 @@ var init_anthropicUsageRefresh = __esm({
     init_middleware();
     init_pick();
     init_plan2();
-    init_rateLimit();
     PERCENT2 = 100;
     ANTHROPIC_USAGE_FRESHNESS_MS = FIVE_HOUR_WINDOW_MS / PERCENT2;
     NO_PLAN_WINDOWS_FRESHNESS_MS = SEVEN_DAY_WINDOW_MS / PERCENT2;

package/dist/index.mjs

@@ -2625,7 +2625,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "agent-shim",
-      version: "9.2.0",
+      version: "9.3.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -4000,7 +4000,7 @@ var init_identity = __esm({
 
 // src/usage/schema.ts
 import { z as z7 } from "zod";
-var USAGE_SCHEMA_VERSION, VersionSchema, InstantSchema, TokenCountSchema, TokenUsageSchema, LIMIT_KINDS, LimitClassificationSchema, UsageRecordSchema, QuotaWindowSchema, UnifiedRateLimitSchema, RateLimitStateSchema, LimitEventSchema, ProviderQuotaWindowSchema, ProviderQuotaSchema, ProviderUsageStateSchema, AccountMetadataSchema, UsageSnapshotSchema;
+var USAGE_SCHEMA_VERSION, VersionSchema, InstantSchema, TokenCountSchema, TokenUsageSchema, LIMIT_KINDS, LimitClassificationSchema, UsageRecordSchema, QuotaWindowSchema, ExtraUsageSpendSchema, UnifiedRateLimitSchema, RateLimitStateSchema, LimitEventSchema, ProviderQuotaWindowSchema, ProviderQuotaSchema, ProviderUsageStateSchema, AccountMetadataSchema, UsageSnapshotSchema;
 var init_schema2 = __esm({
   "src/usage/schema.ts"() {
     "use strict";
@@ -4064,13 +4064,25 @@ var init_schema2 = __esm({
       utilization: z7.number().nonnegative().optional(),
       resetsAt: InstantSchema.optional(),
       /** The window's own status (`allowed`, `allowed_warning`, `rejected`). */
-      status: z7.string().optional()
+      status: z7.string().optional(),
+      /** The fraction of the window's grace allowance used, while the upstream reports the window in grace (the five-hour window only). Requests are served beyond the window's own full mark while it grows, but refusals have been seen at a small value, so nothing ranks on it. */
+      graceUtilization: z7.number().nonnegative().optional()
+    });
+    ExtraUsageSpendSchema = z7.strictObject({
+      /** Spent so far in the allowance's period, in the currency's minor units (pence, cents). */
+      usedMinor: z7.number().nonnegative(),
+      /** The allowance's cap in the same units, when it has one. */
+      limitMinor: z7.number().nonnegative().optional(),
+      /** The ISO 4217 currency code. */
+      currency: z7.string()
     });
     UnifiedRateLimitSchema = z7.strictObject({
       /** The overall status: `allowed`, `allowed_warning` or `rejected`. */
       status: z7.string().optional(),
       fiveHour: QuotaWindowSchema.optional(),
       sevenDay: QuotaWindowSchema.optional(),
+      /** The weekly window of the models whose usage may continue as extra usage (`7d_oi`), reported by some plans beside the all-models weekly window. */
+      sevenDayOverageIncluded: QuotaWindowSchema.optional(),
       /** The window that currently binds. */
       representativeClaim: z7.string().optional(),
       /** When the binding window resets. */
@@ -4082,13 +4094,21 @@ var init_schema2 = __esm({
       /** When the extra-usage allowance resets. */
       overageResetsAt: InstantSchema.optional(),
       /** Why extra usage is unavailable, as the upstream names it (`out_of_credits`, for one). */
-      overageDisabledReason: z7.string().optional()
+      overageDisabledReason: z7.string().optional(),
+      /** Whether the response was served on extra usage, as the upstream states it. */
+      overageInUse: z7.boolean().optional(),
+      /** The allowance in money, from the usage endpoint (the response headers state only the fraction). */
+      extraUsageSpend: ExtraUsageSpendSchema.optional(),
+      /** True when the upstream offers a fallback while a window is rejected: some requests, by model, are still served, though the rest are refused. */
+      fallbackAvailable: z7.boolean().optional()
     });
     RateLimitStateSchema = z7.strictObject({
       observedAt: InstantSchema,
       /** Every quota and rate-limit header on that response, by name. */
       headers: z7.record(z7.string(), z7.string()),
-      unified: UnifiedRateLimitSchema.optional()
+      unified: UnifiedRateLimitSchema.optional(),
+      /** When the usage endpoint last answered that it has no plan windows for the account, which a later response replaces. Its answer leaves the recorded `unified` state alone (a response's headers may be the only source of it), so this alone says the question was asked. */
+      planWindowsUnavailableAt: InstantSchema.optional()
     });
     LimitEventSchema = LimitClassificationSchema.extend({
       observedAt: InstantSchema,
@@ -4243,7 +4263,11 @@ var init_account = __esm({
 // src/usage/plan.ts
 import { z as z8 } from "zod";
 function planOf(account) {
-  const tier = account?.organizationRateLimitTier ?? account?.userRateLimitTier;
+  const userTier = account?.userRateLimitTier;
+  if (userTier !== void 0 && ZERO_TIER.test(userTier)) {
+    return { kind: "pay-per-use", tier: userTier };
+  }
+  const tier = account?.organizationRateLimitTier ?? userTier;
   const tierField = tier === void 0 ? {} : { tier };
   if (tier === void 0) {
     return { kind: "subscription", capacity: 1, recognised: false };
@@ -4297,6 +4321,13 @@ function nonNegativeNumber(value) {
   const parsed = Number(value);
   return Number.isFinite(parsed) && parsed >= 0 ? parsed : void 0;
 }
+function booleanHeader(value) {
+  return value === "true" ? true : value === "false" ? false : void 0;
+}
+function withGrace(window, headers) {
+  const graceUtilization = headers[`${UNIFIED_PREFIX}grace-status`] === "active" ? nonNegativeNumber(headers[`${UNIFIED_PREFIX}grace-5h-utilization`]) : void 0;
+  return window === void 0 || graceUtilization === void 0 ? window : { ...window, graceUtilization };
+}
 function unifiedWindow(headers, window) {
   const utilization = nonNegativeNumber(headers[`${UNIFIED_PREFIX}${window}-utilization`]);
   const resetsAt = epochSecondsToIso(headers[`${UNIFIED_PREFIX}${window}-reset`]);
@@ -4311,33 +4342,39 @@ function parseUnifiedRateLimit(headers) {
     return void 0;
   }
   const status = headers[`${UNIFIED_PREFIX}status`];
-  const fiveHour = unifiedWindow(headers, "5h");
+  const fiveHour = withGrace(unifiedWindow(headers, "5h"), headers);
   const sevenDay = unifiedWindow(headers, "7d");
+  const sevenDayOverageIncluded = unifiedWindow(headers, "7d_oi");
   const representativeClaim = headers[`${UNIFIED_PREFIX}representative-claim`];
   const resetAt = epochSecondsToIso(headers[`${UNIFIED_PREFIX}reset`]);
   const overageStatus = headers[`${UNIFIED_PREFIX}overage-status`];
   const overageUtilization = nonNegativeNumber(headers[`${UNIFIED_PREFIX}overage-utilization`]);
   const overageResetsAt = epochSecondsToIso(headers[`${UNIFIED_PREFIX}overage-reset`]);
   const overageDisabledReason = headers[`${UNIFIED_PREFIX}overage-disabled-reason`];
+  const overageInUse = booleanHeader(headers[`${UNIFIED_PREFIX}overage-in-use`]);
   return {
     ...status === void 0 ? {} : { status },
     ...fiveHour === void 0 ? {} : { fiveHour },
     ...sevenDay === void 0 ? {} : { sevenDay },
+    ...sevenDayOverageIncluded === void 0 ? {} : { sevenDayOverageIncluded },
     ...representativeClaim === void 0 ? {} : { representativeClaim },
     ...resetAt === void 0 ? {} : { resetAt },
     ...overageStatus === void 0 ? {} : { overageStatus },
     ...overageUtilization === void 0 ? {} : { overageUtilization },
     ...overageResetsAt === void 0 ? {} : { overageResetsAt },
-    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason }
+    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason },
+    ...overageInUse === void 0 ? {} : { overageInUse },
+    ...headers[`${UNIFIED_PREFIX}fallback`] === "available" ? { fallbackAvailable: true } : {}
   };
 }
 function overageFactsOf(unified) {
-  const { overageStatus, overageUtilization, overageResetsAt, overageDisabledReason } = unified;
+  const { overageStatus, overageUtilization, overageResetsAt, overageDisabledReason, overageInUse } = unified;
   return {
     ...overageStatus === void 0 ? {} : { overageStatus },
     ...overageUtilization === void 0 ? {} : { overageUtilization },
     ...overageResetsAt === void 0 ? {} : { overageResetsAt },
-    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason }
+    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason },
+    ...overageInUse === void 0 ? {} : { overageInUse }
   };
 }
 function overageWindowOf(unified) {
@@ -4576,7 +4613,7 @@ function assessIdentity(member, nowMs) {
     if (unified.overageStatus === "allowed") {
       return { candidate: { ...base, class: "pay-per-use", reasons: [`plan exhausted until ${new Date(blockedUntil).toISOString()}, continues as extra usage`, ...windowReasons, ...planReasons] } };
     }
-    return { candidate: { ...base, class: "ineligible", blockedUntilMs: blockedUntil, reasons: [`refused until ${new Date(blockedUntil).toISOString()} (in ${formatAge(blockedUntil - nowMs)})`, ...windowReasons, ...overageReasons, ...planReasons] } };
+    return { candidate: { ...base, class: "ineligible", blockedUntilMs: blockedUntil, reasons: [`refused until ${new Date(blockedUntil).toISOString()} (in ${formatAge(blockedUntil - nowMs)})`, ...unified.fallbackAvailable === true ? ["a fallback is on offer, so requests for some models may still be served"] : [], ...windowReasons, ...overageReasons, ...planReasons] } };
   }
   if (plan.kind === "pay-per-use" || fiveHourWindow === void 0 && sevenDayWindow === void 0) {
     const headroom = overage?.utilization === void 0 ? void 0 : Math.max(0, 1 - overage.utilization);
@@ -4927,9 +4964,8 @@ function createUsageStore(deps) {
     recordRateLimit: (identity, provider, rateLimit) => rewriteSnapshot(identity, (current) => {
       const state = current?.providers[provider] ?? {};
       const keep = state.rateLimit !== void 0 && state.rateLimit.observedAt.localeCompare(rateLimit.observedAt) > 0;
-      const earlier = state.rateLimit?.unified;
-      const carried = rateLimit.unified === void 0 || rateLimit.unified.overageStatus !== void 0 || earlier === void 0 ? void 0 : overageFactsOf(earlier);
-      const merged = carried === void 0 || rateLimit.unified === void 0 ? rateLimit : { ...rateLimit, unified: { ...rateLimit.unified, ...carried } };
+      const earlier = state.rateLimit;
+      const merged = rateLimit.unified === void 0 ? { ...earlier ?? rateLimit, planWindowsUnavailableAt: rateLimit.observedAt } : { ...rateLimit, unified: { ...earlier?.unified === void 0 ? {} : overageFactsOf(earlier.unified), ...rateLimit.unified } };
       return { ...current?.providers, [provider]: { ...state, rateLimit: keep ? state.rateLimit : merged } };
     })
   };
@@ -7381,22 +7417,38 @@ function windowOf(reported) {
     ...utilization !== void 0 && utilization >= 1 ? { status: "rejected" } : {}
   };
 }
+function extraUsageOf(reported) {
+  const extra = reported?.extra_usage;
+  if (extra === null || extra === void 0) {
+    return void 0;
+  }
+  const utilization = extra.utilization === null ? void 0 : extra.utilization / PERCENT2;
+  const currency = extra.currency ?? void 0;
+  const spend = extra.used_credits === null || currency === void 0 ? void 0 : { usedMinor: extra.used_credits, ...extra.monthly_limit === null ? {} : { limitMinor: extra.monthly_limit }, currency };
+  return {
+    overageStatus: !extra.is_enabled || utilization !== void 0 && utilization >= 1 ? "rejected" : "allowed",
+    ...utilization === void 0 ? {} : { overageUtilization: utilization },
+    ...spend === void 0 ? {} : { extraUsageSpend: spend }
+  };
+}
 function unifiedFromReportedLimits(reported) {
   const fiveHour = windowOf(reported?.five_hour);
   const sevenDay = windowOf(reported?.seven_day);
-  if (fiveHour === void 0 && sevenDay === void 0) {
+  const extraUsage = extraUsageOf(reported);
+  if (fiveHour === void 0 && sevenDay === void 0 && extraUsage === void 0) {
     return void 0;
   }
-  return { ...fiveHour === void 0 ? {} : { fiveHour }, ...sevenDay === void 0 ? {} : { sevenDay } };
+  return { ...fiveHour === void 0 ? {} : { fiveHour }, ...sevenDay === void 0 ? {} : { sevenDay }, ...extraUsage };
 }
 function isAnthropicUsageProbeable(member) {
-  const unified = member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit?.unified;
-  return planOf(member.account ?? member.snapshot?.account).kind === "subscription" && (unified === void 0 || soleOverageWindow(unified) === void 0);
+  return planOf(member.account ?? member.snapshot?.account).kind === "subscription";
 }
 function isAnthropicUsageStale(member, nowMs) {
   const rateLimit = member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit;
-  const freshnessMs = rateLimit?.unified === void 0 ? NO_PLAN_WINDOWS_FRESHNESS_MS : ANTHROPIC_USAGE_FRESHNESS_MS;
-  return isAnthropicUsageProbeable(member) && (rateLimit === void 0 || nowMs - Date.parse(rateLimit.observedAt) >= freshnessMs);
+  const answeredNothing = rateLimit?.unified === void 0 || rateLimit.planWindowsUnavailableAt !== void 0;
+  const freshnessMs = answeredNothing ? NO_PLAN_WINDOWS_FRESHNESS_MS : ANTHROPIC_USAGE_FRESHNESS_MS;
+  const checkedAt = rateLimit === void 0 ? void 0 : Date.parse(rateLimit.planWindowsUnavailableAt ?? rateLimit.observedAt);
+  return isAnthropicUsageProbeable(member) && (checkedAt === void 0 || nowMs - checkedAt >= freshnessMs);
 }
 function poolIdentityNames(pools, poolName) {
   const seenPools = /* @__PURE__ */ new Set();
@@ -7477,7 +7529,6 @@ var init_anthropicUsageRefresh = __esm({
     init_middleware();
     init_pick();
     init_plan2();
-    init_rateLimit();
     PERCENT2 = 100;
     ANTHROPIC_USAGE_FRESHNESS_MS = FIVE_HOUR_WINDOW_MS / PERCENT2;
     NO_PLAN_WINDOWS_FRESHNESS_MS = SEVEN_DAY_WINDOW_MS / PERCENT2;

package/dist/types/index.d.ts

@@ -4617,6 +4617,7 @@ declare const QuotaWindowSchema: z.ZodObject<{
     utilization: z.ZodOptional<z.ZodNumber>;
     resetsAt: z.ZodOptional<z.ZodISODateTime>;
     status: z.ZodOptional<z.ZodString>;
+    graceUtilization: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 type QuotaWindow = z.infer<typeof QuotaWindowSchema>;
 /**
@@ -4677,11 +4678,19 @@ declare const UsageSnapshotSchema: z.ZodObject<{
                     utilization: z.ZodOptional<z.ZodNumber>;
                     resetsAt: z.ZodOptional<z.ZodISODateTime>;
                     status: z.ZodOptional<z.ZodString>;
+                    graceUtilization: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strict>>;
                 sevenDay: z.ZodOptional<z.ZodObject<{
                     utilization: z.ZodOptional<z.ZodNumber>;
                     resetsAt: z.ZodOptional<z.ZodISODateTime>;
                     status: z.ZodOptional<z.ZodString>;
+                    graceUtilization: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+                sevenDayOverageIncluded: z.ZodOptional<z.ZodObject<{
+                    utilization: z.ZodOptional<z.ZodNumber>;
+                    resetsAt: z.ZodOptional<z.ZodISODateTime>;
+                    status: z.ZodOptional<z.ZodString>;
+                    graceUtilization: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strict>>;
                 representativeClaim: z.ZodOptional<z.ZodString>;
                 resetAt: z.ZodOptional<z.ZodISODateTime>;
@@ -4689,7 +4698,15 @@ declare const UsageSnapshotSchema: z.ZodObject<{
                 overageUtilization: z.ZodOptional<z.ZodNumber>;
                 overageResetsAt: z.ZodOptional<z.ZodISODateTime>;
                 overageDisabledReason: z.ZodOptional<z.ZodString>;
+                overageInUse: z.ZodOptional<z.ZodBoolean>;
+                extraUsageSpend: z.ZodOptional<z.ZodObject<{
+                    usedMinor: z.ZodNumber;
+                    limitMinor: z.ZodOptional<z.ZodNumber>;
+                    currency: z.ZodString;
+                }, z.core.$strict>>;
+                fallbackAvailable: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strict>>;
+            planWindowsUnavailableAt: z.ZodOptional<z.ZodISODateTime>;
         }, z.core.$strict>>;
         lastLimit: z.ZodOptional<z.ZodObject<{
             kind: z.ZodEnum<{
@@ -5011,11 +5028,19 @@ declare function createControlApiRouter(deps: ControlApiDeps): {
                                 utilization: zod.ZodOptional<zod.ZodNumber>;
                                 resetsAt: zod.ZodOptional<zod.ZodISODateTime>;
                                 status: zod.ZodOptional<zod.ZodString>;
+                                graceUtilization: zod.ZodOptional<zod.ZodNumber>;
                             }, zod_v4_core.$strict>>;
                             sevenDay: zod.ZodOptional<zod.ZodObject<{
                                 utilization: zod.ZodOptional<zod.ZodNumber>;
                                 resetsAt: zod.ZodOptional<zod.ZodISODateTime>;
                                 status: zod.ZodOptional<zod.ZodString>;
+                                graceUtilization: zod.ZodOptional<zod.ZodNumber>;
+                            }, zod_v4_core.$strict>>;
+                            sevenDayOverageIncluded: zod.ZodOptional<zod.ZodObject<{
+                                utilization: zod.ZodOptional<zod.ZodNumber>;
+                                resetsAt: zod.ZodOptional<zod.ZodISODateTime>;
+                                status: zod.ZodOptional<zod.ZodString>;
+                                graceUtilization: zod.ZodOptional<zod.ZodNumber>;
                             }, zod_v4_core.$strict>>;
                             representativeClaim: zod.ZodOptional<zod.ZodString>;
                             resetAt: zod.ZodOptional<zod.ZodISODateTime>;
@@ -5023,7 +5048,15 @@ declare function createControlApiRouter(deps: ControlApiDeps): {
                             overageUtilization: zod.ZodOptional<zod.ZodNumber>;
                             overageResetsAt: zod.ZodOptional<zod.ZodISODateTime>;
                             overageDisabledReason: zod.ZodOptional<zod.ZodString>;
+                            overageInUse: zod.ZodOptional<zod.ZodBoolean>;
+                            extraUsageSpend: zod.ZodOptional<zod.ZodObject<{
+                                usedMinor: zod.ZodNumber;
+                                limitMinor: zod.ZodOptional<zod.ZodNumber>;
+                                currency: zod.ZodString;
+                            }, zod_v4_core.$strict>>;
+                            fallbackAvailable: zod.ZodOptional<zod.ZodBoolean>;
                         }, zod_v4_core.$strict>>;
+                        planWindowsUnavailableAt: zod.ZodOptional<zod.ZodISODateTime>;
                     }, zod_v4_core.$strict>>;
                     lastLimit: zod.ZodOptional<zod.ZodObject<{
                         kind: zod.ZodEnum<{
@@ -5595,11 +5628,19 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                                 utilization: zod.ZodOptional<zod.ZodNumber>;
                                 resetsAt: zod.ZodOptional<zod.ZodISODateTime>;
                                 status: zod.ZodOptional<zod.ZodString>;
+                                graceUtilization: zod.ZodOptional<zod.ZodNumber>;
                             }, zod_v4_core.$strict>>;
                             sevenDay: zod.ZodOptional<zod.ZodObject<{
                                 utilization: zod.ZodOptional<zod.ZodNumber>;
                                 resetsAt: zod.ZodOptional<zod.ZodISODateTime>;
                                 status: zod.ZodOptional<zod.ZodString>;
+                                graceUtilization: zod.ZodOptional<zod.ZodNumber>;
+                            }, zod_v4_core.$strict>>;
+                            sevenDayOverageIncluded: zod.ZodOptional<zod.ZodObject<{
+                                utilization: zod.ZodOptional<zod.ZodNumber>;
+                                resetsAt: zod.ZodOptional<zod.ZodISODateTime>;
+                                status: zod.ZodOptional<zod.ZodString>;
+                                graceUtilization: zod.ZodOptional<zod.ZodNumber>;
                             }, zod_v4_core.$strict>>;
                             representativeClaim: zod.ZodOptional<zod.ZodString>;
                             resetAt: zod.ZodOptional<zod.ZodISODateTime>;
@@ -5607,7 +5648,15 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                             overageUtilization: zod.ZodOptional<zod.ZodNumber>;
                             overageResetsAt: zod.ZodOptional<zod.ZodISODateTime>;
                             overageDisabledReason: zod.ZodOptional<zod.ZodString>;
+                            overageInUse: zod.ZodOptional<zod.ZodBoolean>;
+                            extraUsageSpend: zod.ZodOptional<zod.ZodObject<{
+                                usedMinor: zod.ZodNumber;
+                                limitMinor: zod.ZodOptional<zod.ZodNumber>;
+                                currency: zod.ZodString;
+                            }, zod_v4_core.$strict>>;
+                            fallbackAvailable: zod.ZodOptional<zod.ZodBoolean>;
                         }, zod_v4_core.$strict>>;
+                        planWindowsUnavailableAt: zod.ZodOptional<zod.ZodISODateTime>;
                     }, zod_v4_core.$strict>>;
                     lastLimit: zod.ZodOptional<zod.ZodObject<{
                         kind: zod.ZodEnum<{
@@ -6394,11 +6443,19 @@ declare const UsageListOutputSchema: z.ZodObject<{
                         utilization: z.ZodOptional<z.ZodNumber>;
                         resetsAt: z.ZodOptional<z.ZodISODateTime>;
                         status: z.ZodOptional<z.ZodString>;
+                        graceUtilization: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strict>>;
                     sevenDay: z.ZodOptional<z.ZodObject<{
                         utilization: z.ZodOptional<z.ZodNumber>;
                         resetsAt: z.ZodOptional<z.ZodISODateTime>;
                         status: z.ZodOptional<z.ZodString>;
+                        graceUtilization: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strict>>;
+                    sevenDayOverageIncluded: z.ZodOptional<z.ZodObject<{
+                        utilization: z.ZodOptional<z.ZodNumber>;
+                        resetsAt: z.ZodOptional<z.ZodISODateTime>;
+                        status: z.ZodOptional<z.ZodString>;
+                        graceUtilization: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strict>>;
                     representativeClaim: z.ZodOptional<z.ZodString>;
                     resetAt: z.ZodOptional<z.ZodISODateTime>;
@@ -6406,7 +6463,15 @@ declare const UsageListOutputSchema: z.ZodObject<{
                     overageUtilization: z.ZodOptional<z.ZodNumber>;
                     overageResetsAt: z.ZodOptional<z.ZodISODateTime>;
                     overageDisabledReason: z.ZodOptional<z.ZodString>;
+                    overageInUse: z.ZodOptional<z.ZodBoolean>;
+                    extraUsageSpend: z.ZodOptional<z.ZodObject<{
+                        usedMinor: z.ZodNumber;
+                        limitMinor: z.ZodOptional<z.ZodNumber>;
+                        currency: z.ZodString;
+                    }, z.core.$strict>>;
+                    fallbackAvailable: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strict>>;
+                planWindowsUnavailableAt: z.ZodOptional<z.ZodISODateTime>;
             }, z.core.$strict>>;
             lastLimit: z.ZodOptional<z.ZodObject<{
                 kind: z.ZodEnum<{
@@ -7054,7 +7119,7 @@ declare const PlanClassSchema: z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$strict>]>;
 type PlanClass = z.infer<typeof PlanClassSchema>;
 /**
- * Classifies an account from the rate-limit tier of its stored login (`organizationRateLimitTier`, which decides the organisation's limits, then `userRateLimitTier`). The tier strings are free text on Anthropic's side, so only the shapes seen are read: a trailing `<n>x` is that multiple, a bare `pro` is 1, a `zero` tier is pay-per-use. Anything else is a subscription of unrecognised size, counted as 1 and marked so the ranking can say it guessed.
+ * Classifies an account from the rate-limit tier of its stored login (`organizationRateLimitTier`, which decides the organisation's limits, then `userRateLimitTier`), except that a `zero` user tier decides alone: a seat whose own allowance is zero draws on no plan whatever its organisation's tier says (a usage-based Enterprise seat sits in an organisation tier that reads as a subscription). The tier strings are free text on Anthropic's side, so only the shapes seen are read: a trailing `<n>x` is that multiple, a bare `pro` is 1, a `zero` tier is pay-per-use. Anything else is a subscription of unrecognised size, counted as 1 and marked so the ranking can say it guessed.
  */
 declare function planOf(account: AccountMetadata | undefined): PlanClass;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-shim",
-  "version": "9.2.0",
+  "version": "9.3.0",
   "description": "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
   "license": "MIT",
   "author": "Joseph Mearman <joseph@mearman.co.uk>",