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

package/.docs/raw/docs/(reference)/api-reference/context-providers/assistant-runtime-provider.mdx

@@ -48,15 +48,35 @@ primitives built on it. Components rendered outside an `AuiProvider`
 receive a default client whose scope accessors throw on use, so
 missing-provider mistakes surface at the point of use.
 
+`config` is required and must be built with [AuiConfig](/docs/api-reference/utilities/miscellaneous#auiconfig). At the top
+level, `config` alone creates this subtree's own client. Under a parent
+provider, `extends` is mandatory: pass `extends={aui}` to extend the parent
+client or `extends={null}` to isolate from it (enforced with a dev error).
+Configs are identity-insensitive — a fresh object per render is safe.
+A config whose scopes are all Derived keeps its scope set fixed
+at mount (dev-enforced); configs with a root scope, and empty configs,
+may grow and shrink scopes across renders. `ref` receives the resulting
+client after mount.
+
 When mounting a runtime built with one of the runtime hooks, use
 [AssistantRuntimeProvider](/docs/api-reference/context-providers/assistant-runtime-provider#assistantruntimeprovider) — it installs an `AuiProvider`
 internally — rather than wiring `AuiProvider` yourself.
 
 ```tsx
-function ScopedAssistant({ children, scopes }) {
-  const aui = useAui(scopes);
-
-  return <AuiProvider value={aui}>{children}</AuiProvider>;
+function MessageScope({ index, children }) {
+  const aui = useAui();
+  const config = AuiConfig({
+    message: Derived({
+      source: "thread",
+      query: { index },
+      get: (aui) => aui.thread.message({ index }),
+    }),
+  });
+  return (
+    <AuiProvider extends={aui} config={config}>
+      {children}
+    </AuiProvider>
+  );
 }
 ```
 

package/.docs/raw/docs/(reference)/api-reference/integrations/eve.mdx

@@ -39,6 +39,14 @@ Eve's `send` API.
 const getEveMessageContent: (message: AppendMessage) => NonNullable<SendTurnPayload["message"]>;
 ```
 
+### toEveInputResponse
+
+Converts an assistant-ui tool approval response into an Eve input response.
+
+```ts
+const toEveInputResponse: (response: RespondToToolApprovalOptions) => InputResponse;
+```
+
 ### useEveAgentRuntime
 
 Connects Eve's `useEveAgent` hook to assistant-ui's runtime contract.

package/.docs/raw/docs/(reference)/api-reference/utilities/miscellaneous.mdx

@@ -3,7 +3,7 @@ title: Utilities
 description: Miscellaneous @assistant-ui/react utilities for custom rendering, composition, and advanced assistant UI behavior.
 ---
 
-import { AssistantCloud, ChainOfThoughtClient, DevToolsHooks, InMemoryThreadList, SingleThreadList, Suggestions, useSmooth } from "@/generated/typeDocs";
+import { AssistantCloud, AuiConfig, ChainOfThoughtClient, DevToolsHooks, InMemoryThreadList, SingleThreadList, Suggestions, useSmooth } from "@/generated/typeDocs";
 
 {/* AUTO-GENERATED PAGE by scripts/generate-api-reference.mts */}
 {/* Do not edit manually. */}
@@ -18,6 +18,29 @@ import { AssistantCloud, ChainOfThoughtClient, DevToolsHooks, InMemoryThreadList
 
 <ParametersTable {...AssistantCloud} />
 
+### AuiConfig
+
+Builds a config for [AuiProvider](/docs/api-reference/context-providers/assistant-runtime-provider#auiprovider); the `config` prop only accepts
+configs built with this helper.
+
+A config is plain data: it can be hoisted to module scope, created inline
+per render, or memoized — the provider never relies on config identity.
+
+```tsx
+const aui = useAui();
+const config = AuiConfig({
+  message: Derived({
+    source: "thread",
+    query: { index: 0 },
+    get: (aui) => aui.thread.message({ index: 0 }),
+  }),
+});
+
+<AuiProvider extends={aui} config={config}>{children}</AuiProvider>;
+```
+
+<ParametersTable {...AuiConfig} />
+
 ### ChainOfThoughtClient
 
 <ParametersTable {...ChainOfThoughtClient} />

package/.docs/raw/docs/cloud/ai-sdk-assistant-ui.mdx

@@ -393,7 +393,7 @@ export async function POST(req: Request) {
   const { messages } = await req.json();
 
   const result = streamText({
-    model: openai("gpt-5.4-mini"),
+    model: openai("gpt-5.6-luna"),
     messages,
   });
 

package/.docs/raw/docs/cloud/ai-sdk.mdx

@@ -391,7 +391,7 @@ export async function POST(req: Request) {
   const { messages } = await req.json();
 
   const result = streamText({
-    model: openai("gpt-5.4-mini"),
+    model: openai("gpt-5.6-luna"),
     messages,
   });
 
@@ -459,7 +459,7 @@ export async function POST(req: Request) {
   const samplingCalls: Record<string, SamplingCallData[]> = {};
 
   const result = streamText({
-    model: openai("gpt-5.4-mini"),
+    model: openai("gpt-5.6-luna"),
     messages,
     tools: {
       delegate_to_gemini: tool({

package/.docs/raw/docs/copilots/model-context.mdx

@@ -63,6 +63,7 @@ export default defineToolkit({
 
 ```tsx title="app/Form.tsx"
 import {
+  AuiConfig,
   AuiProvider,
   makeAssistantVisible,
   Tools,
@@ -77,10 +78,10 @@ const ClickableButton = makeAssistantVisible(Button, {
 
 // Use in your component
 function Form() {
-  const aui = useAui({ tools: Tools({ toolkit }) });
-
+  const aui = useAui();
+  const config = AuiConfig({ tools: Tools({ toolkit }) });
   return (
-    <AuiProvider value={aui}>
+    <AuiProvider extends={aui} config={config}>
       <form>{/* form fields */}</form>
     </AuiProvider>
   );

package/.docs/raw/docs/copilots/motivation.mdx

@@ -131,15 +131,15 @@ export default defineToolkit({
 ```
 
 ```tsx title="app/SmartTransactionHistory.tsx"
-import { AuiProvider, Tools, useAui } from "@assistant-ui/react";
+import { AuiConfig, AuiProvider, Tools, useAui } from "@assistant-ui/react";
 import toolkit from "./transaction-toolkit";
 
 function SmartTransactionHistory() {
-  const aui = useAui({ tools: Tools({ toolkit }) });
-
   // Previous instructions...
+  const aui = useAui();
+  const config = AuiConfig({ tools: Tools({ toolkit }) });
   return (
-    <AuiProvider value={aui}>
+    <AuiProvider extends={aui} config={config}>
       <TransactionHistory transactions={transactions} />
     </AuiProvider>
   );

package/.docs/raw/docs/guides/chain-of-thought.mdx

@@ -109,7 +109,7 @@ export async function POST(req: Request) {
   const { messages } = await req.json();
 
   const result = streamText({
-    model: openai("gpt-5.4-mini"),
+    model: openai("gpt-5.6-luna"),
     messages: await convertToModelMessages(messages),
   });
 

package/.docs/raw/docs/guides/electron.mdx

@@ -214,7 +214,7 @@ export function registerAssistantIpc(mainWindow: BrowserWindow) {
     void (async () => {
       try {
         const result = streamText({
-          model: openai("gpt-5.4-mini"),
+          model: openai("gpt-5.6-luna"),
           messages: request.messages,
           ...(request.system ? { system: request.system } : {}),
           abortSignal: abortController.signal,

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()` on mount whenever a pending id is present in storage.
+`@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.
 
 ```tsx title="/app/page.tsx"
 "use client";
@@ -127,12 +127,83 @@ export default function Page() {
 }
 ```
 
-`onResumeError` runs when the client finds a stored stream id but the reconnect attempt fails. Use it to show a toast, report telemetry, or mark the thread as needing retry; assistant-ui still clears the stale stream id after the callback runs.
+`onResumeError` runs when the client finds a stored stream id but the reconnect attempt fails. Use it to show a toast, report telemetry, or mark the thread as needing retry. Assistant-ui clears the failed stream id after the callback unless a newer id has replaced it.
 
-`createResumableSessionStorage` returns a `ResumableClientStorage` backed by `window.sessionStorage`. Pass `{ key }` to namespace per route or per chat surface, or supply your own implementation of the three methods (`getStreamId`, `setStreamId`, `clear`). If you are running on a transport that already wraps `fetch` or `prepareReconnectToStreamRequest`, the `resumable` option composes with your existing handlers.
+`createResumableSessionStorage` returns a `ResumableClientStorage` backed by `window.sessionStorage`. Pass `{ key }` to namespace per route or chat surface; `key` also accepts a getter that is read lazily on every access, so you can derive it from the active thread's identity (see [Multiple threads](#multiple-threads)). While the getter returns `undefined`, reads report no pending stream and writes are dropped. Reuse one storage instance per key, because separate instances do not synchronize their in-memory caches. The persisted entry survives reloads, while in-memory ownership prevents one mounted thread from attaching to another thread's pending stream. An idle follower that learns a stream id from its backend can call `storage.setStreamId(streamId, threadId)` after the corresponding message exists in local history; the runtime attaches when that thread is current, without requiring a remount. The built-in storage holds one pending stream id per key; the [Multiple threads](#multiple-threads) pattern gives each thread its own key, so several threads stay resumable at once. A custom `ResumableClientStorage` can instead key its records by the optional `threadId` arguments and implement `subscribe(listener, threadId)` for post-mount updates, or replace the storage methods entirely. If you are running on a transport that already wraps `fetch` or `prepareReconnectToStreamRequest`, the `resumable` option composes with your existing handlers.
 
 The default finish detector scans the SSE body for the AI SDK `"type":"finish"` marker. Override `isFinishEvent` on the `resumable` option when you ship a custom encoder.
 
+### Multiple threads
+
+The snippet above stores the pending stream id under one `sessionStorage` key, which is correct for a single chat surface. Under a thread list runtime (`useRemoteThreadListRuntime`, which `useChatRuntime` wraps) with more than one alive thread, a single shared key is written and cleared by whichever thread acts last: switch threads while a response is in flight and the response header writes its stream id to the shared key, which the thread you switched to reads on mount and resumes — replaying the other conversation's stream into this one. An unscoped clear when a stream finishes can also drop another thread's pending id. And after a reload, a pending id under the shared key is claimed by whichever thread is main at mount, which with a thread list is a fresh empty thread rather than the one that started the stream.
+
+Scope the key to the thread, and construct the transport and storage per thread inside the per-thread runtime hook rather than once at module level. Derive the key from the thread's identity with a getter so it is read lazily on every access:
+
+```tsx title="/app/page.tsx"
+"use client";
+
+import {
+  AssistantCloud,
+  AssistantRuntimeProvider,
+  useAui,
+  useCloudThreadListAdapter,
+  useRemoteThreadListRuntime,
+} from "@assistant-ui/react";
+import {
+  AssistantChatTransport,
+  createResumableSessionStorage,
+  useChatRuntime,
+} from "@assistant-ui/react-ai-sdk";
+import { useMemo } from "react";
+import { Thread } from "@/components/assistant-ui/thread";
+import { ThreadList } from "@/components/assistant-ui/thread-list";
+
+const cloud = new AssistantCloud({
+  baseUrl: process.env.NEXT_PUBLIC_ASSISTANT_BASE_URL!,
+  anonymous: true,
+});
+
+function ResumableThreadRuntime() {
+  const aui = useAui();
+  const transport = useMemo(
+    () =>
+      new AssistantChatTransport({
+        api: "/api/chat",
+        resumable: {
+          storage: createResumableSessionStorage({
+            key: () => {
+              const item = aui.threadListItem.getState();
+              return `aui-resumable-stream-id:${item.remoteId ?? item.id}`;
+            },
+          }),
+          resumeApi: (streamId) => `/api/chat/resume/${streamId}`,
+        },
+      }),
+    [aui],
+  );
+  return useChatRuntime({ transport });
+}
+
+export default function Page() {
+  const adapter = useCloudThreadListAdapter({ cloud });
+  const runtime = useRemoteThreadListRuntime({
+    adapter,
+    runtimeHook: ResumableThreadRuntime,
+  });
+
+  return (
+    <AssistantRuntimeProvider runtime={runtime}>
+      <ThreadList />
+      <Thread />
+    </AssistantRuntimeProvider>
+  );
+}
+```
+
+`useCloudThreadListAdapter` is the same adapter `useChatRuntime({ cloud })` builds internally, so cloud thread history and attachments keep working; to bring your own backend, pass a custom `RemoteThreadListAdapter` instead. Each thread's runtime hook constructs its own transport and storage, keyed by that thread's identity, so one conversation's stream id can never be read or cleared by another. `useChatRuntime` is a no-op thread list when nested as a `runtimeHook`, so it only runs the per-thread chat runtime against the per-thread transport; the real thread list is the outer `useRemoteThreadListRuntime`.
+
+Key by `remoteId ?? id` under a recognizable prefix, read lazily. A brand-new thread has no `remoteId` yet, but the transport initializes the thread before the request goes out, so by the time the response header delivers the stream id the getter resolves to the `remoteId`. After a reload the same conversation comes back with that `remoteId` as its id, so the stored entry is found again and the pending stream resumes. The local-id fallback covers a thread that has never sent, whose key nothing else reads or writes. Keying by the local id alone would break resume across reloads for threads created in the current session, because their local `__LOCALID_` id is replaced by the `remoteId` when the list reloads.
+
 ## Storage choices
 
 The core package ships `createInMemoryResumableStreamStore` for development and tests. State lives in a process-local `Map`, so it does not survive a server restart. Useful options include `defaultTtlMs`, `maxChunkBytes`, `maxEntriesPerStream`, `maxStreams`, and `gcIntervalMs` for periodic eviction.

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

@@ -15,13 +15,13 @@ The Suggestions API allows you to configure a list of suggested prompts that are
 Configure suggestions using the `Suggestions()` API in your runtime provider:
 
 ```tsx
-import { useAui, Tools, Suggestions } from "@assistant-ui/react";
+import { AuiConfig, Tools, Suggestions } from "@assistant-ui/react";
 import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 
 function MyRuntimeProvider({ children }: { children: React.ReactNode }) {
   const runtime = useChatRuntime();
 
-  const aui = useAui({
+  const config = AuiConfig({
     tools: Tools({ toolkit: myToolkit }),
     suggestions: Suggestions([
       "What can you help me with?",
@@ -31,7 +31,7 @@ function MyRuntimeProvider({ children }: { children: React.ReactNode }) {
   });
 
   return (
-    <AssistantRuntimeProvider aui={aui} runtime={runtime}>
+    <AssistantRuntimeProvider runtime={runtime} config={config}>
       {children}
     </AssistantRuntimeProvider>
   );
@@ -45,7 +45,7 @@ Suggestions can be provided as either strings or objects with title, label, and
 ### Simple Strings
 
 ```tsx
-const aui = useAui({
+AuiConfig({
   suggestions: Suggestions([
     "What's the weather today?",
     "Help me write an email",
@@ -59,7 +59,7 @@ const aui = useAui({
 For more detailed suggestions with separate display text and prompts:
 
 ```tsx
-const aui = useAui({
+AuiConfig({
   suggestions: Suggestions([
     {
       title: "Weather",
@@ -315,13 +315,13 @@ function MyRuntimeProvider({ children }: { children: React.ReactNode }) {
     ];
   }, [user.isPremium]);
 
-  const aui = useAui({
+  const config = AuiConfig({
     tools: Tools({ toolkit: myToolkit }),
     suggestions: Suggestions(suggestions),
   });
 
   return (
-    <AssistantRuntimeProvider aui={aui} runtime={runtime}>
+    <AssistantRuntimeProvider runtime={runtime} config={config}>
       {children}
     </AssistantRuntimeProvider>
   );
@@ -352,10 +352,10 @@ If your codebase uses the inline `ThreadPrimitive.Suggestion` component (which r
 
 ### Runtime-driven form
 
-1. Configure suggestions in your runtime provider:
+1. Configure suggestions in your runtime provider's `config`:
 
 ```tsx
-const aui = useAui({
+AuiConfig({
   suggestions: Suggestions(["What's the weather?"]),
 });
 ```

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

@@ -187,12 +187,17 @@ export default defineToolkit({
 ```
 
 ```tsx title="ToolProvider.tsx"
-import { AuiProvider, Tools, useAui } from "@assistant-ui/react-ink";
+import { AuiConfig, AuiProvider, Tools, useAui } from "@assistant-ui/react-ink";
 import toolkit from "./weather-toolkit";
 
 function ToolProvider({ children }: { children: React.ReactNode }) {
-  const aui = useAui({ tools: Tools({ toolkit }) });
-  return <AuiProvider value={aui}>{children}</AuiProvider>;
+  const aui = useAui();
+  const config = AuiConfig({ tools: Tools({ toolkit }) });
+  return (
+    <AuiProvider extends={aui} config={config}>
+      {children}
+    </AuiProvider>
+  );
 }
 ```
 
@@ -271,7 +276,7 @@ export function useWeatherToolkit() {
 }
 ```
 
-Import the toolkit hook, pass its result to `useAui({ tools: Tools({ toolkit }) })`, and provide the returned `aui` with `AuiProvider`, as shown in the [Tools](#tools) section above.
+Import the toolkit hook and mount it with `<AuiProvider extends={aui} config={config}>` where `const aui = useAui()` and `const config = AuiConfig({ tools: Tools({ toolkit }) })`, as shown in the [Tools](#tools) section above.
 
 ## Runtime Providers
 

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

@@ -666,10 +666,11 @@ Container `Box` for an attachment. Forwards all `Box` props.
 
 ### Thumb
 
-`Text` component displaying a short identifier for the attachment. Renders the file extension (`.pdf`, `.png`, …) when the name has one. Falls back to the attachment `type` (e.g. `image`, `document`) otherwise, and finally to `file`.
+`Text` component displaying a short identifier for the attachment. Renders the file extension (`.pdf`, `.png`, …) when the name has one. Falls back to the attachment `type` (e.g. `image`, `document`) otherwise, and finally to `file`. Passing `children` overrides the automatic label.
 
 | Prop | Type | Description |
 |------|------|-------------|
+| `children` | `ReactNode` | Overrides the automatic extension/type label |
 | `...rest` | `ComponentProps<typeof Text>` | Forwarded to the underlying Ink `Text` |
 
 ### Status
@@ -712,7 +713,7 @@ Primitives for rendering individual queued composer items. Use inside a `Compose
 
 ### Text
 
-Renders the queue item's prompt with Ink `<Text>`. Pass `children` to override the displayed value.
+Renders the queue item's text with Ink `<Text>`. Pass `children` to override the displayed value.
 
 ```tsx
 <QueueItemPrimitive.Text color="gray" />
@@ -720,7 +721,7 @@ Renders the queue item's prompt with Ink `<Text>`. Pass `children` to override t
 
 | Prop | Type | Description |
 |------|------|-------------|
-| `children` | `ReactNode` | Override content; defaults to `s.queueItem.prompt` |
+| `children` | `ReactNode` | Override content; defaults to the text parts of `s.queueItem.parts` |
 | `...rest` | `TextProps` | Standard Ink Text props |
 
 ### Remove

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

@@ -489,6 +489,22 @@ In the adapter's `add`, call Uploadthing's client upload and read `url` from the
 </Tab>
 </Tabs>
 
+### Opaque file references (LangGraph / LangChain)
+
+When the backend resolves stored files itself and the browser never holds a usable URL, send the storage id instead: set `sourceType: "id"` on the file part in `send()`, and the LangChain-family runtimes emit a `source_type: "id"` block with the value in the `id` key. `sourceType: "url"` similarly forces a url reference for non-http data and is honored by the LangChain-family, A2A, AG-UI, and Google ADK runtimes. `sourceType: "id"` is LangChain-family only; runtimes without the concept ignore the field.
+
+```ts
+const content = [
+  {
+    type: "file" as const,
+    filename: name,
+    mimeType: contentType ?? "application/octet-stream",
+    data: fileId,
+    sourceType: "id" as const,
+  },
+];
+```
+
 ## Notes
 
 - **Persistence.** A URL the model sees on Monday must still resolve next week if the thread is reloaded. Either use storage with no expiry on the public URL, or have your [history adapter](/docs/integrations/persistence/custom-adapter) regenerate signed URLs on `load`. Don't store presigned URLs in the message row.

package/.docs/raw/docs/integrations/auth/better-auth.mdx

@@ -66,7 +66,7 @@ export async function POST(req: Request) {
 
   const { messages }: { messages: UIMessage[] } = await req.json();
   const result = streamText({
-    model: openai("gpt-5.4-nano"),
+    model: openai("gpt-5.6-luna"),
     messages: await convertToModelMessages(messages),
   });
   return result.toUIMessageStreamResponse();

package/.docs/raw/docs/integrations/auth/clerk.mdx

@@ -45,7 +45,7 @@ export async function POST(req: Request) {
 
   const { messages }: { messages: UIMessage[] } = await req.json();
   const result = streamText({
-    model: openai("gpt-5.4-nano"),
+    model: openai("gpt-5.6-luna"),
     messages: await convertToModelMessages(messages),
   });
   return result.toUIMessageStreamResponse();

package/.docs/raw/docs/integrations/auth/next-auth.mdx

@@ -72,7 +72,7 @@ export async function POST(req: Request) {
 
   const { messages }: { messages: UIMessage[] } = await req.json();
   const result = streamText({
-    model: openai("gpt-5.4-nano"),
+    model: openai("gpt-5.6-luna"),
     messages: await convertToModelMessages(messages),
   });
   return result.toUIMessageStreamResponse();

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

@@ -68,7 +68,7 @@ export type Env = {
 export class Chat extends AIChatAgent<Env> {
   async onChatMessage(onFinish: Parameters<typeof streamText>[0]["onFinish"]) {
     return streamText({
-      model: openai("gpt-5.4-nano"),
+      model: openai("gpt-5.6-luna"),
       messages: await convertToModelMessages(this.messages),
       onFinish,
     });

package/.docs/raw/docs/integrations/frameworks/mastra/full-stack.mdx

@@ -81,11 +81,11 @@ export const chefAgent = new Agent({
   instructions:
     "You are Michel, a practical and experienced home chef. " +
     "You help people cook with whatever ingredients they have available.",
-  model: "openai/gpt-5.4-mini",
+  model: "openai/gpt-5.6-luna",
 });
 ```
 
-`model: "openai/gpt-5.4-mini"` uses Mastra's model router. Set the provider key in `.env.local` so Next.js auto-loads it:
+`model: "openai/gpt-5.6-luna"` uses Mastra's model router. Set the provider key in `.env.local` so Next.js auto-loads it:
 
 ```sh title=".env.local"
 OPENAI_API_KEY=sk-...

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

@@ -50,7 +50,7 @@ export const chefAgent = new Agent({
   instructions:
     "You are Michel, a practical and experienced home chef. " +
     "You help people cook with whatever ingredients they have available.",
-  model: "openai/gpt-5.4-nano",
+  model: "openai/gpt-5.6-luna",
 });
 ```
 

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

@@ -48,7 +48,7 @@ The rest of this page is what to put in `baseURL`, `headers`, and `model(...)` f
 
 ## OpenRouter
 
-[OpenRouter](https://openrouter.ai/) aggregates 100+ models behind one OpenAI-compatible endpoint. The model ID is `provider/model` (e.g., `anthropic/claude-sonnet-4.6`, `openai/gpt-5.4-mini`, `meta-llama/llama-3.3-70b-instruct`).
+[OpenRouter](https://openrouter.ai/) aggregates 100+ models behind one OpenAI-compatible endpoint. The model ID is `provider/model` (e.g., `anthropic/claude-sonnet-4.6`, `openai/gpt-5.6-luna`, `meta-llama/llama-3.3-70b-instruct`).
 
 ```sh title=".env.local"
 OPENROUTER_API_KEY=sk-or-...
@@ -129,7 +129,7 @@ const litellm = createOpenAI({
 });
 
 const result = streamText({
-  model: litellm("gpt-5.4-mini"),
+  model: litellm("gpt-5.6-luna"),
   messages: await convertToModelMessages(messages),
 });
 ```

package/.docs/raw/docs/integrations/observability/helicone.mdx

@@ -57,7 +57,7 @@ const openai = createOpenAI({
 export async function POST(req: Request) {
   const { messages }: { messages: UIMessage[] } = await req.json();
   const result = streamText({
-    model: openai("gpt-5.4-mini"),
+    model: openai("gpt-5.6-luna"),
     messages: await convertToModelMessages(messages),
   });
   return result.toUIMessageStreamResponse();
@@ -80,7 +80,7 @@ const openai = new OpenAI({
 export async function POST(req: Request) {
   const { messages } = await req.json();
   const stream = await openai.chat.completions.create({
-    model: "gpt-5.4-mini",
+    model: "gpt-5.6-luna",
     messages,
     stream: true,
   });

package/.docs/raw/docs/integrations/observability/langfuse.mdx

@@ -101,7 +101,7 @@ export async function POST(req: Request) {
     { traceName: "chat-completion", userId, sessionId },
     async () =>
       streamText({
-        model: openai("gpt-5.4-nano"),
+        model: openai("gpt-5.6-luna"),
         messages: await convertToModelMessages(messages),
         experimental_telemetry: { isEnabled: true },
       }),

package/.docs/raw/docs/integrations/observability/langsmith.mdx

@@ -63,7 +63,7 @@ export async function POST(req: Request) {
   const { messages }: { messages: UIMessage[] } = await req.json();
 
   const result = streamText({
-    model: openai("gpt-5.4-nano"),
+    model: openai("gpt-5.6-luna"),
     messages: await ai.convertToModelMessages(messages),
   });
 
@@ -84,7 +84,7 @@ Pass a `langsmith` provider option to tag traces with user, session, or run iden
 import { createLangSmithProviderOptions } from "langsmith/experimental/vercel";
 
 const result = streamText({
-  model: openai("gpt-5.4-nano"),
+  model: openai("gpt-5.6-luna"),
   messages: await ai.convertToModelMessages(messages),
   providerOptions: {
     langsmith: createLangSmithProviderOptions({

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

@@ -73,20 +73,18 @@ export default defineToolkit({
 
 import {
   AssistantRuntimeProvider,
+  AuiConfig,
   Tools,
-  useAui,
 } from "@assistant-ui/react";
 import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 import toolkit from "./toolkit";
 
 export function App() {
   const runtime = useChatRuntime();
-  const aui = useAui({
-    tools: Tools({ toolkit }),
-  });
+  const config = AuiConfig({ tools: Tools({ toolkit }) });
 
   return (
-    <AssistantRuntimeProvider aui={aui} runtime={runtime}>
+    <AssistantRuntimeProvider runtime={runtime} config={config}>
       <Thread />
     </AssistantRuntimeProvider>
   );
@@ -100,7 +98,7 @@ export function App() {
 1. Create a `Toolkit` object.
 2. Move each `toolName` into the toolkit key.
 3. Move `description`, `parameters`, `execute`, `providerOptions`, `render`, `renderText`, and `display` onto the toolkit entry.
-4. Register the toolkit once with `useAui({ tools: Tools({ toolkit }) })`.
+4. Register the toolkit once with `config={config}` on your runtime provider, where `const config = AuiConfig({ tools: Tools({ toolkit }) })`.
 5. Remove `<Tool />`, `<ToolUI />`, `useAssistantTool(...)`, and `useAssistantToolUI(...)` registrations.
 
 ## UI-Only Tool Renderers
@@ -126,7 +124,7 @@ export default defineToolkit({
 });
 ```
 
-Register it like any toolkit: `useAui({ tools: Tools({ toolkit }) })`.
+Register it like any toolkit: `config={config}` where `const config = AuiConfig({ tools: Tools({ toolkit }) })`.
 Render-only entries upload no schema and run no browser code — they only attach
 UI for matching tool-call message parts. For MCP server catalogs, spread
 `defineMcpToolkit({ ... })` in the same generative toolkit.
@@ -163,20 +161,24 @@ export default defineToolkit({
 ```
 
 ```tsx title="TaskBoard.tsx"
-import { AuiProvider, Tools, useAui, useAuiToolOverrides } from "@assistant-ui/react";
+import {
+  AuiConfig,
+  AuiProvider,
+  Tools,
+  useAui,
+  useAuiToolOverrides,
+} from "@assistant-ui/react";
 import { useState, type Dispatch, type SetStateAction } from "react";
 import type { Task } from "./task-board-toolkit";
 import toolkit from "./task-board-toolkit";
 
 function TaskBoard() {
   const [tasks, setTasks] = useState<Task[]>([]);
-
-  const aui = useAui({
-    tools: Tools({ toolkit }),
-  });
+  const aui = useAui();
+  const config = AuiConfig({ tools: Tools({ toolkit }) });
 
   return (
-    <AuiProvider value={aui}>
+    <AuiProvider extends={aui} config={config}>
       <TaskBoardToolOverrides setTasks={setTasks} />
       <TaskList tasks={tasks} />
     </AuiProvider>