deepadb 1.1.1 → 1.1.3

package/build/tools/forwarding.js

@@ -1,18 +1,97 @@
+// Copyright 2026 Jason <fullread@github>
+// SPDX-License-Identifier: Apache-2.0
 /**
  * Port Forwarding Tools — TCP port mapping between host and device.
  * Wraps adb forward and adb reverse for network debugging.
  */
 import { z } from "zod";
+import { randomBytes } from "crypto";
+import { createServer } from "net";
 import { OutputProcessor } from "../middleware/output-processor.js";
+import { registerCleanup } from "../middleware/cleanup.js";
+const trackedForwards = new Set();
+let forwardCleanupRegistered = false;
+function ensureForwardCleanupRegistered(ctx) {
+    if (forwardCleanupRegistered)
+        return;
+    registerCleanup("forwarding", async () => {
+        for (const fwd of trackedForwards) {
+            try {
+                const args = fwd.kind === "forward"
+                    ? ["forward", "--remove", fwd.spec]
+                    : ["reverse", "--remove", fwd.spec];
+                await ctx.bridge.exec(args, { device: fwd.device, ignoreExitCode: true, timeout: 3000 });
+            }
+            catch { /* best-effort on shutdown */ }
+        }
+        trackedForwards.clear();
+    });
+    forwardCleanupRegistered = true;
+}
+/**
+ * AF2 fix: format regex for adb forward / reverse specs.
+ *
+ * Accepted forms (all from adb documentation):
+ *   tcp:<port>             — TCP port (1-65535 enforced by separate parse)
+ *   localabstract:<name>   — Linux abstract socket namespace
+ *   localreserved:<name>   — Linux reserved socket namespace
+ *   localfilesystem:<path> — Filesystem socket
+ *   dev:<path>             — Character device
+ *   jdwp:<pid>             — Java debug wire protocol (pid)
+ *
+ * Body characters intentionally restricted to [A-Za-z0-9_./-] so an operator
+ * cannot smuggle shell metacharacters via a forward spec. ADB itself will
+ * range-check the numeric values; this regex is a defense-in-depth at the
+ * tool boundary.
+ */
+const FORWARD_SPEC_RE = /^(tcp:\d{1,5}|localabstract:[A-Za-z0-9_./-]+|localreserved:[A-Za-z0-9_./-]+|localfilesystem:[A-Za-z0-9_./-]+|dev:[A-Za-z0-9_./-]+|jdwp:\d+)$/;
+const tunnels = new Map();
+/**
+ * Generate an opaque tunnel ID. Format: tun_XXXXXX (6 hex chars from
+ * randomBytes, ~16M space, collision-free within any realistic session).
+ * Opaque so operators don't try to parse it; metadata is surfaced by
+ * adb_tunnel_list.
+ */
+function generateTunnelId() {
+    return "tun_" + randomBytes(3).toString("hex");
+}
+/**
+ * Find a free TCP port on the host. Uses net.createServer().listen(0)
+ * which asks the OS to bind any available port, then immediately closes
+ * the listener and returns the port the OS picked. The window between
+ * close and the caller's subsequent bind is a TOCTOU race in theory but
+ * in practice the kernel doesn't immediately re-hand-out a just-released
+ * port, so this is the standard cross-platform free-port-pick idiom.
+ * Returns 0 if the helper itself fails (caller should treat as error).
+ */
+function pickFreeHostPort() {
+    return new Promise((resolve, reject) => {
+        const srv = createServer();
+        srv.unref();
+        srv.on("error", reject);
+        srv.listen(0, "127.0.0.1", () => {
+            const addr = srv.address();
+            if (addr && typeof addr === "object") {
+                const port = addr.port;
+                srv.close(() => resolve(port));
+            }
+            else {
+                srv.close(() => reject(new Error("Failed to obtain port from server.address()")));
+            }
+        });
+    });
+}
 export function registerForwardingTools(ctx) {
     ctx.server.tool("adb_forward", "Forward a local port to a port on the device (host → device). Use for connecting to services running on the device.", {
-        local: z.string().describe("Local (host) spec, e.g., 'tcp:8080'"),
-        remote: z.string().describe("Remote (device) spec, e.g., 'tcp:8080' or 'localabstract:app_socket'"),
+        local: z.string().regex(FORWARD_SPEC_RE, "Spec must be one of tcp:<port>, localabstract:<name>, localreserved:<name>, localfilesystem:<path>, dev:<path>, jdwp:<pid>").describe("Local (host) spec, e.g., 'tcp:8080'. AF2 fix: format-validated."),
+        remote: z.string().regex(FORWARD_SPEC_RE, "Spec must be one of tcp:<port>, localabstract:<name>, localreserved:<name>, localfilesystem:<path>, dev:<path>, jdwp:<pid>").describe("Remote (device) spec, e.g., 'tcp:8080' or 'localabstract:app_socket'. AF2 fix: format-validated."),
         device: z.string().optional().describe("Device serial"),
     }, async ({ local, remote, device }) => {
         try {
             const resolved = await ctx.deviceManager.resolveDevice(device);
+            ensureForwardCleanupRegistered(ctx);
             const result = await ctx.bridge.exec(["forward", local, remote], { device: resolved.serial });
+            trackedForwards.add({ device: resolved.serial, spec: local, kind: "forward" });
             return { content: [{ type: "text", text: result.stdout.trim() || `Forwarding ${local} → ${remote}` }] };
         }
         catch (error) {
@@ -20,13 +99,15 @@ export function registerForwardingTools(ctx) {
         }
     });
     ctx.server.tool("adb_reverse", "Reverse-forward a device port to a port on the host (device → host). Use for letting device apps reach services on your machine.", {
-        remote: z.string().describe("Remote (device) spec, e.g., 'tcp:3000'"),
-        local: z.string().describe("Local (host) spec, e.g., 'tcp:3000'"),
+        remote: z.string().regex(FORWARD_SPEC_RE, "Spec must be one of tcp:<port>, localabstract:<name>, localreserved:<name>, localfilesystem:<path>, dev:<path>, jdwp:<pid>").describe("Remote (device) spec, e.g., 'tcp:3000'. AF2 fix: format-validated."),
+        local: z.string().regex(FORWARD_SPEC_RE, "Spec must be one of tcp:<port>, localabstract:<name>, localreserved:<name>, localfilesystem:<path>, dev:<path>, jdwp:<pid>").describe("Local (host) spec, e.g., 'tcp:3000'. AF2 fix: format-validated."),
         device: z.string().optional().describe("Device serial"),
     }, async ({ remote, local, device }) => {
         try {
             const resolved = await ctx.deviceManager.resolveDevice(device);
+            ensureForwardCleanupRegistered(ctx);
             const result = await ctx.bridge.exec(["reverse", remote, local], { device: resolved.serial });
+            trackedForwards.add({ device: resolved.serial, spec: remote, kind: "reverse" });
             return { content: [{ type: "text", text: result.stdout.trim() || `Reverse forwarding ${remote} → ${local}` }] };
         }
         catch (error) {
@@ -65,7 +146,7 @@ export function registerForwardingTools(ctx) {
         }
     });
     ctx.server.tool("adb_forward_remove", "Remove a port forward (host → device), or all forwards. Use after testing to clean up.", {
-        local: z.string().optional().describe("Local spec to remove (e.g., 'tcp:8080'). Omit to remove all forwards."),
+        local: z.string().regex(FORWARD_SPEC_RE, "Spec must be one of tcp:<port>, localabstract:<name>, localreserved:<name>, localfilesystem:<path>, dev:<path>, jdwp:<pid>").optional().describe("Local spec to remove (e.g., 'tcp:8080'). Omit to remove all forwards. AF2 fix: format-validated."),
         device: z.string().optional().describe("Device serial"),
     }, async ({ local, device }) => {
         try {
@@ -82,7 +163,7 @@ export function registerForwardingTools(ctx) {
         }
     });
     ctx.server.tool("adb_reverse_remove", "Remove a reverse forward (device → host), or all reverse forwards. Use after testing to clean up.", {
-        remote: z.string().optional().describe("Remote spec to remove (e.g., 'tcp:3000'). Omit to remove all reverse forwards."),
+        remote: z.string().regex(FORWARD_SPEC_RE, "Spec must be one of tcp:<port>, localabstract:<name>, localreserved:<name>, localfilesystem:<path>, dev:<path>, jdwp:<pid>").optional().describe("Remote spec to remove (e.g., 'tcp:3000'). Omit to remove all reverse forwards. AF2 fix: format-validated."),
         device: z.string().optional().describe("Device serial"),
     }, async ({ remote, device }) => {
         try {
@@ -98,5 +179,166 @@ export function registerForwardingTools(ctx) {
             return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
         }
     });
+    // ═══════════════════════════════════════════════════════════════════
+    // Tunnel automation (adb_tunnel_open / list / close)
+    //
+    // High-level wrappers over adb_forward / adb_reverse. Each open
+    // returns an opaque `tun_XXXXXX` ID that close can reference, so
+    // operators don't have to remember the spec they passed to forward.
+    // Hooks into the existing AF4 cleanup path (trackedForwards Set)
+    // so server shutdown removes managed tunnels automatically.
+    // ═══════════════════════════════════════════════════════════════════
+    ctx.server.tool("adb_tunnel_open", "Open a managed tunnel between host and device. Higher-level convenience wrapper over adb_forward / adb_reverse: auto-picks a free host port when one isn't specified (forward only), returns an opaque tunnel ID for later close, and registers cleanup so the tunnel is removed on server exit. Direction 'forward' = host port forwards TO device service; 'reverse' = device port forwards TO host service.", {
+        direction: z.enum(["forward", "reverse"])
+            .describe("'forward' (host → device) or 'reverse' (device → host)"),
+        deviceSpec: z.string().regex(FORWARD_SPEC_RE, "Spec must be one of tcp:<port>, localabstract:<name>, localreserved:<name>, localfilesystem:<path>, dev:<path>, jdwp:<pid>")
+            .describe("Device-side spec, e.g., 'tcp:3000' or 'localabstract:app_socket'"),
+        hostSpec: z.string().regex(FORWARD_SPEC_RE, "Spec must be one of tcp:<port>, localabstract:<name>, localreserved:<name>, localfilesystem:<path>, dev:<path>, jdwp:<pid>").optional()
+            .describe("Host-side spec, e.g., 'tcp:8080'. For 'forward' direction: omit to auto-pick a free host port. For 'reverse' direction: required (can't auto-pick device-side ports without an extra probe call)."),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ direction, deviceSpec, hostSpec, device }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            ensureForwardCleanupRegistered(ctx);
+            // Resolve hostSpec: auto-pick free port for forward + omitted; require for reverse.
+            let effectiveHostSpec = hostSpec;
+            if (!effectiveHostSpec) {
+                if (direction === "reverse") {
+                    return { content: [{ type: "text", text: "hostSpec is required for direction='reverse'. Auto-pick is supported only for 'forward' (host-side port). For reverse, specify the host endpoint explicitly (e.g., hostSpec: 'tcp:3000')." }], isError: true };
+                }
+                const port = await pickFreeHostPort();
+                effectiveHostSpec = "tcp:" + port;
+            }
+            // Build adb args. For forward: adb forward LOCAL REMOTE. For reverse: adb reverse REMOTE LOCAL.
+            // The order in the adb CLI is "device side first" for reverse, "host side first" for forward.
+            const args = direction === "forward"
+                ? ["forward", effectiveHostSpec, deviceSpec]
+                : ["reverse", deviceSpec, effectiveHostSpec];
+            await ctx.bridge.exec(args, { device: resolved.serial });
+            // Register for AF4 cleanup-on-exit. trackedForwards.spec is the
+            // arg passed to --remove, which for forward is the host spec and
+            // for reverse is the device spec.
+            const removeSpec = direction === "forward" ? effectiveHostSpec : deviceSpec;
+            trackedForwards.add({ device: resolved.serial, spec: removeSpec, kind: direction });
+            // Generate ID + store metadata for ID-based close + list.
+            const id = generateTunnelId();
+            tunnels.set(id, {
+                id,
+                device: resolved.serial,
+                direction,
+                hostSpec: effectiveHostSpec,
+                deviceSpec,
+                createdAt: Date.now(),
+            });
+            const lines = [
+                `Tunnel opened: ${id}`,
+                `  device: ${resolved.serial}`,
+                `  direction: ${direction}`,
+                `  host: ${effectiveHostSpec}${hostSpec ? "" : " (auto-picked)"}`,
+                `  device: ${deviceSpec}`,
+                "",
+                `Use adb_tunnel_close with id=${id} to remove. Tunnel will also be auto-removed on server shutdown.`,
+            ];
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_tunnel_list", "List all active managed tunnels (opened via adb_tunnel_open). Shows tunnel ID, device, direction, and both endpoints. Note: this only surfaces tunnels created via adb_tunnel_open — tunnels created via the low-level adb_forward / adb_reverse won't appear here. For those, use adb_forward_list.", {
+        device: z.string().optional().describe("Filter to a specific device serial (default: all devices)"),
+    }, async ({ device }) => {
+        try {
+            // device param is a filter — don't resolveDevice (it'd require a connected device).
+            const filtered = device
+                ? [...tunnels.values()].filter((t) => t.device === device)
+                : [...tunnels.values()];
+            if (filtered.length === 0) {
+                return { content: [{ type: "text", text: device
+                                ? `No managed tunnels open for device ${device}. (Use adb_forward_list for tunnels not created via adb_tunnel_open.)`
+                                : "No managed tunnels open. (Use adb_forward_list for tunnels not created via adb_tunnel_open.)" }] };
+            }
+            // Sort by createdAt for stable, predictable output.
+            filtered.sort((a, b) => a.createdAt - b.createdAt);
+            const lines = [`${filtered.length} managed tunnel(s):`, ""];
+            for (const t of filtered) {
+                const ageSec = Math.round((Date.now() - t.createdAt) / 1000);
+                lines.push(`  ${t.id}  [${t.direction}]  device=${t.device}`);
+                lines.push(`    host:   ${t.hostSpec}`);
+                lines.push(`    device: ${t.deviceSpec}`);
+                lines.push(`    age:    ${ageSec}s`);
+                lines.push("");
+            }
+            return { content: [{ type: "text", text: lines.join("\n").trimEnd() }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_tunnel_close", "Close a managed tunnel by ID, or all managed tunnels at once. The corresponding adb forward/reverse entry is removed and the tunnel is dropped from the cleanup registry. Use adb_tunnel_list to see active tunnel IDs.", {
+        id: z.string().describe("Tunnel ID (tun_XXXXXX) returned by adb_tunnel_open, or the literal string 'all' to close every managed tunnel."),
+    }, async ({ id }) => {
+        try {
+            if (id === "all") {
+                if (tunnels.size === 0) {
+                    return { content: [{ type: "text", text: "No managed tunnels to close." }] };
+                }
+                const all = [...tunnels.values()];
+                let closed = 0;
+                const failures = [];
+                for (const t of all) {
+                    try {
+                        const args = t.direction === "forward"
+                            ? ["forward", "--remove", t.hostSpec]
+                            : ["reverse", "--remove", t.deviceSpec];
+                        await ctx.bridge.exec(args, { device: t.device, ignoreExitCode: true, timeout: 5000 });
+                        // Drop from both maps.
+                        tunnels.delete(t.id);
+                        for (const fwd of trackedForwards) {
+                            if (fwd.device === t.device && fwd.kind === t.direction &&
+                                fwd.spec === (t.direction === "forward" ? t.hostSpec : t.deviceSpec)) {
+                                trackedForwards.delete(fwd);
+                                break;
+                            }
+                        }
+                        closed++;
+                    }
+                    catch (err) {
+                        failures.push(`${t.id}: ${err instanceof Error ? err.message : err}`);
+                    }
+                }
+                const lines = [`Closed ${closed} of ${all.length} managed tunnel(s).`];
+                if (failures.length > 0) {
+                    lines.push("");
+                    lines.push("Failures:");
+                    for (const f of failures)
+                        lines.push("  " + f);
+                }
+                return { content: [{ type: "text", text: lines.join("\n") }] };
+            }
+            // Single-ID close.
+            const t = tunnels.get(id);
+            if (!t) {
+                return { content: [{ type: "text", text: `No managed tunnel with id='${id}'. Use adb_tunnel_list to see active tunnels.` }], isError: true };
+            }
+            const args = t.direction === "forward"
+                ? ["forward", "--remove", t.hostSpec]
+                : ["reverse", "--remove", t.deviceSpec];
+            await ctx.bridge.exec(args, { device: t.device, ignoreExitCode: true, timeout: 5000 });
+            tunnels.delete(t.id);
+            // Drop from trackedForwards too — match by device + kind + spec.
+            for (const fwd of trackedForwards) {
+                if (fwd.device === t.device && fwd.kind === t.direction &&
+                    fwd.spec === (t.direction === "forward" ? t.hostSpec : t.deviceSpec)) {
+                    trackedForwards.delete(fwd);
+                    break;
+                }
+            }
+            return { content: [{ type: "text", text: `Tunnel ${id} closed (${t.direction}, host=${t.hostSpec}, device=${t.deviceSpec}).` }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
 }
 //# sourceMappingURL=forwarding.js.map

package/build/tools/forwarding.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA+G1D"}
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAuH1D"}

package/build/tools/health.js

@@ -1,9 +1,12 @@
+// Copyright 2026 Jason <fullread@github>
+// SPDX-License-Identifier: Apache-2.0
 /**
  * Health Check Tools — Validate the ADB chain and diagnose connection issues.
  * Runs through: ADB binary → ADB server → device connection → authorization.
  */
 import { z } from "zod";
 import { existsSync } from "fs";
+import { shellQuote } from "../middleware/sanitize.js";
 import { isOnDevice } from "../config/config.js";
 export function registerHealthTools(ctx) {
     ctx.server.tool("adb_health_check", "Run a comprehensive health check of the ADB toolchain. Validates: ADB binary, server, device connection, authorization, and root access.", { device: z.string().optional().describe("Device serial to check (optional)") }, async ({ device }) => {
@@ -34,7 +37,6 @@ export function registerHealthTools(ctx) {
         }
         catch (error) {
             checks.push(`✗ ADB server: unreachable — ${error instanceof Error ? error.message : error}`);
-            allPassed = false;
             checks.push("\n--- Health check aborted: ADB server must be running ---");
             return { content: [{ type: "text", text: checks.join("\n") }], isError: true };
         }
@@ -87,7 +89,16 @@ export function registerHealthTools(ctx) {
                 checks.push("○ Root access: not available (non-critical)");
             }
             // Temp dir writable
-            const tempCheck = await ctx.bridge.shell('touch /sdcard/.DA_health_check && rm /sdcard/.DA_health_check && echo OK', {
+            // AG1 fix: include PID + timestamp + random suffix in the probe filename
+            // so two concurrent health checks (from different DeepADB processes
+            // sharing the same device) don't race on a fixed path. The race is
+            // benign — both succeed since touch+rm is idempotent — but if one
+            // process's rm runs between the other's touch and rm, the OK echo
+            // could fire incorrectly. Using a per-invocation unique name eliminates
+            // the cross-process interleaving entirely.
+            const probeId = `${process.pid}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+            const probePath = `/sdcard/.DA_health_check_${probeId}`;
+            const tempCheck = await ctx.bridge.shell(`touch ${shellQuote(probePath)} && rm ${shellQuote(probePath)} && echo OK`, {
                 device: resolved.serial, ignoreExitCode: true,
             });
             if (tempCheck.stdout.includes("OK")) {
@@ -98,7 +109,7 @@ export function registerHealthTools(ctx) {
                 allPassed = false;
             }
         }
-        catch (error) {
+        catch {
             // No target device — already reported above
             if (!device) {
                 checks.push("\n○ No target device to deep-check (expected if no device connected)");

package/build/tools/health.js.map

@@ -1 +1 @@
-{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,UAAU,mBAAmB,CAAC,GAAgB;IAElD,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,kBAAkB,EAClB,0IAA0I,EAC1I,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC,EAAE,EAC/E,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,SAAS,GAAG,IAAI,CAAC;QAErB,0DAA0D;QAC1D,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;YACnC,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;YACjD,CAAC;iBAAM,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;gBACrD,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7F,SAAS,GAAG,KAAK,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjF,CAAC;QAED,sBAAsB;QACtB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;YACtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;YAC3D,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;YAE7D,MAAM,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,MAAM,WAAW,MAAM,CAAC,MAAM,YAAY,YAAY,CAAC,MAAM,kBAAkB,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;YAElJ,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC9D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5E,CAAC;YAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,SAAS,GAAG,KAAK,CAAC;gBAClB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;gBAClF,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;gBACjF,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5F,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,wBAAwB,QAAQ,CAAC,MAAM,MAAM,CAAC,CAAC;YAE3D,aAAa;YACb,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1G,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACtG,MAAM,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAErF,aAAa;YACb,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE;oBACpD,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI;iBAC7D,CAAC,CAAC;gBACH,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBACxC,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;gBAC1C,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAC7D,CAAC;YAED,oBAAoB;YACpB,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,0EAA0E,EAAE;gBACnH,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI;aAC9C,CAAC,CAAC;YACH,IAAI,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;gBACtD,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;QAEH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,4CAA4C;YAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;QAED,UAAU;QACV,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,kCAAkC,EAAE,CAAC,CAAC;QACjG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAClE,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,sCAAsC;AACtC;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,UAAU,mBAAmB,CAAC,GAAgB;IAElD,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,kBAAkB,EAClB,0IAA0I,EAC1I,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC,EAAE,EAC/E,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,SAAS,GAAG,IAAI,CAAC;QAErB,0DAA0D;QAC1D,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;YACnC,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;YACjD,CAAC;iBAAM,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;gBACrD,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7F,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjF,CAAC;QAED,sBAAsB;QACtB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;YACtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;YAC3D,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;YAE7D,MAAM,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,MAAM,WAAW,MAAM,CAAC,MAAM,YAAY,YAAY,CAAC,MAAM,kBAAkB,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;YAElJ,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC9D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5E,CAAC;YAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,SAAS,GAAG,KAAK,CAAC;gBAClB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;gBAClF,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;gBACjF,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5F,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,wBAAwB,QAAQ,CAAC,MAAM,MAAM,CAAC,CAAC;YAE3D,aAAa;YACb,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1G,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACtG,MAAM,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAErF,aAAa;YACb,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE;oBACpD,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI;iBAC7D,CAAC,CAAC;gBACH,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBACxC,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;gBAC1C,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAC7D,CAAC;YAED,oBAAoB;YACpB,yEAAyE;YACzE,oEAAoE;YACpE,mEAAmE;YACnE,kEAAkE;YAClE,kEAAkE;YAClE,wEAAwE;YACxE,2CAA2C;YAC3C,MAAM,OAAO,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACzF,MAAM,SAAS,GAAG,4BAA4B,OAAO,EAAE,CAAC;YACxD,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,UAAU,CAAC,SAAS,CAAC,UAAU,UAAU,CAAC,SAAS,CAAC,aAAa,EAAE;gBACnH,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI;aAC9C,CAAC,CAAC;YACH,IAAI,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;gBACtD,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;QAEH,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;YAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;QAED,UAAU;QACV,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,kCAAkC,EAAE,CAAC,CAAC;QACjG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAClE,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/input-gestures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-gestures.d.ts","sourceRoot":"","sources":["../../src/tools/input-gestures.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOjD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA4pChE"}
+{"version":3,"file":"input-gestures.d.ts","sourceRoot":"","sources":["../../src/tools/input-gestures.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOjD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA0sChE"}

package/build/tools/input-gestures.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Jason <fullread@github>
+// SPDX-License-Identifier: Apache-2.0
 /**
  * Input Gestures, UI Automation & Device Awareness Tools.
  *
@@ -8,9 +10,9 @@
  */
 import { z } from "zod";
 import { OutputProcessor } from "../middleware/output-processor.js";
-import { shellEscape } from "../middleware/sanitize.js";
+import { shellQuote } from "../middleware/sanitize.js";
+import { sanitizeFilenameComponentDotted } from "../middleware/fs-utils.js";
 import { captureUiDump, parseUiNodes } from "../middleware/ui-dump.js";
-import { isOnDevice } from "../config/config.js";
 import { join } from "path";
 export function registerInputGestureTools(ctx) {
     ctx.server.tool("adb_input_drag", "Drag from one point to another on screen. Uses Android's draganddrop input command. Useful for drag-and-drop UI elements, sliders, map panning, and reorder operations.", {
@@ -101,7 +103,7 @@ export function registerInputGestureTools(ctx) {
             // Android's input text treats spaces as argument separators — must use %s
             // Also need to escape shell special characters
             const escaped = text.replace(/ /g, "%s");
-            const shellCmd = `input text '${shellEscape(escaped)}'`;
+            const shellCmd = `input text ${shellQuote(escaped)}`;
             await ctx.bridge.shell(shellCmd, { device: resolved.serial, ignoreExitCode: true });
             return { content: [{ type: "text", text: `Typed ${text.length} character(s)` }] };
         }
@@ -110,12 +112,12 @@ export function registerInputGestureTools(ctx) {
         }
     });
     ctx.server.tool("adb_open_url", "Open a URL on the device in the default browser or handling app. Uses Android's VIEW intent action.", {
-        url: z.string().url().describe("URL to open (must be a valid URL with scheme)"),
+        url: z.url().describe("URL to open (must be a valid URL with scheme)"),
         device: z.string().optional().describe("Device serial"),
     }, async ({ url, device }) => {
         try {
             const resolved = await ctx.deviceManager.resolveDevice(device);
-            const result = await ctx.bridge.shell(`am start -a android.intent.action.VIEW -d '${shellEscape(url)}'`, { device: resolved.serial, ignoreExitCode: true });
+            const result = await ctx.bridge.shell(`am start -a android.intent.action.VIEW -d ${shellQuote(url)}`, { device: resolved.serial, ignoreExitCode: true });
             const output = result.stdout.trim();
             if (output.includes("Error") || output.includes("Exception")) {
                 return { content: [{ type: "text", text: `Failed to open URL: ${output}` }], isError: true };
@@ -179,12 +181,55 @@ export function registerInputGestureTools(ctx) {
                     return { content: [{ type: "text", text: "text parameter is required when action='write'" }], isError: true };
                 }
                 // Use am broadcast to set clipboard via a helper — this is the most reliable cross-version approach
-                await ctx.bridge.shell(`am broadcast -a clipper.set -e text '${shellEscape(text)}'`, { device: serial, ignoreExitCode: true });
+                await ctx.bridge.shell(`am broadcast -a clipper.set -e text ${shellQuote(text)}`, { device: serial, ignoreExitCode: true });
                 // Fallback: use service call if clipper app isn't installed
                 // service call clipboard 2 (SET_PRIMARY_CLIP) requires parcel construction
                 // For simplicity, also try the settings-based approach
-                await ctx.bridge.shell(`input keyevent --longpress KEYCODE_UNKNOWN 2>/dev/null; settings put system clipboard_text '${shellEscape(text)}' 2>/dev/null`, { device: serial, ignoreExitCode: true });
-                return { content: [{ type: "text", text: `Clipboard set (${text.length} chars). Note: if no clipper app is installed, use 'input text' as alternative.` }] };
+                await ctx.bridge.shell(`input keyevent --longpress KEYCODE_UNKNOWN 2>/dev/null; settings put system clipboard_text ${shellQuote(text)} 2>/dev/null`, { device: serial, ignoreExitCode: true });
+                // AH7 fix: read-back verification. Previously the tool reported
+                // "Clipboard set" even when BOTH fallback writes failed silently
+                // (no clipper app + Android 12+ blocking settings put). Now we
+                // immediately read the clipboard back and surface success/failure
+                // honestly. The read uses the same dumpsys / service call methods
+                // as the read action below — duplicated here to avoid moving the
+                // methods array above the function structure.
+                //
+                // Caveats this verification cannot catch: (1) On Android 12+ the
+                // clipboard requires the requesting app to be in the foreground,
+                // and adb shell isn't a foreground app, so read-back may fail even
+                // if write succeeded for foreground consumers. We surface that as
+                // an explicit "could not verify" rather than a hard failure.
+                let verified = null;
+                const verifyMethods = [
+                    { cmd: "dumpsys clipboard | grep -A 2 'mPrimaryClip'", parse: (s) => {
+                            const m = s.match(/Text\s*\{(.+?)\}/);
+                            return m ? m[1] : null;
+                        } },
+                    { cmd: "service call clipboard 1 2>/dev/null", parse: (s) => {
+                            const parts = s.match(/'([^']*)'/g);
+                            return parts ? parts.map(p => p.replace(/'/g, "").replace(/\.\s*$/g, "")).join("") : null;
+                        } },
+                ];
+                for (const method of verifyMethods) {
+                    try {
+                        const result = await ctx.bridge.shell(method.cmd, { device: serial, timeout: 3000, ignoreExitCode: true });
+                        const parsed = method.parse(result.stdout);
+                        if (parsed && parsed.trim().length > 0) {
+                            verified = parsed;
+                            break;
+                        }
+                    }
+                    catch { /* try next */ }
+                }
+                if (verified === text) {
+                    return { content: [{ type: "text", text: `Clipboard set (${text.length} chars). Verified: read-back matches.` }] };
+                }
+                else if (verified !== null && verified !== text) {
+                    return { content: [{ type: "text", text: `Clipboard write may have partially failed: wrote ${text.length} chars but read back ${verified.length} chars of different content. Some apps may have own clipboard implementations.` }], isError: true };
+                }
+                else {
+                    return { content: [{ type: "text", text: `Clipboard write attempted (${text.length} chars) but read-back returned empty — could not verify. On Android 12+, this is normal: the clipboard requires a foreground app to read. The write may still have succeeded; try paste in a foreground app to confirm. If pasting also yields empty, no clipper helper is installed.` }] };
+                }
             }
             // action === "read"
             // Try multiple methods to read clipboard
@@ -452,7 +497,7 @@ export function registerInputGestureTools(ctx) {
         }
     });
     // ── Batch 3: Efficiency Features ──────────────────────────────────────
-    ctx.server.tool("adb_screenshot_compressed", "Take a screenshot and compress it for reduced file size and LLM token usage. Captures at full resolution then uses device-side conversion to produce a smaller JPEG. Returns the local file path. Ideal for iterative UI testing where token cost matters.", {
+    ctx.server.tool("adb_screenshot_compressed", "Take a screenshot and pull the full-resolution PNG, plus metadata for client-side compression. Returns local file path, dimensions, file size, and a ready-to-run imagemagick command for converting to a smaller JPEG. (Android doesn't ship imagemagick, so the actual compression is post-processing — this tool sets up everything you need.)", {
         quality: z.number().int().min(10).max(100).optional().default(50)
             .describe("JPEG quality (10-100, default 50). Lower = smaller file, more artifacts"),
         scale: z.number().min(0.1).max(1.0).optional().default(0.5)
@@ -463,13 +508,13 @@ export function registerInputGestureTools(ctx) {
         try {
             const resolved = await ctx.deviceManager.resolveDevice(device);
             const serial = resolved.serial;
-            const remoteDir = isOnDevice() ? "/data/local/tmp" : "/sdcard";
+            const remoteDir = "/data/local/tmp";
             const timestamp = Date.now();
             const remotePng = `${remoteDir}/DA_cap_${timestamp}.png`;
             const remoteJpg = `${remoteDir}/DA_cap_${timestamp}.jpg`;
             // Sanitize filename
             const outName = filename
-                ? filename.replace(/[^a-zA-Z0-9._-]/g, "_")
+                ? sanitizeFilenameComponentDotted(filename)
                 : `screenshot_compressed_${timestamp}.jpg`;
             const localPath = join(ctx.config.tempDir, outName);
             try {
@@ -511,7 +556,7 @@ export function registerInputGestureTools(ctx) {
     ctx.server.tool("adb_batch_actions", "Execute multiple input actions in a single tool call. Reduces ADB round-trips for multi-step UI interactions. Each action runs sequentially with an optional delay between them. Supported action types: tap, swipe, fling, long_press, double_tap, keyevent, text, drag, pinch, back, home, sleep.", {
         actions: z.array(z.object({
             type: z.enum(["tap", "swipe", "fling", "long_press", "double_tap", "keyevent", "text", "drag", "pinch", "back", "home", "sleep"])
-                .describe("Action type"),
+                .describe("Action type — one of: tap, swipe, fling, long_press, double_tap, keyevent, text, drag, pinch, back, home, sleep. The args field documents the expected argument format per type."),
             args: z.string().optional()
                 .describe("Action arguments: tap='x y', swipe='x1 y1 x2 y2 [ms]', fling='x1 y1 x2 y2 [ms]', long_press='x y [ms]', double_tap='x y', keyevent='KEYCODE_*', text='string', drag='x1 y1 x2 y2 [ms]', pinch='cx cy startRadius endRadius [durationMs]', sleep='ms', back/home=none"),
         })).min(1).max(50).describe("Array of actions to execute (1-50)"),
@@ -581,7 +626,7 @@ export function registerInputGestureTools(ctx) {
                             cmd = `input keyevent ${args}`;
                             break;
                         case "text":
-                            cmd = `input text '${shellEscape(args.replace(/ /g, "%s"))}'`;
+                            cmd = `input text ${shellQuote(args.replace(/ /g, "%s"))}`;
                             break;
                         case "drag":
                             if (!/^[\d\s]+$/.test(args))
@@ -605,6 +650,13 @@ export function registerInputGestureTools(ctx) {
                             const pf2sy = Math.round(pcy - psr * Math.sin(prad));
                             const pf2ex = Math.round(pcx - per * Math.cos(prad));
                             const pf2ey = Math.round(pcy - per * Math.sin(prad));
+                            // AH11 note: the bare & here is INTENTIONAL, not a typo or shell-
+                            // injection vector. Pinch/spread requires two input swipe commands
+                            // running in parallel so both fingers move simultaneously; the &
+                            // backgrounds the first while the second runs. All coordinate
+                            // values were validated against /^[\d\s]+$/ above (pure digits +
+                            // whitespace), so there's no operator-supplied content here that
+                            // could exploit the & — only validated integers from parseInt.
                             cmd = `input swipe ${pf1sx} ${pf1sy} ${pf1ex} ${pf1ey} ${pdur} & input swipe ${pf2sx} ${pf2sy} ${pf2ex} ${pf2ey} ${pdur}`;
                             break;
                         }