deepadb 1.0.0

package/build/middleware/chipset.js

@@ -0,0 +1,123 @@
+/**
+ * Chipset Detection — Shared chipset family identification, modem path mapping,
+ * and SIM configuration detection.
+ *
+ * Used by at-commands.ts, baseband.ts, and device-profiles.ts to avoid
+ * duplicated detection logic. Single source of truth for chipset family
+ * classification, known modem device node paths, and dual SIM detection.
+ */
+/**
+ * Known modem device node paths by chipset family.
+ * Ordered by likelihood — detection tries each path until one responds.
+ */
+export const MODEM_PATHS = {
+    // Samsung Shannon/Exynos (Pixel 6, 6a, 7, 7a, 8, Samsung Galaxy S series)
+    shannon: [
+        "/dev/umts_router0",
+        "/dev/umts_router1",
+        "/dev/umts_atc0",
+    ],
+    // Qualcomm (most Android devices)
+    qualcomm: [
+        "/dev/smd11",
+        "/dev/smd7",
+        "/dev/smd0",
+        "/dev/at_channel0",
+        "/dev/at_mdm0",
+    ],
+    // MediaTek (many mid-range devices)
+    mediatek: [
+        "/dev/radio/atci-serv-fw",
+        "/dev/ccci_ioctl0",
+        "/dev/ttyC0",
+        "/dev/ttyC1",
+    ],
+    // Unisoc/Spreadtrum
+    unisoc: [
+        "/dev/stty_lte0",
+        "/dev/stty_nr0",
+        "/dev/stty_w0",
+    ],
+    // HiSilicon/Kirin (Huawei, Honor devices)
+    hisilicon: [
+        "/dev/appvcom0",
+        "/dev/appvcom9",
+        "/dev/acm_at",
+    ],
+    // Intel XMM (older iPhones via Android projects, some Samsung/Asus devices)
+    intel: [
+        "/dev/ttyIFX0",
+        "/dev/ttyACM0",
+        "/dev/ttyACM1",
+    ],
+    // Generic USB/serial modems
+    generic: [
+        "/dev/ttyUSB0",
+        "/dev/ttyUSB1",
+        "/dev/ttyUSB2",
+        "/dev/ttyACM0",
+        "/dev/ttyACM1",
+    ],
+};
+/**
+ * Detect the chipset family from device properties.
+ * Returns the family key for MODEM_PATHS lookup.
+ */
+export function detectChipsetFamily(props) {
+    const chipname = (props["ro.hardware.chipname"] ?? "").toLowerCase();
+    const platform = (props["ro.board.platform"] ?? "").toLowerCase();
+    const hardware = (props["ro.hardware"] ?? "").toLowerCase();
+    const soc = (props["ro.soc.model"] ?? "").toLowerCase();
+    // Shannon/Exynos detection (includes Google Tensor SoCs which use Samsung Shannon modems)
+    if (chipname.includes("exynos") || chipname.includes("s5e") ||
+        soc.includes("exynos") || soc.includes("shannon") ||
+        hardware.includes("samsungexynos") || platform.includes("exynos") ||
+        platform.includes("gs101") || platform.includes("gs201") ||
+        platform.includes("zuma") || platform.includes("zumapro")) {
+        return "shannon";
+    }
+    // Qualcomm detection (includes platform codenames for recent SoCs)
+    if (platform.includes("msm") || platform.includes("sdm") || platform.includes("sm") ||
+        platform.includes("qcom") || chipname.includes("snapdragon") ||
+        hardware.includes("qcom") || platform.includes("lahaina") ||
+        platform.includes("taro") || platform.includes("kalama")) {
+        return "qualcomm";
+    }
+    // MediaTek detection
+    if (platform.includes("mt") || chipname.includes("mt") ||
+        hardware.includes("mt") || platform.includes("mediatek")) {
+        return "mediatek";
+    }
+    // Unisoc detection
+    if (platform.includes("sp") || platform.includes("ums") ||
+        chipname.includes("unisoc") || chipname.includes("spreadtrum")) {
+        return "unisoc";
+    }
+    // HiSilicon/Kirin detection (Huawei, Honor devices)
+    if (platform.includes("kirin") || chipname.includes("kirin") ||
+        platform.includes("hi3") || platform.includes("hi6") ||
+        chipname.includes("hisilicon") || hardware.includes("kirin") ||
+        soc.includes("kirin") || soc.includes("hisilicon")) {
+        return "hisilicon";
+    }
+    // Intel XMM detection (older modem platforms)
+    if (chipname.includes("xmm") || chipname.includes("intel") ||
+        platform.includes("intel") || soc.includes("xmm")) {
+        return "intel";
+    }
+    return "generic";
+}
+/** Maximum SIM slots to prevent resource exhaustion from corrupted properties. */
+const MAX_SIM_SLOTS = 4;
+/**
+ * Detect SIM configuration from device properties.
+ * Returns dual SIM status, slot count, and multisim mode string.
+ */
+export function detectSimConfig(props) {
+    const activeModems = parseInt(props["telephony.active_modems.max_count"] ?? "1", 10) || 1;
+    const multisimMode = (props["persist.radio.multisim.config"] ?? "").toLowerCase();
+    const dualSim = activeModems >= 2 || multisimMode === "dsds" || multisimMode === "dsda" || multisimMode === "tsts";
+    const simSlots = dualSim ? Math.min(Math.max(activeModems, 2), MAX_SIM_SLOTS) : 1;
+    return { dualSim, simSlots, multisimMode };
+}
+//# sourceMappingURL=chipset.js.map

package/build/middleware/chipset.js.map

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

package/build/middleware/cleanup.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Process Cleanup Registry — Centralized signal handler for child process cleanup.
+ *
+ * Multiple modules (logcat-watch, ril-intercept, mirroring) spawn long-running
+ * child processes that must be killed on server exit. Instead of each module
+ * independently registering SIGINT/SIGTERM/exit handlers (which creates
+ * ordering dependencies and redundant process.exit() calls), all modules
+ * register their cleanup functions here.
+ *
+ * One set of signal handlers runs all registered cleanups in order.
+ */
+type CleanupFn = () => void;
+/**
+ * Register a cleanup function that will be called on process exit/SIGINT/SIGTERM.
+ * Each module should register under a unique key. Re-registering the same key
+ * replaces the previous function.
+ */
+export declare function registerCleanup(key: string, fn: CleanupFn): void;
+/**
+ * Remove a cleanup function by key (e.g., if the module's sessions are all stopped).
+ */
+export declare function unregisterCleanup(key: string): void;
+export {};
+//# sourceMappingURL=cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/middleware/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,KAAK,SAAS,GAAG,MAAM,IAAI,CAAC;AA8B5B;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,CAGhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEnD"}

package/build/middleware/cleanup.js

@@ -0,0 +1,53 @@
+/**
+ * Process Cleanup Registry — Centralized signal handler for child process cleanup.
+ *
+ * Multiple modules (logcat-watch, ril-intercept, mirroring) spawn long-running
+ * child processes that must be killed on server exit. Instead of each module
+ * independently registering SIGINT/SIGTERM/exit handlers (which creates
+ * ordering dependencies and redundant process.exit() calls), all modules
+ * register their cleanup functions here.
+ *
+ * One set of signal handlers runs all registered cleanups in order.
+ */
+const registry = new Map();
+let registered = false;
+function runAllCleanups() {
+    for (const [, fn] of registry) {
+        try {
+            fn();
+        }
+        catch {
+            // Cleanup must not throw during shutdown
+        }
+    }
+}
+function ensureHandlers() {
+    if (registered)
+        return;
+    registered = true;
+    process.on("exit", runAllCleanups);
+    process.on("SIGINT", () => {
+        runAllCleanups();
+        process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+        runAllCleanups();
+        process.exit(0);
+    });
+}
+/**
+ * Register a cleanup function that will be called on process exit/SIGINT/SIGTERM.
+ * Each module should register under a unique key. Re-registering the same key
+ * replaces the previous function.
+ */
+export function registerCleanup(key, fn) {
+    ensureHandlers();
+    registry.set(key, fn);
+}
+/**
+ * Remove a cleanup function by key (e.g., if the module's sessions are all stopped).
+ */
+export function unregisterCleanup(key) {
+    registry.delete(key);
+}
+//# sourceMappingURL=cleanup.js.map

package/build/middleware/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/middleware/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,QAAQ,GAA2B,IAAI,GAAG,EAAE,CAAC;AACnD,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,SAAS,cAAc;IACrB,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,EAAE,EAAE,CAAC;QACP,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,cAAc;IACrB,IAAI,UAAU;QAAE,OAAO;IACvB,UAAU,GAAG,IAAI,CAAC;IAElB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,cAAc,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,cAAc,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,EAAa;IACxD,cAAc,EAAE,CAAC;IACjB,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/build/middleware/fetch-utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Fetch Utilities — Shared HTTP helpers with response size limits.
+ *
+ * Used by the plugin registry, workflow marketplace, and any module
+ * that fetches external resources. Enforces a maximum response body
+ * size to prevent memory exhaustion from oversized or malicious responses.
+ */
+/**
+ * Fetch a URL and parse the response as JSON.
+ * Enforces a response size limit to prevent memory exhaustion.
+ */
+export declare function fetchJson(url: string): Promise<unknown>;
+/**
+ * Fetch a URL and return the response body as text.
+ * Enforces a response size limit via streaming to prevent memory exhaustion,
+ * even when the server omits the Content-Length header.
+ */
+export declare function fetchText(url: string): Promise<string>;
+//# sourceMappingURL=fetch-utils.d.ts.map

package/build/middleware/fetch-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-utils.d.ts","sourceRoot":"","sources":["../../src/middleware/fetch-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;GAGG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG7D;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2C5D"}

package/build/middleware/fetch-utils.js

@@ -0,0 +1,64 @@
+/**
+ * Fetch Utilities — Shared HTTP helpers with response size limits.
+ *
+ * Used by the plugin registry, workflow marketplace, and any module
+ * that fetches external resources. Enforces a maximum response body
+ * size to prevent memory exhaustion from oversized or malicious responses.
+ */
+/** Maximum response body size in bytes (5 MB). */
+const MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
+/**
+ * Fetch a URL and parse the response as JSON.
+ * Enforces a response size limit to prevent memory exhaustion.
+ */
+export async function fetchJson(url) {
+    const text = await fetchText(url);
+    return JSON.parse(text);
+}
+/**
+ * Fetch a URL and return the response body as text.
+ * Enforces a response size limit via streaming to prevent memory exhaustion,
+ * even when the server omits the Content-Length header.
+ */
+export async function fetchText(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText} — ${url}`);
+    }
+    // Fast-reject via Content-Length header if available
+    const contentLength = response.headers.get("content-length");
+    if (contentLength && parseInt(contentLength, 10) > MAX_RESPONSE_BYTES) {
+        throw new Error(`Response too large: ${contentLength} bytes (max ${MAX_RESPONSE_BYTES})`);
+    }
+    // Stream-read the body with incremental size checking.
+    // This prevents memory exhaustion even when Content-Length is absent.
+    if (response.body) {
+        const reader = response.body.getReader();
+        const chunks = [];
+        let totalBytes = 0;
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                totalBytes += value.length;
+                if (totalBytes > MAX_RESPONSE_BYTES) {
+                    reader.cancel();
+                    throw new Error(`Response body too large: exceeded ${MAX_RESPONSE_BYTES} bytes (read aborted)`);
+                }
+                chunks.push(value);
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+        return new TextDecoder().decode(Buffer.concat(chunks));
+    }
+    // Fallback for environments where response.body is null
+    const text = await response.text();
+    if (text.length > MAX_RESPONSE_BYTES) {
+        throw new Error(`Response body too large: ${text.length} characters (max ${MAX_RESPONSE_BYTES})`);
+    }
+    return text;
+}
+//# sourceMappingURL=fetch-utils.js.map

package/build/middleware/fetch-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-utils.js","sourceRoot":"","sources":["../../src/middleware/fetch-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kDAAkD;AAClD,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,MAAM,GAAG,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,qDAAqD;IACrD,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC7D,IAAI,aAAa,IAAI,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,uBAAuB,aAAa,eAAe,kBAAkB,GAAG,CAAC,CAAC;IAC5F,CAAC;IAED,uDAAuD;IACvD,sEAAsE;IACtE,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI;oBAAE,MAAM;gBAChB,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;gBAC3B,IAAI,UAAU,GAAG,kBAAkB,EAAE,CAAC;oBACpC,MAAM,CAAC,MAAM,EAAE,CAAC;oBAChB,MAAM,IAAI,KAAK,CAAC,qCAAqC,kBAAkB,uBAAuB,CAAC,CAAC;gBAClG,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,wDAAwD;IACxD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,MAAM,oBAAoB,kBAAkB,GAAG,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/build/middleware/logger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Logger — Simple stderr-based logger for MCP servers.
+ *
+ * IMPORTANT: MCP stdio servers MUST NOT write to stdout.
+ * All logging goes to stderr to avoid corrupting JSON-RPC messages.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export declare class Logger {
+    private level;
+    constructor(level?: LogLevel);
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    private log;
+}
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/middleware/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAS3D,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,GAAE,QAAiB;IAIpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,OAAO,CAAC,GAAG;CAOZ"}

package/build/middleware/logger.js

@@ -0,0 +1,38 @@
+/**
+ * Logger — Simple stderr-based logger for MCP servers.
+ *
+ * IMPORTANT: MCP stdio servers MUST NOT write to stdout.
+ * All logging goes to stderr to avoid corrupting JSON-RPC messages.
+ */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+export class Logger {
+    level;
+    constructor(level = "info") {
+        this.level = LOG_LEVELS[level];
+    }
+    debug(message, ...args) {
+        this.log("debug", message, ...args);
+    }
+    info(message, ...args) {
+        this.log("info", message, ...args);
+    }
+    warn(message, ...args) {
+        this.log("warn", message, ...args);
+    }
+    error(message, ...args) {
+        this.log("error", message, ...args);
+    }
+    log(level, message, ...args) {
+        if (LOG_LEVELS[level] >= this.level) {
+            const timestamp = new Date().toISOString();
+            const prefix = `[${timestamp}] [${level.toUpperCase()}]`;
+            console.error(`${prefix} ${message}`, ...args);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/build/middleware/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/middleware/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,OAAO,MAAM;IACT,KAAK,CAAS;IAEtB,YAAY,QAAkB,MAAM;QAClC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,GAAG,IAAe;QAC9D,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;YACzD,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;CACF"}

package/build/middleware/output-processor.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Output Processor — Truncation, formatting, structured parsing, and binary handling.
+ *
+ * Sits between raw ADB output and what gets returned to Claude.
+ * Prevents context window blowout from verbose commands.
+ */
+export declare class OutputProcessor {
+    /**
+     * Truncate output at a logical boundary (line break or section separator)
+     * rather than cutting mid-line. Falls back to character limit if no
+     * clean break is found within a reasonable range.
+     */
+    static truncate(text: string, maxSize?: number): string;
+    /**
+     * Format ADB command output for clean presentation.
+     * Strips trailing whitespace and normalizes line endings.
+     */
+    static clean(text: string): string;
+    /**
+     * Process raw ADB output: clean, then truncate.
+     */
+    static process(text: string, maxSize?: number): string;
+    /**
+     * Format a structured error response.
+     */
+    static formatError(error: unknown): string;
+    /**
+     * Limit output to N lines (useful for logcat, dumpsys).
+     */
+    static limitLines(text: string, maxLines: number): string;
+    /**
+     * Extract the stdout string from a Promise.allSettled result.
+     * Handles fulfilled/rejected states, applies optional truncation,
+     * and provides a configurable fallback message on failure.
+     *
+     * Used by tools that run parallel ADB commands and need to present
+     * results even when some commands fail (e.g., diagnostics, baseband).
+     */
+    static settledValue(result: PromiseSettledResult<{
+        stdout: string;
+    }>, maxSize?: number, fallback?: string): string;
+    /**
+     * Parse `dumpsys battery` output into a concise key-value summary.
+     */
+    static parseBattery(raw: string): string;
+    /**
+     * Parse `dumpsys meminfo <package>` to extract the summary line.
+     * Returns the TOTAL line with key heap metrics, or falls back to raw.
+     */
+    static parseMeminfo(raw: string): string;
+    /**
+     * Parse `getprop` output into a clean key=value map string.
+     * Strips the [brackets] format.
+     */
+    static parseGetprop(raw: string): Record<string, string>;
+}
+//# sourceMappingURL=output-processor.d.ts.map

package/build/middleware/output-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-processor.d.ts","sourceRoot":"","sources":["../../src/middleware/output-processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,qBAAa,eAAe;IAC1B;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IA2BvD;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAOlC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAItD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAO1C;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAWzD;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CACjB,MAAM,EAAE,oBAAoB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,EAChD,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,SAAgB,GACvB,MAAM;IAST;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAgCxC;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAmBxC;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAUzD"}

package/build/middleware/output-processor.js

@@ -0,0 +1,162 @@
+/**
+ * Output Processor — Truncation, formatting, structured parsing, and binary handling.
+ *
+ * Sits between raw ADB output and what gets returned to Claude.
+ * Prevents context window blowout from verbose commands.
+ */
+import { config } from "../config/config.js";
+export class OutputProcessor {
+    /**
+     * Truncate output at a logical boundary (line break or section separator)
+     * rather than cutting mid-line. Falls back to character limit if no
+     * clean break is found within a reasonable range.
+     */
+    static truncate(text, maxSize) {
+        const limit = maxSize ?? config.maxOutputSize;
+        if (text.length <= limit)
+            return text;
+        // Scan backward from the limit to find a clean break point
+        // Look within the last 500 chars of the allowed range
+        const searchStart = Math.max(0, limit - 500);
+        const searchRegion = text.substring(searchStart, limit);
+        // Prefer section separators, then newlines
+        let breakOffset = -1;
+        const sectionBreak = searchRegion.lastIndexOf("\n\n");
+        if (sectionBreak !== -1) {
+            breakOffset = searchStart + sectionBreak;
+        }
+        else {
+            const lineBreak = searchRegion.lastIndexOf("\n");
+            if (lineBreak !== -1) {
+                breakOffset = searchStart + lineBreak;
+            }
+        }
+        const cutPoint = breakOffset > 0 ? breakOffset : limit;
+        const truncated = text.substring(0, cutPoint);
+        const remaining = text.length - cutPoint;
+        return `${truncated}\n\n--- OUTPUT TRUNCATED (${remaining.toLocaleString()} characters omitted) ---`;
+    }
+    /**
+     * Format ADB command output for clean presentation.
+     * Strips trailing whitespace and normalizes line endings.
+     */
+    static clean(text) {
+        return text
+            .replace(/\r\n/g, "\n")
+            .replace(/\r/g, "\n")
+            .trimEnd();
+    }
+    /**
+     * Process raw ADB output: clean, then truncate.
+     */
+    static process(text, maxSize) {
+        return this.truncate(this.clean(text), maxSize);
+    }
+    /**
+     * Format a structured error response.
+     */
+    static formatError(error) {
+        if (error instanceof Error) {
+            return `Error: ${error.message}`;
+        }
+        return `Error: ${String(error)}`;
+    }
+    /**
+     * Limit output to N lines (useful for logcat, dumpsys).
+     */
+    static limitLines(text, maxLines) {
+        const lines = text.split("\n");
+        if (lines.length <= maxLines)
+            return text;
+        const kept = lines.slice(0, maxLines);
+        const omitted = lines.length - maxLines;
+        return `${kept.join("\n")}\n\n--- ${omitted} lines omitted (showing first ${maxLines}) ---`;
+    }
+    // ── Structured Output Parsers ────────────────────────────────────
+    /**
+     * Extract the stdout string from a Promise.allSettled result.
+     * Handles fulfilled/rejected states, applies optional truncation,
+     * and provides a configurable fallback message on failure.
+     *
+     * Used by tools that run parallel ADB commands and need to present
+     * results even when some commands fail (e.g., diagnostics, baseband).
+     */
+    static settledValue(result, maxSize, fallback = "unavailable") {
+        if (result.status === "fulfilled") {
+            const text = result.value.stdout.trim();
+            return text ? (maxSize ? OutputProcessor.process(text, maxSize) : text) : "(empty)";
+        }
+        const reason = result.reason;
+        return `${fallback}: ${reason instanceof Error ? reason.message : String(reason ?? "unknown error")}`;
+    }
+    /**
+     * Parse `dumpsys battery` output into a concise key-value summary.
+     */
+    static parseBattery(raw) {
+        const pairs = [];
+        const extract = (key) => {
+            const match = raw.match(new RegExp(`^\\s*${key}:\\s*(.+)$`, "m"));
+            return match?.[1]?.trim();
+        };
+        const level = extract("level");
+        const status = extract("status");
+        const health = extract("health");
+        const plugged = extract("plugged");
+        const temperature = extract("temperature");
+        const voltage = extract("voltage");
+        if (level)
+            pairs.push(`Level: ${level}%`);
+        if (status) {
+            const statusMap = { "2": "Charging", "3": "Discharging", "4": "Not charging", "5": "Full" };
+            pairs.push(`Status: ${statusMap[status] ?? status}`);
+        }
+        if (health) {
+            const healthMap = { "2": "Good", "3": "Overheat", "4": "Dead", "5": "Over voltage" };
+            pairs.push(`Health: ${healthMap[health] ?? health}`);
+        }
+        if (plugged) {
+            const plugMap = { "0": "Unplugged", "1": "AC", "2": "USB", "4": "Wireless" };
+            pairs.push(`Plugged: ${plugMap[plugged] ?? plugged}`);
+        }
+        if (temperature)
+            pairs.push(`Temperature: ${(parseInt(temperature, 10) / 10).toFixed(1)}°C`);
+        if (voltage)
+            pairs.push(`Voltage: ${(parseInt(voltage, 10) / 1000).toFixed(3)}V`);
+        return pairs.length > 0 ? pairs.join(" | ") : raw.trim();
+    }
+    /**
+     * Parse `dumpsys meminfo <package>` to extract the summary line.
+     * Returns the TOTAL line with key heap metrics, or falls back to raw.
+     */
+    static parseMeminfo(raw) {
+        const lines = raw.split("\n");
+        const sections = [];
+        // Find TOTAL line
+        const totalLine = lines.find((l) => /^\s*TOTAL\b/.test(l));
+        if (totalLine)
+            sections.push(`Memory: ${totalLine.trim()}`);
+        // Find summary section
+        const summaryIdx = lines.findIndex((l) => l.includes("App Summary"));
+        if (summaryIdx !== -1) {
+            const summaryLines = lines.slice(summaryIdx, summaryIdx + 10)
+                .filter((l) => l.trim().length > 0);
+            sections.push(summaryLines.join("\n"));
+        }
+        return sections.length > 0 ? sections.join("\n\n") : raw;
+    }
+    /**
+     * Parse `getprop` output into a clean key=value map string.
+     * Strips the [brackets] format.
+     */
+    static parseGetprop(raw) {
+        const props = {};
+        for (const line of raw.split("\n")) {
+            const match = line.trim().match(/^\[(.+?)\]: \[(.*)?\]$/);
+            if (match) {
+                props[match[1]] = match[2] ?? "";
+            }
+        }
+        return props;
+    }
+}
+//# sourceMappingURL=output-processor.js.map

package/build/middleware/output-processor.js.map

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

package/build/middleware/sanitize.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+/**
+ * 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 declare function validateShellArg(value: string, paramName: string): string | 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 declare function shellEscape(str: string): string;
+/**
+ * Validate multiple arguments at once. Returns the first error found, or null if all pass.
+ */
+export declare function validateShellArgs(args: Array<[string, string]>): string | null;
+//# sourceMappingURL=sanitize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/middleware/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKhF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAM9E"}