execbro 0.0.1-reserve → 1.10.13

package/build/tools/interactionTools.js

@@ -0,0 +1,539 @@
+import { z } from "zod";
+import { registerToolWithTelemetry } from "../core/register.js";
+import { androidLongPress, androidSwipe, androidInputText, androidKeyEvent, ANDROID_KEY_EVENTS, iosButton, iosInputText, iosSwipe, IOS_BUTTON_TYPES, getDevicePixelRatio, connectedApps, } from "../core/index.js";
+import { tap, convertScreenshotToTapCoords } from "../pro/tap.js";
+import { captureScreenshot, verifyAndCapture, burstCaptureAndVerify, } from "../pro/verifyAction.js";
+import { clearFocusedInput, dismissKeyboard, inputTextWithReplace } from "../core/focusedInputTools.js";
+import { primaryInteractionBanner, platformFallbackBanner, platformUniqueBanner } from "../core/toolHelpers.js";
+import { resolveDeviceTarget, formatResolverError } from "../core/deviceResolver.js";
+import { resolveAndroidDeviceId, resolveIosUdid } from "./_deviceArg.js";
+export function registerInteractionTools(server) {
+    // Tool: Unified tap — tries fiber, accessibility, OCR, coordinate strategies
+    registerToolWithTelemetry(server, "tap", {
+        description: "Tap a UI element. Automatically tries multiple strategies: fiber tree (React), accessibility tree (native), and OCR (visual)." +
+            primaryInteractionBanner() + "\n" +
+            "PURPOSE: Single unified tap entry point — resolves text/testID/component/coordinates into a real touch event on the correct device.\n" +
+            "WHEN TO USE: Any time you need to press a button, focus an input, open a menu, or verify a handler fires. Prefer testID, then text, then component, then (x,y) from a screenshot's pressables list.\n" +
+            "WORKFLOW: ios_screenshot or android_screenshot -> tap(testID=\"...\") | tap(text=\"...\") | tap(x, y) -> screenshot again to verify. Use burst=true when meaningful=false but visual feedback looks transient.\n" +
+            "LIMITATIONS: iOS needs AXe (brew install cameroncooke/axe/axe) or IDB for accessibility/coordinate taps. Non-ASCII text skips fiber (Hermes); prefer testID. Pass `device` to target a specific simulator/emulator when multiple are available — call list_devices for the inventory.\n" +
+            "GOOD: tap({ testID: \"login-btn\" }); tap({ text: \"Submit\" }); tap({ x: 300, y: 600 }); tap({ x: 300, y: 600, native: true, device: \"emulator-5554\" })\n" +
+            "BAD: tap({ text: \"\" }) or tap({ x: 0, y: 0 }) — missing a target. tap({ text: \"Submit\" }) without first screenshotting an ambiguous screen.\n" +
+            "SEE ALSO: call get_usage_guide(topic=\"interact\") for the full device-interaction playbook.",
+        inputSchema: {
+            text: z
+                .string()
+                .optional()
+                .describe("Visible text to match (case-insensitive substring). ASCII only for fiber strategy; OCR handles non-ASCII."),
+            testID: z
+                .string()
+                .optional()
+                .describe("Exact match on the element's testID prop."),
+            component: z
+                .string()
+                .optional()
+                .describe("Component name match (case-insensitive substring, e.g. 'Button', 'MenuItem')."),
+            index: z.coerce
+                .number()
+                .optional()
+                .describe("Zero-based index when multiple elements match (default: 0)."),
+            x: z.coerce
+                .number()
+                .optional()
+                .describe("X coordinate in pixels (from screenshot). Must provide both x and y."),
+            y: z.coerce
+                .number()
+                .optional()
+                .describe("Y coordinate in pixels (from screenshot). Must provide both x and y."),
+            strategy: z
+                .enum(["auto", "fiber", "accessibility", "ocr", "coordinate"])
+                .optional()
+                .default("auto")
+                .describe('"auto" (default) tries fiber -> accessibility -> OCR. Set explicitly to skip strategies you know will fail.'),
+            maxTraversalDepth: z.coerce
+                .number()
+                .optional()
+                .describe("Max parent levels to traverse when searching by component name (default: 15). " +
+                "Increase if your component is deeply wrapped (e.g. inside multiple HOCs/animation wrappers)."),
+            native: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("When true, tap coordinates directly via ADB/simctl without requiring a React Native connection. " +
+                "Useful for interacting with native UI, system dialogs, or non-RN apps. Requires x/y coordinates."),
+            device: z
+                .string()
+                .optional()
+                .describe("Target device. Accepts (a) an iOS simulator UDID, " +
+                "(b) an Android adb serial like 'emulator-5554', " +
+                "(c) the iOS simulator or Android emulator/device name (substring match), or " +
+                "(d) a connected RN app's deviceName (substring match against get_apps output). " +
+                "Omit when exactly one device is available. Call list_devices to enumerate."),
+            screenshot: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Return post-tap image bytes in the response. Default true. Set to false to drop the PNG bytes — verification still runs (set verify=false to skip that too). Combine with verify=true to get the meaningful/changeRate signal without paying the ~1MB-per-tap bandwidth cost."),
+            verify: z
+                .boolean()
+                .optional()
+                .describe("Run before/after screenshot diff to detect if the tap had a meaningful visual effect. " +
+                "Default: true for coordinate/accessibility/ocr strategies, false for fiber. " +
+                "Independent of `screenshot` — verify can run with screenshot=false (the diff is computed internally; image bytes are dropped). " +
+                "When skipped, the response contains `verification: { skipped: true, skippedReason }` so callers can tell apart \"ran clean\" from \"never ran\"."),
+            burst: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Enable burst screenshot capture for enhanced verification. " +
+                "Captures 4 rapid screenshots (~150ms intervals) after the tap to detect transient visual feedback " +
+                "(press animations, highlights, ripples) that may settle before a standard after-screenshot. " +
+                "Results are stored in the image buffer (use get_images to inspect individual frames). " +
+                "Default: false."),
+        },
+    }, async (args) => {
+        const result = await tap({
+            text: args.text,
+            testID: args.testID,
+            component: args.component,
+            index: args.index,
+            x: args.x,
+            y: args.y,
+            strategy: args.strategy,
+            maxTraversalDepth: args.maxTraversalDepth,
+            native: args.native,
+            device: args.device,
+            screenshot: args.screenshot,
+            verify: args.verify,
+            burst: args.burst,
+        });
+        const { screenshot: screenshotData, ...resultWithoutScreenshot } = result;
+        const text = JSON.stringify(resultWithoutScreenshot, null, 2);
+        // Pack predicate + strategy mode + attempted strategies into errorContext for telemetry.
+        // Always include the predicate so unmeaningful outcomes (no isError, no _errorMessage) still
+        // carry triage context — otherwise blob8 ends up blank and the dashboard shows empty rows.
+        // e.g. "p={\"text\":\"Save\"}|s=ocr|fiber:no_pressable|ocr:no_match"
+        const stratPrefix = args.strategy && args.strategy !== "auto" ? `s=${args.strategy}|` : "";
+        let predicatePrefix = "";
+        try {
+            if (result.query !== undefined) {
+                predicatePrefix = `p=${JSON.stringify(result.query)}|`;
+            }
+        }
+        catch {
+            // query may contain non-serializable values — drop the prefix rather than fail.
+        }
+        const attemptedPart = result.attempted?.length
+            ? result.attempted.map(a => `${a.strategy}:${a.reason.slice(0, 40)}`).join("|")
+            : "";
+        const ctxParts = `${predicatePrefix}${stratPrefix}${attemptedPart}`;
+        const errorContext = ctxParts ? ctxParts.replace(/\|$/, "") : undefined;
+        const content = [
+            { type: "text", text },
+        ];
+        if (screenshotData) {
+            content.push({
+                type: "image",
+                data: screenshotData.image,
+                mimeType: "image/jpeg",
+            });
+        }
+        return {
+            content,
+            isError: !result.success && !result.ambiguous,
+            _errorMessage: !result.success && !result.ambiguous
+                ? `${JSON.stringify(result.query)}|${result.error || ""}`
+                : undefined,
+            _errorContext: errorContext,
+            _meaningful: result.verification?.meaningful,
+            _changeRate: result.verification?.changeRate,
+            _tapStrategy: result.method,
+            _iosDriver: result.platform === "ios" ? (process.env.IOS_DRIVER?.toLowerCase() || "axe") : undefined,
+            _artifactKey: result.artifactKey,
+            _ocrClosestMatch: result.ocrClosestMatch,
+            _fiberPressableCount: result.fiberPressableCount,
+            _accessibilityMatchCount: result.accessibilityMatchCount,
+            _appRoute: result.appRoute,
+        };
+    });
+    // Android UI Input Tools (Phase 2)
+    // ============================================================================
+    // Tool: Android long press
+    registerToolWithTelemetry(server, "android_long_press", {
+        description: "Long press at specific coordinates on an Android device/emulator screen" +
+            platformFallbackBanner("`tap` for short taps; keep android_long_press for long-press gestures specifically") +
+            "\nPURPOSE: Emit a sustained touch at raw pixel coordinates to trigger long-press handlers (context menus, drag starts, multi-select)." +
+            "\nWHEN TO USE: Only when a long-press gesture is required — regular taps should go through `tap`." +
+            "\nSEE ALSO: call get_usage_guide(topic=\"interact\") for the full UI-interaction playbook.",
+        inputSchema: {
+            x: z.coerce.number().describe("X coordinate in pixels"),
+            y: z.coerce.number().describe("Y coordinate in pixels"),
+            durationMs: z.number().optional().default(1000).describe("Press duration in milliseconds (default: 1000)"),
+            deviceId: z
+                .string()
+                .optional()
+                .describe("Optional Android target. Accepts an adb serial (e.g. 'emulator-5554', 'RFCX20CLX3F'), an emulator name, or a substring of the connected RN device name (e.g. 'sdk_gphone'). Uses first available device if not specified.")
+        }
+    }, async ({ x, y, durationMs, deviceId }) => {
+        const r = await resolveAndroidDeviceId(deviceId);
+        if (!r.ok)
+            return r.response;
+        const result = await androidLongPress(x, y, durationMs, r.serial);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.success ? result.result : `Error: ${result.error}`
+                }
+            ],
+            isError: !result.success
+        };
+    });
+    // Tool: Cross-platform swipe — auto-routes to iOS or Android backend
+    registerToolWithTelemetry(server, "swipe", {
+        description: "Swipe gesture that auto-routes to the correct platform (iOS or Android), with pixel-diff verification." +
+            primaryInteractionBanner() + "\n" +
+            "PURPOSE: Single unified swipe entry point — accepts screenshot pixel coordinates, dispatches to the correct native driver, and returns a `verification` block indicating whether the swipe produced a visual change.\n" +
+            "WHEN TO USE: Scrolling lists, paging carousels, pull-to-refresh, dismissing sheets, opening drawers — anything that needs a gesture rather than a tap. Especially useful in virtualized lists (FlatList/SectionList) where off-screen items aren't mounted in the fiber tree.\n" +
+            "VERIFICATION: verify=true (default) returns `verification.meaningful` — false means the scroll did nothing (end-of-list, non-scrollable surface, or missed coordinates). burst=true catches transient feedback like overscroll bounce.\n" +
+            "WORKFLOW: ios_screenshot or android_screenshot -> swipe({ startX, startY, endX, endY }) -> read response.verification.meaningful to confirm it worked.\n" +
+            "LIMITATIONS: iOS needs AXe (brew install cameroncooke/axe/axe) or IDB. Pass `device` to target a specific simulator/emulator when multiple are available — call list_devices for the inventory.\n" +
+            "SEE ALSO: call get_usage_guide(topic=\"interact\") for the full UI-interaction playbook.",
+        inputSchema: {
+            startX: z.coerce.number().describe("Starting X coordinate in screenshot pixels"),
+            startY: z.coerce.number().describe("Starting Y coordinate in screenshot pixels"),
+            endX: z.coerce.number().describe("Ending X coordinate in screenshot pixels"),
+            endY: z.coerce.number().describe("Ending Y coordinate in screenshot pixels"),
+            durationMs: z.coerce
+                .number()
+                .optional()
+                .describe("Swipe duration in milliseconds (default: 300 on Android; iOS uses driver default if omitted)"),
+            delta: z.coerce
+                .number()
+                .optional()
+                .describe("iOS only — touch step size between events (driver-dependent default). Ignored on Android."),
+            device: z
+                .string()
+                .optional()
+                .describe("Target device. Accepts (a) an iOS simulator UDID, " +
+                "(b) an Android adb serial like 'emulator-5554', " +
+                "(c) the iOS simulator or Android emulator/device name (substring match), or " +
+                "(d) a connected RN app's deviceName (substring match against get_apps output). " +
+                "Omit when exactly one device is available. Call list_devices to enumerate."),
+            verify: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Compare before/after screenshots to detect whether the swipe produced a visual change. " +
+                "Set false to skip. When skipped, the response contains `verification: { skipped: true, skippedReason }` " +
+                "so callers can tell apart \"ran clean\" from \"never ran\"."),
+            screenshot: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Return the post-swipe image bytes in the response. Default true. Set to false to drop the PNG bytes — " +
+                "verification still runs (set verify=false to skip that too)."),
+            burst: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Capture rapid sequential frames after the swipe to detect transient feedback (overscroll bounce, " +
+                "fling-then-snap-back) even when the final state is unchanged. Frames are stored in the image buffer; " +
+                "use get_images(groupId=verification.burstGroupId) to retrieve them."),
+        }
+    }, async ({ startX, startY, endX, endY, durationMs, delta, device, verify, screenshot, burst }) => {
+        const resolved = await resolveDeviceTarget(device);
+        if (!resolved.ok) {
+            return {
+                content: [{ type: "text", text: `Error: ${formatResolverError(resolved.error)}` }],
+                isError: true
+            };
+        }
+        const resolvedPlatform = resolved.target.platform;
+        const resolvedUdid = resolved.target.iosUdid;
+        const shouldVerify = verify !== false;
+        const shouldScreenshot = screenshot !== false;
+        const shouldBurst = burst === true;
+        // Capture before-screenshot only if we'll need it (verify or burst).
+        const wantBefore = shouldVerify || shouldBurst;
+        const beforeCapture = wantBefore
+            ? await captureScreenshot(resolvedPlatform, resolvedUdid)
+            : null;
+        const beforeBuffer = beforeCapture?.buffer ?? null;
+        const beforeScaleFactor = beforeCapture?.scaleFactor;
+        let driverResult;
+        if (resolvedPlatform === "ios") {
+            const dpr = await getDevicePixelRatio(resolvedUdid);
+            const firstApp = connectedApps.values().next().value;
+            const scaleFactor = firstApp?.lastScreenshot?.scaleFactor ?? 1;
+            const start = convertScreenshotToTapCoords(startX, startY, "ios", dpr, scaleFactor);
+            const end = convertScreenshotToTapCoords(endX, endY, "ios", dpr, scaleFactor);
+            const duration = durationMs !== undefined ? durationMs / 1000 : undefined;
+            driverResult = await iosSwipe(start.x, start.y, end.x, end.y, { duration, delta, udid: resolvedUdid });
+        }
+        else {
+            const firstApp = connectedApps.values().next().value;
+            const scaleFactor = firstApp?.lastScreenshot?.scaleFactor ?? 1;
+            const start = convertScreenshotToTapCoords(startX, startY, "android", 1, scaleFactor);
+            const end = convertScreenshotToTapCoords(endX, endY, "android", 1, scaleFactor);
+            driverResult = await androidSwipe(start.x, start.y, end.x, end.y, durationMs ?? 300, resolved.target.androidSerial);
+        }
+        if (!driverResult.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${driverResult.error}` }],
+                isError: true
+            };
+        }
+        // Driver succeeded — run verification.
+        const verifyResult = shouldBurst
+            ? await burstCaptureAndVerify({
+                platform: resolvedPlatform,
+                beforeBuffer,
+                udid: resolvedUdid,
+                beforeScaleFactor,
+                source: "swipe-burst",
+            })
+            : await verifyAndCapture({
+                platform: resolvedPlatform,
+                shouldVerify,
+                shouldScreenshot,
+                beforeBuffer,
+                udid: resolvedUdid,
+                beforeScaleFactor,
+                source: "swipe-verify",
+            });
+        const { screenshot: screenshotData, verification } = verifyResult;
+        const warning = verification && !verification.skipped && verification.meaningful === false
+            ? "Swipe executed but no visual change detected — list may be at end-of-scroll, content is non-scrollable, or the gesture missed the scroll surface. Inspect the screenshot and retry with adjusted coordinates if needed."
+            : undefined;
+        const responseBody = {
+            success: true,
+            platform: resolvedPlatform,
+            from: { x: startX, y: startY },
+            to: { x: endX, y: endY },
+            driverMessage: driverResult.result,
+            ...(verification && { verification }),
+            ...(warning && { warning }),
+        };
+        const content = [
+            { type: "text", text: JSON.stringify(responseBody, null, 2) },
+        ];
+        if (shouldScreenshot && screenshotData) {
+            content.push({
+                type: "image",
+                data: screenshotData.image,
+                mimeType: "image/jpeg",
+            });
+        }
+        return {
+            content,
+            isError: false,
+            _meaningful: verification && !verification.skipped ? verification.meaningful : undefined,
+            _changeRate: verification && !verification.skipped ? verification.changeRate : undefined,
+        };
+    });
+    // Tool: Android input text
+    registerToolWithTelemetry(server, "android_input_text", {
+        description: "Type text on an Android device/emulator." +
+            platformFallbackBanner("`tap(text=...)` — it auto-focuses TextInput via the fiber tree") +
+            " The text will be input at the current focus point (tap an input field first)." +
+            "\nPURPOSE: Send keystrokes to whichever input currently has focus on Android — the tool does NOT focus a field itself." +
+            "\nWHEN TO USE: Only after an input is already focused, or when `tap(text=...)` on the input didn't take focus for some reason." +
+            "\nPREREQUISITE: A TextInput must already have focus. Tap the field first (e.g. tap({ testID: 'search' })) — `android_input_text` does NOT focus a field itself; replace:true also requires React focus." +
+            "\nREPLACE MODE: pass replace:true to clear the focused field first (via React onChangeText so controlled state stays consistent), then type the new value. Use for pre-filled fields where appending would corrupt the value." +
+            "\nSEE ALSO: call get_usage_guide(topic=\"interact\") for the full UI-interaction playbook.",
+        inputSchema: {
+            text: z.string().describe("Text to type"),
+            replace: z
+                .boolean()
+                .optional()
+                .describe("If true, clear the focused TextInput via React onChangeText before typing. Use to set a pre-filled field to an exact value without concatenation. Requires Bridgeless/Fabric."),
+            device: z
+                .string()
+                .optional()
+                .describe("Optional RN device name (substring match) — needed by replace:true when multiple RN apps are connected, to disambiguate which device's focused input to clear. Single-device sessions can omit."),
+            deviceId: z
+                .string()
+                .optional()
+                .describe("Optional Android target. Accepts an adb serial (e.g. 'emulator-5554', 'RFCX20CLX3F'), an emulator name, or a substring of the connected RN device name (e.g. 'sdk_gphone'). Uses first available device if not specified.")
+        }
+    }, async ({ text, replace, device, deviceId }) => {
+        const r = await resolveAndroidDeviceId(deviceId);
+        if (!r.ok)
+            return r.response;
+        const result = await inputTextWithReplace(text, replace === true, (t) => androidInputText(t, r.serial), () => clearFocusedInput(device));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.success ? result.result : `Error: ${result.error}`
+                }
+            ],
+            isError: !result.success
+        };
+    });
+    // Tool: Android key event
+    registerToolWithTelemetry(server, "android_key_event", {
+        description: "Send a key event to an Android device/emulator." +
+            platformUniqueBanner("sending Android key events (BACK, HOME, MENU, etc.)") +
+            ` Common keys: ${Object.keys(ANDROID_KEY_EVENTS).join(", ")}` +
+            "\nPURPOSE: Dispatch Android system keys (BACK, HOME, MENU, ENTER, DEL, etc.) that aren't reachable via on-screen tap." +
+            "\nWHEN TO USE: Navigate back from a screen, submit a form with ENTER, dismiss the keyboard, or press hardware-style keys during a flow." +
+            "\nSEE ALSO: call get_usage_guide(topic=\"interact\") for the full UI-interaction playbook.",
+        inputSchema: {
+            key: z.string().describe(`Key name (${Object.keys(ANDROID_KEY_EVENTS).join(", ")}) or numeric keycode`),
+            deviceId: z
+                .string()
+                .optional()
+                .describe("Optional Android target. Accepts an adb serial (e.g. 'emulator-5554', 'RFCX20CLX3F'), an emulator name, or a substring of the connected RN device name (e.g. 'sdk_gphone'). Uses first available device if not specified.")
+        }
+    }, async ({ key, deviceId }) => {
+        // Try to parse as number first, otherwise treat as key name
+        const keyCode = /^\d+$/.test(key) ? parseInt(key, 10) : key.toUpperCase();
+        const r = await resolveAndroidDeviceId(deviceId);
+        if (!r.ok)
+            return r.response;
+        const result = await androidKeyEvent(keyCode, r.serial);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.success ? result.result : `Error: ${result.error}`
+                }
+            ],
+            isError: !result.success
+        };
+    });
+    // ============================================================================
+    // Android Accessibility Tools (UI Hierarchy)
+    // ============================================================================
+    // ============================================================================
+    // iOS Simulator Tools
+    // ============================================================================
+    // Tool: iOS install app
+    // ============================================================================
+    // iOS UI Interaction Tools (require an iOS UI driver)
+    // Default: AXe — brew install cameroncooke/axe/axe
+    // Alternative: IDB — brew install idb-companion (set IOS_DRIVER=idb)
+    // ============================================================================
+    // Tool: iOS button
+    server.registerTool("ios_button", {
+        description: "Press a hardware button on an iOS simulator." +
+            platformUniqueBanner("pressing iOS hardware buttons (HOME, LOCK, SIRI, APPLE_PAY)") +
+            " Requires an iOS UI driver: AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion)." +
+            "\nPURPOSE: Trigger iOS hardware buttons (HOME, LOCK, SIDE_BUTTON, SIRI, APPLE_PAY) that aren't reachable via on-screen tap." +
+            "\nWHEN TO USE: Send the app to background (HOME), lock the simulator (LOCK), or exercise Siri/Apple Pay flows." +
+            "\nSEE ALSO: call get_usage_guide(topic=\"interact\") for the full UI-interaction playbook.",
+        inputSchema: {
+            button: z
+                .enum(IOS_BUTTON_TYPES)
+                .describe("Hardware button to press: HOME, LOCK, SIDE_BUTTON, SIRI, or APPLE_PAY"),
+            duration: z.coerce.number().optional().describe("Optional button press duration in seconds"),
+            udid: z.string().optional().describe("Optional iOS target. Accepts a simulator UDID, the simulator name (e.g. 'iPhone 17 Pro'), or a substring of the connected RN device name. Uses booted simulator if not specified.")
+        }
+    }, async ({ button, duration, udid }) => {
+        const r = await resolveIosUdid(udid);
+        if (!r.ok)
+            return r.response;
+        const result = await iosButton(button, { duration, udid: r.udid });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.success ? result.result : `Error: ${result.error}`
+                }
+            ],
+            isError: !result.success
+        };
+    });
+    // Tool: Clear focused text input
+    registerToolWithTelemetry(server, "clear_focused_input", {
+        description: "Clear the contents of the currently focused TextInput, updating React state correctly so controlled components (Formik, react-hook-form, useState) stay consistent." +
+            "\nPURPOSE: Reset whatever TextInput has focus to empty, with the React state owner notified via onChangeText. Use BEFORE typing a replacement value into a pre-filled field." +
+            "\nWHEN TO USE: After tap(testID=...) focuses an input that already has text. Pair with ios_input_text/android_input_text (or use their replace:true flag for one-shot)." +
+            "\nPREREQUISITE: A TextInput must already have React focus. Tap the field first (e.g. tap({ testID: 'search' })) — this tool does NOT focus a field itself." +
+            "\nLIMITATIONS: Requires Bridgeless/Fabric (RN new architecture). Returns 'no focused TextInput' if nothing is focused — does not silently no-op." +
+            "\nSEE ALSO: dismiss_keyboard, ios_input_text({replace:true}), android_input_text({replace:true}). call get_usage_guide(topic=\"interact\") for the full UI-interaction playbook.",
+        inputSchema: {
+            device: z
+                .string()
+                .optional()
+                .describe("Optional device name (substring match). Uses default device if not specified.")
+        }
+    }, async ({ device }) => {
+        const result = await clearFocusedInput(device);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.success ? `Cleared focused input (via ${result.via}).` : `Error: ${result.error}`
+                }
+            ],
+            isError: !result.success
+        };
+    });
+    // Tool: Dismiss keyboard
+    registerToolWithTelemetry(server, "dismiss_keyboard", {
+        description: "Blur the currently focused TextInput, dismissing the on-screen keyboard." +
+            "\nPURPOSE: Close the keyboard when it's blocking content beneath the input, or move focus off an input before a tap that would otherwise be intercepted." +
+            "\nWHEN TO USE: After typing into a field and before tapping a button that is hidden by the keyboard. Or to verify a 'tap outside dismisses' UX is wired up." +
+            "\nPREREQUISITE: A TextInput must already have React focus. Tap the field first (e.g. tap({ testID: 'search' }))." +
+            "\nLIMITATIONS: Requires Bridgeless/Fabric (RN new architecture). Returns 'no focused TextInput' if nothing is focused.",
+        inputSchema: {
+            device: z
+                .string()
+                .optional()
+                .describe("Optional device name (substring match). Uses default device if not specified.")
+        }
+    }, async ({ device }) => {
+        const result = await dismissKeyboard(device);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.success
+                        ? `Dismissed keyboard (nativeTag ${result.nativeTag}).`
+                        : `Error: ${result.error}`
+                }
+            ],
+            isError: !result.success
+        };
+    });
+    // Tool: iOS input text
+    registerToolWithTelemetry(server, "ios_input_text", {
+        description: "Type text on an iOS simulator." +
+            platformFallbackBanner("`tap(text=...)` — it auto-focuses TextInput via the fiber tree") +
+            " The text is typed into whichever field currently has focus (tap an input first). Mirrors `android_input_text` so cross-platform agents can use `<platform>_input_text` without branching on the iOS driver shell-out." +
+            "\nPURPOSE: Send keystrokes to the focused field on an iOS simulator via the active UI driver (AXe — preferred — or IDB)." +
+            "\nWHEN TO USE: Only after an input is already focused, or when `tap(testID=...)` on the input didn't take focus for some reason. Use the testID-first flow whenever possible — it's faster and survives UI repositioning." +
+            "\nREPLACE MODE: pass replace:true to clear the focused field first (via React onChangeText so controlled state stays consistent), then type the new value. Use for pre-filled fields where appending would corrupt the value." +
+            "\nLIMITATIONS: AXe types via the US-keyboard HID — non-ASCII characters (Cyrillic, CJK, Arabic) may not transmit correctly. If the active driver is AXe and the text contains non-ASCII chars, prefer pasting via the simulator pasteboard or setting IOS_DRIVER=idb." +
+            "\nSEE ALSO: call get_usage_guide(topic=\"interact\") for the full UI-interaction playbook.",
+        inputSchema: {
+            text: z.string().describe("Text to type into the currently focused field."),
+            replace: z
+                .boolean()
+                .optional()
+                .describe("If true, clear the focused TextInput via React onChangeText before typing. Use to set a pre-filled field to an exact value without concatenation. Requires Bridgeless/Fabric."),
+            device: z
+                .string()
+                .optional()
+                .describe("Optional RN device name (substring match) — needed by replace:true when multiple RN apps are connected, to disambiguate which device's focused input to clear. Single-device sessions can omit."),
+            udid: z.string().optional().describe("Optional iOS target. Accepts a simulator UDID, the simulator name (e.g. 'iPhone 17 Pro'), or a substring of the connected RN device name. Uses booted simulator if not specified.")
+        }
+    }, async ({ text, replace, device, udid }) => {
+        const r = await resolveIosUdid(udid);
+        if (!r.ok)
+            return r.response;
+        const result = await inputTextWithReplace(text, replace === true, (t) => iosInputText(t, r.udid), () => clearFocusedInput(device));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.success ? result.result : `Error: ${result.error}`
+                }
+            ],
+            isError: !result.success
+        };
+    });
+}
+//# sourceMappingURL=interactionTools.js.map

package/build/tools/interactionTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactionTools.js","sourceRoot":"","sources":["../../src/tools/interactionTools.ts"],"names":[],"mappings":"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"}

package/build/tools/logTools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLogTools(server: McpServer): void;
+//# sourceMappingURL=logTools.d.ts.map

package/build/tools/logTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logTools.d.ts","sourceRoot":"","sources":["../../src/tools/logTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8BzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqZxD"}