agent-shim 8.30.0 → 8.32.0

package/dist/cli.cjs

@@ -61796,7 +61796,7 @@ function registerIdentityCommand(program2, deps) {
 // package.json
 var package_default = {
   name: "agent-shim",
-  version: "8.30.0",
+  version: "8.32.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>",
@@ -62775,10 +62775,10 @@ function windowBlockedUntil(windows) {
   const resets = windows.flatMap((window) => window.status === "rejected" && window.resetsAtMs !== void 0 ? [window.resetsAtMs] : []);
   return resets.length === 0 ? void 0 : Math.max(...resets);
 }
-function fiveHourBurn(records) {
+function windowBurn(records, which) {
   const points = [];
   for (const record2 of records) {
-    const window = record2.rateLimitHeaders === void 0 ? void 0 : parseUnifiedRateLimit(record2.rateLimitHeaders)?.fiveHour;
+    const window = record2.rateLimitHeaders === void 0 ? void 0 : parseUnifiedRateLimit(record2.rateLimitHeaders)?.[which];
     if (window?.utilization !== void 0 && window.resetsAt !== void 0) {
       points.push({ resetsAt: window.resetsAt, point: { atMs: Date.parse(record2.at), utilization: window.utilization } });
     }
@@ -62872,11 +62872,16 @@ function assessIdentity(member, nowMs) {
   const score = remaining * plan.capacity / (untilResetMs / MS_PER_HOUR);
   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_SECOND3);
-  const burn = fiveHourBurn(member.records);
+  const burn = windowBurn(member.records, "fiveHour");
+  const sevenRemaining = seven?.utilization === void 0 ? void 0 : Math.max(0, 1 - seven.utilization);
+  const sevenUntil = seven?.resetsAtMs === void 0 ? SEVEN_DAY_WINDOW_MS : Math.max(seven.resetsAtMs - nowMs, MS_PER_SECOND3);
+  const sevenDayBurn = windowBurn(member.records, "sevenDay");
   return {
     candidate: { ...base, class: "scored", score, reasons: [...windowReasons.map((reason, index) => index === windowReasons.length - 1 ? `${reason}${observedAgo}` : reason), ...planReasons] },
     ...fiveRemaining === void 0 ? {} : { fiveHour: { remaining: fiveRemaining, untilResetMs: fiveUntil } },
-    ...burn === void 0 ? {} : { burn }
+    ...burn === void 0 ? {} : { burn },
+    ...sevenRemaining === void 0 ? {} : { sevenDay: { remaining: sevenRemaining, untilResetMs: sevenUntil } },
+    ...sevenDayBurn === void 0 ? {} : { sevenDayBurn }
   };
 }
 function rankPool(input2) {
@@ -62887,14 +62892,27 @@ function rankPool(input2) {
   const candidates = assessments.map((assessment) => {
     const { candidate, fiveHour, burn } = assessment;
     const pace = burn ?? (sharedDemand === void 0 ? void 0 : sharedDemand / capacityOf(candidate.plan));
-    if (candidate.class !== "scored" || fiveHour === void 0 || pace === void 0) {
+    const { sevenDay, sevenDayBurn } = assessment;
+    if (candidate.class !== "scored") {
       return { ...candidate, feasible: true };
     }
-    const runsDryInMs = fiveHour.remaining / pace;
-    if (runsDryInMs >= fiveHour.untilResetMs) {
+    const drySpots = [];
+    if (fiveHour !== void 0 && pace !== void 0) {
+      const runsDryInMs = fiveHour.remaining / pace;
+      if (runsDryInMs < fiveHour.untilResetMs) {
+        drySpots.push(`5h window would run dry in ${formatAge(runsDryInMs)}, before it resets in ${formatAge(fiveHour.untilResetMs)}`);
+      }
+    }
+    if (sevenDay !== void 0 && sevenDayBurn !== void 0) {
+      const runsDryInMs = sevenDay.remaining / sevenDayBurn;
+      if (runsDryInMs < sevenDay.untilResetMs) {
+        drySpots.push(`7d window would run dry in ${formatAge(runsDryInMs)}, before it resets in ${formatAge(sevenDay.untilResetMs)}`);
+      }
+    }
+    if (drySpots.length === 0) {
       return { ...candidate, feasible: true };
     }
-    return { ...candidate, feasible: false, reasons: [`5h window would run dry in ${formatAge(runsDryInMs)}, before it resets in ${formatAge(fiveHour.untilResetMs)}`, ...candidate.reasons] };
+    return { ...candidate, feasible: false, reasons: [...drySpots, ...candidate.reasons] };
   });
   const ordered = input2.preference === "listed" ? [...candidates] : [...candidates].sort(
     (left, right) => CLASS_ORDER[left.class] - CLASS_ORDER[right.class] || Number(right.feasible) - Number(left.feasible) || (right.score ?? 0) - (left.score ?? 0) || left.identity.localeCompare(right.identity)
@@ -62902,7 +62920,8 @@ function rankPool(input2) {
   const sticky = input2.sticky;
   const stickyIndex = sticky === void 0 ? -1 : ordered.findIndex((candidate) => candidate.identity === sticky.identity);
   const stickyCandidate = ordered[stickyIndex];
-  if (sticky !== void 0 && stickyCandidate?.class === "scored" && stickyCandidate.feasible) {
+  const keepSticky = stickyCandidate?.class === "scored" && stickyCandidate.feasible;
+  if (sticky !== void 0 && keepSticky) {
     const ageMs = nowMs - Date.parse(sticky.at);
     const warm = ageMs <= PROMPT_CACHE_TTL_MS;
     if (input2.resuming || warm) {
@@ -62911,12 +62930,14 @@ function rankPool(input2) {
       ordered.unshift({ ...stickyCandidate, reasons: [why, ...stickyCandidate.reasons] });
     }
   }
+  const movedOff = sticky !== void 0 && input2.resuming && !keepSticky ? { identity: sticky.identity, reason: stickyCandidate?.reasons[0] ?? "no longer among the pool's members" } : void 0;
   const pick2 = ordered.find((candidate) => candidate.class !== "ineligible");
   const returns = ordered.flatMap((candidate) => candidate.blockedUntilMs === void 0 ? [] : [{ identity: candidate.identity, atMs: candidate.blockedUntilMs }]);
   const earliestReturn = returns.length === 0 ? void 0 : returns.reduce((soonest, entry) => entry.atMs < soonest.atMs ? entry : soonest);
   return {
     candidates: ordered,
-    ...pick2 === void 0 ? { ...earliestReturn === void 0 ? {} : { earliestReturn } } : { pick: pick2 }
+    ...pick2 === void 0 ? { ...earliestReturn === void 0 ? {} : { earliestReturn } } : { pick: pick2 },
+    ...movedOff === void 0 || pick2 === void 0 ? {} : { movedOff }
   };
 }
 
@@ -63150,6 +63171,7 @@ function createUsageStore(deps) {
     fs20.mkdirPrivate(paths.usageSnapshotsDir);
     fs20.writeFilePrivate(snapshotPath(paths.usageSnapshotsDir, identity), `${JSON.stringify(snapshot, null, 2)}
 `);
+    deps.publish?.(snapshot);
     return true;
   };
   return {
@@ -63331,6 +63353,7 @@ function collectPoolPick(params) {
     candidates: ranking.candidates.map(candidateView),
     missing: missing.map(({ identity }) => identity),
     ...ranking.earliestReturn === void 0 ? {} : { earliestReturn: { identity: ranking.earliestReturn.identity, at: new Date(ranking.earliestReturn.atMs).toISOString() } },
+    ...ranking.movedOff === void 0 ? {} : { movedOff: ranking.movedOff },
     ...sticky.problem === void 0 ? {} : { stickyProblem: sticky.problem }
   };
 }
@@ -65682,6 +65705,7 @@ async function runFrontDoorSupervisor(idleShutdownMinutes, ports, options = {})
   try {
     http8 = await ports.startProviderListener(lastPort);
   } catch (error62) {
+    ports.doorHealth.listenerFailed("provider", error62 instanceof Error ? error62.message : String(error62));
     return fail(`could not start the provider listener: ${error62 instanceof Error ? error62.message : String(error62)}`);
   }
   if (previousSticky !== void 0 && http8.port !== previousSticky) {
@@ -65694,6 +65718,7 @@ async function runFrontDoorSupervisor(idleShutdownMinutes, ports, options = {})
     connect3 = await ports.startConnectListener(lastConnectPort);
   } catch (error62) {
     await http8.close();
+    ports.doorHealth.listenerFailed("connect", error62 instanceof Error ? error62.message : String(error62));
     return fail(`could not start the CONNECT surface: ${error62 instanceof Error ? error62.message : String(error62)}`);
   }
   if (previousStickyConnect !== void 0 && connect3.port !== previousStickyConnect) {
@@ -65707,6 +65732,7 @@ async function runFrontDoorSupervisor(idleShutdownMinutes, ports, options = {})
   } catch (error62) {
     await connect3.close();
     await http8.close();
+    ports.doorHealth.listenerFailed("direct", error62 instanceof Error ? error62.message : String(error62));
     return fail(`could not start the direct listener: ${error62 instanceof Error ? error62.message : String(error62)}`);
   }
   if (previousStickyDirect !== void 0 && direct.port !== previousStickyDirect) {
@@ -65714,6 +65740,7 @@ async function runFrontDoorSupervisor(idleShutdownMinutes, ports, options = {})
   }
   lastDirectPort = direct.port;
   writeFrontDoorState(fs20, paths.frontdoorStateFile, { protocol: FRONT_DOOR_PROTOCOL, supervisorPid: ports.ownPid, port: http8.port, connectPort: connect3.port, directPort: direct.port, ...sticky() });
+  ports.doorHealth.generation({ providerPort: http8.port, connectPort: connect3.port, directPort: direct.port });
   fs20.removeRecursive(paths.frontdoorLockFile);
   ports.log(`agent-shim frontdoor supervisor ${String(ports.ownPid)}: front door on 127.0.0.1:${String(http8.port)}, CONNECT surface on 127.0.0.1:${String(connect3.port)}`);
   let idleSince;
@@ -65726,11 +65753,13 @@ async function runFrontDoorSupervisor(idleShutdownMinutes, ports, options = {})
     const listed = listFrontDoorSessions(fs20, paths.frontdoorSessionsDir);
     const pruned = pruneDeadFrontDoorSessions(fs20, paths.frontdoorSessionsDir, ports.isRunning);
     ports.observeLaunchRegistry(listed, pruned);
+    ports.checkQuotaExpiry();
     const prunedPids = new Set(pruned);
     if (listed.filter((session) => !prunedPids.has(session.pid)).length === 0) {
       idleSince ??= ports.now();
       if (ports.now() - idleSince >= idleShutdownMinutes * MS_PER_MINUTE2) {
         ports.log(`agent-shim frontdoor supervisor: no sessions for ${String(idleShutdownMinutes)} minute(s); closing the front door and exiting`);
+        ports.doorHealth.idleShutdown();
         await direct.close();
         await connect3.close();
         await http8.close();
@@ -69604,6 +69633,8 @@ var PoolPickReportSchema = external_exports.strictObject({
   missing: external_exports.array(external_exports.string()),
   /** When nothing can be picked, the soonest any member returns. */
   earliestReturn: external_exports.strictObject({ identity: external_exports.string(), at: external_exports.iso.datetime() }).optional(),
+  /** The member a resumed conversation started on but moved off, and why, when the ranking could not keep it. */
+  movedOff: external_exports.strictObject({ identity: external_exports.string(), reason: external_exports.string() }).optional(),
   /** Why the last-pick record could not be read, when that is the case. */
   stickyProblem: external_exports.string().optional()
 });
@@ -73910,6 +73941,9 @@ function frontDoorRcApiClient(port, ca, token) {
 // src/frontdoor/eventSchemas.ts
 var DOOR_EVENT_SOURCE_RC = "rc";
 var LAUNCH_EVENT_SOURCE = "launch";
+var USAGE_EVENT_SOURCE = "usage";
+var DOOR_HEALTH_EVENT_SOURCE = "door";
+var QUOTA_EXPIRING_EVENT_SOURCE = "quota-expiring";
 var DoorEventSchema = external_exports.strictObject({
   source: external_exports.string().min(1),
   /** A positive integer because the backbone's counters start at one and only ever increase. */
@@ -73925,6 +73959,20 @@ var LaunchLifecycleEventSchema = external_exports.strictObject({
   startedAt: external_exports.number(),
   observedAt: external_exports.number()
 });
+var DoorHealthEventSchema = external_exports.discriminatedUnion("kind", [
+  external_exports.strictObject({ kind: external_exports.literal("generation"), pid: external_exports.number().int().positive(), providerPort: external_exports.number().int().positive(), connectPort: external_exports.number().int().positive(), directPort: external_exports.number().int().positive(), observedAt: external_exports.number() }),
+  external_exports.strictObject({ kind: external_exports.literal("listenerFailed"), pid: external_exports.number().int().positive(), listener: external_exports.enum(["provider", "connect", "direct"]), message: external_exports.string(), observedAt: external_exports.number() }),
+  external_exports.strictObject({ kind: external_exports.literal("idleShutdown"), pid: external_exports.number().int().positive(), observedAt: external_exports.number() })
+]);
+var QuotaExpiringEventSchema = external_exports.strictObject({
+  identity: external_exports.string().min(1),
+  provider: external_exports.string().min(1),
+  window: external_exports.enum(["fiveHour", "sevenDay"]),
+  /** The fraction of the window already used when it was seen expiring, always below one because a fully used window has nothing left to spend. */
+  utilization: external_exports.number().min(0).max(1),
+  resetsAt: external_exports.iso.datetime(),
+  observedAt: external_exports.number()
+});
 
 // src/frontdoor/eventsApi.ts
 var EVENTS_API_TAG = "events";
@@ -74035,6 +74083,22 @@ function createDoorApiNodeHandler(deps) {
   return doorApiNodeHandlerOf(createDoorApiRouter(deps), deps.expectedToken);
 }
 
+// src/frontdoor/doorHealthEvents.ts
+function createDoorHealthPublisher(hub, now, pid) {
+  const publisher = hub.publisher(DOOR_HEALTH_EVENT_SOURCE);
+  return {
+    generation: (ports) => {
+      publisher.publish({ kind: "generation", pid, providerPort: ports.providerPort, connectPort: ports.connectPort, directPort: ports.directPort, observedAt: now() });
+    },
+    listenerFailed: (listener, message) => {
+      publisher.publish({ kind: "listenerFailed", pid, listener, message, observedAt: now() });
+    },
+    idleShutdown: () => {
+      publisher.publish({ kind: "idleShutdown", pid, observedAt: now() });
+    }
+  };
+}
+
 // src/frontdoor/eventHub.ts
 var DOOR_EVENT_BUFFER_EVENTS = 100;
 function createDoorEventHub() {
@@ -74141,6 +74205,65 @@ function rcFanoutOnDoorHub(fanout, hub) {
   };
 }
 
+// src/frontdoor/quotaExpiringEvents.ts
+var MS_PER_HOUR2 = 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 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;
+function createQuotaExpiringPublisher(hub, deps) {
+  const publisher = hub.publisher(QUOTA_EXPIRING_EVENT_SOURCE);
+  const latest = /* @__PURE__ */ new Map();
+  for (const snapshot of deps.seed) {
+    latest.set(snapshot.identity, snapshot);
+  }
+  hub.subscribe([USAGE_EVENT_SOURCE], (event) => {
+    const snapshot = UsageSnapshotSchema.parse(event.payload);
+    latest.set(snapshot.identity, snapshot);
+  });
+  const announced = /* @__PURE__ */ new Set();
+  const windowsOf = (snapshot) => {
+    const views = [];
+    for (const provider of Object.keys(snapshot.providers).sort()) {
+      const unified = snapshot.providers[provider]?.rateLimit?.unified;
+      const fiveHour = unified?.fiveHour;
+      if (fiveHour?.utilization !== void 0 && fiveHour.resetsAt !== void 0) {
+        views.push({ provider, view: { window: "fiveHour", spanMs: FIVE_HOUR_WINDOW_MS2, utilization: fiveHour.utilization, resetsAtMs: Date.parse(fiveHour.resetsAt) } });
+      }
+      const sevenDay = unified?.sevenDay;
+      if (sevenDay?.utilization !== void 0 && sevenDay.resetsAt !== void 0) {
+        views.push({ provider, view: { window: "sevenDay", spanMs: SEVEN_DAY_WINDOW_MS2, utilization: sevenDay.utilization, resetsAtMs: Date.parse(sevenDay.resetsAt) } });
+      }
+    }
+    return views;
+  };
+  return {
+    check: () => {
+      const now = deps.now();
+      for (const identity of [...latest.keys()].sort()) {
+        const snapshot = latest.get(identity);
+        if (snapshot === void 0) {
+          continue;
+        }
+        for (const { provider, view } of windowsOf(snapshot)) {
+          if (view.utilization >= 1 || view.resetsAtMs <= now || view.resetsAtMs - now >= view.spanMs * QUOTA_EXPIRING_WINDOW_FRACTION) {
+            continue;
+          }
+          const key = `${identity}:${provider}:${view.window}:${String(view.resetsAtMs)}`;
+          if (announced.has(key)) {
+            continue;
+          }
+          announced.add(key);
+          publisher.publish({ identity, provider, window: view.window, utilization: view.utilization, resetsAt: new Date(view.resetsAtMs).toISOString(), observedAt: now });
+        }
+      }
+    }
+  };
+}
+
 // src/frontdoor/launchEvents.ts
 function createLaunchEventPublisher(hub, now) {
   const publisher = hub.publisher(LAUNCH_EVENT_SOURCE);
@@ -78277,7 +78400,7 @@ var OPENROUTER_HOST = "openrouter.ai";
 var OPENROUTER_KEY_URL = `https://${OPENROUTER_HOST}/api/v1/key`;
 var OPENROUTER_CREDITS_URL = `https://${OPENROUTER_HOST}/api/v1/credits`;
 var HTTP_FORBIDDEN = 403;
-var MS_PER_DAY2 = HOURS_PER_DAY3 * SECONDS_PER_HOUR * MS_PER_SECOND10;
+var MS_PER_DAY3 = HOURS_PER_DAY3 * SECONDS_PER_HOUR * MS_PER_SECOND10;
 var OpenRouterKeySchema = external_exports.object({
   data: external_exports.object({
     limit: external_exports.number().nonnegative().nullable(),
@@ -78309,7 +78432,7 @@ async function openRouterGet(url2, schema, apiKey, http8, signal) {
   return parsed.data;
 }
 function nextUtcMidnight(nowMs) {
-  return new Date((Math.floor(nowMs / MS_PER_DAY2) + 1) * MS_PER_DAY2).toISOString();
+  return new Date((Math.floor(nowMs / MS_PER_DAY3) + 1) * MS_PER_DAY3).toISOString();
 }
 var openRouterQuotaAdapter = {
   source: OPENROUTER_SOURCE,
@@ -78331,7 +78454,7 @@ var openRouterQuotaAdapter = {
       windows.push({ measures: "account-credits", period: "prepaid", utilization: used / total, limit: total, used, remaining: Math.max(total - used, 0) });
     }
     if (free !== void 0 && free.limit > 0) {
-      windows.push({ measures: "free-model-requests", periodMs: MS_PER_DAY2, utilization: free.used / free.limit, resetsAt: nextUtcMidnight(nowMs), limit: free.limit, used: free.used, remaining: Math.max(free.remaining, 0) });
+      windows.push({ measures: "free-model-requests", periodMs: MS_PER_DAY3, utilization: free.used / free.limit, resetsAt: nextUtcMidnight(nowMs), limit: free.limit, used: free.used, remaining: Math.max(free.remaining, 0) });
     }
     return ProviderQuotaSchema.parse({
       observedAt: new Date(nowMs).toISOString(),
@@ -78520,6 +78643,9 @@ function realFrontDoorSupervisorPorts(paths) {
   const rcCredentialStore = createRcCredentialStore(realFarmFs, paths.frontdoorRcCredentialsDir);
   const rcTracker = createRcSessionTracker({ now: () => Date.now(), idleMs: RC_IDLE_EXPIRY_MS, credentialStore: rcCredentialStore });
   const doorEvents = createDoorEventHub();
+  const usagePublisher = doorEvents.publisher(USAGE_EVENT_SOURCE);
+  const quotaExpiring = createQuotaExpiringPublisher(doorEvents, { seed: listUsageSnapshots(realFarmFs, paths.usageSnapshotsDir), now: () => Date.now() });
+  const doorHealth = createDoorHealthPublisher(doorEvents, () => Date.now(), process.pid);
   const rcLiveUsage = createRcLiveUsage({ now: () => Date.now(), hub: doorEvents });
   const rcFanout = rcFanoutOnDoorHub(createRcEventFanout(), doorEvents);
   const rcHub = createRcStreamHub({
@@ -78565,7 +78691,10 @@ function realFrontDoorSupervisorPorts(paths) {
     pid: process.pid,
     now: () => Date.now(),
     readAccount: createAccountReader(realFarmFs, paths.identitiesDir),
-    log
+    log,
+    publish: (snapshot) => {
+      usagePublisher.publish(snapshot);
+    }
   });
   const quotaRefresher = createRealQuotaRefresher({ paths, store: usageStore, log });
   const usageMiddleware = createUsageMiddleware({
@@ -78764,6 +78893,8 @@ function realFrontDoorSupervisorPorts(paths) {
     closeRcStreamHub: rcHub.close,
     // The launch lifecycle publisher over the same backbone the typed API serves: the tick's registry facts go in here, and the door's own register, prune and end moments come out as source-tagged events.
     observeLaunchRegistry: createLaunchEventPublisher(doorEvents, () => Date.now()).observe,
+    doorHealth,
+    checkQuotaExpiry: quotaExpiring.check,
     log: (line) => {
       appendLog(paths, line);
     }
@@ -80582,13 +80713,13 @@ function formatLimit(limit) {
   return `last limit: ${limit.kind} (${String(limit.status)}) at ${limit.observedAt}${limit.window === void 0 ? "" : ` on the ${limit.window} window`}${wait.length === 0 ? "" : `, ${wait.join(", ")}`}`;
 }
 var MONEY_DECIMALS = 2;
-var MS_PER_HOUR2 = 36e5;
+var MS_PER_HOUR3 = 36e5;
 var HOURS_PER_DAY4 = 24;
 function formatPeriod(window) {
   if (window.periodMs === void 0) {
     return window.period ?? "unknown period";
   }
-  const hours = window.periodMs / MS_PER_HOUR2;
+  const hours = window.periodMs / MS_PER_HOUR3;
   return hours >= HOURS_PER_DAY4 && Number.isInteger(hours / HOURS_PER_DAY4) ? `${String(hours / HOURS_PER_DAY4)}d` : `${String(hours)}h`;
 }
 function formatCount(value2) {
@@ -81080,10 +81211,11 @@ function resolvePoolLaunch(params) {
     if (graph.ranking.candidates.length === 0) {
       return { ok: false, message: `agent-shim: no member of pool "${poolName}" is an existing identity.` };
     }
-    const { pick: pick2, earliestReturn } = graph.ranking;
+    const { pick: pick2, earliestReturn, movedOff } = graph.ranking;
     if (pick2 !== void 0) {
       recordStickyPick(params.usageFs, params.paths.usagePicksFile, params.cwd, pick2.identity, nowMs);
-      return { ok: true, identity: pick2.identity, explanation: `pool ${poolName}: ${pick2.reasons.slice(0, REASONS_LOGGED).join("; ")}` };
+      const move = movedOff === void 0 ? "" : `moved off ${movedOff.identity} (${movedOff.reason}); `;
+      return { ok: true, identity: pick2.identity, explanation: `pool ${poolName}: ${move}${pick2.reasons.slice(0, REASONS_LOGGED).join("; ")}` };
     }
     if (earliestReturn === void 0) {
       return { ok: false, message: `agent-shim: no member of pool "${poolName}" can be picked.` };