@eventcatalog/core 3.32.1 → 3.33.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.1";
+var version = "3.33.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-CC6EO52Y.js";
-import "../chunk-2AFDJJP4.js";
+} from "../chunk-TDRDRXOZ.js";
+import "../chunk-YKTTWB2P.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.1";
+var version = "3.33.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-CUTS7SO7.js";
-import "../chunk-CC6EO52Y.js";
+} from "../chunk-GBSBBBF5.js";
+import "../chunk-TDRDRXOZ.js";
 import "../chunk-4UVFXLPI.js";
-import "../chunk-2AFDJJP4.js";
+import "../chunk-YKTTWB2P.js";
 import "../chunk-5T63CXKU.js";
 export {
   log_build_default as default

package/dist/{chunk-JJZ4XMYN.js → chunk-DN6F4AAQ.js}

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

package/dist/{chunk-CUTS7SO7.js → chunk-GBSBBBF5.js}

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

package/dist/{chunk-CC6EO52Y.js → chunk-TDRDRXOZ.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-2AFDJJP4.js";
+} from "./chunk-YKTTWB2P.js";
 
 // src/analytics/analytics.js
 import axios from "axios";

package/dist/{chunk-IQ7W6KWL.js → chunk-VRXBFCYB.js}

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

package/dist/{chunk-2AFDJJP4.js → chunk-YKTTWB2P.js}

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

package/dist/constants.cjs

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

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-2AFDJJP4.js";
+} from "./chunk-YKTTWB2P.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.1";
+var version = "3.33.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/eventcatalog.js

@@ -1,18 +1,18 @@
+import {
+  log_build_default
+} from "./chunk-GBSBBBF5.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-WAJIJEI3.js";
 import {
   watch
 } from "./chunk-K3ZVEX2Y.js";
-import {
-  log_build_default
-} from "./chunk-CUTS7SO7.js";
-import "./chunk-CC6EO52Y.js";
-import "./chunk-4UVFXLPI.js";
 import {
   runMigrations
 } from "./chunk-XUAF2H54.js";
 import "./chunk-CA4U2JP7.js";
+import "./chunk-TDRDRXOZ.js";
+import "./chunk-4UVFXLPI.js";
 import {
   catalogToAstro
 } from "./chunk-YDXB3BD2.js";
@@ -22,13 +22,13 @@ import {
 } from "./chunk-3KXCGYET.js";
 import {
   generate
-} from "./chunk-IQ7W6KWL.js";
+} from "./chunk-VRXBFCYB.js";
 import {
   logger
-} from "./chunk-JJZ4XMYN.js";
+} from "./chunk-DN6F4AAQ.js";
 import {
   VERSION
-} from "./chunk-2AFDJJP4.js";
+} from "./chunk-YKTTWB2P.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.1";
+var version = "3.33.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-IQ7W6KWL.js";
-import "./chunk-JJZ4XMYN.js";
-import "./chunk-2AFDJJP4.js";
+} from "./chunk-VRXBFCYB.js";
+import "./chunk-DN6F4AAQ.js";
+import "./chunk-YKTTWB2P.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.1";
+var version = "3.33.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-JJZ4XMYN.js";
-import "../chunk-2AFDJJP4.js";
+} from "../chunk-DN6F4AAQ.js";
+import "../chunk-YKTTWB2P.js";
 export {
   logger
 };

package/eventcatalog/src/components/MDX/Prompt/Prompt.astro

@@ -0,0 +1,173 @@
+---
+import { LUCIDE_ICON_MAP } from '@utils/icon-map';
+
+type ActionType = 'copy' | 'cursor';
+
+interface Props {
+  description: string;
+  actions?: ActionType[];
+  icon?: string;
+}
+
+const { description, actions = ['copy'], icon } = Astro.props;
+
+const showCopy = actions.includes('copy');
+const showCursor = actions.includes('cursor');
+
+const toPascalCase = (input: string): string =>
+  input
+    .split(/[-_\s]+/)
+    .filter(Boolean)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join('');
+
+const Icon = icon ? (LUCIDE_ICON_MAP[toPascalCase(icon)] ?? null) : null;
+
+// Render the slotted content to a string so we can use it as the prompt text
+// (for clipboard + the Cursor deep link).
+const slotHtml = await Astro.slots.render('default');
+const promptText = (slotHtml ?? '')
+  .replace(/<[^>]+>/g, '')
+  .replace(/&nbsp;/g, ' ')
+  .replace(/&amp;/g, '&')
+  .replace(/&lt;/g, '<')
+  .replace(/&gt;/g, '>')
+  .replace(/&quot;/g, '"')
+  .replace(/&#39;/g, "'")
+  .trim();
+
+const cursorUrl = `https://cursor.com/link/prompt?text=${encodeURIComponent(promptText)}`;
+---
+
+<ec-prompt
+  class="not-prose my-4 block rounded-xl border border-[rgb(var(--ec-page-border))] bg-gray-50 dark:bg-[rgb(var(--ec-rail-bg))]"
+  data-prompt-text={promptText}
+>
+  <div class="flex items-center gap-2.5 px-4 py-3">
+    {Icon && <Icon className="w-4 h-4 shrink-0 text-[rgb(var(--ec-page-text-muted))]" />}
+    <div class="flex-1 min-w-0">
+      <div class="text-sm font-medium text-[rgb(var(--ec-page-text))] leading-snug">{description}</div>
+    </div>
+    <div class="flex items-center gap-1.5 shrink-0">
+      {
+        showCopy && (
+          <button
+            type="button"
+            data-prompt-copy
+            data-copied="false"
+            aria-label="Copy prompt"
+            aria-live="polite"
+            class="ec-prompt-copy inline-flex items-center gap-1.5 px-2 py-1 text-xs font-medium rounded-md border transition-all duration-150 border-[rgb(var(--ec-page-border))] bg-[rgb(var(--ec-page-bg))] text-[rgb(var(--ec-page-text))] hover:bg-[rgb(var(--ec-content-hover))] data-[copied=true]:border-emerald-500/70 data-[copied=true]:bg-emerald-50 data-[copied=true]:text-emerald-700 dark:data-[copied=true]:bg-emerald-950/50 dark:data-[copied=true]:text-emerald-300 dark:data-[copied=true]:border-emerald-500/60"
+          >
+            <span data-prompt-copy-idle class="inline-flex items-center gap-1.5">
+              <svg
+                xmlns="http://www.w3.org/2000/svg"
+                width="14"
+                height="14"
+                viewBox="0 0 24 24"
+                fill="none"
+                stroke="currentColor"
+                stroke-width="2"
+                stroke-linecap="round"
+                stroke-linejoin="round"
+              >
+                <rect x="9" y="9" width="13" height="13" rx="2" ry="2" />
+                <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" />
+              </svg>
+              <span>Copy</span>
+            </span>
+            <span data-prompt-copy-done class="inline-flex items-center gap-1.5" style="display:none;">
+              <svg
+                xmlns="http://www.w3.org/2000/svg"
+                width="14"
+                height="14"
+                viewBox="0 0 24 24"
+                fill="none"
+                stroke="currentColor"
+                stroke-width="2.5"
+                stroke-linecap="round"
+                stroke-linejoin="round"
+              >
+                <polyline points="20 6 9 17 4 12" />
+              </svg>
+              <span>Copied!</span>
+            </span>
+          </button>
+        )
+      }
+      {
+        showCursor && (
+          <a
+            href={cursorUrl}
+            target="_blank"
+            rel="noopener noreferrer"
+            aria-label="Open in Cursor"
+            class="inline-flex items-center gap-1.5 px-2 py-1 text-xs font-medium rounded-md border border-black bg-black !text-white hover:bg-black/85 transition-colors no-underline"
+          >
+            <svg
+              height="1em"
+              width="1em"
+              viewBox="0 0 16 16"
+              xmlns="http://www.w3.org/2000/svg"
+              aria-hidden="true"
+              class="w-3 h-3 shrink-0"
+            >
+              <path
+                fill="currentColor"
+                d="M14.4734 3.9527L8.31773 0.398522C8.22052 0.342485 8.11029 0.312988 7.99809 0.312988C7.88589 0.312988 7.77566 0.342485 7.67846 0.398522L1.52355 3.9527C1.44182 3.99989 1.37394 4.06773 1.32671 4.14942C1.27948 4.23112 1.25457 4.32379 1.25446 4.41816V11.584C1.25457 11.6783 1.27948 11.771 1.32671 11.8527C1.37394 11.9344 1.44182 12.0022 1.52355 12.0494L7.67918 15.6036C7.77636 15.6597 7.8866 15.6893 7.99882 15.6893C8.11103 15.6893 8.22127 15.6597 8.31846 15.6036L14.4741 12.0502C14.5558 12.003 14.6237 11.9351 14.6709 11.8534C14.7182 11.7717 14.7431 11.6791 14.7432 11.5847V4.41743C14.7431 4.32307 14.7182 4.23039 14.6709 4.14869C14.6237 4.067 14.5558 3.99916 14.4741 3.95198L14.4734 3.9527ZM14.0872 4.70543L8.14464 14.9978C8.10464 15.0669 7.99846 15.0385 7.99846 14.9578V8.21889C7.99841 8.15254 7.98092 8.08738 7.94773 8.02993C7.91454 7.97249 7.86682 7.92478 7.80936 7.89161L1.97373 4.52361C1.90391 4.48289 1.93227 4.3767 2.013 4.3767H13.8966C14.0661 4.3767 14.1715 4.55925 14.0872 4.70543Z"
+              />
+            </svg>
+            <span>Open in Cursor</span>
+          </a>
+        )
+      }
+    </div>
+  </div>
+  <div hidden><slot /></div>
+</ec-prompt>
+
+<script>
+  if (!customElements.get('ec-prompt')) {
+    class ECPromptElement extends HTMLElement {
+      private resetTimer: number | null = null;
+      private button: HTMLButtonElement | null = null;
+      private boundHandler = this.handleCopy.bind(this);
+
+      connectedCallback() {
+        this.button = this.querySelector<HTMLButtonElement>('[data-prompt-copy]');
+        this.button?.addEventListener('click', this.boundHandler);
+      }
+
+      disconnectedCallback() {
+        this.button?.removeEventListener('click', this.boundHandler);
+        if (this.resetTimer != null) {
+          window.clearTimeout(this.resetTimer);
+          this.resetTimer = null;
+        }
+      }
+
+      private async handleCopy() {
+        const text = this.dataset.promptText ?? '';
+        try {
+          await navigator.clipboard.writeText(text);
+        } catch {
+          return;
+        }
+        this.setCopied(true);
+        if (this.resetTimer != null) window.clearTimeout(this.resetTimer);
+        this.resetTimer = window.setTimeout(() => this.setCopied(false), 1500);
+      }
+
+      private setCopied(copied: boolean) {
+        if (!this.button) return;
+        this.button.dataset.copied = copied ? 'true' : 'false';
+        this.button.setAttribute('aria-label', copied ? 'Copied to clipboard' : 'Copy prompt');
+        const idle = this.button.querySelector<HTMLElement>('[data-prompt-copy-idle]');
+        const done = this.button.querySelector<HTMLElement>('[data-prompt-copy-done]');
+        if (idle) idle.style.display = copied ? 'none' : '';
+        if (done) done.style.display = copied ? '' : 'none';
+      }
+    }
+    customElements.define('ec-prompt', ECPromptElement);
+  }
+</script>

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

@@ -10,6 +10,7 @@ import Tile from '@components/MDX/Tiles/Tile.astro';
 import Steps from '@components/MDX/Steps/Steps.astro';
 import Step from '@components/MDX/Steps/Step.astro';
 import Admonition from '@components/MDX/Admonition';
+import Prompt from '@components/MDX/Prompt/Prompt.astro';
 import OpenAPI from '@components/MDX/OpenAPI/OpenAPI.astro';
 import AsyncAPI from '@components/MDX/AsyncAPI/AsyncAPI.astro';
 import ChannelInformation from '@components/MDX/ChannelInformation/ChannelInformation';
@@ -34,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 {
@@ -53,6 +55,7 @@ const components = (props: any) => {
     NodeGraph: (mdxProp: any) => jsx(NodeGraphPortal, { ...props.data, ...mdxProp, props, mdxProp }),
     EntityMap: (mdxProp: any) => jsx(EntityMap, { ...props, ...mdxProp }),
     OpenAPI,
+    Prompt: (mdxProp: any) => jsx(Prompt, { ...props, ...mdxProp }),
     ResourceGroupTable: (mdxProp: any) => jsx(ResourceGroupTable, { ...props, ...mdxProp }),
     ResourceLink: (mdxProp: any) => jsx(ResourceLink, { ...props, ...mdxProp }),
     ResourceRef: (mdxProp: any) => jsx(ResourceRef, { ...props, ...mdxProp }),
@@ -64,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/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/remark-plugins/directives.ts

@@ -5,29 +5,48 @@ export function remarkDirectives() {
   return (tree: any) => {
     visit(tree, (node) => {
       if (node.type === 'containerDirective') {
+        // Subtle, tinted backgrounds with a coloured left bar and icon.
+        // Body text inherits the page's normal text colour for readability.
         const blockTypes = {
-          info: 'bg-blue-50 dark:bg-blue-950/50 border-l-4 border-blue-500 text-blue-700 dark:text-blue-200',
-          warning: 'bg-yellow-50 dark:bg-yellow-950/50 border-l-4 border-yellow-500 text-yellow-700 dark:text-yellow-200',
-          danger: 'bg-red-50 dark:bg-red-950/50 border-l-4 border-red-500 text-red-700 dark:text-red-200',
-          tip: 'bg-green-50 dark:bg-green-950/50 border-l-4 border-green-500 text-green-700 dark:text-green-200',
-          note: 'bg-gray-50 dark:bg-gray-950/50 border-l-4 border-gray-500 text-gray-700 dark:text-gray-200',
+          info: 'ec-admonition ec-admonition--info bg-blue-50/60 dark:bg-blue-950/30 border border-blue-200/70 dark:border-blue-900/60',
+          warning:
+            'ec-admonition ec-admonition--warning bg-amber-50/60 dark:bg-amber-950/30 border border-amber-200/70 dark:border-amber-900/60',
+          danger:
+            'ec-admonition ec-admonition--danger bg-red-50/60 dark:bg-red-950/30 border border-red-200/70 dark:border-red-900/60',
+          tip: 'ec-admonition ec-admonition--tip bg-emerald-50/60 dark:bg-emerald-900/40 border border-emerald-200/70 dark:border-emerald-700/80',
+          note: 'ec-admonition ec-admonition--note bg-slate-50/70 dark:bg-slate-900/40 border border-slate-200/70 dark:border-slate-700/60',
         };
 
-        // Lucide icon paths
+        // Distinct Lucide icons per intent (warning vs danger no longer share).
         const iconPaths = {
-          info: 'M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z',
-          warning:
-            'M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z',
-          danger:
-            'M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z',
-          tip: 'M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z',
-          note: 'M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z',
+          // Info — circle with "i"
+          info: 'M12 2a10 10 0 100 20 10 10 0 000-20zM12 8h.01M11 12h1v4h1',
+          // Warning — triangle with !
+          warning: 'M10.29 3.86 1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0zM12 9v4 M12 17h.01',
+          // Danger — octagon with !
+          danger: 'M7.86 2h8.28L22 7.86v8.28L16.14 22H7.86L2 16.14V7.86L7.86 2z M12 8v4 M12 16h.01',
+          // Tip — lightbulb
+          tip: 'M9 18h6 M10 22h4 M12 2a7 7 0 0 0-4 12.74V17h8v-2.26A7 7 0 0 0 12 2z',
+          // Note — pencil-line
+          note: 'M12 20h9 M16.5 3.5a2.121 2.121 0 1 1 3 3L7 19l-4 1 1-4 12.5-12.5z',
         };
 
+        // Coloured icon + title classes (intent accent colours).
+        const accentTextClasses = {
+          info: 'text-blue-700 dark:text-blue-300',
+          warning: 'text-amber-700 dark:text-amber-300',
+          danger: 'text-red-700 dark:text-red-300',
+          tip: 'text-emerald-700 dark:text-emerald-300',
+          note: 'text-slate-600 dark:text-slate-300',
+        };
+
+        const intent = node.name as keyof typeof blockTypes;
+        const accentClass = accentTextClasses[intent] || accentTextClasses.note;
+
         node.data = node.data || {};
         node.data.hName = 'div';
         node.data.hProperties = {
-          class: `rounded-lg p-4 my-4 ${blockTypes[node.name as keyof typeof blockTypes] || ''}`,
+          class: `rounded-md px-3 py-2.5 my-4 text-[0.85rem] leading-relaxed ${blockTypes[intent] || ''}`,
         };
 
         // Check if there's a custom title (label) provided via :::note[Custom Title]
@@ -62,26 +81,26 @@ export function remarkDirectives() {
           data: {
             hName: 'div',
             hProperties: {
-              class: 'flex items-center gap-2 font-semibold mb-2',
+              class: `flex items-center gap-1.5 mb-1 ${accentClass}`,
             },
           },
           children: [
-            // Lucide Icon SVG
+            // Lucide Icon SVG (smaller, accent-coloured)
             {
               type: 'element',
               data: {
                 hName: 'svg',
                 hProperties: {
                   xmlns: 'http://www.w3.org/2000/svg',
-                  width: '26',
-                  height: '26',
+                  width: '14',
+                  height: '14',
                   viewBox: '0 0 24 24',
                   fill: 'none',
                   stroke: 'currentColor',
-                  strokeWidth: '2',
+                  strokeWidth: '2.25',
                   strokeLinecap: 'round',
                   strokeLinejoin: 'round',
-                  class: 'lucide',
+                  class: 'lucide shrink-0',
                 },
               },
               children: [
@@ -96,13 +115,13 @@ export function remarkDirectives() {
                 },
               ],
             },
-            // Title (with support for markdown)
+            // Title — small, uppercase, tracked
             {
               type: 'element',
               data: {
                 hName: 'span',
                 hProperties: {
-                  class: '',
+                  class: 'text-[0.7rem] font-semibold uppercase tracking-wider',
                 },
               },
               children: titleChildren,
@@ -116,7 +135,8 @@ export function remarkDirectives() {
           data: {
             hName: 'div',
             hProperties: {
-              class: 'prose prose-md dark:prose-invert w-full max-w-none! prose-p:my-1 prose-p:text-inherit',
+              class:
+                'prose prose-sm dark:prose-invert w-full max-w-none! prose-p:my-0.5 prose-p:text-inherit prose-p:text-[0.85rem] prose-p:leading-relaxed prose-code:text-[0.8rem]',
             },
           },
           children: contentChildren,

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.1",
+  "version": "3.33.0",
   "publishConfig": {
     "access": "public"
   },
@@ -106,8 +106,8 @@
     "uuid": "^10.0.0",
     "zod": "^4.3.6",
     "@eventcatalog/linter": "1.0.22",
-    "@eventcatalog/visualiser": "^3.20.0",
-    "@eventcatalog/sdk": "2.21.0"
+    "@eventcatalog/sdk": "2.21.0",
+    "@eventcatalog/visualiser": "^3.20.0"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.8",