docs: add AI SDK 7 Beta announcement and rebrand Workflow references by nicoalbanese · Pull Request #14520 · vercel/ai

nicoalbanese · 2026-04-16T12:43:48Z

Summary

Add AI SDK 7 Beta announcement page with comprehensive documentation on new features, update Workflow-related docs to reference the Workflow SDK instead of Vercel Workflows, and replace hardcoded model names with placeholders in code examples.

Changes

New: AI SDK 7 Beta announcement (content/docs/00-introduction/01-announcing-ai-sdk-7-beta.mdx)

Full announcement page covering WorkflowAgent, overhauled telemetry, top-level reasoning, file/skill uploads, typed tool context, and granular timeout controls
Includes installation instructions, beta guidance, code examples, and migration pointers

Introduction page (content/docs/00-introduction/index.mdx)

Add note linking to the AI SDK 7 Beta announcement

Migration guides (content/docs/08-migration-guides/index.mdx)

Add AI SDK 6.x to 7.0 migration guide entry

Rebrand: Vercel Workflows -> Workflow SDK (across 7 files)

content/docs/03-agents/07-workflow-agent.mdx — Update description, comparison table, and runtime references
content/docs/03-agents/index.mdx — Update WorkflowAgent card description
content/docs/04-ai-sdk-ui/21-transport.mdx — Update Workflow Transport section
content/docs/07-reference/04-ai-sdk-workflow/01-workflow-agent.mdx — Update class description and reference text
content/docs/07-reference/04-ai-sdk-workflow/02-workflow-chat-transport.mdx — Update transport description
content/docs/07-reference/04-ai-sdk-workflow/index.mdx — Update package overview

Code example cleanup

Replace hardcoded model/provider names with __MODEL__ and __PROVIDER_IMPORT__ placeholders in announcement page examples

Chat - Built with guidance from Nico Albanese

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

felixarntz · 2026-04-16T14:03:47Z

+
+### Stable Typed Tool Context
+
+AI SDK 7 promotes `experimental_context` to stable `context` and lets tools declare a `contextSchema` for end-to-end type inference.


This was just enhanced in #14515, may be good to mention that context is separated by tool and must be passed via toolsContext.

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

aayush-kapoor · 2026-04-16T14:37:13Z

+
+### Overhauled Telemetry
+
+AI SDK 7 overhauls telemetry to make observability much easier to adopt. OpenTelemetry support now lives in the new `@ai-sdk/otel` package, and setup is simple: register an integration once, then enable telemetry on the calls you want to trace.


then enable telemetry on the calls you want to trace.

this will change after PR #14500.

Telemetry will be enabled by default for all calls and will opt-out!

aayush-kapoor · 2026-04-16T14:37:16Z

+const result = streamText({
+  model: __MODEL__,
+  prompt: "Summarize today's release notes.",
+  experimental_telemetry: { isEnabled: true },


this line won't be needed!

lgrammel · 2026-04-16T15:28:20Z

+import { GenAIOpenTelemetryIntegration } from '@ai-sdk/otel';
+__PROVIDER_IMPORT__;
+
+registerTelemetryIntegration(new GenAIOpenTelemetryIntegration());


would be good to mention that this only needs to happen on app startup

gr2m

Should we mention the tracking issue? Folks can subscribe to it for updates. I'll post weekly updates to it: #14011

gr2m · 2026-04-16T15:25:38Z

+__PROVIDER_IMPORT__;
+import { z } from 'zod';
+
+export const supportAgent = new WorkflowAgent({
+  model: __MODEL__,


I think I would use an example provider here. Being able to use the providers just like ToolLoopAgent is one of the main improvements over DurableAgent

Suggested change

__PROVIDER_IMPORT__;

import { z } from 'zod';

export const supportAgent = new WorkflowAgent({

model: __MODEL__,

import { openai } from '@ai-sdk/openai';

import { z } from 'zod';

export const supportAgent = new WorkflowAgent({

model: openai('gpt-5.4-pro'),

gr2m · 2026-04-16T15:27:39Z

+      execute: async ({ orderId }) => ({
+        orderId,
+        status: 'shipped',
+      }),


this would usually be a step function.

Suggested change

execute: async ({ orderId }) => ({

orderId,

status: 'shipped',

}),

execute: async ({ orderId }) => {

'use step';

/* look up order in database */

return {

orderId,

status: 'shipped',

}

},

lgrammel · 2026-04-16T15:29:18Z

+### Stable Typed Tool Context
+
+AI SDK 7 promotes `experimental_context` to stable `context` and lets each tool declare its own `contextSchema` for end-to-end type inference. Context is separated by tool — each tool only receives the context it declares, and the call-site `context` is type-checked against the combined requirements of all tools.
+
+```ts
+import { tool } from 'ai';
+import { z } from 'zod';
+
+const weather = tool({
+  inputSchema: z.object({
+    location: z.string(),
+  }),
+  contextSchema: z.object({
+    weatherApiKey: z.string(),
+  }),
+  execute: async ({ location }, { context: { weatherApiKey } }) => {
+    return getWeather(location, weatherApiKey);
+  },
+});
+```
+
+This typed context also flows into approval callbacks and other tool lifecycle hooks. See the [migration guide](/docs/migration-guides/migration-guide-7-0) for upgrade details.


this is still undergoing significant changes (example is already outdated)

lgrammel · 2026-04-16T15:30:12Z

+### `reasoning-file` Content Part
+
+Models that return files as part of their reasoning trace (separate from regular output files) now use a distinct `reasoning-file` content part type. Previously these were grouped under the generic `file` type. If you have exhaustive part handling (`switch` statements, renderers, serializers), you will need to add a case for `type: 'reasoning-file'`.
+


there is also the new top level toolNeedsApproval setting for agent, generateText, streamText

feat(ai): add toolNeedsApproval option #14480

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

nicoalbanese and others added 3 commits April 16, 2026 11:00

docs: add AI SDK 7 Beta announcement

95433f7

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

docs: add ToolLoopAgent reasoning example

967376e

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

docs: clarify ToolLoopAgent settings documentation

04f01e5

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

github-actions Bot assigned nicoalbanese Apr 16, 2026

tigent Bot added documentation Improvements or additions to documentation maintenance CI, internal documentation, automations, etc labels Apr 16, 2026

docs: add telemetry revamp section to AI SDK 7 announcement

0ba253b

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 16, 2026 12:50 View deployment

docs: add observability integrations to telemetry section

75fce1f

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 16, 2026 12:55 View deployment

docs: clarify observability integration methods

87efe55

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 16, 2026 13:01 View deployment

docs: clarify WorkflowAgent and telemetry benefits

e99075e

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 16, 2026 13:07 View deployment

refactor: simplify feature explanations on AI SDK 7 announcement

5235c5d

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 16, 2026 13:11 View deployment

docs: add workflow SDK link to WorkflowAgent description

9c30c37

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 16, 2026 13:13 View deployment

docs: replace Vercel Workflows with Workflow SDK

2892fdf

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 16, 2026 13:16 View deployment

docs: simplify WorkflowAgent intro text

86250d7

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 16, 2026 13:24 View deployment

docs: simplify WorkflowAgent description

696c1cb

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 16, 2026 13:26 View deployment

refactor: replace hardcoded models with placeholders in examples

c3a9f7f

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 16, 2026 13:33 View deployment

nicoalbanese changed the title ~~docs: add AI SDK 7 Beta announcement and documentation updates~~ docs: add AI SDK 7 Beta announcement and rebrand Workflow references Apr 16, 2026

docs: clarify WorkflowAgent terminology in SDK 7 announcement

2d06d12

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 16, 2026 13:52 View deployment

felixarntz reviewed Apr 16, 2026

View reviewed changes

nicoalbanese and others added 2 commits April 16, 2026 14:27

docs: clarify tool context and document reasoning-file

92ad2cf

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

Merge remote-tracking branch 'origin/main' into na/6ccf9d81

4f823ac

vercel Bot deployed to Preview April 16, 2026 14:29 View deployment

aayush-kapoor reviewed Apr 16, 2026

View reviewed changes

felixarntz approved these changes Apr 16, 2026

View reviewed changes

lgrammel reviewed Apr 16, 2026

View reviewed changes

gr2m reviewed Apr 16, 2026

View reviewed changes

lgrammel reviewed Apr 16, 2026

View reviewed changes

nicoalbanese and others added 2 commits April 21, 2026 14:52

Merge remote-tracking branch 'origin/main' into na/6ccf9d81

3f2c8ab

docs: update AI SDK 7 announcement with refined examples

094d493

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 21, 2026 14:57 View deployment

docs: clarify WorkflowAgent provider model usage

4a9718b

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 21, 2026 15:01 View deployment

docs: simplify WorkflowAgent explanation

55da46f

Co-Authored-By: open-agents-bot[bot] <260704009+open-agents-bot[bot]@users.noreply.github.com>

vercel Bot deployed to Preview April 21, 2026 15:03 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: add AI SDK 7 Beta announcement and rebrand Workflow references#14520

docs: add AI SDK 7 Beta announcement and rebrand Workflow references#14520
nicoalbanese wants to merge 20 commits intomainfrom
na/6ccf9d81

nicoalbanese commented Apr 16, 2026 •

edited

Loading

Uh oh!

felixarntz Apr 16, 2026

Uh oh!

Uh oh!

aayush-kapoor Apr 16, 2026

Uh oh!

aayush-kapoor Apr 16, 2026

Uh oh!

lgrammel Apr 16, 2026

Uh oh!

gr2m left a comment

Uh oh!

gr2m Apr 16, 2026

Uh oh!

gr2m Apr 16, 2026

Uh oh!

lgrammel Apr 16, 2026

Uh oh!

lgrammel Apr 16, 2026

Uh oh!

gr2m Apr 16, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants


		### Stable Typed Tool Context

		AI SDK 7 promotes `experimental_context` to stable `context` and lets tools declare a `contextSchema` for end-to-end type inference.


		### Overhauled Telemetry

		AI SDK 7 overhauls telemetry to make observability much easier to adopt. OpenTelemetry support now lives in the new `@ai-sdk/otel` package, and setup is simple: register an integration once, then enable telemetry on the calls you want to trace.

		### `reasoning-file` Content Part

		Models that return files as part of their reasoning trace (separate from regular output files) now use a distinct `reasoning-file` content part type. Previously these were grouped under the generic `file` type. If you have exhaustive part handling (`switch` statements, renderers, serializers), you will need to add a case for `type: 'reasoning-file'`.

Conversation

nicoalbanese commented Apr 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

gr2m left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

gr2m Apr 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

nicoalbanese commented Apr 16, 2026 •

edited

Loading

gr2m Apr 16, 2026 •

edited

Loading