@memberjunction/ai-bridge-livekit 0.0.1 → 5.42.0

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":"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"}