browser-debugger-cli 0.0.1-alpha.0

package/dist/connection/tabs.js

@@ -0,0 +1,216 @@
+import { normalizeUrl } from '../utils/url.js';
+/**
+ * Score how well a tab matches the search URL.
+ * Higher score = better match.
+ *
+ * @param tab - Target to score
+ * @param searchUrl - Normalized URL to match against
+ * @returns Match score (0-100)
+ */
+function scoreTabMatch(tab, searchUrl) {
+    // Exact match = best score
+    if (tab.url === searchUrl) {
+        return 100;
+    }
+    // Try URL-based matching
+    try {
+        const tabUrlObj = new URL(tab.url);
+        const searchUrlObj = new URL(searchUrl);
+        // Same host + path = excellent score
+        if (tabUrlObj.host === searchUrlObj.host &&
+            tabUrlObj.pathname === searchUrlObj.pathname) {
+            return 90;
+        }
+        // Same host + path prefix = good score
+        if (tabUrlObj.host === searchUrlObj.host &&
+            tabUrlObj.pathname.startsWith(searchUrlObj.pathname)) {
+            return 70;
+        }
+        // Same host = decent score
+        if (tabUrlObj.host === searchUrlObj.host) {
+            return 50;
+        }
+    }
+    catch {
+        // URL parsing failed, fall back to substring matching
+    }
+    // Substring match = weak score
+    if (tab.url.includes(searchUrl)) {
+        return 30;
+    }
+    return 0; // No match
+}
+/**
+ * Find the best matching target from a list of tabs.
+ *
+ * @param url - Target URL to find (will be normalized)
+ * @param targets - List of available targets
+ * @returns Best matching target or null if no match found
+ */
+export function findBestTarget(url, targets) {
+    const searchUrl = normalizeUrl(url);
+    // Filter for page targets only
+    const pageTargets = targets.filter((t) => t.type === 'page');
+    if (pageTargets.length === 0) {
+        return null;
+    }
+    // Score all targets
+    const scored = pageTargets
+        .map((t) => ({ target: t, score: scoreTabMatch(t, searchUrl) }))
+        .filter(({ score }) => score > 0)
+        .sort((a, b) => b.score - a.score);
+    if (scored.length === 0) {
+        return null;
+    }
+    // Warn if multiple tabs have same score
+    if (scored.length > 1 &&
+        scored[0].score === scored[1].score &&
+        scored[0].score < 100) {
+        console.error(`Warning: Multiple tabs match equally (score ${scored[0].score}), using: ${scored[0].target.url}`);
+    }
+    return scored[0].target;
+}
+/**
+ * Create a new tab with the specified URL using CDP.
+ *
+ * @param url - URL to open in the new tab
+ * @param cdp - CDP connection instance
+ * @returns Target information for the new tab
+ */
+export async function createNewTab(url, cdp) {
+    const normalizedUrl = normalizeUrl(url);
+    const port = cdp.getPort();
+    // Try CDP method first
+    try {
+        const response = await cdp.send('Target.createTarget', {
+            url: normalizedUrl,
+            newWindow: false, // Open as tab, not window
+        });
+        // Fetch target info from Chrome
+        const listResponse = await fetch(`http://127.0.0.1:${port}/json/list`);
+        const targets = await listResponse.json();
+        // Find the target we just created
+        const target = targets.find((t) => t.id === response.targetId);
+        if (target) {
+            return target;
+        }
+    }
+    catch (cdpError) {
+        console.error(`CDP Target.createTarget failed, trying HTTP endpoint...`);
+    }
+    // Fallback to HTTP endpoint method
+    try {
+        const createResponse = await fetch(`http://127.0.0.1:${port}/json/new?${encodeURIComponent(normalizedUrl)}`);
+        if (!createResponse.ok) {
+            throw new Error(`HTTP /json/new failed: ${createResponse.statusText}`);
+        }
+        const target = await createResponse.json();
+        return target;
+    }
+    catch (httpError) {
+        throw new Error(`Failed to create new tab: ${httpError instanceof Error ? httpError.message : String(httpError)}`);
+    }
+}
+/**
+ * Navigate an existing tab to a new URL using CDP.
+ *
+ * @param targetId - CDP target ID to navigate
+ * @param url - URL to navigate to
+ * @param cdp - CDP connection instance
+ */
+export async function navigateToUrl(targetId, url, cdp) {
+    const normalizedUrl = normalizeUrl(url);
+    // Attach to target
+    const sessionResponse = await cdp.send('Target.attachToTarget', {
+        targetId,
+        flatten: true,
+    });
+    // Navigate
+    const navResponse = await cdp.send('Page.navigate', { url: normalizedUrl }, sessionResponse.sessionId);
+    if (navResponse.errorText) {
+        throw new Error(`Navigation failed: ${navResponse.errorText}`);
+    }
+}
+/**
+ * Wait for a target to be ready (URL matches expected).
+ *
+ * @param targetId - CDP target ID to wait for
+ * @param expectedUrl - Expected URL (normalized)
+ * @param cdp - CDP connection instance
+ * @param maxWaitMs - Maximum time to wait in milliseconds
+ */
+export async function waitForTargetReady(targetId, expectedUrl, cdp, maxWaitMs = 15000) {
+    const startTime = Date.now();
+    const normalizedUrl = normalizeUrl(expectedUrl);
+    while (Date.now() - startTime < maxWaitMs) {
+        try {
+            // Fetch current targets
+            const response = await fetch(`http://127.0.0.1:${cdp.getPort()}/json/list`);
+            const targets = await response.json();
+            const target = targets.find((t) => t.id === targetId);
+            if (target) {
+                // Check if URL matches or is loading
+                if (target.url === normalizedUrl ||
+                    target.url.startsWith(normalizedUrl) ||
+                    target.url === 'about:blank' // Still loading
+                ) {
+                    // Wait a bit more if still on about:blank
+                    if (target.url === 'about:blank') {
+                        await new Promise((resolve) => setTimeout(resolve, 500));
+                        continue;
+                    }
+                    return; // Target is ready!
+                }
+            }
+        }
+        catch {
+            // Target doesn't exist yet or fetch failed, keep waiting
+        }
+        await new Promise((resolve) => setTimeout(resolve, 200));
+    }
+    throw new Error(`Target did not become ready within ${maxWaitMs}ms`);
+}
+/**
+ * Create a new tab or find existing tab with the target URL.
+ *
+ * This is the main entry point for tab management.
+ * It tries to find an existing tab first, and if not found,
+ * creates a new one.
+ *
+ * @param url - Target URL
+ * @param cdp - CDP connection instance
+ * @param reuseTab - If true, navigate existing tab instead of creating new one
+ * @returns Target information
+ */
+export async function createOrFindTarget(url, cdp, reuseTab = false) {
+    // Only look for existing tabs if reuseTab is true
+    if (reuseTab) {
+        // Try to find existing target via CDP
+        const targetsResponse = await cdp.send('Target.getTargets');
+        const targets = targetsResponse.targetInfos.map((info) => ({
+            id: info.targetId,
+            type: info.type,
+            url: info.url,
+            title: info.title,
+            webSocketDebuggerUrl: '', // Not needed for this operation
+        }));
+        const existingTarget = findBestTarget(url, targets);
+        if (existingTarget) {
+            console.error(`Found existing tab: ${existingTarget.url}`);
+            // If URLs don't match exactly, navigate
+            if (existingTarget.url !== normalizeUrl(url)) {
+                console.error(`Navigating tab to: ${url}`);
+                await navigateToUrl(existingTarget.id, url, cdp);
+                await waitForTargetReady(existingTarget.id, url, cdp);
+            }
+            return existingTarget;
+        }
+    }
+    // No matching tab found (or reuseTab=false), create new one
+    console.error(`Creating new tab for: ${url}`);
+    const newTarget = await createNewTab(url, cdp);
+    // Wait for tab to start loading
+    await waitForTargetReady(newTarget.id, url, cdp);
+    return newTarget;
+}
+//# sourceMappingURL=tabs.js.map

package/dist/connection/tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../src/connection/tabs.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAU/C;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,GAAc,EAAE,SAAiB;IACtD,2BAA2B;IAC3B,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,yBAAyB;IACzB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAExC,qCAAqC;QACrC,IACE,SAAS,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI;YACpC,SAAS,CAAC,QAAQ,KAAK,YAAY,CAAC,QAAQ,EAC5C,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,uCAAuC;QACvC,IACE,SAAS,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI;YACpC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,EACpD,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,2BAA2B;QAC3B,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,EAAE,CAAC;YACzC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;IAED,+BAA+B;IAC/B,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,CAAC,CAAC,CAAC,WAAW;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,OAAoB;IAEpB,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAEpC,+BAA+B;IAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAE7D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAAmB,WAAW;SACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;SAC/D,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;SAChC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAErC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,IACE,MAAM,CAAC,MAAM,GAAG,CAAC;QACjB,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK;QACnC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,EACrB,CAAC;QACD,OAAO,CAAC,KAAK,CACX,+CAA+C,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,aAAa,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,CAClG,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,GAAkB;IAElB,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAE3B,uBAAuB;IACvB,IAAI,CAAC;QACH,MAAM,QAAQ,GAA4B,MAAM,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE;YAC9E,GAAG,EAAE,aAAa;YAClB,SAAS,EAAE,KAAK,EAAE,0BAA0B;SAC7C,CAAC,CAAC;QAEH,gCAAgC;QAChC,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,YAAY,CAAC,CAAC;QACvE,MAAM,OAAO,GAAgB,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;QAEvD,kCAAkC;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE/D,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,OAAO,QAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC3E,CAAC;IAED,mCAAmC;IACnC,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,KAAK,CAChC,oBAAoB,IAAI,aAAa,kBAAkB,CAAC,aAAa,CAAC,EAAE,CACzE,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,0BAA0B,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,MAAM,GAAc,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,SAAS,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,6BAA6B,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAClG,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,GAAW,EACX,GAAkB;IAElB,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAExC,mBAAmB;IACnB,MAAM,eAAe,GAA8B,MAAM,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE;QACzF,QAAQ;QACR,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,WAAW;IACX,MAAM,WAAW,GAAwB,MAAM,GAAG,CAAC,IAAI,CACrD,eAAe,EACf,EAAE,GAAG,EAAE,aAAa,EAAE,EACtB,eAAe,CAAC,SAAS,CAC1B,CAAC;IAEF,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,sBAAsB,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,WAAmB,EACnB,GAAkB,EAClB,SAAS,GAAG,KAAK;IAEjB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAEhD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,wBAAwB;YACxB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,oBAAoB,GAAG,CAAC,OAAO,EAAE,YAAY,CAC9C,CAAC;YACF,MAAM,OAAO,GAAgB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEnD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;YAEtD,IAAI,MAAM,EAAE,CAAC;gBACX,qCAAqC;gBACrC,IACE,MAAM,CAAC,GAAG,KAAK,aAAa;oBAC5B,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;oBACpC,MAAM,CAAC,GAAG,KAAK,aAAa,CAAC,gBAAgB;kBAC7C,CAAC;oBACD,0CAA0C;oBAC1C,IAAI,MAAM,CAAC,GAAG,KAAK,aAAa,EAAE,CAAC;wBACjC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;wBACzD,SAAS;oBACX,CAAC;oBACD,OAAO,CAAC,mBAAmB;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;QAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,sCAAsC,SAAS,IAAI,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW,EACX,GAAkB,EAClB,QAAQ,GAAG,KAAK;IAEhB,kDAAkD;IAClD,IAAI,QAAQ,EAAE,CAAC;QACb,sCAAsC;QACtC,MAAM,eAAe,GAA0B,MAAM,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACnF,MAAM,OAAO,GAAgB,eAAe,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACtE,EAAE,EAAE,IAAI,CAAC,QAAQ;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,oBAAoB,EAAE,EAAE,EAAE,gCAAgC;SAC3D,CAAC,CAAC,CAAC;QAEJ,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEpD,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,uBAAuB,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC;YAE3D,wCAAwC;YACxC,IAAI,cAAc,CAAC,GAAG,KAAK,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7C,OAAO,CAAC,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;gBAC3C,MAAM,aAAa,CAAC,cAAc,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACjD,MAAM,kBAAkB,CAAC,cAAc,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YACxD,CAAC;YAED,OAAO,cAAc,CAAC;QACxB,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,OAAO,CAAC,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAE/C,gCAAgC;IAChC,MAAM,kBAAkB,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAEjD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,431 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { launchChrome, isChromeRunning } from './connection/launcher.js';
+import { BdgSession } from './session/BdgSession.js';
+import { normalizeUrl } from './utils/url.js';
+import { validateCollectorTypes } from './utils/validation.js';
+import { createOrFindTarget } from './connection/tabs.js';
+import { writePid, readPid, isProcessAlive, writeSessionOutput, acquireSessionLock, writeSessionMetadata, cleanupSession } from './utils/session.js';
+const program = new Command();
+// Global state for signal handling
+let session = null;
+let launchedChrome = null;
+let isShuttingDown = false;
+let shutdownKeepalive = null;
+async function handleStop() {
+    if (isShuttingDown || !session) {
+        return;
+    }
+    isShuttingDown = true;
+    // Keep event loop alive during shutdown to prevent premature exit
+    shutdownKeepalive = setInterval(() => { }, 1000);
+    try {
+        console.error('Stopping session...');
+        const output = await session.stop();
+        // Write to file for 'bdg stop' to read (synchronous to ensure it completes)
+        try {
+            console.error('Writing session output...');
+            writeSessionOutput(output);
+            console.error('Session output written successfully');
+        }
+        catch (writeError) {
+            console.error('Failed to write session output:', writeError);
+            console.error('Write error details:', writeError);
+        }
+        // Also output to stdout (for foreground use)
+        console.log(JSON.stringify(output, null, 2));
+        // Leave Chrome running for future sessions (persistent profile benefit)
+        if (launchedChrome) {
+            console.error('Leaving Chrome running for future sessions (use persistent profile)');
+            console.error(`Chrome PID: ${launchedChrome.pid}, port: ${launchedChrome.port}`);
+        }
+        // Cleanup session files
+        try {
+            cleanupSession();
+        }
+        catch (cleanupError) {
+            console.error('Error cleaning up session:', cleanupError);
+        }
+        // Clear keepalive and exit
+        if (shutdownKeepalive) {
+            clearInterval(shutdownKeepalive);
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('Error during shutdown:', error);
+        const errorOutput = {
+            success: false,
+            timestamp: new Date().toISOString(),
+            duration: 0,
+            target: { url: '', title: '' },
+            data: {},
+            error: error instanceof Error ? error.message : String(error)
+        };
+        // Write error output to file (synchronous to ensure it completes)
+        try {
+            console.error('Writing error output...');
+            writeSessionOutput(errorOutput);
+            console.error('Error output written successfully');
+        }
+        catch (writeError) {
+            console.error('Failed to write error output:', writeError);
+            console.error('Write error details:', writeError);
+        }
+        console.log(JSON.stringify(errorOutput, null, 2));
+        // Leave Chrome running even on error
+        if (launchedChrome) {
+            console.error('Leaving Chrome running (use persistent profile)');
+            console.error(`Chrome PID: ${launchedChrome.pid}, port: ${launchedChrome.port}`);
+        }
+        // Cleanup session files
+        try {
+            cleanupSession();
+        }
+        catch (cleanupError) {
+            console.error('Error cleaning up session:', cleanupError);
+        }
+        // Clear keepalive and exit
+        if (shutdownKeepalive) {
+            clearInterval(shutdownKeepalive);
+        }
+        process.exit(1);
+    }
+}
+// Register signal handlers
+// Wrap in async IIFE to ensure handler completes before exit
+process.on('SIGINT', () => {
+    // Prevent multiple signals from being processed
+    if (!isShuttingDown) {
+        handleStop().catch((error) => {
+            console.error('Fatal error during shutdown:', error);
+            process.exit(1);
+        });
+    }
+});
+process.on('SIGTERM', () => {
+    if (!isShuttingDown) {
+        handleStop().catch((error) => {
+            console.error('Fatal error during shutdown:', error);
+            process.exit(1);
+        });
+    }
+});
+async function run(url, options, collectors) {
+    const startTime = Date.now();
+    try {
+        // 1. Acquire session lock
+        if (!acquireSessionLock()) {
+            const existingPid = readPid();
+            throw new Error(`Session already running (PID ${existingPid}). Stop it with: bdg stop`);
+        }
+        // Validate collector types
+        validateCollectorTypes(collectors);
+        // Normalize URL - add http:// if no protocol specified
+        const targetUrl = normalizeUrl(url);
+        // 2. Launch or connect to Chrome
+        const chromeRunning = await isChromeRunning(options.port);
+        if (!chromeRunning) {
+            // Launch Chrome with target URL
+            launchedChrome = await launchChrome({
+                port: options.port,
+                headless: false,
+                url: targetUrl,
+                userDataDir: options.userDataDir,
+            });
+            console.error(`Chrome launched (PID: ${launchedChrome.pid})`);
+        }
+        else {
+            console.error(`Chrome already running on port ${options.port}`);
+        }
+        // 3. Create session (connects to CDP)
+        // We need a temporary target just to connect to CDP
+        // Then we'll use createOrFindTarget to get the right tab
+        const tempResponse = await fetch(`http://127.0.0.1:${options.port}/json/list`);
+        const tempTargets = await tempResponse.json();
+        if (tempTargets.length === 0) {
+            throw new Error('No targets available in Chrome');
+        }
+        // Use first available target to establish CDP connection
+        session = new BdgSession(tempTargets[0], options.port);
+        await session.connect();
+        if (!session.isConnected()) {
+            throw new Error('Failed to establish CDP connection');
+        }
+        // 4. Create or find target tab using TabManager
+        console.error(`Finding or creating tab for: ${targetUrl}`);
+        const target = await createOrFindTarget(url, session.getCDP(), options.reuseTab ?? false);
+        console.error(`Using tab: ${target.url}`);
+        // Fetch full target info with webSocketDebuggerUrl
+        const fullTargetResponse = await fetch(`http://127.0.0.1:${options.port}/json/list`);
+        const fullTargets = await fullTargetResponse.json();
+        const fullTarget = fullTargets.find((t) => t.id === target.id);
+        if (!fullTarget || !fullTarget.webSocketDebuggerUrl) {
+            throw new Error(`Could not find webSocketDebuggerUrl for target ${target.id}`);
+        }
+        // Update session with the correct target
+        // Close current session and reconnect to the correct target
+        await session.getCDP().close();
+        session = new BdgSession(fullTarget, options.port);
+        await session.connect();
+        // 5. Start collectors
+        for (const collector of collectors) {
+            await session.startCollector(collector);
+        }
+        // 6. Write session metadata
+        writePid(process.pid);
+        writeSessionMetadata({
+            bdgPid: process.pid,
+            chromePid: launchedChrome?.pid,
+            startTime,
+            port: options.port,
+            targetId: fullTarget.id,
+            webSocketDebuggerUrl: fullTarget.webSocketDebuggerUrl,
+        });
+        const collectorNames = collectors.length === 3
+            ? 'network, console, and DOM'
+            : collectors.join(', ');
+        if (options.timeout) {
+            console.error(`Collecting ${collectorNames}... (Ctrl+C to stop and output, or wait ${options.timeout}s for timeout)`);
+            // Set timeout if explicitly provided
+            setTimeout(() => {
+                console.error(`\nTimeout reached (${options.timeout}s)`);
+                handleStop();
+            }, options.timeout * 1000);
+        }
+        else {
+            console.error(`Collecting ${collectorNames}... (Ctrl+C to stop and output, or use 'bdg stop')`);
+        }
+        // 7. Keep alive until signal or error
+        await new Promise((_, reject) => {
+            if (!session) {
+                reject(new Error('Session not initialized'));
+                return;
+            }
+            // Listen for WebSocket connection loss
+            const connectionCheckInterval = setInterval(() => {
+                if (!session) {
+                    clearInterval(connectionCheckInterval);
+                    return;
+                }
+                if (!session.isConnected()) {
+                    clearInterval(connectionCheckInterval);
+                    reject(new Error('WebSocket connection lost'));
+                    return;
+                }
+            }, 2000); // Check every 2 seconds
+            // Listen for target destruction (tab closed/navigated)
+            session.getCDP().on('Target.targetDestroyed', (params) => {
+                if (params.targetId === target.id) {
+                    clearInterval(connectionCheckInterval);
+                    reject(new Error('Browser tab was closed'));
+                }
+            });
+        });
+    }
+    catch (error) {
+        const errorOutput = {
+            success: false,
+            timestamp: new Date().toISOString(),
+            duration: Date.now() - startTime,
+            target: { url: '', title: '' },
+            data: {},
+            error: error instanceof Error ? error.message : String(error)
+        };
+        console.log(JSON.stringify(errorOutput, null, 2));
+        // Cleanup on error
+        if (launchedChrome) {
+            try {
+                await launchedChrome.kill();
+            }
+            catch { }
+        }
+        cleanupSession();
+        process.exit(1);
+    }
+}
+program
+    .name('bdg')
+    .description('Browser telemetry via Chrome DevTools Protocol')
+    .version('0.1.0');
+program
+    .argument('<url>', 'Target URL (example.com or localhost:3000)')
+    .option('-p, --port <number>', 'Chrome debugging port', '9222')
+    .option('-t, --timeout <seconds>', 'Auto-stop after timeout (optional)')
+    .option('-r, --reuse-tab', 'Navigate existing tab instead of creating new one')
+    .option('-u, --user-data-dir <path>', 'Chrome user data directory (default: ~/.bdg/chrome-profile)')
+    .action(async (url, options) => {
+    const port = parseInt(options.port);
+    const timeout = options.timeout ? parseInt(options.timeout) : undefined;
+    const reuseTab = options.reuseTab ?? false;
+    const userDataDir = options.userDataDir;
+    await run(url, { port, timeout, reuseTab, userDataDir }, ['dom', 'network', 'console']);
+});
+program
+    .command('dom')
+    .description('Collect DOM only')
+    .argument('<url>', 'Target URL')
+    .option('-p, --port <number>', 'Chrome debugging port', '9222')
+    .option('-t, --timeout <seconds>', 'Auto-stop after timeout (optional)')
+    .option('-r, --reuse-tab', 'Navigate existing tab instead of creating new one')
+    .option('-u, --user-data-dir <path>', 'Chrome user data directory (default: ~/.bdg/chrome-profile)')
+    .action(async (url, options) => {
+    const port = parseInt(options.port);
+    const timeout = options.timeout ? parseInt(options.timeout) : undefined;
+    const reuseTab = options.reuseTab ?? false;
+    const userDataDir = options.userDataDir;
+    await run(url, { port, timeout, reuseTab, userDataDir }, ['dom']);
+});
+program
+    .command('network')
+    .description('Collect network requests only')
+    .argument('<url>', 'Target URL')
+    .option('-p, --port <number>', 'Chrome debugging port', '9222')
+    .option('-t, --timeout <seconds>', 'Auto-stop after timeout (optional)')
+    .option('-r, --reuse-tab', 'Navigate existing tab instead of creating new one')
+    .option('-u, --user-data-dir <path>', 'Chrome user data directory (default: ~/.bdg/chrome-profile)')
+    .action(async (url, options) => {
+    const port = parseInt(options.port);
+    const timeout = options.timeout ? parseInt(options.timeout) : undefined;
+    const reuseTab = options.reuseTab ?? false;
+    const userDataDir = options.userDataDir;
+    await run(url, { port, timeout, reuseTab, userDataDir }, ['network']);
+});
+program
+    .command('console')
+    .description('Collect console logs only')
+    .argument('<url>', 'Target URL')
+    .option('-p, --port <number>', 'Chrome debugging port', '9222')
+    .option('-t, --timeout <seconds>', 'Auto-stop after timeout (optional)')
+    .option('-r, --reuse-tab', 'Navigate existing tab instead of creating new one')
+    .option('-u, --user-data-dir <path>', 'Chrome user data directory (default: ~/.bdg/chrome-profile)')
+    .action(async (url, options) => {
+    const port = parseInt(options.port);
+    const timeout = options.timeout ? parseInt(options.timeout) : undefined;
+    const reuseTab = options.reuseTab ?? false;
+    const userDataDir = options.userDataDir;
+    await run(url, { port, timeout, reuseTab, userDataDir }, ['console']);
+});
+program
+    .command('query')
+    .description('Execute JavaScript in the active session for live debugging')
+    .argument('<script>', 'JavaScript to execute (e.g., "document.querySelector(\'input[type=email]\').value")')
+    .option('-p, --port <number>', 'Chrome debugging port', '9222')
+    .action(async (script, options) => {
+    try {
+        const port = parseInt(options.port);
+        // Check if session is running
+        const pid = readPid();
+        if (!pid || !isProcessAlive(pid)) {
+            console.error('Error: No active session running');
+            console.error('Start a session with: bdg <url>');
+            process.exit(1);
+        }
+        // Read session metadata to get the target ID
+        const { readSessionMetadata } = await import('./utils/session.js');
+        const metadata = readSessionMetadata();
+        if (!metadata || !metadata.targetId || !metadata.webSocketDebuggerUrl) {
+            console.error('Error: No target information in session metadata');
+            console.error('Session may have been started with an older version');
+            process.exit(1);
+        }
+        // Verify the target still exists
+        const response = await fetch(`http://127.0.0.1:${port}/json/list`);
+        const targets = await response.json();
+        const target = targets.find((t) => t.id === metadata.targetId);
+        if (!target) {
+            console.error('Error: Session target not found (tab may have been closed)');
+            console.error('Start a new session with: bdg <url>');
+            process.exit(1);
+        }
+        // Create temporary CDP connection using stored webSocketDebuggerUrl
+        const { CDPConnection } = await import('./connection/cdp.js');
+        const cdp = new CDPConnection();
+        await cdp.connect(metadata.webSocketDebuggerUrl);
+        // Execute JavaScript
+        const result = await cdp.send('Runtime.evaluate', {
+            expression: script,
+            returnByValue: true,
+            awaitPromise: true
+        });
+        await cdp.close();
+        // Output result
+        if (result.exceptionDetails) {
+            console.error('Error executing script:');
+            console.error(result.exceptionDetails.exception.description);
+            process.exit(1);
+        }
+        console.log(JSON.stringify(result.result.value, null, 2));
+        process.exit(0);
+    }
+    catch (error) {
+        console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+});
+program
+    .command('stop')
+    .description('Stop all active sessions and free ports (does not capture output)')
+    .option('--kill-chrome', 'Also kill Chrome browser')
+    .action(async (options) => {
+    try {
+        const { readSessionMetadata } = await import('./utils/session.js');
+        // Read PID
+        const pid = readPid();
+        if (!pid) {
+            console.error('No active session found');
+            console.error('All ports should be free');
+            process.exit(0);
+        }
+        console.error(`Stopping session (PID ${pid})...`);
+        // Read metadata BEFORE killing the process (so we can get Chrome PID)
+        const metadata = readSessionMetadata();
+        // Kill the bdg process (use SIGKILL for immediate termination)
+        if (isProcessAlive(pid)) {
+            try {
+                process.kill(pid, 'SIGKILL');
+                console.error(`✓ Killed bdg session (PID ${pid})`);
+            }
+            catch (killError) {
+                console.error(`Warning: Could not kill process ${pid}:`, killError);
+            }
+        }
+        else {
+            console.error(`Process ${pid} already stopped`);
+        }
+        // Kill Chrome if requested
+        if (options.killChrome) {
+            if (metadata?.chromePid) {
+                try {
+                    if (isProcessAlive(metadata.chromePid)) {
+                        process.kill(metadata.chromePid, 'SIGTERM');
+                        console.error(`✓ Killed Chrome (PID ${metadata.chromePid})`);
+                    }
+                    else {
+                        console.error(`Chrome process (PID ${metadata.chromePid}) already stopped`);
+                    }
+                }
+                catch (chromeError) {
+                    console.error(`Warning: Could not kill Chrome:`, chromeError);
+                }
+            }
+            else {
+                console.error('Warning: Chrome PID not found in session metadata');
+            }
+        }
+        else {
+            console.error('Leaving Chrome running (use --kill-chrome to close it)');
+        }
+        // Clean up session files
+        cleanupSession();
+        console.error('✓ Cleaned up session files');
+        console.error('\nAll sessions stopped and ports freed');
+        process.exit(0);
+    }
+    catch (error) {
+        console.error(`Error stopping session: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map