@assistant-ui/mcp-docs-server 0.1.7 → 0.1.8

package/.docs/raw/docs/api-reference/primitives/Thread.mdx

@@ -104,6 +104,65 @@ Renders all messages. This primitive renders a separate component for each messa
   ]}
 />
 
+### MessageByIndex
+
+Renders a single message at the specified index in the current thread.
+
+```tsx
+<ThreadPrimitive.MessageByIndex
+  index={0}
+  components={{
+    UserMessage: MyUserMessage,
+    AssistantMessage: MyAssistantMessage
+  }}
+/>
+```
+
+<ParametersTable
+  type="ThreadPrimitive.MessageByIndex.Props"
+  parameters={[
+    {
+      name: "index",
+      type: "number",
+      required: true,
+      description: "The index of the message to render.",
+    },
+    {
+      name: "components",
+      type: "MessageComponents",
+      description: "The component configuration for rendering the message.",
+      children: [
+        {
+          type: "MessageComponents",
+          parameters: [
+            {
+              name: "Message",
+              type: "ComponentType",
+              description: "The component to render for each message.",
+            },
+            {
+              name: "UserMessage",
+              type: "ComponentType",
+              description: "The component to render for user messages.",
+            },
+            {
+              name: "EditComposer",
+              type: "ComponentType",
+              description:
+                "The component to render for user messages that are being edited.",
+            },
+            {
+              name: "AssistantMessage",
+              type: "ComponentType",
+              description: "The component to render for assistant messages.",
+            },
+          ],
+        },
+      ],
+    },
+  ]}
+/>
+
 ### Empty
 
 Renders children only when there are no messages.

package/.docs/raw/docs/api-reference/primitives/ThreadList.mdx

@@ -0,0 +1,128 @@
+---
+title: ThreadListPrimitive
+---
+
+Displays a list of conversation threads.
+
+import { ParametersTable } from "@/components/docs";
+
+## Anatomy
+
+```tsx
+import { ThreadListPrimitive } from "@assistant-ui/react";
+
+const ThreadList = () => (
+  <ThreadListPrimitive.Root>
+    <ThreadListPrimitive.New />
+    <ThreadListPrimitive.Items
+      components={{
+        ThreadListItem: MyThreadListItem
+      }}
+    />
+  </ThreadListPrimitive.Root>
+);
+```
+
+## API Reference
+
+### Root
+
+Contains all parts of the thread list.
+
+This primitive renders a `<div>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadListPrimitiveRootProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### New
+
+A button to create a new thread.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadListPrimitiveNewProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### Items
+
+Renders all items in the thread list.
+
+<ParametersTable
+  type="ThreadListPrimitive.Items.Props"
+  parameters={[
+    {
+      name: "archived",
+      type: "boolean",
+      default: "false",
+      description: "Whether to show archived threads instead of active threads.",
+    },
+    {
+      name: "components",
+      type: "ThreadListItemComponents",
+      required: true,
+      description: "The components to render for each thread list item.",
+      children: [
+        {
+          type: "ThreadListItemComponents",
+          parameters: [
+            {
+              name: "ThreadListItem",
+              type: "ComponentType",
+              required: true,
+              description: "The component to render for each thread in the list.",
+            },
+          ],
+        },
+      ],
+    },
+  ]}
+/>
+
+### ItemByIndex
+
+Renders a single thread list item at the specified index.
+
+```tsx
+<ThreadListPrimitive.ItemByIndex
+  index={0}
+  components={{
+    ThreadListItem: MyThreadListItem
+  }}
+/>
+```
+
+<ParametersTable
+  type="ThreadListPrimitive.ItemByIndex.Props"
+  parameters={[
+    {
+      name: "index",
+      type: "number",
+      required: true,
+      description: "The index of the thread list item to render.",
+    },
+    {
+      name: "archived",
+      type: "boolean",
+      default: "false",
+      description: "Whether to render from archived threads instead of active threads.",
+    },
+    {
+      name: "components",
+      type: "ThreadListItemComponents",
+      required: true,
+      description: "The components to render for the thread list item.",
+    },
+  ]}
+/>

package/.docs/raw/docs/api-reference/primitives/ThreadListItem.mdx

@@ -0,0 +1,160 @@
+---
+title: ThreadListItemPrimitive
+---
+
+A single thread item within a thread list.
+
+import { ParametersTable } from "@/components/docs";
+
+## Anatomy
+
+```tsx
+import { ThreadListItemPrimitive } from "@assistant-ui/react";
+
+const ThreadListItem = () => (
+  <ThreadListItemPrimitive.Root>
+    <ThreadListItemPrimitive.Trigger>
+      <ThreadListItemPrimitive.Title />
+    </ThreadListItemPrimitive.Trigger>
+    <ThreadListItemPrimitive.Archive />
+    <ThreadListItemPrimitive.Unarchive />
+    <ThreadListItemPrimitive.Delete />
+  </ThreadListItemPrimitive.Root>
+);
+```
+
+## API Reference
+
+### Root
+
+Contains all parts of the thread list item.
+
+This primitive renders a `<div>` element unless `asChild` is set. It automatically adds `data-active="true"` and `aria-current="true"` attributes when the thread is the currently active thread.
+
+<ParametersTable
+  type="ThreadListItemPrimitiveRootProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### Trigger
+
+A button that switches to the thread when clicked.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadListItemPrimitiveTriggerProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### Title
+
+Displays the title of the thread.
+
+This primitive renders a `<span>` element unless `asChild` is set. The title is automatically derived from the first user message in the thread.
+
+<ParametersTable
+  type="ThreadListItemPrimitiveTitleProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### Archive
+
+A button to archive the thread. Only shown for non-archived threads.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadListItemPrimitiveArchiveProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### Unarchive
+
+A button to unarchive the thread. Only shown for archived threads.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadListItemPrimitiveUnarchiveProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### Delete
+
+A button to permanently delete the thread.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadListItemPrimitiveDeleteProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+## Examples
+
+### Basic Thread List Item
+
+```tsx
+const MyThreadListItem = () => {
+  return (
+    <ThreadListItemPrimitive.Root className="thread-item">
+      <ThreadListItemPrimitive.Trigger className="thread-trigger">
+        <ThreadListItemPrimitive.Title />
+      </ThreadListItemPrimitive.Trigger>
+      <div className="thread-actions">
+        <ThreadListItemPrimitive.Archive>
+          Archive
+        </ThreadListItemPrimitive.Archive>
+        <ThreadListItemPrimitive.Delete>
+          Delete
+        </ThreadListItemPrimitive.Delete>
+      </div>
+    </ThreadListItemPrimitive.Root>
+  );
+};
+```
+
+### Archived Thread List Item
+
+```tsx
+const ArchivedThreadListItem = () => {
+  return (
+    <ThreadListItemPrimitive.Root className="archived-thread-item">
+      <ThreadListItemPrimitive.Trigger>
+        <ThreadListItemPrimitive.Title />
+      </ThreadListItemPrimitive.Trigger>
+      <ThreadListItemPrimitive.Unarchive>
+        Restore
+      </ThreadListItemPrimitive.Unarchive>
+      <ThreadListItemPrimitive.Delete>
+        Delete Permanently
+      </ThreadListItemPrimitive.Delete>
+    </ThreadListItemPrimitive.Root>
+  );
+};
+```

package/.docs/raw/docs/api-reference/runtimes/AssistantRuntime.mdx

@@ -20,14 +20,3 @@ const runtime = useAssistantRuntime();
 ### Tool UI Registry
 
 The tool UI registry is part of the assistant runtime. It allows you to display custom UI for tool calls, enabling generative UI.
-
-#### `useToolUIs`
-
-```tsx
-import { useToolUIs } from "@assistant-ui/react";
-
-const toolUIs = useToolUIs();
-const webSearchToolUI = useToolUIs((m) => m.getToolUI("web_search"));
-```
-
-<ParametersTable {...AssistantToolUIsState} />

package/.docs/raw/docs/api-reference/runtimes/ComposerRuntime.mdx

@@ -7,15 +7,15 @@ The composer runtime allows you to view or edit anything related to how new info
 import { ParametersTable } from "@/components/docs";
 import { ComposerRuntime, ThreadComposerRuntime, ThreadComposerState, EditComposerState } from "@/generated/typeDocs";
 
-### `useComposer`
+### `useComposerRuntime`
 
 Grabs the nearest composer (whether it’s the edit composer or the thread’s composer):
 
 ```tsx
 // Example
-import { useComposer } from "@assistant-ui/react";
+import { useComposerRuntime } from "@assistant-ui/react";
 
-const composerRuntime = useComposer();
+const composerRuntime = useComposerRuntime();
 
 // set the text
 composerRuntime.setText("Hello from the composer runtime");