@validate.qa/runner 1.0.71 → 1.0.73

package/dist/cli.js

@@ -5854,6 +5854,29 @@ function normalizeTtsVoiceId(voiceId) {
     return null;
   return LEGACY_TTS_VOICE_ID_MAP[trimmed] ?? trimmed;
 }
+function normalizeTtsModel(model) {
+  if (!model)
+    return null;
+  const trimmed = model.trim();
+  if (!trimmed)
+    return null;
+  return LEGACY_TTS_MODEL_MAP[trimmed] ?? trimmed;
+}
+function ttsFallbackModel(primary) {
+  const normalized = normalizeTtsModel(primary);
+  if (!normalized)
+    return null;
+  return TTS_FALLBACK_MODEL_MAP[normalized] ?? null;
+}
+function resolveTtsModelChain(model) {
+  const normalized = normalizeTtsModel(model);
+  const primary = normalized && normalized in TTS_FALLBACK_MODEL_MAP ? normalized : DEFAULT_TTS_MODEL;
+  const chain = [primary];
+  const fallback = TTS_FALLBACK_MODEL_MAP[primary];
+  if (fallback && fallback !== primary)
+    chain.push(fallback);
+  return chain;
+}
 function sttModelsForProvider(provider) {
   if (provider === "openai") {
     return STT_MODEL_OPTIONS.filter((m) => m.provider === "openai");
@@ -5901,16 +5924,18 @@ function isValidTtsVoiceId(value) {
   return TTS_VOICE_OPTIONS.some((v) => v.id === normalized);
 }
 function isValidTtsModel(value) {
-  if (!value)
+  const normalized = normalizeTtsModel(value);
+  if (!normalized)
     return false;
-  return TTS_MODEL_OPTIONS.some((m) => m.id === value);
+  return TTS_MODEL_OPTIONS.some((m) => m.id === normalized);
 }
-var VOICE_PREVIEW_SAMPLE, DEFAULT_TTS_MODEL, DEFAULT_TTS_VOICE_ID, DEFAULT_TTS_SPEED, LEGACY_TTS_VOICE_ID_MAP, DEFAULT_STT_MODEL_BY_PROVIDER, STT_PROVIDER_OPTIONS, STT_MODEL_OPTIONS, TTS_MODEL_OPTIONS, TTS_VOICE_OPTIONS;
+var VOICE_PREVIEW_SAMPLE, DEFAULT_TTS_MODEL, DEFAULT_TTS_TURBO_MODEL, DEFAULT_TTS_VOICE_ID, DEFAULT_TTS_SPEED, LEGACY_TTS_VOICE_ID_MAP, LEGACY_TTS_MODEL_MAP, TTS_FALLBACK_MODEL_MAP, DEFAULT_STT_MODEL_BY_PROVIDER, STT_PROVIDER_OPTIONS, STT_MODEL_OPTIONS, TTS_MODEL_OPTIONS, TTS_VOICE_OPTIONS;
 var init_voice_config = __esm({
   "../shared/dist/voice-config.js"() {
     "use strict";
     VOICE_PREVIEW_SAMPLE = "Hello! I am your Validate Copilot assistant. I can help you run tests, review failures, and generate new coverage for your project.";
-    DEFAULT_TTS_MODEL = "speech-2.6-hd";
+    DEFAULT_TTS_MODEL = "speech-2.8-hd";
+    DEFAULT_TTS_TURBO_MODEL = "speech-2.8-turbo";
     DEFAULT_TTS_VOICE_ID = "English_Graceful_Lady";
     DEFAULT_TTS_SPEED = 1;
     LEGACY_TTS_VOICE_ID_MAP = {
@@ -5919,6 +5944,18 @@ var init_voice_config = __esm({
       English_Deep_Voice_Man: "English_ManWithDeepVoice",
       English_CasualMan: "English_Jovialman"
     };
+    LEGACY_TTS_MODEL_MAP = {
+      "speech-2.6-hd": "speech-2.8-hd",
+      "speech-2.6-turbo": "speech-2.8-turbo",
+      "speech-02-hd": "speech-2.8-hd",
+      "speech-02-turbo": "speech-2.8-turbo",
+      "speech-01-hd": "speech-2.8-hd",
+      "speech-01-turbo": "speech-2.8-turbo"
+    };
+    TTS_FALLBACK_MODEL_MAP = {
+      "speech-2.8-hd": "speech-2.6-hd",
+      "speech-2.8-turbo": "speech-2.6-turbo"
+    };
     DEFAULT_STT_MODEL_BY_PROVIDER = {
       groq: "whisper-large-v3-turbo",
       openai: "whisper-1"
@@ -5971,49 +6008,13 @@ var init_voice_config = __esm({
         id: "speech-2.8-hd",
         label: "Speech 2.8 HD",
         provider: "minimax",
-        description: "Latest high-definition model with interjection tags (recommended)."
+        description: "High-definition quality (default). Auto-falls back to Speech 2.6 HD."
       },
       {
         id: "speech-2.8-turbo",
         label: "Speech 2.8 Turbo",
         provider: "minimax",
-        description: "Latest low-latency model with interjection tags."
-      },
-      {
-        id: "speech-2.6-hd",
-        label: "Speech 2.6 HD",
-        provider: "minimax",
-        description: "High-definition MiniMax voice model."
-      },
-      {
-        id: "speech-2.6-turbo",
-        label: "Speech 2.6 Turbo",
-        provider: "minimax",
-        description: "Lower-latency Speech 2.6 variant."
-      },
-      {
-        id: "speech-02-hd",
-        label: "Speech 02 HD",
-        provider: "minimax",
-        description: "Previous-generation HD model."
-      },
-      {
-        id: "speech-02-turbo",
-        label: "Speech 02 Turbo",
-        provider: "minimax",
-        description: "Lower-latency Speech 02 variant."
-      },
-      {
-        id: "speech-01-hd",
-        label: "Speech 01 HD",
-        provider: "minimax",
-        description: "Legacy HD model."
-      },
-      {
-        id: "speech-01-turbo",
-        label: "Speech 01 Turbo",
-        provider: "minimax",
-        description: "Legacy fast model."
+        description: "Lower latency. Auto-falls back to Speech 2.6 Turbo."
       }
     ];
     TTS_VOICE_OPTIONS = [
@@ -6297,6 +6298,7 @@ __export(dist_exports, {
   DEFAULT_STT_MODEL_BY_PROVIDER: () => DEFAULT_STT_MODEL_BY_PROVIDER,
   DEFAULT_TTS_MODEL: () => DEFAULT_TTS_MODEL,
   DEFAULT_TTS_SPEED: () => DEFAULT_TTS_SPEED,
+  DEFAULT_TTS_TURBO_MODEL: () => DEFAULT_TTS_TURBO_MODEL,
   DEFAULT_TTS_VOICE_ID: () => DEFAULT_TTS_VOICE_ID,
   DEFAULT_UI_VARIANT: () => DEFAULT_UI_VARIANT,
   EMAIL_FROM_IDENTITIES: () => EMAIL_FROM_IDENTITIES,
@@ -6306,6 +6308,7 @@ __export(dist_exports, {
   FLOW_SERVER_TYPES: () => FLOW_SERVER_TYPES,
   GROUPABLE_CALL_TYPES: () => GROUPABLE_CALL_TYPES,
   GROUP_LABELS: () => GROUP_LABELS,
+  LEGACY_TTS_MODEL_MAP: () => LEGACY_TTS_MODEL_MAP,
   LEGACY_TTS_VOICE_ID_MAP: () => LEGACY_TTS_VOICE_ID_MAP,
   MAX_CREDIT_TOPUP_CENTS: () => MAX_CREDIT_TOPUP_CENTS,
   MAX_DEEPLINK_LENGTH: () => MAX_DEEPLINK_LENGTH,
@@ -6339,6 +6342,7 @@ __export(dist_exports, {
   TEST_USER_ENV_KEYS: () => TEST_USER_ENV_KEYS,
   TRANSIENT_CONTROL_ROLES: () => TRANSIENT_CONTROL_ROLES,
   TRIAL_DURATION_DAYS: () => TRIAL_DURATION_DAYS,
+  TTS_FALLBACK_MODEL_MAP: () => TTS_FALLBACK_MODEL_MAP,
   TTS_MODEL_OPTIONS: () => TTS_MODEL_OPTIONS,
   TTS_VOICE_OPTIONS: () => TTS_VOICE_OPTIONS,
   UI_VARIANTS: () => UI_VARIANTS,
@@ -6441,6 +6445,7 @@ __export(dist_exports, {
   mobilePlatformFromMedium: () => mobilePlatformFromMedium,
   mobileWanderTraceEnabled: () => mobileWanderTraceEnabled,
   normalizeControlName: () => normalizeControlName,
+  normalizeTtsModel: () => normalizeTtsModel,
   normalizeTtsVoiceId: () => normalizeTtsVoiceId,
   otherMobilePlatform: () => otherMobilePlatform,
   parenDepthDelta: () => parenDepthDelta,
@@ -6459,6 +6464,7 @@ __export(dist_exports, {
   resolveMobileStepValuePlaceholders: () => resolveMobileStepValuePlaceholders,
   resolvePlatformLocatorBundle: () => resolvePlatformLocatorBundle,
   resolveSttModelForProvider: () => resolveSttModelForProvider,
+  resolveTtsModelChain: () => resolveTtsModelChain,
   safeCurrentUrl: () => safeCurrentUrl,
   safeOrigin: () => safeOrigin,
   sanitizeSttErrorMessage: () => sanitizeSttErrorMessage,
@@ -6481,6 +6487,7 @@ __export(dist_exports, {
   summarizeMobileReadiness: () => summarizeMobileReadiness,
   summarizeRunHealth: () => summarizeRunHealth,
   toDbPricingPlan: () => toDbPricingPlan,
+  ttsFallbackModel: () => ttsFallbackModel,
   validateAssertionStrength: () => validateAssertionStrength
 });
 var init_dist = __esm({
@@ -11491,7 +11498,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 +11551,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 +74651,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 +75105,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 +83749,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 +83764,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 +83781,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 +353014,7 @@ var require_package4 = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.71",
+      version: "1.0.73",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -354654,6 +354678,27 @@ async function clickCssInCurrentContext(sessionPath, css) {
     body: "{}"
   });
 }
+async function clickByVisibleTextInCurrentContext(sessionPath, text) {
+  const script = `
+    var t = String(arguments[0]).trim().replace(/\\s+/g, ' ');
+    var sel = 'button, a, [role="tab"], [role="button"], [onclick], .stream-tab, .ux-interactive, input[type="submit"], input[type="button"]';
+    var norm = function (e) { return (e.textContent || e.value || '').trim().replace(/\\s+/g, ' '); };
+    var vis = function (e) { var r = e.getBoundingClientRect(); return r.width > 0 && r.height > 0; };
+    var all = Array.prototype.slice.call(document.querySelectorAll(sel));
+    var match = all.filter(function (e) { return norm(e) === t && vis(e); });
+    if (match.length !== 1) { return match.length; }
+    match[0].click();
+    return 1;
+  `;
+  const result = await appiumRequest(`${sessionPath}/execute/sync`, {
+    method: "POST",
+    body: JSON.stringify({ script, args: [text] })
+  });
+  const count = readValue(result);
+  if (count !== 1) {
+    throw new Error(`WEBVIEW text click found ${count === 0 || count === void 0 ? "no" : String(count)} actionable match(es) for "${text}"`);
+  }
+}
 async function typeCssInCurrentContext(sessionPath, css, text) {
   const elResult = await appiumRequest(`${sessionPath}/element`, {
     method: "POST",
@@ -354802,7 +354847,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 +354860,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);
   }
 }
@@ -356998,6 +357057,48 @@ function stepWebViewContext(step) {
   const meta = step.metadata && typeof step.metadata === "object" ? step.metadata : null;
   return typeof meta?.webviewContext === "string" && meta.webviewContext.trim() ? meta.webviewContext.trim() : null;
 }
+var DOM_ID_RE = /^[A-Za-z_][\w-]*$/;
+var SYSTEM_RESOURCE_ID_RE = /^(?:android|com\.android\.|com\.google\.android\.)/i;
+function webViewCssFallbackFromNativeStep(step) {
+  if (stepWebViewCss(step)) return null;
+  const target = step.target;
+  if (!target) return null;
+  const bundle = target.locatorBundle;
+  const resourceId = typeof bundle?.resourceId === "string" ? bundle.resourceId.trim() : "";
+  const accessibilityId = typeof bundle?.accessibilityId === "string" ? bundle.accessibilityId.trim() : "";
+  const primary = typeof target.primary === "string" ? target.primary.trim() : "";
+  const fromResourceId = (raw) => {
+    if (!raw) return null;
+    if (raw.includes(":id/")) {
+      if (SYSTEM_RESOURCE_ID_RE.test(raw)) return null;
+      const local = raw.slice(raw.indexOf(":id/") + 4);
+      return DOM_ID_RE.test(local) ? local : null;
+    }
+    return DOM_ID_RE.test(raw) ? raw : null;
+  };
+  const domId = fromResourceId(resourceId) ?? fromResourceId(accessibilityId) ?? (primary && !/[=~/[\].\s]/.test(primary) && DOM_ID_RE.test(primary) ? primary : null);
+  return domId ? `#${domId}` : null;
+}
+function webViewTextFallbackFromNativeStep(step) {
+  if (stepWebViewCss(step)) return null;
+  if (step.action !== "tap") return null;
+  const target = step.target;
+  if (!target) return null;
+  const bundle = target.locatorBundle;
+  const text = typeof bundle?.text === "string" && bundle.text.trim() ? bundle.text.trim() : typeof bundle?.contentDesc === "string" && bundle.contentDesc.trim() ? bundle.contentDesc.trim() : typeof target.primary === "string" && target.primary.trim() && !/[=~/[\]]|:id\//.test(target.primary) ? target.primary.trim() : "";
+  const normalized = text.replace(/\s+/g, " ");
+  if (!normalized || normalized.length > 40 || /[\n\r]/.test(text)) return null;
+  if (SYSTEM_PERMISSION_BUTTON_RE.test(text)) return null;
+  return normalized;
+}
+async function hasLiveWebViewContext(sessionId) {
+  try {
+    const contexts = await listAppContexts(`/session/${sessionId}`);
+    return contexts.some((c) => /^WEBVIEW/i.test(c));
+  } catch {
+    return false;
+  }
+}
 var CONTAINER_ONLY_ENTRY_ID_RE = /(?:^|[:/])id\/(webview|content|decor|decor_content_parent|action_bar_root|statusBarBackground|navigationBarBackground)$|^(?:main-content|root|app|app-root|__next|react-root|application)$/i;
 function isContainerOnlyEntryTarget(target) {
   const primary = target?.primary?.trim() ?? "";
@@ -357085,6 +357186,7 @@ function isWebViewHydrationTransient(err) {
   return /no such element|NoSuchElement|element not interactable|stale element|WEBVIEW step requires|Empty page dictionary|not connectable|no WEBVIEW context|chrome not reachable/i.test(message);
 }
 var WEBVIEW_HYDRATION_TIMEOUT_MS = Number(process.env.VALIDATEQA_WEBVIEW_HYDRATION_TIMEOUT_MS) || 3e4;
+var PERMISSION_DIALOG_TIMEOUT_MS = Number(process.env.VALIDATEQA_PERMISSION_DIALOG_TIMEOUT_MS) || 3e3;
 async function executeInWebViewContextWithHydrationRetry(sessionId, step, css, body, timeoutMs) {
   const deadline = Date.now() + Math.max(1e3, timeoutMs);
   for (; ; ) {
@@ -357097,6 +357199,17 @@ async function executeInWebViewContextWithHydrationRetry(sessionId, step, css, b
     }
   }
 }
+var SYSTEM_PERMISSION_BUTTON_RE = /com\.android\.permissioncontroller:id\/permission_(allow|deny)|com\.android\.packageinstaller:id\/permission_|:id\/permission_allow_(foreground_only|one_time)_button|^(?:com\.apple\.springboard|SpringBoard)/i;
+function isSystemPermissionButtonTarget(target) {
+  if (!target) return false;
+  const bundle = target.locatorBundle;
+  const candidates = [
+    target.primary,
+    typeof bundle?.resourceId === "string" ? bundle.resourceId : "",
+    typeof bundle?.xpath === "string" ? bundle.xpath : ""
+  ];
+  return candidates.some((c) => typeof c === "string" && SYSTEM_PERMISSION_BUTTON_RE.test(c));
+}
 async function executeTap(sessionId, step, platform3, isCrossPlatform = false) {
   const webCss = stepWebViewCss(step);
   if (webCss) {
@@ -357109,10 +357222,11 @@ async function executeTap(sessionId, step, platform3, isCrossPlatform = false) {
     );
     return;
   }
+  const isPermissionTap = isSystemPermissionButtonTarget(step.target);
   const bounds = boundsForRun(step, platform3, isCrossPlatform);
   if (step.target) {
     try {
-      const elementId = await findElement(sessionId, step.target, readStepTimeout(step), {
+      const elementId = await findElement(sessionId, step.target, isPermissionTap ? Math.min(readStepTimeout(step) ?? DEFAULT_STEP_TIMEOUT_MS, PERMISSION_DIALOG_TIMEOUT_MS) : readStepTimeout(step), {
         platform: platform3,
         recordedBounds: bounds
       });
@@ -357122,7 +357236,23 @@ async function executeTap(sessionId, step, platform3, isCrossPlatform = false) {
       });
       return;
     } catch (error2) {
-      if (isTransportError(error2) || !bounds || buildLocatorStrategies(step.target, platform3).length > 0) throw error2;
+      if (isTransportError(error2) || error2 instanceof MobileAmbiguousMatchError) throw error2;
+      if (isPermissionTap) return;
+      const cssFallback = webViewCssFallbackFromNativeStep(step);
+      const textFallback = cssFallback ? null : webViewTextFallbackFromNativeStep(step);
+      if ((cssFallback || textFallback) && await hasLiveWebViewContext(sessionId)) {
+        try {
+          if (cssFallback) {
+            await executeInWebViewContext(sessionId, step, cssFallback, (sessionPath, css) => clickCssInCurrentContext(sessionPath, css));
+          } else if (textFallback) {
+            await executeInWebViewContext(sessionId, step, textFallback, (sessionPath) => clickByVisibleTextInCurrentContext(sessionPath, textFallback));
+          }
+          return;
+        } catch (webErr) {
+          if (isTransportError(webErr)) throw webErr;
+        }
+      }
+      if (!bounds || buildLocatorStrategies(step.target, platform3).length > 0) throw error2;
     }
   }
   if (!bounds) {
@@ -357180,6 +357310,18 @@ async function executeType(sessionId, step, context) {
     return;
   } catch (error2) {
     if (isTransportError(error2)) throw error2;
+    if (!focusEstablished && !keyboardSubmitOnly) {
+      const cssFallback = webViewCssFallbackFromNativeStep(step);
+      if (cssFallback && await hasLiveWebViewContext(sessionId)) {
+        try {
+          context.log?.(`  Native locate failed; retrying as WebView ${cssFallback} (hybrid mirror fallback)`);
+          await executeInWebViewContext(sessionId, step, cssFallback, (sessionPath2, css) => typeCssInCurrentContext(sessionPath2, css, value));
+          return;
+        } catch (webErr) {
+          if (isTransportError(webErr)) throw webErr;
+        }
+      }
+    }
     if (context.platform === "ANDROID" && focusEstablished) {
       try {
         context.log?.("  Appium active-element send failed; using Android focused-keyboard input fallback");
@@ -358158,6 +358300,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 +363984,7 @@ async function startRunner(opts) {
       }
     }
   };
+  const heartbeatKeepalive = startHeartbeatKeepalive();
   const sendHeartbeat = async () => {
     try {
       const devices = enableMobile ? getCachedDeviceSnapshot() : [];
@@ -363776,41 +363999,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 +364107,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

@@ -5859,6 +5859,29 @@ function normalizeTtsVoiceId(voiceId) {
     return null;
   return LEGACY_TTS_VOICE_ID_MAP[trimmed] ?? trimmed;
 }
+function normalizeTtsModel(model) {
+  if (!model)
+    return null;
+  const trimmed = model.trim();
+  if (!trimmed)
+    return null;
+  return LEGACY_TTS_MODEL_MAP[trimmed] ?? trimmed;
+}
+function ttsFallbackModel(primary) {
+  const normalized = normalizeTtsModel(primary);
+  if (!normalized)
+    return null;
+  return TTS_FALLBACK_MODEL_MAP[normalized] ?? null;
+}
+function resolveTtsModelChain(model) {
+  const normalized = normalizeTtsModel(model);
+  const primary = normalized && normalized in TTS_FALLBACK_MODEL_MAP ? normalized : DEFAULT_TTS_MODEL;
+  const chain = [primary];
+  const fallback = TTS_FALLBACK_MODEL_MAP[primary];
+  if (fallback && fallback !== primary)
+    chain.push(fallback);
+  return chain;
+}
 function sttModelsForProvider(provider) {
   if (provider === "openai") {
     return STT_MODEL_OPTIONS.filter((m) => m.provider === "openai");
@@ -5906,16 +5929,18 @@ function isValidTtsVoiceId(value) {
   return TTS_VOICE_OPTIONS.some((v) => v.id === normalized);
 }
 function isValidTtsModel(value) {
-  if (!value)
+  const normalized = normalizeTtsModel(value);
+  if (!normalized)
     return false;
-  return TTS_MODEL_OPTIONS.some((m) => m.id === value);
+  return TTS_MODEL_OPTIONS.some((m) => m.id === normalized);
 }
-var VOICE_PREVIEW_SAMPLE, DEFAULT_TTS_MODEL, DEFAULT_TTS_VOICE_ID, DEFAULT_TTS_SPEED, LEGACY_TTS_VOICE_ID_MAP, DEFAULT_STT_MODEL_BY_PROVIDER, STT_PROVIDER_OPTIONS, STT_MODEL_OPTIONS, TTS_MODEL_OPTIONS, TTS_VOICE_OPTIONS;
+var VOICE_PREVIEW_SAMPLE, DEFAULT_TTS_MODEL, DEFAULT_TTS_TURBO_MODEL, DEFAULT_TTS_VOICE_ID, DEFAULT_TTS_SPEED, LEGACY_TTS_VOICE_ID_MAP, LEGACY_TTS_MODEL_MAP, TTS_FALLBACK_MODEL_MAP, DEFAULT_STT_MODEL_BY_PROVIDER, STT_PROVIDER_OPTIONS, STT_MODEL_OPTIONS, TTS_MODEL_OPTIONS, TTS_VOICE_OPTIONS;
 var init_voice_config = __esm({
   "../shared/dist/voice-config.js"() {
     "use strict";
     VOICE_PREVIEW_SAMPLE = "Hello! I am your Validate Copilot assistant. I can help you run tests, review failures, and generate new coverage for your project.";
-    DEFAULT_TTS_MODEL = "speech-2.6-hd";
+    DEFAULT_TTS_MODEL = "speech-2.8-hd";
+    DEFAULT_TTS_TURBO_MODEL = "speech-2.8-turbo";
     DEFAULT_TTS_VOICE_ID = "English_Graceful_Lady";
     DEFAULT_TTS_SPEED = 1;
     LEGACY_TTS_VOICE_ID_MAP = {
@@ -5924,6 +5949,18 @@ var init_voice_config = __esm({
       English_Deep_Voice_Man: "English_ManWithDeepVoice",
       English_CasualMan: "English_Jovialman"
     };
+    LEGACY_TTS_MODEL_MAP = {
+      "speech-2.6-hd": "speech-2.8-hd",
+      "speech-2.6-turbo": "speech-2.8-turbo",
+      "speech-02-hd": "speech-2.8-hd",
+      "speech-02-turbo": "speech-2.8-turbo",
+      "speech-01-hd": "speech-2.8-hd",
+      "speech-01-turbo": "speech-2.8-turbo"
+    };
+    TTS_FALLBACK_MODEL_MAP = {
+      "speech-2.8-hd": "speech-2.6-hd",
+      "speech-2.8-turbo": "speech-2.6-turbo"
+    };
     DEFAULT_STT_MODEL_BY_PROVIDER = {
       groq: "whisper-large-v3-turbo",
       openai: "whisper-1"
@@ -5976,49 +6013,13 @@ var init_voice_config = __esm({
         id: "speech-2.8-hd",
         label: "Speech 2.8 HD",
         provider: "minimax",
-        description: "Latest high-definition model with interjection tags (recommended)."
+        description: "High-definition quality (default). Auto-falls back to Speech 2.6 HD."
       },
       {
         id: "speech-2.8-turbo",
         label: "Speech 2.8 Turbo",
         provider: "minimax",
-        description: "Latest low-latency model with interjection tags."
-      },
-      {
-        id: "speech-2.6-hd",
-        label: "Speech 2.6 HD",
-        provider: "minimax",
-        description: "High-definition MiniMax voice model."
-      },
-      {
-        id: "speech-2.6-turbo",
-        label: "Speech 2.6 Turbo",
-        provider: "minimax",
-        description: "Lower-latency Speech 2.6 variant."
-      },
-      {
-        id: "speech-02-hd",
-        label: "Speech 02 HD",
-        provider: "minimax",
-        description: "Previous-generation HD model."
-      },
-      {
-        id: "speech-02-turbo",
-        label: "Speech 02 Turbo",
-        provider: "minimax",
-        description: "Lower-latency Speech 02 variant."
-      },
-      {
-        id: "speech-01-hd",
-        label: "Speech 01 HD",
-        provider: "minimax",
-        description: "Legacy HD model."
-      },
-      {
-        id: "speech-01-turbo",
-        label: "Speech 01 Turbo",
-        provider: "minimax",
-        description: "Legacy fast model."
+        description: "Lower latency. Auto-falls back to Speech 2.6 Turbo."
       }
     ];
     TTS_VOICE_OPTIONS = [
@@ -6302,6 +6303,7 @@ __export(dist_exports, {
   DEFAULT_STT_MODEL_BY_PROVIDER: () => DEFAULT_STT_MODEL_BY_PROVIDER,
   DEFAULT_TTS_MODEL: () => DEFAULT_TTS_MODEL,
   DEFAULT_TTS_SPEED: () => DEFAULT_TTS_SPEED,
+  DEFAULT_TTS_TURBO_MODEL: () => DEFAULT_TTS_TURBO_MODEL,
   DEFAULT_TTS_VOICE_ID: () => DEFAULT_TTS_VOICE_ID,
   DEFAULT_UI_VARIANT: () => DEFAULT_UI_VARIANT,
   EMAIL_FROM_IDENTITIES: () => EMAIL_FROM_IDENTITIES,
@@ -6311,6 +6313,7 @@ __export(dist_exports, {
   FLOW_SERVER_TYPES: () => FLOW_SERVER_TYPES,
   GROUPABLE_CALL_TYPES: () => GROUPABLE_CALL_TYPES,
   GROUP_LABELS: () => GROUP_LABELS,
+  LEGACY_TTS_MODEL_MAP: () => LEGACY_TTS_MODEL_MAP,
   LEGACY_TTS_VOICE_ID_MAP: () => LEGACY_TTS_VOICE_ID_MAP,
   MAX_CREDIT_TOPUP_CENTS: () => MAX_CREDIT_TOPUP_CENTS,
   MAX_DEEPLINK_LENGTH: () => MAX_DEEPLINK_LENGTH,
@@ -6344,6 +6347,7 @@ __export(dist_exports, {
   TEST_USER_ENV_KEYS: () => TEST_USER_ENV_KEYS,
   TRANSIENT_CONTROL_ROLES: () => TRANSIENT_CONTROL_ROLES,
   TRIAL_DURATION_DAYS: () => TRIAL_DURATION_DAYS,
+  TTS_FALLBACK_MODEL_MAP: () => TTS_FALLBACK_MODEL_MAP,
   TTS_MODEL_OPTIONS: () => TTS_MODEL_OPTIONS,
   TTS_VOICE_OPTIONS: () => TTS_VOICE_OPTIONS,
   UI_VARIANTS: () => UI_VARIANTS,
@@ -6446,6 +6450,7 @@ __export(dist_exports, {
   mobilePlatformFromMedium: () => mobilePlatformFromMedium,
   mobileWanderTraceEnabled: () => mobileWanderTraceEnabled,
   normalizeControlName: () => normalizeControlName,
+  normalizeTtsModel: () => normalizeTtsModel,
   normalizeTtsVoiceId: () => normalizeTtsVoiceId,
   otherMobilePlatform: () => otherMobilePlatform,
   parenDepthDelta: () => parenDepthDelta,
@@ -6464,6 +6469,7 @@ __export(dist_exports, {
   resolveMobileStepValuePlaceholders: () => resolveMobileStepValuePlaceholders,
   resolvePlatformLocatorBundle: () => resolvePlatformLocatorBundle,
   resolveSttModelForProvider: () => resolveSttModelForProvider,
+  resolveTtsModelChain: () => resolveTtsModelChain,
   safeCurrentUrl: () => safeCurrentUrl,
   safeOrigin: () => safeOrigin,
   sanitizeSttErrorMessage: () => sanitizeSttErrorMessage,
@@ -6486,6 +6492,7 @@ __export(dist_exports, {
   summarizeMobileReadiness: () => summarizeMobileReadiness,
   summarizeRunHealth: () => summarizeRunHealth,
   toDbPricingPlan: () => toDbPricingPlan,
+  ttsFallbackModel: () => ttsFallbackModel,
   validateAssertionStrength: () => validateAssertionStrength
 });
 var init_dist = __esm({
@@ -11496,7 +11503,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 +11556,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 +74656,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 +75110,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 +83754,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 +83769,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 +83786,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 +353019,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.71",
+      version: "1.0.73",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -354659,6 +354683,27 @@ async function clickCssInCurrentContext(sessionPath, css) {
     body: "{}"
   });
 }
+async function clickByVisibleTextInCurrentContext(sessionPath, text) {
+  const script = `
+    var t = String(arguments[0]).trim().replace(/\\s+/g, ' ');
+    var sel = 'button, a, [role="tab"], [role="button"], [onclick], .stream-tab, .ux-interactive, input[type="submit"], input[type="button"]';
+    var norm = function (e) { return (e.textContent || e.value || '').trim().replace(/\\s+/g, ' '); };
+    var vis = function (e) { var r = e.getBoundingClientRect(); return r.width > 0 && r.height > 0; };
+    var all = Array.prototype.slice.call(document.querySelectorAll(sel));
+    var match = all.filter(function (e) { return norm(e) === t && vis(e); });
+    if (match.length !== 1) { return match.length; }
+    match[0].click();
+    return 1;
+  `;
+  const result = await appiumRequest(`${sessionPath}/execute/sync`, {
+    method: "POST",
+    body: JSON.stringify({ script, args: [text] })
+  });
+  const count = readValue(result);
+  if (count !== 1) {
+    throw new Error(`WEBVIEW text click found ${count === 0 || count === void 0 ? "no" : String(count)} actionable match(es) for "${text}"`);
+  }
+}
 async function typeCssInCurrentContext(sessionPath, css, text) {
   const elResult = await appiumRequest(`${sessionPath}/element`, {
     method: "POST",
@@ -354807,7 +354852,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 +354865,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);
   }
 }
@@ -357006,6 +357065,48 @@ function stepWebViewContext(step) {
   const meta = step.metadata && typeof step.metadata === "object" ? step.metadata : null;
   return typeof meta?.webviewContext === "string" && meta.webviewContext.trim() ? meta.webviewContext.trim() : null;
 }
+var DOM_ID_RE = /^[A-Za-z_][\w-]*$/;
+var SYSTEM_RESOURCE_ID_RE = /^(?:android|com\.android\.|com\.google\.android\.)/i;
+function webViewCssFallbackFromNativeStep(step) {
+  if (stepWebViewCss(step)) return null;
+  const target = step.target;
+  if (!target) return null;
+  const bundle = target.locatorBundle;
+  const resourceId = typeof bundle?.resourceId === "string" ? bundle.resourceId.trim() : "";
+  const accessibilityId = typeof bundle?.accessibilityId === "string" ? bundle.accessibilityId.trim() : "";
+  const primary = typeof target.primary === "string" ? target.primary.trim() : "";
+  const fromResourceId = (raw) => {
+    if (!raw) return null;
+    if (raw.includes(":id/")) {
+      if (SYSTEM_RESOURCE_ID_RE.test(raw)) return null;
+      const local = raw.slice(raw.indexOf(":id/") + 4);
+      return DOM_ID_RE.test(local) ? local : null;
+    }
+    return DOM_ID_RE.test(raw) ? raw : null;
+  };
+  const domId = fromResourceId(resourceId) ?? fromResourceId(accessibilityId) ?? (primary && !/[=~/[\].\s]/.test(primary) && DOM_ID_RE.test(primary) ? primary : null);
+  return domId ? `#${domId}` : null;
+}
+function webViewTextFallbackFromNativeStep(step) {
+  if (stepWebViewCss(step)) return null;
+  if (step.action !== "tap") return null;
+  const target = step.target;
+  if (!target) return null;
+  const bundle = target.locatorBundle;
+  const text = typeof bundle?.text === "string" && bundle.text.trim() ? bundle.text.trim() : typeof bundle?.contentDesc === "string" && bundle.contentDesc.trim() ? bundle.contentDesc.trim() : typeof target.primary === "string" && target.primary.trim() && !/[=~/[\]]|:id\//.test(target.primary) ? target.primary.trim() : "";
+  const normalized = text.replace(/\s+/g, " ");
+  if (!normalized || normalized.length > 40 || /[\n\r]/.test(text)) return null;
+  if (SYSTEM_PERMISSION_BUTTON_RE.test(text)) return null;
+  return normalized;
+}
+async function hasLiveWebViewContext(sessionId) {
+  try {
+    const contexts = await listAppContexts(`/session/${sessionId}`);
+    return contexts.some((c) => /^WEBVIEW/i.test(c));
+  } catch {
+    return false;
+  }
+}
 var CONTAINER_ONLY_ENTRY_ID_RE = /(?:^|[:/])id\/(webview|content|decor|decor_content_parent|action_bar_root|statusBarBackground|navigationBarBackground)$|^(?:main-content|root|app|app-root|__next|react-root|application)$/i;
 function isContainerOnlyEntryTarget(target) {
   const primary = target?.primary?.trim() ?? "";
@@ -357093,6 +357194,7 @@ function isWebViewHydrationTransient(err) {
   return /no such element|NoSuchElement|element not interactable|stale element|WEBVIEW step requires|Empty page dictionary|not connectable|no WEBVIEW context|chrome not reachable/i.test(message);
 }
 var WEBVIEW_HYDRATION_TIMEOUT_MS = Number(process.env.VALIDATEQA_WEBVIEW_HYDRATION_TIMEOUT_MS) || 3e4;
+var PERMISSION_DIALOG_TIMEOUT_MS = Number(process.env.VALIDATEQA_PERMISSION_DIALOG_TIMEOUT_MS) || 3e3;
 async function executeInWebViewContextWithHydrationRetry(sessionId, step, css, body, timeoutMs) {
   const deadline = Date.now() + Math.max(1e3, timeoutMs);
   for (; ; ) {
@@ -357105,6 +357207,17 @@ async function executeInWebViewContextWithHydrationRetry(sessionId, step, css, b
     }
   }
 }
+var SYSTEM_PERMISSION_BUTTON_RE = /com\.android\.permissioncontroller:id\/permission_(allow|deny)|com\.android\.packageinstaller:id\/permission_|:id\/permission_allow_(foreground_only|one_time)_button|^(?:com\.apple\.springboard|SpringBoard)/i;
+function isSystemPermissionButtonTarget(target) {
+  if (!target) return false;
+  const bundle = target.locatorBundle;
+  const candidates = [
+    target.primary,
+    typeof bundle?.resourceId === "string" ? bundle.resourceId : "",
+    typeof bundle?.xpath === "string" ? bundle.xpath : ""
+  ];
+  return candidates.some((c) => typeof c === "string" && SYSTEM_PERMISSION_BUTTON_RE.test(c));
+}
 async function executeTap(sessionId, step, platform3, isCrossPlatform = false) {
   const webCss = stepWebViewCss(step);
   if (webCss) {
@@ -357117,10 +357230,11 @@ async function executeTap(sessionId, step, platform3, isCrossPlatform = false) {
     );
     return;
   }
+  const isPermissionTap = isSystemPermissionButtonTarget(step.target);
   const bounds = boundsForRun(step, platform3, isCrossPlatform);
   if (step.target) {
     try {
-      const elementId = await findElement(sessionId, step.target, readStepTimeout(step), {
+      const elementId = await findElement(sessionId, step.target, isPermissionTap ? Math.min(readStepTimeout(step) ?? DEFAULT_STEP_TIMEOUT_MS, PERMISSION_DIALOG_TIMEOUT_MS) : readStepTimeout(step), {
         platform: platform3,
         recordedBounds: bounds
       });
@@ -357130,7 +357244,23 @@ async function executeTap(sessionId, step, platform3, isCrossPlatform = false) {
       });
       return;
     } catch (error2) {
-      if (isTransportError(error2) || !bounds || buildLocatorStrategies(step.target, platform3).length > 0) throw error2;
+      if (isTransportError(error2) || error2 instanceof MobileAmbiguousMatchError) throw error2;
+      if (isPermissionTap) return;
+      const cssFallback = webViewCssFallbackFromNativeStep(step);
+      const textFallback = cssFallback ? null : webViewTextFallbackFromNativeStep(step);
+      if ((cssFallback || textFallback) && await hasLiveWebViewContext(sessionId)) {
+        try {
+          if (cssFallback) {
+            await executeInWebViewContext(sessionId, step, cssFallback, (sessionPath, css) => clickCssInCurrentContext(sessionPath, css));
+          } else if (textFallback) {
+            await executeInWebViewContext(sessionId, step, textFallback, (sessionPath) => clickByVisibleTextInCurrentContext(sessionPath, textFallback));
+          }
+          return;
+        } catch (webErr) {
+          if (isTransportError(webErr)) throw webErr;
+        }
+      }
+      if (!bounds || buildLocatorStrategies(step.target, platform3).length > 0) throw error2;
     }
   }
   if (!bounds) {
@@ -357188,6 +357318,18 @@ async function executeType(sessionId, step, context) {
     return;
   } catch (error2) {
     if (isTransportError(error2)) throw error2;
+    if (!focusEstablished && !keyboardSubmitOnly) {
+      const cssFallback = webViewCssFallbackFromNativeStep(step);
+      if (cssFallback && await hasLiveWebViewContext(sessionId)) {
+        try {
+          context.log?.(`  Native locate failed; retrying as WebView ${cssFallback} (hybrid mirror fallback)`);
+          await executeInWebViewContext(sessionId, step, cssFallback, (sessionPath2, css) => typeCssInCurrentContext(sessionPath2, css, value));
+          return;
+        } catch (webErr) {
+          if (isTransportError(webErr)) throw webErr;
+        }
+      }
+    }
     if (context.platform === "ANDROID" && focusEstablished) {
       try {
         context.log?.("  Appium active-element send failed; using Android focused-keyboard input fallback");
@@ -358166,6 +358308,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 +363992,7 @@ async function startRunner(opts) {
       }
     }
   };
+  const heartbeatKeepalive = startHeartbeatKeepalive();
   const sendHeartbeat = async () => {
     try {
       const devices = enableMobile ? getCachedDeviceSnapshot() : [];
@@ -363784,41 +364007,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 +364115,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.73",
   "description": "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
   "bin": {
     "validate-runner": "dist/cli.js"