@vforsh/argus-watcher 0.1.2 → 0.1.4

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,eA2C3D,CAAA"}

package/dist/sources/cdp-source.js

@@ -0,0 +1,49 @@
+/**
+ * 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,
+        pageSession: 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,WAAW,EAAE,OAAO,CAAC,OAAO;QAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,iEAAiE;QACjE,0CAA0C;KAC1C,CAAA;AACF,CAAC,CAAA"}

package/dist/sources/extension-frame-state.d.ts

@@ -0,0 +1,64 @@
+import type { CdpSourceTarget } from './types.js';
+type SessionSummary = {
+    tabId: number;
+    url: string;
+    title: string;
+    faviconUrl?: string;
+};
+export type ExtensionFrameState = {
+    topFrameId: string | null;
+    requestedFrameId: string | null;
+    activeFrameId: string | null;
+    activeAttachedAt: number | null;
+    frames: Map<string, ExtensionFrame>;
+    executionContexts: Map<string, number>;
+    pendingTitleLoads: Set<string>;
+};
+export type ExtensionFrame = {
+    frameId: string;
+    parentFrameId: string | null;
+    url: string;
+    title: string | null;
+    sessionId: string | null;
+};
+export type CdpFrameTreeNode = {
+    frame?: {
+        id?: string;
+        parentId?: string;
+        url?: string;
+        name?: string;
+    };
+    childFrames?: CdpFrameTreeNode[];
+};
+export declare const createEmptyFrameState: () => ExtensionFrameState;
+export declare const createNotAttachedError: () => Error;
+export declare const formatPageTargetId: (tabId: number) => string;
+export declare const formatFrameTargetId: (tabId: number, frameId: string) => string;
+export declare const parseExtensionTargetId: (targetId: string) => {
+    tabId: number;
+    frameId: string | null;
+};
+export declare const buildPageTarget: (session: SessionSummary, options: {
+    attached: boolean;
+}) => CdpSourceTarget;
+export declare const frameToTarget: (tabId: number, frame: ExtensionFrame, options: {
+    attached: boolean;
+    faviconUrl?: string;
+    topFrameId: string | null;
+}) => CdpSourceTarget;
+export declare const buildFrameTargets: (state: ExtensionFrameState, tabId: number, activeFrameId: string | null, faviconUrl?: string) => CdpSourceTarget[];
+export declare const collectFrameTree: (node: CdpFrameTreeNode | undefined, state: ExtensionFrameState) => void;
+export declare const parseFrame: (params: unknown) => ExtensionFrame | null;
+export declare const parseExecutionContext: (params: unknown) => {
+    id: number;
+    frameId: string | null;
+    isDefault: boolean;
+} | null;
+/**
+ * Selection is about the user's intended target, not whether every frame-scoped command is ready.
+ * Once the watcher knows the frame exists we can switch the active target; commands that require
+ * an execution context still guard that separately at execution time.
+ */
+export declare const resolveRequestedFrameId: (state: ExtensionFrameState, requestedFrameId: string | null) => string | null;
+export {};
+//# sourceMappingURL=extension-frame-state.d.ts.map

package/dist/sources/extension-frame-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-frame-state.d.ts","sourceRoot":"","sources":["../../src/sources/extension-frame-state.ts"],"names":[],"mappings":"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"}

package/dist/sources/extension-frame-state.js

@@ -0,0 +1,117 @@
+export const createEmptyFrameState = () => ({
+    topFrameId: null,
+    requestedFrameId: null,
+    activeFrameId: null,
+    activeAttachedAt: null,
+    frames: new Map(),
+    executionContexts: new Map(),
+    pendingTitleLoads: new Set(),
+});
+export const createNotAttachedError = () => {
+    const error = new Error('No tab attached via extension');
+    error.code = 'cdp_not_attached';
+    return error;
+};
+export const formatPageTargetId = (tabId) => `tab:${tabId}`;
+export const formatFrameTargetId = (tabId, frameId) => `frame:${tabId}:${frameId}`;
+export const parseExtensionTargetId = (targetId) => {
+    if (targetId.startsWith('tab:')) {
+        const tabId = Number.parseInt(targetId.slice(4), 10);
+        if (Number.isFinite(tabId)) {
+            return { tabId, frameId: null };
+        }
+    }
+    if (targetId.startsWith('frame:')) {
+        const [, tabIdRaw, ...frameIdParts] = targetId.split(':');
+        const tabId = Number.parseInt(tabIdRaw ?? '', 10);
+        const frameId = frameIdParts.join(':');
+        if (Number.isFinite(tabId) && frameId) {
+            return { tabId, frameId };
+        }
+    }
+    const legacyTabId = Number.parseInt(targetId, 10);
+    if (Number.isFinite(legacyTabId)) {
+        return { tabId: legacyTabId, frameId: null };
+    }
+    throw new Error(`Invalid extension target id: ${targetId}`);
+};
+export const buildPageTarget = (session, options) => ({
+    id: formatPageTargetId(session.tabId),
+    title: session.title,
+    url: session.url,
+    type: 'page',
+    parentId: null,
+    faviconUrl: session.faviconUrl,
+    attached: options.attached,
+});
+export const frameToTarget = (tabId, frame, options) => ({
+    id: formatFrameTargetId(tabId, frame.frameId),
+    title: frame.title ?? frame.url ?? `iframe ${frame.frameId}`,
+    url: frame.url,
+    type: 'iframe',
+    parentId: frame.parentFrameId && frame.parentFrameId !== options.topFrameId
+        ? formatFrameTargetId(tabId, frame.parentFrameId)
+        : formatPageTargetId(tabId),
+    faviconUrl: options.faviconUrl,
+    attached: options.attached,
+});
+export const buildFrameTargets = (state, tabId, activeFrameId, faviconUrl) => [...state.frames.values()]
+    .filter((frame) => frame.frameId !== state.topFrameId)
+    .map((frame) => frameToTarget(tabId, frame, { attached: frame.frameId === activeFrameId, faviconUrl, topFrameId: state.topFrameId }));
+export const collectFrameTree = (node, state) => {
+    if (!node?.frame?.id) {
+        return;
+    }
+    const frameId = node.frame.id;
+    state.frames.set(frameId, {
+        frameId,
+        parentFrameId: node.frame.parentId ?? null,
+        url: node.frame.url ?? '',
+        title: node.frame.name ?? null,
+        sessionId: state.frames.get(frameId)?.sessionId ?? null,
+    });
+    if (!node.frame.parentId) {
+        state.topFrameId = frameId;
+    }
+    for (const child of node.childFrames ?? []) {
+        collectFrameTree(child, state);
+    }
+};
+export const parseFrame = (params) => {
+    const record = params;
+    const frameId = record.frame?.id;
+    const url = record.frame?.url;
+    if (!frameId || !url || typeof url !== 'string' || url.trim() === '') {
+        return null;
+    }
+    return {
+        frameId,
+        parentFrameId: record.frame?.parentId ?? null,
+        url,
+        title: record.frame?.name ?? null,
+        sessionId: null,
+    };
+};
+export const parseExecutionContext = (params) => {
+    const record = params;
+    if (record.context?.id == null) {
+        return null;
+    }
+    return {
+        id: record.context.id,
+        frameId: record.context.auxData?.frameId ?? null,
+        isDefault: record.context.auxData?.isDefault === true,
+    };
+};
+/**
+ * Selection is about the user's intended target, not whether every frame-scoped command is ready.
+ * Once the watcher knows the frame exists we can switch the active target; commands that require
+ * an execution context still guard that separately at execution time.
+ */
+export const resolveRequestedFrameId = (state, requestedFrameId) => {
+    if (!requestedFrameId) {
+        return null;
+    }
+    return state.frames.has(requestedFrameId) ? requestedFrameId : null;
+};
+//# sourceMappingURL=extension-frame-state.js.map

package/dist/sources/extension-frame-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-frame-state.js","sourceRoot":"","sources":["../../src/sources/extension-frame-state.ts"],"names":[],"mappings":"AAqCA,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAwB,EAAE,CAAC,CAAC;IAChE,UAAU,EAAE,IAAI;IAChB,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,IAAI;IACnB,gBAAgB,EAAE,IAAI;IACtB,MAAM,EAAE,IAAI,GAAG,EAAE;IACjB,iBAAiB,EAAE,IAAI,GAAG,EAAE;IAC5B,iBAAiB,EAAE,IAAI,GAAG,EAAE;CAC5B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAU,EAAE;IACjD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,+BAA+B,CAAC,CACvD;IAAC,KAAmC,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAC/D,OAAO,KAAK,CAAA;AACb,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,OAAO,KAAK,EAAE,CAAA;AAE3E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAE,OAAe,EAAU,EAAE,CAAC,SAAS,KAAK,IAAI,OAAO,EAAE,CAAA;AAE1G,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,QAAgB,EAA6C,EAAE;IACrG,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACpD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAChC,CAAC;IACF,CAAC;IAED,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACzD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;QACjD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACtC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACvC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;QAC1B,CAAC;IACF,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IACjD,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC7C,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAA;AAC5D,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAuB,EAAE,OAA8B,EAAmB,EAAE,CAAC,CAAC;IAC7G,EAAE,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC;IACrC,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,OAAO,CAAC,UAAU;IAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;CAC1B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAC5B,KAAa,EACb,KAAqB,EACrB,OAA8E,EAC5D,EAAE,CAAC,CAAC;IACtB,EAAE,EAAE,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;IAC7C,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,IAAI,UAAU,KAAK,CAAC,OAAO,EAAE;IAC5D,GAAG,EAAE,KAAK,CAAC,GAAG;IACd,IAAI,EAAE,QAAQ;IACd,QAAQ,EACP,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa,KAAK,OAAO,CAAC,UAAU;QAChE,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC;QACjD,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC,UAAU;IAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;CAC1B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAA0B,EAAE,KAAa,EAAE,aAA4B,EAAE,UAAmB,EAAqB,EAAE,CACpJ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;KACxB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,UAAU,CAAC;KACrD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,KAAK,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAA;AAEvI,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAkC,EAAE,KAA0B,EAAQ,EAAE;IACxG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACtB,OAAM;IACP,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAA;IAC7B,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE;QACzB,OAAO;QACP,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI;QAC1C,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI;QAC9B,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS,IAAI,IAAI;KACvD,CAAC,CAAA;IACF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,KAAK,CAAC,UAAU,GAAG,OAAO,CAAA;IAC3B,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;QAC5C,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAC/B,CAAC;AACF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAe,EAAyB,EAAE;IACpE,MAAM,MAAM,GAAG,MAA4F,CAAA;IAC3G,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,EAAE,CAAA;IAChC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,CAAA;IAC7B,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtE,OAAO,IAAI,CAAA;IACZ,CAAC;IACD,OAAO;QACN,OAAO;QACP,aAAa,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,IAAI,IAAI;QAC7C,GAAG;QACH,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI;QACjC,SAAS,EAAE,IAAI;KACf,CAAA;AACF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAe,EAAqE,EAAE;IAC3H,MAAM,MAAM,GAAG,MAKd,CAAA;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;QAChC,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,OAAO;QACN,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,IAAI;QAChD,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,KAAK,IAAI;KACrD,CAAA;AACF,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAA0B,EAAE,gBAA+B,EAAiB,EAAE;IACrH,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvB,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAA;AACpE,CAAC,CAAA"}

package/dist/sources/extension-log-events.d.ts

@@ -0,0 +1,15 @@
+import type { LogEvent } from '@vforsh/argus-core';
+type SessionSummary = {
+    url: string;
+    title: string;
+};
+export declare const toConsoleEvent: (params: unknown, session: SessionSummary, config: {
+    ignoreMatcher?: ((url: string) => boolean) | null;
+    stripUrlPrefixes?: string[];
+}) => Omit<LogEvent, "id">;
+export declare const toExceptionEvent: (params: unknown, session: SessionSummary, config: {
+    ignoreMatcher?: ((url: string) => boolean) | null;
+    stripUrlPrefixes?: string[];
+}) => Omit<LogEvent, "id">;
+export {};
+//# sourceMappingURL=extension-log-events.d.ts.map

package/dist/sources/extension-log-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-log-events.d.ts","sourceRoot":"","sources":["../../src/sources/extension-log-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,oBAAoB,CAAA;AAG5D,KAAK,cAAc,GAAG;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED,eAAO,MAAM,cAAc,GAC1B,QAAQ,OAAO,EACf,SAAS,cAAc,EACvB,QAAQ;IAAE,aAAa,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,KACxF,IAAI,CAAC,QAAQ,EAAE,IAAI,CAwBrB,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC5B,QAAQ,OAAO,EACf,SAAS,cAAc,EACvB,QAAQ;IAAE,aAAa,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,KACxF,IAAI,CAAC,QAAQ,EAAE,IAAI,CA2BrB,CAAA"}

package/dist/sources/extension-log-events.js

@@ -0,0 +1,101 @@
+import { previewStringify } from '@vforsh/argus-core';
+export const toConsoleEvent = (params, session, config) => {
+    const record = params;
+    const args = record.args?.map((arg) => arg.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,
+    };
+};
+export 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,
+    };
+};
+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(' ');
+};
+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';
+    }
+};
+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;
+        }
+    }
+    return frames[0] ?? null;
+};
+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-log-events.js.map

package/dist/sources/extension-log-events.js.map

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

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;AAKH,OAAO,KAAK,EAAE,eAAe,EAAmB,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAmBxF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,CAAA;AAEzD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,sBAAsB,KAAG,eAmhBvE,CAAA"}