@absolutejs/voice 0.0.22-beta.487 → 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,10 @@ 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";
 export type { CreateVoiceCallerMemoryNamespaceOptions, SummarizeVoiceCallerTranscriptOptions, VoiceCallerIdentity, VoiceCallerMemoryCompletion, VoiceCallerMemorySnapshot, VoiceCallerMemorySummarizerInput, } from "./callerMemory";
 export { aggregateVoiceTurnLatencySpans, buildOTELSpanId, buildOTELTraceId, buildVoiceOTELPayload, createVoiceOTELHTTPExporter, } from "./otelExporter";

package/dist/index.js

@@ -35475,6 +35475,154 @@ 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();
+  if (pattern instanceof RegExp) {
+    return pattern.test(normalized);
+  }
+  const target = pattern.toLowerCase().trim();
+  if (!target) {
+    return false;
+  }
+  return normalized.includes(target);
+};
+var digitsMatchPattern = (pattern, input) => {
+  return input === pattern;
+};
+var branchMatches = (branch, input) => {
+  const matcher = branch.match;
+  if (matcher.digit && input.digits) {
+    if (input.digits === matcher.digit) {
+      return true;
+    }
+  }
+  if (matcher.digits && input.digits) {
+    if (digitsMatchPattern(matcher.digits, input.digits)) {
+      return true;
+    }
+  }
+  if (matcher.speech && input.speech) {
+    if (speechMatchesPattern(matcher.speech, input.speech)) {
+      return true;
+    }
+  }
+  return false;
+};
+var evaluateVoiceIVRPlan = (plan, input) => {
+  if (!input.digits && !input.speech) {
+    return { reason: "timeout" };
+  }
+  for (const branch of plan.branches) {
+    if (branchMatches(branch, input)) {
+      return { branch, reason: "matched" };
+    }
+  }
+  if (plan.fallbackBranchId) {
+    const fallback = plan.branches.find((branch) => branch.id === plan.fallbackBranchId);
+    if (fallback) {
+      return { branch: fallback, reason: "fallback" };
+    }
+  }
+  return { reason: "no-match" };
+};
+var createVoiceIVRSession = (plan) => {
+  const maxAttempts = plan.maxAttempts ?? 3;
+  let attempts = 0;
+  return {
+    attempt: () => attempts,
+    decide: (input) => {
+      attempts += 1;
+      return evaluateVoiceIVRPlan(plan, input);
+    },
+    exhausted: () => attempts >= maxAttempts,
+    reset: () => {
+      attempts = 0;
+    }
+  };
+};
+var describeVoiceIVRPlan = (plan) => {
+  const lines = [plan.greeting];
+  for (const branch of plan.branches) {
+    const triggers = [];
+    if (branch.match.digit) {
+      triggers.push(`press ${branch.match.digit}`);
+    }
+    if (branch.match.digits) {
+      triggers.push(`press ${branch.match.digits}`);
+    }
+    if (branch.match.speech) {
+      triggers.push(`say "${branch.match.speech instanceof RegExp ? branch.match.speech.source : branch.match.speech}"`);
+    }
+    lines.push(`- ${branch.label}: ${triggers.join(" or ")}`);
+  }
+  return lines.join(`
+`);
+};
 // src/callerMemory.ts
 var VOICE_CALLER_MEMORY_KEY = "caller-memory-snapshot";
 var normalizeIdentifier = (value) => value.trim().replace(/[^a-zA-Z0-9+@._-]/g, "-").toLowerCase();
@@ -46553,6 +46701,7 @@ export {
   evaluateVoiceMediaPipelineEvidence,
   evaluateVoiceLiveOpsEvidence,
   evaluateVoiceLiveOpsControlEvidence,
+  evaluateVoiceIVRPlan,
   evaluateVoiceGuardrailPolicy,
   evaluateVoiceDataControlEvidence,
   evaluateVoiceCompetitiveCoverage,
@@ -46562,6 +46711,7 @@ export {
   evaluateVoiceAgentSquadContractEvidence,
   encodeTwilioMulawBase64,
   encodePcmAsWav,
+  describeVoiceIVRPlan,
   describeVoiceAssistantMode,
   deliverVoiceTraceEventsToSinks,
   deliverVoiceObservabilityExport,
@@ -46807,6 +46957,7 @@ export {
   createVoiceIncidentBundleRoutes,
   createVoiceInMemoryRealCallProfileRecoveryJobStore,
   createVoiceInMemoryMonitorRegistry,
+  createVoiceIVRSession,
   createVoiceHubSpotTaskUpdateSink,
   createVoiceHubSpotTaskSyncSinks,
   createVoiceHubSpotTaskSink,
@@ -46872,6 +47023,7 @@ export {
   createVoiceBrowserMediaRoutes,
   createVoiceBrowserCallProfileRoutes,
   createVoiceBargeInRoutes,
+  createVoiceBackchannelDriver,
   createVoiceAuditTrailRoutes,
   createVoiceAuditSinkStore,
   createVoiceAuditSinkDeliveryWorkerLoop,

package/dist/ivrPlan.d.ts

@@ -0,0 +1,40 @@
+export type VoiceIVRMatch = {
+    digit?: string;
+    digits?: string;
+    speech?: string | RegExp;
+};
+export type VoiceIVRBranch = {
+    assistantId?: string;
+    description?: string;
+    id: string;
+    label: string;
+    match: VoiceIVRMatch;
+    metadata?: Record<string, unknown>;
+    target?: string;
+};
+export type VoiceIVRPlan = {
+    branches: readonly VoiceIVRBranch[];
+    fallbackBranchId?: string;
+    greeting: string;
+    maxAttempts?: number;
+    noMatchPrompt?: string;
+    timeoutMs?: number;
+    timeoutPrompt?: string;
+};
+export type VoiceIVRInput = {
+    digits?: string;
+    speech?: string;
+};
+export type VoiceIVRDecision = {
+    branch?: VoiceIVRBranch;
+    reason: "matched" | "no-match" | "fallback" | "timeout";
+};
+export declare const evaluateVoiceIVRPlan: (plan: VoiceIVRPlan, input: VoiceIVRInput) => VoiceIVRDecision;
+export type VoiceIVRSession = {
+    attempt: () => number;
+    decide: (input: VoiceIVRInput) => VoiceIVRDecision;
+    exhausted: () => boolean;
+    reset: () => void;
+};
+export declare const createVoiceIVRSession: (plan: VoiceIVRPlan) => VoiceIVRSession;
+export declare const describeVoiceIVRPlan: (plan: VoiceIVRPlan) => string;

package/package.json

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