@eventcatalog/core 3.40.1 → 3.41.0

package/eventcatalog/src/content.config.ts

@@ -32,7 +32,8 @@ export const projectDirBase = (() => {
 
 const withIgnoredBuildArtifacts = (patterns: string | string[]) => {
   if (process.env.IGNORE_BUILD_ARTIFACTS === 'true') {
-    return Array.isArray(patterns) ? [...patterns, '!dist/**'] : [patterns, '!dist/**'];
+    const ignoredArtifacts = ['!dist/**', '!**/dist/**'];
+    return Array.isArray(patterns) ? [...patterns, ...ignoredArtifacts] : [patterns, ...ignoredArtifacts];
   }
   return patterns;
 };
@@ -97,7 +98,7 @@ const receivesPointer = z.object({
 const resourcePointer = z.object({
   id: z.string(),
   version: z.string().optional().default('latest'),
-  type: z.enum(['service', 'event', 'command', 'query', 'flow', 'channel', 'domain', 'user', 'team', 'container']),
+  type: z.enum(['agent', 'service', 'event', 'command', 'query', 'flow', 'channel', 'domain', 'user', 'team', 'container']),
 });
 
 const changelogs = defineCollection({
@@ -133,20 +134,6 @@ const baseSchema = z.object({
   badges: z.array(badge).optional(),
   owners: z.array(ownerReference).optional(),
   schemaPath: z.string().optional(),
-  sidebar: z
-    .object({
-      label: z.string().optional(),
-      badge: z.string().optional(),
-      color: z.string().optional(),
-      backgroundColor: z.string().optional(),
-    })
-    .optional(),
-  repository: z
-    .object({
-      language: z.string().optional(),
-      url: z.string().optional(),
-    })
-    .optional(),
   specifications: z
     .union([
       z.object({
@@ -164,6 +151,20 @@ const baseSchema = z.object({
       ),
     ])
     .optional(),
+  sidebar: z
+    .object({
+      label: z.string().optional(),
+      badge: z.string().optional(),
+      color: z.string().optional(),
+      backgroundColor: z.string().optional(),
+    })
+    .optional(),
+  repository: z
+    .object({
+      language: z.string().optional(),
+      url: z.string().optional(),
+    })
+    .optional(),
   hidden: z.boolean().optional(),
   editUrl: z.string().optional(),
   resourceGroups: z
@@ -226,6 +227,8 @@ const baseSchema = z.object({
     .optional(),
 });
 
+const agentBaseSchema = baseSchema.omit({ specifications: true });
+
 const flowStep = z
   .union([
     // Can be a string or a number just to reference a step
@@ -260,10 +263,11 @@ const flows = defineCollection({
         z
           .object({
             id: z.union([z.string(), z.number()]),
-            type: z.enum(['node', 'message', 'user', 'actor']).optional(),
+            type: z.enum(['node', 'message', 'agent', 'user', 'actor']).optional(),
             title: z.string(),
             summary: z.string().optional(),
             message: pointer.optional(),
+            agent: pointer.optional(),
             service: pointer.optional(),
             flow: pointer.optional(),
             container: pointer.optional(),
@@ -312,6 +316,7 @@ const flows = defineCollection({
             // Either one or non types can be present
             const typesUsed = [
               data.message,
+              data.agent,
               data.service,
               data.flow,
               data.container,
@@ -496,6 +501,55 @@ const services = defineCollection({
     .extend(baseSchema.shape),
 });
 
+const agentTool = z.object({
+  name: z.string(),
+  type: z.string(),
+  icon: z.string().optional(),
+  url: z.string().optional(),
+  description: z.string().optional(),
+});
+
+const agentModel = z.object({
+  provider: z.string().optional(),
+  name: z.string().optional(),
+  version: z.string().optional(),
+});
+
+const agents = defineCollection({
+  loader: glob({
+    pattern: withIgnoredBuildArtifacts(['**/agents/*/index.(md|mdx)', '**/agents/*/versioned/*/index.(md|mdx)']),
+    base: projectDirBase,
+    generateId: ({ data }) => {
+      return `${data.id}-${data.version}`;
+    },
+  }),
+  schema: z
+    .object({
+      sends: z.array(sendsPointer).optional(),
+      receives: z.array(receivesPointer).optional(),
+      writesTo: z.array(pointer).optional(),
+      readsFrom: z.array(pointer).optional(),
+      flows: z.array(pointer).optional(),
+      model: agentModel.optional(),
+      tools: z.array(agentTool).optional(),
+      specifications: z.undefined().optional(),
+      detailsPanel: z
+        .object({
+          domains: detailPanelPropertySchema.optional(),
+          messages: detailPanelPropertySchema.optional(),
+          versions: detailPanelPropertySchema.optional(),
+          repository: detailPanelPropertySchema.optional(),
+          owners: detailPanelPropertySchema.optional(),
+          changelog: detailPanelPropertySchema.optional(),
+          containers: detailPanelPropertySchema.optional(),
+          tools: detailPanelPropertySchema.optional(),
+          model: detailPanelPropertySchema.optional(),
+        })
+        .optional(),
+    })
+    .extend(baseSchema.shape),
+});
+
 // 1) Put this near your other enums/utilities
 const containerTypeEnum = z.enum([
   // Core
@@ -566,10 +620,10 @@ const resourceDocs = defineCollection({
     // Resource-level docs are restricted to known resource paths.
     // This avoids scanning external docs such as node_modules/**/docs.
     pattern: withIgnoredBuildArtifacts([
-      '{events,commands,queries,services,flows,containers,channels,entities,data-products}/**/docs/**/*.@(md|mdx)',
-      '{events,commands,queries,services,flows,containers,channels,entities,data-products}/**/docs/*.@(md|mdx)',
-      '{events,commands,queries,services,flows,containers,channels,entities,data-products}/**/versioned/*/docs/**/*.@(md|mdx)',
-      '{events,commands,queries,services,flows,containers,channels,entities,data-products}/**/versioned/*/docs/*.@(md|mdx)',
+      '{agents,events,commands,queries,services,flows,containers,channels,entities,data-products}/**/docs/**/*.@(md|mdx)',
+      '{agents,events,commands,queries,services,flows,containers,channels,entities,data-products}/**/docs/*.@(md|mdx)',
+      '{agents,events,commands,queries,services,flows,containers,channels,entities,data-products}/**/versioned/*/docs/**/*.@(md|mdx)',
+      '{agents,events,commands,queries,services,flows,containers,channels,entities,data-products}/**/versioned/*/docs/*.@(md|mdx)',
       'domains/**/docs/**/*.@(md|mdx)',
       'domains/**/docs/*.@(md|mdx)',
     ]),
@@ -581,10 +635,10 @@ const resourceDocs = defineCollection({
 const resourceDocCategories = defineCollection({
   loader: glob({
     pattern: withIgnoredBuildArtifacts([
-      '{events,commands,queries,services,flows,containers,channels,entities,data-products}/**/docs/**/category.json',
-      '{events,commands,queries,services,flows,containers,channels,entities,data-products}/**/docs/**/_category_.json',
-      '{events,commands,queries,services,flows,containers,channels,entities,data-products}/**/versioned/*/docs/**/category.json',
-      '{events,commands,queries,services,flows,containers,channels,entities,data-products}/**/versioned/*/docs/**/_category_.json',
+      '{agents,events,commands,queries,services,flows,containers,channels,entities,data-products}/**/docs/**/category.json',
+      '{agents,events,commands,queries,services,flows,containers,channels,entities,data-products}/**/docs/**/_category_.json',
+      '{agents,events,commands,queries,services,flows,containers,channels,entities,data-products}/**/versioned/*/docs/**/category.json',
+      '{agents,events,commands,queries,services,flows,containers,channels,entities,data-products}/**/versioned/*/docs/**/_category_.json',
       'domains/**/docs/**/category.json',
       'domains/**/docs/**/_category_.json',
       'domains/**/docs/category.json',
@@ -614,6 +668,7 @@ const domains = defineCollection({
   schema: z
     .object({
       services: z.array(pointer).optional(),
+      agents: z.array(pointer).optional(),
       domains: z.array(pointer).optional(),
       entities: z.array(pointer).optional(),
       'data-products': z.array(pointer).optional(),
@@ -775,6 +830,7 @@ const users = defineCollection({
     email: z.string().optional(),
     slackDirectMessageUrl: z.string().optional(),
     msTeamsDirectMessageUrl: z.string().optional(),
+    ownedAgents: z.array(reference('agents')).optional(),
     ownedDomains: z.array(reference('domains')).optional(),
     ownedServices: z.array(reference('services')).optional(),
     ownedEvents: z.array(reference('events')).optional(),
@@ -799,6 +855,7 @@ const teams = defineCollection({
     slackDirectMessageUrl: z.string().optional(),
     msTeamsDirectMessageUrl: z.string().optional(),
     members: z.array(reference('users')).optional(),
+    ownedAgents: z.array(reference('agents')).optional(),
     ownedCommands: z.array(reference('commands')).optional(),
     ownedQueries: z.array(reference('queries')).optional(),
     ownedDomains: z.array(reference('domains')).optional(),
@@ -857,6 +914,7 @@ export const collections = {
   commands,
   queries,
   services,
+  agents,
   channels,
   users,
   teams,

package/eventcatalog/src/enterprise/collections/resource-docs-utils.ts

@@ -12,6 +12,7 @@ import { isResourceDocsEnabled } from '../feature';
 const CACHE_ENABLED = process.env.DISABLE_EVENTCATALOG_CACHE !== 'true';
 
 export type ResourceCollection =
+  | 'agents'
   | 'domains'
   | 'services'
   | 'events'
@@ -167,6 +168,7 @@ const inferResourceFromFilePath = (filePath: string): InferredResource | null =>
   };
 
   const segmentMappings: Array<{ segment: string; collection: ResourceCollection }> = [
+    { segment: 'agents', collection: 'agents' },
     { segment: 'events', collection: 'events' },
     { segment: 'commands', collection: 'commands' },
     { segment: 'queries', collection: 'queries' },
@@ -270,8 +272,9 @@ const getResourceLookups = async (): Promise<Record<ResourceCollection, Resource
   }
 
   const lookupPromise = (async () => {
-    const [domains, services, events, commands, queries, flows, containers, channels, entities, dataProducts] = await Promise.all(
-      [
+    const [agents, domains, services, events, commands, queries, flows, containers, channels, entities, dataProducts] =
+      await Promise.all([
+        getCollection('agents'),
         getCollection('domains'),
         getCollection('services'),
         getCollection('events'),
@@ -282,10 +285,10 @@ const getResourceLookups = async (): Promise<Record<ResourceCollection, Resource
         getCollection('channels'),
         getCollection('entities'),
         getCollection('data-products'),
-      ]
-    );
+      ]);
 
     return {
+      agents: buildLookup(agents),
       domains: buildLookup(domains),
       services: buildLookup(services),
       events: buildLookup(events),

package/eventcatalog/src/enterprise/mcp/mcp-server.ts

@@ -327,8 +327,8 @@ function createMcpServer() {
     {
       name: 'All Resources in EventCatalog',
       uri: 'eventcatalog://all',
-      description: 'All messages, domains and services in EventCatalog',
-      collections: ['events', 'commands', 'queries', 'services', 'domains', 'flows', 'channels', 'entities'] as const,
+      description: 'All messages, agents, domains and services in EventCatalog',
+      collections: ['events', 'commands', 'queries', 'agents', 'services', 'domains', 'flows', 'channels', 'entities'] as const,
     },
     {
       name: 'All Events in EventCatalog',
@@ -354,6 +354,12 @@ function createMcpServer() {
       description: 'All services in EventCatalog',
       collections: ['services'] as const,
     },
+    {
+      name: 'All Agents in EventCatalog',
+      uri: 'eventcatalog://agents',
+      description: 'All agents in EventCatalog',
+      collections: ['agents'] as const,
+    },
     {
       name: 'All Domains in EventCatalog',
       uri: 'eventcatalog://domains',
@@ -454,6 +460,7 @@ const mcpResources = [
   'eventcatalog://events',
   'eventcatalog://commands',
   'eventcatalog://queries',
+  'eventcatalog://agents',
   'eventcatalog://services',
   'eventcatalog://domains',
   'eventcatalog://flows',

package/eventcatalog/src/enterprise/tools/catalog-tools.ts

@@ -15,6 +15,7 @@ import { getUbiquitousLanguageWithSubdomains } from '@utils/collections/domains'
 import { getAbsoluteFilePathForAstroFile } from '@utils/files';
 import fs from 'node:fs';
 import { getNodesAndEdges as getNodesAndEdgesForService } from '@utils/node-graphs/services-node-graph';
+import { getNodesAndEdges as getNodesAndEdgesForAgent } from '@utils/node-graphs/agents-node-graph';
 import {
   getNodesAndEdgesForCommands,
   getNodesAndEdgesForEvents,
@@ -101,6 +102,7 @@ export function paginate<T>(
 
 export const collectionSchema = z.enum([
   'events',
+  'agents',
   'services',
   'commands',
   'queries',
@@ -116,6 +118,7 @@ export const collectionSchema = z.enum([
 export const messageCollectionSchema = z.enum(['events', 'commands', 'queries']);
 
 export const resourceCollectionSchema = z.enum([
+  'agents',
   'services',
   'events',
   'commands',
@@ -131,6 +134,7 @@ export const visualiserCollectionSchema = z.enum([
   'events',
   'commands',
   'queries',
+  'agents',
   'services',
   'domains',
   'flows',
@@ -243,6 +247,7 @@ export async function findResourcesByOwner(params: { ownerId: string }) {
     'events',
     'commands',
     'queries',
+    'agents',
     'services',
     'domains',
     'flows',
@@ -279,10 +284,11 @@ export async function findResourcesByOwner(params: { ownerId: string }) {
 }
 
 /**
- * Get services that produce (send) a specific message
+ * Get resources that produce (send) a specific message
  */
 export async function getProducersOfMessage(params: { messageId: string; messageVersion: string; messageCollection: string }) {
-  const services = await getCollection('services');
+  const [services, agents] = await Promise.all([getCollection('services'), getCollection('agents')]);
+  const routableResources = [...services, ...agents];
   const message = await getEntry(params.messageCollection as any, `${params.messageId}-${params.messageVersion}`);
 
   if (!message) {
@@ -291,8 +297,8 @@ export async function getProducersOfMessage(params: { messageId: string; message
     };
   }
 
-  const producers = services.filter((service) => {
-    const sends = (service.data as any).sends || [];
+  const producers = routableResources.filter((resource) => {
+    const sends = (resource.data as any).sends || [];
     return sends.some((send: any) => {
       const idMatch = send.id === params.messageId;
       if (!send.version || send.version === 'latest') return idMatch;
@@ -310,16 +316,18 @@ export async function getProducersOfMessage(params: { messageId: string; message
       id: (s.data as any).id,
       version: (s.data as any).version,
       name: (s.data as any).name || (s.data as any).id,
+      collection: s.collection,
     })),
     count: producers.length,
   };
 }
 
 /**
- * Get services that consume (receive) a specific message
+ * Get resources that consume (receive) a specific message
  */
 export async function getConsumersOfMessage(params: { messageId: string; messageVersion: string; messageCollection: string }) {
-  const services = await getCollection('services');
+  const [services, agents] = await Promise.all([getCollection('services'), getCollection('agents')]);
+  const routableResources = [...services, ...agents];
   const message = await getEntry(params.messageCollection as any, `${params.messageId}-${params.messageVersion}`);
 
   if (!message) {
@@ -328,8 +336,8 @@ export async function getConsumersOfMessage(params: { messageId: string; message
     };
   }
 
-  const consumers = services.filter((service) => {
-    const receives = (service.data as any).receives || [];
+  const consumers = routableResources.filter((resource) => {
+    const receives = (resource.data as any).receives || [];
     return receives.some((receive: any) => {
       const idMatch = receive.id === params.messageId;
       if (!receive.version || receive.version === 'latest') return idMatch;
@@ -347,6 +355,7 @@ export async function getConsumersOfMessage(params: { messageId: string; message
       id: (s.data as any).id,
       version: (s.data as any).version,
       name: (s.data as any).name || (s.data as any).id,
+      collection: s.collection,
     })),
     count: consumers.length,
   };
@@ -357,7 +366,8 @@ export async function getConsumersOfMessage(params: { messageId: string; message
  * Returns all affected services (producers and consumers) and their owners
  */
 export async function analyzeChangeImpact(params: { messageId: string; messageVersion: string; messageCollection: string }) {
-  const services = await getCollection('services');
+  const [services, agents] = await Promise.all([getCollection('services'), getCollection('agents')]);
+  const routableResources = [...services, ...agents];
   const message = await getEntry(params.messageCollection as any, `${params.messageId}-${params.messageVersion}`);
 
   if (!message) {
@@ -367,14 +377,14 @@ export async function analyzeChangeImpact(params: { messageId: string; messageVe
   }
 
   // Find producers
-  const producers = services.filter((service) => {
-    const sends = (service.data as any).sends || [];
+  const producers = routableResources.filter((resource) => {
+    const sends = (resource.data as any).sends || [];
     return sends.some((send: any) => send.id === params.messageId);
   });
 
   // Find consumers
-  const consumers = services.filter((service) => {
-    const receives = (service.data as any).receives || [];
+  const consumers = routableResources.filter((resource) => {
+    const receives = (resource.data as any).receives || [];
     return receives.some((receive: any) => receive.id === params.messageId);
   });
 
@@ -405,19 +415,27 @@ export async function analyzeChangeImpact(params: { messageId: string; messageVe
     impact: {
       producerCount: producers.length,
       consumerCount: consumers.length,
-      totalServicesAffected: new Set([...producers, ...consumers].map((s) => (s.data as any).id)).size,
+      totalResourcesAffected: new Set([...producers, ...consumers].map((s) => `${s.collection}:${(s.data as any).id}`)).size,
+      totalServicesAffected: new Set(
+        [...producers, ...consumers].filter((s) => s.collection === 'services').map((s) => (s.data as any).id)
+      ).size,
+      totalAgentsAffected: new Set(
+        [...producers, ...consumers].filter((s) => s.collection === 'agents').map((s) => (s.data as any).id)
+      ).size,
       teamsAffected: Array.from(affectedOwners),
     },
     producers: producers.map((s) => ({
       id: (s.data as any).id,
       version: (s.data as any).version,
       name: (s.data as any).name || (s.data as any).id,
+      collection: s.collection,
       owners: (s.data as any).owners || [],
     })),
     consumers: consumers.map((s) => ({
       id: (s.data as any).id,
       version: (s.data as any).version,
       name: (s.data as any).name || (s.data as any).id,
+      collection: s.collection,
       owners: (s.data as any).owners || [],
     })),
   };
@@ -434,12 +452,16 @@ export async function explainBusinessFlow(params: { flowId: string; flowVersion:
     return { error: `Flow not found: ${params.flowId}-${params.flowVersion}` };
   }
 
-  // Get related services that use this flow
-  const services = await getCollection('services');
+  // Get related services and agents that use this flow
+  const [services, agents] = await Promise.all([getCollection('services'), getCollection('agents')]);
   const relatedServices = services.filter((service) => {
     const flows = (service.data as any).flows || [];
     return flows.some((f: any) => f.id === params.flowId);
   });
+  const relatedAgents = agents.filter((agent) => {
+    const flows = (agent.data as any).flows || [];
+    return flows.some((f: any) => f.id === params.flowId);
+  });
 
   return {
     flow: {
@@ -458,6 +480,11 @@ export async function explainBusinessFlow(params: { flowId: string; flowVersion:
       version: (s.data as any).version,
       name: (s.data as any).name || (s.data as any).id,
     })),
+    relatedAgents: relatedAgents.map((a) => ({
+      id: (a.data as any).id,
+      version: (a.data as any).version,
+      name: (a.data as any).name || (a.data as any).id,
+    })),
   };
 }
 
@@ -583,15 +610,16 @@ export async function findMessageBySchemaId(params: {
     const resource = matches[0];
     if (resource) {
       // Get producers and consumers
-      const services = await getCollection('services');
+      const [services, agents] = await Promise.all([getCollection('services'), getCollection('agents')]);
+      const routableResources = [...services, ...agents];
 
-      const producers = services.filter((service) => {
-        const sends = (service.data as any).sends || [];
+      const producers = routableResources.filter((resource) => {
+        const sends = (resource.data as any).sends || [];
         return sends.some((send: any) => send.id === params.messageId);
       });
 
-      const consumers = services.filter((service) => {
-        const receives = (service.data as any).receives || [];
+      const consumers = routableResources.filter((resource) => {
+        const receives = (resource.data as any).receives || [];
         return receives.some((receive: any) => receive.id === params.messageId);
       });
 
@@ -608,11 +636,13 @@ export async function findMessageBySchemaId(params: {
           id: (s.data as any).id,
           version: (s.data as any).version,
           name: (s.data as any).name || (s.data as any).id,
+          collection: s.collection,
         })),
         consumers: consumers.map((s) => ({
           id: (s.data as any).id,
           version: (s.data as any).version,
           name: (s.data as any).name || (s.data as any).id,
+          collection: s.collection,
         })),
       };
     }
@@ -854,6 +884,7 @@ export async function getDataProductOutputs(params: { dataProductId: string; dat
 // ============================================
 
 const getNodesAndEdgesFunctions = {
+  agents: getNodesAndEdgesForAgent,
   services: getNodesAndEdgesForService,
   events: getNodesAndEdgesForEvents,
   commands: getNodesAndEdgesForCommands,
@@ -926,19 +957,22 @@ export async function getArchitectureDiagramAsMermaid(params: {
 
 export const toolDescriptions = {
   getResources:
-    'Use this tool to get events, services, commands, queries, flows, domains, channels, entities from EventCatalog. Supports pagination via cursor and filtering by search term (searches name, id, and summary).',
+    'Use this tool to get events, agents, services, commands, queries, flows, domains, channels, entities from EventCatalog. Supports pagination via cursor and filtering by search term (searches name, id, and summary).',
   getResource: 'Use this tool to get a specific resource from EventCatalog by its id and version',
   getMessagesProducedOrConsumedByResource:
     'Use this tool to get the messages produced or consumed by a resource by its id and version. Look at the `sends` and `receives` properties to get the messages produced or consumed by the resource',
   getSchemaForResource:
     'Use this tool to get the schema or specifications (openapi or asyncapi or graphql) for a resource by its id and version',
-  findResourcesByOwner: 'Use this tool to find all resources (services, events, commands, etc.) owned by a specific team or user',
-  getProducersOfMessage: 'Use this tool to find which services produce (send) a specific message (event, command, or query)',
-  getConsumersOfMessage: 'Use this tool to find which services consume (receive) a specific message (event, command, or query)',
+  findResourcesByOwner:
+    'Use this tool to find all resources (agents, services, events, commands, etc.) owned by a specific team or user',
+  getProducersOfMessage:
+    'Use this tool to find which agents or services produce (send) a specific message (event, command, or query)',
+  getConsumersOfMessage:
+    'Use this tool to find which agents or services consume (receive) a specific message (event, command, or query)',
   analyzeChangeImpact:
-    'Use this tool to analyze the impact of changing a message. Returns all affected services (producers and consumers), the teams that own them, and the blast radius of the change',
+    'Use this tool to analyze the impact of changing a message. Returns all affected agents and services (producers and consumers), the teams that own them, and the blast radius of the change',
   explainBusinessFlow:
-    'Use this tool to get detailed information about a business flow (state machine). Returns the flow definition, steps, mermaid diagram if available, and related services',
+    'Use this tool to get detailed information about a business flow (state machine). Returns the flow definition, steps, mermaid diagram if available, and related agents and services',
   getTeams:
     'Use this tool to get all teams in EventCatalog. Teams are groups of users that own resources. Supports pagination via cursor.',
   getTeam: 'Use this tool to get a specific team by its id. Returns team details including members.',
@@ -954,5 +988,5 @@ export const toolDescriptions = {
   getDataProductOutputs:
     'Use this tool to get the outputs (resources produced) for a data product. Returns fully hydrated output resources with their id, version, name, summary, collection type, and data contracts (if defined). Data contracts include the contract name, path, format, type, and content.',
   getArchitectureDiagramAsMermaid:
-    'Use this tool to get the architecture diagram for a resource as Mermaid flowchart code. This shows how the resource connects to other resources (services, events, channels, etc.) in the architecture. The mermaid code can be rendered to visualize the architecture or used to understand relationships. Supported collections: events, commands, queries, services, domains, flows, containers, data-products.',
+    'Use this tool to get the architecture diagram for a resource as Mermaid flowchart code. This shows how the resource connects to other resources (agents, services, events, channels, etc.) in the architecture. The mermaid code can be rendered to visualize the architecture or used to understand relationships. Supported collections: events, commands, queries, agents, services, domains, flows, containers, data-products.',
 };

package/eventcatalog/src/layouts/VerticalSideBarLayout.astro

@@ -59,6 +59,7 @@ import { getCommands } from '@utils/collections/commands';
 import { getDomains } from '@utils/collections/domains';
 import { getEvents } from '@utils/collections/events';
 import { getServices } from '@utils/collections/services';
+import { getAgents } from '@utils/collections/agents';
 import { getFlows } from '@utils/collections/flows';
 import { isCollectionVisibleInCatalog } from '@eventcatalog';
 import { buildUrl } from '@utils/url-builder';
@@ -75,15 +76,17 @@ let events: any[] = [];
 let commands: any[] = [];
 let queries: any[] = [];
 let services: any[] = [];
+let agents: any[] = [];
 let domains: any[] = [];
 let flows: any[] = [];
 
 if (!catalogHasDefaultLandingPageForDocs) {
-  [events, commands, queries, services, domains, flows] = await Promise.all([
+  [events, commands, queries, services, agents, domains, flows] = await Promise.all([
     getEvents({ getAllVersions: false, hydrateServices: false }),
     getCommands({ getAllVersions: false, hydrateServices: false }),
     getQueries({ getAllVersions: false, hydrateServices: false }),
     getServices({ getAllVersions: false }),
+    getAgents({ getAllVersions: false }),
     getDomains({ getAllVersions: false }),
     getFlows({ getAllVersions: false }),
   ]);
@@ -106,6 +109,7 @@ const getDefaultUrl = (route: string, defaultValue: string) => {
   const collections = [
     { data: domains, key: 'domains' },
     { data: services, key: 'services' },
+    { data: agents, key: 'agents' },
     { data: events, key: 'events' },
     { data: commands, key: 'commands' },
     { data: queries, key: 'queries' },
@@ -273,6 +277,14 @@ const browseItems = filterSidebarItems(
       href: buildUrl('/discover/data-products'),
       current: currentPath === buildUrl('/discover/data-products'),
     },
+    {
+      id: '/discover/agents',
+      aliases: ['/discover'],
+      label: 'Agents',
+      icon: BotMessageSquare,
+      href: buildUrl('/discover/agents'),
+      current: currentPath === buildUrl('/discover/agents'),
+    },
   ],
   userSideBarConfiguration
 );

package/eventcatalog/src/pages/_index.astro

@@ -29,8 +29,6 @@ const queries = allQueries.filter(isCurrentVersion);
 const messages = [...events, ...commands, ...queries];
 const flows = allFlows.filter(isCurrentVersion);
 
-const totalResources = domains.length + services.length + messages.length + flows.length;
-
 const getDefaultUrl = (route: string, defaultValue: string) => {
   if (domains.length > 0) return buildUrl(`/${route}/domains/${domains[0].data.id}/${domains[0].data.version}`);
   if (services.length > 0) return buildUrl(`/${route}/services/${services[0].data.id}/${services[0].data.version}`);
@@ -106,7 +104,7 @@ const exploreCards: ExploreCard[] = [
   },
   {
     title: 'Discover',
-    description: 'Search every event, service, and team across the catalog.',
+    description: 'Search every event, service, agent, and team across the catalog.',
     icon: TableProperties,
     href: buildUrl('/discover/events'),
     tone: '94 234 212', // teal-300

package/eventcatalog/src/pages/architecture/[type]/[id]/[version]/_index.data.ts

@@ -5,6 +5,8 @@ import { pageDataLoader } from '@utils/page-loaders/page-data-loader';
 import { getDomains } from '@utils/collections/domains';
 import { getServices } from '@utils/collections/services';
 
+const architecturePageTypes: PageTypes[] = ['services', 'domains'];
+
 /**
  * Documentation page class for all collection types with versioning
  */
@@ -14,8 +16,6 @@ export class Page extends HybridPage {
       return [];
     }
 
-    const itemTypes: PageTypes[] = ['services', 'domains'];
-
     const domains = await getDomains({ enrichServices: true });
     const services = await getServices();
 
@@ -24,12 +24,12 @@ export class Page extends HybridPage {
     return pageData.flatMap((items, index) =>
       items.map((item) => ({
         params: {
-          type: itemTypes[index],
+          type: architecturePageTypes[index],
           id: item.data.id,
           version: item.data.version,
         },
         props: {
-          type: itemTypes[index],
+          type: architecturePageTypes[index],
           ...item,
           // Not everything needs the body of the page itself.
           body: undefined,
@@ -41,7 +41,7 @@ export class Page extends HybridPage {
   protected static async fetchData(params: any) {
     const { type, id, version } = params;
 
-    if (!type || !id || !version) {
+    if (!type || !id || !version || !architecturePageTypes.includes(type)) {
       return null;
     }