@memberjunction/aiengine 3.4.0 → 4.1.0

package/dist/services/ConversationAttachmentService.js

@@ -1,21 +1,38 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAttachmentService = exports.ConversationAttachmentService = void 0;
-const core_1 = require("@memberjunction/core");
-const global_1 = require("@memberjunction/global");
-const storage_1 = require("@memberjunction/storage");
-const ai_core_plus_1 = require("@memberjunction/ai-core-plus");
-const ai_1 = require("@memberjunction/ai");
-class ConversationAttachmentService {
+/**
+ * @fileoverview Service for managing conversation attachments.
+ *
+ * This service provides centralized attachment management including:
+ * - Validation against size/count limits with cascade logic
+ * - Inline vs MJStorage storage decisions
+ * - Thumbnail generation for images
+ * - CRUD operations for attachments
+ *
+ * @module @memberjunction/aiengine
+ * @author MemberJunction.com
+ * @since 2.130.0
+ */
+import { Metadata, RunView } from '@memberjunction/core';
+import { MJGlobal } from '@memberjunction/global';
+import { FileStorageBase } from '@memberjunction/storage';
+import { ConversationUtility, DEFAULT_ATTACHMENT_LIMITS, DEFAULT_INLINE_STORAGE_THRESHOLD_BYTES } from '@memberjunction/ai-core-plus';
+import { createBase64DataUrl, parseBase64DataUrl } from '@memberjunction/ai';
+/**
+ * Service for managing conversation attachments.
+ * Handles validation, storage, thumbnails, and CRUD operations.
+ */
+export class ConversationAttachmentService {
     constructor() {
         this.modalityCache = { byName: new Map(), loaded: false };
-        this.md = new core_1.Metadata();
+        this.md = new Metadata();
     }
+    /**
+     * Load and cache modalities for efficient lookup
+     */
     async loadModalitiesIfNeeded(contextUser) {
         if (this.modalityCache.loaded) {
             return;
         }
-        const rv = new core_1.RunView();
+        const rv = new RunView();
         const result = await rv.RunView({
             EntityName: 'MJ: AI Modalities',
             ResultType: 'entity_object'
@@ -27,22 +44,46 @@ class ConversationAttachmentService {
             this.modalityCache.loaded = true;
         }
     }
+    /**
+     * Get modality by name (e.g., 'Image', 'Audio', 'Video', 'File')
+     */
     async getModalityByName(name, contextUser) {
         await this.loadModalitiesIfNeeded(contextUser);
         return this.modalityCache.byName.get(name.toLowerCase()) || null;
     }
+    /**
+     * Convert AttachmentType to modality name
+     */
     attachmentTypeToModalityName(attachmentType) {
+        // AttachmentType is 'Image' | 'Video' | 'Audio' | 'Document'
+        // Modality names are 'Image', 'Audio', 'Video', 'File' etc.
         if (attachmentType === 'Document') {
             return 'File';
         }
         return attachmentType;
     }
+    /**
+     * Add a new attachment to a conversation detail.
+     * Handles validation, storage decision, thumbnail generation, and record creation.
+     *
+     * @param conversationDetailId - The ID of the conversation detail
+     * @param input - The attachment data and metadata
+     * @param agent - The AI agent (for limit overrides)
+     * @param model - The AI model (for capability limits)
+     * @param contextUser - The current user context
+     * @param existingCounts - Current attachment counts for validation
+     * @returns The result with created attachment or error
+     */
     async addAttachment(conversationDetailId, input, agent, model, contextUser, existingCounts = { images: 0, videos: 0, audios: 0, documents: 0 }) {
-        const parsed = (0, ai_1.parseBase64DataUrl)(input.data);
+        // Parse data if it's a data URL
+        const parsed = parseBase64DataUrl(input.data);
         const base64Data = parsed?.data || input.data;
         const mimeType = parsed?.mediaType || input.mimeType;
+        // Calculate size from base64
         const sizeBytes = this.calculateBase64Size(base64Data);
-        const attachmentType = ai_core_plus_1.ConversationUtility.GetAttachmentTypeFromMime(mimeType);
+        // Determine attachment type from MIME
+        const attachmentType = ConversationUtility.GetAttachmentTypeFromMime(mimeType);
+        // Get the modality entity for this attachment type
         const modalityName = this.attachmentTypeToModalityName(attachmentType);
         const modality = await this.getModalityByName(modalityName, contextUser);
         if (!modality) {
@@ -51,21 +92,28 @@ class ConversationAttachmentService {
                 error: `Unknown modality type: ${modalityName}`
             };
         }
-        const validation = ai_core_plus_1.ConversationUtility.ValidateAttachment({ type: attachmentType, sizeBytes }, existingCounts, null, null, ai_core_plus_1.DEFAULT_ATTACHMENT_LIMITS);
+        // Validate attachment against limits
+        // For now, use default limits since agent/model don't have these specific fields
+        const validation = ConversationUtility.ValidateAttachment({ type: attachmentType, sizeBytes }, existingCounts, null, // Agent limits - not currently stored on entity
+        null, // Model limits - not currently stored on entity
+        DEFAULT_ATTACHMENT_LIMITS);
         if (!validation.allowed) {
             return {
                 success: false,
                 error: validation.reason
             };
         }
+        // Determine storage mode using agent's threshold if available
         const agentThreshold = agent?.InlineStorageThresholdBytes ?? null;
-        const storeInline = ai_core_plus_1.ConversationUtility.ShouldStoreInline(sizeBytes, agentThreshold, ai_core_plus_1.DEFAULT_INLINE_STORAGE_THRESHOLD_BYTES);
+        const storeInline = ConversationUtility.ShouldStoreInline(sizeBytes, agentThreshold, DEFAULT_INLINE_STORAGE_THRESHOLD_BYTES);
         let inlineData = null;
         let fileId = null;
         if (storeInline) {
+            // Store inline as base64
             inlineData = base64Data;
         }
         else {
+            // Upload to MJStorage
             const uploadResult = await this.uploadToStorage(base64Data, mimeType, input.fileName || `attachment_${Date.now()}`, agent, contextUser);
             if (!uploadResult.success) {
                 return {
@@ -75,10 +123,12 @@ class ConversationAttachmentService {
             }
             fileId = uploadResult.fileId;
         }
+        // Generate thumbnail for images
         let thumbnailBase64 = null;
         if (attachmentType === 'Image') {
             thumbnailBase64 = await this.generateImageThumbnail(base64Data, mimeType);
         }
+        // Create attachment record using strongly-typed entity
         const attachment = await this.createAttachmentRecord({
             conversationDetailId,
             modalityId: modality.ID,
@@ -104,12 +154,23 @@ class ConversationAttachmentService {
             attachment
         };
     }
+    /**
+     * Get attachment data with content URL.
+     * For inline attachments, returns the base64 data URL.
+     * For MJStorage attachments, returns a pre-authenticated download URL.
+     *
+     * @param attachment - The attachment entity
+     * @param contextUser - The current user context
+     * @returns The attachment with content URL
+     */
     async getAttachmentData(attachment, contextUser) {
         let contentUrl;
         if (attachment.InlineData) {
-            contentUrl = (0, ai_1.createBase64DataUrl)(attachment.InlineData, attachment.MimeType);
+            // Inline data - convert to data URL
+            contentUrl = createBase64DataUrl(attachment.InlineData, attachment.MimeType);
         }
         else if (attachment.FileID) {
+            // MJStorage - get download URL
             const downloadUrl = await this.getDownloadUrl(attachment.FileID, contextUser);
             if (!downloadUrl) {
                 return null;
@@ -124,21 +185,38 @@ class ConversationAttachmentService {
             contentUrl
         };
     }
+    /**
+     * Get a pre-authenticated download URL for an MJStorage file.
+     *
+     * @param fileId - The File entity ID
+     * @param contextUser - The current user context
+     * @returns The download URL or null if unavailable
+     */
     async getDownloadUrl(fileId, contextUser) {
+        // Load file entity
         const file = await this.md.GetEntityObject('Files', contextUser);
         if (!await file.Load(fileId)) {
             return null;
         }
+        // Load provider
         const provider = await this.md.GetEntityObject('File Storage Providers', contextUser);
         if (!await provider.Load(file.ProviderID)) {
             return null;
         }
-        const driver = global_1.MJGlobal.Instance.ClassFactory.CreateInstance(storage_1.FileStorageBase, provider.ServerDriverKey);
+        // Get driver and create download URL
+        const driver = MJGlobal.Instance.ClassFactory.CreateInstance(FileStorageBase, provider.ServerDriverKey);
         const objectKey = file.ProviderKey || file.Name;
         return driver.CreatePreAuthDownloadUrl(objectKey);
     }
+    /**
+     * Get all attachments for a conversation detail.
+     *
+     * @param conversationDetailId - The conversation detail ID
+     * @param contextUser - The current user context
+     * @returns Array of attachment entities
+     */
     async getAttachments(conversationDetailId, contextUser) {
-        const rv = new core_1.RunView();
+        const rv = new RunView();
         const result = await rv.RunView({
             EntityName: 'MJ: Conversation Detail Attachments',
             ExtraFilter: `ConversationDetailID='${conversationDetailId}'`,
@@ -150,12 +228,19 @@ class ConversationAttachmentService {
         }
         return result.Results;
     }
+    /**
+     * Get attachments for multiple conversation details (batch load).
+     *
+     * @param conversationDetailIds - Array of conversation detail IDs
+     * @param contextUser - The current user context
+     * @returns Map of conversation detail ID to attachments
+     */
     async getAttachmentsBatch(conversationDetailIds, contextUser) {
         if (conversationDetailIds.length === 0) {
             return new Map();
         }
         const idList = conversationDetailIds.map(id => `'${id}'`).join(',');
-        const rv = new core_1.RunView();
+        const rv = new RunView();
         const result = await rv.RunView({
             EntityName: 'MJ: Conversation Detail Attachments',
             ExtraFilter: `ConversationDetailID IN (${idList})`,
@@ -166,6 +251,7 @@ class ConversationAttachmentService {
         if (!result.Success || !result.Results) {
             return map;
         }
+        // Group by conversation detail ID
         for (const att of result.Results) {
             const existing = map.get(att.ConversationDetailID) || [];
             existing.push(att);
@@ -173,17 +259,35 @@ class ConversationAttachmentService {
         }
         return map;
     }
+    /**
+     * Delete an attachment and its underlying storage.
+     *
+     * @param attachmentId - The attachment ID
+     * @param contextUser - The current user context
+     * @returns Whether deletion succeeded
+     */
     async deleteAttachment(attachmentId, contextUser) {
+        // Load attachment using strongly-typed entity
         const attachment = await this.md.GetEntityObject('MJ: Conversation Detail Attachments', contextUser);
         if (!await attachment.Load(attachmentId)) {
             return false;
         }
+        // If stored in MJStorage, delete the file
         if (attachment.FileID) {
             await this.deleteStorageFile(attachment.FileID, contextUser);
         }
+        // Delete the attachment record
         return attachment.Delete();
     }
+    /**
+     * Create an AttachmentContent reference for embedding in messages.
+     * Maps from entity to the content block type used in AI messages.
+     *
+     * @param attachment - The attachment entity
+     * @returns The attachment content reference
+     */
     createAttachmentReference(attachment) {
+        // Map from modality to AttachmentType
         const modalityName = attachment.Modality?.toLowerCase() || 'file';
         let type = 'Document';
         if (modalityName === 'image')
@@ -205,11 +309,22 @@ class ConversationAttachmentService {
             thumbnailBase64: attachment.ThumbnailBase64 || undefined
         };
     }
+    // ==================== Private Helper Methods ====================
+    /**
+     * Calculate the decoded size of base64 data
+     */
     calculateBase64Size(base64Data) {
+        // Base64 encoding adds ~33% overhead
+        // Length * 3/4 gives approximate decoded size
+        // Account for padding characters
         const padding = (base64Data.match(/=/g) || []).length;
         return Math.floor((base64Data.length * 3) / 4) - padding;
     }
+    /**
+     * Upload data to MJStorage
+     */
     async uploadToStorage(base64Data, mimeType, fileName, agent, contextUser) {
+        // Get storage provider from agent config or use default
         const providerId = agent?.AttachmentStorageProviderID ?? null;
         if (!providerId) {
             return {
@@ -217,6 +332,7 @@ class ConversationAttachmentService {
                 error: 'No storage provider configured for attachments'
             };
         }
+        // Load provider
         const provider = await this.md.GetEntityObject('File Storage Providers', contextUser);
         if (!await provider.Load(providerId)) {
             return {
@@ -224,11 +340,15 @@ class ConversationAttachmentService {
                 error: 'Failed to load storage provider'
             };
         }
-        const driver = global_1.MJGlobal.Instance.ClassFactory.CreateInstance(storage_1.FileStorageBase, provider.ServerDriverKey);
+        // Get driver
+        const driver = MJGlobal.Instance.ClassFactory.CreateInstance(FileStorageBase, provider.ServerDriverKey);
+        // Determine storage path - use a default if agent doesn't have one
         const basePath = 'conversation-attachments';
         const timestamp = Date.now();
         const objectName = `${basePath}/${timestamp}_${fileName}`;
+        // Convert base64 to buffer
         const buffer = Buffer.from(base64Data, 'base64');
+        // Upload
         const uploaded = await driver.PutObject(objectName, buffer, mimeType);
         if (!uploaded) {
             return {
@@ -236,6 +356,7 @@ class ConversationAttachmentService {
                 error: 'Failed to upload file to storage'
             };
         }
+        // Create File entity record
         const file = await this.md.GetEntityObject('Files', contextUser);
         file.Name = fileName;
         file.ProviderID = providerId;
@@ -243,6 +364,7 @@ class ConversationAttachmentService {
         file.ProviderKey = objectName;
         file.Status = 'Uploaded';
         if (!await file.Save()) {
+            // Try to clean up uploaded file
             await driver.DeleteObject(objectName);
             return {
                 success: false,
@@ -254,32 +376,59 @@ class ConversationAttachmentService {
             fileId: file.ID
         };
     }
+    /**
+     * Delete a file from MJStorage
+     */
     async deleteStorageFile(fileId, contextUser) {
+        // Load file entity
         const file = await this.md.GetEntityObject('Files', contextUser);
         if (!await file.Load(fileId)) {
             return false;
         }
+        // Load provider
         const provider = await this.md.GetEntityObject('File Storage Providers', contextUser);
         if (!await provider.Load(file.ProviderID)) {
             return false;
         }
-        const driver = global_1.MJGlobal.Instance.ClassFactory.CreateInstance(storage_1.FileStorageBase, provider.ServerDriverKey);
+        // Get driver and delete
+        const driver = MJGlobal.Instance.ClassFactory.CreateInstance(FileStorageBase, provider.ServerDriverKey);
         const objectKey = file.ProviderKey || file.Name;
         const deleted = await driver.DeleteObject(objectKey);
         if (deleted) {
+            // Delete file record
             await file.Delete();
         }
         return deleted;
     }
+    /**
+     * Generate a thumbnail for an image.
+     * Returns base64-encoded thumbnail data.
+     *
+     * Note: This is a placeholder implementation.
+     * In production, you'd use a library like sharp or Jimp for server-side
+     * image processing, or Canvas API for client-side.
+     */
     async generateImageThumbnail(_base64Data, _mimeType, _maxDimension = 200, _quality = 0.7) {
+        // For small images, just return the original
         const size = this.calculateBase64Size(_base64Data);
-        if (size < 50 * 1024) {
+        if (size < 50 * 1024) { // Less than 50KB
             return _base64Data;
         }
+        // In a full implementation, you would:
+        // 1. Decode the base64 image
+        // 2. Resize to maxDimension while maintaining aspect ratio
+        // 3. Compress with the specified quality
+        // 4. Return as base64
+        // For now, return null to indicate no thumbnail generated
+        // The UI can fall back to displaying the full image
         return null;
     }
+    /**
+     * Create an attachment record in the database using strongly-typed entity.
+     */
     async createAttachmentRecord(data, contextUser) {
         const attachment = await this.md.GetEntityObject('MJ: Conversation Detail Attachments', contextUser);
+        // Use strongly-typed property setters
         attachment.ConversationDetailID = data.conversationDetailId;
         attachment.ModalityID = data.modalityId;
         attachment.MimeType = data.mimeType;
@@ -298,13 +447,19 @@ class ConversationAttachmentService {
         return attachment;
     }
 }
-exports.ConversationAttachmentService = ConversationAttachmentService;
+/**
+ * Singleton instance of the attachment service
+ */
 let _attachmentServiceInstance = null;
-function getAttachmentService() {
+/**
+ * Get the singleton instance of the ConversationAttachmentService.
+ *
+ * @returns The attachment service instance
+ */
+export function getAttachmentService() {
     if (!_attachmentServiceInstance) {
         _attachmentServiceInstance = new ConversationAttachmentService();
     }
     return _attachmentServiceInstance;
 }
-exports.getAttachmentService = getAttachmentService;
 //# sourceMappingURL=ConversationAttachmentService.js.map

package/dist/services/ConversationAttachmentService.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConversationAttachmentService.js","sourceRoot":"","sources":["../../src/services/ConversationAttachmentService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConversationAttachmentService.js","sourceRoot":"","sources":["../../src/services/ConversationAttachmentService.ts"],"names":[],"mappings":"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"}

package/dist/types/ActionMatchResult.d.ts

@@ -1,18 +1,66 @@
+/**
+ * Metadata stored with each action's vector embedding.
+ * Used for filtering and result formatting.
+ */
 export interface ActionEmbeddingMetadata {
+    /**
+     * Unique identifier for the action
+     */
     id: string;
+    /**
+     * Action name
+     */
     name: string;
+    /**
+     * Action description (used in embedding generation)
+     */
     description: string;
+    /**
+     * Category name for grouping/filtering
+     */
     categoryName: string | null;
+    /**
+     * Action status (Active, Disabled, etc.)
+     */
     status: string;
+    /**
+     * Driver class name for the action
+     */
     driverClass: string;
 }
+/**
+ * Result from semantic action search.
+ * Returned by FindSimilarActions with similarity scores.
+ */
 export interface ActionMatchResult {
+    /**
+     * Unique identifier for the action
+     */
     actionId: string;
+    /**
+     * Action name
+     */
     actionName: string;
+    /**
+     * Action description
+     */
     description: string;
+    /**
+     * Cosine similarity score (0-1)
+     * Higher scores indicate better matches
+     */
     similarityScore: number;
+    /**
+     * Category name for the action
+     */
     categoryName?: string | null;
+    /**
+     * Action status
+     */
     status?: string;
+    /**
+     * Driver class name
+     */
     driverClass?: string;
 }
 //# sourceMappingURL=ActionMatchResult.d.ts.map

package/dist/types/ActionMatchResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionMatchResult.d.ts","sourceRoot":"","sources":["../../src/types/ActionMatchResult.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IAIpC,EAAE,EAAE,MAAM,CAAC;IAKX,IAAI,EAAE,MAAM,CAAC;IAKb,WAAW,EAAE,MAAM,CAAC;IAKpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAK5B,MAAM,EAAE,MAAM,CAAC;IAKf,WAAW,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,WAAW,iBAAiB;IAI9B,QAAQ,EAAE,MAAM,CAAC;IAKjB,UAAU,EAAE,MAAM,CAAC;IAKnB,WAAW,EAAE,MAAM,CAAC;IAMpB,eAAe,EAAE,MAAM,CAAC;IAKxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAK7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"ActionMatchResult.d.ts","sourceRoot":"","sources":["../../src/types/ActionMatchResult.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/types/ActionMatchResult.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=ActionMatchResult.js.map

package/dist/types/AgentMatchResult.d.ts

@@ -1,15 +1,55 @@
+/**
+ * Result from agent similarity matching
+ */
 export interface AgentMatchResult {
+    /**
+     * The agent's unique ID
+     */
     agentId: string;
+    /**
+     * The agent's name
+     */
     agentName: string;
+    /**
+     * The agent's description
+     */
     description: string;
+    /**
+     * Cosine similarity score (0-1, where 1 = perfect match)
+     */
     similarityScore: number;
+    /**
+     * Agent's system prompt (optional)
+     */
     systemPrompt?: string;
+    /**
+     * Agent type name (optional)
+     */
     typeName?: string;
+    /**
+     * Agent status (optional)
+     */
     status?: string;
+    /**
+     * Agent invocation mode - controls how agent can be called (optional)
+     * Values: 'Any', 'Top-Level', 'Sub-Agent'
+     */
     invocationMode?: string;
+    /**
+     * Name of the default artifact type this agent produces (optional)
+     * NULL if agent doesn't produce artifacts (orchestration/utility agents)
+     * Examples: "Research Content", "Report", "Diagram"
+     */
     defaultArtifactType?: string;
+    /**
+     * Parent agent ID for child agents (optional)
+     * NULL if this is a top-level agent
+     */
     parentId?: string;
 }
+/**
+ * Metadata about an agent for embedding purposes
+ */
 export interface AgentEmbeddingMetadata {
     id: string;
     name: string;
@@ -17,8 +57,20 @@ export interface AgentEmbeddingMetadata {
     systemPrompt?: string;
     typeName?: string;
     status?: string;
+    /**
+     * Agent invocation mode - controls how agent can be called
+     * Values: 'Any', 'Top-Level', 'Sub-Agent'
+     */
     invocationMode?: string;
+    /**
+     * Name of the default artifact type this agent produces
+     * NULL if agent doesn't produce artifacts
+     */
     defaultArtifactType?: string;
+    /**
+     * Parent agent ID for child agents
+     * NULL if this is a top-level agent
+     */
     parentId?: string;
 }
 //# sourceMappingURL=AgentMatchResult.d.ts.map

package/dist/types/AgentMatchResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentMatchResult.d.ts","sourceRoot":"","sources":["../../src/types/AgentMatchResult.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAI7B,OAAO,EAAE,MAAM,CAAC;IAKhB,SAAS,EAAE,MAAM,CAAC;IAKlB,WAAW,EAAE,MAAM,CAAC;IAKpB,eAAe,EAAE,MAAM,CAAC;IAKxB,YAAY,CAAC,EAAE,MAAM,CAAC;IAKtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAMhB,cAAc,CAAC,EAAE,MAAM,CAAC;IAOxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAM7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB,cAAc,CAAC,EAAE,MAAM,CAAC;IAMxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAM7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"AgentMatchResult.d.ts","sourceRoot":"","sources":["../../src/types/AgentMatchResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/AgentMatchResult.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=AgentMatchResult.js.map

package/dist/types/ExampleMatchResult.d.ts

@@ -1,4 +1,8 @@
 import { AIAgentExampleEntity } from '@memberjunction/core-entities';
+/**
+ * Metadata stored with each example embedding in the vector service.
+ * Includes the full entity to avoid re-loading from database.
+ */
 export interface ExampleEmbeddingMetadata {
     id: string;
     agentId: string;
@@ -10,6 +14,10 @@ export interface ExampleEmbeddingMetadata {
     successScore: number | null;
     exampleEntity: AIAgentExampleEntity;
 }
+/**
+ * Result from semantic search for similar examples.
+ * Returns full entity object to avoid database round-trip.
+ */
 export interface ExampleMatchResult {
     example: AIAgentExampleEntity;
     similarity: number;

package/dist/types/ExampleMatchResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExampleMatchResult.d.ts","sourceRoot":"","sources":["../../src/types/ExampleMatchResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAMrE,MAAM,WAAW,wBAAwB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,oBAAoB,CAAC;CACvC;AAMD,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"ExampleMatchResult.d.ts","sourceRoot":"","sources":["../../src/types/ExampleMatchResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,oBAAoB,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACtB"}