agents@0.25.0
Cloudflare Agents SDK v0.25.0 introduces automatic lifecycle initialization on async Agent/Think RPC calls (requiring named addressing), adds browser automation enhancements, and introduces experimental providers for Workers AI and pi-ai.
Why this signal matters
agents@0.25.0 introduces a minor breaking behavior in native RPC handling: async calls to Agent and Think methods now trigger lifecycle initialization first. Consequently, agents must be addressed by name, as raw IDs generated via newUniqueId() or idFromString() will fail on their initial async RPC. The release also adds several experimental modules: agents/models/ai-sdk and agents/models/pi-ai (providing Workers AI and AI Gateway integration via AI bindings), and agents/harnesses/pi to host pi-durable sessions in Durable Objects. For tooling and browser rendering, it improves CDP integrations (immediate rejection on closed sockets, hostname guardrails, detailed command/type specifications in cdp.spec, and support for persistent browser tools in AI SDK and TanStack AI) and fixes agent-tool chunk drops/duplications during fiber recovery or reconnects.
Actionable summary
agents@0.25.0 changes RPC routing: native async Agent and Think RPCs now trigger lifecycle initialization, breaking raw ID addressing from newUniqueId() and idFromString() on the first RPC. It also introduces experimental packages for Workers AI/AI Gateway bindings (ai-sdk and pi-ai) and Pi harness, alongside fixes and features for CDP browser sessions and agent-tool chunk handling.
- Agent usefulness
- 94/100
- Confidence
- 96%
- Canonical data
- JSON + Markdown
What builders should check
- Update agent addressing logic to reference agents by name instead of raw IDs (newUniqueId() / idFromString()) to avoid failures on initial async RPC calls.
- Rename usages of CdpSession to CdpConnection to align with the new naming standard.
- Optionally evaluate new experimental modules: agents/models/ai-sdk , agents/models/pi-ai , and agents/harnesses/pi if using Workers AI bindings or Durable Object pi harnesses.