@ariaflowagents/livekit-plugin-transport-twilio 0.9.0

package/dist/codec/g711.js

@@ -0,0 +1,137 @@
+/**
+ * G.711 μ-law codec implementation for Twilio Media Streams.
+ *
+ * Twilio uses G.711 μ-law (mu-law) encoding at 8kHz.
+ * This codec provides bidirectional conversion between PCM Int16
+ * and μ-law encoded Uint8.
+ */
+const MULAW_BIAS = 0x84;
+const MULAW_CLIP = 32635;
+/**
+ * μ-law compression table (precomputed for performance).
+ * Maps linear 14-bit samples to 8-bit μ-law values.
+ */
+const MULAW_COMPRESS_TABLE = new Int8Array([
+    -3, -3, -3, -3, -3, -3, -3, -3, -3, -3, -3, -3, -3, -3, -3, -3,
+    -2, -2, -2, -2, -2, -2, -2, -2, -1, -1, -1, -1, -1, -1, -1, -1,
+    -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
+    -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
+    -1, -1, -1, -1, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0,
+    -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0,
+    -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0,
+    -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0,
+    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+    0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 2, 2, 2, 2, 2,
+    2, 2, 2, 2, 2, 2, 2, 2, 3, 3, 3, 3, 3, 3, 3, 3,
+    3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3,
+    3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3,
+]);
+/**
+ * μ-law expansion table (precomputed for performance).
+ * Maps 8-bit μ-law values to linear 16-bit PCM samples.
+ */
+const MULAW_EXPAND_TABLE = new Int16Array([
+    -32124, -31100, -30076, -29052, -28028, -27004, -25980, -24956,
+    -23932, -22908, -21884, -20860, -19836, -18812, -17788, -16764,
+    -15996, -15484, -14972, -14460, -13948, -13436, -12924, -12412,
+    -11900, -11388, -10876, -10364, -9852, -9340, -8828, -8316,
+    -7932, -7676, -7420, -7164, -6908, -6652, -6396, -6140,
+    -5884, -5628, -5372, -5116, -4860, -4604, -4348, -4092,
+    -3900, -3772, -3644, -3516, -3388, -3260, -3132, -3004,
+    -2876, -2748, -2620, -2492, -2364, -2236, -2108, -1980,
+    -1884, -1820, -1756, -1692, -1628, -1564, -1500, -1436,
+    -1372, -1308, -1244, -1180, -1116, -1052, -988, -924,
+    -876, -844, -812, -780, -748, -716, -684, -652,
+    -620, -588, -556, -524, -492, -460, -428, -396,
+    -372, -356, -340, -324, -308, -292, -276, -260,
+    -244, -228, -212, -196, -180, -164, -148, -132,
+    -120, -112, -104, -96, -88, -80, -72, -64,
+    -56, -48, -40, -32, -24, -16, -8, 0,
+    0, 8, 16, 24, 32, 40, 48, 56,
+    64, 72, 80, 88, 96, 104, 112, 120,
+    132, 148, 164, 180, 196, 212, 228, 244,
+    260, 276, 292, 308, 324, 340, 356, 372,
+    396, 428, 460, 492, 524, 556, 588, 620,
+    652, 684, 716, 748, 780, 812, 844, 876,
+    924, 988, 1052, 1116, 1180, 1244, 1308, 1372,
+    1436, 1500, 1564, 1628, 1692, 1756, 1820, 1884,
+    1980, 2108, 2236, 2364, 2492, 2620, 2748, 2876,
+    3004, 3132, 3260, 3388, 3516, 3644, 3772, 3900,
+    4092, 4348, 4604, 4860, 5116, 5372, 5628, 5884,
+    6140, 6396, 6652, 6908, 7164, 7420, 7676, 7932,
+    8316, 8828, 9340, 9852, 10364, 10876, 11388, 11900,
+    12412, 12924, 13436, 13948, 14460, 14972, 15484, 15996,
+    16764, 17788, 18812, 19836, 20860, 21884, 22908, 23932,
+    24956, 25980, 27004, 28028, 29052, 30076, 31100, 32124,
+]);
+/**
+ * Encode a PCM Int16 sample to μ-law Uint8.
+ *
+ * @param sample - 16-bit PCM sample (-32768 to 32767)
+ * @returns μ-law encoded byte (0-255)
+ */
+export function mulawEncode(sample) {
+    // Add bias to center around zero
+    sample += MULAW_BIAS;
+    // Clip to valid range
+    if (sample > MULAW_CLIP)
+        sample = MULAW_CLIP;
+    if (sample < -MULAW_CLIP)
+        sample = -MULAW_CLIP;
+    // Convert to positive value
+    const sign = sample < 0 ? 0x80 : 0x00;
+    if (sign)
+        sample = -sample;
+    // Find exponent and mantissa
+    let exponent = 7;
+    for (let i = 0; i < 7; i++) {
+        if (sample <= (0x01 << (i + 1))) {
+            exponent = i;
+            break;
+        }
+    }
+    const mantissa = (sample >> (exponent + 1)) & 0x0F;
+    // Compress to 8-bit μ-law
+    const mulaw = ~(sign | (exponent << 4) | mantissa);
+    return mulaw & 0xFF;
+}
+/**
+ * Decode a μ-law Uint8 to PCM Int16.
+ *
+ * @param mulaw - μ-law encoded byte (0-255)
+ * @returns 16-bit PCM sample
+ */
+export function mulawDecode(mulaw) {
+    // Expand using lookup table
+    return MULAW_EXPAND_TABLE[mulaw & 0xFF];
+}
+/**
+ * Encode an array of PCM samples to μ-law.
+ *
+ * @param pcm - Int16Array of PCM samples
+ * @returns Uint8Array of μ-law encoded bytes
+ */
+export function mulawEncodeArray(pcm) {
+    const mulaw = new Uint8Array(pcm.length);
+    for (let i = 0; i < pcm.length; i++) {
+        mulaw[i] = mulawEncode(pcm[i]);
+    }
+    return mulaw;
+}
+/**
+ * Decode an array of μ-law bytes to PCM.
+ *
+ * @param mulaw - Uint8Array of μ-law encoded bytes
+ * @returns Int16Array of PCM samples
+ */
+export function mulawDecodeArray(mulaw) {
+    const pcm = new Int16Array(mulaw.length);
+    for (let i = 0; i < mulaw.length; i++) {
+        pcm[i] = mulawDecode(mulaw[i]);
+    }
+    return pcm;
+}
+//# sourceMappingURL=g711.js.map

package/dist/codec/g711.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"g711.js","sourceRoot":"","sources":["../../src/codec/g711.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,UAAU,GAAG,KAAK,CAAC;AAEzB;;;GAGG;AACH,MAAM,oBAAoB,GAAG,IAAI,SAAS,CAAC;IACzC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9C,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9C,CAAC,EAAE,CAAC,EAA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"}

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Twilio Media Streams Transport for AriaFlow Agents
+ *
+ * Enables AriaFlow voice agents to work with Twilio Media Streams API.
+ * Compatible with Cloudflare Workers, Node.js, and any WebSocket-enabled runtime.
+ *
+ * Features:
+ * - G.711 μ-law codec support (Twilio standard)
+ * - Automatic resampling (8kHz ↔ 24kHz)
+ * - Cloudflare Workers compatible
+ * - Session management integration
+ *
+ * Basic usage (Cloudflare Workers):
+ * ```typescript
+ * import { createTwilioWorker } from '@ariaflow/livekit-plugin-transport-twilio/cloudflare';
+ *
+ * export default createTwilioWorker({
+ *   agent: () => createAriaFlowSession({...}),
+ * });
+ * ```
+ *
+ * Basic usage (Node.js/any WebSocket):
+ * ```typescript
+ * import { WebSocketServer } from 'ws';
+ * import { TwilioTransportAdapter } from '@ariaflow/livekit-plugin-transport-twilio';
+ * import { createAriaFlowSession } from '@ariaflow/livekit-plugin';
+ *
+ * const wss = new WebSocketServer({ port: 8080 });
+ *
+ * wss.on('connection', (ws, req) => {
+ *   const transport = new TwilioTransportAdapter({
+ *     send: (msg) => ws.send(msg),
+ *   });
+ *
+ *   ws.on('message', (data) => {
+ *     transport.handleMessage(data.toString());
+ *   });
+ *
+ *   const { agent, sessionOptions } = createAriaFlowSession({
+ *     runtime: agentConfig,
+ *     stt: new GeminiLiveSTT(),
+ *     tts: new GeminiLiveTTS(),
+ *   });
+ *
+ *   await sessionManager.startSession(transport, agent, sessionOptions);
+ * });
+ * ```
+ *
+ * Basic usage (TwilioAgentServer):
+ * ```typescript
+ * import { TwilioAgentServer } from '@ariaflow/livekit-plugin-transport-twilio';
+ * import { createAriaFlowSession } from '@ariaflow/livekit-plugin';
+ *
+ * const server = new TwilioAgentServer({ port: 8080 });
+ *
+ * server.onCall(async (callId, transport) => {
+ *   const { agent, sessionOptions } = createAriaFlowSession({...});
+ *   await server.startSession(callId, agent, sessionOptions);
+ * });
+ *
+ * await server.listen();
+ * ```
+ */
+export { TwilioAgentServer } from './server.js';
+export type { TwilioServerOptions } from './server.js';
+export { TwilioTransportAdapter } from './transport_adapter.js';
+export type { TwilioTransportOptions } from './transport_adapter.js';
+export { TwilioAudioInput } from './audio_input.js';
+export { TwilioAudioOutput } from './audio_output.js';
+export { TwilioTextOutput } from './text_output.js';
+export { parseTwilioMessage, isMediaEvent, extractMediaPayload, createClearMessage, createMarkMessage, } from './twilio_protocol.js';
+export type { TwilioEvent, TwilioMediaEvent, TwilioConnectedEvent, TwilioStartEvent, TwilioStopEvent, TwilioMarkEvent, TwilioClearEvent, } from './twilio_protocol.js';
+export { mulawEncodeArray, mulawDecodeArray } from '@ariaflow/livekit-plugin/codec/g711';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/index.js

@@ -0,0 +1,76 @@
+/**
+ * Twilio Media Streams Transport for AriaFlow Agents
+ *
+ * Enables AriaFlow voice agents to work with Twilio Media Streams API.
+ * Compatible with Cloudflare Workers, Node.js, and any WebSocket-enabled runtime.
+ *
+ * Features:
+ * - G.711 μ-law codec support (Twilio standard)
+ * - Automatic resampling (8kHz ↔ 24kHz)
+ * - Cloudflare Workers compatible
+ * - Session management integration
+ *
+ * Basic usage (Cloudflare Workers):
+ * ```typescript
+ * import { createTwilioWorker } from '@ariaflow/livekit-plugin-transport-twilio/cloudflare';
+ *
+ * export default createTwilioWorker({
+ *   agent: () => createAriaFlowSession({...}),
+ * });
+ * ```
+ *
+ * Basic usage (Node.js/any WebSocket):
+ * ```typescript
+ * import { WebSocketServer } from 'ws';
+ * import { TwilioTransportAdapter } from '@ariaflow/livekit-plugin-transport-twilio';
+ * import { createAriaFlowSession } from '@ariaflow/livekit-plugin';
+ *
+ * const wss = new WebSocketServer({ port: 8080 });
+ *
+ * wss.on('connection', (ws, req) => {
+ *   const transport = new TwilioTransportAdapter({
+ *     send: (msg) => ws.send(msg),
+ *   });
+ *
+ *   ws.on('message', (data) => {
+ *     transport.handleMessage(data.toString());
+ *   });
+ *
+ *   const { agent, sessionOptions } = createAriaFlowSession({
+ *     runtime: agentConfig,
+ *     stt: new GeminiLiveSTT(),
+ *     tts: new GeminiLiveTTS(),
+ *   });
+ *
+ *   await sessionManager.startSession(transport, agent, sessionOptions);
+ * });
+ * ```
+ *
+ * Basic usage (TwilioAgentServer):
+ * ```typescript
+ * import { TwilioAgentServer } from '@ariaflow/livekit-plugin-transport-twilio';
+ * import { createAriaFlowSession } from '@ariaflow/livekit-plugin';
+ *
+ * const server = new TwilioAgentServer({ port: 8080 });
+ *
+ * server.onCall(async (callId, transport) => {
+ *   const { agent, sessionOptions } = createAriaFlowSession({...});
+ *   await server.startSession(callId, agent, sessionOptions);
+ * });
+ *
+ * await server.listen();
+ * ```
+ */
+// Server
+export { TwilioAgentServer } from './server.js';
+// Core transport
+export { TwilioTransportAdapter } from './transport_adapter.js';
+// Audio I/O
+export { TwilioAudioInput } from './audio_input.js';
+export { TwilioAudioOutput } from './audio_output.js';
+export { TwilioTextOutput } from './text_output.js';
+// Protocol utilities
+export { parseTwilioMessage, isMediaEvent, extractMediaPayload, createClearMessage, createMarkMessage, } from './twilio_protocol.js';
+// Codec (re-exported from canonical source)
+export { mulawEncodeArray, mulawDecodeArray } from '@ariaflow/livekit-plugin/codec/g711';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAEH,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,iBAAiB;AACjB,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,qBAAqB;AACrB,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAW9B,4CAA4C;AAC5C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,42 @@
+import { SessionManager, type AriaFlowVoiceSession } from '@ariaflow/livekit-plugin';
+import type { voice } from '@livekit/agents';
+import { TwilioTransportAdapter } from './transport_adapter.js';
+/**
+ * Options for TwilioAgentServer
+ */
+export interface TwilioServerOptions {
+    port?: number;
+    host?: string;
+}
+/**
+ * A WebSocket server that accepts Twilio Media Streams connections and creates agent sessions.
+ *
+ * Usage:
+ *   const server = new TwilioAgentServer({ port: 8080 });
+ *
+ *   server.onCall(async (callId, transport) => {
+ *     const voiceSession = new AriaFlowVoiceSession({
+ *       runtime: runtime,
+ *       stt: new GeminiLiveSTT(),
+ *       tts: new GeminiLiveTTS(),
+ *     });
+ *     await server.startSession(callId, voiceSession);
+ *   });
+ *
+ *   await server.listen();
+ */
+export declare class TwilioAgentServer {
+    private options;
+    private wss;
+    private sessionManager;
+    private callHandler;
+    private callIdCounter;
+    constructor(options?: TwilioServerOptions);
+    onCall(handler: (callId: string, transport: TwilioTransportAdapter) => void | Promise<void>): void;
+    startSession(callId: string, voiceSession: AriaFlowVoiceSession): Promise<voice.AgentSession>;
+    private transports;
+    listen(): Promise<void>;
+    get sessions(): SessionManager;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGhE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,iBAAiB;IAQhB,OAAO,CAAC,OAAO;IAP3B,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,WAAW,CAEH;IAChB,OAAO,CAAC,aAAa,CAAK;gBAEN,OAAO,GAAE,mBAAwB;IAErD,MAAM,CACJ,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnF,IAAI;IAID,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,oBAAoB,GACjC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;IAQ9B,OAAO,CAAC,UAAU,CAA6C;IAEzD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAoF7B,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist/server.js

@@ -0,0 +1,125 @@
+import { WebSocketServer as WSServer } from 'ws';
+import { SessionManager } from '@ariaflow/livekit-plugin';
+import { TwilioTransportAdapter } from './transport_adapter.js';
+/**
+ * A WebSocket server that accepts Twilio Media Streams connections and creates agent sessions.
+ *
+ * Usage:
+ *   const server = new TwilioAgentServer({ port: 8080 });
+ *
+ *   server.onCall(async (callId, transport) => {
+ *     const voiceSession = new AriaFlowVoiceSession({
+ *       runtime: runtime,
+ *       stt: new GeminiLiveSTT(),
+ *       tts: new GeminiLiveTTS(),
+ *     });
+ *     await server.startSession(callId, voiceSession);
+ *   });
+ *
+ *   await server.listen();
+ */
+export class TwilioAgentServer {
+    options;
+    wss = null;
+    sessionManager = new SessionManager();
+    callHandler = null;
+    callIdCounter = 0;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    onCall(handler) {
+        this.callHandler = handler;
+    }
+    async startSession(callId, voiceSession) {
+        const transport = this.transports.get(callId);
+        if (!transport) {
+            throw new Error(`Transport not found for call: ${callId}`);
+        }
+        return this.sessionManager.startSession(transport, voiceSession);
+    }
+    transports = new Map();
+    async listen() {
+        const port = this.options.port ?? 8080;
+        const host = this.options.host ?? '0.0.0.0';
+        this.wss = new WSServer({ port, host });
+        this.wss.on('connection', async (ws, req) => {
+            const callId = `call-${++this.callIdCounter}`;
+            console.log(`[TwilioServer] New connection: ${callId}`);
+            const transport = new TwilioTransportAdapter({
+                id: callId,
+                send: (message) => {
+                    if (ws.readyState === ws.OPEN) {
+                        ws.send(message);
+                    }
+                },
+            });
+            // Store transport
+            this.transports.set(callId, transport);
+            // Handle incoming messages from Twilio
+            ws.on('message', (data) => {
+                try {
+                    const message = data.toString();
+                    // Parse to detect start event
+                    const event = JSON.parse(message);
+                    // Log events
+                    if (event.event === 'connected') {
+                        console.log(`[TwilioServer] [${callId}] Connected to Twilio`);
+                    }
+                    else if (event.event === 'start') {
+                        const streamSid = event.start?.streamSid ?? event.streamSid ?? '(missing)';
+                        console.log(`[TwilioServer] [${callId}] Stream started: ${streamSid}`);
+                    }
+                    else if (event.event === 'stop') {
+                        console.log(`[TwilioServer] [${callId}] Stream stopped`);
+                    }
+                    // Route to transport
+                    transport.handleMessage(message);
+                    // Trigger call handler on start event (when streamSid is available)
+                    if (event.event === 'start' && this.callHandler) {
+                        this.callHandler(callId, transport);
+                    }
+                }
+                catch (error) {
+                    console.error('[TwilioServer] Error handling message:', {
+                        error: error instanceof Error ? error.message : String(error),
+                        callId,
+                    });
+                }
+            });
+            // Handle disconnect
+            ws.on('close', async () => {
+                console.log(`[TwilioServer] Connection closed: ${callId}`);
+                await this.sessionManager.closeSession(callId).catch((err) => {
+                    console.error('[TwilioServer] Error closing session:', {
+                        error: err instanceof Error ? err.message : String(err),
+                        callId,
+                    });
+                });
+                await transport.close();
+                this.transports.delete(callId);
+            });
+            // Handle errors
+            ws.on('error', (error) => {
+                console.error('[TwilioServer] WebSocket error:', {
+                    error: error.message,
+                    callId,
+                });
+            });
+        });
+        return new Promise((resolve) => {
+            this.wss.on('listening', () => {
+                resolve();
+            });
+        });
+    }
+    get sessions() {
+        return this.sessionManager;
+    }
+    async close() {
+        await this.sessionManager.closeAll();
+        if (this.wss) {
+            this.wss.close();
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,QAAQ,EAAkB,MAAM,IAAI,CAAC;AACjE,OAAO,EAAE,cAAc,EAA6B,MAAM,0BAA0B,CAAC;AAGrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAWhE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,iBAAiB;IAQR;IAPZ,GAAG,GAAoB,IAAI,CAAC;IAC5B,cAAc,GAAmB,IAAI,cAAc,EAAE,CAAC;IACtD,WAAW,GAER,IAAI,CAAC;IACR,aAAa,GAAG,CAAC,CAAC;IAE1B,YAAoB,UAA+B,EAAE;QAAjC,YAAO,GAAP,OAAO,CAA0B;IAAG,CAAC;IAEzD,MAAM,CACJ,OAAoF;QAEpF,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,MAAc,EACd,YAAkC;QAElC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACnE,CAAC;IAEO,UAAU,GAAG,IAAI,GAAG,EAAkC,CAAC;IAE/D,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;QAE5C,IAAI,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAExC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,EAAa,EAAE,GAAoB,EAAE,EAAE;YACtE,MAAM,MAAM,GAAG,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAC;YAExD,MAAM,SAAS,GAAG,IAAI,sBAAsB,CAAC;gBAC3C,EAAE,EAAE,MAAM;gBACV,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE;oBAChB,IAAI,EAAE,CAAC,UAAU,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;wBAC9B,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACnB,CAAC;gBACH,CAAC;aACF,CAAC,CAAC;YAEH,kBAAkB;YAClB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAEvC,uCAAuC;YACvC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE;gBAChC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAEhC,8BAA8B;oBAC9B,MAAM,KAAK,GAAgB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAE/C,aAAa;oBACb,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;wBAChC,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,uBAAuB,CAAC,CAAC;oBAChE,CAAC;yBAAM,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;wBACnC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,SAAS,IAAI,KAAK,CAAC,SAAS,IAAI,WAAW,CAAC;wBAC3E,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,qBAAqB,SAAS,EAAE,CAAC,CAAC;oBACzE,CAAC;yBAAM,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;wBAClC,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,kBAAkB,CAAC,CAAC;oBAC3D,CAAC;oBAED,qBAAqB;oBACrB,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;oBAEjC,oEAAoE;oBACpE,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;wBAChD,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;oBACtC,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE;wBACtD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;wBAC7D,MAAM;qBACP,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,oBAAoB;YACpB,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;gBACxB,OAAO,CAAC,GAAG,CAAC,qCAAqC,MAAM,EAAE,CAAC,CAAC;gBAC3D,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBAC3D,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE;wBACrD,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;wBACvD,MAAM;qBACP,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;gBACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;gBACxB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACjC,CAAC,CAAC,CAAC;YAEH,gBAAgB;YAChB,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACvB,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE;oBAC/C,KAAK,EAAE,KAAK,CAAC,OAAO;oBACpB,MAAM;iBACP,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,GAAI,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;gBAC7B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/text_output.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Text output for Twilio Media Streams.
+ *
+ * Sends transcribed agent responses as text events to Twilio.
+ */
+import { TextOutput, type TimedString } from '@ariaflow/livekit-plugin';
+/**
+ * Sends agent text responses to Twilio Media Streams.
+ *
+ * Since Twilio Media Streams is primarily audio-focused, this
+ * implementation stores text for potential use in marks/metadata.
+ */
+export declare class TwilioTextOutput extends TextOutput {
+    private closed;
+    private textBuffer;
+    private sendCallback;
+    constructor(nextInChain?: TextOutput);
+    /**
+     * Set the callback for sending marks to Twilio.
+     *
+     * @param callback - Function that sends mark name to WebSocket
+     */
+    setSendCallback(callback: (markName: string) => void): void;
+    captureText(text: string | TimedString): Promise<void>;
+    flush(): void;
+    close(): Promise<void>;
+    /**
+     * Get buffered text (for debugging or logging).
+     */
+    getBufferedText(): string[];
+}
+//# sourceMappingURL=text_output.d.ts.map

package/dist/text_output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text_output.d.ts","sourceRoot":"","sources":["../src/text_output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAiB,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvF;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAgB;IAGlC,OAAO,CAAC,YAAY,CAAwC;gBAEhD,WAAW,CAAC,EAAE,UAAU;IAIpC;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB5D,KAAK,IAAI,IAAI;IAWP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;CAG5B"}

package/dist/text_output.js

@@ -0,0 +1,72 @@
+/**
+ * Text output for Twilio Media Streams.
+ *
+ * Sends transcribed agent responses as text events to Twilio.
+ */
+import { TextOutput, isTimedString } from '@ariaflow/livekit-plugin';
+/**
+ * Sends agent text responses to Twilio Media Streams.
+ *
+ * Since Twilio Media Streams is primarily audio-focused, this
+ * implementation stores text for potential use in marks/metadata.
+ */
+export class TwilioTextOutput extends TextOutput {
+    closed = false;
+    textBuffer = [];
+    // Callback to send marks to Twilio
+    sendCallback = () => { };
+    constructor(nextInChain) {
+        super(nextInChain);
+    }
+    /**
+     * Set the callback for sending marks to Twilio.
+     *
+     * @param callback - Function that sends mark name to WebSocket
+     */
+    setSendCallback(callback) {
+        this.sendCallback = callback;
+    }
+    async captureText(text) {
+        if (this.closed)
+            return;
+        const textContent = isTimedString(text) ? text.text : text;
+        this.textBuffer.push(textContent);
+        // Send as a mark event to Twilio (metadata only)
+        try {
+            this.sendCallback(`agent_response_${this.textBuffer.length}`);
+        }
+        catch (error) {
+            console.error('[TwilioTextOutput] Error sending mark:', {
+                error: error instanceof Error ? error.message : String(error),
+                textLength: textContent.length,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        // Access protected nextInChain property
+        const next = this.nextInChain;
+        if (next) {
+            await next.captureText(text);
+        }
+    }
+    flush() {
+        if (this.closed)
+            return;
+        this.textBuffer = [];
+        // Access protected nextInChain property
+        const next = this.nextInChain;
+        if (next) {
+            next.flush();
+        }
+    }
+    async close() {
+        this.closed = true;
+        this.textBuffer = [];
+    }
+    /**
+     * Get buffered text (for debugging or logging).
+     */
+    getBufferedText() {
+        return [...this.textBuffer];
+    }
+}
+//# sourceMappingURL=text_output.js.map

package/dist/text_output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text_output.js","sourceRoot":"","sources":["../src/text_output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAoB,MAAM,0BAA0B,CAAC;AAEvF;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IACtC,MAAM,GAAY,KAAK,CAAC;IACxB,UAAU,GAAa,EAAE,CAAC;IAElC,mCAAmC;IAC3B,YAAY,GAA+B,GAAG,EAAE,GAAE,CAAC,CAAC;IAE5D,YAAY,WAAwB;QAClC,KAAK,CAAC,WAAW,CAAC,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,QAAoC;QAClD,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAA0B;QAC1C,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAElC,iDAAiD;QACjD,IAAI,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,kBAAkB,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE;gBACtD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,UAAU,EAAE,WAAW,CAAC,MAAM;gBAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QAED,wCAAwC;QACxC,MAAM,IAAI,GAAI,IAAY,CAAC,WAAW,CAAC;QACvC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QAErB,wCAAwC;QACxC,MAAM,IAAI,GAAI,IAAY,CAAC,WAAW,CAAC;QACvC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;CACF"}