@assistant-ui/mcp-docs-server 0.2.1 → 0.2.3

package/.docs/raw/docs/guides/quoting.mdx

@@ -4,7 +4,7 @@ description: Let users select text from AI messages and quote it back into the c
 platforms: ["react"]
 ---
 
-import { QuoteComposerSample } from "@/components/docs/samples/quote-composer";
+import { QuoteComposerSample } from "@/components/pages/docs/samples/quote-composer";
 
 <QuoteComposerSample />
 

package/.docs/raw/docs/guides/resumable-streams.mdx

@@ -84,7 +84,7 @@ The context exposes two more verbs: `ctx.status(streamId)` returns `"streaming"
 
 ## Client side: native integration
 
-`@assistant-ui/react-ai-sdk` ships a `resumable` option on `AssistantChatTransport`. It captures the stream id from the response header, redirects `chat.resumeStream()` reconnects to your resume route, and clears the stored id when the response finishes naturally. Pair it with `useChatRuntime`, which fires `chat.resumeStream()` whenever its resumable storage reports a pending id, including ids discovered after mount.
+`@assistant-ui/ai-sdk` ships a `resumable` option on `AssistantChatTransport`. It captures the stream id from the response header, redirects `chat.resumeStream()` reconnects to your resume route, and clears the stored id when the response finishes naturally. Pair it with `useChatRuntime`, which fires `chat.resumeStream()` whenever its resumable storage reports a pending id, including ids discovered after mount.
 
 ```tsx title="/app/page.tsx"
 "use client";
@@ -94,7 +94,7 @@ import {
   AssistantChatTransport,
   createResumableSessionStorage,
   useChatRuntime,
-} from "@assistant-ui/react-ai-sdk";
+} from "@assistant-ui/ai-sdk";
 import { useMemo } from "react";
 import { Thread } from "@/components/assistant-ui/thread";
 
@@ -153,7 +153,7 @@ import {
   AssistantChatTransport,
   createResumableSessionStorage,
   useChatRuntime,
-} from "@assistant-ui/react-ai-sdk";
+} from "@assistant-ui/ai-sdk";
 import { useMemo } from "react";
 import { Thread } from "@/components/assistant-ui/thread";
 import { ThreadList } from "@/components/assistant-ui/thread-list";

package/.docs/raw/docs/guides/speech.mdx

@@ -4,7 +4,7 @@ description: Read AI chat messages aloud with the Web Speech API or a custom TTS
 platforms: ["react"]
 ---
 
-import { SpeechSample } from "@/components/docs/samples/speech";
+import { SpeechSample } from "@/components/pages/docs/samples/speech";
 
 assistant-ui supports text-to-speech via the `SpeechSynthesisAdapter` interface. When a speech adapter is configured, users can trigger playback for any assistant message.
 

package/.docs/raw/docs/guides/suggestions.mdx

@@ -16,7 +16,7 @@ Configure suggestions using the `Suggestions()` API in your runtime provider:
 
 ```tsx
 import { AuiConfig, Tools, Suggestions } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/ai-sdk";
 
 function MyRuntimeProvider({ children }: { children: React.ReactNode }) {
   const runtime = useChatRuntime();
@@ -138,7 +138,7 @@ The primitives available for rendering suggestions are `ThreadPrimitive.Suggesti
 
 ## Runtime driven suggestions
 
-The static `Suggestions(...)` API covers welcome screens. For follow up prompts that depend on the conversation, a tool result, or your backend, push suggestions through the runtime itself. They land on `thread.suggestions` rather than the static `suggestions` scope, so they render through a different component.
+The static `Suggestions(...)` API covers welcome screens. For follow up prompts that depend on the conversation, a tool result, or your backend, push suggestions through the runtime itself. They land on `thread.suggestions`, and when no static `Suggestions(...)` configuration is set, the `suggestions` scope derives from them, so `ThreadPrimitive.Suggestions` renders them as well. Runtime suggestions use the `ThreadSuggestion` shape: a required `prompt` plus optional `title` and `label`. When `title` is omitted it falls back to the prompt, and an omitted `label` renders as empty, so a prompt-only runtime suggestion looks exactly like a plain string suggestion.
 
 ### Local runtime: `SuggestionAdapter`
 
@@ -218,7 +218,7 @@ They also accept the same `suggestion` adapter as the local runtime under `adapt
 
 ```tsx
 import { createSuggestionAdapter } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/ai-sdk";
 
 const runtime = useChatRuntime({
   adapters: {
@@ -263,7 +263,7 @@ The local runtime clears its suggestions when a new run starts. External store r
 
 ### Rendering runtime suggestions
 
-Static suggestions go through `ThreadPrimitive.Suggestions`; runtime suggestions go through `thread.suggestions`. The shadcn registry ships `ThreadFollowupSuggestions` for the common single line pill layout. For a custom layout, read the array yourself:
+Runtime suggestions land on `thread.suggestions`, and `ThreadPrimitive.Suggestions` picks them up unless a static `Suggestions(...)` configuration overrides the scope. The shadcn registry ships `ThreadFollowupSuggestions` for the common single line pill layout. For a custom layout, read the array yourself:
 
 ```tsx
 import { useAuiState, ThreadPrimitive, AuiIf } from "@assistant-ui/react";
@@ -280,7 +280,10 @@ function FollowUps() {
             method="replace"
             autoSend
           >
-            {s.prompt}
+            {s.title ?? s.prompt}
+            {s.label && (
+              <span className="text-muted-foreground ms-1">{s.label}</span>
+            )}
           </ThreadPrimitive.Suggestion>
         ))}
       </div>

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

@@ -4,7 +4,7 @@ description: Build bidirectional voice conversations with AI in React. Realtime
 platforms: ["react"]
 ---
 
-import { VoiceSample } from "@/components/docs/samples/voice";
+import { VoiceSample } from "@/components/pages/docs/samples/voice";
 
 assistant-ui supports realtime bidirectional voice through the `RealtimeVoiceAdapter` interface. Users speak into their microphone, the agent answers with audio, and transcripts appear in the thread while the session runs.
 

package/.docs/raw/docs/ink/hooks.mdx

@@ -129,7 +129,7 @@ const runtime = useLocalRuntime(chatModel, {
 | `adapters.dictation` | `DictationAdapter` | Adapter for speech-to-text input |
 | `adapters.feedback` | `FeedbackAdapter` | Adapter for message feedback (thumbs up/down) |
 | `adapters.suggestion` | `SuggestionAdapter` | Adapter for suggested prompts |
-| `cloud` | `AssistantCloud` | Cloud instance for thread persistence via `@assistant-ui/cloud` |
+| `cloud` | `AssistantCloud` | Cloud instance for thread persistence via `assistant-cloud` |
 | `unstable_humanToolNames` | `string[]` | Tool names that pause the run until a result is added via `addResult` |
 
 ### useRemoteThreadListRuntime

package/.docs/raw/docs/ink/index.mdx

@@ -127,6 +127,7 @@ Use primitives to compose your terminal chat interface:
 ```tsx title="components/thread.tsx"
 import { Box, Text } from "ink";
 import {
+  AuiIf,
   ThreadPrimitive,
   ComposerPrimitive,
   LoadingPrimitive,
@@ -170,11 +171,11 @@ const StatusIndicator = () => (
 export const Thread = () => {
   return (
     <ThreadPrimitive.Root>
-      <ThreadPrimitive.Empty>
+      <AuiIf condition={(s) => s.thread.isEmpty}>
         <Box marginBottom={1}>
           <Text dimColor>No messages yet. Start typing below!</Text>
         </Box>
-      </ThreadPrimitive.Empty>
+      </AuiIf>
 
       <ThreadPrimitive.Messages>
         {() => <Message />}

package/.docs/raw/docs/ink/migration.mdx

@@ -8,7 +8,7 @@ If you already have an assistant-ui web app, most of your code transfers directl
 ## What stays the same
 
 - **Runtime setup** — `useLocalRuntime`, `ChatModelAdapter`, and all runtime options work identically.
-- **AI SDK integration** — `@assistant-ui/react-ai-sdk` works with React Ink. Your runtime setup transfers directly.
+- **AI SDK integration** — `@assistant-ui/ai-sdk` works with React Ink. Your runtime setup transfers directly.
 - **Tool definitions** — `Tools({ toolkit })` and toolkit renderers use the same API.
 - **State hooks** — `useAuiState`, `useAui`, and selector patterns are the same.
 - **Backend code** — Your API routes, streaming endpoints, and server-side logic need zero changes.

package/.docs/raw/docs/ink/primitives.mdx

@@ -1217,7 +1217,7 @@ Container `Box` for the status bar. Forwards all `Box` props; pass `gap` to spac
 ```tsx
 <StatusBarPrimitive.Root gap={1}>
   <StatusBarPrimitive.Status />
-  <StatusBarPrimitive.ModelName name="gpt-5" />
+  <StatusBarPrimitive.ModelName name="gpt-5.6-luna" />
   <StatusBarPrimitive.MessageCount />
   <StatusBarPrimitive.TokenCount />
   <StatusBarPrimitive.Latency />

package/.docs/raw/docs/integrations/attachments/custom-adapter.mdx

@@ -340,7 +340,7 @@ The shape of `content` matches the AI SDK part types. Use `image` for images and
 "use client";
 
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/ai-sdk";
 import { attachmentAdapter } from "./attachment-adapter";
 
 export function MyProvider({ children }: { children: React.ReactNode }) {
@@ -363,7 +363,7 @@ import { AssistantRuntimeProvider } from "@assistant-ui/react-native";
 import {
   AssistantChatTransport,
   useChatRuntime,
-} from "@assistant-ui/react-ai-sdk";
+} from "@assistant-ui/ai-sdk";
 import { attachmentAdapter } from "./attachment-adapter";
 
 export function MyProvider({ children }: { children: React.ReactNode }) {
@@ -387,7 +387,7 @@ import { AssistantRuntimeProvider } from "@assistant-ui/react-ink";
 import {
   AssistantChatTransport,
   useChatRuntime,
-} from "@assistant-ui/react-ai-sdk";
+} from "@assistant-ui/ai-sdk";
 import { attachmentAdapter } from "./attachment-adapter";
 
 export function MyProvider({ children }: { children: React.ReactNode }) {

package/.docs/raw/docs/integrations/frameworks/ai-sdk.mdx

@@ -1,5 +1,5 @@
 ---
-title: Vercel AI SDK Integration
+title: Vercel AI SDK
 description: Wire the Vercel AI SDK into a React chat UI with assistant-ui — useChat, streaming, tools, attachments, multi-step agents, and persistence covered end-to-end.
 ---
 
@@ -16,14 +16,14 @@ If you arrived here looking to wire up your first chat: jump to [AI SDK v7 quick
 ```mermaid
 flowchart LR
     client["client"]
-    runtime["useChatRuntime (react-ai-sdk)<br/>(thread state · tool calls · attachments<br/>speech · dictation · feedback adapters)"]
+    runtime["useChatRuntime (ai-sdk)<br/>(thread state · tool calls · attachments<br/>speech · dictation · feedback adapters)"]
     api["/api/chat<br/>(streamText)"]
     provider["provider"]
 
     client --> runtime --> api --> provider
 ```
 
-`@assistant-ui/react-ai-sdk` wraps the AI SDK's `useChat` hook and exposes it as an assistant-ui runtime. The runtime owns conversation state on the client; your `/api/chat` route returns a UI message stream from `streamText`. Everything else (tools, attachments, observability, gateways, custom persistence) layers on top of this base.
+`@assistant-ui/ai-sdk` wraps the AI SDK's `useChat` hook and exposes it as an assistant-ui runtime. The runtime owns conversation state on the client; your `/api/chat` route returns a UI message stream from `streamText`. Everything else (tools, attachments, observability, gateways, custom persistence) layers on top of this base.
 
 ## Pick a version
 

package/.docs/raw/docs/integrations/frameworks/{cloudflare-agents/overview.mdx → cloudflare-agents.mdx}

@@ -1,6 +1,7 @@
 ---
-title: Cloudflare Agents Integration
+title: Cloudflare Agents
 description: Wire Cloudflare's stateful agent framework into a React chat UI with assistant-ui via the standard AI SDK runtime. WebSocket transport, server-side persistence, tool calling, all preserved.
+platforms: ["react"]
 ---
 
 import { CloudflareIcon } from "@/components/icons/cloudflare";
@@ -16,7 +17,7 @@ This is an integration guide, not a runtime adapter. assistant-ui does not ship
 
 Cloudflare Agents handles the server half: a Durable Object subclasses `AIChatAgent` from `@cloudflare/ai-chat`, owns the message history, and streams responses back over a WebSocket. `@cloudflare/ai-chat/react`'s `useAgentChat` hook wraps that WebSocket and exposes the same `messages`, `sendMessage`, `regenerate`, `status`, `stop`, `setMessages`, `addToolOutput` surface that the AI SDK's `useChat` does, plus a few Cloudflare-specific extras (`clearHistory`, `isServerStreaming`, `isToolContinuation`).
 
-assistant-ui handles the client half. `useAISDKRuntime` from [`@assistant-ui/react-ai-sdk`](/docs/runtimes/ai-sdk/v7) reads exactly those AI SDK methods off whatever you pass in, so feeding it `useAgentChat`'s return value yields a fully-featured runtime: streaming, tool calling, edit, reload, history import and export, attachments, suggestions.
+assistant-ui handles the client half. `useAISDKRuntime` from [`@assistant-ui/ai-sdk`](/docs/runtimes/ai-sdk/v7) reads exactly those AI SDK methods off whatever you pass in, so feeding it `useAgentChat`'s return value yields a fully-featured runtime: streaming, tool calling, edit, reload, history import and export, attachments, suggestions.
 
 Shared adapters (attachments, speech, feedback, history) work the same way as described in [adapters](/docs/runtimes/concepts/adapters). Multi-thread support needs a [custom thread list](/docs/runtimes/concepts/threads) wired around `useAISDKRuntime`; [AssistantCloud](/docs/cloud) integrates via `useChatRuntime` (which constructs its own `useChat` internally) and is not compatible with the `useAgentChat` wiring shown here.
 
@@ -198,7 +199,7 @@ In the frontend project:
 import { useAgent } from "agents/react";
 import { useAgentChat } from "@cloudflare/ai-chat/react";
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { useAISDKRuntime } from "@assistant-ui/react-ai-sdk";
+import { useAISDKRuntime } from "@assistant-ui/ai-sdk";
 import { Thread } from "@/components/assistant-ui/thread";
 
 export const Assistant = () => {

package/.docs/raw/docs/integrations/frameworks/mastra/overview.mdx

@@ -19,7 +19,7 @@ This is an integration guide, not a runtime adapter. assistant-ui does not ship
 | [Full-stack](/docs/integrations/frameworks/mastra/full-stack) | One Next.js app: API routes call Mastra in-process. Simpler deployment, single repo. |
 | [Separate server](/docs/integrations/frameworks/mastra/separate-server) | Mastra runs as its own service; the Next.js frontend hits its API. Independent scaling, clearer separation of concerns. |
 
-Both use the same client-side `useChatRuntime` from [`@assistant-ui/react-ai-sdk`](/docs/runtimes/ai-sdk/v7). The only difference is where the Mastra agent lives.
+Both use the same client-side `useChatRuntime` from [`@assistant-ui/ai-sdk`](/docs/runtimes/ai-sdk/v7). The only difference is where the Mastra agent lives.
 
 ## Architecture
 

package/.docs/raw/docs/integrations/frameworks/mastra/separate-server.mdx

@@ -129,7 +129,7 @@ Open the file containing `useChatRuntime` (typically `app/assistant.tsx`) and pa
 "use client";
 
 import { AssistantRuntimeProvider } from "@assistant-ui/react";
-import { AssistantChatTransport, useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { AssistantChatTransport, useChatRuntime } from "@assistant-ui/ai-sdk";
 import { Thread } from "@/components/assistant-ui/thread";
 
 export const Assistant = () => {

package/.docs/raw/docs/integrations/index.mdx

@@ -11,7 +11,7 @@ import { LangChainIcon } from "@/components/icons/langchain";
 import { McpIcon } from "@/components/icons/mcp";
 import { VercelIcon } from "@/components/icons/vercel";
 
-Integrations are wiring guides for using third-party services with assistant-ui, plus canonical recipes for the adapter slots (persistence, attachments). They are distinct from [runtimes](/docs/runtimes/pick-a-runtime), which are the React adapter packages (`@assistant-ui/react-ai-sdk`, `@assistant-ui/react-langgraph`, etc.) that connect the UI to a backend. An integration assumes you already have a working runtime and adds something on top.
+Integrations are wiring guides for using third-party services with assistant-ui, plus canonical recipes for the adapter slots (persistence, attachments). They are distinct from [runtimes](/docs/runtimes/pick-a-runtime), which are the React adapter packages (`@assistant-ui/ai-sdk`, `@assistant-ui/react-langgraph`, etc.) that connect the UI to a backend. An integration assumes you already have a working runtime and adds something on top.
 
 ## Where integrations slot in
 
@@ -40,7 +40,7 @@ Framework integrations that pair with assistant-ui at the API-route layer.
       icon={<CloudflareIcon width={20} height={20} />}
       title="Cloudflare Agents"
       description="Stateful Durable Object agents. Wired through the AI SDK runtime with WebSocket streaming."
-      href="/docs/integrations/frameworks/cloudflare-agents/overview"
+      href="/docs/integrations/frameworks/cloudflare-agents"
     />
     <Card
       icon={<MastraIcon width={20} height={20} />}

package/.docs/raw/docs/integrations/persistence/custom-adapter.mdx

@@ -227,7 +227,7 @@ export async function POST(
 
 ### Implement `RemoteThreadListAdapter`
 
-The adapter calls your endpoints. `unstable_Provider` injects the per-thread history adapter so messages persist alongside metadata.
+The adapter calls your endpoints. `unstable_useAdapters` injects the per-thread history adapter on the `RemoteThreadList` store entry and on `useRemoteThreadListRuntime` when `unstable_Provider` is omitted. `unstable_Provider` is an optional React face for that runtime. On the `RemoteThreadList` store entry, key the thread factory with `withKey(id, …)` so history reloads when the visible thread changes.
 
 <PlatformTabs>
 <Tab value="React">
@@ -244,6 +244,51 @@ import {
 import { createAssistantStream } from "assistant-stream";
 import { useMemo } from "react";
 
+function useThreadListAdapters() {
+  const aui = useAui();
+  const history = useMemo<ThreadHistoryAdapter>(
+    () => ({
+      async load() {
+        return { messages: [] };
+      },
+      async append() {},
+      withFormat: (fmt) => ({
+        async load() {
+          const { remoteId } = aui.threadListItem.getState();
+          if (!remoteId) return { messages: [] };
+          const rows = await fetch(
+            `/api/threads/${remoteId}/messages`,
+          ).then((r) => r.json());
+          return {
+            messages: rows.map((row: any) =>
+              fmt.decode({
+                id: row.id,
+                parent_id: row.parent_id,
+                format: row.format,
+                content: row.content,
+              }),
+            ),
+          };
+        },
+        async append(item) {
+          const { remoteId } = await aui.threadListItem.initialize();
+          await fetch(`/api/threads/${remoteId}/messages`, {
+            method: "POST",
+            body: JSON.stringify({
+              id: fmt.getId(item.message),
+              parent_id: item.parentId,
+              format: fmt.format,
+              content: fmt.encode(item),
+            }),
+          });
+        },
+      }),
+    }),
+    [aui],
+  );
+  return useMemo(() => ({ history }), [history]);
+}
+
 export const threadListAdapter: RemoteThreadListAdapter = {
   async list() {
     const rows = await fetch("/api/threads").then((r) => r.json());
@@ -295,50 +340,11 @@ export const threadListAdapter: RemoteThreadListAdapter = {
       controller.appendText(title);
     });
   },
+  unstable_useAdapters: useThreadListAdapters,
   unstable_Provider({ children }) {
-    const aui = useAui();
-    const history = useMemo<ThreadHistoryAdapter>(
-      () => ({
-        async load() {
-          return { messages: [] };
-        },
-        async append() {},
-        withFormat: (fmt) => ({
-          async load() {
-            const { remoteId } = aui.threadListItem.getState();
-            if (!remoteId) return { messages: [] };
-            const rows = await fetch(
-              `/api/threads/${remoteId}/messages`,
-            ).then((r) => r.json());
-            return {
-              messages: rows.map((row: any) =>
-                fmt.decode({
-                  id: row.id,
-                  parent_id: row.parent_id,
-                  format: row.format,
-                  content: row.content,
-                }),
-              ),
-            };
-          },
-          async append(item) {
-            const { remoteId } = await aui.threadListItem.initialize();
-            await fetch(`/api/threads/${remoteId}/messages`, {
-              method: "POST",
-              body: JSON.stringify({
-                id: fmt.getId(item.message),
-                parent_id: item.parentId,
-                format: fmt.format,
-                content: fmt.encode(item),
-              }),
-            });
-          },
-        }),
-      }),
-      [aui],
-    );
+    const adapters = useThreadListAdapters();
     return (
-      <RuntimeAdapterProvider adapters={{ history }}>
+      <RuntimeAdapterProvider adapters={adapters}>
         {children}
       </RuntimeAdapterProvider>
     );
@@ -359,6 +365,51 @@ import {
 import { createAssistantStream } from "assistant-stream";
 import { useMemo } from "react";
 
+function useThreadListAdapters() {
+  const aui = useAui();
+  const history = useMemo<ThreadHistoryAdapter>(
+    () => ({
+      async load() {
+        return { messages: [] };
+      },
+      async append() {},
+      withFormat: (fmt) => ({
+        async load() {
+          const { remoteId } = aui.threadListItem.getState();
+          if (!remoteId) return { messages: [] };
+          const rows = await fetch(
+            `${API_URL}/threads/${remoteId}/messages`,
+          ).then((r) => r.json());
+          return {
+            messages: rows.map((row: any) =>
+              fmt.decode({
+                id: row.id,
+                parent_id: row.parent_id,
+                format: row.format,
+                content: row.content,
+              }),
+            ),
+          };
+        },
+        async append(item) {
+          const { remoteId } = await aui.threadListItem.initialize();
+          await fetch(`${API_URL}/threads/${remoteId}/messages`, {
+            method: "POST",
+            body: JSON.stringify({
+              id: fmt.getId(item.message),
+              parent_id: item.parentId,
+              format: fmt.format,
+              content: fmt.encode(item),
+            }),
+          });
+        },
+      }),
+    }),
+    [aui],
+  );
+  return useMemo(() => ({ history }), [history]);
+}
+
 export const threadListAdapter: RemoteThreadListAdapter = {
   async list() {
     const rows = await fetch(`${API_URL}/threads`).then((r) => r.json());
@@ -412,50 +463,11 @@ export const threadListAdapter: RemoteThreadListAdapter = {
       controller.appendText(title);
     });
   },
+  unstable_useAdapters: useThreadListAdapters,
   unstable_Provider({ children }) {
-    const aui = useAui();
-    const history = useMemo<ThreadHistoryAdapter>(
-      () => ({
-        async load() {
-          return { messages: [] };
-        },
-        async append() {},
-        withFormat: (fmt) => ({
-          async load() {
-            const { remoteId } = aui.threadListItem.getState();
-            if (!remoteId) return { messages: [] };
-            const rows = await fetch(
-              `${API_URL}/threads/${remoteId}/messages`,
-            ).then((r) => r.json());
-            return {
-              messages: rows.map((row: any) =>
-                fmt.decode({
-                  id: row.id,
-                  parent_id: row.parent_id,
-                  format: row.format,
-                  content: row.content,
-                }),
-              ),
-            };
-          },
-          async append(item) {
-            const { remoteId } = await aui.threadListItem.initialize();
-            await fetch(`${API_URL}/threads/${remoteId}/messages`, {
-              method: "POST",
-              body: JSON.stringify({
-                id: fmt.getId(item.message),
-                parent_id: item.parentId,
-                format: fmt.format,
-                content: fmt.encode(item),
-              }),
-            });
-          },
-        }),
-      }),
-      [aui],
-    );
+    const adapters = useThreadListAdapters();
     return (
-      <RuntimeAdapterProvider adapters={{ history }}>
+      <RuntimeAdapterProvider adapters={adapters}>
         {children}
       </RuntimeAdapterProvider>
     );
@@ -478,6 +490,51 @@ import {
 import { createAssistantStream } from "assistant-stream";
 import { useMemo } from "react";
 
+function useThreadListAdapters() {
+  const aui = useAui();
+  const history = useMemo<ThreadHistoryAdapter>(
+    () => ({
+      async load() {
+        return { messages: [] };
+      },
+      async append() {},
+      withFormat: (fmt) => ({
+        async load() {
+          const { remoteId } = aui.threadListItem.getState();
+          if (!remoteId) return { messages: [] };
+          const rows = await fetch(
+            `${API_URL}/threads/${remoteId}/messages`,
+          ).then((r) => r.json());
+          return {
+            messages: rows.map((row: any) =>
+              fmt.decode({
+                id: row.id,
+                parent_id: row.parent_id,
+                format: row.format,
+                content: row.content,
+              }),
+            ),
+          };
+        },
+        async append(item) {
+          const { remoteId } = await aui.threadListItem.initialize();
+          await fetch(`${API_URL}/threads/${remoteId}/messages`, {
+            method: "POST",
+            body: JSON.stringify({
+              id: fmt.getId(item.message),
+              parent_id: item.parentId,
+              format: fmt.format,
+              content: fmt.encode(item),
+            }),
+          });
+        },
+      }),
+    }),
+    [aui],
+  );
+  return useMemo(() => ({ history }), [history]);
+}
+
 export const threadListAdapter: RemoteThreadListAdapter = {
   async list() {
     const rows = await fetch(`${API_URL}/threads`).then((r) => r.json());
@@ -531,50 +588,11 @@ export const threadListAdapter: RemoteThreadListAdapter = {
       controller.appendText(title);
     });
   },
+  unstable_useAdapters: useThreadListAdapters,
   unstable_Provider({ children }) {
-    const aui = useAui();
-    const history = useMemo<ThreadHistoryAdapter>(
-      () => ({
-        async load() {
-          return { messages: [] };
-        },
-        async append() {},
-        withFormat: (fmt) => ({
-          async load() {
-            const { remoteId } = aui.threadListItem.getState();
-            if (!remoteId) return { messages: [] };
-            const rows = await fetch(
-              `${API_URL}/threads/${remoteId}/messages`,
-            ).then((r) => r.json());
-            return {
-              messages: rows.map((row: any) =>
-                fmt.decode({
-                  id: row.id,
-                  parent_id: row.parent_id,
-                  format: row.format,
-                  content: row.content,
-                }),
-              ),
-            };
-          },
-          async append(item) {
-            const { remoteId } = await aui.threadListItem.initialize();
-            await fetch(`${API_URL}/threads/${remoteId}/messages`, {
-              method: "POST",
-              body: JSON.stringify({
-                id: fmt.getId(item.message),
-                parent_id: item.parentId,
-                format: fmt.format,
-                content: fmt.encode(item),
-              }),
-            });
-          },
-        }),
-      }),
-      [aui],
-    );
+    const adapters = useThreadListAdapters();
     return (
-      <RuntimeAdapterProvider adapters={{ history }}>
+      <RuntimeAdapterProvider adapters={adapters}>
         {children}
       </RuntimeAdapterProvider>
     );
@@ -632,7 +650,7 @@ import {
   AssistantRuntimeProvider,
   useRemoteThreadListRuntime,
 } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/ai-sdk";
 import { threadListAdapter } from "./thread-adapter";
 
 export function MyProvider({ children }: { children: React.ReactNode }) {
@@ -659,7 +677,7 @@ import {
 import {
   AssistantChatTransport,
   useChatRuntime,
-} from "@assistant-ui/react-ai-sdk";
+} from "@assistant-ui/ai-sdk";
 import { threadListAdapter } from "./thread-adapter";
 
 export function MyProvider({ children }: { children: React.ReactNode }) {
@@ -689,7 +707,7 @@ import {
 import {
   AssistantChatTransport,
   useChatRuntime,
-} from "@assistant-ui/react-ai-sdk";
+} from "@assistant-ui/ai-sdk";
 import { threadListAdapter } from "./thread-adapter";
 
 export function MyProvider({ children }: { children: React.ReactNode }) {
@@ -728,7 +746,7 @@ Send a message in a fresh thread. Check the database:
 
 ## Notes
 
-- **First-message race.** `append` may fire before the thread row exists. The `unstable_Provider` example above always awaits `aui.threadListItem.initialize()` before writing; do the same in any custom implementation.
+- **First-message race.** `append` may fire before the thread row exists. The example above always awaits `aui.threadListItem.initialize()` before writing; do the same in any custom implementation.
 - **Reload after async auth.** If `auth()` resolves after the initial `list()` call, threads won't appear until the user refreshes. Call `aui.threads.reload()` from a `useEffect` watching the session. Pattern is documented in [threads](/docs/runtimes/concepts/threads#reloading-after-async-authentication).
 - **Format string.** The `format` column is *not* a free-text label; it identifies the on-disk shape so multiple runtimes can coexist. Don't strip it. Don't make assumptions about its value (`useChatRuntime` is responsible for setting and decoding it).
 - **Pending approvals need `update`.** Tool call approvals persist across reloads only when the formatted adapter implements `update`; omitting it keeps the pre-approval snapshot out of storage by design.

package/.docs/raw/docs/migrations/toolkit-tools.mdx

@@ -16,7 +16,7 @@ Use a toolkit registered with `Tools({ toolkit })` instead. Toolkits keep the mo
 
 ```tsx
 import { AssistantRuntimeProvider, makeAssistantTool } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/ai-sdk";
 import { z } from "zod";
 
 const WeatherTool = makeAssistantTool({
@@ -76,7 +76,7 @@ import {
   AuiConfig,
   Tools,
 } from "@assistant-ui/react";
-import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { useChatRuntime } from "@assistant-ui/ai-sdk";
 import toolkit from "./toolkit";
 
 export function App() {