videobook 0.3.0 → 0.3.2

package/dist/provider-usage.js

@@ -80,8 +80,8 @@ function historicalAverage(warnings) {
 }
 async function priceRequest(provider, model, payload, endpoint, hints) {
     try {
-        const request = { provider, payload, ...(provider === "fal" ? { endpoint } : {}), ...(hints ? { costHints: hints } : {}) };
-        const estimate = provider === "fal"
+        const request = { provider, payload, ...(endpoint ? { endpoint } : {}), ...(hints ? { costHints: hints } : {}) };
+        const estimate = provider === "fal" && endpoint
             ? await estimateFalRequest(endpoint, payload, hints)
             : cost.estimate(request);
         const historical = estimate.usd > 0 && historicalAverage(estimate.warnings);
@@ -92,7 +92,7 @@ async function priceRequest(provider, model, payload, endpoint, hints) {
             ...unknownPrice(historical ? estimate.warnings : []),
             costUsd: estimate.usd,
             basis: estimate.source === "free" ? "free" : "estimated",
-            rateSource: rateFor(provider, model)?.source.url ?? null,
+            rateSource: (rateFor(provider, model) ?? (endpoint ? rateFor(provider, endpoint) : undefined))?.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,
@@ -102,11 +102,24 @@ async function priceRequest(provider, model, payload, endpoint, hints) {
         return unknownPrice();
     }
 }
-function activityFor(model, path, operation = "") {
+const MEDIA_ACTIVITY = { image: "images", video: "video", audio: "audio" };
+function kieSunoApiId(provider, path) {
+    const match = provider === "kie" ? /\/api\/v1\/generate(\/sounds)?$/u.exec(path) : null;
+    if (!match)
+        return undefined;
+    return match[1] ? "suno/sounds-generate" : "suno/generate";
+}
+function catalogMedia(provider, model, path) {
+    return modelEntry(provider === "fal" ? `fal:${path.slice(1)}` : `${provider}:${kieSunoApiId(provider, path) ?? model}`)?.media;
+}
+function activityFor(provider, model, path, operation = "") {
     if (/\/(responses|completions)$/u.test(path) && /chat|rewrite_prompt/u.test(operation))
         return "chat";
     if (/transcrib|speech.to.text|analy|describe|tag_|rename|suggest|translate|vision|image.subjects|regions|verify/iu.test(`${operation} ${path}`))
         return "analysis";
+    const media = catalogMedia(provider, model, path);
+    if (media)
+        return MEDIA_ACTIVITY[media];
     if (/video|veo|wan\/|kling|seedance|happyhorse|lipsync/iu.test(`${model} ${path}`))
         return "video";
     if (/audio|speech|music|sound|sfx|suno|vocal/iu.test(`${model} ${path}`))
@@ -121,7 +134,7 @@ function isBillable(provider, path, method) {
     if (provider === "openai" || provider === "xai")
         return /\/(responses|chat\/completions|images\/(generations|edits)|videos\/(generations|edits|extensions)|audio\/(speech|transcriptions|translations)|embeddings|tts|stt)$/u.test(path);
     if (provider === "kie")
-        return /\/(createTask|veo\/(generate|extend))$/u.test(path);
+        return /\/(createTask|veo\/(generate|extend))$/u.test(path) || kieSunoApiId(provider, path) !== undefined;
     if (provider === "fal")
         return !/\/requests\//u.test(path)
             && (/^\/(fal-ai|alibaba)\//u.test(path) || modelEntry(`fal:${path.slice(1)}`) !== undefined);
@@ -169,7 +182,8 @@ function responseStatus(body, accepted) {
     const data = object(body.data);
     const output = object(body.output);
     const state = String(body.status ?? data.state ?? data.status ?? output.task_status ?? "").toLowerCase();
-    if (body.error || data.failCode || (typeof body.code === "number" && body.code >= 400) || data.successFlag === 2 || ["failed", "fail", "error"].includes(state))
+    if (body.error || data.failCode || (typeof body.code === "number" && body.code >= 400) || data.successFlag === 2 || data.successFlag === 3
+        || ["failed", "fail", "error", "create_task_failed", "generate_audio_failed", "sensitive_word_error"].includes(state))
         return "failed";
     if (["cancelled", "canceled"].includes(state))
         return "cancelled";
@@ -177,7 +191,8 @@ function responseStatus(body, accepted) {
         return "uncertain";
     if (data.successFlag === 1 || ["success", "succeeded", "completed", "done"].includes(state))
         return "completed";
-    if (["created", "pending", "queued", "in_queue", "running", "in_progress", "processing", "started", "waiting"].includes(state))
+    if (data.successFlag === 0
+        || ["created", "pending", "queued", "in_queue", "running", "in_progress", "processing", "started", "waiting", "queuing", "generating", "text_success"].includes(state))
         return "pending";
     return accepted ? "pending" : "completed";
 }
@@ -232,12 +247,12 @@ export function providerUsageFetch(provider, transport = fetch) {
             catch {
                 void 0;
             }
-            const activity = provider === "machgen" ? "video" : activityFor(model, url.pathname, context.operation);
+            const activity = provider === "machgen" ? "video" : activityFor(provider, model, url.pathname, context.operation);
             entry = {
                 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,
-                ...await priceRequest(provider, model, payload, endpoint, hints),
+                ...await priceRequest(provider, model, payload, provider === "fal" ? endpoint : kieSunoApiId(provider, url.pathname), hints),
             };
             safeRecord(engine, entry);
         }

package/dist/tools/estimate-cost.js

@@ -51,13 +51,18 @@ async function sourceDuration(engine, refs) {
     }
     return undefined;
 }
-async function mediaHints(engine, refs) {
+async function mediaHints(engine, refs, model) {
+    const audioSeconds = () => sourceDuration(engine, (refs.audio ?? []).filter((ref) => !ref.startsWith("http")));
+    if (model.entry.outputLength === "audio") {
+        const seconds = await audioSeconds();
+        return seconds === undefined ? {} : { durationSeconds: seconds };
+    }
     const videos = (refs.video ?? []).filter((ref) => !ref.startsWith("http"));
     const videoSeconds = videos.length > 0 ? await referenceVideoDuration(engine, videos) : undefined;
     if (videoSeconds !== undefined)
         return { inputDurationSeconds: videoSeconds };
-    const audioSeconds = await sourceDuration(engine, (refs.audio ?? []).filter((ref) => !ref.startsWith("http")));
-    return audioSeconds === undefined ? {} : { inputDurationSeconds: audioSeconds };
+    const seconds = await audioSeconds();
+    return seconds === undefined ? {} : { inputDurationSeconds: seconds };
 }
 async function estimateMedia(engine, input) {
     const modelId = text(input.model);
@@ -71,7 +76,7 @@ async function estimateMedia(engine, input) {
     const sourceError = await checkSeedanceEditSource(engine, model, refs, input.mode);
     if (sourceError)
         return unavailable(sourceError);
-    const hints = { ...await mediaHints(engine, refs), ...await seedanceDraftCostHints(engine, model.id, options) };
+    const hints = { ...await mediaHints(engine, refs, model), ...await seedanceDraftCostHints(engine, model.id, options) };
     const result = await estimateGeneration(model, {
         prompt: text(input.prompt),
         refUrls: placeholderRefs(refs),

package/dist/tools/reconcile-project-work.js

@@ -7,7 +7,6 @@ import { legacyMediaForTaskType } from "../media/legacy-task-types.js";
 import { parseModelId } from "../media/model-id.js";
 import { computeArtifactStatus, QUEUED_TASK_ID } from "videobook-engine";
 import { z } from "zod";
-import { createHash } from "node:crypto";
 import { join } from "node:path";
 import { KieError } from "@apicity/kie";
 import { XaiError } from "@apicity/xai";
@@ -18,20 +17,19 @@ import { EMPTY_TAG_SUMMARY, readAssetTagSummaries, } from "../asset-tags.js";
 import { logger } from "../logger.js";
 import { queue } from "../queue.js";
 import { getApiKey } from "../api-key.js";
-import { findVideoFile, findAudioFile, findPrimaryMediaFile, RENDER_ORIENTATIONS as MEDIA_RENDER_ORIENTATIONS, } from "videobook-engine";
+import { findVideoFile, findAudioFile, RENDER_ORIENTATIONS as MEDIA_RENDER_ORIENTATIONS, } from "videobook-engine";
 import { readAndAssessDialog } from "../dialog-quality.js";
 import { hasSpokenAudio, PLAIN_TRANSCRIPT_FILE, readAssetTranscriptSources, TIMED_TRANSCRIPT_FILE, } from "../transcript-projection.js";
 import { isAnalyzableVideo, readVideoAnalysisSummary, VIDEO_ANALYSIS_FILE, } from "../video-analysis-projection.js";
 import { failPendingTaskAndLog } from "../jobs/task-failure.js";
 import { findUnprocessedUploads, processExternalUpload } from "../jobs/process-upload.js";
 import { planVideoTranscriptJobs } from "../jobs/process-video.js";
-import { probeVideo } from "../ffmpeg.js";
 import { providerEndpoints } from "../media/endpoints.js";
 import { machgenProvider } from "../media/adapters/machgen.js";
 import { MEDIA_TASK_TYPES } from "../media/adapters/types.js";
 import { submitQueuedKieTask } from "../jobs/kie-paygate.js";
 import { DEFAULT_KEYWORD_GRAPHICS_LINGER_SECONDS, DEFAULT_KEYWORD_GRAPHICS_MAX_COUNT, } from "../remotion/keyword-graphics.js";
-import { invalidVideoProxyMetadata, probeStoredVideoFile, videoProxyAssessmentMatches, videoProxyMetadata, videoProxyMetadataMatches, videoProxyValidationError, } from "../video-proxy.js";
+import { assetDuration, assetMediaUrls, assetStreamProfile, findAssetMediaFile, groupByArtifactId, indexByArtifactId, PARTIAL_DOWNLOAD_RE, scheduleMissingVideoPoster, servedVideoProxyFile, } from "../asset-media-projection.js";
 /** Upper bound on how long a pending task may sit without reaching success/fail
  *  before reconciliation ages it out. Guards against providers leaving jobs in an
  *  intermediate "waiting" state indefinitely. */
@@ -153,29 +151,6 @@ async function analysisOutputProjection(engine, artifactId) {
         return null;
     }
 }
-function findAssetMediaFile(files, asset) {
-    return asset.kind === "audio"
-        ? findAudioFile(files, asset.kind)
-        : asset.kind === "video"
-            ? findVideoFile(files.filter((file) => file.name !== "proxy.mp4"))
-            : findPrimaryMediaFile(files, asset.kind);
-}
-async function assessStoredVideoProxy(engine, assetId, sourceFile, proxyFile, sourceProfile) {
-    let assessment;
-    try {
-        const proxy = await probeStoredVideoFile(engine, assetId, proxyFile.name);
-        const error = videoProxyValidationError(sourceProfile, proxy);
-        assessment = error
-            ? invalidVideoProxyMetadata(sourceFile, proxyFile, error)
-            : videoProxyMetadata(sourceFile, proxyFile, proxy);
-    }
-    catch (cause) {
-        const error = cause instanceof Error ? cause.message : String(cause);
-        assessment = invalidVideoProxyMetadata(sourceFile, proxyFile, error);
-    }
-    await engine.metadata.artifacts.write(assetId, "proxy", assessment);
-    return assessment.valid;
-}
 /** Read the OSG overlay summary from the asset's render metadata. OSG is stored
  *  identically across orientations, so the first orientation that carries an
  *  osgAssetId wins. Returns null when no overlay is configured. */
@@ -277,9 +252,7 @@ function scheduleWaveformExtraction(bookId, assetId, videoFilename) {
         logger.error("waveform-enqueue-failed", { assetId, error: err });
     });
 }
-const PARTIAL_DOWNLOAD_RE = /\.(mp4|mov)\.part$/i;
 /** Media extensions whose duration can be recovered via ffprobe when metadata lacks it. */
-const DURATION_PROBE_EXT_RE = /\.(mp4|mov|webm|mkv|mp3|wav|m4a|aac|ogg|flac)$/i;
 export const RENDER_ORIENTATIONS = MEDIA_RENDER_ORIENTATIONS;
 export async function readRenderSettings(engine, assetId, orientations) {
     const result = {};
@@ -377,30 +350,6 @@ async function readAnalysisRecommendations(engine, assetId) {
         return {};
     }
 }
-// Content fingerprint covering every file in the asset directory. Changes
-// whenever any file is added, removed, resized, or rewritten, so every URL
-// derived from an asset's filePath (including alternate-orientation renders
-// like portrait.mp4 / landscape.mp4) invalidates together. Cheap: no file
-// reads — just hashes the immutable manifest tuples. Partial downloads are
-// excluded: their size grows on every poll while no served URL points at
-// them, and including them made every media URL churn (and the browser
-// refetch) once per poll tick for the whole duration of a download.
-function computeAssetFingerprint(files) {
-    const settled = files.filter((f) => !PARTIAL_DOWNLOAD_RE.test(f.name));
-    if (settled.length === 0)
-        return "";
-    const sorted = [...settled].sort((a, b) => a.name.localeCompare(b.name));
-    const hash = createHash("sha1");
-    for (const f of sorted) {
-        hash.update(f.name);
-        hash.update("\0");
-        hash.update(String(f.sizeBytes ?? 0));
-        hash.update("\0");
-        hash.update(f.objectHash);
-        hash.update("\0");
-    }
-    return hash.digest("hex").slice(0, 12);
-}
 function renderedOrientationsFor(files, kind) {
     const fileSet = new Set(files.map((f) => f.name));
     if (kind === "final") {
@@ -408,23 +357,6 @@ function renderedOrientationsFor(files, kind) {
     }
     return RENDER_ORIENTATIONS.filter((o) => fileSet.has(`${o}.mp4`));
 }
-function indexByArtifactId(rows) {
-    const map = new Map();
-    for (const row of rows)
-        map.set(row.artifactId, row);
-    return map;
-}
-function groupByArtifactId(rows) {
-    const map = new Map();
-    for (const row of rows) {
-        const list = map.get(row.artifactId);
-        if (list)
-            list.push(row);
-        else
-            map.set(row.artifactId, [row]);
-    }
-    return map;
-}
 export async function buildAssetList(engine, book_id, sort) {
     const assets = engine.artifacts.list({ ...(sort ? { sort } : {}) });
     const pendingAll = engine.jobs.pending.findAll();
@@ -468,30 +400,9 @@ export async function buildAssetList(engine, book_id, sort) {
         const mediaFile = findAssetMediaFile(files, a);
         const meta = metadata.ok ? metadata.value : null;
         const streams = streamsByArtifact.get(a.artifactId) ?? [];
-        const videoStream = streams.find((stream) => stream.kind === "video" && stream.video);
-        const audioStream = streams.find((stream) => stream.kind === "audio" && stream.audio);
-        const frameRate = videoStream?.video?.averageFrameRate
-            ?? videoStream?.video?.nominalFrameRate;
-        const streamDuration = videoStream
-            ? videoStream.durationTicks
-                * videoStream.timeBase.numerator
-                / videoStream.timeBase.denominator
-            : 0;
-        const metadataDuration = Number(meta?.duration);
-        const sourceDuration = streamDuration > 0
-            ? streamDuration
-            : Number.isFinite(metadataDuration) ? metadataDuration : 0;
-        const sourceProfile = sourceDuration > 0
-            ? {
-                videoDuration: sourceDuration,
-                avgFps: frameRate
-                    ? frameRate.numerator / frameRate.denominator
-                    : null,
-                hasAudio: audioStream !== undefined || meta?.hasAudio === true,
-            }
-            : null;
+        const profile = assetStreamProfile(streams, meta);
+        const { audioStream, frameRate } = profile;
         const fileNames = new Set(files.map((f) => f.name));
-        const hasThumbnail = fileNames.has("original.jpg");
         const renders = renderedOrientationsFor(files, a.kind);
         const hasPartFile = files.some((f) => PARTIAL_DOWNLOAD_RE.test(f.name));
         const frameDirs = buildFrameDirs(directories, book_id, a.artifactId);
@@ -509,64 +420,22 @@ export async function buildAssetList(engine, book_id, sort) {
                 : Promise.resolve(null),
         ]);
         const waveform = await readWaveformOrSchedule(engine, a.artifactId, book_id, mediaFile?.name ?? null);
-        // Cache-bust media URLs so browsers refetch after trim / re-encode / re-render.
-        // For video and image assets, use a content fingerprint covering the whole
-        // asset directory: orientation re-renders (portrait/landscape/square.mp4)
-        // touch alternate files but not original.mp4, so a primary-mtime cache
-        // key would leave alternate-orientation URLs cached and stale.
-        const useFingerprint = a.kind === "video" || a.kind === "image";
-        let cacheBust = '';
-        if (useFingerprint) {
-            const fp = computeAssetFingerprint(files);
-            if (fp)
-                cacheBust = `?v=${fp}`;
-        }
-        else {
-            const mediaHash = mediaFile?.objectHash;
-            if (mediaHash)
-                cacheBust = `?v=${mediaHash.slice(0, 12)}`;
-        }
-        // Character assets: free-form folders have no original.* media. Project
-        // the first image in the folder so sidebar thumbs and drag-drop keep working.
-        let charImage = null;
-        if (a.kind === "character") {
-            charImage = files.find((f) => /\.(jpg|jpeg|png|webp|gif)$/i.test(f.name)) ?? null;
-        }
-        const proxyCandidate = a.kind === "video"
-            ? files.find((file) => file.name === "proxy.mp4")
-            : null;
-        let proxyFile = null;
-        if (proxyCandidate && mediaFile) {
-            if (proxyMetadata.ok
-                && videoProxyMetadataMatches(proxyMetadata.value, mediaFile, proxyCandidate)) {
-                proxyFile = proxyCandidate;
-            }
-            else {
-                const assessmentMatches = proxyMetadata.ok
-                    && videoProxyAssessmentMatches(proxyMetadata.value, mediaFile, proxyCandidate);
-                const active = assetWorkRow.ok
-                    && assetWorkRow.value !== null
-                    && (assetWorkRow.value.status === "pending" || assetWorkRow.value.status === "working");
-                if (!assessmentMatches && !active && sourceProfile) {
-                    const valid = await assessStoredVideoProxy(engine, a.artifactId, mediaFile, proxyCandidate, sourceProfile);
-                    if (valid)
-                        proxyFile = proxyCandidate;
-                }
-            }
-        }
-        const media_url = charImage
-            ? `/files/${book_id}/${a.artifactId}/${charImage.name}${cacheBust}`
-            : proxyFile
-                ? `/files/${book_id}/${a.artifactId}/${proxyFile.name}${cacheBust}`
-                : mediaFile
-                    ? `/files/${book_id}/${a.artifactId}/${mediaFile.name}${cacheBust}`
-                    : null;
-        const isImage = a.kind === "image";
-        const thumbnail_url = charImage
-            ? `/files/${book_id}/${a.artifactId}/${charImage.name}${cacheBust}`
-            : hasThumbnail
-                ? `/files/${book_id}/${a.artifactId}/original.jpg${cacheBust}`
-                : isImage ? media_url : null;
+        const proxyFile = servedVideoProxyFile({
+            bookId: book_id,
+            artifact: a,
+            files,
+            mediaFile,
+            proxyMetadata,
+            work: assetWorkRow.value,
+            sourceProfile: profile.sourceProfile,
+        });
+        const { media_url, thumbnail_url } = assetMediaUrls({
+            bookId: book_id,
+            artifact: a,
+            files,
+            mediaFile,
+            proxyFile,
+        });
         // Status derivation lives in videobook-engine (`computeArtifactStatus`). We pass
         // the asset-type-aware primary media name we already computed so the
         // engine doesn't have to redo media-type heuristics.
@@ -587,20 +456,13 @@ export async function buildAssetList(engine, book_id, sort) {
                 }
                 : null,
         });
-        if (a.kind === "video" && status === "ready" && !hasThumbnail && mediaFile) {
-            const recovery = await engine.metadata.artifacts.read(a.artifactId, "poster-recovery");
-            if (!recovery.ok || !recovery.value.failed || recovery.value.sourceHash !== mediaFile.objectHash) {
-                void queue.enqueue(`extract-video-poster-${book_id}-${a.artifactId}-${mediaFile.objectHash}`, {
-                    type: "extract_video_poster",
-                    bookId: book_id,
-                    posterArtifactId: a.artifactId,
-                    sourceFilename: mediaFile.name,
-                    sourceHash: mediaFile.objectHash,
-                }).catch((error) => {
-                    logger.error("poster-enqueue-failed", { assetId: a.artifactId, error });
-                });
-            }
-        }
+        await scheduleMissingVideoPoster(engine, {
+            bookId: book_id,
+            artifact: a,
+            files,
+            mediaFile,
+            status,
+        });
         const archiveMeta = archiveMetadata.ok ? archiveMetadata.value : null;
         const analysisInfo = analysisInfoFromMetadata(meta);
         if (analysisInfo && fileNames.has("analysis.json")) {
@@ -612,22 +474,13 @@ export async function buildAssetList(engine, book_id, sort) {
                 analysisInfo.llm_exchanges = output.llmExchanges;
             }
         }
-        // Backfill duration if missing from metadata (video + audio; probeVideo
-        // reads format.duration via ffprobe and works for both).
-        let duration = meta?.duration ?? null;
-        if (duration === null && mediaFile && DURATION_PROBE_EXT_RE.test(mediaFile.name)) {
-            try {
-                const probe = await probeVideo(join(a.path, mediaFile.name));
-                if (Number.isFinite(probe.duration) && probe.duration > 0) {
-                    duration = probe.duration;
-                    // Persist so we don't re-probe next time
-                    if (metadata.ok) {
-                        await engine.metadata.artifacts.write(a.artifactId, "original", { ...metadata.value, duration });
-                    }
-                }
-            }
-            catch { /* non-fatal */ }
-        }
+        const duration = assetDuration({
+            bookId: book_id,
+            artifactId: a.artifactId,
+            meta,
+            mediaFile,
+            profile,
+        });
         const audio_info = audioStream?.audio
             ? {
                 codec: audioStream.codec,
@@ -925,7 +778,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
             try {
                 const recordInfo = await provider.veo.get.api.v1.veo.recordInfo(task.taskId);
                 const data = recordInfo.data;
-                // Veo successFlag: 0=submitted/pending, 1=success, 2=fail, 3=processing
+                // Veo successFlag: 0=generating, 1=success, 2=task creation failed, 3=generation failed
                 if (data?.successFlag === 1) {
                     const urls = data.response?.resultUrls ?? [];
                     if (urls.length === 0) {
@@ -953,7 +806,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
                     });
                     result.completed.push({ assetId: task.artifactId, taskType: task.taskType, jobId });
                 }
-                else if (data?.successFlag === 2) {
+                else if (data?.successFlag === 2 || data?.successFlag === 3) {
                     const failMsg = data.errorMessage ?? "Veo task failed";
                     result.failed.push({ assetId: task.artifactId, taskType: task.taskType, failMsg, failedAt: new Date().toISOString(), prompt });
                     await failPendingTaskAndLog(engine, task.artifactId, task.taskId, { message: failMsg, prompt });
@@ -963,7 +816,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
                         assetId: task.artifactId,
                         taskType: task.taskType,
                         progress: 0,
-                        state: data?.successFlag === 3 ? "processing" : "waiting",
+                        state: "waiting",
                         prompt,
                         startedAt: task.createdAt,
                     });

package/dist/tools/videobook-domain.js

@@ -17,6 +17,7 @@ import { listNotebookActions, markDescendantsStale, normalizeCellActionFields, n
 import { hydrateNotebookProviderFailures } from "../notebook-provider-failure.js";
 import { buildSevenStageScaffold } from "../notebook-workflow.js";
 import { previewGeneration } from "../media/preview.js";
+import { readNotebookStickySettings, rememberNotebookStickySettings, seedNotebookStickySettings, } from "../notebook-sticky-settings.js";
 import { generationInputMentions, remapGenerationInputPrompt } from "../generation-input-mentions.js";
 import { applyPreviewPlaceholderUrls } from "../preview-payload.js";
 import { jobProviderTaskStatus } from "../provider-task-status.js";
@@ -559,6 +560,7 @@ function notebookPayload(engine, notebook) {
         cells: normalized.cells.map(cellPayload),
         posts: notebookPosts(engine, normalized),
         edges: normalized.edges,
+        generation_settings_memory: readNotebookStickySettings(engine, normalized.id),
     };
 }
 const entityKindSchema = z.enum(["prompt", "scene", "character"]);
@@ -1158,6 +1160,7 @@ export function videobookDomainDefs(engine, books) {
                 if (args.cell.type === "goal")
                     return failure(GOAL_TILE_CREATE_ERROR);
                 let cell = engine.notebooks.createCell(cellFromInput(args.cell));
+                let requestedCell = cell;
                 let outputCell = null;
                 let outputEdge = null;
                 try {
@@ -1167,6 +1170,8 @@ export function videobookDomainDefs(engine, books) {
                             throw new Error(`Stale notebook revision: expected ${args.expected_revision}`);
                         }
                         cell = normalizeCellActionFields(cell, notebook);
+                        requestedCell = cell;
+                        cell = seedNotebookStickySettings(cell, readNotebookStickySettings(engine, String(args.notebook_id)));
                         const withCell = seedInitialGenerationPrompt({
                             ...notebook,
                             cells: [...notebook.cells, cell],
@@ -1209,6 +1214,8 @@ export function videobookDomainDefs(engine, books) {
                             ],
                         };
                     }, { cellId: cell.id });
+                    if (result.ok)
+                        rememberNotebookStickySettings(engine, String(args.notebook_id), requestedCell);
                     return result.ok
                         ? json({
                             ...cellPayload(cell),
@@ -1239,6 +1246,7 @@ export function videobookDomainDefs(engine, books) {
                     return failure(`Stale notebook revision: expected ${args.expected_revision}`);
                 }
                 const patch = args.cell;
+                const edited = {};
                 try {
                     const result = await mutateNotebook(engine, String(args.notebook_id), "update_notebook_cell", (notebook) => {
                         if (typeof args.expected_revision === "string"
@@ -1298,10 +1306,15 @@ export function videobookDomainDefs(engine, books) {
                                     ? {}
                                     : { pinnedResults: patch.pinned_results.map(pinnedResultFromInput) }),
                             }, document);
-                            const next = reconcileInitialGenerationPrompt(cell, normalized);
+                            const reconciled = reconcileInitialGenerationPrompt(cell, normalized);
+                            const next = reconciled.model !== cell.model
+                                ? seedNotebookStickySettings(reconciled, readNotebookStickySettings(engine, String(args.notebook_id)))
+                                : reconciled;
                             const validation = validateCellConfiguration(next, document);
                             if (!validation.ok)
                                 throw new Error(validation.message);
+                            edited.previous = cell;
+                            edited.next = reconciled;
                             return next;
                         });
                         if (!found)
@@ -1312,6 +1325,8 @@ export function videobookDomainDefs(engine, books) {
                         });
                         return markDescendantsStale(updated, String(args.cell_id));
                     }, { cellId: args.cell_id });
+                    if (result.ok && edited.next)
+                        rememberNotebookStickySettings(engine, String(args.notebook_id), edited.next, edited.previous);
                     return result.ok
                         ? json({ cell_id: args.cell_id, revision: result.value.hash })
                         : failure(result.error.message);

package/dist/usage-providers.js

@@ -53,13 +53,13 @@ export function createFreeMediaUpload(options = {}) {
     return capturedProvider("free-media-upload", (fetch) => freemediaupload({ ...options, fetch }), options?.fetch);
 }
 export function uploadFalFile(options, input) {
-    return withHarCapture({ provider: "fal", endpoint: "uploadFile", input }, (fetch) => falUpload(fal({ ...options, fetch }), input), providerUsageFetch("fal", options.fetch));
+    return withHarCapture({ provider: "fal", endpoint: "storage.upload.initiate", input }, (fetch) => falUpload(fal({ ...options, fetch }), input), providerUsageFetch("fal", options.fetch));
 }
 export function uploadAlibabaFile(options, input) {
-    return withHarCapture({ provider: "alibaba", endpoint: "uploadFile", input }, (fetch) => alibabaUpload(alibaba({ ...options, fetch }), input), providerUsageFetch("alibaba", options.fetch));
+    return withHarCapture({ provider: "alibaba", endpoint: "api.v1.uploads", input }, (fetch) => alibabaUpload(alibaba({ ...options, fetch }), input), providerUsageFetch("alibaba", options.fetch));
 }
 export function uploadKieFile(options, file, filename) {
-    return withHarCapture({ provider: "kie", endpoint: "uploadFile", input: { file, filename } }, (fetch) => kieUpload(kie({ ...options, fetch }), file, filename), providerUsageFetch("kie", options.fetch));
+    return withHarCapture({ provider: "kie", endpoint: "api.fileStreamUpload", input: { file, filename } }, (fetch) => kieUpload(kie({ ...options, fetch }), file, filename), providerUsageFetch("kie", options.fetch));
 }
 export function submitMediaJob(...args) {
     const [provider, request, approval] = args;

package/package.json

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