deepadb 1.0.0

package/build/tools/resources.js

@@ -0,0 +1,77 @@
+/**
+ * MCP Resources — Read-only device state surfaces.
+ *
+ * Exposes device information as MCP Resources that clients can
+ * read on demand. Semantically better than tools for "give me
+ * current state" operations.
+ */
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { OutputProcessor } from "../middleware/output-processor.js";
+export function registerResources(ctx) {
+    // Dynamic resource: device info by serial
+    ctx.server.resource("device-info", new ResourceTemplate("device://info/{serial}", { list: undefined }), { description: "Device properties (model, OS version, build, ABI)" }, async (uri, { serial }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(serial || undefined);
+            const props = await ctx.deviceManager.getDeviceProps(resolved.serial);
+            const info = [
+                `Model: ${props["ro.product.model"] ?? "unknown"}`,
+                `Manufacturer: ${props["ro.product.manufacturer"] ?? "unknown"}`,
+                `Android: ${props["ro.build.version.release"] ?? "unknown"} (SDK ${props["ro.build.version.sdk"] ?? "?"})`,
+                `Build: ${props["ro.build.display.id"] ?? "unknown"}`,
+                `Security Patch: ${props["ro.build.version.security_patch"] ?? "unknown"}`,
+                `ABI: ${props["ro.product.cpu.abi"] ?? "unknown"}`,
+                `Serial: ${resolved.serial}`,
+            ].join("\n");
+            return { contents: [{ uri: uri.href, mimeType: "text/plain", text: info }] };
+        }
+        catch (error) {
+            return { contents: [{ uri: uri.href, mimeType: "text/plain", text: OutputProcessor.formatError(error) }] };
+        }
+    });
+    // Dynamic resource: battery status by serial
+    ctx.server.resource("device-battery", new ResourceTemplate("device://battery/{serial}", { list: undefined }), { description: "Battery status, level, temperature, and charging info" }, async (uri, { serial }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(serial || undefined);
+            const result = await ctx.bridge.shell("dumpsys battery", { device: resolved.serial });
+            const parsed = OutputProcessor.parseBattery(result.stdout);
+            return { contents: [{ uri: uri.href, mimeType: "text/plain", text: parsed }] };
+        }
+        catch (error) {
+            return { contents: [{ uri: uri.href, mimeType: "text/plain", text: OutputProcessor.formatError(error) }] };
+        }
+    });
+    // Dynamic resource: telephony state by serial
+    ctx.server.resource("device-telephony", new ResourceTemplate("device://telephony/{serial}", { list: undefined }), { description: "Telephony state: cell info, signal strength, network registration" }, async (uri, { serial }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(serial || undefined);
+            const result = await ctx.bridge.shell("dumpsys telephony.registry", {
+                device: resolved.serial, timeout: 15000,
+            });
+            return { contents: [{ uri: uri.href, mimeType: "text/plain", text: OutputProcessor.process(result.stdout, 20000) }] };
+        }
+        catch (error) {
+            return { contents: [{ uri: uri.href, mimeType: "text/plain", text: OutputProcessor.formatError(error) }] };
+        }
+    });
+    // Static resource: list connected devices
+    ctx.server.resource("devices-list", "device://list", { description: "List of all connected Android devices" }, async (uri) => {
+        try {
+            const devices = await ctx.deviceManager.listDevices();
+            const text = devices.length === 0
+                ? "No devices connected."
+                : devices.map((d) => {
+                    const parts = [`${d.serial} (${d.state})`];
+                    if (d.model)
+                        parts.push(`model: ${d.model}`);
+                    if (d.product)
+                        parts.push(`product: ${d.product}`);
+                    return parts.join(" | ");
+                }).join("\n");
+            return { contents: [{ uri: uri.href, mimeType: "text/plain", text }] };
+        }
+        catch (error) {
+            return { contents: [{ uri: uri.href, mimeType: "text/plain", text: OutputProcessor.formatError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=resources.js.map

package/build/tools/resources.js.map

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

package/build/tools/ril-intercept.d.ts

@@ -0,0 +1,24 @@
+/**
+ * RIL Message Interception — Passive radio interface layer monitoring.
+ *
+ * Captures and parses RIL (Radio Interface Layer) messages from the
+ * Android radio logcat buffer. RIL sits between the telephony framework
+ * and the baseband modem — intercepting these messages provides visibility
+ * into network attach, authentication, handover, paging, and registration
+ * events useful for radio diagnostics and cellular network research.
+ *
+ * Parsed message categories:
+ *   - Registration: VOICE_REGISTRATION_STATE, DATA_REGISTRATION_STATE
+ *   - Cell info: GET_CELL_INFO_LIST responses
+ *   - Signal: SIGNAL_STRENGTH updates
+ *   - Network: OPERATOR, QUERY_NETWORK_SELECTION_MODE
+ *   - Security: AUTHENTICATION events, cipher indicators
+ *   - Handover: Tracking area updates, cell reselection
+ *
+ * Uses spawned logcat processes (like logcat-watch) with radio buffer
+ * filtering. Root access optional but recommended for kernel-level
+ * modem messages via dmesg.
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerRilInterceptTools(ctx: ToolContext): void;
+//# sourceMappingURL=ril-intercept.d.ts.map

package/build/tools/ril-intercept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ril-intercept.d.ts","sourceRoot":"","sources":["../../src/tools/ril-intercept.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAyEjD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA2OhE"}

package/build/tools/ril-intercept.js

@@ -0,0 +1,273 @@
+/**
+ * RIL Message Interception — Passive radio interface layer monitoring.
+ *
+ * Captures and parses RIL (Radio Interface Layer) messages from the
+ * Android radio logcat buffer. RIL sits between the telephony framework
+ * and the baseband modem — intercepting these messages provides visibility
+ * into network attach, authentication, handover, paging, and registration
+ * events useful for radio diagnostics and cellular network research.
+ *
+ * Parsed message categories:
+ *   - Registration: VOICE_REGISTRATION_STATE, DATA_REGISTRATION_STATE
+ *   - Cell info: GET_CELL_INFO_LIST responses
+ *   - Signal: SIGNAL_STRENGTH updates
+ *   - Network: OPERATOR, QUERY_NETWORK_SELECTION_MODE
+ *   - Security: AUTHENTICATION events, cipher indicators
+ *   - Handover: Tracking area updates, cell reselection
+ *
+ * Uses spawned logcat processes (like logcat-watch) with radio buffer
+ * filtering. Root access optional but recommended for kernel-level
+ * modem messages via dmesg.
+ */
+import { z } from "zod";
+import { OutputProcessor } from "../middleware/output-processor.js";
+import { registerCleanup } from "../middleware/cleanup.js";
+/** Active RIL capture sessions by ID. */
+const sessions = new Map();
+let sessionCounter = 0;
+const MAX_RIL_SESSIONS = 5;
+/** RIL message category patterns. */
+const RIL_CATEGORIES = [
+    { pattern: /VOICE_REGISTRATION_STATE|DATA_REGISTRATION_STATE|REGISTRATION_FAILED/i, category: "registration" },
+    { pattern: /CELL_INFO|CellInfo|mCellInfo/i, category: "cell_info" },
+    { pattern: /SIGNAL_STRENGTH|SignalStrength/i, category: "signal" },
+    { pattern: /OPERATOR|COPS|operator/i, category: "network" },
+    { pattern: /AUTH|CPIN|SIM_STATUS|IMSI/i, category: "security" },
+    { pattern: /HANDOVER|TAU|TRACKING_AREA|RESELECT/i, category: "handover" },
+    { pattern: /SETUP_DATA_CALL|DEACTIVATE_DATA|DATA_CALL_LIST/i, category: "data" },
+    { pattern: /RADIO_STATE|CFUN|RADIO_POWER/i, category: "radio_state" },
+    { pattern: /SMS|CDMA_SMS|NEW_SMS/i, category: "sms" },
+    { pattern: /NAS|EMM|5GMM|ATTACH|DETACH/i, category: "nas" },
+];
+function categorizeMessage(line) {
+    for (const { pattern, category } of RIL_CATEGORIES) {
+        if (pattern.test(line))
+            return category;
+    }
+    return "other";
+}
+function parseRilLine(line) {
+    // Standard logcat format: "MM-DD HH:MM:SS.mmm PID TID PRIORITY TAG: message"
+    const match = line.match(/^(\d{2}-\d{2}\s+\d{2}:\d{2}:\d{2}\.\d{3})\s+\d+\s+\d+\s+([VDIWEF])\s+(.+?):\s+(.*)/);
+    if (!match)
+        return null;
+    return {
+        timestamp: match[1],
+        priority: match[2],
+        tag: match[3].trim(),
+        raw: match[4],
+        category: categorizeMessage(match[4]),
+    };
+}
+// Register cleanup via shared registry
+function ensureCleanupRegistered() {
+    registerCleanup("ril-intercept", () => {
+        for (const [, session] of sessions) {
+            try {
+                session.process.kill();
+            }
+            catch { /* ignore */ }
+        }
+        sessions.clear();
+    });
+}
+export function registerRilInterceptTools(ctx) {
+    ensureCleanupRegistered();
+    ctx.server.tool("adb_ril_start", "Start capturing RIL (Radio Interface Layer) messages from the radio logcat buffer. Captures network registration, cell info, signal strength, authentication, handover, and NAS events. Useful for radio diagnostics and cellular network research.", {
+        bufferSize: z.number().min(100).max(50000).optional().default(5000).describe("Max messages to keep in ring buffer (100-50000, default 5000)"),
+        includeKernel: z.boolean().optional().default(false).describe("Also capture from main and kernel logcat buffers for modem framework and kernel-level radio messages"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ bufferSize, includeKernel, device }) => {
+        try {
+            if (sessions.size >= MAX_RIL_SESSIONS) {
+                return {
+                    content: [{ type: "text", text: `Maximum RIL sessions reached (${MAX_RIL_SESSIONS}). Stop an existing session first.` }],
+                    isError: true,
+                };
+            }
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const serial = resolved.serial;
+            const id = `ril_${++sessionCounter}`;
+            // Spawn logcat with radio buffer (and main buffer if includeKernel for modem framework messages)
+            const buffers = includeKernel ? "radio,main,kernel" : "radio";
+            const logcatArgs = ["logcat", "-b", buffers, "-v", "time"];
+            // Spawn via bridge — works in both ADB and on-device modes
+            const proc = ctx.bridge.spawnStreaming(logcatArgs, serial);
+            const session = {
+                process: proc,
+                buffer: [],
+                rawBuffer: [],
+                readCursor: 0,
+                maxMessages: bufferSize,
+                startedAt: Date.now(),
+                device: serial,
+                includeKernel,
+            };
+            let partial = "";
+            proc.stdout?.on("data", (chunk) => {
+                const text = partial + chunk.toString();
+                const lines = text.split("\n");
+                partial = lines.pop() ?? "";
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed)
+                        continue;
+                    const parsed = parseRilLine(trimmed);
+                    if (parsed) {
+                        session.buffer.push(parsed);
+                        session.rawBuffer.push(trimmed);
+                        // Ring buffer management
+                        if (session.buffer.length > session.maxMessages) {
+                            const overflow = session.buffer.length - session.maxMessages;
+                            session.buffer.splice(0, overflow);
+                            session.rawBuffer.splice(0, overflow);
+                            session.readCursor = Math.max(0, session.readCursor - overflow);
+                        }
+                    }
+                }
+            });
+            proc.stderr?.on("data", (chunk) => {
+                const msg = chunk.toString().trim();
+                if (msg)
+                    ctx.logger.warn(`[${id}] radio logcat stderr: ${msg}`);
+            });
+            proc.on("error", (err) => {
+                ctx.logger.error(`[${id}] Failed to spawn radio logcat: ${err.message}`);
+                sessions.delete(id);
+            });
+            proc.on("exit", (code) => {
+                ctx.logger.info(`[${id}] radio logcat exited (code: ${code})`);
+                sessions.delete(id);
+            });
+            sessions.set(id, session);
+            return {
+                content: [{
+                        type: "text",
+                        text: `RIL capture started: ${id}\nDevice: ${serial}\nBuffer: ${bufferSize} messages\nLogcat buffers: ${includeKernel ? "radio + main + kernel" : "radio only"}\n\nCapturing: registration, cell info, signal, network, security, handover, NAS events\nUse adb_ril_poll to retrieve captured messages.`,
+                    }],
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_ril_poll", "Retrieve captured RIL messages since the last poll. Optionally filter by category (registration, cell_info, signal, network, security, handover, data, radio_state, nas).", {
+        session: z.string().describe("Session ID from adb_ril_start (e.g., 'ril_1')"),
+        category: z.string().optional().describe("Filter by category: registration, cell_info, signal, network, security, handover, data, radio_state, sms, nas, other"),
+        maxMessages: z.number().min(1).max(10000).optional().default(100).describe("Max messages to return per poll (1-10000)"),
+        raw: z.boolean().optional().default(false).describe("Return raw logcat lines instead of parsed messages"),
+    }, async ({ session: sessionId, category, maxMessages, raw }) => {
+        try {
+            const session = sessions.get(sessionId);
+            if (!session) {
+                const active = Array.from(sessions.keys());
+                return {
+                    content: [{ type: "text", text: `Session "${sessionId}" not found. Active: ${active.join(", ") || "none"}` }],
+                    isError: true,
+                };
+            }
+            const available = session.buffer.length - session.readCursor;
+            if (available <= 0) {
+                const elapsed = ((Date.now() - session.startedAt) / 1000).toFixed(0);
+                // Show category distribution of existing buffer
+                const counts = {};
+                for (const msg of session.buffer) {
+                    counts[msg.category] = (counts[msg.category] ?? 0) + 1;
+                }
+                const dist = Object.entries(counts)
+                    .sort(([, a], [, b]) => b - a)
+                    .map(([cat, n]) => `${cat}: ${n}`)
+                    .join(", ");
+                return {
+                    content: [{
+                            type: "text",
+                            text: `No new messages. Running ${elapsed}s, buffer: ${session.buffer.length}/${session.maxMessages}\nCategory distribution: ${dist || "(empty)"}`,
+                        }],
+                };
+            }
+            // Get new messages
+            const startIdx = session.readCursor;
+            let messages = [];
+            for (let i = startIdx; i < session.buffer.length; i++) {
+                messages.push({ parsed: session.buffer[i], raw: session.rawBuffer[i] });
+            }
+            // Filter by category
+            if (category) {
+                messages = messages.filter((m) => m.parsed.category === category);
+            }
+            // Limit
+            const limited = messages.slice(0, maxMessages);
+            // Advance cursor (always, regardless of filter)
+            session.readCursor = session.buffer.length;
+            if (limited.length === 0) {
+                return {
+                    content: [{ type: "text", text: `${available} new message(s) but none match category "${category}".` }],
+                };
+            }
+            let output;
+            if (raw) {
+                output = limited.map((m) => m.raw).join("\n");
+            }
+            else {
+                output = limited.map((m) => {
+                    const p = m.parsed;
+                    return `[${p.timestamp}] [${p.category}] ${p.tag}: ${p.raw}`;
+                }).join("\n");
+            }
+            const remaining = messages.length - limited.length;
+            if (remaining > 0) {
+                output += `\n\n--- ${remaining} more messages available, poll again ---`;
+            }
+            return { content: [{ type: "text", text: OutputProcessor.process(output) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_ril_stop", "Stop a RIL capture session. Shows a summary of captured message categories.", {
+        session: z.string().describe("Session ID to stop (e.g., 'ril_1'), or 'all' to stop all"),
+    }, async ({ session: sessionId }) => {
+        try {
+            if (sessionId === "all") {
+                const count = sessions.size;
+                for (const [, s] of sessions) {
+                    try {
+                        s.process.kill();
+                    }
+                    catch { /* ignore */ }
+                }
+                sessions.clear();
+                return { content: [{ type: "text", text: `Stopped ${count} RIL session(s).` }] };
+            }
+            const session = sessions.get(sessionId);
+            if (!session) {
+                return { content: [{ type: "text", text: `Session "${sessionId}" not found.` }], isError: true };
+            }
+            const elapsed = ((Date.now() - session.startedAt) / 1000).toFixed(1);
+            // Category summary
+            const counts = {};
+            for (const msg of session.buffer) {
+                counts[msg.category] = (counts[msg.category] ?? 0) + 1;
+            }
+            const dist = Object.entries(counts)
+                .sort(([, a], [, b]) => b - a)
+                .map(([cat, n]) => `  ${cat}: ${n}`)
+                .join("\n");
+            try {
+                session.process.kill();
+            }
+            catch { /* ignore */ }
+            sessions.delete(sessionId);
+            const summary = [];
+            summary.push(`Stopped ${sessionId}. Duration: ${elapsed}s, Total messages: ${session.buffer.length}`);
+            if (dist) {
+                summary.push(`\nMessage categories:\n${dist}`);
+            }
+            return { content: [{ type: "text", text: summary.join("\n") }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=ril-intercept.js.map

package/build/tools/ril-intercept.js.map

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

package/build/tools/screen-record.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Screen Recording Tools — Start/stop video capture on the device.
+ *
+ * Uses `adb shell screenrecord` with a background process pattern.
+ * The recording runs on-device; stop pulls the mp4 locally.
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerScreenRecordTools(ctx: ToolContext): void;
+//# sourceMappingURL=screen-record.d.ts.map

package/build/tools/screen-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-record.d.ts","sourceRoot":"","sources":["../../src/tools/screen-record.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAcjD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA8GhE"}

package/build/tools/screen-record.js

@@ -0,0 +1,95 @@
+/**
+ * Screen Recording Tools — Start/stop video capture on the device.
+ *
+ * Uses `adb shell screenrecord` with a background process pattern.
+ * The recording runs on-device; stop pulls the mp4 locally.
+ */
+import { z } from "zod";
+import { join } from "path";
+import { OutputProcessor } from "../middleware/output-processor.js";
+import { shellEscape } from "../middleware/sanitize.js";
+/** Only one recording per device at a time. Key = device serial. */
+const recordings = new Map();
+export function registerScreenRecordTools(ctx) {
+    ctx.server.tool("adb_screenrecord_start", "Start recording the device screen. Recording runs on-device. Use adb_screenrecord_stop to finish and pull the video file.", {
+        maxDuration: z.number().min(1).max(180).optional().default(60)
+            .describe("Maximum recording duration in seconds (1-180, default 60)"),
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ maxDuration, device }) => {
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            const serial = resolved.serial;
+            if (recordings.has(serial)) {
+                return { content: [{ type: "text", text: `Recording already in progress on ${serial}. Stop it first with adb_screenrecord_stop.` }], isError: true };
+            }
+            const filename = `screenrecord_${Date.now()}.mp4`;
+            const remotePath = `/sdcard/${filename}`;
+            // Start screenrecord in background via shell nohup
+            // screenrecord auto-stops at --time-limit
+            await ctx.bridge.shell(`nohup screenrecord --time-limit ${maxDuration} '${shellEscape(remotePath)}' > /dev/null 2>&1 &`, { device: serial, ignoreExitCode: true });
+            recordings.set(serial, {
+                device: serial,
+                remotePath,
+                startedAt: Date.now(),
+                maxDuration,
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: `Recording started on ${serial}\nMax duration: ${maxDuration}s\nDevice path: ${remotePath}\nUse adb_screenrecord_stop to finish and pull the video.`,
+                    }],
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+    ctx.server.tool("adb_screenrecord_stop", "Stop an active screen recording and pull the video file locally. If the recording has already finished (hit time limit), this just pulls the file.", {
+        device: z.string().optional().describe("Device serial"),
+    }, async ({ device }) => {
+        let resolvedSerial;
+        try {
+            const resolved = await ctx.deviceManager.resolveDevice(device);
+            resolvedSerial = resolved.serial;
+            const serial = resolved.serial;
+            const session = recordings.get(serial);
+            if (!session) {
+                return { content: [{ type: "text", text: `No active recording on ${serial}.` }], isError: true };
+            }
+            // Kill the screenrecord process writing to our specific file.
+            // Uses pgrep (by binary name) + /proc/cmdline grep to avoid the pkill -f
+            // self-match bug: on-device, pkill -f runs through su -c whose cmdline
+            // contains the pattern, causing pkill to kill itself instead of screenrecord.
+            const recordFilename = session.remotePath.split("/").pop() ?? "";
+            await ctx.bridge.shell(`pgrep screenrecord | while read p; do grep -q '${recordFilename}' /proc/$p/cmdline 2>/dev/null && kill $p; done 2>/dev/null; true`, { device: serial, ignoreExitCode: true, timeout: 5000 });
+            // Brief wait for file to finalize
+            await new Promise((r) => setTimeout(r, 1500));
+            // Pull the file locally
+            const localFilename = session.remotePath.split("/").pop() ?? "recording.mp4";
+            const localPath = join(ctx.config.tempDir, localFilename);
+            await ctx.bridge.exec(["pull", session.remotePath, localPath], {
+                device: serial, timeout: 60000,
+            });
+            // Clean up device file
+            await ctx.bridge.shell(`rm '${shellEscape(session.remotePath)}'`, {
+                device: serial, ignoreExitCode: true,
+            });
+            const elapsed = ((Date.now() - session.startedAt) / 1000).toFixed(1);
+            recordings.delete(serial);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Recording saved: ${localPath}\nDuration: ~${elapsed}s`,
+                    }],
+            };
+        }
+        catch (error) {
+            // Clean up session state even on error
+            if (resolvedSerial) {
+                recordings.delete(resolvedSerial);
+            }
+            return { content: [{ type: "text", text: OutputProcessor.formatError(error) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=screen-record.js.map

package/build/tools/screen-record.js.map

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

package/build/tools/screenshot-diff.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Screenshot Diffing Tools — Pixel-level screenshot comparison for visual regression detection.
+ *
+ * Extends the regression detection capabilities with visual comparison.
+ * Captures baseline screenshots, compares current screen state against them,
+ * and reports differences. Uses raw screencap data for pixel-level comparison
+ * without external image processing dependencies.
+ *
+ * Baselines are saved as PNG files in {tempDir}/screenshot-baselines/.
+ */
+import { ToolContext } from "../tool-context.js";
+export declare function registerScreenshotDiffTools(ctx: ToolContext): void;
+//# sourceMappingURL=screenshot-diff.d.ts.map

package/build/tools/screenshot-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-diff.d.ts","sourceRoot":"","sources":["../../src/tools/screenshot-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAkOjD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAiMlE"}