@absolutejs/voice 0.0.22-beta.622 → 0.0.22-beta.623

package/dist/core/types.d.ts

@@ -803,6 +803,13 @@ export type VoicePluginConfig<TContext = unknown, TSession extends VoiceSessionR
     sttRecoveryLine?: string | ((input: {
         session: TSession;
     }) => string | Promise<string>);
+    stuckCallClose?: {
+        afterMs: number;
+        line?: string | ((input: {
+            session: TSession;
+        }) => string | Promise<string>);
+        reason?: string;
+    };
     languageStrategy?: VoiceLanguageStrategy;
     lexicon?: VoiceLexiconEntry[] | VoiceLexiconResolver<TContext>;
     phraseHints?: VoicePhraseHint[] | VoicePhraseHintResolver<TContext>;
@@ -958,6 +965,20 @@ export type CreateVoiceSessionOptions<TContext = unknown, TSession extends Voice
     sttRecoveryLine?: string | ((input: {
         session: TSession;
     }) => string | Promise<string>);
+    /** Last-resort GRACEFUL terminal close for a wedged call. If no caller-side
+     *  progress (committed turn / user partial) lands for `afterMs` on a live call
+     *  — STT permanently deaf, or the caller left — the assistant speaks `line` and
+     *  the session COMPLETES (disposition "completed") so onComplete still saves and
+     *  the call ends with a real goodbye instead of dead air + "abandoned". Reset by
+     *  real progress (committed turn / user partial / (re)connect), NOT by the
+     *  assistant's own speech, so STT recovery re-prompts can't defer it forever. */
+    stuckCallClose?: {
+        afterMs: number;
+        line?: string | ((input: {
+            session: TSession;
+        }) => string | Promise<string>);
+        reason?: string;
+    };
     stt?: STTAdapter;
     realtime?: RealtimeAdapter;
     realtimeInputFormat?: AudioFormat;

package/dist/index.js

@@ -4186,6 +4186,51 @@ var createVoiceSession = (options) => {
     clearCallSilenceWatchdog();
     callSilenceWatchdog = setTimeout(fireCallSilenceTimeout, callSilenceTimeoutMs);
   };
+  const stuckCloseConfig = options.stuckCallClose;
+  const stuckCloseAfterMs = stuckCloseConfig && stuckCloseConfig.afterMs > 0 ? stuckCloseConfig.afterMs : undefined;
+  let stuckCloseWatchdog = null;
+  let stuckCloseFired = false;
+  const clearStuckCloseWatchdog = () => {
+    if (stuckCloseWatchdog) {
+      clearTimeout(stuckCloseWatchdog);
+      stuckCloseWatchdog = null;
+    }
+  };
+  const fireStuckClose = () => {
+    stuckCloseWatchdog = null;
+    if (stuckCloseFired) {
+      return;
+    }
+    stuckCloseFired = true;
+    runSerial("stuck-call-close", async () => {
+      const snapshot = await readSession();
+      if (snapshot.status === "completed" || snapshot.status === "failed" || snapshot.call?.endedAt) {
+        return;
+      }
+      await appendTrace({
+        payload: {
+          action: "stuck-call-close",
+          reason: `no caller progress for ${stuckCloseAfterMs}ms`
+        },
+        session: snapshot,
+        type: "session.error"
+      });
+      if (stuckCloseConfig?.line) {
+        await speakResolvedLine(stuckCloseConfig.line, snapshot);
+      }
+      await completeInternal(undefined, {
+        disposition: "completed",
+        reason: stuckCloseConfig?.reason ?? "stuck-call-close"
+      });
+    });
+  };
+  const kickStuckCloseWatchdog = () => {
+    if (stuckCloseAfterMs === undefined || stuckCloseFired) {
+      return;
+    }
+    clearStuckCloseWatchdog();
+    stuckCloseWatchdog = setTimeout(fireStuckClose, stuckCloseAfterMs);
+  };
   const recordingConfig = options.recording;
   const recordingChannels = new Set(recordingConfig?.channels ?? ["assistant", "user"]);
   const recordingMaxBytes = recordingConfig?.maxBytesPerChannel ?? 50 * 1024 * 1024;
@@ -4682,6 +4727,7 @@ var createVoiceSession = (options) => {
       type: "error"
     });
     clearCallSilenceWatchdog();
+    clearStuckCloseWatchdog();
     clearAmdEvaluationTimer();
     await closeTTSSession("failed");
     await closeAdapter("failed");
@@ -4791,6 +4837,7 @@ var createVoiceSession = (options) => {
       type: "complete"
     });
     clearCallSilenceWatchdog();
+    clearStuckCloseWatchdog();
     clearAmdEvaluationTimer();
     await closeTTSSession("complete");
     await closeAdapter("complete");
@@ -5268,6 +5315,9 @@ var createVoiceSession = (options) => {
     };
   };
   const handlePartial = async (transcript) => {
+    if (transcript.text.trim()) {
+      kickStuckCloseWatchdog();
+    }
     if (activeTTSTurnId !== undefined) {
       const triggeringText = transcript.text.trim();
       if (triggeringText) {
@@ -5742,6 +5792,7 @@ var createVoiceSession = (options) => {
   };
   const completeTurn = async (session, turn) => {
     console.error(`[voice] completeTurn ENTER session=${options.id} turn=${turn.id} textLen=${turn.text?.length ?? 0}`);
+    kickStuckCloseWatchdog();
     const liveOpsControl = await options.liveOps?.getControl(options.id);
     if (liveOpsControl?.assistantPaused || liveOpsControl?.operatorTakeover) {
       await appendTrace({
@@ -6443,6 +6494,7 @@ var createVoiceSession = (options) => {
     await ensureAdapter();
     warmTTSSession();
     kickCallSilenceWatchdog();
+    kickStuckCloseWatchdog();
     startAmdEvaluationTimer();
     if (options.greeting && session.turns.length === 0) {
       await speakResolvedLine(options.greeting, session);
@@ -6588,6 +6640,7 @@ var createVoiceSession = (options) => {
     });
     clearSilenceTimer();
     clearCallSilenceWatchdog();
+    clearStuckCloseWatchdog();
     clearAmdEvaluationTimer();
     if (options.noiseSuppressor?.close) {
       try {
@@ -39705,6 +39758,7 @@ var voice = (config) => {
       greeting: config.greeting,
       resumeGreeting: config.resumeGreeting,
       sttRecoveryLine: config.sttRecoveryLine,
+      stuckCallClose: config.stuckCallClose,
       handoff: config.handoff,
       languageStrategy: config.languageStrategy,
       lexicon,

package/dist/testing/index.js

@@ -6506,6 +6506,51 @@ var createVoiceSession = (options) => {
     clearCallSilenceWatchdog();
     callSilenceWatchdog = setTimeout(fireCallSilenceTimeout, callSilenceTimeoutMs);
   };
+  const stuckCloseConfig = options.stuckCallClose;
+  const stuckCloseAfterMs = stuckCloseConfig && stuckCloseConfig.afterMs > 0 ? stuckCloseConfig.afterMs : undefined;
+  let stuckCloseWatchdog = null;
+  let stuckCloseFired = false;
+  const clearStuckCloseWatchdog = () => {
+    if (stuckCloseWatchdog) {
+      clearTimeout(stuckCloseWatchdog);
+      stuckCloseWatchdog = null;
+    }
+  };
+  const fireStuckClose = () => {
+    stuckCloseWatchdog = null;
+    if (stuckCloseFired) {
+      return;
+    }
+    stuckCloseFired = true;
+    runSerial("stuck-call-close", async () => {
+      const snapshot = await readSession();
+      if (snapshot.status === "completed" || snapshot.status === "failed" || snapshot.call?.endedAt) {
+        return;
+      }
+      await appendTrace({
+        payload: {
+          action: "stuck-call-close",
+          reason: `no caller progress for ${stuckCloseAfterMs}ms`
+        },
+        session: snapshot,
+        type: "session.error"
+      });
+      if (stuckCloseConfig?.line) {
+        await speakResolvedLine(stuckCloseConfig.line, snapshot);
+      }
+      await completeInternal(undefined, {
+        disposition: "completed",
+        reason: stuckCloseConfig?.reason ?? "stuck-call-close"
+      });
+    });
+  };
+  const kickStuckCloseWatchdog = () => {
+    if (stuckCloseAfterMs === undefined || stuckCloseFired) {
+      return;
+    }
+    clearStuckCloseWatchdog();
+    stuckCloseWatchdog = setTimeout(fireStuckClose, stuckCloseAfterMs);
+  };
   const recordingConfig = options.recording;
   const recordingChannels = new Set(recordingConfig?.channels ?? ["assistant", "user"]);
   const recordingMaxBytes = recordingConfig?.maxBytesPerChannel ?? 50 * 1024 * 1024;
@@ -7002,6 +7047,7 @@ var createVoiceSession = (options) => {
       type: "error"
     });
     clearCallSilenceWatchdog();
+    clearStuckCloseWatchdog();
     clearAmdEvaluationTimer();
     await closeTTSSession("failed");
     await closeAdapter("failed");
@@ -7111,6 +7157,7 @@ var createVoiceSession = (options) => {
       type: "complete"
     });
     clearCallSilenceWatchdog();
+    clearStuckCloseWatchdog();
     clearAmdEvaluationTimer();
     await closeTTSSession("complete");
     await closeAdapter("complete");
@@ -7588,6 +7635,9 @@ var createVoiceSession = (options) => {
     };
   };
   const handlePartial = async (transcript) => {
+    if (transcript.text.trim()) {
+      kickStuckCloseWatchdog();
+    }
     if (activeTTSTurnId !== undefined) {
       const triggeringText = transcript.text.trim();
       if (triggeringText) {
@@ -8062,6 +8112,7 @@ var createVoiceSession = (options) => {
   };
   const completeTurn = async (session, turn) => {
     console.error(`[voice] completeTurn ENTER session=${options.id} turn=${turn.id} textLen=${turn.text?.length ?? 0}`);
+    kickStuckCloseWatchdog();
     const liveOpsControl = await options.liveOps?.getControl(options.id);
     if (liveOpsControl?.assistantPaused || liveOpsControl?.operatorTakeover) {
       await appendTrace({
@@ -8763,6 +8814,7 @@ var createVoiceSession = (options) => {
     await ensureAdapter();
     warmTTSSession();
     kickCallSilenceWatchdog();
+    kickStuckCloseWatchdog();
     startAmdEvaluationTimer();
     if (options.greeting && session.turns.length === 0) {
       await speakResolvedLine(options.greeting, session);
@@ -8908,6 +8960,7 @@ var createVoiceSession = (options) => {
     });
     clearSilenceTimer();
     clearCallSilenceWatchdog();
+    clearStuckCloseWatchdog();
     clearAmdEvaluationTimer();
     if (options.noiseSuppressor?.close) {
       try {

package/package.json

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