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

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

@@ -828,6 +828,7 @@ export const ToolFallback: ToolCallMessagePartComponent = ({
 "use client";
 
 import { ComponentPropsWithoutRef, forwardRef } from "react";
+import { Slottable } from "@radix-ui/react-slot";
 
 import {
   Tooltip,
@@ -856,7 +857,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>
@@ -1175,6 +1176,7 @@ The API route at `/api/chat` uses the new `streamText` function from AI SDK v5 t
       "@/*": ["./*"],
       "@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/organized/code-examples/with-cloud.md

@@ -870,6 +870,7 @@ const CircleStopIcon = () => {
 "use client";
 
 import { ComponentPropsWithoutRef, forwardRef } from "react";
+import { Slottable } from "@radix-ui/react-slot";
 
 import {
   Tooltip,
@@ -898,7 +899,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>
@@ -1145,6 +1146,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/organized/code-examples/with-external-store.md

@@ -782,6 +782,7 @@ const CircleStopIcon = () => {
 "use client";
 
 import { ComponentPropsWithoutRef, forwardRef } from "react";
+import { Slottable } from "@radix-ui/react-slot";
 
 import {
   Tooltip,
@@ -810,7 +811,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>
@@ -1052,6 +1053,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/organized/code-examples/with-ffmpeg.md

@@ -991,6 +991,7 @@ const CircleStopIcon = () => {
 "use client";
 
 import { ComponentPropsWithoutRef, forwardRef } from "react";
+import { Slottable } from "@radix-ui/react-slot";
 
 import {
   Tooltip,
@@ -1019,7 +1020,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>
@@ -1290,6 +1291,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/organized/code-examples/with-langgraph.md

@@ -1016,11 +1016,11 @@ const CircleStopIcon = () => {
 "use client";
 
 import { ComponentPropsWithoutRef, forwardRef } from "react";
+import { Slottable } from "@radix-ui/react-slot";
 
 import {
   Tooltip,
   TooltipContent,
-  TooltipProvider,
   TooltipTrigger,
 } from "@/components/ui/tooltip";
 import { Button } from "@/components/ui/button";
@@ -1036,23 +1036,21 @@ export const TooltipIconButton = forwardRef<
   TooltipIconButtonProps
 >(({ children, tooltip, side = "bottom", className, ...rest }, ref) => {
   return (
-    <TooltipProvider>
-      <Tooltip>
-        <TooltipTrigger asChild>
-          <Button
-            variant="ghost"
-            size="icon"
-            {...rest}
-            className={cn("size-6 p-1", className)}
-            ref={ref}
-          >
-            {children}
-            <span className="sr-only">{tooltip}</span>
-          </Button>
-        </TooltipTrigger>
-        <TooltipContent side={side}>{tooltip}</TooltipContent>
-      </Tooltip>
-    </TooltipProvider>
+    <Tooltip>
+      <TooltipTrigger asChild>
+        <Button
+          variant="ghost"
+          size="icon"
+          {...rest}
+          className={cn("size-6 p-1", className)}
+          ref={ref}
+        >
+          <Slottable>{children}</Slottable>
+          <span className="sr-only">{tooltip}</span>
+        </Button>
+      </TooltipTrigger>
+      <TooltipContent side={side}>{tooltip}</TooltipContent>
+    </Tooltip>
   );
 });
 
@@ -1560,29 +1558,58 @@ import * as TooltipPrimitive from "@radix-ui/react-tooltip";
 
 import { cn } from "@/lib/utils";
 
-const TooltipProvider = TooltipPrimitive.Provider;
+function TooltipProvider({
+  delayDuration = 0,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {
+  return (
+    <TooltipPrimitive.Provider
+      data-slot="tooltip-provider"
+      delayDuration={delayDuration}
+      {...props}
+    />
+  );
+}
 
-const Tooltip = TooltipPrimitive.Root;
+function Tooltip({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Root>) {
+  return (
+    <TooltipProvider>
+      <TooltipPrimitive.Root data-slot="tooltip" {...props} />
+    </TooltipProvider>
+  );
+}
 
-const TooltipTrigger = TooltipPrimitive.Trigger;
+function TooltipTrigger({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {
+  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />;
+}
 
-const TooltipContent = React.forwardRef<
-  React.ElementRef<typeof TooltipPrimitive.Content>,
-  React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content>
->(({ className, sideOffset = 4, ...props }, ref) => (
-  <TooltipPrimitive.Portal>
-    <TooltipPrimitive.Content
-      ref={ref}
-      sideOffset={sideOffset}
-      className={cn(
-        "bg-primary text-primary-foreground animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 origin-[--radix-tooltip-content-transform-origin] overflow-hidden rounded-md px-3 py-1.5 text-xs",
-        className,
-      )}
-      {...props}
-    />
-  </TooltipPrimitive.Portal>
-));
-TooltipContent.displayName = TooltipPrimitive.Content.displayName;
+function TooltipContent({
+  className,
+  sideOffset = 0,
+  children,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Content>) {
+  return (
+    <TooltipPrimitive.Portal>
+      <TooltipPrimitive.Content
+        data-slot="tooltip-content"
+        sideOffset={sideOffset}
+        className={cn(
+          "bg-primary text-primary-foreground animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 origin-(--radix-tooltip-content-transform-origin) z-50 w-fit text-balance rounded-md px-3 py-1.5 text-xs",
+          className,
+        )}
+        {...props}
+      >
+        {children}
+        <TooltipPrimitive.Arrow className="bg-primary fill-primary z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px]" />
+      </TooltipPrimitive.Content>
+    </TooltipPrimitive.Portal>
+  );
+}
 
 export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
 
@@ -1806,6 +1833,7 @@ npm run dev
       "@/*": ["./*"],
       "@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/organized/code-examples/with-parent-id-grouping.md

@@ -1028,6 +1028,7 @@ const CircleStopIcon = () => {
 "use client";
 
 import { ComponentPropsWithoutRef, forwardRef } from "react";
+import { Slottable } from "@radix-ui/react-slot";
 
 import {
   Tooltip,
@@ -1056,7 +1057,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>
@@ -1365,6 +1366,7 @@ This pattern is useful for:
       "@/*": ["./*"],
       "@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/organized/code-examples/with-react-hook-form.md

@@ -883,6 +883,7 @@ const CircleStopIcon = () => {
 "use client";
 
 import { ComponentPropsWithoutRef, forwardRef } from "react";
+import { Slottable } from "@radix-ui/react-slot";
 
 import {
   Tooltip,
@@ -911,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>
@@ -1710,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

@@ -31,6 +31,12 @@ export const contextColors = {
 - [`useChatRuntime`](#use-chat-runtime)
 - [`useAISDKRuntime`](#use-aisdk-runtime)
 
+### Data Stream
+
+- [`useDataStreamRuntime`](#use-data-stream-runtime)
+- [`useCloudRuntime`](#use-cloud-runtime)
+- [`toLanguageModelMessages`](#to-language-model-messages)
+
 ### LangGraph
 
 - [`useLangGraphRuntime`](#use-lang-graph-runtime)

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.