deepadb 1.0.0

package/build/middleware/sanitize.js

@@ -0,0 +1,46 @@
+/**
+ * Input Sanitization — Shell injection prevention for ADB command construction.
+ *
+ * Tools that interpolate user-supplied parameters into shell command strings
+ * must validate those parameters before passing them to bridge.shell().
+ * This module provides validation for common parameter types.
+ */
+/** Characters that are dangerous in shell command interpolation. */
+const SHELL_METACHARACTERS = /[;|&$`(){}<>!\n\r\\'"]/;
+/**
+ * Validate that a string is safe to interpolate into a shell command.
+ * Rejects strings containing shell metacharacters that could enable injection.
+ *
+ * Use for: package names, property keys, service names, setting keys,
+ * test class names, runner names, interface names — any identifier that
+ * should never contain shell operators.
+ *
+ * Returns null if safe, or an error message string if unsafe.
+ */
+export function validateShellArg(value, paramName) {
+    if (SHELL_METACHARACTERS.test(value)) {
+        return `Invalid ${paramName}: contains shell metacharacters. Value must not include: ; | & $ \` ( ) { } < > ! \\ ' "`;
+    }
+    return null;
+}
+/**
+ * Escape a string for safe use inside single-quoted shell arguments.
+ * Handles the only character that can break single-quote context: the quote itself.
+ * Use for file paths, grep patterns, and any value interpolated into shell commands
+ * within single quotes.
+ */
+export function shellEscape(str) {
+    return str.replace(/'/g, "'\\''");
+}
+/**
+ * Validate multiple arguments at once. Returns the first error found, or null if all pass.
+ */
+export function validateShellArgs(args) {
+    for (const [value, paramName] of args) {
+        const error = validateShellArg(value, paramName);
+        if (error)
+            return error;
+    }
+    return null;
+}
+//# sourceMappingURL=sanitize.js.map

package/build/middleware/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/middleware/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oEAAoE;AACpE,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAEtD;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,SAAiB;IAC/D,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,WAAW,SAAS,0FAA0F,CAAC;IACxH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA6B;IAC7D,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACjD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/build/middleware/security.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Security Middleware — Command filtering, rate limiting, and audit logging.
+ *
+ * Provides configurable security controls for DeepADB.
+ * Currently opt-in: tools and the bridge can consult this middleware
+ * before executing commands. Can be tightened for production deployments.
+ *
+ * Enable via environment variable: DA_SECURITY=true
+ */
+import { Logger } from "./logger.js";
+export interface SecurityConfig {
+    /** Enable security enforcement (default: false in dev, true recommended for shared use) */
+    enabled: boolean;
+    /** Shell commands that are always blocked (substring match) */
+    blockedCommands: string[];
+    /** If set, only these shell commands are allowed (substring match). Empty = allow all. */
+    allowedCommands: string[];
+    /** Maximum commands per minute (0 = unlimited) */
+    rateLimit: number;
+    /** Enable audit logging of all commands */
+    auditLog: boolean;
+}
+export declare class SecurityMiddleware {
+    private config;
+    private logger;
+    private rateBucket;
+    constructor(logger: Logger);
+    private parseList;
+    /**
+     * Check if a shell command is allowed to execute.
+     * Returns null if allowed, or an error message if blocked.
+     */
+    checkCommand(command: string, device?: string): string | null;
+    /**
+     * Log a completed command for audit trail.
+     */
+    logResult(command: string, success: boolean, device?: string): void;
+    /** Whether security enforcement is active. */
+    get isEnabled(): boolean;
+    /** Get current rate limit status. */
+    getRateStatus(): {
+        count: number;
+        limit: number;
+        windowRemaining: number;
+    };
+    /**
+     * Redact potentially sensitive content from commands before logging.
+     * Truncates long commands and masks common credential patterns.
+     */
+    private redactForLog;
+}
+//# sourceMappingURL=security.d.ts.map

package/build/middleware/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/middleware/security.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,WAAW,cAAc;IAC7B,2FAA2F;IAC3F,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,0FAA0F;IAC1F,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAOD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAqD;gBAE3D,MAAM,EAAE,MAAM;IAwB1B,OAAO,CAAC,SAAS;IAKjB;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA8C7D;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAOnE,8CAA8C;IAC9C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,qCAAqC;IACrC,aAAa,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;IAS1E;;;OAGG;IACH,OAAO,CAAC,YAAY;CAarB"}

package/build/middleware/security.js

@@ -0,0 +1,123 @@
+/**
+ * Security Middleware — Command filtering, rate limiting, and audit logging.
+ *
+ * Provides configurable security controls for DeepADB.
+ * Currently opt-in: tools and the bridge can consult this middleware
+ * before executing commands. Can be tightened for production deployments.
+ *
+ * Enable via environment variable: DA_SECURITY=true
+ */
+export class SecurityMiddleware {
+    config;
+    logger;
+    rateBucket = { count: 0, windowStart: Date.now() };
+    constructor(logger) {
+        this.logger = logger;
+        this.config = {
+            enabled: process.env.DA_SECURITY === "true",
+            blockedCommands: this.parseList(process.env.DA_BLOCKED_COMMANDS),
+            allowedCommands: this.parseList(process.env.DA_ALLOWED_COMMANDS),
+            rateLimit: parseInt(process.env.DA_RATE_LIMIT ?? "0", 10) || 0,
+            auditLog: process.env.DA_AUDIT_LOG === "true",
+        };
+        if (this.config.enabled) {
+            logger.info("Security middleware enabled");
+            if (this.config.blockedCommands.length > 0) {
+                logger.info(`Blocked commands: ${this.config.blockedCommands.join(", ")}`);
+            }
+            if (this.config.allowedCommands.length > 0) {
+                logger.info(`Allowlist active: ${this.config.allowedCommands.length} patterns`);
+            }
+            if (this.config.rateLimit > 0) {
+                logger.info(`Rate limit: ${this.config.rateLimit} commands/minute`);
+            }
+        }
+    }
+    parseList(value) {
+        if (!value)
+            return [];
+        return value.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+    }
+    /**
+     * Check if a shell command is allowed to execute.
+     * Returns null if allowed, or an error message if blocked.
+     */
+    checkCommand(command, device) {
+        // Audit log regardless of enforcement
+        if (this.config.auditLog) {
+            const deviceLabel = device ? ` [${device}]` : "";
+            this.logger.info(`[AUDIT]${deviceLabel} ${this.redactForLog(command)}`);
+        }
+        if (!this.config.enabled)
+            return null;
+        // Rate limiting
+        if (this.config.rateLimit > 0) {
+            const now = Date.now();
+            const windowMs = 60_000;
+            if (now - this.rateBucket.windowStart > windowMs) {
+                this.rateBucket = { count: 0, windowStart: now };
+            }
+            this.rateBucket.count++;
+            if (this.rateBucket.count > this.config.rateLimit) {
+                this.logger.warn(`Rate limit exceeded: ${this.rateBucket.count}/${this.config.rateLimit} per minute`);
+                return `Rate limit exceeded (${this.config.rateLimit} commands/minute). Wait before retrying.`;
+            }
+        }
+        // Blocklist check
+        const cmdLower = command.toLowerCase();
+        for (const blocked of this.config.blockedCommands) {
+            if (cmdLower.includes(blocked.toLowerCase())) {
+                this.logger.warn(`Blocked command: ${command} (matched: ${blocked})`);
+                return `Command blocked by security policy (matched: "${blocked}").`;
+            }
+        }
+        // Allowlist check (only if allowlist is non-empty)
+        if (this.config.allowedCommands.length > 0) {
+            const allowed = this.config.allowedCommands.some((pattern) => cmdLower.includes(pattern.toLowerCase()));
+            if (!allowed) {
+                this.logger.warn(`Command not in allowlist: ${command}`);
+                return "Command not in security allowlist.";
+            }
+        }
+        return null;
+    }
+    /**
+     * Log a completed command for audit trail.
+     */
+    logResult(command, success, device) {
+        if (!this.config.auditLog)
+            return;
+        const status = success ? "OK" : "FAIL";
+        const deviceLabel = device ? ` [${device}]` : "";
+        this.logger.info(`[AUDIT]${deviceLabel} ${status}: ${this.redactForLog(command)}`);
+    }
+    /** Whether security enforcement is active. */
+    get isEnabled() {
+        return this.config.enabled;
+    }
+    /** Get current rate limit status. */
+    getRateStatus() {
+        const elapsed = Date.now() - this.rateBucket.windowStart;
+        return {
+            count: this.rateBucket.count,
+            limit: this.config.rateLimit,
+            windowRemaining: Math.max(0, 60_000 - elapsed),
+        };
+    }
+    /**
+     * Redact potentially sensitive content from commands before logging.
+     * Truncates long commands and masks common credential patterns.
+     */
+    redactForLog(command) {
+        const MAX_LOG_LENGTH = 200;
+        // Mask common credential patterns
+        let redacted = command
+            .replace(/(?:password|passwd|token|secret|key|auth)([\s=:]+)\S+/gi, (_, sep) => `***${sep}***REDACTED***`)
+            .replace(/echo\s+["'].*?["']\s*>\s*/g, "echo '***' > ");
+        if (redacted.length > MAX_LOG_LENGTH) {
+            redacted = redacted.substring(0, MAX_LOG_LENGTH) + `... (${command.length} chars total)`;
+        }
+        return redacted;
+    }
+}
+//# sourceMappingURL=security.js.map

package/build/middleware/security.js.map

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

package/build/middleware/ui-dump.d.ts

@@ -0,0 +1,23 @@
+/**
+ * UI Dump Utilities — Shared uiautomator XML capture and attribute parsing.
+ *
+ * Used by ui.ts, accessibility.ts, and test-gen.ts to avoid duplicating
+ * the dump→cat→rm pattern and regex-based attribute extraction.
+ */
+import { AdbBridge } from "../bridge/adb-bridge.js";
+/**
+ * Pre-compiled regexes for uiautomator XML attribute extraction.
+ * Avoids creating new RegExp objects inside hot parsing loops.
+ */
+export declare const UI_ATTR_REGEXES: Record<string, RegExp>;
+/** Extract an attribute value from a uiautomator node attributes string. */
+export declare function getAttr(attrs: string, name: string): string;
+/**
+ * Capture the UI hierarchy XML from the device.
+ * Handles the dump → cat → cleanup sequence in one place.
+ * Uses a unique dump path per call to avoid collisions across concurrent tool invocations.
+ * Cleanup runs in a finally block to prevent device file leaks on errors.
+ * Returns the XML string, or null if the dump failed.
+ */
+export declare function captureUiDump(bridge: AdbBridge, serial: string, dumpPath?: string): Promise<string | null>;
+//# sourceMappingURL=ui-dump.d.ts.map

package/build/middleware/ui-dump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-dump.d.ts","sourceRoot":"","sources":["../../src/middleware/ui-dump.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAIpD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUlD,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB"}

package/build/middleware/ui-dump.js

@@ -0,0 +1,59 @@
+/**
+ * UI Dump Utilities — Shared uiautomator XML capture and attribute parsing.
+ *
+ * Used by ui.ts, accessibility.ts, and test-gen.ts to avoid duplicating
+ * the dump→cat→rm pattern and regex-based attribute extraction.
+ */
+import { isOnDevice } from "../config/config.js";
+import { shellEscape } from "./sanitize.js";
+/**
+ * Pre-compiled regexes for uiautomator XML attribute extraction.
+ * Avoids creating new RegExp objects inside hot parsing loops.
+ */
+export const UI_ATTR_REGEXES = {
+    "resource-id": /resource-id="([^"]*)"/,
+    "text": /\btext="([^"]*)"/,
+    "content-desc": /content-desc="([^"]*)"/,
+    "class": /\bclass="([^"]*)"/,
+    "clickable": /clickable="([^"]*)"/,
+    "scrollable": /scrollable="([^"]*)"/,
+    "focusable": /focusable="([^"]*)"/,
+    "enabled": /enabled="([^"]*)"/,
+    "bounds": /bounds="([^"]*)"/,
+};
+/** Extract an attribute value from a uiautomator node attributes string. */
+export function getAttr(attrs, name) {
+    const regex = UI_ATTR_REGEXES[name];
+    if (!regex)
+        return "";
+    const m = attrs.match(regex);
+    return m ? m[1] : "";
+}
+/**
+ * Capture the UI hierarchy XML from the device.
+ * Handles the dump → cat → cleanup sequence in one place.
+ * Uses a unique dump path per call to avoid collisions across concurrent tool invocations.
+ * Cleanup runs in a finally block to prevent device file leaks on errors.
+ * Returns the XML string, or null if the dump failed.
+ */
+export async function captureUiDump(bridge, serial, dumpPath) {
+    // On-device: use /data/local/tmp/ which is world-readable/writable — avoids
+    // scoped storage issues with /sdcard/ on Android 16+.
+    // ADB mode: use /sdcard/ which is the standard ADB scratch location.
+    const defaultDir = isOnDevice() ? "/data/local/tmp" : "/sdcard";
+    const path = dumpPath ?? `${defaultDir}/DA_uidump_${Date.now()}.xml`;
+    try {
+        await bridge.shell(`uiautomator dump '${shellEscape(path)}'`, { device: serial, timeout: 15000 });
+        const catResult = await bridge.shell(`cat '${shellEscape(path)}'`, { device: serial });
+        const xml = catResult.stdout;
+        if (!xml || xml.includes("ERROR") || !xml.includes("<hierarchy")) {
+            return null;
+        }
+        return xml;
+    }
+    finally {
+        // Always clean up the device-side dump file, even if cat/dump throws
+        await bridge.shell(`rm '${shellEscape(path)}'`, { device: serial, ignoreExitCode: true }).catch(() => { });
+    }
+}
+//# sourceMappingURL=ui-dump.js.map

package/build/middleware/ui-dump.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-dump.js","sourceRoot":"","sources":["../../src/middleware/ui-dump.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,aAAa,EAAE,uBAAuB;IACtC,MAAM,EAAE,kBAAkB;IAC1B,cAAc,EAAE,wBAAwB;IACxC,OAAO,EAAE,mBAAmB;IAC5B,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,sBAAsB;IACpC,WAAW,EAAE,qBAAqB;IAClC,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,kBAAkB;CAC7B,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,IAAY;IACjD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAiB,EACjB,MAAc,EACd,QAAiB;IAEjB,4EAA4E;IAC5E,sDAAsD;IACtD,qEAAqE;IACrE,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,MAAM,IAAI,GAAG,QAAQ,IAAI,GAAG,UAAU,cAAc,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;IACrE,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,CAAC,qBAAqB,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAClG,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvF,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACjE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;YAAS,CAAC;QACT,qEAAqE;QACrE,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC5G,CAAC;AACH,CAAC"}

package/build/server.d.ts

@@ -0,0 +1,18 @@
+/**
+ * DeepADB MCP Server
+ *
+ * Wires together the ADB bridge, device manager, middleware,
+ * and all tool/resource/prompt modules into a single MCP server instance.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AdbBridge } from "./bridge/adb-bridge.js";
+import { DeviceManager } from "./bridge/device-manager.js";
+import { Logger } from "./middleware/logger.js";
+export interface CreateServerResult {
+    server: McpServer;
+    logger: Logger;
+    bridge: AdbBridge;
+    deviceManager: DeviceManager;
+}
+export declare function createServer(): Promise<CreateServerResult>;
+//# sourceMappingURL=server.d.ts.map

package/build/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAoDhD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAoFhE"}

package/build/server.js

@@ -0,0 +1,133 @@
+/**
+ * DeepADB MCP Server
+ *
+ * Wires together the ADB bridge, device manager, middleware,
+ * and all tool/resource/prompt modules into a single MCP server instance.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { mkdirSync, existsSync } from "fs";
+import { AdbBridge } from "./bridge/adb-bridge.js";
+import { LocalBridge } from "./bridge/local-bridge.js";
+import { DeviceManager } from "./bridge/device-manager.js";
+import { Logger } from "./middleware/logger.js";
+import { SecurityMiddleware } from "./middleware/security.js";
+import { config, validateConfig, isOnDevice } from "./config/config.js";
+// Tool module registrations
+import { registerDeviceTools } from "./tools/device.js";
+import { registerShellTools } from "./tools/shell.js";
+import { registerPackageTools } from "./tools/packages.js";
+import { registerFileTools } from "./tools/files.js";
+import { registerLogTools } from "./tools/logs.js";
+import { registerDiagnosticTools } from "./tools/diagnostics.js";
+import { registerUiTools } from "./tools/ui.js";
+import { registerBuildTools } from "./tools/build.js";
+import { registerHealthTools } from "./tools/health.js";
+import { registerWirelessTools } from "./tools/wireless.js";
+import { registerControlTools } from "./tools/control.js";
+import { registerLogcatWatchTools } from "./tools/logcat-watch.js";
+import { registerForwardingTools } from "./tools/forwarding.js";
+import { registerScreenRecordTools } from "./tools/screen-record.js";
+import { registerEmulatorTools } from "./tools/emulator.js";
+import { registerQemuTools } from "./tools/qemu.js";
+import { registerTestingTools } from "./tools/testing.js";
+import { registerMultiDeviceTools } from "./tools/multi-device.js";
+import { registerSnapshotTools } from "./tools/snapshot.js";
+import { registerNetworkCaptureTools } from "./tools/network-capture.js";
+import { registerCiTools } from "./tools/ci.js";
+import { registerPluginTools, loadPlugins } from "./tools/plugins.js";
+import { registerBasebandTools } from "./tools/baseband.js";
+import { registerAccessibilityTools } from "./tools/accessibility.js";
+import { registerRegressionTools } from "./tools/regression.js";
+import { registerDeviceFarmTools } from "./tools/device-farm.js";
+import { registerRegistryTools } from "./tools/registry.js";
+import { registerAtCommandTools } from "./tools/at-commands.js";
+import { registerScreenshotDiffTools } from "./tools/screenshot-diff.js";
+import { registerWorkflowTools } from "./tools/workflow.js";
+import { registerSplitApkTools } from "./tools/split-apk.js";
+import { registerMirroringTools } from "./tools/mirroring.js";
+import { registerTestGenTools } from "./tools/test-gen.js";
+import { registerOtaMonitorTools } from "./tools/ota-monitor.js";
+import { registerRilInterceptTools } from "./tools/ril-intercept.js";
+import { registerDeviceProfileTools } from "./tools/device-profiles.js";
+import { registerFirmwareAnalysisTools } from "./tools/firmware-analysis.js";
+import { registerWorkflowMarketTools } from "./tools/workflow-market.js";
+import { registerSelinuxAuditTools } from "./tools/selinux-audit.js";
+import { registerThermalPowerTools } from "./tools/thermal-power.js";
+import { registerNetworkDiscoveryTools } from "./tools/network-discovery.js";
+// Resource and prompt registrations
+import { registerResources } from "./tools/resources.js";
+import { registerPrompts } from "./tools/prompts.js";
+export async function createServer() {
+    const logger = new Logger(process.env.DA_LOG_LEVEL ?? "info");
+    // Validate configuration at startup
+    const warnings = validateConfig();
+    for (const warning of warnings) {
+        logger.warn(warning);
+    }
+    // Ensure temp directory exists once, before any tool module registration
+    if (!existsSync(config.tempDir)) {
+        mkdirSync(config.tempDir, { recursive: true });
+    }
+    const bridge = isOnDevice() ? new LocalBridge(logger) : new AdbBridge(logger);
+    if (bridge instanceof LocalBridge) {
+        logger.info("On-device mode detected — using LocalBridge (direct execution, no ADB)");
+    }
+    const deviceManager = new DeviceManager(bridge);
+    const security = new SecurityMiddleware(logger);
+    const server = new McpServer({
+        name: "deepadb",
+        version: "1.0.0",
+    });
+    // Build unified tool context
+    const ctx = { server, bridge, deviceManager, logger, security, config };
+    // Register all tool modules (41 modules)
+    registerDeviceTools(ctx);
+    registerShellTools(ctx);
+    registerPackageTools(ctx);
+    registerFileTools(ctx);
+    registerLogTools(ctx);
+    registerDiagnosticTools(ctx);
+    registerUiTools(ctx);
+    registerBuildTools(ctx);
+    registerHealthTools(ctx);
+    registerWirelessTools(ctx);
+    registerControlTools(ctx);
+    registerLogcatWatchTools(ctx);
+    registerForwardingTools(ctx);
+    registerScreenRecordTools(ctx);
+    registerEmulatorTools(ctx);
+    registerQemuTools(ctx);
+    registerTestingTools(ctx);
+    registerMultiDeviceTools(ctx);
+    registerSnapshotTools(ctx);
+    registerNetworkCaptureTools(ctx);
+    registerCiTools(ctx);
+    registerPluginTools(ctx);
+    registerBasebandTools(ctx);
+    registerAccessibilityTools(ctx);
+    registerRegressionTools(ctx);
+    registerDeviceFarmTools(ctx);
+    registerRegistryTools(ctx);
+    registerAtCommandTools(ctx);
+    registerScreenshotDiffTools(ctx);
+    registerWorkflowTools(ctx);
+    registerSplitApkTools(ctx);
+    registerMirroringTools(ctx);
+    registerTestGenTools(ctx);
+    registerOtaMonitorTools(ctx);
+    registerRilInterceptTools(ctx);
+    registerDeviceProfileTools(ctx);
+    registerFirmwareAnalysisTools(ctx);
+    registerWorkflowMarketTools(ctx);
+    registerSelinuxAuditTools(ctx);
+    registerThermalPowerTools(ctx);
+    registerNetworkDiscoveryTools(ctx);
+    // Register MCP resources and prompts
+    registerResources(ctx);
+    registerPrompts(ctx);
+    // Load external plugins (async — scans plugin directory)
+    await loadPlugins(ctx);
+    logger.info("DeepADB MCP server initialized — 41 tool modules, 4 resources, 4 prompts. Ready.");
+    return { server, logger, bridge, deviceManager };
+}
+//# sourceMappingURL=server.js.map

package/build/server.js.map

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

package/build/tool-context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ToolContext — Unified dependency bundle for all tool modules.
+ *
+ * Instead of passing (server, bridge, deviceManager) to every module,
+ * we pass a single context object. This makes adding new cross-cutting
+ * dependencies non-breaking.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AdbBridge } from "./bridge/adb-bridge.js";
+import { DeviceManager } from "./bridge/device-manager.js";
+import { Logger } from "./middleware/logger.js";
+import { SecurityMiddleware } from "./middleware/security.js";
+import { DeepADBConfig } from "./config/config.js";
+export interface ToolContext {
+    server: McpServer;
+    bridge: AdbBridge;
+    deviceManager: DeviceManager;
+    logger: Logger;
+    security: SecurityMiddleware;
+    config: DeepADBConfig;
+}
+//# sourceMappingURL=tool-context.d.ts.map

package/build/tool-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-context.d.ts","sourceRoot":"","sources":["../src/tool-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,aAAa,CAAC;CACvB"}

package/build/tool-context.js

@@ -0,0 +1,9 @@
+/**
+ * ToolContext — Unified dependency bundle for all tool modules.
+ *
+ * Instead of passing (server, bridge, deviceManager) to every module,
+ * we pass a single context object. This makes adding new cross-cutting
+ * dependencies non-breaking.
+ */
+export {};
+//# sourceMappingURL=tool-context.js.map

package/build/tool-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-context.js","sourceRoot":"","sources":["../src/tool-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/build/tools/accessibility.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Accessibility Auditing Tools — Automated a11y checks on the UI hierarchy.
+ *
+ * Extends the uiautomator dump analysis to flag common accessibility issues:
+ * missing content-descriptions, undersized touch targets, duplicate descriptions,
+ * and elements missing focusability. Generates structured audit reports.
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerAccessibilityTools(ctx: ToolContext): void;
+//# sourceMappingURL=accessibility.d.ts.map

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

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