react-native-mcp-kit 4.2.0 → 4.2.1

package/dist/server/host/tools/input/longPress.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.longPressTool = void 0;
+const deviceResolver_1 = require("../../../../server/host/deviceResolver");
+const helpers_1 = require("../../../../server/host/helpers");
+const iosInput_1 = require("../../../../server/host/iosInput");
+const android_1 = require("./android");
+const constants_1 = require("./constants");
+const longPressTool = (runner) => {
+    return {
+        description: 'Primary way to deliver a long-press: hold a touch at (x, y) for durationMs through the OS gesture pipeline. Default 700ms — above the RN Pressable long-press threshold (~500ms) with margin. Internally a zero-distance swipe kept alive for the full duration on both platforms.',
+        handler: async (args, ctx) => {
+            const resolved = await (0, deviceResolver_1.resolveDevice)(ctx, (0, helpers_1.parseResolveOptions)(args), runner);
+            if (!resolved.ok) {
+                return { error: resolved.error };
+            }
+            const x = (0, helpers_1.parseCoord)(args.x, 'x');
+            if (!x.ok)
+                return { error: x.error };
+            const y = (0, helpers_1.parseCoord)(args.y, 'y');
+            if (!y.ok)
+                return { error: y.error };
+            const durationMs = (0, constants_1.clampLongPressDuration)(args.durationMs);
+            const result = resolved.device.platform === 'ios'
+                ? await (0, iosInput_1.swipeIos)(resolved.device.nativeId, x.value, y.value, x.value, y.value, durationMs, runner)
+                : await (0, android_1.swipeAndroid)(resolved.device.nativeId, x.value, y.value, x.value, y.value, durationMs, runner);
+            if ('error' in result) {
+                return { error: result.error };
+            }
+            return { device: resolved.device, durationMs, longPressed: true, x: x.value, y: y.value };
+        },
+        inputSchema: {
+            durationMs: {
+                default: constants_1.LONG_PRESS_DURATION_DEFAULT_MS,
+                description: 'Hold duration in milliseconds.',
+                maximum: constants_1.SWIPE_DURATION_MAX_MS,
+                minimum: constants_1.SWIPE_DURATION_MIN_MS,
+                type: 'number',
+            },
+            platform: helpers_1.PLATFORM_ARG_SCHEMA,
+            x: { description: 'Absolute x pixel coordinate.', minimum: 0, type: 'number' },
+            y: { description: 'Absolute y pixel coordinate.', minimum: 0, type: 'number' },
+            ...helpers_1.NATIVE_ID_SCHEMA,
+        },
+        timeout: constants_1.INPUT_TIMEOUT_MS + constants_1.SWIPE_DURATION_MAX_MS,
+    };
+};
+exports.longPressTool = longPressTool;
+//# sourceMappingURL=longPress.js.map

package/dist/server/host/tools/input/longPress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"longPress.js","sourceRoot":"","sources":["../../../../../src/server/host/tools/input/longPress.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAC7D,mDAK+B;AAC/B,qDAAkD;AAIlD,uCAAyC;AACzC,2CAMqB;AAEd,MAAM,aAAa,GAAG,CAAC,MAAqB,EAAmB,EAAE;IACtE,OAAO;QACL,WAAW,EACT,oRAAoR;QACtR,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,MAAM,IAAA,8BAAa,EAAC,GAAG,EAAE,IAAA,6BAAmB,EAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YAC7E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnC,CAAC;YACD,MAAM,CAAC,GAAG,IAAA,oBAAU,EAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,IAAA,oBAAU,EAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,UAAU,GAAG,IAAA,kCAAsB,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3D,MAAM,MAAM,GACV,QAAQ,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK;gBAChC,CAAC,CAAC,MAAM,IAAA,mBAAQ,EACZ,QAAQ,CAAC,MAAM,CAAC,QAAQ,EACxB,CAAC,CAAC,KAAK,EACP,CAAC,CAAC,KAAK,EACP,CAAC,CAAC,KAAK,EACP,CAAC,CAAC,KAAK,EACP,UAAU,EACV,MAAM,CACP;gBACH,CAAC,CAAC,MAAM,IAAA,sBAAY,EAChB,QAAQ,CAAC,MAAM,CAAC,QAAQ,EACxB,CAAC,CAAC,KAAK,EACP,CAAC,CAAC,KAAK,EACP,CAAC,CAAC,KAAK,EACP,CAAC,CAAC,KAAK,EACP,UAAU,EACV,MAAM,CACP,CAAC;YACR,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;gBACtB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAC5F,CAAC;QACD,WAAW,EAAE;YACX,UAAU,EAAE;gBACV,OAAO,EAAE,0CAA8B;gBACvC,WAAW,EAAE,gCAAgC;gBAC7C,OAAO,EAAE,iCAAqB;gBAC9B,OAAO,EAAE,iCAAqB;gBAC9B,IAAI,EAAE,QAAQ;aACf;YACD,QAAQ,EAAE,6BAAmB;YAC7B,CAAC,EAAE,EAAE,WAAW,EAAE,8BAA8B,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9E,CAAC,EAAE,EAAE,WAAW,EAAE,8BAA8B,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9E,GAAG,0BAAgB;SACpB;QACD,OAAO,EAAE,4BAAgB,GAAG,iCAAqB;KAClD,CAAC;AACJ,CAAC,CAAC;AAtDW,QAAA,aAAa,iBAsDxB"}

package/dist/server/host/tools/input/pressKey.d.ts

@@ -0,0 +1,4 @@
+import { type ProcessRunner } from '../../../../server/host/processRunner';
+import { type HostToolHandler } from '../../../../server/host/types';
+export declare const pressKeyTool: (runner: ProcessRunner) => HostToolHandler;
+//# sourceMappingURL=pressKey.d.ts.map

package/dist/server/host/tools/input/pressKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pressKey.d.ts","sourceRoot":"","sources":["../../../../../src/server/host/tools/input/pressKey.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,eAAO,MAAM,YAAY,WAAY,aAAa,KAAG,eAgCpD,CAAC"}

package/dist/server/host/tools/input/pressKey.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pressKeyTool = void 0;
+const deviceResolver_1 = require("../../../../server/host/deviceResolver");
+const helpers_1 = require("../../../../server/host/helpers");
+const iosInput_1 = require("../../../../server/host/iosInput");
+const android_1 = require("./android");
+const constants_1 = require("./constants");
+const pressKeyTool = (runner) => {
+    return {
+        description: `Primary way to press a hardware / semantic key — routes through the OS so native handlers (back, home, volume, etc.) fire. Accepted: ${constants_1.KEY_NAMES.join(', ')}. iOS lacks back / menu / power / volume_up / volume_down.`,
+        handler: async (args, ctx) => {
+            const resolved = await (0, deviceResolver_1.resolveDevice)(ctx, (0, helpers_1.parseResolveOptions)(args), runner);
+            if (!resolved.ok) {
+                return { error: resolved.error };
+            }
+            const key = (0, helpers_1.parseStringArg)(args.key);
+            if (!key) {
+                return { error: `'key' is required. Supported: ${constants_1.KEY_NAMES.join(', ')}.` };
+            }
+            const result = resolved.device.platform === 'ios'
+                ? await (0, iosInput_1.pressKeyIos)(resolved.device.nativeId, key, runner)
+                : await (0, android_1.pressKeyAndroid)(resolved.device.nativeId, key, runner);
+            if ('error' in result) {
+                return { error: result.error };
+            }
+            return { device: resolved.device, key, pressed: true };
+        },
+        inputSchema: {
+            key: {
+                description: `Semantic key name. Mapped to the target platform's native key code internally. Supported: ${constants_1.KEY_NAMES.join(', ')}.`,
+                enum: constants_1.KEY_NAMES,
+                type: 'string',
+            },
+            platform: helpers_1.PLATFORM_ARG_SCHEMA,
+            ...helpers_1.NATIVE_ID_SCHEMA,
+        },
+        timeout: constants_1.INPUT_TIMEOUT_MS,
+    };
+};
+exports.pressKeyTool = pressKeyTool;
+//# sourceMappingURL=pressKey.js.map

package/dist/server/host/tools/input/pressKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pressKey.js","sourceRoot":"","sources":["../../../../../src/server/host/tools/input/pressKey.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAC7D,mDAK+B;AAC/B,qDAAqD;AAIrD,uCAA4C;AAC5C,2CAA0D;AAEnD,MAAM,YAAY,GAAG,CAAC,MAAqB,EAAmB,EAAE;IACrE,OAAO;QACL,WAAW,EAAE,wIAAwI,qBAAS,CAAC,IAAI,CAAC,IAAI,CAAC,4DAA4D;QACrO,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,MAAM,IAAA,8BAAa,EAAC,GAAG,EAAE,IAAA,6BAAmB,EAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YAC7E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnC,CAAC;YACD,MAAM,GAAG,GAAG,IAAA,wBAAc,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,EAAE,KAAK,EAAE,iCAAiC,qBAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7E,CAAC;YACD,MAAM,MAAM,GACV,QAAQ,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK;gBAChC,CAAC,CAAC,MAAM,IAAA,sBAAW,EAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC;gBAC1D,CAAC,CAAC,MAAM,IAAA,yBAAe,EAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YACnE,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;gBACtB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACzD,CAAC;QACD,WAAW,EAAE;YACX,GAAG,EAAE;gBACH,WAAW,EAAE,6FAA6F,qBAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBACjI,IAAI,EAAE,qBAAS;gBACf,IAAI,EAAE,QAAQ;aACf;YACD,QAAQ,EAAE,6BAAmB;YAC7B,GAAG,0BAAgB;SACpB;QACD,OAAO,EAAE,4BAAgB;KAC1B,CAAC;AACJ,CAAC,CAAC;AAhCW,QAAA,YAAY,gBAgCvB"}

package/dist/server/host/tools/input/swipe.d.ts

@@ -0,0 +1,4 @@
+import { type ProcessRunner } from '../../../../server/host/processRunner';
+import { type HostToolHandler } from '../../../../server/host/types';
+export declare const swipeTool: (runner: ProcessRunner) => HostToolHandler;
+//# sourceMappingURL=swipe.d.ts.map

package/dist/server/host/tools/input/swipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swipe.d.ts","sourceRoot":"","sources":["../../../../../src/server/host/tools/input/swipe.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAW3D,eAAO,MAAM,SAAS,WAAY,aAAa,KAAG,eA0EjD,CAAC"}

package/dist/server/host/tools/input/swipe.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.swipeTool = void 0;
+const deviceResolver_1 = require("../../../../server/host/deviceResolver");
+const helpers_1 = require("../../../../server/host/helpers");
+const iosInput_1 = require("../../../../server/host/iosInput");
+const android_1 = require("./android");
+const constants_1 = require("./constants");
+const swipeTool = (runner) => {
+    return {
+        description: 'Primary way to deliver a swipe / scroll gesture, from (x1, y1) to (x2, y2) in physical pixels. Runs through the OS gesture pipeline — Pan responders, scroll momentum, and gesture handlers all behave as under a finger. durationMs default 300, clamped 50..5000.',
+        handler: async (args, ctx) => {
+            const resolved = await (0, deviceResolver_1.resolveDevice)(ctx, (0, helpers_1.parseResolveOptions)(args), runner);
+            if (!resolved.ok) {
+                return { error: resolved.error };
+            }
+            const x1 = (0, helpers_1.parseCoord)(args.x1, 'x1');
+            if (!x1.ok)
+                return { error: x1.error };
+            const y1 = (0, helpers_1.parseCoord)(args.y1, 'y1');
+            if (!y1.ok)
+                return { error: y1.error };
+            const x2 = (0, helpers_1.parseCoord)(args.x2, 'x2');
+            if (!x2.ok)
+                return { error: x2.error };
+            const y2 = (0, helpers_1.parseCoord)(args.y2, 'y2');
+            if (!y2.ok)
+                return { error: y2.error };
+            const durationMs = (0, constants_1.clampSwipeDuration)(args.durationMs);
+            const result = resolved.device.platform === 'ios'
+                ? await (0, iosInput_1.swipeIos)(resolved.device.nativeId, x1.value, y1.value, x2.value, y2.value, durationMs, runner)
+                : await (0, android_1.swipeAndroid)(resolved.device.nativeId, x1.value, y1.value, x2.value, y2.value, durationMs, runner);
+            if ('error' in result) {
+                return { error: result.error };
+            }
+            return {
+                device: resolved.device,
+                durationMs,
+                from: { x: x1.value, y: y1.value },
+                swiped: true,
+                to: { x: x2.value, y: y2.value },
+            };
+        },
+        inputSchema: {
+            durationMs: {
+                default: constants_1.SWIPE_DURATION_DEFAULT_MS,
+                description: 'Total swipe duration in milliseconds.',
+                maximum: constants_1.SWIPE_DURATION_MAX_MS,
+                minimum: constants_1.SWIPE_DURATION_MIN_MS,
+                type: 'number',
+            },
+            platform: helpers_1.PLATFORM_ARG_SCHEMA,
+            x1: {
+                description: 'Start x pixel coordinate (top-left origin).',
+                minimum: 0,
+                type: 'number',
+            },
+            x2: { description: 'End x pixel coordinate (top-left origin).', minimum: 0, type: 'number' },
+            y1: {
+                description: 'Start y pixel coordinate (top-left origin).',
+                minimum: 0,
+                type: 'number',
+            },
+            y2: { description: 'End y pixel coordinate (top-left origin).', minimum: 0, type: 'number' },
+            ...helpers_1.NATIVE_ID_SCHEMA,
+        },
+        timeout: constants_1.INPUT_TIMEOUT_MS + constants_1.SWIPE_DURATION_MAX_MS,
+    };
+};
+exports.swipeTool = swipeTool;
+//# sourceMappingURL=swipe.js.map

package/dist/server/host/tools/input/swipe.js.map

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

package/dist/server/host/tools/input/tap.d.ts

@@ -0,0 +1,4 @@
+import { type ProcessRunner } from '../../../../server/host/processRunner';
+import { type HostToolHandler } from '../../../../server/host/types';
+export declare const tapTool: (runner: ProcessRunner) => HostToolHandler;
+//# sourceMappingURL=tap.d.ts.map

package/dist/server/host/tools/input/tap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap.d.ts","sourceRoot":"","sources":["../../../../../src/server/host/tools/input/tap.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,eAAO,MAAM,OAAO,WAAY,aAAa,KAAG,eAsC/C,CAAC"}

package/dist/server/host/tools/input/tap.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tapTool = void 0;
+const deviceResolver_1 = require("../../../../server/host/deviceResolver");
+const helpers_1 = require("../../../../server/host/helpers");
+const iosInput_1 = require("../../../../server/host/iosInput");
+const android_1 = require("./android");
+const constants_1 = require("./constants");
+const tapTool = (runner) => {
+    return {
+        description: 'Primary way to deliver a tap to the app, at physical-pixel (x, y). Runs through the real OS gesture pipeline so Pressable feedback, gesture responders, and hit-test all fire. For a fiber-targeted tap without copying bounds by hand, prefer host__tap_fiber.',
+        handler: async (args, ctx) => {
+            const resolved = await (0, deviceResolver_1.resolveDevice)(ctx, (0, helpers_1.parseResolveOptions)(args), runner);
+            if (!resolved.ok) {
+                return { error: resolved.error };
+            }
+            const x = (0, helpers_1.parseCoord)(args.x, 'x');
+            if (!x.ok)
+                return { error: x.error };
+            const y = (0, helpers_1.parseCoord)(args.y, 'y');
+            if (!y.ok)
+                return { error: y.error };
+            const result = resolved.device.platform === 'ios'
+                ? await (0, iosInput_1.tapIos)(resolved.device.nativeId, x.value, y.value, runner)
+                : await (0, android_1.tapAndroid)(resolved.device.nativeId, x.value, y.value, runner);
+            if ('error' in result) {
+                return { error: result.error };
+            }
+            return { device: resolved.device, tapped: true, x: x.value, y: y.value };
+        },
+        inputSchema: {
+            platform: helpers_1.PLATFORM_ARG_SCHEMA,
+            x: {
+                description: 'Absolute x pixel coordinate (top-left origin).',
+                minimum: 0,
+                type: 'number',
+            },
+            y: {
+                description: 'Absolute y pixel coordinate (top-left origin).',
+                minimum: 0,
+                type: 'number',
+            },
+            ...helpers_1.NATIVE_ID_SCHEMA,
+        },
+        timeout: constants_1.INPUT_TIMEOUT_MS,
+    };
+};
+exports.tapTool = tapTool;
+//# sourceMappingURL=tap.js.map

package/dist/server/host/tools/input/tap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap.js","sourceRoot":"","sources":["../../../../../src/server/host/tools/input/tap.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAC7D,mDAK+B;AAC/B,qDAAgD;AAIhD,uCAAuC;AACvC,2CAA+C;AAExC,MAAM,OAAO,GAAG,CAAC,MAAqB,EAAmB,EAAE;IAChE,OAAO;QACL,WAAW,EACT,iQAAiQ;QACnQ,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,MAAM,IAAA,8BAAa,EAAC,GAAG,EAAE,IAAA,6BAAmB,EAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YAC7E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnC,CAAC;YACD,MAAM,CAAC,GAAG,IAAA,oBAAU,EAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,IAAA,oBAAU,EAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,MAAM,GACV,QAAQ,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK;gBAChC,CAAC,CAAC,MAAM,IAAA,iBAAM,EAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC;gBAClE,CAAC,CAAC,MAAM,IAAA,oBAAU,EAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC3E,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;gBACtB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3E,CAAC;QACD,WAAW,EAAE;YACX,QAAQ,EAAE,6BAAmB;YAC7B,CAAC,EAAE;gBACD,WAAW,EAAE,gDAAgD;gBAC7D,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,QAAQ;aACf;YACD,CAAC,EAAE;gBACD,WAAW,EAAE,gDAAgD;gBAC7D,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,QAAQ;aACf;YACD,GAAG,0BAAgB;SACpB;QACD,OAAO,EAAE,4BAAgB;KAC1B,CAAC;AACJ,CAAC,CAAC;AAtCW,QAAA,OAAO,WAsClB"}

package/dist/server/host/tools/input/typeText.d.ts

@@ -0,0 +1,4 @@
+import { type ProcessRunner } from '../../../../server/host/processRunner';
+import { type HostToolHandler } from '../../../../server/host/types';
+export declare const typeTextTool: (runner: ProcessRunner) => HostToolHandler;
+//# sourceMappingURL=typeText.d.ts.map

package/dist/server/host/tools/input/typeText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeText.d.ts","sourceRoot":"","sources":["../../../../../src/server/host/tools/input/typeText.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,eAAO,MAAM,YAAY,WAAY,aAAa,KAAG,eA4CpD,CAAC"}

package/dist/server/host/tools/input/typeText.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typeTextTool = void 0;
+const deviceResolver_1 = require("../../../../server/host/deviceResolver");
+const helpers_1 = require("../../../../server/host/helpers");
+const iosInput_1 = require("../../../../server/host/iosInput");
+const android_1 = require("./android");
+const constants_1 = require("./constants");
+const typeTextTool = (runner) => {
+    return {
+        description: "Primary way to type into the currently focused text input — replaces existing content (select-all then paste). submit:true presses ENTER after typing. iOS: unicode via clipboard paste, keyboard-layout immune. Android: ASCII only (adb input text limitation); for non-Latin scripts fall back to fiber_tree__call on the input's onChangeText.",
+        handler: async (args, ctx) => {
+            const resolved = await (0, deviceResolver_1.resolveDevice)(ctx, (0, helpers_1.parseResolveOptions)(args), runner);
+            if (!resolved.ok) {
+                return { error: resolved.error };
+            }
+            const text = typeof args.text === 'string' ? args.text : undefined;
+            if (text === undefined) {
+                return { error: "'text' is required and must be a string" };
+            }
+            const submit = args.submit === true;
+            const result = resolved.device.platform === 'ios'
+                ? await (0, iosInput_1.typeTextIos)(resolved.device.nativeId, text, submit, runner)
+                : await (0, android_1.typeTextAndroid)(resolved.device.nativeId, text, submit, runner);
+            if ('error' in result) {
+                return { error: result.error };
+            }
+            return {
+                device: resolved.device,
+                length: text.length,
+                submitted: submit,
+                typed: true,
+            };
+        },
+        inputSchema: {
+            platform: helpers_1.PLATFORM_ARG_SCHEMA,
+            submit: {
+                default: false,
+                description: 'Press ENTER after typing (e.g. to submit a search).',
+                type: 'boolean',
+            },
+            text: {
+                description: 'Text to type into the currently focused input field. Whitespace and shell metacharacters are escaped automatically.',
+                type: 'string',
+            },
+            ...helpers_1.NATIVE_ID_SCHEMA,
+        },
+        timeout: constants_1.INPUT_TIMEOUT_MS,
+    };
+};
+exports.typeTextTool = typeTextTool;
+//# sourceMappingURL=typeText.js.map

package/dist/server/host/tools/input/typeText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeText.js","sourceRoot":"","sources":["../../../../../src/server/host/tools/input/typeText.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAC7D,mDAAmG;AACnG,qDAAqD;AAIrD,uCAA4C;AAC5C,2CAA+C;AAExC,MAAM,YAAY,GAAG,CAAC,MAAqB,EAAmB,EAAE;IACrE,OAAO;QACL,WAAW,EACT,oVAAoV;QACtV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,MAAM,IAAA,8BAAa,EAAC,GAAG,EAAE,IAAA,6BAAmB,EAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YAC7E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnC,CAAC;YACD,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YACnE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;YAC9D,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;YACpC,MAAM,MAAM,GACV,QAAQ,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK;gBAChC,CAAC,CAAC,MAAM,IAAA,sBAAW,EAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC;gBACnE,CAAC,CAAC,MAAM,IAAA,yBAAe,EAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAC5E,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;gBACtB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS,EAAE,MAAM;gBACjB,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QACD,WAAW,EAAE;YACX,QAAQ,EAAE,6BAAmB;YAC7B,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,qDAAqD;gBAClE,IAAI,EAAE,SAAS;aAChB;YACD,IAAI,EAAE;gBACJ,WAAW,EACT,qHAAqH;gBACvH,IAAI,EAAE,QAAQ;aACf;YACD,GAAG,0BAAgB;SACpB;QACD,OAAO,EAAE,4BAAgB;KAC1B,CAAC;AACJ,CAAC,CAAC;AA5CW,QAAA,YAAY,gBA4CvB"}

package/dist/server/host/tools/input/typeTextBatch.d.ts

@@ -0,0 +1,4 @@
+import { type ProcessRunner } from '../../../../server/host/processRunner';
+import { type HostToolHandler } from '../../../../server/host/types';
+export declare const typeTextBatchTool: (runner: ProcessRunner) => HostToolHandler;
+//# sourceMappingURL=typeTextBatch.d.ts.map

package/dist/server/host/tools/input/typeTextBatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeTextBatch.d.ts","sourceRoot":"","sources":["../../../../../src/server/host/tools/input/typeTextBatch.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAgB3D,eAAO,MAAM,iBAAiB,WAAY,aAAa,KAAG,eAyGzD,CAAC"}

package/dist/server/host/tools/input/typeTextBatch.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typeTextBatchTool = void 0;
+const deviceResolver_1 = require("../../../../server/host/deviceResolver");
+const helpers_1 = require("../../../../server/host/helpers");
+const iosInput_1 = require("../../../../server/host/iosInput");
+const android_1 = require("./android");
+const constants_1 = require("./constants");
+const typeTextBatchTool = (runner) => {
+    return {
+        description: `Primary way to fill multiple text fields in one call. Each field: { x, y, text, submit? }. For each entry — tap to focus, wait focusDelayMs, then type via the same semantics as host__type_text (select-all → paste on iOS; adb input text on Android). Stops on the first error and returns { filled, failedAt, error? }.
+
+focusDelayMs default is ${constants_1.BATCH_FOCUS_DELAY_DEFAULT_MS}ms — tuned for in-place TextInputs (login / signup forms, already-mounted fields). When the tap triggers a screen transition (e.g. searchBar → SearchScreen) the target input won't be mounted yet and the typed text is lost; bump focusDelayMs to 700-800. Set to 0 when the input is already focused.`,
+        handler: async (args, ctx) => {
+            const resolved = await (0, deviceResolver_1.resolveDevice)(ctx, (0, helpers_1.parseResolveOptions)(args), runner);
+            if (!resolved.ok) {
+                return { error: resolved.error };
+            }
+            const fields = args.fields;
+            if (!Array.isArray(fields) || fields.length === 0) {
+                return { error: "'fields' must be a non-empty array of { x, y, text, submit? }." };
+            }
+            const focusDelayMs = typeof args.focusDelayMs === 'number' && Number.isFinite(args.focusDelayMs)
+                ? Math.max(0, Math.min(constants_1.BATCH_FOCUS_DELAY_MAX_MS, Math.floor(args.focusDelayMs)))
+                : constants_1.BATCH_FOCUS_DELAY_DEFAULT_MS;
+            const results = [];
+            for (let i = 0; i < fields.length; i++) {
+                const raw = fields[i];
+                if (!raw || typeof raw !== 'object') {
+                    return { error: `fields[${i}]: must be an object.`, failedAt: i, filled: results.length };
+                }
+                const x = (0, helpers_1.parseCoord)(raw.x, `fields[${i}].x`);
+                if (!x.ok)
+                    return { error: x.error, failedAt: i, filled: results.length };
+                const y = (0, helpers_1.parseCoord)(raw.y, `fields[${i}].y`);
+                if (!y.ok)
+                    return { error: y.error, failedAt: i, filled: results.length };
+                if (typeof raw.text !== 'string') {
+                    return {
+                        error: `fields[${i}].text must be a string.`,
+                        failedAt: i,
+                        filled: results.length,
+                    };
+                }
+                const submit = raw.submit === true;
+                const focused = resolved.device.platform === 'ios'
+                    ? await (0, iosInput_1.tapIos)(resolved.device.nativeId, x.value, y.value, runner)
+                    : await (0, android_1.tapAndroid)(resolved.device.nativeId, x.value, y.value, runner);
+                if ('error' in focused) {
+                    return { error: focused.error, failedAt: i, filled: results.length };
+                }
+                // Give the soft keyboard (or a screen transition to a search-style
+                // view) a beat to come up before typing. Tunable per-call because
+                // navigation-triggering taps need more than in-place input focus.
+                if (focusDelayMs > 0) {
+                    await new Promise((r) => {
+                        return setTimeout(r, focusDelayMs);
+                    });
+                }
+                const typed = resolved.device.platform === 'ios'
+                    ? await (0, iosInput_1.typeTextIos)(resolved.device.nativeId, raw.text, submit, runner)
+                    : await (0, android_1.typeTextAndroid)(resolved.device.nativeId, raw.text, submit, runner);
+                if ('error' in typed) {
+                    return { error: typed.error, failedAt: i, filled: results.length };
+                }
+                results.push({ submitted: submit, x: x.value, y: y.value });
+            }
+            return { device: resolved.device, fields: results, filled: results.length };
+        },
+        inputSchema: {
+            fields: {
+                description: 'Ordered list of { x, y, text, submit? } entries. Each entry taps the coordinate to focus the input, waits focusDelayMs, then types the text.',
+                examples: [
+                    [
+                        { text: 'alice@example.com', x: 120, y: 400 },
+                        { submit: true, text: 'pa55word', x: 120, y: 520 },
+                    ],
+                ],
+                items: {
+                    properties: {
+                        submit: { default: false, type: 'boolean' },
+                        text: { type: 'string' },
+                        x: { minimum: 0, type: 'number' },
+                        y: { minimum: 0, type: 'number' },
+                    },
+                    required: ['x', 'y', 'text'],
+                    type: 'object',
+                },
+                minItems: 1,
+                type: 'array',
+            },
+            focusDelayMs: {
+                default: constants_1.BATCH_FOCUS_DELAY_DEFAULT_MS,
+                description: 'Delay between tap and type. Use 0 to skip when the input is already focused.',
+                maximum: constants_1.BATCH_FOCUS_DELAY_MAX_MS,
+                minimum: 0,
+                type: 'number',
+            },
+            platform: helpers_1.PLATFORM_ARG_SCHEMA,
+            ...helpers_1.NATIVE_ID_SCHEMA,
+        },
+        timeout: constants_1.INPUT_TIMEOUT_MS * 6,
+    };
+};
+exports.typeTextBatchTool = typeTextBatchTool;
+//# sourceMappingURL=typeTextBatch.js.map

package/dist/server/host/tools/input/typeTextBatch.js.map

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

package/dist/server/instructions.d.ts

@@ -0,0 +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";
+//# sourceMappingURL=instructions.d.ts.map

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

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

package/dist/server/instructions.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_INSTRUCTIONS = void 0;
+const protocol_1 = require("../shared/protocol");
+exports.BASE_INSTRUCTIONS = `You are connected to a running React Native app via the react-native-mcp-kit bridge.
+
+Multiple React Native apps can connect simultaneously — 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.
+
+## How to interact
+
+1. Use \`connection_status\` to check which clients are connected.
+2. Use \`list_tools\` to browse all available tool names and short descriptions. The response is compact — 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.
+3. 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.
+4. Use \`call\` to invoke any tool with format: module${protocol_1.MODULE_SEPARATOR}method (e.g. navigation${protocol_1.MODULE_SEPARATOR}navigate). When more than one client is connected, specify \`clientId\`. When exactly one client is connected, \`clientId\` is optional — it's auto-picked. \`args\` accepts either a plain object or a JSON string — prefer objects to avoid quote escaping.
+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.
+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.
+
+## Driving the UI — pick the right tool
+1. **\`host${protocol_1.MODULE_SEPARATOR}tap_fiber\` with \`steps: [...]\`** — 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.
+2. **\`fiber_tree${protocol_1.MODULE_SEPARATOR}query\` with \`select: ["mcpId","name","bounds"]\` + \`host${protocol_1.MODULE_SEPARATOR}tap\`** when you want to inspect a match set before committing — e.g. verify bounds, or skim candidates before picking one. \`props\` is opt-in on \`select\` to keep responses small.
+3. **\`fiber_tree${protocol_1.MODULE_SEPARATOR}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).
+4. **\`host${protocol_1.MODULE_SEPARATOR}screenshot\` + manual coordinate estimation + \`host${protocol_1.MODULE_SEPARATOR}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 — vision-token cheap.
+
+Gesture tools: \`host${protocol_1.MODULE_SEPARATOR}tap\` / \`host${protocol_1.MODULE_SEPARATOR}long_press\` / \`host${protocol_1.MODULE_SEPARATOR}swipe\` / \`host${protocol_1.MODULE_SEPARATOR}drag\` / \`host${protocol_1.MODULE_SEPARATOR}type_text\` / \`host${protocol_1.MODULE_SEPARATOR}type_text_batch\` / \`host${protocol_1.MODULE_SEPARATOR}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.
+
+Stack traces: \`errors${protocol_1.MODULE_SEPARATOR}get_errors\` and \`log_box${protocol_1.MODULE_SEPARATOR}get_logs\` return parsed \`stackFrames\` you can pass straight into \`metro${protocol_1.MODULE_SEPARATOR}symbolicate\` to resolve bundled frames back to source paths via Metro.
+
+## Consolidated tools — verb + arg, not verb-per-action
+
+Every 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:
+
+- **console** — \`get_logs({ level? })\` for all levels (no per-level shortcuts).
+- **errors** — \`get_errors({ fatal? })\` covers fatal-only too.
+- **network** — \`get_requests({ status?, method?, url? })\` covers errors / pending / URL filter.
+- **log_box** — \`clear({ level? })\` (warn / error / syntax / all); \`set_installed({ enabled })\` toggles install/uninstall.
+- **navigation** — \`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.
+- **query** (reactQuery) — \`mutate({ action: 'invalidate' | 'refetch' | 'remove' | 'reset', key? })\` covers all four cache mutations.
+- **device** — \`info({ select?: [...] })\` aggregates platform / dimensions / pixelRatio / appearance / appState / accessibility / keyboard / initialUrl / dev / identity / app / battery / memoryStorage. \`open_url({ dryRun? })\` covers the canOpenURL check too.
+- **fiber_tree** — \`query\` (all inspection: mcpId / name / testID / props / hooks / bounds / refMethods / children) and \`call({ prop? | method? })\` (callback prop OR native-ref method) — two tools cover everything fibers offer.
+
+## Path-based drill into heavy responses
+
+All 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\` — no separate by-id fetcher.
+
+  \`network__get_requests({ path: '[-1:][0].response.body' })\`         — last request's body
+  \`network__get_requests({ path: '[-1:][0].response.body', depth: 8 })\` — fully expanded
+  \`console__get_logs({ path: '[-3:][0].args[1]' })\`                    — second arg of the third-from-last log
+  \`storage__get_item({ key: 'session', path: 'value.user.email' })\`    — drill into a stored value
+  \`query__get_data({ key: '["users"]', path: 'data.email' })\`         — drill into cached data
+
+Path syntax (JS-style):
+  \`.key\` or \`["key.with.dots"]\` — object key access
+  \`[N]\` — index (numeric for arrays, Nth char for strings, Nth key in insertion order for objects)
+  \`[start:end]\` / \`[start:]\` / \`[:end]\` — 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.
+
+Path drilling to a string scalar applies \`previewCap\` as usual — 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>\`.
+
+\`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 — overflow is replaced with a single \`\${str}\` marker carrying the original byte count + a preview.
+
+For \`fiber_tree__query\`, heavy fields (\`props\`, \`hooks\`) take projection knobs per-field via \`select\` so the rest of the response stays raw:
+  \`select: [{ props: { path: "style", depth: 2 } }]\`   — drill into props.style 2 levels deep
+  \`select: [{ props: { path: "data[0:5]" } }]\`         — slice path: take first 5 items of props.data
+  \`select: [{ hooks: { kinds: ["State"], names: ["isLoading"], withValues: true, depth: 2 } }]\` — filter + project hook values
+  \`select: [{ children: 5 }]\`                          — 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\`.
+
+Hook 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 })\`.
+
+Marker 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).
+`;
+//# sourceMappingURL=instructions.js.map

package/dist/server/instructions.js.map

@@ -0,0 +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"}

package/dist/server/mcpServer.d.ts

@@ -1,20 +1,8 @@
 import { type Bridge } from './bridge';
 import { type HostModule } from './host/types';
 export declare class McpServerWrapper {
-    private readonly bridge;
-    private hostModules;
-    private hostToolMap;
     private mcp;
     constructor(bridge: Bridge, hostModules?: HostModule[]);
     start(): Promise<void>;
-    private registerTools;
-    /**
-     * Execute a single tool by full name, returning the raw handler result.
-     * Used by both the `call` tool and meta-tools like `wait_until` that need to
-     * invoke other tools without going through the full MCP content wrapping.
-     */
-    private dispatchTool;
-    private buildToolGroups;
-    private formatResult;
 }
 //# sourceMappingURL=mcpServer.d.ts.map