appium-mcp 1.82.2 → 1.84.0

package/dist/tools/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../src/tools/evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AA2C3D,MAAM,kBAAkB,GAAG,sCAAsC,CAAC;AAalE;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClE,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,MAAM,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAqB,EACrB,KAAoB;IAEpB,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE;YACP,GAAG,MAAM,CAAC,OAAO;YACjB;gBACE,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE;oBACR,GAAG,EAAE,cAAc,MAAM,CAAC,UAAU,EAAE;oBACtC,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;iBAC7B;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAkB;IAElB,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,MAAM,IAAI,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzE,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC;IAEpD,IAAI,wDAAwD,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5E,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,iDAAiD,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrE,OAAO,uBAAuB,CAAC;IACjC,CAAC;IACD,IAAI,2CAA2C,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/D,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAS,WAAW,CAClB,MAAqB,EACrB,KAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC5B,MAAM,MAAM,GACV,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAEpE,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;QACtD,UAAU,EAAE,UAAU,EAAE;QACxB,MAAM;QACN,MAAM,EAAE;YACN,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD;QACD,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,MAAM,EAAE;YACN,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;YAClD,UAAU,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;YAC5C,UAAU,EAAE,QAAQ,GAAG,KAAK,CAAC,SAAS;SACvC;QACD,GAAG,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CACjB,GAAY,EACZ,MAAqB;IAErB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,YAAY,CAAC,GAAY,EAAE,MAAqB;IACvD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAC3D,OAAO,IAAI,IAAI,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC;AAC9D,CAAC"}

package/dist/tools/gestures/gesture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gesture.d.ts","sourceRoot":"","sources":["../../../src/tools/gestures/gesture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AActD,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAkDrD"}
+{"version":3,"file":"gesture.d.ts","sourceRoot":"","sources":["../../../src/tools/gestures/gesture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AA0BtD,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAwCrD"}

package/dist/tools/gestures/gesture.js

@@ -1,10 +1,12 @@
 import { errorResult, resolveDriver, textResult, toolErrorMessage, } from '../tool-response.js';
-import { GESTURE_ACTIONS, gestureSchema } from './schema.js';
+import { GESTURE_ACTIONS, gestureSchema, } from './schema.js';
 import { handleTap, handleDoubleTap, handleLongPress } from './handlers/tap.js';
 import { handleScroll, handleSwipe } from './handlers/swipe-scroll.js';
 import { handlePinchZoom } from './handlers/pinch.js';
 import { handleScrollToElement } from './handlers/scroll-to-element.js';
 import { back } from '../../command.js';
+import { withEvidence, evidenceContext, } from '../evidence.js';
+import { isAiElementUUID } from './handlers/ai-element.js';
 export default function gesture(server) {
     server.addTool({
         name: 'appium_gesture',
@@ -23,31 +25,51 @@ export default function gesture(server) {
                 return resolved.result;
             }
             const { driver } = resolved;
-            switch (args.action) {
-                case 'back':
-                    try {
-                        await back(driver);
-                        return textResult('Successfully performed back action.');
-                    }
-                    catch (err) {
-                        return errorResult(`Failed to perform back action. ${toolErrorMessage(err)}`);
-                    }
-                case 'tap':
-                    return handleTap(driver, args);
-                case 'double_tap':
-                    return handleDoubleTap(driver, args);
-                case 'long_press':
-                    return handleLongPress(driver, args);
-                case 'scroll':
-                    return handleScroll(driver, args);
-                case 'swipe':
-                    return handleSwipe(driver, args);
-                case 'pinch_zoom':
-                    return handlePinchZoom(driver, args);
-                case 'scroll_to_element':
-                    return handleScrollToElement(driver, args);
-            }
+            const startedAt = Date.now();
+            const context = await evidenceContext(args.sessionId);
+            const result = await dispatchGesture(driver, args);
+            return withEvidence(result, {
+                name: 'appium_gesture',
+                stage: gestureStage(args.action),
+                startedAt,
+                context,
+                ...(args.strategy && args.selector
+                    ? { locator: { strategy: args.strategy, selector: args.selector } }
+                    : {}),
+                ...(args.elementUUID && !isAiElementUUID(args.elementUUID)
+                    ? { element: { webdriverId: args.elementUUID } }
+                    : {}),
+            });
         },
     });
 }
+async function dispatchGesture(driver, args) {
+    switch (args.action) {
+        case 'back':
+            try {
+                await back(driver);
+                return textResult('Successfully performed back action.');
+            }
+            catch (err) {
+                return errorResult(`Failed to perform back action. ${toolErrorMessage(err)}`);
+            }
+        case 'tap':
+            return handleTap(driver, args);
+        case 'double_tap':
+            return handleDoubleTap(driver, args);
+        case 'long_press':
+            return handleLongPress(driver, args);
+        case 'scroll':
+            return handleScroll(driver, args);
+        case 'swipe':
+            return handleSwipe(driver, args);
+        case 'pinch_zoom':
+            return handlePinchZoom(driver, args);
+        case 'scroll_to_element':
+            return handleScrollToElement(driver, args);
+    }
+}
+function gestureStage(action) {
+    return action === 'scroll_to_element' ? 'locate' : 'interact';
+}
 //# sourceMappingURL=gesture.js.map

package/dist/tools/gestures/gesture.js.map

@@ -1 +1 @@
-{"version":3,"file":"gesture.js","sourceRoot":"","sources":["../../../src/tools/gestures/gesture.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,aAAa,EACb,UAAU,EACV,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,aAAa,EAAoB,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,MAAe;IAC7C,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,oDAAoD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAClF,gFAAgF;YAChF,yFAAyF;YACzF,gGAAgG;QAClG,UAAU,EAAE,aAAa;QACzB,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EACZ,IAAiB,EACjB,QAA6C,EACrB,EAAE;YAC1B,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,QAAQ,CAAC,MAAM,CAAC;YACzB,CAAC;YACD,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;YAE5B,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;gBACpB,KAAK,MAAM;oBACT,IAAI,CAAC;wBACH,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;wBACnB,OAAO,UAAU,CAAC,qCAAqC,CAAC,CAAC;oBAC3D,CAAC;oBAAC,OAAO,GAAY,EAAE,CAAC;wBACtB,OAAO,WAAW,CAChB,kCAAkC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAC1D,CAAC;oBACJ,CAAC;gBACH,KAAK,KAAK;oBACR,OAAO,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACjC,KAAK,YAAY;oBACf,OAAO,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACvC,KAAK,YAAY;oBACf,OAAO,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACvC,KAAK,QAAQ;oBACX,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACpC,KAAK,OAAO;oBACV,OAAO,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACnC,KAAK,YAAY;oBACf,OAAO,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACvC,KAAK,mBAAmB;oBACtB,OAAO,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"gesture.js","sourceRoot":"","sources":["../../../src/tools/gestures/gesture.ts"],"names":[],"mappings":"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"}

package/dist/tools/interactions/find.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/tools/interactions/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;iBAqC5B,CAAC;AAEH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA2CzD"}
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/tools/interactions/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;iBAqC5B,CAAC;AAEH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA4EzD"}

package/dist/tools/interactions/find.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { resolveDriver, textResultWithPrimaryElementId, errorResult, toolErrorMessage, readWebElementId, } from '../tool-response.js';
+import { withEvidence, evidenceContext } from '../evidence.js';
 export const findElementSchema = z.object({
     strategy: z
         .enum([
@@ -57,17 +58,39 @@ export default function findElement(server) {
                 return resolved.result;
             }
             const { driver } = resolved;
+            const startedAt = Date.now();
+            const locator = { strategy: args.strategy, selector: args.selector };
+            const context = await evidenceContext(args.sessionId);
             try {
                 const element = await driver.findElement(args.strategy, args.selector);
                 const elementId = readWebElementId(element);
                 if (!elementId) {
-                    return errorResult('Element was returned without a valid element ID');
+                    return withEvidence(errorResult('Element was returned without a valid element ID'), {
+                        name: 'appium_find_element',
+                        stage: 'locate',
+                        startedAt,
+                        locator,
+                        context,
+                    });
                 }
-                return textResultWithPrimaryElementId(elementId, `Successfully found element ${args.selector} with strategy ${args.strategy}.`);
+                return withEvidence(textResultWithPrimaryElementId(elementId, `Successfully found element ${args.selector} with strategy ${args.strategy}.`), {
+                    name: 'appium_find_element',
+                    stage: 'locate',
+                    startedAt,
+                    locator,
+                    element: { webdriverId: elementId },
+                    context,
+                });
             }
             catch (err) {
-                const errorMessage = toolErrorMessage(err);
-                return errorResult(`Failed to find element. Error: ${errorMessage}`);
+                return withEvidence(errorResult(`Failed to find element. Error: ${toolErrorMessage(err)}`), {
+                    name: 'appium_find_element',
+                    stage: 'locate',
+                    startedAt,
+                    locator,
+                    context,
+                    error: err,
+                });
             }
         },
     });

package/dist/tools/interactions/find.js.map

@@ -1 +1 @@
-{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../src/tools/interactions/find.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,aAAa,EACb,8BAA8B,EAC9B,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC;QACJ,kBAAkB;QAClB,IAAI;QACJ,uBAAuB;QACvB,kBAAkB;QAClB,sBAAsB;QACtB,OAAO;QACP,MAAM;QACN,YAAY;QACZ,cAAc;KACf,CAAC;SACD,QAAQ,CACP,2CAA2C;QACzC,+DAA+D;QAC/D,8DAA8D;QAC9D,gDAAgD;QAChD,wDAAwD;QACxD,oEAAoE;QACpE,6EAA6E;QAC7E,2CAA2C;QAC3C,qDAAqD;QACrD,mDAAmD;QACnD,yFAAyF;QACzF,uGAAuG,CAC1G;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CACP,2CAA2C;QACzC,6GAA6G,CAChH;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;CAC1E,CAAC,CAAC;AAEH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,MAAe;IACjD,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE;;;;;;;;mGAQkF;QAC/F,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EACZ,IAAuC,EACvC,QAA6C,EACrB,EAAE;YAC1B,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,QAAQ,CAAC,MAAM,CAAC;YACzB,CAAC;YACD,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;YAE5B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvE,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;gBAC5C,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,OAAO,WAAW,CAAC,iDAAiD,CAAC,CAAC;gBACxE,CAAC;gBACD,OAAO,8BAA8B,CACnC,SAAS,EACT,8BAA8B,IAAI,CAAC,QAAQ,kBAAkB,IAAI,CAAC,QAAQ,GAAG,CAC9E,CAAC;YACJ,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;gBAC3C,OAAO,WAAW,CAAC,kCAAkC,YAAY,EAAE,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../src/tools/interactions/find.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "appium-mcp",
   "mcpName": "io.github.appium/appium-mcp",
-  "version": "1.82.2",
+  "version": "1.84.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -27,8 +27,7 @@
     "appium-mcp": "dist/index.js"
   },
   "scripts": {
-    "build": "rimraf dist tsconfig.tsbuildinfo && tsc -b && chmod +x dist/index.js && npm run copy-docs",
-    "copy-docs": "mkdir -p dist/tools/documentation/uploads dist/scripts && cp -f src/tools/documentation/uploads/documents.json dist/tools/documentation/uploads/documents.json 2>/dev/null || true && cp -f src/tools/documentation/uploads/embeddings-*.json dist/tools/documentation/uploads/ 2>/dev/null || true && cp -f src/scripts/rag-eval-dataset.json dist/scripts/rag-eval-dataset.json 2>/dev/null || true",
+    "build": "rimraf dist tsconfig.tsbuildinfo && tsc -b && chmod +x dist/index.js",
     "start": "node dist/index.js",
     "start:stdio": "node dist/index.js",
     "start:httpStream": "node dist/index.js --httpStream",
@@ -45,27 +44,17 @@
     "format": "prettier --write \"src/**/*.{ts,js,json}\"",
     "format:check": "prettier --check \"src/**/*.{ts,js,json}\"",
     "check": "npm run lint && npm run format:check",
-    "index-docs": "node dist/scripts/simple-index-documentation.js",
-    "query-docs": "node dist/scripts/simple-query-documentation.js",
-    "eval-docs": "node dist/scripts/eval-documentation-rag.js",
-    "generate-cache": "node dist/scripts/generate-embeddings-cache.js",
-    "prepublishOnly": "npm run build && npm run generate-cache",
+    "prepublishOnly": "npm run build",
     "sync-version": "node scripts/sync-version.mjs",
-    "version": "npm run sync-version",
-    "zip-assets": "node scripts/zip-assets.mjs zip",
-    "unzip-assets": "node scripts/zip-assets.mjs unzip",
-    "preinstall": "node scripts/zip-assets.mjs unzip"
+    "version": "npm run sync-version"
   },
   "author": "",
   "license": "Apache-2.0",
   "description": "Intelligent MCP server providing AI assistants with powerful tools and resources for Appium mobile automation",
   "dependencies": {
+    "@appium/mcp-documentation": "^1.0.1",
     "@appium/support": "^7.0.2",
-    "@langchain/classic": "^1.0.10",
-    "@langchain/core": "^1.1.17",
-    "@langchain/textsplitters": "^1.0.1",
     "@modelcontextprotocol/sdk": "^1.22.0",
-    "@xenova/transformers": "^2.17.2",
     "@xmldom/xmldom": "^0.9.8",
     "appium-adb": "^15.0.0",
     "appium-ios-device": "^3.1.0",
@@ -73,18 +62,17 @@
     "appium-webdriveragent": "^12.1.1",
     "appium-xcuitest-driver": "^11.0.0",
     "applesign": "^5.0.0",
-    "fast-xml-parser": "^5.2.3",
     "fastmcp": "^4.0.0",
     "ios-mobileprovision-finder": "^1.2.1",
-    "langchain": "^1.1.6",
     "node-simctl": "^8.0.4",
-    "rimraf": "^6.0.1",
+    "lru-cache": "^11.5.0",
     "webdriver": "^9.23.0",
     "xpath": "^0.0.34",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@appium/eslint-config-appium-ts": "^3.0.0",
+    "@appium/tsconfig": "^1.1.2",
     "@jest/globals": "^30.2.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
@@ -95,6 +83,7 @@
     "jest": "^30.2.0",
     "lint-staged": "^17.0.2",
     "prettier": "^3.5.3",
+    "rimraf": "^6.0.1",
     "semantic-release": "^25.0.2",
     "ts-node": "^10.9.2",
     "typescript": "^6.0.2"

package/server.json

@@ -3,12 +3,12 @@
   "name": "io.github.appium/appium-mcp",
   "title": "MCP Appium - Mobile Development and Automation Server",
   "description": "MCP server for Appium mobile automation on iOS and Android devices with test creation tools.",
-  "version": "1.82.2",
+  "version": "1.84.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "appium-mcp",
-      "version": "1.82.2",
+      "version": "1.84.0",
       "transport": {
         "type": "stdio"
       }

package/src/create-server.ts

@@ -103,6 +103,10 @@ export function createAppiumMcpServer(
     name: serverName,
     version: serverVersion,
     instructions,
+    // Appium MCP will not allow client to ask the local workspace/project folders.
+    roots: {
+      enabled: false,
+    },
   });
 
   installPolicy(server, policy);

package/src/server.ts

@@ -1,7 +1,12 @@
+import type { AppiumMcpPlugin } from './core.js';
 import { createAppiumMcpServer } from './create-server.js';
-import { AppiumDocumentation } from './tools/documentation/plugin.js';
 
-const server = createAppiumMcpServer({
-  plugins: [new AppiumDocumentation()],
-});
+const plugins: AppiumMcpPlugin[] = [];
+
+try {
+  const { AppiumDocumentation } = await import('@appium/mcp-documentation');
+  plugins.push(new AppiumDocumentation());
+} catch (_err) {}
+
+const server = createAppiumMcpServer({ plugins });
 export default server;

package/src/tools/evidence.ts

@@ -0,0 +1,198 @@
+import { randomUUID } from 'node:crypto';
+import type { ContentResult } from 'fastmcp';
+import pkg from '../../package.json' with { type: 'json' };
+
+/**
+ * Structured, machine-readable trace of a single tool action, so CI and agents
+ *  can diagnose failures without parsing prose.
+ *
+ * This is an *action* record. A future run-level bundle may reference many of
+ * these plus heavier artifacts (screenshots, page source).
+ */
+export interface ActionEvidenceRecord {
+  schemaVersion: 1;
+  producer: { name: 'appium-mcp'; version: string };
+  evidenceId: string;
+  status: 'success' | 'error';
+  /**
+   * Action-specific details. `stage`/`locator`/`element` are optional because
+   * they only apply to tools that resolve or interact with elements (find,
+   * gesture); tools like screenshot carry just `name`.
+   */
+  action: {
+    name: string;
+    stage?: EvidenceStage;
+    locator?: { strategy: string; selector: string };
+    element?: { webdriverId: string };
+  };
+  context?: {
+    platform?: string;
+    contextName?: string;
+  };
+  timing: { startedAt: string; finishedAt: string; durationMs: number };
+  error?: { code: EvidenceErrorCode; message: string };
+}
+
+export type EvidenceStage = 'locate' | 'interact' | 'capture';
+
+export type EvidenceErrorCode =
+  | 'ELEMENT_NOT_FOUND'
+  | 'TIMEOUT'
+  | 'STALE_ELEMENT'
+  | 'CONTEXT_NOT_AVAILABLE'
+  | 'INVALID_SELECTOR'
+  | 'ACTION_FAILED';
+
+const EVIDENCE_MIME_TYPE = 'application/vnd.appium.evidence+json';
+
+/** Inputs a handler supplies to describe the action it performed. */
+export interface EvidenceInput {
+  name: string;
+  startedAt: number;
+  stage?: EvidenceStage;
+  locator?: ActionEvidenceRecord['action']['locator'];
+  element?: ActionEvidenceRecord['action']['element'];
+  context?: ActionEvidenceRecord['context'];
+  error?: unknown;
+}
+
+/**
+ * When disabled, evidence is never built or attached and tool
+ * responses are byte-for-byte unchanged.
+ */
+export function isEvidenceEnabled(): boolean {
+  const raw = process.env.APPIUM_MCP_EVIDENCE?.trim().toLowerCase();
+  return raw === '1' || raw === 'true';
+}
+
+/**
+ * Attach an evidence record to an existing tool result as a `resource` content
+ * block, leaving the original text untouched. No-op when evidence is disabled.
+ */
+export function withEvidence(
+  result: ContentResult,
+  input: EvidenceInput
+): ContentResult {
+  if (!isEvidenceEnabled()) {
+    return result;
+  }
+  const record = buildRecord(result, input);
+  return {
+    ...result,
+    content: [
+      ...result.content,
+      {
+        type: 'resource',
+        resource: {
+          uri: `evidence://${record.evidenceId}`,
+          mimeType: EVIDENCE_MIME_TYPE,
+          text: JSON.stringify(record),
+        },
+      },
+    ],
+  };
+}
+
+/**
+ * Snapshot the active session's platform and current context for the evidence
+ * record. Returns undefined when there is no session to read, so the field is
+ * simply omitted. The session-store import is deferred until evidence is
+ * enabled so the disabled path pulls in no driver dependencies.
+ */
+export async function evidenceContext(
+  sessionId?: string
+): Promise<ActionEvidenceRecord['context'] | undefined> {
+  if (!isEvidenceEnabled()) {
+    return undefined;
+  }
+  const { getSessionInfo } = await import('../session-store.js');
+  const info = getSessionInfo(sessionId);
+  if (!info) {
+    return undefined;
+  }
+  return {
+    ...(info.metadata.platform ? { platform: info.metadata.platform } : {}),
+    ...(info.currentContext ? { contextName: info.currentContext } : {}),
+  };
+}
+
+/**
+ * Map a raw Appium/WebDriver error to a stable, normalized code. The codes are
+ * also the foundation for failure-reason hypotheses. Inspects the error name
+ * first, then the message, falling back to ACTION_FAILED.
+ */
+export function classifyError(err: unknown): EvidenceErrorCode {
+  const name = err instanceof Error ? err.name : '';
+  const message = (err instanceof Error ? err.message : String(err)) ?? '';
+  const haystack = `${name} ${message}`.toLowerCase();
+
+  if (/no such element|could not be located|element not found/.test(haystack)) {
+    return 'ELEMENT_NOT_FOUND';
+  }
+  if (/stale element/.test(haystack)) {
+    return 'STALE_ELEMENT';
+  }
+  if (/timed? ?out|timeout/.test(haystack)) {
+    return 'TIMEOUT';
+  }
+  if (/no such context|context.*not.*(found|available)/.test(haystack)) {
+    return 'CONTEXT_NOT_AVAILABLE';
+  }
+  if (/invalid selector|invalid.*(locator|xpath)/.test(haystack)) {
+    return 'INVALID_SELECTOR';
+  }
+  return 'ACTION_FAILED';
+}
+
+function buildRecord(
+  result: ContentResult,
+  input: EvidenceInput
+): ActionEvidenceRecord {
+  const finished = Date.now();
+  const status: ActionEvidenceRecord['status'] =
+    result.isError || input.error !== undefined ? 'error' : 'success';
+
+  return {
+    schemaVersion: 1,
+    producer: { name: 'appium-mcp', version: pkg.version },
+    evidenceId: randomUUID(),
+    status,
+    action: {
+      name: input.name,
+      ...(input.stage ? { stage: input.stage } : {}),
+      ...(input.locator ? { locator: input.locator } : {}),
+      ...(input.element ? { element: input.element } : {}),
+    },
+    ...(input.context ? { context: input.context } : {}),
+    timing: {
+      startedAt: new Date(input.startedAt).toISOString(),
+      finishedAt: new Date(finished).toISOString(),
+      durationMs: finished - input.startedAt,
+    },
+    ...(status === 'error' ? { error: buildError(input.error, result) } : {}),
+  };
+}
+
+/**
+ * Resolve the error message, then classify from the same source so the code
+ * and message always agree — handlers that swallow errors only expose the
+ * result text, so fall back to that when no error object is passed.
+ */
+function buildError(
+  err: unknown,
+  result: ContentResult
+): NonNullable<ActionEvidenceRecord['error']> {
+  const message = errorMessage(err, result);
+  return { code: classifyError(err ?? message), message };
+}
+
+function errorMessage(err: unknown, result: ContentResult): string {
+  if (err instanceof Error) {
+    return err.message;
+  }
+  if (err !== undefined) {
+    return String(err);
+  }
+  const text = result.content.find((c) => c.type === 'text');
+  return text && 'text' in text ? text.text : 'Unknown error';
+}

package/src/tools/gestures/gesture.ts

@@ -1,16 +1,28 @@
 import type { ContentResult, FastMCP } from 'fastmcp';
+import type { DriverInstance } from '../../session-store.js';
 import {
   errorResult,
   resolveDriver,
   textResult,
   toolErrorMessage,
 } from '../tool-response.js';
-import { GESTURE_ACTIONS, gestureSchema, type GestureArgs } from './schema.js';
+import {
+  GESTURE_ACTIONS,
+  gestureSchema,
+  type GestureAction,
+  type GestureArgs,
+} from './schema.js';
 import { handleTap, handleDoubleTap, handleLongPress } from './handlers/tap.js';
 import { handleScroll, handleSwipe } from './handlers/swipe-scroll.js';
 import { handlePinchZoom } from './handlers/pinch.js';
 import { handleScrollToElement } from './handlers/scroll-to-element.js';
 import { back } from '../../command.js';
+import {
+  withEvidence,
+  evidenceContext,
+  type EvidenceStage,
+} from '../evidence.js';
+import { isAiElementUUID } from './handlers/ai-element.js';
 
 export default function gesture(server: FastMCP): void {
   server.addTool({
@@ -35,31 +47,56 @@ export default function gesture(server: FastMCP): void {
       }
       const { driver } = resolved;
 
-      switch (args.action) {
-        case 'back':
-          try {
-            await back(driver);
-            return textResult('Successfully performed back action.');
-          } catch (err: unknown) {
-            return errorResult(
-              `Failed to perform back action. ${toolErrorMessage(err)}`
-            );
-          }
-        case 'tap':
-          return handleTap(driver, args);
-        case 'double_tap':
-          return handleDoubleTap(driver, args);
-        case 'long_press':
-          return handleLongPress(driver, args);
-        case 'scroll':
-          return handleScroll(driver, args);
-        case 'swipe':
-          return handleSwipe(driver, args);
-        case 'pinch_zoom':
-          return handlePinchZoom(driver, args);
-        case 'scroll_to_element':
-          return handleScrollToElement(driver, args);
-      }
+      const startedAt = Date.now();
+      const context = await evidenceContext(args.sessionId);
+      const result = await dispatchGesture(driver, args);
+      return withEvidence(result, {
+        name: 'appium_gesture',
+        stage: gestureStage(args.action),
+        startedAt,
+        context,
+        ...(args.strategy && args.selector
+          ? { locator: { strategy: args.strategy, selector: args.selector } }
+          : {}),
+        ...(args.elementUUID && !isAiElementUUID(args.elementUUID)
+          ? { element: { webdriverId: args.elementUUID } }
+          : {}),
+      });
     },
   });
 }
+
+async function dispatchGesture(
+  driver: DriverInstance,
+  args: GestureArgs
+): Promise<ContentResult> {
+  switch (args.action) {
+    case 'back':
+      try {
+        await back(driver);
+        return textResult('Successfully performed back action.');
+      } catch (err: unknown) {
+        return errorResult(
+          `Failed to perform back action. ${toolErrorMessage(err)}`
+        );
+      }
+    case 'tap':
+      return handleTap(driver, args);
+    case 'double_tap':
+      return handleDoubleTap(driver, args);
+    case 'long_press':
+      return handleLongPress(driver, args);
+    case 'scroll':
+      return handleScroll(driver, args);
+    case 'swipe':
+      return handleSwipe(driver, args);
+    case 'pinch_zoom':
+      return handlePinchZoom(driver, args);
+    case 'scroll_to_element':
+      return handleScrollToElement(driver, args);
+  }
+}
+
+function gestureStage(action: GestureAction): EvidenceStage {
+  return action === 'scroll_to_element' ? 'locate' : 'interact';
+}