@absolutejs/voice 0.0.22-beta.631 → 0.0.22-beta.633

package/dist/core/types.d.ts

@@ -522,6 +522,17 @@ export type VoiceSessionHandle<TContext = unknown, TSession extends VoiceSession
         transferMode?: "cold" | "warm";
     }) => Promise<void>;
     close: (reason?: string) => Promise<void>;
+    /**
+     * Caller-driven in-call pause: the session stays LIVE (socket, state,
+     * transcript) but every idle/silence watchdog is suspended and turn
+     * processing is skipped, so a paused caller is never nudged or hung up on.
+     * Past `pause.maxMs` (default 10 min) the session closes gracefully with
+     * reason "pause-timeout" — completed turns stay durably persisted, so the
+     * host's normal draft/resume path takes over.
+     */
+    pause: () => Promise<void>;
+    /** Lift a caller-driven pause: watchdogs re-arm and turns process again. */
+    resume: () => Promise<void>;
     snapshot: () => Promise<TSession>;
     /**
      * Mutate the live turn-detection config for this session — useful when a
@@ -1016,6 +1027,12 @@ export type CreateVoiceSessionOptions<TContext = unknown, TSession extends Voice
         }) => string | Promise<string>);
         maxReprompts?: number;
     };
+    /** Caller-driven in-call pause (VoiceSessionHandle.pause/resume). `maxMs`
+     *  bounds how long a session may sit paused before it closes gracefully
+     *  with reason "pause-timeout" (default 10 minutes). */
+    pause?: {
+        maxMs?: number;
+    };
     stt?: STTAdapter;
     realtime?: RealtimeAdapter;
     realtimeInputFormat?: AudioFormat;
@@ -1161,7 +1178,7 @@ export type VoiceClientCloseMessage = {
 };
 export type VoiceClientCallControlMessage = {
     type: "call_control";
-    action: "complete" | "escalate" | "no-answer" | "transfer" | "voicemail";
+    action: "complete" | "escalate" | "no-answer" | "pause" | "resume" | "transfer" | "voicemail";
     metadata?: Record<string, unknown>;
     reason?: string;
     target?: string;

package/dist/index.js

@@ -4368,6 +4368,9 @@ var createVoiceSession = (options) => {
     if (callSilenceTimeoutMs === undefined || callSilenceFired) {
       return;
     }
+    if (callerPaused) {
+      return;
+    }
     clearCallSilenceWatchdog();
     callSilenceWatchdog = setTimeout(fireCallSilenceTimeout, callSilenceTimeoutMs);
   };
@@ -4413,6 +4416,9 @@ var createVoiceSession = (options) => {
     if (stuckCloseAfterMs === undefined || stuckCloseFired) {
       return;
     }
+    if (callerPaused) {
+      return;
+    }
     clearStuckCloseWatchdog();
     stuckCloseWatchdog = setTimeout(fireStuckClose, stuckCloseAfterMs);
   };
@@ -4435,6 +4441,9 @@ var createVoiceSession = (options) => {
       idleRepromptsUsed = 0;
     }
     clearIdleRepromptWatchdog();
+    if (callerPaused) {
+      return;
+    }
     if (idleRepromptsUsed >= idleRepromptMax) {
       return;
     }
@@ -4455,6 +4464,60 @@ var createVoiceSession = (options) => {
       });
     }, idleRepromptAfterMs);
   };
+  const PAUSE_MAX_MS_DEFAULT = 600000;
+  const pauseMaxMs = options.pause?.maxMs && options.pause.maxMs > 0 ? options.pause.maxMs : PAUSE_MAX_MS_DEFAULT;
+  let callerPaused = false;
+  let pauseTimeout = null;
+  const clearPauseTimeout = () => {
+    if (pauseTimeout) {
+      clearTimeout(pauseTimeout);
+      pauseTimeout = null;
+    }
+  };
+  const pauseInternal = async () => {
+    if (callerPaused) {
+      return;
+    }
+    const snapshot = await readSession();
+    if (snapshot.status === "completed" || snapshot.status === "failed" || snapshot.call?.endedAt) {
+      return;
+    }
+    callerPaused = true;
+    clearCallSilenceWatchdog();
+    clearStuckCloseWatchdog();
+    clearIdleRepromptWatchdog();
+    clearPauseTimeout();
+    pauseTimeout = setTimeout(() => {
+      pauseTimeout = null;
+      api.close("pause-timeout");
+    }, pauseMaxMs);
+    await appendTrace({
+      payload: {
+        action: "call.paused",
+        maxMs: pauseMaxMs
+      },
+      session: snapshot,
+      type: "call.lifecycle"
+    });
+  };
+  const resumeInternal = async () => {
+    if (!callerPaused) {
+      return;
+    }
+    callerPaused = false;
+    clearPauseTimeout();
+    kickCallSilenceWatchdog();
+    kickStuckCloseWatchdog();
+    kickIdleRepromptWatchdog(true);
+    const snapshot = await readSession();
+    await appendTrace({
+      payload: {
+        action: "call.resumed"
+      },
+      session: snapshot,
+      type: "call.lifecycle"
+    });
+  };
   const recordingConfig = options.recording;
   const recordingChannels = new Set(recordingConfig?.channels ?? ["assistant", "user"]);
   const recordingMaxBytes = recordingConfig?.maxBytesPerChannel ?? 50 * 1024 * 1024;
@@ -4962,6 +5025,7 @@ var createVoiceSession = (options) => {
     clearCallSilenceWatchdog();
     clearStuckCloseWatchdog();
     clearIdleRepromptWatchdog();
+    clearPauseTimeout();
     clearAmdEvaluationTimer();
     await closeTTSSession("failed");
     await closeAdapter("failed");
@@ -5073,6 +5137,7 @@ var createVoiceSession = (options) => {
     clearCallSilenceWatchdog();
     clearStuckCloseWatchdog();
     clearIdleRepromptWatchdog();
+    clearPauseTimeout();
     clearAmdEvaluationTimer();
     await closeTTSSession("complete");
     await closeAdapter("complete");
@@ -6033,6 +6098,19 @@ var createVoiceSession = (options) => {
     }
     kickStuckCloseWatchdog();
     kickIdleRepromptWatchdog(true);
+    if (callerPaused) {
+      await appendTrace({
+        payload: {
+          action: "turn.skipped",
+          reason: "caller-paused",
+          status: "skipped"
+        },
+        session,
+        turnId: turn.id,
+        type: "call.lifecycle"
+      });
+      return;
+    }
     const liveOpsControl = await options.liveOps?.getControl(options.id);
     if (liveOpsControl?.assistantPaused || liveOpsControl?.operatorTakeover) {
       await appendTrace({
@@ -6883,6 +6961,7 @@ var createVoiceSession = (options) => {
     clearCallSilenceWatchdog();
     clearStuckCloseWatchdog();
     clearIdleRepromptWatchdog();
+    clearPauseTimeout();
     clearAmdEvaluationTimer();
     if (options.noiseSuppressor?.close) {
       try {
@@ -6948,9 +7027,15 @@ var createVoiceSession = (options) => {
     markVoicemail: async (input) => runSerial("api.markVoicemail", async () => {
       await markVoicemailInternal(input);
     }),
+    pause: async () => runSerial("api.pause", async () => {
+      await pauseInternal();
+    }),
     receiveAudio: async (audio) => runSerial("api.receiveAudio", async () => {
       await receiveAudioInternal(audio);
     }),
+    resume: async () => runSerial("api.resume", async () => {
+      await resumeInternal();
+    }),
     snapshot: async () => runSerial("api.snapshot", async () => readSession()),
     transfer: async (input) => runSerial("api.transfer", async () => {
       await transferInternal(input);
@@ -39724,7 +39809,7 @@ var isVoiceClientMessage = (value) => {
       if (!("action" in value)) {
         return false;
       }
-      if (value.action !== "complete" && value.action !== "escalate" && value.action !== "no-answer" && value.action !== "transfer" && value.action !== "voicemail") {
+      if (value.action !== "complete" && value.action !== "escalate" && value.action !== "no-answer" && value.action !== "pause" && value.action !== "resume" && value.action !== "transfer" && value.action !== "voicemail") {
         return false;
       }
       return (!("metadata" in value) || value.metadata === undefined || value.metadata !== null && typeof value.metadata === "object") && (!("reason" in value) || value.reason === undefined || typeof value.reason === "string") && (!("target" in value) || value.target === undefined || typeof value.target === "string");
@@ -40313,6 +40398,12 @@ var voice = (config) => {
           if (message.action === "complete") {
             await current.complete();
           }
+          if (message.action === "pause") {
+            await current.pause();
+          }
+          if (message.action === "resume") {
+            await current.resume();
+          }
         }
         if (message.type === "start" && message.sessionId && message.sessionId !== sessionState.sessionId) {
           const currentSession = runtime.activeSessions.get(sessionState.sessionId);
@@ -44373,7 +44464,9 @@ var createContractApi = (session) => ({
   fail: async () => {},
   markNoAnswer: async () => {},
   markVoicemail: async () => {},
+  pause: async () => {},
   receiveAudio: async () => {},
+  resume: async () => {},
   setTurnDetection: async () => ({
     silenceMs: 0,
     speechThreshold: 0,

package/dist/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { VoicePluginConfig, VoiceSessionStore } from "./core/types";
+export declare const manifest: import("@absolutejs/manifest").PackageManifest<VoicePluginConfig, VoiceSessionStore>;