react-native-mcp-kit 1.0.1 → 2.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"hostModule.d.ts","sourceRoot":"","sources":["../../../src/server/host/hostModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,eAAO,MAAM,UAAU,WAAY,aAAa,KAAG,UAiBlD,CAAC"}

package/dist/server/host/hostModule.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hostModule = void 0;
+const capture_1 = require("./tools/capture");
+const devices_1 = require("./tools/devices");
+const input_1 = require("./tools/input");
+const lifecycle_1 = require("./tools/lifecycle");
+const hostModule = (runner) => {
+    return {
+        description: 'OS-level operations that run on the MCP server host via xcrun simctl / adb. Works when the React Native app is hung, disconnected, or not installed.',
+        name: 'host',
+        tools: {
+            launch_app: (0, lifecycle_1.launchAppTool)(runner),
+            list_devices: (0, devices_1.listDevicesTool)(runner),
+            press_key: (0, input_1.pressKeyTool)(runner),
+            restart_app: (0, lifecycle_1.restartAppTool)(runner),
+            screenshot: (0, capture_1.screenshotTool)(runner),
+            swipe: (0, input_1.swipeTool)(runner),
+            tap: (0, input_1.tapTool)(runner),
+            terminate_app: (0, lifecycle_1.terminateAppTool)(runner),
+            type_text: (0, input_1.typeTextTool)(runner),
+        },
+    };
+};
+exports.hostModule = hostModule;
+//# sourceMappingURL=hostModule.js.map

package/dist/server/host/hostModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostModule.js","sourceRoot":"","sources":["../../../src/server/host/hostModule.ts"],"names":[],"mappings":";;;AACA,6CAAiD;AACjD,6CAAkD;AAClD,yCAA+E;AAC/E,iDAAoF;AAG7E,MAAM,UAAU,GAAG,CAAC,MAAqB,EAAc,EAAE;IAC9D,OAAO;QACL,WAAW,EACT,sJAAsJ;QACxJ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE;YACL,UAAU,EAAE,IAAA,yBAAa,EAAC,MAAM,CAAC;YACjC,YAAY,EAAE,IAAA,yBAAe,EAAC,MAAM,CAAC;YACrC,SAAS,EAAE,IAAA,oBAAY,EAAC,MAAM,CAAC;YAC/B,WAAW,EAAE,IAAA,0BAAc,EAAC,MAAM,CAAC;YACnC,UAAU,EAAE,IAAA,wBAAc,EAAC,MAAM,CAAC;YAClC,KAAK,EAAE,IAAA,iBAAS,EAAC,MAAM,CAAC;YACxB,GAAG,EAAE,IAAA,eAAO,EAAC,MAAM,CAAC;YACpB,aAAa,EAAE,IAAA,4BAAgB,EAAC,MAAM,CAAC;YACvC,SAAS,EAAE,IAAA,oBAAY,EAAC,MAAM,CAAC;SAChC;KACF,CAAC;AACJ,CAAC,CAAC;AAjBW,QAAA,UAAU,cAiBrB"}

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

@@ -0,0 +1,4 @@
+export { hostModule } from './hostModule';
+export { runProcess, type ProcessRunner } from './processRunner';
+export { type HostContext, type HostModule, type HostToolHandler } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/server/host/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runProcess = exports.hostModule = void 0;
+var hostModule_1 = require("./hostModule");
+Object.defineProperty(exports, "hostModule", { enumerable: true, get: function () { return hostModule_1.hostModule; } });
+var processRunner_1 = require("./processRunner");
+Object.defineProperty(exports, "runProcess", { enumerable: true, get: function () { return processRunner_1.runProcess; } });
+//# sourceMappingURL=index.js.map

package/dist/server/host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/host/index.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,iDAAiE;AAAxD,2GAAA,UAAU,OAAA"}

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

@@ -0,0 +1,15 @@
+import { type AppTargetError } from './helpers';
+import { type ProcessRunner } from './processRunner';
+export declare const tapIos: (udid: string, xPixels: number, yPixels: number, runner: ProcessRunner) => Promise<{
+    ok: true;
+} | AppTargetError>;
+export declare const swipeIos: (udid: string, x1Pixels: number, y1Pixels: number, x2Pixels: number, y2Pixels: number, durationMs: number, runner: ProcessRunner) => Promise<{
+    ok: true;
+} | AppTargetError>;
+export declare const typeTextIos: (udid: string, text: string, submit: boolean, runner: ProcessRunner) => Promise<{
+    ok: true;
+} | AppTargetError>;
+export declare const pressKeyIos: (udid: string, key: string, runner: ProcessRunner) => Promise<{
+    ok: true;
+} | AppTargetError>;
+//# sourceMappingURL=iosInput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iosInput.d.ts","sourceRoot":"","sources":["../../../src/server/host/iosInput.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAqC3E,eAAO,MAAM,MAAM,SACX,MAAM,WACH,MAAM,WACN,MAAM,UACP,aAAa,KACpB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,cAAc,CAEvC,CAAC;AAEF,eAAO,MAAM,QAAQ,SACb,MAAM,YACF,MAAM,YACN,MAAM,YACN,MAAM,YACN,MAAM,cACJ,MAAM,UACV,aAAa,KACpB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,cAAc,CAcvC,CAAC;AAEF,eAAO,MAAM,WAAW,SAChB,MAAM,QACN,MAAM,UACJ,OAAO,UACP,aAAa,KACpB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,cAAc,CAKvC,CAAC;AAiBF,eAAO,MAAM,WAAW,SAChB,MAAM,OACP,MAAM,UACH,aAAa,KACpB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,cAAc,CAkBvC,CAAC"}

package/dist/server/host/iosInput.js

@@ -0,0 +1,93 @@
+"use strict";
+// iOS input injection via the bundled ios-hid Swift binary.
+// ios-hid uses Apple private frameworks (SimulatorKit, CoreSimulator) to inject
+// HID events directly into iOS Simulator — no WDA, no idb, no external deps.
+// Coordinates are PHYSICAL PIXELS end-to-end, matching Android adb semantics
+// and fiber_tree bounds — ios-hid passes them straight to the HID layer with
+// screenSize loaded from SimDevice.deviceType.mainScreenSize (also pixels on
+// Xcode 15+).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pressKeyIos = exports.typeTextIos = exports.swipeIos = exports.tapIos = void 0;
+const node_path_1 = require("node:path");
+const processRunner_1 = require("./processRunner");
+const IOS_INPUT_TIMEOUT_MS = 5_000;
+const getIosHidPath = () => {
+    return (0, node_path_1.join)(__dirname, '..', '..', 'bin', 'ios-hid');
+};
+const runIosHid = async (runner, args, action) => {
+    const bin = getIosHidPath();
+    try {
+        const proc = await runner(bin, args, { timeoutMs: IOS_INPUT_TIMEOUT_MS });
+        if (proc.timedOut) {
+            return { error: `iOS ${action} timed out after ${IOS_INPUT_TIMEOUT_MS}ms` };
+        }
+        if (proc.exitCode !== 0) {
+            const stderr = proc.stderr.toString('utf8').trim();
+            return {
+                error: `iOS ${action} failed: ${stderr.slice(0, 500) || `exit code ${proc.exitCode}`}`,
+            };
+        }
+        return { ok: true };
+    }
+    catch (err) {
+        if (err instanceof processRunner_1.ProcessNotFoundError) {
+            return {
+                error: 'ios-hid binary not found. This usually means the package was installed on a non-macOS platform. iOS input injection requires macOS with Xcode.',
+            };
+        }
+        return { error: `iOS ${action} failed: ${err.message}` };
+    }
+};
+const tapIos = async (udid, xPixels, yPixels, runner) => {
+    return runIosHid(runner, ['tap', udid, String(xPixels), String(yPixels)], 'tap');
+};
+exports.tapIos = tapIos;
+const swipeIos = async (udid, x1Pixels, y1Pixels, x2Pixels, y2Pixels, durationMs, runner) => {
+    return runIosHid(runner, [
+        'swipe',
+        udid,
+        String(x1Pixels),
+        String(y1Pixels),
+        String(x2Pixels),
+        String(y2Pixels),
+        String(durationMs / 1000),
+    ], 'swipe');
+};
+exports.swipeIos = swipeIos;
+const typeTextIos = async (udid, text, submit, runner) => {
+    // ios-hid handles clipboard paste internally (simctl pbcopy + Cmd+V)
+    // to avoid keyboard layout issues (HID keycodes are physical keys).
+    const fullText = submit ? text + '\n' : text;
+    return runIosHid(runner, ['type', udid, fullText], 'type');
+};
+exports.typeTextIos = typeTextIos;
+// Keys that don't exist on iOS Simulator
+const IOS_UNSUPPORTED_KEYS = new Set(['back', 'menu', 'power', 'volume_down', 'volume_up']);
+const IOS_BUTTON_MAP = {
+    home: 'home',
+};
+const IOS_KEY_TEXT = {
+    backspace: '\u007F',
+    enter: '\n',
+    escape: '\u001B',
+    space: ' ',
+    tab: '\t',
+};
+const pressKeyIos = async (udid, key, runner) => {
+    if (IOS_UNSUPPORTED_KEYS.has(key)) {
+        return {
+            error: `Key '${key}' is not available on iOS Simulator. Supported: enter, tab, space, backspace, escape, home.`,
+        };
+    }
+    const button = IOS_BUTTON_MAP[key];
+    if (button) {
+        return runIosHid(runner, ['button', udid, button], 'button');
+    }
+    const keyText = IOS_KEY_TEXT[key];
+    if (keyText) {
+        return runIosHid(runner, ['type', udid, keyText], 'key');
+    }
+    return { error: `Unknown key '${key}' for iOS.` };
+};
+exports.pressKeyIos = pressKeyIos;
+//# sourceMappingURL=iosInput.js.map

package/dist/server/host/iosInput.js.map

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

package/dist/server/host/modules/screenshot.d.ts

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

package/dist/server/host/modules/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../../src/server/host/modules/screenshot.ts"],"names":[],"mappings":"AAUA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAmbxE,eAAO,MAAM,UAAU,WAAY,aAAa,KAAG,UAuTlD,CAAC"}