@absolutejs/voice 0.0.22-beta.563 → 0.0.22-beta.564

package/dist/core/types.d.ts

@@ -913,6 +913,20 @@ export type CreateVoiceSessionOptions<TContext = unknown, TSession extends Voice
      * Set `fillerPhrases: []` (or omit) to disable. Reasonable defaults if
      * you enable: `["Hmm.", "Got it.", "Right.", "Mm-hm.", "Let me think.", "Okay."]`.
      */
+    /**
+     * Minimum word count in an STT partial transcript before speech-gated
+     * barge-in cancels the in-flight assistant TTS. Default 1 (any non-empty
+     * partial triggers barge-in — backwards-compatible).
+     *
+     * Set to 2 (or higher) on phone routes where the caller's brief
+     * acknowledgements ("yeah", "uh-huh", "you", "am i") would otherwise
+     * cut the bot off mid-question. Each extra word added typically delays
+     * barge-in by ~100-200ms (one extra STT partial cycle) — cheap compared
+     * to losing the bot's response.
+     *
+     * Word splitting is whitespace-based. Punctuation is left attached.
+     */
+    bargeInMinPartialWords?: number;
     fillerPhrases?: ReadonlyArray<string>;
     /** Milliseconds after turn-commit before the filler fires. Default 250ms — short enough to feel instant, long enough to skip if the LLM is very fast. */
     fillerDelayMs?: number;

package/dist/index.js

@@ -3875,6 +3875,7 @@ var createVoiceSession = (options) => {
   let fillerToken = 0;
   const fillerPhrases = (options.fillerPhrases ?? []).filter((p) => typeof p === "string" && p.trim().length > 0);
   const fillerDelayMs = options.fillerDelayMs ?? 250;
+  const bargeInMinPartialWords = Math.max(1, options.bargeInMinPartialWords ?? 1);
   const fillerFor = options.fillerFor;
   const fillerForTimeoutMs = options.fillerForTimeoutMs ?? 600;
   const currentTurnAudio = [];
@@ -4924,17 +4925,33 @@ var createVoiceSession = (options) => {
     };
   };
   const handlePartial = async (transcript) => {
-    if (activeTTSTurnId !== undefined && transcript.text.trim()) {
+    if (activeTTSTurnId !== undefined) {
       const triggeringText = transcript.text.trim();
-      appendTurnLatencyStage({
-        metadata: {
-          partial: triggeringText.slice(0, 200),
-          source: "stt_partial"
-        },
-        stage: "barge_in",
-        turnId: activeTTSTurnId
-      }).catch(() => {});
-      cancelActiveTTS("barge-in");
+      if (triggeringText) {
+        const wordCount = triggeringText.split(/\s+/).length;
+        if (wordCount >= bargeInMinPartialWords) {
+          appendTurnLatencyStage({
+            metadata: {
+              partial: triggeringText.slice(0, 200),
+              source: "stt_partial",
+              wordCount
+            },
+            stage: "barge_in",
+            turnId: activeTTSTurnId
+          }).catch(() => {});
+          cancelActiveTTS("barge-in");
+        } else {
+          appendTurnLatencyStage({
+            metadata: {
+              partial: triggeringText.slice(0, 200),
+              reason: "below_min_words",
+              wordCount
+            },
+            stage: "barge_in_suppressed",
+            turnId: activeTTSTurnId
+          }).catch(() => {});
+        }
+      }
     }
     const session = await writeSession((session2) => {
       const nextPartialStartedAt = transcript.startedAtMs ?? session2.currentTurn.partialStartedAt;
@@ -24765,6 +24782,7 @@ var createTwilioMediaStreamBridge = (socket, options) => {
       ...options.semanticTurnDetector ? { semanticTurnDetector: options.semanticTurnDetector } : {},
       ...options.fillerPhrases ? { fillerPhrases: options.fillerPhrases } : {},
       ...options.fillerDelayMs !== undefined ? { fillerDelayMs: options.fillerDelayMs } : {},
+      ...options.bargeInMinPartialWords !== undefined ? { bargeInMinPartialWords: options.bargeInMinPartialWords } : {},
       ...options.fillerFor ? { fillerFor: options.fillerFor } : {},
       ...options.fillerForTimeoutMs !== undefined ? { fillerForTimeoutMs: options.fillerForTimeoutMs } : {},
       ...options.defaultSilentTurnAck !== undefined ? { defaultSilentTurnAck: options.defaultSilentTurnAck } : {},

package/dist/telephony/twilio.d.ts

@@ -132,6 +132,14 @@ export type TwilioMediaStreamBridgeOptions<TContext = unknown, TSession extends
     fillerPhrases?: ReadonlyArray<string>;
     /** Milliseconds after turn-commit before the filler fires. Default 250ms. */
     fillerDelayMs?: number;
+    /**
+     * Minimum word count in an STT partial transcript before barge-in
+     * cancels in-flight assistant TTS. Default 1 (any partial).
+     * Recommended 2 on phone routes — single-word partials ("you", "am i")
+     * cut the bot off mid-question per live-test 2026-05-27. See
+     * CreateVoiceSessionOptions for full semantics.
+     */
+    bargeInMinPartialWords?: number;
     /**
      * Content-aware filler (Latency Theater). Called in parallel with the
      * main LLM turn; if it resolves within `fillerForTimeoutMs` the runtime

package/dist/testing/index.js

@@ -5746,6 +5746,7 @@ var createVoiceSession = (options) => {
   let fillerToken = 0;
   const fillerPhrases = (options.fillerPhrases ?? []).filter((p) => typeof p === "string" && p.trim().length > 0);
   const fillerDelayMs = options.fillerDelayMs ?? 250;
+  const bargeInMinPartialWords = Math.max(1, options.bargeInMinPartialWords ?? 1);
   const fillerFor = options.fillerFor;
   const fillerForTimeoutMs = options.fillerForTimeoutMs ?? 600;
   const currentTurnAudio = [];
@@ -6795,17 +6796,33 @@ var createVoiceSession = (options) => {
     };
   };
   const handlePartial = async (transcript) => {
-    if (activeTTSTurnId !== undefined && transcript.text.trim()) {
+    if (activeTTSTurnId !== undefined) {
       const triggeringText = transcript.text.trim();
-      appendTurnLatencyStage({
-        metadata: {
-          partial: triggeringText.slice(0, 200),
-          source: "stt_partial"
-        },
-        stage: "barge_in",
-        turnId: activeTTSTurnId
-      }).catch(() => {});
-      cancelActiveTTS("barge-in");
+      if (triggeringText) {
+        const wordCount = triggeringText.split(/\s+/).length;
+        if (wordCount >= bargeInMinPartialWords) {
+          appendTurnLatencyStage({
+            metadata: {
+              partial: triggeringText.slice(0, 200),
+              source: "stt_partial",
+              wordCount
+            },
+            stage: "barge_in",
+            turnId: activeTTSTurnId
+          }).catch(() => {});
+          cancelActiveTTS("barge-in");
+        } else {
+          appendTurnLatencyStage({
+            metadata: {
+              partial: triggeringText.slice(0, 200),
+              reason: "below_min_words",
+              wordCount
+            },
+            stage: "barge_in_suppressed",
+            turnId: activeTTSTurnId
+          }).catch(() => {});
+        }
+      }
     }
     const session = await writeSession((session2) => {
       const nextPartialStartedAt = transcript.startedAtMs ?? session2.currentTurn.partialStartedAt;
@@ -13355,6 +13372,7 @@ var createTwilioMediaStreamBridge = (socket, options) => {
       ...options.semanticTurnDetector ? { semanticTurnDetector: options.semanticTurnDetector } : {},
       ...options.fillerPhrases ? { fillerPhrases: options.fillerPhrases } : {},
       ...options.fillerDelayMs !== undefined ? { fillerDelayMs: options.fillerDelayMs } : {},
+      ...options.bargeInMinPartialWords !== undefined ? { bargeInMinPartialWords: options.bargeInMinPartialWords } : {},
       ...options.fillerFor ? { fillerFor: options.fillerFor } : {},
       ...options.fillerForTimeoutMs !== undefined ? { fillerForTimeoutMs: options.fillerForTimeoutMs } : {},
       ...options.defaultSilentTurnAck !== undefined ? { defaultSilentTurnAck: options.defaultSilentTurnAck } : {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/voice",
-  "version": "0.0.22-beta.563",
+  "version": "0.0.22-beta.564",
   "description": "Voice primitives and Elysia plugin for AbsoluteJS",
   "repository": {
     "type": "git",