@adhdev/mesh-shared 1.0.82-rc.4 → 1.0.82-rc.5

package/dist/index.mjs

@@ -300,6 +300,44 @@ function defaultProviderPriorityFromNodeFacts(facts) {
   return orderProvidersByBuiltinPreference(detected.length ? detected : enabled);
 }
 
+// src/quota-freshness.ts
+var QUOTA_RETRY_INFLIGHT_GRACE_MS = 6e4;
+var QUOTA_BACKFILL_HORIZON_MS = 60 * 60 * 1e3;
+function hasUsableWindow(window) {
+  return !!window && typeof window.usedPercent === "number" && Number.isFinite(window.usedPercent);
+}
+function hasReading(quota) {
+  if (hasUsableWindow(quota.session) || hasUsableWindow(quota.weekly)) return true;
+  return Array.isArray(quota.buckets) && quota.buckets.some((b) => !!b && typeof b.usedPercent === "number" && Number.isFinite(b.usedPercent));
+}
+function finiteMs(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
+function backfillCheckAt(quota, now) {
+  const dataDue = finiteMs(quota.updatedAt);
+  const attempted = finiteMs(quota.metadata?.fetchedAt);
+  const dueAt = Math.max(
+    dataDue === void 0 ? Number.NEGATIVE_INFINITY : dataDue + QUOTA_BACKFILL_HORIZON_MS,
+    attempted === void 0 ? Number.NEGATIVE_INFINITY : attempted + QUOTA_BACKFILL_HORIZON_MS
+  );
+  return Number.isFinite(dueAt) && dueAt > now ? dueAt : void 0;
+}
+function assessQuotaFreshness(quota, now = Date.now()) {
+  const meta = quota.metadata;
+  const kind = meta?.failureKind;
+  const userMustAct = kind === "no-data" && quota.provider !== "codex-cli" || kind === "expired-token" && quota.provider === "antigravity-cli";
+  if (userMustAct && hasReading(quota)) return { cue: "stale", userMustAct: true };
+  if (meta?.lastGoodWindows !== true) return { userMustAct };
+  const retryAtMs = finiteMs(meta?.retryAtMs);
+  const retryStopped = meta?.retryExhausted === true || retryAtMs !== void 0 && retryAtMs + QUOTA_RETRY_INFLIGHT_GRACE_MS < now;
+  if (kind !== "no-data" && !retryStopped) return { cue: "refreshing", userMustAct: false };
+  const nextCheckAt = backfillCheckAt(quota, now);
+  return nextCheckAt === void 0 ? { cue: "stale", userMustAct: false } : { cue: "stale", userMustAct: false, nextCheckAt };
+}
+function minutesUntilQuotaCheck(nextCheckAt, now = Date.now()) {
+  return Math.max(1, Math.round((nextCheckAt - now) / 6e4));
+}
+
 // src/workspace-normalize.ts
 function normalizeMeshWorkspaceForCompare(dir) {
   if (typeof dir !== "string") return "";
@@ -3471,6 +3509,8 @@ export {
   OUTBOUND_MESSAGE_ORIGINS,
   P2P_SIGNAL_TYPES,
   PROVIDER_FAILURES,
+  QUOTA_BACKFILL_HORIZON_MS,
+  QUOTA_RETRY_INFLIGHT_GRACE_MS,
   QUOTA_SUPPORTED_PROVIDERS,
   RECENT_SESSION_BUCKETS,
   RECLAIMING_SEND_REFUSALS,
@@ -3519,6 +3559,7 @@ export {
   WORKER_TOOLS,
   appendWorkerProtocolFooter,
   argsCarryStatusProbeMarker,
+  assessQuotaFreshness,
   buildSlotProposal,
   canonicalDaemonId,
   classifySessionStatus,
@@ -3677,6 +3718,7 @@ export {
   meshUtf8ByteLength,
   meshWorkspacesEquivalent,
   mintMessageId,
+  minutesUntilQuotaCheck,
   normalizeAuthOkLimits,
   normalizeBrainSlot,
   normalizeDifficultyBrainMap,