pw-repl 0.12.2 → 0.12.4

package/README.md

@@ -8,10 +8,10 @@ in one it starts itself. You type commands at a `pw>` prompt. Agents send the sa
 with `pw-repl send`. Every command shows in the REPL, whoever sent it, so you always see what an agent
 is doing in your browser, and the agent can see what you did.
 
-[![pw-repl demo, recorded by pw-repl](docs/pw-repl-demo.png)](docs/pw-repl-demo.webm)
+[![pw-repl demo, recorded by pw-repl](docs/pw-repl-demo.webp)](https://github.com/user-attachments/assets/c4114933-8ef2-455e-bc9e-1dd6f1fe9c07)
 
-A 90-second demo (click to play), recorded by pw-repl itself from one script of commands. The command
-panel on the right is part of the demo page, showing what the agent sends.
+A 90-second demo, recorded by pw-repl itself from one script of commands. The command panel on the
+right is part of the demo page, showing what the agent sends.
 
 ```text
 pw> tab new http://localhost:3000/cart

package/lib/help.js

@@ -573,7 +573,8 @@ A (page) line marks each new page, loaded or routed to by a single-page app. It
 video.
 
 ffmpeg: $PW_FFMPEG, and only it when it is set (the REPL's, not send's); otherwise Playwright's own (npx
-playwright-core install ffmpeg, in $PLAYWRIGHT_BROWSERS_PATH or ~/.cache/ms-playwright), then one on the
+playwright-core install ffmpeg, in $PLAYWRIGHT_BROWSERS_PATH, or ~/.cache/ms-playwright on Linux and
+~/Library/Caches/ms-playwright on macOS), then one on the
 PATH. Playwright's writes only WebM; an MP4 needs a system ffmpeg with H.264. Without one that can write
 the format, record on fails at once, recording nothing. WebM plays in browsers, GitHub, GitLab and Slack;
 MP4 everywhere. About 15 MB a minute.`,

package/lib/launch.js

@@ -6,6 +6,7 @@ const { spawn } = require('child_process');
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
+const { playwrightBrowsersDir } = require('./util');
 
 const START_TIMEOUT = 20000;
 // Stopping: a moment to connect and ask it to close, a few seconds to close, as long again after SIGTERM,
@@ -31,11 +32,14 @@ function findChrome() {
     if (fs.existsSync(bundled)) return bundled;
   } catch {}
   // Any Chromium works over CDP, so a revision other than this Playwright's is fine.
-  const dir = process.env.PLAYWRIGHT_BROWSERS_PATH || path.join(os.homedir(), '.cache', 'ms-playwright');
+  const dir = playwrightBrowsersDir();
   let names = [];
   try { names = fs.readdirSync(dir).filter(n => /^chromium-\d+$/.test(n)).sort().reverse(); } catch {}
   for (const name of names) {
-    for (const sub of ['chrome-linux64/chrome', 'chrome-linux/chrome', 'chrome-mac/Chromium.app/Contents/MacOS/Chromium']) {
+    for (const sub of ['chrome-linux64/chrome', 'chrome-linux-arm64/chrome', 'chrome-linux/chrome', 'chrome-win64/chrome.exe',
+      'chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing',
+      'chrome-mac-x64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing',
+      'chrome-mac/Chromium.app/Contents/MacOS/Chromium']) {
       const candidate = path.join(dir, name, sub);
       if (fs.existsSync(candidate)) return candidate;
     }

package/lib/record.js

@@ -1,12 +1,11 @@
 // Recording a tab's page to a video, from Chrome's screencast of it through ffmpeg.
 const { spawn, execFileSync } = require('child_process');
 const fs = require('fs');
-const os = require('os');
 const path = require('path');
 const { state, onShutdown } = require('./state');
 const out = require('./output');
 const { tabState } = require('./tabstate');
-const { clock, NO_TAB, STOPPED_RECORDING, ENDED_UNSEEN } = require('./util');
+const { clock, NO_TAB, STOPPED_RECORDING, ENDED_UNSEEN, playwrightBrowsersDir } = require('./util');
 const { shellWords, splitSelector } = require('./syntax');
 const { reapplyMetrics } = require('./emulation');
 
@@ -38,7 +37,7 @@ const FORMAT_NAMES = { webm: 'WebM (VP8)', mp4: 'MP4 (H.264)' };
 // Playwright's own (wherever PLAYWRIGHT_BROWSERS_PATH puts it), then one on the PATH.
 function ffmpegCandidates() {
   const found = [];
-  const dir = process.env.PLAYWRIGHT_BROWSERS_PATH || path.join(os.homedir(), '.cache', 'ms-playwright');
+  const dir = playwrightBrowsersDir();
   let names = [];
   try { names = fs.readdirSync(dir).filter(n => /^ffmpeg-\d+$/.test(n)).sort().reverse(); } catch {}
   for (const name of names) {

package/lib/util.js

@@ -1,5 +1,8 @@
 // Small helpers the commands share: output hints, clipping, times, patterns and number arguments.
 
+const os = require('os');
+const path = require('path');
+
 const COMMAND_TIMEOUT = 15000;
 
 const MAX_EVENT_TEXT = 4000;
@@ -51,4 +54,16 @@ function clock(t) {
 const STOPPED_RECORDING = 'The REPL stopped, which ended a recording';
 const ENDED_UNSEEN = 'A recording ended before the REPL stopped, unseen since';
 
-module.exports = { STOPPED_RECORDING, ENDED_UNSEEN, COMMAND_TIMEOUT, MAX_EVENT_TEXT, NO_TAB, hints, clipText, numbers, regexOf, patternText, clock };
+// Where Playwright installs its browsers and ffmpeg, worked out as playwright-core does it: a cache of
+// each platform's own (~/Library/Caches on macOS), unless PLAYWRIGHT_BROWSERS_PATH says otherwise.
+function playwrightBrowsersDir() {
+  const given = process.env.PLAYWRIGHT_BROWSERS_PATH;
+  if (given === '0') return path.join(path.dirname(require.resolve('playwright-core/package.json')), '.local-browsers');
+  if (given) return path.resolve(process.env.INIT_CWD || process.cwd(), given);
+  const cache = process.platform === 'darwin' ? path.join(os.homedir(), 'Library', 'Caches')
+    : process.platform === 'win32' ? process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local')
+      : process.env.XDG_CACHE_HOME || path.join(os.homedir(), '.cache');
+  return path.join(cache, 'ms-playwright');
+}
+
+module.exports = { STOPPED_RECORDING, ENDED_UNSEEN, COMMAND_TIMEOUT, MAX_EVENT_TEXT, NO_TAB, hints, clipText, numbers, regexOf, patternText, clock, playwrightBrowsersDir };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pw-repl",
-  "version": "0.12.2",
+  "version": "0.12.4",
   "description": "Text REPL for driving an existing Chromium through Playwright over CDP",
   "keywords": [
     "playwright",

package/skill/SKILL.md

@@ -249,7 +249,8 @@ pw-repl send -c <name> close                        # your modes off; tab close
 - `PW_FFMPEG` — the ffmpeg `record` uses, and no other, read by the REPL, not by `send` (default:
   Playwright's own, then one on the `PATH`).
 - Playwright's own Chromium and ffmpeg are found where Playwright installs them:
-  `PLAYWRIGHT_BROWSERS_PATH`, or `~/.cache/ms-playwright`.
+  `PLAYWRIGHT_BROWSERS_PATH`, or `~/.cache/ms-playwright` on Linux and `~/Library/Caches/ms-playwright`
+  on macOS.
 - `PW_CDP_URL` — CDP endpoint (default `http://localhost:9222`).
 - `PW_SCREENSHOT_DIR` — where the REPL saves screenshots (a folder that exists), read when it starts,
   not by `send`. Without it, a REPL on a socket of its own saves them next to its socket, and any other