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

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export * from './git-normalize';
 export * from './session-normalize';
 export * from './node-normalize';
 export * from './node-facts';
+export * from './quota-freshness';
 export * from './workspace-normalize';
 export * from './daemon-normalize';
 export * from './git-summarize';

package/dist/index.js

@@ -97,6 +97,8 @@ __export(index_exports, {
   OUTBOUND_MESSAGE_ORIGINS: () => OUTBOUND_MESSAGE_ORIGINS,
   P2P_SIGNAL_TYPES: () => P2P_SIGNAL_TYPES,
   PROVIDER_FAILURES: () => PROVIDER_FAILURES,
+  QUOTA_BACKFILL_HORIZON_MS: () => QUOTA_BACKFILL_HORIZON_MS,
+  QUOTA_RETRY_INFLIGHT_GRACE_MS: () => QUOTA_RETRY_INFLIGHT_GRACE_MS,
   QUOTA_SUPPORTED_PROVIDERS: () => QUOTA_SUPPORTED_PROVIDERS,
   RECENT_SESSION_BUCKETS: () => RECENT_SESSION_BUCKETS,
   RECLAIMING_SEND_REFUSALS: () => RECLAIMING_SEND_REFUSALS,
@@ -145,6 +147,7 @@ __export(index_exports, {
   WORKER_TOOLS: () => WORKER_TOOLS,
   appendWorkerProtocolFooter: () => appendWorkerProtocolFooter,
   argsCarryStatusProbeMarker: () => argsCarryStatusProbeMarker,
+  assessQuotaFreshness: () => assessQuotaFreshness,
   buildSlotProposal: () => buildSlotProposal,
   canonicalDaemonId: () => canonicalDaemonId,
   classifySessionStatus: () => classifySessionStatus,
@@ -303,6 +306,7 @@ __export(index_exports, {
   meshUtf8ByteLength: () => meshUtf8ByteLength,
   meshWorkspacesEquivalent: () => meshWorkspacesEquivalent,
   mintMessageId: () => mintMessageId,
+  minutesUntilQuotaCheck: () => minutesUntilQuotaCheck,
   normalizeAuthOkLimits: () => normalizeAuthOkLimits,
   normalizeBrainSlot: () => normalizeBrainSlot,
   normalizeDifficultyBrainMap: () => normalizeDifficultyBrainMap,
@@ -656,6 +660,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 "";
@@ -3828,6 +3870,8 @@ function stableMeshNodeRow(row) {
   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,
@@ -3876,6 +3920,7 @@ function stableMeshNodeRow(row) {
   WORKER_TOOLS,
   appendWorkerProtocolFooter,
   argsCarryStatusProbeMarker,
+  assessQuotaFreshness,
   buildSlotProposal,
   canonicalDaemonId,
   classifySessionStatus,
@@ -4034,6 +4079,7 @@ function stableMeshNodeRow(row) {
   meshUtf8ByteLength,
   meshWorkspacesEquivalent,
   mintMessageId,
+  minutesUntilQuotaCheck,
   normalizeAuthOkLimits,
   normalizeBrainSlot,
   normalizeDifficultyBrainMap,