@assistant-ui/mcp-docs-server 0.1.33 → 0.1.35

package/.docs/organized/code-examples/waterfall.md

@@ -774,19 +774,19 @@ export default withAui(nextConfig);
     "@assistant-ui/react-o11y": "workspace:*",
     "@assistant-ui/store": "workspace:*",
     "@assistant-ui/tap": "workspace:*",
-    "next": "^16.2.6",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6"
+    "next": "^16.2.9",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7"
   },
   "devDependencies": {
     "@assistant-ui/next": "workspace:*",
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.3.0",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.15",
-    "tailwindcss": "^4.3.0",
+    "tailwindcss": "^4.3.1",
     "typescript": "^6.0.3"
   }
 }

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

@@ -555,21 +555,21 @@ export default withAui(nextConfig);
     "@assistant-ui/ui": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.17.0",
-    "next": "^16.2.6",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "lucide-react": "^1.18.0",
+    "next": "^16.2.9",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tailwind-merge": "^3.6.0"
   },
   "devDependencies": {
     "@assistant-ui/next": "workspace:*",
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.3.0",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.15",
-    "tailwindcss": "^4.3.0",
+    "tailwindcss": "^4.3.1",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }

package/.docs/organized/code-examples/with-ag-ui.md

@@ -263,16 +263,16 @@ export function MyRuntimeProvider({
 "use client";
 
 import {
+  defineToolkit,
   useAui,
   AuiProvider,
   Suggestions,
   Tools,
-  type Toolkit,
 } from "@assistant-ui/react";
 import { Thread } from "@/components/assistant-ui/thread";
 import { PlusIcon } from "lucide-react";
 
-const toolkit = {
+const toolkit = defineToolkit({
   browser_alert: {
     description: "Display a native browser alert dialog to the user.",
     parameters: {
@@ -306,7 +306,7 @@ const toolkit = {
       </div>
     ),
   },
-} satisfies Toolkit;
+});
 
 function NewThreadButton() {
   const aui = useAui();
@@ -420,28 +420,28 @@ export default withAui(nextConfig);
     "start": "next start"
   },
   "dependencies": {
-    "@ag-ui/client": "^0.0.54",
+    "@ag-ui/client": "^0.0.57",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ag-ui": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.17.0",
-    "next": "^16.2.6",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "lucide-react": "^1.18.0",
+    "next": "^16.2.9",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tailwind-merge": "^3.6.0"
   },
   "devDependencies": {
     "@assistant-ui/next": "workspace:*",
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.3.0",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.15",
-    "tailwindcss": "^4.3.0",
+    "tailwindcss": "^4.3.1",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }

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

@@ -316,30 +316,30 @@ export default withAui(nextConfig);
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.67",
+    "@ai-sdk/openai": "^3.0.71",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.193",
+    "ai": "^6.0.204",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.17.0",
-    "next": "^16.2.6",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "lucide-react": "^1.18.0",
+    "next": "^16.2.9",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tailwind-merge": "^3.6.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@assistant-ui/next": "workspace:*",
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.3.0",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.15",
-    "tailwindcss": "^4.3.0",
+    "tailwindcss": "^4.3.1",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }

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

@@ -212,7 +212,6 @@ import { Thread } from "@/components/assistant-ui/thread";
 import {
   AssistantRuntimeProvider,
   Tools,
-  type Toolkit,
   useAui,
   useAuiState,
   AuiProvider,
@@ -220,30 +219,9 @@ import {
 } from "@assistant-ui/react";
 import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 import type { ToolCallMessagePart } from "@assistant-ui/react";
-import { TerminalIcon, CodeIcon, EyeIcon } from "lucide-react";
+import { CodeIcon, EyeIcon } from "lucide-react";
 import { useState } from "react";
-import { z } from "zod";
-
-const toolkit = {
-  render_html: {
-    description:
-      "Whenever the user asks for HTML code, call this function. The user will see the HTML code rendered in their browser.",
-    parameters: z.object({
-      code: z.string(),
-    }),
-    execute: async () => {
-      return {};
-    },
-    render: () => {
-      return (
-        <div className="bg-primary text-primary-foreground my-2 inline-flex items-center gap-2 rounded-full border px-4 py-2">
-          <TerminalIcon className="size-4" />
-          render_html(&#123; code: &quot;...&quot; &#125;)
-        </div>
-      );
-    },
-  },
-} satisfies Toolkit;
+import toolkit from "./toolkit";
 
 function ArtifactsView() {
   const [tab, setTab] = useState<"source" | "preview">("source");
@@ -359,6 +337,34 @@ export default function Home() {
 
 ```
 
+## app/toolkit.tsx
+
+```tsx
+"use generative";
+
+import { defineToolkit, externalTool } from "@assistant-ui/react";
+import { TerminalIcon } from "lucide-react";
+import { z } from "zod";
+
+export default defineToolkit({
+  render_html: {
+    parameters: z.object({
+      code: z.string(),
+    }),
+    execute: externalTool(),
+    render: () => {
+      return (
+        <div className="bg-primary text-primary-foreground my-2 inline-flex items-center gap-2 rounded-full border px-4 py-2">
+          <TerminalIcon className="size-4" />
+          render_html(&#123; code: &quot;...&quot; &#125;)
+        </div>
+      );
+    },
+  },
+});
+
+```
+
 ## components.json
 
 ```json
@@ -420,30 +426,30 @@ export default withAui(nextConfig);
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.67",
+    "@ai-sdk/openai": "^3.0.71",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.193",
+    "ai": "^6.0.204",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.17.0",
-    "next": "^16.2.6",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "lucide-react": "^1.18.0",
+    "next": "^16.2.9",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tailwind-merge": "^3.6.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@assistant-ui/next": "workspace:*",
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.3.0",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.15",
-    "tailwindcss": "^4.3.0",
+    "tailwindcss": "^4.3.1",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }

package/.docs/organized/code-examples/with-assistant-transport.md

@@ -170,9 +170,9 @@ export default function RootLayout({
 
 import {
   AssistantRuntimeProvider,
+  defineToolkit,
   Tools,
   type AssistantTransportConnectionMetadata,
-  type Toolkit,
   unstable_createMessageConverter as createMessageConverter,
   useAui,
   useAssistantTransportRuntime,
@@ -184,7 +184,7 @@ import {
 import type { ReactNode } from "react";
 import { z } from "zod";
 
-const toolkit = {
+const toolkit = defineToolkit({
   get_weather: {
     type: "frontend",
     description: "Get the current weather for a city",
@@ -232,7 +232,7 @@ const toolkit = {
           : "Weather lookup complete",
     },
   },
-} satisfies Toolkit;
+});
 
 type MyRuntimeProviderProps = {
   children: ReactNode;
@@ -433,22 +433,22 @@ export default withAui(nextConfig);
     "@assistant-ui/ui": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.17.0",
-    "next": "^16.2.6",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "lucide-react": "^1.18.0",
+    "next": "^16.2.9",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tailwind-merge": "^3.6.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@assistant-ui/next": "workspace:*",
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.3.0",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.15",
-    "tailwindcss": "^4.3.0",
+    "tailwindcss": "^4.3.1",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }

package/.docs/organized/code-examples/with-browser-extension.md

@@ -229,20 +229,20 @@ export function MyThread() {
     "@assistant-ui/ui": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.17.0",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "lucide-react": "^1.18.0",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tailwind-merge": "^3.6.0"
   },
   "devDependencies": {
-    "@tailwindcss/postcss": "^4.3.0",
-    "@types/chrome": "^0.1.42",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@types/chrome": "^0.1.43",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "esbuild": "^0.28.0",
+    "esbuild": "^0.28.1",
     "postcss": "^8.5.15",
-    "tailwindcss": "^4.3.0",
+    "tailwindcss": "^4.3.1",
     "tsx": "^4.22.4",
     "tw-animate-css": "^1.4.0",
     "typescript": "5.9.3"

package/.docs/organized/code-examples/with-chain-of-thought.md

@@ -14,11 +14,14 @@ import {
   JsonToSseTransformStream,
 } from "ai";
 import type { UIMessage, UIMessageStreamWriter } from "ai";
-import { frontendTools } from "@assistant-ui/react-ai-sdk";
+import { AISDKToolkit } from "@assistant-ui/react-ai-sdk";
 import { z } from "zod";
+import toolkit from "../../toolkit";
 
 export const maxDuration = 30;
 
+const aiToolkit = new AISDKToolkit({ toolkit });
+
 type SearchResult = { id: string; url: string; title: string };
 
 const searchSources = (query: string): SearchResult[] => {
@@ -112,13 +115,15 @@ async function streamModel(
     }),
   });
 
+  const toolkitTools = await aiToolkit.tools({ frontend: frontendToolDefs });
+
   const result = streamText({
     // Reasoning model so the chain-of-thought group has real content.
     model: openai("gpt-5.4-mini"),
     messages: await convertToModelMessages(messages),
     stopWhen: stepCountIs(10),
     tools: {
-      ...frontendTools(frontendToolDefs),
+      ...toolkitTools,
       get_current_weather: tool({
         description: "Get the current weather for a city",
         inputSchema: zodSchema(z.object({ city: z.string() })),
@@ -635,7 +640,7 @@ const Composer: FC = () => {
   const isRunning = useThread((state) => state.isRunning);
 
   return (
-    <ComposerPrimitive.Root className="border-input bg-background has-[textarea:focus-visible]:border-ring has-[textarea:focus-visible]:ring-ring/20 flex w-full flex-col rounded-2xl border px-1 pt-2 transition-shadow outline-none has-[textarea:focus-visible]:ring-2">
+    <ComposerPrimitive.Root className="border-input bg-background has-[textarea:focus-visible]:border-foreground/60 flex w-full flex-col rounded-2xl border px-1 pt-2 transition-colors outline-none">
       <ComposerPrimitive.Input
         placeholder="Send a message..."
         className="placeholder:text-muted-foreground mb-1 max-h-32 min-h-14 w-full resize-none bg-transparent px-4 pt-2 pb-3 text-sm outline-none"
@@ -682,51 +687,14 @@ const Composer: FC = () => {
 import {
   AssistantRuntimeProvider,
   Tools,
-  type Toolkit,
   useAui,
   AuiProvider,
   Suggestions,
 } from "@assistant-ui/react";
 import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
-import { z } from "zod";
 import { MyThread } from "./MyThread";
 import { lastAssistantMessageIsCompleteWithApprovalResponses } from "ai";
-
-const toolkit = {
-  execute_js: {
-    type: "frontend",
-    description: "Execute JavaScript code and return the result",
-    parameters: z.object({
-      code: z.string().describe("The JavaScript code to execute"),
-    }),
-    execute: async ({ code }) => {
-      try {
-        const result = eval(code);
-        return { success: true, result: String(result) };
-      } catch (e) {
-        return { success: false, error: String(e) };
-      }
-    },
-    render: ({ args, result, status }) => (
-      <div className="bg-muted/30 my-2 rounded-lg border p-4 text-sm">
-        <p className="mb-1 font-semibold">execute_js</p>
-        <pre className="bg-background rounded p-2 font-mono text-xs whitespace-pre-wrap">
-          {args.code}
-        </pre>
-        {status.type !== "running" && result && (
-          <div className="mt-2 border-t pt-2">
-            <p className="text-muted-foreground font-semibold">
-              {result.success ? "Result:" : "Error:"}
-            </p>
-            <pre className="font-mono text-xs whitespace-pre-wrap">
-              {result.success ? result.result : result.error}
-            </pre>
-          </div>
-        )}
-      </div>
-    ),
-  },
-} satisfies Toolkit;
+import toolkit from "./toolkit";
 
 function MyThreadWithSuggestions() {
   const aui = useAui({
@@ -771,6 +739,59 @@ export default function Home() {
 
 ```
 
+## app/toolkit.tsx
+
+```tsx
+"use generative";
+
+import { defineToolkit } from "@assistant-ui/react";
+import { z } from "zod";
+
+type ExecuteJsResult =
+  | { success: true; result: string }
+  | { success: false; error: string };
+
+export default defineToolkit({
+  execute_js: {
+    description: "Execute JavaScript code and return the result",
+    parameters: z.object({
+      code: z.string().describe("The JavaScript code to execute"),
+    }),
+    execute: async ({ code }) => {
+      "use client";
+      try {
+        const result = eval(code);
+        return { success: true, result: String(result) };
+      } catch (e) {
+        return { success: false, error: String(e) };
+      }
+    },
+    render: ({ args, result, status }) => {
+      const output = result as ExecuteJsResult | undefined;
+      return (
+        <div className="bg-muted/30 my-2 rounded-lg border p-4 text-sm">
+          <p className="mb-1 font-semibold">execute_js</p>
+          <pre className="bg-background rounded p-2 font-mono text-xs whitespace-pre-wrap">
+            {args.code}
+          </pre>
+          {status.type !== "running" && output && (
+            <div className="mt-2 border-t pt-2">
+              <p className="text-muted-foreground font-semibold">
+                {output.success ? "Result:" : "Error:"}
+              </p>
+              <pre className="font-mono text-xs whitespace-pre-wrap">
+                {output.success ? output.result : output.error}
+              </pre>
+            </div>
+          )}
+        </div>
+      );
+    },
+  },
+});
+
+```
+
 ## components.json
 
 ```json
@@ -828,30 +849,30 @@ export default withAui(nextConfig);
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.67",
+    "@ai-sdk/openai": "^3.0.71",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.193",
+    "ai": "^6.0.204",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.17.0",
-    "next": "^16.2.6",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "lucide-react": "^1.18.0",
+    "next": "^16.2.9",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tailwind-merge": "^3.6.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@assistant-ui/next": "workspace:*",
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.3.0",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.15",
-    "tailwindcss": "^4.3.0",
+    "tailwindcss": "^4.3.1",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }

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

@@ -568,26 +568,26 @@ export default withAui(nextConfig);
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.67",
+    "@ai-sdk/openai": "^3.0.71",
     "@assistant-ui/cloud-ai-sdk": "workspace:*",
-    "ai": "^6.0.193",
+    "ai": "^6.0.204",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.17.0",
-    "next": "^16.2.6",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "lucide-react": "^1.18.0",
+    "next": "^16.2.9",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tailwind-merge": "^3.6.0"
   },
   "devDependencies": {
     "@assistant-ui/next": "workspace:*",
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.3.0",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.15",
-    "tailwindcss": "^4.3.0",
+    "tailwindcss": "^4.3.1",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }

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

@@ -328,29 +328,29 @@ export default withAui(nextConfig);
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.67",
+    "@ai-sdk/openai": "^3.0.71",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.193",
+    "ai": "^6.0.204",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.17.0",
-    "next": "^16.2.6",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "lucide-react": "^1.18.0",
+    "next": "^16.2.9",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "tailwind-merge": "^3.6.0"
   },
   "devDependencies": {
     "@assistant-ui/next": "workspace:*",
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@tailwindcss/postcss": "^4.3.0",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.15",
-    "tailwindcss": "^4.3.0",
+    "tailwindcss": "^4.3.1",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3"
   }