appium-desktop-driver 1.2.0

package/build/lib/mcp/tools/find.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFindTools = registerFindTools;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+const constants_js_1 = require("../constants.js");
+const STRATEGIES = ['accessibility id', 'name', 'id', 'xpath', 'class name', 'tag name', '-windows uiautomation'];
+// 'id' is documented as an alias for 'accessibility id' (UIA AutomationId).
+// All other strategies are forwarded verbatim to the Appium/WinAppDriver protocol.
+function resolveStrategy(strategy) {
+    return strategy === 'id' ? 'accessibility id' : strategy;
+}
+const STRATEGY_DESCRIPTIONS = {
+    'accessibility id': 'Maps to UIA AutomationId — most stable selector, preferred for test automation. Use when the element has a non-empty AutomationId.',
+    'name': 'Maps to UIA Name property (visible label/title). Reliable when text is static and not locale-dependent.',
+    'id': 'Alias for accessibility id — maps to UIA AutomationId.',
+    'xpath': 'Evaluates XPath against the live UIA tree. Use as fallback when no stable AutomationId or Name exists. Example: //Button[@Name="OK"]',
+    'class name': 'Maps to UIA ClassName — rarely unique on its own; use to narrow results when combined with other strategies.',
+    'tag name': 'Maps to UIA ControlType (e.g. "Button", "Edit", "TextBlock"). Rarely unique; useful for finding all elements of a type.',
+    '-windows uiautomation': 'Raw UIA condition expression for advanced compound queries.',
+};
+const StrategyEnum = zod_1.z.enum(STRATEGIES);
+const FIND_STRATEGY_PRIORITY = [
+    'Preferred strategy order for reliable automation:',
+    '1) "accessibility id" (AutomationId) — most stable, use whenever available',
+    '2) "name" — good for static labels not subject to localization',
+    '3) "xpath" — flexible fallback, e.g. //Button[@Name="OK"]',
+    '4) other strategies — use only when the above are unavailable.',
+    'After interacting with an element you plan to use in generated test code, call get_element_info to capture the best locator.',
+].join(' ');
+function registerFindTools(server, session) {
+    server.registerTool('find_element', {
+        description: `Find a single UI element in the current app window. Returns an element ID string to pass to other tools. Returns an error if not found. ${FIND_STRATEGY_PRIORITY}`,
+        inputSchema: {
+            strategy: StrategyEnum.describe('Locator strategy. ' +
+                Object.entries(STRATEGY_DESCRIPTIONS).map(([k, v]) => `"${k}": ${v}`).join(' | ')),
+            selector: zod_1.z.string().min(1).describe('The selector value for the chosen strategy'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ strategy, selector }) => {
+        try {
+            const driver = session.getDriver();
+            const rawEl = await driver.findElement(resolveStrategy(strategy), selector);
+            return { content: [{ type: 'text', text: rawEl[constants_js_1.ELEMENT_KEY] }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('find_elements', {
+        description: `Find all UI elements matching the selector. Returns a JSON array of element ID strings. ${FIND_STRATEGY_PRIORITY}`,
+        inputSchema: {
+            strategy: StrategyEnum.describe('Locator strategy. ' +
+                Object.entries(STRATEGY_DESCRIPTIONS).map(([k, v]) => `"${k}": ${v}`).join(' | ')),
+            selector: zod_1.z.string().min(1).describe('The selector value for the chosen strategy'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ strategy, selector }) => {
+        try {
+            const driver = session.getDriver();
+            const rawEls = await driver.findElements(resolveStrategy(strategy), selector);
+            const ids = rawEls.map((el) => el[constants_js_1.ELEMENT_KEY]);
+            return { content: [{ type: 'text', text: JSON.stringify(ids) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('find_child_element', {
+        description: `Find a child element within a parent element. Returns an element ID string. ${FIND_STRATEGY_PRIORITY}`,
+        inputSchema: {
+            parentElementId: zod_1.z.string().min(1).describe('Element ID of the parent to search within'),
+            strategy: StrategyEnum.describe('Locator strategy. ' +
+                Object.entries(STRATEGY_DESCRIPTIONS).map(([k, v]) => `"${k}": ${v}`).join(' | ')),
+            selector: zod_1.z.string().min(1).describe('The selector value for the chosen strategy'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ parentElementId, strategy, selector }) => {
+        try {
+            const driver = session.getDriver();
+            const rawEl = await driver.findElementFromElement(parentElementId, resolveStrategy(strategy), selector);
+            return { content: [{ type: 'text', text: rawEl[constants_js_1.ELEMENT_KEY] }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('wait_for_element', {
+        description: `Wait for a UI element to appear within a configurable timeout, then return its element ID. Useful after dialog opens, page transitions, or loading spinners disappear. ${FIND_STRATEGY_PRIORITY}`,
+        inputSchema: {
+            strategy: StrategyEnum.describe('Locator strategy. ' +
+                Object.entries(STRATEGY_DESCRIPTIONS).map(([k, v]) => `"${k}": ${v}`).join(' | ')),
+            selector: zod_1.z.string().min(1).describe('The selector value for the chosen strategy'),
+            timeoutMs: zod_1.z.number().int().min(0).default(5000).describe('Maximum time in milliseconds to wait for the element'),
+            pollIntervalMs: zod_1.z.number().int().min(50).default(200).describe('How often to retry in milliseconds'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ strategy, selector, timeoutMs, pollIntervalMs }) => {
+        const driver = session.getDriver();
+        const effectiveStrategy = resolveStrategy(strategy);
+        const deadline = Date.now() + timeoutMs;
+        while (true) {
+            try {
+                const rawEl = await driver.findElement(effectiveStrategy, selector);
+                return { content: [{ type: 'text', text: rawEl[constants_js_1.ELEMENT_KEY] }] };
+            }
+            catch {
+                if (Date.now() >= deadline) {
+                    return {
+                        isError: true,
+                        content: [{ type: 'text', text: `Element not found within ${timeoutMs}ms: ${strategy}="${selector}"` }],
+                    };
+                }
+                await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+            }
+        }
+    });
+}
+//# sourceMappingURL=find.js.map

package/build/lib/mcp/tools/find.js.map

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

package/build/lib/mcp/tools/index.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppiumSession } from '../session.js';
+export declare function registerAllTools(server: McpServer, session: AppiumSession): void;
+//# sourceMappingURL=index.d.ts.map

package/build/lib/mcp/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/mcp/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAWnD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAUhF"}

package/build/lib/mcp/tools/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAllTools = registerAllTools;
+const session_js_1 = require("./session.js");
+const find_js_1 = require("./find.js");
+const interact_js_1 = require("./interact.js");
+const inspect_js_1 = require("./inspect.js");
+const window_js_1 = require("./window.js");
+const advanced_js_1 = require("./advanced.js");
+const patterns_js_1 = require("./patterns.js");
+const app_js_1 = require("./app.js");
+const clipboard_js_1 = require("./clipboard.js");
+function registerAllTools(server, session) {
+    (0, session_js_1.registerSessionTools)(server, session);
+    (0, find_js_1.registerFindTools)(server, session);
+    (0, interact_js_1.registerInteractTools)(server, session);
+    (0, inspect_js_1.registerInspectTools)(server, session);
+    (0, window_js_1.registerWindowTools)(server, session);
+    (0, advanced_js_1.registerAdvancedTools)(server, session);
+    (0, patterns_js_1.registerPatternTools)(server, session);
+    (0, app_js_1.registerAppTools)(server, session);
+    (0, clipboard_js_1.registerClipboardTools)(server, session);
+}
+//# sourceMappingURL=index.js.map

package/build/lib/mcp/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/mcp/tools/index.ts"],"names":[],"mappings":";;AAYA,4CAUC;AApBD,6CAAoD;AACpD,uCAA8C;AAC9C,+CAAsD;AACtD,6CAAoD;AACpD,2CAAkD;AAClD,+CAAsD;AACtD,+CAAqD;AACrD,qCAA4C;AAC5C,iDAAwD;AAExD,SAAgB,gBAAgB,CAAC,MAAiB,EAAE,OAAsB;IACtE,IAAA,iCAAoB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAA,2BAAiB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,IAAA,mCAAqB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,IAAA,iCAAoB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAA,+BAAmB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAA,mCAAqB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,IAAA,kCAAoB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAA,yBAAgB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAA,qCAAsB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/build/lib/mcp/tools/inspect.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppiumSession } from '../session.js';
+export declare function registerInspectTools(server: McpServer, session: AppiumSession): void;
+//# sourceMappingURL=inspect.d.ts.map

package/build/lib/mcp/tools/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../../../lib/mcp/tools/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAsFnD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAkDpF"}

package/build/lib/mcp/tools/inspect.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInspectTools = registerInspectTools;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+const constants_js_1 = require("../constants.js");
+/**
+ * Build a ranked list of suggested selectors for test automation.
+ * Priority: accessibility id (AutomationId) > name > xpath combos.
+ */
+function buildSuggestedSelectors(props) {
+    const suggestions = [];
+    // Derive the XPath tag name from ControlType (strip "ControlType." prefix if present)
+    const tag = props.controlType?.replace(/^ControlType\./, '') ?? null;
+    // 1. AutomationId via accessibility id — most reliable
+    if (props.automationId?.trim()) {
+        suggestions.push({
+            strategy: 'accessibility id',
+            selector: props.automationId,
+            reliability: 'high',
+            note: 'AutomationId — stable across locales and UI layout changes. Preferred for .NET: driver.FindElement(MobileBy.AccessibilityId("' + props.automationId + '"))',
+        });
+    }
+    // 2. XPath with AutomationId — explicit type + stable id
+    if (tag && props.automationId?.trim()) {
+        suggestions.push({
+            strategy: 'xpath',
+            selector: `//${tag}[@AutomationId="${props.automationId}"]`,
+            reliability: 'high',
+            note: 'XPath using AutomationId — use when you also want to assert the control type',
+        });
+    }
+    // 3. Name via name strategy — medium reliability (may change with locale)
+    if (props.name?.trim()) {
+        suggestions.push({
+            strategy: 'name',
+            selector: props.name,
+            reliability: 'medium',
+            note: 'Element Name — may change with localization or dynamic text. .NET: driver.FindElement(MobileBy.Name("' + props.name + '"))',
+        });
+    }
+    // 4. XPath with Name + ControlType
+    if (tag && props.name?.trim()) {
+        suggestions.push({
+            strategy: 'xpath',
+            selector: `//${tag}[@Name="${props.name}"]`,
+            reliability: 'medium',
+            note: 'XPath using Name — readable but locale-sensitive',
+        });
+    }
+    // 5. ClassName as fallback (rarely unique on its own)
+    if (props.className?.trim()) {
+        suggestions.push({
+            strategy: 'class name',
+            selector: props.className,
+            reliability: 'low',
+            note: 'ClassName — often shared by many elements; combine with other strategies in XPath',
+        });
+    }
+    return suggestions;
+}
+function registerInspectTools(server, session) {
+    server.registerTool('get_element_info', {
+        description: [
+            'Retrieve all key UIA properties of an element and get ranked selector suggestions for test automation.',
+            'Returns: Name, AutomationId, ClassName, ControlType, IsEnabled, and a prioritized list of selectors.',
+            'ALWAYS call this after find_element when generating automated test code — it gives you the best locator to use.',
+            'Selector reliability order: accessibility id (AutomationId) = highest → name → xpath → class name = lowest.',
+            'For .NET/C# Appium: use MobileBy.AccessibilityId(automationId) when AutomationId is non-empty.',
+        ].join(' '),
+        inputSchema: {
+            elementId: zod_1.z.string().min(1).describe('Element ID returned by find_element'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            const el = await driver.$({ [constants_js_1.ELEMENT_KEY]: elementId });
+            // Fetch all relevant UIA properties in parallel
+            const [name, automationId, className, controlType, isEnabled] = await Promise.all([
+                el.getAttribute('Name').catch(() => null),
+                el.getAttribute('AutomationId').catch(() => null),
+                el.getAttribute('ClassName').catch(() => null),
+                el.getAttribute('ControlType').catch(() => null),
+                el.getAttribute('IsEnabled').catch(() => null),
+            ]);
+            const props = {
+                name: name || null,
+                automationId: automationId || null,
+                className: className || null,
+                controlType: controlType || null,
+                isEnabled: isEnabled || null,
+            };
+            const result = {
+                elementId,
+                ...props,
+                suggestedSelectors: buildSuggestedSelectors(props),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+}
+//# sourceMappingURL=inspect.js.map

package/build/lib/mcp/tools/inspect.js.map

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

package/build/lib/mcp/tools/interact.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppiumSession } from '../session.js';
+export declare function registerInteractTools(server: McpServer, session: AppiumSession): void;
+//# sourceMappingURL=interact.d.ts.map

package/build/lib/mcp/tools/interact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interact.d.ts","sourceRoot":"","sources":["../../../../lib/mcp/tools/interact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAMnD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CA2IrF"}

package/build/lib/mcp/tools/interact.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInteractTools = registerInteractTools;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+const constants_js_1 = require("../constants.js");
+const elementIdSchema = zod_1.z.string().min(1).describe('Element ID returned by find_element');
+function registerInteractTools(server, session) {
+    server.registerTool('click_element', {
+        description: 'Click a UI element by its element ID.',
+        inputSchema: { elementId: elementIdSchema },
+        annotations: { destructiveHint: false },
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            const el = await driver.$({ [constants_js_1.ELEMENT_KEY]: elementId });
+            await el.click();
+            return { content: [{ type: 'text', text: 'clicked' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('set_value', {
+        description: 'Set the text value of an input element (clears first then types).',
+        inputSchema: {
+            elementId: elementIdSchema,
+            value: zod_1.z.string().describe('The text value to set'),
+        },
+        annotations: { destructiveHint: false },
+    }, async ({ elementId, value }) => {
+        try {
+            const driver = session.getDriver();
+            const el = await driver.$({ [constants_js_1.ELEMENT_KEY]: elementId });
+            await el.setValue(value);
+            return { content: [{ type: 'text', text: 'value set' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('clear_element', {
+        description: 'Clear the text content of an input element.',
+        inputSchema: { elementId: elementIdSchema },
+        annotations: { destructiveHint: false },
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            const el = await driver.$({ [constants_js_1.ELEMENT_KEY]: elementId });
+            await el.clearValue();
+            return { content: [{ type: 'text', text: 'cleared' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('get_text', {
+        description: 'Get the visible text content of a UI element.',
+        inputSchema: { elementId: elementIdSchema },
+        annotations: { readOnlyHint: true },
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            const el = await driver.$({ [constants_js_1.ELEMENT_KEY]: elementId });
+            const text = await el.getText();
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('get_attribute', {
+        description: 'Get an attribute or property of a UI element. Common attributes: Name, AutomationId, ClassName, IsEnabled, IsOffscreen, ControlType, Value.Value. Returns an empty string when the attribute is absent.',
+        inputSchema: {
+            elementId: elementIdSchema,
+            attribute: zod_1.z.string().min(1).describe('Attribute name, e.g. "Name", "IsEnabled", "ControlType"'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ elementId, attribute }) => {
+        try {
+            const driver = session.getDriver();
+            const el = await driver.$({ [constants_js_1.ELEMENT_KEY]: elementId });
+            const value = await el.getAttribute(attribute);
+            return { content: [{ type: 'text', text: value ?? '' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('is_element_displayed', {
+        description: 'Check whether a UI element is visible on screen (not off-screen).',
+        inputSchema: { elementId: elementIdSchema },
+        annotations: { readOnlyHint: true },
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            const el = await driver.$({ [constants_js_1.ELEMENT_KEY]: elementId });
+            const displayed = await el.isDisplayed();
+            return { content: [{ type: 'text', text: String(displayed) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('is_element_enabled', {
+        description: 'Check whether a UI element is enabled and interactable.',
+        inputSchema: { elementId: elementIdSchema },
+        annotations: { readOnlyHint: true },
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            const el = await driver.$({ [constants_js_1.ELEMENT_KEY]: elementId });
+            const enabled = await el.isEnabled();
+            return { content: [{ type: 'text', text: String(enabled) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+}
+//# sourceMappingURL=interact.js.map

package/build/lib/mcp/tools/interact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interact.js","sourceRoot":"","sources":["../../../../lib/mcp/tools/interact.ts"],"names":[],"mappings":";;AAQA,sDA2IC;AAlJD,6BAAwB;AAExB,4CAA2C;AAC3C,kDAA8C;AAE9C,MAAM,eAAe,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC,CAAC;AAE1F,SAAgB,qBAAqB,CAAC,MAAiB,EAAE,OAAsB;IAC3E,MAAM,CAAC,YAAY,CACf,eAAe,EACf;QACI,WAAW,EAAE,uCAAuC;QACpD,WAAW,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE;QAC3C,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KAC1C,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,0BAAW,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YACxD,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACf,WAAW,EACX;QACI,WAAW,EAAE,mEAAmE;QAChF,WAAW,EAAE;YACT,SAAS,EAAE,eAAe;YAC1B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;SACtD;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KAC1C,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,0BAAW,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YACxD,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACf,eAAe,EACf;QACI,WAAW,EAAE,6CAA6C;QAC1D,WAAW,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE;QAC3C,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KAC1C,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,0BAAW,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YACxD,MAAM,EAAE,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACf,UAAU,EACV;QACI,WAAW,EAAE,+CAA+C;QAC5D,WAAW,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE;QAC3C,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACtC,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,0BAAW,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACf,eAAe,EACf;QACI,WAAW,EAAE,yMAAyM;QACtN,WAAW,EAAE;YACT,SAAS,EAAE,eAAe;YAC1B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yDAAyD,CAAC;SACnG;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACtC,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE;QAC/B,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,0BAAW,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAC/C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACf,sBAAsB,EACtB;QACI,WAAW,EAAE,mEAAmE;QAChF,WAAW,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE;QAC3C,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACtC,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,0BAAW,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YACxD,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC;YACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACf,oBAAoB,EACpB;QACI,WAAW,EAAE,yDAAyD;QACtE,WAAW,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE;QAC3C,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACtC,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,0BAAW,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YACxD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/build/lib/mcp/tools/patterns.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppiumSession } from '../session.js';
+export declare function registerPatternTools(server: McpServer, session: AppiumSession): void;
+//# sourceMappingURL=patterns.d.ts.map

package/build/lib/mcp/tools/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../../../lib/mcp/tools/patterns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAMnD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAkKpF"}

package/build/lib/mcp/tools/patterns.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPatternTools = registerPatternTools;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+const elementIdSchema = zod_1.z.string().min(1).describe('Element ID returned by find_element');
+const elementIdInput = { elementId: elementIdSchema };
+function registerPatternTools(server, session) {
+    server.registerTool('invoke_element', {
+        description: 'Invoke the default action of an element via the UIA Invoke pattern (e.g. click a button programmatically without mouse input).',
+        inputSchema: elementIdInput,
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: invoke', [{ elementId }]);
+            return { content: [{ type: 'text', text: 'invoked' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('expand_element', {
+        description: 'Expand a collapsible element (tree node, combo box, menu) via the UIA ExpandCollapse pattern.',
+        inputSchema: elementIdInput,
+        annotations: { idempotentHint: true },
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: expand', [{ elementId }]);
+            return { content: [{ type: 'text', text: 'expanded' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('collapse_element', {
+        description: 'Collapse an expanded element via the UIA ExpandCollapse pattern.',
+        inputSchema: elementIdInput,
+        annotations: { idempotentHint: true },
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: collapse', [{ elementId }]);
+            return { content: [{ type: 'text', text: 'collapsed' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('toggle_element', {
+        description: 'Toggle a checkbox or toggle button via the UIA Toggle pattern. To confirm the resulting state, call get_toggle_state after this.',
+        inputSchema: elementIdInput,
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: toggle', [{ elementId }]);
+            return { content: [{ type: 'text', text: 'toggled' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('get_toggle_state', {
+        description: 'Get the toggle state of a checkbox or toggle button via the UIA Toggle pattern. Returns "On", "Off", or "Indeterminate".',
+        inputSchema: elementIdInput,
+        annotations: { readOnlyHint: true },
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            const result = await driver.executeScript('windows: getToggleState', [{ elementId }]);
+            return { content: [{ type: 'text', text: String(result) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('set_element_value', {
+        description: 'Set the value of an element via the UIA Value or RangeValue pattern (e.g. sliders, spin boxes).',
+        inputSchema: {
+            elementId: elementIdSchema,
+            value: zod_1.z.string().describe('The value to set'),
+        },
+        annotations: { destructiveHint: false },
+    }, async ({ elementId, value }) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: setValue', [{ elementId, value }]);
+            return { content: [{ type: 'text', text: 'value set' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('get_element_value', {
+        description: 'Get the value of an element via the UIA Value pattern.',
+        inputSchema: elementIdInput,
+        annotations: { readOnlyHint: true },
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            const result = await driver.executeScript('windows: getValue', [{ elementId }]);
+            return { content: [{ type: 'text', text: String(result) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('focus_element', {
+        description: 'Set focus to an element via the UIA Focus pattern (windows: setFocus). Required before keyboard-driven interactions such as send_keys on a specific control.',
+        inputSchema: elementIdInput,
+        annotations: { idempotentHint: true },
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: setFocus', [{ elementId }]);
+            return { content: [{ type: 'text', text: 'focused' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('select_item', {
+        description: 'Select an item in a list box, tab control, or combo box via the UIA SelectionItem pattern (windows: select). Use when click does not trigger selection.',
+        inputSchema: elementIdInput,
+    }, async ({ elementId }) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: select', [{ elementId }]);
+            return { content: [{ type: 'text', text: 'selected' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+}
+//# sourceMappingURL=patterns.js.map

package/build/lib/mcp/tools/patterns.js.map

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

package/build/lib/mcp/tools/session.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppiumSession } from '../session.js';
+export declare function registerSessionTools(server: McpServer, session: AppiumSession): void;
+//# sourceMappingURL=session.d.ts.map

package/build/lib/mcp/tools/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../lib/mcp/tools/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CA+DpF"}