@aleph-alpha/lib-mcp 2.2.0 → 4.0.0

package/dist/server.js

@@ -3221,8 +3221,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path11) {
-      let input = path11;
+    function removeDotSegments(path12) {
+      let input = path12;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3421,8 +3421,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path11, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path11 && path11 !== "/" ? path11 : void 0;
+        const [path12, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path12 && path12 !== "/" ? path12 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -7275,8 +7275,8 @@ function getErrorMap() {
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path11, errorMaps, issueData } = params;
-  const fullPath = [...path11, ...issueData.path || []];
+  const { data, path: path12, errorMaps, issueData } = params;
+  const fullPath = [...path12, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -7392,11 +7392,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path11, key) {
+  constructor(parent, value, path12, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path11;
+    this._path = path12;
     this._key = key;
   }
   get path() {
@@ -11034,10 +11034,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path11) {
-  if (!path11)
+function getElementAtPath(obj, path12) {
+  if (!path12)
     return obj;
-  return path11.reduce((acc, key) => acc?.[key], obj);
+  return path12.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -11357,11 +11357,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path11, issues) {
+function prefixIssues(path12, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path11);
+    iss.path.unshift(path12);
     return iss;
   });
 }
@@ -20989,9 +20989,9 @@ var StdioServerTransport = class {
 
 // src/tools/list-components.ts
 import * as fs4 from "node:fs";
-import * as path4 from "node:path";
+import * as path5 from "node:path";
 
-// src/readers/types-reader.ts
+// src/readers/stories-reader.ts
 import * as path from "node:path";
 
 // src/utils/file-utils.ts
@@ -21034,7 +21034,264 @@ function findMatchingBrace(text2, openingBraceIndex, openChar = "{", closeChar =
   return depth === 0 ? i - 1 : -1;
 }
 
+// src/readers/stories-reader.ts
+function extractStoryJSDoc(content, storyName) {
+  const exportRegex = new RegExp(`export\\s+const\\s+${storyName}\\s*:`);
+  const exportMatch = content.match(exportRegex);
+  if (!exportMatch || exportMatch.index === void 0) return "";
+  const beforeExport = content.substring(0, exportMatch.index);
+  const lastJsDocEnd = beforeExport.lastIndexOf("*/");
+  if (lastJsDocEnd === -1) return "";
+  const between = beforeExport.substring(lastJsDocEnd + 2);
+  if (between.trim() !== "") return "";
+  const lastJsDocStart = beforeExport.lastIndexOf("/**");
+  if (lastJsDocStart === -1 || lastJsDocStart > lastJsDocEnd) return "";
+  const jsdoc = beforeExport.substring(lastJsDocStart + 3, lastJsDocEnd);
+  return jsdoc.split("\n").map((line) => line.replace(/^\s*\*\s?/, "").trim()).filter((line) => line && !line.startsWith("@")).join(" ").trim();
+}
+function extractTemplateSource(content) {
+  const templates = /* @__PURE__ */ new Map();
+  const templateRegex = /const\s+(\w+TemplateSource)\s*=\s*`([\s\S]*?)`;/g;
+  let match;
+  while ((match = templateRegex.exec(content)) !== null) {
+    const varName = match[1];
+    const code = match[2].trim();
+    templates.set(varName, code);
+  }
+  return templates;
+}
+function extractStories(content) {
+  const stories = /* @__PURE__ */ new Map();
+  const storyExportRegex = /export\s+const\s+(\w+):\s*Story\s*=/g;
+  let match;
+  while ((match = storyExportRegex.exec(content)) !== null) {
+    const storyName = match[1];
+    if (storyName === "default") continue;
+    const storyStart = match.index;
+    const remainingContent = content.substring(storyStart);
+    const templateRefMatch = remainingContent.match(
+      /code:\s*(\w+TemplateSource)/
+    );
+    if (templateRefMatch) {
+      stories.set(storyName, templateRefMatch[1]);
+    }
+  }
+  return stories;
+}
+function extractInlineRenderTemplates(content) {
+  const examples = [];
+  const storyExportRegex = /export\s+const\s+(\w+):\s*Story\s*=/g;
+  let match;
+  while ((match = storyExportRegex.exec(content)) !== null) {
+    const storyName = match[1];
+    if (storyName === "default") continue;
+    const afterEquals = content.indexOf("{", match.index + match[0].length);
+    if (afterEquals === -1) continue;
+    const closingBrace = findMatchingBrace(content, afterEquals);
+    if (closingBrace === -1) continue;
+    const storyBlock = content.slice(afterEquals, closingBrace + 1);
+    if (!storyBlock.includes("template:")) continue;
+    if (/sourceState:\s*['"]none['"]/.test(storyBlock)) continue;
+    const templateMatch = storyBlock.match(/template:\s*`([\s\S]*?)`/);
+    if (!templateMatch) continue;
+    const template = templateMatch[1].trim();
+    if (!template) continue;
+    const componentsMatch = storyBlock.match(/components:\s*\{([^}]+)\}/);
+    const componentNames = componentsMatch ? componentsMatch[1].split(",").map((c) => c.trim()).filter(Boolean) : [];
+    const imports = componentNames.length > 0 ? `<script setup>
+// Components: ${componentNames.join(", ")}
+</script>
+
+` : "";
+    examples.push({
+      name: storyName,
+      description: "",
+      code: `${imports}<template>
+${template}
+</template>`
+    });
+  }
+  return examples;
+}
+function extractArgTypes(content) {
+  const argTypes = [];
+  const argTypesKeyIndex = content.indexOf("argTypes");
+  if (argTypesKeyIndex === -1) {
+    return argTypes;
+  }
+  const colonIndex = content.indexOf(":", argTypesKeyIndex);
+  if (colonIndex === -1) {
+    return argTypes;
+  }
+  const openingBraceIndex = content.indexOf("{", colonIndex);
+  if (openingBraceIndex === -1) {
+    return argTypes;
+  }
+  const closingBraceIndex = findMatchingBrace(content, openingBraceIndex);
+  if (closingBraceIndex === -1) {
+    return argTypes;
+  }
+  const argTypesBlock = content.slice(openingBraceIndex + 1, closingBraceIndex);
+  let index = 0;
+  while (index < argTypesBlock.length) {
+    const propNameMatch = argTypesBlock.slice(index).match(/^\s*(\w+)\s*:\s*\{/);
+    if (!propNameMatch) {
+      const nextComma = argTypesBlock.indexOf(",", index);
+      if (nextComma === -1) break;
+      index = nextComma + 1;
+      continue;
+    }
+    const propName = propNameMatch[1];
+    const propStartIndex = index + propNameMatch[0].length - 1;
+    const propEndIndex = findMatchingBrace(argTypesBlock, propStartIndex);
+    if (propEndIndex === -1) break;
+    const propBlock = argTypesBlock.slice(propStartIndex + 1, propEndIndex);
+    const descMatch = propBlock.match(/description:\s*['"](.+?)['"]\s*[,}]/s);
+    const description = descMatch ? descMatch[1].replace(/\\(['"])/g, "$1") : "";
+    const controlMatch = propBlock.match(/control:\s*['"]?(\w+)['"]?/);
+    const control = controlMatch ? controlMatch[1] : void 0;
+    const optionsMatch = propBlock.match(/options:\s*\[([\s\S]*?)\]/);
+    let options;
+    if (optionsMatch) {
+      options = optionsMatch[1].split(",").map((opt) => opt.trim().replace(/['"]/g, "")).filter(Boolean);
+    }
+    argTypes.push({
+      name: propName,
+      description,
+      control,
+      options
+    });
+    index = propEndIndex + 1;
+  }
+  return argTypes;
+}
+function extractTitle(content) {
+  const titleMatch = content.match(/title:\s*['"]([^'"]+)['"]/);
+  return titleMatch ? titleMatch[1] : "";
+}
+function extractLabels(content) {
+  const tagsKeyIndex = content.indexOf("tags:");
+  if (tagsKeyIndex === -1) return [];
+  const openingBracketIndex = content.indexOf("[", tagsKeyIndex);
+  if (openingBracketIndex === -1) return [];
+  const closingBracketIndex = content.indexOf("]", openingBracketIndex);
+  if (closingBracketIndex === -1) return [];
+  const tagsBlock = content.slice(openingBracketIndex + 1, closingBracketIndex);
+  const labels = /* @__PURE__ */ new Set();
+  const tagRegex = /['"`]([^'"`]+)['"`]/g;
+  let match;
+  while ((match = tagRegex.exec(tagsBlock)) !== null) {
+    const label = match[1].trim();
+    if (label) labels.add(label);
+  }
+  return Array.from(labels);
+}
+function extractMetaArgs(content) {
+  const metaDefaultIndex = content.indexOf("export default");
+  if (metaDefaultIndex === -1) return void 0;
+  const metaSection = content.slice(0, metaDefaultIndex);
+  const argsKeyIndex = metaSection.lastIndexOf("args:");
+  if (argsKeyIndex !== -1) {
+    return extractArgsFromPosition(content, argsKeyIndex);
+  }
+  const afterExport = content.slice(metaDefaultIndex + "export default".length);
+  const trimmed = afterExport.trimStart();
+  if (!trimmed.startsWith("{")) return void 0;
+  const blockStart = content.indexOf("{", metaDefaultIndex);
+  const blockEnd = findMatchingBrace(content, blockStart);
+  if (blockEnd === -1) return void 0;
+  const metaBlock = content.slice(blockStart + 1, blockEnd);
+  const inlineArgsIndex = metaBlock.indexOf("args:");
+  if (inlineArgsIndex === -1) return void 0;
+  return extractArgsFromPosition(content, blockStart + 1 + inlineArgsIndex);
+}
+function extractArgsFromPosition(content, argsKeyIndex) {
+  const colonIndex = content.indexOf(":", argsKeyIndex + 4);
+  if (colonIndex === -1) {
+    return void 0;
+  }
+  const openingBraceIndex = content.indexOf("{", colonIndex);
+  if (openingBraceIndex === -1) {
+    return void 0;
+  }
+  const closingBraceIndex = findMatchingBrace(content, openingBraceIndex);
+  if (closingBraceIndex === -1) {
+    return void 0;
+  }
+  const argsBlock = content.slice(openingBraceIndex + 1, closingBraceIndex);
+  const args = {};
+  const kvRegex = /(\w+)\s*:\s*(?:'([^']*)'|"([^"]*)"|(\d+(?:\.\d+)?)|(\btrue\b|\bfalse\b))/g;
+  let match;
+  while ((match = kvRegex.exec(argsBlock)) !== null) {
+    const key = match[1];
+    if (match[2] !== void 0) {
+      args[key] = match[2];
+    } else if (match[3] !== void 0) {
+      args[key] = match[3];
+    } else if (match[4] !== void 0) {
+      args[key] = Number(match[4]);
+    } else if (match[5] !== void 0) {
+      args[key] = match[5] === "true";
+    }
+  }
+  return Object.keys(args).length > 0 ? args : void 0;
+}
+function readStoriesFile(filePath) {
+  const content = readTextFile(filePath);
+  if (!content) {
+    return null;
+  }
+  const title = extractTitle(content);
+  const labels = extractLabels(content);
+  const argTypes = extractArgTypes(content);
+  const templateSources = extractTemplateSource(content);
+  const storyTemplateMap = extractStories(content);
+  const examples = [];
+  const usageGuidance = [];
+  const coveredStories = /* @__PURE__ */ new Set();
+  for (const [storyName, templateVar] of storyTemplateMap) {
+    const code = templateSources.get(templateVar);
+    const description = extractStoryJSDoc(content, storyName);
+    if (code) {
+      examples.push({
+        name: storyName,
+        description,
+        code
+      });
+      coveredStories.add(storyName);
+    }
+    if (description) {
+      usageGuidance.push(description);
+    }
+  }
+  const inlineExamples = extractInlineRenderTemplates(content);
+  for (const example of inlineExamples) {
+    if (!coveredStories.has(example.name)) {
+      const description = extractStoryJSDoc(content, example.name);
+      examples.push({ ...example, description });
+      if (description) {
+        usageGuidance.push(description);
+      }
+    }
+  }
+  const defaultArgs = extractMetaArgs(content);
+  return {
+    title,
+    labels,
+    examples,
+    argTypes,
+    usageGuidance,
+    defaultArgs
+  };
+}
+function readComponentStories(componentDir) {
+  const componentName = path.basename(componentDir);
+  const storiesPath = path.join(componentDir, `${componentName}.stories.ts`);
+  return readStoriesFile(storiesPath);
+}
+
 // src/readers/types-reader.ts
+import * as path2 from "node:path";
 var TYPE_OR_INTERFACE = "(?:interface|type)";
 function parseJSDoc(comment) {
   const lines = comment.replace(/\/\*\*|\*\/|\*/g, "").split("\n").map((line) => line.trim()).filter(Boolean);
@@ -21168,7 +21425,7 @@ function readTypesFile(filePath, componentName) {
   if (!content) {
     return null;
   }
-  const resolvedName = componentName || path.basename(path.dirname(filePath));
+  const resolvedName = componentName || path2.basename(path2.dirname(filePath));
   const exactRegex = new RegExp(
     `export\\s+${TYPE_OR_INTERFACE}\\s+(${resolvedName}Props)\\b`
   );
@@ -21201,28 +21458,28 @@ function readTypesFile(filePath, componentName) {
   };
 }
 function readComponentTypes(componentDir) {
-  const typesPath = path.join(componentDir, "types.ts");
-  return readTypesFile(typesPath, path.basename(componentDir));
+  const typesPath = path2.join(componentDir, "types.ts");
+  return readTypesFile(typesPath, path2.basename(componentDir));
 }
 
 // src/constants.ts
 import * as fs3 from "node:fs";
-import * as path3 from "node:path";
+import * as path4 from "node:path";
 
 // src/utils/paths.ts
 import * as fs2 from "node:fs";
-import * as path2 from "node:path";
+import * as path3 from "node:path";
 import { fileURLToPath } from "node:url";
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = path2.dirname(__filename);
+var __dirname = path3.dirname(__filename);
 function findInMonorepo(startDir, packageName) {
   let current = startDir;
   for (let i = 0; i < 10; i++) {
-    const candidate = path2.join(current, "packages", packageName);
-    if (fs2.existsSync(path2.join(candidate, "package.json"))) {
+    const candidate = path3.join(current, "packages", packageName);
+    if (fs2.existsSync(path3.join(candidate, "package.json"))) {
       return candidate;
     }
-    const parent = path2.dirname(current);
+    const parent = path3.dirname(current);
     if (parent === current) break;
     current = parent;
   }
@@ -21234,12 +21491,12 @@ function resolveWorkspacePackage(packageName, scope = "@aleph-alpha") {
   const fromCwd = findInMonorepo(process.cwd(), packageName);
   if (fromCwd) return fromCwd;
   const nodeModulesCandidates = [
-    path2.resolve(__dirname, `../../${scope}/${packageName}`),
-    path2.resolve(__dirname, `../../../${scope}/${packageName}`),
-    path2.join(process.cwd(), `node_modules/${scope}/${packageName}`)
+    path3.resolve(__dirname, `../../${scope}/${packageName}`),
+    path3.resolve(__dirname, `../../../${scope}/${packageName}`),
+    path3.join(process.cwd(), `node_modules/${scope}/${packageName}`)
   ];
   for (const pkgPath of nodeModulesCandidates) {
-    if (fs2.existsSync(path2.join(pkgPath, "package.json"))) {
+    if (fs2.existsSync(path3.join(pkgPath, "package.json"))) {
       return pkgPath;
     }
   }
@@ -21255,7 +21512,7 @@ function getLibraryRootPath() {
 }
 function getLibrarySourcePath() {
   const uiLibraryRoot = findUiLibraryRoot();
-  const srcPath = path2.join(uiLibraryRoot, "src");
+  const srcPath = path3.join(uiLibraryRoot, "src");
   if (fs2.existsSync(srcPath)) {
     return srcPath;
   }
@@ -21270,7 +21527,7 @@ function findChatKitRoot() {
 }
 function getChatKitSourcePath() {
   const chatKitRoot = findChatKitRoot();
-  const srcPath = path2.join(chatKitRoot, "src");
+  const srcPath = path3.join(chatKitRoot, "src");
   if (fs2.existsSync(srcPath)) {
     return srcPath;
   }
@@ -21281,20 +21538,20 @@ function getChatKitSourcePath() {
 function getMcpDirPath() {
   const possiblePaths = [
     // Bundled: from dist/utils -> package root
-    path2.resolve(__dirname, "../.."),
+    path3.resolve(__dirname, "../.."),
     // Fallback: current directory
     __dirname
   ];
   for (const mcpPath of possiblePaths) {
-    if (fs2.existsSync(path2.join(mcpPath, "components-meta.json"))) {
+    if (fs2.existsSync(path3.join(mcpPath, "components-meta.json"))) {
       return mcpPath;
     }
   }
-  return path2.resolve(__dirname, "../..");
+  return path3.resolve(__dirname, "../..");
 }
 function getPackageRoot() {
-  const pkgRoot = path2.resolve(__dirname, "../..");
-  if (fs2.existsSync(path2.join(pkgRoot, "package.json"))) {
+  const pkgRoot = path3.resolve(__dirname, "../..");
+  if (fs2.existsSync(path3.join(pkgRoot, "package.json"))) {
     return pkgRoot;
   }
   return process.cwd();
@@ -21317,7 +21574,7 @@ function detectCategoryDirs() {
     (entry) => !entry.name.startsWith(".") && entry.name !== "node_modules"
   ).filter((entry) => {
     try {
-      const dirPath = path3.join(srcPath, entry.name);
+      const dirPath = path4.join(srcPath, entry.name);
       const subEntries = fs3.readdirSync(dirPath, { withFileTypes: true });
       return subEntries.some(
         (sub) => sub.isDirectory() && sub.name.startsWith(COMPONENT_PREFIX)
@@ -21359,8 +21616,8 @@ function detectChatKitCategoryDirs() {
       if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
       if (entry.name.startsWith(CHAT_KIT_PREFIX)) continue;
       walk(
-        path3.join(dir, entry.name),
-        relative ? path3.join(relative, entry.name) : entry.name,
+        path4.join(dir, entry.name),
+        relative ? path4.join(relative, entry.name) : entry.name,
         depth + 1
       );
     }
@@ -21392,7 +21649,7 @@ var cachedMeta = null;
 function loadComponentsMeta() {
   if (cachedMeta) return cachedMeta;
   const mcpDir = getMcpDirPath();
-  const metaPath = path3.join(mcpDir, "components-meta.json");
+  const metaPath = path4.join(mcpDir, "components-meta.json");
   cachedMeta = readJsonFile(metaPath) ?? {};
   return cachedMeta;
 }
@@ -21400,13 +21657,13 @@ var cachedChatKitMeta = null;
 function loadChatKitComponentsMeta() {
   if (cachedChatKitMeta) return cachedChatKitMeta;
   const mcpDir = getMcpDirPath();
-  const metaPath = path3.join(mcpDir, "chat-kit-components-meta.json");
+  const metaPath = path4.join(mcpDir, "chat-kit-components-meta.json");
   cachedChatKitMeta = readJsonFile(metaPath) ?? {};
   return cachedChatKitMeta;
 }
 function getPackageVersion() {
   const pkgRoot = getPackageRoot();
-  const pkgPath = path3.join(pkgRoot, "package.json");
+  const pkgPath = path4.join(pkgRoot, "package.json");
   const pkg = readJsonFile(pkgPath);
   return pkg?.version ?? "0.0.0";
 }
@@ -21442,7 +21699,7 @@ function scanCategoryDirectory(categoryDir) {
   return entries.filter((entry) => entry.isDirectory()).filter((entry) => isComponentDirectory(entry.name)).filter((entry) => !INTERNAL_DIRS.includes(entry.name)).map((entry) => {
     const componentName = entry.name;
     const componentMeta = meta[componentName];
-    const componentDir = path4.join(categoryDir, componentName);
+    const componentDir = path5.join(categoryDir, componentName);
     return {
       name: componentName,
       category: componentMeta?.category ?? "Uncategorized",
@@ -21450,18 +21707,19 @@ function scanCategoryDirectory(categoryDir) {
         componentName,
         componentMeta,
         componentDir
-      )
+      ),
+      labels: readComponentStories(componentDir)?.labels || []
     };
   });
 }
 function matchesFilter(component, filter) {
   const filterLower = filter.toLowerCase();
-  return component.name.toLowerCase().includes(filterLower) || component.category.toLowerCase().includes(filterLower) || component.description.toLowerCase().includes(filterLower);
+  return component.name.toLowerCase().includes(filterLower) || component.category.toLowerCase().includes(filterLower) || component.description.toLowerCase().includes(filterLower) || component.labels.some((label) => label.toLowerCase().includes(filterLower));
 }
 function listComponents(filter) {
   const srcPath = getLibrarySourcePath();
   const allComponents = getCategoryDirs().flatMap((category) => {
-    const categoryPath = path4.join(srcPath, category);
+    const categoryPath = path5.join(srcPath, category);
     return scanCategoryDirectory(categoryPath);
   });
   allComponents.sort((a, b) => a.name.localeCompare(b.name));
@@ -21469,250 +21727,21 @@ function listComponents(filter) {
 }
 
 // src/tools/get-docs.ts
-import * as path6 from "node:path";
-
-// src/readers/stories-reader.ts
-import * as path5 from "node:path";
-function extractStoryJSDoc(content, storyName) {
-  const exportRegex = new RegExp(`export\\s+const\\s+${storyName}\\s*:`);
-  const exportMatch = content.match(exportRegex);
-  if (!exportMatch || exportMatch.index === void 0) return "";
-  const beforeExport = content.substring(0, exportMatch.index);
-  const lastJsDocEnd = beforeExport.lastIndexOf("*/");
-  if (lastJsDocEnd === -1) return "";
-  const between = beforeExport.substring(lastJsDocEnd + 2);
-  if (between.trim() !== "") return "";
-  const lastJsDocStart = beforeExport.lastIndexOf("/**");
-  if (lastJsDocStart === -1 || lastJsDocStart > lastJsDocEnd) return "";
-  const jsdoc = beforeExport.substring(lastJsDocStart + 3, lastJsDocEnd);
-  return jsdoc.split("\n").map((line) => line.replace(/^\s*\*\s?/, "").trim()).filter((line) => line && !line.startsWith("@")).join(" ").trim();
-}
-function extractTemplateSource(content) {
-  const templates = /* @__PURE__ */ new Map();
-  const templateRegex = /const\s+(\w+TemplateSource)\s*=\s*`([\s\S]*?)`;/g;
-  let match;
-  while ((match = templateRegex.exec(content)) !== null) {
-    const varName = match[1];
-    const code = match[2].trim();
-    templates.set(varName, code);
-  }
-  return templates;
-}
-function extractStories(content) {
-  const stories = /* @__PURE__ */ new Map();
-  const storyExportRegex = /export\s+const\s+(\w+):\s*Story\s*=/g;
-  let match;
-  while ((match = storyExportRegex.exec(content)) !== null) {
-    const storyName = match[1];
-    if (storyName === "default") continue;
-    const storyStart = match.index;
-    const remainingContent = content.substring(storyStart);
-    const templateRefMatch = remainingContent.match(
-      /code:\s*(\w+TemplateSource)/
-    );
-    if (templateRefMatch) {
-      stories.set(storyName, templateRefMatch[1]);
-    }
-  }
-  return stories;
-}
-function extractInlineRenderTemplates(content) {
-  const examples = [];
-  const storyExportRegex = /export\s+const\s+(\w+):\s*Story\s*=/g;
-  let match;
-  while ((match = storyExportRegex.exec(content)) !== null) {
-    const storyName = match[1];
-    if (storyName === "default") continue;
-    const afterEquals = content.indexOf("{", match.index + match[0].length);
-    if (afterEquals === -1) continue;
-    const closingBrace = findMatchingBrace(content, afterEquals);
-    if (closingBrace === -1) continue;
-    const storyBlock = content.slice(afterEquals, closingBrace + 1);
-    if (!storyBlock.includes("template:")) continue;
-    const templateMatch = storyBlock.match(/template:\s*`([\s\S]*?)`/);
-    if (!templateMatch) continue;
-    const template = templateMatch[1].trim();
-    if (!template) continue;
-    const componentsMatch = storyBlock.match(/components:\s*\{([^}]+)\}/);
-    const componentNames = componentsMatch ? componentsMatch[1].split(",").map((c) => c.trim()).filter(Boolean) : [];
-    const imports = componentNames.length > 0 ? `<script setup>
-// Components: ${componentNames.join(", ")}
-</script>
+import * as path7 from "node:path";
 
-` : "";
-    examples.push({
-      name: storyName,
-      description: "",
-      code: `${imports}<template>
-${template}
-</template>`
-    });
-  }
-  return examples;
-}
-function extractArgTypes(content) {
-  const argTypes = [];
-  const argTypesKeyIndex = content.indexOf("argTypes");
-  if (argTypesKeyIndex === -1) {
-    return argTypes;
-  }
-  const colonIndex = content.indexOf(":", argTypesKeyIndex);
-  if (colonIndex === -1) {
-    return argTypes;
-  }
-  const openingBraceIndex = content.indexOf("{", colonIndex);
-  if (openingBraceIndex === -1) {
-    return argTypes;
-  }
-  const closingBraceIndex = findMatchingBrace(content, openingBraceIndex);
-  if (closingBraceIndex === -1) {
-    return argTypes;
-  }
-  const argTypesBlock = content.slice(openingBraceIndex + 1, closingBraceIndex);
-  let index = 0;
-  while (index < argTypesBlock.length) {
-    const propNameMatch = argTypesBlock.slice(index).match(/^\s*(\w+)\s*:\s*\{/);
-    if (!propNameMatch) {
-      const nextComma = argTypesBlock.indexOf(",", index);
-      if (nextComma === -1) break;
-      index = nextComma + 1;
-      continue;
-    }
-    const propName = propNameMatch[1];
-    const propStartIndex = index + propNameMatch[0].length - 1;
-    const propEndIndex = findMatchingBrace(argTypesBlock, propStartIndex);
-    if (propEndIndex === -1) break;
-    const propBlock = argTypesBlock.slice(propStartIndex + 1, propEndIndex);
-    const descMatch = propBlock.match(/description:\s*['"](.+?)['"]\s*[,}]/s);
-    const description = descMatch ? descMatch[1].replace(/\\(['"])/g, "$1") : "";
-    const controlMatch = propBlock.match(/control:\s*['"]?(\w+)['"]?/);
-    const control = controlMatch ? controlMatch[1] : void 0;
-    const optionsMatch = propBlock.match(/options:\s*\[([\s\S]*?)\]/);
-    let options;
-    if (optionsMatch) {
-      options = optionsMatch[1].split(",").map((opt) => opt.trim().replace(/['"]/g, "")).filter(Boolean);
-    }
-    argTypes.push({
-      name: propName,
-      description,
-      control,
-      options
-    });
-    index = propEndIndex + 1;
-  }
-  return argTypes;
-}
-function extractTitle(content) {
-  const titleMatch = content.match(/title:\s*['"]([^'"]+)['"]/);
-  return titleMatch ? titleMatch[1] : "";
-}
-function extractMetaArgs(content) {
-  const metaDefaultIndex = content.indexOf("export default");
-  if (metaDefaultIndex === -1) return void 0;
-  const metaSection = content.slice(0, metaDefaultIndex);
-  const argsKeyIndex = metaSection.lastIndexOf("args:");
-  if (argsKeyIndex !== -1) {
-    return extractArgsFromPosition(content, argsKeyIndex);
-  }
-  const afterExport = content.slice(metaDefaultIndex + "export default".length);
-  const trimmed = afterExport.trimStart();
-  if (!trimmed.startsWith("{")) return void 0;
-  const blockStart = content.indexOf("{", metaDefaultIndex);
-  const blockEnd = findMatchingBrace(content, blockStart);
-  if (blockEnd === -1) return void 0;
-  const metaBlock = content.slice(blockStart + 1, blockEnd);
-  const inlineArgsIndex = metaBlock.indexOf("args:");
-  if (inlineArgsIndex === -1) return void 0;
-  return extractArgsFromPosition(content, blockStart + 1 + inlineArgsIndex);
-}
-function extractArgsFromPosition(content, argsKeyIndex) {
-  const colonIndex = content.indexOf(":", argsKeyIndex + 4);
-  if (colonIndex === -1) {
-    return void 0;
-  }
-  const openingBraceIndex = content.indexOf("{", colonIndex);
-  if (openingBraceIndex === -1) {
-    return void 0;
-  }
-  const closingBraceIndex = findMatchingBrace(content, openingBraceIndex);
-  if (closingBraceIndex === -1) {
-    return void 0;
-  }
-  const argsBlock = content.slice(openingBraceIndex + 1, closingBraceIndex);
-  const args = {};
-  const kvRegex = /(\w+)\s*:\s*(?:'([^']*)'|"([^"]*)"|(\d+(?:\.\d+)?)|(\btrue\b|\bfalse\b))/g;
-  let match;
-  while ((match = kvRegex.exec(argsBlock)) !== null) {
-    const key = match[1];
-    if (match[2] !== void 0) {
-      args[key] = match[2];
-    } else if (match[3] !== void 0) {
-      args[key] = match[3];
-    } else if (match[4] !== void 0) {
-      args[key] = Number(match[4]);
-    } else if (match[5] !== void 0) {
-      args[key] = match[5] === "true";
-    }
-  }
-  return Object.keys(args).length > 0 ? args : void 0;
-}
-function readStoriesFile(filePath) {
-  const content = readTextFile(filePath);
-  if (!content) {
-    return null;
-  }
-  const title = extractTitle(content);
-  const argTypes = extractArgTypes(content);
-  const templateSources = extractTemplateSource(content);
-  const storyTemplateMap = extractStories(content);
-  const examples = [];
-  const usageGuidance = [];
-  const coveredStories = /* @__PURE__ */ new Set();
-  for (const [storyName, templateVar] of storyTemplateMap) {
-    const code = templateSources.get(templateVar);
-    const description = extractStoryJSDoc(content, storyName);
-    if (code) {
-      examples.push({
-        name: storyName,
-        description,
-        code
-      });
-      coveredStories.add(storyName);
-    }
-    if (description) {
-      usageGuidance.push(description);
-    }
-  }
-  const inlineExamples = extractInlineRenderTemplates(content);
-  for (const example of inlineExamples) {
-    if (!coveredStories.has(example.name)) {
-      const description = extractStoryJSDoc(content, example.name);
-      examples.push({ ...example, description });
-      if (description) {
-        usageGuidance.push(description);
-      }
-    }
-  }
-  const defaultArgs = extractMetaArgs(content);
-  return {
-    title,
-    examples,
-    argTypes,
-    usageGuidance,
-    defaultArgs
-  };
-}
-function readComponentStories(componentDir) {
-  const componentName = path5.basename(componentDir);
-  const storiesPath = path5.join(componentDir, `${componentName}.stories.ts`);
-  return readStoriesFile(storiesPath);
+// src/readers/component-docs-reader.ts
+import * as path6 from "node:path";
+function readComponentSupplementalDocs(componentDir) {
+  return readJsonFile(
+    path6.join(componentDir, "mcp-docs.json")
+  );
 }
 
 // src/tools/get-docs.ts
 function findComponentDirectory(componentName) {
   const srcPath = getLibrarySourcePath();
   for (const category of getCategoryDirs()) {
-    const componentDir = path6.join(srcPath, category, componentName);
+    const componentDir = path7.join(srcPath, category, componentName);
     if (isDirectory(componentDir)) {
       return componentDir;
     }
@@ -21748,15 +21777,17 @@ function getComponentDocs(componentName) {
   const props = typeInfo?.props || [];
   let description = typeInfo?.description || "";
   const storiesInfo = readComponentStories(componentDir);
+  const labels = storiesInfo?.labels || [];
   const examples = storiesInfo?.examples || [];
   const usageGuidance = storiesInfo?.usageGuidance || [];
+  const supplementalDocs = readComponentSupplementalDocs(componentDir);
   if (!description && usageGuidance.length > 0) {
     description = usageGuidance[0];
   }
   if (!description) {
     description = `${normalizedName} component from @aleph-alpha/ui-library`;
   }
-  const indexPath = path6.join(componentDir, "index.ts");
+  const indexPath = path7.join(componentDir, "index.ts");
   const subComponents = readTextFile(indexPath) ? extractSubComponents(indexPath, normalizedName) : void 0;
   if (storiesInfo?.argTypes) {
     for (const argType of storiesInfo.argTypes) {
@@ -21769,20 +21800,22 @@ function getComponentDocs(componentName) {
   return {
     name: normalizedName,
     description,
+    labels,
     props,
     examples,
     usageGuidance: [...new Set(usageGuidance)],
     // Remove duplicates
+    supplementalDocs: supplementalDocs ?? void 0,
     subComponents: subComponents && subComponents.length > 0 ? subComponents : void 0,
     defaultArgs: storiesInfo?.defaultArgs
   };
 }
 
 // src/tools/get-setup.ts
-import * as path7 from "node:path";
+import * as path8 from "node:path";
 function getSetupGuide() {
   const libraryRoot = getLibraryRootPath();
-  const quickStartPath = path7.join(
+  const quickStartPath = path8.join(
     libraryRoot,
     "docs",
     "public-docs",
@@ -21792,7 +21825,7 @@ function getSetupGuide() {
   if (quickStart) {
     return quickStart;
   }
-  const readmePath = path7.join(libraryRoot, "README.md");
+  const readmePath = path8.join(libraryRoot, "README.md");
   const readme = readTextFile(readmePath);
   if (readme) {
     return readme;
@@ -21802,10 +21835,10 @@ function getSetupGuide() {
 
 // src/tools/list-chat-kit-components.ts
 import * as fs5 from "node:fs";
-import * as path9 from "node:path";
+import * as path10 from "node:path";
 
 // src/readers/chat-kit-types-reader.ts
-import * as path8 from "node:path";
+import * as path9 from "node:path";
 var TYPE_OR_INTERFACE2 = "(?:interface|type)";
 function parseJSDoc2(comment) {
   const lines = comment.replace(/\/\*\*|\*\/|\*/g, "").split("\n").map((line) => line.trim()).filter(Boolean);
@@ -21939,7 +21972,7 @@ function readChatKitTypesFile(filePath, componentName) {
   if (!content) {
     return null;
   }
-  const resolvedName = componentName || path8.basename(path8.dirname(filePath));
+  const resolvedName = componentName || path9.basename(path9.dirname(filePath));
   const exactRegex = new RegExp(
     `export\\s+${TYPE_OR_INTERFACE2}\\s+(${resolvedName}Props)\\b`
   );
@@ -21972,8 +22005,8 @@ function readChatKitTypesFile(filePath, componentName) {
   };
 }
 function readChatKitComponentTypes(componentDir) {
-  const typesPath = path8.join(componentDir, "types.ts");
-  return readChatKitTypesFile(typesPath, path8.basename(componentDir));
+  const typesPath = path9.join(componentDir, "types.ts");
+  return readChatKitTypesFile(typesPath, path9.basename(componentDir));
 }
 
 // src/tools/list-chat-kit-components.ts
@@ -21994,10 +22027,10 @@ function listChatKitComponents(filter) {
   const srcPath = getChatKitSourcePath();
   const meta = loadChatKitComponentsMeta();
   const allComponents = getChatKitCategoryDirs().flatMap((category) => {
-    const categoryPath = path9.join(srcPath, category);
+    const categoryPath = path10.join(srcPath, category);
     if (!isDirectory(categoryPath)) return [];
     return fs5.readdirSync(categoryPath, { withFileTypes: true }).filter((e) => e.isDirectory() && isChatKitComponent(e.name)).map((e) => {
-      const componentDir = path9.join(categoryPath, e.name);
+      const componentDir = path10.join(categoryPath, e.name);
       const componentMeta = meta[e.name];
       return {
         name: e.name,
@@ -22011,14 +22044,14 @@ function listChatKitComponents(filter) {
 }
 
 // src/tools/get-chat-kit-docs.ts
-import * as path10 from "node:path";
+import * as path11 from "node:path";
 function normalizeChatKitName(name) {
   return name.startsWith(CHAT_KIT_PREFIX) ? name : `${CHAT_KIT_PREFIX}${name}`;
 }
 function findChatKitComponentDir(componentName) {
   const srcPath = getChatKitSourcePath();
   for (const category of getChatKitCategoryDirs()) {
-    const dir = path10.join(srcPath, category, componentName);
+    const dir = path11.join(srcPath, category, componentName);
     if (isDirectory(dir)) return dir;
   }
   return null;
@@ -22056,7 +22089,7 @@ function getChatKitComponentDocs(componentName) {
   if (!description) {
     description = `${name} component from @aleph-alpha/chat-kit`;
   }
-  const indexPath = path10.join(componentDir, "index.ts");
+  const indexPath = path11.join(componentDir, "index.ts");
   const subComponents = readTextFile(indexPath) ? extractSubComponents2(indexPath, name) : void 0;
   if (storiesInfo?.argTypes) {
     for (const argType of storiesInfo.argTypes) {
@@ -22069,6 +22102,7 @@ function getChatKitComponentDocs(componentName) {
   return {
     name,
     description,
+    labels: [],
     props,
     examples,
     usageGuidance: [...new Set(usageGuidance)],
@@ -22100,6 +22134,12 @@ function formatProp(prop) {
 }
 function formatComponentDocs(docs) {
   const sections = [`# ${docs.name}`, docs.description, ""];
+  if (docs.labels.length > 0) {
+    sections.push(
+      `**Labels:** ${docs.labels.map((label) => `\`${label}\``).join(", ")}`,
+      ""
+    );
+  }
   if (docs.props.length > 0) {
     sections.push("## Props", "");
     docs.props.forEach((prop) => sections.push(...formatProp(prop)));
@@ -22137,6 +22177,22 @@ function formatComponentDocs(docs) {
     docs.usageGuidance.forEach((guidance) => sections.push(`- ${guidance}`));
     sections.push("");
   }
+  if (docs.supplementalDocs?.designNotes) {
+    sections.push(
+      ...formatSupplementalDocsSection(
+        "Design Notes",
+        docs.supplementalDocs.designNotes
+      )
+    );
+  }
+  if (docs.supplementalDocs?.accessibility) {
+    sections.push(
+      ...formatSupplementalDocsSection(
+        "Accessibility",
+        docs.supplementalDocs.accessibility
+      )
+    );
+  }
   if (docs.examples.length > 0) {
     sections.push("## Examples", "");
     docs.examples.forEach((example) => {
@@ -22149,6 +22205,37 @@ function formatComponentDocs(docs) {
   }
   return sections.join("\n").trim();
 }
+function formatSupplementalDocsSection(heading, section) {
+  if (!section) return [];
+  const lines = [`## ${heading}`, ""];
+  lines.push(`### ${section.title}`, "");
+  if (section.summary) {
+    lines.push(section.summary, "");
+  }
+  for (const block of section.sections ?? []) {
+    lines.push(`#### ${block.title}`, "");
+    if (block.content) {
+      lines.push(block.content, "");
+    }
+    for (const item of block.items ?? []) {
+      lines.push(`- ${item}`);
+    }
+    if (block.items?.length) {
+      lines.push("");
+    }
+  }
+  if (section.do?.length) {
+    lines.push("#### Do", "");
+    section.do.forEach((item) => lines.push(`- ${item}`));
+    lines.push("");
+  }
+  if (section.dont?.length) {
+    lines.push("#### Don't", "");
+    section.dont.forEach((item) => lines.push(`- ${item}`));
+    lines.push("");
+  }
+  return lines;
+}
 async function startServer() {
   const server = new McpServer({
     name: "ui-library",
@@ -22179,7 +22266,8 @@ async function startServer() {
         Object.entries(grouped).forEach(([category, comps]) => {
           sections.push(`## ${category}`, "");
           comps.forEach((comp) => {
-            sections.push(`- **${comp.name}**: ${comp.description}`);
+            const labels = comp.labels.length > 0 ? ` [${comp.labels.join(", ")}]` : "";
+            sections.push(`- **${comp.name}**${labels}: ${comp.description}`);
           });
           sections.push("");
         });