@assistant-ui/mcp-docs-server 0.1.6 → 0.1.8

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

@@ -4,10 +4,9 @@
 
 ```typescript
 import { openai } from "@ai-sdk/openai";
-import { frontendTools } from "@assistant-ui/react-ai-sdk-v4";
-import { streamText } from "ai";
+import { frontendTools } from "@assistant-ui/react-ai-sdk";
+import { convertToModelMessages, streamText } from "ai";
 
-export const runtime = "edge";
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
@@ -15,15 +14,14 @@ export async function POST(req: Request) {
 
   const result = streamText({
     model: openai("gpt-4o"),
-    messages,
-    toolCallStreaming: true,
+    messages: convertToModelMessages(messages),
     system,
     tools: {
       ...frontendTools(tools),
     },
   });
 
-  return result.toDataStreamResponse();
+  return result.toUIMessageStreamResponse();
 }
 
 ```
@@ -189,16 +187,14 @@ export default function RootLayout({
 "use client";
 
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk-v4";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 
 export function MyRuntimeProvider({
   children,
 }: Readonly<{
   children: React.ReactNode;
 }>) {
-  const runtime = useChatRuntime({
-    api: "/api/chat",
-  });
+  const runtime = useChatRuntime();
 
   return (
     <AssistantRuntimeProvider runtime={runtime}>
@@ -887,6 +883,7 @@ const CircleStopIcon = () => {
 "use client";
 
 import { ComponentPropsWithoutRef, forwardRef } from "react";
+import { Slottable } from "@radix-ui/react-slot";
 
 import {
   Tooltip,
@@ -915,7 +912,7 @@ export const TooltipIconButton = forwardRef<
           className={cn("size-6 p-1", className)}
           ref={ref}
         >
-          {children}
+          <Slottable>{children}</Slottable>
           <span className="sr-only">{tooltip}</span>
         </Button>
       </TooltipTrigger>
@@ -1649,7 +1646,7 @@ export default nextConfig;
     "lint": "next lint"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^1.3.22",
+    "@ai-sdk/openai": "^2.0.15",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-hook-form": "workspace:*",
@@ -1659,23 +1656,23 @@ export default nextConfig;
     "@radix-ui/react-icons": "^1.3.2",
     "@radix-ui/react-label": "^2.1.7",
     "@radix-ui/react-slot": "^1.2.3",
-    "@radix-ui/react-tabs": "^1.1.12",
-    "@radix-ui/react-tooltip": "^1.2.7",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@radix-ui/react-tooltip": "^1.2.8",
     "@react-hook/media-query": "^1.1.1",
-    "ai": "^4.3.16",
+    "ai": "^5.0.15",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "json-schema-to-zod": "^2.6.1",
-    "lucide-react": "^0.535.0",
-    "next": "15.4.5",
+    "lucide-react": "^0.539.0",
+    "next": "15.4.6",
     "react": "19.1.1",
     "react-dom": "19.1.1",
-    "react-hook-form": "^7.61.1",
+    "react-hook-form": "^7.62.0",
     "react-resizable-panels": "^3.0.4",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.3.1",
     "tw-animate-css": "^1.3.6",
-    "zod": "^4.0.14",
+    "zod": "^4.0.17",
     "zustand": "^5.0.7"
   },
   "devDependencies": {
@@ -1684,9 +1681,9 @@ export default nextConfig;
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-config-next": "15.4.5",
+    "eslint-config-next": "15.4.6",
     "postcss": "^8",
-    "tailwindcss": "^4.1.11",
+    "tailwindcss": "^4.1.12",
     "typescript": "^5.9.2"
   }
 }
@@ -1714,6 +1711,7 @@ export default nextConfig;
       "@/*": ["./*"],
       "@assistant-ui/*": ["../../packages/*/src"],
       "@assistant-ui/react/*": ["../../packages/react/src/*"],
+      "@assistant-ui/tap/*": ["../../packages/tap/src/*"],
       "assistant-stream": ["../../packages/assistant-stream/src"],
       "assistant-stream/*": ["../../packages/assistant-stream/src/*"]
     }

package/.docs/raw/docs/api-reference/integrations/react-data-stream.mdx

@@ -0,0 +1,194 @@
+---
+title: "@assistant-ui/react-data-stream"
+---
+
+Data Stream protocol integration for assistant-ui.
+
+import { ParametersTable } from "@/components/docs";
+
+## API Reference
+
+### `useDataStreamRuntime`
+
+Create a runtime that connects to a data stream protocol endpoint.
+
+```tsx
+import { useDataStreamRuntime } from "@assistant-ui/react-data-stream";
+
+const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
+  const runtime = useDataStreamRuntime({
+    api: "/api/chat",
+  });
+
+  return (
+    <AssistantRuntimeProvider runtime={runtime}>
+      {children}
+    </AssistantRuntimeProvider>
+  );
+};
+```
+
+<ParametersTable
+  parameters={[
+    {
+      name: "api",
+      type: "string",
+      description: "The API endpoint URL for the data stream protocol.",
+    },
+    {
+      name: "onResponse",
+      type: "(response: Response) => void | Promise<void>",
+      description: "Optional callback called when a response is received.",
+    },
+    {
+      name: "onFinish",
+      type: "(message: ThreadMessage) => void",
+      description: "Optional callback called when a message is finished.",
+    },
+    {
+      name: "onError",
+      type: "(error: Error) => void",
+      description: "Optional callback called when an error occurs.",
+    },
+    {
+      name: "onCancel",
+      type: "() => void",
+      description: "Optional callback called when a request is cancelled.",
+    },
+    {
+      name: "credentials",
+      type: "RequestCredentials",
+      description: "Optional credentials mode for the fetch request.",
+    },
+    {
+      name: "headers",
+      type: "Record<string, string> | Headers | (() => Promise<Record<string, string> | Headers>)",
+      description: "Optional headers to include in the request.",
+    },
+    {
+      name: "body",
+      type: "object",
+      description: "Optional additional body parameters to include in the request.",
+    },
+    {
+      name: "sendExtraMessageFields",
+      type: "boolean",
+      description: "Whether to include extra message fields like IDs in the request.",
+    },
+  ]}
+/>
+
+### `useCloudRuntime`
+
+Create a runtime that connects to Assistant Cloud using the data stream protocol.
+
+```tsx
+import { useCloudRuntime } from "@assistant-ui/react-data-stream";
+
+const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
+  const runtime = useCloudRuntime({
+    cloud: assistantCloud,
+    assistantId: "my-assistant-id",
+  });
+
+  return (
+    <AssistantRuntimeProvider runtime={runtime}>
+      {children}
+    </AssistantRuntimeProvider>
+  );
+};
+```
+
+<ParametersTable
+  parameters={[
+    {
+      name: "cloud",
+      type: "AssistantCloud",
+      description: "The Assistant Cloud instance.",
+    },
+    {
+      name: "assistantId",
+      type: "string",
+      description: "The ID of the assistant to connect to.",
+    },
+    {
+      name: "onResponse",
+      type: "(response: Response) => void | Promise<void>",
+      description: "Optional callback called when a response is received.",
+    },
+    {
+      name: "onFinish",
+      type: "(message: ThreadMessage) => void",
+      description: "Optional callback called when a message is finished.",
+    },
+    {
+      name: "onError",
+      type: "(error: Error) => void",
+      description: "Optional callback called when an error occurs.",
+    },
+    {
+      name: "onCancel",
+      type: "() => void",
+      description: "Optional callback called when a request is cancelled.",
+    },
+    {
+      name: "credentials",
+      type: "RequestCredentials",
+      description: "Optional credentials mode for the fetch request.",
+    },
+    {
+      name: "headers",
+      type: "Record<string, string> | Headers | (() => Promise<Record<string, string> | Headers>)",
+      description: "Optional headers to include in the request.",
+    },
+    {
+      name: "body",
+      type: "object",
+      description: "Optional additional body parameters to include in the request.",
+    },
+    {
+      name: "sendExtraMessageFields",
+      type: "boolean",
+      description: "Whether to include extra message fields like IDs in the request.",
+    },
+  ]}
+/>
+
+### `toLanguageModelMessages`
+
+Convert assistant-ui messages to language model format.
+
+```tsx
+import { toLanguageModelMessages } from "@assistant-ui/react-data-stream";
+
+const languageModelMessages = toLanguageModelMessages(messages, {
+  unstable_includeId: true,
+});
+```
+
+<ParametersTable
+  parameters={[
+    {
+      name: "messages",
+      type: "readonly ThreadMessage[]",
+      description: "The messages to convert.",
+    },
+    {
+      name: "options",
+      type: "{ unstable_includeId?: boolean }",
+      description: "Optional conversion options.",
+      children: [
+        {
+          type: "{ unstable_includeId?: boolean }",
+          parameters: [
+            {
+              name: "unstable_includeId",
+              type: "boolean",
+              description: "Whether to include message IDs in the converted messages.",
+            },
+          ],
+        },
+      ],
+    },
+  ]}
+/>

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

@@ -29,10 +29,13 @@ export const contextColors = {
 ### AI SDK
 
 - [`useChatRuntime`](#use-chat-runtime)
-- [`useVercelUseChatRuntime`](#use-vercel-use-chat-runtime) (legacy)
-- [`useVercelUseAssistantRuntime`](#use-vercel-use-assistant-runtime)
-- [`useVercelRSCRuntime`](#use-vercel-rsc-runtime)
-- [`useDangerousInBrowserRuntime`](#use-dangerous-in-browser-runtime)
+- [`useAISDKRuntime`](#use-aisdk-runtime)
+
+### Data Stream
+
+- [`useDataStreamRuntime`](#use-data-stream-runtime)
+- [`useCloudRuntime`](#use-cloud-runtime)
+- [`toLanguageModelMessages`](#to-language-model-messages)
 
 ### LangGraph
 

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

@@ -168,6 +168,37 @@ Renders attachments. This primitive renders a separate component for each attach
   ]}
 />
 
+### AttachmentByIndex
+
+Renders a single attachment at the specified index within the composer.
+
+```tsx
+<ComposerPrimitive.AttachmentByIndex
+  index={0}
+  components={{
+    Image: MyImageAttachment,
+    Document: MyDocumentAttachment
+  }}
+/>
+```
+
+<ParametersTable
+  type="ComposerPrimitive.AttachmentByIndex.Props"
+  parameters={[
+    {
+      name: "index",
+      type: "number",
+      required: true,
+      description: "The index of the attachment to render.",
+    },
+    {
+      name: "components",
+      type: "ComposerAttachmentsComponents",
+      description: "The components to render for the attachment.",
+    },
+  ]}
+/>
+
 ### AddAttachment
 
 Renders a button to add an attachment.

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

@@ -13,7 +13,7 @@ import { MessagePrimitive } from "@assistant-ui/react";
 
 const UserMessage = () => (
   <MessagePrimitive.Root>
-    User: <MessagePrimitive.Content />
+    User: <MessagePrimitive.Parts />
     <BranchPicker />
     <ActionBar />
   </MessagePrimitive.Root>
@@ -21,7 +21,7 @@ const UserMessage = () => (
 
 const AssistantMessage = () => (
   <MessagePrimitive.Root>
-    Assistant: <MessagePrimitive.Content />
+    Assistant: <MessagePrimitive.Parts />
     <BranchPicker />
     <ActionBar />
   </MessagePrimitive.Root>
@@ -45,7 +45,7 @@ This primitive renders a `<div>` element unless `asChild` is set.
   ]}
 />
 
-### Content
+### Parts
 
 The content of the message. This renders a separate component for each content part of the message.
 
@@ -154,6 +154,111 @@ The content of the message. This renders a separate component for each content p
   ]}
 />
 
+### PartByIndex
+
+Renders a single message part at the specified index.
+
+```tsx
+<MessagePrimitive.PartByIndex
+  index={0}
+  components={{
+    Text: MyTextComponent,
+    Image: MyImageComponent
+  }}
+/>
+```
+
+<ParametersTable
+  type="MessagePrimitive.PartByIndex.Props"
+  parameters={[
+    {
+      name: "index",
+      type: "number",
+      required: true,
+      description: "The index of the message part to render.",
+    },
+    {
+      name: "components",
+      required: false,
+      type: "ContentPartComponents",
+      description: "The components to render for the message part.",
+    },
+  ]}
+/>
+
+### Attachments
+
+Renders all attachments of the message.
+
+<ParametersTable
+  type="MessagePrimitive.Attachments.Props"
+  parameters={[
+    {
+      name: "components",
+      type: "AttachmentComponents",
+      description: "The components to render for each attachment.",
+      children: [
+        {
+          type: "AttachmentComponents",
+          parameters: [
+            {
+              name: "Image",
+              type: "ComponentType",
+              description: "The component to render for image attachments.",
+            },
+            {
+              name: "Document",
+              type: "ComponentType",
+              description: "The component to render for document attachments.",
+            },
+            {
+              name: "File",
+              type: "ComponentType",
+              description: "The component to render for file attachments.",
+            },
+            {
+              name: "Attachment",
+              type: "ComponentType",
+              description: "The fallback component to render for any attachment type.",
+            },
+          ],
+        },
+      ],
+    },
+  ]}
+/>
+
+### AttachmentByIndex
+
+Renders a single attachment at the specified index within the message.
+
+```tsx
+<MessagePrimitive.AttachmentByIndex
+  index={0}
+  components={{
+    Image: MyImageAttachment,
+    Document: MyDocumentAttachment
+  }}
+/>
+```
+
+<ParametersTable
+  type="MessagePrimitive.AttachmentByIndex.Props"
+  parameters={[
+    {
+      name: "index",
+      type: "number",
+      required: true,
+      description: "The index of the attachment to render.",
+    },
+    {
+      name: "components",
+      type: "AttachmentComponents",
+      description: "The components to render for the attachment.",
+    },
+  ]}
+/>
+
 ### If
 
 Renders children if a condition is met.

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

@@ -104,6 +104,65 @@ Renders all messages. This primitive renders a separate component for each messa
   ]}
 />
 
+### MessageByIndex
+
+Renders a single message at the specified index in the current thread.
+
+```tsx
+<ThreadPrimitive.MessageByIndex
+  index={0}
+  components={{
+    UserMessage: MyUserMessage,
+    AssistantMessage: MyAssistantMessage
+  }}
+/>
+```
+
+<ParametersTable
+  type="ThreadPrimitive.MessageByIndex.Props"
+  parameters={[
+    {
+      name: "index",
+      type: "number",
+      required: true,
+      description: "The index of the message to render.",
+    },
+    {
+      name: "components",
+      type: "MessageComponents",
+      description: "The component configuration for rendering the message.",
+      children: [
+        {
+          type: "MessageComponents",
+          parameters: [
+            {
+              name: "Message",
+              type: "ComponentType",
+              description: "The component to render for each message.",
+            },
+            {
+              name: "UserMessage",
+              type: "ComponentType",
+              description: "The component to render for user messages.",
+            },
+            {
+              name: "EditComposer",
+              type: "ComponentType",
+              description:
+                "The component to render for user messages that are being edited.",
+            },
+            {
+              name: "AssistantMessage",
+              type: "ComponentType",
+              description: "The component to render for assistant messages.",
+            },
+          ],
+        },
+      ],
+    },
+  ]}
+/>
+
 ### Empty
 
 Renders children only when there are no messages.

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

@@ -0,0 +1,128 @@
+---
+title: ThreadListPrimitive
+---
+
+Displays a list of conversation threads.
+
+import { ParametersTable } from "@/components/docs";
+
+## Anatomy
+
+```tsx
+import { ThreadListPrimitive } from "@assistant-ui/react";
+
+const ThreadList = () => (
+  <ThreadListPrimitive.Root>
+    <ThreadListPrimitive.New />
+    <ThreadListPrimitive.Items
+      components={{
+        ThreadListItem: MyThreadListItem
+      }}
+    />
+  </ThreadListPrimitive.Root>
+);
+```
+
+## API Reference
+
+### Root
+
+Contains all parts of the thread list.
+
+This primitive renders a `<div>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadListPrimitiveRootProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### New
+
+A button to create a new thread.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadListPrimitiveNewProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### Items
+
+Renders all items in the thread list.
+
+<ParametersTable
+  type="ThreadListPrimitive.Items.Props"
+  parameters={[
+    {
+      name: "archived",
+      type: "boolean",
+      default: "false",
+      description: "Whether to show archived threads instead of active threads.",
+    },
+    {
+      name: "components",
+      type: "ThreadListItemComponents",
+      required: true,
+      description: "The components to render for each thread list item.",
+      children: [
+        {
+          type: "ThreadListItemComponents",
+          parameters: [
+            {
+              name: "ThreadListItem",
+              type: "ComponentType",
+              required: true,
+              description: "The component to render for each thread in the list.",
+            },
+          ],
+        },
+      ],
+    },
+  ]}
+/>
+
+### ItemByIndex
+
+Renders a single thread list item at the specified index.
+
+```tsx
+<ThreadListPrimitive.ItemByIndex
+  index={0}
+  components={{
+    ThreadListItem: MyThreadListItem
+  }}
+/>
+```
+
+<ParametersTable
+  type="ThreadListPrimitive.ItemByIndex.Props"
+  parameters={[
+    {
+      name: "index",
+      type: "number",
+      required: true,
+      description: "The index of the thread list item to render.",
+    },
+    {
+      name: "archived",
+      type: "boolean",
+      default: "false",
+      description: "Whether to render from archived threads instead of active threads.",
+    },
+    {
+      name: "components",
+      type: "ThreadListItemComponents",
+      required: true,
+      description: "The components to render for the thread list item.",
+    },
+  ]}
+/>