@metamask/device-mcp 0.1.0

package/dist/backends/adb-backend.cjs

@@ -0,0 +1,442 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _AdbBackend_instances, _AdbBackend_serial, _AdbBackend_recordingProcess, _AdbBackend_recordingPath, _AdbBackend_recordingRemotePath, _AdbBackend_adb, _AdbBackend_dumpUiHierarchy;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdbBackend = void 0;
+exports.parseAndroidHierarchy = parseAndroidHierarchy;
+exports.parseNodeAttributes = parseNodeAttributes;
+const node_child_process_1 = require("node:child_process");
+const alert_labels_js_1 = require("../utils/alert-labels.cjs");
+const element_js_1 = require("../utils/element.cjs");
+const exec_js_1 = require("../utils/exec.cjs");
+class AdbBackend {
+    constructor(serial) {
+        _AdbBackend_instances.add(this);
+        this.platform = 'android';
+        _AdbBackend_serial.set(this, void 0);
+        _AdbBackend_recordingProcess.set(this, null);
+        _AdbBackend_recordingPath.set(this, null);
+        _AdbBackend_recordingRemotePath.set(this, '/sdcard/device-mcp-recording.mp4');
+        __classPrivateFieldSet(this, _AdbBackend_serial, serial, "f");
+    }
+    async ensureConnected() {
+        if (!(await (0, exec_js_1.isCommandAvailable)('adb'))) {
+            throw new Error('adb is not installed or not on $PATH.\n' +
+                'Install Android SDK platform-tools.');
+        }
+        const state = await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['get-state']);
+        if (state.trim() !== 'device') {
+            throw new Error(`Device ${__classPrivateFieldGet(this, _AdbBackend_serial, "f")} is not ready (state: ${state.trim()})`);
+        }
+    }
+    async getDeviceInfo() {
+        const [model, version] = await Promise.all([
+            __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'getprop', 'ro.product.model']),
+            __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'getprop', 'ro.build.version.release']),
+        ]);
+        return {
+            platform: 'android',
+            deviceId: __classPrivateFieldGet(this, _AdbBackend_serial, "f"),
+            name: model.trim(),
+            osVersion: version.trim(),
+            state: 'device',
+        };
+    }
+    async snapshot() {
+        const raw = await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_dumpUiHierarchy).call(this);
+        const hierarchy = parseAndroidHierarchy(raw);
+        return {
+            platform: 'android',
+            hierarchy,
+            raw,
+            timestamp: Date.now(),
+        };
+    }
+    async tapElement(query) {
+        const snapshot = await this.snapshot();
+        const element = (0, element_js_1.findElement)(snapshot.hierarchy, query);
+        if (!element) {
+            throw new Error(`Element not found: ${JSON.stringify(query)}\n` +
+                'Use device_snapshot to inspect the current UI hierarchy.');
+        }
+        const x = Math.round(element.frame.x + element.frame.width / 2);
+        const y = Math.round(element.frame.y + element.frame.height / 2);
+        await this.tapCoordinates(x, y);
+        return {
+            success: true,
+            x,
+            y,
+            targetDescription: (0, element_js_1.describeElement)(element),
+        };
+    }
+    async tapCoordinates(x, y) {
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'input', 'tap', String(x), String(y)]);
+    }
+    async typeText(text) {
+        // Android keyevent 29+shift = Ctrl+A (select all), 67 = DEL
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'input', 'keyevent', 'KEYCODE_MOVE_HOME']);
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, [
+            'shell',
+            'input',
+            'keyevent',
+            '--longpress',
+            'KEYCODE_SHIFT_LEFT',
+            'KEYCODE_MOVE_END',
+        ]);
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'input', 'keyevent', '67']);
+        // Android input text requires escaping spaces and special chars
+        const escaped = text.replace(/ /gu, '%s').replace(/[&|;<>]/gu, '\\$&');
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'input', 'text', escaped]);
+    }
+    async swipe(direction, startX, startY, distance) {
+        const d = distance ?? 500;
+        const sx = startX ?? 540;
+        const sy = startY ?? 960;
+        const [endX, endY] = (0, element_js_1.computeSwipeEnd)(sx, sy, direction, d);
+        const durationMs = 300;
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, [
+            'shell',
+            'input',
+            'swipe',
+            String(sx),
+            String(sy),
+            String(endX),
+            String(endY),
+            String(durationMs),
+        ]);
+    }
+    async waitForElement(query, timeoutMs = 10000, intervalMs = 500) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const snapshot = await this.snapshot();
+            const element = (0, element_js_1.findElement)(snapshot.hierarchy, query);
+            if (element) {
+                return element;
+            }
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        }
+        throw new Error(`Timed out waiting for element: ${JSON.stringify(query)} (${timeoutMs}ms)`);
+    }
+    async getAppState(bundleId) {
+        const raw = await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'dumpsys', 'activity', 'processes']);
+        const pidMatch = raw.match(new RegExp(`PID #(\\d+):.*${bundleId.replace(/\./gu, '\\.')}`, 'u'));
+        if (pidMatch) {
+            return {
+                bundleId,
+                state: 'Running',
+                pid: parseInt(pidMatch[1], 10),
+            };
+        }
+        const pmResult = await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, [
+            'shell',
+            'pm',
+            'list',
+            'packages',
+            bundleId,
+        ]);
+        if (pmResult.includes(bundleId)) {
+            return { bundleId, state: 'Installed (not running)' };
+        }
+        return { bundleId, state: 'Not Installed' };
+    }
+    async screenshot(outputPath) {
+        const localPath = outputPath ?? `/tmp/device-mcp-screenshot-${Date.now()}.png`;
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'screencap', '-p', '/sdcard/screenshot.png']);
+        await (0, exec_js_1.execStrict)('adb', [
+            '-s',
+            __classPrivateFieldGet(this, _AdbBackend_serial, "f"),
+            'pull',
+            '/sdcard/screenshot.png',
+            localPath,
+        ]);
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'rm', '-f', '/sdcard/screenshot.png']);
+        const data = await (0, exec_js_1.execStrict)('base64', [localPath]);
+        return { data: data.trim(), format: 'png', path: localPath };
+    }
+    async openApp(bundleId) {
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, [
+            'shell',
+            'monkey',
+            '-p',
+            bundleId,
+            '-c',
+            'android.intent.category.LAUNCHER',
+            '1',
+        ]);
+    }
+    async closeApp(bundleId) {
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'am', 'force-stop', bundleId]);
+    }
+    async pressButton(button) {
+        // Android keyevent codes
+        const keyMap = {
+            home: '3',
+            back: '4',
+            enter: '66',
+            lock: '26',
+        };
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'input', 'keyevent', keyMap[button]]);
+    }
+    async dismissKeyboard() {
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'input', 'keyevent', '111']);
+    }
+    async dismissAlert(accept) {
+        const snap = await this.snapshot();
+        const candidates = accept ? alert_labels_js_1.ACCEPT_LABELS : alert_labels_js_1.DENY_LABELS;
+        for (const label of candidates) {
+            const element = (0, element_js_1.findElement)(snap.hierarchy, { text: label });
+            if (element) {
+                const cx = Math.round(element.frame.x + element.frame.width / 2);
+                const cy = Math.round(element.frame.y + element.frame.height / 2);
+                await this.tapCoordinates(cx, cy);
+                return;
+            }
+        }
+        throw new Error(`No alert button found. Tried: ${candidates.join(', ')}`);
+    }
+    async getLogs(durationSeconds = 30, filter) {
+        const args = ['shell', 'logcat', '-d', '-t', String(durationSeconds)];
+        if (filter) {
+            args.push('-e', filter);
+        }
+        const raw = await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, args);
+        const entries = raw
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => {
+            const match = line.match(/^(\d{2}-\d{2}\s+\S+)\s+(\w)\/.*?:\s*(.*)/u);
+            if (match) {
+                return {
+                    timestamp: match[1],
+                    level: match[2],
+                    message: match[3],
+                };
+            }
+            return { timestamp: '', level: 'info', message: line };
+        });
+        return { entries, source: 'logcat' };
+    }
+    async longPress(query, durationMs = 1000) {
+        const snap = await this.snapshot();
+        const element = (0, element_js_1.findElement)(snap.hierarchy, query);
+        if (!element) {
+            throw new Error(`Element not found: ${JSON.stringify(query)}\n` +
+                'Use device_snapshot to inspect the current UI hierarchy.');
+        }
+        const cx = Math.round(element.frame.x + element.frame.width / 2);
+        const cy = Math.round(element.frame.y + element.frame.height / 2);
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, [
+            'shell',
+            'input',
+            'swipe',
+            String(cx),
+            String(cy),
+            String(cx),
+            String(cy),
+            String(durationMs),
+        ]);
+        return {
+            success: true,
+            x: cx,
+            y: cy,
+            targetDescription: (0, element_js_1.describeElement)(element),
+        };
+    }
+    async scrollToElement(query, direction = 'down', maxAttempts = 10) {
+        let previousRaw = '';
+        for (let i = 0; i < maxAttempts; i++) {
+            const snap = await this.snapshot();
+            const element = (0, element_js_1.findElement)(snap.hierarchy, query);
+            if (element) {
+                return element;
+            }
+            if (snap.raw === previousRaw) {
+                break;
+            }
+            previousRaw = snap.raw;
+            await this.swipe(direction);
+        }
+        throw new Error(`Element not found after scrolling: ${JSON.stringify(query)}\n` +
+            'Use device_snapshot to inspect the current UI hierarchy.');
+    }
+    async getAlertText() {
+        const snap = await this.snapshot();
+        const texts = collectAndroidAlertTexts(snap.hierarchy);
+        if (texts.length === 0) {
+            throw new Error('No alert is currently displayed.\n' +
+                'Use device_snapshot to inspect the current UI hierarchy.');
+        }
+        return texts.join('\n');
+    }
+    async getWindowSize() {
+        const raw = await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'wm', 'size']);
+        const match = raw.match(/(\d+)x(\d+)/u);
+        if (match) {
+            return {
+                width: parseInt(match[1], 10),
+                height: parseInt(match[2], 10),
+            };
+        }
+        throw new Error(`Unable to parse window size from: ${raw.trim()}`);
+    }
+    async getContexts() {
+        return ['NATIVE_APP'];
+    }
+    async setContext(context) {
+        if (context === 'NATIVE_APP') {
+            return;
+        }
+        throw new Error('Context switching requires Appium backend. ADB only supports NATIVE_APP.');
+    }
+    async getClipboard() {
+        throw new Error('Clipboard access via ADB is not supported on modern Android. ' +
+            'Use the Appium backend for clipboard operations.');
+    }
+    async setClipboard(_text) {
+        throw new Error('Clipboard access via ADB is not supported on modern Android. ' +
+            'Use the Appium backend for clipboard operations.');
+    }
+    async startScreenRecording(outputPath) {
+        if (__classPrivateFieldGet(this, _AdbBackend_recordingProcess, "f")) {
+            throw new Error('Screen recording is already in progress');
+        }
+        __classPrivateFieldSet(this, _AdbBackend_recordingPath, outputPath ?? `/tmp/device-mcp-recording-${Date.now()}.mp4`, "f");
+        __classPrivateFieldSet(this, _AdbBackend_recordingProcess, (0, node_child_process_1.spawn)('adb', [
+            '-s',
+            __classPrivateFieldGet(this, _AdbBackend_serial, "f"),
+            'shell',
+            'screenrecord',
+            __classPrivateFieldGet(this, _AdbBackend_recordingRemotePath, "f"),
+        ]), "f");
+        __classPrivateFieldGet(this, _AdbBackend_recordingProcess, "f").on('error', () => {
+            __classPrivateFieldSet(this, _AdbBackend_recordingProcess, null, "f");
+            __classPrivateFieldSet(this, _AdbBackend_recordingPath, null, "f");
+        });
+    }
+    async stopScreenRecording() {
+        if (!__classPrivateFieldGet(this, _AdbBackend_recordingProcess, "f") || !__classPrivateFieldGet(this, _AdbBackend_recordingPath, "f")) {
+            throw new Error('No screen recording in progress');
+        }
+        const localPath = __classPrivateFieldGet(this, _AdbBackend_recordingPath, "f");
+        __classPrivateFieldGet(this, _AdbBackend_recordingProcess, "f").kill('SIGINT');
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+        __classPrivateFieldSet(this, _AdbBackend_recordingProcess, null, "f");
+        __classPrivateFieldSet(this, _AdbBackend_recordingPath, null, "f");
+        await (0, exec_js_1.execStrict)('adb', [
+            '-s',
+            __classPrivateFieldGet(this, _AdbBackend_serial, "f"),
+            'pull',
+            __classPrivateFieldGet(this, _AdbBackend_recordingRemotePath, "f"),
+            localPath,
+        ]);
+        await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'rm', '-f', __classPrivateFieldGet(this, _AdbBackend_recordingRemotePath, "f")]);
+        return localPath;
+    }
+}
+exports.AdbBackend = AdbBackend;
+_AdbBackend_serial = new WeakMap(), _AdbBackend_recordingProcess = new WeakMap(), _AdbBackend_recordingPath = new WeakMap(), _AdbBackend_recordingRemotePath = new WeakMap(), _AdbBackend_instances = new WeakSet(), _AdbBackend_adb = async function _AdbBackend_adb(args) {
+    return (0, exec_js_1.execStrict)('adb', ['-s', __classPrivateFieldGet(this, _AdbBackend_serial, "f"), ...args]);
+}, _AdbBackend_dumpUiHierarchy = async function _AdbBackend_dumpUiHierarchy() {
+    const remotePath = '/sdcard/window_dump.xml';
+    await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'uiautomator', 'dump', remotePath]);
+    const xml = await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'cat', remotePath]);
+    await __classPrivateFieldGet(this, _AdbBackend_instances, "m", _AdbBackend_adb).call(this, ['shell', 'rm', '-f', remotePath]);
+    return xml;
+};
+function collectAndroidAlertTexts(elements) {
+    const texts = [];
+    for (const el of elements) {
+        const isDialog = el.type.includes('Dialog') || el.type.includes('AlertDialog');
+        if (isDialog) {
+            collectTextValues(el.children ?? [], texts);
+            return texts;
+        }
+        if (el.children) {
+            const found = collectAndroidAlertTexts(el.children);
+            if (found.length > 0) {
+                return found;
+            }
+        }
+    }
+    return texts;
+}
+function collectTextValues(elements, texts) {
+    for (const el of elements) {
+        if (el.type.includes('TextView') && el.value) {
+            texts.push(el.value);
+        }
+        if (el.children) {
+            collectTextValues(el.children, texts);
+        }
+    }
+}
+function parseAndroidHierarchy(xml) {
+    const stack = [[]];
+    // Matches all <node ...>, </node>, and <node .../> tags in document order
+    const tagRegex = /<(\/?)node(?:\s+([^>]*?))?\s*(\/?)>/gu;
+    let match;
+    while ((match = tagRegex.exec(xml)) !== null) {
+        const isClosing = match[1] === '/';
+        const attrs = match[2];
+        const isSelfClosing = match[3] === '/';
+        if (isClosing) {
+            if (stack.length > 1) {
+                stack.pop();
+            }
+        }
+        else if (isSelfClosing && attrs) {
+            const element = parseNodeAttributes(attrs);
+            if (element) {
+                stack[stack.length - 1].push(element);
+            }
+        }
+        else if (attrs) {
+            const element = parseNodeAttributes(attrs);
+            if (element) {
+                element.children = [];
+                stack[stack.length - 1].push(element);
+                stack.push(element.children);
+            }
+        }
+    }
+    return stack[0];
+}
+function parseNodeAttributes(attrs) {
+    const get = (name) => {
+        const attrMatch = attrs.match(new RegExp(`${name}="([^"]*)"`, 'u'));
+        return attrMatch?.[1] || undefined;
+    };
+    const boundsStr = get('bounds');
+    if (!boundsStr) {
+        return null;
+    }
+    // bounds format: [x1,y1][x2,y2]
+    const boundsMatch = boundsStr.match(/\[(\d+),(\d+)\]\[(\d+),(\d+)\]/u);
+    if (!boundsMatch) {
+        return null;
+    }
+    const x1 = parseInt(boundsMatch[1], 10);
+    const y1 = parseInt(boundsMatch[2], 10);
+    const x2 = parseInt(boundsMatch[3], 10);
+    const y2 = parseInt(boundsMatch[4], 10);
+    return {
+        type: get('class') ?? 'Unknown',
+        label: get('content-desc') || undefined,
+        value: get('text') || undefined,
+        identifier: get('resource-id') || undefined,
+        frame: { x: x1, y: y1, width: x2 - x1, height: y2 - y1 },
+        enabled: get('enabled') !== 'false',
+    };
+}
+//# sourceMappingURL=adb-backend.cjs.map

package/dist/backends/adb-backend.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb-backend.cjs","sourceRoot":"","sources":["../../src/backends/adb-backend.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'node:child_process';\nimport type { ChildProcess } from 'node:child_process';\n\nimport type {\n  DeviceBackend,\n  DeviceButton,\n  DeviceInfo,\n  SnapshotResult,\n  ScreenshotResult,\n  LogsResult,\n  TapResult,\n  AppStateResult,\n  ElementQuery,\n  UIElement,\n  WindowSize,\n} from './types.js';\nimport { ACCEPT_LABELS, DENY_LABELS } from '../utils/alert-labels.js';\nimport {\n  findElement,\n  describeElement,\n  computeSwipeEnd,\n} from '../utils/element.js';\nimport { execStrict, isCommandAvailable } from '../utils/exec.js';\n\nexport class AdbBackend implements DeviceBackend {\n  readonly platform = 'android' as const;\n\n  readonly #serial: string;\n\n  #recordingProcess: ChildProcess | null = null;\n\n  #recordingPath: string | null = null;\n\n  readonly #recordingRemotePath = '/sdcard/device-mcp-recording.mp4';\n\n  constructor(serial: string) {\n    this.#serial = serial;\n  }\n\n  async #adb(args: string[]): Promise<string> {\n    return execStrict('adb', ['-s', this.#serial, ...args]);\n  }\n\n  async ensureConnected(): Promise<void> {\n    if (!(await isCommandAvailable('adb'))) {\n      throw new Error(\n        'adb is not installed or not on $PATH.\\n' +\n          'Install Android SDK platform-tools.',\n      );\n    }\n    const state = await this.#adb(['get-state']);\n    if (state.trim() !== 'device') {\n      throw new Error(\n        `Device ${this.#serial} is not ready (state: ${state.trim()})`,\n      );\n    }\n  }\n\n  async getDeviceInfo(): Promise<DeviceInfo> {\n    const [model, version] = await Promise.all([\n      this.#adb(['shell', 'getprop', 'ro.product.model']),\n      this.#adb(['shell', 'getprop', 'ro.build.version.release']),\n    ]);\n    return {\n      platform: 'android',\n      deviceId: this.#serial,\n      name: model.trim(),\n      osVersion: version.trim(),\n      state: 'device',\n    };\n  }\n\n  async snapshot(): Promise<SnapshotResult> {\n    const raw = await this.#dumpUiHierarchy();\n    const hierarchy = parseAndroidHierarchy(raw);\n    return {\n      platform: 'android',\n      hierarchy,\n      raw,\n      timestamp: Date.now(),\n    };\n  }\n\n  async tapElement(query: ElementQuery): Promise<TapResult> {\n    const snapshot = await this.snapshot();\n    const element = findElement(snapshot.hierarchy, query);\n    if (!element) {\n      throw new Error(\n        `Element not found: ${JSON.stringify(query)}\\n` +\n          'Use device_snapshot to inspect the current UI hierarchy.',\n      );\n    }\n\n    const x = Math.round(element.frame.x + element.frame.width / 2);\n    const y = Math.round(element.frame.y + element.frame.height / 2);\n    await this.tapCoordinates(x, y);\n\n    return {\n      success: true,\n      x,\n      y,\n      targetDescription: describeElement(element),\n    };\n  }\n\n  async tapCoordinates(x: number, y: number): Promise<void> {\n    await this.#adb(['shell', 'input', 'tap', String(x), String(y)]);\n  }\n\n  async typeText(text: string): Promise<void> {\n    // Android keyevent 29+shift = Ctrl+A (select all), 67 = DEL\n    await this.#adb(['shell', 'input', 'keyevent', 'KEYCODE_MOVE_HOME']);\n    await this.#adb([\n      'shell',\n      'input',\n      'keyevent',\n      '--longpress',\n      'KEYCODE_SHIFT_LEFT',\n      'KEYCODE_MOVE_END',\n    ]);\n    await this.#adb(['shell', 'input', 'keyevent', '67']);\n    // Android input text requires escaping spaces and special chars\n    const escaped = text.replace(/ /gu, '%s').replace(/[&|;<>]/gu, '\\\\$&');\n    await this.#adb(['shell', 'input', 'text', escaped]);\n  }\n\n  async swipe(\n    direction: 'up' | 'down' | 'left' | 'right',\n    startX?: number,\n    startY?: number,\n    distance?: number,\n  ): Promise<void> {\n    const d = distance ?? 500;\n    const sx = startX ?? 540;\n    const sy = startY ?? 960;\n    const [endX, endY] = computeSwipeEnd(sx, sy, direction, d);\n    const durationMs = 300;\n\n    await this.#adb([\n      'shell',\n      'input',\n      'swipe',\n      String(sx),\n      String(sy),\n      String(endX),\n      String(endY),\n      String(durationMs),\n    ]);\n  }\n\n  async waitForElement(\n    query: ElementQuery,\n    timeoutMs = 10_000,\n    intervalMs = 500,\n  ): Promise<UIElement> {\n    const start = Date.now();\n    while (Date.now() - start < timeoutMs) {\n      const snapshot = await this.snapshot();\n      const element = findElement(snapshot.hierarchy, query);\n      if (element) {\n        return element;\n      }\n      await new Promise((resolve) => setTimeout(resolve, intervalMs));\n    }\n    throw new Error(\n      `Timed out waiting for element: ${JSON.stringify(query)} (${timeoutMs}ms)`,\n    );\n  }\n\n  async getAppState(bundleId: string): Promise<AppStateResult> {\n    const raw = await this.#adb(['shell', 'dumpsys', 'activity', 'processes']);\n\n    const pidMatch = raw.match(\n      new RegExp(`PID #(\\\\d+):.*${bundleId.replace(/\\./gu, '\\\\.')}`, 'u'),\n    );\n\n    if (pidMatch) {\n      return {\n        bundleId,\n        state: 'Running',\n        pid: parseInt(pidMatch[1], 10),\n      };\n    }\n\n    const pmResult = await this.#adb([\n      'shell',\n      'pm',\n      'list',\n      'packages',\n      bundleId,\n    ]);\n    if (pmResult.includes(bundleId)) {\n      return { bundleId, state: 'Installed (not running)' };\n    }\n\n    return { bundleId, state: 'Not Installed' };\n  }\n\n  async #dumpUiHierarchy(): Promise<string> {\n    const remotePath = '/sdcard/window_dump.xml';\n    await this.#adb(['shell', 'uiautomator', 'dump', remotePath]);\n    const xml = await this.#adb(['shell', 'cat', remotePath]);\n    await this.#adb(['shell', 'rm', '-f', remotePath]);\n    return xml;\n  }\n\n  async screenshot(outputPath?: string): Promise<ScreenshotResult> {\n    const localPath =\n      outputPath ?? `/tmp/device-mcp-screenshot-${Date.now()}.png`;\n    await this.#adb(['shell', 'screencap', '-p', '/sdcard/screenshot.png']);\n    await execStrict('adb', [\n      '-s',\n      this.#serial,\n      'pull',\n      '/sdcard/screenshot.png',\n      localPath,\n    ]);\n    await this.#adb(['shell', 'rm', '-f', '/sdcard/screenshot.png']);\n    const data = await execStrict('base64', [localPath]);\n    return { data: data.trim(), format: 'png', path: localPath };\n  }\n\n  async openApp(bundleId: string): Promise<void> {\n    await this.#adb([\n      'shell',\n      'monkey',\n      '-p',\n      bundleId,\n      '-c',\n      'android.intent.category.LAUNCHER',\n      '1',\n    ]);\n  }\n\n  async closeApp(bundleId: string): Promise<void> {\n    await this.#adb(['shell', 'am', 'force-stop', bundleId]);\n  }\n\n  async pressButton(button: DeviceButton): Promise<void> {\n    // Android keyevent codes\n    const keyMap: Record<DeviceButton, string> = {\n      home: '3',\n      back: '4',\n      enter: '66',\n      lock: '26',\n    };\n    await this.#adb(['shell', 'input', 'keyevent', keyMap[button]]);\n  }\n\n  async dismissKeyboard(): Promise<void> {\n    await this.#adb(['shell', 'input', 'keyevent', '111']);\n  }\n\n  async dismissAlert(accept: boolean): Promise<void> {\n    const snap = await this.snapshot();\n    const candidates = accept ? ACCEPT_LABELS : DENY_LABELS;\n\n    for (const label of candidates) {\n      const element = findElement(snap.hierarchy, { text: label });\n      if (element) {\n        const cx = Math.round(element.frame.x + element.frame.width / 2);\n        const cy = Math.round(element.frame.y + element.frame.height / 2);\n        await this.tapCoordinates(cx, cy);\n        return;\n      }\n    }\n\n    throw new Error(`No alert button found. Tried: ${candidates.join(', ')}`);\n  }\n\n  async getLogs(durationSeconds = 30, filter?: string): Promise<LogsResult> {\n    const args = ['shell', 'logcat', '-d', '-t', String(durationSeconds)];\n    if (filter) {\n      args.push('-e', filter);\n    }\n    const raw = await this.#adb(args);\n    const entries = raw\n      .trim()\n      .split('\\n')\n      .filter(Boolean)\n      .map((line) => {\n        const match = line.match(/^(\\d{2}-\\d{2}\\s+\\S+)\\s+(\\w)\\/.*?:\\s*(.*)/u);\n        if (match) {\n          return {\n            timestamp: match[1],\n            level: match[2],\n            message: match[3],\n          };\n        }\n        return { timestamp: '', level: 'info', message: line };\n      });\n    return { entries, source: 'logcat' };\n  }\n\n  async longPress(query: ElementQuery, durationMs = 1000): Promise<TapResult> {\n    const snap = await this.snapshot();\n    const element = findElement(snap.hierarchy, query);\n    if (!element) {\n      throw new Error(\n        `Element not found: ${JSON.stringify(query)}\\n` +\n          'Use device_snapshot to inspect the current UI hierarchy.',\n      );\n    }\n\n    const cx = Math.round(element.frame.x + element.frame.width / 2);\n    const cy = Math.round(element.frame.y + element.frame.height / 2);\n    await this.#adb([\n      'shell',\n      'input',\n      'swipe',\n      String(cx),\n      String(cy),\n      String(cx),\n      String(cy),\n      String(durationMs),\n    ]);\n\n    return {\n      success: true,\n      x: cx,\n      y: cy,\n      targetDescription: describeElement(element),\n    };\n  }\n\n  async scrollToElement(\n    query: ElementQuery,\n    direction: 'up' | 'down' = 'down',\n    maxAttempts = 10,\n  ): Promise<UIElement> {\n    let previousRaw = '';\n\n    for (let i = 0; i < maxAttempts; i++) {\n      const snap = await this.snapshot();\n      const element = findElement(snap.hierarchy, query);\n      if (element) {\n        return element;\n      }\n      if (snap.raw === previousRaw) {\n        break;\n      }\n      previousRaw = snap.raw;\n      await this.swipe(direction);\n    }\n    throw new Error(\n      `Element not found after scrolling: ${JSON.stringify(query)}\\n` +\n        'Use device_snapshot to inspect the current UI hierarchy.',\n    );\n  }\n\n  async getAlertText(): Promise<string> {\n    const snap = await this.snapshot();\n    const texts = collectAndroidAlertTexts(snap.hierarchy);\n    if (texts.length === 0) {\n      throw new Error(\n        'No alert is currently displayed.\\n' +\n          'Use device_snapshot to inspect the current UI hierarchy.',\n      );\n    }\n    return texts.join('\\n');\n  }\n\n  async getWindowSize(): Promise<WindowSize> {\n    const raw = await this.#adb(['shell', 'wm', 'size']);\n    const match = raw.match(/(\\d+)x(\\d+)/u);\n    if (match) {\n      return {\n        width: parseInt(match[1], 10),\n        height: parseInt(match[2], 10),\n      };\n    }\n    throw new Error(`Unable to parse window size from: ${raw.trim()}`);\n  }\n\n  async getContexts(): Promise<string[]> {\n    return ['NATIVE_APP'];\n  }\n\n  async setContext(context: string): Promise<void> {\n    if (context === 'NATIVE_APP') {\n      return;\n    }\n    throw new Error(\n      'Context switching requires Appium backend. ADB only supports NATIVE_APP.',\n    );\n  }\n\n  async getClipboard(): Promise<string> {\n    throw new Error(\n      'Clipboard access via ADB is not supported on modern Android. ' +\n        'Use the Appium backend for clipboard operations.',\n    );\n  }\n\n  async setClipboard(_text: string): Promise<void> {\n    throw new Error(\n      'Clipboard access via ADB is not supported on modern Android. ' +\n        'Use the Appium backend for clipboard operations.',\n    );\n  }\n\n  async startScreenRecording(outputPath?: string): Promise<void> {\n    if (this.#recordingProcess) {\n      throw new Error('Screen recording is already in progress');\n    }\n    this.#recordingPath =\n      outputPath ?? `/tmp/device-mcp-recording-${Date.now()}.mp4`;\n    this.#recordingProcess = spawn('adb', [\n      '-s',\n      this.#serial,\n      'shell',\n      'screenrecord',\n      this.#recordingRemotePath,\n    ]);\n    this.#recordingProcess.on('error', () => {\n      this.#recordingProcess = null;\n      this.#recordingPath = null;\n    });\n  }\n\n  async stopScreenRecording(): Promise<string> {\n    if (!this.#recordingProcess || !this.#recordingPath) {\n      throw new Error('No screen recording in progress');\n    }\n    const localPath = this.#recordingPath;\n    this.#recordingProcess.kill('SIGINT');\n    await new Promise((resolve) => setTimeout(resolve, 2000));\n    this.#recordingProcess = null;\n    this.#recordingPath = null;\n\n    await execStrict('adb', [\n      '-s',\n      this.#serial,\n      'pull',\n      this.#recordingRemotePath,\n      localPath,\n    ]);\n    await this.#adb(['shell', 'rm', '-f', this.#recordingRemotePath]);\n    return localPath;\n  }\n}\n\nfunction collectAndroidAlertTexts(elements: UIElement[]): string[] {\n  const texts: string[] = [];\n  for (const el of elements) {\n    const isDialog =\n      el.type.includes('Dialog') || el.type.includes('AlertDialog');\n    if (isDialog) {\n      collectTextValues(el.children ?? [], texts);\n      return texts;\n    }\n    if (el.children) {\n      const found = collectAndroidAlertTexts(el.children);\n      if (found.length > 0) {\n        return found;\n      }\n    }\n  }\n  return texts;\n}\n\nfunction collectTextValues(elements: UIElement[], texts: string[]): void {\n  for (const el of elements) {\n    if (el.type.includes('TextView') && el.value) {\n      texts.push(el.value);\n    }\n    if (el.children) {\n      collectTextValues(el.children, texts);\n    }\n  }\n}\n\nexport function parseAndroidHierarchy(xml: string): UIElement[] {\n  const stack: UIElement[][] = [[]];\n\n  // Matches all <node ...>, </node>, and <node .../> tags in document order\n  const tagRegex = /<(\\/?)node(?:\\s+([^>]*?))?\\s*(\\/?)>/gu;\n  let match: RegExpExecArray | null;\n\n  while ((match = tagRegex.exec(xml)) !== null) {\n    const isClosing = match[1] === '/';\n    const attrs = match[2];\n    const isSelfClosing = match[3] === '/';\n\n    if (isClosing) {\n      if (stack.length > 1) {\n        stack.pop();\n      }\n    } else if (isSelfClosing && attrs) {\n      const element = parseNodeAttributes(attrs);\n      if (element) {\n        stack[stack.length - 1].push(element);\n      }\n    } else if (attrs) {\n      const element = parseNodeAttributes(attrs);\n      if (element) {\n        element.children = [];\n        stack[stack.length - 1].push(element);\n        stack.push(element.children);\n      }\n    }\n  }\n\n  return stack[0];\n}\n\nexport function parseNodeAttributes(attrs: string): UIElement | null {\n  const get = (name: string): string | undefined => {\n    const attrMatch = attrs.match(new RegExp(`${name}=\"([^\"]*)\"`, 'u'));\n    return attrMatch?.[1] || undefined;\n  };\n\n  const boundsStr = get('bounds');\n  if (!boundsStr) {\n    return null;\n  }\n\n  // bounds format: [x1,y1][x2,y2]\n  const boundsMatch = boundsStr.match(/\\[(\\d+),(\\d+)\\]\\[(\\d+),(\\d+)\\]/u);\n  if (!boundsMatch) {\n    return null;\n  }\n\n  const x1 = parseInt(boundsMatch[1], 10);\n  const y1 = parseInt(boundsMatch[2], 10);\n  const x2 = parseInt(boundsMatch[3], 10);\n  const y2 = parseInt(boundsMatch[4], 10);\n\n  return {\n    type: get('class') ?? 'Unknown',\n    label: get('content-desc') || undefined,\n    value: get('text') || undefined,\n    identifier: get('resource-id') || undefined,\n    frame: { x: x1, y: y1, width: x2 - x1, height: y2 - y1 },\n    enabled: get('enabled') !== 'false',\n  };\n}\n"]}

package/dist/backends/adb-backend.d.cts

@@ -0,0 +1,35 @@
+import type { DeviceBackend, DeviceButton, DeviceInfo, SnapshotResult, ScreenshotResult, LogsResult, TapResult, AppStateResult, ElementQuery, UIElement, WindowSize } from "./types.cjs";
+export declare class AdbBackend implements DeviceBackend {
+    #private;
+    readonly platform: "android";
+    constructor(serial: string);
+    ensureConnected(): Promise<void>;
+    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>;
+}
+export declare function parseAndroidHierarchy(xml: string): UIElement[];
+export declare function parseNodeAttributes(attrs: string): UIElement | null;
+//# sourceMappingURL=adb-backend.d.cts.map

package/dist/backends/adb-backend.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb-backend.d.cts","sourceRoot":"","sources":["../../src/backends/adb-backend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,cAAc,EACd,YAAY,EACZ,SAAS,EACT,UAAU,EACX,oBAAmB;AASpB,qBAAa,UAAW,YAAW,aAAa;;IAC9C,QAAQ,CAAC,QAAQ,EAAG,SAAS,CAAU;gBAU3B,MAAM,EAAE,MAAM;IAQpB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAehC,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAcpC,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAWnC,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAsBnD,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrC,KAAK,CACT,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;IAmBV,cAAc,CAClB,KAAK,EAAE,YAAY,EACnB,SAAS,SAAS,EAClB,UAAU,SAAM,GACf,OAAO,CAAC,SAAS,CAAC;IAef,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqCtD,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgB1D,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5C,OAAO,CAAC,eAAe,SAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAwBnE,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,SAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IA+BrE,eAAe,CACnB,KAAK,EAAE,YAAY,EACnB,SAAS,GAAE,IAAI,GAAG,MAAe,EACjC,WAAW,SAAK,GACf,OAAO,CAAC,SAAS,CAAC;IAqBf,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAY/B,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAYpC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1C,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAO/B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxD,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;CAoB7C;AAgCD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAgC9D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CA8BnE"}

package/dist/backends/adb-backend.d.mts

@@ -0,0 +1,35 @@
+import type { DeviceBackend, DeviceButton, DeviceInfo, SnapshotResult, ScreenshotResult, LogsResult, TapResult, AppStateResult, ElementQuery, UIElement, WindowSize } from "./types.mjs";
+export declare class AdbBackend implements DeviceBackend {
+    #private;
+    readonly platform: "android";
+    constructor(serial: string);
+    ensureConnected(): Promise<void>;
+    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>;
+}
+export declare function parseAndroidHierarchy(xml: string): UIElement[];
+export declare function parseNodeAttributes(attrs: string): UIElement | null;
+//# sourceMappingURL=adb-backend.d.mts.map

package/dist/backends/adb-backend.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb-backend.d.mts","sourceRoot":"","sources":["../../src/backends/adb-backend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,cAAc,EACd,YAAY,EACZ,SAAS,EACT,UAAU,EACX,oBAAmB;AASpB,qBAAa,UAAW,YAAW,aAAa;;IAC9C,QAAQ,CAAC,QAAQ,EAAG,SAAS,CAAU;gBAU3B,MAAM,EAAE,MAAM;IAQpB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAehC,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAcpC,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAWnC,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAsBnD,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrC,KAAK,CACT,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;IAmBV,cAAc,CAClB,KAAK,EAAE,YAAY,EACnB,SAAS,SAAS,EAClB,UAAU,SAAM,GACf,OAAO,CAAC,SAAS,CAAC;IAef,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqCtD,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgB1D,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5C,OAAO,CAAC,eAAe,SAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAwBnE,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,SAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IA+BrE,eAAe,CACnB,KAAK,EAAE,YAAY,EACnB,SAAS,GAAE,IAAI,GAAG,MAAe,EACjC,WAAW,SAAK,GACf,OAAO,CAAC,SAAS,CAAC;IAqBf,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAY/B,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAYpC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1C,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAO/B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxD,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;CAoB7C;AAgCD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAgC9D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CA8BnE"}