[bot] Instrument fal.ai (1,249,653 weekly downloads)

[braintrust-bot]

Summary

fal.ai publishes an official JavaScript/TypeScript client, @fal-ai/client on npm, providing execution APIs for running generative image, video, and audio models (FLUX, Nano Banana, Stable Diffusion, and hundreds of other hosted models) via a queue-based prediction API. This repository has zero instrumentation for any fal.ai SDK surface — no wrapper, no diagnostics channel, no plugin, no auto-instrumentation config, no e2e scenario.

What instrumentation is missing

Execution surfaces exposed by @fal-ai/client that are not instrumented:

SDK Method	Description
fal.subscribe(endpointId, { input })	Submits a model run, waits on the queue, and returns the result — the primary generation execution path
fal.run(endpointId, { input })	Synchronous convenience call that runs a model and returns output directly
fal.stream(endpointId, { input })	Streams partial generation results as an AsyncIterable
fal.queue.submit(endpointId, { input }) / fal.queue.status(...) / fal.queue.result(...)	Lower-level async queue execution (submit, poll, retrieve)

The client has its own fetch-based HTTP layer and does not depend on openai or any already-instrumented package, so none of the existing auto-instrumentation (OpenAI, Anthropic, AI SDK, etc.) picks up these calls.

No coverage in any instrumentation layer:

• No wrapper function (e.g. wrapFal()) in js/src/wrappers/
• No channel definitions or plugin in js/src/instrumentation/plugins/
• No auto-instrumentation config in js/src/auto-instrumentations/configs/
• No e2e test scenario under e2e/scenarios/
• Repo-wide grep for fal-ai/@fal-ai (case-insensitive) returns zero real matches (one incidental match in an unrelated test cassette URL string, not instrumentation)

Weekly downloads

Weekly downloads: 1,249,653 (as of 2026-08-10; window 2026-08-03 to 2026-08-09; https://api.npmjs.org/downloads/point/last-week/@fal-ai/client)

Braintrust docs status

not_found. fal / fal.ai does not appear anywhere on the Braintrust integrations index — https://www.braintrust.dev/docs/integrations — which enumerates AI providers (Anthropic, OpenAI, Gemini, Replicate, Together, etc.), agent frameworks, and SDK integrations, with no entry for fal.ai. There is no fal-specific documentation, proxy note, or gateway workaround.

Upstream references

• npm package: https://www.npmjs.com/package/@fal-ai/client
• Official SDK GitHub: https://github.com/fal-ai/fal-js
• fal.ai model execution docs (example): https://fal.ai/models/fal-ai/nano-banana-pro/api

Braintrust docs sources checked

• https://www.braintrust.dev/docs/integrations

Local files inspected

• js/src/wrappers/*.ts — full directory listing — no fal.ts/fal-ai.ts wrapper
• js/src/instrumentation/plugins/*.ts — full directory listing — no fal channels or plugin file
• js/src/auto-instrumentations/configs/*.ts — full directory listing (33 files) — no fal config entry
• e2e/scenarios/*fal* — no matching scenario directories
• Repo-wide grep for fal-ai|copilotkit|semantic-kernel — only one incidental match (an unrelated blog-title string inside an Anthropic test cassette snapshot)