@assistant-ui/mcp-docs-server 0.1.31 → 0.1.33

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

@@ -0,0 +1,65 @@
+---
+title: QueueItemPrimitive
+description: Queue item primitives for rendering pending assistant-ui thread operations, optimistic work, and runtime queue state.
+---
+
+import { QueueItemPrimitiveRemoveProps, QueueItemPrimitiveSteerProps, QueueItemPrimitiveTextProps } from "@/generated/typeDocs";
+import { QueueItemPrimitive as QueueItemPrimitiveDocs } from "@/generated/primitiveDocs";
+
+{/* AUTO-GENERATED PAGE by scripts/generate-api-reference.mts */}
+{/* Do not edit manually. */}
+
+{/* api-reference:start */}
+{/* AUTO-GENERATED by scripts/generate-api-reference.mts */}
+{/* Do not edit this block manually. */}
+
+## API Reference
+
+### Text
+
+{QueueItemPrimitiveDocs.Text?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {QueueItemPrimitiveDocs.Text.deprecated}
+  </Callout>
+)}
+
+{QueueItemPrimitiveDocs.Text?.description}
+
+{QueueItemPrimitiveDocs.Text?.element && (
+  <p>This primitive renders a <code>{`<${QueueItemPrimitiveDocs.Text?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...QueueItemPrimitiveTextProps} />
+
+### Steer
+
+{QueueItemPrimitiveDocs.Steer?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {QueueItemPrimitiveDocs.Steer.deprecated}
+  </Callout>
+)}
+
+{QueueItemPrimitiveDocs.Steer?.description}
+
+{QueueItemPrimitiveDocs.Steer?.element && (
+  <p>This primitive renders a <code>{`<${QueueItemPrimitiveDocs.Steer?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...QueueItemPrimitiveSteerProps} />
+
+### Remove
+
+{QueueItemPrimitiveDocs.Remove?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {QueueItemPrimitiveDocs.Remove.deprecated}
+  </Callout>
+)}
+
+{QueueItemPrimitiveDocs.Remove?.description}
+
+{QueueItemPrimitiveDocs.Remove?.element && (
+  <p>This primitive renders a <code>{`<${QueueItemPrimitiveDocs.Remove?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...QueueItemPrimitiveRemoveProps} />
+{/* api-reference:end */}

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

@@ -1,10 +1,17 @@
 ---
 title: SelectionToolbarPrimitive
-description: A floating toolbar that appears when text is selected within a message.
+description: Selection toolbar primitives for quote, copy, and contextual actions on selected chat text.
 ---
 
-A floating toolbar that appears near the user's text selection within a message. Used to provide contextual actions like quoting selected text.
+import { SelectionToolbarPrimitiveQuoteProps, SelectionToolbarPrimitiveRootProps } from "@/generated/typeDocs";
+import { SelectionToolbarPrimitive as SelectionToolbarPrimitiveDocs } from "@/generated/primitiveDocs";
 
+{/* AUTO-GENERATED PAGE by scripts/generate-api-reference.mts */}
+{/* Do not edit manually. */}
+
+For examples and usage patterns, see [SelectionToolbar](/docs/primitives/selection-toolbar).
+
+{/* api-manual:start */}
 ## Anatomy
 
 ```tsx
@@ -25,37 +32,43 @@ Place this component inside `ThreadPrimitive.Root`:
   <FloatingSelectionToolbar />
 </ThreadPrimitive.Root>
 ```
+{/* api-manual:end */}
+
+{/* api-reference:start */}
+{/* AUTO-GENERATED by scripts/generate-api-reference.mts */}
+{/* Do not edit this block manually. */}
 
 ## API Reference
 
 ### Root
 
-A floating container that renders as a portal positioned above the text selection. Only renders when there is a valid text selection within a single message.
+{SelectionToolbarPrimitiveDocs.Root?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {SelectionToolbarPrimitiveDocs.Root.deprecated}
+  </Callout>
+)}
 
-This primitive renders a `<div>` element.
+{SelectionToolbarPrimitiveDocs.Root?.description}
 
-**Behavior:**
+{SelectionToolbarPrimitiveDocs.Root?.element && (
+  <p>This primitive renders a <code>{`<${SelectionToolbarPrimitiveDocs.Root?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-- Listens for `mouseup` and `keyup` events to detect completed selections
-- Validates the selection is within a single message using `data-message-id` attributes
-- Renders a portal with `position: fixed`, centered above the selection
-- Prevents `mousedown` from clearing the text selection when clicking the toolbar
-- Hides automatically on scroll or when the selection is cleared
-- Cross-message selections are ignored
+<ParametersTable {...SelectionToolbarPrimitiveRootProps} />
 
 ### Quote
 
-A button that captures the currently selected text and sets it as a quote in the thread composer.
-
-This primitive renders a `<button>` element.
+{SelectionToolbarPrimitiveDocs.Quote?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {SelectionToolbarPrimitiveDocs.Quote.deprecated}
+  </Callout>
+)}
 
-**Behavior:**
+{SelectionToolbarPrimitiveDocs.Quote?.description}
 
-- Reads selection info from the Root context (not `window.getSelection()`)
-- Calls `composer.setQuote({ text, messageId })` on the thread composer
-- Clears the text selection after quoting
-- Disabled when no selection info is available
+{SelectionToolbarPrimitiveDocs.Quote?.element && (
+  <p>This primitive renders a <code>{`<${SelectionToolbarPrimitiveDocs.Quote?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-<Callout type="info">
-See the [Quoting guide](/docs/guides/quoting) for a complete walkthrough including composer preview, sent message display, and backend handling.
-</Callout>
+<ParametersTable {...SelectionToolbarPrimitiveQuoteProps} />
+{/* api-reference:end */}

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

@@ -1,150 +1,67 @@
 ---
 title: SuggestionPrimitive
+description: Suggestion primitives for rendering starter prompts, follow-up actions, and composer suggestions in assistant-ui threads.
 ---
 
+import { SuggestionPrimitiveDescriptionProps, SuggestionPrimitiveTitleProps, SuggestionPrimitiveTriggerProps } from "@/generated/typeDocs";
+import { SuggestionPrimitive as SuggestionPrimitiveDocs } from "@/generated/primitiveDocs";
 
-Primitives for rendering individual suggestions. These primitives must be used within a suggestion context provided by `ThreadPrimitive.Suggestions`.
+{/* AUTO-GENERATED PAGE by scripts/generate-api-reference.mts */}
+{/* Do not edit manually. */}
 
-## Quick Reference
+For examples and usage patterns, see [Suggestion](/docs/primitives/suggestion).
 
-```tsx
-import { SuggestionPrimitive } from "@assistant-ui/react";
-
-<SuggestionPrimitive.Title />
-<SuggestionPrimitive.Description />
-<SuggestionPrimitive.Trigger />
-```
+{/* api-reference:start */}
+{/* AUTO-GENERATED by scripts/generate-api-reference.mts */}
+{/* Do not edit this block manually. */}
 
 ## 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>
-          {() => <SuggestionCard />}
-        </ThreadPrimitive.Suggestions>
-      </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/api-reference/primitives/thread#threadprimitive-suggestions) - Render all suggestions
+### Title
+
+{SuggestionPrimitiveDocs.Title?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {SuggestionPrimitiveDocs.Title.deprecated}
+  </Callout>
+)}
+
+{SuggestionPrimitiveDocs.Title?.description}
+
+{SuggestionPrimitiveDocs.Title?.element && (
+  <p>This primitive renders a <code>{`<${SuggestionPrimitiveDocs.Title?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...SuggestionPrimitiveTitleProps} />
+
+### Description
+
+{SuggestionPrimitiveDocs.Description?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {SuggestionPrimitiveDocs.Description.deprecated}
+  </Callout>
+)}
+
+{SuggestionPrimitiveDocs.Description?.description}
+
+{SuggestionPrimitiveDocs.Description?.element && (
+  <p>This primitive renders a <code>{`<${SuggestionPrimitiveDocs.Description?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...SuggestionPrimitiveDescriptionProps} />
+
+### Trigger
+
+{SuggestionPrimitiveDocs.Trigger?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {SuggestionPrimitiveDocs.Trigger.deprecated}
+  </Callout>
+)}
+
+{SuggestionPrimitiveDocs.Trigger?.description}
+
+{SuggestionPrimitiveDocs.Trigger?.element && (
+  <p>This primitive renders a <code>{`<${SuggestionPrimitiveDocs.Trigger?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...SuggestionPrimitiveTriggerProps} />
+{/* api-reference:end */}

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

@@ -1,11 +1,15 @@
 ---
 title: ThreadListItemMorePrimitive
-description: Dropdown menu for additional thread actions like archive and delete.
+description: Overflow menu primitives for secondary thread list item actions in custom assistant-ui sidebars.
 ---
 
-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 { ThreadListItemMorePrimitiveContentProps, ThreadListItemMorePrimitiveItemProps, ThreadListItemMorePrimitiveRootProps, ThreadListItemMorePrimitiveSeparatorProps, ThreadListItemMorePrimitiveTriggerProps } from "@/generated/typeDocs";
+import { ThreadListItemMorePrimitive as ThreadListItemMorePrimitiveDocs } from "@/generated/primitiveDocs";
 
+{/* AUTO-GENERATED PAGE by scripts/generate-api-reference.mts */}
+{/* Do not edit manually. */}
 
+{/* api-manual:start */}
 ## Anatomy
 
 ```tsx
@@ -35,186 +39,91 @@ const ThreadListItemMore = () => (
   </ThreadListItemMorePrimitive.Root>
 );
 ```
+{/* api-manual:end */}
+
+{/* api-reference:start */}
+{/* AUTO-GENERATED by scripts/generate-api-reference.mts */}
+{/* Do not edit this block manually. */}
 
 ## 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.",
-    },
-  ]}
-/>
+{ThreadListItemMorePrimitiveDocs.Root?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListItemMorePrimitiveDocs.Root.deprecated}
+  </Callout>
+)}
+
+{ThreadListItemMorePrimitiveDocs.Root?.description}
+
+{ThreadListItemMorePrimitiveDocs.Root?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListItemMorePrimitiveDocs.Root?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...ThreadListItemMorePrimitiveRootProps} />
 
 ### Trigger
 
-The button that toggles the dropdown menu. Wraps Radix UI's `DropdownMenu.Trigger`.
+{ThreadListItemMorePrimitiveDocs.Trigger?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListItemMorePrimitiveDocs.Trigger.deprecated}
+  </Callout>
+)}
 
-This primitive renders a `<button>` element unless `asChild` is set.
+{ThreadListItemMorePrimitiveDocs.Trigger?.description}
 
-<ParametersTable
-  type="ThreadListItemMorePrimitiveTriggerProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
+{ThreadListItemMorePrimitiveDocs.Trigger?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListItemMorePrimitiveDocs.Trigger?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...ThreadListItemMorePrimitiveTriggerProps} />
 
 ### 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.",
-    },
-  ]}
-/>
+{ThreadListItemMorePrimitiveDocs.Content?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListItemMorePrimitiveDocs.Content.deprecated}
+  </Callout>
+)}
 
-### Item
+{ThreadListItemMorePrimitiveDocs.Content?.description}
 
-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.",
-    },
-  ]}
-/>
+{ThreadListItemMorePrimitiveDocs.Content?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListItemMorePrimitiveDocs.Content?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-### Separator
+<ParametersTable {...ThreadListItemMorePrimitiveContentProps} />
 
-A visual separator between menu items. Wraps Radix UI's `DropdownMenu.Separator`.
+### Item
 
-<ParametersTable
-  type="ThreadListItemMorePrimitiveSeparatorProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
+{ThreadListItemMorePrimitiveDocs.Item?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListItemMorePrimitiveDocs.Item.deprecated}
+  </Callout>
+)}
 
-## Examples
+{ThreadListItemMorePrimitiveDocs.Item?.description}
 
-### With Icons
+{ThreadListItemMorePrimitiveDocs.Item?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListItemMorePrimitiveDocs.Item?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-```tsx
-import { ArchiveIcon, TrashIcon, MoreHorizontalIcon } from "lucide-react";
+<ParametersTable {...ThreadListItemMorePrimitiveItemProps} />
 
-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>
-);
-```
+### Separator
 
-### Complete Thread List Item with More Menu
+{ThreadListItemMorePrimitiveDocs.Separator?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListItemMorePrimitiveDocs.Separator.deprecated}
+  </Callout>
+)}
 
-```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>
-);
-```
+{ThreadListItemMorePrimitiveDocs.Separator?.description}
+
+{ThreadListItemMorePrimitiveDocs.Separator?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListItemMorePrimitiveDocs.Separator?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...ThreadListItemMorePrimitiveSeparatorProps} />
+{/* api-reference:end */}