computer: Add a ws:browser host module

[mattzcarey]

Adds an experimental ws:browser host module, createBrowserModule() from @cloudflare/computer/modules/browser. Code that exec runs can drive a persistent Chrome browser over the Chrome DevTools Protocol with send, attachToTarget, spec, getDebugLog and clearDebugLog.

import { Browser, browserRun } from "agents/browser";
import { createBrowserModule } from "@cloudflare/computer/modules/browser";

modules: { "ws:browser": createBrowserModule({ browser: this.browser }) }

import { send } from "ws:browser";
export default () => send({ method: "Page.navigate", params: { url }, sessionId: "active" });

The agents SDK's browser tools are moving off @cloudflare/codemode, which is being deprecated, and the browser itself stays in agents:

• the module takes anything with a name and a session({ scope, maxResultBytes }). Browser from agents/browser has that shape (browser: run createBrowserTool without codemode, on a BrowserSession agents#2612), so neither package imports the other
• the CDP rules (the "active" tab, attach handles that last between runs, refusing Browser.close, hints for common mistakes) live in that session, so ws:browser and agents' direct createBrowserTool behave the same way
• each run starts one session on its first call. A deferred function closes it and writes the report (a restart, a closed or shared tab, tabs the page opened) to standard error

npm test in packages/computer and npm run check ran. Unit tests cover the routing to one session per run, the options passed through and the report lines. A workerd test imports ws:browser from exec code and sees a restart on standard error. A scratch type check against agents' built types confirmed Browser is assignable to BrowserSource, and that a connect()-only source isn't.

Stacked on #247, which adds executionId, log and defer.

[changeset-bot]

🦋 Changeset detected

Latest commit: e1e67d3

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
@cloudflare/computer	Minor
@cloudflare/dofs	Minor
@cloudflare/computer-rpc	Minor
@cloudflare/computerd	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@cloudflare/computer@248

commit: e1e67d3