@nodetool-ai/runtime 0.7.0-rc.23 → 0.8.1

package/dist/providers/fake-provider.js

@@ -1,11 +1,104 @@
-import { randomUUID } from "node:crypto";
+import { getNodeBuiltinSync } from "@nodetool-ai/config";
 import { BaseProvider } from "./base-provider.js";
+const _nodeCrypto = getNodeBuiltinSync("node:crypto");
+const randomUUID = () => {
+    if (_nodeCrypto?.randomUUID)
+        return _nodeCrypto.randomUUID();
+    const g = globalThis;
+    if (g.crypto?.randomUUID)
+        return g.crypto.randomUUID();
+    return `id_${Date.now().toString(36)}_${Math.random()
+        .toString(36)
+        .slice(2, 10)}`;
+};
+// ---------------------------------------------------------------------------
+// Tiny but valid asset bytes for fake media generators.
+// ---------------------------------------------------------------------------
+/**
+ * Minimal 1×1 transparent PNG. Sufficient for any consumer that just sniffs
+ * the file signature or runs the bytes through `sharp` / Pillow / etc.
+ */
+const TINY_PNG = new Uint8Array([
+    0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,
+    0x00, 0x00, 0x00, 0x0d, 0x49, 0x48, 0x44, 0x52,
+    0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x01,
+    0x08, 0x06, 0x00, 0x00, 0x00, 0x1f, 0x15, 0xc4,
+    0x89, 0x00, 0x00, 0x00, 0x0d, 0x49, 0x44, 0x41,
+    0x54, 0x78, 0x9c, 0x63, 0x00, 0x01, 0x00, 0x00,
+    0x05, 0x00, 0x01, 0x0d, 0x0a, 0x2d, 0xb4, 0x00,
+    0x00, 0x00, 0x00, 0x49, 0x45, 0x4e, 0x44, 0xae,
+    0x42, 0x60, 0x82
+]);
+/**
+ * Minimal MP4 `ftyp` box marking the file as `isom`/`mp4`. Consumers that
+ * just sniff the container (ffprobe header check, Sharp's video detector)
+ * are satisfied; nothing decodes it.
+ */
+const TINY_MP4 = new Uint8Array([
+    0x00, 0x00, 0x00, 0x18, 0x66, 0x74, 0x79, 0x70,
+    0x69, 0x73, 0x6f, 0x6d, 0x00, 0x00, 0x00, 0x00,
+    0x69, 0x73, 0x6f, 0x6d, 0x6d, 0x70, 0x34, 0x32
+]);
+/**
+ * Tiny silent 24 kHz mono WAV (10 ms of zeros). Mirrors what the streaming
+ * TTS path produces after `encodePcm16Wav` wraps the PCM samples.
+ */
+function tinyWav() {
+    const sampleRate = 24000;
+    const numSamples = 240; // 10 ms
+    const dataSize = numSamples * 2;
+    const buf = new Uint8Array(44 + dataSize);
+    const view = new DataView(buf.buffer);
+    // RIFF header
+    buf.set([0x52, 0x49, 0x46, 0x46], 0); // "RIFF"
+    view.setUint32(4, 36 + dataSize, true);
+    buf.set([0x57, 0x41, 0x56, 0x45], 8); // "WAVE"
+    // fmt chunk
+    buf.set([0x66, 0x6d, 0x74, 0x20], 12); // "fmt "
+    view.setUint32(16, 16, true);
+    view.setUint16(20, 1, true); // PCM
+    view.setUint16(22, 1, true); // channels
+    view.setUint32(24, sampleRate, true);
+    view.setUint32(28, sampleRate * 2, true);
+    view.setUint16(32, 2, true);
+    view.setUint16(34, 16, true);
+    // data chunk
+    buf.set([0x64, 0x61, 0x74, 0x61], 36); // "data"
+    view.setUint32(40, dataSize, true);
+    return buf;
+}
+/**
+ * Minimal GLB (binary glTF) header — version 2, contentLength 12. Real glTF
+ * loaders fail on this, but consumers that just route bytes through never
+ * notice.
+ */
+const TINY_GLB = new Uint8Array([
+    0x67, 0x6c, 0x54, 0x46, 0x02, 0x00, 0x00, 0x00,
+    0x0c, 0x00, 0x00, 0x00
+]);
+function defaultToolArgs(toolName, index) {
+    switch (toolName) {
+        case "add_item":
+            return { item: `fake item ${index + 1}` };
+        case "add_row":
+            return { row: { id: index + 1, value: `fake row ${index + 1}` } };
+        case "emit":
+        case "emit_text":
+            return { text: `fake text ${index + 1}` };
+        default:
+            return {};
+    }
+}
 export class FakeProvider extends BaseProvider {
     textResponse;
     toolCalls;
     shouldStream;
     chunkSize;
     customResponseFn;
+    toolCallsPerTool;
+    toolArgsBuilder;
+    /** Number of LLM invocations that have already auto-emitted tool calls. */
+    _toolBurstsEmitted = 0;
     callCount = 0;
     lastMessages = null;
     lastModel = null;
@@ -18,6 +111,29 @@ export class FakeProvider extends BaseProvider {
         this.shouldStream = options.shouldStream ?? true;
         this.chunkSize = options.chunkSize ?? 10;
         this.customResponseFn = options.customResponseFn ?? null;
+        this.toolCallsPerTool = options.toolCallsPerTool ?? 3;
+        this.toolArgsBuilder = options.toolArgsBuilder ?? defaultToolArgs;
+    }
+    autoToolCalls(tools) {
+        if (this.toolCallsPerTool <= 0 ||
+            tools.length === 0 ||
+            this._toolBurstsEmitted > 0 ||
+            this.toolCalls.length > 0 ||
+            this.customResponseFn !== null) {
+            return null;
+        }
+        const calls = [];
+        for (const t of tools) {
+            for (let i = 0; i < this.toolCallsPerTool; i++) {
+                calls.push({
+                    id: randomUUID(),
+                    name: t.name,
+                    args: this.toolArgsBuilder(t.name, i)
+                });
+            }
+        }
+        this._toolBurstsEmitted += 1;
+        return calls;
     }
     getResponse(messages, model) {
         if (this.customResponseFn) {
@@ -43,6 +159,10 @@ export class FakeProvider extends BaseProvider {
         this.lastMessages = args.messages;
         this.lastModel = args.model;
         this.lastTools = args.tools ?? [];
+        const auto = this.autoToolCalls(args.tools ?? []);
+        if (auto) {
+            return { role: "assistant", content: [], toolCalls: auto };
+        }
         const response = this.getResponse(args.messages, args.model);
         if (Array.isArray(response)) {
             return { role: "assistant", content: [], toolCalls: response };
@@ -55,6 +175,12 @@ export class FakeProvider extends BaseProvider {
         this.lastMessages = args.messages;
         this.lastModel = args.model;
         this.lastTools = args.tools ?? [];
+        const auto = this.autoToolCalls(args.tools ?? []);
+        if (auto) {
+            for (const call of auto)
+                yield call;
+            return;
+        }
         const response = this.getResponse(args.messages, args.model);
         if (Array.isArray(response)) {
             for (const toolCall of response) {
@@ -83,6 +209,82 @@ export class FakeProvider extends BaseProvider {
             };
         }
     }
+    // -------------------------------------------------------------------------
+    // Media-generation capabilities
+    //
+    // Each method returns the smallest possible "valid-enough" payload for the
+    // requested format so downstream nodes can mime-sniff / route the bytes
+    // without performing a real decode. The point is to satisfy the contract
+    // of the surrounding workflow node, not to produce media a user can play.
+    // -------------------------------------------------------------------------
+    async textToImage(_params) {
+        this.callCount++;
+        return new Uint8Array(TINY_PNG);
+    }
+    async imageToImage(_images, _params) {
+        this.callCount++;
+        return new Uint8Array(TINY_PNG);
+    }
+    async upscaleImage(_image, _params) {
+        this.callCount++;
+        return new Uint8Array(TINY_PNG);
+    }
+    async removeBackground(_image, _params) {
+        this.callCount++;
+        return new Uint8Array(TINY_PNG);
+    }
+    async relightImage(_image, _params) {
+        this.callCount++;
+        return new Uint8Array(TINY_PNG);
+    }
+    async vectorizeImage(_image, _params) {
+        this.callCount++;
+        // Bare-minimum SVG; consumers either route bytes or parse XML.
+        return new TextEncoder().encode('<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"></svg>');
+    }
+    async textToVideo(_params) {
+        this.callCount++;
+        return new Uint8Array(TINY_MP4);
+    }
+    async imageToVideo(_image, _params) {
+        this.callCount++;
+        return new Uint8Array(TINY_MP4);
+    }
+    async videoToVideo(_video, _params) {
+        this.callCount++;
+        return new Uint8Array(TINY_MP4);
+    }
+    async lipSync(_video, _params) {
+        this.callCount++;
+        return new Uint8Array(TINY_MP4);
+    }
+    async *textToSpeech(_args) {
+        this.callCount++;
+        yield { samples: new Int16Array(240), sampleRate: 24000 };
+    }
+    async textToSpeechEncoded(_args) {
+        this.callCount++;
+        return { data: tinyWav(), mimeType: "audio/wav" };
+    }
+    async automaticSpeechRecognition(_args) {
+        this.callCount++;
+        return { text: "fake transcript", chunks: [] };
+    }
+    async generateEmbedding(args) {
+        this.callCount++;
+        const dims = args.dimensions ?? 8;
+        const items = Array.isArray(args.text) ? args.text : [args.text];
+        // Deterministic small vector per input for stable test snapshots.
+        return items.map((s, idx) => Array.from({ length: dims }, (_, d) => ((s.length + idx + d) % 7) / 10));
+    }
+    async textTo3D(_params) {
+        this.callCount++;
+        return new Uint8Array(TINY_GLB);
+    }
+    async imageTo3D(_image, _params) {
+        this.callCount++;
+        return new Uint8Array(TINY_GLB);
+    }
 }
 export function createFakeToolCall(name, args, callId) {
     return {

package/dist/providers/fake-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"fake-provider.js","sourceRoot":"","sources":["../../src/providers/fake-provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fake-provider.js","sourceRoot":"","sources":["../../src/providers/fake-provider.ts"],"names":[],"mappings":"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"}

package/dist/providers/fal-generations.d.ts

@@ -0,0 +1,106 @@
+/**
+ * FAL's request history, read through its Platform APIs.
+ *
+ * Two endpoints answer different halves of a generation, and this module is
+ * the one client for both (https://fal.ai/docs/api-reference/platform-apis):
+ *
+ *  - `GET /v1/models/billing-events` — one record per *charge*: request id,
+ *    endpoint, timestamp and the billed cost. Account-wide, so it is what a
+ *    listing without an endpoint filter can use. A billing event says a call
+ *    was charged, never how it ended, so those records carry
+ *    `status: "unknown"` rather than an invented outcome.
+ *  - `GET /v1/models/requests/by-endpoint` — one record per *request*: status
+ *    code, timings, and with `expand=payloads` the input and output. It
+ *    requires at least one endpoint id, so it serves a listing filtered by
+ *    model and the second half of a single lookup.
+ *
+ * Both need an admin-scoped key; NodeTool reuses `FAL_API_KEY` and a key
+ * without that scope 401/403s. The caller gets that as a thrown error on a
+ * direct read, and as a `note` with null costs when only the cost half fails.
+ */
+import { type ProviderGeneration, type ProviderGenerationLookup, type ProviderGenerationPage, type ProviderGenerationQuery, type ProviderGenerationStatus } from "./provider-generations.js";
+/** One file in a FAL result payload. */
+export interface FalFile {
+    url?: string;
+}
+/**
+ * The output fields FAL models publish media under. A model that names its
+ * output something else still yields a record — with no `output_urls`, which
+ * is the honest answer for a payload this does not recognize.
+ */
+export interface FalJsonOutput {
+    image?: FalFile;
+    images?: FalFile[];
+    video?: FalFile;
+    videos?: FalFile[];
+    audio?: FalFile;
+    audio_file?: FalFile;
+    model_mesh?: FalFile;
+}
+export interface FalBillingEvent {
+    request_id?: string;
+    endpoint_id?: string;
+    timestamp?: string;
+    output_units?: number | null;
+    unit_price?: number | null;
+    cost_total?: number | null;
+    cost_estimate_nano_usd?: number | null;
+}
+export interface FalRequestItem {
+    request_id?: string;
+    endpoint_id?: string;
+    started_at?: string | null;
+    sent_at?: string | null;
+    ended_at?: string | null;
+    status_code?: number | null;
+    duration?: number | null;
+    json_output?: FalJsonOutput;
+}
+/** How this module reaches FAL. Injectable so tests drive it without network. */
+export interface FalGenerationsOptions {
+    fetchFn?: typeof fetch;
+    signal?: AbortSignal;
+}
+/** FAL refused the key: it is missing, invalid, or not admin-scoped. */
+export declare class FalPlatformAuthError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
+/** Outputs FAL still hosts for a request, from the payloads it returns. */
+export declare function falOutputUrls(output: FalJsonOutput | undefined): string[];
+/**
+ * A request's outcome from its HTTP status. A request FAL has accepted but not
+ * finished has no `ended_at` and no status code yet — that is `running`, not a
+ * missing value.
+ */
+export declare function falRequestStatus(item: FalRequestItem): ProviderGenerationStatus;
+/** One billing event by request id, or null when FAL has not posted one. */
+export declare function falBillingEvent(apiKey: string, requestId: string, options?: FalGenerationsOptions): Promise<FalBillingEvent | null>;
+/**
+ * The billed cost of one FAL request, in USD, or null when no billing event
+ * exists for it yet. The reconciler's lookup — see `fal-billing.ts` in
+ * `@nodetool-ai/fal-nodes` for the retry that surrounds it.
+ */
+export declare function falRequestCost(apiKey: string, requestId: string, options?: FalGenerationsOptions): Promise<{
+    cost: number;
+    currency: string;
+    quantity: number | null;
+    unit_price: number | null;
+} | null>;
+/**
+ * List FAL's own record of this account's generations, newest first.
+ *
+ * With a `model` filter the request history answers, so each row carries a
+ * real status and its outputs, and one billing call fills the costs in.
+ * Without one, only the account-wide billing feed can answer, so the rows
+ * carry cost but `status: "unknown"` — the `note` says so.
+ */
+export declare function falListGenerations(apiKey: string, query?: ProviderGenerationQuery, options?: FalGenerationsOptions): Promise<ProviderGenerationPage>;
+/**
+ * One FAL generation by request id. The billing feed finds it account-wide and
+ * names its endpoint; the request history then adds status, timings and
+ * outputs. A caller that already knows the endpoint passes it as `model`, and
+ * the lookup works even before FAL posts the charge.
+ */
+export declare function falGetGeneration(apiKey: string, requestId: string, lookup?: ProviderGenerationLookup, options?: FalGenerationsOptions): Promise<ProviderGeneration | null>;
+//# sourceMappingURL=fal-generations.d.ts.map

package/dist/providers/fal-generations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fal-generations.d.ts","sourceRoot":"","sources":["../../src/providers/fal-generations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AAcnC,wCAAwC;AACxC,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAOD,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AAOD,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAeD,wEAAwE;AACxE,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,MAAM,EAAE,MAAM,EAOzB;CACF;AAkCD,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,EAAE,CAiBzE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,GACnB,wBAAwB,CAQ1B;AAgDD,4EAA4E;AAC5E,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CASjC;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,IAAI,CAAC,CAWR;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,uBAA4B,EACnC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAuEjC;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,wBAA6B,EACrC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAiBpC"}

package/dist/providers/fal-generations.js

@@ -0,0 +1,286 @@
+/**
+ * FAL's request history, read through its Platform APIs.
+ *
+ * Two endpoints answer different halves of a generation, and this module is
+ * the one client for both (https://fal.ai/docs/api-reference/platform-apis):
+ *
+ *  - `GET /v1/models/billing-events` — one record per *charge*: request id,
+ *    endpoint, timestamp and the billed cost. Account-wide, so it is what a
+ *    listing without an endpoint filter can use. A billing event says a call
+ *    was charged, never how it ended, so those records carry
+ *    `status: "unknown"` rather than an invented outcome.
+ *  - `GET /v1/models/requests/by-endpoint` — one record per *request*: status
+ *    code, timings, and with `expand=payloads` the input and output. It
+ *    requires at least one endpoint id, so it serves a listing filtered by
+ *    model and the second half of a single lookup.
+ *
+ * Both need an admin-scoped key; NodeTool reuses `FAL_API_KEY` and a key
+ * without that scope 401/403s. The caller gets that as a thrown error on a
+ * direct read, and as a `note` with null costs when only the cost half fails.
+ */
+import { createLogger } from "@nodetool-ai/config";
+import { isFiniteNumber, isNumber } from "@nodetool-ai/protocol";
+import { boundedLimit, modelFilter, providerGeneration } from "./provider-generations.js";
+const log = createLogger("nodetool.runtime.fal-generations");
+const FAL_PLATFORM_BASE = "https://api.fal.ai/v1";
+const BILLING_EVENTS_PATH = "/models/billing-events";
+const REQUESTS_PATH = "/models/requests/by-endpoint";
+/** `limit` ceiling both endpoints document. */
+const MAX_PAGE = 100;
+const DEFAULT_PAGE = 50;
+/** The window FAL keeps queryable when a request id is given. */
+const LOOKUP_WINDOW_DAYS = 90;
+const NANO_PER_USD = 1_000_000_000;
+function isoDaysAgo(days) {
+    return new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+}
+function buildUrl(path, params) {
+    const query = new URLSearchParams();
+    for (const [key, value] of params) {
+        if (value.length > 0)
+            query.append(key, value);
+    }
+    const suffix = query.toString();
+    return `${FAL_PLATFORM_BASE}${path}${suffix ? `?${suffix}` : ""}`;
+}
+/** FAL refused the key: it is missing, invalid, or not admin-scoped. */
+export class FalPlatformAuthError extends Error {
+    status;
+    constructor(status) {
+        super(`FAL rejected the platform API key (HTTP ${status}). Reading FAL's ` +
+            `generation history needs an admin-scoped FAL_API_KEY.`);
+        this.name = "FalPlatformAuthError";
+        this.status = status;
+    }
+}
+async function falGet(apiKey, url, options) {
+    const fetchFn = options.fetchFn ?? globalThis.fetch.bind(globalThis);
+    const init = {
+        headers: { Authorization: `Key ${apiKey}` }
+    };
+    if (options.signal)
+        init.signal = options.signal;
+    const res = await fetchFn(url, init);
+    if (res.status === 401 || res.status === 403) {
+        throw new FalPlatformAuthError(res.status);
+    }
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`FAL platform API ${res.status} for ${url}: ${body.slice(0, 500)}`);
+    }
+    // SAFETY: each caller passes the response interface documented for the
+    // endpoint in that URL, and every field of those interfaces is optional, so
+    // a payload missing one narrows to undefined rather than lying.
+    return (await res.json());
+}
+function costOf(event) {
+    if (isFiniteNumber(event.cost_total))
+        return event.cost_total;
+    const nano = event.cost_estimate_nano_usd;
+    return isFiniteNumber(nano) ? nano / NANO_PER_USD : null;
+}
+/** Outputs FAL still hosts for a request, from the payloads it returns. */
+export function falOutputUrls(output) {
+    if (!output)
+        return [];
+    const files = [
+        output.image,
+        output.video,
+        output.audio,
+        output.audio_file,
+        output.model_mesh,
+        ...(output.images ?? []),
+        ...(output.videos ?? [])
+    ];
+    const urls = [];
+    for (const file of files) {
+        const url = file?.url;
+        if (url !== undefined && url.length > 0)
+            urls.push(url);
+    }
+    return urls;
+}
+/**
+ * A request's outcome from its HTTP status. A request FAL has accepted but not
+ * finished has no `ended_at` and no status code yet — that is `running`, not a
+ * missing value.
+ */
+export function falRequestStatus(item) {
+    const code = item.status_code;
+    if (!isNumber(code)) {
+        return item.ended_at ? "unknown" : "running";
+    }
+    if (code >= 200 && code < 400)
+        return "completed";
+    if (code >= 400)
+        return "failed";
+    return "unknown";
+}
+/** FAL's `status` filter for the statuses it can express. */
+function falStatusFilter(status) {
+    if (status === "completed")
+        return "success";
+    if (status === "failed")
+        return "error";
+    return "";
+}
+function fromBillingEvent(event) {
+    const requestId = event.request_id;
+    if (requestId === undefined || requestId.length === 0)
+        return null;
+    return providerGeneration({
+        provider: "fal_ai",
+        request_id: requestId,
+        model: event.endpoint_id ?? null,
+        // A charge is not an outcome. `by-endpoint` is what knows how it ended.
+        status: "unknown",
+        created_at: event.timestamp ?? null,
+        cost: costOf(event),
+        currency: "USD",
+        quantity: event.output_units ?? null,
+        unit_price: event.unit_price ?? null
+    });
+}
+function fromRequestItem(item, event) {
+    const requestId = item.request_id;
+    if (requestId === undefined || requestId.length === 0)
+        return null;
+    return providerGeneration({
+        provider: "fal_ai",
+        request_id: requestId,
+        model: item.endpoint_id ?? event?.endpoint_id ?? null,
+        status: falRequestStatus(item),
+        created_at: item.started_at ?? item.sent_at ?? event?.timestamp ?? null,
+        completed_at: item.ended_at ?? null,
+        duration_seconds: item.duration ?? null,
+        cost: event ? costOf(event) : null,
+        currency: event ? "USD" : null,
+        quantity: event?.output_units ?? null,
+        unit_price: event?.unit_price ?? null,
+        output_urls: falOutputUrls(item.json_output)
+    });
+}
+/** One billing event by request id, or null when FAL has not posted one. */
+export async function falBillingEvent(apiKey, requestId, options = {}) {
+    const url = buildUrl(BILLING_EVENTS_PATH, [
+        ["request_id", requestId],
+        ["start", isoDaysAgo(LOOKUP_WINDOW_DAYS)]
+    ]);
+    const body = await falGet(apiKey, url, options);
+    return ((body.billing_events ?? []).find((e) => e.request_id === requestId) ?? null);
+}
+/**
+ * The billed cost of one FAL request, in USD, or null when no billing event
+ * exists for it yet. The reconciler's lookup — see `fal-billing.ts` in
+ * `@nodetool-ai/fal-nodes` for the retry that surrounds it.
+ */
+export async function falRequestCost(apiKey, requestId, options = {}) {
+    const event = await falBillingEvent(apiKey, requestId, options);
+    if (!event)
+        return null;
+    const cost = costOf(event);
+    if (cost === null)
+        return null;
+    return {
+        cost,
+        currency: "USD",
+        quantity: event.output_units ?? null,
+        unit_price: event.unit_price ?? null
+    };
+}
+/**
+ * List FAL's own record of this account's generations, newest first.
+ *
+ * With a `model` filter the request history answers, so each row carries a
+ * real status and its outputs, and one billing call fills the costs in.
+ * Without one, only the account-wide billing feed can answer, so the rows
+ * carry cost but `status: "unknown"` — the `note` says so.
+ */
+export async function falListGenerations(apiKey, query = {}, options = {}) {
+    const limit = boundedLimit(query.limit, DEFAULT_PAGE, MAX_PAGE);
+    const endpoints = modelFilter(query.model);
+    const window = [
+        ["start", query.since ?? ""],
+        ["end", query.until ?? ""]
+    ];
+    if (endpoints.length === 0) {
+        const url = buildUrl(BILLING_EVENTS_PATH, [
+            ...window,
+            ["limit", String(limit)],
+            ["cursor", query.cursor ?? ""]
+        ]);
+        const body = await falGet(apiKey, url, options);
+        const generations = (body.billing_events ?? [])
+            .map(fromBillingEvent)
+            .filter((row) => row !== null);
+        return {
+            generations,
+            next_cursor: body.next_cursor ?? null,
+            note: "FAL lists account-wide generations through its billing feed, which " +
+                "records the charge and not the outcome. Pass a model (endpoint id) " +
+                "to read status, timings and outputs."
+        };
+    }
+    const url = buildUrl(REQUESTS_PATH, [
+        ...window,
+        ["endpoint_id", endpoints.join(",")],
+        ["limit", String(limit)],
+        ["cursor", query.cursor ?? ""],
+        ["status", falStatusFilter(query.status)],
+        ["expand", "payloads"]
+    ]);
+    const body = await falGet(apiKey, url, options);
+    const items = body.items ?? [];
+    // The request history carries no cost, so one billing call over the same
+    // window and endpoints supplies it. A key without billing scope leaves the
+    // costs null rather than failing a listing that otherwise answered.
+    const costs = new Map();
+    let note = null;
+    if (items.length > 0) {
+        const billingUrl = buildUrl(BILLING_EVENTS_PATH, [
+            ...window,
+            ["endpoint_id", endpoints.join(",")],
+            ["limit", String(MAX_PAGE)]
+        ]);
+        try {
+            const billing = await falGet(apiKey, billingUrl, options);
+            for (const event of billing.billing_events ?? []) {
+                if (event.request_id)
+                    costs.set(event.request_id, event);
+            }
+        }
+        catch (err) {
+            log.warn(`FAL billing lookup failed, listing without costs: ${err}`);
+            note = `Costs are missing: the FAL billing feed answered ${String(err)}.`;
+        }
+    }
+    const generations = items
+        .map((item) => fromRequestItem(item, costs.get(item.request_id ?? "") ?? undefined))
+        .filter((row) => row !== null);
+    return { generations, next_cursor: body.next_cursor ?? null, note };
+}
+/**
+ * One FAL generation by request id. The billing feed finds it account-wide and
+ * names its endpoint; the request history then adds status, timings and
+ * outputs. A caller that already knows the endpoint passes it as `model`, and
+ * the lookup works even before FAL posts the charge.
+ */
+export async function falGetGeneration(apiKey, requestId, lookup = {}, options = {}) {
+    const event = await falBillingEvent(apiKey, requestId, options);
+    const endpointId = lookup.model ?? event?.endpoint_id ?? null;
+    if (endpointId === null) {
+        return event ? fromBillingEvent(event) : null;
+    }
+    const url = buildUrl(REQUESTS_PATH, [
+        ["endpoint_id", endpointId],
+        ["request_id", requestId],
+        ["start", isoDaysAgo(LOOKUP_WINDOW_DAYS)],
+        ["expand", "payloads"]
+    ]);
+    const body = await falGet(apiKey, url, options);
+    const item = (body.items ?? []).find((i) => i.request_id === requestId);
+    if (!item)
+        return event ? fromBillingEvent(event) : null;
+    return fromRequestItem(item, event ?? undefined);
+}
+//# sourceMappingURL=fal-generations.js.map