deepadb 1.0.0

package/build/tools/packages.js

@@ -0,0 +1,237 @@
+/**
+ * Package Tools — App installation, management, and permissions.
+ */
+import { z } from "zod";
+import { OutputProcessor } from "../middleware/output-processor.js";
+import { validateShellArg, validateShellArgs } from "../middleware/sanitize.js";
+export function registerPackageTools(ctx) {
+    ctx.server.tool("adb_install", "Install an APK on the device. Provide the full local path to the APK file.", {
+        apkPath: z.string().describe("Local filesystem path to the APK file"),
+        device: z.string().optional().describe("Device serial"),
+        replace: z.boolean().optional().default(true).describe("Replace existing app (-r flag)"),
+        downgrade: z.boolean().optional().default(false).describe("Allow version downgrade (-d flag)"),
+    }, async ({ apkPath, device, replace, downgrade }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const args = ["install"];
+            if (replace)
+                args.push("-r");
+            if (downgrade)
+                args.push("-d");
+            args.push(apkPath);
+            const result = await ctx.bridge.exec(args, { device: resolved.serial, timeout: 120000 });
+            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_uninstall", "Uninstall a package from the device", {
+        packageName: z.string().describe("Package name (e.g., 'com.example.app')"),
+        device: z.string().optional().describe("Device serial"),
+        keepData: z.boolean().optional().default(false).describe("Keep app data and cache (-k flag)"),
+    }, async ({ packageName, device, keepData }) => {
+        try {
+            const pkgErr = validateShellArg(packageName, "packageName");
+            if (pkgErr)
+                return { content: [{ type: "text", text: pkgErr }], isError: true };
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const args = ["uninstall"];
+            if (keepData)
+                args.push("-k");
+            args.push(packageName);
+            const result = await ctx.bridge.exec(args, { device: resolved.serial });
+            return { content: [{ type: "text", text: result.stdout.trim() || "Success" }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_list_packages", "List installed packages. Supports filtering by name.", {
+        filter: z.string().optional().describe("Filter packages containing this string"),
+        device: z.string().optional().describe("Device serial"),
+        type: z.enum(["all", "system", "third-party"]).optional().default("all")
+            .describe("Show all, system-only, or third-party-only packages"),
+    }, async ({ filter, device, type }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            let cmd = "pm list packages";
+            if (type === "system")
+                cmd += " -s";
+            else if (type === "third-party")
+                cmd += " -3";
+            if (filter) {
+                const err = validateShellArg(filter, "filter");
+                if (err)
+                    return { content: [{ type: "text", text: err }], isError: true };
+                cmd += ` ${filter}`;
+            }
+            const result = await ctx.bridge.shell(cmd, { device: resolved.serial });
+            const packages = result.stdout
+                .split("\n")
+                .map((l) => l.replace("package:", "").trim())
+                .filter((l) => l.length > 0)
+                .sort();
+            return {
+                content: [{ type: "text", text: `${packages.length} packages:\n${packages.join("\n")}` }],
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_package_info", "Get detailed info about an installed package (version, permissions, paths)", {
+        packageName: z.string().describe("Package name"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ packageName, device }) => {
+        try {
+            const pkgErr = validateShellArg(packageName, "packageName");
+            if (pkgErr)
+                return { content: [{ type: "text", text: pkgErr }], isError: true };
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const result = await ctx.bridge.shell(`dumpsys package ${packageName}`, { 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_clear_data", "Clear all data for a package (equivalent to clearing storage in settings)", {
+        packageName: z.string().describe("Package name"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ packageName, device }) => {
+        try {
+            const pkgErr = validateShellArg(packageName, "packageName");
+            if (pkgErr)
+                return { content: [{ type: "text", text: pkgErr }], isError: true };
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const result = await ctx.bridge.shell(`pm clear ${packageName}`, { device: resolved.serial });
+            return { content: [{ type: "text", text: result.stdout.trim() }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_grant_permission", "Grant a runtime permission to a package", {
+        packageName: z.string().describe("Package name"),
+        permission: z.string().describe("Full permission string (e.g., 'android.permission.READ_PHONE_STATE')"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ packageName, permission, device }) => {
+        try {
+            const argErr = validateShellArgs([[packageName, "packageName"], [permission, "permission"]]);
+            if (argErr)
+                return { content: [{ type: "text", text: argErr }], isError: true };
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const result = await ctx.bridge.shell(`pm grant ${packageName} ${permission}`, { device: resolved.serial, ignoreExitCode: true });
+            const output = result.stdout.trim() || "Permission granted.";
+            return { content: [{ type: "text", text: output }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_force_stop", "Force-stop an app immediately. The most common debugging action.", {
+        packageName: z.string().describe("Package name (e.g., 'com.example.app')"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ packageName, device }) => {
+        try {
+            const pkgErr = validateShellArg(packageName, "packageName");
+            if (pkgErr)
+                return { content: [{ type: "text", text: pkgErr }], isError: true };
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            await ctx.bridge.shell(`am force-stop ${packageName}`, { device: resolved.serial });
+            return { content: [{ type: "text", text: `Force-stopped: ${packageName}` }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_start_app", "Launch an app by package name (resolves and starts the default launcher activity)", {
+        packageName: z.string().describe("Package name (e.g., 'com.example.app')"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ packageName, device }) => {
+        try {
+            const pkgErr = validateShellArg(packageName, "packageName");
+            if (pkgErr)
+                return { content: [{ type: "text", text: pkgErr }], isError: true };
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const result = await ctx.bridge.shell(`monkey -p ${packageName} -c android.intent.category.LAUNCHER 1`, { device: resolved.serial, ignoreExitCode: true });
+            const output = result.stdout.trim();
+            if (output.includes("No activities found")) {
+                return { content: [{ type: "text", text: `No launcher activity found for ${packageName}` }], isError: true };
+            }
+            return { content: [{ type: "text", text: `Launched: ${packageName}` }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_restart_app", "Force-stop then re-launch an app. The most frequent debugging workflow in a single call.", {
+        packageName: z.string().describe("Package name (e.g., 'com.example.app')"),
+        device: z.string().optional().describe("Device serial"),
+        delayMs: z.number().min(0).max(10000).optional().default(500).describe("Delay between stop and start in ms (0-10000, default 500)"),
+    }, async ({ packageName, device, delayMs }) => {
+        try {
+            const pkgErr = validateShellArg(packageName, "packageName");
+            if (pkgErr)
+                return { content: [{ type: "text", text: pkgErr }], isError: true };
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const serial = resolved.serial;
+            // Force stop
+            await ctx.bridge.shell(`am force-stop ${packageName}`, { device: serial });
+            // Brief settle
+            await new Promise((r) => setTimeout(r, delayMs));
+            // Re-launch
+            const result = await ctx.bridge.shell(`monkey -p ${packageName} -c android.intent.category.LAUNCHER 1`, { device: serial, ignoreExitCode: true });
+            if (result.stdout.includes("No activities found")) {
+                return { content: [{ type: "text", text: `Stopped ${packageName} but no launcher activity found to restart.` }], isError: true };
+            }
+            return { content: [{ type: "text", text: `Restarted: ${packageName}` }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_resolve_intents", "Discover all activities, services, and receivers registered by a package with their intent filters", {
+        packageName: z.string().describe("Package name to query"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ packageName, device }) => {
+        try {
+            const pkgErr = validateShellArg(packageName, "packageName");
+            if (pkgErr)
+                return { content: [{ type: "text", text: pkgErr }], isError: true };
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            // Get the full package dump and extract resolver sections
+            const result = await ctx.bridge.shell(`dumpsys package ${packageName}`, {
+                device: resolved.serial, timeout: 15000,
+            });
+            const dump = result.stdout;
+            // Extract Activity, Service, and Receiver resolver entries
+            const sections = [];
+            for (const sectionName of ["Activity Resolver Table", "Service Resolver Table", "Receiver Resolver Table"]) {
+                const startIdx = dump.indexOf(sectionName);
+                if (startIdx === -1)
+                    continue;
+                // Find next resolver table or end of relevant section
+                const endMarkers = ["Resolver Table", "Permissions:", "Registered ContentProviders:", "ContentProvider Authorities:"];
+                let endIdx = dump.length;
+                for (const marker of endMarkers) {
+                    const idx = dump.indexOf(marker, startIdx + sectionName.length + 1);
+                    if (idx !== -1 && idx < endIdx)
+                        endIdx = idx;
+                }
+                const section = dump.substring(startIdx, endIdx).trim();
+                if (section)
+                    sections.push(section);
+            }
+            if (sections.length === 0) {
+                return { content: [{ type: "text", text: `No resolver entries found for ${packageName}` }] };
+            }
+            return { content: [{ type: "text", text: OutputProcessor.process(sections.join("\n\n")) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=packages.js.map

package/build/tools/packages.js.map

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

package/build/tools/plugins.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Plugin Architecture — Dynamic tool module loading.
+ *
+ * Allows external tool modules to be loaded at runtime from a plugins directory.
+ * Each plugin is a JavaScript module that exports a register function accepting ToolContext.
+ *
+ * Plugin directory: DA_PLUGIN_DIR env var, or {tempDir}/plugins
+ *
+ * Plugin format:
+ *   // my-plugin.js
+ *   export function register(ctx) {
+ *     ctx.server.tool("my_custom_tool", "description", { ... }, async (args) => { ... });
+ *   }
+ */
+import { ToolContext } from "../tool-context.js";
+/**
+ * Scan the plugins directory and load any .js modules that export a register function.
+ * Called once at startup.
+ */
+export declare function loadPlugins(ctx: ToolContext): Promise<void>;
+export declare function registerPluginTools(ctx: ToolContext): void;
+//# sourceMappingURL=plugins.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/tools/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAYjD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCjE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAoE1D"}

package/build/tools/plugins.js

@@ -0,0 +1,118 @@
+/**
+ * Plugin Architecture — Dynamic tool module loading.
+ *
+ * Allows external tool modules to be loaded at runtime from a plugins directory.
+ * Each plugin is a JavaScript module that exports a register function accepting ToolContext.
+ *
+ * Plugin directory: DA_PLUGIN_DIR env var, or {tempDir}/plugins
+ *
+ * Plugin format:
+ *   // my-plugin.js
+ *   export function register(ctx) {
+ *     ctx.server.tool("my_custom_tool", "description", { ... }, async (args) => { ... });
+ *   }
+ */
+import { join } from "path";
+import { readdirSync, existsSync } from "fs";
+import { pathToFileURL } from "url";
+import { OutputProcessor } from "../middleware/output-processor.js";
+/** Track loaded plugins */
+const loadedPlugins = [];
+/**
+ * Scan the plugins directory and load any .js modules that export a register function.
+ * Called once at startup.
+ */
+export async function loadPlugins(ctx) {
+    const pluginDir = process.env.DA_PLUGIN_DIR ?? join(ctx.config.tempDir, "plugins");
+    if (!existsSync(pluginDir)) {
+        ctx.logger.debug(`Plugin directory not found: ${pluginDir} (no plugins to load)`);
+        return;
+    }
+    const files = readdirSync(pluginDir).filter((f) => f.endsWith(".js"));
+    if (files.length === 0) {
+        ctx.logger.debug("Plugin directory exists but contains no .js files.");
+        return;
+    }
+    for (const file of files) {
+        const pluginPath = join(pluginDir, file);
+        try {
+            const moduleUrl = pathToFileURL(pluginPath).href;
+            const mod = await import(moduleUrl);
+            if (typeof mod.register === "function") {
+                mod.register(ctx);
+                loadedPlugins.push({
+                    name: file.replace(/\.js$/, ""),
+                    path: pluginPath,
+                    loadedAt: Date.now(),
+                });
+                ctx.logger.info(`Plugin loaded: ${file}`);
+            }
+            else {
+                ctx.logger.warn(`Plugin ${file} has no register() export — skipped.`);
+            }
+        }
+        catch (error) {
+            ctx.logger.error(`Failed to load plugin ${file}: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    if (loadedPlugins.length > 0) {
+        ctx.logger.info(`${loadedPlugins.length} plugin(s) loaded from ${pluginDir}`);
+    }
+}
+export function registerPluginTools(ctx) {
+    ctx.server.tool("adb_plugin_list", "List all loaded plugins and the plugin directory path.", {}, async () => {
+        try {
+            const pluginDir = process.env.DA_PLUGIN_DIR ?? join(ctx.config.tempDir, "plugins");
+            if (loadedPlugins.length === 0) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `No plugins loaded.\nPlugin directory: ${pluginDir}\n\nTo create a plugin, add a .js file to the plugin directory that exports a register(ctx) function.`,
+                        }],
+                };
+            }
+            const output = loadedPlugins.map((p) => {
+                const ago = ((Date.now() - p.loadedAt) / 1000).toFixed(0);
+                return `${p.name} — loaded ${ago}s ago\n  Path: ${p.path}`;
+            }).join("\n\n");
+            return {
+                content: [{
+                        type: "text",
+                        text: `${loadedPlugins.length} plugin(s) loaded:\n\n${output}\n\nPlugin directory: ${pluginDir}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_plugin_info", "Show information about the plugin system: directory, how to create plugins, and loaded plugin count.", {}, async () => {
+        try {
+            const pluginDir = process.env.DA_PLUGIN_DIR ?? join(ctx.config.tempDir, "plugins");
+            const info = [
+                `Plugin System — DeepADB`,
+                ``,
+                `Directory: ${pluginDir}`,
+                `Loaded: ${loadedPlugins.length} plugin(s)`,
+                ``,
+                `Creating a plugin:`,
+                `1. Create a .js file in the plugin directory`,
+                `2. Export a register(ctx) function that receives ToolContext`,
+                `3. Use ctx.server.tool() to register custom tools`,
+                `4. Restart DeepADB to load the plugin`,
+                ``,
+                `Example (my-plugin.js):`,
+                `  export function register(ctx) {`,
+                `    ctx.server.tool("my_tool", "My custom tool", {}, async () => {`,
+                `      return { content: [{ type: "text", text: "Hello from plugin!" }] };`,
+                `    });`,
+                `  }`,
+            ];
+            return { content: [{ type: "text", text: info.join("\n") }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=plugins.js.map

package/build/tools/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/tools/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAQpE,2BAA2B;AAC3B,MAAM,aAAa,GAAmB,EAAE,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAgB;IAChD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAEnF,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,SAAS,uBAAuB,CAAC,CAAC;QAClF,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACvE,OAAO;IACT,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;YACjD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YAEpC,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACvC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAClB,aAAa,CAAC,IAAI,CAAC;oBACjB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;oBAC/B,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;iBACrB,CAAC,CAAC;gBACH,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,sCAAsC,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,0BAA0B,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAgB;IAElD,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,iBAAiB,EACjB,wDAAwD,EACxD,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAEnF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,yCAAyC,SAAS,uGAAuG;yBAChK,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACrC,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC1D,OAAO,GAAG,CAAC,CAAC,IAAI,aAAa,GAAG,kBAAkB,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7D,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhB,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,GAAG,aAAa,CAAC,MAAM,yBAAyB,MAAM,yBAAyB,SAAS,EAAE;qBACjG,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAClG,CAAC;IACH,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,iBAAiB,EACjB,sGAAsG,EACtG,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACnF,MAAM,IAAI,GAAG;gBACX,yBAAyB;gBACzB,EAAE;gBACF,cAAc,SAAS,EAAE;gBACzB,WAAW,aAAa,CAAC,MAAM,YAAY;gBAC3C,EAAE;gBACF,oBAAoB;gBACpB,8CAA8C;gBAC9C,8DAA8D;gBAC9D,mDAAmD;gBACnD,uCAAuC;gBACvC,EAAE;gBACF,yBAAyB;gBACzB,mCAAmC;gBACnC,oEAAoE;gBACpE,2EAA2E;gBAC3E,SAAS;gBACT,KAAK;aACN,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAClG,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/prompts.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Prompts — Pre-built workflow templates for common Android debugging tasks.
+ *
+ * Prompts are exposed to MCP clients as reusable, parameterized templates
+ * that guide multi-step tool usage sequences.
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerPrompts(ctx: ToolContext): void;
+//# sourceMappingURL=prompts.d.ts.map

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

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

package/build/tools/prompts.js

@@ -0,0 +1,94 @@
+/**
+ * MCP Prompts — Pre-built workflow templates for common Android debugging tasks.
+ *
+ * Prompts are exposed to MCP clients as reusable, parameterized templates
+ * that guide multi-step tool usage sequences.
+ */
+import { z } from "zod";
+export function registerPrompts(ctx) {
+    ctx.server.prompt("debug-crash", "Guided workflow: Capture crash information for debugging. Clears logcat, waits for reproduction, then captures crash buffer and device state.", { packageName: z.string().describe("Package name to monitor for crashes") }, ({ packageName }) => ({
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `I need to debug a crash in ${packageName}. Please follow this workflow:`,
+                        ``,
+                        `1. Clear the logcat buffers using adb_logcat_clear`,
+                        `2. Force-stop and restart ${packageName} using adb_restart_app`,
+                        `3. Ask me to reproduce the crash, then wait for my confirmation`,
+                        `4. After I confirm, capture the crash buffer using adb_logcat_crash with 200 lines`,
+                        `5. Capture the main logcat filtered to ${packageName} using adb_logcat with tag="${packageName}" and 300 lines`,
+                        `6. Get the device info using adb_device_info for context`,
+                        `7. Analyze the crash logs and provide a diagnosis`,
+                    ].join("\n"),
+                },
+            }],
+    }));
+    ctx.server.prompt("deploy-and-test", "Guided workflow: Build, install, launch, and start monitoring an app in one sequence.", {
+        projectPath: z.string().describe("Path to the Android project root"),
+        packageName: z.string().describe("Package name of the app"),
+    }, ({ projectPath, packageName }) => ({
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Deploy and test ${packageName} from ${projectPath}. Follow this workflow:`,
+                        ``,
+                        `1. Build and install the debug APK using adb_build_and_install with projectPath="${projectPath}"`,
+                        `2. Clear logcat buffers using adb_logcat_clear`,
+                        `3. Start a background logcat watcher using adb_logcat_start with tag="${packageName}"`,
+                        `4. Launch the app using adb_start_app with packageName="${packageName}"`,
+                        `5. Wait 3 seconds, then take a screenshot using adb_screencap`,
+                        `6. Poll the logcat watcher using adb_logcat_poll to show initial log output`,
+                        `7. Report the deployment status and any startup issues found in the logs`,
+                    ].join("\n"),
+                },
+            }],
+    }));
+    ctx.server.prompt("telephony-snapshot", "Guided workflow: Capture comprehensive telephony and cellular state for radio diagnostics.", {}, () => ({
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Capture a comprehensive telephony snapshot for cellular security analysis:`,
+                        ``,
+                        `1. Get full telephony state using adb_telephony`,
+                        `2. Get network connectivity info using adb_network`,
+                        `3. Read the SIM operator using adb_getprop with key="gsm.sim.operator.alpha"`,
+                        `4. Read the network operator using adb_getprop with key="gsm.operator.alpha"`,
+                        `5. Read the network type using adb_getprop with key="gsm.network.type"`,
+                        `6. Summarize the cellular state: operator, registration, signal strength, cell IDs, and any anomalies`,
+                    ].join("\n"),
+                },
+            }],
+    }));
+    ctx.server.prompt("airplane-cycle-test", "Guided workflow: Test cellular re-registration by cycling airplane mode while monitoring logs.", {
+        packageName: z.string().optional().describe("Optional package to monitor during the test"),
+    }, ({ packageName }) => {
+        const tagFilter = packageName ? ` with tag="${packageName}"` : "";
+        return {
+            messages: [{
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: [
+                            `Test cellular re-registration with airplane mode cycling:`,
+                            ``,
+                            `1. Start a background logcat watcher using adb_logcat_start${tagFilter}`,
+                            `2. Get baseline telephony state using adb_telephony`,
+                            `3. Cycle airplane mode using adb_airplane_cycle with delaySeconds=5`,
+                            `4. Wait 10 seconds for cellular re-registration`,
+                            `5. Get post-cycle telephony state using adb_telephony`,
+                            `6. Poll the logcat watcher using adb_logcat_poll`,
+                            `7. Compare pre and post telephony state — report any changes in cell ID, operator, signal strength, or registration status`,
+                            `8. Stop the logcat watcher using adb_logcat_stop`,
+                        ].join("\n"),
+                    },
+                }],
+        };
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/build/tools/prompts.js.map

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

package/build/tools/qemu.d.ts

@@ -0,0 +1,18 @@
+/**
+ * QEMU/KVM Tools — On-device virtual machine management.
+ *
+ * Provides QEMU VM lifecycle management for on-device mode (Termux).
+ * Uses KVM hardware acceleration when available (/dev/kvm) for near-native
+ * performance. Manages disk images, VM boot/shutdown, and ADB port forwarding
+ * to guest VMs.
+ *
+ * These tools complement the existing AVD emulator tools:
+ * - AVD tools (emulator.ts): manage Android SDK emulators on desktop
+ * - QEMU tools (this file): manage hardware-accelerated VMs on-device
+ *
+ * Images are stored in {tempDir}/qemu-images/.
+ * QEMU must be installed via Termux: pkg install qemu-system-aarch64-headless
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerQemuTools(ctx: ToolContext): void;
+//# sourceMappingURL=qemu.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qemu.d.ts","sourceRoot":"","sources":["../../src/tools/qemu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAiNjD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAyqBxD"}