rechrome 1.1.0 → 1.3.0

package/.env.example

@@ -1,9 +1,6 @@
 # Remote Chrome connection URL (auto-generated by `rech serve` if not set)
 # REMOTE_CHROME_URL=remote-chrome://key@host:13775
 
-# Gemini API key for screenshot vision descriptions (optional)
-# GEMINI_API_KEY=your-gemini-api-key
-
 # Custom playwright-cli binary path (default: playwright-cli)
 # For full multi-tab & multi-session support, use playwright-cli-multi-tab:
 # PLAYWRIGHT_CLI=playwright-cli-multi-tab

package/README.md

@@ -10,7 +10,6 @@ Built on top of [playwright-multi-tab](https://github.com/snomiao/playwright-mul
 
 - **Session isolation** — clients are automatically namespaced by git repo or hostname
 - **File transfer** — screenshots and PDFs are automatically downloaded to the client
-- **Vision descriptions** — optional Gemini-powered screenshot descriptions
 - **Hot-reload config** — `.env.local` changes are picked up without restart
 - **Security** — bearer auth, path traversal protection, env allowlisting for child processes
 
@@ -76,14 +75,13 @@ Copy `.env.example` to `.env.local` and edit:
 cp .env.example .env.local
 ```
 
-| Variable | Description | Default |
-|---|---|---|
-| `REMOTE_CHROME_URL` | Connection URL (auto-generated by `rechrome serve`) | — |
-| `GEMINI_API_KEY` | Gemini API key for screenshot vision descriptions | — |
-| `PLAYWRIGHT_CLI` | Path to playwright-cli binary (recommended: `playwright-cli-multi-tab` for full multi-tab support) | `playwright-cli` |
-| `RECH_HOST` | Server bind address | `127.0.0.1` |
-| `PLAYWRIGHT_MCP_EXTENSION_ID` | Chrome extension ID (client overrides server) | — |
-| `PLAYWRIGHT_MCP_EXTENSION_TOKEN` | Chrome extension token (client overrides server) | — |
+| Variable                         | Description                                                                                        | Default          |
+| -------------------------------- | -------------------------------------------------------------------------------------------------- | ---------------- |
+| `REMOTE_CHROME_URL`              | Connection URL (auto-generated by `rechrome serve`)                                                | —                |
+| `PLAYWRIGHT_CLI`                 | Path to playwright-cli binary (recommended: `playwright-cli-multi-tab` for full multi-tab support) | `playwright-cli` |
+| `RECH_HOST`                      | Server bind address                                                                                | `127.0.0.1`      |
+| `PLAYWRIGHT_MCP_EXTENSION_ID`    | Chrome extension ID (client overrides server)                                                      | —                |
+| `PLAYWRIGHT_MCP_EXTENSION_TOKEN` | Chrome extension token (client overrides server)                                                   | —                |
 
 ### Remote access
 

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "rechrome",
-  "version": "1.1.0",
-  "type": "module",
+  "version": "1.3.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/snomiao/rechrome.git"
@@ -10,6 +9,16 @@
     "rech": "./rech.js",
     "rechrome": "./rech.js"
   },
+  "files": [
+    ".env.example",
+    "LICENSE",
+    "README.md",
+    "rech.js",
+    "rech.ts",
+    "serve.js",
+    "serve.ts"
+  ],
+  "type": "module",
   "scripts": {
     "serve": "bun run rech.ts serve",
     "test": "bun test",
@@ -22,14 +31,5 @@
     "branches": [
       "main"
     ]
-  },
-  "files": [
-    "rech.ts",
-    "rech.js",
-    "serve.ts",
-    "serve.js",
-    ".env.example",
-    "README.md",
-    "LICENSE"
-  ]
+  }
 }

package/rech.js

@@ -35,40 +35,6 @@ if (existsSync(envFile)) {
   });
 }
 
-/** Describe an image using Gemini vision API. Returns description or null on failure. */
-export async function describeImage(imagePath: string): Promise<string | null> {
-  const apiKey = process.env.GEMINI_API_KEY;
-  if (!apiKey) return null;
-  try {
-    const imageData = await file(imagePath).arrayBuffer();
-    const base64 = Buffer.from(imageData).toString("base64");
-    const mimeType = imagePath.endsWith(".png") ? "image/png" : "image/jpeg";
-    const res = await fetch(
-      `https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-pro-preview:generateContent?key=${apiKey}`,
-      {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          contents: [
-            {
-              parts: [
-                {
-                  text: "Describe this browser screenshot concisely in 2-3 sentences. Focus on what's visible: page layout, content, any errors or issues.",
-                },
-                { inline_data: { mime_type: mimeType, data: base64 } },
-              ],
-            },
-          ],
-        }),
-      },
-    );
-    if (!res.ok) return null;
-    const json = await res.json();
-    return json.candidates?.[0]?.content?.parts?.[0]?.text?.trim() ?? null;
-  } catch {
-    return null;
-  }
-}
 
 export const PASSTHROUGH_ENV_KEYS = [
   "PLAYWRIGHT_MCP_EXTENSION_ID",
@@ -141,7 +107,12 @@ async function getClientIdentity(): Promise<{ gitUrl?: string; hostname?: string
       }
       if (branch) gitUrl += `/tree/${branch}`;
       // Strip any embedded credentials from the URL
-      try { const u = new URL(gitUrl); u.username = ""; u.password = ""; gitUrl = u.toString(); } catch {}
+      try {
+        const u = new URL(gitUrl);
+        u.username = "";
+        u.password = "";
+        gitUrl = u.toString();
+      } catch {}
       return { gitUrl };
     }
   } catch {}
@@ -158,6 +129,7 @@ function getClientEnv(): Record<string, string> {
 
 async function run(url: string, args: string[]) {
   const { key, host, port } = parseUrl(url);
+
   const identity = await getClientIdentity();
   console.error(
     `[rech] connecting to ${host}:${port} (identity: ${identity.gitUrl || `${identity.hostname}:${identity.cwd}`})`,
@@ -177,12 +149,11 @@ async function run(url: string, args: string[]) {
     process.exit(1);
   }
 
-  const { status, stdout, stderr, files, descriptions, existingSession } = (await res.json()) as {
+  const { status, stdout, stderr, files, existingSession } = (await res.json()) as {
     status: number;
     stdout: string;
     stderr: string;
     files?: string[];
-    descriptions?: Record<string, string>;
     existingSession?: boolean;
   };
 
@@ -207,9 +178,6 @@ async function run(url: string, args: string[]) {
       const dest = join(dlDir, basename(name));
       await Bun.write(dest, fileRes);
       console.error(`[rech] downloaded: ${dest}`);
-      if (descriptions?.[name]) {
-        console.error(`[rech] vision: ${descriptions[name]}`);
-      }
     }
   }
 

package/rech.ts

@@ -35,40 +35,6 @@ if (existsSync(envFile)) {
   });
 }
 
-/** Describe an image using Gemini vision API. Returns description or null on failure. */
-export async function describeImage(imagePath: string): Promise<string | null> {
-  const apiKey = process.env.GEMINI_API_KEY;
-  if (!apiKey) return null;
-  try {
-    const imageData = await file(imagePath).arrayBuffer();
-    const base64 = Buffer.from(imageData).toString("base64");
-    const mimeType = imagePath.endsWith(".png") ? "image/png" : "image/jpeg";
-    const res = await fetch(
-      `https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-pro-preview:generateContent?key=${apiKey}`,
-      {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          contents: [
-            {
-              parts: [
-                {
-                  text: "Describe this browser screenshot concisely in 2-3 sentences. Focus on what's visible: page layout, content, any errors or issues.",
-                },
-                { inline_data: { mime_type: mimeType, data: base64 } },
-              ],
-            },
-          ],
-        }),
-      },
-    );
-    if (!res.ok) return null;
-    const json = await res.json();
-    return json.candidates?.[0]?.content?.parts?.[0]?.text?.trim() ?? null;
-  } catch {
-    return null;
-  }
-}
 
 export const PASSTHROUGH_ENV_KEYS = [
   "PLAYWRIGHT_MCP_EXTENSION_ID",
@@ -141,7 +107,12 @@ async function getClientIdentity(): Promise<{ gitUrl?: string; hostname?: string
       }
       if (branch) gitUrl += `/tree/${branch}`;
       // Strip any embedded credentials from the URL
-      try { const u = new URL(gitUrl); u.username = ""; u.password = ""; gitUrl = u.toString(); } catch {}
+      try {
+        const u = new URL(gitUrl);
+        u.username = "";
+        u.password = "";
+        gitUrl = u.toString();
+      } catch {}
       return { gitUrl };
     }
   } catch {}
@@ -158,6 +129,7 @@ function getClientEnv(): Record<string, string> {
 
 async function run(url: string, args: string[]) {
   const { key, host, port } = parseUrl(url);
+
   const identity = await getClientIdentity();
   console.error(
     `[rech] connecting to ${host}:${port} (identity: ${identity.gitUrl || `${identity.hostname}:${identity.cwd}`})`,
@@ -177,12 +149,11 @@ async function run(url: string, args: string[]) {
     process.exit(1);
   }
 
-  const { status, stdout, stderr, files, descriptions, existingSession } = (await res.json()) as {
+  const { status, stdout, stderr, files, existingSession } = (await res.json()) as {
     status: number;
     stdout: string;
     stderr: string;
     files?: string[];
-    descriptions?: Record<string, string>;
     existingSession?: boolean;
   };
 
@@ -207,9 +178,6 @@ async function run(url: string, args: string[]) {
       const dest = join(dlDir, basename(name));
       await Bun.write(dest, fileRes);
       console.error(`[rech] downloaded: ${dest}`);
-      if (descriptions?.[name]) {
-        console.error(`[rech] vision: ${descriptions[name]}`);
-      }
     }
   }
 

package/serve.js

@@ -2,7 +2,14 @@ import { file } from "bun";
 import { createHash } from "crypto";
 import { mkdirSync } from "fs";
 import { join, resolve, relative, isAbsolute } from "path";
-import { log, parseUrl, getOrCreateUrl, authCheck, describeImage, RECH_DIR, PASSTHROUGH_ENV_KEYS } from "./rech.js";
+import {
+  log,
+  parseUrl,
+  getOrCreateUrl,
+  authCheck,
+  RECH_DIR,
+  PASSTHROUGH_ENV_KEYS,
+} from "./rech.js";
 
 export function isUnderDir(base: string, candidate: string): boolean {
   const absBase = resolve(base) + "/";
@@ -192,22 +199,12 @@ export async function serve() {
         }
       }
 
-      // Auto-describe screenshot files with Gemini vision
-      const descriptions: Record<string, string> = {};
-      for (const f of outputFiles) {
-        if (/\.(?:png|jpe?g)$/i.test(f)) {
-          const desc = await describeImage(join(workDir, f));
-          if (desc) descriptions[f] = desc;
-        }
-      }
-
       const rebrand = (s: string) => s.replaceAll("npx playwright-cli", "rech");
       return Response.json({
         status,
         stdout: rebrand(stdout),
         stderr: rebrand(stderr),
         files: outputFiles,
-        descriptions,
       });
     },
   });

package/serve.ts

@@ -2,7 +2,14 @@ import { file } from "bun";
 import { createHash } from "crypto";
 import { mkdirSync } from "fs";
 import { join, resolve, relative, isAbsolute } from "path";
-import { log, parseUrl, getOrCreateUrl, authCheck, describeImage, RECH_DIR, PASSTHROUGH_ENV_KEYS } from "./rech.ts";
+import {
+  log,
+  parseUrl,
+  getOrCreateUrl,
+  authCheck,
+  RECH_DIR,
+  PASSTHROUGH_ENV_KEYS,
+} from "./rech.ts";
 
 export function isUnderDir(base: string, candidate: string): boolean {
   const absBase = resolve(base) + "/";
@@ -192,22 +199,12 @@ export async function serve() {
         }
       }
 
-      // Auto-describe screenshot files with Gemini vision
-      const descriptions: Record<string, string> = {};
-      for (const f of outputFiles) {
-        if (/\.(?:png|jpe?g)$/i.test(f)) {
-          const desc = await describeImage(join(workDir, f));
-          if (desc) descriptions[f] = desc;
-        }
-      }
-
       const rebrand = (s: string) => s.replaceAll("npx playwright-cli", "rech");
       return Response.json({
         status,
         stdout: rebrand(stdout),
         stderr: rebrand(stderr),
         files: outputFiles,
-        descriptions,
       });
     },
   });