@validate.qa/runner 1.0.72 → 1.0.74

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({
@@ -353007,7 +353014,7 @@ var require_package4 = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.72",
+      version: "1.0.74",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -354671,6 +354678,47 @@ async function clickCssInCurrentContext(sessionPath, css) {
     body: "{}"
   });
 }
+async function clickByVisibleTextInCurrentContext(sessionPath, text) {
+  const script = `
+    var t = String(arguments[0]).trim().replace(/\\s+/g, ' ');
+    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.body.getElementsByTagName('*'));
+    var match = all.filter(function (e) { return norm(e) === t && vis(e); });
+    // Deepest-only: drop any match that contains another match (same text).
+    var deepest = match.filter(function (e) {
+      return !match.some(function (o) { return o !== e && e.contains(o); });
+    });
+    if (deepest.length !== 1) { return deepest.length; }
+    var el = deepest[0];
+    var interactive = function (e) {
+      var tag = e.tagName;
+      if (tag === 'BUTTON' || tag === 'A' || tag === 'INPUT' || tag === 'SELECT' || tag === 'SUMMARY') { return true; }
+      var role = e.getAttribute && e.getAttribute('role');
+      if (role === 'button' || role === 'tab' || role === 'link' || role === 'menuitem' || role === 'option') { return true; }
+      if (e.hasAttribute && (e.hasAttribute('onclick') || (e.hasAttribute('tabindex') && e.getAttribute('tabindex') !== '-1'))) { return true; }
+      try { return window.getComputedStyle(e).cursor === 'pointer'; } catch (err) { return false; }
+    };
+    // Prefer the outermost interactive ancestor that wraps ONLY this text.
+    var target = el;
+    var hop = el;
+    for (var i = 0; i < 5 && hop && hop !== document.body; i++) {
+      if (norm(hop) !== t) { break; }
+      if (interactive(hop)) { target = hop; }
+      hop = hop.parentElement;
+    }
+    target.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",
@@ -357029,6 +357077,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() ?? "";
@@ -357116,6 +357206,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 (; ; ) {
@@ -357128,6 +357219,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) {
@@ -357140,10 +357242,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
       });
@@ -357153,7 +357256,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) {
@@ -357211,6 +357330,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");
@@ -363045,7 +363176,11 @@ ${finalVerifyResult.logs ?? ""}`;
         surface: "mobile",
         mobilePlatform: target.platform,
         ...assignedDeviceId ? { deviceId: assignedDeviceId } : {},
-        ...leasedDeviceName ? { deviceName: leasedDeviceName } : {}
+        ...leasedDeviceName ? { deviceName: leasedDeviceName } : {},
+        // A mobile AI heal spends its first phase in model analysis with NO
+        // Appium session, so the dashboard mirror is legitimately dark — say
+        // so instead of leaving an eternal "mirror starting" placeholder.
+        ...runMode === "heal" ? { note: "Heal Phase 1 \u2014 reproducing & analyzing the failure (the device mirror attaches when the live phase starts)" } : {}
       });
       requestLiveBrowserHeartbeat(true);
       const mobileSteps = run2.steps ?? [];
@@ -363145,7 +363280,11 @@ ${finalVerifyResult.logs ?? ""}`;
             // Surface heal liveness: a Phase-1/Phase-2 heal can legitimately run
             // for many minutes of model calls with zero device traffic, which
             // previously printed nothing between the start banner and the verdict.
-            onProgress: (message) => log.info(`\u{1FA7A} ${message}`),
+            onProgress: (message) => {
+              log.info(`\u{1FA7A} ${message}`);
+              liveBrowserHandle.patch({ note: `\u{1FA7A} ${message}`.slice(0, 180) });
+              requestLiveBrowserHeartbeat();
+            },
             selectorRegistryContext: run2.selectorRegistryContext ?? null,
             runLiveHeal: async (a) => {
               let liveSession = null;
@@ -363197,6 +363336,8 @@ ${finalVerifyResult.logs ?? ""}`;
                 };
               }
               log.info("\u{1FA7A} Phase 2 (live device) \u2014 opening the live observation session...");
+              liveBrowserHandle.patch({ note: "Heal Phase 2 \u2014 opening the live device session (mirror attaching)" });
+              requestLiveBrowserHeartbeat(true);
               try {
                 await openLiveSession();
                 const liveDriver = {

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({
@@ -353012,7 +353019,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.72",
+      version: "1.0.74",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -354676,6 +354683,47 @@ async function clickCssInCurrentContext(sessionPath, css) {
     body: "{}"
   });
 }
+async function clickByVisibleTextInCurrentContext(sessionPath, text) {
+  const script = `
+    var t = String(arguments[0]).trim().replace(/\\s+/g, ' ');
+    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.body.getElementsByTagName('*'));
+    var match = all.filter(function (e) { return norm(e) === t && vis(e); });
+    // Deepest-only: drop any match that contains another match (same text).
+    var deepest = match.filter(function (e) {
+      return !match.some(function (o) { return o !== e && e.contains(o); });
+    });
+    if (deepest.length !== 1) { return deepest.length; }
+    var el = deepest[0];
+    var interactive = function (e) {
+      var tag = e.tagName;
+      if (tag === 'BUTTON' || tag === 'A' || tag === 'INPUT' || tag === 'SELECT' || tag === 'SUMMARY') { return true; }
+      var role = e.getAttribute && e.getAttribute('role');
+      if (role === 'button' || role === 'tab' || role === 'link' || role === 'menuitem' || role === 'option') { return true; }
+      if (e.hasAttribute && (e.hasAttribute('onclick') || (e.hasAttribute('tabindex') && e.getAttribute('tabindex') !== '-1'))) { return true; }
+      try { return window.getComputedStyle(e).cursor === 'pointer'; } catch (err) { return false; }
+    };
+    // Prefer the outermost interactive ancestor that wraps ONLY this text.
+    var target = el;
+    var hop = el;
+    for (var i = 0; i < 5 && hop && hop !== document.body; i++) {
+      if (norm(hop) !== t) { break; }
+      if (interactive(hop)) { target = hop; }
+      hop = hop.parentElement;
+    }
+    target.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",
@@ -357037,6 +357085,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() ?? "";
@@ -357124,6 +357214,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 (; ; ) {
@@ -357136,6 +357227,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) {
@@ -357148,10 +357250,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
       });
@@ -357161,7 +357264,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) {
@@ -357219,6 +357338,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");
@@ -363053,7 +363184,11 @@ ${finalVerifyResult.logs ?? ""}`;
         surface: "mobile",
         mobilePlatform: target.platform,
         ...assignedDeviceId ? { deviceId: assignedDeviceId } : {},
-        ...leasedDeviceName ? { deviceName: leasedDeviceName } : {}
+        ...leasedDeviceName ? { deviceName: leasedDeviceName } : {},
+        // A mobile AI heal spends its first phase in model analysis with NO
+        // Appium session, so the dashboard mirror is legitimately dark — say
+        // so instead of leaving an eternal "mirror starting" placeholder.
+        ...runMode === "heal" ? { note: "Heal Phase 1 \u2014 reproducing & analyzing the failure (the device mirror attaches when the live phase starts)" } : {}
       });
       requestLiveBrowserHeartbeat(true);
       const mobileSteps = run2.steps ?? [];
@@ -363153,7 +363288,11 @@ ${finalVerifyResult.logs ?? ""}`;
             // Surface heal liveness: a Phase-1/Phase-2 heal can legitimately run
             // for many minutes of model calls with zero device traffic, which
             // previously printed nothing between the start banner and the verdict.
-            onProgress: (message) => log.info(`\u{1FA7A} ${message}`),
+            onProgress: (message) => {
+              log.info(`\u{1FA7A} ${message}`);
+              liveBrowserHandle.patch({ note: `\u{1FA7A} ${message}`.slice(0, 180) });
+              requestLiveBrowserHeartbeat();
+            },
             selectorRegistryContext: run2.selectorRegistryContext ?? null,
             runLiveHeal: async (a) => {
               let liveSession = null;
@@ -363205,6 +363344,8 @@ ${finalVerifyResult.logs ?? ""}`;
                 };
               }
               log.info("\u{1FA7A} Phase 2 (live device) \u2014 opening the live observation session...");
+              liveBrowserHandle.patch({ note: "Heal Phase 2 \u2014 opening the live device session (mirror attaching)" });
+              requestLiveBrowserHeartbeat(true);
               try {
                 await openLiveSession();
                 const liveDriver = {

package/package.json

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