Released Nov 3, 2026Cloudflareagents@0.33.0Reported

Cloudflare Agents SDK: what’s new in agents@0.33.0 and our verdict

MIT-licensed TypeScript SDK for stateful agents on Durable Objects, with MCP, scheduling and browser tools.

Official site

Evidence: Reported
Released: Nov 3, 2026
Last verified: Nov 11, 2026
Pricing: Not verified
Best for: agent building

Evidence behind this verdict

Sources read6 cited sources, latest fetched Nov 11, 2026. (done)
Facts re-checkedLast verified Nov 11, 2026. (done)
Not run by us yetWe have not run it, so this is labelled Reported. (not done)

Where we rank it (editorial)

agent building

Listed here but not yet ranked. Ranks are editorial picks, not benchmark scores.

Primary source: https://developers.cloudflare.com/agents/. We are the fast, independent index; the vendor’s own page is the source of record for this tool.

Pricing: We have not verified pricing for this tool; see the official site.

Our verdict

The natural choice if you already deploy on Cloudflare Workers and want one durable, stateful agent per user or session; expect breaking changes almost every release.

Good for

Teams already on Cloudflare Workers and Durable Objects
Many small stateful agents (one per user, session or room) that hibernate when idle
MCP servers and clients hosted on Cloudflare

Skip if

You need a stable API: the package is pre-1.0 and three of the last four releases had breaking changes
You do not want to run on Cloudflare

Status: Reported. This write-up is based on official release notes and docs; we have not run this release ourselves yet.

Best for

Best AI tool for agent building: Stateful agents on Cloudflare Durable Objects, with MCP, scheduling and a browser tool.

What’s new

Cloudflare's agents package runs each agent as a Durable Object with its own state, storage and lifecycle. Since late October it has shipped weekly: 0.31.0 (Oct 27) made the MCP packages optional peers, 0.32.0 (Oct 29) rebuilt Agent Skills loading, and 0.33.0 (Nov 3) moved the Pi harness to Pi 1.5 with no rollback.

agents@0.33.0 (Nov 3): the Pi harness moves to Pi 1.5, which the notes say cuts SQLite storage transactions about 27x for long answers; once a conversation runs on Pi 1.5 a deployment cannot roll back past this release.
agents@0.33.0: session.watch() replaces session.events(), session.continue() restarts a run on the existing transcript, and defaults.maxTurns caps tool rounds; retry() and the parked status are removed.
agents@0.32.0 (Oct 29): breaking for agents/skills: skills load from Workspace files, R2 or code, SKILL.md is checked against the Agent Skills spec, and SkillRegistry is replaced by loadSkillCatalog() and createSkillTools(). Adds experimental OpenTelemetry spans.
agents@0.31.0 (Oct 27): Browser Run can route up to 8 internal hostnames to your agent; @modelcontextprotocol/sdk and server become optional peer dependencies that MCP users must add themselves.

Cloudflare Agents releases, October to November 2026

Every minor release since 0.30.0, from Cloudflare's GitHub release notes (read Nov 11, 2026). Breaking changes are called out because the package is still pre-1.0.

agents package releases with their breaking changes (GitHub release notes, read Nov 11, 2026)
Version	Date	Headline change	Breaking for	Rollback
0.33.0	Nov 3	Pi harness on Pi 1.5; batched writes cut SQLite transactions about 27x for long answers (vendor figure); session.watch(), session.continue(), defaults.maxTurns	Pi users: retry() and the parked status removed; tool schemas move to @earendil-works/pi-schema	Not possible past this release once a conversation runs on Pi 1.5
0.32.0	Oct 29	Agent Skills load from Workspace files, R2 or code; experimental_registerOpenTelemetry()	agents/skills: SkillRegistry replaced by loadSkillCatalog() and createSkillTools(); agents/skills/compile removed	Normal
0.31.0	Oct 27	Browser Run routes up to 8 internal hostnames to your agent; browserTool runs model code in its own Dynamic Worker	MCP users must install @modelcontextprotocol/sdk and server themselves	Normal
0.30.0	Oct 22	Pi 1.4 support; PiHarness hibernates while Pi's tasks sleep and recovers from storage errors	Pi users must update to ~1.4.0 and pass onWake	Not possible past this release (Pi 1.4 storage schema)

Upgrading from 0.30 to 0.33: install the MCP peers if you import agents/mcp, migrate skills to loadSkillCatalog(), then update Pi to ~1.5.0 and replace session.events() with session.watch(). Test on a copy first: both the 0.30 and 0.33 Pi migrations are one-way.
Performance claims: Cloudflare's 0.33.0 notes say one Pi harness with 2,048 sessions went from 88 to 459 agent runs a second on SQLite. We have not measured this.
Companion packages: @cloudflare/think shipped 0.22.0 and 0.23.0 alongside 0.31.0 and 0.32.0; check their notes if you use Think.

Cloudflare Agents vs other agent frameworks

Agent frameworks we cover, by where they run (project READMEs and our tool pages)
Framework	Language	Where agents run	Licence	Our evidence
Cloudflare Agents SDK	TypeScript	Cloudflare Workers and Durable Objects	MIT	Reported
Mastra	TypeScript	Any Node runtime, local Studio	Check the repository (GitHub reports NOASSERTION)	Tested (smoke test)
OpenAI Agents SDK	Python and TypeScript	Anywhere you run the SDK	See its tool page	See its tool page
LangGraph	Python and TypeScript	Anywhere, or LangGraph Platform	See its tool page	See its tool page

Pick Cloudflare Agents when you want the platform to own state, hibernation and scaling per agent; pick a runtime-neutral framework if you may move off Cloudflare. See all of them ranked on best agent-building tools.

How to set it up: Start a Cloudflare Agents project

Steps come from the project's README. We have not run them ourselves.

Create from the starter template
The README's quickest path scaffolds a working agent project.
```
npm create cloudflare@latest -- --template cloudflare/agents-starter
```
Or add it to an existing Worker
Install the package into a project you already have.
```
npm install agents
```
If you use MCP, add the peers
Since 0.31.0 the MCP packages are optional peer dependencies; builds that import agents/mcp fail without them.
```
npm install @modelcontextprotocol/sdk @modelcontextprotocol/server
```

Pros and cons

Pros

MIT licence
Each agent keeps its own state and storage and hibernates when idle, per the README
Detailed release notes with upgrade steps
Built-in MCP, scheduling, workflows and a browser tool

Cons

Pre-1.0 with frequent breaking changes (0.31.0, 0.32.0 and 0.33.0 all break something)
Pi 1.4 to 1.5 storage migration cannot be rolled back
Tied to Cloudflare Workers and Durable Objects

Alternatives and comparisons

Mastra: TypeScript framework for AI-powered applications and agents, with a local Studio.
OpenAI Agents SDK: Lightweight Python framework for multi-agent workflows, with tools, handoffs, sessions and tracing.
LangGraph: Low-level framework for building long-running, stateful agents as graphs.
Semantic Kernel: Microsoft's model-agnostic SDK for building AI agents; its README calls Microsoft Agent Framework the enterprise-ready successor.

See all alternatives to Cloudflare Agents SDK

FAQ

What is the Cloudflare Agents SDK?

Cloudflare's MIT-licensed agents package for TypeScript. Each agent is a Durable Object with its own state, storage and lifecycle, with built-in real-time sync, scheduling, AI model calls, MCP and workflows, per its README.

What is the latest Cloudflare Agents release?

agents@0.33.0, released Nov 3, 2026 (checked on GitHub Nov 11). It moves the Pi harness to Pi 1.5 and cannot be rolled back once conversations run on Pi 1.5.

Why does my agents/mcp build fail after upgrading?

Since 0.31.0, @modelcontextprotocol/sdk and @modelcontextprotocol/server are optional peer dependencies. Install them yourself; 0.32.0 moved to sdk 1.32.2 and server 2.4.0.

Is the Cloudflare Agents SDK free?

The package is MIT open source. Running it uses Cloudflare Workers and Durable Objects, which Cloudflare bills under its own plans; we have not priced a deployment.

What we have not verified

Cloudflare Workers and Durable Objects costs for a real agent workload
Performance figures (the 27x and 88-to-459 runs a second numbers are Cloudflare's release notes)
Behaviour in production (not tested)

Sources

agents@0.33.0 release (fetched 2026-11-11)
agents@0.32.0 release (fetched 2026-11-11)
agents@0.31.0 release (fetched 2026-11-11)
agents@0.30.0 release (fetched 2026-11-11)
README (fetched 2026-11-11)
Cloudflare Agents docs (fetched 2026-11-11)

Last verified Nov 11, 2026 · Agentic Weekly

Part of the week of Nov 2, 2026 archive.

Semantic Kernel: Microsoft's model-agnostic SDK for building AI agents; its README calls Microsoft Agent Framework the enterprise-ready successor.
Langflow: MIT-licensed visual builder for AI agents and MCP servers with a very large GitHub following.
Botpress: Customer-support AI agent platform with a free plan and conversation-based paid plans.

How to cite this page

Agentic Weekly, "Cloudflare Agents SDK agents@0.33.0: what's new, verdict & setup", last updated 2026-11-11, https://theagenticweekly.com/tools/cloudflare-agents

Keep the Reported or Tested label when you quote a verdict. Plain-text version: https://theagenticweekly.com/tools/cloudflare-agents.md. More for AI assistants: /ai, /tools.json, /llms.txt.

Want the next verdict in your inbox?

One email every Monday. The week's few big releases, each with one call: update now, worth a look, or skip.
5 use cases for the new models, each with a prompt you can paste. Suggested by us, labelled when we have not run them.
Every claim shows its evidence. Reported means we read the sources; Tested means we ran it, with the exact scope and the failures left in.
A free AI Tools Cheat Sheet (web page and printable PDF) lands in your inbox when you confirm.

At a glance

Evidence and ranking