@validate.qa/runner 1.0.71 → 1.0.72

package/dist/cli.js

@@ -11491,7 +11491,7 @@ var require_thread_stream = __commonJS({
     "use strict";
     var { version } = require_package();
     var { EventEmitter: EventEmitter2 } = require("events");
-    var { Worker } = require("worker_threads");
+    var { Worker: Worker2 } = require("worker_threads");
     var { join: join8 } = require("path");
     var { pathToFileURL } = require("url");
     var { wait } = require_wait();
@@ -11544,7 +11544,7 @@ var require_thread_stream = __commonJS({
       const { filename, workerData } = opts;
       const bundlerOverrides = "__bundlerPathsOverrides" in globalThis ? globalThis.__bundlerPathsOverrides : {};
       const toExecute = bundlerOverrides["thread-stream-worker"] || join8(__dirname, "lib", "worker.js");
-      const worker = new Worker(toExecute, {
+      const worker = new Worker2(toExecute, {
         ...opts.workerOpts,
         name: opts.workerOpts?.name || "thread-stream",
         trackUnmanagedFds: false,
@@ -74644,6 +74644,7 @@ var require_mobile_explorer = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.computeMobileSurveyBreadthContinuation = computeMobileSurveyBreadthContinuation;
     exports2.computeMobileBreadthFinishRedirectDecision = computeMobileBreadthFinishRedirectDecision;
+    exports2.hybridScreenFingerprint = hybridScreenFingerprint;
     exports2.runMobileExplorePhase = runMobileExplorePhase;
     var crypto_1 = require("crypto");
     var shared_1 = (init_dist(), __toCommonJS(dist_exports));
@@ -75097,11 +75098,12 @@ var require_mobile_explorer = __commonJS({
       const validSurfaceDigest = /^[0-9a-f]{16,64}$/.test(normalizedSurfaceDigest) ? normalizedSurfaceDigest : void 0;
       const legacyElementDigests = [...new Set(elements.map((element) => element.pageIdentityDigest?.trim().toLowerCase() ?? "").filter((digest) => /^[0-9a-f]{16,64}$/.test(digest)))];
       const pageIdentityDigest = validSurfaceDigest ?? (legacyElementDigests.length === 1 ? legacyElementDigests[0] : void 0);
+      const hasStableControlIdentity = elements.some((element) => Boolean(safeHybridIdentity(element.id, credentials) || safeHybridIdentity(element.name, credentials)));
       const descriptors = elements.map((element) => {
         const editable = element.editable === true || /^(?:input|textarea|select)$/i.test(element.tag) || /(?:textbox|searchbox|combobox)/i.test(element.role);
         const id = safeHybridIdentity(element.id, credentials)?.toLowerCase() ?? "";
         const name = safeHybridIdentity(element.name, credentials)?.toLowerCase() ?? "";
-        const semanticText = editable || id || name ? "" : stableHybridSemanticText(element.text, credentials);
+        const semanticText = editable || id || name || hasStableControlIdentity ? "" : stableHybridSemanticText(element.text, credentials);
         return [
           element.tag.trim().toLowerCase(),
           element.role.trim().toLowerCase(),
@@ -83740,6 +83742,14 @@ ${statePacket}`, redactionCredentials) },
       return actions.filter((_, index) => !toDrop.has(index));
     }
     var MAX_DETOUR_LENGTH = 6;
+    function isDetourClosingAction(action) {
+      if (action.type === "BACK" || action.type === "HOME")
+        return true;
+      return isNavigationChromeTap(action);
+    }
+    function isEvidenceAction(action) {
+      return action.type === "ASSERT_VISIBLE" || action.type === "ASSERT_TEXT" || action.type === "WAIT_FOR_ELEMENT";
+    }
     function elideNoOpDetours(actions) {
       if (actions.length < 2)
         return actions;
@@ -83747,12 +83757,16 @@ ${statePacket}`, redactionCredentials) },
       for (let j = 0; j < actions.length; j++) {
         if (toDrop.has(j))
           continue;
-        if (actions[j].type !== "BACK" && actions[j].type !== "HOME")
+        if (!isDetourClosingAction(actions[j]))
           continue;
         const keyAfter = actions[j].metadata.structuralKey;
         if (!keyAfter)
           continue;
+        const next = actions[j + 1];
+        if (next && isEvidenceAction(next))
+          continue;
         let bestStart = null;
+        let leftScreen = false;
         const earliestStart = Math.max(0, j - MAX_DETOUR_LENGTH + 1);
         for (let i = j; i >= earliestStart; i--) {
           if (i < j) {
@@ -83760,11 +83774,14 @@ ${statePacket}`, redactionCredentials) },
             if (inside.type === "ASSERT_VISIBLE" || inside.type === "ASSERT_TEXT" || isDurableMutation(inside)) {
               break;
             }
+            const insideKey = inside.metadata.structuralKey;
+            if (insideKey && insideKey !== keyAfter)
+              leftScreen = true;
           }
           if (i === 0)
             continue;
           const keyBefore = actions[i - 1].metadata.structuralKey;
-          if (i < j && keyBefore && keyBefore === keyAfter) {
+          if (i < j && leftScreen && keyBefore && keyBefore === keyAfter) {
             bestStart = i;
           }
         }
@@ -352990,7 +353007,7 @@ var require_package4 = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.71",
+      version: "1.0.72",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -354802,7 +354819,11 @@ async function pressHome(sessionPath, platform3) {
 }
 
 // src/services/device-quarantine.ts
-var quarantinedDevices = /* @__PURE__ */ new Set();
+var QUARANTINE_MAX_MS = (() => {
+  const raw = Number(process.env.VALIDATEQA_DEVICE_QUARANTINE_MAX_MS);
+  return Number.isFinite(raw) && raw > 0 ? raw : 10 * 60 * 1e3;
+})();
+var quarantinedAt = /* @__PURE__ */ new Map();
 var DeviceQuarantinedError = class extends Error {
   constructor(deviceId) {
     super(
@@ -354811,17 +354832,27 @@ var DeviceQuarantinedError = class extends Error {
     this.name = "DeviceQuarantinedError";
   }
 };
-function quarantineDevice(deviceId) {
-  quarantinedDevices.add(deviceId);
+function quarantineDevice(deviceId, now = Date.now()) {
+  quarantinedAt.set(deviceId, now);
 }
 function unquarantineDevice(deviceId) {
-  quarantinedDevices.delete(deviceId);
+  quarantinedAt.delete(deviceId);
 }
-function isDeviceQuarantined(deviceId) {
-  return typeof deviceId === "string" && quarantinedDevices.has(deviceId);
+function isDeviceQuarantined(deviceId, now = Date.now()) {
+  if (typeof deviceId !== "string") return false;
+  const since = quarantinedAt.get(deviceId);
+  if (since === void 0) return false;
+  if (now - since >= QUARANTINE_MAX_MS) {
+    quarantinedAt.delete(deviceId);
+    console.warn(
+      `[device-quarantine] Quarantine on ${deviceId} exceeded its ${Math.round(QUARANTINE_MAX_MS / 6e4)}min ceiling without the original run settling \u2014 lifting it so the device is usable again. If this recurs, the zombie run is wedged in non-device work (check the runner log).`
+    );
+    return false;
+  }
+  return true;
 }
-function assertDeviceNotQuarantined(deviceId) {
-  if (isDeviceQuarantined(deviceId)) {
+function assertDeviceNotQuarantined(deviceId, now = Date.now()) {
+  if (isDeviceQuarantined(deviceId, now)) {
     throw new DeviceQuarantinedError(deviceId);
   }
 }
@@ -358158,6 +358189,86 @@ function validateRunnerMobileTarget(value) {
   };
 }
 
+// src/services/heartbeat-keepalive.ts
+var import_node_worker_threads = require("worker_threads");
+var KEEPALIVE_INTERVAL_MS = (() => {
+  const raw = Number(process.env.VALIDATEQA_HEARTBEAT_KEEPALIVE_MS);
+  return Number.isFinite(raw) && raw > 0 ? raw : 2e4;
+})();
+function isHeartbeatKeepaliveEnabled(env = process.env) {
+  return (env.VALIDATEQA_HEARTBEAT_KEEPALIVE ?? "").trim().toLowerCase() !== "off";
+}
+var WORKER_SOURCE = `
+const { parentPort } = require('node:worker_threads');
+let url = null;
+let headers = null;
+let body = null;
+let intervalMs = 20000;
+let timer = null;
+
+async function post() {
+  if (!url || !headers || !body) return; // inert until the first real heartbeat
+  try {
+    await fetch(url, {
+      method: 'POST',
+      headers,
+      body,
+      signal: AbortSignal.timeout(10000),
+    });
+  } catch {
+    // Best-effort by design: the next tick retries; the main loop's own
+    // heartbeat error handling owns logging/upgrade signals.
+  }
+}
+
+parentPort.on('message', (msg) => {
+  if (!msg || typeof msg !== 'object') return;
+  if (msg.type === 'update') {
+    url = msg.url;
+    headers = msg.headers;
+    body = msg.body;
+    intervalMs = msg.intervalMs || intervalMs;
+    if (!timer) {
+      timer = setInterval(post, intervalMs);
+      if (timer.unref) timer.unref();
+    }
+  } else if (msg.type === 'stop') {
+    if (timer) clearInterval(timer);
+    timer = null;
+    parentPort.close();
+  }
+});
+`;
+var NOOP_KEEPALIVE = { update: () => {
+}, stop: () => {
+} };
+function startHeartbeatKeepalive(options = {}) {
+  if (!isHeartbeatKeepaliveEnabled(options.env)) return NOOP_KEEPALIVE;
+  const intervalMs = options.intervalMs ?? KEEPALIVE_INTERVAL_MS;
+  let worker;
+  try {
+    worker = new import_node_worker_threads.Worker(WORKER_SOURCE, { eval: true });
+    worker.unref();
+    worker.on("error", () => {
+      worker = null;
+    });
+  } catch {
+    return NOOP_KEEPALIVE;
+  }
+  return {
+    update(url, headers, body) {
+      worker?.postMessage({ type: "update", url, headers, body, intervalMs });
+    },
+    stop() {
+      try {
+        worker?.postMessage({ type: "stop" });
+      } catch {
+      }
+      worker = null;
+    }
+  };
+}
+
 // src/mobile-device-queue.ts
 function isNativeMobileDiscoveryContext(ctx) {
   if (!ctx) return false;
@@ -363762,6 +363873,7 @@ async function startRunner(opts) {
       }
     }
   };
+  const heartbeatKeepalive = startHeartbeatKeepalive();
   const sendHeartbeat = async () => {
     try {
       const devices = enableMobile ? getCachedDeviceSnapshot() : [];
@@ -363776,41 +363888,44 @@ async function startRunner(opts) {
       lastInventoryPids = new Set(processInventory.processes.map((p) => p.pid));
       lastInventoryKinds.clear();
       for (const p of processInventory.processes) lastInventoryKinds.set(p.pid, p.kind);
-      const response = await fetch(`${serverUrl}/api/runner/heartbeat`, {
+      const heartbeatUrl = `${serverUrl}/api/runner/heartbeat`;
+      const heartbeatBody = JSON.stringify({
+        runnerName: RUNNER_NAME,
+        runnerVersion: RUNNER_VERSION,
+        runnerBuildId: RUNNER_BUILD_ID,
+        runsCompleted,
+        activeRuns,
+        maxConcurrent: MAX_CONCURRENT,
+        uptimeMs: Date.now() - startedAt,
+        capabilities,
+        devices,
+        mobileBridge: bridge ? {
+          online: bridge.running,
+          port: bridge.port,
+          tunnelUrl: bridge.tunnelUrl,
+          tunnelToken: bridge.tunnelToken
+        } : void 0,
+        activeByType: Object.fromEntries(activeByType),
+        activeByProject: Object.fromEntries(activeByProject),
+        typeLimits: TYPE_LIMITS,
+        maxProjectConcurrent: MAX_PROJECT_CONCURRENT,
+        resourceSnapshot: resourceStatus.snapshot,
+        resourceGovernor: resourceStatus.governor,
+        processInventory,
+        aiQueue: (0, import_runner_core13.getRunnerAIQueueStats)(),
+        liveBrowsers: import_runner_core11.liveBrowserRegistry.snapshotForHeartbeat(),
+        // Pre-flight checks (ANDROID_HOME, Xcode, Appium drivers, adb, etc).
+        // Cached & cheap — see getCachedDoctor above.
+        doctor: getCachedDoctor()
+      });
+      const response = await fetch(heartbeatUrl, {
         method: "POST",
         headers,
-        body: JSON.stringify({
-          runnerName: RUNNER_NAME,
-          runnerVersion: RUNNER_VERSION,
-          runnerBuildId: RUNNER_BUILD_ID,
-          runsCompleted,
-          activeRuns,
-          maxConcurrent: MAX_CONCURRENT,
-          uptimeMs: Date.now() - startedAt,
-          capabilities,
-          devices,
-          mobileBridge: bridge ? {
-            online: bridge.running,
-            port: bridge.port,
-            tunnelUrl: bridge.tunnelUrl,
-            tunnelToken: bridge.tunnelToken
-          } : void 0,
-          activeByType: Object.fromEntries(activeByType),
-          activeByProject: Object.fromEntries(activeByProject),
-          typeLimits: TYPE_LIMITS,
-          maxProjectConcurrent: MAX_PROJECT_CONCURRENT,
-          resourceSnapshot: resourceStatus.snapshot,
-          resourceGovernor: resourceStatus.governor,
-          processInventory,
-          aiQueue: (0, import_runner_core13.getRunnerAIQueueStats)(),
-          liveBrowsers: import_runner_core11.liveBrowserRegistry.snapshotForHeartbeat(),
-          // Pre-flight checks (ANDROID_HOME, Xcode, Appium drivers, adb, etc).
-          // Cached & cheap — see getCachedDoctor above.
-          doctor: getCachedDoctor()
-        }),
+        body: heartbeatBody,
         signal: AbortSignal.timeout(1e4)
       });
       if (response.ok) {
+        heartbeatKeepalive.update(heartbeatUrl, headers, heartbeatBody);
         const body = await response.json().catch(() => null);
         if (body && Array.isArray(body.commands) && body.commands.length > 0) {
           void handleControlCommands(body.commands);
@@ -363881,6 +363996,7 @@ async function startRunner(opts) {
       process.exit(1);
     }, SHUTDOWN_TIMEOUT_MS).unref();
     clearInterval(heartbeat);
+    heartbeatKeepalive.stop();
     if (liveBrowserHeartbeatTimer) {
       clearTimeout(liveBrowserHeartbeatTimer);
       liveBrowserHeartbeatTimer = null;

package/dist/cli.mjs

@@ -11496,7 +11496,7 @@ var require_thread_stream = __commonJS({
     "use strict";
     var { version } = require_package();
     var { EventEmitter: EventEmitter2 } = __require("events");
-    var { Worker } = __require("worker_threads");
+    var { Worker: Worker2 } = __require("worker_threads");
     var { join: join8 } = __require("path");
     var { pathToFileURL } = __require("url");
     var { wait } = require_wait();
@@ -11549,7 +11549,7 @@ var require_thread_stream = __commonJS({
       const { filename, workerData } = opts;
       const bundlerOverrides = "__bundlerPathsOverrides" in globalThis ? globalThis.__bundlerPathsOverrides : {};
       const toExecute = bundlerOverrides["thread-stream-worker"] || join8(__dirname, "lib", "worker.js");
-      const worker = new Worker(toExecute, {
+      const worker = new Worker2(toExecute, {
         ...opts.workerOpts,
         name: opts.workerOpts?.name || "thread-stream",
         trackUnmanagedFds: false,
@@ -74649,6 +74649,7 @@ var require_mobile_explorer = __commonJS({
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.computeMobileSurveyBreadthContinuation = computeMobileSurveyBreadthContinuation;
     exports.computeMobileBreadthFinishRedirectDecision = computeMobileBreadthFinishRedirectDecision;
+    exports.hybridScreenFingerprint = hybridScreenFingerprint;
     exports.runMobileExplorePhase = runMobileExplorePhase;
     var crypto_1 = __require("crypto");
     var shared_1 = (init_dist(), __toCommonJS(dist_exports));
@@ -75102,11 +75103,12 @@ var require_mobile_explorer = __commonJS({
       const validSurfaceDigest = /^[0-9a-f]{16,64}$/.test(normalizedSurfaceDigest) ? normalizedSurfaceDigest : void 0;
       const legacyElementDigests = [...new Set(elements.map((element) => element.pageIdentityDigest?.trim().toLowerCase() ?? "").filter((digest) => /^[0-9a-f]{16,64}$/.test(digest)))];
       const pageIdentityDigest = validSurfaceDigest ?? (legacyElementDigests.length === 1 ? legacyElementDigests[0] : void 0);
+      const hasStableControlIdentity = elements.some((element) => Boolean(safeHybridIdentity(element.id, credentials) || safeHybridIdentity(element.name, credentials)));
       const descriptors = elements.map((element) => {
         const editable = element.editable === true || /^(?:input|textarea|select)$/i.test(element.tag) || /(?:textbox|searchbox|combobox)/i.test(element.role);
         const id = safeHybridIdentity(element.id, credentials)?.toLowerCase() ?? "";
         const name = safeHybridIdentity(element.name, credentials)?.toLowerCase() ?? "";
-        const semanticText = editable || id || name ? "" : stableHybridSemanticText(element.text, credentials);
+        const semanticText = editable || id || name || hasStableControlIdentity ? "" : stableHybridSemanticText(element.text, credentials);
         return [
           element.tag.trim().toLowerCase(),
           element.role.trim().toLowerCase(),
@@ -83745,6 +83747,14 @@ ${statePacket}`, redactionCredentials) },
       return actions.filter((_, index) => !toDrop.has(index));
     }
     var MAX_DETOUR_LENGTH = 6;
+    function isDetourClosingAction(action) {
+      if (action.type === "BACK" || action.type === "HOME")
+        return true;
+      return isNavigationChromeTap(action);
+    }
+    function isEvidenceAction(action) {
+      return action.type === "ASSERT_VISIBLE" || action.type === "ASSERT_TEXT" || action.type === "WAIT_FOR_ELEMENT";
+    }
     function elideNoOpDetours(actions) {
       if (actions.length < 2)
         return actions;
@@ -83752,12 +83762,16 @@ ${statePacket}`, redactionCredentials) },
       for (let j = 0; j < actions.length; j++) {
         if (toDrop.has(j))
           continue;
-        if (actions[j].type !== "BACK" && actions[j].type !== "HOME")
+        if (!isDetourClosingAction(actions[j]))
           continue;
         const keyAfter = actions[j].metadata.structuralKey;
         if (!keyAfter)
           continue;
+        const next = actions[j + 1];
+        if (next && isEvidenceAction(next))
+          continue;
         let bestStart = null;
+        let leftScreen = false;
         const earliestStart = Math.max(0, j - MAX_DETOUR_LENGTH + 1);
         for (let i = j; i >= earliestStart; i--) {
           if (i < j) {
@@ -83765,11 +83779,14 @@ ${statePacket}`, redactionCredentials) },
             if (inside.type === "ASSERT_VISIBLE" || inside.type === "ASSERT_TEXT" || isDurableMutation(inside)) {
               break;
             }
+            const insideKey = inside.metadata.structuralKey;
+            if (insideKey && insideKey !== keyAfter)
+              leftScreen = true;
           }
           if (i === 0)
             continue;
           const keyBefore = actions[i - 1].metadata.structuralKey;
-          if (i < j && keyBefore && keyBefore === keyAfter) {
+          if (i < j && leftScreen && keyBefore && keyBefore === keyAfter) {
             bestStart = i;
           }
         }
@@ -352995,7 +353012,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.71",
+      version: "1.0.72",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -354807,7 +354824,11 @@ async function pressHome(sessionPath, platform3) {
 }
 
 // src/services/device-quarantine.ts
-var quarantinedDevices = /* @__PURE__ */ new Set();
+var QUARANTINE_MAX_MS = (() => {
+  const raw = Number(process.env.VALIDATEQA_DEVICE_QUARANTINE_MAX_MS);
+  return Number.isFinite(raw) && raw > 0 ? raw : 10 * 60 * 1e3;
+})();
+var quarantinedAt = /* @__PURE__ */ new Map();
 var DeviceQuarantinedError = class extends Error {
   constructor(deviceId) {
     super(
@@ -354816,17 +354837,27 @@ var DeviceQuarantinedError = class extends Error {
     this.name = "DeviceQuarantinedError";
   }
 };
-function quarantineDevice(deviceId) {
-  quarantinedDevices.add(deviceId);
+function quarantineDevice(deviceId, now = Date.now()) {
+  quarantinedAt.set(deviceId, now);
 }
 function unquarantineDevice(deviceId) {
-  quarantinedDevices.delete(deviceId);
+  quarantinedAt.delete(deviceId);
 }
-function isDeviceQuarantined(deviceId) {
-  return typeof deviceId === "string" && quarantinedDevices.has(deviceId);
+function isDeviceQuarantined(deviceId, now = Date.now()) {
+  if (typeof deviceId !== "string") return false;
+  const since = quarantinedAt.get(deviceId);
+  if (since === void 0) return false;
+  if (now - since >= QUARANTINE_MAX_MS) {
+    quarantinedAt.delete(deviceId);
+    console.warn(
+      `[device-quarantine] Quarantine on ${deviceId} exceeded its ${Math.round(QUARANTINE_MAX_MS / 6e4)}min ceiling without the original run settling \u2014 lifting it so the device is usable again. If this recurs, the zombie run is wedged in non-device work (check the runner log).`
+    );
+    return false;
+  }
+  return true;
 }
-function assertDeviceNotQuarantined(deviceId) {
-  if (isDeviceQuarantined(deviceId)) {
+function assertDeviceNotQuarantined(deviceId, now = Date.now()) {
+  if (isDeviceQuarantined(deviceId, now)) {
     throw new DeviceQuarantinedError(deviceId);
   }
 }
@@ -358166,6 +358197,86 @@ function validateRunnerMobileTarget(value) {
   };
 }
 
+// src/services/heartbeat-keepalive.ts
+import { Worker } from "worker_threads";
+var KEEPALIVE_INTERVAL_MS = (() => {
+  const raw = Number(process.env.VALIDATEQA_HEARTBEAT_KEEPALIVE_MS);
+  return Number.isFinite(raw) && raw > 0 ? raw : 2e4;
+})();
+function isHeartbeatKeepaliveEnabled(env = process.env) {
+  return (env.VALIDATEQA_HEARTBEAT_KEEPALIVE ?? "").trim().toLowerCase() !== "off";
+}
+var WORKER_SOURCE = `
+const { parentPort } = require('node:worker_threads');
+let url = null;
+let headers = null;
+let body = null;
+let intervalMs = 20000;
+let timer = null;
+
+async function post() {
+  if (!url || !headers || !body) return; // inert until the first real heartbeat
+  try {
+    await fetch(url, {
+      method: 'POST',
+      headers,
+      body,
+      signal: AbortSignal.timeout(10000),
+    });
+  } catch {
+    // Best-effort by design: the next tick retries; the main loop's own
+    // heartbeat error handling owns logging/upgrade signals.
+  }
+}
+
+parentPort.on('message', (msg) => {
+  if (!msg || typeof msg !== 'object') return;
+  if (msg.type === 'update') {
+    url = msg.url;
+    headers = msg.headers;
+    body = msg.body;
+    intervalMs = msg.intervalMs || intervalMs;
+    if (!timer) {
+      timer = setInterval(post, intervalMs);
+      if (timer.unref) timer.unref();
+    }
+  } else if (msg.type === 'stop') {
+    if (timer) clearInterval(timer);
+    timer = null;
+    parentPort.close();
+  }
+});
+`;
+var NOOP_KEEPALIVE = { update: () => {
+}, stop: () => {
+} };
+function startHeartbeatKeepalive(options = {}) {
+  if (!isHeartbeatKeepaliveEnabled(options.env)) return NOOP_KEEPALIVE;
+  const intervalMs = options.intervalMs ?? KEEPALIVE_INTERVAL_MS;
+  let worker;
+  try {
+    worker = new Worker(WORKER_SOURCE, { eval: true });
+    worker.unref();
+    worker.on("error", () => {
+      worker = null;
+    });
+  } catch {
+    return NOOP_KEEPALIVE;
+  }
+  return {
+    update(url, headers, body) {
+      worker?.postMessage({ type: "update", url, headers, body, intervalMs });
+    },
+    stop() {
+      try {
+        worker?.postMessage({ type: "stop" });
+      } catch {
+      }
+      worker = null;
+    }
+  };
+}
+
 // src/mobile-device-queue.ts
 function isNativeMobileDiscoveryContext(ctx) {
   if (!ctx) return false;
@@ -363770,6 +363881,7 @@ async function startRunner(opts) {
       }
     }
   };
+  const heartbeatKeepalive = startHeartbeatKeepalive();
   const sendHeartbeat = async () => {
     try {
       const devices = enableMobile ? getCachedDeviceSnapshot() : [];
@@ -363784,41 +363896,44 @@ async function startRunner(opts) {
       lastInventoryPids = new Set(processInventory.processes.map((p) => p.pid));
       lastInventoryKinds.clear();
       for (const p of processInventory.processes) lastInventoryKinds.set(p.pid, p.kind);
-      const response = await fetch(`${serverUrl}/api/runner/heartbeat`, {
+      const heartbeatUrl = `${serverUrl}/api/runner/heartbeat`;
+      const heartbeatBody = JSON.stringify({
+        runnerName: RUNNER_NAME,
+        runnerVersion: RUNNER_VERSION,
+        runnerBuildId: RUNNER_BUILD_ID,
+        runsCompleted,
+        activeRuns,
+        maxConcurrent: MAX_CONCURRENT,
+        uptimeMs: Date.now() - startedAt,
+        capabilities,
+        devices,
+        mobileBridge: bridge ? {
+          online: bridge.running,
+          port: bridge.port,
+          tunnelUrl: bridge.tunnelUrl,
+          tunnelToken: bridge.tunnelToken
+        } : void 0,
+        activeByType: Object.fromEntries(activeByType),
+        activeByProject: Object.fromEntries(activeByProject),
+        typeLimits: TYPE_LIMITS,
+        maxProjectConcurrent: MAX_PROJECT_CONCURRENT,
+        resourceSnapshot: resourceStatus.snapshot,
+        resourceGovernor: resourceStatus.governor,
+        processInventory,
+        aiQueue: (0, import_runner_core13.getRunnerAIQueueStats)(),
+        liveBrowsers: import_runner_core11.liveBrowserRegistry.snapshotForHeartbeat(),
+        // Pre-flight checks (ANDROID_HOME, Xcode, Appium drivers, adb, etc).
+        // Cached & cheap — see getCachedDoctor above.
+        doctor: getCachedDoctor()
+      });
+      const response = await fetch(heartbeatUrl, {
         method: "POST",
         headers,
-        body: JSON.stringify({
-          runnerName: RUNNER_NAME,
-          runnerVersion: RUNNER_VERSION,
-          runnerBuildId: RUNNER_BUILD_ID,
-          runsCompleted,
-          activeRuns,
-          maxConcurrent: MAX_CONCURRENT,
-          uptimeMs: Date.now() - startedAt,
-          capabilities,
-          devices,
-          mobileBridge: bridge ? {
-            online: bridge.running,
-            port: bridge.port,
-            tunnelUrl: bridge.tunnelUrl,
-            tunnelToken: bridge.tunnelToken
-          } : void 0,
-          activeByType: Object.fromEntries(activeByType),
-          activeByProject: Object.fromEntries(activeByProject),
-          typeLimits: TYPE_LIMITS,
-          maxProjectConcurrent: MAX_PROJECT_CONCURRENT,
-          resourceSnapshot: resourceStatus.snapshot,
-          resourceGovernor: resourceStatus.governor,
-          processInventory,
-          aiQueue: (0, import_runner_core13.getRunnerAIQueueStats)(),
-          liveBrowsers: import_runner_core11.liveBrowserRegistry.snapshotForHeartbeat(),
-          // Pre-flight checks (ANDROID_HOME, Xcode, Appium drivers, adb, etc).
-          // Cached & cheap — see getCachedDoctor above.
-          doctor: getCachedDoctor()
-        }),
+        body: heartbeatBody,
         signal: AbortSignal.timeout(1e4)
       });
       if (response.ok) {
+        heartbeatKeepalive.update(heartbeatUrl, headers, heartbeatBody);
         const body = await response.json().catch(() => null);
         if (body && Array.isArray(body.commands) && body.commands.length > 0) {
           void handleControlCommands(body.commands);
@@ -363889,6 +364004,7 @@ async function startRunner(opts) {
       process.exit(1);
     }, SHUTDOWN_TIMEOUT_MS).unref();
     clearInterval(heartbeat);
+    heartbeatKeepalive.stop();
     if (liveBrowserHeartbeatTimer) {
       clearTimeout(liveBrowserHeartbeatTimer);
       liveBrowserHeartbeatTimer = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@validate.qa/runner",
-  "version": "1.0.71",
+  "version": "1.0.72",
   "description": "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
   "bin": {
     "validate-runner": "dist/cli.js"