@broberg/ai-sdk 0.36.6 → 0.36.7

package/dist/index.d.ts

@@ -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.6";
-declare const SDK_TAG: "@broberg/ai-sdk@0.36.6";
+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

@@ -959,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) {
@@ -1998,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) {
@@ -2028,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 };
@@ -2058,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),
@@ -2993,8 +2993,8 @@ var aiConfigSchema = z.object({
 });
 
 // src/version.ts
-var VERSION = "0.36.6";
-var SDK_TAG = "@broberg/ai-sdk@0.36.6";
+var VERSION = "0.36.7";
+var SDK_TAG = "@broberg/ai-sdk@0.36.7";
 
 // src/cost/sinks/upmetrics.ts
 function upmetricsSink(config) {
@@ -3090,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",
@@ -3405,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,
@@ -3418,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