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

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

@@ -4,7 +4,7 @@
 
 ```typescript
 import { openai } from "@ai-sdk/openai";
-import { frontendTools } from "@assistant-ui/react-ai-sdk";
+import { frontendTools } from "@assistant-ui/react-ai-sdk-v4";
 import { streamText } from "ai";
 
 export const runtime = "edge";
@@ -189,7 +189,7 @@ export default function RootLayout({
 "use client";
 
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk-v4";
 
 export function MyRuntimeProvider({
   children,
@@ -753,7 +753,7 @@ const UserMessage: FC = () => {
       <UserActionBar />
 
       <div className="bg-muted text-foreground col-start-2 row-start-2 max-w-[calc(var(--thread-max-width)*0.8)] break-words rounded-3xl px-5 py-2.5">
-        <MessagePrimitive.Content />
+        <MessagePrimitive.Parts />
       </div>
 
       <BranchPicker className="col-span-full col-start-1 row-start-3 -mr-1 justify-end" />
@@ -798,7 +798,7 @@ const AssistantMessage: FC = () => {
   return (
     <MessagePrimitive.Root className="relative grid w-full max-w-[var(--thread-max-width)] grid-cols-[auto_auto_1fr] grid-rows-[auto_1fr] py-4">
       <div className="text-foreground col-span-2 col-start-2 row-start-1 my-1.5 max-w-[calc(var(--thread-max-width)*0.8)] break-words leading-7">
-        <MessagePrimitive.Content components={{ Text: MarkdownText }} />
+        <MessagePrimitive.Parts components={{ Text: MarkdownText }} />
       </div>
 
       <AssistantActionBar />
@@ -1654,7 +1654,7 @@ export default nextConfig;
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-hook-form": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
-    "@hookform/resolvers": "^5.1.1",
+    "@hookform/resolvers": "^5.2.1",
     "@radix-ui/react-avatar": "^1.1.10",
     "@radix-ui/react-icons": "^1.3.2",
     "@radix-ui/react-label": "^2.1.7",
@@ -1666,18 +1666,18 @@ export default nextConfig;
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "json-schema-to-zod": "^2.6.1",
-    "lucide-react": "^0.515.0",
-    "next": "15.3.3",
-    "react": "19.1.0",
-    "react-dom": "19.1.0",
-    "react-hook-form": "^7.58.0",
-    "react-resizable-panels": "^3.0.3",
+    "lucide-react": "^0.535.0",
+    "next": "15.4.5",
+    "react": "19.1.1",
+    "react-dom": "19.1.1",
+    "react-hook-form": "^7.61.1",
+    "react-resizable-panels": "^3.0.4",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.3.1",
-    "tw-animate-css": "^1.3.4",
-    "zod": "^3.25.64",
-    "zod-to-json-schema": "^3.24.5",
-    "zustand": "^5.0.5"
+    "tw-animate-css": "^1.3.6",
+    "zod": "^4.0.14",
+    "zod-to-json-schema": "^3.24.6",
+    "zustand": "^5.0.7"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
@@ -1685,10 +1685,10 @@ export default nextConfig;
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-config-next": "15.3.3",
+    "eslint-config-next": "15.4.5",
     "postcss": "^8",
-    "tailwindcss": "^4.1.10",
-    "typescript": "^5.8.3"
+    "tailwindcss": "^4.1.11",
+    "typescript": "^5.9.2"
   }
 }
 

package/.docs/raw/docs/about-assistantui.mdx

@@ -41,4 +41,13 @@ assistant-ui helps you create beautiful, enterprise-grade AI chat interfaces in
   [Get Started in 30 Seconds](/docs/getting-started).
 </Callout>
 
+## AI Accessible Documentation
+
+Our docs are easily accessible to AI assistants through several methods:
+
+- **[MCP Docs Server](/docs/mcp-docs-server)** - Direct MCP integration for IDEs and agents
+- **`/llms.txt`** - Structured index of all documentation pages
+- **`/llms-full.txt`** - Complete documentation in a single file
+- **`.mdx` suffix** - Add `.mdx` to any page's URL for raw markdown content
+
 

package/.docs/raw/docs/api-reference/context-providers/{TextContentPartProvider.mdx → TextMessagePartProvider.mdx}

@@ -1,11 +1,11 @@
 ---
-title: <TextContentPartProvider />
+title: <TextMessagePartProvider />
 ---
 
 import { ParametersTable } from "@/components/docs";
 import { AssistantRuntimeProvider } from "@/generated/typeDocs";
 
-The `TextContentPartProvider` provides data and APIs for `TextContentPart` components.
+The `TextMessagePartProvider` provides data and APIs for `TextMessagePart` components.
 
 This is useful if you want to reuse the same `Text` component outside of a message text, e.g. with the `@assistant-ui/react-markdown` package.
 
@@ -14,7 +14,7 @@ import { AssistantRuntimeProvider } from "@assistant-ui/react";
 
 const MyApp = () => {
   return (
-    <TextContentPartProvider text={"Hello!"}>
+    <TextMessagePartProvider text={"Hello!"}>
       <MyMarkdownText />
     </AssistantRuntimeProvider>
   );

package/.docs/raw/docs/api-reference/integrations/react-hook-form.mdx

@@ -51,7 +51,7 @@ Drop-in replacement hook for `useForm` that adds support for `@assistant-ui/reac
                           parameters: [
                             {
                               name: "render",
-                              type: "ToolCallContentPartComponent<{ name: string; value: string; }, {}>",
+                              type: "ToolCallMessagePartComponent<{ name: string; value: string; }, {}>",
                               description:
                                 "The component to render when set_form_field is called.",
                             },
@@ -68,7 +68,7 @@ Drop-in replacement hook for `useForm` that adds support for `@assistant-ui/reac
                           parameters: [
                             {
                               name: "render",
-                              type: "ToolCallContentPartComponent<{}, {}>",
+                              type: "ToolCallMessagePartComponent<{}, {}>",
                               description:
                                 "The component to render when submit_form is called.",
                             },

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

@@ -11,7 +11,7 @@ export const contextColors = {
   "Thread Context": "#45a049",
   "Composer Context": "#ff9933",
   "Message Context": "#bb2244",
-  "ContentPart Context": "#268bd2",
+  "MessagePart Context": "#268bd2",
   "Attachment Context": "#FFB6C1",
   "ThreadListItem Context": "#c678dd",
 };
@@ -93,20 +93,20 @@ export const contextColors = {
 </Component>
 
 <Component
-  name="TextContentPartProvider"
+  name="TextMessagePartProvider"
   isContextProvider={true}
   providedContexts={[
     {
-      name: "Text ContentPart Context",
-      color: contextColors["ContentPart Context"],
-      link: "#contentpart-context",
+      name: "Text MessagePart Context",
+      color: contextColors["MessagePart Context"],
+      link: "#MessagePart-context",
     },
   ]}
-  docsLink="./context-providers/TextContentPartProvider"
-  tooltip="Provides context for text content parts"
+  docsLink="./context-providers/TextMessagePartProvider"
+  tooltip="Provides context for text message parts"
   props="text={text}"
 >
-  <Component name="ContentPart" isLink={true} />
+  <Component name="MessagePart" isLink={true} />
 </Component>
 
 <ContextLevel color={contextColors["Assistant Context"]}>
@@ -356,16 +356,16 @@ Manages the state and actions for individual messages
   tooltip="Root component for a message"
 >
   <Component
-    name="MessagePrimitive.Content"
+    name="MessagePrimitive.Parts"
     isContextProvider={true}
     providedContexts={[
       {
-        name: "ContentPart Context",
-        color: contextColors["ContentPart Context"],
+        name: "MessagePart Context",
+        color: contextColors["MessagePart Context"],
       },
     ]}
-    docsLink="#message-primitive-content"
-    tooltip="Displays the content of the message"
+    docsLink="#message-primitive-parts"
+    tooltip="Displays the parts of the message"
   />
   <Component
     name="MessagePrimitive.Attachments"
@@ -456,23 +456,23 @@ Manages the state and actions for individual messages
 
 </ContextLevel>
 
-<ContextLevel color={contextColors["ContentPart Context"]}>
+<ContextLevel color={contextColors["MessagePart Context"]}>
 
-## ContentPart Context
+## MessagePart Context
 
-Manages the state and actions for content parts within messages
+Manages the state and actions for message parts within messages
 
-### ContentPartRuntime
+### MessagePartRuntime
 
-- [`useContentPart`](#use-content-part)
-- [`useContentPartText`](#use-content-part-text)
-- [`useContentPartReasoning`](#use-content-part-reasoning)
-- [`useContentPartRuntime`](#use-content-part-runtime)
+- [`useMessagePart`](#use-content-part)
+- [`useMessagePartText`](#use-content-part-text)
+- [`useMessagePartReasoning`](#use-content-part-reasoning)
+- [`useMessagePartRuntime`](#use-content-part-runtime)
 
-### ContentPartPrimitive
+### MessagePartPrimitive
 
 <Component
-  name="ContentPartPrimitive.Text"
+  name="MessagePartPrimitive.Text"
   docsLink="#content-part-text"
   tooltip="Represents a text part of the message content"
 />

package/.docs/raw/docs/api-reference/primitives/Error.mdx

@@ -30,7 +30,8 @@ Contains all parts of the error display. Renders a `<div>` element with `role="a
     {
       name: "asChild",
       type: "boolean",
-      description: "Change the component to the HTML tag or custom component of the only child.",
+      description:
+        "Change the component to the HTML tag or custom component of the only child.",
     },
   ]}
 />
@@ -45,7 +46,8 @@ Displays the error message. By default, it shows the error from the message cont
     {
       name: "children",
       type: "ReactNode",
-      description: "Optional custom content to display instead of the default error message.",
+      description:
+        "Optional custom content to display instead of the default error message.",
     },
   ]}
 />
@@ -59,7 +61,7 @@ import { MessagePrimitive, ErrorPrimitive } from "@assistant-ui/react";
 
 const MessageWithError = () => (
   <MessagePrimitive.Root>
-    <MessagePrimitive.Content />
+    <MessagePrimitive.Parts />
     <MessagePrimitive.Error>
       <ErrorPrimitive.Root>
         <ErrorPrimitive.Message />

package/.docs/raw/docs/api-reference/primitives/Message.mdx

@@ -115,6 +115,38 @@ The content of the message. This renders a separate component for each content p
                 },
               ],
             },
+            {
+              name: "ToolGroup",
+              type: "ComponentType<PropsWithChildren<{ startIndex: number; endIndex: number }>>",
+              description:
+                "Component for rendering grouped consecutive tool calls. When provided, consecutive tool-call content parts will be automatically grouped and wrapped with this component.",
+              children: [
+                {
+                  type: "ToolGroupProps",
+                  parameters: [
+                    {
+                      name: "startIndex",
+                      type: "number",
+                      description: "Index of the first tool call in the group.",
+                      required: true,
+                    },
+                    {
+                      name: "endIndex",
+                      type: "number",
+                      description: "Index of the last tool call in the group.",
+                      required: true,
+                    },
+                    {
+                      name: "children",
+                      type: "ReactNode",
+                      description:
+                        "The rendered tool call components within the group.",
+                      required: true,
+                    },
+                  ],
+                },
+              ],
+            },
           ],
         },
       ],

package/.docs/raw/docs/api-reference/primitives/{ContentPart.mdx → MessagePart.mdx}

@@ -1,20 +1,20 @@
 ---
-title: ContentPartPrimitive
-description: A part of a message's content. Content parts may be text, image, tool call or UI elements.
+title: MessagePartPrimitive
+description: A part of a message's content. Message parts may be text, image, tool call or UI elements.
 ---
 
 import { ParametersTable } from "@/components/docs";
 import {
-  ContentPartRuntime,
-  TextContentPartState,
-  AudioContentPartState,
-  ToolCallContentPartState,
+  MessagePartRuntime,
+  TextMessagePartState,
+  AudioMessagePartState,
+  ToolCallMessagePartState,
 } from "@/generated/typeDocs";
 
-Each message can have any number of content parts.  
-Content parts are usually one of text, reasoning, audio or tool-call.
+Each message can have any number of message parts.  
+Message parts are usually one of text, reasoning, audio or tool-call.
 
-## Content Part Types
+## Message part Types
 
 ### Text
 
@@ -35,10 +35,10 @@ Interactive elements that represent tool operations.
 ## Anatomy
 
 ```tsx
-import { ContentPartPrimitive } from "@assistant-ui/react";
+import { MessagePartPrimitive } from "@assistant-ui/react";
 
-const TextContentPart = () => {
-  return <ContentPartPrimitive.Text />;
+const TextMessagePart = () => {
+  return <MessagePartPrimitive.Text />;
 };
 ```
 
@@ -47,9 +47,9 @@ const TextContentPart = () => {
 ### Plain Text
 
 ```tsx
-import { ContentPartPrimitive } from "@assistant/react";
+import { MessagePartPrimitive } from "@assistant/react";
 
-<ContentPartPrimitive.Text />;
+<MessagePartPrimitive.Text />;
 ```
 
 ### Markdown Text
@@ -68,14 +68,14 @@ Coming soon.
 
 ### InProgress
 
-Renders children only if the content part is in progress.
+Renders children only if the message part is in progress.
 
 ```tsx
-import { ContentPartPrimitive } from "@assistant/react";
+import { MessagePartPrimitive } from "@assistant/react";
 
-<ContentPartPrimitive.InProgress>
+<MessagePartPrimitive.InProgress>
   <LoadingIndicator />
-</ContentPartPrimitive.InProgress>;
+</MessagePartPrimitive.InProgress>;
 ```
 
 ### Tool UI
@@ -104,14 +104,14 @@ const MyWeatherToolUI = makeAssistantToolUI({
 
 ## Context Provider
 
-Content part context is provided by `MessagePrimitive.Content` or `TextContentPartProvider`
+Message part context is provided by `MessagePrimitive.Parts` or `TextMessagePartProvider`
 
-### MessagePrimitive.Content
+### MessagePrimitive.Parts
 
 ```tsx
 import { MessagePrimitive } from "@assistant/react";
 
-<MessagePrimitive.Content
+<MessagePrimitive.Parts
   components={{
     Text: MyText,
     Reasoning: MyReasoning,
@@ -126,48 +126,48 @@ import { MessagePrimitive } from "@assistant/react";
 />;
 ```
 
-### TextContentPartProvider
+### TextMessagePartProvider
 
-This is a helper context provider to allow you to reuse the content part components outside a message content part.
+This is a helper context provider to allow you to reuse the message part components outside a message message part.
 
 ```tsx
-import { TextContentPartProvider } from "@assistant-ui/react";
+import { TextMessagePartProvider } from "@assistant-ui/react";
 
-<TextContentPartProvider text="Hello world" isRunning={false}>
-  <ContentPart.Text />
-</TextContentPartProvider>;
+<TextMessagePartProvider text="Hello world" isRunning={false}>
+  <MessagePart.Text />
+</TextMessagePartProvider>;
 ```
 
 ## Runtime API
 
-### `useContentPartRuntime`
+### `useMessagePartRuntime`
 
 ```tsx
-import { useContentPartRuntime } from "@assistant-ui/react";
+import { useMessagePartRuntime } from "@assistant-ui/react";
 
-const contentPartRuntime = useContentPartRuntime();
+const MessagePartRuntime = useMessagePartRuntime();
 ```
 
-<ParametersTable {...ContentPartRuntime} />
+<ParametersTable {...MessagePartRuntime} />
 
-### `useContentPart`
+### `useMessagePart`
 
 ```tsx
-import { useContentPart } from "@assistant-ui/react";
+import { useMessagePart } from "@assistant-ui/react";
 
-const contentPart = useContentPart();
+const MessagePart = useMessagePart();
 ```
 
-<ParametersTable {...TextContentPartState} />
-<ParametersTable {...AudioContentPartState} />
-<ParametersTable {...ToolCallContentPartState} />
+<ParametersTable {...TextMessagePartState} />
+<ParametersTable {...AudioMessagePartState} />
+<ParametersTable {...ToolCallMessagePartState} />
 
-### `useContentPartText`
+### `useMessagePartText`
 
 ```tsx
-import { useContentPartText } from "@assistant-ui/react";
+import { useMessagePartText } from "@assistant-ui/react";
 
-const contentPartText = useContentPartText();
+const MessagePartText = useMessagePartText();
 ```
 
-<ParametersTable {...TextContentPartState} />
+<ParametersTable {...TextMessagePartState} />

package/.docs/raw/docs/api-reference/runtimes/MessagePartRuntime.mdx

@@ -0,0 +1,22 @@
+---
+title: MessagePartRuntime
+---
+
+import { ParametersTable } from "@/components/docs";
+import { MessagePartState } from "@/components/docs/parameters/context";
+
+### `useMessagePart`
+
+Access the message part state:
+
+```tsx
+import { useMessagePart } from "@assistant-ui/react";
+
+const part = useMessagePart();
+const partState = useMessagePart.getState();
+
+const status = useMessagePart((m) => m.status);
+const statusAgain = useMessagePart.getState().status;
+```
+
+<ParametersTable {...MessagePartState} />

package/.docs/raw/docs/api-reference/runtimes/ThreadListRuntime.mdx

@@ -26,6 +26,7 @@ import { useThreadList } from "@assistant-ui/react";
 
 const threadList = useThreadList();
 const threads = useThreadList((m) => m.threads);
+const isLoading = useThreadList((m) => m.isLoading);
 ```
 
 <ParametersTable {...ThreadListState} />

package/.docs/raw/docs/api-reference/runtimes/ThreadRuntime.mdx

@@ -30,6 +30,7 @@ import { useThread } from "@assistant-ui/react";
 
 const thread = useThread();
 const isRunning = useThread((m) => m.isRunning);
+const isLoading = useThread((m) => m.isLoading);
 ```
 
 <ParametersTable {...ThreadState} />

package/.docs/raw/docs/cloud/persistence/ai-sdk.mdx

@@ -2,53 +2,110 @@
 title: Chat History for AI SDK
 ---
 
+import { Steps, Step } from 'fumadocs-ui/components/steps';
+import { Callout } from 'fumadocs-ui/components/callout';
+
 ## Overview
 
-With the help of assistant-cloud, you can add thread management and thread history capabilities to assistant-ui. This guide will walk you through the process of integrating assistant-cloud with the AI SDK by Vercel.
+assistant-cloud provides thread management and persistent chat history for applications built with the [AI SDK by Vercel](https://sdk.vercel.ai/). This guide shows you how to integrate cloud persistence into your AI SDK application.
+
+## Prerequisites
+
+<Callout type="info">
+  You need an assistant-cloud account to follow this guide. [Sign up here](https://cloud.assistant-ui.com/) to get started.
+</Callout>
+
+## Setup Guide
+
+<Steps>
+
+<Step>
+
+### Create a Cloud Project
+
+Create a new project in the [assistant-cloud dashboard](https://cloud.assistant-ui.com/) and from the settings page, copy:
+
+- **Frontend API URL**: `https://proj-[ID].assistant-api.com`
+- **Assistant Cloud API Key**: `sk_aui_proj_*`
+
+</Step>
+
+<Step>
+
+### Configure Environment Variables
+
+Add the following environment variables to your project:
 
-### Prerequisites
+```bash title=".env.local"
+# Frontend API URL from your cloud project settings
+NEXT_PUBLIC_ASSISTANT_BASE_URL=https://proj-[YOUR-ID].assistant-api.com
 
-You need an assistant-cloud account to follow this guide. You can sign up here: [https://cloud.assistant-ui.com/](https://cloud.assistant-ui.com/)
+# API key for server-side operations
+ASSISTANT_API_KEY=your-api-key-here
+```
+
+</Step>
 
-### Setting up assistant-cloud project in your react project:
+<Step>
 
-1. Create a new project on the assistant-cloud dashboard and copy the Frontend API URL (`https://proj-[ID].assistant-api.com`) from the settings page.
-2. Add the url as an environment variable `NEXT_PUBLIC_ASSISTANT_BASE_URL`
+### Install Dependencies
+
+Install the required packages:
 
 ```bash
-NEXT_PUBLIC_ASSISTANT_BASE_URL=[YOUR_FRONTEND_API_URL]
+npm install @assistant-ui/react @assistant-ui/react-ai-sdk
 ```
-3. Create a client side AssistantCloud instance. Note: this will create an anonymous user id that is tied to the user's browser session. For connecting to an auth provider to persist threads for a user based on a workspace and/or user id, look at [Cloud Authorization Docs](/docs/cloud/authorization).
 
-```typescript
+</Step>
+
+<Step>
+
+### Set Up the Cloud Runtime
+
+Create a client-side AssistantCloud instance and integrate it with your AI SDK runtime:
+
+```tsx title="app/chat/page.tsx"
 "use client";
-import {
-  AssistantCloud,
-  AssistantRuntimeProvider,
-  ThreadList,
-  Thread
-} from "@assistant-ui/react";
+
+import { AssistantCloud, AssistantRuntimeProvider } from "@assistant-ui/react";
 import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { ThreadList } from "@/components/assistant-ui/thread-list";
+import { Thread } from "@/components/assistant-ui/thread";
+
+export default function ChatPage() {
+  const cloud = new AssistantCloud({
+    baseUrl: process.env.NEXT_PUBLIC_ASSISTANT_BASE_URL!,
+    anonymous: true, // Creates browser-session based user ID
+  });
+
+  const runtime = useChatRuntime({
+    api: "/api/chat", // Your AI SDK endpoint
+    cloud,
+  });
+
+  return (
+    <AssistantRuntimeProvider runtime={runtime}>
+      <div className="grid h-dvh grid-cols-[200px_1fr] gap-x-2 px-4 py-4">
+        <ThreadList />
+        <Thread />
+      </div>
+    </AssistantRuntimeProvider>
+  );
+}
+```
+
+</Step>
 
+</Steps>
 
-const cloud = new AssistantCloud({
-  baseUrl: process.env["NEXT_PUBLIC_ASSISTANT_BASE_URL"]!,
-  anonymous: true,
-});
+## Authentication
 
+The example above uses `anonymous: true` which creates a browser session-based user ID. This is suitable for public demos or prototypes.
 
-const runtime = useChatRuntime({
-  api: "/api/chat",
-  cloud,
-});
+For production apps with user accounts, see the [Cloud Authorization](/docs/cloud/authorization) guide to persist threads per user or workspace.
 
- return (
-  <AssistantRuntimeProvider runtime={runtime}>
-    <div className="grid h-dvh grid-cols-[200px_1fr] gap-x-2 px-4 py-4">
-      <ThreadList />
-      <Thread />
-    </div>
-  </AssistantRuntimeProvider>
-);
+## Next Steps
 
-```
+- Learn about [user authentication](/docs/cloud/authorization) for multi-user applications
+- Explore [runtime hooks](/docs/api-reference/integrations/vercel-ai-sdk) and integration options
+- Check out the [complete example](https://github.com/assistant-ui/assistant-ui/tree/main/examples/with-cloud) on GitHub