videobook 0.2.5 → 0.3.1

package/dist/tools/index.js

@@ -1,3 +1,4 @@
+import { setHarCaptureDef } from "./set-har-capture.js";
 import { coldOpenDefs } from "./cold-open.js";
 import { withBookContext } from "../book-context.js";
 import { bookManager } from "../engine.js";
@@ -78,6 +79,7 @@ import { listAssetsDef } from "./list-assets.js";
 import { listCellGenerationsDef } from "./list-cell-generations.js";
 import { waitForAssetReadyDef } from "./wait-for-asset-ready.js";
 import { generationPayloadDef } from "./generation-payload.js";
+import { getGenerationHarDef } from "./get-generation-har.js";
 import { concatImagesDef } from "./concat-images.js";
 import { chatDef } from "./chat.js";
 import { chainDef } from "./chain.js";
@@ -250,6 +252,7 @@ export function getAllToolDefs(engine, books = bookManager) {
         listChatModelsDef(),
         providerKeyStatusDef(),
         setEnvSecretDef(),
+        setHarCaptureDef(),
         listElevenLabsVoicesDef(),
         estimateCostDef(engine, books),
         bookUsageDef(engine),
@@ -285,6 +288,7 @@ export function getAllToolDefs(engine, books = bookManager) {
         listCellGenerationsDef(engine),
         waitForAssetReadyDef(engine),
         generationPayloadDef(engine),
+        getGenerationHarDef(engine),
         concatImagesDef(engine),
         chatDef(engine),
         chainDef(engine),

package/dist/tools/list-cell-generations.js

@@ -2,6 +2,20 @@ import { z } from "zod";
 import { findGenerateAudioOutput, findGenerateImageOutput, findGenerateVideoOutput, listGenerateImageOutputs, listGenerateVideoOutputs, } from "../notebook-cell-outputs.js";
 import { buildAssetList } from "./reconcile-project-work.js";
 import { readProviderTaskStatus } from "../provider-task-status.js";
+import { captureKeys, generationHarStatus } from "../generation-har.js";
+import { readHarIndex } from "../har-index.js";
+import { readHarSettings } from "../har-settings.js";
+import { logger } from "../logger.js";
+async function attemptHarLookup(engine) {
+    try {
+        const [{ mode }, rows] = await Promise.all([readHarSettings(), readHarIndex()]);
+        return { mode, status: async (ids) => generationHarStatus(await captureKeys(engine, ids), mode, rows) };
+    }
+    catch (error) {
+        logger.warn("har-capture-failed", { error });
+        return null;
+    }
+}
 function generationArtifactIds(generations) {
     return [...new Set(generations.flatMap((row) => [
             ...(row.outputArtifactId ? [row.outputArtifactId] : []),
@@ -132,6 +146,7 @@ export function listCellGenerationsDef(engine) {
                     ? generationsResult.value.filter((row) => !row.outputCellId || row.outputCellId === requestedResult.id)
                     : generationsResult.value;
                 const transitions = generationTransitions(engine, rows);
+                const harLookup = await attemptHarLookup(engine);
                 const assets = await buildAssetList(engine, book_id);
                 const assetById = new Map(assets.map((asset) => [asset.artifact_id, asset]));
                 const attempts = [];
@@ -180,6 +195,9 @@ export function listCellGenerationsDef(engine) {
                         ...(include_payloads ? { payload } : {}),
                         commandPlan,
                         transitions: transitions.get(row.generationId) ?? [],
+                        har: harLookup
+                            ? await harLookup.status([row.generationId, row.providerArtifactId, row.outputArtifactId])
+                            : null,
                         createdAt: row.createdAt,
                         updatedAt: row.updatedAt,
                     });
@@ -205,6 +223,7 @@ export function listCellGenerationsDef(engine) {
                         latestStatus: rows[0]?.status ?? null,
                         artifactIds: generationArtifactIds(rows),
                     },
+                    harMode: harLookup?.mode ?? null,
                 };
                 return {
                     content: [{

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,
@@ -791,12 +644,18 @@ async function processMachGenTaskStatus(engine, task, status, result, bookId) {
     });
     result.completed.push({ assetId: task.artifactId, taskType: task.taskType, jobId });
 }
+function withProviderTaskContext(engine, bookId, task, operation) {
+    return withBookContext({ bookId, engine, operation: "poll_pending_provider_tasks", artifactId: task.artifactId,
+        providerTaskId: task.taskId, attemptId: typeof task.meta.attemptId === "string" ? task.meta.attemptId : task.artifactId,
+        runId: typeof task.meta.runId === "string" ? task.meta.runId : undefined,
+        model: typeof task.meta.model === "string" ? task.meta.model : undefined }, operation);
+}
 async function pollMachGenTasks(engine, tasks, result, bookId, baseURL) {
     const machgenTasks = tasks.filter((task) => task.taskType === MEDIA_TASK_TYPES.machgen);
     if (!getApiKey("MACHGEN_API_KEY") || machgenTasks.length === 0)
         return;
     const provider = machgenProvider(30_000, baseURL);
-    await Promise.all(machgenTasks.map(async (task) => {
+    await Promise.all(machgenTasks.map(async (task) => withProviderTaskContext(engine, bookId, task, async () => {
         try {
             await processMachGenTaskStatus(engine, task, await provider.api.v0.tasks(task.taskId), result, bookId);
         }
@@ -807,7 +666,7 @@ async function pollMachGenTasks(engine, tasks, result, bookId, baseURL) {
             if (machgenPollFailureIsFinal(error))
                 await failPendingTaskAndLog(engine, task.artifactId, task.taskId, { message: failMsg, prompt });
         }
-    }));
+    })));
 }
 /**
  * Poll provider-pending tasks: submit queued KIE rows, age out stale tasks,
@@ -887,7 +746,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
             timeout: 30_000,
             ...(kieBaseURL ? { baseURL: kieBaseURL } : {}),
         });
-        await Promise.all(kieTasks.map(async (task) => {
+        await Promise.all(kieTasks.map(async (task) => withProviderTaskContext(engine, book_id, task, async () => {
             try {
                 const taskInfo = await provider.get.api.v1.jobs.recordInfo(task.taskId);
                 await processKieTaskResult(engine, task, taskInfo, result, book_id);
@@ -904,7 +763,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
                     }
                 }
             }
-        }));
+        })));
     }
     // Poll KIE Veo tasks (separate namespace: kie.veo.get.api.v1.veo.recordInfo)
     const veoTasks = pollableTasks.filter(isVeoPendingTask);
@@ -914,7 +773,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
             timeout: 30_000,
             ...(kieBaseURL ? { baseURL: kieBaseURL } : {}),
         });
-        await Promise.all(veoTasks.map(async (task) => {
+        await Promise.all(veoTasks.map(async (task) => withProviderTaskContext(engine, book_id, task, async () => {
             const prompt = metaPrompt(task.meta);
             try {
                 const recordInfo = await provider.veo.get.api.v1.veo.recordInfo(task.taskId);
@@ -973,13 +832,13 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
                     }
                 }
             }
-        }));
+        })));
     }
     // Poll xAI tasks (only if API key is set)
     const xaiTasks = pollableTasks.filter((t) => t.taskType.startsWith("xai_"));
     if (process.env.XAI_API_KEY && xaiTasks.length > 0) {
         const provider = createXai({ apiKey: process.env.XAI_API_KEY, timeout: 30_000 });
-        await Promise.all(xaiTasks.map(async (task) => {
+        await Promise.all(xaiTasks.map(async (task) => withProviderTaskContext(engine, book_id, task, async () => {
             const prompt = metaPrompt(task.meta);
             try {
                 const videoResult = await provider.get.v1.videos(task.taskId);
@@ -1029,13 +888,13 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
                     }
                 }
             }
-        }));
+        })));
     }
     // Poll Alibaba tasks (only if API key is set)
     const alibabaTasks = pollableTasks.filter((t) => t.taskType.startsWith("alibaba_"));
     if (process.env.DASHSCOPE_API_KEY && alibabaTasks.length > 0) {
         const provider = createAlibaba({ apiKey: process.env.DASHSCOPE_API_KEY, timeout: 30_000 });
-        await Promise.all(alibabaTasks.map(async (task) => {
+        await Promise.all(alibabaTasks.map(async (task) => withProviderTaskContext(engine, book_id, task, async () => {
             const prompt = metaPrompt(task.meta);
             try {
                 const taskStatus = await provider.get.api.v1.tasks(task.taskId);
@@ -1105,7 +964,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
                     }
                 }
             }
-        }));
+        })));
     }
     // Poll FAL tasks (only if API key is set)
     const falTasks = pollableTasks.filter((t) => t.taskType.startsWith("fal_"));
@@ -1116,7 +975,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
         // — e.g. `fal-ai/elevenlabs/speech-to-text/scribe-v2` — 405s. Strip back
         // to `fal-ai/elevenlabs` for polling.
         const falNamespace = (endpointId) => endpointId.split("/").slice(0, 2).join("/");
-        await Promise.all(falTasks.map(async (task) => {
+        await Promise.all(falTasks.map(async (task) => withProviderTaskContext(engine, book_id, task, async () => {
             const prompt = metaPrompt(task.meta);
             const endpointId = typeof task.meta?.falEndpointId === "string" ? task.meta.falEndpointId : null;
             if (!endpointId) {
@@ -1179,7 +1038,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
                     }
                 }
             }
-        }));
+        })));
     }
     await pollMachGenTasks(engine, pollableTasks, result, book_id, options.machgenBaseURL ?? providerEndpoints().machgenBaseURL);
     for (const task of expiredTasks) {

package/dist/tools/set-har-capture.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { harSettingsSchema, readHarSettings, writeHarSettings, harDirectory } from "../har-settings.js";
+import { appState } from "../app-state.js";
+export function setHarCaptureDef(store = appState) {
+    return {
+        name: "set_har_capture",
+        description: "Read or change opt-in local provider HAR diagnostics. Captures retain prompts, media URLs, parameters, responses and errors; secrets, cookies and oversized media bytes are scrubbed. Omit mode to read settings. Environment override wins.",
+        schema: {
+            mode: harSettingsSchema.shape.mode.removeDefault().optional(),
+            maxAgeDays: harSettingsSchema.shape.maxAgeDays.removeDefault().optional(),
+            maxTotalMB: harSettingsSchema.shape.maxTotalMB.removeDefault().optional(),
+        },
+        handler: async (args) => {
+            try {
+                const changes = z.object({
+                    mode: harSettingsSchema.shape.mode.removeDefault().optional(),
+                    maxAgeDays: harSettingsSchema.shape.maxAgeDays.removeDefault().optional(),
+                    maxTotalMB: harSettingsSchema.shape.maxTotalMB.removeDefault().optional(),
+                }).parse(args);
+                const settings = Object.values(changes).some((value) => value !== undefined)
+                    ? await writeHarSettings({ ...await readHarSettings(store, {}), ...changes }, store)
+                    : await readHarSettings(store);
+                return { content: [{ type: "text", text: JSON.stringify({ ...settings, dir: harDirectory(), overridden: Boolean(process.env.VIDEOBOOK_HAR_CAPTURE?.trim()) }) }] };
+            }
+            catch (error) {
+                return { isError: true, content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }] };
+            }
+        },
+    };
+}

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/upload.js

@@ -1,4 +1,5 @@
-import { createFreeMediaUpload, uploadToAnyHost } from "@apicity/free-media-upload";
+import { createFreeMediaUpload } from "./usage-providers.js";
+import { uploadToAnyHost } from "@apicity/free-media-upload";
 import { createHash } from "node:crypto";
 import { maybeReencodeImage, maybeUpscaleSmallImage } from "./image-compress.js";
 export function contentHash(data) {