@memberjunction/ai-bridge-twilio 5.41.0 → 5.42.0

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export * from './twilio-call-sdk.js';
+export * from './twilio-native-call-sdk.js';
 export * from './twilio-bridge.js';
+export * from './register-native.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,7 +1,12 @@
 export * from './twilio-call-sdk.js';
+export * from './twilio-native-call-sdk.js';
 export * from './twilio-bridge.js';
+export * from './register-native.js';
 import { LoadTwilioBridge } from './twilio-bridge.js';
+import { RegisterTwilioNativeSdk } from './register-native.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();
+// Register Twilio's native two-way call-SDK binding so the engine auto-binds it at StartBridgeSession.
+RegisterTwilioNativeSdk();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,wGAAwG;AACxG,iGAAiG;AACjG,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,wGAAwG;AACxG,iGAAiG;AACjG,gBAAgB,EAAE,CAAC;AACnB,uGAAuG;AACvG,uBAAuB,EAAE,CAAC"}

package/dist/register-native.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Registers the Twilio **native two-way** call-SDK binding into the {@link BridgeNativeSdkRegistry}
+ * so `AIBridgeEngine.StartBridgeSession` auto-binds it onto a resolved `TwilioBridge` before connect — no
+ * per-deployment wiring needed. The typed downcast + `SetSdkFactory` stay confined here (where the concrete
+ * `TwilioBridge` type is known), keeping the engine seam free of provider types.
+ *
+ * A host can still override per-session via `StartBridgeSessionParams.BindSdk` — e.g. to inject a fake
+ * telephony SDK in a test instead of the native two-way default.
+ *
+ * @module @memberjunction/ai-bridge-twilio
+ * @author MemberJunction.com
+ */
+/**
+ * Registers Twilio's native two-way call binding. Idempotent (latest-wins in the registry), and invoked from
+ * the package `index.ts` so merely importing `@memberjunction/ai-bridge-twilio` wires the default binding.
+ * Also exported as a tree-shake-safe no-op-returning function callers can reference to force-retain the module.
+ */
+export declare function RegisterTwilioNativeSdk(): void;
+//# sourceMappingURL=register-native.d.ts.map

package/dist/register-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-native.d.ts","sourceRoot":"","sources":["../src/register-native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAS9C"}

package/dist/register-native.js

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Registers the Twilio **native two-way** call-SDK binding into the {@link BridgeNativeSdkRegistry}
+ * so `AIBridgeEngine.StartBridgeSession` auto-binds it onto a resolved `TwilioBridge` before connect — no
+ * per-deployment wiring needed. The typed downcast + `SetSdkFactory` stay confined here (where the concrete
+ * `TwilioBridge` type is known), keeping the engine seam free of provider types.
+ *
+ * A host can still override per-session via `StartBridgeSessionParams.BindSdk` — e.g. to inject a fake
+ * telephony SDK in a test instead of the native two-way default.
+ *
+ * @module @memberjunction/ai-bridge-twilio
+ * @author MemberJunction.com
+ */
+import { BridgeNativeSdkRegistry } from '@memberjunction/ai-bridge-base';
+import { BindTwilioNativeCall } from './twilio-native-call-sdk.js';
+/** The `MJ: AI Bridge Providers.DriverClass` value the Twilio provider row carries. */
+const TWILIO_DRIVER_CLASS = 'TwilioBridge';
+/**
+ * Registers Twilio's native two-way call binding. Idempotent (latest-wins in the registry), and invoked from
+ * the package `index.ts` so merely importing `@memberjunction/ai-bridge-twilio` wires the default binding.
+ * Also exported as a tree-shake-safe no-op-returning function callers can reference to force-retain the module.
+ */
+export function RegisterTwilioNativeSdk() {
+    BridgeNativeSdkRegistry.Instance.Register(TWILIO_DRIVER_CLASS, (driver) => {
+        // Safe downcast: the registry is keyed by DriverClass, so the engine only ever applies this to the
+        // TwilioBridge it resolved for 'TwilioBridge'. TwilioBridge extends BaseTelephonyBridge (a
+        // BaseRealtimeBridge), so the registry's BaseRealtimeBridge driver param accommodates it.
+        // BindTwilioNativeCall() defaults to the lazy native loader, which reads NativeModuleSpecifier from
+        // the per-session Configuration.
+        driver.SetSdkFactory(BindTwilioNativeCall());
+    });
+}
+// Register on import (mirrors the LoadTwilioBridge() tree-shake pattern in index.ts).
+RegisterTwilioNativeSdk();
+//# sourceMappingURL=register-native.js.map

package/dist/register-native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-native.js","sourceRoot":"","sources":["../src/register-native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,uBAAuB,EAAsB,MAAM,gCAAgC,CAAC;AAE7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,uFAAuF;AACvF,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACnC,uBAAuB,CAAC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAA0B,EAAE,EAAE;QAC1F,mGAAmG;QACnG,2FAA2F;QAC3F,0FAA0F;QAC1F,oGAAoG;QACpG,iCAAiC;QAChC,MAAuB,CAAC,aAAa,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACP,CAAC;AAED,sFAAsF;AACtF,uBAAuB,EAAE,CAAC"}

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

@@ -0,0 +1,281 @@
+/**
+ * @fileoverview `TwilioNativeCallSdk` — a **real, two-way** {@link ITelephonyCallSdk} binding over the
+ * native **Twilio Programmable Voice + Media Streams** path. Unlike the shipped, unbound
+ * {@link import('./twilio-call-sdk.js').TwilioCallSdk} (every operation throws "bind the real Twilio
+ * client"), this adapter actually carries the call: {@link TwilioNativeCallSdk.sendAudioFrame} forwards
+ * the agent's synthesized PCM onto the call's Media-Streams websocket (the agent's **voice** on the
+ * call), inbound Media-Streams audio maps to the seam's audio-frame callback (what the agent **hears**),
+ * and DTMF / transfer / hangup actually reach the native client.
+ *
+ * ## Why a native binding
+ * A phone call is a single-leg, bidirectional audio source. The native Twilio path has two halves — a
+ * **REST API** (place / hang-up / transfer / send-DTMF) and a **Media Streams** websocket (bidirectional
+ * realtime audio + inbound DTMF events). This adapter sits over both so a single binding gives the agent
+ * full-duplex audio plus the call controls the telephony seam declares.
+ *
+ * ## The native module seam (no SDK types leak)
+ * The `twilio` SDK is NOT imported here. Deployments wrap the REST + Media-Streams plumbing behind the
+ * small structural {@link NativeCallModule} surface declared below, and this adapter depends ONLY on that
+ * surface — none of `twilio`'s real types leak into `@memberjunction/ai-bridge-twilio`. The module is
+ * loaded **lazily** behind an injectable {@link NativeModuleLoader} so the package builds and unit-tests
+ * with **no `twilio` install and no network**. Tests inject a fake module; production points
+ * {@link TwilioNativeSdkConfig.NativeModuleSpecifier} at the real adapter package/path.
+ *
+ * ## Auth (deployment responsibility)
+ * The native client authenticates with the Twilio **Account SID + Auth Token** (or API key/secret) and a
+ * resolved Media-Streams websocket URL. These resolve **upstream** (MJ credential system / provider
+ * `Configuration`) and are **never inlined** at a call site — {@link readNativeConfig} reads already-
+ * resolved values out of the loose `Configuration` map the engine passes at connect.
+ *
+ * @module @memberjunction/ai-bridge-twilio
+ * @author MemberJunction.com
+ * @see {@link ITelephonyCallSdk} — the platform-agnostic telephony seam this binds.
+ */
+import { ITelephonyCallSdk } from '@memberjunction/ai-bridge-base';
+/** One inbound Media-Streams audio frame the native adapter surfaces (what the agent hears). */
+export interface NativeCallAudioFrame {
+    /** Raw PCM/μ-law bytes for this frame (`Uint8Array` view or standalone `ArrayBuffer`). */
+    data: Uint8Array | ArrayBuffer;
+    /** Optional epoch-ms capture timestamp (informational; the seam carries only the bytes). */
+    timestampMs?: number;
+}
+/** Options the native adapter's `createCall` (outbound dial) accepts. Mirrors the seam's `dial` args. */
+export interface NativeDialArgs {
+    /** Destination number to dial (E.164 recommended). */
+    toNumber: string;
+    /** The agent's caller-id / DID the call originates FROM. */
+    fromNumber: string;
+    /** Provider-specific dial options (status-callback URL, stream URL, recording flags, …). */
+    extra?: Record<string, unknown>;
+}
+/**
+ * The live native-call client the adapter hands back. The surface mirrors {@link ITelephonyCallSdk} but in
+ * the native adapter's own (lower-cased) vocabulary; this adapter maps between the two. VERIFY against the
+ * native Twilio adapter.
+ */
+export interface NativeCallClient {
+    /** Places the outbound call (REST `calls.create` with a `<Connect><Stream>` TwiML). Resolves the Call SID. */
+    dial(args: NativeDialArgs): Promise<string>;
+    /** Accepts the Media-Streams websocket for an already-delivered inbound Call SID. */
+    answer(callId: string): Promise<void>;
+    /** Ends the call (REST `calls(sid).update({ status: 'completed' })`). */
+    hangup(callId: string): Promise<void>;
+    /** Pushes one outbound PCM frame onto the call's Media-Streams websocket — the agent's voice. */
+    sendAudioFrame(pcm: ArrayBuffer): void;
+    /** Registers the inbound Media-Streams audio callback. "Latest handler wins." */
+    onAudioFrame(cb: (frame: NativeCallAudioFrame) => void): void;
+    /** Sends DTMF digits on the call (REST `<Play digits>` / `<Dial sendDigits>`). */
+    sendDtmf(digits: string): Promise<void>;
+    /** Registers the inbound DTMF callback (`<Gather>` results or Media-Streams `dtmf` events). */
+    onDtmf(cb: (digits: string) => void): void;
+    /** Transfers the live call (REST `calls(sid).update({ twiml: '<Dial>...' })`). */
+    transfer(callId: string, toNumber: string): Promise<void>;
+    /** Registers the call-ended callback (status-callback `completed`/`failed` or stream `stop`). */
+    onCallEnded(cb: () => void): void;
+}
+/** Options passed to {@link NativeCallModule.createClient}. Credentials are resolved upstream. */
+export interface NativeClientOptions {
+    /** The Twilio Account SID (resolved upstream). */
+    AccountSid?: string;
+    /** The Twilio Auth Token (resolved upstream). */
+    AuthToken?: string;
+    /** The Twilio API Key SID (resolved upstream; alternative to Account SID + Auth Token). */
+    ApiKeySid?: string;
+    /** The Twilio API Key Secret (resolved upstream). */
+    ApiKeySecret?: string;
+    /** The Media-Streams websocket URL the call's `<Connect><Stream>` connects to (resolved upstream). */
+    StreamUrl?: string;
+}
+/** The native adapter module surface — a factory that constructs a {@link NativeCallClient}. */
+export interface NativeCallModule {
+    /**
+     * Constructs a native call client from resolved options (Twilio credentials already resolved upstream).
+     * VERIFY against the native Twilio adapter (`createClient` vs a `Client` constructor).
+     */
+    createClient(options: NativeClientOptions): NativeCallClient;
+}
+/**
+ * Resolved configuration for {@link TwilioNativeCallSdk}. Credentials resolve **upstream** (MJ credential
+ * system / provider `Configuration`) — this object carries already-resolved values; **never inline
+ * secrets** at a call site.
+ */
+export interface TwilioNativeSdkConfig {
+    /** The Twilio Account SID (resolved upstream). */
+    AccountSid?: string;
+    /** The Twilio Auth Token (resolved upstream). */
+    AuthToken?: string;
+    /** The Twilio API Key SID (resolved upstream; alternative to Account SID + Auth Token). */
+    ApiKeySid?: string;
+    /** The Twilio API Key Secret (resolved upstream). */
+    ApiKeySecret?: string;
+    /** The Media-Streams websocket URL the call's `<Connect><Stream>` connects to (resolved upstream). */
+    StreamUrl?: string;
+    /**
+     * The module specifier of the native Twilio adapter to load (an internal adapter package name or an
+     * absolute path to a sidecar entry). Required in production; tests inject a loader.
+     */
+    NativeModuleSpecifier?: string;
+}
+/**
+ * Copies arbitrary PCM bytes into a standalone `ArrayBuffer`, never aliasing the caller's buffer window.
+ * A `Uint8Array` view may be a slice of a larger backing buffer (offset/length), so a naive `.buffer`
+ * grab would leak neighbouring audio; this copies exactly the view's bytes. Defined locally because the
+ * Twilio package has no shared coercion helper to reuse (unlike the Zoom package's RTMS binding).
+ */
+export declare function toArrayBuffer(data: Uint8Array | ArrayBuffer): ArrayBuffer;
+/**
+ * **Pure mapping** of one native inbound audio frame onto the raw PCM `ArrayBuffer` the telephony seam's
+ * audio callback delivers. Copies the bytes (see {@link toArrayBuffer}). Isolated from I/O for direct
+ * unit testing. (The telephony seam carries no per-speaker label — a 1:1 call has one remote party.)
+ */
+export declare function mapNativeAudioFrame(frame: NativeCallAudioFrame): ArrayBuffer;
+/**
+ * The injectable loader for the native Twilio adapter — overridable so unit tests supply a fake module
+ * with no `twilio` install and no network. Production leaves it as {@link defaultNativeLoader}, which
+ * lazily imports the configured {@link TwilioNativeSdkConfig.NativeModuleSpecifier}.
+ */
+export type NativeModuleLoader = (specifier: string) => Promise<NativeCallModule>;
+/**
+ * Lazily loads the native Twilio adapter at the given specifier (category: runtime plugin discovery from
+ * config — the adapter path is deployment-supplied and not known at build time, so a static import is
+ * impossible). Throws a precise, actionable error when it can't be loaded so a misconfigured deployment
+ * fails loudly, not silently.
+ *
+ * VERIFY against the native Twilio adapter: the module's default/namespace interop + that it exposes
+ * `createClient`.
+ */
+export declare const defaultNativeLoader: NativeModuleLoader;
+/**
+ * A **real, two-way** {@link ITelephonyCallSdk} over the native Twilio Programmable Voice + Media Streams
+ * path.
+ *
+ * Gives the agent both **hearing** (inbound Media-Streams audio → the seam's audio callback) and a
+ * **voice** ({@link sendAudioFrame} → the native Media-Streams send path), plus working DTMF, transfer,
+ * and hangup. Construct via {@link BindTwilioNativeCall} (the factory the bridge's `SetSdkFactory` wants),
+ * not directly, so config resolution + the lazy loader wire consistently.
+ *
+ * The adapter tracks the active Call SID so per-call REST/websocket operations can be addressed, and
+ * re-registers any handlers the bridge set before the call existed once a call comes online.
+ */
+export declare class TwilioNativeCallSdk implements ITelephonyCallSdk {
+    /** Resolved config (credentials + stream URL + the native module specifier). */
+    private readonly config;
+    /** The native-adapter module loader (overridable for tests). */
+    private readonly loadModule;
+    /** The live native client once {@link dial}/{@link answer} brings a call online. */
+    private client;
+    /** The active call's SID, so per-call operations can address it. */
+    private activeCallId;
+    /** The inbound audio handler the bridge registered (may predate the call). */
+    private audioHandler?;
+    /** The inbound DTMF handler the bridge registered (may predate the call). */
+    private dtmfHandler?;
+    /** The call-ended handler the bridge registered (may predate the call). */
+    private endedHandler?;
+    /**
+     * @param config Resolved credentials + stream URL + the native module specifier.
+     * @param loadModule The native-adapter loader (defaults to the lazy specifier loader).
+     */
+    constructor(config: TwilioNativeSdkConfig, loadModule?: NativeModuleLoader);
+    /**
+     * Loads the native adapter, constructs a client, wires its callbacks, and places the **outbound** call.
+     * Brings BOTH hearing and the agent's voice online. Resolves the platform-native Call SID.
+     *
+     * @param toNumber The destination phone number to dial.
+     * @param fromNumber The agent's caller-id / DID the call originates from.
+     * @param args Provider-specific dial parameters.
+     * @returns The Twilio Call SID for the placed call.
+     * @throws When the native module specifier is missing or the adapter can't be loaded.
+     */
+    dial(toNumber: string, fromNumber: string, args?: Record<string, unknown>): Promise<string>;
+    /**
+     * Loads the native adapter, constructs a client, wires its callbacks, and **answers** an inbound call
+     * already delivered to the agent's number. Brings BOTH hearing and the agent's voice online.
+     *
+     * @param callId The platform-native identifier of the inbound call to answer.
+     * @throws When the native module specifier is missing or the adapter can't be loaded.
+     */
+    answer(callId: string): Promise<void>;
+    /**
+     * Hangs up the call via the native client and clears the active call. Tolerant of teardown errors.
+     *
+     * @param callId The platform-native identifier of the call to end.
+     */
+    hangup(callId: string): Promise<void>;
+    /**
+     * Sends one raw PCM frame as the agent's outbound voice into the call — **the agent's real voice on
+     * the call**, via the native Media-Streams send path. No-ops (without throwing) before a call exists
+     * so an early model frame never crashes the session.
+     *
+     * @param pcm The PCM audio bytes to speak into the call.
+     */
+    sendAudioFrame(pcm: ArrayBuffer): void;
+    /**
+     * Registers the inbound audio handler (the agent's hearing path). Wires it to the live client when a
+     * call already exists; otherwise it is (re-)registered at {@link bindCall} when the call comes online.
+     *
+     * @param cb Invoked with each inbound PCM audio frame.
+     */
+    onAudioFrame(cb: (pcm: ArrayBuffer) => void): void;
+    /**
+     * Sends DTMF touch-tones on the call via the native client. No-ops (without throwing) before a call
+     * exists.
+     *
+     * @param digits The DTMF digit string to send.
+     */
+    sendDtmf(digits: string): Promise<void>;
+    /**
+     * Registers the inbound DTMF handler. Wires it to the live client when a call already exists; otherwise
+     * it is (re-)registered at {@link bindCall} when the call comes online.
+     *
+     * @param cb Invoked with each received DTMF digit string.
+     */
+    onDtmf(cb: (digits: string) => void): void;
+    /**
+     * Transfers the live call to another party via the native client. No-ops (without throwing) before a
+     * call exists.
+     *
+     * @param callId The platform-native identifier of the call to transfer.
+     * @param toNumber The transfer destination.
+     */
+    transfer(callId: string, toNumber: string): Promise<void>;
+    /**
+     * Registers the call-ended handler. Wires it to the live client when a call already exists; otherwise
+     * it is (re-)registered at {@link bindCall} when the call comes online.
+     *
+     * @param cb Invoked when the call ends.
+     */
+    onCallEnded(cb: () => void): void;
+    /**
+     * Lazily loads the native adapter and constructs the client (once), throwing an actionable error when
+     * the required {@link TwilioNativeSdkConfig.NativeModuleSpecifier} is absent.
+     */
+    private ensureClient;
+    /** Binds the active Call SID and (re-)registers any handlers the bridge set before the call existed. */
+    private bindCall;
+}
+/**
+ * Builds the {@link import('@memberjunction/ai-bridge-base').TelephonyCallSdkFactory}-shaped factory that
+ * constructs a {@link TwilioNativeCallSdk} from the bridge's per-session `Configuration`. Pass the result
+ * to `TwilioBridge.SetSdkFactory(...)` so a deployment activates **two-way native Twilio audio** without
+ * code changes to the driver.
+ *
+ * Reads Twilio credentials + stream URL + the native module specifier out of the config map the engine
+ * passes at connect (credentials resolved upstream — **never inline secrets**).
+ *
+ * @example
+ * // Where bridge drivers are configured (creds already resolved from the MJ credential system):
+ * bridge.SetSdkFactory(BindTwilioNativeCall());
+ *
+ * @param loadModule Optional native-adapter loader override (tests inject a fake; production omits it).
+ * @returns A factory `(config) => TwilioNativeCallSdk`.
+ */
+export declare function BindTwilioNativeCall(loadModule?: NativeModuleLoader): (config?: Record<string, unknown>) => TwilioNativeCallSdk;
+/**
+ * Extracts a {@link TwilioNativeSdkConfig} from the engine's loosely-typed `Configuration` map without
+ * ever widening to `any`. Each field is read + type-checked individually so a malformed config yields a
+ * clean, partially-resolved object (and {@link TwilioNativeCallSdk} then throws a precise error if the
+ * required specifier is absent) rather than a half-typed blob.
+ */
+export declare function readNativeConfig(config?: Record<string, unknown>): TwilioNativeSdkConfig;
+//# sourceMappingURL=twilio-native-call-sdk.d.ts.map

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

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

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

@@ -0,0 +1,313 @@
+/**
+ * @fileoverview `TwilioNativeCallSdk` — a **real, two-way** {@link ITelephonyCallSdk} binding over the
+ * native **Twilio Programmable Voice + Media Streams** path. Unlike the shipped, unbound
+ * {@link import('./twilio-call-sdk.js').TwilioCallSdk} (every operation throws "bind the real Twilio
+ * client"), this adapter actually carries the call: {@link TwilioNativeCallSdk.sendAudioFrame} forwards
+ * the agent's synthesized PCM onto the call's Media-Streams websocket (the agent's **voice** on the
+ * call), inbound Media-Streams audio maps to the seam's audio-frame callback (what the agent **hears**),
+ * and DTMF / transfer / hangup actually reach the native client.
+ *
+ * ## Why a native binding
+ * A phone call is a single-leg, bidirectional audio source. The native Twilio path has two halves — a
+ * **REST API** (place / hang-up / transfer / send-DTMF) and a **Media Streams** websocket (bidirectional
+ * realtime audio + inbound DTMF events). This adapter sits over both so a single binding gives the agent
+ * full-duplex audio plus the call controls the telephony seam declares.
+ *
+ * ## The native module seam (no SDK types leak)
+ * The `twilio` SDK is NOT imported here. Deployments wrap the REST + Media-Streams plumbing behind the
+ * small structural {@link NativeCallModule} surface declared below, and this adapter depends ONLY on that
+ * surface — none of `twilio`'s real types leak into `@memberjunction/ai-bridge-twilio`. The module is
+ * loaded **lazily** behind an injectable {@link NativeModuleLoader} so the package builds and unit-tests
+ * with **no `twilio` install and no network**. Tests inject a fake module; production points
+ * {@link TwilioNativeSdkConfig.NativeModuleSpecifier} at the real adapter package/path.
+ *
+ * ## Auth (deployment responsibility)
+ * The native client authenticates with the Twilio **Account SID + Auth Token** (or API key/secret) and a
+ * resolved Media-Streams websocket URL. These resolve **upstream** (MJ credential system / provider
+ * `Configuration`) and are **never inlined** at a call site — {@link readNativeConfig} reads already-
+ * resolved values out of the loose `Configuration` map the engine passes at connect.
+ *
+ * @module @memberjunction/ai-bridge-twilio
+ * @author MemberJunction.com
+ * @see {@link ITelephonyCallSdk} — the platform-agnostic telephony seam this binds.
+ */
+import { LogError } from '@memberjunction/core';
+/**
+ * Copies arbitrary PCM bytes into a standalone `ArrayBuffer`, never aliasing the caller's buffer window.
+ * A `Uint8Array` view may be a slice of a larger backing buffer (offset/length), so a naive `.buffer`
+ * grab would leak neighbouring audio; this copies exactly the view's bytes. Defined locally because the
+ * Twilio package has no shared coercion helper to reuse (unlike the Zoom package's RTMS binding).
+ */
+export function toArrayBuffer(data) {
+    if (data instanceof ArrayBuffer) {
+        return data.slice(0);
+    }
+    const copy = new Uint8Array(data.byteLength);
+    copy.set(data);
+    return copy.buffer;
+}
+/**
+ * **Pure mapping** of one native inbound audio frame onto the raw PCM `ArrayBuffer` the telephony seam's
+ * audio callback delivers. Copies the bytes (see {@link toArrayBuffer}). Isolated from I/O for direct
+ * unit testing. (The telephony seam carries no per-speaker label — a 1:1 call has one remote party.)
+ */
+export function mapNativeAudioFrame(frame) {
+    return toArrayBuffer(frame.data);
+}
+/** Structural guard: a value is a {@link NativeCallModule} when it exposes a `createClient` function. */
+function isNativeModule(value) {
+    return (value != null &&
+        typeof value === 'object' &&
+        typeof value.createClient === 'function');
+}
+/** Unwraps a `{ default }` interop wrapper (CJS-with-default), returning the inner value or the input. */
+function unwrapDefault(mod) {
+    if (mod && typeof mod === 'object' && 'default' in mod) {
+        const inner = mod.default;
+        if (isNativeModule(inner)) {
+            return inner;
+        }
+    }
+    return mod;
+}
+/**
+ * Lazily loads the native Twilio adapter at the given specifier (category: runtime plugin discovery from
+ * config — the adapter path is deployment-supplied and not known at build time, so a static import is
+ * impossible). Throws a precise, actionable error when it can't be loaded so a misconfigured deployment
+ * fails loudly, not silently.
+ *
+ * VERIFY against the native Twilio adapter: the module's default/namespace interop + that it exposes
+ * `createClient`.
+ */
+export const defaultNativeLoader = async (specifier) => {
+    try {
+        const mod = await import(/* @vite-ignore */ specifier);
+        const resolved = unwrapDefault(mod);
+        if (!isNativeModule(resolved)) {
+            throw new Error('resolved module has no createClient() factory');
+        }
+        return resolved;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`TwilioNativeCallSdk could not load the native Twilio adapter at '${specifier}'. Build/install the ` +
+            'native Twilio Programmable Voice + Media Streams adapter (REST + websocket) and set ' +
+            `TwilioNativeSdkConfig.NativeModuleSpecifier to it. Underlying error: ${message}`);
+    }
+};
+/**
+ * A **real, two-way** {@link ITelephonyCallSdk} over the native Twilio Programmable Voice + Media Streams
+ * path.
+ *
+ * Gives the agent both **hearing** (inbound Media-Streams audio → the seam's audio callback) and a
+ * **voice** ({@link sendAudioFrame} → the native Media-Streams send path), plus working DTMF, transfer,
+ * and hangup. Construct via {@link BindTwilioNativeCall} (the factory the bridge's `SetSdkFactory` wants),
+ * not directly, so config resolution + the lazy loader wire consistently.
+ *
+ * The adapter tracks the active Call SID so per-call REST/websocket operations can be addressed, and
+ * re-registers any handlers the bridge set before the call existed once a call comes online.
+ */
+export class TwilioNativeCallSdk {
+    /**
+     * @param config Resolved credentials + stream URL + the native module specifier.
+     * @param loadModule The native-adapter loader (defaults to the lazy specifier loader).
+     */
+    constructor(config, loadModule = defaultNativeLoader) {
+        /** The live native client once {@link dial}/{@link answer} brings a call online. */
+        this.client = null;
+        /** The active call's SID, so per-call operations can address it. */
+        this.activeCallId = null;
+        this.config = config;
+        this.loadModule = loadModule;
+    }
+    // ── ITelephonyCallSdk — lifecycle ────────────────────────────────────────────────
+    /**
+     * Loads the native adapter, constructs a client, wires its callbacks, and places the **outbound** call.
+     * Brings BOTH hearing and the agent's voice online. Resolves the platform-native Call SID.
+     *
+     * @param toNumber The destination phone number to dial.
+     * @param fromNumber The agent's caller-id / DID the call originates from.
+     * @param args Provider-specific dial parameters.
+     * @returns The Twilio Call SID for the placed call.
+     * @throws When the native module specifier is missing or the adapter can't be loaded.
+     */
+    async dial(toNumber, fromNumber, args) {
+        const client = await this.ensureClient();
+        const callSid = await client.dial({ toNumber, fromNumber, extra: args });
+        this.bindCall(callSid);
+        return callSid;
+    }
+    /**
+     * Loads the native adapter, constructs a client, wires its callbacks, and **answers** an inbound call
+     * already delivered to the agent's number. Brings BOTH hearing and the agent's voice online.
+     *
+     * @param callId The platform-native identifier of the inbound call to answer.
+     * @throws When the native module specifier is missing or the adapter can't be loaded.
+     */
+    async answer(callId) {
+        const client = await this.ensureClient();
+        await client.answer(callId);
+        this.bindCall(callId);
+    }
+    /**
+     * Hangs up the call via the native client and clears the active call. Tolerant of teardown errors.
+     *
+     * @param callId The platform-native identifier of the call to end.
+     */
+    async hangup(callId) {
+        const client = this.client;
+        this.activeCallId = null;
+        if (client) {
+            try {
+                await client.hangup(callId);
+            }
+            catch (err) {
+                LogError(`[TwilioNativeCallSdk] hangup() failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    // ── ITelephonyCallSdk — two-way audio (real) ─────────────────────────────────────
+    /**
+     * Sends one raw PCM frame as the agent's outbound voice into the call — **the agent's real voice on
+     * the call**, via the native Media-Streams send path. No-ops (without throwing) before a call exists
+     * so an early model frame never crashes the session.
+     *
+     * @param pcm The PCM audio bytes to speak into the call.
+     */
+    sendAudioFrame(pcm) {
+        this.client?.sendAudioFrame(pcm);
+    }
+    /**
+     * Registers the inbound audio handler (the agent's hearing path). Wires it to the live client when a
+     * call already exists; otherwise it is (re-)registered at {@link bindCall} when the call comes online.
+     *
+     * @param cb Invoked with each inbound PCM audio frame.
+     */
+    onAudioFrame(cb) {
+        this.audioHandler = cb;
+        this.client?.onAudioFrame((frame) => cb(mapNativeAudioFrame(frame)));
+    }
+    // ── ITelephonyCallSdk — DTMF, transfer (real) ────────────────────────────────────
+    /**
+     * Sends DTMF touch-tones on the call via the native client. No-ops (without throwing) before a call
+     * exists.
+     *
+     * @param digits The DTMF digit string to send.
+     */
+    async sendDtmf(digits) {
+        await this.client?.sendDtmf(digits);
+    }
+    /**
+     * Registers the inbound DTMF handler. Wires it to the live client when a call already exists; otherwise
+     * it is (re-)registered at {@link bindCall} when the call comes online.
+     *
+     * @param cb Invoked with each received DTMF digit string.
+     */
+    onDtmf(cb) {
+        this.dtmfHandler = cb;
+        this.client?.onDtmf(cb);
+    }
+    /**
+     * Transfers the live call to another party via the native client. No-ops (without throwing) before a
+     * call exists.
+     *
+     * @param callId The platform-native identifier of the call to transfer.
+     * @param toNumber The transfer destination.
+     */
+    async transfer(callId, toNumber) {
+        await this.client?.transfer(callId, toNumber);
+    }
+    /**
+     * Registers the call-ended handler. Wires it to the live client when a call already exists; otherwise
+     * it is (re-)registered at {@link bindCall} when the call comes online.
+     *
+     * @param cb Invoked when the call ends.
+     */
+    onCallEnded(cb) {
+        this.endedHandler = cb;
+        this.client?.onCallEnded(cb);
+    }
+    // ── internals ────────────────────────────────────────────────────────────────────
+    /**
+     * Lazily loads the native adapter and constructs the client (once), throwing an actionable error when
+     * the required {@link TwilioNativeSdkConfig.NativeModuleSpecifier} is absent.
+     */
+    async ensureClient() {
+        if (this.client) {
+            return this.client;
+        }
+        const specifier = this.config.NativeModuleSpecifier;
+        if (!specifier) {
+            throw new Error('TwilioNativeCallSdk: no NativeModuleSpecifier configured. Set it to the native Twilio Programmable ' +
+                'Voice + Media Streams adapter (REST + websocket) in the session Configuration. See the README.');
+        }
+        const mod = await this.loadModule(specifier);
+        this.client = mod.createClient({
+            AccountSid: this.config.AccountSid,
+            AuthToken: this.config.AuthToken,
+            ApiKeySid: this.config.ApiKeySid,
+            ApiKeySecret: this.config.ApiKeySecret,
+            StreamUrl: this.config.StreamUrl,
+        });
+        return this.client;
+    }
+    /** Binds the active Call SID and (re-)registers any handlers the bridge set before the call existed. */
+    bindCall(callId) {
+        this.activeCallId = callId;
+        const client = this.client;
+        if (!client) {
+            return;
+        }
+        if (this.audioHandler) {
+            const cb = this.audioHandler;
+            client.onAudioFrame((frame) => cb(mapNativeAudioFrame(frame)));
+        }
+        if (this.dtmfHandler) {
+            client.onDtmf(this.dtmfHandler);
+        }
+        if (this.endedHandler) {
+            client.onCallEnded(this.endedHandler);
+        }
+    }
+}
+/**
+ * Builds the {@link import('@memberjunction/ai-bridge-base').TelephonyCallSdkFactory}-shaped factory that
+ * constructs a {@link TwilioNativeCallSdk} from the bridge's per-session `Configuration`. Pass the result
+ * to `TwilioBridge.SetSdkFactory(...)` so a deployment activates **two-way native Twilio audio** without
+ * code changes to the driver.
+ *
+ * Reads Twilio credentials + stream URL + the native module specifier out of the config map the engine
+ * passes at connect (credentials resolved upstream — **never inline secrets**).
+ *
+ * @example
+ * // Where bridge drivers are configured (creds already resolved from the MJ credential system):
+ * bridge.SetSdkFactory(BindTwilioNativeCall());
+ *
+ * @param loadModule Optional native-adapter loader override (tests inject a fake; production omits it).
+ * @returns A factory `(config) => TwilioNativeCallSdk`.
+ */
+export function BindTwilioNativeCall(loadModule = defaultNativeLoader) {
+    return (config) => new TwilioNativeCallSdk(readNativeConfig(config), loadModule);
+}
+/**
+ * Extracts a {@link TwilioNativeSdkConfig} from the engine's loosely-typed `Configuration` map without
+ * ever widening to `any`. Each field is read + type-checked individually so a malformed config yields a
+ * clean, partially-resolved object (and {@link TwilioNativeCallSdk} then throws a precise error if the
+ * required specifier is absent) rather than a half-typed blob.
+ */
+export function readNativeConfig(config) {
+    const cfg = config ?? {};
+    return {
+        AccountSid: readString(cfg.AccountSid),
+        AuthToken: readString(cfg.AuthToken),
+        ApiKeySid: readString(cfg.ApiKeySid),
+        ApiKeySecret: readString(cfg.ApiKeySecret),
+        StreamUrl: readString(cfg.StreamUrl),
+        NativeModuleSpecifier: readString(cfg.NativeModuleSpecifier),
+    };
+}
+/** Reads a value as a non-empty string, or `undefined`. */
+function readString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+//# sourceMappingURL=twilio-native-call-sdk.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"twilio-native-call-sdk.js","sourceRoot":"","sources":["../src/twilio-native-call-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAmGhD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAA8B;IACxD,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACf,OAAO,IAAI,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA2B;IAC3D,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AASD,yGAAyG;AACzG,SAAS,cAAc,CAAC,KAAc;IAClC,OAAO,CACH,KAAK,IAAI,IAAI;QACb,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAQ,KAAoC,CAAC,YAAY,KAAK,UAAU,CAC3E,CAAC;AACN,CAAC;AAED,0GAA0G;AAC1G,SAAS,aAAa,CAAC,GAAY;IAC/B,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;QACrD,MAAM,KAAK,GAAI,GAA4B,CAAC,OAAO,CAAC;QACpD,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAuB,KAAK,EAAE,SAAiB,EAA6B,EAAE;IAC1G,IAAI,CAAC;QACD,MAAM,GAAG,GAAY,MAAM,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CACX,oEAAoE,SAAS,uBAAuB;YAChG,sFAAsF;YACtF,wEAAwE,OAAO,EAAE,CACxF,CAAC;IACN,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,mBAAmB;IAsB5B;;;OAGG;IACH,YAAY,MAA6B,EAAE,aAAiC,mBAAmB;QAnB/F,oFAAoF;QAC5E,WAAM,GAA4B,IAAI,CAAC;QAE/C,oEAAoE;QAC5D,iBAAY,GAAkB,IAAI,CAAC;QAgBvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,oFAAoF;IAEpF;;;;;;;;;OASG;IACI,KAAK,CAAC,IAAI,CAAC,QAAgB,EAAE,UAAkB,EAAE,IAA8B;QAClF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAM,CAAC,MAAc;QAC9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,MAAM,CAAC,MAAc;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,MAAM,EAAE,CAAC;YACT,IAAI,CAAC;gBACD,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,QAAQ,CAAC,0CAA0C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3G,CAAC;QACL,CAAC;IACL,CAAC;IAED,oFAAoF;IAEpF;;;;;;OAMG;IACI,cAAc,CAAC,GAAgB;QAClC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACI,YAAY,CAAC,EAA8B;QAC9C,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,oFAAoF;IAEpF;;;;;OAKG;IACI,KAAK,CAAC,QAAQ,CAAC,MAAc;QAChC,MAAM,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,EAA4B;QACtC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,QAAgB;QAClD,MAAM,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,EAAc;QAC7B,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,oFAAoF;IAEpF;;;OAGG;IACK,KAAK,CAAC,YAAY;QACtB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACX,qGAAqG;gBACjG,gGAAgG,CACvG,CAAC;QACN,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC;YAC3B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAClC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;YACtC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;SACnC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,wGAAwG;IAChG,QAAQ,CAAC,MAAc;QAC3B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO;QACX,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC;YAC7B,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;CACJ;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB,CAChC,aAAiC,mBAAmB;IAEpD,OAAO,CAAC,MAAgC,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;AAC/G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAgC;IAC7D,MAAM,GAAG,GAAG,MAAM,IAAI,EAAE,CAAC;IACzB,OAAO;QACH,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC;QACtC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;QACpC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;QACpC,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC;QAC1C,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;QACpC,qBAAqB,EAAE,UAAU,CAAC,GAAG,CAAC,qBAAqB,CAAC;KAC/D,CAAC;AACN,CAAC;AAED,2DAA2D;AAC3D,SAAS,UAAU,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/ai-bridge-twilio",
   "type": "module",
-  "version": "5.41.0",
+  "version": "5.42.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",
@@ -17,10 +17,10 @@
   "author": "MemberJunction.com",
   "license": "ISC",
   "dependencies": {
-    "@memberjunction/core": "5.41.0",
-    "@memberjunction/global": "5.41.0",
-    "@memberjunction/core-entities": "5.41.0",
-    "@memberjunction/ai-bridge-base": "5.41.0"
+    "@memberjunction/core": "5.42.0",
+    "@memberjunction/global": "5.42.0",
+    "@memberjunction/core-entities": "5.42.0",
+    "@memberjunction/ai-bridge-base": "5.42.0"
   },
   "devDependencies": {
     "@types/node": "24.10.11",