@memberjunction/core-entities-server 6.2.0-edge.6 → 6.2.0-edge.8

package/dist/custom/AnchoredConversationReadSecurityHook.js

@@ -0,0 +1,293 @@
+import { BaseEntity, GetDataHooks, LogError, Metadata, RegisterDataHook, RunView, WellKnownUserSource } from '@memberjunction/core';
+import { EscapeSQLString, NormalizeUUID } from '@memberjunction/global';
+import { FilterAnchoredConversationsForUser } from '@memberjunction/core-entities';
+const INTERNAL_SECURITY_QUERY_PARAMS = new WeakSet();
+/**
+ * Resolves the entity name targeted by `params` without additional I/O.
+ */
+function resolveTargetEntityName(params) {
+    if (typeof params.EntityName === 'string' && params.EntityName.trim().length > 0) {
+        return params.EntityName.trim();
+    }
+    const viewEntityName = params.ViewEntity?.Get('Entity');
+    if (typeof viewEntityName === 'string' && viewEntityName.trim().length > 0) {
+        return viewEntityName.trim();
+    }
+    return '';
+}
+function resolveProviderForUser(contextUser) {
+    return (contextUser.OwningProvider ??
+        Metadata.Provider ?? // global-provider-ok: fallback when UserInfo was constructed without an OwningProvider
+        null);
+}
+function readRowField(row, fieldName) {
+    if (!row || typeof row !== 'object') {
+        return undefined;
+    }
+    if (row instanceof BaseEntity) {
+        return row.Get(fieldName);
+    }
+    return row[fieldName];
+}
+function hasOwnOrEntityField(row, fieldName) {
+    if (!row || typeof row !== 'object') {
+        return false;
+    }
+    if (row instanceof BaseEntity) {
+        return true;
+    }
+    return Object.prototype.hasOwnProperty.call(row, fieldName);
+}
+/**
+ * Server-side `PostRunView` data hook enforcing Row-Level Security (RLS) and Field-Level Security (FLS)
+ * on anchored conversations (`MJ: Conversations` where `AnchorType IS NOT NULL`) and their comment
+ * messages (`MJ: Conversation Details`).
+ *
+ * Guarantees that even a raw `RunView` call over GraphQL, REST, or server code cannot return:
+ * - Anchored conversation threads (`MJ: Conversations`) attached to a linked record that `contextUser`
+ *   cannot read (entity permissions + RLS), or anchored/stamped with restricted fields (`AnchorKey` /
+ *   `AnchorMetadata.restrictedFields`) that `contextUser` is denied Read access to (FLS).
+ * - Comment messages (`MJ: Conversation Details`) belonging to any such anchored conversation thread.
+ *
+ * Never mutates `results.Results` in place (safe with frozen cache entries); returns a replacement
+ * `RunViewResult` whenever rows are filtered out.
+ */
+export const AnchoredConversationPostRunViewHook = async (params, results, contextUser) => {
+    if (!results?.Success ||
+        !Array.isArray(results.Results) ||
+        results.Results.length === 0 ||
+        !contextUser ||
+        INTERNAL_SECURITY_QUERY_PARAMS.has(params)) {
+        return results;
+    }
+    const entityName = resolveTargetEntityName(params);
+    if (entityName !== 'MJ: Conversations' && entityName !== 'MJ: Conversation Details') {
+        return results;
+    }
+    const provider = resolveProviderForUser(contextUser);
+    if (!provider || provider.ProviderType !== 'Database') {
+        return results;
+    }
+    if (WellKnownUserSource.Instance.IsSystemUser(contextUser)) {
+        return results;
+    }
+    try {
+        if (entityName === 'MJ: Conversations') {
+            return await filterConversationsRunViewResult(provider, contextUser, results);
+        }
+        return await filterConversationDetailsRunViewResult(provider, contextUser, results);
+    }
+    catch (error) {
+        LogError(`AnchoredConversationPostRunViewHook failed on ${entityName}: ${error instanceof Error ? error.message : String(error)}`);
+        return results;
+    }
+};
+async function filterConversationsRunViewResult(provider, contextUser, results) {
+    const rows = results.Results;
+    // Check if any row is missing security columns due to a narrow `Fields` projection
+    const missingMetadataIds = [];
+    for (const row of rows) {
+        const hasSecurityCols = hasOwnOrEntityField(row, 'AnchorType') &&
+            hasOwnOrEntityField(row, 'LinkedEntityID') &&
+            hasOwnOrEntityField(row, 'LinkedRecordID') &&
+            hasOwnOrEntityField(row, 'AnchorKey') &&
+            hasOwnOrEntityField(row, 'AnchorMetadata');
+        if (!hasSecurityCols) {
+            const id = String(readRowField(row, 'ID') ?? '').trim();
+            if (id) {
+                missingMetadataIds.push(id);
+            }
+        }
+    }
+    const hydratedById = new Map();
+    if (missingMetadataIds.length > 0) {
+        const fetched = await fetchConversationsSecurityMetadataByIds(provider, contextUser, missingMetadataIds, false);
+        for (const item of fetched) {
+            if (item.ID) {
+                hydratedById.set(NormalizeUUID(item.ID), item);
+            }
+        }
+    }
+    // Collect anchored candidates
+    const anchoredCandidates = [];
+    for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        const rowId = String(readRowField(row, 'ID') ?? '').trim();
+        const hydrated = rowId ? hydratedById.get(NormalizeUUID(rowId)) : undefined;
+        const anchorType = (hydrated ? hydrated.AnchorType : readRowField(row, 'AnchorType'));
+        const linkedEntityId = (hydrated ? hydrated.LinkedEntityID : readRowField(row, 'LinkedEntityID'));
+        const linkedRecordId = (hydrated ? hydrated.LinkedRecordID : readRowField(row, 'LinkedRecordID'));
+        if (!anchorType && (!linkedEntityId || !linkedRecordId)) {
+            continue;
+        }
+        // Only filter anchored comment threads (or conversations linked to a record that carry an anchor)
+        if (!anchorType) {
+            continue;
+        }
+        const anchorKey = (hydrated ? hydrated.AnchorKey : readRowField(row, 'AnchorKey'));
+        const anchorMetadata = (hydrated ? hydrated.AnchorMetadata : readRowField(row, 'AnchorMetadata'));
+        const anchorMetadataObject = (hydrated ? hydrated.AnchorMetadataObject : readRowField(row, 'AnchorMetadataObject'));
+        anchoredCandidates.push({
+            __rowIndex: i,
+            ID: rowId || undefined,
+            LinkedEntityID: linkedEntityId ?? null,
+            LinkedRecordID: linkedRecordId ?? null,
+            AnchorType: anchorType,
+            AnchorKey: anchorKey ?? null,
+            AnchorMetadata: anchorMetadata ?? null,
+            AnchorMetadataObject: anchorMetadataObject ?? null
+        });
+    }
+    if (anchoredCandidates.length === 0) {
+        return results;
+    }
+    const allowedAnchored = await FilterAnchoredConversationsForUser(provider, contextUser, anchoredCandidates);
+    if (allowedAnchored.length === anchoredCandidates.length) {
+        return results;
+    }
+    const allowedRowIndexes = new Set(allowedAnchored.map((c) => c.__rowIndex));
+    const anchoredRowIndexes = new Set(anchoredCandidates.map((c) => c.__rowIndex));
+    const filteredRows = rows.filter((_row, index) => !anchoredRowIndexes.has(index) || allowedRowIndexes.has(index));
+    const removedCount = rows.length - filteredRows.length;
+    return {
+        ...results,
+        Results: filteredRows,
+        RowCount: filteredRows.length,
+        TotalRowCount: Math.max(filteredRows.length, (results.TotalRowCount ?? results.RowCount ?? rows.length) - removedCount)
+    };
+}
+async function filterConversationDetailsRunViewResult(provider, contextUser, results) {
+    const rows = results.Results;
+    const missingConvIdDetailIds = [];
+    for (const row of rows) {
+        if (!hasOwnOrEntityField(row, 'ConversationID')) {
+            const detailId = String(readRowField(row, 'ID') ?? '').trim();
+            if (detailId) {
+                missingConvIdDetailIds.push(detailId);
+            }
+        }
+    }
+    const convIdByDetailId = new Map();
+    if (missingConvIdDetailIds.length > 0) {
+        const fetchedDetails = await fetchDetailConversationIdsByIds(provider, contextUser, missingConvIdDetailIds);
+        for (const d of fetchedDetails) {
+            if (d.ID && d.ConversationID) {
+                convIdByDetailId.set(NormalizeUUID(d.ID), d.ConversationID);
+            }
+        }
+    }
+    const conversationIdsByNorm = new Map();
+    const rowConvNormByIndex = new Map();
+    for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        let convId = String(readRowField(row, 'ConversationID') ?? '').trim();
+        if (!convId) {
+            const detailId = String(readRowField(row, 'ID') ?? '').trim();
+            if (detailId) {
+                convId = convIdByDetailId.get(NormalizeUUID(detailId)) ?? '';
+            }
+        }
+        if (convId) {
+            const norm = NormalizeUUID(convId);
+            conversationIdsByNorm.set(norm, convId);
+            rowConvNormByIndex.set(i, norm);
+        }
+    }
+    if (conversationIdsByNorm.size === 0) {
+        return results;
+    }
+    // Fetch only parent conversations that are anchored (`AnchorType IS NOT NULL`)
+    const anchoredParents = await fetchConversationsSecurityMetadataByIds(provider, contextUser, [...conversationIdsByNorm.values()], true);
+    if (anchoredParents.length === 0) {
+        return results;
+    }
+    const allowedParents = await FilterAnchoredConversationsForUser(provider, contextUser, anchoredParents);
+    if (allowedParents.length === anchoredParents.length) {
+        return results;
+    }
+    const allowedNormIds = new Set(allowedParents.map((c) => NormalizeUUID(String(c.ID ?? ''))));
+    const deniedNormIds = new Set();
+    for (const parent of anchoredParents) {
+        const norm = NormalizeUUID(String(parent.ID ?? ''));
+        if (norm && !allowedNormIds.has(norm)) {
+            deniedNormIds.add(norm);
+        }
+    }
+    if (deniedNormIds.size === 0) {
+        return results;
+    }
+    const filteredRows = rows.filter((_row, index) => {
+        const convNorm = rowConvNormByIndex.get(index);
+        return !convNorm || !deniedNormIds.has(convNorm);
+    });
+    const removedCount = rows.length - filteredRows.length;
+    return {
+        ...results,
+        Results: filteredRows,
+        RowCount: filteredRows.length,
+        TotalRowCount: Math.max(filteredRows.length, (results.TotalRowCount ?? results.RowCount ?? rows.length) - removedCount)
+    };
+}
+async function fetchConversationsSecurityMetadataByIds(provider, contextUser, conversationIds, anchoredOnly) {
+    const uniqueEscaped = Array.from(new Set(conversationIds
+        .map((id) => id.trim())
+        .filter((id) => id.length > 0)
+        .map((id) => `'${EscapeSQLString(id)}'`)));
+    if (uniqueEscaped.length === 0) {
+        return [];
+    }
+    const systemUser = (await WellKnownUserSource.Instance.GetSystemUser(provider)) ?? contextUser;
+    const rv = RunView.FromMetadataProvider(provider);
+    const filterClauses = [`ID IN (${uniqueEscaped.join(',')})`];
+    if (anchoredOnly) {
+        filterClauses.push(`AnchorType IS NOT NULL`);
+    }
+    const params = {
+        EntityName: 'MJ: Conversations',
+        ExtraFilter: filterClauses.join(' AND '),
+        Fields: ['ID', 'LinkedEntityID', 'LinkedRecordID', 'AnchorType', 'AnchorKey', 'AnchorMetadata'],
+        ResultType: 'simple'
+    };
+    INTERNAL_SECURITY_QUERY_PARAMS.add(params);
+    const res = await rv.RunView(params, systemUser);
+    if (!res?.Success || !Array.isArray(res.Results)) {
+        return [];
+    }
+    return res.Results;
+}
+async function fetchDetailConversationIdsByIds(provider, contextUser, detailIds) {
+    const uniqueEscaped = Array.from(new Set(detailIds
+        .map((id) => id.trim())
+        .filter((id) => id.length > 0)
+        .map((id) => `'${EscapeSQLString(id)}'`)));
+    if (uniqueEscaped.length === 0) {
+        return [];
+    }
+    const systemUser = (await WellKnownUserSource.Instance.GetSystemUser(provider)) ?? contextUser;
+    const rv = RunView.FromMetadataProvider(provider);
+    const params = {
+        EntityName: 'MJ: Conversation Details',
+        ExtraFilter: `ID IN (${uniqueEscaped.join(',')})`,
+        Fields: ['ID', 'ConversationID'],
+        ResultType: 'simple'
+    };
+    INTERNAL_SECURITY_QUERY_PARAMS.add(params);
+    const res = await rv.RunView(params, systemUser);
+    if (!res?.Success || !Array.isArray(res.Results)) {
+        return [];
+    }
+    return res.Results;
+}
+/**
+ * Ensures {@link AnchoredConversationPostRunViewHook} is registered in the global `PostRunView`
+ * data hooks store. Safe to call multiple times (idempotent).
+ */
+export function EnsureAnchoredConversationReadHookRegistered() {
+    const existing = GetDataHooks('PostRunView');
+    if (!existing.includes(AnchoredConversationPostRunViewHook)) {
+        RegisterDataHook('PostRunView', AnchoredConversationPostRunViewHook);
+    }
+}
+// Auto-register when @memberjunction/core-entities-server is loaded
+EnsureAnchoredConversationReadHookRegistered();
+//# sourceMappingURL=AnchoredConversationReadSecurityHook.js.map

package/dist/custom/AnchoredConversationReadSecurityHook.js.map

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

package/dist/custom/MJAIAgentExampleEntityServer.server.d.ts

@@ -13,6 +13,8 @@ export declare class MJAIAgentExampleEntityServer extends MJAIAgentExampleEntity
      * Override EmbedTextLocal to use helper
      */
     protected EmbedTextLocal(textToEmbed: string): Promise<SimpleEmbeddingResult>;
+    /** A stored vector from a model other than the default local one is re-embedded on save. */
+    protected IsEmbeddingStale(embeddingModelID: string | null): Promise<boolean>;
     Save(options?: EntitySaveOptions): Promise<boolean>;
     Delete(options?: EntityDeleteOptions): Promise<boolean>;
 }

package/dist/custom/MJAIAgentExampleEntityServer.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MJAIAgentExampleEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIAgentExampleEntityServer.server.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,mBAAmB,EAAE,iBAAiB,EAAY,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC3H,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAIvE;;;;;;;GAOG;AACH,qBACa,4BAA6B,SAAQ,sBAAsB;IACpE;;OAEG;cACsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI7E,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAmCnD,MAAM,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CAQzE"}
+{"version":3,"file":"MJAIAgentExampleEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIAgentExampleEntityServer.server.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,mBAAmB,EAAE,iBAAiB,EAAY,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC3H,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAIvE;;;;;;;GAOG;AACH,qBACa,4BAA6B,SAAQ,sBAAsB;IACpE;;OAEG;cACsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI5F,4FAA4F;cACnE,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7E,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAiCnD,MAAM,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CAQzE"}

package/dist/custom/MJAIAgentExampleEntityServer.server.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { RegisterClass } from "@memberjunction/global";
 import { BaseEntity, LogError } from "@memberjunction/core";
 import { MJAIAgentExampleEntity } from "@memberjunction/core-entities";
-import { EmbedTextLocalHelper } from "./util.js";
+import { EmbedTextLocalHelper, IsLocalEmbeddingStaleHelper } from "./util.js";
 import { AIEngine } from "@memberjunction/aiengine";
 /**
  * Server-side extension of MJAIAgentExampleEntity that:
@@ -24,12 +24,15 @@ let MJAIAgentExampleEntityServer = class MJAIAgentExampleEntityServer extends MJ
     async EmbedTextLocal(textToEmbed) {
         return EmbedTextLocalHelper(this, textToEmbed);
     }
+    /** A stored vector from a model other than the default local one is re-embedded on save. */
+    async IsEmbeddingStale(embeddingModelID) {
+        return IsLocalEmbeddingStaleHelper(this, embeddingModelID);
+    }
     async Save(options) {
         try {
-            // 1. Generate/refresh the embedding if the ExampleInput text is new or dirty.
-            const inputField = this.GetFieldByName('ExampleInput');
-            const shouldGenerateEmbedding = !this.IsSaved || inputField.Dirty;
-            if (shouldGenerateEmbedding && this.ExampleInput && this.ExampleInput.trim().length > 0) {
+            // 1. Generate/refresh the embedding. GenerateEmbedding skips it unless the ExampleInput is
+            //    new or dirty, or its stored vector is from another model (IsEmbeddingStale).
+            if (this.ExampleInput && this.ExampleInput.trim().length > 0) {
                 await this.GenerateEmbeddingByFieldName("ExampleInput", "EmbeddingVector", "EmbeddingModelID", "EmbeddingVectorBinary");
             }
             else if (!this.ExampleInput || this.ExampleInput.trim().length === 0) {

package/dist/custom/MJAIAgentExampleEntityServer.server.js.map

@@ -1 +1 @@
-{"version":3,"file":"MJAIAgentExampleEntityServer.server.js","sourceRoot":"","sources":["../../src/custom/MJAIAgentExampleEntityServer.server.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAA0C,QAAQ,EAAyB,MAAM,sBAAsB,CAAC;AAC3H,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD;;;;;;;GAOG;AAEI,IAAM,4BAA4B,GAAlC,MAAM,4BAA6B,SAAQ,sBAAsB;IACpE;;OAEG;IACgB,KAAK,CAAC,cAAc,CAAC,WAAmB;QACvD,OAAO,oBAAoB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IAEQ,KAAK,CAAC,IAAI,CAAC,OAA2B;QAC3C,IAAI,CAAC;YACD,8EAA8E;YAC9E,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;YACvD,MAAM,uBAAuB,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC;YAElE,IAAI,uBAAuB,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtF,MAAM,IAAI,CAAC,4BAA4B,CAAC,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,uBAAuB,CAAC,CAAC;YAC5H,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;gBAC5B,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;gBAClC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YACjC,CAAC;YAED,mFAAmF;YACnF,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YAEzB,uEAAuE;YACvE,wEAAwE;YACxE,wEAAwE;YACxE,MAAM,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,qBAAqB,IAAI,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnF,QAAQ,CAAC,QAAQ,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACJ,QAAQ,CAAC,QAAQ,CAAC,4BAA4B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,QAAQ,CAAC,kCAAkC,EAAE,CAAC,CAAC,CAAC;YAChD,6DAA6D;YAC7D,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,MAAM,CAAC,OAA6B;QAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;YAChB,QAAQ,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ,CAAA;AAnDY,4BAA4B;IADxC,aAAa,CAAC,UAAU,EAAE,uBAAuB,CAAC;GACtC,4BAA4B,CAmDxC"}
+{"version":3,"file":"MJAIAgentExampleEntityServer.server.js","sourceRoot":"","sources":["../../src/custom/MJAIAgentExampleEntityServer.server.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAA0C,QAAQ,EAAyB,MAAM,sBAAsB,CAAC;AAC3H,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,QAAQ,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD;;;;;;;GAOG;AAEI,IAAM,4BAA4B,GAAlC,MAAM,4BAA6B,SAAQ,sBAAsB;IACpE;;OAEG;IACgB,KAAK,CAAC,cAAc,CAAC,WAAmB;QACvD,OAAO,oBAAoB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,4FAA4F;IACzE,KAAK,CAAC,gBAAgB,CAAC,gBAA+B;QACrE,OAAO,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC/D,CAAC;IAEQ,KAAK,CAAC,IAAI,CAAC,OAA2B;QAC3C,IAAI,CAAC;YACD,2FAA2F;YAC3F,kFAAkF;YAClF,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,CAAC,4BAA4B,CAAC,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,uBAAuB,CAAC,CAAC;YAC5H,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;gBAC5B,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;gBAClC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YACjC,CAAC;YAED,mFAAmF;YACnF,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YAEzB,uEAAuE;YACvE,wEAAwE;YACxE,wEAAwE;YACxE,MAAM,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,qBAAqB,IAAI,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnF,QAAQ,CAAC,QAAQ,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACJ,QAAQ,CAAC,QAAQ,CAAC,4BAA4B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,QAAQ,CAAC,kCAAkC,EAAE,CAAC,CAAC,CAAC;YAChD,6DAA6D;YAC7D,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,MAAM,CAAC,OAA6B;QAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;YAChB,QAAQ,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ,CAAA;AAtDY,4BAA4B;IADxC,aAAa,CAAC,UAAU,EAAE,uBAAuB,CAAC;GACtC,4BAA4B,CAsDxC"}

package/dist/custom/MJAIAgentNoteEntityServer.server.d.ts

@@ -17,6 +17,8 @@ export declare class MJAIAgentNoteEntityServer extends MJAIAgentNoteEntity {
      * Override EmbedTextLocal to use helper
      */
     protected EmbedTextLocal(textToEmbed: string): Promise<SimpleEmbeddingResult>;
+    /** A stored vector from a model other than the default local one is re-embedded on save. */
+    protected IsEmbeddingStale(embeddingModelID: string | null): Promise<boolean>;
     Save(options?: EntitySaveOptions): Promise<boolean>;
     Delete(options?: EntityDeleteOptions): Promise<boolean>;
 }

package/dist/custom/MJAIAgentNoteEntityServer.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MJAIAgentNoteEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIAgentNoteEntityServer.server.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,mBAAmB,EAAE,iBAAiB,EAAY,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC3H,OAAO,EAAE,mBAAmB,EAA0B,MAAM,+BAA+B,CAAC;AAI5F;;;;;;;;;;;GAWG;AACH,qBACa,yBAA0B,SAAQ,mBAAmB;IAC9D;;OAEG;cACsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI7E,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IA0CnD,MAAM,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CAQzE"}
+{"version":3,"file":"MJAIAgentNoteEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIAgentNoteEntityServer.server.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,mBAAmB,EAAE,iBAAiB,EAAY,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC3H,OAAO,EAAE,mBAAmB,EAA0B,MAAM,+BAA+B,CAAC;AAI5F;;;;;;;;;;;GAWG;AACH,qBACa,yBAA0B,SAAQ,mBAAmB;IAC9D;;OAEG;cACsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI5F,4FAA4F;cACnE,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7E,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAwCnD,MAAM,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CAQzE"}

package/dist/custom/MJAIAgentNoteEntityServer.server.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { RegisterClass } from "@memberjunction/global";
 import { BaseEntity, LogError } from "@memberjunction/core";
 import { MJAIAgentNoteEntity, IsInjectableNoteStatus } from "@memberjunction/core-entities";
-import { EmbedTextLocalHelper } from "./util.js";
+import { EmbedTextLocalHelper, IsLocalEmbeddingStaleHelper } from "./util.js";
 import { AIEngine } from "@memberjunction/aiengine";
 /**
  * Server-side extension of MJAIAgentNoteEntity that:
@@ -28,12 +28,15 @@ let MJAIAgentNoteEntityServer = class MJAIAgentNoteEntityServer extends MJAIAgen
     async EmbedTextLocal(textToEmbed) {
         return EmbedTextLocalHelper(this, textToEmbed);
     }
+    /** A stored vector from a model other than the default local one is re-embedded on save. */
+    async IsEmbeddingStale(embeddingModelID) {
+        return IsLocalEmbeddingStaleHelper(this, embeddingModelID);
+    }
     async Save(options) {
         try {
-            // 1. Generate/refresh the embedding if the Note text is new or dirty.
-            const noteField = this.GetFieldByName('Note');
-            const shouldGenerateEmbedding = !this.IsSaved || noteField.Dirty;
-            if (shouldGenerateEmbedding && this.Note && this.Note.trim().length > 0) {
+            // 1. Generate/refresh the embedding. GenerateEmbedding skips it unless the Note is new or
+            //    dirty, or its stored vector is from another model (IsEmbeddingStale).
+            if (this.Note && this.Note.trim().length > 0) {
                 await this.GenerateEmbeddingByFieldName("Note", "EmbeddingVector", "EmbeddingModelID", "EmbeddingVectorBinary");
             }
             else if (!this.Note || this.Note.trim().length === 0) {

package/dist/custom/MJAIAgentNoteEntityServer.server.js.map

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

package/dist/custom/MJAIAgentRelationshipEntityServer.server.d.ts

@@ -0,0 +1,17 @@
+import { ValidationErrorInfo, ValidationResult } from '@memberjunction/core';
+import { MJAIAgentRelationshipEntity } from '@memberjunction/core-entities';
+/**
+ * Server-side `MJ: AI Agent Relationships` entity enforcing that when `ConfigurationPresetID` is set,
+ * the referenced `MJ: AI Agent Configurations` preset exists and belongs to the relationship's `SubAgentID`.
+ */
+export declare class MJAIAgentRelationshipEntityServer extends MJAIAgentRelationshipEntity {
+    get DefaultSkipAsyncValidation(): boolean;
+    ValidateAsync(): Promise<ValidationResult>;
+    private validateConfigurationPreset;
+}
+/**
+ * PURE invariant core for `ConfigurationPresetID` on `MJ: AI Agent Relationships`:
+ * when set, the referenced preset must exist and its `AgentID` must match `SubAgentID`.
+ */
+export declare function BuildConfigurationPresetOwnershipError(configurationPresetID: string | null, subAgentID: string | null, presetAgentID: string | null, presetName?: string): ValidationErrorInfo | null;
+//# sourceMappingURL=MJAIAgentRelationshipEntityServer.server.d.ts.map

package/dist/custom/MJAIAgentRelationshipEntityServer.server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MJAIAgentRelationshipEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIAgentRelationshipEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,mBAAmB,EAAuB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEjI,OAAO,EAAgC,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE1G;;;GAGG;AACH,qBACa,iCAAkC,SAAQ,2BAA2B;IAC9E,IAAoB,0BAA0B,IAAI,OAAO,CAExD;IAEqB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;YAuBlD,2BAA2B;CAoB5C;AAED;;;GAGG;AACH,wBAAgB,sCAAsC,CAClD,qBAAqB,EAAE,MAAM,GAAG,IAAI,EACpC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,UAAU,CAAC,EAAE,MAAM,GACpB,mBAAmB,GAAG,IAAI,CAsB5B"}

package/dist/custom/MJAIAgentRelationshipEntityServer.server.js

@@ -0,0 +1,71 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseEntity, ValidationErrorInfo, ValidationErrorType } from '@memberjunction/core';
+import { RegisterClass, UUIDsEqual } from '@memberjunction/global';
+import { MJAIAgentRelationshipEntity } from '@memberjunction/core-entities';
+/**
+ * Server-side `MJ: AI Agent Relationships` entity enforcing that when `ConfigurationPresetID` is set,
+ * the referenced `MJ: AI Agent Configurations` preset exists and belongs to the relationship's `SubAgentID`.
+ */
+let MJAIAgentRelationshipEntityServer = class MJAIAgentRelationshipEntityServer extends MJAIAgentRelationshipEntity {
+    get DefaultSkipAsyncValidation() {
+        return false;
+    }
+    async ValidateAsync() {
+        const result = await super.ValidateAsync();
+        if (!result.Success) {
+            return result;
+        }
+        if (!this.ConfigurationPresetID) {
+            return result;
+        }
+        const presetDirty = this.GetFieldByName('ConfigurationPresetID')?.Dirty ?? false;
+        const subAgentDirty = this.GetFieldByName('SubAgentID')?.Dirty ?? false;
+        if (!this.IsSaved || presetDirty || subAgentDirty) {
+            const presetError = await this.validateConfigurationPreset();
+            if (presetError) {
+                result.Errors.push(presetError);
+                result.Success = false;
+            }
+        }
+        return result;
+    }
+    async validateConfigurationPreset() {
+        if (!this.ConfigurationPresetID) {
+            return null;
+        }
+        const md = this.ProviderToUse;
+        const preset = await md.GetEntityObject('MJ: AI Agent Configurations', this.ContextCurrentUser);
+        const loaded = await preset.Load(this.ConfigurationPresetID);
+        if (!loaded) {
+            return BuildConfigurationPresetOwnershipError(this.ConfigurationPresetID, this.SubAgentID, null);
+        }
+        return BuildConfigurationPresetOwnershipError(this.ConfigurationPresetID, this.SubAgentID, preset.AgentID ?? null, preset.Name ?? undefined);
+    }
+};
+MJAIAgentRelationshipEntityServer = __decorate([
+    RegisterClass(BaseEntity, 'MJ: AI Agent Relationships')
+], MJAIAgentRelationshipEntityServer);
+export { MJAIAgentRelationshipEntityServer };
+/**
+ * PURE invariant core for `ConfigurationPresetID` on `MJ: AI Agent Relationships`:
+ * when set, the referenced preset must exist and its `AgentID` must match `SubAgentID`.
+ */
+export function BuildConfigurationPresetOwnershipError(configurationPresetID, subAgentID, presetAgentID, presetName) {
+    if (!configurationPresetID) {
+        return null;
+    }
+    if (presetAgentID === null) {
+        return new ValidationErrorInfo('ConfigurationPresetID', `ConfigurationPresetID references preset '${configurationPresetID}' but no such AI Agent Configuration exists.`, configurationPresetID, ValidationErrorType.Failure);
+    }
+    if (!subAgentID || !UUIDsEqual(presetAgentID, subAgentID)) {
+        const label = presetName ? `'${presetName}' (${configurationPresetID})` : `'${configurationPresetID}'`;
+        return new ValidationErrorInfo('ConfigurationPresetID', `Configuration preset ${label} belongs to agent '${presetAgentID}', not sub-agent '${subAgentID}'.`, configurationPresetID, ValidationErrorType.Failure);
+    }
+    return null;
+}
+//# sourceMappingURL=MJAIAgentRelationshipEntityServer.server.js.map

package/dist/custom/MJAIAgentRelationshipEntityServer.server.js.map

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

package/dist/custom/MJAIAgentSessionEntityServer.server.d.ts

@@ -1,29 +1,15 @@
 import { ValidationResult } from '@memberjunction/core';
 import { MJAIAgentSessionEntity } from '@memberjunction/core-entities';
-/**
- * Server-side `MJ: AI Agent Sessions` entity.
- *
- * It keeps the **server-authoritative keys** inside `Config` (the janitor's
- * `maxSessionDeadlineIso`, the `identityVerification` state) out of the session owner's reach, and keeps an
- * anonymous visitor from re-pointing an existing session's `ConversationID` (the anonymous ownership key —
- * see `CheckAnonymousOwnershipKeyChange`). The
- * owner can legitimately write the row — the `UI` and `Widget Guest` roles hold `CanUpdate` on their
- * own sessions — so the protection has to live at the entity, where the generated CRUD mutations,
- * `StartAgentSession(configJson)` and every other path converge on `Save`.
- *
- * The recording ledger's columns need no subclass: they are protected in metadata
- * (`AllowUpdateAPI=false`, #6010), so an entity save cannot write them and only the ledger's stored
- * procedures do.
- *
- * See {@link FindProtectedSessionConfigChanges} for what is protected and why, and
- * `RunWithTrustedSessionConfigWrites` for how server code opts in.
- *
- * Uses the **synchronous** `Validate()` rather than `ValidateAsync()` on purpose: `Validate()` runs on
- * every save, whereas async validation can be skipped by an option, and a guard that a caller can opt
- * out of is not a guard.
- */
 export declare class MJAIAgentSessionEntityServer extends MJAIAgentSessionEntity {
     Validate(): ValidationResult;
+    /**
+     * Returns a refusal when an untrusted save writes or overwrites a server-only `CloseReason`, else null. The owner may
+     * close their own row as `Explicit` or `Error`; `TimeLimit` is stamped only after `SessionManager.CloseSession`
+     * verifies it against the stored deadline, and `Idle`, `Janitor` and `Shutdown` belong to the janitor and the
+     * host. A stamped server-only reason is the record of how the session ended, so the owner cannot replace it either.
+     * Server code that stamps them saves inside `RunWithTrustedSessionConfigWrites`.
+     */
+    private checkServerManagedCloseReason;
     /** Returns a refusal when an untrusted save changes a protected `Config` key, else null. */
     private checkProtectedConfigKeys;
 }

package/dist/custom/MJAIAgentSessionEntityServer.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MJAIAgentSessionEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIAgentSessionEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwD,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE9G,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAIvE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBACa,4BAA6B,SAAQ,sBAAsB;IACpD,QAAQ,IAAI,gBAAgB;IAa5C,4FAA4F;IAC5F,OAAO,CAAC,wBAAwB;CAmCnC"}
+{"version":3,"file":"MJAIAgentSessionEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIAgentSessionEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwD,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE9G,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AA8BvE,qBACa,4BAA6B,SAAQ,sBAAsB;IACpD,QAAQ,IAAI,gBAAgB;IAc5C;;;;;;OAMG;IACH,OAAO,CAAC,6BAA6B;IAkBrC,4FAA4F;IAC5F,OAAO,CAAC,wBAAwB;CAmCnC"}

package/dist/custom/MJAIAgentSessionEntityServer.server.js

@@ -13,7 +13,8 @@ import { CheckAnonymousOwnershipKeyChange, IsSetByTransactionVariable } from './
  * Server-side `MJ: AI Agent Sessions` entity.
  *
  * It keeps the **server-authoritative keys** inside `Config` (the janitor's
- * `maxSessionDeadlineIso`, the `identityVerification` state) out of the session owner's reach, and keeps an
+ * `maxSessionDeadlineIso`, the `identityVerification` state) and the server-only `CloseReason` values (`TimeLimit`,
+ * `Idle`, `Janitor`, `Shutdown`) out of the session owner's reach, and keeps an
  * anonymous visitor from re-pointing an existing session's `ConversationID` (the anonymous ownership key —
  * see `CheckAnonymousOwnershipKeyChange`). The
  * owner can legitimately write the row — the `UI` and `Widget Guest` roles hold `CanUpdate` on their
@@ -31,11 +32,14 @@ import { CheckAnonymousOwnershipKeyChange, IsSetByTransactionVariable } from './
  * every save, whereas async validation can be skipped by an option, and a guard that a caller can opt
  * out of is not a guard.
  */
+/** The close reasons a session owner may record; every other value is stamped by the server. */
+const OWNER_CLOSE_REASONS = new Set(['Explicit', 'Error']);
 let MJAIAgentSessionEntityServer = class MJAIAgentSessionEntityServer extends MJAIAgentSessionEntity {
     Validate() {
         const result = super.Validate();
         const violations = [
             this.checkProtectedConfigKeys(),
+            this.checkServerManagedCloseReason(),
             CheckAnonymousOwnershipKeyChange(this, 'ConversationID'),
         ].filter((v) => v !== null);
         if (violations.length > 0) {
@@ -44,6 +48,25 @@ let MJAIAgentSessionEntityServer = class MJAIAgentSessionEntityServer extends MJ
         }
         return result;
     }
+    /**
+     * Returns a refusal when an untrusted save writes or overwrites a server-only `CloseReason`, else null. The owner may
+     * close their own row as `Explicit` or `Error`; `TimeLimit` is stamped only after `SessionManager.CloseSession`
+     * verifies it against the stored deadline, and `Idle`, `Janitor` and `Shutdown` belong to the janitor and the
+     * host. A stamped server-only reason is the record of how the session ended, so the owner cannot replace it either.
+     * Server code that stamps them saves inside `RunWithTrustedSessionConfigWrites`.
+     */
+    checkServerManagedCloseReason() {
+        const field = this.GetFieldByName('CloseReason');
+        if (IsTrustedSessionConfigWriteActive() || !field?.Dirty) {
+            return null;
+        }
+        const previous = typeof field.OldValue === 'string' ? field.OldValue : null;
+        const serverOnly = [this.CloseReason, previous].find((reason) => reason !== null && !OWNER_CLOSE_REASONS.has(reason));
+        if (serverOnly === undefined) {
+            return null;
+        }
+        return new ValidationErrorInfo('CloseReason', `CloseReason '${serverOnly}' is server-managed; a session owner can close a session only as Explicit or Error, and cannot change a reason the server recorded.`, this.CloseReason, ValidationErrorType.Failure);
+    }
     /** Returns a refusal when an untrusted save changes a protected `Config` key, else null. */
     checkProtectedConfigKeys() {
         if (IsTrustedSessionConfigWriteActive()) {