execbro 2.9.3 → 2.9.4

package/README.md

@@ -17,7 +17,7 @@ ExecBro is the runtime bridge between your AI coding assistant and your running
 1. [Setup ExecBro as an MCP server for your agent of choice](#setup)
 2. [Setup UI automation helpers](docs/setup.md#ios-simulator--ui-automation-setup)
 3. [Install the SDK in your React Native app](#install-the-sdk-recommended) — optional, but recommended for the most robust log, network, and state experience
-4. [Authorize and link to the web dashboard](#see-your-usage--execbrocom) — optional for usage stats and session history, **required to unlock unlimited usage via ExecBro Pro**
+4. [Authorize and link to the web dashboard](#see-your-usage--execbrocom) — optional, for usage stats and session history
 5. Start your React Native app (`npm start` / `expo start`)
 6. [Ask your AI assistant](#usage) in plain language — e.g. "Connect to the simulator and investigate what caused the error on the screen"
 
@@ -25,7 +25,7 @@ ExecBro is the runtime bridge between your AI coding assistant and your running
 
 Log in at **[execbro.com](https://execbro.com)** to see your ExecBro activity rendered back to you: which tools you use most, tool **error rates**, and your **session history** — so you can spot flaky tools, track usage over time, and understand how your agent drives the app across sessions. It's built from the same anonymous telemetry described in [Telemetry & Privacy](#telemetry--privacy), tied to your installation ID.
 
-Linking your installation here is also **required to unlock [ExecBro Pro](#pricing)** — signing in and authorizing your installation is what lets the unlimited-usage plan take effect; without it, the free tier's monthly cap applies even after subscribing.
+Linking is also how [ExecBro Pro](#pricing) attaches to your installation, if you ever subscribe.
 
 ## Features
 
@@ -70,11 +70,13 @@ Linking your installation here is also **required to unlock [ExecBro Pro](#prici
 Add ExecBro to Claude Code in one command — no installation, `npx` fetches the latest version on demand:
 
 ```bash
-claude mcp add execbro --scope user -- npx -y execbro@latest
+claude mcp add execbro --scope project -- npx -y execbro@latest
 ```
 
 Then fully restart the client (quit and relaunch) so it picks up the new server.
 
+Project scope writes a `.mcp.json` you can commit, so the whole team picks ExecBro up in this repo and nowhere else. Swap `project` for `user` to register it globally instead — convenient if you work in React Native all day, but it starts ExecBro in every session you open, including repos with no Metro server to connect to.
+
 **Using a different client or need platform setup?** The [full setup guide](docs/setup.md) covers Claude Desktop, Codex CLI, Cursor, VS Code Copilot, Windsurf, Zed, and Gemini CLI, plus [Android](docs/setup.md#android) and [iOS simulator UI automation](docs/setup.md#ios-simulator--ui-automation-setup) requirements.
 
 ## Install the SDK (recommended)
@@ -204,12 +206,14 @@ See the [full tool reference](docs/tools.md) for all tools with descriptions. Ke
 
 ## Telemetry & Privacy
 
-ExecBro sends two separate signals, not one:
+**No source code, file paths, or app content is ever sent.** Your app and your repo stay on your machine.
+
+ExecBro sends two small signals:
 
-- **Usage metering** (required, always on) — a counted tool-call signal that powers the free tier and enforces its monthly cap. This stays on whenever you're using the free tier; it cannot be disabled and still use ExecBro's free tools.
-- **Product analytics** (optional) — tool names, success/failure, and durations, used to improve the product. **No source code, file paths, or app content is ever sent.** This is what powers your [usage dashboard](#see-your-usage--execbrocom). Disable it with `EXECBRO_TELEMETRY=false` in your MCP server config. Doing so turns off analytics only — it does **not** disable usage metering, which keeps counting tool calls against the free-tier cap regardless.
+- **Product analytics** (optional) — tool names, success/failure, and durations. This is what powers your [usage dashboard](#see-your-usage--execbrocom) and tells me which tools are flaky and worth fixing. Turn it off any time with `EXECBRO_TELEMETRY=false` in your MCP server config.
+- **Usage count** — a running tally of how many tool calls you've made, so the free tier knows where you stand against its monthly allowance. It's a number, not content, and it's the one signal that keeps running when analytics is off.
 
-See the [Telemetry & Data Collection guide](docs/telemetry.md) for the full breakdown of what's collected, auto-registration, and how to opt out, and [PRIVACY.md](./PRIVACY.md) for the complete privacy policy.
+See the [Telemetry & Data Collection guide](docs/telemetry.md) for the full field-by-field breakdown, and [PRIVACY.md](./PRIVACY.md) for the complete privacy policy.
 
 ## Supported React Native Versions
 
@@ -223,7 +227,7 @@ See the [Telemetry & Data Collection guide](docs/telemetry.md) for the full brea
 
 ## Pricing
 
-ExecBro is **free to use** — every feature, fully intelligent — up to **600 tool calls per month**. That covers evaluation and everyday debugging. Heavy users can remove the cap with **ExecBro Pro** ($8.99/mo) for unlimited calls and every future hosted feature. See [execbro.com/pricing](https://execbro.com/pricing).
+ExecBro is **free** — every tool, full power, no feature gates, no account needed to start. The free tier covers **600 tool calls a month**, which is evaluation plus everyday debugging; most people never reach it. If you drive your agent hard all day, **ExecBro Pro** ($8.99/mo) lifts the cap and includes every hosted feature as it ships. See [execbro.com/pricing](https://execbro.com/pricing).
 
 > [!NOTE]
 > **Grandfather notice:** the 600-call monthly cap starts applying **2026-08-01** for new installs. If you already had ExecBro installed before then, you get a free month on top — your cap doesn't start until **2026-08-31**. You'll also see this as an in-app notice. No action needed unless you want to [link your account and upgrade to Pro](#see-your-usage--execbrocom) ahead of time. Questions? [zigor535@gmail.com](mailto:zigor535@gmail.com).

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

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

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

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

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

@@ -0,0 +1,49 @@
+import { describe, it, expect, beforeEach, afterEach } from "@jest/globals";
+import { connectedApps, clearAllCDPMessageTimes, updateLastCDPMessageTime } from "../../core/state.js";
+import { markContextStale, initContextHealth, clearContextHealth } from "../../core/connectionState.js";
+import { passiveConnectionBanner } from "../../core/connection.js";
+const APP_KEY = "8081-device1";
+function connect() {
+    connectedApps.set(APP_KEY, {
+        ws: { readyState: 1 },
+        port: 8081,
+        platform: "ios",
+        deviceInfo: { id: "device1", title: "iPhone", deviceName: "iPhone" }
+    });
+    initContextHealth(APP_KEY);
+}
+describe("passiveConnectionBanner", () => {
+    beforeEach(() => {
+        connectedApps.clear();
+        clearAllCDPMessageTimes();
+        clearContextHealth(APP_KEY);
+    });
+    afterEach(() => {
+        connectedApps.clear();
+        clearAllCDPMessageTimes();
+    });
+    it("says nothing while the connection is healthy", () => {
+        connect();
+        updateLastCDPMessageTime(APP_KEY, new Date());
+        expect(passiveConnectionBanner()).toBe("");
+    });
+    it("reports a genuinely absent socket as disconnected", () => {
+        expect(passiveConnectionBanner()).toContain("Disconnected");
+    });
+    it("does not claim disconnection from an inferred stale context", () => {
+        connect();
+        updateLastCDPMessageTime(APP_KEY, new Date());
+        markContextStale(APP_KEY);
+        const banner = passiveConnectionBanner();
+        expect(banner).not.toContain("Disconnected");
+        expect(banner).toContain("Status unknown");
+        expect(banner).toContain("ensure_connection");
+    });
+    it("does not claim disconnection merely because no CDP traffic was recorded", () => {
+        connect();
+        const banner = passiveConnectionBanner();
+        expect(banner).not.toContain("Disconnected");
+        expect(banner).toContain("no_activity");
+    });
+});
+//# sourceMappingURL=passiveConnectionBanner.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"passiveConnectionBanner.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/passiveConnectionBanner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACvG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxG,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAWnE,MAAM,OAAO,GAAG,cAAc,CAAC;AAE/B,SAAS,OAAO;IACZ,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE;QACvB,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE;QACrB,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE;KAC5C,CAAC,CAAC;IAC9B,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACrC,UAAU,CAAC,GAAG,EAAE;QACZ,aAAa,CAAC,KAAK,EAAE,CAAC;QACtB,uBAAuB,EAAE,CAAC;QAC1B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE;QACX,aAAa,CAAC,KAAK,EAAE,CAAC;QACtB,uBAAuB,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,OAAO,EAAE,CAAC;QACV,wBAAwB,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,uBAAuB,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,uBAAuB,EAAE,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACnE,OAAO,EAAE,CAAC;QACV,wBAAwB,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC9C,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE1B,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QAC/E,OAAO,EAAE,CAAC;QAEV,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,86 @@
+import { describe, it, expect, jest, beforeEach } from "@jest/globals";
+const evaluated = [];
+let evalResult = null;
+jest.unstable_mockModule("../../core/jsExecute.js", () => ({
+    executeInApp: async (expression) => {
+        evaluated.push(expression);
+        return { success: true, result: JSON.stringify(evalResult) };
+    },
+    delay: async () => { }
+}));
+const { pressElement } = await import("../../core/pressables.js");
+function fiber(props, type = "View", children = []) {
+    const node = {
+        type,
+        memoizedProps: props,
+        stateNode: { measureInWindow: (cb) => cb(10, 20, 100, 50) },
+        child: null,
+        sibling: null,
+        return: null
+    };
+    let prev = null;
+    for (const c of children) {
+        c.return = node;
+        if (prev)
+            prev.sibling = c;
+        else
+            node.child = c;
+        prev = c;
+    }
+    return node;
+}
+async function search(options, root) {
+    evaluated.length = 0;
+    evalResult = { dispatched: 1 };
+    await pressElement(options);
+    const globalThisStub = {
+        __REACT_DEVTOOLS_GLOBAL_HOOK__: {
+            getFiberRoots: () => new Set([{ current: root }]),
+            renderers: new Map()
+        }
+    };
+    let last = null;
+    for (const expression of evaluated) {
+        const fn = new Function("globalThis", `return (${expression.trim()});`);
+        last = fn(globalThisStub);
+    }
+    return typeof last === "string" ? JSON.parse(last) : last;
+}
+describe("fiber search and Switch elements", () => {
+    beforeEach(() => {
+        evaluated.length = 0;
+    });
+    const switchTree = (value) => fiber({}, "View", [
+        fiber({ children: "Push notifications" }, "Text"),
+        fiber({ testID: "settings-push", onValueChange: () => { }, value }, "Switch", [
+            fiber({}, "RCTSwitch")
+        ])
+    ]);
+    it("resolves a switch by testID even though it has no onPress", async () => {
+        const out = await search({ testID: "settings-push" }, switchTree(false));
+        expect(out.needsNativeTap).toBe(true);
+        expect(out.switchValue).toBe(false);
+    });
+    it("reports the value the caller is about to change", async () => {
+        const out = await search({ testID: "settings-push" }, switchTree(true));
+        expect(out.switchValue).toBe(true);
+    });
+    it("resolves a Switch that carries no handler at all", async () => {
+        const root = fiber({}, "View", [
+            fiber({ children: "Sponsor" }, "Text"),
+            fiber({ value: false }, { name: "Switch" }, [fiber({}, "RCTSwitch")])
+        ]);
+        const out = await search({ component: "Switch" }, root);
+        expect(out.needsNativeTap).toBe(true);
+        expect(out.switchValue).toBe(false);
+    });
+    it("leaves switchValue null for an ordinary button", async () => {
+        const root = fiber({}, "View", [
+            fiber({ testID: "save", onPress: () => { } }, "View", [fiber({ children: "Save" }, "Text")])
+        ]);
+        const out = await search({ testID: "save" }, root);
+        expect(out.needsNativeTap).toBe(true);
+        expect(out.switchValue).toBeNull();
+    });
+});
+//# sourceMappingURL=pressablesSwitch.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,51 @@
+import { describe, it, expect, jest } from "@jest/globals";
+const evaluated = [];
+jest.unstable_mockModule("../../core/executor.js", () => ({
+    executeInApp: async (expression) => {
+        evaluated.push(expression);
+        return { success: true, result: run(expression) };
+    }
+}));
+const dispatched = [];
+const store = {
+    dispatch: (a) => dispatched.push(a),
+    getState: () => ({ settings: { a: 1 } }),
+    subscribe: () => { }
+};
+function run(expression) {
+    const globalThisStub = {
+        __REACT_DEVTOOLS_GLOBAL_HOOK__: {
+            renderers: new Map([[1, {}]]),
+            getFiberRoots: () => new Set([{ current: { type: { name: "Provider" }, memoizedProps: { store } } }])
+        }
+    };
+    return new Function("globalThis", `return (${expression.trim()});`)(globalThisStub);
+}
+const { reduxDispatch } = await import("../../core/redux.js");
+describe("redux_dispatch batching", () => {
+    it("dispatches an array in order in a single round trip", async () => {
+        dispatched.length = 0;
+        evaluated.length = 0;
+        const result = await reduxDispatch({
+            action: [
+                { type: "settings/setA", payload: false },
+                { type: "settings/setB", payload: true }
+            ],
+            returnPath: "settings"
+        });
+        expect(evaluated).toHaveLength(1);
+        expect(dispatched).toEqual([
+            { type: "settings/setA", payload: false },
+            { type: "settings/setB", payload: true }
+        ]);
+        expect(result.success).toBe(true);
+        expect(result.state).toEqual({ a: 1 });
+    });
+    it("still accepts a single action object", async () => {
+        dispatched.length = 0;
+        const result = await reduxDispatch({ action: { type: "app/setIsLoading", payload: true } });
+        expect(dispatched).toEqual([{ type: "app/setIsLoading", payload: true }]);
+        expect(result.previousAction).toEqual({ type: "app/setIsLoading", payload: true });
+    });
+});
+//# sourceMappingURL=reduxBatchDispatch.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,46 @@
+import { describe, it, expect } from "@jest/globals";
+import { formatRequestDetails, redactHeaderValue } from "../../core/network.js";
+const JWT = "Bearer " + "e".repeat(1500);
+function request(overrides = {}) {
+    return {
+        requestId: "js-1",
+        url: "https://api.example.com/graphql",
+        method: "POST",
+        headers: { authorization: JWT, accept: "application/json" },
+        postData: JSON.stringify({ query: "query GetThings { things { id } }" }),
+        responseBody: JSON.stringify({ data: { things: [{ id: "t1" }] } }),
+        timestamp: new Date("2026-08-25T10:00:00Z"),
+        epoch: 1,
+        completed: true,
+        status: 200,
+        ...overrides
+    };
+}
+describe("get_request_details request/response split", () => {
+    it("keeps a live token out of the transcript unless verbose asks for it", () => {
+        const out = formatRequestDetails(request(), { include: "request" });
+        expect(out).not.toContain(JWT);
+        expect(out).toContain("Bearer [redacted, 1507 chars");
+        expect(formatRequestDetails(request(), { include: "request", verbose: true })).toContain(JWT);
+        expect(redactHeaderValue("accept", "application/json")).toBe("application/json");
+    });
+    it("renders only the queried side, so narrowing does not re-dump the request", () => {
+        const out = formatRequestDetails(request(), { query: "data.things[0].id" });
+        expect(out).toContain("t1");
+        expect(out).not.toContain("Request Headers");
+        expect(out).not.toContain("Request Body");
+        expect(out).not.toContain("Response Headers");
+        expect(out).toContain('include:"both"');
+    });
+    it("still shows both sides when there is no query", () => {
+        const out = formatRequestDetails(request());
+        expect(out).toContain("Request Headers");
+        expect(out).toContain("Response Body");
+    });
+    it("honours an explicit include over the query default", () => {
+        const out = formatRequestDetails(request(), { query: "data.things[0].id", include: "both" });
+        expect(out).toContain("Request Headers");
+        expect(out).toContain("t1");
+    });
+});
+//# sourceMappingURL=requestDetailsInclude.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,34 @@
+import { describe, expect, it } from "@jest/globals";
+import { formatScreenStateSummary } from "../../core/screenState.js";
+function toggle(over = {}) {
+    return {
+        label: "Push notifications",
+        component: "Switch",
+        center: { x: 775, y: 320 },
+        bounds: { x: 745, y: 305, width: 60, height: 30 },
+        testID: "settings-push",
+        ...over
+    };
+}
+const screen = (pressables) => ({ route: null, overlays: [], pressables, texts: [], images: [] });
+describe("get_screen_state switch reporting", () => {
+    it("lists a switch with its current value and a tappable testID", () => {
+        const out = formatScreenStateSummary(screen([toggle({ switchValue: true })]), undefined, {
+            pressablesOnly: true
+        });
+        expect(out).toContain("[switch:ON]");
+        expect(out).toContain('testID="settings-push"');
+        expect(out).toContain("(775, 320)");
+    });
+    it("distinguishes off from on", () => {
+        const out = formatScreenStateSummary(screen([toggle({ switchValue: false })]), undefined, {
+            pressablesOnly: true
+        });
+        expect(out).toContain("[switch:OFF]");
+    });
+    it("says nothing about elements that are not switches", () => {
+        const out = formatScreenStateSummary(screen([toggle({ component: "Button", switchValue: undefined })]), undefined, { pressablesOnly: true });
+        expect(out).not.toContain("[switch:");
+    });
+});
+//# sourceMappingURL=screenStateSwitch.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screenStateSwitch.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/screenStateSwitch.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAA+C,MAAM,2BAA2B,CAAC;AAQlH,SAAS,MAAM,CAAC,OAAsC,EAAE;IACpD,OAAO;QACH,KAAK,EAAE,oBAAoB;QAC3B,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;QAC1B,MAAM,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACjD,MAAM,EAAE,eAAe;QACvB,GAAG,IAAI;KACV,CAAC;AACN,CAAC;AAED,MAAM,MAAM,GAAG,CAAC,UAAkC,EAAe,EAAE,CAC/D,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;AAEvE,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACnE,MAAM,GAAG,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE;YACrF,cAAc,EAAE,IAAI;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,GAAG,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE;YACtF,cAAc,EAAE,IAAI;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QACzD,MAAM,GAAG,GAAG,wBAAwB,CAChC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EACjE,SAAS,EACT,EAAE,cAAc,EAAE,IAAI,EAAE,CAC3B,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,47 @@
+import { describe, it, expect } from "@jest/globals";
+import { sheetShiftY, SHEET_HELPERS_JS } from "../../core/injected/sheetOffset.js";
+const WINDOW = { width: 420, height: 912 };
+describe("sheetShiftY", () => {
+    it("derives the measured inset from the sheet's own height", () => {
+        expect(sheetShiftY({ x: 0, y: 0, width: 420, height: 844 }, WINDOW)).toBe(68);
+    });
+    it("is zero for a full-screen presentation", () => {
+        expect(sheetShiftY({ x: 0, y: 0, width: 420, height: 912 }, WINDOW)).toBe(0);
+    });
+    it("is zero when the platform already reports absolute coordinates", () => {
+        expect(sheetShiftY({ x: 0, y: 68, width: 420, height: 844 }, WINDOW)).toBe(0);
+    });
+    it("scales with a detented half sheet, which is still bottom-anchored", () => {
+        expect(sheetShiftY({ x: 0, y: 0, width: 420, height: 456 }, WINDOW)).toBe(456);
+    });
+    it("refuses to guess when the sheet is not full-width", () => {
+        expect(sheetShiftY({ x: 60, y: 0, width: 300, height: 700 }, WINDOW)).toBe(0);
+    });
+    it("returns 0 rather than throwing on missing or degenerate input", () => {
+        expect(sheetShiftY(null, WINDOW)).toBe(0);
+        expect(sheetShiftY(undefined, WINDOW)).toBe(0);
+        expect(sheetShiftY({ x: 0, y: 0, width: 0, height: 0 }, WINDOW)).toBe(0);
+        expect(sheetShiftY({ x: 0, y: 0, width: 420, height: 844 }, null)).toBe(0);
+        expect(sheetShiftY({ x: 0, y: 0, width: 420, height: 1000 }, WINDOW)).toBe(0);
+    });
+});
+describe("SHEET_HELPERS_JS", () => {
+    it("evaluates to the same function the Node side uses", () => {
+        const fn = new Function(`${SHEET_HELPERS_JS} return sheetShiftY;`)();
+        expect(fn({ x: 0, y: 0, width: 420, height: 844 }, WINDOW)).toBe(68);
+        expect(fn({ x: 0, y: 0, width: 420, height: 912 }, WINDOW)).toBe(0);
+    });
+    it("walks up to the modal boundary and stops at ordinary hosts", () => {
+        const ctx = new Function(`${SHEET_HELPERS_JS} return { modalBoundaryOf: modalBoundaryOf, shiftRect: shiftRect };`)();
+        const sheet = { type: "RNSModalScreen", memoizedProps: {}, return: null };
+        const view = { type: "RCTView", memoizedProps: {}, return: sheet };
+        const leaf = { type: "RCTSwitch", memoizedProps: {}, return: view };
+        expect(ctx.modalBoundaryOf(leaf)).toBe(sheet);
+        const pushed = { type: "RNSScreen", memoizedProps: { stackPresentation: "push" }, return: null };
+        expect(ctx.modalBoundaryOf({ type: "RCTView", memoizedProps: {}, return: pushed })).toBeNull();
+        const legacy = { type: "RNSScreen", memoizedProps: { stackPresentation: "formSheet" }, return: null };
+        expect(ctx.modalBoundaryOf({ type: "RCTView", memoizedProps: {}, return: legacy })).toBe(legacy);
+        expect(ctx.shiftRect({ x: 1, y: 10, width: 2, height: 3 }, 68).y).toBe(78);
+    });
+});
+//# sourceMappingURL=sheetOffset.test.js.map

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

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

package/build/core/connection.d.ts

@@ -59,5 +59,6 @@ export interface PassiveConnectionStatus {
     reason: "ok" | "no_connection" | "context_stale" | "no_activity" | "activity_stale";
 }
 export declare function getPassiveConnectionStatus(targetAppKey?: string): PassiveConnectionStatus;
+export declare function passiveConnectionBanner(targetAppKey?: string): string;
 export declare function checkAndEnsureConnection(device?: string): Promise<ConnectionCheckResult>;
 //# sourceMappingURL=connection.d.ts.map

package/build/core/connection.d.ts.map

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

package/build/core/connection.js

@@ -1502,6 +1502,15 @@ export function getPassiveConnectionStatus(targetAppKey) {
     }
     return { connected: true, needsPing: false, reason: "ok" };
 }
+export function passiveConnectionBanner(targetAppKey) {
+    const passive = getPassiveConnectionStatus(targetAppKey);
+    if (passive.connected)
+        return "";
+    if (passive.reason === "no_connection") {
+        return "\n\n[CONNECTION] Disconnected. Showing cached data. New data is not being captured.";
+    }
+    return `\n\n[CONNECTION] Status unknown for this read (${passive.reason}) — inferred, not measured. The data above is real; if you suspect capture stopped, call ensure_connection({healthCheck:true}) rather than scan_metro.`;
+}
 export async function checkAndEnsureConnection(device) {
     let targetAppKey;
     let targetApp = null;