@assistant-ui/mcp-docs-server 0.1.5 → 0.1.6

package/.docs/organized/code-examples/with-ai-sdk-v5.md

@@ -199,14 +199,12 @@ export default function RootLayout({
 "use client";
 
 import { Thread } from "@/components/assistant-ui/thread";
-import { useChat } from "@ai-sdk/react";
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useAISDKRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 
 export default function Home() {
-  const chat = useChat();
-
-  const runtime = useAISDKRuntime(chat);
+  // Using the new simplified useChatRuntime hook
+  const runtime = useChatRuntime();
 
   return (
     <AssistantRuntimeProvider runtime={runtime}>
@@ -243,6 +241,7 @@ export default function Home() {
   },
   "iconLibrary": "lucide"
 }
+
 ```
 
 ## components/assistant-ui/markdown-text.tsx
@@ -1086,21 +1085,25 @@ This example demonstrates how to use `@assistant-ui/react-ai-sdk-v5` with the Ve
 ## Getting Started
 
 1. Install dependencies:
+
 ```bash
 npm install
 ```
 
 2. Set up your environment variables:
+
 ```bash
 cp .env.example .env.local
 ```
 
 Add your Anthropic API key to `.env.local`:
+
 ```
 ANTHROPIC_API_KEY=your-api-key-here
 ```
 
 3. Run the development server:
+
 ```bash
 npm run dev
 ```
@@ -1110,13 +1113,45 @@ Open [http://localhost:3000](http://localhost:3000) to see the result.
 ## Key Features
 
 - Uses the new AI SDK v5 with `@ai-sdk/react` and `@ai-sdk/anthropic`
-- Integrates with `@assistant-ui/react` using the v5-compatible runtime
+- Integrates with `@assistant-ui/react` using the new `useChatRuntime` hook
 - No RSC support (client-side only)
-- Uses the `useChat` hook from AI SDK v5
+- Simplified integration with the `useChatRuntime` hook that wraps AI SDK v5's `useChat`
+- Automatically uses `AssistantChatTransport` to pass system messages and frontend tools to the backend
+
+## Custom Transport Configuration
+
+By default, `useChatRuntime` uses `AssistantChatTransport` which automatically forwards system messages and frontend tools to the backend.
+
+### Custom API URL with Forwarding
+
+When customizing the API URL, you must explicitly use `AssistantChatTransport` to keep system/tools forwarding:
+
+```typescript
+import { AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
+
+const runtime = useChatRuntime({
+  transport: new AssistantChatTransport({
+    api: "/my-custom-api/chat", // Custom URL with system/tools forwarding
+  }),
+});
+```
+
+### Disable System/Tools Forwarding
+
+To use the standard AI SDK transport without forwarding:
+
+```typescript
+import { DefaultChatTransport } from "ai";
+
+const runtime = useChatRuntime({
+  transport: new DefaultChatTransport(), // No system/tools forwarding
+});
+```
 
 ## API Route
 
 The API route at `/api/chat` uses the new `streamText` function from AI SDK v5 to handle chat completions.
+
 ```
 
 ## tsconfig.json

package/.docs/organized/code-examples/with-ai-sdk.md

@@ -273,6 +273,7 @@ export default function Home() {
   },
   "iconLibrary": "lucide"
 }
+
 ```
 
 ## components/assistant-ui/markdown-text.tsx

package/.docs/organized/code-examples/with-cloud.md

@@ -279,6 +279,7 @@ export default function Home() {
   },
   "iconLibrary": "lucide"
 }
+
 ```
 
 ## components/assistant-ui/markdown-text.tsx

package/.docs/organized/code-examples/with-ffmpeg.md

@@ -1254,7 +1254,6 @@ export default nextConfig;
     "tailwind-merge": "^3.3.1",
     "tw-animate-css": "^1.3.6",
     "zod": "^4.0.14",
-    "zod-to-json-schema": "^3.24.6",
     "zustand": "^5.0.7"
   },
   "devDependencies": {

package/.docs/organized/code-examples/with-langgraph.md

@@ -1784,6 +1784,7 @@ To run the example, run the following commands:
 npm install
 npm run dev
 ```
+
 ```
 
 ## tsconfig.json

package/.docs/organized/code-examples/with-parent-id-grouping.md

@@ -1297,6 +1297,7 @@ This example demonstrates how to use the parent ID feature in assistant-ui to gr
 ## How it works
 
 1. **Message Structure**: The example uses the external store runtime with predefined messages that include parts with `parentId` fields:
+
    ```typescript
    {
      type: "text",
@@ -1335,10 +1336,12 @@ Open [http://localhost:3000](http://localhost:3000) to see the example.
 ## Use Cases
 
 This pattern is useful for:
+
 - Grouping research sources with their related findings
 - Organizing multi-step tool executions
 - Creating hierarchical content structures
 - Showing related content in collapsible sections
+
 ```
 
 ## tsconfig.json

package/.docs/organized/code-examples/with-react-hook-form.md

@@ -1676,7 +1676,6 @@ export default nextConfig;
     "tailwind-merge": "^3.3.1",
     "tw-animate-css": "^1.3.6",
     "zod": "^4.0.14",
-    "zod-to-json-schema": "^3.24.6",
     "zustand": "^5.0.7"
   },
   "devDependencies": {

package/.docs/raw/docs/guides/Latex.mdx

@@ -53,29 +53,55 @@ export const MarkdownText = memo(MarkdownTextImpl);
   </Step>
 </Steps>
 
-## Examples
+## Supported Formats
 
-### Inline math
+By default, remark-math supports:
+- `$...$` for inline math
+- `$$...$$` for display math
+- Fenced code blocks with the `math` language identifier
 
-Single dollar signs for inline math: `$E = mc^2$`
+## Supporting Alternative LaTeX Delimiters
 
-### Block math
+Many language models generate LaTeX using different delimiter formats:
+- `\(...\)` for inline math
+- `\[...\]` for display math
+- Custom formats like `[/math]...[/math]`
 
-Double dollar signs for block math:
+You can use the `preprocess` prop to normalize these formats:
 
-```
-$$
-\int_{a}^{b} f(x) \, dx = F(b) - F(a)
-$$
-```
+```tsx title="/components/assistant-ui/markdown-text.tsx"
+const MarkdownTextImpl = () => {
+  return (
+    <MarkdownTextPrimitive
+      remarkPlugins={[remarkGfm, remarkMath]}
+      rehypePlugins={[rehypeKatex]}
+      preprocess={normalizeCustomMathTags} // [!code ++]
+      className="aui-md"
+      components={defaultComponents}
+    />
+  );
+};
 
-### Fenced code blocks
+// Your LaTeX preprocessing function
+function normalizeCustomMathTags(input: string): string {
+  return (
+    input
+      // Convert [/math]...[/math] to $$...$$
+      .replace(/\[\/math\]([\s\S]*?)\[\/math\]/g, (_, content) => `$$${content.trim()}$$`)
 
-Fenced code blocks with the `math` language identifier:
+      // Convert [/inline]...[/inline] to $...$
+      .replace(/\[\/inline\]([\s\S]*?)\[\/inline\]/g, (_, content) => `$${content.trim()}$`)
 
-````
-```math
-\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
+      // Convert \( ... \) to $...$ (inline math) - handles both single and double backslashes
+      .replace(/\\{1,2}\(([\s\S]*?)\\{1,2}\)/g, (_, content) => `$${content.trim()}$`)
+
+      // Convert \[ ... \] to $$...$$ (block math) - handles both single and double backslashes
+      .replace(/\\{1,2}\[([\s\S]*?)\\{1,2}\]/g, (_, content) => `$$${content.trim()}$$`)
+  );
+}
 ```
-````
+
+<Callout type="tip">
+The preprocessing function runs before markdown parsing, allowing you to transform any delimiter format into the standard `$` and `$$` format.
+</Callout>
 

package/.docs/raw/docs/runtimes/ai-sdk/use-chat-v5.mdx

@@ -1,17 +1,14 @@
 ---
-title: AI SDK v5 (@alpha)
+title: AI SDK v5 with useChatRuntime
 ---
 
 import { Callout } from "fumadocs-ui/components/callout";
 
-<Callout type="warn">
-  This integration is currently in **alpha**. APIs may change before the stable release.
-</Callout>
 
 ## Overview
 
-Integration with the Vercel AI SDK v5's `useChat` hook using the `@assistant-ui/react-ai-sdk` package with the `@alpha` tag.  
-This version supports the latest AI SDK v5 features including the new streamText API and improved TypeScript support.
+Integration with the Vercel AI SDK v5 using the new `useChatRuntime` hook from `@assistant-ui/react-ai-sdk`.  
+This provides a streamlined way to integrate AI SDK v5 features including the new streamText API and improved TypeScript support.
 
 ## Getting Started
 
@@ -29,10 +26,10 @@ cd my-app
   </Step>
   <Step>
 
-### Install AI SDK v5 and `@assistant-ui/react` with alpha tag
+### Install AI SDK v5 and `@assistant-ui/react`
 
 ```sh npm2yarn
-npm install @assistant-ui/react @assistant-ui/react-ai-sdk@alpha ai @ai-sdk/openai
+npm install @assistant-ui/react @assistant-ui/react-ai-sdk ai @ai-sdk/openai
 ```
 
   </Step>
@@ -50,18 +47,27 @@ import {
   convertToModelMessages,
   tool,
 } from "ai";
+import { frontendTools } from "@assistant-ui/assistant-stream/ai-sdk";
 import { z } from "zod";
 
 // Allow streaming responses up to 30 seconds
 export const maxDuration = 30;
 
 export async function POST(req: Request) {
-  const { messages }: { messages: UIMessage[] } = await req.json();
+  const { messages, system, tools }: { 
+    messages: UIMessage[];
+    system?: string; // System message forwarded from AssistantChatTransport
+    tools?: any; // Frontend tools forwarded from AssistantChatTransport
+  } = await req.json();
 
   const result = streamText({
     model: openai("gpt-4o"),
+    system, // Use the system message from the frontend if provided
     messages: convertToModelMessages(messages),
     tools: {
+      // Wrap frontend tools with frontendTools helper
+      ...frontendTools(tools),
+      // Backend tools
       get_current_weather: tool({
         description: "Get the current weather",
         inputSchema: z.object({
@@ -81,7 +87,7 @@ export async function POST(req: Request) {
   </Step>
   <Step>
 
-### Wrap your app with `AssistantRuntimeProvider` with AI SDK v5 runtime
+### Wrap your app with `AssistantRuntimeProvider` using `useChatRuntime`
 
 `@/app/page.tsx`
 
@@ -89,13 +95,11 @@ export async function POST(req: Request) {
 "use client";
 
 import { Thread } from "@/components/assistant-ui/thread";
-import { useChat } from "@ai-sdk/react";
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useAISDKRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 
 export default function Home() {
-  const chat = useChat();
-  const runtime = useAISDKRuntime(chat);
+  const runtime = useChatRuntime();
 
   return (
     <AssistantRuntimeProvider runtime={runtime}>
@@ -112,9 +116,88 @@ export default function Home() {
 
 ## API Reference
 
-### useAISDKRuntime
+### useChatRuntime
+
+Creates a runtime directly with AI SDK v5's `useChat` hook integration.
+
+```tsx
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+
+const runtime = useChatRuntime({
+  api: "/api/chat",
+  // All standard useChat options are supported
+});
+```
+
+<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>
+
+### Custom Transport Configuration
+
+If you need to customize the transport configuration:
+
+```tsx
+import { DefaultChatTransport } from "ai";
+import { AssistantChatTransport } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+
+// Example 1: Custom API URL while keeping system/tools forwarding
+const runtime = useChatRuntime({
+  transport: new AssistantChatTransport({
+    api: "/my-custom-api/chat" // Custom API URL with forwarding
+  })
+});
+
+// Example 2: Disable system/tools forwarding
+const runtime = useChatRuntime({
+  api: "/api/chat",
+  transport: new DefaultChatTransport() // Standard AI SDK transport without forwarding
+});
+```
+
+<Callout type="warning">
+  When customizing the API URL, you must explicitly use `AssistantChatTransport` if you want to keep frontend system messages and tools forwarding. Simply passing `api` to `useChatRuntime` will use the default transport configuration.
+</Callout>
+
+#### Transport Options
+
+- **`AssistantChatTransport`** (default): Automatically forwards system messages and frontend tools from the Assistant UI context to your backend
+- **`DefaultChatTransport`**: Standard AI SDK transport without automatic forwarding
+
+### Using Frontend Tools with `frontendTools`
+
+When using `AssistantChatTransport`, frontend tools are forwarded to your backend. Use the `frontendTools` helper to properly integrate them:
+
+```tsx
+import { frontendTools } from "@assistant-ui/assistant-stream/ai-sdk";
+
+export async function POST(req: Request) {
+  const { messages, system, tools } = await req.json();
+
+  const result = streamText({
+    model: openai("gpt-4o"),
+    system,
+    messages: convertToModelMessages(messages),
+    tools: {
+      // Wrap frontend tools with the helper
+      ...frontendTools(tools),
+      // Your backend tools
+      myBackendTool: tool({
+        // ...
+      }),
+    },
+  });
+
+  return result.toUIMessageStreamResponse();
+}
+```
+
+The `frontendTools` helper converts frontend tool definitions to the AI SDK format and ensures they are properly handled by the streaming response.
+
+### useAISDKRuntime (Advanced)
 
-Creates a runtime adapter for AI SDK v5's `useChat` hook.
+For advanced use cases where you need direct access to the `useChat` hook:
 
 ```tsx
 import { useChat } from "@ai-sdk/react";
@@ -126,4 +209,4 @@ const runtime = useAISDKRuntime(chat);
 
 ## Example
 
-For a complete example, check out the [AI SDK v5 example](https://github.com/assistant-ui/assistant-ui/tree/main/examples/with-ai-sdk-v5) in our repository.
+For a complete example, check out the [AI SDK v5 example](https://github.com/assistant-ui/assistant-ui/tree/main/examples/with-ai-sdk-v5) in our repository.

package/.docs/raw/docs/runtimes/custom/local.mdx

@@ -169,7 +169,7 @@ Use `LocalRuntime` if you need:
     ### Use the Thread component
 
     ```tsx title="app/page.tsx"
-    import { Thread } from "@assistant-ui/react";
+    import { Thread } from 'components/assistant-ui/thread.tsx'
 
     export default function Page() {
       return <Thread />;

package/.docs/raw/docs/runtimes/mastra/separate-server-integration.mdx

@@ -140,13 +140,13 @@ Open the main page file in your Assistant UI frontend project (usually `app/page
 ```tsx {10} title="app/page.tsx"
 "use client";
 import { Thread } from "@/components/assistant-ui/thread";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useDataStreamRuntime } from "@assistant-ui/react-data-stream";
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
 import { ThreadList } from "@/components/assistant-ui/thread-list";
 
 export default function Home() {
   // Point the runtime to the Mastra server endpoint
-  const runtime = useChatRuntime({
+  const runtime = useDataStreamRuntime({
     api: "http://localhost:4111/api/agents/chefAgent/stream",
   });
 

package/dist/{chunk-JS4PWCVA.js → chunk-L4K23SWI.js}

@@ -1,7 +1,7 @@
 import { logger, IS_PREPARE_MODE, MDX_EXTENSION, DOCS_PATH, MAX_FILE_SIZE, CODE_EXAMPLES_PATH, MD_EXTENSION } from './chunk-M2RKUM66.js';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 import { lstat, stat, readdir, readFile } from 'fs/promises';
 import path, { dirname, join, extname, normalize, relative } from 'path';
 import matter from 'gray-matter';

package/dist/index.js

@@ -1 +1 @@
-export { runServer, server } from './chunk-JS4PWCVA.js';
+export { runServer, server } from './chunk-L4K23SWI.js';

package/dist/stdio.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { runServer } from './chunk-JS4PWCVA.js';
+import { runServer } from './chunk-L4K23SWI.js';
 
 // src/stdio.ts
 void runServer().catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/mcp-docs-server",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "MCP server for assistant-ui documentation and examples",
   "type": "module",
   "main": "dist/index.js",