@memberjunction/core-entities 5.22.0 → 5.23.0

package/dist/index.d.ts

@@ -21,6 +21,8 @@ export * from './engines/UserViewEngine.js';
 export * from './engines/FileStorageEngine.js';
 export * from './engines/MCPEngine.js';
 export * from './engines/QueryEngine.js';
+export * from './engines/conversations.js';
+export * from './engines/knowledgeHubMetadata.js';
 export * from './artifact-extraction/artifact-extract-rules.js';
 export * from './artifact-extraction/artifact-extractor.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAA;AAEhD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAElD,cAAc,uDAAuD,CAAC;AACtE,cAAc,iEAAiE,CAAC;AAChF,cAAc,2CAA2C,CAAC;AAE1D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAA;AAEhD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAElD,cAAc,uDAAuD,CAAC;AACtE,cAAc,iEAAiE,CAAC;AAChF,cAAc,2CAA2C,CAAC;AAE1D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAE/C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC"}

package/dist/index.js

@@ -21,6 +21,8 @@ export * from './engines/UserViewEngine.js';
 export * from './engines/FileStorageEngine.js';
 export * from './engines/MCPEngine.js';
 export * from './engines/QueryEngine.js';
+export * from './engines/conversations.js';
+export * from './engines/knowledgeHubMetadata.js';
 export * from './artifact-extraction/artifact-extract-rules.js';
 export * from './artifact-extraction/artifact-extractor.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAA;AAEhD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAElD,cAAc,uDAAuD,CAAC;AACtE,cAAc,iEAAiE,CAAC;AAChF,cAAc,2CAA2C,CAAC;AAE1D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAA;AAEhD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAElD,cAAc,uDAAuD,CAAC;AACtE,cAAc,iEAAiE,CAAC;AAChF,cAAc,2CAA2C,CAAC;AAE1D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAE/C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/core-entities",
   "type": "module",
-  "version": "5.22.0",
+  "version": "5.23.0",
   "description": "Entity subclasses for the metadata layer of MemberJunction defined in the MJ_CORE schema (usually '__mj'), distributed as part of each release of MemberJunction",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,10 +21,10 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@memberjunction/ai": "5.22.0",
-    "@memberjunction/core": "5.22.0",
-    "@memberjunction/global": "5.22.0",
-    "@memberjunction/interactive-component-types": "5.22.0",
+    "@memberjunction/ai": "5.23.0",
+    "@memberjunction/core": "5.23.0",
+    "@memberjunction/global": "5.23.0",
+    "@memberjunction/interactive-component-types": "5.23.0",
     "zod": "~3.24.4"
   },
   "repository": {

package/readme.md

@@ -34,8 +34,10 @@ flowchart TD
         AME["ArtifactMetadataEngine"]
         FE["FileStorageEngine"]
         EE["EncryptionEngineBase"]
+        CE["ConversationEngine"]
         ME["MCPEngine"]
         TTC["TypeTablesCache"]
+        KHE["KnowledgeHubMetadataEngine"]
     end
 
     subgraph Extraction["Artifact Extraction"]
@@ -119,7 +121,7 @@ A metadata-driven system for extracting structured attributes from artifact cont
 - **272 strongly-typed entity classes** covering all MemberJunction core schema entities
 - **Zod runtime validation** with field-level constraints and value list enums
 - **Extended entity classes** with permission checks, workflow logic, and JSON state parsing
-- **9 singleton engine caches** eliminating redundant database queries
+- **10 singleton engine caches** eliminating redundant database queries (including KnowledgeHubMetadataEngine for vector/content metadata)
 - **Resource permission engine** with role-based access control (View/Edit/Owner levels)
 - **Dashboard permission engine** with owner/direct/category permission hierarchy
 - **User view engine** with filter-to-SQL conversion and smart filter AI support
@@ -387,10 +389,80 @@ Every generated entity class provides:
 | `DeserializeFromStorage(stored)` | Convert stored attributes back to runtime objects |
 | `GetStandardProperty(attributes, prop)` | Find a standard property value (name/description/etc.) |
 
+### ConversationEngine
+
+Centralized, reactive cache for conversations, conversation details (messages), and peripheral data such as agent runs. `ConversationEngine` is the single source of truth for conversation data across all UI consumers (chat area, sidebar, overlay, etc.), replacing per-component caching that previously lived in multiple scattered locations.
+
+The engine is user-scoped and environment-filtered, so it manages its own caching instead of using `BaseEngine.Load()` bulk-load pattern.
+
+```typescript
+import { ConversationEngine } from '@memberjunction/core-entities';
+
+// Initialize once at app startup
+await ConversationEngine.Instance.Config(false, contextUser);
+
+// Load conversations for the current user and environment
+await ConversationEngine.Instance.LoadConversations(environmentId, contextUser);
+
+// Subscribe to reactive conversation list changes
+ConversationEngine.Instance.Conversations$.subscribe(conversations => {
+    console.log(`${conversations.length} conversations loaded`);
+});
+
+// Load and cache details (messages) for a specific conversation
+const details = await ConversationEngine.Instance.LoadConversationDetails(conversationId, contextUser);
+
+// Instant cache reads (no DB round-trip)
+const cached = ConversationEngine.Instance.GetCachedDetails(conversationId);
+
+// CRUD operations that automatically update the reactive list
+await ConversationEngine.Instance.CreateConversation('New Chat', environmentId, contextUser);
+await ConversationEngine.Instance.PinConversation(conversationId, true, contextUser);
+await ConversationEngine.Instance.ArchiveConversation(conversationId, contextUser);
+
+// Cache management
+ConversationEngine.Instance.InvalidateConversation(conversationId);
+ConversationEngine.Instance.ClearCache();
+```
+
+Source: [`src/engines/conversations.ts`](src/engines/conversations.ts)
+
+### KnowledgeHubMetadataEngine
+
+Caches all Knowledge Hub-related metadata in a single singleton, providing fast lookups for entity documents, vector indexes, vector databases, content sources, content types, content source types, and content file types. Uses `BaseEngine` for automatic caching and entity-event auto-refresh.
+
+```typescript
+import { KnowledgeHubMetadataEngine } from '@memberjunction/core-entities';
+
+const khEngine = KnowledgeHubMetadataEngine.Instance;
+await khEngine.Config(false, contextUser);
+
+// Cached data access (no DB round-trip)
+const activeDocuments = khEngine.GetActiveEntityDocuments();
+const entitiesWithDocs = khEngine.GetEntitiesWithDocuments(); // For dropdowns
+const doc = khEngine.GetEntityDocumentById(docId);
+const docsForEntity = khEngine.GetEntityDocumentsForEntity('Contacts');
+const vectorIndex = khEngine.GetVectorIndexById(indexId);
+const vectorDB = khEngine.GetVectorDatabaseById(dbId);
+
+// Raw cached arrays
+khEngine.EntityDocuments;    // All entity documents
+khEngine.VectorIndexes;      // All vector indexes
+khEngine.VectorDatabases;    // All vector databases
+khEngine.ContentSources;     // All content sources
+khEngine.ContentTypes;       // All content types
+khEngine.ContentSourceTypes; // All content source types (Web, RSS, etc.)
+khEngine.ContentFileTypes;   // All content file types (.pdf, .html, etc.)
+```
+
+Source: [`src/engines/knowledgeHubMetadata.ts`](src/engines/knowledgeHubMetadata.ts)
+
 ### Other Engines
 
 | Engine | Purpose |
 |---|---|
+| `KnowledgeHubMetadataEngine` | Caches entity documents, vector indexes/databases, content sources/types/file types |
+| `ConversationEngine` | Reactive cache for conversations, messages, and agent runs (user-scoped) |
 | `EncryptionEngineBase` | Caches encryption keys, algorithms, and key sources |
 | `FileStorageEngine` | Caches file storage accounts and providers |
 | `MCPEngine` | Caches MCP servers, connections, and tools |