mobile-device-mcp 0.1.0

package/dist/ai/analyzer.js

@@ -0,0 +1,451 @@
+// ============================================================
+// ScreenAnalyzer — Orchestrates screenshots, UI trees, and AI
+// calls to provide smart visual analysis of mobile device screens.
+// ============================================================
+import Anthropic from "@anthropic-ai/sdk";
+import { GoogleGenerativeAI } from "@google/generative-ai";
+import { PROMPTS, buildAnalyzeScreenPrompt, buildFindElementPrompt, buildSuggestActionsPrompt, buildVisualDiffPrompt, buildExtractTextPrompt, buildVerifyScreenPrompt, summarizeUIElements, } from "./prompts.js";
+import { searchElementsLocally } from "./element-search.js";
+// ----------------------------------------------------------
+// Two-image analysis helper (used for visual diff)
+// ----------------------------------------------------------
+/**
+ * Sends two screenshots to the AI provider in a single message.
+ * This bypasses AIClient (which only supports one image) to allow
+ * before/after comparison in a single request.
+ *
+ * Supports both Anthropic and Google Gemini providers.
+ */
+async function analyzeWithTwoImages(provider, apiKey, model, maxTokens, systemPrompt, userPrompt, beforeBase64, afterBase64, beforeMimeType = "image/png", afterMimeType = "image/png") {
+    if (provider === "google") {
+        return analyzeWithTwoImagesGemini(apiKey, model, systemPrompt, userPrompt, beforeBase64, afterBase64, beforeMimeType, afterMimeType);
+    }
+    return analyzeWithTwoImagesAnthropic(apiKey, model, maxTokens, systemPrompt, userPrompt, beforeBase64, afterBase64, beforeMimeType, afterMimeType);
+}
+/**
+ * Anthropic implementation: two images in a single message.
+ */
+async function analyzeWithTwoImagesAnthropic(apiKey, model, maxTokens, systemPrompt, userPrompt, beforeBase64, afterBase64, beforeMimeType = "image/png", afterMimeType = "image/png") {
+    const anthropic = new Anthropic({ apiKey });
+    const response = await anthropic.messages.create({
+        model,
+        max_tokens: maxTokens,
+        system: systemPrompt,
+        messages: [
+            {
+                role: "user",
+                content: [
+                    {
+                        type: "image",
+                        source: {
+                            type: "base64",
+                            media_type: beforeMimeType,
+                            data: beforeBase64,
+                        },
+                    },
+                    { type: "text", text: "This is the BEFORE screenshot." },
+                    {
+                        type: "image",
+                        source: {
+                            type: "base64",
+                            media_type: afterMimeType,
+                            data: afterBase64,
+                        },
+                    },
+                    {
+                        type: "text",
+                        text: "This is the AFTER screenshot.\n\n" + userPrompt,
+                    },
+                ],
+            },
+        ],
+    });
+    const block = response.content[0];
+    if (block.type === "text")
+        return block.text;
+    throw new Error("Unexpected response type from Anthropic API.");
+}
+/**
+ * Google Gemini implementation: two images in a single message.
+ */
+async function analyzeWithTwoImagesGemini(apiKey, model, systemPrompt, userPrompt, beforeBase64, afterBase64, beforeMimeType = "image/png", afterMimeType = "image/png") {
+    const genAI = new GoogleGenerativeAI(apiKey);
+    const geminiModel = genAI.getGenerativeModel({ model });
+    const result = await geminiModel.generateContent({
+        systemInstruction: systemPrompt,
+        contents: [
+            {
+                role: "user",
+                parts: [
+                    { inlineData: { mimeType: beforeMimeType, data: beforeBase64 } },
+                    { text: "This is the BEFORE screenshot." },
+                    { inlineData: { mimeType: afterMimeType, data: afterBase64 } },
+                    { text: "This is the AFTER screenshot.\n\n" + userPrompt },
+                ],
+            },
+        ],
+    });
+    return result.response.text();
+}
+/**
+ * Parse a raw string as JSON, handling markdown code fences.
+ */
+function parseJSONResponse(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        // Fall through to extraction.
+    }
+    const fenceMatch = raw.match(/```(?:json)?\s*\n?([\s\S]*?)```/);
+    if (fenceMatch) {
+        try {
+            return JSON.parse(fenceMatch[1].trim());
+        }
+        catch {
+            // Fall through.
+        }
+    }
+    const objectMatch = raw.match(/(\{[\s\S]*\}|\[[\s\S]*\])/);
+    if (objectMatch) {
+        try {
+            return JSON.parse(objectMatch[1]);
+        }
+        catch {
+            // Fall through.
+        }
+    }
+    throw new Error(`Failed to parse AI response as JSON. Raw response:\n${raw.slice(0, 500)}`);
+}
+export class ScreenAnalyzer {
+    client;
+    driver;
+    config;
+    cache = {};
+    cacheTTL = 3000; // 3 seconds
+    /** Screenshot options used for AI analysis (compressed for performance). */
+    screenshotOptions;
+    constructor(client, driver, config, screenshotOptions) {
+        this.client = client;
+        this.driver = driver;
+        this.config = config;
+        // Default: JPEG at quality 80, resize to 720px for AI — saves tokens
+        this.screenshotOptions = screenshotOptions ?? {
+            format: "jpeg",
+            quality: 80,
+            maxWidth: 720,
+        };
+    }
+    // ----------------------------------------------------------
+    // Public API
+    // ----------------------------------------------------------
+    /**
+     * Analyze the current screen state — identifies elements, screen
+     * type, visible text, and actionable suggestions.
+     */
+    async analyzeScreen(deviceId) {
+        try {
+            this.assertClientAvailable();
+            const ctx = await this.captureContext(deviceId);
+            const summarized = ctx.uiElements
+                ? summarizeUIElements(ctx.uiElements)
+                : undefined;
+            const userPrompt = buildAnalyzeScreenPrompt(summarized);
+            return await this.client.analyzeJSON({
+                systemPrompt: PROMPTS.ANALYZE_SCREEN,
+                userPrompt,
+                screenshot: ctx.screenshot?.base64,
+                screenshotMimeType: ctx.screenshot ? `image/${ctx.screenshot.format}` : undefined,
+            });
+        }
+        catch (error) {
+            throw new Error(`analyzeScreen failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Find an element on screen by natural language description.
+     *
+     * Fast path: searches the UI tree locally first. If a high-confidence
+     * match is found (>0.7), returns immediately without calling the AI.
+     * Falls back to AI for ambiguous or complex queries.
+     */
+    async findElement(deviceId, query) {
+        try {
+            // --- Fast path: local UI tree search (no AI call) ---
+            if (this.config.analyzeWithUITree) {
+                const uiElements = await this.getUIElements(deviceId);
+                if (uiElements && uiElements.length > 0) {
+                    const localMatch = searchElementsLocally(uiElements, query);
+                    if (localMatch.found && localMatch.confidence > 0.5) {
+                        return localMatch;
+                    }
+                }
+            }
+            // --- Slow path: AI-powered search ---
+            this.assertClientAvailable();
+            const ctx = await this.captureContext(deviceId);
+            const summarized = ctx.uiElements
+                ? summarizeUIElements(ctx.uiElements)
+                : undefined;
+            const userPrompt = buildFindElementPrompt(query, summarized);
+            return await this.client.analyzeJSON({
+                systemPrompt: PROMPTS.FIND_ELEMENT,
+                userPrompt,
+                screenshot: ctx.screenshot?.base64,
+                screenshotMimeType: ctx.screenshot ? `image/${ctx.screenshot.format}` : undefined,
+            });
+        }
+        catch (error) {
+            throw new Error(`findElement failed for query "${query}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Plan a sequence of actions to achieve a goal on the current screen.
+     */
+    async suggestActions(deviceId, goal) {
+        try {
+            this.assertClientAvailable();
+            const ctx = await this.captureContext(deviceId);
+            const summarized = ctx.uiElements
+                ? summarizeUIElements(ctx.uiElements)
+                : undefined;
+            let currentApp;
+            try {
+                const appInfo = await this.driver.getCurrentApp(deviceId);
+                currentApp = appInfo.packageName;
+            }
+            catch {
+                // getCurrentApp may fail on some devices — proceed without it.
+            }
+            const userPrompt = buildSuggestActionsPrompt(goal, currentApp, summarized);
+            return await this.client.analyzeJSON({
+                systemPrompt: PROMPTS.SUGGEST_ACTIONS,
+                userPrompt,
+                screenshot: ctx.screenshot?.base64,
+                screenshotMimeType: ctx.screenshot ? `image/${ctx.screenshot.format}` : undefined,
+            });
+        }
+        catch (error) {
+            throw new Error(`suggestActions failed for goal "${goal}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Compare the current screen with a previous screenshot and
+     * describe what changed.
+     */
+    async compareScreenshots(deviceId, beforeBase64) {
+        try {
+            this.assertClientAvailable();
+            // Always take a fresh screenshot for the "after" state.
+            const afterScreenshot = await this.driver.takeScreenshot(deviceId, this.screenshotOptions);
+            const userPrompt = buildVisualDiffPrompt();
+            // Before image might be PNG (from take_screenshot tool) or JPEG (from cached).
+            // Detect from base64 header: JPEG starts with /9j/, PNG starts with iVBOR.
+            const beforeMimeType = beforeBase64.startsWith("/9j/") ? "image/jpeg" : "image/png";
+            const afterMimeType = `image/${afterScreenshot.format}`;
+            const raw = await analyzeWithTwoImages(this.config.provider, this.config.apiKey, this.config.model, this.config.maxTokens, PROMPTS.VISUAL_DIFF, userPrompt, beforeBase64, afterScreenshot.base64, beforeMimeType, afterMimeType);
+            return parseJSONResponse(raw);
+        }
+        catch (error) {
+            throw new Error(`compareScreenshots failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Extract all readable text from the current screen.
+     */
+    async extractText(deviceId) {
+        try {
+            this.assertClientAvailable();
+            // Always need a screenshot for OCR — ignore UITree config.
+            const screenshot = await this.driver.takeScreenshot(deviceId, this.screenshotOptions);
+            const userPrompt = buildExtractTextPrompt();
+            const result = await this.client.analyzeJSON({
+                systemPrompt: PROMPTS.EXTRACT_TEXT,
+                userPrompt,
+                screenshot: screenshot.base64,
+                screenshotMimeType: `image/${screenshot.format}`,
+            });
+            return result.texts;
+        }
+        catch (error) {
+            throw new Error(`extractText failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Verify an assertion about the current screen state.
+     */
+    async verifyScreen(deviceId, assertion) {
+        try {
+            this.assertClientAvailable();
+            const ctx = await this.captureContext(deviceId);
+            const summarized = ctx.uiElements
+                ? summarizeUIElements(ctx.uiElements)
+                : undefined;
+            const userPrompt = buildVerifyScreenPrompt(assertion, summarized);
+            return await this.client.analyzeJSON({
+                systemPrompt: PROMPTS.VERIFY_SCREEN,
+                userPrompt,
+                screenshot: ctx.screenshot?.base64,
+                screenshotMimeType: ctx.screenshot ? `image/${ctx.screenshot.format}` : undefined,
+            });
+        }
+        catch (error) {
+            throw new Error(`verifyScreen failed for assertion "${assertion}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Smart tap: find an element by natural language description and
+     * tap its center.
+     */
+    async smartTap(deviceId, elementDescription) {
+        try {
+            const match = await this.findElement(deviceId, elementDescription);
+            if (match.found && match.element && match.confidence > 0.5) {
+                await this.driver.tap(deviceId, match.element.bounds.centerX, match.element.bounds.centerY);
+                this.invalidateCache();
+                return {
+                    success: true,
+                    tapped: match.element,
+                    message: `Tapped: ${match.element.description}`,
+                };
+            }
+            return {
+                success: false,
+                tapped: null,
+                message: `Could not find element: ${elementDescription}`,
+            };
+        }
+        catch (error) {
+            throw new Error(`smartTap failed for "${elementDescription}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Smart type: find an input field by description, tap to focus it,
+     * then type the provided text.
+     */
+    async smartType(deviceId, fieldDescription, text) {
+        try {
+            const match = await this.findElement(deviceId, fieldDescription);
+            if (match.found && match.element && match.confidence > 0.5) {
+                // Tap to focus the field first.
+                await this.driver.tap(deviceId, match.element.bounds.centerX, match.element.bounds.centerY);
+                // Brief delay for focus to settle.
+                await this.delay(300);
+                // Type the text.
+                await this.driver.typeText(deviceId, text);
+                this.invalidateCache();
+                return {
+                    success: true,
+                    field: match.element,
+                    message: `Typed into: ${match.element.description}`,
+                };
+            }
+            return {
+                success: false,
+                field: null,
+                message: `Could not find field: ${fieldDescription}`,
+            };
+        }
+        catch (error) {
+            throw new Error(`smartType failed for field "${fieldDescription}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // ----------------------------------------------------------
+    // Internal helpers
+    // ----------------------------------------------------------
+    /**
+     * Fetch UI elements for the device, using the cache when valid.
+     * This is a lightweight call (no screenshot) used by the local
+     * element search fast path.
+     */
+    async getUIElements(deviceId) {
+        if (this.cache.uiElements &&
+            this.isCacheValid(this.cache.uiElements.timestamp)) {
+            return this.cache.uiElements.data;
+        }
+        try {
+            const elements = await this.driver.getUIElements(deviceId, {
+                interactiveOnly: false,
+            });
+            this.cache.uiElements = { data: elements, timestamp: Date.now() };
+            return elements;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Capture screenshot and/or UI elements based on config flags.
+     * Uses caching with TTL and parallel capture for performance.
+     */
+    async captureContext(deviceId) {
+        const ctx = {};
+        const now = Date.now();
+        // Check cache for valid screenshot
+        const cachedScreenshot = this.config.analyzeWithScreenshot &&
+            this.cache.screenshot &&
+            this.isCacheValid(this.cache.screenshot.timestamp)
+            ? this.cache.screenshot.data
+            : undefined;
+        // Check cache for valid UI elements
+        const cachedUIElements = this.config.analyzeWithUITree &&
+            this.cache.uiElements &&
+            this.isCacheValid(this.cache.uiElements.timestamp)
+            ? this.cache.uiElements.data
+            : undefined;
+        if (cachedScreenshot) {
+            ctx.screenshot = cachedScreenshot;
+        }
+        if (cachedUIElements) {
+            ctx.uiElements = cachedUIElements;
+        }
+        // Capture missing data in parallel
+        const promises = [];
+        if (this.config.analyzeWithScreenshot && !cachedScreenshot) {
+            promises.push(this.driver.takeScreenshot(deviceId, this.screenshotOptions).then((s) => {
+                ctx.screenshot = s;
+                this.cache.screenshot = { data: s, timestamp: now };
+            }));
+        }
+        if (this.config.analyzeWithUITree && !cachedUIElements) {
+            promises.push(this.driver
+                .getUIElements(deviceId, { interactiveOnly: false })
+                .then((e) => {
+                ctx.uiElements = e;
+                this.cache.uiElements = { data: e, timestamp: now };
+            }));
+        }
+        await Promise.all(promises);
+        return ctx;
+    }
+    /**
+     * Check if a cached entry is still valid based on TTL.
+     */
+    isCacheValid(timestamp) {
+        return Date.now() - timestamp < this.cacheTTL;
+    }
+    /**
+     * Invalidate the cache — call after actions that change the screen.
+     * Only clears the screenshot. UI element positions (button layout)
+     * rarely change after a tap, so keep the UI tree cache to avoid
+     * expensive uiautomator dump calls on every interaction.
+     */
+    invalidateCache() {
+        this.cache.screenshot = undefined;
+    }
+    /**
+     * Throw if the AI client is not available (no API key configured).
+     */
+    assertClientAvailable() {
+        if (!this.client.isAvailable()) {
+            throw new Error("AI client is not available. Set ANTHROPIC_API_KEY to enable AI features.");
+        }
+    }
+    /**
+     * Promise-based delay helper.
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/ai/analyzer.js.map

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

package/dist/ai/client.d.ts

@@ -0,0 +1,92 @@
+import type { AIConfig } from "../types.js";
+/**
+ * Options accepted by {@link AIClient.analyze} and {@link AIClient.analyzeJSON}.
+ */
+export interface AnalyzeOptions {
+    systemPrompt: string;
+    userPrompt: string;
+    /** Base-64 encoded screenshot (PNG by default). */
+    screenshot?: string;
+    /** MIME type for the screenshot. Defaults to `"image/png"`. */
+    screenshotMimeType?: string;
+    /** Override the default max tokens for this request. */
+    maxTokens?: number;
+}
+/**
+ * Wraps both the Anthropic and Google Generative AI SDKs for all
+ * AI visual-analysis features.
+ *
+ * Create one instance and reuse it — the underlying HTTP client is
+ * allocated once in the constructor.
+ */
+export declare class AIClient {
+    private readonly anthropicClient?;
+    private readonly geminiModel?;
+    private readonly config;
+    constructor(config: AIConfig);
+    /**
+     * Returns `true` when a non-empty API key has been configured,
+     * meaning AI features can be used.
+     */
+    isAvailable(): boolean;
+    /**
+     * Send a prompt (with an optional screenshot) to the configured
+     * AI provider and return the plain-text response.
+     */
+    analyze(options: AnalyzeOptions): Promise<string>;
+    /**
+     * Convenience wrapper: call {@link analyze}, then parse the response
+     * as JSON.  Handles responses wrapped in markdown code fences.
+     */
+    analyzeJSON<T>(options: AnalyzeOptions): Promise<T>;
+    private analyzeWithAnthropic;
+    /**
+     * Build the `content` array for the Anthropic user message.
+     */
+    private buildAnthropicContent;
+    /**
+     * Call `messages.create` with a single manual retry for 429 / 529.
+     */
+    private createWithRetryAnthropic;
+    /**
+     * Determine whether an Anthropic error is a retryable 429 or 529.
+     */
+    private isRetryableAnthropic;
+    /**
+     * Extract the text content from the first Anthropic content block.
+     */
+    private extractAnthropicText;
+    private analyzeWithGemini;
+    /**
+     * Call Gemini generateContent with retries for 429 / 503 errors.
+     * Parses the RetryInfo delay from Google API error messages.
+     */
+    private createWithRetryGemini;
+    /**
+     * Determine whether a Google API error is retryable (429 / 503).
+     */
+    private isRetryableGemini;
+    /**
+     * Extract the retry delay (in ms) from a Google API error message.
+     * Looks for patterns like 'retryDelay":"23s"' or 'Please retry in 23.2s'.
+     */
+    private extractRetryDelay;
+    /**
+     * Throw immediately when the API key is absent so callers get a
+     * clear message instead of an opaque 401.
+     */
+    private assertAvailable;
+    /**
+     * Parse a string as JSON, stripping markdown code fences if present.
+     */
+    private parseJSON;
+    /**
+     * Wrap unknown errors into Error instances with descriptive messages.
+     */
+    private wrapError;
+    /**
+     * Promise-based delay helper.
+     */
+    private delay;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/ai/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ai/client.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD;;;;;;GAMG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAkB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAEtB,MAAM,EAAE,QAAQ;IAoB5B;;;OAGG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IASvD;;;OAGG;IACG,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;YAS3C,oBAAoB;IAsBlC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;YACW,wBAAwB;IAetC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;YAmBd,iBAAiB;IAqB/B;;;OAGG;YACW,qBAAqB;IA6BnC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiCjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAYjB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}