getpatter 0.4.4 → 0.5.0

package/dist/index.js

@@ -305,254 +305,16 @@ var init_elevenlabs_convai = __esm({
   }
 });
 
-// src/providers/deepgram-stt.ts
-var import_ws4, DEEPGRAM_WS_URL, DeepgramSTT;
-var init_deepgram_stt = __esm({
-  "src/providers/deepgram-stt.ts"() {
-    "use strict";
-    import_ws4 = __toESM(require("ws"));
-    init_logger();
-    DEEPGRAM_WS_URL = "wss://api.deepgram.com/v1/listen";
-    DeepgramSTT = class _DeepgramSTT {
-      ws = null;
-      callbacks = [];
-      /** Request ID from Deepgram — used to query actual cost post-call. */
-      requestId = "";
-      apiKey;
-      language;
-      model;
-      encoding;
-      sampleRate;
-      endpointingMs;
-      utteranceEndMs;
-      smartFormat;
-      interimResults;
-      vadEvents;
-      constructor(apiKey, languageOrOptions, model, encoding, sampleRate, options) {
-        this.apiKey = apiKey;
-        const opts = typeof languageOrOptions === "object" && languageOrOptions !== null ? languageOrOptions : options ?? {};
-        this.language = (typeof languageOrOptions === "string" ? languageOrOptions : opts.language) ?? "en";
-        this.model = model ?? opts.model ?? "nova-3";
-        this.encoding = encoding ?? opts.encoding ?? "linear16";
-        this.sampleRate = sampleRate ?? opts.sampleRate ?? 16e3;
-        this.endpointingMs = opts.endpointingMs ?? 150;
-        this.utteranceEndMs = opts.utteranceEndMs === null ? null : opts.utteranceEndMs ?? 1e3;
-        this.smartFormat = opts.smartFormat ?? true;
-        this.interimResults = opts.interimResults ?? true;
-        this.vadEvents = opts.vadEvents ?? true;
-      }
-      /** Factory for Twilio calls — mulaw 8 kHz. Forwards tuning options through. */
-      static forTwilio(apiKey, language = "en", model = "nova-3", options = {}) {
-        return new _DeepgramSTT(apiKey, language, model, "mulaw", 8e3, options);
-      }
-      async connect() {
-        const params = new URLSearchParams({
-          model: this.model,
-          language: this.language,
-          encoding: this.encoding,
-          sample_rate: String(this.sampleRate),
-          channels: "1",
-          interim_results: this.interimResults ? "true" : "false",
-          endpointing: String(this.endpointingMs),
-          smart_format: this.smartFormat ? "true" : "false",
-          vad_events: this.vadEvents ? "true" : "false",
-          no_delay: "true"
-        });
-        if (this.utteranceEndMs !== null) {
-          params.set("utterance_end_ms", String(Math.max(this.utteranceEndMs, 1e3)));
-        }
-        const url = `${DEEPGRAM_WS_URL}?${params.toString()}`;
-        this.ws = new import_ws4.default(url, {
-          headers: { Authorization: `Token ${this.apiKey}` }
-        });
-        await new Promise((resolve, reject) => {
-          const timer = setTimeout(() => reject(new Error("Deepgram connect timeout")), 1e4);
-          this.ws.once("open", () => {
-            clearTimeout(timer);
-            resolve();
-          });
-          this.ws.once("error", (err) => {
-            clearTimeout(timer);
-            reject(err);
-          });
-        });
-        this.ws.on("message", (raw) => {
-          let data;
-          try {
-            data = JSON.parse(raw.toString());
-          } catch {
-            return;
-          }
-          if (data.type === "Metadata" && data.request_id) {
-            this.requestId = data.request_id;
-            return;
-          }
-          if (data.type !== "Results") return;
-          const alternatives = data.channel?.alternatives ?? [];
-          if (!alternatives.length) return;
-          const best = alternatives[0];
-          const text = (best.transcript ?? "").trim();
-          if (!text) return;
-          const transcript = {
-            text,
-            isFinal: Boolean(data.is_final) || Boolean(data.speech_final),
-            confidence: best.confidence ?? 0
-          };
-          for (const cb of this.callbacks) {
-            cb(transcript);
-          }
-        });
-      }
-      sendAudio(audio) {
-        if (!this.ws || this.ws.readyState !== import_ws4.default.OPEN) return;
-        this.ws.send(audio);
-      }
-      onTranscript(callback) {
-        if (this.callbacks.length >= 10) {
-          getLogger().warn("DeepgramSTT: maximum of 10 onTranscript callbacks reached; replacing the last callback.");
-          this.callbacks[this.callbacks.length - 1] = callback;
-          return;
-        }
-        this.callbacks.push(callback);
-      }
-      close() {
-        if (this.ws) {
-          try {
-            this.ws.send(JSON.stringify({ type: "CloseStream" }));
-          } catch {
-          }
-          this.ws.close();
-          this.ws = null;
-        }
-      }
-    };
-  }
-});
-
-// src/providers/whisper-stt.ts
-function wrapPcmInWav(pcm, sampleRate = 16e3, channels = 1, bitsPerSample = 16) {
-  const dataSize = pcm.length;
-  const header = Buffer.alloc(44);
-  header.write("RIFF", 0);
-  header.writeUInt32LE(36 + dataSize, 4);
-  header.write("WAVE", 8);
-  header.write("fmt ", 12);
-  header.writeUInt32LE(16, 16);
-  header.writeUInt16LE(1, 20);
-  header.writeUInt16LE(channels, 22);
-  header.writeUInt32LE(sampleRate, 24);
-  header.writeUInt32LE(sampleRate * channels * (bitsPerSample / 8), 28);
-  header.writeUInt16LE(channels * (bitsPerSample / 8), 32);
-  header.writeUInt16LE(bitsPerSample, 34);
-  header.write("data", 36);
-  header.writeUInt32LE(dataSize, 40);
-  return Buffer.concat([header, pcm]);
+// src/provider-factory.ts
+async function createSTT(agent) {
+  return agent.stt ?? null;
 }
-var OPENAI_TRANSCRIPTION_URL, DEFAULT_BUFFER_SIZE, WhisperSTT;
-var init_whisper_stt = __esm({
-  "src/providers/whisper-stt.ts"() {
+async function createTTS(agent) {
+  return agent.tts ?? null;
+}
+var init_provider_factory = __esm({
+  "src/provider-factory.ts"() {
     "use strict";
-    init_logger();
-    OPENAI_TRANSCRIPTION_URL = "https://api.openai.com/v1/audio/transcriptions";
-    DEFAULT_BUFFER_SIZE = 16e3 * 2;
-    WhisperSTT = class _WhisperSTT {
-      apiKey;
-      model;
-      language;
-      bufferSize;
-      buffer = Buffer.alloc(0);
-      callbacks = [];
-      running = false;
-      pendingTranscriptions = [];
-      constructor(apiKey, model = "whisper-1", language, bufferSize = DEFAULT_BUFFER_SIZE) {
-        this.apiKey = apiKey;
-        this.model = model;
-        this.language = language;
-        this.bufferSize = bufferSize;
-      }
-      /** Factory for Twilio calls — mulaw 8 kHz is transcoded upstream, so we still receive PCM 16-bit. */
-      static forTwilio(apiKey, language = "en", model = "whisper-1") {
-        return new _WhisperSTT(apiKey, model, language);
-      }
-      async connect() {
-        this.running = true;
-        this.buffer = Buffer.alloc(0);
-      }
-      sendAudio(audio) {
-        if (!this.running) return;
-        this.buffer = Buffer.concat([this.buffer, audio]);
-        if (this.buffer.length >= this.bufferSize) {
-          const pcm = this.buffer;
-          this.buffer = Buffer.alloc(0);
-          this.trackTranscription(this.transcribeBuffer(pcm));
-        }
-      }
-      trackTranscription(promise) {
-        const wrapped = promise.finally(() => {
-          const idx = this.pendingTranscriptions.indexOf(wrapped);
-          if (idx !== -1) this.pendingTranscriptions.splice(idx, 1);
-        });
-        this.pendingTranscriptions.push(wrapped);
-      }
-      onTranscript(callback) {
-        if (this.callbacks.length >= 10) {
-          getLogger().warn("WhisperSTT: maximum of 10 onTranscript callbacks reached; replacing the last callback.");
-          this.callbacks[this.callbacks.length - 1] = callback;
-          return;
-        }
-        this.callbacks.push(callback);
-      }
-      async close() {
-        this.running = false;
-        if (this.buffer.length >= this.bufferSize / 4) {
-          const pcm = this.buffer;
-          this.buffer = Buffer.alloc(0);
-          this.trackTranscription(this.transcribeBuffer(pcm));
-        } else {
-          this.buffer = Buffer.alloc(0);
-        }
-        await Promise.allSettled(this.pendingTranscriptions);
-        this.callbacks = [];
-      }
-      // ------------------------------------------------------------------
-      // Private
-      // ------------------------------------------------------------------
-      async transcribeBuffer(pcm) {
-        const wav = wrapPcmInWav(pcm);
-        const formData = new FormData();
-        formData.append("file", new Blob([wav.buffer.slice(wav.byteOffset, wav.byteOffset + wav.byteLength)], { type: "audio/wav" }), "audio.wav");
-        formData.append("model", this.model);
-        if (this.language) {
-          formData.append("language", this.language);
-        }
-        try {
-          const resp = await fetch(OPENAI_TRANSCRIPTION_URL, {
-            method: "POST",
-            headers: { Authorization: `Bearer ${this.apiKey}` },
-            body: formData,
-            signal: AbortSignal.timeout(15e3)
-          });
-          if (!resp.ok) {
-            const body = await resp.text();
-            getLogger().error(`WhisperSTT transcription error: ${resp.status} ${body}`);
-            return;
-          }
-          const json = await resp.json();
-          const text = (json.text ?? "").trim();
-          if (!text) return;
-          const transcript = {
-            text,
-            isFinal: true,
-            confidence: 1
-          };
-          for (const cb of this.callbacks) {
-            cb(transcript);
-          }
-        } catch (err) {
-          getLogger().error(`WhisperSTT transcription error: ${String(err)}`);
-        }
-      }
-    };
   }
 });
 
@@ -1972,258 +1734,125 @@ var init_remote_message = __esm({
   }
 });
 
-// src/providers/elevenlabs-tts.ts
-function resolveVoiceId(voice) {
-  if (!voice) return voice;
-  if (VOICE_ID_PATTERN.test(voice)) return voice;
-  return ELEVENLABS_VOICE_ID_BY_NAME[voice.toLowerCase()] ?? voice;
-}
-var ELEVENLABS_BASE_URL, ELEVENLABS_VOICE_ID_BY_NAME, VOICE_ID_PATTERN, ElevenLabsTTS;
-var init_elevenlabs_tts = __esm({
-  "src/providers/elevenlabs-tts.ts"() {
+// src/providers/deepgram-stt.ts
+var import_ws4, DEEPGRAM_WS_URL, DeepgramSTT;
+var init_deepgram_stt = __esm({
+  "src/providers/deepgram-stt.ts"() {
     "use strict";
-    ELEVENLABS_BASE_URL = "https://api.elevenlabs.io/v1";
-    ELEVENLABS_VOICE_ID_BY_NAME = {
-      rachel: "21m00Tcm4TlvDq8ikWAM",
-      drew: "29vD33N1CtxCmqQRPOHJ",
-      clyde: "2EiwWnXFnvU5JabPnv8n",
-      paul: "5Q0t7uMcjvnagumLfvZi",
-      domi: "AZnzlk1XvdvUeBnXmlld",
-      dave: "CYw3kZ02Hs0563khs1Fj",
-      fin: "D38z5RcWu1voky8WS1ja",
-      bella: "EXAVITQu4vr4xnSDxMaL",
-      antoni: "ErXwobaYiN019PkySvjV",
-      thomas: "GBv7mTt0atIp3Br8iCZE",
-      charlie: "IKne3meq5aSn9XLyUdCD",
-      george: "JBFqnCBsd6RMkjVDRZzb",
-      emily: "LcfcDJNUP1GQjkzn1xUU",
-      elli: "MF3mGyEYCl7XYWbV9V6O",
-      callum: "N2lVS1w4EtoT3dr4eOWO",
-      patrick: "ODq5zmih8GrVes37Dizd",
-      harry: "SOYHLrjzK2X1ezoPC6cr",
-      liam: "TX3LPaxmHKxFdv7VOQHJ",
-      dorothy: "ThT5KcBeYPX3keUQqHPh",
-      josh: "TxGEqnHWrfWFTfGW9XjX",
-      arnold: "VR6AewLTigWG4xSOukaG",
-      charlotte: "XB0fDUnXU5powFXDhCwa",
-      matilda: "XrExE9yKIg1WjnnlVkGX",
-      matthew: "Yko7PKHZNXotIFUBG7I9",
-      james: "ZQe5CZNOzWyzPSCn5a3c",
-      joseph: "Zlb1dXrM653N07WRdFW3",
-      jeremy: "bVMeCyTHy58xNoL34h3p",
-      michael: "flq6f7yk4E4fJM5XTYuZ",
-      ethan: "g5CIjZEefAph4nQFvHAz",
-      gigi: "jBpfuIE2acCO8z3wKNLl",
-      freya: "jsCqWAovK2LkecY7zXl4",
-      brian: "nPczCjzI2devNBz1zQrb",
-      grace: "oWAxZDx7w5VEj9dCyTzz",
-      daniel: "onwK4e9ZLuTAKqWW03F9",
-      lily: "pFZP5JQG7iQjIQuC4Bku",
-      serena: "pMsXgVXv3BLzUgSXRplE",
-      adam: "pNInz6obpgDQGcFmaJgB",
-      nicole: "piTKgcLEGmPE4e6mEKli",
-      bill: "pqHfZKP75CvOlQylNhV4",
-      jessie: "t0jbNlBVZ17f02VDIeMI",
-      ryan: "wViXBPUzp2ZZixB1xQuM",
-      sam: "yoZ06aMxZJJ28mfd3POQ",
-      glinda: "z9fAnlkpzviPz146aGWa",
-      giovanni: "zcAOhNBS3c14rBihAFp1",
-      mimi: "zrHiDhphv9ZnVXBqCLjz",
-      alloy: "21m00Tcm4TlvDq8ikWAM"
-    };
-    VOICE_ID_PATTERN = /^[A-Za-z0-9]{20}$/;
-    ElevenLabsTTS = class {
-      constructor(apiKey, voiceId = "21m00Tcm4TlvDq8ikWAM", modelId = "eleven_turbo_v2_5", outputFormat = "pcm_16000") {
+    import_ws4 = __toESM(require("ws"));
+    init_logger();
+    DEEPGRAM_WS_URL = "wss://api.deepgram.com/v1/listen";
+    DeepgramSTT = class _DeepgramSTT {
+      ws = null;
+      callbacks = [];
+      /** Request ID from Deepgram — used to query actual cost post-call. */
+      requestId = "";
+      apiKey;
+      language;
+      model;
+      encoding;
+      sampleRate;
+      endpointingMs;
+      utteranceEndMs;
+      smartFormat;
+      interimResults;
+      vadEvents;
+      constructor(apiKey, languageOrOptions, model, encoding, sampleRate, options) {
         this.apiKey = apiKey;
-        this.modelId = modelId;
-        this.outputFormat = outputFormat;
-        this.voiceId = resolveVoiceId(voiceId);
+        const opts = typeof languageOrOptions === "object" && languageOrOptions !== null ? languageOrOptions : options ?? {};
+        this.language = (typeof languageOrOptions === "string" ? languageOrOptions : opts.language) ?? "en";
+        this.model = model ?? opts.model ?? "nova-3";
+        this.encoding = encoding ?? opts.encoding ?? "linear16";
+        this.sampleRate = sampleRate ?? opts.sampleRate ?? 16e3;
+        this.endpointingMs = opts.endpointingMs ?? 150;
+        this.utteranceEndMs = opts.utteranceEndMs === null ? null : opts.utteranceEndMs ?? 1e3;
+        this.smartFormat = opts.smartFormat ?? true;
+        this.interimResults = opts.interimResults ?? true;
+        this.vadEvents = opts.vadEvents ?? true;
       }
-      voiceId;
-      /**
-       * Synthesise text to speech and return the full audio as a single Buffer.
-       *
-       * For large chunks (or when latency matters) call `synthesizeStream` instead.
-       */
-      async synthesize(text) {
-        const chunks = [];
-        for await (const chunk of this.synthesizeStream(text)) {
-          chunks.push(chunk);
-        }
-        return Buffer.concat(chunks);
+      /** Factory for Twilio calls — mulaw 8 kHz. Forwards tuning options through. */
+      static forTwilio(apiKey, language = "en", model = "nova-3", options = {}) {
+        return new _DeepgramSTT(apiKey, language, model, "mulaw", 8e3, options);
       }
-      /**
-       * Synthesise text and yield audio chunks as they arrive (streaming).
-       *
-       * The yielded buffers are raw PCM at 16 kHz (or whatever `outputFormat` is
-       * configured to).
-       */
-      async *synthesizeStream(text) {
-        const url = `${ELEVENLABS_BASE_URL}/text-to-speech/${encodeURIComponent(this.voiceId)}/stream?output_format=${encodeURIComponent(this.outputFormat)}`;
-        const response = await fetch(url, {
-          method: "POST",
-          headers: {
-            "xi-api-key": this.apiKey,
-            "Content-Type": "application/json"
-          },
-          body: JSON.stringify({ text, model_id: this.modelId }),
-          signal: AbortSignal.timeout(3e4)
+      async connect() {
+        const params = new URLSearchParams({
+          model: this.model,
+          language: this.language,
+          encoding: this.encoding,
+          sample_rate: String(this.sampleRate),
+          channels: "1",
+          interim_results: this.interimResults ? "true" : "false",
+          endpointing: String(this.endpointingMs),
+          smart_format: this.smartFormat ? "true" : "false",
+          vad_events: this.vadEvents ? "true" : "false",
+          no_delay: "true"
         });
-        if (!response.ok) {
-          const body = await response.text();
-          throw new Error(`ElevenLabs TTS error ${response.status}: ${body}`);
-        }
-        if (!response.body) {
-          throw new Error("ElevenLabs TTS: no response body");
+        if (this.utteranceEndMs !== null) {
+          params.set("utterance_end_ms", String(Math.max(this.utteranceEndMs, 1e3)));
         }
-        const reader = response.body.getReader();
-        try {
-          while (true) {
-            const { done, value } = await reader.read();
-            if (done) break;
-            if (value && value.length > 0) {
-              yield Buffer.from(value);
-            }
-          }
-        } finally {
-          if (typeof reader.cancel === "function") await reader.cancel().catch(() => {
+        const url = `${DEEPGRAM_WS_URL}?${params.toString()}`;
+        this.ws = new import_ws4.default(url, {
+          headers: { Authorization: `Token ${this.apiKey}` }
+        });
+        await new Promise((resolve, reject) => {
+          const timer = setTimeout(() => reject(new Error("Deepgram connect timeout")), 1e4);
+          this.ws.once("open", () => {
+            clearTimeout(timer);
+            resolve();
+          });
+          this.ws.once("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
           });
-          reader.releaseLock();
-        }
-      }
-    };
-  }
-});
-
-// src/providers/openai-tts.ts
-var OPENAI_TTS_URL, OpenAITTS;
-var init_openai_tts = __esm({
-  "src/providers/openai-tts.ts"() {
-    "use strict";
-    OPENAI_TTS_URL = "https://api.openai.com/v1/audio/speech";
-    OpenAITTS = class _OpenAITTS {
-      constructor(apiKey, voice = "alloy", model = "tts-1") {
-        this.apiKey = apiKey;
-        this.voice = voice;
-        this.model = model;
-      }
-      /**
-       * Synthesise text to speech and return the full audio as a single Buffer.
-       *
-       * For large chunks (or when latency matters) call `synthesizeStream` instead.
-       */
-      async synthesize(text) {
-        const chunks = [];
-        for await (const chunk of this.synthesizeStream(text)) {
-          chunks.push(chunk);
-        }
-        return Buffer.concat(chunks);
-      }
-      /**
-       * Synthesise text and yield audio chunks as they arrive (streaming).
-       *
-       * OpenAI returns 24 kHz PCM16; each chunk is resampled to 16 kHz before
-       * yielding so the output is ready for telephony pipelines.
-       *
-       * The resampler carries state (buffered samples + odd trailing byte)
-       * between chunks — without that state cross-chunk sample alignment drifts
-       * and the caller hears pops / dropped audio (BUG #23, mirror of the
-       * Python `audioop.ratecv` fix).
-       */
-      async *synthesizeStream(text) {
-        const response = await fetch(OPENAI_TTS_URL, {
-          method: "POST",
-          headers: {
-            "Authorization": `Bearer ${this.apiKey}`,
-            "Content-Type": "application/json"
-          },
-          body: JSON.stringify({
-            model: this.model,
-            input: text,
-            voice: this.voice,
-            response_format: "pcm"
-          }),
-          signal: AbortSignal.timeout(3e4)
         });
-        if (!response.ok) {
-          const body = await response.text();
-          throw new Error(`OpenAI TTS error ${response.status}: ${body}`);
-        }
-        if (!response.body) {
-          throw new Error("OpenAI TTS: no response body");
-        }
-        const ctx = { carryByte: null, leftover: [] };
-        const reader = response.body.getReader();
-        try {
-          while (true) {
-            const { done, value } = await reader.read();
-            if (done) break;
-            if (value && value.length > 0) {
-              const out = _OpenAITTS.resampleStreaming(Buffer.from(value), ctx);
-              if (out.length > 0) yield out;
-            }
+        this.ws.on("message", (raw) => {
+          let data;
+          try {
+            data = JSON.parse(raw.toString());
+          } catch {
+            return;
           }
-          if (ctx.leftover.length > 0) {
-            const tail = Buffer.alloc(ctx.leftover.length * 2);
-            for (let i = 0; i < ctx.leftover.length; i++) {
-              tail.writeInt16LE(ctx.leftover[i], i * 2);
-            }
-            yield tail;
+          if (data.type === "Metadata" && data.request_id) {
+            this.requestId = data.request_id;
+            return;
           }
-        } finally {
-          if (typeof reader.cancel === "function") await reader.cancel().catch(() => {
-          });
-          reader.releaseLock();
+          if (data.type !== "Results") return;
+          const alternatives = data.channel?.alternatives ?? [];
+          if (!alternatives.length) return;
+          const best = alternatives[0];
+          const text = (best.transcript ?? "").trim();
+          if (!text) return;
+          const transcript = {
+            text,
+            isFinal: Boolean(data.is_final) || Boolean(data.speech_final),
+            confidence: best.confidence ?? 0
+          };
+          for (const cb of this.callbacks) {
+            cb(transcript);
+          }
+        });
+      }
+      sendAudio(audio) {
+        if (!this.ws || this.ws.readyState !== import_ws4.default.OPEN) return;
+        this.ws.send(audio);
+      }
+      onTranscript(callback) {
+        if (this.callbacks.length >= 10) {
+          getLogger().warn("DeepgramSTT: maximum of 10 onTranscript callbacks reached; replacing the last callback.");
+          this.callbacks[this.callbacks.length - 1] = callback;
+          return;
         }
+        this.callbacks.push(callback);
       }
-      /**
-       * Streaming 24 kHz → 16 kHz resampler (PCM16-LE). Maintains cross-chunk
-       * state so the 3:2 pattern doesn't reset at every network read.
-       */
-      static resampleStreaming(audio, ctx) {
-        let buf;
-        if (ctx.carryByte !== null) {
-          buf = Buffer.concat([Buffer.from([ctx.carryByte]), audio]);
-          ctx.carryByte = null;
-        } else {
-          buf = audio;
-        }
-        if (buf.length % 2 === 1) {
-          ctx.carryByte = buf[buf.length - 1];
-          buf = buf.subarray(0, buf.length - 1);
-        }
-        if (buf.length === 0 && ctx.leftover.length === 0) {
-          return Buffer.alloc(0);
-        }
-        const sampleCount = buf.length / 2;
-        const samples = ctx.leftover.slice();
-        for (let i2 = 0; i2 < sampleCount; i2++) {
-          samples.push(buf.readInt16LE(i2 * 2));
-        }
-        const out = [];
-        let i = 0;
-        while (i + 2 < samples.length) {
-          out.push(samples[i]);
-          out.push(Math.trunc((samples[i + 1] + samples[i + 2]) / 2));
-          i += 3;
-        }
-        ctx.leftover = samples.slice(i);
-        const buffer = Buffer.alloc(out.length * 2);
-        for (let j = 0; j < out.length; j++) {
-          buffer.writeInt16LE(out[j], j * 2);
-        }
-        return buffer;
-      }
-      /** @deprecated use {@link resampleStreaming} with persistent state. */
-      static resample24kTo16k(audio) {
-        const ctx = { carryByte: null, leftover: [] };
-        const out = _OpenAITTS.resampleStreaming(audio, ctx);
-        if (ctx.leftover.length === 0) return out;
-        const tail = Buffer.alloc(ctx.leftover.length * 2);
-        for (let i = 0; i < ctx.leftover.length; i++) {
-          tail.writeInt16LE(ctx.leftover[i], i * 2);
+      close() {
+        if (this.ws) {
+          try {
+            this.ws.send(JSON.stringify({ type: "CloseStream" }));
+          } catch {
+          }
+          this.ws.close();
+          this.ws = null;
         }
-        return Buffer.concat([out, tail]);
       }
     };
   }
@@ -3133,8 +2762,8 @@ var init_stream_handler = __esm({
     "use strict";
     init_openai_realtime();
     init_elevenlabs_convai();
-    init_elevenlabs_tts();
-    init_openai_tts();
+    init_deepgram_stt();
+    init_provider_factory();
     init_metrics();
     init_transcoding();
     init_llm_loop();
@@ -3176,8 +2805,8 @@ var init_stream_handler = __esm({
         this.caller = caller;
         this.callee = callee;
         this.history = createHistoryManager(200);
-        const sttProviderName = deps.agent.stt?.provider || (deps.agent.deepgramKey ? "deepgram" : void 0);
-        const ttsProviderName = deps.agent.tts?.provider === "elevenlabs" ? "elevenlabs" : deps.agent.tts?.provider === "openai" ? "openai_tts" : deps.agent.elevenlabsKey ? "elevenlabs" : void 0;
+        const sttProviderName = deps.agent.stt ? deps.agent.stt.constructor?.name ?? "custom" : void 0;
+        const ttsProviderName = deps.agent.tts ? deps.agent.tts.constructor?.name ?? "custom" : void 0;
         const providerMode = deps.agent.provider ?? "openai_realtime";
         this.metricsAcc = new CallMetricsAccumulator({
           callId: "",
@@ -3367,17 +2996,8 @@ var init_stream_handler = __esm({
       // ---------------------------------------------------------------------------
       async initPipeline(resolvedPrompt) {
         const label = this.deps.bridge.label;
-        this.stt = this.deps.bridge.createStt(this.deps.agent);
-        if (this.deps.agent.tts) {
-          if (this.deps.agent.tts.provider === "elevenlabs") {
-            this.tts = new ElevenLabsTTS(this.deps.agent.tts.apiKey, this.deps.agent.tts.voice ?? "21m00Tcm4TlvDq8ikWAM");
-          }
-          if (this.deps.agent.tts.provider === "openai") {
-            this.tts = new OpenAITTS(this.deps.agent.tts.apiKey, this.deps.agent.tts.voice ?? "alloy");
-          }
-        } else if (this.deps.agent.elevenlabsKey) {
-          this.tts = new ElevenLabsTTS(this.deps.agent.elevenlabsKey, this.deps.agent.voice || "rachel");
-        }
+        this.stt = await this.deps.bridge.createStt(this.deps.agent);
+        this.tts = await createTTS(this.deps.agent);
         if (!this.stt) {
           getLogger().info(`Pipeline mode (${label}): no STT configured`);
         }
@@ -3895,10 +3515,11 @@ var init_stream_handler = __esm({
           this.maxDurationTimer = null;
         }
         await this.deps.bridge.queryTelephonyCost(this.metricsAcc, this.callId);
-        const deepgramKey = this.deps.agent.deepgramKey;
-        const deepgramRequestId = this.stt?.requestId;
-        if (deepgramKey && deepgramRequestId) {
-          await queryDeepgramCost(this.metricsAcc, deepgramKey, deepgramRequestId);
+        if (this.stt instanceof DeepgramSTT && this.stt.requestId) {
+          const dgKey = this.stt.apiKey;
+          if (dgKey) {
+            await queryDeepgramCost(this.metricsAcc, dgKey, this.stt.requestId);
+          }
         }
         const finalMetrics = this.metricsAcc.endCall();
         const callEndData = {
@@ -4000,11 +3621,16 @@ function resolveVariables(template, variables) {
   return result;
 }
 function buildAIAdapter(config, agent, resolvedPrompt) {
+  const engine = agent.engine;
   if (agent.provider === "elevenlabs_convai") {
-    const key = agent.elevenlabsKey ?? "";
+    if (!engine || engine.kind !== "elevenlabs_convai") {
+      throw new Error(
+        "ElevenLabs ConvAI mode requires `agent.engine = new ElevenLabsConvAI({...})`."
+      );
+    }
     return new ElevenLabsConvAIAdapter(
-      key,
-      agent.elevenlabsAgentId ?? "",
+      engine.apiKey,
+      engine.agentId,
       agent.voice ?? "21m00Tcm4TlvDq8ikWAM",
       "eleven_turbo_v2_5",
       agent.language ?? "en",
@@ -4017,33 +3643,15 @@ function buildAIAdapter(config, agent, resolvedPrompt) {
     parameters: t.parameters
   })) ?? [];
   const tools = [...agentTools, TRANSFER_CALL_TOOL, END_CALL_TOOL];
+  const openaiKey = engine && engine.kind === "openai_realtime" ? engine.apiKey : config.openaiKey ?? "";
   return new OpenAIRealtimeAdapter(
-    config.openaiKey ?? "",
+    openaiKey,
     agent.model,
     agent.voice,
     resolvedPrompt ?? agent.systemPrompt,
     tools
   );
 }
-function extractDeepgramOptions(options) {
-  if (!options) return {};
-  const get = (snake, camel) => options[snake] ?? options[camel];
-  const out = {};
-  const model = get("model", "model");
-  if (typeof model === "string") out.model = model;
-  const endpointing = get("endpointing_ms", "endpointingMs");
-  if (typeof endpointing === "number") out.endpointingMs = endpointing;
-  const utteranceEnd = get("utterance_end_ms", "utteranceEndMs");
-  if (utteranceEnd === null) out.utteranceEndMs = null;
-  else if (typeof utteranceEnd === "number") out.utteranceEndMs = utteranceEnd;
-  const smart = get("smart_format", "smartFormat");
-  if (typeof smart === "boolean") out.smartFormat = smart;
-  const interim = get("interim_results", "interimResults");
-  if (typeof interim === "boolean") out.interimResults = interim;
-  const vad = get("vad_events", "vadEvents");
-  if (typeof vad === "boolean") out.vadEvents = vad;
-  return out;
-}
 function isValidTelnyxTransferTarget(target) {
   if (typeof target !== "string" || !target) return false;
   if (/^\+[1-9]\d{6,14}$/.test(target)) return true;
@@ -4063,8 +3671,7 @@ var init_server = __esm({
     import_ws5 = require("ws");
     init_openai_realtime();
     init_elevenlabs_convai();
-    init_deepgram_stt();
-    init_whisper_stt();
+    init_provider_factory();
     init_pricing();
     init_store();
     init_routes();
@@ -4149,24 +3756,7 @@ var init_server = __esm({
         }
       }
       createStt(agent) {
-        const isPipeline = agent.provider === "pipeline";
-        if (agent.stt) {
-          if (agent.stt.provider === "deepgram") {
-            const dgOptions = extractDeepgramOptions(agent.stt.options);
-            if (isPipeline) {
-              return new DeepgramSTT(agent.stt.apiKey, agent.stt.language ?? "en", dgOptions.model, "linear16", 16e3, dgOptions);
-            }
-            return DeepgramSTT.forTwilio(agent.stt.apiKey, agent.stt.language ?? "en", dgOptions.model, dgOptions);
-          } else if (agent.stt.provider === "whisper") {
-            return isPipeline ? new WhisperSTT(agent.stt.apiKey, "whisper-1", agent.stt.language ?? "en") : WhisperSTT.forTwilio(agent.stt.apiKey, agent.stt.language ?? "en");
-          }
-        } else if (agent.deepgramKey) {
-          if (isPipeline) {
-            return new DeepgramSTT(agent.deepgramKey, agent.language ?? "en", "nova-3", "linear16", 16e3);
-          }
-          return DeepgramSTT.forTwilio(agent.deepgramKey, agent.language ?? "en");
-        }
-        return null;
+        return createSTT(agent);
       }
       async queryTelephonyCost(metricsAcc, callId) {
         if (this.config.twilioSid && this.config.twilioToken && callId) {
@@ -4304,24 +3894,7 @@ var init_server = __esm({
         ws.close();
       }
       createStt(agent) {
-        if (agent.stt) {
-          if (agent.stt.provider === "deepgram") {
-            const dgOptions = extractDeepgramOptions(agent.stt.options);
-            return new DeepgramSTT(
-              agent.stt.apiKey,
-              agent.stt.language ?? "en",
-              dgOptions.model ?? "nova-3",
-              "linear16",
-              16e3,
-              dgOptions
-            );
-          } else if (agent.stt.provider === "whisper") {
-            return new WhisperSTT(agent.stt.apiKey, "whisper-1", agent.stt.language ?? "en");
-          }
-        } else if (agent.deepgramKey) {
-          return new DeepgramSTT(agent.deepgramKey, agent.language ?? "en", "nova-3", "linear16", 16e3);
-        }
-        return null;
+        return createSTT(agent);
       }
       async queryTelephonyCost(metricsAcc, callId) {
         if (this.config.telnyxKey && callId) {
@@ -5760,6 +5333,94 @@ var init_tunnel = __esm({
   }
 });
 
+// src/carrier-config.ts
+var carrier_config_exports = {};
+__export(carrier_config_exports, {
+  autoConfigureCarrier: () => autoConfigureCarrier,
+  configureTelnyxNumber: () => configureTelnyxNumber,
+  configureTwilioNumber: () => configureTwilioNumber
+});
+async function configureTwilioNumber(accountSid, authToken, phoneNumber, voiceUrl) {
+  const auth = `Basic ${Buffer.from(`${accountSid}:${authToken}`).toString("base64")}`;
+  const listUrl = `${TWILIO_API_BASE}/Accounts/${accountSid}/IncomingPhoneNumbers.json?PhoneNumber=${encodeURIComponent(phoneNumber)}`;
+  const listResp = await fetch(listUrl, {
+    method: "GET",
+    headers: { Authorization: auth }
+  });
+  if (!listResp.ok) {
+    throw new Error(
+      `Twilio IncomingPhoneNumbers.list failed: ${listResp.status} ${await listResp.text()}`
+    );
+  }
+  const body = await listResp.json();
+  const match = body.incoming_phone_numbers?.[0];
+  if (!match) {
+    throw new Error(`Twilio number ${phoneNumber} not found on account ${accountSid}`);
+  }
+  const updateUrl = `${TWILIO_API_BASE}/Accounts/${accountSid}/IncomingPhoneNumbers/${match.sid}.json`;
+  const form = new URLSearchParams({ VoiceUrl: voiceUrl, VoiceMethod: "POST" });
+  const updateResp = await fetch(updateUrl, {
+    method: "POST",
+    headers: {
+      Authorization: auth,
+      "Content-Type": "application/x-www-form-urlencoded"
+    },
+    body: form.toString()
+  });
+  if (!updateResp.ok) {
+    throw new Error(
+      `Twilio IncomingPhoneNumbers.update failed: ${updateResp.status} ${await updateResp.text()}`
+    );
+  }
+}
+async function configureTelnyxNumber(apiKey, connectionId, phoneNumber) {
+  const resp = await fetch(`${TELNYX_API_BASE}/phone_numbers/${encodeURIComponent(phoneNumber)}`, {
+    method: "PATCH",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ connection_id: connectionId })
+  });
+  if (!resp.ok) {
+    throw new Error(
+      `Telnyx PATCH /phone_numbers/${phoneNumber} failed: ${resp.status} ${await resp.text()}`
+    );
+  }
+}
+async function autoConfigureCarrier(params) {
+  const log2 = getLogger();
+  const provider = params.telephonyProvider ?? (params.twilioSid ? "twilio" : "telnyx");
+  if (provider === "twilio" && params.twilioSid && params.twilioToken) {
+    const voiceUrl = `https://${params.webhookHost}/webhooks/twilio/voice`;
+    try {
+      await configureTwilioNumber(params.twilioSid, params.twilioToken, params.phoneNumber, voiceUrl);
+      log2.info("Twilio webhook set to %s", voiceUrl);
+    } catch (err) {
+      log2.warn("Could not auto-configure Twilio webhook: %s", err instanceof Error ? err.message : String(err));
+      log2.info("Set webhook manually to: %s", voiceUrl);
+    }
+    return;
+  }
+  if (provider === "telnyx" && params.telnyxKey && params.telnyxConnectionId) {
+    try {
+      await configureTelnyxNumber(params.telnyxKey, params.telnyxConnectionId, params.phoneNumber);
+      log2.info("Telnyx number %s associated with connection %s", params.phoneNumber, params.telnyxConnectionId);
+    } catch (err) {
+      log2.warn("Could not auto-configure Telnyx number: %s", err instanceof Error ? err.message : String(err));
+    }
+  }
+}
+var TWILIO_API_BASE, TELNYX_API_BASE;
+var init_carrier_config = __esm({
+  "src/carrier-config.ts"() {
+    "use strict";
+    init_logger();
+    TWILIO_API_BASE = "https://api.twilio.com/2010-04-01";
+    TELNYX_API_BASE = "https://api.telnyx.com/v2";
+  }
+});
+
 // src/test-mode.ts
 var test_mode_exports = {};
 __export(test_mode_exports, {
@@ -6874,31 +6535,35 @@ var require_node_cron = __commonJS({
 var index_exports = {};
 __export(index_exports, {
   AllProvidersFailedError: () => AllProvidersFailedError,
-  AssemblyAISTT: () => AssemblyAISTT,
+  AssemblyAISTT: () => STT5,
   AuthenticationError: () => AuthenticationError,
   BackgroundAudioPlayer: () => BackgroundAudioPlayer,
   BuiltinAudioClip: () => BuiltinAudioClip,
   CallMetricsAccumulator: () => CallMetricsAccumulator,
-  CartesiaSTT: () => CartesiaSTT,
-  CartesiaTTS: () => CartesiaTTS,
+  CartesiaSTT: () => STT3,
+  CartesiaTTS: () => TTS3,
   ChatContext: () => ChatContext,
+  CloudflareTunnel: () => CloudflareTunnel,
   DEFAULT_MIN_SENTENCE_LEN: () => DEFAULT_MIN_SENTENCE_LEN,
   DEFAULT_PRICING: () => DEFAULT_PRICING,
   DTMF_EVENTS: () => DTMF_EVENTS,
-  DeepgramSTT: () => DeepgramSTT,
+  DeepgramSTT: () => STT,
+  ElevenLabsConvAI: () => ConvAI,
   ElevenLabsConvAIAdapter: () => ElevenLabsConvAIAdapter,
-  ElevenLabsTTS: () => ElevenLabsTTS,
+  ElevenLabsTTS: () => TTS,
   FallbackLLMProvider: () => FallbackLLMProvider,
   GEMINI_DEFAULT_INPUT_SR: () => GEMINI_DEFAULT_INPUT_SR,
   GEMINI_DEFAULT_OUTPUT_SR: () => GEMINI_DEFAULT_OUTPUT_SR,
   GeminiLiveAdapter: () => GeminiLiveAdapter,
+  Guardrail: () => Guardrail,
   IVRActivity: () => IVRActivity,
   LLMLoop: () => LLMLoop,
-  LMNTTTS: () => LMNTTTS,
+  LMNTTTS: () => TTS5,
   MetricsStore: () => MetricsStore,
   OpenAILLMProvider: () => OpenAILLMProvider,
+  OpenAIRealtime: () => Realtime,
   OpenAIRealtimeAdapter: () => OpenAIRealtimeAdapter,
-  OpenAITTS: () => OpenAITTS,
+  OpenAITTS: () => TTS2,
   PartialStreamError: () => PartialStreamError,
   Patter: () => Patter,
   PatterConnectionError: () => PatterConnectionError,
@@ -6906,15 +6571,19 @@ __export(index_exports, {
   PipelineHookExecutor: () => PipelineHookExecutor,
   ProvisionError: () => ProvisionError,
   RemoteMessageHandler: () => RemoteMessageHandler,
-  RimeTTS: () => RimeTTS,
+  RimeTTS: () => TTS4,
   SentenceChunker: () => SentenceChunker,
-  SonioxSTT: () => SonioxSTT,
+  SonioxSTT: () => STT4,
+  StaticTunnel: () => Static,
+  Telnyx: () => Carrier2,
   TestSession: () => TestSession,
   TfidfLoopDetector: () => TfidfLoopDetector,
+  Tool: () => Tool,
+  Twilio: () => Carrier,
   ULTRAVOX_DEFAULT_API_BASE: () => ULTRAVOX_DEFAULT_API_BASE,
   ULTRAVOX_DEFAULT_SR: () => ULTRAVOX_DEFAULT_SR,
   UltravoxRealtimeAdapter: () => UltravoxRealtimeAdapter,
-  WhisperSTT: () => WhisperSTT,
+  WhisperSTT: () => STT2,
   builtinClipPath: () => builtinClipPath,
   calculateRealtimeCost: () => calculateRealtimeCost,
   calculateSttCost: () => calculateSttCost,
@@ -6930,6 +6599,7 @@ __export(index_exports, {
   filterMarkdown: () => filterMarkdown,
   formatDtmf: () => formatDtmf,
   getLogger: () => getLogger,
+  guardrail: () => guardrail,
   isRemoteUrl: () => isRemoteUrl,
   isWebSocketUrl: () => isWebSocketUrl,
   makeAuthMiddleware: () => makeAuthMiddleware,
@@ -6951,6 +6621,7 @@ __export(index_exports, {
   selectSoundFromList: () => selectSoundFromList,
   setLogger: () => setLogger,
   startTunnel: () => startTunnel,
+  tool: () => tool,
   whisper: () => whisper
 });
 module.exports = __toCommonJS(index_exports);
@@ -7096,77 +6767,69 @@ var PatterConnection = class {
   }
 };
 
-// src/providers.ts
-var STTConfigImpl = class {
-  provider;
+// src/client.ts
+init_server();
+
+// src/engines/openai.ts
+var Realtime = class {
+  kind = "openai_realtime";
   apiKey;
-  language;
-  options;
-  constructor(provider, apiKey, language = "en", options) {
-    this.provider = provider;
-    this.apiKey = apiKey;
-    this.language = language;
-    if (options) this.options = options;
-  }
-  toDict() {
-    const out = {
-      provider: this.provider,
-      api_key: this.apiKey,
-      language: this.language
-    };
-    if (this.options) out.options = { ...this.options };
-    return out;
+  model;
+  voice;
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.OPENAI_API_KEY;
+    if (!key) {
+      throw new Error(
+        "OpenAI Realtime requires an apiKey. Pass { apiKey: 'sk-...' } or set OPENAI_API_KEY in the environment."
+      );
+    }
+    this.apiKey = key;
+    this.model = opts.model ?? "gpt-4o-mini-realtime-preview";
+    this.voice = opts.voice ?? "alloy";
   }
 };
-var TTSConfigImpl = class {
-  provider;
+
+// src/engines/elevenlabs.ts
+var ConvAI = class {
+  kind = "elevenlabs_convai";
   apiKey;
+  agentId;
   voice;
-  constructor(provider, apiKey, voice = "alloy") {
-    this.provider = provider;
-    this.apiKey = apiKey;
-    this.voice = voice;
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.ELEVENLABS_API_KEY;
+    const agent = opts.agentId ?? process.env.ELEVENLABS_AGENT_ID;
+    if (!key) {
+      throw new Error(
+        "ElevenLabs ConvAI requires an apiKey. Pass { apiKey: '...' } or set ELEVENLABS_API_KEY in the environment."
+      );
+    }
+    if (!agent) {
+      throw new Error(
+        "ElevenLabs ConvAI requires an agentId. Pass { agentId: 'agent_...' } or set ELEVENLABS_AGENT_ID in the environment."
+      );
+    }
+    this.apiKey = key;
+    this.agentId = agent;
+    this.voice = opts.voice;
   }
-  toDict() {
-    return { provider: this.provider, api_key: this.apiKey, voice: this.voice };
+};
+
+// src/tunnels/index.ts
+var CloudflareTunnel = class {
+  kind = "cloudflare";
+};
+var Static = class {
+  kind = "static";
+  hostname;
+  constructor(opts) {
+    if (!opts.hostname) {
+      throw new Error("Static tunnel requires a non-empty hostname.");
+    }
+    this.hostname = opts.hostname;
   }
 };
-function deepgram(opts) {
-  const options = {
-    model: opts.model ?? "nova-3",
-    endpointing_ms: opts.endpointingMs ?? 150,
-    utterance_end_ms: opts.utteranceEndMs === null ? null : opts.utteranceEndMs ?? 1e3,
-    smart_format: opts.smartFormat ?? true,
-    interim_results: opts.interimResults ?? true
-  };
-  if (opts.vadEvents !== void 0) options.vad_events = opts.vadEvents;
-  return new STTConfigImpl("deepgram", opts.apiKey, opts.language ?? "en", options);
-}
-function whisper(opts) {
-  return new STTConfigImpl("whisper", opts.apiKey, opts.language ?? "en");
-}
-function elevenlabs(opts) {
-  return new TTSConfigImpl("elevenlabs", opts.apiKey, opts.voice ?? "rachel");
-}
-function openaiTts(opts) {
-  return new TTSConfigImpl("openai", opts.apiKey, opts.voice ?? "alloy");
-}
-function cartesia(opts) {
-  return new TTSConfigImpl(
-    "cartesia",
-    opts.apiKey,
-    opts.voice ?? "f786b574-daa5-4673-aa0c-cbe3e8534c02"
-  );
-}
-function rime(opts) {
-  return new TTSConfigImpl("rime", opts.apiKey, opts.voice ?? "astra");
-}
-function lmnt(opts) {
-  return new TTSConfigImpl("lmnt", opts.apiKey, opts.voice ?? "leah");
-}
 
 // src/client.ts
-init_server();
 var DEFAULT_BACKEND_URL2 = "wss://api.getpatter.com";
 var DEFAULT_REST_URL = "https://api.getpatter.com";
 function sttConfigToDict(cfg) {
@@ -7197,21 +6860,39 @@ var Patter = class {
   embeddedServer = null;
   tunnelHandle = null;
   constructor(options) {
-    const isLocal = "mode" in options && options.mode === "local" || !("apiKey" in options) && ("twilioSid" in options && options.twilioSid || "telnyxKey" in options && options.telnyxKey);
+    const hasCarrier = "carrier" in options && options.carrier !== void 0;
+    const isLocal = "mode" in options && options.mode === "local" || hasCarrier;
     if (isLocal) {
       const local = options;
       if (!local.phoneNumber) {
         throw new Error("Local mode requires phoneNumber");
       }
-      if (!local.twilioSid && !local.telnyxKey) {
-        throw new Error("Local mode requires twilioSid or telnyxKey");
+      if (!local.carrier) {
+        throw new Error(
+          "Local mode requires a `carrier` instance. Pass `carrier: new Twilio({...})` or `carrier: new Telnyx({...})`."
+        );
       }
-      if (local.twilioSid && !local.twilioToken) {
-        throw new Error("twilioToken is required when using twilioSid");
+      const carrier = local.carrier;
+      const tunnel = local.tunnel;
+      let tunnelWebhookUrl;
+      if (tunnel instanceof Static) {
+        if (local.webhookUrl) {
+          throw new Error(
+            "Cannot use both `tunnel: new StaticTunnel(...)` and `webhookUrl`. Pick one."
+          );
+        }
+        tunnelWebhookUrl = tunnel.hostname;
       }
       this.mode = "local";
-      const normalizedLocal = local.webhookUrl ? { ...local, webhookUrl: local.webhookUrl.replace(/^https?:\/\//, "").replace(/\/$/, "") } : local;
-      this.localConfig = normalizedLocal;
+      const rawWebhook = tunnelWebhookUrl ?? local.webhookUrl;
+      const normalizedWebhook = rawWebhook ? rawWebhook.replace(/^https?:\/\//, "").replace(/\/$/, "") : void 0;
+      this.localConfig = {
+        carrier,
+        phoneNumber: local.phoneNumber,
+        webhookUrl: normalizedWebhook,
+        tunnel: local.tunnel,
+        openaiKey: local.openaiKey
+      };
       this.apiKey = "";
       this.backendUrl = DEFAULT_BACKEND_URL2;
       this.restUrl = DEFAULT_REST_URL;
@@ -7228,25 +6909,55 @@ var Patter = class {
   }
   // === Local mode ===
   agent(opts) {
-    if (opts.provider) {
+    let working = { ...opts };
+    if (opts.engine) {
+      if (opts.provider) {
+        throw new Error(
+          "Cannot pass both `engine:` and `provider:`. Use one (engine is preferred)."
+        );
+      }
+      const engine = opts.engine;
+      if (engine instanceof Realtime) {
+        working = {
+          ...working,
+          provider: "openai_realtime",
+          model: working.model ?? engine.model,
+          voice: working.voice ?? engine.voice
+        };
+        if (this.localConfig && !this.localConfig.openaiKey) {
+          this.localConfig = { ...this.localConfig, openaiKey: engine.apiKey };
+        }
+      } else if (engine instanceof ConvAI) {
+        working = {
+          ...working,
+          provider: "elevenlabs_convai",
+          voice: working.voice ?? engine.voice
+        };
+      } else {
+        throw new Error(
+          "Unknown engine. Expected OpenAIRealtime or ElevenLabsConvAI instance."
+        );
+      }
+    }
+    if (working.provider) {
       const valid = ["openai_realtime", "elevenlabs_convai", "pipeline"];
-      if (!valid.includes(opts.provider)) {
-        throw new Error(`provider must be one of: ${valid.join(", ")}. Got: '${opts.provider}'`);
+      if (!valid.includes(working.provider)) {
+        throw new Error(`provider must be one of: ${valid.join(", ")}. Got: '${working.provider}'`);
       }
     }
-    if (opts.tools) {
-      if (!Array.isArray(opts.tools)) {
+    if (working.tools) {
+      if (!Array.isArray(working.tools)) {
         throw new TypeError("tools must be an array");
       }
-      opts.tools.forEach((tool, i) => {
-        if (!tool.name) throw new Error(`tools[${i}] missing required 'name' field`);
-        if (!tool.webhookUrl && !tool.handler) throw new Error(`tools[${i}] requires either 'webhookUrl' or 'handler'`);
+      working.tools.forEach((tool2, i) => {
+        if (!tool2.name) throw new Error(`tools[${i}] missing required 'name' field`);
+        if (!tool2.webhookUrl && !tool2.handler) throw new Error(`tools[${i}] requires either 'webhookUrl' or 'handler'`);
       });
     }
-    if (opts.variables !== void 0 && (typeof opts.variables !== "object" || Array.isArray(opts.variables))) {
+    if (working.variables !== void 0 && (typeof working.variables !== "object" || Array.isArray(working.variables))) {
       throw new TypeError("variables must be an object");
     }
-    return { ...opts };
+    return working;
   }
   async serve(opts) {
     if (this.mode !== "local" || !this.localConfig) {
@@ -7269,10 +6980,14 @@ var Patter = class {
     }
     let webhookUrl = this.localConfig.webhookUrl ?? "";
     const port = opts.port ?? 8e3;
-    if (opts.tunnel && webhookUrl) {
+    const ctorTunnel = this.localConfig.tunnel;
+    const wantsCloudflaredFromServe = opts.tunnel === true;
+    const wantsCloudflaredFromCtor = ctorTunnel === true || ctorTunnel instanceof CloudflareTunnel;
+    const wantsCloudflared = wantsCloudflaredFromServe || wantsCloudflaredFromCtor;
+    if (wantsCloudflared && webhookUrl) {
       throw new Error("Cannot use both tunnel: true and webhookUrl. Pick one.");
     }
-    if (opts.tunnel) {
+    if (wantsCloudflared) {
       const { startTunnel: startTunnel2 } = await Promise.resolve().then(() => (init_tunnel(), tunnel_exports));
       this.tunnelHandle = await startTunnel2(port);
       webhookUrl = this.tunnelHandle.hostname;
@@ -7282,17 +6997,29 @@ var Patter = class {
         "No webhookUrl configured. Either:\n  - Pass webhookUrl in the Patter constructor\n  - Use tunnel: true in serve() to auto-create a tunnel"
       );
     }
+    const carrier = this.localConfig.carrier;
+    const telephonyProvider = carrier.kind === "twilio" ? "twilio" : "telnyx";
+    const { autoConfigureCarrier: autoConfigureCarrier2 } = await Promise.resolve().then(() => (init_carrier_config(), carrier_config_exports));
+    await autoConfigureCarrier2({
+      telephonyProvider,
+      twilioSid: carrier.kind === "twilio" ? carrier.accountSid : void 0,
+      twilioToken: carrier.kind === "twilio" ? carrier.authToken : void 0,
+      telnyxKey: carrier.kind === "telnyx" ? carrier.apiKey : void 0,
+      telnyxConnectionId: carrier.kind === "telnyx" ? carrier.connectionId : void 0,
+      phoneNumber: this.localConfig.phoneNumber,
+      webhookHost: webhookUrl
+    });
     this.embeddedServer = new EmbeddedServer(
       {
-        twilioSid: this.localConfig.twilioSid,
-        twilioToken: this.localConfig.twilioToken,
+        twilioSid: carrier.kind === "twilio" ? carrier.accountSid : void 0,
+        twilioToken: carrier.kind === "twilio" ? carrier.authToken : void 0,
         openaiKey: this.localConfig.openaiKey,
         phoneNumber: this.localConfig.phoneNumber,
         webhookUrl,
-        telephonyProvider: this.localConfig.telephonyProvider,
-        telnyxKey: this.localConfig.telnyxKey,
-        telnyxConnectionId: this.localConfig.telnyxConnectionId,
-        telnyxPublicKey: this.localConfig.telnyxPublicKey
+        telephonyProvider,
+        telnyxKey: carrier.kind === "telnyx" ? carrier.apiKey : void 0,
+        telnyxConnectionId: carrier.kind === "telnyx" ? carrier.connectionId : void 0,
+        telnyxPublicKey: carrier.kind === "telnyx" ? carrier.publicKey : void 0
       },
       opts.agent,
       opts.onCallStart,
@@ -7353,10 +7080,10 @@ var Patter = class {
       if (!this.localConfig) {
         throw new Error("local config missing");
       }
-      const { phoneNumber, webhookUrl, telephonyProvider } = this.localConfig;
-      if (telephonyProvider === "telnyx") {
-        const telnyxKey = this.localConfig.telnyxKey ?? "";
-        const connectionId = this.localConfig.telnyxConnectionId ?? "";
+      const { phoneNumber, webhookUrl, carrier } = this.localConfig;
+      if (carrier.kind === "telnyx") {
+        const telnyxKey = carrier.apiKey;
+        const connectionId = carrier.connectionId;
         const streamUrl = `wss://${webhookUrl}/ws/stream/${encodeURIComponent(localOpts.to)}?caller=${encodeURIComponent(phoneNumber)}&callee=${encodeURIComponent(localOpts.to)}`;
         const telnyxPayload = {
           connection_id: connectionId,
@@ -7396,8 +7123,8 @@ var Patter = class {
         }
         return;
       }
-      const twilioSid = this.localConfig.twilioSid ?? "";
-      const twilioToken = this.localConfig.twilioToken ?? "";
+      const twilioSid = carrier.accountSid;
+      const twilioToken = carrier.authToken;
       const statusCallbackUrl = `https://${webhookUrl}/webhooks/twilio/status`;
       const url = `https://api.twilio.com/2010-04-01/Accounts/${twilioSid}/Calls.json`;
       const params = new URLSearchParams({
@@ -7529,65 +7256,6 @@ var Patter = class {
     const data = await response.json();
     return data.map((c) => ({ id: c.id, direction: c.direction, caller: c.caller, callee: c.callee, startedAt: c.started_at, endedAt: c.ended_at, durationSeconds: c.duration_seconds, status: c.status, transcript: c.transcript }));
   }
-  // Provider helpers — mirror the Python classmethod factories so callers can
-  // write ``Patter.deepgram({ apiKey })`` without importing the top-level.
-  static deepgram = deepgram;
-  static whisper = whisper;
-  static elevenlabs = elevenlabs;
-  static openaiTts = openaiTts;
-  static cartesia = cartesia;
-  static rime = rime;
-  static lmnt = lmnt;
-  static guardrail(opts) {
-    return {
-      name: opts.name,
-      blockedTerms: opts.blockedTerms,
-      check: opts.check,
-      replacement: opts.replacement ?? "I'm sorry, I can't respond to that."
-    };
-  }
-  /**
-   * Create a tool definition for use with `agent({ tools: [...] })`.
-   *
-   * Either `handler` (a function) or `webhookUrl` must be provided.
-   *
-   * @param opts.name - Tool name (visible to the LLM).
-   * @param opts.description - What the tool does (visible to the LLM).
-   * @param opts.parameters - JSON Schema for tool arguments.
-   * @param opts.handler - Async function called in-process when the LLM invokes the tool.
-   * @param opts.webhookUrl - URL to POST to when the LLM invokes the tool.
-   *
-   * @example
-   * ```ts
-   * phone.agent({
-   *   systemPrompt: 'You are a pizza bot.',
-   *   tools: [
-   *     Patter.tool({
-   *       name: 'check_menu',
-   *       description: 'Check available menu items',
-   *       handler: async (args) => JSON.stringify({ items: ['margherita'] }),
-   *     }),
-   *   ],
-   * });
-   * ```
-   */
-  static tool(opts) {
-    if (!opts.handler && !opts.webhookUrl) {
-      throw new Error("tool() requires either handler or webhookUrl");
-    }
-    const t = {
-      name: opts.name,
-      description: opts.description ?? "",
-      parameters: opts.parameters ?? { type: "object", properties: {} }
-    };
-    if (opts.handler) {
-      t.handler = opts.handler;
-    }
-    if (opts.webhookUrl) {
-      t.webhookUrl = opts.webhookUrl;
-    }
-    return t;
-  }
   // Internal
   async registerNumber(provider, providerKey, number, providerSecret, country = "US", stt, tts) {
     const credentials = { api_key: providerKey };
@@ -7682,8 +7350,64 @@ function filterForTTS(text) {
   return filterEmoji(filterMarkdown(text));
 }
 
-// src/index.ts
-init_pricing();
+// src/providers.ts
+var STTConfigImpl = class {
+  provider;
+  apiKey;
+  language;
+  options;
+  constructor(provider, apiKey, language = "en", options) {
+    this.provider = provider;
+    this.apiKey = apiKey;
+    this.language = language;
+    if (options) this.options = options;
+  }
+  toDict() {
+    const out = {
+      provider: this.provider,
+      api_key: this.apiKey,
+      language: this.language
+    };
+    if (this.options) out.options = { ...this.options };
+    return out;
+  }
+};
+var TTSConfigImpl = class {
+  provider;
+  apiKey;
+  voice;
+  constructor(provider, apiKey, voice = "alloy") {
+    this.provider = provider;
+    this.apiKey = apiKey;
+    this.voice = voice;
+  }
+  toDict() {
+    return { provider: this.provider, api_key: this.apiKey, voice: this.voice };
+  }
+};
+function deepgram(opts) {
+  const options = {
+    model: opts.model ?? "nova-3",
+    endpointing_ms: opts.endpointingMs ?? 150,
+    utterance_end_ms: opts.utteranceEndMs === null ? null : opts.utteranceEndMs ?? 1e3,
+    smart_format: opts.smartFormat ?? true,
+    interim_results: opts.interimResults ?? true
+  };
+  if (opts.vadEvents !== void 0) options.vad_events = opts.vadEvents;
+  return new STTConfigImpl("deepgram", opts.apiKey, opts.language ?? "en", options);
+}
+function whisper(opts) {
+  return new STTConfigImpl("whisper", opts.apiKey, opts.language ?? "en");
+}
+function elevenlabs(opts) {
+  return new TTSConfigImpl("elevenlabs", opts.apiKey, opts.voice ?? "rachel");
+}
+function openaiTts(opts) {
+  return new TTSConfigImpl("openai", opts.apiKey, opts.voice ?? "alloy");
+}
+
+// src/index.ts
+init_pricing();
 init_metrics();
 init_store();
 init_auth();
@@ -8372,166 +8096,480 @@ function scheduleInterval(intervalOrOpts, callback) {
   };
 }
 
-// src/index.ts
+// src/stt/deepgram.ts
 init_deepgram_stt();
-
-// src/providers/soniox-stt.ts
-var import_ws7 = __toESM(require("ws"));
-init_logger();
-var SONIOX_WS_URL = "wss://stt-rt.soniox.com/transcribe-websocket";
-var KEEPALIVE_MESSAGE = '{"type": "keepalive"}';
-var END_TOKEN = "<end>";
-var FINALIZED_TOKEN = "<fin>";
-var KEEPALIVE_INTERVAL_MS = 5e3;
-function isEndToken(token) {
-  return token.text === END_TOKEN || token.text === FINALIZED_TOKEN;
-}
-var TokenAccumulator = class {
-  text = "";
-  confSum = 0;
-  confCount = 0;
-  update(token) {
-    if (token.text) {
-      this.text += token.text;
-    }
-    if (typeof token.confidence === "number") {
-      this.confSum += token.confidence;
-      this.confCount += 1;
+var STT = class extends DeepgramSTT {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.DEEPGRAM_API_KEY;
+    if (!key) {
+      throw new Error(
+        "Deepgram STT requires an apiKey. Pass { apiKey: 'dg_...' } or set DEEPGRAM_API_KEY in the environment."
+      );
     }
-  }
-  get confidence() {
-    return this.confCount === 0 ? 0 : this.confSum / this.confCount;
-  }
-  reset() {
-    this.text = "";
-    this.confSum = 0;
-    this.confCount = 0;
-  }
-  get raw() {
-    return { sum: this.confSum, count: this.confCount };
+    super(
+      key,
+      opts.language ?? "en",
+      opts.model ?? "nova-3",
+      opts.encoding ?? "linear16",
+      opts.sampleRate ?? 16e3,
+      {
+        endpointingMs: opts.endpointingMs ?? 150,
+        utteranceEndMs: opts.utteranceEndMs === null ? null : opts.utteranceEndMs ?? 1e3,
+        smartFormat: opts.smartFormat ?? true,
+        interimResults: opts.interimResults ?? true,
+        ...opts.vadEvents !== void 0 ? { vadEvents: opts.vadEvents } : {}
+      }
+    );
   }
 };
-var SonioxSTT = class _SonioxSTT {
-  ws = null;
-  callbacks = [];
-  final = new TokenAccumulator();
-  keepaliveTimer = null;
+
+// src/providers/whisper-stt.ts
+init_logger();
+var OPENAI_TRANSCRIPTION_URL = "https://api.openai.com/v1/audio/transcriptions";
+var DEFAULT_BUFFER_SIZE = 16e3 * 2;
+function wrapPcmInWav(pcm, sampleRate = 16e3, channels = 1, bitsPerSample = 16) {
+  const dataSize = pcm.length;
+  const header = Buffer.alloc(44);
+  header.write("RIFF", 0);
+  header.writeUInt32LE(36 + dataSize, 4);
+  header.write("WAVE", 8);
+  header.write("fmt ", 12);
+  header.writeUInt32LE(16, 16);
+  header.writeUInt16LE(1, 20);
+  header.writeUInt16LE(channels, 22);
+  header.writeUInt32LE(sampleRate, 24);
+  header.writeUInt32LE(sampleRate * channels * (bitsPerSample / 8), 28);
+  header.writeUInt16LE(channels * (bitsPerSample / 8), 32);
+  header.writeUInt16LE(bitsPerSample, 34);
+  header.write("data", 36);
+  header.writeUInt32LE(dataSize, 40);
+  return Buffer.concat([header, pcm]);
+}
+var WhisperSTT = class _WhisperSTT {
   apiKey;
   model;
-  languageHints;
-  languageHintsStrict;
-  sampleRate;
-  numChannels;
-  enableSpeakerDiarization;
-  enableLanguageIdentification;
-  maxEndpointDelayMs;
-  clientReferenceId;
-  baseUrl;
-  constructor(apiKey, options = {}) {
-    if (!apiKey) {
-      throw new Error("Soniox apiKey is required");
-    }
-    const maxEndpointDelayMs = options.maxEndpointDelayMs ?? 500;
-    if (maxEndpointDelayMs < 500 || maxEndpointDelayMs > 3e3) {
-      throw new Error("maxEndpointDelayMs must be between 500 and 3000");
-    }
+  language;
+  bufferSize;
+  buffer = Buffer.alloc(0);
+  callbacks = [];
+  running = false;
+  pendingTranscriptions = [];
+  constructor(apiKey, model = "whisper-1", language, bufferSize = DEFAULT_BUFFER_SIZE) {
     this.apiKey = apiKey;
-    this.model = options.model ?? "stt-rt-v4";
-    this.languageHints = options.languageHints;
-    this.languageHintsStrict = options.languageHintsStrict ?? false;
-    this.sampleRate = options.sampleRate ?? 16e3;
-    this.numChannels = options.numChannels ?? 1;
-    this.enableSpeakerDiarization = options.enableSpeakerDiarization ?? false;
-    this.enableLanguageIdentification = options.enableLanguageIdentification ?? true;
-    this.maxEndpointDelayMs = maxEndpointDelayMs;
-    this.clientReferenceId = options.clientReferenceId;
-    this.baseUrl = options.baseUrl ?? SONIOX_WS_URL;
-  }
-  /** Factory for Twilio-style 8 kHz linear PCM. */
-  static forTwilio(apiKey, languageHints) {
-    return new _SonioxSTT(apiKey, { sampleRate: 8e3, languageHints });
+    this.model = model;
+    this.language = language;
+    this.bufferSize = bufferSize;
   }
-  buildConfig() {
-    const config = {
-      api_key: this.apiKey,
-      model: this.model,
-      audio_format: "pcm_s16le",
-      num_channels: this.numChannels,
-      sample_rate: this.sampleRate,
-      enable_endpoint_detection: true,
-      enable_speaker_diarization: this.enableSpeakerDiarization,
-      enable_language_identification: this.enableLanguageIdentification,
-      max_endpoint_delay_ms: this.maxEndpointDelayMs
-    };
-    if (this.languageHints) {
-      config.language_hints = this.languageHints;
-      config.language_hints_strict = this.languageHintsStrict;
-    }
-    if (this.clientReferenceId) {
-      config.client_reference_id = this.clientReferenceId;
-    }
-    return config;
+  /** Factory for Twilio calls — mulaw 8 kHz is transcoded upstream, so we still receive PCM 16-bit. */
+  static forTwilio(apiKey, language = "en", model = "whisper-1") {
+    return new _WhisperSTT(apiKey, model, language);
   }
   async connect() {
-    this.ws = new import_ws7.default(this.baseUrl);
-    await new Promise((resolve, reject) => {
-      const timer = setTimeout(() => reject(new Error("Soniox connect timeout")), 1e4);
-      this.ws.once("open", () => {
-        clearTimeout(timer);
-        resolve();
-      });
-      this.ws.once("error", (err) => {
-        clearTimeout(timer);
-        reject(err);
-      });
-    });
-    this.ws.send(JSON.stringify(this.buildConfig()));
-    this.ws.on("message", (raw) => this.handleMessage(raw.toString()));
-    this.ws.on("close", () => this.clearKeepalive());
-    this.ws.on("error", (err) => {
-      getLogger().error(`SonioxSTT WebSocket error: ${String(err)}`);
+    this.running = true;
+    this.buffer = Buffer.alloc(0);
+  }
+  sendAudio(audio) {
+    if (!this.running) return;
+    this.buffer = Buffer.concat([this.buffer, audio]);
+    if (this.buffer.length >= this.bufferSize) {
+      const pcm = this.buffer;
+      this.buffer = Buffer.alloc(0);
+      this.trackTranscription(this.transcribeBuffer(pcm));
+    }
+  }
+  trackTranscription(promise) {
+    const wrapped = promise.finally(() => {
+      const idx = this.pendingTranscriptions.indexOf(wrapped);
+      if (idx !== -1) this.pendingTranscriptions.splice(idx, 1);
     });
-    this.keepaliveTimer = setInterval(() => {
-      if (this.ws && this.ws.readyState === import_ws7.default.OPEN) {
-        try {
-          this.ws.send(KEEPALIVE_MESSAGE);
-        } catch {
-        }
-      }
-    }, KEEPALIVE_INTERVAL_MS);
+    this.pendingTranscriptions.push(wrapped);
   }
-  clearKeepalive() {
-    if (this.keepaliveTimer) {
-      clearInterval(this.keepaliveTimer);
-      this.keepaliveTimer = null;
+  onTranscript(callback) {
+    if (this.callbacks.length >= 10) {
+      getLogger().warn("WhisperSTT: maximum of 10 onTranscript callbacks reached; replacing the last callback.");
+      this.callbacks[this.callbacks.length - 1] = callback;
+      return;
     }
+    this.callbacks.push(callback);
   }
-  handleMessage(raw) {
-    let content;
+  async close() {
+    this.running = false;
+    if (this.buffer.length >= this.bufferSize / 4) {
+      const pcm = this.buffer;
+      this.buffer = Buffer.alloc(0);
+      this.trackTranscription(this.transcribeBuffer(pcm));
+    } else {
+      this.buffer = Buffer.alloc(0);
+    }
+    await Promise.allSettled(this.pendingTranscriptions);
+    this.callbacks = [];
+  }
+  // ------------------------------------------------------------------
+  // Private
+  // ------------------------------------------------------------------
+  async transcribeBuffer(pcm) {
+    const wav = wrapPcmInWav(pcm);
+    const formData = new FormData();
+    formData.append("file", new Blob([wav.buffer.slice(wav.byteOffset, wav.byteOffset + wav.byteLength)], { type: "audio/wav" }), "audio.wav");
+    formData.append("model", this.model);
+    if (this.language) {
+      formData.append("language", this.language);
+    }
     try {
-      content = JSON.parse(raw);
-    } catch {
-      return;
+      const resp = await fetch(OPENAI_TRANSCRIPTION_URL, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${this.apiKey}` },
+        body: formData,
+        signal: AbortSignal.timeout(15e3)
+      });
+      if (!resp.ok) {
+        const body = await resp.text();
+        getLogger().error(`WhisperSTT transcription error: ${resp.status} ${body}`);
+        return;
+      }
+      const json = await resp.json();
+      const text = (json.text ?? "").trim();
+      if (!text) return;
+      const transcript = {
+        text,
+        isFinal: true,
+        confidence: 1
+      };
+      for (const cb of this.callbacks) {
+        cb(transcript);
+      }
+    } catch (err) {
+      getLogger().error(`WhisperSTT transcription error: ${String(err)}`);
     }
-    if (content.error_code || content.error_message) {
-      getLogger().error(
-        `SonioxSTT error ${String(content.error_code)}: ${String(content.error_message)}`
+  }
+};
+
+// src/stt/whisper.ts
+var STT2 = class extends WhisperSTT {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.OPENAI_API_KEY;
+    if (!key) {
+      throw new Error(
+        "Whisper STT requires an apiKey. Pass { apiKey: 'sk-...' } or set OPENAI_API_KEY in the environment."
       );
     }
-    const tokens = content.tokens ?? [];
-    const nonFinal = new TokenAccumulator();
-    let emittedFinalThisMsg = false;
-    for (const token of tokens) {
-      if (token.is_final) {
-        if (isEndToken(token)) {
-          if (this.final.text) {
-            this.emit({
-              text: this.final.text.trim(),
-              isFinal: true,
-              confidence: this.final.confidence
-            });
-            this.final.reset();
-            emittedFinalThisMsg = true;
+    super(key, opts.model ?? "whisper-1", opts.language, opts.bufferSize);
+  }
+};
+
+// src/providers/cartesia-stt.ts
+var import_ws7 = __toESM(require("ws"));
+init_logger();
+var DEFAULT_BASE_URL = "https://api.cartesia.ai";
+var API_VERSION = "2025-04-16";
+var USER_AGENT = "Patter/1.0 (integration=LiveKit-port; provider=Cartesia)";
+var KEEPALIVE_INTERVAL_MS = 3e4;
+var CONNECT_TIMEOUT_MS = 1e4;
+var MAX_CALLBACKS = 10;
+var CartesiaSTT = class {
+  constructor(apiKey, options = {}) {
+    this.apiKey = apiKey;
+    this.options = options;
+    if (!apiKey) {
+      throw new Error("CartesiaSTT requires a non-empty apiKey");
+    }
+  }
+  ws = null;
+  callbacks = [];
+  keepaliveTimer = null;
+  /** Cartesia request id — set from the server transcript events. */
+  requestId = "";
+  buildWsUrl() {
+    const opts = this.options;
+    const rawBase = opts.baseUrl ?? DEFAULT_BASE_URL;
+    let base;
+    if (rawBase.startsWith("http://")) {
+      base = `ws://${rawBase.slice("http://".length)}`;
+    } else if (rawBase.startsWith("https://")) {
+      base = `wss://${rawBase.slice("https://".length)}`;
+    } else if (rawBase.startsWith("ws://") || rawBase.startsWith("wss://")) {
+      base = rawBase;
+    } else {
+      base = `wss://${rawBase}`;
+    }
+    const language = opts.language ?? "en";
+    const params = new URLSearchParams({
+      model: opts.model ?? "ink-whisper",
+      sample_rate: String(opts.sampleRate ?? 16e3),
+      encoding: opts.encoding ?? "pcm_s16le",
+      cartesia_version: API_VERSION,
+      api_key: this.apiKey,
+      language
+    });
+    return `${base}/stt/websocket?${params.toString()}`;
+  }
+  async connect() {
+    const url = this.buildWsUrl();
+    this.ws = new import_ws7.default(url, {
+      headers: { "User-Agent": USER_AGENT }
+    });
+    await new Promise((resolve, reject) => {
+      const timer = setTimeout(
+        () => reject(new Error("Cartesia STT connect timeout")),
+        CONNECT_TIMEOUT_MS
+      );
+      this.ws.once("open", () => {
+        clearTimeout(timer);
+        resolve();
+      });
+      this.ws.once("error", (err) => {
+        clearTimeout(timer);
+        reject(err);
+      });
+    });
+    this.ws.on("message", (raw) => {
+      let event;
+      try {
+        event = JSON.parse(raw.toString());
+      } catch {
+        return;
+      }
+      this.handleEvent(event);
+    });
+    this.keepaliveTimer = setInterval(() => {
+      if (this.ws && this.ws.readyState === import_ws7.default.OPEN) {
+        try {
+          this.ws.ping();
+        } catch {
+        }
+      }
+    }, KEEPALIVE_INTERVAL_MS);
+  }
+  handleEvent(event) {
+    const type = event.type;
+    if (type === "transcript") {
+      const text = (event.text ?? "").trim();
+      const isFinal = Boolean(event.is_final);
+      if (!text && !isFinal) return;
+      if (event.request_id) {
+        this.requestId = event.request_id;
+      }
+      if (!text) return;
+      const confidence = Number(event.probability ?? 1);
+      this.emit({ text, isFinal, confidence });
+      return;
+    }
+    if (type === "error") {
+      getLogger().error(`Cartesia STT error: ${event.message ?? "unknown"}`);
+      return;
+    }
+  }
+  emit(transcript) {
+    for (const cb of this.callbacks) {
+      cb(transcript);
+    }
+  }
+  sendAudio(audio) {
+    if (!this.ws || this.ws.readyState !== import_ws7.default.OPEN) return;
+    this.ws.send(audio);
+  }
+  onTranscript(callback) {
+    if (this.callbacks.length >= MAX_CALLBACKS) {
+      getLogger().warn(
+        "CartesiaSTT: maximum of 10 onTranscript callbacks reached; replacing the last callback."
+      );
+      this.callbacks[this.callbacks.length - 1] = callback;
+      return;
+    }
+    this.callbacks.push(callback);
+  }
+  close() {
+    if (this.keepaliveTimer) {
+      clearInterval(this.keepaliveTimer);
+      this.keepaliveTimer = null;
+    }
+    if (this.ws) {
+      try {
+        this.ws.send("finalize");
+      } catch {
+      }
+      this.ws.close();
+      this.ws = null;
+    }
+  }
+};
+
+// src/stt/cartesia.ts
+var STT3 = class extends CartesiaSTT {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.CARTESIA_API_KEY;
+    if (!key) {
+      throw new Error(
+        "Cartesia STT requires an apiKey. Pass { apiKey: '...' } or set CARTESIA_API_KEY in the environment."
+      );
+    }
+    super(key, {
+      model: opts.model,
+      language: opts.language,
+      encoding: opts.encoding,
+      sampleRate: opts.sampleRate,
+      baseUrl: opts.baseUrl
+    });
+  }
+};
+
+// src/providers/soniox-stt.ts
+var import_ws8 = __toESM(require("ws"));
+init_logger();
+var SONIOX_WS_URL = "wss://stt-rt.soniox.com/transcribe-websocket";
+var KEEPALIVE_MESSAGE = '{"type": "keepalive"}';
+var END_TOKEN = "<end>";
+var FINALIZED_TOKEN = "<fin>";
+var KEEPALIVE_INTERVAL_MS2 = 5e3;
+function isEndToken(token) {
+  return token.text === END_TOKEN || token.text === FINALIZED_TOKEN;
+}
+var TokenAccumulator = class {
+  text = "";
+  confSum = 0;
+  confCount = 0;
+  update(token) {
+    if (token.text) {
+      this.text += token.text;
+    }
+    if (typeof token.confidence === "number") {
+      this.confSum += token.confidence;
+      this.confCount += 1;
+    }
+  }
+  get confidence() {
+    return this.confCount === 0 ? 0 : this.confSum / this.confCount;
+  }
+  reset() {
+    this.text = "";
+    this.confSum = 0;
+    this.confCount = 0;
+  }
+  get raw() {
+    return { sum: this.confSum, count: this.confCount };
+  }
+};
+var SonioxSTT = class _SonioxSTT {
+  ws = null;
+  callbacks = [];
+  final = new TokenAccumulator();
+  keepaliveTimer = null;
+  apiKey;
+  model;
+  languageHints;
+  languageHintsStrict;
+  sampleRate;
+  numChannels;
+  enableSpeakerDiarization;
+  enableLanguageIdentification;
+  maxEndpointDelayMs;
+  clientReferenceId;
+  baseUrl;
+  constructor(apiKey, options = {}) {
+    if (!apiKey) {
+      throw new Error("Soniox apiKey is required");
+    }
+    const maxEndpointDelayMs = options.maxEndpointDelayMs ?? 500;
+    if (maxEndpointDelayMs < 500 || maxEndpointDelayMs > 3e3) {
+      throw new Error("maxEndpointDelayMs must be between 500 and 3000");
+    }
+    this.apiKey = apiKey;
+    this.model = options.model ?? "stt-rt-v4";
+    this.languageHints = options.languageHints;
+    this.languageHintsStrict = options.languageHintsStrict ?? false;
+    this.sampleRate = options.sampleRate ?? 16e3;
+    this.numChannels = options.numChannels ?? 1;
+    this.enableSpeakerDiarization = options.enableSpeakerDiarization ?? false;
+    this.enableLanguageIdentification = options.enableLanguageIdentification ?? true;
+    this.maxEndpointDelayMs = maxEndpointDelayMs;
+    this.clientReferenceId = options.clientReferenceId;
+    this.baseUrl = options.baseUrl ?? SONIOX_WS_URL;
+  }
+  /** Factory for Twilio-style 8 kHz linear PCM. */
+  static forTwilio(apiKey, languageHints) {
+    return new _SonioxSTT(apiKey, { sampleRate: 8e3, languageHints });
+  }
+  buildConfig() {
+    const config = {
+      api_key: this.apiKey,
+      model: this.model,
+      audio_format: "pcm_s16le",
+      num_channels: this.numChannels,
+      sample_rate: this.sampleRate,
+      enable_endpoint_detection: true,
+      enable_speaker_diarization: this.enableSpeakerDiarization,
+      enable_language_identification: this.enableLanguageIdentification,
+      max_endpoint_delay_ms: this.maxEndpointDelayMs
+    };
+    if (this.languageHints) {
+      config.language_hints = this.languageHints;
+      config.language_hints_strict = this.languageHintsStrict;
+    }
+    if (this.clientReferenceId) {
+      config.client_reference_id = this.clientReferenceId;
+    }
+    return config;
+  }
+  async connect() {
+    this.ws = new import_ws8.default(this.baseUrl);
+    await new Promise((resolve, reject) => {
+      const timer = setTimeout(() => reject(new Error("Soniox connect timeout")), 1e4);
+      this.ws.once("open", () => {
+        clearTimeout(timer);
+        resolve();
+      });
+      this.ws.once("error", (err) => {
+        clearTimeout(timer);
+        reject(err);
+      });
+    });
+    this.ws.send(JSON.stringify(this.buildConfig()));
+    this.ws.on("message", (raw) => this.handleMessage(raw.toString()));
+    this.ws.on("close", () => this.clearKeepalive());
+    this.ws.on("error", (err) => {
+      getLogger().error(`SonioxSTT WebSocket error: ${String(err)}`);
+    });
+    this.keepaliveTimer = setInterval(() => {
+      if (this.ws && this.ws.readyState === import_ws8.default.OPEN) {
+        try {
+          this.ws.send(KEEPALIVE_MESSAGE);
+        } catch {
+        }
+      }
+    }, KEEPALIVE_INTERVAL_MS2);
+  }
+  clearKeepalive() {
+    if (this.keepaliveTimer) {
+      clearInterval(this.keepaliveTimer);
+      this.keepaliveTimer = null;
+    }
+  }
+  handleMessage(raw) {
+    let content;
+    try {
+      content = JSON.parse(raw);
+    } catch {
+      return;
+    }
+    if (content.error_code || content.error_message) {
+      getLogger().error(
+        `SonioxSTT error ${String(content.error_code)}: ${String(content.error_message)}`
+      );
+    }
+    const tokens = content.tokens ?? [];
+    const nonFinal = new TokenAccumulator();
+    let emittedFinalThisMsg = false;
+    for (const token of tokens) {
+      if (token.is_final) {
+        if (isEndToken(token)) {
+          if (this.final.text) {
+            this.emit({
+              text: this.final.text.trim(),
+              isFinal: true,
+              confidence: this.final.confidence
+            });
+            this.final.reset();
+            emittedFinalThisMsg = true;
           }
         } else {
           this.final.update(token);
@@ -8565,7 +8603,7 @@ var SonioxSTT = class _SonioxSTT {
     }
   }
   sendAudio(audio) {
-    if (!this.ws || this.ws.readyState !== import_ws7.default.OPEN) return;
+    if (!this.ws || this.ws.readyState !== import_ws8.default.OPEN) return;
     if (audio.length === 0) return;
     this.ws.send(audio);
   }
@@ -8595,16 +8633,28 @@ var SonioxSTT = class _SonioxSTT {
   }
 };
 
-// src/index.ts
-init_whisper_stt();
+// src/stt/soniox.ts
+var STT4 = class extends SonioxSTT {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.SONIOX_API_KEY;
+    if (!key) {
+      throw new Error(
+        "Soniox STT requires an apiKey. Pass { apiKey: '...' } or set SONIOX_API_KEY in the environment."
+      );
+    }
+    const { apiKey: _ignored, ...rest } = opts;
+    void _ignored;
+    super(key, rest);
+  }
+};
 
 // src/providers/assemblyai-stt.ts
-var import_ws8 = __toESM(require("ws"));
+var import_ws9 = __toESM(require("ws"));
 init_logger();
-var DEFAULT_BASE_URL = "wss://streaming.assemblyai.com";
+var DEFAULT_BASE_URL2 = "wss://streaming.assemblyai.com";
 var DEFAULT_MIN_TURN_SILENCE_MS = 100;
-var CONNECT_TIMEOUT_MS = 1e4;
-var MAX_CALLBACKS = 10;
+var CONNECT_TIMEOUT_MS2 = 1e4;
+var MAX_CALLBACKS2 = 10;
 var AssemblyAISTT = class _AssemblyAISTT {
   constructor(apiKey, options = {}) {
     this.apiKey = apiKey;
@@ -8667,168 +8717,21 @@ var AssemblyAISTT = class _AssemblyAISTT {
         params.set(key, String(value));
       }
     }
-    const base = opts.baseUrl ?? DEFAULT_BASE_URL;
+    const base = opts.baseUrl ?? DEFAULT_BASE_URL2;
     return `${base}/v3/ws?${params.toString()}`;
   }
   async connect() {
-    const url = this.buildUrl();
-    this.ws = new import_ws8.default(url, {
-      headers: {
-        Authorization: this.apiKey,
-        "Content-Type": "application/json",
-        "User-Agent": "Patter/1.0 (integration=LiveKit-port)"
-      }
-    });
-    await new Promise((resolve, reject) => {
-      const timer = setTimeout(
-        () => reject(new Error("AssemblyAI connect timeout")),
-        CONNECT_TIMEOUT_MS
-      );
-      this.ws.once("open", () => {
-        clearTimeout(timer);
-        resolve();
-      });
-      this.ws.once("error", (err) => {
-        clearTimeout(timer);
-        reject(err);
-      });
-    });
-    this.ws.on("message", (raw) => {
-      let event;
-      try {
-        event = JSON.parse(raw.toString());
-      } catch {
-        return;
-      }
-      this.handleEvent(event);
-    });
-  }
-  handleEvent(event) {
-    const type = event.type;
-    if (type === "Begin") {
-      this.sessionId = event.id ?? "";
-      this.expiresAt = event.expires_at ?? 0;
-      return;
-    }
-    if (type !== "Turn") {
-      return;
-    }
-    const endOfTurn = Boolean(event.end_of_turn);
-    const turnIsFormatted = Boolean(event.turn_is_formatted);
-    const words = event.words ?? [];
-    const transcriptText = (event.transcript ?? "").trim();
-    if (endOfTurn) {
-      if (this.options.formatTurns && !turnIsFormatted) return;
-      if (!transcriptText) return;
-      this.emit({
-        text: transcriptText,
-        isFinal: true,
-        confidence: averageConfidence(words)
-      });
-      return;
-    }
-    if (!words.length) return;
-    const interim = words.map((w) => (w.text ?? "").trim()).filter(Boolean).join(" ");
-    if (!interim) return;
-    this.emit({
-      text: interim,
-      isFinal: false,
-      confidence: averageConfidence(words)
-    });
-  }
-  emit(transcript) {
-    for (const cb of this.callbacks) {
-      cb(transcript);
-    }
-  }
-  sendAudio(audio) {
-    if (!this.ws || this.ws.readyState !== import_ws8.default.OPEN) return;
-    this.ws.send(audio);
-  }
-  onTranscript(callback) {
-    if (this.callbacks.length >= MAX_CALLBACKS) {
-      getLogger().warn(
-        "AssemblyAISTT: maximum of 10 onTranscript callbacks reached; replacing the last callback."
-      );
-      this.callbacks[this.callbacks.length - 1] = callback;
-      return;
-    }
-    this.callbacks.push(callback);
-  }
-  close() {
-    if (this.ws) {
-      try {
-        this.ws.send(JSON.stringify({ type: "Terminate" }));
-      } catch {
-      }
-      this.ws.close();
-      this.ws = null;
-    }
-  }
-};
-function averageConfidence(words) {
-  if (!words.length) return 0;
-  let total = 0;
-  for (const w of words) {
-    total += Number(w.confidence ?? 0);
-  }
-  return total / words.length;
-}
-
-// src/providers/cartesia-stt.ts
-var import_ws9 = __toESM(require("ws"));
-init_logger();
-var DEFAULT_BASE_URL2 = "https://api.cartesia.ai";
-var API_VERSION = "2025-04-16";
-var USER_AGENT = "Patter/1.0 (integration=LiveKit-port; provider=Cartesia)";
-var KEEPALIVE_INTERVAL_MS2 = 3e4;
-var CONNECT_TIMEOUT_MS2 = 1e4;
-var MAX_CALLBACKS2 = 10;
-var CartesiaSTT = class {
-  constructor(apiKey, options = {}) {
-    this.apiKey = apiKey;
-    this.options = options;
-    if (!apiKey) {
-      throw new Error("CartesiaSTT requires a non-empty apiKey");
-    }
-  }
-  ws = null;
-  callbacks = [];
-  keepaliveTimer = null;
-  /** Cartesia request id — set from the server transcript events. */
-  requestId = "";
-  buildWsUrl() {
-    const opts = this.options;
-    const rawBase = opts.baseUrl ?? DEFAULT_BASE_URL2;
-    let base;
-    if (rawBase.startsWith("http://")) {
-      base = `ws://${rawBase.slice("http://".length)}`;
-    } else if (rawBase.startsWith("https://")) {
-      base = `wss://${rawBase.slice("https://".length)}`;
-    } else if (rawBase.startsWith("ws://") || rawBase.startsWith("wss://")) {
-      base = rawBase;
-    } else {
-      base = `wss://${rawBase}`;
-    }
-    const language = opts.language ?? "en";
-    const params = new URLSearchParams({
-      model: opts.model ?? "ink-whisper",
-      sample_rate: String(opts.sampleRate ?? 16e3),
-      encoding: opts.encoding ?? "pcm_s16le",
-      cartesia_version: API_VERSION,
-      api_key: this.apiKey,
-      language
-    });
-    return `${base}/stt/websocket?${params.toString()}`;
-  }
-  async connect() {
-    const url = this.buildWsUrl();
+    const url = this.buildUrl();
     this.ws = new import_ws9.default(url, {
-      headers: { "User-Agent": USER_AGENT }
+      headers: {
+        Authorization: this.apiKey,
+        "Content-Type": "application/json",
+        "User-Agent": "Patter/1.0 (integration=LiveKit-port)"
+      }
     });
     await new Promise((resolve, reject) => {
       const timer = setTimeout(
-        () => reject(new Error("Cartesia STT connect timeout")),
+        () => reject(new Error("AssemblyAI connect timeout")),
         CONNECT_TIMEOUT_MS2
       );
       this.ws.once("open", () => {
@@ -8849,33 +8752,39 @@ var CartesiaSTT = class {
       }
       this.handleEvent(event);
     });
-    this.keepaliveTimer = setInterval(() => {
-      if (this.ws && this.ws.readyState === import_ws9.default.OPEN) {
-        try {
-          this.ws.ping();
-        } catch {
-        }
-      }
-    }, KEEPALIVE_INTERVAL_MS2);
   }
   handleEvent(event) {
     const type = event.type;
-    if (type === "transcript") {
-      const text = (event.text ?? "").trim();
-      const isFinal = Boolean(event.is_final);
-      if (!text && !isFinal) return;
-      if (event.request_id) {
-        this.requestId = event.request_id;
-      }
-      if (!text) return;
-      const confidence = Number(event.probability ?? 1);
-      this.emit({ text, isFinal, confidence });
+    if (type === "Begin") {
+      this.sessionId = event.id ?? "";
+      this.expiresAt = event.expires_at ?? 0;
       return;
     }
-    if (type === "error") {
-      getLogger().error(`Cartesia STT error: ${event.message ?? "unknown"}`);
+    if (type !== "Turn") {
+      return;
+    }
+    const endOfTurn = Boolean(event.end_of_turn);
+    const turnIsFormatted = Boolean(event.turn_is_formatted);
+    const words = event.words ?? [];
+    const transcriptText = (event.transcript ?? "").trim();
+    if (endOfTurn) {
+      if (this.options.formatTurns && !turnIsFormatted) return;
+      if (!transcriptText) return;
+      this.emit({
+        text: transcriptText,
+        isFinal: true,
+        confidence: averageConfidence(words)
+      });
       return;
     }
+    if (!words.length) return;
+    const interim = words.map((w) => (w.text ?? "").trim()).filter(Boolean).join(" ");
+    if (!interim) return;
+    this.emit({
+      text: interim,
+      isFinal: false,
+      confidence: averageConfidence(words)
+    });
   }
   emit(transcript) {
     for (const cb of this.callbacks) {
@@ -8889,7 +8798,7 @@ var CartesiaSTT = class {
   onTranscript(callback) {
     if (this.callbacks.length >= MAX_CALLBACKS2) {
       getLogger().warn(
-        "CartesiaSTT: maximum of 10 onTranscript callbacks reached; replacing the last callback."
+        "AssemblyAISTT: maximum of 10 onTranscript callbacks reached; replacing the last callback."
       );
       this.callbacks[this.callbacks.length - 1] = callback;
       return;
@@ -8897,13 +8806,9 @@ var CartesiaSTT = class {
     this.callbacks.push(callback);
   }
   close() {
-    if (this.keepaliveTimer) {
-      clearInterval(this.keepaliveTimer);
-      this.keepaliveTimer = null;
-    }
     if (this.ws) {
       try {
-        this.ws.send("finalize");
+        this.ws.send(JSON.stringify({ type: "Terminate" }));
       } catch {
       }
       this.ws.close();
@@ -8911,10 +8816,305 @@ var CartesiaSTT = class {
     }
   }
 };
+function averageConfidence(words) {
+  if (!words.length) return 0;
+  let total = 0;
+  for (const w of words) {
+    total += Number(w.confidence ?? 0);
+  }
+  return total / words.length;
+}
+
+// src/stt/assemblyai.ts
+var STT5 = class extends AssemblyAISTT {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.ASSEMBLYAI_API_KEY;
+    if (!key) {
+      throw new Error(
+        "AssemblyAI STT requires an apiKey. Pass { apiKey: '...' } or set ASSEMBLYAI_API_KEY in the environment."
+      );
+    }
+    const { apiKey: _ignored, ...rest } = opts;
+    void _ignored;
+    super(key, rest);
+  }
+};
 
-// src/index.ts
-init_elevenlabs_tts();
-init_openai_tts();
+// src/providers/elevenlabs-tts.ts
+var ELEVENLABS_BASE_URL = "https://api.elevenlabs.io/v1";
+var ELEVENLABS_VOICE_ID_BY_NAME = {
+  rachel: "21m00Tcm4TlvDq8ikWAM",
+  drew: "29vD33N1CtxCmqQRPOHJ",
+  clyde: "2EiwWnXFnvU5JabPnv8n",
+  paul: "5Q0t7uMcjvnagumLfvZi",
+  domi: "AZnzlk1XvdvUeBnXmlld",
+  dave: "CYw3kZ02Hs0563khs1Fj",
+  fin: "D38z5RcWu1voky8WS1ja",
+  bella: "EXAVITQu4vr4xnSDxMaL",
+  antoni: "ErXwobaYiN019PkySvjV",
+  thomas: "GBv7mTt0atIp3Br8iCZE",
+  charlie: "IKne3meq5aSn9XLyUdCD",
+  george: "JBFqnCBsd6RMkjVDRZzb",
+  emily: "LcfcDJNUP1GQjkzn1xUU",
+  elli: "MF3mGyEYCl7XYWbV9V6O",
+  callum: "N2lVS1w4EtoT3dr4eOWO",
+  patrick: "ODq5zmih8GrVes37Dizd",
+  harry: "SOYHLrjzK2X1ezoPC6cr",
+  liam: "TX3LPaxmHKxFdv7VOQHJ",
+  dorothy: "ThT5KcBeYPX3keUQqHPh",
+  josh: "TxGEqnHWrfWFTfGW9XjX",
+  arnold: "VR6AewLTigWG4xSOukaG",
+  charlotte: "XB0fDUnXU5powFXDhCwa",
+  matilda: "XrExE9yKIg1WjnnlVkGX",
+  matthew: "Yko7PKHZNXotIFUBG7I9",
+  james: "ZQe5CZNOzWyzPSCn5a3c",
+  joseph: "Zlb1dXrM653N07WRdFW3",
+  jeremy: "bVMeCyTHy58xNoL34h3p",
+  michael: "flq6f7yk4E4fJM5XTYuZ",
+  ethan: "g5CIjZEefAph4nQFvHAz",
+  gigi: "jBpfuIE2acCO8z3wKNLl",
+  freya: "jsCqWAovK2LkecY7zXl4",
+  brian: "nPczCjzI2devNBz1zQrb",
+  grace: "oWAxZDx7w5VEj9dCyTzz",
+  daniel: "onwK4e9ZLuTAKqWW03F9",
+  lily: "pFZP5JQG7iQjIQuC4Bku",
+  serena: "pMsXgVXv3BLzUgSXRplE",
+  adam: "pNInz6obpgDQGcFmaJgB",
+  nicole: "piTKgcLEGmPE4e6mEKli",
+  bill: "pqHfZKP75CvOlQylNhV4",
+  jessie: "t0jbNlBVZ17f02VDIeMI",
+  ryan: "wViXBPUzp2ZZixB1xQuM",
+  sam: "yoZ06aMxZJJ28mfd3POQ",
+  glinda: "z9fAnlkpzviPz146aGWa",
+  giovanni: "zcAOhNBS3c14rBihAFp1",
+  mimi: "zrHiDhphv9ZnVXBqCLjz",
+  alloy: "21m00Tcm4TlvDq8ikWAM"
+};
+var VOICE_ID_PATTERN = /^[A-Za-z0-9]{20}$/;
+function resolveVoiceId(voice) {
+  if (!voice) return voice;
+  if (VOICE_ID_PATTERN.test(voice)) return voice;
+  return ELEVENLABS_VOICE_ID_BY_NAME[voice.toLowerCase()] ?? voice;
+}
+var ElevenLabsTTS = class {
+  constructor(apiKey, voiceId = "21m00Tcm4TlvDq8ikWAM", modelId = "eleven_turbo_v2_5", outputFormat = "pcm_16000") {
+    this.apiKey = apiKey;
+    this.modelId = modelId;
+    this.outputFormat = outputFormat;
+    this.voiceId = resolveVoiceId(voiceId);
+  }
+  voiceId;
+  /**
+   * Synthesise text to speech and return the full audio as a single Buffer.
+   *
+   * For large chunks (or when latency matters) call `synthesizeStream` instead.
+   */
+  async synthesize(text) {
+    const chunks = [];
+    for await (const chunk of this.synthesizeStream(text)) {
+      chunks.push(chunk);
+    }
+    return Buffer.concat(chunks);
+  }
+  /**
+   * Synthesise text and yield audio chunks as they arrive (streaming).
+   *
+   * The yielded buffers are raw PCM at 16 kHz (or whatever `outputFormat` is
+   * configured to).
+   */
+  async *synthesizeStream(text) {
+    const url = `${ELEVENLABS_BASE_URL}/text-to-speech/${encodeURIComponent(this.voiceId)}/stream?output_format=${encodeURIComponent(this.outputFormat)}`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "xi-api-key": this.apiKey,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ text, model_id: this.modelId }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(`ElevenLabs TTS error ${response.status}: ${body}`);
+    }
+    if (!response.body) {
+      throw new Error("ElevenLabs TTS: no response body");
+    }
+    const reader = response.body.getReader();
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        if (value && value.length > 0) {
+          yield Buffer.from(value);
+        }
+      }
+    } finally {
+      if (typeof reader.cancel === "function") await reader.cancel().catch(() => {
+      });
+      reader.releaseLock();
+    }
+  }
+};
+
+// src/tts/elevenlabs.ts
+var TTS = class extends ElevenLabsTTS {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.ELEVENLABS_API_KEY;
+    if (!key) {
+      throw new Error(
+        "ElevenLabs TTS requires an apiKey. Pass { apiKey: '...' } or set ELEVENLABS_API_KEY in the environment."
+      );
+    }
+    super(
+      key,
+      opts.voiceId ?? "21m00Tcm4TlvDq8ikWAM",
+      opts.modelId ?? "eleven_turbo_v2_5",
+      opts.outputFormat ?? "pcm_16000"
+    );
+  }
+};
+
+// src/providers/openai-tts.ts
+var OPENAI_TTS_URL = "https://api.openai.com/v1/audio/speech";
+var OpenAITTS = class _OpenAITTS {
+  constructor(apiKey, voice = "alloy", model = "tts-1") {
+    this.apiKey = apiKey;
+    this.voice = voice;
+    this.model = model;
+  }
+  /**
+   * Synthesise text to speech and return the full audio as a single Buffer.
+   *
+   * For large chunks (or when latency matters) call `synthesizeStream` instead.
+   */
+  async synthesize(text) {
+    const chunks = [];
+    for await (const chunk of this.synthesizeStream(text)) {
+      chunks.push(chunk);
+    }
+    return Buffer.concat(chunks);
+  }
+  /**
+   * Synthesise text and yield audio chunks as they arrive (streaming).
+   *
+   * OpenAI returns 24 kHz PCM16; each chunk is resampled to 16 kHz before
+   * yielding so the output is ready for telephony pipelines.
+   *
+   * The resampler carries state (buffered samples + odd trailing byte)
+   * between chunks — without that state cross-chunk sample alignment drifts
+   * and the caller hears pops / dropped audio (BUG #23, mirror of the
+   * Python `audioop.ratecv` fix).
+   */
+  async *synthesizeStream(text) {
+    const response = await fetch(OPENAI_TTS_URL, {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        model: this.model,
+        input: text,
+        voice: this.voice,
+        response_format: "pcm"
+      }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(`OpenAI TTS error ${response.status}: ${body}`);
+    }
+    if (!response.body) {
+      throw new Error("OpenAI TTS: no response body");
+    }
+    const ctx = { carryByte: null, leftover: [] };
+    const reader = response.body.getReader();
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        if (value && value.length > 0) {
+          const out = _OpenAITTS.resampleStreaming(Buffer.from(value), ctx);
+          if (out.length > 0) yield out;
+        }
+      }
+      if (ctx.leftover.length > 0) {
+        const tail = Buffer.alloc(ctx.leftover.length * 2);
+        for (let i = 0; i < ctx.leftover.length; i++) {
+          tail.writeInt16LE(ctx.leftover[i], i * 2);
+        }
+        yield tail;
+      }
+    } finally {
+      if (typeof reader.cancel === "function") await reader.cancel().catch(() => {
+      });
+      reader.releaseLock();
+    }
+  }
+  /**
+   * Streaming 24 kHz → 16 kHz resampler (PCM16-LE). Maintains cross-chunk
+   * state so the 3:2 pattern doesn't reset at every network read.
+   */
+  static resampleStreaming(audio, ctx) {
+    let buf;
+    if (ctx.carryByte !== null) {
+      buf = Buffer.concat([Buffer.from([ctx.carryByte]), audio]);
+      ctx.carryByte = null;
+    } else {
+      buf = audio;
+    }
+    if (buf.length % 2 === 1) {
+      ctx.carryByte = buf[buf.length - 1];
+      buf = buf.subarray(0, buf.length - 1);
+    }
+    if (buf.length === 0 && ctx.leftover.length === 0) {
+      return Buffer.alloc(0);
+    }
+    const sampleCount = buf.length / 2;
+    const samples = ctx.leftover.slice();
+    for (let i2 = 0; i2 < sampleCount; i2++) {
+      samples.push(buf.readInt16LE(i2 * 2));
+    }
+    const out = [];
+    let i = 0;
+    while (i + 2 < samples.length) {
+      out.push(samples[i]);
+      out.push(Math.trunc((samples[i + 1] + samples[i + 2]) / 2));
+      i += 3;
+    }
+    ctx.leftover = samples.slice(i);
+    const buffer = Buffer.alloc(out.length * 2);
+    for (let j = 0; j < out.length; j++) {
+      buffer.writeInt16LE(out[j], j * 2);
+    }
+    return buffer;
+  }
+  /** @deprecated use {@link resampleStreaming} with persistent state. */
+  static resample24kTo16k(audio) {
+    const ctx = { carryByte: null, leftover: [] };
+    const out = _OpenAITTS.resampleStreaming(audio, ctx);
+    if (ctx.leftover.length === 0) return out;
+    const tail = Buffer.alloc(ctx.leftover.length * 2);
+    for (let i = 0; i < ctx.leftover.length; i++) {
+      tail.writeInt16LE(ctx.leftover[i], i * 2);
+    }
+    return Buffer.concat([out, tail]);
+  }
+};
+
+// src/tts/openai.ts
+var TTS2 = class extends OpenAITTS {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.OPENAI_API_KEY;
+    if (!key) {
+      throw new Error(
+        "OpenAI TTS requires an apiKey. Pass { apiKey: 'sk-...' } or set OPENAI_API_KEY in the environment."
+      );
+    }
+    super(key, opts.voice ?? "alloy", opts.model ?? "tts-1");
+  }
+};
 
 // src/providers/cartesia-tts.ts
 var CARTESIA_BASE_URL = "https://api.cartesia.ai";
@@ -9014,6 +9214,21 @@ var CartesiaTTS = class {
   }
 };
 
+// src/tts/cartesia.ts
+var TTS3 = class extends CartesiaTTS {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.CARTESIA_API_KEY;
+    if (!key) {
+      throw new Error(
+        "Cartesia TTS requires an apiKey. Pass { apiKey: '...' } or set CARTESIA_API_KEY in the environment."
+      );
+    }
+    const { apiKey: _ignored, ...rest } = opts;
+    void _ignored;
+    super(key, rest);
+  }
+};
+
 // src/providers/rime-tts.ts
 var RIME_BASE_URL = "https://users.rime.ai/v1/rime-tts";
 var ARCANA_MODEL_TIMEOUT_MS = 60 * 4 * 1e3;
@@ -9141,6 +9356,21 @@ var RimeTTS = class {
   }
 };
 
+// src/tts/rime.ts
+var TTS4 = class extends RimeTTS {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.RIME_API_KEY;
+    if (!key) {
+      throw new Error(
+        "Rime TTS requires an apiKey. Pass { apiKey: '...' } or set RIME_API_KEY in the environment."
+      );
+    }
+    const { apiKey: _ignored, ...rest } = opts;
+    void _ignored;
+    super(key, rest);
+  }
+};
+
 // src/providers/lmnt-tts.ts
 var LMNT_BASE_URL = "https://api.lmnt.com/v1/ai/speech/bytes";
 var LMNTTTS = class {
@@ -9219,6 +9449,119 @@ var LMNTTTS = class {
   }
 };
 
+// src/tts/lmnt.ts
+var TTS5 = class extends LMNTTTS {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.LMNT_API_KEY;
+    if (!key) {
+      throw new Error(
+        "LMNT TTS requires an apiKey. Pass { apiKey: '...' } or set LMNT_API_KEY in the environment."
+      );
+    }
+    const { apiKey: _ignored, ...rest } = opts;
+    void _ignored;
+    super(key, rest);
+  }
+};
+
+// src/carriers/twilio.ts
+var Carrier = class {
+  kind = "twilio";
+  accountSid;
+  authToken;
+  constructor(opts = {}) {
+    const sid = opts.accountSid ?? process.env.TWILIO_ACCOUNT_SID;
+    const tok = opts.authToken ?? process.env.TWILIO_AUTH_TOKEN;
+    if (!sid) {
+      throw new Error(
+        "Twilio carrier requires accountSid. Pass { accountSid: 'AC...' } or set TWILIO_ACCOUNT_SID in the environment."
+      );
+    }
+    if (!tok) {
+      throw new Error(
+        "Twilio carrier requires authToken. Pass { authToken: '...' } or set TWILIO_AUTH_TOKEN in the environment."
+      );
+    }
+    this.accountSid = sid;
+    this.authToken = tok;
+  }
+};
+
+// src/carriers/telnyx.ts
+var Carrier2 = class {
+  kind = "telnyx";
+  apiKey;
+  connectionId;
+  publicKey;
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.TELNYX_API_KEY;
+    const conn = opts.connectionId ?? process.env.TELNYX_CONNECTION_ID;
+    const pub = opts.publicKey ?? process.env.TELNYX_PUBLIC_KEY;
+    if (!key) {
+      throw new Error(
+        "Telnyx carrier requires apiKey. Pass { apiKey: '...' } or set TELNYX_API_KEY in the environment."
+      );
+    }
+    if (!conn) {
+      throw new Error(
+        "Telnyx carrier requires connectionId. Pass { connectionId: '...' } or set TELNYX_CONNECTION_ID in the environment."
+      );
+    }
+    this.apiKey = key;
+    this.connectionId = conn;
+    this.publicKey = pub;
+  }
+};
+
+// src/public-api.ts
+var DEFAULT_GUARDRAIL_REPLACEMENT = "I'm sorry, I can't respond to that.";
+var Guardrail = class {
+  name;
+  blockedTerms;
+  check;
+  replacement;
+  constructor(opts) {
+    if (!opts.name) {
+      throw new Error("Guardrail requires a non-empty name.");
+    }
+    this.name = opts.name;
+    if (opts.blockedTerms) this.blockedTerms = opts.blockedTerms;
+    if (opts.check) this.check = opts.check;
+    this.replacement = opts.replacement ?? DEFAULT_GUARDRAIL_REPLACEMENT;
+  }
+};
+function guardrail(opts) {
+  return new Guardrail(opts);
+}
+var Tool = class {
+  name;
+  description;
+  parameters;
+  handler;
+  webhookUrl;
+  constructor(opts) {
+    if (!opts.name) {
+      throw new Error("Tool requires a non-empty name.");
+    }
+    const hasHandler = typeof opts.handler === "function";
+    const hasWebhook = typeof opts.webhookUrl === "string" && opts.webhookUrl.length > 0;
+    if (!hasHandler && !hasWebhook) {
+      throw new Error("Tool requires either handler or webhookUrl.");
+    }
+    if (hasHandler && hasWebhook) {
+      throw new Error("Tool accepts handler OR webhookUrl, not both.");
+    }
+    this.name = opts.name;
+    this.description = opts.description ?? "";
+    this.parameters = opts.parameters ?? { type: "object", properties: {} };
+    if (hasHandler) this.handler = opts.handler;
+    if (hasWebhook) this.webhookUrl = opts.webhookUrl;
+  }
+};
+function tool(opts) {
+  return new Tool(opts);
+}
+
 // src/index.ts
 init_transcoding();
 init_tunnel();
@@ -9843,21 +10186,25 @@ function isAudioConfig(value) {
   CartesiaSTT,
   CartesiaTTS,
   ChatContext,
+  CloudflareTunnel,
   DEFAULT_MIN_SENTENCE_LEN,
   DEFAULT_PRICING,
   DTMF_EVENTS,
   DeepgramSTT,
+  ElevenLabsConvAI,
   ElevenLabsConvAIAdapter,
   ElevenLabsTTS,
   FallbackLLMProvider,
   GEMINI_DEFAULT_INPUT_SR,
   GEMINI_DEFAULT_OUTPUT_SR,
   GeminiLiveAdapter,
+  Guardrail,
   IVRActivity,
   LLMLoop,
   LMNTTTS,
   MetricsStore,
   OpenAILLMProvider,
+  OpenAIRealtime,
   OpenAIRealtimeAdapter,
   OpenAITTS,
   PartialStreamError,
@@ -9870,8 +10217,12 @@ function isAudioConfig(value) {
   RimeTTS,
   SentenceChunker,
   SonioxSTT,
+  StaticTunnel,
+  Telnyx,
   TestSession,
   TfidfLoopDetector,
+  Tool,
+  Twilio,
   ULTRAVOX_DEFAULT_API_BASE,
   ULTRAVOX_DEFAULT_SR,
   UltravoxRealtimeAdapter,
@@ -9891,6 +10242,7 @@ function isAudioConfig(value) {
   filterMarkdown,
   formatDtmf,
   getLogger,
+  guardrail,
   isRemoteUrl,
   isWebSocketUrl,
   makeAuthMiddleware,
@@ -9912,5 +10264,6 @@ function isAudioConfig(value) {
   selectSoundFromList,
   setLogger,
   startTunnel,
+  tool,
   whisper
 });