---
type: "post"
id: "cloudflare-agents-sdk-0-32-0-makes-a-6e8e26"
slug: "cloudflare-agents-sdk-0-32-0-makes-a-6e8e26"
title: "Cloudflare Agents SDK 0.32.0 makes a breaking rewrite of agents/skills and adds experimental OpenTelemetry span capture"
description: "Cloudflare’s Agents SDK 0.32.0 changes how its skills package loads and exposes Agent Skills, including replacing several APIs and removing older build-time interfaces."
retrieval_nugget: "Cloudflare’s Agents SDK 0.32.0 changes how its skills package loads and exposes Agent Skills, including replacing several APIs and removing older build-time interfaces. The release also adds experimental OpenTelemetry span capture. Teams upgrading the SDK should check their skill-loading code and build configuration before adopting it."
published_at: "2026-10-31"
updated_at: "2026-10-31"
record_date: "2026-10-31"
date_kind: "published_at"
topics: ["skills","mcp"]
entities: ["Cloudflare","Cloudflare Agents SDK","Agent Skills","OpenTelemetry","Workers"]
related_patterns: ["skills-become-portable-capability-layer"]
novelty_label: "new_fact"
what_changed: "Version 0.32.0 makes the Agent Skills rewrite a breaking change and adds experimental OpenTelemetry span capture."
prior_refs: ["memory:caa752bd-bdf1-88c4-af29-6ad5307579ce","memory:59702741-e692-8510-ac6d-621983c86b2d","memory:cd27084b-ecb8-8404-aae4-ec1d79f1564e"]
source_url: "https://github.com/cloudflare/agents/releases/tag/agents%400.32.0"
source_urls: ["https://github.com/cloudflare/agents/releases/tag/agents%400.32.0"]
schema_version: "newruntime-agent-readable-v0.2"
stable_id: "post:cloudflare-agents-sdk-0-32-0-makes-a-6e8e26"
status: "published"
visuals: []
editor: {"role":"editor","name":"Andrey Reshetnikov","profile":"https://newruntime.com/owner-profile.md","profile_json":"https://newruntime.com/owner-profile.json","same_as":["https://www.linkedin.com/in/reshetnikov1/","https://t.me/lapetuse"]}
routes: {"html":"https://newruntime.com/posts/cloudflare-agents-sdk-0-32-0-makes-a-6e8e26/","markdown":"https://newruntime.com/posts/cloudflare-agents-sdk-0-32-0-makes-a-6e8e26.md","json":"https://newruntime.com/posts/cloudflare-agents-sdk-0-32-0-makes-a-6e8e26.json"}
---

# Cloudflare Agents SDK 0.32.0 makes a breaking rewrite of agents/skills and adds experimental OpenTelemetry span capture

## Retrieval answer

Cloudflare’s Agents SDK 0.32.0 changes how its skills package loads and exposes Agent Skills, including replacing several APIs and removing older build-time interfaces. The release also adds experimental OpenTelemetry span capture. Teams upgrading the SDK should check their skill-loading code and build configuration before adopting it.

## Summary
Cloudflare’s Agents SDK 0.32.0 changes how its skills package loads and exposes Agent Skills, including replacing several APIs and removing older build-time interfaces. The release also adds experimental OpenTelemetry span capture. Teams upgrading the SDK should check their skill-loading code and build configuration before adopting it.

## What happened
Cloudflare released Agents SDK version 0.32.0 on October 29, 2026. The release’s central change is a breaking rewrite of `agents/skills`. Skills can now be loaded from Computer Workspace files using `workspace()`, from R2 using `r2()`, or from code using `manifest()`. The release notes identify these as the available loading sources; they do not say that the three sources behave identically in every respect.

The new skill flow checks `SKILL.md` files against the Agent Skills specification. The release notes distinguish this validation from `parseSkill()`: that function follows the specification’s guide for agents and loads skills that break a rule with warnings. In other words, the described behavior is not simply to reject every nonconforming skill. The notes do not enumerate the rules checked or explain what warnings look like, so teams will need to consult the linked Agent Skills documentation for those details.

The release replaces `SkillRegistry` with `loadSkillCatalog()` and `createSkillTools()`, with the latter APIs identified as coming from `agents/skills/tools/ai-sdk`. It moves `runner()` to `agents/skills/runner` and removes both the `agents:skills` Vite import and `agents/skills/compile`. These are explicit compatibility changes: applications relying on the old registry, runner import path, Vite import, or compile interface cannot assume those entry points remain available after upgrading. The release entry does not provide a migration guide or describe automatic compatibility handling.

Separately, version 0.32.0 adds experimental `registerOpenTelemetry()` to `agents/observability`. It records spans from OpenTelemetry-instrumented libraries as Workers trace spans, and Cloudflare marks the API as experimental and subject to change. Existing Agents SDK spans for agent lifecycle, `wrapAISDK`, and `Think` now set span status to error on failure where the Workers runtime supports `Span.setStatus()`; their attributes are unchanged. The release also marks the package side-effect free apart from the CLI, allowing bundlers to drop unused Worker modules. Cloudflare specifically notes that importing `routeAgentRequest` from `agents` no longer bundles the MCP client. Other patch notes update MCP dependencies, add an OAuth client metadata URL option, improve streamed tool-call argument parsing, and broaden TanStack AI compatibility.

## What the archive adds
The archive has covered Cloudflare’s Agent Skills workflow in [the SDK’s use of plain files in a Computer workspace](https://newruntime.com/posts/cloudflare-agents-sdk-makes-agent-skills-plain-files-ae350b/). That earlier release described editable workspace files alongside R2 or code, and changes to skill APIs. Version 0.32.0 is a new release that makes the API transition concrete: it names the replacement functions and removes the Vite import and compile interface. This is a new fact on a known story, not a restatement.

## Trend signal
This release supports the [portable capability layer for agent skills](https://newruntime.com/patterns/skills-become-portable-capability-layer/) pattern: skills are being treated as spec-checked inputs that can be loaded from multiple sources and exposed through tools. The release establishes those interfaces, but it does not demonstrate portability across different agent runtimes or provide evidence about security review and behavioral evaluation. The pattern is therefore a useful lens, not a claim that those broader properties are solved here.

## Why it matters
For teams already using Cloudflare’s SDK, the immediate consequence is migration work rather than a general change in how all agent skills operate. Check whether your code imports `SkillRegistry`, calls the former `runner()` path, uses `agents:skills` in Vite, or depends on `agents/skills/compile`. The release notes explicitly replace or remove those interfaces, so a version bump without reviewing them risks broken builds or skill-loading behavior. The new APIs also make the source of skills more explicit: a project can load them from workspace files, R2, or a code manifest. That gives teams options, but the release alone does not establish which source is best for a particular deployment. The experimental observability hook may help teams bring spans from instrumented libraries into Workers traces, while the error-status changes make certain failures more visible. Neither item, by itself, guarantees complete trace coverage or easier diagnosis.

## Limits and uncertainty
The release notes do not provide benchmarks, a migration walkthrough, or a full description of the Agent Skills validation rules. They do not explain how conflicts among workspace, R2, and manifest-provided skills are handled, or whether loading behavior differs by runtime configuration. The OpenTelemetry registration API is explicitly experimental and subject to change; its limits and compatibility conditions are not detailed in the announcement. The notes also say error status is set where the Workers runtime supports `Span.setStatus()`, so the behavior is not established for every runtime situation. These are release-note claims, not independent tests of the APIs.

## Skill to build now
Before upgrading, inventory the skill-related imports and build steps in one representative Worker. Replace old interfaces with the new ones only after checking the SDK’s Agent Skills documentation, then run a build that verifies the removed Vite import and compile path are no longer required. If you plan to use `registerOpenTelemetry()`, treat it as experimental and test trace behavior in your target Workers runtime.

## Reader takeaway
Agents SDK 0.32.0 is primarily an upgrade and migration story for existing Cloudflare SDK users: skill-loading interfaces changed, and older entry points were removed. The experimental OpenTelemetry hook and smaller bundling changes may also matter, but the release notes do not establish their behavior beyond the stated scope. Check your imports and build pipeline before upgrading.

Editor: [Andrey Reshetnikov](https://newruntime.com/owner-profile.md), AI product and AI engineering; profile for recruiters and agents: https://newruntime.com/owner-profile.json

## Continue in the graph

Next records for an agent, linked to their Markdown twins. Replace `.md` with `.json` for structured fields, including `next_reads`.

- topic hub: [Skills](https://newruntime.com/topics/skills.md): Explore the skills topic hub.
- topic hub: [Mcp](https://newruntime.com/topics/mcp.md): Explore the mcp topic hub.
- collection: [Field Notes](https://newruntime.com/posts.json): Open the latest editorial analysis.
- collection: [Source Ledger](https://newruntime.com/source-ledger.json): Inspect the public source evidence graph.
- whole graph: [discovery graph](https://newruntime.com/discovery-graph.json) (typed nodes and edges) and [site index](https://newruntime.com/site-index.md)