@memberjunction/ai-bridge-twilio 0.0.1 → 5.41.0

package/README.md

@@ -1,45 +1,108 @@
 # @memberjunction/ai-bridge-twilio
 
-## ⚠️ 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-twilio`
-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 **Twilio** Realtime Bridge driver — the first **telephony** bridge in MemberJunction's Realtime
+Bridges program, and the reference driver the RingCentral and Vonage telephony drivers copy. It connects
+the one realtime agent engine to a **phone call** over **Twilio Programmable Voice + Media Streams**:
+outbound dial, inbound DID routing, single-party audio in/out, DTMF send/receive, and call transfer — all
+behind an injectable telephony call SDK seam so the driver builds and unit-tests with **no network and no
+real Twilio client**.
+
+A phone call goes through the *same* transport seam as every meeting bridge — it is just a single-leg
+audio media source. Telephony is **audio only**: no video, no screen, and **no Meeting Controls /
+facilitator surface** (a 1:1 call has no roster to facilitate).
+
+See the [Realtime Bridges Guide](../../../../guides/REALTIME_BRIDGES_GUIDE.md) (§ Telephony bridges) and
+[`/plans/realtime/realtime-bridges-architecture.md`](../../../../plans/realtime/realtime-bridges-architecture.md)
+(§8 Twilio capability row, §9 Phase 6) for the full architecture.
+
+## Install
+
+```bash
+npm install @memberjunction/ai-bridge-twilio
+```
+
+## What it provides
+
+- **`TwilioBridge`** — `@RegisterClass(BaseRealtimeBridge, 'TwilioBridge')`. The `MJ: AI Bridge Providers`
+  row with `DriverClass = 'TwilioBridge'` resolves to this driver via the `ClassFactory`. It is a thin
+  subclass of [`BaseTelephonyBridge`](../../BridgeBase) — all call lifecycle, the audio media seam, DTMF,
+  transfer, the caller+agent roster, and capability gating are inherited. The driver only binds the Twilio
+  SDK factory.
+- **`TwilioCallSdk`** — the Twilio binding of the platform-agnostic `ITelephonyCallSdk` seam over Twilio
+  Programmable Voice + Media Streams. Ships **unbound** (every op throws "bind the real Twilio client")
+  until a deployment supplies `ITwilioClientBindings` over the real `twilio` SDK.
+- **`TwilioCallSdkFactory`** — the creation seam that builds a `TwilioCallSdk` from resolved config.
+
+## Capability coverage (the Twilio seed row)
+
+| Capability | Status |
+|---|---|
+| Outbound dial | ✅ |
+| Inbound DID routing | ✅ |
+| Invite (DID identity) | ✅ |
+| Audio in / out | ✅ |
+| DTMF send / receive | ✅ |
+| Call transfer | ✅ |
+| Video / screen | ➖ n/a — telephony is audio only (`SendMedia` no-ops video/screen out) |
+| Meeting Controls / facilitator | ➖ n/a — a 1:1 call has no roster (`GetMeetingControlsEventSource` → `null`) |
+| Recording | ➖ not enabled on the seed row — `StartRecording` stays capability-gated and throws |
+
+Capability gating is two-layer (defense-in-depth): the engine checks the provider's `SupportedFeatures`
+first, and the base re-asserts each flag with `RequireFeature` at the top of its overrides.
+
+## Outbound vs inbound
+
+The shipped `RealtimeBridgeContext` is a meeting-shaped contract with no `Direction` field, so the engine
+forwards the session's direction (and the agent's caller-id / the inbound call id) into the driver's
+`Configuration`:
+
+| Config key | Purpose |
+|---|---|
+| `Direction` | `'Outbound'` (default) → `sdk.dial(to, from)`; `'Inbound'` → `sdk.answer(callId)` |
+| `FromNumber` | the agent's Twilio number / DID outbound calls originate from |
+| `InboundCallId` | the platform Call SID of the inbound call to answer (from the inbound webhook) |
+
+`Connect` requires `AudioIn` + `AudioOut`; outbound additionally requires `OutboundDial`, inbound requires
+`InboundRouting`.
+
+## The Twilio binding (deployment TODO)
+
+`TwilioCallSdk` maps the telephony seam onto Twilio's two halves — the **REST API** (place/modify/hang-up)
+and the **Media Streams** websocket (bidirectional realtime audio + DTMF):
+
+| `ITelephonyCallSdk` op | Twilio binding |
+|---|---|
+| `dial` (outbound) | REST `calls.create({ to, from, twiml })` with `<Connect><Stream>` to the Media-Streams websocket → Call SID |
+| `answer` (inbound) | the inbound voice webhook returns `<Connect><Stream>`; accept the Media-Streams websocket for the Call SID |
+| `hangup` | REST `calls(sid).update({ status: 'completed' })` |
+| `sendAudioFrame` | outbound Media-Streams `media` message (the agent's voice) |
+| `onAudioFrame` | inbound Media-Streams `media` events (single remote party) |
+| `sendDtmf` | REST `calls(sid).update` with `<Play digits>` / `<Dial sendDigits>` |
+| `onDtmf` | `<Gather input="dtmf">` webhook results or Media-Streams `dtmf` events |
+| `transfer` | REST `calls(sid).update({ twiml: '<Dial>+1…</Dial>' })` |
+| `onCallEnded` | the `status-callback` webhook (`completed`/`failed`/`canceled`) or the stream `stop` event |
+
+Out of the box `TwilioCallSdk` is **unbound** — every operation throws an explicit "bind the real Twilio
+client" error. Bind the real client by supplying an `ITwilioClientBindings` (REST + Media Streams) when
+constructing the SDK; the driver and its tests do not change, and **none of the `twilio` SDK's types leak
+into this package**. Credentials (Account SID, Auth Token, Media-Streams URL) resolve through MJ's
+credential system referenced by the provider `Configuration` — never inline secrets.
+
+## Usage (engine-driven)
+
+The bridge is not used directly — `AIBridgeEngine.StartBridgeSession` (`@memberjunction/ai-bridge-server`)
+resolves it from the provider's `DriverClass`, forwards the session `Direction` / caller-id into the
+driver config, and wires the transport seam to the injected `IRealtimeSession`. There is no channel host
+to wire for telephony (no Meeting Controls).
+
+## Testing
+
+`FakeTwilioCallSdk` (in `src/__tests__/`) is an in-memory `ITelephonyCallSdk` with drive helpers and
+capture sinks. The suite covers outbound dial → connect → audio round-trip (in/out), inbound answer, DTMF
+send + receive, transfer (gated), hangup + `onCallEnded`, the single caller+agent roster, capability
+gating (video/screen/Meeting Controls correctly absent), and the unbound-`TwilioCallSdk` bind-me throw —
+all with no network.
+
+```bash
+cd packages/AI/Providers/BridgeTwilio && npm run test
+```

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './twilio-call-sdk.js';
+export * from './twilio-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,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './twilio-call-sdk.js';
+export * from './twilio-bridge.js';
+import { LoadTwilioBridge } from './twilio-bridge.js';
+// Static reference so bundlers cannot tree-shake the @RegisterClass(BaseRealtimeBridge, 'TwilioBridge')
+// registration. Calling the no-op here keeps the driver resolvable by the engine's ClassFactory.
+LoadTwilioBridge();
+//# 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,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,wGAAwG;AACxG,iGAAiG;AACjG,gBAAgB,EAAE,CAAC"}

package/dist/twilio-bridge.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview `TwilioBridge` — the first telephony Realtime Bridge driver, connecting the one realtime
+ * agent engine to a **phone call over Twilio Programmable Voice + Media Streams**. It is the reference
+ * telephony driver the RingCentral + Vonage drivers copy.
+ *
+ * `TwilioBridge` is intentionally **thin**: nearly all behavior — outbound dial / inbound answer, the
+ * single-party audio media seam, DTMF send/receive, call transfer, the trivial caller+agent roster, and
+ * the capability gating — is inherited from {@link BaseTelephonyBridge} (`@memberjunction/ai-bridge-base`).
+ * The driver supplies only the **Twilio binding**: it points the base's SDK creation seam at the
+ * {@link TwilioCallSdkFactory}, which builds a {@link TwilioCallSdk} over the real Twilio client (REST +
+ * Media Streams). Until a real Twilio client is bound (a deployment concern), the SDK's operations throw
+ * an explicit "bind the real Twilio client" error, so `Connect` fails loudly rather than pretending.
+ *
+ * Twilio capability coverage (per the §8 seed row): inbound DID routing + outbound dial, audio in/out,
+ * DTMF, and call transfer. Telephony is **audio only** — no video, no screen, and no Meeting Controls /
+ * facilitator surface (a 1:1 call has no roster to facilitate). Those features are absent from the
+ * provider row, and the base's `GetMeetingControlsEventSource` returns `null`.
+ *
+ * @module @memberjunction/ai-bridge-twilio
+ * @author MemberJunction.com
+ */
+import { BaseTelephonyBridge } from '@memberjunction/ai-bridge-base';
+/**
+ * The `DriverClass` key {@link TwilioBridge} registers under. A `MJ: AI Bridge Providers` row with
+ * `DriverClass = 'TwilioBridge'` resolves to this driver via the `ClassFactory`.
+ */
+export declare const TWILIO_BRIDGE_DRIVER_CLASS = "TwilioBridge";
+/**
+ * Realtime Bridge driver for **Twilio** telephony (Programmable Voice + Media Streams).
+ *
+ * Construct the driver with the default constructor (the engine's `ClassFactory` path); it binds the
+ * {@link TwilioCallSdkFactory} so a real deployment only needs to wire the Twilio client behind it (or a
+ * test injects a `FakeTwilioCallSdk` via {@link BaseTelephonyBridge.SetSdkFactory}). Everything else is
+ * inherited from {@link BaseTelephonyBridge}.
+ *
+ * Registered via `@RegisterClass(BaseRealtimeBridge, 'TwilioBridge')` — the engine resolves any bridge
+ * driver against the `BaseRealtimeBridge` root, so a telephony driver registers under that same root.
+ */
+export declare class TwilioBridge extends BaseTelephonyBridge {
+    /**
+     * Wires the Twilio SDK factory onto the telephony base. The factory builds a {@link TwilioCallSdk}
+     * which — until a real Twilio client is bound — throws an explicit "bind the real Twilio client"
+     * error from every operation, so `Connect` fails loudly. A deployment binds the real client behind
+     * the factory; tests override it via {@link BaseTelephonyBridge.SetSdkFactory}.
+     */
+    constructor();
+}
+/**
+ * Tree-shaking-prevention loader. Modern bundlers cannot see the `@RegisterClass` dynamic registration
+ * of {@link TwilioBridge} 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 `'TwilioBridge'`.
+ */
+export declare function LoadTwilioBridge(): void;
+//# sourceMappingURL=twilio-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"twilio-bridge.d.ts","sourceRoot":"","sources":["../src/twilio-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAsB,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGzF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,qBACa,YAAa,SAAQ,mBAAmB;IACjD;;;;;OAKG;;CAKN;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/twilio-bridge.js

@@ -0,0 +1,75 @@
+/**
+ * @fileoverview `TwilioBridge` — the first telephony Realtime Bridge driver, connecting the one realtime
+ * agent engine to a **phone call over Twilio Programmable Voice + Media Streams**. It is the reference
+ * telephony driver the RingCentral + Vonage drivers copy.
+ *
+ * `TwilioBridge` is intentionally **thin**: nearly all behavior — outbound dial / inbound answer, the
+ * single-party audio media seam, DTMF send/receive, call transfer, the trivial caller+agent roster, and
+ * the capability gating — is inherited from {@link BaseTelephonyBridge} (`@memberjunction/ai-bridge-base`).
+ * The driver supplies only the **Twilio binding**: it points the base's SDK creation seam at the
+ * {@link TwilioCallSdkFactory}, which builds a {@link TwilioCallSdk} over the real Twilio client (REST +
+ * Media Streams). Until a real Twilio client is bound (a deployment concern), the SDK's operations throw
+ * an explicit "bind the real Twilio client" error, so `Connect` fails loudly rather than pretending.
+ *
+ * Twilio capability coverage (per the §8 seed row): inbound DID routing + outbound dial, audio in/out,
+ * DTMF, and call transfer. Telephony is **audio only** — no video, no screen, and no Meeting Controls /
+ * facilitator surface (a 1:1 call has no roster to facilitate). Those features are absent from the
+ * provider row, and the base's `GetMeetingControlsEventSource` returns `null`.
+ *
+ * @module @memberjunction/ai-bridge-twilio
+ * @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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { RegisterClass } from '@memberjunction/global';
+import { BaseRealtimeBridge, BaseTelephonyBridge } from '@memberjunction/ai-bridge-base';
+import { TwilioCallSdkFactory } from './twilio-call-sdk.js';
+/**
+ * The `DriverClass` key {@link TwilioBridge} registers under. A `MJ: AI Bridge Providers` row with
+ * `DriverClass = 'TwilioBridge'` resolves to this driver via the `ClassFactory`.
+ */
+export const TWILIO_BRIDGE_DRIVER_CLASS = 'TwilioBridge';
+/**
+ * Realtime Bridge driver for **Twilio** telephony (Programmable Voice + Media Streams).
+ *
+ * Construct the driver with the default constructor (the engine's `ClassFactory` path); it binds the
+ * {@link TwilioCallSdkFactory} so a real deployment only needs to wire the Twilio client behind it (or a
+ * test injects a `FakeTwilioCallSdk` via {@link BaseTelephonyBridge.SetSdkFactory}). Everything else is
+ * inherited from {@link BaseTelephonyBridge}.
+ *
+ * Registered via `@RegisterClass(BaseRealtimeBridge, 'TwilioBridge')` — the engine resolves any bridge
+ * driver against the `BaseRealtimeBridge` root, so a telephony driver registers under that same root.
+ */
+let TwilioBridge = class TwilioBridge extends BaseTelephonyBridge {
+    /**
+     * Wires the Twilio SDK factory onto the telephony base. The factory builds a {@link TwilioCallSdk}
+     * which — until a real Twilio client is bound — throws an explicit "bind the real Twilio client"
+     * error from every operation, so `Connect` fails loudly. A deployment binds the real client behind
+     * the factory; tests override it via {@link BaseTelephonyBridge.SetSdkFactory}.
+     */
+    constructor() {
+        super();
+        this.SetSdkFactory(TwilioCallSdkFactory);
+    }
+};
+TwilioBridge = __decorate([
+    RegisterClass(BaseRealtimeBridge, TWILIO_BRIDGE_DRIVER_CLASS),
+    __metadata("design:paramtypes", [])
+], TwilioBridge);
+export { TwilioBridge };
+/**
+ * Tree-shaking-prevention loader. Modern bundlers cannot see the `@RegisterClass` dynamic registration
+ * of {@link TwilioBridge} 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 `'TwilioBridge'`.
+ */
+export function LoadTwilioBridge() {
+    // Intentionally empty — referencing the module is what prevents tree-shaking.
+}
+//# sourceMappingURL=twilio-bridge.js.map

package/dist/twilio-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio-bridge.js","sourceRoot":"","sources":["../src/twilio-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC;AAEzD;;;;;;;;;;GAUG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,mBAAmB;IACjD;;;;;OAKG;IACH;QACI,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAC7C,CAAC;CACJ,CAAA;AAXY,YAAY;IADxB,aAAa,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;;GACjD,YAAY,CAWxB;;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC5B,8EAA8E;AAClF,CAAC"}

package/dist/twilio-call-sdk.d.ts

@@ -0,0 +1,167 @@
+/**
+ * @fileoverview The **Twilio** binding of the telephony call SDK seam — `TwilioCallSdk` +
+ * `TwilioCallSdkFactory`.
+ *
+ * {@link TwilioCallSdk} implements the platform-agnostic {@link ITelephonyCallSdk} (from
+ * `@memberjunction/ai-bridge-base`) over **Twilio Programmable Voice + Media Streams**, so
+ * {@link import('./twilio-bridge.js').TwilioBridge} drives a real phone call without ever importing the
+ * Twilio SDK directly. As shipped, every operation throws an explicit **"bind the real Twilio client"**
+ * error — the real Twilio binding is a documented deployment seam (below). Production supplies the bound
+ * client via {@link TwilioCallSdk}'s constructor / the factory; tests inject a `FakeTwilioCallSdk`.
+ *
+ * ## How the Twilio operations map (production binding — deployment TODO)
+ * Twilio has two halves: a **REST API** (place/modify/hang-up calls) and a **Media Streams** websocket
+ * (bidirectional realtime audio + DTMF events). This SDK adapter sits over both:
+ *
+ * | {@link ITelephonyCallSdk} op | Twilio binding |
+ * |---|---|
+ * | {@link TwilioCallSdk.dial} (outbound) | REST `client.calls.create({ to, from, twiml })` where the TwiML opens a bidirectional `<Connect><Stream>` to the Media-Streams websocket. Returns the Call SID. |
+ * | {@link TwilioCallSdk.answer} (inbound) | The inbound webhook (a call to the agent's DID) returns TwiML with `<Connect><Stream>`; "answering" = accepting that Media-Streams websocket for the delivered Call SID. |
+ * | {@link TwilioCallSdk.hangup} | REST `client.calls(callSid).update({ status: 'completed' })`. |
+ * | {@link TwilioCallSdk.sendAudioFrame} | A Media-Streams **outbound `media`** message (base64 μ-law/PCM payload) on the call's websocket — the agent's voice. |
+ * | {@link TwilioCallSdk.onAudioFrame} | Inbound Media-Streams **`media`** events on the websocket — what the agent hears (single remote party). |
+ * | {@link TwilioCallSdk.sendDtmf} | REST `client.calls(callSid).update({ twiml: '<Play digits="...">' })` (or a `<Dial>` `sendDigits`). |
+ * | {@link TwilioCallSdk.onDtmf} | `<Gather input="dtmf">` results delivered to the voice webhook, OR Media-Streams DTMF `dtmf` events. |
+ * | {@link TwilioCallSdk.transfer} | REST `client.calls(callSid).update({ twiml: '<Dial>+1...</Dial>' })` redirecting the live call. |
+ * | {@link TwilioCallSdk.onCallEnded} | The `status-callback` webhook for `completed` / `failed` / `canceled`, OR the Media-Streams `stop` event. |
+ *
+ * Binding the real Twilio client is a thin adapter that supplies an {@link ITwilioClientBindings}
+ * implementation (REST + websocket) to {@link TwilioCallSdk}; the driver and its tests do not change.
+ * **None of the `twilio` SDK's types leak into this package.**
+ *
+ * Credentials (Account SID, Auth Token, the Media-Streams websocket URL) resolve through MJ's credential
+ * system referenced by the provider `Configuration` — never inline secrets.
+ *
+ * @module @memberjunction/ai-bridge-twilio
+ * @see {@link ITelephonyCallSdk} — the platform-agnostic seam this binds.
+ * @see `/plans/realtime/realtime-bridges-architecture.md` §8 (Twilio capability row) and §9 Phase 6.
+ */
+import { ITelephonyCallSdk } from '@memberjunction/ai-bridge-base';
+/**
+ * The minimal Twilio client surface {@link TwilioCallSdk} drives. A production deployment implements
+ * this over the real `twilio` SDK (REST) + a Media-Streams websocket handler; this package never imports
+ * `twilio` so it builds and tests with no network. When no bindings are supplied, {@link TwilioCallSdk}
+ * throws the explicit "bind the real Twilio client" error from every operation.
+ *
+ * The shapes are intentionally tiny and provider-neutral at the value level (strings / byte buffers) so
+ * the Twilio SDK's types do not leak into the bridge package.
+ */
+export interface ITwilioClientBindings {
+    /**
+     * Places an outbound call via the Twilio REST API (`calls.create`) with TwiML that opens a
+     * bidirectional Media-Streams `<Connect><Stream>` to the agent's websocket.
+     *
+     * @param toNumber Destination number (E.164).
+     * @param fromNumber The agent's Twilio number / verified caller-id the call originates from.
+     * @param args Provider-specific options (status-callback URL, stream URL, recording flags, …).
+     * @returns The created Call SID.
+     */
+    createCall(toNumber: string, fromNumber: string, args?: Record<string, unknown>): Promise<string>;
+    /**
+     * Accepts the Media-Streams websocket for an inbound call already delivered by the voice webhook.
+     *
+     * @param callSid The inbound Call SID from the webhook.
+     */
+    acceptInbound(callSid: string): Promise<void>;
+    /**
+     * Ends the call (REST `calls(sid).update({ status: 'completed' })`).
+     *
+     * @param callSid The Call SID to complete.
+     */
+    completeCall(callSid: string): Promise<void>;
+    /**
+     * Pushes one outbound audio payload onto the call's Media-Streams websocket (the agent's voice).
+     *
+     * @param callSid The Call SID whose stream to write to.
+     * @param pcm The audio bytes (the adapter encodes to the Media-Streams μ-law/PCM `media` frame).
+     */
+    pushStreamAudio(callSid: string, pcm: ArrayBuffer): void;
+    /**
+     * Registers the inbound Media-Streams audio callback for the call (what the agent hears).
+     *
+     * @param callSid The Call SID whose inbound stream to subscribe to.
+     * @param cb Invoked with each inbound PCM audio frame.
+     */
+    onStreamAudio(callSid: string, cb: (pcm: ArrayBuffer) => void): void;
+    /**
+     * Sends DTMF digits on the call (REST `calls(sid).update` with `<Play digits>` / `<Dial sendDigits>`).
+     *
+     * @param callSid The Call SID.
+     * @param digits The DTMF digit string.
+     */
+    playDigits(callSid: string, digits: string): Promise<void>;
+    /**
+     * Registers the inbound DTMF callback (`<Gather>` webhook results or Media-Streams `dtmf` events).
+     *
+     * @param callSid The Call SID.
+     * @param cb Invoked with each received DTMF digit string.
+     */
+    onDigits(callSid: string, cb: (digits: string) => void): void;
+    /**
+     * Transfers the live call (REST `calls(sid).update({ twiml: '<Dial>...' })`).
+     *
+     * @param callSid The Call SID to redirect.
+     * @param toNumber The transfer destination.
+     */
+    redirectCall(callSid: string, toNumber: string): Promise<void>;
+    /**
+     * Registers the call-ended callback (status-callback `completed`/`failed`/`canceled` or stream `stop`).
+     *
+     * @param callSid The Call SID.
+     * @param cb Invoked when the call ends.
+     */
+    onCallStatus(callSid: string, cb: () => void): void;
+}
+/**
+ * Twilio's implementation of the {@link ITelephonyCallSdk} telephony seam over **Twilio Programmable
+ * Voice + Media Streams**. {@link import('./twilio-bridge.js').TwilioBridge} drives this; production
+ * constructs it with real {@link ITwilioClientBindings}, tests inject a `FakeTwilioCallSdk` directly
+ * (no need for this adapter at all in tests).
+ *
+ * The adapter tracks the active Call SID so the per-call websocket / REST operations can be addressed.
+ * It never imports the `twilio` SDK — all Twilio specifics live behind {@link ITwilioClientBindings}.
+ */
+export declare class TwilioCallSdk implements ITelephonyCallSdk {
+    private readonly bindings;
+    /** The active call's SID once dialled/answered, so per-call operations can address it. */
+    private activeCallSid;
+    private audioCb?;
+    private dtmfCb?;
+    private endedCb?;
+    /**
+     * @param bindings The real Twilio client bindings (REST + Media Streams). Defaults to an unbound
+     *   implementation whose every method throws the explicit "bind the real Twilio client" error.
+     */
+    constructor(bindings?: ITwilioClientBindings);
+    /** @inheritdoc */
+    dial(toNumber: string, fromNumber: string, args?: Record<string, unknown>): Promise<string>;
+    /** @inheritdoc */
+    answer(callId: string): Promise<void>;
+    /** @inheritdoc */
+    hangup(callId: string): Promise<void>;
+    /** @inheritdoc */
+    sendAudioFrame(pcm: ArrayBuffer): void;
+    /** @inheritdoc */
+    onAudioFrame(cb: (pcm: ArrayBuffer) => void): void;
+    /** @inheritdoc */
+    sendDtmf(digits: string): Promise<void>;
+    /** @inheritdoc */
+    onDtmf(cb: (digits: string) => void): void;
+    /** @inheritdoc */
+    transfer(callId: string, toNumber: string): Promise<void>;
+    /** @inheritdoc */
+    onCallEnded(cb: () => void): void;
+    /** Binds the active Call SID and (re-)registers any handlers the driver set before the call existed. */
+    private bindCall;
+}
+/**
+ * Builds a {@link TwilioCallSdk} for a session — the Twilio creation seam. Production supplies a factory
+ * that constructs the SDK with real {@link ITwilioClientBindings} (built from the resolved provider
+ * `Configuration` — Account SID, Auth Token, Media-Streams URL, all resolved upstream). Out of the box
+ * this returns an **unbound** `TwilioCallSdk` whose operations throw until the real client is bound.
+ *
+ * @param _config The resolved provider/session configuration (credential refs already resolved upstream).
+ * @returns An (unbound) {@link TwilioCallSdk}. Override in deployment / inject a fake in tests.
+ */
+export declare const TwilioCallSdkFactory: (_config?: Record<string, unknown>) => TwilioCallSdk;
+//# sourceMappingURL=twilio-call-sdk.d.ts.map

package/dist/twilio-call-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio-call-sdk.d.ts","sourceRoot":"","sources":["../src/twilio-call-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;;;;;;OAQG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElG;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAEzD;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAAC;IAErE;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAE9D;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACvD;AA0BD;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,iBAAiB;IAYvC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAXrC,0FAA0F;IAC1F,OAAO,CAAC,aAAa,CAAuB;IAE5C,OAAO,CAAC,OAAO,CAAC,CAA6B;IAC7C,OAAO,CAAC,MAAM,CAAC,CAA2B;IAC1C,OAAO,CAAC,OAAO,CAAC,CAAa;IAE7B;;;OAGG;gBAC0B,QAAQ,GAAE,qBAAwC;IAE/E,kBAAkB;IACL,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxG,kBAAkB;IACL,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,kBAAkB;IACL,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,kBAAkB;IACX,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAM7C,kBAAkB;IACX,YAAY,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAOzD,kBAAkB;IACL,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD,kBAAkB;IACX,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAOjD,kBAAkB;IACL,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,kBAAkB;IACX,WAAW,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAOxC,wGAAwG;IACxG,OAAO,CAAC,QAAQ;CAYnB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,aAExE,CAAC"}

package/dist/twilio-call-sdk.js

@@ -0,0 +1,156 @@
+/**
+ * @fileoverview The **Twilio** binding of the telephony call SDK seam — `TwilioCallSdk` +
+ * `TwilioCallSdkFactory`.
+ *
+ * {@link TwilioCallSdk} implements the platform-agnostic {@link ITelephonyCallSdk} (from
+ * `@memberjunction/ai-bridge-base`) over **Twilio Programmable Voice + Media Streams**, so
+ * {@link import('./twilio-bridge.js').TwilioBridge} drives a real phone call without ever importing the
+ * Twilio SDK directly. As shipped, every operation throws an explicit **"bind the real Twilio client"**
+ * error — the real Twilio binding is a documented deployment seam (below). Production supplies the bound
+ * client via {@link TwilioCallSdk}'s constructor / the factory; tests inject a `FakeTwilioCallSdk`.
+ *
+ * ## How the Twilio operations map (production binding — deployment TODO)
+ * Twilio has two halves: a **REST API** (place/modify/hang-up calls) and a **Media Streams** websocket
+ * (bidirectional realtime audio + DTMF events). This SDK adapter sits over both:
+ *
+ * | {@link ITelephonyCallSdk} op | Twilio binding |
+ * |---|---|
+ * | {@link TwilioCallSdk.dial} (outbound) | REST `client.calls.create({ to, from, twiml })` where the TwiML opens a bidirectional `<Connect><Stream>` to the Media-Streams websocket. Returns the Call SID. |
+ * | {@link TwilioCallSdk.answer} (inbound) | The inbound webhook (a call to the agent's DID) returns TwiML with `<Connect><Stream>`; "answering" = accepting that Media-Streams websocket for the delivered Call SID. |
+ * | {@link TwilioCallSdk.hangup} | REST `client.calls(callSid).update({ status: 'completed' })`. |
+ * | {@link TwilioCallSdk.sendAudioFrame} | A Media-Streams **outbound `media`** message (base64 μ-law/PCM payload) on the call's websocket — the agent's voice. |
+ * | {@link TwilioCallSdk.onAudioFrame} | Inbound Media-Streams **`media`** events on the websocket — what the agent hears (single remote party). |
+ * | {@link TwilioCallSdk.sendDtmf} | REST `client.calls(callSid).update({ twiml: '<Play digits="...">' })` (or a `<Dial>` `sendDigits`). |
+ * | {@link TwilioCallSdk.onDtmf} | `<Gather input="dtmf">` results delivered to the voice webhook, OR Media-Streams DTMF `dtmf` events. |
+ * | {@link TwilioCallSdk.transfer} | REST `client.calls(callSid).update({ twiml: '<Dial>+1...</Dial>' })` redirecting the live call. |
+ * | {@link TwilioCallSdk.onCallEnded} | The `status-callback` webhook for `completed` / `failed` / `canceled`, OR the Media-Streams `stop` event. |
+ *
+ * Binding the real Twilio client is a thin adapter that supplies an {@link ITwilioClientBindings}
+ * implementation (REST + websocket) to {@link TwilioCallSdk}; the driver and its tests do not change.
+ * **None of the `twilio` SDK's types leak into this package.**
+ *
+ * Credentials (Account SID, Auth Token, the Media-Streams websocket URL) resolve through MJ's credential
+ * system referenced by the provider `Configuration` — never inline secrets.
+ *
+ * @module @memberjunction/ai-bridge-twilio
+ * @see {@link ITelephonyCallSdk} — the platform-agnostic seam this binds.
+ * @see `/plans/realtime/realtime-bridges-architecture.md` §8 (Twilio capability row) and §9 Phase 6.
+ */
+/** The default bindings used when none are supplied — every operation throws the bind-me error. */
+const UNBOUND_BINDINGS = {
+    createCall: () => throwUnbound('createCall (outbound dial)'),
+    acceptInbound: () => throwUnbound('acceptInbound (inbound answer)'),
+    completeCall: () => throwUnbound('completeCall (hangup)'),
+    pushStreamAudio: () => throwUnboundVoid('pushStreamAudio (outbound media)'),
+    onStreamAudio: () => throwUnboundVoid('onStreamAudio (inbound media)'),
+    playDigits: () => throwUnbound('playDigits (send DTMF)'),
+    onDigits: () => throwUnboundVoid('onDigits (receive DTMF)'),
+    redirectCall: () => throwUnbound('redirectCall (transfer)'),
+    onCallStatus: () => throwUnboundVoid('onCallStatus (call ended)'),
+};
+function throwUnbound(op) {
+    throw new Error(`TwilioCallSdk has no real Twilio client bound (operation '${op}'). Construct it with an ` +
+        'ITwilioClientBindings over the real twilio SDK (REST + Media Streams), or inject a fake in tests.');
+}
+function throwUnboundVoid(op) {
+    throwUnbound(op);
+}
+/**
+ * Twilio's implementation of the {@link ITelephonyCallSdk} telephony seam over **Twilio Programmable
+ * Voice + Media Streams**. {@link import('./twilio-bridge.js').TwilioBridge} drives this; production
+ * constructs it with real {@link ITwilioClientBindings}, tests inject a `FakeTwilioCallSdk` directly
+ * (no need for this adapter at all in tests).
+ *
+ * The adapter tracks the active Call SID so the per-call websocket / REST operations can be addressed.
+ * It never imports the `twilio` SDK — all Twilio specifics live behind {@link ITwilioClientBindings}.
+ */
+export class TwilioCallSdk {
+    /**
+     * @param bindings The real Twilio client bindings (REST + Media Streams). Defaults to an unbound
+     *   implementation whose every method throws the explicit "bind the real Twilio client" error.
+     */
+    constructor(bindings = UNBOUND_BINDINGS) {
+        this.bindings = bindings;
+        /** The active call's SID once dialled/answered, so per-call operations can address it. */
+        this.activeCallSid = null;
+    }
+    /** @inheritdoc */
+    async dial(toNumber, fromNumber, args) {
+        const sid = await this.bindings.createCall(toNumber, fromNumber, args);
+        this.bindCall(sid);
+        return sid;
+    }
+    /** @inheritdoc */
+    async answer(callId) {
+        await this.bindings.acceptInbound(callId);
+        this.bindCall(callId);
+    }
+    /** @inheritdoc */
+    async hangup(callId) {
+        await this.bindings.completeCall(callId);
+        this.activeCallSid = null;
+    }
+    /** @inheritdoc */
+    sendAudioFrame(pcm) {
+        if (this.activeCallSid) {
+            this.bindings.pushStreamAudio(this.activeCallSid, pcm);
+        }
+    }
+    /** @inheritdoc */
+    onAudioFrame(cb) {
+        this.audioCb = cb;
+        if (this.activeCallSid) {
+            this.bindings.onStreamAudio(this.activeCallSid, cb);
+        }
+    }
+    /** @inheritdoc */
+    async sendDtmf(digits) {
+        if (this.activeCallSid) {
+            await this.bindings.playDigits(this.activeCallSid, digits);
+        }
+    }
+    /** @inheritdoc */
+    onDtmf(cb) {
+        this.dtmfCb = cb;
+        if (this.activeCallSid) {
+            this.bindings.onDigits(this.activeCallSid, cb);
+        }
+    }
+    /** @inheritdoc */
+    async transfer(callId, toNumber) {
+        await this.bindings.redirectCall(callId, toNumber);
+    }
+    /** @inheritdoc */
+    onCallEnded(cb) {
+        this.endedCb = cb;
+        if (this.activeCallSid) {
+            this.bindings.onCallStatus(this.activeCallSid, cb);
+        }
+    }
+    /** Binds the active Call SID and (re-)registers any handlers the driver set before the call existed. */
+    bindCall(callSid) {
+        this.activeCallSid = callSid;
+        if (this.audioCb) {
+            this.bindings.onStreamAudio(callSid, this.audioCb);
+        }
+        if (this.dtmfCb) {
+            this.bindings.onDigits(callSid, this.dtmfCb);
+        }
+        if (this.endedCb) {
+            this.bindings.onCallStatus(callSid, this.endedCb);
+        }
+    }
+}
+/**
+ * Builds a {@link TwilioCallSdk} for a session — the Twilio creation seam. Production supplies a factory
+ * that constructs the SDK with real {@link ITwilioClientBindings} (built from the resolved provider
+ * `Configuration` — Account SID, Auth Token, Media-Streams URL, all resolved upstream). Out of the box
+ * this returns an **unbound** `TwilioCallSdk` whose operations throw until the real client is bound.
+ *
+ * @param _config The resolved provider/session configuration (credential refs already resolved upstream).
+ * @returns An (unbound) {@link TwilioCallSdk}. Override in deployment / inject a fake in tests.
+ */
+export const TwilioCallSdkFactory = (_config) => {
+    return new TwilioCallSdk();
+};
+//# sourceMappingURL=twilio-call-sdk.js.map

package/dist/twilio-call-sdk.js.map

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

package/package.json

@@ -1,10 +1,35 @@
 {
   "name": "@memberjunction/ai-bridge-twilio",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/ai-bridge-twilio",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "type": "module",
+  "version": "5.41.0",
+  "description": "MemberJunction: Twilio Realtime Bridge driver (telephony). Connects the realtime agent engine to a phone call over Twilio Programmable Voice + Media Streams — outbound dial, inbound DID routing, single-party audio in/out, DTMF send/receive, and call transfer — via an injectable telephony call SDK seam. Audio only: no video, no screen, no Meeting Controls.",
+  "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"
+  }
 }