@lumavox/client 0.10.0 → 0.11.0

package/dist/hands-free.d.ts

@@ -13,10 +13,14 @@
  * - **Barge-in in two steps** (D15): talking while the agent's voice plays
  *   lowers it (`AgentAudio.duck`) and opens the recording; the edge says
  *   `barge_in` on its first words that are not the agent's own, and the
- *   voice stops. No words within `wordsWithinMs` and it was not the person:
- *   the recording is thrown away (`discardAudio`), the voice comes back up,
- *   and the detector must hear silence before it opens another — so the
- *   agent's own leftover voice, or a long cough, never loops.
+ *   voice stops. **Over the agent, only words end an utterance, never
+ *   silence**: the transcriber's first words come about 2 s after the first
+ *   word (`wordsWithinMs`), and a short "Stop." is heard only while audio
+ *   still reaches it — ended at 700 ms of silence, it never was. No words
+ *   within `wordsWithinMs` and it was not the person: the recording is
+ *   thrown away (`discardAudio`), the voice comes back up, and the detector
+ *   must hear silence before it opens another — so the agent's own leftover
+ *   voice, or a long cough, never loops.
  * - **The detector's threshold rises while the agent speaks**: what echo
  *   cancellation leaves of its voice is louder than a quiet room.
  * - **Refused where the agent would hear itself** (D16): an adapter that
@@ -75,9 +79,11 @@ export interface ListenOptions extends TurnOptions {
     startAfterMs?: number;
     /**
      * Over the agent's voice: no words this long into the talking, and it
-     * was not the person, ms: 1,200 — the plan's ~0.7 s and the partial
-     * transcripts' lag behind speech (left-overs #101), until a device
-     * measures it.
+     * was not the person, ms: 3,000. On staging (2026-10-31, speech paced in
+     * real time) the first words came 2.06 to 2.46 s after the first word
+     * spoken — the transcriber's session opening with the recording — and
+     * 1.47 s on one already open; the plan's ~0.7 s would have thrown every
+     * barge-in away.
      */
     wordsWithinMs?: number;
     /** The app knows the agent's voice stays out of the microphone — headphones, say — though the adapter cannot tell. */

package/dist/hands-free.js

@@ -87,7 +87,7 @@ class HandsFree {
         this.detector = options.detector ?? loudness();
         this.endAfterMs = options.endAfterMs ?? 700;
         this.startAfterMs = options.startAfterMs ?? 100;
-        this.wordsWithinMs = options.wordsWithinMs ?? 1200;
+        this.wordsWithinMs = options.wordsWithinMs ?? 3000;
         this.ringFrames = Math.ceil(((options.preRollMs ?? 300) + this.startAfterMs) / FRAME_MS);
     }
     /** The microphone, and everything watched: `null`, or why it did not open. */
@@ -153,6 +153,9 @@ class HandsFree {
         this.audio.stop();
         this.audio.duck?.(false);
         this.options.onBargeIn?.(frame);
+        // The words came after the person stopped: the turn is theirs now.
+        if (this.quietMs >= this.endAfterMs)
+            this.end();
     }
     /** The device took the audio, and closed the recorder; or gave it back. */
     interrupted(now) {
@@ -215,9 +218,11 @@ class HandsFree {
         }
         this.conversation.sendAudio(frame);
         open.ms += FRAME_MS;
-        if (open.barging && !open.barged && open.ms >= this.wordsWithinMs) {
-            this.throwAway();
-            this.waitForQuiet = true;
+        if (open.barging && !open.barged) {
+            if (open.ms >= this.wordsWithinMs) {
+                this.throwAway();
+                this.waitForQuiet = this.quietMs < this.endAfterMs;
+            }
         }
         else if (this.quietMs >= this.endAfterMs) {
             this.end();
@@ -241,13 +246,9 @@ class HandsFree {
             this.conversation.sendAudio(frame);
         this.set("hearing");
     }
-    /** Silence: a turn — but over the agent, only once the person's own words were heard. */
+    /** Silence after the person's words: a turn. */
     end() {
         const open = this.open;
-        if (open.barging && !open.barged) {
-            this.throwAway();
-            return;
-        }
         this.open = null;
         if (open.barging)
             this.audio.duck?.(false);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumavox/client",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Talk to Lumavox agents from a browser, a React Native app or Node, with an end user's ephemeral key: conversations on the agent's socket, sessions, memory and relations. Zero dependencies.",
   "license": "MIT",
   "type": "module",