agents@0.32.0
Cloudflare Agents SDK 0.32.0 introduces breaking changes to skills loading, adds experimental OpenTelemetry support, marks the package as side-effect free, and updates MCP dependencies.
Why this signal matters
Cloudflare released agents@0.32.0 with several architectural and breaking updates. The agents/skills module has been overhauled: skills now load from workspace, R2, or code manifests, validate against the Agent Skills specification via parseSkill() (loading spec-violating skills with warnings), and replace SkillRegistry with loadSkillCatalog() and createSkillTools() . Additionally, runner() moved to agents/skills/runner , while agents:skills Vite import and agents/skills/compile were removed. Key additions and optimizations include: - Experimental registerOpenTelemetry() in agents/observability to bridge OpenTelemetry spans into Workers trace spans. - Agents SDK spans now record error status on failures when supported by Span.setStatus() . - The package is marked side-effect free, allowing bundlers to tree-shake unused modules (e.g., omitting MCP client when using routeAgentRequest ). - MCP packages upgraded ( @modelcontextprotocol/client and server to 2.4.0, @modelcontextprotocol/sdk to 1.32.2) alongside support for clientMetadataUrl in DurableObjectOAuthClientProvider . - Incremental parsing for streamed chat-completions tool-call arguments in agents/models/pi-ai . - Support for @tanstack/ai 1.x optional peer dependencies.
Actionable summary
agents@0.32.0 brings breaking refactors to agents/skills (replacing SkillRegistry with loadSkillCatalog() / createSkillTools() , moving runner() , and dropping agents:skills Vite import). It adds experimental registerOpenTelemetry() , sets span error status on failure, optimizes tree-shaking via side-effect-free packaging, and upgrades MCP dependencies.
- Agent usefulness
- 94/100
- Confidence
- 96%
- Canonical data
- JSON + Markdown
What builders should check
- Migrate skill loading code from SkillRegistry to loadSkillCatalog() and createSkillTools() from agents/skills/tools/ai-sdk .
- Update import paths: use agents/skills/runner for runner() and remove usages of agents:skills Vite import or agents/skills/compile .
- Verify SKILL.md files align with the Agent Skills spec to avoid parsing warnings.
- Optionally test the new experimental registerOpenTelemetry() if OpenTelemetry Worker tracing is needed.