Uh oh!
There was an error while loading. Please reload this page.
docs: deprecate DurableAgent and WorkflowChatTransport, point to AI SDK WorkflowAgent - #2616
Merged
Conversation
…DK WorkflowAgent - Add deprecation banners (with migration-guide link) to the DurableAgent and WorkflowChatTransport API references in v4 and v5; keep the full API surface intact - Bring v4 headline guides to parity with v5's WorkflowAgent migration (ai/index, foundations/streaming, the cookbook recipe + index) - Convert standard agent examples (defining-tools, message-queueing) to WorkflowAgent and reframe the streamText-vs comparison page - Banner + repoint the deep recipes that stream custom UIMessageChunk data parts (chat-session-modeling, human-in-the-loop, agent-cancellation, serializable-steps) — that pattern doesn't map to WorkflowAgent's ModelCallStreamPart model, so their legacy DurableAgent examples are kept behind a clear deprecation banner - Point all WorkflowChatTransport examples at the @ai-sdk/workflow 1:1 port - Rename the cookbook agent-patterns recipe to WorkflowAgent Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
Contributor
Uh oh!
There was an error while loading. Please reload this page.
Contributor
Backport to This is usually an infrastructure problem (e.g. the configured AI model could not be found, an AI Gateway error, or an opencode crash) rather than a merge conflict. Check the job logs linked above for details. Once the underlying issue is fixed, re-run the Backport to stable workflow manually via |
pranaygp added a commit
that referenced
this pull request
Jun 26, 2026
…edrive * origin/main: (90 commits) [ai] Fix "missing text part" stream crash by repairing UI message framing (#2537) [ci] Fix release "Premature close" by bounding changelog GraphQL batch size (#2669) [ai] Drop orphan UI chunks after negative-index reconnect (#2082) Fix trace detail panel Input/Output flicker (selection-driven state machine) (#2637) [world-local] Scope untagged startup recovery to untagged runs (#2667) fix(world-postgres): defer loopback worker startup (#2657) docs: deprecate DurableAgent and WorkflowChatTransport, point to AI SDK WorkflowAgent (#2616) [web] Fix HTTP/2 in bundled server build so observability reads work (#2632) [core] Fix turbo-mode step-body writes racing run_started (#2629) fix(world-postgres): rename setup command (#2644) chore: ignore workflow swc caches (#2640) fix(ai): ignore intentional stream aborts (#2635) fix(nitro): reload steps during Vite HMR (#2572) [world] Make @workflow/world own its Zod dependency (#2622) feat(web-shared): extend cn with custom tailwind-merge class groups (#2619) [world-vercel] Enable HTTP/2 for the events API and stream writes (#2573) Remove shadow from off-screen marker indicator button (#2614) Fix discovery of dotted JS workflow imports (#2594) Version Packages (beta) (#2597) Thread occurredAt into web-shared entities (#2608) ... # Conflicts: # packages/core/src/runtime/step-executor.ts # packages/world-vercel/src/http-client.ts
pranaygp added a commit
that referenced
this pull request
Jul 28, 2026
Post-merge fixes for main's #2222, which replaced the local geistdocs chrome with the published @vercel/geistdocs package and deleted the components the patterns pages imported. - Point Button/Input/Separator/Mermaid/CodeBlock imports at the package. - Rebuild RegistryDetailToc against the package: use its AskAIButton, inline ScrollTop and CopyPage (their deps survive the migration), and drop Feedback + Open-in-Chat, whose entire infrastructure (app actions, ai-elements, ui/popover, ui/textarea) was deleted and is only reachable through the package's non-exported internals. - Restore the sitemap link in the llms.mdx route via the package's transform hook, keeping agent-discoverable sitemap behavior intact. - Port #2616's DurableAgent -> WorkflowAgent deprecation notes into the pattern manifest prose. - Fix a validate-registry type error: use the narrowed caption local instead of the optional snippet.caption.
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 freeto 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.
What & why
DurableAgent(@workflow/ai/agent) andWorkflowChatTransport(@workflow/ai) are superseded by AI SDK v7'sWorkflowAgentand its built-inWorkflowChatTransport(@ai-sdk/workflow) — 1:1 ports. This steers all new readers to the AI SDK APIs and the migration guide, while keeping the API-reference pages live so existing imports aren't 404'd.PR #2285 did this for v5's 5 headline pages only. This completes the sweep across both v4 and v5, adds
WorkflowChatTransport, and adds the migration-guide link.Approach
durable-agentandworkflow-chat-transport(v4 + v5), plus the@workflow/ailanding cards.ai/index,foundations/streaming, the cookbook recipe (now a WorkflowAgent stub) + cookbook index — brought to parity with v5.ai/defining-tools,ai/message-queueing;cookbook/integrations/ai-sdkreframed (streamTextvs WorkflowAgent).@ai-sdk/workflow:ai/resumable-streams,ai/chat-session-modeling,cookbook/integrations/ai-sdk.UIMessageChunkdata parts to the agent's run stream —chat-session-modeling(multi-turn markers),human-in-the-loop(approval parts),agent-cancellation(data-stopped),serializable-steps(@workflow/aiprovider wrapping). That pattern does not map to WorkflowAgent'sModelCallStreamPart+ route-transform model, and the AI SDK docs don't document an equivalent, so rather than publish an incorrect hybrid these keep their working DurableAgent examples behind a clear deprecation banner with links pointing to WorkflowAgent. Flagging for reviewer judgment — happy to attempt deeper rewrites if there's a supported WorkflowAgent pattern for custom data parts.agent-patternsrecipe renamed to WorkflowAgent (base recipe incookbook-tree.ts; the now-redundant v5 override is removed).Out of scope
skills/workflow/SKILL.mdstill teaches DurableAgent — it's agent guidance (not user docs), not maintained onstable, and needs a skill version bump. Left for a follow-up; can include if wanted.Notes
pnpm lint:links) couldn't run here —bunsegfaults in this environment — so CI is the authoritative lint. Verified manually: Callout tags balanced, internal link targets exist, grep sweeps confirm the intended end state.Docs Preview
Preview deployment (
workflow-docs, behind Vercel team auth):🤖 Generated with Claude Code