[mattzcarey]

agents/lifecycle and the Scheduler, State, WebSockets and MCPClientManager capabilities are no longer experimental. This removes their @experimental tags and the matching banners in docs/, and reorganizes docs/agents/index.md around a Durable Object with a Lifecycle and capabilities, with Agent as one way to get a preset of them.

Surface	Status
agents/lifecycle, Agent.lifecycle	Stable
Scheduler (agents/schedules)	Stable
State (agents/state)	Stable
WebSockets (agents/websockets)	Stable, except the Cap'n Web transport
MCPClientManager on a Lifecycle	Stable
PiHarness	Beta
Queue, Tasks, Streams, Sessions, RoutedAgents, Browser, dynamic agents	Experimental

export class Assistant extends DurableObject<Env> {
  readonly mcp = new MCPClientManager("assistant", "1.0.0");
  readonly scheduler = new Scheduler({ callbacks: {} });
  readonly lifecycle = Lifecycle.install(this).use(this.mcp).use(this.scheduler);
}

The developers.cloudflare.com side is a stack of four docs PRs (cloudflare/cloudflare-docs#33974, #33975, #33976, #33977). They move the Agent class docs under /agents/agent-class/, rewrite the core pages around the Lifecycle, add a page per capability, and add a changelog entry.

[changeset-bot]

🦋 Changeset detected

Latest commit: 3d019d9

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
agents	Patch
@cloudflare/agent-think	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[devin-ai-integration]

Devin Review found 1 potential issue.

[devin-ai-integration]

🔍 Cap'n Web stability boundary is unclear

Cap'n Web remains experimental, but the stable WebSockets documentation presents both transports together without marking the exception. Its exported transport helpers also lack an experimental annotation. Mark the exception where users encounter the transport.

---

Was this helpful? React with 👍 or 👎 to provide feedback.

[agent-think]

✅ agents import sizes: no significant changes (a3d490ee → 3d019d92, workflow run)

[pkg-pr-new]

Open in StackBlitz

agents

npm i https://pkg.pr.new/agents@2473

@cloudflare/ai-chat

npm i https://pkg.pr.new/@cloudflare/ai-chat@2473

@cloudflare/codemode

npm i https://pkg.pr.new/@cloudflare/codemode@2473

hono-agents

npm i https://pkg.pr.new/hono-agents@2473

@cloudflare/shell

npm i https://pkg.pr.new/@cloudflare/shell@2473

@cloudflare/think

npm i https://pkg.pr.new/@cloudflare/think@2473

@cloudflare/voice

npm i https://pkg.pr.new/@cloudflare/voice@2473

@cloudflare/worker-bundler

npm i https://pkg.pr.new/@cloudflare/worker-bundler@2473

commit: 3d019d9