@metamask/device-mcp 0.1.0 → 0.3.0

package/dist/backends/index.d.mts

@@ -1,16 +1,13 @@
-import type { DeviceBackend } from "./types.mjs";
+import type { DeviceBackend, Platform } from "./types.mjs";
+import type { DetectedDevice } from "../utils/platform.mjs";
 export type { DeviceBackend } from "./types.mjs";
 export { AdbBackend } from "./adb-backend.mjs";
 export { AppiumBackend } from "./appium-backend.mjs";
 export { IdbBackend } from "./idb-backend.mjs";
-export declare function createBackend(explicitDeviceId?: string): Promise<DeviceBackend>;
-/**
- * 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.
- */
-export declare function createLazyBackend(explicitDeviceId?: string): DeviceBackend;
+export type LazyDeviceBackend = DeviceBackend & {
+    selectDevice(deviceId: string): void;
+    listDevices(): Promise<DetectedDevice[]>;
+};
+export declare function createBackend(explicitDeviceId?: string, explicitPlatform?: Platform): Promise<DeviceBackend>;
+export declare function createLazyBackend(explicitDeviceId?: string, explicitPlatform?: Platform): LazyDeviceBackend;
 //# sourceMappingURL=index.d.mts.map

package/dist/backends/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EAYd,oBAAmB;AAGpB,YAAY,EAAE,aAAa,EAAE,oBAAmB;AAChD,OAAO,EAAE,UAAU,EAAE,0BAAyB;AAC9C,OAAO,EAAE,aAAa,EAAE,6BAA4B;AACpD,OAAO,EAAE,UAAU,EAAE,0BAAyB;AAE9C,wBAAsB,aAAa,CACjC,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,aAAa,CAAC,CAmBxB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,aAAa,CA6I1E"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EAYb,QAAQ,EAET,oBAAmB;AAMpB,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA6B;AAE3D,YAAY,EAAE,aAAa,EAAE,oBAAmB;AAChD,OAAO,EAAE,UAAU,EAAE,0BAAyB;AAC9C,OAAO,EAAE,aAAa,EAAE,6BAA4B;AACpD,OAAO,EAAE,UAAU,EAAE,0BAAyB;AAE9C,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG;IAC9C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC1C,CAAC;AAEF,wBAAsB,aAAa,CACjC,gBAAgB,CAAC,EAAE,MAAM,EACzB,gBAAgB,CAAC,EAAE,QAAQ,GAC1B,OAAO,CAAC,aAAa,CAAC,CAsBxB;AAED,wBAAgB,iBAAiB,CAC/B,gBAAgB,CAAC,EAAE,MAAM,EACzB,gBAAgB,CAAC,EAAE,QAAQ,GAC1B,iBAAiB,CAgMnB"}

package/dist/backends/index.mjs

@@ -2,11 +2,11 @@ import { AdbBackend } from "./adb-backend.mjs";
 import { AppiumBackend } from "./appium-backend.mjs";
 import { IdbBackend } from "./idb-backend.mjs";
 import { readSessionFile } from "./session-file.mjs";
-import { detectPlatform } from "../utils/platform.mjs";
+import { detectPlatform, detectAllDevices, MultipleDevicesError } from "../utils/platform.mjs";
 export { AdbBackend } from "./adb-backend.mjs";
 export { AppiumBackend } from "./appium-backend.mjs";
 export { IdbBackend } from "./idb-backend.mjs";
-export async function createBackend(explicitDeviceId) {
+export async function createBackend(explicitDeviceId, explicitPlatform) {
     const sessionConfig = await readSessionFile();
     if (sessionConfig) {
         console.error(`Found .device-session (${sessionConfig.mode}, ${sessionConfig.platform})`);
@@ -14,38 +14,59 @@ export async function createBackend(explicitDeviceId) {
         await backend.ensureConnected();
         return backend;
     }
-    const { platform, deviceId } = await detectPlatform(explicitDeviceId);
+    const { platform, deviceId } = await detectPlatform(explicitDeviceId, explicitPlatform);
     const backend = platform === 'ios' ? new IdbBackend(deviceId) : new 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.
- */
-export function createLazyBackend(explicitDeviceId) {
+export function createLazyBackend(explicitDeviceId, explicitPlatform) {
     let inner = null;
     let connecting = null;
+    let pendingDevices = null;
+    let selectedOverride = null;
     async function resolve() {
         if (inner) {
             return inner;
         }
+        if (pendingDevices && !selectedOverride) {
+            throw new MultipleDevicesError(pendingDevices);
+        }
         if (!connecting) {
-            connecting = createBackend(explicitDeviceId).then((backend) => {
+            const deviceId = selectedOverride ?? explicitDeviceId;
+            connecting = createBackend(deviceId, explicitPlatform)
+                .then((backend) => {
                 inner = backend;
+                pendingDevices = null;
                 return backend;
+            })
+                .catch((error) => {
+                connecting = null;
+                if (error instanceof MultipleDevicesError) {
+                    pendingDevices = error.devices;
+                }
+                throw error;
             });
         }
         return connecting;
     }
+    async function screenshot(outputPath, options) {
+        return (await resolve()).screenshot(outputPath, options);
+    }
     return {
         get platform() {
             return inner?.platform ?? 'ios';
         },
+        selectDevice(deviceId) {
+            selectedOverride = deviceId;
+            inner = null;
+            connecting = null;
+        },
+        async listDevices() {
+            if (pendingDevices) {
+                return pendingDevices;
+            }
+            return detectAllDevices(explicitPlatform);
+        },
         async getDeviceInfo() {
             return (await resolve()).getDeviceInfo();
         },
@@ -70,9 +91,7 @@ export function createLazyBackend(explicitDeviceId) {
         async getAppState(bundleId) {
             return (await resolve()).getAppState(bundleId);
         },
-        async screenshot(outputPath) {
-            return (await resolve()).screenshot(outputPath);
-        },
+        screenshot,
         async openApp(bundleId) {
             return (await resolve()).openApp(bundleId);
         },
@@ -121,6 +140,9 @@ export function createLazyBackend(explicitDeviceId) {
         async stopScreenRecording() {
             return (await resolve()).stopScreenRecording();
         },
+        async getElementText(query) {
+            return (await resolve()).getElementText(query);
+        },
     };
 }
 //# sourceMappingURL=index.mjs.map

package/dist/backends/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","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"]}
+{"version":3,"file":"index.mjs","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  ScreenshotFileResult,\n  ScreenshotOptions,\n  SnapshotResult,\n  TapResult,\n  AppStateResult,\n  ElementQuery,\n  UIElement,\n  Platform,\n  WindowSize,\n} from './types.js';\nimport {\n  detectPlatform,\n  detectAllDevices,\n  MultipleDevicesError,\n} from '../utils/platform.js';\nimport type { DetectedDevice } 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 type LazyDeviceBackend = DeviceBackend & {\n  selectDevice(deviceId: string): void;\n  listDevices(): Promise<DetectedDevice[]>;\n};\n\nexport async function createBackend(\n  explicitDeviceId?: string,\n  explicitPlatform?: Platform,\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(\n    explicitDeviceId,\n    explicitPlatform,\n  );\n\n  const backend =\n    platform === 'ios' ? new IdbBackend(deviceId) : new AdbBackend(deviceId);\n\n  await backend.ensureConnected();\n  return backend;\n}\n\nexport function createLazyBackend(\n  explicitDeviceId?: string,\n  explicitPlatform?: Platform,\n): LazyDeviceBackend {\n  let inner: DeviceBackend | null = null;\n  let connecting: Promise<DeviceBackend> | null = null;\n  let pendingDevices: DetectedDevice[] | null = null;\n  let selectedOverride: string | null = null;\n\n  async function resolve(): Promise<DeviceBackend> {\n    if (inner) {\n      return inner;\n    }\n\n    if (pendingDevices && !selectedOverride) {\n      throw new MultipleDevicesError(pendingDevices);\n    }\n\n    if (!connecting) {\n      const deviceId = selectedOverride ?? explicitDeviceId;\n      connecting = createBackend(deviceId, explicitPlatform)\n        .then((backend) => {\n          inner = backend;\n          pendingDevices = null;\n          return backend;\n        })\n        .catch((error: unknown) => {\n          connecting = null;\n          if (error instanceof MultipleDevicesError) {\n            pendingDevices = error.devices;\n          }\n          throw error;\n        });\n    }\n    return connecting;\n  }\n\n  function screenshot(\n    outputPath?: string,\n    options?: { encode?: true },\n  ): Promise<ScreenshotResult>;\n  function screenshot(\n    outputPath: string | undefined,\n    options: { encode: false },\n  ): Promise<ScreenshotFileResult>;\n  function screenshot(\n    outputPath?: string,\n    options?: ScreenshotOptions,\n  ): Promise<ScreenshotResult | ScreenshotFileResult>;\n  async function screenshot(\n    outputPath?: string,\n    options?: ScreenshotOptions,\n  ): Promise<ScreenshotResult | ScreenshotFileResult> {\n    return (await resolve()).screenshot(outputPath, options);\n  }\n\n  return {\n    get platform(): Platform {\n      return inner?.platform ?? 'ios';\n    },\n\n    selectDevice(deviceId: string): void {\n      selectedOverride = deviceId;\n      inner = null;\n      connecting = null;\n    },\n\n    async listDevices(): Promise<DetectedDevice[]> {\n      if (pendingDevices) {\n        return pendingDevices;\n      }\n      return detectAllDevices(explicitPlatform);\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    screenshot,\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    async getElementText(query: ElementQuery): Promise<string> {\n      return (await resolve()).getElementText(query);\n    },\n  };\n}\n"]}

package/dist/backends/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"","sourcesContent":["export type Platform = 'ios' | 'android';\n\nexport type DeviceInfo = {\n  platform: Platform;\n  deviceId: string;\n  name: string;\n  osVersion: string;\n  state: string;\n};\n\nexport type UIElement = {\n  type: string;\n  label?: string;\n  value?: string;\n  identifier?: string;\n  frame: { x: number; y: number; width: number; height: number };\n  enabled: boolean;\n  children?: UIElement[];\n};\n\nexport type SnapshotResult = {\n  platform: Platform;\n  hierarchy: UIElement[];\n  raw: string;\n  timestamp: number;\n};\n\nexport type TapResult = {\n  success: boolean;\n  x: number;\n  y: number;\n  targetDescription: string;\n};\n\nexport type AppStateResult = {\n  bundleId: string;\n  state: string;\n  pid?: number;\n};\n\nexport type ScreenshotResult = {\n  data: string;\n  format: 'png' | 'jpeg';\n  path?: string;\n};\n\nexport type LogEntry = {\n  timestamp: string;\n  level: string;\n  message: string;\n};\n\nexport type LogsResult = {\n  entries: LogEntry[];\n  source: string;\n};\n\nexport type ElementQuery = {\n  label?: string;\n  identifier?: string;\n  text?: string;\n  type?: string;\n};\n\nexport type DeviceButton = 'home' | 'back' | 'enter' | 'lock';\n\nexport type WindowSize = {\n  width: number;\n  height: number;\n};\n\nexport type DeviceBackend = {\n  readonly platform: Platform;\n\n  getDeviceInfo(): Promise<DeviceInfo>;\n\n  snapshot(): Promise<SnapshotResult>;\n\n  tapElement(query: ElementQuery): Promise<TapResult>;\n\n  tapCoordinates(x: number, y: number): Promise<void>;\n\n  typeText(text: string): Promise<void>;\n\n  swipe(\n    direction: 'up' | 'down' | 'left' | 'right',\n    startX?: number,\n    startY?: number,\n    distance?: number,\n  ): Promise<void>;\n\n  waitForElement(\n    query: ElementQuery,\n    timeoutMs?: number,\n    intervalMs?: number,\n  ): Promise<UIElement>;\n\n  getAppState(bundleId: string): Promise<AppStateResult>;\n\n  screenshot(outputPath?: string): Promise<ScreenshotResult>;\n\n  openApp(bundleId: string): Promise<void>;\n\n  closeApp(bundleId: string): Promise<void>;\n\n  pressButton(button: DeviceButton): Promise<void>;\n\n  dismissKeyboard(): Promise<void>;\n\n  dismissAlert(accept: boolean): Promise<void>;\n\n  getLogs(durationSeconds?: number, filter?: string): Promise<LogsResult>;\n\n  longPress(query: ElementQuery, durationMs?: number): Promise<TapResult>;\n\n  scrollToElement(\n    query: ElementQuery,\n    direction?: 'up' | 'down',\n    maxAttempts?: number,\n  ): Promise<UIElement>;\n\n  getAlertText(): Promise<string>;\n\n  getWindowSize(): Promise<WindowSize>;\n\n  getContexts(): Promise<string[]>;\n\n  setContext(context: string): Promise<void>;\n\n  getClipboard(): Promise<string>;\n\n  setClipboard(text: string): Promise<void>;\n\n  startScreenRecording(outputPath?: string): Promise<void>;\n\n  stopScreenRecording(): Promise<string>;\n};\n"]}
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"","sourcesContent":["export type Platform = 'ios' | 'android';\n\nexport type DeviceInfo = {\n  platform: Platform;\n  deviceId: string;\n  name: string;\n  osVersion: string;\n  state: string;\n};\n\nexport type UIElement = {\n  type: string;\n  label?: string;\n  value?: string;\n  identifier?: string;\n  frame: { x: number; y: number; width: number; height: number };\n  enabled: boolean;\n  children?: UIElement[];\n};\n\nexport type SnapshotResult = {\n  platform: Platform;\n  hierarchy: UIElement[];\n  raw: string;\n  timestamp: number;\n};\n\nexport type TapResult = {\n  success: boolean;\n  x: number;\n  y: number;\n  targetDescription: string;\n};\n\nexport type AppStateResult = {\n  bundleId: string;\n  state: string;\n  pid?: number;\n};\n\nexport type ScreenshotResult = {\n  /** Base64-encoded image data. */\n  data: string;\n  format: 'png' | 'jpeg';\n  /** File path the screenshot was written to, when captured to disk. */\n  path?: string;\n};\n\n/** Result of a screenshot captured with `encode: false`: file `path` only, no base64 `data`. */\nexport type ScreenshotFileResult = {\n  data?: undefined;\n  format: 'png' | 'jpeg';\n  path: string;\n};\n\nexport type ScreenshotOptions = {\n  /** Include base64 image data in the result. Defaults to `true`. */\n  encode?: boolean;\n};\n\nexport type LogEntry = {\n  timestamp: string;\n  level: string;\n  message: string;\n};\n\nexport type LogsResult = {\n  entries: LogEntry[];\n  source: string;\n};\n\nexport type ElementQuery = {\n  label?: string;\n  identifier?: string;\n  text?: string;\n  type?: string;\n};\n\nexport type DeviceButton = 'home' | 'back' | 'enter' | 'lock';\n\nexport type WindowSize = {\n  width: number;\n  height: number;\n};\n\nexport type DeviceBackend = {\n  readonly platform: Platform;\n\n  getDeviceInfo(): Promise<DeviceInfo>;\n\n  snapshot(): Promise<SnapshotResult>;\n\n  tapElement(query: ElementQuery): Promise<TapResult>;\n\n  tapCoordinates(x: number, y: number): Promise<void>;\n\n  typeText(text: string): Promise<void>;\n\n  swipe(\n    direction: 'up' | 'down' | 'left' | 'right',\n    startX?: number,\n    startY?: number,\n    distance?: number,\n  ): Promise<void>;\n\n  waitForElement(\n    query: ElementQuery,\n    timeoutMs?: number,\n    intervalMs?: number,\n  ): Promise<UIElement>;\n\n  getAppState(bundleId: string): Promise<AppStateResult>;\n\n  screenshot(\n    outputPath?: string,\n    options?: { encode?: true },\n  ): Promise<ScreenshotResult>;\n  screenshot(\n    outputPath: string | undefined,\n    options: { encode: false },\n  ): Promise<ScreenshotFileResult>;\n  screenshot(\n    outputPath?: string,\n    options?: ScreenshotOptions,\n  ): Promise<ScreenshotResult | ScreenshotFileResult>;\n\n  openApp(bundleId: string): Promise<void>;\n\n  closeApp(bundleId: string): Promise<void>;\n\n  pressButton(button: DeviceButton): Promise<void>;\n\n  dismissKeyboard(): Promise<void>;\n\n  dismissAlert(accept: boolean): Promise<void>;\n\n  getLogs(durationSeconds?: number, filter?: string): Promise<LogsResult>;\n\n  longPress(query: ElementQuery, durationMs?: number): Promise<TapResult>;\n\n  scrollToElement(\n    query: ElementQuery,\n    direction?: 'up' | 'down',\n    maxAttempts?: number,\n  ): Promise<UIElement>;\n\n  getAlertText(): Promise<string>;\n\n  getWindowSize(): Promise<WindowSize>;\n\n  getContexts(): Promise<string[]>;\n\n  setContext(context: string): Promise<void>;\n\n  getClipboard(): Promise<string>;\n\n  setClipboard(text: string): Promise<void>;\n\n  startScreenRecording(outputPath?: string): Promise<void>;\n\n  stopScreenRecording(): Promise<string>;\n\n  getElementText(query: ElementQuery): Promise<string>;\n};\n"]}

package/dist/backends/types.d.cts

@@ -38,10 +38,22 @@ export type AppStateResult = {
     pid?: number;
 };
 export type ScreenshotResult = {
+    /** Base64-encoded image data. */
     data: string;
     format: 'png' | 'jpeg';
+    /** File path the screenshot was written to, when captured to disk. */
     path?: string;
 };
+/** Result of a screenshot captured with `encode: false`: file `path` only, no base64 `data`. */
+export type ScreenshotFileResult = {
+    data?: undefined;
+    format: 'png' | 'jpeg';
+    path: string;
+};
+export type ScreenshotOptions = {
+    /** Include base64 image data in the result. Defaults to `true`. */
+    encode?: boolean;
+};
 export type LogEntry = {
     timestamp: string;
     level: string;
@@ -72,7 +84,13 @@ export type DeviceBackend = {
     swipe(direction: 'up' | 'down' | 'left' | 'right', startX?: number, startY?: number, distance?: number): Promise<void>;
     waitForElement(query: ElementQuery, timeoutMs?: number, intervalMs?: number): Promise<UIElement>;
     getAppState(bundleId: string): Promise<AppStateResult>;
-    screenshot(outputPath?: string): Promise<ScreenshotResult>;
+    screenshot(outputPath?: string, options?: {
+        encode?: true;
+    }): Promise<ScreenshotResult>;
+    screenshot(outputPath: string | undefined, options: {
+        encode: false;
+    }): Promise<ScreenshotFileResult>;
+    screenshot(outputPath?: string, options?: ScreenshotOptions): Promise<ScreenshotResult | ScreenshotFileResult>;
     openApp(bundleId: string): Promise<void>;
     closeApp(bundleId: string): Promise<void>;
     pressButton(button: DeviceButton): Promise<void>;
@@ -89,5 +107,6 @@ export type DeviceBackend = {
     setClipboard(text: string): Promise<void>;
     startScreenRecording(outputPath?: string): Promise<void>;
     stopScreenRecording(): Promise<string>;
+    getElementText(query: ElementQuery): Promise<string>;
 };
 //# sourceMappingURL=types.d.cts.map

package/dist/backends/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzC,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,gGAAgG;AAChG,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAErC,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAEpC,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEpD,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC,KAAK,CACH,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC3C,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,cAAc,CACZ,KAAK,EAAE,YAAY,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEvD,UAAU,CACR,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAA;KAAE,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7B,UAAU,CACR,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjC,UAAU,CACR,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,GAAG,oBAAoB,CAAC,CAAC;IAEpD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,OAAO,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAExE,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAExE,eAAe,CACb,KAAK,EAAE,YAAY,EACnB,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhC,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAErC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD,CAAC"}

package/dist/backends/types.d.mts

@@ -38,10 +38,22 @@ export type AppStateResult = {
     pid?: number;
 };
 export type ScreenshotResult = {
+    /** Base64-encoded image data. */
     data: string;
     format: 'png' | 'jpeg';
+    /** File path the screenshot was written to, when captured to disk. */
     path?: string;
 };
+/** Result of a screenshot captured with `encode: false`: file `path` only, no base64 `data`. */
+export type ScreenshotFileResult = {
+    data?: undefined;
+    format: 'png' | 'jpeg';
+    path: string;
+};
+export type ScreenshotOptions = {
+    /** Include base64 image data in the result. Defaults to `true`. */
+    encode?: boolean;
+};
 export type LogEntry = {
     timestamp: string;
     level: string;
@@ -72,7 +84,13 @@ export type DeviceBackend = {
     swipe(direction: 'up' | 'down' | 'left' | 'right', startX?: number, startY?: number, distance?: number): Promise<void>;
     waitForElement(query: ElementQuery, timeoutMs?: number, intervalMs?: number): Promise<UIElement>;
     getAppState(bundleId: string): Promise<AppStateResult>;
-    screenshot(outputPath?: string): Promise<ScreenshotResult>;
+    screenshot(outputPath?: string, options?: {
+        encode?: true;
+    }): Promise<ScreenshotResult>;
+    screenshot(outputPath: string | undefined, options: {
+        encode: false;
+    }): Promise<ScreenshotFileResult>;
+    screenshot(outputPath?: string, options?: ScreenshotOptions): Promise<ScreenshotResult | ScreenshotFileResult>;
     openApp(bundleId: string): Promise<void>;
     closeApp(bundleId: string): Promise<void>;
     pressButton(button: DeviceButton): Promise<void>;
@@ -89,5 +107,6 @@ export type DeviceBackend = {
     setClipboard(text: string): Promise<void>;
     startScreenRecording(outputPath?: string): Promise<void>;
     stopScreenRecording(): Promise<string>;
+    getElementText(query: ElementQuery): Promise<string>;
 };
 //# sourceMappingURL=types.d.mts.map

package/dist/backends/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"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"}

package/dist/backends/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"","sourcesContent":["export type Platform = 'ios' | 'android';\n\nexport type DeviceInfo = {\n  platform: Platform;\n  deviceId: string;\n  name: string;\n  osVersion: string;\n  state: string;\n};\n\nexport type UIElement = {\n  type: string;\n  label?: string;\n  value?: string;\n  identifier?: string;\n  frame: { x: number; y: number; width: number; height: number };\n  enabled: boolean;\n  children?: UIElement[];\n};\n\nexport type SnapshotResult = {\n  platform: Platform;\n  hierarchy: UIElement[];\n  raw: string;\n  timestamp: number;\n};\n\nexport type TapResult = {\n  success: boolean;\n  x: number;\n  y: number;\n  targetDescription: string;\n};\n\nexport type AppStateResult = {\n  bundleId: string;\n  state: string;\n  pid?: number;\n};\n\nexport type ScreenshotResult = {\n  data: string;\n  format: 'png' | 'jpeg';\n  path?: string;\n};\n\nexport type LogEntry = {\n  timestamp: string;\n  level: string;\n  message: string;\n};\n\nexport type LogsResult = {\n  entries: LogEntry[];\n  source: string;\n};\n\nexport type ElementQuery = {\n  label?: string;\n  identifier?: string;\n  text?: string;\n  type?: string;\n};\n\nexport type DeviceButton = 'home' | 'back' | 'enter' | 'lock';\n\nexport type WindowSize = {\n  width: number;\n  height: number;\n};\n\nexport type DeviceBackend = {\n  readonly platform: Platform;\n\n  getDeviceInfo(): Promise<DeviceInfo>;\n\n  snapshot(): Promise<SnapshotResult>;\n\n  tapElement(query: ElementQuery): Promise<TapResult>;\n\n  tapCoordinates(x: number, y: number): Promise<void>;\n\n  typeText(text: string): Promise<void>;\n\n  swipe(\n    direction: 'up' | 'down' | 'left' | 'right',\n    startX?: number,\n    startY?: number,\n    distance?: number,\n  ): Promise<void>;\n\n  waitForElement(\n    query: ElementQuery,\n    timeoutMs?: number,\n    intervalMs?: number,\n  ): Promise<UIElement>;\n\n  getAppState(bundleId: string): Promise<AppStateResult>;\n\n  screenshot(outputPath?: string): Promise<ScreenshotResult>;\n\n  openApp(bundleId: string): Promise<void>;\n\n  closeApp(bundleId: string): Promise<void>;\n\n  pressButton(button: DeviceButton): Promise<void>;\n\n  dismissKeyboard(): Promise<void>;\n\n  dismissAlert(accept: boolean): Promise<void>;\n\n  getLogs(durationSeconds?: number, filter?: string): Promise<LogsResult>;\n\n  longPress(query: ElementQuery, durationMs?: number): Promise<TapResult>;\n\n  scrollToElement(\n    query: ElementQuery,\n    direction?: 'up' | 'down',\n    maxAttempts?: number,\n  ): Promise<UIElement>;\n\n  getAlertText(): Promise<string>;\n\n  getWindowSize(): Promise<WindowSize>;\n\n  getContexts(): Promise<string[]>;\n\n  setContext(context: string): Promise<void>;\n\n  getClipboard(): Promise<string>;\n\n  setClipboard(text: string): Promise<void>;\n\n  startScreenRecording(outputPath?: string): Promise<void>;\n\n  stopScreenRecording(): Promise<string>;\n};\n"]}
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"","sourcesContent":["export type Platform = 'ios' | 'android';\n\nexport type DeviceInfo = {\n  platform: Platform;\n  deviceId: string;\n  name: string;\n  osVersion: string;\n  state: string;\n};\n\nexport type UIElement = {\n  type: string;\n  label?: string;\n  value?: string;\n  identifier?: string;\n  frame: { x: number; y: number; width: number; height: number };\n  enabled: boolean;\n  children?: UIElement[];\n};\n\nexport type SnapshotResult = {\n  platform: Platform;\n  hierarchy: UIElement[];\n  raw: string;\n  timestamp: number;\n};\n\nexport type TapResult = {\n  success: boolean;\n  x: number;\n  y: number;\n  targetDescription: string;\n};\n\nexport type AppStateResult = {\n  bundleId: string;\n  state: string;\n  pid?: number;\n};\n\nexport type ScreenshotResult = {\n  /** Base64-encoded image data. */\n  data: string;\n  format: 'png' | 'jpeg';\n  /** File path the screenshot was written to, when captured to disk. */\n  path?: string;\n};\n\n/** Result of a screenshot captured with `encode: false`: file `path` only, no base64 `data`. */\nexport type ScreenshotFileResult = {\n  data?: undefined;\n  format: 'png' | 'jpeg';\n  path: string;\n};\n\nexport type ScreenshotOptions = {\n  /** Include base64 image data in the result. Defaults to `true`. */\n  encode?: boolean;\n};\n\nexport type LogEntry = {\n  timestamp: string;\n  level: string;\n  message: string;\n};\n\nexport type LogsResult = {\n  entries: LogEntry[];\n  source: string;\n};\n\nexport type ElementQuery = {\n  label?: string;\n  identifier?: string;\n  text?: string;\n  type?: string;\n};\n\nexport type DeviceButton = 'home' | 'back' | 'enter' | 'lock';\n\nexport type WindowSize = {\n  width: number;\n  height: number;\n};\n\nexport type DeviceBackend = {\n  readonly platform: Platform;\n\n  getDeviceInfo(): Promise<DeviceInfo>;\n\n  snapshot(): Promise<SnapshotResult>;\n\n  tapElement(query: ElementQuery): Promise<TapResult>;\n\n  tapCoordinates(x: number, y: number): Promise<void>;\n\n  typeText(text: string): Promise<void>;\n\n  swipe(\n    direction: 'up' | 'down' | 'left' | 'right',\n    startX?: number,\n    startY?: number,\n    distance?: number,\n  ): Promise<void>;\n\n  waitForElement(\n    query: ElementQuery,\n    timeoutMs?: number,\n    intervalMs?: number,\n  ): Promise<UIElement>;\n\n  getAppState(bundleId: string): Promise<AppStateResult>;\n\n  screenshot(\n    outputPath?: string,\n    options?: { encode?: true },\n  ): Promise<ScreenshotResult>;\n  screenshot(\n    outputPath: string | undefined,\n    options: { encode: false },\n  ): Promise<ScreenshotFileResult>;\n  screenshot(\n    outputPath?: string,\n    options?: ScreenshotOptions,\n  ): Promise<ScreenshotResult | ScreenshotFileResult>;\n\n  openApp(bundleId: string): Promise<void>;\n\n  closeApp(bundleId: string): Promise<void>;\n\n  pressButton(button: DeviceButton): Promise<void>;\n\n  dismissKeyboard(): Promise<void>;\n\n  dismissAlert(accept: boolean): Promise<void>;\n\n  getLogs(durationSeconds?: number, filter?: string): Promise<LogsResult>;\n\n  longPress(query: ElementQuery, durationMs?: number): Promise<TapResult>;\n\n  scrollToElement(\n    query: ElementQuery,\n    direction?: 'up' | 'down',\n    maxAttempts?: number,\n  ): Promise<UIElement>;\n\n  getAlertText(): Promise<string>;\n\n  getWindowSize(): Promise<WindowSize>;\n\n  getContexts(): Promise<string[]>;\n\n  setContext(context: string): Promise<void>;\n\n  getClipboard(): Promise<string>;\n\n  setClipboard(text: string): Promise<void>;\n\n  startScreenRecording(outputPath?: string): Promise<void>;\n\n  stopScreenRecording(): Promise<string>;\n\n  getElementText(query: ElementQuery): Promise<string>;\n};\n"]}

package/dist/cli/device-mcp.cjs

@@ -6,8 +6,17 @@ const index_js_1 = require("../backends/index.cjs");
 const server_js_1 = require("../server.cjs");
 async function main() {
     const deviceId = process.env.DEVICE_ID;
-    console.error(`@metamask/device-mcp starting...${deviceId ? ` (DEVICE_ID=${deviceId})` : ' (auto-detect)'}`);
-    const backend = (0, index_js_1.createLazyBackend)(deviceId);
+    const devicePlatform = process.env.DEVICE_PLATFORM;
+    const parts = [];
+    if (deviceId) {
+        parts.push(`DEVICE_ID=${deviceId}`);
+    }
+    if (devicePlatform) {
+        parts.push(`DEVICE_PLATFORM=${devicePlatform}`);
+    }
+    const suffix = parts.length > 0 ? ` (${parts.join(', ')})` : ' (auto-detect)';
+    console.error(`@metamask/device-mcp starting...${suffix}`);
+    const backend = (0, index_js_1.createLazyBackend)(deviceId, devicePlatform);
     const server = (0, server_js_1.createMcpServer)(backend);
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);

package/dist/cli/device-mcp.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"device-mcp.cjs","sourceRoot":"","sources":["../../src/cli/device-mcp.ts"],"names":[],"mappings":";;;AACA,wEAAiF;AAEjF,oDAAyD;AACzD,6CAA+C;AAE/C,KAAK,UAAU,IAAI;IACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAEvC,OAAO,CAAC,KAAK,CACX,mCAAmC,QAAQ,CAAC,CAAC,CAAC,eAAe,QAAQ,GAAG,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAC9F,CAAC;IAEF,MAAM,OAAO,GAAG,IAAA,4BAAiB,EAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAA,2BAAe,EAAC,OAAO,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\n\nimport { createLazyBackend } from '../backends/index.js';\nimport { createMcpServer } from '../server.js';\n\nasync function main(): Promise<void> {\n  const deviceId = process.env.DEVICE_ID;\n\n  console.error(\n    `@metamask/device-mcp starting...${deviceId ? ` (DEVICE_ID=${deviceId})` : ' (auto-detect)'}`,\n  );\n\n  const backend = createLazyBackend(deviceId);\n  const server = createMcpServer(backend);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  console.error('@metamask/device-mcp ready on stdio');\n}\n\nmain().catch((error: unknown) => {\n  console.error('Fatal:', error);\n  process.exit(1);\n});\n"]}
+{"version":3,"file":"device-mcp.cjs","sourceRoot":"","sources":["../../src/cli/device-mcp.ts"],"names":[],"mappings":";;;AACA,wEAAiF;AAEjF,oDAAyD;AAEzD,6CAA+C;AAE/C,KAAK,UAAU,IAAI;IACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IACvC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,eAAuC,CAAC;IAE3E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,mBAAmB,cAAc,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC9E,OAAO,CAAC,KAAK,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC;IAE3D,MAAM,OAAO,GAAG,IAAA,4BAAiB,EAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,IAAA,2BAAe,EAAC,OAAO,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\n\nimport { createLazyBackend } from '../backends/index.js';\nimport type { Platform } from '../backends/types.js';\nimport { createMcpServer } from '../server.js';\n\nasync function main(): Promise<void> {\n  const deviceId = process.env.DEVICE_ID;\n  const devicePlatform = process.env.DEVICE_PLATFORM as Platform | undefined;\n\n  const parts: string[] = [];\n  if (deviceId) {\n    parts.push(`DEVICE_ID=${deviceId}`);\n  }\n  if (devicePlatform) {\n    parts.push(`DEVICE_PLATFORM=${devicePlatform}`);\n  }\n  const suffix = parts.length > 0 ? ` (${parts.join(', ')})` : ' (auto-detect)';\n  console.error(`@metamask/device-mcp starting...${suffix}`);\n\n  const backend = createLazyBackend(deviceId, devicePlatform);\n  const server = createMcpServer(backend);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  console.error('@metamask/device-mcp ready on stdio');\n}\n\nmain().catch((error: unknown) => {\n  console.error('Fatal:', error);\n  process.exit(1);\n});\n"]}

package/dist/cli/device-mcp.mjs

@@ -4,8 +4,17 @@ import { createLazyBackend } from "../backends/index.mjs";
 import { createMcpServer } from "../server.mjs";
 async function main() {
     const deviceId = process.env.DEVICE_ID;
-    console.error(`@metamask/device-mcp starting...${deviceId ? ` (DEVICE_ID=${deviceId})` : ' (auto-detect)'}`);
-    const backend = createLazyBackend(deviceId);
+    const devicePlatform = process.env.DEVICE_PLATFORM;
+    const parts = [];
+    if (deviceId) {
+        parts.push(`DEVICE_ID=${deviceId}`);
+    }
+    if (devicePlatform) {
+        parts.push(`DEVICE_PLATFORM=${devicePlatform}`);
+    }
+    const suffix = parts.length > 0 ? ` (${parts.join(', ')})` : ' (auto-detect)';
+    console.error(`@metamask/device-mcp starting...${suffix}`);
+    const backend = createLazyBackend(deviceId, devicePlatform);
     const server = createMcpServer(backend);
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/cli/device-mcp.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"device-mcp.mjs","sourceRoot":"","sources":["../../src/cli/device-mcp.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,kDAAkD;AAEjF,OAAO,EAAE,iBAAiB,EAAE,8BAA6B;AACzD,OAAO,EAAE,eAAe,EAAE,sBAAqB;AAE/C,KAAK,UAAU,IAAI;IACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAEvC,OAAO,CAAC,KAAK,CACX,mCAAmC,QAAQ,CAAC,CAAC,CAAC,eAAe,QAAQ,GAAG,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAC9F,CAAC;IAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\n\nimport { createLazyBackend } from '../backends/index.js';\nimport { createMcpServer } from '../server.js';\n\nasync function main(): Promise<void> {\n  const deviceId = process.env.DEVICE_ID;\n\n  console.error(\n    `@metamask/device-mcp starting...${deviceId ? ` (DEVICE_ID=${deviceId})` : ' (auto-detect)'}`,\n  );\n\n  const backend = createLazyBackend(deviceId);\n  const server = createMcpServer(backend);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  console.error('@metamask/device-mcp ready on stdio');\n}\n\nmain().catch((error: unknown) => {\n  console.error('Fatal:', error);\n  process.exit(1);\n});\n"]}
+{"version":3,"file":"device-mcp.mjs","sourceRoot":"","sources":["../../src/cli/device-mcp.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,kDAAkD;AAEjF,OAAO,EAAE,iBAAiB,EAAE,8BAA6B;AAEzD,OAAO,EAAE,eAAe,EAAE,sBAAqB;AAE/C,KAAK,UAAU,IAAI;IACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IACvC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,eAAuC,CAAC;IAE3E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,mBAAmB,cAAc,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC9E,OAAO,CAAC,KAAK,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC;IAE3D,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\n\nimport { createLazyBackend } from '../backends/index.js';\nimport type { Platform } from '../backends/types.js';\nimport { createMcpServer } from '../server.js';\n\nasync function main(): Promise<void> {\n  const deviceId = process.env.DEVICE_ID;\n  const devicePlatform = process.env.DEVICE_PLATFORM as Platform | undefined;\n\n  const parts: string[] = [];\n  if (deviceId) {\n    parts.push(`DEVICE_ID=${deviceId}`);\n  }\n  if (devicePlatform) {\n    parts.push(`DEVICE_PLATFORM=${devicePlatform}`);\n  }\n  const suffix = parts.length > 0 ? ` (${parts.join(', ')})` : ' (auto-detect)';\n  console.error(`@metamask/device-mcp starting...${suffix}`);\n\n  const backend = createLazyBackend(deviceId, devicePlatform);\n  const server = createMcpServer(backend);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  console.error('@metamask/device-mcp ready on stdio');\n}\n\nmain().catch((error: unknown) => {\n  console.error('Fatal:', error);\n  process.exit(1);\n});\n"]}