@memberjunction/livekit-room-server 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/room-handoff/handoff-types.d.ts

@@ -0,0 +1,172 @@
+/**
+ * @fileoverview Shared types for bringing a person (or another agent) into a LiveKit room conversation.
+ *
+ * A **handoff** moves a conversation from the AI agent that is in a room to someone else, without the caller
+ * leaving the room: a person at an Explorer console (who is first OFFERED the conversation and may accept or
+ * decline), a phone number the room dials out to, or another AI agent. The caller stays in the room throughout;
+ * only the AI agent leaves, and only once the new party is actually present.
+ *
+ * The types here are the engine's vocabulary. Where a destination comes from (a named entry in the operator's
+ * transfer directory, a user looked up by email) is the caller's concern: by the time a request reaches the engine
+ * the destination is already resolved to an id or a validated number.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import type { IMetadataProvider, UserInfo } from '@memberjunction/core';
+/**
+ * How the AI agent leaves the conversation.
+ * - `warm`: the AI briefs the new party in a sentence or two (aloud, in the room), then leaves.
+ * - `blind`: the AI leaves as soon as the new party is present, with no briefing.
+ */
+export type HandoffMode = 'warm' | 'blind';
+/** A resolved place to hand the conversation to. */
+export type HandoffDestination = {
+    Kind: 'user';
+    /** The `MJ: Users` id of the person who is offered the conversation. */
+    UserID: string;
+    /** A name the AI can say (and the console can show). */
+    DisplayName: string;
+    /** E.164 number the room dials into the call when the person declines or does not answer in time. */
+    FallbackNumber?: string;
+} | {
+    Kind: 'number';
+    /** E.164 number the room dials. The caller of the engine has already checked it against the outbound policy. */
+    Number: string;
+    DisplayName: string;
+    /** Optional outbound caller ID to present when dialing. */
+    FromNumber?: string;
+} | {
+    Kind: 'agent';
+    /** The `MJ: AI Agents` id of the agent that takes over. */
+    AgentID: string;
+    AgentName: string;
+};
+/** One request to hand the conversation over. */
+export interface HandoffRequest {
+    Mode: HandoffMode;
+    Destination: HandoffDestination;
+    /** A short summary of the conversation so far, written by the AI. Shown on the offer and given to a taking-over agent. */
+    Summary: string;
+}
+/** Where a handoff offer stands. */
+export type HandoffOfferStatus = 'Pending' | 'Accepted' | 'Declined' | 'Expired' | 'Cancelled';
+/** What the console is shown about an offer. Never carries server-only fields (the target user id, the bridge id). */
+export interface HandoffOfferView {
+    OfferID: string;
+    RoomName: string;
+    Mode: HandoffMode;
+    /** The AI's summary of the conversation so far. */
+    Summary: string;
+    /** Who is on the other end, in words the person can use (a masked number, "Web visitor"). */
+    CallerLabel: string;
+    /** The AI agent that is in the room. */
+    AgentName: string;
+    Status: HandoffOfferStatus;
+    /** ISO-8601 UTC. */
+    CreatedAt: string;
+    /** ISO-8601 UTC; after this the offer can no longer be accepted. */
+    ExpiresAt: string;
+    /** The MJ interaction ID associated with this conversation/room, if known. */
+    InteractionID?: string | null;
+}
+/** One change to an offer, as published to the person it was offered to. */
+export interface HandoffOfferEvent {
+    /** The person the offer belongs to. A server-side delivery key: subscribers only ever see their own. */
+    UserID: string;
+    /** `offered` for a new offer; `updated` when it was accepted, declined, expired or cancelled. */
+    Kind: 'offered' | 'updated';
+    Offer: HandoffOfferView;
+}
+/**
+ * The live room call one AI agent is part of, as the engine needs to act on it. The host builds one per agent
+ * session and hands it to {@link RoomHandoffEngine.RequestHandoff}.
+ */
+export interface RoomHandoffAgentContext {
+    RoomName: string;
+    /** The agent's own name (said to the caller, shown on the offer). */
+    AgentName: string;
+    /** Who is on the other end of the room. */
+    CallerLabel: string;
+    /** The user the call runs as (a taking-over agent runs as the same user). */
+    ContextUser: UserInfo;
+    Provider: IMetadataProvider;
+    /** Removes THIS agent from the room. The room, and the caller, stay. */
+    LeaveRoom: () => Promise<void>;
+    /** Tells THIS agent's model something that happened out-of-band, so it can say it aloud. */
+    NotifyModel: (note: string) => void;
+}
+/** What the engine tells the host synchronously when a handoff is requested. */
+export type HandoffStartResult = {
+    Ok: true;
+    Status: 'offered' | 'dialing' | 'agent-joining';
+} | {
+    Ok: false;
+    Error: string;
+};
+/** Delivers a new offer to the person it was made to, outside the live subscription (in-app notification, email). */
+export interface IHandoffNotifier {
+    NotifyOffer(offer: HandoffOfferView, targetUserID: string, contextUser: UserInfo, provider: IMetadataProvider): Promise<void>;
+}
+/** Pushes offer changes to the person's open console. */
+export interface IHandoffPublisher {
+    Publish(event: HandoffOfferEvent): void;
+}
+/** Whether a participant is currently in a room. */
+export interface IRoomPresence {
+    IsParticipantPresent(roomName: string, identity: string): Promise<boolean>;
+}
+/** What a dial-out into the room needs. */
+export interface DialIntoRoomRequest {
+    RoomName: string;
+    Number: string;
+    ParticipantIdentity: string;
+    DisplayName?: string;
+    /** Caller ID / outbound from number (overrides default outbound from number). */
+    FromNumber?: string;
+    /** Seconds to let the number ring. */
+    RingTimeoutSeconds?: number;
+}
+/** Dials a phone number into a room as a participant. */
+export interface IRoomDialer {
+    DialIntoRoom(request: DialIntoRoomRequest): Promise<void>;
+}
+/** Asks the host to put an AI agent into the room, either to take a conversation over or to start one. */
+export interface StartRoomAgentRequest {
+    RoomName: string;
+    /** The agent the caller is to talk to (the persona; the host resolves the voice front-end that speaks as it). */
+    AgentID: string;
+    AgentName: string;
+    /** When taking over: what the agent that is leaving says about the conversation. Absent when starting a conversation. */
+    Brief?: string;
+    /** When taking over: the agent that is handing over. */
+    PreviousAgentName?: string;
+    CallerLabel: string;
+    ContextUser: UserInfo;
+    Provider: IMetadataProvider;
+    /** Optional per-session realtime model override (a developer's choice in the Meet UI). */
+    RealtimeModelID?: string;
+    /** Optional per-session voice override. */
+    RealtimeVoice?: string;
+}
+/** Handoff lifecycle event payload. */
+export interface RoomHandoffEvent {
+    RoomName: string;
+    EventType: 'Offered' | 'Accepted' | 'Declined' | 'Transferred' | 'Escalated';
+    ActorUserID?: string;
+    ActorAgentID?: string;
+    Details?: Record<string, unknown>;
+    ContextUser?: UserInfo;
+    Provider?: IMetadataProvider;
+}
+/** Observer for handoff lifecycle events (offered, accepted, declined, transferred, escalated). */
+export interface IRoomHandoffObserver {
+    OnHandoffEvent?: (event: RoomHandoffEvent) => void | Promise<void>;
+}
+/** What the host reports back once the agent is in the room. */
+export interface StartedRoomAgent {
+    /** The `MJ: AI Agent Session Bridges` row id (use it to stop that agent). */
+    SessionBridgeID: string;
+}
+/** Puts an AI agent into the room (the host owns the realtime session, tools and capacity for it). */
+export type RoomAgentStarter = (request: StartRoomAgentRequest) => Promise<StartedRoomAgent>;
+//# sourceMappingURL=handoff-types.d.ts.map

package/dist/room-handoff/handoff-types.d.ts.map

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

package/dist/room-handoff/handoff-types.js

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Shared types for bringing a person (or another agent) into a LiveKit room conversation.
+ *
+ * A **handoff** moves a conversation from the AI agent that is in a room to someone else, without the caller
+ * leaving the room: a person at an Explorer console (who is first OFFERED the conversation and may accept or
+ * decline), a phone number the room dials out to, or another AI agent. The caller stays in the room throughout;
+ * only the AI agent leaves, and only once the new party is actually present.
+ *
+ * The types here are the engine's vocabulary. Where a destination comes from (a named entry in the operator's
+ * transfer directory, a user looked up by email) is the caller's concern: by the time a request reaches the engine
+ * the destination is already resolved to an id or a validated number.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+export {};
+//# sourceMappingURL=handoff-types.js.map

package/dist/room-handoff/handoff-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-types.js","sourceRoot":"","sources":["../../src/room-handoff/handoff-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/room-handoff/room-handoff-engine.d.ts

@@ -0,0 +1,149 @@
+/**
+ * @fileoverview {@link RoomHandoffEngine}: moves a LiveKit room conversation from the AI agent that is in it to a
+ * person, a phone number, or another AI agent, while the caller stays in the room.
+ *
+ * The room is the shared plane. A handoff never transfers the caller; it adds the new party to the room the caller
+ * is already in and then takes the AI out. That is what makes "warm" possible (the AI can say a sentence to the new
+ * party with the caller listening) and what makes a failed handoff harmless (nobody is moved, so the AI just carries on).
+ *
+ * The flow for each destination:
+ * - **person**: an offer is created and pushed to their console. If they accept, the console joins the room; the engine
+ *   watches the room until they are actually present, then runs the leave step. If they decline, or do not answer in time
+ *   (or accept but never appear), the engine dials the person's fallback number into the room when one is configured, and
+ *   otherwise tells the model nobody is available.
+ * - **number**: the room dials the number; when it answers and is present, the leave step runs.
+ * - **agent**: the host starts the other agent in the room; when it is up, the leave step runs.
+ *
+ * The leave step is where warm and blind differ. Blind: the AI leaves as soon as the new party is present. Warm: the AI is
+ * told the party has joined and to introduce them in a sentence or two, then to call `finish_handoff`; it leaves a moment
+ * after that call (so its last words are heard), or after a ceiling if it never calls.
+ *
+ * Everything the engine touches the outside world with is an injected seam (presence, dialer, notifier, publisher, agent
+ * starter), so the whole flow is unit-tested with fakes. One handoff runs per room at a time. State is in memory and per
+ * process: see {@link HandoffOfferRegistry} for what a multi-instance deployment needs.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { BaseSingleton } from '@memberjunction/global';
+import type { HandoffOfferView, HandoffRequest, HandoffStartResult, IHandoffNotifier, IHandoffPublisher, IRoomDialer, IRoomHandoffObserver, IRoomPresence, RoomAgentStarter, RoomHandoffAgentContext, RoomHandoffEvent } from './handoff-types.js';
+/** The tool the AI calls after briefing the new party, to say it is done and can leave. */
+export declare const FINISH_HANDOFF_TOOL = "finish_handoff";
+/** How long a person who accepted an offer has to actually appear in the room. */
+export declare const HANDOFF_JOIN_WAIT_MS = 90000;
+/** How often the room is checked for the new party. */
+export declare const HANDOFF_PRESENCE_POLL_MS = 1000;
+/** The longest the AI is given to brief the new party before it is removed anyway. */
+export declare const HANDOFF_BRIEF_MAX_MS = 45000;
+/** How long the AI's last words are given to play after it calls {@link FINISH_HANDOFF_TOOL}. */
+export declare const HANDOFF_LEAVE_SETTLE_MS = 3000;
+/** How long after a blind handoff's new party appears the AI leaves. */
+export declare const HANDOFF_BLIND_LEAVE_DELAY_MS = 1500;
+/** How long a number the room dials is allowed to ring. */
+export declare const HANDOFF_DIAL_RING_SECONDS = 30;
+/** The longest summary kept (it is shown on the offer and given to a taking-over agent). */
+export declare const MAX_HANDOFF_SUMMARY_CHARS = 600;
+/** The collaborators the engine uses. All optional: a handoff kind whose collaborator is missing is refused clearly. */
+export interface RoomHandoffDeps {
+    Presence?: IRoomPresence;
+    Dialer?: IRoomDialer;
+    Notifier?: IHandoffNotifier;
+    Publisher?: IHandoffPublisher;
+    AgentStarter?: RoomAgentStarter;
+    Observer?: IRoomHandoffObserver;
+}
+/** Brings a person, a number or another agent into a room conversation and takes the AI out. */
+export declare class RoomHandoffEngine extends BaseSingleton<RoomHandoffEngine> {
+    private deps;
+    private readonly flows;
+    private readonly registeredObservers;
+    private nextFlowID;
+    protected constructor();
+    /** The process-wide engine. */
+    static get Instance(): RoomHandoffEngine;
+    /** Sets (merges) the collaborators. Called once at startup by the host that owns each one. */
+    Configure(deps: RoomHandoffDeps): void;
+    /** Registers an observer for handoff lifecycle events without replacing the primary collaborator. */
+    RegisterObserver(observer: IRoomHandoffObserver): {
+        Unregister: () => void;
+    };
+    /** The collaborators currently set (a `Pick` for diagnostics; tests read it). */
+    get Deps(): Readonly<RoomHandoffDeps>;
+    /** Drops every flow and every collaborator (tests, shutdown). */
+    Reset(): void;
+    /** Emits a handoff event to all registered observers and the primary observer. */
+    EmitHandoffEvent(event: RoomHandoffEvent): void;
+    private emitHandoffEvent;
+    /**
+     * Starts handing the conversation over. Returns at once; what happens next is reported to the model through
+     * {@link RoomHandoffAgentContext.NotifyModel}.
+     */
+    RequestHandoff(agent: RoomHandoffAgentContext, request: HandoffRequest): Promise<HandoffStartResult>;
+    /** The AI says it has finished briefing and is ready to leave. Returns whether a handoff was waiting for that. */
+    AgentReadyToLeave(roomName: string): boolean;
+    /** Whether a handoff is in progress for the room. */
+    HasHandoff(roomName: string): boolean;
+    /**
+     * The room's call ended or the agent left for another reason: abandon its handoff and withdraw its offer. A flow
+     * that is already leaving is finished, not cancelled.
+     */
+    CancelRoom(roomName: string): void;
+    /** The offers to show a person (pending ones and recently resolved ones). */
+    ListOffersForUser(userID: string, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<HandoffOfferView[]>;
+    /**
+     * A person accepts an offer. Authorised by the offer's target; anything else answers as a missing offer. On success
+     * the console should join the room; the engine watches for them and takes the AI out once they are there.
+     */
+    AcceptOffer(offerID: string, userID: string, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<{
+        Ok: true;
+        Offer: HandoffOfferView;
+    } | {
+        Ok: false;
+        Reason: string;
+    }>;
+    /** A person declines an offer. Authorised the same way as {@link AcceptOffer}. */
+    DeclineOffer(offerID: string, userID: string, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<{
+        Ok: true;
+    } | {
+        Ok: false;
+        Reason: string;
+    }>;
+    /**
+     * Handles an offer update forwarded from another cluster instance via cross-instance pub/sub.
+     */
+    OnRemoteOfferChange(payload: {
+        UserID: string;
+        Kind: string;
+        Offer: HandoffOfferView;
+    }): void;
+    /** Checks the request and that the collaborators its kind needs are present. */
+    private prepare;
+    private begin;
+    private offerToUser;
+    private onOfferTimeout;
+    private waitForUserToJoin;
+    /** Dials a number into the room and waits for it to appear. Used for a number target and for a person's fallback. */
+    private dialAndAwait;
+    private startAgent;
+    /** The person did not take it. Fall back to their phone when one is configured, otherwise tell the model. */
+    private onPartyUnavailable;
+    /** The handoff failed for good: tell the model so it can tell the caller, and let the call carry on with the AI. */
+    private finishUnavailable;
+    /** The new party is in the room. Blind: the AI leaves. Warm: the AI briefs them, then leaves. */
+    private onPartyPresent;
+    /** Takes the AI out of the room. The flow is removed first, so the agent's own teardown does not read as a cancellation. */
+    private leave;
+    /** Checks the room for a participant until it is there, the flow is cancelled, or the time is up. */
+    private pollPresence;
+    private isPresent;
+    private notify;
+    private publishUpdate;
+    private publish;
+    private flowForOffer;
+    private removeFlow;
+    /** Stops a flow's timers and withdraws its offer. */
+    private cancelFlow;
+    private armTimer;
+    private clearTimers;
+}
+//# sourceMappingURL=room-handoff-engine.d.ts.map

package/dist/room-handoff/room-handoff-engine.d.ts.map

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