@eventcatalog/core 3.32.2 → 3.34.0

package/dist/analytics/analytics.cjs

@@ -37,7 +37,7 @@ var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.32.2";
+var version = "3.34.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-CBKYKCNH.js";
-import "../chunk-U54R4QAA.js";
+} from "../chunk-IO6EMN5C.js";
+import "../chunk-623CFR4T.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

@@ -111,7 +111,7 @@ var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.32.2";
+var version = "3.34.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-MR3R4KPQ.js";
-import "../chunk-CBKYKCNH.js";
+} from "../chunk-BJWMR3ZH.js";
+import "../chunk-IO6EMN5C.js";
 import "../chunk-4UVFXLPI.js";
-import "../chunk-U54R4QAA.js";
+import "../chunk-623CFR4T.js";
 import "../chunk-5T63CXKU.js";
 export {
   log_build_default as default

package/dist/{chunk-U54R4QAA.js → chunk-623CFR4T.js}

@@ -1,5 +1,5 @@
 // package.json
-var version = "3.32.2";
+var version = "3.34.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/{chunk-MR3R4KPQ.js → chunk-BJWMR3ZH.js}

@@ -1,6 +1,6 @@
 import {
   raiseEvent
-} from "./chunk-CBKYKCNH.js";
+} from "./chunk-IO6EMN5C.js";
 import {
   countResources,
   serializeCounts

package/dist/{chunk-CBKYKCNH.js → chunk-IO6EMN5C.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-U54R4QAA.js";
+} from "./chunk-623CFR4T.js";
 
 // src/analytics/analytics.js
 import axios from "axios";

package/dist/{chunk-JTPCTZLV.js → chunk-K5AM6PPU.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-U54R4QAA.js";
+} from "./chunk-623CFR4T.js";
 
 // src/utils/cli-logger.ts
 import pc from "picocolors";

package/dist/{chunk-APXR6OUM.js → chunk-PP7EDIPX.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-JTPCTZLV.js";
+} from "./chunk-K5AM6PPU.js";
 import {
   cleanup,
   getEventCatalogConfigFile

package/dist/constants.cjs

@@ -25,7 +25,7 @@ __export(constants_exports, {
 module.exports = __toCommonJS(constants_exports);
 
 // package.json
-var version = "3.32.2";
+var version = "3.34.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-U54R4QAA.js";
+} from "./chunk-623CFR4T.js";
 export {
   VERSION
 };

package/dist/eventcatalog.cjs

@@ -114,7 +114,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "3.32.2";
+var version = "3.34.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/eventcatalog.js

@@ -6,8 +6,8 @@ import {
 } from "./chunk-K3ZVEX2Y.js";
 import {
   log_build_default
-} from "./chunk-MR3R4KPQ.js";
-import "./chunk-CBKYKCNH.js";
+} from "./chunk-BJWMR3ZH.js";
+import "./chunk-IO6EMN5C.js";
 import "./chunk-4UVFXLPI.js";
 import {
   runMigrations
@@ -22,13 +22,13 @@ import {
 } from "./chunk-3KXCGYET.js";
 import {
   generate
-} from "./chunk-APXR6OUM.js";
+} from "./chunk-PP7EDIPX.js";
 import {
   logger
-} from "./chunk-JTPCTZLV.js";
+} from "./chunk-K5AM6PPU.js";
 import {
   VERSION
-} from "./chunk-U54R4QAA.js";
+} from "./chunk-623CFR4T.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/generate.cjs

@@ -78,7 +78,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "3.32.2";
+var version = "3.34.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-APXR6OUM.js";
-import "./chunk-JTPCTZLV.js";
-import "./chunk-U54R4QAA.js";
+} from "./chunk-PP7EDIPX.js";
+import "./chunk-K5AM6PPU.js";
+import "./chunk-623CFR4T.js";
 import "./chunk-5T63CXKU.js";
 export {
   generate

package/dist/utils/cli-logger.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(cli_logger_exports);
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "3.32.2";
+var version = "3.34.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-JTPCTZLV.js";
-import "../chunk-U54R4QAA.js";
+} from "../chunk-K5AM6PPU.js";
+import "../chunk-623CFR4T.js";
 export {
   logger
 };

package/eventcatalog/src/components/MDX/Visibility.tsx

@@ -0,0 +1,12 @@
+type VisibilityProps = {
+  for: 'agents' | 'humans';
+  children?: any;
+};
+
+const Visibility = ({ for: audience, children }: VisibilityProps) => {
+  if (audience !== 'humans') return null;
+
+  return <>{children}</>;
+};
+
+export default Visibility;

package/eventcatalog/src/components/MDX/components.tsx

@@ -35,6 +35,7 @@ import NodeGraphPortal from '@components/MDX/NodeGraph/NodeGraphPortal';
 import SchemaViewerPortal from '@components/MDX/SchemaViewer/SchemaViewerPortal';
 import { jsx } from 'astro/jsx-runtime';
 import RemoteSchema from '@components/MDX/RemoteSchema.astro';
+import Visibility from '@components/MDX/Visibility';
 
 const components = (props: any) => {
   return {
@@ -66,6 +67,7 @@ const components = (props: any) => {
     Tabs,
     Tile,
     Tiles,
+    Visibility,
     Miro: (mdxProp: any) => jsx(Miro, { ...props, ...mdxProp }),
     Lucid: (mdxProp: any) => jsx(Lucid, { ...props, ...mdxProp }),
     DrawIO: (mdxProp: any) => jsx(DrawIO, { ...props, ...mdxProp }),

package/eventcatalog/src/enterprise/custom-documentation/pages/docs/custom/[...path].mdx.ts

@@ -6,9 +6,11 @@ import type { APIRoute, GetStaticPaths } from 'astro';
 import { getCollection } from 'astro:content';
 import fs from 'fs';
 import { isLLMSTxtEnabled } from '@utils/feature';
+import { filterMarkdownForAgents } from '@utils/llms';
+
+const docs = await getCollection('customPages');
 
 export const getStaticPaths = (async () => {
-  const docs = await getCollection('customPages');
   const paths = docs.map((doc) => ({
     params: { path: doc.id.replace('docs/', '') },
     props: doc,
@@ -23,8 +25,10 @@ export const GET: APIRoute = async ({ params, props }) => {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 
-  if (props.filePath) {
-    const file = fs.readFileSync(props.filePath, 'utf8');
+  const docPath = Array.isArray(params.path) ? params.path.join('/') : params.path;
+  const content = props?.filePath ? props : docs.find((doc) => doc.id.replace('docs/', '') === docPath);
+  if (content?.filePath) {
+    const file = filterMarkdownForAgents(fs.readFileSync(content.filePath, 'utf8'));
     return new Response(file, { status: 200 });
   }
 

package/eventcatalog/src/enterprise/custom-documentation/utils/custom-docs.ts

@@ -6,9 +6,20 @@
 import config from '@config';
 import fs from 'node:fs';
 import path from 'node:path';
-import { getEntry } from 'astro:content';
+import { getCollection } from 'astro:content';
 import matter from 'gray-matter';
 
+// Use getCollection (which returns plain entries) instead of getEntry, which installs
+// Astro's `slug` deprecation accessor on every entry it returns. The accessor fires a
+// `console.error` on each access of `entry.data.slug`, even though our schema legitimately
+// defines `slug` as an optional user field. See packages/core/eventcatalog/src/enterprise/collections/custom-pages.ts.
+const getCustomPagesById = async () => {
+  const all = await getCollection('customPages');
+  const map = new Map<string, (typeof all)[number]>();
+  for (const e of all) map.set(e.id, e);
+  return map;
+};
+
 type Badge = {
   text: string;
   color: string;
@@ -55,12 +66,16 @@ const DOCS_DIR = 'docs';
  * If an index.mdx or index.md file exists in the directory, it will be used as the
  * folder's link target (making the folder clickable) and excluded from the items list.
  */
+type CustomPagesMap = Awaited<ReturnType<typeof getCustomPagesById>>;
+
 const processAutoGeneratedDirectory = async (
   directory: string,
   label: string,
   badge?: Badge,
-  collapsed?: boolean
+  collapsed?: boolean,
+  customPages?: CustomPagesMap
 ): Promise<SidebarItem> => {
+  customPages ??= await getCustomPagesById();
   // @ts-ignore
   const items = fs.readdirSync(path.join(process.env.PROJECT_DIR || '', DOCS_DIR, directory));
 
@@ -78,7 +93,7 @@ const processAutoGeneratedDirectory = async (
     // Normalize path separators for cross-platform compatibility
     // Note: Astro's glob loader strips '/index' from the ID, so docs/foo/index.mdx becomes docs/foo
     const astroId = data.slug || path.join(DOCS_DIR, directory).replace(/\\/g, '/');
-    const entry = await getEntry('customPages', astroId.toLowerCase());
+    const entry = customPages.get(astroId.toLowerCase());
 
     if (entry) {
       // Use the index file's slug as the folder's link target
@@ -101,7 +116,8 @@ const processAutoGeneratedDirectory = async (
         path.join(directory, item),
         item, // Use directory name as label
         undefined, // No badge for subdirectories
-        collapsed // Inherit collapsed state
+        collapsed, // Inherit collapsed state
+        customPages
       );
       // Only add the directory if it contains valid items (mdx/md files) or has a slug (index file)
       if ((subdirResult.items && subdirResult.items.length > 0) || subdirResult.slug) {
@@ -115,7 +131,7 @@ const processAutoGeneratedDirectory = async (
       // Normalize path separators to forward slashes for cross-platform compatibility (Windows uses backslashes)
       const astroId =
         data.slug || path.join(DOCS_DIR, directory, item).replace('.mdx', '').replace('.md', '').replace(/\\/g, '/');
-      const entry = await getEntry('customPages', astroId.toLowerCase());
+      const entry = customPages.get(astroId.toLowerCase());
 
       if (entry) {
         allItems.push({
@@ -138,7 +154,8 @@ const processAutoGeneratedDirectory = async (
 /**
  * Recursively process sidebar items to handle auto-generated content at any nesting level
  */
-const processSidebarItems = async (items: SideBarConfigurationItem[]): Promise<SidebarItem[]> => {
+const processSidebarItems = async (items: SideBarConfigurationItem[], customPages?: CustomPagesMap): Promise<SidebarItem[]> => {
+  customPages ??= await getCustomPagesById();
   const processedItems: SidebarItem[] = [];
 
   for (const item of items) {
@@ -148,13 +165,14 @@ const processSidebarItems = async (items: SideBarConfigurationItem[]): Promise<S
         item.autogenerated.directory,
         item.label,
         item.badge,
-        item.autogenerated.collapsed !== undefined ? item.autogenerated.collapsed : item.collapsed
+        item.autogenerated.collapsed !== undefined ? item.autogenerated.collapsed : item.collapsed,
+        customPages
       );
       processedItems.push(processedItem);
     }
     // If item has nested items, process them recursively
     else if (item.items && item.items.length > 0) {
-      const processedNestedItems = await processSidebarItems(item.items);
+      const processedNestedItems = await processSidebarItems(item.items, customPages);
       processedItems.push({
         label: item.label,
         slug: item.slug,

package/eventcatalog/src/pages/diagrams/[id]/[version].mdx.ts

@@ -7,6 +7,7 @@ import type { APIRoute } from 'astro';
 import { getCollection } from 'astro:content';
 import fs from 'fs';
 import { isLLMSTxtEnabled, isSSR } from '@utils/feature';
+import { filterMarkdownForAgents } from '@utils/llms';
 
 const diagrams = await getCollection('diagrams');
 
@@ -34,11 +35,11 @@ export const GET: APIRoute = async ({ params, props }) => {
     if (!diagram?.filePath) {
       return new Response('Not found', { status: 404 });
     }
-    const file = fs.readFileSync(diagram.filePath, 'utf8');
+    const file = filterMarkdownForAgents(fs.readFileSync(diagram.filePath, 'utf8'));
     return new Response(file, { status: 200 });
   } else {
     if (props?.content?.filePath) {
-      const file = fs.readFileSync(props.content.filePath, 'utf8');
+      const file = filterMarkdownForAgents(fs.readFileSync(props.content.filePath, 'utf8'));
       return new Response(file, { status: 200 });
     }
   }

package/eventcatalog/src/pages/docs/[type]/[id]/[version]/[docType]/[docId].md.ts

@@ -6,6 +6,7 @@ import type { APIRoute } from 'astro';
 import fs from 'fs';
 import { isLLMSTxtEnabled, isResourceDocsEnabled, isSSR } from '@utils/feature';
 import { getResourceDocs, getResourceDocsForResource, type ResourceCollection } from '@utils/collections/resource-docs';
+import { filterMarkdownForAgents } from '@utils/llms';
 
 const supportedResourceCollections = new Set<ResourceCollection>([
   'domains',
@@ -70,6 +71,6 @@ export const GET: APIRoute = async ({ params, props }) => {
     return new Response('Not found', { status: 404 });
   }
 
-  const file = fs.readFileSync(filePath, 'utf8');
+  const file = filterMarkdownForAgents(fs.readFileSync(filePath, 'utf8'));
   return new Response(file, { status: 200, headers: { 'Content-Type': 'text/markdown; charset=utf-8' } });
 };

package/eventcatalog/src/pages/docs/[type]/[id]/[version]/[docType]/[docId].mdx.ts

@@ -6,6 +6,7 @@ import type { APIRoute } from 'astro';
 import fs from 'fs';
 import { isLLMSTxtEnabled, isResourceDocsEnabled, isSSR } from '@utils/feature';
 import { getResourceDocs, getResourceDocsForResource, type ResourceCollection } from '@utils/collections/resource-docs';
+import { filterMarkdownForAgents } from '@utils/llms';
 
 const supportedResourceCollections = new Set<ResourceCollection>([
   'domains',
@@ -70,6 +71,6 @@ export const GET: APIRoute = async ({ params, props }) => {
     return new Response('Not found', { status: 404 });
   }
 
-  const file = fs.readFileSync(filePath, 'utf8');
+  const file = filterMarkdownForAgents(fs.readFileSync(filePath, 'utf8'));
   return new Response(file, { status: 200, headers: { 'Content-Type': 'text/markdown; charset=utf-8' } });
 };

package/eventcatalog/src/pages/docs/[type]/[id]/[version].md.ts

@@ -8,6 +8,7 @@ import { getEntities } from '@utils/collections/entities';
 import config from '@config';
 import fs from 'fs';
 import { isLLMSTxtEnabled } from '@utils/feature';
+import { filterMarkdownForAgents } from '@utils/llms';
 
 const events = await getCollection('events');
 const commands = await getCollection('commands');
@@ -18,23 +19,30 @@ const flows = await getCollection('flows');
 const channels = await getCollection('channels');
 const containers = await getCollection('containers');
 const entities = await getEntities();
+
+const collections = {
+  events,
+  commands,
+  queries,
+  services,
+  domains,
+  flows,
+  channels,
+  containers,
+  entities,
+};
+
+const findContent = (params: Record<string, string | undefined>) => {
+  const collection = collections[params.type as keyof typeof collections];
+  return collection?.find((item: any) => item.data.id === params.id && item.data.version === params.version);
+};
+
 export async function getStaticPaths() {
   // Just return empty array if LLMs are not enabled
   if (!isLLMSTxtEnabled()) {
     return [];
   }
 
-  const collections = {
-    events,
-    commands,
-    queries,
-    services,
-    domains,
-    flows,
-    channels,
-    containers,
-    entities,
-  };
   const paths = Object.keys(collections).map((type) => {
     return collections[type as keyof typeof collections].map((item: { data: { id: string; version: string } }) => ({
       params: { type, id: item.data.id, version: item.data.version },
@@ -51,8 +59,9 @@ export const GET: APIRoute = async ({ params, props }) => {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 
-  if (props?.content?.filePath) {
-    const file = fs.readFileSync(props.content.filePath, 'utf8');
+  const content = props?.content ?? findContent(params);
+  if (content?.filePath) {
+    const file = filterMarkdownForAgents(fs.readFileSync(content.filePath, 'utf8'));
     return new Response(file, { status: 200 });
   }
 

package/eventcatalog/src/pages/docs/[type]/[id]/[version].mdx.ts

@@ -6,7 +6,7 @@ import type { APIRoute } from 'astro';
 import { getCollection } from 'astro:content';
 import config from '@config';
 import fs from 'fs';
-import { addSchemaToMarkdown } from '@utils/llms';
+import { addSchemaToMarkdown, filterMarkdownForAgents } from '@utils/llms';
 import { isLLMSTxtEnabled, isSSR } from '@utils/feature';
 const events = await getCollection('events');
 const commands = await getCollection('commands');
@@ -15,25 +15,34 @@ const services = await getCollection('services');
 const domains = await getCollection('domains');
 const flows = await getCollection('flows');
 const channels = await getCollection('channels');
+const containers = await getCollection('containers');
 const entities = await getCollection('entities');
 
 import utils from '@eventcatalog/sdk';
 
+const collections = {
+  events,
+  commands,
+  queries,
+  services,
+  domains,
+  flows,
+  channels,
+  containers,
+  entities,
+};
+
+const findContent = (params: Record<string, string | undefined>) => {
+  const collection = collections[params.type as keyof typeof collections];
+  return collection?.find((item) => item.data.id === params.id && item.data.version === params.version);
+};
+
 export async function getStaticPaths() {
   // Just return empty array if LLMs are not enabled
   if (!isLLMSTxtEnabled()) {
     return [];
   }
-  const collections = {
-    events,
-    commands,
-    queries,
-    services,
-    domains,
-    flows,
-    channels,
-    entities,
-  };
+
   const paths = Object.keys(collections).map((type) => {
     return collections[type as keyof typeof collections].map((item: { data: { id: string; version: string } }) => ({
       params: { type, id: item.data.id, version: item.data.version },
@@ -50,26 +59,27 @@ export const GET: APIRoute = async ({ params, props }) => {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 
+  const content = props?.content ?? findContent(params);
+  if (content?.filePath) {
+    let file = fs.readFileSync(content.filePath, 'utf8');
+
+    try {
+      file = addSchemaToMarkdown(content, file);
+    } catch (error) {
+      console.log('Warning: Cant find the schema for', content.data.id, content.data.version);
+    }
+
+    return new Response(filterMarkdownForAgents(file), { status: 200 });
+  }
+
   if (isSSR()) {
     const { getResourcePath } = utils(process.env.PROJECT_DIR ?? '');
     const filePath = await getResourcePath(process.env.PROJECT_DIR ?? '', params.id ?? '', params.version ?? '');
     if (!filePath) {
       return new Response('Not found', { status: 404 });
     }
-    const file = fs.readFileSync(filePath.fullPath, 'utf8');
+    const file = filterMarkdownForAgents(fs.readFileSync(filePath.fullPath, 'utf8'));
     return new Response(file, { status: 200 });
-  } else {
-    if (props?.content?.filePath) {
-      let file = fs.readFileSync(props.content.filePath, 'utf8');
-
-      try {
-        file = addSchemaToMarkdown(props.content, file);
-      } catch (error) {
-        console.log('Warning: Cant find the schema for', props.content.data.id, props.content.data.version);
-      }
-
-      return new Response(file, { status: 200 });
-    }
   }
 
   return new Response('Not found', { status: 404 });

package/eventcatalog/src/pages/docs/[type]/[id]/language.mdx.ts

@@ -4,6 +4,7 @@ import type { APIRoute } from 'astro';
 import config from '@config';
 import fs from 'fs';
 import { isLLMSTxtEnabled } from '@utils/feature';
+import { filterMarkdownForAgents } from '@utils/llms';
 
 export async function getStaticPaths() {
   const domains = await getDomains({ getAllVersions: false });
@@ -30,11 +31,17 @@ export const GET: APIRoute = async ({ params, props }) => {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 
-  const ubiquitousLanguages = await getUbiquitousLanguage(props as CollectionEntry<'domains'>);
+  const domains = await getDomains({ getAllVersions: false });
+  const domain = props?.data ? (props as CollectionEntry<'domains'>) : domains.find((item) => item.data.id === params.id);
+  if (!domain) {
+    return new Response('Not found', { status: 404 });
+  }
+
+  const ubiquitousLanguages = await getUbiquitousLanguage(domain as CollectionEntry<'domains'>);
   const ubiquitousLanguage = ubiquitousLanguages[0];
 
   if (ubiquitousLanguage?.filePath) {
-    let file = fs.readFileSync(ubiquitousLanguage.filePath, 'utf8');
+    let file = filterMarkdownForAgents(fs.readFileSync(ubiquitousLanguage.filePath, 'utf8'));
 
     return new Response(file, { status: 200 });
   }

package/eventcatalog/src/pages/docs/llm/llms-full.txt.ts

@@ -2,7 +2,7 @@ import { getCollection, type CollectionEntry } from 'astro:content';
 import type { APIRoute } from 'astro';
 import fs from 'fs';
 import { isCustomDocsEnabled, isResourceDocsEnabled, isLLMSTxtEnabled } from '@utils/feature';
-import { addSchemaToMarkdown } from '@utils/llms';
+import { addSchemaToMarkdown, filterMarkdownForAgents } from '@utils/llms';
 
 type AllowedCollections =
   | 'events'
@@ -74,7 +74,7 @@ export const GET: APIRoute = async ({ params, request }) => {
         // just skip the resource if it has no schema
       }
 
-      return file;
+      return filterMarkdownForAgents(file);
     })
     .join('\n');
 

package/eventcatalog/src/pages/docs/teams/[id].md.ts

@@ -7,6 +7,7 @@ import { getCollection } from 'astro:content';
 import config from '@config';
 import fs from 'fs';
 import { isLLMSTxtEnabled } from '@utils/feature';
+import { filterMarkdownForAgents } from '@utils/llms';
 
 const teams = await getCollection('teams');
 
@@ -28,8 +29,9 @@ export const GET: APIRoute = async ({ params, props }) => {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 
-  if (props?.content?.filePath) {
-    const file = fs.readFileSync(props.content.filePath, 'utf8');
+  const content = props?.content ?? teams.find((team) => team.data.id === params.id);
+  if (content?.filePath) {
+    const file = filterMarkdownForAgents(fs.readFileSync(content.filePath, 'utf8'));
     return new Response(file, { status: 200 });
   }
 

package/eventcatalog/src/pages/docs/teams/[id].mdx.ts

@@ -6,6 +6,7 @@ import type { APIRoute } from 'astro';
 import { getCollection } from 'astro:content';
 import { isLLMSTxtEnabled } from '@utils/feature';
 import fs from 'fs';
+import { filterMarkdownForAgents } from '@utils/llms';
 
 const teams = await getCollection('teams');
 
@@ -27,8 +28,9 @@ export const GET: APIRoute = async ({ params, props }) => {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 
-  if (props?.content?.filePath) {
-    const file = fs.readFileSync(props.content.filePath, 'utf8');
+  const content = props?.content ?? teams.find((team) => team.data.id === params.id);
+  if (content?.filePath) {
+    const file = filterMarkdownForAgents(fs.readFileSync(content.filePath, 'utf8'));
     return new Response(file, { status: 200 });
   }
 

package/eventcatalog/src/pages/docs/users/[id].md.ts

@@ -7,6 +7,7 @@ import { getCollection } from 'astro:content';
 import config from '@config';
 import fs from 'fs';
 import { isLLMSTxtEnabled } from '@utils/feature';
+import { filterMarkdownForAgents } from '@utils/llms';
 
 const users = await getCollection('users');
 
@@ -28,8 +29,9 @@ export const GET: APIRoute = async ({ params, props }) => {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 
-  if (props?.content?.filePath) {
-    const file = fs.readFileSync(props.content?.filePath, 'utf8');
+  const content = props?.content ?? users.find((user) => user.data.id === params.id);
+  if (content?.filePath) {
+    const file = filterMarkdownForAgents(fs.readFileSync(content.filePath, 'utf8'));
     return new Response(file, { status: 200 });
   }
 

package/eventcatalog/src/pages/docs/users/[id].mdx.ts

@@ -6,6 +6,7 @@ import type { APIRoute } from 'astro';
 import { getCollection } from 'astro:content';
 import { isLLMSTxtEnabled } from '@utils/feature';
 import fs from 'fs';
+import { filterMarkdownForAgents } from '@utils/llms';
 
 const users = await getCollection('users');
 
@@ -27,8 +28,9 @@ export const GET: APIRoute = async ({ params, props }) => {
     return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
   }
 
-  if (props?.content?.filePath) {
-    const file = fs.readFileSync(props.content?.filePath, 'utf8');
+  const content = props?.content ?? users.find((user) => user.data.id === params.id);
+  if (content?.filePath) {
+    const file = filterMarkdownForAgents(fs.readFileSync(content.filePath, 'utf8'));
     return new Response(file, { status: 200 });
   }
 

package/eventcatalog/src/utils/llms.ts

@@ -33,3 +33,25 @@ export const addSchemaToMarkdown = (collection: CollectionEntry<CollectionTypes>
 
   return file;
 };
+
+type VisibilityAudience = 'agents' | 'humans';
+
+const visibilityPattern =
+  /(?:\r?\n){0,2}<Visibility\b(?=[^>]*\bfor=(?:"agents"|'agents'|{["']agents["']}|"humans"|'humans'|{["']humans["']}))[^>]*\bfor=(?:"(agents|humans)"|'(agents|humans)'|{["'](agents|humans)["']})[^>]*>\s*([\s\S]*?)\s*<\/Visibility>(?:\r?\n){0,2}/g;
+
+export const filterMarkdownForAudience = (file: string, audience: VisibilityAudience) => {
+  visibilityPattern.lastIndex = 0;
+  if (!visibilityPattern.test(file)) {
+    return file;
+  }
+  visibilityPattern.lastIndex = 0;
+
+  return file
+    .replace(visibilityPattern, (_match, doubleQuoted, singleQuoted, expressionQuoted, content) => {
+      const visibilityAudience = doubleQuoted || singleQuoted || expressionQuoted;
+      return visibilityAudience === audience ? `\n\n${content.trim()}\n\n` : '\n\n';
+    })
+    .trim();
+};
+
+export const filterMarkdownForAgents = (file: string) => filterMarkdownForAudience(file, 'agents');

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
-  "version": "3.32.2",
+  "version": "3.34.0",
   "publishConfig": {
     "access": "public"
   },
@@ -22,10 +22,10 @@
   ],
   "dependencies": {
     "@ai-sdk/react": "^3.0.17",
-    "@astrojs/markdown-remark": "^7.0.1",
-    "@astrojs/mdx": "^5.0.2",
-    "@astrojs/node": "^10.0.5",
-    "@astrojs/react": "^5.0.1",
+    "@astrojs/markdown-remark": "^7.1.1",
+    "@astrojs/mdx": "^5.0.4",
+    "@astrojs/node": "^10.1.0",
+    "@astrojs/react": "^5.0.4",
     "@astrojs/rss": "^4.0.18",
     "@asyncapi/avro-schema-parser": "3.0.24",
     "@asyncapi/parser": "^3.6.0",
@@ -51,7 +51,7 @@
     "@tanstack/react-table": "^8.17.3",
     "@xyflow/react": "^12.3.6",
     "ai": "^6.0.17",
-    "astro": "^6.0.8",
+    "astro": "^6.3.1",
     "astro-compress": "^2.4.0",
     "astro-expressive-code": "^0.41.7",
     "astro-seo": "^0.8.4",
@@ -68,7 +68,7 @@
     "elkjs": "^0.10.0",
     "glob": "^13.0.6",
     "gray-matter": "^4.0.3",
-    "hono": "4.12.12",
+    "hono": "4.12.16",
     "html-to-image": "^1.11.11",
     "js-yaml": "^4.1.1",
     "jsonpath-plus": "^10.4.0",
@@ -106,11 +106,11 @@
     "uuid": "^10.0.0",
     "zod": "^4.3.6",
     "@eventcatalog/sdk": "2.21.0",
-    "@eventcatalog/visualiser": "^3.20.0",
-    "@eventcatalog/linter": "1.0.22"
+    "@eventcatalog/linter": "1.0.22",
+    "@eventcatalog/visualiser": "^3.20.0"
   },
   "devDependencies": {
-    "@astrojs/check": "^0.9.8",
+    "@astrojs/check": "^0.9.9",
     "@types/dagre": "^0.7.52",
     "@types/diff": "^5.2.2",
     "@types/js-yaml": "^4.0.9",
@@ -119,8 +119,8 @@
     "@types/lodash.merge": "4.6.9",
     "@types/node": "^20.14.2",
     "@types/pako": "^2.0.3",
-    "@types/react": "^18.3.3",
-    "@types/react-dom": "^18.3.0",
+    "@types/react": "^19.2.13",
+    "@types/react-dom": "^19.2.3",
     "@types/react-syntax-highlighter": "^15.5.13",
     "@types/semver": "^7.5.8",
     "@types/shelljs": "^0.8.15",