chrome-relay 0.5.15 → 0.5.16

package/dist/cli.js

@@ -234,6 +234,16 @@ function parseChromeHoverArgs(input) {
   const target = parseTargetArgs(obj, TOOL_NAMES.HOVER);
   const x = optNumber(obj, "x", TOOL_NAMES.HOVER);
   const y = optNumber(obj, "y", TOOL_NAMES.HOVER);
+  if (x !== void 0 !== (y !== void 0)) {
+    throw new RelayError({
+      code: "invalid_arguments",
+      message: "chrome_hover: pass BOTH x and y, or neither (selector mode).",
+      tool: TOOL_NAMES.HOVER,
+      phase: "parse_arguments",
+      details: { received: { x: obj.x, y: obj.y } },
+      retryable: false
+    });
+  }
   if (x !== void 0 && y !== void 0) {
     return { ...target, kind: "coords", x, y };
   }
@@ -831,7 +841,7 @@ var init_args = __esm({
 });
 
 // ../protocol/dist/limits.js
-var DEFAULT_TOOL_CALL_TIMEOUT_MS, DEFAULT_PING_TIMEOUT_MS, DEFAULT_READY_TIMEOUT_MS, DEFAULT_EVAL_TIMEOUT_MS, DEFAULT_BODY_PREVIEW_BYTES, NETWORK_BUFFER_MAX_ENTRIES, NETWORK_BUFFER_MAX_BYTES, CONSOLE_BUFFER_MAX_ENTRIES, CONSOLE_BUFFER_MAX_BYTES;
+var DEFAULT_TOOL_CALL_TIMEOUT_MS, DEFAULT_PING_TIMEOUT_MS, DEFAULT_READY_TIMEOUT_MS, DEFAULT_EVAL_TIMEOUT_MS, DEFAULT_BODY_PREVIEW_BYTES, NETWORK_BUFFER_MAX_ENTRIES, NETWORK_BUFFER_MAX_BYTES, CONSOLE_BUFFER_MAX_ENTRIES, CONSOLE_BUFFER_MAX_BYTES, CONSOLE_ENTRY_TEXT_MAX_CHARS, CONSOLE_ENTRY_STACK_MAX_CHARS;
 var init_limits = __esm({
   "../protocol/dist/limits.js"() {
     "use strict";
@@ -844,6 +854,8 @@ var init_limits = __esm({
     NETWORK_BUFFER_MAX_BYTES = 512 * 1024;
     CONSOLE_BUFFER_MAX_ENTRIES = 200;
     CONSOLE_BUFFER_MAX_BYTES = 256 * 1024;
+    CONSOLE_ENTRY_TEXT_MAX_CHARS = 1e3;
+    CONSOLE_ENTRY_STACK_MAX_CHARS = 1e3;
   }
 });
 
@@ -853,6 +865,8 @@ __export(dist_exports, {
   CHROME_WEB_STORE_EXTENSION_ID: () => CHROME_WEB_STORE_EXTENSION_ID,
   CONSOLE_BUFFER_MAX_BYTES: () => CONSOLE_BUFFER_MAX_BYTES,
   CONSOLE_BUFFER_MAX_ENTRIES: () => CONSOLE_BUFFER_MAX_ENTRIES,
+  CONSOLE_ENTRY_STACK_MAX_CHARS: () => CONSOLE_ENTRY_STACK_MAX_CHARS,
+  CONSOLE_ENTRY_TEXT_MAX_CHARS: () => CONSOLE_ENTRY_TEXT_MAX_CHARS,
   DEFAULT_BODY_PREVIEW_BYTES: () => DEFAULT_BODY_PREVIEW_BYTES,
   DEFAULT_EVAL_TIMEOUT_MS: () => DEFAULT_EVAL_TIMEOUT_MS,
   DEFAULT_EXTENSION_ID: () => DEFAULT_EXTENSION_ID,
@@ -1009,7 +1023,7 @@ var init_dist = __esm({
 import { Command } from "commander";
 
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.5.15" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.5.16" : "0.0.0-dev";
 
 // src/commands/shared.ts
 init_dist();
@@ -1248,6 +1262,15 @@ async function runDoctor() {
 
 // src/release-notes.ts
 var RELEASE_NOTES = {
+  "0.5.16": [
+    "chrome_hover now rejects partial-coordinate intent (`--x 10` without `--y`, or vice versa) instead of silently falling through to selector-mode and losing the half-passed coordinate. CLI forwards even partial input so the protocol parser sees it.",
+    "Network body errors are now structured RelayError instead of plain Error. `getBody` for a request that's not in the buffer \u2192 `target_not_found`; CDP failure (Chrome GC'd the body, permission denied, etc.) \u2192 `cdp_error` with the original message under `details.underlying`. Agents can branch on the code instead of pattern-matching the message.",
+    "Console truncation cap (1000 chars) consolidated into limits.ts as CONSOLE_ENTRY_TEXT_MAX_CHARS / CONSOLE_ENTRY_STACK_MAX_CHARS. 4 hardcoded sites in console-buffer.ts now reference the constants.",
+    "CLI help text interpolates limits from @chrome-relay/protocol. `chrome-relay network --help` and `chrome-relay console --help` no longer hardcode '200' or '256 KB' \u2014 they read from NETWORK_BUFFER_MAX_ENTRIES / CONSOLE_BUFFER_MAX_ENTRIES / CONSOLE_BUFFER_MAX_BYTES. Future bumps propagate without manual edits.",
+    "Removed the PER_TAB_MAX / PER_TAB_MAX_BYTES alias indirection in network-buffer.ts and console-buffer.ts. The protocol constants have good names; aliasing them was leftover from before they existed.",
+    "Softened the over-claiming parser comments in args/index.ts and shared.ts \u2014 they correctly describe the extension as the trust boundary that runs the parsers (CLI doesn't pre-validate today; that's a documented future PR).",
+    "Tests: +1 hover partial-coord + 2 network getBody structured-error coverage. Total 417 (was 416)."
+  ],
   "0.5.15": [
     "Tab-id coercion is now strict against blank strings. `--tabs '1,,3'` (or `[\"\"]`, or `[' ']`) used to silently become `[1, 0, 3]` because Number('') === 0 \u2014 and tab 0 is a real Chrome target. Now throws RelayError(invalid_arguments). Affects chrome_group create/add/remove, chrome_switch_tab, chrome_close_tabs.",
     "Numeric range validation added across the parsers. `optPositiveNumber` (> 0) and `optNonNegativeNumber` (>= 0) helpers reject out-of-range values at the parser boundary instead of letting nonsense through to CDP / handler logic. Affects: chrome_evaluate timeoutMs, chrome_screenshot maxEdge + padding, chrome_screencast quality/maxWidth/maxHeight/everyNthFrame, chrome_network body head.",
@@ -1598,10 +1621,8 @@ tooltip appearance, etc.) that a bare click would skip past too quickly.
   ).action(async (selector, opts) => {
     const extras = {};
     if (selector) extras.selector = selector;
-    if (typeof opts.x === "number" && typeof opts.y === "number") {
-      extras.x = opts.x;
-      extras.y = opts.y;
-    }
+    if (typeof opts.x === "number") extras.x = opts.x;
+    if (typeof opts.y === "number") extras.y = opts.y;
     await run("chrome_hover", withBase(opts, extras));
   });
 }
@@ -1857,6 +1878,8 @@ Notes:
 }
 
 // src/commands/sessions.ts
+init_dist();
+var CONSOLE_BUFFER_MAX_KB = Math.round(CONSOLE_BUFFER_MAX_BYTES / 1024);
 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));
 }
@@ -1984,13 +2007,13 @@ Notes:
     await run("chrome_group", { action: "remove", tabIds: String(opts.tabs) });
   });
   const network = tabOpt(netFilterOpts(
-    program.command("network").description("Capture HTTP request/response metadata. Ring buffer, last 200 per tab.")
+    program.command("network").description(`Capture HTTP request/response metadata. Ring buffer, last ${NETWORK_BUFFER_MAX_ENTRIES} per tab.`)
   )).addHelpText(
     "after",
     `
 
 Examples:
-  chrome-relay network --tab 123                              # last 200 requests
+  chrome-relay network --tab 123                              # last ${NETWORK_BUFFER_MAX_ENTRIES} 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
@@ -2045,7 +2068,7 @@ Notes:
     await run("chrome_network", withBase(opts, { action: "clear" }));
   });
   tabOpt(
-    program.command("console").description("Read console.log/warn/error + page exceptions (ring buffer, last 200).").option("--level <levels>", "comma-separated: log,info,warn,error,debug,exception").option("--since <id>", "only return entries with id > since (live-tail-ish)", (v) => Number(v)).option("--limit <n>", "cap response length", (v) => Number(v)).option("--clear", "wipe the buffer (no read)").addHelpText(
+    program.command("console").description(`Read console.log/warn/error + page exceptions (ring buffer, last ${CONSOLE_BUFFER_MAX_ENTRIES}).`).option("--level <levels>", "comma-separated: log,info,warn,error,debug,exception").option("--since <id>", "only return entries with id > since (live-tail-ish)", (v) => Number(v)).option("--limit <n>", "cap response length", (v) => Number(v)).option("--clear", "wipe the buffer (no read)").addHelpText(
       "after",
       `
 
@@ -2056,7 +2079,7 @@ Examples:
   chrome-relay console --tab 123 --clear
 
 Notes:
-  Ring buffer holds the last 200 entries per tab (or 256 KB, whichever first).
+  Ring buffer holds the last ${CONSOLE_BUFFER_MAX_ENTRIES} entries per tab (or ${CONSOLE_BUFFER_MAX_KB} KB, whichever first).
   Wipes on tab close. First call on a tab subscribes; subsequent calls are
   instant in-memory reads.
 `

package/dist/index.js

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

package/dist/native-host.js

@@ -56,7 +56,7 @@ function toBridgeError(unknownErr, fallbackTool) {
 }
 
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.5.15" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.5.16" : "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.15",
+  "version": "0.5.16",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",