@metamask/device-mcp 0.1.0

package/dist/backends/idb-backend.mjs

@@ -0,0 +1,436 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _IdbBackend_connected, _IdbBackend_udid, _IdbBackend_recordingProcess, _IdbBackend_recordingPath;
+import { execFile as execFileCb, spawn } from "node:child_process";
+import { ACCEPT_LABELS, DENY_LABELS } from "../utils/alert-labels.mjs";
+import { findElement, describeElement, computeSwipeEnd } from "../utils/element.mjs";
+import { execStrict, exec, isCommandAvailable } from "../utils/exec.mjs";
+export class IdbBackend {
+    constructor(udid) {
+        this.platform = 'ios';
+        _IdbBackend_connected.set(this, false);
+        _IdbBackend_udid.set(this, void 0);
+        _IdbBackend_recordingProcess.set(this, null);
+        _IdbBackend_recordingPath.set(this, null);
+        __classPrivateFieldSet(this, _IdbBackend_udid, udid, "f");
+    }
+    async ensureConnected() {
+        if (__classPrivateFieldGet(this, _IdbBackend_connected, "f")) {
+            return;
+        }
+        if (!(await isCommandAvailable('idb'))) {
+            throw new Error('idb is not installed.\n' +
+                'Install: brew tap facebook/fb && brew install idb-companion && pip3 install fb-idb');
+        }
+        await exec('idb', ['connect', __classPrivateFieldGet(this, _IdbBackend_udid, "f")]);
+        __classPrivateFieldSet(this, _IdbBackend_connected, true, "f");
+    }
+    async getDeviceInfo() {
+        await this.ensureConnected();
+        const raw = await execStrict('idb', [
+            'describe',
+            '--udid',
+            __classPrivateFieldGet(this, _IdbBackend_udid, "f"),
+            '--json',
+        ]);
+        let info;
+        try {
+            info = JSON.parse(raw);
+        }
+        catch {
+            throw new Error(`idb describe returned invalid JSON for device ${__classPrivateFieldGet(this, _IdbBackend_udid, "f")}: ${raw.slice(0, 200)}`);
+        }
+        return {
+            platform: 'ios',
+            deviceId: __classPrivateFieldGet(this, _IdbBackend_udid, "f"),
+            name: info.name ?? 'Unknown',
+            osVersion: info.os_version ?? 'Unknown',
+            state: info.state ?? 'Unknown',
+        };
+    }
+    async snapshot() {
+        await this.ensureConnected();
+        const raw = await execStrict('idb', [
+            'ui',
+            'describe-all',
+            '--udid',
+            __classPrivateFieldGet(this, _IdbBackend_udid, "f"),
+        ]);
+        const hierarchy = parseIdbHierarchy(raw);
+        return {
+            platform: 'ios',
+            hierarchy,
+            raw,
+            timestamp: Date.now(),
+        };
+    }
+    async tapElement(query) {
+        await this.ensureConnected();
+        const snapshot = await this.snapshot();
+        const element = findElement(snapshot.hierarchy, query);
+        if (!element) {
+            throw new Error(`Element not found: ${JSON.stringify(query)}\n` +
+                'Use device_snapshot to inspect the current UI hierarchy.');
+        }
+        const x = Math.round(element.frame.x + element.frame.width / 2);
+        const y = Math.round(element.frame.y + element.frame.height / 2);
+        await this.tapCoordinates(x, y);
+        return {
+            success: true,
+            x,
+            y,
+            targetDescription: describeElement(element),
+        };
+    }
+    async tapCoordinates(x, y) {
+        await this.ensureConnected();
+        await execStrict('idb', [
+            'ui',
+            'tap',
+            String(x),
+            String(y),
+            '--udid',
+            __classPrivateFieldGet(this, _IdbBackend_udid, "f"),
+        ]);
+    }
+    async typeText(text) {
+        await this.ensureConnected();
+        await exec('idb', [
+            'ui',
+            'key-sequence',
+            '--',
+            'cmd+a',
+            '--udid',
+            __classPrivateFieldGet(this, _IdbBackend_udid, "f"),
+        ]);
+        await exec('idb', ['ui', 'key', 'DELETE', '--udid', __classPrivateFieldGet(this, _IdbBackend_udid, "f")]);
+        await execStrict('idb', ['ui', 'text', text, '--udid', __classPrivateFieldGet(this, _IdbBackend_udid, "f")]);
+    }
+    async swipe(direction, startX, startY, distance) {
+        await this.ensureConnected();
+        const d = distance ?? 500;
+        const sx = startX ?? 200;
+        const sy = startY ?? 400;
+        const [endX, endY] = computeSwipeEnd(sx, sy, direction, d);
+        await execStrict('idb', [
+            'ui',
+            'swipe',
+            String(sx),
+            String(sy),
+            String(endX),
+            String(endY),
+            '--udid',
+            __classPrivateFieldGet(this, _IdbBackend_udid, "f"),
+        ]);
+    }
+    async waitForElement(query, timeoutMs = 10000, intervalMs = 500) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const snapshot = await this.snapshot();
+            const element = findElement(snapshot.hierarchy, query);
+            if (element) {
+                return element;
+            }
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        }
+        throw new Error(`Timed out waiting for element: ${JSON.stringify(query)} (${timeoutMs}ms)`);
+    }
+    async getAppState(bundleId) {
+        await this.ensureConnected();
+        const raw = await execStrict('idb', ['list-apps', '--udid', __classPrivateFieldGet(this, _IdbBackend_udid, "f")]);
+        for (const line of raw.trim().split('\n')) {
+            if (line.includes(bundleId)) {
+                const parts = line.split('|').map((s) => s.trim());
+                return {
+                    bundleId,
+                    state: parts[2] ?? 'Unknown',
+                    pid: parts[3] ? parseInt(parts[3], 10) : undefined,
+                };
+            }
+        }
+        return { bundleId, state: 'Not Installed' };
+    }
+    async screenshot(outputPath) {
+        await this.ensureConnected();
+        const path = outputPath ?? `/tmp/device-mcp-screenshot-${Date.now()}.png`;
+        await execStrict('idb', ['screenshot', path, '--udid', __classPrivateFieldGet(this, _IdbBackend_udid, "f")]);
+        const data = await execStrict('base64', [path]);
+        return { data: data.trim(), format: 'png', path };
+    }
+    async openApp(bundleId) {
+        await this.ensureConnected();
+        await execStrict('idb', ['launch', bundleId, '--udid', __classPrivateFieldGet(this, _IdbBackend_udid, "f")]);
+    }
+    async closeApp(bundleId) {
+        await this.ensureConnected();
+        await execStrict('idb', ['terminate', bundleId, '--udid', __classPrivateFieldGet(this, _IdbBackend_udid, "f")]);
+    }
+    async pressButton(button) {
+        await this.ensureConnected();
+        const keyMap = {
+            home: 'HOME',
+            lock: 'LOCK',
+            back: 'HOME',
+            enter: 'RETURN',
+        };
+        await execStrict('idb', [
+            'ui',
+            'key',
+            keyMap[button],
+            '--udid',
+            __classPrivateFieldGet(this, _IdbBackend_udid, "f"),
+        ]);
+    }
+    async dismissKeyboard() {
+        await this.ensureConnected();
+        await execStrict('idb', ['ui', 'key', 'RETURN', '--udid', __classPrivateFieldGet(this, _IdbBackend_udid, "f")]);
+    }
+    async dismissAlert(accept) {
+        await this.ensureConnected();
+        const snap = await this.snapshot();
+        const candidates = accept ? ACCEPT_LABELS : DENY_LABELS;
+        for (const label of candidates) {
+            const element = findElement(snap.hierarchy, { label });
+            if (element) {
+                const cx = Math.round(element.frame.x + element.frame.width / 2);
+                const cy = Math.round(element.frame.y + element.frame.height / 2);
+                await this.tapCoordinates(cx, cy);
+                return;
+            }
+        }
+        throw new Error(`No alert button found. Tried: ${candidates.join(', ')}`);
+    }
+    async getLogs(durationSeconds = 30, filter) {
+        await this.ensureConnected();
+        const args = [
+            'log',
+            '--udid',
+            __classPrivateFieldGet(this, _IdbBackend_udid, "f"),
+            '--',
+            '--last',
+            `${durationSeconds}s`,
+        ];
+        if (filter) {
+            args.push('--predicate', `eventMessage CONTAINS "${filter}"`);
+        }
+        const raw = await execStrict('idb', args);
+        const entries = raw
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => ({
+            timestamp: line.substring(0, 31).trim(),
+            level: 'info',
+            message: line.substring(31).trim(),
+        }));
+        return { entries, source: 'idb log' };
+    }
+    async longPress(query, durationMs = 1000) {
+        await this.ensureConnected();
+        const snap = await this.snapshot();
+        const element = findElement(snap.hierarchy, query);
+        if (!element) {
+            throw new Error(`Element not found: ${JSON.stringify(query)}\n` +
+                'Use device_snapshot to inspect the current UI hierarchy.');
+        }
+        const cx = Math.round(element.frame.x + element.frame.width / 2);
+        const cy = Math.round(element.frame.y + element.frame.height / 2);
+        await execStrict('idb', [
+            'ui',
+            'tap',
+            String(cx),
+            String(cy),
+            '--duration',
+            String(durationMs / 1000),
+            '--udid',
+            __classPrivateFieldGet(this, _IdbBackend_udid, "f"),
+        ]);
+        return {
+            success: true,
+            x: cx,
+            y: cy,
+            targetDescription: describeElement(element),
+        };
+    }
+    async scrollToElement(query, direction = 'down', maxAttempts = 10) {
+        await this.ensureConnected();
+        let previousRaw = '';
+        for (let i = 0; i < maxAttempts; i++) {
+            const snap = await this.snapshot();
+            const element = findElement(snap.hierarchy, query);
+            if (element) {
+                return element;
+            }
+            if (snap.raw === previousRaw) {
+                break;
+            }
+            previousRaw = snap.raw;
+            await this.swipe(direction);
+        }
+        throw new Error(`Element not found after scrolling: ${JSON.stringify(query)}\n` +
+            'Use device_snapshot to inspect the current UI hierarchy.');
+    }
+    async getAlertText() {
+        await this.ensureConnected();
+        const snap = await this.snapshot();
+        const texts = collectAlertTexts(snap.hierarchy);
+        if (texts.length === 0) {
+            throw new Error('No alert is currently displayed.\n' +
+                'Use device_snapshot to inspect the current UI hierarchy.');
+        }
+        return texts.join('\n');
+    }
+    async getWindowSize() {
+        await this.ensureConnected();
+        const raw = await execStrict('idb', [
+            'describe',
+            '--udid',
+            __classPrivateFieldGet(this, _IdbBackend_udid, "f"),
+            '--json',
+        ]);
+        try {
+            const info = JSON.parse(raw);
+            const dims = info.screen_dimensions;
+            if (dims?.width && dims?.height) {
+                return { width: dims.width, height: dims.height };
+            }
+        }
+        catch {
+            // fall through to snapshot-based approach
+        }
+        const snap = await this.snapshot();
+        if (snap.hierarchy.length > 0) {
+            const root = snap.hierarchy[0];
+            if (root.frame.width > 0 && root.frame.height > 0) {
+                return { width: root.frame.width, height: root.frame.height };
+            }
+        }
+        throw new Error('Unable to determine window size from device');
+    }
+    async getContexts() {
+        return ['NATIVE_APP'];
+    }
+    async setContext(context) {
+        if (context === 'NATIVE_APP') {
+            return;
+        }
+        throw new Error('Context switching requires Appium backend. IDB only supports NATIVE_APP.');
+    }
+    async getClipboard() {
+        await this.ensureConnected();
+        return execStrict('xcrun', ['simctl', 'pbpaste', __classPrivateFieldGet(this, _IdbBackend_udid, "f")]);
+    }
+    async setClipboard(text) {
+        await this.ensureConnected();
+        await new Promise((resolve, reject) => {
+            const proc = execFileCb('xcrun', ['simctl', 'pbcopy', __classPrivateFieldGet(this, _IdbBackend_udid, "f")], { timeout: 30000 }, (error) => (error ? reject(new Error(error.message)) : resolve()));
+            proc.stdin?.end(text);
+        });
+    }
+    async startScreenRecording(outputPath) {
+        await this.ensureConnected();
+        if (__classPrivateFieldGet(this, _IdbBackend_recordingProcess, "f")) {
+            throw new Error('Screen recording is already in progress');
+        }
+        const path = outputPath ?? `/tmp/device-mcp-recording-${Date.now()}.mp4`;
+        __classPrivateFieldSet(this, _IdbBackend_recordingPath, path, "f");
+        __classPrivateFieldSet(this, _IdbBackend_recordingProcess, spawn('idb', [
+            'record-video',
+            path,
+            '--udid',
+            __classPrivateFieldGet(this, _IdbBackend_udid, "f"),
+        ]), "f");
+        __classPrivateFieldGet(this, _IdbBackend_recordingProcess, "f").on('error', () => {
+            __classPrivateFieldSet(this, _IdbBackend_recordingProcess, null, "f");
+            __classPrivateFieldSet(this, _IdbBackend_recordingPath, null, "f");
+        });
+    }
+    async stopScreenRecording() {
+        if (!__classPrivateFieldGet(this, _IdbBackend_recordingProcess, "f") || !__classPrivateFieldGet(this, _IdbBackend_recordingPath, "f")) {
+            throw new Error('No screen recording in progress');
+        }
+        const path = __classPrivateFieldGet(this, _IdbBackend_recordingPath, "f");
+        __classPrivateFieldGet(this, _IdbBackend_recordingProcess, "f").kill('SIGINT');
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        __classPrivateFieldSet(this, _IdbBackend_recordingProcess, null, "f");
+        __classPrivateFieldSet(this, _IdbBackend_recordingPath, null, "f");
+        return path;
+    }
+}
+_IdbBackend_connected = new WeakMap(), _IdbBackend_udid = new WeakMap(), _IdbBackend_recordingProcess = new WeakMap(), _IdbBackend_recordingPath = new WeakMap();
+function collectAlertTexts(elements) {
+    const texts = [];
+    for (const el of elements) {
+        const isAlertContainer = el.type === 'Alert' || el.type === 'Sheet' || el.type.includes('Alert');
+        if (isAlertContainer) {
+            collectTextsFromChildren(el.children ?? [], texts);
+            return texts;
+        }
+        if (el.children) {
+            const found = collectAlertTexts(el.children);
+            if (found.length > 0) {
+                return found;
+            }
+        }
+    }
+    return texts;
+}
+function collectTextsFromChildren(elements, texts) {
+    for (const el of elements) {
+        if (el.type === 'StaticText' || el.type === 'TextView') {
+            const text = el.value ?? el.label;
+            if (text) {
+                texts.push(text);
+            }
+        }
+        if (el.children) {
+            collectTextsFromChildren(el.children, texts);
+        }
+    }
+}
+export function parseIdbHierarchy(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) {
+            return parsed.map(mapIdbElement);
+        }
+        if (parsed.children) {
+            return parsed.children.map(mapIdbElement);
+        }
+        return [mapIdbElement(parsed)];
+    }
+    catch {
+        return [
+            {
+                type: 'raw',
+                label: raw.slice(0, 200),
+                frame: { x: 0, y: 0, width: 0, height: 0 },
+                enabled: true,
+            },
+        ];
+    }
+}
+export function mapIdbElement(node) {
+    const frame = node.frame;
+    return {
+        type: node.type ?? node.AXType ?? 'Unknown',
+        label: node.AXLabel ?? node.label ?? undefined,
+        value: node.AXValue ?? node.value ?? undefined,
+        identifier: node.AXUniqueId ?? node.identifier ?? undefined,
+        frame: frame ?? { x: 0, y: 0, width: 0, height: 0 },
+        enabled: node.enabled ?? true,
+        children: Array.isArray(node.children)
+            ? node.children.map(mapIdbElement)
+            : undefined,
+    };
+}
+//# sourceMappingURL=idb-backend.mjs.map

package/dist/backends/idb-backend.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb-backend.mjs","sourceRoot":"","sources":["../../src/backends/idb-backend.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile as execFileCb, spawn } from 'node:child_process';\nimport type { ChildProcess } from 'node:child_process';\n\nimport type {\n  DeviceBackend,\n  DeviceButton,\n  DeviceInfo,\n  SnapshotResult,\n  ScreenshotResult,\n  LogsResult,\n  TapResult,\n  AppStateResult,\n  ElementQuery,\n  UIElement,\n  WindowSize,\n} from './types.js';\nimport { ACCEPT_LABELS, DENY_LABELS } from '../utils/alert-labels.js';\nimport {\n  findElement,\n  describeElement,\n  computeSwipeEnd,\n} from '../utils/element.js';\nimport { execStrict, exec, isCommandAvailable } from '../utils/exec.js';\n\nexport class IdbBackend implements DeviceBackend {\n  readonly platform = 'ios' as const;\n\n  #connected = false;\n\n  readonly #udid: string;\n\n  #recordingProcess: ChildProcess | null = null;\n\n  #recordingPath: string | null = null;\n\n  constructor(udid: string) {\n    this.#udid = udid;\n  }\n\n  async ensureConnected(): Promise<void> {\n    if (this.#connected) {\n      return;\n    }\n\n    if (!(await isCommandAvailable('idb'))) {\n      throw new Error(\n        'idb is not installed.\\n' +\n          'Install: brew tap facebook/fb && brew install idb-companion && pip3 install fb-idb',\n      );\n    }\n\n    await exec('idb', ['connect', this.#udid]);\n    this.#connected = true;\n  }\n\n  async getDeviceInfo(): Promise<DeviceInfo> {\n    await this.ensureConnected();\n    const raw = await execStrict('idb', [\n      'describe',\n      '--udid',\n      this.#udid,\n      '--json',\n    ]);\n    let info: Record<string, unknown>;\n    try {\n      info = JSON.parse(raw) as Record<string, unknown>;\n    } catch {\n      throw new Error(\n        `idb describe returned invalid JSON for device ${this.#udid}: ${raw.slice(0, 200)}`,\n      );\n    }\n    return {\n      platform: 'ios',\n      deviceId: this.#udid,\n      name: (info.name as string) ?? 'Unknown',\n      osVersion: (info.os_version as string) ?? 'Unknown',\n      state: (info.state as string) ?? 'Unknown',\n    };\n  }\n\n  async snapshot(): Promise<SnapshotResult> {\n    await this.ensureConnected();\n    const raw = await execStrict('idb', [\n      'ui',\n      'describe-all',\n      '--udid',\n      this.#udid,\n    ]);\n    const hierarchy = parseIdbHierarchy(raw);\n    return {\n      platform: 'ios',\n      hierarchy,\n      raw,\n      timestamp: Date.now(),\n    };\n  }\n\n  async tapElement(query: ElementQuery): Promise<TapResult> {\n    await this.ensureConnected();\n    const snapshot = await this.snapshot();\n    const element = findElement(snapshot.hierarchy, query);\n    if (!element) {\n      throw new Error(\n        `Element not found: ${JSON.stringify(query)}\\n` +\n          'Use device_snapshot to inspect the current UI hierarchy.',\n      );\n    }\n\n    const x = Math.round(element.frame.x + element.frame.width / 2);\n    const y = Math.round(element.frame.y + element.frame.height / 2);\n    await this.tapCoordinates(x, y);\n\n    return {\n      success: true,\n      x,\n      y,\n      targetDescription: describeElement(element),\n    };\n  }\n\n  async tapCoordinates(x: number, y: number): Promise<void> {\n    await this.ensureConnected();\n    await execStrict('idb', [\n      'ui',\n      'tap',\n      String(x),\n      String(y),\n      '--udid',\n      this.#udid,\n    ]);\n  }\n\n  async typeText(text: string): Promise<void> {\n    await this.ensureConnected();\n    await exec('idb', [\n      'ui',\n      'key-sequence',\n      '--',\n      'cmd+a',\n      '--udid',\n      this.#udid,\n    ]);\n    await exec('idb', ['ui', 'key', 'DELETE', '--udid', this.#udid]);\n    await execStrict('idb', ['ui', 'text', text, '--udid', this.#udid]);\n  }\n\n  async swipe(\n    direction: 'up' | 'down' | 'left' | 'right',\n    startX?: number,\n    startY?: number,\n    distance?: number,\n  ): Promise<void> {\n    await this.ensureConnected();\n    const d = distance ?? 500;\n    const sx = startX ?? 200;\n    const sy = startY ?? 400;\n    const [endX, endY] = computeSwipeEnd(sx, sy, direction, d);\n\n    await execStrict('idb', [\n      'ui',\n      'swipe',\n      String(sx),\n      String(sy),\n      String(endX),\n      String(endY),\n      '--udid',\n      this.#udid,\n    ]);\n  }\n\n  async waitForElement(\n    query: ElementQuery,\n    timeoutMs = 10_000,\n    intervalMs = 500,\n  ): Promise<UIElement> {\n    const start = Date.now();\n    while (Date.now() - start < timeoutMs) {\n      const snapshot = await this.snapshot();\n      const element = findElement(snapshot.hierarchy, query);\n      if (element) {\n        return element;\n      }\n      await new Promise((resolve) => setTimeout(resolve, intervalMs));\n    }\n    throw new Error(\n      `Timed out waiting for element: ${JSON.stringify(query)} (${timeoutMs}ms)`,\n    );\n  }\n\n  async getAppState(bundleId: string): Promise<AppStateResult> {\n    await this.ensureConnected();\n    const raw = await execStrict('idb', ['list-apps', '--udid', this.#udid]);\n\n    for (const line of raw.trim().split('\\n')) {\n      if (line.includes(bundleId)) {\n        const parts = line.split('|').map((s) => s.trim());\n        return {\n          bundleId,\n          state: parts[2] ?? 'Unknown',\n          pid: parts[3] ? parseInt(parts[3], 10) : undefined,\n        };\n      }\n    }\n\n    return { bundleId, state: 'Not Installed' };\n  }\n\n  async screenshot(outputPath?: string): Promise<ScreenshotResult> {\n    await this.ensureConnected();\n    const path = outputPath ?? `/tmp/device-mcp-screenshot-${Date.now()}.png`;\n    await execStrict('idb', ['screenshot', path, '--udid', this.#udid]);\n    const data = await execStrict('base64', [path]);\n    return { data: data.trim(), format: 'png', path };\n  }\n\n  async openApp(bundleId: string): Promise<void> {\n    await this.ensureConnected();\n    await execStrict('idb', ['launch', bundleId, '--udid', this.#udid]);\n  }\n\n  async closeApp(bundleId: string): Promise<void> {\n    await this.ensureConnected();\n    await execStrict('idb', ['terminate', bundleId, '--udid', this.#udid]);\n  }\n\n  async pressButton(button: DeviceButton): Promise<void> {\n    await this.ensureConnected();\n    const keyMap: Record<DeviceButton, string> = {\n      home: 'HOME',\n      lock: 'LOCK',\n      back: 'HOME',\n      enter: 'RETURN',\n    };\n    await execStrict('idb', [\n      'ui',\n      'key',\n      keyMap[button],\n      '--udid',\n      this.#udid,\n    ]);\n  }\n\n  async dismissKeyboard(): Promise<void> {\n    await this.ensureConnected();\n    await execStrict('idb', ['ui', 'key', 'RETURN', '--udid', this.#udid]);\n  }\n\n  async dismissAlert(accept: boolean): Promise<void> {\n    await this.ensureConnected();\n    const snap = await this.snapshot();\n    const candidates = accept ? ACCEPT_LABELS : DENY_LABELS;\n\n    for (const label of candidates) {\n      const element = findElement(snap.hierarchy, { label });\n      if (element) {\n        const cx = Math.round(element.frame.x + element.frame.width / 2);\n        const cy = Math.round(element.frame.y + element.frame.height / 2);\n        await this.tapCoordinates(cx, cy);\n        return;\n      }\n    }\n\n    throw new Error(`No alert button found. Tried: ${candidates.join(', ')}`);\n  }\n\n  async getLogs(durationSeconds = 30, filter?: string): Promise<LogsResult> {\n    await this.ensureConnected();\n    const args = [\n      'log',\n      '--udid',\n      this.#udid,\n      '--',\n      '--last',\n      `${durationSeconds}s`,\n    ];\n    if (filter) {\n      args.push('--predicate', `eventMessage CONTAINS \"${filter}\"`);\n    }\n    const raw = await execStrict('idb', args);\n    const entries = raw\n      .trim()\n      .split('\\n')\n      .filter(Boolean)\n      .map((line) => ({\n        timestamp: line.substring(0, 31).trim(),\n        level: 'info',\n        message: line.substring(31).trim(),\n      }));\n    return { entries, source: 'idb log' };\n  }\n\n  async longPress(query: ElementQuery, durationMs = 1000): Promise<TapResult> {\n    await this.ensureConnected();\n    const snap = await this.snapshot();\n    const element = findElement(snap.hierarchy, query);\n    if (!element) {\n      throw new Error(\n        `Element not found: ${JSON.stringify(query)}\\n` +\n          'Use device_snapshot to inspect the current UI hierarchy.',\n      );\n    }\n\n    const cx = Math.round(element.frame.x + element.frame.width / 2);\n    const cy = Math.round(element.frame.y + element.frame.height / 2);\n    await execStrict('idb', [\n      'ui',\n      'tap',\n      String(cx),\n      String(cy),\n      '--duration',\n      String(durationMs / 1000),\n      '--udid',\n      this.#udid,\n    ]);\n\n    return {\n      success: true,\n      x: cx,\n      y: cy,\n      targetDescription: describeElement(element),\n    };\n  }\n\n  async scrollToElement(\n    query: ElementQuery,\n    direction: 'up' | 'down' = 'down',\n    maxAttempts = 10,\n  ): Promise<UIElement> {\n    await this.ensureConnected();\n    let previousRaw = '';\n\n    for (let i = 0; i < maxAttempts; i++) {\n      const snap = await this.snapshot();\n      const element = findElement(snap.hierarchy, query);\n      if (element) {\n        return element;\n      }\n      if (snap.raw === previousRaw) {\n        break;\n      }\n      previousRaw = snap.raw;\n      await this.swipe(direction);\n    }\n    throw new Error(\n      `Element not found after scrolling: ${JSON.stringify(query)}\\n` +\n        'Use device_snapshot to inspect the current UI hierarchy.',\n    );\n  }\n\n  async getAlertText(): Promise<string> {\n    await this.ensureConnected();\n    const snap = await this.snapshot();\n    const texts = collectAlertTexts(snap.hierarchy);\n    if (texts.length === 0) {\n      throw new Error(\n        'No alert is currently displayed.\\n' +\n          'Use device_snapshot to inspect the current UI hierarchy.',\n      );\n    }\n    return texts.join('\\n');\n  }\n\n  async getWindowSize(): Promise<WindowSize> {\n    await this.ensureConnected();\n    const raw = await execStrict('idb', [\n      'describe',\n      '--udid',\n      this.#udid,\n      '--json',\n    ]);\n    try {\n      const info = JSON.parse(raw) as Record<string, unknown>;\n      const dims = info.screen_dimensions as\n        | { width: number; height: number }\n        | undefined;\n      if (dims?.width && dims?.height) {\n        return { width: dims.width, height: dims.height };\n      }\n    } catch {\n      // fall through to snapshot-based approach\n    }\n    const snap = await this.snapshot();\n    if (snap.hierarchy.length > 0) {\n      const root = snap.hierarchy[0];\n      if (root.frame.width > 0 && root.frame.height > 0) {\n        return { width: root.frame.width, height: root.frame.height };\n      }\n    }\n    throw new Error('Unable to determine window size from device');\n  }\n\n  async getContexts(): Promise<string[]> {\n    return ['NATIVE_APP'];\n  }\n\n  async setContext(context: string): Promise<void> {\n    if (context === 'NATIVE_APP') {\n      return;\n    }\n    throw new Error(\n      'Context switching requires Appium backend. IDB only supports NATIVE_APP.',\n    );\n  }\n\n  async getClipboard(): Promise<string> {\n    await this.ensureConnected();\n    return execStrict('xcrun', ['simctl', 'pbpaste', this.#udid]);\n  }\n\n  async setClipboard(text: string): Promise<void> {\n    await this.ensureConnected();\n    await new Promise<void>((resolve, reject) => {\n      const proc = execFileCb(\n        'xcrun',\n        ['simctl', 'pbcopy', this.#udid],\n        { timeout: 30_000 },\n        (error) => (error ? reject(new Error(error.message)) : resolve()),\n      );\n      proc.stdin?.end(text);\n    });\n  }\n\n  async startScreenRecording(outputPath?: string): Promise<void> {\n    await this.ensureConnected();\n    if (this.#recordingProcess) {\n      throw new Error('Screen recording is already in progress');\n    }\n    const path = outputPath ?? `/tmp/device-mcp-recording-${Date.now()}.mp4`;\n    this.#recordingPath = path;\n    this.#recordingProcess = spawn('idb', [\n      'record-video',\n      path,\n      '--udid',\n      this.#udid,\n    ]);\n    this.#recordingProcess.on('error', () => {\n      this.#recordingProcess = null;\n      this.#recordingPath = null;\n    });\n  }\n\n  async stopScreenRecording(): Promise<string> {\n    if (!this.#recordingProcess || !this.#recordingPath) {\n      throw new Error('No screen recording in progress');\n    }\n    const path = this.#recordingPath;\n    this.#recordingProcess.kill('SIGINT');\n    await new Promise((resolve) => setTimeout(resolve, 1000));\n    this.#recordingProcess = null;\n    this.#recordingPath = null;\n    return path;\n  }\n}\n\nfunction collectAlertTexts(elements: UIElement[]): string[] {\n  const texts: string[] = [];\n  for (const el of elements) {\n    const isAlertContainer =\n      el.type === 'Alert' || el.type === 'Sheet' || el.type.includes('Alert');\n    if (isAlertContainer) {\n      collectTextsFromChildren(el.children ?? [], texts);\n      return texts;\n    }\n    if (el.children) {\n      const found = collectAlertTexts(el.children);\n      if (found.length > 0) {\n        return found;\n      }\n    }\n  }\n  return texts;\n}\n\nfunction collectTextsFromChildren(\n  elements: UIElement[],\n  texts: string[],\n): void {\n  for (const el of elements) {\n    if (el.type === 'StaticText' || el.type === 'TextView') {\n      const text = el.value ?? el.label;\n      if (text) {\n        texts.push(text);\n      }\n    }\n    if (el.children) {\n      collectTextsFromChildren(el.children, texts);\n    }\n  }\n}\n\nexport function parseIdbHierarchy(raw: string): UIElement[] {\n  try {\n    const parsed = JSON.parse(raw);\n    if (Array.isArray(parsed)) {\n      return parsed.map(mapIdbElement);\n    }\n    if (parsed.children) {\n      return parsed.children.map(mapIdbElement);\n    }\n    return [mapIdbElement(parsed)];\n  } catch {\n    return [\n      {\n        type: 'raw',\n        label: raw.slice(0, 200),\n        frame: { x: 0, y: 0, width: 0, height: 0 },\n        enabled: true,\n      },\n    ];\n  }\n}\n\nexport function mapIdbElement(node: Record<string, unknown>): UIElement {\n  const frame = node.frame as\n    | { x: number; y: number; width: number; height: number }\n    | undefined;\n\n  return {\n    type: (node.type as string) ?? (node.AXType as string) ?? 'Unknown',\n    label: (node.AXLabel as string) ?? (node.label as string) ?? undefined,\n    value: (node.AXValue as string) ?? (node.value as string) ?? undefined,\n    identifier:\n      (node.AXUniqueId as string) ?? (node.identifier as string) ?? undefined,\n    frame: frame ?? { x: 0, y: 0, width: 0, height: 0 },\n    enabled: (node.enabled as boolean) ?? true,\n    children: Array.isArray(node.children)\n      ? node.children.map(mapIdbElement)\n      : undefined,\n  };\n}\n"]}

package/dist/backends/index.cjs

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdbBackend = exports.AppiumBackend = exports.AdbBackend = void 0;
+exports.createBackend = createBackend;
+exports.createLazyBackend = createLazyBackend;
+const adb_backend_js_1 = require("./adb-backend.cjs");
+const appium_backend_js_1 = require("./appium-backend.cjs");
+const idb_backend_js_1 = require("./idb-backend.cjs");
+const session_file_js_1 = require("./session-file.cjs");
+const platform_js_1 = require("../utils/platform.cjs");
+var adb_backend_js_2 = require("./adb-backend.cjs");
+Object.defineProperty(exports, "AdbBackend", { enumerable: true, get: function () { return adb_backend_js_2.AdbBackend; } });
+var appium_backend_js_2 = require("./appium-backend.cjs");
+Object.defineProperty(exports, "AppiumBackend", { enumerable: true, get: function () { return appium_backend_js_2.AppiumBackend; } });
+var idb_backend_js_2 = require("./idb-backend.cjs");
+Object.defineProperty(exports, "IdbBackend", { enumerable: true, get: function () { return idb_backend_js_2.IdbBackend; } });
+async function createBackend(explicitDeviceId) {
+    const sessionConfig = await (0, session_file_js_1.readSessionFile)();
+    if (sessionConfig) {
+        console.error(`Found .device-session (${sessionConfig.mode}, ${sessionConfig.platform})`);
+        const backend = new appium_backend_js_1.AppiumBackend(sessionConfig);
+        await backend.ensureConnected();
+        return backend;
+    }
+    const { platform, deviceId } = await (0, platform_js_1.detectPlatform)(explicitDeviceId);
+    const backend = platform === 'ios' ? new idb_backend_js_1.IdbBackend(deviceId) : new adb_backend_js_1.AdbBackend(deviceId);
+    await backend.ensureConnected();
+    return backend;
+}
+/**
+ * Lazy backend that defers device detection to first tool call.
+ * Allows the MCP server to start and complete the handshake
+ * even when no device is connected yet.
+ *
+ * @param explicitDeviceId - Optional device ID override.
+ * @returns A DeviceBackend that resolves on first use.
+ */
+function createLazyBackend(explicitDeviceId) {
+    let inner = null;
+    let connecting = null;
+    async function resolve() {
+        if (inner) {
+            return inner;
+        }
+        if (!connecting) {
+            connecting = createBackend(explicitDeviceId).then((backend) => {
+                inner = backend;
+                return backend;
+            });
+        }
+        return connecting;
+    }
+    return {
+        get platform() {
+            return inner?.platform ?? 'ios';
+        },
+        async getDeviceInfo() {
+            return (await resolve()).getDeviceInfo();
+        },
+        async snapshot() {
+            return (await resolve()).snapshot();
+        },
+        async tapElement(query) {
+            return (await resolve()).tapElement(query);
+        },
+        async tapCoordinates(x, y) {
+            return (await resolve()).tapCoordinates(x, y);
+        },
+        async typeText(text) {
+            return (await resolve()).typeText(text);
+        },
+        async swipe(direction, startX, startY, distance) {
+            return (await resolve()).swipe(direction, startX, startY, distance);
+        },
+        async waitForElement(query, timeoutMs, intervalMs) {
+            return (await resolve()).waitForElement(query, timeoutMs, intervalMs);
+        },
+        async getAppState(bundleId) {
+            return (await resolve()).getAppState(bundleId);
+        },
+        async screenshot(outputPath) {
+            return (await resolve()).screenshot(outputPath);
+        },
+        async openApp(bundleId) {
+            return (await resolve()).openApp(bundleId);
+        },
+        async closeApp(bundleId) {
+            return (await resolve()).closeApp(bundleId);
+        },
+        async pressButton(button) {
+            return (await resolve()).pressButton(button);
+        },
+        async dismissKeyboard() {
+            return (await resolve()).dismissKeyboard();
+        },
+        async dismissAlert(accept) {
+            return (await resolve()).dismissAlert(accept);
+        },
+        async getLogs(durationSeconds, filter) {
+            return (await resolve()).getLogs(durationSeconds, filter);
+        },
+        async longPress(query, durationMs) {
+            return (await resolve()).longPress(query, durationMs);
+        },
+        async scrollToElement(query, direction, maxAttempts) {
+            return (await resolve()).scrollToElement(query, direction, maxAttempts);
+        },
+        async getAlertText() {
+            return (await resolve()).getAlertText();
+        },
+        async getWindowSize() {
+            return (await resolve()).getWindowSize();
+        },
+        async getContexts() {
+            return (await resolve()).getContexts();
+        },
+        async setContext(context) {
+            return (await resolve()).setContext(context);
+        },
+        async getClipboard() {
+            return (await resolve()).getClipboard();
+        },
+        async setClipboard(text) {
+            return (await resolve()).setClipboard(text);
+        },
+        async startScreenRecording(outputPath) {
+            return (await resolve()).startScreenRecording(outputPath);
+        },
+        async stopScreenRecording() {
+            return (await resolve()).stopScreenRecording();
+        },
+    };
+}
+//# sourceMappingURL=index.cjs.map

package/dist/backends/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { AdbBackend } from './adb-backend.js';\nimport { AppiumBackend } from './appium-backend.js';\nimport { IdbBackend } from './idb-backend.js';\nimport { readSessionFile } from './session-file.js';\nimport type {\n  DeviceBackend,\n  DeviceButton,\n  DeviceInfo,\n  LogsResult,\n  ScreenshotResult,\n  SnapshotResult,\n  TapResult,\n  AppStateResult,\n  ElementQuery,\n  UIElement,\n  Platform,\n  WindowSize,\n} from './types.js';\nimport { detectPlatform } from '../utils/platform.js';\n\nexport type { DeviceBackend } from './types.js';\nexport { AdbBackend } from './adb-backend.js';\nexport { AppiumBackend } from './appium-backend.js';\nexport { IdbBackend } from './idb-backend.js';\n\nexport async function createBackend(\n  explicitDeviceId?: string,\n): Promise<DeviceBackend> {\n  const sessionConfig = await readSessionFile();\n\n  if (sessionConfig) {\n    console.error(\n      `Found .device-session (${sessionConfig.mode}, ${sessionConfig.platform})`,\n    );\n    const backend = new AppiumBackend(sessionConfig);\n    await backend.ensureConnected();\n    return backend;\n  }\n\n  const { platform, deviceId } = await detectPlatform(explicitDeviceId);\n\n  const backend =\n    platform === 'ios' ? new IdbBackend(deviceId) : new AdbBackend(deviceId);\n\n  await backend.ensureConnected();\n  return backend;\n}\n\n/**\n * Lazy backend that defers device detection to first tool call.\n * Allows the MCP server to start and complete the handshake\n * even when no device is connected yet.\n *\n * @param explicitDeviceId - Optional device ID override.\n * @returns A DeviceBackend that resolves on first use.\n */\nexport function createLazyBackend(explicitDeviceId?: string): DeviceBackend {\n  let inner: DeviceBackend | null = null;\n  let connecting: Promise<DeviceBackend> | null = null;\n\n  async function resolve(): Promise<DeviceBackend> {\n    if (inner) {\n      return inner;\n    }\n    if (!connecting) {\n      connecting = createBackend(explicitDeviceId).then((backend) => {\n        inner = backend;\n        return backend;\n      });\n    }\n    return connecting;\n  }\n\n  return {\n    get platform(): Platform {\n      return inner?.platform ?? 'ios';\n    },\n\n    async getDeviceInfo(): Promise<DeviceInfo> {\n      return (await resolve()).getDeviceInfo();\n    },\n\n    async snapshot(): Promise<SnapshotResult> {\n      return (await resolve()).snapshot();\n    },\n\n    async tapElement(query: ElementQuery): Promise<TapResult> {\n      return (await resolve()).tapElement(query);\n    },\n\n    async tapCoordinates(x: number, y: number): Promise<void> {\n      return (await resolve()).tapCoordinates(x, y);\n    },\n\n    async typeText(text: string): Promise<void> {\n      return (await resolve()).typeText(text);\n    },\n\n    async swipe(\n      direction: 'up' | 'down' | 'left' | 'right',\n      startX?: number,\n      startY?: number,\n      distance?: number,\n    ): Promise<void> {\n      return (await resolve()).swipe(direction, startX, startY, distance);\n    },\n\n    async waitForElement(\n      query: ElementQuery,\n      timeoutMs?: number,\n      intervalMs?: number,\n    ): Promise<UIElement> {\n      return (await resolve()).waitForElement(query, timeoutMs, intervalMs);\n    },\n\n    async getAppState(bundleId: string): Promise<AppStateResult> {\n      return (await resolve()).getAppState(bundleId);\n    },\n\n    async screenshot(outputPath?: string): Promise<ScreenshotResult> {\n      return (await resolve()).screenshot(outputPath);\n    },\n\n    async openApp(bundleId: string): Promise<void> {\n      return (await resolve()).openApp(bundleId);\n    },\n\n    async closeApp(bundleId: string): Promise<void> {\n      return (await resolve()).closeApp(bundleId);\n    },\n\n    async pressButton(button: DeviceButton): Promise<void> {\n      return (await resolve()).pressButton(button);\n    },\n\n    async dismissKeyboard(): Promise<void> {\n      return (await resolve()).dismissKeyboard();\n    },\n\n    async dismissAlert(accept: boolean): Promise<void> {\n      return (await resolve()).dismissAlert(accept);\n    },\n\n    async getLogs(\n      durationSeconds?: number,\n      filter?: string,\n    ): Promise<LogsResult> {\n      return (await resolve()).getLogs(durationSeconds, filter);\n    },\n\n    async longPress(\n      query: ElementQuery,\n      durationMs?: number,\n    ): Promise<TapResult> {\n      return (await resolve()).longPress(query, durationMs);\n    },\n\n    async scrollToElement(\n      query: ElementQuery,\n      direction?: 'up' | 'down',\n      maxAttempts?: number,\n    ): Promise<UIElement> {\n      return (await resolve()).scrollToElement(query, direction, maxAttempts);\n    },\n\n    async getAlertText(): Promise<string> {\n      return (await resolve()).getAlertText();\n    },\n\n    async getWindowSize(): Promise<WindowSize> {\n      return (await resolve()).getWindowSize();\n    },\n\n    async getContexts(): Promise<string[]> {\n      return (await resolve()).getContexts();\n    },\n\n    async setContext(context: string): Promise<void> {\n      return (await resolve()).setContext(context);\n    },\n\n    async getClipboard(): Promise<string> {\n      return (await resolve()).getClipboard();\n    },\n\n    async setClipboard(text: string): Promise<void> {\n      return (await resolve()).setClipboard(text);\n    },\n\n    async startScreenRecording(outputPath?: string): Promise<void> {\n      return (await resolve()).startScreenRecording(outputPath);\n    },\n\n    async stopScreenRecording(): Promise<string> {\n      return (await resolve()).stopScreenRecording();\n    },\n  };\n}\n"]}