Repository navigation
[Agents] Add a durable agents concept - #34728
Closed
mattzcarey wants to merge 36 commits into
Closed
mattzcarey wants to merge 36 commits into
mattzcarey wants to merge 36 commits into
Conversation
- 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
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
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
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
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
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
… work 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
mattzcarey
force-pushed
the
claude/agents-sdk-docs-framing-4ywlcx-10-guides
branch
from
October 29, 2026 14:28
29e7052 to
3bd3c4e
Compare
Member
Author
|
Folded into #34722, which now holds all the concept changes and targets production. |
🚀 Deploying Preview to Cloudflare 🚀Preview Deployments by commit
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.
concepts/durable-execution/toconcepts/durable-agents/.Documentation checklist