@assistant-ui/mcp-docs-server 0.1.28 → 0.1.29

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

@@ -474,28 +474,28 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.51",
+    "@ai-sdk/openai": "^3.0.52",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.7.0",
-    "next": "^16.2.2",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "lucide-react": "^1.8.0",
+    "next": "^16.2.3",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
     "@tailwindcss/postcss": "^4.2.2",
-    "@types/node": "^25.5.2",
+    "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.8",
+    "postcss": "^8.5.9",
     "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "5.9.3"
+    "typescript": "^6.0.2"
   }
 }
 

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

@@ -537,32 +537,32 @@ export default nextConfig;
     "start": "next start"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.51",
+    "@ai-sdk/openai": "^3.0.52",
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-ai-sdk": "workspace:*",
     "@assistant-ui/react-hook-form": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@assistant-ui/ui": "workspace:*",
-    "ai": "^6.0.148",
+    "ai": "^6.0.159",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.7.0",
-    "next": "^16.2.2",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "lucide-react": "^1.8.0",
+    "next": "^16.2.3",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "react-hook-form": "^7.72.1",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
     "@tailwindcss/postcss": "^4.2.2",
-    "@types/node": "^25.5.2",
+    "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.8",
+    "postcss": "^8.5.9",
     "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "5.9.3"
+    "typescript": "^6.0.2"
   }
 }
 

package/.docs/organized/code-examples/with-react-ink.md

@@ -16,14 +16,14 @@
   "dependencies": {
     "@assistant-ui/react-ink": "workspace:*",
     "@assistant-ui/react-ink-markdown": "workspace:*",
-    "ink": "^6.8.0",
-    "react": "^19.2.4"
+    "ink": "^7.0.0",
+    "react": "^19.2.5"
   },
   "devDependencies": {
     "@types/react": "^19.2.14",
     "esbuild": "^0.28.0",
     "tsx": "^4.21.0",
-    "typescript": "5.9.3"
+    "typescript": "^6.0.2"
   }
 }
 

package/.docs/organized/code-examples/with-react-router.md

@@ -777,11 +777,11 @@ export default function Home() {
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "eventsource-parser": "^3.0.6",
-    "isbot": "^5.1.37",
-    "lucide-react": "^1.7.0",
-    "openai": "^6.33.0",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "isbot": "^5.1.38",
+    "lucide-react": "^1.8.0",
+    "openai": "^6.34.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "react-router": "^7.14.0",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.5.0"
@@ -789,13 +789,13 @@ export default function Home() {
   "devDependencies": {
     "@react-router/dev": "^7.14.0",
     "@tailwindcss/vite": "^4.2.2",
-    "@types/node": "^25.5.2",
+    "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "5.9.3",
-    "vite": "^8.0.5",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.8",
     "vite-tsconfig-paths": "^6.1.1"
   }
 }

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

@@ -488,20 +488,20 @@ export default nextConfig;
   "dependencies": {
     "@assistant-ui/store": "workspace:*",
     "@assistant-ui/tap": "workspace:*",
-    "next": "^16.2.2",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4"
+    "next": "^16.2.3",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
     "@tailwindcss/postcss": "^4.2.2",
-    "@types/node": "^25.5.2",
+    "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.8",
+    "postcss": "^8.5.9",
     "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "5.9.3"
+    "typescript": "^6.0.2"
   }
 }
 

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

@@ -65,15 +65,15 @@
     "@assistant-ui/react": "workspace:*",
     "@assistant-ui/react-markdown": "workspace:*",
     "@tailwindcss/vite": "^4.2.2",
-    "@tanstack/react-router": "^1.168.10",
-    "@tanstack/react-start": "^1.167.16",
+    "@tanstack/react-router": "^1.168.19",
+    "@tanstack/react-start": "^1.167.35",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.7.0",
-    "nitro": "^3.0.1-alpha.2",
-    "openai": "^6.33.0",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "lucide-react": "^1.8.0",
+    "nitro": "^3.0.260311-beta",
+    "openai": "^6.34.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.5.0",
     "tailwindcss": "^4.2.2",
@@ -81,12 +81,12 @@
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
-    "@types/node": "^25.5.2",
+    "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.1",
-    "typescript": "5.9.3",
-    "vite": "^8.0.5"
+    "typescript": "^6.0.2",
+    "vite": "^8.0.8"
   }
 }
 

package/.docs/organized/code-examples/with-tap-runtime.md

@@ -597,22 +597,22 @@ export default nextConfig;
     "@assistant-ui/ui": "workspace:*",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.7.0",
-    "next": "^16.2.2",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "lucide-react": "^1.8.0",
+    "next": "^16.2.3",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "workspace:*",
     "@tailwindcss/postcss": "^4.2.2",
-    "@types/node": "^25.5.2",
+    "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "postcss": "^8.5.8",
+    "postcss": "^8.5.9",
     "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
-    "typescript": "5.9.3"
+    "typescript": "^6.0.2"
   }
 }
 

package/.docs/raw/docs/(docs)/guides/voice.mdx

@@ -303,14 +303,21 @@ const runtime = useChatRuntime({
 
 ## Example: LiveKit
 
-[LiveKit](https://livekit.io/) provides realtime voice via WebRTC rooms with transcription support.
+[LiveKit](https://livekit.io/) provides realtime voice via WebRTC rooms with transcription support. Unlike fully-hosted agent services, LiveKit follows a "bring-your-own-agent" model: the browser adapter only joins a room, and you run a separate **agent worker** that joins the same room and handles STT, LLM, and TTS. Without an agent in the room, the client will connect successfully but have nothing to talk to.
+
+### Prerequisites
+
+1. **A LiveKit server** — create a [LiveKit Cloud](https://cloud.livekit.io/) project (grab the URL, API Key, and API Secret from the project settings) or self-host `livekit-server`.
+2. **An agent worker** — built with the [LiveKit Agents SDK](https://docs.livekit.io/agents/) (Python or Node). The worker connects to your LiveKit server and is automatically dispatched into new rooms.
 
 ### Install Dependencies
 
 ```bash
-npm install livekit-client
+npm install livekit-client livekit-server-sdk
 ```
 
+`livekit-client` powers the browser adapter; `livekit-server-sdk` is used server-side to mint access tokens.
+
 ### Usage
 
 ```tsx
@@ -330,4 +337,4 @@ const runtime = useChatRuntime({
 });
 ```
 
-See the `examples/with-livekit` directory in the repository for a complete implementation including the adapter and token endpoint.
+See the [`with-livekit` example](https://github.com/assistant-ui/assistant-ui/tree/main/examples/with-livekit) for a complete implementation: the browser adapter, the token endpoint, and a minimal Python agent worker using the OpenAI Realtime API.

package/.docs/raw/docs/runtimes/custom/custom-thread-list.mdx

@@ -238,12 +238,12 @@ const aui = useAui();
 
 const history = useMemo<ThreadHistoryAdapter>(
   () => ({
-    async append(message) {
+    async append({ message, parentId }) {
       // Wait for initialization to complete and get the remoteId
       const { remoteId } = await aui.threadListItem().initialize();
 
       // Now safe to save the message using the remoteId
-      await saveMessageToDatabase(remoteId, message);
+      await saveMessageToDatabase(remoteId, parentId, message);
     },
     // ...
   }),

package/.docs/raw/docs/runtimes/custom/external-store.mdx

@@ -424,6 +424,44 @@ const onEdit = async (message: AppendMessage) => {
 };
 ```
 
+### Branching Support
+
+The `messages` array path assumes a linear conversation — each message's parent is the previous message. To support branching (e.g. regenerating responses creates alternative branches), use `ExportedMessageRepository.fromBranchableArray()` combined with `thread.import()`.
+
+Each message must have an explicit `id` and `parentId`. Messages with the same `parentId` create branches:
+
+```tsx
+import {
+  ExportedMessageRepository,
+  useExternalStoreRuntime,
+} from "@assistant-ui/react";
+
+// Your messages from the backend, each with an id and parentId
+const backendMessages = [
+  { id: "user-1", role: "user", content: "Hello", parentId: null },
+  { id: "asst-1", role: "assistant", content: "Hi!", parentId: "user-1" },
+  // A second response to the same user message = a branch
+  { id: "asst-2", role: "assistant", content: "Hey!", parentId: "user-1" },
+];
+
+// Convert to ExportedMessageRepository
+const repo = ExportedMessageRepository.fromBranchableArray(
+  backendMessages.map((m) => ({
+    message: { id: m.id, role: m.role, content: m.content },
+    parentId: m.parentId,
+  })),
+  { headId: "asst-1" }, // which branch to display initially
+);
+
+// Import into the runtime
+runtime.thread.import(repo);
+```
+
+<Callout type="warn">
+  Messages in the array must be ordered so that parents appear before their
+  children. Each message **must** have an `id` field set.
+</Callout>
+
 ### Tool Calling
 
 Support tool calls with proper result handling:

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

@@ -501,26 +501,69 @@ export function MyRuntimeProvider({ children }) {
               const { remoteId } = aui.threadListItem().getState();
               if (!remoteId) return { messages: [] };
 
-              const messages = await db.messages.findByThreadId(remoteId);
+              const rows = await db.messages.findByThreadId(remoteId);
               return {
-                messages: messages.map((m) => ({
-                  role: m.role,
-                  content: m.content,
-                  id: m.id,
-                  createdAt: new Date(m.createdAt),
-                })),
+                messages: rows.map((row) => {
+                  const common = {
+                    id: row.id,
+                    createdAt: new Date(row.createdAt),
+                  };
+                  // `content` is stored as JSON — parse back into message parts
+                  const content = JSON.parse(row.content);
+
+                  if (row.role === "user") {
+                    return {
+                      parentId: row.parentId,
+                      message: {
+                        ...common,
+                        role: "user" as const,
+                        content,
+                        attachments: [],
+                        metadata: { custom: {} },
+                      },
+                    };
+                  }
+                  if (row.role === "assistant") {
+                    return {
+                      parentId: row.parentId,
+                      message: {
+                        ...common,
+                        role: "assistant" as const,
+                        content,
+                        status: { type: "complete", reason: "stop" } as const,
+                        metadata: {
+                          custom: {},
+                          unstable_state: null,
+                          unstable_annotations: [],
+                          unstable_data: [],
+                          steps: [],
+                        },
+                      },
+                    };
+                  }
+                  return {
+                    parentId: row.parentId,
+                    message: {
+                      ...common,
+                      role: "system" as const,
+                      content,
+                      metadata: { custom: {} },
+                    },
+                  };
+                }),
               };
             },
 
-            async append(message) {
+            async append({ message, parentId }) {
               // Wait for initialization to get remoteId (safe to call multiple times)
               const { remoteId } = await aui.threadListItem().initialize();
 
               await db.messages.create({
                 threadId: remoteId,
-                role: message.role,
-                content: message.content,
+                parentId,
                 id: message.id,
+                role: message.role,
+                content: JSON.stringify(message.content),
                 createdAt: message.createdAt,
               });
             },
@@ -584,10 +627,10 @@ const aui = useAui();
 
 const history = useMemo<ThreadHistoryAdapter>(
   () => ({
-    async append(message) {
+    async append({ message, parentId }) {
       // Wait for initialization - safe to call multiple times
       const { remoteId } = await aui.threadListItem().initialize();
-      await db.messages.create({ threadId: remoteId, ...message });
+      await db.messages.create({ threadId: remoteId, parentId, ...message });
     },
     // ...
   }),
@@ -613,8 +656,9 @@ interface ThreadRecord {
 interface MessageRecord {
   id: string;
   threadId: string;
+  parentId: string | null;
   role: "user" | "assistant" | "system";
-  content: any; // Store as JSON
+  content: string; // JSON-encoded message content parts
   createdAt: Date;
 }
 ```
@@ -693,18 +737,21 @@ Persist and resume conversations:
 ```tsx
 const historyAdapter: ThreadHistoryAdapter = {
   async load() {
-    // Load messages from your storage
+    // Load messages from your storage.
+    // The API must return `{ messages: { parentId, message }[] }`
+    // where each `message` is a full ThreadMessage
+    // (including `metadata.custom`, plus `attachments` on user messages
+    // and `status` + the rest of `metadata` on assistant messages).
     const response = await fetch(`/api/thread/current`);
-    const { messages } = await response.json();
-    return { messages };
+    return await response.json();
   },
 
-  async append(message) {
+  async append({ message, parentId }) {
     // Save new message to storage
     await fetch(`/api/thread/messages`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ message }),
+      body: JSON.stringify({ message, parentId }),
     });
   },
 

package/.docs/raw/docs/runtimes/google-adk/index.mdx

@@ -317,6 +317,64 @@ function AuthUI() {
 
 `AdkAuthCredential` supports all ADK auth types: `apiKey`, `http`, `oauth2`, `openIdConnect`, `serviceAccount`.
 
+### Input Requests
+
+When an ADK Python 2.0+ Workflow's `RequestInput` node pauses execution to ask the user a question, ADK emits an `adk_request_input` function call marked as long-running. Respond with `useAdkSubmitInput` inside a tool UI — the helper wraps the answer as `{ result }` to match ADK's `unwrap_response` contract, so the Workflow node resumes with the unwrapped value:
+
+```tsx
+import { makeAssistantToolUI } from "@assistant-ui/react";
+import { useAdkSubmitInput } from "@assistant-ui/react-google-adk";
+
+type RequestInputArgs = {
+  interrupt_id?: string;
+  message?: string;
+  payload?: unknown;
+  response_schema?: unknown;
+};
+
+export const RequestInputToolUI = makeAssistantToolUI<RequestInputArgs, unknown>({
+  toolName: "adk_request_input",
+  render: function RequestInputUI({ toolCallId, args, result }) {
+    const submitInput = useAdkSubmitInput();
+
+    if (result !== undefined) {
+      return <p>Answered: {String(result)}</p>;
+    }
+
+    return (
+      <form
+        onSubmit={(e) => {
+          e.preventDefault();
+          const value = (
+            e.currentTarget.elements.namedItem("answer") as HTMLInputElement
+          ).value;
+          submitInput(toolCallId, value);
+        }}
+      >
+        <p>{args.message ?? "Please provide input:"}</p>
+        <input name="answer" autoFocus />
+        <button type="submit">Submit</button>
+      </form>
+    );
+  },
+});
+```
+
+Register the tool UI inside `AssistantRuntimeProvider`:
+
+```tsx
+<AssistantRuntimeProvider runtime={runtime}>
+  <RequestInputToolUI />
+  <Thread />
+</AssistantRuntimeProvider>
+```
+
+<Callout type="info">
+  `adk_request_input` is emitted only by ADK Python 2.0+ Workflow `RequestInput` nodes — ADK JS has no equivalent. Always respond via a tool UI with `useAdkSubmitInput`; HITL interrupts are automatically exempt from `autoCancelPendingToolCalls`, so typing a normal message in the composer will not overwrite the pending interrupt.
+</Callout>
+
+`useAdkSubmitInput` is sugar over the generic `addResult` — if you prefer, you can call `addResult({ result: value })` from inside the render function directly. The `{ result }` wrapper is required either way: the adapter JSON-stringifies the value before sending, and ADK's `unwrap_response` unwraps it on the backend before the Workflow node resumes.
+
 ### Artifacts
 
 Track file artifacts created or modified by the agent:
@@ -384,6 +442,8 @@ function PendingToolsIndicator() {
 }
 ```
 
+This hook reports every tool call ADK marked via `long_running_tool_ids`, including HITL interrupts. To respond to a specific HITL type, see [Tool Confirmations](#tool-confirmations), [Auth Requests](#auth-requests), or [Input Requests](#input-requests).
+
 ### Per-Message Metadata
 
 Access grounding, citation, and token usage metadata per message:
@@ -581,6 +641,7 @@ The resolved `checkpointId` is passed to your `stream` callback via `config.chec
 | `useAdkSend()` | Send raw ADK messages |
 | `useAdkConfirmTool()` | Confirm or deny a pending tool confirmation |
 | `useAdkSubmitAuth()` | Submit auth credentials for a pending auth request |
+| `useAdkSubmitInput()` | Submit the user's answer for a pending `adk_request_input` HITL interrupt |
 | `useAdkToolConfirmations()` | Pending tool confirmation requests |
 | `useAdkAuthRequests()` | Pending auth credential requests |
 | `useAdkLongRunningToolIds()` | IDs of long-running tools awaiting input |
@@ -596,6 +657,7 @@ The resolved `checkpointId` is passed to your `stream` callback via `config.chec
 | Tool calls & results | Supported |
 | Tool confirmations (`useAdkConfirmTool`) | Supported |
 | Auth credential flow (`useAdkSubmitAuth`) | Supported |
+| Workflow input requests (`useAdkSubmitInput`, ADK Python 2.0+) | Supported |
 | Multi-agent (author/branch tracking) | Supported |
 | Agent transfer events | Supported |
 | Escalation detection | Supported |