@memberjunction/core-entities-server 5.40.2 → 5.42.0

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

@@ -0,0 +1,78 @@
+import { ValidationErrorInfo, ValidationResult } from '@memberjunction/core';
+import { MJAIAgentCoAgentEntity } from '@memberjunction/core-entities';
+/**
+ * Server-side `MJ: AI Agent Co Agents` entity enforcing the affinity invariants the migration
+ * documents (see `V202606121723__v5.41.x__AI_Agent_Sessions_Channels.sql`):
+ *
+ *   1. For `Type = 'CoAgent'` rows, `CoAgentID` must reference an **Active** agent of the
+ *      **Realtime** agent type — only Realtime-type agents drive realtime sessions, so
+ *      pairing rows for anything else are metadata mistakes caught at write time. Reserved
+ *      relationship types (Peer/Delegate/Fallback/Reviewer/Observer) skip this check — their
+ *      owner semantics will be defined when those features ship.
+ *   2. **At most one `IsDefault = 1` row per (CoAgentID, Type)** — the default is the target
+ *      a session falls back to when no runtime target is supplied (agent rows) or the type's
+ *      default co-agent (type rows); two defaults would be ambiguous. Cross-record invariant
+ *      checked via RunView (the BASE_ENTITY_SERVER_PATTERNS recipe — `ValidateAsync`, NOT a
+ *      DB trigger).
+ *   3. **No duplicate relationship**: (CoAgentID, target side, Type) must be unique. The DB
+ *      cannot express this as a UNIQUE constraint across the two nullable target columns, so
+ *      it lives here per the migration's documentation.
+ *   4. `CoAgentID ≠ TargetAgentID` — defense in depth over the table CHECK constraint and the
+ *      generated sync validator (an agent cannot front itself). The exactly-one-target rule
+ *      is covered by the table CHECK + the generated validator.
+ *
+ * Affinity rows are OPT-IN: a co-agent with zero rows stays universal — these checks only
+ * govern rows being written, never mandate that any exist.
+ */
+export declare class MJAIAgentCoAgentEntityServer extends MJAIAgentCoAgentEntity {
+    /** Enable async validation so the cross-record pairing invariants run. */
+    get DefaultSkipAsyncValidation(): boolean;
+    ValidateAsync(): Promise<ValidationResult>;
+    /**
+     * Loads the co-agent (and its type) through the request-scoped provider and returns the
+     * invariant violations: missing agent, non-Active status, or non-Realtime type.
+     */
+    private validateCoAgentIsActiveRealtime;
+    /**
+     * Counts OTHER `IsDefault = 1` rows for this (co-agent, Type) — excluding this row when
+     * updating. A failed query counts as 0 (fail-open; the invariant re-checks on next save).
+     */
+    private countOtherDefaultRows;
+    /**
+     * Counts OTHER rows expressing the SAME relationship — same co-agent, same Type, same
+     * target side (TargetAgentID or TargetAgentTypeID) — excluding this row when updating.
+     */
+    private countDuplicateRelationshipRows;
+    /** Shared cross-record counter: runs the filter (plus self-exclusion) and returns the row count. */
+    private countRows;
+    /** Escapes a UUID/string for safe inclusion in an ExtraFilter literal. */
+    private safeID;
+}
+/**
+ * PURE invariant: an agent cannot be paired as its own co-agent. Returns the error, or `null`.
+ * Case/whitespace-insensitive UUID comparison (SQL Server vs PostgreSQL casing).
+ */
+export declare function BuildSelfPairingError(coAgentID: string | null, targetAgentID: string | null): ValidationErrorInfo | null;
+/**
+ * PURE invariant core for the co-agent reference (exported for unit tests): the referenced
+ * agent must exist, be Active, and be of the Realtime agent type.
+ *
+ * @param coAgentID The referenced co-agent id.
+ * @param status The loaded co-agent's Status, or `null` when the agent could not be loaded.
+ * @param typeName The loaded co-agent's TYPE name, or `null` when missing/unresolvable.
+ * @param agentName The loaded co-agent's display name (for friendlier messages).
+ * @returns The violations (empty array = valid).
+ */
+export declare function BuildCoAgentInvariantErrors(coAgentID: string, status: string | null, typeName: string | null, agentName?: string): ValidationErrorInfo[];
+/**
+ * PURE invariant: at most one `IsDefault = 1` row per (co-agent, relationship Type). Returns
+ * the error when `existingDefaultCount` other default rows already exist, else `null`.
+ */
+export declare function BuildDuplicateDefaultError(coAgentID: string | null, existingDefaultCount: number): ValidationErrorInfo | null;
+/**
+ * PURE invariant: a (CoAgentID, target side, Type) relationship may exist only once — the DB
+ * cannot enforce uniqueness across the two nullable target columns. Returns the error when
+ * `duplicateCount` other identical rows already exist, else `null`.
+ */
+export declare function BuildDuplicateRelationshipError(coAgentID: string | null, relationshipType: string, duplicateCount: number): ValidationErrorInfo | null;
+//# sourceMappingURL=MJAIAgentCoAgentEntityServer.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MJAIAgentCoAgentEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIAgentCoAgentEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,mBAAmB,EAAuB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE1I,OAAO,EAAmB,sBAAsB,EAAuB,MAAM,+BAA+B,CAAC;AAK7G;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,4BAA6B,SAAQ,sBAAsB;IACpE,0EAA0E;IAC1E,IAAoB,0BAA0B,IAAI,OAAO,CAExD;IAEqB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAmDhE;;;OAGG;YACW,+BAA+B;IAmB7C;;;OAGG;YACW,qBAAqB;IAQnC;;;OAGG;YACW,8BAA8B;IAW5C,oGAAoG;YACtF,SAAS;IAoBvB,0EAA0E;IAC1E,OAAO,CAAC,MAAM;CAGjB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,mBAAmB,GAAG,IAAI,CAaxH;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,SAAS,CAAC,EAAE,MAAM,GACnB,mBAAmB,EAAE,CAmCvB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,oBAAoB,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAW7H;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC3C,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,GACvB,mBAAmB,GAAG,IAAI,CAW5B"}

package/dist/custom/MJAIAgentCoAgentEntityServer.server.js

@@ -0,0 +1,224 @@
+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, RunView, ValidationErrorInfo, ValidationErrorType } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { MJAIAgentCoAgentEntity } from '@memberjunction/core-entities';
+/** The seeded name of the Realtime agent type — a co-agent must be of this type. */
+const REALTIME_AGENT_TYPE_NAME = 'Realtime';
+/**
+ * Server-side `MJ: AI Agent Co Agents` entity enforcing the affinity invariants the migration
+ * documents (see `V202606121723__v5.41.x__AI_Agent_Sessions_Channels.sql`):
+ *
+ *   1. For `Type = 'CoAgent'` rows, `CoAgentID` must reference an **Active** agent of the
+ *      **Realtime** agent type — only Realtime-type agents drive realtime sessions, so
+ *      pairing rows for anything else are metadata mistakes caught at write time. Reserved
+ *      relationship types (Peer/Delegate/Fallback/Reviewer/Observer) skip this check — their
+ *      owner semantics will be defined when those features ship.
+ *   2. **At most one `IsDefault = 1` row per (CoAgentID, Type)** — the default is the target
+ *      a session falls back to when no runtime target is supplied (agent rows) or the type's
+ *      default co-agent (type rows); two defaults would be ambiguous. Cross-record invariant
+ *      checked via RunView (the BASE_ENTITY_SERVER_PATTERNS recipe — `ValidateAsync`, NOT a
+ *      DB trigger).
+ *   3. **No duplicate relationship**: (CoAgentID, target side, Type) must be unique. The DB
+ *      cannot express this as a UNIQUE constraint across the two nullable target columns, so
+ *      it lives here per the migration's documentation.
+ *   4. `CoAgentID ≠ TargetAgentID` — defense in depth over the table CHECK constraint and the
+ *      generated sync validator (an agent cannot front itself). The exactly-one-target rule
+ *      is covered by the table CHECK + the generated validator.
+ *
+ * Affinity rows are OPT-IN: a co-agent with zero rows stays universal — these checks only
+ * govern rows being written, never mandate that any exist.
+ */
+let MJAIAgentCoAgentEntityServer = class MJAIAgentCoAgentEntityServer extends MJAIAgentCoAgentEntity {
+    /** Enable async validation so the cross-record pairing invariants run. */
+    get DefaultSkipAsyncValidation() {
+        return false;
+    }
+    async ValidateAsync() {
+        const result = await super.ValidateAsync();
+        if (!result.Success)
+            return result;
+        // (3) Self-pairing — cheap, always checked (defense in depth over the CHECK constraint).
+        const selfPairError = BuildSelfPairingError(this.CoAgentID, this.TargetAgentID);
+        if (selfPairError) {
+            result.Errors.push(selfPairError);
+            result.Success = false;
+            return result;
+        }
+        // (1) Co-agent must be an Active, Realtime-type agent — Type='CoAgent' rows only,
+        // and only when new or CoAgentID/Type changed.
+        const coAgentDirty = this.GetFieldByName('CoAgentID')?.Dirty ?? false;
+        const typeDirty = this.GetFieldByName('Type')?.Dirty ?? false;
+        if (this.Type === 'CoAgent' && (!this.IsSaved || coAgentDirty || typeDirty)) {
+            const coAgentErrors = await this.validateCoAgentIsActiveRealtime();
+            if (coAgentErrors.length > 0) {
+                result.Errors.push(...coAgentErrors);
+                result.Success = false;
+                return result;
+            }
+        }
+        // (2) At most one IsDefault row per (CoAgentID, Type) — only when this row claims the default.
+        const isDefaultDirty = this.GetFieldByName('IsDefault')?.Dirty ?? false;
+        if (this.IsDefault && (!this.IsSaved || isDefaultDirty || coAgentDirty || typeDirty)) {
+            const conflict = await this.countOtherDefaultRows();
+            const defaultError = BuildDuplicateDefaultError(this.CoAgentID, conflict);
+            if (defaultError) {
+                result.Errors.push(defaultError);
+                result.Success = false;
+            }
+        }
+        // (3) No duplicate (CoAgentID, target side, Type) relationship.
+        const targetDirty = (this.GetFieldByName('TargetAgentID')?.Dirty ?? false) ||
+            (this.GetFieldByName('TargetAgentTypeID')?.Dirty ?? false);
+        if (!this.IsSaved || coAgentDirty || typeDirty || targetDirty) {
+            const duplicates = await this.countDuplicateRelationshipRows();
+            const duplicateError = BuildDuplicateRelationshipError(this.CoAgentID, this.Type, duplicates);
+            if (duplicateError) {
+                result.Errors.push(duplicateError);
+                result.Success = false;
+            }
+        }
+        return result;
+    }
+    /**
+     * Loads the co-agent (and its type) through the request-scoped provider and returns the
+     * invariant violations: missing agent, non-Active status, or non-Realtime type.
+     */
+    async validateCoAgentIsActiveRealtime() {
+        if (!this.CoAgentID) {
+            return []; // required-field violation is sync Validate()'s job
+        }
+        const md = this.ProviderToUse;
+        const coAgent = await md.GetEntityObject('MJ: AI Agents', this.ContextCurrentUser);
+        if (!(await coAgent.Load(this.CoAgentID))) {
+            return BuildCoAgentInvariantErrors(this.CoAgentID, null, null);
+        }
+        let typeName = null;
+        if (coAgent.TypeID) {
+            const type = await md.GetEntityObject('MJ: AI Agent Types', this.ContextCurrentUser);
+            if (await type.Load(coAgent.TypeID)) {
+                typeName = type.Name ?? null;
+            }
+        }
+        return BuildCoAgentInvariantErrors(this.CoAgentID, coAgent.Status ?? null, typeName, coAgent.Name ?? undefined);
+    }
+    /**
+     * Counts OTHER `IsDefault = 1` rows for this (co-agent, Type) — excluding this row when
+     * updating. A failed query counts as 0 (fail-open; the invariant re-checks on next save).
+     */
+    async countOtherDefaultRows() {
+        if (!this.CoAgentID) {
+            return 0;
+        }
+        const safeType = this.Type.replace(/'/g, "''");
+        return this.countRows(`CoAgentID='${this.safeID(this.CoAgentID)}' AND Type='${safeType}' AND IsDefault=1`);
+    }
+    /**
+     * Counts OTHER rows expressing the SAME relationship — same co-agent, same Type, same
+     * target side (TargetAgentID or TargetAgentTypeID) — excluding this row when updating.
+     */
+    async countDuplicateRelationshipRows() {
+        if (!this.CoAgentID || (!this.TargetAgentID && !this.TargetAgentTypeID)) {
+            return 0; // missing-target violation is the CHECK/sync validator's job
+        }
+        const safeType = this.Type.replace(/'/g, "''");
+        const targetFilter = this.TargetAgentID
+            ? `TargetAgentID='${this.safeID(this.TargetAgentID)}'`
+            : `TargetAgentTypeID='${this.safeID(this.TargetAgentTypeID)}'`;
+        return this.countRows(`CoAgentID='${this.safeID(this.CoAgentID)}' AND Type='${safeType}' AND ${targetFilter}`);
+    }
+    /** Shared cross-record counter: runs the filter (plus self-exclusion) and returns the row count. */
+    async countRows(filter) {
+        try {
+            const md = this.ProviderToUse;
+            const selfExclusion = this.IsSaved ? ` AND ID <> '${this.safeID(this.ID)}'` : '';
+            const rv = RunView.FromMetadataProvider(md);
+            const result = await rv.RunView({
+                EntityName: 'MJ: AI Agent Co Agents',
+                ExtraFilter: `${filter}${selfExclusion}`,
+                Fields: ['ID'],
+                ResultType: 'simple',
+            }, this.ContextCurrentUser);
+            return result.Success ? (result.Results?.length ?? 0) : 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /** Escapes a UUID/string for safe inclusion in an ExtraFilter literal. */
+    safeID(value) {
+        return value.replace(/'/g, "''");
+    }
+};
+MJAIAgentCoAgentEntityServer = __decorate([
+    RegisterClass(BaseEntity, 'MJ: AI Agent Co Agents')
+], MJAIAgentCoAgentEntityServer);
+export { MJAIAgentCoAgentEntityServer };
+/**
+ * PURE invariant: an agent cannot be paired as its own co-agent. Returns the error, or `null`.
+ * Case/whitespace-insensitive UUID comparison (SQL Server vs PostgreSQL casing).
+ */
+export function BuildSelfPairingError(coAgentID, targetAgentID) {
+    if (!coAgentID || !targetAgentID) {
+        return null;
+    }
+    if (coAgentID.trim().toLowerCase() !== targetAgentID.trim().toLowerCase()) {
+        return null;
+    }
+    return new ValidationErrorInfo('CoAgentID', 'The co-agent cannot be the same as the target agent — an agent cannot front itself in a realtime session.', coAgentID, ValidationErrorType.Failure);
+}
+/**
+ * PURE invariant core for the co-agent reference (exported for unit tests): the referenced
+ * agent must exist, be Active, and be of the Realtime agent type.
+ *
+ * @param coAgentID The referenced co-agent id.
+ * @param status The loaded co-agent's Status, or `null` when the agent could not be loaded.
+ * @param typeName The loaded co-agent's TYPE name, or `null` when missing/unresolvable.
+ * @param agentName The loaded co-agent's display name (for friendlier messages).
+ * @returns The violations (empty array = valid).
+ */
+export function BuildCoAgentInvariantErrors(coAgentID, status, typeName, agentName) {
+    if (status === null) {
+        return [
+            new ValidationErrorInfo('CoAgentID', `CoAgentID references agent '${coAgentID}' but no such agent exists.`, coAgentID, ValidationErrorType.Failure),
+        ];
+    }
+    const errors = [];
+    const label = agentName ? `'${agentName}'` : `'${coAgentID}'`;
+    if (status.trim().toLowerCase() !== 'active') {
+        errors.push(new ValidationErrorInfo('CoAgentID', `Co-agent ${label} must be Active to be paired (current Status: ${status}).`, coAgentID, ValidationErrorType.Failure));
+    }
+    if ((typeName ?? '').trim().toLowerCase() !== REALTIME_AGENT_TYPE_NAME.toLowerCase()) {
+        errors.push(new ValidationErrorInfo('CoAgentID', `Co-agent ${label} must be of the '${REALTIME_AGENT_TYPE_NAME}' agent type to drive realtime sessions ` +
+            `(current type: ${typeName ?? 'none'}).`, coAgentID, ValidationErrorType.Failure));
+    }
+    return errors;
+}
+/**
+ * PURE invariant: at most one `IsDefault = 1` row per (co-agent, relationship Type). Returns
+ * the error when `existingDefaultCount` other default rows already exist, else `null`.
+ */
+export function BuildDuplicateDefaultError(coAgentID, existingDefaultCount) {
+    if (existingDefaultCount <= 0) {
+        return null;
+    }
+    return new ValidationErrorInfo('IsDefault', `Co-agent '${coAgentID}' already has a default paired target (${existingDefaultCount} IsDefault row(s) exist). ` +
+        'Clear the existing default before marking this pairing as the default.', true, ValidationErrorType.Failure);
+}
+/**
+ * PURE invariant: a (CoAgentID, target side, Type) relationship may exist only once — the DB
+ * cannot enforce uniqueness across the two nullable target columns. Returns the error when
+ * `duplicateCount` other identical rows already exist, else `null`.
+ */
+export function BuildDuplicateRelationshipError(coAgentID, relationshipType, duplicateCount) {
+    if (duplicateCount <= 0) {
+        return null;
+    }
+    return new ValidationErrorInfo('TargetAgentID', `An identical '${relationshipType}' relationship already exists for co-agent '${coAgentID}' and this target ` +
+        `(${duplicateCount} duplicate row(s)). Edit the existing row instead of creating another.`, coAgentID, ValidationErrorType.Failure);
+}
+//# sourceMappingURL=MJAIAgentCoAgentEntityServer.server.js.map

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

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

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

@@ -0,0 +1,50 @@
+import { ValidationErrorInfo, ValidationResult } from '@memberjunction/core';
+import { MJAIAgentEntityExtended } from '@memberjunction/ai-core-plus';
+/**
+ * Server-side AI Agent entity that validates `TypeConfiguration` on save:
+ *
+ *   1. When non-empty, `TypeConfiguration` must parse as a JSON OBJECT (it is the per-agent
+ *      layer of the effective-configuration merge — arrays/scalars are never valid layers).
+ *   2. When the agent's TYPE publishes a `ConfigSchema` (JSON Schema subset), the parsed
+ *      configuration must conform to it — checked with the dependency-free
+ *      {@link ValidateJsonAgainstSchemaLite} validator (type / required / properties / enum /
+ *      items / additionalProperties). A type WITHOUT a published schema leaves the
+ *      configuration freeform (rule 1 still applies).
+ *
+ * A malformed/unparseable `ConfigSchema` is a METADATA bug on the type row, not the agent
+ * being saved — it surfaces as a WARNING (the save proceeds) rather than blocking every agent
+ * of that type. Extends `MJAIAgentEntityExtended` so all client-side extended behavior is
+ * preserved; registered last, so the ClassFactory prefers it server-side.
+ */
+export declare class MJAIAgentEntityServer extends MJAIAgentEntityExtended {
+    /** Enable async validation so the TypeConfiguration ⊨ ConfigSchema check runs. */
+    get DefaultSkipAsyncValidation(): boolean;
+    /**
+     * Async invariant: `TypeConfiguration` must be a JSON object conforming to the agent
+     * type's published `ConfigSchema`. Cheap fast-path — only runs when the configuration is
+     * present AND (the record is new, or `TypeConfiguration`/`TypeID` is dirty).
+     */
+    ValidateAsync(): Promise<ValidationResult>;
+    /**
+     * Loads the agent type's `ConfigSchema` through the same request-scoped provider that owns
+     * this entity. Returns `null` (freeform) when the agent has no type, the type row cannot be
+     * loaded, or no schema is published.
+     */
+    private loadTypeConfigSchema;
+}
+/**
+ * PURE validation core for the `TypeConfiguration` ⊨ `ConfigSchema` invariant (exported for
+ * unit tests and reuse):
+ *
+ * - unparseable / non-object `typeConfigurationJson` → one **Failure** on `TypeConfiguration`;
+ * - absent/blank `configSchemaJson` → no further checks (freeform configuration);
+ * - unparseable / non-object `configSchemaJson` → one **Warning** (metadata bug on the TYPE row
+ *   — agent saves must not be bricked by it);
+ * - schema violations → one **Failure** per violation, with the JSON-path-ish location.
+ *
+ * @param typeConfigurationJson The agent's `TypeConfiguration` JSON (non-empty).
+ * @param configSchemaJson The type's `ConfigSchema` JSON Schema, or `null` when unpublished.
+ * @returns Validation errors/warnings (empty array = valid).
+ */
+export declare function BuildTypeConfigurationValidationErrors(typeConfigurationJson: string, configSchemaJson: string | null): ValidationErrorInfo[];
+//# sourceMappingURL=MJAIAgentEntityServer.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MJAIAgentEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIAgentEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,mBAAmB,EAAuB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGjI,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAGvE;;;;;;;;;;;;;;;GAeG;AACH,qBACa,qBAAsB,SAAQ,uBAAuB;IAC9D,kFAAkF;IAClF,IAAoB,0BAA0B,IAAI,OAAO,CAExD;IAED;;;;OAIG;IACmB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAwBhE;;;;OAIG;YACW,oBAAoB;CAWrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sCAAsC,CAClD,qBAAqB,EAAE,MAAM,EAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAChC,mBAAmB,EAAE,CAwDvB"}

package/dist/custom/MJAIAgentEntityServer.server.js

@@ -0,0 +1,126 @@
+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 } from '@memberjunction/global';
+import { MJAIAgentEntityExtended } from '@memberjunction/ai-core-plus';
+import { ValidateJsonAgainstSchemaLite } from './json-schema-lite.js';
+/**
+ * Server-side AI Agent entity that validates `TypeConfiguration` on save:
+ *
+ *   1. When non-empty, `TypeConfiguration` must parse as a JSON OBJECT (it is the per-agent
+ *      layer of the effective-configuration merge — arrays/scalars are never valid layers).
+ *   2. When the agent's TYPE publishes a `ConfigSchema` (JSON Schema subset), the parsed
+ *      configuration must conform to it — checked with the dependency-free
+ *      {@link ValidateJsonAgainstSchemaLite} validator (type / required / properties / enum /
+ *      items / additionalProperties). A type WITHOUT a published schema leaves the
+ *      configuration freeform (rule 1 still applies).
+ *
+ * A malformed/unparseable `ConfigSchema` is a METADATA bug on the type row, not the agent
+ * being saved — it surfaces as a WARNING (the save proceeds) rather than blocking every agent
+ * of that type. Extends `MJAIAgentEntityExtended` so all client-side extended behavior is
+ * preserved; registered last, so the ClassFactory prefers it server-side.
+ */
+let MJAIAgentEntityServer = class MJAIAgentEntityServer extends MJAIAgentEntityExtended {
+    /** Enable async validation so the TypeConfiguration ⊨ ConfigSchema check runs. */
+    get DefaultSkipAsyncValidation() {
+        return false;
+    }
+    /**
+     * Async invariant: `TypeConfiguration` must be a JSON object conforming to the agent
+     * type's published `ConfigSchema`. Cheap fast-path — only runs when the configuration is
+     * present AND (the record is new, or `TypeConfiguration`/`TypeID` is dirty).
+     */
+    async ValidateAsync() {
+        const result = await super.ValidateAsync();
+        if (!result.Success)
+            return result;
+        const configJson = this.TypeConfiguration;
+        if (!configJson || configJson.trim().length === 0) {
+            return result; // null/empty = type defaults apply; nothing to validate
+        }
+        const configDirty = this.GetFieldByName('TypeConfiguration')?.Dirty ?? false;
+        const typeDirty = this.GetFieldByName('TypeID')?.Dirty ?? false;
+        if (this.IsSaved && !configDirty && !typeDirty) {
+            return result; // unchanged configuration against an unchanged type — already validated
+        }
+        const schemaJson = await this.loadTypeConfigSchema();
+        const errors = BuildTypeConfigurationValidationErrors(configJson, schemaJson);
+        if (errors.length > 0) {
+            result.Errors.push(...errors);
+            result.Success = errors.every((e) => e.Type !== ValidationErrorType.Failure);
+        }
+        return result;
+    }
+    /**
+     * Loads the agent type's `ConfigSchema` through the same request-scoped provider that owns
+     * this entity. Returns `null` (freeform) when the agent has no type, the type row cannot be
+     * loaded, or no schema is published.
+     */
+    async loadTypeConfigSchema() {
+        if (!this.TypeID) {
+            return null;
+        }
+        const md = this.ProviderToUse;
+        const type = await md.GetEntityObject('MJ: AI Agent Types', this.ContextCurrentUser);
+        if (!(await type.Load(this.TypeID))) {
+            return null; // dangling TypeID is the FK constraint's problem, not this check's
+        }
+        return type.ConfigSchema ?? null;
+    }
+};
+MJAIAgentEntityServer = __decorate([
+    RegisterClass(BaseEntity, 'MJ: AI Agents')
+], MJAIAgentEntityServer);
+export { MJAIAgentEntityServer };
+/**
+ * PURE validation core for the `TypeConfiguration` ⊨ `ConfigSchema` invariant (exported for
+ * unit tests and reuse):
+ *
+ * - unparseable / non-object `typeConfigurationJson` → one **Failure** on `TypeConfiguration`;
+ * - absent/blank `configSchemaJson` → no further checks (freeform configuration);
+ * - unparseable / non-object `configSchemaJson` → one **Warning** (metadata bug on the TYPE row
+ *   — agent saves must not be bricked by it);
+ * - schema violations → one **Failure** per violation, with the JSON-path-ish location.
+ *
+ * @param typeConfigurationJson The agent's `TypeConfiguration` JSON (non-empty).
+ * @param configSchemaJson The type's `ConfigSchema` JSON Schema, or `null` when unpublished.
+ * @returns Validation errors/warnings (empty array = valid).
+ */
+export function BuildTypeConfigurationValidationErrors(typeConfigurationJson, configSchemaJson) {
+    let config;
+    try {
+        config = JSON.parse(typeConfigurationJson);
+    }
+    catch (error) {
+        return [
+            new ValidationErrorInfo('TypeConfiguration', `TypeConfiguration is not valid JSON: ${error instanceof Error ? error.message : String(error)}`, typeConfigurationJson, ValidationErrorType.Failure),
+        ];
+    }
+    if (config === null || typeof config !== 'object' || Array.isArray(config)) {
+        return [
+            new ValidationErrorInfo('TypeConfiguration', 'TypeConfiguration must be a JSON object (arrays and scalars are not valid configuration payloads).', typeConfigurationJson, ValidationErrorType.Failure),
+        ];
+    }
+    if (!configSchemaJson || configSchemaJson.trim().length === 0) {
+        return []; // no published schema — freeform configuration
+    }
+    let schema;
+    try {
+        schema = JSON.parse(configSchemaJson);
+    }
+    catch {
+        schema = null;
+    }
+    if (schema === null || typeof schema !== 'object' || Array.isArray(schema)) {
+        return [
+            new ValidationErrorInfo('TypeConfiguration', "The agent type's ConfigSchema is not a parseable JSON Schema object — schema conformance was NOT " +
+                'checked (fix the ConfigSchema on the agent type row).', configSchemaJson, ValidationErrorType.Warning),
+        ];
+    }
+    return ValidateJsonAgainstSchemaLite(config, schema).map((violation) => new ValidationErrorInfo('TypeConfiguration', `TypeConfiguration does not conform to the agent type's ConfigSchema: ${violation}`, typeConfigurationJson, ValidationErrorType.Failure));
+}
+//# sourceMappingURL=MJAIAgentEntityServer.server.js.map

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

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

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

@@ -5,9 +5,12 @@ import { MJAIAgentNoteEntity } from "@memberjunction/core-entities";
  *   1. Auto-generates an embedding when the Note field is new or dirty.
  *   2. Keeps `AIEngine._noteVectorService` in sync with the note's persisted Status.
  *      Invariant: the vector service contains an entry for a note iff its current Status
- *      is 'Active' AND it has a non-empty EmbeddingVector. This write-side invariant lets
- *      the retrieval filters (`composeNoteFilters`) be pure scope filters — they don't
- *      need to consult any additional cache to decide whether a vector hit is still valid.
+ *      is injectable ('Active' or 'Provisional' — see INJECTABLE_NOTE_STATUSES in
+ *      @memberjunction/core-entities) AND it has a non-empty EmbeddingVector. This
+ *      write-side invariant lets the retrieval filters (`composeNoteFilters`) be pure
+ *      scope filters — they don't need to consult any additional cache to decide
+ *      whether a vector hit is still valid. Provisional notes (written in-flight by
+ *      agents) are deliberately injectable immediately, pending Memory Manager hardening.
  */
 export declare class MJAIAgentNoteEntityServer extends MJAIAgentNoteEntity {
     /**

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,EAAE,MAAM,+BAA+B,CAAC;AAIpE;;;;;;;;GAQG;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;IAyCnD,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;IAI7E,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAyCnD,MAAM,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CAQzE"}

package/dist/custom/MJAIAgentNoteEntityServer.server.js

@@ -6,7 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { RegisterClass } from "@memberjunction/global";
 import { BaseEntity, LogError } from "@memberjunction/core";
-import { MJAIAgentNoteEntity } from "@memberjunction/core-entities";
+import { MJAIAgentNoteEntity, IsInjectableNoteStatus } from "@memberjunction/core-entities";
 import { EmbedTextLocalHelper } from "./util.js";
 import { AIEngine } from "@memberjunction/aiengine";
 /**
@@ -14,9 +14,12 @@ import { AIEngine } from "@memberjunction/aiengine";
  *   1. Auto-generates an embedding when the Note field is new or dirty.
  *   2. Keeps `AIEngine._noteVectorService` in sync with the note's persisted Status.
  *      Invariant: the vector service contains an entry for a note iff its current Status
- *      is 'Active' AND it has a non-empty EmbeddingVector. This write-side invariant lets
- *      the retrieval filters (`composeNoteFilters`) be pure scope filters — they don't
- *      need to consult any additional cache to decide whether a vector hit is still valid.
+ *      is injectable ('Active' or 'Provisional' — see INJECTABLE_NOTE_STATUSES in
+ *      @memberjunction/core-entities) AND it has a non-empty EmbeddingVector. This
+ *      write-side invariant lets the retrieval filters (`composeNoteFilters`) be pure
+ *      scope filters — they don't need to consult any additional cache to decide
+ *      whether a vector hit is still valid. Provisional notes (written in-flight by
+ *      agents) are deliberately injectable immediately, pending Memory Manager hardening.
  */
 let MJAIAgentNoteEntityServer = class MJAIAgentNoteEntityServer extends MJAIAgentNoteEntity {
     /**
@@ -43,8 +46,8 @@ let MJAIAgentNoteEntityServer = class MJAIAgentNoteEntityServer extends MJAIAgen
             if (!saved)
                 return false;
             // 3. Sync the in-memory vector service with the just-persisted Status.
-            //    - Active + has embedding → (re)insert so retrieval can find it.
-            //    - Anything else (Revoked/Archived, or cleared embedding) → drop the vector
+            //    - Injectable (Active/Provisional) + has embedding → (re)insert so retrieval can find it.
+            //    - Anything else (Revoked/Archived/Pending, or cleared embedding) → drop the vector
             //      entry. The original vector metadata still holds a reference to the stale
             //      entity instance, so leaving it would leak into future retrievals.
             //
@@ -52,7 +55,7 @@ let MJAIAgentNoteEntityServer = class MJAIAgentNoteEntityServer extends MJAIAgen
             //    background load completes, the underlying vector service is null and the
             //    update would silently no-op. EnsureLoaded blocks until the engine is ready.
             await AIEngine.Instance.EnsureLoaded();
-            if (this.Status === 'Active' && this.EmbeddingVector) {
+            if (IsInjectableNoteStatus(this.Status) && this.EmbeddingVector) {
                 AIEngine.Instance.AddOrUpdateSingleNoteEmbedding(this);
             }
             else {

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

@@ -1 +1 @@
-{"version":3,"file":"MJAIAgentNoteEntityServer.server.js","sourceRoot":"","sources":["../../src/custom/MJAIAgentNoteEntityServer.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,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD;;;;;;;;GAQG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,mBAAmB;IAC9D;;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,sEAAsE;YACtE,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,uBAAuB,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC;YAEjE,IAAI,uBAAuB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtE,MAAM,IAAI,CAAC,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;YAC3F,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;gBAC5B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YACjC,CAAC;YAED,kFAAkF;YAClF,sEAAsE;YACtE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YAEzB,uEAAuE;YACvE,qEAAqE;YACrE,gFAAgF;YAChF,gFAAgF;YAChF,yEAAyE;YACzE,EAAE;YACF,6EAA6E;YAC7E,8EAA8E;YAC9E,iFAAiF;YACjF,MAAM,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACnD,QAAQ,CAAC,QAAQ,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACJ,QAAQ,CAAC,QAAQ,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,QAAQ,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;YAC7C,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,yBAAyB,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ,CAAA;AAzDY,yBAAyB;IADrC,aAAa,CAAC,UAAU,EAAE,oBAAoB,CAAC;GACnC,yBAAyB,CAyDrC"}
+{"version":3,"file":"MJAIAgentNoteEntityServer.server.js","sourceRoot":"","sources":["../../src/custom/MJAIAgentNoteEntityServer.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,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD;;;;;;;;;;;GAWG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,mBAAmB;IAC9D;;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,sEAAsE;YACtE,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,uBAAuB,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC;YAEjE,IAAI,uBAAuB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtE,MAAM,IAAI,CAAC,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;YAC3F,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;gBAC5B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YACjC,CAAC;YAED,kFAAkF;YAClF,sEAAsE;YACtE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YAEzB,uEAAuE;YACvE,8FAA8F;YAC9F,wFAAwF;YACxF,gFAAgF;YAChF,yEAAyE;YACzE,EAAE;YACF,6EAA6E;YAC7E,8EAA8E;YAC9E,iFAAiF;YACjF,MAAM,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YACvC,IAAI,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC9D,QAAQ,CAAC,QAAQ,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACJ,QAAQ,CAAC,QAAQ,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,QAAQ,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;YAC7C,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,yBAAyB,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ,CAAA;AAzDY,yBAAyB;IADrC,aAAa,CAAC,UAAU,EAAE,oBAAoB,CAAC;GACnC,yBAAyB,CAyDrC"}