realtime-voice-agents 2.0.1 → 2.2.0

package/dist/xai.d.cts

@@ -1,4 +1,4 @@
-import { c as VadConfig, i as ProviderSessionInit, n as ProviderFactory } from "./BaseRealtimeProvider-BehPNT1r.cjs";
+import { i as ProviderSessionInit, l as VadConfig, n as ProviderFactory } from "./BaseRealtimeProvider-BL75_HHh.cjs";
 //#region src/xai.d.ts
 declare const XAI_BASE_URL = "wss://api.x.ai/v1/realtime";
 /** Env vars checked (in order) when no explicit apiKey is passed. */
@@ -29,7 +29,12 @@ declare function buildXaiSessionUpdate(init: ProviderSessionInit, config?: {
   defaultVoice?: string;
   extraSessionOptions?: Record<string, unknown>;
 }): Record<string, unknown>;
-/** Create an xAI Grok Voice provider factory for the bridge. */
+/**
+ * Create an xAI Grok Voice provider factory for the bridge. Credentials are
+ * resolved per call (see `openaiRealtime` — a missing key fails that call's
+ * connect so a fallback chain can absorb it, instead of crashing config
+ * construction).
+ */
 declare function xaiRealtime(options?: XaiRealtimeOptions): ProviderFactory;
 //#endregion
 export { XAI_BASE_URL, XAI_DEFAULT_MODEL, XAI_DEFAULT_VOICE, XAI_KEY_ENV_VARS, XaiRealtimeOptions, buildXaiSessionUpdate, xaiRealtime };

package/dist/xai.d.mts

@@ -1,4 +1,4 @@
-import { c as VadConfig, i as ProviderSessionInit, n as ProviderFactory } from "./BaseRealtimeProvider-ClP8Wx1X.mjs";
+import { i as ProviderSessionInit, l as VadConfig, n as ProviderFactory } from "./BaseRealtimeProvider-CWJ81HIt.mjs";
 //#region src/xai.d.ts
 declare const XAI_BASE_URL = "wss://api.x.ai/v1/realtime";
 /** Env vars checked (in order) when no explicit apiKey is passed. */
@@ -29,7 +29,12 @@ declare function buildXaiSessionUpdate(init: ProviderSessionInit, config?: {
   defaultVoice?: string;
   extraSessionOptions?: Record<string, unknown>;
 }): Record<string, unknown>;
-/** Create an xAI Grok Voice provider factory for the bridge. */
+/**
+ * Create an xAI Grok Voice provider factory for the bridge. Credentials are
+ * resolved per call (see `openaiRealtime` — a missing key fails that call's
+ * connect so a fallback chain can absorb it, instead of crashing config
+ * construction).
+ */
 declare function xaiRealtime(options?: XaiRealtimeOptions): ProviderFactory;
 //#endregion
 export { XAI_BASE_URL, XAI_DEFAULT_MODEL, XAI_DEFAULT_VOICE, XAI_KEY_ENV_VARS, XaiRealtimeOptions, buildXaiSessionUpdate, xaiRealtime };

package/dist/xai.mjs

@@ -1,7 +1,7 @@
-import { n as deepMerge } from "./BaseRealtimeProvider-BQigr5mB.mjs";
-import { n as buildTurnDetection } from "./session-config-BVLl7-ha.mjs";
+import { n as deepMerge } from "./BaseRealtimeProvider-C9C3s8jx.mjs";
+import { n as buildTurnDetection } from "./session-config-CbifLlkV.mjs";
 import { t as resolveApiKey } from "./env-DUwUWTsg.mjs";
-import { t as OpenAICompatibleProvider } from "./OpenAICompatibleProvider-Bdtl-UXH.mjs";
+import { t as OpenAICompatibleProvider } from "./OpenAICompatibleProvider-D-2OOVBU.mjs";
 //#region src/xai.ts
 /**
 * xAI Grok Voice Agent provider — `realtime-voice-agents/xai`.
@@ -58,13 +58,15 @@ function buildXaiSessionUpdate(init, config = {}) {
 		session
 	};
 }
-/** Create an xAI Grok Voice provider factory for the bridge. */
+/**
+* Create an xAI Grok Voice provider factory for the bridge. Credentials are
+* resolved per call (see `openaiRealtime` — a missing key fails that call's
+* connect so a fallback chain can absorb it, instead of crashing config
+* construction).
+*/
 function xaiRealtime(options = {}) {
-	const apiKey = resolveApiKey(options.apiKey, XAI_KEY_ENV_VARS);
-	if (!apiKey) throw new Error(`xaiRealtime: apiKey missing (pass apiKey or set one of ${XAI_KEY_ENV_VARS.join("/")})`);
 	const transcription = options.transcription === false ? false : options.transcription ? { language: options.transcription.languageHint } : void 0;
 	const config = {
-		apiKey,
 		model: options.model ?? "grok-voice-latest",
 		voice: options.voice ?? "eve",
 		baseUrl: options.baseUrl ?? "wss://api.x.ai/v1/realtime",
@@ -77,10 +79,22 @@ function xaiRealtime(options = {}) {
 		buildSession: buildXaiSessionUpdate,
 		capabilityOverrides: {
 			truncate: false,
-			vadInterruptControl: false
+			vadInterruptControl: false,
+			vadTuning: {
+				defaultServerThreshold: .85,
+				minServerThreshold: .1,
+				maxServerThreshold: .9
+			}
 		}
 	};
-	return ({ logger }) => new OpenAICompatibleProvider(config, logger);
+	return ({ logger }) => {
+		const apiKey = resolveApiKey(options.apiKey, XAI_KEY_ENV_VARS);
+		if (!apiKey) throw new Error(`xaiRealtime: apiKey missing (pass apiKey or set one of ${XAI_KEY_ENV_VARS.join("/")})`);
+		return new OpenAICompatibleProvider({
+			...config,
+			apiKey
+		}, logger);
+	};
 }
 //#endregion
 export { XAI_BASE_URL, XAI_DEFAULT_MODEL, XAI_DEFAULT_VOICE, XAI_KEY_ENV_VARS, buildXaiSessionUpdate, xaiRealtime };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "realtime-voice-agents",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "description": "Provider-agnostic bridge between Twilio Media Streams and realtime speech-to-speech AI APIs (OpenAI Realtime, xAI Grok Voice, Gemini Live). Multi-agent handoffs, Zod tools with execution strategies, mark-based playback tracking, interruption guards, and hold audio — for Node.js voice agents over the phone.",
   "keywords": [
     "twilio",