@assistant-ui/mcp-docs-server 0.1.23 → 0.1.25

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

@@ -16,10 +16,6 @@ export const contextColors = {
   "ThreadListItem Context": "#c678dd",
 };
 
-<Callout title="Work in progress" type="warn">
-  This page is under construction. Most links will not work yet.
-</Callout>
-
 ## Cloud
 
 - [`AssistantCloud`](#assistant-cloud)
@@ -93,7 +89,7 @@ export const contextColors = {
       link: "#composer-context",
     },
   ]}
-  docsLink="./context-providers/AssistantRuntimeProvider"
+  docsLink="./context-providers/assistant-runtime-provider"
   tooltip="Provides the highest level context for the assistant-ui"
   props="runtime={runtime}"
 >
@@ -111,7 +107,7 @@ export const contextColors = {
       link: "#MessagePart-context",
     },
   ]}
-  docsLink="./context-providers/TextMessagePartProvider"
+  docsLink="./context-providers/text-message-part-provider"
   tooltip="Provides context for text message parts"
   props="text={text}"
 >
@@ -126,9 +122,7 @@ The context available to components inside `<AssistantRuntimeProvider />`. You u
 
 ### AssistantRuntime
 
-Programmatically access the assistant's state and actions.
-
-- [`useAssistantRuntime`](#use-assistant-runtime)
+Programmatically access the assistant's state and actions via `useAui()`.
 
 ### Instructions
 
@@ -145,10 +139,7 @@ Register tool UIs
 - [`useAssistantTool`](#use-assistant-tool)
 - [`useAssistantToolUI`](#use-assistant-tool-ui)
 
-Programmatically access the list of registered tool UIs (Experimental)
-
-- [`useToolUIs`](#use-tool-uis)
-- [`useToolUIsStore`](#use-tool-uis-store)
+Programmatically access the list of registered tool UIs via `useAuiState((s) => s.tools)` and `useAui().tools()`.
 
 ### ThreadListPrimitive
 
@@ -191,13 +182,13 @@ The context for a single thread. Currently always corresponds to the runtime's m
 
 Programmatically access the thread's state and actions.
 
-- [`useThread`](#use-thread)
-- [`useThreadComposer`](#use-thread-composer)
-- [`useThreadRuntime`](#use-thread-runtime)
+- State: `useAuiState((s) => s.thread)`
+- Actions: `useAui().thread()`
+- Composer: `useAuiState((s) => s.composer)`
 
 ### ModelContext
 
-- [`useThreadModelContext`](#use-thread-model-context)
+- `useAui().thread().getModelContext()`
 
 ### ThreadViewportStore
 
@@ -239,11 +230,6 @@ A conversation thread.
       docsLink="#thread-primitive-scroll-to-bottom"
       tooltip="Scrolls to the bottom of the thread"
     />
-    <Component
-      name="ThreadPrimitive.Empty"
-      docsLink="#thread-primitive-empty"
-      tooltip="Displayed when the thread is empty"
-    />
     <Component
       name="AuiIf"
       docsLink="#assistant-if"
@@ -294,8 +280,8 @@ Manages the state and actions for the message composer
 
 ### ComposerRuntime
 
-- [`useComposer`](#use-composer)
-- [`useComposerRuntime`](#use-composer-runtime)
+- State: `useAuiState((s) => s.composer)`
+- Actions: `useAui().composer()`
 
 ### ComposerPrimitive
 
@@ -348,14 +334,10 @@ Manages the state and actions for individual messages
 
 ### MessageRuntime
 
-- [`useMessage`](#use-message)
-- [`useEditComposer`](#use-edit-composer)
-- [`useMessageRuntime`](#use-message-runtime)
-
-### MessageUtilsStore
-
-- [`useMessageUtils`](#use-message-utils)
-- [`useMessageUtilsStore`](#use-message-utils-store)
+- State: `useAuiState((s) => s.message)`
+- Edit Composer: `useAuiState((s) => s.message.composer)`
+- Actions: `useAui().message()`
+- Utilities: `useAuiState((s) => s.message.isCopied)` / `useAuiState((s) => s.message.isHovering)`
 
 ### MessagePrimitive
 
@@ -473,10 +455,8 @@ Manages the state and actions for message parts within messages
 
 ### MessagePartRuntime
 
-- [`useMessagePart`](#use-content-part)
-- [`useMessagePartText`](#use-content-part-text)
-- [`useMessagePartReasoning`](#use-content-part-reasoning)
-- [`useMessagePartRuntime`](#use-content-part-runtime)
+- State: `useAuiState((s) => s.part)`
+- Actions: `useAui().part()`
 
 ### MessagePartPrimitive
 
@@ -504,8 +484,8 @@ Manages the state and actions for attachments in messages and composer
 
 ### AttachmentRuntime
 
-- [`useAttachment`](#use-attachment)
-- [`useAttachmentRuntime`](#use-attachment-runtime)
+- State: `useAuiState((s) => s.attachment)`
+- Actions: `useAui().attachment()`
 
 ### AttachmentPrimitive
 
@@ -520,12 +500,12 @@ Manages the state and actions for attachments in messages and composer
     tooltip="Displays the name of the attachment"
   />
   <Component
-    name="AttachmentPrimitive.Delete"
-    docsLink="#attachment-primitive-delete"
-    tooltip="Deletes the attachment"
+    name="AttachmentPrimitive.Remove"
+    docsLink="#attachment-primitive-remove"
+    tooltip="Removes the attachment"
   />
   <Component
-    name="AttachmentPrimitive.Thumb"
+    name="AttachmentPrimitive.unstable_Thumb"
     docsLink="#attachment-primitive-thumb"
     tooltip="Displays a thumbnail of the attachment"
   />
@@ -541,8 +521,8 @@ Manages the state and actions for individual thread list items
 
 ### ThreadListItemRuntime
 
-- [`useThreadListItem`](#use-thread-list-item)
-- [`useThreadListItemRuntime`](#use-thread-list-item-runtime)
+- State: `useAuiState((s) => s.threadListItem)`
+- Actions: `useAui().threadListItem()`
 
 ### ThreadListItem
 
@@ -557,9 +537,9 @@ Manages the state and actions for individual thread list items
     tooltip="Trigger for thread list item actions"
   >
     <Component
-      name="ThreadListItemPrimitive.Name"
-      docsLink="#thread-list-item-primitive-name"
-      tooltip="Displays the name of the thread"
+      name="ThreadListItemPrimitive.Title"
+      docsLink="#thread-list-item-primitive-title"
+      tooltip="Displays the title of the thread"
     />
   </Component>
   <Component
@@ -577,16 +557,11 @@ Manages the state and actions for individual thread list items
     docsLink="#thread-list-item-primitive-delete"
     tooltip="Deletes the thread"
   />
-  <Component
-    name="ThreadListItemPrimitive.Rename"
-    docsLink="#thread-list-item-primitive-rename"
-    tooltip="Renames the thread"
-  />
 </Component>
 
 </ContextLevel>
 
 ## Utilities
 
-- [`useThreadViewportAutoscroll`](#use-thread-viewport-autoscroll)
+- [`useThreadViewportAutoScroll`](#use-thread-viewport-autoscroll)
 - [`useInlineRender`](#use-inline-render)

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

@@ -28,9 +28,9 @@ const AssistantMessageBar = () => (
 
 ## API Reference
 
-### Container
+### Root
 
-Containts all parts of the action bar.
+Contains all parts of the action bar.
 
 This primitive renders a `<div>` element unless `asChild` is set.
 
@@ -62,7 +62,7 @@ This primitive renders a `<div>` element unless `asChild` is set.
           <br />
           <Code>"always"</Code>: always autohide.
           <br />
-          <Code>"not-last"</Code>; only autohide if the message is not the last
+          <Code>"not-last"</Code>: only autohide if the message is not the last
           one in the thread.
         </span>
       ),
@@ -122,7 +122,7 @@ This primitive renders a `<button>` element unless `asChild` is set.
       name: "asChild",
     },
   ]}
-/>{" "}
+/>
 
 ### Copy
 

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

@@ -11,7 +11,7 @@ A modal chat UI usually displayed in the bottom right corner of the screen.
 ```tsx
 import { AssistantModalPrimitive } from "@assistant-ui/react";
 
-const Thread = () => (
+const AssistantModal = () => (
   <AssistantModalPrimitive.Root>
     <AssistantModalPrimitive.Trigger>
       <FloatingAssistantButton />
@@ -117,6 +117,12 @@ This primitive renders a `<div>` element unless `asChild` is set.
       description:
         "Dismiss the assistant modal when the user interacts outside of it.",
     },
+    {
+      name: "portalProps",
+      type: "{ container?: HTMLElement | null; forceMount?: true }",
+      description:
+        "Props to pass to the underlying Radix UI Popover.Portal. Use container to render the modal into a specific DOM node, or forceMount to keep it mounted for animation control.",
+    },
   ]}
 />
 

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

@@ -17,14 +17,14 @@ import { AttachmentPrimitive } from "@assistant-ui/react";
 
 const MyMessageAttachment = () => (
   <AttachmentPrimitive.Root>
-    <AttachmentPrimitive.Thumbnail />
+    <AttachmentPrimitive.unstable_Thumb />
     <AttachmentPrimitive.Name />
   </AttachmentPrimitive.Root>
 );
 
 const MyComposerAttachment = () => (
   <AttachmentPrimitive.Root>
-    <AttachmentPrimitive.Thumbnail />
+    <AttachmentPrimitive.unstable_Thumb />
     <AttachmentPrimitive.Name />
     <AttachmentPrimitive.Remove />
   </AttachmentPrimitive.Root>
@@ -33,11 +33,11 @@ const MyComposerAttachment = () => (
 
 ## API Reference
 
-### Container
+### Root
 
-Containts all parts of the attachment.
+Contains all parts of the attachment.
 
-This primitive renders a `<div>` element unless `asChild` is set.
+This primitive renders a `<div>` element unless `asChild` is set. Accepts all standard HTML div element props.
 
 <ParametersTable
   type="AttachmentPrimitiveRootProps"
@@ -45,21 +45,31 @@ This primitive renders a `<div>` element unless `asChild` is set.
     {
       name: "asChild",
     },
+    {
+      name: "...props",
+      type: "HTMLAttributes<HTMLDivElement>",
+      description: "All standard div element props are forwarded to the underlying element.",
+    },
   ]}
 />
 
-### Thumbnail
+### unstable_Thumb
 
 The thumbnail of the attachment.
 
-This primitive renders a `<div>` element unless `asChild` is set.
+This primitive renders a `<div>` element unless `asChild` is set. Accepts all standard HTML div element props.
 
 <ParametersTable
-  type="AttachmentPrimitiveThumbnailProps"
+  type="AttachmentPrimitiveThumbProps"
   parameters={[
     {
       name: "asChild",
     },
+    {
+      name: "...props",
+      type: "HTMLAttributes<HTMLDivElement>",
+      description: "All standard div element props are forwarded to the underlying element.",
+    },
   ]}
 />
 
@@ -67,15 +77,11 @@ This primitive renders a `<div>` element unless `asChild` is set.
 
 The name of the attachment.
 
-This primitive renders a `<div>` element unless `asChild` is set.
+This primitive renders a text node with the attachment's file name. It accepts no props.
 
 <ParametersTable
   type="AttachmentPrimitiveNameProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
+  parameters={[]}
 />
 
 ### Remove

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

@@ -24,7 +24,7 @@ const BranchPicker = () => (
 
 ### Root
 
-Containts all parts of the branch picker.
+Contains all parts of the branch picker.
 
 This primitive renders a `<div>` element unless `asChild` is set.
 

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

@@ -20,14 +20,16 @@ import { ComposerPrimitive } from "@assistant-ui/react";
 // creating a new message
 const Composer = () => (
   <ComposerPrimitive.Root>
-    <ComposerPrimitive.Quote>
-      <ComposerPrimitive.QuoteText />
-      <ComposerPrimitive.QuoteDismiss />
-    </ComposerPrimitive.Quote>
-    <ComposerPrimitive.Attachments />
-    <ComposerPrimitive.AddAttachment />
-    <ComposerPrimitive.Input />
-    <ComposerPrimitive.Send />
+    <ComposerPrimitive.AttachmentDropzone>
+      <ComposerPrimitive.Quote>
+        <ComposerPrimitive.QuoteText />
+        <ComposerPrimitive.QuoteDismiss />
+      </ComposerPrimitive.Quote>
+      <ComposerPrimitive.Attachments />
+      <ComposerPrimitive.AddAttachment />
+      <ComposerPrimitive.Input />
+      <ComposerPrimitive.Send />
+    </ComposerPrimitive.AttachmentDropzone>
   </ComposerPrimitive.Root>
 );
 
@@ -44,12 +46,12 @@ const EditComposer = () => (
 const ComposerWithDictation = () => (
   <ComposerPrimitive.Root>
     <ComposerPrimitive.Input />
-    <ComposerPrimitive.If dictation={false}>
+    <AuiIf condition={(s) => s.composer.dictation == null}>
       <ComposerPrimitive.Dictate />
-    </ComposerPrimitive.If>
-    <ComposerPrimitive.If dictation>
+    </AuiIf>
+    <AuiIf condition={(s) => s.composer.dictation != null}>
       <ComposerPrimitive.StopDictation />
-    </ComposerPrimitive.If>
+    </AuiIf>
     <ComposerPrimitive.Send />
   </ComposerPrimitive.Root>
 );
@@ -59,7 +61,7 @@ const ComposerWithDictation = () => (
 
 ### Root
 
-Containts all parts of the composer.
+Contains all parts of the composer.
 
 This primitive renders a `<form>` element unless `asChild` is set.
 
@@ -91,6 +93,41 @@ This primitive renders a `<textarea>` element unless `asChild` is set.
       description:
         'Controls how the Enter key submits messages. "enter": plain Enter submits (Shift+Enter for newline). "ctrlEnter": Ctrl/Cmd+Enter submits (plain Enter for newline). "none": keyboard submission disabled.',
     },
+    {
+      name: "cancelOnEscape",
+      type: "boolean",
+      default: "true",
+      description:
+        "Whether to cancel message composition when Escape is pressed.",
+    },
+    {
+      name: "unstable_focusOnRunStart",
+      type: "boolean",
+      default: "true",
+      description:
+        "Whether to automatically focus the input when a new run starts.",
+    },
+    {
+      name: "unstable_focusOnScrollToBottom",
+      type: "boolean",
+      default: "true",
+      description:
+        "Whether to automatically focus the input when scrolling to bottom.",
+    },
+    {
+      name: "unstable_focusOnThreadSwitched",
+      type: "boolean",
+      default: "true",
+      description:
+        "Whether to automatically focus the input when switching threads.",
+    },
+    {
+      name: "addAttachmentOnPaste",
+      type: "boolean",
+      default: "true",
+      description:
+        "Whether to automatically add pasted files as attachments.",
+    },
   ]}
 />
 
@@ -124,12 +161,6 @@ This primitive renders a `<button>` element unless `asChild` is set.
     {
       name: "asChild",
     },
-    {
-      name: "multiple",
-      type: "boolean | undefined",
-      description: "Allow selecting multiple attachments at the same time.",
-      default: "true",
-    },
   ]}
 />
 
@@ -183,9 +214,9 @@ Renders attachments. This primitive renders a separate component for each attach
               description: "The component to render for each file attachment.",
             },
             {
-              name: "Fallback",
+              name: "Attachment",
               type: "ComponentType",
-              description: "The component to render for each attachment type.",
+              description: "The fallback component to render for each attachment type.",
             },
           ],
         },
@@ -237,6 +268,41 @@ This primitive renders a `<button>` element unless `asChild` is set.
     {
       name: "asChild",
     },
+    {
+      name: "multiple",
+      type: "boolean | undefined",
+      description: "Allow selecting multiple attachments at the same time.",
+      default: "true",
+    },
+  ]}
+/>
+
+### AttachmentDropzone
+
+A drag-and-drop zone that accepts file drops and adds them as attachments to the composer.
+
+When a file is dragged over the zone, a `data-dragging="true"` attribute is set on the element, which can be used for styling the active drag state.
+
+This primitive renders a `<div>` element unless `asChild` is set.
+
+```tsx
+<ComposerPrimitive.AttachmentDropzone className="relative data-[dragging]:ring-2">
+  <ComposerPrimitive.Input />
+  <ComposerPrimitive.Send />
+</ComposerPrimitive.AttachmentDropzone>
+```
+
+<ParametersTable
+  type="ComposerPrimitiveAttachmentDropzoneProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+    {
+      name: "disabled",
+      type: "boolean | undefined",
+      description: "When true, drag-and-drop is disabled and files will not be added on drop.",
+    },
   ]}
 />
 
@@ -289,11 +355,11 @@ This primitive renders a `<span>` element.
 
 ```tsx
 {/* Optional: Display interim transcript separately with custom styling */}
-<ComposerPrimitive.If dictation>
+<AuiIf condition={(s) => s.composer.dictation != null}>
   <div className="dictation-preview">
     <ComposerPrimitive.DictationTranscript className="italic text-muted" />
   </div>
-</ComposerPrimitive.If>
+</AuiIf>
 ```
 
 ### Quote
@@ -334,30 +400,18 @@ This primitive renders a `<button>` element unless `asChild` is set.
 See the [Quoting guide](/docs/guides/quoting) for a complete walkthrough including the floating selection toolbar and backend handling.
 </Callout>
 
-### If
+### Conditional Rendering
 
-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.",
-    },
-  ]}
-/>
+Use `AuiIf` for conditional rendering based on composer state:
 
 ```tsx
-<Composer.If editing>{/* rendered if message is being edited */}</Composer.If>
+import { AuiIf } from "@assistant-ui/react";
+
+<AuiIf condition={(s) => s.composer.isEditing}>
+  {/* rendered if message is being edited */}
+</AuiIf>
 
-<Composer.If dictation>{/* rendered if dictation is active */}</Composer.If>
+<AuiIf condition={(s) => s.composer.dictation != null}>
+  {/* rendered if dictation is active */}
+</AuiIf>
 ```