@metamask/device-mcp 0.1.0

package/dist/backends/appium-backend.cjs

@@ -0,0 +1,518 @@
+"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 _AppiumBackend_instances, _AppiumBackend_client, _AppiumBackend_config, _AppiumBackend_recording, _AppiumBackend_recordingOutputPath, _AppiumBackend_getHierarchy, _AppiumBackend_getIosHierarchy, _AppiumBackend_requireClient;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppiumBackend = void 0;
+exports.parseAppiumAndroidHierarchy = parseAppiumAndroidHierarchy;
+exports.parseAppiumIosHierarchy = parseAppiumIosHierarchy;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const webdriver_client_js_1 = require("./webdriver-client.cjs");
+const element_js_1 = require("../utils/element.cjs");
+class AppiumBackend {
+    constructor(config) {
+        _AppiumBackend_instances.add(this);
+        _AppiumBackend_client.set(this, null);
+        _AppiumBackend_config.set(this, void 0);
+        _AppiumBackend_recording.set(this, false);
+        _AppiumBackend_recordingOutputPath.set(this, null);
+        __classPrivateFieldSet(this, _AppiumBackend_config, config, "f");
+        this.platform = config.platform;
+    }
+    async ensureConnected() {
+        if (__classPrivateFieldGet(this, _AppiumBackend_client, "f")) {
+            return;
+        }
+        if (__classPrivateFieldGet(this, _AppiumBackend_config, "f").mode === 'attach') {
+            __classPrivateFieldSet(this, _AppiumBackend_client, new webdriver_client_js_1.WebDriverClient(__classPrivateFieldGet(this, _AppiumBackend_config, "f").appiumUrl, __classPrivateFieldGet(this, _AppiumBackend_config, "f").sessionId, __classPrivateFieldGet(this, _AppiumBackend_config, "f").auth), "f");
+            await __classPrivateFieldGet(this, _AppiumBackend_client, "f").getStatus();
+        }
+        else {
+            const { client } = await (0, webdriver_client_js_1.createSession)(__classPrivateFieldGet(this, _AppiumBackend_config, "f").appiumUrl, __classPrivateFieldGet(this, _AppiumBackend_config, "f").capabilities, __classPrivateFieldGet(this, _AppiumBackend_config, "f").auth);
+            __classPrivateFieldSet(this, _AppiumBackend_client, client, "f");
+        }
+    }
+    async getDeviceInfo() {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        const details = await client.getSessionDetails();
+        const caps = (details.capabilities ?? details);
+        return {
+            platform: this.platform,
+            deviceId: caps.udid ?? client.sessionId,
+            name: caps.deviceName ?? 'Appium Device',
+            osVersion: caps.platformVersion ?? 'Unknown',
+            state: 'connected',
+        };
+    }
+    async snapshot() {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        const raw = await __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_getHierarchy).call(this, client);
+        const hierarchy = this.platform === 'ios'
+            ? parseAppiumIosHierarchy(raw)
+            : parseAppiumAndroidHierarchy(raw);
+        return {
+            platform: this.platform,
+            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 targetX = Math.round(element.frame.x + element.frame.width / 2);
+        const targetY = Math.round(element.frame.y + element.frame.height / 2);
+        await this.tapCoordinates(targetX, targetY);
+        return {
+            success: true,
+            x: targetX,
+            y: targetY,
+            targetDescription: (0, element_js_1.describeElement)(element),
+        };
+    }
+    async tapCoordinates(targetX, targetY) {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        await client.performActions([
+            {
+                type: 'pointer',
+                id: 'finger1',
+                parameters: { pointerType: 'touch' },
+                actions: [
+                    { type: 'pointerMove', duration: 0, x: targetX, y: targetY },
+                    { type: 'pointerDown', button: 0 },
+                    { type: 'pause', duration: 50 },
+                    { type: 'pointerUp', button: 0 },
+                ],
+            },
+        ]);
+        await client.releaseActions();
+    }
+    async typeText(text) {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        const activeElement = await client.findElement('xpath', '//*[@focused="true"]');
+        const elementId = extractElementId(activeElement);
+        await client.elementClear(elementId);
+        await client.elementSendKeys(elementId, text);
+    }
+    async swipe(direction, startX, startY, distance) {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        const dist = distance ?? 500;
+        const sx = startX ?? 200;
+        const sy = startY ?? 400;
+        const [endX, endY] = (0, element_js_1.computeSwipeEnd)(sx, sy, direction, dist);
+        await client.performActions([
+            {
+                type: 'pointer',
+                id: 'finger1',
+                parameters: { pointerType: 'touch' },
+                actions: [
+                    { type: 'pointerMove', duration: 0, x: sx, y: sy },
+                    { type: 'pointerDown', button: 0 },
+                    { type: 'pointerMove', duration: 300, x: endX, y: endY },
+                    { type: 'pointerUp', button: 0 },
+                ],
+            },
+        ]);
+        await client.releaseActions();
+    }
+    async waitForElement(query, timeoutMs = 10000, intervalMs = 500) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const snap = await this.snapshot();
+            const element = (0, element_js_1.findElement)(snap.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 client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        if (this.platform === 'ios') {
+            // iOS app state: 0=not installed, 1=not running, 2=background, 3=suspended, 4=foreground
+            const state = await client.queryAppState(bundleId);
+            const stateMap = {
+                0: 'Not Installed',
+                1: 'Not Running',
+                2: 'Running (background)',
+                3: 'Suspended',
+                4: 'Running (foreground)',
+            };
+            return { bundleId, state: stateMap[state] ?? `Unknown (${state})` };
+        }
+        try {
+            const activity = await client.getCurrentActivity();
+            return { bundleId, state: `Running (${activity})` };
+        }
+        catch {
+            return { bundleId, state: 'Not Running' };
+        }
+    }
+    async screenshot() {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        const data = await client.execute('mobile: getScreenshot', []);
+        return { data, format: 'png' };
+    }
+    async openApp(bundleId) {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        await client.execute('mobile: activateApp', [{ bundleId }]);
+    }
+    async closeApp(bundleId) {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        await client.execute('mobile: terminateApp', [{ bundleId }]);
+    }
+    async pressButton(button) {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        if (this.platform === 'ios') {
+            const iosMap = {
+                home: 'home',
+                lock: 'lock',
+                back: 'home',
+                enter: '\n',
+            };
+            await client.execute('mobile: pressButton', [{ name: iosMap[button] }]);
+        }
+        else {
+            // Android keyevent codes
+            const androidMap = {
+                home: 3,
+                back: 4,
+                enter: 66,
+                lock: 26,
+            };
+            await client.execute('mobile: pressKey', [
+                { keycode: androidMap[button] },
+            ]);
+        }
+    }
+    async dismissKeyboard() {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        if (this.platform === 'ios') {
+            await client.execute('mobile: hideKeyboard', []);
+        }
+        else {
+            await client.execute('mobile: hideKeyboard', []);
+        }
+    }
+    async dismissAlert(accept) {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        const action = accept ? 'accept' : 'dismiss';
+        await client.execute(`mobile: ${action}Alert`, []);
+    }
+    async getLogs(durationSeconds = 30, filter) {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        const logType = this.platform === 'ios' ? 'syslog' : 'logcat';
+        const raw = await client.execute('mobile: getLog', [{ type: logType }]);
+        let entries = raw.map((entry) => ({
+            timestamp: typeof entry.timestamp === 'string' ? entry.timestamp : '',
+            level: typeof entry.level === 'string' ? entry.level : 'info',
+            message: typeof entry.message === 'string' ? entry.message : '',
+        }));
+        if (filter) {
+            const pattern = new RegExp(filter, 'iu');
+            entries = entries.filter((entry) => pattern.test(entry.message));
+        }
+        const cutoff = Date.now() - durationSeconds * 1000;
+        entries = entries.filter((entry) => {
+            const ts = Number(entry.timestamp);
+            return isNaN(ts) || ts >= cutoff;
+        });
+        return { entries, source: `appium ${logType}` };
+    }
+    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 client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        const cx = Math.round(element.frame.x + element.frame.width / 2);
+        const cy = Math.round(element.frame.y + element.frame.height / 2);
+        await client.performActions([
+            {
+                type: 'pointer',
+                id: 'finger1',
+                parameters: { pointerType: 'touch' },
+                actions: [
+                    { type: 'pointerMove', duration: 0, x: cx, y: cy },
+                    { type: 'pointerDown', button: 0 },
+                    { type: 'pause', duration: durationMs },
+                    { type: 'pointerUp', button: 0 },
+                ],
+            },
+        ]);
+        await client.releaseActions();
+        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 client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        try {
+            return await client.execute('mobile: getAlertText', []);
+        }
+        catch {
+            const snap = await this.snapshot();
+            const texts = collectAppiumAlertTexts(snap.hierarchy, this.platform);
+            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 client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        try {
+            const rect = await client.getWindowRect();
+            return { width: rect.width, height: rect.height };
+        }
+        catch {
+            const snap = await this.snapshot();
+            if (snap.hierarchy.length > 0) {
+                const root = snap.hierarchy[0];
+                if (root.frame.width > 0 && root.frame.height > 0) {
+                    return { width: root.frame.width, height: root.frame.height };
+                }
+            }
+            throw new Error('Unable to determine window size');
+        }
+    }
+    async getContexts() {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        return client.getContexts();
+    }
+    async setContext(context) {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        await client.setCurrentContext(context);
+    }
+    async getClipboard() {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        const b64 = await client.execute('mobile: getClipboard', [
+            { contentType: 'plaintext' },
+        ]);
+        return Buffer.from(b64, 'base64').toString('utf-8');
+    }
+    async setClipboard(text) {
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        await client.execute('mobile: setClipboard', [
+            {
+                content: Buffer.from(text).toString('base64'),
+                contentType: 'plaintext',
+            },
+        ]);
+    }
+    async startScreenRecording(outputPath) {
+        if (__classPrivateFieldGet(this, _AppiumBackend_recording, "f")) {
+            throw new Error('Screen recording is already in progress');
+        }
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        await client.execute('mobile: startRecordingScreen', [{}]);
+        __classPrivateFieldSet(this, _AppiumBackend_recording, true, "f");
+        __classPrivateFieldSet(this, _AppiumBackend_recordingOutputPath, (0, node_path_1.resolve)(outputPath ?? `/tmp/device-mcp-recording-${Date.now()}.mp4`), "f");
+    }
+    async stopScreenRecording() {
+        if (!__classPrivateFieldGet(this, _AppiumBackend_recording, "f") || !__classPrivateFieldGet(this, _AppiumBackend_recordingOutputPath, "f")) {
+            throw new Error('No screen recording in progress');
+        }
+        const client = __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_requireClient).call(this);
+        const b64 = await client.execute('mobile: stopRecordingScreen', []);
+        const data = Buffer.from(b64, 'base64');
+        if (data.length === 0) {
+            throw new Error('Screen recording returned empty data');
+        }
+        const outputPath = (0, node_path_1.resolve)(__classPrivateFieldGet(this, _AppiumBackend_recordingOutputPath, "f"));
+        (0, node_fs_1.writeFileSync)(outputPath, data);
+        __classPrivateFieldSet(this, _AppiumBackend_recording, false, "f");
+        __classPrivateFieldSet(this, _AppiumBackend_recordingOutputPath, null, "f");
+        return outputPath;
+    }
+}
+exports.AppiumBackend = AppiumBackend;
+_AppiumBackend_client = new WeakMap(), _AppiumBackend_config = new WeakMap(), _AppiumBackend_recording = new WeakMap(), _AppiumBackend_recordingOutputPath = new WeakMap(), _AppiumBackend_instances = new WeakSet(), _AppiumBackend_getHierarchy = async function _AppiumBackend_getHierarchy(client) {
+    if (this.platform === 'ios') {
+        return __classPrivateFieldGet(this, _AppiumBackend_instances, "m", _AppiumBackend_getIosHierarchy).call(this, client);
+    }
+    return client.getPageSource();
+}, _AppiumBackend_getIosHierarchy = async function _AppiumBackend_getIosHierarchy(client) {
+    // Limit hierarchy depth to avoid "JS stack is too deep" on complex iOS apps
+    try {
+        await client.updateSettings({ snapshotMaxDepth: 30 });
+    }
+    catch {
+        // snapshotMaxDepth not supported on older XCUITest drivers
+    }
+    try {
+        return await client.execute('mobile: source', [
+            { format: 'xml' },
+        ]);
+    }
+    catch {
+        return client.getPageSource();
+    }
+}, _AppiumBackend_requireClient = function _AppiumBackend_requireClient() {
+    if (!__classPrivateFieldGet(this, _AppiumBackend_client, "f")) {
+        throw new Error('AppiumBackend not connected. Call ensureConnected() first.');
+    }
+    return __classPrivateFieldGet(this, _AppiumBackend_client, "f");
+};
+function collectAppiumAlertTexts(elements, platform) {
+    const texts = [];
+    for (const el of elements) {
+        const isAlert = platform === 'ios'
+            ? el.type === 'Alert' || el.type === 'Sheet'
+            : el.type.includes('Dialog');
+        if (isAlert) {
+            collectAppiumTextValues(el.children ?? [], texts);
+            return texts;
+        }
+        if (el.children) {
+            const found = collectAppiumAlertTexts(el.children, platform);
+            if (found.length > 0) {
+                return found;
+            }
+        }
+    }
+    return texts;
+}
+function collectAppiumTextValues(elements, texts) {
+    for (const el of elements) {
+        const text = el.value ?? el.label;
+        if (text &&
+            (el.type === 'StaticText' ||
+                el.type.includes('TextView') ||
+                el.type === 'Text')) {
+            texts.push(text);
+        }
+        if (el.children) {
+            collectAppiumTextValues(el.children, texts);
+        }
+    }
+}
+function extractElementId(element) {
+    // W3C uses 'element-6066-11e4-a52e-4f735466cecf', JSONWP uses 'ELEMENT'
+    const id = element['element-6066-11e4-a52e-4f735466cecf'] ||
+        element.ELEMENT ||
+        Object.values(element)[0];
+    if (!id) {
+        throw new Error(`Failed to extract element ID from Appium response: ${JSON.stringify(element)}`);
+    }
+    return id;
+}
+function parseAppiumAndroidHierarchy(xml) {
+    const elements = [];
+    const nodeRegex = /<node\s+([^>]+)\/?>/gu;
+    let match;
+    while ((match = nodeRegex.exec(xml)) !== null) {
+        const element = parseAndroidNodeAttrs(match[1]);
+        if (element) {
+            elements.push(element);
+        }
+    }
+    return elements;
+}
+function parseAndroidNodeAttrs(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',
+    };
+}
+function parseAppiumIosHierarchy(xml) {
+    const elements = [];
+    // XCUITest XML uses <XCUIElementType* ...> elements
+    const nodeRegex = /<(XCUIElementType\w+)\s+([^>]+)\/?>/gu;
+    let match;
+    while ((match = nodeRegex.exec(xml)) !== null) {
+        const typeName = match[1];
+        const element = parseIosNodeAttrs(typeName, match[2]);
+        if (element) {
+            elements.push(element);
+        }
+    }
+    return elements;
+}
+function parseIosNodeAttrs(typeName, attrs) {
+    const get = (name) => {
+        const attrMatch = attrs.match(new RegExp(`${name}="([^"]*)"`, 'u'));
+        return attrMatch?.[1] || undefined;
+    };
+    const xStr = get('x');
+    const yStr = get('y');
+    const widthStr = get('width');
+    const heightStr = get('height');
+    if (!xStr || !yStr || !widthStr || !heightStr) {
+        return null;
+    }
+    const shortType = typeName.replace(/^XCUIElementType/u, '');
+    return {
+        type: shortType,
+        label: get('label') || undefined,
+        value: get('value') || undefined,
+        identifier: get('name') || undefined,
+        frame: {
+            x: parseInt(xStr, 10),
+            y: parseInt(yStr, 10),
+            width: parseInt(widthStr, 10),
+            height: parseInt(heightStr, 10),
+        },
+        enabled: get('enabled') !== 'false',
+    };
+}
+//# sourceMappingURL=appium-backend.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"appium-backend.cjs","sourceRoot":"","sources":["../../src/backends/appium-backend.ts"],"names":[],"mappings":"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","sourcesContent":["import { writeFileSync } from 'node:fs';\nimport { resolve as resolvePath } from 'node:path';\n\nimport type { SessionConfig } from './session-file.js';\nimport type {\n  DeviceBackend,\n  DeviceButton,\n  DeviceInfo,\n  SnapshotResult,\n  ScreenshotResult,\n  LogsResult,\n  TapResult,\n  AppStateResult,\n  ElementQuery,\n  UIElement,\n  Platform,\n  WindowSize,\n} from './types.js';\nimport { WebDriverClient, createSession } from './webdriver-client.js';\nimport {\n  findElement,\n  describeElement,\n  computeSwipeEnd,\n} from '../utils/element.js';\n\nexport class AppiumBackend implements DeviceBackend {\n  readonly platform: Platform;\n\n  #client: WebDriverClient | null = null;\n\n  readonly #config: SessionConfig;\n\n  #recording = false;\n\n  #recordingOutputPath: string | null = null;\n\n  constructor(config: SessionConfig) {\n    this.#config = config;\n    this.platform = config.platform;\n  }\n\n  async ensureConnected(): Promise<void> {\n    if (this.#client) {\n      return;\n    }\n\n    if (this.#config.mode === 'attach') {\n      this.#client = new WebDriverClient(\n        this.#config.appiumUrl,\n        this.#config.sessionId,\n        this.#config.auth,\n      );\n      await this.#client.getStatus();\n    } else {\n      const { client } = await createSession(\n        this.#config.appiumUrl,\n        this.#config.capabilities,\n        this.#config.auth,\n      );\n      this.#client = client;\n    }\n  }\n\n  async getDeviceInfo(): Promise<DeviceInfo> {\n    const client = this.#requireClient();\n    const details = await client.getSessionDetails();\n    const caps = (details.capabilities ?? details) as Record<string, unknown>;\n\n    return {\n      platform: this.platform,\n      deviceId: (caps.udid as string) ?? client.sessionId,\n      name: (caps.deviceName as string) ?? 'Appium Device',\n      osVersion: (caps.platformVersion as string) ?? 'Unknown',\n      state: 'connected',\n    };\n  }\n\n  async snapshot(): Promise<SnapshotResult> {\n    const client = this.#requireClient();\n    const raw = await this.#getHierarchy(client);\n    const hierarchy =\n      this.platform === 'ios'\n        ? parseAppiumIosHierarchy(raw)\n        : parseAppiumAndroidHierarchy(raw);\n\n    return {\n      platform: this.platform,\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 targetX = Math.round(element.frame.x + element.frame.width / 2);\n    const targetY = Math.round(element.frame.y + element.frame.height / 2);\n    await this.tapCoordinates(targetX, targetY);\n\n    return {\n      success: true,\n      x: targetX,\n      y: targetY,\n      targetDescription: describeElement(element),\n    };\n  }\n\n  async tapCoordinates(targetX: number, targetY: number): Promise<void> {\n    const client = this.#requireClient();\n    await client.performActions([\n      {\n        type: 'pointer',\n        id: 'finger1',\n        parameters: { pointerType: 'touch' },\n        actions: [\n          { type: 'pointerMove', duration: 0, x: targetX, y: targetY },\n          { type: 'pointerDown', button: 0 },\n          { type: 'pause', duration: 50 },\n          { type: 'pointerUp', button: 0 },\n        ],\n      },\n    ]);\n    await client.releaseActions();\n  }\n\n  async typeText(text: string): Promise<void> {\n    const client = this.#requireClient();\n    const activeElement = await client.findElement(\n      'xpath',\n      '//*[@focused=\"true\"]',\n    );\n    const elementId = extractElementId(activeElement);\n    await client.elementClear(elementId);\n    await client.elementSendKeys(elementId, 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    const client = this.#requireClient();\n    const dist = distance ?? 500;\n    const sx = startX ?? 200;\n    const sy = startY ?? 400;\n    const [endX, endY] = computeSwipeEnd(sx, sy, direction, dist);\n\n    await client.performActions([\n      {\n        type: 'pointer',\n        id: 'finger1',\n        parameters: { pointerType: 'touch' },\n        actions: [\n          { type: 'pointerMove', duration: 0, x: sx, y: sy },\n          { type: 'pointerDown', button: 0 },\n          { type: 'pointerMove', duration: 300, x: endX, y: endY },\n          { type: 'pointerUp', button: 0 },\n        ],\n      },\n    ]);\n    await client.releaseActions();\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 snap = await this.snapshot();\n      const element = findElement(snap.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 client = this.#requireClient();\n\n    if (this.platform === 'ios') {\n      // iOS app state: 0=not installed, 1=not running, 2=background, 3=suspended, 4=foreground\n      const state = await client.queryAppState(bundleId);\n      const stateMap: Record<number, string> = {\n        0: 'Not Installed',\n        1: 'Not Running',\n        2: 'Running (background)',\n        3: 'Suspended',\n        4: 'Running (foreground)',\n      };\n      return { bundleId, state: stateMap[state] ?? `Unknown (${state})` };\n    }\n\n    try {\n      const activity = await client.getCurrentActivity();\n      return { bundleId, state: `Running (${activity})` };\n    } catch {\n      return { bundleId, state: 'Not Running' };\n    }\n  }\n\n  async #getHierarchy(client: WebDriverClient): Promise<string> {\n    if (this.platform === 'ios') {\n      return this.#getIosHierarchy(client);\n    }\n    return client.getPageSource();\n  }\n\n  async #getIosHierarchy(client: WebDriverClient): Promise<string> {\n    // Limit hierarchy depth to avoid \"JS stack is too deep\" on complex iOS apps\n    try {\n      await client.updateSettings({ snapshotMaxDepth: 30 });\n    } catch {\n      // snapshotMaxDepth not supported on older XCUITest drivers\n    }\n\n    try {\n      return await client.execute<string>('mobile: source', [\n        { format: 'xml' },\n      ]);\n    } catch {\n      return client.getPageSource();\n    }\n  }\n\n  async screenshot(): Promise<ScreenshotResult> {\n    const client = this.#requireClient();\n    const data = await client.execute<string>('mobile: getScreenshot', []);\n    return { data, format: 'png' };\n  }\n\n  async openApp(bundleId: string): Promise<void> {\n    const client = this.#requireClient();\n    await client.execute('mobile: activateApp', [{ bundleId }]);\n  }\n\n  async closeApp(bundleId: string): Promise<void> {\n    const client = this.#requireClient();\n    await client.execute('mobile: terminateApp', [{ bundleId }]);\n  }\n\n  async pressButton(button: DeviceButton): Promise<void> {\n    const client = this.#requireClient();\n    if (this.platform === 'ios') {\n      const iosMap: Record<DeviceButton, string> = {\n        home: 'home',\n        lock: 'lock',\n        back: 'home',\n        enter: '\\n',\n      };\n      await client.execute('mobile: pressButton', [{ name: iosMap[button] }]);\n    } else {\n      // Android keyevent codes\n      const androidMap: Record<DeviceButton, number> = {\n        home: 3,\n        back: 4,\n        enter: 66,\n        lock: 26,\n      };\n      await client.execute('mobile: pressKey', [\n        { keycode: androidMap[button] },\n      ]);\n    }\n  }\n\n  async dismissKeyboard(): Promise<void> {\n    const client = this.#requireClient();\n    if (this.platform === 'ios') {\n      await client.execute('mobile: hideKeyboard', []);\n    } else {\n      await client.execute('mobile: hideKeyboard', []);\n    }\n  }\n\n  async dismissAlert(accept: boolean): Promise<void> {\n    const client = this.#requireClient();\n    const action = accept ? 'accept' : 'dismiss';\n    await client.execute(`mobile: ${action}Alert`, []);\n  }\n\n  async getLogs(durationSeconds = 30, filter?: string): Promise<LogsResult> {\n    const client = this.#requireClient();\n    const logType = this.platform === 'ios' ? 'syslog' : 'logcat';\n    const raw = await client.execute<Record<string, unknown>[]>(\n      'mobile: getLog',\n      [{ type: logType }],\n    );\n\n    let entries = raw.map((entry) => ({\n      timestamp: typeof entry.timestamp === 'string' ? entry.timestamp : '',\n      level: typeof entry.level === 'string' ? entry.level : 'info',\n      message: typeof entry.message === 'string' ? entry.message : '',\n    }));\n\n    if (filter) {\n      const pattern = new RegExp(filter, 'iu');\n      entries = entries.filter((entry) => pattern.test(entry.message));\n    }\n\n    const cutoff = Date.now() - durationSeconds * 1000;\n    entries = entries.filter((entry) => {\n      const ts = Number(entry.timestamp);\n      return isNaN(ts) || ts >= cutoff;\n    });\n\n    return { entries, source: `appium ${logType}` };\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 client = this.#requireClient();\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 client.performActions([\n      {\n        type: 'pointer',\n        id: 'finger1',\n        parameters: { pointerType: 'touch' },\n        actions: [\n          { type: 'pointerMove', duration: 0, x: cx, y: cy },\n          { type: 'pointerDown', button: 0 },\n          { type: 'pause', duration: durationMs },\n          { type: 'pointerUp', button: 0 },\n        ],\n      },\n    ]);\n    await client.releaseActions();\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 client = this.#requireClient();\n    try {\n      return await client.execute<string>('mobile: getAlertText', []);\n    } catch {\n      const snap = await this.snapshot();\n      const texts = collectAppiumAlertTexts(snap.hierarchy, this.platform);\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\n  async getWindowSize(): Promise<WindowSize> {\n    const client = this.#requireClient();\n    try {\n      const rect = await client.getWindowRect();\n      return { width: rect.width, height: rect.height };\n    } catch {\n      const snap = await this.snapshot();\n      if (snap.hierarchy.length > 0) {\n        const root = snap.hierarchy[0];\n        if (root.frame.width > 0 && root.frame.height > 0) {\n          return { width: root.frame.width, height: root.frame.height };\n        }\n      }\n      throw new Error('Unable to determine window size');\n    }\n  }\n\n  async getContexts(): Promise<string[]> {\n    const client = this.#requireClient();\n    return client.getContexts();\n  }\n\n  async setContext(context: string): Promise<void> {\n    const client = this.#requireClient();\n    await client.setCurrentContext(context);\n  }\n\n  async getClipboard(): Promise<string> {\n    const client = this.#requireClient();\n    const b64 = await client.execute<string>('mobile: getClipboard', [\n      { contentType: 'plaintext' },\n    ]);\n    return Buffer.from(b64, 'base64').toString('utf-8');\n  }\n\n  async setClipboard(text: string): Promise<void> {\n    const client = this.#requireClient();\n    await client.execute('mobile: setClipboard', [\n      {\n        content: Buffer.from(text).toString('base64'),\n        contentType: 'plaintext',\n      },\n    ]);\n  }\n\n  async startScreenRecording(outputPath?: string): Promise<void> {\n    if (this.#recording) {\n      throw new Error('Screen recording is already in progress');\n    }\n    const client = this.#requireClient();\n    await client.execute('mobile: startRecordingScreen', [{}]);\n    this.#recording = true;\n    this.#recordingOutputPath = resolvePath(\n      outputPath ?? `/tmp/device-mcp-recording-${Date.now()}.mp4`,\n    );\n  }\n\n  async stopScreenRecording(): Promise<string> {\n    if (!this.#recording || !this.#recordingOutputPath) {\n      throw new Error('No screen recording in progress');\n    }\n    const client = this.#requireClient();\n    const b64 = await client.execute<string>('mobile: stopRecordingScreen', []);\n    const data = Buffer.from(b64, 'base64');\n    if (data.length === 0) {\n      throw new Error('Screen recording returned empty data');\n    }\n    const outputPath = resolvePath(this.#recordingOutputPath);\n    writeFileSync(outputPath, data);\n    this.#recording = false;\n    this.#recordingOutputPath = null;\n    return outputPath;\n  }\n\n  #requireClient(): WebDriverClient {\n    if (!this.#client) {\n      throw new Error(\n        'AppiumBackend not connected. Call ensureConnected() first.',\n      );\n    }\n    return this.#client;\n  }\n}\n\nfunction collectAppiumAlertTexts(\n  elements: UIElement[],\n  platform: Platform,\n): string[] {\n  const texts: string[] = [];\n  for (const el of elements) {\n    const isAlert =\n      platform === 'ios'\n        ? el.type === 'Alert' || el.type === 'Sheet'\n        : el.type.includes('Dialog');\n    if (isAlert) {\n      collectAppiumTextValues(el.children ?? [], texts);\n      return texts;\n    }\n    if (el.children) {\n      const found = collectAppiumAlertTexts(el.children, platform);\n      if (found.length > 0) {\n        return found;\n      }\n    }\n  }\n  return texts;\n}\n\nfunction collectAppiumTextValues(elements: UIElement[], texts: string[]): void {\n  for (const el of elements) {\n    const text = el.value ?? el.label;\n    if (\n      text &&\n      (el.type === 'StaticText' ||\n        el.type.includes('TextView') ||\n        el.type === 'Text')\n    ) {\n      texts.push(text);\n    }\n    if (el.children) {\n      collectAppiumTextValues(el.children, texts);\n    }\n  }\n}\n\nfunction extractElementId(element: Record<string, string>): string {\n  // W3C uses 'element-6066-11e4-a52e-4f735466cecf', JSONWP uses 'ELEMENT'\n  const id =\n    element['element-6066-11e4-a52e-4f735466cecf'] ||\n    element.ELEMENT ||\n    Object.values(element)[0];\n\n  if (!id) {\n    throw new Error(\n      `Failed to extract element ID from Appium response: ${JSON.stringify(element)}`,\n    );\n  }\n  return id;\n}\n\nexport function parseAppiumAndroidHierarchy(xml: string): UIElement[] {\n  const elements: UIElement[] = [];\n  const nodeRegex = /<node\\s+([^>]+)\\/?>/gu;\n  let match;\n\n  while ((match = nodeRegex.exec(xml)) !== null) {\n    const element = parseAndroidNodeAttrs(match[1]);\n    if (element) {\n      elements.push(element);\n    }\n  }\n\n  return elements;\n}\n\nfunction parseAndroidNodeAttrs(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\nexport function parseAppiumIosHierarchy(xml: string): UIElement[] {\n  const elements: UIElement[] = [];\n  // XCUITest XML uses <XCUIElementType* ...> elements\n  const nodeRegex = /<(XCUIElementType\\w+)\\s+([^>]+)\\/?>/gu;\n  let match;\n\n  while ((match = nodeRegex.exec(xml)) !== null) {\n    const typeName = match[1];\n    const element = parseIosNodeAttrs(typeName, match[2]);\n    if (element) {\n      elements.push(element);\n    }\n  }\n\n  return elements;\n}\n\nfunction parseIosNodeAttrs(typeName: string, 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 xStr = get('x');\n  const yStr = get('y');\n  const widthStr = get('width');\n  const heightStr = get('height');\n\n  if (!xStr || !yStr || !widthStr || !heightStr) {\n    return null;\n  }\n\n  const shortType = typeName.replace(/^XCUIElementType/u, '');\n\n  return {\n    type: shortType,\n    label: get('label') || undefined,\n    value: get('value') || undefined,\n    identifier: get('name') || undefined,\n    frame: {\n      x: parseInt(xStr, 10),\n      y: parseInt(yStr, 10),\n      width: parseInt(widthStr, 10),\n      height: parseInt(heightStr, 10),\n    },\n    enabled: get('enabled') !== 'false',\n  };\n}\n"]}

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

@@ -0,0 +1,36 @@
+import type { SessionConfig } from "./session-file.cjs";
+import type { DeviceBackend, DeviceButton, DeviceInfo, SnapshotResult, ScreenshotResult, LogsResult, TapResult, AppStateResult, ElementQuery, UIElement, Platform, WindowSize } from "./types.cjs";
+export declare class AppiumBackend implements DeviceBackend {
+    #private;
+    readonly platform: Platform;
+    constructor(config: SessionConfig);
+    ensureConnected(): Promise<void>;
+    getDeviceInfo(): Promise<DeviceInfo>;
+    snapshot(): Promise<SnapshotResult>;
+    tapElement(query: ElementQuery): Promise<TapResult>;
+    tapCoordinates(targetX: number, targetY: 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(): 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 parseAppiumAndroidHierarchy(xml: string): UIElement[];
+export declare function parseAppiumIosHierarchy(xml: string): UIElement[];
+//# sourceMappingURL=appium-backend.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"appium-backend.d.cts","sourceRoot":"","sources":["../../src/backends/appium-backend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,2BAA0B;AACvD,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,cAAc,EACd,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,UAAU,EACX,oBAAmB;AAQpB,qBAAa,aAAc,YAAW,aAAa;;IACjD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAUhB,MAAM,EAAE,aAAa;IAK3B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBhC,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAcpC,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAgBnC,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAsBnD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB/D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrC,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;IAuBV,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;IAgDtD,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAMvC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBhD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,OAAO,CAAC,eAAe,SAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA4BnE,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,SAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAoCrE,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;IAiB/B,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAiBpC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKhC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ/B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzC,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxD,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;CAyB7C;AA0DD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAapE;AAkCD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAehE"}