appium-desktop-driver 1.2.0

package/build/lib/driver.d.ts

@@ -0,0 +1,36 @@
+import { BaseDriver } from '@appium/base-driver';
+import { ChildProcessWithoutNullStreams } from 'node:child_process';
+import type { ScreenRecorder } from './commands/screen-recorder';
+import { NovaWindowsDriverConstraints } from './constraints';
+import type { DefaultCreateSessionResult, DriverData, Element, InitialOpts, StringRecord, W3CDriverCaps } from '@appium/types';
+type W3CNovaWindowsDriverCaps = W3CDriverCaps<NovaWindowsDriverConstraints>;
+type DefaultWindowsCreateSessionResult = DefaultCreateSessionResult<NovaWindowsDriverConstraints>;
+type KeyboardState = {
+    pressed: Set<string>;
+    shift: boolean;
+    ctrl: boolean;
+    meta: boolean;
+    alt: boolean;
+};
+declare const LOCATION_STRATEGIES: readonly ["id", "name", "xpath", "tag name", "class name", "accessibility id", "-windows uiautomation"];
+export declare class NovaWindowsDriver extends BaseDriver<NovaWindowsDriverConstraints, StringRecord> {
+    isPowerShellSessionStarted: boolean;
+    powerShell?: ChildProcessWithoutNullStreams;
+    powerShellStdOut: string;
+    powerShellStdErr: string;
+    appProcessIds: number[];
+    keyboardState: KeyboardState;
+    _screenRecorder: ScreenRecorder | null;
+    constructor(opts?: InitialOpts, shouldValidateCaps?: boolean);
+    findElement(strategy: string, selector: string): Promise<Element>;
+    findElements(strategy: string, selector: string): Promise<Element[]>;
+    findElementFromElement(strategy: string, selector: string, elementId: string): Promise<Element>;
+    findElementsFromElement(strategy: string, selector: string, elementId: string): Promise<Element[]>;
+    findElOrEls(strategy: typeof LOCATION_STRATEGIES[number], selector: string, mult: true, context?: string): Promise<Element[]>;
+    findElOrEls(strategy: typeof LOCATION_STRATEGIES[number], selector: string, mult: false, context?: string): Promise<Element>;
+    createSession(jwpCaps: W3CNovaWindowsDriverCaps, reqCaps?: W3CNovaWindowsDriverCaps, w3cCaps?: W3CNovaWindowsDriverCaps, driverData?: DriverData[]): Promise<DefaultWindowsCreateSessionResult>;
+    deleteSession(sessionId?: string | null | undefined): Promise<void>;
+    private processSelector;
+}
+export {};
+//# sourceMappingURL=driver.d.ts.map

package/build/lib/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../lib/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EACH,4BAA4B,EAE/B,MAAM,eAAe,CAAC;AAoBvB,OAAO,KAAK,EACR,0BAA0B,EAC1B,UAAU,EACV,OAAO,EACP,WAAW,EACX,YAAY,EACZ,aAAa,EAChB,MAAM,eAAe,CAAC;AAEvB,KAAK,wBAAwB,GAAG,aAAa,CAAC,4BAA4B,CAAC,CAAC;AAC5E,KAAK,iCAAiC,GAAG,0BAA0B,CAAC,4BAA4B,CAAC,CAAC;AAElG,KAAK,aAAa,GAAG;IACjB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CAChB,CAAA;AAED,QAAA,MAAM,mBAAmB,yGAQd,CAAC;AAEZ,qBAAa,iBAAkB,SAAQ,UAAU,CAAC,4BAA4B,EAAE,YAAY,CAAC;IACzF,0BAA0B,EAAE,OAAO,CAAS;IAC5C,UAAU,CAAC,EAAE,8BAA8B,CAAC;IAC5C,gBAAgB,EAAE,MAAM,CAAM;IAC9B,gBAAgB,EAAE,MAAM,CAAM;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAM;IAC7B,aAAa,EAAE,aAAa,CAM1B;IACF,eAAe,EAAE,cAAc,GAAG,IAAI,CAAQ;gBAElC,IAAI,GAAE,WAA+B,EAAE,kBAAkB,UAAO;IAa7D,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAKpE,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/F,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAKlG,WAAW,CAAC,QAAQ,EAAE,OAAO,mBAAmB,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7H,WAAW,CAAC,QAAQ,EAAE,OAAO,mBAAmB,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA8C5H,aAAa,CACxB,OAAO,EAAE,wBAAwB,EACjC,OAAO,CAAC,EAAE,wBAAwB,EAClC,OAAO,CAAC,EAAE,wBAAwB,EAClC,UAAU,CAAC,EAAE,UAAU,EAAE,GAC1B,OAAO,CAAC,iCAAiC,CAAC;IA0D9B,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAgClF,OAAO,CAAC,eAAe;CA4B1B"}

package/build/lib/driver.js

@@ -0,0 +1,209 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NovaWindowsDriver = void 0;
+const base_driver_1 = require("@appium/base-driver");
+const support_1 = require("appium/support");
+const commands_1 = __importDefault(require("./commands"));
+const constraints_1 = require("./constraints");
+const powershell_1 = require("./powershell");
+const util_1 = require("./util");
+const user32_1 = require("./winapi/user32");
+const xpath_1 = require("./xpath");
+const LOCATION_STRATEGIES = Object.freeze([
+    'id',
+    'name',
+    'xpath',
+    'tag name',
+    'class name',
+    'accessibility id',
+    '-windows uiautomation',
+]);
+class NovaWindowsDriver extends base_driver_1.BaseDriver {
+    isPowerShellSessionStarted = false;
+    powerShell;
+    powerShellStdOut = '';
+    powerShellStdErr = '';
+    appProcessIds = [];
+    keyboardState = {
+        pressed: new Set(),
+        alt: false,
+        ctrl: false,
+        meta: false,
+        shift: false,
+    };
+    _screenRecorder = null;
+    constructor(opts = {}, shouldValidateCaps = true) {
+        super(opts, shouldValidateCaps);
+        this.locatorStrategies = [...LOCATION_STRATEGIES];
+        this.desiredCapConstraints = constraints_1.UI_AUTOMATION_DRIVER_CONSTRAINTS;
+        // Bind commands to this instance (not prototype) so each driver instance uses its own
+        // PowerShell session and state when multiple sessions exist
+        for (const key in commands_1.default) { // TODO: create a decorator that will do that for the class
+            this[key] = commands_1.default[key].bind(this);
+        }
+    }
+    async findElement(strategy, selector) {
+        [strategy, selector] = this.processSelector(strategy, selector);
+        return super.findElement(strategy, selector);
+    }
+    async findElements(strategy, selector) {
+        [strategy, selector] = this.processSelector(strategy, selector);
+        return super.findElements(strategy, selector);
+    }
+    async findElementFromElement(strategy, selector, elementId) {
+        [strategy, selector] = this.processSelector(strategy, selector);
+        return super.findElementFromElement(strategy, selector, elementId);
+    }
+    async findElementsFromElement(strategy, selector, elementId) {
+        [strategy, selector] = this.processSelector(strategy, selector);
+        return super.findElementsFromElement(strategy, selector, elementId);
+    }
+    async findElOrEls(strategy, selector, mult, context) {
+        let condition;
+        switch (strategy) {
+            case 'id':
+                condition = new powershell_1.PropertyCondition(powershell_1.Property.RUNTIME_ID, new powershell_1.PSInt32Array(selector.split('.').map(Number)));
+                break;
+            case 'tag name':
+                condition = new powershell_1.PropertyCondition(powershell_1.Property.CONTROL_TYPE, new powershell_1.PSControlType(selector));
+                break;
+            case 'accessibility id':
+                condition = new powershell_1.PropertyCondition(powershell_1.Property.AUTOMATION_ID, new powershell_1.PSString(selector));
+                break;
+            case 'name':
+                condition = new powershell_1.PropertyCondition(powershell_1.Property.NAME, new powershell_1.PSString(selector));
+                break;
+            case 'class name':
+                condition = new powershell_1.PropertyCondition(powershell_1.Property.CLASS_NAME, new powershell_1.PSString(selector));
+                break;
+            case '-windows uiautomation':
+                condition = (0, powershell_1.convertStringToCondition)(selector);
+                break;
+            case 'xpath':
+                return await (0, xpath_1.xpathToElIdOrIds)(selector, mult, context, this.sendPowerShellCommand.bind(this));
+            default:
+                throw new base_driver_1.errors.InvalidArgumentError(`Invalid find strategy ${strategy}`);
+        }
+        const searchContext = context ? new powershell_1.FoundAutomationElement(context) : powershell_1.AutomationElement.automationRoot;
+        if (mult) {
+            const result = await this.sendPowerShellCommand(searchContext.findAll(powershell_1.TreeScope.DESCENDANTS, condition).buildCommand());
+            const elIds = result.split('\n').map((elId) => elId.trim()).filter(Boolean);
+            return elIds.filter(Boolean).map((elId) => ({ [base_driver_1.W3C_ELEMENT_KEY]: elId }));
+        }
+        const result = await this.sendPowerShellCommand(searchContext.findFirst(powershell_1.TreeScope.DESCENDANTS, condition).buildCommand());
+        const elId = result.trim();
+        if (!elId) {
+            throw new base_driver_1.errors.NoSuchElementError();
+        }
+        return { [base_driver_1.W3C_ELEMENT_KEY]: elId };
+    }
+    async createSession(jwpCaps, reqCaps, w3cCaps, driverData) {
+        if (!support_1.system.isWindows()) {
+            this.log.errorWithException('Windows UI Automation tests only run on Windows.');
+        }
+        if (typeof w3cCaps?.alwaysMatch?.['appium:appTopLevelWindow'] === 'number') {
+            w3cCaps.alwaysMatch['appium:appTopLevelWindow'] = String(w3cCaps.alwaysMatch['appium:appTopLevelWindow']);
+        }
+        if (typeof w3cCaps?.firstMatch?.some['appium:appTopLevelWindow'] === 'number') {
+            w3cCaps.firstMatch['appium:appTopLevelWindow'] = w3cCaps.firstMatch['appium:appTopLevelWindow'].map(String);
+        }
+        try {
+            this.log.debug('Creating NovaWindows driver session...');
+            const [sessionId, caps] = await super.createSession(jwpCaps, reqCaps, w3cCaps, driverData);
+            if (caps.smoothPointerMove) {
+                (0, util_1.assertSupportedEasingFunction)(caps.smoothPointerMove);
+            }
+            if (caps.app && caps.appTopLevelWindow) {
+                throw new base_driver_1.errors.InvalidArgumentError('Invalid capabilities. Specify either app or appTopLevelWindow.');
+            }
+            if (caps.appEnvironment) {
+                const invalidKeys = Object.entries(caps.appEnvironment)
+                    .filter(([, v]) => typeof v !== 'string')
+                    .map(([k]) => k);
+                if (invalidKeys.length > 0) {
+                    throw new base_driver_1.errors.InvalidArgumentError(`Invalid capabilities. 'appEnvironment' values must be strings. Invalid keys: ${invalidKeys.join(', ')}`);
+                }
+            }
+            if (caps['ms:windowSwitchRetries'] !== undefined) {
+                (0, util_1.assertIntegerCap)('ms:windowSwitchRetries', caps['ms:windowSwitchRetries'], 0);
+            }
+            if (caps['ms:windowSwitchInterval'] !== undefined) {
+                (0, util_1.assertIntegerCap)('ms:windowSwitchInterval', caps['ms:windowSwitchInterval'], 0);
+            }
+            if (this.caps.shouldCloseApp === undefined) {
+                this.caps.shouldCloseApp = true; // set default value
+            }
+            await this.startPowerShellSession();
+            if (this.caps.prerun) {
+                this.log.info('Executing prerun PowerShell script...');
+                await this.executePowerShellScript(this.caps.prerun);
+            }
+            (0, user32_1.setDpiAwareness)();
+            this.log.debug(`Started session ${sessionId}.`);
+            return [sessionId, caps];
+        }
+        catch (e) {
+            await this.deleteSession();
+            throw e;
+        }
+    }
+    async deleteSession(sessionId) {
+        this.log.debug('Deleting NovaWindows driver session...');
+        if (this.caps.shouldCloseApp && this.caps.app && this.caps.app.toLowerCase() !== 'root') {
+            try {
+                if (this.caps['ms:forcequit'] === true) {
+                    await this.sendPowerShellCommand(/* ps1 */ `
+                        if ($null -ne $rootElement) {
+                            $processId = $rootElement.Current.ProcessId
+                            Stop-Process -Id $processId -Force -ErrorAction SilentlyContinue
+                        }
+                    `);
+                }
+                else {
+                    const result = await this.sendPowerShellCommand(powershell_1.AutomationElement.automationRoot.buildCommand());
+                    const elementId = result.split('\n').map((id) => id.trim()).filter(Boolean)[0];
+                    if (elementId) {
+                        await this.sendPowerShellCommand(new powershell_1.FoundAutomationElement(elementId).buildCloseCommand());
+                    }
+                }
+            }
+            catch {
+                // noop
+            }
+        }
+        if (this.caps.postrun) {
+            this.log.info('Executing postrun PowerShell script...');
+            await this.executePowerShellScript(this.caps.postrun);
+        }
+        await this.terminatePowerShellSession();
+        await super.deleteSession(sessionId);
+    }
+    processSelector(strategy, selector) {
+        if (strategy !== 'css selector') {
+            return [strategy, selector];
+        }
+        this.log.warn('Warning: Use Appium mobile selectors instead of Selenium By, since most of them are based on CSS.');
+        const digitRegex = /\\3(\d) /;
+        if (selector.startsWith('.')) {
+            selector = selector.substring(1).replace(digitRegex, '$1');
+            strategy = 'class name';
+            return [strategy, selector];
+        }
+        if (selector.startsWith('#')) {
+            selector = selector.substring(1).replace(digitRegex, '$1');
+            strategy = 'id';
+            return [strategy, selector];
+        }
+        if (selector.startsWith('*[name')) {
+            selector = selector.substring(selector.indexOf('"') + 1, selector.lastIndexOf('"')).replace(digitRegex, '$1');
+            strategy = 'name';
+            return [strategy, selector];
+        }
+        return [strategy, selector];
+    }
+}
+exports.NovaWindowsDriver = NovaWindowsDriver;
+//# sourceMappingURL=driver.js.map

package/build/lib/driver.js.map

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

package/build/lib/enums.d.ts

@@ -0,0 +1,89 @@
+type Enumerate<N extends number, Acc extends number[] = []> = Acc['length'] extends N ? Acc[number] : Enumerate<N, [...Acc, Acc['length']]>;
+type IntRange<F extends number, T extends number> = Exclude<Enumerate<T>, Enumerate<F>> | T;
+type AllFlagsValue<N extends number, A extends any[] = []> = [N] extends [Partial<A>['length']] ? A['length'] : UnionFlags<N, [0, ...A, ...A]>;
+type UnionFlags<N extends number, A extends any[] = []> = IntRange<0, AllFlagsValue<N, A>>;
+export type Enum<T> = T[keyof T];
+export type FlagsEnum<T> = Enum<T> extends number ? UnionFlags<Enum<T>> : never;
+export declare const Key: Readonly<{
+    readonly NULL: "";
+    readonly CANCEL: "";
+    readonly HELP: "";
+    readonly BACKSPACE: "";
+    readonly TAB: "";
+    readonly CLEAR: "";
+    readonly RETURN: "";
+    readonly ENTER: "";
+    readonly SHIFT: "";
+    readonly CONTROL: "";
+    readonly ALT: "";
+    readonly PAUSE: "";
+    readonly ESCAPE: "";
+    readonly SPACE: "";
+    readonly PAGE_UP: "";
+    readonly PAGE_DOWN: "";
+    readonly END: "";
+    readonly HOME: "";
+    readonly LEFT: "";
+    readonly UP: "";
+    readonly RIGHT: "";
+    readonly DOWN: "";
+    readonly INSERT: "";
+    readonly DELETE: "";
+    readonly SEMICOLON: "";
+    readonly EQUALS: "";
+    readonly NUMPAD0: "";
+    readonly NUMPAD1: "";
+    readonly NUMPAD2: "";
+    readonly NUMPAD3: "";
+    readonly NUMPAD4: "";
+    readonly NUMPAD5: "";
+    readonly NUMPAD6: "";
+    readonly NUMPAD7: "";
+    readonly NUMPAD8: "";
+    readonly NUMPAD9: "";
+    readonly MULTIPLY: "";
+    readonly ADD: "";
+    readonly SEPARATOR: "";
+    readonly SUBTRACT: "";
+    readonly DECIMAL: "";
+    readonly DIVIDE: "";
+    readonly F1: "";
+    readonly F2: "";
+    readonly F3: "";
+    readonly F4: "";
+    readonly F5: "";
+    readonly F6: "";
+    readonly F7: "";
+    readonly F8: "";
+    readonly F9: "";
+    readonly F10: "";
+    readonly F11: "";
+    readonly F12: "";
+    readonly META: "";
+    readonly ZENKAKUHANKAKU: "";
+    readonly R_SHIFT: "";
+    readonly R_CONTROL: "";
+    readonly R_ALT: "";
+    readonly R_META: "";
+    readonly R_PAGEUP: "";
+    readonly R_PAGEDOWN: "";
+    readonly R_END: "";
+    readonly R_HOME: "";
+    readonly R_ARROWLEFT: "";
+    readonly R_ARROWUP: "";
+    readonly R_ARROWRIGHT: "";
+    readonly R_ARROWDOWN: "";
+    readonly R_INSERT: "";
+    readonly R_DELETE: "";
+}>;
+export type Key = Enum<typeof Key>;
+export declare const ClickType: Readonly<{
+    LEFT: "left";
+    MIDDLE: "middle";
+    RIGHT: "right";
+    BACK: "back";
+    FORWARD: "forward";
+}>;
+export type ClickType = Enum<typeof ClickType>;
+export {};
+//# sourceMappingURL=enums.d.ts.map

package/build/lib/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../lib/enums.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,GAC/E,GAAG,CAAC,MAAM,CAAC,GACX,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAE3C,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAE3F,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/I,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,IAAI,QAAQ,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAE3F,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AACjC,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAEhF,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuEL,CAAC;AAEZ,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;AAEnC,eAAO,MAAM,SAAS;;;;;;EAMpB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/build/lib/enums.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClickType = exports.Key = void 0;
+exports.Key = Object.freeze({
+    NULL: '\uE000',
+    CANCEL: '\uE001',
+    HELP: '\uE002',
+    BACKSPACE: '\uE003',
+    TAB: '\uE004',
+    CLEAR: '\uE005',
+    RETURN: '\uE006',
+    ENTER: '\uE007',
+    SHIFT: '\uE008',
+    CONTROL: '\uE009',
+    ALT: '\uE00A',
+    PAUSE: '\uE00B',
+    ESCAPE: '\uE00C',
+    SPACE: '\uE00D',
+    PAGE_UP: '\uE00E',
+    PAGE_DOWN: '\uE00F',
+    END: '\uE010',
+    HOME: '\uE011',
+    LEFT: '\uE012',
+    UP: '\uE013',
+    RIGHT: '\uE014',
+    DOWN: '\uE015',
+    INSERT: '\uE016',
+    DELETE: '\uE017',
+    SEMICOLON: '\uE018',
+    EQUALS: '\uE019',
+    NUMPAD0: '\uE01A',
+    NUMPAD1: '\uE01B',
+    NUMPAD2: '\uE01C',
+    NUMPAD3: '\uE01D',
+    NUMPAD4: '\uE01E',
+    NUMPAD5: '\uE01F',
+    NUMPAD6: '\uE020',
+    NUMPAD7: '\uE021',
+    NUMPAD8: '\uE022',
+    NUMPAD9: '\uE023',
+    MULTIPLY: '\uE024',
+    ADD: '\uE025',
+    SEPARATOR: '\uE026',
+    SUBTRACT: '\uE027',
+    DECIMAL: '\uE028',
+    DIVIDE: '\uE029',
+    F1: '\uE031',
+    F2: '\uE032',
+    F3: '\uE033',
+    F4: '\uE034',
+    F5: '\uE035',
+    F6: '\uE036',
+    F7: '\uE037',
+    F8: '\uE038',
+    F9: '\uE039',
+    F10: '\uE03A',
+    F11: '\uE03B',
+    F12: '\uE03C',
+    META: '\uE03D',
+    ZENKAKUHANKAKU: '\uE040',
+    R_SHIFT: '\uE050',
+    R_CONTROL: '\uE051',
+    R_ALT: '\uE052',
+    R_META: '\uE053',
+    R_PAGEUP: '\uE054',
+    R_PAGEDOWN: '\uE055',
+    R_END: '\uE056',
+    R_HOME: '\uE057',
+    R_ARROWLEFT: '\uE058',
+    R_ARROWUP: '\uE059',
+    R_ARROWRIGHT: '\uE05A',
+    R_ARROWDOWN: '\uE05B',
+    R_INSERT: '\uE05C',
+    R_DELETE: '\uE05D',
+});
+exports.ClickType = Object.freeze({
+    LEFT: 'left',
+    MIDDLE: 'middle',
+    RIGHT: 'right',
+    BACK: 'back',
+    FORWARD: 'forward'
+});
+//# sourceMappingURL=enums.js.map

package/build/lib/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../lib/enums.ts"],"names":[],"mappings":";;;AAYa,QAAA,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,QAAQ;IACnB,GAAG,EAAE,QAAQ;IACb,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,QAAQ;IACjB,GAAG,EAAE,QAAQ;IACb,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,QAAQ;IACjB,SAAS,EAAE,QAAQ;IACnB,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,QAAQ;IACnB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;IAClB,GAAG,EAAE,QAAQ;IACb,SAAS,EAAE,QAAQ;IACnB,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,QAAQ;IAChB,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,QAAQ;IACd,cAAc,EAAE,QAAQ;IACxB,OAAO,EAAE,QAAQ;IACjB,SAAS,EAAE,QAAQ;IACnB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,QAAQ;IACpB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,QAAQ;IACrB,SAAS,EAAE,QAAQ;IACnB,YAAY,EAAE,QAAQ;IACtB,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,QAAQ;CACZ,CAAC,CAAC;AAIC,QAAA,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;CACrB,CAAC,CAAC"}

package/build/lib/mcp/appium-manager.d.ts

@@ -0,0 +1,8 @@
+import type { McpConfig } from './config.js';
+export declare class AppiumManager {
+    private process;
+    private managed;
+    ensureRunning(config: McpConfig): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=appium-manager.d.ts.map

package/build/lib/mcp/appium-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appium-manager.d.ts","sourceRoot":"","sources":["../../../lib/mcp/appium-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAyD7C,qBAAa,aAAa;IACtB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAS;IAElB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAwD/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAsBlC"}

package/build/lib/mcp/appium-manager.js

@@ -0,0 +1,160 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppiumManager = void 0;
+const fs = __importStar(require("node:fs"));
+const http = __importStar(require("node:http"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const POLL_INTERVAL_MS = 500;
+const STARTUP_TIMEOUT_MS = 30_000;
+const SHUTDOWN_TIMEOUT_MS = 5_000;
+function isAppiumReady(host, port) {
+    return new Promise((resolve) => {
+        const req = http.get({ hostname: host, port, path: '/status', timeout: 2000 }, (res) => {
+            let body = '';
+            res.on('data', (chunk) => { body += chunk; });
+            res.on('end', () => {
+                try {
+                    const json = JSON.parse(body);
+                    resolve(json?.value?.ready === true);
+                }
+                catch {
+                    resolve(false);
+                }
+            });
+        });
+        req.on('error', () => resolve(false));
+        req.on('timeout', () => { req.destroy(); resolve(false); });
+    });
+}
+function waitForAppium(host, port) {
+    return new Promise((resolve, reject) => {
+        const deadline = Date.now() + STARTUP_TIMEOUT_MS;
+        const poll = async () => {
+            if (await isAppiumReady(host, port)) {
+                resolve();
+                return;
+            }
+            if (Date.now() >= deadline) {
+                reject(new Error(`Appium did not become ready within ${STARTUP_TIMEOUT_MS / 1000}s on ${host}:${port}`));
+                return;
+            }
+            setTimeout(poll, POLL_INTERVAL_MS);
+        };
+        poll();
+    });
+}
+function resolveAppiumBinary(configBinary) {
+    if (configBinary) {
+        return configBinary;
+    }
+    // Prefer a local node_modules/.bin/appium (3 levels up from build/lib/mcp/)
+    const localBin = path.resolve(__dirname, '..', '..', '..', 'node_modules', '.bin', 'appium');
+    if (fs.existsSync(localBin)) {
+        return localBin;
+    }
+    // Fall back to appium on the system PATH (global install: npm install -g appium)
+    return 'appium';
+}
+class AppiumManager {
+    process = null;
+    managed = false;
+    async ensureRunning(config) {
+        const { appiumHost: host, appiumPort: port } = config;
+        if (await isAppiumReady(host, port)) {
+            process.stderr.write(`[MCP] Appium already running on ${host}:${port}\n`);
+            return;
+        }
+        if (!config.appiumAutoStart) {
+            throw new Error(`Appium is not running on ${host}:${port}.\n` +
+                `Start it with: appium --port ${port}\n` +
+                `Or set APPIUM_AUTO_START=true to start it automatically.`);
+        }
+        const binary = resolveAppiumBinary(config.appiumBinary);
+        process.stderr.write(`[MCP] Starting Appium: ${binary} --port ${port} --address ${host}\n`);
+        const child = (0, node_child_process_1.spawn)(binary, ['--port', String(port), '--address', host], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: process.platform === 'win32',
+        });
+        // Wait for either a successful spawn or an early error.
+        // The 'spawn' event (Node ≥ 15.1) fires only after the OS has confirmed the
+        // process started; 'error' fires if it never starts (binary not found, etc.).
+        // Using setImmediate here would be a race — resolve could win before 'error' fires.
+        await new Promise((resolve, reject) => {
+            child.once('error', (err) => {
+                reject(new Error(`Failed to spawn Appium binary at "${binary}": ${err.message}\n` +
+                    `Install Appium globally with: npm install -g appium\n` +
+                    `Or set APPIUM_BINARY to the full path of the appium executable.`));
+            });
+            child.once('spawn', resolve);
+        });
+        this.process = child;
+        this.managed = true;
+        this.process.stdout?.on('data', (data) => {
+            process.stderr.write(`[Appium] ${data}`);
+        });
+        this.process.stderr?.on('data', (data) => {
+            process.stderr.write(`[Appium] ${data}`);
+        });
+        this.process.on('exit', (code) => {
+            process.stderr.write(`[MCP] Appium process exited with code ${code}\n`);
+        });
+        await waitForAppium(host, port);
+        process.stderr.write(`[MCP] Appium ready on ${host}:${port}\n`);
+    }
+    async shutdown() {
+        if (!this.managed || !this.process) {
+            return;
+        }
+        process.stderr.write('[MCP] Stopping Appium...\n');
+        this.process.kill('SIGTERM');
+        const child = this.process;
+        await new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                child.kill('SIGKILL');
+                resolve();
+            }, SHUTDOWN_TIMEOUT_MS);
+            child.on('exit', () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+        });
+        this.process = null;
+        this.managed = false;
+    }
+}
+exports.AppiumManager = AppiumManager;
+//# sourceMappingURL=appium-manager.js.map

package/build/lib/mcp/appium-manager.js.map

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

package/build/lib/mcp/config.d.ts

@@ -0,0 +1,7 @@
+/** Infrastructure config — read from env vars at startup. */
+export interface McpConfig {
+    appiumHost: string;
+    appiumPort: number;
+}
+export declare function loadConfig(): McpConfig;
+//# sourceMappingURL=config.d.ts.map

package/build/lib/mcp/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../lib/mcp/config.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,UAAU,IAAI,SAAS,CAUtC"}