@volter/browser-cdp 0.1.47 → 0.1.49

package/dist/preview-cdp-endpoint.js

@@ -0,0 +1,153 @@
+import { createSocketEndpoint } from "@volter/almostcdp/socket";
+import { MessagePortTransport } from "@volter/almostcdp/message-port";
+import { createPreviewBrowserHost } from "./preview-browser-host.js";
+const REATTACH_DELAY_MS = 250;
+/**
+ * The preview as a Chrome DevTools Protocol endpoint on a loopback port of the
+ * tab. AlmostCDP serves discovery and the DevTools WebSockets on each accepted
+ * connection; the preview's surface is lent through the authenticated sandbox
+ * bridge and lent again whenever the sandbox document is replaced, which a
+ * client sees as its page target closing and a new one appearing.
+ */
+export function publishPreviewCdp(options) {
+    const { bridge, port } = options;
+    let endpoint;
+    const host = options.browser ? createPreviewBrowserHost({
+        ...options.browser,
+        attachSurface: (peer, id, signal) => attachAndAwait(endpoint, peer, id, signal),
+    }) : undefined;
+    endpoint = createSocketEndpoint({
+        address: `127.0.0.1:${port}`,
+        ...(host ? { contextHost: host.contextHost, pageHost: host.pageHost } : {}),
+        ...(options.downloads ? { downloadHost: { write: (_context, path, bytes) => options.downloads.write(path, bytes) } } : {}),
+        ...(options.files ? { fileHost: options.files } : {}),
+    });
+    const unlisten = options.listen(port, (socket) => endpoint.serve(socket));
+    const unpublish = options.portTable ? servePortTable(endpoint, options.portTable)
+        : options.discoveryTable ? serveDiscovery(endpoint, options.discoveryTable) : undefined;
+    const targetId = options.targetId ?? "preview";
+    let closed = false;
+    if (bridge)
+        void (async () => {
+            while (!closed) {
+                try {
+                    const channel = await bridge.connectProtocol(targetId);
+                    const transport = new MessagePortTransport(channel.port);
+                    void channel.closed.then((reason) => transport.close(1001, reason));
+                    if (closed) {
+                        transport.close(1001, "Preview CDP publication closed");
+                        return;
+                    }
+                    const lost = new Promise((resolve) => transport.on("close", resolve));
+                    endpoint.attachSurface(transport);
+                    await lost;
+                }
+                catch (error) {
+                    // A disposed bridge never lends its preview again; every other failure
+                    // (not yet ready, a dropped transfer, a replaced document) is retried.
+                    if (error instanceof Error && error.message === "Browser sandbox bridge is disposed.")
+                        return;
+                }
+                if (!closed)
+                    await new Promise((resolve) => setTimeout(resolve, REATTACH_DELAY_MS));
+            }
+        })();
+    return {
+        port,
+        url: `http://127.0.0.1:${port}`,
+        attachClient: (peer) => endpoint.attachClient(peer),
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            unlisten();
+            unpublish?.();
+            await endpoint.close();
+            await host?.dispose();
+        },
+    };
+}
+/** Lends a page surface and resolves once the endpoint lists it under its target id. */
+async function attachAndAwait(endpoint, peer, id, signal) {
+    let lost = false;
+    peer.on("close", () => { lost = true; });
+    endpoint.attachSurface(peer);
+    while (!endpoint.targets().some((target) => target.id === id)) {
+        signal.throwIfAborted();
+        if (lost)
+            throw new Error("The page surface closed before it registered.");
+        await new Promise((resolve) => setTimeout(resolve, 10));
+    }
+}
+/**
+ * Discovery as the port's HTTP server and DevTools WebSockets as its socket
+ * endpoint. Discovery names the address the request came in on: a loopback
+ * host plainly, any other host (a live tunnel's) behind TLS.
+ */
+/** The discovery documents as a GET-only server of the port table. */
+function serveDiscovery(endpoint, table) {
+    const encoder = new TextEncoder();
+    table.ports.registerServer({
+        listening: true,
+        address: () => ({ port: table.port, address: "0.0.0.0", family: "IPv4" }),
+        async handleRequest(method, url, headers) {
+            if (method !== "GET" && method !== "HEAD")
+                return { statusCode: 405, headers: { allow: "GET, HEAD" } };
+            const host = headers.host ?? headers.Host ?? `127.0.0.1:${table.port}`;
+            const loopback = /^(localhost|127\.0\.0\.1|\[::1\])(:|$)/u.test(host);
+            const { status, body } = endpoint.discovery(new URL(url, "http://localhost").pathname, loopback ? host : `wss://${host}`);
+            return { statusCode: status, headers: { "content-type": "application/json; charset=UTF-8" }, ...(method === "GET" ? { body: encoder.encode(JSON.stringify(body)) } : {}) };
+        },
+    }, table.port);
+    return () => table.ports.unregisterServer(table.port);
+}
+function servePortTable(endpoint, table) {
+    const unregisterDiscovery = serveDiscovery(endpoint, table);
+    const unregisterSockets = table.webSockets.register(table.port, {
+        open(path, _protocols, handlers) {
+            const messageListeners = [];
+            const closeListeners = [];
+            let state = 1;
+            const finish = () => {
+                if (state === 3)
+                    return;
+                state = 3;
+                for (const listener of closeListeners)
+                    listener();
+            };
+            const peer = {
+                get readyState() { return state; },
+                send: (data) => { if (state === 1)
+                    handlers.message({ kind: "text", text: data }); },
+                close: (code, reason) => { if (state !== 1)
+                    return; handlers.close(code, reason, true); finish(); },
+                on: ((event, listener) => {
+                    if (event === "message")
+                        messageListeners.push(listener);
+                    else
+                        closeListeners.push(listener);
+                }),
+            };
+            queueMicrotask(() => {
+                handlers.open("");
+                endpoint.connect(peer, path);
+            });
+            return {
+                send(data) {
+                    if (data.kind !== "text") {
+                        peer.close(1003, "CDP messages are text");
+                        return;
+                    }
+                    for (const listener of messageListeners)
+                        listener(data.text);
+                },
+                close(code = 1000, reason = "") { handlers.close(code, reason, true); finish(); },
+            };
+        },
+    });
+    return () => {
+        unregisterSockets();
+        unregisterDiscovery();
+    };
+}
+//# sourceMappingURL=preview-cdp-endpoint.js.map

package/dist/preview-cdp-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-cdp-endpoint.js","sourceRoot":"","sources":["../src/preview-cdp-endpoint.ts"],"names":[],"mappings":"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"}

package/dist/sandbox-surface.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sandbox-surface.d.ts.map

package/dist/sandbox-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-surface.d.ts","sourceRoot":"","sources":["../src/sandbox-surface.ts"],"names":[],"mappings":""}

package/dist/sandbox-surface.js

@@ -0,0 +1,27 @@
+import { connectDomSurface } from "@volter/almostcdp/dom";
+import { MessagePortTransport } from "@volter/almostcdp/message-port";
+import { createCaptureAdapter } from "@volter/almostcdp/capture-stream";
+import { createDomAccessibility } from "@volter/almostcdp/accessibility";
+import { registerPreviewProtocolSurface } from "@volter/browser-runtime/sandbox-preview-inspector.js";
+/**
+ * The sandbox page lends its preview as an AlmostCDP DOM surface. Imported by
+ * the sandbox bootstrap of an embedding that publishes the tab's CDP
+ * endpoint; the runtime itself lends no protocol.
+ */
+registerPreviewProtocolSurface((port, id, hooks) => connectDomSurface({
+    id,
+    target: hooks.window,
+    validateDocument: hooks.validateDocument,
+    urls: hooks.urls,
+    transport: new MessagePortTransport(port),
+    navigation: hooks.navigation,
+    // The sandbox bridge carries the preview's document requests through the
+    // surface's network door, so a navigation answers with its outcome.
+    carriedDocuments: true,
+    documentStart: hooks.documentStart,
+    capture: createCaptureAdapter((params) => hooks.capture(params), "dom-rasterized"),
+    // The accessibility tree read from the page's DOM, as a client's
+    // Accessibility.getFullAXTree asks (chrome-devtools-mcp's snapshot).
+    accessibility: createDomAccessibility(),
+}));
+//# sourceMappingURL=sandbox-surface.js.map

package/dist/sandbox-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-surface.js","sourceRoot":"","sources":["../src/sandbox-surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,MAAM,sDAAsD,CAAC;AAEtG;;;;GAIG;AACH,8BAA8B,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC;IACpE,EAAE;IACF,MAAM,EAAE,KAAK,CAAC,MAAM;IACpB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;IACxC,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,SAAS,EAAE,IAAI,oBAAoB,CAAC,IAAI,CAAC;IACzC,UAAU,EAAE,KAAK,CAAC,UAAU;IAC5B,yEAAyE;IACzE,oEAAoE;IACpE,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,KAAK,CAAC,aAAa;IAClC,OAAO,EAAE,oBAAoB,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAClF,iEAAiE;IACjE,qEAAqE;IACrE,aAAa,EAAE,sBAAsB,EAAE;CACxC,CAAC,CAAC,CAAC"}

package/dist/tab-chromium.d.ts

@@ -0,0 +1,51 @@
+import type { BrowserRuntime } from "@volter/browser-runtime";
+import type { BrowserSandboxBridge } from "@volter/browser-runtime/browser-sandbox-bridge.js";
+import type { PreviewBrowserHostOptions } from "./preview-browser-host.js";
+import { publishPreviewCdp, type PreviewCdpListener, type PreviewCdpPublication } from "./preview-cdp-endpoint.js";
+/** The port a client in the tab passes to `connectOverCDP`, as Chromium's default. */
+export declare const TAB_CDP_PORT = 9222;
+export interface TabChromiumOptions {
+    runtime: BrowserRuntime;
+    /** The preview's bridge, to publish the preview itself as a page target; a launched browser does not need it. */
+    bridge?: BrowserSandboxBridge;
+    /** A loopback listener of the tab, such as a Node container's `listenNet`. */
+    listen: PreviewCdpListener;
+    /** Where browser contexts and pages the endpoint creates are opened. */
+    browser: Omit<PreviewBrowserHostOptions, "attachSurface">;
+    /** The home Playwright's registry looks under: the `HOME` the tab's programs run with. */
+    home: string;
+    /** The project roots whose installed playwright-core pins are read for the revisions to place. */
+    roots: readonly string[];
+    /** The same endpoint in the tab's port table, so a page of the tab or a shared port reaches it. */
+    portTable?: Parameters<typeof publishPreviewCdp>[0]["portTable"];
+    /** The discovery documents alone in the tab's port table, under the endpoint's port. */
+    discoveryTable?: Parameters<typeof publishPreviewCdp>[0]["discoveryTable"];
+    port?: number;
+}
+export interface TabChromium {
+    readonly publication: PreviewCdpPublication;
+    dispose(): Promise<void>;
+}
+/**
+ * A Chromium for the tab's own Playwright: the preview published as a CDP
+ * endpoint, and the face registered under Chromium's executable names and
+ * placed where each installed playwright-core's registry looks, so a project's
+ * unchanged `playwright` launches it over its debugging pipe. A page's
+ * download is written where the Playwright client in the container reads it.
+ */
+export declare function installTabChromium(options: TabChromiumOptions): TabChromium;
+/**
+ * Where the tab has no Chromium to give (a page that runs its project in-page,
+ * with no sandbox to lend frames from), the face is still placed, and
+ * launching it says why and where the Chromium is. Without it a project's
+ * Playwright reports a missing executable and advises `npx playwright
+ * install`, a download that can never run in a tab.
+ */
+export declare function installUnavailableTabChromium(options: {
+    runtime: BrowserRuntime;
+    home: string;
+    roots: readonly string[];
+    /** One line naming what to do instead. */
+    reason: string;
+}): () => void;
+//# sourceMappingURL=tab-chromium.d.ts.map

package/dist/tab-chromium.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tab-chromium.d.ts","sourceRoot":"","sources":["../src/tab-chromium.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAE9F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,KAAK,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEnH,sFAAsF;AACtF,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,iHAAiH;IACjH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,8EAA8E;IAC9E,MAAM,EAAE,kBAAkB,CAAC;IAC3B,wEAAwE;IACxE,OAAO,EAAE,IAAI,CAAC,yBAAyB,EAAE,eAAe,CAAC,CAAC;IAC1D,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,mGAAmG;IACnG,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACjE,wFAAwF;IACxF,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAgD3E;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,IAAI,CAUb"}

package/dist/tab-chromium.js

@@ -0,0 +1,113 @@
+import { CHROMIUM_FACE_PROGRAMS, chromiumFaceRunner, placeChromiumFace, playwrightChromiumRevisions } from "./chromium-face.js";
+import { publishPreviewCdp } from "./preview-cdp-endpoint.js";
+/** The port a client in the tab passes to `connectOverCDP`, as Chromium's default. */
+export const TAB_CDP_PORT = 9222;
+/**
+ * A Chromium for the tab's own Playwright: the preview published as a CDP
+ * endpoint, and the face registered under Chromium's executable names and
+ * placed where each installed playwright-core's registry looks, so a project's
+ * unchanged `playwright` launches it over its debugging pipe. A page's
+ * download is written where the Playwright client in the container reads it.
+ */
+export function installTabChromium(options) {
+    const { runtime } = options;
+    const fs = runtime.filesystem;
+    const publication = publishPreviewCdp({
+        ...(options.bridge ? { bridge: options.bridge } : {}),
+        port: options.port ?? TAB_CDP_PORT,
+        listen: options.listen,
+        browser: options.browser,
+        ...(options.portTable ? { portTable: options.portTable } : {}),
+        ...(options.discoveryTable ? { discoveryTable: options.discoveryTable } : {}),
+        downloads: {
+            async write(path, bytes) {
+                fs.mkdirSync(path.slice(0, path.lastIndexOf("/")) || "/", { recursive: true });
+                fs.writeFileSync(path, bytes);
+            },
+        },
+        files: {
+            async read(path) {
+                const stat = fs.statSync(path);
+                if (!stat.isFile())
+                    throw new Error(`Not a file: ${path}`);
+                const name = path.slice(path.lastIndexOf("/") + 1);
+                return { data: await fs.readFile(path), name, type: mimeTypeOf(name), lastModified: Math.round(stat.mtimeMs) };
+            },
+            async list(path) {
+                if (!fs.statSync(path).isDirectory())
+                    return undefined;
+                const files = [];
+                const walk = (directory, prefix) => {
+                    for (const name of fs.readdirSync(directory).map(String).sort()) {
+                        const entry = `${directory}/${name}`;
+                        if (fs.statSync(entry).isDirectory())
+                            walk(entry, `${prefix}${name}/`);
+                        else
+                            files.push(`${prefix}${name}`);
+                    }
+                };
+                walk(path.replace(/\/+$/u, ""), "");
+                return files;
+            },
+        },
+    });
+    const face = chromiumFaceRunner((peer) => publication.attachClient(peer));
+    for (const name of CHROMIUM_FACE_PROGRAMS)
+        runtime.registerProgram(name, face, { descriptors: true });
+    const stopPlacing = keepFacePlaced(runtime, options.home, options.roots);
+    return {
+        publication,
+        async dispose() {
+            stopPlacing();
+            await publication.close();
+        },
+    };
+}
+/**
+ * Where the tab has no Chromium to give (a page that runs its project in-page,
+ * with no sandbox to lend frames from), the face is still placed, and
+ * launching it says why and where the Chromium is. Without it a project's
+ * Playwright reports a missing executable and advises `npx playwright
+ * install`, a download that can never run in a tab.
+ */
+export function installUnavailableTabChromium(options) {
+    const message = `chromium: ${options.reason}\n`;
+    const refuse = async (_argv, run) => {
+        run.onStderr?.(message);
+        return { stdout: "", stderr: message, exitCode: 1 };
+    };
+    // Declared like the real face: Playwright launches it with its pipe on fds
+    // 3 and 4, and a program refusing those would be refused first, generically.
+    for (const name of CHROMIUM_FACE_PROGRAMS)
+        options.runtime.registerProgram(name, refuse, { descriptors: true });
+    return keepFacePlaced(options.runtime, options.home, options.roots);
+}
+/** Places the face for every playwright-core revision the roots install, again whenever that set changes. */
+function keepFacePlaced(runtime, home, roots) {
+    const fs = runtime.filesystem;
+    let placed = "";
+    const place = async () => {
+        const revisions = (await playwrightChromiumRevisions(fs, roots)).sort().join(",");
+        if (revisions === placed)
+            return;
+        placed = revisions;
+        // Playwright looks under os.homedir(), which is HOME.
+        await placeChromiumFace(fs, `${home}/.cache/ms-playwright`, revisions ? revisions.split(",") : []);
+    };
+    // Playwright can arrive with the image or later; its pin is one file, read when it changes.
+    const placing = setInterval(() => { void place().catch((cause) => console.error("Chromium face placement failed:", cause)); }, 2_000);
+    void place().catch((cause) => console.error("Chromium face placement failed:", cause));
+    return () => clearInterval(placing);
+}
+/** A file's type as Chromium gives a picked file one: by its extension. */
+function mimeTypeOf(name) {
+    const extension = name.slice(name.lastIndexOf(".") + 1).toLowerCase();
+    return {
+        png: "image/png", jpg: "image/jpeg", jpeg: "image/jpeg", gif: "image/gif", webp: "image/webp", svg: "image/svg+xml",
+        ico: "image/x-icon", bmp: "image/bmp", avif: "image/avif", txt: "text/plain", html: "text/html", htm: "text/html",
+        css: "text/css", js: "text/javascript", mjs: "text/javascript", json: "application/json", xml: "text/xml", csv: "text/csv",
+        pdf: "application/pdf", zip: "application/zip", gz: "application/gzip", wasm: "application/wasm", mp3: "audio/mpeg",
+        wav: "audio/wav", ogg: "audio/ogg", mp4: "video/mp4", webm: "video/webm", woff: "font/woff", woff2: "font/woff2",
+    }[extension] ?? "";
+}
+//# sourceMappingURL=tab-chromium.js.map

package/dist/tab-chromium.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tab-chromium.js","sourceRoot":"","sources":["../src/tab-chromium.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/browser-cdp",
-  "version": "0.1.47",
+  "version": "0.1.49",
   "description": "The tab's Chrome DevTools Protocol endpoint over AlmostCDP: the preview published inside the tab, browser contexts and pages, and the Chromium face",
   "license": "MIT",
   "repository": {
@@ -22,5 +22,9 @@
     "@volter/almostcdp": "0.1.25",
     "@volter/browser-runtime": "^0.1.5",
     "dom-accessibility-api": "0.7.1"
-  }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ]
 }

package/src/chromium-face.ts

@@ -1,130 +0,0 @@
-import type { ProtocolPeer } from "@volter/almostcdp/core";
-import type { BrowserProgramRunner } from "@volter/browser-runtime/browser-process-host.js";
-import type { BrowserFileSystem } from "@volter/browser-runtime/browser-filesystem.js";
-
-/** Where Playwright's registry keeps each Chromium it launches, under its cache directory. */
-const PLACEMENTS = [
-  { browser: "chromium", directory: "chromium", executable: "chrome-linux64/chrome" },
-  { browser: "chromium-headless-shell", directory: "chromium_headless_shell", executable: "chrome-headless-shell-linux64/chrome-headless-shell" },
-] as const;
-
-/** The program names a placed executable resolves to (a path resolves to its basename). */
-export const CHROMIUM_FACE_PROGRAMS = ["chrome", "chrome-headless-shell"] as const;
-
-const encoder = new TextEncoder();
-
-/**
- * Chromium as Playwright launches it: `--remote-debugging-pipe`, CDP as
- * NUL-terminated JSON read from fd 3 and written to fd 4. The face owns no
- * protocol behaviour of its own; each launch is one browser-level client of
- * the tab's CDP endpoint, and `Browser.close` ends the process as it ends
- * Chromium's.
- */
-export function chromiumFaceRunner(attachClient: (peer: ProtocolPeer) => void): BrowserProgramRunner {
-  return async (argv, options) => {
-    const name = argv[0]?.slice(argv[0].lastIndexOf("/") + 1) ?? "chrome";
-    if (!argv.includes("--remote-debugging-pipe")) {
-      return { stdout: "", stderr: `${name}: the tab's Chromium is driven over --remote-debugging-pipe only\n`, exitCode: 1 };
-    }
-    const commands = options.descriptors?.[3];
-    const replies = options.descriptors?.[4];
-    if (!commands || !replies) {
-      return { stdout: "", stderr: `${name}: --remote-debugging-pipe needs pipes on fds 3 and 4\n`, exitCode: 1 };
-    }
-    const messageListeners: ((data: { toString(): string }) => void)[] = [];
-    const closeListeners: (() => void)[] = [];
-    let open = true;
-    let finished!: () => void;
-    const done = new Promise<void>((resolve) => { finished = resolve; });
-    const end = (): void => {
-      if (!open) return;
-      open = false;
-      replies.end();
-      for (const listener of closeListeners) listener();
-      finished();
-    };
-    const peer: ProtocolPeer = {
-      get readyState() { return open ? 1 : 3; },
-      send: (data) => { if (open) replies.write(encoder.encode(`${data}\0`)); },
-      close: () => end(),
-      on: ((event: "message" | "close", listener: ((data: { toString(): string }) => void) | (() => void)) => {
-        if (event === "message") messageListeners.push(listener as (data: { toString(): string }) => void);
-        else closeListeners.push(listener as () => void);
-      }) as ProtocolPeer["on"],
-    };
-    options.signal?.addEventListener("abort", end, { once: true });
-    attachClient(peer);
-    void (async () => {
-      const decoder = new TextDecoder();
-      let buffered = "";
-      for await (const chunk of commands.input) {
-        buffered += decoder.decode(chunk, { stream: true });
-        for (let boundary = buffered.indexOf("\0"); boundary >= 0; boundary = buffered.indexOf("\0")) {
-          const message = buffered.slice(0, boundary);
-          buffered = buffered.slice(boundary + 1);
-          const closing = browserClose(message);
-          if (closing !== undefined) { peer.send(JSON.stringify({ id: closing, result: {} })); end(); return; }
-          for (const listener of messageListeners) listener(message);
-          if (!open) return;
-        }
-      }
-      end();
-    })().catch(end);
-    await done;
-    return { stdout: "", stderr: "", exitCode: 0 };
-  };
-}
-
-/** The id of a browser-level `Browser.close`, which ends the process rather than reaching the endpoint. */
-function browserClose(message: string): number | undefined {
-  try {
-    const parsed = JSON.parse(message) as { id?: unknown; method?: unknown; sessionId?: unknown };
-    return parsed.method === "Browser.close" && parsed.sessionId === undefined && typeof parsed.id === "number" ? parsed.id : undefined;
-  } catch { return undefined; }
-}
-
-/** The Chromium revisions pinned by each `playwright-core` installed under the given roots. */
-export async function playwrightChromiumRevisions(filesystem: BrowserFileSystem, roots: readonly string[]): Promise<string[]> {
-  const revisions = new Set<string>();
-  for (const root of roots) {
-    const path = `${root.replace(/\/$/u, "")}/node_modules/playwright-core/browsers.json`;
-    if (!filesystem.existsSync(path)) continue;
-    try {
-      const pinned = JSON.parse(await filesystem.readFile(path, "utf8")) as { browsers?: { name?: unknown; revision?: unknown }[] };
-      for (const entry of pinned.browsers ?? []) {
-        if ((entry.name === "chromium" || entry.name === "chromium-headless-shell") && typeof entry.revision === "string") revisions.add(entry.revision);
-      }
-    } catch { /* A browsers.json that does not parse pins nothing. */ }
-  }
-  return [...revisions];
-}
-
-/**
- * Places the face where Playwright's registry looks for each revision, marked
- * installed and host-validated as the registry marks what it downloads, so
- * `playwright install` finds it present and a launch resolves the path to the
- * registered program: the file is the engine's registered-program stub, which
- * it relays to the host rather than running.
- */
-export async function placeChromiumFace(filesystem: BrowserFileSystem, cacheDirectory: string, revisions: readonly string[]): Promise<void> {
-  for (const revision of revisions) {
-    for (const placement of PLACEMENTS) {
-      const root = `${cacheDirectory}/${placement.directory}-${revision}`;
-      const executable = `${root}/${placement.executable}`;
-      filesystem.mkdirSync(executable.slice(0, executable.lastIndexOf("/")), { recursive: true });
-      // The registered-program stub the engine relays to the host, which maps
-      // the pathname to the face by its basename.
-      const name = placement.executable.slice(placement.executable.lastIndexOf("/") + 1);
-      const stub = `#!/bin/sh\n# ${name}: runtime-registered program\n`;
-      let current: string | undefined;
-      try { current = filesystem.existsSync(executable) ? await filesystem.readFile(executable, "utf8") : undefined; } catch { current = undefined; }
-      if (current !== stub) {
-        filesystem.writeFileSync(executable, stub);
-        filesystem.chmodSync?.(executable, 0o755);
-      }
-      for (const marker of ["INSTALLATION_COMPLETE", "DEPENDENCIES_VALIDATED"]) {
-        if (!filesystem.existsSync(`${root}/${marker}`)) filesystem.writeFileSync(`${root}/${marker}`, "");
-      }
-    }
-  }
-}