@assistant-ui/mcp-docs-server 0.1.9 → 0.1.10

package/.docs/raw/docs/migrations/v0-8.mdx

@@ -1,160 +0,0 @@
----
-title: Migration to v0.8
----
-
-## Styled Components moved to @assistant-ui/react-ui
-
-All styled components (Thread, ThreadList, AssistantModal, makeMarkdownText, etc.) have been moved to a new package, `@assistant-ui/react-ui`.
-
-To migrate, use the migration codemod:
-
-```sh
-# IMPORTANT: make sure to commit all changes to git / creating a backup before running the codemod
-npx assistant-ui upgrade
-```
-
-## Vercel AI SDK RSC requires additional setup
-
-Built-in RSC support in assistant-ui has been removed, so an additional setup step is required.
-The RSC runtime now requires additional setup to display React Server Components.
-
-```ts
-import { RSCDisplay } from "@assistant-ui/react-ai-sdk";
-
-// if you are using the default Thread component
-// add RSCDisplay to assistantMessage.components.Text
-<Thread assistantMessage={{ components: { Text: RSCDisplay } }} />
-
-
-// if you are using unstyled primitives, update MyThread.tsx
-<MessagePrimitive.Parts components={{ Text: RSCDisplay }} />
-```
-
-## Migrate away from UIMessagePart
-
-For instructions on migrating for Vercel AI SDK RSC, see section above.
-This migration guide is for users of `useExternalStoreRuntime`.
-
-### Recommended Approach: Use ToolUI
-
-First, reconsider your approach.
-
-Creating UI components in the `convertMessage` callback is considered an anti-pattern.
-The recommended alternative approach is to pass tool-call message parts, and use `makeAssistantToolUI` to map these tool calls to UI components.
-
-This ensures that the data layer is separate and decoupled from the UI layer.
-
-#### Example
-
-Consider the following example, where you are using a UIMessagePart to show a loading indicator.
-
-```ts title="bad.ts"
-// THIS IS BAD
-const convertMessage = (message: MyMessage): ThreadMessageLike => {
-  if (message.isLoading) {
-    return { content: [{ type: "ui", display:< MyLoader /> }] };
-  }
-  // ...
-};
-```
-
-```ts title="good.ts"
-const convertMessage = (message: MyMessage): ThreadMessageLike => {
-  if (message.isLoading) {
-    return { content: [] };
-  }
-  // ...
-};
-
-// use the empty message part to show the loading indicator
-<Thread assistantMessage={{ components: { Empty: MyLoader } }} />;
-```
-
-(if you are using unstyled primitives, update MyThread.tsx, and pass the component to MessagePrimitive.Parts)
-
-#### Example 2
-
-Consider the following example, where you are displaying a custom chart based on data received from an external source.
-
-```ts title="bad.ts"
-// THIS IS BAD
-const convertMessage = (message: MyMessage): ThreadMessageLike => {
-  return { content: [{ type: "ui", display: <MyChart data={message.chartData} /> }] };
-};
-```
-
-```ts title="good.ts"
-const convertMessage = (message: MyMessage): ThreadMessageLike => {
-  return {
-    content: [
-      {
-        type: "tool-call",
-        toolName: "chart",
-        args: message.chartData,
-      },
-    ],
-  };
-};
-
-const ChartToolUI = makeAssistantToolUI({
-  toolName: "chart",
-  render: ({ args }) => <MyChart data={args} />,
-});
-
-// use tool UI to display the chart
-<Thread tools={[ChartToolUI]} />;
-```
-
-(if you are using unstyled primitives, render the `<ChartToolUI />` component anywhere inside your AssistantRuntimeProvider)
-
-### Fallback Approach: Override MessagePartText
-
-However, sometimes you receive UI components from an external source.
-
-The example below assumes that your custom `MyMessage` type has a `display` field.
-
-First, we define a dummy `UI_PLACEHOLDER` message part, which we will replace with the UI component later:
-
-```ts
-const UI_PLACEHOLDER = Object.freeze({
-  type: "text",
-  text: "UI content placeholder",
-});
-const convertMessage = (message: MyMessage): ThreadMessageLike => ({
-  content: [
-    // other message parts,
-    UI_PLACEHOLDER,
-  ],
-});
-```
-
-Then, we define a custom `TextMessagePartComponent`:
-
-```tsx
-const MyText: TextMessagePartComponent = () => {
-  const isUIPlaceholder = useMessagePart((p) => p === UI_PLACEHOLDER);
-
-  // this assumes that you have a `display` field on your original message objects before conversion.
-  const ui = useMessage((m) =>
-    isUIPlaceholder ? getExternalStoreMessage(m).display : undefined,
-  );
-  if (ui) {
-    return ui;
-  }
-
-  return <MarkdownText />; // your default text component
-};
-```
-
-We pass this component to our Thread:
-
-```tsx
-<Thread
-  assistantMessage={{ components: { Text: MyText } }}
-  userMessage={{ components: { Text: MyText } }}
-/>
-```
-
-(if you are using unstyled primitives, update MyThread.tsx, and pass the component to MessagePrimitive.Parts)
-
-Now, the `UI_PLACEHOLDER` message part is replaced with the UI component we defined earlier.

package/.docs/raw/docs/migrations/v0-9.mdx

@@ -1,75 +0,0 @@
----
-title: Migration to v0.9
----
-
-## Edge Runtime moved to @assistant-ui/react-edge
-
-The edge runtime, as well as the `CoreMessage` type, moved to `@assistant-ui/react-edge`.
-
-The following components and types have been moved to `@assistant-ui/react-edge`:
-
-- Edge Runtime
-
-  - `useEdgeRuntime`
-  - `EdgeRuntimeOptions`
-  - `EdgeModelAdapter`
-  - `EdgeChatAdapter`
-  - `EdgeRuntimeRequestOptions`
-  - `createEdgeRuntimeAPI`
-  - `getEdgeRuntimeResponse`
-
-- Core Types
-  - `CoreMessage`
-  - `CoreUserMessage`
-  - `CoreAssistantMessage`
-  - `CoreSystemMessage`
-  - `CoreUserMessagePart`
-  - `CoreAssistantMessagePart`
-  - `CoreToolCallMessagePart`
-- Core message converters
-  - `fromCoreMessages`
-  - `fromCoreMessage`
-  - `toCoreMessages`
-  - `toCoreMessage`
-
-To migrate, use the migration codemod:
-
-```sh
-# IMPORTANT: make sure to commit all changes to git / creating a backup before running the codemod
-npx assistant-ui upgrade
-```
-
-## Language Model converters and useDangerousInBrowserRuntime moved to @assistant-ui/react-ai-sdk
-
-The following methods have been moved to `@assistant-ui/react-ai-sdk`:
-
-- Language Model converters
-  - `toLanguageModelMessages`
-  - `toLanguageModelTools`
-  - `fromLanguageModelMessages`
-  - `fromLanguageModelTools`
-- Dangerous in Browser Runtime
-  - `useDangerousInBrowserRuntime`
-
-To migrate, use the migration codemod:
-
-```sh
-# IMPORTANT: make sure to commit all changes to git / creating a backup before running the codemod
-npx assistant-ui upgrade
-```
-
-## LangGraph `unstable_allowImageAttachments` removed
-
-The `unstable_allowImageAttachments` option has been removed. Use the `adapters` option instead.
-
-```ts
-useLangGraphRuntime({
-  adapters: {
-    attachments: new SimpleImageAttachmentAdapter(),
-  },
-});
-```
-
-## Markdown `components.by_language` removed
-
-The `components.by_language` option has been removed. Use the `componentsByLanguage` option instead.

package/.docs/raw/docs/ui/primitives/Thread.mdx

@@ -1,197 +0,0 @@
----
-title: Thread
----
-
-A conversation between a user and an assistant.
-
-import { ParametersTable } from "@/components/docs";
-
-## Anatomy
-
-```tsx
-import { ThreadPrimitive } from "@assistant-ui/react";
-
-const Thread = () => (
-  <ThreadPrimitive.Root>
-    <ThreadPrimitive.Viewport>
-      <ThreadPrimitive.Empty>...</ThreadPrimitive.Empty>
-      <ThreadPrimitive.Messages components={...} />
-    </ThreadPrimitive.Viewport>
-    <Composer />
-  </ThreadPrimitive.Root>
-);
-```
-
-## API Reference
-
-### Root
-
-Contains all parts of the thread.
-
-This primitive renders a `<div>` element unless `asChild` is set.
-
-<ParametersTable
-  type="ThreadPrimitiveRootProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
-
-### Viewport
-
-The scrollable area containing all messages. Anchors scroll to the bottom as new messages are added.
-
-This primitive renders a `<div>` element unless `asChild` is set.
-
-<ParametersTable
-  type="ThreadPrimitiveViewportProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-    {
-      name: "autoScroll",
-      type: "boolean",
-      default: "true",
-      description:
-        "Whether to automatically scroll to the bottom of the viewport when new messages are added while the viewport is was previously scrolled to the bottom.",
-    },
-  ]}
-/>
-
-### Messages
-
-Renders all messages. This primitive renders a separate component for each message.
-
-<ParametersTable
-  type="ThreadPrimitiveMessagesProps"
-  parameters={[
-    {
-      name: "components",
-      type: "MessageComponents",
-      description: "The component to render for each 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.
-
-### ScrollToBottom
-
-A button to scroll the viewport to the bottom. Disabled when the viewport is already at bottom.
-
-This primitive renders a `<button>` element unless `asChild` is set.
-
-<ParametersTable
-  type="ThreadPrimitiveScrollToBottomProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
-
-### `ThreadPrimitive.Suggestion`
-
-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.
-
-```tsx
-import { ThreadPrimitive } from "@assistant-ui/react";
-
-const Suggestion = () => {
-  return (
-    <ThreadPrimitive.Suggestion
-      prompt="I need help with product search"
-      method="replace"
-      autoSend
-    />
-  );
-};
-```
-
-<ParametersTable
-  type="ThreadPrimitiveSuggestionProps"
-  parameters={[
-    {
-      name: "prompt",
-      type: "string",
-      description: "The suggestion's prompt.",
-    },
-    {
-      name: "method",
-      type: "'replace'",
-      description:
-        "How does the suggestion interact with the composer's existing value.",
-    },
-    {
-      name: "autoSend",
-      type: "boolean",
-      description:
-        "Whether to automatically send the suggestion when the user clicks on it.",
-      default: "false",
-    },
-  ]}
-/>
-
-### If
-
-Renders children if a condition is met.
-
-<ParametersTable
-  type="ThreadPrimitiveIfProps"
-  parameters={[
-    {
-      name: "empty",
-      type: "boolean | undefined",
-      description: "Render children if the thread is empty.",
-    },
-    {
-      name: "running",
-      type: "boolean | undefined",
-      description: "Render children if the thread is running.",
-    },
-  ]}
-/>
-
-```tsx
-<Thread.If empty>
-  {/* equivalent to <Thread.Empty> */}
-</Thread.If>
-<Thread.If empty={false}>
-  {/* rendered if thread is not empty */}
-</Thread.If>
-```