android-dev-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 android-dev-mcp Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# android-dev-mcp
+
+[![npm version](https://img.shields.io/npm/v/android-dev-mcp.svg)](https://www.npmjs.com/package/android-dev-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+MCP server that exposes **Android Debug Bridge (ADB)** as tools. Runs locally. Use with Cursor, Claude Desktop, or any MCP client.
+
+**Requirements:** Node.js ≥18, [ADB](https://developer.android.com/tools/adb) on `PATH`.
+
+---
+
+## Run
+
+### Option 1 — curl (new folder, download, run)
+
+Create a new folder, open a terminal in it, then:
+
+```bash
+curl -sSL -o start.sh https://raw.githubusercontent.com/ferhatozcelik/adb-mcp/main/start.sh
+chmod +x start.sh
+./start.sh
+```
+
+The server starts with detailed logs in the terminal. Connect your MCP client to **http://localhost:3000/mcp**.
+
+---
+
+### Option 2 — git clone
+
+```bash
+git clone https://github.com/ferhatozcelik/adb-mcp.git
+cd adb-mcp
+./start.sh
+```
+
+(stdio: `./start.sh --stdio`)
+
+---
+
+## Connect your MCP client
+
+**Cursor** — `.cursor/mcp.json` or MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "android-dev-mcp": {
+      "url": "http://localhost:3000/mcp"
+    }
+  }
+}
+```
+
+**Claude Desktop** — `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "android-dev-mcp": {
+      "url": "http://localhost:3000/mcp"
+    }
+  }
+}
+```
+
+Port: `PORT=4000 ./start.sh`.
+
+**Extra commands:**
+- `./start.sh help` — show usage and options
+- `./start.sh check` — check Node, npm/npx, ADB, and connected devices
+
+---
+
+## stdio mode (optional)
+
+From repo: `./start.sh --stdio`. Or with npx: `npx android-dev-mcp`.
+
+MCP config: `"command": "npx", "args": ["android-dev-mcp"]`.
+
+---
+
+## Features
+
+- List devices, run allowlisted ADB commands, launch app, tap, swipe, input text, screencap, current activity. Security: allowlist + timeout.
+
+---
+
+## Links
+
+[npm](https://www.npmjs.com/package/android-dev-mcp) · [LICENSE](LICENSE) · [CONTRIBUTING](CONTRIBUTING.md) · [CHANGELOG](CHANGELOG.md)

package/dist/adb/accessibility.d.ts

@@ -0,0 +1,10 @@
+/** Parse uiautomator dump XML: find node by text/content-desc, return bounds center. */
+export declare function findNodeCenterByText(xml: string, searchText: string): {
+    x: number;
+    y: number;
+} | null;
+/** Get progress value from UI dump: progress="N" or text like "100" / "100%". Returns max found or null. */
+export declare function getProgressFromXml(xml: string): number | null;
+/** Check if UI dump contains a node with given text (case-insensitive). */
+export declare function isTextVisibleInXml(xml: string, searchText: string): boolean;
+//# sourceMappingURL=accessibility.d.ts.map

package/dist/adb/accessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/adb/accessibility.ts"],"names":[],"mappings":"AAAA,wFAAwF;AAExF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqBrG;AAED,4GAA4G;AAC5G,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiB7D;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE3E"}

package/dist/adb/accessibility.js

@@ -0,0 +1,52 @@
+/** Parse uiautomator dump XML: find node by text/content-desc, return bounds center. */
+export function findNodeCenterByText(xml, searchText) {
+    const normalized = searchText.trim().toLowerCase();
+    if (!normalized)
+        return null;
+    const nodeRe = /<node[^>]+>/g;
+    let m;
+    while ((m = nodeRe.exec(xml)) !== null) {
+        const node = m[0];
+        const text = (/text="([^"]*)"/.exec(node)?.[1] ?? /content-desc="([^"]*)"/.exec(node)?.[1] ?? '').toLowerCase();
+        if (!text.includes(normalized))
+            continue;
+        const bounds = /bounds="\[(\d+),(\d+)\]\[(\d+),(\d+)\]"/.exec(node);
+        if (!bounds)
+            continue;
+        const left = Number(bounds[1]);
+        const top = Number(bounds[2]);
+        const right = Number(bounds[3]);
+        const bottom = Number(bounds[4]);
+        return {
+            x: Math.round((left + right) / 2),
+            y: Math.round((top + bottom) / 2),
+        };
+    }
+    return null;
+}
+/** Get progress value from UI dump: progress="N" or text like "100" / "100%". Returns max found or null. */
+export function getProgressFromXml(xml) {
+    let maxProgress = null;
+    const progressAttr = /progress="(\d+)"/g;
+    let m;
+    while ((m = progressAttr.exec(xml)) !== null) {
+        const n = parseInt(m[1], 10);
+        if (maxProgress == null || n > maxProgress)
+            maxProgress = n;
+    }
+    const textProgress = /(?:text|content-desc)="([^"]*(\d+)(?:%)?[^"]*)"/g;
+    while ((m = textProgress.exec(xml)) !== null) {
+        const numMatch = m[2];
+        if (numMatch) {
+            const n = parseInt(numMatch, 10);
+            if (n >= 0 && n <= 100 && (maxProgress == null || n > maxProgress))
+                maxProgress = n;
+        }
+    }
+    return maxProgress;
+}
+/** Check if UI dump contains a node with given text (case-insensitive). */
+export function isTextVisibleInXml(xml, searchText) {
+    return findNodeCenterByText(xml, searchText) !== null;
+}
+//# sourceMappingURL=accessibility.js.map

package/dist/adb/accessibility.js.map

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

package/dist/adb/index.d.ts

@@ -0,0 +1,4 @@
+export { listDevices, runAdb, shell, shellBuffer, adbConnect, adbDisconnect, adbKillServer, adbStartServer, adbPush, adbPull, adbInstall, adbUninstall, adbLogcat, adbBackup, adbRestore, adbReboot, adbGetState, adbGetSerialNo, } from './runner.js';
+export { listDevices as adbListDevices, execShell, launchApp, tap, swipe, inputText, screencap, screencapAnalyze, currentActivity, keyevent, screenrecord, homeButton, logcatErrors, logcatCrashes, logcatAnalyze, uiDump, findAndTap, } from './operations.js';
+export { parseScenarioMarkdown, runScenario, type StepKind, type RunScenarioResult, type RunStepResult } from './liveTest.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,MAAM,EACN,KAAK,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,OAAO,EACP,OAAO,EACP,UAAU,EACV,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,IAAI,cAAc,EAC7B,SAAS,EACT,SAAS,EACT,GAAG,EACH,KAAK,EACL,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,MAAM,EACN,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/adb/index.js

@@ -0,0 +1,4 @@
+export { listDevices, runAdb, shell, shellBuffer, adbConnect, adbDisconnect, adbKillServer, adbStartServer, adbPush, adbPull, adbInstall, adbUninstall, adbLogcat, adbBackup, adbRestore, adbReboot, adbGetState, adbGetSerialNo, } from './runner.js';
+export { listDevices as adbListDevices, execShell, launchApp, tap, swipe, inputText, screencap, screencapAnalyze, currentActivity, keyevent, screenrecord, homeButton, logcatErrors, logcatCrashes, logcatAnalyze, uiDump, findAndTap, } from './operations.js';
+export { parseScenarioMarkdown, runScenario } from './liveTest.js';
+//# sourceMappingURL=index.js.map

package/dist/adb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,MAAM,EACN,KAAK,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,OAAO,EACP,OAAO,EACP,UAAU,EACV,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,IAAI,cAAc,EAC7B,SAAS,EACT,SAAS,EACT,GAAG,EACH,KAAK,EACL,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,MAAM,EACN,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAA6D,MAAM,eAAe,CAAC"}

package/dist/adb/liveTest.d.ts

@@ -0,0 +1,39 @@
+import type { AdbOptions } from '../types.js';
+export type StepKind = {
+    type: 'wait_seconds';
+    seconds: number;
+} | {
+    type: 'tap';
+    text: string;
+} | {
+    type: 'wait_progress';
+    value: number;
+    timeoutMs?: number;
+} | {
+    type: 'wait_visible';
+    text: string;
+    timeoutMs?: number;
+};
+/** Parse a single step line (after stripping list marker). Returns null if not recognized. */
+export declare function parseStepLine(line: string): StepKind | null;
+/** Extract step lines from markdown: lines that start with - or * (skip # headers). */
+export declare function parseScenarioMarkdown(md: string): StepKind[];
+export interface RunStepResult {
+    stepIndex: number;
+    step: StepKind;
+    ok: boolean;
+    message: string;
+    durationMs?: number;
+}
+export interface RunScenarioResult {
+    ok: boolean;
+    steps: RunStepResult[];
+    totalDurationMs: number;
+    log: string;
+}
+export declare function runScenario(markdown: string, options?: AdbOptions & {
+    pollMs?: number;
+    waitProgressTimeoutMs?: number;
+    waitVisibleTimeoutMs?: number;
+}): Promise<RunScenarioResult>;
+//# sourceMappingURL=liveTest.d.ts.map

package/dist/adb/liveTest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveTest.d.ts","sourceRoot":"","sources":["../../src/adb/liveTest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAsC3D;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,EAAE,CAY5D;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;CACb;AAMD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,UAAU,GAAG;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC1B,GACL,OAAO,CAAC,iBAAiB,CAAC,CAoF5B"}

package/dist/adb/liveTest.js

@@ -0,0 +1,148 @@
+import { uiDump, findAndTap } from './operations.js';
+import { getProgressFromXml, isTextVisibleInXml } from './accessibility.js';
+const DEFAULT_POLL_MS = 800;
+const DEFAULT_WAIT_PROGRESS_TIMEOUT_MS = 60_000;
+const DEFAULT_WAIT_VISIBLE_TIMEOUT_MS = 30_000;
+/** Parse a single step line (after stripping list marker). Returns null if not recognized. */
+export function parseStepLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    const waitSecRe = /(?:(\d+)\s*(?:saniye|sn|sec|seconds?)\s*bekle|wait\s+(\d+)\s*seconds?)/i;
+    const secMatch = trimmed.match(waitSecRe);
+    if (secMatch) {
+        const n = parseInt(secMatch[1] ?? secMatch[2], 10);
+        if (n >= 0 && n <= 300)
+            return { type: 'wait_seconds', seconds: n };
+    }
+    const progressRe = /(?:progress\s*(?:bar)?\s*(\d+)\s*olana\s+kadar\s+bekle|wait\s+until\s+progress\s+(\d+))/i;
+    const progressMatch = trimmed.match(progressRe);
+    if (progressMatch) {
+        const n = parseInt(progressMatch[1] ?? progressMatch[2], 10);
+        if (n >= 0 && n <= 100)
+            return { type: 'wait_progress', value: n };
+    }
+    const visibleRe = /(?:["']([^"']+)["']\s*görünene\s+kadar\s+bekle|(.+?)\s+görünene\s+kadar\s+bekle|wait\s+until\s+visible\s+["']?([^"'\s]+)["']?)/i;
+    const visibleMatch = trimmed.match(visibleRe);
+    if (visibleMatch) {
+        const text = (visibleMatch[1] ?? visibleMatch[2] ?? visibleMatch[3] ?? '').trim();
+        if (text)
+            return { type: 'wait_visible', text };
+    }
+    const tapRe = /(?:["']([^"']+)["']\s*tıkla|tıkla\s+["']?([^"'\s]+)|tap\s+["']?([^"'\s]+)["']?|([A-Za-z0-9\s]+)\s+buton(?:una)?\s+tıkla|(.+?)\s+tıkla\s*$)/i;
+    const tapMatch = trimmed.match(tapRe);
+    if (tapMatch) {
+        const text = (tapMatch[1] ?? tapMatch[2] ?? tapMatch[3] ?? tapMatch[4] ?? tapMatch[5] ?? '').trim();
+        if (text)
+            return { type: 'tap', text };
+    }
+    if (trimmed.toLowerCase().startsWith('tap ')) {
+        const rest = trimmed.slice(4).replace(/^["']|["']$/g, '').trim();
+        if (rest)
+            return { type: 'tap', text: rest };
+    }
+    return null;
+}
+/** Extract step lines from markdown: lines that start with - or * (skip # headers). */
+export function parseScenarioMarkdown(md) {
+    const steps = [];
+    const lines = md.split(/\r?\n/);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const content = trimmed.replace(/^\s*[-*]\s*/, '').trim();
+        if (!content)
+            continue;
+        const step = parseStepLine(content);
+        if (step)
+            steps.push(step);
+    }
+    return steps;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function runScenario(markdown, options = {}) {
+    const steps = parseScenarioMarkdown(markdown);
+    const { pollMs = DEFAULT_POLL_MS, waitProgressTimeoutMs = DEFAULT_WAIT_PROGRESS_TIMEOUT_MS, waitVisibleTimeoutMs = DEFAULT_WAIT_VISIBLE_TIMEOUT_MS, ...adbOpts } = options;
+    const results = [];
+    const logLines = [];
+    const startTime = Date.now();
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        const stepStart = Date.now();
+        let ok = false;
+        let message = '';
+        try {
+            if (step.type === 'wait_seconds') {
+                await sleep(step.seconds * 1000);
+                ok = true;
+                message = `Waited ${step.seconds}s`;
+            }
+            else if (step.type === 'tap') {
+                const result = await findAndTap(step.text, adbOpts);
+                ok = result.tapped;
+                message = result.tapped
+                    ? `Tapped "${step.text}" at (${result.x}, ${result.y})`
+                    : (result.error ?? `Tap failed: ${step.text}`);
+            }
+            else if (step.type === 'wait_progress') {
+                const deadline = Date.now() + (step.timeoutMs ?? waitProgressTimeoutMs);
+                while (Date.now() < deadline) {
+                    const xml = await uiDump(adbOpts);
+                    const progress = getProgressFromXml(xml);
+                    if (progress != null && progress >= step.value) {
+                        ok = true;
+                        message = `Progress reached ${progress} (>= ${step.value})`;
+                        break;
+                    }
+                    await sleep(pollMs);
+                }
+                if (!ok)
+                    message = `Timeout: progress did not reach ${step.value}`;
+            }
+            else if (step.type === 'wait_visible') {
+                const deadline = Date.now() + (step.timeoutMs ?? waitVisibleTimeoutMs);
+                while (Date.now() < deadline) {
+                    const xml = await uiDump(adbOpts);
+                    if (isTextVisibleInXml(xml, step.text)) {
+                        ok = true;
+                        message = `"${step.text}" is visible`;
+                        break;
+                    }
+                    await sleep(pollMs);
+                }
+                if (!ok)
+                    message = `Timeout: "${step.text}" did not appear`;
+            }
+            const durationMs = Date.now() - stepStart;
+            results.push({ stepIndex: i, step, ok, message, durationMs });
+            logLines.push(`[${i + 1}] ${step.type}: ${message} (${durationMs}ms)`);
+            if (!ok)
+                break;
+        }
+        catch (e) {
+            const err = e instanceof Error ? e.message : String(e);
+            message = `Error: ${err}`;
+            results.push({
+                stepIndex: i,
+                step,
+                ok: false,
+                message,
+                durationMs: Date.now() - stepStart,
+            });
+            logLines.push(`[${i + 1}] ${step.type}: ${message}`);
+            break;
+        }
+    }
+    const totalDurationMs = Date.now() - startTime;
+    const ok = results.length > 0 && results.every((r) => r.ok);
+    return {
+        ok,
+        steps: results,
+        totalDurationMs,
+        log: logLines.join('\n'),
+    };
+}
+//# sourceMappingURL=liveTest.js.map

package/dist/adb/liveTest.js.map

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

package/dist/adb/logcatAnalysis.d.ts

@@ -0,0 +1,17 @@
+export type LogLevel = 'E' | 'F' | 'EF';
+export declare function isCrashLine(line: string): boolean;
+export declare function extractCrashSnippet(logcat: string, maxLines?: number): string;
+export declare function countErrorLevels(logcat: string): {
+    error: number;
+    fatal: number;
+};
+export declare function getErrorLines(logcat: string, maxLines?: number): string[];
+export declare function analyzeLogcat(logcat: string): {
+    hasCrash: boolean;
+    fatalCount: number;
+    errorCount: number;
+    crashSnippet: string;
+    summary: string;
+    errorLines: string[];
+};
+//# sourceMappingURL=logcatAnalysis.d.ts.map

package/dist/adb/logcatAnalysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logcatAnalysis.d.ts","sourceRoot":"","sources":["../../src/adb/logcatAnalysis.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AAgBxC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,CAuBzE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAUjF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,EAAE,CAMtE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAwBA"}

package/dist/adb/logcatAnalysis.js

@@ -0,0 +1,85 @@
+const CRASH_PATTERNS = [
+    /FATAL EXCEPTION/i,
+    /AndroidRuntime:\s*FATAL/i,
+    /Process:\s*\d+,\s*PID:\s*\d+/,
+    /java\.lang\.RuntimeException/i,
+    /java\.lang\.NullPointerException/i,
+    /Caused by:/i,
+    /^\s*at\s+[\w.$]+\s*\(/m,
+    /^\*\*\*\s*\*\*\*\s*\*\*\*/m,
+    /Fatal signal \d+/i,
+    /backtrace:/i,
+    /Build fingerprint:/i,
+];
+export function isCrashLine(line) {
+    return CRASH_PATTERNS.some((p) => p.test(line));
+}
+export function extractCrashSnippet(logcat, maxLines = 80) {
+    const lines = logcat.split('\n');
+    let start = -1;
+    let end = lines.length;
+    for (let i = 0; i < lines.length; i++) {
+        if (/FATAL EXCEPTION|AndroidRuntime:\s*FATAL|Fatal signal/i.test(lines[i])) {
+            start = i;
+            break;
+        }
+    }
+    if (start < 0) {
+        for (let i = 0; i < lines.length; i++) {
+            if (isCrashLine(lines[i])) {
+                start = Math.max(0, i - 2);
+                break;
+            }
+        }
+    }
+    if (start < 0)
+        return '';
+    end = Math.min(start + maxLines, lines.length);
+    return lines.slice(start, end).join('\n').trim();
+}
+export function countErrorLevels(logcat) {
+    const lines = logcat.split('\n');
+    let error = 0;
+    let fatal = 0;
+    for (const line of lines) {
+        const t = line.trim();
+        if (/^F\s|^F\/|FATAL\s|F\/\w+/.test(t))
+            fatal++;
+        else if (/^E\s|^E\/|ERROR\s|E\/\w+/.test(t))
+            error++;
+    }
+    return { error, fatal };
+}
+export function getErrorLines(logcat, maxLines = 200) {
+    const lines = logcat.split('\n').filter((l) => {
+        const t = l.trim();
+        return /^[EF]\s|^[EF]\//.test(t) || /FATAL|AndroidRuntime.*FATAL/i.test(t);
+    });
+    return lines.slice(-maxLines);
+}
+export function analyzeLogcat(logcat) {
+    const { error, fatal } = countErrorLevels(logcat);
+    const crashSnippet = extractCrashSnippet(logcat);
+    const hasCrash = crashSnippet.length > 0;
+    const errorLines = getErrorLines(logcat, 200);
+    let summary = '';
+    if (hasCrash) {
+        const firstLine = crashSnippet.split('\n')[0] ?? '';
+        summary = `Crash detected: ${firstLine.slice(0, 120)}`;
+    }
+    else if (fatal > 0 || error > 0) {
+        summary = `Errors: ${error} E, ${fatal} F. No FATAL EXCEPTION block found.`;
+    }
+    else {
+        summary = 'No errors or crashes in recent log.';
+    }
+    return {
+        hasCrash,
+        fatalCount: fatal,
+        errorCount: error,
+        crashSnippet,
+        summary,
+        errorLines,
+    };
+}
+//# sourceMappingURL=logcatAnalysis.js.map

package/dist/adb/logcatAnalysis.js.map

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

package/dist/adb/ocr.d.ts

@@ -0,0 +1,6 @@
+export interface OcrResult {
+    text: string;
+    confidence?: number;
+}
+export declare function extractTextFromImage(buffer: Buffer): Promise<OcrResult>;
+//# sourceMappingURL=ocr.d.ts.map

package/dist/adb/ocr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr.d.ts","sourceRoot":"","sources":["../../src/adb/ocr.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAa7E"}

package/dist/adb/ocr.js

@@ -0,0 +1,16 @@
+export async function extractTextFromImage(buffer) {
+    try {
+        const Tesseract = await import('tesseract.js');
+        const { data } = await Tesseract.default.recognize(buffer, 'eng', {
+            logger: () => { },
+        });
+        return {
+            text: (data?.text ?? '').trim(),
+            confidence: data?.confidence,
+        };
+    }
+    catch {
+        return { text: '' };
+    }
+}
+//# sourceMappingURL=ocr.js.map

package/dist/adb/ocr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr.js","sourceRoot":"","sources":["../../src/adb/ocr.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAc;IACvD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE;YAChE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;SACjB,CAAC,CAAC;QACH,OAAO;YACL,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAC/B,UAAU,EAAE,IAAI,EAAE,UAAU;SAC7B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/adb/operations.d.ts

@@ -0,0 +1,48 @@
+import { listDevices } from './runner.js';
+import { type LogLevel } from './logcatAnalysis.js';
+import type { AdbOptions } from '../types.js';
+export { listDevices };
+export declare function execShell(command: string, options?: AdbOptions): Promise<string>;
+export declare function launchApp(packageName: string, activity?: string, options?: AdbOptions): Promise<string>;
+export declare function tap(x: number, y: number, options?: AdbOptions): Promise<string>;
+export declare function swipe(x1: number, y1: number, x2: number, y2: number, durationMs?: number, options?: AdbOptions): Promise<string>;
+export declare function inputText(text: string, options?: AdbOptions): Promise<string>;
+export declare function screencap(options?: AdbOptions): Promise<string>;
+/** Screenshot + optional OCR. */
+export declare function screencapAnalyze(options?: AdbOptions & {
+    extractText?: boolean;
+}): Promise<{
+    imageBase64: string;
+    extractedText: string;
+    confidence?: number;
+}>;
+export declare function currentActivity(options?: AdbOptions): Promise<string>;
+export declare function keyevent(keycode: number, options?: AdbOptions): Promise<string>;
+export declare function screenrecord(path: string, durationSec?: number, options?: AdbOptions): Promise<string>;
+export declare function homeButton(options?: AdbOptions): Promise<string>;
+export declare function logcatErrors(level?: LogLevel, maxLines?: number, options?: AdbOptions): Promise<{
+    output: string;
+    lines: string[];
+}>;
+export declare function logcatCrashes(options?: AdbOptions): Promise<{
+    output: string;
+    hasCrash: boolean;
+    crashSnippet: string;
+    summary: string;
+}>;
+export declare function logcatAnalyze(options?: AdbOptions): Promise<{
+    errorCount: number;
+    fatalCount: number;
+    hasCrash: boolean;
+    crashSnippet: string;
+    summary: string;
+    errorLines: string[];
+}>;
+export declare function uiDump(options?: AdbOptions): Promise<string>;
+export declare function findAndTap(text: string, options?: AdbOptions): Promise<{
+    tapped: boolean;
+    x?: number;
+    y?: number;
+    error?: string;
+}>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/adb/operations.d.ts.map

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