@assistant-ui/mcp-docs-server 0.1.12 → 0.1.13

package/.docs/organized/code-examples/with-ai-sdk-v5.md

@@ -1002,13 +1002,6 @@ export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
 
 ```
 
-## eslint.config.ts
-
-```typescript
-export { default } from "@assistant-ui/x-buildutils/eslint";
-
-```
-
 ## lib/utils.ts
 
 ```typescript
@@ -1042,34 +1035,32 @@ export default nextConfig;
   "version": "0.0.0",
   "type": "module",
   "dependencies": {
-    "@ai-sdk/openai": "^2.0.53",
-    "@ai-sdk/react": "^2.0.76",
+    "@ai-sdk/openai": "^2.0.60",
+    "@ai-sdk/react": "^2.0.86",
     "@assistant-ui/react": "workspace:^",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:^",
     "@radix-ui/react-slot": "^1.2.3",
     "@radix-ui/react-tooltip": "^1.2.8",
-    "@tailwindcss/postcss": "^4.1.15",
-    "ai": "^5.0.76",
+    "@tailwindcss/postcss": "^4.1.16",
+    "ai": "^5.0.86",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.546.0",
-    "next": "16.0.0",
+    "lucide-react": "^0.552.0",
+    "next": "16.0.1",
     "postcss": "^8.5.6",
     "react": "19.2.0",
     "react-dom": "19.2.0",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.3.1",
-    "tailwindcss": "^4.1.15",
+    "tailwindcss": "^4.1.16",
     "zod": "^4.1.12"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@types/node": "^24.9.1",
+    "@types/node": "^24.10.0",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
-    "eslint": "^9",
-    "eslint-config-next": "16.0.0",
     "tw-animate-css": "^1.4.0",
     "typescript": "^5.9.3"
   },

package/.docs/organized/code-examples/with-assistant-transport.md

@@ -1215,13 +1215,6 @@ export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
 
 ```
 
-## eslint.config.ts
-
-```typescript
-export { default } from "@assistant-ui/x-buildutils/eslint";
-
-```
-
 ## lib/utils.ts
 
 ```typescript
@@ -1270,29 +1263,27 @@ export default nextConfig;
     "@assistant-ui/react-markdown": "workspace:^",
     "@radix-ui/react-slot": "^1.2.3",
     "@radix-ui/react-tooltip": "^1.2.8",
-    "@tailwindcss/postcss": "^4.1.15",
-    "assistant-stream": "^0.2.37",
+    "@tailwindcss/postcss": "^4.1.16",
+    "assistant-stream": "^0.2.39",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "framer-motion": "^12.23.24",
-    "lucide-react": "^0.546.0",
-    "next": "16.0.0",
+    "lucide-react": "^0.552.0",
+    "next": "16.0.1",
     "postcss": "^8.5.6",
     "react": "19.2.0",
     "react-dom": "19.2.0",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.3.1",
-    "tailwindcss": "^4.1.15",
+    "tailwindcss": "^4.1.16",
     "tailwindcss-animate": "^1.0.7",
     "zod": "^4.1.12"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@types/node": "^24.9.1",
+    "@types/node": "^24.10.0",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
-    "eslint": "^9",
-    "eslint-config-next": "16.0.0",
     "tw-animate-css": "^1.4.0",
     "typescript": "^5.9.3"
   },

package/.docs/organized/code-examples/with-cloud.md

@@ -1044,13 +1044,6 @@ export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
 
 ```
 
-## eslint.config.ts
-
-```typescript
-export { default } from "@assistant-ui/x-buildutils/eslint";
-
-```
-
 ## lib/utils.ts
 
 ```typescript
@@ -1090,19 +1083,19 @@ export default nextConfig;
     "lint": "eslint ."
   },
   "dependencies": {
-    "@ai-sdk/openai": "^2.0.53",
+    "@ai-sdk/openai": "^2.0.60",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@radix-ui/react-slot": "^1.2.3",
     "@radix-ui/react-tooltip": "^1.2.8",
-    "ai": "^5.0.76",
+    "ai": "^5.0.86",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "jsonwebtoken": "^9.0.2",
-    "lucide-react": "^0.546.0",
+    "lucide-react": "^0.552.0",
     "nanoid": "5.1.6",
-    "next": "16.0.0",
+    "next": "16.0.1",
     "react": "19.2.0",
     "react-dom": "19.2.0",
     "remark-gfm": "^4.0.1",
@@ -1115,10 +1108,8 @@ export default nextConfig;
     "@types/node": "^24",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "eslint": "^9",
-    "eslint-config-next": "16.0.0",
     "postcss": "^8",
-    "tailwindcss": "^4.1.15",
+    "tailwindcss": "^4.1.16",
     "typescript": "^5"
   }
 }

package/.docs/organized/code-examples/with-external-store.md

@@ -956,13 +956,6 @@ export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
 
 ```
 
-## eslint.config.ts
-
-```typescript
-export { default } from "@assistant-ui/x-buildutils/eslint";
-
-```
-
 ## lib/utils.ts
 
 ```typescript
@@ -1002,15 +995,15 @@ export default nextConfig;
     "lint": "eslint ."
   },
   "dependencies": {
-    "@ai-sdk/openai": "^2.0.53",
+    "@ai-sdk/openai": "^2.0.60",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@radix-ui/react-slot": "^1.2.3",
     "@radix-ui/react-tooltip": "^1.2.8",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.546.0",
-    "next": "16.0.0",
+    "lucide-react": "^0.552.0",
+    "next": "16.0.1",
     "react": "19.2.0",
     "react-dom": "19.2.0",
     "remark-gfm": "^4.0.1",
@@ -1022,10 +1015,8 @@ export default nextConfig;
     "@types/node": "^24",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "eslint": "^9",
-    "eslint-config-next": "16.0.0",
     "postcss": "^8",
-    "tailwindcss": "^4.1.15",
+    "tailwindcss": "^4.1.16",
     "typescript": "^5"
   }
 }

package/.docs/organized/code-examples/with-ffmpeg.md

@@ -268,7 +268,7 @@ export default dynamic(() => Promise.resolve(NoSSRWrapper), {
 import {
   useAssistantInstructions,
   useAssistantTool,
-  useThreadComposer,
+  useAssistantState,
 } from "@assistant-ui/react";
 import { z } from "zod";
 import { FFmpeg } from "@ffmpeg/ffmpeg";
@@ -417,7 +417,9 @@ const FfmpegTool: FC<{ file: File }> = ({ file }) => {
 
 export default function Home() {
   const [lastFile, setLastFile] = useState<File | null>(null);
-  const attachments = useThreadComposer((c) => c.attachments);
+  const attachments = useAssistantState(
+    ({ thread }) => thread.composer.attachments,
+  );
   useEffect(() => {
     const lastAttachment = attachments[attachments.length - 1];
     if (!lastAttachment) return;
@@ -1167,13 +1169,6 @@ export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
 
 ```
 
-## eslint.config.ts
-
-```typescript
-export { default } from "@assistant-ui/x-buildutils/eslint";
-
-```
-
 ## lib/utils.ts
 
 ```typescript
@@ -1225,7 +1220,7 @@ export default nextConfig;
     "lint": "eslint ."
   },
   "dependencies": {
-    "@ai-sdk/openai": "^2.0.53",
+    "@ai-sdk/openai": "^2.0.60",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-hook-form": "workspace:*",
@@ -1240,15 +1235,15 @@ export default nextConfig;
     "@radix-ui/react-tabs": "^1.1.13",
     "@radix-ui/react-tooltip": "^1.2.8",
     "@react-hook/media-query": "^1.1.1",
-    "ai": "^5.0.76",
+    "ai": "^5.0.86",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "json-schema-to-zod": "^2.6.1",
-    "lucide-react": "^0.546.0",
-    "next": "16.0.0",
+    "lucide-react": "^0.552.0",
+    "next": "16.0.1",
     "react": "19.2.0",
     "react-dom": "19.2.0",
-    "react-hook-form": "^7.65.0",
+    "react-hook-form": "^7.66.0",
     "react-resizable-panels": "^3.0.6",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.3.1",
@@ -1261,10 +1256,8 @@ export default nextConfig;
     "@types/node": "^24",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "eslint": "^9",
-    "eslint-config-next": "16.0.0",
     "postcss": "^8",
-    "tailwindcss": "^4.1.15",
+    "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3"
   }
 }

package/.docs/organized/code-examples/with-langgraph.md

@@ -1530,13 +1530,6 @@ export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
 
 ```
 
-## eslint.config.ts
-
-```typescript
-export { default } from "@assistant-ui/x-buildutils/eslint";
-
-```
-
 ## lib/chatApi.ts
 
 ```typescript
@@ -1682,9 +1675,9 @@ export default nextConfig;
     "clsx": "^2.1.1",
     "js-cookie": "^3.0.5",
     "jsonwebtoken": "^9.0.2",
-    "lucide-react": "^0.546.0",
+    "lucide-react": "^0.552.0",
     "nanoid": "5.1.6",
-    "next": "16.0.0",
+    "next": "16.0.1",
     "react": "19.2.0",
     "react-dom": "19.2.0",
     "remark-gfm": "^4.0.1",
@@ -1698,10 +1691,8 @@ export default nextConfig;
     "@types/node": "^24",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "eslint": "^9",
-    "eslint-config-next": "16.0.0",
     "postcss": "^8",
-    "tailwindcss": "^4.1.15",
+    "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3"
   }
 }

package/.docs/organized/code-examples/with-parent-id-grouping.md

@@ -1202,13 +1202,6 @@ export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
 
 ```
 
-## eslint.config.ts
-
-```typescript
-export { default } from "@assistant-ui/x-buildutils/eslint";
-
-```
-
 ## lib/utils.ts
 
 ```typescript
@@ -1248,15 +1241,15 @@ export default nextConfig;
     "lint": "eslint ."
   },
   "dependencies": {
-    "@ai-sdk/openai": "^2.0.53",
+    "@ai-sdk/openai": "^2.0.60",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@radix-ui/react-slot": "^1.2.3",
     "@radix-ui/react-tooltip": "^1.2.8",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.546.0",
-    "next": "16.0.0",
+    "lucide-react": "^0.552.0",
+    "next": "16.0.1",
     "react": "19.2.0",
     "react-dom": "19.2.0",
     "remark-gfm": "^4.0.1",
@@ -1268,10 +1261,8 @@ export default nextConfig;
     "@types/node": "^24",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "eslint": "^9",
-    "eslint-config-next": "16.0.0",
     "postcss": "^8",
-    "tailwindcss": "^4.1.15",
+    "tailwindcss": "^4.1.16",
     "typescript": "^5"
   }
 }

package/.docs/organized/code-examples/with-react-hook-form.md

@@ -1571,13 +1571,6 @@ export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
 
 ```
 
-## eslint.config.ts
-
-```typescript
-export { default } from "@assistant-ui/x-buildutils/eslint";
-
-```
-
 ## lib/submitSignup.tsx
 
 ```tsx
@@ -1647,7 +1640,7 @@ export default nextConfig;
     "lint": "eslint ."
   },
   "dependencies": {
-    "@ai-sdk/openai": "^2.0.53",
+    "@ai-sdk/openai": "^2.0.60",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-hook-form": "workspace:*",
@@ -1660,15 +1653,15 @@ export default nextConfig;
     "@radix-ui/react-tabs": "^1.1.13",
     "@radix-ui/react-tooltip": "^1.2.8",
     "@react-hook/media-query": "^1.1.1",
-    "ai": "^5.0.76",
+    "ai": "^5.0.86",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "json-schema-to-zod": "^2.6.1",
-    "lucide-react": "^0.546.0",
-    "next": "16.0.0",
+    "lucide-react": "^0.552.0",
+    "next": "16.0.1",
     "react": "19.2.0",
     "react-dom": "19.2.0",
-    "react-hook-form": "^7.65.0",
+    "react-hook-form": "^7.66.0",
     "react-resizable-panels": "^3.0.6",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.3.1",
@@ -1681,10 +1674,8 @@ export default nextConfig;
     "@types/node": "^24",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "eslint": "^9",
-    "eslint-config-next": "16.0.0",
     "postcss": "^8",
-    "tailwindcss": "^4.1.15",
+    "tailwindcss": "^4.1.16",
     "typescript": "^5.9.3"
   }
 }

package/.docs/raw/docs/api-reference/context-providers/AssistantRuntimeProvider.mdx

@@ -13,9 +13,14 @@ You must either wrap your app in an `AssistantRuntimeProvider` or pass a `runtim
 
 ```tsx {1, 8, 10}
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
+import { useChatRuntime, AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
 
 const MyApp = () => {
-  const runtime = useChatRuntime({ api: "/api/chat" });
+  const runtime = useChatRuntime({
+    transport: new AssistantChatTransport({
+      api: "/api/chat",
+    }),
+  });
 
   return (
     <AssistantRuntimeProvider runtime={runtime}>

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

@@ -5,19 +5,29 @@ title: "@assistant-ui/react-ai-sdk"
 Vercel AI SDK integration for assistant-ui.
 
 import { ParametersTable } from "@/components/docs";
+import { Callout } from "fumadocs-ui/components/callout";
+
+<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.
+</Callout>
 
 ## API Reference
 
-### `useVercelUseChatRuntime`
+### `useChatRuntime`
 
-Convert Vercel AI SDK chat helpers into a `AssistantRuntime`.
+Creates a runtime directly with AI SDK v5's `useChat` hook integration. This is the recommended approach for most use cases.
 
 ```tsx
-import { useVercelUseChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime, AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
+import { AssistantRuntimeProvider } from "@assistant-ui/react";
 
 const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
-  const chat = useChat();
-  const runtime = useVercelUseChatRuntime(chat);
+  const runtime = useChatRuntime({
+    transport: new AssistantChatTransport({
+      api: "/api/chat",
+    }),
+  });
 
   return (
     <AssistantRuntimeProvider runtime={runtime}>
@@ -27,26 +37,86 @@ const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
 };
 ```
 
+To customize the API endpoint, simply change the `api` parameter:
+
+```tsx
+const runtime = useChatRuntime({
+  transport: new AssistantChatTransport({
+    api: "/my-custom-api/chat",
+  }),
+});
+```
+
 <ParametersTable
   parameters={[
     {
-      name: "chat",
-      type: "ReturnType<typeof useChat>",
-      description: "The UseChatHelpers from @ai-sdk/react.",
+      name: "options",
+      type: "UseChatRuntimeOptions",
+      description: "Configuration options for the chat runtime.",
+      children: [
+        {
+          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.",
+            },
+            {
+              name: "cloud",
+              type: "AssistantCloud",
+              description:
+                "Optional AssistantCloud instance for chat persistence.",
+            },
+            {
+              name: "initialMessages",
+              type: "UIMessage[]",
+              description: "Initial messages to populate the chat.",
+            },
+            {
+              name: "onFinish",
+              type: "(message: UIMessage) => void",
+              description: "Callback when a message completes streaming.",
+            },
+            {
+              name: "onError",
+              type: "(error: Error) => void",
+              description: "Callback for handling errors.",
+            },
+          ],
+        },
+      ],
     },
   ]}
 />
 
-### `useVercelUseAssistantRuntime`
+<Callout type="info">
+  By default, `useChatRuntime` uses `AssistantChatTransport` which automatically
+  forwards system messages and frontend tools to your backend API. This enables
+  your backend to receive the full context from the assistant-ui.
+</Callout>
+
+### `useAISDKRuntime`
 
-Convert Vercel AI SDK assistant helpers into a `AssistantRuntime`.
+For advanced use cases where you need direct access to the `useChat` hook from AI SDK.
 
 ```tsx
-import { useVercelUseAssistantRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChat } from "@ai-sdk/react";
+import { useAISDKRuntime } from "@assistant-ui/react-ai-sdk";
+import { AssistantRuntimeProvider } from "@assistant-ui/react";
 
 const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
-  const assistant = useAssistant();
-  const runtime = useVercelUseAssistantRuntime(assistant);
+  const chat = useChat({
+    api: "/api/chat",
+  });
+
+  const runtime = useAISDKRuntime(chat);
 
   return (
     <AssistantRuntimeProvider runtime={runtime}>
@@ -59,83 +129,76 @@ const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
 <ParametersTable
   parameters={[
     {
-      name: "assistant",
-      type: "ReturnType<typeof useAssistant>",
-      description: "The UseAssistantHelpers from @ai-sdk/react.",
+      name: "chat",
+      type: "ReturnType<typeof useChat>",
+      description: "The chat helpers from @ai-sdk/react's useChat hook.",
+    },
+    {
+      name: "options",
+      type: "AISDKRuntimeOptions",
+      description: "Optional configuration options.",
+      children: [
+        {
+          type: "AISDKRuntimeOptions",
+          parameters: [
+            {
+              name: "cloud",
+              type: "AssistantCloud",
+              description:
+                "Optional AssistantCloud instance for chat persistence.",
+            },
+            {
+              name: "adapters",
+              type: "RuntimeAdapters",
+              description:
+                "Optional runtime adapters for attachments, feedback, speech, etc.",
+            },
+          ],
+        },
+      ],
     },
   ]}
 />
 
-### `useVercelRSCRuntime`
+### `AssistantChatTransport`
 
-Convert Vercel RSC runtime into a `AssistantRuntime`.
+A transport that extends the default AI SDK transport to automatically forward system messages and frontend tools to your backend.
 
 ```tsx
-import { useVercelRSCRuntime } from "@assistant-ui/react-ai-sdk";
-
-const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
-  const [messages, setMessages] = useUIState<typeof AI>();
-
-  const onNew = async (m: AppendMessage) => {
-    if (m.content[0]?.type !== "text")
-      throw new Error("Only text messages are supported");
-
-    const input = m.content[0].text;
-    setMessages((currentConversation) => [
-      ...currentConversation,
-      { id: nanoid(), role: "user", display: input },
-    ]);
-
-    const message = await continueConversation(input);
-
-    setMessages((currentConversation) => [...currentConversation, message]);
-  };
-
-  const runtime = useVercelRSCRuntime({ messages, onNew });
-
-  return (
-    <AssistantRuntimeProvider runtime={runtime}>
-      {children}
-    </AssistantRuntimeProvider>
-  );
-};
+import { AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+
+const runtime = useChatRuntime({
+  transport: new AssistantChatTransport({
+    api: "/my-custom-api/chat",
+  }),
+});
 ```
 
 <ParametersTable
   parameters={[
     {
-      name: "adapter",
-      type: "VercelRSCAdapter<TMessage>",
-      description: "The Vercel RSC adapter to use.",
+      name: "options",
+      type: "HttpChatTransportInitOptions",
+      description: "Transport configuration options.",
       children: [
         {
-          type: "VercelRSCAdapter<TMessage>",
+          type: "HttpChatTransportInitOptions",
           parameters: [
             {
-              name: "messages",
-              type: "readonly ThreadMessage[]",
-              description: "The messages in the thread.",
+              name: "api",
+              type: "string",
+              description: "The API endpoint URL.",
             },
             {
-              name: "onNew",
-              type: "(message: AppendMessage) => Promise<void>",
-              description: "A function to append a message to the thread.",
+              name: "headers",
+              type: "Record<string, string> | Headers",
+              description: "Optional headers to include in requests.",
             },
             {
-              name: "onEdit",
-              type: "(message: AppendMessage) => Promise<void>",
-              description: "A function to edit a message.",
-            },
-            {
-              name: "onReload",
-              type: "(parentId: string | null) => Promise<void>",
-              description: "A function to reload a message.",
-            },
-            {
-              name: "convertMessage",
-              type: "(message: TMessage) => VercelRSCMessage",
-              description:
-                "A function to convert messages to the VercelRSCMessage format. Only required if your message objects are not already compatible with Vercel RSC.",
+              name: "credentials",
+              type: "RequestCredentials",
+              description: "Optional credentials mode for fetch requests.",
             },
           ],
         },
@@ -143,3 +206,49 @@ const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
     },
   ]}
 />
+
+### `frontendTools`
+
+Helper function to convert frontend tool definitions to AI SDK format for use in your backend.
+
+```tsx
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
+import { streamText, convertToModelMessages } from "ai";
+import { openai } from "@ai-sdk/openai";
+
+export async function POST(req: Request) {
+  const { messages, system, tools } = await req.json();
+
+  const result = streamText({
+    model: openai("gpt-4o"),
+    system,
+    messages: convertToModelMessages(messages),
+    tools: {
+      // Wrap frontend tools with the helper
+      ...frontendTools(tools),
+      // Your backend tools
+      myBackendTool: tool({
+        // ...
+      }),
+    },
+  });
+
+  return result.toUIMessageStreamResponse();
+}
+```
+
+<ParametersTable
+  parameters={[
+    {
+      name: "tools",
+      type: "Record<string, unknown>",
+      description:
+        "Frontend tools object forwarded from AssistantChatTransport.",
+    },
+  ]}
+/>
+
+<Callout type="info">
+  The `frontendTools` helper converts frontend tool definitions to the AI SDK
+  format and ensures they are properly handled by the streaming response.
+</Callout>

package/.docs/raw/docs/copilots/model-context.mdx

@@ -33,7 +33,6 @@ import {
   makeAssistantVisible,
   makeAssistantTool,
   tool,
-  useAssistantRuntime,
 } from "@assistant-ui/react";
 import { z } from "zod";
 
@@ -75,12 +74,12 @@ function Form() {
 The context provider system allows components to contribute to the model context. Here's a typical usage pattern:
 
 ```tsx
-import { useAssistantRuntime, tool } from "@assistant-ui/react";
+import { useAssistantApi, tool } from "@assistant-ui/react";
 import { useEffect } from "react";
 import { z } from "zod";
 
 function MyComponent() {
-  const assistantRuntime = useAssistantRuntime();
+  const api = useAssistantApi();
 
   // Define tool using the tool() helper
   const myTool = tool({
@@ -95,13 +94,13 @@ function MyComponent() {
 
   useEffect(() => {
     // Register context provider
-    return assistantRuntime.registerModelContextProvider({
+    return api.modelContext().register({
       getModelContext: () => ({
         system: "You are a helpful search assistant...",
         tools: { myTool },
       }),
     });
-  }, [assistantRuntime]); // Re-register if runtime changes
+  }, [api]); // Re-register if api changes
 
   return <div>{/* component content */}</div>;
 }

package/.docs/raw/docs/copilots/motivation.mdx

@@ -143,14 +143,14 @@ function SmartTransactionHistory() {
 Finally, let's add dynamic context based on the user's transaction patterns:
 
 ```tsx
-import { useAssistantRuntime } from "@assistant-ui/react";
+import { useAssistantApi } from "@assistant-ui/react";
 import { useEffect } from "react";
 
 function SmartTransactionHistory({ userProfile }) {
-  const assistantRuntime = useAssistantRuntime();
+  const api = useAssistantApi();
 
   useEffect(() => {
-    return assistantRuntime.registerModelContextProvider({
+    return api.modelContext().register({
       getModelContext: () => ({
         system: `
           User spending patterns:
@@ -160,7 +160,7 @@ function SmartTransactionHistory({ userProfile }) {
         `,
       }),
     });
-  }, [assistantRuntime, userProfile]);
+  }, [api, userProfile]);
 
   // Previous components...
 }

package/.docs/raw/docs/getting-started.mdx

@@ -1453,13 +1453,15 @@ If you aren't using Next.js, you can also deploy this endpoint to Cloudflare Wor
 
 ```tsx title="/app/page.tsx" tab="Thread"
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime, AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
 import { ThreadList } from "@/components/assistant-ui/thread-list";
 import { Thread } from "@/components/assistant-ui/thread";
 
 const MyApp = () => {
   const runtime = useChatRuntime({
-    api: "/api/chat",
+    transport: new AssistantChatTransport({
+      api: "/api/chat",
+    }),
   });
 
   return (
@@ -1477,12 +1479,14 @@ const MyApp = () => {
 // run `npx shadcn@latest add "https://r.assistant-ui.com/assistant-modal"`
 
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime, AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
 import { AssistantModal } from "@/components/assistant-ui/assistant-modal";
 
 const MyApp = () => {
   const runtime = useChatRuntime({
-    api: "/api/chat",
+    transport: new AssistantChatTransport({
+      api: "/api/chat",
+    }),
   });
 
   return (

package/.docs/raw/docs/guides/Attachments.mdx

@@ -508,14 +508,14 @@ class ValidatedImageAdapter implements AttachmentAdapter {
 Enable multi-file selection with custom limits:
 
 ```tsx
-const composer = useComposer();
+const api = useAssistantApi();
 
 const handleMultipleFiles = async (files: FileList) => {
   const maxFiles = 5;
   const filesToAdd = Array.from(files).slice(0, maxFiles);
 
   for (const file of filesToAdd) {
-    await composer.addAttachment({ file });
+    await api.composer().addAttachment({ file });
   }
 };
 ```

package/.docs/raw/docs/guides/Tools.mdx

@@ -165,15 +165,15 @@ function App() {
 
 ### 4. Advanced: Direct Context Registration
 
-Use `registerModelContextProvider` when you need to configure more than just tools:
+Use `api.modelContext().register()` when you need to configure more than just tools:
 
 ```tsx
-import { tool, useAssistantRuntime } from "@assistant-ui/react";
+import { tool, useAssistantApi } from "@assistant-ui/react";
 import { useEffect, useState } from "react";
 import { z } from "zod";
 
 function MyComponent() {
-  const runtime = useAssistantRuntime();
+  const api = useAssistantApi();
   const [isCreativeMode, setIsCreativeMode] = useState(false);
 
   useEffect(() => {
@@ -188,7 +188,7 @@ function MyComponent() {
     });
 
     // Register tools with model configuration
-    return runtime.registerModelContextProvider({
+    return api.modelContext().register({
       getModelContext: () => ({
         tools: { calculate: calculateTool },
         callSettings: {
@@ -198,7 +198,7 @@ function MyComponent() {
         priority: 10, // Higher priority overrides other providers
       }),
     });
-  }, [runtime, isCreativeMode]);
+  }, [api, isCreativeMode]);
 
   return <div>{/* Your component */}</div>;
 }

package/.docs/raw/docs/runtimes/ai-sdk/use-chat.mdx

@@ -94,10 +94,14 @@ export async function POST(req: Request) {
 
 import { Thread } from "@/components/assistant-ui/thread";
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime, AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
 
 export default function Home() {
-  const runtime = useChatRuntime();
+  const runtime = useChatRuntime({
+    transport: new AssistantChatTransport({
+      api: "/api/chat",
+    }),
+  });
 
   return (
     <AssistantRuntimeProvider runtime={runtime}>

package/.docs/raw/docs/runtimes/langserve.mdx

@@ -26,7 +26,7 @@ cd my-app
   </Step>
   <Step>
 
-### Install `@langchain/core`, `ai-sdk` and `@assistant-ui/react`
+### Install `@langchain/core`, AI SDK and `@assistant-ui/react`
 
 ```sh npm2yarn
 npm install @assistant-ui/react @assistant-ui/react-ai-sdk ai @ai-sdk/react @langchain/core
@@ -71,19 +71,14 @@ export async function POST(req: Request) {
 
 import { useChat } from "@ai-sdk/react";
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useVercelUseChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 
 export function MyRuntimeProvider({
   children,
 }: Readonly<{
   children: React.ReactNode;
 }>) {
-  const chat = useChat({
-    api: "/api/chat",
-    unstable_AISDKInterop: true,
-  });
-
-  const runtime = useVercelUseChatRuntime(chat);
+  const runtime = useChatRuntime();
 
   return (
     <AssistantRuntimeProvider runtime={runtime}>

package/.docs/raw/docs/runtimes/mastra/full-stack-integration.mdx

@@ -52,7 +52,7 @@ export async function POST(req: Request) {
     messages,
   });
 
-  return result.toDataStreamResponse();
+  return result.toUIMessageStreamResponse();
 }
 ```
 
@@ -184,8 +184,8 @@ export async function POST(req: Request) {
   // Stream the response using the agent
   const result = await agent.stream(messages);
 
-  // Return the result as a data stream response
-  return result.toDataStreamResponse();
+  // Return the result as a UI message stream response
+  return result.toUIMessageStreamResponse();
 }
 ```
 
@@ -194,7 +194,7 @@ Key changes:
 - We import the `mastra` instance created in `mastra/index.ts`. Make sure the import path (`@/mastra`) is correct for your project setup (you might need `~/mastra`, `../../../mastra`, etc., depending on your path aliases and project structure).
 - We retrieve the `chefAgent` using `mastra.getAgent("chefAgent")`.
 - Instead of calling the AI SDK's `streamText` directly, we call `agent.stream(messages)` to process the chat messages using the agent's configuration and model.
-- The result is still returned in a format compatible with assistant-ui using `toDataStreamResponse()`.
+- The result is still returned in a format compatible with assistant-ui using `toUIMessageStreamResponse()`.
 
 Your API route is now powered by Mastra!
 

package/.docs/raw/docs/ui/PartGrouping.mdx

@@ -515,12 +515,12 @@ Adjust group appearance based on content:
 
 ```tsx
 import { FC, PropsWithChildren } from "react";
-import { useMessage } from "@assistant-ui/react";
+import { useAssistantState } from "@assistant-ui/react";
 
 const DynamicGroup: FC<
   PropsWithChildren<{ groupKey: string | undefined; indices: number[] }>
 > = ({ groupKey, indices, children }) => {
-  const parts = useMessage((m) => m.content);
+  const parts = useAssistantState(({ message }) => message.content);
   const groupParts = indices.map((i) => parts[i]);
 
   // Analyze group content

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/mcp-docs-server",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "MCP server for assistant-ui documentation and examples",
   "type": "module",
   "main": "dist/index.js",
@@ -8,18 +8,17 @@
     "assistant-ui-mcp": "./dist/stdio.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.20.1",
+    "@modelcontextprotocol/sdk": "^1.20.2",
     "zod": "^4.1.12",
     "gray-matter": "^4.0.3",
     "cross-env": "^10.1.0"
   },
   "devDependencies": {
-    "@types/node": "^24.9.1",
+    "@types/node": "^24.10.0",
     "tsup": "^8.5.0",
     "tsx": "^4.20.6",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.1",
-    "eslint": "^9.38.0"
+    "vitest": "^4.0.6"
   },
   "files": [
     "dist",