@memberjunction/server 5.40.2 → 5.42.0

package/dist/resolvers/RealtimeBridgeResolver.d.ts

@@ -0,0 +1,121 @@
+import { AppContext } from '../types.js';
+import { ResolverBase } from '../generic/ResolverBase.js';
+/**
+ * GraphQL surface for the MJ-native LiveKit room: mints scoped client access tokens and starts an
+ * agent's presence in a room. The thin resolver delegates to `@memberjunction/livekit-room-server`
+ * (token service + session-start coordinator) per the Transport-Layer Architecture — no LiveKit logic
+ * lives here.
+ *
+ * `MintLiveKitClientToken` is fully functional given LiveKit credentials. `StartLiveKitAgentRoomSession`
+ * opens a real agent model session via the realtime-session factory bound above (the agent must have an
+ * Active `Realtime` model + a vendor with a resolvable API key), then bridges it into the room through the
+ * coordinator. The native room media client (`@memberjunction/ai-bridge-livekit-native` /
+ * `@livekit/rtc-node`) must be installed on the agent host for the bot's audio to flow.
+ */
+export declare class MintLiveKitClientTokenInput {
+    RoomName: string;
+    DisplayName?: string;
+}
+export declare class LiveKitClientTokenResult {
+    Success: boolean;
+    ErrorMessage?: string;
+    ServerUrl: string;
+    Token: string;
+    Identity: string;
+    RoomName: string;
+}
+export declare class StartLiveKitAgentRoomSessionInput {
+    AgentID?: string;
+    AgentName?: string;
+    /** The TARGET agent the co-agent voices (the one being "called") — the Realtime Co-Agent delegates to it. */
+    TargetAgentID?: string;
+    /** Optional per-session Realtime MODEL override (Name or ID) — a dev choosing the model for this agent. */
+    RealtimeModelID?: string;
+    /** Optional per-session VOICE override (provider-native voice id) — gives this agent a distinct voice. */
+    RealtimeVoice?: string;
+    RoomName?: string;
+    AgentSessionID?: string;
+    TurnMode?: string;
+}
+export declare class LiveKitAgentRoomSessionResult {
+    Success: boolean;
+    ErrorMessage?: string;
+    SessionBridgeID: string;
+    RoomName: string;
+    ServerUrl: string;
+    ClientToken: string;
+    Identity: string;
+}
+export declare class LiveKitRecordingInput {
+    RoomName: string;
+    Layout?: string;
+}
+export declare class LiveKitRecordingResult {
+    Success: boolean;
+    ErrorMessage?: string;
+    EgressID: string;
+    Status: string;
+}
+/** A selectable provider-native voice for the dev voice picker. */
+export declare class RealtimeVoiceOptionResult {
+    ID: string;
+    Name: string;
+}
+/** An active Realtime model with the voices its driver supports — feeds the dev model/voice picker. */
+export declare class RealtimeModelVoicesResult {
+    ModelID: string;
+    ModelName: string;
+    Voices: RealtimeVoiceOptionResult[];
+}
+export declare class RealtimeBridgeResolver extends ResolverBase {
+    /** Durable `AIAgentSession` record manager — creates the session row the bridge FK-references. */
+    private readonly sessionManager;
+    /**
+     * Mints a scoped LiveKit access token for the current user to join the given room. The participant
+     * identity is derived server-side from the authenticated user (never trusted from the client).
+     */
+    MintLiveKitClientToken(input: MintLiveKitClientTokenInput, context?: AppContext): Promise<LiveKitClientTokenResult>;
+    /**
+     * Starts (or reuses) an agent's presence in a LiveKit room and returns a client token so the calling
+     * user can immediately join the same room.
+     */
+    StartLiveKitAgentRoomSession(input: StartLiveKitAgentRoomSessionInput, context?: AppContext): Promise<LiveKitAgentRoomSessionResult>;
+    /**
+     * Stops one agent's presence in a room (the bot leaves) — the remove half of in-room agent management.
+     * Identified by the `SessionBridgeID` returned from {@link StartLiveKitAgentRoomSession}. Returns `true`
+     * when the bridge was stopped. Best-effort: a missing/already-stopped bridge or any error resolves `false`.
+     *
+     * @param sessionBridgeID The `MJ: AI Agent Session Bridges` row id of the agent to remove.
+     */
+    StopLiveKitAgentRoomSession(sessionBridgeID: string, context?: AppContext): Promise<boolean>;
+    /**
+     * Lists active Realtime models with the voices each driver supports — the source for the dev model/voice
+     * picker (gated client-side by the `Realtime: Advanced Session Controls` authorization). Read-only; returns
+     * an empty list on any error so the picker degrades gracefully to "no overrides".
+     */
+    GetRealtimeModelVoices(context?: AppContext): Promise<RealtimeModelVoicesResult[]>;
+    /**
+     * Invites MJ users to a live room: for each user, sends a **"Live Room Invite"** notification via the
+     * unified {@link NotificationEngine} — which writes the in-app notification (clickable → joins the room
+     * via the `meet-room` ResourceConfiguration) and ALSO delivers over MJ Comms (email/SMS) when the type's
+     * channels + a provider are configured. Best-effort: Comms not being set up never blocks the in-app
+     * notification, and a missing "Live Room Invite" type (seed not yet pushed) is caught and returns false.
+     *
+     * @param roomName The LiveKit room the invitees should join.
+     * @param userIDs The `MJ: Users` ids to invite.
+     * @returns `true` when at least one invite was delivered.
+     */
+    InviteUsersToLiveKitRoom(roomName: string, userIDs: string[], context?: AppContext): Promise<boolean>;
+    /**
+     * Starts recording (composite egress) of a room. Server-authorized — the browser never holds egress
+     * credentials.
+     */
+    StartLiveKitRecording(input: LiveKitRecordingInput, context?: AppContext): Promise<LiveKitRecordingResult>;
+    /** Stops a recording by egress id. */
+    StopLiveKitRecording(egressID: string, context?: AppContext): Promise<LiveKitRecordingResult>;
+    /** Builds a stable, lowercased participant identity from the authenticated user. */
+    private participantIdentity;
+    /** Normalizes a turn-mode string to the bridge's accepted values. */
+    private normalizeTurnMode;
+}
+//# sourceMappingURL=RealtimeBridgeResolver.d.ts.map

package/dist/resolvers/RealtimeBridgeResolver.d.ts.map

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

package/dist/resolvers/RealtimeBridgeResolver.js

@@ -0,0 +1,533 @@
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Resolver, Mutation, Query, Arg, Ctx, ObjectType, InputType, Field } from 'type-graphql';
+import { randomUUID } from 'crypto';
+import { LogError } from '@memberjunction/core';
+import { LiveKitTokenService, LiveKitAgentRoomCoordinator, LiveKitEgressService } from '@memberjunction/livekit-room-server';
+import { ResolverBase } from '../generic/ResolverBase.js';
+import { GetReadWriteProvider } from '../util.js';
+import { CreateBridgeRealtimeSession, FinalizeBridgeCoAgentRuns, GetRealtimeModelVoices, CreateBridgeRoomTranscriptSink } from '@memberjunction/ai-agents';
+import { AIBridgeEngine } from '@memberjunction/ai-bridge-server';
+import { SessionManager } from '../agentSessions/SessionManager.js';
+import { NotificationEngine } from '@memberjunction/notifications';
+/**
+ * Binds the agent realtime-session factory onto the LiveKit room coordinator's model-session creation seam.
+ * Module-load side effect — it runs when MJServer builds its GraphQL schema (which imports this resolver),
+ * so `StartLiveKitAgentRoomSession` can open a real model session. `@memberjunction/server` is the natural
+ * home for the binding: it is the one package that depends on BOTH `@memberjunction/ai-agents` (the factory)
+ * and `@memberjunction/livekit-room-server` (the coordinator), keeping each of those decoupled from the
+ * other. Idempotent (latest-wins).
+ */
+LiveKitAgentRoomCoordinator.Instance.SetSessionFactory(CreateBridgeRealtimeSession);
+/**
+ * Binds the co-agent run finalizer onto the bridge engine (same module-load rationale as the factory above).
+ * Lets the engine finalize a session's dangling co-agent observability run when it reaps a bridge WITHOUT a
+ * live in-memory session (a prior-boot orphan / cross-host reap) — the one teardown path the agent layer's
+ * `Close()`-wrapped finalizer can't reach. Idempotent for clean same-process teardowns.
+ */
+AIBridgeEngine.Instance.SetSessionRunFinalizer(FinalizeBridgeCoAgentRuns);
+/**
+ * Binds the unified room-transcript sink onto the bridge engine (same module-load rationale). The engine
+ * elects one scribe per LiveKit room and feeds its final transcript lines here; the sink persists them as a
+ * single `MJ: Conversations` of `Type='Meeting Room'`, scoped `Application` so it stays OUT of the normal
+ * chat list (it surfaces in the Meet app's own view), with one `MJ: Conversation Detail` per utterance. The
+ * "Meeting Room"/scope choices live HERE (the Meet composition layer), keeping the engine generic.
+ */
+AIBridgeEngine.Instance.SetTranscriptSink(CreateBridgeRoomTranscriptSink({ ConversationType: 'Meeting Room', ApplicationScope: 'Application' }));
+/**
+ * GraphQL surface for the MJ-native LiveKit room: mints scoped client access tokens and starts an
+ * agent's presence in a room. The thin resolver delegates to `@memberjunction/livekit-room-server`
+ * (token service + session-start coordinator) per the Transport-Layer Architecture — no LiveKit logic
+ * lives here.
+ *
+ * `MintLiveKitClientToken` is fully functional given LiveKit credentials. `StartLiveKitAgentRoomSession`
+ * opens a real agent model session via the realtime-session factory bound above (the agent must have an
+ * Active `Realtime` model + a vendor with a resolvable API key), then bridges it into the room through the
+ * coordinator. The native room media client (`@memberjunction/ai-bridge-livekit-native` /
+ * `@livekit/rtc-node`) must be installed on the agent host for the bot's audio to flow.
+ */
+let MintLiveKitClientTokenInput = class MintLiveKitClientTokenInput {
+};
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], MintLiveKitClientTokenInput.prototype, "RoomName", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], MintLiveKitClientTokenInput.prototype, "DisplayName", void 0);
+MintLiveKitClientTokenInput = __decorate([
+    InputType()
+], MintLiveKitClientTokenInput);
+export { MintLiveKitClientTokenInput };
+let LiveKitClientTokenResult = class LiveKitClientTokenResult {
+};
+__decorate([
+    Field(() => Boolean),
+    __metadata("design:type", Boolean)
+], LiveKitClientTokenResult.prototype, "Success", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], LiveKitClientTokenResult.prototype, "ErrorMessage", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitClientTokenResult.prototype, "ServerUrl", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitClientTokenResult.prototype, "Token", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitClientTokenResult.prototype, "Identity", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitClientTokenResult.prototype, "RoomName", void 0);
+LiveKitClientTokenResult = __decorate([
+    ObjectType()
+], LiveKitClientTokenResult);
+export { LiveKitClientTokenResult };
+let StartLiveKitAgentRoomSessionInput = class StartLiveKitAgentRoomSessionInput {
+};
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], StartLiveKitAgentRoomSessionInput.prototype, "AgentID", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], StartLiveKitAgentRoomSessionInput.prototype, "AgentName", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], StartLiveKitAgentRoomSessionInput.prototype, "TargetAgentID", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], StartLiveKitAgentRoomSessionInput.prototype, "RealtimeModelID", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], StartLiveKitAgentRoomSessionInput.prototype, "RealtimeVoice", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], StartLiveKitAgentRoomSessionInput.prototype, "RoomName", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], StartLiveKitAgentRoomSessionInput.prototype, "AgentSessionID", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], StartLiveKitAgentRoomSessionInput.prototype, "TurnMode", void 0);
+StartLiveKitAgentRoomSessionInput = __decorate([
+    InputType()
+], StartLiveKitAgentRoomSessionInput);
+export { StartLiveKitAgentRoomSessionInput };
+let LiveKitAgentRoomSessionResult = class LiveKitAgentRoomSessionResult {
+};
+__decorate([
+    Field(() => Boolean),
+    __metadata("design:type", Boolean)
+], LiveKitAgentRoomSessionResult.prototype, "Success", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], LiveKitAgentRoomSessionResult.prototype, "ErrorMessage", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitAgentRoomSessionResult.prototype, "SessionBridgeID", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitAgentRoomSessionResult.prototype, "RoomName", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitAgentRoomSessionResult.prototype, "ServerUrl", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitAgentRoomSessionResult.prototype, "ClientToken", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitAgentRoomSessionResult.prototype, "Identity", void 0);
+LiveKitAgentRoomSessionResult = __decorate([
+    ObjectType()
+], LiveKitAgentRoomSessionResult);
+export { LiveKitAgentRoomSessionResult };
+let LiveKitRecordingInput = class LiveKitRecordingInput {
+};
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitRecordingInput.prototype, "RoomName", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], LiveKitRecordingInput.prototype, "Layout", void 0);
+LiveKitRecordingInput = __decorate([
+    InputType()
+], LiveKitRecordingInput);
+export { LiveKitRecordingInput };
+let LiveKitRecordingResult = class LiveKitRecordingResult {
+};
+__decorate([
+    Field(() => Boolean),
+    __metadata("design:type", Boolean)
+], LiveKitRecordingResult.prototype, "Success", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], LiveKitRecordingResult.prototype, "ErrorMessage", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitRecordingResult.prototype, "EgressID", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], LiveKitRecordingResult.prototype, "Status", void 0);
+LiveKitRecordingResult = __decorate([
+    ObjectType()
+], LiveKitRecordingResult);
+export { LiveKitRecordingResult };
+/** A selectable provider-native voice for the dev voice picker. */
+let RealtimeVoiceOptionResult = class RealtimeVoiceOptionResult {
+};
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], RealtimeVoiceOptionResult.prototype, "ID", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], RealtimeVoiceOptionResult.prototype, "Name", void 0);
+RealtimeVoiceOptionResult = __decorate([
+    ObjectType()
+], RealtimeVoiceOptionResult);
+export { RealtimeVoiceOptionResult };
+/** An active Realtime model with the voices its driver supports — feeds the dev model/voice picker. */
+let RealtimeModelVoicesResult = class RealtimeModelVoicesResult {
+};
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], RealtimeModelVoicesResult.prototype, "ModelID", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], RealtimeModelVoicesResult.prototype, "ModelName", void 0);
+__decorate([
+    Field(() => [RealtimeVoiceOptionResult]),
+    __metadata("design:type", Array)
+], RealtimeModelVoicesResult.prototype, "Voices", void 0);
+RealtimeModelVoicesResult = __decorate([
+    ObjectType()
+], RealtimeModelVoicesResult);
+export { RealtimeModelVoicesResult };
+let RealtimeBridgeResolver = class RealtimeBridgeResolver extends ResolverBase {
+    constructor() {
+        super(...arguments);
+        /** Durable `AIAgentSession` record manager — creates the session row the bridge FK-references. */
+        this.sessionManager = new SessionManager();
+    }
+    /**
+     * Mints a scoped LiveKit access token for the current user to join the given room. The participant
+     * identity is derived server-side from the authenticated user (never trusted from the client).
+     */
+    async MintLiveKitClientToken(input, context = {}) {
+        const failure = (msg) => ({
+            Success: false,
+            ErrorMessage: msg,
+            ServerUrl: '',
+            Token: '',
+            Identity: '',
+            RoomName: input.RoomName,
+        });
+        try {
+            const user = this.GetUserFromPayload(context.userPayload);
+            if (!user) {
+                return failure('Unable to determine current user.');
+            }
+            const tokenService = new LiveKitTokenService();
+            const minted = await tokenService.MintClientToken(input.RoomName, this.participantIdentity(user), input.DisplayName ?? user.Name ?? user.Email);
+            return { Success: true, ...minted };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`MintLiveKitClientToken failed: ${msg}`);
+            return failure(msg);
+        }
+    }
+    /**
+     * Starts (or reuses) an agent's presence in a LiveKit room and returns a client token so the calling
+     * user can immediately join the same room.
+     */
+    async StartLiveKitAgentRoomSession(input, context = {}) {
+        const failure = (msg, roomName = '') => ({
+            Success: false,
+            ErrorMessage: msg,
+            SessionBridgeID: '',
+            RoomName: roomName,
+            ServerUrl: '',
+            ClientToken: '',
+            Identity: '',
+        });
+        try {
+            const user = this.GetUserFromPayload(context.userPayload);
+            if (!user) {
+                return failure('Unable to determine current user.');
+            }
+            const provider = GetReadWriteProvider(context.providers);
+            const roomName = input.RoomName?.trim() || `mj-${randomUUID()}`;
+            // Resolve the AIAgentSession the bridge will reference. The bridge row FK-references
+            // AIAgentSession(ID), so we must use an EXISTING session — either one the caller supplied, or a
+            // freshly-created one. Previously this minted a bare random UUID with no backing row, so the
+            // bridge INSERT failed the FK_AIAgentSessionBridge_Session constraint.
+            let agentSessionID = input.AgentSessionID?.trim();
+            if (!agentSessionID) {
+                if (!input.AgentID?.trim()) {
+                    return failure('An AgentID is required to start an agent room session.', roomName);
+                }
+                const createdSession = await this.sessionManager.CreateSession({ agentID: input.AgentID.trim(), userID: user.ID }, user, provider);
+                agentSessionID = createdSession.ID;
+            }
+            const session = await LiveKitAgentRoomCoordinator.Instance.StartAgentRoomSession({
+                AgentSessionID: agentSessionID,
+                RoomName: roomName,
+                AgentID: input.AgentID,
+                AgentName: input.AgentName,
+                TargetAgentID: input.TargetAgentID,
+                RealtimeModelID: input.RealtimeModelID,
+                RealtimeVoice: input.RealtimeVoice,
+                TurnMode: this.normalizeTurnMode(input.TurnMode),
+                ContextUser: user,
+                MetadataProvider: provider,
+            });
+            const tokenService = new LiveKitTokenService();
+            const clientToken = await tokenService.MintClientToken(roomName, this.participantIdentity(user), user.Name ?? user.Email);
+            return {
+                Success: true,
+                SessionBridgeID: session.SessionBridgeID,
+                RoomName: session.RoomName,
+                ServerUrl: session.ServerUrl,
+                ClientToken: clientToken.Token,
+                Identity: clientToken.Identity,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`StartLiveKitAgentRoomSession failed: ${msg}`);
+            return failure(msg, input.RoomName ?? '');
+        }
+    }
+    /**
+     * Stops one agent's presence in a room (the bot leaves) — the remove half of in-room agent management.
+     * Identified by the `SessionBridgeID` returned from {@link StartLiveKitAgentRoomSession}. Returns `true`
+     * when the bridge was stopped. Best-effort: a missing/already-stopped bridge or any error resolves `false`.
+     *
+     * @param sessionBridgeID The `MJ: AI Agent Session Bridges` row id of the agent to remove.
+     */
+    async StopLiveKitAgentRoomSession(sessionBridgeID, context = {}) {
+        try {
+            const user = this.GetUserFromPayload(context.userPayload);
+            if (!user) {
+                return false;
+            }
+            const provider = GetReadWriteProvider(context.providers);
+            return await LiveKitAgentRoomCoordinator.Instance.StopAgentRoomSession(sessionBridgeID, 'Explicit', user, provider);
+        }
+        catch (error) {
+            LogError(`StopLiveKitAgentRoomSession failed: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
+    /**
+     * Lists active Realtime models with the voices each driver supports — the source for the dev model/voice
+     * picker (gated client-side by the `Realtime: Advanced Session Controls` authorization). Read-only; returns
+     * an empty list on any error so the picker degrades gracefully to "no overrides".
+     */
+    async GetRealtimeModelVoices(context = {}) {
+        try {
+            const user = this.GetUserFromPayload(context.userPayload);
+            if (!user) {
+                return [];
+            }
+            const provider = GetReadWriteProvider(context.providers);
+            return await GetRealtimeModelVoices(user, provider);
+        }
+        catch (error) {
+            LogError(`GetRealtimeModelVoices failed: ${error instanceof Error ? error.message : String(error)}`);
+            return [];
+        }
+    }
+    /**
+     * Invites MJ users to a live room: for each user, sends a **"Live Room Invite"** notification via the
+     * unified {@link NotificationEngine} — which writes the in-app notification (clickable → joins the room
+     * via the `meet-room` ResourceConfiguration) and ALSO delivers over MJ Comms (email/SMS) when the type's
+     * channels + a provider are configured. Best-effort: Comms not being set up never blocks the in-app
+     * notification, and a missing "Live Room Invite" type (seed not yet pushed) is caught and returns false.
+     *
+     * @param roomName The LiveKit room the invitees should join.
+     * @param userIDs The `MJ: Users` ids to invite.
+     * @returns `true` when at least one invite was delivered.
+     */
+    async InviteUsersToLiveKitRoom(roomName, userIDs, context = {}) {
+        try {
+            const user = this.GetUserFromPayload(context.userPayload);
+            if (!user) {
+                return false;
+            }
+            const provider = GetReadWriteProvider(context.providers);
+            await NotificationEngine.Instance.Config(false, user, provider);
+            const inviter = user.Name?.trim() || user.Email || 'Someone';
+            let anyDelivered = false;
+            for (const userId of userIDs ?? []) {
+                if (!userId?.trim()) {
+                    continue;
+                }
+                const result = await NotificationEngine.Instance.SendNotification({
+                    userId,
+                    typeNameOrId: 'Live Room Invite',
+                    title: `${inviter} invited you to a live room`,
+                    message: `${inviter} is inviting you to join a live Meet room. Open this notification to join.`,
+                    resourceConfiguration: { type: 'meet-room', room: roomName },
+                }, user);
+                anyDelivered = anyDelivered || result.success;
+            }
+            return anyDelivered;
+        }
+        catch (error) {
+            LogError(`InviteUsersToLiveKitRoom failed: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
+    /**
+     * Starts recording (composite egress) of a room. Server-authorized — the browser never holds egress
+     * credentials.
+     */
+    async StartLiveKitRecording(input, context = {}) {
+        try {
+            if (!this.GetUserFromPayload(context.userPayload)) {
+                return { Success: false, ErrorMessage: 'Unable to determine current user.', EgressID: '', Status: '' };
+            }
+            const info = await new LiveKitEgressService().StartRoomRecording({ RoomName: input.RoomName, Layout: input.Layout });
+            return { Success: true, EgressID: info.EgressID, Status: info.Status };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`StartLiveKitRecording failed: ${msg}`);
+            return { Success: false, ErrorMessage: msg, EgressID: '', Status: '' };
+        }
+    }
+    /** Stops a recording by egress id. */
+    async StopLiveKitRecording(egressID, context = {}) {
+        try {
+            if (!this.GetUserFromPayload(context.userPayload)) {
+                return { Success: false, ErrorMessage: 'Unable to determine current user.', EgressID: egressID, Status: '' };
+            }
+            const info = await new LiveKitEgressService().StopRecording(egressID);
+            return { Success: true, EgressID: info.EgressID, Status: info.Status };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`StopLiveKitRecording failed: ${msg}`);
+            return { Success: false, ErrorMessage: msg, EgressID: egressID, Status: '' };
+        }
+    }
+    /** Builds a stable, lowercased participant identity from the authenticated user. */
+    participantIdentity(user) {
+        return `user-${user.ID}`.toLowerCase();
+    }
+    /** Normalizes a turn-mode string to the bridge's accepted values. */
+    normalizeTurnMode(mode) {
+        switch ((mode ?? '').toLowerCase()) {
+            case 'active':
+                return 'Active';
+            case 'hybrid':
+                return 'Hybrid';
+            case 'passive':
+                return 'Passive';
+            default:
+                return undefined;
+        }
+    }
+};
+__decorate([
+    Mutation(() => LiveKitClientTokenResult),
+    __param(0, Arg('input', () => MintLiveKitClientTokenInput)),
+    __param(1, Ctx()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [MintLiveKitClientTokenInput, Object]),
+    __metadata("design:returntype", Promise)
+], RealtimeBridgeResolver.prototype, "MintLiveKitClientToken", null);
+__decorate([
+    Mutation(() => LiveKitAgentRoomSessionResult),
+    __param(0, Arg('input', () => StartLiveKitAgentRoomSessionInput)),
+    __param(1, Ctx()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [StartLiveKitAgentRoomSessionInput, Object]),
+    __metadata("design:returntype", Promise)
+], RealtimeBridgeResolver.prototype, "StartLiveKitAgentRoomSession", null);
+__decorate([
+    Mutation(() => Boolean),
+    __param(0, Arg('sessionBridgeID', () => String)),
+    __param(1, Ctx()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], RealtimeBridgeResolver.prototype, "StopLiveKitAgentRoomSession", null);
+__decorate([
+    Query(() => [RealtimeModelVoicesResult]),
+    __param(0, Ctx()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], RealtimeBridgeResolver.prototype, "GetRealtimeModelVoices", null);
+__decorate([
+    Mutation(() => Boolean),
+    __param(0, Arg('roomName', () => String)),
+    __param(1, Arg('userIDs', () => [String])),
+    __param(2, Ctx()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Array, Object]),
+    __metadata("design:returntype", Promise)
+], RealtimeBridgeResolver.prototype, "InviteUsersToLiveKitRoom", null);
+__decorate([
+    Mutation(() => LiveKitRecordingResult),
+    __param(0, Arg('input', () => LiveKitRecordingInput)),
+    __param(1, Ctx()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [LiveKitRecordingInput, Object]),
+    __metadata("design:returntype", Promise)
+], RealtimeBridgeResolver.prototype, "StartLiveKitRecording", null);
+__decorate([
+    Mutation(() => LiveKitRecordingResult),
+    __param(0, Arg('egressID', () => String)),
+    __param(1, Ctx()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], RealtimeBridgeResolver.prototype, "StopLiveKitRecording", null);
+RealtimeBridgeResolver = __decorate([
+    Resolver()
+], RealtimeBridgeResolver);
+export { RealtimeBridgeResolver };
+//# sourceMappingURL=RealtimeBridgeResolver.js.map