@delofarag/ai-utils 1.7.2 → 1.8.1

package/dist/modalities/speech/tts/tts.d.ts

@@ -1,115 +0,0 @@
-import { LLMInstance } from "../../openrouter";
-import { OpenRouterTTSVoice, TTSResponseFormat } from "./helpers";
-type TTSOptions = {
-    llm?: LLMInstance;
-    text: string;
-    model: OpenRouterTTSVoice;
-    responseFormat?: TTSResponseFormat;
-    speed?: number;
-};
-type TTSPhoneSocketStreamOptions = TTSOptions & {
-    chunkSizeBytes?: number;
-    emitBase64?: boolean;
-    onChunk: (chunk: Uint8Array | string, index: number) => Promise<void> | void;
-};
-/**
- * Converts text to speech via OpenRouter's dedicated `/audio/speech` endpoint.
- *
- * Internally this function calls OpenRouter directly and returns raw audio bytes.
- * If no `llm` is provided, it creates one with
- * `getLLM({ provider: "openrouter", type: "tts" })` and reads
- * `process.env.OPENROUTER_API_KEY`.
- *
- * Make sure `OPENROUTER_API_KEY` is set in your `.env`.
- *
- * @param params.llm Optional LLM instance from `getLLM(...)`.
- * @param params.text Text that should be synthesized to audio.
- * @param params.model Voice identifier to use for speech generation.
- * @param params.responseFormat Audio response format (`mp3` or `pcm`).
- * @param params.speed Playback speed multiplier (default `1.0`).
- * @returns Promise with `audioBytes` and optional response metadata headers.
- *
- * @example
- * CONFIG:
- * ```ts
- * tts({
- *     llm = getLLM({ provider: "openrouter", type: "tts" }),
- *     responseFormat = "mp3",
- *     speed = 1.0,
- *     text,
- *     model
- * })
- * ```
- *
- * @example
- * ```ts
- * const speech = await tts({
- *     text: "Hallo! Das ist ein Test.",
- *     model: "nova",
- *     responseFormat: "mp3"
- * });
- *
- * console.log(speech.audioBytes.length);
- * ```
- */
-export declare function tts({ llm, responseFormat, speed, text, model }: TTSOptions): Promise<{
-    audioBytes: Uint8Array;
-    contentType?: string;
-    generationId?: string;
-}>;
-/**
- * Streams synthesized TTS audio as sequential chunks for phone socket pipelines
- * (for example Twilio/Telnyx websocket media send loops).
- *
- * Internally this helper calls `tts()` once and splits the returned audio into
- * chunked payloads that can be forwarded to a live call socket.
- *
- * @param params.llm Optional LLM instance from `getLLM(...)`.
- * @param params.text Text that should be synthesized to audio.
- * @param params.model Voice identifier for speech generation.
- * @param params.responseFormat Audio response format (`mp3` or `pcm`).
- * @param params.speed Playback speed multiplier.
- * @param params.chunkSizeBytes Size of each emitted audio chunk.
- * @param params.emitBase64 If true, emits base64 chunks; otherwise emits `Uint8Array`.
- * @param params.onChunk Callback that receives each emitted chunk in order.
- * @returns Promise with total emitted chunks and response metadata.
- *
- * @example
- * CONFIG:
- * ```ts
- * streamTTSOverPhoneSocket({
- *     llm = getLLM({ provider: "openrouter", type: "tts" }),
-       speed = 1.0,
-       chunkSizeBytes = 3200,
-       emitBase64 = true,
-       responseFormat = "mp3",
-       text,
-       model,
-       onChunk
- * })
- * ```
- *
- * @example
- * ```ts
- * await streamTTSOverPhoneSocket({
-    model,
-    onChunk
- * })
- * ```
- *
- * @example
- * ```ts
- * await streamTTSOverPhoneSocket({
- *     text: "Willkommen beim Support.",
- *     model: "nova",
- *     onChunk: async (chunk) => socket.send(String(chunk))
- * });
- * ```
- */
-export declare function streamTTSOverPhoneSocket({ llm, speed, chunkSizeBytes, emitBase64, responseFormat, text, model, onChunk }: TTSPhoneSocketStreamOptions): Promise<{
-    totalChunks: number;
-    contentType?: string;
-    generationId?: string;
-}>;
-export {};
-//# sourceMappingURL=tts.d.ts.map

package/dist/modalities/speech/tts/tts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../../../../src/modalities/speech/tts/tts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAwB,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAoB,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAEnF,KAAK,UAAU,GAAG;IACd,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,kBAAkB,CAAA;IACzB,cAAc,CAAC,EAAE,iBAAiB,CAAA;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,KAAK,2BAA2B,GAAG,UAAU,GAAG;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC/E,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,GAAG,CAAC,EACtB,GAAqD,EACrD,cAAsB,EACtB,KAAW,EACX,IAAI,EACJ,KAAK,EACR,EAAE,UAAU,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B/F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAsB,wBAAwB,CAAC,EAC3C,GAAqD,EACrD,KAAW,EACX,cAAqB,EACrB,UAAiB,EACjB,cAAsB,EACtB,IAAI,EACJ,KAAK,EACL,OAAO,EACV,EAAE,2BAA2B,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB7G"}

package/dist/modalities/speech/tts/tts.js

@@ -1,142 +0,0 @@
-import { getLLM } from "../../../helpers/llms";
-import { getOpenRouterRuntime } from "../../openrouter";
-import { createTTSPayload } from "./helpers";
-/**
- * Converts text to speech via OpenRouter's dedicated `/audio/speech` endpoint.
- *
- * Internally this function calls OpenRouter directly and returns raw audio bytes.
- * If no `llm` is provided, it creates one with
- * `getLLM({ provider: "openrouter", type: "tts" })` and reads
- * `process.env.OPENROUTER_API_KEY`.
- *
- * Make sure `OPENROUTER_API_KEY` is set in your `.env`.
- *
- * @param params.llm Optional LLM instance from `getLLM(...)`.
- * @param params.text Text that should be synthesized to audio.
- * @param params.model Voice identifier to use for speech generation.
- * @param params.responseFormat Audio response format (`mp3` or `pcm`).
- * @param params.speed Playback speed multiplier (default `1.0`).
- * @returns Promise with `audioBytes` and optional response metadata headers.
- *
- * @example
- * CONFIG:
- * ```ts
- * tts({
- *     llm = getLLM({ provider: "openrouter", type: "tts" }),
- *     responseFormat = "mp3",
- *     speed = 1.0,
- *     text,
- *     model
- * })
- * ```
- *
- * @example
- * ```ts
- * const speech = await tts({
- *     text: "Hallo! Das ist ein Test.",
- *     model: "nova",
- *     responseFormat: "mp3"
- * });
- *
- * console.log(speech.audioBytes.length);
- * ```
- */
-export async function tts({ llm = getLLM({ provider: "openrouter", type: "tts" }), responseFormat = "mp3", speed = 1.0, text, model }) {
-    const runtime = getOpenRouterRuntime(llm);
-    const payload = createTTSPayload({
-        model: runtime.model,
-        input: text,
-        voice: model,
-        response_format: responseFormat,
-        speed
-    });
-    const response = await fetch(`${runtime.baseURL}/audio/speech`, {
-        method: "POST",
-        headers: {
-            Authorization: `Bearer ${runtime.apiKey}`,
-            "Content-Type": "application/json"
-        },
-        body: JSON.stringify(payload)
-    });
-    if (!response.ok) {
-        const errorText = await response.text();
-        throw new Error(`OpenRouter TTS failed (${response.status}): ${errorText}`);
-    }
-    const audioBuffer = await response.arrayBuffer();
-    return {
-        audioBytes: new Uint8Array(audioBuffer),
-        contentType: response.headers.get("content-type") ?? undefined,
-        generationId: response.headers.get("x-generation-id") ?? undefined
-    };
-}
-/**
- * Streams synthesized TTS audio as sequential chunks for phone socket pipelines
- * (for example Twilio/Telnyx websocket media send loops).
- *
- * Internally this helper calls `tts()` once and splits the returned audio into
- * chunked payloads that can be forwarded to a live call socket.
- *
- * @param params.llm Optional LLM instance from `getLLM(...)`.
- * @param params.text Text that should be synthesized to audio.
- * @param params.model Voice identifier for speech generation.
- * @param params.responseFormat Audio response format (`mp3` or `pcm`).
- * @param params.speed Playback speed multiplier.
- * @param params.chunkSizeBytes Size of each emitted audio chunk.
- * @param params.emitBase64 If true, emits base64 chunks; otherwise emits `Uint8Array`.
- * @param params.onChunk Callback that receives each emitted chunk in order.
- * @returns Promise with total emitted chunks and response metadata.
- *
- * @example
- * CONFIG:
- * ```ts
- * streamTTSOverPhoneSocket({
- *     llm = getLLM({ provider: "openrouter", type: "tts" }),
-       speed = 1.0,
-       chunkSizeBytes = 3200,
-       emitBase64 = true,
-       responseFormat = "mp3",
-       text,
-       model,
-       onChunk
- * })
- * ```
- *
- * @example
- * ```ts
- * await streamTTSOverPhoneSocket({
-    model,
-    onChunk
- * })
- * ```
- *
- * @example
- * ```ts
- * await streamTTSOverPhoneSocket({
- *     text: "Willkommen beim Support.",
- *     model: "nova",
- *     onChunk: async (chunk) => socket.send(String(chunk))
- * });
- * ```
- */
-export async function streamTTSOverPhoneSocket({ llm = getLLM({ provider: "openrouter", type: "tts" }), speed = 1.0, chunkSizeBytes = 3200, emitBase64 = true, responseFormat = "mp3", text, model, onChunk }) {
-    const result = await tts({
-        llm,
-        text,
-        model,
-        responseFormat,
-        speed
-    });
-    let index = 0;
-    for (let offset = 0; offset < result.audioBytes.length; offset += chunkSizeBytes) {
-        const chunk = result.audioBytes.slice(offset, offset + chunkSizeBytes);
-        const outgoing = emitBase64 ? Buffer.from(chunk).toString("base64") : chunk;
-        await onChunk(outgoing, index);
-        index += 1;
-    }
-    return {
-        totalChunks: index,
-        contentType: result.contentType,
-        generationId: result.generationId
-    };
-}
-//# sourceMappingURL=tts.js.map

package/dist/modalities/speech/tts/tts.js.map

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