Skip to content

[Agents] Changelog: run a harness on a Durable Object, with a stable Lifecycle #33977

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
mattzcarey wants to merge 11 commits into from
Closed

[Agents] Changelog: run a harness on a Durable Object, with a stable Lifecycle #33977

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
53d1651
[Agents] Move the Agent class docs under /agents/agent-class/
mattzcarey Oct 27, 2026
c1c13d1
[Agents] Address style review: relative links, refer to, serial comma…
mattzcarey Oct 27, 2026
efae357
[Agents] Rewrite the core Agents docs around harnesses
mattzcarey Oct 27, 2026
e966810
[Agents] Update harness docs for Pi 1.4 and agents@0.30, link the Cod…
mattzcarey Oct 27, 2026
09c61e1
[Agents] Remove the AI SDK harness docs
mattzcarey Oct 27, 2026
eeae823
[Agents] Reword catch-alls for the typos check
mattzcarey Oct 27, 2026
9c5077e
[Agents] Document each capability on its own page
mattzcarey Oct 27, 2026
a1ef2aa
[Agents] Drop the RPC-only env option from the MCP client capability
mattzcarey Oct 27, 2026
6651400
[Agents] Changelog: run a harness on a Durable Object, with a stable …
mattzcarey Oct 27, 2026
d81567d
[Agents] Date the changelog for today, show a complete Pi harness, an…
mattzcarey Oct 27, 2026
824ae9b
[Agents] Remove the AI SDK harness from the changelog
mattzcarey Oct 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
139 changes: 90 additions & 49 deletions public/__redirects
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -240,83 +240,124 @@
/aegis/analytics/ /smart-shield/configuration/dedicated-egress-ips/ips-utilization/ 301

# agents
/agents/runtime/ /agents/lifecycle/ 301
/agents/runtime/execution/ /agents/agent-class/ 301
/agents/runtime/execution/agent-skills/ /agents/tools/agent-skills/ 301
/agents/runtime/lifecycle/ /agents/lifecycle/ 301
/agents/runtime/lifecycle/get-current-agent/ /agents/lifecycle/get-current-agent/ 301
/agents/runtime/lifecycle/sessions/ /agents/capabilities/sessions/ 301
/agents/runtime/operations/ /agents/platform/ 301
/agents/runtime/operations/configuration/ /agents/platform/configuration/ 301
/agents/runtime/operations/cross-domain-authentication/ /agents/platform/cross-domain-authentication/ 301
/agents/runtime/operations/observability/ /agents/platform/observability/ 301
/agents/runtime/operations/observability/diagnostics-channels/ /agents/platform/observability/diagnostics-channels/ 301
/agents/runtime/operations/observability/tracing/ /agents/platform/observability/tracing/ 301
/agents/communication-channels/ /agents/agent-class/communication-channels/ 301
/agents/communication-channels/chat/ /agents/agent-class/communication-channels/chat/ 301
/agents/communication-channels/chat/autonomous-responses/ /agents/agent-class/communication-channels/chat/autonomous-responses/ 301
/agents/communication-channels/chat/chat-agents/ /agents/agent-class/communication-channels/chat/chat-agents/ 301
/agents/communication-channels/chat/client-sdk/ /agents/agent-class/communication-channels/chat/client-sdk/ 301
/agents/communication-channels/email/ /agents/agent-class/communication-channels/email/ 301
/agents/communication-channels/slack/ /agents/agent-class/communication-channels/slack/ 301
/agents/communication-channels/voice/ /agents/agent-class/communication-channels/voice/ 301
/agents/communication-channels/webhooks/ /agents/agent-class/communication-channels/webhooks/ 301
/agents/communication-channels/webhooks/push-notifications/ /agents/agent-class/communication-channels/webhooks/push-notifications/ 301
/agents/runtime/agents-api/ /agents/agent-class/ 301
/agents/runtime/communication/ /agents/agent-class/ 301
/agents/runtime/communication/chat-sdk/ /agents/agent-class/communication-channels/chat-sdk/ 301
/agents/runtime/communication/http-sse/ /agents/agent-class/http-sse/ 301
/agents/runtime/communication/protocol-messages/ /agents/agent-class/protocol-messages/ 301
/agents/runtime/communication/readonly-connections/ /agents/agent-class/readonly-connections/ 301
/agents/runtime/communication/routing/ /agents/agent-class/routing/ 301
/agents/runtime/communication/websockets/ /agents/agent-class/websockets/ 301
/agents/runtime/execution/agent-tools/ /agents/agent-class/agent-tools/ 301
/agents/runtime/execution/durable-execution/ /agents/agent-class/durable-execution/ 301
/agents/runtime/execution/queue-tasks/ /agents/agent-class/queue-tasks/ 301
/agents/runtime/execution/retries/ /agents/agent-class/retries/ 301
/agents/runtime/execution/run-workflows/ /agents/agent-class/run-workflows/ 301
/agents/runtime/execution/schedule-tasks/ /agents/agent-class/schedule-tasks/ 301
/agents/runtime/execution/sub-agents/ /agents/agent-class/sub-agents/ 301
/agents/runtime/lifecycle/agent-class/ /agents/agent-class/internals/ 301
/agents/runtime/lifecycle/callable-methods/ /agents/agent-class/callable-methods/ 301
/agents/runtime/lifecycle/state/ /agents/agent-class/state/ 301
/agents/runtime/operations/using-ai-models/ /agents/agent-class/using-ai-models/ 301
/agents/api-reference/think/ /agents/harnesses/think/ 301
/agents/think/ /agents/harnesses/think/ 301
/agents/build/prompts/ /workers/get-started/prompting/ 301
/agents/getting-started/build-a-chat-agent/ /agents/examples/chat-agent/ 301
/agents/examples/browse-the-web/ /agents/tools/browser/ 301
/agents/examples/manage-and-sync-state/ /agents/runtime/lifecycle/state/ 301
/agents/examples/manage-and-sync-state/ /agents/agent-class/state/ 301
/agents/examples/rag/ /agents/tools/ai-search/ 301
/agents/tools/rag/ /agents/tools/ai-search/ 301
/agents/examples/run-workflows/ /agents/runtime/execution/run-workflows/ 301
/agents/examples/schedule-tasks/ /agents/runtime/execution/schedule-tasks/ 301
/agents/examples/using-ai-models/ /agents/runtime/operations/using-ai-models/ 301
/agents/examples/websockets/ /agents/runtime/communication/websockets/ 301
/agents/examples/sdk/ /agents/runtime/agents-api/ 301
/agents/examples/run-workflows/ /agents/agent-class/run-workflows/ 301
/agents/examples/schedule-tasks/ /agents/agent-class/schedule-tasks/ 301
/agents/examples/using-ai-models/ /agents/agent-class/using-ai-models/ 301
/agents/examples/websockets/ /agents/agent-class/websockets/ 301
/agents/examples/sdk/ /agents/agent-class/ 301
/agents/examples/build-mcp-server/ /agents/model-context-protocol/guides/remote-mcp-server/ 301
/agents/api-reference/build-mcp-server/ /agents/model-context-protocol/guides/remote-mcp-server/ 301
/agents/api-reference/sdk/ /agents/runtime/agents-api/ 301
/agents/api-reference/sdk/ /agents/agent-class/ 301
/agents/guides/build-mcp-server/ /agents/model-context-protocol/guides/remote-mcp-server/ 301
/agents/capabilities/mcp-server/ /agents/model-context-protocol/ 301
/agents/model-context-protocol/mcp-agent-api/ /agents/model-context-protocol/apis/agent-api/ 301
/agents/model-context-protocol/mcp-client-api/ /agents/model-context-protocol/apis/client-api/ 301
/agents/model-context-protocol/mcp-handler-api/ /agents/model-context-protocol/apis/handler-api/ 301
/agents/api-reference/calling-agents/ /agents/runtime/communication/routing/ 301
/agents/api-reference/calling-agents/ /agents/agent-class/routing/ 301
/agents/community-mcp-server/ /agents/model-context-protocol/cloudflare/servers-for-cloudflare/community-mcp-server/ 301
/agents/patterns/ /agents/concepts/agentic-patterns/ 301
/agents/concepts/patterns/ /agents/concepts/agentic-patterns/ 301
/agents/concepts/anthropic-agent-patterns/ /agents/concepts/agentic-patterns/ 301
/agents/concepts/human-in-the-loop/ /agents/concepts/agentic-patterns/human-in-the-loop/ 301
/agents/concepts/long-running-agents/ /agents/concepts/agentic-patterns/long-running-agents/ 301
/agents/api-reference/agents-api/ /agents/runtime/agents-api/ 301
/agents/api-reference/ /agents/runtime/ 301
/agents/api-reference/chat-sdk/ /agents/runtime/communication/chat-sdk/ 301
/agents/runtime/execution/chat-sdk/ /agents/runtime/communication/chat-sdk/ 301
/agents/api-reference/agent-tools/ /agents/runtime/execution/agent-tools/ 301
/agents/api-reference/agents-api/ /agents/agent-class/ 301
/agents/api-reference/ /agents/lifecycle/ 301
/agents/api-reference/chat-sdk/ /agents/agent-class/communication-channels/chat-sdk/ 301
/agents/runtime/execution/chat-sdk/ /agents/agent-class/communication-channels/chat-sdk/ 301
/agents/api-reference/agent-tools/ /agents/agent-class/agent-tools/ 301
/agents/api-reference/browse-the-web/ /agents/tools/browser/ 301
/agents/api-reference/callable-methods/ /agents/runtime/lifecycle/callable-methods/ 301
/agents/api-reference/chat-agents/ /agents/communication-channels/chat/chat-agents/ 301
/agents/api-reference/client-sdk/ /agents/communication-channels/chat/client-sdk/ 301
/agents/api-reference/callable-methods/ /agents/agent-class/callable-methods/ 301
/agents/api-reference/chat-agents/ /agents/agent-class/communication-channels/chat/chat-agents/ 301
/agents/api-reference/client-sdk/ /agents/agent-class/communication-channels/chat/client-sdk/ 301
/agents/api-reference/codemode/ /agents/tools/codemode/api-reference/ 301
/agents/api-reference/configuration/ /agents/runtime/operations/configuration/ 301
/agents/api-reference/durable-execution/ /agents/runtime/execution/durable-execution/ 301
/agents/api-reference/email/ /agents/communication-channels/email/ 301
/agents/api-reference/get-current-agent/ /agents/runtime/lifecycle/get-current-agent/ 301
/agents/api-reference/http-sse/ /agents/runtime/communication/http-sse/ 301
/agents/api-reference/configuration/ /agents/platform/configuration/ 301
/agents/api-reference/durable-execution/ /agents/agent-class/durable-execution/ 301
/agents/api-reference/email/ /agents/agent-class/communication-channels/email/ 301
/agents/api-reference/get-current-agent/ /agents/lifecycle/get-current-agent/ 301
/agents/api-reference/http-sse/ /agents/agent-class/http-sse/ 301
/agents/api-reference/mcp-agent-api/ /agents/model-context-protocol/apis/agent-api/ 301
/agents/api-reference/mcp-client-api/ /agents/model-context-protocol/apis/client-api/ 301
/agents/api-reference/mcp-handler-api/ /agents/model-context-protocol/apis/handler-api/ 301
/agents/api-reference/observability/ /agents/runtime/operations/observability/ 301
/agents/api-reference/protocol-messages/ /agents/runtime/communication/protocol-messages/ 301
/agents/api-reference/queue-tasks/ /agents/runtime/execution/queue-tasks/ 301
/agents/api-reference/observability/ /agents/platform/observability/ 301
/agents/api-reference/protocol-messages/ /agents/agent-class/protocol-messages/ 301
/agents/api-reference/queue-tasks/ /agents/agent-class/queue-tasks/ 301
/agents/api-reference/rag/ /agents/tools/ai-search/ 301
/agents/api-reference/readonly-connections/ /agents/runtime/communication/readonly-connections/ 301
/agents/api-reference/retries/ /agents/runtime/execution/retries/ 301
/agents/api-reference/routing/ /agents/runtime/communication/routing/ 301
/agents/api-reference/run-workflows/ /agents/runtime/execution/run-workflows/ 301
/agents/api-reference/schedule-tasks/ /agents/runtime/execution/schedule-tasks/ 301
/agents/api-reference/sessions/ /agents/runtime/lifecycle/sessions/ 301
/agents/api-reference/store-and-sync-state/ /agents/runtime/lifecycle/state/ 301
/agents/api-reference/sub-agents/ /agents/runtime/execution/sub-agents/ 301
/agents/api-reference/using-ai-models/ /agents/runtime/operations/using-ai-models/ 301
/agents/api-reference/voice/ /agents/communication-channels/voice/ 301
/agents/api-reference/websockets/ /agents/runtime/communication/websockets/ 301
/agents/api-reference/readonly-connections/ /agents/agent-class/readonly-connections/ 301
/agents/api-reference/retries/ /agents/agent-class/retries/ 301
/agents/api-reference/routing/ /agents/agent-class/routing/ 301
/agents/api-reference/run-workflows/ /agents/agent-class/run-workflows/ 301
/agents/api-reference/schedule-tasks/ /agents/agent-class/schedule-tasks/ 301
/agents/api-reference/sessions/ /agents/capabilities/sessions/ 301
/agents/api-reference/store-and-sync-state/ /agents/agent-class/state/ 301
/agents/api-reference/sub-agents/ /agents/agent-class/sub-agents/ 301
/agents/api-reference/using-ai-models/ /agents/agent-class/using-ai-models/ 301
/agents/api-reference/voice/ /agents/agent-class/communication-channels/voice/ 301
/agents/api-reference/websockets/ /agents/agent-class/websockets/ 301
/agents/guides/anthropic-agent-patterns/ /agents/concepts/agentic-patterns/ 301
/agents/guides/autonomous-responses/ /agents/communication-channels/chat/autonomous-responses/ 301
/agents/guides/autonomous-responses/ /agents/agent-class/communication-channels/chat/autonomous-responses/ 301
/agents/guides/build-a-voice-agent/ /agents/examples/voice-agent/ 301
/agents/guides/build-mcp-client/ /agents/model-context-protocol/guides/build-mcp-client/ 301
/agents/guides/chatgpt-app/ /workers/demos/chatgpt-app/ 301
/agents/communication-channels/chat/chatgpt-app/ /workers/demos/chatgpt-app/ 301
/agents/guides/connect-mcp-client/ /agents/model-context-protocol/guides/connect-mcp-client/ 301
/agents/guides/cross-domain-authentication/ /agents/runtime/operations/cross-domain-authentication/ 301
/agents/guides/cross-domain-authentication/ /agents/platform/cross-domain-authentication/ 301
/agents/guides/human-in-the-loop/ /agents/concepts/agentic-patterns/human-in-the-loop/ 301
/agents/guides/oauth-mcp-client/ /agents/model-context-protocol/guides/oauth-mcp-client/ 301
/agents/guides/push-notifications/ /agents/communication-channels/webhooks/push-notifications/ 301
/agents/guides/push-notifications/ /agents/agent-class/communication-channels/webhooks/push-notifications/ 301
/agents/guides/remote-mcp-server/ /agents/model-context-protocol/guides/remote-mcp-server/ 301
/agents/guides/securing-mcp-server/ /agents/model-context-protocol/guides/securing-mcp-server/ 301
/agents/guides/slack-agent/ /agents/examples/slack-agent/ 301
/agents/guides/test-remote-mcp-server/ /agents/model-context-protocol/guides/test-remote-mcp-server/ 301
/agents/guides/webhooks/ /agents/communication-channels/webhooks/ 301
/agents/guides/webhooks/ /agents/agent-class/communication-channels/webhooks/ 301
/agents/model-context-protocol/authorization/ /agents/model-context-protocol/protocol/authorization/ 301
/agents/model-context-protocol/protocol/codemode/ /agents/tools/codemode/ 301
/agents/model-context-protocol/codemode/ /agents/model-context-protocol/guides/build-codemode-mcp-server/ 301
Expand All @@ -335,23 +376,23 @@
/agents/agentic-payments/x402/pay-with-tool-plugins/ /agents/tools/payments/x402/pay-with-tool-plugins/ 301
/agents/agentic-payments/mpp/ /agents/tools/payments/mpp/ 301
/agents/guides/ /agents/model-context-protocol/guides/ 301
/agents/concepts/agent-class/ /agents/runtime/lifecycle/agent-class/ 301
/agents/concepts/agent-class/ /agents/agent-class/internals/ 301
/agents/concepts/memory/ /agents/concepts/conversation-state-and-memory/ 301
/agents/getting-started/prompting/ /workers/get-started/prompting/ 301
/agents/platform/prompting/ /workers/get-started/prompting/ 301
/agents/platform/prompt.txt/ /workers/prompt.txt 301
/agents/channels/chat/ /agents/communication-channels/chat/ 301
/agents/channels/chat/chat-agents/ /agents/communication-channels/chat/chat-agents/ 301
/agents/channels/chat/client-sdk/ /agents/communication-channels/chat/client-sdk/ 301
/agents/channels/chat/autonomous-responses/ /agents/communication-channels/chat/autonomous-responses/ 301
/agents/channels/chat/ /agents/agent-class/communication-channels/chat/ 301
/agents/channels/chat/chat-agents/ /agents/agent-class/communication-channels/chat/chat-agents/ 301
/agents/channels/chat/client-sdk/ /agents/agent-class/communication-channels/chat/client-sdk/ 301
/agents/channels/chat/autonomous-responses/ /agents/agent-class/communication-channels/chat/autonomous-responses/ 301
/agents/channels/chat/chatgpt-app/ /workers/demos/chatgpt-app/ 301
/agents/channels/voice/ /agents/communication-channels/voice/ 301
/agents/channels/voice/ /agents/agent-class/communication-channels/voice/ 301
/agents/channels/voice/build-a-voice-agent/ /agents/examples/voice-agent/ 301
/agents/channels/email/ /agents/communication-channels/email/ 301
/agents/channels/slack/ /agents/communication-channels/slack/ 301
/agents/channels/email/ /agents/agent-class/communication-channels/email/ 301
/agents/channels/slack/ /agents/agent-class/communication-channels/slack/ 301
/agents/channels/slack/slack-agent/ /agents/examples/slack-agent/ 301
/agents/channels/webhooks/ /agents/communication-channels/webhooks/ 301
/agents/channels/webhooks/push-notifications/ /agents/communication-channels/webhooks/push-notifications/ 301
/agents/channels/webhooks/ /agents/agent-class/communication-channels/webhooks/ 301
/agents/channels/webhooks/push-notifications/ /agents/agent-class/communication-channels/webhooks/push-notifications/ 301
/agents/communication-channels/voice/build-a-voice-agent/ /agents/examples/voice-agent/ 301
/agents/communication-channels/slack/slack-agent/ /agents/examples/slack-agent/ 301
/agents/tools/browser/browse-the-web/ /agents/tools/browser/ 301
Expand Down
51 changes: 29 additions & 22 deletions src/components/cf/AgentsPlatformDiagram.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,37 +3,37 @@ const channels = [
{
type: "Chat",
name: "AIChatAgent",
href: "/agents/communication-channels/chat/",
href: "/agents/agent-class/communication-channels/chat/",
},
{
type: "Email",
name: "onEmail",
href: "/agents/communication-channels/email/",
href: "/agents/agent-class/communication-channels/email/",
},
{
type: "Voice",
name: "withVoice",
href: "/agents/communication-channels/voice/",
href: "/agents/agent-class/communication-channels/voice/",
},
{
type: "Slack",
name: "Events",
href: "/agents/communication-channels/slack/",
href: "/agents/agent-class/communication-channels/slack/",
},
{
type: "Webhook",
name: "HTTP",
href: "/agents/communication-channels/webhooks/",
href: "/agents/agent-class/communication-channels/webhooks/",
},
];

const runtime = [
{ label: "State", href: "/agents/runtime/lifecycle/state/" },
{ label: "Sessions", href: "/agents/runtime/lifecycle/sessions/" },
{ label: "Routing", href: "/agents/runtime/communication/routing/" },
{ label: "WebSockets", href: "/agents/runtime/communication/websockets/" },
{ label: "Scheduling", href: "/agents/runtime/execution/schedule-tasks/" },
{ label: "Fibers", href: "/agents/runtime/execution/durable-execution/" },
{ label: "MCP client", href: "/agents/capabilities/mcp-client/" },
{ label: "Scheduler", href: "/agents/capabilities/scheduler/" },
{ label: "Queue", href: "/agents/capabilities/queue/" },
{ label: "WebSockets", href: "/agents/capabilities/websockets/" },
{ label: "Sessions", href: "/agents/capabilities/sessions/" },
{ label: "Tasks", href: "/agents/capabilities/tasks/" },
];

const tools = [
Expand Down Expand Up @@ -94,20 +94,26 @@ const tools = [
<p>Controls planning, tool use, and response flow.</p>
</div>
<div class="section-row">
<a href="/agents/harnesses/pi/">Pi harness</a>
<a href="/agents/runtime/agents-api/">Build-your-own agent</a>
<a href="/agents/harnesses/pi/">Pi</a>
<a href="/agents/harnesses/opencode/">OpenCode</a>
<a href="/agents/harnesses/container/">Containers</a>
<a href="/agents/harnesses/think/">Project Think</a>
<a href="/agents/harnesses/#build-your-own-harness">
Build your own
</a>
</div>
</div>

<div class="agent-section runtime-section">
<div class="agent-section-copy">
<div class="section-title">Agents SDK runtime</div>
<div class="section-title">Durable Object and capabilities</div>
<p>
Durable identity, state, connections, scheduling, and recovery.
The Lifecycle keeps the harness running. Plug in what else it
needs.
</p>
</div>
<a class="agent-class" href="/agents/runtime/agents-api/">
Agent class
<a class="agent-class" href="/agents/lifecycle/">
Lifecycle
</a>
<div class="runtime-list">
{runtime.map((item) => (
Expand All @@ -132,10 +138,7 @@ const tools = [
</div>
</section>

<a
class="observability-card"
href="/agents/runtime/operations/observability/"
>
<a class="observability-card" href="/agents/platform/observability/">
<span class="observability-title">Observability</span>
<span class="observability-copy">Logs · metrics · traces</span>
</a>
Expand Down Expand Up @@ -387,11 +390,15 @@ const tools = [

.section-row {
display: grid;
grid-template-columns: 1fr;
grid-template-columns: repeat(2, minmax(0, 1fr));
gap: 6px;
margin-top: 9px;
}

.section-row a:last-child:nth-child(odd) {
grid-column: 1 / -1;
}

.section-row a,
.agent-class,
.runtime-list a {
Expand Down
2 changes: 1 addition & 1 deletion src/content/agent-setup/tracing.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -167,7 +167,7 @@ State any validation command that could not run and why.

## Resources

- Agent tracing and framework setup: `https://developers.cloudflare.com/agents/runtime/operations/observability/tracing/`
- Agent tracing and framework setup: `https://developers.cloudflare.com/agents/platform/observability/tracing/`
- Workers tracing and sampling: `https://developers.cloudflare.com/workers/observability/traces/`

These instructions are published at `https://developers.cloudflare.com/agent-setup/tracing.md` so you can re-verify their authenticity at any time.
Loading
Loading