getpatter 0.4.4 → 0.5.1

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]);
       }
     };
   }
@@ -3119,7 +2748,7 @@ async function queryDeepgramCost(metricsAcc, deepgramKey, deepgramRequestId) {
           const usd = reqData.response?.details?.usd;
           if (usd != null) {
             metricsAcc.setActualSttCost(usd);
-            getLogger().info(`Deepgram actual cost: $${usd}`);
+            getLogger().debug(`Deepgram actual cost: $${usd}`);
           }
         }
       }
@@ -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: "",
@@ -3187,7 +2816,7 @@ var init_stream_handler = __esm({
           ttsProvider: ttsProviderName,
           pricing: deps.pricing
         });
-        getLogger().info(`WebSocket connection opened (${deps.bridge.label})`);
+        getLogger().debug(`WebSocket connection opened (${deps.bridge.label})`);
       }
       // ---------------------------------------------------------------------------
       // Public: called by the provider-specific parsers in server.ts
@@ -3203,9 +2832,12 @@ var init_stream_handler = __esm({
         this.metricsAcc.callId = callId;
         if (customParams.caller && !this.caller) this.caller = customParams.caller;
         if (customParams.callee && !this.callee) this.callee = customParams.callee;
-        getLogger().info(`Call started: ${callId}`);
+        const mode = this.deps.agent.engine ? `engine=${this.deps.agent.engine.kind ?? "unknown"}` : "pipeline";
+        getLogger().info(
+          `Call started: ${callId} (${this.deps.bridge.label}, ${mode}, ${sanitizeLogValue(this.caller || "?")} \u2192 ${sanitizeLogValue(this.callee || "?")})`
+        );
         if (Object.keys(customParams).length > 0) {
-          getLogger().info(`Custom params: ${sanitizeLogValue(JSON.stringify(customParams))}`);
+          getLogger().debug(`Custom params: ${sanitizeLogValue(JSON.stringify(customParams))}`);
         }
         this.deps.metricsStore.recordCallStart({
           call_id: callId,
@@ -3253,7 +2885,7 @@ var init_stream_handler = __esm({
                 }
               });
               if (recResp.ok) {
-                getLogger().info(`Recording started for ${callId}`);
+                getLogger().debug(`Recording started for ${callId}`);
               } else {
                 getLogger().warn(`could not start recording: ${await recResp.text()}`);
               }
@@ -3308,7 +2940,7 @@ var init_stream_handler = __esm({
       }
       /** Handle a DTMF keypress event (Twilio only). */
       async handleDtmf(digit) {
-        getLogger().info(`DTMF: ${digit}`);
+        getLogger().debug(`DTMF: ${digit}`);
         if (this.adapter instanceof OpenAIRealtimeAdapter) {
           await this.adapter.sendText(`The user pressed key ${digit} on their phone keypad.`);
         }
@@ -3367,26 +2999,17 @@ 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`);
+          getLogger().debug(`Pipeline mode (${label}): no STT configured`);
         }
         if (!this.tts) {
-          getLogger().info(`Pipeline mode (${label}): no TTS configured`);
+          getLogger().debug(`Pipeline mode (${label}): no TTS configured`);
         }
         try {
           if (this.stt) await this.stt.connect();
-          getLogger().info(`Pipeline mode (${label}): STT + TTS connected`);
+          getLogger().debug(`Pipeline mode (${label}): STT + TTS connected`);
         } catch (e) {
           getLogger().error(`Pipeline connect FAILED (${label}):`, e);
           try {
@@ -3419,7 +3042,24 @@ var init_stream_handler = __esm({
             this.history.push({ role: "assistant", text: this.deps.agent.firstMessage, timestamp: Date.now() });
           }
         }
-        if (!this.deps.onMessage && this.deps.config.openaiKey) {
+        if (this.deps.agent.llm) {
+          if (this.deps.onMessage) {
+            throw new Error(
+              "Cannot pass both agent({ llm }) and serve({ onMessage }). Pick one \u2014 `llm` for built-in LLMs, `onMessage` for custom logic."
+            );
+          }
+          this.llmLoop = new LLMLoop(
+            "",
+            // apiKey unused when llmProvider is supplied
+            "",
+            // model unused when llmProvider is supplied
+            resolvedPrompt,
+            this.deps.agent.tools,
+            this.deps.agent.llm
+          );
+          const llmLabel = this.deps.agent.llm.constructor?.name ?? "custom";
+          getLogger().debug(`Built-in LLM loop active (pipeline, ${label}, llm=${llmLabel})`);
+        } else if (!this.deps.onMessage && this.deps.config.openaiKey) {
           let llmModel = this.deps.agent.model || "gpt-4o-mini";
           if (llmModel.includes("realtime")) llmModel = "gpt-4o-mini";
           this.llmLoop = new LLMLoop(
@@ -3428,7 +3068,7 @@ var init_stream_handler = __esm({
             resolvedPrompt,
             this.deps.agent.tools
           );
-          getLogger().info(`Built-in LLM loop active (pipeline, ${label})`);
+          getLogger().debug(`Built-in LLM loop active (pipeline, ${label})`);
         }
         if (this.stt) {
           this.stt.onTranscript(async (transcript) => {
@@ -3489,7 +3129,7 @@ var init_stream_handler = __esm({
       }
       async processTranscript(transcript) {
         if (transcript.text && this.isSpeaking) {
-          getLogger().info(
+          getLogger().debug(
             `Barge-in: caller spoke over agent (${sanitizeLogValue(transcript.text.slice(0, 40))})`
           );
           this.isSpeaking = false;
@@ -3524,17 +3164,17 @@ var init_stream_handler = __esm({
           "cool"
         ]);
         if (HALLUCINATIONS.has(stripped) || stripped === "") {
-          getLogger().info(`Dropped likely STT hallucination: ${sanitizeLogValue(normalised.slice(0, 40))}`);
+          getLogger().debug(`Dropped likely STT hallucination: ${sanitizeLogValue(normalised.slice(0, 40))}`);
           return;
         }
         if (sinceLastMs < 2e3 && normalised === this.lastCommitText) {
-          getLogger().info(
+          getLogger().debug(
             `Dropped duplicate final transcript (${(sinceLastMs / 1e3).toFixed(1)}s since last): ${sanitizeLogValue(normalised.slice(0, 40))}`
           );
           return;
         }
         if (sinceLastMs < 500) {
-          getLogger().info(
+          getLogger().debug(
             `Dropped back-to-back final transcript (${(sinceLastMs / 1e3).toFixed(2)}s since last): ${sanitizeLogValue(normalised.slice(0, 40))}`
           );
           return;
@@ -3542,7 +3182,7 @@ var init_stream_handler = __esm({
         this.lastCommitText = normalised;
         this.lastCommitAt = now;
         const label = this.deps.bridge.label;
-        getLogger().info(`User (${label} pipeline): ${sanitizeLogValue(transcript.text)}`);
+        getLogger().debug(`User (${label} pipeline): ${sanitizeLogValue(transcript.text)}`);
         this.metricsAcc.startTurn();
         this.metricsAcc.recordSttComplete(transcript.text);
         if (this.deps.onTranscript) {
@@ -3557,7 +3197,7 @@ var init_stream_handler = __esm({
         const hookCtx = this.buildHookContext();
         const filteredTranscript = await hookExecutor.runAfterTranscribe(transcript.text, hookCtx);
         if (filteredTranscript === null) {
-          getLogger().info(`afterTranscribe hook vetoed turn (${label})`);
+          getLogger().debug(`afterTranscribe hook vetoed turn (${label})`);
           this.metricsAcc.recordTurnInterrupted();
           return;
         }
@@ -3645,7 +3285,7 @@ var init_stream_handler = __esm({
         if (!this.llmLoop) {
           const guard = checkGuardrails(responseText, this.deps.agent.guardrails);
           if (guard) {
-            getLogger().info(`Guardrail '${guard.name}' triggered (pipeline)`);
+            getLogger().debug(`Guardrail '${guard.name}' triggered (pipeline)`);
             responseText = guard.replacement ?? "I'm sorry, I can't respond to that.";
           }
           this.metricsAcc.recordLlmComplete();
@@ -3723,7 +3363,7 @@ var init_stream_handler = __esm({
         this.adapter = this.deps.buildAIAdapter(resolvedPrompt);
         try {
           await this.adapter.connect();
-          getLogger().info(`AI adapter connected (${label})`);
+          getLogger().debug(`AI adapter connected (${label})`);
         } catch (e) {
           getLogger().error(`AI adapter connect FAILED (${label}):`, e);
           try {
@@ -3765,7 +3405,7 @@ var init_stream_handler = __esm({
           this.deps.bridge.sendMark(this.ws, `audio_${this.chunkCount}`, this.streamSid);
         } else if (type === "transcript_input") {
           const inputText = eventData;
-          getLogger().info(`User (${this.deps.bridge.label}): ${sanitizeLogValue(inputText)}`);
+          getLogger().debug(`User (${this.deps.bridge.label}): ${sanitizeLogValue(inputText)}`);
           this.history.push({ role: "user", text: inputText, timestamp: Date.now() });
           this.metricsAcc.startTurn();
           this.currentAgentText = "";
@@ -3783,7 +3423,7 @@ var init_stream_handler = __esm({
           if (outputText) {
             const triggered = checkGuardrails(outputText, this.deps.agent.guardrails);
             if (triggered) {
-              getLogger().info(`Guardrail '${triggered.name}' triggered`);
+              getLogger().debug(`Guardrail '${triggered.name}' triggered`);
               if (this.adapter instanceof OpenAIRealtimeAdapter) {
                 this.adapter.cancelResponse();
                 await this.adapter.sendText(triggered.replacement ?? "I'm sorry, I can't respond to that.");
@@ -3842,7 +3482,7 @@ var init_stream_handler = __esm({
             await adapter.sendFunctionResult(fc.call_id, JSON.stringify({ error: "Invalid phone number format", status: "rejected" }));
             return;
           }
-          getLogger().info(`Transferring call to ${transferTo}`);
+          getLogger().debug(`Transferring call to ${transferTo}`);
           await adapter.sendFunctionResult(fc.call_id, JSON.stringify({ status: "transferring", to: transferTo }));
           await this.deps.bridge.transferCall(this.callId, transferTo);
           if (this.deps.onTranscript) {
@@ -3858,7 +3498,7 @@ var init_stream_handler = __esm({
             endArgs = {};
           }
           const reason = endArgs.reason ?? "conversation_complete";
-          getLogger().info(`Ending call (${this.deps.bridge.label}): ${reason}`);
+          getLogger().debug(`Ending call (${this.deps.bridge.label}): ${reason}`);
           await adapter.sendFunctionResult(fc.call_id, JSON.stringify({ status: "ending", reason }));
           await this.deps.bridge.endCall(this.callId, this.ws);
           if (this.deps.onTranscript) {
@@ -3895,10 +3535,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 = {
@@ -3909,6 +3550,11 @@ var init_stream_handler = __esm({
           transcript: [...this.history.entries],
           metrics: finalMetrics
         };
+        const cost = finalMetrics.cost?.total ?? 0;
+        const latencyP95 = finalMetrics.latency_p95?.total_ms ?? 0;
+        getLogger().info(
+          `Call ended: ${this.callId} (${finalMetrics.duration_seconds.toFixed(1)}s, ${finalMetrics.turns.length} turns, cost=$${cost.toFixed(4)}, p95=${Math.round(latencyP95)}ms)`
+        );
         this.deps.metricsStore.recordCallEnd(
           callEndData,
           finalMetrics
@@ -4000,11 +3646,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 +3668,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 +3696,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 +3781,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 +3919,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) {
@@ -4865,909 +4463,171 @@ Connect AI agents to phone numbers in 4 lines of code
   }
 });
 
-// node_modules/cloudflared/lib/constants.js
-var require_constants = __commonJS({
-  "node_modules/cloudflared/lib/constants.js"(exports2, module2) {
-    "use strict";
-    var __create2 = Object.create;
-    var __defProp2 = Object.defineProperty;
-    var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
-    var __getOwnPropNames2 = Object.getOwnPropertyNames;
-    var __getProtoOf2 = Object.getPrototypeOf;
-    var __hasOwnProp2 = Object.prototype.hasOwnProperty;
-    var __export2 = (target, all) => {
-      for (var name in all)
-        __defProp2(target, name, { get: all[name], enumerable: true });
-    };
-    var __copyProps2 = (to, from, except, desc) => {
-      if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of __getOwnPropNames2(from))
-          if (!__hasOwnProp2.call(to, key) && key !== except)
-            __defProp2(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable });
-      }
-      return to;
-    };
-    var __toESM2 = (mod, isNodeMode, target) => (target = mod != null ? __create2(__getProtoOf2(mod)) : {}, __copyProps2(
-      // If the importer is in node compatibility mode or this is not an ESM
-      // file that has been converted to a CommonJS file using a Babel-
-      // compatible transform (i.e. "__esModule" has not been set), then set
-      // "default" to the CommonJS "module.exports" for node compatibility.
-      isNodeMode || !mod || !mod.__esModule ? __defProp2(target, "default", { value: mod, enumerable: true }) : target,
-      mod
-    ));
-    var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
-    var constants_exports = {};
-    __export2(constants_exports, {
-      CLOUDFLARED_VERSION: () => CLOUDFLARED_VERSION,
-      DEFAULT_CLOUDFLARED_BIN: () => DEFAULT_CLOUDFLARED_BIN,
-      RELEASE_BASE: () => RELEASE_BASE,
-      bin: () => bin,
-      use: () => use
-    });
-    module2.exports = __toCommonJS2(constants_exports);
-    var import_node_path = __toESM2(require("path"));
-    var DEFAULT_CLOUDFLARED_BIN = import_node_path.default.join(
-      __dirname,
-      "..",
-      "bin",
-      process.platform === "win32" ? "cloudflared.exe" : "cloudflared"
+// src/tunnel.ts
+var tunnel_exports = {};
+__export(tunnel_exports, {
+  startTunnel: () => startTunnel
+});
+async function startTunnel(port, timeoutMs = 3e4) {
+  let tunnelMod;
+  try {
+    tunnelMod = await import("cloudflared");
+  } catch {
+    throw new Error(
+      'Built-in tunnel requires the "cloudflared" package. Install it with:\n\n  npm install cloudflared\n\nOr provide your own webhookUrl instead of using tunnel: true.'
     );
-    var bin = process.env.CLOUDFLARED_BIN || DEFAULT_CLOUDFLARED_BIN;
-    function use(executable) {
-      bin = executable;
+  }
+  log.info("Starting tunnel to localhost:%d ...", port);
+  const TunnelClass = tunnelMod.Tunnel;
+  const hasQuick = TunnelClass && typeof TunnelClass.quick === "function";
+  let instance;
+  if (hasQuick) {
+    instance = TunnelClass.quick(`http://localhost:${port}`);
+  } else {
+    const result = tunnelMod.tunnel({ "--url": `http://localhost:${port}` });
+    if (result.url && typeof result.url.then === "function") {
+      const tunnelUrl2 = await Promise.race([
+        result.url,
+        new Promise(
+          (_, reject) => setTimeout(() => reject(new Error(
+            `Tunnel failed to start within ${timeoutMs / 1e3}s. Check your internet connection or provide webhookUrl manually.`
+          )), timeoutMs)
+        )
+      ]);
+      const hostname2 = tunnelUrl2.replace(/^https?:\/\//, "").replace(/\/$/, "");
+      log.info("Tunnel ready: https://%s", hostname2);
+      return { hostname: hostname2, stop: () => {
+        log.info("Stopping tunnel...");
+        result.stop();
+      } };
+    }
+    instance = result;
+  }
+  const tunnelUrl = await Promise.race([
+    new Promise((resolve) => {
+      instance.on("url", (url) => resolve(url));
+    }),
+    new Promise(
+      (_, reject) => setTimeout(() => reject(new Error(
+        `Tunnel failed to start within ${timeoutMs / 1e3}s. Check your internet connection or provide webhookUrl manually.`
+      )), timeoutMs)
+    )
+  ]);
+  const hostname = tunnelUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
+  log.info("Tunnel ready: https://%s", hostname);
+  return {
+    hostname,
+    stop: () => {
+      log.info("Stopping tunnel...");
+      instance.stop();
     }
-    var CLOUDFLARED_VERSION = process.env.CLOUDFLARED_VERSION || "latest";
-    var RELEASE_BASE = "https://github.com/cloudflare/cloudflared/releases/";
+  };
+}
+var log;
+var init_tunnel = __esm({
+  "src/tunnel.ts"() {
+    "use strict";
+    init_logger();
+    log = getLogger();
   }
 });
 
-// node_modules/cloudflared/lib/error.js
-var require_error = __commonJS({
-  "node_modules/cloudflared/lib/error.js"(exports2, module2) {
+// 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";
-    var __defProp2 = Object.defineProperty;
-    var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
-    var __getOwnPropNames2 = Object.getOwnPropertyNames;
-    var __hasOwnProp2 = Object.prototype.hasOwnProperty;
-    var __export2 = (target, all) => {
-      for (var name in all)
-        __defProp2(target, name, { get: all[name], enumerable: true });
-    };
-    var __copyProps2 = (to, from, except, desc) => {
-      if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of __getOwnPropNames2(from))
-          if (!__hasOwnProp2.call(to, key) && key !== except)
-            __defProp2(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable });
-      }
-      return to;
-    };
-    var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
-    var error_exports = {};
-    __export2(error_exports, {
-      UnsupportedError: () => UnsupportedError
-    });
-    module2.exports = __toCommonJS2(error_exports);
-    var UnsupportedError = class extends Error {
-      constructor(message) {
-        super(message);
-      }
-    };
+    init_logger();
+    TWILIO_API_BASE = "https://api.twilio.com/2010-04-01";
+    TELNYX_API_BASE = "https://api.telnyx.com/v2";
   }
 });
 
-// node_modules/cloudflared/lib/install.js
-var require_install = __commonJS({
-  "node_modules/cloudflared/lib/install.js"(exports2, module2) {
-    "use strict";
-    var __create2 = Object.create;
-    var __defProp2 = Object.defineProperty;
-    var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
-    var __getOwnPropNames2 = Object.getOwnPropertyNames;
-    var __getProtoOf2 = Object.getPrototypeOf;
-    var __hasOwnProp2 = Object.prototype.hasOwnProperty;
-    var __export2 = (target, all) => {
-      for (var name in all)
-        __defProp2(target, name, { get: all[name], enumerable: true });
-    };
-    var __copyProps2 = (to, from, except, desc) => {
-      if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of __getOwnPropNames2(from))
-          if (!__hasOwnProp2.call(to, key) && key !== except)
-            __defProp2(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable });
-      }
-      return to;
-    };
-    var __toESM2 = (mod, isNodeMode, target) => (target = mod != null ? __create2(__getProtoOf2(mod)) : {}, __copyProps2(
-      // If the importer is in node compatibility mode or this is not an ESM
-      // file that has been converted to a CommonJS file using a Babel-
-      // compatible transform (i.e. "__esModule" has not been set), then set
-      // "default" to the CommonJS "module.exports" for node compatibility.
-      isNodeMode || !mod || !mod.__esModule ? __defProp2(target, "default", { value: mod, enumerable: true }) : target,
-      mod
-    ));
-    var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
-    var install_exports = {};
-    __export2(install_exports, {
-      install: () => install,
-      install_linux: () => install_linux,
-      install_macos: () => install_macos,
-      install_windows: () => install_windows
-    });
-    module2.exports = __toCommonJS2(install_exports);
-    var import_node_fs = __toESM2(require("fs"));
-    var import_node_path = __toESM2(require("path"));
-    var import_node_https = __toESM2(require("https"));
-    var import_node_child_process = require("child_process");
-    var import_constants = require_constants();
-    var import_error = require_error();
-    var LINUX_URL = {
-      arm64: "cloudflared-linux-arm64",
-      arm: "cloudflared-linux-arm",
-      x64: "cloudflared-linux-amd64",
-      ia32: "cloudflared-linux-386"
-    };
-    var MACOS_URL = {
-      arm64: "cloudflared-darwin-arm64.tgz",
-      x64: "cloudflared-darwin-amd64.tgz"
-    };
-    var WINDOWS_URL = {
-      x64: "cloudflared-windows-amd64.exe",
-      ia32: "cloudflared-windows-386.exe"
-    };
-    function resolve_base(version2) {
-      if (version2 === "latest") {
-        return `${import_constants.RELEASE_BASE}latest/download/`;
-      }
-      return `${import_constants.RELEASE_BASE}download/${version2}/`;
-    }
-    async function install(to, version2 = import_constants.CLOUDFLARED_VERSION) {
-      if (process.platform === "linux") {
-        return install_linux(to, version2);
-      } else if (process.platform === "darwin") {
-        return install_macos(to, version2);
-      } else if (process.platform === "win32") {
-        return install_windows(to, version2);
-      } else {
-        throw new import_error.UnsupportedError("Unsupported platform: " + process.platform);
-      }
-    }
-    async function install_linux(to, version2 = import_constants.CLOUDFLARED_VERSION) {
-      const file = LINUX_URL[process.arch];
-      if (file === void 0) {
-        throw new import_error.UnsupportedError("Unsupported architecture: " + process.arch);
-      }
-      await download(resolve_base(version2) + file, to);
-      import_node_fs.default.chmodSync(to, "755");
-      return to;
-    }
-    async function install_macos(to, version2 = import_constants.CLOUDFLARED_VERSION) {
-      let arch = process.arch;
-      if (version2 !== "latest" && version_number(version2) < 20240802) {
-        arch = "x64";
-      }
-      const file = MACOS_URL[arch];
-      if (file === void 0) {
-        throw new import_error.UnsupportedError("Unsupported architecture: " + arch);
-      }
-      await download(resolve_base(version2) + file, `${to}.tgz`);
-      process.env.VERBOSE && console.log(`Extracting to ${to}`);
-      (0, import_node_child_process.execSync)(`tar -xzf ${import_node_path.default.basename(`${to}.tgz`)}`, { cwd: import_node_path.default.dirname(to) });
-      import_node_fs.default.unlinkSync(`${to}.tgz`);
-      import_node_fs.default.renameSync(`${import_node_path.default.dirname(to)}/cloudflared`, to);
-      return to;
-    }
-    async function install_windows(to, version2 = import_constants.CLOUDFLARED_VERSION) {
-      const file = WINDOWS_URL[process.arch];
-      if (file === void 0) {
-        throw new import_error.UnsupportedError("Unsupported architecture: " + process.arch);
-      }
-      await download(resolve_base(version2) + file, to);
-      return to;
-    }
-    function download(url, to, redirect = 0) {
-      if (redirect === 0) {
-        process.env.VERBOSE && console.log(`Downloading ${url} to ${to}`);
-      } else {
-        process.env.VERBOSE && console.log(`Redirecting to ${url}`);
-      }
-      if (!import_node_fs.default.existsSync(import_node_path.default.dirname(to))) {
-        import_node_fs.default.mkdirSync(import_node_path.default.dirname(to), { recursive: true });
-      }
-      return new Promise((resolve, reject) => {
-        const request = import_node_https.default.get(url, (res) => {
-          const redirect_code = [301, 302, 303, 307, 308];
-          if (redirect_code.includes(res.statusCode) && res.headers.location !== void 0) {
-            request.destroy();
-            const redirection = res.headers.location;
-            resolve(download(redirection, to, redirect + 1));
-            return;
-          }
-          if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
-            const file = import_node_fs.default.createWriteStream(to);
-            file.on("finish", () => {
-              file.close(() => resolve(to));
-            });
-            file.on("error", (err) => {
-              import_node_fs.default.unlink(to, () => reject(err));
-            });
-            res.pipe(file);
-          } else {
-            request.destroy();
-            reject(new Error(`HTTP response with status code: ${res.statusCode}`));
-          }
-        });
-        request.on("error", (err) => {
-          reject(err);
-        });
-        request.end();
-      });
-    }
-    function version_number(semver) {
-      const [major, minor, patch] = semver.split(".").map(Number);
-      return major * 1e4 + minor * 100 + patch;
-    }
-  }
-});
-
-// node_modules/cloudflared/lib/regex.js
-var require_regex = __commonJS({
-  "node_modules/cloudflared/lib/regex.js"(exports2, module2) {
-    "use strict";
-    var __defProp2 = Object.defineProperty;
-    var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
-    var __getOwnPropNames2 = Object.getOwnPropertyNames;
-    var __hasOwnProp2 = Object.prototype.hasOwnProperty;
-    var __export2 = (target, all) => {
-      for (var name in all)
-        __defProp2(target, name, { get: all[name], enumerable: true });
-    };
-    var __copyProps2 = (to, from, except, desc) => {
-      if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of __getOwnPropNames2(from))
-          if (!__hasOwnProp2.call(to, key) && key !== except)
-            __defProp2(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable });
-      }
-      return to;
-    };
-    var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
-    var regex_exports = {};
-    __export2(regex_exports, {
-      config_regex: () => config_regex,
-      conn_regex: () => conn_regex,
-      connectorID_regex: () => connectorID_regex,
-      disconnect_regex: () => disconnect_regex,
-      index_regex: () => index_regex,
-      ip_regex: () => ip_regex,
-      location_regex: () => location_regex,
-      metrics_regex: () => metrics_regex,
-      tunnelID_regex: () => tunnelID_regex
-    });
-    module2.exports = __toCommonJS2(regex_exports);
-    var conn_regex = /connection[= ]([0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})/i;
-    var ip_regex = /ip=([0-9.]+)/;
-    var location_regex = /location=([A-Za-z0-9]+)/;
-    var index_regex = /connIndex=(\d)/;
-    var disconnect_regex = /Unregistered tunnel connection connIndex=(\d)/i;
-    var tunnelID_regex = /tunnelID=([0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})/i;
-    var connectorID_regex = /Connector ID: ([0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12})/i;
-    var metrics_regex = /metrics server on ([0-9.:]+\/metrics)/;
-    var config_regex = /config="(.+[^\\])"/;
-  }
-});
-
-// node_modules/cloudflared/lib/handler.js
-var require_handler = __commonJS({
-  "node_modules/cloudflared/lib/handler.js"(exports2, module2) {
-    "use strict";
-    var __defProp2 = Object.defineProperty;
-    var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
-    var __getOwnPropNames2 = Object.getOwnPropertyNames;
-    var __hasOwnProp2 = Object.prototype.hasOwnProperty;
-    var __export2 = (target, all) => {
-      for (var name in all)
-        __defProp2(target, name, { get: all[name], enumerable: true });
-    };
-    var __copyProps2 = (to, from, except, desc) => {
-      if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of __getOwnPropNames2(from))
-          if (!__hasOwnProp2.call(to, key) && key !== except)
-            __defProp2(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable });
-      }
-      return to;
-    };
-    var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
-    var handler_exports = {};
-    __export2(handler_exports, {
-      ConfigHandler: () => ConfigHandler,
-      ConnectionHandler: () => ConnectionHandler,
-      TryCloudflareHandler: () => TryCloudflareHandler
-    });
-    module2.exports = __toCommonJS2(handler_exports);
-    var import_node_stream = require("stream");
-    var import_regex2 = require_regex();
-    var ConnectionHandler = class {
-      constructor(tunnel) {
-        this.connections = [];
-        this.connected_handler = (output, tunnel2) => {
-          const conn_match = output.match(import_regex2.conn_regex);
-          const ip_match = output.match(import_regex2.ip_regex);
-          const location_match = output.match(import_regex2.location_regex);
-          const index_match = output.match(import_regex2.index_regex);
-          if (conn_match && ip_match && location_match && index_match) {
-            const connection = {
-              id: conn_match[1],
-              ip: ip_match[1],
-              location: location_match[1]
-            };
-            this.connections[Number(index_match[1])] = connection;
-            tunnel2.emit("connected", connection);
-          }
-        };
-        this.disconnected_handler = (output, tunnel2) => {
-          const index_match = output.includes("terminated") ? output.match(import_regex2.index_regex) : null;
-          if (index_match) {
-            const index = Number(index_match[1]);
-            if (this.connections[index]) {
-              tunnel2.emit("disconnected", this.connections[index]);
-              this.connections[index] = void 0;
-            }
-          }
-        };
-        tunnel.addHandler(this.connected_handler.bind(this));
-        tunnel.addHandler(this.disconnected_handler.bind(this));
-      }
-    };
-    var TryCloudflareHandler = class {
-      constructor(tunnel) {
-        this.url_handler = (output, tunnel2) => {
-          const url_match = output.match(/https:\/\/([a-z0-9-]+)\.trycloudflare\.com/);
-          if (url_match) {
-            tunnel2.emit("url", url_match[0]);
-          }
-        };
-        tunnel.addHandler(this.url_handler.bind(this));
-      }
-    };
-    var ConfigHandler = class extends import_node_stream.EventEmitter {
-      constructor(tunnel) {
-        super();
-        this.config_handler = (output, tunnel2) => {
-          const config_match = output.match(/\bconfig="(.+?)" version=(\d+)/);
-          if (config_match) {
-            try {
-              const config_str = config_match[1].replace(/\\"/g, '"');
-              const config = JSON.parse(config_str);
-              const version2 = parseInt(config_match[2], 10);
-              this.emit("config", {
-                config,
-                version: version2
-              });
-              if (config && typeof config === "object" && "ingress" in config && Array.isArray(config.ingress)) {
-                for (const ingress of config.ingress) {
-                  if ("hostname" in ingress) {
-                    tunnel2.emit("url", ingress.hostname);
-                  }
-                }
-              }
-            } catch (error) {
-              this.emit("error", new Error(`Failed to parse config: ${error}`));
-            }
-          }
-        };
-        tunnel.addHandler(this.config_handler.bind(this));
-      }
-      on(event, listener) {
-        return super.on(event, listener);
-      }
-      once(event, listener) {
-        return super.once(event, listener);
-      }
-      off(event, listener) {
-        return super.off(event, listener);
-      }
-      emit(event, ...args) {
-        return super.emit(event, ...args);
-      }
-    };
-  }
-});
-
-// node_modules/cloudflared/lib/tunnel.js
-var require_tunnel = __commonJS({
-  "node_modules/cloudflared/lib/tunnel.js"(exports2, module2) {
-    "use strict";
-    var __defProp2 = Object.defineProperty;
-    var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
-    var __getOwnPropNames2 = Object.getOwnPropertyNames;
-    var __hasOwnProp2 = Object.prototype.hasOwnProperty;
-    var __export2 = (target, all) => {
-      for (var name in all)
-        __defProp2(target, name, { get: all[name], enumerable: true });
-    };
-    var __copyProps2 = (to, from, except, desc) => {
-      if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of __getOwnPropNames2(from))
-          if (!__hasOwnProp2.call(to, key) && key !== except)
-            __defProp2(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable });
-      }
-      return to;
-    };
-    var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
-    var tunnel_exports2 = {};
-    __export2(tunnel_exports2, {
-      Tunnel: () => Tunnel,
-      build_args: () => build_args,
-      build_options: () => build_options,
-      tunnel: () => tunnel
-    });
-    module2.exports = __toCommonJS2(tunnel_exports2);
-    var import_node_child_process = require("child_process");
-    var import_node_events = require("events");
-    var import_constants = require_constants();
-    var import_handler = require_handler();
-    var Tunnel = class _Tunnel extends import_node_events.EventEmitter {
-      constructor(options = ["tunnel", "--hello-world"]) {
-        super();
-        this.outputHandlers = [];
-        this.stop = this._stop.bind(this);
-        this.setupDefaultHandlers();
-        const args = Array.isArray(options) ? options : build_args(options);
-        this._process = this.createProcess(args);
-        this.setupEventHandlers();
-      }
-      get process() {
-        return this._process;
-      }
-      setupDefaultHandlers() {
-        new import_handler.ConnectionHandler(this);
-        new import_handler.TryCloudflareHandler(this);
-      }
-      /**
-       * Add a custom output handler
-       * @param handler Function to handle cloudflared output
-       */
-      addHandler(handler) {
-        this.outputHandlers.push(handler);
-      }
-      /**
-       * Remove a previously added output handler
-       * @param handler The handler to remove
-       */
-      removeHandler(handler) {
-        const index = this.outputHandlers.indexOf(handler);
-        if (index !== -1) {
-          this.outputHandlers.splice(index, 1);
-        }
-      }
-      processOutput(output) {
-        for (const handler of this.outputHandlers) {
-          try {
-            handler(output, this);
-          } catch (error) {
-            this.emit("error", error instanceof Error ? error : new Error(String(error)));
-          }
-        }
-      }
-      setupEventHandlers() {
-        this.on("stdout", (output) => {
-          this.processOutput(output);
-        });
-        this.on("stderr", (output) => {
-          this.processOutput(output);
-        });
-      }
-      createProcess(args) {
-        var _a, _b;
-        const child = (0, import_node_child_process.spawn)(import_constants.bin, args, { stdio: ["ignore", "pipe", "pipe"] });
-        child.on("error", (error) => this.emit("error", error));
-        child.on("exit", (code, signal) => this.emit("exit", code, signal));
-        if (process.env.VERBOSE) {
-          child.stdout.pipe(process.stdout);
-          child.stderr.pipe(process.stderr);
-        }
-        (_a = child.stdout) == null ? void 0 : _a.on("data", (data) => this.emit("stdout", data.toString()));
-        (_b = child.stderr) == null ? void 0 : _b.on("data", (data) => this.emit("stderr", data.toString()));
-        return child;
-      }
-      _stop() {
-        return this.process.kill("SIGINT");
-      }
-      on(event, listener) {
-        return super.on(event, listener);
-      }
-      once(event, listener) {
-        return super.once(event, listener);
-      }
-      off(event, listener) {
-        return super.off(event, listener);
-      }
-      emit(event, ...args) {
-        return super.emit(event, ...args);
-      }
-      /**
-       * Create a quick tunnel without a Cloudflare account.
-       * @param url The local service URL to connect to. If not provided, the hello world mode will be used.
-       * @param options The options to pass to cloudflared.
-       */
-      static quick(url, options = {}) {
-        const args = ["tunnel"];
-        if (url) {
-          args.push("--url", url);
-        } else {
-          args.push("--hello-world");
-        }
-        args.push(...build_options(options));
-        return new _Tunnel(args);
-      }
-      /**
-       * Create a tunnel with a Cloudflare account.
-       * @param token The Cloudflare Tunnel token.
-       * @param options The options to pass to cloudflared.
-       */
-      static withToken(token, options = {}) {
-        options["--token"] = token;
-        return new _Tunnel(build_args(options));
-      }
-    };
-    function tunnel(options = {}) {
-      return new Tunnel(options);
-    }
-    function build_args(options) {
-      const args = "--hello-world" in options ? ["tunnel"] : ["tunnel", "run"];
-      args.push(...build_options(options));
-      return args;
-    }
-    function build_options(options) {
-      const opts = [];
-      for (const [key, value] of Object.entries(options)) {
-        if (typeof value === "string") {
-          opts.push(`${key}`, value);
-        } else if (typeof value === "number") {
-          opts.push(`${key}`, value.toString());
-        } else if (typeof value === "boolean") {
-          if (value === true) {
-            opts.push(`${key}`);
-          }
-        }
-      }
-      return opts;
-    }
-  }
-});
-
-// node_modules/cloudflared/lib/service.js
-var require_service = __commonJS({
-  "node_modules/cloudflared/lib/service.js"(exports2, module2) {
-    "use strict";
-    var __create2 = Object.create;
-    var __defProp2 = Object.defineProperty;
-    var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
-    var __getOwnPropNames2 = Object.getOwnPropertyNames;
-    var __getProtoOf2 = Object.getPrototypeOf;
-    var __hasOwnProp2 = Object.prototype.hasOwnProperty;
-    var __export2 = (target, all) => {
-      for (var name in all)
-        __defProp2(target, name, { get: all[name], enumerable: true });
-    };
-    var __copyProps2 = (to, from, except, desc) => {
-      if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of __getOwnPropNames2(from))
-          if (!__hasOwnProp2.call(to, key) && key !== except)
-            __defProp2(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable });
-      }
-      return to;
-    };
-    var __toESM2 = (mod, isNodeMode, target) => (target = mod != null ? __create2(__getProtoOf2(mod)) : {}, __copyProps2(
-      // If the importer is in node compatibility mode or this is not an ESM
-      // file that has been converted to a CommonJS file using a Babel-
-      // compatible transform (i.e. "__esModule" has not been set), then set
-      // "default" to the CommonJS "module.exports" for node compatibility.
-      isNodeMode || !mod || !mod.__esModule ? __defProp2(target, "default", { value: mod, enumerable: true }) : target,
-      mod
-    ));
-    var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
-    var service_exports = {};
-    __export2(service_exports, {
-      AlreadyInstalledError: () => AlreadyInstalledError2,
-      LINUX_SERVICE_PATH: () => LINUX_SERVICE_PATH,
-      MACOS_SERVICE_PATH: () => MACOS_SERVICE_PATH2,
-      NotInstalledError: () => NotInstalledError2,
-      clean: () => clean,
-      current: () => current,
-      err: () => err,
-      exists: () => exists,
-      identifier: () => identifier2,
-      install: () => install,
-      journal: () => journal,
-      log: () => log2,
-      service: () => service2,
-      service_name: () => service_name,
-      uninstall: () => uninstall
-    });
-    module2.exports = __toCommonJS2(service_exports);
-    var import_node_os = __toESM2(require("os"));
-    var import_node_fs = __toESM2(require("fs"));
-    var import_node_child_process = require("child_process");
-    var import_constants = require_constants();
-    var import_regex2 = require_regex();
-    var identifier2 = "com.cloudflare.cloudflared";
-    var service_name = "cloudflared.service";
-    var MACOS_SERVICE_PATH2 = {
-      PLIST: is_root() ? `/Library/LaunchDaemons/${identifier2}.plist` : `${import_node_os.default.homedir()}/Library/LaunchAgents/${identifier2}.plist`,
-      OUT: is_root() ? `/Library/Logs/${identifier2}.out.log` : `${import_node_os.default.homedir()}/Library/Logs/${identifier2}.out.log`,
-      ERR: is_root() ? `/Library/Logs/${identifier2}.err.log` : `${import_node_os.default.homedir()}/Library/Logs/${identifier2}.err.log`
-    };
-    var LINUX_SERVICE_PATH = {
-      SYSTEMD: `/etc/systemd/system/${service_name}`,
-      SERVICE: "/etc/init.d/cloudflared",
-      SERVICE_OUT: "/var/log/cloudflared.log",
-      SERVICE_ERR: "/var/log/cloudflared.err"
-    };
-    var service2 = { install, uninstall, exists, log: log2, err, current, clean, journal };
-    var AlreadyInstalledError2 = class extends Error {
-      constructor() {
-        super("service is already installed");
-      }
-    };
-    var NotInstalledError2 = class extends Error {
-      constructor() {
-        super("service is not installed");
-      }
-    };
-    function install(token) {
-      if (!["darwin", "linux"].includes(process.platform)) {
-        throw new Error(`Not Implemented on platform ${process.platform}`);
-      }
-      if (exists()) {
-        throw new AlreadyInstalledError2();
-      }
-      const args = ["service", "install"];
-      if (token) {
-        args.push(token);
-      }
-      const result = (0, import_node_child_process.spawnSync)(import_constants.bin, args);
-      if (result.status !== 0) {
-        throw new Error(`service install failed: ${result.stderr.toString()}`);
-      }
-    }
-    function uninstall() {
-      if (!["darwin", "linux"].includes(process.platform)) {
-        throw new Error(`Not Implemented on platform ${process.platform}`);
-      }
-      if (!exists()) {
-        throw new NotInstalledError2();
-      }
-      const result = (0, import_node_child_process.spawnSync)(import_constants.bin, ["service", "uninstall"]);
-      if (result.status !== 0) {
-        throw new Error(`service uninstall failed: ${result.stderr.toString()}`);
-      }
-      if (process.platform === "darwin") {
-        import_node_fs.default.rmSync(MACOS_SERVICE_PATH2.OUT);
-        import_node_fs.default.rmSync(MACOS_SERVICE_PATH2.ERR);
-      } else if (process.platform === "linux" && !is_systemd()) {
-        import_node_fs.default.rmSync(LINUX_SERVICE_PATH.SERVICE_OUT);
-        import_node_fs.default.rmSync(LINUX_SERVICE_PATH.SERVICE_ERR);
-      }
-    }
-    function log2() {
-      if (!exists()) {
-        throw new NotInstalledError2();
-      }
-      if (process.platform === "darwin") {
-        return import_node_fs.default.readFileSync(MACOS_SERVICE_PATH2.OUT, "utf8");
-      }
-      if (process.platform === "linux" && !is_systemd()) {
-        return import_node_fs.default.readFileSync(LINUX_SERVICE_PATH.SERVICE_OUT, "utf8");
-      }
-      throw new Error(`Not Implemented on platform ${process.platform}`);
-    }
-    function err() {
-      if (!exists()) {
-        throw new NotInstalledError2();
-      }
-      if (process.platform === "darwin") {
-        return import_node_fs.default.readFileSync(MACOS_SERVICE_PATH2.ERR, "utf8");
-      }
-      if (process.platform === "linux" && !is_systemd()) {
-        return import_node_fs.default.readFileSync(LINUX_SERVICE_PATH.SERVICE_ERR, "utf8");
-      }
-      throw new Error(`Not Implemented on platform ${process.platform}`);
-    }
-    function journal(n = 300) {
-      if (process.platform === "linux" && is_systemd()) {
-        const args = ["-u", service_name, "-o", "cat", "-n", n.toString()];
-        return (0, import_node_child_process.spawnSync)("journalctl", args).stdout.toString();
-      }
-      throw new Error(`Not Implemented on platform ${process.platform}`);
-    }
-    function current() {
-      var _a, _b, _c, _d;
-      if (!["darwin", "linux"].includes(process.platform)) {
-        throw new Error(`Not Implemented on platform ${process.platform}`);
-      }
-      if (!exists()) {
-        throw new NotInstalledError2();
-      }
-      const log22 = is_systemd() ? journal() : err();
-      let tunnelID = "";
-      let connectorID = "";
-      const connections = [];
-      let metrics = "";
-      let config = {};
-      for (const line of log22.split("\n")) {
-        try {
-          if (line.match(import_regex2.tunnelID_regex)) {
-            tunnelID = ((_a = line.match(import_regex2.tunnelID_regex)) == null ? void 0 : _a[1]) ?? "";
-          } else if (line.match(import_regex2.connectorID_regex)) {
-            connectorID = ((_b = line.match(import_regex2.connectorID_regex)) == null ? void 0 : _b[1]) ?? "";
-          } else if (line.match(import_regex2.conn_regex) && line.match(import_regex2.location_regex) && line.match(import_regex2.ip_regex) && line.match(import_regex2.index_regex)) {
-            const [, id] = line.match(import_regex2.conn_regex) ?? [];
-            const [, location] = line.match(import_regex2.location_regex) ?? [];
-            const [, ip] = line.match(import_regex2.ip_regex) ?? [];
-            const [, idx] = line.match(import_regex2.index_regex) ?? [];
-            connections[parseInt(idx)] = { id, ip, location };
-          } else if (line.match(import_regex2.disconnect_regex)) {
-            const [, idx] = line.match(import_regex2.disconnect_regex) ?? [];
-            if (parseInt(idx) in connections) {
-              connections[parseInt(idx)] = { id: "", ip: "", location: "" };
-            }
-          } else if (line.match(import_regex2.metrics_regex)) {
-            metrics = ((_c = line.match(import_regex2.metrics_regex)) == null ? void 0 : _c[1]) ?? "";
-          } else if (line.match(import_regex2.config_regex)) {
-            config = JSON.parse(((_d = line.match(import_regex2.config_regex)) == null ? void 0 : _d[1].replace(/\\/g, "")) ?? "{}");
-          }
-        } catch (err2) {
-          if (process.env.VERBOSE) {
-            console.error("log parsing failed", err2);
-          }
-        }
-      }
-      return { tunnelID, connectorID, connections, metrics, config };
-    }
-    function clean() {
-      if (process.platform !== "darwin") {
-        throw new Error(`Not Implemented on platform ${process.platform}`);
-      }
-      if (exists()) {
-        throw new AlreadyInstalledError2();
-      }
-      import_node_fs.default.rmSync(MACOS_SERVICE_PATH2.OUT, { force: true });
-      import_node_fs.default.rmSync(MACOS_SERVICE_PATH2.ERR, { force: true });
-    }
-    function exists() {
-      if (process.platform === "darwin") {
-        return import_node_fs.default.existsSync(MACOS_SERVICE_PATH2.PLIST);
-      } else if (process.platform === "linux") {
-        return is_systemd() ? import_node_fs.default.existsSync(LINUX_SERVICE_PATH.SYSTEMD) : import_node_fs.default.existsSync(LINUX_SERVICE_PATH.SERVICE);
-      }
-      throw new Error(`Not Implemented on platform ${process.platform}`);
-    }
-    function is_root() {
-      var _a;
-      return ((_a = process.getuid) == null ? void 0 : _a.call(process)) === 0;
-    }
-    function is_systemd() {
-      return process.platform === "linux" && import_node_fs.default.existsSync("/run/systemd/system");
-    }
-  }
-});
-
-// node_modules/cloudflared/lib/lib.js
-var require_lib = __commonJS({
-  "node_modules/cloudflared/lib/lib.js"(exports2, module2) {
-    "use strict";
-    var __defProp2 = Object.defineProperty;
-    var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
-    var __getOwnPropNames2 = Object.getOwnPropertyNames;
-    var __hasOwnProp2 = Object.prototype.hasOwnProperty;
-    var __export2 = (target, all) => {
-      for (var name in all)
-        __defProp2(target, name, { get: all[name], enumerable: true });
-    };
-    var __copyProps2 = (to, from, except, desc) => {
-      if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of __getOwnPropNames2(from))
-          if (!__hasOwnProp2.call(to, key) && key !== except)
-            __defProp2(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable });
-      }
-      return to;
-    };
-    var __reExport = (target, mod, secondTarget) => (__copyProps2(target, mod, "default"), secondTarget && __copyProps2(secondTarget, mod, "default"));
-    var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
-    var lib_exports = {};
-    __export2(lib_exports, {
-      AlreadyInstalledError: () => import_service.AlreadyInstalledError,
-      MACOS_SERVICE_PATH: () => import_service.MACOS_SERVICE_PATH,
-      NotInstalledError: () => import_service.NotInstalledError,
-      identifier: () => import_service.identifier,
-      service: () => import_service.service
-    });
-    module2.exports = __toCommonJS2(lib_exports);
-    __reExport(lib_exports, require_constants(), module2.exports);
-    __reExport(lib_exports, require_install(), module2.exports);
-    __reExport(lib_exports, require_tunnel(), module2.exports);
-    var import_service = require_service();
-    __reExport(lib_exports, require_handler(), module2.exports);
-  }
-});
-
-// src/tunnel.ts
-var tunnel_exports = {};
-__export(tunnel_exports, {
-  startTunnel: () => startTunnel
-});
-async function startTunnel(port, timeoutMs = 3e4) {
-  let tunnelMod;
-  try {
-    tunnelMod = await Promise.resolve().then(() => __toESM(require_lib()));
-  } catch {
-    throw new Error(
-      'Built-in tunnel requires the "cloudflared" package. Install it with:\n\n  npm install cloudflared\n\nOr provide your own webhookUrl instead of using tunnel: true.'
-    );
-  }
-  log.info("Starting tunnel to localhost:%d ...", port);
-  const TunnelClass = tunnelMod.Tunnel;
-  const hasQuick = TunnelClass && typeof TunnelClass.quick === "function";
-  let instance;
-  if (hasQuick) {
-    instance = TunnelClass.quick(`http://localhost:${port}`);
-  } else {
-    const result = tunnelMod.tunnel({ "--url": `http://localhost:${port}` });
-    if (result.url && typeof result.url.then === "function") {
-      const tunnelUrl2 = await Promise.race([
-        result.url,
-        new Promise(
-          (_, reject) => setTimeout(() => reject(new Error(
-            `Tunnel failed to start within ${timeoutMs / 1e3}s. Check your internet connection or provide webhookUrl manually.`
-          )), timeoutMs)
-        )
-      ]);
-      const hostname2 = tunnelUrl2.replace(/^https?:\/\//, "").replace(/\/$/, "");
-      log.info("Tunnel ready: https://%s", hostname2);
-      return { hostname: hostname2, stop: () => {
-        log.info("Stopping tunnel...");
-        result.stop();
-      } };
-    }
-    instance = result;
-  }
-  const tunnelUrl = await Promise.race([
-    new Promise((resolve) => {
-      instance.on("url", (url) => resolve(url));
-    }),
-    new Promise(
-      (_, reject) => setTimeout(() => reject(new Error(
-        `Tunnel failed to start within ${timeoutMs / 1e3}s. Check your internet connection or provide webhookUrl manually.`
-      )), timeoutMs)
-    )
-  ]);
-  const hostname = tunnelUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
-  log.info("Tunnel ready: https://%s", hostname);
-  return {
-    hostname,
-    stop: () => {
-      log.info("Stopping tunnel...");
-      instance.stop();
-    }
-  };
-}
-var log;
-var init_tunnel = __esm({
-  "src/tunnel.ts"() {
-    "use strict";
-    init_logger();
-    log = getLogger();
-  }
-});
-
-// src/test-mode.ts
-var test_mode_exports = {};
-__export(test_mode_exports, {
-  TestSession: () => TestSession
-});
-var import_readline, TestSession;
-var init_test_mode = __esm({
-  "src/test-mode.ts"() {
+// src/test-mode.ts
+var test_mode_exports = {};
+__export(test_mode_exports, {
+  TestSession: () => TestSession
+});
+var import_readline, TestSession;
+var init_test_mode = __esm({
+  "src/test-mode.ts"() {
     "use strict";
     import_readline = require("readline");
     init_llm_loop();
@@ -6874,31 +5734,40 @@ var require_node_cron = __commonJS({
 var index_exports = {};
 __export(index_exports, {
   AllProvidersFailedError: () => AllProvidersFailedError,
-  AssemblyAISTT: () => AssemblyAISTT,
+  AnthropicLLM: () => LLM2,
+  AssemblyAISTT: () => STT5,
   AuthenticationError: () => AuthenticationError,
   BackgroundAudioPlayer: () => BackgroundAudioPlayer,
   BuiltinAudioClip: () => BuiltinAudioClip,
   CallMetricsAccumulator: () => CallMetricsAccumulator,
-  CartesiaSTT: () => CartesiaSTT,
-  CartesiaTTS: () => CartesiaTTS,
+  CartesiaSTT: () => STT3,
+  CartesiaTTS: () => TTS3,
+  CerebrasLLM: () => LLM4,
   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,
+  GoogleLLM: () => LLM5,
+  GroqLLM: () => LLM3,
+  Guardrail: () => Guardrail,
   IVRActivity: () => IVRActivity,
   LLMLoop: () => LLMLoop,
-  LMNTTTS: () => LMNTTTS,
+  LMNTTTS: () => TTS5,
   MetricsStore: () => MetricsStore,
+  OpenAILLM: () => LLM,
   OpenAILLMProvider: () => OpenAILLMProvider,
+  OpenAIRealtime: () => Realtime,
   OpenAIRealtimeAdapter: () => OpenAIRealtimeAdapter,
-  OpenAITTS: () => OpenAITTS,
+  OpenAITTS: () => TTS2,
   PartialStreamError: () => PartialStreamError,
   Patter: () => Patter,
   PatterConnectionError: () => PatterConnectionError,
@@ -6906,15 +5775,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 +5803,7 @@ __export(index_exports, {
   filterMarkdown: () => filterMarkdown,
   formatDtmf: () => formatDtmf,
   getLogger: () => getLogger,
+  guardrail: () => guardrail,
   isRemoteUrl: () => isRemoteUrl,
   isWebSocketUrl: () => isWebSocketUrl,
   makeAuthMiddleware: () => makeAuthMiddleware,
@@ -6951,6 +5825,7 @@ __export(index_exports, {
   selectSoundFromList: () => selectSoundFromList,
   setLogger: () => setLogger,
   startTunnel: () => startTunnel,
+  tool: () => tool,
   whisper: () => whisper
 });
 module.exports = __toCommonJS(index_exports);
@@ -7096,77 +5971,70 @@ 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();
+init_logger();
 var DEFAULT_BACKEND_URL2 = "wss://api.getpatter.com";
 var DEFAULT_REST_URL = "https://api.getpatter.com";
 function sttConfigToDict(cfg) {
@@ -7197,21 +6065,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 +6114,70 @@ 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."
+        );
+      }
+    } else if (!working.provider && (working.stt !== void 0 || working.tts !== void 0 || working.llm !== void 0)) {
+      working = { ...working, provider: "pipeline" };
+    }
+    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 (working.llm !== void 0) {
+      const llm = working.llm;
+      if (!llm || typeof llm.stream !== "function") {
+        throw new Error(
+          "`llm` must be an LLMProvider instance (e.g. new AnthropicLLM()). Got a value without a `.stream` method."
+        );
+      }
+      if (working.engine) {
+        getLogger().warn(
+          "agent({ engine, llm }): `llm` is ignored when `engine` is set \u2014 realtime/ConvAI engines run their own model. Remove `llm` or switch to pipeline mode (stt + tts + llm) to silence this warning."
+        );
       }
     }
-    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 +6200,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 +6217,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 +6300,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 +6343,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 +6476,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,6 +6570,62 @@ function filterForTTS(text) {
   return filterEmoji(filterMarkdown(text));
 }
 
+// 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();
@@ -8372,73 +7316,387 @@ function scheduleInterval(intervalOrOpts, callback) {
   };
 }
 
-// src/index.ts
+// src/stt/deepgram.ts
 init_deepgram_stt();
+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."
+      );
+    }
+    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 } : {}
+      }
+    );
+  }
+};
 
-// src/providers/soniox-stt.ts
-var import_ws7 = __toESM(require("ws"));
+// src/providers/whisper-stt.ts
 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 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 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 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;
   }
-  get confidence() {
-    return this.confCount === 0 ? 0 : this.confSum / this.confCount;
+  /** 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);
   }
-  reset() {
-    this.text = "";
-    this.confSum = 0;
-    this.confCount = 0;
+  async connect() {
+    this.running = true;
+    this.buffer = Buffer.alloc(0);
   }
-  get raw() {
-    return { sum: this.confSum, count: this.confCount };
+  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);
   }
-};
-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");
+  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;
     }
-    const maxEndpointDelayMs = options.maxEndpointDelayMs ?? 500;
-    if (maxEndpointDelayMs < 500 || maxEndpointDelayMs > 3e3) {
-      throw new Error("maxEndpointDelayMs must be between 500 and 3000");
+    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);
     }
-    this.apiKey = apiKey;
-    this.model = options.model ?? "stt-rt-v4";
-    this.languageHints = options.languageHints;
-    this.languageHintsStrict = options.languageHintsStrict ?? false;
+    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)}`);
+    }
+  }
+};
+
+// 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."
+      );
+    }
+    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;
@@ -8473,7 +7731,7 @@ var SonioxSTT = class _SonioxSTT {
     return config;
   }
   async connect() {
-    this.ws = new import_ws7.default(this.baseUrl);
+    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", () => {
@@ -8492,13 +7750,13 @@ var SonioxSTT = class _SonioxSTT {
       getLogger().error(`SonioxSTT WebSocket error: ${String(err)}`);
     });
     this.keepaliveTimer = setInterval(() => {
-      if (this.ws && this.ws.readyState === import_ws7.default.OPEN) {
+      if (this.ws && this.ws.readyState === import_ws8.default.OPEN) {
         try {
           this.ws.send(KEEPALIVE_MESSAGE);
         } catch {
         }
       }
-    }, KEEPALIVE_INTERVAL_MS);
+    }, KEEPALIVE_INTERVAL_MS2);
   }
   clearKeepalive() {
     if (this.keepaliveTimer) {
@@ -8565,7 +7823,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 +7853,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,12 +7937,12 @@ 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, {
+    this.ws = new import_ws9.default(url, {
       headers: {
         Authorization: this.apiKey,
         "Content-Type": "application/json",
@@ -8682,7 +7952,7 @@ var AssemblyAISTT = class _AssemblyAISTT {
     await new Promise((resolve, reject) => {
       const timer = setTimeout(
         () => reject(new Error("AssemblyAI connect timeout")),
-        CONNECT_TIMEOUT_MS
+        CONNECT_TIMEOUT_MS2
       );
       this.ws.once("open", () => {
         clearTimeout(timer);
@@ -8742,11 +8012,11 @@ var AssemblyAISTT = class _AssemblyAISTT {
     }
   }
   sendAudio(audio) {
-    if (!this.ws || this.ws.readyState !== import_ws8.default.OPEN) return;
+    if (!this.ws || this.ws.readyState !== import_ws9.default.OPEN) return;
     this.ws.send(audio);
   }
   onTranscript(callback) {
-    if (this.callbacks.length >= MAX_CALLBACKS) {
+    if (this.callbacks.length >= MAX_CALLBACKS2) {
       getLogger().warn(
         "AssemblyAISTT: maximum of 10 onTranscript callbacks reached; replacing the last callback."
       );
@@ -8775,146 +8045,296 @@ function averageConfidence(words) {
   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");
+// 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);
   }
-  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}`;
+};
+
+// 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);
     }
-    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()}`;
+    return Buffer.concat(chunks);
   }
-  async connect() {
-    const url = this.buildWsUrl();
-    this.ws = new import_ws9.default(url, {
-      headers: { "User-Agent": USER_AGENT }
-    });
-    await new Promise((resolve, reject) => {
-      const timer = setTimeout(
-        () => reject(new Error("Cartesia STT connect timeout")),
-        CONNECT_TIMEOUT_MS2
-      );
-      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);
+  /**
+   * 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)
     });
-    this.keepaliveTimer = setInterval(() => {
-      if (this.ws && this.ws.readyState === import_ws9.default.OPEN) {
-        try {
-          this.ws.ping();
-        } catch {
+    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);
         }
       }
-    }, 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 });
-      return;
-    }
-    if (type === "error") {
-      getLogger().error(`Cartesia STT error: ${event.message ?? "unknown"}`);
-      return;
+    } finally {
+      if (typeof reader.cancel === "function") await reader.cancel().catch(() => {
+      });
+      reader.releaseLock();
     }
   }
-  emit(transcript) {
-    for (const cb of this.callbacks) {
-      cb(transcript);
+};
+
+// 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"
+    );
   }
-  sendAudio(audio) {
-    if (!this.ws || this.ws.readyState !== import_ws9.default.OPEN) return;
-    this.ws.send(audio);
+};
+
+// 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;
   }
-  onTranscript(callback) {
-    if (this.callbacks.length >= MAX_CALLBACKS2) {
-      getLogger().warn(
-        "CartesiaSTT: maximum of 10 onTranscript callbacks reached; replacing the last callback."
-      );
-      this.callbacks[this.callbacks.length - 1] = callback;
-      return;
+  /**
+   * 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);
     }
-    this.callbacks.push(callback);
+    return Buffer.concat(chunks);
   }
-  close() {
-    if (this.keepaliveTimer) {
-      clearInterval(this.keepaliveTimer);
-      this.keepaliveTimer = null;
+  /**
+   * 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 (this.ws) {
-      try {
-        this.ws.send("finalize");
-      } catch {
+    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.close();
-      this.ws = null;
+      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/index.ts
-init_elevenlabs_tts();
-init_openai_tts();
+// 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 +8434,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 +8576,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 +8669,734 @@ 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/llm/openai.ts
+init_llm_loop();
+var LLM = class extends OpenAILLMProvider {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.OPENAI_API_KEY;
+    if (!key) {
+      throw new Error(
+        "OpenAI LLM requires an apiKey. Pass { apiKey: 'sk-...' } or set OPENAI_API_KEY."
+      );
+    }
+    super(key, opts.model ?? "gpt-4o-mini");
+  }
+};
+
+// src/providers/anthropic-llm.ts
+init_logger();
+var DEFAULT_ANTHROPIC_URL = "https://api.anthropic.com/v1/messages";
+var DEFAULT_ANTHROPIC_VERSION = "2023-06-01";
+var DEFAULT_MODEL = "claude-3-5-sonnet-20241022";
+var DEFAULT_MAX_TOKENS = 1024;
+var AnthropicLLMProvider = class {
+  apiKey;
+  model;
+  maxTokens;
+  temperature;
+  url;
+  anthropicVersion;
+  constructor(options) {
+    if (!options.apiKey) {
+      throw new Error(
+        "Anthropic API key is required. Pass it via { apiKey } or set the ANTHROPIC_API_KEY environment variable before constructing the provider."
+      );
+    }
+    this.apiKey = options.apiKey;
+    this.model = options.model ?? DEFAULT_MODEL;
+    this.maxTokens = options.maxTokens ?? DEFAULT_MAX_TOKENS;
+    this.temperature = options.temperature;
+    this.url = options.baseUrl ?? DEFAULT_ANTHROPIC_URL;
+    this.anthropicVersion = options.anthropicVersion ?? DEFAULT_ANTHROPIC_VERSION;
+  }
+  async *stream(messages, tools) {
+    const { system, messages: anthropicMessages } = toAnthropicMessages(messages);
+    const anthropicTools = tools ? toAnthropicTools(tools) : null;
+    const body = {
+      model: this.model,
+      messages: anthropicMessages,
+      max_tokens: this.maxTokens,
+      stream: true
+    };
+    if (system) body.system = system;
+    if (anthropicTools && anthropicTools.length > 0) body.tools = anthropicTools;
+    if (this.temperature !== void 0) body.temperature = this.temperature;
+    const response = await fetch(this.url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": this.apiKey,
+        "anthropic-version": this.anthropicVersion
+      },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!response.ok) {
+      const errText = await response.text();
+      getLogger().error(`Anthropic API error: ${response.status} ${errText}`);
+      return;
+    }
+    const reader = response.body?.getReader();
+    if (!reader) return;
+    const decoder = new TextDecoder();
+    let buffer = "";
+    const toolIndexByBlock = /* @__PURE__ */ new Map();
+    const toolIdByBlock = /* @__PURE__ */ new Map();
+    let nextIndex = 0;
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() || "";
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("data: ")) continue;
+        const data = trimmed.slice(6);
+        if (!data || data === "[DONE]") continue;
+        let event;
+        try {
+          event = JSON.parse(data);
+        } catch {
+          continue;
+        }
+        if (event.type === "content_block_start" && event.content_block?.type === "tool_use") {
+          const blockIdx = event.index ?? 0;
+          const toolId = event.content_block.id ?? "";
+          const toolName = event.content_block.name ?? "";
+          const patterIndex = nextIndex++;
+          toolIndexByBlock.set(blockIdx, patterIndex);
+          toolIdByBlock.set(blockIdx, toolId);
+          yield {
+            type: "tool_call",
+            index: patterIndex,
+            id: toolId,
+            name: toolName,
+            arguments: ""
+          };
+          continue;
+        }
+        if (event.type === "content_block_delta") {
+          if (event.delta?.type === "text_delta" && event.delta.text) {
+            yield { type: "text", content: event.delta.text };
+            continue;
+          }
+          if (event.delta?.type === "input_json_delta" && event.delta.partial_json) {
+            const blockIdx = event.index ?? 0;
+            const patterIndex = toolIndexByBlock.get(blockIdx);
+            if (patterIndex !== void 0) {
+              yield {
+                type: "tool_call",
+                index: patterIndex,
+                id: toolIdByBlock.get(blockIdx),
+                arguments: event.delta.partial_json
+              };
+            }
+          }
+        }
+      }
+    }
+    yield { type: "done" };
+  }
+};
+function toAnthropicTools(tools) {
+  return tools.map((t) => {
+    const fn = t.function ?? t;
+    return {
+      name: String(fn.name ?? ""),
+      description: String(fn.description ?? ""),
+      input_schema: fn.parameters ?? { type: "object", properties: {} }
+    };
+  });
+}
+function toAnthropicMessages(messages) {
+  const systemParts = [];
+  const out = [];
+  for (const rawMsg of messages) {
+    const role = rawMsg.role;
+    if (role === "system") {
+      if (typeof rawMsg.content === "string" && rawMsg.content) {
+        systemParts.push(rawMsg.content);
+      }
+      continue;
+    }
+    if (role === "user") {
+      if (typeof rawMsg.content === "string") {
+        out.push({ role: "user", content: rawMsg.content });
+      } else if (rawMsg.content) {
+        out.push({ role: "user", content: rawMsg.content });
+      }
+      continue;
+    }
+    if (role === "assistant") {
+      const blocks = [];
+      if (typeof rawMsg.content === "string" && rawMsg.content) {
+        blocks.push({ type: "text", text: rawMsg.content });
+      }
+      for (const tc of rawMsg.tool_calls ?? []) {
+        let args = {};
+        try {
+          args = JSON.parse(tc.function?.arguments ?? "{}");
+        } catch {
+          args = {};
+        }
+        blocks.push({
+          type: "tool_use",
+          id: tc.id ?? "",
+          name: tc.function?.name ?? "",
+          input: args
+        });
+      }
+      if (blocks.length > 0) {
+        out.push({ role: "assistant", content: blocks });
+      }
+      continue;
+    }
+    if (role === "tool") {
+      const contentStr = typeof rawMsg.content === "string" ? rawMsg.content : JSON.stringify(rawMsg.content);
+      out.push({
+        role: "user",
+        content: [
+          {
+            type: "tool_result",
+            tool_use_id: rawMsg.tool_call_id ?? "",
+            content: contentStr
+          }
+        ]
+      });
+      continue;
+    }
+  }
+  return { system: systemParts.join("\n\n"), messages: out };
+}
+
+// src/llm/anthropic.ts
+var LLM2 = class extends AnthropicLLMProvider {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.ANTHROPIC_API_KEY;
+    if (!key) {
+      throw new Error(
+        "Anthropic LLM requires an apiKey. Pass { apiKey: 'sk-ant-...' } or set ANTHROPIC_API_KEY."
+      );
+    }
+    super({
+      apiKey: key,
+      model: opts.model,
+      maxTokens: opts.maxTokens,
+      temperature: opts.temperature,
+      baseUrl: opts.baseUrl,
+      anthropicVersion: opts.anthropicVersion
+    });
+  }
+};
+
+// src/providers/groq-llm.ts
+init_logger();
+var GROQ_BASE_URL = "https://api.groq.com/openai/v1";
+var DEFAULT_MODEL2 = "llama-3.3-70b-versatile";
+var GroqLLMProvider = class {
+  apiKey;
+  model;
+  baseUrl;
+  constructor(options) {
+    if (!options.apiKey) {
+      throw new Error(
+        "Groq API key is required. Pass it via { apiKey } or read GROQ_API_KEY from the environment."
+      );
+    }
+    this.apiKey = options.apiKey;
+    this.model = options.model ?? DEFAULT_MODEL2;
+    this.baseUrl = options.baseUrl ?? GROQ_BASE_URL;
+  }
+  async *stream(messages, tools) {
+    const body = {
+      model: this.model,
+      messages,
+      stream: true
+    };
+    if (tools) body.tools = tools;
+    const response = await fetch(`${this.baseUrl}/chat/completions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!response.ok) {
+      const errText = await response.text();
+      getLogger().error(`Groq API error: ${response.status} ${errText}`);
+      return;
+    }
+    yield* parseOpenAISseStream(response);
+  }
+};
+async function* parseOpenAISseStream(response) {
+  const reader = response.body?.getReader();
+  if (!reader) return;
+  const decoder = new TextDecoder();
+  let buffer = "";
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const lines = buffer.split("\n");
+    buffer = lines.pop() || "";
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed || !trimmed.startsWith("data: ")) continue;
+      const data = trimmed.slice(6);
+      if (data === "[DONE]") continue;
+      let chunk;
+      try {
+        chunk = JSON.parse(data);
+      } catch {
+        continue;
+      }
+      const delta = chunk.choices?.[0]?.delta;
+      if (!delta) continue;
+      if (delta.content) {
+        yield { type: "text", content: delta.content };
+      }
+      if (delta.tool_calls) {
+        for (const tc of delta.tool_calls) {
+          yield {
+            type: "tool_call",
+            index: tc.index,
+            id: tc.id,
+            name: tc.function?.name,
+            arguments: tc.function?.arguments
+          };
+        }
+      }
+    }
+  }
+}
+
+// src/llm/groq.ts
+var LLM3 = class extends GroqLLMProvider {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.GROQ_API_KEY;
+    if (!key) {
+      throw new Error(
+        "Groq LLM requires an apiKey. Pass { apiKey: 'gsk_...' } or set GROQ_API_KEY."
+      );
+    }
+    super({
+      apiKey: key,
+      model: opts.model,
+      baseUrl: opts.baseUrl
+    });
+  }
+};
+
+// src/providers/cerebras-llm.ts
+init_logger();
+var CEREBRAS_BASE_URL = "https://api.cerebras.ai/v1";
+var DEFAULT_MODEL3 = "llama3.1-8b";
+var CerebrasLLMProvider = class {
+  apiKey;
+  model;
+  baseUrl;
+  gzipCompression;
+  constructor(options) {
+    if (!options.apiKey) {
+      throw new Error(
+        "Cerebras API key is required. Pass it via { apiKey } or read CEREBRAS_API_KEY from the environment."
+      );
+    }
+    this.apiKey = options.apiKey;
+    this.model = options.model ?? DEFAULT_MODEL3;
+    this.baseUrl = options.baseUrl ?? CEREBRAS_BASE_URL;
+    this.gzipCompression = options.gzipCompression ?? false;
+  }
+  async *stream(messages, tools) {
+    const body = {
+      model: this.model,
+      messages,
+      stream: true
+    };
+    if (tools) body.tools = tools;
+    const headers = {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${this.apiKey}`
+    };
+    let payload = JSON.stringify(body);
+    if (this.gzipCompression) {
+      const compressed = await gzipEncode(payload);
+      if (compressed) {
+        payload = compressed;
+        headers["Content-Encoding"] = "gzip";
+      }
+    }
+    const response = await fetch(`${this.baseUrl}/chat/completions`, {
+      method: "POST",
+      headers,
+      body: payload,
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!response.ok) {
+      const errText = await response.text();
+      getLogger().error(`Cerebras API error: ${response.status} ${errText}`);
+      return;
+    }
+    yield* parseOpenAISseStream(response);
+  }
+};
+async function gzipEncode(data) {
+  const CompressionCtor = globalThis.CompressionStream;
+  if (!CompressionCtor) return null;
+  const stream = new CompressionCtor("gzip");
+  const writer = stream.writable.getWriter();
+  const encoder = new TextEncoder();
+  await writer.write(encoder.encode(data));
+  await writer.close();
+  const chunks = [];
+  const reader = stream.readable.getReader();
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    if (value) chunks.push(value);
+  }
+  const total = chunks.reduce((n, c) => n + c.length, 0);
+  const out = new Uint8Array(total);
+  let offset = 0;
+  for (const c of chunks) {
+    out.set(c, offset);
+    offset += c.length;
+  }
+  return out;
+}
+
+// src/llm/cerebras.ts
+var LLM4 = class extends CerebrasLLMProvider {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.CEREBRAS_API_KEY;
+    if (!key) {
+      throw new Error(
+        "Cerebras LLM requires an apiKey. Pass { apiKey: 'csk-...' } or set CEREBRAS_API_KEY."
+      );
+    }
+    super({
+      apiKey: key,
+      model: opts.model,
+      baseUrl: opts.baseUrl,
+      gzipCompression: opts.gzipCompression
+    });
+  }
+};
+
+// src/providers/google-llm.ts
+init_logger();
+var DEFAULT_MODEL4 = "gemini-2.5-flash";
+var DEFAULT_BASE_URL3 = "https://generativelanguage.googleapis.com/v1beta";
+var GoogleLLMProvider = class {
+  apiKey;
+  model;
+  baseUrl;
+  temperature;
+  maxOutputTokens;
+  constructor(options) {
+    if (!options.apiKey) {
+      throw new Error(
+        "Google API key is required. Pass it via { apiKey } or read GOOGLE_API_KEY from the environment."
+      );
+    }
+    this.apiKey = options.apiKey;
+    this.model = options.model ?? DEFAULT_MODEL4;
+    this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL3;
+    this.temperature = options.temperature;
+    this.maxOutputTokens = options.maxOutputTokens;
+  }
+  async *stream(messages, tools) {
+    const { systemInstruction, contents } = toGeminiContents(messages);
+    const geminiTools = tools ? toGeminiTools(tools) : null;
+    const body = { contents };
+    if (systemInstruction) {
+      body.systemInstruction = { role: "system", parts: [{ text: systemInstruction }] };
+    }
+    if (geminiTools) body.tools = geminiTools;
+    const generationConfig = {};
+    if (this.temperature !== void 0) generationConfig.temperature = this.temperature;
+    if (this.maxOutputTokens !== void 0)
+      generationConfig.maxOutputTokens = this.maxOutputTokens;
+    if (Object.keys(generationConfig).length > 0) body.generationConfig = generationConfig;
+    const url = `${this.baseUrl}/models/${encodeURIComponent(this.model)}:streamGenerateContent?alt=sse&key=${encodeURIComponent(this.apiKey)}`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!response.ok) {
+      const errText = await response.text();
+      getLogger().error(`Gemini API error: ${response.status} ${errText}`);
+      return;
+    }
+    const reader = response.body?.getReader();
+    if (!reader) return;
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let nextIndex = 0;
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() || "";
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("data: ")) continue;
+        const data = trimmed.slice(6);
+        if (!data) continue;
+        let payload;
+        try {
+          payload = JSON.parse(data);
+        } catch {
+          continue;
+        }
+        const candidate = payload.candidates?.[0];
+        const parts = candidate?.content?.parts ?? [];
+        for (const part of parts) {
+          if (part.functionCall) {
+            const args = part.functionCall.args ?? {};
+            const callId = part.functionCall.id ?? `gemini_call_${nextIndex}`;
+            yield {
+              type: "tool_call",
+              index: nextIndex,
+              id: callId,
+              name: part.functionCall.name ?? "",
+              arguments: JSON.stringify(args)
+            };
+            nextIndex++;
+            continue;
+          }
+          if (part.text) {
+            yield { type: "text", content: part.text };
+          }
+        }
+      }
+    }
+    yield { type: "done" };
+  }
+};
+function toGeminiTools(tools) {
+  const functionDeclarations = tools.map((t) => {
+    const fn = t.function ?? t;
+    return {
+      name: String(fn.name ?? ""),
+      description: String(fn.description ?? ""),
+      parameters: fn.parameters ?? { type: "object", properties: {} }
+    };
+  });
+  if (functionDeclarations.length === 0) return [];
+  return [{ functionDeclarations }];
+}
+function toGeminiContents(messages) {
+  const systemParts = [];
+  const contents = [];
+  for (const rawMsg of messages) {
+    const role = rawMsg.role;
+    if (role === "system") {
+      if (typeof rawMsg.content === "string" && rawMsg.content) {
+        systemParts.push(rawMsg.content);
+      }
+      continue;
+    }
+    if (role === "user") {
+      if (typeof rawMsg.content === "string" && rawMsg.content) {
+        contents.push({ role: "user", parts: [{ text: rawMsg.content }] });
+      }
+      continue;
+    }
+    if (role === "assistant") {
+      const parts = [];
+      if (typeof rawMsg.content === "string" && rawMsg.content) {
+        parts.push({ text: rawMsg.content });
+      }
+      for (const tc of rawMsg.tool_calls ?? []) {
+        let args = {};
+        try {
+          const parsed = JSON.parse(tc.function?.arguments ?? "{}");
+          if (parsed && typeof parsed === "object") args = parsed;
+        } catch {
+          args = {};
+        }
+        parts.push({
+          functionCall: {
+            name: tc.function?.name ?? "",
+            args,
+            id: tc.id
+          }
+        });
+      }
+      if (parts.length > 0) contents.push({ role: "model", parts });
+      continue;
+    }
+    if (role === "tool") {
+      const raw = rawMsg.content;
+      let response;
+      if (typeof raw === "string") {
+        try {
+          const parsed = JSON.parse(raw);
+          response = parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : { result: parsed };
+        } catch {
+          response = { result: raw };
+        }
+      } else {
+        response = raw ?? {};
+      }
+      contents.push({
+        role: "user",
+        parts: [
+          {
+            functionResponse: {
+              name: rawMsg.name ?? rawMsg.tool_call_id ?? "",
+              response,
+              id: rawMsg.tool_call_id
+            }
+          }
+        ]
+      });
+      continue;
+    }
+  }
+  return { systemInstruction: systemParts.join("\n\n"), contents };
+}
+
+// src/llm/google.ts
+var LLM5 = class extends GoogleLLMProvider {
+  constructor(opts = {}) {
+    const key = opts.apiKey ?? process.env.GEMINI_API_KEY ?? process.env.GOOGLE_API_KEY;
+    if (!key) {
+      throw new Error(
+        "Google LLM requires an apiKey. Pass { apiKey: 'AIza...' } or set GEMINI_API_KEY (or GOOGLE_API_KEY)."
+      );
+    }
+    super({
+      apiKey: key,
+      model: opts.model,
+      baseUrl: opts.baseUrl,
+      temperature: opts.temperature,
+      maxOutputTokens: opts.maxOutputTokens
+    });
+  }
+};
+
+// 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();
@@ -9835,6 +10013,7 @@ function isAudioConfig(value) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AllProvidersFailedError,
+  AnthropicLLM,
   AssemblyAISTT,
   AuthenticationError,
   BackgroundAudioPlayer,
@@ -9842,22 +10021,30 @@ function isAudioConfig(value) {
   CallMetricsAccumulator,
   CartesiaSTT,
   CartesiaTTS,
+  CerebrasLLM,
   ChatContext,
+  CloudflareTunnel,
   DEFAULT_MIN_SENTENCE_LEN,
   DEFAULT_PRICING,
   DTMF_EVENTS,
   DeepgramSTT,
+  ElevenLabsConvAI,
   ElevenLabsConvAIAdapter,
   ElevenLabsTTS,
   FallbackLLMProvider,
   GEMINI_DEFAULT_INPUT_SR,
   GEMINI_DEFAULT_OUTPUT_SR,
   GeminiLiveAdapter,
+  GoogleLLM,
+  GroqLLM,
+  Guardrail,
   IVRActivity,
   LLMLoop,
   LMNTTTS,
   MetricsStore,
+  OpenAILLM,
   OpenAILLMProvider,
+  OpenAIRealtime,
   OpenAIRealtimeAdapter,
   OpenAITTS,
   PartialStreamError,
@@ -9870,8 +10057,12 @@ function isAudioConfig(value) {
   RimeTTS,
   SentenceChunker,
   SonioxSTT,
+  StaticTunnel,
+  Telnyx,
   TestSession,
   TfidfLoopDetector,
+  Tool,
+  Twilio,
   ULTRAVOX_DEFAULT_API_BASE,
   ULTRAVOX_DEFAULT_SR,
   UltravoxRealtimeAdapter,
@@ -9891,6 +10082,7 @@ function isAudioConfig(value) {
   filterMarkdown,
   formatDtmf,
   getLogger,
+  guardrail,
   isRemoteUrl,
   isWebSocketUrl,
   makeAuthMiddleware,
@@ -9912,5 +10104,6 @@ function isAudioConfig(value) {
   selectSoundFromList,
   setLogger,
   startTunnel,
+  tool,
   whisper
 });