@assistant-ui/mcp-docs-server 0.1.23 → 0.1.25

package/.docs/raw/docs/(docs)/installation.mdx

@@ -107,10 +107,10 @@ Install provider SDK:
     <InstallCommand npm={["ai", "@assistant-ui/react-ai-sdk", "@ai-sdk/google-vertex"]} />
   </Tab>
   <Tab>
-    <InstallCommand npm={["ai", "@assistant-ui/react-ai-sdk", "@ai-sdk/openai"]} />
+    <InstallCommand npm={["ai", "@assistant-ui/react-ai-sdk", "@ai-sdk/groq"]} />
   </Tab>
   <Tab>
-    <InstallCommand npm={["ai", "@assistant-ui/react-ai-sdk", "@ai-sdk/openai"]} />
+    <InstallCommand npm={["ai", "@assistant-ui/react-ai-sdk", "@ai-sdk/fireworks"]} />
   </Tab>
   <Tab>
     <InstallCommand npm={["ai", "@assistant-ui/react-ai-sdk", "@ai-sdk/cohere"]} />
@@ -128,15 +128,18 @@ Add an API endpoint:
 <Tabs groupId="provider" items={["OpenAI", "Anthropic", "Azure", "AWS", "Gemini", "GCP", "Groq", "Fireworks", "Cohere", "Ollama", "Chrome AI"]}>
 ```ts title="/app/api/chat/route.ts" tab="OpenAI"
 import { openai } from "@ai-sdk/openai";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import { convertToModelMessages, streamText } from "ai";
 
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
-  const { messages } = await req.json();
+  const { messages, system, tools } = await req.json();
   const result = streamText({
     model: openai("gpt-4o-mini"),
-    messages: convertToModelMessages(messages),
+    system,
+    messages: await convertToModelMessages(messages),
+    tools: frontendTools(tools),
   });
   return result.toUIMessageStreamResponse();
 }
@@ -144,15 +147,18 @@ export async function POST(req: Request) {
 
 ```ts title="/app/api/chat/route.ts" tab="Anthropic"
 import { anthropic } from "@ai-sdk/anthropic";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import { convertToModelMessages, streamText } from "ai";
 
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
-  const { messages } = await req.json();
+  const { messages, system, tools } = await req.json();
   const result = streamText({
-    model: anthropic("claude-3-5-sonnet-20240620"),
-    messages: convertToModelMessages(messages),
+    model: anthropic("claude-sonnet-4-6"),
+    system,
+    messages: await convertToModelMessages(messages),
+    tools: frontendTools(tools),
   });
   return result.toUIMessageStreamResponse();
 }
@@ -160,15 +166,18 @@ export async function POST(req: Request) {
 
 ```ts title="/app/api/chat/route.ts" tab="Azure"
 import { azure } from "@ai-sdk/azure";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import { convertToModelMessages, streamText } from "ai";
 
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
-  const { messages } = await req.json();
+  const { messages, system, tools } = await req.json();
   const result = streamText({
     model: azure("your-deployment-name"),
-    messages: convertToModelMessages(messages),
+    system,
+    messages: await convertToModelMessages(messages),
+    tools: frontendTools(tools),
   });
   return result.toUIMessageStreamResponse();
 }
@@ -176,15 +185,18 @@ export async function POST(req: Request) {
 
 ```ts title="/app/api/chat/route.ts" tab="AWS"
 import { bedrock } from "@ai-sdk/amazon-bedrock";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import { convertToModelMessages, streamText } from "ai";
 
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
-  const { messages } = await req.json();
+  const { messages, system, tools } = await req.json();
   const result = streamText({
-    model: bedrock("anthropic.claude-3-5-sonnet-20240620-v1:0"),
-    messages: convertToModelMessages(messages),
+    model: bedrock("anthropic.claude-sonnet-4-6-v1:0"),
+    system,
+    messages: await convertToModelMessages(messages),
+    tools: frontendTools(tools),
   });
   return result.toUIMessageStreamResponse();
 }
@@ -192,15 +204,18 @@ export async function POST(req: Request) {
 
 ```ts title="/app/api/chat/route.ts" tab="Gemini"
 import { google } from "@ai-sdk/google";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import { convertToModelMessages, streamText } from "ai";
 
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
-  const { messages } = await req.json();
+  const { messages, system, tools } = await req.json();
   const result = streamText({
     model: google("gemini-2.0-flash"),
-    messages: convertToModelMessages(messages),
+    system,
+    messages: await convertToModelMessages(messages),
+    tools: frontendTools(tools),
   });
   return result.toUIMessageStreamResponse();
 }
@@ -208,57 +223,56 @@ export async function POST(req: Request) {
 
 ```ts title="/app/api/chat/route.ts" tab="GCP"
 import { vertex } from "@ai-sdk/google-vertex";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import { convertToModelMessages, streamText } from "ai";
 
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
-  const { messages } = await req.json();
+  const { messages, system, tools } = await req.json();
   const result = streamText({
-    model: vertex("gemini-1.5-pro"),
-    messages: convertToModelMessages(messages),
+    model: vertex("gemini-2.0-flash"),
+    system,
+    messages: await convertToModelMessages(messages),
+    tools: frontendTools(tools),
   });
   return result.toUIMessageStreamResponse();
 }
 ```
 
 ```ts title="/app/api/chat/route.ts" tab="Groq"
-import { createOpenAI } from "@ai-sdk/openai";
+import { groq } from "@ai-sdk/groq";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import { convertToModelMessages, streamText } from "ai";
 
 export const maxDuration = 30;
 
-const groq = createOpenAI({
-  apiKey: process.env.GROQ_API_KEY ?? "",
-  baseURL: "https://api.groq.com/openai/v1",
-});
-
 export async function POST(req: Request) {
-  const { messages } = await req.json();
+  const { messages, system, tools } = await req.json();
   const result = streamText({
-    model: groq("llama3-70b-8192"),
-    messages: convertToModelMessages(messages),
+    model: groq("llama-3.3-70b-versatile"),
+    system,
+    messages: await convertToModelMessages(messages),
+    tools: frontendTools(tools),
   });
   return result.toUIMessageStreamResponse();
 }
 ```
 
 ```ts title="/app/api/chat/route.ts" tab="Fireworks"
-import { createOpenAI } from "@ai-sdk/openai";
+import { fireworks } from "@ai-sdk/fireworks";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import { convertToModelMessages, streamText } from "ai";
 
 export const maxDuration = 30;
 
-const fireworks = createOpenAI({
-  apiKey: process.env.FIREWORKS_API_KEY ?? "",
-  baseURL: "https://api.fireworks.ai/inference/v1",
-});
-
 export async function POST(req: Request) {
-  const { messages } = await req.json();
+  const { messages, system, tools } = await req.json();
   const result = streamText({
-    model: fireworks("accounts/fireworks/models/firefunction-v2"),
-    messages: convertToModelMessages(messages),
+    model: fireworks("accounts/fireworks/models/llama-v3p3-70b-instruct"),
+    system,
+    messages: await convertToModelMessages(messages),
+    tools: frontendTools(tools),
   });
   return result.toUIMessageStreamResponse();
 }
@@ -266,15 +280,18 @@ export async function POST(req: Request) {
 
 ```ts title="/app/api/chat/route.ts" tab="Cohere"
 import { cohere } from "@ai-sdk/cohere";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import { convertToModelMessages, streamText } from "ai";
 
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
-  const { messages } = await req.json();
+  const { messages, system, tools } = await req.json();
   const result = streamText({
     model: cohere("command-r-plus"),
-    messages: convertToModelMessages(messages),
+    system,
+    messages: await convertToModelMessages(messages),
+    tools: frontendTools(tools),
   });
   return result.toUIMessageStreamResponse();
 }
@@ -282,15 +299,18 @@ export async function POST(req: Request) {
 
 ```ts title="/app/api/chat/route.ts" tab="Ollama"
 import { ollama } from "ollama-ai-provider-v2";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import { convertToModelMessages, streamText } from "ai";
 
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
-  const { messages } = await req.json();
+  const { messages, system, tools } = await req.json();
   const result = streamText({
     model: ollama("llama3"),
-    messages: convertToModelMessages(messages),
+    system,
+    messages: await convertToModelMessages(messages),
+    tools: frontendTools(tools),
   });
   return result.toUIMessageStreamResponse();
 }
@@ -298,15 +318,18 @@ export async function POST(req: Request) {
 
 ```ts title="/app/api/chat/route.ts" tab="Chrome AI"
 import { chromeai } from "chrome-ai";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import { convertToModelMessages, streamText } from "ai";
 
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
-  const { messages } = await req.json();
+  const { messages, system, tools } = await req.json();
   const result = streamText({
     model: chromeai(),
-    messages: convertToModelMessages(messages),
+    system,
+    messages: await convertToModelMessages(messages),
+    tools: frontendTools(tools),
   });
   return result.toUIMessageStreamResponse();
 }
@@ -385,7 +408,7 @@ import { useChatRuntime, AssistantChatTransport } from "@assistant-ui/react-ai-s
 import { ThreadList } from "@/components/assistant-ui/thread-list";
 import { Thread } from "@/components/assistant-ui/thread";
 
-const MyApp = () => {
+export default function MyApp() {
   const runtime = useChatRuntime({
     transport: new AssistantChatTransport({
       api: "/api/chat",
@@ -400,7 +423,7 @@ const MyApp = () => {
       </div>
     </AssistantRuntimeProvider>
   );
-};
+}
 ```
 
 ```tsx title="/app/page.tsx" tab="AssistantModal"
@@ -410,7 +433,7 @@ import { AssistantRuntimeProvider } from "@assistant-ui/react";
 import { useChatRuntime, AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
 import { AssistantModal } from "@/components/assistant-ui/assistant-modal";
 
-const MyApp = () => {
+export default function MyApp() {
   const runtime = useChatRuntime({
     transport: new AssistantChatTransport({
       api: "/api/chat",
@@ -422,7 +445,7 @@ const MyApp = () => {
       <AssistantModal />
     </AssistantRuntimeProvider>
   );
-};
+}
 ```
 
 </Tabs>
@@ -446,7 +469,7 @@ const MyApp = () => {
   <Card
     title="Add Persistence"
     description="Save and restore chat conversations"
-    href="/docs/cloud/overview"
+    href="/docs/cloud"
   />
   <Card
     title="Examples"

package/.docs/raw/docs/(reference)/api-reference/context-providers/text-message-part-provider.mdx

@@ -3,24 +3,38 @@ title: <TextMessagePartProvider />
 description: Context provider for reusing text components outside of message content.
 ---
 
-import { AssistantRuntimeProvider } from "@/generated/typeDocs";
-
 The `TextMessagePartProvider` provides data and APIs for `TextMessagePart` components.
 
 This is useful if you want to reuse the same `Text` component outside of a message text, e.g. with the `@assistant-ui/react-markdown` package.
 
-```tsx {1, 8, 10}
-import { AssistantRuntimeProvider } from "@assistant-ui/react";
+```tsx
+import { TextMessagePartProvider } from "@assistant-ui/react";
 
 const MyApp = () => {
   return (
     <TextMessagePartProvider text={"Hello!"}>
       <MyMarkdownText />
-    </AssistantRuntimeProvider>
+    </TextMessagePartProvider>
   );
 };
 ```
 
 #### Properties
 
-<ParametersTable {...AssistantRuntimeProvider} />
+<ParametersTable
+  type="TextMessagePartProviderProps"
+  parameters={[
+    {
+      name: "text",
+      type: "string",
+      required: true,
+      description: "The text content to provide to child components.",
+    },
+    {
+      name: "isRunning",
+      type: "boolean",
+      required: false,
+      description: "Whether the text is still being streamed. Defaults to false.",
+    },
+  ]}
+/>

package/.docs/raw/docs/(reference)/api-reference/integrations/react-data-stream.mdx

@@ -35,6 +35,16 @@ const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
       type: "string",
       description: "The API endpoint URL for the data stream protocol.",
     },
+    {
+      name: "protocol",
+      type: '"ui-message-stream" | "data-stream"',
+      description: 'The streaming protocol to use. Defaults to "ui-message-stream". Use "data-stream" for legacy AI SDK compatibility.',
+    },
+    {
+      name: "onData",
+      type: "(data: { type: string; name: string; data: unknown; transient?: boolean }) => void",
+      description: "Optional callback for data-* parts. Only applies when using the ui-message-stream protocol.",
+    },
     {
       name: "onResponse",
       type: "(response: Response) => void | Promise<void>",
@@ -67,8 +77,8 @@ const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
     },
     {
       name: "body",
-      type: "object",
-      description: "Optional additional body parameters to include in the request.",
+      type: "object | (() => Promise<object | undefined>)",
+      description: "Optional additional body parameters to include in the request. Can be an object or an async function that returns one.",
     },
     {
       name: "sendExtraMessageFields",
@@ -111,6 +121,16 @@ const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
       type: "string",
       description: "The ID of the assistant to connect to.",
     },
+    {
+      name: "protocol",
+      type: '"ui-message-stream" | "data-stream"',
+      description: 'The streaming protocol to use. Defaults to "ui-message-stream". Use "data-stream" for legacy AI SDK compatibility.',
+    },
+    {
+      name: "onData",
+      type: "(data: { type: string; name: string; data: unknown; transient?: boolean }) => void",
+      description: "Optional callback for data-* parts. Only applies when using the ui-message-stream protocol.",
+    },
     {
       name: "onResponse",
       type: "(response: Response) => void | Promise<void>",
@@ -143,8 +163,8 @@ const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
     },
     {
       name: "body",
-      type: "object",
-      description: "Optional additional body parameters to include in the request.",
+      type: "object | (() => Promise<object | undefined>)",
+      description: "Optional additional body parameters to include in the request. Can be an object or an async function that returns one.",
     },
     {
       name: "sendExtraMessageFields",

package/.docs/raw/docs/(reference)/api-reference/integrations/react-hook-form.mdx

@@ -89,7 +89,7 @@ Drop-in replacement hook for `useForm` that adds support for `@assistant-ui/reac
 
 ### `formTools`
 
-The set of tools to use with `useAssistantForm`, useful for runtimes that do not support client-side tool definitions (i.e. Vercel AI SDK).
+The set of tools to use with `useAssistantForm` on the server side. While the AI SDK now supports forwarding frontend tools via `frontendTools()`, using `formTools` directly on the server gives you more control over tool execution.
 
 ```tsx {1, 5-7}
 import { formTools } from "@assistant-ui/react-hook-form";

package/.docs/raw/docs/(reference)/api-reference/integrations/vercel-ai-sdk.mdx

@@ -1,21 +1,21 @@
 ---
 title: "@assistant-ui/react-ai-sdk"
-description: Vercel AI SDK v5 integration with chat runtime hooks and transport utilities.
+description: Vercel AI SDK integration with chat runtime hooks and transport utilities.
 ---
 
 Vercel AI SDK integration for assistant-ui.
 
 
 <Callout type="info">
-  This package provides integration with AI SDK v5. For AI SDK v4, see the [AI
-  SDK v4 (Legacy)](/docs/runtimes/ai-sdk/v4-legacy) documentation.
+  This package provides integration with AI SDK v6. For older versions, see the [AI
+  SDK v5 (Legacy)](/docs/runtimes/ai-sdk/v5-legacy) or [AI SDK v4 (Legacy)](/docs/runtimes/ai-sdk/v4-legacy) documentation.
 </Callout>
 
 ## API Reference
 
 ### `useChatRuntime`
 
-Creates a runtime directly with AI SDK v5's `useChat` hook integration. This is the recommended approach for most use cases.
+Creates a runtime with AI SDK's `useChat` hook integration. This is the recommended approach for most use cases.
 
 ```tsx
 import { useChatRuntime, AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
@@ -56,16 +56,11 @@ const runtime = useChatRuntime({
         {
           type: "UseChatRuntimeOptions",
           parameters: [
-            {
-              name: "api",
-              type: "string",
-              description: "The API endpoint URL. Defaults to '/api/chat'.",
-            },
             {
               name: "transport",
               type: "ChatTransport",
               description:
-                "Custom transport implementation. Defaults to AssistantChatTransport which forwards system messages and tools.",
+                "Custom transport implementation. Defaults to AssistantChatTransport (which sends requests to '/api/chat' and forwards system messages and tools). Use `new AssistantChatTransport({ api: '/custom-endpoint' })` to customize the endpoint.",
             },
             {
               name: "cloud",
@@ -73,6 +68,18 @@ const runtime = useChatRuntime({
               description:
                 "Optional AssistantCloud instance for chat persistence.",
             },
+            {
+              name: "adapters",
+              type: "RuntimeAdapters",
+              description:
+                "Optional runtime adapters to extend or override built-in functionality (attachments, speech, dictation, feedback, history).",
+            },
+            {
+              name: "toCreateMessage",
+              type: "(message: AppendMessage) => CreateUIMessage",
+              description:
+                "Optional custom function to convert an AppendMessage into an AI SDK CreateUIMessage before sending.",
+            },
             {
               name: "initialMessages",
               type: "UIMessage[]",
@@ -134,18 +141,12 @@ const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
     },
     {
       name: "options",
-      type: "AISDKRuntimeOptions",
+      type: "AISDKRuntimeAdapter",
       description: "Optional configuration options.",
       children: [
         {
-          type: "AISDKRuntimeOptions",
+          type: "AISDKRuntimeAdapter",
           parameters: [
-            {
-              name: "cloud",
-              type: "AssistantCloud",
-              description:
-                "Optional AssistantCloud instance for chat persistence.",
-            },
             {
               name: "adapters",
               type: "RuntimeAdapters",
@@ -221,7 +222,7 @@ export async function POST(req: Request) {
   const result = streamText({
     model: openai("gpt-4o"),
     system,
-    messages: convertToModelMessages(messages),
+    messages: await convertToModelMessages(messages),
     tools: {
       // Wrap frontend tools with the helper
       ...frontendTools(tools),