@absolutejs/voice 0.0.22-beta.588 → 0.0.22-beta.589

package/dist/core/types.d.ts

@@ -613,6 +613,17 @@ export type VoiceRouteConfig<TContext = unknown, TSession extends VoiceSessionRe
         session: TSession;
         api: VoiceSessionHandle<TContext, TSession, TResult>;
     }) => Promise<void> | void;
+    /** Fires when a connect RESUMES an existing session (a reconnect, or a fresh
+     *  process after a restart finding the session in a persistent store) instead
+     *  of starting a new call — onCallStart/onSession do NOT fire on a resume.
+     *  Use it to rebuild any per-session in-memory state (caller context, paced
+     *  flags) that didn't survive the process, so the resumed call keeps the
+     *  personalization the original had. Runs before the resume re-greeting. */
+    onResume?: (input: {
+        context: TContext;
+        session: TSession;
+        api: VoiceSessionHandle<TContext, TSession, TResult>;
+    }) => Promise<void> | void;
     correctTurn?: VoiceTurnCorrectionHandler<TContext, TSession, TResult>;
     onTurn: VoiceOnTurnHandler<TContext, TSession, TResult>;
     onComplete: (input: {
@@ -764,6 +775,9 @@ export type VoicePluginConfig<TContext = unknown, TSession extends VoiceSessionR
     greeting?: string | ((input: {
         session: TSession;
     }) => string | Promise<string>);
+    resumeGreeting?: string | ((input: {
+        session: TSession;
+    }) => string | Promise<string>);
     languageStrategy?: VoiceLanguageStrategy;
     lexicon?: VoiceLexiconEntry[] | VoiceLexiconResolver<TContext>;
     phraseHints?: VoicePhraseHint[] | VoicePhraseHintResolver<TContext>;
@@ -893,6 +907,14 @@ export type CreateVoiceSessionOptions<TContext = unknown, TSession extends Voice
     greeting?: string | ((input: {
         session: TSession;
     }) => string | Promise<string>);
+    /** Spoken on a RESUME (reconnect / restart) of a call that already had at
+     *  least one committed turn — a short re-orientation ("Sorry, you cut out —
+     *  you were telling me about X; go on") so the caller knows they're back,
+     *  since the in-flight assistant audio didn't survive. Receives the session so
+     *  it can reference the last turn. No resume greeting fires if unset. */
+    resumeGreeting?: string | ((input: {
+        session: TSession;
+    }) => string | Promise<string>);
     stt?: STTAdapter;
     realtime?: RealtimeAdapter;
     realtimeInputFormat?: AudioFormat;

package/dist/index.js

@@ -6155,6 +6155,7 @@ var createVoiceSession = (options) => {
       type: "session"
     });
     await sendReplay(session);
+    const isResume = !shouldFireOnSession;
     if (shouldFireOnSession) {
       await options.route.onCallStart?.({
         api,
@@ -6166,6 +6167,12 @@ var createVoiceSession = (options) => {
         context: options.context,
         session
       });
+    } else {
+      await options.route.onResume?.({
+        api,
+        context: options.context,
+        session
+      });
     }
     if (session.status === "completed") {
       await send({
@@ -6179,27 +6186,31 @@ var createVoiceSession = (options) => {
     warmTTSSession();
     kickCallSilenceWatchdog();
     startAmdEvaluationTimer();
-    if (shouldFireOnSession && options.greeting && session.turns.length === 0) {
-      const greetingText = typeof options.greeting === "function" ? await options.greeting({ session }) : options.greeting;
-      const greetingTurnId = createId();
-      await send({
-        text: greetingText,
-        turnId: greetingTurnId,
-        type: "assistant"
-      });
+    const speakAssistantLine = async (text) => {
+      if (!text.trim()) {
+        return;
+      }
+      const lineTurnId = createId();
+      await send({ text, turnId: lineTurnId, type: "assistant" });
       try {
-        const greetingTTSSession = await ensureTTSSession();
-        if (greetingTTSSession) {
-          activeTTSTurnId = greetingTurnId;
-          await greetingTTSSession.send(greetingText);
+        const lineTTSSession = await ensureTTSSession();
+        if (lineTTSSession) {
+          activeTTSTurnId = lineTurnId;
+          await lineTTSSession.send(text);
           lastTtsSendAt = Date.now();
         } else if (options.realtime) {
-          const greetingRealtimeSession = await ensureAdapter();
-          activeTTSTurnId = greetingTurnId;
-          await greetingRealtimeSession.send(greetingText);
+          const lineRealtimeSession = await ensureAdapter();
+          activeTTSTurnId = lineTurnId;
+          await lineRealtimeSession.send(text);
           lastTtsSendAt = Date.now();
         }
       } catch {}
+    };
+    const resolveLine = async (line) => typeof line === "function" ? line({ session }) : line;
+    if (options.greeting && session.turns.length === 0) {
+      await speakAssistantLine(await resolveLine(options.greeting));
+    } else if (isResume && options.resumeGreeting && session.turns.length > 0) {
+      await speakAssistantLine(await resolveLine(options.resumeGreeting));
     }
   };
   const disconnectInternal = async (event) => {
@@ -39348,6 +39359,7 @@ var voice = (config) => {
       context,
       id: sessionId,
       greeting: config.greeting,
+      resumeGreeting: config.resumeGreeting,
       handoff: config.handoff,
       languageStrategy: config.languageStrategy,
       lexicon,

package/dist/testing/index.js

@@ -8382,6 +8382,7 @@ var createVoiceSession = (options) => {
       type: "session"
     });
     await sendReplay(session);
+    const isResume = !shouldFireOnSession;
     if (shouldFireOnSession) {
       await options.route.onCallStart?.({
         api,
@@ -8393,6 +8394,12 @@ var createVoiceSession = (options) => {
         context: options.context,
         session
       });
+    } else {
+      await options.route.onResume?.({
+        api,
+        context: options.context,
+        session
+      });
     }
     if (session.status === "completed") {
       await send({
@@ -8406,27 +8413,31 @@ var createVoiceSession = (options) => {
     warmTTSSession();
     kickCallSilenceWatchdog();
     startAmdEvaluationTimer();
-    if (shouldFireOnSession && options.greeting && session.turns.length === 0) {
-      const greetingText = typeof options.greeting === "function" ? await options.greeting({ session }) : options.greeting;
-      const greetingTurnId = createId();
-      await send({
-        text: greetingText,
-        turnId: greetingTurnId,
-        type: "assistant"
-      });
+    const speakAssistantLine = async (text) => {
+      if (!text.trim()) {
+        return;
+      }
+      const lineTurnId = createId();
+      await send({ text, turnId: lineTurnId, type: "assistant" });
       try {
-        const greetingTTSSession = await ensureTTSSession();
-        if (greetingTTSSession) {
-          activeTTSTurnId = greetingTurnId;
-          await greetingTTSSession.send(greetingText);
+        const lineTTSSession = await ensureTTSSession();
+        if (lineTTSSession) {
+          activeTTSTurnId = lineTurnId;
+          await lineTTSSession.send(text);
           lastTtsSendAt = Date.now();
         } else if (options.realtime) {
-          const greetingRealtimeSession = await ensureAdapter();
-          activeTTSTurnId = greetingTurnId;
-          await greetingRealtimeSession.send(greetingText);
+          const lineRealtimeSession = await ensureAdapter();
+          activeTTSTurnId = lineTurnId;
+          await lineRealtimeSession.send(text);
           lastTtsSendAt = Date.now();
         }
       } catch {}
+    };
+    const resolveLine = async (line) => typeof line === "function" ? line({ session }) : line;
+    if (options.greeting && session.turns.length === 0) {
+      await speakAssistantLine(await resolveLine(options.greeting));
+    } else if (isResume && options.resumeGreeting && session.turns.length > 0) {
+      await speakAssistantLine(await resolveLine(options.resumeGreeting));
     }
   };
   const disconnectInternal = async (event) => {

package/package.json

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