devlens-mcp 0.3.0

package/dist/src/platform/android/android-device.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AndroidDevice = void 0;
+const adb_js_1 = require("./adb.js");
+const ui_automator_js_1 = require("./ui-automator.js");
+// Android key codes
+const KEY_HOME = 3;
+const KEY_BACK = 4;
+const KEY_ENTER = 66;
+class AndroidDevice {
+    adb;
+    constructor(deviceId) {
+        this.adb = new adb_js_1.Adb(deviceId);
+    }
+    async getInfo() {
+        const [screenSize, orientation, version, name] = await Promise.all([
+            this.adb.getScreenSize(),
+            this.adb.getOrientation(),
+            this.adb.getAndroidVersion(),
+            this.adb.getDeviceName(),
+        ]);
+        return {
+            id: this.adb.deviceId,
+            name,
+            platform: "android",
+            osVersion: version,
+            screenWidth: screenSize.width,
+            screenHeight: screenSize.height,
+            orientation: orientation === 0 || orientation === 2 ? "portrait" : "landscape",
+            isBooted: true,
+        };
+    }
+    async getSnapshot() {
+        const xml = await this.adb.dumpUiHierarchy();
+        return (0, ui_automator_js_1.parseUiAutomatorXml)(xml);
+    }
+    async takeScreenshot() {
+        return this.adb.screenshot();
+    }
+    async tap(x, y) {
+        await this.adb.tap(x, y);
+    }
+    async doubleTap(x, y) {
+        await this.adb.tap(x, y);
+        await sleep(100);
+        await this.adb.tap(x, y);
+    }
+    async longPress(x, y, durationMs = 1000) {
+        await this.adb.longPress(x, y, durationMs);
+    }
+    async typeText(text) {
+        await this.adb.typeText(text);
+    }
+    async swipe(startX, startY, endX, endY, durationMs = 300) {
+        await this.adb.swipe(startX, startY, endX, endY, durationMs);
+    }
+    async pressButton(button) {
+        const keyMap = {
+            home: KEY_HOME,
+            back: KEY_BACK,
+            enter: KEY_ENTER,
+        };
+        await this.adb.keyEvent(keyMap[button]);
+    }
+    async setOrientation(orientation) {
+        const rotation = orientation === "portrait" ? 0 : 1;
+        await this.adb.setRotation(rotation);
+    }
+    async launchApp(appId) {
+        await this.adb.launchApp(appId);
+    }
+    async terminateApp(appId) {
+        await this.adb.terminateApp(appId);
+    }
+    async installApp(path) {
+        await this.adb.installApp(path);
+    }
+    async listApps() {
+        const packages = await this.adb.listPackages();
+        return packages.map((pkg) => ({
+            appId: pkg,
+            name: pkg,
+            isRunning: false, // Would need `ps` to determine
+        }));
+    }
+    async openUrl(url) {
+        await this.adb.openUrl(url);
+    }
+}
+exports.AndroidDevice = AndroidDevice;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=android-device.js.map

package/dist/src/platform/android/android-device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"android-device.js","sourceRoot":"","sources":["../../../../src/platform/android/android-device.ts"],"names":[],"mappings":"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"}

package/dist/src/platform/android/ui-automator.d.ts

@@ -0,0 +1,17 @@
+import type { SnapshotNode } from "../device.js";
+/**
+ * Parses Android UI Automator XML dump into SnapshotNode tree.
+ *
+ * The XML format from `uiautomator dump` looks like:
+ * <hierarchy rotation="0">
+ *   <node index="0" text="" resource-id="..." class="android.widget.FrameLayout"
+ *         package="com.example" content-desc="" checkable="false" checked="false"
+ *         clickable="false" enabled="true" focusable="false" focused="false"
+ *         scrollable="false" long-clickable="false" password="false" selected="false"
+ *         bounds="[0,0][1080,2340]">
+ *     <node ... />
+ *   </node>
+ * </hierarchy>
+ */
+export declare function parseUiAutomatorXml(xml: string): SnapshotNode;
+//# sourceMappingURL=ui-automator.d.ts.map

package/dist/src/platform/android/ui-automator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-automator.d.ts","sourceRoot":"","sources":["../../../../src/platform/android/ui-automator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAU,MAAM,cAAc,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CA+B7D"}

package/dist/src/platform/android/ui-automator.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUiAutomatorXml = parseUiAutomatorXml;
+const fast_xml_parser_1 = require("fast-xml-parser");
+/**
+ * Parses Android UI Automator XML dump into SnapshotNode tree.
+ *
+ * The XML format from `uiautomator dump` looks like:
+ * <hierarchy rotation="0">
+ *   <node index="0" text="" resource-id="..." class="android.widget.FrameLayout"
+ *         package="com.example" content-desc="" checkable="false" checked="false"
+ *         clickable="false" enabled="true" focusable="false" focused="false"
+ *         scrollable="false" long-clickable="false" password="false" selected="false"
+ *         bounds="[0,0][1080,2340]">
+ *     <node ... />
+ *   </node>
+ * </hierarchy>
+ */
+function parseUiAutomatorXml(xml) {
+    const parser = new fast_xml_parser_1.XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: "@_",
+        allowBooleanAttributes: true,
+        isArray: (name) => name === "node",
+    });
+    const parsed = parser.parse(xml);
+    const hierarchy = parsed.hierarchy;
+    if (!hierarchy || !hierarchy.node) {
+        throw new Error("Invalid UI Automator dump: no hierarchy or root node found");
+    }
+    const rootNodes = Array.isArray(hierarchy.node)
+        ? hierarchy.node
+        : [hierarchy.node];
+    // Create a virtual root that contains all top-level nodes
+    return {
+        type: "hierarchy",
+        text: undefined,
+        label: undefined,
+        description: undefined,
+        bounds: { x: 0, y: 0, width: 0, height: 0 },
+        interactive: false,
+        children: rootNodes.map(convertNode),
+    };
+}
+function convertNode(node) {
+    const bounds = parseBounds(node["@_bounds"] || "[0,0][0,0]");
+    const text = node["@_text"] || undefined;
+    const description = node["@_content-desc"] || undefined;
+    const resourceId = node["@_resource-id"] || undefined;
+    const className = node["@_class"] || "unknown";
+    const clickable = node["@_clickable"] === "true";
+    const longClickable = node["@_long-clickable"] === "true";
+    const checkable = node["@_checkable"] === "true";
+    const scrollable = node["@_scrollable"] === "true";
+    const focusable = node["@_focusable"] === "true";
+    const interactive = clickable || longClickable || checkable || scrollable || focusable;
+    const children = [];
+    if (node.node) {
+        const childNodes = Array.isArray(node.node) ? node.node : [node.node];
+        for (const child of childNodes) {
+            children.push(convertNode(child));
+        }
+    }
+    return {
+        type: simplifyClassName(className),
+        text: text && text.length > 0 ? text : undefined,
+        label: description && description.length > 0 ? description : undefined,
+        description: description && description.length > 0 ? description : undefined,
+        bounds,
+        interactive,
+        focused: node["@_focused"] === "true",
+        enabled: node["@_enabled"] === "true",
+        visible: bounds.width > 0 && bounds.height > 0,
+        value: getElementValue(node),
+        resourceId: resourceId && resourceId.length > 0 ? resourceId : undefined,
+        children,
+        rawAttributes: extractRawAttributes(node),
+    };
+}
+/** Parse Android bounds format "[left,top][right,bottom]" into Bounds */
+function parseBounds(boundsStr) {
+    const match = boundsStr.match(/\[(\d+),(\d+)\]\[(\d+),(\d+)\]/);
+    if (!match) {
+        return { x: 0, y: 0, width: 0, height: 0 };
+    }
+    const left = parseInt(match[1]);
+    const top = parseInt(match[2]);
+    const right = parseInt(match[3]);
+    const bottom = parseInt(match[4]);
+    return {
+        x: left,
+        y: top,
+        width: right - left,
+        height: bottom - top,
+    };
+}
+/** Simplify Android class names for readability */
+function simplifyClassName(className) {
+    // "android.widget.TextView" → "TextView"
+    // "android.view.View" → "View"
+    const parts = className.split(".");
+    return parts[parts.length - 1];
+}
+/** Extract element value (for checkboxes, switches, inputs, etc.) */
+function getElementValue(node) {
+    if (node["@_checked"] === "true")
+        return "checked";
+    if (node["@_checked"] === "false" && node["@_checkable"] === "true")
+        return "unchecked";
+    if (node["@_selected"] === "true")
+        return "selected";
+    if (node["@_password"] === "true")
+        return "•••";
+    return undefined;
+}
+/** Extract all raw attributes for debugging */
+function extractRawAttributes(node) {
+    const attrs = {};
+    for (const key of Object.keys(node)) {
+        if (key.startsWith("@_")) {
+            attrs[key.replace("@_", "")] = String(node[key]);
+        }
+    }
+    return attrs;
+}
+//# sourceMappingURL=ui-automator.js.map

package/dist/src/platform/android/ui-automator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-automator.js","sourceRoot":"","sources":["../../../../src/platform/android/ui-automator.ts"],"names":[],"mappings":"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"}

package/dist/src/platform/device-manager.d.ts

@@ -0,0 +1,28 @@
+import type { Device } from "./device.js";
+export interface DiscoveredDevice {
+    id: string;
+    name: string;
+    platform: "ios" | "android";
+    osVersion: string;
+    isBooted: boolean;
+}
+/**
+ * DeviceManager discovers running iOS Simulators and Android Emulators,
+ * and creates Device instances for them.
+ */
+export declare class DeviceManager {
+    private activeDevice;
+    private activeDeviceId;
+    private activePlatform;
+    discoverDevices(): Promise<DiscoveredDevice[]>;
+    getDevice(deviceId?: string): Promise<Device>;
+    /**
+     * Quick health check to verify a cached device is still alive.
+     * Returns false if the device is disconnected or no longer booted.
+     */
+    private checkDeviceHealth;
+    private discoverAndroidDevices;
+    private discoverIosDevices;
+    private getAdbPath;
+}
+//# sourceMappingURL=device-manager.d.ts.map

package/dist/src/platform/device-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-manager.d.ts","sourceRoot":"","sources":["../../../src/platform/device-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,aAAa,CAAC;AAMtD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,cAAc,CAAkC;IAElD,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAkB9C,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqDnD;;;OAGG;YACW,iBAAiB;YAgCjB,sBAAsB;YAkDtB,kBAAkB;IAsChC,OAAO,CAAC,UAAU;CAQnB"}

package/dist/src/platform/device-manager.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceManager = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const android_device_js_1 = require("./android/android-device.js");
+const ios_device_js_1 = require("./ios/ios-device.js");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+/**
+ * DeviceManager discovers running iOS Simulators and Android Emulators,
+ * and creates Device instances for them.
+ */
+class DeviceManager {
+    activeDevice = null;
+    activeDeviceId = null;
+    activePlatform = null;
+    async discoverDevices() {
+        const devices = [];
+        const [androidDevices, iosDevices] = await Promise.allSettled([
+            this.discoverAndroidDevices(),
+            this.discoverIosDevices(),
+        ]);
+        if (androidDevices.status === "fulfilled") {
+            devices.push(...androidDevices.value);
+        }
+        if (iosDevices.status === "fulfilled") {
+            devices.push(...iosDevices.value);
+        }
+        return devices;
+    }
+    async getDevice(deviceId) {
+        // If we have a cached device and it matches, verify it's still healthy
+        if (this.activeDevice &&
+            this.activeDeviceId &&
+            (!deviceId || deviceId === this.activeDeviceId)) {
+            const isHealthy = await this.checkDeviceHealth(this.activeDeviceId, this.activePlatform);
+            if (isHealthy) {
+                return this.activeDevice;
+            }
+            // Device is stale — clear cache and rediscover
+            this.activeDevice = null;
+            this.activeDeviceId = null;
+            this.activePlatform = null;
+        }
+        const devices = await this.discoverDevices();
+        const bootedDevices = devices.filter((d) => d.isBooted);
+        if (bootedDevices.length === 0) {
+            throw new Error("No running simulators or emulators found. Please start a device first.");
+        }
+        let target;
+        if (deviceId) {
+            const found = bootedDevices.find((d) => d.id === deviceId);
+            if (!found) {
+                throw new Error(`Device "${deviceId}" not found or not running. Available: ${bootedDevices.map((d) => d.id).join(", ")}`);
+            }
+            target = found;
+        }
+        else {
+            target = bootedDevices[0];
+        }
+        if (target.platform === "android") {
+            this.activeDevice = new android_device_js_1.AndroidDevice(target.id);
+        }
+        else {
+            this.activeDevice = new ios_device_js_1.IosDevice(target.id);
+        }
+        this.activeDeviceId = target.id;
+        this.activePlatform = target.platform;
+        return this.activeDevice;
+    }
+    /**
+     * Quick health check to verify a cached device is still alive.
+     * Returns false if the device is disconnected or no longer booted.
+     */
+    async checkDeviceHealth(deviceId, platform) {
+        try {
+            if (platform === "android") {
+                const adbPath = this.getAdbPath();
+                const { stdout } = await execFileAsync(adbPath, ["-s", deviceId, "get-state"], {
+                    timeout: 5000,
+                });
+                return stdout.trim() === "device";
+            }
+            else if (platform === "ios") {
+                const { stdout } = await execFileAsync("xcrun", ["simctl", "list", "devices", "--json"], { timeout: 5000 });
+                const data = JSON.parse(stdout);
+                for (const deviceList of Object.values(data.devices)) {
+                    const found = deviceList.find((d) => d.udid === deviceId);
+                    if (found)
+                        return found.state === "Booted";
+                }
+                return false;
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async discoverAndroidDevices() {
+        try {
+            const adbPath = this.getAdbPath();
+            const { stdout } = await execFileAsync(adbPath, ["devices", "-l"]);
+            const devices = [];
+            for (const line of stdout.split("\n").slice(1)) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed === "")
+                    continue;
+                const parts = trimmed.split(/\s+/);
+                const id = parts[0];
+                const status = parts[1];
+                if (status !== "device")
+                    continue;
+                // Extract model name from properties
+                const modelMatch = trimmed.match(/model:(\S+)/);
+                const name = modelMatch ? modelMatch[1] : id;
+                // Get Android version
+                let osVersion = "unknown";
+                try {
+                    const { stdout: versionOut } = await execFileAsync(adbPath, [
+                        "-s",
+                        id,
+                        "shell",
+                        "getprop",
+                        "ro.build.version.release",
+                    ]);
+                    osVersion = versionOut.trim();
+                }
+                catch {
+                    // Ignore version fetch errors
+                }
+                devices.push({
+                    id,
+                    name,
+                    platform: "android",
+                    osVersion,
+                    isBooted: true,
+                });
+            }
+            return devices;
+        }
+        catch {
+            return [];
+        }
+    }
+    async discoverIosDevices() {
+        try {
+            const { stdout } = await execFileAsync("xcrun", [
+                "simctl",
+                "list",
+                "devices",
+                "--json",
+            ]);
+            const data = JSON.parse(stdout);
+            const devices = [];
+            for (const [runtime, deviceList] of Object.entries(data.devices)) {
+                const osVersion = runtime.replace(/^com\.apple\.CoreSimulator\.SimRuntime\./, "").replace(/-/g, ".").replace(/^iOS\./, "");
+                for (const device of deviceList) {
+                    if (device.state === "Booted") {
+                        devices.push({
+                            id: device.udid,
+                            name: device.name,
+                            platform: "ios",
+                            osVersion,
+                            isBooted: true,
+                        });
+                    }
+                }
+            }
+            return devices;
+        }
+        catch {
+            return [];
+        }
+    }
+    getAdbPath() {
+        const androidHome = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
+        if (androidHome) {
+            return `${androidHome}/platform-tools/adb`;
+        }
+        return "adb";
+    }
+}
+exports.DeviceManager = DeviceManager;
+//# sourceMappingURL=device-manager.js.map

package/dist/src/platform/device-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-manager.js","sourceRoot":"","sources":["../../../src/platform/device-manager.ts"],"names":[],"mappings":"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"}

package/dist/src/platform/device.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Abstract Device interface — the core abstraction that iOS and Android drivers implement.
+ * Every MCP tool delegates to this interface. Tools never know which platform they're on.
+ */
+export interface DeviceInfo {
+    id: string;
+    name: string;
+    platform: "ios" | "android";
+    osVersion: string;
+    screenWidth: number;
+    screenHeight: number;
+    orientation: "portrait" | "landscape";
+    isBooted: boolean;
+}
+export interface AppInfo {
+    appId: string;
+    name: string;
+    isRunning: boolean;
+}
+export interface Bounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface SnapshotNode {
+    /** Element class/type (e.g., "android.widget.TextView", "UILabel") */
+    type: string;
+    /** Text content of the element */
+    text?: string;
+    /** Accessibility label */
+    label?: string;
+    /** Content description / accessibility hint */
+    description?: string;
+    /** Bounding box in screen coordinates */
+    bounds: Bounds;
+    /** Whether the element is interactive (clickable, tappable) */
+    interactive: boolean;
+    /** Whether the element is focused */
+    focused?: boolean;
+    /** Whether the element is enabled */
+    enabled?: boolean;
+    /** Whether the element is visible */
+    visible?: boolean;
+    /** Element value (for inputs, toggles, etc.) */
+    value?: string;
+    /** Resource ID (Android) or accessibility identifier (iOS) */
+    resourceId?: string;
+    /** Child elements */
+    children: SnapshotNode[];
+    /** Platform-specific raw attributes (for debugging) */
+    rawAttributes?: Record<string, string>;
+}
+export interface Device {
+    /** Get device information */
+    getInfo(): Promise<DeviceInfo>;
+    /** Get the accessibility tree of the current screen */
+    getSnapshot(): Promise<SnapshotNode>;
+    /** Take a screenshot, returns PNG buffer */
+    takeScreenshot(): Promise<Buffer>;
+    /** Tap at screen coordinates */
+    tap(x: number, y: number): Promise<void>;
+    /** Double-tap at screen coordinates */
+    doubleTap(x: number, y: number): Promise<void>;
+    /** Long press at screen coordinates */
+    longPress(x: number, y: number, durationMs?: number): Promise<void>;
+    /** Type text (assumes an input is already focused) */
+    typeText(text: string): Promise<void>;
+    /** Swipe from one point to another */
+    swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<void>;
+    /** Press a hardware/system button */
+    pressButton(button: "home" | "back" | "enter"): Promise<void>;
+    /** Set device orientation */
+    setOrientation(orientation: "portrait" | "landscape"): Promise<void>;
+    /** Launch an app by its bundle/package ID */
+    launchApp(appId: string): Promise<void>;
+    /** Terminate a running app */
+    terminateApp(appId: string): Promise<void>;
+    /** Install an app from a file path */
+    installApp(path: string): Promise<void>;
+    /** List installed apps */
+    listApps(): Promise<AppInfo[]>;
+    /** Open a URL (deep link or web URL) */
+    openUrl(url: string): Promise<void>;
+}
+//# sourceMappingURL=device.d.ts.map

package/dist/src/platform/device.d.ts.map

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

package/dist/src/platform/device.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Abstract Device interface — the core abstraction that iOS and Android drivers implement.
+ * Every MCP tool delegates to this interface. Tools never know which platform they're on.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=device.js.map

package/dist/src/platform/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../../src/platform/device.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/src/platform/ios/accessibility.d.ts

@@ -0,0 +1,17 @@
+import type { SnapshotNode } from "../device.js";
+/**
+ * Parses iOS accessibility output from `simctl ui` into SnapshotNode tree.
+ *
+ * The simctl accessibility output varies by iOS/Xcode version. This parser
+ * handles the common formats:
+ *
+ * Format 1 (structured):
+ *   Element: UIButton, Label: "Submit", Traits: Button, Frame: {{20, 100}, {340, 44}}
+ *
+ * Format 2 (XML-like from accessibility inspector):
+ *   <AXElement type="UIButton" label="Submit" frame="20 100 340 44" ...>
+ *
+ * When neither format is available, we fall back to a basic tree.
+ */
+export declare function parseIosAccessibilityOutput(output: string): SnapshotNode;
+//# sourceMappingURL=accessibility.d.ts.map

package/dist/src/platform/ios/accessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../../../src/platform/ios/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAU,MAAM,cAAc,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,GACb,YAAY,CAad"}