@broberg/ai-sdk 0.44.0 → 0.45.1

package/dist/index.d.ts

@@ -87,6 +87,61 @@ interface Pronunciation {
     lang?: string;
 }
 
+/** One entry of Azure's `[nnnn].word.json`, verbatim field names. */
+interface AzureWordBoundary {
+    Text: string;
+    /** Milliseconds into the audio. */
+    AudioOffset: number;
+    /** Milliseconds. */
+    Duration: number;
+}
+interface WordTiming {
+    /** The spoken word, as Azure reported it. */
+    text: string;
+    startMs: number;
+    endMs: number;
+    /** Character span in the SOURCE text. Several spoken words share one span when they
+     *  came from one substituted manuscript word. */
+    sourceStart: number;
+    sourceEnd: number;
+}
+interface AlignedWordTimings {
+    /** Every word we could place in the source, in audio order. */
+    words: WordTiming[];
+    /** Spoken words we could NOT place, in order, verbatim.
+     *
+     *  Named rather than dropped, and never given a guessed offset. "I could not place
+     *  this" and "it was here" must not be the same answer — the same discipline as
+     *  `rerank.unscored` (F052). A highlighter that treats `words` as complete must look
+     *  here. */
+    unaligned: string[];
+}
+/** A pronunciation entry, narrowed to what alignment needs. */
+interface AliasEntry {
+    word: string;
+    alias?: string;
+}
+/**
+ * Map Azure's spoken word list onto positions in the SOURCE text.
+ *
+ * Two rules carry the whole function:
+ *
+ * **The walk only moves FORWARD.** That is what puts a repeated word on its own
+ * occurrence — "AI er AI" must not place the second on the first. Searching from 0 each
+ * time passes every test with distinct words and fails silently on real prose.
+ *
+ * **A substitution is matched as a RUN, not word by word.** Azure speaks SSML, so
+ * `<sub alias='broberg punktum a i'>broberg.ai</sub>` puts four words in the list where
+ * the manuscript has one. Matching them individually is not merely imprecise, it is
+ * wrong in a way that bites every Danish text: MEASURED on cms's own dictionary entry,
+ * a per-word map made the alias's "i" swallow the next real Danish word "i" in
+ * "broberg.ai i dag". An alias's parts are often ordinary words ("a", "i", "punktum"),
+ * so a lookup table cannot be the mechanism — the run has to be consumed positionally.
+ */
+declare function alignWordTimings(text: string, words: AzureWordBoundary[], opts?: {
+    pronunciations?: AliasEntry[];
+}): AlignedWordTimings;
+
 /** How a call reaches the model. `http` = provider REST API; `subprocess` = local
  *  `claude -p` CLI (Max plan, costUsd 0). */
 type Transport = "http" | "subprocess";
@@ -492,6 +547,14 @@ interface PodcastResult {
     /** Episode audio bytes. */
     audio: Uint8Array;
     mimeType: string;
+    /** F055 — per-word timings, present only when `wordTimings` was asked for AND the
+     *  route produces them. Its ABSENCE says "not available here"; an empty `words` array
+     *  would say "the text had no words", which is a different claim.
+     *
+     *  `sourceStart`/`sourceEnd` index the ORIGINAL text you passed, not the SSML we sent
+     *  — Azure reports only audio time, so the link back to the manuscript is derived
+     *  here. `unaligned` names any spoken word that could not be placed. */
+    wordTimings?: AlignedWordTimings;
     usage: Usage;
 }
 
@@ -512,6 +575,16 @@ interface TtsRequest {
      *  into SSML** — the substitution happens adapter-side AFTER the text is escaped, so
      *  `text` can never inject markup, and `alias`/`ipa` are escaped too. */
     pronunciations?: Pronunciation[];
+    /** F055 — ask for per-word timings so a reader can highlight each word as it is
+     *  spoken. Azure only. Absent from the result means "this route does not produce
+     *  them", which is a different answer from an empty list.
+     *
+     *  **This changes the ROUTE, not just the payload.** The real-time endpoint returns
+     *  audio only; word boundaries exist solely on Azure's asynchronous batch synthesis
+     *  API, so the call becomes submit → poll → fetch. Microsoft quotes 10–20s for half
+     *  of all jobs and up to 120s for 95%. Worth it for a pre-generated, cached reading;
+     *  wrong for anything a user is waiting on. */
+    wordTimings?: boolean;
     spec: TierSpec;
 }
 interface BatchRequestItem {
@@ -1322,6 +1395,7 @@ declare const imageInputSchema: z.ZodObject<{
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     seed?: number | undefined;
     purpose?: string | undefined;
+    outputFormat?: "jpeg" | "png" | "webp" | undefined;
     loras?: {
         path: string;
         scale?: number | undefined;
@@ -1343,7 +1417,6 @@ declare const imageInputSchema: z.ZodObject<{
     finetune?: string | undefined;
     finetuneStrength?: number | undefined;
     referenceImages?: (string | Uint8Array<ArrayBuffer>)[] | undefined;
-    outputFormat?: "jpeg" | "png" | "webp" | undefined;
     safetyTolerance?: number | undefined;
     retryOnBlack?: boolean | undefined;
 }, {
@@ -1351,6 +1424,7 @@ declare const imageInputSchema: z.ZodObject<{
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     seed?: number | undefined;
     purpose?: string | undefined;
+    outputFormat?: "jpeg" | "png" | "webp" | undefined;
     loras?: {
         path: string;
         scale?: number | undefined;
@@ -1372,7 +1446,6 @@ declare const imageInputSchema: z.ZodObject<{
     finetune?: string | undefined;
     finetuneStrength?: number | undefined;
     referenceImages?: (string | Uint8Array<ArrayBuffer>)[] | undefined;
-    outputFormat?: "jpeg" | "png" | "webp" | undefined;
     safetyTolerance?: number | undefined;
     retryOnBlack?: boolean | undefined;
 }>;
@@ -1873,6 +1946,13 @@ declare const podcastInputSchema: z.ZodObject<{
     voices: Record<string, string>;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     purpose?: string | undefined;
+    pronunciations?: {
+        word: string;
+        matchInCompounds?: boolean | undefined;
+        alias?: string | undefined;
+        ipa?: string | undefined;
+        lang?: string | undefined;
+    }[] | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1885,13 +1965,6 @@ declare const podcastInputSchema: z.ZodObject<{
     })[] | undefined;
     labels?: Record<string, string> | undefined;
     format?: string | undefined;
-    pronunciations?: {
-        word: string;
-        matchInCompounds?: boolean | undefined;
-        alias?: string | undefined;
-        ipa?: string | undefined;
-        lang?: string | undefined;
-    }[] | undefined;
 }, {
     script: {
         text: string;
@@ -1900,6 +1973,13 @@ declare const podcastInputSchema: z.ZodObject<{
     voices: Record<string, string>;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     purpose?: string | undefined;
+    pronunciations?: {
+        word: string;
+        matchInCompounds?: boolean | undefined;
+        alias?: string | undefined;
+        ipa?: string | undefined;
+        lang?: string | undefined;
+    }[] | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -1912,13 +1992,6 @@ declare const podcastInputSchema: z.ZodObject<{
     })[] | undefined;
     labels?: Record<string, string> | undefined;
     format?: string | undefined;
-    pronunciations?: {
-        word: string;
-        matchInCompounds?: boolean | undefined;
-        alias?: string | undefined;
-        ipa?: string | undefined;
-        lang?: string | undefined;
-    }[] | undefined;
 }>;
 declare const ttsInputSchema: z.ZodObject<{
     tier: z.ZodOptional<z.ZodEnum<["fast", "smart", "powerful", "cheap", "vision", "video", "embedding"]>>;
@@ -1974,6 +2047,8 @@ declare const ttsInputSchema: z.ZodObject<{
         ipa?: string | undefined;
         lang?: string | undefined;
     }>, "many">>;
+    /** F055 — per-word timings (Azure only). Changes the route to batch synthesis. */
+    wordTimings: z.ZodOptional<z.ZodBoolean>;
     /** F037: voice to use if `voice` is one we know the provider has retired. Without
      *  it a retired voice throws VoiceUnavailableError rather than reaching the API.
      *
@@ -1993,6 +2068,14 @@ declare const ttsInputSchema: z.ZodObject<{
     voice: string;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     purpose?: string | undefined;
+    wordTimings?: boolean | undefined;
+    pronunciations?: {
+        word: string;
+        matchInCompounds?: boolean | undefined;
+        alias?: string | undefined;
+        ipa?: string | undefined;
+        lang?: string | undefined;
+    }[] | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -2006,13 +2089,6 @@ declare const ttsInputSchema: z.ZodObject<{
     labels?: Record<string, string> | undefined;
     lang?: string | undefined;
     format?: string | undefined;
-    pronunciations?: {
-        word: string;
-        matchInCompounds?: boolean | undefined;
-        alias?: string | undefined;
-        ipa?: string | undefined;
-        lang?: string | undefined;
-    }[] | undefined;
     voiceFallback?: string | undefined;
     rate?: number | undefined;
 }, {
@@ -2020,6 +2096,14 @@ declare const ttsInputSchema: z.ZodObject<{
     voice: string;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     purpose?: string | undefined;
+    wordTimings?: boolean | undefined;
+    pronunciations?: {
+        word: string;
+        matchInCompounds?: boolean | undefined;
+        alias?: string | undefined;
+        ipa?: string | undefined;
+        lang?: string | undefined;
+    }[] | undefined;
     override?: {
         provider?: string | undefined;
         model?: string | undefined;
@@ -2033,13 +2117,6 @@ declare const ttsInputSchema: z.ZodObject<{
     labels?: Record<string, string> | undefined;
     lang?: string | undefined;
     format?: string | undefined;
-    pronunciations?: {
-        word: string;
-        matchInCompounds?: boolean | undefined;
-        alias?: string | undefined;
-        ipa?: string | undefined;
-        lang?: string | undefined;
-    }[] | undefined;
     voiceFallback?: string | undefined;
     rate?: number | undefined;
 }>;
@@ -2308,11 +2385,25 @@ declare function azureAdapter(config?: {
     sttPricePerMin?: number;
     /** STT base URL override (e.g. a resource custom domain). */
     sttBaseUrl?: string;
-    /** Resource name → custom-domain STT host `{resource}.cognitiveservices.azure.com`
-     *  (or env AZURE_SPEECH_RESOURCE). Without it, STT uses the regional host. */
+    /** Resource name → custom-domain host `{resource}.cognitiveservices.azure.com`
+     *  (or env AZURE_SPEECH_RESOURCE).
+     *
+     *  **STT works without it** — the regional host is a legitimate route for
+     *  `speechtotext/transcriptions` and is the tested default (F029).
+     *
+     *  **BATCH SYNTHESIS REQUIRES IT.** Every example in Microsoft's batch-synthesis
+     *  docs uses the resource host; the regional host is shown nowhere, and cms measured
+     *  it answering 401 with a valid key (F055.3). Without this set, `wordTimings` fails
+     *  before the call rather than spending your time on Azure's "invalid subscription
+     *  key or wrong API endpoint" — which names the key first and sends you the wrong way. */
     resource?: string;
     /** Fast-transcription api-version (overrides the GA default). */
     sttApiVersion?: string;
+    /** F055 — how long to wait for a batch synthesis job. Default 180s (Microsoft's own
+     *  95th percentile is 120s). */
+    batchTimeoutMs?: number;
+    /** F055 — poll interval for batch synthesis. Default 3s. */
+    batchPollMs?: number;
     /** phraseList biasing weight (0–2) applied when a call passes `phrases`. Default 1.5. */
     sttBiasingWeight?: number;
 }): ProviderAdapter;
@@ -2432,8 +2523,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.44.0";
-declare const SDK_TAG: "@broberg/ai-sdk@0.44.0";
+declare const VERSION: "0.45.1";
+declare const SDK_TAG: "@broberg/ai-sdk@0.45.1";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.
@@ -2844,4 +2935,4 @@ interface StreamTransportRequest extends TransportRequest {
  */
 declare function streamTransport(req: StreamTransportRequest): AsyncIterable<string>;
 
-export { AZURE_DANISH_VOICES, AZURE_DANISH_VOICE_LIST, type AiClient, type AiConfig, type AzureVoiceInfo, type BatchJob, type BatchRequestItem, type BatchResultItem, type BflAdapterConfig, type BflCredits, type BudgetConfig, BudgetExceededError, BudgetGuard, type BudgetStore, type CallOptions, type Capability, type ChatInput, type ChatRequest, type ChatResult, type ChatStreamEvent, type CheckVoiceOptions, type ClassifyInput, type ClassifyResult, type ContentPart, type Contracts, type CostQuery, type CostSink, type CostSummary, type CostSummaryQuery, type CostTimeseriesQuery, DEFAULT_TIER_MAP, type DesignInput, type DesignResult, type DialogueRequest, type DialogueTurn, type DiscordSinkConfig, ELEVENLABS_DANISH_VOICES, type EmbeddingInput, type EmbeddingRequest, type EmbeddingResult, type ExtractInput, type ExtractResult, type FalAdapterConfig, type HttpResponse, type ImageInput, type ImageRequest, type ImageResult, type LoraWeight, type Message, type MockupInput, type MockupResult, type ModerationInput, type ModerationItem, type ModerationRequest, type ModerationResult, type OcrInput, type OcrPage, type OcrRequest, type OcrResult, type OpenAICompatibleConfig, type PodcastInput, type PodcastResult, type PricingEntry, type ProviderAdapter, type RefreshOptions, type RefreshResult, type Region, type RerankInput, type RerankResult, type Role, SDK_TAG, type SqliteBudgetStoreConfig, type SqliteSinkConfig, StreamHttpError, type SubprocessResponse, type Tier, type TierSpec, type Tool, type ToolCall, type TrainStyleInput, type TrainStyleRequest, type TrainStyleResult, type TranscribeInput, type TranscribeRequest, type TranscribeResult, type TranslateInput, type TranslateResult, type Transport, type TransportRequest, type TransportResponse, type TtsInput, type TtsRequest, type UpmetricsCostClientConfig, UpmetricsCostError, type UpmetricsCostRow, type UpmetricsCostSummary, type UpmetricsCostTimeseries, type UpmetricsSinkConfig, type Usage, VERSION, type VideoInput, type VisionInput, type VoiceInfo, type VoiceProvider, type VoiceResolveResult, type VoiceStatus, VoiceUnavailableError, aiConfigSchema, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, azureAdapter, bflAdapter, bflCredits, chatInputSchema, checkVoice, classifyRegionName, computeCost, createAI, deepinfraAdapter, deeplAdapter, deepseekAdapter, defaultProviders, discordSink, elevenlabsAdapter, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, listAzureDanishVoices, listVoices, makeContracts, makeOpenAICompatibleAdapter, messageSchema, mistralAdapter, mistralStubAdapter, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, refreshAvailability, regionOfHost, regionOfProvider, requestyAdapter, resetRefreshState, resetRegistry, resolveAzureVoice, resolveTier, resolveVoice, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, upmetricsCostClient, upmetricsSink, usdFromMicro, vertexAdapter, visionInputSchema };
+export { AZURE_DANISH_VOICES, AZURE_DANISH_VOICE_LIST, type AiClient, type AiConfig, type AlignedWordTimings, type AzureVoiceInfo, type AzureWordBoundary, type BatchJob, type BatchRequestItem, type BatchResultItem, type BflAdapterConfig, type BflCredits, type BudgetConfig, BudgetExceededError, BudgetGuard, type BudgetStore, type CallOptions, type Capability, type ChatInput, type ChatRequest, type ChatResult, type ChatStreamEvent, type CheckVoiceOptions, type ClassifyInput, type ClassifyResult, type ContentPart, type Contracts, type CostQuery, type CostSink, type CostSummary, type CostSummaryQuery, type CostTimeseriesQuery, DEFAULT_TIER_MAP, type DesignInput, type DesignResult, type DialogueRequest, type DialogueTurn, type DiscordSinkConfig, ELEVENLABS_DANISH_VOICES, type EmbeddingInput, type EmbeddingRequest, type EmbeddingResult, type ExtractInput, type ExtractResult, type FalAdapterConfig, type HttpResponse, type ImageInput, type ImageRequest, type ImageResult, type LoraWeight, type Message, type MockupInput, type MockupResult, type ModerationInput, type ModerationItem, type ModerationRequest, type ModerationResult, type OcrInput, type OcrPage, type OcrRequest, type OcrResult, type OpenAICompatibleConfig, type PodcastInput, type PodcastResult, type PricingEntry, type ProviderAdapter, type RefreshOptions, type RefreshResult, type Region, type RerankInput, type RerankResult, type Role, SDK_TAG, type SqliteBudgetStoreConfig, type SqliteSinkConfig, StreamHttpError, type SubprocessResponse, type Tier, type TierSpec, type Tool, type ToolCall, type TrainStyleInput, type TrainStyleRequest, type TrainStyleResult, type TranscribeInput, type TranscribeRequest, type TranscribeResult, type TranslateInput, type TranslateResult, type Transport, type TransportRequest, type TransportResponse, type TtsInput, type TtsRequest, type UpmetricsCostClientConfig, UpmetricsCostError, type UpmetricsCostRow, type UpmetricsCostSummary, type UpmetricsCostTimeseries, type UpmetricsSinkConfig, type Usage, VERSION, type VideoInput, type VisionInput, type VoiceInfo, type VoiceProvider, type VoiceResolveResult, type VoiceStatus, VoiceUnavailableError, type WordTiming, aiConfigSchema, alignWordTimings, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, azureAdapter, bflAdapter, bflCredits, chatInputSchema, checkVoice, classifyRegionName, computeCost, createAI, deepinfraAdapter, deeplAdapter, deepseekAdapter, defaultProviders, discordSink, elevenlabsAdapter, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, listAzureDanishVoices, listVoices, makeContracts, makeOpenAICompatibleAdapter, messageSchema, mistralAdapter, mistralStubAdapter, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, refreshAvailability, regionOfHost, regionOfProvider, requestyAdapter, resetRefreshState, resetRegistry, resolveAzureVoice, resolveTier, resolveVoice, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, upmetricsCostClient, upmetricsSink, usdFromMicro, vertexAdapter, visionInputSchema };

package/dist/index.js

@@ -1658,6 +1658,124 @@ function elevenlabsAdapter(config = {}) {
   return { name: "elevenlabs", dialogue, tts, listVoices: listVoices2 };
 }
 
+// src/providers/word-timings.ts
+var PUNCTUATION = /* @__PURE__ */ new Set([".", ",", "!", "?", ":", ";", "\u2026", "\u2014", "\u2013", '"', "'", "(", ")"]);
+var fold = (s) => s.toLowerCase();
+function alignWordTimings(text, words, opts = {}) {
+  const out = [];
+  const unaligned = [];
+  const haystack = fold(text);
+  const aliases = (opts.pronunciations ?? []).filter((p) => typeof p.alias === "string" && p.alias.trim() !== "").map((p) => ({ word: p.word, parts: p.alias.trim().split(/\s+/).map(fold) })).sort((a, b) => b.parts.length - a.parts.length);
+  const spoken = words.filter((w) => !PUNCTUATION.has(w.Text.trim()));
+  let cursor = 0;
+  let i = 0;
+  while (i < spoken.length) {
+    let consumed = false;
+    for (const a of aliases) {
+      if (i + a.parts.length > spoken.length) continue;
+      const matches = a.parts.every((part, k) => fold(spoken[i + k].Text) === part);
+      if (!matches) continue;
+      const at2 = haystack.indexOf(fold(a.word), cursor);
+      if (at2 === -1) continue;
+      const span = { start: at2, end: at2 + a.word.length };
+      for (let k = 0; k < a.parts.length; k++) {
+        const w2 = spoken[i + k];
+        out.push({
+          text: w2.Text,
+          startMs: w2.AudioOffset,
+          endMs: w2.AudioOffset + w2.Duration,
+          sourceStart: span.start,
+          sourceEnd: span.end
+        });
+      }
+      cursor = span.end;
+      i += a.parts.length;
+      consumed = true;
+      break;
+    }
+    if (consumed) continue;
+    const w = spoken[i];
+    const at = haystack.indexOf(fold(w.Text), cursor);
+    if (at === -1) {
+      unaligned.push(w.Text);
+    } else {
+      out.push({
+        text: w.Text,
+        startMs: w.AudioOffset,
+        endMs: w.AudioOffset + w.Duration,
+        sourceStart: at,
+        sourceEnd: at + w.Text.length
+      });
+      cursor = at + w.Text.length;
+    }
+    i++;
+  }
+  return { words: out, unaligned };
+}
+
+// src/providers/zip.ts
+import { inflateRawSync } from "zlib";
+var EOCD_SIG = 101010256;
+var CEN_SIG = 33639248;
+function readZipEntry(zip, name) {
+  const view = new DataView(zip.buffer, zip.byteOffset, zip.byteLength);
+  let eocd = -1;
+  for (let i = zip.length - 22; i >= 0; i--) {
+    if (view.getUint32(i, true) === EOCD_SIG) {
+      eocd = i;
+      break;
+    }
+  }
+  if (eocd === -1) throw new Error("readZipEntry: not a ZIP archive (no end-of-central-directory record)");
+  const entryCount = view.getUint16(eocd + 10, true);
+  let p = view.getUint32(eocd + 16, true);
+  for (let n = 0; n < entryCount; n++) {
+    if (view.getUint32(p, true) !== CEN_SIG) {
+      throw new Error(`readZipEntry: corrupt central directory at entry ${n}`);
+    }
+    const method = view.getUint16(p + 10, true);
+    const compressedSize = view.getUint32(p + 20, true);
+    const nameLen = view.getUint16(p + 28, true);
+    const extraLen = view.getUint16(p + 30, true);
+    const commentLen = view.getUint16(p + 32, true);
+    const localOffset = view.getUint32(p + 42, true);
+    const entryName = new TextDecoder().decode(zip.subarray(p + 46, p + 46 + nameLen));
+    if (entryName === name) {
+      const lNameLen = view.getUint16(localOffset + 26, true);
+      const lExtraLen = view.getUint16(localOffset + 28, true);
+      const start = localOffset + 30 + lNameLen + lExtraLen;
+      const raw = zip.subarray(start, start + compressedSize);
+      if (method === 0) return new Uint8Array(raw);
+      if (method === 8) return new Uint8Array(inflateRawSync(raw));
+      throw new Error(`readZipEntry: "${name}" uses unsupported compression method ${method}`);
+    }
+    p += 46 + nameLen + extraLen + commentLen;
+  }
+  return void 0;
+}
+function listZipEntries(zip) {
+  const view = new DataView(zip.buffer, zip.byteOffset, zip.byteLength);
+  let eocd = -1;
+  for (let i = zip.length - 22; i >= 0; i--) {
+    if (view.getUint32(i, true) === EOCD_SIG) {
+      eocd = i;
+      break;
+    }
+  }
+  if (eocd === -1) throw new Error("listZipEntries: not a ZIP archive (no end-of-central-directory record)");
+  const entryCount = view.getUint16(eocd + 10, true);
+  let p = view.getUint32(eocd + 16, true);
+  const names = [];
+  for (let n = 0; n < entryCount; n++) {
+    const nameLen = view.getUint16(p + 28, true);
+    const extraLen = view.getUint16(p + 30, true);
+    const commentLen = view.getUint16(p + 32, true);
+    names.push(new TextDecoder().decode(zip.subarray(p + 46, p + 46 + nameLen)));
+    p += 46 + nameLen + extraLen + commentLen;
+  }
+  return names;
+}
+
 // src/providers/azure.ts
 var DEFAULT_STT_API_VERSION = "2025-10-15";
 var DEFAULT_REGION = "westeurope";
@@ -1718,11 +1836,14 @@ function azureAdapter(config = {}) {
     }
     return classifyRegionName(region());
   }
-  function sttBaseUrl() {
-    if (config.sttBaseUrl) return config.sttBaseUrl.replace(/\/$/, "");
+  function sttHost() {
+    if (config.sttBaseUrl) return { url: config.sttBaseUrl.replace(/\/$/, ""), source: "explicit" };
     const resource = config.resource ?? process.env.AZURE_SPEECH_RESOURCE;
-    if (resource) return `https://${resource}.cognitiveservices.azure.com`;
-    return `https://${region()}.api.cognitive.microsoft.com`;
+    if (resource) return { url: `https://${resource}.cognitiveservices.azure.com`, source: "resource" };
+    return { url: `https://${region()}.api.cognitive.microsoft.com`, source: "regional-fallback" };
+  }
+  function sttBaseUrl() {
+    return sttHost().url;
   }
   function priceFor(chars, model) {
     const usage = freshUsage({
@@ -1739,10 +1860,9 @@ function azureAdapter(config = {}) {
     usage.costUsd = chars / 1e3 * (config.pricePer1kChars ?? getMediaPrice("azure", "tts")?.usd ?? 0);
     return usage;
   }
-  async function tts(req) {
+  function buildSsml(req) {
     const voice = resolveAzureVoice(req.voiceId);
     const lang = req.lang ?? localeOf(voice);
-    const format = req.format ?? DEFAULT_FORMAT;
     assertPronunciations(req.pronunciations, "azure");
     const escaped = applyPronunciations(
       xmlEscape(req.text),
@@ -1752,7 +1872,11 @@ function azureAdapter(config = {}) {
     );
     const effRate = req.rate ?? AZURE_DANISH_VOICE_LIST.find((v) => v.voiceId === voice)?.defaultRate;
     const inner = effRate != null && effRate !== 1 ? `<prosody rate='${effRate}'>${escaped}</prosody>` : escaped;
-    const ssml = `<speak version='1.0' xml:lang='${lang}'><voice name='${voice}'>${inner}</voice></speak>`;
+    return `<speak version='1.0' xml:lang='${lang}'><voice name='${voice}'>${inner}</voice></speak>`;
+  }
+  async function tts(req) {
+    if (req.wordTimings) return ttsBatch(req);
+    const format = req.format ?? DEFAULT_FORMAT;
     const res = await fetchImpl(
       `https://${region()}.tts.speech.microsoft.com/cognitiveservices/v1`,
       {
@@ -1762,7 +1886,7 @@ function azureAdapter(config = {}) {
           "Content-Type": "application/ssml+xml",
           "X-Microsoft-OutputFormat": format
         },
-        body: ssml
+        body: buildSsml(req)
       }
     );
     if (!res.ok) {
@@ -1772,6 +1896,88 @@ function azureAdapter(config = {}) {
     const audio = new Uint8Array(await res.arrayBuffer());
     return { audio, mimeType: "audio/mpeg", usage: priceFor(req.text.length, req.spec.model) };
   }
+  async function ttsBatch(req) {
+    const picked = sttHost();
+    if (picked.source === "regional-fallback") {
+      throw new Error(
+        `azure batch synthesis (wordTimings) needs the resource's custom subdomain, not the regional host ${picked.url}. Set AZURE_SPEECH_RESOURCE (or config.resource) to your Speech resource name so the call goes to {resource}.cognitiveservices.azure.com, and make sure custom subdomain is enabled on that resource. Azure answers 401 here with a VALID key, and its message blames the key \u2014 measured by cms 11 September 2026.`
+      );
+    }
+    const host = picked.url;
+    const api = "api-version=2024-04-01";
+    const id = `wt-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+    const headers = { "Ocp-Apim-Subscription-Key": key(), "Content-Type": "application/json" };
+    const put = await fetchImpl(`${host}/texttospeech/batchsyntheses/${id}?${api}`, {
+      method: "PUT",
+      headers,
+      body: JSON.stringify({
+        inputKind: "SSML",
+        inputs: [{ content: buildSsml(req) }],
+        properties: {
+          wordBoundaryEnabled: true,
+          // ONE audio file and ONE word list for the whole text. Without it a chunked
+          // input yields per-chunk offsets that somebody has to re-base — the kind of
+          // arithmetic that looks right and is 40 ms wrong by the end.
+          concatenateResult: true,
+          ...req.format ? { outputFormat: req.format } : {}
+        }
+      })
+    });
+    if (!put.ok) {
+      const body = await put.text().catch(() => "");
+      throw new Error(`azure batch synthesis submit ${put.status}: ${body.slice(0, 300)}`);
+    }
+    const deadline = Date.now() + (config.batchTimeoutMs ?? 18e4);
+    let resultUrl = "";
+    for (; ; ) {
+      const get = await fetchImpl(`${host}/texttospeech/batchsyntheses/${id}?${api}`, {
+        headers: { "Ocp-Apim-Subscription-Key": key() }
+      });
+      if (!get.ok) {
+        const body = await get.text().catch(() => "");
+        throw new Error(`azure batch synthesis poll ${get.status}: ${body.slice(0, 300)}`);
+      }
+      const job = await get.json();
+      if (job.status === "Succeeded") {
+        resultUrl = job.outputs?.result ?? "";
+        break;
+      }
+      if (job.status === "Failed") throw new Error(`azure batch synthesis ${id} failed`);
+      if (Date.now() > deadline) {
+        throw new Error(
+          `azure batch synthesis ${id} still "${job.status}" after ${Math.round((config.batchTimeoutMs ?? 18e4) / 1e3)}s`
+        );
+      }
+      await new Promise((r) => setTimeout(r, config.batchPollMs ?? 3e3));
+    }
+    if (!resultUrl) throw new Error(`azure batch synthesis ${id} succeeded without a result URL`);
+    const zipRes = await fetchImpl(resultUrl, { headers: { "Ocp-Apim-Subscription-Key": key() } });
+    if (!zipRes.ok) {
+      throw new Error(`azure batch synthesis results ${zipRes.status}`);
+    }
+    const zip = new Uint8Array(await zipRes.arrayBuffer());
+    const audio = readZipEntry(zip, "0001.wav");
+    if (!audio) {
+      throw new Error(`azure batch synthesis: no 0001.wav in results; archive holds ${listZipEntries(zip).join(", ")}`);
+    }
+    const wordsRaw = readZipEntry(zip, "0001.word.json");
+    if (!wordsRaw) {
+      throw new Error(
+        `azure batch synthesis: wordTimings was requested but the archive has no 0001.word.json; it holds ${listZipEntries(zip).join(", ")}`
+      );
+    }
+    const boundaries = JSON.parse(new TextDecoder().decode(wordsRaw));
+    return {
+      audio,
+      // Batch defaults to riff PCM, not mp3 — saying audio/mpeg here would be a lie the
+      // browser would act on.
+      mimeType: req.format?.includes("mp3") ? "audio/mpeg" : "audio/wav",
+      // Aligned against the ORIGINAL text, with the dictionary, so the offsets index the
+      // manuscript rather than the SSML we sent.
+      wordTimings: alignWordTimings(req.text, boundaries, { pronunciations: req.pronunciations }),
+      usage: priceFor(req.text.length, req.spec.model)
+    };
+  }
   async function transcribe(req) {
     const locale = toAzureLocale(req.language);
     const definition = { locales: [locale] };
@@ -3085,6 +3291,8 @@ var ttsInputSchema = z.object({
   /** F051 — see TtsRequest.pronunciations. The alias/ipa exclusivity is enforced in
    *  the adapter, not here: the message must name the provider that cannot do it. */
   pronunciations: z.array(pronunciationSchema).optional(),
+  /** F055 — per-word timings (Azure only). Changes the route to batch synthesis. */
+  wordTimings: z.boolean().optional(),
   /** F037: voice to use if `voice` is one we know the provider has retired. Without
    *  it a retired voice throws VoiceUnavailableError rather than reaching the API.
    *
@@ -3126,8 +3334,8 @@ var aiConfigSchema = z.object({
 });
 
 // src/version.ts
-var VERSION = "0.44.0";
-var SDK_TAG = "@broberg/ai-sdk@0.44.0";
+var VERSION = "0.45.1";
+var SDK_TAG = "@broberg/ai-sdk@0.45.1";
 
 // src/cost/sinks/upmetrics.ts
 function upmetricsSink(config) {
@@ -3682,6 +3890,7 @@ function createAI(config = {}) {
             format: input.format,
             rate: input.rate,
             pronunciations: input.pronunciations,
+            wordTimings: input.wordTimings,
             spec
           });
         }
@@ -4150,6 +4359,7 @@ export {
   VERSION,
   VoiceUnavailableError,
   aiConfigSchema,
+  alignWordTimings,
   anthropicAdapter,
   anthropicApiAdapter,
   anthropicSubprocessAdapter,