@assistant-ui/mcp-docs-server 0.1.17 → 0.1.19

package/.docs/raw/docs/{api-reference → (reference)/api-reference}/integrations/react-data-stream.mdx

@@ -1,10 +1,11 @@
 ---
 title: "@assistant-ui/react-data-stream"
+description: Hooks for connecting to data stream protocol endpoints and Assistant Cloud.
 ---
 
 Data Stream protocol integration for assistant-ui.
 
-import { ParametersTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## API Reference
 

package/.docs/raw/docs/{api-reference → (reference)/api-reference}/integrations/react-hook-form.mdx

@@ -1,10 +1,11 @@
 ---
 title: "@assistant-ui/react-hook-form"
+description: React Hook Form integration for AI-assisted form filling.
 ---
 
 A React Hook Form integration for @assistant-ui.
 
-import { ParametersTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## API Reference
 

package/.docs/raw/docs/{api-reference → (reference)/api-reference}/integrations/vercel-ai-sdk.mdx

@@ -1,11 +1,11 @@
 ---
 title: "@assistant-ui/react-ai-sdk"
+description: Vercel AI SDK v5 integration with chat runtime hooks and transport utilities.
 ---
 
 Vercel AI SDK integration for assistant-ui.
 
-import { ParametersTable } from "@/components/docs";
-import { Callout } from "fumadocs-ui/components/callout";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 <Callout type="info">
   This package provides integration with AI SDK v5. For AI SDK v4, see the [AI

package/.docs/raw/docs/{api-reference → (reference)/api-reference}/overview.mdx

@@ -1,8 +1,8 @@
 ---
 title: Overview
+description: API reference for primitives, runtime hooks, and context providers.
 ---
 
-import { Callout } from "fumadocs-ui/components/callout";
 
 import { Component, ContextLevel, RuntimeHooks } from "./context";
 

package/.docs/raw/docs/(reference)/api-reference/primitives/action-bar-more.mdx

@@ -0,0 +1,327 @@
+---
+title: ActionBarMorePrimitive
+---
+
+A dropdown menu for additional actions that don't fit in the main action bar.
+
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
+import { DataAttributesTable } from "@/components/docs/tables/DataAttributesTable";
+import { Code } from "@radix-ui/themes";
+
+## Anatomy
+
+```tsx
+import { ActionBarPrimitive, ActionBarMorePrimitive } from "@assistant-ui/react";
+
+const MessageActions = () => (
+  <ActionBarPrimitive.Root>
+    <ActionBarPrimitive.Copy />
+    <ActionBarPrimitive.Reload />
+
+    <ActionBarMorePrimitive.Root>
+      <ActionBarMorePrimitive.Trigger>
+        <MoreHorizontalIcon />
+      </ActionBarMorePrimitive.Trigger>
+      <ActionBarMorePrimitive.Content>
+        <ActionBarMorePrimitive.Item onSelect={() => console.log("Edit")}>
+          Edit
+        </ActionBarMorePrimitive.Item>
+        <ActionBarMorePrimitive.Item onSelect={() => console.log("Speak")}>
+          Read aloud
+        </ActionBarMorePrimitive.Item>
+        <ActionBarMorePrimitive.Separator />
+        <ActionBarMorePrimitive.Item onSelect={() => console.log("Feedback")}>
+          Submit feedback
+        </ActionBarMorePrimitive.Item>
+      </ActionBarMorePrimitive.Content>
+    </ActionBarMorePrimitive.Root>
+  </ActionBarPrimitive.Root>
+);
+```
+
+## API Reference
+
+### Root
+
+Contains all parts of the dropdown menu.
+
+<ParametersTable
+  type="ActionBarMorePrimitiveRootProps"
+  parameters={[
+    {
+      name: "defaultOpen",
+      type: "boolean",
+      default: "false",
+      description:
+        "The open state of the dropdown menu when it is initially rendered. Use when you do not need to control its open state.",
+    },
+    {
+      name: "open",
+      type: "boolean",
+      description:
+        "The controlled open state of the dropdown menu. Must be used in conjunction with onOpenChange.",
+    },
+    {
+      name: "onOpenChange",
+      type: "(open: boolean) => void",
+      description:
+        "Event handler called when the open state of the dropdown menu changes.",
+    },
+    {
+      name: "modal",
+      type: "boolean",
+      default: "true",
+      description:
+        "The modality of the dropdown menu. When set to true, interaction with outside elements will be disabled and only menu content will be visible to screen readers.",
+    },
+    {
+      name: "dir",
+      type: "'ltr' | 'rtl'",
+      description: "The reading direction of the dropdown menu.",
+    },
+  ]}
+/>
+
+### Trigger
+
+A button that toggles the dropdown menu.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ActionBarMorePrimitiveTriggerProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+<DataAttributesTable
+  data={[
+    {
+      attribute: "[data-state]",
+      values: <Code>"open" | "closed"</Code>,
+    },
+    {
+      attribute: "[data-disabled]",
+      values: "Present when disabled",
+    },
+  ]}
+/>
+
+### Content
+
+The component that pops out when the dropdown menu is open.
+
+This primitive renders a `<div>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ActionBarMorePrimitiveContentProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+    {
+      name: "side",
+      type: "'top' | 'right' | 'bottom' | 'left'",
+      default: "'bottom'",
+      description: "The preferred side of the trigger to render against.",
+    },
+    {
+      name: "sideOffset",
+      type: "number",
+      default: "4",
+      description: "The distance in pixels from the trigger.",
+    },
+    {
+      name: "align",
+      type: "'start' | 'center' | 'end'",
+      default: "'center'",
+      description: "The preferred alignment against the trigger.",
+    },
+    {
+      name: "alignOffset",
+      type: "number",
+      default: "0",
+      description: "An offset in pixels from the align option.",
+    },
+    {
+      name: "portalProps",
+      type: "PortalProps",
+      description: "Props to pass to the Portal component.",
+    },
+  ]}
+/>
+
+<DataAttributesTable
+  data={[
+    {
+      attribute: "[data-state]",
+      values: <Code>"open" | "closed"</Code>,
+    },
+    {
+      attribute: "[data-side]",
+      values: <Code>"top" | "right" | "bottom" | "left"</Code>,
+    },
+    {
+      attribute: "[data-align]",
+      values: <Code>"start" | "center" | "end"</Code>,
+    },
+  ]}
+/>
+
+Refer to Radix UI's Documentation for [DropdownMenu.Content](https://www.radix-ui.com/primitives/docs/components/dropdown-menu#content) for more details.
+
+### Item
+
+A menu item within the dropdown menu.
+
+This primitive renders a `<div>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ActionBarMorePrimitiveItemProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+    {
+      name: "disabled",
+      type: "boolean",
+      description: "When true, prevents the user from interacting with the item.",
+    },
+    {
+      name: "onSelect",
+      type: "(event: Event) => void",
+      description:
+        "Event handler called when the user selects an item (via mouse or keyboard). Calling event.preventDefault in this handler will prevent the dropdown menu from closing when selecting that item.",
+    },
+    {
+      name: "textValue",
+      type: "string",
+      description:
+        "Optional text used for typeahead purposes. By default the typeahead behavior will use the .textContent of the item.",
+    },
+  ]}
+/>
+
+<DataAttributesTable
+  data={[
+    {
+      attribute: "[data-disabled]",
+      values: "Present when disabled",
+    },
+    {
+      attribute: "[data-highlighted]",
+      values: "Present when highlighted",
+    },
+  ]}
+/>
+
+Refer to Radix UI's Documentation for [DropdownMenu.Item](https://www.radix-ui.com/primitives/docs/components/dropdown-menu#item) for more details.
+
+### Separator
+
+A visual separator between groups of items.
+
+This primitive renders a `<div>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ActionBarMorePrimitiveSeparatorProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+## Example Usage
+
+### Basic dropdown menu
+
+```tsx
+import { ActionBarMorePrimitive } from "@assistant-ui/react";
+import { MoreHorizontal, Pencil, Volume2, ThumbsUp } from "lucide-react";
+
+const MoreActionsMenu = () => (
+  <ActionBarMorePrimitive.Root>
+    <ActionBarMorePrimitive.Trigger className="action-button">
+      <MoreHorizontal className="size-4" />
+    </ActionBarMorePrimitive.Trigger>
+    <ActionBarMorePrimitive.Content className="dropdown-content">
+      <ActionBarMorePrimitive.Item
+        className="dropdown-item"
+        onSelect={() => console.log("Edit")}
+      >
+        <Pencil className="size-4" />
+        Edit message
+      </ActionBarMorePrimitive.Item>
+      <ActionBarMorePrimitive.Item
+        className="dropdown-item"
+        onSelect={() => console.log("Speak")}
+      >
+        <Volume2 className="size-4" />
+        Read aloud
+      </ActionBarMorePrimitive.Item>
+      <ActionBarMorePrimitive.Separator className="dropdown-separator" />
+      <ActionBarMorePrimitive.Item
+        className="dropdown-item"
+        onSelect={() => console.log("Like")}
+      >
+        <ThumbsUp className="size-4" />
+        Good response
+      </ActionBarMorePrimitive.Item>
+    </ActionBarMorePrimitive.Content>
+  </ActionBarMorePrimitive.Root>
+);
+```
+
+### Using with action hooks
+
+You can combine the dropdown menu items with action hooks from ActionBarPrimitive:
+
+```tsx
+import {
+  ActionBarPrimitive,
+  ActionBarMorePrimitive,
+  useAssistantApi,
+  useAssistantState,
+} from "@assistant-ui/react";
+import { useCallback } from "react";
+
+const useEditAction = () => {
+  const api = useAssistantApi();
+  const disabled = useAssistantState(({ composer }) => composer.isEditing);
+  const callback = useCallback(() => api.composer().beginEdit(), [api]);
+  if (disabled) return null;
+  return callback;
+};
+
+const useSpeakAction = () => {
+  const api = useAssistantApi();
+  return useCallback(() => api.message().speak(), [api]);
+};
+
+const MoreActionsWithHooks = () => {
+  const edit = useEditAction();
+  const speak = useSpeakAction();
+
+  return (
+    <ActionBarMorePrimitive.Root>
+      <ActionBarMorePrimitive.Trigger>
+        <MoreHorizontalIcon />
+      </ActionBarMorePrimitive.Trigger>
+      <ActionBarMorePrimitive.Content>
+        <ActionBarMorePrimitive.Item onSelect={edit ?? undefined} disabled={!edit}>
+          Edit
+        </ActionBarMorePrimitive.Item>
+        <ActionBarMorePrimitive.Item onSelect={speak}>
+          Read aloud
+        </ActionBarMorePrimitive.Item>
+      </ActionBarMorePrimitive.Content>
+    </ActionBarMorePrimitive.Root>
+  );
+};
+```
+
+

package/.docs/raw/docs/{api-reference/primitives/ActionBar.mdx → (reference)/api-reference/primitives/action-bar.mdx}

@@ -1,10 +1,12 @@
 ---
 title: ActionBarPrimitive
+description: Buttons for message actions like copy, edit, reload, speak, and feedback.
 ---
 
 Buttons to interact with the message.
 
-import { ParametersTable, DataAttributesTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
+import { DataAttributesTable } from "@/components/docs/tables/DataAttributesTable";
 import { Code } from "@radix-ui/themes";
 
 ## Anatomy

package/.docs/raw/docs/{api-reference/primitives/AssistantIf.mdx → (reference)/api-reference/primitives/assistant-if.mdx}

@@ -1,11 +1,11 @@
 ---
 title: AssistantIf
+description: Conditional rendering component based on thread, message, or composer state.
 ---
 
 Conditionally render children based on assistant state.
 
-import { ParametersTable } from "@/components/docs";
-import { Callout } from "fumadocs-ui/components/callout";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 

package/.docs/raw/docs/{api-reference/primitives/AssistantModal.mdx → (reference)/api-reference/primitives/assistant-modal.mdx}

@@ -1,11 +1,13 @@
 ---
 title: AssistantModalPrimitive
+description: A popover chat interface for floating assistant UI in the corner of the screen.
 ---
 
 A modal chat UI usually displayed in the bottom right corner of the screen.
 
 import { Code } from "@radix-ui/themes";
-import { ParametersTable, DataAttributesTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
+import { DataAttributesTable } from "@/components/docs/tables/DataAttributesTable";
 
 ## Anatomy
 

package/.docs/raw/docs/{api-reference/primitives/Attachment.mdx → (reference)/api-reference/primitives/attachment.mdx}

@@ -1,12 +1,13 @@
 ---
 title: AttachmentPrimitive
+description: Components for displaying and managing file attachments in messages and composer.
 ---
 
 Buttons to interact with attachments.
 
-import { ParametersTable, DataAttributesTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
+import { DataAttributesTable } from "@/components/docs/tables/DataAttributesTable";
 import { Code } from "@radix-ui/themes";
-import { Callout } from "fumadocs-ui/components/callout";
 
 <Callout>
   **Dual Use!** Attachments can appear in both messages and composers.

package/.docs/raw/docs/{api-reference/primitives/BranchPicker.mdx → (reference)/api-reference/primitives/branch-picker.mdx}

@@ -1,10 +1,11 @@
 ---
 title: BranchPickerPrimitive
+description: Navigate between conversation branches with previous/next controls.
 ---
 
 View and switch between branches.
 
-import { ParametersTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 

package/.docs/raw/docs/{api-reference/primitives/Composer.mdx → (reference)/api-reference/primitives/composer.mdx}

@@ -1,12 +1,13 @@
 ---
 title: ComposerPrimitive
+description: Primitives for the text input, send button, and attachments.
 ---
 
 The user interface to add new messages or edit existing ones.
 
-import { Callout } from "fumadocs-ui/components/callout";
 
-import { ParametersTable, KeyboardTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
+import { KeyboardTable } from "@/components/docs/tables/KeyboardTable";
 import { Code } from "@radix-ui/themes";
 
 <Callout>
@@ -37,6 +38,20 @@ const EditComposer = () => (
     <ComposerPrimitive.Cancel />
   </ComposerPrimitive.Root>
 );
+
+// with voice input (dictation)
+const ComposerWithDictation = () => (
+  <ComposerPrimitive.Root>
+    <ComposerPrimitive.Input />
+    <ComposerPrimitive.If dictation={false}>
+      <ComposerPrimitive.Dictate />
+    </ComposerPrimitive.If>
+    <ComposerPrimitive.If dictation>
+      <ComposerPrimitive.StopDictation />
+    </ComposerPrimitive.If>
+    <ComposerPrimitive.Send />
+  </ComposerPrimitive.Root>
+);
 ```
 
 ## API Reference
@@ -213,3 +228,87 @@ This primitive renders a `<button>` element unless `asChild` is set.
     },
   ]}
 />
+
+### Dictate
+
+Renders a button to start dictation to convert voice to text.
+
+Requires a `DictationAdapter` to be configured in the runtime.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ComposerPrimitiveDictateProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### StopDictation
+
+Renders a button to stop the current dictation session.
+
+Only rendered when dictation is active.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ComposerPrimitiveStopDictationProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### DictationTranscript
+
+Renders the current interim (partial) transcript while dictation is active.
+
+<Callout type="info">
+**Note:** By default, interim transcripts are displayed directly in the composer input (like native dictation).
+This component is for **advanced customization** when you want to display the interim transcript separately (e.g., in a different style or location).
+</Callout>
+
+Only renders when there is an active interim transcript (returns `null` otherwise).
+
+This primitive renders a `<span>` element.
+
+```tsx
+{/* Optional: Display interim transcript separately with custom styling */}
+<ComposerPrimitive.If dictation>
+  <div className="dictation-preview">
+    <ComposerPrimitive.DictationTranscript className="italic text-muted" />
+  </div>
+</ComposerPrimitive.If>
+```
+
+### If
+
+Renders children if a condition is met.
+
+<ParametersTable
+  type="UseComposerIfProps"
+  parameters={[
+    {
+      name: "editing",
+      required: false,
+      type: "boolean | undefined",
+      description: "Render children if the message is being edited.",
+    },
+    {
+      name: "dictation",
+      required: false,
+      type: "boolean | undefined",
+      description: "Render children if dictation is active.",
+    },
+  ]}
+/>
+
+```tsx
+<Composer.If editing>{/* rendered if message is being edited */}</Composer.If>
+
+<Composer.If dictation>{/* rendered if dictation is active */}</Composer.If>
+```

package/.docs/raw/docs/{api-reference → (reference)/api-reference}/primitives/composition.mdx

@@ -1,5 +1,6 @@
 ---
 title: Composition
+description: How to compose primitives with custom components using asChild.
 ---
 
 import { Code } from "@radix-ui/themes";

package/.docs/raw/docs/{api-reference/primitives/Error.mdx → (reference)/api-reference/primitives/error.mdx}

@@ -1,10 +1,11 @@
 ---
 title: ErrorPrimitive
+description: Components for displaying error messages in the chat interface.
 ---
 
 A component for displaying error messages in the UI.
 
-import { ParametersTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 

package/.docs/raw/docs/{api-reference/primitives/MessagePart.mdx → (reference)/api-reference/primitives/message-part.mdx}

@@ -1,9 +1,9 @@
 ---
 title: MessagePartPrimitive
-description: A part of a message's content. Message parts may be text, image, tool call or UI elements.
+description: Primitives for text, images, tool calls, and other message content.
 ---
 
-import { ParametersTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 import {
   MessagePartRuntime,
   TextMessagePartState,

package/.docs/raw/docs/{api-reference/primitives/Message.mdx → (reference)/api-reference/primitives/message.mdx}

@@ -1,10 +1,11 @@
 ---
 title: MessagePrimitive
+description: Components for rendering message content, parts, and attachments.
 ---
 
 A single message in a conversation. Messages may consist of multiple parts.
 
-import { ParametersTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy