@vforsh/argus-watcher 0.1.2 → 0.1.3

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":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAQ,CAAA;AAEtC,MAAM,SAAS,GAAG,yBAAyB,CAAA;AAI3C,MAAM,cAAc,GAAG,CAAC,QAAkB,EAAU,EAAE;IACrD,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,QAAQ;YACZ,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,gEAAgE,CAAC,CAAA;QACjG,KAAK,OAAO;YACX,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,4CAA4C,CAAC,CAAA;QAC7E,KAAK,OAAO;YACX,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,8CAA8C,CAAC,CAAA;QAC3G;YACC,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAA;IACtD,CAAC;AACF,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CAAC,QAAkB,EAAU,EAAE;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,GAAG,SAAS,OAAO,CAAC,CAAA;AAChE,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,GAAW,EAAE;IACxC,uCAAuC;IACvC,qDAAqD;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAA;IACrE,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAA;IACf,CAAC;IAED,qCAAqC;IACrC,IAAI,CAAC;QACJ,MAAM,eAAe,GAAG,QAAQ,CAAC,uBAAuB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACtF,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;QAChE,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,OAAO,aAAa,CAAA;QACrB,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,SAAS;IACV,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC;QACJ,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACtE,IAAI,SAAS,EAAE,CAAC;YACf,OAAO,SAAS,CAAA;QACjB,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,SAAS;IACV,CAAC;IAED,MAAM,IAAI,KAAK,CACd,sIAAsI,CACtI,CAAA;AACF,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,WAAmB,EAAE,cAAsB,EAAU,EAAE;IAC9E,OAAO;QACN,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,qCAAqC;QAClD,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,OAAO;QACb,eAAe,EAAE,CAAC,sBAAsB,WAAW,GAAG,CAAC;KACvD,CAAA;AACF,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,GAAW,EAAE;IACjC,gEAAgE;IAChE,4EAA4E;IAC5E,OAAO,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;AACzC,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,CAAC,QAAkB,EAAE,cAAsB,EAAU,EAAE;IAClF,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAA;IACjE,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;IAE/B,kEAAkE;IAClE,sEAAsE;IACtE,MAAM,MAAM,GAAG;QACR,QAAQ,MAAM,cAAc;CACnC,CAAA;IAEA,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACtD,OAAO,WAAW,CAAA;AACnB,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,CAAC,WAAmB,EAAQ,EAAE;IAC7C,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAc,CAAA;IAC1C,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAA;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IAC5C,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IAE9C,0BAA0B;IAC1B,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE9C,wBAAwB;IACxB,IAAI,cAAsB,CAAA;IAC1B,IAAI,CAAC;QACJ,cAAc,GAAG,mBAAmB,EAAE,CAAA;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAA;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;IAED,kFAAkF;IAClF,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAA;IACjE,OAAO,CAAC,GAAG,CAAC,2BAA2B,WAAW,EAAE,CAAC,CAAA;IAErD,kBAAkB;IAClB,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;IACzD,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IACjE,OAAO,CAAC,GAAG,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAA;IAEhD,4BAA4B;IAC5B,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,yDAAyD,SAAS,EAAE,CAAA;QACnF,IAAI,CAAC;YACJ,QAAQ,CAAC,YAAY,MAAM,uBAAuB,YAAY,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;YAC3F,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAA;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAA;YACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAChB,CAAC;IACF,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAA;IAC9D,OAAO,CAAC,GAAG,CAAC,cAAc,SAAS,EAAE,CAAC,CAAA;IACtC,OAAO,CAAC,GAAG,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAA;AAC5C,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,GAAS,EAAE;IAC5B,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAc,CAAA;IAC1C,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAA;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC,CAAA;IAE/E,kBAAkB;IAClB,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;QAC3B,OAAO,CAAC,GAAG,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAA;IACjD,CAAC;SAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,wBAAwB;IACxB,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;QAC1B,OAAO,CAAC,GAAG,CAAC,2BAA2B,WAAW,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,+BAA+B;IAC/B,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,yDAAyD,SAAS,EAAE,CAAA;QACnF,IAAI,CAAC;YACJ,QAAQ,CAAC,eAAe,MAAM,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;YAC3D,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAA;QAC/C,CAAC;QAAC,MAAM,CAAC;YACR,sBAAsB;QACvB,CAAC;IACF,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAA;AACpD,CAAC,CAAA;AAED,MAAM,IAAI,GAAG,GAAS,EAAE;IACvB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IAEvB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QAC3B,IAAI,CAAC,WAAW,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAA;YAC3D,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAA;YAC5C,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAA;YAC5C,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAA;YACzC,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAA;YAC1E,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAA;YAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAChB,CAAC;QACD,OAAO,CAAC,WAAW,CAAC,CAAA;IACrB,CAAC;SAAM,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QACpC,SAAS,EAAE,CAAA;IACZ,CAAC;SAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACvB,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAA;QACtD,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAA;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;AACF,CAAC,CAAA;AAED,IAAI,EAAE,CAAA"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-source.js","sourceRoot":"","sources":["../../src/sources/extension-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,EAAE,cAAc,EAAyB,MAAM,wCAAwC,CAAA;AAU9F;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAA+B,EAAmB,EAAE;IACzF,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAA;IAE3D,MAAM,SAAS,GAAG,qBAAqB,EAAE,CAAA;IACzC,IAAI,cAAc,GAA4B,IAAI,CAAA;IAClD,IAAI,QAAQ,GAAG,KAAK,CAAA;IAEpB,6CAA6C;IAC7C,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE;QACpD,QAAQ,EAAE,CAAC,OAAyB,EAAE,EAAE;YACvC,OAAO,CAAC,KAAK,CAAC,mCAAmC,OAAO,CAAC,KAAK,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;YAElF,cAAc,GAAG,OAAO,CAAA;YAExB,cAAc,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAElD,8BAA8B;YAC9B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,0BAA0B,EAAE,CAAC,MAAM,EAAE,EAAE;gBAC7D,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC,CAAA;gBACrF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACvB,CAAC,CAAC,CAAA;YAEF,gCAAgC;YAChC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,MAAM,EAAE,EAAE;gBAC5D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC,CAAA;gBACvF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACvB,CAAC,CAAC,CAAA;YAEF,uBAAuB;YACvB,MAAM,MAAM,GAAoB;gBAC/B,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;gBACzB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,IAAI,EAAE,MAAM;gBACZ,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ,EAAE,IAAI;aACd,CAAA;YAED,MAAM,CAAC,QAAQ,CAAC;gBACf,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE;oBACP,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,IAAI,EAAE,MAAM;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,MAAM,EAAE,IAAI;aACZ,CAAC,CAAA;YAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC/C,CAAC;QAED,QAAQ,EAAE,CAAC,KAAa,EAAE,MAAc,EAAE,EAAE;YAC3C,OAAO,CAAC,KAAK,CAAC,mCAAmC,KAAK,MAAM,MAAM,EAAE,CAAC,CAAA;YAErE,IAAI,cAAc,EAAE,KAAK,KAAK,KAAK,EAAE,CAAC;gBACrC,cAAc,GAAG,IAAI,CAAA;YACtB,CAAC;YAED,MAAM,CAAC,QAAQ,CAAC;gBACf,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,IAAI;gBACZ,MAAM;aACN,CAAC,CAAA;YAEF,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAA;QAC1B,CAAC;QAED,aAAa,EAAE,GAAG,EAAE;YACnB,uCAAuC;QACxC,CAAC;KACD,CAAC,CAAA;IAEF,sEAAsE;IACtE,MAAM,YAAY,GAAqB;QACtC,UAAU,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,KAAK;QAE9D,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YAC9C,MAAM,OAAO,GAAG,cAAc,CAAA;YAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,+BAA+B,CAAC,CACvD;gBAAC,KAAmC,CAAC,IAAI,GAAG,kBAAkB,CAAA;gBAC/D,MAAM,KAAK,CAAA;YACZ,CAAC;YACD,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QAC3D,CAAC;QAED,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;YAC5B,mEAAmE;YACnE,yEAAyE;YACzE,IAAI,CAAC,cAAc,EAAE,CAAC;gBACrB,sCAAsC;gBACtC,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;YAChB,CAAC;YACD,OAAO,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACtD,CAAC;KACD,CAAA;IAED,yBAAyB;IACzB,SAAS,CAAC,KAAK,EAAE,CAAA;IACjB,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE;QAC3B,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAA;QACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,CAAC,QAAQ,CAAC;gBACf,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,wBAAwB;aAChC,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,EAAE,CAAC,wBAAwB,CAAC,CAAA;QAC5C,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACtC,QAAQ,GAAG,IAAI,CAAA;QACf,SAAS,CAAC,IAAI,EAAE,CAAA;IACjB,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,KAAK,IAAgC,EAAE;QAC1D,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,CAAA;QAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IAC7B,CAAC,CAAA;IAED,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAQ,EAAE;QAC/C,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;IACnC,CAAC,CAAA;IAED,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAQ,EAAE;QAC/C,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;IACnC,CAAC,CAAA;IAED,OAAO;QACN,OAAO,EAAE,YAAY;QACrB,IAAI;QACJ,WAAW;QACX,YAAY;QACZ,YAAY;KACZ,CAAA;AACF,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,GAAG,CAAC,GAAY,EAAmB,EAAE,CAAC,CAAC;IACvD,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC,KAAK;IAChB,GAAG,EAAE,GAAG,CAAC,GAAG;IACZ,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,GAAG,CAAC,UAAU;IAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;CACtB,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,cAAc,GAAG,CACtB,MAAe,EACf,OAAyB,EACzB,MAA0F,EACnE,EAAE;IACzB,MAAM,MAAM,GAAG,MAKd,CAAA;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IACnD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;IAE1C,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,CAAA;IAElF,OAAO;QACN,EAAE,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;QAClC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC;QAC3C,IAAI;QACJ,IAAI;QACJ,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,kBAAkB,CAAC,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC;QACrE,IAAI,EAAE,KAAK,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;QAC7D,MAAM,EAAE,KAAK,EAAE,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;QACnE,OAAO,EAAE,OAAO,CAAC,GAAG;QACpB,SAAS,EAAE,OAAO,CAAC,KAAK;KACxB,CAAA;AACF,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,gBAAgB,GAAG,CACxB,MAAe,EACf,OAAyB,EACzB,MAA0F,EACnE,EAAE;IACzB,MAAM,MAAM,GAAG,MAOd,CAAA;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAA;IACvC,MAAM,IAAI,GAAG,OAAO,EAAE,SAAS,EAAE,WAAW,IAAI,OAAO,EAAE,IAAI,IAAI,WAAW,CAAA;IAC5E,MAAM,IAAI,GAAG,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAEjG,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,CAAA;IAEpF,OAAO;QACN,EAAE,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;QAClC,KAAK,EAAE,WAAW;QAClB,IAAI;QACJ,IAAI;QACJ,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,kBAAkB,CAAC,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC;QACrE,IAAI,EAAE,KAAK,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;QAC7D,MAAM,EAAE,KAAK,EAAE,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;QACnE,OAAO,EAAE,OAAO,CAAC,GAAG;QACpB,SAAS,EAAE,OAAO,CAAC,KAAK;KACxB,CAAA;AACF,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,IAAoE,EAAU,EAAE;IACnG,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAA;IACV,CAAC;IAED,OAAO,IAAI;SACT,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACZ,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC/E,CAAC;QACD,OAAO,GAAG,CAAC,WAAW,IAAI,IAAI,GAAG,CAAC,IAAI,GAAG,CAAA;IAC1C,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAA;AACZ,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,cAAc,GAAG,CAAC,IAAuB,EAAqB,EAAE;IACrE,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,KAAK,CAAC;QACX,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,SAAS,CAAC;QACf,KAAK,SAAS;YACb,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;QACrE,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACb,OAAO,SAAS,CAAA;QACjB,KAAK,OAAO,CAAC;QACb,KAAK,QAAQ,CAAC;QACd,KAAK,WAAW;YACf,OAAO,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAA;QACpD;YACC,OAAO,KAAK,CAAA;IACd,CAAC;AACF,CAAC,CAAA;AAID;;GAEG;AACH,MAAM,eAAe,GAAG,CAAC,MAA+B,EAAE,aAA4D,EAAoB,EAAE;IAC3I,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IACzB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAA;QACb,CAAC;IACF,CAAC;IAED,8CAA8C;IAC9C,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;AACzB,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,IAAmB,EAAE,QAA8B,EAAiB,EAAE;IACjG,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACjC,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAA;AACZ,CAAC,CAAA"}

package/dist/sources/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Source abstraction types for unified CDP and Extension modes.
+ * Both sources implement the same interface, allowing the watcher
+ * to work with either CDP WebSocket or Extension Native Messaging.
+ */
+import type { LogEvent } from '@vforsh/argus-core';
+import type { CdpSessionHandle } from '../cdp/connection.js';
+/**
+ * Represents a CDP target (either from Chrome /json or extension tabs).
+ */
+export type CdpSourceTarget = {
+    /** Target/tab ID (string for CDP, number for extension). */
+    id: string;
+    /** Page title. */
+    title: string;
+    /** Page URL. */
+    url: string;
+    /** Target type (e.g., 'page', 'iframe'). */
+    type?: string;
+    /** Parent target ID for nested targets. */
+    parentId?: string | null;
+    /** Favicon URL (extension mode only). */
+    faviconUrl?: string;
+    /** Whether the target is currently attached. */
+    attached?: boolean;
+};
+/**
+ * CDP attachment status.
+ */
+export type CdpSourceStatus = {
+    attached: boolean;
+    target: {
+        title: string | null;
+        url: string | null;
+        type: string | null;
+        parentId: string | null;
+    } | null;
+    /** Best-effort reason for detachment. Null when attached. */
+    reason?: string | null;
+};
+/**
+ * Events emitted by a CDP source.
+ */
+export type CdpSourceEvents = {
+    /** Called when a log event is captured. */
+    onLog: (event: Omit<LogEvent, 'id'>) => void;
+    /** Called when CDP status changes (attached/detached). */
+    onStatus: (status: CdpSourceStatus) => void;
+    /** Called when a session is attached to a target. */
+    onAttach?: (session: CdpSessionHandle, target: CdpSourceTarget) => Promise<void> | void;
+    /** Called when a session is detached from a target. */
+    onDetach?: (reason: string) => void;
+    /** Called on page navigation (for file log rotation). */
+    onPageNavigation?: (info: {
+        url: string;
+        title: string | null;
+    }) => void;
+    /** Called when the page DOM is ready after navigation. */
+    onPageLoad?: () => void;
+    /** Called when page intl info is available. */
+    onPageIntl?: (info: {
+        timezone: string | null;
+        locale: string | null;
+    }) => void;
+};
+/**
+ * Handle for a running CDP source.
+ */
+export type CdpSourceHandle = {
+    /** The CDP session handle for sending commands and subscribing to events. */
+    session: CdpSessionHandle;
+    /** Stop the source and clean up resources. */
+    stop: () => Promise<void>;
+    /** List available targets (extension mode only). */
+    listTargets?: () => Promise<CdpSourceTarget[]>;
+    /** Attach to a specific target by ID (extension mode only). */
+    attachTarget?: (targetId: number) => void;
+    /** Detach from a specific target by ID (extension mode only). */
+    detachTarget?: (targetId: number) => void;
+};
+/**
+ * Options common to all CDP sources.
+ */
+export type CdpSourceBaseOptions = {
+    /** Event handlers for the source. */
+    events: CdpSourceEvents;
+    /** Optional ignore list filtering for log/exception locations. */
+    ignoreMatcher?: ((url: string) => boolean) | null;
+    /** Strip these literal prefixes from event.file for display/logging. */
+    stripUrlPrefixes?: string[];
+};
+//# sourceMappingURL=types.d.ts.map