@assistant-ui/mcp-docs-server 0.1.24 → 0.1.26

package/.docs/organized/code-examples/with-ag-ui.md

@@ -261,7 +261,6 @@ export function MyRuntimeProvider({
 "use client";
 
 import {
-  useAssistantRuntime,
   useAssistantTool,
   useAui,
   AuiProvider,
@@ -289,7 +288,7 @@ function BrowserAlertTool() {
       return { status: "shown" };
     },
     render: ({ args, result }) => (
-      <div className="mt-3 w-full max-w-[var(--thread-max-width)] rounded-lg border px-4 py-3 text-sm">
+      <div className="mt-3 w-full max-w-(--thread-max-width) rounded-lg border px-4 py-3 text-sm">
         <p className="font-semibold text-muted-foreground">browser_alert</p>
         <p className="mt-1">
           Requested alert with message:
@@ -310,11 +309,11 @@ function BrowserAlertTool() {
 }
 
 function NewThreadButton() {
-  const runtime = useAssistantRuntime();
+  const aui = useAui();
 
   return (
     <button
-      onClick={() => runtime.switchToNewThread()}
+      onClick={() => aui.threads().switchToNewThread()}
       className="absolute top-4 right-4 z-10 flex items-center gap-2 rounded-lg border bg-background px-3 py-2 font-medium text-sm shadow-sm transition-colors hover:bg-accent"
     >
       <PlusIcon className="size-4" />
@@ -414,29 +413,29 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ag-ui/client": "^0.0.47",
+    "@ag-ui/client": "^0.0.48",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ag-ui": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.576.0",
-    "next": "^16.1.6",
+    "lucide-react": "^1.7.0",
+    "next": "^16.2.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.1",
-    "@types/node": "^25.3.3",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.8",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "5.9.3"
   }
 }
 

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

@@ -4,27 +4,39 @@
 
 ```typescript
 import { openai } from "@ai-sdk/openai";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import {
+  JSONSchema7,
   streamText,
   convertToModelMessages,
+  type UIMessage,
   tool,
   stepCountIs,
   zodSchema,
 } from "ai";
-import type { UIMessage } from "ai";
 import { z } from "zod";
 
 // Allow streaming responses up to 30 seconds
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
-  const { messages }: { messages: UIMessage[] } = await req.json();
+  const {
+    messages,
+    system,
+    tools,
+  }: {
+    messages: UIMessage[];
+    system?: string;
+    tools?: Record<string, { description?: string; parameters: JSONSchema7 }>;
+  } = await req.json();
 
   const result = streamText({
     model: openai("gpt-4o"),
     messages: await convertToModelMessages(messages),
+    ...(system ? { system } : {}),
     stopWhen: stepCountIs(10),
     tools: {
+      ...frontendTools(tools ?? {}),
       get_current_weather: tool({
         description: "Get the current weather",
         inputSchema: zodSchema(
@@ -179,8 +191,8 @@ import type { Metadata } from "next";
 import "./globals.css";
 
 export const metadata: Metadata = {
-  title: "AI SDK v5 Example",
-  description: "Example using @assistant-ui/react with AI SDK v5",
+  title: "AI SDK v6 Example",
+  description: "Example using @assistant-ui/react with AI SDK v6",
 };
 
 export default function RootLayout({
@@ -303,16 +315,16 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.39",
+    "@ai-sdk/openai": "^3.0.48",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.111",
+    "ai": "^6.0.138",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.576.0",
-    "next": "^16.1.6",
+    "lucide-react": "^1.7.0",
+    "next": "^16.2.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.5.0",
@@ -320,14 +332,14 @@ export default nextConfig;
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.1",
-    "@types/node": "^25.3.3",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.8",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "5.9.3"
   }
 }
 
@@ -353,26 +365,26 @@ cd my-app
 
 Create `.env.local`:
 
-```
-ANTHROPIC_API_KEY=your-api-key-here
+```sh
+OPENAI_API_KEY=your-api-key-here
 ```
 
 ### Run
 
 ```bash
-npm install
-npm run dev
+pnpm install
+pnpm dev
 ```
 
 Open [http://localhost:3000](http://localhost:3000) to see the result.
 
 ## Key Features
 
-- Uses the new AI SDK v6 with `@ai-sdk/react` and `@ai-sdk/anthropic`
+- Uses the new AI SDK v6 with `@ai-sdk/openai`
 - Integrates with `@assistant-ui/react` using the new `useChatRuntime` hook
 - No RSC support (client-side only)
 - Simplified integration with the `useChatRuntime` hook that wraps AI SDK v6's `useChat`
-- Automatically uses `AssistantChatTransport` to pass system messages and frontend tools to the backend
+- Uses `AssistantChatTransport` to pass system messages and frontend tools to the backend
 
 ## Custom Transport Configuration
 
@@ -406,7 +418,7 @@ const runtime = useChatRuntime({
 
 ## API Route
 
-The API route at `/api/chat` uses the new `streamText` function from AI SDK v6 to handle chat completions.
+The API route at `/api/chat` uses AI SDK v6 `streamText`, forwards `system` and frontend `tools`, and merges them with a server-defined weather tool.
 
 ## Related Documentation
 

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

@@ -413,16 +413,16 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.39",
+    "@ai-sdk/openai": "^3.0.48",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.111",
+    "ai": "^6.0.138",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.576.0",
-    "next": "^16.1.6",
+    "lucide-react": "^1.7.0",
+    "next": "^16.2.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.5.0",
@@ -430,14 +430,14 @@ export default nextConfig;
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.1",
-    "@types/node": "^25.3.3",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.8",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "5.9.3"
   }
 }
 

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

@@ -423,8 +423,8 @@ export default nextConfig;
     "@assistant-ui/ui": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.576.0",
-    "next": "^16.1.6",
+    "lucide-react": "^1.7.0",
+    "next": "^16.2.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.5.0",
@@ -432,14 +432,14 @@ export default nextConfig;
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.1",
-    "@types/node": "^25.3.3",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.8",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "5.9.3"
   }
 }
 

package/.docs/organized/code-examples/with-chain-of-thought.md

@@ -212,7 +212,6 @@ export default function RootLayout({
 
 import { type FC, type PropsWithChildren, useState } from "react";
 import { MarkdownText } from "@/components/assistant-ui/markdown-text";
-import { ToolFallback } from "@/components/assistant-ui/tool-fallback";
 import { TooltipIconButton } from "@/components/assistant-ui/tooltip-icon-button";
 import { Button } from "@/components/ui/button";
 import {
@@ -238,9 +237,12 @@ export const MyThread: FC = () => {
       style={{ ["--thread-max-width" as string]: "44rem" }}
     >
       <ThreadPrimitive.Viewport className="flex flex-1 flex-col overflow-y-scroll scroll-smooth px-4 pt-8">
-        <ThreadPrimitive.Messages
-          components={{ UserMessage, AssistantMessage }}
-        />
+        <ThreadPrimitive.Messages>
+          {({ message }) => {
+            if (message.role === "user") return <UserMessage />;
+            return <AssistantMessage />;
+          }}
+        </ThreadPrimitive.Messages>
 
         <ThreadPrimitive.ViewportFooter className="sticky bottom-0 mx-auto mt-auto flex w-full max-w-(--thread-max-width) flex-col gap-4 pb-4">
           <ThreadPrimitive.ScrollToBottom asChild>
@@ -268,7 +270,12 @@ const UserMessage: FC = () => {
     <MessagePrimitive.Root className="mx-auto w-full max-w-(--thread-max-width) py-3">
       <div className="flex justify-end">
         <div className="max-w-[80%] rounded-2xl bg-primary px-4 py-2 text-primary-foreground">
-          <MessagePrimitive.Parts components={{ Text }} />
+          <MessagePrimitive.Parts>
+            {({ part }) => {
+              if (part.type === "text") return <Text {...part} />;
+              return null;
+            }}
+          </MessagePrimitive.Parts>
         </div>
       </div>
     </MessagePrimitive.Root>
@@ -279,17 +286,14 @@ const AssistantMessage: FC = () => {
   return (
     <MessagePrimitive.Root className="mx-auto w-full max-w-(--thread-max-width) py-3">
       <div className="flex flex-col gap-2 px-2 leading-relaxed">
-        {/*
-          The ChainOfThought component is passed to MessagePrimitive.Parts.
-          When set, consecutive reasoning + tool-call parts are grouped together
-          and rendered through this component instead of individually.
-        */}
-        <MessagePrimitive.Parts
-          components={{
-            Text: MarkdownText,
-            ChainOfThought,
+        {/* Text parts are rendered inline; ChainOfThought is rendered separately below. */}
+        <MessagePrimitive.Parts>
+          {({ part }) => {
+            if (part.type === "text") return <MarkdownText />;
+            return null;
           }}
-        />
+        </MessagePrimitive.Parts>
+        <ChainOfThought />
       </div>
     </MessagePrimitive.Root>
   );
@@ -315,13 +319,17 @@ const ChainOfThought: FC = () => {
         Thinking
       </ChainOfThoughtPrimitive.AccordionTrigger>
       <AuiIf condition={(s) => !s.chainOfThought.collapsed}>
-        <ChainOfThoughtPrimitive.Parts
-          components={{
-            Reasoning,
-            tools: { Fallback: ToolFallback },
-            Layout: PartLayout,
+        <ChainOfThoughtPrimitive.Parts>
+          {({ part }) => {
+            if (part.type === "reasoning")
+              return (
+                <PartLayout>
+                  <Reasoning {...part} />
+                </PartLayout>
+              );
+            return null;
           }}
-        />
+        </ChainOfThoughtPrimitive.Parts>
       </AuiIf>
     </ChainOfThoughtPrimitive.Root>
   );
@@ -549,16 +557,16 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.39",
+    "@ai-sdk/openai": "^3.0.48",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.111",
+    "ai": "^6.0.138",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.576.0",
-    "next": "^16.1.6",
+    "lucide-react": "^1.7.0",
+    "next": "^16.2.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.5.0",
@@ -566,14 +574,14 @@ export default nextConfig;
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.1",
-    "@types/node": "^25.3.3",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.8",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "5.9.3"
   }
 }
 

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

@@ -19,10 +19,14 @@ export async function POST(req: Request) {
 
   return result.toUIMessageStreamResponse({
     messageMetadata: ({ part }) => {
+      if (part.type === "finish") {
+        return {
+          usage: part.totalUsage,
+        };
+      }
       if (part.type === "finish-step") {
         return {
           modelId: part.response.modelId,
-          usage: part.usage,
         };
       }
       return undefined;
@@ -561,28 +565,27 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.39",
+    "@ai-sdk/openai": "^3.0.48",
     "@assistant-ui/cloud-ai-sdk": "workspace:*",
-    "ai": "^6.0.111",
-    "assistant-cloud": "workspace:*",
+    "ai": "^6.0.138",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.576.0",
-    "next": "^16.1.6",
+    "lucide-react": "^1.7.0",
+    "next": "^16.2.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.1",
-    "@types/node": "^25.3.3",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.8",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "5.9.3"
   }
 }
 
@@ -595,7 +598,7 @@ export default nextConfig;
 
 Lightweight cloud persistence for AI SDK apps without assistant-ui components.
 
-> **Want the full assistant-ui experience?** See [with-cloud](../with-cloud) instead, which uses `useChatRuntime` with `<Thread />` and other primitives.
+> **Want the full assistant-ui experience?** See [with-cloud](https://github.com/assistant-ui/assistant-ui/tree/main/examples/with-cloud) instead, which uses `useChatRuntime` with `<Thread />` and other primitives.
 
 ## Setup
 

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

@@ -327,30 +327,30 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.39",
+    "@ai-sdk/openai": "^3.0.48",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.111",
+    "ai": "^6.0.138",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.576.0",
-    "next": "^16.1.6",
+    "lucide-react": "^1.7.0",
+    "next": "^16.2.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.1",
-    "@types/node": "^25.3.3",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.8",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "5.9.3"
   }
 }
 

package/.docs/organized/code-examples/with-custom-thread-list.md

@@ -209,8 +209,8 @@ export default function RootLayout({
 import type { ReactNode } from "react";
 import {
   AssistantRuntimeProvider,
-  unstable_useRemoteThreadListRuntime as useRemoteThreadListRuntime,
-  type unstable_RemoteThreadListAdapter as RemoteThreadListAdapter,
+  useRemoteThreadListRuntime,
+  type RemoteThreadListAdapter,
 } from "@assistant-ui/react";
 import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 import { createAssistantStream } from "assistant-stream";
@@ -414,17 +414,17 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.39",
+    "@ai-sdk/openai": "^3.0.48",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.111",
+    "ai": "^6.0.138",
     "assistant-stream": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.576.0",
-    "next": "^16.1.6",
+    "lucide-react": "^1.7.0",
+    "next": "^16.2.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.5.0",
@@ -432,14 +432,14 @@ export default nextConfig;
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.1",
-    "@types/node": "^25.3.3",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.8",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "5.9.3"
   }
 }
 

package/.docs/organized/code-examples/with-elevenlabs-scribe.md

@@ -562,34 +562,34 @@ export default nextConfig;
   "version": "0.0.0",
   "type": "module",
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.39",
-    "@ai-sdk/react": "^3.0.113",
+    "@ai-sdk/openai": "^3.0.48",
+    "@ai-sdk/react": "^3.0.140",
     "@assistant-ui/react": "workspace:^",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:^",
     "@assistant-ui/ui": "workspace:*",
-    "@elevenlabs/client": "^0.15.0",
-    "@tailwindcss/postcss": "^4.2.1",
-    "ai": "^6.0.111",
+    "@elevenlabs/client": "^0.16.0",
+    "@tailwindcss/postcss": "^4.2.2",
+    "ai": "^6.0.138",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.576.0",
-    "motion": "^12.34.5",
-    "next": "^16.1.6",
+    "lucide-react": "^1.7.0",
+    "motion": "^12.38.0",
+    "next": "^16.2.1",
     "postcss": "^8.5.8",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.5.0",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.2",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@types/node": "^25.3.3",
+    "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "5.9.3"
   },
   "scripts": {
     "dev": "next dev",