@livx.cc/agentx 0.96.17 → 0.96.18

package/dist/index.d.ts

@@ -1209,6 +1209,11 @@ declare class VoiceEngineOptions {
      *  as a barge and abort the fresh turn (live: mid-sentence self-interruption + steps=1→steps=0 double
      *  abort). Short enough that a genuine immediate barge ("no wait—") still lands right after. */
     bargeGraceMs: number;
+    /** Barge-in (talk over the assistant to interrupt). true = full-duplex (needs echo cancellation, or
+     *  the assistant's own TTS bleeds back and self-interrupts). false = HALF-DUPLEX: the engine is deaf
+     *  while audible (speaking + drain tail), so echo can never become a phantom turn — the right mode
+     *  when there's no AEC (e.g. the non-VPIO mic fallback) and no headphones. Cost: can't interrupt. */
+    bargeIn: boolean;
     /** Filler phrase spoken when holding for an incomplete utterance ('' disables). */
     holdFiller: string;
     /** Called when the engine holds an incomplete utterance (host can render a visual cue). */
@@ -1269,6 +1274,8 @@ declare class VoiceEngine {
     constructor(options?: Partial<VoiceEngineOptions>);
     start(): Promise<void>;
     get usingAec(): boolean;
+    /** Flip barge-in at runtime (e.g. the mic fell back to non-VPIO → go half-duplex so echo can't leak). */
+    setBargeIn(on: boolean): void;
     private idleWaiters;
     private setState;
     /** Resolve when the engine is no longer speaking (immediate if already idle). */

package/dist/index.js

@@ -5624,6 +5624,11 @@ var VoiceEngineOptions = class {
    *  as a barge and abort the fresh turn (live: mid-sentence self-interruption + steps=1→steps=0 double
    *  abort). Short enough that a genuine immediate barge ("no wait—") still lands right after. */
   bargeGraceMs = 600;
+  /** Barge-in (talk over the assistant to interrupt). true = full-duplex (needs echo cancellation, or
+   *  the assistant's own TTS bleeds back and self-interrupts). false = HALF-DUPLEX: the engine is deaf
+   *  while audible (speaking + drain tail), so echo can never become a phantom turn — the right mode
+   *  when there's no AEC (e.g. the non-VPIO mic fallback) and no headphones. Cost: can't interrupt. */
+  bargeIn = true;
   /** Filler phrase spoken when holding for an incomplete utterance ('' disables). */
   holdFiller = "";
   /** Called when the engine holds an incomplete utterance (host can render a visual cue). */
@@ -5717,6 +5722,10 @@ var VoiceEngine = class _VoiceEngine {
   get usingAec() {
     return this.stt.usingAec;
   }
+  /** Flip barge-in at runtime (e.g. the mic fell back to non-VPIO → go half-duplex so echo can't leak). */
+  setBargeIn(on) {
+    this.options.bargeIn = on;
+  }
   idleWaiters = [];
   setState(s) {
     if (this.state === s) return;
@@ -5868,6 +5877,7 @@ var VoiceEngine = class _VoiceEngine {
   }
   handlePartial(text) {
     if (this.speaking) {
+      if (!this.options.bargeIn) return;
       if (now() < this.bargeGraceUntil) {
         if (!this.echoActive() || (this.usingAec ? this.genuine(text) : this.novelWords(text).length >= 1)) this.options.onPartial(text);
         return;
@@ -5943,7 +5953,7 @@ var VoiceEngine = class _VoiceEngine {
       this.stt.reset();
       return;
     }
-    if (this.echoActive() && (this.usingAec ? !this.genuine(text) : this.novelWords(text).length < 2)) {
+    if (this.echoActive() && (!this.options.bargeIn || (this.usingAec ? !this.genuine(text) : this.novelWords(text).length < 2))) {
       this.stt.reset();
       return;
     }