@broberg/ai-sdk 0.36.5 → 0.36.7

package/dist/index.d.ts

@@ -17,7 +17,7 @@ export { AvailabilitySource, AvailabilityStatus, ModelStatus, ModelUnavailableEr
 type Region = "eu" | "us" | "cn" | "unknown";
 /** Region of the endpoint a call will actually hit. Never throws — a residency
  *  reading must not be able to break a call that already succeeded. */
-declare function regionOfHost(url: string | undefined): Region;
+declare function regionOfHost(hostOrUrl: string | undefined): Region;
 /** Classify a provider REGION STRING — a Vertex/GCP location like `europe-west1`, or
  *  an Azure region like `westeurope`. Anything unrecognised is `"unknown"`: a region
  *  name we have never seen is exactly the case where guessing is most tempting and
@@ -273,7 +273,9 @@ interface ImageResult {
 }
 /** Image-to-video generation (F024) — animate a still into a short clip. */
 interface AnimateRequest {
-    /** Input image: a URL (passed through) or raw bytes (uploaded to fal storage). */
+    /** Input image: a URL (passed through) or raw bytes. Where bytes are uploaded is
+     *  the ADAPTER's business — fal uses fal storage, the Gemini/Veo default inlines
+     *  them — so do not read a storage provider out of this field. */
     image: string | Uint8Array;
     /** Motion/scene prompt, e.g. "the subject turns and smiles". */
     prompt?: string;
@@ -446,7 +448,11 @@ interface ProviderAdapter {
     translate?(req: TranslateRequest): Promise<TranslateResult>;
     vision?(req: ChatRequest): Promise<ChatResult>;
     image?(req: ImageRequest): Promise<ImageResult>;
-    /** Image-to-video generation (F024) — animate a still into a short clip. fal. */
+    /** Image-to-video generation (F024) — animate a still into a short clip. gemini
+     *  (Veo 3.1) by default; override to fal for Kling/Seedance. Name only the DEFAULT
+     *  route here — provider-doc-drift.test.ts fails if this and DEFAULT_ANIMATE_SPEC
+     *  disagree, because this sentence is the editor tooltip a consumer reads when
+     *  deciding which API key to buy. */
     animate?(req: AnimateRequest): Promise<AnimateResult>;
     /** Train a style/brand LoRA from images (F021). fal. */
     trainStyle?(req: TrainStyleRequest): Promise<TrainStyleResult>;
@@ -2200,8 +2206,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.36.5";
-declare const SDK_TAG: "@broberg/ai-sdk@0.36.5";
+declare const VERSION: "0.36.7";
+declare const SDK_TAG: "@broberg/ai-sdk@0.36.7";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.

package/dist/index.js

@@ -241,14 +241,20 @@ var HOST_REGION = {
   "openrouter.ai": "unknown",
   "router.requesty.ai": "unknown"
 };
-function regionOfHost(url) {
-  if (!url) return "unknown";
+function regionOfHost(hostOrUrl) {
+  if (!hostOrUrl) return "unknown";
+  const trimmed = hostOrUrl.trim();
+  if (!trimmed) return "unknown";
+  let host = "";
   try {
-    const host = new URL(url).host.toLowerCase();
-    return Object.hasOwn(HOST_REGION, host) ? HOST_REGION[host] : "unknown";
+    host = new URL(trimmed).host;
   } catch {
-    return "unknown";
   }
+  if (!host) {
+    host = trimmed.split("/")[0].split("@").pop().split(":")[0];
+  }
+  host = host.toLowerCase();
+  return Object.hasOwn(HOST_REGION, host) ? HOST_REGION[host] : "unknown";
 }
 var FIXED_PROVIDER_REGION = {
   // NB: mistral and deepl are deliberately ABSENT — both take a config.baseUrl, so
@@ -303,6 +309,7 @@ function classifyRegionName(name) {
   if (!name) return "unknown";
   const n = name.trim().toLowerCase();
   if (!n) return "unknown";
+  if (n === "eu" || n === "us" || n === "cn" || n === "unknown") return n;
   if (n.startsWith("europe-")) return "eu";
   if (n.startsWith("us-")) return "us";
   if (EU_REGION_NAMES.has(n)) return "eu";
@@ -952,7 +959,7 @@ function geminiAdapter(config = {}) {
   const baseUrl = config.baseUrl ?? "https://generativelanguage.googleapis.com/v1beta";
   function resolveKey() {
     const apiKey = config.apiKey ?? process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
-    if (!apiKey) throw new Error("gemini adapter: API key not set (env GOOGLE_API_KEY)");
+    if (!apiKey) throw new Error("gemini adapter: API key not set (env GOOGLE_API_KEY or GEMINI_API_KEY)");
     return apiKey;
   }
   function buildBody(req) {
@@ -1991,7 +1998,7 @@ function falAdapter(config = {}) {
   });
   async function image(req) {
     const apiKey = resolveKey();
-    if (!apiKey) throw new Error("fal adapter: FAL_KEY not set");
+    if (!apiKey) throw new Error("fal adapter: API key not set (env FAL_KEY or FAL_API_KEY)");
     const headers = authHeaders(apiKey);
     const body = { prompt: req.prompt };
     if (req.width !== void 0 && req.height !== void 0) {
@@ -2021,7 +2028,7 @@ function falAdapter(config = {}) {
   }
   async function animate(req) {
     const apiKey = resolveKey();
-    if (!apiKey) throw new Error("fal adapter: FAL_KEY not set");
+    if (!apiKey) throw new Error("fal adapter: API key not set (env FAL_KEY or FAL_API_KEY)");
     const headers = authHeaders(apiKey);
     const imageUrl = typeof req.image === "string" && /^https?:\/\//i.test(req.image) ? req.image : await uploadToFalStorage(toBytes(req.image), sniffImageType(req.image), "input", apiKey);
     const body = { image_url: imageUrl };
@@ -2051,7 +2058,7 @@ function falAdapter(config = {}) {
   }
   async function trainStyle(req) {
     const apiKey = resolveKey();
-    if (!apiKey) throw new Error("fal adapter: FAL_KEY not set");
+    if (!apiKey) throw new Error("fal adapter: API key not set (env FAL_KEY or FAL_API_KEY)");
     const headers = authHeaders(apiKey);
     const body = {
       images_data_url: await resolveImagesUrl(req.images, apiKey),
@@ -2986,8 +2993,8 @@ var aiConfigSchema = z.object({
 });
 
 // src/version.ts
-var VERSION = "0.36.5";
-var SDK_TAG = "@broberg/ai-sdk@0.36.5";
+var VERSION = "0.36.7";
+var SDK_TAG = "@broberg/ai-sdk@0.36.7";
 
 // src/cost/sinks/upmetrics.ts
 function upmetricsSink(config) {
@@ -3083,6 +3090,11 @@ var DEFAULT_ANIMATE_SPEC = {
   transport: "http"
 };
 var ANIMATE_AUDIO_DIRECTIVE = "No spoken dialogue, no talking, no voiceover. Include natural ambient background sounds that match the environment.";
+function routeHasAudio(spec) {
+  const m = spec.model.toLowerCase();
+  if (m.includes("kling") || m.includes("seedance") || m.includes("wan-")) return false;
+  return true;
+}
 var DEFAULT_BFL_FINETUNE_SPEC = {
   provider: "bfl",
   model: "flux-pro-1.1-ultra-finetuned",
@@ -3398,7 +3410,7 @@ function createAI(config = {}) {
     },
     async animate(input) {
       input = animateInputSchema.parse(input);
-      const prompt = input.prompt?.trim() ? `${input.prompt.trim()} ${ANIMATE_AUDIO_DIRECTIVE}` : ANIMATE_AUDIO_DIRECTIVE;
+      const basePrompt = input.prompt?.trim() ?? "";
       return runCapability({
         primary: withOverride(DEFAULT_ANIMATE_SPEC, input.override, "animate"),
         fallback: input.fallback,
@@ -3411,9 +3423,10 @@ function createAI(config = {}) {
         invoke: async (spec) => {
           const adapter = pickProvider(spec.provider);
           if (!adapter.animate) throw new Error(`createAI: provider "${spec.provider}" does not support animate`);
+          const prompt = routeHasAudio(spec) ? `${basePrompt} ${ANIMATE_AUDIO_DIRECTIVE}`.trim() : basePrompt;
           return adapter.animate({
             image: input.image,
-            prompt,
+            prompt: prompt || void 0,
             durationSec: input.durationSec,
             resolution: input.resolution,
             spec