react-native-ai-debugger 1.8.0 → 1.9.0

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

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

package/build/tools/interactionTools.js

@@ -0,0 +1,558 @@
+import { z } from "zod";
+import { registerToolWithTelemetry } from "../core/register.js";
+import { androidLongPress, androidSwipe, androidInputText, androidKeyEvent, ANDROID_KEY_EVENTS, iosButton, iosInputText, iosSwipe, IOS_BUTTON_TYPES, getActiveOrBootedSimulatorUdid, getDevicePixelRatio, getDefaultAndroidDevice, findSimulatorByName, connectedApps, } from "../core/index.js";
+import { tap, convertScreenshotToTapCoords } from "../pro/tap.js";
+import { clearFocusedInput, dismissKeyboard, inputTextWithReplace } from "../core/focusedInputTools.js";
+import { primaryInteractionBanner, platformFallbackBanner, platformUniqueBanner } from "../core/toolHelpers.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. When iOS AND Android are connected, pass platform explicitly.\n" +
+            "GOOD: tap({ testID: \"login-btn\" }); tap({ text: \"Submit\" }); tap({ x: 300, y: 600 }); tap({ x: 300, y: 600, native: true, platform: \"android\" })\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."),
+            platform: z
+                .enum(["ios", "android"])
+                .optional()
+                .describe("Target platform. Required when both iOS and Android devices are connected. Auto-detected if only one platform is available."),
+            device: z
+                .string()
+                .optional()
+                .describe("Target device name (substring match against the connected RN app's device name). " +
+                "Use to pin the tap to a specific device when multiple are connected (e.g. \"iPhone SE\"). " +
+                "Run get_apps to see connected device names. For iOS, the matched device's simulatorUdid is used to scope the tap."),
+            udid: z
+                .string()
+                .optional()
+                .describe("iOS simulator UDID (from list_ios_simulators). Takes precedence over device/platform when set. " +
+                "iOS-only — pairing with platform=\"android\" returns an error."),
+            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,
+            platform: args.platform,
+            device: args.device,
+            udid: args.udid,
+            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 device ID. Uses first available device if not specified.")
+        }
+    }, async ({ x, y, durationMs, deviceId }) => {
+        const result = await androidLongPress(x, y, durationMs, deviceId);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.success ? result.result : `Error: ${result.error}`
+                }
+            ],
+            isError: !result.success
+        };
+    });
+    // Tool: Android swipe
+    registerToolWithTelemetry(server, "android_swipe", {
+        description: "Swipe from one point to another on an Android device/emulator screen" +
+            platformFallbackBanner("`tap` for targeted interactions; keep android_swipe for raw-coordinate gestures") +
+            "\nPURPOSE: Perform a raw-coordinate swipe gesture for scrolling, paging, dismissing sheets, or drawer opens on Android." +
+            "\nWHEN TO USE: When you need a gesture rather than a tap — scroll lists, swipe carousels, or pull-to-refresh." +
+            "\nSEE ALSO: call get_usage_guide(topic=\"interact\") for the full UI-interaction playbook.",
+        inputSchema: {
+            startX: z.coerce.number().describe("Starting X coordinate in pixels"),
+            startY: z.coerce.number().describe("Starting Y coordinate in pixels"),
+            endX: z.coerce.number().describe("Ending X coordinate in pixels"),
+            endY: z.coerce.number().describe("Ending Y coordinate in pixels"),
+            durationMs: z.number().optional().default(300).describe("Swipe duration in milliseconds (default: 300)"),
+            deviceId: z
+                .string()
+                .optional()
+                .describe("Optional device ID. Uses first available device if not specified.")
+        }
+    }, async ({ startX, startY, endX, endY, durationMs, deviceId }) => {
+        const result = await androidSwipe(startX, startY, endX, endY, durationMs, deviceId);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.success ? result.result : `Error: ${result.error}`
+                }
+            ],
+            isError: !result.success
+        };
+    });
+    // Tool: iOS swipe
+    registerToolWithTelemetry(server, "ios_swipe", {
+        description: "Swipe gesture on an iOS simulator screen." +
+            platformFallbackBanner("`swipe` for cross-platform gestures; `tap` for targeted interactions") +
+            " Pass screenshot pixel coordinates directly — the same values returned by ios_screenshot pressable elements and screen layout. Coordinates are auto-converted to native iOS points internally. Requires an iOS UI driver: AXe (recommended: brew install cameroncooke/axe/axe) or IDB (brew install idb-companion)." +
+            "\nPURPOSE: Perform a raw-coordinate swipe gesture for scrolling, paging, dismissing sheets, or drawer opens on iOS." +
+            "\nWHEN TO USE: When you need a gesture rather than a tap — scroll lists, swipe carousels, or pull-to-refresh." +
+            "\nSEE 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 (from ios_screenshot output)"),
+            startY: z.coerce.number().describe("Starting Y coordinate in screenshot pixels (from ios_screenshot output)"),
+            endX: z.coerce.number().describe("Ending X coordinate in screenshot pixels (from ios_screenshot output)"),
+            endY: z.coerce.number().describe("Ending Y coordinate in screenshot pixels (from ios_screenshot output)"),
+            duration: z.coerce.number().optional().describe("Optional swipe duration in seconds"),
+            delta: z.coerce.number().optional().describe("Optional delta between touch events (step size)"),
+            udid: z.string().optional().describe("Optional simulator UDID. Uses booted simulator if not specified.")
+        }
+    }, async ({ startX, startY, endX, endY, duration, delta, udid }) => {
+        const dpr = await getDevicePixelRatio(udid);
+        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 result = await iosSwipe(start.x, start.y, end.x, end.y, { duration, delta, udid });
+        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)." +
+            primaryInteractionBanner() + "\n" +
+            "PURPOSE: Single unified swipe entry point — accepts screenshot pixel coordinates and dispatches to ios_swipe or android_swipe based on the connected device.\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" +
+            "WORKFLOW: ios_screenshot or android_screenshot -> swipe({ startX, startY, endX, endY }) -> screenshot again to verify.\n" +
+            "LIMITATIONS: iOS needs AXe (brew install cameroncooke/axe/axe) or IDB. When both iOS and Android devices are connected, pass platform explicitly.\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)"),
+            platform: z
+                .enum(["ios", "android"])
+                .optional()
+                .describe("Target platform. Required when both iOS and Android devices are connected. Auto-detected if only one is available."),
+            device: z
+                .string()
+                .optional()
+                .describe("Optional iOS simulator name (substring match) to disambiguate when multiple simulators are booted."),
+            udid: z.string().optional().describe("Optional iOS simulator UDID. Forces iOS targeting."),
+            deviceId: z.string().optional().describe("Optional Android device ID. Uses first available Android device if not specified.")
+        }
+    }, async ({ startX, startY, endX, endY, durationMs, platform, device, udid, deviceId }) => {
+        // Platform resolution mirrors the tap() native-mode flow (src/pro/tap.ts).
+        if (udid && platform === "android") {
+            return {
+                content: [{ type: "text", text: 'Error: udid is only valid for iOS. Got platform: "android".' }],
+                isError: true
+            };
+        }
+        let resolvedPlatform = platform;
+        let resolvedUdid;
+        if (udid) {
+            resolvedPlatform = "ios";
+            resolvedUdid = udid;
+        }
+        else if (!resolvedPlatform) {
+            const deviceMatchedUdid = device
+                ? await findSimulatorByName(device).catch(() => null)
+                : null;
+            if (deviceMatchedUdid) {
+                resolvedPlatform = "ios";
+                resolvedUdid = deviceMatchedUdid;
+            }
+            else {
+                const [androidDevice, iosSimulator] = await Promise.all([
+                    getDefaultAndroidDevice().catch(() => null),
+                    getActiveOrBootedSimulatorUdid().catch(() => null)
+                ]);
+                if (androidDevice && iosSimulator) {
+                    return {
+                        content: [{ type: "text", text: 'Error: Multiple platforms detected (both Android and iOS). Specify platform: "android" or platform: "ios" to target the correct device.' }],
+                        isError: true
+                    };
+                }
+                if (androidDevice) {
+                    resolvedPlatform = "android";
+                }
+                else if (iosSimulator) {
+                    resolvedPlatform = "ios";
+                    resolvedUdid = iosSimulator;
+                }
+                else {
+                    return {
+                        content: [{ type: "text", text: "Error: No Android device or iOS simulator found. Connect a device or start a simulator." }],
+                        isError: true
+                    };
+                }
+            }
+        }
+        else if (resolvedPlatform === "ios") {
+            resolvedUdid =
+                (device ? await findSimulatorByName(device).catch(() => null) : null) ??
+                    (await getActiveOrBootedSimulatorUdid().catch(() => null)) ??
+                    undefined;
+        }
+        let result;
+        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;
+            result = await iosSwipe(start.x, start.y, end.x, end.y, { duration, 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);
+            result = await androidSwipe(start.x, start.y, end.x, end.y, durationMs ?? 300, deviceId);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.success ? `[${resolvedPlatform}] ${result.result}` : `Error: ${result.error}`
+                }
+            ],
+            isError: !result.success
+        };
+    });
+    // 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." +
+            "\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 device ID. Uses first available device if not specified.")
+        }
+    }, async ({ text, replace, device, deviceId }) => {
+        const result = await inputTextWithReplace(text, replace === true, (t) => androidInputText(t, deviceId), () => 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 device ID. 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 result = await androidKeyEvent(keyCode, deviceId);
+        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 simulator UDID. Uses booted simulator if not specified.")
+        }
+    }, async ({ button, duration, udid }) => {
+        const result = await iosButton(button, { duration, 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)." +
+            "\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." +
+            "\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 simulator UDID (from list_ios_simulators). Uses booted simulator if not specified.")
+        }
+    }, async ({ text, replace, device, udid }) => {
+        const result = await inputTextWithReplace(text, replace === true, (t) => iosInputText(t, 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"}