@gentbajko/slopify 2.5.0 → 3.0.0

package/dist/slices/project-templates/one-off.js

@@ -0,0 +1,26 @@
+import { detectSlots } from "../admission/substitute.js";
+// A template keeps the settings, never what was typed for one video. A keyword the project
+// title names ({{Topic}} in "D&D Lore: {{Topic}}") is the video's topic: it changes with every
+// video, so a template stores it empty. Every other keyword ({{minWords}}, {{style}}) is a
+// setting and keeps its value.
+export function topicKeywords(title) {
+    return detectSlots(title).names;
+}
+// The values a template stores: the topic keywords emptied, the rest as they were.
+export function templateValues(title, values) {
+    const topics = topicKeywords(title);
+    // Prototype-free, as `slices/admission/rules.ts` explains: a keyword can be "__proto__".
+    const kept = Object.create(null);
+    for (const [name, value] of Object.entries(values))
+        kept[name] = topics.includes(name) ? "" : value;
+    return kept;
+}
+// The Play document a template is saved from, without the one-off values: the topic keywords
+// emptied and the queued extra videos dropped (each is a topic of its own).
+export function templateDocument(document) {
+    return {
+        ...document,
+        form: { ...document.form, values: templateValues(document.form.title, document.form.values) },
+        variants: [],
+    };
+}

package/dist/slices/project-templates/repo.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { projectTemplateSchema } from "./schema.js";
-const select = `SELECT t.id,r.version,r.name,t.created_at AS createdAt,r.created_at AS updatedAt,r.document_json AS document FROM project_templates t JOIN project_template_revisions r ON r.template_id=t.id`;
+// A template in the trash (`deleted_at` set, Settings → Trash) is invisible to every read here.
+const select = `SELECT t.id,r.version,r.name,t.created_at AS createdAt,r.created_at AS updatedAt,r.document_json AS document FROM project_templates t JOIN project_template_revisions r ON r.template_id=t.id AND t.deleted_at IS NULL`;
 const templateSummarySchema = z
     .object({
     id: z.uuid(),

package/dist/slices/project-templates/service.js

@@ -1,12 +1,17 @@
 import { z } from "zod";
 import { transact } from "../../kernel/db/tx.js";
+import { resolveChannelId, templateChannels } from "../channels/repo.js";
 import { requestHash } from "../play-drafts/repo.js";
 import { createDraft, readDraft } from "../play-drafts/service.js";
 import { insertTemplateRevision, templateById, templateSummaries } from "./repo.js";
 import { templateCreateSchema, templateDeleteSchema, templateInstantiateSchema, templateUpdateSchema, } from "./schema.js";
 import { freshTemplateDraft, templateSetup } from "./setup.js";
 export function listTemplates(deps) {
-    return templateSummaries(deps.db);
+    const channels = templateChannels(deps.db);
+    return templateSummaries(deps.db).map((template) => ({
+        ...template,
+        channelId: channels.get(template.id) ?? resolveChannelId(deps.db, undefined),
+    }));
 }
 export function readTemplate(deps, id, version) {
     if (!z.uuid().safeParse(id).success ||
@@ -39,9 +44,11 @@ export function createTemplate(deps, input) {
             createdAt: at,
             updatedAt: at,
         };
+        // The channel is the template's, not part of its setup: moving it (Channels)
+        // makes no new version, and a draft made from it asks the template (`draftChannel`).
         deps.db
-            .prepare("INSERT INTO project_templates(id,head_version,creation_hash,created_at) VALUES (?,1,?,?)")
-            .run(id, hash, at);
+            .prepare("INSERT INTO project_templates(id,head_version,creation_hash,created_at,channel_id) VALUES (?,1,?,?,?)")
+            .run(id, hash, at, resolveChannelId(deps.db, document.channelId));
         insertTemplateRevision(deps.db, value);
         return { ok: true, value };
     });
@@ -96,7 +103,11 @@ export function deleteTemplate(deps, input) {
             .prepare("SELECT 1 FROM schedules WHERE template_id=? AND deleted_at IS NULL LIMIT 1")
             .get(parsed.data.id))
             return { ok: false, reason: "referenced-by-schedule" };
-        deps.db.prepare("DELETE FROM project_templates WHERE id=?").run(parsed.data.id);
+        // Into the trash (Settings → Trash), not gone: `slices/trash` restores it or removes it
+        // for good. A schedule that is itself in the trash may still name it.
+        deps.db
+            .prepare("UPDATE project_templates SET deleted_at=? WHERE id=? AND deleted_at IS NULL")
+            .run(deps.clock.now().toISOString(), parsed.data.id);
         return { ok: true, value: { deleted: true } };
     });
 }

package/dist/slices/project-templates/setup.js

@@ -1,15 +1,26 @@
+import { templateChannelId } from "../channels/repo.js";
 import { snapshotEntry, snapshotPrompt } from "../library/snapshot.js";
+import { templateDocument } from "./one-off.js";
 export function templateSetup(deps, input) {
     const prompts = [];
     const entries = [];
     const choices = [
-        { kind: "article", name: input.form.articlePrompt },
+        {
+            kind: input.form.voices?.source === "script" && input.form.sources.audio === "generate"
+                ? "script"
+                : "article",
+            name: input.form.articlePrompt,
+        },
         { kind: "narration", name: input.form.narrationPrompt ?? "" },
         { kind: "description", name: input.form.descriptionPrompt ?? "" },
         ...input.form.imagePrompts.map((row) => ({ kind: "image", name: row.name })),
         { kind: "thumbnail", name: input.form.thumbnailPrompt },
         { kind: "shorts", name: input.form.shorts?.prompt ?? "" },
         { kind: "image", name: input.form.shorts?.imagePrompt ?? "" },
+        ...Object.values(input.form.reviews?.stages ?? {}).map((stage) => ({
+            kind: "review",
+            name: stage.mode === "off" ? "" : stage.prompt,
+        })),
         {
             kind: "image",
             name: input.form.reference?.source === "prompt" ? input.form.reference.prompt : "",
@@ -32,7 +43,8 @@ export function templateSetup(deps, input) {
             return { ok: false, reason: "missing-prompt" };
         entries.push(row);
     }
-    const { templateSource: _source, ...document } = input;
+    // Only the settings are kept: the topic typed for one video is left empty (`one-off.ts`).
+    const { templateSource: _source, channelId: _channel, ...document } = templateDocument(input);
     return {
         ok: true,
         value: { ...document, fontUpload: null, librarySnapshot: { prompts, entries } },
@@ -49,6 +61,7 @@ export function freshTemplateDraft(deps, document, source) {
         section: "content",
         fontUpload: null,
         templateSource: source,
+        channelId: templateChannelId(deps.db, source.id),
         variants: document.variants.map((variant) => ({ ...variant, id: deps.uuid() })),
         form: {
             ...document.form,
@@ -64,6 +77,9 @@ export function freshTemplateDraft(deps, document, source) {
                 ...(provided.shortsMusic === undefined
                     ? {}
                     : { shortsMusic: provided.shortsMusic === null ? null : fresh(provided.shortsMusic) }),
+                ...(provided.ambientBed === undefined
+                    ? {}
+                    : { ambientBed: provided.ambientBed === null ? null : fresh(provided.ambientBed) }),
             },
         },
     };

package/dist/slices/rebuild/admission-repo.js

@@ -72,7 +72,7 @@ export function admitPreview(deps, input) {
                 workIds.push(String(existing.id));
                 if (existing.state !== "running") {
                     deps.db
-                        .prepare("UPDATE revision_work SET state='pending',dispatch_state='allowed',failure_reason=NULL WHERE id=?")
+                        .prepare("UPDATE revision_work SET state='pending',dispatch_state='allowed',failure_reason=NULL,failure_kind=NULL,retry_at=NULL,auto_retries=0 WHERE id=?")
                         .run(String(existing.id));
                     deps.db
                         .prepare(`UPDATE revision_work_pieces SET state='pending',dispatch_state='allowed'

package/dist/slices/rebuild/model.js

@@ -30,6 +30,9 @@ const costRowSchema = z.object({
     low: z.number().finite().nonnegative().nullable(),
     high: z.number().finite().nonnegative().nullable(),
     detail: z.string(),
+    onPlan: z.boolean().optional(),
+    apiLow: z.number().finite().nonnegative().nullable().optional(),
+    apiHigh: z.number().finite().nonnegative().nullable().optional(),
 });
 const costEstimateSchema = z.object({
     currency: z.literal("USD"),
@@ -37,6 +40,9 @@ const costEstimateSchema = z.object({
     low: z.number().finite().nonnegative(),
     high: z.number().finite().nonnegative(),
     unknown: z.number().int().nonnegative(),
+    apiLow: z.number().finite().nonnegative().optional(),
+    apiHigh: z.number().finite().nonnegative().optional(),
+    apiUnknown: z.number().int().nonnegative().optional(),
     expectedWords: z.number().finite().nonnegative(),
     catalogueDate: z.string().nullable(),
     assumptions: z.array(z.string()),

package/dist/slices/rebuild/preview-details.js

@@ -1,9 +1,13 @@
 import { stageKinds } from "../../kernel/pipeline.js";
+import { languageInfo } from "../../kernel/ports/languages.js";
 import { sourceOf } from "../admission/model.js";
 import { motionStyleLabels } from "../admission/rules.js";
 import { documentThemeLabel } from "../document/model.js";
+import { loudnessLabel } from "../loudness/model.js";
+import { reviewModeLabels, reviewModeOf, reviewStageLabels, reviewStages, } from "../reviews/model.js";
 import { getRevisionView } from "../revisions/view.js";
 import { musicVolumeOf, shortsSpeedOf } from "../shorts/model.js";
+import { ambientBedLabels } from "../video/ambient-bed.js";
 import { videoEditOf, videoEditRows } from "../video/edit-settings.js";
 export function previewDetails(deps, view, allRecipes, selected) {
     const parent = view.revision.parentId === null
@@ -48,9 +52,11 @@ export function previewDetails(deps, view, allRecipes, selected) {
                     key: row.key,
                     label: row.key === "reference:image"
                         ? "Establishing image"
-                        : index < 0
-                            ? "Thumbnail image"
-                            : `Image ${index + 1}`,
+                        : row.key.startsWith("thumbnail:image:")
+                            ? `Thumbnail image ${row.key.slice("thumbnail:image:".length)}`
+                            : index < 0
+                                ? "Thumbnail image"
+                                : `Image ${index + 1}`,
                     text: input.prompt,
                     settings: [
                         input.provider,
@@ -95,6 +101,9 @@ export function previewDetails(deps, view, allRecipes, selected) {
     });
     return { inputChanges: parent === undefined ? [] : inputChanges(parent, view), requests };
 }
+function loudnessSummary(value) {
+    return `Video ${loudnessLabel(value.videoLufs, "video")}; audio files ${loudnessLabel(value.audioFilesLufs, "audioFiles")}`;
+}
 function narrationIdentity(row) {
     if (row.input.kind === "tts")
         return { logicalKey: row.input.logicalKey, segment: row.input.segment };
@@ -138,9 +147,17 @@ function inputChanges(parent, view) {
         add(`${name} model`, a?.model, b?.model);
         add(`${name} thinking`, a?.thinking, b?.thinking);
     }
+    add("Language", languageInfo(before.language).name, languageInfo(after.language).name);
     add("Narration voice", before.audio?.voice, after.audio?.voice);
     add("Narration Preparation", before.narrationPrompt, after.narrationPrompt);
     add("Narration chunking", before.chunking, after.chunking);
+    add("Narration aliases", before.audio?.useNarrationAliases === true ? aliasLines(before.narrationAliases) : "Off", after.audio?.useNarrationAliases === true ? aliasLines(after.narrationAliases) : "Off");
+    const described = (audio) => audio?.describeFigures !== true ? "Off" : audio.skipCode === true ? "On, code left out" : "On";
+    add("Describe tables and figures", described(before.audio), described(after.audio));
+    add("Show tables and figures on screen", before.showFigures === true ? "On" : "Off", after.showFigures === true ? "On" : "Off");
+    add("Pause between sentences (seconds)", before.sentencePauseSeconds ?? 0, after.sentencePauseSeconds ?? 0);
+    add("Pause between paragraphs (seconds)", before.paragraphPauseSeconds ?? 0, after.paragraphPauseSeconds ?? 0);
+    add("Level the volume", before.loudness === undefined ? "Off" : loudnessSummary(before.loudness), after.loudness === undefined ? "Off" : loudnessSummary(after.loudness));
     add("YouTube description", before.youtubeDescription === true ? "On" : "Off", after.youtubeDescription === true ? "On" : "Off");
     add("Description prompt", before.descriptionPrompt, after.descriptionPrompt);
     add("Shorts", before.shorts?.enabled === true ? "On" : "Off", after.shorts?.enabled === true ? "On" : "Off");
@@ -150,8 +167,16 @@ function inputChanges(parent, view) {
         : `${String(before.shorts.minSeconds)}-${String(before.shorts.maxSeconds)}`, after.shorts === undefined
         ? undefined
         : `${String(after.shorts.minSeconds)}-${String(after.shorts.maxSeconds)}`);
+    add("Thumbnails", before.thumbnailCount === 3 ? "3" : "1", after.thumbnailCount === 3 ? "3" : "1");
     add("Shorts prompt", before.shorts?.prompt, after.shorts?.prompt);
     add("Shorts image prompt", before.shorts?.imagePrompt, after.shorts?.imagePrompt);
+    add("Reviewer provider", before.reviews?.provider, after.reviews?.provider);
+    add("Reviewer model", before.reviews?.model, after.reviews?.model);
+    add("Reviewer redos", before.reviews?.retries, after.reviews?.retries);
+    for (const stage of reviewStages) {
+        add(`${reviewStageLabels[stage]} review`, reviewModeLabels[reviewModeOf(before.reviews, stage)], reviewModeLabels[reviewModeOf(after.reviews, stage)]);
+        add(`${reviewStageLabels[stage]} review prompt`, before.reviews?.stages[stage]?.prompt, after.reviews?.stages[stage]?.prompt);
+    }
     add("Establishing image", referenceLabel(before), referenceLabel(after));
     add("Thumbnail drawn from the establishing image", before.reference === undefined
         ? undefined
@@ -170,6 +195,7 @@ function inputChanges(parent, view) {
     add("Short ranges set by hand", old.shortsRanges, next.shortsRanges);
     add("Silence gap (seconds)", before.silenceGapSeconds, after.silenceGapSeconds);
     add("Silence at start and end (seconds)", before.edgeSilenceSeconds, after.edgeSilenceSeconds);
+    add("Ambient sound", ambientBedLabel(before, old), ambientBedLabel(after, next));
     add("Seconds per image", before.imageSeconds, after.imageSeconds);
     add("Zoom (%)", before.zoomPercent, after.zoomPercent);
     add("Motion", motionStyleLabels[before.motionStyle], motionStyleLabels[after.motionStyle]);
@@ -207,9 +233,26 @@ function inputChanges(parent, view) {
     add("Manual captions", old.subtitleCues?.cues, next.subtitleCues?.cues);
     return changes;
 }
+// The ambient bed in one line; undefined without one, so a project that never had one lists
+// no change.
+function ambientBedLabel(config, content) {
+    const bed = config.ambientBed;
+    if (bed === undefined)
+        return undefined;
+    const file = bed.source === "upload" && content.ambientBed !== undefined ? " (uploaded file)" : "";
+    return `${ambientBedLabels[bed.source]}${file}, ${String(bed.levelDb)} dB, fade in ${String(bed.fadeInSeconds)} s, tail ${String(bed.tailSeconds)} s`;
+}
 function referenceLabel(config) {
     const reference = config.reference;
     if (reference === undefined)
         return "Off";
     return reference.source === "provide" ? "Uploaded image" : `Prompt: ${reference.prompt ?? ""}`;
 }
+// One line per alias, as the Library shows it, so a changed alias reads as a changed line.
+function aliasLines(aliases) {
+    if (aliases === undefined || aliases.length === 0)
+        return "On, no aliases copied";
+    return aliases
+        .map((alias) => `${alias.written} → ${alias.spoken}${alias.wholeWord ? "" : " (inside words too)"}${alias.caseSensitive ? " (match case)" : ""}`)
+        .join("\n");
+}

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

@@ -168,13 +168,20 @@ export function planPreview(deps, view, catalogue, selection, id) {
         providedReuseRequired: execution.reviews.map((row) => row.key),
         costs: estimateRequests(work.flatMap((row) => priceRecipes(row.inflight || !requiresNewSubmission(deps, view.revision.id, row.key, row.fingerprint)
             ? { ...row, disposition: "reuse" }
-            : row, recipes.find((recipe) => recipe.key === row.key))), snapshot),
+            : row, recipes.find((recipe) => recipe.key === row.key), view.revision.config)), 
+        // The whole catalogue, as Play's review prices with: a CLI row's API figure is read
+        // from the API models, which the execution snapshot leaves out.
+        catalogue),
         wholeRequestNotice: plan.wholeRequestNotice,
-        warnings: submissions.some((row) => row.uncertain)
-            ? [
-                "A previous request was submitted without a saved result or resumable job. Retrying may charge you again.",
-            ]
-            : [],
+        warnings: [
+            ...(submissions.some((row) => row.uncertain)
+                ? [
+                    "A previous request was submitted without a saved result or resumable job. Retrying may charge you again.",
+                ]
+                : []),
+            ...(plan.glossaryNotice ? [plan.glossaryNotice] : []),
+            ...(plan.speakerPronunciationNotice ? [plan.speakerPronunciationNotice] : []),
+        ],
     };
     return { ok: true, value: { preview, execution } };
 }

package/dist/slices/rebuild/recipe-audio-parts.js

@@ -1,4 +1,6 @@
-import { usesNarrationPreparation, usesPronunciationGlossary } from "../admission/rules.js";
+import { aliasMatches } from "../../kernel/ports/narration-aliases.js";
+import { narrationAliasesOf, usesNarrationPreparation, usesPronunciationGlossary, } from "../admission/rules.js";
+import { aliasSpans, withAliasSpans } from "../narration/aliases.js";
 import { narrationRegenerationToken, normalizeNarrationText, planNarration, } from "../narration/plan.js";
 import { pronunciationSpans } from "../narration/pronunciation.js";
 import { prepareRequests } from "../narration/steering.js";
@@ -20,18 +22,20 @@ export function narrationParts(context, logicalKey, originalText, segment, depen
     if (!glossary.ok)
         return [refusedPart(context, logicalKey, dependsOn, glossary.reason)];
     const logicalText = normalizeNarrationText(override?.kind === "text" ? override.text : originalText);
-    const spans = pronunciationSpans(logicalText, glossary.entries);
+    // Aliases first: where one applies, the glossary does not.
+    const aliases = narrationAliasesOf(context.config);
+    const matches = aliasMatches(logicalText, aliases);
+    const spans = withAliasSpans(pronunciationSpans(logicalText, glossary.entries), aliasSpans(logicalText, aliases));
     const wholeRequest = segment !== "body" || (context.config.chunking?.mode ?? "whole") === "whole";
     const choice = context.config.audio;
-    const model = context.catalogue?.tts.find((row) => row.provider === choice?.provider &&
-        row.id === choice.model &&
-        row.enabled &&
-        !row.deprecated);
+    // A retired model's character limit is still its limit: the automatic catalogue check marks
+    // models deprecated, and that alone must not re-split narration and outdate a project.
+    const model = context.catalogue?.tts.find((row) => row.provider === choice?.provider && row.id === choice.model && row.enabled);
     const logicalLimit = Math.max(2, logicalText.length +
         spans.reduce((sum, span) => sum + Math.max(0, span.text.length - (span.end - span.start)), 0));
     const maxCharacters = model?.tts.maxCharacters ?? logicalLimit;
     if (usesNarrationPreparation(context.config)) {
-        const prepared = preparationForGroup(context, logicalKey, logicalText, segment, dependsOn, maxCharacters, spans);
+        const prepared = preparationForGroup(context, logicalKey, logicalText, segment, dependsOn, maxCharacters, spans, matches);
         preparations.push(prepared.preparation);
         if (prepared.refusal !== null)
             return [refusedPart(context, logicalKey, [prepared.preparation.key], prepared.refusal)];
@@ -135,6 +139,35 @@ export function pronunciationFutureValues(context, glossary, article, logicalKey
             ],
         ];
 }
+// What aliases add to a narration recipe that can't be worked out yet. With none copied into
+// the project (every project from before aliases), nothing: its fingerprints stay as they were.
+export function aliasFutureValues(context, logicalKey, source) {
+    const aliases = narrationAliasesOf(context.config);
+    if (aliases.length === 0)
+        return [];
+    const override = context.content.narrationOverrides[logicalKey];
+    if (override?.kind === "asset")
+        return [];
+    // Unknown generated text may contain any alias.
+    if (source === null)
+        return [
+            [
+                "narration-aliases-v1",
+                aliases.map((alias) => [alias.written, alias.spoken, alias.wholeWord, alias.caseSensitive]),
+            ],
+        ];
+    const clean = normalizeNarrationText(override?.kind === "text" ? override.text : source);
+    const matches = aliasMatches(clean, aliases);
+    return matches.length === 0
+        ? []
+        : [
+            [
+                "narration-aliases-v1",
+                logicalKey,
+                matches.map((match) => [match.start, match.end, match.spoken]),
+            ],
+        ];
+}
 export function voiceValues(context) {
     return [
         context.config.audio?.provider ?? null,

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

@@ -4,25 +4,37 @@ import { defaultChunking } from "../narration/chunk.js";
 import { concatArgs } from "../narration/concat.js";
 import { normalizeNarrationText } from "../narration/plan.js";
 import { pronunciationChunks } from "../narration/pronunciation-chunks.js";
-import { narrationParts, pronunciationFutureValues, voiceValues } from "./recipe-audio-parts.js";
+import { aliasFutureValues, narrationParts, pronunciationFutureValues, voiceValues, } from "./recipe-audio-parts.js";
+import { levelRecipe } from "./recipe-loudness.js";
 import { recipe, resourceIdentity, selectedReference, } from "./recipe-model.js";
 import { narrationFileRecipe } from "./recipe-narration-text.js";
+import { pauseValues } from "./recipe-pauses.js";
 import { preparationFuture, preparationTemplate } from "./recipe-preparation.js";
+import { voiceBodyRecipes } from "./recipe-voices.js";
 export function bodyNarrationGroups(context, text) {
-    return text.articleText === null
+    return text.narrationText === null
         ? []
-        : pronunciationChunks(normalizeNarrationText(text.articleText), context.config.chunking ?? defaultChunking, usesPronunciationGlossary(context.config) && text.glossary?.ok ? text.glossary.entries : [], new Set(Object.keys(context.content.narrationOverrides)), context.content.narrationSources);
+        : pronunciationChunks(normalizeNarrationText(text.narrationText), context.config.chunking ?? defaultChunking, usesPronunciationGlossary(context.config) && text.glossary?.ok ? text.glossary.entries : [], new Set(Object.keys(context.content.narrationOverrides)), context.content.narrationSources);
 }
 export function audioRecipes(context, text) {
     const { config, content } = context;
     const recipes = [];
     if (config.sources.audio === "off")
-        return { recipes, mediaFingerprint: null, timeline: [], keys: [] };
+        return { recipes, mediaFingerprint: null, timeline: [], keys: [], levels: [] };
     const prepare = usesNarrationPreparation(config);
     const pronounce = usesPronunciationGlossary(config);
     const narrationFiles = prepare || pronounce;
     let body;
-    let bodyTranscript = text.articleText ?? text.article.fingerprint;
+    let bodyTranscript = text.narrationText ??
+        (text.descriptions.length === 0
+            ? text.article.fingerprint
+            : [
+                "described-v1",
+                text.article.fingerprint,
+                text.descriptions.map((row) => row.fingerprint),
+            ]);
+    let sections;
+    let cards = [];
     if (config.sources.audio === "provide") {
         body = recipe(context, "audio:provided", "audio", {
             kind: "provided",
@@ -32,18 +44,31 @@ export function audioRecipes(context, text) {
         }, [text.article.key], { unresolved: content.provided.audio === undefined });
         recipes.push(body);
     }
+    else if (text.script !== undefined && config.voices !== undefined) {
+        const voiced = voiceBodyRecipes(context, config.voices, text.script, text.glossary);
+        recipes.push(...voiced.preparations, ...voiced.cards, ...voiced.parts);
+        cards = voiced.cards;
+        if (narrationFiles)
+            recipes.push(narrationFileRecipe(context, "body", voiced.parts));
+        recipes.push(voiced.body);
+        body = voiced.body;
+        bodyTranscript = voiced.transcript;
+        sections = voiced.sections;
+    }
     else {
         const groups = bodyNarrationGroups(context, text);
         const parts = [];
         const transcripts = [];
         const futurePronunciation = [];
-        let pending = text.articleText === null;
+        recipes.push(...text.descriptions, ...text.cards);
+        cards = text.cards;
+        let pending = text.narrationText === null;
         for (const { key: logicalKey, text: logicalText } of groups) {
             transcripts.push({
                 original: logicalText,
                 effective: effectiveText(context, logicalKey, logicalText),
             });
-            futurePronunciation.push(...pronunciationFutureValues(context, text.glossary, text.article, logicalKey, logicalText));
+            futurePronunciation.push(...pronunciationFutureValues(context, text.glossary, text.article, logicalKey, logicalText), ...aliasFutureValues(context, logicalKey, logicalText));
             const group = narrationParts(context, logicalKey, logicalText, "body", [text.article.key], recipes, text.glossary);
             if (group.length === 0)
                 pending = true;
@@ -51,10 +76,10 @@ export function audioRecipes(context, text) {
         }
         if (transcripts.some((row) => row.effective !== row.original))
             bodyTranscript = ["narration-transcript-v1", transcripts.map((row) => row.effective)];
-        if (text.articleText === null) {
-            futurePronunciation.push(...pronunciationFutureValues(context, text.glossary, text.article, "audio:body:future", null));
+        if (text.narrationText === null) {
+            futurePronunciation.push(...pronunciationFutureValues(context, text.glossary, text.article, "audio:body:future", null), ...aliasFutureValues(context, "audio:body:future", null));
             if (prepare)
-                recipes.push(preparationFuture(context, "body", text.article));
+                recipes.push(preparationFuture(context, "body", text.article, text.descriptions));
         }
         if (pending && prepare)
             parts.length = 0;
@@ -69,8 +94,15 @@ export function audioRecipes(context, text) {
                     chunkingValues(context),
                     ...(prepare ? [preparationTemplate(context)] : []),
                     ...futurePronunciation,
+                    ...(text.descriptions.length === 0
+                        ? []
+                        : [["described-v1", text.descriptions.map((row) => row.fingerprint)]]),
                 ],
-            }, [text.article.key, ...preparationKeys(recipes, "body")]));
+            }, [
+                text.article.key,
+                ...text.descriptions.map((row) => row.key),
+                ...preparationKeys(recipes, "body"),
+            ]));
         recipes.push(...parts);
         if (narrationFiles)
             recipes.push(narrationFileRecipe(context, "body", parts));
@@ -81,14 +113,30 @@ export function audioRecipes(context, text) {
             values: [
                 parts.map((part) => resourceIdentity(context, part)),
                 parts.length === 1 ? "copy-single-file" : concatArgs("$parts", "$output"),
+                // Pauses between sentences; a paragraph's between pieces cut at paragraphs.
+                ...pauseValues(config, parts.map((_part, at) => at === parts.length - 1
+                    ? "end"
+                    : (config.chunking ?? defaultChunking).mode === "paragraph"
+                        ? "paragraph"
+                        : "sentence")),
             ],
-        }, parts.map((part) => part.key), { unresolved: text.articleText !== null && groups.length === 0 });
+        }, parts.map((part) => part.key), { unresolved: text.narrationText !== null && groups.length === 0 });
         recipes.push(body);
     }
     const ordered = [];
+    const levels = [];
+    const level = (join, segment) => {
+        // An uploaded narration is the user's own file: only the exports' master reaches it.
+        const levelled = config.sources.audio === "generate" ? levelRecipe(context, join, segment) : undefined;
+        if (levelled === undefined)
+            return;
+        recipes.push(levelled);
+        levels.push(levelled);
+    };
     for (const category of ["intro", "body", "outro"]) {
         if (category === "body") {
             ordered.push({ value: body, transcript: bodyTranscript });
+            level(body, "body");
             continue;
         }
         const entry = text.entries[category];
@@ -116,6 +164,7 @@ export function audioRecipes(context, text) {
                     voiceValues(context),
                     ...(prepare ? [preparationTemplate(context)] : []),
                     ...pronunciationFutureValues(context, text.glossary, text.article, logicalKey, entry.text),
+                    ...aliasFutureValues(context, logicalKey, entry.text),
                 ],
             }, [...dependencies, ...preparationKeys(recipes, category)], invalidGlossary === undefined ? {} : { unresolved: true, refusal: invalidGlossary }));
         recipes.push(...parts);
@@ -126,9 +175,11 @@ export function audioRecipes(context, text) {
             values: [
                 parts.map((part) => resourceIdentity(context, part)),
                 parts.length === 1 ? "copy-single-file" : concatArgs("$parts", "$output"),
+                ...pauseValues(config, parts.map((_part, at) => (at === parts.length - 1 ? "end" : "sentence"))),
             ],
         }, parts.map((part) => part.key));
         recipes.push(audio);
+        level(audio, category);
         if (narrationFiles)
             recipes.push(narrationFileRecipe(context, category, parts));
         ordered.push({
@@ -158,6 +209,9 @@ export function audioRecipes(context, text) {
         ]),
         timeline,
         keys: ordered.map(({ value }) => value.key),
+        levels,
+        ...(sections === undefined ? {} : { sections }),
+        ...(cards.length === 0 ? {} : { cards }),
     };
 }
 function effectiveText(context, key, original) {

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

@@ -3,7 +3,10 @@ import { audioRecipes } from "./recipe-audio.js";
 import { documentRecipes } from "./recipe-document.js";
 import { editPlan } from "./recipe-edit.js";
 import { exportRecipes } from "./recipe-exports.js";
+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 { shortsRecipes } from "./recipe-shorts.js";
 import { textRecipes } from "./recipe-text.js";
 import { thumbnailRecipes, visualAssets, visualRecipes } from "./recipe-visual.js";
@@ -13,20 +16,21 @@ export function buildRecipes(context) {
     const audio = audioRecipes(context, text);
     const exports = exportRecipes(context, audio);
     const captions = exports.find((value) => value.key === "subtitles:files");
+    const timing = exports.find((value) => value.key === "subtitles:timing");
     // The establishing image, when it is on: every other image is drawn from it.
     const reference = referenceRecipe(context);
     const drawnFrom = imageReference(context, reference);
     const thumbnail = thumbnailRecipes(context, text.recipes, referenceForThumbnail(context.config) ? drawnFrom : undefined);
     const youtube = youtubeRecipes(context, exports);
-    return [
+    return withReviews(context, [
         ...text.recipes,
         ...audio.recipes,
         ...exports,
         ...youtube,
         ...(reference === undefined ? [] : [reference]),
-        ...shortsRecipes(context, exports, drawnFrom),
+        ...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), drawnFrom)),
-    ];
+        ...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), masterPlan(context, audio.levels, "video"))),
+    ]);
 }

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

@@ -0,0 +1,18 @@
+import { castMentions } from "../channels/cast-match.js";
+// The cast members an image request is drawn with: the ones its texts mention, at most
+// `castMembersPerImage` of them in the order they are first mentioned. Undefined when none is,
+// so the request - and its fingerprint - is exactly what it was before the channel had a cast.
+// A member's name and description go with its pictures, since the note that introduces each
+// picture to the provider names them.
+export const castMembersPerImage = 4;
+export function castFor(config, ...texts) {
+    const text = texts.filter((value) => typeof value === "string" && value !== "").join("\n");
+    const mentioned = castMentions(text, config.cast).slice(0, castMembersPerImage);
+    return mentioned.length === 0
+        ? undefined
+        : mentioned.map((member) => ({
+            name: member.name,
+            description: member.description,
+            images: member.images,
+        }));
+}

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

@@ -1,5 +1,6 @@
 import { fingerprint } from "../../kernel/runner/work.js";
 import { checkpointClosure, checkpointFingerprint } from "../checkpoints/fingerprint.js";
+import { imageCountsOf } from "../images/scale.js";
 import { buildRecipes } from "./recipe-build.js";
 export function reviewCheckpointSet(runs, catalogue, attachments, fontHash) {
     return runs.flatMap((run, runIndex) => {
@@ -11,15 +12,16 @@ export function reviewCheckpointSet(runs, catalogue, attachments, fontHash) {
                 id,
                 { source: "provide", assetId: id, prompt: null, templateKey: null },
             ])
-            : config.imagePrompts.flatMap((prompt, index) => Array.from({ length: prompt.number }, (_, number) => [
-                `${index}:${number}`,
-                {
-                    source: "generate",
-                    assetId: null,
-                    prompt: run.rendered[`imagePrompts.${index}`] ?? null,
-                    templateKey: `imagePrompts.${index}`,
-                },
-            ]));
+            : // The count the run's first revision plans (`revisions/adopt-content.ts`).
+                imageCountsOf(config).flatMap((count, index) => Array.from({ length: count }, (_, number) => [
+                    `${index}:${number}`,
+                    {
+                        source: "generate",
+                        assetId: null,
+                        prompt: run.rendered[`imagePrompts.${index}`] ?? null,
+                        templateKey: `imagePrompts.${index}`,
+                    },
+                ]));
         const content = {
             articleMarkdown: config.sources.article === "provide" ? config.provided.article : undefined,
             provided: { audio: config.provided.audio, thumbnail: config.provided.thumbnail },