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

package/.docs/raw/docs/tools/interactables.mdx

@@ -41,7 +41,7 @@ Interactables allow both agents and users to read and edit tool UIs and componen
 
 ```tsx
 import {
-  useAui,
+  AuiConfig,
   unstable_Interactables,
   AssistantRuntimeProvider,
   Tools,
@@ -50,13 +50,15 @@ import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 
 function MyRuntimeProvider({ children }: { children: React.ReactNode }) {
   const runtime = useChatRuntime();
-
-  const aui = useAui({
+  const config = AuiConfig({
     unstable_interactables: unstable_Interactables(), // [!code ++]
   });
 
   return (
-    <AssistantRuntimeProvider aui={aui} runtime={runtime}>
+    <AssistantRuntimeProvider
+      runtime={runtime}
+      config={config}
+    >
       {children}
     </AssistantRuntimeProvider>
   );
@@ -66,7 +68,7 @@ function MyRuntimeProvider({ children }: { children: React.ReactNode }) {
 <Callout type="idea">
   The legacy `interactables: Interactables()` scope and the new
   `unstable_interactables: unstable_Interactables()` scope are mutually
-  exclusive. Mount only one interactables API in a single `useAui` provider.
+  exclusive. Mount only one interactables API in a single provider config.
 </Callout>
 
 This scope is needed for both kinds of interactable. Thread-scoped interactables also live in a toolkit, which you register with `Tools` (shown below).
@@ -166,7 +168,7 @@ const toolkit = defineToolkit({
 Register the toolkit alongside the `unstable_Interactables` scope:
 
 ```tsx
-const aui = useAui({
+AuiConfig({
   unstable_interactables: unstable_Interactables(),
   tools: Tools({ toolkit }), // [!code ++]
 });
@@ -199,7 +201,7 @@ export async function POST(req: Request) {
   const { messages } = await req.json();
 
   const result = streamText({
-    model: openai("gpt-5.4"),
+    model: openai("gpt-5.6-luna"),
     messages: await convertToModelMessages(injectInteractableContext(messages)), // [!code ++]
   });
 
@@ -592,7 +594,12 @@ An app-scoped item's history covers the current conversation, not its full cross
 By default, app-scoped interactable state is in-memory and lost on page refresh. You can add persistence by passing an adapter to `unstable_Interactables`:
 
 ```tsx
-import { useAui, unstable_Interactables } from "@assistant-ui/react";
+import {
+  AuiConfig,
+  AuiProvider,
+  useAui,
+  unstable_Interactables,
+} from "@assistant-ui/react";
 
 // Module-level (or memoized) so the adapter identity is stable across renders.
 const persistenceAdapter = {
@@ -606,13 +613,17 @@ const persistenceAdapter = {
 };
 
 function MyRuntimeProvider({ children }) {
-  const aui = useAui({
+  const aui = useAui();
+  const config = AuiConfig({
     unstable_interactables: unstable_Interactables({
       persistence: persistenceAdapter,
     }),
   });
-
-  return /* ... */;
+  return (
+    <AuiProvider extends={aui} config={config}>
+      {children}
+    </AuiProvider>
+  );
 }
 ```
 
@@ -1040,10 +1051,10 @@ Every version of an interactable recorded in the current thread, oldest first. E
 
 ### `unstable_Interactables`
 
-The scope resource that manages all interactables. Register it via `useAui`, optionally with a [persistence adapter](#persistence):
+The scope resource that manages all interactables. Register it via your provider's `config`, optionally with a [persistence adapter](#persistence):
 
 ```tsx
-const aui = useAui({
+AuiConfig({
   unstable_interactables: unstable_Interactables({ persistence: myAdapter }),
 });
 ```

package/.docs/raw/docs/tools/mcp-apps.mdx

@@ -36,14 +36,17 @@ Compose `McpAppRenderer({...})` into your `Tools` resource. Provide `host.url` p
 
 ```tsx
 import {
-  useAui,
+  AuiConfig,
+  AuiProvider,
   Tools,
   McpAppRenderer,
   McpAppsRemoteHost,
+  useAui,
 } from "@assistant-ui/react";
 
-function MyAssistant() {
-  useAui({
+function MyAssistant({ children }) {
+  const aui = useAui();
+  const config = AuiConfig({
     tools: Tools({
       toolkit: myToolkit,
       mcpApp: McpAppRenderer({
@@ -53,12 +56,38 @@ function MyAssistant() {
       }),
     }),
   });
-  // ...
+  return (
+    <AuiProvider extends={aui} config={config}>
+      {children}
+    </AuiProvider>
+  );
 }
 ```
 
 `McpAppsRemoteHost` is the default host strategy — it POSTs `{ method, params }` to your route. A different strategy (e.g. a client-side MCP client) can be plugged in by writing a custom resource that returns the same `McpAppsHost` shape (`{ loadResource, callTool, readResource, listResources }`).
 
+Changes to `headers` or a custom `fetch` function apply to subsequent host requests without reloading the widget. When the account or workspace identity changes, key the host resource explicitly so its UI resource reloads.
+
+Install the resource helper:
+
+```bash
+pnpm add @assistant-ui/tap
+```
+
+```tsx
+import { withKey } from "@assistant-ui/tap";
+
+const mcpApp = McpAppRenderer({
+  host: withKey(
+    workspaceId,
+    McpAppsRemoteHost({
+      url: "/api/mcp-apps",
+      headers: () => getWorkspaceHeaders(workspaceId),
+    }),
+  ),
+});
+```
+
 `openLink` is auto-wired to `window.open(url, "_blank", "noopener,noreferrer")`. `sendMessage` is auto-wired to append a user message to the current thread (accepts `string`, `{ prompt }`, `{ text }`, or `{ message }`).
 
 ### Route handler
@@ -154,7 +183,7 @@ const tools = await client.listTools();
 const { modelVisible } = splitMcpAppTools(tools);
 
 const result = streamText({
-  model: openai("gpt-5.4-nano"),
+  model: openai("gpt-5.6-luna"),
   tools: modelVisible.tools,
   // ...
 });
@@ -314,4 +343,4 @@ McpAppRenderer({
 - Widgets run cross-origin in a sandboxed iframe. The bridge filters incoming messages by both source window and origin.
 - The host route is your auth boundary — apply session checks, rate limiting, and per-tool allowlists there. The renderer trusts whatever the route returns.
 - `openLink` rejects non-`http(s)` URLs at the bridge layer, but your `openLink` handler should still treat the URL as untrusted (e.g. always use `noopener,noreferrer`).
-- Keep `host` and `handlers` references stable across renders (e.g. module-scope constants or `useMemo`); an unstable identity will tear down and refetch the widget on every parent re-render.
+- Keep custom `host` and `handlers` references stable across renders (e.g. module-scope constants or `useMemo`); an unstable custom-host identity keeps the widget in `loadingFallback` while refetching on every parent re-render.

package/.docs/raw/docs/tools/mcp.mdx

@@ -177,7 +177,7 @@ export async function POST(req: Request) {
   const aiToolkit = new AISDKToolkit({ toolkit });
 
   const result = streamText({
-    model: openai("gpt-5.4-mini"),
+    model: openai("gpt-5.6-luna"),
     messages: await convertToModelMessages(messages),
     tools: await aiToolkit.tools({ frontend: tools }),
     onFinish: async () => {
@@ -220,7 +220,7 @@ export async function POST(req: Request) {
   const tools = await mcpClient.tools();
 
   const result = streamText({
-    model: openai("gpt-5.4-mini"),
+    model: openai("gpt-5.6-luna"),
     messages: await convertToModelMessages(messages),
     tools,
     onFinish: async () => {
@@ -369,7 +369,7 @@ Register the toolkit once with `Tools({ toolkit })`. Renderer keys such as
 ```tsx title="app/components/RuntimeProvider.tsx"
 "use client";
 
-import { AssistantRuntimeProvider, Tools, useAui } from "@assistant-ui/react";
+import { AssistantRuntimeProvider, AuiConfig, Tools } from "@assistant-ui/react";
 import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 import type { ReactNode } from "react";
 
@@ -377,10 +377,12 @@ import { toolkit } from "./GitHubIssueToolUI";
 
 export function MyRuntimeProvider({ children }: { children: ReactNode }) {
   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}
+    >
       {children}
     </AssistantRuntimeProvider>
   );
@@ -400,7 +402,7 @@ MCP tools execute on the server, so approval is a server-side tool gate, not a `
 const tools = await mcpClient.tools();
 
 const result = streamText({
-  model: openai("gpt-5.4-mini"),
+  model: openai("gpt-5.6-luna"),
   messages: await convertToModelMessages(messages),
   tools,
   toolApproval: {

package/.docs/raw/docs/tools/tool-ui.mdx

@@ -69,15 +69,15 @@ export default defineToolkit({
 ```
 
 ```tsx title="app/MyRuntimeProvider.tsx"
-import { AssistantRuntimeProvider, Tools, useAui } from "@assistant-ui/react";
+import { AssistantRuntimeProvider, AuiConfig, Tools } from "@assistant-ui/react";
 import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 import toolkit from "./toolkit";
 
 function MyRuntimeProvider({ children }: { children: React.ReactNode }) {
   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}>
       {children}
     </AssistantRuntimeProvider>
   );
@@ -190,10 +190,9 @@ const toolkit = defineToolkit({
 });
 
 function App({ runtime }: { runtime: AssistantRuntime }) {
-  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>
   );
@@ -215,7 +214,7 @@ export async function POST(req: Request) {
   const { messages } = await req.json();
 
   const result = streamText({
-    model: openai("gpt-5.4-nano"),
+    model: openai("gpt-5.6-luna"),
     messages: await convertToModelMessages(messages),
     tools: {
       getWeather: tool({
@@ -331,19 +330,21 @@ export function useAnalyzeDataToolkit(theme: "light" | "dark") {
 ```
 
 ```tsx title="DynamicToolUI.tsx"
-import { AuiProvider, Tools, useAui } from "@assistant-ui/react";
+import { AuiConfig, AuiProvider, Tools, useAui } from "@assistant-ui/react";
 import { useState } from "react";
 import { useAnalyzeDataToolkit } from "./analyze-data-toolkit";
 
 function DynamicToolUI({ children }: { children: React.ReactNode }) {
   const [theme] = useState<"light" | "dark">("light");
   const toolkit = useAnalyzeDataToolkit(theme);
+  const aui = useAui();
+  const config = AuiConfig({ tools: Tools({ toolkit }) });
 
-  const aui = useAui({
-    tools: Tools({ toolkit }),
-  });
-
-  return <AuiProvider value={aui}>{children}</AuiProvider>;
+  return (
+    <AuiProvider extends={aui} config={config}>
+      {children}
+    </AuiProvider>
+  );
 }
 ```
 
@@ -390,18 +391,16 @@ export function useInventoryToolkit(productId: string, productName: string) {
 ```
 
 ```tsx title="ProductPage.tsx"
-import { AuiProvider, Tools, useAui } from "@assistant-ui/react";
+import { AuiConfig, AuiProvider, Tools, useAui } from "@assistant-ui/react";
 import { useInventoryToolkit } from "./inventory-toolkit";
 
 function ProductPage({ productId, productName }) {
   const toolkit = useInventoryToolkit(productId, productName);
-
-  const aui = useAui({
-    tools: Tools({ toolkit }),
-  });
+  const aui = useAui();
+  const config = AuiConfig({ tools: Tools({ toolkit }) });
 
   return (
-    <AuiProvider value={aui}>
+    <AuiProvider extends={aui} config={config}>
       <div>Product details...</div>
     </AuiProvider>
   );
@@ -942,15 +941,20 @@ export function useHeavyComputationToolkit() {
 ```
 
 ```tsx title="HeavyComputationToolProvider.tsx"
-import { AuiProvider, Tools, useAui } from "@assistant-ui/react";
+import { AuiConfig, AuiProvider, Tools, useAui } from "@assistant-ui/react";
 import type { ReactNode } from "react";
 import { useHeavyComputationToolkit } from "./heavy-computation-toolkit";
 
 function HeavyComputationToolProvider({ children }: { children: ReactNode }) {
   const toolkit = useHeavyComputationToolkit();
-  const aui = useAui({ tools: Tools({ toolkit }) });
+  const aui = useAui();
+  const config = AuiConfig({ tools: Tools({ toolkit }) });
 
-  return <AuiProvider value={aui}>{children}</AuiProvider>;
+  return (
+    <AuiProvider extends={aui} config={config}>
+      {children}
+    </AuiProvider>
+  );
 }
 ```
 

package/.docs/raw/docs/tools/user-managed-mcp.mdx

@@ -15,14 +15,14 @@ Both flow through one connection lifecycle, one persisted state surface, and one
 ## How it works
 
 ```
-useAui({ mcp: McpManagerResource({ connectors }) })
+AuiConfig({ mcp: McpManagerResource({ connectors }) })
         │
         ├─ Resource — connection lifecycle, server lookup, OAuth/bearer auth
         ├─ Auto-mounts the modelContext scope when no chat runtime provides one
         └─ Registers connected tools as frontend tools — your chat sees them automatically
 ```
 
-The manager is a single resource. Mount it with `useAui` like any other scope. OAuth (PKCE + RFC 7591 dynamic client registration), bearer, and "no auth" are first-class. Token refresh runs inside the MCP SDK on 401; this package mediates persistence and the redirect step.
+The manager is a single resource. Mount it with `AuiProvider` like any other scope. OAuth (PKCE + RFC 7591 dynamic client registration), bearer, and "no auth" are first-class. Token refresh runs inside the MCP SDK on 401; this package mediates persistence and the redirect step.
 
 ## Setup
 
@@ -38,12 +38,12 @@ The manager is a single resource. Mount it with `useAui` like any other scope. O
 
 ### Mount the manager
 
-Declare your connectors and provide the `mcp` scope on `useAui`. No provider wrapper, no imperative hooks:
+Declare your connectors and provide the `mcp` scope via `AuiProvider`. No imperative hooks:
 
 ```tsx title="app/providers.tsx"
 "use client";
 
-import { AuiProvider, useAui } from "@assistant-ui/react";
+import { AuiConfig, AuiProvider, useAui } from "@assistant-ui/react";
 import { McpManagerResource, defineConnector } from "@assistant-ui/react-mcp";
 
 const connectors = [
@@ -64,13 +64,18 @@ const connectors = [
 ];
 
 export function Providers({ children }: { children: React.ReactNode }) {
-  const aui = useAui({
+  const aui = useAui();
+  const config = AuiConfig({
     mcp: McpManagerResource({
       connectors,
       connectionTimeout: 15_000,
     }),
   });
-  return <AuiProvider value={aui}>{children}</AuiProvider>;
+  return (
+    <AuiProvider extends={aui} config={config}>
+      {children}
+    </AuiProvider>
+  );
 }
 ```
 
@@ -297,7 +302,7 @@ All persisted state — custom server records, OAuth tokens, PKCE verifiers, DCR
 ```tsx
 import { McpManagerResource, McpCustomStorage } from "@assistant-ui/react-mcp";
 
-const aui = useAui({
+AuiConfig({
   mcp: McpManagerResource({
     connectors,
     storage: McpCustomStorage({

package/.docs/raw/docs/ui/file.mdx

@@ -115,7 +115,7 @@ import {
 | `File.Icon` | MIME type-aware icon, or pass custom `children` |
 | `File.Name` | Truncated filename |
 | `File.Size` | Human-readable file size |
-| `File.Download` | Download link button |
+| `File.Download` | Download link button; renders nothing without a browser-resolvable target (`sourceType: "id"`, urls that are not http(s)/blob/data) |
 
 ### Custom Icon
 
@@ -134,6 +134,7 @@ The component also exports utility functions:
 ```tsx
 import {
   getMimeTypeIcon,
+  getFileDataKind,
   getBase64Size,
   formatFileSize,
 } from "@/components/assistant-ui/file";
@@ -141,6 +142,10 @@ import {
 // Get icon component for a MIME type
 const Icon = getMimeTypeIcon("application/pdf"); // FileTextIcon
 
+// Classify the data field of a file part; a declared sourceType wins over sniffing, except a data: payload declared as "url"
+const kind = getFileDataKind("https://example.com/report.pdf"); // "url"
+const ref = getFileDataKind("file-abc123", "id"); // "id"
+
 // Calculate size from base64 string
 const bytes = getBase64Size("SGVsbG8gV29ybGQh"); // 12
 

package/.docs/raw/docs/ui/mcp-config.mdx

@@ -25,7 +25,7 @@ platforms: ["react"]
 ```tsx title="app/providers.tsx"
 "use client";
 
-import { AuiProvider, useAui } from "@assistant-ui/react";
+import { AuiConfig, AuiProvider, useAui } from "@assistant-ui/react";
 import { McpManagerResource, defineConnector } from "@assistant-ui/react-mcp";
 
 const connectors = [
@@ -38,8 +38,13 @@ const connectors = [
 ];
 
 export function Providers({ children }: { children: React.ReactNode }) {
-  const aui = useAui({ mcp: McpManagerResource({ connectors }) });
-  return <AuiProvider value={aui}>{children}</AuiProvider>;
+  const aui = useAui();
+  const config = AuiConfig({ mcp: McpManagerResource({ connectors }) });
+  return (
+    <AuiProvider extends={aui} config={config}>
+      {children}
+    </AuiProvider>
+  );
 }
 ```
 

package/.docs/raw/docs/ui/model-selector.mdx

@@ -38,11 +38,11 @@ const ComposerAction: FC = () => {
     <div className="flex items-center gap-1">
       <ModelSelector
         models={[
-          { id: "gpt-5.4-nano", name: "GPT-5.4 Nano", description: "Fast and efficient" },
-          { id: "gpt-5.4-mini", name: "GPT-5.4 Mini", description: "Balanced performance" },
-          { id: "gpt-5.5", name: "GPT-5.5", description: "Most capable", efforts: true },
+          { id: "gpt-5.6-luna", name: "GPT-5.6 Luna", description: "Fast and efficient" },
+          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra", description: "Balanced performance" },
+          { id: "gpt-5.6-sol", name: "GPT-5.6 Sol", description: "Most capable", efforts: true },
         ]}
-        defaultValue="gpt-5.4-nano"
+        defaultValue="gpt-5.6-luna"
         defaultEffort="medium"
         size="sm"
       />
@@ -63,7 +63,7 @@ export async function POST(req: Request) {
   const { messages, config } = await req.json();
 
   const result = streamText({
-    model: openai(config?.modelName ?? "gpt-5.4-nano"),
+    model: openai(config?.modelName ?? "gpt-5.6-luna"),
     providerOptions: {
       openai:
         config?.reasoningEffort !== undefined
@@ -88,8 +88,8 @@ A model that declares `efforts` shows a "Thinking" row at the bottom of the popo
 
 ```tsx
 {
-  id: "gpt-5.5",
-  name: "GPT-5.5",
+  id: "gpt-5.6-sol",
+  name: "GPT-5.6 Sol",
   efforts: [
     { id: "minimal", name: "Minimal" },
     { id: "high", name: "High" },
@@ -156,7 +156,7 @@ import { ClaudeLogo, GeminiLogo, OpenAILogo } from "@/components/assistant-ui/lo
 
 <ModelSelector
   models={[
-    { id: "gpt-5.5", name: "GPT-5.5", icon: <OpenAILogo /> },
+    { id: "gpt-5.6-sol", name: "GPT-5.6 Sol", icon: <OpenAILogo /> },
     { id: "claude-opus-4.5", name: "Claude Opus 4.5", icon: <ClaudeLogo /> },
     { id: "gemini-3-pro", name: "Gemini 3 Pro", icon: <GeminiLogo /> },
   ]}

package/.docs/raw/docs/ui/part-grouping.mdx

@@ -575,7 +575,7 @@ Use `MessagePrimitive.Unstable_PartsGrouped` only when you need to collect non-a
               name: "Unstable_Audio",
               type: "Unstable_AudioMessagePartComponent",
               description:
-                "Component for rendering audio content (experimental)",
+                "Component for rendering audio content (deprecated, render audio/* from File)",
             },
             {
               name: "tools",

package/.docs/raw/docs/ui/thread.mdx

@@ -111,17 +111,36 @@ export default function Chat() {
 Display suggested prompts using the Suggestions API. See the [Suggestions guide](/docs/guides/suggestions) for detailed configuration.
 
 ```tsx
-import { SuggestionPrimitive, ThreadPrimitive } from "@assistant-ui/react";
+import type { ReactNode } from "react";
+import {
+  AssistantRuntimeProvider,
+  AuiConfig,
+  SuggestionPrimitive,
+  Suggestions,
+  ThreadPrimitive,
+} from "@assistant-ui/react";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
 
 // Configure suggestions in your runtime provider
-const aui = useAui({
+const config = AuiConfig({
   suggestions: Suggestions(["What's the weather?", "Tell me a joke"]),
 });
 
+const App = ({ children }: { children: ReactNode }) => {
+  const runtime = useChatRuntime();
+  return (
+    <AssistantRuntimeProvider runtime={runtime} config={config}>
+      {children}
+    </AssistantRuntimeProvider>
+  );
+};
+
 // Display suggestions in your thread component
-<ThreadPrimitive.Suggestions>
-  {() => <SuggestionItem />}
-</ThreadPrimitive.Suggestions>
+const ThreadSuggestions = () => (
+  <ThreadPrimitive.Suggestions>
+    {() => <SuggestionItem />}
+  </ThreadPrimitive.Suggestions>
+);
 
 // Custom suggestion item
 const SuggestionItem = () => (

package/.docs/raw/docs/utilities/react-o11y.mdx

@@ -42,7 +42,7 @@ import {
   SpanResource,
   type SpanData,
 } from "@assistant-ui/react-o11y";
-import { useAui, AuiProvider } from "@assistant-ui/store";
+import { AuiConfig, AuiProvider } from "@assistant-ui/store";
 
 function SpanRow() {
   return (
@@ -59,10 +59,9 @@ function SpanRow() {
 }
 
 export function TraceView({ spans }: { spans: SpanData[] }) {
-  const aui = useAui({ span: SpanResource({ spans }) });
-
+  const config = AuiConfig({ span: SpanResource({ spans }) });
   return (
-    <AuiProvider value={aui}>
+    <AuiProvider extends={null} config={config}>
       <SpanPrimitive.Children components={{ Span: SpanRow }} />
     </AuiProvider>
   );
@@ -106,10 +105,9 @@ import {
   SpanByIndexProvider,
 } from "@assistant-ui/react-o11y";
 
-// Top-level: mount SpanResource via useAui
-const aui = useAui({ span: SpanResource({ spans }) });
-
-<AuiProvider value={aui}>
+// Top-level: mount SpanResource via AuiProvider
+const config = AuiConfig({ span: SpanResource({ spans }) });
+<AuiProvider extends={null} config={config}>
   {/* Render visible spans (flat-list output respecting collapsed state) */}
   <SpanPrimitive.Children components={{ Span: SpanRow }} />
 </AuiProvider>;
@@ -140,7 +138,7 @@ Resource that ingests raw span data and exposes a tree-aware reactive state to p
 SpanResource({ spans }: { spans: SpanData[] }): ClientOutput<"span">;
 ```
 
-Mount through `useAui({ span: SpanResource({ spans }) })`.
+Mount through `config={config}`, where `const config = AuiConfig({ span: SpanResource({ spans }) })`.
 
 The resource computes:
 

package/dist/constants.js

@@ -10,8 +10,8 @@ const DOCS_PATH = join(DOCS_BASE, "raw/docs");
 const CODE_EXAMPLES_PATH = join(DOCS_BASE, "organized/code-examples");
 const MDX_EXTENSION = ".mdx";
 const MD_EXTENSION = ".md";
-const MAX_FILE_SIZE = 10 * 1024 * 1024;
-const MAX_DIRECTORY_CONTENT_SIZE = 1024 * 1024;
+const MAX_FILE_SIZE = 10485760;
+const MAX_DIRECTORY_CONTENT_SIZE = 1048576;
 const IS_PREPARE_MODE = process.argv[1]?.includes("prepare-docs/prepare");
 //#endregion
 export { CODE_EXAMPLES_PATH, DOCS_PATH, EXAMPLES_PATH, IS_PREPARE_MODE, MAX_DIRECTORY_CONTENT_SIZE, MAX_FILE_SIZE, MDX_EXTENSION, MD_EXTENSION, PACKAGE_DIR, ROOT_DIR };

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { dirname, join } from \"node:path\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport const ROOT_DIR = join(__dirname, \"../../../\");\nexport const PACKAGE_DIR = join(__dirname, \"../\");\n\nexport const EXAMPLES_PATH = join(ROOT_DIR, \"examples\");\n\nconst DOCS_BASE = join(PACKAGE_DIR, \".docs\");\nexport const DOCS_PATH = join(DOCS_BASE, \"raw/docs\");\nexport const CODE_EXAMPLES_PATH = join(DOCS_BASE, \"organized/code-examples\");\n\nexport const MDX_EXTENSION = \".mdx\";\nexport const MD_EXTENSION = \".md\";\n\nexport const MAX_FILE_SIZE = 10 * 1024 * 1024;\n\nexport const MAX_DIRECTORY_CONTENT_SIZE = 1024 * 1024;\n\nexport const IS_PREPARE_MODE = process.argv[1]?.includes(\n  \"prepare-docs/prepare\",\n);\n"],"mappings":";;;AAGA,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,GAAG,CAAC;AAExD,MAAa,WAAW,KAAK,WAAW,WAAW;AACnD,MAAa,cAAc,KAAK,WAAW,KAAK;AAEhD,MAAa,gBAAgB,KAAK,UAAU,UAAU;AAEtD,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,MAAa,YAAY,KAAK,WAAW,UAAU;AACnD,MAAa,qBAAqB,KAAK,WAAW,yBAAyB;AAE3E,MAAa,gBAAgB;AAC7B,MAAa,eAAe;AAE5B,MAAa,gBAAgB,KAAK,OAAO;AAEzC,MAAa,6BAA6B,OAAO;AAEjD,MAAa,kBAAkB,QAAQ,KAAK,EAAE,EAAE,SAC9C,sBACF"}
+{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { dirname, join } from \"node:path\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport const ROOT_DIR = join(__dirname, \"../../../\");\nexport const PACKAGE_DIR = join(__dirname, \"../\");\n\nexport const EXAMPLES_PATH = join(ROOT_DIR, \"examples\");\n\nconst DOCS_BASE = join(PACKAGE_DIR, \".docs\");\nexport const DOCS_PATH = join(DOCS_BASE, \"raw/docs\");\nexport const CODE_EXAMPLES_PATH = join(DOCS_BASE, \"organized/code-examples\");\n\nexport const MDX_EXTENSION = \".mdx\";\nexport const MD_EXTENSION = \".md\";\n\nexport const MAX_FILE_SIZE = 10 * 1024 * 1024;\n\nexport const MAX_DIRECTORY_CONTENT_SIZE = 1024 * 1024;\n\nexport const IS_PREPARE_MODE = process.argv[1]?.includes(\n  \"prepare-docs/prepare\",\n);\n"],"mappings":";;;AAGA,MAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAExD,MAAa,WAAW,KAAK,WAAW,WAAW;AACnD,MAAa,cAAc,KAAK,WAAW,KAAK;AAEhD,MAAa,gBAAgB,KAAK,UAAU,UAAU;AAEtD,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,MAAa,YAAY,KAAK,WAAW,UAAU;AACnD,MAAa,qBAAqB,KAAK,WAAW,yBAAyB;AAE3E,MAAa,gBAAgB;AAC7B,MAAa,eAAe;AAE5B,MAAa,gBAAgB;AAE7B,MAAa,6BAA6B;AAE1C,MAAa,kBAAkB,QAAQ,KAAK,EAAE,EAAE,SAC9C,sBACF"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/server\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/server/stdio\";\nimport { docsTools } from \"./tools/docs.js\";\nimport { examplesTools } from \"./tools/examples.js\";\nimport { searchTools } from \"./tools/search.js\";\nimport {\n  xuluxTemplatesListTool,\n  xuluxTemplateDetailsTool,\n  xuluxTemplatePreviewTool,\n} from \"./tools/xulux-templates.js\";\nimport { xuluxPlaygroundPrompt } from \"./prompts/xulux-playground.js\";\nimport { registerResources } from \"./tools/resources.js\";\nimport { logger } from \"./utils/logger.js\";\nimport { PACKAGE_DIR } from \"./constants.js\";\n\nimport { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst packageJson = JSON.parse(\n  readFileSync(join(PACKAGE_DIR, \"package.json\"), \"utf-8\"),\n);\n\nexport const server = new McpServer({\n  name: \"assistant-ui-docs\",\n  version: packageJson.version,\n});\n\nserver.registerTool(\n  docsTools.name,\n  {\n    title: \"assistant-ui Documentation\",\n    description: docsTools.description,\n    inputSchema: docsTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  docsTools.execute,\n);\nserver.registerTool(\n  examplesTools.name,\n  {\n    title: \"assistant-ui Examples\",\n    description: examplesTools.description,\n    inputSchema: examplesTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  examplesTools.execute,\n);\nserver.registerTool(\n  searchTools.name,\n  {\n    title: \"Search assistant-ui Documentation\",\n    description: searchTools.description,\n    inputSchema: searchTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  searchTools.execute,\n);\n\nserver.registerTool(\n  xuluxTemplatesListTool.name,\n  {\n    title: \"assistant-ui Templates\",\n    description: xuluxTemplatesListTool.description,\n    inputSchema: xuluxTemplatesListTool.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: true },\n  },\n  xuluxTemplatesListTool.execute,\n);\nserver.registerTool(\n  xuluxTemplateDetailsTool.name,\n  {\n    title: \"assistant-ui Template Details\",\n    description: xuluxTemplateDetailsTool.description,\n    inputSchema: xuluxTemplateDetailsTool.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: true },\n  },\n  xuluxTemplateDetailsTool.execute,\n);\nserver.registerTool(\n  xuluxTemplatePreviewTool.name,\n  {\n    title: \"assistant-ui Template Preview URLs\",\n    description: xuluxTemplatePreviewTool.description,\n    inputSchema: xuluxTemplatePreviewTool.parameters,\n    annotations: { readOnlyHint: false, openWorldHint: true },\n  },\n  xuluxTemplatePreviewTool.execute,\n);\n\nserver.registerPrompt(\n  xuluxPlaygroundPrompt.name,\n  {\n    title: \"assistant-ui Template Workflow\",\n    description: xuluxPlaygroundPrompt.description,\n  },\n  () => ({\n    messages: [\n      {\n        role: \"user\" as const,\n        content: { type: \"text\" as const, text: xuluxPlaygroundPrompt.text },\n      },\n    ],\n  }),\n);\n\nregisterResources(server);\n\nexport async function runServer() {\n  try {\n    logger.info(\n      `Starting assistant-ui MCP docs server v${packageJson.version}`,\n    );\n    const transport = new StdioServerTransport();\n    await server.connect(transport);\n  } catch (error) {\n    logger.error(\"Failed to start MCP server\", error);\n    process.exit(1);\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  void runServer().catch((error) => {\n    console.error(\"Failed to start server:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;AAkBA,MAAM,cAAc,KAAK,MACvB,aAAa,KAAK,aAAa,cAAc,GAAG,OAAO,CACzD;AAEA,MAAa,SAAS,IAAI,UAAU;CAClC,MAAM;CACN,SAAS,YAAY;AACvB,CAAC;AAED,OAAO,aACL,UAAU,MACV;CACE,OAAO;CACP,aAAa,UAAU;CACvB,aAAa,UAAU;CACvB,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,UAAU,OACZ;AACA,OAAO,aACL,cAAc,MACd;CACE,OAAO;CACP,aAAa,cAAc;CAC3B,aAAa,cAAc;CAC3B,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,cAAc,OAChB;AACA,OAAO,aACL,YAAY,MACZ;CACE,OAAO;CACP,aAAa,YAAY;CACzB,aAAa,YAAY;CACzB,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,YAAY,OACd;AAEA,OAAO,aACL,uBAAuB,MACvB;CACE,OAAO;CACP,aAAa,uBAAuB;CACpC,aAAa,uBAAuB;CACpC,aAAa;EAAE,cAAc;EAAM,eAAe;CAAK;AACzD,GACA,uBAAuB,OACzB;AACA,OAAO,aACL,yBAAyB,MACzB;CACE,OAAO;CACP,aAAa,yBAAyB;CACtC,aAAa,yBAAyB;CACtC,aAAa;EAAE,cAAc;EAAM,eAAe;CAAK;AACzD,GACA,yBAAyB,OAC3B;AACA,OAAO,aACL,yBAAyB,MACzB;CACE,OAAO;CACP,aAAa,yBAAyB;CACtC,aAAa,yBAAyB;CACtC,aAAa;EAAE,cAAc;EAAO,eAAe;CAAK;AAC1D,GACA,yBAAyB,OAC3B;AAEA,OAAO,eACL,sBAAsB,MACtB;CACE,OAAO;CACP,aAAa,sBAAsB;AACrC,UACO,EACL,UAAU,CACR;CACE,MAAM;CACN,SAAS;EAAE,MAAM;EAAiB,MAAM,sBAAsB;CAAK;AACrE,CACF,EACF,EACF;AAEA,kBAAkB,MAAM;AAExB,eAAsB,YAAY;CAChC,IAAI;EACF,OAAO,KACL,0CAA0C,YAAY,SACxD;EACA,MAAM,YAAY,IAAI,qBAAqB;EAC3C,MAAM,OAAO,QAAQ,SAAS;CAChC,SAAS,OAAO;EACd,OAAO,MAAM,8BAA8B,KAAK;EAChD,QAAQ,KAAK,CAAC;CAChB;AACF;AAEA,IAAI,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,MAC7C,UAAe,CAAC,CAAC,OAAO,UAAU;CAChC,QAAQ,MAAM,2BAA2B,KAAK;CAC9C,QAAQ,KAAK,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/server\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/server/stdio\";\nimport { docsTools } from \"./tools/docs.js\";\nimport { examplesTools } from \"./tools/examples.js\";\nimport { searchTools } from \"./tools/search.js\";\nimport {\n  xuluxTemplatesListTool,\n  xuluxTemplateDetailsTool,\n  xuluxTemplatePreviewTool,\n} from \"./tools/xulux-templates.js\";\nimport { xuluxPlaygroundPrompt } from \"./prompts/xulux-playground.js\";\nimport { registerResources } from \"./tools/resources.js\";\nimport { logger } from \"./utils/logger.js\";\nimport { PACKAGE_DIR } from \"./constants.js\";\n\nimport { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst packageJson = JSON.parse(\n  readFileSync(join(PACKAGE_DIR, \"package.json\"), \"utf-8\"),\n);\n\nexport const server = new McpServer({\n  name: \"assistant-ui-docs\",\n  version: packageJson.version,\n});\n\nserver.registerTool(\n  docsTools.name,\n  {\n    title: \"assistant-ui Documentation\",\n    description: docsTools.description,\n    inputSchema: docsTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  docsTools.execute,\n);\nserver.registerTool(\n  examplesTools.name,\n  {\n    title: \"assistant-ui Examples\",\n    description: examplesTools.description,\n    inputSchema: examplesTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  examplesTools.execute,\n);\nserver.registerTool(\n  searchTools.name,\n  {\n    title: \"Search assistant-ui Documentation\",\n    description: searchTools.description,\n    inputSchema: searchTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  searchTools.execute,\n);\n\nserver.registerTool(\n  xuluxTemplatesListTool.name,\n  {\n    title: \"assistant-ui Templates\",\n    description: xuluxTemplatesListTool.description,\n    inputSchema: xuluxTemplatesListTool.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: true },\n  },\n  xuluxTemplatesListTool.execute,\n);\nserver.registerTool(\n  xuluxTemplateDetailsTool.name,\n  {\n    title: \"assistant-ui Template Details\",\n    description: xuluxTemplateDetailsTool.description,\n    inputSchema: xuluxTemplateDetailsTool.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: true },\n  },\n  xuluxTemplateDetailsTool.execute,\n);\nserver.registerTool(\n  xuluxTemplatePreviewTool.name,\n  {\n    title: \"assistant-ui Template Preview URLs\",\n    description: xuluxTemplatePreviewTool.description,\n    inputSchema: xuluxTemplatePreviewTool.parameters,\n    annotations: { readOnlyHint: false, openWorldHint: true },\n  },\n  xuluxTemplatePreviewTool.execute,\n);\n\nserver.registerPrompt(\n  xuluxPlaygroundPrompt.name,\n  {\n    title: \"assistant-ui Template Workflow\",\n    description: xuluxPlaygroundPrompt.description,\n  },\n  () => ({\n    messages: [\n      {\n        role: \"user\" as const,\n        content: { type: \"text\" as const, text: xuluxPlaygroundPrompt.text },\n      },\n    ],\n  }),\n);\n\nregisterResources(server);\n\nexport async function runServer() {\n  try {\n    logger.info(\n      `Starting assistant-ui MCP docs server v${packageJson.version}`,\n    );\n    const transport = new StdioServerTransport();\n    await server.connect(transport);\n  } catch (error) {\n    logger.error(\"Failed to start MCP server\", error);\n    process.exit(1);\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  void runServer().catch((error) => {\n    console.error(\"Failed to start server:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;AAkBA,MAAM,cAAc,KAAK,MACvB,aAAa,KAAK,aAAa,cAAc,GAAG,OAAO,CACzD;AAEA,MAAa,SAAS,IAAI,UAAU;CAClC,MAAM;CACN,SAAS,YAAY;AACvB,CAAC;AAED,OAAO,aACL,UAAU,MACV;CACE,OAAO;CACP,aAAa,UAAU;CACvB,aAAa,UAAU;CACvB,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,UAAU,OACZ;AACA,OAAO,aACL,cAAc,MACd;CACE,OAAO;CACP,aAAa,cAAc;CAC3B,aAAa,cAAc;CAC3B,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,cAAc,OAChB;AACA,OAAO,aACL,YAAY,MACZ;CACE,OAAO;CACP,aAAa,YAAY;CACzB,aAAa,YAAY;CACzB,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,YAAY,OACd;AAEA,OAAO,aACL,uBAAuB,MACvB;CACE,OAAO;CACP,aAAa,uBAAuB;CACpC,aAAa,uBAAuB;CACpC,aAAa;EAAE,cAAc;EAAM,eAAe;CAAK;AACzD,GACA,uBAAuB,OACzB;AACA,OAAO,aACL,yBAAyB,MACzB;CACE,OAAO;CACP,aAAa,yBAAyB;CACtC,aAAa,yBAAyB;CACtC,aAAa;EAAE,cAAc;EAAM,eAAe;CAAK;AACzD,GACA,yBAAyB,OAC3B;AACA,OAAO,aACL,yBAAyB,MACzB;CACE,OAAO;CACP,aAAa,yBAAyB;CACtC,aAAa,yBAAyB;CACtC,aAAa;EAAE,cAAc;EAAO,eAAe;CAAK;AAC1D,GACA,yBAAyB,OAC3B;AAEA,OAAO,eACL,sBAAsB,MACtB;CACE,OAAO;CACP,aAAa,sBAAsB;AACrC,UACO,EACL,UAAU,CACR;CACE,MAAM;CACN,SAAS;EAAE,MAAM;EAAiB,MAAM,sBAAsB;CAAK;AACrE,CACF,EACF,EACF;AAEA,kBAAkB,MAAM;AAExB,eAAsB,YAAY;CAChC,IAAI;EACF,OAAO,KACL,0CAA0C,YAAY,SACxD;EACA,MAAM,YAAY,IAAI,qBAAqB;EAC3C,MAAM,OAAO,QAAQ,SAAS;CAChC,SAAS,OAAO;EACd,OAAO,MAAM,8BAA8B,KAAK;EAChD,QAAQ,KAAK,CAAC;CAChB;AACF;AAEA,IAAI,YAAY,QAAQ,UAAU,QAAQ,KAAK,MAC7C,UAAe,CAAC,CAAC,OAAO,UAAU;CAChC,QAAQ,MAAM,2BAA2B,KAAK;CAC9C,QAAQ,KAAK,CAAC;AAChB,CAAC"}

package/dist/prepare-docs/prepare.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepare.js","names":[],"sources":["../../src/prepare-docs/prepare.ts"],"sourcesContent":["import { logger } from \"../utils/logger.js\";\nimport { copyRaw } from \"./copy-raw.js\";\nimport { prepareCodeExamples } from \"./code-examples.js\";\n\nasync function prepare(): Promise<void> {\n  logger.info(\"Starting documentation preparation...\");\n\n  try {\n    await copyRaw();\n    await prepareCodeExamples();\n\n    logger.info(\"Documentation preparation complete\");\n  } catch (error) {\n    logger.error(\"Documentation preparation failed\", error);\n    throw error;\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  prepare().catch((error) => {\n    logger.error(\"Preparation failed\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;AAIA,eAAe,UAAyB;CACtC,OAAO,KAAK,uCAAuC;CAEnD,IAAI;EACF,MAAM,QAAQ;EACd,MAAM,oBAAoB;EAE1B,OAAO,KAAK,oCAAoC;CAClD,SAAS,OAAO;EACd,OAAO,MAAM,oCAAoC,KAAK;EACtD,MAAM;CACR;AACF;AAEA,IAAI,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,MAC7C,QAAQ,CAAC,CAAC,OAAO,UAAU;CACzB,OAAO,MAAM,sBAAsB,KAAK;CACxC,QAAQ,KAAK,CAAC;AAChB,CAAC"}
+{"version":3,"file":"prepare.js","names":[],"sources":["../../src/prepare-docs/prepare.ts"],"sourcesContent":["import { logger } from \"../utils/logger.js\";\nimport { copyRaw } from \"./copy-raw.js\";\nimport { prepareCodeExamples } from \"./code-examples.js\";\n\nasync function prepare(): Promise<void> {\n  logger.info(\"Starting documentation preparation...\");\n\n  try {\n    await copyRaw();\n    await prepareCodeExamples();\n\n    logger.info(\"Documentation preparation complete\");\n  } catch (error) {\n    logger.error(\"Documentation preparation failed\", error);\n    throw error;\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  prepare().catch((error) => {\n    logger.error(\"Preparation failed\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;AAIA,eAAe,UAAyB;CACtC,OAAO,KAAK,uCAAuC;CAEnD,IAAI;EACF,MAAM,QAAQ;EACd,MAAM,oBAAoB;EAE1B,OAAO,KAAK,oCAAoC;CAClD,SAAS,OAAO;EACd,OAAO,MAAM,oCAAoC,KAAK;EACtD,MAAM;CACR;AACF;AAEA,IAAI,YAAY,QAAQ,UAAU,QAAQ,KAAK,MAC7C,QAAQ,CAAC,CAAC,OAAO,UAAU;CACzB,OAAO,MAAM,sBAAsB,KAAK;CACxC,QAAQ,KAAK,CAAC;AAChB,CAAC"}