@aleph-alpha/lib-mcp 1.7.0 → 2.0.0

package/dist/server.js

@@ -3221,8 +3221,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path8) {
-      let input = path8;
+    function removeDotSegments(path11) {
+      let input = path11;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3421,8 +3421,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path8, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path8 && path8 !== "/" ? path8 : void 0;
+        const [path11, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path11 && path11 !== "/" ? path11 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -6784,12 +6784,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs5, exportName) {
+    function addFormats(ajv, list, fs6, exportName) {
       var _a;
       var _b;
       (_a = (_b = ajv.opts.code).formats) !== null && _a !== void 0 ? _a : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv.addFormat(f, fs5[f]);
+        ajv.addFormat(f, fs6[f]);
     }
     module.exports = exports = formatsPlugin;
     Object.defineProperty(exports, "__esModule", { value: true });
@@ -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: path8, errorMaps, issueData } = params;
-  const fullPath = [...path8, ...issueData.path || []];
+  const { data, path: path11, errorMaps, issueData } = params;
+  const fullPath = [...path11, ...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, path8, key) {
+  constructor(parent, value, path11, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path8;
+    this._path = path11;
     this._key = key;
   }
   get path() {
@@ -10827,14 +10827,14 @@ var ostring = () => stringType().optional();
 var onumber = () => numberType().optional();
 var oboolean = () => booleanType().optional();
 var coerce = {
-  string: (arg) => ZodString.create({ ...arg, coerce: true }),
-  number: (arg) => ZodNumber.create({ ...arg, coerce: true }),
-  boolean: (arg) => ZodBoolean.create({
+  string: ((arg) => ZodString.create({ ...arg, coerce: true })),
+  number: ((arg) => ZodNumber.create({ ...arg, coerce: true })),
+  boolean: ((arg) => ZodBoolean.create({
     ...arg,
     coerce: true
-  }),
-  bigint: (arg) => ZodBigInt.create({ ...arg, coerce: true }),
-  date: (arg) => ZodDate.create({ ...arg, coerce: true })
+  })),
+  bigint: ((arg) => ZodBigInt.create({ ...arg, coerce: true })),
+  date: ((arg) => ZodDate.create({ ...arg, coerce: true }))
 };
 var NEVER = INVALID;
 
@@ -11034,10 +11034,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path8) {
-  if (!path8)
+function getElementAtPath(obj, path11) {
+  if (!path11)
     return obj;
-  return path8.reduce((acc, key) => acc?.[key], obj);
+  return path11.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(path8, issues) {
+function prefixIssues(path11, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path8);
+    iss.path.unshift(path11);
     return iss;
   });
 }
@@ -14668,10 +14668,10 @@ var ZodMiniType = /* @__PURE__ */ $constructor("ZodMiniType", (inst, def) => {
   };
   inst.clone = (_def, params) => clone(inst, _def, params);
   inst.brand = () => inst;
-  inst.register = (reg, meta) => {
+  inst.register = ((reg, meta) => {
     reg.add(inst, meta);
     return inst;
-  };
+  });
 });
 var ZodMiniObject = /* @__PURE__ */ $constructor("ZodMiniObject", (inst, def) => {
   $ZodObject.init(inst, def);
@@ -14934,10 +14934,10 @@ var ZodType2 = /* @__PURE__ */ $constructor("ZodType", (inst, def) => {
   };
   inst.clone = (def2, params) => clone(inst, def2, params);
   inst.brand = () => inst;
-  inst.register = (reg, meta) => {
+  inst.register = ((reg, meta) => {
     reg.add(inst, meta);
     return inst;
-  };
+  });
   inst.parse = (data, params) => parse2(inst, data, params, { callee: inst.parse });
   inst.safeParse = (data, params) => safeParse3(inst, data, params);
   inst.parseAsync = async (data, params) => parseAsync2(inst, data, params, { callee: inst.parseAsync });
@@ -16894,11 +16894,13 @@ function assertCompleteRequestPrompt(request) {
   if (request.params.ref.type !== "ref/prompt") {
     throw new TypeError(`Expected CompleteRequestPrompt, but got ${request.params.ref.type}`);
   }
+  void request;
 }
 function assertCompleteRequestResourceTemplate(request) {
   if (request.params.ref.type !== "ref/resource") {
     throw new TypeError(`Expected CompleteRequestResourceTemplate, but got ${request.params.ref.type}`);
   }
+  void request;
 }
 var CompleteResultSchema = ResultSchema.extend({
   completion: looseObject({
@@ -21074,7 +21076,7 @@ function extractType(text2, startIndex) {
 function parseInterface(content, interfaceName) {
   const props = [];
   const interfaceRegex = new RegExp(
-    `(?:export\\s+)?${TYPE_OR_INTERFACE}\\s+${interfaceName}\\s*(?:extends\\s+[^{]+)?(?:=\\s*)?\\{([\\s\\S]*?)\\n\\}`,
+    `(?:export\\s+)?${TYPE_OR_INTERFACE}\\s+${interfaceName}\\s*(?:<(?:\\{[^}]*\\}|[^>])*>)?\\s*(?:extends\\s+[^{]+)?(?:=\\s*)?\\{([\\s\\S]*?)\\n\\}`,
     "m"
   );
   const match = content.match(interfaceRegex);
@@ -21089,7 +21091,10 @@ function parseInterface(content, interfaceName) {
     const propName = propMatch[2];
     const isOptional = !!propMatch[3];
     const typeStartIndex = propMatch.index + propMatch[0].length;
-    const { type: propType, endIndex } = extractType(interfaceBody, typeStartIndex);
+    const { type: propType, endIndex } = extractType(
+      interfaceBody,
+      typeStartIndex
+    );
     propStartRegex.lastIndex = endIndex + 1;
     const jsdoc = parseJSDoc(jsdocComment);
     props.push({
@@ -21106,7 +21111,9 @@ function parseInterface(content, interfaceName) {
 function extractComponentDescription(content, interfaceName) {
   const lines = content.split("\n");
   const interfaceLineIndex = lines.findIndex(
-    (line) => line.match(new RegExp(`export\\s+${TYPE_OR_INTERFACE}\\s+${interfaceName}`))
+    (line) => line.match(
+      new RegExp(`export\\s+${TYPE_OR_INTERFACE}\\s+${interfaceName}`)
+    )
   );
   if (interfaceLineIndex === -1) {
     return "";
@@ -21132,7 +21139,9 @@ function extractComponentDescription(content, interfaceName) {
   return "";
 }
 function resolveUnionOrIntersectionProps(content, typeName) {
-  const typeDefRegex = new RegExp(`export\\s+type\\s+${typeName}\\s*=\\s*([^;]+)`);
+  const typeDefRegex = new RegExp(
+    `export\\s+type\\s+${typeName}\\s*=\\s*([^;]+)`
+  );
   const match = content.match(typeDefRegex);
   if (!match) return [];
   const referencedTypes = match[1].split(/[|&]/).map((t) => t.trim()).filter((t) => t.endsWith("Props"));
@@ -21160,7 +21169,9 @@ function readTypesFile(filePath, componentName) {
     return null;
   }
   const resolvedName = componentName || path.basename(path.dirname(filePath));
-  const exactRegex = new RegExp(`export\\s+${TYPE_OR_INTERFACE}\\s+(${resolvedName}Props)\\b`);
+  const exactRegex = new RegExp(
+    `export\\s+${TYPE_OR_INTERFACE}\\s+(${resolvedName}Props)\\b`
+  );
   let propsInterfaceMatch = content.match(exactRegex);
   if (!propsInterfaceMatch) {
     const prefixRegex = new RegExp(
@@ -21204,20 +21215,39 @@ import * as path2 from "node:path";
 import { fileURLToPath } from "node:url";
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = path2.dirname(__filename);
-function findUiLibraryRoot() {
-  const possiblePaths = [
-    // Monorepo development: from packages/lib-mcp/dist/utils -> packages/ui-library
-    path2.resolve(__dirname, "../../../ui-library"),
-    // Installed as dependency: from node_modules/@aleph-alpha/lib-mcp/dist/utils -> node_modules/@aleph-alpha/ui-library
-    path2.resolve(__dirname, "../../@aleph-alpha/ui-library"),
-    // Alternative: resolve from cwd
-    path2.join(process.cwd(), "node_modules/@aleph-alpha/ui-library")
+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"))) {
+      return candidate;
+    }
+    const parent = path2.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return null;
+}
+function resolveWorkspacePackage(packageName, scope = "@aleph-alpha") {
+  const fromDirname = findInMonorepo(__dirname, packageName);
+  if (fromDirname) return fromDirname;
+  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}`)
   ];
-  for (const pkgPath of possiblePaths) {
+  for (const pkgPath of nodeModulesCandidates) {
     if (fs2.existsSync(path2.join(pkgPath, "package.json"))) {
       return pkgPath;
     }
   }
+  return null;
+}
+function findUiLibraryRoot() {
+  const pkgPath = resolveWorkspacePackage("ui-library");
+  if (pkgPath) return pkgPath;
   throw new Error("Could not find @aleph-alpha/ui-library. Is it installed?");
 }
 function getLibraryRootPath() {
@@ -21233,6 +21263,21 @@ function getLibrarySourcePath() {
     "Could not find UI library source directory. Is the package installed correctly?"
   );
 }
+function findChatKitRoot() {
+  const pkgPath = resolveWorkspacePackage("chat-kit");
+  if (pkgPath) return pkgPath;
+  throw new Error("Could not find @aleph-alpha/chat-kit. Is it installed?");
+}
+function getChatKitSourcePath() {
+  const chatKitRoot = findChatKitRoot();
+  const srcPath = path2.join(chatKitRoot, "src");
+  if (fs2.existsSync(srcPath)) {
+    return srcPath;
+  }
+  throw new Error(
+    "Could not find chat-kit source directory. Is the package installed correctly?"
+  );
+}
 function getMcpDirPath() {
   const possiblePaths = [
     // Bundled: from dist/utils -> package root
@@ -21255,6 +21300,12 @@ function getPackageRoot() {
   return process.cwd();
 }
 
+// src/utils/constants.ts
+var COMPONENT_PREFIX = "Ui";
+var CHAT_KIT_PREFIX = "Ck";
+var INTERNAL_DIRS = ["shadcn"];
+var TYPE_SUFFIXES = ["Props", "Variant", "Size"];
+
 // src/constants.ts
 function detectCategoryDirs() {
   const srcPath = getSrcPath();
@@ -21266,7 +21317,7 @@ function detectCategoryDirs() {
     try {
       const dirPath = path3.join(srcPath, entry.name);
       const subEntries = fs3.readdirSync(dirPath, { withFileTypes: true });
-      return subEntries.some((sub) => sub.isDirectory() && sub.name.startsWith("Ui"));
+      return subEntries.some((sub) => sub.isDirectory() && sub.name.startsWith(COMPONENT_PREFIX));
     } catch {
       return false;
     }
@@ -21278,6 +21329,47 @@ function getCategoryDirs() {
   cachedCategoryDirs = detectCategoryDirs();
   return cachedCategoryDirs;
 }
+function detectChatKitCategoryDirs() {
+  const srcPath = getChatKitSrcPath();
+  if (!srcPath || !fs3.existsSync(srcPath)) {
+    return [];
+  }
+  const categories = [];
+  const walk = (dir, relative, depth) => {
+    let entries;
+    try {
+      entries = fs3.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    const hasChatKitSubdirs = entries.some(
+      (sub) => sub.isDirectory() && sub.name.startsWith(CHAT_KIT_PREFIX)
+    );
+    if (hasChatKitSubdirs && relative) {
+      categories.push(relative);
+      return;
+    }
+    if (depth >= 2) return;
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      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,
+        depth + 1
+      );
+    }
+  };
+  walk(srcPath, "", 0);
+  return categories;
+}
+var cachedChatKitCategoryDirs = null;
+function getChatKitCategoryDirs() {
+  if (cachedChatKitCategoryDirs) return cachedChatKitCategoryDirs;
+  cachedChatKitCategoryDirs = detectChatKitCategoryDirs();
+  return cachedChatKitCategoryDirs;
+}
 function getSrcPath() {
   try {
     return getLibrarySourcePath();
@@ -21285,6 +21377,13 @@ function getSrcPath() {
     return null;
   }
 }
+function getChatKitSrcPath() {
+  try {
+    return getChatKitSourcePath();
+  } catch {
+    return null;
+  }
+}
 var cachedMeta = null;
 function loadComponentsMeta() {
   if (cachedMeta) return cachedMeta;
@@ -21293,6 +21392,14 @@ function loadComponentsMeta() {
   cachedMeta = readJsonFile(metaPath) ?? {};
   return cachedMeta;
 }
+var cachedChatKitMeta = null;
+function loadChatKitComponentsMeta() {
+  if (cachedChatKitMeta) return cachedChatKitMeta;
+  const mcpDir = getMcpDirPath();
+  const metaPath = path3.join(mcpDir, "chat-kit-components-meta.json");
+  cachedChatKitMeta = readJsonFile(metaPath) ?? {};
+  return cachedChatKitMeta;
+}
 function getPackageVersion() {
   const pkgRoot = getPackageRoot();
   const pkgPath = path3.join(pkgRoot, "package.json");
@@ -21300,11 +21407,6 @@ function getPackageVersion() {
   return pkg?.version ?? "0.0.0";
 }
 
-// src/utils/constants.ts
-var COMPONENT_PREFIX = "Ui";
-var INTERNAL_DIRS = ["shadcn"];
-var TYPE_SUFFIXES = ["Props", "Variant", "Size"];
-
 // src/utils/component-name.ts
 function normalizeComponentName(name) {
   if (name.startsWith(COMPONENT_PREFIX)) {
@@ -21340,7 +21442,11 @@ function scanCategoryDirectory(categoryDir) {
     return {
       name: componentName,
       category: componentMeta?.category ?? "Uncategorized",
-      description: getComponentDescription(componentName, componentMeta, componentDir)
+      description: getComponentDescription(
+        componentName,
+        componentMeta,
+        componentDir
+      )
     };
   });
 }
@@ -21397,7 +21503,9 @@ function extractStories(content) {
     if (storyName === "default") continue;
     const storyStart = match.index;
     const remainingContent = content.substring(storyStart);
-    const templateRefMatch = remainingContent.match(/code:\s*(\w+TemplateSource)/);
+    const templateRefMatch = remainingContent.match(
+      /code:\s*(\w+TemplateSource)/
+    );
     if (templateRefMatch) {
       stories.set(storyName, templateRefMatch[1]);
     }
@@ -21670,7 +21778,12 @@ function getComponentDocs(componentName) {
 import * as path7 from "node:path";
 function getSetupGuide() {
   const libraryRoot = getLibraryRootPath();
-  const quickStartPath = path7.join(libraryRoot, "docs", "public-docs", "quick-start.md");
+  const quickStartPath = path7.join(
+    libraryRoot,
+    "docs",
+    "public-docs",
+    "quick-start.md"
+  );
   const quickStart = readTextFile(quickStartPath);
   if (quickStart) {
     return quickStart;
@@ -21683,8 +21796,278 @@ function getSetupGuide() {
   return null;
 }
 
+// src/tools/list-chat-kit-components.ts
+import * as fs5 from "node:fs";
+import * as path9 from "node:path";
+
+// src/readers/chat-kit-types-reader.ts
+import * as path8 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);
+  let description = "";
+  let defaultValue;
+  let example;
+  for (const line of lines) {
+    if (line.startsWith("@default")) {
+      defaultValue = line.replace("@default", "").trim().replace(/^['"]|['"]$/g, "");
+    } else if (line.startsWith("@example")) {
+      example = line.replace("@example", "").trim();
+    } else if (!line.startsWith("@")) {
+      description += (description ? " " : "") + line;
+    }
+  }
+  return { description, default: defaultValue, example };
+}
+function extractType2(text2, startIndex) {
+  let depth = 0;
+  let i = startIndex;
+  while (i < text2.length) {
+    const char = text2[i];
+    const prevChar = i > 0 ? text2[i - 1] : "";
+    if (char === "<" || char === "{" || char === "(" || char === "[") {
+      depth++;
+    } else if (char === "}" || char === ")" || char === "]") {
+      depth = Math.max(0, depth - 1);
+    } else if (char === ">") {
+      if (prevChar !== "=") {
+        depth = Math.max(0, depth - 1);
+      }
+    } else if (char === ";" && depth === 0) {
+      return { type: text2.slice(startIndex, i).trim(), endIndex: i };
+    }
+    i++;
+  }
+  return { type: text2.slice(startIndex).trim(), endIndex: text2.length };
+}
+function parseInterface2(content, interfaceName) {
+  const props = [];
+  const interfaceRegex = new RegExp(
+    `(?:export\\s+)?${TYPE_OR_INTERFACE2}\\s+${interfaceName}\\s*(?:<(?:\\{[^}]*\\}|[^>])*>)?\\s*(?:extends\\s+[^{]+)?(?:=\\s*)?\\{([\\s\\S]*?)\\n\\}`,
+    "m"
+  );
+  const match = content.match(interfaceRegex);
+  if (!match) {
+    return props;
+  }
+  const interfaceBody = match[1];
+  const propStartRegex = /(?:\/\*\*([\s\S]*?)\*\/\s*)?([\w]+)(\?)?:\s*/g;
+  let propMatch;
+  while ((propMatch = propStartRegex.exec(interfaceBody)) !== null) {
+    const jsdocComment = propMatch[1] || "";
+    const propName = propMatch[2];
+    const isOptional = !!propMatch[3];
+    const typeStartIndex = propMatch.index + propMatch[0].length;
+    const { type: propType, endIndex } = extractType2(interfaceBody, typeStartIndex);
+    propStartRegex.lastIndex = endIndex + 1;
+    const jsdoc = parseJSDoc2(jsdocComment);
+    props.push({
+      name: propName,
+      type: propType,
+      required: !isOptional,
+      description: jsdoc.description,
+      default: jsdoc.default,
+      example: jsdoc.example
+    });
+  }
+  return props;
+}
+function extractComponentDescription2(content, interfaceName) {
+  const lines = content.split("\n");
+  const interfaceLineIndex = lines.findIndex(
+    (line) => line.match(new RegExp(`export\\s+${TYPE_OR_INTERFACE2}\\s+${interfaceName}`))
+  );
+  if (interfaceLineIndex === -1) {
+    return "";
+  }
+  let jsdocEndIndex = -1;
+  for (let i = interfaceLineIndex - 1; i >= 0; i--) {
+    const line = lines[i].trim();
+    if (line === "" || line === "*/") {
+      if (line === "*/") {
+        jsdocEndIndex = i;
+      }
+      continue;
+    }
+    if (!line.startsWith("*") && !line.startsWith("/**")) {
+      break;
+    }
+    if (line.startsWith("/**")) {
+      const jsdocLines = lines.slice(i, jsdocEndIndex + 1);
+      const jsdocContent = jsdocLines.join("\n");
+      return parseJSDoc2(jsdocContent).description;
+    }
+  }
+  return "";
+}
+function resolveUnionOrIntersectionProps2(content, typeName) {
+  const typeDefRegex = new RegExp(`export\\s+type\\s+${typeName}\\s*=\\s*([^;]+)`);
+  const match = content.match(typeDefRegex);
+  if (!match) return [];
+  const referencedTypes = match[1].split(/[|&]/).map((t) => t.trim()).filter((t) => t.endsWith("Props"));
+  if (referencedTypes.length === 0) return [];
+  const firstBranch = referencedTypes[0];
+  const extendsRegex = new RegExp(
+    `(?:export\\s+)?${TYPE_OR_INTERFACE2}\\s+${firstBranch}\\s+extends\\s+(\\w+)`
+  );
+  const extendsMatch = content.match(extendsRegex);
+  const allProps = [];
+  if (extendsMatch) {
+    allProps.push(...parseInterface2(content, extendsMatch[1]));
+  }
+  allProps.push(...parseInterface2(content, firstBranch));
+  const seen = /* @__PURE__ */ new Set();
+  return allProps.filter((p) => {
+    if (seen.has(p.name)) return false;
+    seen.add(p.name);
+    return true;
+  });
+}
+function readChatKitTypesFile(filePath, componentName) {
+  const content = readTextFile(filePath);
+  if (!content) {
+    return null;
+  }
+  const resolvedName = componentName || path8.basename(path8.dirname(filePath));
+  const exactRegex = new RegExp(`export\\s+${TYPE_OR_INTERFACE2}\\s+(${resolvedName}Props)\\b`);
+  let propsInterfaceMatch = content.match(exactRegex);
+  if (!propsInterfaceMatch) {
+    const prefixRegex = new RegExp(
+      `export\\s+${TYPE_OR_INTERFACE2}\\s+(${resolvedName}\\w*Props)\\b`
+    );
+    propsInterfaceMatch = content.match(prefixRegex);
+  }
+  if (!propsInterfaceMatch) {
+    propsInterfaceMatch = content.match(
+      new RegExp(`export\\s+${TYPE_OR_INTERFACE2}\\s+(Ck\\w+Props)\\b`)
+    );
+  }
+  if (!propsInterfaceMatch) {
+    return null;
+  }
+  const interfaceName = propsInterfaceMatch[1];
+  const matchedComponentName = interfaceName.replace("Props", "");
+  const description = extractComponentDescription2(content, interfaceName);
+  let props = parseInterface2(content, interfaceName);
+  if (props.length === 0) {
+    props = resolveUnionOrIntersectionProps2(content, interfaceName);
+  }
+  return {
+    name: matchedComponentName,
+    description,
+    props
+  };
+}
+function readChatKitComponentTypes(componentDir) {
+  const typesPath = path8.join(componentDir, "types.ts");
+  return readChatKitTypesFile(typesPath, path8.basename(componentDir));
+}
+
+// src/tools/list-chat-kit-components.ts
+function isChatKitComponent(dirName) {
+  return dirName.startsWith(CHAT_KIT_PREFIX);
+}
+function getDescription(componentName, componentMeta, componentDir) {
+  if (componentMeta?.description) return componentMeta.description;
+  const typeInfo = readChatKitComponentTypes(componentDir);
+  if (typeInfo?.description) return typeInfo.description;
+  return `${componentName} component`;
+}
+function matchesFilter2(component, filter) {
+  const filterLower = filter.toLowerCase();
+  return component.name.toLowerCase().includes(filterLower) || component.category.toLowerCase().includes(filterLower) || component.description.toLowerCase().includes(filterLower);
+}
+function listChatKitComponents(filter) {
+  const srcPath = getChatKitSourcePath();
+  const meta = loadChatKitComponentsMeta();
+  const allComponents = getChatKitCategoryDirs().flatMap((category) => {
+    const categoryPath = path9.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 componentMeta = meta[e.name];
+      return {
+        name: e.name,
+        category: componentMeta?.category ?? "Uncategorized",
+        description: getDescription(e.name, componentMeta, componentDir)
+      };
+    });
+  });
+  allComponents.sort((a, b) => a.name.localeCompare(b.name));
+  return filter ? allComponents.filter((c) => matchesFilter2(c, filter)) : allComponents;
+}
+
+// src/tools/get-chat-kit-docs.ts
+import * as path10 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);
+    if (isDirectory(dir)) return dir;
+  }
+  return null;
+}
+function isTypeSuffix2(name) {
+  return TYPE_SUFFIXES.some((suffix) => name.endsWith(suffix));
+}
+function extractSubComponents2(indexPath, mainComponentName) {
+  const content = readTextFile(indexPath);
+  if (!content) return [];
+  const subComponents = /* @__PURE__ */ new Set();
+  const exportRegex = /export\s*\{[^}]*(?:default\s+as\s+)?(\w+)[^}]*\}/g;
+  let match;
+  while ((match = exportRegex.exec(content)) !== null) {
+    const exportName = match[1];
+    if (exportName.startsWith(mainComponentName) && exportName !== mainComponentName && !isTypeSuffix2(exportName)) {
+      subComponents.add(exportName);
+    }
+  }
+  return Array.from(subComponents).sort();
+}
+function getChatKitComponentDocs(componentName) {
+  const name = normalizeChatKitName(componentName);
+  const componentDir = findChatKitComponentDir(name);
+  if (!componentDir) return null;
+  const typeInfo = readChatKitComponentTypes(componentDir);
+  const props = typeInfo?.props || [];
+  let description = typeInfo?.description || "";
+  const storiesInfo = readComponentStories(componentDir);
+  const examples = storiesInfo?.examples || [];
+  const usageGuidance = storiesInfo?.usageGuidance || [];
+  if (!description && usageGuidance.length > 0) {
+    description = usageGuidance[0];
+  }
+  if (!description) {
+    description = `${name} component from @aleph-alpha/chat-kit`;
+  }
+  const indexPath = path10.join(componentDir, "index.ts");
+  const subComponents = readTextFile(indexPath) ? extractSubComponents2(indexPath, name) : void 0;
+  if (storiesInfo?.argTypes) {
+    for (const argType of storiesInfo.argTypes) {
+      const prop = props.find((p) => p.name === argType.name);
+      if (prop && !prop.description && argType.description) {
+        prop.description = argType.description;
+      }
+    }
+  }
+  return {
+    name,
+    description,
+    props,
+    examples,
+    usageGuidance: [...new Set(usageGuidance)],
+    subComponents: subComponents && subComponents.length > 0 ? subComponents : void 0,
+    defaultArgs: storiesInfo?.defaultArgs
+  };
+}
+
 // src/server.ts
-var text = (t) => ({ content: [{ type: "text", text: t }] });
+var text = (t) => ({
+  content: [{ type: "text", text: t }]
+});
 var error2 = (msg) => ({ ...text(msg), isError: true });
 function handleError(e) {
   const message = e instanceof Error ? e.message : String(e);
@@ -21709,11 +22092,13 @@ function formatComponentDocs(docs) {
     docs.props.forEach((prop) => sections.push(...formatProp(prop)));
   }
   if (docs.defaultArgs && Object.keys(docs.defaultArgs).length > 0) {
-    const filteredArgs = Object.entries(docs.defaultArgs).filter(([key, value]) => {
-      const prop = docs.props.find((p) => p.name === key);
-      if (!prop?.default) return true;
-      return String(value) !== prop.default;
-    });
+    const filteredArgs = Object.entries(docs.defaultArgs).filter(
+      ([key, value]) => {
+        const prop = docs.props.find((p) => p.name === key);
+        if (!prop?.default) return true;
+        return String(value) !== prop.default;
+      }
+    );
     if (filteredArgs.length > 0) {
       sections.push("## Storybook Defaults", "");
       sections.push(
@@ -21752,11 +22137,16 @@ function formatComponentDocs(docs) {
   return sections.join("\n").trim();
 }
 async function startServer() {
-  const server = new McpServer({ name: "ui-library", version: getPackageVersion() });
+  const server = new McpServer({
+    name: "ui-library",
+    version: getPackageVersion()
+  });
   server.tool(
     "list_components",
     "List all UI components. Optionally filter by name, category, or description.",
-    { filter: external_exports.string().optional().describe("Filter by name/category/description") },
+    {
+      filter: external_exports.string().optional().describe("Filter by name/category/description")
+    },
     async ({ filter }) => {
       try {
         const components = listComponents(filter);
@@ -21789,7 +22179,9 @@ async function startServer() {
   server.tool(
     "get_component_docs",
     "Get full documentation for a component including props, examples, and usage.",
-    { componentName: external_exports.string().describe('Component name (e.g., "UiButton" or "Button")') },
+    {
+      componentName: external_exports.string().describe('Component name (e.g., "UiButton" or "Button")')
+    },
     async ({ componentName }) => {
       try {
         const docs = getComponentDocs(componentName);
@@ -21800,6 +22192,52 @@ async function startServer() {
       }
     }
   );
+  server.tool(
+    "list_chat_kit_components",
+    "List all Chat Kit components. Optionally filter by name, category, or description.",
+    { filter: external_exports.string().optional().describe("Filter by name/category/description") },
+    async ({ filter }) => {
+      try {
+        const components = listChatKitComponents(filter);
+        if (components.length === 0) {
+          const message = filter ? `No chat-kit components matching "${filter}".` : "No chat-kit components found.";
+          return text(message);
+        }
+        const grouped = components.reduce(
+          (acc, component) => {
+            (acc[component.category] ??= []).push(component);
+            return acc;
+          },
+          {}
+        );
+        const sections = [`Found ${components.length} chat-kit component(s):`, ""];
+        Object.entries(grouped).forEach(([category, comps]) => {
+          sections.push(`## ${category}`, "");
+          comps.forEach((comp) => {
+            sections.push(`- **${comp.name}**: ${comp.description}`);
+          });
+          sections.push("");
+        });
+        return text(sections.join("\n").trim());
+      } catch (e) {
+        return handleError(e);
+      }
+    }
+  );
+  server.tool(
+    "get_chat_kit_docs",
+    "Get full documentation for a Chat Kit component including props, examples, and usage.",
+    { componentName: external_exports.string().describe('Component name (e.g., "CkChatBubble" or "ChatBubble")') },
+    async ({ componentName }) => {
+      try {
+        const docs = getChatKitComponentDocs(componentName);
+        if (!docs) return error2(`Chat Kit component "${componentName}" not found.`);
+        return text(formatComponentDocs(docs));
+      } catch (e) {
+        return handleError(e);
+      }
+    }
+  );
   server.tool(
     "get_setup_guide",
     "Get the setup and installation guide for integrating the UI library into a project. Returns UnoCSS config, Vite config, required dependencies, and MCP setup instructions.",
@@ -21807,7 +22245,10 @@ async function startServer() {
     async () => {
       try {
         const guide = getSetupGuide();
-        if (!guide) return error2("Setup guide not found. Is @aleph-alpha/ui-library installed?");
+        if (!guide)
+          return error2(
+            "Setup guide not found. Is @aleph-alpha/ui-library installed?"
+          );
         return text(guide);
       } catch (e) {
         return handleError(e);