cbrowser 6.3.2 → 6.5.0

package/dist/daemon.js

@@ -0,0 +1,358 @@
+"use strict";
+/**
+ * CBrowser Daemon Mode
+ *
+ * Keeps browser running between CLI commands for faster iteration.
+ *
+ * Usage:
+ *   cbrowser daemon start     # Start daemon in background
+ *   cbrowser daemon stop      # Stop daemon
+ *   cbrowser daemon status    # Check if daemon is running
+ *
+ * Once running, all other commands automatically connect to the daemon
+ * instead of launching a new browser.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDaemonState = getDaemonState;
+exports.isDaemonRunning = isDaemonRunning;
+exports.sendToDaemon = sendToDaemon;
+exports.startDaemon = startDaemon;
+exports.stopDaemon = stopDaemon;
+exports.getDaemonStatus = getDaemonStatus;
+exports.runDaemonServer = runDaemonServer;
+const http_1 = require("http");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const child_process_1 = require("child_process");
+const browser_js_1 = require("./browser.js");
+const config_js_1 = require("./config.js");
+const DEFAULT_PORT = 9222;
+const DAEMON_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes idle timeout
+/**
+ * Get the daemon state file path
+ */
+function getDaemonStatePath() {
+    const paths = (0, config_js_1.getPaths)();
+    return (0, path_1.join)(paths.dataDir, "daemon.json");
+}
+/**
+ * Get the daemon log file path
+ */
+function getDaemonLogPath() {
+    const paths = (0, config_js_1.getPaths)();
+    return (0, path_1.join)(paths.dataDir, "daemon.log");
+}
+/**
+ * Read daemon state from disk
+ */
+function getDaemonState() {
+    const statePath = getDaemonStatePath();
+    if (!(0, fs_1.existsSync)(statePath)) {
+        return null;
+    }
+    try {
+        const data = (0, fs_1.readFileSync)(statePath, "utf-8");
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write daemon state to disk
+ */
+function writeDaemonState(state) {
+    const statePath = getDaemonStatePath();
+    (0, fs_1.writeFileSync)(statePath, JSON.stringify(state, null, 2));
+}
+/**
+ * Clear daemon state file
+ */
+function clearDaemonState() {
+    const statePath = getDaemonStatePath();
+    if ((0, fs_1.existsSync)(statePath)) {
+        (0, fs_1.unlinkSync)(statePath);
+    }
+}
+/**
+ * Check if daemon is running
+ */
+async function isDaemonRunning() {
+    const state = getDaemonState();
+    if (!state) {
+        return false;
+    }
+    // Try to ping the daemon
+    try {
+        const response = await fetch(`http://127.0.0.1:${state.port}/ping`, {
+            method: "GET",
+            signal: AbortSignal.timeout(1000),
+        });
+        return response.ok;
+    }
+    catch {
+        // Daemon not responding, clean up stale state
+        clearDaemonState();
+        return false;
+    }
+}
+/**
+ * Send a command to the running daemon
+ */
+async function sendToDaemon(command, args = {}) {
+    const state = getDaemonState();
+    if (!state) {
+        return { success: false, error: "Daemon not running" };
+    }
+    try {
+        const response = await fetch(`http://127.0.0.1:${state.port}/command`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ command, args }),
+            signal: AbortSignal.timeout(120000), // 2 minute timeout for commands
+        });
+        const data = await response.json();
+        return data;
+    }
+    catch (err) {
+        return { success: false, error: `Failed to communicate with daemon: ${err}` };
+    }
+}
+/**
+ * Start the daemon in the background
+ */
+async function startDaemon(port = DEFAULT_PORT) {
+    // Check if already running
+    if (await isDaemonRunning()) {
+        const state = getDaemonState();
+        return { success: true, message: `Daemon already running on port ${state.port} (PID: ${state.pid})` };
+    }
+    // Start daemon as background process
+    const logPath = getDaemonLogPath();
+    const child = (0, child_process_1.spawn)(process.execPath, [process.argv[1], "daemon", "run", "--port", String(port)], {
+        detached: true,
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    // Write logs to file
+    const logStream = require("fs").createWriteStream(logPath, { flags: "a" });
+    child.stdout?.pipe(logStream);
+    child.stderr?.pipe(logStream);
+    child.unref();
+    // Wait for daemon to be ready
+    const maxWait = 10000;
+    const startTime = Date.now();
+    while (Date.now() - startTime < maxWait) {
+        await new Promise(resolve => setTimeout(resolve, 200));
+        if (await isDaemonRunning()) {
+            const state = getDaemonState();
+            return { success: true, message: `Daemon started on port ${state.port} (PID: ${state.pid})` };
+        }
+    }
+    return { success: false, message: "Daemon failed to start within 10 seconds" };
+}
+/**
+ * Stop the running daemon
+ */
+async function stopDaemon() {
+    const state = getDaemonState();
+    if (!state) {
+        return { success: true, message: "Daemon not running" };
+    }
+    try {
+        // Send shutdown command
+        await fetch(`http://127.0.0.1:${state.port}/shutdown`, {
+            method: "POST",
+            signal: AbortSignal.timeout(5000),
+        }).catch(() => { });
+        // Wait for daemon to stop
+        await new Promise(resolve => setTimeout(resolve, 500));
+        // Force kill if still running
+        try {
+            process.kill(state.pid, 0); // Check if process exists
+            process.kill(state.pid, "SIGTERM");
+        }
+        catch {
+            // Process already gone
+        }
+        clearDaemonState();
+        return { success: true, message: `Daemon stopped (was PID: ${state.pid})` };
+    }
+    catch (err) {
+        clearDaemonState();
+        return { success: true, message: `Daemon stopped (cleanup: ${err})` };
+    }
+}
+/**
+ * Get daemon status
+ */
+async function getDaemonStatus() {
+    const running = await isDaemonRunning();
+    const state = getDaemonState();
+    if (!running || !state) {
+        return "Daemon is not running";
+    }
+    const uptime = Math.round((Date.now() - new Date(state.startedAt).getTime()) / 1000);
+    const lastActivity = Math.round((Date.now() - new Date(state.lastActivity).getTime()) / 1000);
+    return `Daemon running:
+  PID: ${state.pid}
+  Port: ${state.port}
+  Uptime: ${uptime}s
+  Last activity: ${lastActivity}s ago`;
+}
+/**
+ * Run the daemon server (called in foreground mode)
+ */
+async function runDaemonServer(config, port = DEFAULT_PORT) {
+    let browser = null;
+    let idleTimer = null;
+    let lastActivity = new Date();
+    const resetIdleTimer = () => {
+        lastActivity = new Date();
+        if (idleTimer) {
+            clearTimeout(idleTimer);
+        }
+        idleTimer = setTimeout(async () => {
+            console.log(`[${new Date().toISOString()}] Daemon idle timeout, shutting down...`);
+            await shutdown();
+        }, DAEMON_TIMEOUT_MS);
+    };
+    const updateState = () => {
+        const state = getDaemonState();
+        if (state) {
+            state.lastActivity = lastActivity.toISOString();
+            writeDaemonState(state);
+        }
+    };
+    const getBrowser = async () => {
+        if (!browser) {
+            const fullConfig = (0, config_js_1.mergeConfig)({ ...config, persistent: true });
+            browser = new browser_js_1.CBrowser(fullConfig);
+        }
+        return browser;
+    };
+    const handleCommand = async (req) => {
+        resetIdleTimer();
+        updateState();
+        try {
+            const b = await getBrowser();
+            switch (req.command) {
+                case "navigate": {
+                    const url = req.args.url;
+                    const result = await b.navigate(url);
+                    return { success: true, result };
+                }
+                case "click": {
+                    const selector = req.args.selector;
+                    const result = await b.click(selector);
+                    return { success: true, result };
+                }
+                case "fill": {
+                    const selector = req.args.selector;
+                    const value = req.args.value;
+                    const result = await b.fill(selector, value);
+                    return { success: true, result };
+                }
+                case "screenshot": {
+                    const path = req.args.path;
+                    const result = await b.screenshot(path);
+                    return { success: true, result };
+                }
+                case "extract": {
+                    const what = req.args.what;
+                    const result = await b.extract(what);
+                    return { success: true, result };
+                }
+                case "run": {
+                    const command = req.args.command;
+                    const result = await (0, browser_js_1.executeNaturalLanguage)(b, command);
+                    return { success: true, result };
+                }
+                case "getPage": {
+                    // Navigate to about:blank to ensure page is loaded, then get info
+                    const navResult = await b.navigate("about:blank");
+                    return {
+                        success: true,
+                        result: {
+                            url: navResult.url,
+                            title: navResult.title,
+                        },
+                    };
+                }
+                default:
+                    return { success: false, error: `Unknown command: ${req.command}` };
+            }
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    };
+    const server = (0, http_1.createServer)(async (req, res) => {
+        // CORS headers
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        if (req.url === "/ping" && req.method === "GET") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok", uptime: process.uptime() }));
+            return;
+        }
+        if (req.url === "/shutdown" && req.method === "POST") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "shutting down" }));
+            await shutdown();
+            return;
+        }
+        if (req.url === "/command" && req.method === "POST") {
+            let body = "";
+            req.on("data", chunk => { body += chunk; });
+            req.on("end", async () => {
+                try {
+                    const request = JSON.parse(body);
+                    const response = await handleCommand(request);
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify(response));
+                }
+                catch (err) {
+                    res.writeHead(400, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ success: false, error: `Invalid request: ${err}` }));
+                }
+            });
+            return;
+        }
+        res.writeHead(404, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "Not found" }));
+    });
+    const shutdown = async () => {
+        if (idleTimer) {
+            clearTimeout(idleTimer);
+        }
+        if (browser) {
+            await browser.close();
+        }
+        server.close();
+        clearDaemonState();
+        process.exit(0);
+    };
+    // Handle termination signals
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+    // Start server
+    server.listen(port, "127.0.0.1", () => {
+        const state = {
+            pid: process.pid,
+            port,
+            startedAt: new Date().toISOString(),
+            lastActivity: new Date().toISOString(),
+        };
+        writeDaemonState(state);
+        console.log(`[${new Date().toISOString()}] CBrowser daemon started on port ${port} (PID: ${process.pid})`);
+        console.log(`[${new Date().toISOString()}] Idle timeout: ${DAEMON_TIMEOUT_MS / 1000 / 60} minutes`);
+        resetIdleTimer();
+    });
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAiDH,wCAWC;AAuBD,0CAkBC;AAKD,oCAmBC;AAKD,kCAsCC;AAKD,gCA8BC;AAKD,0CAgBC;AAKD,0CA8KC;AAjZD,+BAA4F;AAC5F,2BAAyE;AACzE,+BAA4B;AAC5B,iDAAyD;AACzD,6CAAgE;AAChE,2CAAyE;AAEzE,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,0BAA0B;AAoBpE;;GAEG;AACH,SAAS,kBAAkB;IACzB,MAAM,KAAK,GAAG,IAAA,oBAAQ,GAAE,CAAC;IACzB,OAAO,IAAA,WAAI,EAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB;IACvB,MAAM,KAAK,GAAG,IAAA,oBAAQ,GAAE,CAAC;IACzB,OAAO,IAAA,WAAI,EAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc;IAC5B,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,IAAI,CAAC,IAAA,eAAU,EAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAA,iBAAY,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAkB;IAC1C,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,IAAA,kBAAa,EAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB;IACvB,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,IAAI,IAAA,eAAU,EAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,IAAA,eAAU,EAAC,SAAS,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe;IACnC,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,yBAAyB;IACzB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,oBAAoB,KAAK,CAAC,IAAI,OAAO,EAAE;YAClE,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;QAC9C,gBAAgB,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,OAAgC,EAAE;IACpF,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,oBAAoB,KAAK,CAAC,IAAI,UAAU,EAAE;YACrE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAmB,CAAC;YACxD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,gCAAgC;SACtE,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAoB,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,sCAAsC,GAAG,EAAE,EAAE,CAAC;IAChF,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,WAAW,CAAC,OAAe,YAAY;IAC3D,2BAA2B;IAC3B,IAAI,MAAM,eAAe,EAAE,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,cAAc,EAAG,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,kCAAkC,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC;IACxG,CAAC;IAED,qCAAqC;IACrC,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAA,qBAAK,EACjB,OAAO,CAAC,QAAQ,EAChB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAC1D;QACE,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CACF,CAAC;IAEF,qBAAqB;IACrB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3E,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAE9B,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,8BAA8B;IAC9B,MAAM,OAAO,GAAG,KAAK,CAAC;IACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;QACxC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QACvD,IAAI,MAAM,eAAe,EAAE,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,cAAc,EAAG,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,0BAA0B,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC;QAChG,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;AACjF,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,UAAU;IAC9B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC;QACH,wBAAwB;QACxB,MAAM,KAAK,CAAC,oBAAoB,KAAK,CAAC,IAAI,WAAW,EAAE;YACrD,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEnB,0BAA0B;QAC1B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAEvD,8BAA8B;QAC9B,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,0BAA0B;YACtD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QAED,gBAAgB,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,4BAA4B,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC;IAC9E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,gBAAgB,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,4BAA4B,GAAG,GAAG,EAAE,CAAC;IACxE,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe;IACnC,MAAM,OAAO,GAAG,MAAM,eAAe,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAE/B,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACrF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAE9F,OAAO;SACA,KAAK,CAAC,GAAG;UACR,KAAK,CAAC,IAAI;YACR,MAAM;mBACC,YAAY,OAAO,CAAC;AACvC,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe,CAAC,MAA+B,EAAE,OAAe,YAAY;IAChG,IAAI,OAAO,GAAoB,IAAI,CAAC;IACpC,IAAI,SAAS,GAA0B,IAAI,CAAC;IAC5C,IAAI,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;IAE9B,MAAM,cAAc,GAAG,GAAG,EAAE;QAC1B,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QACD,SAAS,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YAChC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,yCAAyC,CAAC,CAAC;YACnF,MAAM,QAAQ,EAAE,CAAC;QACnB,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;QAC/B,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,YAAY,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;YAChD,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,IAAuB,EAAE;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,UAAU,GAAG,IAAA,uBAAW,EAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAChE,OAAO,GAAG,IAAI,qBAAQ,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,EAAE,GAAkB,EAA2B,EAAE;QAC1E,cAAc,EAAE,CAAC;QACjB,WAAW,EAAE,CAAC;QAEd,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,UAAU,EAAE,CAAC;YAE7B,QAAQ,GAAG,CAAC,OAAO,EAAE,CAAC;gBACpB,KAAK,UAAU,CAAC,CAAC,CAAC;oBAChB,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAa,CAAC;oBACnC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACnC,CAAC;gBAED,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,QAAkB,CAAC;oBAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;oBACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACnC,CAAC;gBAED,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,QAAkB,CAAC;oBAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,KAAe,CAAC;oBACvC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;oBAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACnC,CAAC;gBAED,KAAK,YAAY,CAAC,CAAC,CAAC;oBAClB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAA0B,CAAC;oBACjD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;oBACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACnC,CAAC;gBAED,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAc,CAAC;oBACrC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACnC,CAAC;gBAED,KAAK,KAAK,CAAC,CAAC,CAAC;oBACX,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,OAAiB,CAAC;oBAC3C,MAAM,MAAM,GAAG,MAAM,IAAA,mCAAsB,EAAC,CAAC,EAAE,OAAO,CAAC,CAAC;oBACxD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACnC,CAAC;gBAED,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,kEAAkE;oBAClE,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;oBAClD,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,MAAM,EAAE;4BACN,GAAG,EAAE,SAAS,CAAC,GAAG;4BAClB,KAAK,EAAE,SAAS,CAAC,KAAK;yBACvB;qBACF,CAAC;gBACJ,CAAC;gBAED;oBACE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACxE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAW,IAAA,mBAAY,EAAC,KAAK,EAAE,GAAoB,EAAE,GAAmB,EAAE,EAAE;QACtF,eAAe;QACf,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;QAClD,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,oBAAoB,CAAC,CAAC;QACpE,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,cAAc,CAAC,CAAC;QAE9D,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnB,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,GAAG,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAChD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,GAAG,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACrD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;YACrD,MAAM,QAAQ,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,GAAG,KAAK,UAAU,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACpD,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;gBACvB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;oBAClD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;oBAC9C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;oBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;oBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;gBAChF,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,gBAAgB,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,6BAA6B;IAC7B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE/B,eAAe;IACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;QACpC,MAAM,KAAK,GAAgB;YACzB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,IAAI;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACvC,CAAC;QACF,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAExB,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,qCAAqC,IAAI,UAAU,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;QAC3G,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,mBAAmB,iBAAiB,GAAG,IAAI,GAAG,EAAE,UAAU,CAAC,CAAC;QAEpG,cAAc,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -17,4 +17,5 @@ export type { CBrowserConfig, CBrowserPaths, BrowserType } from "./config.js";
 export * from "./types.js";
 export { BUILTIN_PERSONAS } from "./personas.js";
 export { startMcpServer } from "./mcp-server.js";
+export { startDaemon, stopDaemon, getDaemonStatus, isDaemonRunning, sendToDaemon, runDaemonServer } from "./daemon.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzF,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9E,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzF,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9E,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -27,7 +27,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.startMcpServer = exports.BUILTIN_PERSONAS = exports.mergeConfig = exports.ensureDirectories = exports.getPaths = exports.getDefaultConfig = exports.CBrowser = void 0;
+exports.runDaemonServer = exports.sendToDaemon = exports.isDaemonRunning = exports.getDaemonStatus = exports.stopDaemon = exports.startDaemon = exports.startMcpServer = exports.BUILTIN_PERSONAS = exports.mergeConfig = exports.ensureDirectories = exports.getPaths = exports.getDefaultConfig = exports.CBrowser = void 0;
 var browser_js_1 = require("./browser.js");
 Object.defineProperty(exports, "CBrowser", { enumerable: true, get: function () { return browser_js_1.CBrowser; } });
 var config_js_1 = require("./config.js");
@@ -40,4 +40,11 @@ var personas_js_1 = require("./personas.js");
 Object.defineProperty(exports, "BUILTIN_PERSONAS", { enumerable: true, get: function () { return personas_js_1.BUILTIN_PERSONAS; } });
 var mcp_server_js_1 = require("./mcp-server.js");
 Object.defineProperty(exports, "startMcpServer", { enumerable: true, get: function () { return mcp_server_js_1.startMcpServer; } });
+var daemon_js_1 = require("./daemon.js");
+Object.defineProperty(exports, "startDaemon", { enumerable: true, get: function () { return daemon_js_1.startDaemon; } });
+Object.defineProperty(exports, "stopDaemon", { enumerable: true, get: function () { return daemon_js_1.stopDaemon; } });
+Object.defineProperty(exports, "getDaemonStatus", { enumerable: true, get: function () { return daemon_js_1.getDaemonStatus; } });
+Object.defineProperty(exports, "isDaemonRunning", { enumerable: true, get: function () { return daemon_js_1.isDaemonRunning; } });
+Object.defineProperty(exports, "sendToDaemon", { enumerable: true, get: function () { return daemon_js_1.sendToDaemon; } });
+Object.defineProperty(exports, "runDaemonServer", { enumerable: true, get: function () { return daemon_js_1.runDaemonServer; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;;AAEH,2CAAwC;AAA/B,sGAAA,QAAQ,OAAA;AACjB,yCAAyF;AAAhF,6GAAA,gBAAgB,OAAA;AAAE,qGAAA,QAAQ,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,wGAAA,WAAW,OAAA;AAEnE,6CAA2B;AAC3B,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AACzB,iDAAiD;AAAxC,+GAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;;AAEH,2CAAwC;AAA/B,sGAAA,QAAQ,OAAA;AACjB,yCAAyF;AAAhF,6GAAA,gBAAgB,OAAA;AAAE,qGAAA,QAAQ,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,wGAAA,WAAW,OAAA;AAEnE,6CAA2B;AAC3B,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AACzB,iDAAiD;AAAxC,+GAAA,cAAc,OAAA;AACvB,yCAAuH;AAA9G,wGAAA,WAAW,OAAA;AAAE,uGAAA,UAAU,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,4GAAA,eAAe,OAAA"}

package/dist/types.d.ts

@@ -810,4 +810,213 @@ export interface TestGenerationResult {
     cbrowserScript: string;
     playwrightCode: string;
 }
+export interface PerformanceBaseline {
+    /** Unique identifier for this baseline */
+    id: string;
+    /** URL this baseline was captured from */
+    url: string;
+    /** Human-readable name for this baseline */
+    name: string;
+    /** Timestamp when baseline was captured */
+    timestamp: string;
+    /** Performance metrics captured */
+    metrics: PerformanceMetrics;
+    /** Number of runs averaged (for stability) */
+    runsAveraged: number;
+    /** Environment info */
+    environment: {
+        browser: string;
+        viewport: {
+            width: number;
+            height: number;
+        };
+        device?: string;
+        connection?: string;
+    };
+}
+export interface PerformanceRegressionThresholds {
+    /** Max allowed increase in LCP (percentage, default: 20) */
+    lcp?: number;
+    /** Max allowed increase in FID (percentage, default: 50) */
+    fid?: number;
+    /** Max allowed increase in CLS (absolute, default: 0.1) */
+    cls?: number;
+    /** Max allowed increase in FCP (percentage, default: 20) */
+    fcp?: number;
+    /** Max allowed increase in TTFB (percentage, default: 30) */
+    ttfb?: number;
+    /** Max allowed increase in TTI (percentage, default: 25) */
+    tti?: number;
+    /** Max allowed increase in TBT (percentage, default: 50) */
+    tbt?: number;
+    /** Max allowed increase in transfer size (percentage, default: 25) */
+    transferSize?: number;
+}
+export interface MetricRegression {
+    /** Metric name */
+    metric: keyof PerformanceMetrics;
+    /** Baseline value */
+    baselineValue: number;
+    /** Current value */
+    currentValue: number;
+    /** Change amount */
+    change: number;
+    /** Change percentage */
+    changePercent: number;
+    /** Threshold that was exceeded */
+    threshold: number;
+    /** Severity of regression */
+    severity: "warning" | "regression" | "critical";
+}
+export interface PerformanceComparison {
+    /** Metric name */
+    metric: keyof PerformanceMetrics;
+    /** Baseline value */
+    baseline: number;
+    /** Current value */
+    current: number;
+    /** Change amount (positive = worse, negative = better) */
+    change: number;
+    /** Change percentage */
+    changePercent: number;
+    /** Is this a regression? */
+    isRegression: boolean;
+    /** Is this an improvement? */
+    isImprovement: boolean;
+    /** Status indicator */
+    status: "improved" | "stable" | "warning" | "regression" | "critical";
+}
+export interface PerformanceRegressionResult {
+    /** URL tested */
+    url: string;
+    /** Baseline used for comparison */
+    baseline: PerformanceBaseline;
+    /** Current metrics */
+    currentMetrics: PerformanceMetrics;
+    /** Timestamp of this test */
+    timestamp: string;
+    /** Duration of test */
+    duration: number;
+    /** Detailed comparison per metric */
+    comparisons: PerformanceComparison[];
+    /** Detected regressions */
+    regressions: MetricRegression[];
+    /** Overall result */
+    passed: boolean;
+    /** Summary */
+    summary: {
+        totalMetrics: number;
+        improved: number;
+        stable: number;
+        regressed: number;
+        critical: number;
+        overallChange: number;
+    };
+}
+export interface TestedPage {
+    /** URL or route pattern */
+    url: string;
+    /** Normalized path for matching */
+    path: string;
+    /** Test files that cover this page */
+    testFiles: string[];
+    /** Actions tested on this page */
+    actions: TestedAction[];
+    /** Number of test cases covering this page */
+    testCount: number;
+    /** Coverage score (0-100) */
+    coverageScore: number;
+}
+export interface TestedAction {
+    /** Action type */
+    type: "navigate" | "click" | "fill" | "verify" | "wait" | "scroll" | "hover";
+    /** Target element description */
+    target?: string;
+    /** Value if applicable */
+    value?: string;
+    /** Test file containing this action */
+    testFile: string;
+    /** Line number in test file */
+    lineNumber?: number;
+}
+export interface SitePage {
+    /** Full URL */
+    url: string;
+    /** Path portion of URL */
+    path: string;
+    /** Page title if available */
+    title?: string;
+    /** Discovered from source */
+    source: "sitemap" | "crawl" | "link";
+    /** HTTP status code */
+    status?: number;
+    /** Links found on this page */
+    outboundLinks?: string[];
+    /** Interactive elements found */
+    interactiveElements?: number;
+    /** Forms found */
+    formCount?: number;
+}
+export interface CoverageGap {
+    /** Page without adequate test coverage */
+    page: SitePage;
+    /** Why this is flagged as a gap */
+    reason: "untested" | "low-coverage" | "no-interactions" | "no-verifications";
+    /** Priority level */
+    priority: "critical" | "high" | "medium" | "low";
+    /** Suggested test steps */
+    suggestedTests: string[];
+    /** Similar pages that are tested (for reference) */
+    similarTestedPages?: string[];
+}
+export interface TestCoverageAnalysis {
+    /** Total pages found on site */
+    totalPages: number;
+    /** Pages with at least one test */
+    testedPages: number;
+    /** Pages with no tests */
+    untestedPages: number;
+    /** Overall coverage percentage */
+    coveragePercent: number;
+    /** Coverage by section/route prefix */
+    sectionCoverage: Record<string, {
+        total: number;
+        tested: number;
+        percent: number;
+    }>;
+}
+export interface CoverageMapResult {
+    /** Base URL of the site */
+    baseUrl: string;
+    /** Timestamp of analysis */
+    timestamp: string;
+    /** Duration of analysis */
+    duration: number;
+    /** Test files analyzed */
+    testFiles: string[];
+    /** All pages found on site */
+    sitePages: SitePage[];
+    /** Pages with test coverage */
+    testedPages: TestedPage[];
+    /** Coverage gaps identified */
+    gaps: CoverageGap[];
+    /** Overall analysis */
+    analysis: TestCoverageAnalysis;
+    /** Recommendations */
+    recommendations: string[];
+}
+export interface CoverageMapOptions {
+    /** Sitemap URL to use instead of crawling */
+    sitemapUrl?: string;
+    /** Max pages to crawl (default: 100) */
+    maxPages?: number;
+    /** Include only paths matching pattern */
+    includePattern?: string;
+    /** Exclude paths matching pattern */
+    excludePattern?: string;
+    /** Minimum coverage % to not flag as gap (default: 50) */
+    minCoverage?: number;
+    /** Output format */
+    format?: "json" | "html" | "summary";
+}
 //# sourceMappingURL=types.d.ts.map