@runtypelabs/voice 0.3.0 → 0.4.0

package/README.md

@@ -54,6 +54,11 @@ alongside `transcript`.
 Changing `clientToken` affects the next call without interrupting the current one.
 Startup and connection failures populate `error` and `status: 'error'`.
 
+GPT-Live requires the default full-duplex browser protocol. Set `fullDuplex: false`
+only for a client that cannot handle overlapping transcripts. GPT-Live does not
+resume shared text/voice sessions; a call with `sessionId` or `visitorToken`
+receives `VOICE_SHARED_SESSION_UNSUPPORTED`.
+
 ## Plain JavaScript
 
 ```ts
@@ -85,6 +90,10 @@ The adapter implements Persona 4.22's `VoiceProvider` API and delivers transcrip
 through `onTranscript`, avoiding duplicate text dispatches. Use it as the custom
 provider in the widget's `config`:
 
+Persona 4.22 cannot handle GPT-Live's overlapping transcripts. The adapter does
+not advertise full duplex, so it cannot connect to a GPT-Live agent. Use the
+plain `VoiceClient` or the React hook for GPT-Live calls.
+
 ```ts
 import { createPersonaVoiceProvider } from '@runtypelabs/voice/persona'
 
@@ -125,8 +134,8 @@ embed's wire byte-identical.
 `event` is a unified `artifact_start`, `artifact_delta`, `artifact_update`, or
 `artifact_complete` frame. A start opens a `streaming` record, deltas append to
 its `content`, an update carries the component payload, and a complete settles
-it. Artifacts of a turn the caller stopped or cancelled are dropped, the same
-suppression the transcript applies. Ending the call keeps completed artifacts
+it. Cancelling a turn drops its later artifacts. Playback-only Stop keeps
+artifact delivery active. Ending the call keeps completed artifacts
 and drops half-streamed ones. Artifacts are never spoken: file bodies arrive
 only through these frames.
 
@@ -136,15 +145,32 @@ widget through its `upsertArtifact` handle:
 
 ```ts
 import { bindVoiceArtifactsToPersona, createPersonaVoiceProvider } from '@runtypelabs/voice/persona'
+import { initAgentWidget } from '@runtypelabs/persona'
 
 const provider = createPersonaVoiceProvider({ agentId, clientToken, artifacts: true })
-const widget = initAgentWidget({ ...config, features: { artifacts: { enabled: true } } })
+const widget = initAgentWidget({
+  target: document.getElementById('chat')!,
+  config: {
+    ...config,
+    features: { artifacts: { enabled: true } },
+    voiceRecognition: {
+      enabled: true,
+      provider: { type: 'custom', custom: () => provider },
+    },
+  },
+})
 const release = bindVoiceArtifactsToPersona(provider, widget)
+
+function dispose() {
+  release()
+  widget.destroy()
+}
 ```
 
 The artifact id is the upsert id, so every frame updates the same record in
 place, and only the settled record writes a transcript block. The pane opens
 once on the first artifact; pass `{ showOnFirst: false }` to leave it closed.
+Call `dispose()` when the host removes the widget.
 Persona's `features.artifacts.enabled` must be on, because `showArtifacts()` is
 a no-op otherwise. Call the returned function to stop delivery; the adapter's
 `disconnect()` releases artifact callbacks along with the rest.

package/dist/index.cjs

@@ -35,13 +35,16 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     this.readOffset = 0
     this.buffered = 0
     this.waiting = true
-    // INVARIANT: Only report drained after end-of-stream, never during a jitter gap.
+    // INVARIANT: Pipeline replies need EOS; continuous sessions report queue drain without a provider turn boundary.
     this.eosSeen = false
+    this.continuous = false
     this.revision = 0
     this.port.onmessage = (e) => {
       const msg = e.data
       this.revision = msg.revision
-      if (msg.type === 'push') {
+      if (msg.type === 'continuous') {
+        this.continuous = msg.enabled
+      } else if (msg.type === 'push') {
         this.eosSeen = false
         this.chunks.push(msg.samples)
         this.buffered += msg.samples.length
@@ -81,7 +84,7 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     }
     if (this.buffered === 0) {
       this.waiting = true // mid-reply underrun: re-buffer silently
-      if (this.eosSeen) {
+      if (this.eosSeen || this.continuous) {
         this.eosSeen = false
         this.port.postMessage({ type: 'drained', revision: this.revision })
       }
@@ -125,6 +128,9 @@ async function createPcmPlayer(onDrained) {
       if (samples.length === 0) return;
       node.port.postMessage({ type: "push", samples, revision }, [samples.buffer]);
     },
+    setContinuousMode(enabled) {
+      node.port.postMessage({ type: "continuous", enabled, revision });
+    },
     endOfStream() {
       node.port.postMessage({ type: "eos", revision });
     },
@@ -251,6 +257,7 @@ var VoiceClient = class {
   committedAssistantTurnId = null;
   activeTurnId = null;
   suppressedArtifactTurnId = null;
+  fullDuplex = false;
   getSnapshot = () => this.snapshot;
   subscribe = (listener) => {
     this.listeners.add(listener);
@@ -301,10 +308,12 @@ var VoiceClient = class {
       if (visitorToken && !/^cvt_[A-Za-z0-9_-]+$/.test(visitorToken)) {
         throw new Error("Invalid voice visitor credential.");
       }
+      if (this.options.fullDuplex !== false)
+        url.searchParams.set("voiceCapabilities", "full-duplex-v1");
       url.hash = "";
-      const stream = await navigator.mediaDevices.getUserMedia({
+      const stream = await (this.options.audioSource?.() ?? navigator.mediaDevices.getUserMedia({
         audio: { sampleRate: CAPTURE_SAMPLE_RATE, channelCount: 1, echoCancellation: true }
-      });
+      }));
       if (generation !== this.generation) {
         stream.getTracks().forEach((track) => track.stop());
         return;
@@ -399,6 +408,7 @@ var VoiceClient = class {
     });
   }
   cleanup() {
+    this.fullDuplex = false;
     this.generation += 1;
     if (this.processor) this.processor.onaudioprocess = null;
     this.processor?.disconnect();
@@ -535,6 +545,8 @@ var VoiceClient = class {
     }
     switch (msg.type) {
       case "session_config": {
+        this.fullDuplex = msg.speechMode === "speech_to_speech";
+        if (this.fullDuplex) player.setContinuousMode?.(true);
         if (msg.interruptionMode === "none" || msg.interruptionMode === "cancel" || msg.interruptionMode === "barge-in") {
           this.update({ interruptionMode: msg.interruptionMode });
         }
@@ -550,6 +562,32 @@ var VoiceClient = class {
       case "artifact":
         this.applyArtifactMessage(msg);
         break;
+      case "transcript_update": {
+        if (typeof msg.text !== "string" || typeof msg.turnId !== "string" || msg.role !== "user" && msg.role !== "assistant")
+          break;
+        if (msg.role === "assistant" && this.awaitingClear) break;
+        const entries = [...this.snapshot.transcript];
+        const index = entries.findIndex(
+          (entry2) => entry2.turnId === msg.turnId && entry2.role === msg.role
+        );
+        const entry = {
+          role: msg.role,
+          content: msg.text,
+          turnId: msg.turnId,
+          isFinal: msg.final === true,
+          timestamp: index >= 0 ? entries[index].timestamp : Date.now()
+        };
+        if (index >= 0) entries[index] = entry;
+        else entries.push(entry);
+        this.update({ transcript: entries, interimTranscript: null });
+        break;
+      }
+      case "delegation_started":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("thinking");
+        break;
+      case "delegation_completed":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("listening");
+        break;
       case "transcript_interim":
         this.update({ interimTranscript: typeof msg.text === "string" ? msg.text || null : null });
         break;
@@ -659,14 +697,14 @@ var VoiceClient = class {
     const processor = context.createScriptProcessor(CAPTURE_BUFFER_SIZE, 1, 1);
     this.processor = processor;
     processor.onaudioprocess = (event) => {
-      if (generation !== this.generation || this.snapshot.isMuted) return;
+      if (generation !== this.generation || this.snapshot.isMuted && !this.fullDuplex) return;
       const input = event.inputBuffer.getChannelData(0);
       let sum = 0;
       for (const sample of input) sum += sample * sample;
-      this.update({ audioLevel: Math.sqrt(sum / input.length) });
+      this.update({ audioLevel: this.snapshot.isMuted ? 0 : Math.sqrt(sum / input.length) });
       if (socket.readyState !== WebSocket.OPEN) return;
       const pcm = new Int16Array(input.length);
-      if (this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
+      if (this.snapshot.isMuted || this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
         socket.send(pcm.buffer);
         return;
       }

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { V as VoiceClientOptions, a as VoiceSnapshot } from './types-DaXyPeiV.cjs';
-export { I as InterruptionMode, T as TranscriptEntry, b as VoiceArtifact, c as VoiceArtifactFile, d as VoiceMetrics, e as VoiceSession, f as VoiceStatus } from './types-DaXyPeiV.cjs';
+import { V as VoiceClientOptions, a as VoiceSnapshot } from './types-Dkh4LxEA.cjs';
+export { I as InterruptionMode, T as TranscriptEntry, b as VoiceArtifact, c as VoiceArtifactFile, d as VoiceMetrics, e as VoiceSession, f as VoiceStatus } from './types-Dkh4LxEA.cjs';
 
 /** Browser microphone and playback lifecycle for Runtype's voice WebSocket endpoint. */
 declare class VoiceClient {
@@ -29,6 +29,7 @@ declare class VoiceClient {
     private committedAssistantTurnId;
     private activeTurnId;
     private suppressedArtifactTurnId;
+    private fullDuplex;
     constructor(options: VoiceClientOptions);
     getSnapshot: () => VoiceSnapshot;
     subscribe: (listener: () => void) => (() => void);

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { V as VoiceClientOptions, a as VoiceSnapshot } from './types-DaXyPeiV.js';
-export { I as InterruptionMode, T as TranscriptEntry, b as VoiceArtifact, c as VoiceArtifactFile, d as VoiceMetrics, e as VoiceSession, f as VoiceStatus } from './types-DaXyPeiV.js';
+import { V as VoiceClientOptions, a as VoiceSnapshot } from './types-Dkh4LxEA.js';
+export { I as InterruptionMode, T as TranscriptEntry, b as VoiceArtifact, c as VoiceArtifactFile, d as VoiceMetrics, e as VoiceSession, f as VoiceStatus } from './types-Dkh4LxEA.js';
 
 /** Browser microphone and playback lifecycle for Runtype's voice WebSocket endpoint. */
 declare class VoiceClient {
@@ -29,6 +29,7 @@ declare class VoiceClient {
     private committedAssistantTurnId;
     private activeTurnId;
     private suppressedArtifactTurnId;
+    private fullDuplex;
     constructor(options: VoiceClientOptions);
     getSnapshot: () => VoiceSnapshot;
     subscribe: (listener: () => void) => (() => void);

package/dist/index.js

@@ -9,13 +9,16 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     this.readOffset = 0
     this.buffered = 0
     this.waiting = true
-    // INVARIANT: Only report drained after end-of-stream, never during a jitter gap.
+    // INVARIANT: Pipeline replies need EOS; continuous sessions report queue drain without a provider turn boundary.
     this.eosSeen = false
+    this.continuous = false
     this.revision = 0
     this.port.onmessage = (e) => {
       const msg = e.data
       this.revision = msg.revision
-      if (msg.type === 'push') {
+      if (msg.type === 'continuous') {
+        this.continuous = msg.enabled
+      } else if (msg.type === 'push') {
         this.eosSeen = false
         this.chunks.push(msg.samples)
         this.buffered += msg.samples.length
@@ -55,7 +58,7 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     }
     if (this.buffered === 0) {
       this.waiting = true // mid-reply underrun: re-buffer silently
-      if (this.eosSeen) {
+      if (this.eosSeen || this.continuous) {
         this.eosSeen = false
         this.port.postMessage({ type: 'drained', revision: this.revision })
       }
@@ -99,6 +102,9 @@ async function createPcmPlayer(onDrained) {
       if (samples.length === 0) return;
       node.port.postMessage({ type: "push", samples, revision }, [samples.buffer]);
     },
+    setContinuousMode(enabled) {
+      node.port.postMessage({ type: "continuous", enabled, revision });
+    },
     endOfStream() {
       node.port.postMessage({ type: "eos", revision });
     },
@@ -225,6 +231,7 @@ var VoiceClient = class {
   committedAssistantTurnId = null;
   activeTurnId = null;
   suppressedArtifactTurnId = null;
+  fullDuplex = false;
   getSnapshot = () => this.snapshot;
   subscribe = (listener) => {
     this.listeners.add(listener);
@@ -275,10 +282,12 @@ var VoiceClient = class {
       if (visitorToken && !/^cvt_[A-Za-z0-9_-]+$/.test(visitorToken)) {
         throw new Error("Invalid voice visitor credential.");
       }
+      if (this.options.fullDuplex !== false)
+        url.searchParams.set("voiceCapabilities", "full-duplex-v1");
       url.hash = "";
-      const stream = await navigator.mediaDevices.getUserMedia({
+      const stream = await (this.options.audioSource?.() ?? navigator.mediaDevices.getUserMedia({
         audio: { sampleRate: CAPTURE_SAMPLE_RATE, channelCount: 1, echoCancellation: true }
-      });
+      }));
       if (generation !== this.generation) {
         stream.getTracks().forEach((track) => track.stop());
         return;
@@ -373,6 +382,7 @@ var VoiceClient = class {
     });
   }
   cleanup() {
+    this.fullDuplex = false;
     this.generation += 1;
     if (this.processor) this.processor.onaudioprocess = null;
     this.processor?.disconnect();
@@ -509,6 +519,8 @@ var VoiceClient = class {
     }
     switch (msg.type) {
       case "session_config": {
+        this.fullDuplex = msg.speechMode === "speech_to_speech";
+        if (this.fullDuplex) player.setContinuousMode?.(true);
         if (msg.interruptionMode === "none" || msg.interruptionMode === "cancel" || msg.interruptionMode === "barge-in") {
           this.update({ interruptionMode: msg.interruptionMode });
         }
@@ -524,6 +536,32 @@ var VoiceClient = class {
       case "artifact":
         this.applyArtifactMessage(msg);
         break;
+      case "transcript_update": {
+        if (typeof msg.text !== "string" || typeof msg.turnId !== "string" || msg.role !== "user" && msg.role !== "assistant")
+          break;
+        if (msg.role === "assistant" && this.awaitingClear) break;
+        const entries = [...this.snapshot.transcript];
+        const index = entries.findIndex(
+          (entry2) => entry2.turnId === msg.turnId && entry2.role === msg.role
+        );
+        const entry = {
+          role: msg.role,
+          content: msg.text,
+          turnId: msg.turnId,
+          isFinal: msg.final === true,
+          timestamp: index >= 0 ? entries[index].timestamp : Date.now()
+        };
+        if (index >= 0) entries[index] = entry;
+        else entries.push(entry);
+        this.update({ transcript: entries, interimTranscript: null });
+        break;
+      }
+      case "delegation_started":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("thinking");
+        break;
+      case "delegation_completed":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("listening");
+        break;
       case "transcript_interim":
         this.update({ interimTranscript: typeof msg.text === "string" ? msg.text || null : null });
         break;
@@ -633,14 +671,14 @@ var VoiceClient = class {
     const processor = context.createScriptProcessor(CAPTURE_BUFFER_SIZE, 1, 1);
     this.processor = processor;
     processor.onaudioprocess = (event) => {
-      if (generation !== this.generation || this.snapshot.isMuted) return;
+      if (generation !== this.generation || this.snapshot.isMuted && !this.fullDuplex) return;
       const input = event.inputBuffer.getChannelData(0);
       let sum = 0;
       for (const sample of input) sum += sample * sample;
-      this.update({ audioLevel: Math.sqrt(sum / input.length) });
+      this.update({ audioLevel: this.snapshot.isMuted ? 0 : Math.sqrt(sum / input.length) });
       if (socket.readyState !== WebSocket.OPEN) return;
       const pcm = new Int16Array(input.length);
-      if (this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
+      if (this.snapshot.isMuted || this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
         socket.send(pcm.buffer);
         return;
       }

package/dist/persona.cjs

@@ -36,13 +36,16 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     this.readOffset = 0
     this.buffered = 0
     this.waiting = true
-    // INVARIANT: Only report drained after end-of-stream, never during a jitter gap.
+    // INVARIANT: Pipeline replies need EOS; continuous sessions report queue drain without a provider turn boundary.
     this.eosSeen = false
+    this.continuous = false
     this.revision = 0
     this.port.onmessage = (e) => {
       const msg = e.data
       this.revision = msg.revision
-      if (msg.type === 'push') {
+      if (msg.type === 'continuous') {
+        this.continuous = msg.enabled
+      } else if (msg.type === 'push') {
         this.eosSeen = false
         this.chunks.push(msg.samples)
         this.buffered += msg.samples.length
@@ -82,7 +85,7 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     }
     if (this.buffered === 0) {
       this.waiting = true // mid-reply underrun: re-buffer silently
-      if (this.eosSeen) {
+      if (this.eosSeen || this.continuous) {
         this.eosSeen = false
         this.port.postMessage({ type: 'drained', revision: this.revision })
       }
@@ -126,6 +129,9 @@ async function createPcmPlayer(onDrained) {
       if (samples.length === 0) return;
       node.port.postMessage({ type: "push", samples, revision }, [samples.buffer]);
     },
+    setContinuousMode(enabled) {
+      node.port.postMessage({ type: "continuous", enabled, revision });
+    },
     endOfStream() {
       node.port.postMessage({ type: "eos", revision });
     },
@@ -252,6 +258,7 @@ var VoiceClient = class {
   committedAssistantTurnId = null;
   activeTurnId = null;
   suppressedArtifactTurnId = null;
+  fullDuplex = false;
   getSnapshot = () => this.snapshot;
   subscribe = (listener) => {
     this.listeners.add(listener);
@@ -302,10 +309,12 @@ var VoiceClient = class {
       if (visitorToken && !/^cvt_[A-Za-z0-9_-]+$/.test(visitorToken)) {
         throw new Error("Invalid voice visitor credential.");
       }
+      if (this.options.fullDuplex !== false)
+        url.searchParams.set("voiceCapabilities", "full-duplex-v1");
       url.hash = "";
-      const stream = await navigator.mediaDevices.getUserMedia({
+      const stream = await (this.options.audioSource?.() ?? navigator.mediaDevices.getUserMedia({
         audio: { sampleRate: CAPTURE_SAMPLE_RATE, channelCount: 1, echoCancellation: true }
-      });
+      }));
       if (generation !== this.generation) {
         stream.getTracks().forEach((track) => track.stop());
         return;
@@ -400,6 +409,7 @@ var VoiceClient = class {
     });
   }
   cleanup() {
+    this.fullDuplex = false;
     this.generation += 1;
     if (this.processor) this.processor.onaudioprocess = null;
     this.processor?.disconnect();
@@ -536,6 +546,8 @@ var VoiceClient = class {
     }
     switch (msg.type) {
       case "session_config": {
+        this.fullDuplex = msg.speechMode === "speech_to_speech";
+        if (this.fullDuplex) player.setContinuousMode?.(true);
         if (msg.interruptionMode === "none" || msg.interruptionMode === "cancel" || msg.interruptionMode === "barge-in") {
           this.update({ interruptionMode: msg.interruptionMode });
         }
@@ -551,6 +563,32 @@ var VoiceClient = class {
       case "artifact":
         this.applyArtifactMessage(msg);
         break;
+      case "transcript_update": {
+        if (typeof msg.text !== "string" || typeof msg.turnId !== "string" || msg.role !== "user" && msg.role !== "assistant")
+          break;
+        if (msg.role === "assistant" && this.awaitingClear) break;
+        const entries = [...this.snapshot.transcript];
+        const index = entries.findIndex(
+          (entry2) => entry2.turnId === msg.turnId && entry2.role === msg.role
+        );
+        const entry = {
+          role: msg.role,
+          content: msg.text,
+          turnId: msg.turnId,
+          isFinal: msg.final === true,
+          timestamp: index >= 0 ? entries[index].timestamp : Date.now()
+        };
+        if (index >= 0) entries[index] = entry;
+        else entries.push(entry);
+        this.update({ transcript: entries, interimTranscript: null });
+        break;
+      }
+      case "delegation_started":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("thinking");
+        break;
+      case "delegation_completed":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("listening");
+        break;
       case "transcript_interim":
         this.update({ interimTranscript: typeof msg.text === "string" ? msg.text || null : null });
         break;
@@ -660,14 +698,14 @@ var VoiceClient = class {
     const processor = context.createScriptProcessor(CAPTURE_BUFFER_SIZE, 1, 1);
     this.processor = processor;
     processor.onaudioprocess = (event) => {
-      if (generation !== this.generation || this.snapshot.isMuted) return;
+      if (generation !== this.generation || this.snapshot.isMuted && !this.fullDuplex) return;
       const input = event.inputBuffer.getChannelData(0);
       let sum = 0;
       for (const sample of input) sum += sample * sample;
-      this.update({ audioLevel: Math.sqrt(sum / input.length) });
+      this.update({ audioLevel: this.snapshot.isMuted ? 0 : Math.sqrt(sum / input.length) });
       if (socket.readyState !== WebSocket.OPEN) return;
       const pcm = new Int16Array(input.length);
-      if (this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
+      if (this.snapshot.isMuted || this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
         socket.send(pcm.buffer);
         return;
       }
@@ -684,7 +722,7 @@ var VoiceClient = class {
 
 // src/persona.ts
 function createPersonaVoiceProvider(options) {
-  const client = new VoiceClient(options);
+  const client = new VoiceClient({ ...options, fullDuplex: false });
   const statusCallbacks = /* @__PURE__ */ new Set();
   const errorCallbacks = /* @__PURE__ */ new Set();
   const transcriptCallbacks = /* @__PURE__ */ new Set();
@@ -720,7 +758,7 @@ function createPersonaVoiceProvider(options) {
     });
     snapshot.transcript.forEach((entry, index) => {
       if (entry === before.transcript[index]) return;
-      const isFinal = entry.partial !== true;
+      const isFinal = entry.partial !== true && entry.isFinal !== false;
       for (const callback of transcriptCallbacks) {
         if (entry.turnId) callback(entry.role, entry.content, isFinal, { turnId: entry.turnId });
         else callback(entry.role, entry.content, isFinal);

package/dist/persona.d.cts

@@ -1,5 +1,5 @@
 import { AgentWidgetInitHandle, VoiceProvider } from '@runtypelabs/persona';
-import { b as VoiceArtifact, V as VoiceClientOptions } from './types-DaXyPeiV.cjs';
+import { b as VoiceArtifact, V as VoiceClientOptions } from './types-Dkh4LxEA.cjs';
 
 type ArtifactCallback = (artifact: VoiceArtifact) => void;
 /**

package/dist/persona.d.ts

@@ -1,5 +1,5 @@
 import { AgentWidgetInitHandle, VoiceProvider } from '@runtypelabs/persona';
-import { b as VoiceArtifact, V as VoiceClientOptions } from './types-DaXyPeiV.js';
+import { b as VoiceArtifact, V as VoiceClientOptions } from './types-Dkh4LxEA.js';
 
 type ArtifactCallback = (artifact: VoiceArtifact) => void;
 /**

package/dist/persona.js

@@ -9,13 +9,16 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     this.readOffset = 0
     this.buffered = 0
     this.waiting = true
-    // INVARIANT: Only report drained after end-of-stream, never during a jitter gap.
+    // INVARIANT: Pipeline replies need EOS; continuous sessions report queue drain without a provider turn boundary.
     this.eosSeen = false
+    this.continuous = false
     this.revision = 0
     this.port.onmessage = (e) => {
       const msg = e.data
       this.revision = msg.revision
-      if (msg.type === 'push') {
+      if (msg.type === 'continuous') {
+        this.continuous = msg.enabled
+      } else if (msg.type === 'push') {
         this.eosSeen = false
         this.chunks.push(msg.samples)
         this.buffered += msg.samples.length
@@ -55,7 +58,7 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     }
     if (this.buffered === 0) {
       this.waiting = true // mid-reply underrun: re-buffer silently
-      if (this.eosSeen) {
+      if (this.eosSeen || this.continuous) {
         this.eosSeen = false
         this.port.postMessage({ type: 'drained', revision: this.revision })
       }
@@ -99,6 +102,9 @@ async function createPcmPlayer(onDrained) {
       if (samples.length === 0) return;
       node.port.postMessage({ type: "push", samples, revision }, [samples.buffer]);
     },
+    setContinuousMode(enabled) {
+      node.port.postMessage({ type: "continuous", enabled, revision });
+    },
     endOfStream() {
       node.port.postMessage({ type: "eos", revision });
     },
@@ -225,6 +231,7 @@ var VoiceClient = class {
   committedAssistantTurnId = null;
   activeTurnId = null;
   suppressedArtifactTurnId = null;
+  fullDuplex = false;
   getSnapshot = () => this.snapshot;
   subscribe = (listener) => {
     this.listeners.add(listener);
@@ -275,10 +282,12 @@ var VoiceClient = class {
       if (visitorToken && !/^cvt_[A-Za-z0-9_-]+$/.test(visitorToken)) {
         throw new Error("Invalid voice visitor credential.");
       }
+      if (this.options.fullDuplex !== false)
+        url.searchParams.set("voiceCapabilities", "full-duplex-v1");
       url.hash = "";
-      const stream = await navigator.mediaDevices.getUserMedia({
+      const stream = await (this.options.audioSource?.() ?? navigator.mediaDevices.getUserMedia({
         audio: { sampleRate: CAPTURE_SAMPLE_RATE, channelCount: 1, echoCancellation: true }
-      });
+      }));
       if (generation !== this.generation) {
         stream.getTracks().forEach((track) => track.stop());
         return;
@@ -373,6 +382,7 @@ var VoiceClient = class {
     });
   }
   cleanup() {
+    this.fullDuplex = false;
     this.generation += 1;
     if (this.processor) this.processor.onaudioprocess = null;
     this.processor?.disconnect();
@@ -509,6 +519,8 @@ var VoiceClient = class {
     }
     switch (msg.type) {
       case "session_config": {
+        this.fullDuplex = msg.speechMode === "speech_to_speech";
+        if (this.fullDuplex) player.setContinuousMode?.(true);
         if (msg.interruptionMode === "none" || msg.interruptionMode === "cancel" || msg.interruptionMode === "barge-in") {
           this.update({ interruptionMode: msg.interruptionMode });
         }
@@ -524,6 +536,32 @@ var VoiceClient = class {
       case "artifact":
         this.applyArtifactMessage(msg);
         break;
+      case "transcript_update": {
+        if (typeof msg.text !== "string" || typeof msg.turnId !== "string" || msg.role !== "user" && msg.role !== "assistant")
+          break;
+        if (msg.role === "assistant" && this.awaitingClear) break;
+        const entries = [...this.snapshot.transcript];
+        const index = entries.findIndex(
+          (entry2) => entry2.turnId === msg.turnId && entry2.role === msg.role
+        );
+        const entry = {
+          role: msg.role,
+          content: msg.text,
+          turnId: msg.turnId,
+          isFinal: msg.final === true,
+          timestamp: index >= 0 ? entries[index].timestamp : Date.now()
+        };
+        if (index >= 0) entries[index] = entry;
+        else entries.push(entry);
+        this.update({ transcript: entries, interimTranscript: null });
+        break;
+      }
+      case "delegation_started":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("thinking");
+        break;
+      case "delegation_completed":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("listening");
+        break;
       case "transcript_interim":
         this.update({ interimTranscript: typeof msg.text === "string" ? msg.text || null : null });
         break;
@@ -633,14 +671,14 @@ var VoiceClient = class {
     const processor = context.createScriptProcessor(CAPTURE_BUFFER_SIZE, 1, 1);
     this.processor = processor;
     processor.onaudioprocess = (event) => {
-      if (generation !== this.generation || this.snapshot.isMuted) return;
+      if (generation !== this.generation || this.snapshot.isMuted && !this.fullDuplex) return;
       const input = event.inputBuffer.getChannelData(0);
       let sum = 0;
       for (const sample of input) sum += sample * sample;
-      this.update({ audioLevel: Math.sqrt(sum / input.length) });
+      this.update({ audioLevel: this.snapshot.isMuted ? 0 : Math.sqrt(sum / input.length) });
       if (socket.readyState !== WebSocket.OPEN) return;
       const pcm = new Int16Array(input.length);
-      if (this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
+      if (this.snapshot.isMuted || this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
         socket.send(pcm.buffer);
         return;
       }
@@ -657,7 +695,7 @@ var VoiceClient = class {
 
 // src/persona.ts
 function createPersonaVoiceProvider(options) {
-  const client = new VoiceClient(options);
+  const client = new VoiceClient({ ...options, fullDuplex: false });
   const statusCallbacks = /* @__PURE__ */ new Set();
   const errorCallbacks = /* @__PURE__ */ new Set();
   const transcriptCallbacks = /* @__PURE__ */ new Set();
@@ -693,7 +731,7 @@ function createPersonaVoiceProvider(options) {
     });
     snapshot.transcript.forEach((entry, index) => {
       if (entry === before.transcript[index]) return;
-      const isFinal = entry.partial !== true;
+      const isFinal = entry.partial !== true && entry.isFinal !== false;
       for (const callback of transcriptCallbacks) {
         if (entry.turnId) callback(entry.role, entry.content, isFinal, { turnId: entry.turnId });
         else callback(entry.role, entry.content, isFinal);

package/dist/react.cjs

@@ -37,13 +37,16 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     this.readOffset = 0
     this.buffered = 0
     this.waiting = true
-    // INVARIANT: Only report drained after end-of-stream, never during a jitter gap.
+    // INVARIANT: Pipeline replies need EOS; continuous sessions report queue drain without a provider turn boundary.
     this.eosSeen = false
+    this.continuous = false
     this.revision = 0
     this.port.onmessage = (e) => {
       const msg = e.data
       this.revision = msg.revision
-      if (msg.type === 'push') {
+      if (msg.type === 'continuous') {
+        this.continuous = msg.enabled
+      } else if (msg.type === 'push') {
         this.eosSeen = false
         this.chunks.push(msg.samples)
         this.buffered += msg.samples.length
@@ -83,7 +86,7 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     }
     if (this.buffered === 0) {
       this.waiting = true // mid-reply underrun: re-buffer silently
-      if (this.eosSeen) {
+      if (this.eosSeen || this.continuous) {
         this.eosSeen = false
         this.port.postMessage({ type: 'drained', revision: this.revision })
       }
@@ -127,6 +130,9 @@ async function createPcmPlayer(onDrained) {
       if (samples.length === 0) return;
       node.port.postMessage({ type: "push", samples, revision }, [samples.buffer]);
     },
+    setContinuousMode(enabled) {
+      node.port.postMessage({ type: "continuous", enabled, revision });
+    },
     endOfStream() {
       node.port.postMessage({ type: "eos", revision });
     },
@@ -253,6 +259,7 @@ var VoiceClient = class {
   committedAssistantTurnId = null;
   activeTurnId = null;
   suppressedArtifactTurnId = null;
+  fullDuplex = false;
   getSnapshot = () => this.snapshot;
   subscribe = (listener) => {
     this.listeners.add(listener);
@@ -303,10 +310,12 @@ var VoiceClient = class {
       if (visitorToken && !/^cvt_[A-Za-z0-9_-]+$/.test(visitorToken)) {
         throw new Error("Invalid voice visitor credential.");
       }
+      if (this.options.fullDuplex !== false)
+        url.searchParams.set("voiceCapabilities", "full-duplex-v1");
       url.hash = "";
-      const stream = await navigator.mediaDevices.getUserMedia({
+      const stream = await (this.options.audioSource?.() ?? navigator.mediaDevices.getUserMedia({
         audio: { sampleRate: CAPTURE_SAMPLE_RATE, channelCount: 1, echoCancellation: true }
-      });
+      }));
       if (generation !== this.generation) {
         stream.getTracks().forEach((track) => track.stop());
         return;
@@ -401,6 +410,7 @@ var VoiceClient = class {
     });
   }
   cleanup() {
+    this.fullDuplex = false;
     this.generation += 1;
     if (this.processor) this.processor.onaudioprocess = null;
     this.processor?.disconnect();
@@ -537,6 +547,8 @@ var VoiceClient = class {
     }
     switch (msg.type) {
       case "session_config": {
+        this.fullDuplex = msg.speechMode === "speech_to_speech";
+        if (this.fullDuplex) player.setContinuousMode?.(true);
         if (msg.interruptionMode === "none" || msg.interruptionMode === "cancel" || msg.interruptionMode === "barge-in") {
           this.update({ interruptionMode: msg.interruptionMode });
         }
@@ -552,6 +564,32 @@ var VoiceClient = class {
       case "artifact":
         this.applyArtifactMessage(msg);
         break;
+      case "transcript_update": {
+        if (typeof msg.text !== "string" || typeof msg.turnId !== "string" || msg.role !== "user" && msg.role !== "assistant")
+          break;
+        if (msg.role === "assistant" && this.awaitingClear) break;
+        const entries = [...this.snapshot.transcript];
+        const index = entries.findIndex(
+          (entry2) => entry2.turnId === msg.turnId && entry2.role === msg.role
+        );
+        const entry = {
+          role: msg.role,
+          content: msg.text,
+          turnId: msg.turnId,
+          isFinal: msg.final === true,
+          timestamp: index >= 0 ? entries[index].timestamp : Date.now()
+        };
+        if (index >= 0) entries[index] = entry;
+        else entries.push(entry);
+        this.update({ transcript: entries, interimTranscript: null });
+        break;
+      }
+      case "delegation_started":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("thinking");
+        break;
+      case "delegation_completed":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("listening");
+        break;
       case "transcript_interim":
         this.update({ interimTranscript: typeof msg.text === "string" ? msg.text || null : null });
         break;
@@ -661,14 +699,14 @@ var VoiceClient = class {
     const processor = context.createScriptProcessor(CAPTURE_BUFFER_SIZE, 1, 1);
     this.processor = processor;
     processor.onaudioprocess = (event) => {
-      if (generation !== this.generation || this.snapshot.isMuted) return;
+      if (generation !== this.generation || this.snapshot.isMuted && !this.fullDuplex) return;
       const input = event.inputBuffer.getChannelData(0);
       let sum = 0;
       for (const sample of input) sum += sample * sample;
-      this.update({ audioLevel: Math.sqrt(sum / input.length) });
+      this.update({ audioLevel: this.snapshot.isMuted ? 0 : Math.sqrt(sum / input.length) });
       if (socket.readyState !== WebSocket.OPEN) return;
       const pcm = new Int16Array(input.length);
-      if (this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
+      if (this.snapshot.isMuted || this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
         socket.send(pcm.buffer);
         return;
       }
@@ -691,7 +729,9 @@ function useVoiceClient({
   artifacts,
   sessionId,
   visitorToken,
-  onSession
+  onSession,
+  fullDuplex,
+  audioSource
 }) {
   const sessionRef = (0, import_react.useRef)(sessionId);
   (0, import_react.useEffect)(() => {
@@ -700,10 +740,15 @@ function useVoiceClient({
   const tokenRef = (0, import_react.useRef)(clientToken);
   const visitorRef = (0, import_react.useRef)(visitorToken);
   const sessionCallbackRef = (0, import_react.useRef)(onSession);
+  const audioSourceRef = (0, import_react.useRef)(audioSource);
+  const hasAudioSource = audioSource !== void 0;
   (0, import_react.useEffect)(() => {
     visitorRef.current = visitorToken;
     sessionCallbackRef.current = onSession;
   }, [visitorToken, onSession]);
+  (0, import_react.useEffect)(() => {
+    audioSourceRef.current = audioSource;
+  }, [audioSource]);
   (0, import_react.useEffect)(() => {
     tokenRef.current = clientToken;
   }, [clientToken]);
@@ -711,6 +756,8 @@ function useVoiceClient({
     agentId,
     apiUrl,
     artifacts,
+    fullDuplex,
+    ...hasAudioSource ? { audioSource: () => audioSourceRef.current() } : {},
     get sessionId() {
       return sessionRef.current;
     },
@@ -724,16 +771,20 @@ function useVoiceClient({
     agentId,
     apiUrl,
     artifacts,
+    fullDuplex,
+    hasAudioSource,
     sessionId,
     client: createClient()
   }));
-  const configurationChanged = binding.agentId !== agentId || binding.apiUrl !== apiUrl || binding.artifacts !== artifacts;
+  const configurationChanged = binding.agentId !== agentId || binding.apiUrl !== apiUrl || binding.artifacts !== artifacts || binding.fullDuplex !== fullDuplex || binding.hasAudioSource !== hasAudioSource;
   if (configurationChanged || binding.sessionId !== sessionId) {
     const acknowledgesSession = sessionId !== void 0 && sessionId === binding.client.getSnapshot().session?.sessionId;
     setBinding({
       agentId,
       apiUrl,
       artifacts,
+      fullDuplex,
+      hasAudioSource,
       sessionId,
       client: !configurationChanged && acknowledgesSession ? binding.client : createClient()
     });

package/dist/react.d.cts

@@ -1,8 +1,8 @@
-import { V as VoiceClientOptions, f as VoiceStatus, T as TranscriptEntry, d as VoiceMetrics, I as InterruptionMode, b as VoiceArtifact, e as VoiceSession } from './types-DaXyPeiV.cjs';
-export { a as VoiceSnapshot } from './types-DaXyPeiV.cjs';
+import { V as VoiceClientOptions, f as VoiceStatus, T as TranscriptEntry, d as VoiceMetrics, I as InterruptionMode, b as VoiceArtifact, e as VoiceSession } from './types-Dkh4LxEA.cjs';
+export { a as VoiceSnapshot } from './types-Dkh4LxEA.cjs';
 
 /** Subscribe to a voice client and end its call when the component unmounts or changes agent. */
-declare function useVoiceClient({ agentId, apiUrl, clientToken, artifacts, sessionId, visitorToken, onSession, }: VoiceClientOptions): {
+declare function useVoiceClient({ agentId, apiUrl, clientToken, artifacts, sessionId, visitorToken, onSession, fullDuplex, audioSource, }: VoiceClientOptions): {
     startCall: (tokenOverride?: string) => Promise<void>;
     endCall: () => void;
     resetSession: () => void;

package/dist/react.d.ts

@@ -1,8 +1,8 @@
-import { V as VoiceClientOptions, f as VoiceStatus, T as TranscriptEntry, d as VoiceMetrics, I as InterruptionMode, b as VoiceArtifact, e as VoiceSession } from './types-DaXyPeiV.js';
-export { a as VoiceSnapshot } from './types-DaXyPeiV.js';
+import { V as VoiceClientOptions, f as VoiceStatus, T as TranscriptEntry, d as VoiceMetrics, I as InterruptionMode, b as VoiceArtifact, e as VoiceSession } from './types-Dkh4LxEA.js';
+export { a as VoiceSnapshot } from './types-Dkh4LxEA.js';
 
 /** Subscribe to a voice client and end its call when the component unmounts or changes agent. */
-declare function useVoiceClient({ agentId, apiUrl, clientToken, artifacts, sessionId, visitorToken, onSession, }: VoiceClientOptions): {
+declare function useVoiceClient({ agentId, apiUrl, clientToken, artifacts, sessionId, visitorToken, onSession, fullDuplex, audioSource, }: VoiceClientOptions): {
     startCall: (tokenOverride?: string) => Promise<void>;
     endCall: () => void;
     resetSession: () => void;

package/dist/react.js

@@ -14,13 +14,16 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     this.readOffset = 0
     this.buffered = 0
     this.waiting = true
-    // INVARIANT: Only report drained after end-of-stream, never during a jitter gap.
+    // INVARIANT: Pipeline replies need EOS; continuous sessions report queue drain without a provider turn boundary.
     this.eosSeen = false
+    this.continuous = false
     this.revision = 0
     this.port.onmessage = (e) => {
       const msg = e.data
       this.revision = msg.revision
-      if (msg.type === 'push') {
+      if (msg.type === 'continuous') {
+        this.continuous = msg.enabled
+      } else if (msg.type === 'push') {
         this.eosSeen = false
         this.chunks.push(msg.samples)
         this.buffered += msg.samples.length
@@ -60,7 +63,7 @@ class RuntypePcmPlayerProcessor extends AudioWorkletProcessor {
     }
     if (this.buffered === 0) {
       this.waiting = true // mid-reply underrun: re-buffer silently
-      if (this.eosSeen) {
+      if (this.eosSeen || this.continuous) {
         this.eosSeen = false
         this.port.postMessage({ type: 'drained', revision: this.revision })
       }
@@ -104,6 +107,9 @@ async function createPcmPlayer(onDrained) {
       if (samples.length === 0) return;
       node.port.postMessage({ type: "push", samples, revision }, [samples.buffer]);
     },
+    setContinuousMode(enabled) {
+      node.port.postMessage({ type: "continuous", enabled, revision });
+    },
     endOfStream() {
       node.port.postMessage({ type: "eos", revision });
     },
@@ -230,6 +236,7 @@ var VoiceClient = class {
   committedAssistantTurnId = null;
   activeTurnId = null;
   suppressedArtifactTurnId = null;
+  fullDuplex = false;
   getSnapshot = () => this.snapshot;
   subscribe = (listener) => {
     this.listeners.add(listener);
@@ -280,10 +287,12 @@ var VoiceClient = class {
       if (visitorToken && !/^cvt_[A-Za-z0-9_-]+$/.test(visitorToken)) {
         throw new Error("Invalid voice visitor credential.");
       }
+      if (this.options.fullDuplex !== false)
+        url.searchParams.set("voiceCapabilities", "full-duplex-v1");
       url.hash = "";
-      const stream = await navigator.mediaDevices.getUserMedia({
+      const stream = await (this.options.audioSource?.() ?? navigator.mediaDevices.getUserMedia({
         audio: { sampleRate: CAPTURE_SAMPLE_RATE, channelCount: 1, echoCancellation: true }
-      });
+      }));
       if (generation !== this.generation) {
         stream.getTracks().forEach((track) => track.stop());
         return;
@@ -378,6 +387,7 @@ var VoiceClient = class {
     });
   }
   cleanup() {
+    this.fullDuplex = false;
     this.generation += 1;
     if (this.processor) this.processor.onaudioprocess = null;
     this.processor?.disconnect();
@@ -514,6 +524,8 @@ var VoiceClient = class {
     }
     switch (msg.type) {
       case "session_config": {
+        this.fullDuplex = msg.speechMode === "speech_to_speech";
+        if (this.fullDuplex) player.setContinuousMode?.(true);
         if (msg.interruptionMode === "none" || msg.interruptionMode === "cancel" || msg.interruptionMode === "barge-in") {
           this.update({ interruptionMode: msg.interruptionMode });
         }
@@ -529,6 +541,32 @@ var VoiceClient = class {
       case "artifact":
         this.applyArtifactMessage(msg);
         break;
+      case "transcript_update": {
+        if (typeof msg.text !== "string" || typeof msg.turnId !== "string" || msg.role !== "user" && msg.role !== "assistant")
+          break;
+        if (msg.role === "assistant" && this.awaitingClear) break;
+        const entries = [...this.snapshot.transcript];
+        const index = entries.findIndex(
+          (entry2) => entry2.turnId === msg.turnId && entry2.role === msg.role
+        );
+        const entry = {
+          role: msg.role,
+          content: msg.text,
+          turnId: msg.turnId,
+          isFinal: msg.final === true,
+          timestamp: index >= 0 ? entries[index].timestamp : Date.now()
+        };
+        if (index >= 0) entries[index] = entry;
+        else entries.push(entry);
+        this.update({ transcript: entries, interimTranscript: null });
+        break;
+      }
+      case "delegation_started":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("thinking");
+        break;
+      case "delegation_completed":
+        if (!this.hasPendingAudio && !this.awaitingClear) this.setStatus("listening");
+        break;
       case "transcript_interim":
         this.update({ interimTranscript: typeof msg.text === "string" ? msg.text || null : null });
         break;
@@ -638,14 +676,14 @@ var VoiceClient = class {
     const processor = context.createScriptProcessor(CAPTURE_BUFFER_SIZE, 1, 1);
     this.processor = processor;
     processor.onaudioprocess = (event) => {
-      if (generation !== this.generation || this.snapshot.isMuted) return;
+      if (generation !== this.generation || this.snapshot.isMuted && !this.fullDuplex) return;
       const input = event.inputBuffer.getChannelData(0);
       let sum = 0;
       for (const sample of input) sum += sample * sample;
-      this.update({ audioLevel: Math.sqrt(sum / input.length) });
+      this.update({ audioLevel: this.snapshot.isMuted ? 0 : Math.sqrt(sum / input.length) });
       if (socket.readyState !== WebSocket.OPEN) return;
       const pcm = new Int16Array(input.length);
-      if (this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
+      if (this.snapshot.isMuted || this.snapshot.interruptionMode === "cancel" && (this.awaitingClear || this.snapshot.status === "thinking" || this.hasPendingAudio || this.snapshot.status === "speaking")) {
         socket.send(pcm.buffer);
         return;
       }
@@ -668,7 +706,9 @@ function useVoiceClient({
   artifacts,
   sessionId,
   visitorToken,
-  onSession
+  onSession,
+  fullDuplex,
+  audioSource
 }) {
   const sessionRef = useRef(sessionId);
   useEffect(() => {
@@ -677,10 +717,15 @@ function useVoiceClient({
   const tokenRef = useRef(clientToken);
   const visitorRef = useRef(visitorToken);
   const sessionCallbackRef = useRef(onSession);
+  const audioSourceRef = useRef(audioSource);
+  const hasAudioSource = audioSource !== void 0;
   useEffect(() => {
     visitorRef.current = visitorToken;
     sessionCallbackRef.current = onSession;
   }, [visitorToken, onSession]);
+  useEffect(() => {
+    audioSourceRef.current = audioSource;
+  }, [audioSource]);
   useEffect(() => {
     tokenRef.current = clientToken;
   }, [clientToken]);
@@ -688,6 +733,8 @@ function useVoiceClient({
     agentId,
     apiUrl,
     artifacts,
+    fullDuplex,
+    ...hasAudioSource ? { audioSource: () => audioSourceRef.current() } : {},
     get sessionId() {
       return sessionRef.current;
     },
@@ -701,16 +748,20 @@ function useVoiceClient({
     agentId,
     apiUrl,
     artifacts,
+    fullDuplex,
+    hasAudioSource,
     sessionId,
     client: createClient()
   }));
-  const configurationChanged = binding.agentId !== agentId || binding.apiUrl !== apiUrl || binding.artifacts !== artifacts;
+  const configurationChanged = binding.agentId !== agentId || binding.apiUrl !== apiUrl || binding.artifacts !== artifacts || binding.fullDuplex !== fullDuplex || binding.hasAudioSource !== hasAudioSource;
   if (configurationChanged || binding.sessionId !== sessionId) {
     const acknowledgesSession = sessionId !== void 0 && sessionId === binding.client.getSnapshot().session?.sessionId;
     setBinding({
       agentId,
       apiUrl,
       artifacts,
+      fullDuplex,
+      hasAudioSource,
       sessionId,
       client: !configurationChanged && acknowledgesSession ? binding.client : createClient()
     });

package/dist/{types-DaXyPeiV.d.cts → types-Dkh4LxEA.d.cts}

@@ -4,6 +4,7 @@ interface TranscriptEntry {
     readonly role: 'user' | 'assistant';
     readonly content: string;
     readonly timestamp: number;
+    readonly isFinal?: boolean;
     readonly turnId?: string;
     /**
      * The reply is still being spoken, so `content` holds the clauses committed so
@@ -74,6 +75,10 @@ interface VoiceSnapshot {
 }
 interface VoiceClientOptions {
     agentId: string;
+    /** Disable when the transcript consumer only supports sequential pipeline turns. */
+    fullDuplex?: boolean;
+    /** Optional custom audio source; the client owns and stops the returned tracks. */
+    audioSource?: () => Promise<MediaStream>;
     /** Browser client token, or a getter called once per call to obtain a fresh token. */
     clientToken: string | (() => string | Promise<string>);
     /** Absolute API base URL, including any proxy path prefix. Defaults to https://api.runtype.com. */

package/dist/{types-DaXyPeiV.d.ts → types-Dkh4LxEA.d.ts}

@@ -4,6 +4,7 @@ interface TranscriptEntry {
     readonly role: 'user' | 'assistant';
     readonly content: string;
     readonly timestamp: number;
+    readonly isFinal?: boolean;
     readonly turnId?: string;
     /**
      * The reply is still being spoken, so `content` holds the clauses committed so
@@ -74,6 +75,10 @@ interface VoiceSnapshot {
 }
 interface VoiceClientOptions {
     agentId: string;
+    /** Disable when the transcript consumer only supports sequential pipeline turns. */
+    fullDuplex?: boolean;
+    /** Optional custom audio source; the client owns and stops the returned tracks. */
+    audioSource?: () => Promise<MediaStream>;
     /** Browser client token, or a getter called once per call to obtain a fresh token. */
     clientToken: string | (() => string | Promise<string>);
     /** Absolute API base URL, including any proxy path prefix. Defaults to https://api.runtype.com. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/voice",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Runtype browser voice client with React and Persona adapters",
   "type": "module",
   "license": "MIT",