chrome-relay 0.5.15 → 0.5.17

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 };
   }
@@ -818,6 +828,54 @@ var init_multi = __esm({
 });
 
 // ../protocol/dist/args/index.js
+function parseToolArgs(name, input) {
+  switch (name) {
+    case "get_windows_and_tabs":
+      return parseGetWindowsAndTabsArgs(input);
+    case "chrome_navigate":
+      return parseChromeNavigateArgs(input);
+    case "chrome_switch_tab":
+      return parseChromeSwitchTabArgs(input);
+    case "chrome_close_tabs":
+      return parseChromeCloseTabsArgs(input);
+    case "chrome_screenshot":
+      return parseChromeScreenshotArgs(input);
+    case "chrome_read_page":
+      return parseChromeReadPageArgs(input);
+    case "chrome_click_element":
+      return parseChromeClickArgs(input);
+    case "chrome_fill_or_select":
+      return parseChromeFillArgs(input);
+    case "chrome_keyboard":
+      return parseChromeKeyboardArgs(input);
+    case "chrome_type":
+      return parseChromeTypeArgs(input);
+    case "chrome_evaluate":
+      return parseChromeEvaluateArgs(input);
+    case "chrome_viewport":
+      return parseChromeViewportArgs(input);
+    case "chrome_self_reload":
+      return parseChromeSelfReloadArgs(input);
+    case "chrome_console":
+      return parseChromeConsoleArgs(input);
+    case "chrome_workspace":
+      return parseChromeWorkspaceArgs(input);
+    case "chrome_group":
+      return parseChromeGroupArgs(input);
+    case "chrome_ax":
+      return parseChromeAxArgs(input);
+    case "chrome_click_ax":
+      return parseChromeClickAxArgs(input);
+    case "chrome_network":
+      return parseChromeNetworkArgs(input);
+    case "chrome_hover":
+      return parseChromeHoverArgs(input);
+    case "chrome_screencast":
+      return parseChromeScreencastArgs(input);
+  }
+  const exhaustive = name;
+  return exhaustive;
+}
 var init_args = __esm({
   "../protocol/dist/args/index.js"() {
     "use strict";
@@ -827,11 +885,16 @@ var init_args = __esm({
     init_network();
     init_simple();
     init_multi();
+    init_navigate();
+    init_hover();
+    init_network();
+    init_simple();
+    init_multi();
   }
 });
 
 // ../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 +907,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 +918,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,
@@ -897,6 +964,7 @@ __export(dist_exports, {
   parseChromeWorkspaceArgs: () => parseChromeWorkspaceArgs,
   parseGetWindowsAndTabsArgs: () => parseGetWindowsAndTabsArgs,
   parseTargetArgs: () => parseTargetArgs,
+  parseToolArgs: () => parseToolArgs,
   requireString: () => requireString,
   toBridgeError: () => toBridgeError
 });
@@ -1009,7 +1077,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.17" : "0.0.0-dev";
 
 // src/commands/shared.ts
 init_dist();
@@ -1117,7 +1185,8 @@ function emitTargetOverride(kind, from, to) {
 }
 async function runToolImpl(name, args) {
   try {
-    const result = await callTool(name, args);
+    const parsedArgs = isToolName(name) ? parseToolArgs(name, args) : args;
+    const result = await callTool(name, parsedArgs);
     if (typeof result === "string") {
       process.stdout.write(result + "\n");
     } else {
@@ -1136,6 +1205,9 @@ async function runToolImpl(name, args) {
   }
 }
 var runTool = runToolImpl;
+function isToolName(name) {
+  return Object.values(TOOL_NAMES).includes(name);
+}
 
 // src/install/install.ts
 init_dist();
@@ -1248,6 +1320,21 @@ async function runDoctor() {
 
 // src/release-notes.ts
 var RELEASE_NOTES = {
+  "0.5.17": [
+    "Force-visible on attach (default-on). Modern SPAs (Cloudflare dashboard, Linear, Notion) gate their JS on `document.visibilityState` and stall on backgrounded tabs \u2014 chrome-relay's whole pitch is operate-without-stealing-focus, and that pitch silently broke whenever the page was visibility-gated. Fix runs three CDP calls on every attach: `Page.setWebLifecycleState({state:'active'})` to stop Chrome's rAF/timer throttling, plus a JS shim (installed via `Page.addScriptToEvaluateOnNewDocument` AND `Runtime.evaluate`) that overrides `document.visibilityState` / `document.hidden` so the page's own checks see 'visible.'",
+    "Scoped to debugger-attached tabs only \u2014 other tabs the user has open stay normally throttled. Override clears when chrome-relay detaches. User's viewport never changes.",
+    "Behavioral guidance: never call `chrome-relay switch` to make a backgrounded SPA render \u2014 it stalls because of visibility gating, not chrome-relay. The new attach behavior fixes it invisibly.",
+    "Tests: +4 in apps/extension/test/force-visibility.test.ts. Total 426 (was 422)."
+  ],
+  "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 +1685,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 +1942,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 +2071,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 +2132,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 +2143,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.17" : "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.17" : "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.17",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",