chrome-relay 0.5.9 → 0.5.11

package/dist/cli.js

@@ -1,50 +1,142 @@
 #!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// ../protocol/dist/index.js
+var dist_exports = {};
+__export(dist_exports, {
+  CHROME_WEB_STORE_EXTENSION_ID: () => CHROME_WEB_STORE_EXTENSION_ID,
+  DEFAULT_EXTENSION_ID: () => DEFAULT_EXTENSION_ID,
+  DEFAULT_EXTENSION_IDS: () => DEFAULT_EXTENSION_IDS,
+  DEFAULT_HTTP_PORT: () => DEFAULT_HTTP_PORT,
+  LEGACY_DEV_EXTENSION_ID: () => LEGACY_DEV_EXTENSION_ID,
+  LOCAL_UNPACKED_EXTENSION_ID: () => LOCAL_UNPACKED_EXTENSION_ID,
+  NATIVE_HOST_NAME: () => NATIVE_HOST_NAME,
+  RelayError: () => RelayError,
+  TOOL_NAMES: () => TOOL_NAMES,
+  toBridgeError: () => toBridgeError
+});
+function toBridgeError(unknownErr, fallbackTool) {
+  if (unknownErr instanceof RelayError) {
+    const e = unknownErr.toBridgeError();
+    return fallbackTool && !e.tool ? { ...e, tool: fallbackTool } : e;
+  }
+  const message = unknownErr instanceof Error ? unknownErr.message : String(unknownErr);
+  return {
+    code: "internal_error",
+    message,
+    ...fallbackTool ? { tool: fallbackTool } : {}
+  };
+}
+var NATIVE_HOST_NAME, DEFAULT_HTTP_PORT, CHROME_WEB_STORE_EXTENSION_ID, LEGACY_DEV_EXTENSION_ID, LOCAL_UNPACKED_EXTENSION_ID, DEFAULT_EXTENSION_ID, DEFAULT_EXTENSION_IDS, TOOL_NAMES, RelayError;
+var init_dist = __esm({
+  "../protocol/dist/index.js"() {
+    "use strict";
+    NATIVE_HOST_NAME = "dev.chrome_relay.native_host";
+    DEFAULT_HTTP_PORT = 12122;
+    CHROME_WEB_STORE_EXTENSION_ID = "cpdiapbifblhlcpnmlmfpgfjlacebokb";
+    LEGACY_DEV_EXTENSION_ID = "cdmmkpadhnpcfjljhgpdnnljhjafmhop";
+    LOCAL_UNPACKED_EXTENSION_ID = "cleiodnaklknhhfopegimjelfibjmbkc";
+    DEFAULT_EXTENSION_ID = CHROME_WEB_STORE_EXTENSION_ID;
+    DEFAULT_EXTENSION_IDS = [
+      CHROME_WEB_STORE_EXTENSION_ID,
+      LEGACY_DEV_EXTENSION_ID,
+      LOCAL_UNPACKED_EXTENSION_ID
+    ];
+    TOOL_NAMES = {
+      GET_WINDOWS_AND_TABS: "get_windows_and_tabs",
+      NAVIGATE: "chrome_navigate",
+      SWITCH_TAB: "chrome_switch_tab",
+      CLOSE_TABS: "chrome_close_tabs",
+      SCREENSHOT: "chrome_screenshot",
+      READ_PAGE: "chrome_read_page",
+      CLICK: "chrome_click_element",
+      FILL: "chrome_fill_or_select",
+      KEYBOARD: "chrome_keyboard",
+      TYPE: "chrome_type",
+      EVALUATE: "chrome_evaluate",
+      // §2.2 — viewport emulation (set/preset/clear share one tool, action via args.action)
+      VIEWPORT: "chrome_viewport",
+      // chrome_self_reload — calls chrome.runtime.reload() inside the extension.
+      // Lets the dev loop refresh the extension without manually clicking reload
+      // on chrome://extensions (Chrome blocks CDP attach on chrome:// pages).
+      SELF_RELOAD: "chrome_self_reload",
+      // §2.7c — console capture. Ring-buffer per tab; actions read/clear via args.
+      CONSOLE: "chrome_console",
+      // Workspaces — named Chrome windows for parallel agent work. Single tool
+      // with action: create | list | close. Every existing tool also accepts an
+      // optional workspaceName arg that routes ops into that workspace's window.
+      // (Was "chrome_group" pre-0.4.0; renamed because "group" collides with
+      // Chrome's own tab-group UI primitive, which is now exposed separately.)
+      WORKSPACE: "chrome_workspace",
+      // Tab groups — Chrome's native colored, collapsible folder of tabs inside
+      // a single window. Single tool with action: create | list | close | add | remove.
+      // Every existing tool also accepts an optional groupName arg that routes
+      // ops to a tab inside that tab-group.
+      GROUP: "chrome_group",
+      // §2.4 — accessibility tree. ~30× smaller than DOM serialization, more
+      // semantic. click_ax pairs with it: targets by backendDOMNodeId, no CSS.
+      AX: "chrome_ax",
+      CLICK_AX: "chrome_click_ax",
+      // §2.7a — network capture. Ring-buffer per tab; actions read/clear/har/body.
+      NETWORK: "chrome_network",
+      // Hover — dispatches mouseMoved at element center (or x,y) so :hover/
+      // :focus-within styles fire before a click or screencast frame is read.
+      HOVER: "chrome_hover",
+      // Screencast — wraps CDP Page.startScreencast / stopScreencast. SW buffers
+      // base64 JPEG frames per tab between start and stop. Paint-driven (catches
+      // CSS transitions, fade-ins, focus-ring motion) — at the cost of requiring
+      // the tab to be ACTIVE (Chrome doesn't paint backgrounded tabs). See
+      // docs/recording.md for the active-tab matrix.
+      SCREENCAST: "chrome_screencast"
+    };
+    RelayError = class extends Error {
+      code;
+      tool;
+      phase;
+      details;
+      retryable;
+      constructor(spec) {
+        super(spec.message);
+        this.name = "RelayError";
+        this.code = spec.code;
+        this.tool = spec.tool;
+        this.phase = spec.phase;
+        this.details = spec.details;
+        this.retryable = spec.retryable;
+      }
+      toBridgeError() {
+        return {
+          code: this.code,
+          message: this.message,
+          ...this.tool ? { tool: this.tool } : {},
+          ...this.phase ? { phase: this.phase } : {},
+          ...this.details ? { details: this.details } : {},
+          ...this.retryable !== void 0 ? { retryable: this.retryable } : {}
+        };
+      }
+    };
+  }
+});
 
 // src/program.ts
 import { Command } from "commander";
 
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.5.9" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.5.11" : "0.0.0-dev";
 
-// ../protocol/dist/index.js
-var NATIVE_HOST_NAME = "dev.chrome_relay.native_host";
-var DEFAULT_HTTP_PORT = 12122;
-var CHROME_WEB_STORE_EXTENSION_ID = "cpdiapbifblhlcpnmlmfpgfjlacebokb";
-var LEGACY_DEV_EXTENSION_ID = "cdmmkpadhnpcfjljhgpdnnljhjafmhop";
-var LOCAL_UNPACKED_EXTENSION_ID = "cleiodnaklknhhfopegimjelfibjmbkc";
-var DEFAULT_EXTENSION_IDS = [
-  CHROME_WEB_STORE_EXTENSION_ID,
-  LEGACY_DEV_EXTENSION_ID,
-  LOCAL_UNPACKED_EXTENSION_ID
-];
-var RelayError = class extends Error {
-  code;
-  tool;
-  phase;
-  details;
-  retryable;
-  constructor(spec) {
-    super(spec.message);
-    this.name = "RelayError";
-    this.code = spec.code;
-    this.tool = spec.tool;
-    this.phase = spec.phase;
-    this.details = spec.details;
-    this.retryable = spec.retryable;
-  }
-  toBridgeError() {
-    return {
-      code: this.code,
-      message: this.message,
-      ...this.tool ? { tool: this.tool } : {},
-      ...this.phase ? { phase: this.phase } : {},
-      ...this.details ? { details: this.details } : {},
-      ...this.retryable !== void 0 ? { retryable: this.retryable } : {}
-    };
-  }
-};
+// src/commands/shared.ts
+init_dist();
 
 // src/client/call.ts
+init_dist();
 var noticePrinted = false;
 function emitNoticeOnce(notice) {
   if (noticePrinted) return;
@@ -162,6 +254,7 @@ async function runToolImpl(name, args) {
 var runTool = runToolImpl;
 
 // src/install/install.ts
+init_dist();
 import os from "os";
 import path from "path";
 import { chmod, mkdir, readFile, stat, writeFile } from "fs/promises";
@@ -271,6 +364,17 @@ async function runDoctor() {
 
 // src/release-notes.ts
 var RELEASE_NOTES = {
+  "0.5.11": [
+    "Tests-only: 6 new edge-case tests for `chrome-relay update`. Covers --dry-run, install failure, install-success-but-binary-version-unchanged (PATH mismatch / stale shim), install-success-but-which-fails, install-success-but-release-notes-parse-fails, and the happy path. Locks in the structured-metadata contract from 0.5.7.",
+    "Total tests now 378 (was 372)."
+  ],
+  "0.5.10": [
+    "Direct /call target conflict enforcement. Third-party callers posting to /call with multiple loose target fields (tabId + workspaceName, etc.) now throw `target_conflict` instead of silently applying precedence. Matches the CLI rule the CLI itself enforced since 0.5.4.",
+    "All useful plain Error throws in extension handlers converted to RelayError(invalid_arguments). Affected tools: chrome_click_element, chrome_fill_or_select, chrome_keyboard, chrome_type, chrome_evaluate, chrome_switch_tab, chrome_close_tabs, chrome_viewport (preset name + width/height), chrome_workspace (create/close), chrome_group (create/close/add/remove), chrome_network (body without --request-id), chrome_hover (no selector or x,y), chrome_click_ax (no --node), and bbox parser. Agents can now branch on `errorDetails.code === 'invalid_arguments'` for all of these.",
+    "chrome_hover with a selector that doesn't match now throws RelayError(`element_not_found`) (was plain Error).",
+    "BEHAVIOR CHANGE \u2014 `chrome-relay screencast stop --gif/--mp4` is no longer best-effort when ffmpeg is missing. Old behavior printed 'skipping' and exited 0 (agent saw success but no GIF existed). New behavior throws `external_dependency_missing` with exit 1. Pass `--allow-missing-ffmpeg` to restore the legacy skip-with-warning behavior.",
+    "Tests: +17 in handler-strict.test.ts covering the conflict + 13 missing-arg paths. Total now 372."
+  ],
   "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.",
@@ -728,7 +832,7 @@ Notes:
     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")
+    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 (requires ffmpeg on PATH)").option("--mp4", "after writing frames, ffmpeg them into <dir>.mp4 (requires ffmpeg on PATH)").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").option("--allow-missing-ffmpeg", "with --gif/--mp4: skip ffmpeg step (and emit a warning) if ffmpeg isn't on PATH, instead of failing with external_dependency_missing")
   ).action(async (opts) => {
     const args = { action: "stop" };
     Object.assign(args, baseArgs(opts));
@@ -790,8 +894,22 @@ Notes:
         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.allowMissingFfmpeg) {
+            process.stderr.write("[chrome-relay] ffmpeg not on PATH \u2014 skipping --gif/--mp4 (allow-missing-ffmpeg).\n");
+            return;
+          }
+          const { RelayError: RelayError2 } = await Promise.resolve().then(() => (init_dist(), dist_exports));
+          const err = new RelayError2({
+            code: "external_dependency_missing",
+            message: "chrome-relay screencast stop --gif/--mp4 requires ffmpeg on PATH. Install ffmpeg (brew install ffmpeg) or pass --allow-missing-ffmpeg to skip the stitch step with a warning.",
+            tool: "chrome_screencast",
+            phase: "ffmpeg_stitch",
+            details: { dependency: "ffmpeg", outputs: { gif: !!opts.gif, mp4: !!opts.mp4 } },
+            retryable: false
+          });
+          process.stderr.write(err.message + "\n");
+          process.stderr.write(JSON.stringify({ relayError: err.toBridgeError() }, null, 2) + "\n");
+          process.exit(1);
         }
         if (opts.gif) {
           const gifOut = `${opts.out.replace(/\/$/, "")}.gif`;

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.5.9" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.5.11" : "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.9" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.5.11" : "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.9",
+  "version": "0.5.11",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",