@assistant-ui/mcp-docs-server 0.1.20 → 0.1.22

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

@@ -162,29 +162,68 @@ export default function RootLayout({
 ```tsx
 "use client";
 
-import React, { useMemo } from "react";
-import { AssistantRuntimeProvider } from "@assistant-ui/react";
+import { useEffect, useMemo, useRef, useState, type ReactNode } from "react";
+import {
+  AssistantRuntimeProvider,
+  type ThreadMessage,
+} from "@assistant-ui/react";
 import { HttpAgent } from "@ag-ui/client";
 import { useAgUiRuntime } from "@assistant-ui/react-ag-ui";
 
+type StoredThread = {
+  id: string;
+  messages: readonly ThreadMessage[];
+};
+
 /**
- * Minimal example: instantiate AG-UI runtime and provide to Assistant UI.
+ * AG-UI runtime with threadList adapter for multi-thread support.
  */
 export function MyRuntimeProvider({
   children,
-}: Readonly<{ children: React.ReactNode }>) {
+}: Readonly<{ children: ReactNode }>) {
   const agentUrl =
     (process.env["NEXT_PUBLIC_AGUI_AGENT_URL"] as string | undefined) ??
     "http://localhost:8000/agent";
 
+  // Simple in-memory thread storage
+  const threadsRef = useRef<Map<string, StoredThread>>(new Map());
+  const [currentThreadId, setCurrentThreadId] = useState<string>(() => {
+    const id = crypto.randomUUID();
+    threadsRef.current.set(id, { id, messages: [] });
+    return id;
+  });
+
   const agent = useMemo(() => {
     return new HttpAgent({
       url: agentUrl,
+      threadId: currentThreadId,
       headers: {
         Accept: "text/event-stream",
       },
     });
-  }, [agentUrl]);
+  }, [agentUrl, currentThreadId]);
+
+  const threadListAdapter = useMemo(
+    () => ({
+      threadId: currentThreadId,
+      onSwitchToNewThread: async () => {
+        const newId = crypto.randomUUID();
+        threadsRef.current.set(newId, { id: newId, messages: [] });
+        setCurrentThreadId(newId);
+        console.debug("[agui] Switched to new thread:", newId);
+      },
+      onSwitchToThread: async (threadId: string) => {
+        const thread = threadsRef.current.get(threadId);
+        if (!thread) {
+          throw new Error(`Thread ${threadId} not found`);
+        }
+        setCurrentThreadId(threadId);
+        console.debug("[agui] Switched to thread:", threadId);
+        return { messages: thread.messages };
+      },
+    }),
+    [currentThreadId],
+  );
 
   const runtime = useAgUiRuntime({
     agent,
@@ -192,8 +231,21 @@ export function MyRuntimeProvider({
       debug: (...a: any[]) => console.debug("[agui]", ...a),
       error: (...a: any[]) => console.error("[agui]", ...a),
     },
+    adapters: {
+      threadList: threadListAdapter,
+    },
   });
 
+  // Persist messages to threadsRef when they change
+  useEffect(() => {
+    return runtime.thread.subscribe(() => {
+      threadsRef.current.set(currentThreadId, {
+        id: currentThreadId,
+        messages: runtime.thread.getState().messages,
+      });
+    });
+  }, [runtime, currentThreadId]);
+
   return (
     <AssistantRuntimeProvider runtime={runtime}>
       {children}
@@ -208,10 +260,11 @@ export function MyRuntimeProvider({
 ```tsx
 "use client";
 
-import { useAssistantTool } from "@assistant-ui/react";
+import { useAssistantRuntime, useAssistantTool } from "@assistant-ui/react";
 import { Thread } from "@/components/assistant-ui/thread";
+import { PlusIcon } from "lucide-react";
 
-const BrowserAlertTool = () => {
+function BrowserAlertTool() {
   useAssistantTool<{ message: string }, { status: string }>({
     toolName: "browser_alert",
     description: "Display a native browser alert dialog to the user.",
@@ -248,11 +301,26 @@ const BrowserAlertTool = () => {
   });
 
   return null;
-};
+}
+
+function NewThreadButton() {
+  const runtime = useAssistantRuntime();
+
+  return (
+    <button
+      onClick={() => runtime.switchToNewThread()}
+      className="absolute top-4 right-4 z-10 flex items-center gap-2 rounded-lg border bg-background px-3 py-2 font-medium text-sm shadow-sm transition-colors hover:bg-accent"
+    >
+      <PlusIcon className="size-4" />
+      New Thread
+    </button>
+  );
+}
 
 export default function Home() {
   return (
-    <main className="h-dvh">
+    <main className="relative h-dvh">
+      <NewThreadButton />
       <Thread />
       <BrowserAlertTool />
     </main>
@@ -330,7 +398,7 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ag-ui/client": "^0.0.43",
+    "@ag-ui/client": "^0.0.44",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ag-ui": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
@@ -343,7 +411,7 @@ export default nextConfig;
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.563.0",
-    "next": "^16.1.5",
+    "next": "^16.1.6",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.4.0"
@@ -351,8 +419,8 @@ export default nextConfig;
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
     "@tailwindcss/postcss": "^4.1.18",
-    "@types/node": "^25.0.10",
-    "@types/react": "^19.2.9",
+    "@types/node": "^25.2.1",
+    "@types/react": "^19.2.13",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.6",
     "tailwindcss": "^4.1.18",
@@ -379,7 +447,22 @@ npx assistant-ui@latest create my-app --example with-ag-ui
 cd my-app
 ```
 
-### Environment Variables
+### 1. Start the Backend Agent
+
+```bash
+# Install Python dependencies
+pip install -r server/requirements.txt
+
+# Run the agent (echo mode by default)
+python server/agent.py
+
+# Or with OpenAI integration
+OPENAI_API_KEY=sk-xxx python server/agent.py
+```
+
+The agent will start at `http://localhost:8000/agent`.
+
+### 2. Configure Environment
 
 Create `.env.local`:
 
@@ -387,19 +470,32 @@ Create `.env.local`:
 NEXT_PUBLIC_AGUI_AGENT_URL=http://localhost:8000/agent
 ```
 
-### Run
+### 3. Run the Frontend
 
 ```bash
-npm run dev
+pnpm dev
 ```
 
 ## Features
 
 - AG-UI protocol integration via `@assistant-ui/react-ag-ui`
+- Multi-thread support with "New Thread" button
 - Custom browser alert tool demonstration
 - Client-side tool execution
 - Tool result rendering
 
+## Backend Agent
+
+The included `server/agent.py` provides:
+
+- **Echo mode** (default): Echoes back user messages for testing
+- **OpenAI mode**: Uses GPT-4o-mini when `OPENAI_API_KEY` is set
+
+### Endpoints
+
+- `POST /agent` - AG-UI agent endpoint (SSE streaming)
+- `GET /health` - Health check
+
 ## Related Documentation
 
 - [assistant-ui Documentation](https://www.assistant-ui.com/docs)

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

@@ -289,7 +289,7 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.19",
+    "@ai-sdk/openai": "^3.0.25",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
@@ -299,11 +299,11 @@ export default nextConfig;
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-slot": "^1.2.4",
     "@radix-ui/react-tooltip": "^1.2.8",
-    "ai": "^6.0.50",
+    "ai": "^6.0.73",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.563.0",
-    "next": "^16.1.5",
+    "next": "^16.1.6",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.4.0",
@@ -312,8 +312,8 @@ export default nextConfig;
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
     "@tailwindcss/postcss": "^4.1.18",
-    "@types/node": "^25.0.10",
-    "@types/react": "^19.2.9",
+    "@types/node": "^25.2.1",
+    "@types/react": "^19.2.13",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.6",
     "tailwindcss": "^4.1.18",

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

@@ -418,7 +418,7 @@ export default nextConfig;
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.563.0",
-    "next": "^16.1.5",
+    "next": "^16.1.6",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.4.0",
@@ -427,8 +427,8 @@ export default nextConfig;
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
     "@tailwindcss/postcss": "^4.1.18",
-    "@types/node": "^25.0.10",
-    "@types/react": "^19.2.9",
+    "@types/node": "^25.2.1",
+    "@types/react": "^19.2.13",
     "@types/react-dom": "^19.2.3",
     "postcss": "^8.5.6",
     "tailwindcss": "^4.1.18",