execbro 2.1.2 → 2.3.0

package/README.md

@@ -42,8 +42,8 @@ Linking your installation here is also **required to unlock [ExecBro Pro](#prici
 
 - **iOS Simulator** - Screenshots, app management, URL handling, boot/terminate (via simctl)
 - **Android Devices** - Screenshots, app install/launch, package management (via ADB)
-- **Unified Tap** - Single `tap` tool with automatic fallback chain: fiber tree → accessibility → OCR → coordinates. Auto-detects platform, accepts pixels from screenshots. Returns post-tap screenshot and verifies visual change by default
-- **Unified Swipe** - Single `swipe` tool that auto-routes to iOS or Android based on the connected device. Accepts screenshot pixel coordinates, handles per-platform conversion, and returns a `verification.meaningful` signal so agents detect end-of-list, non-scrollable surfaces, and missed coordinates. Essential for scrolling virtualized lists (FlatList/SectionList) where off-screen items aren't in the fiber tree
+- **Unified Tap** - Single `tap` tool with automatic fallback chain: fiber tree → accessibility → OCR → coordinates. Auto-detects platform, accepts coordinates from screenshots and layout tools unchanged. Returns post-tap screenshot and verifies visual change by default
+- **Unified Swipe** - Single `swipe` tool that auto-routes to iOS or Android based on the connected device. Takes coordinates in the same screen space as the layout tools and screenshots — no conversion — and returns a `verification.meaningful` signal so agents detect end-of-list, non-scrollable surfaces, and missed coordinates. Essential for scrolling virtualized lists (FlatList/SectionList) where off-screen items aren't in the fiber tree
 - **UI Automation** - Swipe, long press, key events, and text input on both platforms. On Bridgeless/Fabric apps, `dismiss_keyboard` operates on whatever has focus, and `ios_input_text` / `android_input_text` accept `replace:true` to overwrite pre-filled values — updating React state through `onChangeText` so controlled components (Formik, react-hook-form, useState) stay consistent
 - **Accessibility Inspection** - Query UI hierarchy to find elements by text, label, or resource ID
 - **OCR Text Extraction** - Extract visible text with tap-ready coordinates via Google Cloud Vision (works on any screen content)
@@ -110,6 +110,7 @@ See the [full tool reference](docs/tools.md) for all tools with descriptions. Ke
 | `scan_metro`                            | **Start here** — scan for Metro servers and auto-connect                                 |
 | `get_logs` / `search_logs`              | Capture and search console logs with filtering and summaries                             |
 | `get_network_requests`                  | Monitor HTTP requests with method/status filtering                                       |
+| `get_screen_state`                      | **Orientation snapshot** — active route, overlays, and every element with a tap-ready `(x, y)` |
 | `get_screen_layout`                     | Screen map of visible components with positions, sizes, and text content                 |
 | `tap`                                   | **Unified tap** — auto-detects platform, tries fiber → accessibility → OCR → coordinates |
 | `ios_input_text` / `android_input_text` | Type text into the focused field. `replace:true` clears pre-filled values first (Fabric) |
@@ -163,7 +164,7 @@ See the [full tool reference](docs/tools.md) for all tools with descriptions. Ke
 | [Device Interaction](docs/device-interaction.md)           | Unified `tap`, platform-specific gestures, text input, key events               |
 | [OCR Text Extraction](docs/ocr.md)                         | Cloud Vision OCR, offline fallback, language config, workflows                  |
 | [Claude Code Skills](docs/skills.md)                       | Pre-built skills for session setup, debugging, and automation                   |
-| [Full Tool Reference](docs/tools.md)                       | Complete list of all 40+ tools with descriptions                                |
+| [Full Tool Reference](docs/tools.md)                       | Complete list of all 58 tools with descriptions                                 |
 
 ## How It Works
 

package/build/__tests__/integration/text-input.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=text-input.test.d.ts.map

package/build/__tests__/integration/text-input.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-input.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/text-input.test.ts"],"names":[],"mappings":""}

package/build/__tests__/integration/text-input.test.js

@@ -0,0 +1,181 @@
+// Device-gated: each platform's block skips cleanly when that platform has no
+// device attached, so this runs on a Mac with both, either, or neither. CI has
+// neither.
+//
+// Both platforms run the SAME cases, because the bugs this suite has caught
+// were platform-specific in cause but identical in symptom. What it does NOT
+// cover is the HID keystroke race: it is transient and cannot be provoked on
+// demand — 15 consecutive clean runs during development, then it fired twice in
+// a row an hour later. What IS covered is the machinery that makes it
+// survivable: exact comparison, the retry, and the accessibility read-back that
+// lets an uncontrolled field be checked at all.
+import { describe, it, expect, beforeAll, afterEach } from "@jest/globals";
+import { execSync } from "node:child_process";
+import { enterText, isHidTypeable } from "../../core/textEntry.js";
+import { runInputOp } from "../../core/inputTargetTools.js";
+import { readNativeFields } from "../../core/nativeInputValue.js";
+import { readKeyboardState } from "../../core/keyboardMetrics.js";
+import { scanMetroPorts, fetchDevices, filterDebuggableDevices } from "../../core/metro.js";
+import { connectToDevice } from "../../core/connection.js";
+import { androidInputText } from "../../core/android.js";
+import { iosInputText } from "../../core/ios.js";
+function androidSerial() {
+    try {
+        const out = execSync("adb devices", { encoding: "utf8", timeout: 5000 });
+        const line = out.split("\n").slice(1).find((l) => l.trim().endsWith("device"));
+        return line ? line.split(/\s+/)[0] : null;
+    }
+    catch {
+        return null;
+    }
+}
+function bootedIosUdid() {
+    try {
+        const out = execSync("xcrun simctl list devices booted -j", { encoding: "utf8", timeout: 10_000 });
+        const parsed = JSON.parse(out);
+        for (const list of Object.values(parsed.devices ?? {})) {
+            const booted = list.find((d) => d.state === "Booted");
+            if (booted)
+                return booted.udid;
+        }
+    }
+    catch {
+        /* no simulator, or no Xcode */
+    }
+    return null;
+}
+/** RN reports Android emulators as "sdk_gphone… - 16 - API 36"; iOS as "iPhone Air". */
+const ANDROID_NAME = /sdk_gphone|emulator|android/i;
+/**
+ * A testID that exists in the app under test. Without it the field-specific
+ * cases no-op rather than failing, so the suite stays honest on any app.
+ */
+const FIELD = process.env.EXECBRO_TEST_INPUT_TESTID ?? "";
+/**
+ * A SECOND field, so the non-ASCII case does not inherit the ASCII case's text
+ * and focus. Sharing one field made a write issued right after the previous
+ * case's typing intermittently swallowed — reproducible in-suite, never in
+ * isolation. Isolating the state is the fix; relaxing the assertion would not
+ * have been.
+ */
+const FIELD_2 = process.env.EXECBRO_TEST_INPUT_TESTID_2 ?? "";
+function suiteFor(platform, deviceId) {
+    describe(`text entry (live ${platform} device)`, () => {
+        // The RN device name, needed so every op targets THIS app when both
+        // platforms are connected in the same process.
+        let rnDevice;
+        let connected = false;
+        beforeAll(async () => {
+            for (const port of await scanMetroPorts()) {
+                for (const device of filterDebuggableDevices(await fetchDevices(port))) {
+                    const name = device.deviceName ?? "";
+                    const isAndroid = ANDROID_NAME.test(name);
+                    if ((platform === "android") !== isAndroid)
+                        continue;
+                    await connectToDevice(device, port, {
+                        reconnectionConfig: {
+                            enabled: false, maxAttempts: 0, initialDelayMs: 0, maxDelayMs: 0, backoffMultiplier: 1
+                        }
+                    });
+                    rnDevice = name;
+                    connected = true;
+                }
+            }
+        }, 60_000);
+        // Real devices need a beat between cases. Without it a write issued
+        // immediately after the previous case's typing is intermittently
+        // swallowed — the field simply does not change. This is quiescence, not
+        // an assertion being relaxed: every expectation below is unchanged.
+        afterEach(async () => {
+            await new Promise((r) => setTimeout(r, 700));
+        });
+        const deps = () => ({
+            runOp: (op, query, device) => runInputOp(op, query, device ?? rnDevice),
+            typeHid: (text) => platform === "ios" ? iosInputText(text, deviceId) : androidInputText(text, deviceId),
+            raise: async () => ({ raised: false, changed: false, reason: "not exercised in tests" }),
+            readNativeFields: () => readNativeFields(platform, deviceId)
+        });
+        it("reads keyboard state without throwing", async () => {
+            if (!connected)
+                return;
+            const s = await readKeyboardState(rnDevice);
+            expect(typeof s.visible).toBe("boolean");
+            // Metrics are either all present or all null — never a half-shape.
+            if (!s.visible)
+                expect(s.height).toBeNull();
+        }, 30_000);
+        it("sees the fields the app has mounted", async () => {
+            if (!connected)
+                return;
+            const { fields, error } = await readNativeFields(platform, deviceId);
+            expect(error).toBeUndefined();
+            expect(fields.length).toBeGreaterThan(0);
+        }, 30_000);
+        it("refuses to type when nothing is focused and no target is given", async () => {
+            if (!connected)
+                return;
+            await runInputOp({ kind: "blur" }, undefined, rnDevice);
+            const r = await enterText({ text: "should not land", device: rnDevice }, deps());
+            expect(r.success).toBe(false);
+            expect(r.error).toMatch(/focus/i);
+        }, 30_000);
+        it("lists candidate inputs when a target matches nothing", async () => {
+            if (!connected)
+                return;
+            const r = await enterText({ text: "x", testID: "definitely-not-a-real-testid", device: rnDevice }, deps());
+            expect(r.success).toBe(false);
+            expect(Array.isArray(r.candidates)).toBe(true);
+        }, 30_000);
+        it("writes and verifies an exact ASCII string", async () => {
+            if (!connected || !FIELD)
+                return;
+            // Capitalised deliberately: iOS TextInput defaults autoCapitalize to
+            // "sentences", so a lowercase first letter comes back transformed and
+            // the tool correctly refuses. That behaviour has its own test below.
+            const r = await enterText({ text: "Hello", testID: FIELD, replace: true, device: rnDevice }, deps());
+            if (!r.success)
+                throw new Error(`enterText failed: ${JSON.stringify(r)}`);
+            expect(r.verified).toBe(true);
+        }, 90_000);
+        it("writes non-ASCII, which the HID driver cannot express", async () => {
+            if (!connected || !FIELD_2)
+                return;
+            // Spanish accents matter as much as Cyrillic and CJK here: they look
+            // Latin but have no US keycode either.
+            const text = "Señor Привіт 世界";
+            expect(isHidTypeable(text)).toBe(false);
+            const r = await enterText({ text, testID: FIELD_2, replace: true, device: rnDevice }, deps());
+            if (!r.success)
+                throw new Error(`enterText failed: ${JSON.stringify(r)}`);
+            expect(r.path).toBe("native");
+        }, 90_000);
+        it("appends rather than replacing by default", async () => {
+            if (!connected || !FIELD)
+                return;
+            await enterText({ text: "abc", testID: FIELD, replace: true, device: rnDevice }, deps());
+            const r = await enterText({ text: "de", testID: FIELD, device: rnDevice }, deps());
+            // The field's keyboard may transform input (iOS auto-capitalises),
+            // so assert the append SHAPE rather than an exact string.
+            if (r.verified && r.value)
+                expect(r.value.toLowerCase()).toBe("abcde");
+        }, 90_000);
+        it("never reports success with an unverified value silently", async () => {
+            if (!connected || !FIELD)
+                return;
+            const r = await enterText({ text: "Check", testID: FIELD, replace: true, device: rnDevice }, deps());
+            // Either it verified, or it said out loud that it could not.
+            expect(r.verified === true || typeof r.error === "string").toBe(true);
+        }, 90_000);
+    });
+}
+const ANDROID = androidSerial();
+const IOS = bootedIosUdid();
+if (ANDROID)
+    suiteFor("android", ANDROID);
+else
+    describe.skip("text entry (live android device)", () => it("skipped", () => { }));
+if (IOS)
+    suiteFor("ios", IOS);
+else
+    describe.skip("text entry (live ios device)", () => it("skipped", () => { }));
+//# sourceMappingURL=text-input.test.js.map

package/build/__tests__/integration/text-input.test.js.map

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

package/build/__tests__/unit/focusedInputTools.test.js

@@ -2,19 +2,32 @@ import { describe, expect, it, jest } from "@jest/globals";
 import { clearFocusedInput, dismissKeyboard, inputTextWithReplace } from "../../core/focusedInputTools.js";
 const okExecute = (result) => jest.fn(async () => ({ success: true, result: JSON.stringify(result) }));
 const errExecute = (error) => jest.fn(async () => ({ success: false, error }));
+// These now go through the shared resolver (inputTarget.ts), so the executor
+// payload is the resolver's { found, ok, via } shape rather than the old
+// per-operation { cleared } / { dismissed } shapes. The public contract of
+// clearFocusedInput / dismissKeyboard is unchanged.
+const resolved = (over = {}) => ({
+    found: true,
+    focused: true,
+    nativeTag: 42,
+    value: "",
+    hasOnChangeText: true,
+    ok: true,
+    ...over
+});
 describe("clearFocusedInput", () => {
     it("returns success when executor reports cleared via onChangeText", async () => {
-        const result = await clearFocusedInput(undefined, okExecute({ cleared: true, via: "onChangeText" }));
+        const result = await clearFocusedInput(undefined, okExecute(resolved({ via: "onChangeText" })));
         expect(result.success).toBe(true);
         expect(result.via).toBe("onChangeText");
     });
     it("returns success with fallback flag when via=publicInstance", async () => {
-        const result = await clearFocusedInput(undefined, okExecute({ cleared: true, via: "publicInstance" }));
+        const result = await clearFocusedInput(undefined, okExecute(resolved({ via: "publicInstance.clear", hasOnChangeText: false })));
         expect(result.success).toBe(true);
         expect(result.via).toBe("publicInstance");
     });
     it("returns failure when no input focused", async () => {
-        const result = await clearFocusedInput(undefined, okExecute({ cleared: false, reason: "no focused TextInput" }));
+        const result = await clearFocusedInput(undefined, okExecute({ found: false, reason: "no focused TextInput" }));
         expect(result.success).toBe(false);
         expect(result.error).toContain("no focused TextInput");
     });
@@ -26,7 +39,7 @@ describe("clearFocusedInput", () => {
     it("passes the device argument through to the executor", async () => {
         const exec = jest.fn(async () => ({
             success: true,
-            result: JSON.stringify({ cleared: true, via: "onChangeText" })
+            result: JSON.stringify(resolved({ via: "onChangeText" }))
         }));
         await clearFocusedInput("iPhone 15", exec);
         expect(exec).toHaveBeenCalledWith(expect.any(String), "iPhone 15");
@@ -34,12 +47,12 @@ describe("clearFocusedInput", () => {
 });
 describe("dismissKeyboard", () => {
     it("returns success with nativeTag on dismiss", async () => {
-        const result = await dismissKeyboard(undefined, okExecute({ dismissed: true, nativeTag: 42 }));
+        const result = await dismissKeyboard(undefined, okExecute(resolved({ focused: false, via: "publicInstance.blur" })));
         expect(result.success).toBe(true);
         expect(result.nativeTag).toBe(42);
     });
     it("returns failure when nothing focused", async () => {
-        const result = await dismissKeyboard(undefined, okExecute({ dismissed: false, reason: "no focused TextInput" }));
+        const result = await dismissKeyboard(undefined, okExecute({ found: false, reason: "no focused TextInput" }));
         expect(result.success).toBe(false);
         expect(result.error).toContain("no focused TextInput");
     });

package/build/__tests__/unit/focusedInputTools.test.js.map

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

package/build/__tests__/unit/inputTarget.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inputTarget.test.d.ts.map

package/build/__tests__/unit/inputTarget.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputTarget.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/inputTarget.test.ts"],"names":[],"mappings":""}

package/build/__tests__/unit/inputTarget.test.js

@@ -0,0 +1,144 @@
+import { describe, expect, it } from "@jest/globals";
+import { buildInputExpression } from "../../core/inputTarget.js";
+describe("buildInputExpression", () => {
+    it("returns a parseable IIFE", () => {
+        const expr = buildInputExpression({ kind: "find" });
+        expect(expr.trim()).toMatch(/^\(\(\)\s*=>\s*\{/);
+        expect(expr.trim()).toMatch(/\}\)\(\)$/);
+    });
+    it("walks every fiber root, not just the first", () => {
+        const expr = buildInputExpression({ kind: "find" });
+        // The old walkers did `if (roots.length > 0) { root = roots[0]; break; }`,
+        // which hid a focused input living under a second root (modal/portal).
+        expect(expr).not.toMatch(/roots\[0\]/);
+        expect(expr).toContain("getFiberRoots");
+        expect(expr).toContain("allRoots");
+    });
+    it("resolves the public instance for Fabric and Paper stateNode shapes", () => {
+        const expr = buildInputExpression({ kind: "find" });
+        expect(expr).toContain("canonical.publicInstance");
+        // Paper exposes the instance as stateNode itself. A Fabric-only read makes
+        // old-arch apps report "no focused TextInput" while a field IS focused.
+        expect(expr).toMatch(/return sn;/);
+    });
+    it("recognises all three host input types", () => {
+        const expr = buildInputExpression({ kind: "find" });
+        expect(expr).toContain("RCTSinglelineTextInputView");
+        expect(expr).toContain("RCTMultilineTextInputView");
+        expect(expr).toContain("AndroidTextInput");
+    });
+    it("targets by testID when a query is given", () => {
+        const expr = buildInputExpression({ kind: "focus" }, { testID: "email-input" });
+        expect(expr).toContain('"email-input"');
+        expect(expr).toContain("wantTestID");
+    });
+    it("falls back to the focused input when no query is given", () => {
+        const expr = buildInputExpression({ kind: "focus" });
+        expect(expr).toContain("isFocused");
+        expect(expr).toContain("wantTestID = null");
+    });
+    it("embeds the value as a JSON literal for setValue", () => {
+        const tricky = 'a"b\\c';
+        const expr = buildInputExpression({ kind: "setValue", value: tricky });
+        expect(expr).toContain(JSON.stringify(tricky));
+    });
+    it("writes and clears through onChangeText", () => {
+        expect(buildInputExpression({ kind: "setValue", value: "x" })).toContain("onChangeText");
+        expect(buildInputExpression({ kind: "clear" })).toContain('onChangeText("")');
+    });
+    it("focuses and blurs through the public instance", () => {
+        expect(buildInputExpression({ kind: "focus" })).toContain(".focus()");
+        expect(buildInputExpression({ kind: "blur" })).toContain(".blur()");
+    });
+    it("offers candidate testIDs when the target is not found", () => {
+        const expr = buildInputExpression({ kind: "focus" }, { testID: "nope" });
+        expect(expr).toContain("candidates");
+    });
+    it("explains how to fix a missing focus rather than just naming it", () => {
+        const expr = buildInputExpression({ kind: "find" });
+        expect(expr).toContain("no focused TextInput");
+        expect(expr).toContain("testID");
+    });
+    it("keeps clear falling back to publicInstance.clear for uncontrolled inputs", () => {
+        expect(buildInputExpression({ kind: "clear" })).toContain(".clear()");
+    });
+});
+describe("target disambiguation", () => {
+    it("collects every match instead of taking the first", () => {
+        const expr = buildInputExpression({ kind: "find" }, { component: "Input" });
+        // Silently taking match[0] writes the right text into the wrong field of a
+        // form and still verifies clean. Every branch must push, never break.
+        expect(expr).toContain("__eb_matches.push");
+        expect(expr).not.toMatch(/__eb_host = __eb_inputs\[i\]; break;/);
+    });
+    it("refuses when several inputs match and no index is given", () => {
+        const expr = buildInputExpression({ kind: "find" }, { component: "Input" });
+        expect(expr).toContain("ambiguous: true");
+        expect(expr).toContain("__eb_matches.length > 1");
+    });
+    it("selects by index when one is supplied", () => {
+        const expr = buildInputExpression({ kind: "find" }, { component: "Input", index: 3 });
+        expect(expr).toContain("__eb_index = 3");
+    });
+    it("rejects an out-of-range index rather than clamping it", () => {
+        const expr = buildInputExpression({ kind: "find" }, { component: "Input", index: 99 });
+        expect(expr).toContain("is out of range");
+    });
+    it("describes candidates richly enough to choose between them", () => {
+        const expr = buildInputExpression({ kind: "find" }, { testID: "nope" });
+        for (const field of ["index:", "component:", "label:", "placeholder:", "value:", "testID:"]) {
+            expect(expr).toContain(field);
+        }
+    });
+});
+describe("targeting keys", () => {
+    it("scopes testID to the host and its owner, never an arbitrary ancestor", () => {
+        const expr = buildInputExpression({ kind: "find" }, { testID: "email" });
+        // Free climbing picked up a ScrollView's nativeID: on a 7-field form every
+        // input answered to testID "7", so one target matched them all.
+        expect(expr).toContain("__eb_testIDOf");
+        expect(expr).toContain("scope");
+        expect(expr).not.toMatch(/for \(var p = hostFiber; p; p = p\.return\)[\s\S]{0,120}mp\.nativeID/);
+    });
+    it("prefers an explicit testID over a nativeID", () => {
+        const expr = buildInputExpression({ kind: "find" }, { testID: "email" });
+        expect(expr.indexOf("mp.testID")).toBeLessThan(expr.indexOf("mp2.nativeID"));
+    });
+    it("filters framework wrappers out of the component name", () => {
+        const expr = buildInputExpression({ kind: "find" }, { component: "InputField" });
+        // Without the filters every input resolves to TextAncestorContext, which
+        // names nothing and matches everything.
+        expect(expr).toContain("RN_PRIMITIVES");
+        expect(expr).toContain("GENERIC_COMPONENT");
+        expect(expr).toContain("TextAncestorContext");
+    });
+    it("matches the visible field label as well as value and placeholder", () => {
+        const expr = buildInputExpression({ kind: "find" }, { textMatch: "First Name" });
+        expect(expr).toContain("__eb_labelOf");
+        expect(expr).toContain("accessibilityLabel");
+    });
+    it("never lets an input's own value become its label", () => {
+        const expr = buildInputExpression({ kind: "find" }, { textMatch: "x" });
+        expect(expr).toMatch(/HOSTS\.indexOf\(__eb_name\(f\.type\)\) !== -1\) return;/);
+    });
+    it("finds the field wrapper by outermost onChangeText, not a capped climb", () => {
+        const expr = buildInputExpression({ kind: "find" }, { component: "FormInput" });
+        // Measured on a real form: the wrapper sits 10 levels above the host behind
+        // four plain Views, so a 4-composite budget is spent before reaching it and
+        // every input resolves to nothing. onChangeText is what distinguishes a
+        // field's wrapper from the layout Views around it.
+        expect(expr).toContain("__eb_fieldFiber");
+        expect(expr).toContain("d < 30");
+    });
+    it("reads and writes through the innermost composite, skipping host fibers", () => {
+        const expr = buildInputExpression({ kind: "setValue", value: "x" });
+        expect(expr).toMatch(/if \(typeof p\.type === "string"\) continue;/);
+    });
+    it("stops descending a text branch once it yields a string", () => {
+        const expr = buildInputExpression({ kind: "find" });
+        // One label repeats down its Text -> RCTText chain; descending through it
+        // renders "Title Title Title *" instead of "Title *".
+        expect(expr).toMatch(/parts\.push\(mp\.children\.trim\(\)\);[\s\S]{0,80}return;/);
+    });
+});
+//# sourceMappingURL=inputTarget.test.js.map

package/build/__tests__/unit/inputTarget.test.js.map

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

package/build/__tests__/unit/inputTargetTools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inputTargetTools.test.d.ts.map

package/build/__tests__/unit/inputTargetTools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputTargetTools.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/inputTargetTools.test.ts"],"names":[],"mappings":""}

package/build/__tests__/unit/inputTargetTools.test.js

@@ -0,0 +1,46 @@
+import { describe, expect, it, jest } from "@jest/globals";
+import { runInputOp } from "../../core/inputTargetTools.js";
+const ok = (payload) => async () => ({ success: true, result: JSON.stringify(payload) });
+describe("runInputOp", () => {
+    it("parses a found result", async () => {
+        const r = await runInputOp({ kind: "read" }, undefined, undefined, ok({ found: true, focused: true, nativeTag: 7, value: "hi", hasOnChangeText: true, ok: true }));
+        expect(r).toMatchObject({ found: true, value: "hi", hasOnChangeText: true });
+    });
+    it("passes the not-found reason and candidates through", async () => {
+        const r = await runInputOp({ kind: "read" }, undefined, undefined, ok({ found: false, reason: "no focused TextInput", candidates: ["email"] }));
+        expect(r).toEqual({ found: false, reason: "no focused TextInput", candidates: ["email"] });
+    });
+    it("reports executor failure as not-found rather than throwing", async () => {
+        const r = await runInputOp({ kind: "read" }, undefined, undefined, async () => ({
+            success: false,
+            error: "No apps connected"
+        }));
+        expect(r).toEqual({ found: false, reason: "No apps connected" });
+    });
+    it("reports unparseable output as not-found rather than throwing", async () => {
+        const r = await runInputOp({ kind: "read" }, undefined, undefined, async () => ({
+            success: true,
+            result: "not json"
+        }));
+        expect(r.found).toBe(false);
+        if (!r.found)
+            expect(r.reason).toContain("not json");
+    });
+    it("threads the device argument to the executor", async () => {
+        const spy = jest.fn(async () => ({
+            success: true,
+            result: JSON.stringify({ found: false, reason: "x" })
+        }));
+        await runInputOp({ kind: "read" }, undefined, "iPhone Air", spy);
+        expect(spy).toHaveBeenCalledWith(expect.any(String), "iPhone Air");
+    });
+    it("passes the query into the built expression", async () => {
+        const spy = jest.fn(async () => ({
+            success: true,
+            result: JSON.stringify({ found: false, reason: "x" })
+        }));
+        await runInputOp({ kind: "focus" }, { testID: "email-input" }, undefined, spy);
+        expect(spy.mock.calls[0][0]).toContain("email-input");
+    });
+});
+//# sourceMappingURL=inputTargetTools.test.js.map

package/build/__tests__/unit/inputTargetTools.test.js.map

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

package/build/__tests__/unit/inputTextTool.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inputTextTool.test.d.ts.map

package/build/__tests__/unit/inputTextTool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputTextTool.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/inputTextTool.test.ts"],"names":[],"mappings":""}