@assistant-ui/mcp-docs-server 0.1.30 → 0.1.32

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

@@ -1,103 +0,0 @@
----
-title: "@assistant-ui/react-hook-form"
-description: React Hook Form integration for AI-assisted form filling.
----
-
-A React Hook Form integration for @assistant-ui.
-
-
-## API Reference
-
-### `useAssistantForm`
-
-Drop-in replacement hook for `useForm` that adds support for `@assistant-ui/react`.
-
-```diff
-- import { useForm } from "react-hook-form";
-+ import { useAssistantForm } from "@assistant-ui/react-hook-form";
-
-- useForm({
-+ useAssistantForm({
-    ...
-  });
-```
-
-#### Properties
-
-<ParametersTable
-  type="UseAssistantFormProps"
-  parameters={[
-    {
-      name: "assistant",
-      type: "object",
-      optional: true,
-      description: "Configuration for useAssistantForm",
-      children: [
-        {
-          parameters: [
-            {
-              name: "tools",
-              type: "object",
-              description: "Tools configuration for useAssistantForm",
-              children: [
-                {
-                  parameters: [
-                    {
-                      name: "set_form_field",
-                      type: "object",
-                      description: "Configuration for the set_form_field tool",
-                      children: [
-                        {
-                          parameters: [
-                            {
-                              name: "render",
-                              type: "ToolCallMessagePartComponent<{ name: string; value: string; }, {}>",
-                              description:
-                                "The component to render when set_form_field is called.",
-                            },
-                          ],
-                        },
-                      ],
-                    },
-                    {
-                      name: "submit_form",
-                      type: "object",
-                      description: "Configuration for the submit_form tool",
-                      children: [
-                        {
-                          parameters: [
-                            {
-                              name: "render",
-                              type: "ToolCallMessagePartComponent<{}, {}>",
-                              description:
-                                "The component to render when submit_form is called.",
-                            },
-                          ],
-                        },
-                      ],
-                    },
-                  ],
-                },
-              ],
-            },
-          ],
-        },
-      ],
-    },
-  ]}
-/>
-
-### `formTools`
-
-The set of tools to use with `useAssistantForm` on the server side. While the AI SDK now supports forwarding frontend tools via `frontendTools()`, using `formTools` directly on the server gives you more control over tool execution.
-
-```tsx {1, 5-7}
-import { formTools } from "@assistant-ui/react-hook-form";
-
-const result = streamText({
-  ...
-  tools: {
-    ...formTools,
-  }
-});
-```

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

@@ -1,254 +0,0 @@
----
-title: "@assistant-ui/react-ai-sdk"
-description: Vercel AI SDK integration with chat runtime hooks and transport utilities.
----
-
-Vercel AI SDK integration for assistant-ui.
-
-
-<Callout type="info">
-  This package provides integration with AI SDK v6. For older versions, see the [AI
-  SDK v5 (Legacy)](/docs/runtimes/ai-sdk/v5-legacy) or [AI SDK v4 (Legacy)](/docs/runtimes/ai-sdk/v4-legacy) documentation.
-</Callout>
-
-## API Reference
-
-### `useChatRuntime`
-
-Creates a runtime with AI SDK's `useChat` hook integration. This is the recommended approach for most use cases.
-
-```tsx
-import { useChatRuntime, AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
-import { AssistantRuntimeProvider } from "@assistant-ui/react";
-
-const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
-  const runtime = useChatRuntime({
-    transport: new AssistantChatTransport({
-      api: "/api/chat",
-    }),
-  });
-
-  return (
-    <AssistantRuntimeProvider runtime={runtime}>
-      {children}
-    </AssistantRuntimeProvider>
-  );
-};
-```
-
-To customize the API endpoint, simply change the `api` parameter:
-
-```tsx
-const runtime = useChatRuntime({
-  transport: new AssistantChatTransport({
-    api: "/my-custom-api/chat",
-  }),
-});
-```
-
-<ParametersTable
-  parameters={[
-    {
-      name: "options",
-      type: "UseChatRuntimeOptions",
-      description: "Configuration options for the chat runtime.",
-      children: [
-        {
-          type: "UseChatRuntimeOptions",
-          parameters: [
-            {
-              name: "transport",
-              type: "ChatTransport",
-              description:
-                "Custom transport implementation. Defaults to AssistantChatTransport (which sends requests to '/api/chat' and forwards system messages and tools). Use `new AssistantChatTransport({ api: '/custom-endpoint' })` to customize the endpoint.",
-            },
-            {
-              name: "cloud",
-              type: "AssistantCloud",
-              description:
-                "Optional AssistantCloud instance for chat persistence.",
-            },
-            {
-              name: "adapters",
-              type: "RuntimeAdapters",
-              description:
-                "Optional runtime adapters to extend or override built-in functionality (attachments, speech, dictation, feedback, history).",
-            },
-            {
-              name: "toCreateMessage",
-              type: "(message: AppendMessage) => CreateUIMessage",
-              description:
-                "Optional custom function to convert an AppendMessage into an AI SDK CreateUIMessage before sending.",
-            },
-            {
-              name: "initialMessages",
-              type: "UIMessage[]",
-              description: "Initial messages to populate the chat.",
-            },
-            {
-              name: "onFinish",
-              type: "(message: UIMessage) => void",
-              description: "Callback when a message completes streaming.",
-            },
-            {
-              name: "onError",
-              type: "(error: Error) => void",
-              description: "Callback for handling errors.",
-            },
-          ],
-        },
-      ],
-    },
-  ]}
-/>
-
-<Callout type="info">
-  By default, `useChatRuntime` uses `AssistantChatTransport` which automatically
-  forwards system messages and frontend tools to your backend API. This enables
-  your backend to receive the full context from the assistant-ui.
-</Callout>
-
-### `useAISDKRuntime`
-
-For advanced use cases where you need direct access to the `useChat` hook from AI SDK.
-
-```tsx
-import { useChat } from "@ai-sdk/react";
-import { useAISDKRuntime } from "@assistant-ui/react-ai-sdk";
-import { AssistantRuntimeProvider } from "@assistant-ui/react";
-
-const MyRuntimeProvider = ({ children }: { children: React.ReactNode }) => {
-  const chat = useChat({
-    api: "/api/chat",
-  });
-
-  const runtime = useAISDKRuntime(chat);
-
-  return (
-    <AssistantRuntimeProvider runtime={runtime}>
-      {children}
-    </AssistantRuntimeProvider>
-  );
-};
-```
-
-<ParametersTable
-  parameters={[
-    {
-      name: "chat",
-      type: "ReturnType<typeof useChat>",
-      description: "The chat helpers from @ai-sdk/react's useChat hook.",
-    },
-    {
-      name: "options",
-      type: "AISDKRuntimeAdapter",
-      description: "Optional configuration options.",
-      children: [
-        {
-          type: "AISDKRuntimeAdapter",
-          parameters: [
-            {
-              name: "adapters",
-              type: "RuntimeAdapters",
-              description:
-                "Optional runtime adapters for attachments, feedback, speech, etc.",
-            },
-          ],
-        },
-      ],
-    },
-  ]}
-/>
-
-### `AssistantChatTransport`
-
-A transport that extends the default AI SDK transport to automatically forward system messages and frontend tools to your backend.
-
-```tsx
-import { AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
-
-const runtime = useChatRuntime({
-  transport: new AssistantChatTransport({
-    api: "/my-custom-api/chat",
-  }),
-});
-```
-
-<ParametersTable
-  parameters={[
-    {
-      name: "options",
-      type: "HttpChatTransportInitOptions",
-      description: "Transport configuration options.",
-      children: [
-        {
-          type: "HttpChatTransportInitOptions",
-          parameters: [
-            {
-              name: "api",
-              type: "string",
-              description: "The API endpoint URL.",
-            },
-            {
-              name: "headers",
-              type: "Record<string, string> | Headers",
-              description: "Optional headers to include in requests.",
-            },
-            {
-              name: "credentials",
-              type: "RequestCredentials",
-              description: "Optional credentials mode for fetch requests.",
-            },
-          ],
-        },
-      ],
-    },
-  ]}
-/>
-
-### `frontendTools`
-
-Helper function to convert frontend tool definitions to AI SDK format for use in your backend.
-
-```tsx
-import { frontendTools } from "@assistant-ui/react-ai-sdk";
-import { streamText, convertToModelMessages } from "ai";
-import { openai } from "@ai-sdk/openai";
-
-export async function POST(req: Request) {
-  const { messages, system, tools } = await req.json();
-
-  const result = streamText({
-    model: openai("gpt-4o"),
-    system,
-    messages: await convertToModelMessages(messages),
-    tools: {
-      // Wrap frontend tools with the helper
-      ...frontendTools(tools),
-      // Your backend tools
-      myBackendTool: tool({
-        // ...
-      }),
-    },
-  });
-
-  return result.toUIMessageStreamResponse();
-}
-```
-
-<ParametersTable
-  parameters={[
-    {
-      name: "tools",
-      type: "Record<string, unknown>",
-      description:
-        "Frontend tools object forwarded from AssistantChatTransport.",
-    },
-  ]}
-/>
-
-<Callout type="info">
-  The `frontendTools` helper converts frontend tool definitions to the AI SDK
-  format and ensures they are properly handled by the streaming response.
-</Callout>

package/.docs/raw/docs/(reference)/migrations/v0-14.mdx

@@ -1,159 +0,0 @@
----
-title: Migration to v0.14
-description: Primitives migrate from components prop to children render functions.
----
-
-## Children API for Primitives
-
-Version 0.14 replaces the `components` prop on primitives with a children render function pattern. This gives you full control over rendering with simple inline logic.
-
-### ThreadPrimitive.Messages
-
-**Before:**
-
-```tsx
-<ThreadPrimitive.Messages
-  components={{
-    UserMessage,
-    EditComposer,
-    AssistantMessage,
-  }}
-/>
-```
-
-**After:**
-
-```tsx
-<ThreadPrimitive.Messages>
-  {({ message }) => {
-    if (message.composer.isEditing) return <EditComposer />;
-    if (message.role === "user") return <UserMessage />;
-    return <AssistantMessage />;
-  }}
-</ThreadPrimitive.Messages>
-```
-
-### MessagePrimitive.Parts
-
-**Before:**
-
-```tsx
-<MessagePrimitive.Parts
-  components={{
-    Text: MarkdownText,
-    Reasoning,
-    tools: { Fallback: ToolFallback },
-  }}
-/>
-```
-
-**After:**
-
-```tsx
-<MessagePrimitive.Parts>
-  {({ part }) => {
-    if (part.type === "text") return <MarkdownText />;
-    if (part.type === "reasoning") return <Reasoning {...part} />;
-    if (part.type === "tool-call")
-      return part.toolUI ?? <ToolFallback {...part} />;
-    return null;
-  }}
-</MessagePrimitive.Parts>
-```
-
-### `part.toolUI` and `part.dataRendererUI`
-
-Tool-call parts now expose a `toolUI` property that resolves to the registered tool UI (via `useAssistantToolUI` / `makeAssistantToolUI`) or `null` if none is registered. Data parts similarly expose `dataRendererUI`.
-
-```tsx
-// Renders the registered tool UI if available, otherwise ToolFallback
-if (part.type === "tool-call")
-  return part.toolUI ?? <ToolFallback {...part} />;
-
-// Renders the registered data renderer if available
-if (part.type === "data")
-  return part.dataRendererUI ?? null;
-```
-
-### Returning `null`
-
-Returning `null` from the children function renders registered tool UIs and data renderer UIs automatically via the registry. To explicitly render nothing (suppressing registered UIs), return `<></>`.
-
-```tsx
-<MessagePrimitive.Parts>
-  {({ part }) => {
-    if (part.type === "text") return <MarkdownText />;
-    return null; // registered tool/data UIs still render
-  }}
-</MessagePrimitive.Parts>
-```
-
-### ThreadPrimitive.Suggestions
-
-**Before:**
-
-```tsx
-<ThreadPrimitive.Suggestions
-  components={{ Suggestion: SuggestionItem }}
-/>
-```
-
-**After:**
-
-```tsx
-<ThreadPrimitive.Suggestions>
-  {() => <SuggestionItem />}
-</ThreadPrimitive.Suggestions>
-```
-
-### ThreadListPrimitive.Items
-
-**Before:**
-
-```tsx
-<ThreadListPrimitive.Items
-  components={{ ThreadListItem: MyThreadListItem }}
-/>
-```
-
-**After:**
-
-```tsx
-<ThreadListPrimitive.Items>
-  {() => <MyThreadListItem />}
-</ThreadListPrimitive.Items>
-```
-
-### Attachments
-
-**Before:**
-
-```tsx
-<ComposerPrimitive.Attachments
-  components={{ Attachment: MyAttachment }}
-/>
-```
-
-**After:**
-
-```tsx
-<ComposerPrimitive.Attachments>
-  {() => <MyAttachment />}
-</ComposerPrimitive.Attachments>
-```
-
-### `addResult` / `resume` on enriched part state
-
-When using the children API, tool-call parts include `addResult` and `resume` methods directly on the part object. This means `<ToolFallback {...part} />` works without needing a wrapper component to provide these methods.
-
-### Backwards Compatibility
-
-The `components` prop is still supported on all primitives but is deprecated and will be removed in a future version.
-
-## Getting Help
-
-If you encounter issues during migration:
-
-1. Check the updated API documentation for detailed examples
-2. Review the example applications in the repository
-3. Report issues at https://github.com/assistant-ui/assistant-ui/issues