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

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

@@ -0,0 +1,152 @@
+---
+title: SuggestionPrimitive
+---
+
+
+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

@@ -5,7 +5,6 @@ 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
 

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

@@ -5,7 +5,6 @@ description: Individual thread item with title, archive, and delete controls.
 
 A single thread item within a thread list.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 
@@ -158,4 +157,4 @@ const ArchivedThreadListItem = () => {
     </ThreadListItemPrimitive.Root>
   );
 };
-```
+```

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

@@ -5,7 +5,6 @@ description: Display and manage multiple conversation threads with create and ar
 
 Displays a list of conversation threads.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 
@@ -126,4 +125,4 @@ Renders a single thread list item at the specified index.
       description: "The components to render for the thread list item.",
     },
   ]}
-/>
+/>

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

@@ -5,7 +5,6 @@ description: Primitives for the message list, viewport, and welcome screen.
 
 A conversation between a user and an assistant.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 
@@ -183,57 +182,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/(reference)/api-reference/runtimes/assistant-runtime.mdx

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

package/.docs/raw/docs/(reference)/api-reference/runtimes/attachment-runtime.mdx

@@ -3,11 +3,10 @@ title: AttachmentRuntime
 description: Hooks for accessing attachment state in composer and messages.
 ---
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 import {
   ComposerAttachmentState,
   MessageAttachmentState,
-} from "@/components/docs/tables/parameters/context";
+} from "@/components/docs/parameters-table.context";
 
 ### `useAttachment`
 

package/.docs/raw/docs/(reference)/api-reference/runtimes/composer-runtime.mdx

@@ -5,7 +5,6 @@ description: Runtime for programmatically controlling the message composer.
 
 The composer runtime allows you to view or edit anything related to how new information is added and sent. For instance you can use the composer runtime to read the state, add attachments, update text, send a message, etc.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 import { ComposerRuntime, ThreadComposerRuntime, ThreadComposerState, EditComposerState } from "@/generated/typeDocs";
 
 ### `useComposerRuntime`
@@ -21,7 +20,7 @@ const composerRuntime = useComposerRuntime();
 // set the text
 composerRuntime.setText("Hello from the composer runtime");
 
-// send whatever is in the composer 
+// send whatever is in the composer
 composerRuntime.send();
 
 // get the current text in the composer state
@@ -45,7 +44,7 @@ const threadComposerRuntime = useThreadComposer();
 // set the text
 threadComposerRuntime.setText("Hello from the thread composer runtime");
 
-// send whatever is in the thread composer 
+// send whatever is in the thread composer
 threadComposerRuntime.send();
 
 // get the current text in the composer state

package/.docs/raw/docs/(reference)/api-reference/runtimes/message-part-runtime.mdx

@@ -3,8 +3,7 @@ title: MessagePartRuntime
 description: Hook for accessing message part state within parts.
 ---
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
-import { MessagePartState } from "@/components/docs/tables/parameters/context";
+import { MessagePartState } from "@/components/docs/parameters-table.context";
 
 ### `useMessagePart`
 

package/.docs/raw/docs/(reference)/api-reference/runtimes/message-runtime.mdx

@@ -3,12 +3,11 @@ title: MessageRuntime
 description: Hooks for accessing message state, utilities, and edit composer.
 ---
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 import {
   MessageState,
   MessageUtilsState,
   EditComposerState,
-} from "@/components/docs/tables/parameters/context";
+} from "@/components/docs/parameters-table.context";
 
 ### `useMessage`
 

package/.docs/raw/docs/(reference)/api-reference/runtimes/thread-list-item-runtime.mdx

@@ -3,7 +3,6 @@ title: ThreadListItemRuntime
 description: Runtime for managing individual thread list items.
 ---
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 import {
   ThreadListItemRuntime,
   ThreadListItemState,

package/.docs/raw/docs/(reference)/api-reference/runtimes/thread-list-runtime.mdx

@@ -3,7 +3,6 @@ title: ThreadListRuntime
 description: Runtime for accessing and managing the list of threads.
 ---
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 import { ThreadListRuntime, ThreadListState } from "@/generated/typeDocs";
 
 ### Access via `useAssistantRuntime`

package/.docs/raw/docs/(reference)/api-reference/runtimes/thread-runtime.mdx

@@ -3,9 +3,8 @@ title: ThreadRuntime
 description: Runtime for thread state, messages, and viewport management.
 ---
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 import { ThreadRuntime, ThreadState } from "@/generated/typeDocs";
-import { ThreadMessagesState, ThreadViewportState } from "@/components/docs/tables/parameters/context";
+import { ThreadViewportState } from "@/components/docs/parameters-table.context";
 
 ### `useThreadRuntime`
 

package/.docs/raw/docs/(reference)/legacy/styled/assistant-modal.mdx

@@ -3,7 +3,6 @@ title: AssistantModal
 description: Chat bubble component for support or Q&A use cases.
 ---
 
-import { InstallCommand } from "@/components/docs/fumadocs/install/install-command";
 
 ## Overview
 

package/.docs/raw/docs/(reference)/legacy/styled/decomposition.mdx

@@ -176,17 +176,17 @@ The button to send or cancel the message.
 
 ```tsx
 import { Composer } from "@assistant-ui/react-ui";
-import { AssistantIf } from "@assistant-ui/react";
+import { AuiIf } from "@assistant-ui/react";
 
 const MyComposerAction: FC = () => {
   return (
     <>
-      <AssistantIf condition={({ thread }) => !thread.isRunning}>
+      <AuiIf condition={({ thread }) => !thread.isRunning}>
         <Composer.Send />
-      </AssistantIf>
-      <AssistantIf condition={({ thread }) => thread.isRunning}>
+      </AuiIf>
+      <AuiIf condition={({ thread }) => thread.isRunning}>
         <Composer.Cancel />
-      </AssistantIf>
+      </AuiIf>
     </>
   );
 };

package/.docs/raw/docs/(reference)/legacy/styled/markdown.mdx

@@ -5,7 +5,6 @@ description: Enable rich text formatting for assistant messages using markdown.
 
 Allow the assistant to display rich text using markdown.
 
-import { InstallCommand } from "@/components/docs/fumadocs/install/install-command";
 
 ## Enabling markdown support
 

package/.docs/raw/docs/(reference)/legacy/styled/thread.mdx

@@ -3,7 +3,6 @@ title: Thread
 description: Full-screen message list and composer UI for chat interfaces.
 ---
 
-import { InstallCommand } from "@/components/docs/fumadocs/install/install-command";
 
 ## Overview