react-native-mcp-kit 4.2.1 → 4.3.0

package/dist/server/helpers.d.ts

@@ -52,6 +52,38 @@ export interface ServerContext {
 export declare const jsonError: (msg: string) => {
     content: TextContent[];
 };
+export type ClientIdsParse = {
+    ids: string[];
+    mode: 'broadcast';
+    ok: true;
+} | {
+    clientId: string | undefined;
+    mode: 'single';
+    ok: true;
+} | {
+    error: string;
+    ok: false;
+};
+/**
+ * Normalises the `clientId` arg accepted by every public tool. A bare string
+ * keeps the single-client shape (image content passes through; auto-resolution
+ * still applies when undefined). An array — even with one entry — switches the
+ * caller into broadcast mode, where each client is dispatched in parallel and
+ * results are aggregated.
+ */
+export declare const parseClientIds: (raw: unknown) => ClientIdsParse;
+export interface BroadcastDispatch {
+    clientId: string;
+    result: DispatchResult;
+}
+/**
+ * Build MCP content blocks from per-client dispatch results. When every result
+ * is text-only, the function returns a single JSON envelope so the agent can
+ * parse one blob; when any result carries image content (e.g. screenshots),
+ * results are emitted as per-client blocks prefixed with `## <clientId>`
+ * headers so each image stays paired with its source.
+ */
+export declare const buildBroadcastContent: (results: BroadcastDispatch[], formatResult: (result: unknown) => Array<TextContent | ImageContent>) => Array<TextContent | ImageContent>;
 /**
  * Parse a `call`-style args argument that may arrive as a JSON string (older
  * clients) or a plain object (new form). Returns { ok, args } or { ok: false,

package/dist/server/helpers.d.ts.map

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

package/dist/server/helpers.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatResult = exports.buildToolGroups = exports.findToolInClient = exports.canonicalizeGroup = exports.canonicalize = exports.parseCallArgs = exports.jsonError = void 0;
+exports.formatResult = exports.buildToolGroups = exports.findToolInClient = exports.canonicalizeGroup = exports.canonicalize = exports.parseCallArgs = exports.buildBroadcastContent = exports.parseClientIds = exports.jsonError = void 0;
 const protocol_1 = require("../shared/protocol");
 const jsonError = (msg) => {
     return {
@@ -8,6 +8,94 @@ const jsonError = (msg) => {
     };
 };
 exports.jsonError = jsonError;
+/**
+ * Normalises the `clientId` arg accepted by every public tool. A bare string
+ * keeps the single-client shape (image content passes through; auto-resolution
+ * still applies when undefined). An array — even with one entry — switches the
+ * caller into broadcast mode, where each client is dispatched in parallel and
+ * results are aggregated.
+ */
+const parseClientIds = (raw) => {
+    if (raw === undefined || raw === null)
+        return { clientId: undefined, mode: 'single', ok: true };
+    if (typeof raw === 'string')
+        return { clientId: raw, mode: 'single', ok: true };
+    if (Array.isArray(raw)) {
+        if (raw.length === 0) {
+            return { error: 'clientId array must contain at least one entry.', ok: false };
+        }
+        const seen = new Set();
+        const ids = [];
+        for (const id of raw) {
+            if (typeof id !== 'string') {
+                return { error: 'clientId array must contain strings only.', ok: false };
+            }
+            if (!seen.has(id)) {
+                seen.add(id);
+                ids.push(id);
+            }
+        }
+        return { ids, mode: 'broadcast', ok: true };
+    }
+    return { error: 'clientId must be a string or an array of strings.', ok: false };
+};
+exports.parseClientIds = parseClientIds;
+/**
+ * Detects an MCP image-content payload (the shape host__screenshot returns)
+ * without re-running formatResult. Used to pick the broadcast aggregation
+ * strategy — text-only results collapse into a single JSON envelope, image
+ * results keep per-client blocks so each image is anchored to its source.
+ */
+const isImageResult = (result) => {
+    if (!Array.isArray(result) || result.length === 0)
+        return false;
+    const first = result[0];
+    return (typeof first === 'object' &&
+        first !== null &&
+        'type' in first &&
+        first.type === 'image');
+};
+/**
+ * Build MCP content blocks from per-client dispatch results. When every result
+ * is text-only, the function returns a single JSON envelope so the agent can
+ * parse one blob; when any result carries image content (e.g. screenshots),
+ * results are emitted as per-client blocks prefixed with `## <clientId>`
+ * headers so each image stays paired with its source.
+ */
+const buildBroadcastContent = (results, formatResult) => {
+    const hasImage = results.some(({ result }) => {
+        return result.ok && isImageResult(result.result);
+    });
+    if (!hasImage) {
+        return [
+            {
+                text: JSON.stringify({
+                    results: results.map(({ clientId, result }) => {
+                        if (result.ok)
+                            return { clientId, ok: true, result: result.result };
+                        return { clientId, error: result.error, ok: false };
+                    }),
+                }, null, 2),
+                type: 'text',
+            },
+        ];
+    }
+    const blocks = [];
+    for (const { clientId, result } of results) {
+        blocks.push({ text: `## ${clientId}`, type: 'text' });
+        if (result.ok) {
+            blocks.push(...formatResult(result.result));
+        }
+        else {
+            blocks.push({
+                text: JSON.stringify({ error: result.error }, null, 2),
+                type: 'text',
+            });
+        }
+    }
+    return blocks;
+};
+exports.buildBroadcastContent = buildBroadcastContent;
 /**
  * Parse a `call`-style args argument that may arrive as a JSON string (older
  * clients) or a plain object (new form). Returns { ok, args } or { ok: false,

package/dist/server/helpers.js.map

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

package/dist/server/instructions.d.ts

@@ -1,2 +1,2 @@
-export declare const BASE_INSTRUCTIONS = "You are connected to a running React Native app via the react-native-mcp-kit bridge.\n\nMultiple React Native apps can connect simultaneously \u2014 each is identified by a short ID like \"ios-1\", \"android-1\", or \"client-1\". Use `connection_status` or `list_tools` to see which clients are connected and their IDs, platforms, and labels.\n\n## How to interact\n\n1. Use `connection_status` to check which clients are connected.\n2. Use `list_tools` to browse all available tool names and short descriptions. The response is compact \u2014 modules that are structurally identical across multiple clients are deduplicated into a single entry with a `clientIds` array, and input schemas are omitted. Narrow the listing with `{ module }` or `{ clientId }`, or pass `{ compact: true }` to drop module-level descriptions.\n3. Use `describe_tool` with `{ tool, clientId? }` to fetch the full input schema of a specific tool before calling it. Required when you need to know the argument shape. Host tools are resolved directly (no clientId needed). For in-app tools, omit `clientId` to auto-pick; specify it only when multiple clients have the same tool with different schemas.\n4. Use `call` to invoke any tool with format: module__method (e.g. navigation__navigate). When more than one client is connected, specify `clientId`. When exactly one client is connected, `clientId` is optional \u2014 it's auto-picked. `args` accepts either a plain object or a JSON string \u2014 prefer objects to avoid quote escaping.\n5. Use `wait_until` to poll any tool until a predicate over its result holds (or timeout). Replaces \"screenshot in a loop + sleep\" for state-level waits (\"wait for network to idle\", \"wait for state key X to become Y\"). Predicate supports compound forms: { all: [...] } (AND), { any: [...] } (OR), { not: predicate }.\n6. For UI-level waits (\"wait for a screen to appear\", \"wait for a spinner to disappear\") use `fiber_tree__query` with `waitFor: { until: \"appear\" | \"disappear\", timeout?, interval?, stable? }` \u2014 it polls the same query with cache bypassed until the target state holds. `stable: <ms>` requires continuous presence/absence for that many ms to ignore transient matches during screen transitions.\n7. Use `assert` for a single-shot checkpoint after actions \u2014 same predicate vocabulary as wait_until, returns { pass, actual, expected?, result? }. Natural pair: do action \u2192 wait_until / fiber_tree waitFor \u2192 assert.\n8. Use `host__tap_fiber` to collapse \"fiber_tree__query \u2192 host__tap at bounds\" into one call. Pass fiber_tree steps; if exactly one fiber matches, its center is tapped. Ambiguous match returns the candidate list so you can add `index` or narrow the chain.\n\nSome tools run inline on the MCP server host (e.g. `host__screenshot`, `host__list_devices`, `host__launch_app`, `host__terminate_app`, `host__restart_app`, `metro__reload`, `metro__symbolicate`) and work even when no React Native client is connected. They use xcrun simctl / adb on the dev machine. When `clientId` is provided, host tools use that client's platform/label/deviceId as hints to resolve the target device; otherwise they prefer the device of the single connected client, falling back to the single booted sim / online device. `launch_app`, `terminate_app`, and `restart_app` accept an `appId` arg (iOS bundle ID / Android package name); omit it to reuse the target client's registered `bundleId` from its connection metadata.\n\n## Driving the UI \u2014 pick the right tool\n1. **`host__tap_fiber` with `steps: [...]`** \u2014 the canonical way to simulate a user tap. One call locates the fiber via fiber_tree__query and taps its center through the real OS gesture pipeline, so Pressable feedback, gesture responders, and hit-test logic all run. Ambiguous matches return a candidate list so you can add `index` or narrow `steps`. This is what you want whenever the user asks to simulate a tap / press / button click.\n2. **`fiber_tree__query` with `select: [\"mcpId\",\"name\",\"bounds\"]` + `host__tap`** when you want to inspect a match set before committing \u2014 e.g. verify bounds, or skim candidates before picking one. `props` is opt-in on `select` to keep responses small.\n3. **`fiber_tree__call`** for non-gesture callbacks or imperative ref methods. Pass `prop` to call a callback prop (`{ prop: 'onPress' }`) or `method` to call a native-ref method (`{ method: 'focus' }`). Good when the component is off-screen / virtualised, when a scroll-handler parent swallows taps, or when you're driving focus / blur / measure / scrollTo via the native ref. For simulating a user tap, prefer tap_fiber (above).\n4. **`host__screenshot` + manual coordinate estimation + `host__tap`** ONLY for non-React surfaces: system permission dialogs, native alerts, the on-screen keyboard, WebView content, native splash. These have no fiber and no bounds. Pair with `region: { x, y, width, height }` to screenshot just the area you're inspecting \u2014 vision-token cheap.\n\nGesture tools: `host__tap` / `host__long_press` / `host__swipe` / `host__drag` / `host__type_text` / `host__type_text_batch` / `host__press_key` work on both platforms with no external daemons: Android via `adb shell input`, iOS via a bundled `ios-hid` binary that injects HID events directly into iOS Simulator through SimulatorKit.\n\nStack traces: `errors__get_errors` and `log_box__get_logs` return parsed `stackFrames` you can pass straight into `metro__symbolicate` to resolve bundled frames back to source paths via Metro.\n\n## Consolidated tools \u2014 verb + arg, not verb-per-action\n\nEvery module exposes one verb per concept rather than one tool per variant. Reach for the listing tool with a filter arg, not a tool named after the filter:\n\n- **console** \u2014 `get_logs({ level? })` for all levels (no per-level shortcuts).\n- **errors** \u2014 `get_errors({ fatal? })` covers fatal-only too.\n- **network** \u2014 `get_requests({ status?, method?, url? })` covers errors / pending / URL filter.\n- **log_box** \u2014 `clear({ level? })` (warn / error / syntax / all); `set_installed({ enabled })` toggles install/uninstall.\n- **navigation** \u2014 `navigate({ mode: 'reuse' | 'push' | 'replace' })` covers navigate/push/replace; `pop({ to: <number> | <screenName> | 'top' })` covers pop / pop_to / pop_to_top; `get_current_route({ withState? })` covers the route-state read too.\n- **query** (reactQuery) \u2014 `mutate({ action: 'invalidate' | 'refetch' | 'remove' | 'reset', key? })` covers all four cache mutations.\n- **device** \u2014 `info({ select?: [...] })` aggregates platform / dimensions / pixelRatio / appearance / appState / accessibility / keyboard / initialUrl / dev / identity / app / battery / memoryStorage. `open_url({ dryRun? })` covers the canOpenURL check too.\n- **fiber_tree** \u2014 `query` (all inspection: mcpId / name / testID / props / hooks / bounds / refMethods / children) and `call({ prop? | method? })` (callback prop OR native-ref method) \u2014 two tools cover everything fibers offer.\n\n## Path-based drill into heavy responses\n\nAll listing tools that return heavy JSON (console / network / errors / storage / reactQuery / log_box / navigation / metro events / fiber_tree) accept the standard `path` / `depth` / `maxBytes` projection args. Heavy nested values collapse to compact `${...}`-keyed markers; primitives stay raw. Drill into a specific subtree via the same tool with `path` \u2014 no separate by-id fetcher.\n\n  `network__get_requests({ path: '[-1:][0].response.body' })`         \u2014 last request's body\n  `network__get_requests({ path: '[-1:][0].response.body', depth: 8 })` \u2014 fully expanded\n  `console__get_logs({ path: '[-3:][0].args[1]' })`                    \u2014 second arg of the third-from-last log\n  `storage__get_item({ key: 'session', path: 'value.user.email' })`    \u2014 drill into a stored value\n  `query__get_data({ key: '[\"users\"]', path: 'data.email' })`         \u2014 drill into cached data\n\nPath syntax (JS-style):\n  `.key` or `[\"key.with.dots\"]` \u2014 object key access\n  `[N]` \u2014 index (numeric for arrays, Nth char for strings, Nth key in insertion order for objects)\n  `[start:end]` / `[start:]` / `[:end]` \u2014 slice (Python/jq-style; negative indices count from end). Works on arrays, strings, and objects (key slice). After array slice, chained `.key` maps over each element; `[N]` picks one.\n\nPath drilling to a string scalar applies `previewCap` as usual \u2014 long leaves still wrap in a `${str}` marker. To get a raw substring, end the path with a slice: `stack[0:500]` returns the first 500 chars verbatim (slice = explicit truncation request, previewCap bypassed). Default `previewCap` is 250; override per call via `previewCap: <N>`.\n\n`depth` (default per tool, max 8) controls how many container levels are walked before collapsing to a marker. Bump `depth` for an exploratory survey, use `path` for a targeted drill. `maxBytes` (default 50KB) caps the total response size \u2014 overflow is replaced with a single `${str}` marker carrying the original byte count + a preview.\n\nFor `fiber_tree__query`, heavy fields (`props`, `hooks`) take projection knobs per-field via `select` so the rest of the response stays raw:\n  `select: [{ props: { path: \"style\", depth: 2 } }]`   \u2014 drill into props.style 2 levels deep\n  `select: [{ props: { path: \"data[0:5]\" } }]`         \u2014 slice path: take first 5 items of props.data\n  `select: [{ hooks: { kinds: [\"State\"], names: [\"isLoading\"], withValues: true, depth: 2 } }]` \u2014 filter + project hook values\n  `select: [{ children: 5 }]`                          \u2014 light-only recursive tree walker (5 levels deep); use `scope: \"root\"` as the first step to dump the whole tree. props/hooks not supported inside; sub-children past treeDepth surface as `${arr}: N`.\n\nHook filters: `kinds` (State/Effect/Memo/Ref/Custom/...), `names` (exact or `/regex/flags`), `withValues` (adds resolved values), `expansionDepth` (caps custom-hook recursion), `format: \"tree\"` (nested children vs flat `via` chains). Each hook entry carries `{ kind, name, hook?, via?, expanded? }`. Sensitive names (password, token, jwt, secret, credential, apiKey, authorization, Pin suffix) are auto-redacted; configure via `fiberTreeModule({ redactHookNames, additionalRedactHookNames })`.\n\nMarker format: `{ \"${obj}\": N }` for collapsed objects (N keys), `{ \"${arr}\": N }` for arrays (N items), `{ \"${fun}\": \"name\" }` for functions, `{ \"${str}\": { len, preview } }` for long strings (>`previewCap`, default 250), `{ \"${Date}\": \"iso\" }` for Date, `{ \"${Err}\": { name, msg } }` for Error, `{ \"${RegExp}\": \"/.../i\" }` for RegExp, `{ \"${map}\": N }` / `{ \"${set}\": N }` for Map/Set sizes, `{ \"${cyc}\": true }` for cycles, `{ \"${ref}\": { mcpId, name } }` for fiber/native refs, `{ \"${cls}\": { name, len } }` for class instances, `{ \"${truncated}\": { total, slice } }` first key/item when a container is wider than the cap (30 keys for objects, 50 items for arrays).\n";
+export declare const BASE_INSTRUCTIONS = "You are connected to a running React Native app via the react-native-mcp-kit bridge.\n\nMultiple React Native apps can connect simultaneously \u2014 each is identified by a short ID like \"ios-1\", \"android-1\", or \"client-1\". Use `connection_status` or `list_tools` to see which clients are connected and their IDs, platforms, and labels.\n\n## How to interact\n\n1. Use `connection_status` to check which clients are connected.\n2. Use `list_tools` to browse all available tool names and short descriptions. The response is compact \u2014 modules that are structurally identical across multiple clients are deduplicated into a single entry with a `clientIds` array, and input schemas are omitted. Narrow the listing with `{ module }` or `{ clientId }`, or pass `{ compact: true }` to drop module-level descriptions.\n3. Use `describe_tool` with `{ tool, clientId? }` to fetch the full input schema of a specific tool before calling it. Required when you need to know the argument shape. Host tools are resolved directly (no clientId needed). For in-app tools, omit `clientId` to auto-pick; specify it only when multiple clients have the same tool with different schemas.\n4. Use `call` to invoke any tool with format: module__method (e.g. navigation__navigate). When more than one client is connected, specify `clientId`. When exactly one client is connected, `clientId` is optional \u2014 it's auto-picked. `args` accepts either a plain object or a JSON string \u2014 prefer objects to avoid quote escaping.\n5. Use `wait_until` to poll any tool until a predicate over its result holds (or timeout). Replaces \"screenshot in a loop + sleep\" for state-level waits (\"wait for network to idle\", \"wait for state key X to become Y\"). Predicate supports compound forms: { all: [...] } (AND), { any: [...] } (OR), { not: predicate }.\n6. For UI-level waits (\"wait for a screen to appear\", \"wait for a spinner to disappear\") use `fiber_tree__query` with `waitFor: { until: \"appear\" | \"disappear\", timeout?, interval?, stable? }` \u2014 it polls the same query with cache bypassed until the target state holds. `stable: <ms>` requires continuous presence/absence for that many ms to ignore transient matches during screen transitions.\n7. Use `assert` for a single-shot checkpoint after actions \u2014 same predicate vocabulary as wait_until, returns { pass, actual, expected?, result? }. Natural pair: do action \u2192 wait_until / fiber_tree waitFor \u2192 assert.\n\n### Broadcast \u2014 same call on several clients\n\n`call`, `wait_until` and `assert` accept `clientId` as either a string or an array of strings. A string keeps the single-client shape (image content passes through). An array dispatches the same invocation to every listed client in parallel \u2014 useful for iOS\u2194Android parity, A/B device runs, or asserting a state across all attached apps in one round-trip.\n\n  `call({ clientId: [\"ios-1\", \"android-1\"], tool: \"host__screenshot\" })`          \u2014 two screenshots in one response\n  `wait_until({ clientId: [\"ios-1\", \"android-1\"], tool: \"navigation__get_current_route\", predicate: { op: \"equals\", path: \"name\", value: \"CART\" } })`  \u2014 wait until both clients land on CART\n  `assert({ clientId: [\"ios-1\", \"android-1\"], tool: \"fiber_tree__query\", args: { mcpId: \"checkout:button:submit\" }, predicate: { op: \"exists\" } })`     \u2014 the same fiber exists on both platforms\n\nBroadcast result shapes:\n  `call` \u2014 when every per-client result is text, you get one JSON envelope `{ results: [{ clientId, ok, result | error }, ...] }`. When any result is an image (screenshot), per-client `## <clientId>` text headers are interleaved with each client's blocks so each image stays paired with its source.\n  `wait_until` \u2014 `{ ok, perClient: [{ clientId, ok, attempts, elapsedMs, matched? | lastResult, lastError?, reason? }, ...] }`; overall `ok` is true only if every client matched within the shared timeout.\n  `assert` \u2014 `{ pass, perClient: [{ clientId, pass, actual?, expected?, op?, path?, message?, result?, error? }, ...] }`; overall `pass` is true only when every client passed.\n\n`list_tools` and `describe_tool` also accept an array `clientId` \u2014 there it narrows the considered client set (filter / canonicalisation pool) rather than triggering a broadcast.\n8. Use `host__tap_fiber` to collapse \"fiber_tree__query \u2192 host__tap at bounds\" into one call. Pass fiber_tree steps; if exactly one fiber matches, its center is tapped. Ambiguous match returns the candidate list so you can add `index` or narrow the chain.\n\nSome tools run inline on the MCP server host (e.g. `host__screenshot`, `host__list_devices`, `host__launch_app`, `host__terminate_app`, `host__restart_app`, `metro__reload`, `metro__symbolicate`) and work even when no React Native client is connected. They use xcrun simctl / adb on the dev machine. When `clientId` is provided, host tools use that client's platform/label/deviceId as hints to resolve the target device; otherwise they prefer the device of the single connected client, falling back to the single booted sim / online device. `launch_app`, `terminate_app`, and `restart_app` accept an `appId` arg (iOS bundle ID / Android package name); omit it to reuse the target client's registered `bundleId` from its connection metadata.\n\n## Driving the UI \u2014 pick the right tool\n1. **`host__tap_fiber` with `steps: [...]`** \u2014 the canonical way to simulate a user tap. One call locates the fiber via fiber_tree__query and taps its center through the real OS gesture pipeline, so Pressable feedback, gesture responders, and hit-test logic all run. Ambiguous matches return a candidate list so you can add `index` or narrow `steps`. This is what you want whenever the user asks to simulate a tap / press / button click.\n2. **`fiber_tree__query` with `select: [\"mcpId\",\"name\",\"bounds\"]` + `host__tap`** when you want to inspect a match set before committing \u2014 e.g. verify bounds, or skim candidates before picking one. `props` is opt-in on `select` to keep responses small.\n3. **`fiber_tree__call`** for non-gesture callbacks or imperative ref methods. Pass `prop` to call a callback prop (`{ prop: 'onPress' }`) or `method` to call a native-ref method (`{ method: 'focus' }`). Good when the component is off-screen / virtualised, when a scroll-handler parent swallows taps, or when you're driving focus / blur / measure / scrollTo via the native ref. For simulating a user tap, prefer tap_fiber (above).\n4. **`host__screenshot` + manual coordinate estimation + `host__tap`** ONLY for non-React surfaces: system permission dialogs, native alerts, the on-screen keyboard, WebView content, native splash. These have no fiber and no bounds. Pair with `region: { x, y, width, height }` to screenshot just the area you're inspecting \u2014 vision-token cheap.\n\nGesture tools: `host__tap` / `host__long_press` / `host__swipe` / `host__drag` / `host__type_text` / `host__type_text_batch` / `host__press_key` work on both platforms with no external daemons: Android via `adb shell input`, iOS via a bundled `ios-hid` binary that injects HID events directly into iOS Simulator through SimulatorKit.\n\nStack traces: `errors__get_errors` and `log_box__get_logs` return parsed `stackFrames` you can pass straight into `metro__symbolicate` to resolve bundled frames back to source paths via Metro.\n\n## Consolidated tools \u2014 verb + arg, not verb-per-action\n\nEvery module exposes one verb per concept rather than one tool per variant. Reach for the listing tool with a filter arg, not a tool named after the filter:\n\n- **console** \u2014 `get_logs({ level? })` for all levels (no per-level shortcuts).\n- **errors** \u2014 `get_errors({ fatal? })` covers fatal-only too.\n- **network** \u2014 `get_requests({ status?, method?, url? })` covers errors / pending / URL filter.\n- **log_box** \u2014 `clear({ level? })` (warn / error / syntax / all); `set_installed({ enabled })` toggles install/uninstall.\n- **navigation** \u2014 `navigate({ mode: 'reuse' | 'push' | 'replace' })` covers navigate/push/replace; `pop({ to: <number> | <screenName> | 'top' })` covers pop / pop_to / pop_to_top; `get_current_route({ withState? })` covers the route-state read too.\n- **query** (reactQuery) \u2014 `mutate({ action: 'invalidate' | 'refetch' | 'remove' | 'reset', key? })` covers all four cache mutations.\n- **device** \u2014 `info({ select?: [...] })` aggregates platform / dimensions / pixelRatio / appearance / appState / accessibility / keyboard / initialUrl / dev / identity / app / battery / memoryStorage. `open_url({ dryRun? })` covers the canOpenURL check too.\n- **fiber_tree** \u2014 `query` (all inspection: mcpId / name / testID / props / hooks / bounds / refMethods / children) and `call({ prop? | method? })` (callback prop OR native-ref method) \u2014 two tools cover everything fibers offer.\n\n## Path-based drill into heavy responses\n\nAll listing tools that return heavy JSON (console / network / errors / storage / reactQuery / log_box / navigation / metro events / fiber_tree) accept the standard `path` / `depth` / `maxBytes` projection args. Heavy nested values collapse to compact `${...}`-keyed markers; primitives stay raw. Drill into a specific subtree via the same tool with `path` \u2014 no separate by-id fetcher.\n\n  `network__get_requests({ path: '[-1:][0].response.body' })`         \u2014 last request's body\n  `network__get_requests({ path: '[-1:][0].response.body', depth: 8 })` \u2014 fully expanded\n  `console__get_logs({ path: '[-3:][0].args[1]' })`                    \u2014 second arg of the third-from-last log\n  `storage__get_item({ key: 'session', path: 'value.user.email' })`    \u2014 drill into a stored value\n  `query__get_data({ key: '[\"users\"]', path: 'data.email' })`         \u2014 drill into cached data\n\nPath syntax (JS-style):\n  `.key` or `[\"key.with.dots\"]` \u2014 object key access\n  `[N]` \u2014 index (numeric for arrays, Nth char for strings, Nth key in insertion order for objects)\n  `[start:end]` / `[start:]` / `[:end]` \u2014 slice (Python/jq-style; negative indices count from end). Works on arrays, strings, and objects (key slice). After array slice, chained `.key` maps over each element; `[N]` picks one.\n\nPath drilling to a string scalar applies `previewCap` as usual \u2014 long leaves still wrap in a `${str}` marker. To get a raw substring, end the path with a slice: `stack[0:500]` returns the first 500 chars verbatim (slice = explicit truncation request, previewCap bypassed). Default `previewCap` is 250; override per call via `previewCap: <N>`.\n\n`depth` (default per tool, max 8) controls how many container levels are walked before collapsing to a marker. Bump `depth` for an exploratory survey, use `path` for a targeted drill. `maxBytes` (default 50KB) caps the total response size \u2014 overflow is replaced with a single `${str}` marker carrying the original byte count + a preview.\n\nFor `fiber_tree__query`, heavy fields (`props`, `hooks`) take projection knobs per-field via `select` so the rest of the response stays raw:\n  `select: [{ props: { path: \"style\", depth: 2 } }]`   \u2014 drill into props.style 2 levels deep\n  `select: [{ props: { path: \"data[0:5]\" } }]`         \u2014 slice path: take first 5 items of props.data\n  `select: [{ hooks: { kinds: [\"State\"], names: [\"isLoading\"], withValues: true, depth: 2 } }]` \u2014 filter + project hook values\n  `select: [{ children: 5 }]`                          \u2014 light-only recursive tree walker (5 levels deep); use `scope: \"root\"` as the first step to dump the whole tree. props/hooks not supported inside; sub-children past treeDepth surface as `${arr}: N`.\n\nHook filters: `kinds` (State/Effect/Memo/Ref/Custom/...), `names` (exact or `/regex/flags`), `withValues` (adds resolved values), `expansionDepth` (caps custom-hook recursion), `format: \"tree\"` (nested children vs flat `via` chains). Each hook entry carries `{ kind, name, hook?, via?, expanded? }`. Sensitive names (password, token, jwt, secret, credential, apiKey, authorization, Pin suffix) are auto-redacted; configure via `fiberTreeModule({ redactHookNames, additionalRedactHookNames })`.\n\nMarker format: `{ \"${obj}\": N }` for collapsed objects (N keys), `{ \"${arr}\": N }` for arrays (N items), `{ \"${fun}\": \"name\" }` for functions, `{ \"${str}\": { len, preview } }` for long strings (>`previewCap`, default 250), `{ \"${Date}\": \"iso\" }` for Date, `{ \"${Err}\": { name, msg } }` for Error, `{ \"${RegExp}\": \"/.../i\" }` for RegExp, `{ \"${map}\": N }` / `{ \"${set}\": N }` for Map/Set sizes, `{ \"${cyc}\": true }` for cycles, `{ \"${ref}\": { mcpId, name } }` for fiber/native refs, `{ \"${cls}\": { name, len } }` for class instances, `{ \"${truncated}\": { total, slice } }` first key/item when a container is wider than the cap (30 keys for objects, 50 items for arrays).\n";
 //# sourceMappingURL=instructions.d.ts.map

package/dist/server/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/server/instructions.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,22VAoE7B,CAAC"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/server/instructions.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,ssZAmF7B,CAAC"}

package/dist/server/instructions.js

@@ -15,6 +15,21 @@ Multiple React Native apps can connect simultaneously — each is identified by
 5. Use \`wait_until\` to poll any tool until a predicate over its result holds (or timeout). Replaces "screenshot in a loop + sleep" for state-level waits ("wait for network to idle", "wait for state key X to become Y"). Predicate supports compound forms: { all: [...] } (AND), { any: [...] } (OR), { not: predicate }.
 6. For UI-level waits ("wait for a screen to appear", "wait for a spinner to disappear") use \`fiber_tree${protocol_1.MODULE_SEPARATOR}query\` with \`waitFor: { until: "appear" | "disappear", timeout?, interval?, stable? }\` — it polls the same query with cache bypassed until the target state holds. \`stable: <ms>\` requires continuous presence/absence for that many ms to ignore transient matches during screen transitions.
 7. Use \`assert\` for a single-shot checkpoint after actions — same predicate vocabulary as wait_until, returns { pass, actual, expected?, result? }. Natural pair: do action → wait_until / fiber_tree waitFor → assert.
+
+### Broadcast — same call on several clients
+
+\`call\`, \`wait_until\` and \`assert\` accept \`clientId\` as either a string or an array of strings. A string keeps the single-client shape (image content passes through). An array dispatches the same invocation to every listed client in parallel — useful for iOS↔Android parity, A/B device runs, or asserting a state across all attached apps in one round-trip.
+
+  \`call({ clientId: ["ios-1", "android-1"], tool: "host${protocol_1.MODULE_SEPARATOR}screenshot" })\`          — two screenshots in one response
+  \`wait_until({ clientId: ["ios-1", "android-1"], tool: "navigation${protocol_1.MODULE_SEPARATOR}get_current_route", predicate: { op: "equals", path: "name", value: "CART" } })\`  — wait until both clients land on CART
+  \`assert({ clientId: ["ios-1", "android-1"], tool: "fiber_tree${protocol_1.MODULE_SEPARATOR}query", args: { mcpId: "checkout:button:submit" }, predicate: { op: "exists" } })\`     — the same fiber exists on both platforms
+
+Broadcast result shapes:
+  \`call\` — when every per-client result is text, you get one JSON envelope \`{ results: [{ clientId, ok, result | error }, ...] }\`. When any result is an image (screenshot), per-client \`## <clientId>\` text headers are interleaved with each client's blocks so each image stays paired with its source.
+  \`wait_until\` — \`{ ok, perClient: [{ clientId, ok, attempts, elapsedMs, matched? | lastResult, lastError?, reason? }, ...] }\`; overall \`ok\` is true only if every client matched within the shared timeout.
+  \`assert\` — \`{ pass, perClient: [{ clientId, pass, actual?, expected?, op?, path?, message?, result?, error? }, ...] }\`; overall \`pass\` is true only when every client passed.
+
+\`list_tools\` and \`describe_tool\` also accept an array \`clientId\` — there it narrows the considered client set (filter / canonicalisation pool) rather than triggering a broadcast.
 8. Use \`host${protocol_1.MODULE_SEPARATOR}tap_fiber\` to collapse "fiber_tree__query → host__tap at bounds" into one call. Pass fiber_tree steps; if exactly one fiber matches, its center is tapped. Ambiguous match returns the candidate list so you can add \`index\` or narrow the chain.
 
 Some tools run inline on the MCP server host (e.g. \`host${protocol_1.MODULE_SEPARATOR}screenshot\`, \`host${protocol_1.MODULE_SEPARATOR}list_devices\`, \`host${protocol_1.MODULE_SEPARATOR}launch_app\`, \`host${protocol_1.MODULE_SEPARATOR}terminate_app\`, \`host${protocol_1.MODULE_SEPARATOR}restart_app\`, \`metro${protocol_1.MODULE_SEPARATOR}reload\`, \`metro${protocol_1.MODULE_SEPARATOR}symbolicate\`) and work even when no React Native client is connected. They use xcrun simctl / adb on the dev machine. When \`clientId\` is provided, host tools use that client's platform/label/deviceId as hints to resolve the target device; otherwise they prefer the device of the single connected client, falling back to the single booted sim / online device. \`launch_app\`, \`terminate_app\`, and \`restart_app\` accept an \`appId\` arg (iOS bundle ID / Android package name); omit it to reuse the target client's registered \`bundleId\` from its connection metadata.

package/dist/server/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/server/instructions.ts"],"names":[],"mappings":";;;AAAA,gDAAqD;AAExC,QAAA,iBAAiB,GAAG;;;;;;;;;wDASuB,2BAAgB,0BAA0B,2BAAgB;;2GAEP,2BAAgB;;eAE5G,2BAAgB;;2DAE4B,2BAAgB,uBAAuB,2BAAgB,yBAAyB,2BAAgB,uBAAuB,2BAAgB,0BAA0B,2BAAgB,yBAAyB,2BAAgB,oBAAoB,2BAAgB;;;aAG5S,2BAAgB;mBACV,2BAAgB,8DAA8D,2BAAgB;mBAC9F,2BAAgB;aACtB,2BAAgB,uDAAuD,2BAAgB;;uBAE7E,2BAAgB,iBAAiB,2BAAgB,wBAAwB,2BAAgB,mBAAmB,2BAAgB,kBAAkB,2BAAgB,uBAAuB,2BAAgB,6BAA6B,2BAAgB;;wBAEjP,2BAAgB,6BAA6B,2BAAgB,8EAA8E,2BAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ClL,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/server/instructions.ts"],"names":[],"mappings":";;;AAAA,gDAAqD;AAExC,QAAA,iBAAiB,GAAG;;;;;;;;;wDASuB,2BAAgB,0BAA0B,2BAAgB;;2GAEP,2BAAgB;;;;;;;0DAOjE,2BAAgB;sEACJ,2BAAgB;kEACpB,2BAAgB;;;;;;;;eAQnE,2BAAgB;;2DAE4B,2BAAgB,uBAAuB,2BAAgB,yBAAyB,2BAAgB,uBAAuB,2BAAgB,0BAA0B,2BAAgB,yBAAyB,2BAAgB,oBAAoB,2BAAgB;;;aAG5S,2BAAgB;mBACV,2BAAgB,8DAA8D,2BAAgB;mBAC9F,2BAAgB;aACtB,2BAAgB,uDAAuD,2BAAgB;;uBAE7E,2BAAgB,iBAAiB,2BAAgB,wBAAwB,2BAAgB,mBAAmB,2BAAgB,kBAAkB,2BAAgB,uBAAuB,2BAAgB,6BAA6B,2BAAgB;;wBAEjP,2BAAgB,6BAA6B,2BAAgB,8EAA8E,2BAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ClL,CAAC"}

package/dist/server/tools/assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../src/server/tools/assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAUhF,eAAO,MAAM,kBAAkB,QAAS,SAAS,OAAO,aAAa,KAAG,IAyEvE,CAAC"}
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../src/server/tools/assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AA4C1B,eAAO,MAAM,kBAAkB,QAAS,SAAS,OAAO,aAAa,KAAG,IAmFvE,CAAC"}

package/dist/server/tools/assert.js

@@ -5,6 +5,30 @@ const zod_1 = require("zod");
 const helpers_1 = require("../../server/helpers");
 const predicate_1 = require("../../server/predicate");
 const protocol_1 = require("../../shared/protocol");
+const evaluate = (dispatch, pred, isLeaf, leafPath, leafValue, leafOp, message) => {
+    if (!dispatch.ok) {
+        const failure = { error: dispatch.error, pass: false };
+        if (message)
+            failure.message = message;
+        return failure;
+    }
+    const pass = (0, predicate_1.evalPredicate)(dispatch.result, pred);
+    const payload = { pass };
+    if (isLeaf)
+        payload.actual = (0, predicate_1.resolvePath)(dispatch.result, leafPath);
+    if (!pass) {
+        if (isLeaf) {
+            payload.expected = leafValue;
+            payload.op = leafOp;
+            if (leafPath)
+                payload.path = leafPath;
+        }
+        if (message)
+            payload.message = message;
+        payload.result = dispatch.result;
+    }
+    return payload;
+};
 const registerAssertTool = (mcp, ctx) => {
     mcp.registerTool('assert', {
         annotations: {
@@ -13,9 +37,14 @@ const registerAssertTool = (mcp, ctx) => {
         },
         description: `Single-shot assertion over a tool's result. Same predicate vocabulary (including { all / any / not }) as wait_until, but one attempt and a standardized diff on failure.
 
-Returns { pass: true, actual? } on success — actual is the path-resolved value for leaf predicates, omitted for compound.
-Returns { pass: false, actual, expected?, op?, path?, message?, result } on predicate failure.
-Returns { pass: false, error, message? } when the tool dispatch itself threw.
+Single client (clientId omitted or a string):
+  Returns { pass: true, actual? } on success — actual is the path-resolved value for leaf predicates, omitted for compound.
+  Returns { pass: false, actual, expected?, op?, path?, message?, result } on predicate failure.
+  Returns { pass: false, error, message? } when the tool dispatch itself threw.
+
+Broadcast (clientId is an array — asserts on each client in parallel):
+  Returns { pass, perClient: [{ clientId, pass, actual?, expected?, op?, path?, message?, result?, error? }, ...] }
+  with overall pass = every client's assertion passed.
 
 Useful after wait_until as a checkpoint — the pair reads "do action → wait → assert" which produces a clean audit trail in session logs.`,
         inputSchema: {
@@ -23,7 +52,10 @@ Useful after wait_until as a checkpoint — the pair reads "do action → wait
                 .union([zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())])
                 .optional()
                 .describe('Arguments for the asserted tool — object or JSON string.'),
-            clientId: zod_1.z.string().optional().describe('Target client ID, same semantics as `call`.'),
+            clientId: zod_1.z
+                .union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())])
+                .optional()
+                .describe('Target client ID(s). String asserts on one client; array runs the same assertion on multiple clients in parallel. Same auto-resolution semantics as `call`.'),
             message: zod_1.z
                 .string()
                 .optional()
@@ -39,39 +71,31 @@ Useful after wait_until as a checkpoint — the pair reads "do action → wait
         const parsedArgs = (0, helpers_1.parseCallArgs)(args);
         if (!parsedArgs.ok)
             return (0, helpers_1.jsonError)(parsedArgs.error);
-        const dispatch = await ctx.dispatchTool(tool, parsedArgs.args, clientId);
-        if (!dispatch.ok) {
-            return {
-                content: [
-                    {
-                        text: JSON.stringify({ error: dispatch.error, message, pass: false }, null, 2),
-                        type: 'text',
-                    },
-                ],
-            };
-        }
+        const clients = (0, helpers_1.parseClientIds)(clientId);
+        if (!clients.ok)
+            return (0, helpers_1.jsonError)(clients.error);
         const pred = predicate;
         const isLeaf = (0, predicate_1.isLeafPredicate)(pred);
         const leafPath = isLeaf ? pred.path : undefined;
         const leafValue = isLeaf ? pred.value : undefined;
         const leafOp = isLeaf ? pred.op : undefined;
-        const pass = (0, predicate_1.evalPredicate)(dispatch.result, pred);
-        const payload = { pass };
-        if (isLeaf)
-            payload.actual = (0, predicate_1.resolvePath)(dispatch.result, leafPath);
-        if (!pass) {
-            if (isLeaf) {
-                payload.expected = leafValue;
-                payload.op = leafOp;
-                if (leafPath)
-                    payload.path = leafPath;
-            }
-            if (message)
-                payload.message = message;
-            payload.result = dispatch.result;
+        if (clients.mode === 'single') {
+            const dispatch = await ctx.dispatchTool(tool, parsedArgs.args, clients.clientId);
+            const payload = evaluate(dispatch, pred, isLeaf, leafPath, leafValue, leafOp, message);
+            return {
+                content: [{ text: JSON.stringify(payload, null, 2), type: 'text' }],
+            };
         }
+        const perClient = await Promise.all(clients.ids.map(async (id) => {
+            const dispatch = await ctx.dispatchTool(tool, parsedArgs.args, id);
+            const entry = evaluate(dispatch, pred, isLeaf, leafPath, leafValue, leafOp, message);
+            return { clientId: id, ...entry };
+        }));
+        const pass = perClient.every((entry) => {
+            return entry.pass === true;
+        });
         return {
-            content: [{ text: JSON.stringify(payload, null, 2), type: 'text' }],
+            content: [{ text: JSON.stringify({ pass, perClient }, null, 2), type: 'text' }],
         };
     });
 };

package/dist/server/tools/assert.js.map

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

package/dist/server/tools/call.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../../src/server/tools/call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGhF,eAAO,MAAM,gBAAgB,QAAS,SAAS,OAAO,aAAa,KAAG,IAsCrE,CAAC"}
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../../src/server/tools/call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,gBAAgB,QAAS,SAAS,OAAO,aAAa,KAAG,IAoDrE,CAAC"}

package/dist/server/tools/call.js

@@ -10,16 +10,16 @@ const registerCallTool = (mcp, ctx) => {
             openWorldHint: true,
             title: 'Call Tool',
         },
-        description: 'Call a tool registered by a React Native app client. Use list_tools first to see available tools. When multiple clients are connected, specify clientId; otherwise it is auto-picked. `args` accepts either a plain object or a JSON string — objects are preferred to avoid escaping quotes.',
+        description: 'Call a tool registered by a React Native app client. Use list_tools first to see available tools. When multiple clients are connected, specify clientId; otherwise it is auto-picked. Pass `clientId: ["ios-1", "android-1"]` (an array) to broadcast the same call to several clients in parallel — useful for iOS↔Android parity checks. `args` accepts either a plain object or a JSON string — objects are preferred to avoid escaping quotes.',
         inputSchema: {
             args: zod_1.z
                 .union([zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())])
                 .optional()
                 .describe('Tool arguments as a plain object (e.g. { screen: "AUTH_LOGIN_SCREEN" }) or a JSON string.'),
             clientId: zod_1.z
-                .string()
+                .union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())])
                 .optional()
-                .describe('Target client ID (e.g. "ios-1", "android-1"). Optional when exactly one client is connected.'),
+                .describe('Target client ID(s). String selects one client (e.g. "ios-1"); array broadcasts the call to multiple clients in parallel (e.g. ["ios-1", "android-1"]). Optional when exactly one client is connected.'),
             tool: zod_1.z
                 .string()
                 .describe(`Tool name in format "module${protocol_1.MODULE_SEPARATOR}method" (e.g. "navigation${protocol_1.MODULE_SEPARATOR}navigate")`),
@@ -28,10 +28,20 @@ const registerCallTool = (mcp, ctx) => {
         const parsed = (0, helpers_1.parseCallArgs)(args);
         if (!parsed.ok)
             return (0, helpers_1.jsonError)(parsed.error);
-        const dispatch = await ctx.dispatchTool(tool, parsed.args, clientId);
-        if (!dispatch.ok)
-            return (0, helpers_1.jsonError)(dispatch.error);
-        return { content: ctx.formatResult(dispatch.result) };
+        const clients = (0, helpers_1.parseClientIds)(clientId);
+        if (!clients.ok)
+            return (0, helpers_1.jsonError)(clients.error);
+        if (clients.mode === 'single') {
+            const dispatch = await ctx.dispatchTool(tool, parsed.args, clients.clientId);
+            if (!dispatch.ok)
+                return (0, helpers_1.jsonError)(dispatch.error);
+            return { content: ctx.formatResult(dispatch.result) };
+        }
+        const results = await Promise.all(clients.ids.map(async (id) => {
+            const result = await ctx.dispatchTool(tool, parsed.args, id);
+            return { clientId: id, result };
+        }));
+        return { content: (0, helpers_1.buildBroadcastContent)(results, ctx.formatResult) };
     });
 };
 exports.registerCallTool = registerCallTool;

package/dist/server/tools/call.js.map

@@ -1 +1 @@
-{"version":3,"file":"call.js","sourceRoot":"","sources":["../../../src/server/tools/call.ts"],"names":[],"mappings":";;;AACA,6BAAwB;AAExB,8CAAgF;AAChF,gDAAqD;AAE9C,MAAM,gBAAgB,GAAG,CAAC,GAAc,EAAE,GAAkB,EAAQ,EAAE;IAC3E,GAAG,CAAC,YAAY,CACd,MAAM,EACN;QACE,WAAW,EAAE;YACX,aAAa,EAAE,IAAI;YACnB,KAAK,EAAE,WAAW;SACnB;QACD,WAAW,EACT,+RAA+R;QACjS,WAAW,EAAE;YACX,IAAI,EAAE,OAAC;iBACJ,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;iBACtD,QAAQ,EAAE;iBACV,QAAQ,CACP,2FAA2F,CAC5F;YACH,QAAQ,EAAE,OAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,8FAA8F,CAC/F;YACH,IAAI,EAAE,OAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CACP,8BAA8B,2BAAgB,4BAA4B,2BAAgB,YAAY,CACvG;SACJ;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,IAAA,uBAAa,EAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,IAAA,mBAAS,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAA,mBAAS,EAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnD,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IACxD,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAtCW,QAAA,gBAAgB,oBAsC3B"}
+{"version":3,"file":"call.js","sourceRoot":"","sources":["../../../src/server/tools/call.ts"],"names":[],"mappings":";;;AACA,6BAAwB;AAExB,8CAO0B;AAC1B,gDAAqD;AAE9C,MAAM,gBAAgB,GAAG,CAAC,GAAc,EAAE,GAAkB,EAAQ,EAAE;IAC3E,GAAG,CAAC,YAAY,CACd,MAAM,EACN;QACE,WAAW,EAAE;YACX,aAAa,EAAE,IAAI;YACnB,KAAK,EAAE,WAAW;SACnB;QACD,WAAW,EACT,obAAob;QACtb,WAAW,EAAE;YACX,IAAI,EAAE,OAAC;iBACJ,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;iBACtD,QAAQ,EAAE;iBACV,QAAQ,CACP,2FAA2F,CAC5F;YACH,QAAQ,EAAE,OAAC;iBACR,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;iBACxC,QAAQ,EAAE;iBACV,QAAQ,CACP,wMAAwM,CACzM;YACH,IAAI,EAAE,OAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CACP,8BAA8B,2BAAgB,4BAA4B,2BAAgB,YAAY,CACvG;SACJ;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,IAAA,uBAAa,EAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,IAAA,mBAAS,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE/C,MAAM,OAAO,GAAG,IAAA,wBAAc,EAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,IAAA,mBAAS,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEjD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC7E,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,IAAA,mBAAS,EAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACnD,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,CAAC;QAED,MAAM,OAAO,GAAwB,MAAM,OAAO,CAAC,GAAG,CACpD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7D,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QAClC,CAAC,CAAC,CACH,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,IAAA,+BAAqB,EAAC,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;IACvE,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AApDW,QAAA,gBAAgB,oBAoD3B"}

package/dist/server/tools/describeTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"describeTool.d.ts","sourceRoot":"","sources":["../../../src/server/tools/describeTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,wBAAwB,QAAS,SAAS,OAAO,aAAa,KAAG,IAyJ7E,CAAC"}
+{"version":3,"file":"describeTool.d.ts","sourceRoot":"","sources":["../../../src/server/tools/describeTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAKL,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,wBAAwB,QAAS,SAAS,OAAO,aAAa,KAAG,IAgL7E,CAAC"}

package/dist/server/tools/describeTool.js

@@ -10,17 +10,20 @@ const registerDescribeToolTool = (mcp, ctx) => {
             readOnlyHint: true,
             title: 'Describe Tool',
         },
-        description: 'Fetch the full description and input schema for a single tool. Use this after list_tools to learn how to construct arguments for a tool before calling it. For host tools, clientId is ignored. For in-app tools, omit clientId to auto-pick the shared descriptor; specify it only when multiple clients have the same tool with different schemas.',
+        description: 'Fetch the full description and input schema for a single tool. Use this after list_tools to learn how to construct arguments for a tool before calling it. For host tools, clientId is ignored. For in-app tools, omit clientId to auto-pick the shared descriptor; specify a string clientId to pin to one client, or an array of clientIds to narrow the auto-pick to that subset (useful when other clients have a divergent schema).',
         inputSchema: {
             clientId: zod_1.z
-                .string()
+                .union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())])
                 .optional()
-                .describe('Target client ID for in-app tools. Required only when multiple clients have the same tool with different schemas. Ignored for host tools.'),
+                .describe('Target client(s) for in-app tools. String pins to one client; array narrows the canonicalisation pool to the listed clients. Ignored for host tools.'),
             tool: zod_1.z
                 .string()
                 .describe(`Full tool name in the format "module${protocol_1.MODULE_SEPARATOR}method" (e.g. "navigation${protocol_1.MODULE_SEPARATOR}navigate", "host${protocol_1.MODULE_SEPARATOR}screenshot").`),
         },
     }, async ({ clientId, tool }) => {
+        const parsedClient = (0, helpers_1.parseClientIds)(clientId);
+        if (!parsedClient.ok)
+            return (0, helpers_1.jsonError)(parsedClient.error);
         // 1. Host tool path — resolved via hostToolMap, clientId is ignored
         const hostEntry = ctx.hostToolMap.get(tool);
         if (hostEntry) {
@@ -45,9 +48,10 @@ const registerDescribeToolTool = (mcp, ctx) => {
                 ],
             };
         }
-        // 2. Explicit clientId — look up the specific client
-        if (clientId) {
-            const client = ctx.bridge.getClient(clientId);
+        // 2. Explicit single clientId — pin to one client
+        if (parsedClient.mode === 'single' && parsedClient.clientId) {
+            const pinned = parsedClient.clientId;
+            const client = ctx.bridge.getClient(pinned);
             if (!client) {
                 const available = ctx.bridge
                     .listClients()
@@ -55,17 +59,17 @@ const registerDescribeToolTool = (mcp, ctx) => {
                     return c.id;
                 })
                     .join(', ') || '(none)';
-                return (0, helpers_1.jsonError)(`Client '${clientId}' not connected. Available: ${available}`);
+                return (0, helpers_1.jsonError)(`Client '${pinned}' not connected. Available: ${available}`);
             }
             const found = (0, helpers_1.findToolInClient)(client, tool);
             if (!found) {
-                return (0, helpers_1.jsonError)(`Tool '${tool}' not found on client '${clientId}'.`);
+                return (0, helpers_1.jsonError)(`Tool '${tool}' not found on client '${pinned}'.`);
             }
             return {
                 content: [
                     {
                         text: JSON.stringify({
-                            clientIds: [clientId],
+                            clientIds: [pinned],
                             description: found.description,
                             inputSchema: found.inputSchema,
                             name: tool,
@@ -76,8 +80,23 @@ const registerDescribeToolTool = (mcp, ctx) => {
                 ],
             };
         }
-        // 3. Auto-pick across all connected clients
-        const clients = ctx.bridge.listClients();
+        // 3. Auto-pick across all connected clients (optionally narrowed by an
+        //    explicit array of clientIds — only those clients participate in the
+        //    canonicalisation pool).
+        const allClients = ctx.bridge.listClients();
+        const clients = parsedClient.mode === 'broadcast'
+            ? allClients.filter((c) => {
+                return parsedClient.ids.includes(c.id);
+            })
+            : allClients;
+        if (parsedClient.mode === 'broadcast' && clients.length === 0) {
+            const available = allClients
+                .map((c) => {
+                return c.id;
+            })
+                .join(', ') || '(none)';
+            return (0, helpers_1.jsonError)(`None of the requested clients (${parsedClient.ids.join(', ')}) are connected. Available: ${available}`);
+        }
         const matches = [];
         for (const c of clients) {
             const found = (0, helpers_1.findToolInClient)(c, tool);

package/dist/server/tools/describeTool.js.map

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

package/dist/server/tools/listTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listTools.d.ts","sourceRoot":"","sources":["../../../src/server/tools/listTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAqB,KAAK,aAAa,EAAkB,MAAM,kBAAkB,CAAC;AAGzF,eAAO,MAAM,qBAAqB,QAAS,SAAS,OAAO,aAAa,KAAG,IAwH1E,CAAC"}
+{"version":3,"file":"listTools.d.ts","sourceRoot":"","sources":["../../../src/server/tools/listTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,qBAAqB,QAAS,SAAS,OAAO,aAAa,KAAG,IAiI1E,CAAC"}

package/dist/server/tools/listTools.js

@@ -10,12 +10,12 @@ const registerListToolsTool = (mcp, ctx) => {
             readOnlyHint: true,
             title: 'List Tools',
         },
-        description: 'Browse available tools with compact (schema-free) descriptions. Modules with identical shape across multiple clients are deduplicated into a single entry with a clientIds array. Use describe_tool to fetch the full input schema for a specific tool before calling it. Pass `module` to narrow to one module, `clientId` to narrow to one client, `compact: true` to drop long module-level descriptions.',
+        description: 'Browse available tools with compact (schema-free) descriptions. Modules with identical shape across multiple clients are deduplicated into a single entry with a clientIds array. Use describe_tool to fetch the full input schema for a specific tool before calling it. Pass `module` to narrow to one module, `clientId` to narrow to one client (string) or several clients (array, e.g. ["ios-1", "android-1"]), `compact: true` to drop long module-level descriptions.',
         inputSchema: {
             clientId: zod_1.z
-                .string()
+                .union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())])
                 .optional()
-                .describe('Narrow listing to a single client. Omit for all connected clients.'),
+                .describe('Narrow listing to a single client (string) or several clients (array). Omit for all connected clients.'),
             compact: zod_1.z
                 .boolean()
                 .optional()
@@ -26,12 +26,19 @@ const registerListToolsTool = (mcp, ctx) => {
                 .describe('Narrow listing to a single module name (e.g. "fiber_tree", "host"). Omit for all.'),
         },
     }, async ({ clientId, compact, module }) => {
+        const filter = (0, helpers_1.parseClientIds)(clientId);
+        if (!filter.ok)
+            return (0, helpers_1.jsonError)(filter.error);
         const allClients = ctx.bridge.listClients();
-        const clients = clientId
+        const clients = filter.mode === 'broadcast'
             ? allClients.filter((c) => {
-                return c.id === clientId;
+                return filter.ids.includes(c.id);
             })
-            : allClients;
+            : filter.clientId
+                ? allClients.filter((c) => {
+                    return c.id === filter.clientId;
+                })
+                : allClients;
         // Dedup tool groups across clients by canonical shape
         const dedupMap = new Map();
         for (const client of clients) {

package/dist/server/tools/listTools.js.map

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

package/dist/server/tools/waitUntil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"waitUntil.d.ts","sourceRoot":"","sources":["../../../src/server/tools/waitUntil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAUhF,eAAO,MAAM,qBAAqB,QAAS,SAAS,OAAO,aAAa,KAAG,IAsH1E,CAAC"}
+{"version":3,"file":"waitUntil.d.ts","sourceRoot":"","sources":["../../../src/server/tools/waitUntil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAA4C,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAwEhG,eAAO,MAAM,qBAAqB,QAAS,SAAS,OAAO,aAAa,KAAG,IAgJ1E,CAAC"}

package/dist/server/tools/waitUntil.js

@@ -5,6 +5,48 @@ const zod_1 = require("zod");
 const helpers_1 = require("../../server/helpers");
 const predicate_1 = require("../../server/predicate");
 const protocol_1 = require("../../shared/protocol");
+const pollForClient = async (ctx, tool, args, clientId, pred, isLeaf, leafPath, timeout, interval) => {
+    const started = Date.now();
+    let attempts = 0;
+    let lastResult;
+    let lastError;
+    while (Date.now() - started < timeout) {
+        attempts += 1;
+        const dispatch = await ctx.dispatchTool(tool, args, clientId);
+        if (dispatch.ok) {
+            lastResult = dispatch.result;
+            if ((0, predicate_1.evalPredicate)(lastResult, pred)) {
+                const outcome = {
+                    attempts,
+                    elapsedMs: Date.now() - started,
+                    ok: true,
+                };
+                if (isLeaf)
+                    outcome.matched = (0, predicate_1.resolvePath)(lastResult, leafPath);
+                return outcome;
+            }
+        }
+        else {
+            lastError = dispatch.error;
+        }
+        const remaining = timeout - (Date.now() - started);
+        if (remaining <= 0)
+            break;
+        await new Promise((r) => {
+            return setTimeout(r, Math.min(interval, remaining));
+        });
+    }
+    return {
+        attempts,
+        elapsedMs: Date.now() - started,
+        lastError,
+        lastResult,
+        ok: false,
+        reason: lastError
+            ? `Last dispatch failed: ${lastError}`
+            : `Predicate did not hold within ${timeout}ms`,
+    };
+};
 const registerWaitUntilTool = (mcp, ctx) => {
     mcp.registerTool('wait_until', {
         annotations: {
@@ -30,15 +72,23 @@ PREDICATE
   Example: { all: [{op:"equals", path:"name", value:"CART"}, {op:"gt", path:"items.length", value:0}] }
 
 RETURNS
-  { ok: true, attempts, elapsedMs, matched? } on success — matched is the path-
-    resolved value for leaf predicates, omitted for compound.
-  { ok: false, reason, attempts, elapsedMs, lastResult, lastError? } on timeout.`,
+  Single client (clientId omitted or a string):
+    { ok: true, attempts, elapsedMs, matched? } on success — matched is the path-
+      resolved value for leaf predicates, omitted for compound.
+    { ok: false, reason, attempts, elapsedMs, lastResult, lastError? } on timeout.
+
+  Broadcast (clientId is an array — polls each client in parallel under the
+  shared timeout): { ok, perClient: [{ clientId, ok, attempts, elapsedMs, matched? | lastResult, lastError? }, ...] }
+  with overall ok = every client matched within its budget.`,
         inputSchema: {
             args: zod_1.z
                 .union([zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())])
                 .optional()
                 .describe('Arguments for the polled tool — object or JSON string.'),
-            clientId: zod_1.z.string().optional().describe('Target client ID, same semantics as `call`.'),
+            clientId: zod_1.z
+                .union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())])
+                .optional()
+                .describe('Target client ID(s). String polls one client; array broadcasts the poll to multiple clients in parallel and reports per-client outcomes. Same auto-resolution semantics as `call`.'),
             intervalMs: zod_1.z
                 .number()
                 .optional()
@@ -58,60 +108,60 @@ RETURNS
         const parsedArgs = (0, helpers_1.parseCallArgs)(args);
         if (!parsedArgs.ok)
             return (0, helpers_1.jsonError)(parsedArgs.error);
+        const clients = (0, helpers_1.parseClientIds)(clientId);
+        if (!clients.ok)
+            return (0, helpers_1.jsonError)(clients.error);
         const pred = predicate;
         const isLeaf = (0, predicate_1.isLeafPredicate)(pred);
         const leafPath = isLeaf ? pred.path : undefined;
         const timeout = Math.max(500, Math.min(60_000, timeoutMs ?? 10_000));
         const interval = Math.max(50, Math.min(5_000, intervalMs ?? 300));
-        const started = Date.now();
-        let attempts = 0;
-        let lastResult;
-        let lastError;
-        while (Date.now() - started < timeout) {
-            attempts += 1;
-            const dispatch = await ctx.dispatchTool(tool, parsedArgs.args, clientId);
-            if (dispatch.ok) {
-                lastResult = dispatch.result;
-                if ((0, predicate_1.evalPredicate)(lastResult, pred)) {
-                    const payload = {
-                        attempts,
-                        elapsedMs: Date.now() - started,
-                        ok: true,
-                    };
-                    if (isLeaf) {
-                        payload.matched = (0, predicate_1.resolvePath)(lastResult, leafPath);
-                    }
-                    return {
-                        content: [{ text: JSON.stringify(payload, null, 2), type: 'text' }],
-                    };
-                }
+        if (clients.mode === 'single') {
+            const outcome = await pollForClient(ctx, tool, parsedArgs.args, clients.clientId, pred, isLeaf, leafPath, timeout, interval);
+            const payload = {
+                attempts: outcome.attempts,
+                elapsedMs: outcome.elapsedMs,
+                ok: outcome.ok,
+            };
+            if (outcome.ok) {
+                if (isLeaf)
+                    payload.matched = outcome.matched;
             }
             else {
-                lastError = dispatch.error;
+                payload.lastResult = outcome.lastResult;
+                payload.reason = outcome.reason;
+                if (outcome.lastError)
+                    payload.lastError = outcome.lastError;
             }
-            const remaining = timeout - (Date.now() - started);
-            if (remaining <= 0)
-                break;
-            await new Promise((r) => {
-                return setTimeout(r, Math.min(interval, remaining));
-            });
+            return {
+                content: [{ text: JSON.stringify(payload, null, 2), type: 'text' }],
+            };
         }
+        const perClient = await Promise.all(clients.ids.map(async (id) => {
+            const outcome = await pollForClient(ctx, tool, parsedArgs.args, id, pred, isLeaf, leafPath, timeout, interval);
+            const entry = {
+                attempts: outcome.attempts,
+                clientId: id,
+                elapsedMs: outcome.elapsedMs,
+                ok: outcome.ok,
+            };
+            if (outcome.ok) {
+                if (isLeaf)
+                    entry.matched = outcome.matched;
+            }
+            else {
+                entry.lastResult = outcome.lastResult;
+                entry.reason = outcome.reason;
+                if (outcome.lastError)
+                    entry.lastError = outcome.lastError;
+            }
+            return entry;
+        }));
+        const ok = perClient.every((entry) => {
+            return entry.ok === true;
+        });
         return {
-            content: [
-                {
-                    text: JSON.stringify({
-                        attempts,
-                        elapsedMs: Date.now() - started,
-                        lastError,
-                        lastResult,
-                        ok: false,
-                        reason: lastError
-                            ? `Last dispatch failed: ${lastError}`
-                            : `Predicate did not hold within ${timeout}ms`,
-                    }, null, 2),
-                    type: 'text',
-                },
-            ],
+            content: [{ text: JSON.stringify({ ok, perClient }, null, 2), type: 'text' }],
         };
     });
 };

package/dist/server/tools/waitUntil.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-mcp-kit",
-  "version": "4.2.1",
+  "version": "4.3.0",
   "description": "MCP server for React Native — drive, inspect, and debug running RN apps from AI agents via the real OS gesture pipeline",
   "license": "MIT",
   "author": "Aliaksei Pranko",