@assistant-ui/mcp-docs-server 0.1.2 → 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

@@ -4,14 +4,12 @@ title: makeAssistantToolUI
 
 import { ParametersTable } from "@/components/docs";
 
-# `makeAssistantToolUI`
-
 The `makeAssistantToolUI` utility is used to register a tool UI component with the Assistant.
 
 ## Usage
 
 ```tsx
-import { makeAssistantToolUI } from "assistant-ui/react";
+import { makeAssistantToolUI } from "@assistant-ui/react";
 
 const MyToolUI = makeAssistantToolUI({
   toolName: "myTool",
@@ -23,9 +21,7 @@ const MyToolUI = makeAssistantToolUI({
 
 ## API
 
-### `makeAssistantToolUI(tool)`
-
-#### Parameters
+### Parameters
 
 <ParametersTable
   type="AssistantToolUIProps<TArgs, TResult>"
@@ -33,33 +29,99 @@ 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: "function",
-      description: "A function that renders the tool UI. It receives an object with the following properties: `args` (any): The arguments passed to the tool. `result` (any): The result of the tool execution. `status` (\"requires_action\" | \"in_progress\" | \"complete\" | \"error\"): The status of the tool execution.",
+      type: "ComponentType<ToolCallMessagePartProps<TArgs, TResult>>",
+      description:
+        "A React component that renders the tool UI. Receives the following props:",
+      required: true,
+      children: [
+        {
+          type: "ToolCallMessagePartProps<TArgs, TResult>",
+          parameters: [
+            {
+              name: "type",
+              type: '"tool-call"',
+              description: "The message part type",
+            },
+            {
+              name: "toolCallId",
+              type: "string",
+              description: "Unique identifier for this tool call",
+            },
+            {
+              name: "toolName",
+              type: "string",
+              description: "The name of the tool being called",
+            },
+            {
+              name: "args",
+              type: "TArgs",
+              description: "The arguments passed to the tool",
+            },
+            {
+              name: "argsText",
+              type: "string",
+              description: "String representation of the arguments",
+            },
+            {
+              name: "result",
+              type: "TResult | undefined",
+              description: "The result of the tool execution (if complete)",
+            },
+            {
+              name: "isError",
+              type: "boolean | undefined",
+              description: "Whether the result is an error",
+            },
+            {
+              name: "status",
+              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)",
+            },
+            {
+              name: "artifact",
+              type: "unknown",
+              description:
+                "Optional artifact data associated with the tool call",
+            },
+          ],
+        },
+      ],
     },
   ]}
 />
 
-#### Returns
+### Returns
 
 A React functional component that should be included in your component tree. This component doesn't render anything itself, but it registers the tool UI with the Assistant.
 
 ## Example
 
 ```tsx
-import { makeAssistantToolUI } from "assistant-ui/react";
-import { AssistantRuntimeProvider } from "assistant-ui/react";
+import { makeAssistantToolUI } from "@assistant-ui/react";
+import { AssistantRuntimeProvider } from "@assistant-ui/react";
 
 const GetWeatherUI = makeAssistantToolUI({
   toolName: "get_weather",
   render: ({ args, result, status }) => {
-    if (status === "requires_action") return <p>Getting weather for {args.location}...</p>;
-    if (status === "in_progress") return <p>Loading...</p>;
-    if (status === "error") return <p>Error getting weather.</p>;
-    if (status === "complete") return <p>The weather is {result.weather}.</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>;
     return null;
   },
 });
@@ -73,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

@@ -2,6 +2,8 @@
 title: makeAssistantTool
 ---
 
+import { ParametersTable } from "@/components/docs";
+
 `makeAssistantTool` creates a React component that provides a tool to the assistant. This is useful for defining reusable tools that can be composed into your application.
 
 ## Usage
@@ -23,7 +25,10 @@ const submitForm = tool({
 });
 
 // Create a tool component
-const SubmitFormTool = makeAssistantTool(submitForm);
+const SubmitFormTool = makeAssistantTool({
+  ...submitForm,
+  toolName: "submitForm",
+});
 
 // Use in your component
 function Form() {
@@ -40,9 +45,102 @@ function Form() {
 
 ### Parameters
 
-- `tool`: A tool definition created using the `tool()` helper function
-  - `parameters`: Zod schema defining the tool's parameters
-  - `execute`: Function that implements the tool's behavior
+<ParametersTable
+  type="AssistantToolProps<TArgs, TResult>"
+  parameters={[
+    {
+      name: "toolName",
+      type: "string",
+      description: "The unique identifier for the tool",
+      required: true,
+    },
+    {
+      name: "parameters",
+      type: "StandardSchemaV1<TArgs> | JSONSchema7",
+      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)",
+      required: true,
+    },
+    {
+      name: "description",
+      type: "string",
+      description: "Optional description of the tool's purpose",
+    },
+    {
+      name: "render",
+      type: "ComponentType<ToolCallMessagePartProps<TArgs, TResult>>",
+      description:
+        "Optional custom UI component for rendering the tool execution. Receives the following props:",
+      children: [
+        {
+          type: "ToolCallMessagePartProps<TArgs, TResult>",
+          parameters: [
+            {
+              name: "type",
+              type: '"tool-call"',
+              description: "The message part type",
+            },
+            {
+              name: "toolCallId",
+              type: "string",
+              description: "Unique identifier for this tool call",
+            },
+            {
+              name: "toolName",
+              type: "string",
+              description: "The name of the tool being called",
+            },
+            {
+              name: "args",
+              type: "TArgs",
+              description: "The arguments passed to the tool",
+            },
+            {
+              name: "argsText",
+              type: "string",
+              description: "String representation of the arguments",
+            },
+            {
+              name: "result",
+              type: "TResult | undefined",
+              description: "The result of the tool execution (if complete)",
+            },
+            {
+              name: "isError",
+              type: "boolean | undefined",
+              description: "Whether the result is an error",
+            },
+            {
+              name: "status",
+              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)",
+            },
+            {
+              name: "artifact",
+              type: "unknown",
+              description:
+                "Optional artifact data associated with the tool call",
+            },
+          ],
+        },
+      ],
+    },
+  ]}
+/>
 
 ### Returns
 
@@ -76,14 +174,20 @@ const sendEmail = tool({
     body: z.string(),
   }),
   execute: async (params) => {
-    // Implementation
+    // Tool logic
     return { sent: true };
   },
 });
 
 // Create tool components
-const EmailValidator = makeAssistantTool(validateEmail);
-const EmailSender = makeAssistantTool(sendEmail);
+const EmailValidator = makeAssistantTool({
+  ...validateEmail,
+  toolName: "validateEmail",
+});
+const EmailSender = makeAssistantTool({
+  ...sendEmail,
+  toolName: "sendEmail",
+});
 
 // Use together
 function EmailForm() {

package/.docs/raw/docs/copilots/model-context.mdx

@@ -54,7 +54,10 @@ const submitForm = tool({
   },
 });
 
-const SubmitFormTool = makeAssistantTool(submitForm);
+const SubmitFormTool = makeAssistantTool({
+  ...submitForm,
+  toolName: "submitForm"
+});
 
 // Use in your component
 function Form() {

package/.docs/raw/docs/copilots/motivation.mdx

@@ -122,7 +122,10 @@ const analyzeTransaction = tool({
 });
 
 // Create a tool component
-const TransactionAnalyzer = makeAssistantTool(analyzeTransaction);
+const TransactionAnalyzer = makeAssistantTool({
+  ...analyzeTransaction,
+  toolName: "analyzeTransaction",
+});
 
 function SmartTransactionHistory() {
   // Previous instructions...