Skip to content
Agents tracked: 258 Downloads (7d): 219M up 6.1% GitHub stars: 5.5M VS Code installs: 148M Releases (7d): 327 Agent status: 1 with issues Updated Oct 7, 2026
AgentGid

Cloudflare Agents SDK changelog: what's new each month

Every stable Cloudflare Agents SDK release summarised by month: the highlights, new features, improvements, fixes and anything you need to act on. 3 months covered; the current month updates daily.

October 2026 · so far

2 releases: 0.25.0 → 0.26.0

October brought improvements to agent lifecycle management, tool execution reliability, and new experimental model providers. The SDK now handles agent addressing, tool event filtering, and recovery scenarios more robustly.

Action needed
  • pi-durable and pi-ai dependencies updated to ^1.0.0; review Pi harness docs for migration details.

Highlights

  • Native RPC calls to async Agent methods now initialize lifecycle properly and support addressing agents by name.
  • Agent-tool execution is more reliable with fixes for duplicated or dropped chunks on reconnect and fiber recovery.
  • New experimental model providers for Workers AI and AI Gateway integration via the AI binding.
  • Tool event delivery can now be filtered to only terminal lifecycle and progress events.
  • New pi harness for hosting pi-durable sessions in a Durable Object with a runnable example.

New

  • Experimental agents/models/ai-sdk provider for Workers AI and AI Gateway over the AI binding.
  • Experimental agents/models/pi-ai provider for pi-ai with Workers AI and AI Gateway.
  • Experimental agents/harnesses/pi to host pi-durable sessions in a Durable Object.
  • eventDelivery: 'terminal' option for runAgentTool to forward only lifecycle, progress, and milestone events.

Improved

  • Native RPC calls to async Agent and Think methods now start lifecycle initialization first.
  • Tool calls retain their input when approval requests arrive before streaming completes.
  • Agent-tool chunks no longer duplicate or drop on reconnect and child re-attach scenarios.
  • Failed agent-tool children are reported as failed even when evicted before recording the failure.

Fixed

  • Agent-tool chunks being duplicated or dropped on reconnect and fiber recovery.
  • Failed agent-tool children not being reported as failed when evicted early.
  • Tool call input lost when approval request arrived before input finished streaming.

September 2026

2 releases: 0.23.0 → 0.24.0

September brought major architectural improvements to the Agents SDK, introducing new Lifecycle capabilities for sessions, routing, and background jobs, alongside expanded transport options for WebSocket connections.

Action needed
  • The experimental ?agentsrpc=capnweb endpoint from 0.23.0 has been removed; use the transport parameter instead.
  • Agent state is now opt-in via the State Lifecycle capability rather than automatic.

Highlights

  • WebSockets now support both hibernating sockets and Cap'n Web transport for flexible agent communication.
  • New RoutedAgents capability enables the hub-and-spoke topology with one Durable Object per chat conversation.
  • Sessions capability with context blocks allows structured conversation management and message optimization.
  • Queue capability for durable background job processing integrated into the Lifecycle.
  • Dynamic agents machinery extracted and repositioned as a core Lifecycle capability.

New

  • RoutedAgents Lifecycle capability for managing multi-agent topologies with per-chat Durable Objects.
  • Sessions Lifecycle capability with context block declarations for conversation state management.
  • Queue Lifecycle capability for durable background work with job queue integration.
  • Cap'n Web transport option for WebSockets alongside the default hibernating socket.
  • ContextBlocks from agents/context module for structured context management in sessions.
  • AgentSearchProvider and AgentContextProvider in agents/context module.
  • Dynamic agents facade through this.dynamicAgents capability.
  • Token estimators and message truncation utilities in agents/sessions and agents/chat.

Improved

  • WebSockets integrated with useAgent and AgentClient for seamless transport selection.
  • Session management refactored so SessionManager capability holds multiple sessions by ID.
  • Lifecycle now owns a durable job queue driven as an alarm event loop.
  • LifecycleServices now exposes name and className properties.
  • Agent state management made opt-in through the State Lifecycle capability.
  • Message handling optimized with createCompactFunction and truncateOlderMessages utilities.

August 2026

2 releases: 0.21.0 → 0.22.0

August brought major improvements to transport, schema handling, and lifecycle management in the Agents SDK. The month focused on making agent communication more flexible and adding persistent scheduling capabilities.

Action needed
  • The agents command-line binary has been removed; init, dev, deploy, and mcp commands are no longer available.

Highlights

  • WebSocketChatTransport is now exposed from the framework-neutral entry point, with React peers becoming optional.
  • Agent tools now accept flexible AI SDK schemas including Valibot adapters while maintaining type inference and validation.
  • New Scheduler capability enables persistent delayed, dated, cron, and interval callbacks for agents.
  • Durable chat recovery is now unconditional for AIChatAgent and Think, improving reliability.
  • Browser tools now support connection-scoped Kitesurf sessions for enhanced browser automation.

New

  • Scheduler lifecycle capability for persistent delayed, dated, cron, and interval callbacks.
  • buildAgentPath() and buildAgentUrl() helpers for constructing canonical agent addresses.
  • Connection-scoped Kitesurf support in Browser Tools through the browser session option.
  • MCPClientManager as a reusable Durable Object lifecycle capability with persisted connection restoration.
  • SDK instrumentation and agent instance identity attributes added to created spans.

Improved

  • WebSocketChatTransport and connection types exposed from framework-neutral agents/chat/transport entry point.
  • Agent tools now support flexible AI SDK schemas including Valibot adapters with preserved type inference.
  • Chat UI updates throttled by default in useAgentChat for better performance.
  • Stream forwarded request bodies into sub-agents instead of buffering in parent Durable Object.
  • Workflow retention now passed through Agent.runWorkflow().
  • TanStack browser tools screenshot output reduced to compact model-facing summary instead of raw base64.
  • Large base64 values outside canonical screenshot shape are now redacted.

Fixed

  • Durable chat recovery now works unconditionally for AIChatAgent and Think.

Summaries are written automatically from the official release notes (full changelog ↗); check the original notes before relying on a detail. Cloudflare Agents SDK: pricing, features and alternatives · All changelogs