deepadb 1.0.0

package/build/tools/network-discovery.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ADB-over-Network Device Discovery — Scan for ADB devices on the local network.
+ *
+ * Discovers Android devices with ADB enabled over WiFi/TCP by scanning
+ * common ADB ports on the local subnet. Replaces manual IP entry for
+ * wireless debugging workflows.
+ *
+ * Discovery methods:
+ *   1. ARP table scan — check known hosts for open ADB ports
+ *   2. Subnet sweep — probe a configurable IP range for ADB responses
+ *   3. Connected device IP extraction — get IPs of already-connected WiFi devices
+ *
+ * Does NOT require root. Uses standard TCP connection attempts to detect
+ * ADB listeners on ports 5555 (default), 5554, and custom ports.
+ *
+ * Security: Only scans local network subnets. Connection attempts use
+ * short timeouts (2s) to avoid hanging on unresponsive hosts.
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerNetworkDiscoveryTools(ctx: ToolContext): void;
+//# sourceMappingURL=network-discovery.d.ts.map

package/build/tools/network-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-discovery.d.ts","sourceRoot":"","sources":["../../src/tools/network-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAqDjD,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA4QpE"}

package/build/tools/network-discovery.js

@@ -0,0 +1,284 @@
+/**
+ * ADB-over-Network Device Discovery — Scan for ADB devices on the local network.
+ *
+ * Discovers Android devices with ADB enabled over WiFi/TCP by scanning
+ * common ADB ports on the local subnet. Replaces manual IP entry for
+ * wireless debugging workflows.
+ *
+ * Discovery methods:
+ *   1. ARP table scan — check known hosts for open ADB ports
+ *   2. Subnet sweep — probe a configurable IP range for ADB responses
+ *   3. Connected device IP extraction — get IPs of already-connected WiFi devices
+ *
+ * Does NOT require root. Uses standard TCP connection attempts to detect
+ * ADB listeners on ports 5555 (default), 5554, and custom ports.
+ *
+ * Security: Only scans local network subnets. Connection attempts use
+ * short timeouts (2s) to avoid hanging on unresponsive hosts.
+ */
+import { z } from "zod";
+import { createConnection } from "net";
+import { OutputProcessor } from "../middleware/output-processor.js";
+/** Default ADB TCP ports to probe. */
+const ADB_PORTS = [5555, 5554, 5556, 5557, 5558];
+/** Check if a TCP port is open on a given host. */
+function probePort(host, port, timeoutMs) {
+    return new Promise((resolve) => {
+        const socket = createConnection({ host, port, timeout: timeoutMs });
+        let resolved = false;
+        const done = (result) => {
+            if (!resolved) {
+                resolved = true;
+                socket.destroy();
+                resolve(result);
+            }
+        };
+        socket.on("connect", () => done(true));
+        socket.on("timeout", () => done(false));
+        socket.on("error", () => done(false));
+        // Safety timeout in case none of the events fire
+        setTimeout(() => done(false), timeoutMs + 500);
+    });
+}
+/** Parse an IP range string like "192.168.1.1-254" into individual IPs. */
+function expandIpRange(range) {
+    const match = range.match(/^(\d+\.\d+\.\d+\.)(\d+)-(\d+)$/);
+    if (!match)
+        return [range]; // Not a range, treat as single IP
+    const prefix = match[1];
+    const start = parseInt(match[2], 10);
+    const end = parseInt(match[3], 10);
+    if (start > end || start < 0 || end > 255)
+        return [];
+    const ips = [];
+    for (let i = start; i <= end; i++) {
+        ips.push(`${prefix}${i}`);
+    }
+    return ips;
+}
+export function registerNetworkDiscoveryTools(ctx) {
+    ctx.server.tool("adb_network_scan", "Scan the local network for Android devices with ADB enabled over WiFi/TCP. Probes common ADB ports (5555-5558) on hosts from the ARP table and optionally a custom IP range. Discovered devices can be connected with adb_connect.", {
+        ipRange: z.string().optional().describe("IP range to scan (e.g., '192.168.1.1-254'). If omitted, scans hosts from the ARP table only."),
+        ports: z.array(z.number().min(1).max(65535)).max(20).optional().describe("Custom ports to probe (default: [5555, 5554, 5556, 5557, 5558], max 20)"),
+        timeoutMs: z.number().min(500).max(10000).optional().default(2000).describe("Connection timeout per host in ms (500-10000, default 2000)"),
+        device: z.string().optional().describe("Device serial (used to determine the local subnet if no ipRange given)"),
+    }, async ({ ipRange, ports, timeoutMs, device }) => {
+        try {
+            const probePorts = ports ?? ADB_PORTS;
+            const timeout = Math.min(Math.max(timeoutMs, 500), 10000);
+            const discovered = [];
+            const sections = [];
+            sections.push("=== ADB Network Discovery ===\n");
+            // Collect candidate IPs
+            const candidates = new Set();
+            // Method 1: ARP table — query a connected device for its network neighbors
+            let arpSource = "host";
+            try {
+                // Try to get the device's own IP and subnet
+                const resolved = device ? await ctx.deviceManager.resolveDevice(device) : await ctx.deviceManager.resolveDevice();
+                const serial = resolved.serial;
+                const ipResult = await ctx.bridge.shell("ip neigh show 2>/dev/null || arp -a 2>/dev/null", {
+                    device: serial, timeout: 5000, ignoreExitCode: true,
+                });
+                const ipMatches = ipResult.stdout.matchAll(/(\d+\.\d+\.\d+\.\d+)/g);
+                for (const m of ipMatches) {
+                    const ip = m[1];
+                    // Skip broadcast, loopback, and link-local
+                    if (!ip.startsWith("127.") && !ip.startsWith("169.254.") && !ip.endsWith(".255")) {
+                        candidates.add(ip);
+                    }
+                }
+                arpSource = `device (${serial})`;
+            }
+            catch { /* no device available, skip */ }
+            // Method 2: User-specified IP range
+            if (ipRange) {
+                const rangeIps = expandIpRange(ipRange);
+                for (const ip of rangeIps)
+                    candidates.add(ip);
+                sections.push(`IP range: ${ipRange} (${rangeIps.length} hosts)`);
+            }
+            if (candidates.size === 0) {
+                sections.push("No candidate IPs found. Provide an ipRange to scan a specific subnet.");
+                sections.push("Example: ipRange='192.168.1.1-254'");
+                return { content: [{ type: "text", text: sections.join("\n") }] };
+            }
+            sections.push(`Candidates: ${candidates.size} hosts (from ${arpSource}${ipRange ? " + IP range" : ""})`);
+            sections.push(`Ports: ${probePorts.join(", ")}`);
+            sections.push(`Timeout: ${timeout}ms per probe\n`);
+            sections.push("Scanning...");
+            // Probe all candidates in parallel batches (limit concurrency to avoid overwhelming)
+            const allIps = Array.from(candidates);
+            const BATCH_SIZE = 20;
+            for (let batch = 0; batch < allIps.length; batch += BATCH_SIZE) {
+                const batchIps = allIps.slice(batch, batch + BATCH_SIZE);
+                const probes = [];
+                for (const ip of batchIps) {
+                    for (const port of probePorts) {
+                        probes.push(probePort(ip, port, timeout).then((open) => {
+                            if (open) {
+                                discovered.push({ ip, port, source: ipRange && expandIpRange(ipRange).includes(ip) ? "range" : "arp" });
+                            }
+                        }));
+                    }
+                }
+                await Promise.all(probes);
+            }
+            if (discovered.length === 0) {
+                sections.push("\nNo ADB listeners found on the scanned hosts.");
+                sections.push("Ensure target devices have wireless debugging enabled:");
+                sections.push("  Settings → Developer Options → Wireless debugging");
+                sections.push("  Or run: adb_tcpip to switch a USB-connected device to TCP mode.");
+            }
+            else {
+                sections.push(`\nDiscovered ${discovered.length} ADB listener(s):\n`);
+                for (const d of discovered) {
+                    sections.push(`  ${d.ip}:${d.port} (found via ${d.source})`);
+                }
+                sections.push(`\nConnect with: adb_connect host="${discovered[0].ip}:${discovered[0].port}"`);
+            }
+            return { content: [{ type: "text", text: sections.join("\n") }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_network_device_ip", "Get the WiFi IP address of a connected device. Useful for switching from USB to wireless debugging without needing to find the IP manually on the device.", {
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ device }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const serial = resolved.serial;
+            // Try multiple methods to get the device IP
+            const methods = [
+                { cmd: "ip route | grep 'src' | head -1", regex: /src\s+(\d+\.\d+\.\d+\.\d+)/ },
+                { cmd: "ip addr show wlan0 | grep 'inet '", regex: /inet\s+(\d+\.\d+\.\d+\.\d+)/ },
+                { cmd: "ifconfig wlan0 2>/dev/null | grep 'inet '", regex: /inet\s+(?:addr:)?(\d+\.\d+\.\d+\.\d+)/ },
+                { cmd: "getprop dhcp.wlan0.ipaddress", regex: /(\d+\.\d+\.\d+\.\d+)/ },
+            ];
+            let ip = null;
+            let method = "";
+            for (const m of methods) {
+                const result = await ctx.bridge.shell(m.cmd, {
+                    device: serial, ignoreExitCode: true,
+                });
+                const match = result.stdout.match(m.regex);
+                if (match && match[1] && !match[1].startsWith("127.")) {
+                    ip = match[1];
+                    method = m.cmd.split("|")[0].trim().split(" ")[0];
+                    break;
+                }
+            }
+            if (!ip) {
+                return {
+                    content: [{ type: "text", text: `Could not determine WiFi IP for ${serial}. Device may not be connected to WiFi.` }],
+                    isError: true,
+                };
+            }
+            // Check if ADB TCP is already enabled
+            const propsResult = await ctx.bridge.shell("getprop service.adb.tcp.port", {
+                device: serial, ignoreExitCode: true,
+            });
+            const tcpPort = propsResult.stdout.trim();
+            const adbTcpEnabled = tcpPort && tcpPort !== "0" && tcpPort !== "-1";
+            const sections = [];
+            sections.push(`Device: ${serial}`);
+            sections.push(`WiFi IP: ${ip} (via ${method})`);
+            sections.push(`ADB TCP: ${adbTcpEnabled ? `enabled on port ${tcpPort}` : "not enabled"}`);
+            if (adbTcpEnabled) {
+                sections.push(`\nConnect wirelessly: adb_connect host="${ip}:${tcpPort}"`);
+            }
+            else {
+                sections.push(`\nTo enable wireless debugging:`);
+                sections.push(`  1. adb_tcpip (switches USB device to TCP mode on port 5555)`);
+                sections.push(`  2. adb_connect host="${ip}:5555"`);
+            }
+            return { content: [{ type: "text", text: sections.join("\n") }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_network_auto_connect", "Discover and automatically connect to ADB devices on the local network. Combines network scanning with adb connect in one step.", {
+        ipRange: z.string().optional().describe("IP range to scan (e.g., '192.168.1.1-254')"),
+        port: z.number().min(1).max(65535).optional().default(5555).describe("ADB port to probe and connect (1-65535, default 5555)"),
+        device: z.string().optional().describe("Device serial (used to determine local subnet for ARP-based discovery)"),
+    }, async ({ ipRange, port, device }) => {
+        try {
+            const sections = [];
+            sections.push("=== Auto-Connect Discovery ===\n");
+            // Collect candidate IPs
+            const candidates = new Set();
+            if (ipRange) {
+                const ips = expandIpRange(ipRange);
+                for (const ip of ips)
+                    candidates.add(ip);
+            }
+            // ARP-based discovery
+            try {
+                const resolved = device ? await ctx.deviceManager.resolveDevice(device) : await ctx.deviceManager.resolveDevice();
+                const arpResult = await ctx.bridge.shell("ip neigh show 2>/dev/null || arp -a 2>/dev/null", {
+                    device: resolved.serial, timeout: 5000, ignoreExitCode: true,
+                });
+                for (const m of arpResult.stdout.matchAll(/(\d+\.\d+\.\d+\.\d+)/g)) {
+                    if (!m[1].startsWith("127.") && !m[1].endsWith(".255"))
+                        candidates.add(m[1]);
+                }
+            }
+            catch { /* no device for ARP */ }
+            if (candidates.size === 0) {
+                sections.push("No candidate IPs. Provide ipRange (e.g., '192.168.1.1-254').");
+                return { content: [{ type: "text", text: sections.join("\n") }] };
+            }
+            sections.push(`Scanning ${candidates.size} hosts on port ${port}...`);
+            // Probe all candidates
+            const found = [];
+            const allIps = Array.from(candidates);
+            const BATCH_SIZE = 20;
+            for (let batch = 0; batch < allIps.length; batch += BATCH_SIZE) {
+                const batchIps = allIps.slice(batch, batch + BATCH_SIZE);
+                const probes = batchIps.map((ip) => probePort(ip, port, 2000).then((open) => {
+                    if (open)
+                        found.push(ip);
+                }));
+                await Promise.all(probes);
+            }
+            if (found.length === 0) {
+                sections.push("\nNo ADB listeners found.");
+                return { content: [{ type: "text", text: sections.join("\n") }] };
+            }
+            sections.push(`\nFound ${found.length} device(s). Connecting...\n`);
+            // Try to connect to each discovered device
+            let connected = 0;
+            for (const ip of found) {
+                const target = `${ip}:${port}`;
+                try {
+                    const result = await ctx.bridge.exec(["connect", target], { timeout: 10000 });
+                    const output = result.stdout.trim();
+                    const success = output.includes("connected") && !output.includes("failed");
+                    if (success) {
+                        connected++;
+                        sections.push(`  ✓ Connected: ${target}`);
+                    }
+                    else {
+                        sections.push(`  ✗ Failed: ${target} — ${output}`);
+                    }
+                }
+                catch (err) {
+                    sections.push(`  ✗ Error: ${target} — ${err instanceof Error ? err.message : err}`);
+                }
+            }
+            // Invalidate device cache after connections
+            ctx.deviceManager.invalidateCache();
+            sections.push(`\nResult: ${connected} device(s) connected out of ${found.length} found.`);
+            if (connected > 0) {
+                sections.push("Use adb_devices to see all connected devices.");
+            }
+            return { content: [{ type: "text", text: sections.join("\n") }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=network-discovery.js.map

package/build/tools/network-discovery.js.map

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

package/build/tools/ota-monitor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * OTA Update Monitoring — Track system updates across sessions.
+ *
+ * Captures a comprehensive system fingerprint (build ID, security patch,
+ * bootloader version, kernel, baseband firmware) and compares against
+ * previously saved state to detect when a device has been updated.
+ *
+ * Useful for: detecting post-OTA behavioral changes in apps under test,
+ * verifying security patch currency, and triggering automatic re-baselining
+ * of performance and screenshots after updates.
+ *
+ * Fingerprints are saved as JSON in {tempDir}/ota-fingerprints/.
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerOtaMonitorTools(ctx: ToolContext): void;
+//# sourceMappingURL=ota-monitor.d.ts.map

package/build/tools/ota-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ota-monitor.d.ts","sourceRoot":"","sources":["../../src/tools/ota-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAuFjD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAiK9D"}

package/build/tools/ota-monitor.js

@@ -0,0 +1,211 @@
+/**
+ * OTA Update Monitoring — Track system updates across sessions.
+ *
+ * Captures a comprehensive system fingerprint (build ID, security patch,
+ * bootloader version, kernel, baseband firmware) and compares against
+ * previously saved state to detect when a device has been updated.
+ *
+ * Useful for: detecting post-OTA behavioral changes in apps under test,
+ * verifying security patch currency, and triggering automatic re-baselining
+ * of performance and screenshots after updates.
+ *
+ * Fingerprints are saved as JSON in {tempDir}/ota-fingerprints/.
+ */
+import { z } from "zod";
+import { join } from "path";
+import { mkdirSync, writeFileSync, readFileSync, existsSync, readdirSync } from "fs";
+import { OutputProcessor } from "../middleware/output-processor.js";
+function getFingerprintDir(tempDir) {
+    return join(tempDir, "ota-fingerprints");
+}
+async function captureFingerprint(ctx, serial) {
+    const props = await ctx.deviceManager.getDeviceProps(serial);
+    // Get kernel version separately (not in getprop)
+    const kernelResult = await ctx.bridge.shell("uname -r", {
+        device: serial, ignoreExitCode: true,
+    });
+    // Check A/B partition slot
+    const slotResult = await ctx.bridge.shell("getprop ro.boot.slot_suffix", {
+        device: serial, ignoreExitCode: true,
+    });
+    return {
+        timestamp: new Date().toISOString(),
+        device: serial,
+        model: props["ro.product.model"] ?? "unknown",
+        buildFingerprint: props["ro.build.fingerprint"] ?? "unknown",
+        buildId: props["ro.build.display.id"] ?? "unknown",
+        buildType: props["ro.build.type"] ?? "unknown",
+        androidVersion: props["ro.build.version.release"] ?? "unknown",
+        sdkLevel: props["ro.build.version.sdk"] ?? "unknown",
+        securityPatch: props["ro.build.version.security_patch"] ?? "unknown",
+        bootloaderVersion: props["ro.bootimage.build.fingerprint"] ?? props["ro.bootloader"] ?? "unknown",
+        basebandVersion: props["gsm.version.baseband"] ?? "unknown",
+        kernelVersion: kernelResult.stdout.trim() || "unknown",
+        buildDate: props["ro.build.date"] ?? "unknown",
+        incrementalBuild: props["ro.build.version.incremental"] ?? "unknown",
+        abUpdatePartition: slotResult.stdout.trim() || "none",
+    };
+}
+function compareFingerprints(saved, current) {
+    const fields = [
+        { key: "buildFingerprint", label: "Build Fingerprint" },
+        { key: "buildId", label: "Build ID" },
+        { key: "androidVersion", label: "Android Version" },
+        { key: "sdkLevel", label: "SDK Level" },
+        { key: "securityPatch", label: "Security Patch" },
+        { key: "bootloaderVersion", label: "Bootloader" },
+        { key: "basebandVersion", label: "Baseband Firmware" },
+        { key: "kernelVersion", label: "Kernel" },
+        { key: "incrementalBuild", label: "Incremental Build" },
+        { key: "abUpdatePartition", label: "A/B Slot" },
+    ];
+    const changed = [];
+    const unchanged = [];
+    for (const { key, label } of fields) {
+        const oldVal = saved[key];
+        const newVal = current[key];
+        if (oldVal !== newVal) {
+            changed.push(`${label}: "${oldVal}" → "${newVal}"`);
+        }
+        else {
+            unchanged.push(`${label}: ${newVal}`);
+        }
+    }
+    return { changed, unchanged };
+}
+export function registerOtaMonitorTools(ctx) {
+    ctx.server.tool("adb_ota_fingerprint", "Capture and save the current system fingerprint: build ID, Android version, security patch, bootloader, baseband firmware, kernel version, and A/B partition slot. Saves to a timestamped JSON file for later comparison.", {
+        label: z.string().optional().default("current").describe("Label for this fingerprint (e.g., 'pre-update', 'post-ota')"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ label, device }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const serial = resolved.serial;
+            const fp = await captureFingerprint(ctx, serial);
+            const dir = getFingerprintDir(ctx.config.tempDir);
+            if (!existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+            const safeLabel = label.replace(/[^a-zA-Z0-9_-]/g, "_");
+            const safeDevice = serial.replace(/[^a-zA-Z0-9_-]/g, "_");
+            const filename = `${safeDevice}_${safeLabel}_${Date.now()}.json`;
+            const filePath = join(dir, filename);
+            writeFileSync(filePath, JSON.stringify(fp, null, 2));
+            const summary = [];
+            summary.push(`System fingerprint captured: ${label}`);
+            summary.push(`Device: ${fp.model} (${serial})`);
+            summary.push(`Android: ${fp.androidVersion} (SDK ${fp.sdkLevel})`);
+            summary.push(`Build: ${fp.buildId}`);
+            summary.push(`Security Patch: ${fp.securityPatch}`);
+            summary.push(`Baseband: ${fp.basebandVersion}`);
+            summary.push(`Bootloader: ${fp.bootloaderVersion}`);
+            summary.push(`Kernel: ${fp.kernelVersion}`);
+            summary.push(`A/B Slot: ${fp.abUpdatePartition}`);
+            summary.push(`Saved: ${filePath}`);
+            return { content: [{ type: "text", text: summary.join("\n") }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_ota_check", "Compare the current system state against a saved fingerprint. Detects OTA updates by identifying changes in build ID, security patch, baseband firmware, bootloader, or kernel version.", {
+        fingerprintPath: z.string().optional().describe("Path to saved fingerprint JSON. If omitted, compares against the most recent fingerprint for this device."),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ fingerprintPath, device }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const serial = resolved.serial;
+            // Find the fingerprint to compare against
+            let savedPath = fingerprintPath;
+            if (!savedPath) {
+                const dir = getFingerprintDir(ctx.config.tempDir);
+                if (!existsSync(dir)) {
+                    return { content: [{ type: "text", text: "No saved fingerprints. Use adb_ota_fingerprint to capture one first." }], isError: true };
+                }
+                const safeDevice = serial.replace(/[^a-zA-Z0-9_-]/g, "_");
+                const files = readdirSync(dir)
+                    .filter((f) => f.startsWith(safeDevice) && f.endsWith(".json"))
+                    .sort()
+                    .reverse();
+                if (files.length === 0) {
+                    return { content: [{ type: "text", text: `No saved fingerprints for device ${serial}. Use adb_ota_fingerprint first.` }], isError: true };
+                }
+                savedPath = join(dir, files[0]);
+            }
+            if (!existsSync(savedPath)) {
+                return { content: [{ type: "text", text: `Fingerprint file not found: ${savedPath}` }], isError: true };
+            }
+            const saved = JSON.parse(readFileSync(savedPath, "utf-8"));
+            const current = await captureFingerprint(ctx, serial);
+            const { changed, unchanged } = compareFingerprints(saved, current);
+            const sections = [];
+            sections.push(`=== OTA Update Check ===`);
+            sections.push(`Saved: ${saved.timestamp} (${saved.buildId})`);
+            sections.push(`Current: ${current.buildId}`);
+            sections.push(`Device: ${current.model} (${serial})\n`);
+            if (changed.length === 0) {
+                sections.push("Result: ✓ NO UPDATE DETECTED — system state unchanged.\n");
+                sections.push(`Unchanged fields (${unchanged.length}):`);
+                for (const u of unchanged)
+                    sections.push(`  ✓ ${u}`);
+            }
+            else {
+                sections.push(`Result: ⚠ UPDATE DETECTED — ${changed.length} field(s) changed.\n`);
+                sections.push("Changed:");
+                for (const c of changed)
+                    sections.push(`  ✗ ${c}`);
+                if (unchanged.length > 0) {
+                    sections.push("\nUnchanged:");
+                    for (const u of unchanged)
+                        sections.push(`  ✓ ${u}`);
+                }
+                sections.push("\nRecommendation: Re-baseline performance (adb_regression_baseline) and screenshots (adb_screenshot_baseline) after an OTA update.");
+            }
+            return { content: [{ type: "text", text: sections.join("\n") }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_ota_history", "List all saved system fingerprints for a device, showing version progression over time. Highlights changes between consecutive snapshots.", {
+        device: z.string().optional().describe("Device serial (filters to this device). Omit for all devices."),
+    }, async ({ device }) => {
+        try {
+            const dir = getFingerprintDir(ctx.config.tempDir);
+            if (!existsSync(dir)) {
+                return { content: [{ type: "text", text: "No fingerprint history. Use adb_ota_fingerprint to start tracking." }] };
+            }
+            let deviceFilter = "";
+            if (device) {
+                const resolved = await ctx.deviceManager.resolveDevice(device);
+                deviceFilter = resolved.serial.replace(/[^a-zA-Z0-9_-]/g, "_");
+            }
+            const files = readdirSync(dir)
+                .filter((f) => f.endsWith(".json") && (!deviceFilter || f.startsWith(deviceFilter)))
+                .sort();
+            if (files.length === 0) {
+                return { content: [{ type: "text", text: device ? `No fingerprints for device ${device}.` : "No fingerprints saved." }] };
+            }
+            const fingerprints = [];
+            for (const file of files) {
+                try {
+                    fingerprints.push(JSON.parse(readFileSync(join(dir, file), "utf-8")));
+                }
+                catch { /* skip corrupt */ }
+            }
+            const lines = [`${fingerprints.length} fingerprint(s):\n`];
+            for (let i = 0; i < fingerprints.length; i++) {
+                const fp = fingerprints[i];
+                const changeMarker = i > 0 && fp.buildFingerprint !== fingerprints[i - 1].buildFingerprint
+                    ? " ⚠ UPDATE"
+                    : "";
+                lines.push(`[${i + 1}] ${fp.timestamp.substring(0, 19)} | ${fp.model} | Android ${fp.androidVersion} | ${fp.buildId} | Patch: ${fp.securityPatch}${changeMarker}`);
+            }
+            lines.push(`\nDirectory: ${dir}`);
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=ota-monitor.js.map

package/build/tools/ota-monitor.js.map

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

package/build/tools/packages.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Package Tools — App installation, management, and permissions.
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerPackageTools(ctx: ToolContext): void;
+//# sourceMappingURL=packages.d.ts.map

package/build/tools/packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../../src/tools/packages.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIjD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAiR3D"}