@gentbajko/slopify 3.25.9 → 4.1.0

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

@@ -10,17 +10,21 @@ import { plainText } from "../article/plain.js";
 import { segmentMessages } from "../article/segments.js";
 import { splitEndMatter } from "../article/split.js";
 import { withEarlierEpisodes } from "../episodes/related.js";
+import { withoutSlopifyScene } from "../images/scenes.js";
 import { parsePronunciationGlossary, pronunciationRulesOf, } from "../narration/pronunciation.js";
 import { withSharedGlossary } from "../narration/shared-glossary.js";
 import { researchDocuments } from "../research/documents.js";
 import { plannerMessages, subAgentMessages } from "../research/planner.js";
 import { synthesisMessages } from "../research/synthesis.js";
+import { sampleArticleInstruction, sampleNarrationText } from "../template-studio/scope.js";
 import { thumbnailMessages } from "../thumbnail/by-llm.js";
 import { adaptationMessages } from "../voices/adaptation.js";
 import { attributionMessages } from "../voices/attribution.js";
 import { usesVoices } from "../voices/model.js";
 import { scriptMessages } from "../voices/script.js";
 import { describedText, describeFuture, describing } from "./recipe-describe.js";
+import { keywordDigest } from "./recipe-digest.js";
+import { articleMarkdownOf, chaptersProducer, filledPrompt, } from "./recipe-keywords.js";
 import { recipe, selectedReference, } from "./recipe-model.js";
 export function renderedPrompt(context, key) {
     const raw = context.content.promptTemplates[key];
@@ -28,6 +32,10 @@ export function renderedPrompt(context, key) {
         ? (context.config.rendered[key] ?? "")
         : render(raw, context.config.values);
 }
+// The prompt rendered with the person's values, then with the keywords Slopify fills.
+export function promptOf(context, key) {
+    return filledPrompt(context, key, renderedPrompt(context, key));
+}
 export function llmInput(context, messages, webSearch = false, documents) {
     const choice = context.config.llm;
     const model = context.catalogue?.llm.find((row) => row.provider === choice?.provider &&
@@ -66,7 +74,7 @@ export function selectedText(context, key, field) {
 export function textRecipes(context) {
     const { config, content, resolved } = context;
     const recipes = [];
-    const brief = { articlePrompt: renderedPrompt(context, "article"), values: config.values };
+    const brief = { articlePrompt: promptOf(context, "article").text, values: config.values };
     let research;
     if (config.sources.research === "generate") {
         const planner = recipe(context, "research:planner", "research", llmInput(context, plannerMessages(brief)));
@@ -113,7 +121,9 @@ export function textRecipes(context) {
     // The related earlier episodes go under the prompt only when the run carries them, so a
     // project made without them keeps its fingerprint. Either is written in the project's
     // language (`withLanguage`; English adds nothing).
-    const writtenPrompt = withEarlierEpisodes(brief.articlePrompt, config.earlierEpisodes);
+    // A template studio sample asks for its outline and first chapter only (`config.sample`);
+    // nothing is added for any other project, so its fingerprint stays as it was.
+    const writtenPrompt = withSampleScope(withEarlierEpisodes(brief.articlePrompt, config.earlierEpisodes), config.sample);
     const messages = withLanguage(voices !== undefined && writesScript
         ? scriptMessages(voices.format, voices.speakers, writtenPrompt, articleNotes)
         : articleMessages({
@@ -157,6 +167,18 @@ export function textRecipes(context) {
     const pictureText = content.picturesArticle === undefined
         ? articleText
         : plainText(splitEndMatter(content.picturesArticle).body);
+    // What the keywords in the later prompts are filled from: the article's chapters and, when a
+    // prompt uses one, the keyword digest written from it.
+    const digest = keywordDigest(context, { pictureText, article });
+    if (digest !== undefined)
+        recipes.push(digest.recipe);
+    const keywords = {
+        producers: [
+            chaptersProducer(articleMarkdown, article),
+            ...(digest === undefined ? [] : [digest.producer]),
+        ],
+    };
+    const keyed = { ...context, keywords };
     let script;
     if (voices !== undefined && scriptCheck !== undefined) {
         if (writesScript)
@@ -189,7 +211,10 @@ export function textRecipes(context) {
             };
         }
     }
-    let narrationText = articleText;
+    // A sample says only the narration's opening (`template-studio/scope.ts`).
+    let narrationText = config.sample === undefined || articleText === null
+        ? articleText
+        : sampleNarrationText(articleText);
     const descriptions = [];
     const cards = [];
     if (describing(context) && voices === undefined) {
@@ -201,7 +226,11 @@ export function textRecipes(context) {
             const described = describedText(context, endMatter.body, [article.key]);
             descriptions.push(...described.recipes);
             cards.push(...described.cards);
-            narrationText = described.spoken;
+            // A sample says only the opening of the described narration too.
+            narrationText =
+                config.sample === undefined || described.spoken === null
+                    ? described.spoken
+                    : sampleNarrationText(described.spoken);
         }
     }
     const glossary = glossaryOf(context, endMatter);
@@ -210,11 +239,20 @@ export function textRecipes(context) {
         const choice = config[category];
         if (choice === undefined || config.sources.audio !== "generate")
             continue;
-        const prompt = renderedPrompt(context, category);
+        const filled = promptOf(keyed, category);
+        const prompt = filled.text;
+        const waiting = filled.waits.length > 0;
         const key = `entry:${category}:text`;
         const input = choice.mode === "text"
-            ? { kind: "local", version: 1, operation: "entry-text", values: prompt }
-            : pictureText === null
+            ? waiting
+                ? {
+                    kind: "deferred",
+                    version: 1,
+                    operation: key,
+                    template: [prompt, ...filled.waits.map((one) => one.fingerprint)],
+                }
+                : { kind: "local", version: 1, operation: "entry-text", values: prompt }
+            : pictureText === null || waiting
                 ? {
                     kind: "deferred",
                     version: 1,
@@ -222,36 +260,43 @@ export function textRecipes(context) {
                     template: [
                         llmInputFingerprint(context, withLanguage(segmentMessages(prompt, config, ""), config.language)),
                         article.fingerprint,
+                        ...filled.waits.map((one) => one.fingerprint),
                     ],
                 }
                 : llmInput(context, withLanguage(segmentMessages(prompt, config, pictureText), config.language));
-        const value = recipe(context, key, "article", input, choice.mode === "llm" ? [article.key] : []);
+        const value = recipe(context, key, "article", input, choice.mode === "llm" ? [...new Set([article.key, ...filled.dependsOn])] : filled.dependsOn);
         recipes.push(value);
         entries[category] = {
             recipe: value,
-            text: choice.mode === "text" ? prompt : matchingText(context, value, "text"),
+            text: choice.mode === "text" ? (waiting ? null : prompt) : matchingText(context, value, "text"),
         };
     }
     if (config.sources.thumbnail === "prompt_by_llm") {
-        const prompt = renderedPrompt(context, "thumbnailPrompt");
+        const filled = promptOf(keyed, "thumbnailPrompt");
         const messages = thumbnailMessages({
-            instruction: prompt,
+            // The AI writes the picture itself, so a `Slopify_` scene keyword has nothing to fill.
+            instruction: withoutSlopifyScene(filled.text),
             title: subjectOf(config),
             values: config.values,
             format: config.format,
             article: pictureText ?? "",
         });
-        recipes.push(recipe(context, "thumbnail:prompt", "thumbnail", pictureText === null
+        recipes.push(recipe(context, "thumbnail:prompt", "thumbnail", pictureText === null || filled.waits.length > 0
             ? {
                 kind: "deferred",
                 version: 1,
                 operation: "thumbnail-prompt",
-                template: [llmInputFingerprint(context, messages), article.fingerprint],
+                template: [
+                    llmInputFingerprint(context, messages),
+                    article.fingerprint,
+                    ...filled.waits.map((one) => one.fingerprint),
+                ],
             }
-            : llmInput(context, messages), [article.key]));
+            : llmInput(context, messages), [...new Set([article.key, ...filled.dependsOn])]));
     }
     return {
         recipes,
+        keywords,
         articleText,
         pictureText,
         narrationText,
@@ -276,12 +321,6 @@ export function matchingText(context, value, field) {
         return null;
     return selectedText(context, value.key, field);
 }
-function articleMarkdownOf(context) {
-    const { config, content, resolved } = context;
-    return config.sources.article !== "generate" || content.articleEdited === true
-        ? (content.articleMarkdown ?? config.provided.article ?? "")
-        : resolved.articleMarkdown;
-}
 function glossaryOf(context, endMatter) {
     if (!usesPronunciationGlossary(context.config))
         return { ok: true, entries: [] };
@@ -301,3 +340,8 @@ function withShared(own, config) {
         return own;
     return { ...own, entries: withSharedGlossary(own.entries, config.sharedGlossary) };
 }
+function withSampleScope(prompt, sample) {
+    return sample === undefined || sample.fullScript
+        ? prompt
+        : `${prompt.trimEnd()}\n\n${sampleArticleInstruction}`;
+}

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

@@ -1,10 +1,16 @@
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { narrationPreparationFields, shortsFields, usesNarrationPreparation, usesReference, usesShorts, usesYoutubeDescription, videoEditFields, youtubeDescriptionFields, } from "../admission/rules.js";
 import { detectSlots, filledKeywords, render } from "../admission/substitute.js";
 import { imagesPerVideoMax } from "../images/scale.js";
+import { keywordUsesOf, placedProblems, textEntryProblems, usesFacts, } from "../keywords/rules.js";
 import { loudnessFields } from "../loudness/model.js";
 import { pauseFields } from "../narration/pauses-model.js";
-import { reviewFields } from "../reviews/rules.js";
+import { reviewPromptKey } from "../reviews/model.js";
+import { activeReviewStages, reviewFields } from "../reviews/rules.js";
+import { socialPlatforms } from "../social/model.js";
+import { usesPostPrompt } from "../social/rules.js";
 import { usesAnimation } from "../video/edit-settings.js";
+import { usesScriptPrompt } from "../voices/model.js";
 export function validateRecipeInputs(config, content) {
     const fields = [
         ...narrationPreparationFields(config),
@@ -20,14 +26,18 @@ export function validateRecipeInputs(config, content) {
         config.sources.thumbnail === "prompt_by_llm" ||
         usesNarrationPreparation(config) ||
         usesYoutubeDescription(config) ||
+        // A post written by a post prompt.
+        usesPostPrompt(config) ||
         usesShorts(config) ||
         (config.sources.audio === "generate" &&
-            (config.intro?.mode === "llm" || config.outro?.mode === "llm"));
+            (config.intro?.mode === "llm" || config.outro?.mode === "llm")) ||
+        // The keyword digest and the scene keywords are written by the text model too.
+        Object.keys(keywordUsesOf(keywordBodies(config, content))).some((cost) => cost === "digest" || cost === "scenes");
     if (llm && (!config.llm?.provider.trim() || !config.llm.model.trim()))
-        fields.push({ field: "llm", message: "Pick a text provider and model." });
+        fields.push({ field: "llm", message: "Choose a Service and a Model under Written by." });
     if (config.sources.audio === "generate") {
         if (!config.audio?.provider.trim() || !config.audio.model.trim())
-            fields.push({ field: "audio", message: "Pick a narration provider and model." });
+            fields.push({ field: "audio", message: "Choose a Service and a Model under Read by." });
         else if (!config.audio.voice.trim())
             fields.push({ field: "audio.voice", message: "Pick a narration voice." });
     }
@@ -39,7 +49,7 @@ export function validateRecipeInputs(config, content) {
         usesShorts(config) ||
         usesAnimation(config)) &&
         (!config.images?.provider.trim() || !config.images.model.trim()))
-        fields.push({ field: "images", message: "Pick an image provider and model." });
+        fields.push({ field: "images", message: "Choose a Service and a Model under Images by." });
     // 60, or more for a project that scales its images with the narration (`images/scale.ts`).
     const imagesMax = imagesPerVideoMax(config);
     if (content.imageOrder.length > imagesMax)
@@ -58,10 +68,60 @@ export function validateRecipeInputs(config, content) {
             field: `chunking.${chunking?.mode}`,
             message: "Use a whole number from 1 to 1,000,000.",
         });
+    if (usesReference(config) &&
+        config.reference?.source === "provide" &&
+        content.provided.reference === undefined)
+        fields.push({
+            field: "content.provided.reference",
+            message: "Upload the establishing image, choose From a prompt instead, or set Establishing image to Off.",
+        });
+    if (config.sources.images !== "off")
+        for (const key of content.imageOrder) {
+            const image = content.imageDefinitions[key];
+            if (image?.source === "provide" && image.assetId === null)
+                fields.push({
+                    field: `content.imageDefinitions.${key}.assetId`,
+                    message: "Choose an uploaded image.",
+                });
+        }
+    const prompts = checkedPrompts(config, content);
+    for (const prompt of prompts) {
+        if (!(prompt.raw === null ? prompt.literal : render(prompt.raw, config.values))?.trim())
+            fields.push({ field: prompt.field, message: "Enter a prompt or text." });
+        const text = prompt.raw ?? prompt.literal ?? "";
+        if (config.keywordFacts === undefined && usesFacts([text]))
+            fields.push({
+                field: prompt.field,
+                message: `This prompt uses a keyword Slopify fills from the channel and its videos, but this project has no keyword facts yet. Use Refresh keyword facts in ${editSettings.title}, then save again.`,
+            });
+        if (prompt.raw === null)
+            continue;
+        const slots = detectSlots(prompt.raw);
+        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 (!filledKeywords.includes(key) &&
+                (!Object.hasOwn(config.values, key) || !config.values[key]?.trim()))
+                fields.push({ field: `values.${key}`, message: "Enter a value for this keyword." });
+    }
+    fields.push(...placedProblems(keywordBodies(config, content), config.values));
+    for (const category of ["intro", "outro"]) {
+        const raw = content.promptTemplates[category] ?? config.rendered[category];
+        if (config.sources.audio === "generate" && config[category]?.mode === "text" && raw != null)
+            fields.push(...textEntryProblems(raw, category).map((problem) => ({
+                field: `rendered.${category}`,
+                message: problem.message,
+            })));
+    }
+    return fields;
+}
+// The prompts a version runs, each with the field a refusal marks and where it runs.
+function checkedPrompts(config, content) {
     const prompts = [];
     if (usesNarrationPreparation(config))
         prompts.push({
             field: "rendered.narration",
+            place: "narration",
             raw: content.promptTemplates.narration ?? null,
             literal: config.rendered.narration,
         });
@@ -71,6 +131,7 @@ export function validateRecipeInputs(config, content) {
         content.promptTemplates.description != null)
         prompts.push({
             field: "rendered.description",
+            place: "description",
             raw: content.promptTemplates.description,
             literal: config.rendered.description,
         });
@@ -82,6 +143,7 @@ export function validateRecipeInputs(config, content) {
         if (usesShorts(config) && name?.trim() && content.promptTemplates[key] != null)
             prompts.push({
                 field: `rendered.${key}`,
+                place: key === "shorts" ? "shorts" : "image",
                 raw: content.promptTemplates[key] ?? null,
                 literal: config.rendered[key],
             });
@@ -89,6 +151,7 @@ export function validateRecipeInputs(config, content) {
         (config.sources.research === "generate" && config.sources.article !== "provide"))
         prompts.push({
             field: "rendered.article",
+            place: usesScriptPrompt(config) ? "script" : "article",
             raw: content.promptTemplates.article ?? null,
             literal: config.rendered.article,
         });
@@ -96,12 +159,26 @@ export function validateRecipeInputs(config, content) {
         if (config.sources.audio === "generate" && config[category] !== undefined)
             prompts.push({
                 field: `rendered.${category}`,
+                place: category,
                 raw: content.promptTemplates[category] ?? null,
                 literal: config.rendered[category],
             });
+    // Each site's post prompt, only when one is picked: none picked uses the built-in one.
+    for (const platform of socialPlatforms) {
+        const choice = config.social?.[platform];
+        const key = `social.${platform}`;
+        if (choice?.text === "prompt" && choice.prompt?.trim() && content.promptTemplates[key] != null)
+            prompts.push({
+                field: `rendered.${key}`,
+                place: "post",
+                raw: content.promptTemplates[key] ?? null,
+                literal: config.rendered[key],
+            });
+    }
     if (config.sources.thumbnail === "from_prompt" || config.sources.thumbnail === "prompt_by_llm")
         prompts.push({
             field: "rendered.thumbnailPrompt",
+            place: "thumbnail",
             raw: content.promptTemplates.thumbnailPrompt ?? null,
             literal: config.rendered.thumbnailPrompt,
         });
@@ -109,43 +186,37 @@ export function validateRecipeInputs(config, content) {
     if (usesReference(config) && config.reference?.source === "prompt")
         prompts.push({
             field: "rendered.referencePrompt",
+            place: "image",
             raw: content.promptTemplates.referencePrompt ?? null,
             literal: config.rendered.referencePrompt,
         });
-    if (usesReference(config) &&
-        config.reference?.source === "provide" &&
-        content.provided.reference === undefined)
-        fields.push({
-            field: "content.provided.reference",
-            message: "Upload the establishing image, choose From a prompt instead, or set Establishing image to Off.",
-        });
     if (config.sources.images !== "off")
         for (const key of content.imageOrder) {
             const image = content.imageDefinitions[key];
             if (image?.source === "generate")
                 prompts.push({
                     field: `content.imageDefinitions.${key}.prompt`,
+                    place: "image",
                     raw: image.templateKey == null ? null : (content.promptTemplates[image.templateKey] ?? null),
                     literal: image.prompt ?? undefined,
                 });
-            else if (image?.source === "provide" && image.assetId === null)
-                fields.push({
-                    field: `content.imageDefinitions.${key}.assetId`,
-                    message: "Choose an uploaded image.",
-                });
         }
-    for (const prompt of prompts) {
-        if (!(prompt.raw === null ? prompt.literal : render(prompt.raw, config.values))?.trim())
-            fields.push({ field: prompt.field, message: "Enter a prompt or text." });
-        if (prompt.raw === null)
-            continue;
-        const slots = detectSlots(prompt.raw);
-        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 (!filledKeywords.includes(key) &&
-                (!Object.hasOwn(config.values, key) || !config.values[key]?.trim()))
-                fields.push({ field: `values.${key}`, message: "Enter a value for this keyword." });
-    }
-    return fields;
+    return prompts;
+}
+// The bodies a version runs with their places, for the keyword checks: its prompts and its
+// reviews' prompts.
+export function keywordBodies(config, content) {
+    return [
+        ...checkedPrompts(config, content).map((prompt) => ({
+            field: prompt.field,
+            place: prompt.place,
+            body: prompt.raw ?? prompt.literal ?? "",
+        })),
+        ...activeReviewStages(config).flatMap((stage) => {
+            const raw = content.promptTemplates[reviewPromptKey(stage)];
+            return raw == null || !config.reviews?.stages[stage]?.prompt?.trim()
+                ? []
+                : [{ field: `rendered.${reviewPromptKey(stage)}`, place: "review", body: raw }];
+        }),
+    ];
 }

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

@@ -1,3 +1,4 @@
+import { internalError } from "../../kernel/errors.js";
 import { thumbnailAspect } from "../../kernel/pipeline.js";
 import { subjectOf, thumbnailCountOf, thumbnailKey } from "../admission/model.js";
 import { usesShortMode } from "../admission/short-mode.js";
@@ -7,6 +8,7 @@ import { thumbnailOverrideOf } from "../revisions/model.js";
 import { usesAmbientBed } from "../video/ambient-bed.js";
 import { lookWait, withLooks } from "./recipe-appearance.js";
 import { castFor } from "./recipe-cast.js";
+import { fillPrompt } from "./recipe-keywords.js";
 import { noMaster } from "./recipe-loudness.js";
 import { recipe, resourceIdentity, } from "./recipe-model.js";
 import { castField, imageChoice } from "./recipe-reference.js";
@@ -23,30 +25,36 @@ master = noMaster,
 // Each image's own scene, for the images whose prompt asks for one (`recipe-scenes.ts`).
 scenes, 
 // How the subject and characters look, for prompts with `{{Appearance}}`.
-appearance) {
+appearance, 
+// The keywords Slopify fills in an image prompt (`recipe-keywords.ts`).
+fill = unfilled) {
     const recipes = [];
     const imageKeys = config.sources.images === "off" ? [] : content.imageOrder;
     for (const key of imageKeys) {
         const image = content.imageDefinitions[key];
         if (image === undefined)
-            throw new Error("Slopify hit an internal error (one of the project's images has no saved settings). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("one of the project's images has no saved settings"));
         const raw = image.templateKey === undefined || image.templateKey === null
             ? undefined
             : content.promptTemplates[image.templateKey];
         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, appearance));
+            recipes.push(sceneImage(config, content, key, raw ?? image.prompt ?? "", scenes, at, reference, appearance, fill));
             continue;
         }
         // With Scenes from the article off, a prompt's `{{Scene}}` line is left out.
-        const written = raw === undefined || raw === null
+        const base = raw === undefined || raw === null
             ? image.prompt === null || image.prompt === undefined
                 ? image.prompt
                 : withoutScene(image.prompt)
             : render(withoutScene(raw), config.values);
-        const prompt = written === null || written === undefined || image.source !== "generate"
+        const keyed = base === null || base === undefined || image.source !== "generate" ? undefined : fill(base);
+        const written = keyed?.text ?? base;
+        const prompt = written === null || written === undefined || keyed === undefined
             ? written
-            : withLooks(written, appearance);
+            : keyed.waits.length > 0
+                ? null
+                : withLooks(written, appearance);
         // Waiting for the looks: the same wait an image with a scene has, on the lookup instead.
         if (prompt === null && written !== null && written !== undefined) {
             const wait = lookWait(written, appearance);
@@ -62,8 +70,13 @@ appearance) {
                     config.format,
                     ...(config.images?.thinking === undefined ? [] : [config.images.thinking]),
                     ...(reference === undefined ? [] : [reference.input.fingerprint]),
+                    ...(keyed?.waits ?? []).map((one) => one.fingerprint),
                 ],
-            }, [...wait.dependsOn, ...(reference === undefined ? [] : [reference.key])]));
+            }, [
+                ...wait.dependsOn,
+                ...(reference === undefined ? [] : [reference.key]),
+                ...(keyed?.waits ?? []).map((one) => one.key),
+            ]));
             continue;
         }
         recipes.push(recipe({ content }, `image:${key}`, "images", image.source === "provide"
@@ -76,7 +89,10 @@ appearance) {
                 prompt: prompt ?? "",
                 ...(reference === undefined ? {} : { reference: reference.input }),
                 ...castField(castFor(config, prompt)),
-            }, image.source === "provide" || reference === undefined ? [] : [reference.key], { unresolved: image.source === "provide" ? image.assetId === null : !prompt?.trim() }));
+            }, [
+            ...(image.source === "provide" || reference === undefined ? [] : [reference.key]),
+            ...(keyed?.dependsOn ?? []),
+        ], { unresolved: image.source === "provide" ? image.assetId === null : !prompt?.trim() }));
     }
     if (config.sources.video !== "off") {
         const short = usesShortMode(config);
@@ -152,11 +168,12 @@ appearance) {
 // 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, appearance) {
+function sceneImage(config, content, key, body, scenes, at, reference, appearance, fill) {
     const scene = scenes.scenes?.[at];
-    const prompt = scene === undefined
+    const keyed = fill(render(body, config.values));
+    const prompt = scene === undefined || keyed.waits.length > 0
         ? undefined
-        : (withLooks(withScene(render(body, config.values), scene), appearance, scene) ?? undefined);
+        : (withLooks(withScene(keyed.text, scene, { legacy: scenes.legacy, ...scenes.details?.[at] }), appearance, scene) ?? undefined);
     const wait = lookWait(body, appearance);
     return recipe({ content }, `image:${key}`, "images", prompt === undefined
         ? {
@@ -172,6 +189,7 @@ function sceneImage(config, content, key, body, scenes, at, reference, appearanc
                 ...(config.images?.thinking === undefined ? [] : [config.images.thinking]),
                 ...(reference === undefined ? [] : [reference.input.fingerprint]),
                 ...wait.template,
+                ...keyed.waits.map((one) => one.fingerprint),
             ],
         }
         : {
@@ -182,7 +200,15 @@ function sceneImage(config, content, key, body, scenes, at, reference, appearanc
             prompt,
             ...(reference === undefined ? {} : { reference: reference.input }),
             ...castField(castFor(config, prompt)),
-        }, [scenes.recipe.key, ...wait.dependsOn, ...(reference === undefined ? [] : [reference.key])]);
+        }, [
+        scenes.recipe.key,
+        ...wait.dependsOn,
+        ...(reference === undefined ? [] : [reference.key]),
+        ...keyed.dependsOn,
+    ]);
+}
+function unfilled(text) {
+    return { text, waits: [], dependsOn: [] };
 }
 // 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.
@@ -219,9 +245,17 @@ appearance) {
             }, [], { unresolved: content.provided.thumbnail === undefined }),
         ];
     const promptRecipe = textRecipes.find((value) => value.key === "thumbnail:prompt");
-    const written = config.sources.thumbnail === "prompt_by_llm" && promptRecipe !== undefined
-        ? matchingText(context, promptRecipe, "prompt")
-        : renderedPrompt(context, "thumbnailPrompt");
+    // A prompt the AI wrote is sent as it wrote it; a Library prompt has its keywords filled.
+    const keyed = config.sources.thumbnail === "prompt_by_llm" && promptRecipe !== undefined
+        ? undefined
+        : fillPrompt(context, renderedPrompt(context, "thumbnailPrompt"), "thumbnail");
+    const written = keyed === undefined
+        ? promptRecipe === undefined
+            ? null
+            : matchingText(context, promptRecipe, "prompt")
+        : keyed.waits.length > 0
+            ? null
+            : keyed.text;
     const sceneFor = (variant) => scenes?.scenes?.[variant - 1];
     const withScenes = scenes !== undefined;
     const variants = Array.from({ length: thumbnailCountOf(config) }, (_, index) => index + 1);
@@ -239,7 +273,10 @@ appearance) {
             : withScenes
                 ? scene === undefined
                     ? null
-                    : withScene(written, scene)
+                    : withScene(written, scene, {
+                        legacy: scenes.legacy,
+                        ...scenes.details?.[variant - 1],
+                    })
                 : withoutScene(written);
         // A thumbnail stands for the subject, so it always has the subject's look.
         const prompt = sceneFilled === null
@@ -263,6 +300,7 @@ appearance) {
                     ...(variant === 1 ? [] : [["thumbnail-variant", variant]]),
                     ...(withScenes ? [["thumbnail-scene", scenes.recipe.fingerprint]] : []),
                     ...wait.template,
+                    ...(keyed?.waits ?? []).map((one) => one.fingerprint),
                 ],
             }
             : {
@@ -279,6 +317,7 @@ appearance) {
             ...(reference === undefined ? [] : [reference.key]),
             ...(withScenes ? [scenes.recipe.key] : []),
             ...wait.dependsOn,
+            ...(keyed?.dependsOn ?? []),
         ]);
     });
 }

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

@@ -1,4 +1,5 @@
 import { aliasMatches, applyAliases } from "../../kernel/ports/narration-aliases.js";
+import { createRows, editSettings } from "../../kernel/ports/settings-places.js";
 import { splitText } from "../../kernel/ports/text.js";
 import { narrationAliasesOf, usesNarrationPreparation } from "../admission/rules.js";
 import { aliasSpans, withAliasSpans } from "../narration/aliases.js";
@@ -83,7 +84,7 @@ export function voiceBodyRecipes(context, voices, script, glossary) {
         parts.push(future());
     }
     else if (parsed !== undefined && !parsed.ok) {
-        parts.push(refused(context, "audio:body:turn:1", script.dependsOn, `The script can't be narrated: ${parsed.reason} Fix it in Edit project → Article, then Try again.`));
+        parts.push(refused(context, "audio:body:turn:1", script.dependsOn, `The script can't be narrated: ${parsed.reason} Fix it in ${editSettings.article}, then Try again.`));
     }
     else if (pending) {
         parts.push(future());
@@ -251,7 +252,7 @@ function speakerGlossary(context, speaker, glossary) {
     if (!own.ok)
         return {
             ok: false,
-            reason: `${speaker.name.trim()}'s pronunciations can't be used: ${own.reason.replace("Edit the glossary or turn off Use Pronunciation Glossary.", "Fix them under Speakers (Play → Narration, or Edit project → Providers).")}`,
+            reason: `${speaker.name.trim()}'s pronunciations can't be used: ${own.reason.replace("Edit the glossary or turn off Use Pronunciation Glossary.", `Fix them under Speakers (${createRows.narration}, or ${editSettings.narration}).`)}`,
         };
     const run = context.config.audio?.usePronunciationGlossary === true && glossary?.ok === true
         ? glossary.entries