@memberjunction/ai-bridge-teams 5.41.0 → 5.42.0

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export * from './teams-sdk.js';
 export * from './teams-meeting-controls.js';
 export * from './teams-bridge.js';
+export * from './teams-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 './teams-sdk.js';
 export * from './teams-meeting-controls.js';
 export * from './teams-bridge.js';
+export * from './teams-native-sdk.js';
+export * from './register-native.js';
 import { LoadTeamsBridge } from './teams-bridge.js';
+import { RegisterTeamsNativeSdk } from './register-native.js';
 // Static reference so bundlers cannot tree-shake the @RegisterClass(BaseRealtimeBridge, 'TeamsBridge')
 // registration. Calling the no-op here keeps the driver resolvable by the engine's ClassFactory.
 LoadTeamsBridge();
+// Register Teams's native two-way SDK binding so the engine auto-binds it at StartBridgeSession.
+RegisterTeamsNativeSdk();
 //# 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,19 @@
+/**
+ * @fileoverview Registers the Teams **native two-way** SDK binding into the {@link BridgeNativeSdkRegistry}
+ * so `AIBridgeEngine.StartBridgeSession` auto-binds it onto a resolved `TeamsBridge` before connect — no
+ * per-deployment wiring needed. The typed downcast + `SetSdkFactory` stay confined here (where the concrete
+ * `TeamsBridge` type is known), keeping the engine seam free of provider types.
+ *
+ * A host can still override per-session via `StartBridgeSessionParams.BindSdk` — e.g. to use a different
+ * Teams binding instead of the native two-way default.
+ *
+ * @module @memberjunction/ai-bridge-teams
+ * @author MemberJunction.com
+ */
+/**
+ * Registers Teams's native two-way binding. Idempotent (latest-wins in the registry), and invoked from the
+ * package `index.ts` so merely importing `@memberjunction/ai-bridge-teams` 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 RegisterTeamsNativeSdk(): 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,sBAAsB,IAAI,IAAI,CAO7C"}

package/dist/register-native.js

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Registers the Teams **native two-way** SDK binding into the {@link BridgeNativeSdkRegistry}
+ * so `AIBridgeEngine.StartBridgeSession` auto-binds it onto a resolved `TeamsBridge` before connect — no
+ * per-deployment wiring needed. The typed downcast + `SetSdkFactory` stay confined here (where the concrete
+ * `TeamsBridge` type is known), keeping the engine seam free of provider types.
+ *
+ * A host can still override per-session via `StartBridgeSessionParams.BindSdk` — e.g. to use a different
+ * Teams binding instead of the native two-way default.
+ *
+ * @module @memberjunction/ai-bridge-teams
+ * @author MemberJunction.com
+ */
+import { BridgeNativeSdkRegistry } from '@memberjunction/ai-bridge-base';
+import { BindTeamsNative } from './teams-native-sdk.js';
+/** The `MJ: AI Bridge Providers.DriverClass` value the Teams provider row carries. */
+const TEAMS_DRIVER_CLASS = 'TeamsBridge';
+/**
+ * Registers Teams's native two-way binding. Idempotent (latest-wins in the registry), and invoked from the
+ * package `index.ts` so merely importing `@memberjunction/ai-bridge-teams` 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 RegisterTeamsNativeSdk() {
+    BridgeNativeSdkRegistry.Instance.Register(TEAMS_DRIVER_CLASS, (driver) => {
+        // Safe downcast: the registry is keyed by DriverClass, so the engine only ever applies this to the
+        // TeamsBridge it resolved for 'TeamsBridge'. BindTeamsNative() defaults to the lazy native loader,
+        // which reads NativeModuleSpecifier from the per-session Configuration.
+        driver.SetSdkFactory(BindTeamsNative());
+    });
+}
+// Register on import (mirrors the LoadTeamsBridge() tree-shake pattern in index.ts).
+RegisterTeamsNativeSdk();
+//# 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,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/teams-native-sdk.d.ts

@@ -0,0 +1,291 @@
+/**
+ * @fileoverview `TeamsNativeMeetingSdk` — a **real, two-way** {@link ITeamsMeetingSdk} binding over a
+ * native **Microsoft Teams real-time-media / calling-bot addon** (the application-hosted-media bot build).
+ * Unlike a receive-only or stub binding, this adapter gives the agent a **voice**: {@link sendAudioFrame}
+ * forwards the agent's synthesized PCM to the native client's outbound audio-socket **send** path, and the
+ * host controls (chat / mute) actually act.
+ *
+ * ## Why a native binding
+ * Pushing audio *into* a Teams meeting and observing per-participant inbound audio requires the
+ * application-hosted-media bot model (Azure Communication Services calling-bot + Microsoft Graph
+ * cloud-communications API). The native addon exposes both the outbound audio **send** path (the bot's
+ * voice) and the per-participant inbound raw-audio receive 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 ACS/Graph calling-bot media stack has **no single official Node real-time-media package** that fits
+ * this seam; deployments wrap it as a 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 ACS/Graph SDK's real types leak into the package, and the module is loaded **lazily**
+ * behind an injectable {@link NativeModuleLoader} so `@memberjunction/ai-bridge-teams` builds and
+ * unit-tests with **no addon and no network**. Tests inject a fake module; production points
+ * {@link TeamsNativeSdkConfig.NativeModuleSpecifier} at the real addon.
+ *
+ * ## Entitlements + auth (deployment responsibility)
+ * The native bot needs the Graph cloud-communications **application-hosted media** permissions and joins
+ * with an OAuth bearer / application token (the bot's identity in the tenant) — resolved **upstream** (MJ
+ * credential system / provider `Configuration`) and **never inlined**. See the package README's
+ * "Native two-way audio" section.
+ *
+ * Every spot where the native addon's exact surface is assumed carries a `// VERIFY against the native
+ * Teams real-time-media addon` note so a live test can confirm it.
+ *
+ * @module @memberjunction/ai-bridge-teams
+ * @author MemberJunction.com
+ */
+import { ITeamsMeetingSdk, TeamsAudioFrame, TeamsJoinArgs, TeamsJoinResult, TeamsParticipant, TeamsParticipantRole } from './teams-sdk.js';
+/**
+ * Copies arbitrary PCM input (`Uint8Array` view or standalone `ArrayBuffer`) into a fresh, exactly-sized
+ * `ArrayBuffer`. Copying (rather than aliasing) protects the bridge from a native buffer the addon may
+ * recycle for the next frame, and respects a `Uint8Array`'s byteOffset/byteLength window.
+ */
+export declare function toPcmArrayBuffer(data: Uint8Array | ArrayBuffer): ArrayBuffer;
+/** One raw per-participant 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 Teams participant id that produced the audio (the diarization speaker label). */
+    participantId: string | number;
+    /** The participant's display name at capture time, when the addon provides it. */
+    displayName?: string;
+    /** Optional epoch-ms capture timestamp. */
+    timestampMs?: number;
+}
+/** One participant as the native addon reports it. Mapped onto {@link TeamsParticipant}. */
+export interface NativeParticipant {
+    /** The native participant id. */
+    participantId: string | number;
+    /** The participant's display name. */
+    displayName?: string;
+    /** The participant's role as the addon reports it (`organizer` / `presenter` / `attendee`). */
+    role?: string;
+    /** Whether this participant is the bot itself. */
+    isSelf?: boolean;
+}
+/** The arguments the native addon's `join()` accepts. Mirrors {@link TeamsJoinArgs} plus raw-audio opts. */
+export interface NativeJoinArgs {
+    /** The Teams meeting join URL (the `https://teams.microsoft.com/l/meetup-join/...` link). */
+    joinUrl: string;
+    /** The parsed meeting thread id (chat/conversation id behind the join URL), when resolved upstream. */
+    threadId?: string;
+    /** The bot's display name in the participant list. */
+    displayName: string;
+    /** The OAuth bearer / application token authorizing the bot's Graph + ACS calls (resolved upstream; never inline). */
+    accessToken?: string;
+    /** The Azure tenant id the meeting belongs to, when joining cross-tenant. */
+    tenantId?: 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 participant id in the joined meeting. */
+    botParticipantId: string | number;
+    /** The Teams call id the bot joined (the durable external connection id). */
+    callId: string;
+}
+/**
+ * The live native-meeting client the addon hands back. The surface closely mirrors {@link ITeamsMeetingSdk}
+ * but in the addon's own (lower-cased) vocabulary; this adapter maps between the two. VERIFY against the
+ * native Teams real-time-media 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 audio-socket — the agent's voice). */
+    sendAudioFrame(pcm: ArrayBuffer): void;
+    /** Registers the inbound per-participant raw-audio callback. "Latest handler wins." */
+    onAudioFrame(cb: (frame: NativeAudioFrame) => void): void;
+    /** Registers the participant-join callback. */
+    onParticipantJoin(cb: (participant: NativeParticipant) => void): void;
+    /** Registers the participant-leave callback (id of the participant that left). */
+    onParticipantLeave(cb: (participantId: string | number) => void): void;
+    /** Registers the native hand-raise/lower callback (⚠️ partial on Teams). */
+    onHandRaise(cb: (participantId: string | number, raised: boolean) => void): void;
+    /** Returns the current participant roster (including the bot). */
+    getParticipants(): Promise<NativeParticipant[]>;
+    /** Posts a message to the Teams meeting chat thread (everyone). */
+    postChatMessage(text: string): Promise<void>;
+    /** Mutes a participant (requires the bot be organizer/presenter with the relevant policy). */
+    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 (credentials already resolved upstream).
+     * VERIFY against the native Teams real-time-media addon (`createClient` vs a `Client` constructor).
+     */
+    createClient(options: NativeClientOptions): NativeMeetingClient;
+}
+/** Options passed to {@link NativeMeetingModule.createClient}. Credentials are resolved upstream. */
+export interface NativeClientOptions {
+    /** The bot's Azure AD application (client) id (resolved upstream). */
+    AppId?: string;
+    /** The Azure tenant id the bot operates in (resolved upstream). */
+    TenantId?: string;
+    /** A pre-resolved OAuth bearer / application token, when the deployment computes it out-of-band. */
+    AccessToken?: string;
+}
+/**
+ * Resolved configuration for {@link TeamsNativeMeetingSdk}. Credentials resolve **upstream** (MJ credential
+ * system / provider `Configuration`) — this object carries already-resolved values; **never inline
+ * secrets** at a call site.
+ */
+export interface TeamsNativeSdkConfig {
+    /** The bot's Azure AD application (client) id (resolved upstream). */
+    AppId?: string;
+    /** The Azure tenant id the bot operates in (resolved upstream). */
+    TenantId?: string;
+    /** A pre-resolved OAuth bearer / application token, when the deployment computes it out-of-band. */
+    AccessToken?: 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 Teams real-time-media 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;
+}
+/** Normalizes the addon's free-form role string onto the bridge's {@link TeamsParticipantRole}. */
+export declare function mapNativeRole(role?: string): TeamsParticipantRole;
+/**
+ * **Pure mapping** of one native participant onto the bridge's {@link TeamsParticipant}. Isolated from the
+ * addon and from I/O so it is unit-tested directly.
+ */
+export declare function mapNativeParticipant(p: NativeParticipant): TeamsParticipant;
+/**
+ * **Pure mapping** of one native inbound audio frame onto the bridge's diarized {@link TeamsAudioFrame}.
+ * Copies the PCM (see {@link toPcmArrayBuffer}) and resolves the speaker label. Isolated for direct testing.
+ */
+export declare function mapNativeAudioFrame(frame: NativeAudioFrame): TeamsAudioFrame;
+/**
+ * The injectable loader for the native Teams real-time-media 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 TeamsNativeSdkConfig.NativeModuleSpecifier}.
+ */
+export type NativeModuleLoader = (specifier: string) => Promise<NativeMeetingModule>;
+/**
+ * Lazily loads the native Teams real-time-media addon at the given specifier (category: runtime plugin
+ * discovery from config — the addon path is deployment-supplied and not known at build time). Throws a
+ * precise, actionable error when it can't be loaded so a misconfigured deployment fails loudly, not
+ * silently.
+ *
+ * VERIFY against the native Teams real-time-media addon: the module's default/namespace interop + that it
+ * exposes `createClient`.
+ */
+export declare const defaultNativeLoader: NativeModuleLoader;
+/**
+ * A **real, two-way** {@link ITeamsMeetingSdk} over the native Teams real-time-media addon (outbound audio
+ * send + per-participant inbound receive).
+ *
+ * Gives the agent both **hearing** (per-participant inbound audio → diarized {@link TeamsAudioFrame}s) and
+ * a **voice** ({@link sendAudioFrame} → the native outbound audio-socket), plus working host controls
+ * (chat / mute) and roster/hand-raise events. Construct via {@link BindTeamsNative} (the factory the
+ * bridge's `SetSdkFactory` wants), not directly, so config resolution + the lazy loader wire consistently.
+ */
+export declare class TeamsNativeMeetingSdk implements ITeamsMeetingSdk {
+    /** 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-participant audio handler registered by the bridge. */
+    private audioHandler?;
+    /** The participant-join handler. */
+    private joinHandler?;
+    /** The participant-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: TeamsNativeSdkConfig, loadModule?: NativeModuleLoader);
+    /**
+     * Loads the native addon, constructs a client, wires its callbacks, and joins the meeting with the
+     * resolved bot token. Brings BOTH hearing and the agent's voice online.
+     *
+     * @param args The bridge's join args (join URL, thread id, bot name, auth).
+     * @returns The bot/call identifiers.
+     * @throws When the native module specifier is missing or the addon can't be loaded.
+     */
+    join(args: TeamsJoinArgs): Promise<TeamsJoinResult>;
+    /** 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 audio-socket. 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-participant audio handler (the diarized hearing path). */
+    onAudioFrame(cb: (frame: TeamsAudioFrame) => void): void;
+    /** Registers the participant-join handler. */
+    onParticipantJoin(cb: (participant: TeamsParticipant) => void): void;
+    /** Registers the participant-leave handler. */
+    onParticipantLeave(cb: (participantId: string) => void): void;
+    /** Registers the native hand-raise/lower handler (⚠️ partial on Teams; tolerant of never firing). */
+    onHandRaise(cb: (participantId: string, raised: boolean) => void): void;
+    /** Returns the current roster from the native client, mapped to {@link TeamsParticipant}. */
+    getParticipants(): Promise<TeamsParticipant[]>;
+    /** Registers the meeting-ended handler. */
+    onMeetingEnded(cb: () => void): void;
+    /**
+     * Posts a message to the Teams meeting 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 participant via the native host control (requires the bot be organizer/presenter). No-ops
+     * (without throwing) before {@link join}.
+     *
+     * @param participantId The participant 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('./teams-sdk.js').TeamsMeetingSdkFactory}-shaped factory that constructs a
+ * {@link TeamsNativeMeetingSdk} from the bridge's per-session `Configuration`. Pass the result to
+ * `TeamsBridge.SetSdkFactory(...)` so a deployment activates **two-way native Teams audio** without code
+ * changes to the driver.
+ *
+ * Reads bot credentials / token + 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(BindTeamsNative());
+ *
+ * @param loadModule Optional native-addon loader override (tests inject a fake; production omits it).
+ * @returns A factory `(config) => TeamsNativeMeetingSdk`.
+ */
+export declare function BindTeamsNative(loadModule?: NativeModuleLoader): (config?: Record<string, unknown>) => TeamsNativeMeetingSdk;
+/**
+ * Extracts a {@link TeamsNativeSdkConfig} 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 TeamsNativeMeetingSdk.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>): TeamsNativeSdkConfig;
+//# sourceMappingURL=teams-native-sdk.d.ts.map

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

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

package/dist/teams-native-sdk.js

@@ -0,0 +1,320 @@
+/**
+ * @fileoverview `TeamsNativeMeetingSdk` — a **real, two-way** {@link ITeamsMeetingSdk} binding over a
+ * native **Microsoft Teams real-time-media / calling-bot addon** (the application-hosted-media bot build).
+ * Unlike a receive-only or stub binding, this adapter gives the agent a **voice**: {@link sendAudioFrame}
+ * forwards the agent's synthesized PCM to the native client's outbound audio-socket **send** path, and the
+ * host controls (chat / mute) actually act.
+ *
+ * ## Why a native binding
+ * Pushing audio *into* a Teams meeting and observing per-participant inbound audio requires the
+ * application-hosted-media bot model (Azure Communication Services calling-bot + Microsoft Graph
+ * cloud-communications API). The native addon exposes both the outbound audio **send** path (the bot's
+ * voice) and the per-participant inbound raw-audio receive 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 ACS/Graph calling-bot media stack has **no single official Node real-time-media package** that fits
+ * this seam; deployments wrap it as a 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 ACS/Graph SDK's real types leak into the package, and the module is loaded **lazily**
+ * behind an injectable {@link NativeModuleLoader} so `@memberjunction/ai-bridge-teams` builds and
+ * unit-tests with **no addon and no network**. Tests inject a fake module; production points
+ * {@link TeamsNativeSdkConfig.NativeModuleSpecifier} at the real addon.
+ *
+ * ## Entitlements + auth (deployment responsibility)
+ * The native bot needs the Graph cloud-communications **application-hosted media** permissions and joins
+ * with an OAuth bearer / application token (the bot's identity in the tenant) — resolved **upstream** (MJ
+ * credential system / provider `Configuration`) and **never inlined**. See the package README's
+ * "Native two-way audio" section.
+ *
+ * Every spot where the native addon's exact surface is assumed carries a `// VERIFY against the native
+ * Teams real-time-media addon` note so a live test can confirm it.
+ *
+ * @module @memberjunction/ai-bridge-teams
+ * @author MemberJunction.com
+ */
+import { LogError } from '@memberjunction/core';
+// ──────────────────────────────────────────────────────────────────────────────
+// Local PCM-coercion helper. The Teams package has no existing `toArrayBuffer`
+// export (unlike Zoom, which reuses its RTMS binding's), so we define a
+// non-colliding local one (`toPcmArrayBuffer`) to avoid clashing under index.ts's
+// `export *`.
+// ──────────────────────────────────────────────────────────────────────────────
+/**
+ * Copies arbitrary PCM input (`Uint8Array` view or standalone `ArrayBuffer`) into a fresh, exactly-sized
+ * `ArrayBuffer`. Copying (rather than aliasing) protects the bridge from a native buffer the addon may
+ * recycle for the next frame, and respects a `Uint8Array`'s byteOffset/byteLength window.
+ */
+export function toPcmArrayBuffer(data) {
+    if (data instanceof ArrayBuffer) {
+        return data.slice(0);
+    }
+    const out = new ArrayBuffer(data.byteLength);
+    new Uint8Array(out).set(data);
+    return out;
+}
+/** Normalizes the addon's free-form role string onto the bridge's {@link TeamsParticipantRole}. */
+export function mapNativeRole(role) {
+    switch ((role ?? '').trim().toLowerCase()) {
+        case 'organizer':
+            return 'Organizer';
+        case 'presenter':
+        case 'co-organizer':
+        case 'coorganizer':
+            return 'Presenter';
+        default:
+            return 'Attendee';
+    }
+}
+/**
+ * **Pure mapping** of one native participant onto the bridge's {@link TeamsParticipant}. 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 TeamsAudioFrame}.
+ * Copies the PCM (see {@link toPcmArrayBuffer}) and resolves the speaker label. Isolated for direct testing.
+ */
+export function mapNativeAudioFrame(frame) {
+    return {
+        Pcm: toPcmArrayBuffer(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 Teams real-time-media addon at the given specifier (category: runtime plugin
+ * discovery from config — the addon path is deployment-supplied and not known at build time). Throws a
+ * precise, actionable error when it can't be loaded so a misconfigured deployment fails loudly, not
+ * silently.
+ *
+ * VERIFY against the native Teams real-time-media addon: the module's default/namespace interop + that it
+ * exposes `createClient`.
+ */
+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 createClient() factory');
+        }
+        return resolved;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`TeamsNativeMeetingSdk could not load the native Teams real-time-media addon at '${specifier}'. ` +
+            'Build/install the native Teams calling-bot addon (the ACS application-hosted-media build, with ' +
+            'Graph cloud-communications permissions) and set TeamsNativeSdkConfig.NativeModuleSpecifier to it. ' +
+            `Underlying error: ${message}`);
+    }
+};
+/**
+ * A **real, two-way** {@link ITeamsMeetingSdk} over the native Teams real-time-media addon (outbound audio
+ * send + per-participant inbound receive).
+ *
+ * Gives the agent both **hearing** (per-participant inbound audio → diarized {@link TeamsAudioFrame}s) and
+ * a **voice** ({@link sendAudioFrame} → the native outbound audio-socket), plus working host controls
+ * (chat / mute) and roster/hand-raise events. Construct via {@link BindTeamsNative} (the factory the
+ * bridge's `SetSdkFactory` wants), not directly, so config resolution + the lazy loader wire consistently.
+ */
+export class TeamsNativeMeetingSdk {
+    /**
+     * @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;
+    }
+    // ── ITeamsMeetingSdk — lifecycle ─────────────────────────────────────────────────
+    /**
+     * Loads the native addon, constructs a client, wires its callbacks, and joins the meeting with the
+     * resolved bot token. Brings BOTH hearing and the agent's voice online.
+     *
+     * @param args The bridge's join args (join URL, thread id, bot name, auth).
+     * @returns The bot/call 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('TeamsNativeMeetingSdk.join: no NativeModuleSpecifier configured. Set it to the native Teams ' +
+                'real-time-media bot addon (ACS application-hosted-media build) in the session Configuration. ' +
+                'See the README.');
+        }
+        const mod = await this.loadModule(specifier);
+        const client = mod.createClient({
+            AppId: this.config.AppId,
+            TenantId: this.config.TenantId,
+            AccessToken: this.config.AccessToken,
+        });
+        this.wireClient(client);
+        const result = await client.join({
+            joinUrl: args.JoinUrl,
+            threadId: args.ThreadId,
+            displayName: args.BotDisplayName || this.config.BotDisplayName || 'AI Agent',
+            accessToken: args.AccessToken ?? this.config.AccessToken,
+            tenantId: args.TenantId ?? this.config.TenantId,
+            sampleRate: this.config.SampleRate,
+            channels: this.config.Channels,
+        });
+        this.client = client;
+        return {
+            BotParticipantId: String(result.botParticipantId),
+            CallId: result.callId || args.ThreadId || args.JoinUrl,
+        };
+    }
+    /** 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(`[TeamsNativeMeetingSdk] leave() failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    // ── ITeamsMeetingSdk — 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 audio-socket. 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-participant audio handler (the diarized hearing path). */
+    onAudioFrame(cb) {
+        this.audioHandler = cb;
+    }
+    // ── ITeamsMeetingSdk — roster + signals ──────────────────────────────────────────
+    /** Registers the participant-join handler. */
+    onParticipantJoin(cb) {
+        this.joinHandler = cb;
+    }
+    /** Registers the participant-leave handler. */
+    onParticipantLeave(cb) {
+        this.leaveHandler = cb;
+    }
+    /** Registers the native hand-raise/lower handler (⚠️ partial on Teams; tolerant of never firing). */
+    onHandRaise(cb) {
+        this.handRaiseHandler = cb;
+    }
+    /** Returns the current roster from the native client, mapped to {@link TeamsParticipant}. */
+    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;
+    }
+    // ── ITeamsMeetingSdk — host controls (real) ──────────────────────────────────────
+    /**
+     * Posts a message to the Teams meeting 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 participant via the native host control (requires the bot be organizer/presenter). No-ops
+     * (without throwing) before {@link join}.
+     *
+     * @param participantId The participant 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('./teams-sdk.js').TeamsMeetingSdkFactory}-shaped factory that constructs a
+ * {@link TeamsNativeMeetingSdk} from the bridge's per-session `Configuration`. Pass the result to
+ * `TeamsBridge.SetSdkFactory(...)` so a deployment activates **two-way native Teams audio** without code
+ * changes to the driver.
+ *
+ * Reads bot credentials / token + 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(BindTeamsNative());
+ *
+ * @param loadModule Optional native-addon loader override (tests inject a fake; production omits it).
+ * @returns A factory `(config) => TeamsNativeMeetingSdk`.
+ */
+export function BindTeamsNative(loadModule = defaultNativeLoader) {
+    return (config) => new TeamsNativeMeetingSdk(readNativeConfig(config), loadModule);
+}
+/**
+ * Extracts a {@link TeamsNativeSdkConfig} 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 TeamsNativeMeetingSdk.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 {
+        AppId: readString(cfg.AppId),
+        TenantId: readString(cfg.TenantId),
+        AccessToken: readString(cfg.AccessToken),
+        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=teams-native-sdk.js.map

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

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/ai-bridge-teams",
   "type": "module",
-  "version": "5.41.0",
+  "version": "5.42.0",
   "description": "MemberJunction: Microsoft Teams Realtime Bridge driver. Connects the realtime agent engine to a Teams meeting (audio in/out, diarized roster, participant mute, Teams meeting chat) via an injectable Teams calling-bot SDK seam (Azure Communication Services / Microsoft Graph cloud-communications), 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",