@vforsh/argus-watcher 0.1.1 → 0.1.3

package/dist/registry/registry.js

@@ -1,19 +1,63 @@
-import { readRegistry, removeWatcherEntry, setWatcherEntry, writeRegistry } from '@vforsh/argus-core';
-/** Write watcher entry to registry. */
-export const announceWatcher = async (watcher) => {
+import { readRegistry, removeWatcherEntry, setWatcherEntry, updateRegistry } from '@vforsh/argus-core';
+/**
+ * Resolve a unique watcher ID. If the requested ID is taken by a live watcher,
+ * appends `-2`, `-3`, etc. until a free slot is found.
+ * Stale entries (dead process) are cleaned up automatically.
+ * Returns the ID that should be used.
+ */
+export const resolveUniqueWatcherId = async (id) => {
     const { registry } = await readRegistry();
-    const next = setWatcherEntry(registry, watcher);
-    await writeRegistry(next);
+    const staleIds = [];
+    const isIdAvailable = (candidate) => {
+        const existing = registry.watchers[candidate];
+        if (!existing) {
+            return true;
+        }
+        if (existing.pid == null || !isProcessAlive(existing.pid)) {
+            staleIds.push(candidate);
+            return true;
+        }
+        return false;
+    };
+    let resolvedId = id;
+    if (!isIdAvailable(id)) {
+        let suffix = 2;
+        while (!isIdAvailable(`${id}-${suffix}`)) {
+            suffix++;
+        }
+        resolvedId = `${id}-${suffix}`;
+    }
+    if (staleIds.length > 0) {
+        await updateRegistry((reg) => {
+            let next = reg;
+            for (const staleId of staleIds) {
+                next = removeWatcherEntry(next, staleId);
+            }
+            return next;
+        });
+    }
+    return resolvedId;
+};
+const isProcessAlive = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/** Write watcher entry to registry (locked read-modify-write). */
+export const announceWatcher = async (watcher) => {
+    await updateRegistry((registry) => setWatcherEntry(registry, watcher));
 };
 /** Refresh watcher entry in registry. */
 export const updateWatcherHeartbeat = async (watcher) => {
     await announceWatcher(watcher);
 };
-/** Remove watcher entry from registry by id. */
+/** Remove watcher entry from registry by id (locked read-modify-write). */
 export const removeWatcher = async (id) => {
-    const { registry } = await readRegistry();
-    const next = removeWatcherEntry(registry, id);
-    await writeRegistry(next);
+    await updateRegistry((registry) => removeWatcherEntry(registry, id));
 };
 /** Periodically refresh registry entry until stopped. */
 export const startRegistryHeartbeat = (getWatcher, intervalMs = 15_000) => {

package/dist/registry/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGrG,uCAAuC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,OAAsB,EAAiB,EAAE;IAC9E,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,YAAY,EAAE,CAAA;IACzC,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC/C,MAAM,aAAa,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC,CAAA;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,OAAsB,EAAiB,EAAE;IACrF,MAAM,eAAe,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC,CAAA;AAED,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,EAAU,EAAiB,EAAE;IAChE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,YAAY,EAAE,CAAA;IACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IAC7C,MAAM,aAAa,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC,CAAA;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,UAA+B,EAAE,UAAU,GAAG,MAAM,EAAwB,EAAE;IACpH,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;QAC5B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC9B,KAAK,sBAAsB,CAAC,OAAO,CAAC,CAAA;IACrC,CAAC,EAAE,UAAU,CAAC,CAAA;IAEd,OAAO;QACN,IAAI,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC;KAChC,CAAA;AACF,CAAC,CAAA"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"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"}

package/dist/scripts/install-host.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env bun
+/**
+ * Install/uninstall Native Messaging host manifest for the Argus extension.
+ *
+ * Usage:
+ *   node dist/scripts/install-host.js install <EXTENSION_ID>
+ *   node dist/scripts/install-host.js uninstall
+ */
+export {};
+//# sourceMappingURL=install-host.d.ts.map

package/dist/scripts/install-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-host.d.ts","sourceRoot":"","sources":["../../src/scripts/install-host.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}

package/dist/scripts/install-host.js

@@ -0,0 +1,189 @@
+#!/usr/bin/env bun
+/**
+ * Install/uninstall Native Messaging host manifest for the Argus extension.
+ *
+ * Usage:
+ *   node dist/scripts/install-host.js install <EXTENSION_ID>
+ *   node dist/scripts/install-host.js uninstall
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { execSync } from 'node:child_process';
+const __dirname = import.meta.dirname;
+const HOST_NAME = 'com.vforsh.argus.bridge';
+const getManifestDir = (platform) => {
+    switch (platform) {
+        case 'darwin':
+            return path.join(os.homedir(), 'Library/Application Support/Google/Chrome/NativeMessagingHosts');
+        case 'linux':
+            return path.join(os.homedir(), '.config/google-chrome/NativeMessagingHosts');
+        case 'win32':
+            return path.join(process.env.LOCALAPPDATA ?? os.homedir(), 'Google/Chrome/User Data/NativeMessagingHosts');
+        default:
+            throw new Error(`Unsupported platform: ${platform}`);
+    }
+};
+const getManifestPath = (platform) => {
+    return path.join(getManifestDir(platform), `${HOST_NAME}.json`);
+};
+const findArgusExecutable = () => {
+    // Try to find the argus CLI executable
+    // First, check if we're in a development environment
+    const devPath = path.resolve(__dirname, '../../../argus/dist/bin.js');
+    if (fs.existsSync(devPath)) {
+        return devPath;
+    }
+    // Check for globally installed argus
+    try {
+        const npmGlobalPrefix = execSync('npm config get prefix', { encoding: 'utf8' }).trim();
+        const globalBinPath = path.join(npmGlobalPrefix, 'bin', 'argus');
+        if (fs.existsSync(globalBinPath)) {
+            return globalBinPath;
+        }
+    }
+    catch {
+        // Ignore
+    }
+    // Check if argus is in PATH
+    try {
+        const whichPath = execSync('which argus', { encoding: 'utf8' }).trim();
+        if (whichPath) {
+            return whichPath;
+        }
+    }
+    catch {
+        // Ignore
+    }
+    throw new Error('Could not find argus executable. Please install argus globally (npm install -g @vforsh/argus) or run from the development directory.');
+};
+const createManifest = (extensionId, executablePath) => {
+    return {
+        name: HOST_NAME,
+        description: 'Argus Watcher Native Messaging Host',
+        path: executablePath,
+        type: 'stdio',
+        allowed_origins: [`chrome-extension://${extensionId}/`],
+    };
+};
+const findNodePath = () => {
+    // Get the current node executable path and resolve any symlinks
+    // This is important for fnm/nvm which use symlinks in temporary directories
+    return fs.realpathSync(process.execPath);
+};
+const createWrapperScript = (platform, executablePath) => {
+    const wrapperDir = getManifestDir(platform);
+    const wrapperPath = path.join(wrapperDir, 'argus-native-host.sh');
+    const nodePath = findNodePath();
+    // Create a wrapper script that launches argus in native-host mode
+    // Use absolute path to node since Chrome spawns without shell profile
+    const script = `#!/bin/bash
+exec "${nodePath}" "${executablePath}" watcher native-host
+`;
+    fs.writeFileSync(wrapperPath, script, { mode: 0o755 });
+    return wrapperPath;
+};
+const install = (extensionId) => {
+    const platform = os.platform();
+    if (!['darwin', 'linux', 'win32'].includes(platform)) {
+        console.error(`Unsupported platform: ${platform}`);
+        process.exit(1);
+    }
+    const manifestDir = getManifestDir(platform);
+    const manifestPath = getManifestPath(platform);
+    // Ensure directory exists
+    fs.mkdirSync(manifestDir, { recursive: true });
+    // Find argus executable
+    let executablePath;
+    try {
+        executablePath = findArgusExecutable();
+    }
+    catch (err) {
+        console.error(err.message);
+        process.exit(1);
+    }
+    // Create wrapper script (Native Messaging requires a native executable, not node)
+    const wrapperPath = createWrapperScript(platform, executablePath);
+    console.log(`Created wrapper script: ${wrapperPath}`);
+    // Create manifest
+    const manifest = createManifest(extensionId, wrapperPath);
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+    console.log(`Created manifest: ${manifestPath}`);
+    // Windows: Add registry key
+    if (platform === 'win32') {
+        const regKey = `HKCU\\Software\\Google\\Chrome\\NativeMessagingHosts\\${HOST_NAME}`;
+        try {
+            execSync(`reg add "${regKey}" /ve /t REG_SZ /d "${manifestPath}" /f`, { stdio: 'inherit' });
+            console.log(`Added registry key: ${regKey}`);
+        }
+        catch (err) {
+            console.error('Failed to add registry key:', err);
+            process.exit(1);
+        }
+    }
+    console.log('\nNative Messaging host installed successfully!');
+    console.log(`Host name: ${HOST_NAME}`);
+    console.log(`Extension ID: ${extensionId}`);
+};
+const uninstall = () => {
+    const platform = os.platform();
+    if (!['darwin', 'linux', 'win32'].includes(platform)) {
+        console.error(`Unsupported platform: ${platform}`);
+        process.exit(1);
+    }
+    const manifestPath = getManifestPath(platform);
+    const wrapperPath = path.join(getManifestDir(platform), 'argus-native-host.sh');
+    // Remove manifest
+    if (fs.existsSync(manifestPath)) {
+        fs.unlinkSync(manifestPath);
+        console.log(`Removed manifest: ${manifestPath}`);
+    }
+    else {
+        console.log(`Manifest not found: ${manifestPath}`);
+    }
+    // Remove wrapper script
+    if (fs.existsSync(wrapperPath)) {
+        fs.unlinkSync(wrapperPath);
+        console.log(`Removed wrapper script: ${wrapperPath}`);
+    }
+    // Windows: Remove registry key
+    if (platform === 'win32') {
+        const regKey = `HKCU\\Software\\Google\\Chrome\\NativeMessagingHosts\\${HOST_NAME}`;
+        try {
+            execSync(`reg delete "${regKey}" /f`, { stdio: 'inherit' });
+            console.log(`Removed registry key: ${regKey}`);
+        }
+        catch {
+            // Key might not exist
+        }
+    }
+    console.log('\nNative Messaging host uninstalled.');
+};
+const main = () => {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (command === 'install') {
+        const extensionId = args[1];
+        if (!extensionId) {
+            console.error('Usage: install-host install <EXTENSION_ID>');
+            console.error('\nTo get your extension ID:');
+            console.error('1. Open chrome://extensions');
+            console.error('2. Enable Developer mode');
+            console.error('3. Load the argus-extension package as unpacked extension');
+            console.error('4. Copy the ID shown on the extension card');
+            process.exit(1);
+        }
+        install(extensionId);
+    }
+    else if (command === 'uninstall') {
+        uninstall();
+    }
+    else {
+        console.error('Usage:');
+        console.error('  install-host install <EXTENSION_ID>');
+        console.error('  install-host uninstall');
+        process.exit(1);
+    }
+};
+main();
+//# sourceMappingURL=install-host.js.map

package/dist/scripts/install-host.js.map

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

package/dist/sources/cdp-source.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CDP source for direct Chrome DevTools Protocol connection via WebSocket.
+ * Wraps the existing CDP watcher with the unified source interface.
+ */
+import type { WatcherMatch, WatcherChrome } from '@vforsh/argus-core';
+import { type CdpSessionController } from '../cdp/connection.js';
+import type { CdpSourceHandle, CdpSourceBaseOptions } from './types.js';
+/**
+ * Options for creating a CDP source.
+ */
+export type CdpSourceOptions = CdpSourceBaseOptions & {
+    /** Chrome DevTools Protocol connection settings. */
+    chrome: WatcherChrome;
+    /** Criteria for which Chrome target(s) to attach to. */
+    match?: WatcherMatch;
+    /** Optional session controller (for sharing session handle with other components). */
+    sessionHandle?: CdpSessionController;
+};
+/**
+ * Create a CDP source that connects to Chrome via WebSocket.
+ * Returns a handle that can be used to control the source and access CDP session.
+ */
+export declare const createCdpSource: (options: CdpSourceOptions) => CdpSourceHandle;
+//# sourceMappingURL=cdp-source.d.ts.map

package/dist/sources/cdp-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-source.d.ts","sourceRoot":"","sources":["../../src/sources/cdp-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAErE,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAExF,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEvE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACrD,oDAAoD;IACpD,MAAM,EAAE,aAAa,CAAA;IACrB,wDAAwD;IACxD,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,sFAAsF;IACtF,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACpC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,eA0C3D,CAAA"}

package/dist/sources/cdp-source.js

@@ -0,0 +1,48 @@
+/**
+ * CDP source for direct Chrome DevTools Protocol connection via WebSocket.
+ * Wraps the existing CDP watcher with the unified source interface.
+ */
+import { startCdpWatcher } from '../cdp/watcher.js';
+import { createCdpSessionHandle } from '../cdp/connection.js';
+/**
+ * Create a CDP source that connects to Chrome via WebSocket.
+ * Returns a handle that can be used to control the source and access CDP session.
+ */
+export const createCdpSource = (options) => {
+    const { events, ignoreMatcher, stripUrlPrefixes, chrome, match, sessionHandle } = options;
+    // Create session handle if not provided
+    const controller = sessionHandle ?? createCdpSessionHandle();
+    // Convert ignoreMatcher function to IgnoreMatcher object if needed
+    const ignoreMatcherObj = ignoreMatcher ? { matches: ignoreMatcher } : null;
+    // Map source events to watcher events
+    const watcherOptions = {
+        chrome,
+        match,
+        sessionHandle: controller,
+        ignoreMatcher: ignoreMatcherObj,
+        stripUrlPrefixes,
+        onLog: events.onLog,
+        onStatus: events.onStatus,
+        onPageNavigation: events.onPageNavigation,
+        onPageLoad: events.onPageLoad,
+        onPageIntl: events.onPageIntl,
+        onAttach: events.onAttach
+            ? (session, target) => events.onAttach(session, {
+                id: target.id,
+                title: target.title,
+                url: target.url,
+                type: target.type,
+                parentId: target.parentId,
+            })
+            : undefined,
+        onDetach: events.onDetach,
+    };
+    const watcher = startCdpWatcher(watcherOptions);
+    return {
+        session: watcher.session,
+        stop: watcher.stop,
+        // CDP mode doesn't support listTargets/attachTarget/detachTarget
+        // (auto-attaches based on match criteria)
+    };
+};
+//# sourceMappingURL=cdp-source.js.map

package/dist/sources/cdp-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-source.js","sourceRoot":"","sources":["../../src/sources/cdp-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAA0B,MAAM,mBAAmB,CAAA;AAC3E,OAAO,EAAE,sBAAsB,EAA6B,MAAM,sBAAsB,CAAA;AAgBxF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAyB,EAAmB,EAAE;IAC7E,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAA;IAEzF,wCAAwC;IACxC,MAAM,UAAU,GAAG,aAAa,IAAI,sBAAsB,EAAE,CAAA;IAE5D,mEAAmE;IACnE,MAAM,gBAAgB,GAAyB,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAEhG,sCAAsC;IACtC,MAAM,cAAc,GAAsB;QACzC,MAAM;QACN,KAAK;QACL,aAAa,EAAE,UAAU;QACzB,aAAa,EAAE,gBAAgB;QAC/B,gBAAgB;QAChB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACxB,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CACpB,MAAM,CAAC,QAAS,CAAC,OAAO,EAAE;gBACzB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aACzB,CAAC;YACJ,CAAC,CAAC,SAAS;QACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;KACzB,CAAA;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,cAAc,CAAC,CAAA;IAE/C,OAAO;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,iEAAiE;QACjE,0CAA0C;KAC1C,CAAA;AACF,CAAC,CAAA"}

package/dist/sources/extension-source.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Extension source for CDP access via Chrome extension Native Messaging.
+ * Wraps SessionManager and provides a unified source interface.
+ */
+import type { CdpSourceHandle, CdpSourceBaseOptions } from './types.js';
+/**
+ * Options for creating an extension source.
+ */
+export type ExtensionSourceOptions = CdpSourceBaseOptions;
+/**
+ * Create an extension source that connects to Chrome via Native Messaging.
+ * Returns a handle that can be used to control the source and access CDP session.
+ */
+export declare const createExtensionSource: (options: ExtensionSourceOptions) => CdpSourceHandle;
+//# sourceMappingURL=extension-source.d.ts.map

package/dist/sources/extension-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-source.d.ts","sourceRoot":"","sources":["../../src/sources/extension-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAmB,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAGxF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,CAAA;AAEzD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,sBAAsB,KAAG,eAyIvE,CAAA"}

package/dist/sources/extension-source.js

@@ -0,0 +1,256 @@
+/**
+ * Extension source for CDP access via Chrome extension Native Messaging.
+ * Wraps SessionManager and provides a unified source interface.
+ */
+import { previewStringify } from '@vforsh/argus-core';
+import { createNativeMessaging } from '../native-messaging/messaging.js';
+import { SessionManager } from '../native-messaging/session-manager.js';
+/**
+ * Create an extension source that connects to Chrome via Native Messaging.
+ * Returns a handle that can be used to control the source and access CDP session.
+ */
+export const createExtensionSource = (options) => {
+    const { events, ignoreMatcher, stripUrlPrefixes } = options;
+    const messaging = createNativeMessaging();
+    let currentSession = null;
+    let stopping = false;
+    // Create session manager with event handlers
+    const sessionManager = new SessionManager(messaging, {
+        onAttach: (session) => {
+            console.error(`[ExtensionSource] Tab attached: ${session.tabId} - ${session.url}`);
+            currentSession = session;
+            sessionManager.enableDomain(session.tabId, 'Page');
+            // Subscribe to console events
+            session.handle.onEvent('Runtime.consoleAPICalled', (params) => {
+                const logEvent = toConsoleEvent(params, session, { ignoreMatcher, stripUrlPrefixes });
+                events.onLog(logEvent);
+            });
+            // Subscribe to exception events
+            session.handle.onEvent('Runtime.exceptionThrown', (params) => {
+                const logEvent = toExceptionEvent(params, session, { ignoreMatcher, stripUrlPrefixes });
+                events.onLog(logEvent);
+            });
+            // Notify status change
+            const target = {
+                id: String(session.tabId),
+                title: session.title,
+                url: session.url,
+                type: 'page',
+                faviconUrl: session.faviconUrl,
+                attached: true,
+            };
+            events.onStatus({
+                attached: true,
+                target: {
+                    title: session.title,
+                    url: session.url,
+                    type: 'page',
+                    parentId: null,
+                },
+                reason: null,
+            });
+            void events.onAttach?.(session.handle, target);
+        },
+        onDetach: (tabId, reason) => {
+            console.error(`[ExtensionSource] Tab detached: ${tabId} - ${reason}`);
+            if (currentSession?.tabId === tabId) {
+                currentSession = null;
+            }
+            events.onStatus({
+                attached: false,
+                target: null,
+                reason,
+            });
+            events.onDetach?.(reason);
+        },
+        onTabsUpdated: () => {
+            // Tabs list updated - no action needed
+        },
+    });
+    // Create a proxy session handle that delegates to the current session
+    const proxySession = {
+        isAttached: () => currentSession?.handle.isAttached() ?? false,
+        sendAndWait: async (method, params, options) => {
+            const session = currentSession;
+            if (!session) {
+                const error = new Error('No tab attached via extension');
+                error.code = 'cdp_not_attached';
+                throw error;
+            }
+            return session.handle.sendAndWait(method, params, options);
+        },
+        onEvent: (method, handler) => {
+            // For proxy session, we need to track all handlers and replay them
+            // when a new session is attached. For now, just use the current session.
+            if (!currentSession) {
+                // Return a no-op unsubscribe function
+                return () => { };
+            }
+            return currentSession.handle.onEvent(method, handler);
+        },
+    };
+    // Start Native Messaging
+    messaging.start();
+    messaging.onDisconnect(() => {
+        console.error('[ExtensionSource] Extension disconnected');
+        if (!stopping) {
+            events.onStatus({
+                attached: false,
+                target: null,
+                reason: 'extension_disconnected',
+            });
+            events.onDetach?.('extension_disconnected');
+        }
+    });
+    const stop = async () => {
+        stopping = true;
+        messaging.stop();
+    };
+    const listTargets = async () => {
+        const tabs = await sessionManager.listTabs();
+        return tabs.map(tabToTarget);
+    };
+    const attachTarget = (targetId) => {
+        sessionManager.attachTab(targetId);
+    };
+    const detachTarget = (targetId) => {
+        sessionManager.detachTab(targetId);
+    };
+    return {
+        session: proxySession,
+        stop,
+        listTargets,
+        attachTarget,
+        detachTarget,
+    };
+};
+/**
+ * Convert TabInfo to CdpSourceTarget.
+ */
+const tabToTarget = (tab) => ({
+    id: String(tab.tabId),
+    title: tab.title,
+    url: tab.url,
+    type: 'page',
+    faviconUrl: tab.faviconUrl,
+    attached: tab.attached,
+});
+/**
+ * Convert Runtime.consoleAPICalled event to LogEvent.
+ */
+const toConsoleEvent = (params, session, config) => {
+    const record = params;
+    const args = record.args?.map((a) => a.value) ?? [];
+    const text = formatArgs(record.args ?? []);
+    const frame = selectBestFrame(record.stackTrace?.callFrames, config.ignoreMatcher);
+    return {
+        ts: record.timestamp ?? Date.now(),
+        level: normalizeLevel(record.type ?? 'log'),
+        text,
+        args,
+        source: 'console',
+        file: applyStripPrefixes(frame?.url ?? null, config.stripUrlPrefixes),
+        line: frame?.lineNumber != null ? frame.lineNumber + 1 : null,
+        column: frame?.columnNumber != null ? frame.columnNumber + 1 : null,
+        pageUrl: session.url,
+        pageTitle: session.title,
+    };
+};
+/**
+ * Convert Runtime.exceptionThrown event to LogEvent.
+ */
+const toExceptionEvent = (params, session, config) => {
+    const record = params;
+    const details = record.exceptionDetails;
+    const text = details?.exception?.description ?? details?.text ?? 'Exception';
+    const args = details?.exception ? [details.exception.value ?? details.exception.description] : [];
+    const frame = selectBestFrame(details?.stackTrace?.callFrames, config.ignoreMatcher);
+    return {
+        ts: record.timestamp ?? Date.now(),
+        level: 'exception',
+        text,
+        args,
+        source: 'exception',
+        file: applyStripPrefixes(frame?.url ?? null, config.stripUrlPrefixes),
+        line: frame?.lineNumber != null ? frame.lineNumber + 1 : null,
+        column: frame?.columnNumber != null ? frame.columnNumber + 1 : null,
+        pageUrl: session.url,
+        pageTitle: session.title,
+    };
+};
+/**
+ * Format console args for display.
+ */
+const formatArgs = (args) => {
+    if (args.length === 0) {
+        return '';
+    }
+    return args
+        .map((arg) => {
+        if (arg.value !== undefined) {
+            return typeof arg.value === 'string' ? arg.value : previewStringify(arg.value);
+        }
+        return arg.description ?? `[${arg.type}]`;
+    })
+        .join(' ');
+};
+/**
+ * Normalize console log type to LogLevel.
+ */
+const normalizeLevel = (type) => {
+    switch (type) {
+        case 'log':
+        case 'info':
+        case 'debug':
+        case 'dir':
+        case 'dirxml':
+        case 'table':
+        case 'trace':
+        case 'count':
+        case 'timeEnd':
+        case 'timeLog':
+            return type === 'debug' ? 'debug' : type === 'info' ? 'info' : 'log';
+        case 'warn':
+        case 'warning':
+            return 'warning';
+        case 'error':
+        case 'assert':
+        case 'exception':
+            return type === 'exception' ? 'exception' : 'error';
+        default:
+            return 'log';
+    }
+};
+/**
+ * Select the best frame from the stack trace (first non-ignored frame).
+ */
+const selectBestFrame = (frames, ignoreMatcher) => {
+    if (!frames || frames.length === 0) {
+        return null;
+    }
+    if (!ignoreMatcher) {
+        return frames[0] ?? null;
+    }
+    for (const frame of frames) {
+        if (frame.url && !ignoreMatcher(frame.url)) {
+            return frame;
+        }
+    }
+    // Fall back to first frame if all are ignored
+    return frames[0] ?? null;
+};
+/**
+ * Apply strip prefixes to a file URL.
+ */
+const applyStripPrefixes = (file, prefixes) => {
+    if (!file || !prefixes || prefixes.length === 0) {
+        return file;
+    }
+    for (const prefix of prefixes) {
+        if (file.startsWith(prefix)) {
+            return file.slice(prefix.length);
+        }
+    }
+    return file;
+};
+//# sourceMappingURL=extension-source.js.map