deepadb 1.0.0

package/build/tools/accessibility.js

@@ -0,0 +1,259 @@
+/**
+ * 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 { z } from "zod";
+import { OutputProcessor } from "../middleware/output-processor.js";
+import { captureUiDump, UI_ATTR_REGEXES } from "../middleware/ui-dump.js";
+/** Minimum touch target size in dp (WCAG / Material Design guideline). */
+const MIN_TOUCH_TARGET_DP = 48;
+/** Default screen density for dp conversion (mdpi baseline). */
+const DEFAULT_DENSITY = 160;
+const ATTR_REGEXES = UI_ATTR_REGEXES;
+function parseElements(xml) {
+    const elements = [];
+    const nodeRegex = /<node\s+([^>]+)\/?>/g;
+    let match;
+    while ((match = nodeRegex.exec(xml)) !== null) {
+        const attrs = match[1];
+        const get = (name) => {
+            const regex = ATTR_REGEXES[name];
+            if (!regex)
+                return "";
+            const m = attrs.match(regex);
+            return m ? m[1] : "";
+        };
+        const boundsStr = get("bounds");
+        const boundsMatch = boundsStr.match(/\[(\d+),(\d+)\]\[(\d+),(\d+)\]/);
+        if (!boundsMatch)
+            continue;
+        const left = parseInt(boundsMatch[1], 10);
+        const top = parseInt(boundsMatch[2], 10);
+        const right = parseInt(boundsMatch[3], 10);
+        const bottom = parseInt(boundsMatch[4], 10);
+        elements.push({
+            className: get("class").replace("android.widget.", "").replace("android.view.", ""),
+            text: get("text"),
+            contentDesc: get("content-desc"),
+            resourceId: get("resource-id"),
+            clickable: get("clickable") === "true",
+            focusable: get("focusable") === "true",
+            enabled: get("enabled") !== "false",
+            bounds: { left, top, right, bottom },
+            widthPx: right - left,
+            heightPx: bottom - top,
+        });
+    }
+    return elements;
+}
+function elementLabel(el) {
+    const parts = [el.className];
+    if (el.resourceId)
+        parts.push(`id:${el.resourceId}`);
+    if (el.text)
+        parts.push(`"${el.text.substring(0, 30)}"`);
+    return parts.join(" ");
+}
+function runAudit(elements, density) {
+    const issues = [];
+    const dpScale = density / DEFAULT_DENSITY;
+    const descriptionsSeen = new Map();
+    for (const el of elements) {
+        const label = elementLabel(el);
+        // Rule 1: Interactive elements must have a label (text or content-desc)
+        if (el.clickable && !el.text && !el.contentDesc) {
+            issues.push({
+                severity: "error",
+                rule: "missing-label",
+                message: "Clickable element has no text or content-description. Screen readers cannot announce this element.",
+                element: label,
+            });
+        }
+        // Rule 2: ImageView/ImageButton should have content-desc
+        if ((el.className.includes("Image") || el.className.includes("Icon")) && !el.contentDesc && !el.text) {
+            issues.push({
+                severity: "warning",
+                rule: "image-no-desc",
+                message: "Image element has no content-description. Decorative images should be marked not-important-for-accessibility.",
+                element: label,
+            });
+        }
+        // Rule 3: Touch target size check
+        if (el.clickable && el.widthPx > 0 && el.heightPx > 0) {
+            const widthDp = el.widthPx / dpScale;
+            const heightDp = el.heightPx / dpScale;
+            if (widthDp < MIN_TOUCH_TARGET_DP || heightDp < MIN_TOUCH_TARGET_DP) {
+                issues.push({
+                    severity: "warning",
+                    rule: "small-touch-target",
+                    message: `Touch target is ${widthDp.toFixed(0)}x${heightDp.toFixed(0)}dp (minimum ${MIN_TOUCH_TARGET_DP}x${MIN_TOUCH_TARGET_DP}dp).`,
+                    element: label,
+                });
+            }
+        }
+        // Rule 4: Clickable elements should be focusable
+        if (el.clickable && !el.focusable) {
+            issues.push({
+                severity: "warning",
+                rule: "clickable-not-focusable",
+                message: "Element is clickable but not focusable. Keyboard and switch navigation may not reach it.",
+                element: label,
+            });
+        }
+        // Rule 5: Duplicate content-descriptions
+        if (el.contentDesc) {
+            const count = (descriptionsSeen.get(el.contentDesc) ?? 0) + 1;
+            descriptionsSeen.set(el.contentDesc, count);
+            if (count === 2) {
+                issues.push({
+                    severity: "warning",
+                    rule: "duplicate-desc",
+                    message: `Content-description "${el.contentDesc.substring(0, 40)}" is used by multiple elements. Screen reader users cannot distinguish them.`,
+                    element: label,
+                });
+            }
+        }
+    }
+    return issues;
+}
+export function registerAccessibilityTools(ctx) {
+    ctx.server.tool("adb_a11y_audit", "Run an automated accessibility audit on the current screen. Checks for: missing labels on interactive elements, undersized touch targets (<48dp), images without content-descriptions, clickable elements missing focusability, and duplicate descriptions. Returns a structured report with severity and rule violations.", {
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ device }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const serial = resolved.serial;
+            const xml = await captureUiDump(ctx.bridge, serial);
+            if (!xml) {
+                return { content: [{ type: "text", text: "Failed to capture UI hierarchy for accessibility audit." }], isError: true };
+            }
+            // Get screen density for dp conversion
+            const densityResult = await ctx.bridge.shell("wm density", { device: serial, ignoreExitCode: true });
+            const densityMatch = densityResult.stdout.match(/(\d+)/);
+            const density = densityMatch ? parseInt(densityMatch[1], 10) : DEFAULT_DENSITY;
+            const elements = parseElements(xml);
+            const clickable = elements.filter((el) => el.clickable);
+            const issues = runAudit(elements, density);
+            const errors = issues.filter((i) => i.severity === "error");
+            const warnings = issues.filter((i) => i.severity === "warning");
+            const sections = [];
+            sections.push(`Accessibility Audit — ${elements.length} elements, ${clickable.length} interactive`);
+            sections.push(`Screen density: ${density}dpi (min touch target: ${MIN_TOUCH_TARGET_DP}dp = ${Math.round(MIN_TOUCH_TARGET_DP * density / DEFAULT_DENSITY)}px)`);
+            sections.push(`Result: ${errors.length} error(s), ${warnings.length} warning(s)\n`);
+            if (issues.length === 0) {
+                sections.push("No accessibility issues detected on this screen.");
+            }
+            else {
+                if (errors.length > 0) {
+                    sections.push("=== Errors ===");
+                    for (const issue of errors) {
+                        sections.push(`✗ [${issue.rule}] ${issue.element}\n  ${issue.message}`);
+                    }
+                }
+                if (warnings.length > 0) {
+                    sections.push("\n=== Warnings ===");
+                    for (const issue of warnings) {
+                        sections.push(`○ [${issue.rule}] ${issue.element}\n  ${issue.message}`);
+                    }
+                }
+            }
+            return { content: [{ type: "text", text: OutputProcessor.process(sections.join("\n")) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_a11y_touch_targets", "List all interactive elements with their touch target dimensions in dp. Highlights elements below the 48dp minimum. Useful for quickly identifying cramped UI layouts.", {
+        belowMinOnly: z.boolean().optional().default(false).describe("Only show elements below the 48dp minimum"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ belowMinOnly, device }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const serial = resolved.serial;
+            const xml = await captureUiDump(ctx.bridge, serial);
+            if (!xml) {
+                return { content: [{ type: "text", text: "Failed to capture UI hierarchy." }], isError: true };
+            }
+            const densityResult = await ctx.bridge.shell("wm density", { device: serial, ignoreExitCode: true });
+            const densityMatch = densityResult.stdout.match(/(\d+)/);
+            const density = densityMatch ? parseInt(densityMatch[1], 10) : DEFAULT_DENSITY;
+            const dpScale = density / DEFAULT_DENSITY;
+            const elements = parseElements(xml);
+            const clickable = elements.filter((el) => el.clickable && el.widthPx > 0 && el.heightPx > 0);
+            const rows = clickable
+                .map((el) => {
+                const wDp = el.widthPx / dpScale;
+                const hDp = el.heightPx / dpScale;
+                const ok = wDp >= MIN_TOUCH_TARGET_DP && hDp >= MIN_TOUCH_TARGET_DP;
+                if (belowMinOnly && ok)
+                    return null;
+                const flag = ok ? "✓" : "✗";
+                return `${flag} ${wDp.toFixed(0)}x${hDp.toFixed(0)}dp | ${elementLabel(el)}`;
+            })
+                .filter(Boolean);
+            if (rows.length === 0) {
+                return { content: [{ type: "text", text: belowMinOnly ? "All interactive elements meet the 48dp minimum touch target size." : "No interactive elements found on screen." }] };
+            }
+            const header = `Touch targets (${rows.length} elements, density: ${density}dpi, min: ${MIN_TOUCH_TARGET_DP}dp):\n`;
+            return { content: [{ type: "text", text: header + rows.join("\n") }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_a11y_tree", "Dump the accessibility-focused view of the UI hierarchy. Shows only elements relevant to screen readers: their roles, labels, states, and navigation order. Filters out decorative/layout containers.", {
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ device }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const serial = resolved.serial;
+            const xml = await captureUiDump(ctx.bridge, serial);
+            if (!xml) {
+                return { content: [{ type: "text", text: "Failed to capture UI hierarchy." }], isError: true };
+            }
+            const elements = parseElements(xml);
+            // Filter to elements that are relevant to accessibility:
+            // interactive, have labels, or are images
+            const a11yRelevant = elements.filter((el) => el.clickable || el.focusable || el.text || el.contentDesc ||
+                el.className.includes("Image") || el.className.includes("Button") ||
+                el.className.includes("EditText") || el.className.includes("Switch") ||
+                el.className.includes("CheckBox") || el.className.includes("Radio"));
+            if (a11yRelevant.length === 0) {
+                return { content: [{ type: "text", text: "No accessibility-relevant elements found on screen." }] };
+            }
+            const lines = a11yRelevant.map((el, i) => {
+                const parts = [`[${i}] ${el.className}`];
+                const label = el.contentDesc || el.text;
+                if (label)
+                    parts.push(`label: "${label.substring(0, 50)}"`);
+                else
+                    parts.push("(no label)");
+                const states = [];
+                if (el.clickable)
+                    states.push("clickable");
+                if (el.focusable)
+                    states.push("focusable");
+                if (!el.enabled)
+                    states.push("disabled");
+                if (states.length)
+                    parts.push(`[${states.join(", ")}]`);
+                if (el.resourceId)
+                    parts.push(`id: ${el.resourceId}`);
+                return parts.join(" | ");
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: `Accessibility tree — ${a11yRelevant.length} elements (of ${elements.length} total):\n\n${OutputProcessor.process(lines.join("\n"))}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=accessibility.js.map

package/build/tools/accessibility.js.map

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

package/build/tools/at-commands.d.ts

@@ -0,0 +1,20 @@
+/**
+ * AT Command Interface — Raw modem AT command passthrough via root access.
+ *
+ * Enables direct modem interrogation beyond what the Android telephony
+ * framework exposes. Useful for advanced baseband research, cellular
+ * protocol analysis, and low-level radio diagnostics.
+ *
+ * Multi-device support: auto-detects modem device node by chipset family
+ * (Shannon/Exynos, Qualcomm, MediaTek, Unisoc, generic USB modems).
+ * Manual port override available for unknown hardware.
+ *
+ * Root access required — AT commands go through /dev/ serial device nodes.
+ *
+ * SAFETY: Certain AT commands can disable the radio (AT+CFUN=0), factory
+ * reset the modem, or alter NVRAM. A blocklist prevents accidental execution
+ * of the most dangerous commands. Use `force: true` to bypass.
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerAtCommandTools(ctx: ToolContext): void;
+//# sourceMappingURL=at-commands.d.ts.map

package/build/tools/at-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"at-commands.d.ts","sourceRoot":"","sources":["../../src/tools/at-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA2GjD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA+T7D"}