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

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { docsTools } from \"./tools/docs.js\";\nimport { examplesTools } from \"./tools/examples.js\";\nimport { searchTools } from \"./tools/search.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\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":";;;;;;;;;;;AAYA,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,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,OAAO,KAAK,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/code-examples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-examples.d.ts","names":[],"sources":["../../src/prepare-docs/code-examples.ts"],"mappings":";iBA2FsB,mBAAA,IAAuB,OAAO"}
+{"version":3,"file":"code-examples.d.ts","names":[],"sources":["../../src/prepare-docs/code-examples.ts"],"mappings":";iBA2FsB,uBAAuB"}

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

@@ -1 +1 @@
-{"version":3,"file":"code-examples.js","names":[],"sources":["../../src/prepare-docs/code-examples.ts"],"sourcesContent":["import { rm, mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join, relative, extname } from \"node:path\";\nimport { logger } from \"../utils/logger.js\";\nimport { ROOT_DIR, EXAMPLES_PATH } from \"../constants.js\";\n\nconst OUTPUT_DIR = join(\n  ROOT_DIR,\n  \"packages/mcp-docs-server/.docs/organized/code-examples\",\n);\nconst MAX_LINES = 10000;\n\ninterface FileContent {\n  path: string;\n  content: string;\n}\n\nasync function scanDirectory(\n  dir: string,\n  baseDir: string,\n): Promise<FileContent[]> {\n  const files: FileContent[] = [];\n\n  try {\n    const entries = await readdir(dir, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const fullPath = join(dir, entry.name);\n\n      if (entry.isDirectory()) {\n        const skipDirs = [\n          \"node_modules\",\n          \"dist\",\n          \"build\",\n          \".next\",\n          \".git\",\n          \".turbo\",\n        ];\n        if (!skipDirs.includes(entry.name)) {\n          const subFiles = await scanDirectory(fullPath, baseDir);\n          files.push(...subFiles);\n        }\n      } else if (entry.isFile()) {\n        const includeExts = [\n          \".ts\",\n          \".tsx\",\n          \".js\",\n          \".jsx\",\n          \".json\",\n          \".css\",\n          \".md\",\n          \".mdx\",\n        ];\n        const ext = extname(entry.name).toLowerCase();\n\n        if (\n          includeExts.includes(ext) ||\n          entry.name === \"package.json\" ||\n          entry.name === \"tsconfig.json\"\n        ) {\n          try {\n            const content = await readFile(fullPath, \"utf-8\");\n            const relativePath = relative(baseDir, fullPath);\n            files.push({ path: relativePath, content });\n          } catch (error) {\n            logger.warn(`Failed to read file: ${fullPath}`, error);\n          }\n        }\n      }\n    }\n  } catch (error) {\n    logger.error(`Failed to scan directory: ${dir}`, error);\n  }\n\n  return files;\n}\n\nfunction getFileType(filename: string): string {\n  const ext = extname(filename).toLowerCase();\n  const extMap: Record<string, string> = {\n    \".ts\": \"typescript\",\n    \".tsx\": \"tsx\",\n    \".js\": \"javascript\",\n    \".jsx\": \"jsx\",\n    \".json\": \"json\",\n    \".css\": \"css\",\n    \".md\": \"markdown\",\n    \".mdx\": \"mdx\",\n  };\n  return extMap[ext] || \"text\";\n}\n\nexport async function prepareCodeExamples(): Promise<void> {\n  logger.info(\"Preparing code examples...\");\n\n  try {\n    await rm(OUTPUT_DIR, { recursive: true, force: true });\n    await mkdir(OUTPUT_DIR, { recursive: true });\n\n    const exampleDirs = await readdir(EXAMPLES_PATH, { withFileTypes: true });\n\n    for (const dir of exampleDirs) {\n      if (dir.isDirectory() && !dir.name.startsWith(\".\")) {\n        const examplePath = join(EXAMPLES_PATH, dir.name);\n        logger.info(`Processing example: ${dir.name}`);\n\n        let description = \"\";\n        try {\n          const packageJsonPath = join(examplePath, \"package.json\");\n          const packageJson = JSON.parse(\n            await readFile(packageJsonPath, \"utf-8\"),\n          );\n          description = packageJson.description || \"\";\n        } catch (error: any) {\n          if (error?.code !== \"ENOENT\") {\n            logger.warn(`Failed to read package.json for ${dir.name}:`, error);\n          } else {\n            logger.debug(`No package.json found for example: ${dir.name}`);\n          }\n        }\n\n        const files = await scanDirectory(examplePath, examplePath);\n\n        files.sort((a, b) => a.path.localeCompare(b.path));\n\n        let markdown = `# Example: ${dir.name}\\n\\n`;\n        if (description) {\n          markdown += `${description}\\n\\n`;\n        }\n\n        let totalLines = 0;\n        for (const file of files) {\n          const lines = file.content.split(\"\\n\").length;\n          if (totalLines + lines > MAX_LINES) {\n            markdown += `\\n_Note: Additional files truncated due to size limits_\\n`;\n            break;\n          }\n\n          // Normalize Windows backslashes to forward slashes for consistent markdown output\n          markdown += `## ${file.path.replace(/\\\\/g, \"/\")}\\n\\n`;\n          markdown += `\\`\\`\\`${getFileType(file.path)}\\n`;\n          markdown += file.content;\n          markdown += `\\n\\`\\`\\`\\n\\n`;\n\n          totalLines += lines;\n        }\n\n        const outputPath = join(OUTPUT_DIR, `${dir.name}.md`);\n        await writeFile(outputPath, markdown, \"utf-8\");\n        logger.debug(`Created example: ${outputPath}`);\n      }\n    }\n\n    logger.info(\"Code examples preparation complete\");\n  } catch (error) {\n    logger.error(\"Failed to prepare code examples\", error);\n    throw error;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"code-examples.js","names":[],"sources":["../../src/prepare-docs/code-examples.ts"],"sourcesContent":["import { rm, mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join, relative, extname } from \"node:path\";\nimport { logger } from \"../utils/logger.js\";\nimport { ROOT_DIR, EXAMPLES_PATH } from \"../constants.js\";\n\nconst OUTPUT_DIR = join(\n  ROOT_DIR,\n  \"packages/mcp-docs-server/.docs/organized/code-examples\",\n);\nconst MAX_LINES = 10000;\n\ninterface FileContent {\n  path: string;\n  content: string;\n}\n\nasync function scanDirectory(\n  dir: string,\n  baseDir: string,\n): Promise<FileContent[]> {\n  const files: FileContent[] = [];\n\n  try {\n    const entries = await readdir(dir, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const fullPath = join(dir, entry.name);\n\n      if (entry.isDirectory()) {\n        const skipDirs = [\n          \"node_modules\",\n          \"dist\",\n          \"build\",\n          \".next\",\n          \".git\",\n          \".turbo\",\n        ];\n        if (!skipDirs.includes(entry.name)) {\n          const subFiles = await scanDirectory(fullPath, baseDir);\n          files.push(...subFiles);\n        }\n      } else if (entry.isFile()) {\n        const includeExts = [\n          \".ts\",\n          \".tsx\",\n          \".js\",\n          \".jsx\",\n          \".json\",\n          \".css\",\n          \".md\",\n          \".mdx\",\n        ];\n        const ext = extname(entry.name).toLowerCase();\n\n        if (\n          includeExts.includes(ext) ||\n          entry.name === \"package.json\" ||\n          entry.name === \"tsconfig.json\"\n        ) {\n          try {\n            const content = await readFile(fullPath, \"utf-8\");\n            const relativePath = relative(baseDir, fullPath);\n            files.push({ path: relativePath, content });\n          } catch (error) {\n            logger.warn(`Failed to read file: ${fullPath}`, error);\n          }\n        }\n      }\n    }\n  } catch (error) {\n    logger.error(`Failed to scan directory: ${dir}`, error);\n  }\n\n  return files;\n}\n\nfunction getFileType(filename: string): string {\n  const ext = extname(filename).toLowerCase();\n  const extMap: Record<string, string> = {\n    \".ts\": \"typescript\",\n    \".tsx\": \"tsx\",\n    \".js\": \"javascript\",\n    \".jsx\": \"jsx\",\n    \".json\": \"json\",\n    \".css\": \"css\",\n    \".md\": \"markdown\",\n    \".mdx\": \"mdx\",\n  };\n  return extMap[ext] || \"text\";\n}\n\nexport async function prepareCodeExamples(): Promise<void> {\n  logger.info(\"Preparing code examples...\");\n\n  try {\n    await rm(OUTPUT_DIR, { recursive: true, force: true });\n    await mkdir(OUTPUT_DIR, { recursive: true });\n\n    const exampleDirs = await readdir(EXAMPLES_PATH, { withFileTypes: true });\n\n    for (const dir of exampleDirs) {\n      if (dir.isDirectory() && !dir.name.startsWith(\".\")) {\n        const examplePath = join(EXAMPLES_PATH, dir.name);\n        logger.info(`Processing example: ${dir.name}`);\n\n        let description = \"\";\n        try {\n          const packageJsonPath = join(examplePath, \"package.json\");\n          const packageJson = JSON.parse(\n            await readFile(packageJsonPath, \"utf-8\"),\n          );\n          description = packageJson.description || \"\";\n        } catch (error: any) {\n          if (error?.code !== \"ENOENT\") {\n            logger.warn(`Failed to read package.json for ${dir.name}:`, error);\n          } else {\n            logger.debug(`No package.json found for example: ${dir.name}`);\n          }\n        }\n\n        const files = await scanDirectory(examplePath, examplePath);\n\n        files.sort((a, b) => a.path.localeCompare(b.path));\n\n        let markdown = `# Example: ${dir.name}\\n\\n`;\n        if (description) {\n          markdown += `${description}\\n\\n`;\n        }\n\n        let totalLines = 0;\n        for (const file of files) {\n          const lines = file.content.split(\"\\n\").length;\n          if (totalLines + lines > MAX_LINES) {\n            markdown += `\\n_Note: Additional files truncated due to size limits_\\n`;\n            break;\n          }\n\n          // Normalize Windows backslashes to forward slashes for consistent markdown output\n          markdown += `## ${file.path.replace(/\\\\/g, \"/\")}\\n\\n`;\n          markdown += `\\`\\`\\`${getFileType(file.path)}\\n`;\n          markdown += file.content;\n          markdown += `\\n\\`\\`\\`\\n\\n`;\n\n          totalLines += lines;\n        }\n\n        const outputPath = join(OUTPUT_DIR, `${dir.name}.md`);\n        await writeFile(outputPath, markdown, \"utf-8\");\n        logger.debug(`Created example: ${outputPath}`);\n      }\n    }\n\n    logger.info(\"Code examples preparation complete\");\n  } catch (error) {\n    logger.error(\"Failed to prepare code examples\", error);\n    throw error;\n  }\n}\n"],"mappings":"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"}

package/dist/prepare-docs/copy-raw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copy-raw.d.ts","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"mappings":";iBAiCsB,OAAA,IAAW,OAAO"}
+{"version":3,"file":"copy-raw.d.ts","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"mappings":";iBAiCsB,WAAW"}

package/dist/prepare-docs/prepare.d.ts

@@ -1 +1 @@
-export { };
+export {}

package/dist/prompts/xulux-playground.d.ts

@@ -0,0 +1,12 @@
+//#region src/prompts/xulux-playground.d.ts
+declare const XULUX_PLAYGROUND_PROMPT_NAME = "assistant-ui-template-workflow";
+declare const XULUX_PLAYGROUND_PROMPT_DESCRIPTION = "How to use the assistant-ui template tools to discover hosted templates, inspect their customization contracts, and retrieve preview/download URLs.";
+declare const XULUX_PLAYGROUND_PROMPT = "You have access to assistant-ui template tools for hosted app templates.\n\n<workflow>\nFollow this template-first workflow for any assistant-ui app-building request:\n\n1. Call **assistantUITemplates** FIRST. Never decide on a template or claim one exists without listing.\n2. Call **assistantUITemplateDetails** on any candidate template before deciding whether it fits.\n   - Review the whole template shape: features, assistantPlacement, configRoots schemas, rules, built-in tools, renderers, and exampleConfig.\n   - If `customizable` is empty, the entry is a fixed demo. Use it as-is; never pass a config for it.\n3. Decide one of three paths:\n   - The template fits as-is: call **assistantUITemplatePreview** with templateId and optional versionId.\n   - The template fits with supported customization: author a config using the configRoots schemas and rules from assistantUITemplateDetails, then call **assistantUITemplatePreview** with that config.\n   - No template fits: do NOT call assistantUITemplatePreview. Do not force the request into a template or fake domain content with mock config. Instead, ground yourself in the assistant-ui docs (assistantUIDocs, assistantUISearch, assistantUIExamples) and produce an honest, docs-grounded build guide or prompt for the user.\n</workflow>\n\n<important_constraints>\n- Only use URLs copied exactly from tool results. Never guess, fabricate, or use placeholder URLs.\n- If assistantUITemplatePreview returns validationWarnings or an error, call assistantUITemplateDetails again and correct the config against configRoots. Pass only the documented top-level config roots.\n- Customization is for supported adaptation within a template's shape, not for turning it into a completely different kind of product.\n- Responses may include `catalogDegraded: true` when the live template catalog is unreachable. In that mode, template details and preview URLs may be unavailable; tell the user rather than improvising.\n</important_constraints>";
+declare const xuluxPlaygroundPrompt: {
+  name: string;
+  description: string;
+  text: string;
+};
+//#endregion
+export { XULUX_PLAYGROUND_PROMPT, XULUX_PLAYGROUND_PROMPT_DESCRIPTION, XULUX_PLAYGROUND_PROMPT_NAME, xuluxPlaygroundPrompt };
+//# sourceMappingURL=xulux-playground.d.ts.map

package/dist/prompts/xulux-playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xulux-playground.d.ts","names":[],"sources":["../../src/prompts/xulux-playground.ts"],"mappings":";cAIa;cAEA;cAGA;cAsBA"}

package/dist/prompts/xulux-playground.js

@@ -0,0 +1,33 @@
+//#region src/prompts/xulux-playground.ts
+const XULUX_PLAYGROUND_PROMPT_NAME = "assistant-ui-template-workflow";
+const XULUX_PLAYGROUND_PROMPT_DESCRIPTION = "How to use the assistant-ui template tools to discover hosted templates, inspect their customization contracts, and retrieve preview/download URLs.";
+const XULUX_PLAYGROUND_PROMPT = `You have access to assistant-ui template tools for hosted app templates.
+
+<workflow>
+Follow this template-first workflow for any assistant-ui app-building request:
+
+1. Call **assistantUITemplates** FIRST. Never decide on a template or claim one exists without listing.
+2. Call **assistantUITemplateDetails** on any candidate template before deciding whether it fits.
+   - Review the whole template shape: features, assistantPlacement, configRoots schemas, rules, built-in tools, renderers, and exampleConfig.
+   - If \`customizable\` is empty, the entry is a fixed demo. Use it as-is; never pass a config for it.
+3. Decide one of three paths:
+   - The template fits as-is: call **assistantUITemplatePreview** with templateId and optional versionId.
+   - The template fits with supported customization: author a config using the configRoots schemas and rules from assistantUITemplateDetails, then call **assistantUITemplatePreview** with that config.
+   - No template fits: do NOT call assistantUITemplatePreview. Do not force the request into a template or fake domain content with mock config. Instead, ground yourself in the assistant-ui docs (assistantUIDocs, assistantUISearch, assistantUIExamples) and produce an honest, docs-grounded build guide or prompt for the user.
+</workflow>
+
+<important_constraints>
+- Only use URLs copied exactly from tool results. Never guess, fabricate, or use placeholder URLs.
+- If assistantUITemplatePreview returns validationWarnings or an error, call assistantUITemplateDetails again and correct the config against configRoots. Pass only the documented top-level config roots.
+- Customization is for supported adaptation within a template's shape, not for turning it into a completely different kind of product.
+- Responses may include \`catalogDegraded: true\` when the live template catalog is unreachable. In that mode, template details and preview URLs may be unavailable; tell the user rather than improvising.
+</important_constraints>`;
+const xuluxPlaygroundPrompt = {
+	name: XULUX_PLAYGROUND_PROMPT_NAME,
+	description: XULUX_PLAYGROUND_PROMPT_DESCRIPTION,
+	text: XULUX_PLAYGROUND_PROMPT
+};
+//#endregion
+export { XULUX_PLAYGROUND_PROMPT, XULUX_PLAYGROUND_PROMPT_DESCRIPTION, XULUX_PLAYGROUND_PROMPT_NAME, xuluxPlaygroundPrompt };
+
+//# sourceMappingURL=xulux-playground.js.map

package/dist/prompts/xulux-playground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xulux-playground.js","names":[],"sources":["../../src/prompts/xulux-playground.ts"],"sourcesContent":["// Skill-style MCP prompt teaching agents the assistant-ui template workflow.\n// Adapted for MCP clients: tools return URLs and data only; there is no\n// browser canvas UI here.\n\nexport const XULUX_PLAYGROUND_PROMPT_NAME = \"assistant-ui-template-workflow\";\n\nexport const XULUX_PLAYGROUND_PROMPT_DESCRIPTION =\n  \"How to use the assistant-ui template tools to discover hosted templates, inspect their customization contracts, and retrieve preview/download URLs.\";\n\nexport const XULUX_PLAYGROUND_PROMPT = `You have access to assistant-ui template tools for hosted app templates.\n\n<workflow>\nFollow this template-first workflow for any assistant-ui app-building request:\n\n1. Call **assistantUITemplates** FIRST. Never decide on a template or claim one exists without listing.\n2. Call **assistantUITemplateDetails** on any candidate template before deciding whether it fits.\n   - Review the whole template shape: features, assistantPlacement, configRoots schemas, rules, built-in tools, renderers, and exampleConfig.\n   - If \\`customizable\\` is empty, the entry is a fixed demo. Use it as-is; never pass a config for it.\n3. Decide one of three paths:\n   - The template fits as-is: call **assistantUITemplatePreview** with templateId and optional versionId.\n   - The template fits with supported customization: author a config using the configRoots schemas and rules from assistantUITemplateDetails, then call **assistantUITemplatePreview** with that config.\n   - No template fits: do NOT call assistantUITemplatePreview. Do not force the request into a template or fake domain content with mock config. Instead, ground yourself in the assistant-ui docs (assistantUIDocs, assistantUISearch, assistantUIExamples) and produce an honest, docs-grounded build guide or prompt for the user.\n</workflow>\n\n<important_constraints>\n- Only use URLs copied exactly from tool results. Never guess, fabricate, or use placeholder URLs.\n- If assistantUITemplatePreview returns validationWarnings or an error, call assistantUITemplateDetails again and correct the config against configRoots. Pass only the documented top-level config roots.\n- Customization is for supported adaptation within a template's shape, not for turning it into a completely different kind of product.\n- Responses may include \\`catalogDegraded: true\\` when the live template catalog is unreachable. In that mode, template details and preview URLs may be unavailable; tell the user rather than improvising.\n</important_constraints>`;\n\nexport const xuluxPlaygroundPrompt = {\n  name: XULUX_PLAYGROUND_PROMPT_NAME,\n  description: XULUX_PLAYGROUND_PROMPT_DESCRIPTION,\n  text: XULUX_PLAYGROUND_PROMPT,\n};\n"],"mappings":";AAIA,MAAa,+BAA+B;AAE5C,MAAa,sCACX;AAEF,MAAa,0BAA0B;;;;;;;;;;;;;;;;;;;;;AAsBvC,MAAa,wBAAwB;CACnC,MAAM;CACN,aAAa;CACb,MAAM;AACR"}

package/dist/stdio.d.ts

@@ -1 +1 @@
-export { };
+export {}

package/dist/tools/docs.d.ts

@@ -1,26 +1,20 @@
-import { z } from "zod/v3";
-
+import { z } from "zod";
 //#region src/tools/docs.d.ts
 declare const docsInputSchema: z.ZodObject<{
-  paths: z.ZodArray<z.ZodString, "many">;
-}, "strip", z.ZodTypeAny, {
-  paths: string[];
-}, {
-  paths: string[];
-}>;
+  paths: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
 declare const docsTools: {
   name: string;
   description: string;
-  parameters: {
-    paths: z.ZodArray<z.ZodString, "many">;
-  };
-  execute: ({
-    paths
-  }: z.infer<typeof docsInputSchema>) => Promise<{
+  parameters: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>;
+  execute: ({ paths }: z.infer<typeof docsInputSchema>) => Promise<{
     content: Array<{
       type: "text";
       text: string;
     }>;
+    structuredContent?: Record<string, unknown>;
   }>;
 };
 //#endregion

package/dist/tools/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","names":[],"sources":["../../src/tools/docs.ts"],"mappings":";;;cAoBM,eAAA,EAAe,CAAA,CAAA,SAAA;;;;;;;cAyKR,SAAA;;;;;;;;KAKgB,CAAA,CAAE,KAAA,QAAa,eAAA,MAAgB,OAAA"}
+{"version":3,"file":"docs.d.ts","names":[],"sources":["../../src/tools/docs.ts"],"mappings":";;cAoBM,iBAAe,EAAA;;GAOnB,EAAA,KAAA;cAwLW;;;;;;EAKgB,YAAA,SAAA,EAAE,aAAa,qBAAgB"}

package/dist/tools/docs.js

@@ -5,7 +5,7 @@ import { formatMDXContent, readMDXFile } from "../utils/mdx.js";
 import { formatMCPResponse } from "../utils/mcp-format.js";
 import { sanitizePath } from "../utils/security.js";
 import { extname, join } from "node:path";
-import { z } from "zod/v3";
+import { z } from "zod";
 import { lstat, stat } from "node:fs/promises";
 //#region src/tools/docs.ts
 const docsInputSchema = z.object({ paths: z.array(z.string()).min(1).describe("Documentation paths to retrieve (e.g., [\"getting-started\", \"api-reference/primitives/thread\"])") });
@@ -46,6 +46,7 @@ async function readDocumentation(docPath) {
 			if (stats.isDirectory()) {
 				const { directories, files } = await listDirContents(fullPath);
 				const contents = {};
+				const summaries = [];
 				let aggregateSize = 0;
 				let truncated = false;
 				for (const file of files) {
@@ -62,7 +63,16 @@ async function readDocumentation(docPath) {
 						break;
 					}
 					const mdxContent = await readMDXFile(join(fullPath, file));
-					if (mdxContent) contents[file.replace(MDX_EXTENSION, "")] = formatMDXContent(mdxContent);
+					if (mdxContent) {
+						const name = file.replace(MDX_EXTENSION, "");
+						contents[name] = formatMDXContent(mdxContent);
+						const title = mdxContent.frontmatter["title"];
+						summaries.push({
+							name,
+							...typeof title === "string" && { title },
+							...mdxContent.excerpt !== void 0 && { excerpt: mdxContent.excerpt }
+						});
+					}
 				}
 				const content = !truncated && Object.keys(contents).length > 0 ? JSON.stringify(contents, null, 2) : void 0;
 				return {
@@ -71,8 +81,9 @@ async function readDocumentation(docPath) {
 					type: "directory",
 					directories,
 					files: files.map((f) => f.replace(MDX_EXTENSION, "")),
+					...summaries.length > 0 && { summaries },
 					...content !== void 0 && { content },
-					...truncated && { hint: `Directory content exceeds 1048576 bytes and was omitted; request individual files by path to retrieve their content.` }
+					...truncated && { hint: `Directory content exceeds 1048576 bytes and was omitted; summaries cover only the files read before the limit. Request individual files by path to retrieve their content.` }
 				};
 			}
 		}
@@ -98,12 +109,17 @@ async function readDocumentation(docPath) {
 		} catch {}
 		if (await pathExists(mdxPath)) {
 			const mdxContent = await readMDXFile(mdxPath);
-			if (mdxContent) return {
-				path: docPath,
-				found: true,
-				type: "file",
-				content: formatMDXContent(mdxContent)
-			};
+			if (mdxContent) {
+				const title = mdxContent.frontmatter["title"];
+				return {
+					path: docPath,
+					found: true,
+					type: "file",
+					content: formatMDXContent(mdxContent),
+					...typeof title === "string" && { title },
+					...mdxContent.excerpt !== void 0 && { excerpt: mdxContent.excerpt }
+				};
+			}
 		}
 		return {
 			path: docPath,
@@ -122,7 +138,7 @@ async function readDocumentation(docPath) {
 const docsTools = {
 	name: "assistantUIDocs",
 	description: "Retrieve assistant-ui documentation by path. Use \"/\" to list all sections. Supports multiple paths in a single request.",
-	parameters: docsInputSchema.shape,
+	parameters: docsInputSchema,
 	execute: async ({ paths }) => {
 		logger.info(`Retrieving documentation for paths: ${paths.join(", ")}`);
 		try {

package/dist/tools/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","names":[],"sources":["../../src/tools/docs.ts"],"sourcesContent":["import { z } from \"zod/v3\";\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  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        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            contents[file.replace(MDX_EXTENSION, \"\")] =\n              formatMDXContent(mdxContent);\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          ...(content !== undefined && { content }),\n          ...(truncated && {\n            hint: `Directory content exceeds ${MAX_DIRECTORY_CONTENT_SIZE} bytes and was omitted; 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        return {\n          path: docPath,\n          found: true,\n          type: \"file\",\n          content: formatMDXContent(mdxContent),\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.shape,\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":"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"}

package/dist/tools/examples.d.ts

@@ -1,28 +1,22 @@
-import { z } from "zod/v3";
-
+import { z } from "zod";
 //#region src/tools/examples.d.ts
 declare const examplesInputSchema: z.ZodObject<{
   example: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-  example?: string | undefined;
-}, {
-  example?: string | undefined;
-}>;
+}, z.core.$strip>;
 declare function listCodeExamples(): Promise<string[]>;
 declare function readCodeExample(exampleName: string): Promise<string | null>;
 declare const examplesTools: {
   name: string;
   description: string;
-  parameters: {
+  parameters: z.ZodObject<{
     example: z.ZodOptional<z.ZodString>;
-  };
-  execute: ({
-    example
-  }: z.infer<typeof examplesInputSchema>) => Promise<{
+  }, z.core.$strip>;
+  execute: ({ example }: z.infer<typeof examplesInputSchema>) => Promise<{
     content: Array<{
       type: "text";
       text: string;
     }>;
+    structuredContent?: Record<string, unknown>;
   }>;
 };
 //#endregion

package/dist/tools/examples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"examples.d.ts","names":[],"sources":["../../src/tools/examples.ts"],"mappings":";;;cAQM,mBAAA,EAAmB,CAAA,CAAA,SAAA;;;;;;;iBASH,gBAAA,IAAoB,OAAO;AAAA,iBAa3B,eAAA,CACpB,WAAA,WACC,OAAO;AAAA,cAwBG,aAAA;;;;;;;;KAKkB,CAAA,CAAE,KAAA,QAAa,mBAAA,MAAoB,OAAA"}
+{"version":3,"file":"examples.d.ts","names":[],"sources":["../../src/tools/examples.ts"],"mappings":";;cASM,qBAAmB,EAAA;;GAOvB,EAAA,KAAA;iBAIc,oBAAoB;iBAed,gBACpB,sBACC;cAwBU;;;;;;EAKkB,YAAA,WAAA,EAAE,aAAa,yBAAoB"}

package/dist/tools/examples.js

@@ -1,19 +1,22 @@
 import { CODE_EXAMPLES_PATH } from "../constants.js";
 import { logger } from "../utils/logger.js";
+import { cacheListing } from "../utils/cache.js";
 import { formatMCPResponse } from "../utils/mcp-format.js";
 import { sanitizePath } from "../utils/security.js";
 import { extname, join } from "node:path";
-import { z } from "zod/v3";
+import { z } from "zod";
 import { lstat, readFile, readdir } from "node:fs/promises";
 //#region src/tools/examples.ts
-const examplesInputSchema = z.object({ example: z.string().optional().describe("Example name (e.g., \"with-ai-sdk-v6\"). Leave empty to list all examples.") });
-async function listCodeExamples() {
-	try {
-		return (await readdir(CODE_EXAMPLES_PATH)).filter((file) => extname(file) === ".md").map((file) => file.replace(".md", "")).sort();
-	} catch (error) {
+const examplesInputSchema = z.object({ example: z.string().optional().describe("Example name (e.g., \"with-ai-sdk-v7\"). Leave empty to list all examples.") });
+const loadCodeExamples = cacheListing(scanCodeExamples);
+function listCodeExamples() {
+	return loadCodeExamples().catch((error) => {
 		logger.error("Failed to list code examples", error);
 		return [];
-	}
+	});
+}
+async function scanCodeExamples() {
+	return (await readdir(CODE_EXAMPLES_PATH)).filter((file) => extname(file) === ".md").map((file) => file.replace(".md", "")).sort();
 }
 async function readCodeExample(exampleName) {
 	try {
@@ -36,7 +39,7 @@ async function readCodeExample(exampleName) {
 const examplesTools = {
 	name: "assistantUIExamples",
 	description: "List available examples or retrieve complete code for a specific example",
-	parameters: examplesInputSchema.shape,
+	parameters: examplesInputSchema,
 	execute: async ({ example }) => {
 		try {
 			if (!example) {

package/dist/tools/examples.js.map

@@ -1 +1 @@
-{"version":3,"file":"examples.js","names":[],"sources":["../../src/tools/examples.ts"],"sourcesContent":["import { z } from \"zod/v3\";\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 { 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-v6\"). Leave empty to list all examples.',\n    ),\n});\n\nexport async function listCodeExamples(): Promise<string[]> {\n  try {\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  } catch (error) {\n    logger.error(\"Failed to list code examples\", error);\n    return [];\n  }\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.shape,\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":";;;;;;;;AAQA,MAAM,sBAAsB,EAAE,OAAO,EACnC,SAAS,EACN,OAAO,CAAC,CACR,SAAS,CAAC,CACV,SACC,4EACF,EACJ,CAAC;AAED,eAAsB,mBAAsC;CAC1D,IAAI;EAEF,QAAO,MADa,QAAQ,kBAAkB,EAAA,CAE3C,QAAQ,SAAS,QAAQ,IAAI,MAAM,KAAK,CAAC,CACzC,KAAK,SAAS,KAAK,QAAQ,OAAO,EAAE,CAAC,CAAC,CACtC,KAAK;CACV,SAAS,OAAO;EACd,OAAO,MAAM,gCAAgC,KAAK;EAClD,OAAO,CAAC;CACV;AACF;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,oBAAoB;CAChC,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;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"}

package/dist/tools/resources.d.ts

@@ -1,5 +1,4 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-
+import { McpServer } from "@modelcontextprotocol/server";
 //#region src/tools/resources.d.ts
 declare function registerResources(server: McpServer): void;
 //#endregion

package/dist/tools/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","names":[],"sources":["../../src/tools/resources.ts"],"mappings":";;;iBAuFgB,iBAAA,CAAkB,MAAiB,EAAT,SAAS"}
+{"version":3,"file":"resources.d.ts","names":[],"sources":["../../src/tools/resources.ts"],"mappings":";;iBAoFgB,kBAAkB,QAAQ"}

package/dist/tools/resources.js

@@ -5,7 +5,7 @@ import { formatMDXContent, readMDXFileSafe } from "../utils/mdx.js";
 import { sanitizePath } from "../utils/security.js";
 import { listCodeExamples, readCodeExample } from "./examples.js";
 import { join } from "node:path";
-import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ResourceTemplate } from "@modelcontextprotocol/server";
 //#region src/tools/resources.ts
 const MARKDOWN_MIME_TYPE = "text/markdown";
 const DOCS_SCHEME = "aui-docs";

package/dist/tools/resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources.js","names":[],"sources":["../../src/tools/resources.ts"],"sourcesContent":["import {\n  McpServer,\n  ResourceTemplate,\n} from \"@modelcontextprotocol/sdk/server/mcp.js\";\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":";;;;;;;;;AAYA,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;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"}

package/dist/tools/search.d.ts

@@ -1,31 +1,22 @@
-import { z } from "zod/v3";
-
+import { z } from "zod";
 //#region src/tools/search.d.ts
 declare const searchInputSchema: z.ZodObject<{
   query: z.ZodString;
   limit: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-  query: string;
-  limit: number;
-}, {
-  query: string;
-  limit?: number | undefined;
-}>;
+}, z.core.$strip>;
 declare const searchTools: {
   name: string;
   description: string;
-  parameters: {
+  parameters: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
-  };
-  execute: ({
-    query,
-    limit
-  }: z.infer<typeof searchInputSchema>) => Promise<{
+  }, z.core.$strip>;
+  execute: ({ query, limit }: z.infer<typeof searchInputSchema>) => Promise<{
     content: Array<{
       type: "text";
       text: string;
     }>;
+    structuredContent?: Record<string, unknown>;
   }>;
 };
 //#endregion

package/dist/tools/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","names":[],"sources":["../../src/tools/search.ts"],"mappings":";;;cAKM,iBAAA,EAAiB,CAAA,CAAA,SAAA;;;;;;;;;;cAcV,WAAA;;;;;;;;;;KAKuB,CAAA,CAAE,KAAA,QAAa,iBAAA,MAAkB,OAAA"}
+{"version":3,"file":"search.d.ts","names":[],"sources":["../../src/tools/search.ts"],"mappings":";;cAKM,mBAAiB,EAAA;;;GAYrB,EAAA,KAAA;cAEW;;;;;;;EAKuB,YAAA,OAAA,SAAA,EAAE,aAAa,uBAAkB"}

package/dist/tools/search.js

@@ -1,14 +1,14 @@
 import { logger } from "../utils/logger.js";
 import { formatMCPResponse } from "../utils/mcp-format.js";
 import { searchDocs } from "../utils/search.js";
-import { z } from "zod/v3";
+import { z } from "zod";
 const searchTools = {
 	name: "assistantUISearch",
 	description: "Search assistant-ui documentation by keyword. Returns ranked matches with their doc path, title, and a snippet. Fetch full content with assistantUIDocs using a returned path.",
 	parameters: z.object({
 		query: z.string().min(1).describe("Keyword(s) to search assistant-ui documentation for."),
 		limit: z.number().int().min(1).max(25).default(10).describe("Maximum number of results to return (default 10).")
-	}).shape,
+	}),
 	execute: async ({ query, limit }) => {
 		logger.info(`Searching documentation for: ${query}`);
 		try {

package/dist/tools/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","names":[],"sources":["../../src/tools/search.ts"],"sourcesContent":["import { z } from \"zod/v3\";\nimport { logger } from \"../utils/logger.js\";\nimport { formatMCPResponse } from \"../utils/mcp-format.js\";\nimport { searchDocs } from \"../utils/search.js\";\n\nconst searchInputSchema = z.object({\n  query: z\n    .string()\n    .min(1)\n    .describe(\"Keyword(s) to search assistant-ui documentation for.\"),\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(25)\n    .default(10)\n    .describe(\"Maximum number of results to return (default 10).\"),\n});\n\nexport const searchTools = {\n  name: \"assistantUISearch\",\n  description:\n    \"Search assistant-ui documentation by keyword. Returns ranked matches with their doc path, title, and a snippet. Fetch full content with assistantUIDocs using a returned path.\",\n  parameters: searchInputSchema.shape,\n  execute: async ({ query, limit }: z.infer<typeof searchInputSchema>) => {\n    logger.info(`Searching documentation for: ${query}`);\n    try {\n      const results = await searchDocs(query, limit);\n      if (results.length === 0) {\n        return formatMCPResponse({\n          query,\n          results: [],\n          total: 0,\n          hint: 'No matches. Use assistantUIDocs with \"/\" to list all sections.',\n        });\n      }\n      return formatMCPResponse({ query, results, total: results.length });\n    } catch (error) {\n      logger.error(\"Failed to search documentation\", error);\n      return formatMCPResponse({\n        error: \"Failed to search documentation\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n"],"mappings":";;;;AAmBA,MAAa,cAAc;CACzB,MAAM;CACN,aACE;CACF,YAlBwB,EAAE,OAAO;EACjC,OAAO,EACJ,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,SAAS,sDAAsD;EAClE,OAAO,EACJ,OAAO,CAAC,CACR,IAAI,CAAC,CACL,IAAI,CAAC,CAAC,CACN,IAAI,EAAE,CAAC,CACP,QAAQ,EAAE,CAAC,CACX,SAAS,mDAAmD;CACjE,CAMc,CAAA,CAAkB;CAC9B,SAAS,OAAO,EAAE,OAAO,YAA+C;EACtE,OAAO,KAAK,gCAAgC,OAAO;EACnD,IAAI;GACF,MAAM,UAAU,MAAM,WAAW,OAAO,KAAK;GAC7C,IAAI,QAAQ,WAAW,GACrB,OAAO,kBAAkB;IACvB;IACA,SAAS,CAAC;IACV,OAAO;IACP,MAAM;GACR,CAAC;GAEH,OAAO,kBAAkB;IAAE;IAAO;IAAS,OAAO,QAAQ;GAAO,CAAC;EACpE,SAAS,OAAO;GACd,OAAO,MAAM,kCAAkC,KAAK;GACpD,OAAO,kBAAkB;IACvB,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH;CACF;AACF"}
+{"version":3,"file":"search.js","names":[],"sources":["../../src/tools/search.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { logger } from \"../utils/logger.js\";\nimport { formatMCPResponse } from \"../utils/mcp-format.js\";\nimport { searchDocs } from \"../utils/search.js\";\n\nconst searchInputSchema = z.object({\n  query: z\n    .string()\n    .min(1)\n    .describe(\"Keyword(s) to search assistant-ui documentation for.\"),\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(25)\n    .default(10)\n    .describe(\"Maximum number of results to return (default 10).\"),\n});\n\nexport const searchTools = {\n  name: \"assistantUISearch\",\n  description:\n    \"Search assistant-ui documentation by keyword. Returns ranked matches with their doc path, title, and a snippet. Fetch full content with assistantUIDocs using a returned path.\",\n  parameters: searchInputSchema,\n  execute: async ({ query, limit }: z.infer<typeof searchInputSchema>) => {\n    logger.info(`Searching documentation for: ${query}`);\n    try {\n      const results = await searchDocs(query, limit);\n      if (results.length === 0) {\n        return formatMCPResponse({\n          query,\n          results: [],\n          total: 0,\n          hint: 'No matches. Use assistantUIDocs with \"/\" to list all sections.',\n        });\n      }\n      return formatMCPResponse({ query, results, total: results.length });\n    } catch (error) {\n      logger.error(\"Failed to search documentation\", error);\n      return formatMCPResponse({\n        error: \"Failed to search documentation\",\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  },\n};\n"],"mappings":";;;;AAmBA,MAAa,cAAc;CACzB,MAAM;CACN,aACE;CACF,YAlBwB,EAAE,OAAO;EACjC,OAAO,EACJ,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,SAAS,sDAAsD;EAClE,OAAO,EACJ,OAAO,CAAC,CACR,IAAI,CAAC,CACL,IAAI,CAAC,CAAC,CACN,IAAI,EAAE,CAAC,CACP,QAAQ,EAAE,CAAC,CACX,SAAS,mDAAmD;CACjE,CAMc;CACZ,SAAS,OAAO,EAAE,OAAO,YAA+C;EACtE,OAAO,KAAK,gCAAgC,OAAO;EACnD,IAAI;GACF,MAAM,UAAU,MAAM,WAAW,OAAO,KAAK;GAC7C,IAAI,QAAQ,WAAW,GACrB,OAAO,kBAAkB;IACvB;IACA,SAAS,CAAC;IACV,OAAO;IACP,MAAM;GACR,CAAC;GAEH,OAAO,kBAAkB;IAAE;IAAO;IAAS,OAAO,QAAQ;GAAO,CAAC;EACpE,SAAS,OAAO;GACd,OAAO,MAAM,kCAAkC,KAAK;GACpD,OAAO,kBAAkB;IACvB,OAAO;IACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH;CACF;AACF"}

package/dist/tools/tests/mcp-test-client.d.ts

@@ -0,0 +1,15 @@
+import { McpServer } from "@modelcontextprotocol/server";
+//#region src/tools/tests/mcp-test-client.d.ts
+type RawMcpRequest = {
+  method: string;
+  params?: unknown;
+};
+type McpTestClient = {
+  initialize: () => Promise<unknown>;
+  request: <Result>(request: RawMcpRequest) => Promise<Result>;
+  close: () => Promise<void>;
+};
+declare function createMcpTestClient(server: McpServer): Promise<McpTestClient>;
+//#endregion
+export { McpTestClient, createMcpTestClient };
+//# sourceMappingURL=mcp-test-client.d.ts.map

package/dist/tools/tests/mcp-test-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-test-client.d.ts","names":[],"sources":["../../../src/tools/tests/mcp-test-client.ts"],"mappings":";;KAKK;EACH;EACA;;KAiBU;EACV,kBAAkB;EAClB,UAAU,QAAQ,SAAS,kBAAkB,QAAQ;EACrD,aAAa;;iBAaO,oBACpB,QAAQ,YACP,QAAQ"}