@memberjunction/ai-bridge-webex 5.41.0 → 5.42.0

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export * from './webex-sdk.js';
 export * from './webex-meeting-controls.js';
 export * from './webex-bridge.js';
+export * from './webex-native-sdk.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,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,8 +1,13 @@
 export * from './webex-sdk.js';
 export * from './webex-meeting-controls.js';
 export * from './webex-bridge.js';
+export * from './webex-native-sdk.js';
+export * from './register-native.js';
 import { LoadWebexBridge } from './webex-bridge.js';
+import { RegisterWebexNativeSdk } from './register-native.js';
 // Static reference so bundlers cannot tree-shake the @RegisterClass(BaseRealtimeBridge, 'WebexBridge')
 // registration. Calling the no-op here keeps the driver resolvable by the engine's ClassFactory.
 LoadWebexBridge();
+// Register Webex's native two-way SDK binding so the engine auto-binds it at StartBridgeSession.
+RegisterWebexNativeSdk();
 //# 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,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,uGAAuG;AACvG,iGAAiG;AACjG,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,uGAAuG;AACvG,iGAAiG;AACjG,eAAe,EAAE,CAAC;AAClB,iGAAiG;AACjG,sBAAsB,EAAE,CAAC"}

package/dist/register-native.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Registers the Webex **native two-way** SDK binding into the {@link BridgeNativeSdkRegistry}
+ * so `AIBridgeEngine.StartBridgeSession` auto-binds it onto a resolved `WebexBridge` before connect — no
+ * per-deployment wiring needed. The typed downcast + `SetSdkFactory` stay confined here (where the concrete
+ * `WebexBridge` type is known), keeping the engine seam free of provider types.
+ *
+ * A host can still override per-session via `StartBridgeSessionParams.BindSdk`.
+ *
+ * @module @memberjunction/ai-bridge-webex
+ * @author MemberJunction.com
+ */
+/**
+ * Registers Webex's native two-way binding. Idempotent (latest-wins in the registry), and invoked from the
+ * package `index.ts` so merely importing `@memberjunction/ai-bridge-webex` 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 RegisterWebexNativeSdk(): 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;;;;;;;;;;GAUG;AASH;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAO7C"}

package/dist/register-native.js

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Registers the Webex **native two-way** SDK binding into the {@link BridgeNativeSdkRegistry}
+ * so `AIBridgeEngine.StartBridgeSession` auto-binds it onto a resolved `WebexBridge` before connect — no
+ * per-deployment wiring needed. The typed downcast + `SetSdkFactory` stay confined here (where the concrete
+ * `WebexBridge` type is known), keeping the engine seam free of provider types.
+ *
+ * A host can still override per-session via `StartBridgeSessionParams.BindSdk`.
+ *
+ * @module @memberjunction/ai-bridge-webex
+ * @author MemberJunction.com
+ */
+import { BridgeNativeSdkRegistry } from '@memberjunction/ai-bridge-base';
+import { BindWebexNative } from './webex-native-sdk.js';
+/** The `MJ: AI Bridge Providers.DriverClass` value the Webex provider row carries. */
+const WEBEX_DRIVER_CLASS = 'WebexBridge';
+/**
+ * Registers Webex's native two-way binding. Idempotent (latest-wins in the registry), and invoked from the
+ * package `index.ts` so merely importing `@memberjunction/ai-bridge-webex` 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 RegisterWebexNativeSdk() {
+    BridgeNativeSdkRegistry.Instance.Register(WEBEX_DRIVER_CLASS, (driver) => {
+        // Safe downcast: the registry is keyed by DriverClass, so the engine only ever applies this to the
+        // WebexBridge it resolved for 'WebexBridge'. BindWebexNative() defaults to the lazy native loader,
+        // which reads NativeModuleSpecifier from the per-session Configuration.
+        driver.SetSdkFactory(BindWebexNative());
+    });
+}
+// Register on import (mirrors the LoadWebexBridge() tree-shake pattern in index.ts).
+RegisterWebexNativeSdk();
+//# 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;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,uBAAuB,EAAsB,MAAM,gCAAgC,CAAC;AAE7F,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,sFAAsF;AACtF,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IAClC,uBAAuB,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,MAA0B,EAAE,EAAE;QACzF,mGAAmG;QACnG,mGAAmG;QACnG,wEAAwE;QACvE,MAAsB,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACP,CAAC;AAED,qFAAqF;AACrF,sBAAsB,EAAE,CAAC"}

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

@@ -0,0 +1,283 @@
+/**
+ * @fileoverview `WebexNativeMeetingSdk` — a **real, two-way** {@link IWebexMeetingSdk} binding over a
+ * **native Cisco Webex media bot addon** (a headless meeting-bot build with the raw-media send + receive
+ * entitlement). Unlike a UI/embedded-app binding, this adapter gives the agent a **voice**:
+ * {@link sendAudioFrame} forwards the agent's synthesized PCM to the addon's outbound audio **send** path,
+ * and the host controls (chat / mute) actually act on the live meeting.
+ *
+ * ## Why a native binding
+ * Pushing audio *into* a Webex meeting as a server-side bot requires a media-capable bot runtime — the
+ * Webex Meetings SDK's raw audio media tracks (or an equivalent media-bot addon) expose an outbound audio
+ * **send** API alongside the per-member inbound raw-audio callback, so a single binding carries
+ * **bidirectional** audio. This is the binding a two-way "agent talks in the meeting" deployment uses.
+ *
+ * ## The native module seam (no SDK types leak)
+ * The native Webex media bot is delivered as an N-API addon or a local sidecar process exposing the small
+ * {@link NativeMeetingModule} surface declared below. This adapter depends ONLY on that structural surface
+ * — none of the Webex SDK's real types leak into the package, and the module is loaded **lazily** behind an
+ * injectable {@link NativeModuleLoader} so `@memberjunction/ai-bridge-webex` builds and unit-tests with
+ * **no addon and no network**. Tests inject a fake module; production points
+ * {@link WebexNativeSdkConfig.NativeModuleSpecifier} at the real addon.
+ *
+ * ## Entitlements + auth (deployment responsibility)
+ * The native bot joins with a Webex **bot/OAuth access token** (NOT inline) and needs the media-bot
+ * (raw audio send + receive) entitlement on the Webex org. Credentials resolve **upstream** (MJ credential
+ * system / provider `Configuration`) and are **never inlined**.
+ *
+ * Every spot where the native addon's exact surface is assumed carries a `// VERIFY against the native
+ * Webex media bot addon` note so a live test can confirm it.
+ *
+ * @module @memberjunction/ai-bridge-webex
+ * @author MemberJunction.com
+ */
+import { IWebexMeetingSdk, WebexAudioFrame, WebexJoinArgs, WebexJoinResult, WebexParticipant, WebexParticipantRole } from './webex-sdk.js';
+/** One raw per-member audio frame the native addon surfaces (inbound hearing + diarization). */
+export interface NativeAudioFrame {
+    /** Raw PCM bytes for this frame (`Uint8Array` view or standalone `ArrayBuffer`). */
+    data: Uint8Array | ArrayBuffer;
+    /** The Webex member id that produced the audio (the diarization speaker label). */
+    participantId: string | number;
+    /** The member's display name at capture time, when the addon provides it. */
+    displayName?: string;
+    /** Optional epoch-ms capture timestamp. */
+    timestampMs?: number;
+}
+/** One member as the native addon reports it. Mapped onto {@link WebexParticipant}. */
+export interface NativeParticipant {
+    /** The native member id. */
+    participantId: string | number;
+    /** The member's display name. */
+    displayName?: string;
+    /** The member's role as the addon reports it (`host` / `cohost` / `attendee`). */
+    role?: string;
+    /** Whether this member is the bot itself. */
+    isSelf?: boolean;
+}
+/** The arguments the native addon's `join()` accepts. Mirrors {@link WebexJoinArgs} plus raw-audio opts. */
+export interface NativeJoinArgs {
+    /** The Webex meeting link the bot joins (the durable join coordinate). */
+    meetingLink: string;
+    /** The parsed meeting number / SIP address, when resolved upstream. */
+    meetingNumber?: string;
+    /** The bot's display name in the participant list. */
+    displayName: string;
+    /** The Webex bot/OAuth access token authorizing the join (resolved upstream; never inline). */
+    accessToken?: string;
+    /** The Webex site (org) the meeting belongs to, when joining cross-site. */
+    siteUrl?: string;
+    /** Raw-audio sample rate the bot sends/receives (Hz), when the addon needs it told. */
+    sampleRate?: number;
+    /** Raw-audio channel count, when the addon needs it told. */
+    channels?: number;
+}
+/** What the native addon's `join()` resolves to. */
+export interface NativeJoinResult {
+    /** The bot's own member id in the joined meeting. */
+    botParticipantId: string | number;
+    /** The Webex meeting id the bot joined. */
+    meetingId: string;
+}
+/**
+ * The live native-meeting client the addon hands back. The surface closely mirrors {@link IWebexMeetingSdk}
+ * but in the addon's own (lower-cased) vocabulary; this adapter maps between the two. VERIFY against the
+ * native Webex media bot addon.
+ */
+export interface NativeMeetingClient {
+    /** Joins the meeting (async — the native join handshake is network-bound). */
+    join(args: NativeJoinArgs): Promise<NativeJoinResult>;
+    /** Leaves the meeting and releases native resources. */
+    leave(): Promise<void>;
+    /** Sends one raw PCM frame as the bot's outbound audio (the outbound media track — the agent's voice). */
+    sendAudioFrame(pcm: ArrayBuffer): void;
+    /** Registers the inbound per-member raw-audio callback. "Latest handler wins." */
+    onAudioFrame(cb: (frame: NativeAudioFrame) => void): void;
+    /** Registers the member-join callback. */
+    onParticipantJoin(cb: (participant: NativeParticipant) => void): void;
+    /** Registers the member-leave callback (id of the member that left). */
+    onParticipantLeave(cb: (participantId: string | number) => void): void;
+    /** Registers the native hand-raise/lower callback. */
+    onHandRaise(cb: (participantId: string | number, raised: boolean) => void): void;
+    /** Returns the current member roster (including the bot). */
+    getParticipants(): Promise<NativeParticipant[]>;
+    /** Posts a message to the meeting space chat (everyone). */
+    postChatMessage(text: string): Promise<void>;
+    /** Mutes a member (requires the bot be host/cohost). */
+    muteParticipant(participantId: string | number): Promise<void>;
+    /** Registers the meeting-ended callback. */
+    onMeetingEnded(cb: () => void): void;
+}
+/** The native addon module surface — a factory that constructs a {@link NativeMeetingClient}. */
+export interface NativeMeetingModule {
+    /**
+     * Constructs a native meeting client from resolved options (Webex credentials already resolved upstream).
+     * VERIFY against the native Webex media bot addon (`createClient` vs a `Client` constructor).
+     */
+    createClient(options: NativeClientOptions): NativeMeetingClient;
+}
+/** Options passed to {@link NativeMeetingModule.createClient}. Credentials are resolved upstream. */
+export interface NativeClientOptions {
+    /** The Webex bot/OAuth access token (resolved upstream). */
+    AccessToken?: string;
+    /** The Webex site (org) url, when joining cross-site (resolved upstream). */
+    SiteUrl?: string;
+}
+/**
+ * Resolved configuration for {@link WebexNativeMeetingSdk}. Credentials resolve **upstream** (MJ credential
+ * system / provider `Configuration`) — this object carries already-resolved values; **never inline
+ * secrets** at a call site.
+ */
+export interface WebexNativeSdkConfig {
+    /** The Webex bot/OAuth access token authorizing the bot's Meetings + Messaging calls (resolved upstream). */
+    AccessToken?: string;
+    /** The Webex site (org) the meeting belongs to, when joining cross-site (resolved upstream). */
+    SiteUrl?: string;
+    /** The bot's display name (defaults applied by the bridge when absent). */
+    BotDisplayName?: string;
+    /** Raw-audio sample rate (Hz) the bot sends/receives. */
+    SampleRate?: number;
+    /** Raw-audio channel count. */
+    Channels?: number;
+    /**
+     * The module specifier of the native Webex media bot addon/sidecar to load (e.g. an internal N-API addon
+     * package name or an absolute path to a sidecar entry). Required in production; tests inject a loader.
+     */
+    NativeModuleSpecifier?: string;
+}
+/**
+ * Coerces a `Uint8Array | ArrayBuffer` to a standalone `ArrayBuffer`, **copying** the exact byte window so
+ * the result never aliases a larger backing buffer (a view over a pooled buffer would otherwise expose
+ * neighboring bytes). Defined locally in this binding (the Webex seam carries raw `ArrayBuffer`s
+ * elsewhere), so it does not collide with any other export under `index.ts`'s `export *`.
+ */
+export declare function toArrayBuffer(data: Uint8Array | ArrayBuffer): ArrayBuffer;
+/** Normalizes the addon's free-form role string onto the bridge's {@link WebexParticipantRole}. */
+export declare function mapNativeRole(role?: string): WebexParticipantRole;
+/**
+ * **Pure mapping** of one native member onto the bridge's {@link WebexParticipant}. Isolated from the
+ * addon and from I/O so it is unit-tested directly.
+ */
+export declare function mapNativeParticipant(p: NativeParticipant): WebexParticipant;
+/**
+ * **Pure mapping** of one native inbound audio frame onto the bridge's diarized {@link WebexAudioFrame}.
+ * Copies the PCM (see {@link toArrayBuffer}) and resolves the speaker label. Isolated for direct testing.
+ */
+export declare function mapNativeAudioFrame(frame: NativeAudioFrame): WebexAudioFrame;
+/**
+ * The injectable loader for the native Webex media bot addon — overridable so unit tests supply a fake
+ * module with no addon and no network. Production leaves it as {@link defaultNativeLoader}, which lazily
+ * imports the configured {@link WebexNativeSdkConfig.NativeModuleSpecifier}.
+ */
+export type NativeModuleLoader = (specifier: string) => Promise<NativeMeetingModule>;
+/**
+ * Lazily loads the native Webex media bot addon at the given specifier (category: runtime plugin discovery
+ * from config — the addon path is deployment-supplied and not known at build time, so a static import is
+ * impossible). Throws a precise, actionable error when it can't be loaded so a misconfigured deployment
+ * fails loudly, not silently.
+ *
+ * VERIFY against the native Webex media bot addon: the module's default/namespace interop + that it
+ * exposes `createClient`.
+ */
+export declare const defaultNativeLoader: NativeModuleLoader;
+/**
+ * A **real, two-way** {@link IWebexMeetingSdk} over the native Webex media bot addon (raw-audio send + receive).
+ *
+ * Gives the agent both **hearing** (per-member inbound audio → diarized {@link WebexAudioFrame}s) and a
+ * **voice** ({@link sendAudioFrame} → the native outbound media track), plus working host controls
+ * (chat / mute) and roster/hand-raise events. Construct via {@link BindWebexNative} (the factory the
+ * bridge's `SetSdkFactory` wants), not directly, so config resolution + the lazy loader wire consistently.
+ */
+export declare class WebexNativeMeetingSdk implements IWebexMeetingSdk {
+    /** Resolved config (credentials + raw-audio + the native module specifier). */
+    private readonly config;
+    /** The native-addon module loader (overridable for tests). */
+    private readonly loadModule;
+    /** The live native client once {@link join} succeeds. */
+    private client;
+    /** The inbound per-member audio handler registered by the bridge. */
+    private audioHandler?;
+    /** The member-join handler. */
+    private joinHandler?;
+    /** The member-leave handler. */
+    private leaveHandler?;
+    /** The hand-raise handler. */
+    private handRaiseHandler?;
+    /** The meeting-ended handler. */
+    private endedHandler?;
+    /**
+     * @param config Resolved credentials + raw-audio opts + the native module specifier.
+     * @param loadModule The native-addon loader (defaults to the lazy specifier loader).
+     */
+    constructor(config: WebexNativeSdkConfig, loadModule?: NativeModuleLoader);
+    /**
+     * Loads the native addon, constructs a client, wires its callbacks, and joins the meeting with the
+     * resolved Webex access token. Brings BOTH hearing and the agent's voice online.
+     *
+     * @param args The bridge's join args (meeting link, meeting number, bot name, auth).
+     * @returns The bot/meeting identifiers.
+     * @throws When the native module specifier is missing or the addon can't be loaded.
+     */
+    join(args: WebexJoinArgs): Promise<WebexJoinResult>;
+    /** Leaves the meeting and releases the native client. Tolerant of teardown errors. */
+    leave(): Promise<void>;
+    /**
+     * Sends one raw PCM frame as the bot's outbound audio — **the agent's real voice into the meeting**,
+     * via the native outbound media track. No-ops (without throwing) before {@link join} so an early model
+     * frame never crashes the session.
+     *
+     * @param pcm The PCM audio bytes to speak into the meeting.
+     */
+    sendAudioFrame(pcm: ArrayBuffer): void;
+    /** Registers the inbound per-member audio handler (the diarized hearing path). */
+    onAudioFrame(cb: (frame: WebexAudioFrame) => void): void;
+    /** Registers the member-join handler. */
+    onParticipantJoin(cb: (participant: WebexParticipant) => void): void;
+    /** Registers the member-leave handler. */
+    onParticipantLeave(cb: (participantId: string) => void): void;
+    /** Registers the native hand-raise/lower handler. */
+    onHandRaise(cb: (participantId: string, raised: boolean) => void): void;
+    /** Returns the current roster from the native client, mapped to {@link WebexParticipant}. */
+    getParticipants(): Promise<WebexParticipant[]>;
+    /** Registers the meeting-ended handler. */
+    onMeetingEnded(cb: () => void): void;
+    /**
+     * Posts a message to the meeting space chat via the native client. No-ops (without throwing) before
+     * {@link join}.
+     *
+     * @param text The chat message text.
+     */
+    postChatMessage(text: string): Promise<void>;
+    /**
+     * Mutes a member via the native host control (requires the bot be host/cohost). No-ops (without
+     * throwing) before {@link join}.
+     *
+     * @param participantId The member to mute.
+     */
+    muteParticipant(participantId: 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('./webex-sdk.js').WebexMeetingSdkFactory}-shaped factory that constructs a
+ * {@link WebexNativeMeetingSdk} from the bridge's per-session `Configuration`. Pass the result to
+ * `WebexBridge.SetSdkFactory(...)` so a deployment activates **two-way native Webex audio** without code
+ * changes to the driver.
+ *
+ * Reads the access token / site + raw-audio opts + 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(BindWebexNative());
+ *
+ * @param loadModule Optional native-addon loader override (tests inject a fake; production omits it).
+ * @returns A factory `(config) => WebexNativeMeetingSdk`.
+ */
+export declare function BindWebexNative(loadModule?: NativeModuleLoader): (config?: Record<string, unknown>) => WebexNativeMeetingSdk;
+/**
+ * Extracts a {@link WebexNativeSdkConfig} 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 WebexNativeMeetingSdk.join} 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>): WebexNativeSdkConfig;
+//# sourceMappingURL=webex-native-sdk.d.ts.map

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

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

package/dist/webex-native-sdk.js

@@ -0,0 +1,305 @@
+/**
+ * @fileoverview `WebexNativeMeetingSdk` — a **real, two-way** {@link IWebexMeetingSdk} binding over a
+ * **native Cisco Webex media bot addon** (a headless meeting-bot build with the raw-media send + receive
+ * entitlement). Unlike a UI/embedded-app binding, this adapter gives the agent a **voice**:
+ * {@link sendAudioFrame} forwards the agent's synthesized PCM to the addon's outbound audio **send** path,
+ * and the host controls (chat / mute) actually act on the live meeting.
+ *
+ * ## Why a native binding
+ * Pushing audio *into* a Webex meeting as a server-side bot requires a media-capable bot runtime — the
+ * Webex Meetings SDK's raw audio media tracks (or an equivalent media-bot addon) expose an outbound audio
+ * **send** API alongside the per-member inbound raw-audio callback, so a single binding carries
+ * **bidirectional** audio. This is the binding a two-way "agent talks in the meeting" deployment uses.
+ *
+ * ## The native module seam (no SDK types leak)
+ * The native Webex media bot is delivered as an N-API addon or a local sidecar process exposing the small
+ * {@link NativeMeetingModule} surface declared below. This adapter depends ONLY on that structural surface
+ * — none of the Webex SDK's real types leak into the package, and the module is loaded **lazily** behind an
+ * injectable {@link NativeModuleLoader} so `@memberjunction/ai-bridge-webex` builds and unit-tests with
+ * **no addon and no network**. Tests inject a fake module; production points
+ * {@link WebexNativeSdkConfig.NativeModuleSpecifier} at the real addon.
+ *
+ * ## Entitlements + auth (deployment responsibility)
+ * The native bot joins with a Webex **bot/OAuth access token** (NOT inline) and needs the media-bot
+ * (raw audio send + receive) entitlement on the Webex org. Credentials resolve **upstream** (MJ credential
+ * system / provider `Configuration`) and are **never inlined**.
+ *
+ * Every spot where the native addon's exact surface is assumed carries a `// VERIFY against the native
+ * Webex media bot addon` note so a live test can confirm it.
+ *
+ * @module @memberjunction/ai-bridge-webex
+ * @author MemberJunction.com
+ */
+import { LogError } from '@memberjunction/core';
+/**
+ * Coerces a `Uint8Array | ArrayBuffer` to a standalone `ArrayBuffer`, **copying** the exact byte window so
+ * the result never aliases a larger backing buffer (a view over a pooled buffer would otherwise expose
+ * neighboring bytes). Defined locally in this binding (the Webex seam carries raw `ArrayBuffer`s
+ * elsewhere), so it does not collide with any other export under `index.ts`'s `export *`.
+ */
+export function toArrayBuffer(data) {
+    if (data instanceof ArrayBuffer) {
+        return data;
+    }
+    const copy = new Uint8Array(data.byteLength);
+    copy.set(data);
+    return copy.buffer;
+}
+/** Normalizes the addon's free-form role string onto the bridge's {@link WebexParticipantRole}. */
+export function mapNativeRole(role) {
+    switch ((role ?? '').trim().toLowerCase()) {
+        case 'host':
+            return 'Host';
+        case 'cohost':
+        case 'co-host':
+            return 'Cohost';
+        default:
+            return 'Attendee';
+    }
+}
+/**
+ * **Pure mapping** of one native member onto the bridge's {@link WebexParticipant}. Isolated from the
+ * addon and from I/O so it is unit-tested directly.
+ */
+export function mapNativeParticipant(p) {
+    return {
+        ParticipantId: String(p.participantId),
+        DisplayName: p.displayName,
+        Role: mapNativeRole(p.role),
+        IsSelf: p.isSelf,
+    };
+}
+/**
+ * **Pure mapping** of one native inbound audio frame onto the bridge's diarized {@link WebexAudioFrame}.
+ * Copies the PCM (see {@link toArrayBuffer}) and resolves the speaker label. Isolated for direct testing.
+ */
+export function mapNativeAudioFrame(frame) {
+    return {
+        Pcm: toArrayBuffer(frame.data),
+        ParticipantId: String(frame.participantId),
+        DisplayName: frame.displayName,
+        TimestampMs: typeof frame.timestampMs === 'number' ? frame.timestampMs : Date.now(),
+    };
+}
+/** Structural guard: a value is a {@link NativeMeetingModule} when it exposes a `createClient` function. */
+function isNativeModule(value) {
+    return (value != null &&
+        typeof value === 'object' &&
+        typeof value.createClient === '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 Webex media bot addon at the given specifier (category: runtime plugin discovery
+ * from config — the addon path is deployment-supplied and not known at build time, so a static import is
+ * impossible). Throws a precise, actionable error when it can't be loaded so a misconfigured deployment
+ * fails loudly, not silently.
+ *
+ * VERIFY against the native Webex media bot addon: the module's default/namespace interop + that it
+ * exposes `createClient`.
+ */
+export const defaultNativeLoader = async (specifier) => {
+    try {
+        // `/* @vite-ignore */`: the specifier is a deployment-supplied, runtime-resolved plugin path (not a
+        // build-time constant), so Vite/ESBuild must not try to analyze or pre-bundle it.
+        const mod = await import(/* @vite-ignore */ specifier);
+        const resolved = unwrapDefault(mod);
+        if (!isNativeModule(resolved)) {
+            throw new Error('resolved module has no createClient() factory');
+        }
+        return resolved;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`WebexNativeMeetingSdk could not load the native Webex media bot addon at '${specifier}'. Build/install ` +
+            'the native Webex media bot addon (the raw-audio send+receive build, media-bot entitled) and set ' +
+            `WebexNativeSdkConfig.NativeModuleSpecifier to it. Underlying error: ${message}`);
+    }
+};
+/**
+ * A **real, two-way** {@link IWebexMeetingSdk} over the native Webex media bot addon (raw-audio send + receive).
+ *
+ * Gives the agent both **hearing** (per-member inbound audio → diarized {@link WebexAudioFrame}s) and a
+ * **voice** ({@link sendAudioFrame} → the native outbound media track), plus working host controls
+ * (chat / mute) and roster/hand-raise events. Construct via {@link BindWebexNative} (the factory the
+ * bridge's `SetSdkFactory` wants), not directly, so config resolution + the lazy loader wire consistently.
+ */
+export class WebexNativeMeetingSdk {
+    /**
+     * @param config Resolved credentials + raw-audio opts + the native module specifier.
+     * @param loadModule The native-addon loader (defaults to the lazy specifier loader).
+     */
+    constructor(config, loadModule = defaultNativeLoader) {
+        /** The live native client once {@link join} succeeds. */
+        this.client = null;
+        this.config = config;
+        this.loadModule = loadModule;
+    }
+    // ── IWebexMeetingSdk — lifecycle ─────────────────────────────────────────────────
+    /**
+     * Loads the native addon, constructs a client, wires its callbacks, and joins the meeting with the
+     * resolved Webex access token. Brings BOTH hearing and the agent's voice online.
+     *
+     * @param args The bridge's join args (meeting link, meeting number, bot name, auth).
+     * @returns The bot/meeting identifiers.
+     * @throws When the native module specifier is missing or the addon can't be loaded.
+     */
+    async join(args) {
+        const specifier = this.config.NativeModuleSpecifier;
+        if (!specifier) {
+            throw new Error('WebexNativeMeetingSdk.join: no NativeModuleSpecifier configured. Set it to the native Webex ' +
+                'media bot addon (raw-audio send+receive build) in the session Configuration. See the README.');
+        }
+        const mod = await this.loadModule(specifier);
+        const client = mod.createClient({ AccessToken: this.config.AccessToken, SiteUrl: this.config.SiteUrl });
+        this.wireClient(client);
+        const result = await client.join({
+            meetingLink: args.MeetingLink,
+            meetingNumber: args.MeetingNumber,
+            displayName: args.BotDisplayName || this.config.BotDisplayName || 'AI Agent',
+            accessToken: args.AccessToken ?? this.config.AccessToken,
+            siteUrl: args.SiteUrl ?? this.config.SiteUrl,
+            sampleRate: this.config.SampleRate,
+            channels: this.config.Channels,
+        });
+        this.client = client;
+        return {
+            BotParticipantId: String(result.botParticipantId),
+            MeetingId: result.meetingId || args.MeetingNumber || args.MeetingLink,
+        };
+    }
+    /** Leaves the meeting and releases the native client. Tolerant of teardown errors. */
+    async leave() {
+        const client = this.client;
+        this.client = null;
+        if (client) {
+            try {
+                await client.leave();
+            }
+            catch (err) {
+                LogError(`[WebexNativeMeetingSdk] leave() failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    // ── IWebexMeetingSdk — two-way audio (real) ──────────────────────────────────────
+    /**
+     * Sends one raw PCM frame as the bot's outbound audio — **the agent's real voice into the meeting**,
+     * via the native outbound media track. No-ops (without throwing) before {@link join} so an early model
+     * frame never crashes the session.
+     *
+     * @param pcm The PCM audio bytes to speak into the meeting.
+     */
+    sendAudioFrame(pcm) {
+        this.client?.sendAudioFrame(pcm);
+    }
+    /** Registers the inbound per-member audio handler (the diarized hearing path). */
+    onAudioFrame(cb) {
+        this.audioHandler = cb;
+    }
+    // ── IWebexMeetingSdk — roster + signals ──────────────────────────────────────────
+    /** Registers the member-join handler. */
+    onParticipantJoin(cb) {
+        this.joinHandler = cb;
+    }
+    /** Registers the member-leave handler. */
+    onParticipantLeave(cb) {
+        this.leaveHandler = cb;
+    }
+    /** Registers the native hand-raise/lower handler. */
+    onHandRaise(cb) {
+        this.handRaiseHandler = cb;
+    }
+    /** Returns the current roster from the native client, mapped to {@link WebexParticipant}. */
+    async getParticipants() {
+        if (!this.client) {
+            return [];
+        }
+        const natives = await this.client.getParticipants();
+        return natives.map(mapNativeParticipant);
+    }
+    /** Registers the meeting-ended handler. */
+    onMeetingEnded(cb) {
+        this.endedHandler = cb;
+    }
+    // ── IWebexMeetingSdk — host controls (real) ──────────────────────────────────────
+    /**
+     * Posts a message to the meeting space chat via the native client. No-ops (without throwing) before
+     * {@link join}.
+     *
+     * @param text The chat message text.
+     */
+    async postChatMessage(text) {
+        await this.client?.postChatMessage(text);
+    }
+    /**
+     * Mutes a member via the native host control (requires the bot be host/cohost). No-ops (without
+     * throwing) before {@link join}.
+     *
+     * @param participantId The member to mute.
+     */
+    async muteParticipant(participantId) {
+        await this.client?.muteParticipant(participantId);
+    }
+    // ── 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.onParticipantJoin((p) => this.joinHandler?.(mapNativeParticipant(p)));
+        client.onParticipantLeave((id) => this.leaveHandler?.(String(id)));
+        client.onHandRaise((id, raised) => this.handRaiseHandler?.(String(id), raised));
+        client.onMeetingEnded(() => this.endedHandler?.());
+    }
+}
+/**
+ * Builds the {@link import('./webex-sdk.js').WebexMeetingSdkFactory}-shaped factory that constructs a
+ * {@link WebexNativeMeetingSdk} from the bridge's per-session `Configuration`. Pass the result to
+ * `WebexBridge.SetSdkFactory(...)` so a deployment activates **two-way native Webex audio** without code
+ * changes to the driver.
+ *
+ * Reads the access token / site + raw-audio opts + 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(BindWebexNative());
+ *
+ * @param loadModule Optional native-addon loader override (tests inject a fake; production omits it).
+ * @returns A factory `(config) => WebexNativeMeetingSdk`.
+ */
+export function BindWebexNative(loadModule = defaultNativeLoader) {
+    return (config) => new WebexNativeMeetingSdk(readNativeConfig(config), loadModule);
+}
+/**
+ * Extracts a {@link WebexNativeSdkConfig} 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 WebexNativeMeetingSdk.join} 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 {
+        AccessToken: readString(cfg.AccessToken),
+        SiteUrl: readString(cfg.SiteUrl),
+        BotDisplayName: readString(cfg.BotDisplayName),
+        SampleRate: readNumber(cfg.SampleRate),
+        Channels: readNumber(cfg.Channels),
+        NativeModuleSpecifier: readString(cfg.NativeModuleSpecifier),
+    };
+}
+/** Reads a value as a non-empty string, or `undefined`. */
+function readString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/** Reads a value as a finite number, or `undefined`. */
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+//# sourceMappingURL=webex-native-sdk.js.map

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

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/ai-bridge-webex",
   "type": "module",
-  "version": "5.41.0",
+  "version": "5.42.0",
   "description": "MemberJunction: Cisco Webex Realtime Bridge driver. Connects the realtime agent engine to a Webex meeting (audio in/out, diarized roster, participant mute, Webex meeting chat) via an injectable Cisco Webex Meetings SDK seam (Webex Meetings SDK / xAPI / Webex bot framework), 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",