@memberjunction/aiengine 5.40.1 → 5.40.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/aiengine",
   "type": "module",
-  "version": "5.40.1",
+  "version": "5.40.2",
   "description": "MemberJunction: AI Engine Package - handles automatic execution of Entity AI Actions using AI Models",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,15 +17,15 @@
   "author": "MemberJunction.com",
   "license": "ISC",
   "dependencies": {
-    "@memberjunction/core": "5.40.1",
-    "@memberjunction/global": "5.40.1",
-    "@memberjunction/core-entities": "5.40.1",
-    "@memberjunction/actions-base": "5.40.1",
-    "@memberjunction/ai": "5.40.1",
-    "@memberjunction/ai-core-plus": "5.40.1",
-    "@memberjunction/ai-engine-base": "5.40.1",
-    "@memberjunction/ai-vectors-memory": "5.40.1",
-    "@memberjunction/storage": "5.40.1",
+    "@memberjunction/core": "5.40.2",
+    "@memberjunction/global": "5.40.2",
+    "@memberjunction/core-entities": "5.40.2",
+    "@memberjunction/actions-base": "5.40.2",
+    "@memberjunction/ai": "5.40.2",
+    "@memberjunction/ai-core-plus": "5.40.2",
+    "@memberjunction/ai-engine-base": "5.40.2",
+    "@memberjunction/ai-vectors-memory": "5.40.2",
+    "@memberjunction/storage": "5.40.2",
     "dotenv": "^17.2.4",
     "rxjs": "^7.8.2"
   },

package/dist/services/QueryEmbeddingService.d.ts

@@ -1,62 +0,0 @@
-import { SimpleVectorService } from '@memberjunction/ai-vectors-memory';
-import { MJAIModelEntityExtended } from '@memberjunction/ai-core-plus';
-import { QueryMatchResult, QueryEmbeddingMetadata } from '../types/QueryMatchResult.js';
-import { EmbedTextResult } from '@memberjunction/ai';
-import { UserInfo } from '@memberjunction/core';
-/**
- * Utility service for query catalog semantic search.
- *
- * Unlike AgentEmbeddingService (which generates embeddings at AIEngine startup),
- * this service loads pre-computed embeddings from the database. Embeddings are
- * generated by MJQueryEntityServer.Save() using composite text (Name + UserQuestion + Description)
- * and stored in the Query entity's EmbeddingVector column.
- *
- * This follows the same pattern as RefreshNoteEmbeddings in AIEngine — parsing
- * stored JSON vectors from DB records rather than calling the embedding API.
- *
- * All methods are static — no instance state required.
- *
- * @example
- * ```typescript
- * const vectorService = await QueryEmbeddingService.LoadQueryEmbeddings(contextUser);
- * const matches = await QueryEmbeddingService.FindSimilarQueries(
- *   vectorService,
- *   "monthly revenue by region",
- *   (text) => AIEngine.Instance.EmbedTextLocal(text),
- *   10,
- *   0.3
- * );
- * ```
- */
-export declare class QueryEmbeddingService {
-    /**
-     * Load pre-computed query embeddings from the database into a SimpleVectorService.
-     * Only loads queries that have a non-null EmbeddingVector.
-     *
-     * Follows the same pattern as AIEngine.RefreshNoteEmbeddings() — parsing
-     * stored JSON vectors rather than generating embeddings at load time.
-     *
-     * @param contextUser - User context for RunView permissions
-     * @param filter - Optional additional SQL filter (e.g., "Reusable = 1 AND Status = 'Approved'")
-     * @returns SimpleVectorService loaded with query embeddings, ready for FindSimilarQueries()
-     */
-    static LoadQueryEmbeddings(contextUser: UserInfo, filter?: string): Promise<SimpleVectorService<QueryEmbeddingMetadata>>;
-    /**
-     * Find queries semantically similar to a natural language search text.
-     *
-     * Follows the same pattern as AgentEmbeddingService.FindSimilarAgents() —
-     * embeds the search text, then uses FindNearest for cosine similarity.
-     *
-     * @param vectorService - Vector service from LoadQueryEmbeddings()
-     * @param searchText - Natural language description of what data is needed
-     * @param embedFunction - Function to generate embeddings (typically from AIEngine.EmbedTextLocal)
-     * @param topK - Maximum number of results to return (default: 10)
-     * @param minSimilarity - Minimum similarity score 0-1 (default: 0.3)
-     * @returns Array of matching queries sorted by similarity score (highest first)
-     */
-    static FindSimilarQueries(vectorService: SimpleVectorService<QueryEmbeddingMetadata>, searchText: string, embedFunction: (text: string) => Promise<{
-        result: EmbedTextResult;
-        model: MJAIModelEntityExtended;
-    } | null>, topK?: number, minSimilarity?: number): Promise<QueryMatchResult[]>;
-}
-//# sourceMappingURL=QueryEmbeddingService.d.ts.map

package/dist/services/QueryEmbeddingService.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"QueryEmbeddingService.d.ts","sourceRoot":"","sources":["../../src/services/QueryEmbeddingService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAe,MAAM,mCAAmC,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAqB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,qBAAqB;IAC9B;;;;;;;;;;OAUG;WACiB,mBAAmB,CACnC,WAAW,EAAE,QAAQ,EACrB,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,CAAC;IA0DvD;;;;;;;;;;;;OAYG;WACiB,kBAAkB,CAClC,aAAa,EAAE,mBAAmB,CAAC,sBAAsB,CAAC,EAC1D,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAC,MAAM,EAAE,eAAe,CAAC;QAAC,KAAK,EAAE,uBAAuB,CAAA;KAAC,GAAG,IAAI,CAAC,EAC1G,IAAI,GAAE,MAAW,EACjB,aAAa,GAAE,MAAY,GAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAmCjC"}

package/dist/services/QueryEmbeddingService.js

@@ -1,124 +0,0 @@
-import { SimpleVectorService } from '@memberjunction/ai-vectors-memory';
-import { LogError, RunView } from '@memberjunction/core';
-/**
- * Utility service for query catalog semantic search.
- *
- * Unlike AgentEmbeddingService (which generates embeddings at AIEngine startup),
- * this service loads pre-computed embeddings from the database. Embeddings are
- * generated by MJQueryEntityServer.Save() using composite text (Name + UserQuestion + Description)
- * and stored in the Query entity's EmbeddingVector column.
- *
- * This follows the same pattern as RefreshNoteEmbeddings in AIEngine — parsing
- * stored JSON vectors from DB records rather than calling the embedding API.
- *
- * All methods are static — no instance state required.
- *
- * @example
- * ```typescript
- * const vectorService = await QueryEmbeddingService.LoadQueryEmbeddings(contextUser);
- * const matches = await QueryEmbeddingService.FindSimilarQueries(
- *   vectorService,
- *   "monthly revenue by region",
- *   (text) => AIEngine.Instance.EmbedTextLocal(text),
- *   10,
- *   0.3
- * );
- * ```
- */
-export class QueryEmbeddingService {
-    /**
-     * Load pre-computed query embeddings from the database into a SimpleVectorService.
-     * Only loads queries that have a non-null EmbeddingVector.
-     *
-     * Follows the same pattern as AIEngine.RefreshNoteEmbeddings() — parsing
-     * stored JSON vectors rather than generating embeddings at load time.
-     *
-     * @param contextUser - User context for RunView permissions
-     * @param filter - Optional additional SQL filter (e.g., "Reusable = 1 AND Status = 'Approved'")
-     * @returns SimpleVectorService loaded with query embeddings, ready for FindSimilarQueries()
-     */
-    static async LoadQueryEmbeddings(contextUser, filter) {
-        const rv = new RunView();
-        const baseFilter = "EmbeddingVector IS NOT NULL";
-        const extraFilter = filter ? `${baseFilter} AND ${filter}` : baseFilter;
-        const result = await rv.RunView({
-            EntityName: 'MJ: Queries',
-            ExtraFilter: extraFilter,
-            Fields: ['ID', 'Name', 'Description', 'Category', 'Status', 'Reusable', 'SQL', 'UserQuestion', 'EmbeddingVector'],
-            ResultType: 'simple'
-        }, contextUser);
-        if (!result.Success) {
-            LogError(`QueryEmbeddingService: Failed to load query embeddings: ${result.ErrorMessage}`);
-            return new SimpleVectorService();
-        }
-        const entries = [];
-        for (const query of result.Results) {
-            try {
-                const vector = JSON.parse(query.EmbeddingVector);
-                if (!Array.isArray(vector) || vector.length === 0)
-                    continue;
-                entries.push({
-                    key: query.ID,
-                    vector,
-                    metadata: {
-                        id: query.ID,
-                        name: query.Name,
-                        description: query.Description || '',
-                        category: query.Category || '',
-                        status: query.Status || '',
-                        reusable: query.Reusable ?? false,
-                        sql: query.SQL || '',
-                        userQuestion: query.UserQuestion || ''
-                    }
-                });
-            }
-            catch (error) {
-                LogError(`QueryEmbeddingService: Failed to parse embedding for query ${query.Name}: ${error instanceof Error ? error.message : String(error)}`);
-            }
-        }
-        const vectorService = new SimpleVectorService();
-        vectorService.LoadVectors(entries);
-        return vectorService;
-    }
-    /**
-     * Find queries semantically similar to a natural language search text.
-     *
-     * Follows the same pattern as AgentEmbeddingService.FindSimilarAgents() —
-     * embeds the search text, then uses FindNearest for cosine similarity.
-     *
-     * @param vectorService - Vector service from LoadQueryEmbeddings()
-     * @param searchText - Natural language description of what data is needed
-     * @param embedFunction - Function to generate embeddings (typically from AIEngine.EmbedTextLocal)
-     * @param topK - Maximum number of results to return (default: 10)
-     * @param minSimilarity - Minimum similarity score 0-1 (default: 0.3)
-     * @returns Array of matching queries sorted by similarity score (highest first)
-     */
-    static async FindSimilarQueries(vectorService, searchText, embedFunction, topK = 10, minSimilarity = 0.3) {
-        if (!searchText || searchText.trim().length === 0) {
-            throw new Error('searchText cannot be empty');
-        }
-        try {
-            const queryEmbedding = await embedFunction(searchText);
-            if (!queryEmbedding || !queryEmbedding.result || queryEmbedding.result.vector.length === 0) {
-                throw new Error('Failed to generate embedding for search text');
-            }
-            const results = vectorService.FindNearest(queryEmbedding.result.vector, topK, minSimilarity, 'cosine');
-            return results.map(r => ({
-                queryId: r.key,
-                queryName: r.metadata?.name || 'Unknown',
-                description: r.metadata?.description || '',
-                category: r.metadata?.category || '',
-                similarityScore: r.score,
-                status: r.metadata?.status || '',
-                reusable: r.metadata?.reusable ?? false,
-                sql: r.metadata?.sql,
-                userQuestion: r.metadata?.userQuestion
-            }));
-        }
-        catch (error) {
-            LogError(`QueryEmbeddingService: Error finding similar queries: ${error instanceof Error ? error.message : String(error)}`);
-            throw error;
-        }
-    }
-}
-//# sourceMappingURL=QueryEmbeddingService.js.map

package/dist/services/QueryEmbeddingService.js.map

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

package/dist/types/QueryMatchResult.d.ts

@@ -1,55 +0,0 @@
-/**
- * Metadata about a query for embedding purposes
- */
-export interface QueryEmbeddingMetadata {
-    id: string;
-    name: string;
-    description: string;
-    category: string;
-    status: string;
-    reusable: boolean;
-    sql: string;
-    userQuestion: string;
-}
-/**
- * Result from query similarity matching
- */
-export interface QueryMatchResult {
-    /**
-     * The query's unique ID
-     */
-    queryId: string;
-    /**
-     * The query's name
-     */
-    queryName: string;
-    /**
-     * The query's description
-     */
-    description: string;
-    /**
-     * The query's category name
-     */
-    category: string;
-    /**
-     * Cosine similarity score (0-1, where 1 = perfect match)
-     */
-    similarityScore: number;
-    /**
-     * Query status (Approved, Pending, etc.)
-     */
-    status: string;
-    /**
-     * Whether the query is marked as reusable for composition
-     */
-    reusable: boolean;
-    /**
-     * The query's SQL (only populated when requested)
-     */
-    sql?: string;
-    /**
-     * The natural language question this query answers
-     */
-    userQuestion?: string;
-}
-//# sourceMappingURL=QueryMatchResult.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"QueryMatchResult.d.ts","sourceRoot":"","sources":["../../src/types/QueryMatchResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;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,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/types/QueryMatchResult.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=QueryMatchResult.js.map

package/dist/types/QueryMatchResult.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"QueryMatchResult.js","sourceRoot":"","sources":["../../src/types/QueryMatchResult.ts"],"names":[],"mappings":""}