cbrowser 19.4.2 → 19.5.0

package/dist/cli.js

@@ -29,6 +29,7 @@ import { getStatusInfo, formatStatus, getDataDir, getPaths } from "./config.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { resolveCookieDomain, hostFromUrl } from "./utils.js";
 import { dirname, join, resolve } from "node:path";
+import { guardConsole, guardTerminalOutput } from "./terminal-safe.js";
 import { VideoCaptureSession } from "./recording/engine.js";
 import { changeSignal, parseManifest } from "./recording/types.js";
 import { printEnterpriseStatus } from "./stealth/index.js";
@@ -339,10 +340,16 @@ PERFORMANCE REGRESSION (v6.4.0)
       cbrowser perf-regression "https://example.com" homepage --sensitivity strict
       cbrowser perf-regression "https://example.com" homepage --threshold-lcp 30
 
-NETWORK / HAR
-  har start                   Start recording HAR
+NETWORK / HAR (need the daemon: each command is its own process)
+  daemon start                Start the daemon first; it holds the browser between commands
+  har start                   Start recording HAR in the daemon's browser
   har stop [output]           Stop and save HAR file
-  network list                List captured network requests
+  network list                List network requests the daemon's browser captured
+  network clear               Clear that list
+  console                     List the daemon tab's console messages (errors, warnings, logs)
+    --filter <type>           all | error | warning | log | info (default all)
+    --clear                   Empty the console buffer after reading
+    --json                    Print the raw messages as JSON
 
 VISUAL REGRESSION (v2.5.0)
   visual save <name>          Save baseline screenshot
@@ -2612,6 +2619,12 @@ async function main() {
     const outputOpts = detectOutputOptions(options);
     setOutputOptions(outputOpts);
     installOutputWrappers();
+    // Page-derived text (console messages, titles, extracted text) reaches stdout in
+    // many places; escape sequences and bidi overrides in it come out as visible
+    // escapes instead of acting on the terminal. (2026-10-12)
+    guardTerminalOutput(process.stdout);
+    guardTerminalOutput(process.stderr);
+    guardConsole();
     // --json-output must never leave stdout empty. Only two commands in this file
     // call emitJson, so without this every other command printed nothing at all and
     // still exited 0 — a CI step piping to jq saw empty input beside a success code.
@@ -4381,32 +4394,122 @@ Documentation: https://github.com/alexandriashai/cbrowser/wiki
             // =========================================================================
             case "har": {
                 const subcommand = args[0];
-                switch (subcommand) {
-                    case "start": {
-                        browser.startHarRecording();
-                        console.log("✓ HAR recording started");
-                        console.log("  Navigate and interact with pages, then run 'cbrowser har stop'");
-                        break;
+                if (subcommand !== "start" && subcommand !== "stop") {
+                    console.error("Usage: cbrowser har [start|stop]");
+                    break;
+                }
+                // A recording has to span several commands, and each cbrowser command is
+                // its own process: only the daemon's browser outlives them. Recorded here,
+                // start, navigate and stop were three processes and every HAR was empty,
+                // with or without a daemon, while this printed "started" and "saved".
+                // (2026-10-12)
+                if (!(await isDaemonRunning())) {
+                    console.error("Error: HAR recording spans several commands, and each cbrowser command is its own process,");
+                    console.error("  so nothing records between them. Start the daemon first:");
+                    console.error("  cbrowser daemon start  ->  cbrowser har start  ->  navigate/click...  ->  cbrowser har stop [file]");
+                    process.exit(1);
+                }
+                const response = subcommand === "start"
+                    ? await sendToDaemon("harStart", {})
+                    : await sendToDaemon("harStop", {});
+                if (!response.success) {
+                    console.error(`✗ Daemon error: ${response.error}`);
+                    process.exit(1);
+                }
+                if (subcommand === "start") {
+                    console.log("✓ HAR recording started in the daemon");
+                    console.log("  Navigate and interact with pages, then run 'cbrowser har stop'");
+                }
+                else {
+                    // The daemon writes only its own har directory; a chosen path is written here,
+                    // with this process's permissions.
+                    const { file, har } = response.result;
+                    if (args[1]) {
+                        const out = resolve(args[1]);
+                        writeFileSync(out, har);
+                        console.log(`✓ HAR saved: ${out}`);
                     }
-                    case "stop": {
-                        const output = args[1];
-                        const filename = await browser.exportHar(output);
-                        console.log(`✓ HAR saved: ${filename}`);
-                        break;
+                    else {
+                        console.log(`✓ HAR saved: ${file}`);
                     }
-                    default:
-                        console.error("Usage: cbrowser har [start|stop]");
                 }
-                break;
+                process.exit(0);
             }
             // =========================================================================
             // Network
             // =========================================================================
+            case "console": {
+                // The daemon tab's console (log, info, warning, error, uncaught exceptions,
+                // failed resources), as get_console_messages returns it over MCP. Served by
+                // the daemon: a fresh process has no tab and would always list nothing.
+                const filter = typeof options.filter === "string" ? options.filter : "all";
+                if (!["all", "error", "warning", "log", "info"].includes(filter)) {
+                    console.error(`Error: --filter must be one of all, error, warning, log, info (got "${filter}")`);
+                    process.exit(1);
+                }
+                if (!(await isDaemonRunning())) {
+                    console.error("Error: the console log only spans commands in the daemon's browser; each cbrowser command is");
+                    console.error("  its own process. Start the daemon first:");
+                    console.error("  cbrowser daemon start  ->  navigate/click...  ->  cbrowser console [--filter error] [--clear] [--json]");
+                    process.exit(1);
+                }
+                const response = await sendToDaemon("consoleMessages", { filter, clear: options.clear === true });
+                if (!response.success) {
+                    console.error(`✗ Daemon error: ${response.error}`);
+                    process.exit(1);
+                }
+                const out = response.result;
+                if (options.json === true) {
+                    console.log(JSON.stringify(out, null, 2));
+                }
+                else if (out.count === 0) {
+                    console.log(filter === "all" ? "No console messages" : `No ${filter} console messages`);
+                }
+                else {
+                    console.log(`\n🖥  Console (${out.count}${out.dropped ? `, ${out.dropped} older dropped` : ""}):\n`);
+                    for (const m of out.messages) {
+                        const where = m.url ? ` (${m.url}${m.lineNumber !== undefined ? `:${m.lineNumber}` : ""})` : "";
+                        console.log(`  [${m.type}${m.source === "pageerror" ? ", uncaught" : ""}] ${m.text}${where}`);
+                        console.log(`    on ${m.pageUrl}`);
+                    }
+                }
+                if (options.clear === true)
+                    console.log("✓ Console cleared");
+                process.exit(0);
+            }
             case "network": {
                 const subcommand = args[0];
+                if (subcommand !== "list" && subcommand !== "clear") {
+                    console.error("Usage: cbrowser network [list|clear]");
+                    break;
+                }
+                // Same reason as har: the request log lives in a browser, and only the
+                // daemon's browser outlives a command. A fresh process always listed
+                // nothing and said "Navigate to a page first", even right after a
+                // navigate. (2026-10-12)
+                if (!(await isDaemonRunning())) {
+                    console.error("Error: the network log only spans commands in the daemon's browser; each cbrowser command is");
+                    console.error("  its own process. Start the daemon first:");
+                    console.error("  cbrowser daemon start  ->  navigate/click...  ->  cbrowser network list");
+                    process.exit(1);
+                }
+                if (subcommand === "clear") {
+                    const cleared = await sendToDaemon("networkClear", {});
+                    if (!cleared.success) {
+                        console.error(`✗ Daemon error: ${cleared.error}`);
+                        process.exit(1);
+                    }
+                    console.log("✓ Network history cleared");
+                    process.exit(0);
+                }
+                const listed = await sendToDaemon("networkList", {});
+                if (!listed.success) {
+                    console.error(`✗ Daemon error: ${listed.error}`);
+                    process.exit(1);
+                }
                 switch (subcommand) {
                     case "list": {
-                        const requests = browser.getNetworkRequests();
+                        const requests = listed.result.requests;
                         if (requests.length === 0) {
                             console.log("No network requests captured");
                             console.log("Navigate to a page first to capture requests");
@@ -4423,15 +4526,8 @@ Documentation: https://github.com/alexandriashai/cbrowser/wiki
                         }
                         break;
                     }
-                    case "clear": {
-                        browser.clearNetworkHistory();
-                        console.log("✓ Network history cleared");
-                        break;
-                    }
-                    default:
-                        console.error("Usage: cbrowser network [list|clear]");
                 }
-                break;
+                process.exit(0);
             }
             // =========================================================================
             // Visual Regression (Tier 2)