@absolutejs/voice 0.0.22-beta.488 → 0.0.22-beta.489

package/dist/backchannel.d.ts

@@ -0,0 +1,18 @@
+export type VoiceBackchannelCue = {
+    audioUrl?: string;
+    metadata?: Record<string, unknown>;
+    text?: string;
+};
+export type VoiceBackchannelDriverOptions = {
+    cues?: ReadonlyArray<VoiceBackchannelCue>;
+    cueIntervalMs?: number;
+    cueIndex?: (index: number) => number;
+    minSpeechMs?: number;
+    onCue: (cue: VoiceBackchannelCue) => Promise<void> | void;
+};
+export type VoiceBackchannelDriver = {
+    noteSpeech: (timestampMs?: number) => void;
+    noteSilence: (timestampMs?: number) => void;
+    reset: () => void;
+};
+export declare const createVoiceBackchannelDriver: (options: VoiceBackchannelDriverOptions) => VoiceBackchannelDriver;

package/dist/index.d.ts

@@ -81,6 +81,8 @@ export { describeVoiceAssistantMode, resolveVoiceAssistantMode, } from "./assist
 export type { VoiceAssistantMode, VoiceAssistantModality, VoiceAssistantModeDescriptor, VoiceSemanticVADConfig, } from "./assistantMode";
 export { createPunctuationSemanticTurnDetector, createRegexSemanticTurnDetector, } from "./semanticTurn";
 export { VOICE_WEBHOOK_SIGNATURE_HEADER, VOICE_WEBHOOK_TIMESTAMP_HEADER, extractVoiceWebhookSignatureFromHeaders, signVoiceWebhookBody, verifyVoiceWebhookSignature, } from "./webhookVerification";
+export { createVoiceBackchannelDriver } from "./backchannel";
+export type { VoiceBackchannelCue, VoiceBackchannelDriver, VoiceBackchannelDriverOptions, } from "./backchannel";
 export { createVoiceIVRSession, describeVoiceIVRPlan, evaluateVoiceIVRPlan, } from "./ivrPlan";
 export type { VoiceIVRBranch, VoiceIVRDecision, VoiceIVRInput, VoiceIVRMatch, VoiceIVRPlan, VoiceIVRSession, } from "./ivrPlan";
 export { VOICE_CALLER_MEMORY_KEY, buildVoiceCallerMemoryNamespace, createVoiceCallerMemoryNamespace, summarizeVoiceCallerTranscript, } from "./callerMemory";

package/dist/index.js

@@ -35475,6 +35475,70 @@ var extractVoiceWebhookSignatureFromHeaders = (headers) => {
     timestamp: get(VOICE_WEBHOOK_TIMESTAMP_HEADER)
   };
 };
+// src/backchannel.ts
+var DEFAULT_CUES = [
+  { text: "mm-hmm" },
+  { text: "I see" },
+  { text: "right" },
+  { text: "go on" }
+];
+var createVoiceBackchannelDriver = (options) => {
+  const cues = options.cues ?? DEFAULT_CUES;
+  const minSpeechMs = options.minSpeechMs ?? 2500;
+  const cueIntervalMs = options.cueIntervalMs ?? 2500;
+  const cueIndexFn = options.cueIndex ?? ((index) => index % Math.max(cues.length, 1));
+  let speechStartedAt;
+  let lastCueAt;
+  let cueCount = 0;
+  let firing = false;
+  const tryFire = async (now) => {
+    if (firing || cues.length === 0) {
+      return;
+    }
+    if (speechStartedAt === undefined) {
+      return;
+    }
+    const elapsed = now - speechStartedAt;
+    if (elapsed < minSpeechMs) {
+      return;
+    }
+    if (lastCueAt !== undefined && now - lastCueAt < cueIntervalMs) {
+      return;
+    }
+    const cue = cues[cueIndexFn(cueCount)];
+    if (!cue) {
+      return;
+    }
+    firing = true;
+    try {
+      await options.onCue(cue);
+    } finally {
+      firing = false;
+      lastCueAt = now;
+      cueCount += 1;
+    }
+  };
+  return {
+    noteSpeech: (timestampMs) => {
+      const now = timestampMs ?? Date.now();
+      if (speechStartedAt === undefined) {
+        speechStartedAt = now;
+      }
+      tryFire(now);
+    },
+    noteSilence: (timestampMs) => {
+      const now = timestampMs ?? Date.now();
+      if (lastCueAt !== undefined && now - lastCueAt > cueIntervalMs * 2) {
+        speechStartedAt = undefined;
+      }
+    },
+    reset: () => {
+      speechStartedAt = undefined;
+      lastCueAt = undefined;
+      cueCount = 0;
+    }
+  };
+};
 // src/ivrPlan.ts
 var speechMatchesPattern = (pattern, speech) => {
   const normalized = speech.toLowerCase().trim();
@@ -46959,6 +47023,7 @@ export {
   createVoiceBrowserMediaRoutes,
   createVoiceBrowserCallProfileRoutes,
   createVoiceBargeInRoutes,
+  createVoiceBackchannelDriver,
   createVoiceAuditTrailRoutes,
   createVoiceAuditSinkStore,
   createVoiceAuditSinkDeliveryWorkerLoop,

package/package.json

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