@executioncontrolprotocol/fal

FAL model provider extension for ECP. Invokes any FAL endpoint from workflows with env/secrets auth and standard $ref chaining.

Binding

import "@executioncontrolprotocol/fal"
import { environment, extension, env, secrets } from "@executioncontrolprotocol/node"

export default environment("fal-demo")
  .withExtensions([
    extension("@executioncontrolprotocol/secrets").with({}),
    extension("@executioncontrolprotocol/fal").with({
      apiKey: secrets("fal/api-key"), // or env("FAL_KEY")
      defaultMode: "subscribe",
    }),
  ])

Capability: @executioncontrolprotocol/fal.generate

Input: { endpoint?, input, mode?, logs? } — endpoint can default from extension config.

Output: { data, requestId? } — data holds the FAL model response (images, video URLs, etc.).

Chaining

Reference prior step output fields with ref():

step("@executioncontrolprotocol/fal.generate", "Upscale")
  .with({
    endpoint: "fal-ai/clarity-upscaler",
    input: { image_url: ref("base.data.images.0.url") },
  })
  .as("upscaled")