@gentbajko/slopify 3.0.7 → 3.0.9

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

@@ -8,6 +8,7 @@ import { masterPlan } from "./recipe-loudness.js";
 import { resourceIdentity } from "./recipe-model.js";
 import { imageReference, referenceRecipe } from "./recipe-reference.js";
 import { withReviews } from "./recipe-reviews.js";
+import { imageScenes } from "./recipe-scenes.js";
 import { shortsRecipes } from "./recipe-shorts.js";
 import { textRecipes } from "./recipe-text.js";
 import { thumbnailRecipes, visualAssets, visualRecipes } from "./recipe-visual.js";
@@ -29,6 +30,8 @@ export function buildRecipes(context) {
     const drawnFrom = imageReference(context, reference);
     const thumbnail = thumbnailRecipes(context, text.recipes, referenceForThumbnail(context.config) ? drawnFrom : undefined);
     const youtube = youtubeRecipes(context, exports);
+    // Each image's scene, written from the article, for image prompts that ask for one.
+    const scenes = imageScenes(context, text);
     return withReviews(context, [
         ...text.recipes,
         ...audio.recipes,
@@ -38,6 +41,7 @@ export function buildRecipes(context) {
         ...shortsRecipes(context, exports, drawnFrom, audio.cards ?? [], masterPlan(context, audio.levels, "video")),
         ...thumbnail,
         ...documentRecipes(context, text, thumbnail),
-        ...visualAssets(context, visualRecipes(context.config, context.content, audio.mediaFingerprint, captions?.fingerprint ?? null, (images) => editPlan(context, exports, youtube, images, audio.cards ?? []), drawnFrom, timing === undefined ? null : resourceIdentity(context, timing), withLines(masterPlan(context, audio.levels, "video"), linePlan(context, timing)))),
+        ...visualAssets(context, visualRecipes(context.config, context.content, audio.mediaFingerprint, captions?.fingerprint ?? null, (images) => editPlan(context, exports, youtube, images, audio.cards ?? []), drawnFrom, timing === undefined ? null : resourceIdentity(context, timing), withLines(masterPlan(context, audio.levels, "video"), linePlan(context, timing)), scenes)),
+        ...(scenes === undefined ? [] : [scenes.recipe]),
     ]);
 }

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

@@ -44,6 +44,9 @@ export const deferredOperations = [
     "shorts",
     "animate",
     "script-attribution",
+    // Scenes from the article (`recipe-scenes.ts`): the scenes step and each image waiting on it.
+    "image-scenes",
+    "image-scene",
 ];
 export function recipe(context, key, stage, input, dependsOn = [], options = {}) {
     const requestFingerprint = input.kind === "tts" && input.dialogue !== undefined

package/dist/slices/rebuild/recipe-provider-choice.js

@@ -32,7 +32,9 @@ export function recipeProviderChoice(recipe, config) {
             };
     if (input.kind !== "deferred")
         return undefined;
-    const family = input.operation === "narration-preparation" || input.operation === "narration-description"
+    const family = input.operation === "narration-preparation" ||
+        input.operation === "narration-description" ||
+        input.operation === "image-scenes"
         ? "llm"
         : recipe.stage === "audio"
             ? "tts"

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

@@ -1,6 +1,6 @@
 import { stageKinds } from "../../kernel/pipeline.js";
 import { sourceOf } from "../admission/model.js";
-import { allowedSources, edgeSilenceSecondsProblem, imageSecondsProblem, normaliseDraft, silenceGapSecondsMax, voicesFields, zoomPercentProblem, } from "../admission/rules.js";
+import { allowedSources, articleOffFields, edgeSilenceSecondsProblem, imageSecondsProblem, normaliseDraft, silenceGapSecondsMax, voicesFields, zoomPercentProblem, } from "../admission/rules.js";
 import { shortModeFields } from "../admission/short-mode.js";
 import { render } from "../admission/substitute.js";
 import { effectiveClips, pickedShortsOf, rangeProblem } from "../shorts/clips.js";
@@ -27,7 +27,7 @@ function shortRangeFields(base, config, content) {
 }
 export function normalizeArticleIntent(base, edit) {
     const restart = edit.regenerate?.includes("article:body") === true ||
-        (base.revision.config.sources.article === "provide" &&
+        (base.revision.config.sources.article !== "generate" &&
             edit.config.sources.article === "generate");
     const submittedText = edit.content.articleEdited === true ||
         edit.content.articleMarkdown !== base.revision.content.articleMarkdown;
@@ -232,6 +232,7 @@ export function validateRevisionEdit(config, content) {
     if (config.sources.article === "provide" &&
         !(content.articleMarkdown ?? config.provided.article)?.trim())
         fields.push({ field: "provided.article", message: "Paste the article." });
+    fields.push(...articleOffFields(config));
     if (config.sources.audio === "off" &&
         config.subtitles !== undefined &&
         config.subtitles.mode !== "off")

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

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { withLanguage } from "../../kernel/ports/languages.js";
+import { pictureKind, sceneMessages } from "../images/scenes.js";
+import { recipe, selectedReference, } from "./recipe-model.js";
+import { llmInput, llmInputFingerprint } from "./recipe-text.js";
+export const imageScenesKey = "images:scenes";
+export function imageScenes(context, text) {
+    const { config, content } = context;
+    if (config.sources.images !== "generate" || config.imageScenes !== true)
+        return undefined;
+    const keys = [];
+    const pictures = [];
+    for (const key of content.imageOrder) {
+        const image = content.imageDefinitions[key];
+        if (image?.source !== "generate")
+            continue;
+        const body = image.templateKey == null
+            ? image.prompt
+            : (content.promptTemplates[image.templateKey] ?? image.prompt);
+        if (body == null || body.trim() === "")
+            continue;
+        const at = /^imagePrompts\.(\d+)$/.exec(image.templateKey ?? "")?.[1];
+        const name = at === undefined ? "Image" : (config.imagePrompts[Number(at)]?.name ?? "Image");
+        keys.push(key);
+        pictures.push(pictureKind(body, name));
+    }
+    if (keys.length === 0)
+        return undefined;
+    const messages = withLanguage(sceneMessages({ title: config.title, article: text.articleText ?? "", pictures }), config.language);
+    const value = recipe(context, imageScenesKey, "images", text.articleText === null
+        ? {
+            kind: "deferred",
+            version: 1,
+            operation: "image-scenes",
+            template: [llmInputFingerprint(context, messages), text.article.fingerprint],
+        }
+        : llmInput(context, messages), [text.article.key]);
+    return {
+        recipe: value,
+        keys,
+        scenes: text.articleText === null ? undefined : savedScenes(context, value, keys.length),
+    };
+}
+// The scenes saved for this request. The request carries the model's thinking settings from
+// the catalogue, which the plan without a catalogue has not got, so either fingerprint
+// matches (like the shorts' saved prompts).
+function savedScenes(context, value, count) {
+    const logical = context.catalogue === undefined || value.input.kind !== "llm"
+        ? value.fingerprint
+        : recipe({ content: context.content }, value.key, value.stage, { ...value.input, thinkingConfig: null }, value.dependsOn).fingerprint;
+    const piece = context.manifest.pieces.find((row) => row.key === value.key &&
+        selectedReference(row) &&
+        row.piece.state === "done" &&
+        (row.fingerprint === value.fingerprint || row.fingerprint === logical));
+    if (piece?.piece.payload == null)
+        return undefined;
+    const parsed = z
+        .object({ scenes: z.array(z.string()) })
+        .safeParse(JSON.parse(piece.piece.payload));
+    return parsed.success && parsed.data.scenes.length === count ? parsed.data.scenes : undefined;
+}

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

@@ -124,7 +124,8 @@ export function textRecipes(context) {
             speakers: voices.speakers.map((speaker) => ({ id: speaker.id, name: speaker.name })),
             attribute: !writesScript,
         };
-    const article = config.sources.article === "provide" || content.articleEdited === true
+    // A pasted article, or with Article Off an empty one: nothing is written.
+    const article = config.sources.article !== "generate" || content.articleEdited === true
         ? recipe(context, "article:body", "article", {
             kind: "local",
             version: 1,
@@ -250,7 +251,7 @@ export function textRecipes(context) {
         ...(script === undefined ? {} : { script }),
     };
 }
-function llmInputFingerprint(context, messages) {
+export function llmInputFingerprint(context, messages) {
     return fingerprint(JSON.parse(JSON.stringify(llmInput(context, messages))));
 }
 export function matchingText(context, value, field) {
@@ -265,7 +266,7 @@ export function matchingText(context, value, field) {
 }
 function articleMarkdownOf(context) {
     const { config, content, resolved } = context;
-    return config.sources.article === "provide" || content.articleEdited === true
+    return config.sources.article !== "generate" || content.articleEdited === true
         ? (content.articleMarkdown ?? config.provided.article ?? "")
         : resolved.articleMarkdown;
 }

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

@@ -1,5 +1,5 @@
 import { narrationPreparationFields, shortsFields, usesNarrationPreparation, usesReference, usesShorts, usesYoutubeDescription, videoEditFields, youtubeDescriptionFields, } from "../admission/rules.js";
-import { detectSlots, render } from "../admission/substitute.js";
+import { detectSlots, render, sceneKeyword } from "../admission/substitute.js";
 import { imagesPerVideoMax } from "../images/scale.js";
 import { loudnessFields } from "../loudness/model.js";
 import { pauseFields } from "../narration/pauses-model.js";
@@ -143,7 +143,8 @@ export function validateRecipeInputs(config, content) {
         if (slots.errors.length > 0)
             fields.push({ field: prompt.field, message: "Fix the keyword placeholders in this prompt." });
         for (const key of slots.names)
-            if (!Object.hasOwn(config.values, key) || !config.values[key]?.trim())
+            if (key !== sceneKeyword &&
+                (!Object.hasOwn(config.values, key) || !config.values[key]?.trim()))
                 fields.push({ field: `values.${key}`, message: "Enter a value for this keyword." });
     }
     return fields;

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

@@ -1,6 +1,7 @@
 import { thumbnailCountOf, thumbnailKey } from "../admission/model.js";
 import { usesShortMode } from "../admission/short-mode.js";
 import { render } from "../admission/substitute.js";
+import { withoutScene, withScene } from "../images/scenes.js";
 import { usesAmbientBed } from "../video/ambient-bed.js";
 import { castFor } from "./recipe-cast.js";
 import { noMaster } from "./recipe-loudness.js";
@@ -15,7 +16,9 @@ reference,
 // The word timing's identity, which a short's captions are drawn from.
 timing = null, 
 // Level the volume: the levelled narration and the master (`recipe-loudness.ts`).
-master = noMaster) {
+master = noMaster, 
+// Each image's own scene, for the images whose prompt asks for one (`recipe-scenes.ts`).
+scenes) {
     const recipes = [];
     const imageKeys = config.sources.images === "off" ? [] : content.imageOrder;
     for (const key of imageKeys) {
@@ -25,7 +28,17 @@ master = noMaster) {
         const raw = image.templateKey === undefined || image.templateKey === null
             ? undefined
             : content.promptTemplates[image.templateKey];
-        const prompt = raw === undefined || raw === null ? image.prompt : render(raw, config.values);
+        const at = scenes?.keys.indexOf(key) ?? -1;
+        if (scenes !== undefined && at !== -1 && image.source === "generate") {
+            recipes.push(sceneImage(config, content, key, raw ?? image.prompt ?? "", scenes, at, reference));
+            continue;
+        }
+        // With Scenes from the article off, a prompt's `{{Scene}}` line is left out.
+        const prompt = raw === undefined || raw === null
+            ? image.prompt === null || image.prompt === undefined
+                ? image.prompt
+                : withoutScene(image.prompt)
+            : render(withoutScene(raw), config.values);
         recipes.push(recipe({ content }, `image:${key}`, "images", image.source === "provide"
             ? { kind: "provided", version: 1, assetId: image.assetId, semantic: null }
             : {
@@ -109,6 +122,37 @@ master = noMaster) {
     }
     return recipes;
 }
+// An image drawn from its own scene. Until the scenes are written it waits as a deferred
+// request that names the scenes step and the image's place among them, so writing them turns
+// it into its image request (materialization), and writing them again draws it again.
+function sceneImage(config, content, key, body, scenes, at, reference) {
+    const scene = scenes.scenes?.[at];
+    const prompt = scene === undefined ? undefined : withScene(render(body, config.values), scene);
+    return recipe({ content }, `image:${key}`, "images", prompt === undefined
+        ? {
+            kind: "deferred",
+            version: 1,
+            operation: "image-scene",
+            template: [
+                scenes.recipe.fingerprint,
+                at,
+                config.images?.provider ?? null,
+                config.images?.model ?? null,
+                config.format,
+                ...(config.images?.thinking === undefined ? [] : [config.images.thinking]),
+                ...(reference === undefined ? [] : [reference.input.fingerprint]),
+            ],
+        }
+        : {
+            kind: "image",
+            version: 1,
+            ...imageChoice(config),
+            aspect: config.format,
+            prompt,
+            ...(reference === undefined ? {} : { reference: reference.input }),
+            ...castField(castFor(config, prompt)),
+        }, [scenes.recipe.key, ...(reference === undefined ? [] : [reference.key])]);
+}
 // What the ambient bed adds to the render's fingerprint: its settings and, for the user's own
 // file, the project asset it plays. Undefined without a bed.
 export function ambientBedValues(config, content) {

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

@@ -278,6 +278,24 @@ export function priceRecipe(work, value, config) {
     const onPlan = config === undefined ? undefined : cliRequest(work, value, config);
     if (onPlan !== undefined)
         return onPlan;
+    // Scenes from the article: an image waiting for its scene is one image, and the scenes are
+    // one call that reads the article (its length is known once the article is written).
+    if (input.kind === "deferred" &&
+        (input.operation === "image-scene" || input.operation === "image-scenes")) {
+        const choice = config === undefined ? undefined : recipeProviderChoice(value, config);
+        if (choice !== undefined && input.operation === "image-scene")
+            return { kind: "image", stage: work.key, provider: choice.provider, model: choice.model };
+        if (choice !== undefined)
+            return {
+                kind: "llm",
+                stage: work.key,
+                provider: choice.provider,
+                model: choice.model,
+                inputCharacters: 90000,
+                outputCharacters: 4000,
+                detail: "The article is read when the step runs; its length is estimated. Retries are excluded.",
+            };
+    }
     if (input.kind === "deferred" && input.operation === "narration-preparation")
         return {
             kind: "unknown",

package/dist/slices/rebuild/recovery-selection.js

@@ -44,6 +44,13 @@ export function redoTarget(view, plan, item) {
         return plan.recipes.some((row) => row.key === `${item}:prompts`)
             ? own([`${item}:prompts`])
             : undefined;
+    // One narration chunk, by the key the Narration editor regenerates it by: its TTS requests
+    // are the roots (`narration-retry.ts`).
+    const chunk = plan.recipes
+        .filter((row) => row.input.kind === "tts" && row.input.logicalKey === item)
+        .map((row) => row.key);
+    if (chunk.length > 0)
+        return own(chunk);
     return plan.recipes.some((row) => row.key === item && row.kind === "provider")
         ? own([item])
         : undefined;

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

@@ -24,7 +24,7 @@ export async function executeDocumentRecipe(deps, context, piece) {
             : readFileSync(outputPath(deps.paths, projectId, row.output.path), "utf8");
     };
     const config = view.revision.config;
-    const article = view.revision.content.articleEdited === true || config.sources.article === "provide"
+    const article = view.revision.content.articleEdited === true || config.sources.article !== "generate"
         ? view.articleMarkdown
         : text("article_md", "article:body");
     if (article === null)

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

@@ -45,6 +45,8 @@ export function pieceLabel(deps, context, piece) {
         return "Shorts";
     if (key === "animate:future")
         return "Animated images";
+    if (key === "images:scenes")
+        return "Image scenes";
     const short = /^shorts:(\d+):(prompts|image:(\d+)|render)$/.exec(key);
     if (short !== null)
         return short[2] === "prompts"

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

@@ -35,7 +35,7 @@ export function executionPlan(deps, view, catalogue) {
     const payloads = view.pieces.filter((piece) => piece.selected && piece.piece.state === "done" && piece.piece.payload !== null);
     const resolved = {
         articleMarkdown: view.revision.content.articleEdited === true ||
-            view.revision.config.sources.article === "provide"
+            view.revision.config.sources.article !== "generate"
             ? view.articleMarkdown
             : textOutput("article_md"),
         researchNotes: textOutput("notes"),

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

@@ -2,6 +2,7 @@ import { basename } from "node:path";
 import { referenceKey, thumbnailVariant } from "../admission/model.js";
 import { plainText } from "../article/plain.js";
 import { splitEndMatter } from "../article/split.js";
+import { checkScenes, sceneCountOf } from "../images/scenes.js";
 import { spokenPassage } from "../narration/describe.js";
 import { observeNarration } from "../narration/live.js";
 import { validatePreparation } from "../narration/preparation.js";
@@ -14,6 +15,7 @@ import { outputPath } from "../storage/layout.js";
 import { probeDurationMs } from "../video/ffmpeg.js";
 import { parseAttribution } from "../voices/attribution.js";
 import { parseScript } from "../voices/script.js";
+import { imageScenesKey } from "./recipe-scenes.js";
 import { executeArticleRequests } from "./runtime-article.js";
 import { imageCall } from "./runtime-image.js";
 import { frozenInstructions } from "./runtime-instructions.js";
@@ -193,6 +195,11 @@ function checkAnswer(piece, answer) {
         return spokenPassage(answer.text) === ""
             ? "The AI model's description had no words a narrator could say. Use Try again; if it keeps happening, choose another model in the Providers section of Edit project, or turn off Describe tables and figures there."
             : undefined;
+    // Scenes from the article: one scene per image, as many as the request lists.
+    if (piece.key === imageScenesKey && piece.input.kind === "llm") {
+        const checked = checkScenes(answer.text, sceneCountOf(piece.input.messages) ?? 0);
+        return checked.ok ? undefined : checked.reason;
+    }
     if (piece.key === "research:planner")
         return chaptersFrom(answer.text).length === 0
             ? "The AI model's research plan listed no chapters, so research could not go on. Use Try again; if it keeps happening, choose another model in the Providers section of Edit project."
@@ -210,6 +217,15 @@ function attributionSource(messages) {
     return messages.at(-1)?.content ?? "";
 }
 async function publishText(deps, context, piece, answer) {
+    if (piece.key === imageScenesKey && piece.input.kind === "llm") {
+        const checked = checkScenes(answer.text, sceneCountOf(piece.input.messages) ?? 0);
+        if (!checked.ok)
+            throw new Error(checked.reason);
+        await publishResult(deps, context, piece, preparedTexts(deps, context, piece, [
+            ["instructions", "instructions.md", frozenInstructions(deps, context, piece)],
+        ]), { scenes: checked.scenes, text: answer.text });
+        return;
+    }
     if (piece.input.kind === "llm" && piece.input.preparation !== undefined) {
         const checked = validatePreparation(answer.text, piece.input.preparation.source);
         if (!checked.ok)

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

@@ -16,6 +16,7 @@ import { speakerColour } from "../voices/palette.js";
 import { speakerPanelEvents, usesSpeakerPanel } from "../voices/panel.js";
 import { panelPortraits } from "../voices/portraits.js";
 import { attributeWords } from "../voices/timing.js";
+import { narrationRetryLimit, requestNarrationRetry } from "./narration-retry.js";
 import { exportSnapshot, retainedOutput, revisionAudio, revisionTranscript, revisionTurns, } from "./runtime-export-inputs.js";
 import { narrationChunks, narrationTextParts, } from "./runtime-narration-text.js";
 import { preparedResult, preparedText, publishResult } from "./runtime-publication.js";
@@ -77,7 +78,7 @@ async function timing(deps, context, piece, snapshot) {
         context.signal.throwIfAborted();
         const { path, kind } = segment;
         if (path !== null && spoken(kind)) {
-            const aligned = await located(snapshot, kind, () => alignSubtitles({
+            const aligned = await located(deps, context, snapshot, kind, () => alignSubtitles({
                 audioPath: path,
                 text: revisionTranscript(deps, snapshot, kind),
                 aliases: narrationAliasesOf(snapshot.view.revision.config),
@@ -250,45 +251,86 @@ async function files(deps, context, piece, snapshot) {
 }
 // A mismatch names the place to fix: the time in the narration, the chunk that holds it (as
 // the Narration editor numbers them) and what was expected against what was heard. The
-// usual cause is a TTS request that skipped or reworded a sentence.
-async function located(snapshot, segment, align) {
+// usual cause is a TTS request that skipped or reworded a sentence, which a second request
+// almost always reads right, so a chunk made by a voice is first recorded again by itself
+// (`narration-retry.ts`); the message says so, and says when its tries are used up.
+async function located(deps, context, snapshot, segment, align) {
     try {
         return await align();
     }
     catch (error) {
         if (!(error instanceof SubtitleMismatch))
             throw error;
-        throw new Error(mismatchMessage(snapshot, segment, error), { cause: error });
+        const chunks = mismatchChunks(snapshot, segment);
+        const at = mismatchChunk(chunks, error);
+        const chunk = at === -1 ? undefined : chunks[at];
+        const retry = chunk !== undefined && retryable(snapshot, chunk.key)
+            ? {
+                chunk: at + 1,
+                try: requestNarrationRetry(deps.db, {
+                    projectId: context.work.projectId,
+                    chunkKey: chunk.key,
+                    now: deps.clock.now().toISOString(),
+                }),
+            }
+            : undefined;
+        throw new Error(describeMismatch(chunks, segment, error, retry), { cause: error });
     }
 }
-export function mismatchMessage(snapshot, segment, mismatch) {
-    let chunks = [];
+// A chunk a voice made from the text: not uploaded audio, not captions edited by hand (their
+// remake waits for the person) and not a multi-voice turn, whose key the regeneration list
+// can't hold yet.
+function retryable(snapshot, key) {
+    if (snapshot.view.revision.content.subtitleCues !== undefined)
+        return false;
+    if (/:turn:\d+$/.test(key))
+        return false;
+    return snapshot.plan.recipes.some((row) => row.input.kind === "tts" && row.input.logicalKey === key);
+}
+function mismatchChunks(snapshot, segment) {
     try {
-        chunks = narrationChunks(narrationTextParts(snapshot.view, snapshot.plan, segment));
+        return narrationChunks(narrationTextParts(snapshot.view, snapshot.plan, segment));
     }
     catch {
         // Without a readable plan the message still gives the time and the words.
+        return [];
     }
-    return describeMismatch(chunks, segment, mismatch);
 }
-export function describeMismatch(chunks, segment, mismatch) {
+export function mismatchMessage(snapshot, segment, mismatch) {
+    return describeMismatch(mismatchChunks(snapshot, segment), segment, mismatch);
+}
+// The chunk that holds the words the audio stopped matching, by index; -1 when none does.
+export function mismatchChunk(chunks, mismatch) {
     const probe = comparable(mismatch.expected).split(" ").slice(0, 6).join(" ");
-    const at = probe === ""
+    return probe === ""
         ? chunks.length - 1
         : chunks.findIndex((chunk) => comparable(chunk.spokenText).includes(probe));
+}
+export function describeMismatch(chunks, segment, mismatch, 
+// Set when the chunk is one a voice made: `try` is the automatic try just asked for, or
+// undefined once its tries are used up.
+retry) {
+    const at = mismatchChunk(chunks, mismatch);
     const chunk = at === -1 ? undefined : chunks[at];
     const where = chunk === undefined
         ? `${clock(mismatch.at)} into the ${segment} narration`
         : `${clock(mismatch.at)} into the ${segment} narration, in narration chunk ${String(at + 1)} of ${String(chunks.length)} (it starts "${opening(chunk.spokenText)}")`;
     const expected = mismatch.expected === "" ? "the end of the text" : `"${mismatch.expected}…"`;
     const heard = mismatch.heard === "" ? "no more speech" : `"${mismatch.heard.toLowerCase()}…"`;
+    const stopped = `Subtitles stopped matching the audio at ${where}. The text expected ${expected} but the audio has ${heard}`;
+    if (retry !== undefined) {
+        const n = String(retry.chunk);
+        return retry.try === undefined
+            ? `${stopped} Slopify already recorded narration chunk ${n} again ${String(narrationRetryLimit)} times and the audio still doesn't match there, so the voice probably reads something its own way (a year, an abbreviation or a name). Listen at ${clock(mismatch.at)}: if words are missing or wrong, reword that sentence in Edit project → Narration → narration chunk ${n}, save, then Continue the run. If it says them right, use Download diagnostics in Settings and report it.`
+            : `${stopped} The voice probably skipped or garbled words there, so Slopify is recording narration chunk ${n} again by itself (try ${String(retry.try)} of ${String(narrationRetryLimit)}) and carries on with the video when it's done. If this message is still here in a few minutes, regenerate narration chunk ${n} in Edit project → Narration, then Continue the run.`;
+    }
     const fix = chunk === undefined
         ? `Listen at ${clock(mismatch.at)}: if words are missing or wrong, regenerate that part in Edit project → Narration, then Continue the run.`
         : `Listen at ${clock(mismatch.at)}: if words are missing or wrong, regenerate narration chunk ${String(at + 1)} in Edit project → Narration, then Continue the run.`;
     // A voice that reads a year, an abbreviation or a name its own way reads it the same way
     // again, so a remake would cost a chunk and fail here once more.
     const same = "If it says them right, only another way (a year, an abbreviation or a name read its own way), regenerating gives the same reading: use Download diagnostics in Settings and report it.";
-    return `Subtitles stopped matching the audio at ${where}. The text expected ${expected} but the audio has ${heard} The recording there probably skips or changes words. ${fix} ${same}`;
+    return `${stopped} The recording there probably skips or changes words. ${fix} ${same}`;
 }
 function comparable(text) {
     return text

package/dist/slices/revisions/mutation-prepare.js

@@ -121,7 +121,7 @@ export async function prepareEditAssets(deps, base, edit) {
             };
             prepared.push(item);
         }
-        const article = edit.config.sources.article === "provide" || content.articleEdited === true
+        const article = edit.config.sources.article !== "generate" || content.articleEdited === true
             ? (content.articleMarkdown ?? edit.config.provided.article)
             : undefined;
         if (article !== undefined &&

package/dist/slices/revisions/view.js

@@ -40,5 +40,7 @@ export function resolvedArticleMarkdown(deps, revision, outputs) {
         return readFileSync(outputPath(deps.paths, revision.projectId, article.output.path), "utf8");
     return revision.config.sources.article === "provide"
         ? (revision.config.provided.article ?? null)
-        : null;
+        : revision.config.sources.article === "off"
+            ? ""
+            : null;
 }

package/dist/slices/storage/backup-format.js

@@ -57,6 +57,7 @@ export const projectTables = [
     "project_uploads",
     // Since 2.5.0. Left out on purpose: plan_limit_waits and plan_limit_waiters (an account's
     // current wait, a lease of this install) and prompt_softening (a pending one-off request).
+    // Since 3.0.8, narration_retries is left out too: the tries of a run, not of the project.
     "review_verdicts",
     "provider_usage",
     "plan_limit_readings",

package/dist/tutorials/Play-Images.md

@@ -105,6 +105,22 @@ How the count is worked out:
 
 Turning it on also switches **Motion** (in the **Video and style** row) from **Zoom in and out** to **Mix of both**, so a long video pans and zooms by turns. A **Pan across** or **Still** you picked stays, and you can pick Zoom again.
 
+## Scenes from the article
+
+Without it, every image of a prompt is drawn from the same text, so three images of one prompt tend to show the same picture three times. **Scenes from the article** gives every image its own moment.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Scenes from the article** | Before the images are drawn, the project's AI model reads the article once and writes a short scene for each image. Scene 1 comes from the article's opening and the last from its ending, in the order the images are shown. Each image is drawn from its prompt with its scene added. One more AI call per run. | Off |
+
+Where the scene goes:
+
+- A prompt with `{{Scene}}` gets the scene there, for example a line `Scene: {{Scene}}` under the prompt's first sentence. `{{Scene}}` is never a field to fill in: Slopify writes it.
+- A prompt without it gets the scene as a line of its own after its first paragraph, so any prompt works unchanged.
+- With the switch off, a line holding `{{Scene}}` is left out and the prompt is drawn as it always was.
+
+The style, composition and everything else in the prompt stay as written; only the scene changes from image to image. The scenes are written once the article exists, and each image waits for them. Switching it on or off in **Edit project** remakes the images.
+
 ## How long each image stays on screen
 
 **Seconds per image** (1 to 600, default 15) is in the **Video and style** row, beside **Cuts**, **Zoom** and **Motion**. When cuts follow the narration, it is the target length and a cut waits for a sentence end. When images run out, they start again. See [Play Video and Style](Play-Video-and-Style).

package/dist/tutorials/Play-Title-and-Article.md

@@ -25,6 +25,7 @@ The Article row starts with a **Source** switch:
 | --- | --- | --- |
 | **Generate** (default) | The text model writes the article from the article prompt, in one call. | One text-model call |
 | **Provide** | Slopify narrates the text you paste, word for word. No text model writes one. | No text-model cost for the article |
+| **Off** | No article at all, for a project of images or a thumbnail made from prompts. Choosing it switches off what reads the article (research, narration, captions, the YouTube description, shorts, the PDF, Scenes from the article) and takes those sections out of Play; the thumbnail offers From prompt and Provide only. | Nothing |
 
 The article is what the narration reads and what the PDF lays out.
 

package/dist/updater/service.js

@@ -2,6 +2,7 @@ import { timingSafeEqual } from "node:crypto";
 import { setImmediate } from "node:timers";
 import { isStableVersion, isUpdateToken, newerVersion } from "./model.js";
 const waitCheckMs = 5_000;
+const idleLooksToInstall = 2;
 export function createUpdater(deps) {
     let latestVersion = null;
     let checkedAt = -Infinity;
@@ -66,13 +67,23 @@ export function createUpdater(deps) {
             deps.report(error);
         });
     }
-    // Looks again every few seconds and installs the moment no work is running.
+    // Looks again every few seconds and installs once no work is running. Idle has to hold for
+    // two looks in a row, so the moment between one step finishing and the next starting is
+    // never mistaken for the end of the work.
     function wait(version) {
         pending = version;
         status = "waiting";
         error = undefined;
+        let idleLooks = 0;
         stopWatching = every(() => {
-            if (status !== "waiting" || busyNow())
+            if (status !== "waiting")
+                return;
+            if (busyNow()) {
+                idleLooks = 0;
+                return;
+            }
+            idleLooks += 1;
+            if (idleLooks < idleLooksToInstall)
                 return;
             stopWatching?.();
             stopWatching = undefined;