appium-mcp 1.90.1 → 1.91.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [1.91.0](https://github.com/appium/appium-mcp/compare/v1.90.1...v1.91.0) (2026-07-31)
+
+### Features
+
+* avoid duplicate screenshot and locator UI payloads ([#478](https://github.com/appium/appium-mcp/issues/478)) ([562e84e](https://github.com/appium/appium-mcp/commit/562e84e58063d071bb46d9e1c2fe093b50f30a88))
+
 ## [1.90.1](https://github.com/appium/appium-mcp/compare/v1.90.0...v1.90.1) (2026-07-29)
 
 ### Miscellaneous Chores

package/README.md

@@ -332,9 +332,14 @@ More models benchmarked can be found [here](src/tests/benchmark_model/TEST_REPOR
 
 #### MCP Apps Mode
 
-`appium_get_page_source` uses a static MCP App inspector by default when the client advertises MCP Apps support.
-The XML remains in the normal text result for the LLM, while the inspector reads that same result instead of
-receiving a duplicated XML copy.
+`appium_get_page_source`, `appium_screenshot`, and `generate_locators` use static MCP App viewers by default when
+the client advertises MCP Apps support.
+
+- Page source XML and generated locator JSON remain in their normal text results for the LLM. Their viewers read
+  those existing results instead of receiving duplicated copies inside generated HTML.
+- Saved screenshot base64 is delivered to the viewer through `structuredContent`, which MCP Apps keeps out of model
+  context. The LLM still receives the saved file path. Explicit `returnRawBase64=true` calls keep their existing raw
+  image result.
 
 For clients with unreliable MCP Apps rendering, set `APPIUM_MCP_APPS_ENABLED` to `false` or `0`:
 
@@ -348,9 +353,9 @@ For clients with unreliable MCP Apps rendering, set `APPIUM_MCP_APPS_ENABLED` to
 }
 ```
 
-This keeps interactive UI enabled but forces the previous embedded page-source inspector. The compatibility mode
-duplicates the XML inside the inspector HTML and therefore uses more result tokens and bandwidth. With a synthetic
-95,000-character page source, the static mode reduced the result from approximately 267 KB to 95 KB (about 64%).
+This keeps interactive UI enabled but forces the previous embedded viewers. The compatibility mode places viewer
+data inside inline HTML and therefore uses more result tokens and bandwidth. With a synthetic 95,000-character page
+source, the static mode reduced the result from approximately 267 KB to 95 KB (about 64%).
 
 `NO_UI=true` or `NO_UI=1` takes precedence over this setting and disables both static and embedded UI.
 

package/dist/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAM,EAAE,GAAG,QAMpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAM,EAAE,GAAG,QAQpD"}

package/dist/resources/index.js

@@ -2,11 +2,15 @@ import log from '../logger.js';
 import { isMcpAppsEnabled } from '../ui/mcp-apps.js';
 // Export all resources
 import javaTemplatesResource from './java/template.js';
+import locatorGeneratorResource from './locator-generator.js';
 import pageSourceInspectorResource from './page-source-inspector.js';
+import screenshotViewerResource from './screenshot-viewer.js';
 export default function registerResources(server) {
     javaTemplatesResource(server);
     if (isMcpAppsEnabled()) {
         pageSourceInspectorResource(server);
+        screenshotViewerResource(server);
+        locatorGeneratorResource(server);
     }
     log.info('All resources registered');
 }

package/dist/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,cAAc,CAAC;AAC/B,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AACnD,uBAAuB;AACvB,OAAO,qBAAqB,MAAM,oBAAoB,CAAC;AACvD,OAAO,2BAA2B,MAAM,4BAA4B,CAAC;AAErE,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAW;IACnD,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACvB,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,cAAc,CAAC;AAC/B,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AACnD,uBAAuB;AACvB,OAAO,qBAAqB,MAAM,oBAAoB,CAAC;AACvD,OAAO,wBAAwB,MAAM,wBAAwB,CAAC;AAC9D,OAAO,2BAA2B,MAAM,4BAA4B,CAAC;AACrE,OAAO,wBAAwB,MAAM,wBAAwB,CAAC;AAE9D,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAW;IACnD,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACvB,2BAA2B,CAAC,MAAM,CAAC,CAAC;QACpC,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACjC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AACvC,CAAC"}

package/dist/resources/locator-generator.d.ts

@@ -0,0 +1,4 @@
+import type { FastMCP } from 'fastmcp';
+export declare const LOCATOR_GENERATOR_URI = "ui://appium-mcp/locator-generator";
+export default function locatorGeneratorResource(server: FastMCP): void;
+//# sourceMappingURL=locator-generator.d.ts.map

package/dist/resources/locator-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator-generator.d.ts","sourceRoot":"","sources":["../../src/resources/locator-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAKrC,eAAO,MAAM,qBAAqB,sCAAsC,CAAC;AAEzE,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAUtE"}

package/dist/resources/locator-generator.js

@@ -0,0 +1,15 @@
+import { createLocatorGeneratorAppUI } from '../ui/locator-generator-app.js';
+import { MCP_APP_MIME_TYPE } from '../ui/mcp-apps.js';
+export const LOCATOR_GENERATOR_URI = 'ui://appium-mcp/locator-generator';
+export default function locatorGeneratorResource(server) {
+    server.addResource({
+        uri: LOCATOR_GENERATOR_URI,
+        name: 'Appium Locator Generator',
+        description: 'Interactive viewer for generate_locators results',
+        mimeType: MCP_APP_MIME_TYPE,
+        async load() {
+            return { text: createLocatorGeneratorAppUI() };
+        },
+    });
+}
+//# sourceMappingURL=locator-generator.js.map

package/dist/resources/locator-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator-generator.js","sourceRoot":"","sources":["../../src/resources/locator-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,2BAA2B,EAAC,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAEpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,mCAAmC,CAAC;AAEzE,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,MAAe;IAC9D,MAAM,CAAC,WAAW,CAAC;QACjB,GAAG,EAAE,qBAAqB;QAC1B,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,kDAAkD;QAC/D,QAAQ,EAAE,iBAAiB;QAC3B,KAAK,CAAC,IAAI;YACR,OAAO,EAAC,IAAI,EAAE,2BAA2B,EAAE,EAAC,CAAC;QAC/C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/resources/screenshot-viewer.d.ts

@@ -0,0 +1,4 @@
+import type { FastMCP } from 'fastmcp';
+export declare const SCREENSHOT_VIEWER_URI = "ui://appium-mcp/screenshot-viewer";
+export default function screenshotViewerResource(server: FastMCP): void;
+//# sourceMappingURL=screenshot-viewer.d.ts.map

package/dist/resources/screenshot-viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-viewer.d.ts","sourceRoot":"","sources":["../../src/resources/screenshot-viewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAKrC,eAAO,MAAM,qBAAqB,sCAAsC,CAAC;AAEzE,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAUtE"}

package/dist/resources/screenshot-viewer.js

@@ -0,0 +1,15 @@
+import { MCP_APP_MIME_TYPE } from '../ui/mcp-apps.js';
+import { createScreenshotViewerAppUI } from '../ui/screenshot-viewer-app.js';
+export const SCREENSHOT_VIEWER_URI = 'ui://appium-mcp/screenshot-viewer';
+export default function screenshotViewerResource(server) {
+    server.addResource({
+        uri: SCREENSHOT_VIEWER_URI,
+        name: 'Appium Screenshot Viewer',
+        description: 'Interactive viewer for appium_screenshot results',
+        mimeType: MCP_APP_MIME_TYPE,
+        async load() {
+            return { text: createScreenshotViewerAppUI() };
+        },
+    });
+}
+//# sourceMappingURL=screenshot-viewer.js.map

package/dist/resources/screenshot-viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-viewer.js","sourceRoot":"","sources":["../../src/resources/screenshot-viewer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAC,2BAA2B,EAAC,MAAM,gCAAgC,CAAC;AAE3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,mCAAmC,CAAC;AAEzE,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,MAAe;IAC9D,MAAM,CAAC,WAAW,CAAC;QACjB,GAAG,EAAE,qBAAqB;QAC1B,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,kDAAkD;QAC/D,QAAQ,EAAE,iBAAiB;QAC3B,KAAK,CAAC,IAAI;YACR,OAAO,EAAC,IAAI,EAAE,2BAA2B,EAAE,EAAC,CAAC;QAC/C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/interactions/screenshot.d.ts

@@ -1,4 +1,4 @@
-import type { FastMCP } from 'fastmcp';
+import type { ContentResult, FastMCP } from 'fastmcp';
 import { resolveScreenshotDir } from '../../utils/paths.js';
 export { resolveScreenshotDir };
 export interface ScreenshotDeps {
@@ -15,6 +15,7 @@ export declare function executeScreenshot(opts: {
     maxWidth?: number;
     returnRawBase64?: boolean;
     sessionId?: string;
-}): Promise<any>;
+    useMcpApps?: boolean;
+}): Promise<ContentResult>;
 export default function screenshot(server: FastMCP): void;
 //# sourceMappingURL=screenshot.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../src/tools/interactions/screenshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAMrC,OAAO,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAC,oBAAoB,EAAC,CAAC;AAE9B,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9E,oBAAoB,EAAE,OAAO,oBAAoB,CAAC;IAClD,OAAO,EAAE,MAAM,MAAM,CAAC;CACvB;AASD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,GAAG,CAAC,CAmEf;AAyBD,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAiBxD"}
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../src/tools/interactions/screenshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,aAAa,EAAE,OAAO,EAAC,MAAM,SAAS,CAAC;AAQpD,OAAO,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAC,oBAAoB,EAAC,CAAC;AAE9B,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9E,oBAAoB,EAAE,OAAO,oBAAoB,CAAC;IAClD,OAAO,EAAE,MAAM,MAAM,CAAC;CACvB;AASD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmFzB;AAyBD,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAuBxD"}

package/dist/tools/interactions/screenshot.js

@@ -2,7 +2,9 @@ import { join } from 'node:path';
 import { fs, imageUtil } from '@appium/support';
 import z from 'zod';
 import { getScreenshot } from '../../command.js';
+import { SCREENSHOT_VIEWER_URI } from '../../resources/screenshot-viewer.js';
 import { elementUUIDScheme } from '../../schema.js';
+import { clientSupportsMcpApps, isMcpAppsEnabled } from '../../ui/mcp-apps.js';
 import { createUIResource, createScreenshotViewerUI, addUIResourceToResponse } from '../../ui/mcp-ui-utils.js';
 import { resolveScreenshotDir } from '../../utils/paths.js';
 import { resolveDriver, textResult, errorResult, toolErrorMessage } from '../tool-response.js';
@@ -14,7 +16,7 @@ const defaultDeps = {
     dateNow: () => Date.now(),
 };
 export async function executeScreenshot(opts) {
-    const { deps = defaultDeps, elementId, maxWidth, returnRawBase64, sessionId } = opts;
+    const { deps = defaultDeps, elementId, maxWidth, returnRawBase64, sessionId, useMcpApps = false } = opts;
     const resolved = await resolveDriver(sessionId);
     if (!resolved.ok) {
         return resolved.result;
@@ -59,6 +61,21 @@ export async function executeScreenshot(opts) {
         // Save screenshot to disk
         await deps.writeFile(filepath, screenshotBuffer);
         const textResponse = textResult(`Screenshot saved successfully to: ${filepath}`);
+        // MCP Apps-capable clients receive the image through structuredContent.
+        // It remains available to the viewer without adding base64 data to model
+        // context or duplicating it inside generated HTML.
+        if (useMcpApps) {
+            return {
+                ...textResponse,
+                structuredContent: {
+                    screenshot: {
+                        data: displayBase64,
+                        mimeType: 'image/png',
+                        filepath,
+                    },
+                },
+            };
+        }
         // Add interactive screenshot viewer UI
         return addUIResourceToResponse(textResponse, () => createUIResource(`ui://appium-mcp/screenshot-viewer/${Date.now()}`, createScreenshotViewerUI(displayBase64, filepath)));
     }
@@ -85,19 +102,22 @@ const screenshotSchema = z.object({
     sessionId: z.string().optional().describe('Session ID to target. If omitted, uses the active session.'),
 });
 export default function screenshot(server) {
+    const mcpAppsEnabled = isMcpAppsEnabled();
     server.addTool({
         name: 'appium_screenshot',
         description: 'Take a screenshot and save as PNG. Optionally provide elementUUID to capture only that element.',
+        _meta: mcpAppsEnabled ? { ui: { resourceUri: SCREENSHOT_VIEWER_URI } } : undefined,
         parameters: screenshotSchema,
         annotations: {
             readOnlyHint: false,
             openWorldHint: false,
         },
-        execute: async (args, _context) => executeScreenshot({
+        execute: async (args, context) => executeScreenshot({
             elementId: args.elementUUID,
             maxWidth: args.maxWidth,
             returnRawBase64: args.returnRawBase64,
             sessionId: args.sessionId,
+            useMcpApps: mcpAppsEnabled && clientSupportsMcpApps(server, context),
         }),
     });
 }

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

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

package/dist/tools/test-generation/locators.d.ts

@@ -1,2 +1,14 @@
-export default function generateLocators(server: any): void;
+/**
+ * Tool to get page source from the Android session
+ *
+ * TOOL EXTENSION GUIDE:
+ * This tool demonstrates the traditional approach where metadata is defined inline.
+ *
+ * ALTERNATIVE APPROACH: You can also use YAML metadata files for better separation.
+ * See src/tools/metadata/ for examples and src/tools/scroll-with-yaml.example.ts
+ *
+ * For detailed documentation on adding tools, see docs/CONTRIBUTING.md
+ */
+import type { FastMCP } from 'fastmcp';
+export default function generateLocators(server: FastMCP): void;
 //# sourceMappingURL=locators.d.ts.map

package/dist/tools/test-generation/locators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locators.d.ts","sourceRoot":"","sources":["../../../src/tools/test-generation/locators.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAyD1D"}
+{"version":3,"file":"locators.d.ts","sourceRoot":"","sources":["../../../src/tools/test-generation/locators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAWrC,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAkE9D"}

package/dist/tools/test-generation/locators.js

@@ -1,24 +1,17 @@
-/**
- * Tool to get page source from the Android session
- *
- * TOOL EXTENSION GUIDE:
- * This tool demonstrates the traditional approach where metadata is defined inline.
- *
- * ALTERNATIVE APPROACH: You can also use YAML metadata files for better separation.
- * See src/tools/metadata/ for examples and src/tools/scroll-with-yaml.example.ts
- *
- * For detailed documentation on adding tools, see docs/CONTRIBUTING.md
- */
 import { z } from 'zod';
 import { getPageSource } from '../../command.js';
 import { generateAllElementLocators } from '../../locators/generate-all-locators.js';
+import { LOCATOR_GENERATOR_URI } from '../../resources/locator-generator.js';
 import { isAndroidUiautomator2DriverSession, isXCUITestDriverSession } from '../../session-store.js';
+import { clientSupportsMcpApps, isMcpAppsEnabled } from '../../ui/mcp-apps.js';
 import { createUIResource, createLocatorGeneratorUI, addUIResourceToResponse } from '../../ui/mcp-ui-utils.js';
 import { resolveDriver, textResult, errorResult, toolErrorMessage } from '../tool-response.js';
 export default function generateLocators(server) {
+    const mcpAppsEnabled = isMcpAppsEnabled();
     server.addTool({
         name: 'generate_locators',
         description: `Generate locators for all interactable elements on the current page. [PRIORITY 3: Use this for debugging/inspection or when you need comprehensive element info with locator suggestions]`,
+        _meta: mcpAppsEnabled ? { ui: { resourceUri: LOCATOR_GENERATOR_URI } } : undefined,
         parameters: z.object({
             sessionId: z.string().optional().describe('Session ID to target. If omitted, uses the active session.'),
         }),
@@ -26,7 +19,8 @@ export default function generateLocators(server) {
             readOnlyHint: true,
             openWorldHint: false,
         },
-        execute: async (args, { log }) => {
+        execute: async (args, context) => {
+            const { log } = context;
             log.info('Getting page source');
             const resolved = await resolveDriver(args.sessionId);
             if (!resolved.ok) {
@@ -55,6 +49,11 @@ export default function generateLocators(server) {
                     instruction: `These are the locators for the current page. Use this to generate code for the current page.
                      Using the template provided by generate://code-with-locators resource.`,
                 }));
+                // The static MCP App reads the existing JSON text result instead of
+                // receiving a second copy rendered into inline HTML.
+                if (mcpAppsEnabled && clientSupportsMcpApps(server, context)) {
+                    return textResponse;
+                }
                 return addUIResourceToResponse(textResponse, () => createUIResource(`ui://appium-mcp/locator-generator/${Date.now()}`, createLocatorGeneratorUI(interactableElements)));
             }
             catch (err) {

package/dist/tools/test-generation/locators.js.map

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

package/dist/ui/locator-generator-app.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Static MCP App used by generate_locators.
+ *
+ * Locator data is read from the tool's existing JSON text result, avoiding a
+ * second rendered copy of the same element and locator strings in inline HTML.
+ */
+export declare function createLocatorGeneratorAppUI(): string;
+//# sourceMappingURL=locator-generator-app.d.ts.map

package/dist/ui/locator-generator-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator-generator-app.d.ts","sourceRoot":"","sources":["../../src/ui/locator-generator-app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAkRpD"}

package/dist/ui/locator-generator-app.js

@@ -0,0 +1,282 @@
+/**
+ * Static MCP App used by generate_locators.
+ *
+ * Locator data is read from the tool's existing JSON text result, avoiding a
+ * second rendered copy of the same element and locator strings in inline HTML.
+ */
+export function createLocatorGeneratorAppUI() {
+    return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Locator Generator</title>
+  <style>
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      padding: 20px;
+      background: #f5f5f5;
+      color: #222;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    }
+    .container { max-width: 1200px; margin: 0 auto; }
+    .header { margin-bottom: 24px; }
+    .header h1 { margin: 0 0 8px; font-size: 24px; }
+    .status { margin: 0; color: #666; }
+    .grid { display: grid; gap: 16px; }
+    .card {
+      padding: 16px;
+      border: 1px solid #e0e0e0;
+      border-radius: 8px;
+      background: #fff;
+      box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
+    }
+    .card-header {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 12px;
+      margin-bottom: 12px;
+    }
+    .card-header h2 { margin: 0; font-size: 16px; font-weight: 600; }
+    .badges { display: flex; flex-wrap: wrap; gap: 6px; }
+    .badge {
+      padding: 2px 8px;
+      border-radius: 4px;
+      font-size: 11px;
+      font-weight: 500;
+    }
+    .badge-clickable { background: #d4edda; color: #155724; }
+    .badge-enabled { background: #d1ecf1; color: #0c5460; }
+    .badge-displayed { background: #fff3cd; color: #856404; }
+    .detail { margin: 0 0 8px; color: #666; font-size: 13px; }
+    .detail code {
+      padding: 2px 6px;
+      border-radius: 3px;
+      background: #f5f5f5;
+      font-size: 12px;
+    }
+    .locator-list { margin-top: 12px; }
+    .locator {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      margin-bottom: 6px;
+      padding: 8px;
+      border-radius: 4px;
+      background: #f8f9fa;
+    }
+    .strategy {
+      min-width: 120px;
+      color: #007aff;
+      font-size: 12px;
+      font-weight: 600;
+    }
+    .selector {
+      flex: 1;
+      overflow-x: auto;
+      padding: 4px 8px;
+      border-radius: 3px;
+      background: #fff;
+      font: 12px Monaco, Menlo, monospace;
+    }
+    .test-button {
+      padding: 4px 12px;
+      border: 0;
+      border-radius: 4px;
+      background: #007aff;
+      color: #fff;
+      cursor: pointer;
+      font-size: 12px;
+    }
+    .test-button:hover { background: #0056b3; }
+  </style>
+</head>
+<body>
+  <main class="container">
+    <header class="header">
+      <h1>🔍 Generated Locators</h1>
+      <p class="status" id="status">Waiting for locators…</p>
+    </header>
+    <div class="grid" id="locatorGrid"></div>
+  </main>
+  <script>
+    (() => {
+      const locatorGrid = document.getElementById('locatorGrid');
+      const status = document.getElementById('status');
+      let nextRequestId = 1;
+      const pendingRequests = new Map();
+
+      function sendRequest(method, params) {
+        const id = nextRequestId++;
+        window.parent.postMessage({jsonrpc: '2.0', id, method, params}, '*');
+        return new Promise((resolve, reject) => pendingRequests.set(id, {resolve, reject}));
+      }
+
+      function sendNotification(method, params) {
+        window.parent.postMessage({jsonrpc: '2.0', method, params}, '*');
+      }
+
+      function locatorsFromToolResult(result) {
+        const textBlock = result && Array.isArray(result.content)
+          ? result.content.find((item) => item && item.type === 'text' && typeof item.text === 'string')
+          : undefined;
+        if (!textBlock) return undefined;
+
+        try {
+          const parsed = JSON.parse(textBlock.text);
+          return Array.isArray(parsed.interactableElements) ? parsed.interactableElements : undefined;
+        } catch {
+          return undefined;
+        }
+      }
+
+      function appendTextDetail(card, label, value, useCode) {
+        if (typeof value !== 'string' || !value) return;
+        const detail = document.createElement('p');
+        detail.className = 'detail';
+        const labelElement = document.createElement('strong');
+        labelElement.textContent = label + ': ';
+        detail.appendChild(labelElement);
+        const valueElement = document.createElement(useCode ? 'code' : 'span');
+        valueElement.textContent = value;
+        detail.appendChild(valueElement);
+        card.appendChild(detail);
+      }
+
+      function appendBadge(container, label, className) {
+        const badge = document.createElement('span');
+        badge.className = 'badge ' + className;
+        badge.textContent = label;
+        container.appendChild(badge);
+      }
+
+      async function testLocator(strategy, selector, button) {
+        const originalText = button.textContent;
+        button.disabled = true;
+        button.textContent = 'Testing…';
+        try {
+          const result = await sendRequest('tools/call', {
+            name: 'appium_find_element',
+            arguments: {strategy, selector},
+          });
+          button.textContent = result && result.isError ? 'Failed' : 'Found';
+        } catch {
+          button.textContent = 'Failed';
+        }
+        window.setTimeout(() => {
+          button.disabled = false;
+          button.textContent = originalText;
+        }, 1500);
+      }
+
+      function renderLocators(elements) {
+        locatorGrid.textContent = '';
+        status.textContent =
+          'Found ' + elements.length + ' interactable element' + (elements.length === 1 ? '' : 's');
+
+        if (elements.length === 0) {
+          const empty = document.createElement('p');
+          empty.textContent = 'No locators found.';
+          locatorGrid.appendChild(empty);
+          return;
+        }
+
+        elements.forEach((element) => {
+          if (!element || typeof element !== 'object') return;
+          const card = document.createElement('section');
+          card.className = 'card';
+
+          const header = document.createElement('div');
+          header.className = 'card-header';
+          const heading = document.createElement('h2');
+          heading.textContent = typeof element.tagName === 'string' ? element.tagName : 'Element';
+          const badges = document.createElement('div');
+          badges.className = 'badges';
+          if (element.clickable) appendBadge(badges, 'Clickable', 'badge-clickable');
+          if (element.enabled) appendBadge(badges, 'Enabled', 'badge-enabled');
+          if (element.displayed) appendBadge(badges, 'Displayed', 'badge-displayed');
+          header.append(heading, badges);
+          card.appendChild(header);
+
+          appendTextDetail(card, 'Text', element.text, false);
+          appendTextDetail(card, 'Content Desc', element.contentDesc, false);
+          appendTextDetail(card, 'Resource ID', element.resourceId, true);
+
+          const locatorList = document.createElement('div');
+          locatorList.className = 'locator-list';
+          const locators =
+            element.locators && typeof element.locators === 'object' ? Object.entries(element.locators) : [];
+          locators.forEach(([strategy, selector]) => {
+            if (typeof selector !== 'string') return;
+            const locator = document.createElement('div');
+            locator.className = 'locator';
+            const strategyElement = document.createElement('span');
+            strategyElement.className = 'strategy';
+            strategyElement.textContent = strategy;
+            const selectorElement = document.createElement('code');
+            selectorElement.className = 'selector';
+            selectorElement.textContent = selector;
+            const button = document.createElement('button');
+            button.className = 'test-button';
+            button.textContent = 'Test';
+            button.addEventListener('click', () => testLocator(strategy, selector, button));
+            locator.append(strategyElement, selectorElement, button);
+            locatorList.appendChild(locator);
+          });
+          card.appendChild(locatorList);
+          locatorGrid.appendChild(card);
+        });
+      }
+
+      function setToolResult(result) {
+        const elements = locatorsFromToolResult(result);
+        if (!elements) {
+          locatorGrid.textContent = '';
+          status.textContent = result && result.isError
+            ? 'Failed to generate locators.'
+            : 'No locator data was returned.';
+          return;
+        }
+        renderLocators(elements);
+      }
+
+      window.addEventListener('message', (event) => {
+        if (event.source !== window.parent) return;
+        const message = event.data;
+        if (!message || message.jsonrpc !== '2.0') return;
+
+        if (message.id !== undefined && pendingRequests.has(message.id)) {
+          const pending = pendingRequests.get(message.id);
+          pendingRequests.delete(message.id);
+          if (message.error) {
+            pending.reject(new Error(message.error.message || 'MCP App request failed'));
+          } else {
+            pending.resolve(message.result);
+          }
+          return;
+        }
+
+        if (message.method === 'ui/notifications/tool-result') {
+          setToolResult(message.params);
+        }
+      });
+
+      sendRequest('ui/initialize', {
+        protocolVersion: '2026-01-26',
+        appInfo: {name: 'Appium Locator Generator', version: '1.0.0'},
+        appCapabilities: {availableDisplayModes: ['inline', 'fullscreen']},
+      })
+        .then(() => sendNotification('ui/notifications/initialized', {}))
+        .catch(() => {
+          status.textContent = 'Unable to initialize locator generator.';
+        });
+    })();
+  </script>
+</body>
+</html>
+  `;
+}
+//# sourceMappingURL=locator-generator-app.js.map

package/dist/ui/locator-generator-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator-generator-app.js","sourceRoot":"","sources":["../../src/ui/locator-generator-app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgRN,CAAC;AACJ,CAAC"}

package/dist/ui/screenshot-viewer-app.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Static MCP App used by appium_screenshot.
+ *
+ * Saved screenshots are read from structuredContent so the image remains
+ * available to the UI without placing base64-encoded data in model context.
+ * Raw image results are also supported for explicit manual calls.
+ */
+export declare function createScreenshotViewerAppUI(): string;
+//# sourceMappingURL=screenshot-viewer-app.d.ts.map

package/dist/ui/screenshot-viewer-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-viewer-app.d.ts","sourceRoot":"","sources":["../../src/ui/screenshot-viewer-app.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAiRpD"}