react-native-ai-debugger 2.14.1 → 2.16.0

package/README.md

@@ -78,6 +78,11 @@ Linking is only for the dashboard: it attaches your installs to your account so
 
   Keep the `!app.isPackaged` guard: an open debugging port on a packaged build lets anything that can reach it run code in your renderer
 
+### Native Android (preview)
+
+- **Kotlin apps without a JavaScript runtime** - A native app that includes `execbro-sdk-android` in its debug build registers named state and commands. `scan_metro` finds it over adb, `list_debug_globals` and `inspect_global` read its state, `run_app_command` runs its commands, and `navigate` drives Jetpack Navigation
+- **Coming soon** - The SDK is not published to Maven yet. Execbro already supports it; install instructions will follow with the SDK release
+
 ### Under the Hood
 
 - **Auto-Discovery** - Scans Metro on ports 8081-8090 automatically, and lists Chromium/Electron targets on 9222 (plus any ports in `EXECBRO_CHROMIUM_PORTS`)

package/build/__tests__/helpers/fakeNativeSdk.d.ts

@@ -0,0 +1,19 @@
+export declare const NO_REPLY: unique symbol;
+export type FakeHandler = (method: string, params: Record<string, unknown>) => unknown;
+export declare const HELLO: {
+    protocolVersion: number;
+    sdkVersion: string;
+    package: string;
+    label: string;
+    versionName: string;
+    capabilities: string[];
+};
+export declare function rpcError(code: string, message: string): Error;
+export declare function startFakeSdk(handler: FakeHandler): Promise<{
+    port: number;
+    url: string;
+    emit(method: string, params: unknown): void;
+    dropClients(): void;
+    close(): Promise<void>;
+}>;
+//# sourceMappingURL=fakeNativeSdk.d.ts.map

package/build/__tests__/helpers/fakeNativeSdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakeNativeSdk.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/fakeNativeSdk.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,eAAqB,CAAC;AAC3C,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;AAEvF,eAAO,MAAM,KAAK;;;;;;;CAOjB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAE7D;AAGD,wBAAsB,YAAY,CAAC,OAAO,EAAE,WAAW;;;iBAsBlC,MAAM,UAAU,OAAO;;aAM3B,OAAO,CAAC,IAAI,CAAC;GAK7B"}

package/build/__tests__/helpers/fakeNativeSdk.js

@@ -0,0 +1,53 @@
+import { WebSocketServer } from "ws";
+export const NO_REPLY = Symbol("no-reply");
+export const HELLO = {
+    protocolVersion: 1,
+    sdkVersion: "0.1.0",
+    package: "com.example.app",
+    label: "Example",
+    versionName: "1.0",
+    capabilities: ["state", "command", "navigation"]
+};
+export function rpcError(code, message) {
+    return Object.assign(new Error(message), { code });
+}
+export async function startFakeSdk(handler) {
+    const server = new WebSocketServer({ port: 0, host: "127.0.0.1" });
+    await new Promise((resolve) => server.once("listening", () => resolve()));
+    const sockets = [];
+    server.on("connection", (ws) => {
+        sockets.push(ws);
+        ws.on("message", (data) => {
+            const req = JSON.parse(data.toString());
+            try {
+                const result = handler(req.method, req.params ?? {});
+                if (result === NO_REPLY)
+                    return;
+                ws.send(JSON.stringify({ id: req.id, result }));
+            }
+            catch (e) {
+                const err = e;
+                ws.send(JSON.stringify({ id: req.id, error: { code: err.code ?? "THREW", message: err.message } }));
+            }
+        });
+    });
+    const port = server.address().port;
+    return {
+        port,
+        url: `ws://127.0.0.1:${port}`,
+        emit(method, params) {
+            for (const s of sockets)
+                s.send(JSON.stringify({ method, params }));
+        },
+        dropClients() {
+            for (const s of sockets)
+                s.terminate();
+        },
+        close() {
+            for (const s of sockets)
+                s.terminate();
+            return new Promise((resolve) => server.close(() => resolve()));
+        }
+    };
+}
+//# sourceMappingURL=fakeNativeSdk.js.map

package/build/__tests__/helpers/fakeNativeSdk.js.map

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

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

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

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

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

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

@@ -0,0 +1,77 @@
+import { describe, it, expect, afterEach, beforeEach } from "@jest/globals";
+import { connectedApps } from "../../core/state.js";
+import { openNativeSocket } from "../../core/nativeConnection.js";
+import { nativeListDebugGlobals, nativeInspectGlobal, nativeRunCommand } from "../../core/nativeApp.js";
+import { startFakeSdk, rpcError, HELLO } from "../helpers/fakeNativeSdk.js";
+let fake;
+let app;
+let locked = false;
+beforeEach(async () => {
+    locked = false;
+    fake = await startFakeSdk((method, params) => {
+        switch (method) {
+            case "execbro.hello": return HELLO;
+            case "state.list": return [{ name: "lock" }, { name: "prefs" }];
+            case "command.list": return [{ name: "lock", description: "Engage the touch lock" }, { name: "resetPrefs", description: "" }];
+            case "state.get":
+                if (params.name === "lock")
+                    return { value: locked };
+                if (params.name === "prefs")
+                    return { value: { posX: 0, allowedPackages: ["com.google.android.youtube"] } };
+                throw rpcError("NOT_FOUND", `No state named '${String(params.name)}'. Registered: lock, prefs`);
+            case "command.run":
+                if (params.name === "lock") {
+                    locked = true;
+                    return { result: "locked" };
+                }
+                throw rpcError("THREW", "java.lang.IllegalStateException: Bubble service is not running");
+            default: throw rpcError("METHOD_NOT_FOUND", method);
+        }
+    });
+    app = await openNativeSocket(fake.url, { serial: "emulator-5554", pkg: "com.example.app", port: fake.port });
+});
+afterEach(async () => {
+    for (const a of connectedApps.values())
+        a.ws.terminate();
+    connectedApps.clear();
+    await fake.close();
+});
+describe("nativeListDebugGlobals", () => {
+    it("lists state and commands in two groups", async () => {
+        const r = await nativeListDebugGlobals(app);
+        expect(r.success).toBe(true);
+        expect(r.result).toContain("State (read with inspect_global");
+        expect(r.result).toContain("  - prefs");
+        expect(r.result).toContain("Commands (run with run_app_command");
+        expect(r.result).toContain("  - lock: Engage the touch lock");
+        expect(r.result).toContain("  - resetPrefs");
+    });
+});
+describe("nativeInspectGlobal", () => {
+    it("returns the value as JSON", async () => {
+        const r = await nativeInspectGlobal(app, "prefs");
+        expect(JSON.parse(r.result)).toEqual({ posX: 0, allowedPackages: ["com.google.android.youtube"] });
+    });
+    it("reports a missing name with the SDK's code and list", async () => {
+        const r = await nativeInspectGlobal(app, "nope");
+        expect(r.success).toBe(false);
+        expect(r.error).toBe("NOT_FOUND: No state named 'nope'. Registered: lock, prefs");
+    });
+});
+describe("nativeRunCommand", () => {
+    it("lists commands when no name is given", async () => {
+        const r = await nativeRunCommand(app);
+        expect(r.result).toBe("- lock: Engage the touch lock\n- resetPrefs");
+    });
+    it("runs a command and the state reflects it", async () => {
+        expect((await nativeRunCommand(app, "lock")).result).toBe('lock -> "locked"');
+        expect((await nativeInspectGlobal(app, "lock")).result).toBe("true");
+    });
+    it("surfaces an app-side exception", async () => {
+        const r = await nativeRunCommand(app, "unlock");
+        expect(r.success).toBe(false);
+        expect(r.error).toContain("THREW");
+        expect(r.error).toContain("Bubble service is not running");
+    });
+});
+//# sourceMappingURL=nativeApp.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,33 @@
+import { describe, it, expect, jest, afterEach } from "@jest/globals";
+import { startFakeSdk, HELLO } from "../helpers/fakeNativeSdk.js";
+const execFileAsyncMock = jest.fn();
+jest.unstable_mockModule("../../core/exec.js", () => ({
+    execFileAsync: execFileAsyncMock,
+    execAsync: async () => ({ stdout: "", stderr: "" }),
+    quoteForDeviceShell: (v) => v,
+    withCancelableTimeout: (fn) => fn(undefined)
+}));
+const { connectNativeApp } = await import("../../core/nativeConnection.js");
+const { connectedApps } = await import("../../core/state.js");
+let fake = null;
+afterEach(async () => {
+    for (const app of connectedApps.values())
+        app.ws.terminate();
+    connectedApps.clear();
+    await fake?.close();
+    fake = null;
+});
+describe("connectNativeApp", () => {
+    it("shares one connection between concurrent connects to the same app", async () => {
+        fake = await startFakeSdk((m) => (m === "execbro.hello" ? HELLO : null));
+        const port = fake.port;
+        execFileAsyncMock.mockImplementation(async (_file, args) => ({ stdout: args.includes("tcp:0") ? `${port}\n` : "", stderr: "" }));
+        const [a, b] = await Promise.all([
+            connectNativeApp("emulator-5554", "com.example.app"),
+            connectNativeApp("emulator-5554", "com.example.app")
+        ]);
+        expect(a === b).toBe(true);
+        expect(execFileAsyncMock.mock.calls.filter(([, args]) => args.includes("tcp:0"))).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=nativeConnectRace.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nativeConnectRace.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/nativeConnectRace.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,iBAAiB,GAAG,IAAI,CAAC,EAAE,EAAiF,CAAC;AACnH,IAAI,CAAC,mBAAmB,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC;IAClD,aAAa,EAAE,iBAAiB;IAChC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACnD,mBAAmB,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC;IACrC,qBAAqB,EAAE,CAAC,EAAqC,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC;CAClF,CAAC,CAAC,CAAC;AAEJ,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;AAC5E,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAE9D,IAAI,IAAI,GAAoD,IAAI,CAAC;AAEjE,SAAS,CAAC,KAAK,IAAI,EAAE;IACjB,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC;IAC7D,aAAa,CAAC,KAAK,EAAE,CAAC;IACtB,MAAM,IAAI,EAAE,KAAK,EAAE,CAAC;IACpB,IAAI,GAAG,IAAI,CAAC;AAChB,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QAC/E,IAAI,GAAG,MAAM,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,iBAAiB,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAEjI,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC7B,gBAAgB,CAAC,eAAe,EAAE,iBAAiB,CAAC;YACpD,gBAAgB,CAAC,eAAe,EAAE,iBAAiB,CAAC;SACvD,CAAC,CAAC;QAEH,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACtG,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,78 @@
+import { describe, it, expect, afterEach } from "@jest/globals";
+import { connectedApps } from "../../core/state.js";
+import { openNativeSocket, nativeRequest, nativeAppKey, NativeRpcError } from "../../core/nativeConnection.js";
+import { startFakeSdk, rpcError, NO_REPLY, HELLO } from "../helpers/fakeNativeSdk.js";
+const target = { serial: "emulator-5554", pkg: "com.example.app", port: 0 };
+let fake = null;
+afterEach(async () => {
+    for (const app of connectedApps.values())
+        app.ws.terminate();
+    connectedApps.clear();
+    await fake?.close();
+    fake = null;
+});
+function handler(method, params) {
+    if (method === "execbro.hello")
+        return HELLO;
+    if (method === "state.get" && params.name === "lock")
+        return { value: true };
+    if (method === "state.get")
+        throw rpcError("NOT_FOUND", `No state named '${String(params.name)}'`);
+    if (method === "slow")
+        return NO_REPLY;
+    throw rpcError("METHOD_NOT_FOUND", method);
+}
+describe("openNativeSocket", () => {
+    it("registers the app under its native key", async () => {
+        fake = await startFakeSdk(handler);
+        const app = await openNativeSocket(fake.url, { ...target, port: fake.port });
+        expect(nativeAppKey("emulator-5554", "com.example.app")).toBe("native:emulator-5554:com.example.app");
+        expect(connectedApps.get("native:emulator-5554:com.example.app")).toBe(app);
+        expect(app.runtime).toBe("native");
+        expect(app.platform).toBe("android");
+        expect(app.adbSerial).toBe("emulator-5554");
+        expect(app.nativePackage).toBe("com.example.app");
+        expect(app.deviceInfo.deviceName).toBe("Example");
+        expect(app.nativeCapabilities).toEqual(["state", "command", "navigation"]);
+    });
+    it("refuses an SDK speaking another protocol version and registers nothing", async () => {
+        fake = await startFakeSdk((m) => (m === "execbro.hello" ? { ...HELLO, protocolVersion: 2 } : null));
+        await expect(openNativeSocket(fake.url, { ...target, port: fake.port })).rejects.toThrow(/protocol 2/);
+        expect(connectedApps.size).toBe(0);
+    });
+    it("drops the app, rejects pending calls and reports the close when the socket goes away", async () => {
+        fake = await startFakeSdk(handler);
+        let closed = false;
+        const app = await openNativeSocket(fake.url, { ...target, port: fake.port }, () => { closed = true; });
+        const pending = nativeRequest(app.ws, "slow");
+        fake.dropClients();
+        await expect(pending).rejects.toMatchObject({ code: "DISCONNECTED" });
+        await new Promise((r) => setTimeout(r, 20));
+        expect(connectedApps.size).toBe(0);
+        expect(closed).toBe(true);
+    });
+    it("survives socket errors after the connection is open", async () => {
+        fake = await startFakeSdk(handler);
+        const app = await openNativeSocket(fake.url, { ...target, port: fake.port });
+        expect(() => {
+            app.ws.emit("error", new Error("ECONNRESET"));
+            app.ws.emit("error", new Error("ECONNRESET"));
+        }).not.toThrow();
+    });
+});
+describe("nativeRequest", () => {
+    it("resolves results and rejects errors with their code", async () => {
+        fake = await startFakeSdk(handler);
+        const app = await openNativeSocket(fake.url, { ...target, port: fake.port });
+        await expect(nativeRequest(app.ws, "state.get", { name: "lock" })).resolves.toEqual({ value: true });
+        const err = (await nativeRequest(app.ws, "state.get", { name: "nope" }).catch((e) => e));
+        expect(err).toBeInstanceOf(NativeRpcError);
+        expect(err.code).toBe("NOT_FOUND");
+    });
+    it("times out a call the app never answers", async () => {
+        fake = await startFakeSdk(handler);
+        const app = await openNativeSocket(fake.url, { ...target, port: fake.port });
+        await expect(nativeRequest(app.ws, "slow", undefined, 50)).rejects.toMatchObject({ code: "TIMEOUT" });
+    });
+});
+//# sourceMappingURL=nativeConnection.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,67 @@
+import { describe, it, expect } from "@jest/globals";
+import { parseExecbroSockets, discoverAndConnectNativeApps, connectNativePackage } from "../../core/nativeDiscovery.js";
+const PROC_NET_UNIX = [
+    "Num       RefCount Protocol Flags    Type St Inode Path",
+    "0000000000000000: 00000002 00000000 00010000 0001 01 41234 @execbro_com.ihorzheludkov.touchdisabler",
+    "0000000000000000: 00000003 00000000 00000000 0001 03 41240 @execbro_com.ihorzheludkov.touchdisabler",
+    "0000000000000000: 00000002 00000000 00010000 0001 01 51234 @chrome_devtools_remote",
+    "0000000000000000: 00000002 00000000 00010000 0001 01 61234 @execbro_com.example.app",
+    "0000000000000000: 00000002 00000000 00010000 0001 01 71234 /dev/socket/zygote"
+].join("\n");
+describe("parseExecbroSockets", () => {
+    it("returns each SDK package once and ignores other sockets", () => {
+        expect(parseExecbroSockets(PROC_NET_UNIX)).toEqual(["com.ihorzheludkov.touchdisabler", "com.example.app"]);
+    });
+    it("returns nothing for an empty or unreadable listing", () => {
+        expect(parseExecbroSockets("")).toEqual([]);
+        expect(parseExecbroSockets("cat: /proc/net/unix: Permission denied")).toEqual([]);
+    });
+});
+describe("discoverAndConnectNativeApps", () => {
+    it("does nothing, and asks nothing of adb, when adb is missing", async () => {
+        let discovered = false;
+        const lines = await discoverAndConnectNativeApps({
+            adbAvailable: async () => false,
+            discover: async () => { discovered = true; return []; }
+        });
+        expect(lines).toEqual([]);
+        expect(discovered).toBe(false);
+    });
+    it("reports connected apps and connection failures per app", async () => {
+        const lines = await discoverAndConnectNativeApps({
+            adbAvailable: async () => true,
+            discover: async () => [
+                { serial: "emulator-5554", pkg: "com.good" },
+                { serial: "emulator-5554", pkg: "com.bad" }
+            ],
+            connect: async (_serial, pkg) => {
+                if (pkg === "com.bad")
+                    throw new Error("protocol 2");
+                return { deviceInfo: { deviceName: "Good" } };
+            }
+        });
+        expect(lines).toEqual([
+            "Android native (emulator-5554): connected to Good (com.good) via execbro-sdk-android",
+            "Android native (emulator-5554): found com.bad but could not connect: protocol 2"
+        ]);
+    });
+});
+describe("connectNativePackage", () => {
+    it("reports nothing when no device serves the package, so connect_metro falls through to its port", async () => {
+        const lines = await connectNativePackage("github.com", {
+            adbAvailable: async () => true,
+            serials: async () => ["emulator-5554"],
+            connect: async () => { throw new Error("socket hang up"); }
+        });
+        expect(lines).toEqual([]);
+    });
+    it("reports the app it connected", async () => {
+        const lines = await connectNativePackage("com.good", {
+            adbAvailable: async () => true,
+            serials: async () => ["emulator-5554"],
+            connect: async () => ({ deviceInfo: { deviceName: "Good" } })
+        });
+        expect(lines).toEqual(["Android native (emulator-5554): connected to Good (com.good) via execbro-sdk-android"]);
+    });
+});
+//# sourceMappingURL=nativeDiscovery.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nativeDiscovery.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/nativeDiscovery.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAExH,MAAM,aAAa,GAAG;IAClB,yDAAyD;IACzD,qGAAqG;IACrG,qGAAqG;IACrG,oFAAoF;IACpF,qFAAqF;IACrF,+EAA+E;CAClF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,iCAAiC,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC/G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,mBAAmB,CAAC,wCAAwC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QACxE,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,4BAA4B,CAAC;YAC7C,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK;YAC/B,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;SAC1D,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1B,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,KAAK,GAAG,MAAM,4BAA4B,CAAC;YAC7C,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;YAC9B,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC;gBAClB,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,UAAU,EAAE;gBAC5C,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,SAAS,EAAE;aAC9C;YACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE;gBAC5B,IAAI,GAAG,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;gBACrD,OAAO,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,EAAkB,CAAC;YAClE,CAAC;SACJ,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;YAClB,sFAAsF;YACtF,iFAAiF;SACpF,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,+FAA+F,EAAE,KAAK,IAAI,EAAE;QAE3G,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,YAAY,EAAE;YACnD,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;YAC9B,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,eAAe,CAAC;YACtC,OAAO,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;SAC9D,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE;YACjD,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;YAC9B,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,eAAe,CAAC;YACtC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,CAAiB;SAChF,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,sFAAsF,CAAC,CAAC,CAAC;IACpH,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,27 @@
+import { describe, it, expect, afterEach } from "@jest/globals";
+import WebSocket from "ws";
+import { connectedApps } from "../../core/state.js";
+import { ensureConnection } from "../../core/connection.js";
+import { openNativeSocket } from "../../core/nativeConnection.js";
+import { startFakeSdk, rpcError, HELLO } from "../helpers/fakeNativeSdk.js";
+let fake;
+afterEach(async () => {
+    for (const a of connectedApps.values())
+        a.ws.terminate();
+    connectedApps.clear();
+    await fake.close();
+});
+describe("ensureConnection with a native app connected", () => {
+    it("leaves the native app alone instead of health-checking it over CDP", async () => {
+        fake = await startFakeSdk((method) => {
+            if (method === "execbro.hello")
+                return HELLO;
+            throw rpcError("METHOD_NOT_FOUND", method);
+        });
+        const app = await openNativeSocket(fake.url, { serial: "emulator-5554", pkg: "com.example.app", port: fake.port });
+        await ensureConnection({ port: 1, healthCheck: true });
+        expect(connectedApps.get("native:emulator-5554:com.example.app")).toBe(app);
+        expect(app.ws.readyState).toBe(WebSocket.OPEN);
+    }, 20000);
+});
+//# sourceMappingURL=nativeEnsureConnection.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nativeEnsureConnection.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/nativeEnsureConnection.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAE5E,IAAI,IAA8C,CAAC;AAEnD,SAAS,CAAC,KAAK,IAAI,EAAE;IACjB,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC;IACzD,aAAa,CAAC,KAAK,EAAE,CAAC;IACtB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8CAA8C,EAAE,GAAG,EAAE;IAC1D,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAGhF,IAAI,GAAG,MAAM,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;YACjC,IAAI,MAAM,KAAK,eAAe;gBAAE,OAAO,KAAK,CAAC;YAC7C,MAAM,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAGnH,MAAM,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvD,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5E,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC,EAAE,KAAK,CAAC,CAAC;AACd,CAAC,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,76 @@
+process.env.RN_AI_DEVTOOLS_TEST_MODE = "1";
+import { describe, it, expect, beforeEach, afterEach } from "@jest/globals";
+import WebSocket from "ws";
+const { connectedApps } = await import("../../core/state.js");
+const { peekTargetApp, nativeAppFor, getFirstConnectedApp } = await import("../../core/connection.js");
+const { NATIVE_TOOLS, nativeGate } = await import("../../core/nativeCapabilities.js");
+const { toolRegistry } = await import("../../index.js");
+function rnApp(id, deviceName) {
+    return {
+        ws: { readyState: WebSocket.OPEN },
+        deviceInfo: { id, title: deviceName, description: "", appId: "", type: "node", webSocketDebuggerUrl: `ws://x/${id}`, deviceName },
+        port: 8081,
+        platform: "android"
+    };
+}
+function nativeApp(serial, pkg, label) {
+    return {
+        ...rnApp(`native:${serial}:${pkg}`, label),
+        adbSerial: serial,
+        runtime: "native",
+        nativePackage: pkg
+    };
+}
+describe("nativeGate", () => {
+    it("lets allowlisted tools through on native", () => {
+        for (const t of ["navigate", "list_debug_globals", "inspect_global", "run_app_command", "android_screenshot", "scan_metro"]) {
+            expect(nativeGate(t, "native")).toBeNull();
+        }
+    });
+    it("refuses other tools on native, naming the tool and pointing at what works", () => {
+        const r = nativeGate("tap", "native");
+        expect(r?.isError).toBe(true);
+        expect(r?.content[0].text).toContain("tap");
+        expect(r?.content[0].text).toContain("android_screenshot");
+        expect(r?._failureKind).toBe("platform_mismatch");
+    });
+    it("never touches non-native targets", () => {
+        expect(nativeGate("tap", undefined)).toBeNull();
+    });
+    it("allowlists only tools that actually exist", () => {
+        const devOnly = new Set(["reset_telemetry"]);
+        for (const name of NATIVE_TOOLS)
+            if (!devOnly.has(name))
+                expect(toolRegistry.has(name)).toBe(true);
+    });
+});
+describe("native target resolution", () => {
+    beforeEach(() => connectedApps.clear());
+    afterEach(() => connectedApps.clear());
+    it("matches a native app by package, label or serial", () => {
+        connectedApps.set("rn", rnApp("rn", "Pixel 9"));
+        connectedApps.set("n", nativeApp("emulator-5554", "com.ihorzheludkov.touchdisabler", "TouchDisabler"));
+        expect(nativeAppFor("navigate", "com.ihorzheludkov.touchdisabler")?.nativePackage).toBe("com.ihorzheludkov.touchdisabler");
+        expect(nativeAppFor("navigate", "TouchDisabler")?.runtime).toBe("native");
+        expect(nativeAppFor("navigate", "Pixel 9")).toBeNull();
+    });
+    it("keeps the same package on two devices apart and fails open when ambiguous", () => {
+        connectedApps.set("a", nativeApp("emulator-5554", "com.example.app", "Example"));
+        connectedApps.set("b", nativeApp("emulator-5556", "com.example.app", "Example"));
+        expect(peekTargetApp("navigate", "emulator-5556")?.adbSerial).toBe("emulator-5556");
+        expect(peekTargetApp("navigate", "com.example.app")).toBeUndefined();
+    });
+    it("prefers a React Native app for a bare call, then a native one when nothing else is open", () => {
+        connectedApps.set("n", nativeApp("emulator-5554", "com.example.app", "Example"));
+        connectedApps.set("rn", rnApp("rn", "Pixel 9"));
+        expect(getFirstConnectedApp()?.runtime).toBeUndefined();
+        connectedApps.delete("rn");
+        expect(getFirstConnectedApp()?.runtime).toBe("native");
+    });
+    it("keeps a chromium app ahead of a native one for a bare call, as before native support", () => {
+        connectedApps.set("n", nativeApp("emulator-5554", "com.example.app", "Example"));
+        connectedApps.set("c", { ...rnApp("c", "FluentTalk"), platform: "chromium", port: 9222 });
+        expect(getFirstConnectedApp()?.platform).toBe("chromium");
+    });
+});
+//# sourceMappingURL=nativeGate.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,16 @@
+import { describe, it, expect } from "@jest/globals";
+import { getGuideByTopic, getAvailableTopics, DECISION_TREE } from "../../core/guides.js";
+describe("native guide", () => {
+    it("is a listed topic covering setup and the four tools", () => {
+        expect(getAvailableTopics()).toContain("native");
+        const guide = getGuideByTopic("native");
+        for (const s of ["execbro-sdk-android", "ExecBro.init", "run_app_command", "inspect_global", "navigate", "list_debug_globals"]) {
+            expect(guide).toContain(s);
+        }
+    });
+    it("is announced in the decision tree", () => {
+        expect(DECISION_TREE).toContain("native");
+        expect(DECISION_TREE).toContain("run_app_command");
+    });
+});
+//# sourceMappingURL=nativeGuide.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nativeGuide.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/nativeGuide.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1F,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAE,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,oBAAoB,CAAC,EAAE,CAAC;YAC7H,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}