@eventcatalog/core 3.0.0-beta.2 → 3.0.0-beta.21

package/eventcatalog/src/enterprise/eventcatalog-chat/pages/chat/index.astro

@@ -1,104 +0,0 @@
----
-import VerticalSideBarLayout from '@layouts/VerticalSideBarLayout.astro';
-import Chat from '@enterprise/eventcatalog-chat/components/Chat';
-import { getChatPromptsGroupedByCategory } from '@enterprise/eventcatalog-chat/utils/chat-prompts';
-import config from '@config';
-import { Code } from 'astro-expressive-code/components';
-import { getDomains } from '@utils/collections/domains';
-import { getEvents } from '@utils/collections/events';
-import { getCommands } from '@utils/collections/commands';
-import { getServices } from '@utils/collections/services';
-import { getQueries } from '@utils/collections/queries';
-
-const isEnabled = config.chat?.enabled || false;
-const chatConfig = config.chat || {};
-const output = config.output || 'static';
-
-// Get all information for the mention input
-const [events, commands, queries, services, domains] = await Promise.all([
-  getEvents({ getAllVersions: false }),
-  getCommands({ getAllVersions: false }),
-  getQueries({ getAllVersions: false }),
-  getServices({ getAllVersions: false }),
-  getDomains({ getAllVersions: false }),
-]);
-const allItems = [...events, ...commands, ...queries, ...services, ...domains];
-
-const chatPrompts = await getChatPromptsGroupedByCategory();
-
-const resources = allItems.map((item) => ({ id: item.data.id, type: item.collection, name: item.data.name }));
----
-
-<VerticalSideBarLayout title="AI Chat" showNestedSideBar={false}>
-  <div class="flex h-[calc(100vh-60px)] bg-white">
-    {
-      isEnabled ? (
-        <>
-          <div id="chatContainer" class="w-full">
-            <Chat
-              client:only="react"
-              chatConfig={{
-                ...chatConfig,
-              }}
-              resources={resources}
-              chatPrompts={chatPrompts}
-              output={output as 'static' | 'server'}
-            />
-          </div>
-        </>
-      ) : (
-        <div class="flex items-center justify-center w-full p-4 sm:p-8">
-          <div class="max-w-6xl flex flex-col md:flex-row gap-8 md:gap-12 items-center">
-            {/* Left side - Illustration */}
-            <div class="flex-1">
-              <img
-                src="/images/ai-placeholder.png"
-                alt="AI Assistant Illustration"
-                class="w-full max-w-sm md:max-w-md mx-auto  rounded-lg shadow-lg"
-              />
-            </div>
-
-            {/* Right side - Content */}
-            <div class="flex-1">
-              <h2 class="text-2xl md:text-3xl font-bold text-gray-900 mb-4">EventCatalog AI Assistant</h2>
-              <p class="text-gray-600 mb-6 text-base md:text-lg">
-                Chat with your catalog to quickly find information, understand relationships, and get instant answers about your
-                architecture. Our AI-powered assistant makes exploring your event catalog faster and more intuitive than ever.
-              </p>
-
-              <div class="bg-gray-700 rounded-lg p-4 md:p-6 mb-4">
-                <h3 class="text-lg text-white font-semibold mb-3">Quick Setup</h3>
-                <Code code={`npm install @eventcatalog/generator-ai`} lang="bash" frame="none" />
-                <a
-                  href="https://www.eventcatalog.dev/features/ai-assistant"
-                  class="inline-flex items-center text-sm text-white mt-4"
-                >
-                  Learn more about setup →
-                </a>
-              </div>
-              <p class="text-gray-600 mb-6 text-sm">
-                Your data stays private and secure - all processing happens locally on your machine.
-              </p>
-            </div>
-          </div>
-        </div>
-      )
-    }
-  </div>
-</VerticalSideBarLayout>
-
-<style>
-  .loading-status.ready {
-    background-color: rgb(240 253 244); /* light green bg */
-    color: rgb(22 163 74); /* green text */
-  }
-
-  .loading-status.hidden {
-    display: none;
-  }
-
-  /* Add smooth scrolling behavior */
-  .scroll-smooth {
-    scroll-behavior: smooth;
-  }
-</style>

package/eventcatalog/src/enterprise/eventcatalog-chat/providers/ai-provider.ts

@@ -1,140 +0,0 @@
-import { streamText, tool, type LanguageModel, type UIMessage, stepCountIs, convertToModelMessages } from 'ai';
-import { z } from 'astro/zod';
-import config from '@config';
-
-const getBaseURL = () => {
-  if (import.meta.env.MODE === 'development') {
-    return `http://localhost:${config.port || 3000}`;
-  }
-  return config.homepageLink || 'https://eventcatalog.dev/';
-};
-
-export const getEventCatalogResources = async () => {
-  const baseUrl = process.env.EVENTCATALOG_URL || getBaseURL();
-  const url = new URL('/docs/llm/llms.txt', baseUrl);
-  const response = await fetch(url.toString());
-  const text = await response.text();
-  return text;
-};
-
-export const getResourceInformation = async (type: string, id: string, version: string) => {
-  const baseUrl = process.env.EVENTCATALOG_URL || getBaseURL();
-  const url = new URL(`/docs/${type}/${id}/${version}.mdx`, baseUrl);
-  const response = await fetch(url.toString());
-  const text = await response.text();
-  return text;
-};
-
-// base class for AI providers
-export interface AIProviderOptions {
-  modelId: string;
-  model?: LanguageModel;
-  temperature?: number;
-  topP?: number | undefined;
-  topK?: number | undefined;
-  frequencyPenalty?: number | undefined;
-  presencePenalty?: number | undefined;
-}
-
-export class AIProvider {
-  private model?: string | LanguageModel;
-  private modelId: string;
-  private temperature: number;
-  private topP: number | undefined;
-  private topK: number | undefined;
-  private frequencyPenalty: number | undefined;
-  private presencePenalty: number | undefined;
-  public models: string[];
-
-  constructor({ modelId, model, temperature, topP, topK, frequencyPenalty, presencePenalty }: AIProviderOptions) {
-    this.modelId = modelId;
-    this.temperature = temperature ?? 0.2;
-    this.topP = topP;
-    this.topK = topK;
-    this.frequencyPenalty = frequencyPenalty;
-    this.presencePenalty = presencePenalty;
-    this.models = [];
-
-    if (model) {
-      this.model = model;
-    }
-  }
-
-  async validateModel(model: string): Promise<{ isValidModel: boolean; listOfModels: string[] }> {
-    const isValidModel = this.models.includes(model);
-    return { isValidModel, listOfModels: this.models };
-  }
-
-  async streamText(system: string, messages: Array<UIMessage> | Array<Omit<UIMessage, 'id'>>) {
-    if (!this.model) {
-      throw new Error('Model not set');
-    }
-
-    return await streamText({
-      model: this.model,
-      system: system ?? '',
-      messages: convertToModelMessages(messages),
-      stopWhen: stepCountIs(5),
-      temperature: this.temperature,
-      ...(this.topP && { topP: this.topP }),
-      ...(this.topK && { topK: this.topK }),
-      ...(this.frequencyPenalty && { frequencyPenalty: this.frequencyPenalty }),
-      ...(this.presencePenalty && { presencePenalty: this.presencePenalty }),
-      tools: {
-        findResources: tool({
-          description: [
-            'Find resources that are available in EventCatalog',
-            '',
-            'Use this tool when you need to:',
-            '- Get a list of resources in EventCatalog including services, domains, events, commands, queries and flows, ubiquitous language terms and entities',
-            "- Find a resource's id and version to aid other tool requests",
-            '- Just return the list of matched resources in EventCatalog with a short description of each resource',
-            "- Don't return bullet points, just return the list of resources in a readable format",
-            '- Include the resource name, description, and a link to the resource',
-            '- When you return a link, remove the .mdx from the end of the url',
-            '- Return a list of messages the resource produces and consumes, these are marked as sends and receives',
-            '- If the resource has a domain, include it in the response',
-            '- Ask the user if they would like more information about a specific resource',
-            '- When you return a message, in brackets let me know if its a query, command or event',
-            `- The host URL is ${process.env.EVENTCATALOG_URL}`,
-          ].join('\n'),
-          inputSchema: z.object({}),
-          execute: async () => {
-            const text = await getEventCatalogResources();
-            return text;
-          },
-        }),
-        findResource: tool({
-          description: [
-            'Get more information about a service, domain, event, command, query or flow in EventCatalog using its id and version',
-            'Use this tool when you need to:',
-            '- Get more details/information about a service, domain, event, command, query, flow or entity in EventCatalog',
-            '- Use the id to find more information about a service, domain, event, command, query, flow or entity',
-            '- Return everything you know about this resource',
-            '- If the resource has a specification return links to the specification file',
-            '- When you find owners the url would look something like /docs/users/{id} if its a user or /docs/teams/{id} if its a team',
-            '- When you return the producers and consumers (the messages the service produces and consumes) make sure they include the url to the documentation, the url would look something like /docs/{type}/{id}, e.g /docs/events/MyEvent/1.0.0 or /docs/commands/MyCommand/1.0.0',
-            '- When you return owners make sure they include the url to the documentation',
-            '- If the resource has a domain, include it in the response',
-            '- Ask the user if they would like more information about a specific resource',
-            '- When you return a message, in brackets let me know if its a query, command or event',
-            `- If you are returning a flow (state machine) try and return the result in mermaid to the user, visualizing how the business logic flows`,
-            `- If you return any URLS make sure to include the host URL ${process.env.EVENTCATALOG_URL}`,
-            '- You will ALWAYS return the visualizer URL in an IFRAME in the given response - example <iframe src="http://localhost:3000/visualiser/{type}/{id}/{version}?embed=true"></iframe>',
-          ].join('\n'),
-          inputSchema: z.object({
-            id: z.string().describe('The id of the resource to find'),
-            version: z.string().describe('The version of the resource to find'),
-            type: z
-              .enum(['services', 'domains', 'events', 'commands', 'queries', 'flows', 'entities'])
-              .describe('The type of resource to find'),
-          }),
-          execute: async ({ id, version, type }) => {
-            const text = await getResourceInformation(type, id, version);
-            return text;
-          },
-        }),
-      },
-    });
-  }
-}

package/eventcatalog/src/enterprise/eventcatalog-chat/providers/anthropic.ts

@@ -1,28 +0,0 @@
-import { anthropic } from '@ai-sdk/anthropic';
-import { AIProvider, type AIProviderOptions } from './ai-provider';
-
-const AVAILABLE_GOOGLE_MODELS = [
-  'claude-3-7-sonnet-20250219',
-  'claude-3-5-sonnet-latest',
-  'claude-3-5-sonnet-20241022',
-  'claude-3-5-sonnet-20240620',
-  'claude-3-5-haiku-latest',
-  'claude-3-5-haiku-20241022',
-  'claude-3-opus-latest',
-  'claude-3-opus-20240229',
-  'claude-3-sonnet-20240229',
-  'claude-3-haiku-20240307',
-] as const;
-
-export class AnthropicProvider extends AIProvider {
-  public models: string[] = [...AVAILABLE_GOOGLE_MODELS];
-
-  constructor(options: AIProviderOptions) {
-    const languageModel = anthropic(options.modelId || 'claude-3-7-sonnet-20250219');
-
-    super({
-      ...options,
-      model: languageModel,
-    });
-  }
-}

package/eventcatalog/src/enterprise/eventcatalog-chat/providers/google.ts

@@ -1,41 +0,0 @@
-import { google } from '@ai-sdk/google';
-import { AIProvider, type AIProviderOptions } from './ai-provider';
-
-const AVAILABLE_GOOGLE_MODELS = [
-  'gemini-1.5-flash',
-  'gemini-1.5-flash-latest',
-  'gemini-1.5-flash-001',
-  'gemini-1.5-flash-002',
-  'gemini-1.5-flash-8b',
-  'gemini-1.5-flash-8b-latest',
-  'gemini-1.5-flash-8b-001',
-  'gemini-1.5-pro',
-  'gemini-1.5-pro-latest',
-  'gemini-1.5-pro-001',
-  'gemini-1.5-pro-002',
-  'gemini-2.0-flash',
-  'gemini-2.0-flash-001',
-  'gemini-2.0-flash-live-001',
-  'gemini-2.0-flash-lite',
-  'gemini-2.0-pro-exp-02-05',
-  'gemini-2.0-flash-thinking-exp-01-21',
-  'gemini-2.0-flash-exp',
-  'gemini-2.5-pro-exp-03-25',
-  'gemini-2.5-pro-preview-05-06',
-  'gemini-2.5-flash-preview-04-17',
-  'gemini-exp-1206',
-  'gemma-3-27b-it',
-  'learnlm-1.5-pro-experimental',
-] as const;
-
-export class GoogleProvider extends AIProvider {
-  public models: string[] = [...AVAILABLE_GOOGLE_MODELS];
-
-  constructor(options: AIProviderOptions) {
-    const languageModel = google(options.modelId || 'gemini-1.5-flash');
-    super({
-      ...options,
-      model: languageModel,
-    });
-  }
-}

package/eventcatalog/src/enterprise/eventcatalog-chat/providers/index.ts

@@ -1,26 +0,0 @@
-import { OpenAIProvider } from './openai';
-import { GoogleProvider } from './google';
-import { AnthropicProvider } from './anthropic';
-import type { AIProviderOptions } from './ai-provider';
-
-export function getProvider(provider: string, options: AIProviderOptions) {
-  switch (provider) {
-    case 'openai':
-      return new OpenAIProvider({
-        ...options,
-        modelId: options.modelId,
-      });
-    case 'google':
-      return new GoogleProvider({
-        ...options,
-        modelId: options.modelId,
-      });
-    case 'anthropic':
-      return new AnthropicProvider({
-        ...options,
-        modelId: options.modelId,
-      });
-    default:
-      throw new Error(`Provider ${provider} not supported`);
-  }
-}

package/eventcatalog/src/enterprise/eventcatalog-chat/providers/openai.ts

@@ -1,61 +0,0 @@
-import { openai } from '@ai-sdk/openai';
-import { AIProvider, type AIProviderOptions } from './ai-provider';
-
-const AVAILABLE_OPENAI_MODELS = [
-  'o1',
-  'o1-2024-12-17',
-  'o1-mini',
-  'o1-mini-2024-09-12',
-  'o1-preview',
-  'o1-preview-2024-09-12',
-  'o3-mini',
-  'o3-mini-2025-01-31',
-  'o3',
-  'o3-2025-04-16',
-  'o4-mini',
-  'o4-mini-2025-04-16',
-  'gpt-4.1',
-  'gpt-4.1-2025-04-14',
-  'gpt-4.1-mini',
-  'gpt-4.1-mini-2025-04-14',
-  'gpt-4.1-nano',
-  'gpt-4.1-nano-2025-04-14',
-  'gpt-4o',
-  'gpt-4o-2024-05-13',
-  'gpt-4o-2024-08-06',
-  'gpt-4o-2024-11-20',
-  'gpt-4o-audio-preview',
-  'gpt-4o-audio-preview-2024-10-01',
-  'gpt-4o-audio-preview-2024-12-17',
-  'gpt-4o-search-preview',
-  'gpt-4o-search-preview-2025-03-11',
-  'gpt-4o-mini-search-preview',
-  'gpt-4o-mini-search-preview-2025-03-11',
-  'gpt-4o-mini',
-  'gpt-4o-mini-2024-07-18',
-  'gpt-4-turbo',
-  'gpt-4-turbo-2024-04-09',
-  'gpt-4-turbo-preview',
-  'gpt-4-0125-preview',
-  'gpt-4-1106-preview',
-  'gpt-4',
-  'gpt-4-0613',
-  'gpt-4.5-preview',
-  'gpt-4.5-preview-2025-02-27',
-  'gpt-3.5-turbo-0125',
-  'gpt-3.5-turbo',
-  'gpt-3.5-turbo-1106',
-  'chatgpt-4o-latest',
-] as const;
-
-export class OpenAIProvider extends AIProvider {
-  public models: string[] = [...AVAILABLE_OPENAI_MODELS];
-
-  constructor(options: AIProviderOptions) {
-    const languageModel = openai(options.modelId || 'o4-mini');
-    super({
-      ...options,
-      model: languageModel,
-    });
-  }
-}

package/eventcatalog/src/enterprise/eventcatalog-chat/utils/chat-prompts.ts

@@ -1,50 +0,0 @@
-import { getCollection } from 'astro:content';
-import type { CollectionEntry } from 'astro:content';
-
-export type ChatPrompt = CollectionEntry<'chatPrompts'>;
-
-// Update cache to store both versions
-let cachedChatPrompts: Record<string, ChatPrompt[]> = {
-  allVersions: [],
-  currentVersions: [],
-};
-
-export const getChatPrompts = async (): Promise<ChatPrompt[]> => {
-  const cacheKey = 'allVersions';
-
-  // Check if we have cached domains for this specific getAllVersions value
-  if (cachedChatPrompts[cacheKey].length > 0) {
-    return cachedChatPrompts[cacheKey];
-  }
-
-  const prompts = await getCollection('chatPrompts');
-
-  return prompts;
-};
-
-export type ChatPromptCategoryGroup = {
-  label: string;
-  icon?: string;
-  items: ChatPrompt[];
-};
-
-export const getChatPromptsGroupedByCategory = async (): Promise<ChatPromptCategoryGroup[]> => {
-  const prompts = await getChatPrompts();
-
-  const grouped = prompts.reduce(
-    (acc, prompt) => {
-      const { id, label, icon } = prompt.data.category;
-
-      if (!acc[id]) {
-        acc[id] = { label, icon, items: [] };
-      }
-
-      acc[id].items.push(prompt);
-      return acc;
-    },
-    {} as Record<string, { label: string; icon?: string; items: ChatPrompt[] }>
-  );
-
-  // Convert the grouped object into the desired array format
-  return Object.values(grouped);
-};