@memberjunction/ai-bridge-webex 0.0.1 → 5.41.0

package/README.md

@@ -1,45 +1,112 @@
 # @memberjunction/ai-bridge-webex
 
-## ⚠️ 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-webex`
-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 **Cisco Webex** Realtime Bridge driver in MemberJunction's Realtime Bridges program. It connects
+the one realtime agent engine to a **Webex meeting**: bidirectional audio, a diarized participant roster,
+participant mute, Webex meeting chat, and a **Meeting Controls** facilitator channel — all behind an
+injectable Cisco Webex Meetings SDK seam so the driver builds and unit-tests with **no network and no real
+Cisco Webex Meetings SDK**. It is a structural mirror of the reference
+[`@memberjunction/ai-bridge-zoom`](../BridgeZoom/README.md) driver (and its sibling
+[`@memberjunction/ai-bridge-teams`](../BridgeTeams/README.md)).
+
+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 Cisco Webex capability row) for the full architecture.
+
+## Install
+
+```bash
+npm install @memberjunction/ai-bridge-webex
+```
+
+## What it provides
+
+- **`WebexBridge`** — `@RegisterClass(BaseRealtimeBridge, 'WebexBridge')`. The `MJ: AI Bridge Providers`
+  row with `DriverClass = 'WebexBridge'` resolves to this driver via the `ClassFactory`. Implements the
+  four `BaseRealtimeBridge` abstracts (`Connect` / `Disconnect` / `SendMedia` / `OnMedia`) and the
+  capability-gated virtuals Webex supports (`GetParticipants`, `OnParticipantChange`), plus
+  `GetMeetingControlsEventSource` for the facilitator channel and a `PostChatMessage` helper.
+- **`IWebexMeetingSdk`** — the **injectable seam** the driver depends on instead of the real SDK.
+- **`WebexMeetingControlsEventSource`** — 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 Cisco Webex seed row)
+
+| Capability | Status |
+|---|---|
+| On-demand + scheduled + 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) | ✅ |
+| Webex meeting chat | ✅ |
+| Native raised-hand | ⚠️ Partial — wired where the Meetings SDK surfaces it; tolerant of it never firing |
+| DTMF / call transfer / recording | ➖ not Webex-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.
+
+### Webex vs. Zoom capability differences
+
+Webex advertises everything Zoom does, **plus** `InviteJoin` and `InboundRouting` (the calendar-invite /
+inbound-routing UX), and its native raised-hand is **partial** rather than fully reliable. Unlike Teams,
+Webex does **not** advertise `NativeInvite`. Everything else (audio in/out, directional video/screen,
+diarized roster, mute, meeting chat) maps one-to-one onto the Zoom reference driver.
+
+## The Cisco Webex Meetings SDK seam (`IWebexMeetingSdk`)
+
+The driver never imports the real Webex SDK. It depends only on this minimal interface, named after
+Cisco Webex Meetings SDK / xAPI / Webex bot concepts:
+
+```typescript
+export interface IWebexMeetingSdk {
+    join(args: WebexJoinArgs): Promise<WebexJoinResult>;
+    leave(): Promise<void>;
+    sendAudioFrame(pcm: ArrayBuffer): void;                                 // agent's voice out (outbound audio track)
+    onAudioFrame(cb: (frame: WebexAudioFrame) => void): void;               // raw per-participant audio in (diarization)
+    onParticipantJoin(cb: (p: WebexParticipant) => void): void;
+    onParticipantLeave(cb: (id: string) => void): void;
+    onHandRaise(cb: (id: string, raised: boolean) => void): void;           // ⚠️ partial on Webex
+    getParticipants(): Promise<WebexParticipant[]>;
+    postChatMessage(text: string): Promise<void>;                           // Webex meeting space chat
+    muteParticipant(participantId: string): Promise<void>;
+    onMeetingEnded(cb: () => void): void;
+}
+```
+
+### Production binding (deployment TODO)
+
+In production this is bound to the **Cisco Webex Meetings SDK** (the embedded-app / Web / mobile Meetings
+SDK that joins the meeting and exposes media + the `members` roster) together with the **Webex bot
+framework** (Webex Messaging API for the in-meeting space chat) and, where a Webex room device is involved,
+the **xAPI** for participant actions. Supply a factory via the creation seam:
+
+```typescript
+import { WebexBridge } from '@memberjunction/ai-bridge-webex';
+
+// Once, where bridge drivers are configured:
+//   bridge.SetSdkFactory((config) => new RealWebexSdkAdapter(config));
+// The adapter implements IWebexMeetingSdk over the real Webex SDK. The driver + its tests do not change.
+```
+
+Out of the box, `WebexBridge` ships **without** the real SDK adapter — `Connect` throws an explicit
+"bind the real Cisco Webex SDK" error until `SetSdkFactory` is called. Tests inject a `FakeWebexSdk`.
+
+## 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
+
+`FakeWebexSdk` (in `src/__tests__/`) is an in-memory `IWebexMeetingSdk` with drive helpers and capture
+sinks. The suite covers connect/disconnect (incl. parsing the meeting number out of the join link),
+audio in→`OnMedia` (speaker labels) and out→seam, participant join/leave → roster + event source, native
+hand-raise → Meeting Controls perception, capability gating (a feature Webex lacks throws), and chat — all
+with no network.
+
+```bash
+cd packages/AI/Providers/BridgeWebex && npm run test
+```

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './webex-sdk.js';
+export * from './webex-meeting-controls.js';
+export * from './webex-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 './webex-sdk.js';
+export * from './webex-meeting-controls.js';
+export * from './webex-bridge.js';
+import { LoadWebexBridge } from './webex-bridge.js';
+// Static reference so bundlers cannot tree-shake the @RegisterClass(BaseRealtimeBridge, 'WebexBridge')
+// registration. Calling the no-op here keeps the driver resolvable by the engine's ClassFactory.
+LoadWebexBridge();
+//# 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/webex-bridge.d.ts

@@ -0,0 +1,156 @@
+/**
+ * @fileoverview `WebexBridge` — the **Cisco Webex** platform Realtime Bridge driver, connecting the
+ * one realtime agent engine to a **Webex meeting**. Implements the {@link BaseRealtimeBridge} contract
+ * against an injectable {@link IWebexMeetingSdk} seam so it builds + unit-tests with NO network and NO
+ * real Cisco Webex Meetings SDK (the Gemini `connectLiveSession` testability pattern). Structurally
+ * mirrors `ZoomBridge` / `TeamsBridge` (the reference drivers) — only the platform names + join-coordinate
+ * parsing differ.
+ *
+ * Webex capability coverage (per the §8 seed row): on-demand + scheduled + invite join, inbound routing,
+ * audio in/out (video/screen directional flags carried by transport), a diarized roster
+ * (`SpeakerDiarization`), participant mute + Webex meeting chat (via the Meeting Controls channel). Native
+ * raised-hand is ⚠️ partial over the Meetings SDK — wired where the platform surfaces it, tolerant of it
+ * never firing. Telephony features (DTMF / transfer / recording) are NOT Webex-meeting features here, so
+ * those virtual base methods keep throwing `BridgeCapabilityNotSupportedError`.
+ *
+ * @module @memberjunction/ai-bridge-webex
+ * @author MemberJunction.com
+ */
+import { BaseRealtimeBridge, BridgeConnectResult, BridgeDisconnectReason, BridgeMediaFrame, BridgeMediaTrackKind, BridgeParticipantInfo, RealtimeBridgeContext, IBridgeMeetingControlsEventSource } from '@memberjunction/ai-bridge-base';
+import { WebexMeetingSdkFactory } from './webex-sdk.js';
+/**
+ * The `DriverClass` key {@link WebexBridge} registers under. A `MJ: AI Bridge Providers` row with
+ * `DriverClass = 'WebexBridge'` resolves to this driver via the `ClassFactory`.
+ */
+export declare const WEBEX_BRIDGE_DRIVER_CLASS = "WebexBridge";
+/**
+ * Realtime Bridge driver for **Cisco Webex meetings**.
+ *
+ * Construct the driver with the default constructor (the engine's `ClassFactory` path) — it lazily
+ * builds the Webex SDK from the {@link sdkFactory} at {@link Connect} time. Tests inject a `FakeWebexSdk`
+ * by overriding the factory via {@link SetSdkFactory} (the creation seam) before connecting.
+ *
+ * Registered via `@RegisterClass(BaseRealtimeBridge, 'WebexBridge')`.
+ */
+export declare class WebexBridge extends BaseRealtimeBridge {
+    /** The live Webex SDK seam for this session, created at {@link Connect}. */
+    private sdk;
+    /** The bot's own member 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 Webex 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 `FakeWebexSdk`.
+     */
+    private sdkFactory;
+    /**
+     * Sets the {@link WebexMeetingSdkFactory} this driver uses to construct its SDK seam at connect —
+     * the creation seam (mirroring Gemini's overridable `connectLiveSession`). Production binds the
+     * real Cisco Webex Meetings SDK adapter here; tests inject a `FakeWebexSdk`.
+     *
+     * @param factory The factory that builds the {@link IWebexMeetingSdk} for a session.
+     */
+    SetSdkFactory(factory: WebexMeetingSdkFactory): void;
+    /**
+     * Joins the Webex 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 meeting link as `Address`, config).
+     * @returns The bot member + meeting (external connection) identifiers, persisted by the engine.
+     */
+    Connect(ctx: RealtimeBridgeContext): Promise<BridgeConnectResult>;
+    /**
+     * Leaves the Webex meeting and releases all SDK resources. Tolerant of teardown errors.
+     *
+     * @param _reason Why the disconnect happened (Webex 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-track
+     * 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 Webex member 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 members.
+     * @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 member 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 Webex 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 Webex meeting space 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 member 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 member 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 Webex)
+     * 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 link). */
+    private buildJoinArgs;
+    /**
+     * Extracts the Webex meeting number from a meeting link when present, else `undefined`. Webex meeting
+     * numbers are 9–11 digit strings carried in the join URL (e.g. as a `MTID`/`/j.php?MTID=...` query
+     * param or a trailing numeric segment of a personal-room / scheduled link). Tolerant — a non-matching
+     * address yields `undefined` so the SDK can resolve coordinates itself.
+     */
+    private parseMeetingNumber;
+    /** 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 WebexBridge} 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 `'WebexBridge'`.
+ */
+export declare function LoadWebexBridge(): void;
+//# sourceMappingURL=webex-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webex-bridge.d.ts","sourceRoot":"","sources":["../src/webex-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,8EAA8E;IAC9E,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,oFAAoF;IACpF,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,sFAAsF;IACtF,OAAO,CAAC,aAAa;IAYrB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAmB1B,uFAAuF;IACvF,OAAO,CAAC,QAAQ;IAUhB,+FAA+F;IAC/F,OAAO,CAAC,YAAY;CAevB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/webex-bridge.js

@@ -0,0 +1,361 @@
+/**
+ * @fileoverview `WebexBridge` — the **Cisco Webex** platform Realtime Bridge driver, connecting the
+ * one realtime agent engine to a **Webex meeting**. Implements the {@link BaseRealtimeBridge} contract
+ * against an injectable {@link IWebexMeetingSdk} seam so it builds + unit-tests with NO network and NO
+ * real Cisco Webex Meetings SDK (the Gemini `connectLiveSession` testability pattern). Structurally
+ * mirrors `ZoomBridge` / `TeamsBridge` (the reference drivers) — only the platform names + join-coordinate
+ * parsing differ.
+ *
+ * Webex capability coverage (per the §8 seed row): on-demand + scheduled + invite join, inbound routing,
+ * audio in/out (video/screen directional flags carried by transport), a diarized roster
+ * (`SpeakerDiarization`), participant mute + Webex meeting chat (via the Meeting Controls channel). Native
+ * raised-hand is ⚠️ partial over the Meetings SDK — wired where the platform surfaces it, tolerant of it
+ * never firing. Telephony features (DTMF / transfer / recording) are NOT Webex-meeting features here, so
+ * those virtual base methods keep throwing `BridgeCapabilityNotSupportedError`.
+ *
+ * @module @memberjunction/ai-bridge-webex
+ * @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 { WebexMeetingControlsEventSource } from './webex-meeting-controls.js';
+/**
+ * The `DriverClass` key {@link WebexBridge} registers under. A `MJ: AI Bridge Providers` row with
+ * `DriverClass = 'WebexBridge'` resolves to this driver via the `ClassFactory`.
+ */
+export const WEBEX_BRIDGE_DRIVER_CLASS = 'WebexBridge';
+/**
+ * Maps a Webex member role to the bridge's {@link BridgeParticipantRole}. The bot (`IsSelf`) is
+ * surfaced as `'Agent'`; Webex hosts/cohosts map to host/co-host.
+ */
+function mapParticipantRole(role, isSelf) {
+    if (isSelf) {
+        return 'Agent';
+    }
+    switch (role) {
+        case 'Host':
+            return 'Host';
+        case 'Cohost':
+            return 'CoHost';
+        default:
+            return 'Participant';
+    }
+}
+/** Maps a Webex member 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 **Cisco Webex meetings**.
+ *
+ * Construct the driver with the default constructor (the engine's `ClassFactory` path) — it lazily
+ * builds the Webex SDK from the {@link sdkFactory} at {@link Connect} time. Tests inject a `FakeWebexSdk`
+ * by overriding the factory via {@link SetSdkFactory} (the creation seam) before connecting.
+ *
+ * Registered via `@RegisterClass(BaseRealtimeBridge, 'WebexBridge')`.
+ */
+let WebexBridge = class WebexBridge extends BaseRealtimeBridge {
+    constructor() {
+        super(...arguments);
+        /** The live Webex SDK seam for this session, created at {@link Connect}. */
+        this.sdk = null;
+        /** The bot's own member 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 Webex 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 `FakeWebexSdk`.
+         */
+        this.sdkFactory = () => {
+            throw new Error('WebexBridge has no Cisco Webex SDK bound. Call WebexBridge.SetSdkFactory(...) with a factory ' +
+                'that builds an IWebexMeetingSdk over the real Cisco Webex Meetings SDK / Webex bot framework, ' +
+                'or inject a fake in tests.');
+        };
+    }
+    /**
+     * Sets the {@link WebexMeetingSdkFactory} this driver uses to construct its SDK seam at connect —
+     * the creation seam (mirroring Gemini's overridable `connectLiveSession`). Production binds the
+     * real Cisco Webex Meetings SDK adapter here; tests inject a `FakeWebexSdk`.
+     *
+     * @param factory The factory that builds the {@link IWebexMeetingSdk} for a session.
+     */
+    SetSdkFactory(factory) {
+        this.sdkFactory = factory;
+    }
+    // ── Abstract — every bridge MUST implement ───────────────────────────────────────
+    /**
+     * Joins the Webex 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 meeting link as `Address`, config).
+     * @returns The bot member + meeting (external connection) identifiers, persisted by the engine.
+     */
+    async Connect(ctx) {
+        this.applyContext(ctx);
+        this.RequireFeature('AudioIn'); // a Webex 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 WebexMeetingControlsEventSource(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.MeetingId };
+    }
+    /**
+     * Leaves the Webex meeting and releases all SDK resources. Tolerant of teardown errors.
+     *
+     * @param _reason Why the disconnect happened (Webex 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(`[WebexBridge] 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-track
+     * 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 Webex supports (gated by SupportedFeatures) ──────────
+    /**
+     * Returns the current Webex member 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 members.
+     * @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 member 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 Webex 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;
+    }
+    // ── Webex-native surfaces (used by the channel plane / facilitator) ──────────────
+    /**
+     * Posts a message to the Webex meeting space 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(`[WebexBridge] postChatMessage failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** The bot's member 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 member 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 Webex)
+     * 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(`[WebexBridge] 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 link). */
+    buildJoinArgs(ctx) {
+        const config = ctx.Configuration ?? {};
+        return {
+            MeetingLink: ctx.Address,
+            MeetingNumber: typeof config.MeetingNumber === 'string' ? config.MeetingNumber : this.parseMeetingNumber(ctx.Address),
+            BotDisplayName: typeof config.BotDisplayName === 'string' ? config.BotDisplayName : `${ctx.ProviderName} Agent`,
+            AccessToken: typeof config.AccessToken === 'string' ? config.AccessToken : undefined,
+            SiteUrl: typeof config.SiteUrl === 'string' ? config.SiteUrl : undefined,
+        };
+    }
+    /**
+     * Extracts the Webex meeting number from a meeting link when present, else `undefined`. Webex meeting
+     * numbers are 9–11 digit strings carried in the join URL (e.g. as a `MTID`/`/j.php?MTID=...` query
+     * param or a trailing numeric segment of a personal-room / scheduled link). Tolerant — a non-matching
+     * address yields `undefined` so the SDK can resolve coordinates itself.
+     */
+    parseMeetingNumber(address) {
+        if (!address) {
+            return undefined;
+        }
+        const decoded = (() => {
+            try {
+                return decodeURIComponent(address);
+            }
+            catch {
+                return address;
+            }
+        })();
+        // A 9–11 digit run is the Webex meeting number; prefer the longest match in the link.
+        const matches = decoded.match(/\d{9,11}/g);
+        if (!matches || matches.length === 0) {
+            return undefined;
+        }
+        return matches.reduce((longest, cur) => (cur.length > longest.length ? cur : longest));
+    }
+    /** 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;
+    }
+};
+WebexBridge = __decorate([
+    RegisterClass(BaseRealtimeBridge, WEBEX_BRIDGE_DRIVER_CLASS)
+], WebexBridge);
+export { WebexBridge };
+/**
+ * Tree-shaking-prevention loader. Modern bundlers cannot see the `@RegisterClass` dynamic registration
+ * of {@link WebexBridge} 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 `'WebexBridge'`.
+ */
+export function LoadWebexBridge() {
+    // Intentionally empty — referencing the module is what prevents tree-shaking.
+}
+//# sourceMappingURL=webex-bridge.js.map

package/dist/webex-bridge.js.map

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

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

@@ -0,0 +1,80 @@
+/**
+ * Adapts the {@link IWebexMeetingSdk} member / 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 Webex session. This is
+ * the §4b "the bridge contributes a channel" pattern realized for Webex — no channel logic lives here,
+ * only the platform→channel signal mapping.
+ */
+import { IBridgeMeetingControlsEventSource, BridgeMeetingParticipant, BridgeMeetingControlsCapability } from '@memberjunction/ai-bridge-base';
+import { IWebexMeetingSdk, WebexParticipant } from './webex-sdk.js';
+/** Maps one Webex member onto the channel's {@link BridgeMeetingParticipant} shape. */
+export declare function toMeetingParticipant(p: WebexParticipant): BridgeMeetingParticipant;
+/**
+ * Webex'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 `WebexBridge.GetMeetingControlsEventSource`.
+ */
+export declare class WebexMeetingControlsEventSource implements IBridgeMeetingControlsEventSource {
+    private readonly sdk;
+    /** Live roster keyed by member id (lowercased), kept current by the driver's {@link IngestRoster}. */
+    private readonly roster;
+    private rosterHandler?;
+    private speakingHandler?;
+    private handRaiseHandler?;
+    /** Webex supports host/cohost-driven mute, so the facilitator `MuteParticipant` tool is offered. */
+    readonly Capabilities: ReadonlyArray<BridgeMeetingControlsCapability>;
+    /**
+     * @param sdk The Webex 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: IWebexMeetingSdk);
+    /**
+     * 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 member join/leave.
+     *
+     * @param participants The full current Webex roster.
+     */
+    IngestRoster(participants: WebexParticipant[]): void;
+    /**
+     * Forwards a native hand-raise/lower signal from the driver to the channel.
+     *
+     * ⚠️ Webex raised-hand is partial; this may never fire on clients/builds that don't surface the
+     * event over the Meetings SDK. The channel degrades gracefully (its software hand-raise still works).
+     *
+     * @param participantId The member 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=webex-meeting-controls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webex-meeting-controls.d.ts","sourceRoot":"","sources":["../src/webex-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,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,gBAAgB,GAAG,wBAAwB,CAOlF;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,+BAAgC,YAAW,iCAAiC;IAezE,OAAO,CAAC,QAAQ,CAAC,GAAG;IAdhC,sGAAsG;IACtG,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,oGAAoG;IACpG,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/webex-meeting-controls.js

@@ -0,0 +1,130 @@
+/**
+ * Adapts the {@link IWebexMeetingSdk} member / 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 Webex session. This is
+ * the §4b "the bridge contributes a channel" pattern realized for Webex — no channel logic lives here,
+ * only the platform→channel signal mapping.
+ */
+/**
+ * Maps a Webex member role to the bridge's meeting-participant role. Webex has no distinct "Agent"
+ * role; the bot is flagged via `IsSelf` and surfaced as `'Agent'`. Webex hosts/cohosts 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 'Host':
+            return 'Host';
+        case 'Cohost':
+            return 'CoHost';
+        default:
+            return 'Participant';
+    }
+}
+/** Maps one Webex member 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,
+    };
+}
+/**
+ * Webex'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 `WebexBridge.GetMeetingControlsEventSource`.
+ */
+export class WebexMeetingControlsEventSource {
+    /**
+     * @param sdk The Webex 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 member id (lowercased), kept current by the driver's {@link IngestRoster}. */
+        this.roster = new Map();
+        /** Webex supports host/cohost-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 member join/leave.
+     *
+     * @param participants The full current Webex 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.
+     *
+     * ⚠️ Webex raised-hand is partial; this may never fire on clients/builds that don't surface the
+     * event over the Meetings SDK. The channel degrades gracefully (its software hand-raise still works).
+     *
+     * @param participantId The member 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=webex-meeting-controls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webex-meeting-controls.js","sourceRoot":"","sources":["../src/webex-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,MAAM;YACP,OAAO,MAAM,CAAC;QAClB,KAAK,QAAQ;YACT,OAAO,QAAQ,CAAC;QACpB;YACI,OAAO,aAAa,CAAC;IAC7B,CAAC;AACL,CAAC;AAED,uFAAuF;AACvF,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,sGAAsG;QACrF,WAAM,GAAG,IAAI,GAAG,EAAoC,CAAC;QAMtE,oGAAoG;QACpF,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/webex-sdk.d.ts

@@ -0,0 +1,174 @@
+/**
+ * The injectable **Cisco Webex Meetings SDK seam** — the minimal set of operations
+ * {@link import('./webex-bridge.js').WebexBridge} needs from Webex, declared as an interface so the driver
+ * builds and unit-tests against an in-memory fake with **no network and no real Cisco Webex Meetings SDK
+ * / xAPI / Webex bot framework**.
+ *
+ * ## Production binding (TODO at deployment)
+ * In production this interface is bound to the **Cisco Webex Meetings SDK** (the embedded-app / Web /
+ * mobile Meetings SDK that joins a meeting and exposes media + roster) together with the **Webex bot
+ * framework** (Webex Messaging API, for posting to the meeting/space) and, where a Webex room device is
+ * involved, the **xAPI** (the device control surface for participant actions). The named operations map
+ * to the SDK as follows:
+ * - {@link join} / {@link leave} → the Webex Meetings SDK `Meeting.join()` / `Meeting.leave()` lifecycle
+ *   (the bot/app joins via the meeting link, SIP address, or meeting number).
+ * - {@link sendAudioFrame} → the Meetings SDK outbound audio media track (the bot's voice into the meeting).
+ * - {@link onAudioFrame} → the Meetings SDK per-participant inbound audio media callback (the source of
+ *   speaker labels for diarization — Webex attributes media to a `Member`).
+ * - {@link onParticipantJoin} / {@link onParticipantLeave} / {@link getParticipants} → the meeting's
+ *   `members` collection + the `members:update` change events.
+ * - {@link onHandRaise} → the Webex raised-hand reaction. ⚠️ Partial: Webex surfaces raised hands in the
+ *   meeting UI, but a clean per-participant *event* over the Meetings SDK is not guaranteed on every
+ *   client/build; the adapter wires it where the platform exposes it and otherwise no-ops.
+ * - {@link postChatMessage} → the Webex Messaging API `POST /messages` against the meeting's associated
+ *   space (the in-meeting chat thread).
+ * - {@link muteParticipant} → the meeting's `Member.mute` action / device xAPI mute (requires the bot be
+ *   a host / cohost with the relevant privilege).
+ * - {@link onMeetingEnded} → the meeting's `meeting:ended` / `state` → `ENDED` notification.
+ *
+ * Binding the real SDK is a thin adapter that implements this interface; the driver and its tests do
+ * not change. **None of the Webex SDK types leak into this package.**
+ *
+ * See `/plans/realtime/realtime-bridges-architecture.md` §3, §8 (Cisco Webex row) and
+ * `/guides/REALTIME_BRIDGES_GUIDE.md`.
+ */
+/** The role a Webex member holds in the meeting, normalized to the bridge's participant roles. */
+export type WebexParticipantRole = 'Host' | 'Cohost' | 'Attendee';
+/**
+ * One Webex meeting member as the seam reports it. Platform-native and minimal — the driver maps
+ * this onto `BridgeParticipantInfo` / `BridgeMeetingParticipant`.
+ */
+export interface WebexParticipant {
+    /** The Webex member id (the meeting `Member.id`, stable for their presence). */
+    ParticipantId: string;
+    /** The member's display name as Webex reports it. */
+    DisplayName?: string;
+    /** The member's meeting role. */
+    Role: WebexParticipantRole;
+    /** Whether this member 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 WebexAudioFrame {
+    /** Raw PCM audio bytes for this frame. */
+    Pcm: ArrayBuffer;
+    /** The Webex member id this audio came from (the diarization speaker label). */
+    ParticipantId: string;
+    /** The member's display name at capture time, when known. */
+    DisplayName?: string;
+    /** Optional epoch-ms capture timestamp. */
+    TimestampMs?: number;
+}
+/** Arguments to {@link IWebexMeetingSdk.join} — what the bot needs to get into a Webex meeting. */
+export interface WebexJoinArgs {
+    /** The Webex meeting link (the `https://*.webex.com/meet/...` / `.../join/...` URL). */
+    MeetingLink: string;
+    /**
+     * The parsed Webex meeting number / SIP address (the durable meeting coordinate behind the link),
+     * when resolved upstream. Used as a stable meeting identifier when the link is opaque.
+     */
+    MeetingNumber?: string;
+    /** The display name the bot appears as in the participant list. */
+    BotDisplayName: string;
+    /**
+     * The OAuth bearer / bot access token authorizing the bot's Webex Meetings + Messaging calls.
+     * Resolved upstream via MJ's credential system; never inline secrets.
+     */
+    AccessToken?: string;
+    /** The Webex site (org) the meeting belongs to, when joining cross-site. */
+    SiteUrl?: string;
+}
+/** The handles the seam returns after a successful {@link IWebexMeetingSdk.join}. */
+export interface WebexJoinResult {
+    /** The bot's own member id in the joined meeting. */
+    BotParticipantId: string;
+    /** The Webex meeting id the bot joined (the durable external connection id). */
+    MeetingId: string;
+}
+/**
+ * The minimal Cisco Webex Meetings SDK surface the {@link import('./webex-bridge.js').WebexBridge}
+ * depends on. Production binds this to the real Webex Meetings SDK / Webex bot framework; tests
+ * inject a `FakeWebexSdk`.
+ */
+export interface IWebexMeetingSdk {
+    /**
+     * Joins the Webex meeting and brings the bot online. Returns the bot's member id + the meeting id.
+     *
+     * @param args Join parameters (meeting link, meeting number, bot name, auth).
+     * @returns The bot member + meeting handles.
+     */
+    join(args: WebexJoinArgs): Promise<WebexJoinResult>;
+    /** Leaves the meeting (the bot's `Meeting.leave()`) 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 Webex Meetings SDK outbound audio media track.
+     *
+     * @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: WebexAudioFrame) => void): void;
+    /**
+     * Registers a callback fired when a member joins. "Latest handler wins."
+     *
+     * @param cb Invoked with the member who joined.
+     */
+    onParticipantJoin(cb: (participant: WebexParticipant) => void): void;
+    /**
+     * Registers a callback fired when a member leaves. "Latest handler wins."
+     *
+     * @param cb Invoked with the member id that left.
+     */
+    onParticipantLeave(cb: (participantId: string) => void): void;
+    /**
+     * Registers a callback for native raised-hand signals. "Latest handler wins."
+     *
+     * ⚠️ Webex raised-hand is partial over the Meetings SDK: a clean per-participant event is not
+     * guaranteed on every client/build. The adapter wires this where the platform exposes it and the
+     * driver tolerates the signal never firing.
+     *
+     * @param cb Invoked with the member id and whether the hand is now raised.
+     */
+    onHandRaise(cb: (participantId: string, raised: boolean) => void): void;
+    /**
+     * Returns the current member roster (including the bot).
+     *
+     * @returns The current members.
+     */
+    getParticipants(): Promise<WebexParticipant[]>;
+    /**
+     * Posts a message to the Webex meeting space chat (everyone).
+     *
+     * @param text The chat message text.
+     */
+    postChatMessage(text: string): Promise<void>;
+    /**
+     * Mutes a member (requires the bot be a host/cohost with the relevant privilege).
+     *
+     * @param participantId The member to mute.
+     */
+    muteParticipant(participantId: string): Promise<void>;
+    /**
+     * Registers a callback fired when the meeting ends (host ended / meeting state → ENDED).
+     * "Latest handler wins."
+     *
+     * @param cb Invoked when the meeting has ended.
+     */
+    onMeetingEnded(cb: () => void): void;
+}
+/**
+ * A factory that constructs an {@link IWebexMeetingSdk} for a session — the creation seam (mirroring
+ * Gemini's `connectLiveSession`). Production supplies a factory that builds the real Webex Meetings SDK /
+ * Webex bot adapter from resolved config; tests supply one that returns a `FakeWebexSdk`.
+ *
+ * @param config The resolved provider/session configuration (site, credential refs already resolved upstream).
+ * @returns The Webex SDK instance to drive the meeting with.
+ */
+export type WebexMeetingSdkFactory = (config?: Record<string, unknown>) => IWebexMeetingSdk;
+//# sourceMappingURL=webex-sdk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webex-sdk.d.ts","sourceRoot":"","sources":["../src/webex-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,kGAAkG;AAClG,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,8GAA8G;IAC9G,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wGAAwG;AACxG,MAAM,WAAW,eAAe;IAC5B,0CAA0C;IAC1C,GAAG,EAAE,WAAW,CAAC;IACjB,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,mGAAmG;AACnG,MAAM,WAAW,aAAa;IAC1B,wFAAwF;IACxF,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC5B,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEpD,mFAAmF;IACnF,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/webex-sdk.js

@@ -0,0 +1,36 @@
+/**
+ * The injectable **Cisco Webex Meetings SDK seam** — the minimal set of operations
+ * {@link import('./webex-bridge.js').WebexBridge} needs from Webex, declared as an interface so the driver
+ * builds and unit-tests against an in-memory fake with **no network and no real Cisco Webex Meetings SDK
+ * / xAPI / Webex bot framework**.
+ *
+ * ## Production binding (TODO at deployment)
+ * In production this interface is bound to the **Cisco Webex Meetings SDK** (the embedded-app / Web /
+ * mobile Meetings SDK that joins a meeting and exposes media + roster) together with the **Webex bot
+ * framework** (Webex Messaging API, for posting to the meeting/space) and, where a Webex room device is
+ * involved, the **xAPI** (the device control surface for participant actions). The named operations map
+ * to the SDK as follows:
+ * - {@link join} / {@link leave} → the Webex Meetings SDK `Meeting.join()` / `Meeting.leave()` lifecycle
+ *   (the bot/app joins via the meeting link, SIP address, or meeting number).
+ * - {@link sendAudioFrame} → the Meetings SDK outbound audio media track (the bot's voice into the meeting).
+ * - {@link onAudioFrame} → the Meetings SDK per-participant inbound audio media callback (the source of
+ *   speaker labels for diarization — Webex attributes media to a `Member`).
+ * - {@link onParticipantJoin} / {@link onParticipantLeave} / {@link getParticipants} → the meeting's
+ *   `members` collection + the `members:update` change events.
+ * - {@link onHandRaise} → the Webex raised-hand reaction. ⚠️ Partial: Webex surfaces raised hands in the
+ *   meeting UI, but a clean per-participant *event* over the Meetings SDK is not guaranteed on every
+ *   client/build; the adapter wires it where the platform exposes it and otherwise no-ops.
+ * - {@link postChatMessage} → the Webex Messaging API `POST /messages` against the meeting's associated
+ *   space (the in-meeting chat thread).
+ * - {@link muteParticipant} → the meeting's `Member.mute` action / device xAPI mute (requires the bot be
+ *   a host / cohost with the relevant privilege).
+ * - {@link onMeetingEnded} → the meeting's `meeting:ended` / `state` → `ENDED` notification.
+ *
+ * Binding the real SDK is a thin adapter that implements this interface; the driver and its tests do
+ * not change. **None of the Webex SDK types leak into this package.**
+ *
+ * See `/plans/realtime/realtime-bridges-architecture.md` §3, §8 (Cisco Webex row) and
+ * `/guides/REALTIME_BRIDGES_GUIDE.md`.
+ */
+export {};
+//# sourceMappingURL=webex-sdk.js.map

package/dist/webex-sdk.js.map

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

package/package.json

@@ -1,10 +1,35 @@
 {
   "name": "@memberjunction/ai-bridge-webex",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/ai-bridge-webex",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "type": "module",
+  "version": "5.41.0",
+  "description": "MemberJunction: Cisco Webex Realtime Bridge driver. Connects the realtime agent engine to a Webex meeting (audio in/out, diarized roster, participant mute, Webex meeting chat) via an injectable Cisco Webex Meetings SDK seam (Webex Meetings SDK / xAPI / Webex bot framework), and contributes a Meeting Controls facilitator channel.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "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"
+  }
 }