chrome-relay 0.5.8 → 0.5.9

package/dist/cli.js

@@ -2,16 +2,9 @@
 
 // src/program.ts
 import { Command } from "commander";
-import { writeFileSync } from "fs";
 
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.5.8" : "0.0.0-dev";
-
-// src/install/install.ts
-import os from "os";
-import path from "path";
-import { chmod, mkdir, readFile, stat, writeFile } from "fs/promises";
-import { fileURLToPath } from "url";
+var CHROME_RELAY_VERSION = true ? "0.5.9" : "0.0.0-dev";
 
 // ../protocol/dist/index.js
 var NATIVE_HOST_NAME = "dev.chrome_relay.native_host";
@@ -51,7 +44,128 @@ var RelayError = class extends Error {
   }
 };
 
+// src/client/call.ts
+var noticePrinted = false;
+function emitNoticeOnce(notice) {
+  if (noticePrinted) return;
+  noticePrinted = true;
+  process.stderr.write(`[chrome-relay] ${notice}
+`);
+}
+async function callToolWithMeta(name, args) {
+  const response = await fetch(`http://127.0.0.1:${DEFAULT_HTTP_PORT}/call`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      name,
+      args
+    })
+  });
+  const payload = await response.json().catch(() => null);
+  const noticeString = payload?.notice ?? payload?.notices?.[0]?.message;
+  if (!response.ok) {
+    if (noticeString) emitNoticeOnce(noticeString);
+    throw rebuildError(payload, `Bridge request failed with ${response.status}`);
+  }
+  if (!payload?.ok) {
+    if (noticeString) emitNoticeOnce(noticeString);
+    throw rebuildError(payload, "Bridge call failed.");
+  }
+  if (noticeString) emitNoticeOnce(noticeString);
+  return { data: payload.data, notice: payload.notice, notices: payload.notices };
+}
+function rebuildError(payload, fallbackMessage) {
+  if (payload?.errorDetails) {
+    return new RelayError(payload.errorDetails);
+  }
+  return new Error(payload?.error || fallbackMessage);
+}
+async function callTool(name, args) {
+  const { data } = await callToolWithMeta(name, args);
+  return data;
+}
+
+// src/commands/shared.ts
+function tabOpt(cmd) {
+  return cmd.option("-t, --tab <id>", "target tab ID", (v) => Number(v)).option("--workspace <name>", "target the active tab in a named workspace window (see `chrome-relay workspace`)").option("--group <name>", "target the active tab in a named tab-group (see `chrome-relay group`)");
+}
+function makeBaseArgs(program) {
+  return function baseArgs(opts) {
+    const parentOpts = program.opts();
+    rejectIntraScopeConflict("subcommand", {
+      tab: opts.tab,
+      workspace: opts.workspace,
+      group: opts.group
+    });
+    rejectIntraScopeConflict("program-level", {
+      workspace: parentOpts.workspace,
+      group: parentOpts.group
+    });
+    if (opts.workspace && parentOpts.workspace && opts.workspace !== parentOpts.workspace) {
+      emitTargetOverride("workspace", parentOpts.workspace, opts.workspace);
+    }
+    if (opts.group && parentOpts.group && opts.group !== parentOpts.group) {
+      emitTargetOverride("group", parentOpts.group, opts.group);
+    }
+    if (opts.tab !== void 0 && (parentOpts.workspace || parentOpts.group)) {
+      const prior = parentOpts.workspace ? `workspace=${parentOpts.workspace}` : `group=${parentOpts.group}`;
+      emitTargetOverride("tab", prior, String(opts.tab));
+    }
+    const args = {};
+    if (opts.tab !== void 0) args.tabId = opts.tab;
+    const effectiveWorkspace = opts.workspace ?? parentOpts.workspace;
+    const effectiveGroup = opts.group ?? parentOpts.group;
+    if (opts.tab === void 0 && effectiveWorkspace) args.workspaceName = effectiveWorkspace;
+    if (opts.tab === void 0 && effectiveGroup) args.groupName = effectiveGroup;
+    return args;
+  };
+}
+function rejectIntraScopeConflict(scope, fields) {
+  const present = [];
+  if (fields.tab !== void 0) present.push("--tab");
+  if (fields.workspace) present.push("--workspace");
+  if (fields.group) present.push("--group");
+  if (present.length > 1) {
+    process.stderr.write(
+      `[chrome-relay] target_conflict: ${scope} flags ${present.join(" + ")} are mutually exclusive. Pass exactly one of --tab, --workspace, or --group on the same ${scope}.
+`
+    );
+    process.exit(2);
+  }
+}
+function emitTargetOverride(kind, from, to) {
+  process.stderr.write(
+    `[chrome-relay] target_overridden: ${kind} ${from} \u2192 ${to} (subcommand-level overrides program-level)
+`
+  );
+}
+async function runToolImpl(name, args) {
+  try {
+    const result = await callTool(name, args);
+    if (typeof result === "string") {
+      process.stdout.write(result + "\n");
+    } else {
+      process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+    }
+  } catch (error) {
+    if (error instanceof RelayError) {
+      process.stderr.write(error.message + "\n");
+      process.stderr.write(JSON.stringify({ relayError: error.toBridgeError() }, null, 2) + "\n");
+    } else {
+      process.stderr.write(
+        (error instanceof Error ? error.message : String(error)) + "\n"
+      );
+    }
+    process.exit(1);
+  }
+}
+var runTool = runToolImpl;
+
 // src/install/install.ts
+import os from "os";
+import path from "path";
+import { chmod, mkdir, readFile, stat, writeFile } from "fs/promises";
+import { fileURLToPath } from "url";
 var APP_DIR = path.join(os.homedir(), ".chrome-relay");
 var KNOWN_EXTENSION_IDS = [
   ["Chrome Web Store", CHROME_WEB_STORE_EXTENSION_ID],
@@ -155,49 +269,14 @@ async function runDoctor() {
   }
 }
 
-// src/client/call.ts
-var noticePrinted = false;
-function emitNoticeOnce(notice) {
-  if (noticePrinted) return;
-  noticePrinted = true;
-  process.stderr.write(`[chrome-relay] ${notice}
-`);
-}
-async function callToolWithMeta(name, args) {
-  const response = await fetch(`http://127.0.0.1:${DEFAULT_HTTP_PORT}/call`, {
-    method: "POST",
-    headers: { "content-type": "application/json" },
-    body: JSON.stringify({
-      name,
-      args
-    })
-  });
-  const payload = await response.json().catch(() => null);
-  const noticeString = payload?.notice ?? payload?.notices?.[0]?.message;
-  if (!response.ok) {
-    if (noticeString) emitNoticeOnce(noticeString);
-    throw rebuildError(payload, `Bridge request failed with ${response.status}`);
-  }
-  if (!payload?.ok) {
-    if (noticeString) emitNoticeOnce(noticeString);
-    throw rebuildError(payload, "Bridge call failed.");
-  }
-  if (noticeString) emitNoticeOnce(noticeString);
-  return { data: payload.data, notice: payload.notice, notices: payload.notices };
-}
-function rebuildError(payload, fallbackMessage) {
-  if (payload?.errorDetails) {
-    return new RelayError(payload.errorDetails);
-  }
-  return new Error(payload?.error || fallbackMessage);
-}
-async function callTool(name, args) {
-  const { data } = await callToolWithMeta(name, args);
-  return data;
-}
-
 // src/release-notes.ts
 var RELEASE_NOTES = {
+  "0.5.9": [
+    "Internal refactor (code-quality-hardening PR 7): program.ts and tools.ts split into per-domain modules. Pure code motion, no behavior change.",
+    "CLI: packages/cli/src/program.ts shrank from 1041 \u2192 75 lines. Per-domain modules now live in packages/cli/src/commands/{install-update,navigation,input,capture,sessions}.ts.",
+    "Extension: apps/extension/src/browser/tools.ts shrank from 891 \u2192 34 lines. Per-domain handler modules live in apps/extension/src/browser/handlers/{target,navigation,input,capture,sessions}.ts.",
+    "All 355 tests still pass without modification \u2014 the dispatcher contract (runTool name dispatch) is unchanged."
+  ],
   "0.5.8": [
     "Internal refactor (code-quality-hardening PR 6, first cut): shared CLI helpers moved out of program.ts into packages/cli/src/commands/shared.ts.",
     "tabOpt(), makeBaseArgs(program), and runTool() are now importable from `./commands/shared.js`. program.ts dropped ~100 lines.",
@@ -273,104 +352,8 @@ function listReleaseNotesSince(since) {
   return Object.keys(RELEASE_NOTES).filter((v) => compareSemver(v, since) > 0).sort((a, b) => compareSemver(a, b)).map((version) => ({ version, bullets: RELEASE_NOTES[version] }));
 }
 
-// src/commands/shared.ts
-function tabOpt(cmd) {
-  return cmd.option("-t, --tab <id>", "target tab ID", (v) => Number(v)).option("--workspace <name>", "target the active tab in a named workspace window (see `chrome-relay workspace`)").option("--group <name>", "target the active tab in a named tab-group (see `chrome-relay group`)");
-}
-function makeBaseArgs(program) {
-  return function baseArgs(opts) {
-    const parentOpts = program.opts();
-    rejectIntraScopeConflict("subcommand", {
-      tab: opts.tab,
-      workspace: opts.workspace,
-      group: opts.group
-    });
-    rejectIntraScopeConflict("program-level", {
-      workspace: parentOpts.workspace,
-      group: parentOpts.group
-    });
-    if (opts.workspace && parentOpts.workspace && opts.workspace !== parentOpts.workspace) {
-      emitTargetOverride("workspace", parentOpts.workspace, opts.workspace);
-    }
-    if (opts.group && parentOpts.group && opts.group !== parentOpts.group) {
-      emitTargetOverride("group", parentOpts.group, opts.group);
-    }
-    if (opts.tab !== void 0 && (parentOpts.workspace || parentOpts.group)) {
-      const prior = parentOpts.workspace ? `workspace=${parentOpts.workspace}` : `group=${parentOpts.group}`;
-      emitTargetOverride("tab", prior, String(opts.tab));
-    }
-    const args = {};
-    if (opts.tab !== void 0) args.tabId = opts.tab;
-    const effectiveWorkspace = opts.workspace ?? parentOpts.workspace;
-    const effectiveGroup = opts.group ?? parentOpts.group;
-    if (opts.tab === void 0 && effectiveWorkspace) args.workspaceName = effectiveWorkspace;
-    if (opts.tab === void 0 && effectiveGroup) args.groupName = effectiveGroup;
-    return args;
-  };
-}
-function rejectIntraScopeConflict(scope, fields) {
-  const present = [];
-  if (fields.tab !== void 0) present.push("--tab");
-  if (fields.workspace) present.push("--workspace");
-  if (fields.group) present.push("--group");
-  if (present.length > 1) {
-    process.stderr.write(
-      `[chrome-relay] target_conflict: ${scope} flags ${present.join(" + ")} are mutually exclusive. Pass exactly one of --tab, --workspace, or --group on the same ${scope}.
-`
-    );
-    process.exit(2);
-  }
-}
-function emitTargetOverride(kind, from, to) {
-  process.stderr.write(
-    `[chrome-relay] target_overridden: ${kind} ${from} \u2192 ${to} (subcommand-level overrides program-level)
-`
-  );
-}
-async function runTool(name, args) {
-  try {
-    const result = await callTool(name, args);
-    if (typeof result === "string") {
-      process.stdout.write(result + "\n");
-    } else {
-      process.stdout.write(JSON.stringify(result, null, 2) + "\n");
-    }
-  } catch (error) {
-    if (error instanceof RelayError) {
-      process.stderr.write(error.message + "\n");
-      process.stderr.write(JSON.stringify({ relayError: error.toBridgeError() }, null, 2) + "\n");
-    } else {
-      process.stderr.write(
-        (error instanceof Error ? error.message : String(error)) + "\n"
-      );
-    }
-    process.exit(1);
-  }
-}
-
-// src/program.ts
-function buildProgram() {
-  const program = new Command();
-  program.name("chrome-relay").description("Connect your local Chrome browser to coding agents through a local bridge.").version(CHROME_RELAY_VERSION).showHelpAfterError().option("--workspace <name>", "target the active tab in a named workspace window (works at top level too)").option("--group <name>", "target the active tab in a named tab-group (works at top level too)").enablePositionalOptions().addHelpText(
-    "after",
-    `
-
-Common agent flow:
-  chrome-relay tabs
-  chrome-relay navigate --tab <tabId> "https://example.com"
-  chrome-relay read --tab <tabId> -i
-  chrome-relay click --tab <tabId> "<selector>"
-  chrome-relay fill --tab <tabId> "<selector>" "value"
-  chrome-relay type --tab <tabId> -s "<selector>" "text into rich editor"
-  chrome-relay keys --tab <tabId> Enter
-  chrome-relay js --tab <tabId> "return document.title"
-  chrome-relay screenshot --tab <tabId> -o evidence.png
-
-Notes:
-  navigate takes a URL. Use --tab to target an existing tab.
-  Tools attach via CDP and run on backgrounded tabs without stealing focus.
-`
-  );
+// src/commands/install-update.ts
+function registerInstallUpdate(program) {
   program.command("install").description("Install and register the local Chrome Relay host.").action(async () => {
     await runInstall();
   });
@@ -459,8 +442,11 @@ Notes:
       changes
     }, null, 2) + "\n");
   });
-  const run = runTool;
-  const baseArgs = makeBaseArgs(program);
+}
+
+// src/commands/navigation.ts
+function registerNavigation(ctx) {
+  const { program, baseArgs, run } = ctx;
   program.command("tabs [verb]").description("List open Chrome windows and tabs. (verb 'list' is accepted as alias)").action(async (verb) => {
     if (verb && verb !== "list") {
       process.stderr.write(`unknown tabs verb: ${verb}. Use 'tabs' or 'tabs list'.
@@ -495,59 +481,21 @@ Use "chrome-relay switch ${url}" to activate that tab, or "chrome-relay navigate
     if (opts.inactive) args.active = false;
     await run("chrome_navigate", args);
   });
-  tabOpt(
-    program.command("screenshot").description("Capture a screenshot of any tab without activating it.").option("--full", "capture beyond the viewport (full page)").option("--bbox <rect>", "capture a region: 'x,y,width,height' (pixels)").option("--selector <css>", "capture the bounding box of a CSS selector").option("--padding <px>", "pixels of padding around --selector region", (v) => Number(v)).option("--max-edge <px>", "downscale so longer edge \u2264 this many pixels (no default; opt-in)", (v) => Number(v)).option("-o, --out <path>", "save image to path (base64 PNG decoded)").addHelpText(
-      "after",
-      `
-
-Examples:
-  chrome-relay screenshot -o active-tab.png
-  chrome-relay screenshot --tab 123456789 -o evidence.png
-  chrome-relay screenshot --tab 123456789 --full -o full-page.png
-  chrome-relay screenshot --tab 123456789 --bbox 0,0,1280,80 -o header.png
-  chrome-relay screenshot --tab 123456789 --selector "header" -o header.png
-  chrome-relay screenshot --tab 123456789 --selector ".card:nth-child(3)" --padding 8 -o card.png
-
-Region screenshots (--bbox / --selector) are ~10x cheaper in tokens than a
-full-tab screenshot when an agent only needs to see one component.
-`
-    )
-  ).action(async (opts) => {
-    const args = {};
-    Object.assign(args, baseArgs(opts));
-    if (opts.full) args.fullPage = true;
-    if (opts.bbox) args.bbox = opts.bbox;
-    if (opts.selector) args.selector = opts.selector;
-    if (typeof opts.padding === "number") args.padding = opts.padding;
-    if (typeof opts.maxEdge === "number") args.maxEdge = opts.maxEdge;
-    try {
-      const result = await callTool("chrome_screenshot", args);
-      if (opts.out && result && typeof result === "object") {
-        const data = result.dataUrl ?? result.data;
-        if (typeof data === "string") {
-          const b64 = data.includes(",") ? data.split(",")[1] : data;
-          writeFileSync(opts.out, Buffer.from(b64, "base64"));
-          process.stdout.write(`Saved screenshot to ${opts.out}
-`);
-          return;
-        }
-      }
-      process.stdout.write(JSON.stringify(result, null, 2) + "\n");
-    } catch (error) {
-      process.stderr.write(
-        (error instanceof Error ? error.message : String(error)) + "\n"
-      );
-      process.exit(1);
-    }
+  program.command("switch <tabId>").description("Activate a tab by ID.").action(async (tabId) => {
+    await run("chrome_switch_tab", { tabId: Number(tabId) });
   });
-  tabOpt(
-    program.command("read").description("Extract page structure and interactive elements.").option("-i, --interactive", "return only interactive elements")
-  ).action(async (opts) => {
-    const args = {};
-    Object.assign(args, baseArgs(opts));
-    if (opts.interactive) args.interactiveOnly = true;
-    await run("chrome_read_page", args);
+  program.command("close <tabIds...>").description("Close one or more tabs by ID.").action(async (tabIds) => {
+    await run("chrome_close_tabs", { tabIds: tabIds.map(Number) });
+  });
+  program.command("call <tool> [json]").description("Call any Chrome Relay tool with raw JSON args.").action(async (tool, json) => {
+    const args = json ? JSON.parse(json) : {};
+    await run(tool, args);
   });
+}
+
+// src/commands/input.ts
+function registerInput(ctx) {
+  const { program, baseArgs, run } = ctx;
   tabOpt(
     program.command("click <selector>").description("Click an element by CSS selector.")
   ).action(async (selector, opts) => {
@@ -625,63 +573,87 @@ Notes:
     if (typeof opts.timeoutMs === "number") args.timeoutMs = opts.timeoutMs;
     await run("chrome_evaluate", args);
   });
-  program.command("switch <tabId>").description("Activate a tab by ID.").action(async (tabId) => {
-    await run("chrome_switch_tab", { tabId: Number(tabId) });
-  });
-  program.command("close <tabIds...>").description("Close one or more tabs by ID.").action(async (tabIds) => {
-    await run("chrome_close_tabs", { tabIds: tabIds.map(Number) });
-  });
-  program.command("call <tool> [json]").description("Call any Chrome Relay tool with raw JSON args.").action(async (tool, json) => {
-    const args = json ? JSON.parse(json) : {};
-    await run(tool, args);
-  });
-  const viewport = program.command("viewport").description("Emulate device viewport, DPR, mobile flag, touch, and user agent.").addHelpText(
-    "after",
-    `
+  tabOpt(
+    program.command("hover [selector]").description("Move the pointer over an element or coordinates. Fires :hover styles.").option("--x <px>", "explicit x coordinate (CSS pixels)", (v) => Number(v)).option("--y <px>", "explicit y coordinate (CSS pixels)", (v) => Number(v)).addHelpText(
+      "after",
+      `
 
 Examples:
-  chrome-relay viewport preset iphone-14 --tab 123
-  chrome-relay viewport preset desktop-1440 --tab 123
-  chrome-relay viewport set --tab 123 --width 414 --height 896 --mobile --dpr 3
-  chrome-relay viewport clear --tab 123
-  chrome-relay viewport list
+  chrome-relay hover --tab 123 'button[title="Install runner"]'
+  chrome-relay hover --tab 123 --x 1327 --y 771
 
-Notes:
-  The override survives navigations within the tab but is wiped when the
-  debugger detaches (e.g. another extension takes over). Closing the tab
-  clears it. Re-run after detach if the page snaps back to its default size.
+Use before screencast to capture hover-driven micro-states (button glow,
+tooltip appearance, etc.) that a bare click would skip past too quickly.
 `
-  );
-  tabOpt(
-    viewport.command("set").description("Apply explicit viewport dimensions.").requiredOption("--width <px>", "viewport width in CSS pixels", (v) => Number(v)).requiredOption("--height <px>", "viewport height in CSS pixels", (v) => Number(v)).option("--dpr <ratio>", "device pixel ratio (1, 2, 3...)", (v) => Number(v)).option("--mobile", "set the mobile flag (affects meta viewport interpretation)").option("--touch", "enable touch event emulation").option("--user-agent <ua>", "override the User-Agent header")
-  ).action(async (opts) => {
-    const args = { action: "set", width: opts.width, height: opts.height };
+    )
+  ).action(async (selector, opts) => {
+    const args = {};
     Object.assign(args, baseArgs(opts));
-    if (opts.dpr !== void 0) args.dpr = opts.dpr;
-    if (opts.mobile) args.mobile = true;
-    if (opts.touch) args.hasTouch = true;
-    if (opts.userAgent) args.userAgent = opts.userAgent;
-    await run("chrome_viewport", args);
+    if (selector) args.selector = selector;
+    if (typeof opts.x === "number" && typeof opts.y === "number") {
+      args.x = opts.x;
+      args.y = opts.y;
+    }
+    await run("chrome_hover", args);
   });
+}
+
+// src/commands/capture.ts
+import { writeFileSync } from "fs";
+function registerCapture(ctx) {
+  const { program, baseArgs, run } = ctx;
   tabOpt(
-    viewport.command("preset <name>").description("Apply a named device preset (iphone-14, pixel-7, desktop-1440, etc).")
-  ).action(async (name, opts) => {
-    const args = { action: "preset", name };
+    program.command("screenshot").description("Capture a screenshot of any tab without activating it.").option("--full", "capture beyond the viewport (full page)").option("--bbox <rect>", "capture a region: 'x,y,width,height' (pixels)").option("--selector <css>", "capture the bounding box of a CSS selector").option("--padding <px>", "pixels of padding around --selector region", (v) => Number(v)).option("--max-edge <px>", "downscale so longer edge \u2264 this many pixels (no default; opt-in)", (v) => Number(v)).option("-o, --out <path>", "save image to path (base64 PNG decoded)").addHelpText(
+      "after",
+      `
+
+Examples:
+  chrome-relay screenshot -o active-tab.png
+  chrome-relay screenshot --tab 123456789 -o evidence.png
+  chrome-relay screenshot --tab 123456789 --full -o full-page.png
+  chrome-relay screenshot --tab 123456789 --bbox 0,0,1280,80 -o header.png
+  chrome-relay screenshot --tab 123456789 --selector "header" -o header.png
+  chrome-relay screenshot --tab 123456789 --selector ".card:nth-child(3)" --padding 8 -o card.png
+
+Region screenshots (--bbox / --selector) are ~10x cheaper in tokens than a
+full-tab screenshot when an agent only needs to see one component.
+`
+    )
+  ).action(async (opts) => {
+    const args = {};
     Object.assign(args, baseArgs(opts));
-    await run("chrome_viewport", args);
+    if (opts.full) args.fullPage = true;
+    if (opts.bbox) args.bbox = opts.bbox;
+    if (opts.selector) args.selector = opts.selector;
+    if (typeof opts.padding === "number") args.padding = opts.padding;
+    if (typeof opts.maxEdge === "number") args.maxEdge = opts.maxEdge;
+    try {
+      const result = await callTool("chrome_screenshot", args);
+      if (opts.out && result && typeof result === "object") {
+        const data = result.dataUrl ?? result.data;
+        if (typeof data === "string") {
+          const b64 = data.includes(",") ? data.split(",")[1] : data;
+          writeFileSync(opts.out, Buffer.from(b64, "base64"));
+          process.stdout.write(`Saved screenshot to ${opts.out}
+`);
+          return;
+        }
+      }
+      process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+    } catch (error) {
+      process.stderr.write(
+        (error instanceof Error ? error.message : String(error)) + "\n"
+      );
+      process.exit(1);
+    }
   });
   tabOpt(
-    viewport.command("clear").description("Drop the viewport override and return the tab to its native size.")
+    program.command("read").description("Extract page structure and interactive elements.").option("-i, --interactive", "return only interactive elements")
   ).action(async (opts) => {
-    const args = { action: "clear" };
+    const args = {};
     Object.assign(args, baseArgs(opts));
-    await run("chrome_viewport", args);
-  });
-  viewport.command("list").description("List available presets.").action(async () => {
-    await run("chrome_viewport", { action: "list" });
-  });
-  program.command("self-reload").description("Restart the chrome-relay extension's service worker (picks up newly built code).").action(async () => {
-    await run("chrome_self_reload", {});
+    if (opts.interactive) args.interactiveOnly = true;
+    await run("chrome_read_page", args);
   });
   tabOpt(
     program.command("ax").description("Extract the accessibility tree \u2014 ~30\xD7 smaller than `read` and more semantic.").option("-i, --interactive-only", "filter to actionable roles (button, link, textbox, ...)").option("--root <role>", "start from the first node matching this role (e.g. 'main')").option("--include-subframes", "walk subframes too (default: top frame only)").addHelpText(
@@ -723,67 +695,273 @@ Notes:
     args.node = opts.node;
     await run("chrome_click_ax", args);
   });
-  const workspace = program.command("workspace").description("Manage named Chrome windows so multiple agents can drive separate windows.").addHelpText(
+  const screencast = program.command("screencast").description("Record a tab via CDP (paint-driven). Requires an active tab.").addHelpText(
     "after",
     `
 
 Examples:
-  chrome-relay workspace create bidsmith-h01 --url https://reddit.com
-  chrome-relay workspace list
-  chrome-relay --workspace bidsmith-h01 navigate https://news.ycombinator.com
-  chrome-relay --workspace bidsmith-h01 screenshot -o evidence.png
-  chrome-relay workspace close bidsmith-h01
-
-Notes:
-  Hard lifecycle: if you manually close the workspace's window, the next
-  --workspace operation fails loudly until you run \`workspace close\` +
-  \`workspace create\` again.
-  Precedence on a single command: --tab > --group > --workspace.
-`
-  );
-  workspace.command("create <name>").description("Open a new Chrome window and bind it to <name>.").option("--url <url>", "initial URL (default about:blank)").option("--label <label>", "human-readable description shown in popup/list").action(async (name, opts) => {
-    const args = { action: "create", name };
-    if (opts.url) args.url = opts.url;
-    if (opts.label) args.label = opts.label;
-    await run("chrome_workspace", args);
-  });
-  workspace.command("list").description("List all known workspaces + whether their window is still alive.").action(async () => {
-    await run("chrome_workspace", { action: "list" });
-  });
-  workspace.command("close <name>").description("Close the workspace's window (if alive) and remove the binding.").action(async (name) => {
-    await run("chrome_workspace", { action: "close", name });
-  });
-  const group = program.command("group").description("Manage Chrome tab-groups (the colored, collapsible folders inside one window).").addHelpText(
-    "after",
-    `
+  chrome-relay screencast start --tab 123 --quality 80 --max-width 900
+  # ... drive the interaction (hover, click, etc.) ...
+  chrome-relay screencast stop --tab 123 --out /tmp/recording
 
-Examples:
-  chrome-relay group create research --tabs 123,456,789 --color cyan
-  chrome-relay group list
-  chrome-relay group add research --tabs 1011
-  chrome-relay group remove --tabs 456
-  chrome-relay --group research navigate https://news.ycombinator.com
-  chrome-relay group close research
+  # The --out path becomes a directory of frame_NNNN.jpg files. If ffmpeg
+  # is on PATH and --gif is also passed, an animated GIF is written next to
+  # the frames at /tmp/recording.gif.
 
 Notes:
-  Tab-groups live inside ONE Chrome window. To open in a specific window,
-  pass --workspace W on \`group create\` (we'll route the underlying
-  chrome.tabs.group call there).
-  \`--group X navigate --new\` opens the new tab into the group's window AND
-  drops it inside the group.
-  Auto-pruned when the group's last tab is ungrouped or its window closes.
-  Colors: grey, blue, red, yellow, green, pink, purple, cyan, orange.
+  Frames buffer in the extension service worker. A 10-second capture at
+  default settings (jpeg q=60, ~15fps, full viewport) lands ~2-3 MB.
+  Pass --max-width to downscale and lighten the buffer.
+  Each frame is base64 JPEG; the CLI decodes them when --out is given.
 `
   );
-  group.command("create <name>").description("Group existing tabs into a new tab-group bound to <name>.").requiredOption("--tabs <ids>", "comma-separated tab IDs to group, e.g. 123,456,789").option("--color <color>", "grey | blue | red | yellow | green | pink | purple | cyan | orange").option("--collapsed", "create the group in its collapsed state").action(async (name, opts) => {
-    const args = { action: "create", name };
-    args.tabIds = String(opts.tabs).split(",").map((s) => Number(s.trim())).filter(Number.isFinite);
-    if (opts.color) args.color = opts.color;
-    if (opts.collapsed) args.collapsed = true;
-    await run("chrome_group", args);
+  tabOpt(
+    screencast.command("start").description("Begin screencast capture on a tab.").option("--format <fmt>", "jpeg | png (default jpeg)").option("--quality <n>", "jpeg quality 0-100 (default 80)", (v) => Number(v)).option("--max-width <px>", "downscale; aspect preserved", (v) => Number(v)).option("--max-height <px>", "downscale; aspect preserved", (v) => Number(v)).option("--every-nth <n>", "throttle: keep 1 in N frames (default 1)", (v) => Number(v))
+  ).action(async (opts) => {
+    const args = { action: "start" };
+    Object.assign(args, baseArgs(opts));
+    if (opts.format) args.format = opts.format;
+    if (typeof opts.quality === "number") args.quality = opts.quality;
+    if (typeof opts.maxWidth === "number") args.maxWidth = opts.maxWidth;
+    if (typeof opts.maxHeight === "number") args.maxHeight = opts.maxHeight;
+    if (typeof opts.everyNth === "number") args.everyNthFrame = opts.everyNth;
+    await run("chrome_screencast", args);
   });
-  group.command("list").description("List all known tab-groups + their window/color/tabCount.").action(async () => {
-    await run("chrome_group", { action: "list" });
+  tabOpt(
+    screencast.command("stop").description("Stop the screencast and emit frames (or write to disk).").option("-o, --out <dir>", "write frames as JPEGs into this directory (created if missing)").option("--gif", "after writing frames, ffmpeg them into <dir>.gif").option("--mp4", "after writing frames, ffmpeg them into <dir>.mp4").option("--fps <n>", "assumed framerate when invoking ffmpeg (default 15)", (v) => Number(v)).option("--no-dedupe", "keep raw frames; default collapses consecutive identical frames via SHA-256")
+  ).action(async (opts) => {
+    const args = { action: "stop" };
+    Object.assign(args, baseArgs(opts));
+    try {
+      const result = await callTool("chrome_screencast", args);
+      if (!opts.out) {
+        const { frames, ...summary } = result;
+        process.stdout.write(JSON.stringify({ ...summary, framesOmitted: frames.length, hint: "pass --out <dir> to save" }, null, 2) + "\n");
+        return;
+      }
+      const { mkdirSync, writeFileSync: wf, renameSync, unlinkSync } = await import("fs");
+      const path2 = await import("path");
+      const { createHash } = await import("crypto");
+      mkdirSync(opts.out, { recursive: true });
+      result.frames.forEach((f, i) => {
+        const name = `frame_${String(i + 1).padStart(4, "0")}.jpg`;
+        wf(path2.join(opts.out, name), Buffer.from(f.data, "base64"));
+      });
+      process.stdout.write(`Wrote ${result.frames.length} frames to ${opts.out}
+`);
+      const dedupeOn = opts.dedupe !== false;
+      if (dedupeOn && result.frames.length > 1) {
+        const hashes = result.frames.map(
+          (f) => createHash("sha256").update(Buffer.from(f.data, "base64")).digest("hex")
+        );
+        const kept = [];
+        let prev = "";
+        hashes.forEach((h, i) => {
+          if (h !== prev) kept.push(i);
+          prev = h;
+        });
+        const dropped = result.frames.length - kept.length;
+        if (dropped > 0) {
+          for (let i = 0; i < result.frames.length; i++) {
+            const src = path2.join(opts.out, `frame_${String(i + 1).padStart(4, "0")}.jpg`);
+            try {
+              unlinkSync(src);
+            } catch {
+            }
+          }
+          kept.forEach((srcIdx, newIdx) => {
+            const tmp = path2.join(opts.out, `tmp_${String(newIdx + 1).padStart(4, "0")}.jpg`);
+            wf(tmp, Buffer.from(result.frames[srcIdx].data, "base64"));
+          });
+          kept.forEach((_, newIdx) => {
+            const tmp = path2.join(opts.out, `tmp_${String(newIdx + 1).padStart(4, "0")}.jpg`);
+            const final = path2.join(opts.out, `frame_${String(newIdx + 1).padStart(4, "0")}.jpg`);
+            renameSync(tmp, final);
+          });
+          process.stdout.write(`Deduped: dropped ${dropped} identical frames, ${kept.length} remain.
+`);
+        } else {
+          process.stdout.write(`Deduped: no consecutive duplicates found.
+`);
+        }
+      }
+      if (opts.gif || opts.mp4) {
+        const fps = typeof opts.fps === "number" ? opts.fps : 15;
+        const { spawnSync } = await import("child_process");
+        const which = spawnSync("which", ["ffmpeg"]);
+        if (which.status !== 0) {
+          process.stderr.write("[chrome-relay] ffmpeg not on PATH \u2014 skipping --gif/--mp4.\n");
+          return;
+        }
+        if (opts.gif) {
+          const gifOut = `${opts.out.replace(/\/$/, "")}.gif`;
+          const r = spawnSync("ffmpeg", [
+            "-y",
+            "-framerate",
+            String(fps),
+            "-i",
+            path2.join(opts.out, "frame_%04d.jpg"),
+            "-vf",
+            `fps=${fps},split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse`,
+            "-loop",
+            "0",
+            gifOut
+          ], { stdio: "inherit" });
+          if (r.status === 0) process.stdout.write(`Wrote ${gifOut}
+`);
+        }
+        if (opts.mp4) {
+          const mp4Out = `${opts.out.replace(/\/$/, "")}.mp4`;
+          const r = spawnSync("ffmpeg", [
+            "-y",
+            "-framerate",
+            String(fps),
+            "-i",
+            path2.join(opts.out, "frame_%04d.jpg"),
+            "-c:v",
+            "libx264",
+            "-pix_fmt",
+            "yuv420p",
+            "-crf",
+            "20",
+            mp4Out
+          ], { stdio: "inherit" });
+          if (r.status === 0) process.stdout.write(`Wrote ${mp4Out}
+`);
+        }
+      }
+    } catch (error) {
+      process.stderr.write(
+        (error instanceof Error ? error.message : String(error)) + "\n"
+      );
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/sessions.ts
+function netFilterOpts(cmd) {
+  return cmd.option("--filter <substr>", "url substring filter").option("--status <bucket>", "ok | redirect | client_error | server_error | failed").option("--method <verb>", "exact method, e.g. POST").option("--limit <n>", "cap response length", (v) => Number(v));
+}
+function netFilterArgs(opts) {
+  const a = {};
+  if (opts.filter) a.filter = opts.filter;
+  if (opts.status) a.status = opts.status;
+  if (opts.method) a.method = opts.method;
+  if (typeof opts.limit === "number") a.limit = opts.limit;
+  return a;
+}
+function registerSessions(ctx) {
+  const { program, baseArgs, run } = ctx;
+  const viewport = program.command("viewport").description("Emulate device viewport, DPR, mobile flag, touch, and user agent.").addHelpText(
+    "after",
+    `
+
+Examples:
+  chrome-relay viewport preset iphone-14 --tab 123
+  chrome-relay viewport preset desktop-1440 --tab 123
+  chrome-relay viewport set --tab 123 --width 414 --height 896 --mobile --dpr 3
+  chrome-relay viewport clear --tab 123
+  chrome-relay viewport list
+
+Notes:
+  The override survives navigations within the tab but is wiped when the
+  debugger detaches (e.g. another extension takes over). Closing the tab
+  clears it. Re-run after detach if the page snaps back to its default size.
+`
+  );
+  tabOpt(
+    viewport.command("set").description("Apply explicit viewport dimensions.").requiredOption("--width <px>", "viewport width in CSS pixels", (v) => Number(v)).requiredOption("--height <px>", "viewport height in CSS pixels", (v) => Number(v)).option("--dpr <ratio>", "device pixel ratio (1, 2, 3...)", (v) => Number(v)).option("--mobile", "set the mobile flag (affects meta viewport interpretation)").option("--touch", "enable touch event emulation").option("--user-agent <ua>", "override the User-Agent header")
+  ).action(async (opts) => {
+    const args = { action: "set", width: opts.width, height: opts.height };
+    Object.assign(args, baseArgs(opts));
+    if (opts.dpr !== void 0) args.dpr = opts.dpr;
+    if (opts.mobile) args.mobile = true;
+    if (opts.touch) args.hasTouch = true;
+    if (opts.userAgent) args.userAgent = opts.userAgent;
+    await run("chrome_viewport", args);
+  });
+  tabOpt(
+    viewport.command("preset <name>").description("Apply a named device preset (iphone-14, pixel-7, desktop-1440, etc).")
+  ).action(async (name, opts) => {
+    const args = { action: "preset", name };
+    Object.assign(args, baseArgs(opts));
+    await run("chrome_viewport", args);
+  });
+  tabOpt(
+    viewport.command("clear").description("Drop the viewport override and return the tab to its native size.")
+  ).action(async (opts) => {
+    const args = { action: "clear" };
+    Object.assign(args, baseArgs(opts));
+    await run("chrome_viewport", args);
+  });
+  viewport.command("list").description("List available presets.").action(async () => {
+    await run("chrome_viewport", { action: "list" });
+  });
+  program.command("self-reload").description("Restart the chrome-relay extension's service worker (picks up newly built code).").action(async () => {
+    await run("chrome_self_reload", {});
+  });
+  const workspace = program.command("workspace").description("Manage named Chrome windows so multiple agents can drive separate windows.").addHelpText(
+    "after",
+    `
+
+Examples:
+  chrome-relay workspace create bidsmith-h01 --url https://reddit.com
+  chrome-relay workspace list
+  chrome-relay --workspace bidsmith-h01 navigate https://news.ycombinator.com
+  chrome-relay --workspace bidsmith-h01 screenshot -o evidence.png
+  chrome-relay workspace close bidsmith-h01
+
+Notes:
+  Hard lifecycle: if you manually close the workspace's window, the next
+  --workspace operation fails loudly until you run \`workspace close\` +
+  \`workspace create\` again.
+  Precedence on a single command: --tab > --group > --workspace.
+`
+  );
+  workspace.command("create <name>").description("Open a new Chrome window and bind it to <name>.").option("--url <url>", "initial URL (default about:blank)").option("--label <label>", "human-readable description shown in popup/list").action(async (name, opts) => {
+    const args = { action: "create", name };
+    if (opts.url) args.url = opts.url;
+    if (opts.label) args.label = opts.label;
+    await run("chrome_workspace", args);
+  });
+  workspace.command("list").description("List all known workspaces + whether their window is still alive.").action(async () => {
+    await run("chrome_workspace", { action: "list" });
+  });
+  workspace.command("close <name>").description("Close the workspace's window (if alive) and remove the binding.").action(async (name) => {
+    await run("chrome_workspace", { action: "close", name });
+  });
+  const group = program.command("group").description("Manage Chrome tab-groups (the colored, collapsible folders inside one window).").addHelpText(
+    "after",
+    `
+
+Examples:
+  chrome-relay group create research --tabs 123,456,789 --color cyan
+  chrome-relay group list
+  chrome-relay group add research --tabs 1011
+  chrome-relay group remove --tabs 456
+  chrome-relay --group research navigate https://news.ycombinator.com
+  chrome-relay group close research
+
+Notes:
+  Tab-groups live inside ONE Chrome window. To open in a specific window,
+  pass --workspace W on \`group create\` (we'll route the underlying
+  chrome.tabs.group call there).
+  \`--group X navigate --new\` opens the new tab into the group's window AND
+  drops it inside the group.
+  Auto-pruned when the group's last tab is ungrouped or its window closes.
+  Colors: grey, blue, red, yellow, green, pink, purple, cyan, orange.
+`
+  );
+  group.command("create <name>").description("Group existing tabs into a new tab-group bound to <name>.").requiredOption("--tabs <ids>", "comma-separated tab IDs to group, e.g. 123,456,789").option("--color <color>", "grey | blue | red | yellow | green | pink | purple | cyan | orange").option("--collapsed", "create the group in its collapsed state").action(async (name, opts) => {
+    const args = { action: "create", name };
+    args.tabIds = String(opts.tabs).split(",").map((s) => Number(s.trim())).filter(Number.isFinite);
+    if (opts.color) args.color = opts.color;
+    if (opts.collapsed) args.collapsed = true;
+    await run("chrome_group", args);
+  });
+  group.command("list").description("List all known tab-groups + their window/color/tabCount.").action(async () => {
+    await run("chrome_group", { action: "list" });
   });
   group.command("close <name>").description("Ungroup the tabs in <name> and remove the binding.").action(async (name) => {
     await run("chrome_group", { action: "close", name });
@@ -796,17 +974,6 @@ Notes:
     const tabIds = String(opts.tabs).split(",").map((s) => Number(s.trim())).filter(Number.isFinite);
     await run("chrome_group", { action: "remove", tabIds });
   });
-  function netFilterOpts(cmd) {
-    return cmd.option("--filter <substr>", "url substring filter").option("--status <bucket>", "ok | redirect | client_error | server_error | failed").option("--method <verb>", "exact method, e.g. POST").option("--limit <n>", "cap response length", (v) => Number(v));
-  }
-  function netFilterArgs(opts) {
-    const a = {};
-    if (opts.filter) a.filter = opts.filter;
-    if (opts.status) a.status = opts.status;
-    if (opts.method) a.method = opts.method;
-    if (typeof opts.limit === "number") a.limit = opts.limit;
-    return a;
-  }
   const network = tabOpt(netFilterOpts(
     program.command("network").description("Capture HTTP request/response metadata. Ring buffer, last 200 per tab.")
   )).addHelpText(
@@ -896,171 +1063,41 @@ Notes:
     if (typeof opts.limit === "number") args.limit = opts.limit;
     await run("chrome_console", args);
   });
-  tabOpt(
-    program.command("hover [selector]").description("Move the pointer over an element or coordinates. Fires :hover styles.").option("--x <px>", "explicit x coordinate (CSS pixels)", (v) => Number(v)).option("--y <px>", "explicit y coordinate (CSS pixels)", (v) => Number(v)).addHelpText(
-      "after",
-      `
-
-Examples:
-  chrome-relay hover --tab 123 'button[title="Install runner"]'
-  chrome-relay hover --tab 123 --x 1327 --y 771
+}
 
-Use before screencast to capture hover-driven micro-states (button glow,
-tooltip appearance, etc.) that a bare click would skip past too quickly.
-`
-    )
-  ).action(async (selector, opts) => {
-    const args = {};
-    Object.assign(args, baseArgs(opts));
-    if (selector) args.selector = selector;
-    if (typeof opts.x === "number" && typeof opts.y === "number") {
-      args.x = opts.x;
-      args.y = opts.y;
-    }
-    await run("chrome_hover", args);
-  });
-  const screencast = program.command("screencast").description("Record a tab via CDP (paint-driven). Requires an active tab.").addHelpText(
+// src/program.ts
+function buildProgram() {
+  const program = new Command();
+  program.name("chrome-relay").description("Connect your local Chrome browser to coding agents through a local bridge.").version(CHROME_RELAY_VERSION).showHelpAfterError().option("--workspace <name>", "target the active tab in a named workspace window (works at top level too)").option("--group <name>", "target the active tab in a named tab-group (works at top level too)").enablePositionalOptions().addHelpText(
     "after",
     `
 
-Examples:
-  chrome-relay screencast start --tab 123 --quality 80 --max-width 900
-  # ... drive the interaction (hover, click, etc.) ...
-  chrome-relay screencast stop --tab 123 --out /tmp/recording
-
-  # The --out path becomes a directory of frame_NNNN.jpg files. If ffmpeg
-  # is on PATH and --gif is also passed, an animated GIF is written next to
-  # the frames at /tmp/recording.gif.
+Common agent flow:
+  chrome-relay tabs
+  chrome-relay navigate --tab <tabId> "https://example.com"
+  chrome-relay read --tab <tabId> -i
+  chrome-relay click --tab <tabId> "<selector>"
+  chrome-relay fill --tab <tabId> "<selector>" "value"
+  chrome-relay type --tab <tabId> -s "<selector>" "text into rich editor"
+  chrome-relay keys --tab <tabId> Enter
+  chrome-relay js --tab <tabId> "return document.title"
+  chrome-relay screenshot --tab <tabId> -o evidence.png
 
 Notes:
-  Frames buffer in the extension service worker. A 10-second capture at
-  default settings (jpeg q=60, ~15fps, full viewport) lands ~2-3 MB.
-  Pass --max-width to downscale and lighten the buffer.
-  Each frame is base64 JPEG; the CLI decodes them when --out is given.
+  navigate takes a URL. Use --tab to target an existing tab.
+  Tools attach via CDP and run on backgrounded tabs without stealing focus.
 `
   );
-  tabOpt(
-    screencast.command("start").description("Begin screencast capture on a tab.").option("--format <fmt>", "jpeg | png (default jpeg)").option("--quality <n>", "jpeg quality 0-100 (default 80)", (v) => Number(v)).option("--max-width <px>", "downscale; aspect preserved", (v) => Number(v)).option("--max-height <px>", "downscale; aspect preserved", (v) => Number(v)).option("--every-nth <n>", "throttle: keep 1 in N frames (default 1)", (v) => Number(v))
-  ).action(async (opts) => {
-    const args = { action: "start" };
-    Object.assign(args, baseArgs(opts));
-    if (opts.format) args.format = opts.format;
-    if (typeof opts.quality === "number") args.quality = opts.quality;
-    if (typeof opts.maxWidth === "number") args.maxWidth = opts.maxWidth;
-    if (typeof opts.maxHeight === "number") args.maxHeight = opts.maxHeight;
-    if (typeof opts.everyNth === "number") args.everyNthFrame = opts.everyNth;
-    await run("chrome_screencast", args);
-  });
-  tabOpt(
-    screencast.command("stop").description("Stop the screencast and emit frames (or write to disk).").option("-o, --out <dir>", "write frames as JPEGs into this directory (created if missing)").option("--gif", "after writing frames, ffmpeg them into <dir>.gif").option("--mp4", "after writing frames, ffmpeg them into <dir>.mp4").option("--fps <n>", "assumed framerate when invoking ffmpeg (default 15)", (v) => Number(v)).option("--no-dedupe", "keep raw frames; default collapses consecutive identical frames via SHA-256")
-  ).action(async (opts) => {
-    const args = { action: "stop" };
-    Object.assign(args, baseArgs(opts));
-    try {
-      const result = await callTool("chrome_screencast", args);
-      if (!opts.out) {
-        const { frames, ...summary } = result;
-        process.stdout.write(JSON.stringify({ ...summary, framesOmitted: frames.length, hint: "pass --out <dir> to save" }, null, 2) + "\n");
-        return;
-      }
-      const { mkdirSync, writeFileSync: writeFileSync2, renameSync, unlinkSync } = await import("fs");
-      const path2 = await import("path");
-      const { createHash } = await import("crypto");
-      mkdirSync(opts.out, { recursive: true });
-      result.frames.forEach((f, i) => {
-        const name = `frame_${String(i + 1).padStart(4, "0")}.jpg`;
-        writeFileSync2(path2.join(opts.out, name), Buffer.from(f.data, "base64"));
-      });
-      process.stdout.write(`Wrote ${result.frames.length} frames to ${opts.out}
-`);
-      const dedupeOn = opts.dedupe !== false;
-      if (dedupeOn && result.frames.length > 1) {
-        const hashes = result.frames.map(
-          (f) => createHash("sha256").update(Buffer.from(f.data, "base64")).digest("hex")
-        );
-        const kept = [];
-        let prev = "";
-        hashes.forEach((h, i) => {
-          if (h !== prev) kept.push(i);
-          prev = h;
-        });
-        const dropped = result.frames.length - kept.length;
-        if (dropped > 0) {
-          for (let i = 0; i < result.frames.length; i++) {
-            const src = path2.join(opts.out, `frame_${String(i + 1).padStart(4, "0")}.jpg`);
-            try {
-              unlinkSync(src);
-            } catch {
-            }
-          }
-          kept.forEach((srcIdx, newIdx) => {
-            const tmp = path2.join(opts.out, `tmp_${String(newIdx + 1).padStart(4, "0")}.jpg`);
-            writeFileSync2(tmp, Buffer.from(result.frames[srcIdx].data, "base64"));
-          });
-          kept.forEach((_, newIdx) => {
-            const tmp = path2.join(opts.out, `tmp_${String(newIdx + 1).padStart(4, "0")}.jpg`);
-            const final = path2.join(opts.out, `frame_${String(newIdx + 1).padStart(4, "0")}.jpg`);
-            renameSync(tmp, final);
-          });
-          process.stdout.write(`Deduped: dropped ${dropped} identical frames, ${kept.length} remain.
-`);
-        } else {
-          process.stdout.write(`Deduped: no consecutive duplicates found.
-`);
-        }
-      }
-      if (opts.gif || opts.mp4) {
-        const fps = typeof opts.fps === "number" ? opts.fps : 15;
-        const { spawnSync } = await import("child_process");
-        const which = spawnSync("which", ["ffmpeg"]);
-        if (which.status !== 0) {
-          process.stderr.write("[chrome-relay] ffmpeg not on PATH \u2014 skipping --gif/--mp4.\n");
-          return;
-        }
-        if (opts.gif) {
-          const gifOut = `${opts.out.replace(/\/$/, "")}.gif`;
-          const r = spawnSync("ffmpeg", [
-            "-y",
-            "-framerate",
-            String(fps),
-            "-i",
-            path2.join(opts.out, "frame_%04d.jpg"),
-            "-vf",
-            `fps=${fps},split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse`,
-            "-loop",
-            "0",
-            gifOut
-          ], { stdio: "inherit" });
-          if (r.status === 0) process.stdout.write(`Wrote ${gifOut}
-`);
-        }
-        if (opts.mp4) {
-          const mp4Out = `${opts.out.replace(/\/$/, "")}.mp4`;
-          const r = spawnSync("ffmpeg", [
-            "-y",
-            "-framerate",
-            String(fps),
-            "-i",
-            path2.join(opts.out, "frame_%04d.jpg"),
-            "-c:v",
-            "libx264",
-            "-pix_fmt",
-            "yuv420p",
-            "-crf",
-            "20",
-            mp4Out
-          ], { stdio: "inherit" });
-          if (r.status === 0) process.stdout.write(`Wrote ${mp4Out}
-`);
-        }
-      }
-    } catch (error) {
-      process.stderr.write(
-        (error instanceof Error ? error.message : String(error)) + "\n"
-      );
-      process.exit(1);
-    }
-  });
+  const ctx = {
+    program,
+    baseArgs: makeBaseArgs(program),
+    run: runTool
+  };
+  registerInstallUpdate(program);
+  registerNavigation(ctx);
+  registerInput(ctx);
+  registerCapture(ctx);
+  registerSessions(ctx);
   return program;
 }
 

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.5.8" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.5.9" : "0.0.0-dev";
 export {
   CHROME_RELAY_VERSION
 };

package/dist/native-host.js

@@ -48,7 +48,7 @@ function toBridgeError(unknownErr, fallbackTool) {
 }
 
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.5.8" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.5.9" : "0.0.0-dev";
 
 // src/release-notes.ts
 function compareSemver(a, b) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-relay",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",