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

package/.docs/raw/docs/ui/attachment.mdx

@@ -7,6 +7,11 @@ platforms: ["react"]
 import { AttachmentSample } from "@/components/docs/samples/attachment";
 import * as AttachmentRadixSamples from "@/components/docs/samples/attachment.radix";
 import { Flavored, FlavorSwitcher } from "@/components/docs/contexts/flavor.server";
+import { PreviewCode } from "@/components/docs/preview-code.server";
+import { AttachmentComposerSample } from "@/components/docs/samples/attachment/composer-attachments";
+import * as AttachmentComposerRadixSample from "@/components/docs/samples/attachment/composer-attachments.radix";
+import { AttachmentMessageContextSample } from "@/components/docs/samples/attachment/message-attachments";
+import * as AttachmentMessageRadixSample from "@/components/docs/samples/attachment/message-attachments.radix";
 
 <FlavorSwitcher />
 
@@ -35,6 +40,8 @@ This adds a `/components/assistant-ui/attachment.tsx` file to your project, whic
 
 ### Use in your application
 
+Add `ComposerAttachments` and `ComposerAddAttachment` to your composer:
+
 ```tsx title="/components/assistant-ui/thread.tsx" {1-4,9-10}
 import {
   ComposerAttachments,
@@ -59,6 +66,8 @@ const Composer: FC = () => {
 };
 ```
 
+Add `UserMessageAttachments` to your user message:
+
 ```tsx title="/components/assistant-ui/thread.tsx" {1,8}
 import { UserMessageAttachments } from "@/components/assistant-ui/attachment";
 
@@ -82,6 +91,24 @@ const UserMessage: FC = () => {
   </Step>
 </Steps>
 
+## Examples
+
+### Composer
+
+In the composer, each attachment tile shows a remove button that deletes the attachment from the composer. Use the plus button to add your own files.
+
+<PreviewCode file="components/docs/samples/attachment/composer-attachments" name="ComposerWithAttachments" base={<AttachmentComposerSample />}>
+  <AttachmentComposerRadixSample.AttachmentComposerSample />
+</PreviewCode>
+
+### User Message
+
+Message attachments are read-only. The same tile in a sent user message does not show a remove button.
+
+<PreviewCode file="components/docs/samples/attachment/message-attachments" name="UserMessageWithAttachments" base={<AttachmentMessageContextSample />}>
+  <AttachmentMessageRadixSample.AttachmentMessageContextSample />
+</PreviewCode>
+
 ## API Reference
 
 ### Composer Attachments

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

@@ -22,7 +22,7 @@ import { FileSample } from "@/components/docs/samples/file";
 
 ### Use in your application
 
-Pass `File` to `MessagePrimitive.Parts`:
+The shipped `Thread` component renders `file` parts through `File` by default, in both assistant and user messages. In a custom thread, pass `File` to `MessagePrimitive.Parts`:
 
 ```tsx title="/components/assistant-ui/thread.tsx" {1,8}
 import { File } from "@/components/assistant-ui/file";
@@ -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/image.mdx

@@ -22,7 +22,7 @@ import { ImageSample } from "@/components/docs/samples/image";
 
 ### Use in your application
 
-Pass `Image` to `MessagePrimitive.Parts`:
+The shipped `Thread` component renders `image` parts through `Image` by default, in both assistant and user messages. In a custom thread, pass `Image` to `MessagePrimitive.Parts`:
 
 ```tsx title="/components/assistant-ui/thread.tsx" {1,8}
 import { Image } from "@/components/assistant-ui/image";

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"}

package/dist/tools/docs.js

@@ -22,7 +22,8 @@ async function readDocumentation(docPath) {
 		};
 	}
 	try {
-		const fullPath = join(DOCS_PATH, sanitizePath(docPath));
+		const sanitized = sanitizePath(docPath);
+		const fullPath = join(DOCS_PATH, sanitized);
 		try {
 			if ((await lstat(fullPath)).isSymbolicLink()) {
 				logger.warn(`Symlink detected at path: ${fullPath}`);
@@ -121,10 +122,11 @@ async function readDocumentation(docPath) {
 				};
 			}
 		}
+		const availablePaths = await getAvailablePaths();
 		return {
 			path: docPath,
 			found: false,
-			suggestions: findNearestPaths(docPath, await getAvailablePaths())
+			suggestions: findNearestPaths(docPath, availablePaths)
 		};
 	} catch (error) {
 		if (error instanceof Error && error.message.includes("Invalid path")) return {

package/dist/tools/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","names":[],"sources":["../../src/tools/docs.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { stat, lstat } from \"node:fs/promises\";\nimport { join, extname } from \"node:path\";\nimport {\n  DOCS_PATH,\n  MDX_EXTENSION,\n  MAX_FILE_SIZE,\n  MAX_DIRECTORY_CONTENT_SIZE,\n} from \"../constants.js\";\nimport { logger } from \"../utils/logger.js\";\nimport {\n  listDirContents,\n  getAvailablePaths,\n  findNearestPaths,\n  pathExists,\n} from \"../utils/paths.js\";\nimport { readMDXFile, formatMDXContent } from \"../utils/mdx.js\";\nimport { formatMCPResponse } from \"../utils/mcp-format.js\";\nimport { sanitizePath } from \"../utils/security.js\";\n\nconst docsInputSchema = z.object({\n  paths: z\n    .array(z.string())\n    .min(1)\n    .describe(\n      'Documentation paths to retrieve (e.g., [\"getting-started\", \"api-reference/primitives/thread\"])',\n    ),\n});\n\ninterface DocResult {\n  path: string;\n  found: boolean;\n  type?: \"file\" | \"directory\";\n  content?: string;\n  files?: string[];\n  directories?: string[];\n  summaries?: Array<{ name: string; title?: string; excerpt?: string }>;\n  title?: string;\n  excerpt?: string;\n  suggestions?: string[];\n  hint?: string;\n  error?: string;\n}\n\nasync function readDocumentation(docPath: string): Promise<DocResult> {\n  logger.debug(`Reading documentation for path: ${docPath}`);\n\n  if (docPath === \"/\" || docPath === \"\") {\n    const { directories, files } = await listDirContents(DOCS_PATH);\n    return {\n      path: \"/\",\n      found: true,\n      type: \"directory\",\n      directories,\n      files: files.map((f) => f.replace(MDX_EXTENSION, \"\")),\n    };\n  }\n\n  try {\n    const sanitized = sanitizePath(docPath);\n    const fullPath = join(DOCS_PATH, sanitized);\n\n    try {\n      const lstats = await lstat(fullPath);\n      if (lstats.isSymbolicLink()) {\n        logger.warn(`Symlink detected at path: ${fullPath}`);\n        return {\n          path: docPath,\n          found: false,\n          error: \"Symlinks are not allowed for security reasons\",\n        };\n      }\n    } catch {}\n\n    if (await pathExists(fullPath)) {\n      const stats = await stat(fullPath);\n\n      if (stats.isFile() && stats.size > MAX_FILE_SIZE) {\n        logger.warn(`File too large: ${fullPath} (${stats.size} bytes)`);\n        return {\n          path: docPath,\n          found: false,\n          error: `File size exceeds maximum allowed size of ${MAX_FILE_SIZE} bytes`,\n        };\n      }\n\n      if (stats.isDirectory()) {\n        const { directories, files } = await listDirContents(fullPath);\n\n        const contents: Record<string, string> = {};\n        const summaries: Array<{\n          name: string;\n          title?: string;\n          excerpt?: string;\n        }> = [];\n        let aggregateSize = 0;\n        let truncated = false;\n        for (const file of files) {\n          let fileSize: number;\n          try {\n            fileSize = (await stat(join(fullPath, file))).size;\n          } catch (error) {\n            logger.warn(\n              `Failed to stat MDX file: ${join(fullPath, file)}`,\n              error,\n            );\n            continue;\n          }\n          aggregateSize += fileSize;\n          if (aggregateSize > MAX_DIRECTORY_CONTENT_SIZE) {\n            truncated = true;\n            break;\n          }\n          const mdxContent = await readMDXFile(join(fullPath, file));\n          if (mdxContent) {\n            const name = file.replace(MDX_EXTENSION, \"\");\n            contents[name] = formatMDXContent(mdxContent);\n            const title = mdxContent.frontmatter[\"title\"];\n            summaries.push({\n              name,\n              ...(typeof title === \"string\" && { title }),\n              ...(mdxContent.excerpt !== undefined && {\n                excerpt: mdxContent.excerpt,\n              }),\n            });\n          }\n        }\n\n        const content =\n          !truncated && Object.keys(contents).length > 0\n            ? JSON.stringify(contents, null, 2)\n            : undefined;\n        return {\n          path: docPath,\n          found: true,\n          type: \"directory\",\n          directories,\n          files: files.map((f) => f.replace(MDX_EXTENSION, \"\")),\n          ...(summaries.length > 0 && { summaries }),\n          ...(content !== undefined && { content }),\n          ...(truncated && {\n            hint: `Directory content exceeds ${MAX_DIRECTORY_CONTENT_SIZE} bytes and was omitted; summaries cover only the files read before the limit. Request individual files by path to retrieve their content.`,\n          }),\n        };\n      }\n    }\n\n    const mdxPath =\n      extname(fullPath) === MDX_EXTENSION\n        ? fullPath\n        : `${fullPath}${MDX_EXTENSION}`;\n\n    try {\n      const mdxLstats = await lstat(mdxPath);\n      if (mdxLstats.isSymbolicLink()) {\n        logger.warn(`Symlink detected at MDX path: ${mdxPath}`);\n        return {\n          path: docPath,\n          found: false,\n          error: \"Symlinks are not allowed for security reasons\",\n        };\n      }\n\n      if (mdxLstats.size > MAX_FILE_SIZE) {\n        logger.warn(`MDX file too large: ${mdxPath} (${mdxLstats.size} bytes)`);\n        return {\n          path: docPath,\n          found: false,\n          error: `File size exceeds maximum allowed size of ${MAX_FILE_SIZE} bytes`,\n        };\n      }\n    } catch {}\n\n    if (await pathExists(mdxPath)) {\n      const mdxContent = await readMDXFile(mdxPath);\n\n      if (mdxContent) {\n        const title = mdxContent.frontmatter[\"title\"];\n        return {\n          path: docPath,\n          found: true,\n          type: \"file\",\n          content: formatMDXContent(mdxContent),\n          ...(typeof title === \"string\" && { title }),\n          ...(mdxContent.excerpt !== undefined && {\n            excerpt: mdxContent.excerpt,\n          }),\n        };\n      }\n    }\n\n    const availablePaths = await getAvailablePaths();\n    const suggestions = findNearestPaths(docPath, availablePaths);\n\n    return {\n      path: docPath,\n      found: false,\n      suggestions,\n    };\n  } catch (error) {\n    if (error instanceof Error && error.message.includes(\"Invalid path\")) {\n      return {\n        path: docPath,\n        found: false,\n        error: error.message,\n      };\n    }\n    throw error;\n  }\n}\n\nexport const docsTools = {\n  name: \"assistantUIDocs\",\n  description:\n    'Retrieve assistant-ui documentation by path. Use \"/\" to list all sections. Supports multiple paths in a single request.',\n  parameters: docsInputSchema,\n  execute: async ({ paths }: z.infer<typeof docsInputSchema>) => {\n    logger.info(`Retrieving documentation for paths: ${paths.join(\", \")}`);\n\n    try {\n      const results = await Promise.all(\n        paths.map((path) => readDocumentation(path)),\n      );\n\n      if (results.length === 1) {\n        const result = results[0]!;\n        if (result.error) {\n          return formatMCPResponse({\n            error: result.error,\n            path: result.path,\n          });\n        }\n        if (!result.found) {\n          return formatMCPResponse({\n            error: `Documentation not found for path: ${result.path}`,\n            suggestions: result.suggestions,\n            hint: 'Use \"/\" to list all available documentation sections',\n          });\n        }\n        return formatMCPResponse(result);\n      }\n\n      return formatMCPResponse({\n        results,\n        summary: `Retrieved ${results.filter((r) => r.found).length} of ${results.length} requested paths`,\n      });\n    } catch (error) {\n      logger.error(\"Failed to retrieve documentation\", error);\n      return formatMCPResponse({\n        error: \"Failed to retrieve documentation\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n"],"mappings":"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"}
+{"version":3,"file":"docs.js","names":[],"sources":["../../src/tools/docs.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { stat, lstat } from \"node:fs/promises\";\nimport { join, extname } from \"node:path\";\nimport {\n  DOCS_PATH,\n  MDX_EXTENSION,\n  MAX_FILE_SIZE,\n  MAX_DIRECTORY_CONTENT_SIZE,\n} from \"../constants.js\";\nimport { logger } from \"../utils/logger.js\";\nimport {\n  listDirContents,\n  getAvailablePaths,\n  findNearestPaths,\n  pathExists,\n} from \"../utils/paths.js\";\nimport { readMDXFile, formatMDXContent } from \"../utils/mdx.js\";\nimport { formatMCPResponse } from \"../utils/mcp-format.js\";\nimport { sanitizePath } from \"../utils/security.js\";\n\nconst docsInputSchema = z.object({\n  paths: z\n    .array(z.string())\n    .min(1)\n    .describe(\n      'Documentation paths to retrieve (e.g., [\"getting-started\", \"api-reference/primitives/thread\"])',\n    ),\n});\n\ninterface DocResult {\n  path: string;\n  found: boolean;\n  type?: \"file\" | \"directory\";\n  content?: string;\n  files?: string[];\n  directories?: string[];\n  summaries?: Array<{ name: string; title?: string; excerpt?: string }>;\n  title?: string;\n  excerpt?: string;\n  suggestions?: string[];\n  hint?: string;\n  error?: string;\n}\n\nasync function readDocumentation(docPath: string): Promise<DocResult> {\n  logger.debug(`Reading documentation for path: ${docPath}`);\n\n  if (docPath === \"/\" || docPath === \"\") {\n    const { directories, files } = await listDirContents(DOCS_PATH);\n    return {\n      path: \"/\",\n      found: true,\n      type: \"directory\",\n      directories,\n      files: files.map((f) => f.replace(MDX_EXTENSION, \"\")),\n    };\n  }\n\n  try {\n    const sanitized = sanitizePath(docPath);\n    const fullPath = join(DOCS_PATH, sanitized);\n\n    try {\n      const lstats = await lstat(fullPath);\n      if (lstats.isSymbolicLink()) {\n        logger.warn(`Symlink detected at path: ${fullPath}`);\n        return {\n          path: docPath,\n          found: false,\n          error: \"Symlinks are not allowed for security reasons\",\n        };\n      }\n    } catch {}\n\n    if (await pathExists(fullPath)) {\n      const stats = await stat(fullPath);\n\n      if (stats.isFile() && stats.size > MAX_FILE_SIZE) {\n        logger.warn(`File too large: ${fullPath} (${stats.size} bytes)`);\n        return {\n          path: docPath,\n          found: false,\n          error: `File size exceeds maximum allowed size of ${MAX_FILE_SIZE} bytes`,\n        };\n      }\n\n      if (stats.isDirectory()) {\n        const { directories, files } = await listDirContents(fullPath);\n\n        const contents: Record<string, string> = {};\n        const summaries: Array<{\n          name: string;\n          title?: string;\n          excerpt?: string;\n        }> = [];\n        let aggregateSize = 0;\n        let truncated = false;\n        for (const file of files) {\n          let fileSize: number;\n          try {\n            fileSize = (await stat(join(fullPath, file))).size;\n          } catch (error) {\n            logger.warn(\n              `Failed to stat MDX file: ${join(fullPath, file)}`,\n              error,\n            );\n            continue;\n          }\n          aggregateSize += fileSize;\n          if (aggregateSize > MAX_DIRECTORY_CONTENT_SIZE) {\n            truncated = true;\n            break;\n          }\n          const mdxContent = await readMDXFile(join(fullPath, file));\n          if (mdxContent) {\n            const name = file.replace(MDX_EXTENSION, \"\");\n            contents[name] = formatMDXContent(mdxContent);\n            const title = mdxContent.frontmatter[\"title\"];\n            summaries.push({\n              name,\n              ...(typeof title === \"string\" && { title }),\n              ...(mdxContent.excerpt !== undefined && {\n                excerpt: mdxContent.excerpt,\n              }),\n            });\n          }\n        }\n\n        const content =\n          !truncated && Object.keys(contents).length > 0\n            ? JSON.stringify(contents, null, 2)\n            : undefined;\n        return {\n          path: docPath,\n          found: true,\n          type: \"directory\",\n          directories,\n          files: files.map((f) => f.replace(MDX_EXTENSION, \"\")),\n          ...(summaries.length > 0 && { summaries }),\n          ...(content !== undefined && { content }),\n          ...(truncated && {\n            hint: `Directory content exceeds ${MAX_DIRECTORY_CONTENT_SIZE} bytes and was omitted; summaries cover only the files read before the limit. Request individual files by path to retrieve their content.`,\n          }),\n        };\n      }\n    }\n\n    const mdxPath =\n      extname(fullPath) === MDX_EXTENSION\n        ? fullPath\n        : `${fullPath}${MDX_EXTENSION}`;\n\n    try {\n      const mdxLstats = await lstat(mdxPath);\n      if (mdxLstats.isSymbolicLink()) {\n        logger.warn(`Symlink detected at MDX path: ${mdxPath}`);\n        return {\n          path: docPath,\n          found: false,\n          error: \"Symlinks are not allowed for security reasons\",\n        };\n      }\n\n      if (mdxLstats.size > MAX_FILE_SIZE) {\n        logger.warn(`MDX file too large: ${mdxPath} (${mdxLstats.size} bytes)`);\n        return {\n          path: docPath,\n          found: false,\n          error: `File size exceeds maximum allowed size of ${MAX_FILE_SIZE} bytes`,\n        };\n      }\n    } catch {}\n\n    if (await pathExists(mdxPath)) {\n      const mdxContent = await readMDXFile(mdxPath);\n\n      if (mdxContent) {\n        const title = mdxContent.frontmatter[\"title\"];\n        return {\n          path: docPath,\n          found: true,\n          type: \"file\",\n          content: formatMDXContent(mdxContent),\n          ...(typeof title === \"string\" && { title }),\n          ...(mdxContent.excerpt !== undefined && {\n            excerpt: mdxContent.excerpt,\n          }),\n        };\n      }\n    }\n\n    const availablePaths = await getAvailablePaths();\n    const suggestions = findNearestPaths(docPath, availablePaths);\n\n    return {\n      path: docPath,\n      found: false,\n      suggestions,\n    };\n  } catch (error) {\n    if (error instanceof Error && error.message.includes(\"Invalid path\")) {\n      return {\n        path: docPath,\n        found: false,\n        error: error.message,\n      };\n    }\n    throw error;\n  }\n}\n\nexport const docsTools = {\n  name: \"assistantUIDocs\",\n  description:\n    'Retrieve assistant-ui documentation by path. Use \"/\" to list all sections. Supports multiple paths in a single request.',\n  parameters: docsInputSchema,\n  execute: async ({ paths }: z.infer<typeof docsInputSchema>) => {\n    logger.info(`Retrieving documentation for paths: ${paths.join(\", \")}`);\n\n    try {\n      const results = await Promise.all(\n        paths.map((path) => readDocumentation(path)),\n      );\n\n      if (results.length === 1) {\n        const result = results[0]!;\n        if (result.error) {\n          return formatMCPResponse({\n            error: result.error,\n            path: result.path,\n          });\n        }\n        if (!result.found) {\n          return formatMCPResponse({\n            error: `Documentation not found for path: ${result.path}`,\n            suggestions: result.suggestions,\n            hint: 'Use \"/\" to list all available documentation sections',\n          });\n        }\n        return formatMCPResponse(result);\n      }\n\n      return formatMCPResponse({\n        results,\n        summary: `Retrieved ${results.filter((r) => r.found).length} of ${results.length} requested paths`,\n      });\n    } catch (error) {\n      logger.error(\"Failed to retrieve documentation\", error);\n      return formatMCPResponse({\n        error: \"Failed to retrieve documentation\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n"],"mappings":";;;;;;;;;;AAoBA,MAAM,kBAAkB,EAAE,OAAO,EAC/B,OAAO,EACJ,MAAM,EAAE,OAAO,CAAC,CAAC,CACjB,IAAI,CAAC,CAAC,CACN,SACC,oGACF,EACJ,CAAC;AAiBD,eAAe,kBAAkB,SAAqC;CACpE,OAAO,MAAM,mCAAmC,SAAS;CAEzD,IAAI,YAAY,OAAO,YAAY,IAAI;EACrC,MAAM,EAAE,aAAa,UAAU,MAAM,gBAAgB,SAAS;EAC9D,OAAO;GACL,MAAM;GACN,OAAO;GACP,MAAM;GACN;GACA,OAAO,MAAM,KAAK,MAAM,EAAE,QAAQ,eAAe,EAAE,CAAC;EACtD;CACF;CAEA,IAAI;EACF,MAAM,YAAY,aAAa,OAAO;EACtC,MAAM,WAAW,KAAK,WAAW,SAAS;EAE1C,IAAI;GAEF,KAAI,MADiB,MAAM,QAAQ,EAAA,CACxB,eAAe,GAAG;IAC3B,OAAO,KAAK,6BAA6B,UAAU;IACnD,OAAO;KACL,MAAM;KACN,OAAO;KACP,OAAO;IACT;GACF;EACF,QAAQ,CAAC;EAET,IAAI,MAAM,WAAW,QAAQ,GAAG;GAC9B,MAAM,QAAQ,MAAM,KAAK,QAAQ;GAEjC,IAAI,MAAM,OAAO,KAAK,MAAM,OAAA,UAAsB;IAChD,OAAO,KAAK,mBAAmB,SAAS,IAAI,MAAM,KAAK,QAAQ;IAC/D,OAAO;KACL,MAAM;KACN,OAAO;KACP,OAAO,6CAA6C,cAAc;IACpE;GACF;GAEA,IAAI,MAAM,YAAY,GAAG;IACvB,MAAM,EAAE,aAAa,UAAU,MAAM,gBAAgB,QAAQ;IAE7D,MAAM,WAAmC,CAAC;IAC1C,MAAM,YAID,CAAC;IACN,IAAI,gBAAgB;IACpB,IAAI,YAAY;IAChB,KAAK,MAAM,QAAQ,OAAO;KACxB,IAAI;KACJ,IAAI;MACF,YAAY,MAAM,KAAK,KAAK,UAAU,IAAI,CAAC,EAAA,CAAG;KAChD,SAAS,OAAO;MACd,OAAO,KACL,4BAA4B,KAAK,UAAU,IAAI,KAC/C,KACF;MACA;KACF;KACA,iBAAiB;KACjB,IAAI,gBAAA,SAA4C;MAC9C,YAAY;MACZ;KACF;KACA,MAAM,aAAa,MAAM,YAAY,KAAK,UAAU,IAAI,CAAC;KACzD,IAAI,YAAY;MACd,MAAM,OAAO,KAAK,QAAQ,eAAe,EAAE;MAC3C,SAAS,QAAQ,iBAAiB,UAAU;MAC5C,MAAM,QAAQ,WAAW,YAAY;MACrC,UAAU,KAAK;OACb;OACA,GAAI,OAAO,UAAU,YAAY,EAAE,MAAM;OACzC,GAAI,WAAW,YAAY,KAAA,KAAa,EACtC,SAAS,WAAW,QACtB;MACF,CAAC;KACH;IACF;IAEA,MAAM,UACJ,CAAC,aAAa,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,IACzC,KAAK,UAAU,UAAU,MAAM,CAAC,IAChC,KAAA;IACN,OAAO;KACL,MAAM;KACN,OAAO;KACP,MAAM;KACN;KACA,OAAO,MAAM,KAAK,MAAM,EAAE,QAAQ,eAAe,EAAE,CAAC;KACpD,GAAI,UAAU,SAAS,KAAK,EAAE,UAAU;KACxC,GAAI,YAAY,KAAA,KAAa,EAAE,QAAQ;KACvC,GAAI,aAAa,EACf,MAAM,6KACR;IACF;GACF;EACF;EAEA,MAAM,UACJ,QAAQ,QAAQ,MAAA,SACZ,WACA,GAAG,WAAW;EAEpB,IAAI;GACF,MAAM,YAAY,MAAM,MAAM,OAAO;GACrC,IAAI,UAAU,eAAe,GAAG;IAC9B,OAAO,KAAK,iCAAiC,SAAS;IACtD,OAAO;KACL,MAAM;KACN,OAAO;KACP,OAAO;IACT;GACF;GAEA,IAAI,UAAU,OAAA,UAAsB;IAClC,OAAO,KAAK,uBAAuB,QAAQ,IAAI,UAAU,KAAK,QAAQ;IACtE,OAAO;KACL,MAAM;KACN,OAAO;KACP,OAAO,6CAA6C,cAAc;IACpE;GACF;EACF,QAAQ,CAAC;EAET,IAAI,MAAM,WAAW,OAAO,GAAG;GAC7B,MAAM,aAAa,MAAM,YAAY,OAAO;GAE5C,IAAI,YAAY;IACd,MAAM,QAAQ,WAAW,YAAY;IACrC,OAAO;KACL,MAAM;KACN,OAAO;KACP,MAAM;KACN,SAAS,iBAAiB,UAAU;KACpC,GAAI,OAAO,UAAU,YAAY,EAAE,MAAM;KACzC,GAAI,WAAW,YAAY,KAAA,KAAa,EACtC,SAAS,WAAW,QACtB;IACF;GACF;EACF;EAEA,MAAM,iBAAiB,MAAM,kBAAkB;EAG/C,OAAO;GACL,MAAM;GACN,OAAO;GACP,aALkB,iBAAiB,SAAS,cAKlC;EACZ;CACF,SAAS,OAAO;EACd,IAAI,iBAAiB,SAAS,MAAM,QAAQ,SAAS,cAAc,GACjE,OAAO;GACL,MAAM;GACN,OAAO;GACP,OAAO,MAAM;EACf;EAEF,MAAM;CACR;AACF;AAEA,MAAa,YAAY;CACvB,MAAM;CACN,aACE;CACF,YAAY;CACZ,SAAS,OAAO,EAAE,YAA6C;EAC7D,OAAO,KAAK,uCAAuC,MAAM,KAAK,IAAI,GAAG;EAErE,IAAI;GACF,MAAM,UAAU,MAAM,QAAQ,IAC5B,MAAM,KAAK,SAAS,kBAAkB,IAAI,CAAC,CAC7C;GAEA,IAAI,QAAQ,WAAW,GAAG;IACxB,MAAM,SAAS,QAAQ;IACvB,IAAI,OAAO,OACT,OAAO,kBAAkB;KACvB,OAAO,OAAO;KACd,MAAM,OAAO;IACf,CAAC;IAEH,IAAI,CAAC,OAAO,OACV,OAAO,kBAAkB;KACvB,OAAO,qCAAqC,OAAO;KACnD,aAAa,OAAO;KACpB,MAAM;IACR,CAAC;IAEH,OAAO,kBAAkB,MAAM;GACjC;GAEA,OAAO,kBAAkB;IACvB;IACA,SAAS,aAAa,QAAQ,QAAQ,MAAM,EAAE,KAAK,CAAC,CAAC,OAAO,MAAM,QAAQ,OAAO;GACnF,CAAC;EACH,SAAS,OAAO;GACd,OAAO,MAAM,oCAAoC,KAAK;GACtD,OAAO,kBAAkB;IACvB,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH;CACF;AACF"}

package/dist/tools/examples.js

@@ -20,7 +20,8 @@ async function scanCodeExamples() {
 }
 async function readCodeExample(exampleName) {
 	try {
-		const filePath = join(CODE_EXAMPLES_PATH, `${sanitizePath(exampleName)}.md`);
+		const sanitized = sanitizePath(exampleName);
+		const filePath = join(CODE_EXAMPLES_PATH, `${sanitized}.md`);
 		const stats = await lstat(filePath);
 		if (stats.isSymbolicLink()) {
 			logger.warn(`Attempted to read symlink: ${filePath}`);

package/dist/tools/examples.js.map

@@ -1 +1 @@
-{"version":3,"file":"examples.js","names":[],"sources":["../../src/tools/examples.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { readFile, readdir, lstat } from \"node:fs/promises\";\nimport { join, extname } from \"node:path\";\nimport { CODE_EXAMPLES_PATH, MAX_FILE_SIZE } from \"../constants.js\";\nimport { cacheListing } from \"../utils/cache.js\";\nimport { logger } from \"../utils/logger.js\";\nimport { formatMCPResponse } from \"../utils/mcp-format.js\";\nimport { sanitizePath } from \"../utils/security.js\";\n\nconst examplesInputSchema = z.object({\n  example: z\n    .string()\n    .optional()\n    .describe(\n      'Example name (e.g., \"with-ai-sdk-v7\"). Leave empty to list all examples.',\n    ),\n});\n\nconst loadCodeExamples = cacheListing(scanCodeExamples);\n\nexport function listCodeExamples(): Promise<string[]> {\n  return loadCodeExamples().catch((error) => {\n    logger.error(\"Failed to list code examples\", error);\n    return [];\n  });\n}\n\nasync function scanCodeExamples(): Promise<string[]> {\n  const files = await readdir(CODE_EXAMPLES_PATH);\n  return files\n    .filter((file) => extname(file) === \".md\")\n    .map((file) => file.replace(\".md\", \"\"))\n    .sort();\n}\n\nexport async function readCodeExample(\n  exampleName: string,\n): Promise<string | null> {\n  try {\n    const sanitized = sanitizePath(exampleName);\n    const filePath = join(CODE_EXAMPLES_PATH, `${sanitized}.md`);\n\n    const stats = await lstat(filePath);\n    if (stats.isSymbolicLink()) {\n      logger.warn(`Attempted to read symlink: ${filePath}`);\n      return null;\n    }\n\n    if (stats.size > MAX_FILE_SIZE) {\n      logger.warn(`File size exceeds limit: ${filePath} (${stats.size} bytes)`);\n      return null;\n    }\n\n    const content = await readFile(filePath, \"utf-8\");\n    return content;\n  } catch (error) {\n    logger.error(`Failed to read example: ${exampleName}`, error);\n    return null;\n  }\n}\n\nexport const examplesTools = {\n  name: \"assistantUIExamples\",\n  description:\n    \"List available examples or retrieve complete code for a specific example\",\n  parameters: examplesInputSchema,\n  execute: async ({ example }: z.infer<typeof examplesInputSchema>) => {\n    try {\n      if (!example) {\n        logger.info(\"Listing all available examples\");\n        const examples = await listCodeExamples();\n\n        if (examples.length === 0) {\n          return formatMCPResponse({\n            error:\n              \"No examples found. Please run documentation preparation first.\",\n            hint: \"Run: pnpm prepare-docs\",\n          });\n        }\n\n        return formatMCPResponse({\n          type: \"list\",\n          examples,\n          total: examples.length,\n          hint: \"Use example parameter to get complete code for any example\",\n        });\n      }\n\n      logger.info(`Retrieving example: ${example}`);\n      const content = await readCodeExample(example);\n\n      if (!content) {\n        const availableExamples = await listCodeExamples();\n        return formatMCPResponse({\n          error: `Example not found: ${example}`,\n          availableExamples,\n          hint: \"Use without example parameter to list all available examples\",\n        });\n      }\n\n      return formatMCPResponse({\n        type: \"example\",\n        name: example,\n        content,\n      });\n    } catch (error) {\n      logger.error(\"Failed to retrieve examples\", error);\n      return formatMCPResponse({\n        error: \"Failed to retrieve examples\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n"],"mappings":";;;;;;;;;AASA,MAAM,sBAAsB,EAAE,OAAO,EACnC,SAAS,EACN,OAAO,CAAC,CACR,SAAS,CAAC,CACV,SACC,4EACF,EACJ,CAAC;AAED,MAAM,mBAAmB,aAAa,gBAAgB;AAEtD,SAAgB,mBAAsC;CACpD,OAAO,iBAAiB,CAAC,CAAC,OAAO,UAAU;EACzC,OAAO,MAAM,gCAAgC,KAAK;EAClD,OAAO,CAAC;CACV,CAAC;AACH;AAEA,eAAe,mBAAsC;CAEnD,QAAO,MADa,QAAQ,kBAAkB,EAAA,CAE3C,QAAQ,SAAS,QAAQ,IAAI,MAAM,KAAK,CAAC,CACzC,KAAK,SAAS,KAAK,QAAQ,OAAO,EAAE,CAAC,CAAC,CACtC,KAAK;AACV;AAEA,eAAsB,gBACpB,aACwB;CACxB,IAAI;EAEF,MAAM,WAAW,KAAK,oBAAoB,GADxB,aAAa,WACsB,EAAE,IAAI;EAE3D,MAAM,QAAQ,MAAM,MAAM,QAAQ;EAClC,IAAI,MAAM,eAAe,GAAG;GAC1B,OAAO,KAAK,8BAA8B,UAAU;GACpD,OAAO;EACT;EAEA,IAAI,MAAM,OAAA,UAAsB;GAC9B,OAAO,KAAK,4BAA4B,SAAS,IAAI,MAAM,KAAK,QAAQ;GACxE,OAAO;EACT;EAGA,OAAO,MADe,SAAS,UAAU,OAAO;CAElD,SAAS,OAAO;EACd,OAAO,MAAM,2BAA2B,eAAe,KAAK;EAC5D,OAAO;CACT;AACF;AAEA,MAAa,gBAAgB;CAC3B,MAAM;CACN,aACE;CACF,YAAY;CACZ,SAAS,OAAO,EAAE,cAAmD;EACnE,IAAI;GACF,IAAI,CAAC,SAAS;IACZ,OAAO,KAAK,gCAAgC;IAC5C,MAAM,WAAW,MAAM,iBAAiB;IAExC,IAAI,SAAS,WAAW,GACtB,OAAO,kBAAkB;KACvB,OACE;KACF,MAAM;IACR,CAAC;IAGH,OAAO,kBAAkB;KACvB,MAAM;KACN;KACA,OAAO,SAAS;KAChB,MAAM;IACR,CAAC;GACH;GAEA,OAAO,KAAK,uBAAuB,SAAS;GAC5C,MAAM,UAAU,MAAM,gBAAgB,OAAO;GAE7C,IAAI,CAAC,SAAS;IACZ,MAAM,oBAAoB,MAAM,iBAAiB;IACjD,OAAO,kBAAkB;KACvB,OAAO,sBAAsB;KAC7B;KACA,MAAM;IACR,CAAC;GACH;GAEA,OAAO,kBAAkB;IACvB,MAAM;IACN,MAAM;IACN;GACF,CAAC;EACH,SAAS,OAAO;GACd,OAAO,MAAM,+BAA+B,KAAK;GACjD,OAAO,kBAAkB;IACvB,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH;CACF;AACF"}
+{"version":3,"file":"examples.js","names":[],"sources":["../../src/tools/examples.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { readFile, readdir, lstat } from \"node:fs/promises\";\nimport { join, extname } from \"node:path\";\nimport { CODE_EXAMPLES_PATH, MAX_FILE_SIZE } from \"../constants.js\";\nimport { cacheListing } from \"../utils/cache.js\";\nimport { logger } from \"../utils/logger.js\";\nimport { formatMCPResponse } from \"../utils/mcp-format.js\";\nimport { sanitizePath } from \"../utils/security.js\";\n\nconst examplesInputSchema = z.object({\n  example: z\n    .string()\n    .optional()\n    .describe(\n      'Example name (e.g., \"with-ai-sdk-v7\"). Leave empty to list all examples.',\n    ),\n});\n\nconst loadCodeExamples = cacheListing(scanCodeExamples);\n\nexport function listCodeExamples(): Promise<string[]> {\n  return loadCodeExamples().catch((error) => {\n    logger.error(\"Failed to list code examples\", error);\n    return [];\n  });\n}\n\nasync function scanCodeExamples(): Promise<string[]> {\n  const files = await readdir(CODE_EXAMPLES_PATH);\n  return files\n    .filter((file) => extname(file) === \".md\")\n    .map((file) => file.replace(\".md\", \"\"))\n    .sort();\n}\n\nexport async function readCodeExample(\n  exampleName: string,\n): Promise<string | null> {\n  try {\n    const sanitized = sanitizePath(exampleName);\n    const filePath = join(CODE_EXAMPLES_PATH, `${sanitized}.md`);\n\n    const stats = await lstat(filePath);\n    if (stats.isSymbolicLink()) {\n      logger.warn(`Attempted to read symlink: ${filePath}`);\n      return null;\n    }\n\n    if (stats.size > MAX_FILE_SIZE) {\n      logger.warn(`File size exceeds limit: ${filePath} (${stats.size} bytes)`);\n      return null;\n    }\n\n    const content = await readFile(filePath, \"utf-8\");\n    return content;\n  } catch (error) {\n    logger.error(`Failed to read example: ${exampleName}`, error);\n    return null;\n  }\n}\n\nexport const examplesTools = {\n  name: \"assistantUIExamples\",\n  description:\n    \"List available examples or retrieve complete code for a specific example\",\n  parameters: examplesInputSchema,\n  execute: async ({ example }: z.infer<typeof examplesInputSchema>) => {\n    try {\n      if (!example) {\n        logger.info(\"Listing all available examples\");\n        const examples = await listCodeExamples();\n\n        if (examples.length === 0) {\n          return formatMCPResponse({\n            error:\n              \"No examples found. Please run documentation preparation first.\",\n            hint: \"Run: pnpm prepare-docs\",\n          });\n        }\n\n        return formatMCPResponse({\n          type: \"list\",\n          examples,\n          total: examples.length,\n          hint: \"Use example parameter to get complete code for any example\",\n        });\n      }\n\n      logger.info(`Retrieving example: ${example}`);\n      const content = await readCodeExample(example);\n\n      if (!content) {\n        const availableExamples = await listCodeExamples();\n        return formatMCPResponse({\n          error: `Example not found: ${example}`,\n          availableExamples,\n          hint: \"Use without example parameter to list all available examples\",\n        });\n      }\n\n      return formatMCPResponse({\n        type: \"example\",\n        name: example,\n        content,\n      });\n    } catch (error) {\n      logger.error(\"Failed to retrieve examples\", error);\n      return formatMCPResponse({\n        error: \"Failed to retrieve examples\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n"],"mappings":";;;;;;;;;AASA,MAAM,sBAAsB,EAAE,OAAO,EACnC,SAAS,EACN,OAAO,CAAC,CACR,SAAS,CAAC,CACV,SACC,4EACF,EACJ,CAAC;AAED,MAAM,mBAAmB,aAAa,gBAAgB;AAEtD,SAAgB,mBAAsC;CACpD,OAAO,iBAAiB,CAAC,CAAC,OAAO,UAAU;EACzC,OAAO,MAAM,gCAAgC,KAAK;EAClD,OAAO,CAAC;CACV,CAAC;AACH;AAEA,eAAe,mBAAsC;CAEnD,QAAO,MADa,QAAQ,kBAAkB,EAAA,CAE3C,QAAQ,SAAS,QAAQ,IAAI,MAAM,KAAK,CAAC,CACzC,KAAK,SAAS,KAAK,QAAQ,OAAO,EAAE,CAAC,CAAC,CACtC,KAAK;AACV;AAEA,eAAsB,gBACpB,aACwB;CACxB,IAAI;EACF,MAAM,YAAY,aAAa,WAAW;EAC1C,MAAM,WAAW,KAAK,oBAAoB,GAAG,UAAU,IAAI;EAE3D,MAAM,QAAQ,MAAM,MAAM,QAAQ;EAClC,IAAI,MAAM,eAAe,GAAG;GAC1B,OAAO,KAAK,8BAA8B,UAAU;GACpD,OAAO;EACT;EAEA,IAAI,MAAM,OAAA,UAAsB;GAC9B,OAAO,KAAK,4BAA4B,SAAS,IAAI,MAAM,KAAK,QAAQ;GACxE,OAAO;EACT;EAGA,OAAO,MADe,SAAS,UAAU,OAAO;CAElD,SAAS,OAAO;EACd,OAAO,MAAM,2BAA2B,eAAe,KAAK;EAC5D,OAAO;CACT;AACF;AAEA,MAAa,gBAAgB;CAC3B,MAAM;CACN,aACE;CACF,YAAY;CACZ,SAAS,OAAO,EAAE,cAAmD;EACnE,IAAI;GACF,IAAI,CAAC,SAAS;IACZ,OAAO,KAAK,gCAAgC;IAC5C,MAAM,WAAW,MAAM,iBAAiB;IAExC,IAAI,SAAS,WAAW,GACtB,OAAO,kBAAkB;KACvB,OACE;KACF,MAAM;IACR,CAAC;IAGH,OAAO,kBAAkB;KACvB,MAAM;KACN;KACA,OAAO,SAAS;KAChB,MAAM;IACR,CAAC;GACH;GAEA,OAAO,KAAK,uBAAuB,SAAS;GAC5C,MAAM,UAAU,MAAM,gBAAgB,OAAO;GAE7C,IAAI,CAAC,SAAS;IACZ,MAAM,oBAAoB,MAAM,iBAAiB;IACjD,OAAO,kBAAkB;KACvB,OAAO,sBAAsB;KAC7B;KACA,MAAM;IACR,CAAC;GACH;GAEA,OAAO,kBAAkB;IACvB,MAAM;IACN,MAAM;IACN;GACF,CAAC;EACH,SAAS,OAAO;GACd,OAAO,MAAM,+BAA+B,KAAK;GACjD,OAAO,kBAAkB;IACvB,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH;CACF;AACF"}

package/dist/tools/resources.js

@@ -42,7 +42,8 @@ function registerMarkdownResource(server, config) {
 	});
 }
 async function readDocResource(path) {
-	const mdx = await readMDXFileSafe(join(DOCS_PATH, `${sanitizePath(path)}${MDX_EXTENSION}`));
+	const sanitized = sanitizePath(path);
+	const mdx = await readMDXFileSafe(join(DOCS_PATH, `${sanitized}${MDX_EXTENSION}`));
 	return mdx ? formatMDXContent(mdx) : null;
 }
 function registerResources(server) {

package/dist/tools/resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources.js","names":[],"sources":["../../src/tools/resources.ts"],"sourcesContent":["import { type McpServer, ResourceTemplate } from \"@modelcontextprotocol/server\";\nimport { join } from \"node:path\";\nimport { DOCS_PATH, MDX_EXTENSION } from \"../constants.js\";\nimport { getAvailableDocFiles } from \"../utils/paths.js\";\nimport { readMDXFileSafe, formatMDXContent } from \"../utils/mdx.js\";\nimport { sanitizePath } from \"../utils/security.js\";\nimport { listCodeExamples, readCodeExample } from \"./examples.js\";\nimport { logger } from \"../utils/logger.js\";\n\nconst MARKDOWN_MIME_TYPE = \"text/markdown\";\nconst DOCS_SCHEME = \"aui-docs\";\nconst EXAMPLE_SCHEME = \"aui-example\";\n\nfunction templateVarToPath(value: string | string[] | undefined): string {\n  if (Array.isArray(value)) return value.join(\"/\");\n  return value ?? \"\";\n}\n\ninterface MarkdownResourceConfig {\n  name: string;\n  scheme: string;\n  variable: string;\n  title: string;\n  description: string;\n  notFoundLabel: string;\n  list: () => Promise<string[]>;\n  read: (key: string) => Promise<string | null>;\n}\n\nfunction registerMarkdownResource(\n  server: McpServer,\n  config: MarkdownResourceConfig,\n): void {\n  const {\n    name,\n    scheme,\n    variable,\n    title,\n    description,\n    notFoundLabel,\n    list,\n    read,\n  } = config;\n  server.registerResource(\n    name,\n    new ResourceTemplate(`${scheme}:///{+${variable}}`, {\n      list: async () => ({\n        resources: (await list()).map((key) => ({\n          uri: `${scheme}:///${key}`,\n          name: key,\n          mimeType: MARKDOWN_MIME_TYPE,\n        })),\n      }),\n      complete: {\n        [variable]: async (value) => {\n          const needle = value.toLowerCase();\n          return (await list()).filter((key) =>\n            key.toLowerCase().includes(needle),\n          );\n        },\n      },\n    }),\n    { title, description, mimeType: MARKDOWN_MIME_TYPE },\n    async (uri, variables) => {\n      const key = templateVarToPath(variables[variable]);\n      const text = await read(key);\n      if (text === null) {\n        throw new Error(`${notFoundLabel} not found: ${key}`);\n      }\n      return {\n        contents: [{ uri: uri.href, mimeType: MARKDOWN_MIME_TYPE, text }],\n      };\n    },\n  );\n}\n\nasync function readDocResource(path: string): Promise<string | null> {\n  const sanitized = sanitizePath(path);\n  const mdx = await readMDXFileSafe(\n    join(DOCS_PATH, `${sanitized}${MDX_EXTENSION}`),\n  );\n  return mdx ? formatMDXContent(mdx) : null;\n}\n\nexport function registerResources(server: McpServer): void {\n  registerMarkdownResource(server, {\n    name: \"assistant-ui-docs\",\n    scheme: DOCS_SCHEME,\n    variable: \"path\",\n    title: \"assistant-ui Documentation\",\n    description:\n      \"Individual assistant-ui documentation pages, readable as markdown by path.\",\n    notFoundLabel: \"Documentation\",\n    list: getAvailableDocFiles,\n    read: readDocResource,\n  });\n\n  registerMarkdownResource(server, {\n    name: \"assistant-ui-examples\",\n    scheme: EXAMPLE_SCHEME,\n    variable: \"name\",\n    title: \"assistant-ui Examples\",\n    description:\n      \"Complete assistant-ui example projects, readable as markdown.\",\n    notFoundLabel: \"Example\",\n    list: listCodeExamples,\n    read: readCodeExample,\n  });\n\n  logger.debug(\"Registered docs and examples resources\");\n}\n"],"mappings":";;;;;;;;;AASA,MAAM,qBAAqB;AAC3B,MAAM,cAAc;AACpB,MAAM,iBAAiB;AAEvB,SAAS,kBAAkB,OAA8C;CACvE,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,KAAK,GAAG;CAC/C,OAAO,SAAS;AAClB;AAaA,SAAS,yBACP,QACA,QACM;CACN,MAAM,EACJ,MACA,QACA,UACA,OACA,aACA,eACA,MACA,SACE;CACJ,OAAO,iBACL,MACA,IAAI,iBAAiB,GAAG,OAAO,QAAQ,SAAS,IAAI;EAClD,MAAM,aAAa,EACjB,YAAY,MAAM,KAAK,EAAA,CAAG,KAAK,SAAS;GACtC,KAAK,GAAG,OAAO,MAAM;GACrB,MAAM;GACN,UAAU;EACZ,EAAE,EACJ;EACA,UAAU,GACP,WAAW,OAAO,UAAU;GAC3B,MAAM,SAAS,MAAM,YAAY;GACjC,QAAQ,MAAM,KAAK,EAAA,CAAG,QAAQ,QAC5B,IAAI,YAAY,CAAC,CAAC,SAAS,MAAM,CACnC;EACF,EACF;CACF,CAAC,GACD;EAAE;EAAO;EAAa,UAAU;CAAmB,GACnD,OAAO,KAAK,cAAc;EACxB,MAAM,MAAM,kBAAkB,UAAU,SAAS;EACjD,MAAM,OAAO,MAAM,KAAK,GAAG;EAC3B,IAAI,SAAS,MACX,MAAM,IAAI,MAAM,GAAG,cAAc,cAAc,KAAK;EAEtD,OAAO,EACL,UAAU,CAAC;GAAE,KAAK,IAAI;GAAM,UAAU;GAAoB;EAAK,CAAC,EAClE;CACF,CACF;AACF;AAEA,eAAe,gBAAgB,MAAsC;CAEnE,MAAM,MAAM,MAAM,gBAChB,KAAK,WAAW,GAFA,aAAa,IAEF,IAAI,eAAe,CAChD;CACA,OAAO,MAAM,iBAAiB,GAAG,IAAI;AACvC;AAEA,SAAgB,kBAAkB,QAAyB;CACzD,yBAAyB,QAAQ;EAC/B,MAAM;EACN,QAAQ;EACR,UAAU;EACV,OAAO;EACP,aACE;EACF,eAAe;EACf,MAAM;EACN,MAAM;CACR,CAAC;CAED,yBAAyB,QAAQ;EAC/B,MAAM;EACN,QAAQ;EACR,UAAU;EACV,OAAO;EACP,aACE;EACF,eAAe;EACf,MAAM;EACN,MAAM;CACR,CAAC;CAED,OAAO,MAAM,wCAAwC;AACvD"}
+{"version":3,"file":"resources.js","names":[],"sources":["../../src/tools/resources.ts"],"sourcesContent":["import { type McpServer, ResourceTemplate } from \"@modelcontextprotocol/server\";\nimport { join } from \"node:path\";\nimport { DOCS_PATH, MDX_EXTENSION } from \"../constants.js\";\nimport { getAvailableDocFiles } from \"../utils/paths.js\";\nimport { readMDXFileSafe, formatMDXContent } from \"../utils/mdx.js\";\nimport { sanitizePath } from \"../utils/security.js\";\nimport { listCodeExamples, readCodeExample } from \"./examples.js\";\nimport { logger } from \"../utils/logger.js\";\n\nconst MARKDOWN_MIME_TYPE = \"text/markdown\";\nconst DOCS_SCHEME = \"aui-docs\";\nconst EXAMPLE_SCHEME = \"aui-example\";\n\nfunction templateVarToPath(value: string | string[] | undefined): string {\n  if (Array.isArray(value)) return value.join(\"/\");\n  return value ?? \"\";\n}\n\ninterface MarkdownResourceConfig {\n  name: string;\n  scheme: string;\n  variable: string;\n  title: string;\n  description: string;\n  notFoundLabel: string;\n  list: () => Promise<string[]>;\n  read: (key: string) => Promise<string | null>;\n}\n\nfunction registerMarkdownResource(\n  server: McpServer,\n  config: MarkdownResourceConfig,\n): void {\n  const {\n    name,\n    scheme,\n    variable,\n    title,\n    description,\n    notFoundLabel,\n    list,\n    read,\n  } = config;\n  server.registerResource(\n    name,\n    new ResourceTemplate(`${scheme}:///{+${variable}}`, {\n      list: async () => ({\n        resources: (await list()).map((key) => ({\n          uri: `${scheme}:///${key}`,\n          name: key,\n          mimeType: MARKDOWN_MIME_TYPE,\n        })),\n      }),\n      complete: {\n        [variable]: async (value) => {\n          const needle = value.toLowerCase();\n          return (await list()).filter((key) =>\n            key.toLowerCase().includes(needle),\n          );\n        },\n      },\n    }),\n    { title, description, mimeType: MARKDOWN_MIME_TYPE },\n    async (uri, variables) => {\n      const key = templateVarToPath(variables[variable]);\n      const text = await read(key);\n      if (text === null) {\n        throw new Error(`${notFoundLabel} not found: ${key}`);\n      }\n      return {\n        contents: [{ uri: uri.href, mimeType: MARKDOWN_MIME_TYPE, text }],\n      };\n    },\n  );\n}\n\nasync function readDocResource(path: string): Promise<string | null> {\n  const sanitized = sanitizePath(path);\n  const mdx = await readMDXFileSafe(\n    join(DOCS_PATH, `${sanitized}${MDX_EXTENSION}`),\n  );\n  return mdx ? formatMDXContent(mdx) : null;\n}\n\nexport function registerResources(server: McpServer): void {\n  registerMarkdownResource(server, {\n    name: \"assistant-ui-docs\",\n    scheme: DOCS_SCHEME,\n    variable: \"path\",\n    title: \"assistant-ui Documentation\",\n    description:\n      \"Individual assistant-ui documentation pages, readable as markdown by path.\",\n    notFoundLabel: \"Documentation\",\n    list: getAvailableDocFiles,\n    read: readDocResource,\n  });\n\n  registerMarkdownResource(server, {\n    name: \"assistant-ui-examples\",\n    scheme: EXAMPLE_SCHEME,\n    variable: \"name\",\n    title: \"assistant-ui Examples\",\n    description:\n      \"Complete assistant-ui example projects, readable as markdown.\",\n    notFoundLabel: \"Example\",\n    list: listCodeExamples,\n    read: readCodeExample,\n  });\n\n  logger.debug(\"Registered docs and examples resources\");\n}\n"],"mappings":";;;;;;;;;AASA,MAAM,qBAAqB;AAC3B,MAAM,cAAc;AACpB,MAAM,iBAAiB;AAEvB,SAAS,kBAAkB,OAA8C;CACvE,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,KAAK,GAAG;CAC/C,OAAO,SAAS;AAClB;AAaA,SAAS,yBACP,QACA,QACM;CACN,MAAM,EACJ,MACA,QACA,UACA,OACA,aACA,eACA,MACA,SACE;CACJ,OAAO,iBACL,MACA,IAAI,iBAAiB,GAAG,OAAO,QAAQ,SAAS,IAAI;EAClD,MAAM,aAAa,EACjB,YAAY,MAAM,KAAK,EAAA,CAAG,KAAK,SAAS;GACtC,KAAK,GAAG,OAAO,MAAM;GACrB,MAAM;GACN,UAAU;EACZ,EAAE,EACJ;EACA,UAAU,GACP,WAAW,OAAO,UAAU;GAC3B,MAAM,SAAS,MAAM,YAAY;GACjC,QAAQ,MAAM,KAAK,EAAA,CAAG,QAAQ,QAC5B,IAAI,YAAY,CAAC,CAAC,SAAS,MAAM,CACnC;EACF,EACF;CACF,CAAC,GACD;EAAE;EAAO;EAAa,UAAU;CAAmB,GACnD,OAAO,KAAK,cAAc;EACxB,MAAM,MAAM,kBAAkB,UAAU,SAAS;EACjD,MAAM,OAAO,MAAM,KAAK,GAAG;EAC3B,IAAI,SAAS,MACX,MAAM,IAAI,MAAM,GAAG,cAAc,cAAc,KAAK;EAEtD,OAAO,EACL,UAAU,CAAC;GAAE,KAAK,IAAI;GAAM,UAAU;GAAoB;EAAK,CAAC,EAClE;CACF,CACF;AACF;AAEA,eAAe,gBAAgB,MAAsC;CACnE,MAAM,YAAY,aAAa,IAAI;CACnC,MAAM,MAAM,MAAM,gBAChB,KAAK,WAAW,GAAG,YAAY,eAAe,CAChD;CACA,OAAO,MAAM,iBAAiB,GAAG,IAAI;AACvC;AAEA,SAAgB,kBAAkB,QAAyB;CACzD,yBAAyB,QAAQ;EAC/B,MAAM;EACN,QAAQ;EACR,UAAU;EACV,OAAO;EACP,aACE;EACF,eAAe;EACf,MAAM;EACN,MAAM;CACR,CAAC;CAED,yBAAyB,QAAQ;EAC/B,MAAM;EACN,QAAQ;EACR,UAAU;EACV,OAAO;EACP,aACE;EACF,eAAe;EACf,MAAM;EACN,MAAM;CACR,CAAC;CAED,OAAO,MAAM,wCAAwC;AACvD"}

package/dist/tools/tests/test-setup.js

@@ -27,7 +27,8 @@ const testContext = { callTool: async (name, args) => {
 	}
 } };
 beforeAll(() => {
-	if (!existsSync(join(PACKAGE_DIR, ".docs"))) throw new Error("Documentation not prepared. Run: pnpm build");
+	const docsPath = join(PACKAGE_DIR, ".docs");
+	if (!existsSync(docsPath)) throw new Error("Documentation not prepared. Run: pnpm build");
 });
 //#endregion
 export { testContext };

package/dist/tools/tests/test-setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-setup.js","names":[],"sources":["../../../src/tools/tests/test-setup.ts"],"sourcesContent":["import { beforeAll } from \"vitest\";\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { PACKAGE_DIR } from \"../../constants.js\";\nimport { docsTools } from \"../docs.js\";\nimport { examplesTools } from \"../examples.js\";\nimport { searchTools } from \"../search.js\";\nimport {\n  xuluxTemplatesListTool,\n  xuluxTemplateDetailsTool,\n  xuluxTemplatePreviewTool,\n} from \"../xulux-templates.js\";\n\nconst tools = {\n  assistantUIDocs: docsTools,\n  assistantUIExamples: examplesTools,\n  assistantUISearch: searchTools,\n  assistantUITemplates: xuluxTemplatesListTool,\n  assistantUITemplateDetails: xuluxTemplateDetailsTool,\n  assistantUITemplatePreview: xuluxTemplatePreviewTool,\n};\n\nexport const testContext = {\n  callTool: async (name: string, args: any) => {\n    const tool = tools[name as keyof typeof tools];\n    if (!tool) {\n      throw new Error(`Tool ${name} not found`);\n    }\n    const result = await tool.execute(args);\n\n    const text = result.content?.[0]?.text;\n    if (text === undefined) {\n      throw new Error(`Tool ${name} returned no content`);\n    }\n    try {\n      return JSON.parse(text);\n    } catch (error) {\n      throw new Error(\n        `Tool ${name} returned invalid JSON. Output: ${text}\\nParse error: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  },\n};\n\nbeforeAll(() => {\n  const docsPath = join(PACKAGE_DIR, \".docs\");\n  if (!existsSync(docsPath)) {\n    throw new Error(\"Documentation not prepared. Run: pnpm build\");\n  }\n});\n"],"mappings":";;;;;;;;;AAaA,MAAM,QAAQ;CACZ,iBAAiB;CACjB,qBAAqB;CACrB,mBAAmB;CACnB,sBAAsB;CACtB,4BAA4B;CAC5B,4BAA4B;AAC9B;AAEA,MAAa,cAAc,EACzB,UAAU,OAAO,MAAc,SAAc;CAC3C,MAAM,OAAO,MAAM;CACnB,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,QAAQ,KAAK,WAAW;CAI1C,MAAM,QAAO,MAFQ,KAAK,QAAQ,IAAI,EAAA,CAElB,UAAU,EAAE,EAAE;CAClC,IAAI,SAAS,KAAA,GACX,MAAM,IAAI,MAAM,QAAQ,KAAK,qBAAqB;CAEpD,IAAI;EACF,OAAO,KAAK,MAAM,IAAI;CACxB,SAAS,OAAO;EACd,MAAM,IAAI,MACR,QAAQ,KAAK,kCAAkC,KAAK,iBAAiB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAC5H;CACF;AACF,EACF;AAEA,gBAAgB;CAEd,IAAI,CAAC,WADY,KAAK,aAAa,OACZ,CAAC,GACtB,MAAM,IAAI,MAAM,6CAA6C;AAEjE,CAAC"}
+{"version":3,"file":"test-setup.js","names":[],"sources":["../../../src/tools/tests/test-setup.ts"],"sourcesContent":["import { beforeAll } from \"vitest\";\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { PACKAGE_DIR } from \"../../constants.js\";\nimport { docsTools } from \"../docs.js\";\nimport { examplesTools } from \"../examples.js\";\nimport { searchTools } from \"../search.js\";\nimport {\n  xuluxTemplatesListTool,\n  xuluxTemplateDetailsTool,\n  xuluxTemplatePreviewTool,\n} from \"../xulux-templates.js\";\n\nconst tools = {\n  assistantUIDocs: docsTools,\n  assistantUIExamples: examplesTools,\n  assistantUISearch: searchTools,\n  assistantUITemplates: xuluxTemplatesListTool,\n  assistantUITemplateDetails: xuluxTemplateDetailsTool,\n  assistantUITemplatePreview: xuluxTemplatePreviewTool,\n};\n\nexport const testContext = {\n  callTool: async (name: string, args: any) => {\n    const tool = tools[name as keyof typeof tools];\n    if (!tool) {\n      throw new Error(`Tool ${name} not found`);\n    }\n    const result = await tool.execute(args);\n\n    const text = result.content?.[0]?.text;\n    if (text === undefined) {\n      throw new Error(`Tool ${name} returned no content`);\n    }\n    try {\n      return JSON.parse(text);\n    } catch (error) {\n      throw new Error(\n        `Tool ${name} returned invalid JSON. Output: ${text}\\nParse error: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  },\n};\n\nbeforeAll(() => {\n  const docsPath = join(PACKAGE_DIR, \".docs\");\n  if (!existsSync(docsPath)) {\n    throw new Error(\"Documentation not prepared. Run: pnpm build\");\n  }\n});\n"],"mappings":";;;;;;;;;AAaA,MAAM,QAAQ;CACZ,iBAAiB;CACjB,qBAAqB;CACrB,mBAAmB;CACnB,sBAAsB;CACtB,4BAA4B;CAC5B,4BAA4B;AAC9B;AAEA,MAAa,cAAc,EACzB,UAAU,OAAO,MAAc,SAAc;CAC3C,MAAM,OAAO,MAAM;CACnB,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,QAAQ,KAAK,WAAW;CAI1C,MAAM,QAAO,MAFQ,KAAK,QAAQ,IAAI,EAAA,CAElB,UAAU,EAAE,EAAE;CAClC,IAAI,SAAS,KAAA,GACX,MAAM,IAAI,MAAM,QAAQ,KAAK,qBAAqB;CAEpD,IAAI;EACF,OAAO,KAAK,MAAM,IAAI;CACxB,SAAS,OAAO;EACd,MAAM,IAAI,MACR,QAAQ,KAAK,kCAAkC,KAAK,iBAAiB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAC5H;CACF;AACF,EACF;AAEA,gBAAgB;CACd,MAAM,WAAW,KAAK,aAAa,OAAO;CAC1C,IAAI,CAAC,WAAW,QAAQ,GACtB,MAAM,IAAI,MAAM,6CAA6C;AAEjE,CAAC"}

package/dist/tools/xulux-templates.js

@@ -48,7 +48,8 @@ const xuluxTemplateDetailsTool = {
 		logger.info(`Getting assistant-ui template details for: ${args.templateId}`);
 		try {
 			const { catalog, degraded, degradedReason } = await getXuluxCatalog();
-			return formatMCPResponse(withDegradedNote(await getTemplateDetails(catalog, args), degraded, degradedReason));
+			const details = await getTemplateDetails(catalog, args);
+			return formatMCPResponse(withDegradedNote(details, degraded, degradedReason));
 		} catch (error) {
 			logger.error("Failed to get assistant-ui template details", error);
 			return formatMCPResponse({
@@ -66,7 +67,8 @@ const xuluxTemplatePreviewTool = {
 		logger.info(`Creating assistant-ui template preview for: ${args.templateId}`);
 		try {
 			const { catalog, degraded, degradedReason } = await getXuluxCatalog();
-			return formatMCPResponse(withDegradedNote(await createTemplatePreview(catalog, args), degraded, degradedReason));
+			const result = await createTemplatePreview(catalog, args);
+			return formatMCPResponse(withDegradedNote(result, degraded, degradedReason));
 		} catch (error) {
 			logger.error("Failed to create assistant-ui template preview", error);
 			return formatMCPResponse({

package/dist/tools/xulux-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"xulux-templates.js","names":[],"sources":["../../src/tools/xulux-templates.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { logger } from \"../utils/logger.js\";\nimport { formatMCPResponse } from \"../utils/mcp-format.js\";\nimport { getXuluxCatalog } from \"../xulux/catalog-client.js\";\nimport {\n  createTemplatePreview,\n  getTemplateDetails,\n  listTemplates,\n} from \"../xulux/template-service.js\";\n\nconst emptyInputSchema = z.object({});\n\nconst detailsInputSchema = z.object({\n  templateId: z.string().describe(\"The template id from assistantUITemplates\"),\n  versionId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional version id. When provided, exampleConfig reflects that version's resolved defaults.\",\n    ),\n});\n\nconst previewInputSchema = z.object({\n  templateId: z.string().describe(\"The template id from assistantUITemplates\"),\n  versionId: z\n    .string()\n    .optional()\n    .describe(\"Version id to use. Uses the template default if omitted.\"),\n  config: z\n    .record(z.string(), z.unknown())\n    .optional()\n    .describe(\n      \"Customization config for the preview. Must contain only the top-level keys: hostUi, assistant, and brandTheme. \" +\n        \"Use the schemas from assistantUITemplateDetails.configRoots as the source of truth for each root. \" +\n        \"Do not pass any other root keys.\",\n    ),\n});\n\nfunction withDegradedNote<T extends Record<string, unknown>>(\n  payload: T,\n  degraded: boolean,\n  degradedReason?: string,\n): T & { catalogDegraded?: true; catalogDegradedReason?: string } {\n  if (!degraded) return payload;\n  return {\n    ...payload,\n    catalogDegraded: true,\n    ...(degradedReason ? { catalogDegradedReason: degradedReason } : {}),\n  };\n}\n\nexport const xuluxTemplatesListTool = {\n  name: \"assistantUITemplates\",\n  description:\n    \"List the available assistant-ui hosted app templates and fixed demos with their features, customizable surfaces, and versions. \" +\n    \"Call this first for any assistant-ui app-building request. Use the features and customizable fields to decide which template fits. \" +\n    \"If customizable is empty, the entry is a fixed demo that should be used as-is rather than configured. \" +\n    \"Call assistantUITemplateDetails on the chosen template before requesting a preview.\",\n  parameters: emptyInputSchema,\n  execute: async (_args: z.infer<typeof emptyInputSchema>) => {\n    logger.info(\"Listing assistant-ui templates\");\n    try {\n      const { catalog, degraded, degradedReason } = await getXuluxCatalog();\n      return formatMCPResponse(\n        withDegradedNote(listTemplates(catalog), degraded, degradedReason),\n      );\n    } catch (error) {\n      logger.error(\"Failed to list assistant-ui templates\", error);\n      return formatMCPResponse({\n        error: \"Failed to list assistant-ui templates\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n\nexport const xuluxTemplateDetailsTool = {\n  name: \"assistantUITemplateDetails\",\n  description:\n    \"Get the full authoring surface for a specific assistant-ui hosted template. \" +\n    \"Returns configRoots schemas (with types, defaults, and enums), rules, built-in tool input/outputShape, renderer contracts, and an exampleConfig. \" +\n    \"Fixed demos return no configRoots; use those as-is without config. \" +\n    \"Use this before calling assistantUITemplatePreview to understand exactly what config to write. \" +\n    \"If assistantUITemplatePreview returns validationWarnings, call this again and cross-reference configRoots to correct the config.\",\n  parameters: detailsInputSchema,\n  execute: async (args: z.infer<typeof detailsInputSchema>) => {\n    logger.info(\n      `Getting assistant-ui template details for: ${args.templateId}`,\n    );\n    try {\n      const { catalog, degraded, degradedReason } = await getXuluxCatalog();\n      const details = await getTemplateDetails(catalog, args);\n      return formatMCPResponse(\n        withDegradedNote(\n          details as unknown as Record<string, unknown>,\n          degraded,\n          degradedReason,\n        ),\n      );\n    } catch (error) {\n      logger.error(\"Failed to get assistant-ui template details\", error);\n      return formatMCPResponse({\n        error: \"Failed to get assistant-ui template details\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n\nexport const xuluxTemplatePreviewTool = {\n  name: \"assistantUITemplatePreview\",\n  description:\n    \"Return preview and download URLs for a selected assistant-ui hosted template. \" +\n    \"The previewUrl is a hosted app URL; show it to the user first, or open it with an available browser/in-app-browser tool if your client provides one. \" +\n    \"If you pass config, a preview session is created on the hosted template sandbox and the returned URLs reflect that configuration. \" +\n    \"Do not pass config for fixed demos that have no configRoots in assistantUITemplateDetails. \" +\n    \"This tool only returns URLs.\",\n  parameters: previewInputSchema,\n  execute: async (args: z.infer<typeof previewInputSchema>) => {\n    logger.info(\n      `Creating assistant-ui template preview for: ${args.templateId}`,\n    );\n    try {\n      const { catalog, degraded, degradedReason } = await getXuluxCatalog();\n      const result = await createTemplatePreview(catalog, args);\n      return formatMCPResponse(\n        withDegradedNote(\n          result as unknown as Record<string, unknown>,\n          degraded,\n          degradedReason,\n        ),\n      );\n    } catch (error) {\n      logger.error(\"Failed to create assistant-ui template preview\", error);\n      return formatMCPResponse({\n        error: \"Failed to create assistant-ui template preview\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n"],"mappings":";;;;;;AAUA,MAAM,mBAAmB,EAAE,OAAO,CAAC,CAAC;AAEpC,MAAM,qBAAqB,EAAE,OAAO;CAClC,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,2CAA2C;CAC3E,WAAW,EACR,OAAO,CAAC,CACR,SAAS,CAAC,CACV,SACC,8FACF;AACJ,CAAC;AAED,MAAM,qBAAqB,EAAE,OAAO;CAClC,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,2CAA2C;CAC3E,WAAW,EACR,OAAO,CAAC,CACR,SAAS,CAAC,CACV,SAAS,0DAA0D;CACtE,QAAQ,EACL,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAC/B,SAAS,CAAC,CACV,SACC,mPAGF;AACJ,CAAC;AAED,SAAS,iBACP,SACA,UACA,gBACgE;CAChE,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO;EACL,GAAG;EACH,iBAAiB;EACjB,GAAI,iBAAiB,EAAE,uBAAuB,eAAe,IAAI,CAAC;CACpE;AACF;AAEA,MAAa,yBAAyB;CACpC,MAAM;CACN,aACE;CAIF,YAAY;CACZ,SAAS,OAAO,UAA4C;EAC1D,OAAO,KAAK,gCAAgC;EAC5C,IAAI;GACF,MAAM,EAAE,SAAS,UAAU,mBAAmB,MAAM,gBAAgB;GACpE,OAAO,kBACL,iBAAiB,cAAc,OAAO,GAAG,UAAU,cAAc,CACnE;EACF,SAAS,OAAO;GACd,OAAO,MAAM,yCAAyC,KAAK;GAC3D,OAAO,kBAAkB;IACvB,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH;CACF;AACF;AAEA,MAAa,2BAA2B;CACtC,MAAM;CACN,aACE;CAKF,YAAY;CACZ,SAAS,OAAO,SAA6C;EAC3D,OAAO,KACL,8CAA8C,KAAK,YACrD;EACA,IAAI;GACF,MAAM,EAAE,SAAS,UAAU,mBAAmB,MAAM,gBAAgB;GAEpE,OAAO,kBACL,iBACE,MAHkB,mBAAmB,SAAS,IAAI,GAIlD,UACA,cACF,CACF;EACF,SAAS,OAAO;GACd,OAAO,MAAM,+CAA+C,KAAK;GACjE,OAAO,kBAAkB;IACvB,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH;CACF;AACF;AAEA,MAAa,2BAA2B;CACtC,MAAM;CACN,aACE;CAKF,YAAY;CACZ,SAAS,OAAO,SAA6C;EAC3D,OAAO,KACL,+CAA+C,KAAK,YACtD;EACA,IAAI;GACF,MAAM,EAAE,SAAS,UAAU,mBAAmB,MAAM,gBAAgB;GAEpE,OAAO,kBACL,iBACE,MAHiB,sBAAsB,SAAS,IAAI,GAIpD,UACA,cACF,CACF;EACF,SAAS,OAAO;GACd,OAAO,MAAM,kDAAkD,KAAK;GACpE,OAAO,kBAAkB;IACvB,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH;CACF;AACF"}
+{"version":3,"file":"xulux-templates.js","names":[],"sources":["../../src/tools/xulux-templates.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { logger } from \"../utils/logger.js\";\nimport { formatMCPResponse } from \"../utils/mcp-format.js\";\nimport { getXuluxCatalog } from \"../xulux/catalog-client.js\";\nimport {\n  createTemplatePreview,\n  getTemplateDetails,\n  listTemplates,\n} from \"../xulux/template-service.js\";\n\nconst emptyInputSchema = z.object({});\n\nconst detailsInputSchema = z.object({\n  templateId: z.string().describe(\"The template id from assistantUITemplates\"),\n  versionId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional version id. When provided, exampleConfig reflects that version's resolved defaults.\",\n    ),\n});\n\nconst previewInputSchema = z.object({\n  templateId: z.string().describe(\"The template id from assistantUITemplates\"),\n  versionId: z\n    .string()\n    .optional()\n    .describe(\"Version id to use. Uses the template default if omitted.\"),\n  config: z\n    .record(z.string(), z.unknown())\n    .optional()\n    .describe(\n      \"Customization config for the preview. Must contain only the top-level keys: hostUi, assistant, and brandTheme. \" +\n        \"Use the schemas from assistantUITemplateDetails.configRoots as the source of truth for each root. \" +\n        \"Do not pass any other root keys.\",\n    ),\n});\n\nfunction withDegradedNote<T extends Record<string, unknown>>(\n  payload: T,\n  degraded: boolean,\n  degradedReason?: string,\n): T & { catalogDegraded?: true; catalogDegradedReason?: string } {\n  if (!degraded) return payload;\n  return {\n    ...payload,\n    catalogDegraded: true,\n    ...(degradedReason ? { catalogDegradedReason: degradedReason } : {}),\n  };\n}\n\nexport const xuluxTemplatesListTool = {\n  name: \"assistantUITemplates\",\n  description:\n    \"List the available assistant-ui hosted app templates and fixed demos with their features, customizable surfaces, and versions. \" +\n    \"Call this first for any assistant-ui app-building request. Use the features and customizable fields to decide which template fits. \" +\n    \"If customizable is empty, the entry is a fixed demo that should be used as-is rather than configured. \" +\n    \"Call assistantUITemplateDetails on the chosen template before requesting a preview.\",\n  parameters: emptyInputSchema,\n  execute: async (_args: z.infer<typeof emptyInputSchema>) => {\n    logger.info(\"Listing assistant-ui templates\");\n    try {\n      const { catalog, degraded, degradedReason } = await getXuluxCatalog();\n      return formatMCPResponse(\n        withDegradedNote(listTemplates(catalog), degraded, degradedReason),\n      );\n    } catch (error) {\n      logger.error(\"Failed to list assistant-ui templates\", error);\n      return formatMCPResponse({\n        error: \"Failed to list assistant-ui templates\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n\nexport const xuluxTemplateDetailsTool = {\n  name: \"assistantUITemplateDetails\",\n  description:\n    \"Get the full authoring surface for a specific assistant-ui hosted template. \" +\n    \"Returns configRoots schemas (with types, defaults, and enums), rules, built-in tool input/outputShape, renderer contracts, and an exampleConfig. \" +\n    \"Fixed demos return no configRoots; use those as-is without config. \" +\n    \"Use this before calling assistantUITemplatePreview to understand exactly what config to write. \" +\n    \"If assistantUITemplatePreview returns validationWarnings, call this again and cross-reference configRoots to correct the config.\",\n  parameters: detailsInputSchema,\n  execute: async (args: z.infer<typeof detailsInputSchema>) => {\n    logger.info(\n      `Getting assistant-ui template details for: ${args.templateId}`,\n    );\n    try {\n      const { catalog, degraded, degradedReason } = await getXuluxCatalog();\n      const details = await getTemplateDetails(catalog, args);\n      return formatMCPResponse(\n        withDegradedNote(\n          details as unknown as Record<string, unknown>,\n          degraded,\n          degradedReason,\n        ),\n      );\n    } catch (error) {\n      logger.error(\"Failed to get assistant-ui template details\", error);\n      return formatMCPResponse({\n        error: \"Failed to get assistant-ui template details\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n\nexport const xuluxTemplatePreviewTool = {\n  name: \"assistantUITemplatePreview\",\n  description:\n    \"Return preview and download URLs for a selected assistant-ui hosted template. \" +\n    \"The previewUrl is a hosted app URL; show it to the user first, or open it with an available browser/in-app-browser tool if your client provides one. \" +\n    \"If you pass config, a preview session is created on the hosted template sandbox and the returned URLs reflect that configuration. \" +\n    \"Do not pass config for fixed demos that have no configRoots in assistantUITemplateDetails. \" +\n    \"This tool only returns URLs.\",\n  parameters: previewInputSchema,\n  execute: async (args: z.infer<typeof previewInputSchema>) => {\n    logger.info(\n      `Creating assistant-ui template preview for: ${args.templateId}`,\n    );\n    try {\n      const { catalog, degraded, degradedReason } = await getXuluxCatalog();\n      const result = await createTemplatePreview(catalog, args);\n      return formatMCPResponse(\n        withDegradedNote(\n          result as unknown as Record<string, unknown>,\n          degraded,\n          degradedReason,\n        ),\n      );\n    } catch (error) {\n      logger.error(\"Failed to create assistant-ui template preview\", error);\n      return formatMCPResponse({\n        error: \"Failed to create assistant-ui template preview\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n"],"mappings":";;;;;;AAUA,MAAM,mBAAmB,EAAE,OAAO,CAAC,CAAC;AAEpC,MAAM,qBAAqB,EAAE,OAAO;CAClC,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,2CAA2C;CAC3E,WAAW,EACR,OAAO,CAAC,CACR,SAAS,CAAC,CACV,SACC,8FACF;AACJ,CAAC;AAED,MAAM,qBAAqB,EAAE,OAAO;CAClC,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,2CAA2C;CAC3E,WAAW,EACR,OAAO,CAAC,CACR,SAAS,CAAC,CACV,SAAS,0DAA0D;CACtE,QAAQ,EACL,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAC/B,SAAS,CAAC,CACV,SACC,mPAGF;AACJ,CAAC;AAED,SAAS,iBACP,SACA,UACA,gBACgE;CAChE,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO;EACL,GAAG;EACH,iBAAiB;EACjB,GAAI,iBAAiB,EAAE,uBAAuB,eAAe,IAAI,CAAC;CACpE;AACF;AAEA,MAAa,yBAAyB;CACpC,MAAM;CACN,aACE;CAIF,YAAY;CACZ,SAAS,OAAO,UAA4C;EAC1D,OAAO,KAAK,gCAAgC;EAC5C,IAAI;GACF,MAAM,EAAE,SAAS,UAAU,mBAAmB,MAAM,gBAAgB;GACpE,OAAO,kBACL,iBAAiB,cAAc,OAAO,GAAG,UAAU,cAAc,CACnE;EACF,SAAS,OAAO;GACd,OAAO,MAAM,yCAAyC,KAAK;GAC3D,OAAO,kBAAkB;IACvB,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH;CACF;AACF;AAEA,MAAa,2BAA2B;CACtC,MAAM;CACN,aACE;CAKF,YAAY;CACZ,SAAS,OAAO,SAA6C;EAC3D,OAAO,KACL,8CAA8C,KAAK,YACrD;EACA,IAAI;GACF,MAAM,EAAE,SAAS,UAAU,mBAAmB,MAAM,gBAAgB;GACpE,MAAM,UAAU,MAAM,mBAAmB,SAAS,IAAI;GACtD,OAAO,kBACL,iBACE,SACA,UACA,cACF,CACF;EACF,SAAS,OAAO;GACd,OAAO,MAAM,+CAA+C,KAAK;GACjE,OAAO,kBAAkB;IACvB,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH;CACF;AACF;AAEA,MAAa,2BAA2B;CACtC,MAAM;CACN,aACE;CAKF,YAAY;CACZ,SAAS,OAAO,SAA6C;EAC3D,OAAO,KACL,+CAA+C,KAAK,YACtD;EACA,IAAI;GACF,MAAM,EAAE,SAAS,UAAU,mBAAmB,MAAM,gBAAgB;GACpE,MAAM,SAAS,MAAM,sBAAsB,SAAS,IAAI;GACxD,OAAO,kBACL,iBACE,QACA,UACA,cACF,CACF;EACF,SAAS,OAAO;GACd,OAAO,MAAM,kDAAkD,KAAK;GACpE,OAAO,kBAAkB;IACvB,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH;CACF;AACF"}

package/dist/utils/mdx.js

@@ -5,7 +5,8 @@ import matter from "gray-matter";
 //#region src/utils/mdx.ts
 async function readMDXFile(filePath) {
 	try {
-		const { content, data } = matter(await readFile(filePath, "utf-8"));
+		const fileContent = await readFile(filePath, "utf-8");
+		const { content, data } = matter(fileContent);
 		const excerptMatch = content.match(/^(.+?)(?:\n\n|$)/);
 		const excerpt = excerptMatch?.[1] !== void 0 ? excerptMatch[1].replace(/^#+ /, "") : void 0;
 		return {

package/dist/utils/mdx.js.map

@@ -1 +1 @@
-{"version":3,"file":"mdx.js","names":[],"sources":["../../src/utils/mdx.ts"],"sourcesContent":["import { readFile, lstat } from \"node:fs/promises\";\nimport matter from \"gray-matter\";\nimport { MAX_FILE_SIZE } from \"../constants.js\";\nimport { logger } from \"./logger.js\";\n\ninterface MDXContent {\n  content: string;\n  frontmatter: Record<string, any>;\n  excerpt?: string;\n}\n\nexport async function readMDXFile(\n  filePath: string,\n): Promise<MDXContent | null> {\n  try {\n    const fileContent = await readFile(filePath, \"utf-8\");\n    const { content, data } = matter(fileContent);\n\n    const excerptMatch = content.match(/^(.+?)(?:\\n\\n|$)/);\n    const excerpt =\n      excerptMatch?.[1] !== undefined\n        ? excerptMatch[1].replace(/^#+ /, \"\")\n        : undefined;\n\n    return {\n      content,\n      frontmatter: data,\n      ...(excerpt !== undefined && { excerpt }),\n    };\n  } catch (error) {\n    logger.error(`Failed to read MDX file: ${filePath}`, error);\n    return null;\n  }\n}\n\nexport async function readMDXFileSafe(\n  filePath: string,\n): Promise<MDXContent | null> {\n  try {\n    const stats = await lstat(filePath);\n    if (stats.isSymbolicLink()) {\n      logger.warn(`Attempted to read symlink: ${filePath}`);\n      return null;\n    }\n    if (stats.size > MAX_FILE_SIZE) {\n      logger.warn(`File size exceeds limit: ${filePath} (${stats.size} bytes)`);\n      return null;\n    }\n  } catch {\n    return null;\n  }\n  return readMDXFile(filePath);\n}\n\nexport function formatMDXContent(mdxContent: MDXContent): string {\n  const { content, frontmatter } = mdxContent;\n\n  return matter.stringify(content, frontmatter);\n}\n"],"mappings":";;;;;AAWA,eAAsB,YACpB,UAC4B;CAC5B,IAAI;EAEF,MAAM,EAAE,SAAS,SAAS,OAAO,MADP,SAAS,UAAU,OAAO,CACR;EAE5C,MAAM,eAAe,QAAQ,MAAM,kBAAkB;EACrD,MAAM,UACJ,eAAe,OAAO,KAAA,IAClB,aAAa,EAAE,CAAC,QAAQ,QAAQ,EAAE,IAClC,KAAA;EAEN,OAAO;GACL;GACA,aAAa;GACb,GAAI,YAAY,KAAA,KAAa,EAAE,QAAQ;EACzC;CACF,SAAS,OAAO;EACd,OAAO,MAAM,4BAA4B,YAAY,KAAK;EAC1D,OAAO;CACT;AACF;AAEA,eAAsB,gBACpB,UAC4B;CAC5B,IAAI;EACF,MAAM,QAAQ,MAAM,MAAM,QAAQ;EAClC,IAAI,MAAM,eAAe,GAAG;GAC1B,OAAO,KAAK,8BAA8B,UAAU;GACpD,OAAO;EACT;EACA,IAAI,MAAM,OAAA,UAAsB;GAC9B,OAAO,KAAK,4BAA4B,SAAS,IAAI,MAAM,KAAK,QAAQ;GACxE,OAAO;EACT;CACF,QAAQ;EACN,OAAO;CACT;CACA,OAAO,YAAY,QAAQ;AAC7B;AAEA,SAAgB,iBAAiB,YAAgC;CAC/D,MAAM,EAAE,SAAS,gBAAgB;CAEjC,OAAO,OAAO,UAAU,SAAS,WAAW;AAC9C"}
+{"version":3,"file":"mdx.js","names":[],"sources":["../../src/utils/mdx.ts"],"sourcesContent":["import { readFile, lstat } from \"node:fs/promises\";\nimport matter from \"gray-matter\";\nimport { MAX_FILE_SIZE } from \"../constants.js\";\nimport { logger } from \"./logger.js\";\n\ninterface MDXContent {\n  content: string;\n  frontmatter: Record<string, any>;\n  excerpt?: string;\n}\n\nexport async function readMDXFile(\n  filePath: string,\n): Promise<MDXContent | null> {\n  try {\n    const fileContent = await readFile(filePath, \"utf-8\");\n    const { content, data } = matter(fileContent);\n\n    const excerptMatch = content.match(/^(.+?)(?:\\n\\n|$)/);\n    const excerpt =\n      excerptMatch?.[1] !== undefined\n        ? excerptMatch[1].replace(/^#+ /, \"\")\n        : undefined;\n\n    return {\n      content,\n      frontmatter: data,\n      ...(excerpt !== undefined && { excerpt }),\n    };\n  } catch (error) {\n    logger.error(`Failed to read MDX file: ${filePath}`, error);\n    return null;\n  }\n}\n\nexport async function readMDXFileSafe(\n  filePath: string,\n): Promise<MDXContent | null> {\n  try {\n    const stats = await lstat(filePath);\n    if (stats.isSymbolicLink()) {\n      logger.warn(`Attempted to read symlink: ${filePath}`);\n      return null;\n    }\n    if (stats.size > MAX_FILE_SIZE) {\n      logger.warn(`File size exceeds limit: ${filePath} (${stats.size} bytes)`);\n      return null;\n    }\n  } catch {\n    return null;\n  }\n  return readMDXFile(filePath);\n}\n\nexport function formatMDXContent(mdxContent: MDXContent): string {\n  const { content, frontmatter } = mdxContent;\n\n  return matter.stringify(content, frontmatter);\n}\n"],"mappings":";;;;;AAWA,eAAsB,YACpB,UAC4B;CAC5B,IAAI;EACF,MAAM,cAAc,MAAM,SAAS,UAAU,OAAO;EACpD,MAAM,EAAE,SAAS,SAAS,OAAO,WAAW;EAE5C,MAAM,eAAe,QAAQ,MAAM,kBAAkB;EACrD,MAAM,UACJ,eAAe,OAAO,KAAA,IAClB,aAAa,EAAE,CAAC,QAAQ,QAAQ,EAAE,IAClC,KAAA;EAEN,OAAO;GACL;GACA,aAAa;GACb,GAAI,YAAY,KAAA,KAAa,EAAE,QAAQ;EACzC;CACF,SAAS,OAAO;EACd,OAAO,MAAM,4BAA4B,YAAY,KAAK;EAC1D,OAAO;CACT;AACF;AAEA,eAAsB,gBACpB,UAC4B;CAC5B,IAAI;EACF,MAAM,QAAQ,MAAM,MAAM,QAAQ;EAClC,IAAI,MAAM,eAAe,GAAG;GAC1B,OAAO,KAAK,8BAA8B,UAAU;GACpD,OAAO;EACT;EACA,IAAI,MAAM,OAAA,UAAsB;GAC9B,OAAO,KAAK,4BAA4B,SAAS,IAAI,MAAM,KAAK,QAAQ;GACxE,OAAO;EACT;CACF,QAAQ;EACN,OAAO;CACT;CACA,OAAO,YAAY,QAAQ;AAC7B;AAEA,SAAgB,iBAAiB,YAAgC;CAC/D,MAAM,EAAE,SAAS,gBAAgB;CAEjC,OAAO,OAAO,UAAU,SAAS,WAAW;AAC9C"}

package/dist/xulux/catalog-client.js

@@ -2,7 +2,7 @@ import { logger } from "../utils/logger.js";
 import { FALLBACK_CATALOG, FALLBACK_NOTE } from "./fallback-catalog.js";
 //#region src/xulux/catalog-client.ts
 const DEFAULT_CATALOG_URL = "https://www.assistant-ui.com/api/xulux/mcp-catalog";
-const CATALOG_TTL_MS = 300 * 1e3;
+const CATALOG_TTL_MS = 3e5;
 function getCatalogUrl() {
 	return process.env.XULUX_CATALOG_URL?.trim() || "https://www.assistant-ui.com/api/xulux/mcp-catalog";
 }