@assistant-ui/mcp-docs-server 0.1.18 → 0.1.20

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
 

package/.docs/raw/docs/(reference)/api-reference/primitives/suggestion.mdx

@@ -0,0 +1,153 @@
+---
+title: SuggestionPrimitive
+---
+
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
+
+Primitives for rendering individual suggestions. These primitives must be used within a suggestion context provided by `ThreadPrimitive.Suggestions`.
+
+## Quick Reference
+
+```tsx
+import { SuggestionPrimitive } from "@assistant-ui/react";
+
+<SuggestionPrimitive.Title />
+<SuggestionPrimitive.Description />
+<SuggestionPrimitive.Trigger />
+```
+
+## API Reference
+
+### `SuggestionPrimitive.Title`
+
+Displays the suggestion's title.
+
+```tsx
+import { SuggestionPrimitive } from "@assistant-ui/react";
+
+const SuggestionCard = () => {
+  return (
+    <div>
+      <h3>
+        <SuggestionPrimitive.Title />
+      </h3>
+    </div>
+  );
+};
+```
+
+This primitive renders a `<span>` element.
+
+### `SuggestionPrimitive.Description`
+
+Displays the suggestion's description/label. This is only shown when suggestions are configured using the object format with separate title and label.
+
+```tsx
+import { SuggestionPrimitive } from "@assistant-ui/react";
+
+const SuggestionCard = () => {
+  return (
+    <div>
+      <p className="text-muted-foreground">
+        <SuggestionPrimitive.Description />
+      </p>
+    </div>
+  );
+};
+```
+
+This primitive renders a `<span>` element.
+
+### `SuggestionPrimitive.Trigger`
+
+A button that triggers the suggestion action when clicked. When clicked, it either sends the message immediately or populates the composer with the suggestion's prompt.
+
+```tsx
+import { SuggestionPrimitive } from "@assistant-ui/react";
+
+const SuggestionButton = () => {
+  return (
+    <SuggestionPrimitive.Trigger send asChild>
+      <button>
+        <SuggestionPrimitive.Title />
+      </button>
+    </SuggestionPrimitive.Trigger>
+  );
+};
+```
+
+<ParametersTable
+  type="SuggestionPrimitiveTriggerProps"
+  parameters={[
+    {
+      name: "send",
+      type: "boolean",
+      description:
+        "When true, automatically sends the message. When false, only populates the composer with the suggestion's prompt.",
+    },
+    {
+      name: "clearComposer",
+      type: "boolean",
+      default: "true",
+      description:
+        "When send is false, determines whether to clear the composer before adding the suggestion (true) or append to existing text (false).",
+    },
+    {
+      name: "asChild",
+      type: "boolean",
+      default: "false",
+      description: "Merge props with child element instead of rendering a wrapper button.",
+    },
+    {
+      name: "className",
+      type: "string",
+      description: "CSS class name.",
+    },
+  ]}
+/>
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+## Usage Example
+
+```tsx
+import {
+  ThreadPrimitive,
+  SuggestionPrimitive,
+} from "@assistant-ui/react";
+
+const ThreadWelcome = () => {
+  return (
+    <div>
+      <h1>How can I help you?</h1>
+      <div className="grid grid-cols-2 gap-2">
+        <ThreadPrimitive.Suggestions
+          components={{
+            Suggestion: SuggestionCard,
+          }}
+        />
+      </div>
+    </div>
+  );
+};
+
+const SuggestionCard = () => {
+  return (
+    <SuggestionPrimitive.Trigger send asChild>
+      <button className="flex flex-col gap-1 rounded-lg border p-3 hover:bg-muted">
+        <span className="font-medium">
+          <SuggestionPrimitive.Title />
+        </span>
+        <span className="text-muted-foreground text-sm">
+          <SuggestionPrimitive.Description />
+        </span>
+      </button>
+    </SuggestionPrimitive.Trigger>
+  );
+};
+```
+
+## See Also
+
+- [Suggestions Guide](/docs/guides/suggestions) - Configure and customize suggestions
+- [ThreadPrimitive.Suggestions](/docs/reference/api-reference/primitives/thread#threadprimitive-suggestions) - Render all suggestions

package/.docs/raw/docs/(reference)/api-reference/primitives/thread-list-item-more.mdx

@@ -0,0 +1,221 @@
+---
+title: ThreadListItemMorePrimitive
+description: Dropdown menu for additional thread actions like archive and delete.
+---
+
+A dropdown menu for displaying additional actions on a thread list item. Built on top of [Radix UI Dropdown Menu](https://www.radix-ui.com/primitives/docs/components/dropdown-menu).
+
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
+
+## Anatomy
+
+```tsx
+import {
+  ThreadListItemPrimitive,
+  ThreadListItemMorePrimitive
+} from "@assistant-ui/react";
+
+const ThreadListItemMore = () => (
+  <ThreadListItemMorePrimitive.Root>
+    <ThreadListItemMorePrimitive.Trigger>
+      More options
+    </ThreadListItemMorePrimitive.Trigger>
+    <ThreadListItemMorePrimitive.Content>
+      <ThreadListItemPrimitive.Archive asChild>
+        <ThreadListItemMorePrimitive.Item>
+          Archive
+        </ThreadListItemMorePrimitive.Item>
+      </ThreadListItemPrimitive.Archive>
+      <ThreadListItemMorePrimitive.Separator />
+      <ThreadListItemPrimitive.Delete asChild>
+        <ThreadListItemMorePrimitive.Item>
+          Delete
+        </ThreadListItemMorePrimitive.Item>
+      </ThreadListItemPrimitive.Delete>
+    </ThreadListItemMorePrimitive.Content>
+  </ThreadListItemMorePrimitive.Root>
+);
+```
+
+## API Reference
+
+### Root
+
+Contains all parts of the dropdown menu. Wraps Radix UI's `DropdownMenu.Root`.
+
+<ParametersTable
+  type="ThreadListItemMorePrimitiveRootProps"
+  parameters={[
+    {
+      name: "open",
+      type: "boolean",
+      description: "The controlled open state of the dropdown menu.",
+    },
+    {
+      name: "defaultOpen",
+      type: "boolean",
+      description: "The open state of the dropdown menu when it is initially rendered.",
+    },
+    {
+      name: "onOpenChange",
+      type: "(open: boolean) => void",
+      description: "Event handler called when the open state changes.",
+    },
+    {
+      name: "modal",
+      type: "boolean",
+      default: "true",
+      description: "Whether the dropdown menu should be modal.",
+    },
+  ]}
+/>
+
+### Trigger
+
+The button that toggles the dropdown menu. Wraps Radix UI's `DropdownMenu.Trigger`.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadListItemMorePrimitiveTriggerProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### Content
+
+The container for the dropdown menu items. Wraps Radix UI's `DropdownMenu.Portal` and `DropdownMenu.Content`.
+
+<ParametersTable
+  type="ThreadListItemMorePrimitiveContentProps"
+  parameters={[
+    {
+      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.",
+    },
+  ]}
+/>
+
+### Item
+
+A menu item within the dropdown. Wraps Radix UI's `DropdownMenu.Item`.
+
+This primitive renders a `<div>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadListItemMorePrimitiveItemProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+    {
+      name: "disabled",
+      type: "boolean",
+      description: "Whether the item is disabled.",
+    },
+    {
+      name: "onSelect",
+      type: "(event: Event) => void",
+      description: "Event handler called when the user selects an item.",
+    },
+  ]}
+/>
+
+### Separator
+
+A visual separator between menu items. Wraps Radix UI's `DropdownMenu.Separator`.
+
+<ParametersTable
+  type="ThreadListItemMorePrimitiveSeparatorProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+## Examples
+
+### With Icons
+
+```tsx
+import { ArchiveIcon, TrashIcon, MoreHorizontalIcon } from "lucide-react";
+
+const ThreadListItemMore = () => (
+  <ThreadListItemMorePrimitive.Root>
+    <ThreadListItemMorePrimitive.Trigger asChild>
+      <button className="icon-button">
+        <MoreHorizontalIcon />
+      </button>
+    </ThreadListItemMorePrimitive.Trigger>
+    <ThreadListItemMorePrimitive.Content
+      side="bottom"
+      align="start"
+      className="dropdown-content"
+    >
+      <ThreadListItemPrimitive.Archive asChild>
+        <ThreadListItemMorePrimitive.Item className="dropdown-item">
+          <ArchiveIcon className="icon" />
+          Archive
+        </ThreadListItemMorePrimitive.Item>
+      </ThreadListItemPrimitive.Archive>
+    </ThreadListItemMorePrimitive.Content>
+  </ThreadListItemMorePrimitive.Root>
+);
+```
+
+### Complete Thread List Item with More Menu
+
+```tsx
+const ThreadListItem = () => (
+  <ThreadListItemPrimitive.Root className="thread-item">
+    <ThreadListItemPrimitive.Trigger className="thread-trigger">
+      <ThreadListItemPrimitive.Title fallback="New Chat" />
+    </ThreadListItemPrimitive.Trigger>
+
+    <ThreadListItemMorePrimitive.Root>
+      <ThreadListItemMorePrimitive.Trigger asChild>
+        <button className="more-button">
+          <MoreHorizontalIcon />
+        </button>
+      </ThreadListItemMorePrimitive.Trigger>
+      <ThreadListItemMorePrimitive.Content>
+        <ThreadListItemPrimitive.Archive asChild>
+          <ThreadListItemMorePrimitive.Item>
+            <ArchiveIcon />
+            Archive
+          </ThreadListItemMorePrimitive.Item>
+        </ThreadListItemPrimitive.Archive>
+      </ThreadListItemMorePrimitive.Content>
+    </ThreadListItemMorePrimitive.Root>
+  </ThreadListItemPrimitive.Root>
+);
+```

package/.docs/raw/docs/{api-reference/primitives/ThreadListItem.mdx → (reference)/api-reference/primitives/thread-list-item.mdx}

@@ -1,10 +1,11 @@
 ---
 title: ThreadListItemPrimitive
+description: Individual thread item with title, archive, and delete controls.
 ---
 
 A single thread item within a thread list.
 
-import { ParametersTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 

package/.docs/raw/docs/{api-reference/primitives/ThreadList.mdx → (reference)/api-reference/primitives/thread-list.mdx}

@@ -1,10 +1,11 @@
 ---
 title: ThreadListPrimitive
+description: Display and manage multiple conversation threads with create and archive actions.
 ---
 
 Displays a list of conversation threads.
 
-import { ParametersTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 

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

@@ -1,10 +1,11 @@
 ---
 title: ThreadPrimitive
+description: Primitives for the message list, viewport, and welcome screen.
 ---
 
 A conversation between a user and an assistant.
 
-import { ParametersTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 
@@ -182,57 +183,46 @@ This primitive renders a `<button>` element unless `asChild` is set.
   ]}
 />
 
-### `ThreadPrimitive.Suggestion`
+### `ThreadPrimitive.Suggestions`
 
-Shows a suggestion to the user. When the user clicks on the suggestion, the composer's value is set to the suggestion's prompt.
-
-This primitive renders a `<button>` element unless `asChild` is set.
+Renders all configured suggestions from the Suggestions API. Each suggestion is rendered using the provided Suggestion component.
 
 ```tsx
-import { ThreadPrimitive } from "@assistant-ui/react";
+import { ThreadPrimitive, SuggestionPrimitive } from "@assistant-ui/react";
 
-const Suggestion = () => {
+const SuggestionsList = () => {
   return (
-    <ThreadPrimitive.Suggestion
-      prompt="I need help with product search"
-      send
-    />
+    <div className="grid grid-cols-2 gap-2">
+      <ThreadPrimitive.Suggestions
+        components={{
+          Suggestion: SuggestionItem,
+        }}
+      />
+    </div>
   );
 };
+
+const SuggestionItem = () => (
+  <SuggestionPrimitive.Trigger send asChild>
+    <button className="p-3 border rounded">
+      <SuggestionPrimitive.Title />
+      <SuggestionPrimitive.Description />
+    </button>
+  </SuggestionPrimitive.Trigger>
+);
 ```
 
 <ParametersTable
-  type="ThreadPrimitiveSuggestionProps"
+  type="ThreadPrimitiveSuggestionsProps"
   parameters={[
     {
-      name: "prompt",
-      type: "string",
-      description: "The suggestion's prompt.",
-    },
-    {
-      name: "send",
-      type: "boolean",
-      description:
-        "When true, automatically sends the message. When false, replaces or appends the composer text with the suggestion - depending on the value of `clearComposer`",
-    },
-    {
-      name: "clearComposer",
-      type: "boolean",
-      default: "true",
-      description:
-        "Whether to clear the composer after sending. When send is set to false, determines if composer text is replaced with suggestion (true, default), or if the suggestion's prompt is appended to the composer text (false).",
-    },
-    {
-      name: "autoSend",
-      type: "boolean",
-      deprecated: true,
-      description: "Deprecated. Use 'send' instead.",
-    },
-    {
-      name: "method",
-      type: "'replace'",
-      deprecated: true,
-      description: "Deprecated. This parameter is no longer used.",
+      name: "components",
+      type: "{ Suggestion: ComponentType }",
+      description: "Custom component to render each suggestion.",
     },
   ]}
 />
+
+<Callout type="info">
+Configure suggestions using the `Suggestions()` API in your runtime provider. See the [Suggestions guide](/docs/guides/suggestions) for details.
+</Callout>

package/.docs/raw/docs/{api-reference/runtimes/AssistantRuntime.mdx → (reference)/api-reference/runtimes/assistant-runtime.mdx}

@@ -1,8 +1,9 @@
 ---
 title: AssistantRuntime
+description: Root runtime for managing threads, tool UIs, and assistant state.
 ---
 
-import { ParametersTable } from "@/components/docs";
+import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 import { AssistantRuntime, AssistantToolUIsState } from "@/generated/typeDocs";
 
 The `AssistantRuntime` is the root runtime of the application.