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

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/concepts/runtime-layer.mdx

@@ -66,7 +66,7 @@ import { File, Folder, Files } from "fumadocs-ui/components/files";
       <Folder name="ThreadRuntime" defaultOpen>
         <Folder name="MessageRuntime" defaultOpen>
           <Folder
-            name="ContentPartRuntime (Text / Reasoning / Image / Audio / Tool-Call / UI)"
+            name="MessagePartRuntime (Text / Reasoning / Image / Audio / Tool-Call / UI)"
             defaultOpen
           ></Folder>
           <Folder name="MessageAttachmentRuntime" defaultOpen></Folder>
@@ -95,8 +95,8 @@ The following components provide the runtime APIs:
 // renders every message, provides MessageRuntime, ComposerRuntime (EditComposer)
 <ThreadPrimitive.Messages components={{ Message, ... }} />
 
-// renders every content part, provides ContentPartRuntime
-<MessagePrimitive.Content components={{ Text, Reasoning, Image, Audio, UI, tools }} />
+// renders every message part, provides MessagePartRuntime
+<MessagePrimitive.Parts components={{ Text, Reasoning, Image, Audio, UI, tools }} />
 
 // renders every attachment, provides AttachmentRuntime (Thread or EditComposer)
 <ComposerPrimitive.Attachments components={{ Attachment, ... }} />
@@ -104,8 +104,8 @@ The following components provide the runtime APIs:
 // renders every attachment, provides AtatchmentRuntime (Message)
 <MessagePrimitive.Attachments components={{ Attachment, ... }} />
 
-// provides a custom TextContentPartRuntime
-<TextContentPartProvider text="Hello!" />
+// provides a custom TextMessagePartRuntime
+<TextMessagePartProvider text="Hello!" />
 ```
 
 ### Accessing runtime APIs
@@ -116,7 +116,7 @@ You can access the runtime APIs with react hooks:
 const runtime = useAssistantRuntime();
 const threadRuntime = useThreadRuntime();
 const messageRuntime = useMessageRuntime();
-const contentPartRuntime = useContentPartRuntime();
+const MessagePartRuntime = useMessagePartRuntime();
 
 // thread manager has no separate hook (1:1 relationship with assistant runtime)
 const ThreadListRuntime = useAssistantRuntime().threads;
@@ -145,7 +145,7 @@ Most runtimes also expose a state through two methods `getState` and `subscribe`
 useThreadList(); // get thread manager state
 useThread(); // get thread state
 useMessage(); // get message state
-useContentPart(); // get content part state
+useMessagePart(); // get message part state
 useComposer(); // get composer state
 useThreadComposer(); // get thread composer state
 useEditComposer(); // get edit composer state

package/.docs/raw/docs/copilots/make-assistant-tool-ui.mdx

@@ -29,21 +29,23 @@ const MyToolUI = makeAssistantToolUI({
     {
       name: "toolName",
       type: "string",
-      description: "The name of the tool. This must match the name of the tool defined in the assistant.",
+      description:
+        "The name of the tool. This must match the name of the tool defined in the assistant.",
     },
     {
       name: "render",
-      type: "ComponentType<ToolCallContentPartProps<TArgs, TResult>>",
-      description: "A React component that renders the tool UI. Receives the following props:",
+      type: "ComponentType<ToolCallMessagePartProps<TArgs, TResult>>",
+      description:
+        "A React component that renders the tool UI. Receives the following props:",
       required: true,
       children: [
         {
-          type: "ToolCallContentPartProps<TArgs, TResult>",
+          type: "ToolCallMessagePartProps<TArgs, TResult>",
           parameters: [
             {
               name: "type",
-              type: "\"tool-call\"",
-              description: "The content part type",
+              type: '"tool-call"',
+              description: "The message part type",
             },
             {
               name: "toolCallId",
@@ -77,18 +79,21 @@ const MyToolUI = makeAssistantToolUI({
             },
             {
               name: "status",
-              type: "ToolCallContentPartStatus",
-              description: "The execution status object with a type property: \"running\", \"complete\", \"incomplete\", or \"requires_action\"",
+              type: "ToolCallMessagePartStatus",
+              description:
+                'The execution status object with a type property: "running", "complete", "incomplete", or "requires_action"',
             },
             {
               name: "addResult",
               type: "(result: TResult | ToolResponse<TResult>) => void",
-              description: "Function to add a result (useful for human-in-the-loop tools)",
+              description:
+                "Function to add a result (useful for human-in-the-loop tools)",
             },
             {
               name: "artifact",
               type: "unknown",
-              description: "Optional artifact data associated with the tool call",
+              description:
+                "Optional artifact data associated with the tool call",
             },
           ],
         },
@@ -110,10 +115,13 @@ import { AssistantRuntimeProvider } from "@assistant-ui/react";
 const GetWeatherUI = makeAssistantToolUI({
   toolName: "get_weather",
   render: ({ args, result, status }) => {
-    if (status.type === "requires_action") return <p>Getting weather for {args.location}...</p>;
+    if (status.type === "requires_action")
+      return <p>Getting weather for {args.location}...</p>;
     if (status.type === "running") return <p>Loading...</p>;
-    if (status.type === "incomplete" && status.reason === "error") return <p>Error getting weather.</p>;
-    if (status.type === "complete") return <p>The weather is {result.weather}.</p>;
+    if (status.type === "incomplete" && status.reason === "error")
+      return <p>Error getting weather.</p>;
+    if (status.type === "complete")
+      return <p>The weather is {result.weather}.</p>;
     return null;
   },
 });
@@ -127,4 +135,5 @@ function App() {
   );
 }
 ```
+
 This example shows how to create a simple UI for a `get_weather` tool. The UI will display different messages depending on the status of the tool execution.

package/.docs/raw/docs/copilots/make-assistant-tool.mdx

@@ -27,7 +27,7 @@ const submitForm = tool({
 // Create a tool component
 const SubmitFormTool = makeAssistantTool({
   ...submitForm,
-  toolName: "submitForm"
+  toolName: "submitForm",
 });
 
 // Use in your component
@@ -57,13 +57,15 @@ function Form() {
     {
       name: "parameters",
       type: "StandardSchemaV1<TArgs> | JSONSchema7",
-      description: "Schema defining the tool's parameters (typically a Zod schema)",
+      description:
+        "Schema defining the tool's parameters (typically a Zod schema)",
       required: true,
     },
     {
       name: "execute",
       type: "(args: TArgs, context: ToolExecutionContext) => TResult | Promise<TResult>",
-      description: "Function that implements the tool's behavior (required for frontend tools)",
+      description:
+        "Function that implements the tool's behavior (required for frontend tools)",
       required: true,
     },
     {
@@ -73,16 +75,17 @@ function Form() {
     },
     {
       name: "render",
-      type: "ComponentType<ToolCallContentPartProps<TArgs, TResult>>",
-      description: "Optional custom UI component for rendering the tool execution. Receives the following props:",
+      type: "ComponentType<ToolCallMessagePartProps<TArgs, TResult>>",
+      description:
+        "Optional custom UI component for rendering the tool execution. Receives the following props:",
       children: [
         {
-          type: "ToolCallContentPartProps<TArgs, TResult>",
+          type: "ToolCallMessagePartProps<TArgs, TResult>",
           parameters: [
             {
               name: "type",
-              type: "\"tool-call\"",
-              description: "The content part type",
+              type: '"tool-call"',
+              description: "The message part type",
             },
             {
               name: "toolCallId",
@@ -116,18 +119,21 @@ function Form() {
             },
             {
               name: "status",
-              type: "ToolCallContentPartStatus",
-              description: "The execution status object with a type property: \"running\", \"complete\", \"incomplete\", or \"requires_action\"",
+              type: "ToolCallMessagePartStatus",
+              description:
+                'The execution status object with a type property: "running", "complete", "incomplete", or "requires_action"',
             },
             {
               name: "addResult",
               type: "(result: TResult | ToolResponse<TResult>) => void",
-              description: "Function to add a result (useful for human-in-the-loop tools)",
+              description:
+                "Function to add a result (useful for human-in-the-loop tools)",
             },
             {
               name: "artifact",
               type: "unknown",
-              description: "Optional artifact data associated with the tool call",
+              description:
+                "Optional artifact data associated with the tool call",
             },
           ],
         },
@@ -176,11 +182,11 @@ const sendEmail = tool({
 // Create tool components
 const EmailValidator = makeAssistantTool({
   ...validateEmail,
-  toolName: "validateEmail"
+  toolName: "validateEmail",
 });
 const EmailSender = makeAssistantTool({
   ...sendEmail,
-  toolName: "sendEmail"
+  toolName: "sendEmail",
 });
 
 // Use together

package/.docs/raw/docs/getting-started.mdx

@@ -15,6 +15,7 @@ import { Card, Cards } from "fumadocs-ui/components/card";
   <Step>
 
 ### Initialize assistant-ui
+
 **Create a new project:**
 
 ```sh
@@ -349,7 +350,7 @@ const UserMessage: FC = () => {
       <UserActionBar />
 
       <div className="aui-user-message-content">
-        <MessagePrimitive.Content />
+        <MessagePrimitive.Parts />
       </div>
 
       <BranchPicker className="aui-user-branch-picker" />
@@ -394,7 +395,7 @@ const AssistantMessage: FC = () => {
   return (
     <MessagePrimitive.Root className="aui-assistant-message-root">
       <div className="aui-assistant-message-content">
-        <MessagePrimitive.Content components={{ Text: MarkdownText }} />
+        <MessagePrimitive.Parts components={{ Text: MarkdownText }} />
       </div>
 
       <AssistantActionBar />
@@ -1110,23 +1111,23 @@ const MyApp = () => {
 ## What's Next?
 
 <Cards>
-  <Card 
-    title="Pick a Runtime" 
+  <Card
+    title="Pick a Runtime"
     description="Choose the right runtime for your needs"
     href="/docs/runtimes/pick-a-runtime"
   />
-  <Card 
-    title="Generative UI" 
+  <Card
+    title="Generative UI"
     description="Create rich UI components for tool executions"
     href="/docs/guides/ToolUI"
   />
-  <Card 
-    title="Add Persistence" 
+  <Card
+    title="Add Persistence"
     description="Save and restore chat conversations"
     href="/docs/cloud/overview"
   />
-  <Card 
-    title="Examples" 
+  <Card
+    title="Examples"
     description="Explore full implementations and demos"
     href="https://github.com/assistant-ui/assistant-ui/tree/main/examples"
   />