@gentbajko/slopify 2.3.0 → 2.4.0

package/dist/slices/rebuild/recipe-validation.js

@@ -1,15 +1,19 @@
-import { narrationPreparationFields, usesNarrationPreparation, usesYoutubeDescription, youtubeDescriptionFields, } from "../admission/rules.js";
+import { narrationPreparationFields, shortsFields, usesNarrationPreparation, usesShorts, usesYoutubeDescription, videoEditFields, youtubeDescriptionFields, } from "../admission/rules.js";
 import { detectSlots, render } from "../admission/substitute.js";
+import { usesAnimation } from "../video/edit-settings.js";
 export function validateRecipeInputs(config, content) {
     const fields = [
         ...narrationPreparationFields(config),
         ...youtubeDescriptionFields(config),
+        ...shortsFields(config),
+        ...videoEditFields(config),
     ];
     const llm = (config.sources.research === "generate" && config.sources.article !== "provide") ||
         (config.sources.article === "generate" && !content.articleEdited) ||
         config.sources.thumbnail === "prompt_by_llm" ||
         usesNarrationPreparation(config) ||
         usesYoutubeDescription(config) ||
+        usesShorts(config) ||
         (config.sources.audio === "generate" &&
             (config.intro?.mode === "llm" || config.outro?.mode === "llm"));
     if (llm && (!config.llm?.provider.trim() || !config.llm.model.trim()))
@@ -24,7 +28,9 @@ export function validateRecipeInputs(config, content) {
         content.imageOrder.some((key) => content.imageDefinitions[key]?.source === "generate");
     if ((generatedImages ||
         config.sources.thumbnail === "from_prompt" ||
-        config.sources.thumbnail === "prompt_by_llm") &&
+        config.sources.thumbnail === "prompt_by_llm" ||
+        usesShorts(config) ||
+        usesAnimation(config)) &&
         (!config.images?.provider.trim() || !config.images.model.trim()))
         fields.push({ field: "images", message: "Pick an image provider and model." });
     if (content.imageOrder.length > 60)
@@ -56,6 +62,17 @@ export function validateRecipeInputs(config, content) {
             raw: content.promptTemplates.description,
             literal: config.rendered.description,
         });
+    // Likewise the Shorts step's two prompts, each only when one is picked.
+    for (const [key, name] of [
+        ["shorts", config.shorts?.prompt],
+        ["shortsImage", config.shorts?.imagePrompt],
+    ])
+        if (usesShorts(config) && name?.trim() && content.promptTemplates[key] != null)
+            prompts.push({
+                field: `rendered.${key}`,
+                raw: content.promptTemplates[key] ?? null,
+                literal: config.rendered[key],
+            });
     if ((config.sources.article === "generate" && !content.articleEdited) ||
         (config.sources.research === "generate" && config.sources.article !== "provide"))
         prompts.push({

package/dist/slices/rebuild/recipe-visual.js

@@ -1,7 +1,9 @@
 import { render } from "../admission/substitute.js";
 import { recipe, resourceIdentity, } from "./recipe-model.js";
 import { matchingText, renderedPrompt } from "./recipe-text.js";
-export function visualRecipes(config, content, audioFingerprint, captionFingerprint) {
+export function visualRecipes(config, content, audioFingerprint, captionFingerprint, 
+// What the Video stage's edit settings add (`recipe-edit.ts`), from the images planned here.
+edit) {
     const recipes = [];
     const imageKeys = config.sources.images === "off" ? [] : content.imageOrder;
     for (const key of imageKeys) {
@@ -24,6 +26,7 @@ export function visualRecipes(config, content, audioFingerprint, captionFingerpr
             }, [], { unresolved: image.source === "provide" ? image.assetId === null : !prompt?.trim() }));
     }
     if (config.sources.video !== "off") {
+        const edited = edit?.([...recipes]) ?? { recipes: [], values: [], dependsOn: [] };
         const audioKeys = config.sources.audio === "off"
             ? []
             : [
@@ -55,12 +58,18 @@ export function visualRecipes(config, content, audioFingerprint, captionFingerpr
                 ...(config.motionStyle === "zoom" ? [] : [config.motionStyle]),
                 // v1 split the timeline evenly across the images; v2 cycles them.
                 "slideshow-zoom-v2",
+                // Only what the edit settings change; nothing at all for today's slideshow, so
+                // its fingerprint is the one it always had.
+                ...(edited.values.length === 0 ? [] : [["video-edit", ...edited.values]]),
             ],
         }, [
             ...recipes.map((value) => value.key),
             ...audioKeys,
             ...(config.subtitles?.mode === "burn-in" ? ["subtitles:files"] : []),
+            ...edited.dependsOn,
         ], { unresolved: imageKeys.length === 0 }));
+        // After the export, so the images' recipes above stay the only ones its first values list.
+        recipes.splice(recipes.length - 1, 0, ...edited.recipes);
     }
     return recipes;
 }

package/dist/slices/rebuild/recipe-work.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { estimateRequests } from "../estimate/index.js";
+import { defaultShortsPrompt, shortsImageUpperBound } from "../shorts/model.js";
 import { planDependencies } from "./dependencies.js";
 import { matchingNarrationPiece } from "./narration-reuse.js";
 import { buildRecipes } from "./recipe-build.js";
@@ -63,7 +64,7 @@ export function planRevisionWork(revision, manifest, catalogue, availableAssetId
             null,
         after: row.fingerprint,
     }));
-    const priced = work.map((row) => priceRecipe(row, recipes.find((one) => one.key === row.key)));
+    const priced = work.flatMap((row) => priceRecipes(row, recipes.find((one) => one.key === row.key)));
     return {
         recipes,
         work,
@@ -180,6 +181,74 @@ function retainedFor(row, logical, manifest, available) {
 // ceiling: the timed transcript of a 20-minute narration, about 3,000 words. The real one
 // is only built once the word timing lands.
 const youtubeTranscriptEstimate = 20000;
+// The numbered transcript the shorts are picked from is the same text with a number and a
+// span before every sentence rather than a time before every passage.
+const shortsTranscriptEstimate = 24000;
+// What a step is charged as. Most steps are one request; what stands in for the shorts
+// until they are picked is every clip's image prompts and, at the longest length allowed,
+// every image, which is the most the step can cost.
+export function priceRecipes(work, value) {
+    const input = value?.input;
+    const unfolds = value?.unfoldsImages;
+    // A short's image prompts once the clips are picked: the call, and the images it leads to,
+    // as many as the clip's length asks for.
+    if (work.disposition === "generate" && unfolds !== undefined)
+        return [
+            priceRecipe(work, value),
+            ...Array.from({ length: unfolds.count }, () => ({
+                kind: "image",
+                stage: work.key,
+                provider: unfolds.provider,
+                model: unfolds.model,
+                detail: `${String(unfolds.count)} vertical ${unfolds.count === 1 ? "image" : "images"} for this short, one per stretch of the seconds each image is held.`,
+            })),
+        ];
+    // What stands in for the chapter openers' clips until the chapters are known: one clip for
+    // the opening and for each chapter the article's headings promise, the most it can cost.
+    if (work.disposition === "generate" &&
+        input?.kind === "deferred" &&
+        input.operation === "animate" &&
+        Array.isArray(input.template)) {
+        const [, , provider, model, upper] = input.template;
+        const clips = typeof upper === "number" ? upper : 0;
+        return Array.from({ length: clips }, () => ({
+            kind: "image",
+            stage: work.key,
+            provider: typeof provider === "string" ? provider : "",
+            model: typeof model === "string" ? model : "",
+            detail: `Up to ${String(clips)} animated clips, one per chapter opening; the chapters are found when the word timing lands, so fewer may be made.`,
+        }));
+    }
+    if (work.disposition !== "generate" ||
+        input?.kind !== "deferred" ||
+        input.operation !== "shorts" ||
+        !Array.isArray(input.template))
+        return [priceRecipe(work, value)];
+    const [, style, provider, model, imageSeconds, count, maxSeconds, llmProvider, llmModel] = input.template;
+    const clips = typeof count === "number" ? count : 0;
+    const images = typeof imageSeconds === "number" && typeof maxSeconds === "number"
+        ? shortsImageUpperBound({ count: clips, maxSeconds }, imageSeconds)
+        : 0;
+    const detail = `Up to ${String(images)} vertical images: ${String(clips)} shorts at the longest length allowed. The clips are picked when the step runs, so shorter ones use fewer.`;
+    return [
+        ...Array.from({ length: clips }, () => ({
+            kind: "llm",
+            stage: work.key,
+            provider: typeof llmProvider === "string" ? llmProvider : "",
+            model: typeof llmModel === "string" ? llmModel : "",
+            inputCharacters: (typeof style === "string" ? style.length : 0) + 3000,
+            outputCharacters: 2400,
+            detail: "One LLM call per short writes its image prompts; its length is estimated.",
+        })),
+        ...Array.from({ length: images }, () => ({
+            kind: "image",
+            stage: work.key,
+            provider: typeof provider === "string" ? provider : "",
+            model: typeof model === "string" ? model : "",
+            detail,
+        })),
+    ];
+}
 export function priceRecipe(work, value) {
     if (value === undefined || work.disposition !== "generate")
         return {
@@ -217,6 +286,19 @@ export function priceRecipe(work, value) {
         };
     if (input.kind === "image")
         return { kind: "image", stage: work.key, provider: input.provider, model: input.model };
+    if (input.kind === "local" && input.operation === "shorts-pick-v1") {
+        const [, provider, model, , prompt, count] = Array.isArray(input.values) ? input.values : [];
+        return {
+            kind: "llm",
+            stage: work.key,
+            provider: typeof provider === "string" ? provider : "",
+            model: typeof model === "string" ? model : "",
+            inputCharacters: (typeof prompt === "string" && prompt !== "" ? prompt.length : defaultShortsPrompt.length) +
+                shortsTranscriptEstimate,
+            outputCharacters: 400 * (typeof count === "number" ? count : 1),
+            detail: "The numbered transcript is built when the step runs; its length is estimated. One more call is made when the first answer breaks the rules. Retries are excluded.",
+        };
+    }
     if (input.kind === "local" && input.operation === "youtube-description-v1") {
         const [, provider, model, , prompt] = Array.isArray(input.values) ? input.values : [];
         return {

package/dist/slices/rebuild/runtime-animate.js

@@ -0,0 +1,110 @@
+import { mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { discardPreparedAssets, writeAsset } from "../storage/assets.js";
+import { outputPath, projectDir } from "../storage/layout.js";
+import { runFfmpeg } from "../video/ffmpeg.js";
+import { executionView } from "./runtime-plan.js";
+import { preparedResult, publishResult } from "./runtime-publication.js";
+// Animate images: one still of the slideshow sent to the image provider's image-to-video
+// model, and the clip it makes saved beside the image. The still goes up as a small JPEG, so
+// the request stays well under what either provider takes inline.
+//
+// A clip that cannot be made is not worth failing the video for: after the provider's own
+// retries the step finishes without a clip, saying why, and the render shows the still in
+// its place and puts that sentence on the video (`runtime-export.ts`).
+// ceiling: 1280 px on the long side is more than the 720p the catalogue's models are asked
+// for, and keeps a JPEG to a few hundred KB.
+const sentWidth = 1280;
+export async function executeAnimateRecipe(deps, context, providers, piece) {
+    if (deps.db
+        .prepare("SELECT state FROM revision_work_pieces WHERE id=? AND work_id=?")
+        .get(piece.id, context.work.workId)?.state === "done")
+        return "done";
+    const input = piece.input;
+    if (input.kind !== "image" || input.animate === undefined)
+        throw new Error("Slopify hit an internal error (an animated image was set up wrongly). Use Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+    const imageKey = piece.key.slice("animate:".length);
+    const view = executionView(deps, context.work.projectId, context.work.revisionId);
+    const index = (view?.revision.content.imageOrder.indexOf(imageKey) ?? -1) + 1;
+    const still = view?.outputs.find((row) => row.workKey === `image:${imageKey}` && row.selected && row.available && row.state === "ready");
+    const fallback = async (reason) => {
+        deps.log.write("warn", "video.animate.fallback", { detail: reason });
+        await publishResult(deps, context, piece, [], {
+            fallback: `Image ${String(index)} is shown as a still: ${reason}`,
+        });
+        return "done";
+    };
+    if (still === undefined)
+        return fallback("its image wasn't ready to animate. Use Re-run section on Video after the image is made.");
+    const animate = providers.forPiece(piece.id).animate;
+    if (animate === undefined)
+        throw new Error("Slopify hit an internal error (animating images isn't wired up in this build). Use Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+    if (!context.maySubmit(piece.id))
+        return "held";
+    let made;
+    try {
+        made = await animate({
+            provider: input.provider,
+            model: input.model,
+            prompt: input.prompt,
+            image: await sendable(deps, context, outputPath(deps.paths, context.work.projectId, still.output.path)),
+            aspect: input.aspect,
+            seconds: input.animate.seconds,
+        });
+    }
+    catch (error) {
+        if (context.signal.aborted)
+            throw error;
+        return fallback(`${error instanceof Error ? error.message : String(error)} To try again, use Re-run section on Video.`);
+    }
+    if (!made.ok)
+        return "held";
+    const asset = writeAsset(deps, context.work.projectId, "animated.mp4", made.value.bytes);
+    try {
+        await publishResult(deps, context, piece, [
+            preparedResult(deps, context, piece, "animated_image", asset, null, {
+                index,
+                prompt: input.prompt,
+                provider: input.provider,
+                model: input.model,
+            }),
+        ], { prompt: input.prompt }, asset);
+        deps.count?.("stage.completed", {
+            stage: context.work.kind,
+            provider: input.provider,
+            model: input.model,
+        });
+    }
+    finally {
+        discardPreparedAssets(deps, [asset]);
+    }
+    return "done";
+}
+// The still as a JPEG no wider than 1280 px, or as it is when there is no ffmpeg to shrink it.
+async function sendable(deps, context, path) {
+    const original = () => {
+        const bytes = new Uint8Array(readFileSync(path));
+        return { bytes, mime: bytes[0] === 0xff ? "image/jpeg" : "image/png" };
+    };
+    if (deps.ffmpeg === undefined)
+        return original();
+    const scratch = mkdtempSync(join(projectDir(deps.paths, context.work.projectId), "animate-"));
+    try {
+        const output = join(scratch, "still.jpg");
+        await runFfmpeg({
+            bin: deps.ffmpeg,
+            args: [
+                ...["-hide_banner", "-nostdin", "-loglevel", "error", "-y", "-i", path],
+                ...["-vf", `scale='min(${String(sentWidth)},iw)':-2`, "-frames:v", "1", "-q:v", "3"],
+                output,
+            ],
+            signal: context.signal,
+            log: deps.log,
+            onProgress: () => undefined,
+        });
+        return { bytes: new Uint8Array(readFileSync(output)), mime: "image/jpeg" };
+    }
+    finally {
+        rmSync(scratch, { recursive: true, force: true });
+    }
+}

package/dist/slices/rebuild/runtime-export-edit.js

@@ -0,0 +1,119 @@
+import { readFileSync } from "node:fs";
+import { extname } from "node:path";
+import { z } from "zod";
+import { usesYoutubeDescription } from "../admission/rules.js";
+import { resolveFont } from "../fonts/index.js";
+import { outputPath } from "../storage/layout.js";
+import { headingChapters } from "../video/chapters.js";
+import { sentenceCutPoints } from "../video/cuts.js";
+import { usesChapterCards, usesNarrationCuts, videoEditOf, } from "../video/edit-settings.js";
+import { probeDurationMs } from "../video/ffmpeg.js";
+import { wordsSchema } from "./runtime-subtitles.js";
+// The containers an uploaded clip may come in; anything else in the images is a still.
+const clipExtensions = new Set([".mp4", ".mov", ".m4v", ".webm", ".mkv"]);
+export function isClipPath(path) {
+    return clipExtensions.has(extname(path).toLowerCase());
+}
+export async function exportEdit(deps, context, view, images) {
+    const config = view.revision.config;
+    const order = view.revision.content.imageOrder;
+    const ready = (key) => view.outputs.find((row) => row.workKey === key && row.selected && row.available && row.state === "ready");
+    // Clips: an animated image's clip first, then an uploaded clip in the image's own place.
+    const clips = [];
+    for (const [index, key] of order.entries()) {
+        const animated = ready(`animate:${key}`);
+        const path = animated?.output.role === "animated_image"
+            ? outputPath(deps.paths, context.work.projectId, animated.output.path)
+            : images[index] !== undefined && isClipPath(images[index] ?? "")
+                ? images[index]
+                : undefined;
+        clips.push(path === undefined
+            ? undefined
+            : { kind: "video", path, seconds: await clipSeconds(deps, context, path, index + 1) });
+    }
+    const warnings = view.pieces.flatMap((row) => {
+        if (!row.key.startsWith("animate:") || !row.selected || row.piece.state !== "done")
+            return [];
+        const parsed = z
+            .object({ fallback: z.string() })
+            .safeParse(JSON.parse(row.piece.payload ?? "null"));
+        return parsed.success ? [parsed.data.fallback] : [];
+    });
+    if (config.videoEdit === undefined)
+        return {
+            edit: clips.some((clip) => clip !== undefined) ? { clips } : undefined,
+            warnings,
+            settings: undefined,
+        };
+    const settings = videoEditOf(config);
+    const cuts = usesNarrationCuts(config);
+    const cards = usesChapterCards(config);
+    const words = cuts || cards ? timingWords(deps, context, view) : [];
+    const chapters = cuts || cards ? chaptersOf(view, config, words) : [];
+    const font = cards
+        ? await resolveFont(deps.paths, config.subtitles?.fontId ?? "default")
+        : undefined;
+    return {
+        edit: {
+            clips,
+            ...(cuts
+                ? {
+                    narration: {
+                        cutPoints: sentenceCutPoints(words),
+                        chapterStarts: chapters.map((chapter) => chapter.start),
+                    },
+                }
+                : {}),
+            ...(settings.transition === "cut"
+                ? {}
+                : { transition: { kind: settings.transition, seconds: settings.transitionSeconds } }),
+            look: {
+                vignette: settings.vignette,
+                grain: settings.grain,
+                grade: settings.grade,
+                atmosphere: settings.atmosphere,
+            },
+            ...(font === undefined
+                ? {}
+                : { cards: { chapters, font: { path: font.path, name: font.assName } } }),
+        },
+        warnings,
+        settings,
+    };
+}
+function timingWords(deps, context, view) {
+    const timing = view.outputs.find((row) => row.selected &&
+        row.available &&
+        row.state === "ready" &&
+        row.workKey === "subtitles:timing" &&
+        row.output.role === "subtitle_words");
+    if (timing === undefined)
+        throw new Error("The narration's word timing, which the video's cuts and chapter cards follow, is missing. Use Re-run section on Video, then Retry stage.");
+    return wordsSchema.parse(JSON.parse(readFileSync(outputPath(deps.paths, context.work.projectId, timing.output.path), "utf8"))).words;
+}
+// The YouTube description's chapters when that step runs, the article's headings otherwise.
+function chaptersOf(view, config, words) {
+    if (usesYoutubeDescription(config)) {
+        const row = view.pieces.find((one) => one.key === "youtube:description" && one.selected && one.piece.state === "done");
+        const parsed = z
+            .object({ chapters: z.array(z.object({ start: z.number(), title: z.string() })) })
+            .safeParse(JSON.parse(row?.piece.payload ?? "null"));
+        if (parsed.success)
+            return parsed.data.chapters;
+    }
+    return headingChapters(view.articleMarkdown ?? "", words);
+}
+async function clipSeconds(deps, context, path, place) {
+    let ms;
+    try {
+        ms = await probeDurationMs(deps.ffmpeg, path, context.signal, deps.log);
+    }
+    catch (error) {
+        if (context.signal.aborted)
+            throw error;
+        ms = 0;
+    }
+    if (!(ms > 0))
+        throw new Error(`Image ${String(place)} is a video clip Slopify can't read, so the video can't show it. Replace it with another clip or an image in Edit project → Images, then Retry stage.`);
+    return ms / 1000;
+}

package/dist/slices/rebuild/runtime-export.js

@@ -7,6 +7,7 @@ import { withPaths } from "../video/edit-list.js";
 import { runFfmpeg } from "../video/ffmpeg.js";
 import { planRender } from "../video/plan.js";
 import { renderSlideshow } from "../video/slideshow.js";
+import { exportEdit } from "./runtime-export-edit.js";
 import { exportSnapshot, retainedOutput, revisionAudio, } from "./runtime-export-inputs.js";
 import { preparedResult, preparedText, publishResult } from "./runtime-publication.js";
 export async function executeExportRecipe(deps, context, piece) {
@@ -53,6 +54,7 @@ export async function executeExportRecipe(deps, context, piece) {
                 throw new Error("The video export can't find one of the slideshow images. Use Re-run section on Images (or regenerate that image in Edit project → Images), then Retry stage.");
             return outputPath(deps.paths, context.work.projectId, row.output.path);
         });
+        const edited = wav ? undefined : await exportEdit(deps, context, view, images);
         const plan = wav
             ? undefined
             : planRender({
@@ -67,6 +69,7 @@ export async function executeExportRecipe(deps, context, piece) {
                 outro: segment("outro"),
                 images,
                 output: pending.absolutePath,
+                edit: edited?.edit,
             });
         const totalSeconds = plan?.totalSeconds ?? audio.reduce((sum, row) => sum + row.seconds, 0);
         const projectDirectory = projectDir(deps.paths, context.work.projectId);
@@ -90,6 +93,10 @@ export async function executeExportRecipe(deps, context, piece) {
                 output: pending.path,
                 editList: withPaths(plan.editList, relativePath),
                 subtitles: config.subtitles,
+                ...(edited?.settings === undefined ? {} : { videoEdit: edited.settings }),
+                ...(edited === undefined || edited.warnings.length === 0
+                    ? {}
+                    : { warnings: edited.warnings }),
             };
         if (!context.maySubmit(piece.id))
             return "held";
@@ -122,7 +129,12 @@ export async function executeExportRecipe(deps, context, piece) {
             });
         context.signal.throwIfAborted();
         const asset = sealAsset(deps, pending);
-        prepared.push(preparedResult(deps, context, piece, wav ? "audio_export" : "video", asset, Math.round(totalSeconds * 1000), { subtitlesMode: mode }));
+        prepared.push(preparedResult(deps, context, piece, wav ? "audio_export" : "video", asset, Math.round(totalSeconds * 1000), {
+            subtitlesMode: mode,
+            ...(edited === undefined || edited.warnings.length === 0
+                ? {}
+                : { warnings: edited.warnings }),
+        }));
         prepared.push(preparedText(deps, context, piece, "render_params", "render.json", JSON.stringify(record)));
         prepared.push(...captions.map((row) => retainedOutput(deps, view, row)));
         await publishResult(deps, context, piece, prepared, { totalSeconds }, asset);

package/dist/slices/rebuild/runtime-materialize.js

@@ -2,6 +2,7 @@ import { z } from "zod";
 import { transact } from "../../kernel/db/tx.js";
 import { currentRevisionId } from "../revisions/repo.js";
 import { getRevisionView } from "../revisions/view.js";
+import { recipeInputSchema } from "./recipe-input-schema.js";
 import { insertInvocation } from "./runtime-admission.js";
 import { bindNarrationReuse, narrationOrdinal } from "./runtime-narration-reuse.js";
 import { executionPlan, executionView, savedCatalogue } from "./runtime-plan.js";
@@ -56,6 +57,14 @@ export function materializeAdmittedWork(deps, projectId) {
                     continue;
                 if (plan.work.find((row) => row.key === recipe.key)?.disposition === "review")
                     continue;
+                // A step waiting on its inputs changes fingerprint each time one lands: every
+                // narration chunk moves the joined audio, the timing, the export and the YouTube
+                // description after it. The waiting row is the same request with newer inputs, so it
+                // takes them in place; minting a row per landing left one never-run row per chunk.
+                if (own !== undefined &&
+                    plan.work.find((row) => row.key === recipe.key)?.disposition !== "reuse" &&
+                    refreshWaiting(deps, head, own, recipe))
+                    continue;
                 if (own !== undefined) {
                     deps.db
                         .prepare("UPDATE revision_work SET state='done' WHERE id=? AND state='pending'")
@@ -89,6 +98,34 @@ export function materializeAdmittedWork(deps, projectId) {
         }
     });
 }
+// Only a row nothing has touched: still pending, one unsent piece, no attempt. Anything
+// further along keeps the old path, which retires it and admits a fresh row.
+function refreshWaiting(deps, head, own, recipe) {
+    const pieces = workPieces(deps.db, own.work_id);
+    const piece = pieces[0];
+    if (pieces.length !== 1 ||
+        piece === undefined ||
+        piece.key !== recipe.key ||
+        piece.state !== "pending" ||
+        piece.submittedAt !== null ||
+        piece.continuation !== null)
+        return false;
+    const waiting = deps.db
+        .prepare("SELECT 1 FROM revision_work w WHERE w.id=? AND w.state='pending' AND NOT EXISTS(SELECT 1 FROM attempts a WHERE a.work_id=w.id)")
+        .get(own.work_id);
+    if (waiting === undefined)
+        return false;
+    deps.db
+        .prepare("UPDATE revision_work SET fingerprint=? WHERE id=?")
+        .run(recipe.fingerprint, own.work_id);
+    deps.db
+        .prepare("UPDATE revision_work_pieces SET fingerprint=?,request_fingerprint=?,logical_fingerprint=?,input_json=? WHERE id=?")
+        .run(recipe.fingerprint, recipe.requestFingerprint, recipe.logicalFingerprint, JSON.stringify(recipeInputSchema.parse(recipe.input)), piece.id);
+    deps.db
+        .prepare("UPDATE revision_work_reservations SET fingerprint=? WHERE revision_id=? AND work_id=? AND work_key=?")
+        .run(recipe.fingerprint, head, own.work_id, recipe.key);
+    return true;
+}
 function desiredAnchor(deps, projectId, head, row) {
     const view = getRevisionView(deps, projectId, head);
     return (view?.revision.fingerprints[row.logical_key ?? row.work_key] ===
@@ -103,5 +140,16 @@ function futureKey(recipe) {
         return "research:planner";
     if (recipe.key === "article:continuation")
         return "article:body";
+    // A short's images and render unfold from its image prompts, admitted with them: under the
+    // pick on a first run, or on their own when one short is made again and the pick is kept.
+    // The prompts unfold from the pick's answer.
+    const clip = /^(shorts:\d+):(?:image:\d+|render)$/.exec(recipe.key);
+    if (clip?.[1] !== undefined)
+        return `${clip[1]}:prompts`;
+    if (recipe.key.startsWith("shorts:"))
+        return "shorts:pick";
+    // The chapter openers' clips unfold from the deferred request that stood in for them.
+    if (recipe.key.startsWith("animate:"))
+        return "animate:future";
     return recipe.key;
 }

package/dist/slices/rebuild/runtime-piece-label.js

@@ -12,6 +12,17 @@ export function pieceLabel(deps, context, piece) {
         return "Document";
     if (key === "youtube:description")
         return "YouTube description";
+    if (key === "shorts:pick" || key === "shorts:future")
+        return "Shorts";
+    if (key === "animate:future")
+        return "Animated images";
+    const short = /^shorts:(\d+):(prompts|image:(\d+)|render)$/.exec(key);
+    if (short !== null)
+        return short[2] === "prompts"
+            ? `Short ${short[1]} image prompts`
+            : short[2] === "render"
+                ? `Short ${short[1]}`
+                : `Short ${short[1]} image ${short[3]}`;
     if (key === "entry:intro:text")
         return "Intro text";
     if (key === "entry:outro:text")
@@ -28,6 +39,10 @@ export function pieceLabel(deps, context, piece) {
         const at = view()?.revision.content.imageOrder.indexOf(key.slice("image:".length)) ?? -1;
         return at === -1 ? "An image" : `Image ${String(at + 1)}`;
     }
+    if (key.startsWith("animate:")) {
+        const at = view()?.revision.content.imageOrder.indexOf(key.slice("animate:".length)) ?? -1;
+        return at === -1 ? "An animated image" : `Animated image ${String(at + 1)}`;
+    }
     const narration = /^(?:narration:prepare:(?:intro|body|outro):)?audio:(intro|body|outro)(?::(.+))?$/.exec(key);
     if (narration === null)
         return undefined;

package/dist/slices/rebuild/runtime-publication.js

@@ -8,7 +8,13 @@ import { rebindPublishedNarration } from "./runtime-narration-publication.js";
 import { executionPlan, executionView, savedCatalogue } from "./runtime-plan.js";
 export function preparedResult(deps, context, piece, role, asset, durationMs = null, meta = {}) {
     return {
-        slot: role === "image" ? piece.key : `${context.work.kind}:${role}`,
+        // A project holds many images, and one video and several images per short.
+        slot: role === "image" ||
+            role === "short_image" ||
+            role === "short_video" ||
+            role === "animated_image"
+            ? piece.key
+            : `${context.work.kind}:${role}`,
         workKey: piece.key,
         fingerprint: piece.logicalFingerprint ?? piece.fingerprint,
         asset,
@@ -46,7 +52,7 @@ export function preparedTexts(deps, context, piece, texts) {
         throw error;
     }
 }
-export async function publishResult(deps, context, piece, outputs, payload, asset = null) {
+export async function publishResult(deps, context, piece, outputs, payload, asset = null, retired) {
     try {
         const record = {
             key: piece.key,
@@ -67,7 +73,7 @@ export async function publishResult(deps, context, piece, outputs, payload, asse
             },
         };
         const result = transact(deps.db, () => {
-            const committed = commitRevisionOutputs(deps, { work: context.work, pieceId: piece.id, publicationId: piece.id }, outputs, [record]);
+            const committed = commitRevisionOutputs(deps, { work: context.work, pieceId: piece.id, publicationId: piece.id }, outputs, [record], retired);
             rebindPublishedNarration(deps, context.work, piece);
             deps.db
                 .prepare("UPDATE revision_work_pieces SET state='done' WHERE id=? AND work_id=?")
@@ -93,7 +99,7 @@ function pieceKind(piece) {
         return "chunk";
     if (piece.input.kind === "provided" && /^audio:(intro|outro):\d+$/.test(piece.key))
         return "segment";
-    if (piece.key.startsWith("image:"))
+    if (piece.key.startsWith("image:") || piece.key.startsWith("animate:"))
         return "image";
     if (piece.key.startsWith("research:chapter:"))
         return "chapter";
@@ -117,6 +123,21 @@ function pieceIndex(deps, context, piece) {
         return 1;
     if (piece.key === "entry:outro:text")
         return 2;
+    // The shorts' steps take places of their own, past every other step of the Video stage:
+    // the pick, then per short its prompts, its images and its render.
+    const short = /^shorts:(?:(\d+):(prompts|image:(\d+)|render)|pick)$/.exec(piece.key);
+    if (short !== null)
+        return short[1] === undefined
+            ? 10000
+            : 10000 +
+                Number(short[1]) * 1000 +
+                (short[2] === "prompts" ? 0 : short[2] === "render" ? 999 : Number(short[3]));
+    // Animated images take places past the shorts', one per image of the slideshow.
+    if (piece.key.startsWith("animate:")) {
+        const order = executionView(deps, context.work.projectId, context.work.revisionId)?.revision
+            .content.imageOrder;
+        return 900000 + (order?.indexOf(piece.key.slice("animate:".length)) ?? -1) + 1;
+    }
     const localOrder = [
         "audio:body:concat",
         "audio:intro",