chrome-relay 0.5.0 → 0.5.2

package/dist/cli.js

@@ -5,7 +5,7 @@ import { Command } from "commander";
 import { writeFileSync } from "fs";
 
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.5.0" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.5.2" : "0.0.0-dev";
 
 // src/install/install.ts
 import os from "os";
@@ -130,7 +130,14 @@ async function runDoctor() {
 }
 
 // src/client/call.ts
-async function callTool(name, args) {
+var noticePrinted = false;
+function emitNoticeOnce(notice) {
+  if (noticePrinted) return;
+  noticePrinted = true;
+  process.stderr.write(`[chrome-relay] ${notice}
+`);
+}
+async function callToolWithMeta(name, args) {
   const response = await fetch(`http://127.0.0.1:${DEFAULT_HTTP_PORT}/call`, {
     method: "POST",
     headers: {
@@ -143,12 +150,58 @@ async function callTool(name, args) {
   });
   const payload = await response.json().catch(() => null);
   if (!response.ok) {
+    if (payload?.notice) emitNoticeOnce(payload.notice);
     throw new Error(payload?.error || `Bridge request failed with ${response.status}`);
   }
   if (!payload?.ok) {
+    if (payload?.notice) emitNoticeOnce(payload.notice);
     throw new Error(payload?.error || "Bridge call failed.");
   }
-  return payload.data;
+  if (payload.notice) emitNoticeOnce(payload.notice);
+  return { data: payload.data, notice: payload.notice };
+}
+async function callTool(name, args) {
+  const { data } = await callToolWithMeta(name, args);
+  return data;
+}
+
+// src/release-notes.ts
+var RELEASE_NOTES = {
+  "0.5.2": [
+    "Strict input parsers (code-quality-hardening PR 0). Invalid console levels, network status filters, tab-group colors, and tab-id lists now throw instead of being silently dropped \u2014 an agent that asks for `errors` (typo of `error`) gets a precise error rather than all levels back.",
+    "Affected tools: chrome_console (levels), chrome_network (status), chrome_group (color, tabIds), chrome_screencast (format, action), chrome_network (action).",
+    "Parsers moved to apps/extension/src/browser/parsers.ts (pure module, no chrome runtime imports) so they're directly unit-testable. 24 new tests cover the strict paths."
+  ],
+  "0.5.1": [
+    "Tool results now carry a `notice` field when the CLI is older than the connected extension \u2014 agents (or humans) get a structured nudge to run `chrome-relay update`.",
+    "New subcommand: `chrome-relay update` \u2014 installs the latest CLI via your package manager and prints what changed.",
+    "New subcommand: `chrome-relay release-notes --since <version>` \u2014 query the same change log without updating."
+  ],
+  "0.5.0": [
+    "New tool: `chrome_hover` \u2014 `Input.dispatchMouseEvent mouseMoved` at a selector or x,y. Fires :hover, :focus-within, tooltips, dropdown openers without clicking.",
+    "New tool: `chrome_screencast` \u2014 paint-driven CDP recording. Catches CSS transitions, fade-ins, and animation mid-states that screenshot polling misses. Requires the tab to be active.",
+    "`chrome-relay screencast {start,stop}` CLI with default-on SHA-256 dedupe (--no-dedupe to keep raw frames) and --gif/--mp4 ffmpeg post-step.",
+    "JPEG default quality bumped 60 \u2192 80 for max precision. See docs/recording.md."
+  ],
+  "0.4.0": [
+    "BREAKING: `chrome_group` repurposed for Chrome's native tab-groups (the colored, collapsible folders). Old isolation-window semantics moved to `chrome_workspace`.",
+    "New CLI: `chrome-relay workspace {create,list,close}` for parallel agent isolation (named background windows).",
+    "New CLI: `chrome-relay group {create,list,close,add,remove}` for visual tab-grouping inside a single window."
+  ]
+};
+function compareSemver(a, b) {
+  const pa = a.split(".").map((n) => Number(n) || 0);
+  const pb = b.split(".").map((n) => Number(n) || 0);
+  for (let i = 0; i < 3; i++) {
+    const ai = pa[i] ?? 0;
+    const bi = pb[i] ?? 0;
+    if (ai > bi) return 1;
+    if (ai < bi) return -1;
+  }
+  return 0;
+}
+function listReleaseNotesSince(since) {
+  return Object.keys(RELEASE_NOTES).filter((v) => compareSemver(v, since) > 0).sort((a, b) => compareSemver(a, b)).map((version) => ({ version, bullets: RELEASE_NOTES[version] }));
 }
 
 // src/program.ts
@@ -181,6 +234,43 @@ Notes:
     const ok = await runDoctor();
     process.exit(ok ? 0 : 1);
   });
+  program.command("update").description("Update chrome-relay CLI to the latest version and print what changed (agent-readable JSON).").option("--dry-run", "skip the install; just show what changed since the current version").action(async (opts) => {
+    const fromVersion = CHROME_RELAY_VERSION;
+    const { spawnSync } = await import("child_process");
+    if (!opts.dryRun) {
+      const argv0 = process.argv[1] ?? "";
+      const pm = /[\\/](pnpm|\.pnpm)[\\/]/.test(argv0) ? "pnpm" : /[\\/]bun[\\/]/.test(argv0) ? "bun" : "npm";
+      const cmd = pm === "pnpm" ? ["pnpm", ["add", "-g", "chrome-relay@latest"]] : pm === "bun" ? ["bun", ["add", "-g", "chrome-relay@latest"]] : ["npm", ["install", "-g", "chrome-relay@latest"]];
+      process.stderr.write(`[chrome-relay] updating from ${fromVersion} via ${pm}...
+`);
+      const install = spawnSync(cmd[0], cmd[1], { stdio: "inherit" });
+      if (install.status !== 0) {
+        process.stderr.write(`[chrome-relay] install failed (${pm} exited ${install.status}). Try manually: ${pm} ${cmd[1].join(" ")}
+`);
+        process.exit(1);
+      }
+      const which = spawnSync("which", ["chrome-relay"]);
+      const newBin = which.stdout?.toString().trim();
+      if (which.status === 0 && newBin && newBin !== argv0) {
+        spawnSync(newBin, ["release-notes", "--since", fromVersion], { stdio: "inherit" });
+        return;
+      }
+    }
+    const changes = listReleaseNotesSince(fromVersion);
+    process.stdout.write(JSON.stringify({
+      updatedFrom: fromVersion,
+      updatedTo: CHROME_RELAY_VERSION,
+      changes
+    }, null, 2) + "\n");
+  });
+  program.command("release-notes").description("Print release notes since a version (no install). JSON output for agents.").option("--since <version>", "show release notes for versions newer than this", "0.0.0").action((opts) => {
+    const changes = listReleaseNotesSince(opts.since);
+    process.stdout.write(JSON.stringify({
+      currentVersion: CHROME_RELAY_VERSION,
+      since: opts.since,
+      changes
+    }, null, 2) + "\n");
+  });
   async function run(name, args) {
     try {
       const result = await callTool(name, args);

package/dist/index.js

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

package/dist/native-host.js

@@ -9,7 +9,29 @@ import Fastify from "fastify";
 // ../protocol/dist/index.js
 var DEFAULT_HTTP_PORT = 12122;
 
+// src/index.ts
+var CHROME_RELAY_VERSION = true ? "0.5.2" : "0.0.0-dev";
+
+// src/release-notes.ts
+function compareSemver(a, b) {
+  const pa = a.split(".").map((n) => Number(n) || 0);
+  const pb = b.split(".").map((n) => Number(n) || 0);
+  for (let i = 0; i < 3; i++) {
+    const ai = pa[i] ?? 0;
+    const bi = pb[i] ?? 0;
+    if (ai > bi) return 1;
+    if (ai < bi) return -1;
+  }
+  return 0;
+}
+
 // src/http/server.ts
+function buildOutdatedNotice(bridge2) {
+  const extVersion = bridge2.getExtensionVersion();
+  if (!extVersion) return void 0;
+  if (compareSemver(CHROME_RELAY_VERSION, extVersion) >= 0) return void 0;
+  return `cli-outdated: ${CHROME_RELAY_VERSION} < extension ${extVersion}; run \`chrome-relay update\``;
+}
 var RelayHttpServer = class {
   constructor(bridge2, port = DEFAULT_HTTP_PORT) {
     this.bridge = bridge2;
@@ -19,7 +41,12 @@ var RelayHttpServer = class {
   port;
   app = Fastify({ logger: false });
   async start() {
-    this.app.get("/ping", async () => ({ ok: true, port: this.port }));
+    this.app.get("/ping", async () => ({
+      ok: true,
+      port: this.port,
+      cliVersion: CHROME_RELAY_VERSION,
+      extensionVersion: this.bridge.getExtensionVersion() ?? null
+    }));
     this.app.post("/call", async (request, reply) => {
       if (request.headers.origin) {
         reply.code(403).send({ error: "Browser-origin bridge requests are not accepted." });
@@ -35,12 +62,16 @@ var RelayHttpServer = class {
           body.name,
           body.args ?? {}
         );
-        reply.send({ ok: true, data });
+        const notice = buildOutdatedNotice(this.bridge);
+        reply.send(notice ? { ok: true, data, notice } : { ok: true, data });
       } catch (error) {
-        reply.code(500).send({
+        const notice = buildOutdatedNotice(this.bridge);
+        const body2 = {
           ok: false,
           error: error instanceof Error ? error.message : String(error)
-        });
+        };
+        if (notice) body2.notice = notice;
+        reply.code(500).send(body2);
       }
     });
     await this.app.listen({ port: this.port, host: "127.0.0.1" });
@@ -60,6 +91,12 @@ var ExtensionBridge = class {
   pending = /* @__PURE__ */ new Map();
   readyWaiters = /* @__PURE__ */ new Set();
   ready = false;
+  // Extension version captured from `bridge.ready`. Read by the HTTP server
+  // to compute the cli-outdated notice on each tool call.
+  extensionVersion;
+  getExtensionVersion() {
+    return this.extensionVersion;
+  }
   handleMessage(message) {
     if (message.type === "bridge.ready") {
       this.handleReady(message);
@@ -79,8 +116,9 @@ var ExtensionBridge = class {
       pending.resolve(true);
     }
   }
-  handleReady(_message) {
+  handleReady(message) {
     this.ready = true;
+    this.extensionVersion = message.payload?.version;
     for (const notify of this.readyWaiters) {
       notify();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-relay",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",