[ben-reitz]

Summary

Gives the browser hostnames that your agent serves instead of the internet, using Browser Run's per-session host routing.

sequenceDiagram
    participant Page as Browser Run page
    participant Router as InternalHostRouter (your Worker)
    participant Agent as Agent DO
    Page->>Router: GET http://docs.internal/
    Router->>Agent: fetchInternalHost(message)
    Agent->>Agent: browser.fetchInternalHost → host.fetch(request)
    Agent-->>Page: response

Loading

browser = new Browser({
  provider: browserRun(this.env.BROWSER, {
    internalHosts: {
      router: this.ctx.exports.InternalHostRouter,
      hosts: {
        "docs.internal": { description: "Staging docs", fetch: (req) => … },
        "api.internal": { worker: this.env.API } // straight to a Worker
      }
    }
  })
});

• Agent has fetchInternalHost() built in; a plain DO adds a one-line method.
• Hostnames must end in .internal, .test, .example or .invalid (never resolve publicly). A probe showed single-label names that are real TLDs (docs, app) fail silently in Browser Run.
• At most 8 hosts, plain http on port 80, no WebSockets, deployed only (local dev logs a warning and starts without them).
• Hardening: rejects DO stubs as worker, validates router props, terse 502s when fetch throws.

Merge Danger

Blast Radius: none for existing users — opt-in internalHosts option.

[agent-think]

🟡 agents import sizes: 1 entry point grew

	Entry point	Exports	Largest gzip change	Size now
🟡	agents/browser	2 resized, 2 new	up to +1 KiB (+2.18%)	48.9 KiB

Changed exports (4)

	Import	Gzip change	Size now
🟡	agents/browser#Browser	+1 KiB (+2.18%)	48.9 KiB
🟡	agents/browser#browserRun	+577 B (+1.57%)	36.6 KiB
🆕	agents/browser#InternalHostRouter	—	36.5 KiB
🆕	agents/browser#MAX_INTERNAL_HOSTS	—	36 KiB

How this works

Each runtime export is bundled on its own, minified, and gzipped. Changes smaller than 100 B, or smaller than 1% and 1 KiB, are ignored. Growth over 10% or 5 KiB is marked 🔴. This report is informational and does not fail CI. The workflow artifact contains every measurement.

_{Compared e1b84c06 → 0e7378ac · workflow run · reported by agent-think[bot]}

[pkg-pr-new]

Open in StackBlitz

agents

npm i https://pkg.pr.new/agents@2669

@cloudflare/ai-chat

npm i https://pkg.pr.new/@cloudflare/ai-chat@2669

@cloudflare/codemode

npm i https://pkg.pr.new/@cloudflare/codemode@2669

hono-agents

npm i https://pkg.pr.new/hono-agents@2669

@cloudflare/shell

npm i https://pkg.pr.new/@cloudflare/shell@2669

@cloudflare/think

npm i https://pkg.pr.new/@cloudflare/think@2669

@cloudflare/voice

npm i https://pkg.pr.new/@cloudflare/voice@2669

@cloudflare/worker-bundler

npm i https://pkg.pr.new/@cloudflare/worker-bundler@2669

commit: 0e7378a

[changeset-bot]

⚠️ No Changeset found

Latest commit: 0e7378a

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

[changeset-bot]

⚠️ No Changeset found

Latest commit: af8ae00

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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