agents@0.28.0

cloudflare/agentsagents@0.28.0Oct 9, 2026by github-actions[bot]

Upgrading?

AI Summary

This release adds persistent browser tools (`browserTool`) and `web_fetch` tools, and stabilizes the lifecycle module along with other core capabilities like Scheduler, State, WebSockets, and MCPClientManager.

Key Highlights

  • Add `browserTool()` to `agents/browser/pi` for persistent browser sessions.
  • Add `agents/webfetch` for retrieving documents in Markdown, JSON, or text.
  • Make `agents/lifecycle` stable along with Scheduler, State, WebSockets, and MCPClientManager.
  • ThinkHarness now uses shared `agents/harness/store` for recovery.

New Features

  • `browserTool()` in `agents/browser/pi`.
  • `agents/webfetch` and `web_fetch` tool.
  • Stabilization of `agents/lifecycle`.
  • Stabilization of `agents/schedules`.
  • Stabilization of `agents/state`.
  • Stabilization of `agents/websockets`.
  • Stabilization of `agents/mcp/client`.

Full Release Notes

This release adds two new tools, `browser` via `agents/browser/{pi,ai-sdk,tanstack-ai}` allowing an agent to create and manipulate a persistent browser session and `web_fetch` via `agents/webfetch/{pi,ai-sdk,tanstack-ai}` that can retrieve most document formats converted into markdown.

### Minor Changes

-   [#2484](https://github.com/cloudflare/agents/pull/2484) [`dedbee4`](https://github.com/cloudflare/agents/commit/dedbee41bad3986ffc45fe295502e9740bde31ca) Thanks [@ben-reitz](https://github.com/ben-reitz)! - Add `browserTool()` to `agents/browser/pi`. See [Persistent browser](https://github.com/cloudflare/agents/blob/main/docs/agents/browse-the-web.md#persistent-browser).

-   [#2473](https://github.com/cloudflare/agents/pull/2473) [`6614955`](https://github.com/cloudflare/agents/commit/661495532b69e64affad5e7bcd6373b4ee6ad3c5) Thanks [@mattzcarey](https://github.com/mattzcarey)! - Make `agents/lifecycle` stable along with the `Scheduler` (`agents/schedules`), `State` (`agents/state`), `WebSockets` (`agents/websockets`) and `MCPClientManager` (`agents/mcp/client`) capabilities. See [Lifecycle](https://github.com/cloudflare/agents/blob/main/docs/agents/lifecycle.md).

### Patch Changes

-   [#2540](https://github.com/cloudflare/agents/pull/2540) [`b65956e`](https://github.com/cloudflare/agents/commit/b65956e8a40501fc241c223aba0d6177077268d1) Thanks [@mattzcarey](https://github.com/mattzcarey)! - `ThinkHarness` now keeps its sessions and operations in the shared `agents/harness/store`. Migrations are performed on first run. See [ThinkHarness: Recovery](https://github.com/cloudflare/agents/blob/main/docs/agents/harnesses/think.md#recovery).

-   [#2522](https://github.com/cloudflare/agents/pull/2522) [`bcf5d20`](https://github.com/cloudflare/agents/commit/bcf5d2057aa477da9f464af8496a21811416a7c4) Thanks [@ben-reitz](https://github.com/ben-reitz)! - Add `agents/webfetch`, a `web_fetch` tool that reads a URL as Markdown, JSON, or text (HTML, PDF, and Office documents via Worker AI). See [Fetch the Web](https://github.com/cloudflare/agents/blob/main/docs/agents/fetch-the-web.md).

Related Repositories