@validate.qa/runner 1.0.15 → 1.0.16

package/dist/cli.js

@@ -66792,16 +66792,16 @@ ${statePacket}` },
       }
       const screen = screenName();
       if (accessibilityId) {
-        const bundle2 = { xpath: `//*[@content-desc=${xpathLiteral(accessibilityId)} or @name=${xpathLiteral(accessibilityId)}]`, className: "", accessibilityId };
+        const bundle2 = { xpath: `//*[@content-desc=${xpathLiteral2(accessibilityId)} or @name=${xpathLiteral2(accessibilityId)}]`, className: "", accessibilityId };
         recordAction({ type: "ASSERT_VISIBLE", selector: accessibilityId, metadata: { screenName: screen, targetLabel: accessibilityId, locatorBundle: bundle2 } });
         return { ok: true, label: accessibilityId };
       }
       const safeText = text;
-      const bundle = { xpath: `//*[@text=${xpathLiteral(safeText)} or @label=${xpathLiteral(safeText)}]`, className: "", text: safeText };
+      const bundle = { xpath: `//*[@text=${xpathLiteral2(safeText)} or @label=${xpathLiteral2(safeText)}]`, className: "", text: safeText };
       recordAction({ type: "ASSERT_VISIBLE", selector: bundle.xpath, metadata: { screenName: screen, targetLabel: safeText, locatorBundle: bundle } });
       return { ok: true, label: safeText };
     }
-    function xpathLiteral(value) {
+    function xpathLiteral2(value) {
       if (!value.includes("'"))
         return `'${value}'`;
       if (!value.includes('"'))
@@ -328118,7 +328118,7 @@ var require_package4 = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.15",
+      version: "1.0.16",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -329723,7 +329723,7 @@ async function getWindowSize(sessionId, retries = 3) {
   }
   throw new Error("Failed to get window size: invalid dimensions returned");
 }
-function realDeviceCapabilities(platform3) {
+function realDeviceCapabilities(platform3, portOffset = 0) {
   const env = process.env;
   const caps = {};
   const num = (v) => {
@@ -329731,6 +329731,7 @@ function realDeviceCapabilities(platform3) {
     const n = Number.parseInt(v, 10);
     return Number.isFinite(n) ? n : void 0;
   };
+  const offset = Number.isFinite(portOffset) && portOffset > 0 ? Math.floor(portOffset) : 0;
   if (platform3 === "IOS") {
     if (env.APPIUM_XCODE_ORG_ID) {
       caps["appium:xcodeOrgId"] = env.APPIUM_XCODE_ORG_ID;
@@ -329740,15 +329741,15 @@ function realDeviceCapabilities(platform3) {
     }
     if (env.APPIUM_UPDATED_WDA_BUNDLE_ID) caps["appium:updatedWDABundleId"] = env.APPIUM_UPDATED_WDA_BUNDLE_ID;
     const wdaPort = num(env.APPIUM_WDA_LOCAL_PORT);
-    if (wdaPort !== void 0) caps["appium:wdaLocalPort"] = wdaPort;
+    if (wdaPort !== void 0) caps["appium:wdaLocalPort"] = wdaPort + offset;
   } else {
     const systemPort = num(env.APPIUM_SYSTEM_PORT);
-    if (systemPort !== void 0) caps["appium:systemPort"] = systemPort;
+    if (systemPort !== void 0) caps["appium:systemPort"] = systemPort + offset;
   }
   return caps;
 }
 async function createSession(target) {
-  const realCaps = target.isPhysical ? realDeviceCapabilities(target.platform) : {};
+  const realCaps = target.isPhysical ? realDeviceCapabilities(target.platform, target.portOffset) : {};
   const capabilities = target.platform === "IOS" ? {
     platformName: "iOS",
     "appium:automationName": "XCUITest",
@@ -330023,6 +330024,46 @@ function buildLocatorStrategies(target) {
     (strategy, index, list) => list.findIndex((candidate) => candidate.using === strategy.using && candidate.value === strategy.value) === index
   );
 }
+function dedupeStrategies(strategies) {
+  return strategies.filter(
+    (strategy, index, list) => list.findIndex((candidate) => candidate.using === strategy.using && candidate.value === strategy.value) === index
+  );
+}
+function xpathLiteral(value) {
+  if (!value.includes("'")) return `'${value}'`;
+  if (!value.includes('"')) return `"${value}"`;
+  const parts = value.split("'").map((p) => `'${p}'`);
+  return `concat(${parts.join(`, "'", `)})`;
+}
+function identityTextXpath(value) {
+  const lit = xpathLiteral(value);
+  return `//*[@text=${lit} or @content-desc=${lit} or @label=${lit} or @name=${lit} or @value=${lit}]`;
+}
+function isIdentityStrategy(strategy) {
+  if (strategy.using === "accessibility id" || strategy.using === "id") return true;
+  if (strategy.using === "xpath") return strategy.value.includes("@");
+  return false;
+}
+function buildIdentityLocatorStrategies(target) {
+  if (!target) return [];
+  const strategies = [];
+  const bundle = target.locatorBundle;
+  if (bundle) {
+    if (bundle.accessibilityId) strategies.push({ using: "accessibility id", value: bundle.accessibilityId });
+    if (bundle.resourceId) strategies.push({ using: "id", value: bundle.resourceId });
+    for (const value of [bundle.text, bundle.contentDesc]) {
+      const trimmed = value?.trim();
+      if (trimmed) strategies.push({ using: "xpath", value: identityTextXpath(trimmed) });
+    }
+    if (bundle.xpath && bundle.xpath.includes("@")) strategies.push({ using: "xpath", value: bundle.xpath });
+  }
+  for (const value of [target.primary, ...target.fallbacks ?? []]) {
+    for (const strategy of locatorStrategyForValue(value)) {
+      if (isIdentityStrategy(strategy)) strategies.push(strategy);
+    }
+  }
+  return dedupeStrategies(strategies);
+}
 function readStepTimeout(step) {
   const value = step.metadata?.timeout;
   if (typeof value === "number" && Number.isFinite(value) && value > 0) {
@@ -330030,10 +330071,12 @@ function readStepTimeout(step) {
   }
   return void 0;
 }
-async function findElement(sessionId, target, timeoutMs = DEFAULT_STEP_TIMEOUT_MS) {
-  const strategies = buildLocatorStrategies(target);
+async function findElement(sessionId, target, timeoutMs = DEFAULT_STEP_TIMEOUT_MS, opts) {
+  const strategies = opts?.identityOnly ? buildIdentityLocatorStrategies(target) : buildLocatorStrategies(target);
   if (strategies.length === 0) {
-    throw new Error("No locator strategies available for this step");
+    throw new Error(
+      opts?.identityOnly ? "No identity locator (accessibility id / resource id / text) available for this step \u2014 cannot verify the screen" : "No locator strategies available for this step"
+    );
   }
   const startTime = Date.now();
   let lastError = "";
@@ -330142,7 +330185,7 @@ async function executeTap(sessionId, step) {
       });
       return;
     } catch (error2) {
-      if (!bounds) throw error2;
+      if (isTransportError(error2) || !bounds || buildLocatorStrategies(step.target).length > 0) throw error2;
     }
   }
   if (!bounds) {
@@ -330175,7 +330218,7 @@ async function executeType(sessionId, step, context) {
       if (!lastInputError) return;
       elementId = null;
     } catch (error2) {
-      if (!bounds) throw error2;
+      if (isTransportError(error2) || !bounds || buildLocatorStrategies(step.target).length > 0) throw error2;
       lastInputError = error2;
     }
   }
@@ -330230,7 +330273,7 @@ async function executeClear(sessionId, step) {
     try {
       elementId = await findElement(sessionId, step.target, readStepTimeout(step));
     } catch (error2) {
-      if (!bounds) throw error2;
+      if (isTransportError(error2) || !bounds || buildLocatorStrategies(step.target).length > 0) throw error2;
     }
   }
   if (!elementId && bounds) {
@@ -330301,10 +330344,10 @@ async function executeHome(sessionId, platform3) {
 }
 async function executeWaitForElement(sessionId, step) {
   const timeout = readStepTimeout(step) ?? DEFAULT_STEP_TIMEOUT_MS;
-  await findElement(sessionId, step.target, timeout);
+  await findElement(sessionId, step.target, timeout, { identityOnly: true });
 }
 async function executeAssertVisible(sessionId, step) {
-  const elementId = await findElement(sessionId, step.target, readStepTimeout(step));
+  const elementId = await findElement(sessionId, step.target, readStepTimeout(step), { identityOnly: true });
   const result = await wdRequest(`/session/${sessionId}/element/${elementId}/displayed`);
   if (!result?.value) {
     throw new Error(`Element found but not visible: ${step.target?.primary ?? "unknown"}`);
@@ -330312,7 +330355,7 @@ async function executeAssertVisible(sessionId, step) {
 }
 async function executeAssertText(sessionId, step) {
   if (!step.assertion) throw new Error("assertText step requires an assertion value");
-  const elementId = await findElement(sessionId, step.target, readStepTimeout(step));
+  const elementId = await findElement(sessionId, step.target, readStepTimeout(step), { identityOnly: true });
   const result = await wdRequest(`/session/${sessionId}/element/${elementId}/text`);
   const actualText = typeof result?.value === "string" ? result.value : "";
   const textCandidates = await readElementTextCandidates(sessionId, elementId, actualText);
@@ -330347,6 +330390,7 @@ async function executeMobileTest(options) {
   const screenshots = [];
   let apiCalls = [];
   let sessionId = null;
+  let selectedDevice;
   let capture = null;
   let captureStopped = false;
   let recordingStarted = false;
@@ -330394,7 +330438,6 @@ async function executeMobileTest(options) {
         `No ${platformFilter} ${platformFilter === "IOS" ? "simulator" : "emulator"} booted. Start one via ${platformFilter === "IOS" ? "Simulator.app" : "Android Studio"} first.`
       );
     }
-    let selectedDevice;
     if (options.target.assignedDeviceId) {
       selectedDevice = matchingDevices.find((d) => d.id === options.target.assignedDeviceId);
       if (!selectedDevice) {
@@ -330435,13 +330478,15 @@ async function executeMobileTest(options) {
       log2(`Warning: Could not retrieve installed apps list. Proceeding with test execution.`);
     }
     log2(`Starting Appium session for ${options.target.appId} on ${selectedDevice.name}...`);
+    const leasedPortOffset = Math.max(0, matchingDevices.findIndex((d) => d.id === selectedDevice?.id));
     try {
       sessionId = await createSessionWithRetry({
         appId: options.target.appId,
         platform: options.target.platform,
         deviceId: selectedDevice.id,
         platformVersion: options.target.platformVersion ?? selectedDevice.platformVersion,
-        isPhysical: selectedDevice.isPhysical
+        isPhysical: selectedDevice.isPhysical,
+        portOffset: leasedPortOffset
       }, (msg) => log2(msg));
     } catch (err) {
       const base2 = err instanceof Error ? err.message : String(err);
@@ -330457,6 +330502,12 @@ async function executeMobileTest(options) {
       throw err;
     }
     log2(`Session created: ${sessionId}`);
+    if (selectedDevice.id) {
+      try {
+        options.onSessionReady?.(sessionId, selectedDevice.id, options.target.platform);
+      } catch {
+      }
+    }
     recordingStarted = await startScreenRecording(sessionId, options.target.platform, log2);
     log2("Opening a fresh app instance for the test...");
     await freshLaunchTargetApp(sessionId, options.target.platform, options.target.appId, log2);
@@ -330469,8 +330520,26 @@ async function executeMobileTest(options) {
       }
     }
     await restoreTargetAppIfExternal(sessionId, options.target, log2, "session start", false);
+    let entryDrift = false;
+    const entryStep = options.steps.find(
+      (s) => s.action !== "launchApp" && buildIdentityLocatorStrategies(s.target).length > 0
+    );
+    if (entryStep) {
+      try {
+        await findElement(sessionId, entryStep.target, DEFAULT_STEP_TIMEOUT_MS, { identityOnly: true });
+      } catch (err) {
+        if (isTransportError(err)) throw err;
+        entryDrift = true;
+        const driftMsg = `App started on an unexpected screen \u2014 the recorded flow's first element ("${entryStep.target?.primary ?? entryStep.description}") is not present, so the replay was aborted before it could blind-tap stale coordinates (screen drift; the app may be on onboarding or a different screen than when the test was recorded).`;
+        log2(`  \u2717 Entry-screen drift: ${driftMsg}`);
+        stepResults.push({ stepOrder: entryStep.order, status: "failed", duration: 0, error: driftMsg });
+        const driftShot = await takeScreenshot(sessionId).catch(() => null);
+        screenshots.push(driftShot ?? "");
+      }
+    }
     let environmental = null;
     for (const step of options.steps) {
+      if (entryDrift) break;
       const stepStart = Date.now();
       log2(`Step ${step.order}: ${step.action} - ${step.description}`);
       let status = "passed";
@@ -330548,7 +330617,7 @@ async function executeMobileTest(options) {
         break;
       }
     }
-    const allPassed = !environmental && stepResults.every((r) => r.status === "passed" || r.status === "skipped");
+    const allPassed = !environmental && stepResults.length > 0 && stepResults.every((r) => r.status === "passed" || r.status === "skipped");
     const firstError = environmental ?? (stepResults.find((r) => r.status === "failed")?.error ?? null);
     await stopCapture();
     await stopRecording();
@@ -330561,6 +330630,8 @@ async function executeMobileTest(options) {
       logs: logLines.join("\n"),
       error: firstError,
       duration: Date.now() - startTime,
+      deviceId: selectedDevice?.id,
+      deviceName: selectedDevice?.name,
       environmental: environmental ?? void 0
     };
   } catch (err) {
@@ -330577,6 +330648,8 @@ async function executeMobileTest(options) {
       logs: logLines.join("\n"),
       error: errorMsg,
       duration: Date.now() - startTime,
+      deviceId: selectedDevice?.id,
+      deviceName: selectedDevice?.name,
       // A throw before/around the step loop is a setup/environment problem
       // (no device booted, app not installed, session could not be created,
       // Appium unreachable) — never a genuine test assertion failure.
@@ -330586,6 +330659,12 @@ async function executeMobileTest(options) {
     await stopCapture();
     await stopRecording();
     if (sessionId) {
+      if (selectedDevice?.id) {
+        try {
+          options.onSessionEnding?.(selectedDevice.id);
+        } catch {
+        }
+      }
       try {
         log2("Closing the app on the device...");
         await terminateTargetApp(sessionId, options.target.platform, options.target.appId);
@@ -330644,7 +330723,9 @@ async function createMobileDiscoverySession(target, options) {
     platform: target.platform,
     deviceId: selectedDevice.id,
     platformVersion: target.platformVersion ?? selectedDevice.platformVersion,
-    isPhysical: selectedDevice.isPhysical
+    isPhysical: selectedDevice.isPhysical,
+    // Distinct control port per concurrent physical device (no-op for emulators/sims).
+    portOffset: Math.max(0, matchingDevices.findIndex((d) => d.id === selectedDevice?.id))
   });
   if (target.launchMode === "DEEP_LINK" && target.deeplink) {
     try {
@@ -330656,6 +330737,7 @@ async function createMobileDiscoverySession(target, options) {
   return {
     sessionId,
     deviceId: selectedDevice.id,
+    deviceName: selectedDevice.name,
     isPhysical: selectedDevice.isPhysical === true,
     platform: target.platform,
     appId: target.appId,
@@ -331381,7 +331463,146 @@ async function handleSessionStop(_req, res) {
   stopSessionReaper();
   sendJSON(res, 200, { ok: true });
 }
+var runnerChannels = /* @__PURE__ */ new Map();
+function readDeviceIdParam(req) {
+  try {
+    const url = new URL(req.url || "", "http://localhost");
+    const raw = url.searchParams.get("deviceId");
+    if (!raw) return null;
+    const trimmed = raw.trim();
+    if (!trimmed || trimmed.length > MAX_DEVICE_ID_LENGTH || !DEVICE_ID_PATTERN.test(trimmed)) return null;
+    return trimmed;
+  } catch {
+    return null;
+  }
+}
+async function isSessionAlive(sessionId) {
+  try {
+    validateSessionId(sessionId);
+    await appiumRequest2(`/session/${sessionId}/window/rect`);
+    return true;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return !/no such session|invalid session id|session is either terminated|deleted session/i.test(msg);
+  }
+}
+function writeFrameToChannelClient(ch, client, frame) {
+  try {
+    const buffered = typeof client.writableLength === "number" ? client.writableLength : typeof client.socket?.writableLength === "number" ? client.socket.writableLength : 0;
+    if (buffered > SSE_MAX_BUFFERED_BYTES) {
+      try {
+        client.end();
+      } catch {
+      }
+      ch.clients.delete(client);
+      stopChannelPollingIfIdle(ch);
+      return;
+    }
+    client.write(`data: ${JSON.stringify(frame)}
+
+`);
+  } catch {
+  }
+}
+async function pollRunnerChannel(ch) {
+  if (ch.clients.size === 0 || ch.polling) return;
+  ch.polling = true;
+  try {
+    validateSessionId(ch.sessionId);
+    const [screenshot, source] = await Promise.all([
+      getScreenshot(`/session/${ch.sessionId}`),
+      getPageSource(`/session/${ch.sessionId}`)
+    ]);
+    if (!screenshot && !source) {
+      ch.nullTicks++;
+      if (ch.nullTicks >= MIRROR_DEAD_SESSION_TICKS) {
+        const alive = await isSessionAlive(ch.sessionId);
+        if (!alive) {
+          closeRunnerChannel(ch);
+          return;
+        }
+        ch.nullTicks = 0;
+      }
+    } else {
+      ch.nullTicks = 0;
+    }
+    const frame = { timestamp: Date.now(), screenshot: screenshot ?? null, source: source ?? null };
+    ch.lastFrame = frame;
+    for (const client of ch.clients) writeFrameToChannelClient(ch, client, frame);
+  } catch {
+  } finally {
+    ch.polling = false;
+  }
+}
+function ensureChannelPolling(ch) {
+  if (ch.pollTimer) return;
+  ch.pollTimer = setInterval(() => {
+    void pollRunnerChannel(ch);
+  }, MOBILE_SCREENSHOT_INTERVAL_MS);
+  ch.pollTimer.unref?.();
+}
+function stopChannelPollingIfIdle(ch) {
+  if (ch.clients.size === 0 && ch.pollTimer) {
+    clearInterval(ch.pollTimer);
+    ch.pollTimer = null;
+  }
+}
+function closeRunnerChannel(ch) {
+  if (ch.pollTimer) {
+    clearInterval(ch.pollTimer);
+    ch.pollTimer = null;
+  }
+  for (const client of ch.clients) {
+    try {
+      client.end();
+    } catch {
+    }
+  }
+  ch.clients.clear();
+  ch.lastFrame = null;
+  runnerChannels.delete(ch.deviceId);
+}
+function closeAllRunnerChannels() {
+  for (const ch of [...runnerChannels.values()]) closeRunnerChannel(ch);
+}
+async function serveRunnerMirror(req, res, ch) {
+  res.writeHead(200, {
+    "Content-Type": "text/event-stream",
+    "Cache-Control": "no-cache",
+    "Connection": "keep-alive",
+    "Access-Control-Allow-Origin": getAllowedOrigin(req),
+    "X-Content-Type-Options": "nosniff"
+  });
+  ch.clients.add(res);
+  ensureChannelPolling(ch);
+  if (ch.lastFrame) {
+    writeFrameToChannelClient(ch, res, ch.lastFrame);
+  } else {
+    await pollRunnerChannel(ch);
+  }
+  req.on("close", () => {
+    ch.clients.delete(res);
+    stopChannelPollingIfIdle(ch);
+  });
+}
 async function handleMirror(req, res) {
+  const deviceId = readDeviceIdParam(req);
+  if (deviceId) {
+    const ch = runnerChannels.get(deviceId);
+    if (ch) {
+      await serveRunnerMirror(req, res, ch);
+      return;
+    }
+    sendJSON(res, 404, { error: `No live mirror for device ${deviceId}.` });
+    return;
+  }
+  if (!state.appiumSessionId && runnerChannels.size === 1) {
+    const soleChannel = runnerChannels.values().next().value;
+    if (soleChannel) {
+      await serveRunnerMirror(req, res, soleChannel);
+      return;
+    }
+  }
   if (!state.appiumSessionId) {
     sendJSON(res, 400, { error: "No active Appium session. Call /bridge/session/start first." });
     return;
@@ -331828,6 +332049,7 @@ async function startMobileBridge(options) {
 }
 async function stopMobileBridge() {
   stopAllMirrorClients();
+  closeAllRunnerChannels();
   stopSessionReaper();
   clearBridgePidFile();
   if (state.appiumSessionId) {
@@ -331876,8 +332098,31 @@ function getBridgeState() {
 function setExecutorBusy(busy) {
   executorBusyCount = busy ? executorBusyCount + 1 : Math.max(0, executorBusyCount - 1);
 }
-function attachMirrorSession(sessionId, platform3) {
+function attachMirrorSession(sessionId, platform3, deviceId) {
   validateSessionId(sessionId);
+  if (deviceId) {
+    const existing = runnerChannels.get(deviceId);
+    if (existing && existing.sessionId !== sessionId) closeRunnerChannel(existing);
+    const ch = runnerChannels.get(deviceId) ?? {
+      deviceId,
+      sessionId,
+      platform: platform3,
+      clients: /* @__PURE__ */ new Set(),
+      lastFrame: null,
+      pollTimer: null,
+      nullTicks: 0,
+      polling: false
+    };
+    ch.sessionId = sessionId;
+    ch.platform = platform3;
+    ch.nullTicks = 0;
+    runnerChannels.set(deviceId, ch);
+    if (ch.clients.size > 0) {
+      ensureChannelPolling(ch);
+      void pollRunnerChannel(ch);
+    }
+    return;
+  }
   if (state.appiumSessionId && state.appiumSessionId !== sessionId) {
     stopAllMirrorClients();
   }
@@ -331892,8 +332137,12 @@ function attachMirrorSession(sessionId, platform3) {
     void pollAndBroadcastFrame();
   }
 }
-function detachMirrorSession(sessionId) {
-  if (sessionId && state.appiumSessionId && state.appiumSessionId !== sessionId) return;
+function detachMirrorSession(deviceId) {
+  if (deviceId) {
+    const ch = runnerChannels.get(deviceId);
+    if (ch) closeRunnerChannel(ch);
+    return;
+  }
   state.appiumSessionId = null;
   state.platform = null;
   mirrorSessionOwner = null;
@@ -334079,7 +334328,8 @@ ${finalVerifyResult.logs ?? ""}`;
             testName: ctx.featureName ?? "Mobile discovery",
             note: `${platform3} mobile discovery`,
             surface: "mobile",
-            mobilePlatform: platform3
+            mobilePlatform: platform3,
+            ...assignedDeviceId ? { deviceId: assignedDeviceId } : {}
           });
           requestLiveBrowserHeartbeat(true);
           mobileOnLog(`Mobile discovery (${ctx.mode}) \u2014 ${platform3} / ${mobileTarget.appId}`);
@@ -334097,6 +334347,7 @@ ${finalVerifyResult.logs ?? ""}`;
               deeplink: mobileTarget.deeplink
             }, {
               onDeviceSelected: async (device) => {
+                liveBrowserHandle.patch({ deviceId: device.deviceId, deviceName: device.name });
                 try {
                   capture = await startMobileNetworkCapture({
                     platform: platform3,
@@ -334115,7 +334366,7 @@ ${finalVerifyResult.logs ?? ""}`;
               }
             });
             mobileOnLog(`Appium session created: ${session.sessionId} on device ${session.deviceId}`);
-            attachMirrorSession(session.sessionId, platform3);
+            attachMirrorSession(session.sessionId, platform3, session.deviceId);
             const driver = new MobileBridgeDriver({
               sessionId: session.sessionId,
               platform: platform3,
@@ -334159,7 +334410,7 @@ ${finalVerifyResult.logs ?? ""}`;
               }
             }
             if (session) {
-              detachMirrorSession(session.sessionId);
+              detachMirrorSession(session.deviceId);
               try {
                 await session.stop();
               } catch {
@@ -334436,6 +334687,14 @@ ${finalVerifyResult.logs ?? ""}`;
         return;
       }
       log.info(`\u{1F4F1} Mobile test - ${target.platform} / ${target.appId}`);
+      const leasedDeviceName = assignedDeviceId ? getCachedDeviceSnapshot().find((d) => d.id === assignedDeviceId)?.name : void 0;
+      liveBrowserHandle.patch({
+        surface: "mobile",
+        mobilePlatform: target.platform,
+        ...assignedDeviceId ? { deviceId: assignedDeviceId } : {},
+        ...leasedDeviceName ? { deviceName: leasedDeviceName } : {}
+      });
+      requestLiveBrowserHeartbeat(true);
       const mobileSteps = run2.steps ?? [];
       if (mobileSteps.length === 0) {
         await postResult(opts.serverUrl, headers, run2.runId, {
@@ -334464,6 +334723,15 @@ ${finalVerifyResult.logs ?? ""}`;
               assignedDeviceId,
               launchMode: target.launchMode,
               deeplink: target.deeplink
+            },
+            // Stream this run to its OWN per-device dashboard tile (keyed by the
+            // leased device id) so N parallel Appium runs each show a live mirror.
+            onSessionReady: (sessionId, deviceId, sessionPlatform) => {
+              attachMirrorSession(sessionId, sessionPlatform, deviceId);
+              requestLiveBrowserHeartbeat(true);
+            },
+            onSessionEnding: (deviceId) => {
+              detachMirrorSession(deviceId);
             }
           });
           attemptLogs.push(`--- Appium attempt ${attempt + 1}/${maxRetries + 1} ---
@@ -334479,6 +334747,12 @@ ${result2.logs}`);
       if (attemptLogs.length > 1) {
         result2 = { ...result2, logs: attemptLogs.join("\n\n") };
       }
+      if (result2.deviceId || result2.deviceName) {
+        liveBrowserHandle.patch({
+          ...result2.deviceId ? { deviceId: result2.deviceId } : {},
+          ...result2.deviceName ? { deviceName: result2.deviceName } : {}
+        });
+      }
       const duration2 = Date.now() - startTime;
       const status = result2.environmental ? "ERROR" : result2.passed ? "PASSED" : "FAILED";
       const reportedError = result2.environmental ? `CONFIG_ISSUE: ${result2.environmental}` : result2.error ?? void 0;

package/dist/cli.mjs

@@ -66797,16 +66797,16 @@ ${statePacket}` },
       }
       const screen = screenName();
       if (accessibilityId) {
-        const bundle2 = { xpath: `//*[@content-desc=${xpathLiteral(accessibilityId)} or @name=${xpathLiteral(accessibilityId)}]`, className: "", accessibilityId };
+        const bundle2 = { xpath: `//*[@content-desc=${xpathLiteral2(accessibilityId)} or @name=${xpathLiteral2(accessibilityId)}]`, className: "", accessibilityId };
         recordAction({ type: "ASSERT_VISIBLE", selector: accessibilityId, metadata: { screenName: screen, targetLabel: accessibilityId, locatorBundle: bundle2 } });
         return { ok: true, label: accessibilityId };
       }
       const safeText = text;
-      const bundle = { xpath: `//*[@text=${xpathLiteral(safeText)} or @label=${xpathLiteral(safeText)}]`, className: "", text: safeText };
+      const bundle = { xpath: `//*[@text=${xpathLiteral2(safeText)} or @label=${xpathLiteral2(safeText)}]`, className: "", text: safeText };
       recordAction({ type: "ASSERT_VISIBLE", selector: bundle.xpath, metadata: { screenName: screen, targetLabel: safeText, locatorBundle: bundle } });
       return { ok: true, label: safeText };
     }
-    function xpathLiteral(value) {
+    function xpathLiteral2(value) {
       if (!value.includes("'"))
         return `'${value}'`;
       if (!value.includes('"'))
@@ -328123,7 +328123,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.15",
+      version: "1.0.16",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -329731,7 +329731,7 @@ async function getWindowSize(sessionId, retries = 3) {
   }
   throw new Error("Failed to get window size: invalid dimensions returned");
 }
-function realDeviceCapabilities(platform3) {
+function realDeviceCapabilities(platform3, portOffset = 0) {
   const env = process.env;
   const caps = {};
   const num = (v) => {
@@ -329739,6 +329739,7 @@ function realDeviceCapabilities(platform3) {
     const n = Number.parseInt(v, 10);
     return Number.isFinite(n) ? n : void 0;
   };
+  const offset = Number.isFinite(portOffset) && portOffset > 0 ? Math.floor(portOffset) : 0;
   if (platform3 === "IOS") {
     if (env.APPIUM_XCODE_ORG_ID) {
       caps["appium:xcodeOrgId"] = env.APPIUM_XCODE_ORG_ID;
@@ -329748,15 +329749,15 @@ function realDeviceCapabilities(platform3) {
     }
     if (env.APPIUM_UPDATED_WDA_BUNDLE_ID) caps["appium:updatedWDABundleId"] = env.APPIUM_UPDATED_WDA_BUNDLE_ID;
     const wdaPort = num(env.APPIUM_WDA_LOCAL_PORT);
-    if (wdaPort !== void 0) caps["appium:wdaLocalPort"] = wdaPort;
+    if (wdaPort !== void 0) caps["appium:wdaLocalPort"] = wdaPort + offset;
   } else {
     const systemPort = num(env.APPIUM_SYSTEM_PORT);
-    if (systemPort !== void 0) caps["appium:systemPort"] = systemPort;
+    if (systemPort !== void 0) caps["appium:systemPort"] = systemPort + offset;
   }
   return caps;
 }
 async function createSession(target) {
-  const realCaps = target.isPhysical ? realDeviceCapabilities(target.platform) : {};
+  const realCaps = target.isPhysical ? realDeviceCapabilities(target.platform, target.portOffset) : {};
   const capabilities = target.platform === "IOS" ? {
     platformName: "iOS",
     "appium:automationName": "XCUITest",
@@ -330031,6 +330032,46 @@ function buildLocatorStrategies(target) {
     (strategy, index, list) => list.findIndex((candidate) => candidate.using === strategy.using && candidate.value === strategy.value) === index
   );
 }
+function dedupeStrategies(strategies) {
+  return strategies.filter(
+    (strategy, index, list) => list.findIndex((candidate) => candidate.using === strategy.using && candidate.value === strategy.value) === index
+  );
+}
+function xpathLiteral(value) {
+  if (!value.includes("'")) return `'${value}'`;
+  if (!value.includes('"')) return `"${value}"`;
+  const parts = value.split("'").map((p) => `'${p}'`);
+  return `concat(${parts.join(`, "'", `)})`;
+}
+function identityTextXpath(value) {
+  const lit = xpathLiteral(value);
+  return `//*[@text=${lit} or @content-desc=${lit} or @label=${lit} or @name=${lit} or @value=${lit}]`;
+}
+function isIdentityStrategy(strategy) {
+  if (strategy.using === "accessibility id" || strategy.using === "id") return true;
+  if (strategy.using === "xpath") return strategy.value.includes("@");
+  return false;
+}
+function buildIdentityLocatorStrategies(target) {
+  if (!target) return [];
+  const strategies = [];
+  const bundle = target.locatorBundle;
+  if (bundle) {
+    if (bundle.accessibilityId) strategies.push({ using: "accessibility id", value: bundle.accessibilityId });
+    if (bundle.resourceId) strategies.push({ using: "id", value: bundle.resourceId });
+    for (const value of [bundle.text, bundle.contentDesc]) {
+      const trimmed = value?.trim();
+      if (trimmed) strategies.push({ using: "xpath", value: identityTextXpath(trimmed) });
+    }
+    if (bundle.xpath && bundle.xpath.includes("@")) strategies.push({ using: "xpath", value: bundle.xpath });
+  }
+  for (const value of [target.primary, ...target.fallbacks ?? []]) {
+    for (const strategy of locatorStrategyForValue(value)) {
+      if (isIdentityStrategy(strategy)) strategies.push(strategy);
+    }
+  }
+  return dedupeStrategies(strategies);
+}
 function readStepTimeout(step) {
   const value = step.metadata?.timeout;
   if (typeof value === "number" && Number.isFinite(value) && value > 0) {
@@ -330038,10 +330079,12 @@ function readStepTimeout(step) {
   }
   return void 0;
 }
-async function findElement(sessionId, target, timeoutMs = DEFAULT_STEP_TIMEOUT_MS) {
-  const strategies = buildLocatorStrategies(target);
+async function findElement(sessionId, target, timeoutMs = DEFAULT_STEP_TIMEOUT_MS, opts) {
+  const strategies = opts?.identityOnly ? buildIdentityLocatorStrategies(target) : buildLocatorStrategies(target);
   if (strategies.length === 0) {
-    throw new Error("No locator strategies available for this step");
+    throw new Error(
+      opts?.identityOnly ? "No identity locator (accessibility id / resource id / text) available for this step \u2014 cannot verify the screen" : "No locator strategies available for this step"
+    );
   }
   const startTime = Date.now();
   let lastError = "";
@@ -330150,7 +330193,7 @@ async function executeTap(sessionId, step) {
       });
       return;
     } catch (error2) {
-      if (!bounds) throw error2;
+      if (isTransportError(error2) || !bounds || buildLocatorStrategies(step.target).length > 0) throw error2;
     }
   }
   if (!bounds) {
@@ -330183,7 +330226,7 @@ async function executeType(sessionId, step, context) {
       if (!lastInputError) return;
       elementId = null;
     } catch (error2) {
-      if (!bounds) throw error2;
+      if (isTransportError(error2) || !bounds || buildLocatorStrategies(step.target).length > 0) throw error2;
       lastInputError = error2;
     }
   }
@@ -330238,7 +330281,7 @@ async function executeClear(sessionId, step) {
     try {
       elementId = await findElement(sessionId, step.target, readStepTimeout(step));
     } catch (error2) {
-      if (!bounds) throw error2;
+      if (isTransportError(error2) || !bounds || buildLocatorStrategies(step.target).length > 0) throw error2;
     }
   }
   if (!elementId && bounds) {
@@ -330309,10 +330352,10 @@ async function executeHome(sessionId, platform3) {
 }
 async function executeWaitForElement(sessionId, step) {
   const timeout = readStepTimeout(step) ?? DEFAULT_STEP_TIMEOUT_MS;
-  await findElement(sessionId, step.target, timeout);
+  await findElement(sessionId, step.target, timeout, { identityOnly: true });
 }
 async function executeAssertVisible(sessionId, step) {
-  const elementId = await findElement(sessionId, step.target, readStepTimeout(step));
+  const elementId = await findElement(sessionId, step.target, readStepTimeout(step), { identityOnly: true });
   const result = await wdRequest(`/session/${sessionId}/element/${elementId}/displayed`);
   if (!result?.value) {
     throw new Error(`Element found but not visible: ${step.target?.primary ?? "unknown"}`);
@@ -330320,7 +330363,7 @@ async function executeAssertVisible(sessionId, step) {
 }
 async function executeAssertText(sessionId, step) {
   if (!step.assertion) throw new Error("assertText step requires an assertion value");
-  const elementId = await findElement(sessionId, step.target, readStepTimeout(step));
+  const elementId = await findElement(sessionId, step.target, readStepTimeout(step), { identityOnly: true });
   const result = await wdRequest(`/session/${sessionId}/element/${elementId}/text`);
   const actualText = typeof result?.value === "string" ? result.value : "";
   const textCandidates = await readElementTextCandidates(sessionId, elementId, actualText);
@@ -330355,6 +330398,7 @@ async function executeMobileTest(options) {
   const screenshots = [];
   let apiCalls = [];
   let sessionId = null;
+  let selectedDevice;
   let capture = null;
   let captureStopped = false;
   let recordingStarted = false;
@@ -330402,7 +330446,6 @@ async function executeMobileTest(options) {
         `No ${platformFilter} ${platformFilter === "IOS" ? "simulator" : "emulator"} booted. Start one via ${platformFilter === "IOS" ? "Simulator.app" : "Android Studio"} first.`
       );
     }
-    let selectedDevice;
     if (options.target.assignedDeviceId) {
       selectedDevice = matchingDevices.find((d) => d.id === options.target.assignedDeviceId);
       if (!selectedDevice) {
@@ -330443,13 +330486,15 @@ async function executeMobileTest(options) {
       log2(`Warning: Could not retrieve installed apps list. Proceeding with test execution.`);
     }
     log2(`Starting Appium session for ${options.target.appId} on ${selectedDevice.name}...`);
+    const leasedPortOffset = Math.max(0, matchingDevices.findIndex((d) => d.id === selectedDevice?.id));
     try {
       sessionId = await createSessionWithRetry({
         appId: options.target.appId,
         platform: options.target.platform,
         deviceId: selectedDevice.id,
         platformVersion: options.target.platformVersion ?? selectedDevice.platformVersion,
-        isPhysical: selectedDevice.isPhysical
+        isPhysical: selectedDevice.isPhysical,
+        portOffset: leasedPortOffset
       }, (msg) => log2(msg));
     } catch (err) {
       const base2 = err instanceof Error ? err.message : String(err);
@@ -330465,6 +330510,12 @@ async function executeMobileTest(options) {
       throw err;
     }
     log2(`Session created: ${sessionId}`);
+    if (selectedDevice.id) {
+      try {
+        options.onSessionReady?.(sessionId, selectedDevice.id, options.target.platform);
+      } catch {
+      }
+    }
     recordingStarted = await startScreenRecording(sessionId, options.target.platform, log2);
     log2("Opening a fresh app instance for the test...");
     await freshLaunchTargetApp(sessionId, options.target.platform, options.target.appId, log2);
@@ -330477,8 +330528,26 @@ async function executeMobileTest(options) {
       }
     }
     await restoreTargetAppIfExternal(sessionId, options.target, log2, "session start", false);
+    let entryDrift = false;
+    const entryStep = options.steps.find(
+      (s) => s.action !== "launchApp" && buildIdentityLocatorStrategies(s.target).length > 0
+    );
+    if (entryStep) {
+      try {
+        await findElement(sessionId, entryStep.target, DEFAULT_STEP_TIMEOUT_MS, { identityOnly: true });
+      } catch (err) {
+        if (isTransportError(err)) throw err;
+        entryDrift = true;
+        const driftMsg = `App started on an unexpected screen \u2014 the recorded flow's first element ("${entryStep.target?.primary ?? entryStep.description}") is not present, so the replay was aborted before it could blind-tap stale coordinates (screen drift; the app may be on onboarding or a different screen than when the test was recorded).`;
+        log2(`  \u2717 Entry-screen drift: ${driftMsg}`);
+        stepResults.push({ stepOrder: entryStep.order, status: "failed", duration: 0, error: driftMsg });
+        const driftShot = await takeScreenshot(sessionId).catch(() => null);
+        screenshots.push(driftShot ?? "");
+      }
+    }
     let environmental = null;
     for (const step of options.steps) {
+      if (entryDrift) break;
       const stepStart = Date.now();
       log2(`Step ${step.order}: ${step.action} - ${step.description}`);
       let status = "passed";
@@ -330556,7 +330625,7 @@ async function executeMobileTest(options) {
         break;
       }
     }
-    const allPassed = !environmental && stepResults.every((r) => r.status === "passed" || r.status === "skipped");
+    const allPassed = !environmental && stepResults.length > 0 && stepResults.every((r) => r.status === "passed" || r.status === "skipped");
     const firstError = environmental ?? (stepResults.find((r) => r.status === "failed")?.error ?? null);
     await stopCapture();
     await stopRecording();
@@ -330569,6 +330638,8 @@ async function executeMobileTest(options) {
       logs: logLines.join("\n"),
       error: firstError,
       duration: Date.now() - startTime,
+      deviceId: selectedDevice?.id,
+      deviceName: selectedDevice?.name,
       environmental: environmental ?? void 0
     };
   } catch (err) {
@@ -330585,6 +330656,8 @@ async function executeMobileTest(options) {
       logs: logLines.join("\n"),
       error: errorMsg,
       duration: Date.now() - startTime,
+      deviceId: selectedDevice?.id,
+      deviceName: selectedDevice?.name,
       // A throw before/around the step loop is a setup/environment problem
       // (no device booted, app not installed, session could not be created,
       // Appium unreachable) — never a genuine test assertion failure.
@@ -330594,6 +330667,12 @@ async function executeMobileTest(options) {
     await stopCapture();
     await stopRecording();
     if (sessionId) {
+      if (selectedDevice?.id) {
+        try {
+          options.onSessionEnding?.(selectedDevice.id);
+        } catch {
+        }
+      }
       try {
         log2("Closing the app on the device...");
         await terminateTargetApp(sessionId, options.target.platform, options.target.appId);
@@ -330652,7 +330731,9 @@ async function createMobileDiscoverySession(target, options) {
     platform: target.platform,
     deviceId: selectedDevice.id,
     platformVersion: target.platformVersion ?? selectedDevice.platformVersion,
-    isPhysical: selectedDevice.isPhysical
+    isPhysical: selectedDevice.isPhysical,
+    // Distinct control port per concurrent physical device (no-op for emulators/sims).
+    portOffset: Math.max(0, matchingDevices.findIndex((d) => d.id === selectedDevice?.id))
   });
   if (target.launchMode === "DEEP_LINK" && target.deeplink) {
     try {
@@ -330664,6 +330745,7 @@ async function createMobileDiscoverySession(target, options) {
   return {
     sessionId,
     deviceId: selectedDevice.id,
+    deviceName: selectedDevice.name,
     isPhysical: selectedDevice.isPhysical === true,
     platform: target.platform,
     appId: target.appId,
@@ -331389,7 +331471,146 @@ async function handleSessionStop(_req, res) {
   stopSessionReaper();
   sendJSON(res, 200, { ok: true });
 }
+var runnerChannels = /* @__PURE__ */ new Map();
+function readDeviceIdParam(req) {
+  try {
+    const url = new URL(req.url || "", "http://localhost");
+    const raw = url.searchParams.get("deviceId");
+    if (!raw) return null;
+    const trimmed = raw.trim();
+    if (!trimmed || trimmed.length > MAX_DEVICE_ID_LENGTH || !DEVICE_ID_PATTERN.test(trimmed)) return null;
+    return trimmed;
+  } catch {
+    return null;
+  }
+}
+async function isSessionAlive(sessionId) {
+  try {
+    validateSessionId(sessionId);
+    await appiumRequest2(`/session/${sessionId}/window/rect`);
+    return true;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return !/no such session|invalid session id|session is either terminated|deleted session/i.test(msg);
+  }
+}
+function writeFrameToChannelClient(ch, client, frame) {
+  try {
+    const buffered = typeof client.writableLength === "number" ? client.writableLength : typeof client.socket?.writableLength === "number" ? client.socket.writableLength : 0;
+    if (buffered > SSE_MAX_BUFFERED_BYTES) {
+      try {
+        client.end();
+      } catch {
+      }
+      ch.clients.delete(client);
+      stopChannelPollingIfIdle(ch);
+      return;
+    }
+    client.write(`data: ${JSON.stringify(frame)}
+
+`);
+  } catch {
+  }
+}
+async function pollRunnerChannel(ch) {
+  if (ch.clients.size === 0 || ch.polling) return;
+  ch.polling = true;
+  try {
+    validateSessionId(ch.sessionId);
+    const [screenshot, source] = await Promise.all([
+      getScreenshot(`/session/${ch.sessionId}`),
+      getPageSource(`/session/${ch.sessionId}`)
+    ]);
+    if (!screenshot && !source) {
+      ch.nullTicks++;
+      if (ch.nullTicks >= MIRROR_DEAD_SESSION_TICKS) {
+        const alive = await isSessionAlive(ch.sessionId);
+        if (!alive) {
+          closeRunnerChannel(ch);
+          return;
+        }
+        ch.nullTicks = 0;
+      }
+    } else {
+      ch.nullTicks = 0;
+    }
+    const frame = { timestamp: Date.now(), screenshot: screenshot ?? null, source: source ?? null };
+    ch.lastFrame = frame;
+    for (const client of ch.clients) writeFrameToChannelClient(ch, client, frame);
+  } catch {
+  } finally {
+    ch.polling = false;
+  }
+}
+function ensureChannelPolling(ch) {
+  if (ch.pollTimer) return;
+  ch.pollTimer = setInterval(() => {
+    void pollRunnerChannel(ch);
+  }, MOBILE_SCREENSHOT_INTERVAL_MS);
+  ch.pollTimer.unref?.();
+}
+function stopChannelPollingIfIdle(ch) {
+  if (ch.clients.size === 0 && ch.pollTimer) {
+    clearInterval(ch.pollTimer);
+    ch.pollTimer = null;
+  }
+}
+function closeRunnerChannel(ch) {
+  if (ch.pollTimer) {
+    clearInterval(ch.pollTimer);
+    ch.pollTimer = null;
+  }
+  for (const client of ch.clients) {
+    try {
+      client.end();
+    } catch {
+    }
+  }
+  ch.clients.clear();
+  ch.lastFrame = null;
+  runnerChannels.delete(ch.deviceId);
+}
+function closeAllRunnerChannels() {
+  for (const ch of [...runnerChannels.values()]) closeRunnerChannel(ch);
+}
+async function serveRunnerMirror(req, res, ch) {
+  res.writeHead(200, {
+    "Content-Type": "text/event-stream",
+    "Cache-Control": "no-cache",
+    "Connection": "keep-alive",
+    "Access-Control-Allow-Origin": getAllowedOrigin(req),
+    "X-Content-Type-Options": "nosniff"
+  });
+  ch.clients.add(res);
+  ensureChannelPolling(ch);
+  if (ch.lastFrame) {
+    writeFrameToChannelClient(ch, res, ch.lastFrame);
+  } else {
+    await pollRunnerChannel(ch);
+  }
+  req.on("close", () => {
+    ch.clients.delete(res);
+    stopChannelPollingIfIdle(ch);
+  });
+}
 async function handleMirror(req, res) {
+  const deviceId = readDeviceIdParam(req);
+  if (deviceId) {
+    const ch = runnerChannels.get(deviceId);
+    if (ch) {
+      await serveRunnerMirror(req, res, ch);
+      return;
+    }
+    sendJSON(res, 404, { error: `No live mirror for device ${deviceId}.` });
+    return;
+  }
+  if (!state.appiumSessionId && runnerChannels.size === 1) {
+    const soleChannel = runnerChannels.values().next().value;
+    if (soleChannel) {
+      await serveRunnerMirror(req, res, soleChannel);
+      return;
+    }
+  }
   if (!state.appiumSessionId) {
     sendJSON(res, 400, { error: "No active Appium session. Call /bridge/session/start first." });
     return;
@@ -331836,6 +332057,7 @@ async function startMobileBridge(options) {
 }
 async function stopMobileBridge() {
   stopAllMirrorClients();
+  closeAllRunnerChannels();
   stopSessionReaper();
   clearBridgePidFile();
   if (state.appiumSessionId) {
@@ -331884,8 +332106,31 @@ function getBridgeState() {
 function setExecutorBusy(busy) {
   executorBusyCount = busy ? executorBusyCount + 1 : Math.max(0, executorBusyCount - 1);
 }
-function attachMirrorSession(sessionId, platform3) {
+function attachMirrorSession(sessionId, platform3, deviceId) {
   validateSessionId(sessionId);
+  if (deviceId) {
+    const existing = runnerChannels.get(deviceId);
+    if (existing && existing.sessionId !== sessionId) closeRunnerChannel(existing);
+    const ch = runnerChannels.get(deviceId) ?? {
+      deviceId,
+      sessionId,
+      platform: platform3,
+      clients: /* @__PURE__ */ new Set(),
+      lastFrame: null,
+      pollTimer: null,
+      nullTicks: 0,
+      polling: false
+    };
+    ch.sessionId = sessionId;
+    ch.platform = platform3;
+    ch.nullTicks = 0;
+    runnerChannels.set(deviceId, ch);
+    if (ch.clients.size > 0) {
+      ensureChannelPolling(ch);
+      void pollRunnerChannel(ch);
+    }
+    return;
+  }
   if (state.appiumSessionId && state.appiumSessionId !== sessionId) {
     stopAllMirrorClients();
   }
@@ -331900,8 +332145,12 @@ function attachMirrorSession(sessionId, platform3) {
     void pollAndBroadcastFrame();
   }
 }
-function detachMirrorSession(sessionId) {
-  if (sessionId && state.appiumSessionId && state.appiumSessionId !== sessionId) return;
+function detachMirrorSession(deviceId) {
+  if (deviceId) {
+    const ch = runnerChannels.get(deviceId);
+    if (ch) closeRunnerChannel(ch);
+    return;
+  }
   state.appiumSessionId = null;
   state.platform = null;
   mirrorSessionOwner = null;
@@ -334087,7 +334336,8 @@ ${finalVerifyResult.logs ?? ""}`;
             testName: ctx.featureName ?? "Mobile discovery",
             note: `${platform3} mobile discovery`,
             surface: "mobile",
-            mobilePlatform: platform3
+            mobilePlatform: platform3,
+            ...assignedDeviceId ? { deviceId: assignedDeviceId } : {}
           });
           requestLiveBrowserHeartbeat(true);
           mobileOnLog(`Mobile discovery (${ctx.mode}) \u2014 ${platform3} / ${mobileTarget.appId}`);
@@ -334105,6 +334355,7 @@ ${finalVerifyResult.logs ?? ""}`;
               deeplink: mobileTarget.deeplink
             }, {
               onDeviceSelected: async (device) => {
+                liveBrowserHandle.patch({ deviceId: device.deviceId, deviceName: device.name });
                 try {
                   capture = await startMobileNetworkCapture({
                     platform: platform3,
@@ -334123,7 +334374,7 @@ ${finalVerifyResult.logs ?? ""}`;
               }
             });
             mobileOnLog(`Appium session created: ${session.sessionId} on device ${session.deviceId}`);
-            attachMirrorSession(session.sessionId, platform3);
+            attachMirrorSession(session.sessionId, platform3, session.deviceId);
             const driver = new MobileBridgeDriver({
               sessionId: session.sessionId,
               platform: platform3,
@@ -334167,7 +334418,7 @@ ${finalVerifyResult.logs ?? ""}`;
               }
             }
             if (session) {
-              detachMirrorSession(session.sessionId);
+              detachMirrorSession(session.deviceId);
               try {
                 await session.stop();
               } catch {
@@ -334444,6 +334695,14 @@ ${finalVerifyResult.logs ?? ""}`;
         return;
       }
       log.info(`\u{1F4F1} Mobile test - ${target.platform} / ${target.appId}`);
+      const leasedDeviceName = assignedDeviceId ? getCachedDeviceSnapshot().find((d) => d.id === assignedDeviceId)?.name : void 0;
+      liveBrowserHandle.patch({
+        surface: "mobile",
+        mobilePlatform: target.platform,
+        ...assignedDeviceId ? { deviceId: assignedDeviceId } : {},
+        ...leasedDeviceName ? { deviceName: leasedDeviceName } : {}
+      });
+      requestLiveBrowserHeartbeat(true);
       const mobileSteps = run2.steps ?? [];
       if (mobileSteps.length === 0) {
         await postResult(opts.serverUrl, headers, run2.runId, {
@@ -334472,6 +334731,15 @@ ${finalVerifyResult.logs ?? ""}`;
               assignedDeviceId,
               launchMode: target.launchMode,
               deeplink: target.deeplink
+            },
+            // Stream this run to its OWN per-device dashboard tile (keyed by the
+            // leased device id) so N parallel Appium runs each show a live mirror.
+            onSessionReady: (sessionId, deviceId, sessionPlatform) => {
+              attachMirrorSession(sessionId, sessionPlatform, deviceId);
+              requestLiveBrowserHeartbeat(true);
+            },
+            onSessionEnding: (deviceId) => {
+              detachMirrorSession(deviceId);
             }
           });
           attemptLogs.push(`--- Appium attempt ${attempt + 1}/${maxRetries + 1} ---
@@ -334487,6 +334755,12 @@ ${result2.logs}`);
       if (attemptLogs.length > 1) {
         result2 = { ...result2, logs: attemptLogs.join("\n\n") };
       }
+      if (result2.deviceId || result2.deviceName) {
+        liveBrowserHandle.patch({
+          ...result2.deviceId ? { deviceId: result2.deviceId } : {},
+          ...result2.deviceName ? { deviceName: result2.deviceName } : {}
+        });
+      }
       const duration2 = Date.now() - startTime;
       const status = result2.environmental ? "ERROR" : result2.passed ? "PASSED" : "FAILED";
       const reportedError = result2.environmental ? `CONFIG_ISSUE: ${result2.environmental}` : result2.error ?? void 0;

package/package.json

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