@absolutejs/voice 0.0.22-beta.554 → 0.0.22-beta.556

package/dist/core/modelAdapters.d.ts

@@ -13,6 +13,14 @@ export type OpenAIVoiceAssistantModelOptions = {
     model?: string;
     onUsage?: (usage: Record<string, unknown>) => Promise<void> | void;
     temperature?: number;
+    /**
+     * Hard cap on a single /responses stream. Aborts via AbortController if
+     * the stream doesn't complete in time. Default 60s — generous for typical
+     * gpt-4.1-mini conversational turns (1-3s) but catches infinite hangs
+     * (server-side stream stalls observed on rare complex inputs). On timeout
+     * the agent loop falls through to default-silent-turn-ack.
+     */
+    timeoutMs?: number;
 };
 export type AnthropicVoiceAssistantModelOptions = {
     apiKey: string;

package/dist/index.js

@@ -5253,6 +5253,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}`);
     const liveOpsControl = await options.liveOps?.getControl(options.id);
     if (liveOpsControl?.assistantPaused || liveOpsControl?.operatorTakeover) {
       await appendTrace({
@@ -5303,17 +5304,41 @@ var createVoiceSession = (options) => {
         });
       }, fillerDelayMs);
     }
-    const committedOutput = await options.route.onTurn({
-      api,
-      context: options.context,
-      liveOps: liveOpsControl ? {
-        control: liveOpsControl,
-        injectedInstruction
-      } : undefined,
-      onTextDelta: ttsStreamer?.push,
-      session,
-      turn
-    });
+    let committedOutput;
+    const onTurnStartedAt = Date.now();
+    try {
+      committedOutput = await options.route.onTurn({
+        api,
+        context: options.context,
+        liveOps: liveOpsControl ? {
+          control: liveOpsControl,
+          injectedInstruction
+        } : undefined,
+        onTextDelta: ttsStreamer?.push,
+        session,
+        turn
+      });
+    } catch (error) {
+      const message = toError(error).message;
+      logger.warn("voice route.onTurn failed", {
+        elapsedMs: Date.now() - onTurnStartedAt,
+        error: message,
+        sessionId: options.id,
+        turnId: turn.id
+      });
+      console.error(`[voice] onTurn failed for session ${options.id} turn ${turn.id} after ${Date.now() - onTurnStartedAt}ms:`, message);
+      await appendTrace({
+        payload: {
+          elapsedMs: Date.now() - onTurnStartedAt,
+          error: message,
+          stage: "route.onTurn"
+        },
+        session,
+        turnId: turn.id,
+        type: "session.error"
+      });
+      committedOutput = undefined;
+    }
     const output = {
       assistantText: committedOutput?.assistantText,
       citations: committedOutput?.citations,
@@ -45106,41 +45131,61 @@ var createOpenAIVoiceAssistantModel = (options) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
   const baseUrl = options.baseUrl ?? "https://api.openai.com/v1";
   const model = options.model ?? "gpt-4.1-mini";
+  const timeoutMs = options.timeoutMs ?? 60000;
   return {
     generate: async (input) => {
-      const response = await fetchImpl(`${baseUrl.replace(/\/$/, "")}/responses`, {
-        body: JSON.stringify({
-          input: messagesToOpenAIInput(input.messages),
-          instructions: [input.system, VOICE_SYSTEM_INSTRUCTIONS].filter(Boolean).join(`
+      const ac = new AbortController;
+      const timer = setTimeout(() => {
+        ac.abort(new Error(`OpenAI /responses timed out after ${timeoutMs}ms (no completion event received)`));
+      }, timeoutMs);
+      let response;
+      try {
+        response = await fetchImpl(`${baseUrl.replace(/\/$/, "")}/responses`, {
+          body: JSON.stringify({
+            input: messagesToOpenAIInput(input.messages),
+            instructions: [input.system, VOICE_SYSTEM_INSTRUCTIONS].filter(Boolean).join(`
 
 `),
-          max_output_tokens: options.maxOutputTokens,
-          model,
-          stream: true,
-          temperature: options.temperature,
-          tool_choice: input.tools.length ? "auto" : "none",
-          tools: input.tools.map((tool) => ({
-            description: tool.description,
-            name: tool.name,
-            parameters: tool.parameters ?? {
-              additionalProperties: true,
-              type: "object"
-            },
-            strict: false,
-            type: "function"
-          }))
-        }),
-        headers: {
-          accept: "text/event-stream",
-          authorization: `Bearer ${options.apiKey}`,
-          "content-type": "application/json"
-        },
-        method: "POST"
-      });
+            max_output_tokens: options.maxOutputTokens,
+            model,
+            stream: true,
+            temperature: options.temperature,
+            tool_choice: input.tools.length ? "auto" : "none",
+            tools: input.tools.map((tool) => ({
+              description: tool.description,
+              name: tool.name,
+              parameters: tool.parameters ?? {
+                additionalProperties: true,
+                type: "object"
+              },
+              strict: false,
+              type: "function"
+            }))
+          }),
+          headers: {
+            accept: "text/event-stream",
+            authorization: `Bearer ${options.apiKey}`,
+            "content-type": "application/json"
+          },
+          method: "POST",
+          signal: ac.signal
+        });
+      } catch (error) {
+        clearTimeout(timer);
+        throw error;
+      }
       if (!response.ok) {
+        clearTimeout(timer);
         throw createHTTPError("OpenAI", response);
       }
-      const { assistantText, toolCalls, usage } = await consumeOpenAIResponsesStream(response, input.onTextDelta);
+      let assistantText;
+      let toolCalls;
+      let usage;
+      try {
+        ({ assistantText, toolCalls, usage } = await consumeOpenAIResponsesStream(response, input.onTextDelta));
+      } finally {
+        clearTimeout(timer);
+      }
       if (usage) {
         await options.onUsage?.(usage);
       }

package/dist/testing/index.js

@@ -4600,41 +4600,61 @@ var createOpenAIVoiceAssistantModel = (options) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
   const baseUrl = options.baseUrl ?? "https://api.openai.com/v1";
   const model = options.model ?? "gpt-4.1-mini";
+  const timeoutMs = options.timeoutMs ?? 60000;
   return {
     generate: async (input) => {
-      const response = await fetchImpl(`${baseUrl.replace(/\/$/, "")}/responses`, {
-        body: JSON.stringify({
-          input: messagesToOpenAIInput(input.messages),
-          instructions: [input.system, VOICE_SYSTEM_INSTRUCTIONS].filter(Boolean).join(`
+      const ac = new AbortController;
+      const timer = setTimeout(() => {
+        ac.abort(new Error(`OpenAI /responses timed out after ${timeoutMs}ms (no completion event received)`));
+      }, timeoutMs);
+      let response;
+      try {
+        response = await fetchImpl(`${baseUrl.replace(/\/$/, "")}/responses`, {
+          body: JSON.stringify({
+            input: messagesToOpenAIInput(input.messages),
+            instructions: [input.system, VOICE_SYSTEM_INSTRUCTIONS].filter(Boolean).join(`
 
 `),
-          max_output_tokens: options.maxOutputTokens,
-          model,
-          stream: true,
-          temperature: options.temperature,
-          tool_choice: input.tools.length ? "auto" : "none",
-          tools: input.tools.map((tool) => ({
-            description: tool.description,
-            name: tool.name,
-            parameters: tool.parameters ?? {
-              additionalProperties: true,
-              type: "object"
-            },
-            strict: false,
-            type: "function"
-          }))
-        }),
-        headers: {
-          accept: "text/event-stream",
-          authorization: `Bearer ${options.apiKey}`,
-          "content-type": "application/json"
-        },
-        method: "POST"
-      });
+            max_output_tokens: options.maxOutputTokens,
+            model,
+            stream: true,
+            temperature: options.temperature,
+            tool_choice: input.tools.length ? "auto" : "none",
+            tools: input.tools.map((tool) => ({
+              description: tool.description,
+              name: tool.name,
+              parameters: tool.parameters ?? {
+                additionalProperties: true,
+                type: "object"
+              },
+              strict: false,
+              type: "function"
+            }))
+          }),
+          headers: {
+            accept: "text/event-stream",
+            authorization: `Bearer ${options.apiKey}`,
+            "content-type": "application/json"
+          },
+          method: "POST",
+          signal: ac.signal
+        });
+      } catch (error) {
+        clearTimeout(timer);
+        throw error;
+      }
       if (!response.ok) {
+        clearTimeout(timer);
         throw createHTTPError("OpenAI", response);
       }
-      const { assistantText, toolCalls, usage } = await consumeOpenAIResponsesStream(response, input.onTextDelta);
+      let assistantText;
+      let toolCalls;
+      let usage;
+      try {
+        ({ assistantText, toolCalls, usage } = await consumeOpenAIResponsesStream(response, input.onTextDelta));
+      } finally {
+        clearTimeout(timer);
+      }
       if (usage) {
         await options.onUsage?.(usage);
       }
@@ -7070,6 +7090,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}`);
     const liveOpsControl = await options.liveOps?.getControl(options.id);
     if (liveOpsControl?.assistantPaused || liveOpsControl?.operatorTakeover) {
       await appendTrace({
@@ -7120,17 +7141,41 @@ var createVoiceSession = (options) => {
         });
       }, fillerDelayMs);
     }
-    const committedOutput = await options.route.onTurn({
-      api,
-      context: options.context,
-      liveOps: liveOpsControl ? {
-        control: liveOpsControl,
-        injectedInstruction
-      } : undefined,
-      onTextDelta: ttsStreamer?.push,
-      session,
-      turn
-    });
+    let committedOutput;
+    const onTurnStartedAt = Date.now();
+    try {
+      committedOutput = await options.route.onTurn({
+        api,
+        context: options.context,
+        liveOps: liveOpsControl ? {
+          control: liveOpsControl,
+          injectedInstruction
+        } : undefined,
+        onTextDelta: ttsStreamer?.push,
+        session,
+        turn
+      });
+    } catch (error) {
+      const message = toError(error).message;
+      logger.warn("voice route.onTurn failed", {
+        elapsedMs: Date.now() - onTurnStartedAt,
+        error: message,
+        sessionId: options.id,
+        turnId: turn.id
+      });
+      console.error(`[voice] onTurn failed for session ${options.id} turn ${turn.id} after ${Date.now() - onTurnStartedAt}ms:`, message);
+      await appendTrace({
+        payload: {
+          elapsedMs: Date.now() - onTurnStartedAt,
+          error: message,
+          stage: "route.onTurn"
+        },
+        session,
+        turnId: turn.id,
+        type: "session.error"
+      });
+      committedOutput = undefined;
+    }
     const output = {
       assistantText: committedOutput?.assistantText,
       citations: committedOutput?.citations,

package/package.json

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