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

package/README.md

@@ -114,6 +114,91 @@ and logs — the stop-recording mutation still succeeds. See
 [REALTIME_SESSION_CAPTURE_GUIDE.md](../../guides/REALTIME_SESSION_CAPTURE_GUIDE.md#meeting-room-recording-livekit-egress--mjstorage)
 for the full loop incl. Meet-app playback.
 
+## Room audio player (hold music)
+
+`RoomAudioPlayer` joins a room as a small **publish-only** bot and plays audio into it: contact-center hold
+music, with spoken announcements ducked over the top. It reuses the agent bridge's plumbing: bot tokens from
+`LiveKitTokenService` (the `LIVEKIT_*` env vars), the native room client at the same specifier the agent
+coordinator uses (`LIVEKIT_NATIVE_MODULE`, default `@memberjunction/ai-bridge-livekit-native`), and the PCM16
+resampler from `@memberjunction/ai-bridge-base`.
+
+```typescript
+import { RoomAudioPlayer } from '@memberjunction/livekit-room-server';
+
+const hold = await RoomAudioPlayer.Instance.Start({
+  RoomName: callRoom,
+  Source: { Kind: 'File', FileID: queue.HoldMusicFileID },   // or { Kind: 'Url', Url }, { Kind: 'Pcm', Pcm, SampleRate }, { Kind: 'ComfortTone' }
+  ContextUser: contextUser,
+  // Loop: true (default), DisplayName: 'On hold' (default), Identity: 'hold-<playback id>' (default)
+});
+
+await hold.Announce({ Text: 'You are caller number three.' }); // music ducks, clip plays, music returns
+hold.Pause(); hold.Resume();
+await hold.Stop();                                              // idempotent; always disconnects the bot
+
+RoomAudioPlayer.Instance.GetActive(callRoom);                   // live playbacks in a room
+await RoomAudioPlayer.Instance.StopAllInRoom(callRoom);         // e.g. when an agent picks up
+```
+
+**Sources.** An `MJ: Files` row (loaded as `ContextUser`, bytes read through `@memberjunction/storage`), an
+**https** URL (plain http is refused; fetched with `SafeFetch`, so every redirect hop is checked against
+private/reserved addresses; 20 s timeout; 25 MB cap), caller-supplied mono PCM16, or the built-in
+**comfort tone** — a procedurally generated 10 s loop of soft chord pads (no asset, nothing to license).
+
+**Formats.** WAV (integer PCM 8/16/24/32-bit, IEEE float 32/64-bit, `WAVE_FORMAT_EXTENSIBLE`, any channel count —
+downmixed to mono) and MP3 (decoded by `mpg123-decoder`, a WebAssembly build of libmpg123: no native build step).
+Anything else (Ogg, FLAC, AAC/M4A, …) is refused with an error naming the format. Audio is limited to
+**15 minutes**; hold music loops, so a few minutes is plenty.
+
+**Playback.** Audio is resampled to 48 kHz and paced into the room in 20 ms frames against a monotonic clock,
+about 150 ms ahead of real time — the native client's own outbound queue never holds more than that. A blocked
+event loop drops the missed audio instead of bursting it. Decodes are cached by source (8 entries, 256 MB of PCM),
+and concurrent starts of the same file share one download, so a busy queue reads its hold file once. The cache is
+keyed by source, not by user: only the first load checks the reading user's access to the file.
+
+**Lifecycle.** A playback whose bot is disconnected by the server stops and deregisters itself, and a verified
+`room_finished` webhook (`LiveKitWebhookParser.Parse`) stops every playback in that room. A non-looping playback
+leaves the room when its audio ends — after the audio already sent ahead of real time (about 150 ms) has played
+out, so the tail is not cut off.
+
+**Knowing it finished.** Every handle has `Ended: Promise<RoomAudioEndReason>`, which resolves once the bot has
+left the room, and `EndReason` (`null` while live). Only `'Completed'` means the whole clip reached the room;
+`'Stopped'` (Stop / StopAllInRoom), `'Failed'` (the outbound sink broke) and `'Disconnected'` (the server dropped
+the bot) all mean it was cut short. The first reason wins. Use it to gate anything that must follow a full play:
+
+```typescript
+const disclosure = await RoomAudioPlayer.Instance.Start({
+  RoomName: callRoom,
+  Source: { Kind: 'File', FileID: disclosureFileID },
+  Loop: false,
+  DisplayName: 'Recording notice',
+  ContextUser: contextUser,
+});
+if ((await disclosure.Ended) === 'Completed') {
+  await startRecording();       // the caller has heard the whole notice
+} else {
+  // fail closed: do not record
+}
+```
+
+A looping playback never completes on its own; its `Ended` resolves `'Stopped'` when it is stopped.
+
+**Announcements and text-to-speech.** `Announce({ Pcm, SampleRate })` plays ready-made audio. `Announce({ Text })`
+goes through the `IRoomSpeechSynthesizer` port, and **none is installed by default** — a voice is vendor-specific,
+so the host chooses it. Without one, a text announcement returns `false` and the player logs the omission once.
+To enable it, install the MJ-backed synthesizer (`AITextToSpeechRunner`: model selection, credentials, failover,
+an `MJ: AI Prompt Runs` row) once at startup:
+
+```typescript
+import { MJRoomSpeechSynthesizer, RoomAudioPlayer } from '@memberjunction/livekit-room-server';
+
+RoomAudioPlayer.Instance.SetSpeechSynthesizer(new MJRoomSpeechSynthesizer({ Voice: 'alloy', ModelID: ttsModelID }));
+```
+
+The host needs an active TTS model whose vendor offers that voice (pin `ModelID` — voices belong to a vendor)
+and the carrier prompt `Default Text To Speech` (or pass `PromptID`). Any other implementation of
+`IRoomSpeechSynthesizer` works too.
+
 ## GraphQL surface
 
 These are exposed to the browser via MJServer's `RealtimeBridgeResolver`:

package/dist/index.d.ts

@@ -6,7 +6,23 @@
  *
  * @module @memberjunction/livekit-room-server
  */
-export { LiveKitTokenService, type LiveKitServerConfig, type LiveKitTokenRole, type MintTokenParams, type MintedToken } from './livekit-token-service.js';
-export { LiveKitAgentRoomCoordinator, LIVEKIT_BRIDGE_DRIVER_CLASS, type BridgeOps, type RealtimeSessionFactory, type RealtimeSessionStartContext, type StartAgentRoomSessionParams, type AgentRoomSession, } from './livekit-agent-room-coordinator.js';
+export { LiveKitTokenService, LiveKitUserIdentity, type LiveKitServerConfig, type LiveKitTokenRole, type MintTokenParams, type MintedToken } from './livekit-token-service.js';
+export { LiveKitAgentRoomCoordinator, LIVEKIT_BRIDGE_DRIVER_CLASS, type BridgeOps, type RealtimeSessionFactory, type RealtimeSessionStartContext, type AgentRoomHostOptions, type StartAgentRoomSessionParams, type AgentRoomSession, } from './livekit-agent-room-coordinator.js';
 export { LiveKitEgressService, WsToHttpUrl, wsToHttpUrl, type EgressClientLike, type StartRecordingParams, type RecordingInfo } from './livekit-egress-service.js';
+export { LiveKitParticipantService, type ParticipantUpdateClientLike, type ParticipantUpdateResult } from './livekit-participant-service.js';
+export { LiveKitSipService, LIVEKIT_PARTICIPANT_KIND_SIP, LIVEKIT_SIP_ATTRIBUTES, SIP_DIAL_REQUEST_TIMEOUT_SECONDS, SIP_DIAL_MAX_DURATION_SECONDS, type SipClientLike, type RoomServiceClientLike, type RoomParticipantSummary, type SipTrunkSummary, type DialSipParticipantParams, type EnsureInboundRoutingParams, type InboundRoutingResult, } from './livekit-sip-service.js';
+export { LiveKitWebhookParser, type LiveKitRoomWebhookEvent, type WebhookReceiverLike } from './livekit-webhook.js';
+export * from './room-handoff/handoff-types.js';
+export * from './room-handoff/handoff-offer-registry.js';
+export * from './room-handoff/room-handoff-engine.js';
+export * from './room-authorization.js';
+export * from './meeting-dial-in-service.js';
+export { DEFAULT_LIVEKIT_NATIVE_MODULE, ResolveLiveKitNativeModuleSpecifier } from './livekit-native-module.js';
+export * from './room-audio/audio-decoder.js';
+export * from './room-audio/comfort-tone.js';
+export * from './room-audio/pcm-frame-pump.js';
+export * from './room-audio/room-audio-decode-cache.js';
+export * from './room-audio/room-audio-sources.js';
+export * from './room-audio/room-speech-synthesizer.js';
+export * from './room-audio/room-audio-player.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEvJ,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,GACtB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE5K,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,GACtB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEhK,OAAO,EAAE,yBAAyB,EAAE,KAAK,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE1I,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,sBAAsB,EACtB,gCAAgC,EAChC,6BAA6B,EAC7B,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEjH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAE1C,OAAO,EAAE,6BAA6B,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC;AAG7G,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC"}

package/dist/index.js

@@ -13,7 +13,24 @@ import { LoadLiveKitBridge } from '@memberjunction/ai-bridge-livekit';
 // MJServer does) registers the bridge. The no-op call is a tree-shake guard. Without this the room start
 // fails with "No bridge driver registered for DriverClass 'LiveKitBridge'".
 LoadLiveKitBridge();
-export { LiveKitTokenService } from './livekit-token-service.js';
+export { LiveKitTokenService, LiveKitUserIdentity } from './livekit-token-service.js';
 export { LiveKitAgentRoomCoordinator, LIVEKIT_BRIDGE_DRIVER_CLASS, } from './livekit-agent-room-coordinator.js';
 export { LiveKitEgressService, WsToHttpUrl, wsToHttpUrl } from './livekit-egress-service.js';
+export { LiveKitParticipantService } from './livekit-participant-service.js';
+export { LiveKitSipService, LIVEKIT_PARTICIPANT_KIND_SIP, LIVEKIT_SIP_ATTRIBUTES, SIP_DIAL_REQUEST_TIMEOUT_SECONDS, SIP_DIAL_MAX_DURATION_SECONDS, } from './livekit-sip-service.js';
+export { LiveKitWebhookParser } from './livekit-webhook.js';
+export * from './room-handoff/handoff-types.js';
+export * from './room-handoff/handoff-offer-registry.js';
+export * from './room-handoff/room-handoff-engine.js';
+export * from './room-authorization.js';
+export * from './meeting-dial-in-service.js';
+export { DEFAULT_LIVEKIT_NATIVE_MODULE, ResolveLiveKitNativeModuleSpecifier } from './livekit-native-module.js';
+// Room audio player (contact-center hold music + ducked announcements).
+export * from './room-audio/audio-decoder.js';
+export * from './room-audio/comfort-tone.js';
+export * from './room-audio/pcm-frame-pump.js';
+export * from './room-audio/room-audio-decode-cache.js';
+export * from './room-audio/room-audio-sources.js';
+export * from './room-audio/room-speech-synthesizer.js';
+export * from './room-audio/room-audio-player.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,+FAA+F;AAC/F,sGAAsG;AACtG,wGAAwG;AACxG,yGAAyG;AACzG,4EAA4E;AAC5E,iBAAiB,EAAE,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAA2F,MAAM,yBAAyB,CAAC;AAEvJ,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,GAM5B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,WAAW,EAAwE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,+FAA+F;AAC/F,sGAAsG;AACtG,wGAAwG;AACxG,yGAAyG;AACzG,4EAA4E;AAC5E,iBAAiB,EAAE,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAA2F,MAAM,yBAAyB,CAAC;AAE5K,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,GAO5B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,WAAW,EAAwE,MAAM,0BAA0B,CAAC;AAEhK,OAAO,EAAE,yBAAyB,EAAkE,MAAM,+BAA+B,CAAC;AAE1I,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,sBAAsB,EACtB,gCAAgC,EAChC,6BAA6B,GAQ9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAA0D,MAAM,mBAAmB,CAAC;AAEjH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAE1C,OAAO,EAAE,6BAA6B,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC;AAE7G,wEAAwE;AACxE,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC"}

package/dist/livekit-agent-room-coordinator.d.ts

@@ -1,10 +1,12 @@
 /**
  * @fileoverview {@link LiveKitAgentRoomCoordinator} — the server-side **session-start harness** for the
  * MJ-native LiveKit room (§1 of the realtime-bridge buildout plan). Given an agent + a room, it:
- *   1. mints the agent bot's scoped LiveKit token ({@link LiveKitTokenService}),
- *   2. opens the realtime model session via an injectable {@link RealtimeSessionFactory} seam, and
+ *   1. opens the realtime model session via an injectable {@link RealtimeSessionFactory} seam,
+ *   2. mints the agent bot's scoped LiveKit token ({@link LiveKitTokenService}), whose attributes depend on the session, and
  *   3. bridges that session into the room through {@link AIBridgeEngine.StartBridgeSession} (which wires
  *      the transport seam + turn-taking automatically).
+ * A start that fails after step 1 closes the model session before the error propagates, recording the failure on the
+ * agent's co-agent run first ({@link FailedStartRecorder}).
  *
  * The realtime-session factory is a seam (mirroring `LiveKitBridge.SetSdkFactory`): production binds it to
  * the real model-resolution path (`@memberjunction/ai-agents`), and tests/de-risk inject a stub session.
@@ -14,9 +16,10 @@
  */
 import { BaseSingleton } from '@memberjunction/global';
 import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
-import type { IRealtimeSession } from '@memberjunction/ai';
-import { type BridgeDisconnectReason, type BridgeTurnMode } from '@memberjunction/ai-bridge-base';
-import { AIBridgeEngine } from '@memberjunction/ai-bridge-server';
+import { type IRealtimeSession, type RealtimeToolDefinition } from '@memberjunction/ai';
+import { type NativeAvatarVideoSupport } from '@memberjunction/ai-bridge-livekit';
+import { type BridgeDisconnectReason, type BridgeTurnMode, type TurnAddressingMode } from '@memberjunction/ai-bridge-base';
+import { AIBridgeEngine, type BridgeTranscriptSink, type BridgeTurnTakingToolHandler, type RoomTurnSnapshot } from '@memberjunction/ai-bridge-server';
 import { LiveKitTokenService } from './livekit-token-service.js';
 /** The subset of {@link AIBridgeEngine} the coordinator drives — an injectable seam for unit testing. */
 export type BridgeOps = Pick<AIBridgeEngine, 'Config' | 'ProviderByDriverClass' | 'StartBridgeSession' | 'StopBridgeSession' | 'ReconfigureSessionToMeeting'>;
@@ -49,7 +52,95 @@ export interface RealtimeSessionStartContext {
     MeetingMode?: boolean;
     /** The names the agent answers to (display name + aliases) — phrasing for the meeting prompt. */
     SelfNames?: string[];
+    /** Tools the host declares and executes itself (call control, handoff). Added to the model's tool set. */
+    HostTools?: RealtimeToolDefinition[];
+    /**
+     * Optional callback allowing the coordinator to resolve host tools dynamically based on
+     * the model and driver class context actually resolved for the session, before session opening.
+     */
+    ResolveHostTools?: (resolved: {
+        ModelID?: string;
+        ModelVendorID?: string;
+        DriverClass?: string;
+    }) => RealtimeToolDefinition[] | undefined;
+    /** Host-authored instructions appended to the system prompt (for example the phone framing). */
+    HostFraming?: string;
+    /** Role-tagged transcript so far, framed into the prompt when a lost model session is re-opened mid-call. */
+    PriorTranscript?: string;
+    /** The `MJ: Conversations` row the session writes to — stamped on the co-agent observability run. */
+    ConversationID?: string;
+    /**
+     * `'room'` when this host's bot can publish the agent's avatar into the room (the native module answered
+     * `describeAvatarVideo` with support): the session may then ask the model to render it. Absent: audio only, as before.
+     */
+    AvatarDelivery?: 'room';
+    /**
+     * `true` when the agent is answering a phone call in the room ({@link AgentRoomHostOptions.Channel} `'phone'`): the
+     * caller sees no video, so the session asks the model for no avatar and reports `phone`. Never set with
+     * {@link AvatarDelivery}.
+     */
+    PhoneCall?: boolean;
+}
+/**
+ * What a HOST that owns the call (a phone call arriving in a room, a web room with handoff tools) adds to an agent's
+ * room session beyond the plain "join the room" the coordinator does for the Meet UI. All optional: a session started
+ * without it behaves exactly as before. A start that created the agent session for this agent alone (a Meet room, a
+ * scheduled meeting) passes only {@link AgentRoomHostOptions.OnSessionEnded}, to close that session when the agent leaves.
+ */
+export interface AgentRoomHostOptions {
+    /** Tools the host executes itself. */
+    HostTools?: RealtimeToolDefinition[];
+    /** Instructions appended to the agent's system prompt. */
+    HostFraming?: string;
+    /** The conversation the session's transcript belongs to. */
+    ConversationID?: string;
+    /**
+     * Called with every model session opened for this agent (the first one, and any re-opened after a drop) so the host
+     * can attach its tool handler to each.
+     */
+    OnModelSession?: (session: IRealtimeSession) => void;
+    /** Where this session's final transcript lines go (instead of the shared room transcript). */
+    TranscriptSink?: BridgeTranscriptSink;
+    /** The participant talked over the agent (a true barge-in). */
+    OnBargeIn?: () => void;
+    /** Re-open the model session once, with the conversation so far, if it drops mid-call. */
+    RecoverModelSession?: boolean;
+    /**
+     * Called once when the session has fully ended, for whatever reason (a stop, an emptied room, a lost model session),
+     * for the host's own bookkeeping: closing the agent session it created, freeing a capacity slot.
+     */
+    OnSessionEnded?: (reason: BridgeDisconnectReason) => void | Promise<void>;
+    /** How the agent got into the room. Default `'OnDemand'`. */
+    JoinMethod?: 'InboundRoute' | 'OnDemand' | 'Invite';
+    /** Whether the agent was called into the room or placed the call. Default: not stated. */
+    Direction?: 'Inbound' | 'Outbound';
+    /**
+     * How the person the agent serves reached the room: `'phone'`, a phone call through SIP (they hear the agent and see
+     * nothing), or `'web'`, a browser. On a phone call the coordinator never asks for the avatar: no room delivery, and the
+     * session asks the model for none (`phone`), even when people in the room could see it. Default: not stated, which
+     * is treated like `'web'`.
+     */
+    Channel?: 'phone' | 'web';
 }
+/**
+ * Installs the engine's turn-taking tool handler on a model session — the seam that lets this package stay free
+ * of the agent runtime. Production binds it to `GetBridgeRealtimeRuntime(session)?.SetLocalToolHandler(handler)`
+ * (`@memberjunction/ai-agents`); a test binds a spy.
+ */
+export type TurnToolBinder = (session: IRealtimeSession, handler: BridgeTurnTakingToolHandler) => void;
+/**
+ * Says whether the agent behind a model session watches meetings (its `realtime.video.watchMeetings` setting) — the
+ * seam that keeps this package free of the agent runtime, like {@link TurnToolBinder}. Production binds it to the
+ * session's bridged runtime (`@memberjunction/ai-agents`); unbound, no agent watches.
+ */
+export type AgentVisionResolver = (session: IRealtimeSession) => boolean;
+/**
+ * Records a failed start on the co-agent run of the model session the start opened, with the start's error — the seam
+ * that keeps this package free of the agent runtime, like {@link TurnToolBinder}. Production binds it to the session's
+ * bridged runtime (`Finalize(false, error)`, `@memberjunction/ai-agents`). The coordinator calls it before it closes that
+ * session, because the close alone finalizes the run as completed, which is what happens when nothing is bound.
+ */
+export type FailedStartRecorder = (session: IRealtimeSession, error: string) => Promise<void>;
 /**
  * Opens a realtime model session for the agent. Production binds this to the real model-resolution path;
  * tests inject a stub. Defaults to a clear "not bound" error so misconfiguration fails loudly.
@@ -74,14 +165,36 @@ export interface StartAgentRoomSessionParams {
     RealtimeModelID?: string;
     /** Optional per-session VOICE override (provider-native voice id) — gives this agent a distinct voice. */
     RealtimeVoice?: string;
+    /** Explicit override for whether the model is full-duplex. When omitted, resolved from model metadata or driver capabilities. */
+    FullDuplex?: boolean;
     /** Extra aliases the agent answers to (for Passive turn-taking). */
     AgentAliases?: string[];
     /** Turn-taking mode. Default: `'Passive'` (speak only when addressed). */
     TurnMode?: BridgeTurnMode;
+    /**
+     * How the agent decides it was addressed. `'Auto'` (the default) uses the MODEL's own judgement when its model is
+     * full-duplex and falls back to name matching otherwise; `'ModelSide'` / `'Regex'` force one. A room in moderator
+     * mode (gated meeting) always uses `'Regex'`.
+     */
+    TurnAddressing?: TurnAddressingMode;
     /** The user the session runs as. */
     ContextUser?: UserInfo;
     /** The metadata provider for the session. */
     MetadataProvider?: IMetadataProvider;
+    /**
+     * What a host that owns the call adds (tools, framing, transcript, recovery). A plain Meet room passes at most its
+     * end-of-session hook, to close the agent session it created.
+     */
+    Host?: AgentRoomHostOptions;
+}
+/** One agent's membership in a room's roster (for multi-agent meeting detection). */
+export interface RoomAgentEntry {
+    /** The MJ agent-session id of this agent in the room. */
+    AgentSessionID: string;
+    /** The durable bridge row id — the key {@link LiveKitAgentRoomCoordinator.StopAgentRoomSession} removes by. */
+    SessionBridgeID: string;
+    /** The names this agent answers to (display name + aliases) — used to build its addressing matcher. */
+    Names: string[];
 }
 /** The result of starting an agent room session. */
 export interface AgentRoomSession {
@@ -109,6 +222,10 @@ export declare class LiveKitAgentRoomCoordinator extends BaseSingleton<LiveKitAg
      */
     private roomRosters;
     private bridgeOps;
+    private turnToolBinder?;
+    private agentVisionResolver?;
+    private failedStartRecorder?;
+    private turnStateSource;
     private sessionFactory;
     /** BaseSingleton requires a protected constructor. */
     protected constructor();
@@ -120,6 +237,43 @@ export declare class LiveKitAgentRoomCoordinator extends BaseSingleton<LiveKitAg
      * @param factory The factory that opens an {@link IRealtimeSession} for an agent.
      */
     SetSessionFactory(factory: RealtimeSessionFactory): void;
+    /**
+     * Binds the seam that installs the engine's turn-taking tool handler on a model session. Without it a
+     * full-duplex model's `i_am_addressed` / `yield_turn` calls cannot be executed (the room's floor gate still
+     * protects against overlap; the model just cannot reserve the floor or hand it to a named agent).
+     *
+     * @param binder The binder, or `undefined` to clear it.
+     */
+    SetTurnToolBinder(binder: TurnToolBinder | undefined): void;
+    /**
+     * Binds the seam that says whether the agent behind a model session watches meetings. Without it no agent watches:
+     * the bot reads nobody's camera or screen and the room never offers people the choice.
+     *
+     * @param resolver The resolver, or `undefined` to clear it.
+     */
+    SetAgentVisionResolver(resolver: AgentVisionResolver | undefined): void;
+    /**
+     * Binds the seam that records a failed start on the agent's co-agent run. Without it, the run of an agent whose start
+     * failed reads as completed: closing its model session finalizes the run that way.
+     *
+     * @param recorder The recorder, or `undefined` to clear it.
+     */
+    SetFailedStartRecorder(recorder: FailedStartRecorder | undefined): void;
+    /**
+     * Overrides where a room's turn-taking snapshot comes from (an injectable seam for unit testing; production
+     * reads the process-wide {@link AIBridgeEngine}).
+     *
+     * @param source Returns the snapshot for a room key, or `null` when the room holds no agents.
+     */
+    SetTurnStateSource(source: (roomKey: string) => RoomTurnSnapshot | null): void;
+    /**
+     * A room's live turn-taking state — floor holder, whether a person is speaking, any pending hand-off, the
+     * agent-to-agent loop-cap progress, the most recent floor events, and who is seated. Read-only.
+     *
+     * @param roomName The LiveKit room name (the bridge's room key).
+     * @returns The snapshot, or `null` when the room holds no agents.
+     */
+    GetRoomTurnState(roomName: string): RoomTurnSnapshot | null;
     /**
      * Overrides the token service used to mint the bot token (e.g. to inject explicit credentials).
      *
@@ -134,24 +288,66 @@ export declare class LiveKitAgentRoomCoordinator extends BaseSingleton<LiveKitAg
      */
     SetBridgeOps(ops: BridgeOps): void;
     /**
-     * Starts the agent's presence in a LiveKit room: mints the bot token, opens the realtime session, and
-     * bridges it into the room.
+     * Starts the agent's presence in a LiveKit room: opens the realtime session, mints the bot token, and
+     * bridges the session into the room.
+     *
+     * A start that fails once the model session is open (the bot token can't be minted, the bridge doesn't start) closes
+     * that session before the error propagates, after recording the failure, with the start's error, on the session's
+     * co-agent run ({@link SetFailedStartRecorder}), which would otherwise read as completed. The agent session it runs under
+     * (`AgentSessionID`) is the caller's: a caller that created one for this start closes it.
      *
      * @param params The session parameters.
      * @returns The active session handles.
-     * @throws {Error} when the LiveKit provider is not configured/registered or the session factory is unbound.
+     * @throws {Error} when the LiveKit provider is not configured/registered, the session factory is unbound or fails,
+     *   the bot token can't be minted, or the bridge doesn't start.
      */
     StartAgentRoomSession(params: StartAgentRoomSessionParams): Promise<AgentRoomSession>;
+    /**
+     * Whether the agent behind this model session watches the meeting: its setting is on (through the bound
+     * {@link AgentVisionResolver}) AND its session takes inbound video. Watching on an audio-only model would offer people
+     * a choice no frame could honour, so it is logged and treated as off.
+     */
+    private agentWatches;
+    /**
+     * Whether this host's bots can publish an agent's avatar, from the native room module the bots join with (`ffmpeg`
+     * with the H.264 and AAC decoders, and a room SDK that publishes video). Asked before every agent's model session
+     * opens; the module probes once and remembers. A module that cannot be loaded, or that predates avatars, means no.
+     */
+    DescribeAvatarVideo(): Promise<NativeAvatarVideoSupport>;
+    /**
+     * What became of the agent's avatar request: the session's own status, except that a session which asked for an
+     * avatar and stayed audio only because this host could not publish it carries the host's reason (`decoder-missing`
+     * when there is no usable ffmpeg, `phone` on a phone call whose session factory still asked). Logged once per join when
+     * an avatar was asked for.
+     */
+    private avatarStatusFor;
+    /**
+     * Mints the bot's join token with its attributes: `mj.agentWatches` when the agent watches, so the room offers people
+     * the choice from the moment the bot joins, and `mj.agentAvatar` when the agent asked for an avatar. Minted once the
+     * model session is open; when it fails, the start closes that session (see {@link StartAgentRoomSession}).
+     */
+    private mintBotToken;
+    /**
+     * Closes the model session of a start that failed before the bridge engine took it: the bot's token could not be minted,
+     * or the bridge did not start (its row could not be saved, the driver could not connect). The failure is recorded on the
+     * session's co-agent run first ({@link FailedStartRecorder}), since the close alone would finalize that run as completed.
+     * Neither step throws: a failure is logged, so the caller sees why the start failed and the session is still closed.
+     */
+    private closeModelSessionOfFailedStart;
+    /** Installs the engine's turn-taking tool handler on the model session, when the session has one (a turn-based model in a room). */
+    private bindTurnTools;
+    /**
+     * Resolves whether the model with the given ID is full duplex from model metadata and static driver capabilities.
+     */
+    private resolveIsModelFullDuplexFromId;
     /** Appends an agent to a room's roster (creating the room's list on first join). */
     private addToRoster;
     /** Removes an agent from whatever room roster holds its bridge id; prunes the room when it empties. */
     private removeFromRoster;
-    /** The default native room-client wrapper specifier — the @livekit/rtc-node package this repo ships. */
-    private static readonly DEFAULT_NATIVE_MODULE;
     /**
-     * Resolves the native LiveKit room-client module specifier for the bridge session. Prefers the
-     * `LIVEKIT_NATIVE_MODULE` env override (e.g. a deployment's custom-sample-rate wrapper), else the default
-     * {@link DEFAULT_NATIVE_MODULE}. Overridable in tests via {@link SetNativeModuleSpecifier}.
+     * Resolves the native LiveKit room-client module specifier for the bridge session (see
+     * {@link ResolveLiveKitNativeModuleSpecifier}: the test override, else `LIVEKIT_NATIVE_MODULE`, else the default
+     * `@memberjunction/ai-bridge-livekit-native`). Overridable in tests via {@link SetNativeModuleSpecifier}.
      */
     private resolveNativeModuleSpecifier;
     /**
@@ -185,5 +381,16 @@ export declare class LiveKitAgentRoomCoordinator extends BaseSingleton<LiveKitAg
      * @returns The number of agent sessions asked to stop (0 when the room held no agents).
      */
     StopAllAgentsInRoom(roomName: string, reason?: BridgeDisconnectReason, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<number>;
+    /**
+     * Looks up the room name associated with a session bridge ID if present in the coordinator's active rosters.
+     *
+     * @param sessionBridgeID The `MJ: AI Agent Session Bridges` row id.
+     * @returns The room name, or `undefined` if not tracked in the active rosters.
+     */
+    GetRoomForBridge(sessionBridgeID: string): string | undefined;
+    /**
+     * Returns the agent sessions currently active in the given room.
+     */
+    GetAgentsInRoom(roomName: string): ReadonlyArray<RoomAgentEntry>;
 }
 //# sourceMappingURL=livekit-agent-room-coordinator.d.ts.map

package/dist/livekit-agent-room-coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"livekit-agent-room-coordinator.d.ts","sourceRoot":"","sources":["../src/livekit-agent-room-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAuB,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAiD,KAAK,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACjJ,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,yGAAyG;AACzG,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,uBAAuB,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,6BAA6B,CAAC,CAAC;AAE9J,2GAA2G;AAC3G,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D,0FAA0F;AAC1F,MAAM,WAAW,2BAA2B;IAC1C,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC,mGAAmG;IACnG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,2BAA2B,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAErG,gFAAgF;AAChF,MAAM,WAAW,2BAA2B;IAC1C,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0GAA0G;IAC1G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,oCAAoC;IACpC,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAYD,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,SAAQ,aAAa,CAAC,2BAA2B,CAAC;IACzF,OAAO,CAAC,YAAY,CAAkD;IAEtE;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,cAAc,CAMpB;IAEF,sDAAsD;IACtD,SAAS;IAIT,6CAA6C;IAC7C,WAAkB,QAAQ,IAAI,2BAA2B,CAExD;IAED;;;;OAIG;IACI,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAI/D;;;;OAIG;IACI,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAI1D;;;;;OAKG;IACI,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAIzC;;;;;;;OAOG;IACU,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkGlG,oFAAoF;IACpF,OAAO,CAAC,WAAW;IASnB,uGAAuG;IACvG,OAAO,CAAC,gBAAgB;IAexB,wGAAwG;IACxG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAA8C;IAE3F;;;;OAIG;IACH,OAAO,CAAC,4BAA4B;IAQpC;;;;;OAKG;IACI,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIpE,2GAA2G;IAC3G,OAAO,CAAC,6BAA6B,CAAC,CAAS;IAE/C;;;;;;;OAOG;IACU,oBAAoB,CAC/B,eAAe,EAAE,MAAM,EACvB,MAAM,GAAE,sBAAmC,EAC3C,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,OAAO,CAAC;IAanB;;;;;;;;;;;OAWG;IACU,mBAAmB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,sBAAmC,EAC3C,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,CAAC;CAOnB"}
+{"version":3,"file":"livekit-agent-room-coordinator.d.ts","sourceRoot":"","sources":["../src/livekit-agent-room-coordinator.ts"],"names":[],"mappings":"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"}