Skip to content

browser: deprecate createBrowserTools and Quick Actions in favour of browserTool - #2610

Closed
mattzcarey wants to merge 5 commits into
mainfrom
browser-computer-module
Closed

mattzcarey wants to merge 5 commits into
mainfrom
browser-computer-module

Conversation

@mattzcarey

@mattzcarey mattzcarey commented Oct 17, 2026 •

Copy link
Copy Markdown
Member

Deprecates createBrowserTools and createBrowserRuntime in favour of browserTool, and deprecates the Quick Action helpers (createQuickActionTools, runQuickAction, browserMarkdown and the rest). The deprecated pieces keep their names, exports and behaviour.

browserTool drives the persistent Browser and is the browser tool going forward. createBrowserTools and the Quick Actions are frozen until they're removed:

  • pausing a run while a person works in Live View has no replacement yet, so the guide tells people who rely on it to stay on createBrowserTools
  • the Quick Action deprecation points at browserTool, the web_fetch tool from agents/webfetch, or calling the binding's quickAction() directly

pnpm run check, the browser worker tests and the pi browser test ran. JSDoc, docs and a changeset only.

@changeset-bot

changeset-bot Bot commented Oct 17, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 633b73e

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

This PR includes changesets to release 2 packages
Name Type
agents Minor
@cloudflare/agent-think Patch

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

@agent-think

agent-think Bot commented Oct 17, 2026 •

Copy link
Copy Markdown
Contributor

🔴 agents import sizes: 1 entry point over threshold

Entry point Exports Largest gzip change Size now
🔴 agents/harness/pi 3 resized up to +46.4 KiB (+340.34%) 60.1 KiB
🟡 agents/models/pi-ai 1 resized +2.5 KiB (+1.58%) 159 KiB
Changed exports (4)
Import Gzip change Size now
🔴 agents/harness/pi#PiHarness +46.4 KiB (+340.34%) 60.1 KiB
🔴 agents/harness/pi#PiSession +46 KiB (+962.03%) 50.7 KiB
🟡 agents/models/pi-ai#createAI +2.5 KiB (+1.58%) 159 KiB
🟡 agents/harness/pi#openPiSessionStore +362 B (+4.6%) 8 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 7dd51c51 → 633b73ed · workflow run · reported by agent-think[bot]

@pkg-pr-new

pkg-pr-new Bot commented Oct 17, 2026 •

Copy link
Copy Markdown

Open in StackBlitz

agents

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

@cloudflare/ai-chat

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

@cloudflare/codemode

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

hono-agents

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

@cloudflare/shell

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

@cloudflare/think

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

@cloudflare/voice

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

@cloudflare/worker-bundler

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

commit: 633b73e

createBrowserTools and createBrowserRuntime are deprecated along with
@cloudflare/codemode, which they run on. The browse-the-web guide
shows the replacement for a Computer Workspace: the ws:browser module
from @cloudflare/computer/modules/browser, given the agent's own
Browser. The direct tools (browserTool and the Quick Actions) stay as
they are.
@mattzcarey
mattzcarey force-pushed the browser-computer-module branch from a071047 to 7eec283 Compare October 18, 2026 11:34
@mattzcarey mattzcarey changed the title browser: add a ws:browser module for @cloudflare/computer browser: deprecate createBrowserTools, point at @cloudflare/computer's ws:browser Oct 18, 2026
browserTool is now createBrowserCDPTool and createQuickActionTools is
now createBrowserQuickActionTools, so each browser tool's name says what
it does. The old names stay as deprecated aliases, and a type test
checks they match the new ones. Docs, examples and Think's
tools/browser re-export use the new names.
@mattzcarey mattzcarey changed the title browser: deprecate createBrowserTools, point at @cloudflare/computer's ws:browser browser: deprecate createBrowserTools, rename the direct tools, point at ws:browser Oct 19, 2026
browserTool is renamed to createBrowserTool rather than
createBrowserCDPTool, with browserTool kept as a deprecated alias.

Quick Actions are deprecated instead of renamed: createQuickActionTools,
runQuickAction and the browserMarkdown-style helpers keep their names
and code, with @deprecated pointing at createBrowserTool, web_fetch, or
the binding's quickAction(). The guide and the example's README say so.
@mattzcarey mattzcarey changed the title browser: deprecate createBrowserTools, rename the direct tools, point at ws:browser browser: deprecate createBrowserTools and Quick Actions, rename browserTool to createBrowserTool Oct 19, 2026
This ships before @cloudflare/codemode is deprecated and before
@cloudflare/computer has a ws:browser module, so the deprecation
messages no longer say codemode is deprecated or point at
createBrowserModule, and the Computer section of the guide moves to the
follow-up that adds browser.session(), which the module needs.
@mattzcarey mattzcarey changed the title browser: deprecate createBrowserTools and Quick Actions, rename browserTool to createBrowserTool browser: rename browserTool to createBrowserTool, deprecate createBrowserTools and Quick Actions Oct 19, 2026
browserTool isn't renamed after all. The deprecations of
createBrowserTools, createBrowserRuntime and the Quick Actions point at
browserTool.
@mattzcarey mattzcarey changed the title browser: rename browserTool to createBrowserTool, deprecate createBrowserTools and Quick Actions browser: deprecate createBrowserTools and Quick Actions in favour of browserTool Oct 19, 2026
ben-reitz added a commit that referenced this pull request Oct 26, 2026
… Quick Actions (#2666)

* feat(browser): deprecate createBrowserTools, createBrowserRuntime and Quick Actions

Point users at browserTool from agents/browser/ai-sdk, tanstack-ai or pi.
The Quick Action helpers keep working but won't change. Pausing a run
while a person works in Live View has no replacement yet, so the docs say
to keep using createBrowserTools for that.

Ported from #2610.

Co-authored-by: Matt <77928207+mattzcarey@users.noreply.github.com>

* docs(browser): no contractions in the deprecation notices

Co-authored-by: Matt <77928207+mattzcarey@users.noreply.github.com>

* chore(browser): the deprecation changeset names BrowserConnector

Co-authored-by: Matt <77928207+mattzcarey@users.noreply.github.com>

---------

Co-authored-by: Matt <77928207+mattzcarey@users.noreply.github.com>
@ben-reitz

Copy link
Copy Markdown
Contributor

All done in #2666

@ben-reitz ben-reitz closed this Oct 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants