@algosuite/vo-mcp 0.2.0-beta.37 → 0.2.0-beta.39

package/dist/runner-supervisor.js

@@ -176,6 +176,38 @@ async function mergeVerifiedPrRequest(req, prNumber, automationContext, onUnauth
   };
 }
 
+// ../../scripts/virtual-office/code-runner/claim-gate-notice.mjs
+var REASON_HELP = {
+  daemon_version_below_floor: "this daemon is older than the approved release target \u2014 it idles until the governed updater brings it current (operator override: VO_RUNNER_CLAIM_MIN_DAEMON_VERSION / VO_RUNNER_CLAIM_VERSION_GATE=off on the control plane)",
+  daemon_version_unreported: "this daemon reports no parseable version in its heartbeat \u2014 too old for the updater to manage, so it may not claim work",
+  no_fresh_heartbeat: "the control plane has no fresh heartbeat from this runner \u2014 claims resume once heartbeats land",
+  runner_denylisted: "this runner id is on the operator quarantine list (VO_RUNNER_CLAIM_DENYLIST)"
+};
+function describeClaimGate(gate) {
+  if (!gate || gate.allowed !== false) return null;
+  const reason = String(gate.reason || "denied");
+  const floor = gate.floor_version ? ` (floor ${gate.floor_version})` : "";
+  return `claim gate: DENIED \u2014 ${reason}${floor}: ${(Object.hasOwn(REASON_HELP, reason) ? REASON_HELP[reason] : null) ?? "the control plane refused this runner's claims"}`;
+}
+function makeClaimGateNotice({ log = () => {
+} } = {}) {
+  let last = null;
+  let current = null;
+  return {
+    current: () => current,
+    observe(json) {
+      const gate = json && typeof json === "object" ? json.claim_gate : null;
+      const denied = gate && gate.allowed === false ? gate : null;
+      current = denied ? { ...denied, observed_at: (/* @__PURE__ */ new Date()).toISOString() } : null;
+      const signature = denied ? `${denied.reason}|${denied.floor_version ?? ""}` : null;
+      if (signature === last) return;
+      if (denied) log(describeClaimGate(denied));
+      else if (last !== null) log("claim gate: allowed again \u2014 this runner may claim work");
+      last = signature;
+    }
+  };
+}
+
 // ../../scripts/virtual-office/code-runner/control-plane-client.mjs
 var cachedFirebaseToken = null;
 var ClaimAuthorityChangedError = class extends Error {
@@ -244,7 +276,10 @@ function createControlPlaneClient({
     }
   }
   const taskReq = (method, path2, body, options = {}) => req(method, path2, body, { timeoutMs: taskRequestTimeoutMs, ...options });
+  const claimGate = makeClaimGateNotice({ log: (m) => console.warn(`[code-runner ${(/* @__PURE__ */ new Date()).toISOString()}] ${m}`) });
   return {
+    getClaimGate: () => claimGate.current(),
+    // last DENIED claim-gate verdict (null when allowed) — for /status + tests
     ...makeAutonomousDispatchAdmissionClient(
       req,
       taskRequestTimeoutMs,
@@ -279,6 +314,7 @@ function createControlPlaneClient({
       }
       if (!res.ok) throw new Error(`claim failed: HTTP ${res.status}`);
       const json = await res.json();
+      claimGate.observe(json);
       return json && json.task ? json.task : null;
     },
     /**