@tanstack/ai-fal 0.8.2 → 0.9.0

package/dist/esm/adapters/image.d.ts

@@ -1,7 +1,7 @@
 import { BaseImageAdapter } from '@tanstack/ai/adapters';
 import { FalClientConfig } from '../utils.js';
 import { ImageGenerationOptions, ImageGenerationResult } from '@tanstack/ai';
-import { FalImageProviderOptions, FalModel, FalModelImageSize } from '../model-meta.js';
+import { FalImagePromptModalitiesFor, FalImageProviderOptions, FalModel, FalModelImageSize } from '../model-meta.js';
 /**
  * fal.ai image generation adapter with full type inference.
  *
@@ -22,7 +22,7 @@ import { FalImageProviderOptions, FalModel, FalModelImageSize } from '../model-m
  * })
  * ```
  */
-export declare class FalImageAdapter<TModel extends FalModel> extends BaseImageAdapter<TModel, FalImageProviderOptions<TModel>, Record<TModel, FalImageProviderOptions<TModel>>, Record<TModel, FalModelImageSize<TModel>>> {
+export declare class FalImageAdapter<TModel extends FalModel> extends BaseImageAdapter<TModel, FalImageProviderOptions<TModel>, Record<TModel, FalImageProviderOptions<TModel>>, Record<TModel, FalModelImageSize<TModel>>, Record<TModel, FalImagePromptModalitiesFor<TModel>>> {
     readonly kind: "image";
     readonly name: "fal";
     constructor(model: TModel, config?: FalClientConfig);

package/dist/esm/adapters/image.js

@@ -1,8 +1,10 @@
 import { fal } from "@fal-ai/client";
+import { resolveMediaPrompt } from "@tanstack/ai";
 import { BaseImageAdapter } from "@tanstack/ai/adapters";
 import { configureFalClient, generateId } from "../utils/client.js";
 import { buildFalUsage, takeBillableUnits } from "../utils/billing.js";
 import { mapSizeToFalFormat } from "../image/image-provider-options.js";
+import { mapImageInputsToFalFields } from "../image/image-inputs.js";
 class FalImageAdapter extends BaseImageAdapter {
   kind = "image";
   name = "fal";
@@ -16,8 +18,19 @@ class FalImageAdapter extends BaseImageAdapter {
       provider: "fal",
       model: this.model
     });
+    const resolved = resolveMediaPrompt(options.prompt);
+    if (resolved.videos.length > 0) {
+      throw new Error(
+        `fal.generateImages does not support video prompt parts on model ${this.model}.`
+      );
+    }
+    if (resolved.audios.length > 0) {
+      throw new Error(
+        `fal.generateImages does not support audio prompt parts on model ${this.model}.`
+      );
+    }
     try {
-      const input = this.buildInput(options);
+      const input = this.buildInput(options, resolved);
       const result = await fal.subscribe(this.model, { input });
       return this.transformResponse(result);
     } catch (error) {
@@ -28,12 +41,16 @@ class FalImageAdapter extends BaseImageAdapter {
       throw error;
     }
   }
-  buildInput(options) {
+  buildInput(options, resolved) {
     const sizeParams = mapSizeToFalFormat(options.size);
+    const inputFields = mapImageInputsToFalFields(this.model, resolved.images);
     const input = {
-      ...options.modelOptions,
       ...sizeParams,
-      prompt: options.prompt,
+      ...inputFields,
+      ...options.modelOptions,
+      // Media-only prompts (e.g. upscalers, background removal) omit the
+      // prompt field entirely rather than sending an empty string.
+      ...resolved.text ? { prompt: resolved.text } : {},
       num_images: options.numberOfImages
     };
     return input;

package/dist/esm/adapters/image.js.map

@@ -1 +1 @@
-{"version":3,"file":"image.js","sources":["../../../src/adapters/image.ts"],"sourcesContent":["import { fal } from '@fal-ai/client'\nimport { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport {\n  buildFalUsage,\n  configureFalClient,\n  takeBillableUnits,\n  generateId as utilGenerateId,\n} from '../utils'\nimport { mapSizeToFalFormat } from '../image/image-provider-options'\nimport type { OutputType, Result } from '@fal-ai/client'\nimport type { FalClientConfig } from '../utils'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n} from '@tanstack/ai'\nimport type {\n  FalImageProviderOptions,\n  FalModel,\n  FalModelImageSize,\n  FalModelInput,\n} from '../model-meta'\n\n/**\n * fal.ai image generation adapter with full type inference.\n *\n * Uses fal.ai's comprehensive type system to provide autocomplete\n *\n * and type safety for all 600+ supported models.\n *\n * @example\n * ```typescript\n * const adapter = falImage('fal-ai/flux/dev')\n * const result = await adapter.generateImages({\n *   model: 'fal-ai/flux/dev',\n *   prompt: 'a cat',\n *   modelOptions: {\n *     num_inference_steps: 28, // Type-safe! Autocomplete works\n *     guidance_scale: 3.5,\n *   },\n * })\n * ```\n */\nexport class FalImageAdapter<TModel extends FalModel> extends BaseImageAdapter<\n  TModel,\n  FalImageProviderOptions<TModel>,\n  Record<TModel, FalImageProviderOptions<TModel>>,\n  Record<TModel, FalModelImageSize<TModel>>\n> {\n  override readonly kind = 'image' as const\n  readonly name = 'fal' as const\n\n  constructor(model: TModel, config?: FalClientConfig) {\n    super(model, {})\n    configureFalClient(config)\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<\n      FalImageProviderOptions<TModel>,\n      FalModelImageSize<TModel>\n    >,\n  ): Promise<ImageGenerationResult> {\n    const { logger } = options\n\n    logger.request(`activity=generateImage provider=fal model=${this.model}`, {\n      provider: 'fal',\n      model: this.model,\n    })\n\n    try {\n      const input = this.buildInput(options)\n      const result = await fal.subscribe(this.model, { input })\n      return this.transformResponse(result)\n    } catch (error) {\n      logger.errors('fal.generateImage fatal', {\n        error,\n        source: 'fal.generateImage',\n      })\n      throw error\n    }\n  }\n\n  private buildInput(\n    options: ImageGenerationOptions<\n      FalImageProviderOptions<TModel>,\n      FalModelImageSize<TModel>\n    >,\n  ): FalModelInput<TModel> {\n    const sizeParams = mapSizeToFalFormat(options.size)\n    const input = {\n      ...options.modelOptions,\n      ...sizeParams,\n      prompt: options.prompt,\n      num_images: options.numberOfImages,\n    } as FalModelInput<TModel>\n    return input\n  }\n\n  protected override generateId(): string {\n    return utilGenerateId(this.name)\n  }\n\n  private transformResponse(\n    response: Result<OutputType<TModel>>,\n  ): ImageGenerationResult {\n    const images: Array<GeneratedImage> = []\n    const data = response.data\n\n    // Handle array of images (most models return { images: [...] })\n    if ('images' in data && Array.isArray(data.images)) {\n      for (const img of data.images) {\n        images.push(this.parseImage(img))\n      }\n    }\n    // Handle single image response (some models return { image: {...} })\n    else if ('image' in data && data.image && typeof data.image === 'object') {\n      images.push(this.parseImage(data.image))\n    }\n\n    if (images.length === 0) {\n      throw new Error(\n        'Unexpected fal image response shape. Expected images[] or image{}. Got keys: ' +\n          Object.keys(data).join(','),\n      )\n    }\n\n    const usage = buildFalUsage(takeBillableUnits(response.requestId))\n\n    return {\n      id: response.requestId || this.generateId(),\n      model: this.model,\n      images,\n      ...(usage ? { usage } : {}),\n    }\n  }\n\n  private parseImage(img: unknown): GeneratedImage {\n    let url: string\n    if (typeof img === 'string') {\n      url = img\n    } else if (\n      img &&\n      typeof img === 'object' &&\n      'url' in img &&\n      typeof img.url === 'string'\n    ) {\n      url = (img as { url: string }).url\n    } else {\n      throw new Error(\n        `Invalid image payload from fal response: expected string or { url: string }, received ${\n          img === null ? 'null' : typeof img\n        }`,\n      )\n    }\n\n    if (url.startsWith('data:')) {\n      const base64Match = url.match(/^data:image\\/[^;]+;base64,(.+)$/)\n      if (base64Match && base64Match[1]) {\n        return { b64Json: base64Match[1] }\n      }\n    }\n    return { url }\n  }\n}\n\nexport function createFalImage<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalImageAdapter<TModel> {\n  return new FalImageAdapter(model, config)\n}\n\nexport function falImage<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalImageAdapter<TModel> {\n  return createFalImage(model, config)\n}\n"],"names":["utilGenerateId"],"mappings":";;;;;AA2CO,MAAM,wBAAiD,iBAK5D;AAAA,EACkB,OAAO;AAAA,EAChB,OAAO;AAAA,EAEhB,YAAY,OAAe,QAA0B;AACnD,UAAM,OAAO,EAAE;AACf,uBAAmB,MAAM;AAAA,EAC3B;AAAA,EAEA,MAAM,eACJ,SAIgC;AAChC,UAAM,EAAE,WAAW;AAEnB,WAAO,QAAQ,6CAA6C,KAAK,KAAK,IAAI;AAAA,MACxE,UAAU;AAAA,MACV,OAAO,KAAK;AAAA,IAAA,CACb;AAED,QAAI;AACF,YAAM,QAAQ,KAAK,WAAW,OAAO;AACrC,YAAM,SAAS,MAAM,IAAI,UAAU,KAAK,OAAO,EAAE,OAAO;AACxD,aAAO,KAAK,kBAAkB,MAAM;AAAA,IACtC,SAAS,OAAO;AACd,aAAO,OAAO,2BAA2B;AAAA,QACvC;AAAA,QACA,QAAQ;AAAA,MAAA,CACT;AACD,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,WACN,SAIuB;AACvB,UAAM,aAAa,mBAAmB,QAAQ,IAAI;AAClD,UAAM,QAAQ;AAAA,MACZ,GAAG,QAAQ;AAAA,MACX,GAAG;AAAA,MACH,QAAQ,QAAQ;AAAA,MAChB,YAAY,QAAQ;AAAA,IAAA;AAEtB,WAAO;AAAA,EACT;AAAA,EAEmB,aAAqB;AACtC,WAAOA,WAAe,KAAK,IAAI;AAAA,EACjC;AAAA,EAEQ,kBACN,UACuB;AACvB,UAAM,SAAgC,CAAA;AACtC,UAAM,OAAO,SAAS;AAGtB,QAAI,YAAY,QAAQ,MAAM,QAAQ,KAAK,MAAM,GAAG;AAClD,iBAAW,OAAO,KAAK,QAAQ;AAC7B,eAAO,KAAK,KAAK,WAAW,GAAG,CAAC;AAAA,MAClC;AAAA,IACF,WAES,WAAW,QAAQ,KAAK,SAAS,OAAO,KAAK,UAAU,UAAU;AACxE,aAAO,KAAK,KAAK,WAAW,KAAK,KAAK,CAAC;AAAA,IACzC;AAEA,QAAI,OAAO,WAAW,GAAG;AACvB,YAAM,IAAI;AAAA,QACR,kFACE,OAAO,KAAK,IAAI,EAAE,KAAK,GAAG;AAAA,MAAA;AAAA,IAEhC;AAEA,UAAM,QAAQ,cAAc,kBAAkB,SAAS,SAAS,CAAC;AAEjE,WAAO;AAAA,MACL,IAAI,SAAS,aAAa,KAAK,WAAA;AAAA,MAC/B,OAAO,KAAK;AAAA,MACZ;AAAA,MACA,GAAI,QAAQ,EAAE,UAAU,CAAA;AAAA,IAAC;AAAA,EAE7B;AAAA,EAEQ,WAAW,KAA8B;AAC/C,QAAI;AACJ,QAAI,OAAO,QAAQ,UAAU;AAC3B,YAAM;AAAA,IACR,WACE,OACA,OAAO,QAAQ,YACf,SAAS,OACT,OAAO,IAAI,QAAQ,UACnB;AACA,YAAO,IAAwB;AAAA,IACjC,OAAO;AACL,YAAM,IAAI;AAAA,QACR,yFACE,QAAQ,OAAO,SAAS,OAAO,GACjC;AAAA,MAAA;AAAA,IAEJ;AAEA,QAAI,IAAI,WAAW,OAAO,GAAG;AAC3B,YAAM,cAAc,IAAI,MAAM,iCAAiC;AAC/D,UAAI,eAAe,YAAY,CAAC,GAAG;AACjC,eAAO,EAAE,SAAS,YAAY,CAAC,EAAA;AAAA,MACjC;AAAA,IACF;AACA,WAAO,EAAE,IAAA;AAAA,EACX;AACF;AAEO,SAAS,eACd,OACA,QACyB;AACzB,SAAO,IAAI,gBAAgB,OAAO,MAAM;AAC1C;AAEO,SAAS,SACd,OACA,QACyB;AACzB,SAAO,eAAe,OAAO,MAAM;AACrC;"}
+{"version":3,"file":"image.js","sources":["../../../src/adapters/image.ts"],"sourcesContent":["import { fal } from '@fal-ai/client'\nimport { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport {\n  buildFalUsage,\n  configureFalClient,\n  takeBillableUnits,\n  generateId as utilGenerateId,\n} from '../utils'\nimport { mapSizeToFalFormat } from '../image/image-provider-options'\nimport { mapImageInputsToFalFields } from '../image/image-inputs'\nimport type { OutputType, Result } from '@fal-ai/client'\nimport type { FalClientConfig } from '../utils'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n  ResolvedMediaPrompt,\n} from '@tanstack/ai'\nimport type {\n  FalImagePromptModalitiesFor,\n  FalImageProviderOptions,\n  FalModel,\n  FalModelImageSize,\n  FalModelInput,\n} from '../model-meta'\n\n/**\n * fal.ai image generation adapter with full type inference.\n *\n * Uses fal.ai's comprehensive type system to provide autocomplete\n *\n * and type safety for all 600+ supported models.\n *\n * @example\n * ```typescript\n * const adapter = falImage('fal-ai/flux/dev')\n * const result = await adapter.generateImages({\n *   model: 'fal-ai/flux/dev',\n *   prompt: 'a cat',\n *   modelOptions: {\n *     num_inference_steps: 28, // Type-safe! Autocomplete works\n *     guidance_scale: 3.5,\n *   },\n * })\n * ```\n */\nexport class FalImageAdapter<TModel extends FalModel> extends BaseImageAdapter<\n  TModel,\n  FalImageProviderOptions<TModel>,\n  Record<TModel, FalImageProviderOptions<TModel>>,\n  Record<TModel, FalModelImageSize<TModel>>,\n  Record<TModel, FalImagePromptModalitiesFor<TModel>>\n> {\n  override readonly kind = 'image' as const\n  readonly name = 'fal' as const\n\n  constructor(model: TModel, config?: FalClientConfig) {\n    super(model, {})\n    configureFalClient(config)\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<\n      FalImageProviderOptions<TModel>,\n      FalModelImageSize<TModel>\n    >,\n  ): Promise<ImageGenerationResult> {\n    const { logger } = options\n\n    logger.request(`activity=generateImage provider=fal model=${this.model}`, {\n      provider: 'fal',\n      model: this.model,\n    })\n\n    const resolved = resolveMediaPrompt(options.prompt)\n\n    if (resolved.videos.length > 0) {\n      throw new Error(\n        `fal.generateImages does not support video prompt parts on model ${this.model}.`,\n      )\n    }\n    if (resolved.audios.length > 0) {\n      throw new Error(\n        `fal.generateImages does not support audio prompt parts on model ${this.model}.`,\n      )\n    }\n\n    try {\n      const input = this.buildInput(options, resolved)\n      const result = await fal.subscribe(this.model, { input })\n      return this.transformResponse(result)\n    } catch (error) {\n      logger.errors('fal.generateImage fatal', {\n        error,\n        source: 'fal.generateImage',\n      })\n      throw error\n    }\n  }\n\n  private buildInput(\n    options: ImageGenerationOptions<\n      FalImageProviderOptions<TModel>,\n      FalModelImageSize<TModel>\n    >,\n    resolved: ResolvedMediaPrompt,\n  ): FalModelInput<TModel> {\n    const sizeParams = mapSizeToFalFormat(options.size)\n    // Order matters: size and derived image-input fields first, then\n    // modelOptions (so explicit user overrides win for mask_url /\n    // control_image_url / reference_image_urls), then the call-controlled\n    // prompt / num_images, which always take precedence.\n    const inputFields = mapImageInputsToFalFields(this.model, resolved.images)\n    const input = {\n      ...sizeParams,\n      ...inputFields,\n      ...options.modelOptions,\n      // Media-only prompts (e.g. upscalers, background removal) omit the\n      // prompt field entirely rather than sending an empty string.\n      ...(resolved.text ? { prompt: resolved.text } : {}),\n      num_images: options.numberOfImages,\n    } as FalModelInput<TModel>\n    return input\n  }\n\n  protected override generateId(): string {\n    return utilGenerateId(this.name)\n  }\n\n  private transformResponse(\n    response: Result<OutputType<TModel>>,\n  ): ImageGenerationResult {\n    const images: Array<GeneratedImage> = []\n    const data = response.data\n\n    // Handle array of images (most models return { images: [...] })\n    if ('images' in data && Array.isArray(data.images)) {\n      for (const img of data.images) {\n        images.push(this.parseImage(img))\n      }\n    }\n    // Handle single image response (some models return { image: {...} })\n    else if ('image' in data && data.image && typeof data.image === 'object') {\n      images.push(this.parseImage(data.image))\n    }\n\n    if (images.length === 0) {\n      throw new Error(\n        'Unexpected fal image response shape. Expected images[] or image{}. Got keys: ' +\n          Object.keys(data).join(','),\n      )\n    }\n\n    const usage = buildFalUsage(takeBillableUnits(response.requestId))\n\n    return {\n      id: response.requestId || this.generateId(),\n      model: this.model,\n      images,\n      ...(usage ? { usage } : {}),\n    }\n  }\n\n  private parseImage(img: unknown): GeneratedImage {\n    let url: string\n    if (typeof img === 'string') {\n      url = img\n    } else if (\n      img &&\n      typeof img === 'object' &&\n      'url' in img &&\n      typeof img.url === 'string'\n    ) {\n      url = (img as { url: string }).url\n    } else {\n      throw new Error(\n        `Invalid image payload from fal response: expected string or { url: string }, received ${\n          img === null ? 'null' : typeof img\n        }`,\n      )\n    }\n\n    if (url.startsWith('data:')) {\n      const base64Match = url.match(/^data:image\\/[^;]+;base64,(.+)$/)\n      if (base64Match && base64Match[1]) {\n        return { b64Json: base64Match[1] }\n      }\n    }\n    return { url }\n  }\n}\n\nexport function createFalImage<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalImageAdapter<TModel> {\n  return new FalImageAdapter(model, config)\n}\n\nexport function falImage<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalImageAdapter<TModel> {\n  return createFalImage(model, config)\n}\n"],"names":["utilGenerateId"],"mappings":";;;;;;;AA+CO,MAAM,wBAAiD,iBAM5D;AAAA,EACkB,OAAO;AAAA,EAChB,OAAO;AAAA,EAEhB,YAAY,OAAe,QAA0B;AACnD,UAAM,OAAO,EAAE;AACf,uBAAmB,MAAM;AAAA,EAC3B;AAAA,EAEA,MAAM,eACJ,SAIgC;AAChC,UAAM,EAAE,WAAW;AAEnB,WAAO,QAAQ,6CAA6C,KAAK,KAAK,IAAI;AAAA,MACxE,UAAU;AAAA,MACV,OAAO,KAAK;AAAA,IAAA,CACb;AAED,UAAM,WAAW,mBAAmB,QAAQ,MAAM;AAElD,QAAI,SAAS,OAAO,SAAS,GAAG;AAC9B,YAAM,IAAI;AAAA,QACR,mEAAmE,KAAK,KAAK;AAAA,MAAA;AAAA,IAEjF;AACA,QAAI,SAAS,OAAO,SAAS,GAAG;AAC9B,YAAM,IAAI;AAAA,QACR,mEAAmE,KAAK,KAAK;AAAA,MAAA;AAAA,IAEjF;AAEA,QAAI;AACF,YAAM,QAAQ,KAAK,WAAW,SAAS,QAAQ;AAC/C,YAAM,SAAS,MAAM,IAAI,UAAU,KAAK,OAAO,EAAE,OAAO;AACxD,aAAO,KAAK,kBAAkB,MAAM;AAAA,IACtC,SAAS,OAAO;AACd,aAAO,OAAO,2BAA2B;AAAA,QACvC;AAAA,QACA,QAAQ;AAAA,MAAA,CACT;AACD,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,WACN,SAIA,UACuB;AACvB,UAAM,aAAa,mBAAmB,QAAQ,IAAI;AAKlD,UAAM,cAAc,0BAA0B,KAAK,OAAO,SAAS,MAAM;AACzE,UAAM,QAAQ;AAAA,MACZ,GAAG;AAAA,MACH,GAAG;AAAA,MACH,GAAG,QAAQ;AAAA;AAAA;AAAA,MAGX,GAAI,SAAS,OAAO,EAAE,QAAQ,SAAS,KAAA,IAAS,CAAA;AAAA,MAChD,YAAY,QAAQ;AAAA,IAAA;AAEtB,WAAO;AAAA,EACT;AAAA,EAEmB,aAAqB;AACtC,WAAOA,WAAe,KAAK,IAAI;AAAA,EACjC;AAAA,EAEQ,kBACN,UACuB;AACvB,UAAM,SAAgC,CAAA;AACtC,UAAM,OAAO,SAAS;AAGtB,QAAI,YAAY,QAAQ,MAAM,QAAQ,KAAK,MAAM,GAAG;AAClD,iBAAW,OAAO,KAAK,QAAQ;AAC7B,eAAO,KAAK,KAAK,WAAW,GAAG,CAAC;AAAA,MAClC;AAAA,IACF,WAES,WAAW,QAAQ,KAAK,SAAS,OAAO,KAAK,UAAU,UAAU;AACxE,aAAO,KAAK,KAAK,WAAW,KAAK,KAAK,CAAC;AAAA,IACzC;AAEA,QAAI,OAAO,WAAW,GAAG;AACvB,YAAM,IAAI;AAAA,QACR,kFACE,OAAO,KAAK,IAAI,EAAE,KAAK,GAAG;AAAA,MAAA;AAAA,IAEhC;AAEA,UAAM,QAAQ,cAAc,kBAAkB,SAAS,SAAS,CAAC;AAEjE,WAAO;AAAA,MACL,IAAI,SAAS,aAAa,KAAK,WAAA;AAAA,MAC/B,OAAO,KAAK;AAAA,MACZ;AAAA,MACA,GAAI,QAAQ,EAAE,UAAU,CAAA;AAAA,IAAC;AAAA,EAE7B;AAAA,EAEQ,WAAW,KAA8B;AAC/C,QAAI;AACJ,QAAI,OAAO,QAAQ,UAAU;AAC3B,YAAM;AAAA,IACR,WACE,OACA,OAAO,QAAQ,YACf,SAAS,OACT,OAAO,IAAI,QAAQ,UACnB;AACA,YAAO,IAAwB;AAAA,IACjC,OAAO;AACL,YAAM,IAAI;AAAA,QACR,yFACE,QAAQ,OAAO,SAAS,OAAO,GACjC;AAAA,MAAA;AAAA,IAEJ;AAEA,QAAI,IAAI,WAAW,OAAO,GAAG;AAC3B,YAAM,cAAc,IAAI,MAAM,iCAAiC;AAC/D,UAAI,eAAe,YAAY,CAAC,GAAG;AACjC,eAAO,EAAE,SAAS,YAAY,CAAC,EAAA;AAAA,MACjC;AAAA,IACF;AACA,WAAO,EAAE,IAAA;AAAA,EACX;AACF;AAEO,SAAS,eACd,OACA,QACyB;AACzB,SAAO,IAAI,gBAAgB,OAAO,MAAM;AAC1C;AAEO,SAAS,SACd,OACA,QACyB;AACzB,SAAO,eAAe,OAAO,MAAM;AACrC;"}

package/dist/esm/adapters/video.d.ts

@@ -1,6 +1,6 @@
 import { BaseVideoAdapter } from '@tanstack/ai/adapters';
 import { VideoGenerationOptions, VideoJobResult, VideoStatusResult, VideoUrlResult } from '@tanstack/ai';
-import { FalModel, FalModelVideoSize, FalVideoProviderOptions } from '../model-meta.js';
+import { FalModel, FalModelVideoSize, FalVideoPromptModalitiesFor, FalVideoProviderOptions } from '../model-meta.js';
 import { FalClientConfig } from '../utils.js';
 /**
  * fal.ai video generation adapter.
@@ -11,7 +11,7 @@ import { FalClientConfig } from '../utils.js';
  *
  * @experimental Video generation is an experimental feature and may change.
  */
-export declare class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<TModel, FalVideoProviderOptions<TModel>, Record<TModel, FalVideoProviderOptions<TModel>>, Record<TModel, FalModelVideoSize<TModel>>> {
+export declare class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<TModel, FalVideoProviderOptions<TModel>, Record<TModel, FalVideoProviderOptions<TModel>>, Record<TModel, FalModelVideoSize<TModel>>, Record<TModel, FalVideoPromptModalitiesFor<TModel>>> {
     readonly kind: "video";
     readonly name: "fal";
     constructor(model: TModel, config?: FalClientConfig);

package/dist/esm/adapters/video.js

@@ -1,8 +1,46 @@
 import { fal } from "@fal-ai/client";
+import { resolveMediaPrompt } from "@tanstack/ai";
 import { BaseVideoAdapter } from "@tanstack/ai/adapters";
 import { configureFalClient, generateId } from "../utils/client.js";
 import { buildFalUsage, takeBillableUnits } from "../utils/billing.js";
 import { mapVideoSizeToFalFormat } from "../video/video-provider-options.js";
+import { mapImageInputsToFalVideoFields } from "../image/image-inputs.js";
+function mapVideoInputsToFalFields(videoInputs) {
+  if (!videoInputs || videoInputs.length === 0) return {};
+  const references = [];
+  const sources = [];
+  for (const part of videoInputs) {
+    const url = videoPartToUrl(part);
+    if (part.metadata?.role === "reference" || part.metadata?.role === "character") {
+      references.push(url);
+    } else {
+      sources.push(url);
+    }
+  }
+  const out = {};
+  if (references.length > 0) out.reference_video_urls = references;
+  if (sources.length === 1) {
+    out.video_url = sources[0];
+  } else if (sources.length > 1) {
+    out.video_urls = sources;
+  }
+  return out;
+}
+function mapAudioInputsToFalFields(audioInputs) {
+  if (!audioInputs || audioInputs.length === 0) return {};
+  const [part, ...rest] = audioInputs;
+  if (!part || rest.length > 0) {
+    throw new Error(
+      `fal: exactly one audio prompt part is supported (received ${audioInputs.length}).`
+    );
+  }
+  return {
+    audio_url: part.source.type === "url" ? part.source.value : `data:${part.source.mimeType};base64,${part.source.value}`
+  };
+}
+function videoPartToUrl(part) {
+  return part.source.type === "url" ? part.source.value : `data:${part.source.mimeType};base64,${part.source.value}`;
+}
 function mapFalStatusToVideoStatus(falStatus) {
   switch (falStatus) {
     case "IN_QUEUE":
@@ -23,17 +61,31 @@ class FalVideoAdapter extends BaseVideoAdapter {
     configureFalClient(config);
   }
   async createVideoJob(options) {
-    const { prompt, size, duration, modelOptions, logger } = options;
+    const { size, duration, modelOptions, logger } = options;
     logger.request(`activity=generateVideo provider=fal model=${this.model}`, {
       provider: "fal",
       model: this.model
     });
     try {
+      const resolved = resolveMediaPrompt(options.prompt);
       const sizeParams = mapVideoSizeToFalFormat(size);
+      const inputImageFields = mapImageInputsToFalVideoFields(
+        this.model,
+        resolved.images
+      );
+      const videoFields = mapVideoInputsToFalFields(resolved.videos);
+      const audioFields = mapAudioInputsToFalFields(resolved.audios);
       const input = {
-        ...modelOptions,
         ...sizeParams,
-        prompt,
+        ...inputImageFields,
+        ...videoFields,
+        ...audioFields,
+        // modelOptions applied after derived media fields so explicit user
+        // overrides (video_url, reference_video_urls, audio_url, ...) win.
+        ...modelOptions,
+        // Media-only prompts omit the prompt field rather than sending an
+        // empty string (e.g. pure image-to-video endpoints).
+        ...resolved.text ? { prompt: resolved.text } : {},
         ...duration ? { duration } : {}
       };
       const { request_id } = await fal.queue.submit(this.model, {

package/dist/esm/adapters/video.js.map

@@ -1 +1 @@
-{"version":3,"file":"video.js","sources":["../../../src/adapters/video.ts"],"sourcesContent":["import { fal } from '@fal-ai/client'\nimport { BaseVideoAdapter } from '@tanstack/ai/adapters'\nimport {\n  buildFalUsage,\n  configureFalClient,\n  takeBillableUnits,\n  generateId as utilGenerateId,\n} from '../utils'\nimport { mapVideoSizeToFalFormat } from '../video/video-provider-options'\nimport type {\n  VideoGenerationOptions,\n  VideoJobResult,\n  VideoStatusResult,\n  VideoUrlResult,\n} from '@tanstack/ai'\nimport type {\n  FalModel,\n  FalModelInput,\n  FalModelVideoSize,\n  FalVideoProviderOptions,\n} from '../model-meta'\nimport type { FalClientConfig } from '../utils'\n\ntype FalQueueStatus = 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED'\n\ninterface FalStatusResponse {\n  status: FalQueueStatus\n  queue_position?: number\n  logs?: Array<{ message: string }>\n}\n\ninterface FalVideoResultData {\n  video?: { url: string }\n  video_url?: string\n}\n\n/**\n * Maps fal.ai queue status to TanStack AI video status.\n *\n * Note: fal.ai does not return a FAILED queue status. Errors surface\n * as exceptions when fetching results from a COMPLETED job (e.g. 422\n * validation errors). Those are handled in getVideoUrl().\n */\nfunction mapFalStatusToVideoStatus(\n  falStatus: FalQueueStatus,\n): VideoStatusResult['status'] {\n  switch (falStatus) {\n    case 'IN_QUEUE':\n      return 'pending'\n    case 'IN_PROGRESS':\n      return 'processing'\n    case 'COMPLETED':\n      return 'completed'\n    default:\n      return 'processing'\n  }\n}\n\n/**\n * fal.ai video generation adapter.\n * Supports MiniMax, Luma, Kling, Hunyuan, and other fal.ai video models.\n *\n * Uses fal.ai's comprehensive type system to provide autocomplete\n * and type safety for all supported video models.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<\n  TModel,\n  FalVideoProviderOptions<TModel>,\n  Record<TModel, FalVideoProviderOptions<TModel>>,\n  Record<TModel, FalModelVideoSize<TModel>>\n> {\n  override readonly kind = 'video' as const\n  readonly name = 'fal' as const\n\n  constructor(model: TModel, config?: FalClientConfig) {\n    super({}, model)\n    configureFalClient(config)\n  }\n\n  async createVideoJob(\n    options: VideoGenerationOptions<\n      FalVideoProviderOptions<TModel>,\n      FalModelVideoSize<TModel>\n    >,\n  ): Promise<VideoJobResult> {\n    const { prompt, size, duration, modelOptions, logger } = options\n\n    logger.request(`activity=generateVideo provider=fal model=${this.model}`, {\n      provider: 'fal',\n      model: this.model,\n    })\n\n    try {\n      const sizeParams = mapVideoSizeToFalFormat(size)\n\n      const input = {\n        ...modelOptions,\n        ...sizeParams,\n        prompt,\n        ...(duration ? { duration } : {}),\n      } as FalModelInput<TModel>\n\n      // Submit to queue and get request ID\n      const { request_id } = await fal.queue.submit(this.model, {\n        input,\n      })\n\n      return {\n        jobId: request_id,\n        model: this.model,\n      }\n    } catch (error) {\n      logger.errors('fal.createVideoJob fatal', {\n        error,\n        source: 'fal.createVideoJob',\n      })\n      throw error\n    }\n  }\n\n  async getVideoStatus(jobId: string): Promise<VideoStatusResult> {\n    const statusResponse = (await fal.queue.status(this.model, {\n      requestId: jobId,\n      logs: true,\n    })) as FalStatusResponse\n\n    return {\n      jobId,\n      status: mapFalStatusToVideoStatus(statusResponse.status),\n      ...(statusResponse.queue_position != null\n        ? {\n            progress: Math.max(0, 100 - statusResponse.queue_position * 10),\n          }\n        : {}),\n    }\n  }\n\n  async getVideoUrl(jobId: string): Promise<VideoUrlResult> {\n    let result\n    try {\n      result = await fal.queue.result(this.model, {\n        requestId: jobId,\n      })\n    } catch (error: unknown) {\n      // fal.ai may report COMPLETED status but throw on result fetch\n      // (e.g. 422 validation errors). Extract the detailed error info.\n      const err = error as { body?: { detail?: unknown }; message?: string }\n      const detail = err.body?.detail\n      if (Array.isArray(detail)) {\n        const messages = detail.map(\n          (d: { msg?: string; loc?: Array<string> }) =>\n            d.loc ? `${d.loc.join('.')}: ${d.msg}` : d.msg,\n        )\n        throw new Error(`Video generation failed: ${messages.join('; ')}`)\n      }\n      throw new Error(\n        `Failed to retrieve video result: ${err.message || String(error)}`,\n      )\n    }\n\n    const data = result.data as FalVideoResultData\n\n    // Different models return video URL in different formats\n    const url = data.video?.url || data.video_url\n    if (!url) {\n      throw new Error('Video URL not found in response')\n    }\n\n    const usage = buildFalUsage(takeBillableUnits(result.requestId))\n\n    return {\n      jobId,\n      url,\n      ...(usage ? { usage } : {}),\n    }\n  }\n\n  protected override generateId(): string {\n    return utilGenerateId(this.name)\n  }\n}\n\n/**\n * Create a fal.ai video adapter with an explicit API key.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function createFalVideo<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalVideoAdapter<TModel> {\n  return new FalVideoAdapter(model, config)\n}\n\n/**\n * Create a fal.ai video adapter using config.apiKey or the FAL_KEY environment variable.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function falVideo<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalVideoAdapter<TModel> {\n  return createFalVideo(model, config)\n}\n"],"names":["utilGenerateId"],"mappings":"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"}
+{"version":3,"file":"video.js","sources":["../../../src/adapters/video.ts"],"sourcesContent":["import { fal } from '@fal-ai/client'\nimport { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseVideoAdapter } from '@tanstack/ai/adapters'\nimport {\n  buildFalUsage,\n  configureFalClient,\n  takeBillableUnits,\n  generateId as utilGenerateId,\n} from '../utils'\nimport { mapVideoSizeToFalFormat } from '../video/video-provider-options'\nimport { mapImageInputsToFalVideoFields } from '../image/image-inputs'\nimport type {\n  AudioPart,\n  MediaInputMetadata,\n  VideoGenerationOptions,\n  VideoJobResult,\n  VideoPart,\n  VideoStatusResult,\n  VideoUrlResult,\n} from '@tanstack/ai'\nimport type {\n  FalModel,\n  FalModelInput,\n  FalModelVideoSize,\n  FalVideoPromptModalitiesFor,\n  FalVideoProviderOptions,\n} from '../model-meta'\nimport type { FalClientConfig } from '../utils'\n\n/**\n * Map video conditioning inputs onto fal field names.\n * Video-to-video endpoints on fal almost universally use `video_url`; the\n * occasional model takes `video_urls` (rare). Mirror the image-input logic\n * positionally with a `reference` role escape hatch via `reference_video_urls`.\n */\nfunction mapVideoInputsToFalFields(\n  videoInputs?: ReadonlyArray<VideoPart<MediaInputMetadata>>,\n): Record<string, unknown> {\n  if (!videoInputs || videoInputs.length === 0) return {}\n  const references: Array<string> = []\n  const sources: Array<string> = []\n  for (const part of videoInputs) {\n    const url = videoPartToUrl(part)\n    if (\n      part.metadata?.role === 'reference' ||\n      part.metadata?.role === 'character'\n    ) {\n      references.push(url)\n    } else {\n      sources.push(url)\n    }\n  }\n  const out: Record<string, unknown> = {}\n  if (references.length > 0) out.reference_video_urls = references\n  if (sources.length === 1) {\n    out.video_url = sources[0]\n  } else if (sources.length > 1) {\n    out.video_urls = sources\n  }\n  return out\n}\n\nfunction mapAudioInputsToFalFields(\n  audioInputs?: ReadonlyArray<AudioPart<MediaInputMetadata>>,\n): Record<string, unknown> {\n  if (!audioInputs || audioInputs.length === 0) return {}\n  const [part, ...rest] = audioInputs\n  if (!part || rest.length > 0) {\n    throw new Error(\n      `fal: exactly one audio prompt part is supported (received ${audioInputs.length}).`,\n    )\n  }\n  return {\n    audio_url:\n      part.source.type === 'url'\n        ? part.source.value\n        : `data:${part.source.mimeType};base64,${part.source.value}`,\n  }\n}\n\nfunction videoPartToUrl(part: VideoPart<MediaInputMetadata>): string {\n  return part.source.type === 'url'\n    ? part.source.value\n    : `data:${part.source.mimeType};base64,${part.source.value}`\n}\n\ntype FalQueueStatus = 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED'\n\ninterface FalStatusResponse {\n  status: FalQueueStatus\n  queue_position?: number\n  logs?: Array<{ message: string }>\n}\n\ninterface FalVideoResultData {\n  video?: { url: string }\n  video_url?: string\n}\n\n/**\n * Maps fal.ai queue status to TanStack AI video status.\n *\n * Note: fal.ai does not return a FAILED queue status. Errors surface\n * as exceptions when fetching results from a COMPLETED job (e.g. 422\n * validation errors). Those are handled in getVideoUrl().\n */\nfunction mapFalStatusToVideoStatus(\n  falStatus: FalQueueStatus,\n): VideoStatusResult['status'] {\n  switch (falStatus) {\n    case 'IN_QUEUE':\n      return 'pending'\n    case 'IN_PROGRESS':\n      return 'processing'\n    case 'COMPLETED':\n      return 'completed'\n    default:\n      return 'processing'\n  }\n}\n\n/**\n * fal.ai video generation adapter.\n * Supports MiniMax, Luma, Kling, Hunyuan, and other fal.ai video models.\n *\n * Uses fal.ai's comprehensive type system to provide autocomplete\n * and type safety for all supported video models.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<\n  TModel,\n  FalVideoProviderOptions<TModel>,\n  Record<TModel, FalVideoProviderOptions<TModel>>,\n  Record<TModel, FalModelVideoSize<TModel>>,\n  Record<TModel, FalVideoPromptModalitiesFor<TModel>>\n> {\n  override readonly kind = 'video' as const\n  readonly name = 'fal' as const\n\n  constructor(model: TModel, config?: FalClientConfig) {\n    super({}, model)\n    configureFalClient(config)\n  }\n\n  async createVideoJob(\n    options: VideoGenerationOptions<\n      FalVideoProviderOptions<TModel>,\n      FalModelVideoSize<TModel>\n    >,\n  ): Promise<VideoJobResult> {\n    const { size, duration, modelOptions, logger } = options\n\n    logger.request(`activity=generateVideo provider=fal model=${this.model}`, {\n      provider: 'fal',\n      model: this.model,\n    })\n\n    try {\n      const resolved = resolveMediaPrompt(options.prompt)\n      const sizeParams = mapVideoSizeToFalFormat(size)\n      const inputImageFields = mapImageInputsToFalVideoFields(\n        this.model,\n        resolved.images,\n      )\n      const videoFields = mapVideoInputsToFalFields(resolved.videos)\n      const audioFields = mapAudioInputsToFalFields(resolved.audios)\n\n      const input = {\n        ...sizeParams,\n        ...inputImageFields,\n        ...videoFields,\n        ...audioFields,\n        // modelOptions applied after derived media fields so explicit user\n        // overrides (video_url, reference_video_urls, audio_url, ...) win.\n        ...modelOptions,\n        // Media-only prompts omit the prompt field rather than sending an\n        // empty string (e.g. pure image-to-video endpoints).\n        ...(resolved.text ? { prompt: resolved.text } : {}),\n        ...(duration ? { duration } : {}),\n      } as FalModelInput<TModel>\n\n      // Submit to queue and get request ID\n      const { request_id } = await fal.queue.submit(this.model, {\n        input,\n      })\n\n      return {\n        jobId: request_id,\n        model: this.model,\n      }\n    } catch (error) {\n      logger.errors('fal.createVideoJob fatal', {\n        error,\n        source: 'fal.createVideoJob',\n      })\n      throw error\n    }\n  }\n\n  async getVideoStatus(jobId: string): Promise<VideoStatusResult> {\n    const statusResponse = (await fal.queue.status(this.model, {\n      requestId: jobId,\n      logs: true,\n    })) as FalStatusResponse\n\n    return {\n      jobId,\n      status: mapFalStatusToVideoStatus(statusResponse.status),\n      ...(statusResponse.queue_position != null\n        ? {\n            progress: Math.max(0, 100 - statusResponse.queue_position * 10),\n          }\n        : {}),\n    }\n  }\n\n  async getVideoUrl(jobId: string): Promise<VideoUrlResult> {\n    let result\n    try {\n      result = await fal.queue.result(this.model, {\n        requestId: jobId,\n      })\n    } catch (error: unknown) {\n      // fal.ai may report COMPLETED status but throw on result fetch\n      // (e.g. 422 validation errors). Extract the detailed error info.\n      const err = error as { body?: { detail?: unknown }; message?: string }\n      const detail = err.body?.detail\n      if (Array.isArray(detail)) {\n        const messages = detail.map(\n          (d: { msg?: string; loc?: Array<string> }) =>\n            d.loc ? `${d.loc.join('.')}: ${d.msg}` : d.msg,\n        )\n        throw new Error(`Video generation failed: ${messages.join('; ')}`)\n      }\n      throw new Error(\n        `Failed to retrieve video result: ${err.message || String(error)}`,\n      )\n    }\n\n    const data = result.data as FalVideoResultData\n\n    // Different models return video URL in different formats\n    const url = data.video?.url || data.video_url\n    if (!url) {\n      throw new Error('Video URL not found in response')\n    }\n\n    const usage = buildFalUsage(takeBillableUnits(result.requestId))\n\n    return {\n      jobId,\n      url,\n      ...(usage ? { usage } : {}),\n    }\n  }\n\n  protected override generateId(): string {\n    return utilGenerateId(this.name)\n  }\n}\n\n/**\n * Create a fal.ai video adapter with an explicit API key.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function createFalVideo<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalVideoAdapter<TModel> {\n  return new FalVideoAdapter(model, config)\n}\n\n/**\n * Create a fal.ai video adapter using config.apiKey or the FAL_KEY environment variable.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function falVideo<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalVideoAdapter<TModel> {\n  return createFalVideo(model, config)\n}\n"],"names":["utilGenerateId"],"mappings":"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"}