deepadb 1.0.0

package/build/tools/emulator.js

@@ -0,0 +1,223 @@
+/**
+ * Emulator Management Tools — AVD lifecycle management.
+ *
+ * Manages Android Virtual Devices: list available AVDs, start/stop emulators.
+ * Requires the Android SDK `emulator` binary to be on PATH or in the SDK directory.
+ */
+import { z } from "zod";
+import { execFile, spawn } from "child_process";
+import { platform } from "os";
+import { existsSync } from "fs";
+import { OutputProcessor } from "../middleware/output-processor.js";
+import { isOnDevice } from "../config/config.js";
+import { registerCleanup } from "../middleware/cleanup.js";
+/** Track spawned emulator processes for cleanup. Key = AVD name. */
+const emulatorProcesses = new Map();
+// Register cleanup via shared registry to kill orphaned emulators on server exit
+function ensureCleanupRegistered() {
+    registerCleanup("emulator", () => {
+        for (const [, proc] of emulatorProcesses) {
+            try {
+                proc.kill();
+            }
+            catch { /* ignore */ }
+        }
+        emulatorProcesses.clear();
+    });
+}
+function getEmulatorPath() {
+    const isWindows = platform() === "win32";
+    const localAppData = process.env.LOCALAPPDATA ?? "";
+    if (isWindows && localAppData) {
+        const sdkPath = `${localAppData}\\Android\\Sdk\\emulator\\emulator.exe`;
+        if (existsSync(sdkPath))
+            return sdkPath;
+    }
+    // Check ANDROID_HOME / ANDROID_SDK_ROOT
+    const sdkRoot = process.env.ANDROID_HOME ?? process.env.ANDROID_SDK_ROOT;
+    if (sdkRoot) {
+        const sep = isWindows ? "\\" : "/";
+        const ext = isWindows ? ".exe" : "";
+        const sdkPath = `${sdkRoot}${sep}emulator${sep}emulator${ext}`;
+        if (existsSync(sdkPath))
+            return sdkPath;
+    }
+    return "emulator";
+}
+export function registerEmulatorTools(ctx) {
+    ensureCleanupRegistered();
+    ctx.server.tool("adb_avd_list", "List all available Android Virtual Devices (AVDs) that can be started.", {}, async () => {
+        try {
+            // On-device mode: SDK emulator binary is not available (it's compiled for
+            // desktop x86_64). Check for KVM and QEMU as an alternative virtualization path.
+            if (isOnDevice()) {
+                const sections = [];
+                sections.push("On-device mode: Android SDK emulator (AVD) is not available.");
+                sections.push("The SDK emulator binary is compiled for desktop platforms (x86_64 Linux/macOS/Windows).\n");
+                // Check for KVM support
+                const kvmAvailable = existsSync("/dev/kvm");
+                sections.push(`Hardware virtualization (KVM): ${kvmAvailable ? "✓ /dev/kvm available" : "✗ /dev/kvm not found"}`);
+                // Check if QEMU is installed in Termux
+                let qemuInstalled = false;
+                try {
+                    const qemuCheck = await ctx.bridge.shell("which qemu-system-aarch64 2>/dev/null || which qemu-system-x86_64 2>/dev/null", {
+                        ignoreExitCode: true, timeout: 5000,
+                    });
+                    qemuInstalled = qemuCheck.stdout.trim().length > 0;
+                }
+                catch { /* not installed */ }
+                sections.push(`QEMU: ${qemuInstalled ? "✓ installed" : "✗ not installed"}`);
+                if (kvmAvailable && !qemuInstalled) {
+                    sections.push("\nQEMU with KVM is supported on this device for near-native emulation.");
+                    sections.push("Setup: adb_qemu_setup install=true");
+                    sections.push("Then: adb_qemu_images, adb_qemu_start, adb_qemu_stop, adb_qemu_status");
+                }
+                else if (kvmAvailable && qemuInstalled) {
+                    sections.push("\n✓ QEMU with KVM is available for on-device virtualization.");
+                    sections.push("Use: adb_qemu_images, adb_qemu_start, adb_qemu_stop, adb_qemu_status");
+                }
+                else {
+                    sections.push("\nWithout KVM, emulation would be software-only and very slow.");
+                }
+                return { content: [{ type: "text", text: sections.join("\n") }] };
+            }
+            const emulatorPath = getEmulatorPath();
+            return new Promise((resolve) => {
+                execFile(emulatorPath, ["-list-avds"], {
+                    timeout: 15000, windowsHide: true,
+                }, (error, stdout, stderr) => {
+                    if (error && !stdout) {
+                        resolve({
+                            content: [{ type: "text", text: `Failed to list AVDs: ${error.message}\nIs the Android SDK emulator installed and on PATH?` }],
+                            isError: true,
+                        });
+                        return;
+                    }
+                    const avds = (stdout?.toString() ?? "").trim().split("\n").filter((l) => l.trim().length > 0);
+                    if (avds.length === 0) {
+                        resolve({ content: [{ type: "text", text: "No AVDs found. Create one with Android Studio's AVD Manager or `avdmanager`." }] });
+                        return;
+                    }
+                    // Also show any currently running emulators
+                    const running = Array.from(emulatorProcesses.keys());
+                    let output = `${avds.length} AVD(s) available:\n${avds.join("\n")}`;
+                    if (running.length > 0) {
+                        output += `\n\nCurrently running: ${running.join(", ")}`;
+                    }
+                    resolve({ content: [{ type: "text", text: output }] });
+                });
+            });
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_emulator_start", "Launch an Android Virtual Device (AVD) emulator. Returns once the emulator process has started.", {
+        avdName: z.string().describe("AVD name (from adb_avd_list)"),
+        headless: z.boolean().optional().default(false).describe("Run without GUI window (-no-window)"),
+        coldBoot: z.boolean().optional().default(false).describe("Force cold boot (-no-snapshot-load)"),
+        gpuMode: z.enum(["auto", "host", "swiftshader_indirect", "off"]).optional().default("auto")
+            .describe("GPU acceleration mode"),
+    }, async ({ avdName, headless, coldBoot, gpuMode }) => {
+        try {
+            if (isOnDevice()) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "On-device mode: AVD emulator is not available.\n" +
+                                "The Android SDK emulator requires a desktop host (x86_64 Linux/macOS/Windows).\n\n" +
+                                "Use the QEMU tools for on-device virtualization:\n" +
+                                "  adb_qemu_setup — install QEMU and verify KVM\n" +
+                                "  adb_qemu_images — create/manage disk images\n" +
+                                "  adb_qemu_start — boot a VM with KVM acceleration\n" +
+                                "  adb_qemu_status — view running VMs",
+                        }],
+                    isError: true,
+                };
+            }
+            if (emulatorProcesses.has(avdName)) {
+                return { content: [{ type: "text", text: `Emulator '${avdName}' is already running.` }], isError: true };
+            }
+            const emulatorPath = getEmulatorPath();
+            const args = ["-avd", avdName, `-gpu`, gpuMode];
+            if (headless)
+                args.push("-no-window");
+            if (coldBoot)
+                args.push("-no-snapshot-load");
+            const proc = spawn(emulatorPath, args, {
+                windowsHide: true,
+                stdio: ["ignore", "pipe", "pipe"],
+                detached: false,
+            });
+            emulatorProcesses.set(avdName, proc);
+            let stderrOutput = "";
+            proc.stderr?.on("data", (chunk) => {
+                stderrOutput += chunk.toString();
+            });
+            proc.on("error", (err) => {
+                ctx.logger.error(`[emulator:${avdName}] Spawn error: ${err.message}`);
+                emulatorProcesses.delete(avdName);
+            });
+            proc.on("exit", (code) => {
+                ctx.logger.info(`[emulator:${avdName}] Exited (code: ${code})`);
+                emulatorProcesses.delete(avdName);
+            });
+            // Wait briefly for startup errors
+            await new Promise((r) => setTimeout(r, 3000));
+            // Check if process died immediately
+            if (!emulatorProcesses.has(avdName)) {
+                const errorMsg = stderrOutput.trim().split("\n").slice(0, 5).join("\n");
+                return {
+                    content: [{ type: "text", text: `Emulator '${avdName}' failed to start.${errorMsg ? "\n" + errorMsg : ""}` }],
+                    isError: true,
+                };
+            }
+            ctx.deviceManager.invalidateCache();
+            return {
+                content: [{
+                        type: "text",
+                        text: `Emulator '${avdName}' starting...${headless ? " (headless)" : ""}\nUse adb_devices to check when it comes online.\nUse adb_emulator_stop to shut it down.`,
+                    }],
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_emulator_stop", "Stop a running emulator. Uses 'adb emu kill' for graceful shutdown.", {
+        avdName: z.string().optional().describe("AVD name to stop. If omitted, lists running emulators."),
+        device: z.string().optional().describe("Emulator device serial (e.g., 'emulator-5554') — alternative to avdName"),
+    }, async ({ avdName, device }) => {
+        try {
+            // If device serial is provided, kill via ADB directly
+            if (device) {
+                await ctx.bridge.exec(["emu", "kill"], { device, timeout: 10000, ignoreExitCode: true });
+                ctx.deviceManager.invalidateCache();
+                return { content: [{ type: "text", text: `Emulator ${device} shutdown initiated.` }] };
+            }
+            // If AVD name is provided, find and kill it
+            if (avdName) {
+                const proc = emulatorProcesses.get(avdName);
+                if (proc) {
+                    try {
+                        proc.kill();
+                    }
+                    catch { /* ignore */ }
+                    emulatorProcesses.delete(avdName);
+                }
+                ctx.deviceManager.invalidateCache();
+                return { content: [{ type: "text", text: `Emulator '${avdName}' stop signal sent.` }] };
+            }
+            // No args — list running emulators
+            const running = Array.from(emulatorProcesses.keys());
+            if (running.length === 0) {
+                return { content: [{ type: "text", text: "No emulators tracked by DeepADB. Use device serial to stop externally-launched emulators." }] };
+            }
+            return { content: [{ type: "text", text: `Running emulators: ${running.join(", ")}\nProvide avdName or device serial to stop.` }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=emulator.js.map

package/build/tools/emulator.js.map

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

package/build/tools/files.d.ts

@@ -0,0 +1,6 @@
+/**
+ * File Tools — Push, pull, list, and manage files on the device.
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerFileTools(ctx: ToolContext): void;
+//# sourceMappingURL=files.d.ts.map

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

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

package/build/tools/files.js

@@ -0,0 +1,78 @@
+/**
+ * File Tools — Push, pull, list, and manage files on the device.
+ */
+import { z } from "zod";
+import { join } from "path";
+import { OutputProcessor } from "../middleware/output-processor.js";
+import { shellEscape } from "../middleware/sanitize.js";
+export function registerFileTools(ctx) {
+    ctx.server.tool("adb_push", "Push a local file to the device filesystem", {
+        localPath: z.string().describe("Local file path to push"),
+        remotePath: z.string().describe("Destination path on device"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ localPath, remotePath, device }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const result = await ctx.bridge.exec(["push", localPath, remotePath], {
+                device: resolved.serial, timeout: 120000,
+            });
+            return { content: [{ type: "text", text: result.stdout.trim() || "File pushed successfully." }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_pull", "Pull a file from the device to local filesystem", {
+        remotePath: z.string().describe("File path on the device"),
+        localPath: z.string().optional().describe("Local destination (defaults to temp dir)"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ remotePath, localPath, device }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const fileName = remotePath.split("/").pop() ?? "pulled_file";
+            const dest = localPath ?? join(ctx.config.tempDir, fileName);
+            const result = await ctx.bridge.exec(["pull", remotePath, dest], {
+                device: resolved.serial, timeout: 120000,
+            });
+            return {
+                content: [{ type: "text", text: `${result.stdout.trim()}\nSaved to: ${dest}` }],
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_ls", "List files and directories on the device", {
+        path: z.string().default("/sdcard").describe("Directory path on device"),
+        device: z.string().optional().describe("Device serial"),
+        details: z.boolean().optional().default(false).describe("Show detailed listing (ls -la)"),
+    }, async ({ path, device, details }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const cmd = details ? `ls -la '${shellEscape(path)}'` : `ls '${shellEscape(path)}'`;
+            const result = await ctx.bridge.shell(cmd, { device: resolved.serial });
+            return { content: [{ type: "text", text: OutputProcessor.process(result.stdout) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_cat", "Read a text file from the device", {
+        path: z.string().describe("File path on device"),
+        device: z.string().optional().describe("Device serial"),
+        maxLines: z.number().min(1).max(10000).optional().describe("Maximum lines to return (1-10000)"),
+    }, async ({ path, device, maxLines }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            let cmd = `cat '${shellEscape(path)}'`;
+            if (maxLines)
+                cmd = `head -n ${maxLines} '${shellEscape(path)}'`;
+            const result = await ctx.bridge.shell(cmd, { device: resolved.serial });
+            return { content: [{ type: "text", text: OutputProcessor.process(result.stdout) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=files.js.map

package/build/tools/files.js.map

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

package/build/tools/firmware-analysis.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Modem Firmware Analysis — Comprehensive firmware version tracking and diffing.
+ *
+ * Parses and compares firmware version strings across OTA updates.
+ * Understands version numbering conventions for major chipset families:
+ *
+ *   - Shannon/Exynos: Google Pixel/Tensor "g5123b-..." and Samsung "S5123AP_CL..." formats
+ *   - Qualcomm: "MPSS.xx.yy.zz" (modem protocol software stack)
+ *   - MediaTek: "MOLY.xxx.yyy" prefixed versions
+ *   - Unisoc/Spreadtrum: SoC model + branch/version formats
+ *   - HiSilicon/Kirin: Model + version with carrier codes, and encoded formats
+ *   - Intel XMM: XMM model + branch/build formats
+ *   - Generic: semver-like or date-based patterns
+ *
+ * Also parses bootloader versions (Pixel codename/version/build, Samsung model/carrier/revision)
+ * and RIL implementation strings (Samsung S.LSI, Qualcomm, MediaTek).
+ *
+ * Builds on the OTA fingerprint system — reads saved fingerprints from
+ * {tempDir}/ota-fingerprints/ to track firmware progression over time.
+ * Can also query the live device for current firmware details.
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerFirmwareAnalysisTools(ctx: ToolContext): void;
+//# sourceMappingURL=firmware-analysis.d.ts.map

package/build/tools/firmware-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firmware-analysis.d.ts","sourceRoot":"","sources":["../../src/tools/firmware-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAwPjD,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAqZpE"}