Skip to content

The Open Standard for Generative UI

fix: support AI SDK 7 in react-headless (#982)

Visharad Kashyapedd2b02d1219
diff --git a/packages/assistant-ui/README.md b/packages/assistant-ui/README.md
index 2a9caefbd..d82d44d87 100644
--- a/packages/assistant-ui/README.md
+++ b/packages/assistant-ui/README.md
@@ -104,6 +104,9 @@ can implement that policy using the runtime's continuation API.
For a Vercel AI SDK runtime, the package provides that policy as an optional
convenience helper. Install `ai` and import it from the `/ai-sdk` subpath:
+The helper supports AI SDK 6 and 7. AI SDK 7 requires Node.js 22 or later and
+an ESM application.
+
```tsx
import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
import { shouldContinueAfterOpenUIPrompt } from "@openuidev/assistant-ui/ai-sdk";
diff --git a/packages/react-headless/README.md b/packages/react-headless/README.md
index c79650864..4397958f5 100644
--- a/packages/react-headless/README.md
+++ b/packages/react-headless/README.md
@@ -22,8 +22,13 @@ The Vercel AI SDK integration has one optional peer dependency:
```bash
npm install ai@^6
+# or, on Node.js 22+ with ESM
+npm install ai@^7
```
+Both AI SDK 6 and 7 are supported. AI SDK 7 requires Node.js 22 or later and
+is ESM-only.
+
## Overview
Use `@openuidev/react-headless` when you want OpenUI's chat behavior without OpenUI's visual components:
@@ -185,7 +190,7 @@ const llm = fetchLLM({ url: "/api/chat", streamAdapter: openAIAdapter() });
| `openAIAdapter()` | Parses OpenAI Chat Completions streaming (`ChatCompletionChunk`) |
| `openAIResponsesAdapter()` | Parses OpenAI Responses API streaming (`ResponseStreamEvent`) |
| `openAIReadableStreamAdapter()` | Parses OpenAI SDK's `Stream.toReadableStream()` NDJSON output |
-| `vercelAIAdapter()` | Parses Vercel AI SDK v6 UIMessage streams from `toUIMessageStreamResponse()` |
+| `vercelAIAdapter()` | Parses Vercel AI SDK v6 and v7 UIMessage streams |
For a Vercel AI SDK route, use its stream adapter and message format together:
@@ -236,7 +241,7 @@ const llm = fetchLLM({
| `identityMessageFormat` | Default format when messages are already AG-UI shaped |
| `openAIMessageFormat` | Converts to/from OpenAI `ChatCompletionMessageParam[]` |
| `openAIConversationMessageFormat` | Converts to/from OpenAI Responses API `ResponseInputItem[]` |
-| `vercelAIMessageFormat` | Converts to/from Vercel AI SDK v6 `UIMessage[]` |
+| `vercelAIMessageFormat` | Converts to/from Vercel AI SDK v6 and v7 `UIMessage[]` |
### Custom format
diff --git a/packages/react-headless/package.json b/packages/react-headless/package.json
index 3fdc18013..f91f43059 100644
--- a/packages/react-headless/package.json
+++ b/packages/react-headless/package.json
@@ -1,6 +1,6 @@
{
"name": "@openuidev/react-headless",
- "version": "0.9.7",
+ "version": "0.9.8",
"description": "Headless React primitives for AI chat — state management, streaming adapters for OpenAI, Vercel AI SDK, and AG-UI, message format converters, and thread management for OpenUI generative UI apps",
"license": "MIT",
"type": "module",
@@ -39,7 +39,7 @@
"ci": "pnpm run lint:check && pnpm run format:check"
},
"peerDependencies": {
- "ai": "^6.0.0",
+ "ai": "^6.0.0 || ^7.0.0",
"react": "catalog:",
"zustand": "catalog:"
},
diff --git a/packages/react-headless/src/stream/adapters/__tests__/vercel-ai-sdk.test.ts b/packages/react-headless/src/stream/adapters/__tests__/vercel-ai-sdk.test.ts
index e517ca882..6014eddb4 100644
--- a/packages/react-headless/src/stream/adapters/__tests__/vercel-ai-sdk.test.ts
+++ b/packages/react-headless/src/stream/adapters/__tests__/vercel-ai-sdk.test.ts
@@ -492,7 +492,7 @@ describe("vercelAIAdapter", () => {
try {
await expect(collect(vercelAIAdapter().parse(makeResponse("")))).rejects.toThrow(
- 'vercelAIAdapter requires the optional peer dependency "ai" (Vercel AI SDK v6).',
+ 'vercelAIAdapter requires the optional peer dependency "ai" (Vercel AI SDK v6 or v7).',
);
} finally {
vi.doUnmock("ai");
diff --git a/packages/react-headless/src/stream/adapters/vercel-ai-sdk.ts b/packages/react-headless/src/stream/adapters/vercel-ai-sdk.ts
index fea294e4c..b52d749a1 100644
--- a/packages/react-headless/src/stream/adapters/vercel-ai-sdk.ts
+++ b/packages/react-headless/src/stream/adapters/vercel-ai-sdk.ts
@@ -2,7 +2,7 @@ import type { UIMessage, UIMessageChunk } from "ai";
import { AGUIEvent, EventType, StreamProtocolAdapter } from "../../types";
const MISSING_AI_SDK_MESSAGE =
- 'vercelAIAdapter requires the optional peer dependency "ai" (Vercel AI SDK v6).';
+ 'vercelAIAdapter requires the optional peer dependency "ai" (Vercel AI SDK v6 or v7).';
const PROVIDER_EXECUTED_TOOLS_UNSUPPORTED_MESSAGE =
"Vercel AI SDK provider-executed tools are not supported because AG-UI messages cannot preserve providerExecuted semantics.";
const TOOL_EXECUTION_DENIED_MESSAGE = "Tool execution was denied";
@@ -64,8 +64,7 @@ function toolResult(toolCallId: string, content: string, error?: string): AGUIEv
}
/**
- * Adapter for Vercel AI SDK v6 UIMessage streams, such as responses returned by
- * `toUIMessageStreamResponse()`.
+ * Adapter for Vercel AI SDK v6 and v7 UIMessage streams.
*
* The AI SDK is loaded only when parsing begins so it can remain an optional
* peer dependency for consumers that use other stream adapters. Its
diff --git a/packages/react-headless/src/stream/formats/vercel-ai-message-format.ts b/packages/react-headless/src/stream/formats/vercel-ai-message-format.ts
index 5a9d1315b..dd82b7c76 100644
--- a/packages/react-headless/src/stream/formats/vercel-ai-message-format.ts
+++ b/packages/react-headless/src/stream/formats/vercel-ai-message-format.ts
@@ -438,7 +438,7 @@ function fromVercelMessages(data: unknown): Message[] {
}
/**
- * Converts messages between AG-UI and Vercel AI SDK v6 `UIMessage` format.
+ * Converts messages between AG-UI and Vercel AI SDK v6 and v7 `UIMessage` format.
*
* AG-UI tool-result messages are folded into the matching assistant tool part,
* because `UIMessage` represents a tool invocation and its result as one part.