videobook 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -6,6 +6,31 @@ and the package uses [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.2.3] - 2026-10-21
+
+### Added
+
+- Fal FLUX 3 Max text-to-video, image-to-video, and keyframes-to-video,
+  with generated audio and resolution-tiered per-second cost estimates.
+- Bria Fibo 2 text-to-image with structured VGL prompts, and Fibo 2 Edit
+  for one to four reference images, including the image editor.
+- H3 Max Reframe Video, which outpaints a source video to a target aspect
+  ratio at 480p, 768p, or 1080p while keeping its audio and timing.
+  Priced from fal's historical average because the request does not fix
+  the billed duration.
+
+### Changed
+
+- Upgrade all application `@apicity/*` dependencies to 0.16.3.
+- Windows x64 is supported. The release check runs the pack-and-install
+  smoke on Windows and blocks the release when it fails. Stopping
+  `videobook serve` from another process still ends it without a clean
+  shutdown, because Windows has no SIGTERM, and the next start replaces
+  the lock file.
+- Dynamic fal requests are priced from fal's historical average when
+  `FAL_ADMIN_API_KEY` is set. Without the key, and for the two Seedance
+  formula gaps, the estimate stays at the local $0.
+
 ## [0.2.2] - 2026-10-21
 
 ### Added

package/README.md

@@ -12,8 +12,8 @@ graph, and every change is recorded as a revision. This package installs one
 ## Requirements
 
 - Node.js 22 or newer.
-- macOS (Apple Silicon or Intel) or Linux (x64 or arm64). Windows is not
-  supported yet; see the platform notes.
+- macOS (Apple Silicon or Intel), Linux (x64 or arm64), or Windows x64.
+  See the platform notes.
 - About 800 MB of disk. Installing downloads the ffmpeg and yt-dlp binaries
   from GitHub, and the first video render downloads Chrome Headless Shell
   (about 150 MB) into `~/.cache/videobook/remotion`.
@@ -121,6 +121,7 @@ Caches live in `~/.cache/videobook`. Other settings: `PORT`,
 ## Provider keys
 
 The keys are `OPENAI_API_KEY`, `KIE_API_KEY`, `XAI_API_KEY`, `FAL_API_KEY`,
+`FAL_ADMIN_API_KEY`,
 `DASHSCOPE_API_KEY`, `ELEVENLABS_API_KEY`, `KIMI_CODING_API_KEY`,
 `X_CLIENT_ID` and `X_CLIENT_SECRET`, `DROPBOX_CLIENT_ID` and
 `DROPBOX_CLIENT_SECRET`, and the `B2_*` storage settings. The server starts
@@ -177,12 +178,10 @@ come from 1Password are read-only in Settings.
 - macOS on Intel works, but ONNX Runtime has no Intel Mac build, so semantic
   search is unavailable there.
 - Linux x64 and arm64 are supported.
-- Windows is not supported yet. Every native dependency has a Windows x64
-  build, but the release smoke test has not passed on Windows. Windows has no
-  SIGTERM, so stopping `videobook serve` from another process ends it without
-  a clean shutdown, and the next start replaces the lock file it leaves. The
-  Release check workflow runs the smoke test on Windows for every release tag
-  without blocking the release.
+- Windows x64 is supported. Windows has no SIGTERM, so stopping
+  `videobook serve` from another process ends it without a clean shutdown,
+  and the next start replaces the lock file it leaves. The Release check
+  workflow runs the pack-and-install smoke on Windows for every release tag.
 
 ## Security
 

package/dist/book-manager.js

@@ -1,5 +1,5 @@
 import { randomUUID } from "node:crypto";
-import { lstat, mkdir, readdir, rename, rm } from "node:fs/promises";
+import { cp, lstat, mkdir, readdir, rename, rm } from "node:fs/promises";
 import { join, relative, resolve, sep } from "node:path";
 import { performance } from "node:perf_hooks";
 import { BOOK_SLUG_ERROR, normalizeBookSlug } from "videobook-engine/book-slug";
@@ -8,6 +8,43 @@ import { createEngine, err, isUuidV7, ok, } from "videobook-engine";
 function engineError(code, message) {
     return { code, message };
 }
+const MOVE_ATTEMPTS = 8;
+const RETRYABLE_MOVE_CODES = new Set(["EPERM", "EBUSY", "EACCES", "ENOTEMPTY"]);
+function systemCode(cause) {
+    if (!cause || typeof cause !== "object" || !("code" in cause))
+        return undefined;
+    const code = cause.code;
+    return typeof code === "string" ? code : undefined;
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// Windows denies renaming a directory while Defender, or a Dolt file that just
+// closed, still holds a handle. Retry, then copy and drop the staging tree.
+async function moveDirectory(source, destination) {
+    let last;
+    for (let attempt = 0; attempt < MOVE_ATTEMPTS; attempt += 1) {
+        try {
+            await rename(source, destination);
+            return;
+        }
+        catch (cause) {
+            last = cause;
+            if (!RETRYABLE_MOVE_CODES.has(systemCode(cause) ?? ""))
+                throw cause;
+            if (attempt < MOVE_ATTEMPTS - 1)
+                await delay(50 * 2 ** attempt);
+        }
+    }
+    try {
+        await cp(source, destination, { recursive: true });
+    }
+    catch {
+        await rm(destination, { recursive: true, force: true }).catch(() => undefined);
+        throw last;
+    }
+    await rm(source, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 }).catch(() => undefined);
+}
 function isInside(parent, candidate) {
     const path = relative(parent, candidate);
     return path !== "" && !path.startsWith(`..${sep}`) && path !== "..";
@@ -114,8 +151,9 @@ export class BookManager {
             const created = temporaryEngine.book.get();
             temporaryEngine.close();
             temporaryEngine = null;
+            await delay(0);
             const destination = this.bookRoot(created.bookId);
-            await rename(temporaryRoot, destination);
+            await moveDirectory(temporaryRoot, destination);
             finalRoot = destination;
             const engine = this.createEngine(finalRoot);
             finalEngine = engine;

package/dist/env-secrets.js

@@ -35,6 +35,7 @@ export const MANAGED_ENV_KEYS = [
     "DROPBOX_CLIENT_SECRET",
     "KIMI_CODING_API_KEY",
     "FAL_API_KEY",
+    "FAL_ADMIN_API_KEY",
     "DASHSCOPE_API_KEY",
     "ELEVENLABS_API_KEY",
     "B2_ACCESS_KEY_ID",

package/dist/image-edit-models.js

@@ -18,6 +18,7 @@ const EDIT_MODELS = [
     { catalogModel: "fal:fal-ai/nano-banana-2/edit", label: "Nano Banana 2" },
     { catalogModel: "fal:alibaba/qwen-image-3/edit", label: "Qwen 3.0 Edit" },
     { catalogModel: "fal:fal-ai/wan/v2.7/edit", label: "Wan 2.7 Edit" },
+    { catalogModel: "fal:bria/fibo-2/edit", label: "Fibo 2 Edit" },
 ];
 function imageSlotMax(model) {
     return model.slots.find((slot) => slot.role === "image")?.max ?? null;

package/dist/media/catalog.js

@@ -8,6 +8,13 @@ const SEEDANCE_MODES = [
 const FRAME_MODES = [
     { id: "i2v", label: "Frames", roles: ["first_frame", "last_frame"] },
 ];
+const FLUX_3_MAX_DEFAULTS = {
+    aspect_ratio: "auto",
+    duration: 5,
+    generate_audio: true,
+    resolution: "720p",
+    reasoning_level: "high",
+};
 const SEEDANCE_US_REFERENCE_MODES = [
     { id: "r2v", label: "References", roles: ["image", "video", "audio"], requireAny: ["image", "video", "audio"] },
     { id: "v2v", label: "Edit video", roles: ["video", "image", "audio"], requireAny: ["video"], defaults: { task: "editing" } },
@@ -110,6 +117,8 @@ export const MODEL_ENTRIES = [
     { id: "fal:ideogram/v4.5/edit", media: "image", operations: ["edit_image"], refs: { image: ["image_url", "reference_image_urls"] } },
     { id: "fal:blackforestlabs/flux-3/text-to-image", media: "image", operations: ["text_to_image"] },
     { id: "fal:blackforestlabs/flux-3/edit-image", media: "image", operations: ["edit_image"] },
+    { id: "fal:bria/fibo-2/generate", media: "image", operations: ["text_to_image"] },
+    { id: "fal:bria/fibo-2/edit", media: "image", operations: ["edit_image"], prompt: "instruction" },
     { id: "fal:fal-ai/flux-2-flex", media: "image", operations: ["text_to_image"] },
     { id: "fal:bria/guided-remove-background", media: "image", operations: ["edit_image"] },
     { id: "fal:bria/fibo-edit-1.5/expand", media: "image", operations: ["edit_image"] },
@@ -172,6 +181,10 @@ export const MODEL_ENTRIES = [
     { id: "fal:alibaba/wan-3.0-prime/text-to-video", media: "video", operations: ["text_to_video"], hidden: true },
     { id: "fal:alibaba/wan-3.0-prime/image-to-video", media: "video", operations: ["image_to_video"], hidden: true },
     { id: "fal:alibaba/wan-3.0-prime/reference-to-video", media: "video", operations: ["reference_to_video"], hidden: true },
+    { id: "fal:blackforestlabs/flux-3-max/text-to-video", media: "video", operations: ["text_to_video"], title: "FLUX 3 Max", defaults: FLUX_3_MAX_DEFAULTS },
+    { id: "fal:blackforestlabs/flux-3-max/image-to-video", media: "video", operations: ["image_to_video"], title: "FLUX 3 Max Image", refs: { first_frame: "image_url" }, modes: FRAME_MODES, defaults: FLUX_3_MAX_DEFAULTS },
+    { id: "fal:blackforestlabs/flux-3-max/keyframes-to-video", media: "video", operations: ["image_to_video"], title: "FLUX 3 Max Keyframes", refs: { image: "keyframes" }, keyframeFps: 24, defaults: FLUX_3_MAX_DEFAULTS },
+    { id: "fal:minimax/h3-max/reframe-video", media: "video", operations: ["edit_video"] },
     { id: "fal:minimax/h3-max/insert-video", media: "video", operations: ["edit_video"], refs: { video: ["video_url", "reference_video_urls"] } },
     { id: "fal:minimax/h3-max/recast", media: "video", operations: ["edit_video"] },
     { id: "fal:minimax/h3-max-turbo/extend-video", media: "video", operations: ["extend_video"] },

package/dist/media/cost.js

@@ -1,5 +1,70 @@
-import { computeEstimate } from "@apicity/cost";
+import { createFal } from "@apicity/fal";
+import { computeEstimate, createFalEstimateCache, resolveFalDynamicEstimate, } from "@apicity/cost";
 import { buildWireRequest } from "./request.js";
+const FAL_ESTIMATE_TTL_MS = 5 * 60 * 1000;
+let falEstimateCache = createFalEstimateCache({
+    ttlMs: FAL_ESTIMATE_TTL_MS,
+    maxEntries: 128,
+});
+let estimatorOverrideActive = false;
+let estimatorOverride = null;
+let liveEstimatorKey;
+let liveEstimator;
+function freshFalEstimateCache() {
+    return createFalEstimateCache({ ttlMs: FAL_ESTIMATE_TTL_MS, maxEntries: 128 });
+}
+export function installFalDynamicEstimator(estimator) {
+    const previous = {
+        active: estimatorOverrideActive,
+        estimator: estimatorOverride,
+        cache: falEstimateCache,
+    };
+    estimatorOverrideActive = true;
+    estimatorOverride = estimator;
+    falEstimateCache = freshFalEstimateCache();
+    return () => {
+        estimatorOverrideActive = previous.active;
+        estimatorOverride = previous.estimator;
+        falEstimateCache = previous.cache;
+    };
+}
+function falAdminKey() {
+    const value = process.env.FAL_ADMIN_API_KEY?.trim();
+    return value ? value : undefined;
+}
+function falPricingEstimator(apiKey) {
+    const estimate = createFal({ apiKey }).v1.models.pricing.estimate;
+    return (request) => estimate(request);
+}
+function currentFalEstimator() {
+    if (estimatorOverrideActive)
+        return estimatorOverride;
+    const apiKey = falAdminKey();
+    if (!apiKey)
+        return null;
+    if (liveEstimator && liveEstimatorKey === apiKey)
+        return liveEstimator;
+    liveEstimatorKey = apiKey;
+    liveEstimator = falPricingEstimator(apiKey);
+    return liveEstimator;
+}
+export async function estimateFalRequest(endpoint, payload, hints) {
+    const estimator = currentFalEstimator();
+    if (!estimator) {
+        return computeEstimate({
+            provider: "fal",
+            payload,
+            endpoint,
+            ...(hints ? { costHints: hints } : {}),
+        });
+    }
+    return resolveFalDynamicEstimate(endpoint, payload, estimator, {
+        ...(hints ? { hints } : {}),
+        // Queue polls omit x-fal-billable-units, so this is one historical call.
+        callQuantity: 1,
+        cache: falEstimateCache,
+    });
+}
 function costProvider(model) {
     return model.provider;
 }
@@ -24,20 +89,28 @@ export function generationCostHints(input, hints) {
         ? { ...combined, durationSeconds: combined.inputDurationSeconds }
         : combined;
 }
-function estimateWireRequest(model, request, input, hints = {}) {
+async function estimateWireRequest(model, request, input, hints = {}) {
+    const payload = costPayload(model, request, input);
+    const costHints = generationCostHints(input, hints);
+    if (model.provider === "fal")
+        return estimateFalRequest(model.apiId, payload, costHints);
     return computeEstimate({
         provider: costProvider(model),
-        payload: costPayload(model, request, input),
+        payload,
         endpoint: model.apiId,
-        costHints: generationCostHints(input, hints),
+        costHints,
     });
 }
-export function estimateGeneration(model, call, hints = {}) {
+export async function estimateGeneration(model, call, hints = {}) {
     const built = buildWireRequest(model, call);
     if (!built.ok)
         return built;
     try {
-        return { ok: true, estimate: estimateWireRequest(model, built.request, built.input, hints), request: built.request };
+        return {
+            ok: true,
+            estimate: await estimateWireRequest(model, built.request, built.input, hints),
+            request: built.request,
+        };
     }
     catch (error) {
         return { ok: false, error: error instanceof Error ? error.message : String(error) };

package/dist/media/json-schema.js

@@ -36,6 +36,13 @@ export function isUrlObject(schema) {
         return false;
     return branches(schema).some((branch) => branch.type === "object" && branch.properties?.url !== undefined);
 }
+export function isKeyframeItem(schema) {
+    if (!schema)
+        return false;
+    return branches(schema).some((branch) => branch.type === "object"
+        && branch.properties?.image_url !== undefined
+        && branch.properties?.frame_index !== undefined);
+}
 export function isArraySchema(schema) {
     return branches(schema).some((branch) => branch.type === "array");
 }

package/dist/media/ref-fields.js

@@ -1,4 +1,4 @@
-import { arrayBounds, arrayItems, isArraySchema, isUrlObject, propertyAt } from "./json-schema.js";
+import { arrayBounds, arrayItems, isArraySchema, isKeyframeItem, isUrlObject, propertyAt } from "./json-schema.js";
 const CANDIDATES = {
     first_frame: [
         "first_frame_url",
@@ -55,12 +55,14 @@ function expandField(input, field) {
     const required = isRequired(input, field);
     if (isArraySchema(schema)) {
         const bounds = arrayBounds(schema);
+        const items = arrayItems(schema);
         return [{
                 path: field,
                 multi: true,
                 max: bounds.max,
                 min: required ? Math.max(1, bounds.min) : 0,
-                urlObject: isUrlObject(arrayItems(schema)),
+                urlObject: isUrlObject(items),
+                ...(isKeyframeItem(items) ? { keyframe: true } : {}),
             }];
     }
     return [{ path: field, multi: false, max: 1, min: required ? 1 : 0, urlObject: isUrlObject(schema) }];
@@ -83,7 +85,13 @@ export function resolveSlot(role, input, entry) {
             throw new Error(`${entry.id}: ref field ${name} for ${role} is not in the apicity schema`);
     }
     const expanded = names.flatMap((name) => expandField(input, name));
-    const fields = expanded.map(({ path, multi, max, urlObject }) => ({ path, multi, max, urlObject }));
+    const fields = expanded.map(({ path, multi, max, urlObject, keyframe }) => ({
+        path,
+        multi,
+        max,
+        urlObject,
+        ...(keyframe ? { keyframe: true } : {}),
+    }));
     const max = expanded.some((field) => field.max === null)
         ? null
         : expanded.reduce((sum, field) => sum + (field.max ?? 0), 0);

package/dist/media/request.js

@@ -12,6 +12,15 @@ function childContainer(current, key, nextIsIndex) {
     holder[key] = created;
     return created;
 }
+function getPath(target, path) {
+    let current = target;
+    for (const segment of path.split(".")) {
+        if (current === null || typeof current !== "object")
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
 function setPath(target, path, value) {
     const segments = path.split(".");
     let current = target;
@@ -67,12 +76,51 @@ function checkRefs(model, refs, mode) {
 function refValue(field, url, item) {
     return field.urlObject ? { ...item, url } : url;
 }
+function keyframeIndexes(count, lastFrame) {
+    if (count <= 1)
+        return [0];
+    return Array.from({ length: count }, (_, index) => Math.round((index * lastFrame) / (count - 1)));
+}
+function retimeKeyframeField(model, value, field) {
+    const fps = model.entry.keyframeFps;
+    if (!fps)
+        return;
+    const current = getPath(value, field.path);
+    if (!Array.isArray(current) || current.length === 0)
+        return;
+    const duration = typeof value.duration === "number" && Number.isFinite(value.duration) && value.duration > 0
+        ? value.duration
+        : 5;
+    const indexes = keyframeIndexes(current.length, Math.round(duration * fps));
+    setPath(value, field.path, current.map((frame, index) => {
+        const imageUrl = typeof frame === "object" && frame !== null && "image_url" in frame
+            ? frame.image_url
+            : frame;
+        return { image_url: imageUrl, frame_index: indexes[index] };
+    }));
+}
+function retimeKeyframes(model, value) {
+    if (!model.entry.keyframeFps)
+        return;
+    for (const slot of model.slots) {
+        for (const field of slot.fields) {
+            if (field.keyframe)
+                retimeKeyframeField(model, value, field);
+        }
+    }
+}
 function placeSlot(model, slot, value, urls) {
     const item = model.entry.refItem?.[slot.role];
     let cursor = 0;
     for (const field of slot.fields) {
         if (cursor >= urls.length)
             return;
+        if (field.keyframe) {
+            const taken = field.max === null ? urls.slice(cursor) : urls.slice(cursor, cursor + field.max);
+            setPath(value, field.path, taken.map((url) => ({ image_url: url, frame_index: 0 })));
+            cursor += taken.length;
+            continue;
+        }
         if (!field.multi) {
             setPath(value, field.path, refValue(field, urls[cursor], item));
             cursor += 1;
@@ -175,6 +223,7 @@ export function buildWireRequest(model, call) {
     if (optionError)
         return { ok: false, error: optionError };
     applyFrameOptions(model, value, refs, call.mode);
+    retimeKeyframes(model, value);
     if (isSeedanceEdit(model.id, call.mode)) {
         value.aspect_ratio = "adaptive";
         value.duration = -1;

package/dist/provider-usage.js

@@ -4,6 +4,7 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { createCost, PRICING, PRICING_AS_OF } from "@apicity/cost";
 import { modelEntry } from "./media/catalog.js";
+import { estimateFalRequest } from "./media/cost.js";
 import { currentBookContext } from "./book-context.js";
 function installedPackageVersion(name) {
     let dir = dirname(fileURLToPath(import.meta.resolve(name)));
@@ -91,16 +92,27 @@ function tokenPrice(provider, model, tokens) {
     const usd = ((tokens.inputTokens - cached) * rate.rate.input + cached * (rate.rate.cacheRead ?? rate.rate.input) + tokens.outputTokens * rate.rate.output) / 1e6;
     return { ...unknownPrice([]), costUsd: usd, basis: "estimated", rateSource: rate.source.url, unit: "tokens", units: tokens.inputTokens + tokens.outputTokens };
 }
-function priceRequest(provider, model, payload, endpoint, hints) {
+function historicalAverage(warnings) {
+    return warnings.length > 0 && warnings.every((warning) => warning.includes("historical average per call"));
+}
+async function priceRequest(provider, model, payload, endpoint, hints) {
     try {
         const request = { provider, payload, ...(provider === "fal" ? { endpoint } : {}), ...(hints ? { costHints: hints } : {}) };
-        const estimate = cost.estimate(request);
-        if (estimate.warnings.length || estimate.source === "tokens-heuristic+table")
+        const estimate = provider === "fal"
+            ? await estimateFalRequest(endpoint, payload, hints)
+            : cost.estimate(request);
+        const historical = estimate.usd > 0 && historicalAverage(estimate.warnings);
+        if (!historical && (estimate.warnings.length || estimate.source === "tokens-heuristic+table")) {
             return unknownPrice(estimate.warnings.length ? estimate.warnings : ["Waiting for reported token usage"]);
+        }
         return {
-            ...unknownPrice([]), costUsd: estimate.usd, basis: estimate.source === "free" ? "free" : "estimated",
-            rateSource: rateFor(provider, model)?.source.url ?? null, pricingVersion: `apicity-${COST_PACKAGE_VERSION}:${estimate.rateAsOf}`,
-            units: estimate.breakdown.units ?? null, unit: estimate.breakdown.unit ?? null,
+            ...unknownPrice(historical ? estimate.warnings : []),
+            costUsd: estimate.usd,
+            basis: estimate.source === "free" ? "free" : "estimated",
+            rateSource: rateFor(provider, model)?.source.url ?? null,
+            pricingVersion: `apicity-${COST_PACKAGE_VERSION}:${estimate.rateAsOf ?? (historical ? "fal-historical" : PRICING_AS_OF)}`,
+            units: estimate.breakdown.units ?? null,
+            unit: estimate.breakdown.unit ?? null,
         };
     }
     catch {
@@ -240,7 +252,7 @@ export function providerUsageFetch(provider, transport = fetch) {
                 id: randomUUID(), provider, model, activity, status: "pending",
                 tokenBased: /\/(responses|completions|embeddings)$/u.test(url.pathname) || rateFor(provider, model)?.kind === "tokens",
                 operation: context.operation ?? null, artifactId: context.artifactId ?? null,
-                ...priceRequest(provider, model, payload, endpoint, hints),
+                ...await priceRequest(provider, model, payload, endpoint, hints),
             };
             safeRecord(engine, entry);
         }

package/dist/tools/estimate-cost.js

@@ -70,7 +70,7 @@ async function estimateMedia(engine, input) {
     const sourceError = await checkSeedanceEditSource(engine, model, refs, input.mode);
     if (sourceError)
         return unavailable(sourceError);
-    const result = estimateGeneration(model, {
+    const result = await estimateGeneration(model, {
         prompt: text(input.prompt),
         refUrls: placeholderRefs(refs),
         options,
@@ -78,7 +78,7 @@ async function estimateMedia(engine, input) {
     }, await mediaHints(engine, refs));
     return result.ok ? result.estimate : unavailable(result.error);
 }
-function estimateImageEdit(input) {
+async function estimateImageEdit(input) {
     if (input.model === "sharp/layer-composite" && input.operation === "remove")
         return { ...FREE_ESTIMATE };
     const editModel = findImageEditModel(text(input.model) ?? DEFAULT_IMAGE_EDIT_MODEL_ID);
@@ -86,7 +86,7 @@ function estimateImageEdit(input) {
     if (!model)
         return unavailable(`unknown image edit model '${String(input.model)}'`);
     const imageCount = Array.isArray(input.image_refs) && input.image_refs.length > 0 ? input.image_refs.length : 1;
-    const result = estimateGeneration(model, {
+    const result = await estimateGeneration(model, {
         prompt: text(input.prompt) ?? "edit",
         refUrls: { image: Array.from({ length: imageCount }, (_, index) => `https://example.test/edit-${index + 1}.png`) },
     });
@@ -145,7 +145,7 @@ export function estimateCostDef(engine, books) {
     };
     return {
         name: "estimate_cost",
-        description: "Estimate the USD cost of one or more generate_image, generate_video or generate_audio calls, given as {tool_name, input}, before running them. Models without published rates return $0 with a warning.",
+        description: "Estimate the USD cost of one or more generate_image, generate_video or generate_audio calls, given as {tool_name, input}, before running them. Dynamically billed fal models use fal's historical average per call when FAL_ADMIN_API_KEY is set, and that estimate warns that it ignores the request. Without that key, or without a published rate, the estimate is $0 with a warning.",
         schema,
         handler: async (args) => {
             const calls = args.calls;

package/dist/tools/provider-key-status.js

@@ -13,6 +13,7 @@ const KEY_REGISTRY = {
     DROPBOX_CLIENT_SECRET: { provider: "dropbox", label: "Dropbox OAuth" },
     KIMI_CODING_API_KEY: { provider: "kimicoding", label: "Kimi Coding" },
     FAL_API_KEY: { provider: "fal", label: "FAL" },
+    FAL_ADMIN_API_KEY: { provider: "fal", label: "FAL admin" },
     DASHSCOPE_API_KEY: { provider: "dashscope", label: "DashScope" },
     B2_ACCESS_KEY_ID: { provider: "b2", label: "Backblaze B2" },
     B2_SECRET_ACCESS_KEY: { provider: "b2", label: "Backblaze B2" },
@@ -32,6 +33,7 @@ const ROW_ORDER = [
     "DROPBOX_CLIENT_SECRET",
     "KIMI_CODING_API_KEY",
     "FAL_API_KEY",
+    "FAL_ADMIN_API_KEY",
     "DASHSCOPE_API_KEY",
     "B2_ACCESS_KEY_ID",
     "B2_SECRET_ACCESS_KEY",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "videobook",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Local-first MCP server and web UI for AI video creation: notebooks, generation, editing, rendering and publishing.",
   "keywords": [
     "mcp",
@@ -36,18 +36,18 @@
     "start": "node dist/index.js"
   },
   "dependencies": {
-    "@apicity/alibaba": "^0.16.2",
-    "@apicity/b2": "^0.16.2",
-    "@apicity/cost": "^0.16.2",
-    "@apicity/dropbox": "^0.16.2",
-    "@apicity/elevenlabs": "^0.16.2",
-    "@apicity/fal": "^0.16.2",
-    "@apicity/free-media-upload": "^0.16.2",
-    "@apicity/kie": "^0.16.2",
-    "@apicity/kimicoding": "^0.16.2",
-    "@apicity/openai": "^0.16.2",
-    "@apicity/x": "^0.16.2",
-    "@apicity/xai": "^0.16.2",
+    "@apicity/alibaba": "^0.16.3",
+    "@apicity/b2": "^0.16.3",
+    "@apicity/cost": "^0.16.3",
+    "@apicity/dropbox": "^0.16.3",
+    "@apicity/elevenlabs": "^0.16.3",
+    "@apicity/fal": "^0.16.3",
+    "@apicity/free-media-upload": "^0.16.3",
+    "@apicity/kie": "^0.16.3",
+    "@apicity/kimicoding": "^0.16.3",
+    "@apicity/openai": "^0.16.3",
+    "@apicity/x": "^0.16.3",
+    "@apicity/xai": "^0.16.3",
     "@devmehq/open-graph-extractor": "^1.1.1",
     "@ffprobe-installer/ffprobe": "2.1.2",
     "@modelcontextprotocol/client": "^2.2.0",