@absolutejs/voice 0.0.22-beta.634 → 0.0.22-beta.635

package/dist/core/types.d.ts

@@ -133,7 +133,7 @@ export type VoiceTurnCostEstimate = {
     primaryAudioMs: number;
     totalBillableAudioMs: number;
 };
-export type VoiceFallbackSelectionReason = "fallback-empty" | "primary-empty" | "word-count-margin" | "confidence-margin" | "word-count-tiebreak" | "kept-primary";
+export type VoiceFallbackSelectionReason = "fallback-empty" | "primary-empty" | "word-count-margin" | "confidence-margin" | "word-count-tiebreak" | "policy-preference" | "kept-primary";
 export type VoiceFallbackDiagnostics = {
     attempted: boolean;
     fallbackConfidence?: number;
@@ -458,6 +458,9 @@ export type VoiceSTTFallbackConfig = {
      * language that should receive a second transcription pass regardless of the
      * aggregate confidence. */
     riskPolicy?: VoiceSTTFallbackRiskPolicy;
+    /** Prefer a non-empty independent fallback for these audited trigger reasons,
+     * including providers that do not expose comparable confidence scores. */
+    preferFallbackOn?: VoiceFallbackTriggerReason[];
 };
 export type VoiceResolvedSTTFallbackConfig = {
     adapter: STTAdapter;
@@ -470,6 +473,7 @@ export type VoiceResolvedSTTFallbackConfig = {
     maxAttemptsPerTurn: number;
     wordConfidenceThreshold?: number;
     riskPolicy?: VoiceSTTFallbackRiskPolicy;
+    preferFallbackOn?: VoiceFallbackTriggerReason[];
 };
 export type VoiceTurnDetectionConfig = {
     profile?: VoiceTurnProfile;

package/dist/index.js

@@ -4260,7 +4260,8 @@ var createVoiceSession = (options) => {
     settleMs: options.sttFallback.settleMs ?? DEFAULT_FALLBACK_SETTLE_MS,
     trigger: options.sttFallback.trigger ?? "empty-or-low-confidence",
     wordConfidenceThreshold: options.sttFallback.wordConfidenceThreshold,
-    riskPolicy: options.sttFallback.riskPolicy
+    riskPolicy: options.sttFallback.riskPolicy,
+    preferFallbackOn: options.sttFallback.preferFallbackOn
   } : undefined;
   const appendTrace = async (input) => {
     await options.trace?.append({
@@ -5524,7 +5525,11 @@ var createVoiceSession = (options) => {
       text: primaryText,
       wordCount: countWords2(normalizeText2(primaryText))
     };
-    const selection = selectBetterTurnText(primaryCandidate, fallbackCandidate);
+    const policyPrefersFallback = fallbackCandidate.text.length > 0 && fallbackNeed.reason !== undefined && sttFallback.preferFallbackOn?.includes(fallbackNeed.reason);
+    const selection = policyPrefersFallback ? {
+      reason: "policy-preference",
+      winner: fallbackCandidate
+    } : selectBetterTurnText(primaryCandidate, fallbackCandidate);
     const diagnostics = {
       attempted: true,
       fallbackConfidence: fallbackCandidate.confidence,

package/dist/testing/index.js

@@ -6643,7 +6643,8 @@ var createVoiceSession = (options) => {
     settleMs: options.sttFallback.settleMs ?? DEFAULT_FALLBACK_SETTLE_MS,
     trigger: options.sttFallback.trigger ?? "empty-or-low-confidence",
     wordConfidenceThreshold: options.sttFallback.wordConfidenceThreshold,
-    riskPolicy: options.sttFallback.riskPolicy
+    riskPolicy: options.sttFallback.riskPolicy,
+    preferFallbackOn: options.sttFallback.preferFallbackOn
   } : undefined;
   const appendTrace = async (input) => {
     await options.trace?.append({
@@ -7907,7 +7908,11 @@ var createVoiceSession = (options) => {
       text: primaryText,
       wordCount: countWords2(normalizeText2(primaryText))
     };
-    const selection = selectBetterTurnText(primaryCandidate, fallbackCandidate);
+    const policyPrefersFallback = fallbackCandidate.text.length > 0 && fallbackNeed.reason !== undefined && sttFallback.preferFallbackOn?.includes(fallbackNeed.reason);
+    const selection = policyPrefersFallback ? {
+      reason: "policy-preference",
+      winner: fallbackCandidate
+    } : selectBetterTurnText(primaryCandidate, fallbackCandidate);
     const diagnostics = {
       attempted: true,
       fallbackConfidence: fallbackCandidate.confidence,

package/package.json

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