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

package/.docs/raw/docs/(reference)/api-reference/integrations/react-data-stream.mdx

@@ -5,7 +5,6 @@ description: Hooks for connecting to data stream protocol endpoints and Assistan
 
 Data Stream protocol integration for assistant-ui.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## API Reference
 
@@ -157,7 +156,12 @@ const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
 
 ### `toLanguageModelMessages`
 
-Convert assistant-ui messages to language model format.
+Convert assistant-ui messages to AI SDK's `LanguageModelV2Message` format.
+
+<Callout type="info">
+For custom integrations, consider using `toGenericMessages` from `assistant-stream` instead.
+This function is specific to the AI SDK format.
+</Callout>
 
 ```tsx
 import { toLanguageModelMessages } from "@assistant-ui/react-data-stream";
@@ -192,4 +196,45 @@ const languageModelMessages = toLanguageModelMessages(messages, {
       ],
     },
   ]}
-/>
+/>
+
+---
+
+## Framework-Agnostic Utilities
+
+For custom integrations that don't use the AI SDK, use these utilities from `assistant-stream`:
+
+### `toGenericMessages`
+
+Convert thread messages to a framework-agnostic format.
+
+```tsx
+import { toGenericMessages } from "assistant-stream";
+
+const genericMessages = toGenericMessages(messages);
+```
+
+Returns an array of `GenericMessage` which can be one of:
+- `{ role: "system"; content: string }`
+- `{ role: "user"; content: (GenericTextPart | GenericFilePart)[] }`
+- `{ role: "assistant"; content: (GenericTextPart | GenericToolCallPart)[] }`
+- `{ role: "tool"; content: GenericToolResultPart[] }`
+
+### `toToolsJSONSchema`
+
+Convert tool definitions to JSON Schema format.
+
+```tsx
+import { toToolsJSONSchema } from "assistant-stream";
+
+const toolSchemas = toToolsJSONSchema(tools);
+// Returns: Record<string, { description?: string; parameters: JSONSchema7 }>
+```
+
+By default, filters out disabled tools and backend-only tools. Use the `filter` option to customize:
+
+```tsx
+const allTools = toToolsJSONSchema(tools, {
+  filter: () => true, // Include all tools
+});
+```

package/.docs/raw/docs/(reference)/api-reference/integrations/react-hook-form.mdx

@@ -5,7 +5,6 @@ description: React Hook Form integration for AI-assisted form filling.
 
 A React Hook Form integration for @assistant-ui.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## API Reference
 

package/.docs/raw/docs/(reference)/api-reference/integrations/vercel-ai-sdk.mdx

@@ -5,7 +5,6 @@ description: Vercel AI SDK v5 integration with chat runtime hooks and transport
 
 Vercel AI SDK integration for assistant-ui.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 <Callout type="info">
   This package provides integration with AI SDK v5. For AI SDK v4, see the [AI

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

@@ -35,7 +35,13 @@ export const contextColors = {
 
 - [`useDataStreamRuntime`](#use-data-stream-runtime)
 - [`useCloudRuntime`](#use-cloud-runtime)
-- [`toLanguageModelMessages`](#to-language-model-messages)
+- [`toLanguageModelMessages`](#to-language-model-messages) (AI SDK specific)
+
+### assistant-stream (Framework-Agnostic)
+
+- [`toGenericMessages`](#to-generic-messages)
+- [`toToolsJSONSchema`](#to-tools-json-schema)
+- [`GenericMessage`](#generic-message)
 
 ### LangGraph
 
@@ -239,7 +245,7 @@ A conversation thread.
       tooltip="Displayed when the thread is empty"
     />
     <Component
-      name="AssistantIf"
+      name="AuiIf"
       docsLink="#assistant-if"
       tooltip="Conditional rendering based on assistant state"
     />
@@ -383,7 +389,7 @@ Manages the state and actions for individual messages
     tooltip="Displays attachments in the message"
   />
   <Component
-    name="AssistantIf"
+    name="AuiIf"
     docsLink="#assistant-if"
     tooltip="Conditional rendering based on assistant state"
   />

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

@@ -4,9 +4,6 @@ title: ActionBarMorePrimitive
 
 A dropdown menu for additional actions that don't fit in the main action bar.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
-import { DataAttributesTable } from "@/components/docs/tables/DataAttributesTable";
-import { Code } from "@radix-ui/themes";
 
 ## Anatomy
 
@@ -97,18 +94,10 @@ This primitive renders a `<button>` element unless `asChild` is set.
   ]}
 />
 
-<DataAttributesTable
-  data={[
-    {
-      attribute: "[data-state]",
-      values: <Code>"open" | "closed"</Code>,
-    },
-    {
-      attribute: "[data-disabled]",
-      values: "Present when disabled",
-    },
-  ]}
-/>
+| Data attribute | Values |
+| --- | --- |
+| `[data-state]` | `"open" \| "closed"` |
+| `[data-disabled]` | Present when disabled |
 
 ### Content
 
@@ -154,22 +143,11 @@ This primitive renders a `<div>` element unless `asChild` is set.
   ]}
 />
 
-<DataAttributesTable
-  data={[
-    {
-      attribute: "[data-state]",
-      values: <Code>"open" | "closed"</Code>,
-    },
-    {
-      attribute: "[data-side]",
-      values: <Code>"top" | "right" | "bottom" | "left"</Code>,
-    },
-    {
-      attribute: "[data-align]",
-      values: <Code>"start" | "center" | "end"</Code>,
-    },
-  ]}
-/>
+| Data attribute | Values |
+| --- | --- |
+| `[data-state]` | `"open" \| "closed"` |
+| `[data-side]` | `"top" \| "right" \| "bottom" \| "left"` |
+| `[data-align]` | `"start" \| "center" \| "end"` |
 
 Refer to Radix UI's Documentation for [DropdownMenu.Content](https://www.radix-ui.com/primitives/docs/components/dropdown-menu#content) for more details.
 
@@ -205,18 +183,10 @@ This primitive renders a `<div>` element unless `asChild` is set.
   ]}
 />
 
-<DataAttributesTable
-  data={[
-    {
-      attribute: "[data-disabled]",
-      values: "Present when disabled",
-    },
-    {
-      attribute: "[data-highlighted]",
-      values: "Present when highlighted",
-    },
-  ]}
-/>
+| Data attribute | Values |
+| --- | --- |
+| `[data-disabled]` | Present when disabled |
+| `[data-highlighted]` | Present when highlighted |
 
 Refer to Radix UI's Documentation for [DropdownMenu.Item](https://www.radix-ui.com/primitives/docs/components/dropdown-menu#item) for more details.
 
@@ -284,22 +254,22 @@ You can combine the dropdown menu items with action hooks from ActionBarPrimitiv
 import {
   ActionBarPrimitive,
   ActionBarMorePrimitive,
-  useAssistantApi,
-  useAssistantState,
+  useAui,
+  useAuiState,
 } from "@assistant-ui/react";
 import { useCallback } from "react";
 
 const useEditAction = () => {
-  const api = useAssistantApi();
-  const disabled = useAssistantState(({ composer }) => composer.isEditing);
-  const callback = useCallback(() => api.composer().beginEdit(), [api]);
+  const aui = useAui();
+  const disabled = useAuiState(({ composer }) => composer.isEditing);
+  const callback = useCallback(() => aui.composer().beginEdit(), [aui]);
   if (disabled) return null;
   return callback;
 };
 
 const useSpeakAction = () => {
-  const api = useAssistantApi();
-  return useCallback(() => api.message().speak(), [api]);
+  const aui = useAui();
+  return useCallback(() => aui.message().speak(), [aui]);
 };
 
 const MoreActionsWithHooks = () => {
@@ -323,5 +293,3 @@ const MoreActionsWithHooks = () => {
   );
 };
 ```
-
-

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

@@ -5,9 +5,6 @@ description: Buttons for message actions like copy, edit, reload, speak, and fee
 
 Buttons to interact with the message.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
-import { DataAttributesTable } from "@/components/docs/tables/DataAttributesTable";
-import { Code } from "@radix-ui/themes";
 
 ## Anatomy
 
@@ -93,14 +90,9 @@ This primitive renders a `<div>` element unless `asChild` is set.
   ]}
 />
 
-<DataAttributesTable
-  data={[
-    {
-      attribute: "[data-floating]",
-      values: "Present when floating",
-    },
-  ]}
-/>
+| Data attribute | Values |
+| --- | --- |
+| `[data-floating]` | Present when floating |
 
 ### Edit
 
@@ -154,14 +146,9 @@ This primitive renders a `<button>` element unless `asChild` is set.
   ]}
 />
 
-<DataAttributesTable
-  data={[
-    {
-      attribute: "[data-copied]",
-      values: "Present when the message was recently copied.",
-    },
-  ]}
-/>
+| Data attribute | Values |
+| --- | --- |
+| `[data-copied]` | Present when the message was recently copied. |
 
 #### Copied state
 
@@ -169,12 +156,12 @@ Show a different icon for a few seconds after the message is copied.
 
 ```tsx
 <ActionBarPrimitive.Copy>
-  <AssistantIf condition={({ message }) => !message.isCopied}>
+  <AuiIf condition={({ message }) => !message.isCopied}>
     <CopyIcon />
-  </AssistantIf>
-  <AssistantIf condition={({ message }) => message.isCopied}>
+  </AuiIf>
+  <AuiIf condition={({ message }) => message.isCopied}>
     <CopySuccessIcon />
-  </AssistantIf>
+  </AuiIf>
 </ActionBarPrimitive.Copy>
 ```
 
@@ -232,14 +219,9 @@ This primitive renders a `<button>` element unless `asChild` is set.
   ]}
 />
 
-<DataAttributesTable
-  data={[
-    {
-      attribute: "[data-submitted]",
-      values: "Present when positive feedback was submitted.",
-    },
-  ]}
-/>
+| Data attribute | Values |
+| --- | --- |
+| `[data-submitted]` | Present when positive feedback was submitted. |
 
 ### Feedback Negative
 
@@ -256,14 +238,9 @@ This primitive renders a `<button>` element unless `asChild` is set.
   ]}
 />
 
-<DataAttributesTable
-  data={[
-    {
-      attribute: "[data-submitted]",
-      values: "Present when negative feedback was submitted.",
-    },
-  ]}
-/>
+| Data attribute | Values |
+| --- | --- |
+| `[data-submitted]` | Present when negative feedback was submitted. |
 
 ### ExportMarkdown
 

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

@@ -1,30 +1,29 @@
 ---
-title: AssistantIf
+title: AuiIf
 description: Conditional rendering component based on thread, message, or composer state.
 ---
 
 Conditionally render children based on assistant state.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 
 ```tsx
-import { AssistantIf } from "@assistant-ui/react";
+import { AuiIf } from "@assistant-ui/react";
 
-<AssistantIf condition={({ thread }) => thread.isEmpty}>
+<AuiIf condition={({ thread }) => thread.isEmpty}>
   <WelcomeScreen />
-</AssistantIf>
+</AuiIf>
 ```
 
 ## Overview
 
-`AssistantIf` is a generic conditional rendering component that provides access to the full assistant state. It replaces the deprecated `ThreadPrimitive.If`, `MessagePrimitive.If`, and `ComposerPrimitive.If` components with a single, flexible API.
+`AuiIf` is a generic conditional rendering component that provides access to the full assistant state. It replaces the deprecated `ThreadPrimitive.If`, `MessagePrimitive.If`, and `ComposerPrimitive.If` components with a single, flexible API.
 
 ## API Reference
 
 <ParametersTable
-  type="AssistantIfProps"
+  type="AuiIfProps"
   parameters={[
     {
       name: "condition",
@@ -81,120 +80,120 @@ The condition function receives an `AssistantState` object with the following pr
 
 ```tsx
 // Show welcome screen when thread is empty
-<AssistantIf condition={({ thread }) => thread.isEmpty}>
+<AuiIf condition={({ thread }) => thread.isEmpty}>
   <WelcomeScreen />
-</AssistantIf>
+</AuiIf>
 
 // Show loading indicator while running
-<AssistantIf condition={({ thread }) => thread.isRunning}>
+<AuiIf condition={({ thread }) => thread.isRunning}>
   <LoadingSpinner />
-</AssistantIf>
+</AuiIf>
 
 // Conditional send/cancel button
-<AssistantIf condition={({ thread }) => !thread.isRunning}>
+<AuiIf condition={({ thread }) => !thread.isRunning}>
   <ComposerPrimitive.Send>Send</ComposerPrimitive.Send>
-</AssistantIf>
-<AssistantIf condition={({ thread }) => thread.isRunning}>
+</AuiIf>
+<AuiIf condition={({ thread }) => thread.isRunning}>
   <ComposerPrimitive.Cancel>Cancel</ComposerPrimitive.Cancel>
-</AssistantIf>
+</AuiIf>
 ```
 
 ### Message State Conditions
 
 ```tsx
 // Show avatar only for assistant messages
-<AssistantIf condition={({ message }) => message.role === "assistant"}>
+<AuiIf condition={({ message }) => message.role === "assistant"}>
   <AssistantAvatar />
-</AssistantIf>
+</AuiIf>
 
 // Show disclaimer on last message
-<AssistantIf condition={({ message }) => message.isLast}>
+<AuiIf condition={({ message }) => message.isLast}>
   <Disclaimer />
-</AssistantIf>
+</AuiIf>
 
 // Toggle copy icon based on copied state
 <ActionBarPrimitive.Copy>
-  <AssistantIf condition={({ message }) => !message.isCopied}>
+  <AuiIf condition={({ message }) => !message.isCopied}>
     <CopyIcon />
-  </AssistantIf>
-  <AssistantIf condition={({ message }) => message.isCopied}>
+  </AuiIf>
+  <AuiIf condition={({ message }) => message.isCopied}>
     <CheckIcon />
-  </AssistantIf>
+  </AuiIf>
 </ActionBarPrimitive.Copy>
 
 // Show speak/stop button based on speech state
-<AssistantIf condition={({ message }) => message.speech == null}>
+<AuiIf condition={({ message }) => message.speech == null}>
   <ActionBarPrimitive.Speak>
     <SpeakIcon />
   </ActionBarPrimitive.Speak>
-</AssistantIf>
-<AssistantIf condition={({ message }) => message.speech != null}>
+</AuiIf>
+<AuiIf condition={({ message }) => message.speech != null}>
   <ActionBarPrimitive.StopSpeaking>
     <StopIcon />
   </ActionBarPrimitive.StopSpeaking>
-</AssistantIf>
+</AuiIf>
 ```
 
 ### Composer State Conditions
 
 ```tsx
 // Show placeholder when composer is empty
-<AssistantIf condition={({ composer }) => composer.isEmpty}>
+<AuiIf condition={({ composer }) => composer.isEmpty}>
   <PlaceholderText />
-</AssistantIf>
+</AuiIf>
 
 // Show attachment preview when editing
-<AssistantIf condition={({ composer }) => composer.isEditing}>
+<AuiIf condition={({ composer }) => composer.isEditing}>
   <EditingIndicator />
-</AssistantIf>
+</AuiIf>
 ```
 
 ### Complex Conditions
 
 ```tsx
 // Combine multiple conditions
-<AssistantIf condition={({ thread, message }) =>
+<AuiIf condition={({ thread, message }) =>
   !thread.isRunning && message.role === "assistant"
 }>
   <ActionBar />
-</AssistantIf>
+</AuiIf>
 
 // Custom logic
-<AssistantIf condition={({ thread }) =>
+<AuiIf condition={({ thread }) =>
   thread.messages.length > 0 && !thread.isRunning
 }>
   <FollowUpSuggestions />
-</AssistantIf>
+</AuiIf>
 ```
 
 ## Type Export
 
-You can import the `AssistantIf.Condition` type for typing your condition functions:
+You can import the `AuiIf.Condition` type for typing your condition functions:
 
 ```tsx
-import { AssistantIf } from "@assistant-ui/react";
+import { AuiIf } from "@assistant-ui/react";
 
-const isThreadEmpty: AssistantIf.Condition = ({ thread }) => thread.isEmpty;
+const isThreadEmpty: AuiIf.Condition = ({ thread }) => thread.isEmpty;
 
-<AssistantIf condition={isThreadEmpty}>
+<AuiIf condition={isThreadEmpty}>
   <WelcomeScreen />
-</AssistantIf>
+</AuiIf>
 ```
 
 ## Migration from Deprecated Components
 
 <Callout type="warn">
-`ThreadPrimitive.If`, `MessagePrimitive.If`, and `ComposerPrimitive.If` are deprecated. Use `AssistantIf` instead.
+`ThreadPrimitive.If`, `MessagePrimitive.If`, and `ComposerPrimitive.If` are deprecated. Use `AuiIf` instead.
 </Callout>
 
 | Before | After |
 |--------|-------|
-| `<ThreadPrimitive.If empty>` | `<AssistantIf condition={({ thread }) => thread.isEmpty}>` |
-| `<ThreadPrimitive.If running>` | `<AssistantIf condition={({ thread }) => thread.isRunning}>` |
-| `<ThreadPrimitive.If running={false}>` | `<AssistantIf condition={({ thread }) => !thread.isRunning}>` |
-| `<MessagePrimitive.If user>` | `<AssistantIf condition={({ message }) => message.role === "user"}>` |
-| `<MessagePrimitive.If assistant>` | `<AssistantIf condition={({ message }) => message.role === "assistant"}>` |
-| `<MessagePrimitive.If copied>` | `<AssistantIf condition={({ message }) => message.isCopied}>` |
-| `<MessagePrimitive.If speaking>` | `<AssistantIf condition={({ message }) => message.speech != null}>` |
-| `<MessagePrimitive.If last>` | `<AssistantIf condition={({ message }) => message.isLast}>` |
-| `<ComposerPrimitive.If editing>` | `<AssistantIf condition={({ composer }) => composer.isEditing}>` |
+| `<ThreadPrimitive.If empty>` | `<AuiIf condition={({ thread }) => thread.isEmpty}>` |
+| `<ThreadPrimitive.If running>` | `<AuiIf condition={({ thread }) => thread.isRunning}>` |
+| `<ThreadPrimitive.If running={false}>` | `<AuiIf condition={({ thread }) => !thread.isRunning}>` |
+| `<MessagePrimitive.If user>` | `<AuiIf condition={({ message }) => message.role === "user"}>` |
+| `<MessagePrimitive.If assistant>` | `<AuiIf condition={({ message }) => message.role === "assistant"}>` |
+| `<MessagePrimitive.If copied>` | `<AuiIf condition={({ message }) => message.isCopied}>` |
+| `<MessagePrimitive.If speaking>` | `<AuiIf condition={({ message }) => message.speech != null}>` |
+| `<MessagePrimitive.If last>` | `<AuiIf condition={({ message }) => message.isLast}>` |
+| `<ComposerPrimitive.If editing>` | `<AuiIf condition={({ composer }) => composer.isEditing}>` |

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

@@ -5,9 +5,6 @@ description: A popover chat interface for floating assistant UI in the corner of
 
 A modal chat UI usually displayed in the bottom right corner of the screen.
 
-import { Code } from "@radix-ui/themes";
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
-import { DataAttributesTable } from "@/components/docs/tables/DataAttributesTable";
 
 ## Anatomy
 
@@ -79,14 +76,9 @@ This primitive renders a `<button>` element unless `asChild` is set.
   ]}
 />
 
-<DataAttributesTable
-  data={[
-    {
-      attribute: "[data-state]",
-      values: <Code>"open" | "closed"</Code>,
-    },
-  ]}
-/>
+| Data attribute | Values |
+| --- | --- |
+| `[data-state]` | `"open" \| "closed"` |
 
 ### Anchor
 

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

@@ -5,9 +5,6 @@ description: Components for displaying and managing file attachments in messages
 
 Buttons to interact with attachments.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
-import { DataAttributesTable } from "@/components/docs/tables/DataAttributesTable";
-import { Code } from "@radix-ui/themes";
 
 <Callout>
   **Dual Use!** Attachments can appear in both messages and composers.

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

@@ -5,7 +5,6 @@ description: Navigate between conversation branches with previous/next controls.
 
 View and switch between branches.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 

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

@@ -6,9 +6,6 @@ description: Primitives for the text input, send button, and attachments.
 The user interface to add new messages or edit existing ones.
 
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
-import { KeyboardTable } from "@/components/docs/tables/KeyboardTable";
-import { Code } from "@radix-ui/themes";
 
 <Callout>
   **Dual Use!** A Composer placed directly inside a `Thread` will compose new
@@ -88,18 +85,10 @@ This primitive renders a `<textarea>` element unless `asChild` is set.
 
 #### Keyboard Shortcuts
 
-<KeyboardTable
-  data={[
-    {
-      keys: ["Enter"],
-      description: "Sends the message.",
-    },
-    {
-      keys: ["Escape"],
-      description: "Sends a cancel action.",
-    },
-  ]}
-/>
+| Key | Description |
+| --- | --- |
+| <Kbd>Enter</Kbd> | Sends the message. |
+| <Kbd>Escape</Kbd> | Sends a cancel action. |
 
 ### Send
 
@@ -126,7 +115,7 @@ This primitive renders a `<button>` element unless `asChild` is set.
 
 Sends a cancel action.
 
-In edit composers, this action exits the edit mode.  
+In edit composers, this action exits the edit mode.
 In thread composers, this action stops the current run.
 
 This primitive renders a `<button>` element unless `asChild` is set.

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

@@ -3,7 +3,6 @@ title: Composition
 description: How to compose primitives with custom components using asChild.
 ---
 
-import { Code } from "@radix-ui/themes";
 
 `assistant-ui` primitives are composable. This means that all props are forwarded, classes are merged, and event handlers are chained.
 

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

@@ -5,7 +5,6 @@ description: Components for displaying error messages in the chat interface.
 
 A component for displaying error messages in the UI.
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 
 ## Anatomy
 

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

@@ -3,7 +3,6 @@ title: MessagePartPrimitive
 description: Primitives for text, images, tool calls, and other message content.
 ---
 
-import { ParametersTable } from "@/components/docs/tables/ParametersTable";
 import {
   MessagePartRuntime,
   TextMessagePartState,
@@ -11,7 +10,7 @@ import {
   ToolCallMessagePartState,
 } from "@/generated/typeDocs";
 
-Each message can have any number of message parts.  
+Each message can have any number of message parts.
 Message parts are usually one of text, reasoning, audio or tool-call.
 
 ## Message part Types

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

@@ -5,7 +5,6 @@ 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/tables/ParametersTable";
 
 ## Anatomy