@assistant-ui/mcp-docs-server 0.1.30 → 0.1.32

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

@@ -25,7 +25,7 @@ export async function POST(req: Request) {
 
   const result = streamText({
     // Use a reasoning model to showcase chain of thought
-    model: openai("o4-mini"),
+    model: openai("gpt-5.4-mini"),
     messages: await convertToModelMessages(messages),
     stopWhen: stepCountIs(10),
     tools: {
@@ -45,9 +45,15 @@ export async function POST(req: Request) {
         },
       }),
     },
+    providerOptions: {
+      openai: {
+        reasoningEffort: "high",
+        reasoningSummary: "auto",
+      },
+    },
   });
 
-  return result.toUIMessageStreamResponse();
+  return result.toUIMessageStreamResponse({ sendReasoning: true });
 }
 
 ```
@@ -188,7 +194,7 @@ import "./globals.css";
 
 export const metadata: Metadata = {
   title: "Chain of Thought Example",
-  description: "Example using ChainOfThoughtPrimitive with AI SDK",
+  description: "Example using MessagePrimitive.GroupedParts with AI SDK",
 };
 
 export default function RootLayout({
@@ -215,12 +221,11 @@ import { MarkdownText } from "@/components/assistant-ui/markdown-text";
 import { TooltipIconButton } from "@/components/assistant-ui/tooltip-icon-button";
 import { Button } from "@/components/ui/button";
 import {
-  AuiIf,
-  ChainOfThoughtPrimitive,
   ComposerPrimitive,
   MessagePrimitive,
+  SuggestionPrimitive,
   ThreadPrimitive,
-  useAuiState,
+  useThread,
 } from "@assistant-ui/react";
 import {
   ArrowDownIcon,
@@ -237,6 +242,10 @@ 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.Empty>
+          <ThreadWelcome />
+        </ThreadPrimitive.Empty>
+
         <ThreadPrimitive.Messages>
           {({ message }) => {
             if (message.role === "user") return <UserMessage />;
@@ -265,6 +274,36 @@ const Text: FC<{ text: string }> = ({ text }) => {
   return <p>{text}</p>;
 };
 
+const ThreadWelcome: FC = () => {
+  return (
+    <div className="mx-auto flex w-full max-w-(--thread-max-width) grow flex-col justify-center gap-6">
+      <div>
+        <h1 className="font-semibold text-2xl">What should we calculate?</h1>
+      </div>
+      <div className="flex flex-wrap gap-2">
+        <ThreadPrimitive.Suggestions>
+          {() => <ThreadSuggestionItem />}
+        </ThreadPrimitive.Suggestions>
+      </div>
+    </div>
+  );
+};
+
+const ThreadSuggestionItem: FC = () => {
+  return (
+    <SuggestionPrimitive.Trigger send asChild>
+      <Button
+        type="button"
+        variant="ghost"
+        className="h-auto w-full flex-col items-start justify-start gap-1 rounded-2xl border bg-background px-4 py-3 text-start text-sm hover:bg-muted sm:w-[calc(50%-0.25rem)]"
+      >
+        <SuggestionPrimitive.Title className="font-medium" />
+        <SuggestionPrimitive.Description className="text-muted-foreground empty:hidden" />
+      </Button>
+    </SuggestionPrimitive.Trigger>
+  );
+};
+
 const UserMessage: FC = () => {
   return (
     <MessagePrimitive.Root className="mx-auto w-full max-w-(--thread-max-width) py-3">
@@ -286,61 +325,69 @@ 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">
-        {/* Text parts are rendered inline; ChainOfThought is rendered separately below. */}
-        <MessagePrimitive.Parts>
-          {({ part }) => {
-            if (part.type === "text") return <MarkdownText />;
+        <MessagePrimitive.GroupedParts
+          groupBy={(part) => {
+            if (part.type === "reasoning")
+              return ["group-chainOfThought", "group-reasoning"];
+            if (part.type === "tool-call")
+              return ["group-chainOfThought", "group-tool"];
             return null;
           }}
-        </MessagePrimitive.Parts>
-        <ChainOfThought />
+        >
+          {({ part, children }) => {
+            switch (part.type) {
+              case "group-chainOfThought":
+                return <ChainOfThoughtGroup>{children}</ChainOfThoughtGroup>;
+              case "group-reasoning":
+                return <PartLayout label="Thinking">{children}</PartLayout>;
+              case "group-tool":
+                return (
+                  <PartLayout label="Taking action">{children}</PartLayout>
+                );
+              case "text":
+                return <MarkdownText />;
+              case "reasoning":
+                return <Reasoning {...part} />;
+              case "tool-call":
+                return <ToolCall {...part} />;
+              default:
+                return null;
+            }
+          }}
+        </MessagePrimitive.GroupedParts>
       </div>
     </MessagePrimitive.Root>
   );
 };
 
-/**
- * ChainOfThought component — rendered by MessagePrimitive.Parts when it
- * encounters consecutive reasoning + tool-call parts.
- *
- * Uses ChainOfThoughtPrimitive.Root, AccordionTrigger, and Parts to create
- * a collapsible accordion that groups all "thinking" steps together.
- */
-const ChainOfThought: FC = () => {
+const ChainOfThoughtGroup: FC<PropsWithChildren> = ({ children }) => {
+  const [open, setOpen] = useState(false);
+
   return (
-    <ChainOfThoughtPrimitive.Root className="my-2 rounded-lg border">
-      <ChainOfThoughtPrimitive.AccordionTrigger className="flex w-full cursor-pointer items-center gap-2 px-4 py-2 font-medium text-sm hover:bg-muted/50">
-        <AuiIf condition={(s) => s.chainOfThought.collapsed}>
-          <ChevronRightIcon className="size-4 shrink-0" />
-        </AuiIf>
-        <AuiIf condition={(s) => !s.chainOfThought.collapsed}>
+    <div className="my-2 rounded-lg border">
+      <button
+        type="button"
+        className="flex w-full cursor-pointer items-center gap-2 px-4 py-2 font-medium text-sm hover:bg-muted/50"
+        onClick={() => setOpen((o) => !o)}
+      >
+        {open ? (
           <ChevronDownIcon className="size-4 shrink-0" />
-        </AuiIf>
+        ) : (
+          <ChevronRightIcon className="size-4 shrink-0" />
+        )}
         Thinking
-      </ChainOfThoughtPrimitive.AccordionTrigger>
-      <AuiIf condition={(s) => !s.chainOfThought.collapsed}>
-        <ChainOfThoughtPrimitive.Parts>
-          {({ part }) => {
-            if (part.type === "reasoning")
-              return (
-                <PartLayout>
-                  <Reasoning {...part} />
-                </PartLayout>
-              );
-            return null;
-          }}
-        </ChainOfThoughtPrimitive.Parts>
-      </AuiIf>
-    </ChainOfThoughtPrimitive.Root>
+      </button>
+      {open && children}
+    </div>
   );
 };
 
-const PartLayout: FC<PropsWithChildren> = ({ children }) => {
-  const partType = useAuiState((s) => s.part.type);
+const PartLayout: FC<PropsWithChildren<{ label: string }>> = ({
+  children,
+  label,
+}) => {
   const [open, setOpen] = useState(true);
 
-  const label = partType === "reasoning" ? "Thinking" : "Taking action";
-
   return (
     <div className="border-t">
       <button
@@ -368,7 +415,26 @@ const Reasoning: FC<{ text: string }> = ({ text }) => {
   );
 };
 
+const ToolCall: FC<{ toolName: string; status: { type: string } }> = ({
+  toolName,
+  status,
+}) => {
+  return (
+    <div className="px-4 py-2 text-sm">
+      {status.type === "running"
+        ? `Running ${toolName}...`
+        : status.type === "complete"
+          ? `${toolName} completed`
+          : status.type === "incomplete"
+            ? `${toolName} failed`
+            : `${toolName} requires action`}
+    </div>
+  );
+};
+
 const Composer: FC = () => {
+  const isRunning = useThread((state) => state.isRunning);
+
   return (
     <ComposerPrimitive.Root className="flex w-full flex-col rounded-2xl border border-input bg-background px-1 pt-2 outline-none transition-shadow has-[textarea:focus-visible]:border-ring has-[textarea:focus-visible]:ring-2 has-[textarea:focus-visible]:ring-ring/20">
       <ComposerPrimitive.Input
@@ -378,7 +444,7 @@ const Composer: FC = () => {
         autoFocus
       />
       <div className="relative mx-2 mb-2 flex items-center justify-end">
-        <AuiIf condition={(s) => !s.thread.isRunning}>
+        {!isRunning ? (
           <ComposerPrimitive.Send asChild>
             <TooltipIconButton
               tooltip="Send"
@@ -390,8 +456,7 @@ const Composer: FC = () => {
               <ArrowUpIcon className="size-4" />
             </TooltipIconButton>
           </ComposerPrimitive.Send>
-        </AuiIf>
-        <AuiIf condition={(s) => s.thread.isRunning}>
+        ) : (
           <ComposerPrimitive.Cancel asChild>
             <Button
               type="button"
@@ -402,7 +467,7 @@ const Composer: FC = () => {
               <SquareIcon className="size-3 fill-current" />
             </Button>
           </ComposerPrimitive.Cancel>
-        </AuiIf>
+        )}
       </div>
     </ComposerPrimitive.Root>
   );
@@ -557,29 +622,29 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.53",
+    "@ai-sdk/openai": "^3.0.64",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.168",
+    "ai": "^6.0.188",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.8.0",
-    "next": "^16.2.4",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "tailwind-merge": "^3.5.0",
-    "zod": "^4.3.6"
+    "lucide-react": "^1.16.0",
+    "next": "^16.2.6",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "tailwind-merge": "^3.6.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.4",
-    "@types/node": "^25.6.0",
-    "@types/react": "^19.2.14",
+    "@tailwindcss/postcss": "^4.3.0",
+    "@types/node": "^25.9.1",
+    "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.10",
-    "tailwindcss": "^4.2.4",
+    "postcss": "^8.5.15",
+    "tailwindcss": "^4.3.0",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }
@@ -602,6 +667,7 @@ export default nextConfig;
       "@/lib/utils": ["../../packages/ui/src/lib/utils"],
       "@assistant-ui/ui/*": ["../../packages/ui/src/*"],
       "@assistant-ui/*": ["../../packages/*/src"],
+      "@assistant-ui/core/*": ["../../packages/core/src/*"],
       "@assistant-ui/react/*": ["../../packages/react/src/*"],
       "@assistant-ui/tap/*": ["../../packages/tap/src/*"],
       "assistant-stream": ["../../packages/assistant-stream/src"]

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

@@ -13,7 +13,7 @@ export async function POST(req: Request) {
   const { messages }: { messages: UIMessage[] } = await req.json();
 
   const result = streamText({
-    model: openai("gpt-4o-mini"),
+    model: openai("gpt-5.4-nano"),
     messages: await convertToModelMessages(messages),
   });
 
@@ -568,25 +568,25 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.53",
+    "@ai-sdk/openai": "^3.0.64",
     "@assistant-ui/cloud-ai-sdk": "workspace:*",
-    "ai": "^6.0.168",
+    "ai": "^6.0.188",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.8.0",
-    "next": "^16.2.4",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "tailwind-merge": "^3.5.0"
+    "lucide-react": "^1.16.0",
+    "next": "^16.2.6",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "tailwind-merge": "^3.6.0"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.4",
-    "@types/node": "^25.6.0",
-    "@types/react": "^19.2.14",
+    "@tailwindcss/postcss": "^4.3.0",
+    "@types/node": "^25.9.1",
+    "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.10",
-    "tailwindcss": "^4.2.4",
+    "postcss": "^8.5.15",
+    "tailwindcss": "^4.3.0",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }

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

@@ -13,7 +13,7 @@ export async function POST(req: Request) {
   const { messages, system, tools } = await req.json();
 
   const result = streamText({
-    model: openai("gpt-4o"),
+    model: openai("gpt-5.4-nano"),
     messages: await convertToModelMessages(messages),
     // forward system prompt and tools from the frontend
     system,
@@ -327,28 +327,28 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.53",
+    "@ai-sdk/openai": "^3.0.64",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.168",
+    "ai": "^6.0.188",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.8.0",
-    "next": "^16.2.4",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "tailwind-merge": "^3.5.0"
+    "lucide-react": "^1.16.0",
+    "next": "^16.2.6",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "tailwind-merge": "^3.6.0"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.4",
-    "@types/node": "^25.6.0",
-    "@types/react": "^19.2.14",
+    "@tailwindcss/postcss": "^4.3.0",
+    "@types/node": "^25.9.1",
+    "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.10",
-    "tailwindcss": "^4.2.4",
+    "postcss": "^8.5.15",
+    "tailwindcss": "^4.3.0",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }

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

@@ -21,7 +21,7 @@ export async function POST(req: Request) {
   const { messages }: { messages: UIMessage[] } = await req.json();
 
   const result = streamText({
-    model: openai("gpt-4o"),
+    model: openai("gpt-5.4-nano"),
     messages: await convertToModelMessages(messages),
     stopWhen: stepCountIs(10),
     tools: {
@@ -215,7 +215,8 @@ import {
 import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 import { createAssistantStream } from "assistant-stream";
 
-// In-memory storage for threads (simulating a database)
+const PAGE_SIZE = 10;
+
 const threadsStore = new Map<
   string,
   {
@@ -223,16 +224,33 @@ const threadsStore = new Map<
     status: "regular" | "archived";
     title?: string;
   }
->();
+>(
+  Array.from({ length: 25 }, (_, i) => {
+    const id = `seed-${String(i).padStart(2, "0")}`;
+    return [
+      id,
+      {
+        remoteId: id,
+        status: "regular" as const,
+        title: `Seeded thread ${i + 1}`,
+      },
+    ] as const;
+  }),
+);
 
 const threadListAdapter: RemoteThreadListAdapter = {
-  async list() {
+  async list({ after }: { after?: string } = {}) {
+    const all = Array.from(threadsStore.values());
+    const start = after ? Number(after) : 0;
+    const page = all.slice(start, start + PAGE_SIZE);
+    const nextStart = start + page.length;
     return {
-      threads: Array.from(threadsStore.values()).map((thread) => ({
+      threads: page.map((thread) => ({
         remoteId: thread.remoteId,
         status: thread.status,
         title: thread.title,
       })),
+      nextCursor: nextStart < all.length ? String(nextStart) : undefined,
     };
   },
 
@@ -323,8 +341,35 @@ export function MyRuntimeProvider({
 "use client";
 
 import { Thread } from "@/components/assistant-ui/thread";
-import { ThreadList } from "@/components/assistant-ui/thread-list";
-import { useAui, AuiProvider, Suggestions } from "@assistant-ui/react";
+import {
+  AuiProvider,
+  Suggestions,
+  ThreadListItemPrimitive,
+  ThreadListPrimitive,
+  useAui,
+} from "@assistant-ui/react";
+
+function ThreadList() {
+  return (
+    <ThreadListPrimitive.Root className="flex flex-col gap-1 overflow-y-auto">
+      <ThreadListPrimitive.New className="flex h-9 items-center gap-2 rounded-lg border px-3 text-sm hover:bg-muted">
+        New Thread
+      </ThreadListPrimitive.New>
+      <ThreadListPrimitive.Items>
+        {() => (
+          <ThreadListItemPrimitive.Root className="flex h-9 items-center rounded-lg hover:bg-muted data-active:bg-muted">
+            <ThreadListItemPrimitive.Trigger className="flex-1 truncate px-3 text-start text-sm">
+              <ThreadListItemPrimitive.Title fallback="New Chat" />
+            </ThreadListItemPrimitive.Trigger>
+          </ThreadListItemPrimitive.Root>
+        )}
+      </ThreadListPrimitive.Items>
+      <ThreadListPrimitive.LoadMore className="mt-1 h-9 rounded-lg border px-3 text-sm hover:bg-muted disabled:opacity-50">
+        Load more
+      </ThreadListPrimitive.LoadMore>
+    </ThreadListPrimitive.Root>
+  );
+}
 
 function ThreadWithSuggestions() {
   const aui = useAui({
@@ -414,30 +459,30 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.53",
+    "@ai-sdk/openai": "^3.0.64",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.168",
+    "ai": "^6.0.188",
     "assistant-stream": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.8.0",
-    "next": "^16.2.4",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "tailwind-merge": "^3.5.0",
-    "zod": "^4.3.6"
+    "lucide-react": "^1.16.0",
+    "next": "^16.2.6",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "tailwind-merge": "^3.6.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.4",
-    "@types/node": "^25.6.0",
-    "@types/react": "^19.2.14",
+    "@tailwindcss/postcss": "^4.3.0",
+    "@types/node": "^25.9.1",
+    "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.10",
-    "tailwindcss": "^4.2.4",
+    "postcss": "^8.5.15",
+    "tailwindcss": "^4.3.0",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }

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

@@ -17,7 +17,7 @@ export async function POST(req: Request) {
   const { messages }: { messages: UIMessage[] } = await req.json();
 
   const result = streamText({
-    model: openai("gpt-4o"),
+    model: openai("gpt-5.4-nano"),
     messages: await convertToModelMessages(messages),
     stopWhen: stepCountIs(10),
   });
@@ -438,31 +438,31 @@ export default nextConfig;
   "version": "0.0.0",
   "type": "module",
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.53",
-    "@ai-sdk/react": "^3.0.170",
+    "@ai-sdk/openai": "^3.0.64",
+    "@ai-sdk/react": "^3.0.190",
     "@assistant-ui/react": "workspace:^",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:^",
     "@assistant-ui/ui": "workspace:*",
-    "@elevenlabs/client": "^1.2.1",
-    "@tailwindcss/postcss": "^4.2.4",
-    "ai": "^6.0.168",
+    "@elevenlabs/client": "^1.8.0",
+    "@tailwindcss/postcss": "^4.3.0",
+    "ai": "^6.0.188",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.8.0",
-    "motion": "^12.38.0",
-    "next": "^16.2.4",
-    "postcss": "^8.5.10",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "tailwind-merge": "^3.5.0",
-    "tailwindcss": "^4.2.4",
-    "zod": "^4.3.6"
+    "lucide-react": "^1.16.0",
+    "motion": "^12.39.0",
+    "next": "^16.2.6",
+    "postcss": "^8.5.15",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "tailwind-merge": "^3.6.0",
+    "tailwindcss": "^4.3.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@types/node": "^25.6.0",
-    "@types/react": "^19.2.14",
+    "@types/node": "^25.9.1",
+    "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
@@ -502,6 +502,7 @@ export default nextConfig;
       "@/lib/utils": ["../../packages/ui/src/lib/utils"],
       "@assistant-ui/ui/*": ["../../packages/ui/src/*"],
       "@assistant-ui/*": ["../../packages/*/src"],
+      "@assistant-ui/core/*": ["../../packages/core/src/*"],
       "@assistant-ui/react/*": ["../../packages/react/src/*"],
       "@assistant-ui/tap/*": ["../../packages/tap/src/*"],
       "assistant-stream": ["../../packages/assistant-stream/src"],