@memberjunction/core-entities-server 5.40.2 → 5.41.0

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

@@ -0,0 +1,50 @@
+import { ValidationErrorInfo, ValidationResult } from '@memberjunction/core';
+import { MJAIAgentSessionBridgeEntity } from '@memberjunction/core-entities';
+/**
+ * Server-side `MJ: AI Agent Session Bridges` entity. The session IS the existing `AIAgentSession`;
+ * this row is the transport attachment (lifecycle state machine in §7 of the architecture doc).
+ *
+ * The single-column value lists (`Direction`, `JoinMethod`, `TurnMode`, `Status`, `CloseReason`)
+ * are already enforced by table CHECK constraints + the generated sync validator, so this server
+ * focuses on **CROSS-FIELD coherence** the DB cannot express:
+ *
+ *   1. **Outbound needs a target.** `Direction='Outbound'` (the agent goes *to* a meeting / places
+ *      a call) requires an `Address` (join URL / phone number) OR an `ExternalConnectionID` to dial.
+ *      An outbound bridge with neither is unactionable.
+ *   2. **Connected implies `ConnectedAt`.** Once `Status='Connected'` the media is flowing, so the
+ *      connect timestamp must be stamped (mirrors the state machine; downstream metrics read it).
+ *      Same for terminal states and `DisconnectedAt`.
+ *   3. **`CloseReason` only on terminal status.** A close reason on a still-active bridge is
+ *      contradictory; a terminal bridge should record *why* it closed.
+ *
+ * All three are PURE intra-row checks → no `RunView`, no DB round trips. Each is a separately
+ * exported, unit-tested helper.
+ */
+export declare class MJAIAgentSessionBridgeEntityServer extends MJAIAgentSessionBridgeEntity {
+    /** Enable async validation so the cross-field coherence checks run. */
+    get DefaultSkipAsyncValidation(): boolean;
+    ValidateAsync(): Promise<ValidationResult>;
+}
+/**
+ * PURE invariant: an `Outbound` bridge must have somewhere to go — an `Address` (join URL / phone
+ * number) or an `ExternalConnectionID` (an already-established connection to attach to). Returns
+ * the error, or `null` when valid (Inbound bridges are exempt — the endpoint comes to the agent).
+ */
+export declare function ValidateOutboundHasTarget(direction: 'Inbound' | 'Outbound' | null | undefined, address: string | null | undefined, externalConnectionID: string | null | undefined): ValidationErrorInfo | null;
+/**
+ * PURE invariant: the lifecycle timestamps must agree with `Status`.
+ *  - `Connected` ⇒ `ConnectedAt` is set (media is flowing; the timestamp anchors duration metrics).
+ *  - terminal (`Disconnected`/`Failed`) ⇒ `DisconnectedAt` is set.
+ * Returns all violations (empty array = valid). Earlier non-terminal states (Pending/Scheduled/
+ * Connecting/Disconnecting) impose no timestamp requirement.
+ */
+export declare function ValidateStatusTimestamps(status: string | null | undefined, connectedAt: Date | null, disconnectedAt: Date | null): ValidationErrorInfo[];
+/**
+ * PURE invariant: `CloseReason` is meaningful only for a terminal bridge.
+ *  - a non-terminal status with a `CloseReason` set is contradictory (the bridge isn't closed).
+ *  - a terminal status SHOULD record a reason (returned as a warning, not a hard failure, so the
+ *    janitor / error paths that haven't yet stamped a reason aren't blocked from persisting).
+ * Returns the error/warning, or `null` when coherent.
+ */
+export declare function ValidateCloseReasonCoherence(status: string | null | undefined, closeReason: string | null | undefined): ValidationErrorInfo | null;
+//# sourceMappingURL=MJAIAgentSessionBridgeEntityServer.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MJAIAgentSessionBridgeEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIAgentSessionBridgeEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,mBAAmB,EAAuB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE9G,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAK7E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,kCAAmC,SAAQ,4BAA4B;IAChF,uEAAuE;IACvE,IAAoB,0BAA0B,IAAI,OAAO,CAExD;IAEqB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;CA0CnE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACrC,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,EACpD,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChD,mBAAmB,GAAG,IAAI,CAgB5B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,WAAW,EAAE,IAAI,GAAG,IAAI,EACxB,cAAc,EAAE,IAAI,GAAG,IAAI,GAC5B,mBAAmB,EAAE,CAuBvB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CACxC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,mBAAmB,GAAG,IAAI,CAsB5B"}

package/dist/custom/MJAIAgentSessionBridgeEntityServer.server.js

@@ -0,0 +1,133 @@
+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 { MJAIAgentSessionBridgeEntity } from '@memberjunction/core-entities';
+/** Bridge statuses that are terminal (the connection is over). */
+const TERMINAL_BRIDGE_STATUSES = new Set(['Disconnected', 'Failed']);
+/**
+ * Server-side `MJ: AI Agent Session Bridges` entity. The session IS the existing `AIAgentSession`;
+ * this row is the transport attachment (lifecycle state machine in §7 of the architecture doc).
+ *
+ * The single-column value lists (`Direction`, `JoinMethod`, `TurnMode`, `Status`, `CloseReason`)
+ * are already enforced by table CHECK constraints + the generated sync validator, so this server
+ * focuses on **CROSS-FIELD coherence** the DB cannot express:
+ *
+ *   1. **Outbound needs a target.** `Direction='Outbound'` (the agent goes *to* a meeting / places
+ *      a call) requires an `Address` (join URL / phone number) OR an `ExternalConnectionID` to dial.
+ *      An outbound bridge with neither is unactionable.
+ *   2. **Connected implies `ConnectedAt`.** Once `Status='Connected'` the media is flowing, so the
+ *      connect timestamp must be stamped (mirrors the state machine; downstream metrics read it).
+ *      Same for terminal states and `DisconnectedAt`.
+ *   3. **`CloseReason` only on terminal status.** A close reason on a still-active bridge is
+ *      contradictory; a terminal bridge should record *why* it closed.
+ *
+ * All three are PURE intra-row checks → no `RunView`, no DB round trips. Each is a separately
+ * exported, unit-tested helper.
+ */
+let MJAIAgentSessionBridgeEntityServer = class MJAIAgentSessionBridgeEntityServer extends MJAIAgentSessionBridgeEntity {
+    /** Enable async validation so the cross-field coherence checks run. */
+    get DefaultSkipAsyncValidation() {
+        return false;
+    }
+    async ValidateAsync() {
+        const result = await super.ValidateAsync();
+        if (!result.Success)
+            return result;
+        // Cheap intra-row checks. Each gates on the fields it actually reads so updates that don't
+        // touch the lifecycle don't re-pay the (tiny) cost — and, more importantly, an unrelated
+        // edit never resurfaces a pre-existing coherence quirk on a field the caller didn't change.
+        const newErrors = [];
+        const directionDirty = this.GetFieldByName('Direction')?.Dirty ?? false;
+        const addressDirty = this.GetFieldByName('Address')?.Dirty ?? false;
+        const extConnDirty = this.GetFieldByName('ExternalConnectionID')?.Dirty ?? false;
+        if (!this.IsSaved || directionDirty || addressDirty || extConnDirty) {
+            const outboundError = ValidateOutboundHasTarget(this.Direction, this.Address, this.ExternalConnectionID);
+            if (outboundError) {
+                newErrors.push(outboundError);
+            }
+        }
+        const statusDirty = this.GetFieldByName('Status')?.Dirty ?? false;
+        const connectedAtDirty = this.GetFieldByName('ConnectedAt')?.Dirty ?? false;
+        const disconnectedAtDirty = this.GetFieldByName('DisconnectedAt')?.Dirty ?? false;
+        if (!this.IsSaved || statusDirty || connectedAtDirty || disconnectedAtDirty) {
+            newErrors.push(...ValidateStatusTimestamps(this.Status, this.ConnectedAt ?? null, this.DisconnectedAt ?? null));
+        }
+        const closeReasonDirty = this.GetFieldByName('CloseReason')?.Dirty ?? false;
+        if (!this.IsSaved || statusDirty || closeReasonDirty) {
+            const closeError = ValidateCloseReasonCoherence(this.Status, this.CloseReason ?? null);
+            if (closeError) {
+                newErrors.push(closeError);
+            }
+        }
+        // Collect all errors; only hard Failures flip Success (a Warning — e.g. a terminal bridge
+        // missing a CloseReason — must not block the janitor/error paths from persisting).
+        result.Errors.push(...newErrors);
+        if (newErrors.some((e) => e.Type === ValidationErrorType.Failure)) {
+            result.Success = false;
+        }
+        return result;
+    }
+};
+MJAIAgentSessionBridgeEntityServer = __decorate([
+    RegisterClass(BaseEntity, 'MJ: AI Agent Session Bridges')
+], MJAIAgentSessionBridgeEntityServer);
+export { MJAIAgentSessionBridgeEntityServer };
+/**
+ * PURE invariant: an `Outbound` bridge must have somewhere to go — an `Address` (join URL / phone
+ * number) or an `ExternalConnectionID` (an already-established connection to attach to). Returns
+ * the error, or `null` when valid (Inbound bridges are exempt — the endpoint comes to the agent).
+ */
+export function ValidateOutboundHasTarget(direction, address, externalConnectionID) {
+    if (direction !== 'Outbound') {
+        return null;
+    }
+    const hasAddress = (address ?? '').trim().length > 0;
+    const hasConnection = (externalConnectionID ?? '').trim().length > 0;
+    if (hasAddress || hasConnection) {
+        return null;
+    }
+    return new ValidationErrorInfo('Address', 'An Outbound bridge must specify an Address (meeting join URL / phone number) or an ' +
+        'ExternalConnectionID — the agent has no endpoint to connect to.', address ?? null, ValidationErrorType.Failure);
+}
+/**
+ * PURE invariant: the lifecycle timestamps must agree with `Status`.
+ *  - `Connected` ⇒ `ConnectedAt` is set (media is flowing; the timestamp anchors duration metrics).
+ *  - terminal (`Disconnected`/`Failed`) ⇒ `DisconnectedAt` is set.
+ * Returns all violations (empty array = valid). Earlier non-terminal states (Pending/Scheduled/
+ * Connecting/Disconnecting) impose no timestamp requirement.
+ */
+export function ValidateStatusTimestamps(status, connectedAt, disconnectedAt) {
+    const errors = [];
+    if (status === 'Connected' && connectedAt == null) {
+        errors.push(new ValidationErrorInfo('ConnectedAt', "ConnectedAt must be set once Status is 'Connected' (the bridge's media is flowing).", connectedAt, ValidationErrorType.Failure));
+    }
+    if (status != null && TERMINAL_BRIDGE_STATUSES.has(status) && disconnectedAt == null) {
+        errors.push(new ValidationErrorInfo('DisconnectedAt', `DisconnectedAt must be set once Status is terminal ('${status}').`, disconnectedAt, ValidationErrorType.Failure));
+    }
+    return errors;
+}
+/**
+ * PURE invariant: `CloseReason` is meaningful only for a terminal bridge.
+ *  - a non-terminal status with a `CloseReason` set is contradictory (the bridge isn't closed).
+ *  - a terminal status SHOULD record a reason (returned as a warning, not a hard failure, so the
+ *    janitor / error paths that haven't yet stamped a reason aren't blocked from persisting).
+ * Returns the error/warning, or `null` when coherent.
+ */
+export function ValidateCloseReasonCoherence(status, closeReason) {
+    const isTerminal = status != null && TERMINAL_BRIDGE_STATUSES.has(status);
+    const hasReason = (closeReason ?? '').trim().length > 0;
+    if (hasReason && !isTerminal) {
+        return new ValidationErrorInfo('CloseReason', `CloseReason ('${closeReason}') may only be set when Status is terminal (Disconnected/Failed); ` +
+            `current Status is '${status ?? 'none'}'.`, closeReason, ValidationErrorType.Failure);
+    }
+    if (isTerminal && !hasReason) {
+        return new ValidationErrorInfo('CloseReason', `Status is terminal ('${status}') but no CloseReason is recorded — set why the bridge closed.`, closeReason ?? null, ValidationErrorType.Warning);
+    }
+    return null;
+}
+//# sourceMappingURL=MJAIAgentSessionBridgeEntityServer.server.js.map

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

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

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

@@ -0,0 +1,33 @@
+import { ValidationErrorInfo, ValidationResult } from '@memberjunction/core';
+import { MJAIAgentSessionBridgeParticipantEntity } from '@memberjunction/core-entities';
+/**
+ * Server-side `MJ: AI Agent Session Bridge Participants` entity. One row per participant on the
+ * meeting/call (the diarization map + multi-party signal intel a facilitator agent reads),
+ * including the agent bot itself (`IsAgent = 1`).
+ *
+ * Invariant: **at most one `IsAgent = 1` participant per bridge.** A bridge is one agent's
+ * connection into one room (multiple agents = multiple bridges, §4c), so two bot participants on
+ * the same bridge is a bookkeeping error that would confuse diarization (which inbound speaker is
+ * "the agent") and the self-echo gate. The DB cannot express "≤ 1 row where IsAgent=1 per
+ * SessionBridgeID" as a UNIQUE constraint (it would need a filtered unique index, which CodeGen
+ * doesn't manage), so it lives here — a cross-record RunView gated on dirty, self-excluded on
+ * update. PURE helper `BuildDuplicateAgentParticipantError`.
+ */
+export declare class MJAIAgentSessionBridgeParticipantEntityServer extends MJAIAgentSessionBridgeParticipantEntity {
+    /** Enable async validation so the one-agent-per-bridge check runs. */
+    get DefaultSkipAsyncValidation(): boolean;
+    ValidateAsync(): Promise<ValidationResult>;
+    /**
+     * Counts OTHER `IsAgent = 1` participants on the same bridge (excluding this row when updating).
+     * A failed query counts as 0 (fail-open; re-checks on next save).
+     */
+    private countOtherAgentParticipants;
+    /** Escapes a UUID/string for safe inclusion in an ExtraFilter literal. */
+    private safeLiteral;
+}
+/**
+ * PURE invariant: a bridge has at most one agent-bot participant. Returns the error when
+ * `existingAgentCount` other `IsAgent = 1` rows already exist on the bridge, else `null`.
+ */
+export declare function BuildDuplicateAgentParticipantError(sessionBridgeID: string | null, existingAgentCount: number): ValidationErrorInfo | null;
+//# sourceMappingURL=MJAIAgentSessionBridgeParticipantEntityServer.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MJAIAgentSessionBridgeParticipantEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIAgentSessionBridgeParticipantEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,mBAAmB,EAAuB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE1I,OAAO,EAAE,uCAAuC,EAAE,MAAM,+BAA+B,CAAC;AAExF;;;;;;;;;;;;GAYG;AACH,qBACa,6CAA8C,SAAQ,uCAAuC;IACtG,sEAAsE;IACtE,IAAoB,0BAA0B,IAAI,OAAO,CAExD;IAEqB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAmBhE;;;OAGG;YACW,2BAA2B;IAwBzC,0EAA0E;IAC1E,OAAO,CAAC,WAAW;CAGtB;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAC/C,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,kBAAkB,EAAE,MAAM,GAC3B,mBAAmB,GAAG,IAAI,CAW5B"}

package/dist/custom/MJAIAgentSessionBridgeParticipantEntityServer.server.js

@@ -0,0 +1,90 @@
+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 { MJAIAgentSessionBridgeParticipantEntity } from '@memberjunction/core-entities';
+/**
+ * Server-side `MJ: AI Agent Session Bridge Participants` entity. One row per participant on the
+ * meeting/call (the diarization map + multi-party signal intel a facilitator agent reads),
+ * including the agent bot itself (`IsAgent = 1`).
+ *
+ * Invariant: **at most one `IsAgent = 1` participant per bridge.** A bridge is one agent's
+ * connection into one room (multiple agents = multiple bridges, §4c), so two bot participants on
+ * the same bridge is a bookkeeping error that would confuse diarization (which inbound speaker is
+ * "the agent") and the self-echo gate. The DB cannot express "≤ 1 row where IsAgent=1 per
+ * SessionBridgeID" as a UNIQUE constraint (it would need a filtered unique index, which CodeGen
+ * doesn't manage), so it lives here — a cross-record RunView gated on dirty, self-excluded on
+ * update. PURE helper `BuildDuplicateAgentParticipantError`.
+ */
+let MJAIAgentSessionBridgeParticipantEntityServer = class MJAIAgentSessionBridgeParticipantEntityServer extends MJAIAgentSessionBridgeParticipantEntity {
+    /** Enable async validation so the one-agent-per-bridge check runs. */
+    get DefaultSkipAsyncValidation() {
+        return false;
+    }
+    async ValidateAsync() {
+        const result = await super.ValidateAsync();
+        if (!result.Success)
+            return result;
+        // Only when this row claims to be the agent, and only when new or the relevant fields moved.
+        const isAgentDirty = this.GetFieldByName('IsAgent')?.Dirty ?? false;
+        const bridgeDirty = this.GetFieldByName('SessionBridgeID')?.Dirty ?? false;
+        if (this.IsAgent && (!this.IsSaved || isAgentDirty || bridgeDirty)) {
+            const conflict = await this.countOtherAgentParticipants();
+            const dupError = BuildDuplicateAgentParticipantError(this.SessionBridgeID, conflict);
+            if (dupError) {
+                result.Errors.push(dupError);
+                result.Success = false;
+            }
+        }
+        return result;
+    }
+    /**
+     * Counts OTHER `IsAgent = 1` participants on the same bridge (excluding this row when updating).
+     * A failed query counts as 0 (fail-open; re-checks on next save).
+     */
+    async countOtherAgentParticipants() {
+        if (!this.SessionBridgeID) {
+            return 0; // required-field violation is sync Validate()'s job
+        }
+        try {
+            const md = this.ProviderToUse;
+            const selfExclusion = this.IsSaved ? ` AND ID <> '${this.safeLiteral(this.ID)}'` : '';
+            const filter = `SessionBridgeID='${this.safeLiteral(this.SessionBridgeID)}' AND IsAgent=1${selfExclusion}`;
+            const rv = RunView.FromMetadataProvider(md);
+            const queryResult = await rv.RunView({
+                EntityName: 'MJ: AI Agent Session Bridge Participants',
+                ExtraFilter: filter,
+                Fields: ['ID'],
+                ResultType: 'simple',
+            }, this.ContextCurrentUser);
+            return queryResult.Success ? (queryResult.Results?.length ?? 0) : 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /** Escapes a UUID/string for safe inclusion in an ExtraFilter literal. */
+    safeLiteral(value) {
+        return value.replace(/'/g, "''");
+    }
+};
+MJAIAgentSessionBridgeParticipantEntityServer = __decorate([
+    RegisterClass(BaseEntity, 'MJ: AI Agent Session Bridge Participants')
+], MJAIAgentSessionBridgeParticipantEntityServer);
+export { MJAIAgentSessionBridgeParticipantEntityServer };
+/**
+ * PURE invariant: a bridge has at most one agent-bot participant. Returns the error when
+ * `existingAgentCount` other `IsAgent = 1` rows already exist on the bridge, else `null`.
+ */
+export function BuildDuplicateAgentParticipantError(sessionBridgeID, existingAgentCount) {
+    if (existingAgentCount <= 0) {
+        return null;
+    }
+    return new ValidationErrorInfo('IsAgent', `This bridge already has an agent participant (${existingAgentCount} IsAgent row(s) exist). ` +
+        'A bridge is a single agent’s connection — only one participant may be the agent bot.', true, ValidationErrorType.Failure);
+}
+//# sourceMappingURL=MJAIAgentSessionBridgeParticipantEntityServer.server.js.map

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

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

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

@@ -0,0 +1,49 @@
+import { ValidationErrorInfo, ValidationResult } from '@memberjunction/core';
+import { MJAIBridgeAgentIdentityEntity } from '@memberjunction/core-entities';
+/**
+ * Server-side `MJ: AI Bridge Agent Identities` entity. An identity is how an agent is reachable on
+ * a platform — a calendar mailbox (`Email`), an inbound DID (`PhoneNumber`), or a platform-native
+ * account (`AccountID`). Invite watchers and inbound routing resolve a connection to an agent by
+ * matching `(ProviderID, IdentityValue)`, so that pair MUST be unique, and the value SHOULD look
+ * like its declared `IdentityType`.
+ *
+ * Invariants (see `/plans/realtime/realtime-bridges-architecture.md` §5):
+ *   1. **`(ProviderID, IdentityValue)` is unique** across rows — two agents reachable at the same
+ *      address on the same provider would make inbound routing ambiguous. Cross-record RunView,
+ *      gated on dirty, self-excluded on update (the `countRows` pattern). The column-level docs say
+ *      "Unique per provider"; there is no DB UNIQUE constraint on the pair, so this is the real
+ *      enforcement (case-insensitive, which a raw SQL UNIQUE would not be on a case-sensitive
+ *      collation).
+ *   2. **`IdentityValue` shape matches `IdentityType`** — an `Email` looks like an email, a
+ *      `PhoneNumber` is digits with an optional leading `+`. `AccountID` is opaque (no shape check).
+ *      PURE helper `ValidateIdentityValueFormat`.
+ */
+export declare class MJAIBridgeAgentIdentityEntityServer extends MJAIBridgeAgentIdentityEntity {
+    /** Enable async validation so the cross-record uniqueness check runs. */
+    get DefaultSkipAsyncValidation(): boolean;
+    ValidateAsync(): Promise<ValidationResult>;
+    /**
+     * Counts OTHER identity rows on the same provider with the same `IdentityValue` (excluding this
+     * row when updating). A failed query counts as 0 (fail-open; re-checks on next save).
+     */
+    private countOtherIdentitiesWithSameValue;
+    /** Escapes a UUID/string for safe inclusion in an ExtraFilter literal. */
+    private safeLiteral;
+}
+/**
+ * PURE invariant: `IdentityValue` must look like its `IdentityType`. Returns the error, or `null`
+ * when valid (or when not shape-checkable — `AccountID` is opaque, and missing values are the sync
+ * validator's job).
+ *
+ * - `Email`: a single `@` with non-empty local part and a dotted domain.
+ * - `PhoneNumber`: an optional leading `+` followed by 7–15 digits (E.164-ish), tolerating spaces,
+ *   dashes, parentheses, and dots as separators.
+ * - `AccountID`: opaque — no shape enforced.
+ */
+export declare function ValidateIdentityValueFormat(identityType: 'AccountID' | 'Email' | 'PhoneNumber' | null | undefined, identityValue: string | null | undefined): ValidationErrorInfo | null;
+/**
+ * PURE invariant: `(ProviderID, IdentityValue)` must be unique. Returns the error when
+ * `existingCount` other rows already use this value on the provider, else `null`.
+ */
+export declare function BuildDuplicateIdentityError(providerID: string | null, identityValue: string | null, existingCount: number): ValidationErrorInfo | null;
+//# sourceMappingURL=MJAIBridgeAgentIdentityEntityServer.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MJAIBridgeAgentIdentityEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIBridgeAgentIdentityEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,mBAAmB,EAAuB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE1I,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,mCAAoC,SAAQ,6BAA6B;IAClF,yEAAyE;IACzE,IAAoB,0BAA0B,IAAI,OAAO,CAExD;IAEqB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAiChE;;;OAGG;YACW,iCAAiC;IA0B/C,0EAA0E;IAC1E,OAAO,CAAC,WAAW;CAGtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACvC,YAAY,EAAE,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,IAAI,GAAG,SAAS,EACtE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACzC,mBAAmB,GAAG,IAAI,CAuB5B;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACvC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,aAAa,EAAE,MAAM,GACtB,mBAAmB,GAAG,IAAI,CAW5B"}

package/dist/custom/MJAIBridgeAgentIdentityEntityServer.server.js

@@ -0,0 +1,152 @@
+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 { MJAIBridgeAgentIdentityEntity } from '@memberjunction/core-entities';
+/**
+ * Server-side `MJ: AI Bridge Agent Identities` entity. An identity is how an agent is reachable on
+ * a platform — a calendar mailbox (`Email`), an inbound DID (`PhoneNumber`), or a platform-native
+ * account (`AccountID`). Invite watchers and inbound routing resolve a connection to an agent by
+ * matching `(ProviderID, IdentityValue)`, so that pair MUST be unique, and the value SHOULD look
+ * like its declared `IdentityType`.
+ *
+ * Invariants (see `/plans/realtime/realtime-bridges-architecture.md` §5):
+ *   1. **`(ProviderID, IdentityValue)` is unique** across rows — two agents reachable at the same
+ *      address on the same provider would make inbound routing ambiguous. Cross-record RunView,
+ *      gated on dirty, self-excluded on update (the `countRows` pattern). The column-level docs say
+ *      "Unique per provider"; there is no DB UNIQUE constraint on the pair, so this is the real
+ *      enforcement (case-insensitive, which a raw SQL UNIQUE would not be on a case-sensitive
+ *      collation).
+ *   2. **`IdentityValue` shape matches `IdentityType`** — an `Email` looks like an email, a
+ *      `PhoneNumber` is digits with an optional leading `+`. `AccountID` is opaque (no shape check).
+ *      PURE helper `ValidateIdentityValueFormat`.
+ */
+let MJAIBridgeAgentIdentityEntityServer = class MJAIBridgeAgentIdentityEntityServer extends MJAIBridgeAgentIdentityEntity {
+    /** Enable async validation so the cross-record uniqueness check runs. */
+    get DefaultSkipAsyncValidation() {
+        return false;
+    }
+    async ValidateAsync() {
+        const result = await super.ValidateAsync();
+        if (!result.Success)
+            return result;
+        // (2) Format check — cheap, only when new or the relevant fields changed.
+        const valueDirty = this.GetFieldByName('IdentityValue')?.Dirty ?? false;
+        const typeDirty = this.GetFieldByName('IdentityType')?.Dirty ?? false;
+        if (!this.IsSaved || valueDirty || typeDirty) {
+            const formatError = ValidateIdentityValueFormat(this.IdentityType, this.IdentityValue);
+            if (formatError) {
+                result.Errors.push(formatError);
+                result.Success = false;
+                // Fall through is fine, but a malformed value also makes the uniqueness compare
+                // meaningless — return early.
+                return result;
+            }
+        }
+        // (1) Uniqueness of (ProviderID, IdentityValue) — cross-record, only when new or
+        // ProviderID/IdentityValue changed.
+        const providerDirty = this.GetFieldByName('ProviderID')?.Dirty ?? false;
+        if (!this.IsSaved || providerDirty || valueDirty) {
+            const conflict = await this.countOtherIdentitiesWithSameValue();
+            const dupError = BuildDuplicateIdentityError(this.ProviderID, this.IdentityValue, conflict);
+            if (dupError) {
+                result.Errors.push(dupError);
+                result.Success = false;
+            }
+        }
+        return result;
+    }
+    /**
+     * Counts OTHER identity rows on the same provider with the same `IdentityValue` (excluding this
+     * row when updating). A failed query counts as 0 (fail-open; re-checks on next save).
+     */
+    async countOtherIdentitiesWithSameValue() {
+        if (!this.ProviderID || !this.IdentityValue) {
+            return 0; // required-field violations are sync Validate()'s job
+        }
+        try {
+            const md = this.ProviderToUse;
+            const selfExclusion = this.IsSaved ? ` AND ID <> '${this.safeLiteral(this.ID)}'` : '';
+            const filter = `ProviderID='${this.safeLiteral(this.ProviderID)}' AND ` +
+                `IdentityValue='${this.safeLiteral(this.IdentityValue)}'${selfExclusion}`;
+            const rv = RunView.FromMetadataProvider(md);
+            const result = await rv.RunView({
+                EntityName: 'MJ: AI Bridge Agent Identities',
+                ExtraFilter: filter,
+                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. */
+    safeLiteral(value) {
+        return value.replace(/'/g, "''");
+    }
+};
+MJAIBridgeAgentIdentityEntityServer = __decorate([
+    RegisterClass(BaseEntity, 'MJ: AI Bridge Agent Identities')
+], MJAIBridgeAgentIdentityEntityServer);
+export { MJAIBridgeAgentIdentityEntityServer };
+/**
+ * PURE invariant: `IdentityValue` must look like its `IdentityType`. Returns the error, or `null`
+ * when valid (or when not shape-checkable — `AccountID` is opaque, and missing values are the sync
+ * validator's job).
+ *
+ * - `Email`: a single `@` with non-empty local part and a dotted domain.
+ * - `PhoneNumber`: an optional leading `+` followed by 7–15 digits (E.164-ish), tolerating spaces,
+ *   dashes, parentheses, and dots as separators.
+ * - `AccountID`: opaque — no shape enforced.
+ */
+export function ValidateIdentityValueFormat(identityType, identityValue) {
+    if (identityType == null || identityValue == null || identityValue.trim().length === 0) {
+        return null; // required checks are sync Validate()'s job
+    }
+    const value = identityValue.trim();
+    if (identityType === 'Email') {
+        if (!isEmailLike(value)) {
+            return buildFormatError(`IdentityValue '${value}' is not a valid email address (required for IdentityType 'Email').`, identityValue);
+        }
+        return null;
+    }
+    if (identityType === 'PhoneNumber') {
+        if (!isPhoneNumberLike(value)) {
+            return buildFormatError(`IdentityValue '${value}' is not a valid phone number (required for IdentityType 'PhoneNumber' — ` +
+                'an optional leading + and 7–15 digits).', identityValue);
+        }
+        return null;
+    }
+    return null; // AccountID — opaque
+}
+/**
+ * PURE invariant: `(ProviderID, IdentityValue)` must be unique. Returns the error when
+ * `existingCount` other rows already use this value on the provider, else `null`.
+ */
+export function BuildDuplicateIdentityError(providerID, identityValue, existingCount) {
+    if (existingCount <= 0) {
+        return null;
+    }
+    return new ValidationErrorInfo('IdentityValue', `Identity value '${identityValue}' is already registered on this provider (${existingCount} other row(s)). ` +
+        'Each (provider, identity value) pair must be unique so inbound connections route to exactly one agent.', identityValue, ValidationErrorType.Failure);
+}
+/** Loose email shape check: `local@domain.tld`, no spaces, single `@`. */
+function isEmailLike(value) {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
+}
+/** Loose E.164-ish phone check: optional leading `+`, 7–15 digits, common separators ignored. */
+function isPhoneNumberLike(value) {
+    const stripped = value.replace(/[\s().-]/g, '');
+    return /^\+?\d{7,15}$/.test(stripped);
+}
+/** Builds an `IdentityValue` format failure with the standard source/type. */
+function buildFormatError(message, value) {
+    return new ValidationErrorInfo('IdentityValue', message, value, ValidationErrorType.Failure);
+}
+//# sourceMappingURL=MJAIBridgeAgentIdentityEntityServer.server.js.map

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

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

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

@@ -0,0 +1,33 @@
+import { ValidationErrorInfo, ValidationResult } from '@memberjunction/core';
+import { MJAIBridgeProviderChannelEntity } from '@memberjunction/core-entities';
+/**
+ * Server-side `MJ: AI Bridge Provider Channels` entity — the junction declaring which registered
+ * `AIAgentChannel`s a provider contributes (Zoom → Meeting Controls + Native Whiteboard, etc.).
+ *
+ * The only invariant worth enforcing is uniqueness of `(ProviderID, ChannelID)` — a provider
+ * shouldn't list the same channel twice. **The database already enforces this with a UNIQUE
+ * constraint (`UQ_AIBridgeProviderChannel (ProviderID, ChannelID)`)**, so this check is
+ * **defense-in-depth / friendly-message only**: it turns the raw SQL unique-violation error into a
+ * clear, field-attributed message at validation time (before the INSERT/UPDATE is attempted) and
+ * is consistent with how the sibling co-agent / identity servers surface their cross-record rules.
+ * No format/shape invariants exist for this purely-relational row, so there is nothing else to add.
+ */
+export declare class MJAIBridgeProviderChannelEntityServer extends MJAIBridgeProviderChannelEntity {
+    /** Enable async validation so the friendly-message uniqueness check runs. */
+    get DefaultSkipAsyncValidation(): boolean;
+    ValidateAsync(): Promise<ValidationResult>;
+    /**
+     * Counts OTHER rows pairing this provider with this channel (excluding this row when updating).
+     * A failed query counts as 0 (fail-open; the DB UNIQUE constraint is the hard backstop anyway).
+     */
+    private countOtherProviderChannelRows;
+    /** Escapes a UUID/string for safe inclusion in an ExtraFilter literal. */
+    private safeLiteral;
+}
+/**
+ * PURE invariant: a provider may list a given channel only once. Returns the friendly error when
+ * `existingCount` other rows already pair this `(ProviderID, ChannelID)`, else `null`.
+ * (Defense-in-depth over the DB `UQ_AIBridgeProviderChannel` UNIQUE constraint.)
+ */
+export declare function BuildDuplicateProviderChannelError(providerID: string | null, channelID: string | null, existingCount: number): ValidationErrorInfo | null;
+//# sourceMappingURL=MJAIBridgeProviderChannelEntityServer.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MJAIBridgeProviderChannelEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJAIBridgeProviderChannelEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,mBAAmB,EAAuB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE1I,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAEhF;;;;;;;;;;;GAWG;AACH,qBACa,qCAAsC,SAAQ,+BAA+B;IACtF,6EAA6E;IAC7E,IAAoB,0BAA0B,IAAI,OAAO,CAExD;IAEqB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAkBhE;;;OAGG;YACW,6BAA6B;IA0B3C,0EAA0E;IAC1E,OAAO,CAAC,WAAW;CAGtB;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAC9C,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,aAAa,EAAE,MAAM,GACtB,mBAAmB,GAAG,IAAI,CAW5B"}