@memberjunction/ai-bridge-livekit 5.41.0 → 5.42.0

package/README.md

@@ -80,11 +80,20 @@ export interface ILiveKitRoomSdk {
 }
 ```
 
-**Production binding (TODO at deployment):** bind this to `livekit-server-sdk` (token minting / room
-admin) plus a room client (the Node WebRTC participant, e.g. `@livekit/rtc-node`). The adapter is thin
-and the driver/tests do not change. None of the SDK types leak into this package. Until a real factory is
-bound via `LiveKitBridge.SetSdkFactory(...)`, `Connect` throws an explicit "bind the real LiveKit SDK"
-error.
+**Native binding:** this package ships **`LiveKitNativeMeetingSdk`** (`livekit-native-sdk.ts`) — the
+two-way adapter over the LiveKit room client, activated with `bridge.SetSdkFactory(BindLiveKitNative())`
+(auto-bound by the engine as the registered default for `DriverClass = 'LiveKitBridge'`). It's the MJ-side
+adapter, unit-tested against a fake module; none of the SDK types leak into this package.
+
+**The real room client now ships too:** [`@memberjunction/ai-bridge-livekit-native`](../LiveKitNative)
+wraps `@livekit/rtc-node` behind this adapter's `NativeRoomModule` contract. The LiveKit coordinator points
+`NativeModuleSpecifier` at it by default (overridable via the `LIVEKIT_NATIVE_MODULE` env), so a deployment
+just needs to `npm install @livekit/rtc-node` on the agent host. Until a module is configured, `connect`
+throws an explicit "load the native LiveKit module" error.
+
+LiveKit is the recommended **internal proving ground** (pair with the `mj-livekit-room` Explorer tab or the
+LiveKit Agents Playground) — see
+[`plans/realtime/native-bridge-buildout-plan.md`](../../../../plans/realtime/native-bridge-buildout-plan.md) §6.
 
 ## Echo / self-audio
 

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export * from './livekit-sdk.js';
+export * from './livekit-native-sdk.js';
 export * from './livekit-meeting-controls.js';
 export * from './livekit-bridge.js';
+export * from './register-native.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,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,8 +1,13 @@
 export * from './livekit-sdk.js';
+export * from './livekit-native-sdk.js';
 export * from './livekit-meeting-controls.js';
 export * from './livekit-bridge.js';
+export * from './register-native.js';
 import { LoadLiveKitBridge } from './livekit-bridge.js';
+import { RegisterLiveKitNativeSdk } from './register-native.js';
 // Static reference so bundlers cannot tree-shake the @RegisterClass(BaseRealtimeBridge, 'LiveKitBridge')
 // registration. Calling the no-op here keeps the driver resolvable by the engine's ClassFactory.
 LoadLiveKitBridge();
+// Register LiveKit's native two-way SDK binding so the engine auto-binds it at StartBridgeSession.
+RegisterLiveKitNativeSdk();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,yGAAyG;AACzG,iGAAiG;AACjG,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,yGAAyG;AACzG,iGAAiG;AACjG,iBAAiB,EAAE,CAAC;AACpB,mGAAmG;AACnG,wBAAwB,EAAE,CAAC"}

package/dist/livekit-bridge.d.ts

@@ -91,6 +91,8 @@ export declare class LiveKitBridge extends BaseRealtimeBridge {
      * @param track The outbound track the frame targets.
      * @param frame The media frame to send.
      */
+    /** Flushes the agent's queued outbound voice on barge-in (the user interrupted the agent). */
+    FlushOutboundMedia(): void;
     SendMedia(track: BridgeMediaTrackKind, frame: BridgeMediaFrame): void;
     /**
      * Registers the inbound-media handler. The driver forwards each raw per-participant audio frame

package/dist/livekit-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"livekit-bridge.d.ts","sourceRoot":"","sources":["../src/livekit-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EACH,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EAErB,qBAAqB,EACrB,iCAAiC,EACpC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEH,qBAAqB,EAKxB,MAAM,eAAe,CAAC;AAGvB;;;GAGG;AACH,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AA8B3D;;;;;;;;;GASG;AACH,qBACa,aAAc,SAAQ,kBAAkB;IACjD,8EAA8E;IAC9E,OAAO,CAAC,GAAG,CAAgC;IAE3C,sFAAsF;IACtF,OAAO,CAAC,WAAW,CAAuB;IAE1C,sGAAsG;IACtG,OAAO,CAAC,YAAY,CAAC,CAAoC;IAEzD,4EAA4E;IAC5E,OAAO,CAAC,kBAAkB,CAAC,CAAkD;IAE7E,+FAA+F;IAC/F,OAAO,CAAC,eAAe,CAAkD;IAEzE;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAKhB;IAEF;;;;;;OAMG;IACI,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAM1D;;;;;;;;;OASG;IACU,OAAO,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA2B9E;;;;OAIG;IACU,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvE;;;;;;;OAOG;IACI,SAAS,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IA4B5E;;;;;OAKG;IACI,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAMhE;;;;;;;OAOG;IACmB,eAAe,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IASzE;;;;;;OAMG;IACa,mBAAmB,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,qBAAqB,EAAE,KAAK,IAAI,GAAG,IAAI;IAKnG;;;;OAIG;IACa,6BAA6B,IAAI,iCAAiC,GAAG,IAAI;IAMzF;;;;;;OAMG;IACU,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzD,4FAA4F;IAC5F,IAAW,WAAW,IAAI,MAAM,GAAG,IAAI,CAEtC;IAID;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAKlB,gHAAgH;YAClG,aAAa;IAU3B,4GAA4G;IAC5G,OAAO,CAAC,sBAAsB;IAK9B,wGAAwG;IACxG,OAAO,CAAC,gBAAgB;IASxB,mFAAmF;IACnF,OAAO,CAAC,QAAQ;IAUhB,+FAA+F;IAC/F,OAAO,CAAC,YAAY;CAcvB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"livekit-bridge.d.ts","sourceRoot":"","sources":["../src/livekit-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EACH,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EAErB,qBAAqB,EACrB,iCAAiC,EACpC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEH,qBAAqB,EAKxB,MAAM,eAAe,CAAC;AAGvB;;;GAGG;AACH,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AA0C3D;;;;;;;;;GASG;AACH,qBACa,aAAc,SAAQ,kBAAkB;IACjD,8EAA8E;IAC9E,OAAO,CAAC,GAAG,CAAgC;IAE3C,sFAAsF;IACtF,OAAO,CAAC,WAAW,CAAuB;IAE1C,sGAAsG;IACtG,OAAO,CAAC,YAAY,CAAC,CAAoC;IAEzD,4EAA4E;IAC5E,OAAO,CAAC,kBAAkB,CAAC,CAAkD;IAE7E,+FAA+F;IAC/F,OAAO,CAAC,eAAe,CAAkD;IAEzE;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAKhB;IAEF;;;;;;OAMG;IACI,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAM1D;;;;;;;;;OASG;IACU,OAAO,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA2B9E;;;;OAIG;IACU,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvE;;;;;;;OAOG;IACH,8FAA8F;IAC9E,kBAAkB,IAAI,IAAI;IAInC,SAAS,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IA4B5E;;;;;OAKG;IACI,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAMhE;;;;;;;OAOG;IACmB,eAAe,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IASzE;;;;;;OAMG;IACa,mBAAmB,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,qBAAqB,EAAE,KAAK,IAAI,GAAG,IAAI;IAKnG;;;;OAIG;IACa,6BAA6B,IAAI,iCAAiC,GAAG,IAAI;IAMzF;;;;;;OAMG;IACU,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzD,4FAA4F;IAC5F,IAAW,WAAW,IAAI,MAAM,GAAG,IAAI,CAEtC;IAID;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAKlB,gHAAgH;YAClG,aAAa;IAU3B,4GAA4G;IAC5G,OAAO,CAAC,sBAAsB;IAK9B,wGAAwG;IACxG,OAAO,CAAC,gBAAgB;IASxB,mFAAmF;IACnF,OAAO,CAAC,QAAQ;IAUhB,+FAA+F;IAC/F,OAAO,CAAC,YAAY;CAcvB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/livekit-bridge.js

@@ -56,13 +56,24 @@ function mapParticipantRole(role, isLocal) {
             return 'Participant';
     }
 }
+/**
+ * The bot-identity convention the LiveKit room coordinator mints (`agent-<agentSessionId>`). A bridge only
+ * knows its OWN bot via `IsLocal`; OTHER agents in a multi-agent room are REMOTE participants, so they must
+ * be recognized by this identity prefix. Without it every other agent reads as a human — breaking
+ * turn-taking's agent-exclusion (an agent treats another agent's speech as being addressed) AND the
+ * "are any humans still present?" occupancy check the engine uses to auto-leave an empty room.
+ */
+function isAgentParticipantIdentity(identity) {
+    return typeof identity === 'string' && identity.toLowerCase().startsWith('agent-');
+}
 /** Maps a LiveKit participant onto the bridge's {@link BridgeParticipantInfo}. */
 function toBridgeParticipant(p) {
     return {
         ExternalId: p.Identity,
         DisplayName: p.DisplayName,
         Role: mapParticipantRole(p.Role, p.IsLocal),
-        IsAgent: p.IsLocal === true,
+        // The local bot OR any remote agent bot (by identity convention) counts as an agent, not a human.
+        IsAgent: p.IsLocal === true || isAgentParticipantIdentity(p.Identity),
     };
 }
 /**
@@ -165,6 +176,10 @@ let LiveKitBridge = class LiveKitBridge extends BaseRealtimeBridge {
      * @param track The outbound track the frame targets.
      * @param frame The media frame to send.
      */
+    /** Flushes the agent's queued outbound voice on barge-in (the user interrupted the agent). */
+    FlushOutboundMedia() {
+        this.sdk?.flushOutboundAudio();
+    }
     SendMedia(track, frame) {
         if (!this.sdk) {
             return; // not connected — drop

package/dist/livekit-bridge.js.map

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

package/dist/livekit-native-sdk.d.ts

@@ -0,0 +1,302 @@
+/**
+ * @fileoverview `LiveKitNativeMeetingSdk` — a **real, two-way** {@link ILiveKitRoomSdk} binding over the
+ * **native LiveKit server/agents SDK** (the Node room-participant build: `livekit-server-sdk` for token
+ * minting + admin, plus a room client such as `@livekit/rtc-node` that publishes/subscribes media). It
+ * gives the agent both **hearing** (each remote participant's subscribed audio track → a diarized
+ * {@link LiveKitAudioFrame}) and a **voice** ({@link publishAudioFrame} forwards the agent's synthesized
+ * PCM onto the bot's published audio track), plus full video/screen publish and the data-channel "chat".
+ *
+ * ## Why a native binding
+ * Publishing audio *into* a LiveKit room requires a real WebRTC participant — there is no receive-only
+ * shortcut as there is for some 3rd-party platforms. The native LiveKit room client exposes a
+ * publish-track **send** path alongside per-participant subscribed-track **receive** callbacks, so a
+ * single binding carries **bidirectional** media. This is the binding a two-way "agent talks in the
+ * room" deployment uses.
+ *
+ * ## The native module seam (no SDK types leak)
+ * The real LiveKit Node SDK is loaded **lazily** behind an injectable {@link NativeModuleLoader}, so this
+ * package builds and unit-tests with **no SDK installed and no network**. The adapter depends ONLY on the
+ * small structural {@link NativeRoomModule} / {@link NativeRoomClient} surface declared below — none of
+ * LiveKit's real types leak into the package. Tests inject a fake module; production points
+ * {@link LiveKitNativeSdkConfig.NativeModuleSpecifier} at the real room-client wrapper.
+ *
+ * ## Auth (deployment responsibility)
+ * The bot joins with a signed LiveKit **access token** (room name + grants) minted upstream by MJ's
+ * token/credential layer from the API **key/secret**. The ws URL + key/secret resolve **upstream** (MJ
+ * credential system / provider `Configuration`) and are **never inlined** at a call site. When a
+ * pre-signed token is supplied via {@link LiveKitConnectArgs.AccessToken} the adapter forwards it; when a
+ * deployment lets the native module mint the token, the resolved key/secret + ws URL are handed to
+ * {@link NativeRoomModule.createRoomClient}.
+ *
+ * Every spot where the native module's exact surface is assumed carries a `// VERIFY against the native
+ * LiveKit Node SDK wrapper` note so a live test can confirm it.
+ *
+ * @module @memberjunction/ai-bridge-livekit
+ * @author MemberJunction.com
+ */
+import { ILiveKitRoomSdk, LiveKitAudioFrame, LiveKitConnectArgs, LiveKitConnectResult, LiveKitParticipant, LiveKitParticipantRole } from './livekit-sdk.js';
+/** One subscribed per-participant audio frame the native room client surfaces (inbound hearing + diarization). */
+export interface NativeRoomAudioFrame {
+    /** Raw PCM bytes for this frame (`Uint8Array` view or standalone `ArrayBuffer`). */
+    data: Uint8Array | ArrayBuffer;
+    /** The LiveKit participant identity that produced the audio (the diarization speaker label). */
+    participantIdentity: string;
+    /** The participant's display name at capture time, when the client provides it. */
+    name?: string;
+    /** Optional epoch-ms capture timestamp. */
+    timestampMs?: number;
+}
+/** One participant as the native room client reports it. Mapped onto {@link LiveKitParticipant}. */
+export interface NativeRoomParticipant {
+    /** The native participant identity (stable, application-assigned). */
+    identity: string;
+    /** The participant's display name (LiveKit's `name` attribute). */
+    name?: string;
+    /** The participant's role as the client/metadata reports it (`host` / `cohost` / `participant`). */
+    role?: string;
+    /** Whether this participant is the bot itself (LiveKit's local participant). */
+    isLocal?: boolean;
+}
+/** The arguments the native room client's `connect()` accepts. Mirrors {@link LiveKitConnectArgs}. */
+export interface NativeConnectArgs {
+    /** The LiveKit room server ws URL (e.g. `wss://livekit.myorg.com`). Resolved upstream. */
+    url: string;
+    /** The signed LiveKit access token authorizing the bot to join (resolved upstream; never inline). */
+    token: string;
+    /** The bot's display name in the participant list. */
+    name: string;
+}
+/** What the native room client's `connect()` resolves to. */
+export interface NativeConnectResult {
+    /** The bot's own participant identity in the joined room. */
+    localIdentity: string;
+    /** The LiveKit room name the bot joined. */
+    roomName: string;
+}
+/**
+ * The live native room client the module hands back. The surface mirrors {@link ILiveKitRoomSdk} but in
+ * the native SDK's own (lower-cased) vocabulary; this adapter maps between the two. VERIFY against the
+ * native LiveKit Node SDK wrapper.
+ */
+export interface NativeRoomClient {
+    /** Connects to the room (async — the native connect handshake is network-bound). */
+    connect(args: NativeConnectArgs): Promise<NativeConnectResult>;
+    /** Disconnects from the room and releases native resources. */
+    disconnect(): Promise<void>;
+    /** Publishes one raw PCM frame on the bot's audio track (the agent's voice). */
+    publishAudio(pcm: ArrayBuffer): void;
+    /** Drops all pending/queued outbound audio — flushes the agent's voice on barge-in. */
+    flushOutbound(): void;
+    /** Publishes one raw frame on the bot's camera/video track. */
+    publishVideo(frame: ArrayBuffer): void;
+    /** Publishes one raw frame on the bot's screen-share track. */
+    publishScreen(frame: ArrayBuffer): void;
+    /** Registers the inbound per-participant subscribed-audio callback. "Latest handler wins." */
+    onAudioFrame(cb: (frame: NativeRoomAudioFrame) => void): void;
+    /** Registers the participant-connected callback. */
+    onParticipantConnected(cb: (participant: NativeRoomParticipant) => void): void;
+    /** Registers the participant-disconnected callback (identity of the participant that left). */
+    onParticipantDisconnected(cb: (participantIdentity: string) => void): void;
+    /** Returns the current participant roster (including the bot). */
+    getParticipants(): Promise<NativeRoomParticipant[]>;
+    /** Publishes a reliable message on the room data channel (the room-native "chat"). */
+    publishData(text: string): Promise<void>;
+    /** Registers the room-disconnected callback (SFU closed / the bot was removed). */
+    onDisconnected(cb: () => void): void;
+}
+/** The native room module surface — a factory that constructs a {@link NativeRoomClient}. */
+export interface NativeRoomModule {
+    /**
+     * Constructs a native room client from resolved options (credentials already resolved upstream).
+     * VERIFY against the native LiveKit Node SDK wrapper (`createRoomClient` vs a `Room` constructor).
+     */
+    createRoomClient(options: NativeRoomClientOptions): NativeRoomClient;
+}
+/** Options passed to {@link NativeRoomModule.createRoomClient}. Credentials are resolved upstream. */
+export interface NativeRoomClientOptions {
+    /** The LiveKit room server ws URL (resolved upstream). */
+    Url?: string;
+    /** The LiveKit API key (resolved upstream; used to mint the join token when not pre-signed). */
+    ApiKey?: string;
+    /** The LiveKit API secret (resolved upstream). Used only to sign the join token. */
+    ApiSecret?: string;
+    /**
+     * PCM rate (Hz) the agent's model CONSUMES — the rate inbound room audio is resampled to. Default 24000
+     * (OpenAI); Gemini Live = 16000. A wrapper that ignores this stays on its constructed default.
+     */
+    InboundSampleRate?: number;
+    /** PCM rate (Hz) the agent's model EMITS — the bot's published voice-track rate. Default 24000. */
+    OutboundSampleRate?: number;
+}
+/**
+ * Resolved configuration for {@link LiveKitNativeMeetingSdk}. Credentials resolve **upstream** (MJ
+ * credential system / provider `Configuration`) — this object carries already-resolved values; **never
+ * inline secrets** at a call site.
+ */
+export interface LiveKitNativeSdkConfig {
+    /** The LiveKit room server ws URL (resolved upstream). */
+    Url?: string;
+    /** The LiveKit API key (resolved upstream). Used to mint the join token when not pre-signed. */
+    ApiKey?: string;
+    /** The LiveKit API secret (resolved upstream). Used only to sign the join token. */
+    ApiSecret?: string;
+    /** A pre-signed LiveKit access token, when the deployment mints it out-of-band instead of via key/secret. */
+    AccessToken?: string;
+    /** The bot's display name (defaults applied by the bridge when absent). */
+    BotDisplayName?: string;
+    /**
+     * The module specifier of the native LiveKit room-client wrapper to load (e.g. an internal wrapper
+     * package name or an absolute path to a sidecar entry). Required in production; tests inject a loader.
+     */
+    NativeModuleSpecifier?: string;
+    /**
+     * PCM rate (Hz) the agent's realtime model **consumes** — the rate inbound room audio is resampled to
+     * before reaching the model. Threaded from the model via the engine (`IRealtimeSession.InputSampleRate`).
+     * Default 24000 (OpenAI); Gemini Live = 16000. Mismatch = the agent never hears the user on the bridge.
+     */
+    InboundSampleRate?: number;
+    /** PCM rate (Hz) the agent's model **emits** — the bot's published voice track rate. Default 24000. */
+    OutboundSampleRate?: number;
+}
+/** Normalizes the native client's free-form role string onto the seam's {@link LiveKitParticipantRole}. */
+export declare function mapNativeRole(role?: string): LiveKitParticipantRole;
+/**
+ * **Pure mapping** of one native participant onto the seam's {@link LiveKitParticipant}. Isolated from the
+ * native client and from I/O so it is unit-tested directly.
+ */
+export declare function mapNativeParticipant(p: NativeRoomParticipant): LiveKitParticipant;
+/**
+ * Coerces a `Uint8Array` view or `ArrayBuffer` into a standalone `ArrayBuffer`, **copying** the exact
+ * window of a view (so the result never aliases a larger backing buffer). The LiveKit package has no
+ * pre-existing PCM-coercion helper to reuse, so this is defined here; it is the single such export.
+ */
+export declare function toArrayBuffer(data: Uint8Array | ArrayBuffer): ArrayBuffer;
+/**
+ * **Pure mapping** of one native inbound audio frame onto the seam's diarized {@link LiveKitAudioFrame}.
+ * Copies the PCM (see {@link toArrayBuffer}) and resolves the speaker label. Isolated for direct testing.
+ */
+export declare function mapNativeAudioFrame(frame: NativeRoomAudioFrame): LiveKitAudioFrame;
+/**
+ * The injectable loader for the native LiveKit room module — overridable so unit tests supply a fake
+ * module with no SDK and no network. Production leaves it as {@link defaultNativeLoader}, which lazily
+ * imports the configured {@link LiveKitNativeSdkConfig.NativeModuleSpecifier}.
+ */
+export type NativeModuleLoader = (specifier: string) => Promise<NativeRoomModule>;
+/**
+ * Lazily loads the native LiveKit room module at the given specifier (category: runtime plugin discovery
+ * from config — the wrapper path is deployment-supplied and not known at build time, hence the
+ * `@vite-ignore` on the dynamic import). Throws a precise, actionable error when it can't be loaded so a
+ * misconfigured deployment fails loudly, not silently.
+ *
+ * VERIFY against the native LiveKit Node SDK wrapper: the module's default/namespace interop + that it
+ * exposes `createRoomClient`.
+ */
+export declare const defaultNativeLoader: NativeModuleLoader;
+/**
+ * A **real, two-way** {@link ILiveKitRoomSdk} over the native LiveKit Node room SDK (publish + subscribe).
+ *
+ * Gives the agent both **hearing** (per-participant subscribed audio → diarized {@link LiveKitAudioFrame}s)
+ * and a **voice** ({@link publishAudioFrame} → the native publish path), plus working video/screen publish,
+ * the data-channel chat, and roster events. Construct via {@link BindLiveKitNative} (the factory the
+ * bridge's `SetSdkFactory` wants), not directly, so config resolution + the lazy loader wire consistently.
+ */
+export declare class LiveKitNativeMeetingSdk implements ILiveKitRoomSdk {
+    /** Resolved config (credentials + the native module specifier). */
+    private readonly config;
+    /** The native-module loader (overridable for tests). */
+    private readonly loadModule;
+    /** The live native room client once {@link connect} succeeds. */
+    private client;
+    /** The inbound per-participant audio handler registered by the bridge. */
+    private audioHandler?;
+    /** The participant-join handler. */
+    private joinHandler?;
+    /** The participant-leave handler. */
+    private leaveHandler?;
+    /** The room-disconnected handler. */
+    private disconnectedHandler?;
+    /**
+     * @param config Resolved credentials + the native module specifier.
+     * @param loadModule The native-module loader (defaults to the lazy specifier loader).
+     */
+    constructor(config: LiveKitNativeSdkConfig, loadModule?: NativeModuleLoader);
+    /**
+     * Loads the native module, constructs a room client, wires its callbacks, and connects to the room
+     * with the resolved access token. Brings BOTH hearing and the agent's voice online.
+     *
+     * @param args The bridge's connect args (room ws URL, signed access token, bot name).
+     * @returns The bot/room identifiers.
+     * @throws When the native module specifier is missing or the module can't be loaded.
+     */
+    connect(args: LiveKitConnectArgs): Promise<LiveKitConnectResult>;
+    /** Disconnects from the room and releases the native client. Tolerant of teardown errors. */
+    disconnect(): Promise<void>;
+    /**
+     * Publishes one raw PCM frame on the bot's audio track — **the agent's real voice into the room**, via
+     * the native publish path. No-ops (without throwing) before {@link connect} so an early model frame
+     * never crashes the session.
+     *
+     * @param pcm The PCM audio bytes to publish into the room.
+     */
+    publishAudioFrame(pcm: ArrayBuffer): void;
+    /** Flushes the agent's queued outbound audio (barge-in). No-ops before connect. */
+    flushOutboundAudio(): void;
+    /**
+     * Publishes one raw video frame on the bot's camera track via the native publish path. No-ops before
+     * {@link connect}.
+     *
+     * @param frame The video frame bytes to publish.
+     */
+    publishVideoFrame(frame: ArrayBuffer): void;
+    /**
+     * Publishes one raw screen-share frame on the bot's screen track via the native publish path. No-ops
+     * before {@link connect}.
+     *
+     * @param frame The screen frame bytes to publish.
+     */
+    publishScreenFrame(frame: ArrayBuffer): void;
+    /** Registers the inbound per-participant audio handler (the diarized hearing path). */
+    onAudioTrack(cb: (frame: LiveKitAudioFrame) => void): void;
+    /** Registers the participant-join handler. */
+    onParticipantJoin(cb: (participant: LiveKitParticipant) => void): void;
+    /** Registers the participant-leave handler. */
+    onParticipantLeave(cb: (participantIdentity: string) => void): void;
+    /** Returns the current roster from the native client, mapped to {@link LiveKitParticipant}. */
+    getParticipants(): Promise<LiveKitParticipant[]>;
+    /** Registers the room-disconnected handler. */
+    onDisconnected(cb: () => void): void;
+    /**
+     * Sends a reliable text message on the room data channel via the native client — the room-native
+     * "chat". No-ops (without throwing) before {@link connect}.
+     *
+     * @param text The data/chat message text.
+     */
+    sendDataMessage(text: string): Promise<void>;
+    /** Wires the native client's callbacks to this adapter's handlers, mapping native shapes to the seam. */
+    private wireClient;
+}
+/**
+ * Builds the {@link import('./livekit-sdk.js').LiveKitRoomSdkFactory}-shaped factory that constructs a
+ * {@link LiveKitNativeMeetingSdk} from the bridge's per-session `Configuration`. Pass the result to
+ * `LiveKitBridge.SetSdkFactory(...)` so a deployment activates **two-way native LiveKit media** without
+ * code changes to the driver.
+ *
+ * Reads the ws URL / API key/secret / pre-signed token + bot name + the native module specifier out of
+ * the config map the engine passes at connect (credentials resolved upstream — **never inline secrets**).
+ *
+ * @example
+ * // Where bridge drivers are configured (creds already resolved from the MJ credential system):
+ * bridge.SetSdkFactory(BindLiveKitNative());
+ *
+ * @param loadModule Optional native-module loader override (tests inject a fake; production omits it).
+ * @returns A factory `(config) => LiveKitNativeMeetingSdk`.
+ */
+export declare function BindLiveKitNative(loadModule?: NativeModuleLoader): (config?: Record<string, unknown>) => LiveKitNativeMeetingSdk;
+/**
+ * Extracts a {@link LiveKitNativeSdkConfig} from the engine's loosely-typed `Configuration` map without
+ * ever widening to `any`. Each field is read + type-checked individually so a malformed config yields a
+ * clean, partially-resolved object (and {@link LiveKitNativeMeetingSdk.connect} then throws a precise
+ * error if the required specifier is absent) rather than a half-typed blob.
+ */
+export declare function readNativeConfig(config?: Record<string, unknown>): LiveKitNativeSdkConfig;
+//# sourceMappingURL=livekit-native-sdk.d.ts.map

package/dist/livekit-native-sdk.d.ts.map

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

package/dist/livekit-native-sdk.js

@@ -0,0 +1,320 @@
+/**
+ * @fileoverview `LiveKitNativeMeetingSdk` — a **real, two-way** {@link ILiveKitRoomSdk} binding over the
+ * **native LiveKit server/agents SDK** (the Node room-participant build: `livekit-server-sdk` for token
+ * minting + admin, plus a room client such as `@livekit/rtc-node` that publishes/subscribes media). It
+ * gives the agent both **hearing** (each remote participant's subscribed audio track → a diarized
+ * {@link LiveKitAudioFrame}) and a **voice** ({@link publishAudioFrame} forwards the agent's synthesized
+ * PCM onto the bot's published audio track), plus full video/screen publish and the data-channel "chat".
+ *
+ * ## Why a native binding
+ * Publishing audio *into* a LiveKit room requires a real WebRTC participant — there is no receive-only
+ * shortcut as there is for some 3rd-party platforms. The native LiveKit room client exposes a
+ * publish-track **send** path alongside per-participant subscribed-track **receive** callbacks, so a
+ * single binding carries **bidirectional** media. This is the binding a two-way "agent talks in the
+ * room" deployment uses.
+ *
+ * ## The native module seam (no SDK types leak)
+ * The real LiveKit Node SDK is loaded **lazily** behind an injectable {@link NativeModuleLoader}, so this
+ * package builds and unit-tests with **no SDK installed and no network**. The adapter depends ONLY on the
+ * small structural {@link NativeRoomModule} / {@link NativeRoomClient} surface declared below — none of
+ * LiveKit's real types leak into the package. Tests inject a fake module; production points
+ * {@link LiveKitNativeSdkConfig.NativeModuleSpecifier} at the real room-client wrapper.
+ *
+ * ## Auth (deployment responsibility)
+ * The bot joins with a signed LiveKit **access token** (room name + grants) minted upstream by MJ's
+ * token/credential layer from the API **key/secret**. The ws URL + key/secret resolve **upstream** (MJ
+ * credential system / provider `Configuration`) and are **never inlined** at a call site. When a
+ * pre-signed token is supplied via {@link LiveKitConnectArgs.AccessToken} the adapter forwards it; when a
+ * deployment lets the native module mint the token, the resolved key/secret + ws URL are handed to
+ * {@link NativeRoomModule.createRoomClient}.
+ *
+ * Every spot where the native module's exact surface is assumed carries a `// VERIFY against the native
+ * LiveKit Node SDK wrapper` note so a live test can confirm it.
+ *
+ * @module @memberjunction/ai-bridge-livekit
+ * @author MemberJunction.com
+ */
+import { LogError } from '@memberjunction/core';
+/** Normalizes the native client's free-form role string onto the seam's {@link LiveKitParticipantRole}. */
+export function mapNativeRole(role) {
+    switch ((role ?? '').trim().toLowerCase()) {
+        case 'host':
+            return 'Host';
+        case 'cohost':
+        case 'co-host':
+            return 'CoHost';
+        default:
+            return 'Participant';
+    }
+}
+/**
+ * **Pure mapping** of one native participant onto the seam's {@link LiveKitParticipant}. Isolated from the
+ * native client and from I/O so it is unit-tested directly.
+ */
+export function mapNativeParticipant(p) {
+    return {
+        Identity: String(p.identity),
+        DisplayName: p.name,
+        Role: mapNativeRole(p.role),
+        IsLocal: p.isLocal,
+    };
+}
+/**
+ * Coerces a `Uint8Array` view or `ArrayBuffer` into a standalone `ArrayBuffer`, **copying** the exact
+ * window of a view (so the result never aliases a larger backing buffer). The LiveKit package has no
+ * pre-existing PCM-coercion helper to reuse, so this is defined here; it is the single such export.
+ */
+export function toArrayBuffer(data) {
+    if (data instanceof ArrayBuffer) {
+        return data;
+    }
+    const copy = new Uint8Array(data.byteLength);
+    copy.set(data);
+    return copy.buffer;
+}
+/**
+ * **Pure mapping** of one native inbound audio frame onto the seam's diarized {@link LiveKitAudioFrame}.
+ * Copies the PCM (see {@link toArrayBuffer}) and resolves the speaker label. Isolated for direct testing.
+ */
+export function mapNativeAudioFrame(frame) {
+    return {
+        Pcm: toArrayBuffer(frame.data),
+        ParticipantIdentity: String(frame.participantIdentity),
+        DisplayName: frame.name,
+        TimestampMs: typeof frame.timestampMs === 'number' ? frame.timestampMs : Date.now(),
+    };
+}
+/** Structural guard: a value is a {@link NativeRoomModule} when it exposes a `createRoomClient` function. */
+function isNativeModule(value) {
+    return (value != null &&
+        typeof value === 'object' &&
+        typeof value.createRoomClient === 'function');
+}
+/** Unwraps a `{ default }` interop wrapper (CJS-with-default), returning the inner value or the input. */
+function unwrapDefault(mod) {
+    if (mod && typeof mod === 'object' && 'default' in mod) {
+        const inner = mod.default;
+        if (isNativeModule(inner)) {
+            return inner;
+        }
+    }
+    return mod;
+}
+/**
+ * Lazily loads the native LiveKit room module at the given specifier (category: runtime plugin discovery
+ * from config — the wrapper path is deployment-supplied and not known at build time, hence the
+ * `@vite-ignore` on the dynamic import). Throws a precise, actionable error when it can't be loaded so a
+ * misconfigured deployment fails loudly, not silently.
+ *
+ * VERIFY against the native LiveKit Node SDK wrapper: the module's default/namespace interop + that it
+ * exposes `createRoomClient`.
+ */
+export const defaultNativeLoader = async (specifier) => {
+    try {
+        const mod = await import(/* @vite-ignore */ specifier);
+        const resolved = unwrapDefault(mod);
+        if (!isNativeModule(resolved)) {
+            throw new Error('resolved module has no createRoomClient() factory');
+        }
+        return resolved;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`LiveKitNativeMeetingSdk could not load the native LiveKit room module at '${specifier}'. Build/install ` +
+            'the native LiveKit Node room-client wrapper (livekit-server-sdk + a room client like @livekit/rtc-node) ' +
+            `and set LiveKitNativeSdkConfig.NativeModuleSpecifier to it. Underlying error: ${message}`);
+    }
+};
+/**
+ * A **real, two-way** {@link ILiveKitRoomSdk} over the native LiveKit Node room SDK (publish + subscribe).
+ *
+ * Gives the agent both **hearing** (per-participant subscribed audio → diarized {@link LiveKitAudioFrame}s)
+ * and a **voice** ({@link publishAudioFrame} → the native publish path), plus working video/screen publish,
+ * the data-channel chat, and roster events. Construct via {@link BindLiveKitNative} (the factory the
+ * bridge's `SetSdkFactory` wants), not directly, so config resolution + the lazy loader wire consistently.
+ */
+export class LiveKitNativeMeetingSdk {
+    /**
+     * @param config Resolved credentials + the native module specifier.
+     * @param loadModule The native-module loader (defaults to the lazy specifier loader).
+     */
+    constructor(config, loadModule = defaultNativeLoader) {
+        /** The live native room client once {@link connect} succeeds. */
+        this.client = null;
+        this.config = config;
+        this.loadModule = loadModule;
+    }
+    // ── ILiveKitRoomSdk — lifecycle ──────────────────────────────────────────────────
+    /**
+     * Loads the native module, constructs a room client, wires its callbacks, and connects to the room
+     * with the resolved access token. Brings BOTH hearing and the agent's voice online.
+     *
+     * @param args The bridge's connect args (room ws URL, signed access token, bot name).
+     * @returns The bot/room identifiers.
+     * @throws When the native module specifier is missing or the module can't be loaded.
+     */
+    async connect(args) {
+        const specifier = this.config.NativeModuleSpecifier;
+        if (!specifier) {
+            throw new Error('LiveKitNativeMeetingSdk.connect: no NativeModuleSpecifier configured. Set it to the native LiveKit ' +
+                'Node room-client wrapper in the session Configuration. See the README.');
+        }
+        const mod = await this.loadModule(specifier);
+        const client = mod.createRoomClient({
+            Url: args.RoomUrl || this.config.Url,
+            ApiKey: this.config.ApiKey,
+            ApiSecret: this.config.ApiSecret,
+            // The model's audio format (threaded from IRealtimeSession via the engine) — so inbound room
+            // audio is resampled to what the model consumes (OpenAI 24 kHz; Gemini Live 16 kHz).
+            InboundSampleRate: this.config.InboundSampleRate,
+            OutboundSampleRate: this.config.OutboundSampleRate,
+        });
+        this.wireClient(client);
+        const result = await client.connect({
+            url: args.RoomUrl || this.config.Url || '',
+            token: args.AccessToken || this.config.AccessToken || '',
+            name: args.BotDisplayName || this.config.BotDisplayName || 'AI Agent',
+        });
+        this.client = client;
+        return {
+            BotIdentity: String(result.localIdentity),
+            RoomName: result.roomName,
+        };
+    }
+    /** Disconnects from the room and releases the native client. Tolerant of teardown errors. */
+    async disconnect() {
+        const client = this.client;
+        this.client = null;
+        if (client) {
+            try {
+                await client.disconnect();
+            }
+            catch (err) {
+                LogError(`[LiveKitNativeMeetingSdk] disconnect() failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    // ── ILiveKitRoomSdk — two-way media (real) ───────────────────────────────────────
+    /**
+     * Publishes one raw PCM frame on the bot's audio track — **the agent's real voice into the room**, via
+     * the native publish path. No-ops (without throwing) before {@link connect} so an early model frame
+     * never crashes the session.
+     *
+     * @param pcm The PCM audio bytes to publish into the room.
+     */
+    publishAudioFrame(pcm) {
+        this.client?.publishAudio(pcm);
+    }
+    /** Flushes the agent's queued outbound audio (barge-in). No-ops before connect. */
+    flushOutboundAudio() {
+        this.client?.flushOutbound();
+    }
+    /**
+     * Publishes one raw video frame on the bot's camera track via the native publish path. No-ops before
+     * {@link connect}.
+     *
+     * @param frame The video frame bytes to publish.
+     */
+    publishVideoFrame(frame) {
+        this.client?.publishVideo(frame);
+    }
+    /**
+     * Publishes one raw screen-share frame on the bot's screen track via the native publish path. No-ops
+     * before {@link connect}.
+     *
+     * @param frame The screen frame bytes to publish.
+     */
+    publishScreenFrame(frame) {
+        this.client?.publishScreen(frame);
+    }
+    /** Registers the inbound per-participant audio handler (the diarized hearing path). */
+    onAudioTrack(cb) {
+        this.audioHandler = cb;
+    }
+    // ── ILiveKitRoomSdk — roster + signals ───────────────────────────────────────────
+    /** Registers the participant-join handler. */
+    onParticipantJoin(cb) {
+        this.joinHandler = cb;
+    }
+    /** Registers the participant-leave handler. */
+    onParticipantLeave(cb) {
+        this.leaveHandler = cb;
+    }
+    /** Returns the current roster from the native client, mapped to {@link LiveKitParticipant}. */
+    async getParticipants() {
+        if (!this.client) {
+            return [];
+        }
+        const natives = await this.client.getParticipants();
+        return natives.map(mapNativeParticipant);
+    }
+    /** Registers the room-disconnected handler. */
+    onDisconnected(cb) {
+        this.disconnectedHandler = cb;
+    }
+    // ── ILiveKitRoomSdk — data channel (real) ────────────────────────────────────────
+    /**
+     * Sends a reliable text message on the room data channel via the native client — the room-native
+     * "chat". No-ops (without throwing) before {@link connect}.
+     *
+     * @param text The data/chat message text.
+     */
+    async sendDataMessage(text) {
+        await this.client?.publishData(text);
+    }
+    // ── internals ────────────────────────────────────────────────────────────────────
+    /** Wires the native client's callbacks to this adapter's handlers, mapping native shapes to the seam. */
+    wireClient(client) {
+        client.onAudioFrame((frame) => this.audioHandler?.(mapNativeAudioFrame(frame)));
+        client.onParticipantConnected((p) => this.joinHandler?.(mapNativeParticipant(p)));
+        client.onParticipantDisconnected((id) => this.leaveHandler?.(String(id)));
+        client.onDisconnected(() => this.disconnectedHandler?.());
+    }
+}
+/**
+ * Builds the {@link import('./livekit-sdk.js').LiveKitRoomSdkFactory}-shaped factory that constructs a
+ * {@link LiveKitNativeMeetingSdk} from the bridge's per-session `Configuration`. Pass the result to
+ * `LiveKitBridge.SetSdkFactory(...)` so a deployment activates **two-way native LiveKit media** without
+ * code changes to the driver.
+ *
+ * Reads the ws URL / API key/secret / pre-signed token + bot name + the native module specifier out of
+ * the config map the engine passes at connect (credentials resolved upstream — **never inline secrets**).
+ *
+ * @example
+ * // Where bridge drivers are configured (creds already resolved from the MJ credential system):
+ * bridge.SetSdkFactory(BindLiveKitNative());
+ *
+ * @param loadModule Optional native-module loader override (tests inject a fake; production omits it).
+ * @returns A factory `(config) => LiveKitNativeMeetingSdk`.
+ */
+export function BindLiveKitNative(loadModule = defaultNativeLoader) {
+    return (config) => new LiveKitNativeMeetingSdk(readNativeConfig(config), loadModule);
+}
+/**
+ * Extracts a {@link LiveKitNativeSdkConfig} from the engine's loosely-typed `Configuration` map without
+ * ever widening to `any`. Each field is read + type-checked individually so a malformed config yields a
+ * clean, partially-resolved object (and {@link LiveKitNativeMeetingSdk.connect} then throws a precise
+ * error if the required specifier is absent) rather than a half-typed blob.
+ */
+export function readNativeConfig(config) {
+    const cfg = config ?? {};
+    return {
+        Url: readString(cfg.Url),
+        ApiKey: readString(cfg.ApiKey),
+        ApiSecret: readString(cfg.ApiSecret),
+        AccessToken: readString(cfg.AccessToken),
+        BotDisplayName: readString(cfg.BotDisplayName),
+        NativeModuleSpecifier: readString(cfg.NativeModuleSpecifier),
+        InboundSampleRate: readNumber(cfg.InboundSampleRate),
+        OutboundSampleRate: readNumber(cfg.OutboundSampleRate),
+    };
+}
+/** Reads a value as a non-empty string, or `undefined`. */
+function readString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/** Reads a positive finite number from a free-form config value, or `undefined`. */
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : undefined;
+}
+//# sourceMappingURL=livekit-native-sdk.js.map

package/dist/livekit-native-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"livekit-native-sdk.js","sourceRoot":"","sources":["../src/livekit-native-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAmJhD,2GAA2G;AAC3G,MAAM,UAAU,aAAa,CAAC,IAAa;IACvC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACxC,KAAK,MAAM;YACP,OAAO,MAAM,CAAC;QAClB,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACV,OAAO,QAAQ,CAAC;QACpB;YACI,OAAO,aAAa,CAAC;IAC7B,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,CAAwB;IACzD,OAAO;QACH,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC5B,WAAW,EAAE,CAAC,CAAC,IAAI;QACnB,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3B,OAAO,EAAE,CAAC,CAAC,OAAO;KACrB,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAA8B;IACxD,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACf,OAAO,IAAI,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA2B;IAC3D,OAAO;QACH,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;QAC9B,mBAAmB,EAAE,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC;QACtD,WAAW,EAAE,KAAK,CAAC,IAAI;QACvB,WAAW,EAAE,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;KACtF,CAAC;AACN,CAAC;AASD,6GAA6G;AAC7G,SAAS,cAAc,CAAC,KAAc;IAClC,OAAO,CACH,KAAK,IAAI,IAAI;QACb,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAQ,KAAwC,CAAC,gBAAgB,KAAK,UAAU,CACnF,CAAC;AACN,CAAC;AAED,0GAA0G;AAC1G,SAAS,aAAa,CAAC,GAAY;IAC/B,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;QACrD,MAAM,KAAK,GAAI,GAA4B,CAAC,OAAO,CAAC;QACpD,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAuB,KAAK,EAAE,SAAiB,EAA6B,EAAE;IAC1G,IAAI,CAAC;QACD,MAAM,GAAG,GAAY,MAAM,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CACX,6EAA6E,SAAS,mBAAmB;YACrG,0GAA0G;YAC1G,iFAAiF,OAAO,EAAE,CACjG,CAAC;IACN,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAuB;IAsBhC;;;OAGG;IACH,YAAY,MAA8B,EAAE,aAAiC,mBAAmB;QAnBhG,iEAAiE;QACzD,WAAM,GAA4B,IAAI,CAAC;QAmB3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,oFAAoF;IAEpF;;;;;;;OAOG;IACI,KAAK,CAAC,OAAO,CAAC,IAAwB;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACX,qGAAqG;gBACjG,wEAAwE,CAC/E,CAAC;QACN,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC;YAChC,GAAG,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG;YACpC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,6FAA6F;YAC7F,qFAAqF;YACrF,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB;YAChD,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,kBAAkB;SACrD,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAExB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;YAChC,GAAG,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE;YAC1C,KAAK,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE;YACxD,IAAI,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,UAAU;SACxE,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,OAAO;YACH,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;YACzC,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC5B,CAAC;IACN,CAAC;IAED,6FAA6F;IACtF,KAAK,CAAC,UAAU;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,MAAM,EAAE,CAAC;YACT,IAAI,CAAC;gBACD,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YAC9B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,QAAQ,CACJ,kDAAkD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACvG,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,oFAAoF;IAEpF;;;;;;OAMG;IACI,iBAAiB,CAAC,GAAgB;QACrC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,mFAAmF;IAC5E,kBAAkB;QACrB,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACI,iBAAiB,CAAC,KAAkB;QACvC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACI,kBAAkB,CAAC,KAAkB;QACxC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,uFAAuF;IAChF,YAAY,CAAC,EAAsC;QACtD,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,oFAAoF;IAEpF,8CAA8C;IACvC,iBAAiB,CAAC,EAA6C;QAClE,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED,+CAA+C;IACxC,kBAAkB,CAAC,EAAyC;QAC/D,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,+FAA+F;IACxF,KAAK,CAAC,eAAe;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QACpD,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC7C,CAAC;IAED,+CAA+C;IACxC,cAAc,CAAC,EAAc;QAChC,IAAI,CAAC,mBAAmB,GAAG,EAAE,CAAC;IAClC,CAAC;IAED,oFAAoF;IAEpF;;;;;OAKG;IACI,KAAK,CAAC,eAAe,CAAC,IAAY;QACrC,MAAM,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,oFAAoF;IAEpF,yGAAyG;IACjG,UAAU,CAAC,MAAwB;QACvC,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,MAAM,CAAC,yBAAyB,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;CACJ;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAC7B,aAAiC,mBAAmB;IAEpD,OAAO,CAAC,MAAgC,EAAE,EAAE,CAAC,IAAI,uBAAuB,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;AACnH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAgC;IAC7D,MAAM,GAAG,GAAG,MAAM,IAAI,EAAE,CAAC;IACzB,OAAO;QACH,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;QACxB,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;QAC9B,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;QACpC,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC;QACxC,cAAc,EAAE,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC;QAC9C,qBAAqB,EAAE,UAAU,CAAC,GAAG,CAAC,qBAAqB,CAAC;QAC5D,iBAAiB,EAAE,UAAU,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACpD,kBAAkB,EAAE,UAAU,CAAC,GAAG,CAAC,kBAAkB,CAAC;KACzD,CAAC;AACN,CAAC;AAED,2DAA2D;AAC3D,SAAS,UAAU,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,oFAAoF;AACpF,SAAS,UAAU,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAChG,CAAC"}

package/dist/livekit-sdk.d.ts

@@ -113,6 +113,11 @@ export interface ILiveKitRoomSdk {
      * @param pcm The PCM audio bytes to publish.
      */
     publishAudioFrame(pcm: ArrayBuffer): void;
+    /**
+     * Flushes all pending/queued outbound audio (the agent's voice). Called on barge-in so the agent
+     * stops talking immediately instead of draining already-buffered audio after the model is cut off.
+     */
+    flushOutboundAudio(): void;
     /**
      * Subscribes inbound per-participant audio frames (what the agent hears, carrying the speaker
      * identity for diarization). "Latest handler wins." The SFU never echoes the bot's own published

package/dist/livekit-sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"livekit-sdk.d.ts","sourceRoot":"","sources":["../src/livekit-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,0FAA0F;AAC1F,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,oGAAoG;IACpG,QAAQ,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oGAAoG;IACpG,IAAI,EAAE,sBAAsB,CAAC;IAC7B,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAC9B,0CAA0C;IAC1C,GAAG,EAAE,WAAW,CAAC;IACjB,6FAA6F;IAC7F,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,mGAAmG;AACnG,MAAM,WAAW,kBAAkB;IAC/B,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACjC,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjE,4DAA4D;IAC5D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;OAIG;IACH,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAE1C;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI,CAAC;IAE3D;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAE5C;;;;;OAKG;IACH,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAE7C;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;IAEvE;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAEpE;;;;OAIG;IACH,eAAe,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;;;OAKG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,eAAe,CAAC"}
+{"version":3,"file":"livekit-sdk.d.ts","sourceRoot":"","sources":["../src/livekit-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,0FAA0F;AAC1F,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,oGAAoG;IACpG,QAAQ,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oGAAoG;IACpG,IAAI,EAAE,sBAAsB,CAAC;IAC7B,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAC9B,0CAA0C;IAC1C,GAAG,EAAE,WAAW,CAAC;IACjB,6FAA6F;IAC7F,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,mGAAmG;AACnG,MAAM,WAAW,kBAAkB;IAC/B,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACjC,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjE,4DAA4D;IAC5D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;OAIG;IACH,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAE1C;;;OAGG;IACH,kBAAkB,IAAI,IAAI,CAAC;IAE3B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI,CAAC;IAE3D;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAE5C;;;;;OAKG;IACH,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAE7C;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;IAEvE;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAEpE;;;;OAIG;IACH,eAAe,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;;;OAKG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,eAAe,CAAC"}

package/dist/register-native.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Registers the LiveKit **native two-way** SDK binding into the {@link BridgeNativeSdkRegistry}
+ * so `AIBridgeEngine.StartBridgeSession` auto-binds it onto a resolved `LiveKitBridge` before connect — no
+ * per-deployment wiring needed. The typed downcast + `SetSdkFactory` stay confined here (where the concrete
+ * `LiveKitBridge` type is known), keeping the engine seam free of provider types.
+ *
+ * A host can still override per-session via `StartBridgeSessionParams.BindSdk` — e.g. to inject a fake in a
+ * test instead of the native two-way default.
+ *
+ * @module @memberjunction/ai-bridge-livekit
+ * @author MemberJunction.com
+ */
+/**
+ * Registers LiveKit's native two-way binding. Idempotent (latest-wins in the registry), and invoked from the
+ * package `index.ts` so merely importing `@memberjunction/ai-bridge-livekit` wires the default binding. Also
+ * exported as a tree-shake-safe no-op-returning function callers can reference to force-retain the module.
+ */
+export declare function RegisterLiveKitNativeSdk(): void;
+//# sourceMappingURL=register-native.d.ts.map

package/dist/register-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-native.d.ts","sourceRoot":"","sources":["../src/register-native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAO/C"}

package/dist/register-native.js

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Registers the LiveKit **native two-way** SDK binding into the {@link BridgeNativeSdkRegistry}
+ * so `AIBridgeEngine.StartBridgeSession` auto-binds it onto a resolved `LiveKitBridge` before connect — no
+ * per-deployment wiring needed. The typed downcast + `SetSdkFactory` stay confined here (where the concrete
+ * `LiveKitBridge` type is known), keeping the engine seam free of provider types.
+ *
+ * A host can still override per-session via `StartBridgeSessionParams.BindSdk` — e.g. to inject a fake in a
+ * test instead of the native two-way default.
+ *
+ * @module @memberjunction/ai-bridge-livekit
+ * @author MemberJunction.com
+ */
+import { BridgeNativeSdkRegistry } from '@memberjunction/ai-bridge-base';
+import { BindLiveKitNative } from './livekit-native-sdk.js';
+/** The `MJ: AI Bridge Providers.DriverClass` value the LiveKit provider row carries. */
+const LIVEKIT_DRIVER_CLASS = 'LiveKitBridge';
+/**
+ * Registers LiveKit's native two-way binding. Idempotent (latest-wins in the registry), and invoked from the
+ * package `index.ts` so merely importing `@memberjunction/ai-bridge-livekit` wires the default binding. Also
+ * exported as a tree-shake-safe no-op-returning function callers can reference to force-retain the module.
+ */
+export function RegisterLiveKitNativeSdk() {
+    BridgeNativeSdkRegistry.Instance.Register(LIVEKIT_DRIVER_CLASS, (driver) => {
+        // Safe downcast: the registry is keyed by DriverClass, so the engine only ever applies this to the
+        // LiveKitBridge it resolved for 'LiveKitBridge'. BindLiveKitNative() defaults to the lazy native
+        // loader, which reads NativeModuleSpecifier from the per-session Configuration.
+        driver.SetSdkFactory(BindLiveKitNative());
+    });
+}
+// Register on import (mirrors the LoadLiveKitBridge() tree-shake pattern in index.ts).
+RegisterLiveKitNativeSdk();
+//# sourceMappingURL=register-native.js.map

package/dist/register-native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-native.js","sourceRoot":"","sources":["../src/register-native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,uBAAuB,EAAsB,MAAM,gCAAgC,CAAC;AAE7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,wFAAwF;AACxF,MAAM,oBAAoB,GAAG,eAAe,CAAC;AAE7C;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACpC,uBAAuB,CAAC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC,MAA0B,EAAE,EAAE;QAC3F,mGAAmG;QACnG,iGAAiG;QACjG,gFAAgF;QAC/E,MAAwB,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACP,CAAC;AAED,uFAAuF;AACvF,wBAAwB,EAAE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/ai-bridge-livekit",
   "type": "module",
-  "version": "5.41.0",
+  "version": "5.42.0",
   "description": "MemberJunction: LiveKit Realtime Bridge driver — the MJ-native multi-party room. Unlike the other bridges (which connect OUT to a 3rd-party meeting platform), LiveKit is a SELF-HOSTED WebRTC SFU that MJ runs itself. Connects the realtime agent engine to a LiveKit room as a bot participant (audio/video/screen in+out, per-participant diarization, data-channel chat) via an injectable LiveKit room SDK seam, and contributes a Meeting Controls facilitator channel.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,10 +17,10 @@
   "author": "MemberJunction.com",
   "license": "ISC",
   "dependencies": {
-    "@memberjunction/core": "5.41.0",
-    "@memberjunction/global": "5.41.0",
-    "@memberjunction/core-entities": "5.41.0",
-    "@memberjunction/ai-bridge-base": "5.41.0"
+    "@memberjunction/core": "5.42.0",
+    "@memberjunction/global": "5.42.0",
+    "@memberjunction/core-entities": "5.42.0",
+    "@memberjunction/ai-bridge-base": "5.42.0"
   },
   "devDependencies": {
     "@types/node": "24.10.11",