Cloudflare Agents SDK 0.32.0 rebuilds Agent Skills loading

Updated Oct 29, 2026Cloudflare Agents SDK

Summary

Cloudflare agents 0.32.0 (October 29, 2026) replaces SkillRegistry with spec-checked skills from workspaces, R2 or code and adds OpenTelemetry spans.

Tool: Cloudflare Agents SDK
Category: Frameworks
Date: Oct 29, 2026
Open source: Yes
License: MIT
MCP: Yes
Pricing: Not stated in the sources we cited.
Sources: GitHub release agents@0.32.0
GitHub release @cloudflare/think@0.23.0
GitHub release agents@0.31.0
Agents docs: Agent Skills
npm: agents

Cloudflare published agents 0.32.0 on October 29, 2026, two days after 0.31.0. It reached npm as latest the same day. GitHub releases for @cloudflare/think 0.23.0 and @cloudflare/codemode 0.5.6 went out with it. The headline is a breaking rewrite of Agent Skills. The rest is observability, smaller bundles and MCP SDK bumps.

Release facts

Fact	Detail
Product	Cloudflare Agents SDK (npm `agents`)
Version	0.32.0
Release date	October 29, 2026 (GitHub release and npm)
Previous release	0.31.0, October 27, 2026
Shipped with	`@cloudflare/think` 0.23.0, `@cloudflare/codemode` 0.5.6
License	MIT
Install	`npm i agents@0.32.0`

Check before upgrading

SkillRegistry is gone. Use loadSkillCatalog(), plus createSkillTools() from agents/skills/tools/ai-sdk. runner() moved to agents/skills/runner. The agents:skills Vite import and agents/skills/compile were removed.
Skills are checked against the Agent Skills spec. SKILL.md files are validated, and skills that break a rule still load, with warnings.
Think changed too (0.23.0, breaking): getSkills() sources reload every turn. An overridden getSystemPrompt() now always renders above context blocks. skillWorkspace and the "skill" context block type were removed.
Coming from 0.30 or earlier? 0.31.0 made @modelcontextprotocol/sdk and @modelcontextprotocol/server optional peers. If you serve MCP, add them to package.json or builds fail on an unresolved import.

What changed

Skill sources: agents/skills loads skills from Cloudflare Computer workspace files (workspace()), R2 (r2()) or code (manifest()).
OpenTelemetry bridge (experimental): experimental_registerOpenTelemetry() in agents/observability records spans from OpenTelemetry-instrumented libraries as Workers trace spans. SDK spans now set status error on failure where the runtime supports Span.setStatus().
Smaller bundles: the package is marked side-effect free apart from the CLI, so import { routeAgentRequest } from "agents" no longer bundles the MCP client.
MCP: @modelcontextprotocol/client and server go to 2.4.0 and @modelcontextprotocol/sdk to 1.32.2. DurableObjectOAuthClientProvider gets a clientMetadataUrl option for OAuth Client ID Metadata Documents.
Other: agents/models/pi-ai parses streamed tool-call arguments incrementally, and the TanStack AI peer range allows 1.x.

Questions

Should I upgrade now? Upgrade now if you don't use agents/skills or Think skills, since the other changes are additive. If you do use them, budget time for the SkillRegistry migration and the Think prompt-order change.

What did 0.31.0 add? Internal hostnames for Browser Run (up to eight per browser, served by your agent or another Worker), a browserTool that runs model code in its own Dynamic Worker, and stable agents/models/ai-sdk and agents/models/pi-ai.

Is this the Sandbox SDK? No. Sandboxes are a separate package. See the Cloudflare Sandbox SDK hub.

More: the Agents SDK hub, the frameworks category, and today's other launch, Crush 0.99.0.

Alternatives

Cloudflare Agents SDK compared with its alternatives
Tool	License	Pricing note
Cloudflare Agents SDKThis launchCloudflare's MIT TypeScript SDK (npm: agents) for durable agents on Durable Objects, with state, scheduling, MCP, browser tools and harnesses.	MIT	The SDK is MIT and free on npm; agents run on Cloudflare Workers and Durable Objects, billed under Cloudflare's own plans.
MastraTypeScript agent framework. Mastra Code is the terminal agent; AgentController is the extracted loop, in @mastra/core 1.47.0 or later.	Open source	Mastra Code and AgentController are announced as open source. No license fee is stated in the posts we cited.
OpenAI AgentsOpenAI's agent harness, shipped as a Python SDK update in April 2026 and as the hosted Agents API in September 2026.	Open source	SDK and Agents API use standard token and tool pricing. The Agents API has no additional fee.

Questions

What is the Cloudflare Agents SDK?

The npm package agents from cloudflare/agents. The docs say each agent is a Durable Object with a durable identity, local SQL storage, real-time connections, scheduled work and recoverable execution, and that you add capabilities such as State, WebSockets, Scheduler and an MCP client with .use().

Is the Cloudflare Agents SDK open source?

Yes. The GitHub API and npm both report the MIT license for cloudflare/agents and the agents package.

Which agent loops does it run?

The docs call the agent loop a harness and list Pi, OpenCode and Think. The getting-started guide uses the Pi harness through optional peer dependencies (@earendil-works/pi-durable and pi-ai), with Workers AI as the model so no API key is needed.

Can it serve or call MCP servers?

Both. agents/mcp and agents/mcp/server serve MCP, and agents/mcp/client connects to remote servers. Since 0.31.0 the MCP packages are optional peer dependencies you add yourself.

Filed on Agent Radar. Claims in this note are limited to the sources above.