@metamask/device-mcp 0.1.0

package/dist/backends/index.d.cts

@@ -0,0 +1,16 @@
+import type { DeviceBackend } from "./types.cjs";
+export type { DeviceBackend } from "./types.cjs";
+export { AdbBackend } from "./adb-backend.cjs";
+export { AppiumBackend } from "./appium-backend.cjs";
+export { IdbBackend } from "./idb-backend.cjs";
+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;
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","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"}

package/dist/backends/index.d.mts

@@ -0,0 +1,16 @@
+import type { DeviceBackend } from "./types.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;
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +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"}

package/dist/backends/index.mjs

@@ -0,0 +1,126 @@
+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";
+export { AdbBackend } from "./adb-backend.mjs";
+export { AppiumBackend } from "./appium-backend.mjs";
+export { IdbBackend } from "./idb-backend.mjs";
+export async function createBackend(explicitDeviceId) {
+    const sessionConfig = await readSessionFile();
+    if (sessionConfig) {
+        console.error(`Found .device-session (${sessionConfig.mode}, ${sessionConfig.platform})`);
+        const backend = new AppiumBackend(sessionConfig);
+        await backend.ensureConnected();
+        return backend;
+    }
+    const { platform, deviceId } = await detectPlatform(explicitDeviceId);
+    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) {
+    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.mjs.map

package/dist/backends/index.mjs.map

@@ -0,0 +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"]}

package/dist/backends/session-file.cjs

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSessionFile = readSessionFile;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const SESSION_FILE_NAME = '.device-session';
+async function readSessionFile(searchDir) {
+    const dir = searchDir ?? process.cwd();
+    const filePath = (0, node_path_1.resolve)(dir, SESSION_FILE_NAME);
+    try {
+        const raw = await (0, promises_1.readFile)(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return validateSessionConfig(parsed);
+    }
+    catch {
+        return null;
+    }
+}
+function validateSessionConfig(raw) {
+    const appiumUrl = requireString(raw, 'appiumUrl');
+    const platform = requirePlatform(raw);
+    const auth = raw.auth && typeof raw.auth === 'object'
+        ? {
+            user: requireString(raw.auth, 'user'),
+            key: requireString(raw.auth, 'key'),
+        }
+        : undefined;
+    if (typeof raw.sessionId === 'string' && raw.sessionId.length > 0) {
+        return {
+            mode: 'attach',
+            appiumUrl,
+            sessionId: raw.sessionId,
+            platform,
+            auth,
+        };
+    }
+    if (raw.capabilities && typeof raw.capabilities === 'object') {
+        return {
+            mode: 'create',
+            appiumUrl,
+            platform,
+            capabilities: raw.capabilities,
+            auth,
+        };
+    }
+    throw new Error('.device-session must contain either "sessionId" (attach) or "capabilities" (create)');
+}
+function requireString(obj, field) {
+    const value = obj[field];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`.device-session: "${field}" must be a non-empty string`);
+    }
+    return value;
+}
+function requirePlatform(obj) {
+    const value = obj.platform;
+    if (value !== 'ios' && value !== 'android') {
+        throw new Error('.device-session: "platform" must be "ios" or "android"');
+    }
+    return value;
+}
+//# sourceMappingURL=session-file.cjs.map

package/dist/backends/session-file.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file.cjs","sourceRoot":"","sources":["../../src/backends/session-file.ts"],"names":[],"mappings":";;AA+BA,0CAaC;AA5CD,+CAA4C;AAC5C,yCAAoC;AA4BpC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAErC,KAAK,UAAU,eAAe,CACnC,SAAkB;IAElB,MAAM,GAAG,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAA,mBAAO,EAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QAC1D,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,GAA4B;IACzD,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAEtC,MAAM,IAAI,GACR,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QACtC,CAAC,CAAC;YACE,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,IAA+B,EAAE,MAAM,CAAC;YAChE,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,IAA+B,EAAE,KAAK,CAAC;SAC/D;QACH,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,SAAS;YACT,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ;YACR,IAAI;SACL,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,YAAY,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,SAAS;YACT,QAAQ;YACR,YAAY,EAAE,GAAG,CAAC,YAAuC;YACzD,IAAI;SACL,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CACb,qFAAqF,CACtF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,GAA4B,EAAE,KAAa;IAChE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,8BAA8B,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,GAA4B;IACnD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC3B,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { resolve } from 'node:path';\n\nimport type { Platform } from './types.js';\n\nexport type SessionConfig = AttachSessionConfig | CreateSessionConfig;\n\nexport type AttachSessionConfig = {\n  mode: 'attach';\n  appiumUrl: string;\n  sessionId: string;\n  platform: Platform;\n  auth?: {\n    user: string;\n    key: string;\n  };\n};\n\nexport type CreateSessionConfig = {\n  mode: 'create';\n  appiumUrl: string;\n  platform: Platform;\n  capabilities: Record<string, unknown>;\n  auth?: {\n    user: string;\n    key: string;\n  };\n};\n\nconst SESSION_FILE_NAME = '.device-session';\n\nexport async function readSessionFile(\n  searchDir?: string,\n): Promise<SessionConfig | null> {\n  const dir = searchDir ?? process.cwd();\n  const filePath = resolve(dir, SESSION_FILE_NAME);\n\n  try {\n    const raw = await readFile(filePath, 'utf-8');\n    const parsed = JSON.parse(raw) as Record<string, unknown>;\n    return validateSessionConfig(parsed);\n  } catch {\n    return null;\n  }\n}\n\nfunction validateSessionConfig(raw: Record<string, unknown>): SessionConfig {\n  const appiumUrl = requireString(raw, 'appiumUrl');\n  const platform = requirePlatform(raw);\n\n  const auth =\n    raw.auth && typeof raw.auth === 'object'\n      ? {\n          user: requireString(raw.auth as Record<string, unknown>, 'user'),\n          key: requireString(raw.auth as Record<string, unknown>, 'key'),\n        }\n      : undefined;\n\n  if (typeof raw.sessionId === 'string' && raw.sessionId.length > 0) {\n    return {\n      mode: 'attach',\n      appiumUrl,\n      sessionId: raw.sessionId,\n      platform,\n      auth,\n    };\n  }\n\n  if (raw.capabilities && typeof raw.capabilities === 'object') {\n    return {\n      mode: 'create',\n      appiumUrl,\n      platform,\n      capabilities: raw.capabilities as Record<string, unknown>,\n      auth,\n    };\n  }\n\n  throw new Error(\n    '.device-session must contain either \"sessionId\" (attach) or \"capabilities\" (create)',\n  );\n}\n\nfunction requireString(obj: Record<string, unknown>, field: string): string {\n  const value = obj[field];\n  if (typeof value !== 'string' || value.length === 0) {\n    throw new Error(`.device-session: \"${field}\" must be a non-empty string`);\n  }\n  return value;\n}\n\nfunction requirePlatform(obj: Record<string, unknown>): Platform {\n  const value = obj.platform;\n  if (value !== 'ios' && value !== 'android') {\n    throw new Error('.device-session: \"platform\" must be \"ios\" or \"android\"');\n  }\n  return value;\n}\n"]}

package/dist/backends/session-file.d.cts

@@ -0,0 +1,24 @@
+import type { Platform } from "./types.cjs";
+export type SessionConfig = AttachSessionConfig | CreateSessionConfig;
+export type AttachSessionConfig = {
+    mode: 'attach';
+    appiumUrl: string;
+    sessionId: string;
+    platform: Platform;
+    auth?: {
+        user: string;
+        key: string;
+    };
+};
+export type CreateSessionConfig = {
+    mode: 'create';
+    appiumUrl: string;
+    platform: Platform;
+    capabilities: Record<string, unknown>;
+    auth?: {
+        user: string;
+        key: string;
+    };
+};
+export declare function readSessionFile(searchDir?: string): Promise<SessionConfig | null>;
+//# sourceMappingURL=session-file.d.cts.map

package/dist/backends/session-file.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file.d.cts","sourceRoot":"","sources":["../../src/backends/session-file.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAmB;AAE3C,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAEtE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH,CAAC;AAIF,wBAAsB,eAAe,CACnC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAW/B"}

package/dist/backends/session-file.d.mts

@@ -0,0 +1,24 @@
+import type { Platform } from "./types.mjs";
+export type SessionConfig = AttachSessionConfig | CreateSessionConfig;
+export type AttachSessionConfig = {
+    mode: 'attach';
+    appiumUrl: string;
+    sessionId: string;
+    platform: Platform;
+    auth?: {
+        user: string;
+        key: string;
+    };
+};
+export type CreateSessionConfig = {
+    mode: 'create';
+    appiumUrl: string;
+    platform: Platform;
+    capabilities: Record<string, unknown>;
+    auth?: {
+        user: string;
+        key: string;
+    };
+};
+export declare function readSessionFile(searchDir?: string): Promise<SessionConfig | null>;
+//# sourceMappingURL=session-file.d.mts.map

package/dist/backends/session-file.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file.d.mts","sourceRoot":"","sources":["../../src/backends/session-file.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAmB;AAE3C,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAEtE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH,CAAC;AAIF,wBAAsB,eAAe,CACnC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAW/B"}

package/dist/backends/session-file.mjs

@@ -0,0 +1,59 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+const SESSION_FILE_NAME = '.device-session';
+export async function readSessionFile(searchDir) {
+    const dir = searchDir ?? process.cwd();
+    const filePath = resolve(dir, SESSION_FILE_NAME);
+    try {
+        const raw = await readFile(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return validateSessionConfig(parsed);
+    }
+    catch {
+        return null;
+    }
+}
+function validateSessionConfig(raw) {
+    const appiumUrl = requireString(raw, 'appiumUrl');
+    const platform = requirePlatform(raw);
+    const auth = raw.auth && typeof raw.auth === 'object'
+        ? {
+            user: requireString(raw.auth, 'user'),
+            key: requireString(raw.auth, 'key'),
+        }
+        : undefined;
+    if (typeof raw.sessionId === 'string' && raw.sessionId.length > 0) {
+        return {
+            mode: 'attach',
+            appiumUrl,
+            sessionId: raw.sessionId,
+            platform,
+            auth,
+        };
+    }
+    if (raw.capabilities && typeof raw.capabilities === 'object') {
+        return {
+            mode: 'create',
+            appiumUrl,
+            platform,
+            capabilities: raw.capabilities,
+            auth,
+        };
+    }
+    throw new Error('.device-session must contain either "sessionId" (attach) or "capabilities" (create)');
+}
+function requireString(obj, field) {
+    const value = obj[field];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`.device-session: "${field}" must be a non-empty string`);
+    }
+    return value;
+}
+function requirePlatform(obj) {
+    const value = obj.platform;
+    if (value !== 'ios' && value !== 'android') {
+        throw new Error('.device-session: "platform" must be "ios" or "android"');
+    }
+    return value;
+}
+//# sourceMappingURL=session-file.mjs.map

package/dist/backends/session-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file.mjs","sourceRoot":"","sources":["../../src/backends/session-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,yBAAyB;AAC5C,OAAO,EAAE,OAAO,EAAE,kBAAkB;AA4BpC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAkB;IAElB,MAAM,GAAG,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QAC1D,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,GAA4B;IACzD,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAEtC,MAAM,IAAI,GACR,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QACtC,CAAC,CAAC;YACE,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,IAA+B,EAAE,MAAM,CAAC;YAChE,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,IAA+B,EAAE,KAAK,CAAC;SAC/D;QACH,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,SAAS;YACT,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ;YACR,IAAI;SACL,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,YAAY,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,SAAS;YACT,QAAQ;YACR,YAAY,EAAE,GAAG,CAAC,YAAuC;YACzD,IAAI;SACL,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CACb,qFAAqF,CACtF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,GAA4B,EAAE,KAAa;IAChE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,8BAA8B,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,GAA4B;IACnD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC3B,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { resolve } from 'node:path';\n\nimport type { Platform } from './types.js';\n\nexport type SessionConfig = AttachSessionConfig | CreateSessionConfig;\n\nexport type AttachSessionConfig = {\n  mode: 'attach';\n  appiumUrl: string;\n  sessionId: string;\n  platform: Platform;\n  auth?: {\n    user: string;\n    key: string;\n  };\n};\n\nexport type CreateSessionConfig = {\n  mode: 'create';\n  appiumUrl: string;\n  platform: Platform;\n  capabilities: Record<string, unknown>;\n  auth?: {\n    user: string;\n    key: string;\n  };\n};\n\nconst SESSION_FILE_NAME = '.device-session';\n\nexport async function readSessionFile(\n  searchDir?: string,\n): Promise<SessionConfig | null> {\n  const dir = searchDir ?? process.cwd();\n  const filePath = resolve(dir, SESSION_FILE_NAME);\n\n  try {\n    const raw = await readFile(filePath, 'utf-8');\n    const parsed = JSON.parse(raw) as Record<string, unknown>;\n    return validateSessionConfig(parsed);\n  } catch {\n    return null;\n  }\n}\n\nfunction validateSessionConfig(raw: Record<string, unknown>): SessionConfig {\n  const appiumUrl = requireString(raw, 'appiumUrl');\n  const platform = requirePlatform(raw);\n\n  const auth =\n    raw.auth && typeof raw.auth === 'object'\n      ? {\n          user: requireString(raw.auth as Record<string, unknown>, 'user'),\n          key: requireString(raw.auth as Record<string, unknown>, 'key'),\n        }\n      : undefined;\n\n  if (typeof raw.sessionId === 'string' && raw.sessionId.length > 0) {\n    return {\n      mode: 'attach',\n      appiumUrl,\n      sessionId: raw.sessionId,\n      platform,\n      auth,\n    };\n  }\n\n  if (raw.capabilities && typeof raw.capabilities === 'object') {\n    return {\n      mode: 'create',\n      appiumUrl,\n      platform,\n      capabilities: raw.capabilities as Record<string, unknown>,\n      auth,\n    };\n  }\n\n  throw new Error(\n    '.device-session must contain either \"sessionId\" (attach) or \"capabilities\" (create)',\n  );\n}\n\nfunction requireString(obj: Record<string, unknown>, field: string): string {\n  const value = obj[field];\n  if (typeof value !== 'string' || value.length === 0) {\n    throw new Error(`.device-session: \"${field}\" must be a non-empty string`);\n  }\n  return value;\n}\n\nfunction requirePlatform(obj: Record<string, unknown>): Platform {\n  const value = obj.platform;\n  if (value !== 'ios' && value !== 'android') {\n    throw new Error('.device-session: \"platform\" must be \"ios\" or \"android\"');\n  }\n  return value;\n}\n"]}

package/dist/backends/types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.cjs.map

package/dist/backends/types.cjs.map

@@ -0,0 +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"]}

package/dist/backends/types.d.cts

@@ -0,0 +1,93 @@
+export type Platform = 'ios' | 'android';
+export type DeviceInfo = {
+    platform: Platform;
+    deviceId: string;
+    name: string;
+    osVersion: string;
+    state: string;
+};
+export type UIElement = {
+    type: string;
+    label?: string;
+    value?: string;
+    identifier?: string;
+    frame: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    enabled: boolean;
+    children?: UIElement[];
+};
+export type SnapshotResult = {
+    platform: Platform;
+    hierarchy: UIElement[];
+    raw: string;
+    timestamp: number;
+};
+export type TapResult = {
+    success: boolean;
+    x: number;
+    y: number;
+    targetDescription: string;
+};
+export type AppStateResult = {
+    bundleId: string;
+    state: string;
+    pid?: number;
+};
+export type ScreenshotResult = {
+    data: string;
+    format: 'png' | 'jpeg';
+    path?: string;
+};
+export type LogEntry = {
+    timestamp: string;
+    level: string;
+    message: string;
+};
+export type LogsResult = {
+    entries: LogEntry[];
+    source: string;
+};
+export type ElementQuery = {
+    label?: string;
+    identifier?: string;
+    text?: string;
+    type?: string;
+};
+export type DeviceButton = 'home' | 'back' | 'enter' | 'lock';
+export type WindowSize = {
+    width: number;
+    height: number;
+};
+export type DeviceBackend = {
+    readonly platform: Platform;
+    getDeviceInfo(): Promise<DeviceInfo>;
+    snapshot(): Promise<SnapshotResult>;
+    tapElement(query: ElementQuery): Promise<TapResult>;
+    tapCoordinates(x: number, y: number): Promise<void>;
+    typeText(text: string): Promise<void>;
+    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>;
+    openApp(bundleId: string): Promise<void>;
+    closeApp(bundleId: string): Promise<void>;
+    pressButton(button: DeviceButton): Promise<void>;
+    dismissKeyboard(): Promise<void>;
+    dismissAlert(accept: boolean): Promise<void>;
+    getLogs(durationSeconds?: number, filter?: string): Promise<LogsResult>;
+    longPress(query: ElementQuery, durationMs?: number): Promise<TapResult>;
+    scrollToElement(query: ElementQuery, direction?: 'up' | 'down', maxAttempts?: number): Promise<UIElement>;
+    getAlertText(): Promise<string>;
+    getWindowSize(): Promise<WindowSize>;
+    getContexts(): Promise<string[]>;
+    setContext(context: string): Promise<void>;
+    getClipboard(): Promise<string>;
+    setClipboard(text: string): Promise<void>;
+    startScreenRecording(outputPath?: string): Promise<void>;
+    stopScreenRecording(): Promise<string>;
+};
+//# sourceMappingURL=types.d.cts.map

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

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

package/dist/backends/types.d.mts

@@ -0,0 +1,93 @@
+export type Platform = 'ios' | 'android';
+export type DeviceInfo = {
+    platform: Platform;
+    deviceId: string;
+    name: string;
+    osVersion: string;
+    state: string;
+};
+export type UIElement = {
+    type: string;
+    label?: string;
+    value?: string;
+    identifier?: string;
+    frame: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    enabled: boolean;
+    children?: UIElement[];
+};
+export type SnapshotResult = {
+    platform: Platform;
+    hierarchy: UIElement[];
+    raw: string;
+    timestamp: number;
+};
+export type TapResult = {
+    success: boolean;
+    x: number;
+    y: number;
+    targetDescription: string;
+};
+export type AppStateResult = {
+    bundleId: string;
+    state: string;
+    pid?: number;
+};
+export type ScreenshotResult = {
+    data: string;
+    format: 'png' | 'jpeg';
+    path?: string;
+};
+export type LogEntry = {
+    timestamp: string;
+    level: string;
+    message: string;
+};
+export type LogsResult = {
+    entries: LogEntry[];
+    source: string;
+};
+export type ElementQuery = {
+    label?: string;
+    identifier?: string;
+    text?: string;
+    type?: string;
+};
+export type DeviceButton = 'home' | 'back' | 'enter' | 'lock';
+export type WindowSize = {
+    width: number;
+    height: number;
+};
+export type DeviceBackend = {
+    readonly platform: Platform;
+    getDeviceInfo(): Promise<DeviceInfo>;
+    snapshot(): Promise<SnapshotResult>;
+    tapElement(query: ElementQuery): Promise<TapResult>;
+    tapCoordinates(x: number, y: number): Promise<void>;
+    typeText(text: string): Promise<void>;
+    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>;
+    openApp(bundleId: string): Promise<void>;
+    closeApp(bundleId: string): Promise<void>;
+    pressButton(button: DeviceButton): Promise<void>;
+    dismissKeyboard(): Promise<void>;
+    dismissAlert(accept: boolean): Promise<void>;
+    getLogs(durationSeconds?: number, filter?: string): Promise<LogsResult>;
+    longPress(query: ElementQuery, durationMs?: number): Promise<TapResult>;
+    scrollToElement(query: ElementQuery, direction?: 'up' | 'down', maxAttempts?: number): Promise<UIElement>;
+    getAlertText(): Promise<string>;
+    getWindowSize(): Promise<WindowSize>;
+    getContexts(): Promise<string[]>;
+    setContext(context: string): Promise<void>;
+    getClipboard(): Promise<string>;
+    setClipboard(text: string): Promise<void>;
+    startScreenRecording(outputPath?: string): Promise<void>;
+    stopScreenRecording(): Promise<string>;
+};
+//# sourceMappingURL=types.d.mts.map

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

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

package/dist/backends/types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.mjs.map

package/dist/backends/types.mjs.map

@@ -0,0 +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"]}