@broberg/ai-sdk 0.27.0 → 0.29.0

package/dist/index.js

@@ -1,35 +1,17 @@
 import {
+  DEFAULT_TIER_MAP,
   ModelUnavailableError,
   listModels,
   providerIds,
   resetRegistry,
   resolveModel,
+  resolveTier,
   setAvailability
-} from "./chunk-IT7HNKLY.js";
+} from "./chunk-V2PD522L.js";
 import {
   getPrice
 } from "./chunk-LUPUAAHZ.js";
 
-// src/routing/tier-map.ts
-var DEFAULT_TIER_MAP = {
-  fast: { provider: "mistral", model: "mistral-small-latest", transport: "http" },
-  smart: { provider: "mistral", model: "mistral-large-latest", transport: "http" },
-  powerful: { provider: "mistral", model: "mistral-large-latest", transport: "http" },
-  cheap: { provider: "mistral", model: "mistral-small-latest", transport: "http" },
-  // Vision: small-latest (vision-capable, cheap EU) is the default; override to
-  // mistral-large-latest for demanding image/spatial/composition work.
-  vision: { provider: "mistral", model: "mistral-small-latest", transport: "http" },
-  // Native video understanding — Gemini leads; flash-lite is the cheap default (F019).
-  // NOT Anthropic → out of the F030 phase-out (its own EU epic if/when needed).
-  video: { provider: "gemini", model: "gemini-2.5-flash-lite", transport: "http" },
-  // NOT Anthropic → out of F030 (EU-embedding migration is its own future epic).
-  embedding: { provider: "openai", model: "text-embedding-3-small", transport: "http" }
-};
-function resolveTier(tier, override, configMap) {
-  const base = configMap?.[tier] ?? DEFAULT_TIER_MAP[tier];
-  return { ...base, ...override };
-}
-
 // src/transport/http.ts
 async function httpTransport(req) {
   if (!req.http) {
@@ -1390,13 +1372,13 @@ function elevenlabsAdapter(config = {}) {
     const audio = new Uint8Array(await res.arrayBuffer());
     return { audio, mimeType: "audio/mpeg", usage: priceFor(req.text.length, model) };
   }
-  async function listVoices() {
+  async function listVoices2() {
     const res = await fetchImpl(`${baseUrl}/voices`, { headers: { "xi-api-key": key() } });
     if (!res.ok) throw new Error(`elevenlabs voices ${res.status}`);
     const data = await res.json();
     return (data.voices ?? []).map((v) => ({ voiceId: v.voice_id, name: v.name, language: v.labels?.language }));
   }
-  return { name: "elevenlabs", dialogue, tts, listVoices };
+  return { name: "elevenlabs", dialogue, tts, listVoices: listVoices2 };
 }
 
 // src/providers/azure.ts
@@ -2449,6 +2431,143 @@ ${JSON.stringify(input.items)}`,
   };
 }
 
+// src/voices/registry.ts
+var CHECKED_AT = {
+  // All 5 curated ids confirmed by SYNTHESIS — POST /v1/text-to-speech/{id} returned
+  // 200 with distinct audio per voice (5 distinct sha256), and a fabricated id
+  // returned 404, so a 200 means something.
+  //
+  // NB: GET /v1/voices/{id} is NOT a liveness test and must not be used as one. It
+  // answers "is this voice saved in our account", and returns voice_not_found for a
+  // public/shared voice that synthesizes perfectly well. Using it cost us a false
+  // retirement (see the note on `mads` below) — the only honest liveness check for
+  // ElevenLabs is a real synthesis call, which is exactly why v1 does no live check.
+  elevenlabs: "2026-08-11",
+  // F026 (6ca38c4) verified the 6 curated names against Azure's voices/list. Not
+  // re-probed since: this machine has no Azure Speech key, and inventing a fresher
+  // date than the last real check is exactly the lie checkedAt exists to prevent.
+  azure: "2026-06-23"
+};
+var RETIRED_DEFAULT = {};
+var RETIRED = RETIRED_DEFAULT;
+var ELEVENLABS_GENDER = {
+  soren: "male",
+  jesper: "male",
+  noam: "male",
+  camilla: "female"
+};
+var NOTES = {
+  mads: "usable, but not saved to the ElevenLabs account, so the voices endpoint publishes no metadata for it (verified by synthesis 2026-08-11)"
+};
+function build() {
+  const rows = [];
+  for (const [name, id] of Object.entries(ELEVENLABS_DANISH_VOICES)) {
+    const retired = RETIRED[name];
+    rows.push({
+      id,
+      name,
+      provider: "elevenlabs",
+      // The curated ElevenLabs roster IS the Danish one (see the constant's name
+      // + F020); the multilingual model speaks it as da-DK.
+      locale: "da-DK",
+      gender: ELEVENLABS_GENDER[name],
+      available: retired === void 0,
+      status: retired === void 0 ? "available" : "retired",
+      note: retired ?? NOTES[name],
+      checkedAt: CHECKED_AT.elevenlabs
+    });
+  }
+  for (const v of AZURE_DANISH_VOICE_LIST) {
+    const retired = RETIRED[v.name];
+    rows.push({
+      id: v.voiceId,
+      name: v.name,
+      provider: "azure",
+      locale: localeOf(v.voiceId),
+      gender: v.gender,
+      available: retired === void 0,
+      status: retired === void 0 ? "available" : "retired",
+      note: retired ?? NOTES[v.name],
+      checkedAt: CHECKED_AT.azure
+    });
+  }
+  return rows;
+}
+var ROWS = build();
+function allVoices(provider) {
+  return provider ? ROWS.filter((v) => v.provider === provider) : [...ROWS];
+}
+function getVoice(nameOrId) {
+  return ROWS.find((v) => v.name === nameOrId || v.id === nameOrId);
+}
+
+// src/voices/types.ts
+var VoiceUnavailableError = class extends Error {
+  code = "voice_unavailable";
+  requested;
+  provider;
+  note;
+  constructor(requested, note, provider) {
+    super(`voice "${requested}" is unavailable${note ? ` (${note})` : ""}`);
+    this.name = "VoiceUnavailableError";
+    this.requested = requested;
+    this.note = note;
+    this.provider = provider;
+  }
+};
+
+// src/voices/resolve.ts
+function listVoices(opts = {}) {
+  return allVoices(opts.provider);
+}
+function usable(nameOrId) {
+  const v = getVoice(nameOrId);
+  return v ? v.available : true;
+}
+function idFor(nameOrId) {
+  return getVoice(nameOrId)?.id ?? nameOrId;
+}
+function checkVoice(requested, opts = {}) {
+  const entry = getVoice(requested);
+  const provider = entry?.provider;
+  if (usable(requested)) {
+    return {
+      ok: true,
+      voiceId: idFor(requested),
+      requested,
+      provider,
+      fellBack: false,
+      status: entry?.status ?? "unknown"
+    };
+  }
+  const chain = opts.fallback === void 0 ? [] : Array.isArray(opts.fallback) ? opts.fallback : [opts.fallback];
+  for (const fb of chain) {
+    if (usable(fb)) {
+      return {
+        ok: false,
+        voiceId: idFor(fb),
+        requested,
+        provider: getVoice(fb)?.provider ?? provider,
+        fellBack: true,
+        status: entry?.status ?? "retired",
+        reason: entry?.note ?? `${requested} is unavailable`
+      };
+    }
+  }
+  if (opts.throwIfUnavailable) {
+    throw new VoiceUnavailableError(requested, entry?.note, provider);
+  }
+  return {
+    ok: false,
+    voiceId: idFor(requested),
+    requested,
+    provider,
+    fellBack: false,
+    status: entry?.status ?? "retired",
+    reason: entry?.note ?? `${requested} is unavailable`
+  };
+}
+
 // src/schema/inputs.ts
 import { z } from "zod";
 var transportSchema = z.enum(["http", "subprocess"]);
@@ -2623,6 +2742,17 @@ var podcastInputSchema = z.object({
 var ttsInputSchema = z.object({
   text: z.string(),
   voice: z.string(),
+  /** 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.
+   *
+   *  THINK BEFORE SETTING THIS. It is right for batch work where any acceptable voice
+   *  will do (a generated podcast, a bulk render). It is WRONG where the voice is an
+   *  identity a human recognises — a brand voice, a house narrator: falling back means
+   *  your product suddenly speaks with a stranger's voice and says nothing about why.
+   *  There, leave it unset and let the throw alarm you. Silence WITH a message beats
+   *  the wrong audio WITHOUT one. (torrent-search-api's call on their own house voice,
+   *  2026-08-11 — they took the alarm over the fallback, deliberately.) */
+  voiceFallback: z.string().optional(),
   lang: z.string().optional(),
   format: z.string().optional(),
   rate: z.number().positive().optional(),
@@ -2650,8 +2780,8 @@ var aiConfigSchema = z.object({
 });
 
 // src/version.ts
-var VERSION = "0.27.0";
-var SDK_TAG = "@broberg/ai-sdk@0.27.0";
+var VERSION = "0.29.0";
+var SDK_TAG = "@broberg/ai-sdk@0.29.0";
 
 // src/cost/sinks/upmetrics.ts
 function upmetricsSink(config) {
@@ -3133,7 +3263,9 @@ function createAI(config = {}) {
       const inputs = input.script.map((turn) => {
         const mapped = input.voices[turn.speaker];
         if (!mapped) throw new Error(`ai.podcast: no voice mapped for speaker "${turn.speaker}"`);
-        return { text: turn.text, voiceId: resolveVoice(mapped) };
+        const res = checkVoice(mapped);
+        if (!res.ok) throw new VoiceUnavailableError(mapped, `${res.reason} \u2014 speaker "${turn.speaker}"`, res.provider);
+        return { text: turn.text, voiceId: res.voiceId };
       });
       const chars = input.script.reduce((n, t) => n + t.text.length, 0);
       return runCapability({
@@ -3154,6 +3286,7 @@ function createAI(config = {}) {
     },
     async tts(input) {
       input = ttsInputSchema.parse(input);
+      const { voiceId } = checkVoice(input.voice, { fallback: input.voiceFallback, throwIfUnavailable: true });
       return runCapability({
         primary: { ...DEFAULT_TTS_SPEC, ...input.override },
         fallback: input.fallback,
@@ -3166,7 +3299,7 @@ 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: resolveVoice(input.voice), 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, spec });
         }
       });
     },
@@ -3614,6 +3747,7 @@ export {
   StreamHttpError,
   UpmetricsCostError,
   VERSION,
+  VoiceUnavailableError,
   aiConfigSchema,
   anthropicAdapter,
   anthropicApiAdapter,
@@ -3622,6 +3756,7 @@ export {
   bflAdapter,
   bflCredits,
   chatInputSchema,
+  checkVoice,
   computeCost,
   createAI,
   deepinfraAdapter,
@@ -3642,6 +3777,7 @@ export {
   imageInputSchema,
   listAzureDanishVoices,
   listModels,
+  listVoices,
   makeContracts,
   makeOpenAICompatibleAdapter,
   messageSchema,