@assistant-ui/mcp-docs-server 0.1.29 → 0.1.31

package/.docs/organized/code-examples/waterfall.md

@@ -417,6 +417,7 @@ export function WaterfallRow() {
         <AuiIf condition={(s) => s.span.hasChildren}>
           <SpanPrimitive.CollapseToggle className="flex shrink-0 items-center justify-center rounded p-0.5 text-muted-foreground hover:text-foreground">
             <svg
+              aria-hidden="true"
               className="size-3.5 transition-transform data-[collapsed=true]:[-rotate-90]"
               viewBox="0 0 16 16"
               fill="currentColor"
@@ -438,7 +439,7 @@ export function WaterfallRow() {
         className="group-hover:bg-accent/30"
         style={{ width: barWidth, height: barHeight }}
       >
-        <svg width={barWidth} height={barHeight}>
+        <svg aria-hidden="true" width={barWidth} height={barHeight}>
           <WaterfallBar />
         </svg>
       </div>
@@ -515,7 +516,12 @@ function TimeAxisTicks({
   });
 
   return (
-    <svg width={barWidth} height={28} className="overflow-visible">
+    <svg
+      aria-hidden="true"
+      width={barWidth}
+      height={28}
+      className="overflow-visible"
+    >
       {ticks.map(({ t, x }) => (
         <g key={x}>
           <line
@@ -678,6 +684,8 @@ export function WaterfallTimeline() {
 
         {/* Span rows */}
         <WaterfallLayoutContext.Provider value={layoutValue}>
+          {/* biome-ignore lint/a11y/useKeyWithClickEvents: event delegation on span rows */}
+          {/* biome-ignore lint/a11y/noStaticElementInteractions: event delegation on span rows */}
           <div
             style={{ width: contentWidth }}
             onClick={(e) => {
@@ -769,19 +777,19 @@ export default nextConfig;
     "@assistant-ui/react-o11y": "workspace:*",
     "@assistant-ui/store": "workspace:*",
     "@assistant-ui/tap": "workspace:*",
-    "next": "^16.2.3",
+    "next": "^16.2.4",
     "react": "^19.2.5",
     "react-dom": "^19.2.5"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.2",
+    "@tailwindcss/postcss": "^4.2.4",
     "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.9",
-    "tailwindcss": "^4.2.2",
-    "typescript": "^6.0.2"
+    "postcss": "^8.5.14",
+    "tailwindcss": "^4.2.4",
+    "typescript": "^6.0.3"
   }
 }
 

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

@@ -170,7 +170,7 @@ export function MyRuntimeProvider({
   children,
 }: Readonly<{ children: ReactNode }>) {
   const serverUrl =
-    (process.env["NEXT_PUBLIC_A2A_SERVER_URL"] as string | undefined) ??
+    (process.env.NEXT_PUBLIC_A2A_SERVER_URL as string | undefined) ??
     "http://localhost:9999";
 
   const runtime = useA2ARuntime({
@@ -201,8 +201,6 @@ import {
 } from "@assistant-ui/react-a2a";
 import { Thread } from "@/components/assistant-ui/thread";
 
-// === State Badge ===
-
 const STATE_CONFIG: Record<
   string,
   { label: string; color: string; bg: string }
@@ -274,8 +272,6 @@ function StateBadge({ state }: { state: A2ATaskState }) {
   );
 }
 
-// === Task Status Bar ===
-
 function TaskStatusBar() {
   const task = useA2ATask();
 
@@ -296,8 +292,6 @@ function TaskStatusBar() {
   );
 }
 
-// === Artifact Part Renderer ===
-
 function ArtifactPartView({ part }: { part: A2APart }) {
   if (part.text !== undefined) {
     return (
@@ -322,6 +316,7 @@ function ArtifactPartView({ part }: { part: A2APart }) {
     const isImage = part.mediaType?.startsWith("image/");
     if (isImage) {
       return (
+        // biome-ignore lint/performance/noImgElement: example component
         <img
           src={part.url}
           alt={part.filename ?? "image"}
@@ -350,6 +345,7 @@ function ArtifactPartView({ part }: { part: A2APart }) {
     const isImage = part.mediaType?.startsWith("image/");
     if (isImage) {
       return (
+        // biome-ignore lint/performance/noImgElement: example component
         <img
           src={`data:${part.mediaType};base64,${part.raw}`}
           alt={part.filename ?? "image"}
@@ -377,8 +373,6 @@ function ArtifactPartView({ part }: { part: A2APart }) {
   return null;
 }
 
-// === Artifact Panel ===
-
 function ArtifactPanel() {
   const artifacts = useA2AArtifacts();
 
@@ -417,8 +411,6 @@ function ArtifactPanel() {
   );
 }
 
-// === Agent Card Banner ===
-
 function AgentCardBanner() {
   const card = useA2AAgentCard();
 
@@ -449,8 +441,6 @@ function AgentCardBanner() {
   );
 }
 
-// === Thread with Suggestions ===
-
 function ThreadWithSuggestions() {
   const aui = useAui({
     suggestions: Suggestions([
@@ -488,8 +478,6 @@ function ThreadWithSuggestions() {
   );
 }
 
-// === Main ===
-
 export default function Home() {
   return (
     <main className="flex h-dvh flex-col">
@@ -568,22 +556,22 @@ export default nextConfig;
     "@assistant-ui/ui": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.8.0",
-    "next": "^16.2.3",
+    "lucide-react": "^1.14.0",
+    "next": "^16.2.4",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.2",
+    "@tailwindcss/postcss": "^4.2.4",
     "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.9",
-    "tailwindcss": "^4.2.2",
+    "postcss": "^8.5.14",
+    "tailwindcss": "^4.2.4",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.3"
   }
 }
 

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

@@ -141,6 +141,8 @@ export const metadata: Metadata = {
   description: "Generated by create next app",
 };
 
+export const dynamic = "force-dynamic";
+
 export default function RootLayout({
   children,
 }: Readonly<{
@@ -182,7 +184,7 @@ export function MyRuntimeProvider({
   children,
 }: Readonly<{ children: ReactNode }>) {
   const agentUrl =
-    (process.env["NEXT_PUBLIC_AGUI_AGENT_URL"] as string | undefined) ??
+    (process.env.NEXT_PUBLIC_AGUI_AGENT_URL as string | undefined) ??
     "http://localhost:8000/agent";
 
   // Simple in-memory thread storage
@@ -313,6 +315,7 @@ function NewThreadButton() {
 
   return (
     <button
+      type="button"
       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"
     >
@@ -413,29 +416,29 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ag-ui/client": "^0.0.52",
+    "@ag-ui/client": "^0.0.53",
     "@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": "^1.8.0",
-    "next": "^16.2.3",
+    "lucide-react": "^1.14.0",
+    "next": "^16.2.4",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.2",
+    "@tailwindcss/postcss": "^4.2.4",
     "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.9",
-    "tailwindcss": "^4.2.2",
+    "postcss": "^8.5.14",
+    "tailwindcss": "^4.2.4",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.3"
   }
 }
 

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

@@ -6,7 +6,7 @@
 import { openai } from "@ai-sdk/openai";
 import { frontendTools } from "@assistant-ui/react-ai-sdk";
 import {
-  JSONSchema7,
+  type JSONSchema7,
   streamText,
   convertToModelMessages,
   type UIMessage,
@@ -315,31 +315,31 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.52",
+    "@ai-sdk/openai": "^3.0.61",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.159",
+    "ai": "^6.0.175",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.8.0",
-    "next": "^16.2.3",
+    "lucide-react": "^1.14.0",
+    "next": "^16.2.4",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "tailwind-merge": "^3.5.0",
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.2",
+    "@tailwindcss/postcss": "^4.2.4",
     "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.9",
-    "tailwindcss": "^4.2.2",
+    "postcss": "^8.5.14",
+    "tailwindcss": "^4.2.4",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.3"
   }
 }
 

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

@@ -258,7 +258,7 @@ function ArtifactsView() {
       .at(-1);
   });
 
-  const code = lastToolCall?.args["code"] as string | undefined;
+  const code = lastToolCall?.args.code as string | undefined;
   const isComplete = lastToolCall?.result !== undefined;
 
   if (!code) return null;
@@ -268,6 +268,7 @@ function ArtifactsView() {
       <div className="flex h-full w-full flex-col overflow-hidden rounded-lg border">
         <div className="flex border-b">
           <button
+            type="button"
             onClick={() => setTab("source")}
             className={`inline-flex flex-1 items-center justify-center gap-2 px-4 py-2.5 font-medium text-sm transition-colors ${
               tab === "source"
@@ -279,6 +280,7 @@ function ArtifactsView() {
             Source Code
           </button>
           <button
+            type="button"
             onClick={() => isComplete && setTab("preview")}
             disabled={!isComplete}
             className={`inline-flex flex-1 items-center justify-center gap-2 px-4 py-2.5 font-medium text-sm transition-colors ${
@@ -413,31 +415,31 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.52",
+    "@ai-sdk/openai": "^3.0.61",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.159",
+    "ai": "^6.0.175",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.8.0",
-    "next": "^16.2.3",
+    "lucide-react": "^1.14.0",
+    "next": "^16.2.4",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "tailwind-merge": "^3.5.0",
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.2",
+    "@tailwindcss/postcss": "^4.2.4",
     "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.9",
-    "tailwindcss": "^4.2.2",
+    "postcss": "^8.5.14",
+    "tailwindcss": "^4.2.4",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.3"
   }
 }
 

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

@@ -170,16 +170,16 @@ export default function RootLayout({
 
 import {
   AssistantRuntimeProvider,
-  AssistantTransportConnectionMetadata,
+  type AssistantTransportConnectionMetadata,
   makeAssistantTool,
   unstable_createMessageConverter as createMessageConverter,
   useAssistantTransportRuntime,
 } from "@assistant-ui/react";
 import {
   convertLangChainMessages,
-  LangChainMessage,
+  type LangChainMessage,
 } from "@assistant-ui/react-langgraph";
-import { ReactNode } from "react";
+import type { ReactNode } from "react";
 import { z } from "zod";
 
 // Frontend tool with execute function
@@ -274,8 +274,7 @@ export function MyRuntimeProvider({ children }: MyRuntimeProviderProps) {
     initialState: {
       messages: [],
     },
-    api:
-      process.env["NEXT_PUBLIC_API_URL"] || "http://localhost:8010/assistant",
+    api: process.env.NEXT_PUBLIC_API_URL || "http://localhost:8010/assistant",
     converter,
     headers: async () => ({
       "Test-Header": "test-value",
@@ -423,23 +422,23 @@ export default nextConfig;
     "@assistant-ui/ui": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.8.0",
-    "next": "^16.2.3",
+    "lucide-react": "^1.14.0",
+    "next": "^16.2.4",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "tailwind-merge": "^3.5.0",
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.2",
+    "@tailwindcss/postcss": "^4.2.4",
     "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.9",
-    "tailwindcss": "^4.2.2",
+    "postcss": "^8.5.14",
+    "tailwindcss": "^4.2.4",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.3"
   }
 }
 

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({
@@ -216,11 +222,9 @@ import { TooltipIconButton } from "@/components/assistant-ui/tooltip-icon-button
 import { Button } from "@/components/ui/button";
 import {
   AuiIf,
-  ChainOfThoughtPrimitive,
   ComposerPrimitive,
   MessagePrimitive,
   ThreadPrimitive,
-  useAuiState,
 } from "@assistant-ui/react";
 import {
   ArrowDownIcon,
@@ -286,61 +290,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,6 +380,23 @@ 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 = () => {
   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">
@@ -557,31 +586,31 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.52",
+    "@ai-sdk/openai": "^3.0.61",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.159",
+    "ai": "^6.0.175",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.8.0",
-    "next": "^16.2.3",
+    "lucide-react": "^1.14.0",
+    "next": "^16.2.4",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "tailwind-merge": "^3.5.0",
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.2.2",
+    "@tailwindcss/postcss": "^4.2.4",
     "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.9",
-    "tailwindcss": "^4.2.2",
+    "postcss": "^8.5.14",
+    "tailwindcss": "^4.2.4",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.3"
   }
 }