@assistant-ui/mcp-docs-server 0.2.3 → 0.3.1

package/dist/tools/examples.js.map

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

package/dist/tools/resources.d.ts

@@ -1,6 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/server";
-//#region src/tools/resources.d.ts
-declare function registerResources(server: McpServer): void;
-//#endregion
-export { registerResources };
-//# sourceMappingURL=resources.d.ts.map

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

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

package/dist/tools/resources.js

@@ -1,75 +0,0 @@
-import { DOCS_PATH, MDX_EXTENSION } from "../constants.js";
-import { logger } from "../utils/logger.js";
-import { getAvailableDocFiles } from "../utils/paths.js";
-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/server";
-//#region src/tools/resources.ts
-const MARKDOWN_MIME_TYPE = "text/markdown";
-const DOCS_SCHEME = "aui-docs";
-const EXAMPLE_SCHEME = "aui-example";
-function templateVarToPath(value) {
-	if (Array.isArray(value)) return value.join("/");
-	return value ?? "";
-}
-function registerMarkdownResource(server, config) {
-	const { name, scheme, variable, title, description, notFoundLabel, list, read } = config;
-	server.registerResource(name, new ResourceTemplate(`${scheme}:///{+${variable}}`, {
-		list: async () => ({ resources: (await list()).map((key) => ({
-			uri: `${scheme}:///${key}`,
-			name: key,
-			mimeType: MARKDOWN_MIME_TYPE
-		})) }),
-		complete: { [variable]: async (value) => {
-			const needle = value.toLowerCase();
-			return (await list()).filter((key) => key.toLowerCase().includes(needle));
-		} }
-	}), {
-		title,
-		description,
-		mimeType: MARKDOWN_MIME_TYPE
-	}, async (uri, variables) => {
-		const key = templateVarToPath(variables[variable]);
-		const text = await read(key);
-		if (text === null) throw new Error(`${notFoundLabel} not found: ${key}`);
-		return { contents: [{
-			uri: uri.href,
-			mimeType: MARKDOWN_MIME_TYPE,
-			text
-		}] };
-	});
-}
-async function readDocResource(path) {
-	const sanitized = sanitizePath(path);
-	const mdx = await readMDXFileSafe(join(DOCS_PATH, `${sanitized}${MDX_EXTENSION}`));
-	return mdx ? formatMDXContent(mdx) : null;
-}
-function registerResources(server) {
-	registerMarkdownResource(server, {
-		name: "assistant-ui-docs",
-		scheme: DOCS_SCHEME,
-		variable: "path",
-		title: "assistant-ui Documentation",
-		description: "Individual assistant-ui documentation pages, readable as markdown by path.",
-		notFoundLabel: "Documentation",
-		list: getAvailableDocFiles,
-		read: readDocResource
-	});
-	registerMarkdownResource(server, {
-		name: "assistant-ui-examples",
-		scheme: EXAMPLE_SCHEME,
-		variable: "name",
-		title: "assistant-ui Examples",
-		description: "Complete assistant-ui example projects, readable as markdown.",
-		notFoundLabel: "Example",
-		list: listCodeExamples,
-		read: readCodeExample
-	});
-	logger.debug("Registered docs and examples resources");
-}
-//#endregion
-export { registerResources };
-
-//# sourceMappingURL=resources.js.map

package/dist/tools/resources.js.map

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

package/dist/tools/search.d.ts

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

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

@@ -1 +0,0 @@
-{"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,39 +0,0 @@
-import { logger } from "../utils/logger.js";
-import { formatMCPResponse } from "../utils/mcp-format.js";
-import { searchDocs } from "../utils/search.js";
-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).")
-	}),
-	execute: async ({ query, limit }) => {
-		logger.info(`Searching documentation for: ${query}`);
-		try {
-			const results = await searchDocs(query, limit);
-			if (results.length === 0) return formatMCPResponse({
-				query,
-				results: [],
-				total: 0,
-				hint: "No matches. Use assistantUIDocs with \"/\" to list all sections."
-			});
-			return formatMCPResponse({
-				query,
-				results,
-				total: results.length
-			});
-		} catch (error) {
-			logger.error("Failed to search documentation", error);
-			return formatMCPResponse({
-				error: "Failed to search documentation",
-				message: error instanceof Error ? error.message : String(error)
-			});
-		}
-	}
-};
-//#endregion
-export { searchTools };
-
-//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

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

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

package/dist/tools/tests/mcp-test-client.js

@@ -1,68 +0,0 @@
-import { InMemoryTransport } from "@modelcontextprotocol/server";
-//#region src/tools/tests/mcp-test-client.ts
-function isJsonRpcResponse(message) {
-	return typeof message === "object" && message !== null && "id" in message && typeof message.id === "number" && ("result" in message || "error" in message);
-}
-async function createMcpTestClient(server) {
-	const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
-	const pendingRequests = /* @__PURE__ */ new Map();
-	let nextRequestId = 1;
-	clientTransport.onmessage = (message) => {
-		if (!isJsonRpcResponse(message)) return;
-		const pendingRequest = pendingRequests.get(message.id);
-		if (!pendingRequest) return;
-		pendingRequests.delete(message.id);
-		if (message.error) {
-			pendingRequest.reject(/* @__PURE__ */ new Error(`MCP request failed (${message.error.code}): ${message.error.message}`));
-			return;
-		}
-		pendingRequest.resolve(message.result);
-	};
-	await clientTransport.start();
-	await server.connect(serverTransport);
-	const request = (rawRequest) => {
-		const id = nextRequestId++;
-		return new Promise((resolve, reject) => {
-			pendingRequests.set(id, {
-				resolve,
-				reject
-			});
-			clientTransport.send({
-				jsonrpc: "2.0",
-				id,
-				...rawRequest
-			}).catch((error) => {
-				pendingRequests.delete(id);
-				reject(error instanceof Error ? error : new Error(String(error)));
-			});
-		});
-	};
-	return {
-		initialize: async () => {
-			const result = await request({
-				method: "initialize",
-				params: {
-					protocolVersion: "2025-11-25",
-					capabilities: {},
-					clientInfo: {
-						name: "mcp-docs-server-tests",
-						version: "1.0.0"
-					}
-				}
-			});
-			await clientTransport.send({
-				jsonrpc: "2.0",
-				method: "notifications/initialized"
-			});
-			return result;
-		},
-		request,
-		close: async () => {
-			await clientTransport.close();
-		}
-	};
-}
-//#endregion
-export { createMcpTestClient };
-
-//# sourceMappingURL=mcp-test-client.js.map

package/dist/tools/tests/mcp-test-client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-test-client.js","names":[],"sources":["../../../src/tools/tests/mcp-test-client.ts"],"sourcesContent":["import {\n  InMemoryTransport,\n  type McpServer,\n} from \"@modelcontextprotocol/server\";\n\ntype RawMcpRequest = {\n  method: string;\n  params?: unknown;\n};\n\ntype JsonRpcResponse = {\n  id: number;\n  result?: unknown;\n  error?: {\n    code: number;\n    message: string;\n  };\n};\n\ntype PendingRequest = {\n  resolve: (result: unknown) => void;\n  reject: (error: Error) => void;\n};\n\nexport type McpTestClient = {\n  initialize: () => Promise<unknown>;\n  request: <Result>(request: RawMcpRequest) => Promise<Result>;\n  close: () => Promise<void>;\n};\n\nfunction isJsonRpcResponse(message: unknown): message is JsonRpcResponse {\n  return (\n    typeof message === \"object\" &&\n    message !== null &&\n    \"id\" in message &&\n    typeof message.id === \"number\" &&\n    (\"result\" in message || \"error\" in message)\n  );\n}\n\nexport async function createMcpTestClient(\n  server: McpServer,\n): Promise<McpTestClient> {\n  const [clientTransport, serverTransport] =\n    InMemoryTransport.createLinkedPair();\n  const pendingRequests = new Map<number, PendingRequest>();\n  let nextRequestId = 1;\n\n  clientTransport.onmessage = (message) => {\n    if (!isJsonRpcResponse(message)) return;\n\n    const pendingRequest = pendingRequests.get(message.id);\n    if (!pendingRequest) return;\n\n    pendingRequests.delete(message.id);\n    if (message.error) {\n      pendingRequest.reject(\n        new Error(\n          `MCP request failed (${message.error.code}): ${message.error.message}`,\n        ),\n      );\n      return;\n    }\n\n    pendingRequest.resolve(message.result);\n  };\n\n  await clientTransport.start();\n  await server.connect(serverTransport);\n\n  const request = <Result>(rawRequest: RawMcpRequest): Promise<Result> => {\n    const id = nextRequestId++;\n\n    return new Promise((resolve, reject) => {\n      pendingRequests.set(id, { resolve, reject });\n      void clientTransport\n        .send({ jsonrpc: \"2.0\", id, ...rawRequest })\n        .catch((error: unknown) => {\n          pendingRequests.delete(id);\n          reject(error instanceof Error ? error : new Error(String(error)));\n        });\n    }) as Promise<Result>;\n  };\n\n  return {\n    initialize: async () => {\n      const result = await request({\n        method: \"initialize\",\n        params: {\n          protocolVersion: \"2025-11-25\",\n          capabilities: {},\n          clientInfo: {\n            name: \"mcp-docs-server-tests\",\n            version: \"1.0.0\",\n          },\n        },\n      });\n\n      await clientTransport.send({\n        jsonrpc: \"2.0\",\n        method: \"notifications/initialized\",\n      });\n\n      return result;\n    },\n    request,\n    close: async () => {\n      await clientTransport.close();\n    },\n  };\n}\n"],"mappings":";;AA8BA,SAAS,kBAAkB,SAA8C;CACvE,OACE,OAAO,YAAY,YACnB,YAAY,QACZ,QAAQ,WACR,OAAO,QAAQ,OAAO,aACrB,YAAY,WAAW,WAAW;AAEvC;AAEA,eAAsB,oBACpB,QACwB;CACxB,MAAM,CAAC,iBAAiB,mBACtB,kBAAkB,iBAAiB;CACrC,MAAM,kCAAkB,IAAI,IAA4B;CACxD,IAAI,gBAAgB;CAEpB,gBAAgB,aAAa,YAAY;EACvC,IAAI,CAAC,kBAAkB,OAAO,GAAG;EAEjC,MAAM,iBAAiB,gBAAgB,IAAI,QAAQ,EAAE;EACrD,IAAI,CAAC,gBAAgB;EAErB,gBAAgB,OAAO,QAAQ,EAAE;EACjC,IAAI,QAAQ,OAAO;GACjB,eAAe,uBACb,IAAI,MACF,uBAAuB,QAAQ,MAAM,KAAK,KAAK,QAAQ,MAAM,SAC/D,CACF;GACA;EACF;EAEA,eAAe,QAAQ,QAAQ,MAAM;CACvC;CAEA,MAAM,gBAAgB,MAAM;CAC5B,MAAM,OAAO,QAAQ,eAAe;CAEpC,MAAM,WAAmB,eAA+C;EACtE,MAAM,KAAK;EAEX,OAAO,IAAI,SAAS,SAAS,WAAW;GACtC,gBAAgB,IAAI,IAAI;IAAE;IAAS;GAAO,CAAC;GAC3C,gBACG,KAAK;IAAE,SAAS;IAAO;IAAI,GAAG;GAAW,CAAC,CAAC,CAC3C,OAAO,UAAmB;IACzB,gBAAgB,OAAO,EAAE;IACzB,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CAAC;GAClE,CAAC;EACL,CAAC;CACH;CAEA,OAAO;EACL,YAAY,YAAY;GACtB,MAAM,SAAS,MAAM,QAAQ;IAC3B,QAAQ;IACR,QAAQ;KACN,iBAAiB;KACjB,cAAc,CAAC;KACf,YAAY;MACV,MAAM;MACN,SAAS;KACX;IACF;GACF,CAAC;GAED,MAAM,gBAAgB,KAAK;IACzB,SAAS;IACT,QAAQ;GACV,CAAC;GAED,OAAO;EACT;EACA;EACA,OAAO,YAAY;GACjB,MAAM,gBAAgB,MAAM;EAC9B;CACF;AACF"}

package/dist/tools/tests/test-setup.d.ts

@@ -1,7 +0,0 @@
-//#region src/tools/tests/test-setup.d.ts
-declare const testContext: {
-  callTool: (name: string, args: any) => Promise<any>;
-};
-//#endregion
-export { testContext };
-//# sourceMappingURL=test-setup.d.ts.map

package/dist/tools/tests/test-setup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"test-setup.d.ts","names":[],"sources":["../../../src/tools/tests/test-setup.ts"],"mappings":";cAsBa;EACY,WAAA,cAAM,cAAW"}

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

@@ -1,36 +0,0 @@
-import { PACKAGE_DIR } from "../../constants.js";
-import { docsTools } from "../docs.js";
-import { examplesTools } from "../examples.js";
-import { searchTools } from "../search.js";
-import { xuluxTemplateDetailsTool, xuluxTemplatePreviewTool, xuluxTemplatesListTool } from "../xulux-templates.js";
-import { join } from "node:path";
-import { existsSync } from "node:fs";
-import { beforeAll } from "vitest";
-//#region src/tools/tests/test-setup.ts
-const tools = {
-	assistantUIDocs: docsTools,
-	assistantUIExamples: examplesTools,
-	assistantUISearch: searchTools,
-	assistantUITemplates: xuluxTemplatesListTool,
-	assistantUITemplateDetails: xuluxTemplateDetailsTool,
-	assistantUITemplatePreview: xuluxTemplatePreviewTool
-};
-const testContext = { callTool: async (name, args) => {
-	const tool = tools[name];
-	if (!tool) throw new Error(`Tool ${name} not found`);
-	const text = (await tool.execute(args)).content?.[0]?.text;
-	if (text === void 0) throw new Error(`Tool ${name} returned no content`);
-	try {
-		return JSON.parse(text);
-	} catch (error) {
-		throw new Error(`Tool ${name} returned invalid JSON. Output: ${text}\nParse error: ${error instanceof Error ? error.message : String(error)}`);
-	}
-} };
-beforeAll(() => {
-	const docsPath = join(PACKAGE_DIR, ".docs");
-	if (!existsSync(docsPath)) throw new Error("Documentation not prepared. Run: pnpm build");
-});
-//#endregion
-export { testContext };
-
-//# sourceMappingURL=test-setup.js.map

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

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

package/dist/tools/xulux-templates.d.ts

@@ -1,58 +0,0 @@
-import { z } from "zod";
-//#region src/tools/xulux-templates.d.ts
-declare const emptyInputSchema: z.ZodObject<{}, z.core.$strip>;
-declare const detailsInputSchema: z.ZodObject<{
-  templateId: z.ZodString;
-  versionId: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-declare const previewInputSchema: z.ZodObject<{
-  templateId: z.ZodString;
-  versionId: z.ZodOptional<z.ZodString>;
-  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
-declare const xuluxTemplatesListTool: {
-  name: string;
-  description: string;
-  parameters: z.ZodObject<{}, z.core.$strip>;
-  execute: (_args: z.infer<typeof emptyInputSchema>) => Promise<{
-    content: Array<{
-      type: "text";
-      text: string;
-    }>;
-    structuredContent?: Record<string, unknown>;
-  }>;
-};
-declare const xuluxTemplateDetailsTool: {
-  name: string;
-  description: string;
-  parameters: z.ZodObject<{
-    templateId: z.ZodString;
-    versionId: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>;
-  execute: (args: z.infer<typeof detailsInputSchema>) => Promise<{
-    content: Array<{
-      type: "text";
-      text: string;
-    }>;
-    structuredContent?: Record<string, unknown>;
-  }>;
-};
-declare const xuluxTemplatePreviewTool: {
-  name: string;
-  description: string;
-  parameters: z.ZodObject<{
-    templateId: z.ZodString;
-    versionId: z.ZodOptional<z.ZodString>;
-    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  }, z.core.$strip>;
-  execute: (args: z.infer<typeof previewInputSchema>) => Promise<{
-    content: Array<{
-      type: "text";
-      text: string;
-    }>;
-    structuredContent?: Record<string, unknown>;
-  }>;
-};
-//#endregion
-export { xuluxTemplateDetailsTool, xuluxTemplatePreviewTool, xuluxTemplatesListTool };
-//# sourceMappingURL=xulux-templates.d.ts.map

package/dist/tools/xulux-templates.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"xulux-templates.d.ts","names":[],"sources":["../../src/tools/xulux-templates.ts"],"mappings":";;cAUM,kBAAgB,EAAA,cAAA,EAAA,KAAA;cAEhB,oBAAkB,EAAA;;;GAQtB,EAAA,KAAA;cAEI,oBAAkB,EAAA;;;;GActB,EAAA,KAAA;cAeW;;;;EAQY,UAAA,OAAA,EAAE,aAAa,sBAAiB;;;;;;;;cAiB5C;;;;;;;EASW,UAAA,MAAA,EAAE,aAAa,wBAAmB;;;;;;;;cAwB7C;;;;;;;;EASW,UAAA,MAAA,EAAE,aAAa,wBAAmB"}

package/dist/tools/xulux-templates.js

@@ -1,84 +0,0 @@
-import { logger } from "../utils/logger.js";
-import { formatMCPResponse } from "../utils/mcp-format.js";
-import { getXuluxCatalog } from "../xulux/catalog-client.js";
-import { createTemplatePreview, getTemplateDetails, listTemplates } from "../xulux/template-service.js";
-import { z } from "zod";
-//#region src/tools/xulux-templates.ts
-const emptyInputSchema = z.object({});
-const detailsInputSchema = z.object({
-	templateId: z.string().describe("The template id from assistantUITemplates"),
-	versionId: z.string().optional().describe("Optional version id. When provided, exampleConfig reflects that version's resolved defaults.")
-});
-const previewInputSchema = z.object({
-	templateId: z.string().describe("The template id from assistantUITemplates"),
-	versionId: z.string().optional().describe("Version id to use. Uses the template default if omitted."),
-	config: z.record(z.string(), z.unknown()).optional().describe("Customization config for the preview. Must contain only the top-level keys: hostUi, assistant, and brandTheme. Use the schemas from assistantUITemplateDetails.configRoots as the source of truth for each root. Do not pass any other root keys.")
-});
-function withDegradedNote(payload, degraded, degradedReason) {
-	if (!degraded) return payload;
-	return {
-		...payload,
-		catalogDegraded: true,
-		...degradedReason ? { catalogDegradedReason: degradedReason } : {}
-	};
-}
-const xuluxTemplatesListTool = {
-	name: "assistantUITemplates",
-	description: "List the available assistant-ui hosted app templates and fixed demos with their features, customizable surfaces, and versions. Call this first for any assistant-ui app-building request. Use the features and customizable fields to decide which template fits. If customizable is empty, the entry is a fixed demo that should be used as-is rather than configured. Call assistantUITemplateDetails on the chosen template before requesting a preview.",
-	parameters: emptyInputSchema,
-	execute: async (_args) => {
-		logger.info("Listing assistant-ui templates");
-		try {
-			const { catalog, degraded, degradedReason } = await getXuluxCatalog();
-			return formatMCPResponse(withDegradedNote(listTemplates(catalog), degraded, degradedReason));
-		} catch (error) {
-			logger.error("Failed to list assistant-ui templates", error);
-			return formatMCPResponse({
-				error: "Failed to list assistant-ui templates",
-				message: error instanceof Error ? error.message : String(error)
-			});
-		}
-	}
-};
-const xuluxTemplateDetailsTool = {
-	name: "assistantUITemplateDetails",
-	description: "Get the full authoring surface for a specific assistant-ui hosted template. Returns configRoots schemas (with types, defaults, and enums), rules, built-in tool input/outputShape, renderer contracts, and an exampleConfig. Fixed demos return no configRoots; use those as-is without config. Use this before calling assistantUITemplatePreview to understand exactly what config to write. If assistantUITemplatePreview returns validationWarnings, call this again and cross-reference configRoots to correct the config.",
-	parameters: detailsInputSchema,
-	execute: async (args) => {
-		logger.info(`Getting assistant-ui template details for: ${args.templateId}`);
-		try {
-			const { catalog, degraded, degradedReason } = await getXuluxCatalog();
-			const details = await getTemplateDetails(catalog, args);
-			return formatMCPResponse(withDegradedNote(details, degraded, degradedReason));
-		} catch (error) {
-			logger.error("Failed to get assistant-ui template details", error);
-			return formatMCPResponse({
-				error: "Failed to get assistant-ui template details",
-				message: error instanceof Error ? error.message : String(error)
-			});
-		}
-	}
-};
-const xuluxTemplatePreviewTool = {
-	name: "assistantUITemplatePreview",
-	description: "Return preview and download URLs for a selected assistant-ui hosted template. The previewUrl is a hosted app URL; show it to the user first, or open it with an available browser/in-app-browser tool if your client provides one. If you pass config, a preview session is created on the hosted template sandbox and the returned URLs reflect that configuration. Do not pass config for fixed demos that have no configRoots in assistantUITemplateDetails. This tool only returns URLs.",
-	parameters: previewInputSchema,
-	execute: async (args) => {
-		logger.info(`Creating assistant-ui template preview for: ${args.templateId}`);
-		try {
-			const { catalog, degraded, degradedReason } = await getXuluxCatalog();
-			const result = await createTemplatePreview(catalog, args);
-			return formatMCPResponse(withDegradedNote(result, degraded, degradedReason));
-		} catch (error) {
-			logger.error("Failed to create assistant-ui template preview", error);
-			return formatMCPResponse({
-				error: "Failed to create assistant-ui template preview",
-				message: error instanceof Error ? error.message : String(error)
-			});
-		}
-	}
-};
-//#endregion
-export { xuluxTemplateDetailsTool, xuluxTemplatePreviewTool, xuluxTemplatesListTool };
-
-//# sourceMappingURL=xulux-templates.js.map

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

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

package/dist/utils/cache.d.ts

@@ -1,5 +0,0 @@
-//#region src/utils/cache.d.ts
-declare function cacheListing(scan: () => Promise<string[]>): () => Promise<string[]>;
-//#endregion
-export { cacheListing };
-//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.d.ts","names":[],"sources":["../../src/utils/cache.ts"],"mappings":";iBAAgB,aACd,YAAY,0BACL"}

package/dist/utils/cache.js

@@ -1,18 +0,0 @@
-//#region src/utils/cache.ts
-function cacheListing(scan) {
-	let cache = null;
-	return () => {
-		if (!cache) cache = scan().then((result) => {
-			if (result.length === 0) cache = null;
-			return result;
-		}, (error) => {
-			cache = null;
-			throw error;
-		});
-		return cache;
-	};
-}
-//#endregion
-export { cacheListing };
-
-//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.js","names":[],"sources":["../../src/utils/cache.ts"],"sourcesContent":["export function cacheListing(\n  scan: () => Promise<string[]>,\n): () => Promise<string[]> {\n  let cache: Promise<string[]> | null = null;\n  return () => {\n    if (!cache) {\n      cache = scan().then(\n        (result) => {\n          if (result.length === 0) cache = null;\n          return result;\n        },\n        (error) => {\n          cache = null;\n          throw error;\n        },\n      );\n    }\n    return cache;\n  };\n}\n"],"mappings":";AAAA,SAAgB,aACd,MACyB;CACzB,IAAI,QAAkC;CACtC,aAAa;EACX,IAAI,CAAC,OACH,QAAQ,KAAK,CAAC,CAAC,MACZ,WAAW;GACV,IAAI,OAAO,WAAW,GAAG,QAAQ;GACjC,OAAO;EACT,IACC,UAAU;GACT,QAAQ;GACR,MAAM;EACR,CACF;EAEF,OAAO;CACT;AACF"}

package/dist/utils/logger.d.ts

@@ -1,10 +0,0 @@
-//#region src/utils/logger.d.ts
-declare const logger: {
-  debug: (message: string, ...args: any[]) => void;
-  info: (message: string, ...args: any[]) => void;
-  error: (message: string, ...args: any[]) => void;
-  warn: (message: string, ...args: any[]) => void;
-};
-//#endregion
-export { logger };
-//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.d.ts","names":[],"sources":["../../src/utils/logger.ts"],"mappings":";cAEa;EACM,QAAA,oBAAM;EAKP,OAAA,oBAAM;EAKL,QAAA,oBAAM;EAGP,OAAA,oBAAM"}

package/dist/utils/logger.js

@@ -1,20 +0,0 @@
-import { IS_PREPARE_MODE } from "../constants.js";
-//#region src/utils/logger.ts
-const logger = {
-	debug: (message, ...args) => {
-		if (process.env.DEBUG) console.debug(`[DEBUG] ${message}`, ...args);
-	},
-	info: (message, ...args) => {
-		if (IS_PREPARE_MODE) console.log(`[INFO] ${message}`, ...args);
-	},
-	error: (message, ...args) => {
-		console.error(`[ERROR] ${message}`, ...args);
-	},
-	warn: (message, ...args) => {
-		console.warn(`[WARN] ${message}`, ...args);
-	}
-};
-//#endregion
-export { logger };
-
-//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.js","names":[],"sources":["../../src/utils/logger.ts"],"sourcesContent":["import { IS_PREPARE_MODE } from \"../constants.js\";\n\nexport const logger = {\n  debug: (message: string, ...args: any[]) => {\n    if (process.env.DEBUG) {\n      console.debug(`[DEBUG] ${message}`, ...args);\n    }\n  },\n  info: (message: string, ...args: any[]) => {\n    if (IS_PREPARE_MODE) {\n      console.log(`[INFO] ${message}`, ...args);\n    }\n  },\n  error: (message: string, ...args: any[]) => {\n    console.error(`[ERROR] ${message}`, ...args);\n  },\n  warn: (message: string, ...args: any[]) => {\n    console.warn(`[WARN] ${message}`, ...args);\n  },\n};\n"],"mappings":";;AAEA,MAAa,SAAS;CACpB,QAAQ,SAAiB,GAAG,SAAgB;EAC1C,IAAI,QAAQ,IAAI,OACd,QAAQ,MAAM,WAAW,WAAW,GAAG,IAAI;CAE/C;CACA,OAAO,SAAiB,GAAG,SAAgB;EACzC,IAAI,iBACF,QAAQ,IAAI,UAAU,WAAW,GAAG,IAAI;CAE5C;CACA,QAAQ,SAAiB,GAAG,SAAgB;EAC1C,QAAQ,MAAM,WAAW,WAAW,GAAG,IAAI;CAC7C;CACA,OAAO,SAAiB,GAAG,SAAgB;EACzC,QAAQ,KAAK,UAAU,WAAW,GAAG,IAAI;CAC3C;AACF"}

package/dist/utils/mcp-format.d.ts

@@ -1,11 +0,0 @@
-//#region src/utils/mcp-format.d.ts
-declare function formatMCPResponse(data: any): {
-  content: Array<{
-    type: "text";
-    text: string;
-  }>;
-  structuredContent?: Record<string, unknown>;
-};
-//#endregion
-export { formatMCPResponse };
-//# sourceMappingURL=mcp-format.d.ts.map

package/dist/utils/mcp-format.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-format.d.ts","names":[],"sources":["../../src/utils/mcp-format.ts"],"mappings":";iBAAgB,kBAAkB;EAChC,SAAS;IAAQ;IAAc;;EAC/B,oBAAoB"}

package/dist/utils/mcp-format.js

@@ -1,14 +0,0 @@
-//#region src/utils/mcp-format.ts
-function formatMCPResponse(data) {
-	return {
-		content: [{
-			type: "text",
-			text: typeof data === "string" ? data : JSON.stringify(data, null, 2)
-		}],
-		...typeof data === "object" && data !== null && !Array.isArray(data) && { structuredContent: data }
-	};
-}
-//#endregion
-export { formatMCPResponse };
-
-//# sourceMappingURL=mcp-format.js.map

package/dist/utils/mcp-format.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-format.js","names":[],"sources":["../../src/utils/mcp-format.ts"],"sourcesContent":["export function formatMCPResponse(data: any): {\n  content: Array<{ type: \"text\"; text: string }>;\n  structuredContent?: Record<string, unknown>;\n} {\n  const text = typeof data === \"string\" ? data : JSON.stringify(data, null, 2);\n  const isStructured =\n    typeof data === \"object\" && data !== null && !Array.isArray(data);\n  return {\n    content: [{ type: \"text\", text }],\n    ...(isStructured && {\n      structuredContent: data as Record<string, unknown>,\n    }),\n  };\n}\n"],"mappings":";AAAA,SAAgB,kBAAkB,MAGhC;CAIA,OAAO;EACL,SAAS,CAAC;GAAE,MAAM;GAAQ,MAJf,OAAO,SAAS,WAAW,OAAO,KAAK,UAAU,MAAM,MAAM,CAAC;EAI1C,CAAC;EAChC,GAHA,OAAO,SAAS,YAAY,SAAS,QAAQ,CAAC,MAAM,QAAQ,IAAI,KAG5C,EAClB,mBAAmB,KACrB;CACF;AACF"}