@vforsh/argus 0.1.19 → 0.1.20

package/dist/argus.js

@@ -5,29 +5,15 @@ var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-function __accessProp(key) {
-  return this[key];
-}
-var __toESMCache_node;
-var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
-  var canCache = mod != null && typeof mod === "object";
-  if (canCache) {
-    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
-    var cached = cache.get(mod);
-    if (cached)
-      return cached;
-  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: __accessProp.bind(mod, key),
+        get: () => mod[key],
         enumerable: true
       });
-  if (canCache)
-    cache.set(mod, to);
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
@@ -2144,7 +2130,7 @@ var {
 // package.json
 var package_default = {
   name: "@vforsh/argus",
-  version: "0.1.19",
+  version: "0.1.20",
   repository: {
     type: "git",
     url: "git+https://github.com/vforsh/argus.git",
@@ -2180,7 +2166,7 @@ var package_default = {
   scripts: {
     clean: "node ../../scripts/clean-dist.mjs",
     build: "npm run clean && tsc -b && bun run bundle",
-    bundle: "bun build dist/bin.js --outfile dist/argus.js --target node --external esbuild && node ../../scripts/copy-argus-skill.mjs",
+    bundle: "bun build dist/bin.js --outfile dist/argus.js --target node --external esbuild && node ../../scripts/copy-argus-skill.mjs && node ../../scripts/copy-argus-extension.mjs",
     typecheck: "tsc -b --pretty false",
     "chrome:start": "bun src/bin.ts chrome start"
   }
@@ -49110,9 +49096,63 @@ var pluginCommands = [
   }
 ];
 
-// dist/commands/extension/nativeHost.js
+// dist/commands/extension/install.js
+import { spawn as spawn3 } from "node:child_process";
+
+// dist/commands/extension/extensionId.js
+var ARGUS_EXTENSION_ID = "ibhecpfiodfmkpflcnnkkgnjifheefhb";
+
+// dist/commands/extension/extensionPath.js
 import fs17 from "node:fs";
 import path22 from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+var runExtensionPath = (options) => {
+  const output = createOutput(options);
+  const extensionDir = resolveExtensionDir();
+  if (!extensionDir) {
+    const message = `Packaged Argus extension not found. Checked:
+${resolveExtensionCandidates().join(`
+`)}`;
+    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);
+};
+var resolveExtensionDir = () => {
+  for (const candidate of resolveExtensionCandidates()) {
+    if (isLoadableExtensionDir(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+};
+var isLoadableExtensionDir = (dir) => {
+  return fs17.existsSync(path22.join(dir, "manifest.json")) && fs17.existsSync(path22.join(dir, "dist", "background", "service-worker.js"));
+};
+var resolveExtensionCandidates = () => {
+  const moduleDir = path22.dirname(fileURLToPath2(import.meta.url));
+  const candidates = [
+    path22.resolve(moduleDir, "extension"),
+    path22.resolve(moduleDir, "..", "..", "extension"),
+    path22.resolve(moduleDir, "..", "extension"),
+    path22.resolve(moduleDir, "..", "..", "..", "argus-extension"),
+    path22.resolve(moduleDir, "..", "..", "..", "..", "argus-extension")
+  ];
+  return [...new Set(candidates)];
+};
+
+// dist/commands/extension/nativeHost.js
+import fs18 from "node:fs";
+import path23 from "node:path";
 import os8 from "node:os";
 import { execSync } from "node:child_process";
 var BRIDGE_HOST_NAME = "com.vforsh.argus.bridge";
@@ -49122,21 +49162,21 @@ var HOST_NAMES = [BRIDGE_HOST_NAME, CONTROL_HOST_NAME];
 var getManifestDir = (platform) => {
   switch (platform) {
     case "darwin":
-      return path22.join(os8.homedir(), "Library/Application Support/Google/Chrome/NativeMessagingHosts");
+      return path23.join(os8.homedir(), "Library/Application Support/Google/Chrome/NativeMessagingHosts");
     case "linux":
-      return path22.join(os8.homedir(), ".config/google-chrome/NativeMessagingHosts");
+      return path23.join(os8.homedir(), ".config/google-chrome/NativeMessagingHosts");
     case "win32":
-      return path22.join(process.env.LOCALAPPDATA ?? os8.homedir(), "Google/Chrome/User Data/NativeMessagingHosts");
+      return path23.join(process.env.LOCALAPPDATA ?? os8.homedir(), "Google/Chrome/User Data/NativeMessagingHosts");
     default:
       throw new Error(`Unsupported platform: ${platform}`);
   }
 };
 var getManifestPath = (platform, hostName = BRIDGE_HOST_NAME) => {
-  return path22.join(getManifestDir(platform), `${hostName}.json`);
+  return path23.join(getManifestDir(platform), `${hostName}.json`);
 };
 var getWrapperPath = (platform, hostName = BRIDGE_HOST_NAME) => {
   const filename = hostName === CONTROL_HOST_NAME ? "argus-native-control-host.sh" : "argus-native-host.sh";
-  return path22.join(getManifestDir(platform), filename);
+  return path23.join(getManifestDir(platform), filename);
 };
 var getPlatform = () => {
   const platform = os8.platform();
@@ -49148,8 +49188,8 @@ var getPlatform = () => {
 var findArgusExecutable = () => {
   try {
     const npmGlobalPrefix = execSync("npm config get prefix", { encoding: "utf8" }).trim();
-    const globalBinPath = path22.join(npmGlobalPrefix, "bin", "argus");
-    if (fs17.existsSync(globalBinPath)) {
+    const globalBinPath = path23.join(npmGlobalPrefix, "bin", "argus");
+    if (fs18.existsSync(globalBinPath)) {
       return globalBinPath;
     }
   } catch {}
@@ -49162,7 +49202,7 @@ var findArgusExecutable = () => {
   throw new Error("Could not find argus executable. Please install argus globally (npm install -g @vforsh/argus) or ensure it is in your PATH.");
 };
 var findNodePath = () => {
-  return fs17.realpathSync(process.execPath);
+  return fs18.realpathSync(process.execPath);
 };
 var createManifest = (extensionId, executablePath, hostName = BRIDGE_HOST_NAME) => {
   return {
@@ -49180,16 +49220,16 @@ var createWrapperScript = (platform, executablePath, hostName = BRIDGE_HOST_NAME
   const script = `#!/bin/bash
 exec "${nodePath}" "${executablePath}" ${args}
 `;
-  fs17.writeFileSync(wrapperPath, script, { mode: 493 });
+  fs18.writeFileSync(wrapperPath, script, { mode: 493 });
   return wrapperPath;
 };
 var installNativeHosts = (platform, extensionId, executablePath) => {
-  fs17.mkdirSync(getManifestDir(platform), { recursive: true });
+  fs18.mkdirSync(getManifestDir(platform), { recursive: true });
   return HOST_NAMES.map((hostName) => {
     const wrapperPath = createWrapperScript(platform, executablePath, hostName);
     const manifestPath = getManifestPath(platform, hostName);
     const manifest = createManifest(extensionId, wrapperPath, hostName);
-    fs17.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+    fs18.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
     registerWindowsNativeHost(platform, hostName, manifestPath);
     return { hostName, manifestPath, wrapperPath };
   });
@@ -49209,8 +49249,8 @@ var removeNativeHosts = (platform) => {
 var inspectNativeHost = (platform, hostName) => {
   const manifestPath = getManifestPath(platform, hostName);
   const wrapperPath = getWrapperPath(platform, hostName);
-  const manifestExists = fs17.existsSync(manifestPath);
-  const wrapperExists = fs17.existsSync(wrapperPath);
+  const manifestExists = fs18.existsSync(manifestPath);
+  const wrapperExists = fs18.existsSync(wrapperPath);
   const wrapperExecutable = wrapperExists && isWrapperExecutable(wrapperPath);
   const manifest = manifestExists ? readManifest(manifestPath) : null;
   const manifestValid = Boolean(manifest && manifest.name === hostName && manifest.type === "stdio" && Array.isArray(manifest.allowed_origins));
@@ -49231,7 +49271,7 @@ var inspectNativeHost = (platform, hostName) => {
 };
 var readManifest = (manifestPath) => {
   try {
-    const content = fs17.readFileSync(manifestPath, "utf8");
+    const content = fs18.readFileSync(manifestPath, "utf8");
     return JSON.parse(content);
   } catch {
     return null;
@@ -49239,7 +49279,7 @@ var readManifest = (manifestPath) => {
 };
 var isWrapperExecutable = (wrapperPath) => {
   try {
-    fs17.accessSync(wrapperPath, fs17.constants.X_OK);
+    fs18.accessSync(wrapperPath, fs18.constants.X_OK);
     return true;
   } catch {
     return false;
@@ -49260,10 +49300,10 @@ var extractExtensionId = (origin) => {
   return match?.[1] ?? null;
 };
 var removeFileIfExists = (filePath) => {
-  if (!fs17.existsSync(filePath)) {
+  if (!fs18.existsSync(filePath)) {
     return false;
   }
-  fs17.unlinkSync(filePath);
+  fs18.unlinkSync(filePath);
   return true;
 };
 var registerWindowsNativeHost = (platform, hostName, manifestPath) => {
@@ -49283,10 +49323,145 @@ var unregisterWindowsNativeHost = (platform, hostName) => {
   } catch {}
 };
 
+// dist/commands/extension/install.js
+var DEFAULT_TIMEOUT_SECONDS = 120;
+var POLL_INTERVAL_MS = 700;
+var 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(parseTimeoutMs2(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);
+};
+var isControlConnected = async () => {
+  const { registry: registry2 } = await readRegistry();
+  return Boolean(registry2.watchers[CONTROL_WATCHER_ID]);
+};
+var openExtensionsPage = () => {
+  const chromeBin = resolveChromeBin();
+  if (!chromeBin) {
+    return false;
+  }
+  try {
+    const child = spawn3(chromeBin, ["chrome://extensions/"], { stdio: "ignore", detached: true });
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+};
+var 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 delay7(POLL_INTERVAL_MS);
+  }
+  return isControlConnected();
+};
+var 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("");
+};
+var 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("");
+};
+var parseTimeoutMs2 = (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;
+};
+var fail = (output, message) => {
+  if (output.json) {
+    output.writeJson({ success: false, error: { message } });
+  } else {
+    console.error(message);
+  }
+  process.exitCode = 1;
+};
+var delay7 = (ms3) => new Promise((resolve2) => setTimeout(resolve2, ms3));
+
 // dist/commands/extension/setup.js
 var runExtensionSetup = async (options) => {
   const output = createOutput(options);
-  const { extensionId } = options;
+  const extensionId = options.extensionId ?? ARGUS_EXTENSION_ID;
   let platform;
   try {
     platform = getPlatform();
@@ -49342,9 +49517,11 @@ var 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("");
   }
 };
 
@@ -49733,7 +49910,7 @@ var waitForTabWatcher = async (controlWatcher, selector, tab, watcherId) => {
       if (watcher) {
         const status = await fetchStatus(watcher);
         if (!status || !statusMatchesTabWatcher(status, latestTab ?? tab, latestTab?.watcherId === explicitWatcherId)) {
-          await delay7(WATCHER_POLL_INTERVAL_MS);
+          await delay8(WATCHER_POLL_INTERVAL_MS);
           continue;
         }
         return { ok: true, watcher, status, tab: latestTab ?? tab };
@@ -49743,7 +49920,7 @@ var waitForTabWatcher = async (controlWatcher, selector, tab, watcherId) => {
     if (lastResult.ok) {
       return lastResult;
     }
-    await delay7(WATCHER_POLL_INTERVAL_MS);
+    await delay8(WATCHER_POLL_INTERVAL_MS);
   }
   return lastResult;
 };
@@ -49797,7 +49974,7 @@ var targetMatchesTab = (target, tab) => {
   }
   return Boolean(target.title && target.title === tab.title && target.url === tab.url);
 };
-var delay7 = (ms3) => new Promise((resolve2) => setTimeout(resolve2, ms3));
+var delay8 = (ms3) => new Promise((resolve2) => setTimeout(resolve2, ms3));
 var formatError6 = (error) => error instanceof Error ? error.message : String(error);
 
 // dist/commands/extension/show.js
@@ -50176,19 +50353,19 @@ var waitForSelectedTarget = async (watcher, target, options = {}) => {
     const [status, targets] = await Promise.all([fetchWatcherStatus(watcher), fetchExtensionTargets(watcher)]);
     if (!status.ok) {
       lastError = status.error;
-      await delay8(intervalMs);
+      await delay9(intervalMs);
       continue;
     }
     if (!targets.ok) {
       lastError = targets.error;
-      await delay8(intervalMs);
+      await delay9(intervalMs);
       continue;
     }
     const selected = targets.targets.find((entry) => entry.id === target.id && entry.attached === true);
     if (selected && statusMatchesTarget(status.status, selected) && status.status.targetReady !== false) {
       return { ok: true, status: status.status, target: selected };
     }
-    await delay8(intervalMs);
+    await delay9(intervalMs);
   }
   return { ok: false, error: lastError };
 };
@@ -50334,7 +50511,7 @@ var originOf = (url) => {
   }
 };
 var shortenId = (id) => id.length > 18 ? `${id.slice(0, 14)}...` : id;
-var delay8 = (ms3) => new Promise((resolve2) => setTimeout(resolve2, ms3));
+var delay9 = (ms3) => new Promise((resolve2) => setTimeout(resolve2, ms3));
 var formatError8 = (error) => error instanceof Error ? error.message : String(error);
 
 // dist/commands/extension/use.js
@@ -50750,22 +50927,43 @@ var extensionCommands = [
     description: "Browser extension management",
     subcommands: [
       {
-        name: "setup <extensionId>",
-        description: "Install native messaging host for the browser extension",
+        name: "install",
+        description: "Set up the extension end-to-end: install hosts, open chrome://extensions, wait for connect",
+        options: [
+          { flags: "--no-open", description: "Do not open chrome://extensions automatically" },
+          { flags: "--no-wait", description: "Do not wait for the extension to connect" },
+          { flags: "--timeout <seconds>", description: "Seconds to wait for the extension to connect (default 120)" },
+          jsonOption2
+        ],
+        examples: ["argus extension install", "argus extension install --no-open", "argus extension install --no-wait --json"],
+        action: async (options) => {
+          await runExtensionInstall(options);
+        }
+      },
+      {
+        name: "setup [extensionId]",
+        description: "Install native messaging host (uses the pinned extension ID by default)",
         options: [jsonOption2],
         configure: (command) => {
           command.addHelpText("after", `
-To get your extension ID:
-  1. Open chrome://extensions
-  2. Enable Developer mode
-  3. Load argus-extension as unpacked
-  4. Copy the ID from the extension card
+The Argus extension pins a stable ID, so no argument is needed.
+Prefer \`argus extension install\` for the guided, end-to-end flow.
+Pass an explicit id only when loading a differently-keyed build.
 `);
         },
         action: async (extensionId, options) => {
           await runExtensionSetup({ extensionId, ...options });
         }
       },
+      {
+        name: "path",
+        description: 'Print the path to the unpacked extension for chrome://extensions "Load unpacked"',
+        options: [jsonOption2],
+        examples: ["argus extension path", "argus extension path --json"],
+        action: (options) => {
+          runExtensionPath(options);
+        }
+      },
       {
         name: "remove",
         description: "Uninstall native messaging host",
@@ -50923,9 +51121,9 @@ same sticky shown+focused lock as \`argus page show <watcherId>\`.
 ];
 
 // dist/commands/skill.js
-import fs18 from "node:fs";
-import path23 from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import fs19 from "node:fs";
+import path24 from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 var SKILL_PATH_PARTS = ["skill", "argus", "SKILL.md"];
 var runSkill = (options) => {
   const output = createOutput(options);
@@ -50950,18 +51148,18 @@ ${resolveArgusSkillCandidates().join(`
 };
 var resolveArgusSkillPath = () => {
   for (const candidate of resolveArgusSkillCandidates()) {
-    if (fs18.existsSync(candidate)) {
+    if (fs19.existsSync(candidate)) {
       return candidate;
     }
   }
   return null;
 };
 var resolveArgusSkillCandidates = () => {
-  const moduleDir = path23.dirname(fileURLToPath2(import.meta.url));
+  const moduleDir = path24.dirname(fileURLToPath3(import.meta.url));
   return [
-    path23.resolve(moduleDir, ...SKILL_PATH_PARTS),
-    path23.resolve(moduleDir, "..", ...SKILL_PATH_PARTS),
-    path23.resolve(moduleDir, "..", "..", "..", "..", ...SKILL_PATH_PARTS)
+    path24.resolve(moduleDir, ...SKILL_PATH_PARTS),
+    path24.resolve(moduleDir, "..", ...SKILL_PATH_PARTS),
+    path24.resolve(moduleDir, "..", "..", "..", "..", ...SKILL_PATH_PARTS)
   ];
 };
 

package/dist/cli/register/extensionCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extensionCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/register/extensionCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AA2DjE,eAAO,MAAM,iBAAiB,EAAE,SAAS,sBAAsB,EAwK9D,CAAA"}
+{"version":3,"file":"extensionCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/register/extensionCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AA6DjE,eAAO,MAAM,iBAAiB,EAAE,SAAS,sBAAsB,EA+L9D,CAAA"}

package/dist/cli/register/extensionCommands.js

@@ -1,4 +1,6 @@
+import { runExtensionInstall } from '../../commands/extension/install.js';
 import { runExtensionSetup } from '../../commands/extension/setup.js';
+import { runExtensionPath } from '../../commands/extension/extensionPath.js';
 import { runExtensionRemove } from '../../commands/extension/remove.js';
 import { runExtensionStatus } from '../../commands/extension/status.js';
 import { runExtensionInfo } from '../../commands/extension/info.js';
@@ -56,16 +58,39 @@ export const extensionCommands = [
         description: 'Browser extension management',
         subcommands: [
             {
-                name: 'setup <extensionId>',
-                description: 'Install native messaging host for the browser extension',
+                name: 'install',
+                description: 'Set up the extension end-to-end: install hosts, open chrome://extensions, wait for connect',
+                options: [
+                    { flags: '--no-open', description: 'Do not open chrome://extensions automatically' },
+                    { flags: '--no-wait', description: 'Do not wait for the extension to connect' },
+                    { flags: '--timeout <seconds>', description: 'Seconds to wait for the extension to connect (default 120)' },
+                    jsonOption,
+                ],
+                examples: ['argus extension install', 'argus extension install --no-open', 'argus extension install --no-wait --json'],
+                action: async (options) => {
+                    await runExtensionInstall(options);
+                },
+            },
+            {
+                name: 'setup [extensionId]',
+                description: 'Install native messaging host (uses the pinned extension ID by default)',
                 options: [jsonOption],
                 configure: (command) => {
-                    command.addHelpText('after', '\nTo get your extension ID:\n  1. Open chrome://extensions\n  2. Enable Developer mode\n  3. Load argus-extension as unpacked\n  4. Copy the ID from the extension card\n');
+                    command.addHelpText('after', '\nThe Argus extension pins a stable ID, so no argument is needed.\nPrefer `argus extension install` for the guided, end-to-end flow.\nPass an explicit id only when loading a differently-keyed build.\n');
                 },
                 action: async (extensionId, options) => {
                     await runExtensionSetup({ extensionId, ...options });
                 },
             },
+            {
+                name: 'path',
+                description: 'Print the path to the unpacked extension for chrome://extensions "Load unpacked"',
+                options: [jsonOption],
+                examples: ['argus extension path', 'argus extension path --json'],
+                action: (options) => {
+                    runExtensionPath(options);
+                },
+            },
             {
                 name: 'remove',
                 description: 'Uninstall native messaging host',

package/dist/cli/register/extensionCommands.js.map

@@ -1 +1 @@
-{"version":3,"file":"extensionCommands.js","sourceRoot":"","sources":["../../../src/cli/register/extensionCommands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AAEvE,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAW,CAAA;AAE1F,MAAM,gBAAgB,GAAG;IACxB,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE;IACzD,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,8BAA8B,EAAE;IAC3E,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,gCAAgC,EAAE;IAC/E,UAAU;CACD,CAAA;AAEV,MAAM,mBAAmB,GAAG;IAC3B,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE;IACzD,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,8BAA8B,EAAE;IAC3E,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,gCAAgC,EAAE;IAC/E,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,wCAAwC,EAAE;IACpF,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,4DAA4D,EAAE;IACjG,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;IAC/E,UAAU;CACD,CAAA;AAEV,MAAM,gBAAgB,GAAG;IACxB,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE;IACzD,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,8BAA8B,EAAE;IAC3E,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,gCAAgC,EAAE;IAC/E,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,uDAAuD,EAAE;IACnG,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,oDAAoD,EAAE;IAC/F,EAAE,KAAK,EAAE,0BAA0B,EAAE,WAAW,EAAE,gDAAgD,EAAE;IACpG,EAAE,KAAK,EAAE,4BAA4B,EAAE,WAAW,EAAE,kDAAkD,EAAE;IACxG,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;IAC3E,UAAU;CACD,CAAA;AAEV,MAAM,mBAAmB,GAAG;IAC3B,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;IAC9D,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,2CAA2C,EAAE;IACtF,EAAE,KAAK,EAAE,0BAA0B,EAAE,WAAW,EAAE,gCAAgC,EAAE;IACpF,EAAE,KAAK,EAAE,4BAA4B,EAAE,WAAW,EAAE,kCAAkC,EAAE;CAC/E,CAAA;AAEV,MAAM,iBAAiB,GAAG;IACzB,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE;IACzD,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,8BAA8B,EAAE;IAC3E,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,gCAAgC,EAAE;IAC/E,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,uDAAuD,EAAE;IACnG,UAAU;CACD,CAAA;AAEV,MAAM,CAAC,MAAM,iBAAiB,GAAsC;IACnE;QACC,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,8BAA8B;QAC3C,WAAW,EAAE;YACZ;gBACC,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EAAE,yDAAyD;gBACtE,OAAO,EAAE,CAAC,UAAU,CAAC;gBACrB,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;oBACtB,OAAO,CAAC,WAAW,CAClB,OAAO,EACP,2KAA2K,CAC3K,CAAA;gBACF,CAAC;gBACD,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;oBACtC,MAAM,iBAAiB,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;gBACrD,CAAC;aACD;YACD;gBACC,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;gBAC9C,OAAO,EAAE,CAAC,UAAU,CAAC;gBACrB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACzB,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAA;gBAClC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2CAA2C;gBACxD,OAAO,EAAE,CAAC,UAAU,CAAC;gBACrB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACzB,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAA;gBAClC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;gBACpE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,sDAAsD,EAAE,EAAE,UAAU,CAAC;gBAC9H,QAAQ,EAAE,CAAC,kBAAkB,EAAE,oCAAoC,EAAE,yBAAyB,CAAC;gBAC/F,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACzB,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAA;gBAClC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,oDAAoD;gBACjE,OAAO,EAAE,CAAC,UAAU,CAAC;gBACrB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACzB,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAA;gBAChC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,sDAAsD;gBACnE,OAAO,EAAE;oBACR,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,kFAAkF,EAAE;oBAC9H,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,8BAA8B,EAAE;oBAC3E,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,gCAAgC,EAAE;oBAC/E,UAAU;iBACV;gBACD,QAAQ,EAAE;oBACT,gBAAgB;oBAChB,gCAAgC;oBAChC,oCAAoC;oBACpC,iCAAiC;iBACjC;gBACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACzB,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAA;gBAChC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4DAA4D;gBACzE,OAAO,EAAE,mBAAmB;gBAC5B,QAAQ,EAAE;oBACT,4BAA4B;oBAC5B,2CAA2C;oBAC3C,yCAAyC;oBACzC,gDAAgD;iBAChD;gBACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACzB,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAA;gBAClC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,6DAA6D;gBAC1E,OAAO,EAAE,gBAAgB;gBACzB,QAAQ,EAAE;oBACT,wCAAwC;oBACxC,sEAAsE;oBACtE,2DAA2D;oBAC3D,mCAAmC;oBACnC,gCAAgC;iBAChC;gBACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACzB,MAAM,eAAe,CAAC,OAAO,CAAC,CAAA;gBAC/B,CAAC;aACD;YACD;gBACC,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,2DAA2D;gBACxE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAC;gBAC5E,OAAO,EAAE;oBACR,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE;oBACzD,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,8BAA8B,EAAE;oBAC3E,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,gCAAgC,EAAE;oBAC/E,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,oDAAoD,EAAE;oBAChG,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,6CAA6C,EAAE;oBACtF,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;oBACxE,UAAU;iBACV;gBACD,QAAQ,EAAE;oBACT,kCAAkC;oBAClC,iDAAiD;oBACjD,kDAAkD;iBAClD;gBACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;oBAC7B,MAAM,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;gBACvC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qEAAqE;gBAClF,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAC;gBAC5E,OAAO,EAAE;oBACR,GAAG,mBAAmB;oBACtB,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,2DAA2D,EAAE;oBAChG,UAAU;iBACV;gBACD,QAAQ,EAAE;oBACT,mDAAmD;oBACnD,uDAAuD;oBACvD,wCAAwC;oBACxC,iCAAiC;iBACjC;gBACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;oBAC7B,MAAM,kBAAkB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;gBACtC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;gBACxE,OAAO,EAAE,gBAAgB;gBACzB,QAAQ,EAAE,CAAC,4BAA4B,EAAE,kCAAkC,EAAE,sCAAsC,CAAC;gBACpH,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACzB,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAA;gBAClC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,8DAA8D;gBAC3E,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAC;gBAC5E,OAAO,EAAE,iBAAiB;gBAC1B,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;oBACtB,OAAO,CAAC,WAAW,CAClB,OAAO,EACP,oTAAoT,CACpT,CAAA;gBACF,CAAC;gBACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;oBAC7B,MAAM,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;gBACpC,CAAC;aACD;SACD;KACD;CACD,CAAA"}
+{"version":3,"file":"extensionCommands.js","sourceRoot":"","sources":["../../../src/cli/register/extensionCommands.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,27 @@
+/**
+ * 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 declare const ARGUS_EXTENSION_ID = "ibhecpfiodfmkpflcnnkkgnjifheefhb";
+/** Base64 SPKI public key pinned as the extension manifest `key` field. */
+export declare 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 declare const deriveExtensionId: (publicKeyBase64: string) => string;
+//# sourceMappingURL=extensionId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extensionId.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/extensionId.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,qCAAqC,CAAA;AAEpE,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,6YACoW,CAAA;AAE3Y;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,iBAAiB,MAAM,KAAG,MAS3D,CAAA"}