@vforsh/argus 0.1.19 → 0.1.20

package/dist/commands/extension/extensionId.js

@@ -0,0 +1,37 @@
+import { createHash } from 'node:crypto';
+/**
+ * Stable Chrome extension ID for the Argus CDP Bridge.
+ *
+ * The extension's `manifest.json` pins a public `key`, so Chrome derives this
+ * exact ID on every machine and install path (instead of a path-dependent id).
+ * Because the ID is constant, `argus extension setup`/`install` need no ID
+ * argument and the native messaging host manifest never has to be rewritten.
+ *
+ * Source of truth: `packages/argus-extension/key.pem` (gitignored). Regenerate
+ * both values with `bun run --cwd packages/argus-extension generate-key`, which
+ * updates the manifest `key` and prints the matching id. The drift guard in
+ * `packages/argus/test/extension-id.test.ts` keeps these three in sync.
+ */
+export const ARGUS_EXTENSION_ID = 'ibhecpfiodfmkpflcnnkkgnjifheefhb';
+/** Base64 SPKI public key pinned as the extension manifest `key` field. */
+export const ARGUS_EXTENSION_PUBLIC_KEY = 'MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAt1lmJWE8y/3by5FlIta/a35cckp3mOVkFSmn8imDO+6S4xsD7naFwonrRMlMMd6lljOBG+sa5YgiMEeR1XwwyZlSDqXIOaNdizChK8wjtjhYldRmax9NQCbhejFWRyIDsR+B7xmbRsroCnSG667JR6D3q8L5v2Qbd/4rH+zZniqUdZKOPJEyjOBEbWoytX3nTWbJvCy+AHznAtnkIWysQyibUkMIBxDGNBSpx507Cc6kMrWZpnCSkjKtRj7qLpMEat4xQdkOhh3mZCisSimQoMD2Axhnqmyacj8IoKDQX+xkb6qLArO7nWr6QD4rOVWrTdgSBg+4TfW3C2zDCP5UhwIDAQAB';
+/**
+ * Derive a Chrome extension ID from a base64 SPKI public key, matching Chrome's
+ * algorithm: SHA-256 of the DER public key, first 16 bytes, each hex nibble
+ * mapped 0-f -> a-p.
+ *
+ * @param publicKeyBase64 - Base64-encoded DER (SPKI) public key, i.e. the value
+ *   of the manifest `key` field.
+ * @returns The 32-character extension ID.
+ */
+export const deriveExtensionId = (publicKeyBase64) => {
+    const der = Buffer.from(publicKeyBase64, 'base64');
+    const hash = createHash('sha256').update(der).digest();
+    const hex = hash.subarray(0, 16).toString('hex');
+    let id = '';
+    for (const char of hex) {
+        id += String.fromCharCode(parseInt(char, 16) + 'a'.charCodeAt(0));
+    }
+    return id;
+};
+//# sourceMappingURL=extensionId.js.map

package/dist/commands/extension/extensionId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionId.js","sourceRoot":"","sources":["../../../src/commands/extension/extensionId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,kCAAkC,CAAA;AAEpE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,0BAA0B,GACtC,0YAA0Y,CAAA;AAE3Y;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,eAAuB,EAAU,EAAE;IACpE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAA;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAChD,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACxB,EAAE,IAAI,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IAClE,CAAC;IACD,OAAO,EAAE,CAAA;AACV,CAAC,CAAA"}

package/dist/commands/extension/extensionPath.d.ts

@@ -0,0 +1,15 @@
+export type ExtensionPathOptions = {
+    json?: boolean;
+};
+/**
+ * Print the absolute path to the unpacked Argus extension to load via
+ * chrome://extensions ("Load unpacked"). The built extension ships inside the
+ * CLI package (`dist/extension`), so end users never run a build step.
+ */
+export declare const runExtensionPath: (options: ExtensionPathOptions) => void;
+/**
+ * Resolve the directory of the loadable unpacked extension, or `null` if no
+ * candidate contains both a manifest and a built service worker.
+ */
+export declare const resolveExtensionDir: () => string | null;
+//# sourceMappingURL=extensionPath.d.ts.map

package/dist/commands/extension/extensionPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionPath.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/extensionPath.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,oBAAoB,GAAG;IAClC,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,oBAAoB,KAAG,IAqBhE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAO,MAAM,GAAG,IAO/C,CAAA"}

package/dist/commands/extension/extensionPath.js

@@ -0,0 +1,61 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createOutput } from '../../output/io.js';
+/**
+ * Print the absolute path to the unpacked Argus extension to load via
+ * chrome://extensions ("Load unpacked"). The built extension ships inside the
+ * CLI package (`dist/extension`), so end users never run a build step.
+ */
+export const runExtensionPath = (options) => {
+    const output = createOutput(options);
+    const extensionDir = resolveExtensionDir();
+    if (!extensionDir) {
+        const message = `Packaged Argus extension not found. Checked:\n${resolveExtensionCandidates().join('\n')}`;
+        if (options.json) {
+            output.writeJson({ ok: false, error: { message } });
+        }
+        else {
+            console.error(message);
+        }
+        process.exitCode = 2;
+        return;
+    }
+    if (options.json) {
+        output.writeJson({ ok: true, path: extensionDir });
+        return;
+    }
+    output.writeHuman(extensionDir);
+};
+/**
+ * Resolve the directory of the loadable unpacked extension, or `null` if no
+ * candidate contains both a manifest and a built service worker.
+ */
+export const resolveExtensionDir = () => {
+    for (const candidate of resolveExtensionCandidates()) {
+        if (isLoadableExtensionDir(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+};
+const isLoadableExtensionDir = (dir) => {
+    return fs.existsSync(path.join(dir, 'manifest.json')) && fs.existsSync(path.join(dir, 'dist', 'background', 'service-worker.js'));
+};
+/**
+ * Candidate locations, covering the bundled CLI (`<dist>/extension`), the
+ * tsc-only build (`<dist>/commands/extension` -> `<dist>/extension`), and the
+ * dev source tree (`packages/argus-extension`).
+ */
+const resolveExtensionCandidates = () => {
+    const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        path.resolve(moduleDir, 'extension'),
+        path.resolve(moduleDir, '..', '..', 'extension'),
+        path.resolve(moduleDir, '..', 'extension'),
+        path.resolve(moduleDir, '..', '..', '..', 'argus-extension'),
+        path.resolve(moduleDir, '..', '..', '..', '..', 'argus-extension'),
+    ];
+    return [...new Set(candidates)];
+};
+//# sourceMappingURL=extensionPath.js.map

package/dist/commands/extension/extensionPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionPath.js","sourceRoot":"","sources":["../../../src/commands/extension/extensionPath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAMjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAA6B,EAAQ,EAAE;IACvE,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;IACpC,MAAM,YAAY,GAAG,mBAAmB,EAAE,CAAA;IAE1C,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,iDAAiD,0BAA0B,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;QAC1G,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAA;QACpD,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACvB,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;QACpB,OAAM;IACP,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAA;QAClD,OAAM;IACP,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;AAChC,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAkB,EAAE;IACtD,KAAK,MAAM,SAAS,IAAI,0BAA0B,EAAE,EAAE,CAAC;QACtD,IAAI,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,OAAO,SAAS,CAAA;QACjB,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAW,EAAE;IACvD,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAA;AAClI,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,0BAA0B,GAAG,GAAa,EAAE;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC9D,MAAM,UAAU,GAAG;QAClB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC;KAClE,CAAA;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;AAChC,CAAC,CAAA"}

package/dist/commands/extension/install.d.ts

@@ -0,0 +1,16 @@
+export type ExtensionInstallOptions = {
+    /** Open chrome://extensions automatically. Disable with --no-open. */
+    open?: boolean;
+    /** Wait for the extension to connect. Disable with --no-wait. */
+    wait?: boolean;
+    /** Seconds to wait for the extension to connect (default 120). */
+    timeout?: string;
+    json?: boolean;
+};
+/**
+ * One-command extension setup: install the native messaging hosts with the
+ * pinned ID, open chrome://extensions, point the user at the unpacked folder,
+ * then wait until the extension connects and report the first command to run.
+ */
+export declare const runExtensionInstall: (options: ExtensionInstallOptions) => Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/extension/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/install.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,uBAAuB,GAAG;IACrC,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAKD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAU,SAAS,uBAAuB,KAAG,OAAO,CAAC,IAAI,CAqDxF,CAAA"}

package/dist/commands/extension/install.js

@@ -0,0 +1,154 @@
+import { spawn } from 'node:child_process';
+import { readRegistry } from '@vforsh/argus-core';
+import { createOutput } from '../../output/io.js';
+import { pruneRegistry } from '../../registry.js';
+import { resolveChromeBin } from '../../utils/chromeBin.js';
+import { ARGUS_EXTENSION_ID } from './extensionId.js';
+import { resolveExtensionDir } from './extensionPath.js';
+import { CONTROL_WATCHER_ID, findArgusExecutable, getPlatform, installNativeHosts } from './nativeHost.js';
+const DEFAULT_TIMEOUT_SECONDS = 120;
+const POLL_INTERVAL_MS = 700;
+/**
+ * One-command extension setup: install the native messaging hosts with the
+ * pinned ID, open chrome://extensions, point the user at the unpacked folder,
+ * then wait until the extension connects and report the first command to run.
+ */
+export const runExtensionInstall = async (options) => {
+    const output = createOutput(options);
+    let platform;
+    try {
+        platform = getPlatform();
+    }
+    catch (error) {
+        return fail(output, error.message);
+    }
+    const extensionDir = resolveExtensionDir();
+    if (!extensionDir) {
+        return fail(output, 'Packaged Argus extension not found. Build the CLI (npm run build:packages) or run from a built checkout.');
+    }
+    let executablePath;
+    try {
+        executablePath = findArgusExecutable();
+    }
+    catch (error) {
+        return fail(output, error.message);
+    }
+    let hosts;
+    try {
+        hosts = installNativeHosts(platform, ARGUS_EXTENSION_ID, executablePath);
+    }
+    catch (error) {
+        return fail(output, `Failed to install native hosts: ${error.message}`);
+    }
+    await pruneRegistry();
+    let connected = await isControlConnected();
+    const shouldOpen = options.open !== false && !connected;
+    const opened = shouldOpen ? openExtensionsPage() : false;
+    if (!output.json) {
+        printSummary(output, { extensionDir, hosts, connected, opened, shouldOpen });
+    }
+    const shouldWait = options.wait !== false && !connected;
+    if (shouldWait) {
+        connected = await waitForControl(parseTimeoutMs(options.timeout), output);
+    }
+    if (output.json) {
+        output.writeJson({ success: true, extensionId: ARGUS_EXTENSION_ID, extensionPath: extensionDir, hosts, connected });
+        if (!connected && shouldWait) {
+            process.exitCode = 1;
+        }
+        return;
+    }
+    printResult(output, connected, shouldWait);
+};
+const isControlConnected = async () => {
+    const { registry } = await readRegistry();
+    return Boolean(registry.watchers[CONTROL_WATCHER_ID]);
+};
+const openExtensionsPage = () => {
+    const chromeBin = resolveChromeBin();
+    if (!chromeBin) {
+        return false;
+    }
+    try {
+        const child = spawn(chromeBin, ['chrome://extensions/'], { stdio: 'ignore', detached: true });
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const waitForControl = async (timeoutMs, output) => {
+    if (!output.json) {
+        output.writeHuman(`Waiting for the extension to connect (up to ${Math.round(timeoutMs / 1000)}s)...`);
+    }
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (await isControlConnected()) {
+            return true;
+        }
+        await delay(POLL_INTERVAL_MS);
+    }
+    return isControlConnected();
+};
+const printSummary = (output, info) => {
+    output.writeHuman('');
+    output.writeHuman('Argus extension setup');
+    output.writeHuman('');
+    output.writeHuman(`  Native hosts:  installed (${info.hosts.map((host) => host.hostName).join(', ')})`);
+    output.writeHuman(`  Extension ID:  ${ARGUS_EXTENSION_ID}`);
+    output.writeHuman(`  Load unpacked: ${info.extensionDir}`);
+    output.writeHuman('');
+    if (info.connected) {
+        return;
+    }
+    if (info.opened) {
+        output.writeHuman('Opened chrome://extensions. Click "Load unpacked" and select the folder above.');
+    }
+    else if (info.shouldOpen) {
+        output.writeHuman('Open chrome://extensions, then click "Load unpacked" and select the folder above.');
+    }
+    else {
+        output.writeHuman('Open chrome://extensions and "Load unpacked" the folder above.');
+    }
+    output.writeHuman('(Enable Developer mode if the "Load unpacked" button is hidden.)');
+    output.writeHuman('');
+};
+const printResult = (output, connected, waited) => {
+    if (connected) {
+        output.writeHuman('Extension connected.');
+        output.writeHuman('');
+        output.writeHuman('Try it:');
+        output.writeHuman('  argus ext tabs');
+        output.writeHuman('');
+        return;
+    }
+    if (waited) {
+        output.writeHuman('Extension did not connect yet.');
+        output.writeHuman('  - If it is already loaded, open its popup or reload it in chrome://extensions.');
+        output.writeHuman('  - Then check `argus extension status` and `argus ext doctor`.');
+        output.writeHuman('');
+        process.exitCode = 1;
+        return;
+    }
+    output.writeHuman('Once loaded, verify with `argus ext tabs`.');
+    output.writeHuman('');
+};
+const parseTimeoutMs = (value) => {
+    const seconds = value ? Number.parseInt(value, 10) : DEFAULT_TIMEOUT_SECONDS;
+    if (!Number.isFinite(seconds) || seconds < 5) {
+        return DEFAULT_TIMEOUT_SECONDS * 1000;
+    }
+    return seconds * 1000;
+};
+const fail = (output, message) => {
+    if (output.json) {
+        output.writeJson({ success: false, error: { message } });
+    }
+    else {
+        console.error(message);
+    }
+    process.exitCode = 1;
+};
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+//# sourceMappingURL=install.js.map

package/dist/commands/extension/install.js.map

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

package/dist/commands/extension/setup.d.ts

@@ -1,5 +1,6 @@
 export type ExtensionSetupOptions = {
-    extensionId: string;
+    /** Override the pinned extension ID. Defaults to {@link ARGUS_EXTENSION_ID}. */
+    extensionId?: string;
     json?: boolean;
 };
 export declare const runExtensionSetup: (options: ExtensionSetupOptions) => Promise<void>;

package/dist/commands/extension/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/setup.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,qBAAqB,GAAG;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAU,SAAS,qBAAqB,KAAG,OAAO,CAAC,IAAI,CAmEpF,CAAA"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/setup.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,qBAAqB,GAAG;IACnC,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAU,SAAS,qBAAqB,KAAG,OAAO,CAAC,IAAI,CAqEpF,CAAA"}

package/dist/commands/extension/setup.js

@@ -1,8 +1,9 @@
 import { createOutput } from '../../output/io.js';
 import { getPlatform, findArgusExecutable, installNativeHosts, shortenPath } from './nativeHost.js';
+import { ARGUS_EXTENSION_ID } from './extensionId.js';
 export const runExtensionSetup = async (options) => {
     const output = createOutput(options);
-    const { extensionId } = options;
+    const extensionId = options.extensionId ?? ARGUS_EXTENSION_ID;
     let platform;
     try {
         platform = getPlatform();
@@ -66,9 +67,11 @@ export const runExtensionSetup = async (options) => {
         }
         output.writeHuman('');
         output.writeHuman('Next steps:');
-        output.writeHuman('  1. Reload the extension in chrome://extensions');
+        output.writeHuman('  1. Load the unpacked extension from `argus extension path` (if not already loaded)');
         output.writeHuman('  2. Run `argus ext tabs` or open the extension popup and attach a tab');
         output.writeHuman('');
+        output.writeHuman('Tip: `argus extension install` does this end-to-end and waits for the extension to connect.');
+        output.writeHuman('');
     }
 };
 //# sourceMappingURL=setup.js.map

package/dist/commands/extension/setup.js.map

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

package/dist/extension/dist/background/auth-header-monitor.js

@@ -0,0 +1,77 @@
+const AUTH_HEADER_NAMES = new Set([
+    'authorization',
+    'cookie',
+    'x-api-key',
+    'x-auth-token',
+    'x-csrf-token',
+    'x-csrftoken',
+    'x-xsrf-token',
+    'csrf-token',
+    'xsrf-token',
+]);
+const WEB_REQUEST_FILTER = { urls: ['<all_urls>'] };
+const WEB_REQUEST_EXTRA_INFO = ['requestHeaders', 'extraHeaders'];
+/**
+ * Observe auth-related request headers for currently attached tabs.
+ * We keep the extension payload narrow so the native bridge never has to ship full request headers.
+ */
+export class AuthHeaderMonitor {
+    debuggerManager;
+    bridgeClient;
+    constructor(debuggerManager, bridgeClient) {
+        this.debuggerManager = debuggerManager;
+        this.bridgeClient = bridgeClient;
+        chrome.webRequest.onBeforeSendHeaders.addListener((details) => {
+            this.handleBeforeSendHeaders(details);
+        }, WEB_REQUEST_FILTER, WEB_REQUEST_EXTRA_INFO);
+    }
+    handleBeforeSendHeaders(details) {
+        const message = createObservedHeadersMessage(details, this.debuggerManager);
+        if (!message) {
+            return;
+        }
+        this.bridgeClient.send(message);
+    }
+}
+const createObservedHeadersMessage = (details, debuggerManager) => {
+    if (details.tabId < 0 || !debuggerManager.isAttached(details.tabId)) {
+        return null;
+    }
+    const requestHeaders = pickObservedAuthHeaders(details.requestHeaders);
+    if (!requestHeaders) {
+        return null;
+    }
+    return {
+        type: 'auth_headers_observed',
+        tabId: details.tabId,
+        url: details.url,
+        method: details.method,
+        ts: typeof details.timeStamp === 'number' ? details.timeStamp : Date.now(),
+        requestHeaders,
+    };
+};
+const pickObservedAuthHeaders = (headers) => {
+    if (!headers || headers.length === 0) {
+        return undefined;
+    }
+    const observed = {};
+    for (const header of headers) {
+        const name = header.name?.trim().toLowerCase();
+        if (!name || !AUTH_HEADER_NAMES.has(name)) {
+            continue;
+        }
+        const value = normalizeHeaderValue(header.value);
+        if (!value) {
+            continue;
+        }
+        observed[name] = value;
+    }
+    return Object.keys(observed).length > 0 ? observed : undefined;
+};
+const normalizeHeaderValue = (value) => {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed || null;
+};

package/dist/extension/dist/background/bridge-client.js

@@ -0,0 +1,120 @@
+/**
+ * Native Messaging client for communicating with argus-watcher (extension mode).
+ * Handles connection lifecycle, message serialization, and reconnection.
+ */
+export class BridgeClient {
+    port = null;
+    hostName;
+    messageHandlers = new Set();
+    connectHandler = null;
+    disconnectHandler = null;
+    reconnectAttempts = 0;
+    maxReconnectAttempts = 5;
+    reconnectDelay = 1000;
+    constructor(hostName = 'com.vforsh.argus.bridge') {
+        this.hostName = hostName;
+    }
+    /**
+     * Set handler for incoming messages from the host.
+     */
+    onMessage(handler) {
+        this.messageHandlers.add(handler);
+    }
+    /**
+     * Set handler for successful connection.
+     */
+    onConnect(handler) {
+        this.connectHandler = handler;
+    }
+    /**
+     * Set handler for disconnection.
+     */
+    onDisconnect(handler) {
+        this.disconnectHandler = handler;
+    }
+    /**
+     * Connect to the Native Messaging host.
+     */
+    connect() {
+        if (this.port) {
+            return true; // Already connected
+        }
+        try {
+            this.port = chrome.runtime.connectNative(this.hostName);
+            this.port.onMessage.addListener((message) => {
+                this.reconnectAttempts = 0; // Reset on successful message
+                for (const handler of this.messageHandlers) {
+                    handler(message);
+                }
+            });
+            this.port.onDisconnect.addListener(() => {
+                const error = chrome.runtime.lastError;
+                console.log('[BridgeClient] Disconnected:', error?.message ?? 'unknown reason');
+                this.port = null;
+                if (this.disconnectHandler) {
+                    this.disconnectHandler();
+                }
+                // Attempt reconnection
+                this.scheduleReconnect();
+            });
+            console.log('[BridgeClient] Connected to', this.hostName);
+            this.reconnectAttempts = 0;
+            if (this.connectHandler) {
+                this.connectHandler();
+            }
+            return true;
+        }
+        catch (err) {
+            console.error('[BridgeClient] Failed to connect:', err);
+            this.scheduleReconnect();
+            return false;
+        }
+    }
+    /**
+     * Disconnect from the Native Messaging host.
+     */
+    disconnect() {
+        if (this.port) {
+            this.port.disconnect();
+            this.port = null;
+        }
+    }
+    /**
+     * Send a message to the Native Messaging host.
+     */
+    send(message) {
+        if (!this.port) {
+            console.warn('[BridgeClient] Cannot send, not connected');
+            return false;
+        }
+        try {
+            this.port.postMessage(message);
+            return true;
+        }
+        catch (err) {
+            console.error('[BridgeClient] Send failed:', err);
+            return false;
+        }
+    }
+    /**
+     * Check if connected to the host.
+     */
+    isConnected() {
+        return this.port !== null;
+    }
+    /**
+     * Schedule a reconnection attempt with exponential backoff.
+     */
+    scheduleReconnect() {
+        if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+            console.log('[BridgeClient] Max reconnection attempts reached');
+            return;
+        }
+        const delay = this.reconnectDelay * Math.pow(2, this.reconnectAttempts);
+        this.reconnectAttempts++;
+        console.log(`[BridgeClient] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts})`);
+        setTimeout(() => {
+            this.connect();
+        }, delay);
+    }
+}