@absolutejs/voice 0.0.22-beta.677 → 0.0.22-beta.678

package/CHANGELOG.md

@@ -6,6 +6,12 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.0.22-beta.678 — 2026-09-27
+
+### Fixed
+
+- **Classify exhausted fetch header deadlines as timeouts with per-attempt metadata, preserve caller cancellation, and expose a configurable header deadline without changing the six-second default.** (`hardenFetch`, `VoiceFetchHeadersTimeoutError`, `HardenFetchOptions`, `createVoiceProviderRouter`, `VoiceProviderRouterEvent`)
+
 ## 0.0.22-beta.677 — 2026-09-16
 
 ### Fixed

package/changelog.json

@@ -2,6 +2,23 @@
 	"contract": 1,
 	"name": "@absolutejs/voice",
 	"releases": [
+		{
+			"changes": [
+				{
+					"kind": "fixed",
+					"summary": "Classify exhausted fetch header deadlines as timeouts with per-attempt metadata, preserve caller cancellation, and expose a configurable header deadline without changing the six-second default.",
+					"symbols": [
+						"hardenFetch",
+						"VoiceFetchHeadersTimeoutError",
+						"HardenFetchOptions",
+						"createVoiceProviderRouter",
+						"VoiceProviderRouterEvent"
+					]
+				}
+			],
+			"date": "2026-09-27",
+			"version": "0.0.22-beta.678"
+		},
 		{
 			"changes": [
 				{

package/dist/client/htmxBootstrap.js

@@ -316,7 +316,7 @@ var serverMessageToAction = (message) => {
   }
 };
 
-// ../../home/alexkahn/abs/voice/node_modules/@absolutejs/media/dist/index.js
+// node_modules/@absolutejs/media/dist/index.js
 var TAU = Math.PI * 2;
 var pushIssue = (issues, severity, code, message) => {
   issues.push({ code, message, severity });

package/dist/core/hardenedFetch.d.ts

@@ -1 +1,9 @@
-export declare const hardenFetch: (baseFetch?: typeof fetch) => (input: Parameters<typeof fetch>[0], init: Parameters<typeof fetch>[1]) => Promise<Response>;
+export declare class VoiceFetchHeadersTimeoutError extends Error {
+    readonly timeoutMs: number;
+    readonly attempt: number;
+    constructor(timeoutMs: number, attempt: number);
+}
+export type HardenFetchOptions = {
+    attemptTimeoutMs?: number;
+};
+export declare const hardenFetch: (baseFetch?: typeof fetch, options?: HardenFetchOptions) => (input: Parameters<typeof fetch>[0], init: Parameters<typeof fetch>[1]) => Promise<Response>;

package/dist/core/modelAdapters.d.ts

@@ -64,7 +64,9 @@ export type VoiceProviderRouterEvent<TProvider extends string = string> = {
     suppressedUntil?: number;
     status: "error" | "fallback" | "success";
     timedOut?: boolean;
-    timeoutKind?: "latency-budget" | "stream-inactivity";
+    timeoutKind?: "latency-budget" | "stream-inactivity" | "response-headers";
+    /** Fetch attempt number within this provider attempt. */
+    fetchAttempt?: number;
     timeoutMs?: number;
     totalElapsedMs?: number;
 };

package/dist/embed/index.js

@@ -313,7 +313,7 @@ var serverMessageToAction = (message) => {
   }
 };
 
-// ../../home/alexkahn/abs/voice/node_modules/@absolutejs/media/dist/index.js
+// node_modules/@absolutejs/media/dist/index.js
 var TAU = Math.PI * 2;
 var pushIssue = (issues, severity, code, message) => {
   issues.push({ code, message, severity });

package/dist/index.d.ts

@@ -72,7 +72,7 @@ export { createVoiceAgent, createVoiceAgentSquad, createVoiceAgentTool, } from "
 export { createPersonaVoiceCaller, createScriptedVoiceCaller, renderVoiceSimulationTranscript, runVoiceConversationSimulation, } from "./core/conversationSimulator";
 export type { RunVoiceConversationSimulationInput, VoiceConversationSimulationEndedReason, VoiceConversationSimulationResult, VoicePersonaCallerCompletion, VoiceScriptedCallerStep, VoiceSimulatedSpeaker, VoiceSimulatedTurn, VoiceSimulatorCaller, VoiceSimulatorCallerModel, VoiceSimulatorCallerReply, } from "./core/conversationSimulator";
 export { logVoiceTiming, startVoiceTimer, voiceTimingEnabled, } from "./core/debugTiming";
-export { hardenFetch } from "./core/hardenedFetch";
+export { hardenFetch, VoiceFetchHeadersTimeoutError, type HardenFetchOptions, } from "./core/hardenedFetch";
 export { createVoiceMCPToolset } from "./core/mcpToolset";
 export type { CreateVoiceMCPToolsetOptions, MCPClientLike, MCPToolCallResult, MCPToolContentBlock, MCPToolDefinition, VoiceMCPToolResult, } from "./core/mcpToolset";
 export { createAIVoiceModel } from "./core/aiVoiceModel";

package/dist/index.js

@@ -42225,8 +42225,19 @@ Respond with only your spoken line. When your goal is met or you want to hang up
 };
 // src/core/hardenedFetch.ts
 var ATTEMPT_TIMEOUT_MS = 6000;
+
+class VoiceFetchHeadersTimeoutError extends Error {
+  timeoutMs;
+  attempt;
+  constructor(timeoutMs, attempt) {
+    super(`fetch attempt ${attempt} exceeded ${timeoutMs}ms before response headers`);
+    this.name = "VoiceFetchHeadersTimeoutError";
+    this.timeoutMs = timeoutMs;
+    this.attempt = attempt;
+  }
+}
 var isBun = "Bun" in globalThis;
-var oneAttempt = async (baseFetch, input, init) => {
+var oneAttempt = async (baseFetch, input, init, timeoutMs, attempt) => {
   const controller = new AbortController;
   const callerSignal = init?.signal ?? undefined;
   const onCallerAbort = () => controller.abort(callerSignal?.reason);
@@ -42235,8 +42246,8 @@ var oneAttempt = async (baseFetch, input, init) => {
   else
     callerSignal?.addEventListener("abort", onCallerAbort, { once: true });
   const timer = setTimeout(() => {
-    controller.abort(new Error(`fetch exceeded ${ATTEMPT_TIMEOUT_MS}ms before response headers (stale Bun keep-alive socket?)`));
-  }, ATTEMPT_TIMEOUT_MS);
+    controller.abort(new VoiceFetchHeadersTimeoutError(timeoutMs, attempt));
+  }, timeoutMs);
   const headers = new Headers(init?.headers);
   if (isBun)
     headers.set("Connection", "close");
@@ -42246,20 +42257,29 @@ var oneAttempt = async (baseFetch, input, init) => {
       headers,
       signal: controller.signal
     });
+  } catch (error) {
+    if (callerSignal?.aborted)
+      throw callerSignal.reason;
+    if (controller.signal.reason instanceof VoiceFetchHeadersTimeoutError)
+      throw controller.signal.reason;
+    throw error;
   } finally {
     clearTimeout(timer);
     callerSignal?.removeEventListener("abort", onCallerAbort);
   }
 };
-var hardenFetch = (baseFetch = globalThis.fetch) => {
+var hardenFetch = (baseFetch = globalThis.fetch, options = {}) => {
+  const timeoutMs = options.attemptTimeoutMs ?? ATTEMPT_TIMEOUT_MS;
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0)
+    throw new RangeError("attemptTimeoutMs must be finite and positive");
   const hardenedFetch = async (input, init) => {
     try {
-      return await oneAttempt(baseFetch, input, init);
+      return await oneAttempt(baseFetch, input, init, timeoutMs, 1);
     } catch (error) {
       if (init?.signal?.aborted)
         throw error;
       console.warn(`[voice] hardened fetch retrying on a fresh connection: ${error instanceof Error ? error.message : String(error)}`);
-      return oneAttempt(baseFetch, input, init);
+      return oneAttempt(baseFetch, input, init, timeoutMs, 2);
     }
   };
   return typeof baseFetch.preconnect === "function" ? Object.assign(hardenedFetch, {
@@ -46725,7 +46745,7 @@ var createVoiceProviderRouter = (options) => {
           lastError = error;
           const hasNextProvider = index < order.length - 1;
           const isProviderError = options.isProviderError?.(error, provider) ?? true;
-          const timedOut = options.isTimeoutError?.(error, provider) ?? (error instanceof VoiceProviderTimeoutError || error instanceof VoiceProviderStreamInactivityError);
+          const timedOut = options.isTimeoutError?.(error, provider) ?? (error instanceof VoiceProviderTimeoutError || error instanceof VoiceProviderStreamInactivityError || error instanceof VoiceFetchHeadersTimeoutError);
           const rateLimited = options.isRateLimitError?.(error, provider) ?? defaultIsRateLimitError(error);
           const shouldFallback = fallbackMode === "provider-error" ? isProviderError : fallbackMode === "rate-limit" ? isProviderError && rateLimited : false;
           const providerHealth = recordProviderError(provider, isProviderError, rateLimited);
@@ -46745,8 +46765,9 @@ var createVoiceProviderRouter = (options) => {
             suppressedUntil: providerHealth?.suppressedUntil,
             status: "error",
             timedOut,
-            timeoutKind: error instanceof VoiceProviderStreamInactivityError ? "stream-inactivity" : error instanceof VoiceProviderTimeoutError ? "latency-budget" : undefined,
-            timeoutMs: error instanceof VoiceProviderStreamInactivityError ? error.inactivityMs : error instanceof VoiceProviderTimeoutError ? error.timeoutMs : undefined,
+            fetchAttempt: error instanceof VoiceFetchHeadersTimeoutError ? error.attempt : undefined,
+            timeoutKind: error instanceof VoiceFetchHeadersTimeoutError ? "response-headers" : error instanceof VoiceProviderStreamInactivityError ? "stream-inactivity" : error instanceof VoiceProviderTimeoutError ? "latency-budget" : undefined,
+            timeoutMs: error instanceof VoiceFetchHeadersTimeoutError ? error.timeoutMs : error instanceof VoiceProviderStreamInactivityError ? error.inactivityMs : error instanceof VoiceProviderTimeoutError ? error.timeoutMs : undefined,
             totalElapsedMs: Date.now() - routingStartedAt
           }, input);
           if (!hasNextProvider || !shouldFallback) {
@@ -54471,6 +54492,7 @@ export {
   VOICE_WEBHOOK_SIGNATURE_HEADER,
   VOICE_WEBHOOK_TIMESTAMP_HEADER,
   VOICE_ZERO_DATA_RETENTION_REDACTION_MARKER,
+  VoiceFetchHeadersTimeoutError,
   acknowledgeVoiceMonitorIssue,
   aggregateVoiceTurnLatencySpans,
   appendVoiceIOProviderRouterTraceEvent,

package/dist/testing/index.js

@@ -5121,8 +5121,19 @@ var voiceTimingEnabled = () => timingEnabled();
 
 // src/core/hardenedFetch.ts
 var ATTEMPT_TIMEOUT_MS = 6000;
+
+class VoiceFetchHeadersTimeoutError extends Error {
+  timeoutMs;
+  attempt;
+  constructor(timeoutMs, attempt) {
+    super(`fetch attempt ${attempt} exceeded ${timeoutMs}ms before response headers`);
+    this.name = "VoiceFetchHeadersTimeoutError";
+    this.timeoutMs = timeoutMs;
+    this.attempt = attempt;
+  }
+}
 var isBun = "Bun" in globalThis;
-var oneAttempt = async (baseFetch, input, init) => {
+var oneAttempt = async (baseFetch, input, init, timeoutMs, attempt) => {
   const controller = new AbortController;
   const callerSignal = init?.signal ?? undefined;
   const onCallerAbort = () => controller.abort(callerSignal?.reason);
@@ -5131,8 +5142,8 @@ var oneAttempt = async (baseFetch, input, init) => {
   else
     callerSignal?.addEventListener("abort", onCallerAbort, { once: true });
   const timer = setTimeout(() => {
-    controller.abort(new Error(`fetch exceeded ${ATTEMPT_TIMEOUT_MS}ms before response headers (stale Bun keep-alive socket?)`));
-  }, ATTEMPT_TIMEOUT_MS);
+    controller.abort(new VoiceFetchHeadersTimeoutError(timeoutMs, attempt));
+  }, timeoutMs);
   const headers = new Headers(init?.headers);
   if (isBun)
     headers.set("Connection", "close");
@@ -5142,20 +5153,29 @@ var oneAttempt = async (baseFetch, input, init) => {
       headers,
       signal: controller.signal
     });
+  } catch (error) {
+    if (callerSignal?.aborted)
+      throw callerSignal.reason;
+    if (controller.signal.reason instanceof VoiceFetchHeadersTimeoutError)
+      throw controller.signal.reason;
+    throw error;
   } finally {
     clearTimeout(timer);
     callerSignal?.removeEventListener("abort", onCallerAbort);
   }
 };
-var hardenFetch = (baseFetch = globalThis.fetch) => {
+var hardenFetch = (baseFetch = globalThis.fetch, options = {}) => {
+  const timeoutMs = options.attemptTimeoutMs ?? ATTEMPT_TIMEOUT_MS;
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0)
+    throw new RangeError("attemptTimeoutMs must be finite and positive");
   const hardenedFetch = async (input, init) => {
     try {
-      return await oneAttempt(baseFetch, input, init);
+      return await oneAttempt(baseFetch, input, init, timeoutMs, 1);
     } catch (error) {
       if (init?.signal?.aborted)
         throw error;
       console.warn(`[voice] hardened fetch retrying on a fresh connection: ${error instanceof Error ? error.message : String(error)}`);
-      return oneAttempt(baseFetch, input, init);
+      return oneAttempt(baseFetch, input, init, timeoutMs, 2);
     }
   };
   return typeof baseFetch.preconnect === "function" ? Object.assign(hardenedFetch, {
@@ -5612,7 +5632,7 @@ var createVoiceProviderRouter = (options) => {
           lastError = error;
           const hasNextProvider = index < order.length - 1;
           const isProviderError = options.isProviderError?.(error, provider) ?? true;
-          const timedOut = options.isTimeoutError?.(error, provider) ?? (error instanceof VoiceProviderTimeoutError || error instanceof VoiceProviderStreamInactivityError);
+          const timedOut = options.isTimeoutError?.(error, provider) ?? (error instanceof VoiceProviderTimeoutError || error instanceof VoiceProviderStreamInactivityError || error instanceof VoiceFetchHeadersTimeoutError);
           const rateLimited = options.isRateLimitError?.(error, provider) ?? defaultIsRateLimitError(error);
           const shouldFallback = fallbackMode === "provider-error" ? isProviderError : fallbackMode === "rate-limit" ? isProviderError && rateLimited : false;
           const providerHealth = recordProviderError(provider, isProviderError, rateLimited);
@@ -5632,8 +5652,9 @@ var createVoiceProviderRouter = (options) => {
             suppressedUntil: providerHealth?.suppressedUntil,
             status: "error",
             timedOut,
-            timeoutKind: error instanceof VoiceProviderStreamInactivityError ? "stream-inactivity" : error instanceof VoiceProviderTimeoutError ? "latency-budget" : undefined,
-            timeoutMs: error instanceof VoiceProviderStreamInactivityError ? error.inactivityMs : error instanceof VoiceProviderTimeoutError ? error.timeoutMs : undefined,
+            fetchAttempt: error instanceof VoiceFetchHeadersTimeoutError ? error.attempt : undefined,
+            timeoutKind: error instanceof VoiceFetchHeadersTimeoutError ? "response-headers" : error instanceof VoiceProviderStreamInactivityError ? "stream-inactivity" : error instanceof VoiceProviderTimeoutError ? "latency-budget" : undefined,
+            timeoutMs: error instanceof VoiceFetchHeadersTimeoutError ? error.timeoutMs : error instanceof VoiceProviderStreamInactivityError ? error.inactivityMs : error instanceof VoiceProviderTimeoutError ? error.timeoutMs : undefined,
             totalElapsedMs: Date.now() - routingStartedAt
           }, input);
           if (!hasNextProvider || !shouldFallback) {

package/package.json

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