@absolutejs/voice 0.0.22-beta.616 → 0.0.22-beta.618

package/dist/core/modelAdapters.d.ts

@@ -46,6 +46,10 @@ export type VoiceProviderRouterEvent<TProvider extends string = string> = {
     at: number;
     attempt: number;
     elapsedMs: number;
+    /** Set when this event marks a provider returning an empty completion (no text
+     *  and no tool call) that triggered a same-provider retry — so consumers can
+     *  track how often the model glitches empty, and whether the retry recovered. */
+    emptyCompletion?: boolean;
     error?: string;
     fallbackProvider?: TProvider;
     latencyBudgetMs?: number;
@@ -139,6 +143,14 @@ export type VoiceProviderRouterOptions<TContext = unknown, TSession extends Voic
     allowProviders?: readonly TProvider[] | ((input: VoiceAgentModelInput<TContext, TSession>) => readonly TProvider[] | Promise<readonly TProvider[]>);
     fallback?: TProvider[] | ((input: VoiceAgentModelInput<TContext, TSession>) => readonly TProvider[] | Promise<readonly TProvider[]>);
     fallbackMode?: VoiceProviderRouterFallbackMode;
+    /** Retry the SAME provider this many times when it returns a non-error but
+     *  EMPTY completion (no assistant text AND no tool call) before accepting it.
+     *  An empty completion is a transient model glitch (observed on OpenAI
+     *  /responses returning a 200 with zero output items mid-conversation), NOT a
+     *  provider error — so it bypasses fallbackMode and never suppresses provider
+     *  health. Without this a one-off empty surfaces to the app as a dead turn
+     *  (the caller hears a re-engage / "go on, I'm listening" loop). Default 1. */
+    emptyCompletionRetries?: number;
     isProviderError?: (error: unknown, provider: TProvider) => boolean;
     isRateLimitError?: (error: unknown, provider: TProvider) => boolean;
     isTimeoutError?: (error: unknown, provider: TProvider) => boolean;

package/dist/index.js

@@ -39579,6 +39579,7 @@ var voice = (config) => {
   const monitorBindings = new Map;
   const runtime = {
     activeSessions: new Map,
+    pendingSessions: new Map,
     logger: resolveLogger(config.logger),
     profileSwitchGuardAutoSwitchCounts: new Map,
     profileSwitchGuardedSessions: new Set,
@@ -39738,6 +39739,31 @@ var voice = (config) => {
       turnDetection: sessionOptions.turnDetection
     });
   };
+  const createAndConnectSession = async (ws, sessionId, scenarioId) => {
+    const session = await createManagedSession(ws, sessionId, scenarioId);
+    const typedSession = session;
+    runtime.activeSessions.set(sessionId, typedSession);
+    registerMonitorSession(sessionId, typedSession);
+    await session.connect(buildSocketAdapter(ws, sessionId));
+    return typedSession;
+  };
+  const ensureManagedSession = async (ws, sessionId, scenarioId) => {
+    const active = runtime.activeSessions.get(sessionId);
+    if (active) {
+      return active;
+    }
+    const inFlight = runtime.pendingSessions.get(sessionId);
+    if (inFlight) {
+      return inFlight;
+    }
+    const creation = createAndConnectSession(ws, sessionId, scenarioId);
+    runtime.pendingSessions.set(sessionId, creation);
+    try {
+      return await creation;
+    } finally {
+      runtime.pendingSessions.delete(sessionId);
+    }
+  };
   const mountSurface = (app, value, factory) => {
     if (value === undefined || value === false) {
       return app;
@@ -39950,13 +39976,7 @@ var voice = (config) => {
       if (!audio) {
         return;
       }
-      const session = current ?? await createManagedSession(ws, sessionState.sessionId, sessionState.scenarioId ?? undefined);
-      if (!current) {
-        const typedSession = session;
-        runtime.activeSessions.set(sessionState.sessionId, typedSession);
-        registerMonitorSession(sessionState.sessionId, typedSession);
-        await session.connect(buildSocketAdapter(ws, sessionState.sessionId));
-      }
+      const session = current ?? await ensureManagedSession(ws, sessionState.sessionId, sessionState.scenarioId ?? undefined);
       await session.receiveAudio(audio);
     },
     open: async (ws) => {
@@ -39967,11 +39987,7 @@ var voice = (config) => {
         runtime.activeSessions.delete(sessionState.sessionId);
         deregisterMonitorSession(sessionState.sessionId, "superseded");
       }
-      const session = await createManagedSession(ws, sessionState.sessionId, sessionState.scenarioId ?? undefined);
-      const typedSession = session;
-      runtime.activeSessions.set(sessionState.sessionId, typedSession);
-      registerMonitorSession(sessionState.sessionId, typedSession);
-      await session.connect(buildSocketAdapter(ws, sessionState.sessionId));
+      await ensureManagedSession(ws, sessionState.sessionId, sessionState.scenarioId ?? undefined);
     }
   }).use(htmxRoutes()).use(surfaceRoutes());
 };
@@ -45454,6 +45470,7 @@ var createJSONVoiceAssistantModel = (options) => ({
     return options.mapOutput?.(output) ?? normalizeRouteOutput(output);
   }
 });
+var isEmptyModelOutput = (output) => !output.assistantText?.trim() && !output.toolCalls?.length;
 var createVoiceProviderRouter = (options) => {
   const providerIds = Object.keys(options.providers);
   const firstProvider = providerIds[0];
@@ -45461,6 +45478,7 @@ var createVoiceProviderRouter = (options) => {
   const policy = resolveVoiceProviderRoutingPolicy(options.policy) ?? resolveVoiceProviderRoutingPolicy(orchestrationSurface?.policy);
   const strategy = policy?.strategy ?? "prefer-selected";
   const fallbackMode = policy?.fallbackMode ?? options.fallbackMode ?? orchestrationSurface?.fallbackMode ?? "provider-error";
+  const emptyCompletionRetries = Math.max(0, options.emptyCompletionRetries ?? 1);
   const providerProfiles = {
     ...orchestrationSurface?.providerProfiles ?? {},
     ...options.providerProfiles ?? {}
@@ -45635,6 +45653,24 @@ var createVoiceProviderRouter = (options) => {
       }
     }
   };
+  const runProviderWithEmptyRetry = async (provider, model, input, index, selectedProvider, startedAt) => {
+    let output = await runProvider(provider, model, input);
+    let emptyAttempt = 0;
+    while (emptyAttempt < emptyCompletionRetries && isEmptyModelOutput(output)) {
+      emptyAttempt += 1;
+      await emit({
+        at: Date.now(),
+        attempt: index + 1,
+        elapsedMs: Date.now() - startedAt,
+        emptyCompletion: true,
+        provider,
+        selectedProvider,
+        status: "success"
+      }, input);
+      output = await runProvider(provider, model, input);
+    }
+    return output;
+  };
   return {
     generate: async (input) => {
       const { order, selectedProvider } = await resolveOrder(input);
@@ -45649,7 +45685,7 @@ var createVoiceProviderRouter = (options) => {
         }
         const startedAt = Date.now();
         try {
-          const output = await runProvider(provider, model, input);
+          const output = await runProviderWithEmptyRetry(provider, model, input, index, selectedProvider, startedAt);
           const providerHealth = recordProviderSuccess(provider);
           await emit({
             at: Date.now(),
@@ -45934,10 +45970,21 @@ var finalizeToolCalls = (calls) => [...calls.values()].filter((call) => call.nam
 var consumeOpenAIResponsesStream = async (response, onTextDelta, abortOptions) => {
   let assistantText = "";
   let usage;
+  let status;
+  let incompleteReason;
+  let refusal = "";
+  let failureMessage;
+  let outputItems = 0;
   const calls = new Map;
   await readServerSentEvents(response, (event) => {
     const type = typeof event.type === "string" ? event.type : "";
     const item = event.item;
+    if (type === "response.output_item.added") {
+      outputItems += 1;
+    }
+    if ((type === "response.refusal.delta" || type === "response.refusal.done") && typeof event.delta === "string") {
+      refusal += event.delta;
+    }
     if (type === "response.output_text.delta" && typeof event.delta === "string") {
       assistantText += event.delta;
       onTextDelta?.(event.delta);
@@ -45955,14 +46002,34 @@ var consumeOpenAIResponsesStream = async (response, onTextDelta, abortOptions) =
       const entry = calls.get(String(item.id ?? item.call_id ?? ""));
       if (entry)
         entry.args = item.arguments;
-    } else if (type === "response.completed") {
+    } else if (type === "response.completed" || type === "response.incomplete" || type === "response.failed") {
       const completed = event.response;
       if (completed?.usage && typeof completed.usage === "object") {
         usage = completed.usage;
       }
+      if (typeof completed?.status === "string") {
+        status = completed.status;
+      }
+      const incomplete = completed?.incomplete_details;
+      if (typeof incomplete?.reason === "string") {
+        incompleteReason = incomplete.reason;
+      }
+      const failure = completed?.error;
+      if (typeof failure?.message === "string") {
+        failureMessage = failure.message;
+      }
     }
   }, abortOptions);
-  return { assistantText, toolCalls: finalizeToolCalls(calls), usage };
+  return {
+    assistantText,
+    failureMessage,
+    incompleteReason,
+    outputItems,
+    refusal: refusal || undefined,
+    status,
+    toolCalls: finalizeToolCalls(calls),
+    usage
+  };
 };
 var createOpenAIVoiceAssistantModel = (options) => {
   const fetchImpl = hardenFetch(options.fetch);
@@ -46023,6 +46090,11 @@ var createOpenAIVoiceAssistantModel = (options) => {
       let assistantText;
       let toolCalls;
       let usage;
+      let status;
+      let incompleteReason;
+      let refusal;
+      let failureMessage;
+      let outputItems = 0;
       let firstDeltaSeen = false;
       const onTextDelta = input.onTextDelta ? (delta) => {
         if (!firstDeltaSeen) {
@@ -46032,7 +46104,16 @@ var createOpenAIVoiceAssistantModel = (options) => {
         input.onTextDelta?.(delta);
       } : undefined;
       try {
-        ({ assistantText, toolCalls, usage } = await consumeOpenAIResponsesStream(response, onTextDelta, {
+        ({
+          assistantText,
+          toolCalls,
+          usage,
+          status,
+          incompleteReason,
+          refusal,
+          failureMessage,
+          outputItems
+        } = await consumeOpenAIResponsesStream(response, onTextDelta, {
           signal: ac.signal,
           inactivityMs: 1e4
         }));
@@ -46040,6 +46121,15 @@ var createOpenAIVoiceAssistantModel = (options) => {
           textChars: assistantText?.length ?? 0,
           toolCalls: toolCalls.length
         });
+        if (!assistantText?.trim() && !toolCalls.length) {
+          stamp("openai.empty-completion", {
+            failureMessage: failureMessage ?? "none",
+            incompleteReason: incompleteReason ?? "none",
+            outputItems,
+            refusal: refusal ? refusal.slice(0, 200) : "none",
+            status: status ?? "unknown"
+          });
+        }
       } finally {
         clearTimeout(timer);
       }

package/dist/testing/index.js

@@ -4477,6 +4477,7 @@ var createJSONVoiceAssistantModel = (options) => ({
     return options.mapOutput?.(output) ?? normalizeRouteOutput(output);
   }
 });
+var isEmptyModelOutput = (output) => !output.assistantText?.trim() && !output.toolCalls?.length;
 var createVoiceProviderRouter = (options) => {
   const providerIds = Object.keys(options.providers);
   const firstProvider = providerIds[0];
@@ -4484,6 +4485,7 @@ var createVoiceProviderRouter = (options) => {
   const policy = resolveVoiceProviderRoutingPolicy(options.policy) ?? resolveVoiceProviderRoutingPolicy(orchestrationSurface?.policy);
   const strategy = policy?.strategy ?? "prefer-selected";
   const fallbackMode = policy?.fallbackMode ?? options.fallbackMode ?? orchestrationSurface?.fallbackMode ?? "provider-error";
+  const emptyCompletionRetries = Math.max(0, options.emptyCompletionRetries ?? 1);
   const providerProfiles = {
     ...orchestrationSurface?.providerProfiles ?? {},
     ...options.providerProfiles ?? {}
@@ -4658,6 +4660,24 @@ var createVoiceProviderRouter = (options) => {
       }
     }
   };
+  const runProviderWithEmptyRetry = async (provider, model, input, index, selectedProvider, startedAt) => {
+    let output = await runProvider(provider, model, input);
+    let emptyAttempt = 0;
+    while (emptyAttempt < emptyCompletionRetries && isEmptyModelOutput(output)) {
+      emptyAttempt += 1;
+      await emit({
+        at: Date.now(),
+        attempt: index + 1,
+        elapsedMs: Date.now() - startedAt,
+        emptyCompletion: true,
+        provider,
+        selectedProvider,
+        status: "success"
+      }, input);
+      output = await runProvider(provider, model, input);
+    }
+    return output;
+  };
   return {
     generate: async (input) => {
       const { order, selectedProvider } = await resolveOrder(input);
@@ -4672,7 +4692,7 @@ var createVoiceProviderRouter = (options) => {
         }
         const startedAt = Date.now();
         try {
-          const output = await runProvider(provider, model, input);
+          const output = await runProviderWithEmptyRetry(provider, model, input, index, selectedProvider, startedAt);
           const providerHealth = recordProviderSuccess(provider);
           await emit({
             at: Date.now(),
@@ -4957,10 +4977,21 @@ var finalizeToolCalls = (calls) => [...calls.values()].filter((call) => call.nam
 var consumeOpenAIResponsesStream = async (response, onTextDelta, abortOptions) => {
   let assistantText = "";
   let usage;
+  let status;
+  let incompleteReason;
+  let refusal = "";
+  let failureMessage;
+  let outputItems = 0;
   const calls = new Map;
   await readServerSentEvents(response, (event) => {
     const type = typeof event.type === "string" ? event.type : "";
     const item = event.item;
+    if (type === "response.output_item.added") {
+      outputItems += 1;
+    }
+    if ((type === "response.refusal.delta" || type === "response.refusal.done") && typeof event.delta === "string") {
+      refusal += event.delta;
+    }
     if (type === "response.output_text.delta" && typeof event.delta === "string") {
       assistantText += event.delta;
       onTextDelta?.(event.delta);
@@ -4978,14 +5009,34 @@ var consumeOpenAIResponsesStream = async (response, onTextDelta, abortOptions) =
       const entry = calls.get(String(item.id ?? item.call_id ?? ""));
       if (entry)
         entry.args = item.arguments;
-    } else if (type === "response.completed") {
+    } else if (type === "response.completed" || type === "response.incomplete" || type === "response.failed") {
       const completed = event.response;
       if (completed?.usage && typeof completed.usage === "object") {
         usage = completed.usage;
       }
+      if (typeof completed?.status === "string") {
+        status = completed.status;
+      }
+      const incomplete = completed?.incomplete_details;
+      if (typeof incomplete?.reason === "string") {
+        incompleteReason = incomplete.reason;
+      }
+      const failure = completed?.error;
+      if (typeof failure?.message === "string") {
+        failureMessage = failure.message;
+      }
     }
   }, abortOptions);
-  return { assistantText, toolCalls: finalizeToolCalls(calls), usage };
+  return {
+    assistantText,
+    failureMessage,
+    incompleteReason,
+    outputItems,
+    refusal: refusal || undefined,
+    status,
+    toolCalls: finalizeToolCalls(calls),
+    usage
+  };
 };
 var createOpenAIVoiceAssistantModel = (options) => {
   const fetchImpl = hardenFetch(options.fetch);
@@ -5046,6 +5097,11 @@ var createOpenAIVoiceAssistantModel = (options) => {
       let assistantText;
       let toolCalls;
       let usage;
+      let status;
+      let incompleteReason;
+      let refusal;
+      let failureMessage;
+      let outputItems = 0;
       let firstDeltaSeen = false;
       const onTextDelta = input.onTextDelta ? (delta) => {
         if (!firstDeltaSeen) {
@@ -5055,7 +5111,16 @@ var createOpenAIVoiceAssistantModel = (options) => {
         input.onTextDelta?.(delta);
       } : undefined;
       try {
-        ({ assistantText, toolCalls, usage } = await consumeOpenAIResponsesStream(response, onTextDelta, {
+        ({
+          assistantText,
+          toolCalls,
+          usage,
+          status,
+          incompleteReason,
+          refusal,
+          failureMessage,
+          outputItems
+        } = await consumeOpenAIResponsesStream(response, onTextDelta, {
           signal: ac.signal,
           inactivityMs: 1e4
         }));
@@ -5063,6 +5128,15 @@ var createOpenAIVoiceAssistantModel = (options) => {
           textChars: assistantText?.length ?? 0,
           toolCalls: toolCalls.length
         });
+        if (!assistantText?.trim() && !toolCalls.length) {
+          stamp("openai.empty-completion", {
+            failureMessage: failureMessage ?? "none",
+            incompleteReason: incompleteReason ?? "none",
+            outputItems,
+            refusal: refusal ? refusal.slice(0, 200) : "none",
+            status: status ?? "unknown"
+          });
+        }
       } finally {
         clearTimeout(timer);
       }

package/dist/vue/VoiceProviderSimulationControls.d.ts

@@ -79,10 +79,10 @@ export declare const VoiceProviderSimulationControls: import("vue").DefineCompon
 }>> & Readonly<{}>, {
     kind: string;
     title: string;
+    failureMessage: string;
     fallbackRequiredProvider: string;
     fallbackRequiredMessage: string;
     failureProviders: readonly string[] | undefined;
-    failureMessage: string;
     pathPrefix: string;
     class: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "@absolutejs/voice",
-  "version": "0.0.22-beta.616",
+  "version": "0.0.22-beta.618",
   "description": "Voice primitives and Elysia plugin for AbsoluteJS",
   "repository": {
     "type": "git",
     "url": "https://github.com/absolutejs/voice.git"
   },
+  "homepage": "https://github.com/absolutejs/voice",
+  "bugs": {
+    "url": "https://github.com/absolutejs/voice/issues"
+  },
   "files": [
     "dist",
     "README.md"