chrome-relay 0.3.1 → 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";
@@ -206,7 +206,12 @@ Notes:
     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(
@@ -236,7 +241,7 @@ Use "chrome-relay switch ${url}" to activate that tab, or "chrome-relay navigate
     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",
       `
 
@@ -259,6 +264,7 @@ full-tab screenshot when an agent only needs to see one component.
     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") {
@@ -491,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
@@ -512,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.1",
+  "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",