@memberjunction/ai-bridge-teams 0.0.1 → 5.41.0

package/README.md

@@ -1,45 +1,111 @@
 # @memberjunction/ai-bridge-teams
 
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/ai-bridge-teams`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**
+The **Microsoft Teams** Realtime Bridge driver in MemberJunction's Realtime Bridges program. It connects
+the one realtime agent engine to a **Teams meeting**: bidirectional audio, a diarized participant roster,
+participant mute, Teams meeting chat, and a **Meeting Controls** facilitator channel — all behind an
+injectable Teams calling-bot SDK seam so the driver builds and unit-tests with **no network and no real
+Teams / Azure Communication Services SDK**. It is a structural mirror of the reference
+[`@memberjunction/ai-bridge-zoom`](../BridgeZoom/README.md) driver.
+
+See the [Realtime Bridges Guide](../../../../guides/REALTIME_BRIDGES_GUIDE.md) and
+[`/plans/realtime/realtime-bridges-architecture.md`](../../../../plans/realtime/realtime-bridges-architecture.md)
+(§3 provider abstraction, §4b channels, §8 Microsoft Teams capability row) for the full architecture.
+
+## Install
+
+```bash
+npm install @memberjunction/ai-bridge-teams
+```
+
+## What it provides
+
+- **`TeamsBridge`** — `@RegisterClass(BaseRealtimeBridge, 'TeamsBridge')`. The `MJ: AI Bridge Providers`
+  row with `DriverClass = 'TeamsBridge'` resolves to this driver via the `ClassFactory`. Implements the
+  four `BaseRealtimeBridge` abstracts (`Connect` / `Disconnect` / `SendMedia` / `OnMedia`) and the
+  capability-gated virtuals Teams supports (`GetParticipants`, `OnParticipantChange`), plus
+  `GetMeetingControlsEventSource` for the facilitator channel and a `PostChatMessage` helper.
+- **`ITeamsMeetingSdk`** — the **injectable seam** the driver depends on instead of the real SDK.
+- **`TeamsMeetingControlsEventSource`** — adapts the seam's roster / hand-raise / speaking / mute into
+  the bridge's `IBridgeMeetingControlsEventSource`, so the engine wires the Meeting Controls channel.
+
+## Capability coverage (the Microsoft Teams seed row)
+
+| Capability | Status |
+|---|---|
+| On-demand + scheduled + invite + **native invite** join | ✅ |
+| Inbound routing | ✅ |
+| Audio in / out | ✅ |
+| Video in/out, Screen in/out (directional flags) | ✅ (transport carries them; models light audio first) |
+| Speaker diarization (roster + per-speaker labels) | ✅ |
+| Participant mute (Meeting Controls) | ✅ |
+| Teams meeting chat | ✅ |
+| Native raised-hand | ⚠️ Partial — wired where the calling-bot API surfaces it; tolerant of it never firing |
+| DTMF / call transfer / recording | ➖ not Teams-meeting features here — the gated base methods throw `BridgeCapabilityNotSupportedError` |
+
+Capability gating is two-layer (defense-in-depth): the engine checks the provider's `SupportedFeatures`
+first, and the driver re-asserts each flag with `RequireFeature` at the top of its overrides.
+
+### Teams vs. Zoom capability differences
+
+Teams advertises everything Zoom does, **plus** `InviteJoin`, `NativeInvite`, and `InboundRouting` (the
+calendar-invite / marketplace-native-invite / inbound-routing UX), and its native raised-hand is **partial**
+rather than fully reliable. Everything else (audio in/out, directional video/screen, diarized roster,
+mute, meeting chat) maps one-to-one onto the Zoom reference driver.
+
+## The Teams calling-bot SDK seam (`ITeamsMeetingSdk`)
+
+The driver never imports the real Teams / ACS SDK. It depends only on this minimal interface, named after
+Microsoft Teams / Azure Communication Services calling-bot concepts:
+
+```typescript
+export interface ITeamsMeetingSdk {
+    join(args: TeamsJoinArgs): Promise<TeamsJoinResult>;
+    leave(): Promise<void>;
+    sendAudioFrame(pcm: ArrayBuffer): void;                                 // agent's voice out (outbound audio socket)
+    onAudioFrame(cb: (frame: TeamsAudioFrame) => void): void;               // raw per-participant audio in (diarization)
+    onParticipantJoin(cb: (p: TeamsParticipant) => void): void;
+    onParticipantLeave(cb: (id: string) => void): void;
+    onHandRaise(cb: (id: string, raised: boolean) => void): void;           // ⚠️ partial on Teams
+    getParticipants(): Promise<TeamsParticipant[]>;
+    postChatMessage(text: string): Promise<void>;                           // Teams meeting chat thread
+    muteParticipant(participantId: string): Promise<void>;
+    onMeetingEnded(cb: () => void): void;
+}
+```
+
+### Production binding (deployment TODO)
+
+In production this is bound to the **Azure Communication Services (ACS) calling-bot** SDK plus the
+**Microsoft Graph cloud-communications API** (`/communications/calls`, application-hosted media) for
+per-participant PCM audio, roster events, mute, and Teams meeting-chat posting. Supply a factory via the
+creation seam:
+
+```typescript
+import { TeamsBridge } from '@memberjunction/ai-bridge-teams';
+
+// Once, where bridge drivers are configured:
+//   bridge.SetSdkFactory((config) => new RealTeamsSdkAdapter(config));
+// The adapter implements ITeamsMeetingSdk over the real ACS/Graph SDK. The driver + its tests do not change.
+```
+
+Out of the box, `TeamsBridge` ships **without** the real SDK adapter — `Connect` throws an explicit
+"bind the real Microsoft Teams SDK" error until `SetSdkFactory` is called. Tests inject a `FakeTeamsSdk`.
+
+## Usage (engine-driven)
+
+The bridge is not used directly — `AIBridgeEngine.StartBridgeSession` (`@memberjunction/ai-bridge-server`)
+resolves it from the provider's `DriverClass`, wires the transport seam to the injected
+`IRealtimeSession`, and (when a channel host is supplied) wires the Meeting Controls channel from
+`GetMeetingControlsEventSource`. See the bridge-server package and the guide's "Channel plane" section.
+
+## Testing
+
+`FakeTeamsSdk` (in `src/__tests__/`) is an in-memory `ITeamsMeetingSdk` with drive helpers and capture
+sinks. The suite covers connect/disconnect (incl. parsing the meeting thread id out of the join URL),
+audio in→`OnMedia` (speaker labels) and out→seam, participant join/leave → roster + event source, native
+hand-raise → Meeting Controls perception, capability gating (a feature Teams lacks throws), and chat — all
+with no network.
+
+```bash
+cd packages/AI/Providers/BridgeTeams && npm run test
+```

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './teams-sdk.js';
+export * from './teams-meeting-controls.js';
+export * from './teams-bridge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from './teams-sdk.js';
+export * from './teams-meeting-controls.js';
+export * from './teams-bridge.js';
+import { LoadTeamsBridge } from './teams-bridge.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();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/teams-bridge.d.ts

@@ -0,0 +1,155 @@
+/**
+ * @fileoverview `TeamsBridge` — the **Microsoft Teams** platform Realtime Bridge driver, connecting the
+ * one realtime agent engine to a **Teams meeting**. Implements the {@link BaseRealtimeBridge} contract
+ * against an injectable {@link ITeamsMeetingSdk} seam so it builds + unit-tests with NO network and NO
+ * real Teams / Azure Communication Services SDK (the Gemini `connectLiveSession` testability pattern).
+ * Structurally mirrors `ZoomBridge` (the reference driver) — only the platform names + join-coordinate
+ * parsing differ.
+ *
+ * Teams capability coverage (per the §8 seed row): on-demand + scheduled + invite + native-invite join,
+ * inbound routing, audio in/out (video/screen directional flags carried by transport), a diarized roster
+ * (`SpeakerDiarization`), participant mute + Teams meeting chat (via the Meeting Controls channel). Native
+ * raised-hand is ⚠️ partial over the calling-bot API — wired where the platform surfaces it, tolerant of
+ * it never firing. Telephony features (DTMF / transfer / recording) are NOT Teams-meeting features here,
+ * so those virtual base methods keep throwing `BridgeCapabilityNotSupportedError`.
+ *
+ * @module @memberjunction/ai-bridge-teams
+ * @author MemberJunction.com
+ */
+import { BaseRealtimeBridge, BridgeConnectResult, BridgeDisconnectReason, BridgeMediaFrame, BridgeMediaTrackKind, BridgeParticipantInfo, RealtimeBridgeContext, IBridgeMeetingControlsEventSource } from '@memberjunction/ai-bridge-base';
+import { TeamsMeetingSdkFactory } from './teams-sdk.js';
+/**
+ * The `DriverClass` key {@link TeamsBridge} registers under. A `MJ: AI Bridge Providers` row with
+ * `DriverClass = 'TeamsBridge'` resolves to this driver via the `ClassFactory`.
+ */
+export declare const TEAMS_BRIDGE_DRIVER_CLASS = "TeamsBridge";
+/**
+ * Realtime Bridge driver for **Microsoft Teams meetings**.
+ *
+ * Construct the driver with the default constructor (the engine's `ClassFactory` path) — it lazily
+ * builds the Teams SDK from the {@link sdkFactory} at {@link Connect} time. Tests inject a `FakeTeamsSdk`
+ * by overriding the factory via {@link SetSdkFactory} (the creation seam) before connecting.
+ *
+ * Registered via `@RegisterClass(BaseRealtimeBridge, 'TeamsBridge')`.
+ */
+export declare class TeamsBridge extends BaseRealtimeBridge {
+    /** The live Teams SDK seam for this session, created at {@link Connect}. */
+    private sdk;
+    /** The bot's own participant id in the joined meeting (set at {@link Connect}). */
+    private botParticipantId;
+    /** The inbound-media handler registered via {@link OnMedia}; raw audio frames are forwarded to it. */
+    private mediaHandler?;
+    /** The roster-change handler registered via {@link OnParticipantChange}. */
+    private participantHandler?;
+    /** The Meeting Controls event source for this session (only when diarization is supported). */
+    private meetingControls;
+    /**
+     * The SDK creation seam. Defaults to a factory that throws an explicit "bind the real Teams SDK"
+     * error, since this package ships WITHOUT the real SDK adapter (a deployment concern). Production
+     * sets a real factory via {@link SetSdkFactory}; tests inject a `FakeTeamsSdk`.
+     */
+    private sdkFactory;
+    /**
+     * Sets the {@link TeamsMeetingSdkFactory} this driver uses to construct its SDK seam at connect —
+     * the creation seam (mirroring Gemini's overridable `connectLiveSession`). Production binds the
+     * real Teams ACS calling-bot adapter here; tests inject a `FakeTeamsSdk`.
+     *
+     * @param factory The factory that builds the {@link ITeamsMeetingSdk} for a session.
+     */
+    SetSdkFactory(factory: TeamsMeetingSdkFactory): void;
+    /**
+     * Joins the Teams meeting and brings the bot online. Captures the capability context, builds the SDK
+     * from the {@link sdkFactory}, wires the inbound raw-audio path and meeting-ended callback, joins,
+     * and (when the provider diarizes) constructs + seeds the Meeting Controls event source.
+     *
+     * @param ctx The bridge context (features, provider name, the join URL as `Address`, config).
+     * @returns The bot participant + call (external connection) identifiers, persisted by the engine.
+     */
+    Connect(ctx: RealtimeBridgeContext): Promise<BridgeConnectResult>;
+    /**
+     * Leaves the Teams meeting and releases all SDK resources. Tolerant of teardown errors.
+     *
+     * @param _reason Why the disconnect happened (Teams teardown is uniform; the bot simply leaves).
+     */
+    Disconnect(_reason: BridgeDisconnectReason): Promise<void>;
+    /**
+     * Sends an outbound media frame into the meeting. Audio is fed to the SDK's outbound audio-socket
+     * path; video/screen frames are gated by the directional capability flags (the transport carries
+     * them, and the SDK send is a deployment-time binding TODO — today the models emit audio).
+     *
+     * @param track The outbound track the frame targets.
+     * @param frame The media frame to send.
+     */
+    SendMedia(track: BridgeMediaTrackKind, frame: BridgeMediaFrame): void;
+    /**
+     * Registers the inbound-media handler. The driver forwards each raw per-participant audio frame
+     * (with its speaker label) to this handler; the engine routes it to `IRealtimeSession.SendInput`.
+     *
+     * @param handler Invoked with each inbound media frame.
+     */
+    OnMedia(handler: (frame: BridgeMediaFrame) => void): void;
+    /**
+     * Returns the current Teams participant roster (gated by `SpeakerDiarization`). Re-asserts the flag
+     * (defense-in-depth) so even an engine-bypassing caller cannot pull a roster a disabled provider
+     * forbids.
+     *
+     * @returns The current participants.
+     * @throws {BridgeCapabilityNotSupportedError} when diarization is not enabled for the provider.
+     */
+    GetParticipants(): Promise<BridgeParticipantInfo[]>;
+    /**
+     * Registers a roster-change handler (gated by `SpeakerDiarization`). The driver fires it from the
+     * SDK's participant join/leave stream with the full current roster.
+     *
+     * @param handler Invoked with the updated participant list on each change.
+     * @throws {BridgeCapabilityNotSupportedError} when diarization is not enabled.
+     */
+    OnParticipantChange(handler: (participants: BridgeParticipantInfo[]) => void): void;
+    /**
+     * Returns the Teams Meeting Controls event source for this session (roster · hand-raise · speaking ·
+     * mute), or `null` when diarization is off (no roster to facilitate). The engine wires the Meeting
+     * Controls channel from this.
+     */
+    GetMeetingControlsEventSource(): IBridgeMeetingControlsEventSource | null;
+    /**
+     * Posts a message to the Teams meeting chat. Exposed for the channel plane / turn-taking hybrid
+     * mode (the social-cost-free "raise hand"). Best-effort — a chat failure is logged, never fatal.
+     *
+     * @param text The chat message to post.
+     */
+    PostChatMessage(text: string): Promise<void>;
+    /** The bot's participant id in the joined meeting (or `null` before {@link Connect}). */
+    get BotParticipantId(): string | null;
+    /** Wires the SDK's inbound raw-audio callback to a diarized inbound {@link BridgeMediaFrame}. */
+    private wireInboundAudio;
+    /**
+     * Wires the SDK's participant join/leave + hand-raise streams ONCE (the driver is the single owner;
+     * the SDK seam is latest-handler-wins). Each roster change fans out to both the driver's own
+     * roster-change handler and the Meeting Controls source; hand-raise signals (⚠️ partial on Teams)
+     * feed the source.
+     */
+    private wireRoster;
+    /** Pulls the current roster from the SDK and fans it out to both the participant handler + Meeting Controls. */
+    private refreshRoster;
+    /** Handles the SDK's meeting-ended signal: surface an empty roster so the engine sees everyone gone. */
+    private handleMeetingEnded;
+    /** Builds the SDK join args from the bridge context (Address is the meeting join URL). */
+    private buildJoinArgs;
+    /**
+     * Extracts the meeting thread id from a Teams `meetup-join` URL when present, else `undefined`. The
+     * thread id is the `19:meeting_...@thread.v2` segment embedded (URL-encoded) in the join link.
+     * Tolerant — a non-matching address yields `undefined` so the SDK can resolve coordinates itself.
+     */
+    private parseThreadId;
+    /** Returns the PCM bytes of an outbound audio frame, preferring the binary payload. */
+    private framePcm;
+    /** Decodes a base64 payload to an `ArrayBuffer` (Node `Buffer` fast path, `atob` fallback). */
+    private decodeBase64;
+}
+/**
+ * Tree-shaking-prevention loader. Modern bundlers cannot see the `@RegisterClass` dynamic registration
+ * of {@link TeamsBridge} and may eliminate it. Import and call this no-op from a static code path
+ * (the package entry point does) so the `ClassFactory` can resolve `'TeamsBridge'`.
+ */
+export declare function LoadTeamsBridge(): void;
+//# sourceMappingURL=teams-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"teams-bridge.d.ts","sourceRoot":"","sources":["../src/teams-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EACH,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EAErB,qBAAqB,EACrB,iCAAiC,EACpC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEH,sBAAsB,EAKzB,MAAM,aAAa,CAAC;AAGrB;;;GAGG;AACH,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AA8BvD;;;;;;;;GAQG;AACH,qBACa,WAAY,SAAQ,kBAAkB;IAC/C,4EAA4E;IAC5E,OAAO,CAAC,GAAG,CAAiC;IAE5C,mFAAmF;IACnF,OAAO,CAAC,gBAAgB,CAAuB;IAE/C,sGAAsG;IACtG,OAAO,CAAC,YAAY,CAAC,CAAoC;IAEzD,4EAA4E;IAC5E,OAAO,CAAC,kBAAkB,CAAC,CAAkD;IAE7E,+FAA+F;IAC/F,OAAO,CAAC,eAAe,CAAgD;IAEvE;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAMhB;IAEF;;;;;;OAMG;IACI,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAM3D;;;;;;;OAOG;IACU,OAAO,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA2B9E;;;;OAIG;IACU,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvE;;;;;;;OAOG;IACI,SAAS,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAuB5E;;;;;OAKG;IACI,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAMhE;;;;;;;OAOG;IACmB,eAAe,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IASzE;;;;;;OAMG;IACa,mBAAmB,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,qBAAqB,EAAE,KAAK,IAAI,GAAG,IAAI;IAKnG;;;;OAIG;IACa,6BAA6B,IAAI,iCAAiC,GAAG,IAAI;IAMzF;;;;;OAKG;IACU,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzD,yFAAyF;IACzF,IAAW,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAE3C;IAID,iGAAiG;IACjG,OAAO,CAAC,gBAAgB;IAWxB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAMlB,gHAAgH;YAClG,aAAa;IAU3B,wGAAwG;IACxG,OAAO,CAAC,kBAAkB;IAK1B,0FAA0F;IAC1F,OAAO,CAAC,aAAa;IAWrB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAerB,uFAAuF;IACvF,OAAO,CAAC,QAAQ;IAUhB,+FAA+F;IAC/F,OAAO,CAAC,YAAY;CAevB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/teams-bridge.js

@@ -0,0 +1,356 @@
+/**
+ * @fileoverview `TeamsBridge` — the **Microsoft Teams** platform Realtime Bridge driver, connecting the
+ * one realtime agent engine to a **Teams meeting**. Implements the {@link BaseRealtimeBridge} contract
+ * against an injectable {@link ITeamsMeetingSdk} seam so it builds + unit-tests with NO network and NO
+ * real Teams / Azure Communication Services SDK (the Gemini `connectLiveSession` testability pattern).
+ * Structurally mirrors `ZoomBridge` (the reference driver) — only the platform names + join-coordinate
+ * parsing differ.
+ *
+ * Teams capability coverage (per the §8 seed row): on-demand + scheduled + invite + native-invite join,
+ * inbound routing, audio in/out (video/screen directional flags carried by transport), a diarized roster
+ * (`SpeakerDiarization`), participant mute + Teams meeting chat (via the Meeting Controls channel). Native
+ * raised-hand is ⚠️ partial over the calling-bot API — wired where the platform surfaces it, tolerant of
+ * it never firing. Telephony features (DTMF / transfer / recording) are NOT Teams-meeting features here,
+ * so those virtual base methods keep throwing `BridgeCapabilityNotSupportedError`.
+ *
+ * @module @memberjunction/ai-bridge-teams
+ * @author MemberJunction.com
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { LogError } from '@memberjunction/core';
+import { BaseRealtimeBridge, } from '@memberjunction/ai-bridge-base';
+import { TeamsMeetingControlsEventSource } from './teams-meeting-controls.js';
+/**
+ * The `DriverClass` key {@link TeamsBridge} registers under. A `MJ: AI Bridge Providers` row with
+ * `DriverClass = 'TeamsBridge'` resolves to this driver via the `ClassFactory`.
+ */
+export const TEAMS_BRIDGE_DRIVER_CLASS = 'TeamsBridge';
+/**
+ * Maps a Teams participant role to the bridge's {@link BridgeParticipantRole}. The bot (`IsSelf`) is
+ * surfaced as `'Agent'`; Teams organizers/presenters map to host/co-host.
+ */
+function mapParticipantRole(role, isSelf) {
+    if (isSelf) {
+        return 'Agent';
+    }
+    switch (role) {
+        case 'Organizer':
+            return 'Host';
+        case 'Presenter':
+            return 'CoHost';
+        default:
+            return 'Participant';
+    }
+}
+/** Maps a Teams participant onto the bridge's {@link BridgeParticipantInfo}. */
+function toBridgeParticipant(p) {
+    return {
+        ExternalId: p.ParticipantId,
+        DisplayName: p.DisplayName,
+        Role: mapParticipantRole(p.Role, p.IsSelf),
+        IsAgent: p.IsSelf === true,
+    };
+}
+/**
+ * Realtime Bridge driver for **Microsoft Teams meetings**.
+ *
+ * Construct the driver with the default constructor (the engine's `ClassFactory` path) — it lazily
+ * builds the Teams SDK from the {@link sdkFactory} at {@link Connect} time. Tests inject a `FakeTeamsSdk`
+ * by overriding the factory via {@link SetSdkFactory} (the creation seam) before connecting.
+ *
+ * Registered via `@RegisterClass(BaseRealtimeBridge, 'TeamsBridge')`.
+ */
+let TeamsBridge = class TeamsBridge extends BaseRealtimeBridge {
+    constructor() {
+        super(...arguments);
+        /** The live Teams SDK seam for this session, created at {@link Connect}. */
+        this.sdk = null;
+        /** The bot's own participant id in the joined meeting (set at {@link Connect}). */
+        this.botParticipantId = null;
+        /** The Meeting Controls event source for this session (only when diarization is supported). */
+        this.meetingControls = null;
+        /**
+         * The SDK creation seam. Defaults to a factory that throws an explicit "bind the real Teams SDK"
+         * error, since this package ships WITHOUT the real SDK adapter (a deployment concern). Production
+         * sets a real factory via {@link SetSdkFactory}; tests inject a `FakeTeamsSdk`.
+         */
+        this.sdkFactory = () => {
+            throw new Error('TeamsBridge has no Microsoft Teams SDK bound. Call TeamsBridge.SetSdkFactory(...) with a factory ' +
+                'that builds an ITeamsMeetingSdk over the real Azure Communication Services calling-bot / Microsoft Graph ' +
+                'cloud-communications API, or inject a fake in tests.');
+        };
+    }
+    /**
+     * Sets the {@link TeamsMeetingSdkFactory} this driver uses to construct its SDK seam at connect —
+     * the creation seam (mirroring Gemini's overridable `connectLiveSession`). Production binds the
+     * real Teams ACS calling-bot adapter here; tests inject a `FakeTeamsSdk`.
+     *
+     * @param factory The factory that builds the {@link ITeamsMeetingSdk} for a session.
+     */
+    SetSdkFactory(factory) {
+        this.sdkFactory = factory;
+    }
+    // ── Abstract — every bridge MUST implement ───────────────────────────────────────
+    /**
+     * Joins the Teams meeting and brings the bot online. Captures the capability context, builds the SDK
+     * from the {@link sdkFactory}, wires the inbound raw-audio path and meeting-ended callback, joins,
+     * and (when the provider diarizes) constructs + seeds the Meeting Controls event source.
+     *
+     * @param ctx The bridge context (features, provider name, the join URL as `Address`, config).
+     * @returns The bot participant + call (external connection) identifiers, persisted by the engine.
+     */
+    async Connect(ctx) {
+        this.applyContext(ctx);
+        this.RequireFeature('AudioIn'); // a Teams meeting bridge requires bidirectional audio at minimum
+        this.RequireFeature('AudioOut');
+        this.sdk = this.sdkFactory(ctx.Configuration);
+        this.wireInboundAudio(this.sdk);
+        this.sdk.onMeetingEnded(() => this.handleMeetingEnded());
+        // Roster diarization is optional per provider; only stand up the Meeting Controls source when
+        // the platform advertises it (the engine also gates participant tracking on this flag).
+        if (this.features.SpeakerDiarization === true) {
+            this.meetingControls = new TeamsMeetingControlsEventSource(this.sdk);
+        }
+        // The driver owns the single SDK subscription set and fans out to BOTH its own roster handler
+        // and the Meeting Controls source (the SDK seam is latest-handler-wins, so there is one owner).
+        this.wireRoster(this.sdk);
+        const result = await this.sdk.join(this.buildJoinArgs(ctx));
+        this.botParticipantId = result.BotParticipantId;
+        // Seed the initial roster now that the bot has joined.
+        await this.refreshRoster(this.sdk);
+        return { BotParticipantId: result.BotParticipantId, ExternalConnectionId: result.CallId };
+    }
+    /**
+     * Leaves the Teams meeting and releases all SDK resources. Tolerant of teardown errors.
+     *
+     * @param _reason Why the disconnect happened (Teams teardown is uniform; the bot simply leaves).
+     */
+    async Disconnect(_reason) {
+        const sdk = this.sdk;
+        this.sdk = null;
+        this.botParticipantId = null;
+        this.meetingControls = null;
+        this.mediaHandler = undefined;
+        this.participantHandler = undefined;
+        if (sdk) {
+            try {
+                await sdk.leave();
+            }
+            catch (err) {
+                LogError(`[TeamsBridge] leave() failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    /**
+     * Sends an outbound media frame into the meeting. Audio is fed to the SDK's outbound audio-socket
+     * path; video/screen frames are gated by the directional capability flags (the transport carries
+     * them, and the SDK send is a deployment-time binding TODO — today the models emit audio).
+     *
+     * @param track The outbound track the frame targets.
+     * @param frame The media frame to send.
+     */
+    SendMedia(track, frame) {
+        if (!this.sdk) {
+            return; // not connected — drop
+        }
+        switch (track) {
+            case 'audio-out': {
+                const pcm = this.framePcm(frame);
+                if (pcm) {
+                    this.sdk.sendAudioFrame(pcm);
+                }
+                break;
+            }
+            case 'video-out':
+            case 'screen-out':
+                // Directional video/screen capability is declared; the SDK send binding lands with the
+                // first realtime model that emits these tracks (TODO at deployment). No-op for now.
+                break;
+            default:
+                // An inbound track was passed to SendMedia — ignore (defensive).
+                break;
+        }
+    }
+    /**
+     * Registers the inbound-media handler. The driver forwards each raw per-participant audio frame
+     * (with its speaker label) to this handler; the engine routes it to `IRealtimeSession.SendInput`.
+     *
+     * @param handler Invoked with each inbound media frame.
+     */
+    OnMedia(handler) {
+        this.mediaHandler = handler;
+    }
+    // ── Capability-gated virtuals Teams supports (gated by SupportedFeatures) ──────────
+    /**
+     * Returns the current Teams participant roster (gated by `SpeakerDiarization`). Re-asserts the flag
+     * (defense-in-depth) so even an engine-bypassing caller cannot pull a roster a disabled provider
+     * forbids.
+     *
+     * @returns The current participants.
+     * @throws {BridgeCapabilityNotSupportedError} when diarization is not enabled for the provider.
+     */
+    async GetParticipants() {
+        this.RequireFeature('SpeakerDiarization');
+        if (!this.sdk) {
+            return [];
+        }
+        const participants = await this.sdk.getParticipants();
+        return participants.map(toBridgeParticipant);
+    }
+    /**
+     * Registers a roster-change handler (gated by `SpeakerDiarization`). The driver fires it from the
+     * SDK's participant join/leave stream with the full current roster.
+     *
+     * @param handler Invoked with the updated participant list on each change.
+     * @throws {BridgeCapabilityNotSupportedError} when diarization is not enabled.
+     */
+    OnParticipantChange(handler) {
+        this.RequireFeature('SpeakerDiarization');
+        this.participantHandler = handler;
+    }
+    /**
+     * Returns the Teams Meeting Controls event source for this session (roster · hand-raise · speaking ·
+     * mute), or `null` when diarization is off (no roster to facilitate). The engine wires the Meeting
+     * Controls channel from this.
+     */
+    GetMeetingControlsEventSource() {
+        return this.meetingControls;
+    }
+    // ── Teams-native surfaces (used by the channel plane / facilitator) ──────────────
+    /**
+     * Posts a message to the Teams meeting chat. Exposed for the channel plane / turn-taking hybrid
+     * mode (the social-cost-free "raise hand"). Best-effort — a chat failure is logged, never fatal.
+     *
+     * @param text The chat message to post.
+     */
+    async PostChatMessage(text) {
+        if (!this.sdk) {
+            return;
+        }
+        try {
+            await this.sdk.postChatMessage(text);
+        }
+        catch (err) {
+            LogError(`[TeamsBridge] postChatMessage failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** The bot's participant id in the joined meeting (or `null` before {@link Connect}). */
+    get BotParticipantId() {
+        return this.botParticipantId;
+    }
+    // ── internals ────────────────────────────────────────────────────────────────────
+    /** Wires the SDK's inbound raw-audio callback to a diarized inbound {@link BridgeMediaFrame}. */
+    wireInboundAudio(sdk) {
+        sdk.onAudioFrame((frame) => {
+            this.mediaHandler?.({
+                Track: 'audio-in',
+                Bytes: frame.Pcm,
+                SpeakerLabel: frame.ParticipantId,
+                TimestampMs: frame.TimestampMs ?? Date.now(),
+            });
+        });
+    }
+    /**
+     * Wires the SDK's participant join/leave + hand-raise streams ONCE (the driver is the single owner;
+     * the SDK seam is latest-handler-wins). Each roster change fans out to both the driver's own
+     * roster-change handler and the Meeting Controls source; hand-raise signals (⚠️ partial on Teams)
+     * feed the source.
+     */
+    wireRoster(sdk) {
+        sdk.onParticipantJoin(() => void this.refreshRoster(sdk));
+        sdk.onParticipantLeave(() => void this.refreshRoster(sdk));
+        sdk.onHandRaise((id, raised) => this.meetingControls?.IngestHandRaise(id, raised));
+    }
+    /** Pulls the current roster from the SDK and fans it out to both the participant handler + Meeting Controls. */
+    async refreshRoster(sdk) {
+        try {
+            const participants = await sdk.getParticipants();
+            this.participantHandler?.(participants.map(toBridgeParticipant));
+            this.meetingControls?.IngestRoster(participants);
+        }
+        catch (err) {
+            LogError(`[TeamsBridge] roster refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** Handles the SDK's meeting-ended signal: surface an empty roster so the engine sees everyone gone. */
+    handleMeetingEnded() {
+        this.participantHandler?.([]);
+        this.meetingControls?.IngestRoster([]);
+    }
+    /** Builds the SDK join args from the bridge context (Address is the meeting join URL). */
+    buildJoinArgs(ctx) {
+        const config = ctx.Configuration ?? {};
+        return {
+            JoinUrl: ctx.Address,
+            ThreadId: typeof config.ThreadId === 'string' ? config.ThreadId : this.parseThreadId(ctx.Address),
+            BotDisplayName: typeof config.BotDisplayName === 'string' ? config.BotDisplayName : `${ctx.ProviderName} Agent`,
+            AccessToken: typeof config.AccessToken === 'string' ? config.AccessToken : undefined,
+            TenantId: typeof config.TenantId === 'string' ? config.TenantId : undefined,
+        };
+    }
+    /**
+     * Extracts the meeting thread id from a Teams `meetup-join` URL when present, else `undefined`. The
+     * thread id is the `19:meeting_...@thread.v2` segment embedded (URL-encoded) in the join link.
+     * Tolerant — a non-matching address yields `undefined` so the SDK can resolve coordinates itself.
+     */
+    parseThreadId(address) {
+        if (!address) {
+            return undefined;
+        }
+        const decoded = (() => {
+            try {
+                return decodeURIComponent(address);
+            }
+            catch {
+                return address;
+            }
+        })();
+        const match = decoded.match(/(19:meeting_[^/@]+@thread\.v2)/i);
+        return match ? match[1] : undefined;
+    }
+    /** Returns the PCM bytes of an outbound audio frame, preferring the binary payload. */
+    framePcm(frame) {
+        if (frame.Bytes) {
+            return frame.Bytes;
+        }
+        if (frame.Base64) {
+            return this.decodeBase64(frame.Base64);
+        }
+        return undefined;
+    }
+    /** Decodes a base64 payload to an `ArrayBuffer` (Node `Buffer` fast path, `atob` fallback). */
+    decodeBase64(base64) {
+        if (typeof Buffer !== 'undefined') {
+            const buf = Buffer.from(base64, 'base64');
+            // Copy into a fresh ArrayBuffer (Buffer.buffer is ArrayBufferLike under newer @types/node).
+            const out = new Uint8Array(buf.byteLength);
+            out.set(buf);
+            return out.buffer;
+        }
+        const binary = atob(base64);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        return bytes.buffer;
+    }
+};
+TeamsBridge = __decorate([
+    RegisterClass(BaseRealtimeBridge, TEAMS_BRIDGE_DRIVER_CLASS)
+], TeamsBridge);
+export { TeamsBridge };
+/**
+ * Tree-shaking-prevention loader. Modern bundlers cannot see the `@RegisterClass` dynamic registration
+ * of {@link TeamsBridge} and may eliminate it. Import and call this no-op from a static code path
+ * (the package entry point does) so the `ClassFactory` can resolve `'TeamsBridge'`.
+ */
+export function LoadTeamsBridge() {
+    // Intentionally empty — referencing the module is what prevents tree-shaking.
+}
+//# sourceMappingURL=teams-bridge.js.map

package/dist/teams-bridge.js.map

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

package/dist/teams-meeting-controls.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Adapts the {@link ITeamsMeetingSdk} participant / hand-raise / speaking stream into an
+ * {@link IBridgeMeetingControlsEventSource} so the bridge engine can wire the **Meeting Controls**
+ * facilitator channel (roster · hand-raise queue · who's-speaking · mute) for a Teams session. This is
+ * the §4b "the bridge contributes a channel" pattern realized for Teams — no channel logic lives here,
+ * only the platform→channel signal mapping.
+ */
+import { IBridgeMeetingControlsEventSource, BridgeMeetingParticipant, BridgeMeetingControlsCapability } from '@memberjunction/ai-bridge-base';
+import { ITeamsMeetingSdk, TeamsParticipant } from './teams-sdk.js';
+/** Maps one Teams participant onto the channel's {@link BridgeMeetingParticipant} shape. */
+export declare function toMeetingParticipant(p: TeamsParticipant): BridgeMeetingParticipant;
+/**
+ * Teams's adapter to the Meeting Controls channel's event source. It maintains a live roster and
+ * mirrors native hand-raise + diarized speaking signals, and actuates mute through the SDK.
+ *
+ * **The driver owns the SDK subscriptions** (the SDK seam is "latest handler wins", so it can have
+ * only one subscriber per event) and **feeds this source imperatively** via {@link IngestRoster} /
+ * {@link IngestHandRaise} / {@link IngestSpeaking}. This source only needs the SDK for the one *action*
+ * it actuates — {@link MuteParticipant}. The Meeting Controls channel subscribes the three `On*`
+ * streams in turn.
+ *
+ * The driver constructs ONE of these per session (only when the provider has `SpeakerDiarization`, i.e.
+ * there is a roster to facilitate) and returns it from `TeamsBridge.GetMeetingControlsEventSource`.
+ */
+export declare class TeamsMeetingControlsEventSource implements IBridgeMeetingControlsEventSource {
+    private readonly sdk;
+    /** Live roster keyed by participant id (lowercased), kept current by the driver's {@link IngestRoster}. */
+    private readonly roster;
+    private rosterHandler?;
+    private speakingHandler?;
+    private handRaiseHandler?;
+    /** Teams supports organizer/presenter-driven mute, so the facilitator `MuteParticipant` tool is offered. */
+    readonly Capabilities: ReadonlyArray<BridgeMeetingControlsCapability>;
+    /**
+     * @param sdk The Teams SDK seam used only to actuate {@link MuteParticipant} — all *perception* is
+     *   fed in by the driver via the `Ingest*` methods so the SDK keeps a single subscriber per event.
+     */
+    constructor(sdk: ITeamsMeetingSdk);
+    /**
+     * Replaces the roster with a fresh snapshot from the driver and emits it to the channel. Called by
+     * the driver after the initial join and on every participant join/leave.
+     *
+     * @param participants The full current Teams roster.
+     */
+    IngestRoster(participants: TeamsParticipant[]): void;
+    /**
+     * Forwards a native hand-raise/lower signal from the driver to the channel.
+     *
+     * ⚠️ Teams raised-hand is partial; this may never fire on tenants/builds that don't surface the
+     * event over the calling-bot API. The channel degrades gracefully (its software hand-raise still works).
+     *
+     * @param participantId The participant whose hand changed.
+     * @param raised Whether the hand is now raised.
+     */
+    IngestHandRaise(participantId: string, raised: boolean): void;
+    /**
+     * Forwards a diarized speaking-set change from the driver to the channel.
+     *
+     * @param participantIds The ids currently speaking.
+     */
+    IngestSpeaking(participantIds: string[]): void;
+    /**
+     * Convenience alias for {@link IngestSpeaking}, kept because "notify" reads naturally at the
+     * driver's inbound-audio call site.
+     *
+     * @param participantIds The ids currently speaking.
+     */
+    NotifySpeaking(participantIds: string[]): void;
+    /** @inheritdoc */
+    OnRosterChange(handler: (participants: BridgeMeetingParticipant[]) => void): void;
+    /** @inheritdoc */
+    OnSpeakingChange(handler: (participantIds: string[]) => void): void;
+    /** @inheritdoc */
+    OnHandRaiseChange(handler: (participantId: string, raised: boolean) => void): void;
+    /** @inheritdoc */
+    MuteParticipant(participantId: string): Promise<void>;
+    private emitRoster;
+    private key;
+}
+//# sourceMappingURL=teams-meeting-controls.d.ts.map

package/dist/teams-meeting-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams-meeting-controls.d.ts","sourceRoot":"","sources":["../src/teams-meeting-controls.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACH,iCAAiC,EACjC,wBAAwB,EACxB,+BAA+B,EAElC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAwB,MAAM,aAAa,CAAC;AAqBvF,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,gBAAgB,GAAG,wBAAwB,CAOlF;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,+BAAgC,YAAW,iCAAiC;IAezE,OAAO,CAAC,QAAQ,CAAC,GAAG;IAdhC,2GAA2G;IAC3G,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IAEtE,OAAO,CAAC,aAAa,CAAC,CAAqD;IAC3E,OAAO,CAAC,eAAe,CAAC,CAAqC;IAC7D,OAAO,CAAC,gBAAgB,CAAC,CAAmD;IAE5E,4GAA4G;IAC5G,SAAgB,YAAY,EAAE,aAAa,CAAC,+BAA+B,CAAC,CAAY;IAExF;;;OAGG;gBAC0B,GAAG,EAAE,gBAAgB;IAIlD;;;;;OAKG;IACI,YAAY,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAQ3D;;;;;;;;OAQG;IACI,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIpE;;;;OAIG;IACI,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI;IAIrD;;;;;OAKG;IACI,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI;IAMrD,kBAAkB;IACX,cAAc,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,wBAAwB,EAAE,KAAK,IAAI,GAAG,IAAI;IAMxF,kBAAkB;IACX,gBAAgB,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI;IAI1E,kBAAkB;IACX,iBAAiB,CAAC,OAAO,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAIzF,kBAAkB;IACL,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlE,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,GAAG;CAGd"}

package/dist/teams-meeting-controls.js

@@ -0,0 +1,130 @@
+/**
+ * Adapts the {@link ITeamsMeetingSdk} participant / hand-raise / speaking stream into an
+ * {@link IBridgeMeetingControlsEventSource} so the bridge engine can wire the **Meeting Controls**
+ * facilitator channel (roster · hand-raise queue · who's-speaking · mute) for a Teams session. This is
+ * the §4b "the bridge contributes a channel" pattern realized for Teams — no channel logic lives here,
+ * only the platform→channel signal mapping.
+ */
+/**
+ * Maps a Teams participant role to the bridge's meeting-participant role. Teams has no distinct "Agent"
+ * role; the bot is flagged via `IsSelf` and surfaced as `'Agent'`. Teams organizers/presenters map to
+ * the bridge's host/co-host roles (the closest facilitator-authority equivalents).
+ */
+function mapRole(role, isSelf) {
+    if (isSelf) {
+        return 'Agent';
+    }
+    switch (role) {
+        case 'Organizer':
+            return 'Host';
+        case 'Presenter':
+            return 'CoHost';
+        default:
+            return 'Participant';
+    }
+}
+/** Maps one Teams participant onto the channel's {@link BridgeMeetingParticipant} shape. */
+export function toMeetingParticipant(p) {
+    return {
+        ParticipantId: p.ParticipantId,
+        DisplayName: p.DisplayName,
+        Role: mapRole(p.Role, p.IsSelf),
+        IsAgent: p.IsSelf === true,
+    };
+}
+/**
+ * Teams's adapter to the Meeting Controls channel's event source. It maintains a live roster and
+ * mirrors native hand-raise + diarized speaking signals, and actuates mute through the SDK.
+ *
+ * **The driver owns the SDK subscriptions** (the SDK seam is "latest handler wins", so it can have
+ * only one subscriber per event) and **feeds this source imperatively** via {@link IngestRoster} /
+ * {@link IngestHandRaise} / {@link IngestSpeaking}. This source only needs the SDK for the one *action*
+ * it actuates — {@link MuteParticipant}. The Meeting Controls channel subscribes the three `On*`
+ * streams in turn.
+ *
+ * The driver constructs ONE of these per session (only when the provider has `SpeakerDiarization`, i.e.
+ * there is a roster to facilitate) and returns it from `TeamsBridge.GetMeetingControlsEventSource`.
+ */
+export class TeamsMeetingControlsEventSource {
+    /**
+     * @param sdk The Teams SDK seam used only to actuate {@link MuteParticipant} — all *perception* is
+     *   fed in by the driver via the `Ingest*` methods so the SDK keeps a single subscriber per event.
+     */
+    constructor(sdk) {
+        this.sdk = sdk;
+        /** Live roster keyed by participant id (lowercased), kept current by the driver's {@link IngestRoster}. */
+        this.roster = new Map();
+        /** Teams supports organizer/presenter-driven mute, so the facilitator `MuteParticipant` tool is offered. */
+        this.Capabilities = ['Mute'];
+    }
+    // ── Driver-fed perception (the driver owns the SDK subscriptions) ─────────────────
+    /**
+     * Replaces the roster with a fresh snapshot from the driver and emits it to the channel. Called by
+     * the driver after the initial join and on every participant join/leave.
+     *
+     * @param participants The full current Teams roster.
+     */
+    IngestRoster(participants) {
+        this.roster.clear();
+        for (const p of participants) {
+            this.roster.set(this.key(p.ParticipantId), toMeetingParticipant(p));
+        }
+        this.emitRoster();
+    }
+    /**
+     * Forwards a native hand-raise/lower signal from the driver to the channel.
+     *
+     * ⚠️ Teams raised-hand is partial; this may never fire on tenants/builds that don't surface the
+     * event over the calling-bot API. The channel degrades gracefully (its software hand-raise still works).
+     *
+     * @param participantId The participant whose hand changed.
+     * @param raised Whether the hand is now raised.
+     */
+    IngestHandRaise(participantId, raised) {
+        this.handRaiseHandler?.(participantId, raised);
+    }
+    /**
+     * Forwards a diarized speaking-set change from the driver to the channel.
+     *
+     * @param participantIds The ids currently speaking.
+     */
+    IngestSpeaking(participantIds) {
+        this.speakingHandler?.(participantIds);
+    }
+    /**
+     * Convenience alias for {@link IngestSpeaking}, kept because "notify" reads naturally at the
+     * driver's inbound-audio call site.
+     *
+     * @param participantIds The ids currently speaking.
+     */
+    NotifySpeaking(participantIds) {
+        this.IngestSpeaking(participantIds);
+    }
+    // ── IBridgeMeetingControlsEventSource ────────────────────────────────────────────
+    /** @inheritdoc */
+    OnRosterChange(handler) {
+        this.rosterHandler = handler;
+        // Emit the current roster immediately so a late subscriber is not blank.
+        this.emitRoster();
+    }
+    /** @inheritdoc */
+    OnSpeakingChange(handler) {
+        this.speakingHandler = handler;
+    }
+    /** @inheritdoc */
+    OnHandRaiseChange(handler) {
+        this.handRaiseHandler = handler;
+    }
+    /** @inheritdoc */
+    async MuteParticipant(participantId) {
+        await this.sdk.muteParticipant(participantId);
+    }
+    // ── internals ────────────────────────────────────────────────────────────────────
+    emitRoster() {
+        this.rosterHandler?.(Array.from(this.roster.values()));
+    }
+    key(participantId) {
+        return participantId.trim().toLowerCase();
+    }
+}
+//# sourceMappingURL=teams-meeting-controls.js.map

package/dist/teams-meeting-controls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams-meeting-controls.js","sourceRoot":"","sources":["../src/teams-meeting-controls.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH;;;;GAIG;AACH,SAAS,OAAO,CAAC,IAA0B,EAAE,MAA2B;IACpE,IAAI,MAAM,EAAE,CAAC;QACT,OAAO,OAAO,CAAC;IACnB,CAAC;IACD,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,WAAW;YACZ,OAAO,MAAM,CAAC;QAClB,KAAK,WAAW;YACZ,OAAO,QAAQ,CAAC;QACpB;YACI,OAAO,aAAa,CAAC;IAC7B,CAAC;AACL,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,oBAAoB,CAAC,CAAmB;IACpD,OAAO;QACH,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI;KAC7B,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,+BAA+B;IAWxC;;;OAGG;IACH,YAA6B,GAAqB;QAArB,QAAG,GAAH,GAAG,CAAkB;QAdlD,2GAA2G;QAC1F,WAAM,GAAG,IAAI,GAAG,EAAoC,CAAC;QAMtE,4GAA4G;QAC5F,iBAAY,GAAmD,CAAC,MAAM,CAAC,CAAC;IAMnC,CAAC;IAEtD,qFAAqF;IAErF;;;;;OAKG;IACI,YAAY,CAAC,YAAgC;QAChD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;;;OAQG;IACI,eAAe,CAAC,aAAqB,EAAE,MAAe;QACzD,IAAI,CAAC,gBAAgB,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,cAAc,CAAC,cAAwB;QAC1C,IAAI,CAAC,eAAe,EAAE,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACI,cAAc,CAAC,cAAwB;QAC1C,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IACxC,CAAC;IAED,oFAAoF;IAEpF,kBAAkB;IACX,cAAc,CAAC,OAA2D;QAC7E,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,yEAAyE;QACzE,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAED,kBAAkB;IACX,gBAAgB,CAAC,OAA2C;QAC/D,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC;IACnC,CAAC;IAED,kBAAkB;IACX,iBAAiB,CAAC,OAAyD;QAC9E,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;IACpC,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,eAAe,CAAC,aAAqB;QAC9C,MAAM,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,oFAAoF;IAE5E,UAAU;QACd,IAAI,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAEO,GAAG,CAAC,aAAqB;QAC7B,OAAO,aAAa,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,CAAC;CACJ"}

package/dist/teams-sdk.d.ts

@@ -0,0 +1,173 @@
+/**
+ * The injectable **Microsoft Teams calling-bot SDK seam** — the minimal set of operations
+ * {@link import('./teams-bridge.js').TeamsBridge} needs from Teams, declared as an interface so the driver
+ * builds and unit-tests against an in-memory fake with **no network and no real Teams / Azure
+ * Communication Services SDK**.
+ *
+ * ## Production binding (TODO at deployment)
+ * In production this interface is bound to the **Azure Communication Services (ACS) calling-bot** SDK
+ * plus the **Microsoft Graph cloud-communications API** (the `/communications/calls` "application-hosted
+ * media" bot model) so the bot can join a Teams meeting, pull per-participant PCM audio for diarization,
+ * push synthesized audio back, observe roster + raised-hand events, and post to the Teams meeting chat.
+ * The named operations map to the SDK as follows:
+ * - {@link join} / {@link leave} → the Graph `POST /communications/calls` (join meeting via the join
+ *   URL / meeting coordinates) and the call's `DELETE` (leave) lifecycle.
+ * - {@link sendAudioFrame} → the ACS application-hosted-media outbound audio-socket (the bot's voice in).
+ * - {@link onAudioFrame} → the ACS per-participant inbound audio-socket callback (the source of speaker
+ *   labels for diarization — Teams provides participant attribution on the media stream).
+ * - {@link onParticipantJoin} / {@link onParticipantLeave} / {@link getParticipants} → the call's
+ *   `participants` collection + the `participantsUpdated` change notifications.
+ * - {@link onHandRaise} → the meeting's raised-hand signal. ⚠️ Partial: Teams surfaces raised hands in
+ *   the meeting UI, but a clean per-participant *event* over the calling-bot API is not guaranteed on
+ *   every tenant/build; the adapter wires it where the platform exposes it and otherwise no-ops.
+ * - {@link postChatMessage} → the Graph `POST /chats/{id}/messages` against the meeting's chat thread.
+ * - {@link muteParticipant} → the call's `participant:mute` action (requires the bot be an organizer /
+ *   presenter with the relevant policy).
+ * - {@link onMeetingEnded} → the call's `callEnded` / `terminated` status notification.
+ *
+ * Binding the real SDK is a thin adapter that implements this interface; the driver and its tests do
+ * not change. **None of the ACS/Graph SDK types leak into this package.**
+ *
+ * See `/plans/realtime/realtime-bridges-architecture.md` §3, §8 (Microsoft Teams row) and
+ * `/guides/REALTIME_BRIDGES_GUIDE.md`.
+ */
+/** The role a Teams participant holds in the meeting, normalized to the bridge's participant roles. */
+export type TeamsParticipantRole = 'Organizer' | 'Presenter' | 'Attendee';
+/**
+ * One Teams meeting participant as the seam reports it. Platform-native and minimal — the driver maps
+ * this onto `BridgeParticipantInfo` / `BridgeMeetingParticipant`.
+ */
+export interface TeamsParticipant {
+    /** The Teams participant id (the call's participant identity / `id`, stable for their presence). */
+    ParticipantId: string;
+    /** The participant's display name as Teams reports it. */
+    DisplayName?: string;
+    /** The participant's meeting role. */
+    Role: TeamsParticipantRole;
+    /** Whether this participant is the bridge's own bot (so the driver can exclude it from diarization addressing). */
+    IsSelf?: boolean;
+}
+/** One frame of raw per-participant audio the seam surfaces for diarization + the agent's "hearing". */
+export interface TeamsAudioFrame {
+    /** Raw PCM audio bytes for this frame. */
+    Pcm: ArrayBuffer;
+    /** The Teams participant id this audio came from (the diarization speaker label). */
+    ParticipantId: string;
+    /** The participant's display name at capture time, when known. */
+    DisplayName?: string;
+    /** Optional epoch-ms capture timestamp. */
+    TimestampMs?: number;
+}
+/** Arguments to {@link ITeamsMeetingSdk.join} — what the bot needs to get into a Teams meeting. */
+export interface TeamsJoinArgs {
+    /** The Teams meeting join URL (the `https://teams.microsoft.com/l/meetup-join/...` link). */
+    JoinUrl: string;
+    /**
+     * The parsed meeting thread id (the chat/conversation id behind the join URL), when resolved
+     * upstream. Used for posting to the meeting chat and as a stable meeting coordinate.
+     */
+    ThreadId?: string;
+    /** The display name the bot appears as in the participant list. */
+    BotDisplayName: string;
+    /**
+     * The OAuth bearer / application token authorizing the bot's Graph + ACS calls. Resolved upstream
+     * via MJ's credential system; never inline secrets.
+     */
+    AccessToken?: string;
+    /** The Azure tenant id the meeting belongs to, when joining cross-tenant. */
+    TenantId?: string;
+}
+/** The handles the seam returns after a successful {@link ITeamsMeetingSdk.join}. */
+export interface TeamsJoinResult {
+    /** The bot's own participant id in the joined meeting. */
+    BotParticipantId: string;
+    /** The Teams call id the bot joined (the durable external connection id). */
+    CallId: string;
+}
+/**
+ * The minimal Microsoft Teams calling-bot SDK surface the {@link import('./teams-bridge.js').TeamsBridge}
+ * depends on. Production binds this to the real ACS calling-bot / Graph cloud-communications API; tests
+ * inject a `FakeTeamsSdk`.
+ */
+export interface ITeamsMeetingSdk {
+    /**
+     * Joins the Teams meeting and brings the bot online. Returns the bot's participant id + the call id.
+     *
+     * @param args Join parameters (join URL, thread id, bot name, auth).
+     * @returns The bot participant + call handles.
+     */
+    join(args: TeamsJoinArgs): Promise<TeamsJoinResult>;
+    /** Leaves the meeting (terminates the bot's call leg) and releases SDK resources. */
+    leave(): Promise<void>;
+    /**
+     * Sends one raw PCM audio frame as the bot's outbound audio (the agent's voice into the meeting),
+     * over the ACS application-hosted-media outbound audio socket.
+     *
+     * @param pcm The PCM audio bytes to send.
+     */
+    sendAudioFrame(pcm: ArrayBuffer): void;
+    /**
+     * Registers a callback for inbound raw per-participant audio frames (what the agent hears, carrying
+     * the speaker label for diarization). "Latest handler wins."
+     *
+     * @param cb Invoked with each inbound audio frame.
+     */
+    onAudioFrame(cb: (frame: TeamsAudioFrame) => void): void;
+    /**
+     * Registers a callback fired when a participant joins. "Latest handler wins."
+     *
+     * @param cb Invoked with the participant who joined.
+     */
+    onParticipantJoin(cb: (participant: TeamsParticipant) => void): void;
+    /**
+     * Registers a callback fired when a participant leaves. "Latest handler wins."
+     *
+     * @param cb Invoked with the participant id that left.
+     */
+    onParticipantLeave(cb: (participantId: string) => void): void;
+    /**
+     * Registers a callback for native raised-hand signals. "Latest handler wins."
+     *
+     * ⚠️ Teams raised-hand is partial over the calling-bot API: a clean per-participant event is not
+     * guaranteed on every tenant/build. The adapter wires this where the platform exposes it and the
+     * driver tolerates the signal never firing.
+     *
+     * @param cb Invoked with the participant id and whether the hand is now raised.
+     */
+    onHandRaise(cb: (participantId: string, raised: boolean) => void): void;
+    /**
+     * Returns the current participant roster (including the bot).
+     *
+     * @returns The current participants.
+     */
+    getParticipants(): Promise<TeamsParticipant[]>;
+    /**
+     * Posts a message to the Teams meeting chat thread (everyone).
+     *
+     * @param text The chat message text.
+     */
+    postChatMessage(text: string): Promise<void>;
+    /**
+     * Mutes a participant (requires the bot be an organizer/presenter with the relevant policy).
+     *
+     * @param participantId The participant to mute.
+     */
+    muteParticipant(participantId: string): Promise<void>;
+    /**
+     * Registers a callback fired when the meeting/call ends (organizer ended / call terminated).
+     * "Latest handler wins."
+     *
+     * @param cb Invoked when the meeting has ended.
+     */
+    onMeetingEnded(cb: () => void): void;
+}
+/**
+ * A factory that constructs an {@link ITeamsMeetingSdk} for a session — the creation seam (mirroring
+ * Gemini's `connectLiveSession`). Production supplies a factory that builds the real ACS calling-bot /
+ * Graph adapter from resolved config; tests supply one that returns a `FakeTeamsSdk`.
+ *
+ * @param config The resolved provider/session configuration (tenant, credential refs already resolved upstream).
+ * @returns The Teams SDK instance to drive the meeting with.
+ */
+export type TeamsMeetingSdkFactory = (config?: Record<string, unknown>) => ITeamsMeetingSdk;
+//# sourceMappingURL=teams-sdk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"teams-sdk.d.ts","sourceRoot":"","sources":["../src/teams-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,uGAAuG;AACvG,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAE1E;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,oGAAoG;IACpG,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,mHAAmH;IACnH,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wGAAwG;AACxG,MAAM,WAAW,eAAe;IAC5B,0CAA0C;IAC1C,GAAG,EAAE,WAAW,CAAC;IACjB,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,mGAAmG;AACnG,MAAM,WAAW,aAAa;IAC1B,6FAA6F;IAC7F,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC5B,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEpD,qFAAqF;IACrF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAEvC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI,CAAC;IAEzD;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,CAAC,WAAW,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;IAErE;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAE9D;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAExE;;;;OAIG;IACH,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE/C;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;;OAIG;IACH,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,gBAAgB,CAAC"}

package/dist/teams-sdk.js

@@ -0,0 +1,35 @@
+/**
+ * The injectable **Microsoft Teams calling-bot SDK seam** — the minimal set of operations
+ * {@link import('./teams-bridge.js').TeamsBridge} needs from Teams, declared as an interface so the driver
+ * builds and unit-tests against an in-memory fake with **no network and no real Teams / Azure
+ * Communication Services SDK**.
+ *
+ * ## Production binding (TODO at deployment)
+ * In production this interface is bound to the **Azure Communication Services (ACS) calling-bot** SDK
+ * plus the **Microsoft Graph cloud-communications API** (the `/communications/calls` "application-hosted
+ * media" bot model) so the bot can join a Teams meeting, pull per-participant PCM audio for diarization,
+ * push synthesized audio back, observe roster + raised-hand events, and post to the Teams meeting chat.
+ * The named operations map to the SDK as follows:
+ * - {@link join} / {@link leave} → the Graph `POST /communications/calls` (join meeting via the join
+ *   URL / meeting coordinates) and the call's `DELETE` (leave) lifecycle.
+ * - {@link sendAudioFrame} → the ACS application-hosted-media outbound audio-socket (the bot's voice in).
+ * - {@link onAudioFrame} → the ACS per-participant inbound audio-socket callback (the source of speaker
+ *   labels for diarization — Teams provides participant attribution on the media stream).
+ * - {@link onParticipantJoin} / {@link onParticipantLeave} / {@link getParticipants} → the call's
+ *   `participants` collection + the `participantsUpdated` change notifications.
+ * - {@link onHandRaise} → the meeting's raised-hand signal. ⚠️ Partial: Teams surfaces raised hands in
+ *   the meeting UI, but a clean per-participant *event* over the calling-bot API is not guaranteed on
+ *   every tenant/build; the adapter wires it where the platform exposes it and otherwise no-ops.
+ * - {@link postChatMessage} → the Graph `POST /chats/{id}/messages` against the meeting's chat thread.
+ * - {@link muteParticipant} → the call's `participant:mute` action (requires the bot be an organizer /
+ *   presenter with the relevant policy).
+ * - {@link onMeetingEnded} → the call's `callEnded` / `terminated` status notification.
+ *
+ * Binding the real SDK is a thin adapter that implements this interface; the driver and its tests do
+ * not change. **None of the ACS/Graph SDK types leak into this package.**
+ *
+ * See `/plans/realtime/realtime-bridges-architecture.md` §3, §8 (Microsoft Teams row) and
+ * `/guides/REALTIME_BRIDGES_GUIDE.md`.
+ */
+export {};
+//# sourceMappingURL=teams-sdk.js.map

package/dist/teams-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams-sdk.js","sourceRoot":"","sources":["../src/teams-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG"}

package/package.json

@@ -1,10 +1,35 @@
 {
   "name": "@memberjunction/ai-bridge-teams",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/ai-bridge-teams",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "type": "module",
+  "version": "5.41.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",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "start": "ts-node-dev src/index.ts",
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "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"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.11",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  }
 }