@broberg/ai-sdk 0.38.0 → 0.40.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 export { AvailabilitySource, AvailabilityStatus, ModelStatus, ModelUnavailableError, ResolveOptions, ResolveResult, listModels, resolveModel } from './registry.js';
-export { PRICING_STALE_AFTER_DAYS, PricingFreshness, pricingFreshness, pricingGeneratedAt } from './pricing.js';
+export { DEFAULT_CLIP_SEC, MEDIA_PRICING_CHECKED_AT, MediaPrice, MediaUnit, PRICING_STALE_AFTER_DAYS, PricingFreshness, UnitFreshness, getMediaPrice, listMediaPrices, pricingFreshness, pricingGeneratedAt } from './pricing.js';
 
 /** Coarse data-residency of the endpoint a call went to.
  *
@@ -39,6 +39,18 @@ declare function classifyRegionName(name: string | undefined): Region;
  *  is it?" — a narrower question than "where will my call go?". */
 declare function regionOfProvider(provider: string): Region;
 
+/** One dictionary entry. `alias` says it differently; `ipa` says it precisely. */
+interface Pronunciation {
+    /** The word as it appears in the text. Matched whole-word, case-insensitively. */
+    word: string;
+    /** Say this instead. Azure `<sub alias>`; ElevenLabs plain substitution. */
+    alias?: string;
+    /** IPA phonemes. Azure `<phoneme alphabet="ipa" ph>`. ElevenLabs cannot do this. */
+    ipa?: string;
+    /** Reserved for a future per-entry language switch; carried but not yet emitted. */
+    lang?: string;
+}
+
 /** How a call reaches the model. `http` = provider REST API; `subprocess` = local
  *  `claude -p` CLI (Max plan, costUsd 0). */
 type Transport = "http" | "subprocess";
@@ -147,6 +159,24 @@ interface Usage {
     cacheReadTokens: number;
     cacheCreationTokens: number;
     costUsd: number;
+    /** How `costUsd` was arrived at (F050). Absent means the same as `"computed"`;
+     *  it is optional only so that adding it could not break a consumer building a
+     *  Usage by hand.
+     *
+     *  - `"reported"` — the PROVIDER told us what the call cost (BFL returns credits).
+     *  - `"computed"` — a price table rate × a quantity we actually measured (tokens).
+     *  - `"estimated"` — a quantity or a rate was ASSUMED. A video call with no
+     *    `durationSec` is billed at {@link DEFAULT_CLIP_SEC} seconds regardless of the
+     *    clip that came back, and fal's per-image rates are fal's own estimates.
+     *  - `"unpriced"` — we have NO price for this model, so `costUsd` is 0 because we
+     *    could not answer, not because the call was free. Those two were the same
+     *    number, and the free one is much rarer than the unknown one.
+     *
+     *  This is a DATA field on purpose. upmetrics distinguishes reported / computed /
+     *  unpriced / untokened, and it reads fields — a JSDoc note saying "this one is a
+     *  guess" never reaches it, so an assumed number arrived there indistinguishable
+     *  from a measured one. super did exactly that and passed it on as measured. */
+    costBasis?: "reported" | "computed" | "estimated" | "unpriced";
     toolCalls?: {
         name: string;
         count: number;
@@ -423,6 +453,7 @@ interface PodcastResult {
     mimeType: string;
     usage: Usage;
 }
+
 interface TtsRequest {
     text: string;
     voiceId: string;
@@ -432,6 +463,14 @@ interface TtsRequest {
     format?: string;
     /** Speaking-rate multiplier (Azure): 1 = normal, 0.9 = 10% slower, 1.1 = faster. ElevenLabs ignores it. */
     rate?: number;
+    /** F051 — pronunciation dictionary. A Danish voice says English jargon wrongly:
+     *  measured on da-DK, "AI" comes out as the word "aj", "native" as "nativ".
+     *
+     *  Azure renders these as SSML (`<sub alias>` / `<phoneme alphabet="ipa" ph>`);
+     *  ElevenLabs has no SSML and can only apply `alias`. **This is the CONTROLLED DOOR
+     *  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[];
     spec: TierSpec;
 }
 interface BatchRequestItem {
@@ -1807,6 +1846,24 @@ declare const ttsInputSchema: z.ZodObject<{
     labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     text: z.ZodString;
     voice: z.ZodString;
+    /** 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.ZodOptional<z.ZodArray<z.ZodObject<{
+        word: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        ipa: z.ZodOptional<z.ZodString>;
+        lang: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        word: string;
+        alias?: string | undefined;
+        ipa?: string | undefined;
+        lang?: string | undefined;
+    }, {
+        word: string;
+        alias?: string | undefined;
+        ipa?: string | undefined;
+        lang?: string | undefined;
+    }>, "many">>;
     /** 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.
      *
@@ -1838,8 +1895,14 @@ declare const ttsInputSchema: z.ZodObject<{
     })[] | undefined;
     labels?: Record<string, string> | undefined;
     format?: string | undefined;
-    voiceFallback?: string | undefined;
     lang?: string | undefined;
+    pronunciations?: {
+        word: string;
+        alias?: string | undefined;
+        ipa?: string | undefined;
+        lang?: string | undefined;
+    }[] | undefined;
+    voiceFallback?: string | undefined;
     rate?: number | undefined;
 }, {
     text: string;
@@ -1858,8 +1921,14 @@ declare const ttsInputSchema: z.ZodObject<{
     })[] | undefined;
     labels?: Record<string, string> | undefined;
     format?: string | undefined;
-    voiceFallback?: string | undefined;
     lang?: string | undefined;
+    pronunciations?: {
+        word: string;
+        alias?: string | undefined;
+        ipa?: string | undefined;
+        lang?: string | undefined;
+    }[] | undefined;
+    voiceFallback?: string | undefined;
     rate?: number | undefined;
 }>;
 declare const aiConfigSchema: z.ZodObject<{
@@ -2251,8 +2320,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.38.0";
-declare const SDK_TAG: "@broberg/ai-sdk@0.38.0";
+declare const VERSION: "0.40.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.40.0";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.

package/dist/index.js

@@ -10,11 +10,15 @@ import {
   setAvailability
 } from "./chunk-ZFWSLSE7.js";
 import {
+  DEFAULT_CLIP_SEC,
+  MEDIA_PRICING_CHECKED_AT,
   PRICING_STALE_AFTER_DAYS,
+  getMediaPrice,
   getPrice,
+  listMediaPrices,
   pricingFreshness,
   pricingGeneratedAt
-} from "./chunk-QUOZWQ7G.js";
+} from "./chunk-KXTCLLVF.js";
 
 // src/transport/http.ts
 async function httpTransport(req) {
@@ -355,6 +359,11 @@ function freshUsage(args) {
     cacheReadTokens,
     cacheCreationTokens,
     costUsd,
+    // F050 — say HOW we got the number. A $0 because the model is not in the price
+    // table and a $0 because the call was genuinely free were the same value, and the
+    // free case is much rarer than the unknown one. Adapters that bill a non-token
+    // unit overwrite this with "estimated"/"reported" right after.
+    costBasis: args.subprocess ? "computed" : getPrice(args.provider, args.model) ? "computed" : "unpriced",
     latencyMs: 0,
     capability: args.capability,
     ts: ""
@@ -882,9 +891,6 @@ function mapFinishReason(reason) {
 }
 
 // src/providers/openai.ts
-var WHISPER_PRICE_PER_MIN = {
-  "whisper-1": 6e-3
-};
 function openaiAdapter(config = {}) {
   const baseUrl = config.baseUrl ?? "https://api.openai.com/v1";
   const base = makeOpenAICompatibleAdapter({ name: "openai", baseUrl, apiKey: config.apiKey });
@@ -945,7 +951,7 @@ function openaiAdapter(config = {}) {
       // Whisper is per-minute, not token-priced.
     });
     if (req.durationSec !== void 0) {
-      const perMinute = WHISPER_PRICE_PER_MIN[req.spec.model] ?? 0;
+      const perMinute = getMediaPrice("openai", req.spec.model)?.usd ?? 0;
       usage.costUsd = req.durationSec / 60 * perMinute;
     }
     const result = { text: data.text ?? "", usage };
@@ -985,17 +991,6 @@ function sniffMime(b) {
 }
 
 // src/providers/gemini.ts
-var GEMINI_IMAGE_PRICE_PER_IMAGE = {
-  "gemini-2.5-flash-image": 0.039,
-  // "nano-banana" — 1024px = 1290 tok
-  "gemini-3.1-flash-image": 0.067,
-  // 1K=$0.067, 2K=$0.101, 4K=$0.151
-  "gemini-3.1-flash-image-preview": 0.067,
-  "gemini-3-pro-image": 0.134,
-  // premium — 1K/2K=$0.134, 4K=$0.24
-  "gemini-3-pro-image-preview": 0.134
-  // was $0.039 — wrong (that's the flash price); pro is $0.134
-};
 function splitCached(meta) {
   const prompt = meta?.promptTokenCount ?? 0;
   const cached = meta?.cachedContentTokenCount;
@@ -1014,16 +1009,6 @@ function partsFrom(content) {
     return { inlineData: { mimeType: p.mimeType ?? "image/png", data } };
   });
 }
-var VEO_PRICE_PER_SEC = {
-  "veo-3.1-generate-preview": 0.4,
-  // standard; 4K = 0.60
-  "veo-3.1-fast-generate-preview": 0.1,
-  // 720p; 1080p = 0.12, 4K = 0.30
-  "veo-3.1-lite-generate-preview": 0.05,
-  // 720p; 1080p = 0.08
-  "veo-3.0-generate-001": 0.4,
-  "veo-3.0-fast-generate-001": 0.1
-};
 function geminiAdapter(config = {}) {
   const baseUrl = config.baseUrl ?? "https://generativelanguage.googleapis.com/v1beta";
   function resolveKey() {
@@ -1180,7 +1165,7 @@ function geminiAdapter(config = {}) {
       ...splitCached(data.usageMetadata),
       outputTokens: data.usageMetadata?.candidatesTokenCount ?? 0
     });
-    usage.costUsd = config.pricePerImage ?? GEMINI_IMAGE_PRICE_PER_IMAGE[req.spec.model] ?? 0;
+    usage.costUsd = config.pricePerImage ?? getMediaPrice("gemini", req.spec.model)?.usd ?? 0;
     return { url, usage };
   }
   async function animate(req) {
@@ -1232,8 +1217,9 @@ function geminiAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    const perSec = config.pricePerSecond ?? VEO_PRICE_PER_SEC[req.spec.model] ?? 0;
-    usage.costUsd = perSec * (req.durationSec ?? 8);
+    const perSec = config.pricePerSecond ?? getMediaPrice("gemini", req.spec.model)?.usd ?? 0;
+    usage.costUsd = perSec * (req.durationSec ?? DEFAULT_CLIP_SEC);
+    usage.costBasis = req.durationSec === void 0 ? "estimated" : "computed";
     return { url: videoUri, bytes, mimeType: "video/mp4", usage };
   }
   return { name: "gemini", chat, chatStream, image, animate, vision: chat };
@@ -1259,10 +1245,6 @@ function deepinfraAdapter(config = {}) {
 }
 
 // src/providers/openrouter.ts
-var OPENROUTER_IMAGE_PRICE_ESTIMATE = {
-  "recraft/recraft-v4.1": 0.035,
-  "recraft/recraft-v4.1-vector": 0.08
-};
 function openrouterAdapter(config = {}) {
   const baseUrl = config.baseUrl ?? "https://openrouter.ai/api/v1";
   const headers = {
@@ -1317,7 +1299,7 @@ function openrouterAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    usage.costUsd = data.usage?.cost ?? config.pricePerImage ?? OPENROUTER_IMAGE_PRICE_ESTIMATE[req.spec.model] ?? 0;
+    usage.costUsd = data.usage?.cost ?? config.pricePerImage ?? getMediaPrice("openrouter", req.spec.model)?.usd ?? 0;
     return { url: `data:${first.media_type ?? "image/png"};base64,${first.b64_json}`, usage };
   }
   return { ...base, image };
@@ -1354,12 +1336,6 @@ function deepseekAdapter(config = {}) {
 }
 
 // src/providers/mistral.ts
-var MISTRAL_OCR_PRICE_PER_PAGE = 2e-3;
-var VOXTRAL_PRICE_PER_MIN = {
-  "voxtral-mini-latest": 2e-3,
-  "voxtral-mini-2507": 2e-3,
-  "voxtral-mini-2602": 2e-3
-};
 function mistralAdapter(config = {}) {
   const baseUrl = config.baseUrl ?? "https://api.mistral.ai/v1";
   const base = makeOpenAICompatibleAdapter({ name: "mistral", baseUrl, apiKey: config.apiKey, supportsPromptCacheKey: true, supportsPrefix: true });
@@ -1401,7 +1377,7 @@ function mistralAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    usage.costUsd = pagesProcessed * (config.pricePerPage ?? MISTRAL_OCR_PRICE_PER_PAGE);
+    usage.costUsd = pagesProcessed * (config.pricePerPage ?? getMediaPrice("mistral", "ocr")?.usd ?? 0);
     return { pages, usage };
   }
   async function moderate(req) {
@@ -1495,7 +1471,7 @@ function mistralAdapter(config = {}) {
       outputTokens: 0
     });
     if (req.durationSec !== void 0) {
-      usage.costUsd = req.durationSec / 60 * (VOXTRAL_PRICE_PER_MIN[req.spec.model] ?? 0);
+      usage.costUsd = req.durationSec / 60 * (getMediaPrice("mistral", req.spec.model)?.usd ?? 0);
     }
     return { text: data.text ?? "", usage };
   }
@@ -1547,8 +1523,48 @@ function mistralAdapter(config = {}) {
   return { ...base, ocr, moderate, embedding, transcribe, batchSubmit, batchStatus, batchResults };
 }
 
+// src/providers/pronunciation.ts
+function xmlEscape(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function escapeRegex(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function assertPronunciations(list, provider) {
+  for (const p of list ?? []) {
+    if (!p.word.trim()) {
+      throw new Error(`${provider} adapter: a pronunciation entry has an empty "word".`);
+    }
+    if (p.alias !== void 0 && p.ipa !== void 0) {
+      throw new Error(
+        `${provider} adapter: pronunciation "${p.word}" sets BOTH alias and ipa. They are different instructions \u2014 alias says it differently, ipa says it precisely. Pick one.`
+      );
+    }
+    if (p.alias === void 0 && p.ipa === void 0) {
+      throw new Error(
+        `${provider} adapter: pronunciation "${p.word}" sets neither alias nor ipa, so there is nothing to say instead.`
+      );
+    }
+  }
+}
+function applyPronunciations(haystack, list, render, escape = (s) => s) {
+  const entries = (list ?? []).filter((p) => p.word.trim().length > 0);
+  if (entries.length === 0) return haystack;
+  const sorted = [...entries].sort((a, b) => escape(b.word).length - escape(a.word).length);
+  const byLower = /* @__PURE__ */ new Map();
+  for (const p of sorted) {
+    const k = escape(p.word).toLowerCase();
+    if (!byLower.has(k)) byLower.set(k, p);
+  }
+  const alternation = sorted.map((p) => escapeRegex(escape(p.word))).join("|");
+  const re = new RegExp(`(?<![\\w-])(${alternation})(?![\\w-])`, "gi");
+  return haystack.replace(re, (matched) => {
+    const entry = byLower.get(matched.toLowerCase());
+    return entry ? render(entry, matched) : matched;
+  });
+}
+
 // src/providers/elevenlabs.ts
-var ELEVENLABS_PRICE_PER_1K_CHARS = 0.15;
 var ELEVENLABS_DANISH_VOICES = {
   soren: "xj6X4BCUsv9oxohm1E8o",
   jesper: "Bl1YwS3uJac5zEOSNESn",
@@ -1559,6 +1575,17 @@ var ELEVENLABS_DANISH_VOICES = {
 function resolveVoice(nameOrId) {
   return ELEVENLABS_DANISH_VOICES[nameOrId] ?? nameOrId;
 }
+function ttsText(req) {
+  assertPronunciations(req.pronunciations, "elevenlabs");
+  for (const p of req.pronunciations ?? []) {
+    if (p.ipa !== void 0) {
+      throw new Error(
+        `elevenlabs adapter: pronunciation "${p.word}" uses ipa, which needs SSML \u2014 ElevenLabs has none. Use { alias } here, or route this call to azure.`
+      );
+    }
+  }
+  return applyPronunciations(req.text, req.pronunciations, (p) => p.alias);
+}
 function elevenlabsAdapter(config = {}) {
   const baseUrl = config.baseUrl ?? "https://api.elevenlabs.io/v1";
   const fetchImpl = config.fetch ?? fetch;
@@ -1576,7 +1603,8 @@ function elevenlabsAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    usage.costUsd = chars / 1e3 * (config.pricePer1kChars ?? ELEVENLABS_PRICE_PER_1K_CHARS);
+    usage.costUsd = chars / 1e3 * (config.pricePer1kChars ?? getMediaPrice("elevenlabs", "tts")?.usd ?? 0);
+    usage.costBasis = config.pricePer1kChars !== void 0 ? "computed" : "estimated";
     return usage;
   }
   async function dialogue(req) {
@@ -1602,7 +1630,7 @@ function elevenlabsAdapter(config = {}) {
     const res = await fetchImpl(`${baseUrl}/text-to-speech/${req.voiceId}`, {
       method: "POST",
       headers: { "xi-api-key": key(), "content-type": "application/json", accept: "audio/mpeg" },
-      body: JSON.stringify({ text: req.text, model_id: model })
+      body: JSON.stringify({ text: ttsText(req), model_id: model })
     });
     if (!res.ok) {
       const body = await res.text().catch(() => "");
@@ -1621,8 +1649,6 @@ function elevenlabsAdapter(config = {}) {
 }
 
 // src/providers/azure.ts
-var AZURE_TTS_PRICE_PER_1K_CHARS = 0.016;
-var AZURE_STT_PRICE_PER_MIN = 0.0167;
 var DEFAULT_STT_API_VERSION = "2025-10-15";
 var DEFAULT_REGION = "westeurope";
 var DEFAULT_FORMAT = "audio-24khz-48kbitrate-mono-mp3";
@@ -1662,9 +1688,6 @@ function listAzureDanishVoices() {
 function resolveAzureVoice(nameOrVoice) {
   return AZURE_DANISH_VOICES[nameOrVoice] ?? nameOrVoice;
 }
-function xmlEscape(s) {
-  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-}
 function localeOf(voice) {
   const parts = voice.split("-");
   return parts.length >= 2 ? `${parts[0]}-${parts[1]}` : "en-US";
@@ -1703,14 +1726,20 @@ function azureAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    usage.costUsd = chars / 1e3 * (config.pricePer1kChars ?? AZURE_TTS_PRICE_PER_1K_CHARS);
+    usage.costUsd = chars / 1e3 * (config.pricePer1kChars ?? getMediaPrice("azure", "tts")?.usd ?? 0);
     return usage;
   }
   async function tts(req) {
     const voice = resolveAzureVoice(req.voiceId);
     const lang = req.lang ?? localeOf(voice);
     const format = req.format ?? DEFAULT_FORMAT;
-    const escaped = xmlEscape(req.text);
+    assertPronunciations(req.pronunciations, "azure");
+    const escaped = applyPronunciations(
+      xmlEscape(req.text),
+      req.pronunciations,
+      (p, matched) => p.ipa !== void 0 ? `<phoneme alphabet='ipa' ph='${xmlEscape(p.ipa)}'>${matched}</phoneme>` : `<sub alias='${xmlEscape(p.alias)}'>${matched}</sub>`,
+      xmlEscape
+    );
     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>`;
@@ -1764,7 +1793,7 @@ function azureAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    usage.costUsd = minutes * (config.sttPricePerMin ?? AZURE_STT_PRICE_PER_MIN);
+    usage.costUsd = minutes * (config.sttPricePerMin ?? getMediaPrice("azure", "stt")?.usd ?? 0);
     const result = { text, usage };
     if (req.timestamps && req.timestamps.length > 0 && data.phrases) {
       const toSec = (ms) => (ms ?? 0) / 1e3;
@@ -1795,13 +1824,6 @@ import { readFileSync } from "fs";
 var TOKEN_ENDPOINT = "https://oauth2.googleapis.com/token";
 var DEFAULT_REGION2 = "europe-west1";
 var CLOUD_PLATFORM_SCOPE = "https://www.googleapis.com/auth/cloud-platform";
-var VERTEX_VEO_PRICE_PER_SEC = {
-  "veo-3.1-generate-preview": 0.4,
-  "veo-3.1-fast-generate-preview": 0.1,
-  "veo-3.1-lite-generate-preview": 0.05,
-  "veo-3.0-generate-001": 0.4,
-  "veo-3.0-fast-generate-001": 0.1
-};
 function base64url(input) {
   const buf = typeof input === "string" ? Buffer.from(input) : input;
   return buf.toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
@@ -1941,8 +1963,9 @@ function vertexAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    const perSec = config.pricePerSecond ?? VERTEX_VEO_PRICE_PER_SEC[req.spec.model] ?? 0;
-    usage.costUsd = perSec * (req.durationSec ?? 8);
+    const perSec = config.pricePerSecond ?? getMediaPrice("vertex", req.spec.model)?.usd ?? 0;
+    usage.costUsd = perSec * (req.durationSec ?? DEFAULT_CLIP_SEC);
+    usage.costBasis = req.durationSec === void 0 ? "estimated" : "computed";
     return { url: `vertex://${op.name}`, bytes: Buffer.from(videoB64, "base64"), mimeType: videoMime, usage };
   }
   async function vision(req) {
@@ -1994,7 +2017,6 @@ function vertexAdapter(config = {}) {
 }
 
 // src/providers/deepl.ts
-var DEEPL_PRICE_PER_1K_CHARS_ESTIMATE = 0.0217;
 function deeplAdapter(config = {}) {
   const fetchImpl = config.fetch ?? fetch;
   function key() {
@@ -2030,7 +2052,8 @@ function deeplAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    usage.costUsd = req.text.length / 1e3 * (config.pricePer1kChars ?? DEEPL_PRICE_PER_1K_CHARS_ESTIMATE);
+    usage.costUsd = req.text.length / 1e3 * (config.pricePer1kChars ?? getMediaPrice("deepl", "translate")?.usd ?? 0);
+    usage.costBasis = config.pricePer1kChars !== void 0 ? "computed" : "estimated";
     return { text, usage };
   }
   return { name: "deepl", translate };
@@ -2038,21 +2061,6 @@ function deeplAdapter(config = {}) {
 
 // src/providers/fal.ts
 import { deflateRawSync, crc32 } from "zlib";
-var FAL_IMAGE_PRICE_ESTIMATE = {
-  "fal-ai/flux/schnell": 3e-3,
-  "fal-ai/flux/dev": 0.025,
-  "fal-ai/flux-lora": 0.025,
-  "fal-ai/flux-pro": 0.05,
-  "fal-ai/flux-pro/v1.1": 0.04
-};
-var FAL_TRAIN_PRICE_ESTIMATE = 2;
-var FAL_VIDEO_PRICE_PER_SEC = {
-  // Kling 2.5 Turbo Pro i2v — the blessed FAL_KEY-only image→video route (F014
-  // contentpush spike). $0.35 for the first 5 s + $0.07/additional s = a flat
-  // $0.07/s (1080p); per-second-billed, commercial-use, not deprecated.
-  "fal-ai/kling-video/v2.5-turbo/pro/image-to-video": 0.07
-};
-var FAL_VIDEO_DEFAULT_SEC = 8;
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 function falAdapter(config = {}) {
   const doFetch = config.fetch ?? fetch;
@@ -2092,7 +2100,9 @@ function falAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    usage.costUsd = (config.pricePerImage ?? FAL_IMAGE_PRICE_ESTIMATE[req.spec.model] ?? 0) * calls;
+    const perImage = config.pricePerImage ?? getMediaPrice("fal", req.spec.model)?.usd;
+    usage.costUsd = (perImage ?? 0) * calls;
+    usage.costBasis = config.pricePerImage !== void 0 ? "computed" : "estimated";
     return { url, usage };
   }
   async function animate(req) {
@@ -2121,8 +2131,9 @@ function falAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    const perSec = config.pricePerSecond ?? FAL_VIDEO_PRICE_PER_SEC[req.spec.model] ?? 0;
-    usage.costUsd = perSec * (req.durationSec ?? FAL_VIDEO_DEFAULT_SEC);
+    const perSec = config.pricePerSecond ?? getMediaPrice("fal", req.spec.model)?.usd ?? 0;
+    usage.costUsd = perSec * (req.durationSec ?? DEFAULT_CLIP_SEC);
+    usage.costBasis = req.durationSec === void 0 ? "estimated" : "computed";
     return { url, usage };
   }
   async function trainStyle(req) {
@@ -2158,7 +2169,8 @@ function falAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    usage.costUsd = config.pricePerTraining ?? FAL_TRAIN_PRICE_ESTIMATE;
+    usage.costUsd = config.pricePerTraining ?? getMediaPrice("fal", "train")?.usd ?? 0;
+    usage.costBasis = config.pricePerTraining !== void 0 ? "computed" : "estimated";
     return { loraUrl, configUrl: configUrl ?? "", usage };
   }
   async function resolveImagesUrl(images, apiKey) {
@@ -2356,7 +2368,6 @@ function buildZip(files) {
 // src/providers/bfl.ts
 var EU_BASE2 = "https://api.eu.bfl.ai";
 var BFL_CREDIT_USD = 0.01;
-var BFL_IMAGE_PRICE = 0.06;
 var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
 function gcd(a, b) {
   return b === 0 ? a : gcd(b, a % b);
@@ -2432,7 +2443,13 @@ function bflAdapter(config = {}) {
       inputTokens: 0,
       outputTokens: 0
     });
-    usage.costUsd = typeof submit.cost === "number" ? submit.cost * BFL_CREDIT_USD : config.pricePerImage ?? BFL_IMAGE_PRICE;
+    if (typeof submit.cost === "number") {
+      usage.costUsd = submit.cost * BFL_CREDIT_USD;
+      usage.costBasis = "reported";
+    } else {
+      usage.costUsd = config.pricePerImage ?? getMediaPrice("bfl", "flux-pro-1.1-ultra-finetuned")?.usd ?? 0;
+      usage.costBasis = config.pricePerImage !== void 0 ? "computed" : "estimated";
+    }
     return { url: sample, usage };
   }
   function toBflImage(img) {
@@ -3023,9 +3040,18 @@ var podcastInputSchema = z.object({
   format: z.string().optional(),
   ...callOptions
 });
+var pronunciationSchema = z.object({
+  word: z.string(),
+  alias: z.string().optional(),
+  ipa: z.string().optional(),
+  lang: z.string().optional()
+});
 var ttsInputSchema = z.object({
   text: z.string(),
   voice: z.string(),
+  /** 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(),
   /** 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.
    *
@@ -3067,8 +3093,8 @@ var aiConfigSchema = z.object({
 });
 
 // src/version.ts
-var VERSION = "0.38.0";
-var SDK_TAG = "@broberg/ai-sdk@0.38.0";
+var VERSION = "0.40.0";
+var SDK_TAG = "@broberg/ai-sdk@0.40.0";
 
 // src/cost/sinks/upmetrics.ts
 function upmetricsSink(config) {
@@ -3108,6 +3134,11 @@ function upmetricsSink(config) {
             // capability/transport — no ingest-schema change, and without it the one
             // field built for auditability existed only in memory.
             region: usage.region,
+            // F050: HOW cost_usd was arrived at. upmetrics already distinguishes
+            // reported / computed / unpriced — we were sending an assumed number in
+            // the same field as a measured one, so their labels could not be right
+            // about our rows however carefully they were applied.
+            cost_basis: usage.costBasis ?? "computed",
             sdk: SDK_TAG
           }
         };
@@ -3611,7 +3642,15 @@ function createAI(config = {}) {
         invoke: async (spec) => {
           const adapter = pickProvider(spec.provider);
           if (!adapter.tts) throw new Error(`createAI: provider "${spec.provider}" does not support tts`);
-          return adapter.tts({ text: input.text, voiceId, lang: input.lang, format: input.format, rate: input.rate, spec });
+          return adapter.tts({
+            text: input.text,
+            voiceId,
+            lang: input.lang,
+            format: input.format,
+            rate: input.rate,
+            pronunciations: input.pronunciations,
+            spec
+          });
         }
       });
     },
@@ -3926,6 +3965,7 @@ CREATE TABLE IF NOT EXISTS ai_usage (
   cache_read_tokens INTEGER NOT NULL,
   cache_creation_tokens INTEGER NOT NULL,
   cost_usd REAL NOT NULL,
+  cost_basis TEXT NOT NULL DEFAULT 'unknown',
   latency_ms INTEGER NOT NULL,
   subprocess INTEGER NOT NULL DEFAULT 0
 )`;
@@ -3942,13 +3982,16 @@ function sqliteSink(config) {
     if (!cols.some((c) => c.name === "region")) {
       db.run(`ALTER TABLE ai_usage ADD COLUMN region TEXT NOT NULL DEFAULT 'unknown'`);
     }
+    if (!cols.some((c) => c.name === "cost_basis")) {
+      db.run(`ALTER TABLE ai_usage ADD COLUMN cost_basis TEXT NOT NULL DEFAULT 'unknown'`);
+    }
     const insert = db.prepare(
       `INSERT INTO ai_usage
          (ts, provider, model, tier, transport, capability, region, purpose,
           input_tokens, output_tokens, cache_read_tokens, cache_creation_tokens,
-          cost_usd, latency_ms, subprocess)
+          cost_usd, cost_basis, latency_ms, subprocess)
        VALUES ($ts, $provider, $model, $tier, $transport, $capability, $region, $purpose,
-          $input, $output, $cacheRead, $cacheCreation, $cost, $latency, $subprocess)`
+          $input, $output, $cacheRead, $cacheCreation, $cost, $costBasis, $latency, $subprocess)`
     );
     return insert;
   };
@@ -3969,6 +4012,7 @@ function sqliteSink(config) {
         $cacheRead: usage.cacheReadTokens,
         $cacheCreation: usage.cacheCreationTokens,
         $cost: usage.costUsd,
+        $costBasis: usage.costBasis ?? "computed",
         $latency: usage.latencyMs,
         $subprocess: usage.subprocess ? 1 : 0
       });
@@ -4061,8 +4105,10 @@ export {
   AZURE_DANISH_VOICE_LIST,
   BudgetExceededError,
   BudgetGuard,
+  DEFAULT_CLIP_SEC,
   DEFAULT_TIER_MAP,
   ELEVENLABS_DANISH_VOICES,
+  MEDIA_PRICING_CHECKED_AT,
   ModelUnavailableError,
   PRICING_STALE_AFTER_DAYS,
   SDK_TAG,
@@ -4095,10 +4141,12 @@ export {
   fromProviderToolCall,
   geminiAdapter,
   getCostSummary,
+  getMediaPrice,
   getPrice,
   httpTransport,
   imageInputSchema,
   listAzureDanishVoices,
+  listMediaPrices,
   listModels,
   listVoices,
   makeContracts,