appium-mcp 0.0.1 → 1.1.4

package/dist/locators/locator-generation.js

@@ -0,0 +1,501 @@
+import _ from 'lodash';
+import * as XPath from 'xpath';
+const xpathSelect = XPath.select;
+import log from './logger.js';
+import { childNodesOf, domToXML, findDOMNodeByPath, xmlToDOM, } from './source-parsing.js';
+// Attributes on nodes that are likely to be unique to the node so we should consider first when
+// suggesting xpath locators. These are considered IN ORDER.
+const UNIQUE_XPATH_ATTRIBUTES = [
+    'name',
+    'content-desc',
+    'id',
+    'resource-id',
+    'accessibility-id',
+];
+// Attributes that we should recommend as a fallback but ideally only in conjunction with other
+// attributes
+const MAYBE_UNIQUE_XPATH_ATTRIBUTES = ['label', 'text', 'value'];
+const CHECKED_CLASS_CHAIN_ATTRIBUTES = ['name', 'label', 'value'];
+const CHECKED_PREDICATE_ATTRIBUTES = ['name', 'label', 'value', 'type'];
+// Map of element attributes to their UiAutomator syntax, ordered by (likely) decreasing uniqueness
+const CHECKED_UIAUTOMATOR_ATTRIBUTES = [
+    ['resource-id', 'resourceId'],
+    ['text', 'text'],
+    ['content-desc', 'description'],
+    ['class', 'className'],
+];
+// Map of element attributes to their matching simple (optimal) locator strategies
+const SIMPLE_STRATEGY_MAPPINGS = [
+    ['name', 'accessibility id'],
+    ['content-desc', 'accessibility id'],
+    ['id', 'id'],
+    ['rntestid', 'id'],
+    ['resource-id', 'id'],
+    ['class', 'class name'],
+    ['type', 'class name'],
+];
+/**
+ * Check whether the provided attribute & value are unique in the source
+ */
+export function areAttrAndValueUnique(attrName, attrValue, sourceDoc) {
+    // If no sourceDoc provided, assume it's unique
+    if (!sourceDoc || _.isEmpty(sourceDoc)) {
+        return true;
+    }
+    const result = xpathSelect(`//*[@${attrName}="${attrValue.replace(/"/g, '')}"]`, sourceDoc);
+    return Array.isArray(result) ? result.length < 2 : false;
+}
+/**
+ * Get suggested selectors for simple locator strategies (which match a specific attribute)
+ */
+export function getSimpleSuggestedLocators(attributes, sourceDoc, isNative = true) {
+    const res = {};
+    for (let [strategyAlias, strategy] of SIMPLE_STRATEGY_MAPPINGS) {
+        // accessibility id is only supported in native context
+        if (!(strategy === 'accessibility id' && !isNative)) {
+            const value = attributes[strategyAlias];
+            if (value && areAttrAndValueUnique(strategyAlias, value, sourceDoc)) {
+                res[strategy] = value;
+            }
+        }
+    }
+    return res;
+}
+/**
+ * Get suggested selectors for complex locator strategies (multiple attributes, axes, etc.)
+ */
+export function getComplexSuggestedLocators(path, sourceDoc, isNative, automationName) {
+    let complexLocators = {};
+    const domNode = findDOMNodeByPath(path, sourceDoc);
+    if (isNative) {
+        switch (automationName) {
+            case 'xcuitest':
+            case 'mac2': {
+                const optimalClassChain = getOptimalClassChain(sourceDoc, domNode);
+                complexLocators['-ios class chain'] = optimalClassChain
+                    ? '**' + optimalClassChain
+                    : null;
+                complexLocators['-ios predicate string'] = getOptimalPredicateString(sourceDoc, domNode);
+                break;
+            }
+            case 'uiautomator2': {
+                complexLocators['-android uiautomator'] = getOptimalUiAutomatorSelector(sourceDoc, domNode, path);
+                break;
+            }
+        }
+    }
+    complexLocators.xpath = getOptimalXPath(sourceDoc, domNode);
+    // Remove entries for locators where the optimal selector could not be found
+    return _.omitBy(complexLocators, _.isNil);
+}
+/**
+ * Get suggested selectors for all locator strategies
+ */
+export function getSuggestedLocators(selectedElement, sourceXML, isNative, automationName) {
+    const sourceDoc = xmlToDOM(sourceXML);
+    const simpleLocators = getSimpleSuggestedLocators(selectedElement.attributes, sourceDoc, isNative);
+    const complexLocators = getComplexSuggestedLocators(selectedElement.path, sourceDoc, isNative, automationName);
+    // Combine all locators
+    const allLocators = { ...simpleLocators, ...complexLocators };
+    // Define priority order based on platform preference
+    let priorityOrder;
+    if (isNative &&
+        (automationName === 'xcuitest' || automationName === 'mac2')) {
+        // iOS priority: Accessibility Id > Predicate > Class Chain > XPath > Class Name
+        priorityOrder = [
+            'id',
+            'accessibility id',
+            '-ios predicate string',
+            '-ios class chain',
+            'xpath',
+            'class name',
+        ];
+    }
+    else if (isNative && automationName === 'uiautomator2') {
+        // Android priority: Accessibility Id > UiAutomator > XPath > Class Name
+        priorityOrder = [
+            'id',
+            'accessibility id',
+            'xpath',
+            '-android uiautomator',
+            'class name',
+        ];
+    }
+    else {
+        priorityOrder = ['id', 'class name', 'xpath'];
+    }
+    // Sort locators by priority order, keeping only available ones
+    const sortedLocators = [];
+    // Add locators in priority order
+    for (const strategy of priorityOrder) {
+        if (allLocators[strategy]) {
+            sortedLocators.push([strategy, allLocators[strategy]]);
+        }
+    }
+    // Add any remaining locators that weren't in the priority list (like 'id' for native contexts)
+    for (const [strategy, value] of _.toPairs(allLocators)) {
+        if (!priorityOrder.includes(strategy)) {
+            sortedLocators.push([strategy, value]);
+        }
+    }
+    // Return all valid locators, or empty array if none found
+    // Filter out any undefined entries
+    return sortedLocators.filter((locator) => Array.isArray(locator) &&
+        locator.length === 2 &&
+        typeof locator[0] === 'string' &&
+        typeof locator[1] === 'string' &&
+        locator[0] !== undefined &&
+        locator[1] !== undefined);
+}
+/**
+ * Return information about whether an xpath query results in a unique element, and the non-unique
+ * index of the element in the document if not unique
+ */
+function determineXpathUniqueness(xpath, doc, domNode) {
+    let othersWithAttr = [];
+    // If the XPath does not parse, move to the next unique attribute
+    try {
+        const result = XPath.select(xpath, doc);
+        othersWithAttr = Array.isArray(result)
+            ? result
+            : [];
+    }
+    catch {
+        return [false];
+    }
+    if (othersWithAttr.length > 1) {
+        return [false, othersWithAttr.indexOf(domNode)];
+    }
+    return [true];
+}
+/**
+ * Given an xml doc and a current dom node, try to find a robust xpath selector qualified by
+ * key attributes, which is unique in the document (or unique plus index).
+ */
+function getUniqueXPath(doc, domNode, attrs) {
+    let uniqueXpath, semiUniqueXpath;
+    const tagForXpath = domNode.nodeName || '*';
+    const isPairs = attrs.length > 0 && _.isArray(attrs[0]);
+    const isNodeName = attrs.length === 0;
+    // If we're looking for a unique //<nodetype>, return it only if it's actually unique. No
+    // semi-uniqueness here!
+    if (isNodeName) {
+        let xpath = `//${domNode.nodeName}`;
+        const [isUnique] = determineXpathUniqueness(xpath, doc, domNode);
+        if (isUnique) {
+            // even if this node name is unique, if it's the root node, we don't want to refer to it using
+            // '//' but rather '/'
+            if (!domNode.parentNode?.nodeName) {
+                xpath = `/${domNode.nodeName}`;
+            }
+            return [xpath, true];
+        }
+        return [undefined, undefined];
+    }
+    // Otherwise go through our various attributes to look for uniqueness
+    for (const attrName of attrs) {
+        let xpath;
+        if (isPairs) {
+            const [attr1Name, attr2Name] = attrName;
+            const attr1Value = domNode.getAttribute?.(attr1Name);
+            const attr2Value = domNode.getAttribute?.(attr2Name);
+            if (!attr1Value || !attr2Value) {
+                continue;
+            }
+            xpath = `//${tagForXpath}[@${attr1Name}="${attr1Value}" and @${attr2Name}="${attr2Value}"]`;
+        }
+        else {
+            const attrValue = domNode.getAttribute?.(attrName);
+            if (!attrValue) {
+                continue;
+            }
+            xpath = `//${tagForXpath}[@${attrName}="${attrValue}"]`;
+        }
+        const [isUnique, indexIfNotUnique] = determineXpathUniqueness(xpath, doc, domNode);
+        if (isUnique) {
+            uniqueXpath = xpath;
+            break;
+        }
+        // if the xpath wasn't totally unique it might still be our best bet. Store a less unique
+        // version qualified by an index for later in semiUniqueXpath. If we can't find a better
+        // unique option down the road, we'll fall back to this
+        if (!semiUniqueXpath && !_.isUndefined(indexIfNotUnique)) {
+            semiUniqueXpath = `(${xpath})[${indexIfNotUnique + 1}]`;
+        }
+    }
+    if (uniqueXpath) {
+        return [uniqueXpath, true];
+    }
+    if (semiUniqueXpath) {
+        return [semiUniqueXpath, false];
+    }
+    return [undefined, undefined];
+}
+/**
+ * Get an optimal XPath for a Node
+ */
+export function getOptimalXPath(doc, domNode) {
+    try {
+        // BASE CASE #1: If this isn't an element, we're above the root, return empty string
+        if (!domNode.nodeName || domNode.nodeType !== 1) {
+            return '';
+        }
+        const attrsForPairs = [
+            ...UNIQUE_XPATH_ATTRIBUTES,
+            ...MAYBE_UNIQUE_XPATH_ATTRIBUTES,
+        ];
+        const attrPairsPermutations = attrsForPairs.flatMap((v1, i) => attrsForPairs.slice(i + 1).map(v2 => [v1, v2]));
+        const cases = [
+            // BASE CASE #2: If this node has a unique attribute or content attribute, return an absolute
+            // XPath with that attribute
+            UNIQUE_XPATH_ATTRIBUTES,
+            // BASE CASE #3: If this node has a unique pair of attributes including 'maybe' attributes,
+            // return an xpath based on that pair
+            attrPairsPermutations,
+            // BASE CASE #4: Look for a 'maybe' unique attribute on its own. It's better if we find one
+            // of these that's unique in conjunction with another attribute, but if not, that's OK.
+            // Better than a hierarchical query.
+            MAYBE_UNIQUE_XPATH_ATTRIBUTES,
+            // BASE CASE #5: Look to see if the node type is unique in the document
+            [],
+        ];
+        // It's possible that in all of these cases we don't find a truly unique selector. But
+        // a selector qualified by attribute with an index attached like //*[@id="foo"][1] is still
+        // better than a fully path-based selector. We call this a 'semi unique xpath'
+        let semiUniqueXpath;
+        // Go through each of our cases and look for selectors for each case in order
+        for (const attrs of cases) {
+            const [xpath, isFullyUnique] = getUniqueXPath(doc, domNode, attrs);
+            if (isFullyUnique) {
+                // if we ever encounter an actually unique selector, return it straightaway
+                return xpath;
+            }
+            else if (!semiUniqueXpath && xpath) {
+                // if we have a semin unique selector, and haven't already captured a semi unique selector,
+                // hold onto it for later. If we end up without any unique selectors from any of the cases,
+                // then we'll return this. But we want to make sure to return our FIRST instance of a semi
+                // unique selector, since it might theoretically be the best.
+                semiUniqueXpath = xpath;
+            }
+        }
+        // Once we've gone through all our cases, if we do have a semi unique xpath, send that back
+        if (semiUniqueXpath) {
+            return semiUniqueXpath;
+        }
+        // Otherwise fall back to a purely hierarchical expression of this dom node's position in the
+        // document as a last resort.
+        // First get the relative xpath of this node using tagName
+        let xpath = `/${domNode.nodeName}`;
+        // If this node has siblings of the same tagName, get the index of this node
+        if (domNode.parentNode) {
+            // Get the siblings
+            const childNodes = Array.prototype.slice
+                .call(domNode.parentNode.childNodes, 0)
+                .filter((childNode) => childNode.nodeType === 1 && childNode.nodeName === domNode.nodeName);
+            // If there's more than one sibling, append the index
+            if (childNodes.length > 1) {
+                let index = childNodes.indexOf(domNode);
+                xpath += `[${index + 1}]`;
+            }
+        }
+        // Make a recursive call to this nodes parents and prepend it to this xpath
+        return getOptimalXPath(doc, domNode.parentNode) + xpath;
+    }
+    catch (error) {
+        // If there's an unexpected exception, abort
+        logLocatorError('XPath', error);
+        return null;
+    }
+}
+/**
+ * Get an optimal class chain for a Node based on the getOptimalXPath method
+ */
+export function getOptimalClassChain(doc, domNode) {
+    try {
+        // BASE CASE #1: If this isn't an element, we're above the root, return empty string
+        // Also return empty for 'XCUIElementTypeApplication', which cannot be found via class chain
+        if (!domNode.nodeName ||
+            domNode.nodeType !== 1 ||
+            domNode.nodeName === 'XCUIElementTypeApplication') {
+            return '';
+        }
+        // BASE CASE #2: If this node has a unique class chain based on attributes, return it
+        let classChain, othersWithAttr;
+        for (let attrName of CHECKED_CLASS_CHAIN_ATTRIBUTES) {
+            const attrValue = domNode.getAttribute?.(attrName);
+            if (_.isEmpty(attrValue)) {
+                continue;
+            }
+            const xpath = `//${domNode.nodeName || '*'}[@${attrName}="${attrValue}"]`;
+            classChain = `/${domNode.nodeName || '*'}[\`${attrName} == "${attrValue}"\`]`;
+            // If the XPath does not parse, move to the next unique attribute
+            try {
+                const result = xpathSelect(xpath, doc);
+                othersWithAttr = Array.isArray(result)
+                    ? result
+                    : [];
+            }
+            catch {
+                continue;
+            }
+            // If the attribute isn't actually unique, get its index too
+            if (othersWithAttr.length > 1) {
+                let index = othersWithAttr.indexOf(domNode);
+                classChain = `${classChain}[${index + 1}]`;
+            }
+            return classChain;
+        }
+        // BASE CASE #3: If this node has no unique attributes, repeat checks for its parent
+        // Get the relative xpath of this node using tagName
+        classChain = `/${domNode.nodeName}`;
+        // If this node has siblings of the same tagName, get the index of this node
+        if (domNode.parentNode) {
+            // Get the siblings
+            const childNodes = Array.prototype.slice
+                .call(domNode.parentNode.childNodes, 0)
+                .filter((childNode) => childNode.nodeType === 1 && childNode.nodeName === domNode.nodeName);
+            // If there's more than one sibling, append the index
+            if (childNodes.length > 1) {
+                let index = childNodes.indexOf(domNode);
+                classChain += `[${index + 1}]`;
+            }
+        }
+        // Make a recursive call to this nodes parents and prepend it to this xpath
+        return getOptimalClassChain(doc, domNode.parentNode) + classChain;
+    }
+    catch (error) {
+        // If there's an unexpected exception, abort
+        logLocatorError('class chain', error);
+        return null;
+    }
+}
+/**
+ * Get an optimal predicate string for a Node based on the getOptimalXPath method
+ * Only works for a single element - no parent/child scope
+ */
+export function getOptimalPredicateString(doc, domNode) {
+    try {
+        // BASE CASE #1: If this isn't an element, or we're above the root, return empty string
+        if (!domNode.nodeName || domNode.nodeType !== 1) {
+            return '';
+        }
+        // BASE CASE #2: Check all attributes and try to find the best way
+        let xpathAttributes = [];
+        let predicateString = [];
+        let othersWithAttr;
+        for (let attrName of CHECKED_PREDICATE_ATTRIBUTES) {
+            const attrValue = domNode.getAttribute?.(attrName);
+            if (_.isEmpty(attrValue)) {
+                continue;
+            }
+            xpathAttributes.push(`@${attrName}="${attrValue}"`);
+            const xpath = `//*[${xpathAttributes.join(' and ')}]`;
+            predicateString.push(`${attrName} == "${attrValue}"`);
+            // If the XPath does not parse, move to the next attribute
+            try {
+                const result = xpathSelect(xpath, doc);
+                othersWithAttr = Array.isArray(result)
+                    ? result
+                    : [];
+            }
+            catch {
+                continue;
+            }
+            // Return as soon as the accumulated attribute combination is unique
+            if (othersWithAttr.length === 1) {
+                return predicateString.join(' AND ');
+            }
+        }
+    }
+    catch (error) {
+        // If there's an unexpected exception, abort
+        logLocatorError('predicate string', error);
+        return null;
+    }
+    return null;
+}
+/**
+ * Get an optimal UiAutomator selector for a Node
+ * Only works for elements inside the last direct child of the hierarchy (xpath: /hierarchy/*[last()] )
+ */
+export function getOptimalUiAutomatorSelector(doc, domNode, path) {
+    try {
+        // BASE CASE #1: If this isn't an element, or we're above the root, return empty string
+        if (!domNode.nodeName || domNode.nodeType !== 1) {
+            return '';
+        }
+        // UiAutomator can only find elements inside the last direct child of the hierarchy.
+        // hierarchy is the child of doc (which is <xml/>), so need to get the children of its child
+        // BASE CASE #2: If there is no hierarchy or its children, return null
+        const docChildren = childNodesOf(doc);
+        const hierarchyChildren = _.isEmpty(docChildren)
+            ? []
+            : childNodesOf(docChildren[0]);
+        if (_.isEmpty(hierarchyChildren)) {
+            return null;
+        }
+        // BASE CASE #3: If looking for an element that is not inside
+        // the last direct child of the hierarchy, return null
+        const lastHierarchyChildIndex = (hierarchyChildren.length - 1).toString();
+        let pathArray = path.split('.');
+        const requestedHierarchyChildIndex = pathArray[0];
+        if (requestedHierarchyChildIndex !== lastHierarchyChildIndex) {
+            return null;
+        }
+        // In order to use only the last direct child of the hierarchy as the new scope,
+        // need to recreate it as a Document (Node -> XML -> Document),
+        // then modify the path by changing the first index,
+        // and finally recreate the domNode, since it still references the original parent
+        const lastHierarchyChild = hierarchyChildren[parseInt(lastHierarchyChildIndex, 10)];
+        const newXml = domToXML(lastHierarchyChild);
+        // wrap the new XML in a dummy tag which will have the node type Document
+        const newDoc = xmlToDOM(`<dummy>${newXml}</dummy>`);
+        pathArray[0] = '0';
+        const newPath = pathArray.join('.');
+        const newDomNode = findDOMNodeByPath(newPath, newDoc);
+        // BASE CASE #4: Check all attributes and try to find unique ones
+        let uiSelector, othersWithAttr, othersWithAttrMinCount, mostUniqueSelector;
+        for (const [attrName, attrTranslation] of CHECKED_UIAUTOMATOR_ATTRIBUTES) {
+            const attrValue = newDomNode.getAttribute?.(attrName);
+            if (_.isEmpty(attrValue)) {
+                continue;
+            }
+            const xpath = `//${newDomNode.nodeName}[@${attrName}="${attrValue}"]`;
+            uiSelector = `new UiSelector().${attrTranslation}("${attrValue}")`;
+            // If the XPath does not parse, move to the next unique attribute
+            try {
+                const result = xpathSelect(xpath, newDoc);
+                othersWithAttr = Array.isArray(result)
+                    ? result
+                    : [];
+            }
+            catch {
+                continue;
+            }
+            // If the attribute is unique, return it, otherwise save it and add an index,
+            // but only if it returns the least number of elements
+            if (othersWithAttr.length === 1) {
+                return uiSelector;
+            }
+            else if (!othersWithAttrMinCount ||
+                othersWithAttr.length < othersWithAttrMinCount) {
+                othersWithAttrMinCount = othersWithAttr.length;
+                mostUniqueSelector = `${uiSelector}.instance(${othersWithAttr.indexOf(newDomNode)})`;
+            }
+        }
+        // BASE CASE #5: Did not find any unique attributes - use the 'most unique' selector
+        if (mostUniqueSelector) {
+            return mostUniqueSelector;
+        }
+    }
+    catch (error) {
+        // If there's an unexpected exception, abort
+        logLocatorError('uiautomator selector', error);
+        return null;
+    }
+    return null;
+}
+function logLocatorError(strategy, error) {
+    log.error(`The most optimal ${strategy} could not be determined because an error was thrown: '${error}'`);
+}
+//# sourceMappingURL=locator-generation.js.map

package/dist/locators/locator-generation.js.map

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

package/dist/locators/logger.d.ts

@@ -0,0 +1,5 @@
+declare const log: import("@appium/types/build/lib/logger.js").AppiumLogger;
+export default log;
+export { log };
+export declare const trace: (message: string) => void;
+export declare const error: (message: string) => void;

package/dist/locators/logger.js

@@ -0,0 +1,9 @@
+import { logger } from '@appium/support';
+const log = logger.getLogger('mcp-appium');
+export default log;
+export { log };
+// For backward compatibility, export as named exports
+// Note: @appium/support logger doesn't have trace method, using debug instead
+export const trace = (message) => log.debug(message);
+export const error = (message) => log.error(message);
+//# sourceMappingURL=logger.js.map

package/dist/locators/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/locators/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;AAE3C,eAAe,GAAG,CAAC;AACnB,OAAO,EAAE,GAAG,EAAE,CAAC;AAEf,sDAAsD;AACtD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC"}

package/dist/locators/source-parsing.d.ts

@@ -0,0 +1,43 @@
+import { Document as XMLDocument, Node as XMLNode } from '@xmldom/xmldom';
+export declare const xmlToDOM: (string: string) => XMLDocument;
+export declare const domToXML: (dom: XMLNode) => string;
+/**
+ * Get the child nodes of a Node object
+ *
+ * @param {XMLNode} domNode
+ * @returns {Array<XMLNode>} list of Nodes
+ */
+export declare function childNodesOf(domNode: XMLNode): XMLNode[];
+/**
+ * Look up an element in the Document source using the provided path
+ *
+ * @param {string} path a dot-separated string of indices
+ * @param {XMLDocument} sourceDoc app source in Document format
+ * @returns {XMLNode} element node
+ */
+export declare function findDOMNodeByPath(path: string, sourceDoc: XMLDocument): XMLNode;
+interface ElementAttributes {
+    [key: string]: string;
+}
+interface JSONElement {
+    children: JSONElement[];
+    tagName: string;
+    attributes: ElementAttributes;
+    path: string;
+}
+/**
+ * Look up an element in the JSON source using the provided path
+ *
+ * @param {string} path a dot-separated string of indices
+ * @param {JSONElement} sourceJSON app source in JSON format
+ * @returns {JSONElement} element details in JSON format
+ */
+export declare function findJSONElementByPath(path: string, sourceJSON: JSONElement): JSONElement;
+/**
+ * Translates sourceXML to JSON
+ *
+ * @param {string} sourceXML
+ * @returns {JSONElement} source in JSON format
+ */
+export declare function xmlToJSON(sourceXML: string): JSONElement;
+export type { ElementAttributes, JSONElement };