felona-voice 0.1.0

package/dist/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkB3C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC5B,SAAS,CAAS;IAClB,OAAO,CAAU;IACjB,GAAG,CAAc;IACjB,GAAG,CAAc;IACjB,GAAG,CAAc;IACjB,GAAG,CAAe;IAClB,GAAG,CAAY;IACf,MAAM,CAAqB;IAC3B,KAAK,CAAe;IACpB,MAAM,CAAa;IACnB,KAAK,CAAa;IAClB,YAAY,CAAS;IAE9B,SAAS,GAAqB,IAAI,CAAC;IACnC,UAAU,GAAG,KAAK,CAAC,CAAC,mCAAmC;IACvD,YAAY,GAAG,KAAK,CAAC,CAAC,0CAA0C;IAChE,iBAAiB,GAAG,EAAE,CAAC;IACvB,SAAS,GAAqB,EAAE,CAAC;IAEzC,4CAA4C;IACpC,WAAW,GAAkD,IAAI,CAAC;IAE1E,YAAY,OAcX;QACC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,gCAAgC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAE1E,oBAAoB;QACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;YACrC,cAAc,EAAE,IAAI;YACpB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QAEH,qBAAqB;QACrB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE;YACjC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,eAAe;QACf,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE7C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAAiB;QAC5B,+CAA+C;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAE1C,wEAAwE;QACxE,IAAI,SAAS,CAAC,KAAK,EAAE,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAChE,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;QAED,2DAA2D;QAC3D,IAAI,SAAS,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACzC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAED,sEAAsE;QACtE,IAAI,SAAS,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACjE,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,eAAe;QACf,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YACxB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE;gBACP,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC9B,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;oBACxC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM;oBACjF,CAAC,CAAC,CAAC;gBACL,YAAY,EAAE,CAAC,EAAE,mBAAmB;gBACpC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;oBACtC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM;oBAClF,CAAC,CAAC,CAAC;aACN;SACF,CAAC,CAAC;QAEH,mBAAmB;QACnB,MAAM,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;QAE9B,eAAe;QACf,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEnE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,gCAAgC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,MAIvB;QACC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,+BAA+B;YAC/B,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;YAC5E,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;gBACtB,IAAI,EAAE,IAAI,CAAC,iBAAiB;gBAC5B,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,sCAAsC;YACtC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;gBACtB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,sBAAsB;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,qBAAqB;QAE5C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;QAE5B,IAAI,CAAC;YACH,0BAA0B;YAC1B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;gBAClB,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,QAAQ;gBACjB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE;aAC3D,CAAC,CAAC;YAEH,eAAe;YACf,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAEvD,qCAAqC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CACtC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,YAAY,EACjB,QAAQ,CACT,CAAC;YAEF,2CAA2C;YAC3C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7C,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAEnD,mBAAmB;YACnB,MAAM,WAAW,GAAmB;gBAClC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE;gBAC1D,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBACtC,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;gBAC/B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACxC,SAAS,EAAE,YAAY;aACxB,CAAC;YACF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YAErC,eAAe;YACf,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAE7E,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,MAAM,EACN,kBAAkB,KAAK,CAAC,MAAM,CAAC,EAAE,kBAAkB,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CACzH,CAAC;YAEF,4EAA4E;YAC5E,MAAM,aAAa,GAAG;gBACpB,YAAY,EAAE,OAAO;gBACrB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC;YAEF,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAE/D,2BAA2B;YAC3B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;gBAClB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,YAAY;gBACrB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE;gBAC1D,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;gBACzB,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAC;YAEH,eAAe;YACf,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAE5D,2BAA2B;YAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,mBAAmB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,KAAK,CAAC,IAAY;QAC9B,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QAE9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QAEjC,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpD,6CAA6C;gBAC7C,IAAI,CAAC,IAAI,CAAC,UAAU;oBAAE,MAAM;gBAE5B,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,OAAO,EACP,cAAc,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACvE,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,aAAa;QACnB,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QAE7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,2CAA2C,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,iCAAiC;IACjC,IAAI,KAAK;QACP,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAC5B,OAAuD;IAEvD,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/stt/deepgram.d.ts

@@ -0,0 +1,27 @@
+import type { STTProvider, STTStream, STTStreamOptions } from "../types.js";
+/**
+ * DeepgramSTT — Streaming Speech-to-Text using Deepgram's WebSocket API.
+ *
+ * Deepgram is the default STT provider because:
+ * - Sub-300ms latency for streaming recognition
+ * - Excellent accuracy with Nova-2 model
+ * - Native WebSocket API (no HTTP polling)
+ * - Supports interim results for real-time feedback
+ */
+export declare class DeepgramSTT implements STTProvider {
+    readonly name = "deepgram";
+    private readonly apiKey;
+    private readonly model;
+    private readonly baseUrl;
+    constructor(options: {
+        apiKey: string;
+        model?: string;
+        baseUrl?: string;
+    });
+    createStream(options?: STTStreamOptions): STTStream;
+}
+export declare function createDeepgramSTT(options: {
+    apiKey: string;
+    model?: string;
+}): DeepgramSTT;
+//# sourceMappingURL=deepgram.d.ts.map

package/dist/stt/deepgram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepgram.d.ts","sourceRoot":"","sources":["../../src/stt/deepgram.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,gBAAgB,EAGjB,MAAM,aAAa,CAAC;AAErB;;;;;;;;GAQG;AACH,qBAAa,WAAY,YAAW,WAAW;IAC7C,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAOD,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS;CAUpD;AAkID,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,WAAW,CAEd"}

package/dist/stt/deepgram.js

@@ -0,0 +1,137 @@
+import { WebSocket } from "ws";
+import { EventEmitter } from "node:events";
+/**
+ * DeepgramSTT — Streaming Speech-to-Text using Deepgram's WebSocket API.
+ *
+ * Deepgram is the default STT provider because:
+ * - Sub-300ms latency for streaming recognition
+ * - Excellent accuracy with Nova-2 model
+ * - Native WebSocket API (no HTTP polling)
+ * - Supports interim results for real-time feedback
+ */
+export class DeepgramSTT {
+    name = "deepgram";
+    apiKey;
+    model;
+    baseUrl;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.model = options.model ?? "nova-2";
+        this.baseUrl =
+            options.baseUrl ?? "wss://api.deepgram.com/v1/listen";
+    }
+    createStream(options) {
+        return new DeepgramSTTStream({
+            apiKey: this.apiKey,
+            model: this.model,
+            baseUrl: this.baseUrl,
+            language: options?.language ?? "en-US",
+            interimResults: options?.interimResults ?? true,
+            keywords: options?.keywords,
+        });
+    }
+}
+class DeepgramSTTStream extends EventEmitter {
+    ws = null;
+    resultHandler = null;
+    config;
+    connected = false;
+    connectPromise = null;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.connectPromise = this.connect();
+    }
+    async connect() {
+        const params = new URLSearchParams({
+            model: this.config.model,
+            language: this.config.language,
+            interim_results: String(this.config.interimResults),
+            punctuate: "true",
+            encoding: "linear16",
+            sample_rate: "16000",
+            channels: "1",
+        });
+        if (this.config.keywords?.length) {
+            for (const kw of this.config.keywords) {
+                params.append("keywords", kw);
+            }
+        }
+        const url = `${this.config.baseUrl}?${params.toString()}`;
+        return new Promise((resolve, reject) => {
+            this.ws = new WebSocket(url, {
+                headers: {
+                    Authorization: `Token ${this.config.apiKey}`,
+                },
+            });
+            this.ws.on("open", () => {
+                this.connected = true;
+                resolve();
+            });
+            this.ws.on("message", (data) => {
+                try {
+                    const response = JSON.parse(data.toString());
+                    this.handleResponse(response);
+                }
+                catch {
+                    // Ignore non-JSON messages
+                }
+            });
+            this.ws.on("error", (error) => {
+                console.error("[STT/Deepgram] WebSocket error:", error.message);
+                if (!this.connected) {
+                    reject(error);
+                }
+            });
+            this.ws.on("close", () => {
+                this.connected = false;
+            });
+        });
+    }
+    write(chunk) {
+        if (this.ws && this.connected && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(chunk.data);
+        }
+    }
+    onResult(handler) {
+        this.resultHandler = handler;
+    }
+    async close() {
+        if (this.ws) {
+            // Send close message per Deepgram protocol
+            if (this.ws.readyState === WebSocket.OPEN) {
+                this.ws.send(JSON.stringify({ type: "CloseStream" }));
+            }
+            this.ws.close();
+            this.ws = null;
+        }
+        this.connected = false;
+    }
+    handleResponse(response) {
+        // Deepgram response format
+        if (response.type === "Results") {
+            const channel = response.channel;
+            if (!channel?.alternatives?.length)
+                return;
+            const alt = channel.alternatives[0];
+            const result = {
+                text: alt.transcript ?? "",
+                isFinal: response.is_final ?? false,
+                confidence: alt.confidence ?? 0,
+                words: alt.words?.map((w) => ({
+                    word: w.word,
+                    startMs: Math.round(w.start * 1000),
+                    endMs: Math.round(w.end * 1000),
+                })),
+            };
+            // Only emit non-empty results
+            if (result.text.trim()) {
+                this.resultHandler?.(result);
+            }
+        }
+    }
+}
+export function createDeepgramSTT(options) {
+    return new DeepgramSTT(options);
+}
+//# sourceMappingURL=deepgram.js.map

package/dist/stt/deepgram.js.map

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

package/dist/stt/index.d.ts

@@ -0,0 +1,2 @@
+export { DeepgramSTT, createDeepgramSTT } from "./deepgram.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/stt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/stt/index.js

@@ -0,0 +1,2 @@
+export { DeepgramSTT, createDeepgramSTT } from "./deepgram.js";
+//# sourceMappingURL=index.js.map

package/dist/stt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+export { ToolRegistry, defineTool, createToolRegistry } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,2 @@
+export { ToolRegistry, defineTool, createToolRegistry } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,38 @@
+import type { AgentTool, ToolExecutor } from "../types.js";
+/**
+ * ToolRegistry — Manages tool registration and execution.
+ *
+ * Tools are external capabilities the agent can invoke during a call
+ * (e.g., booking appointments, looking up orders, transferring calls).
+ */
+export declare class ToolRegistry implements ToolExecutor {
+    private tools;
+    /** Register a tool */
+    register(tool: AgentTool): void;
+    /** Register multiple tools at once */
+    registerAll(tools: AgentTool[]): void;
+    /** Call a registered tool by name */
+    call(toolName: string, params?: Record<string, unknown>): Promise<unknown>;
+    /** List all registered tools */
+    list(): AgentTool[];
+    /** Check if a tool is registered */
+    has(toolName: string): boolean;
+    /** Get a tool's schema (for LLM function calling) */
+    getSchema(toolName: string): {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    } | undefined;
+    /** Get all tool schemas (for LLM function calling) */
+    getAllSchemas(): Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }>;
+}
+/**
+ * Helper to define a tool with type safety.
+ */
+export declare function defineTool(tool: AgentTool): AgentTool;
+export declare function createToolRegistry(tools?: AgentTool[]): ToolRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3D;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,OAAO,CAAC,KAAK,CAAqC;IAElD,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAO/B,sCAAsC;IACtC,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI;IAMrC,qCAAqC;IAC/B,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC;IAkBnB,gCAAgC;IAChC,IAAI,IAAI,SAAS,EAAE;IAInB,oCAAoC;IACpC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B,qDAAqD;IACrD,SAAS,CACP,QAAQ,EAAE,MAAM,GACf;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,SAAS;IAUzF,sDAAsD;IACtD,aAAa,IAAI,KAAK,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CAOH;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAErD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,GAAG,YAAY,CAMpE"}

package/dist/tools/registry.js

@@ -0,0 +1,77 @@
+/**
+ * ToolRegistry — Manages tool registration and execution.
+ *
+ * Tools are external capabilities the agent can invoke during a call
+ * (e.g., booking appointments, looking up orders, transferring calls).
+ */
+export class ToolRegistry {
+    tools = new Map();
+    /** Register a tool */
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool "${tool.name}" is already registered`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    /** Register multiple tools at once */
+    registerAll(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+    }
+    /** Call a registered tool by name */
+    async call(toolName, params) {
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            throw new Error(`Tool "${toolName}" not found. Available: ${[...this.tools.keys()].join(", ")}`);
+        }
+        try {
+            const result = await tool.execute(params ?? {});
+            return result;
+        }
+        catch (error) {
+            throw new Error(`Tool "${toolName}" execution failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /** List all registered tools */
+    list() {
+        return [...this.tools.values()];
+    }
+    /** Check if a tool is registered */
+    has(toolName) {
+        return this.tools.has(toolName);
+    }
+    /** Get a tool's schema (for LLM function calling) */
+    getSchema(toolName) {
+        const tool = this.tools.get(toolName);
+        if (!tool)
+            return undefined;
+        return {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        };
+    }
+    /** Get all tool schemas (for LLM function calling) */
+    getAllSchemas() {
+        return this.list().map((t) => ({
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters,
+        }));
+    }
+}
+/**
+ * Helper to define a tool with type safety.
+ */
+export function defineTool(tool) {
+    return tool;
+}
+export function createToolRegistry(tools) {
+    const registry = new ToolRegistry();
+    if (tools) {
+        registry.registerAll(tools);
+    }
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAA2B,IAAI,GAAG,EAAE,CAAC;IAElD,sBAAsB;IACtB,QAAQ,CAAC,IAAe;QACtB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,yBAAyB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,sCAAsC;IACtC,WAAW,CAAC,KAAkB;QAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,IAAI,CACR,QAAgB,EAChB,MAAgC;QAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,2BAA2B,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACjG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,oCAAoC;IACpC,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,qDAAqD;IACrD,SAAS,CACP,QAAgB;QAEhB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;IAED,sDAAsD;IACtD,aAAa;QAKX,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/transport/index.d.ts

@@ -0,0 +1,2 @@
+export { WebSocketTransport, createWebSocketTransport } from "./websocket.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,2 @@
+export { WebSocketTransport, createWebSocketTransport } from "./websocket.js";
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/transport/websocket.d.ts

@@ -0,0 +1,38 @@
+import { EventEmitter } from "node:events";
+import type { Transport, TransportOptions, AudioChunk, Session } from "../types.js";
+/**
+ * WebSocketTransport — Handles real-time audio streaming over WebSocket.
+ *
+ * Protocol:
+ * - Client connects to ws://host:port
+ * - Binary frames = raw PCM audio data
+ * - JSON text frames = control messages (metadata, config, etc.)
+ *
+ * This is the default transport for Phase 1. WebRTC transport
+ * will be added in Phase 3 for lower-latency applications.
+ */
+export declare class WebSocketTransport extends EventEmitter implements Transport {
+    private wss;
+    private sessions;
+    private audioHandler;
+    private connectHandler;
+    private disconnectHandler;
+    start(options: TransportOptions): Promise<void>;
+    stop(): Promise<void>;
+    onAudioChunk(handler: (sessionId: string, chunk: AudioChunk) => void): void;
+    onConnect(handler: (session: Session) => void): void;
+    onDisconnect(handler: (session: Session) => void): void;
+    sendAudio(sessionId: string, chunk: AudioChunk): Promise<void>;
+    /**
+     * Send a JSON control message to a session.
+     */
+    sendMessage(sessionId: string, message: Record<string, unknown>): Promise<void>;
+    /** Get active session count */
+    get activeSessionCount(): number;
+    /** Get a session by ID */
+    getSession(sessionId: string): Session | undefined;
+    private handleConnection;
+    private handleControlMessage;
+}
+export declare function createWebSocketTransport(): WebSocketTransport;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/transport/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/transport/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,OAAO,EAER,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,SAAS;IACvE,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,QAAQ,CACJ;IACZ,OAAO,CAAC,YAAY,CAEJ;IAChB,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,iBAAiB,CAA6C;IAEhE,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB3B,YAAY,CACV,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,GACtD,IAAI;IAIP,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAIpD,YAAY,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAIjD,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE;;OAEG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAShB,+BAA+B;IAC/B,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,0BAA0B;IAC1B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIlD,OAAO,CAAC,gBAAgB;IAkExB,OAAO,CAAC,oBAAoB;CAwB7B;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}

package/dist/transport/websocket.js

@@ -0,0 +1,180 @@
+import { EventEmitter } from "node:events";
+import { randomUUID } from "node:crypto";
+import { WebSocketServer, WebSocket } from "ws";
+/**
+ * WebSocketTransport — Handles real-time audio streaming over WebSocket.
+ *
+ * Protocol:
+ * - Client connects to ws://host:port
+ * - Binary frames = raw PCM audio data
+ * - JSON text frames = control messages (metadata, config, etc.)
+ *
+ * This is the default transport for Phase 1. WebRTC transport
+ * will be added in Phase 3 for lower-latency applications.
+ */
+export class WebSocketTransport extends EventEmitter {
+    wss = null;
+    sessions = new Map();
+    audioHandler = null;
+    connectHandler = null;
+    disconnectHandler = null;
+    async start(options) {
+        return new Promise((resolve, reject) => {
+            try {
+                this.wss = new WebSocketServer({
+                    port: options.port,
+                    host: options.host ?? "0.0.0.0",
+                });
+                this.wss.on("connection", (ws, req) => {
+                    this.handleConnection(ws, req);
+                });
+                this.wss.on("listening", () => {
+                    console.log(`[Transport] WebSocket server listening on ${options.host ?? "0.0.0.0"}:${options.port}`);
+                    resolve();
+                });
+                this.wss.on("error", (error) => {
+                    reject(error);
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    async stop() {
+        // Close all active sessions
+        for (const [sessionId, { ws, session }] of this.sessions) {
+            session.state = "ended";
+            ws.close();
+            this.disconnectHandler?.(session);
+        }
+        this.sessions.clear();
+        // Shut down the server
+        return new Promise((resolve) => {
+            if (this.wss) {
+                this.wss.close(() => {
+                    console.log("[Transport] WebSocket server stopped");
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    onAudioChunk(handler) {
+        this.audioHandler = handler;
+    }
+    onConnect(handler) {
+        this.connectHandler = handler;
+    }
+    onDisconnect(handler) {
+        this.disconnectHandler = handler;
+    }
+    async sendAudio(sessionId, chunk) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry) {
+            throw new Error(`Session "${sessionId}" not found`);
+        }
+        if (entry.ws.readyState === WebSocket.OPEN) {
+            entry.ws.send(chunk.data);
+        }
+    }
+    /**
+     * Send a JSON control message to a session.
+     */
+    async sendMessage(sessionId, message) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry)
+            return;
+        if (entry.ws.readyState === WebSocket.OPEN) {
+            entry.ws.send(JSON.stringify(message));
+        }
+    }
+    /** Get active session count */
+    get activeSessionCount() {
+        return this.sessions.size;
+    }
+    /** Get a session by ID */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId)?.session;
+    }
+    handleConnection(ws, req) {
+        const sessionId = randomUUID();
+        const session = {
+            id: sessionId,
+            startedAt: new Date(),
+            metadata: {
+                remoteAddress: req.socket.remoteAddress,
+                headers: req.headers,
+            },
+            state: "active",
+        };
+        this.sessions.set(sessionId, { ws, session });
+        console.log(`[Transport] New session: ${sessionId}`);
+        // Notify connection handler
+        this.connectHandler?.(session);
+        // Send session info to the client
+        ws.send(JSON.stringify({
+            type: "session.created",
+            sessionId,
+            timestamp: Date.now(),
+        }));
+        const sessionStartTime = Date.now();
+        ws.on("message", (data, isBinary) => {
+            if (isBinary) {
+                // Binary = audio data
+                const chunk = {
+                    data: Buffer.from(data),
+                    sampleRate: 16000,
+                    channels: 1,
+                    bitDepth: 16,
+                    timestampMs: Date.now() - sessionStartTime,
+                };
+                this.audioHandler?.(sessionId, chunk);
+            }
+            else {
+                // Text = control message
+                try {
+                    const message = JSON.parse(data.toString());
+                    this.handleControlMessage(sessionId, message);
+                }
+                catch {
+                    console.warn(`[Transport] Invalid control message from ${sessionId}`);
+                }
+            }
+        });
+        ws.on("close", () => {
+            console.log(`[Transport] Session ended: ${sessionId}`);
+            session.state = "ended";
+            this.disconnectHandler?.(session);
+            this.sessions.delete(sessionId);
+        });
+        ws.on("error", (error) => {
+            console.error(`[Transport] Session error (${sessionId}):`, error.message);
+        });
+    }
+    handleControlMessage(sessionId, message) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry)
+            return;
+        switch (message.type) {
+            case "session.update":
+                // Client can update session metadata
+                if (message.metadata && typeof message.metadata === "object") {
+                    Object.assign(entry.session.metadata, message.metadata);
+                }
+                break;
+            case "audio.config":
+                // Client specifying audio format (future: handle format conversion)
+                this.emit("audioConfig", sessionId, message);
+                break;
+            default:
+                this.emit("controlMessage", sessionId, message);
+        }
+    }
+}
+export function createWebSocketTransport() {
+    return new WebSocketTransport();
+}
+//# sourceMappingURL=websocket.js.map

package/dist/transport/websocket.js.map

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

package/dist/tts/eleven-labs.d.ts

@@ -0,0 +1,27 @@
+import type { TTSProvider, TTSOptions, AudioChunk } from "../types.js";
+/**
+ * ElevenLabsTTS — Streaming Text-to-Speech using ElevenLabs' API.
+ *
+ * Uses the streaming endpoint for chunk-by-chunk audio delivery,
+ * so the agent can start speaking before the full response is generated.
+ */
+export declare class ElevenLabsTTS implements TTSProvider {
+    readonly name = "elevenlabs";
+    private readonly apiKey;
+    private readonly defaultVoice;
+    private readonly baseUrl;
+    private readonly modelId;
+    constructor(options: {
+        apiKey: string;
+        voice?: string;
+        modelId?: string;
+        baseUrl?: string;
+    });
+    synthesize(text: string, options?: TTSOptions): AsyncIterable<AudioChunk>;
+}
+export declare function createElevenLabsTTS(options: {
+    apiKey: string;
+    voice?: string;
+    modelId?: string;
+}): ElevenLabsTTS;
+//# sourceMappingURL=eleven-labs.d.ts.map

package/dist/tts/eleven-labs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eleven-labs.d.ts","sourceRoot":"","sources":["../../src/tts/eleven-labs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvE;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAOM,UAAU,CACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,UAAU,GACnB,aAAa,CAAC,UAAU,CAAC;CA6D7B;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,aAAa,CAEhB"}