@memberjunction/server 5.41.0 → 5.43.0

package/dist/resolvers/RealtimeBridgeResolver.d.ts

@@ -0,0 +1,130 @@
+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>;
+    /**
+     * **Ends the meeting for everyone**: stops EVERY agent bot bridged into a room (by room name, via the
+     * coordinator's server-side roster). This is the "End meeting" half of the Zoom-style leave control —
+     * usable by any participant, including one who only *joined* the room and never tracked the bridge ids.
+     * Returns `true` when the teardown ran (even if the room held zero agents). Best-effort: any error → `false`.
+     *
+     * @param roomName The LiveKit room to end.
+     */
+    EndLiveKitRoom(roomName: 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":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAoD1D;;;;;;;;;;;GAWG;AAEH,qBACa,2BAA2B;IAEtC,QAAQ,EAAE,MAAM,CAAC;IAGjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBACa,wBAAwB;IAEnC,OAAO,EAAE,OAAO,CAAC;IAGjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,SAAS,EAAE,MAAM,CAAC;IAGlB,KAAK,EAAE,MAAM,CAAC;IAGd,QAAQ,EAAE,MAAM,CAAC;IAGjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBACa,iCAAiC;IAE5C,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6GAA6G;IAE7G,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,2GAA2G;IAE3G,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,0GAA0G;IAE1G,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBACa,6BAA6B;IAExC,OAAO,EAAE,OAAO,CAAC;IAGjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,eAAe,EAAE,MAAM,CAAC;IAGxB,QAAQ,EAAE,MAAM,CAAC;IAGjB,SAAS,EAAE,MAAM,CAAC;IAGlB,WAAW,EAAE,MAAM,CAAC;IAGpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBACa,qBAAqB;IAEhC,QAAQ,EAAE,MAAM,CAAC;IAGjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBACa,sBAAsB;IAEjC,OAAO,EAAE,OAAO,CAAC;IAGjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,QAAQ,EAAE,MAAM,CAAC;IAGjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,qBACa,yBAAyB;IAEpC,EAAE,EAAE,MAAM,CAAC;IAGX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uGAAuG;AACvG,qBACa,yBAAyB;IAEpC,OAAO,EAAE,MAAM,CAAC;IAGhB,SAAS,EAAE,MAAM,CAAC;IAGlB,MAAM,EAAE,yBAAyB,EAAE,CAAC;CACrC;AAED,qBACa,sBAAuB,SAAQ,YAAY;IACtD,kGAAkG;IAClG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IAEvD;;;OAGG;IAEG,sBAAsB,CACuB,KAAK,EAAE,2BAA2B,EAC5E,OAAO,GAAE,UAA6B,GAC5C,OAAO,CAAC,wBAAwB,CAAC;IAwBpC;;;OAGG;IAEG,4BAA4B,CACuB,KAAK,EAAE,iCAAiC,EACxF,OAAO,GAAE,UAA6B,GAC5C,OAAO,CAAC,6BAA6B,CAAC;IAkEzC;;;;;;OAMG;IAEG,2BAA2B,CACO,eAAe,EAAE,MAAM,EACtD,OAAO,GAAE,UAA6B,GAC5C,OAAO,CAAC,OAAO,CAAC;IAcnB;;;;;;;OAOG;IAEG,cAAc,CACa,QAAQ,EAAE,MAAM,EACxC,OAAO,GAAE,UAA6B,GAC5C,OAAO,CAAC,OAAO,CAAC;IAenB;;;;OAIG;IAEG,sBAAsB,CACnB,OAAO,GAAE,UAA6B,GAC5C,OAAO,CAAC,yBAAyB,EAAE,CAAC;IAcvC;;;;;;;;;;OAUG;IAEG,wBAAwB,CACG,QAAQ,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EAC1C,OAAO,GAAE,UAA6B,GAC5C,OAAO,CAAC,OAAO,CAAC;IAkCnB;;;OAGG;IAEG,qBAAqB,CACkB,KAAK,EAAE,qBAAqB,EAChE,OAAO,GAAE,UAA6B,GAC5C,OAAO,CAAC,sBAAsB,CAAC;IAclC,sCAAsC;IAEhC,oBAAoB,CAAgC,QAAQ,EAAE,MAAM,EAAS,OAAO,GAAE,UAA6B,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAc3J,oFAAoF;IACpF,OAAO,CAAC,mBAAmB;IAI3B,qEAAqE;IACrE,OAAO,CAAC,iBAAiB;CAY1B"}