Skip to content

[Agents] Add a durable agents concept - #34728

Closed
mattzcarey wants to merge 36 commits into
claude/agents-sdk-docs-framing-4ywlcx-10-guidesfrom
claude/agents-sdk-docs-framing-4ywlcx-11-durable-agents
Closed

mattzcarey wants to merge 36 commits into
claude/agents-sdk-docs-framing-4ywlcx-10-guidesfrom
claude/agents-sdk-docs-framing-4ywlcx-11-durable-agents

Conversation

@mattzcarey

Copy link
Copy Markdown
Member

Summary

Part of the Agents docs restructure stack. Based on #34727 (claude/agents-sdk-docs-framing-4ywlcx-10-guides); merge that first.

Replaces the durable execution concept with a durable agents concept. A Durable Object gives an agent durable storage and one alarm, not durable work. The page explains how the Lifecycle turns SQLite and the alarm into a durable job queue, and what that means for agent code.

  • Updates links from the Agent class, long-running agents, harnesses, models, runtime, workflows and what-are-agents pages.
  • Adds a redirect from concepts/durable-execution/ to concepts/durable-agents/.

Documentation checklist

mattzcarey and others added 30 commits October 28, 2026 16:47
- Quick start now builds a Pi harness agent on a Durable Object with the
  lifecycle and a Scheduler (agents@0.31.0, Pi 1.4). The counter guide
  moves to getting-started/learn-the-runtime.
- Overview states the hierarchy: Durable Object, lifecycle, capabilities,
  with the harness as the capability that runs the agent loop. Links the
  Cloudflare Computer workspace, web fetch, web search, and the MCP client
  reference; describes the Agent class as a preset.
- Platform diagram: Durable Object, Lifecycle, stable capabilities, and
  the Pi harness replace the Agent class and Fibers labels; adds
  Workspace, Web fetch, and Web search tools.
- Add to an existing project: drop the Queue row, fix the MCP client link.
- Testing: remove unused imports, the agents-starter mention, and a full URL.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Rewrite the Runtime section index and the Lifecycle overview, and add
routing, jobs and alarms, build a capability, and capability API
reference pages. Rewrite getCurrentAgent() for a plain Durable Object.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Document the stable Lifecycle capabilities (WebSockets, State, Scheduler,
MCPClientManager) on plain Durable Objects, add a capabilities overview with
capability types, and move the client SDK to /agents/runtime/client/.
Remove the stale runtime/lifecycle/sessions page, which documents removed APIs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Move runtime/operations (configuration, cross-domain authentication,
observability, tracing, diagnostics channels) to /agents/platform/ and
merge the operations index into the platform index (sidebar order 11).

Diagnostics channels now lists all 15 channels and the prefix routing,
documents Lifecycle job-queue events and custom capability events on
agents:lifecycle, and moves the observability override under an
"On the Agent class" section. Configuration and cross-domain auth use
plain Durable Object + Lifecycle examples.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
…ties

Add concept pages for harnesses, runtime, skills, workspace, channels and
durable execution. Rename calling-llms to models and
conversation-state-and-memory to memory, reframe tools, workflows,
human-in-the-loop and long-running agents, and remove runtime/execution.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Rewrite the harnesses index (a harness is a pre-built agent loop and a
Lifecycle capability), add a build-your-own guide, add Connect a workspace
sections to Pi, Think, and OpenCode, add Think memory and context, document
Think's fetch tool, and fix stale Think APIs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
…lient split

- Tools index becomes a catalog with a tool x adapter matrix and how each tool is backed
- Rename tools/filesystem to tools/workspace: model-facing tools, adapters (new TanStack AI example), runtimes, Git, mounts, assets, shell migration note
- Add Think usage to web fetch, web search, and browser; experimental callout for the Browser capability
- Plain Durable Object examples for MCP tools and AI Search; note missing Pi adapters for MCP and Code Mode
- MCP index forks into server and client; client-api keeps the Agent methods and links to the MCP client capability
- Move the MPP HTTP content page under payments/mpp/
- Sidebar order: models 6, tools 7

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Rewrite the Agent class index around the Lifecycle and the seven installed
capabilities, rewrite sub-agents as dynamic agents (this.dynamicAgents),
move voice imports to agents/voice, add Agent class get-started pages with
the deleted partials inlined, and point capability-backed pages to the
runtime capability pages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
…and capabilities

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017x2hF1BzfPSifknGZh4YNJ
@github-actions github-actions Bot added the product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. label Oct 29, 2026
@mattzcarey
mattzcarey force-pushed the claude/agents-sdk-docs-framing-4ywlcx-10-guides branch from 29e7052 to 3bd3c4e Compare October 29, 2026 14:28
@mattzcarey

Copy link
Copy Markdown
Member Author

Folded into #34722, which now holds all the concept changes and targets production.

@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Terminated ⛔

View logs ↗
82ca37f 2026-10-29T14:23:46.011Z View logs ↗

@mattzcarey mattzcarey closed this Oct 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants