@eventcatalog/core 3.1.0 → 3.2.0

package/eventcatalog/src/components/ChatPanel/ChatPanelButton.tsx

@@ -9,11 +9,11 @@ const ChatPanelButton = () => {
     <>
       <button
         onClick={() => setIsOpen(true)}
-        className="flex items-center gap-1.5 px-4 py-1.5 rounded-md bg-white hover:bg-gray-50 ring-1 ring-inset ring-gray-300 shadow-sm transition-colors text-sm ml-[-1px]"
+        className="flex items-center gap-1.5 px-4 py-1.5 rounded-md bg-[rgb(var(--ec-card-bg))] hover:bg-[rgb(var(--ec-content-hover))] ring-1 ring-inset ring-[rgb(var(--ec-page-border))] shadow-sm transition-colors text-sm ml-[-1px]"
         aria-label="Open AI Assistant"
       >
         <BookOpen size={14} className="text-[rgb(var(--ec-accent))]" />
-        <span className="font-light text-gray-600">Ask</span>
+        <span className="font-light text-[rgb(var(--ec-page-text-muted))]">Ask</span>
       </button>
 
       <ChatPanel isOpen={isOpen} onClose={() => setIsOpen(false)} />

package/eventcatalog/src/enterprise/ai/chat-api.ts

@@ -28,7 +28,10 @@ try {
   model = await providerConfiguration.default();
   modelConfiguration = providerConfiguration.configuration || defaultConfiguration;
   hasChatConfiguration = true;
-  extendedTools = providerConfiguration.tools || {};
+
+  if (isEventCatalogScaleEnabled()) {
+    extendedTools = providerConfiguration.tools || {};
+  }
 } catch (error) {
   console.error('[Chat] Error loading chat configuration', error);
   hasChatConfiguration = false;
@@ -111,12 +114,14 @@ When responding:
 5. Don't provide code examples unless specifically requested.
 6. When you refer to a resource in EventCatalog, try and create a link to the resource in the response
     - Example, if you return a message in the text, rather than than just the id or version you should return a markdown link to the resource e.g [MyEvent - 1.0.0](/docs/events/MyEvent/1.0.0)
-    - NEVER return "latest" in the markdown link, always use the specific version
+    - CRITICAL: NEVER use "latest" in any URL or link. Always use the actual semantic version number (e.g., 1.0.0, 2.1.3). The word "latest" is not a valid version and will result in broken links.
     - The link options are:
         - If you want to get the documentation for a resource use the /docs/ prefix (e.g /docs/{collection}/{id}/{version})
         - If you want to let the user know they can visualize a resource use the /visualiser/ prefix (e.g /visualiser/{collection}/{id}/{version})
         - If you want to let the user know they can see the architecture of a resource use the /architecture/ prefix (e.g /architecture/{collection}/{id}/{version})
+    - If you don't know the version, use the getResource tool to fetch the resource and get the actual version number before creating the link.
 7. When you return a schema, use code blocks to render the schema to the user too, for example if the schema is in JSON format use \`\`\`json and if the schema is in YAML format use \`\`\`yaml
+8. IMPORTANT: After answering each question, ALWAYS use the suggestFollowUpQuestions tool to suggest 2-3 relevant follow-up questions the user might want to ask next. These should be contextual to the conversation and help the user explore related topics.
 
 If you have additional context, use it to answer the question.`;
 
@@ -171,7 +176,7 @@ export const POST = async ({ request }: APIContext<{ question: string; messages:
     const result = await streamText({
       model,
       system: getBaseSystemPrompt(referrer ?? ''),
-      messages: convertToModelMessages(messages) as ModelMessage[],
+      messages: await convertToModelMessages(messages),
       temperature: modelConfiguration?.temperature ?? 0.7,
       stopWhen: stepCountIs(5),
       // maxTokens: 4000, // Increased to handle large tool results
@@ -320,6 +325,22 @@ export const POST = async ({ request }: APIContext<{ question: string; messages:
             return [];
           },
         }),
+        suggestFollowUpQuestions: tool({
+          description:
+            'Use this tool after answering a question to suggest 2-3 relevant follow-up questions the user might want to ask. These will be displayed as clickable suggestions.',
+          inputSchema: z.object({
+            questions: z
+              .array(z.string())
+              .min(1)
+              .max(3)
+              .describe('Array of 2-3 follow-up questions relevant to the conversation'),
+          }),
+          execute: async ({ questions }) => {
+            // This tool doesn't need to do anything - it just returns the questions
+            // which will be captured by the UI
+            return { suggestions: questions };
+          },
+        }),
         ...extendedTools,
       },
     });

package/package.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/event-catalog/eventcatalog.git"
   },
   "type": "module",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "publishConfig": {
     "access": "public"
   },
@@ -20,7 +20,7 @@
     "dist/"
   ],
   "dependencies": {
-    "@ai-sdk/react": "^2.0.60",
+    "@ai-sdk/react": "^3.0.17",
     "@astrojs/markdown-remark": "^6.3.10",
     "@astrojs/mdx": "^4.3.13",
     "@astrojs/node": "^9.5.1",
@@ -53,8 +53,8 @@
     "@tanstack/react-query": "^5.74.3",
     "@tanstack/react-table": "^8.17.3",
     "@xyflow/react": "^12.3.6",
-    "ai": "^5.0.60",
-    "astro": "^5.16.6",
+    "ai": "^6.0.17",
+    "astro": "^5.16.7",
     "astro-compress": "^2.3.8",
     "astro-expressive-code": "^0.41.3",
     "astro-seo": "^0.8.4",
@@ -94,7 +94,7 @@
     "rehype-slug": "^6.0.0",
     "remark-comment": "^1.0.0",
     "remark-directive": "^3.0.0",
-    "remark-gfm": "^3.0.1",
+    "remark-gfm": "^4.0.1",
     "rimraf": "^5.0.7",
     "semver": "7.6.3",
     "shelljs": "^0.9.0",
@@ -103,7 +103,8 @@
     "typescript": "^5.4.5",
     "unist-util-visit": "^5.0.0",
     "update-notifier": "^7.3.1",
-    "uuid": "^10.0.0"
+    "uuid": "^10.0.0",
+    "zod": "^3.25.0"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.6",