@voquill/voice-ai 0.3.6 → 0.3.10

package/dist/index.d.ts

@@ -13,4 +13,5 @@ export * from "./deepseek.utils";
 export * from "./gemini.utils";
 export * from "./cerebras.utils";
 export * from "./speaches.utils";
+export * from "./xai.utils";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -13,3 +13,4 @@ export * from "./deepseek.utils";
 export * from "./gemini.utils";
 export * from "./cerebras.utils";
 export * from "./speaches.utils";
+export * from "./xai.utils";

package/dist/xai.utils.d.ts

@@ -0,0 +1,28 @@
+export declare const XAI_TRANSCRIPTION_MODELS: readonly ["grok-stt"];
+export type XaiTranscriptionModel = (typeof XAI_TRANSCRIPTION_MODELS)[number];
+export declare const XAI_TTS_VOICES: readonly ["eve", "ara", "rex", "sal", "leo"];
+export type XaiTtsVoice = (typeof XAI_TTS_VOICES)[number];
+export type XaiTestIntegrationArgs = {
+    apiKey: string;
+};
+export declare const xaiTestIntegration: ({ apiKey, }: XaiTestIntegrationArgs) => Promise<boolean>;
+export type XaiTranscriptionArgs = {
+    apiKey: string;
+    model?: XaiTranscriptionModel;
+    blob: ArrayBuffer | Buffer;
+    ext: string;
+    language?: string;
+};
+export type XaiTranscribeAudioOutput = {
+    text: string;
+    wordsUsed: number;
+};
+export declare const xaiTranscribeAudio: ({ apiKey, model, blob, ext, language, }: XaiTranscriptionArgs) => Promise<XaiTranscribeAudioOutput>;
+export type XaiSpeakArgs = {
+    apiKey: string;
+    text: string;
+    voice?: XaiTtsVoice;
+    language?: string;
+};
+export declare const xaiGenerateSpeech: ({ apiKey, text, voice, language, }: XaiSpeakArgs) => Promise<ArrayBuffer>;
+//# sourceMappingURL=xai.utils.d.ts.map

package/dist/xai.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xai.utils.d.ts","sourceRoot":"","sources":["../src/xai.utils.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,wBAAwB,uBAAwB,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,eAAO,MAAM,cAAc,8CAA+C,CAAC;AAC3E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,aAEtC,sBAAsB,KAAG,OAAO,CAAC,OAAO,CAiB1C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,yCAMtC,oBAAoB,KAAG,OAAO,CAAC,wBAAwB,CAwCzD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,oCAKrC,YAAY,KAAG,OAAO,CAAC,WAAW,CAsBpC,CAAC"}

package/dist/xai.utils.js

@@ -0,0 +1,71 @@
+import { countWords, retry } from "@voquill/utilities";
+const XAI_BASE_URL = "https://api.x.ai/v1";
+export const XAI_TRANSCRIPTION_MODELS = ["grok-stt"];
+export const XAI_TTS_VOICES = ["eve", "ara", "rex", "sal", "leo"];
+export const xaiTestIntegration = async ({ apiKey, }) => {
+    const response = await fetch(`${XAI_BASE_URL}/models`, {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${apiKey.trim()}`,
+        },
+    });
+    if (!response.ok) {
+        const detail = await response.text().catch(() => "");
+        throw new Error(detail
+            ? `xAI responded ${response.status}: ${detail}`
+            : `xAI responded with status ${response.status}`);
+    }
+    return true;
+};
+export const xaiTranscribeAudio = async ({ apiKey, model = "grok-stt", blob, ext, language, }) => {
+    return retry({
+        retries: 3,
+        fn: async () => {
+            const formData = new FormData();
+            const bodyData = blob instanceof ArrayBuffer ? blob : blob.buffer;
+            const audioBlob = new Blob([bodyData], { type: `audio/${ext}` });
+            formData.append("file", audioBlob, `audio.${ext}`);
+            formData.append("model", model);
+            formData.append("format", "json");
+            if (language && language !== "auto") {
+                formData.append("language", language);
+            }
+            const response = await fetch(`${XAI_BASE_URL}/stt`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${apiKey.trim()}`,
+                },
+                body: formData,
+            });
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => "Unknown error");
+                throw new Error(`xAI STT request failed with status ${response.status}: ${errorText}`);
+            }
+            const data = (await response.json());
+            const transcript = data?.text;
+            if (!transcript) {
+                throw new Error("Transcription failed: No text in xAI STT response");
+            }
+            return { text: transcript, wordsUsed: countWords(transcript) };
+        },
+    });
+};
+export const xaiGenerateSpeech = async ({ apiKey, text, voice = "eve", language = "en", }) => {
+    const response = await fetch(`${XAI_BASE_URL}/tts`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey.trim()}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            text,
+            voice_id: voice,
+            language,
+        }),
+    });
+    if (!response.ok) {
+        const errorText = await response.text().catch(() => "Unknown error");
+        throw new Error(`xAI TTS request failed with status ${response.status}: ${errorText}`);
+    }
+    return response.arrayBuffer();
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voquill/voice-ai",
-  "version": "0.3.6",
+  "version": "0.3.10",
   "description": "Shared Groq voice transcription helpers",
   "repository": {
     "type": "git",
@@ -22,12 +22,12 @@
     "wavefile": "^11.0.0",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.25.2",
-    "@voquill/types": "0.3.6",
-    "@voquill/utilities": "0.3.6"
+    "@voquill/utilities": "0.3.10",
+    "@voquill/types": "0.3.10"
   },
   "devDependencies": {
     "typescript": "5.9.2",
-    "@voquill/typescript-config": "0.3.6"
+    "@voquill/typescript-config": "0.3.10"
   },
   "publishConfig": {
     "access": "public"