@assistant-ui/mcp-docs-server 0.1.5 → 0.1.7

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

@@ -199,14 +199,12 @@ export default function RootLayout({
 "use client";
 
 import { Thread } from "@/components/assistant-ui/thread";
-import { useChat } from "@ai-sdk/react";
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useAISDKRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 
 export default function Home() {
-  const chat = useChat();
-
-  const runtime = useAISDKRuntime(chat);
+  // Using the new simplified useChatRuntime hook
+  const runtime = useChatRuntime();
 
   return (
     <AssistantRuntimeProvider runtime={runtime}>
@@ -243,6 +241,7 @@ export default function Home() {
   },
   "iconLibrary": "lucide"
 }
+
 ```
 
 ## components/assistant-ui/markdown-text.tsx
@@ -1035,34 +1034,34 @@ export default nextConfig;
   "version": "0.0.0",
   "type": "module",
   "dependencies": {
-    "@ai-sdk/openai": "^2.0.0",
-    "@ai-sdk/react": "^2.0.0",
+    "@ai-sdk/openai": "^2.0.15",
+    "@ai-sdk/react": "^2.0.15",
     "@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.7",
-    "@tailwindcss/postcss": "^4.1.11",
-    "ai": "^5.0.0",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "@tailwindcss/postcss": "^4.1.12",
+    "ai": "^5.0.15",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.535.0",
-    "next": "15.4.5",
+    "lucide-react": "^0.539.0",
+    "next": "15.4.6",
     "postcss": "^8.5.6",
     "react": "19.1.1",
     "react-dom": "19.1.1",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.3.1",
-    "tailwindcss": "^4.1.11",
-    "zod": "^4.0.14"
+    "tailwindcss": "^4.1.12",
+    "zod": "^4.0.17"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@types/node": "^24.1.0",
-    "@types/react": "^19.1.9",
+    "@types/node": "^24.3.0",
+    "@types/react": "^19.1.10",
     "@types/react-dom": "^19.1.7",
     "eslint": "^9",
-    "eslint-config-next": "15.4.5",
+    "eslint-config-next": "15.4.6",
     "tw-animate-css": "^1.3.6",
     "typescript": "^5.9.2"
   },
@@ -1086,21 +1085,25 @@ This example demonstrates how to use `@assistant-ui/react-ai-sdk-v5` with the Ve
 ## Getting Started
 
 1. Install dependencies:
+
 ```bash
 npm install
 ```
 
 2. Set up your environment variables:
+
 ```bash
 cp .env.example .env.local
 ```
 
 Add your Anthropic API key to `.env.local`:
+
 ```
 ANTHROPIC_API_KEY=your-api-key-here
 ```
 
 3. Run the development server:
+
 ```bash
 npm run dev
 ```
@@ -1110,13 +1113,45 @@ Open [http://localhost:3000](http://localhost:3000) to see the result.
 ## Key Features
 
 - Uses the new AI SDK v5 with `@ai-sdk/react` and `@ai-sdk/anthropic`
-- Integrates with `@assistant-ui/react` using the v5-compatible runtime
+- Integrates with `@assistant-ui/react` using the new `useChatRuntime` hook
 - No RSC support (client-side only)
-- Uses the `useChat` hook from AI SDK v5
+- Simplified integration with the `useChatRuntime` hook that wraps AI SDK v5's `useChat`
+- Automatically uses `AssistantChatTransport` to pass system messages and frontend tools to the backend
+
+## Custom Transport Configuration
+
+By default, `useChatRuntime` uses `AssistantChatTransport` which automatically forwards system messages and frontend tools to the backend.
+
+### Custom API URL with Forwarding
+
+When customizing the API URL, you must explicitly use `AssistantChatTransport` to keep system/tools forwarding:
+
+```typescript
+import { AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
+
+const runtime = useChatRuntime({
+  transport: new AssistantChatTransport({
+    api: "/my-custom-api/chat", // Custom URL with system/tools forwarding
+  }),
+});
+```
+
+### Disable System/Tools Forwarding
+
+To use the standard AI SDK transport without forwarding:
+
+```typescript
+import { DefaultChatTransport } from "ai";
+
+const runtime = useChatRuntime({
+  transport: new DefaultChatTransport(), // No system/tools forwarding
+});
+```
 
 ## API Route
 
 The API route at `/api/chat` uses the new `streamText` function from AI SDK v5 to handle chat completions.
+
 ```
 
 ## tsconfig.json

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

@@ -4,9 +4,9 @@
 
 ```typescript
 import { openai } from "@ai-sdk/openai";
-import { jsonSchema, streamText } from "ai";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
+import { convertToModelMessages, streamText } from "ai";
 
-export const runtime = "edge";
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
@@ -14,22 +14,15 @@ export async function POST(req: Request) {
 
   const result = streamText({
     model: openai("gpt-4o"),
-    messages,
+    messages: convertToModelMessages(messages),
     // forward system prompt and tools from the frontend
     system,
-    tools:
-      tools &&
-      Object.fromEntries(
-        Object.entries<{ parameters: unknown }>(tools).map(([name, tool]) => [
-          name,
-          {
-            parameters: jsonSchema(tool.parameters!),
-          },
-        ]),
-      ),
+    tools: {
+      ...frontendTools(tools),
+    },
   });
 
-  return result.toDataStreamResponse();
+  return result.toUIMessageStreamResponse();
 }
 
 ```
@@ -210,7 +203,7 @@ export default function RootLayout({
 "use client";
 
 import { AssistantCloud, AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk-v4";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 
 const cloud = new AssistantCloud({
   baseUrl: process.env["NEXT_PUBLIC_ASSISTANT_BASE_URL"]!,
@@ -224,7 +217,6 @@ export function MyRuntimeProvider({
 }>) {
   const runtime = useChatRuntime({
     cloud,
-    api: "/api/chat",
   });
 
   return (
@@ -279,6 +271,7 @@ export default function Home() {
   },
   "iconLibrary": "lucide"
 }
+
 ```
 
 ## components/assistant-ui/markdown-text.tsx
@@ -1096,19 +1089,19 @@ export default nextConfig;
     "lint": "next lint"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^1.3.22",
+    "@ai-sdk/openai": "^2.0.15",
     "@assistant-ui/react": "workspace:*",
-    "@assistant-ui/react-ai-sdk-v4": "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.7",
-    "ai": "^4.3.16",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "ai": "^5.0.15",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "jsonwebtoken": "^9.0.2",
-    "lucide-react": "^0.535.0",
+    "lucide-react": "^0.539.0",
     "nanoid": "5.1.5",
-    "next": "15.4.5",
+    "next": "15.4.6",
     "react": "19.1.1",
     "react-dom": "19.1.1",
     "remark-gfm": "^4.0.1",
@@ -1122,9 +1115,9 @@ export default nextConfig;
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-config-next": "15.4.5",
+    "eslint-config-next": "15.4.6",
     "postcss": "^8",
-    "tailwindcss": "^4.1.11",
+    "tailwindcss": "^4.1.12",
     "typescript": "^5"
   }
 }

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

@@ -1001,15 +1001,15 @@ export default nextConfig;
     "lint": "next lint"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^1.3.22",
+    "@ai-sdk/openai": "^2.0.15",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@radix-ui/react-slot": "^1.2.3",
-    "@radix-ui/react-tooltip": "^1.2.7",
+    "@radix-ui/react-tooltip": "^1.2.8",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.535.0",
-    "next": "15.4.5",
+    "lucide-react": "^0.539.0",
+    "next": "15.4.6",
     "react": "19.1.1",
     "react-dom": "19.1.1",
     "remark-gfm": "^4.0.1",
@@ -1022,9 +1022,9 @@ export default nextConfig;
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-config-next": "15.4.5",
+    "eslint-config-next": "15.4.6",
     "postcss": "^8",
-    "tailwindcss": "^4.1.11",
+    "tailwindcss": "^4.1.12",
     "typescript": "^5"
   }
 }

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

@@ -4,10 +4,9 @@
 
 ```typescript
 import { openai } from "@ai-sdk/openai";
-import { frontendTools } from "@assistant-ui/react-ai-sdk-v4";
-import { streamText } from "ai";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
+import { convertToModelMessages, streamText } from "ai";
 
-export const runtime = "edge";
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
@@ -15,8 +14,7 @@ export async function POST(req: Request) {
 
   const result = streamText({
     model: openai("gpt-4o"),
-    messages,
-    toolCallStreaming: true,
+    messages: convertToModelMessages(messages),
     system,
     tools: {
       ...frontendTools(tools),
@@ -24,7 +22,7 @@ export async function POST(req: Request) {
     },
   });
 
-  return result.toDataStreamResponse();
+  return result.toUIMessageStreamResponse();
 }
 
 ```
@@ -192,8 +190,9 @@ export default function RootLayout({
 
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
 import { AttachmentAdapter } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk-v4";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 import { INTERNAL } from "@assistant-ui/react";
+import { lastAssistantMessageIsCompleteWithToolCalls } from "ai";
 
 const { generateId } = INTERNAL;
 
@@ -232,8 +231,7 @@ export function MyRuntimeProvider({
   children: React.ReactNode;
 }>) {
   const runtime = useChatRuntime({
-    api: "/api/chat",
-    maxSteps: 4,
+    sendAutomaticallyWhen: lastAssistantMessageIsCompleteWithToolCalls,
     adapters: {
       attachments: attachmentAdapter,
     },
@@ -1225,9 +1223,9 @@ export default nextConfig;
     "lint": "next lint"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^1.3.22",
+    "@ai-sdk/openai": "^2.0.15",
     "@assistant-ui/react": "workspace:*",
-    "@assistant-ui/react-ai-sdk-v4": "workspace:*",
+    "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-hook-form": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@ffmpeg/ffmpeg": "^0.12.15",
@@ -1237,24 +1235,23 @@ export default nextConfig;
     "@radix-ui/react-icons": "^1.3.2",
     "@radix-ui/react-label": "^2.1.7",
     "@radix-ui/react-slot": "^1.2.3",
-    "@radix-ui/react-tabs": "^1.1.12",
-    "@radix-ui/react-tooltip": "^1.2.7",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@radix-ui/react-tooltip": "^1.2.8",
     "@react-hook/media-query": "^1.1.1",
-    "ai": "^4.3.16",
+    "ai": "^5.0.15",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "json-schema-to-zod": "^2.6.1",
-    "lucide-react": "^0.535.0",
-    "next": "15.4.5",
+    "lucide-react": "^0.539.0",
+    "next": "15.4.6",
     "react": "19.1.1",
     "react-dom": "19.1.1",
-    "react-hook-form": "^7.61.1",
+    "react-hook-form": "^7.62.0",
     "react-resizable-panels": "^3.0.4",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.3.1",
     "tw-animate-css": "^1.3.6",
-    "zod": "^4.0.14",
-    "zod-to-json-schema": "^3.24.6",
+    "zod": "^4.0.17",
     "zustand": "^5.0.7"
   },
   "devDependencies": {
@@ -1263,9 +1260,9 @@ export default nextConfig;
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-config-next": "15.4.5",
+    "eslint-config-next": "15.4.6",
     "postcss": "^8",
-    "tailwindcss": "^4.1.11",
+    "tailwindcss": "^4.1.12",
     "typescript": "^5.9.2"
   }
 }

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

@@ -5,8 +5,6 @@
 ```typescript
 import { NextRequest, NextResponse } from "next/server";
 
-export const runtime = "edge";
-
 function getCorsHeaders() {
   return {
     "Access-Control-Allow-Origin": "*",
@@ -1727,16 +1725,16 @@ export default nextConfig;
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-langgraph": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
-    "@langchain/langgraph-sdk": "^0.0.105",
+    "@langchain/langgraph-sdk": "^0.0.107",
     "@radix-ui/react-slot": "^1.2.3",
-    "@radix-ui/react-tooltip": "^1.2.7",
+    "@radix-ui/react-tooltip": "^1.2.8",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "js-cookie": "^3.0.5",
     "jsonwebtoken": "^9.0.2",
-    "lucide-react": "^0.535.0",
+    "lucide-react": "^0.539.0",
     "nanoid": "5.1.5",
-    "next": "15.4.5",
+    "next": "15.4.6",
     "react": "19.1.1",
     "react-dom": "19.1.1",
     "remark-gfm": "^4.0.1",
@@ -1751,9 +1749,9 @@ export default nextConfig;
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-config-next": "15.4.5",
+    "eslint-config-next": "15.4.6",
     "postcss": "^8",
-    "tailwindcss": "^4.1.11",
+    "tailwindcss": "^4.1.12",
     "typescript": "^5.9.2"
   }
 }
@@ -1784,6 +1782,7 @@ To run the example, run the following commands:
 npm install
 npm run dev
 ```
+
 ```
 
 ## tsconfig.json

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

@@ -1247,15 +1247,15 @@ export default nextConfig;
     "lint": "next lint"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^1.3.22",
+    "@ai-sdk/openai": "^2.0.15",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@radix-ui/react-slot": "^1.2.3",
-    "@radix-ui/react-tooltip": "^1.2.7",
+    "@radix-ui/react-tooltip": "^1.2.8",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.535.0",
-    "next": "15.4.5",
+    "lucide-react": "^0.539.0",
+    "next": "15.4.6",
     "react": "19.1.1",
     "react-dom": "19.1.1",
     "remark-gfm": "^4.0.1",
@@ -1268,9 +1268,9 @@ export default nextConfig;
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-config-next": "15.4.5",
+    "eslint-config-next": "15.4.6",
     "postcss": "^8",
-    "tailwindcss": "^4.1.11",
+    "tailwindcss": "^4.1.12",
     "typescript": "^5"
   }
 }
@@ -1297,6 +1297,7 @@ This example demonstrates how to use the parent ID feature in assistant-ui to gr
 ## How it works
 
 1. **Message Structure**: The example uses the external store runtime with predefined messages that include parts with `parentId` fields:
+
    ```typescript
    {
      type: "text",
@@ -1335,10 +1336,12 @@ Open [http://localhost:3000](http://localhost:3000) to see the example.
 ## Use Cases
 
 This pattern is useful for:
+
 - Grouping research sources with their related findings
 - Organizing multi-step tool executions
 - Creating hierarchical content structures
 - Showing related content in collapsible sections
+
 ```
 
 ## tsconfig.json

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

@@ -4,10 +4,9 @@
 
 ```typescript
 import { openai } from "@ai-sdk/openai";
-import { frontendTools } from "@assistant-ui/react-ai-sdk-v4";
-import { streamText } from "ai";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
+import { convertToModelMessages, streamText } from "ai";
 
-export const runtime = "edge";
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
@@ -15,15 +14,14 @@ export async function POST(req: Request) {
 
   const result = streamText({
     model: openai("gpt-4o"),
-    messages,
-    toolCallStreaming: true,
+    messages: convertToModelMessages(messages),
     system,
     tools: {
       ...frontendTools(tools),
     },
   });
 
-  return result.toDataStreamResponse();
+  return result.toUIMessageStreamResponse();
 }
 
 ```
@@ -189,16 +187,14 @@ export default function RootLayout({
 "use client";
 
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk-v4";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 
 export function MyRuntimeProvider({
   children,
 }: Readonly<{
   children: React.ReactNode;
 }>) {
-  const runtime = useChatRuntime({
-    api: "/api/chat",
-  });
+  const runtime = useChatRuntime();
 
   return (
     <AssistantRuntimeProvider runtime={runtime}>
@@ -1649,7 +1645,7 @@ export default nextConfig;
     "lint": "next lint"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^1.3.22",
+    "@ai-sdk/openai": "^2.0.15",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-hook-form": "workspace:*",
@@ -1659,24 +1655,23 @@ export default nextConfig;
     "@radix-ui/react-icons": "^1.3.2",
     "@radix-ui/react-label": "^2.1.7",
     "@radix-ui/react-slot": "^1.2.3",
-    "@radix-ui/react-tabs": "^1.1.12",
-    "@radix-ui/react-tooltip": "^1.2.7",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@radix-ui/react-tooltip": "^1.2.8",
     "@react-hook/media-query": "^1.1.1",
-    "ai": "^4.3.16",
+    "ai": "^5.0.15",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "json-schema-to-zod": "^2.6.1",
-    "lucide-react": "^0.535.0",
-    "next": "15.4.5",
+    "lucide-react": "^0.539.0",
+    "next": "15.4.6",
     "react": "19.1.1",
     "react-dom": "19.1.1",
-    "react-hook-form": "^7.61.1",
+    "react-hook-form": "^7.62.0",
     "react-resizable-panels": "^3.0.4",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.3.1",
     "tw-animate-css": "^1.3.6",
-    "zod": "^4.0.14",
-    "zod-to-json-schema": "^3.24.6",
+    "zod": "^4.0.17",
     "zustand": "^5.0.7"
   },
   "devDependencies": {
@@ -1685,9 +1680,9 @@ export default nextConfig;
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-config-next": "15.4.5",
+    "eslint-config-next": "15.4.6",
     "postcss": "^8",
-    "tailwindcss": "^4.1.11",
+    "tailwindcss": "^4.1.12",
     "typescript": "^5.9.2"
   }
 }

package/.docs/raw/docs/api-reference/overview.mdx

@@ -29,10 +29,7 @@ export const contextColors = {
 ### AI SDK
 
 - [`useChatRuntime`](#use-chat-runtime)
-- [`useVercelUseChatRuntime`](#use-vercel-use-chat-runtime) (legacy)
-- [`useVercelUseAssistantRuntime`](#use-vercel-use-assistant-runtime)
-- [`useVercelRSCRuntime`](#use-vercel-rsc-runtime)
-- [`useDangerousInBrowserRuntime`](#use-dangerous-in-browser-runtime)
+- [`useAISDKRuntime`](#use-aisdk-runtime)
 
 ### LangGraph