chrome-relay 0.3.0 → 0.3.2

package/dist/cli.js

@@ -5,7 +5,7 @@ import { Command } from "commander";
 import { writeFileSync } from "fs";
 
 // src/index.ts
-var CHROME_RELAY_VERSION = "0.2.3";
+var CHROME_RELAY_VERSION = true ? "0.3.2" : "0.0.0-dev";
 
 // src/install/install.ts
 import os from "os";
@@ -154,7 +154,7 @@ async function callTool(name, args) {
 // 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().addHelpText(
+  program.name("chrome-relay").description("Connect your local Chrome browser to coding agents through a local bridge.").version(CHROME_RELAY_VERSION).showHelpAfterError().option("--group <name>", "target the active tab of a named group window (works at top level too)").enablePositionalOptions().addHelpText(
     "after",
     `
 
@@ -202,10 +202,16 @@ Notes:
   function baseArgs(opts) {
     const args = {};
     if (opts.tab !== void 0) args.tabId = opts.tab;
-    if (opts.group) args.groupName = opts.group;
+    const effectiveGroup = opts.group ?? program.opts().group;
+    if (effectiveGroup) args.groupName = effectiveGroup;
     return args;
   }
-  program.command("tabs").description("List open Chrome windows and tabs.").action(async () => {
+  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'.
+`);
+      process.exit(1);
+    }
     await run("get_windows_and_tabs", {});
   });
   tabOpt(
@@ -229,14 +235,13 @@ Use "chrome-relay switch ${url}" to activate that tab, or "chrome-relay navigate
       process.exit(1);
     }
     const args = { url };
-    if (opts.tab !== void 0) args.tabId = opts.tab;
-    if (opts.group) args.groupName = opts.group;
+    Object.assign(args, baseArgs(opts));
     if (opts.new) args.newTab = true;
     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("-o, --out <path>", "save image to path (base64 PNG decoded)").addHelpText(
+    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",
       `
 
@@ -254,12 +259,12 @@ full-tab screenshot when an agent only needs to see one component.
     )
   ).action(async (opts) => {
     const args = {};
-    if (opts.tab !== void 0) args.tabId = opts.tab;
-    if (opts.group) args.groupName = opts.group;
+    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") {
@@ -284,8 +289,7 @@ full-tab screenshot when an agent only needs to see one component.
     program.command("read").description("Extract page structure and interactive elements.").option("-i, --interactive", "return only interactive elements")
   ).action(async (opts) => {
     const args = {};
-    if (opts.tab !== void 0) args.tabId = opts.tab;
-    if (opts.group) args.groupName = opts.group;
+    Object.assign(args, baseArgs(opts));
     if (opts.interactive) args.interactiveOnly = true;
     await run("chrome_read_page", args);
   });
@@ -293,16 +297,14 @@ full-tab screenshot when an agent only needs to see one component.
     program.command("click <selector>").description("Click an element by CSS selector.")
   ).action(async (selector, opts) => {
     const args = { selector };
-    if (opts.tab !== void 0) args.tabId = opts.tab;
-    if (opts.group) args.groupName = opts.group;
+    Object.assign(args, baseArgs(opts));
     await run("chrome_click_element", args);
   });
   tabOpt(
     program.command("fill <selector> <value>").description("Fill an input or textarea.")
   ).action(async (selector, value, opts) => {
     const args = { selector, value };
-    if (opts.tab !== void 0) args.tabId = opts.tab;
-    if (opts.group) args.groupName = opts.group;
+    Object.assign(args, baseArgs(opts));
     await run("chrome_fill_or_select", args);
   });
   tabOpt(
@@ -321,8 +323,7 @@ For typing text into a field, use \`chrome-relay type\` instead.
     )
   ).action(async (keys, opts) => {
     const args = { keys };
-    if (opts.tab !== void 0) args.tabId = opts.tab;
-    if (opts.group) args.groupName = opts.group;
+    Object.assign(args, baseArgs(opts));
     await run("chrome_keyboard", args);
   });
   tabOpt(
@@ -343,8 +344,7 @@ When to pick which:
     )
   ).action(async (text, opts) => {
     const args = { text };
-    if (opts.tab !== void 0) args.tabId = opts.tab;
-    if (opts.group) args.groupName = opts.group;
+    Object.assign(args, baseArgs(opts));
     if (opts.selector) args.selector = opts.selector;
     await run("chrome_type", args);
   });
@@ -366,8 +366,7 @@ Notes:
     )
   ).action(async (code, opts) => {
     const args = { code };
-    if (opts.tab !== void 0) args.tabId = opts.tab;
-    if (opts.group) args.groupName = opts.group;
+    Object.assign(args, baseArgs(opts));
     if (typeof opts.timeoutMs === "number") args.timeoutMs = opts.timeoutMs;
     await run("chrome_evaluate", args);
   });
@@ -413,16 +412,14 @@ Notes:
     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 };
-    if (opts.tab !== void 0) args.tabId = opts.tab;
-    if (opts.group) args.groupName = opts.group;
+    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" };
-    if (opts.tab !== void 0) args.tabId = opts.tab;
-    if (opts.group) args.groupName = opts.group;
+    Object.assign(args, baseArgs(opts));
     await run("chrome_viewport", args);
   });
   viewport.command("list").description("List available presets.").action(async () => {
@@ -500,18 +497,32 @@ Notes:
   group.command("close <name>").description("Close the group's window (if alive) and remove the binding.").action(async (name) => {
     await run("chrome_group", { action: "close", name });
   });
-  const network = program.command("network").description("Capture HTTP request/response metadata. Ring buffer, last 200 per tab.").addHelpText(
+  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(
     "after",
     `
 
 Examples:
-  chrome-relay network --tab 123                          # last 200 requests
-  chrome-relay network --tab 123 --filter api.example.com  # url substring
-  chrome-relay network --tab 123 --status failed           # only failures
+  chrome-relay network --tab 123                              # last 200 requests
+  chrome-relay network --tab 123 --filter api.example.com      # url substring
+  chrome-relay network --tab 123 --status failed
   chrome-relay network --tab 123 --method POST
-  chrome-relay network --tab 123 --body <requestId>        # lazy body fetch
-  chrome-relay network --tab 123 har > capture.har         # HAR export
-  chrome-relay network --tab 123 --clear
+  chrome-relay network body <requestId> --tab 123              # lazy body fetch
+  chrome-relay network har --tab 123 > capture.har             # HAR (metadata only)
+  chrome-relay network har --tab 123 --with-bodies > full.har  # HAR with bodies
+  chrome-relay network clear --tab 123
 
 Privacy:
   Capturing network traffic includes Authorization headers, cookies, and
@@ -521,32 +532,37 @@ Privacy:
 
 Notes:
   Bodies are NOT eagerly buffered \u2014 Chrome GCs response bodies ~30s after
-  the request finishes. Use \`--body <id>\` promptly. WebSocket frames and
-  SSE streams are out of scope.
+  the request finishes. Use \`--body <id>\` or \`har --with-bodies\` promptly.
+  WebSocket frames and SSE streams are out of scope.
 `
-  );
-  tabOpt(
-    network.command("read", { isDefault: true }).description("List captured network entries.").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))
   ).action(async (opts) => {
-    const args = baseArgs(opts);
-    if (opts.filter) args.filter = opts.filter;
-    if (opts.status) args.status = opts.status;
-    if (opts.method) args.method = opts.method;
-    if (typeof opts.limit === "number") args.limit = opts.limit;
+    const args = { ...baseArgs(opts), ...netFilterArgs(opts) };
+    await run("chrome_network", args);
+  });
+  tabOpt(netFilterOpts(
+    network.command("read").description("(alias) list captured network entries.")
+  )).action(async (opts) => {
+    const args = { ...baseArgs(opts), ...netFilterArgs(opts) };
     await run("chrome_network", args);
   });
   tabOpt(
-    network.command("body <requestId>").description("Fetch the response body for one request (lazy; may fail if GC'd).")
+    network.command("body <requestId>").description("Fetch the response body for one request (lazy; may fail if GC'd).").option("--head <bytes>", "truncate to first N bytes", (v) => Number(v)).option("--full", "return the full body \u2014 default truncates to 8 KB")
   ).action(async (requestId, opts) => {
     const args = { ...baseArgs(opts), action: "body", requestId };
+    if (opts.full) args.full = true;
+    if (typeof opts.head === "number") args.head = opts.head;
     await run("chrome_network", args);
   });
-  tabOpt(
-    network.command("har").description("Emit HAR-compatible JSON for the captured entries.").option("--filter <substr>", "url substring filter").option("--status <bucket>", "status bucket filter")
-  ).action(async (opts) => {
-    const args = { ...baseArgs(opts), action: "har" };
-    if (opts.filter) args.filter = opts.filter;
-    if (opts.status) args.status = opts.status;
+  tabOpt(netFilterOpts(
+    network.command("har").description("Emit HAR-compatible JSON for the captured entries.").option("--with-bodies", "fetch response bodies before emitting (best-effort; bodies GC'd by Chrome become null)")
+  )).action(async (opts) => {
+    const args = { ...baseArgs(opts), ...netFilterArgs(opts), action: "har" };
+    if (opts.withBodies) args.withBodies = true;
+    else {
+      process.stderr.write(
+        "[chrome-relay] HAR exported WITHOUT response bodies. Pass --with-bodies to include them (best-effort; bodies older than ~30s may be unavailable).\n"
+      );
+    }
     await run("chrome_network", args);
   });
   tabOpt(

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-declare const CHROME_RELAY_VERSION = "0.2.3";
+declare const CHROME_RELAY_VERSION: string;
 
 export { CHROME_RELAY_VERSION };

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-relay",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,7 +27,7 @@
   "devDependencies": {
     "tsup": "^8.4.0",
     "vitest": "^3.0.0",
-    "@chrome-relay/protocol": "0.3.0"
+    "@chrome-relay/protocol": "0.3.2"
   },
   "scripts": {
     "build": "tsup",