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

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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,5 +0,0 @@
-//#region src/prepare-docs/copy-raw.d.ts
-declare function copyRaw(): Promise<void>;
-//#endregion
-export { copyRaw };
-//# sourceMappingURL=copy-raw.d.ts.map

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

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

package/dist/prepare-docs/copy-raw.js

@@ -1,49 +0,0 @@
-import { ROOT_DIR } from "../constants.js";
-import { logger } from "../utils/logger.js";
-import { extname, join } from "node:path";
-import { copyFile, mkdir, readdir, rm } from "node:fs/promises";
-//#region src/prepare-docs/copy-raw.ts
-const DOCS_SOURCE = join(ROOT_DIR, "apps/docs/content/docs");
-const DOCS_DEST = join(ROOT_DIR, "packages/mcp-docs-server/.docs/raw");
-async function copyDir(src, dest) {
-	try {
-		await mkdir(dest, { recursive: true });
-		const entries = await readdir(src, { withFileTypes: true });
-		for (const entry of entries) {
-			const srcPath = join(src, entry.name);
-			const destPath = join(dest, entry.name);
-			if (entry.isDirectory()) await copyDir(srcPath, destPath);
-			else if (entry.isFile()) {
-				const ext = extname(entry.name).toLowerCase();
-				if (ext === ".mdx" || ext === ".md") {
-					await copyFile(srcPath, destPath);
-					logger.debug(`Copied: ${srcPath} -> ${destPath}`);
-				}
-			}
-		}
-	} catch (error) {
-		logger.error(`Failed to copy directory: ${src}`, error);
-		throw error;
-	}
-}
-async function copyRaw() {
-	logger.info("Copying raw documentation files...");
-	try {
-		await rm(DOCS_DEST, {
-			recursive: true,
-			force: true
-		});
-		await mkdir(DOCS_DEST, { recursive: true });
-		const docsPath = join(DOCS_DEST, "docs");
-		await copyDir(DOCS_SOURCE, docsPath);
-		logger.info(`Copied documentation to ${docsPath}`);
-		logger.info("Raw documentation copy complete");
-	} catch (error) {
-		logger.error("Failed to copy raw documentation", error);
-		throw error;
-	}
-}
-//#endregion
-export { copyRaw };
-
-//# sourceMappingURL=copy-raw.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"copy-raw.js","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"sourcesContent":["import { rm, mkdir, readdir, copyFile } from \"node:fs/promises\";\nimport { join, extname } from \"node:path\";\nimport { logger } from \"../utils/logger.js\";\nimport { ROOT_DIR } from \"../constants.js\";\n\nconst DOCS_SOURCE = join(ROOT_DIR, \"apps/docs/content/docs\");\nconst DOCS_DEST = join(ROOT_DIR, \"packages/mcp-docs-server/.docs/raw\");\n\nasync function copyDir(src: string, dest: string): Promise<void> {\n  try {\n    await mkdir(dest, { recursive: true });\n    const entries = await readdir(src, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const srcPath = join(src, entry.name);\n      const destPath = join(dest, entry.name);\n\n      if (entry.isDirectory()) {\n        await copyDir(srcPath, destPath);\n      } else if (entry.isFile()) {\n        const ext = extname(entry.name).toLowerCase();\n        if (ext === \".mdx\" || ext === \".md\") {\n          await copyFile(srcPath, destPath);\n          logger.debug(`Copied: ${srcPath} -> ${destPath}`);\n        }\n      }\n    }\n  } catch (error) {\n    logger.error(`Failed to copy directory: ${src}`, error);\n    throw error;\n  }\n}\n\nexport async function copyRaw(): Promise<void> {\n  logger.info(\"Copying raw documentation files...\");\n\n  try {\n    await rm(DOCS_DEST, { recursive: true, force: true });\n    await mkdir(DOCS_DEST, { recursive: true });\n\n    const docsPath = join(DOCS_DEST, \"docs\");\n    await copyDir(DOCS_SOURCE, docsPath);\n    logger.info(`Copied documentation to ${docsPath}`);\n\n    logger.info(\"Raw documentation copy complete\");\n  } catch (error) {\n    logger.error(\"Failed to copy raw documentation\", error);\n    throw error;\n  }\n}\n"],"mappings":";;;;;AAKA,MAAM,cAAc,KAAK,UAAU,wBAAwB;AAC3D,MAAM,YAAY,KAAK,UAAU,oCAAoC;AAErE,eAAe,QAAQ,KAAa,MAA6B;CAC/D,IAAI;EACF,MAAM,MAAM,MAAM,EAAE,WAAW,KAAK,CAAC;EACrC,MAAM,UAAU,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;EAE1D,KAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,UAAU,KAAK,KAAK,MAAM,IAAI;GACpC,MAAM,WAAW,KAAK,MAAM,MAAM,IAAI;GAEtC,IAAI,MAAM,YAAY,GACpB,MAAM,QAAQ,SAAS,QAAQ;QAC1B,IAAI,MAAM,OAAO,GAAG;IACzB,MAAM,MAAM,QAAQ,MAAM,IAAI,CAAC,CAAC,YAAY;IAC5C,IAAI,QAAQ,UAAU,QAAQ,OAAO;KACnC,MAAM,SAAS,SAAS,QAAQ;KAChC,OAAO,MAAM,WAAW,QAAQ,MAAM,UAAU;IAClD;GACF;EACF;CACF,SAAS,OAAO;EACd,OAAO,MAAM,6BAA6B,OAAO,KAAK;EACtD,MAAM;CACR;AACF;AAEA,eAAsB,UAAyB;CAC7C,OAAO,KAAK,oCAAoC;CAEhD,IAAI;EACF,MAAM,GAAG,WAAW;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;EACpD,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAE1C,MAAM,WAAW,KAAK,WAAW,MAAM;EACvC,MAAM,QAAQ,aAAa,QAAQ;EACnC,OAAO,KAAK,2BAA2B,UAAU;EAEjD,OAAO,KAAK,iCAAiC;CAC/C,SAAS,OAAO;EACd,OAAO,MAAM,oCAAoC,KAAK;EACtD,MAAM;CACR;AACF"}

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

@@ -1 +0,0 @@
-export {}

package/dist/prepare-docs/prepare.js

@@ -1,22 +0,0 @@
-import { logger } from "../utils/logger.js";
-import { prepareCodeExamples } from "./code-examples.js";
-import { copyRaw } from "./copy-raw.js";
-//#region src/prepare-docs/prepare.ts
-async function prepare() {
-	logger.info("Starting documentation preparation...");
-	try {
-		await copyRaw();
-		await prepareCodeExamples();
-		logger.info("Documentation preparation complete");
-	} catch (error) {
-		logger.error("Documentation preparation failed", error);
-		throw error;
-	}
-}
-if (import.meta.url === `file://${process.argv[1]}`) prepare().catch((error) => {
-	logger.error("Preparation failed", error);
-	process.exit(1);
-});
-//#endregion
-
-//# sourceMappingURL=prepare.js.map

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

@@ -1 +0,0 @@
-{"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/prompts/xulux-playground.d.ts

@@ -1,12 +0,0 @@
-//#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

@@ -1 +0,0 @@
-{"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

@@ -1,33 +0,0 @@
-//#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

@@ -1 +0,0 @@
-{"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/tools/docs.d.ts

@@ -1,22 +0,0 @@
-import { z } from "zod";
-//#region src/tools/docs.d.ts
-declare const docsInputSchema: z.ZodObject<{
-  paths: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-declare const docsTools: {
-  name: string;
-  description: string;
-  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
-export { docsTools };
-//# sourceMappingURL=docs.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,177 +0,0 @@
-import { DOCS_PATH, MAX_FILE_SIZE, MDX_EXTENSION } from "../constants.js";
-import { logger } from "../utils/logger.js";
-import { findNearestPaths, getAvailablePaths, listDirContents, pathExists } from "../utils/paths.js";
-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";
-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\"])") });
-async function readDocumentation(docPath) {
-	logger.debug(`Reading documentation for path: ${docPath}`);
-	if (docPath === "/" || docPath === "") {
-		const { directories, files } = await listDirContents(DOCS_PATH);
-		return {
-			path: "/",
-			found: true,
-			type: "directory",
-			directories,
-			files: files.map((f) => f.replace(MDX_EXTENSION, ""))
-		};
-	}
-	try {
-		const sanitized = sanitizePath(docPath);
-		const fullPath = join(DOCS_PATH, sanitized);
-		try {
-			if ((await lstat(fullPath)).isSymbolicLink()) {
-				logger.warn(`Symlink detected at path: ${fullPath}`);
-				return {
-					path: docPath,
-					found: false,
-					error: "Symlinks are not allowed for security reasons"
-				};
-			}
-		} catch {}
-		if (await pathExists(fullPath)) {
-			const stats = await stat(fullPath);
-			if (stats.isFile() && stats.size > 10485760) {
-				logger.warn(`File too large: ${fullPath} (${stats.size} bytes)`);
-				return {
-					path: docPath,
-					found: false,
-					error: `File size exceeds maximum allowed size of ${MAX_FILE_SIZE} bytes`
-				};
-			}
-			if (stats.isDirectory()) {
-				const { directories, files } = await listDirContents(fullPath);
-				const contents = {};
-				const summaries = [];
-				let aggregateSize = 0;
-				let truncated = false;
-				for (const file of files) {
-					let fileSize;
-					try {
-						fileSize = (await stat(join(fullPath, file))).size;
-					} catch (error) {
-						logger.warn(`Failed to stat MDX file: ${join(fullPath, file)}`, error);
-						continue;
-					}
-					aggregateSize += fileSize;
-					if (aggregateSize > 1048576) {
-						truncated = true;
-						break;
-					}
-					const mdxContent = await readMDXFile(join(fullPath, file));
-					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 {
-					path: docPath,
-					found: true,
-					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; summaries cover only the files read before the limit. Request individual files by path to retrieve their content.` }
-				};
-			}
-		}
-		const mdxPath = extname(fullPath) === ".mdx" ? fullPath : `${fullPath}${MDX_EXTENSION}`;
-		try {
-			const mdxLstats = await lstat(mdxPath);
-			if (mdxLstats.isSymbolicLink()) {
-				logger.warn(`Symlink detected at MDX path: ${mdxPath}`);
-				return {
-					path: docPath,
-					found: false,
-					error: "Symlinks are not allowed for security reasons"
-				};
-			}
-			if (mdxLstats.size > 10485760) {
-				logger.warn(`MDX file too large: ${mdxPath} (${mdxLstats.size} bytes)`);
-				return {
-					path: docPath,
-					found: false,
-					error: `File size exceeds maximum allowed size of ${MAX_FILE_SIZE} bytes`
-				};
-			}
-		} catch {}
-		if (await pathExists(mdxPath)) {
-			const mdxContent = await readMDXFile(mdxPath);
-			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 }
-				};
-			}
-		}
-		const availablePaths = await getAvailablePaths();
-		return {
-			path: docPath,
-			found: false,
-			suggestions: findNearestPaths(docPath, availablePaths)
-		};
-	} catch (error) {
-		if (error instanceof Error && error.message.includes("Invalid path")) return {
-			path: docPath,
-			found: false,
-			error: error.message
-		};
-		throw error;
-	}
-}
-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,
-	execute: async ({ paths }) => {
-		logger.info(`Retrieving documentation for paths: ${paths.join(", ")}`);
-		try {
-			const results = await Promise.all(paths.map((path) => readDocumentation(path)));
-			if (results.length === 1) {
-				const result = results[0];
-				if (result.error) return formatMCPResponse({
-					error: result.error,
-					path: result.path
-				});
-				if (!result.found) return formatMCPResponse({
-					error: `Documentation not found for path: ${result.path}`,
-					suggestions: result.suggestions,
-					hint: "Use \"/\" to list all available documentation sections"
-				});
-				return formatMCPResponse(result);
-			}
-			return formatMCPResponse({
-				results,
-				summary: `Retrieved ${results.filter((r) => r.found).length} of ${results.length} requested paths`
-			});
-		} catch (error) {
-			logger.error("Failed to retrieve documentation", error);
-			return formatMCPResponse({
-				error: "Failed to retrieve documentation",
-				message: error instanceof Error ? error.message : String(error)
-			});
-		}
-	}
-};
-//#endregion
-export { docsTools };
-
-//# sourceMappingURL=docs.js.map

package/dist/tools/docs.js.map

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

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

@@ -1 +0,0 @@
-{"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,87 +0,0 @@
-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";
-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-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 {
-		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}`);
-			return null;
-		}
-		if (stats.size > 10485760) {
-			logger.warn(`File size exceeds limit: ${filePath} (${stats.size} bytes)`);
-			return null;
-		}
-		return await readFile(filePath, "utf-8");
-	} catch (error) {
-		logger.error(`Failed to read example: ${exampleName}`, error);
-		return null;
-	}
-}
-const examplesTools = {
-	name: "assistantUIExamples",
-	description: "List available examples or retrieve complete code for a specific example",
-	parameters: examplesInputSchema,
-	execute: async ({ example }) => {
-		try {
-			if (!example) {
-				logger.info("Listing all available examples");
-				const examples = await listCodeExamples();
-				if (examples.length === 0) return formatMCPResponse({
-					error: "No examples found. Please run documentation preparation first.",
-					hint: "Run: pnpm prepare-docs"
-				});
-				return formatMCPResponse({
-					type: "list",
-					examples,
-					total: examples.length,
-					hint: "Use example parameter to get complete code for any example"
-				});
-			}
-			logger.info(`Retrieving example: ${example}`);
-			const content = await readCodeExample(example);
-			if (!content) {
-				const availableExamples = await listCodeExamples();
-				return formatMCPResponse({
-					error: `Example not found: ${example}`,
-					availableExamples,
-					hint: "Use without example parameter to list all available examples"
-				});
-			}
-			return formatMCPResponse({
-				type: "example",
-				name: example,
-				content
-			});
-		} catch (error) {
-			logger.error("Failed to retrieve examples", error);
-			return formatMCPResponse({
-				error: "Failed to retrieve examples",
-				message: error instanceof Error ? error.message : String(error)
-			});
-		}
-	}
-};
-//#endregion
-export { examplesTools, listCodeExamples, readCodeExample };
-
-//# sourceMappingURL=examples.js.map