react-native-mcp-kit 2.1.0 → 2.2.1

package/dist/server/host/tools/tapFiber.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tapFiberTool = void 0;
+const protocol_1 = require("../../../shared/protocol");
+const TAP_FIBER_TIMEOUT_MS = 10_000;
+const tapFiberTool = () => {
+    return {
+        description: `The canonical way to simulate a user tap — locates a fiber via fiber_tree__query and taps its center through the real OS gesture pipeline, so Pressable feedback, gesture responders, and hit-test run as under a real finger. One call instead of query + host__tap.
+
+Requires exactly one resolved match after the chain. Pass \`index\` when the chain legitimately yields multiple and you want the Nth (0-based). When ambiguous without \`index\`, returns a candidate list with bounds so you can narrow \`steps\` or pick an index.
+
+Returns { tapped: true, mcpId?, name, testID?, bounds, device } on success.
+On ambiguity: { error: "N matches...", candidates: [...], total }.
+On no match: { error: "no match for given steps", total: 0 }.
+On unmounted: { error: "fiber has no measurable host view", mcpId?, name }.`,
+        handler: async (args, ctx) => {
+            const steps = args.steps;
+            if (!Array.isArray(steps) || steps.length === 0) {
+                return { error: 'tap_fiber requires a non-empty `steps` array.' };
+            }
+            const clientId = args.clientId ?? ctx.requestedClientId;
+            const index = args.index;
+            const queryResult = await ctx.dispatch(`fiber_tree${protocol_1.MODULE_SEPARATOR}query`, { limit: 10, select: ['bounds', 'mcpId', 'name', 'testID'], steps }, clientId);
+            if (!queryResult.ok) {
+                return { error: `fiber_tree__query failed: ${queryResult.error}` };
+            }
+            const result = queryResult.result;
+            const matches = result.matches ?? [];
+            if (matches.length === 0) {
+                return { error: 'no match for given steps', total: result.total ?? 0 };
+            }
+            if (matches.length > 1 && typeof index !== 'number') {
+                return {
+                    candidates: matches.map((m) => {
+                        return {
+                            bounds: m.bounds ?? null,
+                            mcpId: m.mcpId,
+                            name: m.name,
+                            testID: m.testID,
+                        };
+                    }),
+                    error: `${matches.length} matches — pass \`index\` or narrow \`steps\`.`,
+                    total: result.total ?? matches.length,
+                };
+            }
+            const pick = matches[typeof index === 'number' ? index : 0];
+            if (!pick) {
+                return { error: `index ${index} out of range (have ${matches.length}).` };
+            }
+            if (!pick.bounds) {
+                return {
+                    error: 'fiber has no measurable host view — likely unmounted / virtualized.',
+                    mcpId: pick.mcpId,
+                    name: pick.name,
+                };
+            }
+            const tapResult = await ctx.dispatch(`host${protocol_1.MODULE_SEPARATOR}tap`, { x: pick.bounds.centerX, y: pick.bounds.centerY }, clientId);
+            if (!tapResult.ok) {
+                return { error: `host__tap failed: ${tapResult.error}` };
+            }
+            return {
+                bounds: pick.bounds,
+                device: tapResult.result.device,
+                mcpId: pick.mcpId,
+                name: pick.name,
+                tapped: true,
+                testID: pick.testID,
+            };
+        },
+        inputSchema: {
+            clientId: {
+                description: 'Target client ID (optional when one client is connected).',
+                type: 'string',
+            },
+            index: {
+                description: 'Pick the Nth match when the chain returns multiple (0-based).',
+                type: 'number',
+            },
+            steps: {
+                description: 'Same shape as fiber_tree__query steps — ordered criteria + optional scope.',
+                examples: [[{ testID: 'searchBar' }], [{ name: 'HomeScreen' }, { testID: 'addToCartBtn' }]],
+                type: 'array',
+            },
+        },
+        timeout: TAP_FIBER_TIMEOUT_MS,
+    };
+};
+exports.tapFiberTool = tapFiberTool;
+//# sourceMappingURL=tapFiber.js.map

package/dist/server/host/tools/tapFiber.js.map

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

package/dist/server/host/types.d.ts

@@ -1,6 +1,20 @@
 import { type Bridge } from '../../server/bridge';
+/**
+ * Dispatch another tool (host or client module) by full name. Host tools like
+ * tap_fiber use it to chain fiber_tree__query + host__tap without the agent
+ * needing a round-trip. Returns raw handler result on success or a reason on
+ * failure — the caller decides how to surface it.
+ */
+export type HostDispatch = (tool: string, args: Record<string, unknown>, clientId?: string) => Promise<{
+    ok: true;
+    result: unknown;
+} | {
+    error: string;
+    ok: false;
+}>;
 export interface HostContext {
     bridge: Bridge;
+    dispatch: HostDispatch;
     requestedClientId?: string;
 }
 export interface HostToolHandler {

package/dist/server/host/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/host/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/host/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,CAAC,EAAE,MAAM,KACd,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAE3E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/server/mcpServer.d.ts

@@ -8,6 +8,12 @@ export declare class McpServerWrapper {
     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;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../../src/server/mcpServer.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,KAAK,UAAU,EAAwB,MAAM,cAAc,CAAC;AAgIrE,qBAAa,gBAAgB;IAMzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,GAAG,CAAY;gBAGJ,MAAM,EAAE,MAAM,EAC/B,WAAW,GAAE,UAAU,EAAO;IAuB1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,OAAO,CAAC,aAAa;IA4gBrB,OAAO,CAAC,eAAe;IAyCvB,OAAO,CAAC,YAAY;CAerB"}
+{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../../src/server/mcpServer.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,KAAK,UAAU,EAAwB,MAAM,cAAc,CAAC;AAgSrE,qBAAa,gBAAgB;IAMzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,GAAG,CAAY;gBAGJ,MAAM,EAAE,MAAM,EAC/B,WAAW,GAAE,UAAU,EAAO;IAuB1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,OAAO,CAAC,aAAa;IA8oBrB;;;;OAIG;YACW,YAAY;IAkG1B,OAAO,CAAC,eAAe;IAyCvB,OAAO,CAAC,YAAY;CAiBrB"}