agent-shim 9.0.0 → 9.2.0

package/dist/index.cjs

@@ -770,6 +770,18 @@ function matchBranch(pattern, branch, detached = false) {
   }
   return (0, import_picomatch2.default)(pattern, { dot: true, nocase: false })(branch);
 }
+function windowValues(prefix, windows) {
+  const values = {};
+  for (const name of ["fiveHour", "sevenDay", "extraUsage"]) {
+    const facts = windows?.[name];
+    if (facts !== void 0) {
+      values[`${prefix}.${name}.remaining`] = facts.remaining;
+      values[`${prefix}.${name}.utilization`] = facts.utilization;
+      values[`${prefix}.${name}.hoursUntilReset`] = facts.hoursUntilReset;
+    }
+  }
+  return values;
+}
 function resolversOf(context) {
   const pool = context.pool;
   const values = {
@@ -778,8 +790,7 @@ function resolversOf(context) {
     ...context.fact?.totalSizeBytes === void 0 ? {} : { "entry.totalSizeBytes": context.fact.totalSizeBytes },
     ...context.branch === void 0 ? {} : { "repo.branch": context.branch },
     "repo.detached": context.branchDetached ?? false,
-    ...pool?.fiveHour === void 0 ? {} : { "quota.fiveHour.remaining": pool.fiveHour.remaining, "quota.fiveHour.utilization": pool.fiveHour.utilization, "quota.fiveHour.hoursUntilReset": pool.fiveHour.hoursUntilReset },
-    ...pool?.sevenDay === void 0 ? {} : { "quota.sevenDay.remaining": pool.sevenDay.remaining, "quota.sevenDay.utilization": pool.sevenDay.utilization, "quota.sevenDay.hoursUntilReset": pool.sevenDay.hoursUntilReset },
+    ...windowValues("quota", pool),
     ...pool?.burnPerHour === void 0 ? {} : { "quota.burnPerHour": pool.burnPerHour },
     ...pool?.resuming === void 0 ? {} : { "session.resuming": pool.resuming },
     ...pool?.lastPickHoursAgo === void 0 ? {} : { "session.lastPickHoursAgo": pool.lastPickHoursAgo },
@@ -790,12 +801,7 @@ function resolversOf(context) {
     ...context.request?.maxTokens === void 0 ? {} : { "request.maxTokens": context.request.maxTokens },
     ...context.request?.isCountTokens === void 0 ? {} : { "request.isCountTokens": context.request.isCountTokens },
     ...context.providerQuota === void 0 ? {} : Object.fromEntries(
-      Object.entries(context.providerQuota).flatMap(
-        ([name, windows]) => [
-          ...windows.fiveHour === void 0 ? [] : [["provider." + name + ".fiveHour.remaining", windows.fiveHour.remaining], ["provider." + name + ".fiveHour.utilization", windows.fiveHour.utilization], ["provider." + name + ".fiveHour.hoursUntilReset", windows.fiveHour.hoursUntilReset]],
-          ...windows.sevenDay === void 0 ? [] : [["provider." + name + ".sevenDay.remaining", windows.sevenDay.remaining], ["provider." + name + ".sevenDay.utilization", windows.sevenDay.utilization], ["provider." + name + ".sevenDay.hoursUntilReset", windows.sevenDay.hoursUntilReset]]
-        ]
-      )
+      Object.entries(context.providerQuota).flatMap(([name, windows]) => Object.entries(windowValues("provider." + name, windows)))
     )
   };
   return {
@@ -2643,7 +2649,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "agent-shim",
-      version: "9.0.0",
+      version: "9.2.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>",
@@ -4096,7 +4102,13 @@ var init_schema2 = __esm({
       /** When the binding window resets. */
       resetAt: InstantSchema.optional(),
       /** Whether usage beyond the plan (extra usage) is available: `allowed` or `rejected`. */
-      overageStatus: import_zod7.z.string().optional()
+      overageStatus: import_zod7.z.string().optional(),
+      /** The fraction of the extra-usage allowance used, as the upstream reports it (0 to 1). An account with no plan windows, such as an Enterprise one, is metered by this alone. */
+      overageUtilization: import_zod7.z.number().nonnegative().optional(),
+      /** 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()
     });
     RateLimitStateSchema = import_zod7.z.strictObject({
       observedAt: InstantSchema,
@@ -4330,15 +4342,40 @@ function parseUnifiedRateLimit(headers) {
   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`];
   return {
     ...status === void 0 ? {} : { status },
     ...fiveHour === void 0 ? {} : { fiveHour },
     ...sevenDay === void 0 ? {} : { sevenDay },
     ...representativeClaim === void 0 ? {} : { representativeClaim },
     ...resetAt === void 0 ? {} : { resetAt },
-    ...overageStatus === void 0 ? {} : { overageStatus }
+    ...overageStatus === void 0 ? {} : { overageStatus },
+    ...overageUtilization === void 0 ? {} : { overageUtilization },
+    ...overageResetsAt === void 0 ? {} : { overageResetsAt },
+    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason }
   };
 }
+function overageFactsOf(unified) {
+  const { overageStatus, overageUtilization, overageResetsAt, overageDisabledReason } = unified;
+  return {
+    ...overageStatus === void 0 ? {} : { overageStatus },
+    ...overageUtilization === void 0 ? {} : { overageUtilization },
+    ...overageResetsAt === void 0 ? {} : { overageResetsAt },
+    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason }
+  };
+}
+function overageWindowOf(unified) {
+  const { overageUtilization: utilization, overageResetsAt: resetsAt, overageStatus: status } = unified;
+  if (utilization === void 0 && resetsAt === void 0 && status === void 0) {
+    return void 0;
+  }
+  return { ...utilization === void 0 ? {} : { utilization }, ...resetsAt === void 0 ? {} : { resetsAt }, ...status === void 0 ? {} : { status } };
+}
+function soleOverageWindow(unified) {
+  return unified.fiveHour === void 0 && unified.sevenDay === void 0 ? overageWindowOf(unified) : void 0;
+}
 var MS_PER_SECOND2, UNIFIED_PREFIX;
 var init_rateLimit = __esm({
   "src/usage/rateLimit.ts"() {
@@ -4412,7 +4449,8 @@ function quotaWarnings(snapshot, provider, nowMs) {
   const age = formatAge(nowMs - Date.parse(rateLimit.observedAt));
   const windows = [
     { name: "five-hour", window: unified.fiveHour },
-    { name: "seven-day", window: unified.sevenDay }
+    { name: "seven-day", window: unified.sevenDay },
+    { name: "extra-usage", window: soleOverageWindow(unified) }
   ];
   return windows.flatMap(({ name, window }) => {
     const effective = window === void 0 ? void 0 : effectiveWindow(window, nowMs);
@@ -4428,6 +4466,7 @@ var MS_PER_SECOND3, SECONDS_PER_MINUTE, MINUTES_PER_HOUR, HOURS_PER_DAY, WARNING
 var init_preflight = __esm({
   "src/usage/preflight.ts"() {
     "use strict";
+    init_rateLimit();
     MS_PER_SECOND3 = 1e3;
     SECONDS_PER_MINUTE = 60;
     MINUTES_PER_HOUR = 60;
@@ -4436,6 +4475,28 @@ var init_preflight = __esm({
   }
 });
 
+// src/usage/quotaFacts.ts
+function windowFacts(window, nowMs) {
+  if (window?.utilization === void 0 || window.resetsAt === void 0) {
+    return void 0;
+  }
+  return { remaining: Math.max(0, 1 - window.utilization), utilization: window.utilization, hoursUntilReset: Math.max(0, (Date.parse(window.resetsAt) - nowMs) / MS_PER_HOUR) };
+}
+function quotaFactsOf(unified, nowMs) {
+  const fiveHour = windowFacts(unified?.fiveHour, nowMs);
+  const sevenDay = windowFacts(unified?.sevenDay, nowMs);
+  const extraUsage = windowFacts(unified === void 0 ? void 0 : soleOverageWindow(unified), nowMs);
+  return { ...fiveHour === void 0 ? {} : { fiveHour }, ...sevenDay === void 0 ? {} : { sevenDay }, ...extraUsage === void 0 ? {} : { extraUsage } };
+}
+var MS_PER_HOUR;
+var init_quotaFacts = __esm({
+  "src/usage/quotaFacts.ts"() {
+    "use strict";
+    init_rateLimit();
+    MS_PER_HOUR = 36e5;
+  }
+});
+
 // src/usage/pick.ts
 function unifiedOf(state) {
   return state?.rateLimit?.unified;
@@ -4530,18 +4591,22 @@ function assessIdentity(member, nowMs) {
     ...fiveHourWindow === void 0 || five === void 0 ? [] : [describeWindow("5h", fiveHourWindow, five, nowMs)],
     ...sevenDayWindow === void 0 || seven === void 0 ? [] : [describeWindow("7d", sevenDayWindow, seven, nowMs)]
   ];
+  const overageWindow = soleOverageWindow(unified);
+  const overage = overageWindow === void 0 ? void 0 : effectiveWindow(overageWindow, nowMs);
+  const overageReasons = overageWindow === void 0 || overage === void 0 ? [] : [describeWindow("extra usage", overageWindow, overage, nowMs)];
   const blockedUntil = Math.max(
-    windowBlockedUntil([five, seven].flatMap((window) => window === void 0 ? [] : [window])) ?? 0,
+    windowBlockedUntil([five, seven, overage].flatMap((window) => window === void 0 ? [] : [window])) ?? 0,
     limitBlockedUntil(state, nowMs) ?? 0
   );
   if (blockedUntil > 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, ...planReasons] } };
+    return { candidate: { ...base, class: "ineligible", blockedUntilMs: blockedUntil, reasons: [`refused until ${new Date(blockedUntil).toISOString()} (in ${formatAge(blockedUntil - nowMs)})`, ...windowReasons, ...overageReasons, ...planReasons] } };
   }
   if (plan.kind === "pay-per-use" || fiveHourWindow === void 0 && sevenDayWindow === void 0) {
-    return { candidate: { ...base, class: "pay-per-use", reasons: [...plan.kind === "pay-per-use" ? planReasons : ["no plan windows reported, so usage bills as extra usage"]] } };
+    const headroom = overage?.utilization === void 0 ? void 0 : Math.max(0, 1 - overage.utilization);
+    return { candidate: { ...base, class: "pay-per-use", ...headroom === void 0 ? {} : { headroom }, reasons: [...plan.kind === "pay-per-use" ? planReasons : ["no plan windows reported, so usage bills as extra usage"], ...overageReasons] } };
   }
   const basis = seven?.utilization !== void 0 ? { window: seven, windowMs: SEVEN_DAY_WINDOW_MS } : five?.utilization !== void 0 ? { window: five, windowMs: FIVE_HOUR_WINDOW_MS } : void 0;
   if (basis?.window.utilization === void 0) {
@@ -4549,7 +4614,7 @@ function assessIdentity(member, nowMs) {
   }
   const remaining = Math.max(0, 1 - basis.window.utilization);
   const untilResetMs = basis.window.resetsAtMs === void 0 ? basis.windowMs : Math.max(basis.window.resetsAtMs - nowMs, MS_PER_SECOND4);
-  const score = remaining * plan.capacity / (untilResetMs / MS_PER_HOUR);
+  const score = remaining * plan.capacity / (untilResetMs / MS_PER_HOUR2);
   const fiveRemaining = five?.utilization === void 0 ? void 0 : Math.max(0, 1 - five.utilization);
   const fiveUntil = five?.resetsAtMs === void 0 ? FIVE_HOUR_WINDOW_MS : Math.max(five.resetsAtMs - nowMs, MS_PER_SECOND4);
   const burn = windowBurn(member.records, "fiveHour");
@@ -4565,24 +4630,15 @@ function assessIdentity(member, nowMs) {
   };
 }
 function poolFactsOf(member, nowMs, resuming, sticky) {
-  const unified = member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit?.unified;
-  const window = (which) => {
-    const raw = unified?.[which];
-    if (raw?.utilization === void 0) {
-      return void 0;
-    }
-    if (raw.resetsAt === void 0) {
-      return void 0;
-    }
-    return { remaining: Math.max(0, 1 - raw.utilization), utilization: raw.utilization, hoursUntilReset: Math.max(0, (Date.parse(raw.resetsAt) - nowMs) / MS_PER_HOUR) };
-  };
+  const { fiveHour, sevenDay, extraUsage } = quotaFactsOf(member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit?.unified, nowMs);
   const burn = windowBurn(member.records, "fiveHour");
   return {
-    ...window("fiveHour") === void 0 ? {} : { fiveHour: window("fiveHour") },
-    ...window("sevenDay") === void 0 ? {} : { sevenDay: window("sevenDay") },
-    ...burn === void 0 ? {} : { burnPerHour: burn * MS_PER_HOUR },
+    ...fiveHour === void 0 ? {} : { fiveHour },
+    ...sevenDay === void 0 ? {} : { sevenDay },
+    ...extraUsage === void 0 ? {} : { extraUsage },
+    ...burn === void 0 ? {} : { burnPerHour: burn * MS_PER_HOUR2 },
     resuming,
-    ...sticky?.identity === member.identity ? { lastPickHoursAgo: Math.max(0, (nowMs - Date.parse(sticky.at)) / MS_PER_HOUR) } : {}
+    ...sticky?.identity === member.identity ? { lastPickHoursAgo: Math.max(0, (nowMs - Date.parse(sticky.at)) / MS_PER_HOUR2) } : {}
   };
 }
 function rankPool(input) {
@@ -4631,7 +4687,7 @@ function rankPool(input) {
     return { ...candidate, feasible: false, reasons: [...drySpots, ...candidate.reasons] };
   });
   const ordered = input.preference === "listed" ? [...candidates] : [...candidates].sort(
-    (left, right) => CLASS_ORDER[left.class] - CLASS_ORDER[right.class] || Number(left.policyDemoted ?? false) - Number(right.policyDemoted ?? false) || Number(right.feasible) - Number(left.feasible) || (right.score ?? 0) - (left.score ?? 0) || left.identity.localeCompare(right.identity)
+    (left, right) => CLASS_ORDER[left.class] - CLASS_ORDER[right.class] || Number(left.policyDemoted ?? false) - Number(right.policyDemoted ?? false) || Number(right.feasible) - Number(left.feasible) || (right.headroom ?? 1) - (left.headroom ?? 1) || (right.score ?? 0) - (left.score ?? 0) || left.identity.localeCompare(right.identity)
   );
   const sticky = input.sticky;
   const stickyIndex = sticky === void 0 ? -1 : ordered.findIndex((candidate) => candidate.identity === sticky.identity);
@@ -4656,7 +4712,7 @@ function rankPool(input) {
     ...movedOff === void 0 || pick === void 0 ? {} : { movedOff }
   };
 }
-var MS_PER_SECOND4, MS_PER_HOUR, HOURS_PER_DAY2, FIVE_HOURS, PROMPT_CACHE_TTL_HOURS, PERCENT, SEVEN_DAYS, FIVE_HOUR_WINDOW_MS, SEVEN_DAY_WINDOW_MS, PROMPT_CACHE_TTL_MS, CLASS_ORDER;
+var MS_PER_SECOND4, MS_PER_HOUR2, HOURS_PER_DAY2, FIVE_HOURS, PROMPT_CACHE_TTL_HOURS, PERCENT, SEVEN_DAYS, FIVE_HOUR_WINDOW_MS, SEVEN_DAY_WINDOW_MS, PROMPT_CACHE_TTL_MS, CLASS_ORDER;
 var init_pick = __esm({
   "src/usage/pick.ts"() {
     "use strict";
@@ -4664,17 +4720,18 @@ var init_pick = __esm({
     init_plan2();
     init_middleware();
     init_preflight();
+    init_quotaFacts();
     init_rateLimit();
     MS_PER_SECOND4 = 1e3;
-    MS_PER_HOUR = 36e5;
+    MS_PER_HOUR2 = 36e5;
     HOURS_PER_DAY2 = 24;
     FIVE_HOURS = 5;
     PROMPT_CACHE_TTL_HOURS = 1;
     PERCENT = 100;
     SEVEN_DAYS = 7;
-    FIVE_HOUR_WINDOW_MS = FIVE_HOURS * MS_PER_HOUR;
-    SEVEN_DAY_WINDOW_MS = SEVEN_DAYS * HOURS_PER_DAY2 * MS_PER_HOUR;
-    PROMPT_CACHE_TTL_MS = PROMPT_CACHE_TTL_HOURS * MS_PER_HOUR;
+    FIVE_HOUR_WINDOW_MS = FIVE_HOURS * MS_PER_HOUR2;
+    SEVEN_DAY_WINDOW_MS = SEVEN_DAYS * HOURS_PER_DAY2 * MS_PER_HOUR2;
+    PROMPT_CACHE_TTL_MS = PROMPT_CACHE_TTL_HOURS * MS_PER_HOUR2;
     CLASS_ORDER = { scored: 0, unknown: 1, "pay-per-use": 2, ineligible: 3 };
   }
 });
@@ -4895,8 +4952,9 @@ 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 overageStatus = rateLimit.unified?.overageStatus ?? state.rateLimit?.unified?.overageStatus;
-      const merged = overageStatus === void 0 || rateLimit.unified === void 0 ? rateLimit : { ...rateLimit, unified: { ...rateLimit.unified, overageStatus } };
+      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 } };
       return { ...current?.providers, [provider]: { ...state, rateLimit: keep ? state.rateLimit : merged } };
     })
   };
@@ -7360,7 +7418,8 @@ function unifiedFromReportedLimits(reported) {
   return { ...fiveHour === void 0 ? {} : { fiveHour }, ...sevenDay === void 0 ? {} : { sevenDay } };
 }
 function isAnthropicUsageProbeable(member) {
-  return planOf(member.account ?? member.snapshot?.account).kind === "subscription";
+  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);
 }
 function isAnthropicUsageStale(member, nowMs) {
   const rateLimit = member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit;
@@ -7446,6 +7505,7 @@ 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;
@@ -7676,6 +7736,7 @@ __export(index_exports, {
   OWN_CLI_FILE_NAME: () => OWN_CLI_FILE_NAME,
   PROMPT_CACHE_TTL_MS: () => PROMPT_CACHE_TTL_MS,
   PlanClassSchema: () => PlanClassSchema,
+  PoolGraphError: () => PoolGraphError,
   PoolNameSchema: () => PoolNameSchema,
   PoolNotFoundError: () => PoolNotFoundError,
   PoolPickReportSchema: () => PoolPickReportSchema,
@@ -13167,11 +13228,11 @@ function createDoorHealthPublisher(hub, now, pid) {
 
 // src/frontdoor/quotaExpiringEvents.ts
 init_schema2();
-var MS_PER_HOUR2 = 36e5;
+var MS_PER_HOUR3 = 36e5;
 var MS_PER_DAY2 = 864e5;
 var FIVE_HOUR_WINDOW_HOURS = 5;
 var SEVEN_DAY_WINDOW_DAYS = 7;
-var FIVE_HOUR_WINDOW_MS2 = FIVE_HOUR_WINDOW_HOURS * MS_PER_HOUR2;
+var FIVE_HOUR_WINDOW_MS2 = FIVE_HOUR_WINDOW_HOURS * MS_PER_HOUR3;
 var SEVEN_DAY_WINDOW_MS2 = SEVEN_DAY_WINDOW_DAYS * MS_PER_DAY2;
 var FINAL_SPAN_DENOMINATOR = 30;
 var QUOTA_EXPIRING_WINDOW_FRACTION = 1 / FINAL_SPAN_DENOMINATOR;
@@ -15214,6 +15275,7 @@ init_ownCli();
   OWN_CLI_FILE_NAME,
   PROMPT_CACHE_TTL_MS,
   PlanClassSchema,
+  PoolGraphError,
   PoolNameSchema,
   PoolNotFoundError,
   PoolPickReportSchema,

package/dist/index.mjs

@@ -750,6 +750,18 @@ function matchBranch(pattern, branch, detached = false) {
   }
   return picomatch2(pattern, { dot: true, nocase: false })(branch);
 }
+function windowValues(prefix, windows) {
+  const values = {};
+  for (const name of ["fiveHour", "sevenDay", "extraUsage"]) {
+    const facts = windows?.[name];
+    if (facts !== void 0) {
+      values[`${prefix}.${name}.remaining`] = facts.remaining;
+      values[`${prefix}.${name}.utilization`] = facts.utilization;
+      values[`${prefix}.${name}.hoursUntilReset`] = facts.hoursUntilReset;
+    }
+  }
+  return values;
+}
 function resolversOf(context) {
   const pool = context.pool;
   const values = {
@@ -758,8 +770,7 @@ function resolversOf(context) {
     ...context.fact?.totalSizeBytes === void 0 ? {} : { "entry.totalSizeBytes": context.fact.totalSizeBytes },
     ...context.branch === void 0 ? {} : { "repo.branch": context.branch },
     "repo.detached": context.branchDetached ?? false,
-    ...pool?.fiveHour === void 0 ? {} : { "quota.fiveHour.remaining": pool.fiveHour.remaining, "quota.fiveHour.utilization": pool.fiveHour.utilization, "quota.fiveHour.hoursUntilReset": pool.fiveHour.hoursUntilReset },
-    ...pool?.sevenDay === void 0 ? {} : { "quota.sevenDay.remaining": pool.sevenDay.remaining, "quota.sevenDay.utilization": pool.sevenDay.utilization, "quota.sevenDay.hoursUntilReset": pool.sevenDay.hoursUntilReset },
+    ...windowValues("quota", pool),
     ...pool?.burnPerHour === void 0 ? {} : { "quota.burnPerHour": pool.burnPerHour },
     ...pool?.resuming === void 0 ? {} : { "session.resuming": pool.resuming },
     ...pool?.lastPickHoursAgo === void 0 ? {} : { "session.lastPickHoursAgo": pool.lastPickHoursAgo },
@@ -770,12 +781,7 @@ function resolversOf(context) {
     ...context.request?.maxTokens === void 0 ? {} : { "request.maxTokens": context.request.maxTokens },
     ...context.request?.isCountTokens === void 0 ? {} : { "request.isCountTokens": context.request.isCountTokens },
     ...context.providerQuota === void 0 ? {} : Object.fromEntries(
-      Object.entries(context.providerQuota).flatMap(
-        ([name, windows]) => [
-          ...windows.fiveHour === void 0 ? [] : [["provider." + name + ".fiveHour.remaining", windows.fiveHour.remaining], ["provider." + name + ".fiveHour.utilization", windows.fiveHour.utilization], ["provider." + name + ".fiveHour.hoursUntilReset", windows.fiveHour.hoursUntilReset]],
-          ...windows.sevenDay === void 0 ? [] : [["provider." + name + ".sevenDay.remaining", windows.sevenDay.remaining], ["provider." + name + ".sevenDay.utilization", windows.sevenDay.utilization], ["provider." + name + ".sevenDay.hoursUntilReset", windows.sevenDay.hoursUntilReset]]
-        ]
-      )
+      Object.entries(context.providerQuota).flatMap(([name, windows]) => Object.entries(windowValues("provider." + name, windows)))
     )
   };
   return {
@@ -2619,7 +2625,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "agent-shim",
-      version: "9.0.0",
+      version: "9.2.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>",
@@ -4070,7 +4076,13 @@ var init_schema2 = __esm({
       /** When the binding window resets. */
       resetAt: InstantSchema.optional(),
       /** Whether usage beyond the plan (extra usage) is available: `allowed` or `rejected`. */
-      overageStatus: z7.string().optional()
+      overageStatus: z7.string().optional(),
+      /** The fraction of the extra-usage allowance used, as the upstream reports it (0 to 1). An account with no plan windows, such as an Enterprise one, is metered by this alone. */
+      overageUtilization: z7.number().nonnegative().optional(),
+      /** 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()
     });
     RateLimitStateSchema = z7.strictObject({
       observedAt: InstantSchema,
@@ -4304,15 +4316,40 @@ function parseUnifiedRateLimit(headers) {
   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`];
   return {
     ...status === void 0 ? {} : { status },
     ...fiveHour === void 0 ? {} : { fiveHour },
     ...sevenDay === void 0 ? {} : { sevenDay },
     ...representativeClaim === void 0 ? {} : { representativeClaim },
     ...resetAt === void 0 ? {} : { resetAt },
-    ...overageStatus === void 0 ? {} : { overageStatus }
+    ...overageStatus === void 0 ? {} : { overageStatus },
+    ...overageUtilization === void 0 ? {} : { overageUtilization },
+    ...overageResetsAt === void 0 ? {} : { overageResetsAt },
+    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason }
   };
 }
+function overageFactsOf(unified) {
+  const { overageStatus, overageUtilization, overageResetsAt, overageDisabledReason } = unified;
+  return {
+    ...overageStatus === void 0 ? {} : { overageStatus },
+    ...overageUtilization === void 0 ? {} : { overageUtilization },
+    ...overageResetsAt === void 0 ? {} : { overageResetsAt },
+    ...overageDisabledReason === void 0 ? {} : { overageDisabledReason }
+  };
+}
+function overageWindowOf(unified) {
+  const { overageUtilization: utilization, overageResetsAt: resetsAt, overageStatus: status } = unified;
+  if (utilization === void 0 && resetsAt === void 0 && status === void 0) {
+    return void 0;
+  }
+  return { ...utilization === void 0 ? {} : { utilization }, ...resetsAt === void 0 ? {} : { resetsAt }, ...status === void 0 ? {} : { status } };
+}
+function soleOverageWindow(unified) {
+  return unified.fiveHour === void 0 && unified.sevenDay === void 0 ? overageWindowOf(unified) : void 0;
+}
 var MS_PER_SECOND2, UNIFIED_PREFIX;
 var init_rateLimit = __esm({
   "src/usage/rateLimit.ts"() {
@@ -4386,7 +4423,8 @@ function quotaWarnings(snapshot, provider, nowMs) {
   const age = formatAge(nowMs - Date.parse(rateLimit.observedAt));
   const windows = [
     { name: "five-hour", window: unified.fiveHour },
-    { name: "seven-day", window: unified.sevenDay }
+    { name: "seven-day", window: unified.sevenDay },
+    { name: "extra-usage", window: soleOverageWindow(unified) }
   ];
   return windows.flatMap(({ name, window }) => {
     const effective = window === void 0 ? void 0 : effectiveWindow(window, nowMs);
@@ -4402,6 +4440,7 @@ var MS_PER_SECOND3, SECONDS_PER_MINUTE, MINUTES_PER_HOUR, HOURS_PER_DAY, WARNING
 var init_preflight = __esm({
   "src/usage/preflight.ts"() {
     "use strict";
+    init_rateLimit();
     MS_PER_SECOND3 = 1e3;
     SECONDS_PER_MINUTE = 60;
     MINUTES_PER_HOUR = 60;
@@ -4410,6 +4449,28 @@ var init_preflight = __esm({
   }
 });
 
+// src/usage/quotaFacts.ts
+function windowFacts(window, nowMs) {
+  if (window?.utilization === void 0 || window.resetsAt === void 0) {
+    return void 0;
+  }
+  return { remaining: Math.max(0, 1 - window.utilization), utilization: window.utilization, hoursUntilReset: Math.max(0, (Date.parse(window.resetsAt) - nowMs) / MS_PER_HOUR) };
+}
+function quotaFactsOf(unified, nowMs) {
+  const fiveHour = windowFacts(unified?.fiveHour, nowMs);
+  const sevenDay = windowFacts(unified?.sevenDay, nowMs);
+  const extraUsage = windowFacts(unified === void 0 ? void 0 : soleOverageWindow(unified), nowMs);
+  return { ...fiveHour === void 0 ? {} : { fiveHour }, ...sevenDay === void 0 ? {} : { sevenDay }, ...extraUsage === void 0 ? {} : { extraUsage } };
+}
+var MS_PER_HOUR;
+var init_quotaFacts = __esm({
+  "src/usage/quotaFacts.ts"() {
+    "use strict";
+    init_rateLimit();
+    MS_PER_HOUR = 36e5;
+  }
+});
+
 // src/usage/pick.ts
 function unifiedOf(state) {
   return state?.rateLimit?.unified;
@@ -4504,18 +4565,22 @@ function assessIdentity(member, nowMs) {
     ...fiveHourWindow === void 0 || five === void 0 ? [] : [describeWindow("5h", fiveHourWindow, five, nowMs)],
     ...sevenDayWindow === void 0 || seven === void 0 ? [] : [describeWindow("7d", sevenDayWindow, seven, nowMs)]
   ];
+  const overageWindow = soleOverageWindow(unified);
+  const overage = overageWindow === void 0 ? void 0 : effectiveWindow(overageWindow, nowMs);
+  const overageReasons = overageWindow === void 0 || overage === void 0 ? [] : [describeWindow("extra usage", overageWindow, overage, nowMs)];
   const blockedUntil = Math.max(
-    windowBlockedUntil([five, seven].flatMap((window) => window === void 0 ? [] : [window])) ?? 0,
+    windowBlockedUntil([five, seven, overage].flatMap((window) => window === void 0 ? [] : [window])) ?? 0,
     limitBlockedUntil(state, nowMs) ?? 0
   );
   if (blockedUntil > 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, ...planReasons] } };
+    return { candidate: { ...base, class: "ineligible", blockedUntilMs: blockedUntil, reasons: [`refused until ${new Date(blockedUntil).toISOString()} (in ${formatAge(blockedUntil - nowMs)})`, ...windowReasons, ...overageReasons, ...planReasons] } };
   }
   if (plan.kind === "pay-per-use" || fiveHourWindow === void 0 && sevenDayWindow === void 0) {
-    return { candidate: { ...base, class: "pay-per-use", reasons: [...plan.kind === "pay-per-use" ? planReasons : ["no plan windows reported, so usage bills as extra usage"]] } };
+    const headroom = overage?.utilization === void 0 ? void 0 : Math.max(0, 1 - overage.utilization);
+    return { candidate: { ...base, class: "pay-per-use", ...headroom === void 0 ? {} : { headroom }, reasons: [...plan.kind === "pay-per-use" ? planReasons : ["no plan windows reported, so usage bills as extra usage"], ...overageReasons] } };
   }
   const basis = seven?.utilization !== void 0 ? { window: seven, windowMs: SEVEN_DAY_WINDOW_MS } : five?.utilization !== void 0 ? { window: five, windowMs: FIVE_HOUR_WINDOW_MS } : void 0;
   if (basis?.window.utilization === void 0) {
@@ -4523,7 +4588,7 @@ function assessIdentity(member, nowMs) {
   }
   const remaining = Math.max(0, 1 - basis.window.utilization);
   const untilResetMs = basis.window.resetsAtMs === void 0 ? basis.windowMs : Math.max(basis.window.resetsAtMs - nowMs, MS_PER_SECOND4);
-  const score = remaining * plan.capacity / (untilResetMs / MS_PER_HOUR);
+  const score = remaining * plan.capacity / (untilResetMs / MS_PER_HOUR2);
   const fiveRemaining = five?.utilization === void 0 ? void 0 : Math.max(0, 1 - five.utilization);
   const fiveUntil = five?.resetsAtMs === void 0 ? FIVE_HOUR_WINDOW_MS : Math.max(five.resetsAtMs - nowMs, MS_PER_SECOND4);
   const burn = windowBurn(member.records, "fiveHour");
@@ -4539,24 +4604,15 @@ function assessIdentity(member, nowMs) {
   };
 }
 function poolFactsOf(member, nowMs, resuming, sticky) {
-  const unified = member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit?.unified;
-  const window = (which) => {
-    const raw = unified?.[which];
-    if (raw?.utilization === void 0) {
-      return void 0;
-    }
-    if (raw.resetsAt === void 0) {
-      return void 0;
-    }
-    return { remaining: Math.max(0, 1 - raw.utilization), utilization: raw.utilization, hoursUntilReset: Math.max(0, (Date.parse(raw.resetsAt) - nowMs) / MS_PER_HOUR) };
-  };
+  const { fiveHour, sevenDay, extraUsage } = quotaFactsOf(member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit?.unified, nowMs);
   const burn = windowBurn(member.records, "fiveHour");
   return {
-    ...window("fiveHour") === void 0 ? {} : { fiveHour: window("fiveHour") },
-    ...window("sevenDay") === void 0 ? {} : { sevenDay: window("sevenDay") },
-    ...burn === void 0 ? {} : { burnPerHour: burn * MS_PER_HOUR },
+    ...fiveHour === void 0 ? {} : { fiveHour },
+    ...sevenDay === void 0 ? {} : { sevenDay },
+    ...extraUsage === void 0 ? {} : { extraUsage },
+    ...burn === void 0 ? {} : { burnPerHour: burn * MS_PER_HOUR2 },
     resuming,
-    ...sticky?.identity === member.identity ? { lastPickHoursAgo: Math.max(0, (nowMs - Date.parse(sticky.at)) / MS_PER_HOUR) } : {}
+    ...sticky?.identity === member.identity ? { lastPickHoursAgo: Math.max(0, (nowMs - Date.parse(sticky.at)) / MS_PER_HOUR2) } : {}
   };
 }
 function rankPool(input) {
@@ -4605,7 +4661,7 @@ function rankPool(input) {
     return { ...candidate, feasible: false, reasons: [...drySpots, ...candidate.reasons] };
   });
   const ordered = input.preference === "listed" ? [...candidates] : [...candidates].sort(
-    (left, right) => CLASS_ORDER[left.class] - CLASS_ORDER[right.class] || Number(left.policyDemoted ?? false) - Number(right.policyDemoted ?? false) || Number(right.feasible) - Number(left.feasible) || (right.score ?? 0) - (left.score ?? 0) || left.identity.localeCompare(right.identity)
+    (left, right) => CLASS_ORDER[left.class] - CLASS_ORDER[right.class] || Number(left.policyDemoted ?? false) - Number(right.policyDemoted ?? false) || Number(right.feasible) - Number(left.feasible) || (right.headroom ?? 1) - (left.headroom ?? 1) || (right.score ?? 0) - (left.score ?? 0) || left.identity.localeCompare(right.identity)
   );
   const sticky = input.sticky;
   const stickyIndex = sticky === void 0 ? -1 : ordered.findIndex((candidate) => candidate.identity === sticky.identity);
@@ -4630,7 +4686,7 @@ function rankPool(input) {
     ...movedOff === void 0 || pick === void 0 ? {} : { movedOff }
   };
 }
-var MS_PER_SECOND4, MS_PER_HOUR, HOURS_PER_DAY2, FIVE_HOURS, PROMPT_CACHE_TTL_HOURS, PERCENT, SEVEN_DAYS, FIVE_HOUR_WINDOW_MS, SEVEN_DAY_WINDOW_MS, PROMPT_CACHE_TTL_MS, CLASS_ORDER;
+var MS_PER_SECOND4, MS_PER_HOUR2, HOURS_PER_DAY2, FIVE_HOURS, PROMPT_CACHE_TTL_HOURS, PERCENT, SEVEN_DAYS, FIVE_HOUR_WINDOW_MS, SEVEN_DAY_WINDOW_MS, PROMPT_CACHE_TTL_MS, CLASS_ORDER;
 var init_pick = __esm({
   "src/usage/pick.ts"() {
     "use strict";
@@ -4638,17 +4694,18 @@ var init_pick = __esm({
     init_plan2();
     init_middleware();
     init_preflight();
+    init_quotaFacts();
     init_rateLimit();
     MS_PER_SECOND4 = 1e3;
-    MS_PER_HOUR = 36e5;
+    MS_PER_HOUR2 = 36e5;
     HOURS_PER_DAY2 = 24;
     FIVE_HOURS = 5;
     PROMPT_CACHE_TTL_HOURS = 1;
     PERCENT = 100;
     SEVEN_DAYS = 7;
-    FIVE_HOUR_WINDOW_MS = FIVE_HOURS * MS_PER_HOUR;
-    SEVEN_DAY_WINDOW_MS = SEVEN_DAYS * HOURS_PER_DAY2 * MS_PER_HOUR;
-    PROMPT_CACHE_TTL_MS = PROMPT_CACHE_TTL_HOURS * MS_PER_HOUR;
+    FIVE_HOUR_WINDOW_MS = FIVE_HOURS * MS_PER_HOUR2;
+    SEVEN_DAY_WINDOW_MS = SEVEN_DAYS * HOURS_PER_DAY2 * MS_PER_HOUR2;
+    PROMPT_CACHE_TTL_MS = PROMPT_CACHE_TTL_HOURS * MS_PER_HOUR2;
     CLASS_ORDER = { scored: 0, unknown: 1, "pay-per-use": 2, ineligible: 3 };
   }
 });
@@ -4870,8 +4927,9 @@ 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 overageStatus = rateLimit.unified?.overageStatus ?? state.rateLimit?.unified?.overageStatus;
-      const merged = overageStatus === void 0 || rateLimit.unified === void 0 ? rateLimit : { ...rateLimit, unified: { ...rateLimit.unified, overageStatus } };
+      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 } };
       return { ...current?.providers, [provider]: { ...state, rateLimit: keep ? state.rateLimit : merged } };
     })
   };
@@ -7332,7 +7390,8 @@ function unifiedFromReportedLimits(reported) {
   return { ...fiveHour === void 0 ? {} : { fiveHour }, ...sevenDay === void 0 ? {} : { sevenDay } };
 }
 function isAnthropicUsageProbeable(member) {
-  return planOf(member.account ?? member.snapshot?.account).kind === "subscription";
+  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);
 }
 function isAnthropicUsageStale(member, nowMs) {
   const rateLimit = member.snapshot?.providers[ANTHROPIC_PROVIDER]?.rateLimit;
@@ -7418,6 +7477,7 @@ 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;
@@ -12843,11 +12903,11 @@ function createDoorHealthPublisher(hub, now, pid) {
 
 // src/frontdoor/quotaExpiringEvents.ts
 init_schema2();
-var MS_PER_HOUR2 = 36e5;
+var MS_PER_HOUR3 = 36e5;
 var MS_PER_DAY2 = 864e5;
 var FIVE_HOUR_WINDOW_HOURS = 5;
 var SEVEN_DAY_WINDOW_DAYS = 7;
-var FIVE_HOUR_WINDOW_MS2 = FIVE_HOUR_WINDOW_HOURS * MS_PER_HOUR2;
+var FIVE_HOUR_WINDOW_MS2 = FIVE_HOUR_WINDOW_HOURS * MS_PER_HOUR3;
 var SEVEN_DAY_WINDOW_MS2 = SEVEN_DAY_WINDOW_DAYS * MS_PER_DAY2;
 var FINAL_SPAN_DENOMINATOR = 30;
 var QUOTA_EXPIRING_WINDOW_FRACTION = 1 / FINAL_SPAN_DENOMINATOR;
@@ -14889,6 +14949,7 @@ export {
   OWN_CLI_FILE_NAME,
   PROMPT_CACHE_TTL_MS,
   PlanClassSchema,
+  PoolGraphError,
   PoolNameSchema,
   PoolNotFoundError,
   PoolPickReportSchema,