react-native-ai-devtools 1.4.16 → 1.4.18

package/build/pro/tap.js

@@ -1,7 +1,7 @@
 import { connectedApps, imageBuffer } from "../core/state.js";
 import { executeInApp } from "../core/executor.js";
 import { pressElement } from "../core/executor.js";
-import { iosTap, iosFindElement, iosScreenshot, getActiveOrBootedSimulatorUdid, findSimulatorByName, isIdbAvailable } from "../core/ios.js";
+import { iosTap, iosFindElement, iosScreenshot, getActiveOrBootedSimulatorUdid, findSimulatorByName, isUiDriverAvailable, getUiDriverInstallHint } from "../core/ios.js";
 import { androidTap, androidFindElement, getDefaultAndroidDevice, androidScreenshot } from "../core/android.js";
 import { compareScreenshots } from "./screenshot-diff.js";
 import { scanMetroPorts, fetchDevices, selectMainDevice } from "../core/metro.js";
@@ -32,7 +32,7 @@ export async function analyzeBurstFrames(frames, options) {
             transientChangeDetected: false,
             peakChangeRate: 0,
             peakFrame: 0,
-            framesWithChange: [],
+            framesWithChange: []
         };
     }
     let peakChangeRate = 0;
@@ -58,7 +58,7 @@ export async function analyzeBurstFrames(frames, options) {
         transientChangeDetected,
         peakChangeRate,
         peakFrame,
-        framesWithChange,
+        framesWithChange
     };
 }
 // --- Helpers ---
@@ -131,7 +131,7 @@ export function convertScreenshotToTapCoords(pixelX, pixelY, platform, devicePix
     }
     return {
         x: Math.round(deviceX / devicePixelRatio),
-        y: Math.round(deviceY / devicePixelRatio),
+        y: Math.round(deviceY / devicePixelRatio)
     };
 }
 /** @deprecated Use convertScreenshotToTapCoords instead */
@@ -219,7 +219,7 @@ export function formatTapSuccess(data) {
         success: true,
         ...rest,
         ...(verification && { verification }),
-        ...(screenshot && { screenshot }),
+        ...(screenshot && { screenshot })
     };
 }
 export function formatTapFailure(data) {
@@ -240,7 +240,7 @@ export function formatTapFailure(data) {
         ...(data.device && { device: data.device }),
         ...(data.verification && { verification: data.verification }),
         ...(data.screenshot && { screenshot: data.screenshot }),
-        ...(warning && { warning }),
+        ...(warning && { warning })
     };
 }
 function buildErrorMessage(query) {
@@ -282,7 +282,7 @@ async function tryFiberAtDepth(query, index, maxTraversalDepth) {
             testID: query.testID,
             component: query.component,
             index,
-            maxTraversalDepth,
+            maxTraversalDepth
         });
         if (!result.success) {
             return { success: false, reason: result.error || "pressElement failed" };
@@ -294,7 +294,7 @@ async function tryFiberAtDepth(query, index, maxTraversalDepth) {
         if (parsed.error) {
             const strategyResult = {
                 success: false,
-                reason: parsed.error,
+                reason: parsed.error
             };
             if (parsed.matches) {
                 strategyResult.matches = parsed.matches;
@@ -318,22 +318,25 @@ async function tryFiberAtDepth(query, index, maxTraversalDepth) {
                     convertedTo: {
                         x: parsed.nativeTapTarget.x,
                         y: parsed.nativeTapTarget.y,
-                        unit: parsed.nativeTapTarget.unit || "points",
-                    },
+                        unit: parsed.nativeTapTarget.unit || "points"
+                    }
                 };
             }
             return {
                 success: false,
-                reason: `Found ${parsed.pressed} (${elementType}) but could not measure coordinates — falling through to next strategy`,
+                reason: `Found ${parsed.pressed} (${elementType}) but could not measure coordinates — falling through to next strategy`
             };
         }
         // All elements now use needsNativeTap — this shouldn't be reached
-        return { success: false, reason: "Unexpected: element did not request native tap" };
+        return {
+            success: false,
+            reason: "Unexpected: element did not request native tap"
+        };
     }
     catch (err) {
         return {
             success: false,
-            reason: `Fiber strategy error: ${err instanceof Error ? err.message : String(err)}`,
+            reason: `Fiber strategy error: ${err instanceof Error ? err.message : String(err)}`
         };
     }
 }
@@ -342,7 +345,10 @@ async function tryAccessibilityStrategy(query, index, platform, udid) {
         const hasTestID = !!query.testID;
         const hasText = !!query.text;
         if (!hasTestID && !hasText) {
-            return { success: false, reason: "No text or testID for accessibility search" };
+            return {
+                success: false,
+                reason: "No text or testID for accessibility search"
+            };
         }
         if (platform === "ios") {
             // iOS: testID maps to accessibilityIdentifier — search by identifier first,
@@ -352,20 +358,20 @@ async function tryAccessibilityStrategy(query, index, platform, udid) {
                 // Try exact identifier match first (testID → accessibilityIdentifier)
                 result = await iosFindElement({
                     identifier: query.testID,
-                    index,
+                    index
                 }, udid);
                 // Fall back to identifierContains if exact match fails
                 if (!result.success || !result.allMatches || result.allMatches.length === 0) {
                     result = await iosFindElement({
                         identifierContains: query.testID,
-                        index,
+                        index
                     }, udid);
                 }
                 // Last resort: try labelContains in case testID is reflected in label
                 if (!result.success || !result.allMatches || result.allMatches.length === 0) {
                     result = await iosFindElement({
                         labelContains: query.testID,
-                        index,
+                        index
                     }, udid);
                 }
             }
@@ -373,15 +379,21 @@ async function tryAccessibilityStrategy(query, index, platform, udid) {
                 const searchText = query.text;
                 result = await iosFindElement({
                     labelContains: searchText,
-                    index,
+                    index
                 }, udid);
             }
             if (!result.success || !result.allMatches || result.allMatches.length === 0) {
-                return { success: false, reason: result.error ?? "No iOS accessibility match" };
+                return {
+                    success: false,
+                    reason: result.error ?? "No iOS accessibility match"
+                };
             }
             const match = result.allMatches[index ?? 0];
             if (!match) {
-                return { success: false, reason: `Index ${index} out of bounds (${result.allMatches.length} matches)` };
+                return {
+                    success: false,
+                    reason: `Index ${index} out of bounds (${result.allMatches.length} matches)`
+                };
             }
             await iosTap(match.center.x, match.center.y, { udid });
             return {
@@ -390,7 +402,7 @@ async function tryAccessibilityStrategy(query, index, platform, udid) {
                 pressed: match.label || match.type,
                 text: match.label || undefined,
                 component: match.type || null,
-                convertedTo: { x: match.center.x, y: match.center.y, unit: "points" },
+                convertedTo: { x: match.center.x, y: match.center.y, unit: "points" }
             };
         }
         else {
@@ -405,19 +417,24 @@ async function tryAccessibilityStrategy(query, index, platform, udid) {
             let result = await androidFindElement(searchOptions);
             // If testID search via resourceId failed, try contentDescContains
             // (older RN versions map testID to content-description)
-            if (hasTestID && !hasText &&
-                (!result.success || !result.allMatches || result.allMatches.length === 0)) {
+            if (hasTestID && !hasText && (!result.success || !result.allMatches || result.allMatches.length === 0)) {
                 result = await androidFindElement({
                     contentDescContains: query.testID,
-                    index,
+                    index
                 });
             }
             if (!result.success || !result.allMatches || result.allMatches.length === 0) {
-                return { success: false, reason: result.error ?? "No Android accessibility match" };
+                return {
+                    success: false,
+                    reason: result.error ?? "No Android accessibility match"
+                };
             }
             const match = result.allMatches[index ?? 0];
             if (!match) {
-                return { success: false, reason: `Index ${index} out of bounds (${result.allMatches.length} matches)` };
+                return {
+                    success: false,
+                    reason: `Index ${index} out of bounds (${result.allMatches.length} matches)`
+                };
             }
             await androidTap(match.center.x, match.center.y);
             return {
@@ -426,14 +443,14 @@ async function tryAccessibilityStrategy(query, index, platform, udid) {
                 pressed: match.text || match.className || undefined,
                 text: match.text || undefined,
                 component: match.className || undefined,
-                convertedTo: { x: match.center.x, y: match.center.y, unit: "pixels" },
+                convertedTo: { x: match.center.x, y: match.center.y, unit: "pixels" }
             };
         }
     }
     catch (err) {
         return {
             success: false,
-            reason: `Accessibility strategy error: ${err instanceof Error ? err.message : String(err)}`,
+            reason: `Accessibility strategy error: ${err instanceof Error ? err.message : String(err)}`
         };
     }
 }
@@ -448,7 +465,10 @@ async function tryOcrStrategy(query, platform, udid) {
         if (platform === "ios") {
             const screenshot = await iosScreenshot(undefined, udid);
             if (!screenshot.success || !screenshot.data) {
-                return { success: false, reason: "Failed to capture iOS screenshot for OCR" };
+                return {
+                    success: false,
+                    reason: "Failed to capture iOS screenshot for OCR"
+                };
             }
             imageBuffer = screenshot.data;
             scaleFactor = screenshot.scaleFactor ?? 1;
@@ -457,7 +477,10 @@ async function tryOcrStrategy(query, platform, udid) {
             const { androidScreenshot } = await import("../core/android.js");
             const screenshot = await androidScreenshot();
             if (!screenshot.success || !screenshot.data) {
-                return { success: false, reason: "Failed to capture Android screenshot for OCR" };
+                return {
+                    success: false,
+                    reason: "Failed to capture Android screenshot for OCR"
+                };
             }
             imageBuffer = screenshot.data;
             scaleFactor = screenshot.scaleFactor ?? 1;
@@ -465,12 +488,16 @@ async function tryOcrStrategy(query, platform, udid) {
         const { recognizeText } = await import("../core/ocr.js");
         const ocrResult = await recognizeText(imageBuffer, {
             scaleFactor,
-            platform,
+            platform
         });
         const lowerSearch = searchText.toLowerCase();
-        const matchingWord = ocrResult.words.find((w) => w.text.toLowerCase() === lowerSearch) || ocrResult.words.find((w) => w.text.toLowerCase().includes(lowerSearch));
+        const matchingWord = ocrResult.words.find((w) => w.text.toLowerCase() === lowerSearch) ||
+            ocrResult.words.find((w) => w.text.toLowerCase().includes(lowerSearch));
         if (!matchingWord) {
-            return { success: false, reason: `OCR did not find text "${searchText}" on screen` };
+            return {
+                success: false,
+                reason: `OCR did not find text "${searchText}" on screen`
+            };
         }
         if (platform === "ios") {
             // tapCenter is in image-pixel space (downscaled) — convert to points
@@ -478,7 +505,10 @@ async function tryOcrStrategy(query, platform, udid) {
             const dpr = await getDevicePixelRatio(udid);
             const tapResult = await iosTap(Math.round((matchingWord.tapCenter.x * scaleFactor) / dpr), Math.round((matchingWord.tapCenter.y * scaleFactor) / dpr), { udid });
             if (!tapResult.success) {
-                return { success: false, reason: `OCR found "${matchingWord.text}" but tap failed: ${tapResult.error}` };
+                return {
+                    success: false,
+                    reason: `OCR found "${matchingWord.text}" but tap failed: ${tapResult.error}`
+                };
             }
         }
         else {
@@ -492,14 +522,14 @@ async function tryOcrStrategy(query, platform, udid) {
             convertedTo: {
                 x: matchingWord.tapCenter.x,
                 y: matchingWord.tapCenter.y,
-                unit: "pixels",
-            },
+                unit: "pixels"
+            }
         };
     }
     catch (err) {
         return {
             success: false,
-            reason: `OCR strategy error: ${err instanceof Error ? err.message : String(err)}`,
+            reason: `OCR strategy error: ${err instanceof Error ? err.message : String(err)}`
         };
     }
 }
@@ -512,7 +542,10 @@ async function tryCoordinateStrategy(pixelX, pixelY, platform, lastScreenshot, u
             const converted = convertScreenshotToTapCoords(pixelX, pixelY, "ios", devicePixelRatio, scaleFactor);
             const tapResult = await iosTap(converted.x, converted.y, { udid });
             if (!tapResult.success) {
-                return { success: false, reason: `Coordinate tap failed: ${tapResult.error}` };
+                return {
+                    success: false,
+                    reason: `Coordinate tap failed: ${tapResult.error}`
+                };
             }
             // Best-effort: identify what was tapped via fiber tree
             let screen = null;
@@ -526,7 +559,7 @@ async function tryCoordinateStrategy(pixelX, pixelY, platform, lastScreenshot, u
                 success: true,
                 reason: "Tapped at coordinates (iOS)",
                 screen,
-                convertedTo: { x: converted.x, y: converted.y, unit: "points" },
+                convertedTo: { x: converted.x, y: converted.y, unit: "points" }
             };
         }
         else {
@@ -545,14 +578,14 @@ async function tryCoordinateStrategy(pixelX, pixelY, platform, lastScreenshot, u
                 success: true,
                 reason: "Tapped at coordinates (Android)",
                 screen,
-                convertedTo: { x: converted.x, y: converted.y, unit: "pixels" },
+                convertedTo: { x: converted.x, y: converted.y, unit: "pixels" }
             };
         }
     }
     catch (err) {
         return {
             success: false,
-            reason: `Coordinate strategy error: ${err instanceof Error ? err.message : String(err)}`,
+            reason: `Coordinate strategy error: ${err instanceof Error ? err.message : String(err)}`
         };
     }
 }
@@ -563,12 +596,18 @@ const MAX_STRATEGY_MS = {
     fiber: 5000,
     accessibility: 3000,
     ocr: 5000,
-    coordinate: 3000,
+    coordinate: 3000
 };
 function withTimeout(promise, ms, label) {
     return new Promise((resolve, reject) => {
         const timer = setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms);
-        promise.then((val) => { clearTimeout(timer); resolve(val); }, (err) => { clearTimeout(timer); reject(err); });
+        promise.then((val) => {
+            clearTimeout(timer);
+            resolve(val);
+        }, (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
     });
 }
 async function captureScreenshot(platform, udid) {
@@ -580,7 +619,7 @@ async function captureScreenshot(platform, udid) {
             buffer: result.data,
             width: result.originalWidth || 0,
             height: result.originalHeight || 0,
-            scaleFactor: result.scaleFactor || 1,
+            scaleFactor: result.scaleFactor || 1
         };
     }
     catch {
@@ -601,7 +640,7 @@ async function verifyAndCapture(platform, shouldVerify, shouldScreenshot, before
         image: screenshotToBase64(after.buffer),
         width: after.width,
         height: after.height,
-        scaleFactor: after.scaleFactor,
+        scaleFactor: after.scaleFactor
     };
     let verification;
     if (shouldVerify && beforeBuffer) {
@@ -609,7 +648,9 @@ async function verifyAndCapture(platform, shouldVerify, shouldScreenshot, before
             const rawStatusBar = platform === "ios" ? 177 : 142; // pixels in original screenshot space
             const scale = beforeScaleFactor || after.scaleFactor || 1;
             const statusBarHeight = Math.round(rawStatusBar / scale);
-            const diff = await compareScreenshots(beforeBuffer, after.buffer, { statusBarHeight });
+            const diff = await compareScreenshots(beforeBuffer, after.buffer, {
+                statusBarHeight
+            });
             verification = {
                 meaningful: diff.changed,
                 changeRate: diff.changeRate,
@@ -619,8 +660,8 @@ async function verifyAndCapture(platform, shouldVerify, shouldScreenshot, before
                     meaningful: diff.changed,
                     changeRate: diff.changeRate,
                     changedPixels: diff.changedPixels,
-                    totalPixels: diff.totalPixels,
-                }),
+                    totalPixels: diff.totalPixels
+                })
             };
         }
         catch {
@@ -635,7 +676,7 @@ async function verifyAndCapture(platform, shouldVerify, shouldScreenshot, before
             timestamp: Date.now(),
             source: "tap-verify",
             groupId: verifyGroupId,
-            metadata: { phase: "before" },
+            metadata: { phase: "before" }
         });
     }
     imageBuffer.add({
@@ -644,7 +685,7 @@ async function verifyAndCapture(platform, shouldVerify, shouldScreenshot, before
         timestamp: Date.now(),
         source: "tap-verify",
         groupId: verifyGroupId,
-        metadata: { phase: "after", changeRate: verification?.changeRate },
+        metadata: { phase: "after", changeRate: verification?.changeRate }
     });
     return { screenshot, verification };
 }
@@ -681,8 +722,8 @@ async function burstCaptureAndVerify(platform, beforeBuffer, udid, beforeScaleFa
             metadata: {
                 frameIndex: i,
                 isBefore: i === 0,
-                changeRate: i === 0 ? 0 : (analysis.framesWithChange.includes(i) ? analysis.peakChangeRate : 0),
-            },
+                changeRate: i === 0 ? 0 : analysis.framesWithChange.includes(i) ? analysis.peakChangeRate : 0
+            }
         });
     }
     imageBuffer.addGroup({
@@ -696,8 +737,8 @@ async function burstCaptureAndVerify(platform, beforeBuffer, udid, beforeScaleFa
             peakFrame: analysis.peakFrame,
             framesWithChange: analysis.framesWithChange,
             transientChangeDetected: analysis.transientChangeDetected,
-            persistentChangeRate: analysis.persistentChangeRate,
-        },
+            persistentChangeRate: analysis.persistentChangeRate
+        }
     });
     // Get dimensions from the last frame using sharp
     const sharp = (await import("sharp")).default;
@@ -706,7 +747,7 @@ async function burstCaptureAndVerify(platform, beforeBuffer, udid, beforeScaleFa
         image: screenshotToBase64(frames[frames.length - 1]),
         width: meta.width || 0,
         height: meta.height || 0,
-        scaleFactor: 1,
+        scaleFactor: 1
     };
     const verification = {
         meaningful: analysis.meaningful,
@@ -724,8 +765,8 @@ async function burstCaptureAndVerify(platform, beforeBuffer, udid, beforeScaleFa
             totalPixels: 0,
             transientChangeDetected: analysis.transientChangeDetected,
             peakChangeRate: analysis.peakChangeRate,
-            peakFrame: analysis.peakFrame,
-        }),
+            peakFrame: analysis.peakFrame
+        })
     };
     return { screenshot, verification };
 }
@@ -744,14 +785,14 @@ export async function tap(options) {
         return {
             success: false,
             query,
-            error: "Must provide at least one of: text, testID, component, or x/y coordinates",
+            error: "Must provide at least one of: text, testID, component, or x/y coordinates"
         };
     }
     if (hasCoordinates && (query.x === undefined || query.y === undefined)) {
         return {
             success: false,
             query,
-            error: "Both x and y coordinates must be provided",
+            error: "Both x and y coordinates must be provided"
         };
     }
     // Native mode: bypass React Native connection, tap directly via ADB/simctl
@@ -762,13 +803,13 @@ export async function tap(options) {
         if (!platform) {
             const [androidDevice, iosSimulator] = await Promise.all([
                 getDefaultAndroidDevice().catch(() => null),
-                getActiveOrBootedSimulatorUdid().catch(() => null),
+                getActiveOrBootedSimulatorUdid().catch(() => null)
             ]);
             if (androidDevice && iosSimulator) {
                 return {
                     success: false,
                     query,
-                    error: "Multiple platforms detected (both Android and iOS). Specify platform: \"android\" or platform: \"ios\" to target the correct device.",
+                    error: 'Multiple platforms detected (both Android and iOS). Specify platform: "android" or platform: "ios" to target the correct device.'
                 };
             }
             if (androidDevice) {
@@ -782,7 +823,7 @@ export async function tap(options) {
                 return {
                     success: false,
                     query,
-                    error: "No Android device or iOS simulator found. Connect a device or start a simulator.",
+                    error: "No Android device or iOS simulator found. Connect a device or start a simulator."
                 };
             }
         }
@@ -800,7 +841,7 @@ export async function tap(options) {
                 nativeScreenshotMeta = {
                     originalWidth: before.width,
                     originalHeight: before.height,
-                    scaleFactor: before.scaleFactor,
+                    scaleFactor: before.scaleFactor
                 };
             }
         }
@@ -811,7 +852,7 @@ export async function tap(options) {
                 nativeScreenshotMeta = {
                     originalWidth: ref.width,
                     originalHeight: ref.height,
-                    scaleFactor: ref.scaleFactor,
+                    scaleFactor: ref.scaleFactor
                 };
                 // Also use it for verification if buffer is needed
                 if (!nativeBeforeBuffer) {
@@ -826,8 +867,13 @@ export async function tap(options) {
         catch (err) {
             return formatTapFailure({
                 query,
-                attempted: [{ strategy: "native-coordinate", reason: err instanceof Error ? err.message : String(err) }],
-                suggestion: `Tap timed out. Take a screenshot (${platform === "ios" ? "ios_screenshot" : "android_screenshot"}) and retry with coordinates.`,
+                attempted: [
+                    {
+                        strategy: "native-coordinate",
+                        reason: err instanceof Error ? err.message : String(err)
+                    }
+                ],
+                suggestion: `Tap timed out. Take a screenshot (${platform === "ios" ? "ios_screenshot" : "android_screenshot"}) and retry with coordinates.`
             });
         }
         if (result.success) {
@@ -846,13 +892,13 @@ export async function tap(options) {
                 convertedTo: result.convertedTo,
                 platform,
                 screenshot,
-                verification,
+                verification
             });
         }
         return formatTapFailure({
             query,
             attempted: [{ strategy: "native-coordinate", reason: result.reason }],
-            suggestion: `Take a screenshot (${platform === "ios" ? "ios_screenshot" : "android_screenshot"}) to verify coordinates.`,
+            suggestion: `Take a screenshot (${platform === "ios" ? "ios_screenshot" : "android_screenshot"}) to verify coordinates.`
         });
     }
     // Detect available capabilities
@@ -860,7 +906,7 @@ export async function tap(options) {
     let hasMetro = allApps.length > 0;
     // If platform is specified, prefer an app matching that platform
     let app = options.platform
-        ? allApps.find((a) => a.platform === options.platform) ?? allApps[0]
+        ? (allApps.find((a) => a.platform === options.platform) ?? allApps[0])
         : allApps[0];
     // Try to auto-connect to Metro (for fiber strategy), but don't fail if it doesn't work
     if (!hasMetro) {
@@ -895,13 +941,13 @@ export async function tap(options) {
             // No Metro — detect from available devices
             const [androidDevice, iosSimulator] = await Promise.all([
                 getDefaultAndroidDevice().catch(() => null),
-                getActiveOrBootedSimulatorUdid().catch(() => null),
+                getActiveOrBootedSimulatorUdid().catch(() => null)
             ]);
             if (androidDevice && iosSimulator) {
                 return {
                     success: false,
                     query,
-                    error: "Both iOS and Android devices detected but no Metro connection. Specify platform=\"ios\" or platform=\"android\".",
+                    error: 'Both iOS and Android devices detected but no Metro connection. Specify platform="ios" or platform="android".'
                 };
             }
             if (androidDevice)
@@ -914,47 +960,55 @@ export async function tap(options) {
         return {
             success: false,
             query,
-            error: "No devices found. Boot a simulator or connect an Android device.",
+            error: "No devices found. Boot a simulator or connect an Android device."
         };
     }
     // Resolve target iOS simulator UDID from the connected app
     // This ensures taps go to the correct device when multiple simulators are booted
     let targetUdid;
     if (platform === "ios") {
-        targetUdid = app?.simulatorUdid
-            ?? ((app?.deviceInfo?.deviceName ? (await findSimulatorByName(app.deviceInfo.deviceName)) : null) ?? undefined);
+        targetUdid =
+            app?.simulatorUdid ??
+                (app?.deviceInfo?.deviceName ? await findSimulatorByName(app.deviceInfo.deviceName) : null) ??
+                undefined;
     }
     const deviceName = app?.deviceInfo?.deviceName;
     // Determine strategies
     const strategies = getAvailableStrategies(query, strategy);
     const attempted = [];
-    // Early IDB check for iOS — fail fast instead of falling through every strategy
-    const IDB_REQUIRED_STRATEGIES = ["accessibility", "ocr", "coordinate"];
-    let idbMissing = false;
+    // Early UI driver check for iOS — fail fast instead of falling through every strategy
+    const UI_DRIVER_REQUIRED_STRATEGIES = ["accessibility", "ocr", "coordinate"];
+    let uiDriverMissing = false;
     if (platform === "ios") {
-        idbMissing = !(await isIdbAvailable());
+        uiDriverMissing = !(await isUiDriverAvailable());
     }
     // Filter strategies by available capabilities
     const filteredStrategies = strategies.filter((strat) => {
         if (strat === "fiber" && !hasMetro) {
-            attempted.push({ strategy: "fiber", reason: "Skipped — no Metro connection (required for fiber)" });
+            attempted.push({
+                strategy: "fiber",
+                reason: "Skipped — no Metro connection (required for fiber)"
+            });
             return false;
         }
-        if (idbMissing && IDB_REQUIRED_STRATEGIES.includes(strat)) {
-            attempted.push({ strategy: strat, reason: "Skipped — IDB is not installed (required for iOS tap/accessibility/OCR)" });
+        if (uiDriverMissing && UI_DRIVER_REQUIRED_STRATEGIES.includes(strat)) {
+            attempted.push({
+                strategy: strat,
+                reason: "Skipped — iOS UI driver is not installed (required for iOS tap/accessibility/OCR)"
+            });
             return false;
         }
         return true;
     });
     if (filteredStrategies.length === 0) {
-        const errorMessage = idbMissing
-            ? "Cannot tap on iOS Simulator — IDB is not installed.\n\nIDB (iOS Development Bridge) is required for tapping, swiping, text input, and accessibility queries on iOS Simulators.\n\nInstall with:\n  brew install idb-companion\n\nVerify with:\n  idb_companion --list 1\n\nAfter installing, retry the tap. See: https://github.com/facebook/idb"
+        const errorMessage = uiDriverMissing
+            ? `Cannot tap on iOS Simulator — ${getUiDriverInstallHint()}\n\nThe iOS UI driver is required for tapping, swiping, text input, and accessibility queries on iOS Simulators.\n\nAfter installing, retry the tap.`
             : "All strategies require Metro connection, which is unavailable.\n\nTo fix:\n1. Make sure your React Native app is running\n2. Run scan_metro to connect\n3. Or use tap(x, y, native=true) for coordinate-based taps";
         return {
             success: false,
             query,
             attempted,
-            error: errorMessage,
+            error: errorMessage
         };
     }
     // Determine screenshot and verification behavior
@@ -974,7 +1028,10 @@ export async function tap(options) {
     for (const strat of filteredStrategies) {
         const remaining = remainingMs();
         if (remaining < MIN_STRATEGY_BUDGET_MS) {
-            attempted.push({ strategy: strat, reason: `Skipped — only ${remaining}ms remaining (budget ${TAP_TIMEOUT_MS}ms)` });
+            attempted.push({
+                strategy: strat,
+                reason: `Skipped — only ${remaining}ms remaining (budget ${TAP_TIMEOUT_MS}ms)`
+            });
             continue;
         }
         const cap = MAX_STRATEGY_MS[strat] ?? 5000;
@@ -999,7 +1056,10 @@ export async function tap(options) {
             }
         }
         catch (err) {
-            attempted.push({ strategy: strat, reason: err instanceof Error ? err.message : String(err) });
+            attempted.push({
+                strategy: strat,
+                reason: err instanceof Error ? err.message : String(err)
+            });
             continue;
         }
         if (result.success) {
@@ -1015,7 +1075,7 @@ export async function tap(options) {
                 app.lastScreenshot = {
                     originalWidth: screenshot.width,
                     originalHeight: screenshot.height,
-                    scaleFactor: screenshot.scaleFactor,
+                    scaleFactor: screenshot.scaleFactor
                 };
             }
             return formatTapSuccess({
@@ -1030,7 +1090,7 @@ export async function tap(options) {
                 platform,
                 device: deviceName,
                 screenshot,
-                verification,
+                verification
             });
         }
         attempted.push({ strategy: strat, reason: result.reason });
@@ -1063,7 +1123,7 @@ export async function tap(options) {
                     app.lastScreenshot = {
                         originalWidth: screenshot.width,
                         originalHeight: screenshot.height,
-                        scaleFactor: screenshot.scaleFactor,
+                        scaleFactor: screenshot.scaleFactor
                     };
                 }
                 return formatTapSuccess({
@@ -1077,7 +1137,7 @@ export async function tap(options) {
                     platform,
                     device: deviceName,
                     screenshot,
-                    verification,
+                    verification
                 });
             }
             catch {
@@ -1093,7 +1153,7 @@ export async function tap(options) {
                 app.lastScreenshot = {
                     originalWidth: matchScreenshot.width,
                     originalHeight: matchScreenshot.height,
-                    scaleFactor: matchScreenshot.scaleFactor,
+                    scaleFactor: matchScreenshot.scaleFactor
                 };
             }
             return formatTapFailure({
@@ -1102,13 +1162,13 @@ export async function tap(options) {
                 suggestion: `Found ${result.matches.length} match(es) — specify index to select one`,
                 device: deviceName,
                 matches: result.matches,
-                screenshot: matchScreenshot,
+                screenshot: matchScreenshot
             });
         }
     }
     // All strategies failed — check if timeout was the cause
-    const timedOut = attempted.some(a => a.reason.includes("timed out"));
-    const skipped = attempted.some(a => a.reason.includes("Skipped"));
+    const timedOut = attempted.some((a) => a.reason.includes("timed out"));
+    const skipped = attempted.some((a) => a.reason.includes("Skipped"));
     const hitTimeout = timedOut || skipped;
     const elapsed = TAP_TIMEOUT_MS - remainingMs();
     const suggestion = buildSuggestion(query, strategies, platform);
@@ -1119,18 +1179,16 @@ export async function tap(options) {
         app.lastScreenshot = {
             originalWidth: failScreenshot.width,
             originalHeight: failScreenshot.height,
-            scaleFactor: failScreenshot.scaleFactor,
+            scaleFactor: failScreenshot.scaleFactor
         };
     }
     return formatTapFailure({
         query,
         attempted,
-        error: hitTimeout
-            ? `Tap timed out after ${elapsed}ms (budget ${TAP_TIMEOUT_MS}ms)`
-            : undefined,
+        error: hitTimeout ? `Tap timed out after ${elapsed}ms (budget ${TAP_TIMEOUT_MS}ms)` : undefined,
         suggestion,
         device: deviceName,
-        screenshot: failScreenshot,
+        screenshot: failScreenshot
     });
 }
 function buildSuggestion(query, triedStrategies, platform) {