@assistant-ui/mcp-docs-server 0.1.31 → 0.1.33

package/dist/tools/docs.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/tools/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAe3B,QAAA,MAAM,eAAe;;;;;;EAOnB,CAAC;AA6IH,eAAO,MAAM,SAAS;;;;;;yBAKO,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC;;;;;;CAsC3D,CAAC"}
+{"version":3,"file":"docs.d.ts","names":[],"sources":["../../src/tools/docs.ts"],"mappings":";;;cAeM,eAAA,EAAe,CAAA,CAAA,SAAA;;;;;;;cAoJR,SAAA;;;;;;;;KAKgB,CAAA,CAAE,KAAA,QAAa,eAAA,MAAgB,OAAA"}

package/dist/tools/docs.js

@@ -1,168 +1,147 @@
-import { z } from "zod/v3";
-import { stat, lstat } from "node:fs/promises";
-import { join, extname } from "node:path";
-import { DOCS_PATH, MDX_EXTENSION, MAX_FILE_SIZE } from "../constants.js";
+import { DOCS_PATH, MAX_FILE_SIZE, MDX_EXTENSION } from "../constants.js";
 import { logger } from "../utils/logger.js";
-import { listDirContents, getAvailablePaths, findNearestPaths, pathExists, } from "../utils/paths.js";
-import { readMDXFile, formatMDXContent } from "../utils/mdx.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";
-const docsInputSchema = z.object({
-    paths: z
-        .array(z.string())
-        .min(1)
-        .describe('Documentation paths to retrieve (e.g., ["getting-started", "api-reference/primitives/thread"])'),
-});
+import { extname, join } from "node:path";
+import { z } from "zod/v3";
+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 {
-            const lstats = await lstat(fullPath);
-            if (lstats.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 > MAX_FILE_SIZE) {
-                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 = {};
-                for (const file of files) {
-                    const mdxContent = await readMDXFile(join(fullPath, file));
-                    if (mdxContent) {
-                        const fileName = file.replace(MDX_EXTENSION, "");
-                        contents[fileName] = formatMDXContent(mdxContent);
-                    }
-                }
-                const content = Object.keys(contents).length > 0
-                    ? JSON.stringify(contents, null, 2)
-                    : undefined;
-                return {
-                    path: docPath,
-                    found: true,
-                    type: "directory",
-                    directories,
-                    files: files.map((f) => f.replace(MDX_EXTENSION, "")),
-                    ...(content !== undefined && { content }),
-                };
-            }
-        }
-        const mdxPath = extname(fullPath) === MDX_EXTENSION
-            ? 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 > MAX_FILE_SIZE) {
-                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) {
-                return {
-                    path: docPath,
-                    found: true,
-                    type: "file",
-                    content: formatMDXContent(mdxContent),
-                };
-            }
-        }
-        const availablePaths = await getAvailablePaths();
-        const suggestions = findNearestPaths(docPath, availablePaths);
-        return {
-            path: docPath,
-            found: false,
-            suggestions,
-        };
-    }
-    catch (error) {
-        if (error instanceof Error && error.message.includes("Invalid path")) {
-            return {
-                path: docPath,
-                found: false,
-                error: error.message,
-            };
-        }
-        throw error;
-    }
+	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 fullPath = join(DOCS_PATH, sanitizePath(docPath));
+		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 = {};
+				for (const file of files) {
+					const mdxContent = await readMDXFile(join(fullPath, file));
+					if (mdxContent) {
+						const fileName = file.replace(MDX_EXTENSION, "");
+						contents[fileName] = formatMDXContent(mdxContent);
+					}
+				}
+				const content = 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, "")),
+					...content !== void 0 && { 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) return {
+				path: docPath,
+				found: true,
+				type: "file",
+				content: formatMDXContent(mdxContent)
+			};
+		}
+		return {
+			path: docPath,
+			found: false,
+			suggestions: findNearestPaths(docPath, await getAvailablePaths())
+		};
+	} catch (error) {
+		if (error instanceof Error && error.message.includes("Invalid path")) return {
+			path: docPath,
+			found: false,
+			error: error.message
+		};
+		throw error;
+	}
 }
-export 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,
-    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),
-            });
-        }
-    },
+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,
+	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 +1 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/tools/docs.ts"],"names":[],"mappings":"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"}
+{"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 { DOCS_PATH, MDX_EXTENSION, MAX_FILE_SIZE } 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  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        for (const file of files) {\n          const mdxContent = await readMDXFile(join(fullPath, file));\n          if (mdxContent) {\n            const fileName = file.replace(MDX_EXTENSION, \"\");\n            contents[fileName] = formatMDXContent(mdxContent);\n          }\n        }\n\n        const content =\n          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        };\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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"}

package/dist/tools/examples.d.ts

@@ -1,23 +1,28 @@
 import { z } from "zod/v3";
+
+//#region src/tools/examples.d.ts
 declare const examplesInputSchema: z.ZodObject<{
-    example: z.ZodOptional<z.ZodString>;
+  example: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    example?: string | undefined;
+  example?: string | undefined;
 }, {
-    example?: string | undefined;
+  example?: string | undefined;
 }>;
-export declare const examplesTools: {
-    name: string;
-    description: string;
-    parameters: {
-        example: z.ZodOptional<z.ZodString>;
-    };
-    execute: ({ example }: z.infer<typeof examplesInputSchema>) => Promise<{
-        content: Array<{
-            type: "text";
-            text: string;
-        }>;
+declare const examplesTools: {
+  name: string;
+  description: string;
+  parameters: {
+    example: z.ZodOptional<z.ZodString>;
+  };
+  execute: ({
+    example
+  }: z.infer<typeof examplesInputSchema>) => Promise<{
+    content: Array<{
+      type: "text";
+      text: string;
     }>;
+  }>;
 };
-export {};
+//#endregion
+export { examplesTools };
 //# sourceMappingURL=examples.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../src/tools/examples.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAQ3B,QAAA,MAAM,mBAAmB;;;;;;EAOvB,CAAC;AAuCH,eAAO,MAAM,aAAa;;;;;;2BAKK,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;;;;;;CA+CjE,CAAC"}
+{"version":3,"file":"examples.d.ts","names":[],"sources":["../../src/tools/examples.ts"],"mappings":";;;cAQM,mBAAA,EAAmB,CAAA,CAAA,SAAA;;;;;;;cA8CZ,aAAA;;;;;;;;KAKkB,CAAA,CAAE,KAAA,QAAa,mBAAA,MAAoB,OAAA"}

package/dist/tools/examples.js

@@ -1,95 +1,83 @@
-import { z } from "zod/v3";
-import { readFile, readdir, lstat } from "node:fs/promises";
-import { join, extname } from "node:path";
-import { CODE_EXAMPLES_PATH, MAX_FILE_SIZE } from "../constants.js";
+import { CODE_EXAMPLES_PATH } from "../constants.js";
 import { logger } from "../utils/logger.js";
 import { formatMCPResponse } from "../utils/mcp-format.js";
 import { sanitizePath } from "../utils/security.js";
-const examplesInputSchema = z.object({
-    example: z
-        .string()
-        .optional()
-        .describe('Example name (e.g., "with-ai-sdk-v6"). Leave empty to list all examples.'),
-});
+import { extname, join } from "node:path";
+import { z } from "zod/v3";
+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 {
-        const files = await readdir(CODE_EXAMPLES_PATH);
-        return files
-            .filter((file) => extname(file) === ".md")
-            .map((file) => file.replace(".md", ""))
-            .sort();
-    }
-    catch (error) {
-        logger.error("Failed to list code examples", error);
-        return [];
-    }
+	try {
+		return (await readdir(CODE_EXAMPLES_PATH)).filter((file) => extname(file) === ".md").map((file) => file.replace(".md", "")).sort();
+	} catch (error) {
+		logger.error("Failed to list code examples", error);
+		return [];
+	}
 }
 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 > MAX_FILE_SIZE) {
-            logger.warn(`File size exceeds limit: ${filePath} (${stats.size} bytes)`);
-            return null;
-        }
-        const content = await readFile(filePath, "utf-8");
-        return content;
-    }
-    catch (error) {
-        logger.error(`Failed to read example: ${exampleName}`, error);
-        return null;
-    }
+	try {
+		const filePath = join(CODE_EXAMPLES_PATH, `${sanitizePath(exampleName)}.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;
+	}
 }
-export const examplesTools = {
-    name: "assistantUIExamples",
-    description: "List available examples or retrieve complete code for a specific example",
-    parameters: examplesInputSchema.shape,
-    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),
-            });
-        }
-    },
+const examplesTools = {
+	name: "assistantUIExamples",
+	description: "List available examples or retrieve complete code for a specific example",
+	parameters: examplesInputSchema.shape,
+	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 };
+
 //# sourceMappingURL=examples.js.map