@metamask/device-mcp 0.1.0 → 0.2.0

package/dist/utils/platform.cjs

@@ -1,29 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultipleDevicesError = void 0;
+exports.detectAllDevices = detectAllDevices;
 exports.detectPlatform = detectPlatform;
+exports.resolveIdbPath = resolveIdbPath;
+const node_fs_1 = require("node:fs");
 const exec_js_1 = require("./exec.cjs");
-async function detectPlatform(explicitDeviceId) {
+class MultipleDevicesError extends Error {
+    constructor(devices) {
+        const lines = devices.map((d) => `  ${d.platform}\t${d.deviceId}`);
+        super(`Multiple devices detected. Set DEVICE_ID to one of:\n${lines.join('\n')}`);
+        this.name = 'MultipleDevicesError';
+        this.devices = devices;
+    }
+}
+exports.MultipleDevicesError = MultipleDevicesError;
+/**
+ * Detect all connected devices across iOS and Android.
+ *
+ * @param platform - Optional filter to only return devices of a specific platform.
+ * @returns Array of detected devices (may be empty).
+ */
+async function detectAllDevices(platform) {
+    const searches = [];
+    if (platform !== 'android') {
+        searches.push(findAllBootedIOSSimulators().catch(() => []));
+    }
+    if (platform !== 'ios') {
+        searches.push(findAllConnectedAndroidDevices().catch(() => []));
+    }
+    const results = await Promise.all(searches);
+    return results.flat();
+}
+async function detectPlatform(explicitDeviceId, explicitPlatform) {
     if (explicitDeviceId) {
         return detectFromExplicitId(explicitDeviceId);
     }
-    const [hasIdb, hasAdb] = await Promise.all([
-        (0, exec_js_1.isCommandAvailable)('idb'),
-        (0, exec_js_1.isCommandAvailable)('adb'),
-    ]);
-    if (hasIdb) {
-        const iosDevice = await findBootedIOSDevice();
-        if (iosDevice) {
-            return iosDevice;
-        }
+    const devices = await detectAllDevices(explicitPlatform);
+    if (devices.length === 1) {
+        return devices[0];
     }
-    if (hasAdb) {
-        const androidDevice = await findConnectedAndroidDevice();
-        if (androidDevice) {
-            return androidDevice;
-        }
+    if (devices.length > 1) {
+        throw new MultipleDevicesError(devices);
     }
-    throw new Error('No connected device found.\n' +
-        `  iOS (idb): ${hasIdb ? 'available, no booted simulator' : 'not installed'}\n` +
+    const hasAdb = explicitPlatform === 'ios' ? false : await (0, exec_js_1.isCommandAvailable)('adb');
+    const platformLabel = explicitPlatform ?? 'any';
+    throw new Error(`No connected ${platformLabel} device found.\n` +
+        `  iOS (simctl): no booted simulator\n` +
         `  Android (adb): ${hasAdb ? 'available, no connected device' : 'not installed'}\n` +
         'Boot a simulator/emulator or set DEVICE_ID explicitly.');
 }
@@ -55,39 +78,101 @@ async function detectFromExplicitId(deviceId) {
     throw new Error(`Cannot determine platform for device ID: ${deviceId}. ` +
         'Ensure the device is connected and idb/adb is available.');
 }
-async function findBootedIOSDevice() {
-    const result = await (0, exec_js_1.exec)('idb', ['list-targets', '--json']);
+async function findAllBootedIOSSimulators() {
+    const result = await (0, exec_js_1.exec)('xcrun', [
+        'simctl',
+        'list',
+        'devices',
+        'booted',
+        '--json',
+    ]);
     if (result.exitCode !== 0) {
-        return null;
+        return [];
     }
-    for (const line of result.stdout.trim().split('\n')) {
-        if (!line.trim()) {
-            continue;
-        }
-        try {
-            const target = JSON.parse(line);
-            if (target.state === 'Booted' && target.type === 'simulator') {
-                return { platform: 'ios', deviceId: target.udid };
+    try {
+        const parsed = JSON.parse(result.stdout);
+        const devices = [];
+        for (const runtimeDevices of Object.values(parsed.devices)) {
+            for (const device of runtimeDevices) {
+                if (device.state === 'Booted' && device.isAvailable) {
+                    devices.push({ platform: 'ios', deviceId: device.udid });
+                }
             }
         }
-        catch {
-            continue;
+        return devices;
+    }
+    catch {
+        return [];
+    }
+}
+function findPythonBinDirs(base) {
+    try {
+        return (0, node_fs_1.readdirSync)(base, { withFileTypes: true })
+            .filter((e) => (e.isDirectory() && e.name.startsWith('python')) ||
+            /^\d+\.\d+$/u.test(e.name))
+            .map((e) => `${base}/${e.name}/bin`);
+    }
+    catch {
+        return [];
+    }
+}
+async function resolveIdbPath() {
+    const result = await (0, exec_js_1.exec)('idb', ['--help']).catch(() => null);
+    if (result?.exitCode === 0) {
+        return 'idb';
+    }
+    const home = process.env.HOME ?? '';
+    const candidates = [
+        '/usr/local/bin/idb',
+        '/opt/homebrew/bin/idb',
+        ...findPythonBinDirs(`${home}/Library/Python`).map((d) => `${d}/idb`),
+        ...findPythonBinDirs('/usr/local/lib').map((d) => `${d}/idb`),
+    ];
+    for (const candidate of candidates) {
+        const probe = await (0, exec_js_1.exec)(candidate, ['--help']).catch(() => null);
+        if (probe?.exitCode === 0) {
+            return candidate;
+        }
+    }
+    throw new Error('idb not found.\n' +
+        'Install: brew tap facebook/fb && brew install idb-companion && pip3 install fb-idb');
+}
+async function resolveAdbPath() {
+    const result = await (0, exec_js_1.exec)('adb', ['version']).catch(() => null);
+    if (result?.exitCode === 0) {
+        return 'adb';
+    }
+    const home = process.env.HOME ?? '';
+    const candidates = [
+        process.env.ANDROID_HOME &&
+            `${process.env.ANDROID_HOME}/platform-tools/adb`,
+        process.env.ANDROID_SDK_ROOT &&
+            `${process.env.ANDROID_SDK_ROOT}/platform-tools/adb`,
+        `${home}/Library/Android/sdk/platform-tools/adb`,
+        `${home}/Android/Sdk/platform-tools/adb`,
+    ].filter(Boolean);
+    for (const candidate of candidates) {
+        const probe = await (0, exec_js_1.exec)(candidate, ['version']).catch(() => null);
+        if (probe?.exitCode === 0) {
+            return candidate;
         }
     }
-    return null;
+    throw new Error('adb not found');
 }
-async function findConnectedAndroidDevice() {
-    const result = await (0, exec_js_1.exec)('adb', ['devices']);
+async function findAllConnectedAndroidDevices() {
+    const adb = await resolveAdbPath();
+    const result = await (0, exec_js_1.exec)(adb, ['devices']);
     if (result.exitCode !== 0) {
-        return null;
+        return [];
     }
+    const devices = [];
     const lines = result.stdout.trim().split('\n').slice(1);
     for (const line of lines) {
         const [serial, state] = line.trim().split(/\s+/u);
         if (serial && state === 'device') {
-            return { platform: 'android', deviceId: serial };
+            devices.push({ platform: 'android', deviceId: serial });
         }
     }
-    return null;
+    return devices;
 }
 //# sourceMappingURL=platform.cjs.map

package/dist/utils/platform.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"platform.cjs","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"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","sourcesContent":["import { exec, isCommandAvailable } from './exec.js';\nimport type { Platform } from '../backends/types.js';\n\ntype DetectedDevice = {\n  platform: Platform;\n  deviceId: string;\n};\n\nexport async function detectPlatform(\n  explicitDeviceId?: string,\n): Promise<DetectedDevice> {\n  if (explicitDeviceId) {\n    return detectFromExplicitId(explicitDeviceId);\n  }\n\n  const [hasIdb, hasAdb] = await Promise.all([\n    isCommandAvailable('idb'),\n    isCommandAvailable('adb'),\n  ]);\n\n  if (hasIdb) {\n    const iosDevice = await findBootedIOSDevice();\n    if (iosDevice) {\n      return iosDevice;\n    }\n  }\n\n  if (hasAdb) {\n    const androidDevice = await findConnectedAndroidDevice();\n    if (androidDevice) {\n      return androidDevice;\n    }\n  }\n\n  throw new Error(\n    'No connected device found.\\n' +\n      `  iOS (idb): ${hasIdb ? 'available, no booted simulator' : 'not installed'}\\n` +\n      `  Android (adb): ${hasAdb ? 'available, no connected device' : 'not installed'}\\n` +\n      'Boot a simulator/emulator or set DEVICE_ID explicitly.',\n  );\n}\n\nasync function detectFromExplicitId(deviceId: string): Promise<DetectedDevice> {\n  // UUIDs with dashes are typically iOS simulator UDIDs\n  if (/^[0-9A-F]{8}-([0-9A-F]{4}-){3}[0-9A-F]{12}$/iu.test(deviceId)) {\n    return { platform: 'ios', deviceId };\n  }\n\n  // Android emulator or device serial patterns\n  if (deviceId.startsWith('emulator-') || /^[A-Za-z0-9]+$/u.test(deviceId)) {\n    return { platform: 'android', deviceId };\n  }\n\n  const [hasIdb, hasAdb] = await Promise.all([\n    isCommandAvailable('idb'),\n    isCommandAvailable('adb'),\n  ]);\n\n  if (hasIdb) {\n    const result = await exec('idb', ['describe', '--udid', deviceId]);\n    if (result.exitCode === 0) {\n      return { platform: 'ios', deviceId };\n    }\n  }\n\n  if (hasAdb) {\n    const result = await exec('adb', ['-s', deviceId, 'get-state']);\n    if (result.exitCode === 0) {\n      return { platform: 'android', deviceId };\n    }\n  }\n\n  throw new Error(\n    `Cannot determine platform for device ID: ${deviceId}. ` +\n      'Ensure the device is connected and idb/adb is available.',\n  );\n}\n\nasync function findBootedIOSDevice(): Promise<DetectedDevice | null> {\n  const result = await exec('idb', ['list-targets', '--json']);\n  if (result.exitCode !== 0) {\n    return null;\n  }\n\n  for (const line of result.stdout.trim().split('\\n')) {\n    if (!line.trim()) {\n      continue;\n    }\n    try {\n      const target = JSON.parse(line);\n      if (target.state === 'Booted' && target.type === 'simulator') {\n        return { platform: 'ios', deviceId: target.udid };\n      }\n    } catch {\n      continue;\n    }\n  }\n  return null;\n}\n\nasync function findConnectedAndroidDevice(): Promise<DetectedDevice | null> {\n  const result = await exec('adb', ['devices']);\n  if (result.exitCode !== 0) {\n    return null;\n  }\n\n  const lines = result.stdout.trim().split('\\n').slice(1);\n  for (const line of lines) {\n    const [serial, state] = line.trim().split(/\\s+/u);\n    if (serial && state === 'device') {\n      return { platform: 'android', deviceId: serial };\n    }\n  }\n  return null;\n}\n"]}
+{"version":3,"file":"platform.cjs","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"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","sourcesContent":["import { readdirSync } from 'node:fs';\n\nimport { exec, isCommandAvailable } from './exec.js';\nimport type { Platform } from '../backends/types.js';\n\nexport type DetectedDevice = {\n  platform: Platform;\n  deviceId: string;\n};\n\nexport class MultipleDevicesError extends Error {\n  readonly devices: DetectedDevice[];\n\n  constructor(devices: DetectedDevice[]) {\n    const lines = devices.map((d) => `  ${d.platform}\\t${d.deviceId}`);\n    super(\n      `Multiple devices detected. Set DEVICE_ID to one of:\\n${lines.join('\\n')}`,\n    );\n    this.name = 'MultipleDevicesError';\n    this.devices = devices;\n  }\n}\n\n/**\n * Detect all connected devices across iOS and Android.\n *\n * @param platform - Optional filter to only return devices of a specific platform.\n * @returns Array of detected devices (may be empty).\n */\nexport async function detectAllDevices(\n  platform?: Platform,\n): Promise<DetectedDevice[]> {\n  const searches: Promise<DetectedDevice[]>[] = [];\n\n  if (platform !== 'android') {\n    searches.push(findAllBootedIOSSimulators().catch(() => []));\n  }\n  if (platform !== 'ios') {\n    searches.push(findAllConnectedAndroidDevices().catch(() => []));\n  }\n\n  const results = await Promise.all(searches);\n  return results.flat();\n}\n\nexport async function detectPlatform(\n  explicitDeviceId?: string,\n  explicitPlatform?: Platform,\n): Promise<DetectedDevice> {\n  if (explicitDeviceId) {\n    return detectFromExplicitId(explicitDeviceId);\n  }\n\n  const devices = await detectAllDevices(explicitPlatform);\n\n  if (devices.length === 1) {\n    return devices[0];\n  }\n\n  if (devices.length > 1) {\n    throw new MultipleDevicesError(devices);\n  }\n\n  const hasAdb =\n    explicitPlatform === 'ios' ? false : await isCommandAvailable('adb');\n\n  const platformLabel = explicitPlatform ?? 'any';\n  throw new Error(\n    `No connected ${platformLabel} device found.\\n` +\n      `  iOS (simctl): no booted simulator\\n` +\n      `  Android (adb): ${hasAdb ? 'available, no connected device' : 'not installed'}\\n` +\n      'Boot a simulator/emulator or set DEVICE_ID explicitly.',\n  );\n}\n\nasync function detectFromExplicitId(deviceId: string): Promise<DetectedDevice> {\n  // UUIDs with dashes are typically iOS simulator UDIDs\n  if (/^[0-9A-F]{8}-([0-9A-F]{4}-){3}[0-9A-F]{12}$/iu.test(deviceId)) {\n    return { platform: 'ios', deviceId };\n  }\n\n  // Android emulator or device serial patterns\n  if (deviceId.startsWith('emulator-') || /^[A-Za-z0-9]+$/u.test(deviceId)) {\n    return { platform: 'android', deviceId };\n  }\n\n  const [hasIdb, hasAdb] = await Promise.all([\n    isCommandAvailable('idb'),\n    isCommandAvailable('adb'),\n  ]);\n\n  if (hasIdb) {\n    const result = await exec('idb', ['describe', '--udid', deviceId]);\n    if (result.exitCode === 0) {\n      return { platform: 'ios', deviceId };\n    }\n  }\n\n  if (hasAdb) {\n    const result = await exec('adb', ['-s', deviceId, 'get-state']);\n    if (result.exitCode === 0) {\n      return { platform: 'android', deviceId };\n    }\n  }\n\n  throw new Error(\n    `Cannot determine platform for device ID: ${deviceId}. ` +\n      'Ensure the device is connected and idb/adb is available.',\n  );\n}\n\ntype SimctlDevice = {\n  udid: string;\n  name: string;\n  state: string;\n  isAvailable: boolean;\n};\n\nasync function findAllBootedIOSSimulators(): Promise<DetectedDevice[]> {\n  const result = await exec('xcrun', [\n    'simctl',\n    'list',\n    'devices',\n    'booted',\n    '--json',\n  ]);\n  if (result.exitCode !== 0) {\n    return [];\n  }\n\n  try {\n    const parsed = JSON.parse(result.stdout) as {\n      devices: Record<string, SimctlDevice[]>;\n    };\n    const devices: DetectedDevice[] = [];\n    for (const runtimeDevices of Object.values(parsed.devices)) {\n      for (const device of runtimeDevices) {\n        if (device.state === 'Booted' && device.isAvailable) {\n          devices.push({ platform: 'ios', deviceId: device.udid });\n        }\n      }\n    }\n    return devices;\n  } catch {\n    return [];\n  }\n}\n\nfunction findPythonBinDirs(base: string): string[] {\n  try {\n    return readdirSync(base, { withFileTypes: true })\n      .filter(\n        (e) =>\n          (e.isDirectory() && e.name.startsWith('python')) ||\n          /^\\d+\\.\\d+$/u.test(e.name),\n      )\n      .map((e) => `${base}/${e.name}/bin`);\n  } catch {\n    return [];\n  }\n}\n\nexport async function resolveIdbPath(): Promise<string> {\n  const result = await exec('idb', ['--help']).catch(() => null);\n  if (result?.exitCode === 0) {\n    return 'idb';\n  }\n\n  const home = process.env.HOME ?? '';\n  const candidates = [\n    '/usr/local/bin/idb',\n    '/opt/homebrew/bin/idb',\n    ...findPythonBinDirs(`${home}/Library/Python`).map((d) => `${d}/idb`),\n    ...findPythonBinDirs('/usr/local/lib').map((d) => `${d}/idb`),\n  ];\n\n  for (const candidate of candidates) {\n    const probe = await exec(candidate, ['--help']).catch(() => null);\n    if (probe?.exitCode === 0) {\n      return candidate;\n    }\n  }\n\n  throw new Error(\n    'idb not found.\\n' +\n      'Install: brew tap facebook/fb && brew install idb-companion && pip3 install fb-idb',\n  );\n}\n\nasync function resolveAdbPath(): Promise<string> {\n  const result = await exec('adb', ['version']).catch(() => null);\n  if (result?.exitCode === 0) {\n    return 'adb';\n  }\n\n  const home = process.env.HOME ?? '';\n  const candidates = [\n    process.env.ANDROID_HOME &&\n      `${process.env.ANDROID_HOME}/platform-tools/adb`,\n    process.env.ANDROID_SDK_ROOT &&\n      `${process.env.ANDROID_SDK_ROOT}/platform-tools/adb`,\n    `${home}/Library/Android/sdk/platform-tools/adb`,\n    `${home}/Android/Sdk/platform-tools/adb`,\n  ].filter(Boolean) as string[];\n\n  for (const candidate of candidates) {\n    const probe = await exec(candidate, ['version']).catch(() => null);\n    if (probe?.exitCode === 0) {\n      return candidate;\n    }\n  }\n\n  throw new Error('adb not found');\n}\n\nasync function findAllConnectedAndroidDevices(): Promise<DetectedDevice[]> {\n  const adb = await resolveAdbPath();\n  const result = await exec(adb, ['devices']);\n  if (result.exitCode !== 0) {\n    return [];\n  }\n\n  const devices: DetectedDevice[] = [];\n  const lines = result.stdout.trim().split('\\n').slice(1);\n  for (const line of lines) {\n    const [serial, state] = line.trim().split(/\\s+/u);\n    if (serial && state === 'device') {\n      devices.push({ platform: 'android', deviceId: serial });\n    }\n  }\n  return devices;\n}\n"]}

package/dist/utils/platform.d.cts

@@ -1,8 +1,19 @@
 import type { Platform } from "../backends/types.cjs";
-type DetectedDevice = {
+export type DetectedDevice = {
     platform: Platform;
     deviceId: string;
 };
-export declare function detectPlatform(explicitDeviceId?: string): Promise<DetectedDevice>;
-export {};
+export declare class MultipleDevicesError extends Error {
+    readonly devices: DetectedDevice[];
+    constructor(devices: DetectedDevice[]);
+}
+/**
+ * Detect all connected devices across iOS and Android.
+ *
+ * @param platform - Optional filter to only return devices of a specific platform.
+ * @returns Array of detected devices (may be empty).
+ */
+export declare function detectAllDevices(platform?: Platform): Promise<DetectedDevice[]>;
+export declare function detectPlatform(explicitDeviceId?: string, explicitPlatform?: Platform): Promise<DetectedDevice>;
+export declare function resolveIdbPath(): Promise<string>;
 //# sourceMappingURL=platform.d.cts.map

package/dist/utils/platform.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.cts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,8BAA6B;AAErD,KAAK,cAAc,GAAG;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,cAAc,CAClC,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,cAAc,CAAC,CA8BzB"}
+{"version":3,"file":"platform.d.cts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,8BAA6B;AAErD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;gBAEvB,OAAO,EAAE,cAAc,EAAE;CAQtC;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,cAAc,EAAE,CAAC,CAY3B;AAED,wBAAsB,cAAc,CAClC,gBAAgB,CAAC,EAAE,MAAM,EACzB,gBAAgB,CAAC,EAAE,QAAQ,GAC1B,OAAO,CAAC,cAAc,CAAC,CAyBzB;AAyFD,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAyBtD"}

package/dist/utils/platform.d.mts

@@ -1,8 +1,19 @@
 import type { Platform } from "../backends/types.mjs";
-type DetectedDevice = {
+export type DetectedDevice = {
     platform: Platform;
     deviceId: string;
 };
-export declare function detectPlatform(explicitDeviceId?: string): Promise<DetectedDevice>;
-export {};
+export declare class MultipleDevicesError extends Error {
+    readonly devices: DetectedDevice[];
+    constructor(devices: DetectedDevice[]);
+}
+/**
+ * Detect all connected devices across iOS and Android.
+ *
+ * @param platform - Optional filter to only return devices of a specific platform.
+ * @returns Array of detected devices (may be empty).
+ */
+export declare function detectAllDevices(platform?: Platform): Promise<DetectedDevice[]>;
+export declare function detectPlatform(explicitDeviceId?: string, explicitPlatform?: Platform): Promise<DetectedDevice>;
+export declare function resolveIdbPath(): Promise<string>;
 //# sourceMappingURL=platform.d.mts.map

package/dist/utils/platform.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.mts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,8BAA6B;AAErD,KAAK,cAAc,GAAG;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,cAAc,CAClC,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,cAAc,CAAC,CA8BzB"}
+{"version":3,"file":"platform.d.mts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,8BAA6B;AAErD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;gBAEvB,OAAO,EAAE,cAAc,EAAE;CAQtC;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,cAAc,EAAE,CAAC,CAY3B;AAED,wBAAsB,cAAc,CAClC,gBAAgB,CAAC,EAAE,MAAM,EACzB,gBAAgB,CAAC,EAAE,QAAQ,GAC1B,OAAO,CAAC,cAAc,CAAC,CAyBzB;AAyFD,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAyBtD"}

package/dist/utils/platform.mjs

@@ -1,26 +1,45 @@
+import { readdirSync } from "node:fs";
 import { exec, isCommandAvailable } from "./exec.mjs";
-export async function detectPlatform(explicitDeviceId) {
+export class MultipleDevicesError extends Error {
+    constructor(devices) {
+        const lines = devices.map((d) => `  ${d.platform}\t${d.deviceId}`);
+        super(`Multiple devices detected. Set DEVICE_ID to one of:\n${lines.join('\n')}`);
+        this.name = 'MultipleDevicesError';
+        this.devices = devices;
+    }
+}
+/**
+ * Detect all connected devices across iOS and Android.
+ *
+ * @param platform - Optional filter to only return devices of a specific platform.
+ * @returns Array of detected devices (may be empty).
+ */
+export async function detectAllDevices(platform) {
+    const searches = [];
+    if (platform !== 'android') {
+        searches.push(findAllBootedIOSSimulators().catch(() => []));
+    }
+    if (platform !== 'ios') {
+        searches.push(findAllConnectedAndroidDevices().catch(() => []));
+    }
+    const results = await Promise.all(searches);
+    return results.flat();
+}
+export async function detectPlatform(explicitDeviceId, explicitPlatform) {
     if (explicitDeviceId) {
         return detectFromExplicitId(explicitDeviceId);
     }
-    const [hasIdb, hasAdb] = await Promise.all([
-        isCommandAvailable('idb'),
-        isCommandAvailable('adb'),
-    ]);
-    if (hasIdb) {
-        const iosDevice = await findBootedIOSDevice();
-        if (iosDevice) {
-            return iosDevice;
-        }
+    const devices = await detectAllDevices(explicitPlatform);
+    if (devices.length === 1) {
+        return devices[0];
     }
-    if (hasAdb) {
-        const androidDevice = await findConnectedAndroidDevice();
-        if (androidDevice) {
-            return androidDevice;
-        }
+    if (devices.length > 1) {
+        throw new MultipleDevicesError(devices);
     }
-    throw new Error('No connected device found.\n' +
-        `  iOS (idb): ${hasIdb ? 'available, no booted simulator' : 'not installed'}\n` +
+    const hasAdb = explicitPlatform === 'ios' ? false : await isCommandAvailable('adb');
+    const platformLabel = explicitPlatform ?? 'any';
+    throw new Error(`No connected ${platformLabel} device found.\n` +
+        `  iOS (simctl): no booted simulator\n` +
         `  Android (adb): ${hasAdb ? 'available, no connected device' : 'not installed'}\n` +
         'Boot a simulator/emulator or set DEVICE_ID explicitly.');
 }
@@ -52,39 +71,101 @@ async function detectFromExplicitId(deviceId) {
     throw new Error(`Cannot determine platform for device ID: ${deviceId}. ` +
         'Ensure the device is connected and idb/adb is available.');
 }
-async function findBootedIOSDevice() {
-    const result = await exec('idb', ['list-targets', '--json']);
+async function findAllBootedIOSSimulators() {
+    const result = await exec('xcrun', [
+        'simctl',
+        'list',
+        'devices',
+        'booted',
+        '--json',
+    ]);
     if (result.exitCode !== 0) {
-        return null;
+        return [];
     }
-    for (const line of result.stdout.trim().split('\n')) {
-        if (!line.trim()) {
-            continue;
-        }
-        try {
-            const target = JSON.parse(line);
-            if (target.state === 'Booted' && target.type === 'simulator') {
-                return { platform: 'ios', deviceId: target.udid };
+    try {
+        const parsed = JSON.parse(result.stdout);
+        const devices = [];
+        for (const runtimeDevices of Object.values(parsed.devices)) {
+            for (const device of runtimeDevices) {
+                if (device.state === 'Booted' && device.isAvailable) {
+                    devices.push({ platform: 'ios', deviceId: device.udid });
+                }
             }
         }
-        catch {
-            continue;
+        return devices;
+    }
+    catch {
+        return [];
+    }
+}
+function findPythonBinDirs(base) {
+    try {
+        return readdirSync(base, { withFileTypes: true })
+            .filter((e) => (e.isDirectory() && e.name.startsWith('python')) ||
+            /^\d+\.\d+$/u.test(e.name))
+            .map((e) => `${base}/${e.name}/bin`);
+    }
+    catch {
+        return [];
+    }
+}
+export async function resolveIdbPath() {
+    const result = await exec('idb', ['--help']).catch(() => null);
+    if (result?.exitCode === 0) {
+        return 'idb';
+    }
+    const home = process.env.HOME ?? '';
+    const candidates = [
+        '/usr/local/bin/idb',
+        '/opt/homebrew/bin/idb',
+        ...findPythonBinDirs(`${home}/Library/Python`).map((d) => `${d}/idb`),
+        ...findPythonBinDirs('/usr/local/lib').map((d) => `${d}/idb`),
+    ];
+    for (const candidate of candidates) {
+        const probe = await exec(candidate, ['--help']).catch(() => null);
+        if (probe?.exitCode === 0) {
+            return candidate;
+        }
+    }
+    throw new Error('idb not found.\n' +
+        'Install: brew tap facebook/fb && brew install idb-companion && pip3 install fb-idb');
+}
+async function resolveAdbPath() {
+    const result = await exec('adb', ['version']).catch(() => null);
+    if (result?.exitCode === 0) {
+        return 'adb';
+    }
+    const home = process.env.HOME ?? '';
+    const candidates = [
+        process.env.ANDROID_HOME &&
+            `${process.env.ANDROID_HOME}/platform-tools/adb`,
+        process.env.ANDROID_SDK_ROOT &&
+            `${process.env.ANDROID_SDK_ROOT}/platform-tools/adb`,
+        `${home}/Library/Android/sdk/platform-tools/adb`,
+        `${home}/Android/Sdk/platform-tools/adb`,
+    ].filter(Boolean);
+    for (const candidate of candidates) {
+        const probe = await exec(candidate, ['version']).catch(() => null);
+        if (probe?.exitCode === 0) {
+            return candidate;
         }
     }
-    return null;
+    throw new Error('adb not found');
 }
-async function findConnectedAndroidDevice() {
-    const result = await exec('adb', ['devices']);
+async function findAllConnectedAndroidDevices() {
+    const adb = await resolveAdbPath();
+    const result = await exec(adb, ['devices']);
     if (result.exitCode !== 0) {
-        return null;
+        return [];
     }
+    const devices = [];
     const lines = result.stdout.trim().split('\n').slice(1);
     for (const line of lines) {
         const [serial, state] = line.trim().split(/\s+/u);
         if (serial && state === 'device') {
-            return { platform: 'android', deviceId: serial };
+            devices.push({ platform: 'android', deviceId: serial });
         }
     }
-    return null;
+    return devices;
 }
 //# sourceMappingURL=platform.mjs.map

package/dist/utils/platform.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"platform.mjs","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"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","sourcesContent":["import { exec, isCommandAvailable } from './exec.js';\nimport type { Platform } from '../backends/types.js';\n\ntype DetectedDevice = {\n  platform: Platform;\n  deviceId: string;\n};\n\nexport async function detectPlatform(\n  explicitDeviceId?: string,\n): Promise<DetectedDevice> {\n  if (explicitDeviceId) {\n    return detectFromExplicitId(explicitDeviceId);\n  }\n\n  const [hasIdb, hasAdb] = await Promise.all([\n    isCommandAvailable('idb'),\n    isCommandAvailable('adb'),\n  ]);\n\n  if (hasIdb) {\n    const iosDevice = await findBootedIOSDevice();\n    if (iosDevice) {\n      return iosDevice;\n    }\n  }\n\n  if (hasAdb) {\n    const androidDevice = await findConnectedAndroidDevice();\n    if (androidDevice) {\n      return androidDevice;\n    }\n  }\n\n  throw new Error(\n    'No connected device found.\\n' +\n      `  iOS (idb): ${hasIdb ? 'available, no booted simulator' : 'not installed'}\\n` +\n      `  Android (adb): ${hasAdb ? 'available, no connected device' : 'not installed'}\\n` +\n      'Boot a simulator/emulator or set DEVICE_ID explicitly.',\n  );\n}\n\nasync function detectFromExplicitId(deviceId: string): Promise<DetectedDevice> {\n  // UUIDs with dashes are typically iOS simulator UDIDs\n  if (/^[0-9A-F]{8}-([0-9A-F]{4}-){3}[0-9A-F]{12}$/iu.test(deviceId)) {\n    return { platform: 'ios', deviceId };\n  }\n\n  // Android emulator or device serial patterns\n  if (deviceId.startsWith('emulator-') || /^[A-Za-z0-9]+$/u.test(deviceId)) {\n    return { platform: 'android', deviceId };\n  }\n\n  const [hasIdb, hasAdb] = await Promise.all([\n    isCommandAvailable('idb'),\n    isCommandAvailable('adb'),\n  ]);\n\n  if (hasIdb) {\n    const result = await exec('idb', ['describe', '--udid', deviceId]);\n    if (result.exitCode === 0) {\n      return { platform: 'ios', deviceId };\n    }\n  }\n\n  if (hasAdb) {\n    const result = await exec('adb', ['-s', deviceId, 'get-state']);\n    if (result.exitCode === 0) {\n      return { platform: 'android', deviceId };\n    }\n  }\n\n  throw new Error(\n    `Cannot determine platform for device ID: ${deviceId}. ` +\n      'Ensure the device is connected and idb/adb is available.',\n  );\n}\n\nasync function findBootedIOSDevice(): Promise<DetectedDevice | null> {\n  const result = await exec('idb', ['list-targets', '--json']);\n  if (result.exitCode !== 0) {\n    return null;\n  }\n\n  for (const line of result.stdout.trim().split('\\n')) {\n    if (!line.trim()) {\n      continue;\n    }\n    try {\n      const target = JSON.parse(line);\n      if (target.state === 'Booted' && target.type === 'simulator') {\n        return { platform: 'ios', deviceId: target.udid };\n      }\n    } catch {\n      continue;\n    }\n  }\n  return null;\n}\n\nasync function findConnectedAndroidDevice(): Promise<DetectedDevice | null> {\n  const result = await exec('adb', ['devices']);\n  if (result.exitCode !== 0) {\n    return null;\n  }\n\n  const lines = result.stdout.trim().split('\\n').slice(1);\n  for (const line of lines) {\n    const [serial, state] = line.trim().split(/\\s+/u);\n    if (serial && state === 'device') {\n      return { platform: 'android', deviceId: serial };\n    }\n  }\n  return null;\n}\n"]}
+{"version":3,"file":"platform.mjs","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"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","sourcesContent":["import { readdirSync } from 'node:fs';\n\nimport { exec, isCommandAvailable } from './exec.js';\nimport type { Platform } from '../backends/types.js';\n\nexport type DetectedDevice = {\n  platform: Platform;\n  deviceId: string;\n};\n\nexport class MultipleDevicesError extends Error {\n  readonly devices: DetectedDevice[];\n\n  constructor(devices: DetectedDevice[]) {\n    const lines = devices.map((d) => `  ${d.platform}\\t${d.deviceId}`);\n    super(\n      `Multiple devices detected. Set DEVICE_ID to one of:\\n${lines.join('\\n')}`,\n    );\n    this.name = 'MultipleDevicesError';\n    this.devices = devices;\n  }\n}\n\n/**\n * Detect all connected devices across iOS and Android.\n *\n * @param platform - Optional filter to only return devices of a specific platform.\n * @returns Array of detected devices (may be empty).\n */\nexport async function detectAllDevices(\n  platform?: Platform,\n): Promise<DetectedDevice[]> {\n  const searches: Promise<DetectedDevice[]>[] = [];\n\n  if (platform !== 'android') {\n    searches.push(findAllBootedIOSSimulators().catch(() => []));\n  }\n  if (platform !== 'ios') {\n    searches.push(findAllConnectedAndroidDevices().catch(() => []));\n  }\n\n  const results = await Promise.all(searches);\n  return results.flat();\n}\n\nexport async function detectPlatform(\n  explicitDeviceId?: string,\n  explicitPlatform?: Platform,\n): Promise<DetectedDevice> {\n  if (explicitDeviceId) {\n    return detectFromExplicitId(explicitDeviceId);\n  }\n\n  const devices = await detectAllDevices(explicitPlatform);\n\n  if (devices.length === 1) {\n    return devices[0];\n  }\n\n  if (devices.length > 1) {\n    throw new MultipleDevicesError(devices);\n  }\n\n  const hasAdb =\n    explicitPlatform === 'ios' ? false : await isCommandAvailable('adb');\n\n  const platformLabel = explicitPlatform ?? 'any';\n  throw new Error(\n    `No connected ${platformLabel} device found.\\n` +\n      `  iOS (simctl): no booted simulator\\n` +\n      `  Android (adb): ${hasAdb ? 'available, no connected device' : 'not installed'}\\n` +\n      'Boot a simulator/emulator or set DEVICE_ID explicitly.',\n  );\n}\n\nasync function detectFromExplicitId(deviceId: string): Promise<DetectedDevice> {\n  // UUIDs with dashes are typically iOS simulator UDIDs\n  if (/^[0-9A-F]{8}-([0-9A-F]{4}-){3}[0-9A-F]{12}$/iu.test(deviceId)) {\n    return { platform: 'ios', deviceId };\n  }\n\n  // Android emulator or device serial patterns\n  if (deviceId.startsWith('emulator-') || /^[A-Za-z0-9]+$/u.test(deviceId)) {\n    return { platform: 'android', deviceId };\n  }\n\n  const [hasIdb, hasAdb] = await Promise.all([\n    isCommandAvailable('idb'),\n    isCommandAvailable('adb'),\n  ]);\n\n  if (hasIdb) {\n    const result = await exec('idb', ['describe', '--udid', deviceId]);\n    if (result.exitCode === 0) {\n      return { platform: 'ios', deviceId };\n    }\n  }\n\n  if (hasAdb) {\n    const result = await exec('adb', ['-s', deviceId, 'get-state']);\n    if (result.exitCode === 0) {\n      return { platform: 'android', deviceId };\n    }\n  }\n\n  throw new Error(\n    `Cannot determine platform for device ID: ${deviceId}. ` +\n      'Ensure the device is connected and idb/adb is available.',\n  );\n}\n\ntype SimctlDevice = {\n  udid: string;\n  name: string;\n  state: string;\n  isAvailable: boolean;\n};\n\nasync function findAllBootedIOSSimulators(): Promise<DetectedDevice[]> {\n  const result = await exec('xcrun', [\n    'simctl',\n    'list',\n    'devices',\n    'booted',\n    '--json',\n  ]);\n  if (result.exitCode !== 0) {\n    return [];\n  }\n\n  try {\n    const parsed = JSON.parse(result.stdout) as {\n      devices: Record<string, SimctlDevice[]>;\n    };\n    const devices: DetectedDevice[] = [];\n    for (const runtimeDevices of Object.values(parsed.devices)) {\n      for (const device of runtimeDevices) {\n        if (device.state === 'Booted' && device.isAvailable) {\n          devices.push({ platform: 'ios', deviceId: device.udid });\n        }\n      }\n    }\n    return devices;\n  } catch {\n    return [];\n  }\n}\n\nfunction findPythonBinDirs(base: string): string[] {\n  try {\n    return readdirSync(base, { withFileTypes: true })\n      .filter(\n        (e) =>\n          (e.isDirectory() && e.name.startsWith('python')) ||\n          /^\\d+\\.\\d+$/u.test(e.name),\n      )\n      .map((e) => `${base}/${e.name}/bin`);\n  } catch {\n    return [];\n  }\n}\n\nexport async function resolveIdbPath(): Promise<string> {\n  const result = await exec('idb', ['--help']).catch(() => null);\n  if (result?.exitCode === 0) {\n    return 'idb';\n  }\n\n  const home = process.env.HOME ?? '';\n  const candidates = [\n    '/usr/local/bin/idb',\n    '/opt/homebrew/bin/idb',\n    ...findPythonBinDirs(`${home}/Library/Python`).map((d) => `${d}/idb`),\n    ...findPythonBinDirs('/usr/local/lib').map((d) => `${d}/idb`),\n  ];\n\n  for (const candidate of candidates) {\n    const probe = await exec(candidate, ['--help']).catch(() => null);\n    if (probe?.exitCode === 0) {\n      return candidate;\n    }\n  }\n\n  throw new Error(\n    'idb not found.\\n' +\n      'Install: brew tap facebook/fb && brew install idb-companion && pip3 install fb-idb',\n  );\n}\n\nasync function resolveAdbPath(): Promise<string> {\n  const result = await exec('adb', ['version']).catch(() => null);\n  if (result?.exitCode === 0) {\n    return 'adb';\n  }\n\n  const home = process.env.HOME ?? '';\n  const candidates = [\n    process.env.ANDROID_HOME &&\n      `${process.env.ANDROID_HOME}/platform-tools/adb`,\n    process.env.ANDROID_SDK_ROOT &&\n      `${process.env.ANDROID_SDK_ROOT}/platform-tools/adb`,\n    `${home}/Library/Android/sdk/platform-tools/adb`,\n    `${home}/Android/Sdk/platform-tools/adb`,\n  ].filter(Boolean) as string[];\n\n  for (const candidate of candidates) {\n    const probe = await exec(candidate, ['version']).catch(() => null);\n    if (probe?.exitCode === 0) {\n      return candidate;\n    }\n  }\n\n  throw new Error('adb not found');\n}\n\nasync function findAllConnectedAndroidDevices(): Promise<DetectedDevice[]> {\n  const adb = await resolveAdbPath();\n  const result = await exec(adb, ['devices']);\n  if (result.exitCode !== 0) {\n    return [];\n  }\n\n  const devices: DetectedDevice[] = [];\n  const lines = result.stdout.trim().split('\\n').slice(1);\n  for (const line of lines) {\n    const [serial, state] = line.trim().split(/\\s+/u);\n    if (serial && state === 'device') {\n      devices.push({ platform: 'android', deviceId: serial });\n    }\n  }\n  return devices;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask/device-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for mobile device interaction — iOS (IDB), Android (ADB), and Appium/BrowserStack",
   "homepage": "https://github.com/MetaMask/device-mcp#readme",
   "bugs": {
@@ -86,7 +86,7 @@
     "vite": "^6.4.1",
     "vitest": "^3.2.1"
   },
-  "packageManager": "yarn@4.11.0",
+  "packageManager": "yarn@4.16.0",
   "engines": {
     "node": "^20 || ^22 || >=24"
   },