@gentbajko/slopify 2.4.0 → 3.0.0

package/dist/slices/play-drafts/convert.js

@@ -2,8 +2,30 @@ import { z } from "zod";
 import { defaultEdgeSilenceSeconds, defaultImageSeconds, defaultZoomPercent, edgeSilenceSecondsProblem, imageSecondsProblem, numberPerPromptMax, zoomPercentProblem, } from "../admission/rules.js";
 import { runDraftSchema } from "../admission/schema.js";
 import { draftDocumentThemeOf } from "../document/model.js";
+import { defaultExpectedWords, everyMinutesMax, everyMinutesMin, expectedWordsMax, imagesPerHourMax, imagesPerHourMin, perHourFromMinutes, wordCount, } from "../images/scale.js";
+import { defaultLoudness, loudnessOfForm, } from "../loudness/model.js";
+import { pausesOfForm } from "../narration/pauses-model.js";
+import { reviewSettingsFromForm } from "../reviews/model.js";
+import { stageMakesItems } from "../reviews/rules.js";
 import { defaultShorts, shortsExtrasOf, shortsSettingsProblems, } from "../shorts/model.js";
 import { defaultSubtitles } from "../subtitles/model.js";
+import { ambientBedOfForm, ambientBedProblems } from "../video/ambient-bed.js";
+// Said where the control is, since the music sits in a closed disclosure on the Export rail.
+const musicMessages = {
+    uploading: "The shorts' background music is still uploading, so the run can't start yet. Wait for it to finish, or remove it under Outputs → Export → More shorts options → Background music.",
+    missing: "The shorts' background music file is no longer available (it was not uploaded again after the draft was copied, or the upload failed). Choose the file again under Outputs → Export → More shorts options → Background music, or remove it.",
+};
+function pickMusic(id) {
+    return id === undefined ? {} : { shortsMusic: id };
+}
+const bedWhere = "under Outputs → Export → Ambient sound";
+const bedMessages = {
+    uploading: `The ambient sound's audio file is still uploading, so the run can't start yet. Wait for it to finish ${bedWhere}.`,
+    missing: `The ambient sound's audio file is missing (it was never chosen, was not uploaded again after the draft was copied, or the upload failed). Choose the file ${bedWhere}, or pick Rain, Fireplace or Wind instead.`,
+};
+function pickBed(id) {
+    return id === undefined ? {} : { ambientBed: id };
+}
 export function toAdmissionDraft(input) {
     const { form } = input.document;
     const fields = [];
@@ -49,15 +71,18 @@ export function toAdmissionDraft(input) {
         });
         return undefined;
     };
-    const file = (ref, kind, field) => {
+    const file = (ref, kind, field, messages = {
+        uploading: "This file is still uploading. Wait for it to finish.",
+        missing: "That upload is no longer available. Choose the file again.",
+    }) => {
         const attachment = input.attachments.find((item) => item.id === ref?.attachmentId && item.kind === kind && item.name === ref.name);
         if (attachment?.state === "ready" && attachment.stagedFileId !== null)
             return attachment.stagedFileId;
         fields.push({
             field,
             message: attachment?.state === "copying" || attachment?.state === "pending"
-                ? "This file is still uploading. Wait for it to finish."
-                : "That upload is no longer available. Choose the file again.",
+                ? messages.uploading
+                : messages.missing,
         });
         return undefined;
     };
@@ -97,7 +122,28 @@ export function toAdmissionDraft(input) {
                 : defaultShorts.maxSeconds,
         };
     };
+    // Only the reviews of stages that make something; none left is no reviews at all, which is
+    // what every draft saved before them was.
+    const reviewed = form.reviews === undefined
+        ? undefined
+        : reviewSettingsFromForm(form.reviews, (stage) => stageMakesItems({ sources, shorts: shortsOn ? { enabled: true } : undefined }, stage));
+    if (reviewed?.retriesProblem !== undefined)
+        fields.push({ field: "reviews.retries", message: reviewed.retriesProblem });
+    const reviews = reviewed?.settings;
+    // The ambient bed lies under the long video's narration, so a bed left set with either Off
+    // asks for nothing. Refused in the rule's words, so Play and the run say the same sentence.
+    const bed = sources.video === "generate" && sources.audio !== "off"
+        ? ambientBedOfForm(form.ambientBed)
+        : undefined;
+    const bedProblems = bed === undefined ? [] : ambientBedProblems(bed);
+    for (const problem of bedProblems)
+        fields.push({
+            field: `ambientBed.${problem.field}`,
+            message: `${problem.message} Change it ${bedWhere}.`,
+        });
+    const bedRefused = bedProblems.length;
     const draft = {
+        ...(reviews === undefined ? {} : { reviews }),
         ...(form.checkpoints === undefined ? {} : { checkpoints: form.checkpoints }),
         title: form.title,
         format: form.format,
@@ -112,17 +158,46 @@ export function toAdmissionDraft(input) {
             : {}),
         llm: form.llm,
         audio: sources.audio === "generate" || form.audio.usePronunciationGlossary !== undefined
-            ? // With the glossary on, sharing it is on unless the draft turned it off, as Play
-                // shows it for a draft saved before the switch existed.
-                form.audio.usePronunciationGlossary === true && form.audio.shareGlossary === undefined
-                    ? { ...form.audio, shareGlossary: true }
-                    : form.audio
+            ? onlyWhenOn(
+            // With the glossary on, sharing it is on unless the draft turned it off, as Play
+            // shows it for a draft saved before the switch existed.
+            form.audio.usePronunciationGlossary === true && form.audio.shareGlossary === undefined
+                ? { ...form.audio, shareGlossary: true }
+                : form.audio)
             : undefined,
         images: form.images,
+        // The establishing image belongs to generated images; Off, or images not generated,
+        // leaves it out, which is what every draft saved before it was.
+        ...(sources.images === "generate" &&
+            form.reference !== undefined &&
+            form.reference.source !== "off"
+            ? {
+                reference: {
+                    source: form.reference.source,
+                    ...(form.reference.source === "prompt" ? { prompt: form.reference.prompt } : {}),
+                    thumbnail: form.reference.thumbnail,
+                },
+            }
+            : {}),
+        // Three only for a thumbnail the image provider draws; one leaves it out, which is what
+        // every draft saved before it was.
+        ...(form.thumbnailCount === 3 &&
+            (sources.thumbnail === "from_prompt" || sources.thumbnail === "prompt_by_llm")
+            ? { thumbnailCount: 3 }
+            : {}),
         articlePrompt: sources.article === "generate" ? form.articlePrompt : undefined,
         ...(sources.audio === "generate" && form.narrationPrompt?.trim()
             ? { narrationPrompt: form.narrationPrompt }
             : {}),
+        // English is never stored on the run, so an English project is the run it always was.
+        ...(form.language === undefined || form.language === "en" ? {} : { language: form.language }),
+        // Drawn for the blocks the narration describes, so only with a video and describing on.
+        ...(sources.video === "generate" &&
+            sources.audio === "generate" &&
+            form.audio.describeFigures === true &&
+            form.showFigures === true
+            ? { showFigures: true }
+            : {}),
         // Timed from the narration, so a switch left on with narration Off asks for nothing.
         ...(sources.audio !== "off" && form.youtubeDescription === true
             ? {
@@ -139,6 +214,9 @@ export function toAdmissionDraft(input) {
                 number: number(prompt.number, `imagePrompts.${index}.number`, numberPerPromptMax),
             }))
             : [],
+        ...(sources.images === "generate" && form.imageScale !== undefined
+            ? { imageScale: imageScaleOf(input.document, fields) }
+            : {}),
         thumbnailPrompt: ["from_prompt", "prompt_by_llm"].includes(sources.thumbnail)
             ? form.thumbnailPrompt
             : undefined,
@@ -154,12 +232,24 @@ export function toAdmissionDraft(input) {
             thumbnail: sources.thumbnail === "provide"
                 ? file(form.provided.thumbnail, "thumbnail", "provided.thumbnail")
                 : undefined,
+            reference: sources.images === "generate" && form.reference?.source === "provide"
+                ? file(form.provided.reference ?? null, "reference", "provided.reference")
+                : undefined,
             images: sources.images === "provide"
                 ? form.provided.images.flatMap((ref, index) => {
                     const id = file(ref, "images", `provided.images.${index}`);
                     return id === undefined ? [] : [id];
                 })
                 : [],
+            // Optional, so only a file that was attached is checked; with Shorts off it is kept on
+            // the draft for when Shorts is turned back on, and never reaches the run.
+            ...(shortsOn && form.provided.shortsMusic
+                ? pickMusic(file(form.provided.shortsMusic, "audio", "shorts.music", musicMessages))
+                : {}),
+            // Only while the bed plays the user's own file; kept on the draft otherwise.
+            ...(bed?.source === "upload"
+                ? pickBed(file(form.provided.ambientBed ?? null, "audio", "ambientBed.file", bedMessages))
+                : {}),
         },
         chunking: {
             mode: chunkMode,
@@ -177,7 +267,11 @@ export function toAdmissionDraft(input) {
                 mode,
                 fontSize: number(form.subtitles.fontSize, "subtitles.fontSize", 120, 16),
             },
-        silenceGapSeconds: input.silenceGapSeconds,
+        // This run's own gap when one was typed, else the one Settings has. Text that is not a
+        // number is NaN, which admission refuses at silenceGapSeconds.
+        silenceGapSeconds: form.silenceGapSeconds === undefined || form.silenceGapSeconds.trim() === ""
+            ? input.silenceGapSeconds
+            : Number(form.silenceGapSeconds),
         imageSeconds: measure("imageSeconds", sources.video === "generate" || shortsOn, defaultImageSeconds, imageSecondsProblem),
         zoomPercent: measure("zoomPercent", sources.video === "generate", defaultZoomPercent, zoomPercentProblem),
         // A choice from a list, so there is nothing to refuse; a run without a video keeps it
@@ -185,6 +279,15 @@ export function toAdmissionDraft(input) {
         motionStyle: form.motionStyle,
         // Kept the same way; admission checks it only while the video renders.
         ...(form.videoEdit === undefined ? {} : { videoEdit: form.videoEdit }),
+        // Spoken by the speakers only while narration is generated.
+        ...(form.voices !== undefined && sources.audio === "generate" ? { voices: form.voices } : {}),
+        // Under the long video's narration only; a number already refused above leaves it out
+        // rather than saved as NaN.
+        ...(bed !== undefined && bedRefused === 0 ? { ambientBed: bed } : {}),
+        // Only while on, and only with a narration to level, so the run is otherwise the one it was.
+        ...pickLoudness(sources.audio, loudnessOfForm(form.loudness, input.loudness ?? defaultLoudness)),
+        // Pauses between sentences: the default for a new run, with a narration to pace.
+        ...(sources.audio === "generate" ? pausesOfForm(form) : {}),
         edgeSilenceSeconds: measure("edgeSilenceSeconds", sources.audio !== "off", defaultEdgeSilenceSeconds, edgeSilenceSecondsProblem),
     };
     const parsed = runDraftSchema.safeParse(draft);
@@ -198,3 +301,51 @@ export function toAdmissionDraft(input) {
         ? { ok: false, fields }
         : { ok: true, draft: parsed.data };
 }
+function pickLoudness(audio, loudness) {
+    return audio === "off" || loudness === undefined ? {} : { loudness };
+}
+// More images for long videos, from what Play's control holds: the rate as images per hour,
+// and the narration length it is planned for, which is the provided article's own words or
+// else Review's expected words (`images/scale.ts`).
+function imageScaleOf(document, fields) {
+    const { form } = document;
+    const typed = form.imageScale?.value.trim() ?? "";
+    const value = typed === "" ? Number.NaN : Number(typed);
+    const minutes = form.imageScale?.every !== "hour";
+    const inRange = minutes
+        ? value >= everyMinutesMin && value <= everyMinutesMax
+        : value >= imagesPerHourMin && value <= imagesPerHourMax;
+    if (!inRange)
+        fields.push({
+            field: "imageScale.value",
+            message: minutes
+                ? `Enter a number of minutes between ${String(everyMinutesMin)} and ${String(everyMinutesMax)} under Images → More images for long videos.`
+                : `Enter a number of images per hour between ${String(imagesPerHourMin)} and ${String(imagesPerHourMax)} under Images → More images for long videos.`,
+        });
+    const perHour = !inRange
+        ? imagesPerHourMin
+        : minutes
+            ? perHourFromMinutes(value)
+            : Math.round(value * 10000) / 10000;
+    if (form.sources.article === "provide")
+        return { perHour, words: Math.max(1, wordCount(form.provided.article)) };
+    // Review checks the expected words on its own (`review-inputs.ts`); a draft whose figure is
+    // not a whole number yet plans for Play's starting one.
+    const expected = Number(document.expectedWords.trim());
+    return {
+        perHour,
+        words: Number.isInteger(expected) && expected >= 1 && expected <= expectedWordsMax
+            ? expected
+            : defaultExpectedWords,
+    };
+}
+// "Describe tables and figures" and "Skip code" are stored only when on, so a run started
+// with them off saves the config every run made before them did.
+function onlyWhenOn(audio) {
+    const { describeFigures, skipCode, ...rest } = audio;
+    return {
+        ...rest,
+        ...(describeFigures === true ? { describeFigures } : {}),
+        ...(describeFigures === true && skipCode === true ? { skipCode } : {}),
+    };
+}

package/dist/slices/play-drafts/readiness.js

@@ -2,6 +2,7 @@ import { checkRuntimeModel } from "../../catalog/runtime-models.js";
 import { modelFields } from "../../catalog/validate.js";
 import { readinessIsUsable } from "../../kernel/ports/model.js";
 import { usesNarrationPreparation, usesShorts, usesYoutubeDescription, } from "../admission/rules.js";
+import { usesReviews } from "../reviews/rules.js";
 import { cliPathChanged } from "../settings/cli-paths.js";
 import { hasKey, listVoices } from "../settings/repo.js";
 import { usesAnimation } from "../video/edit-settings.js";
@@ -36,6 +37,8 @@ export function choices(runs) {
                 usesShorts(d) ||
                 usesAnimation(d),
         },
+        // The reviewer is its own text model, checked like the LLM row.
+        { field: "reviews", family: "llm", choice: d.reviews, needed: usesReviews(d) },
     ])
         .flatMap((c) => (c.needed && c.choice ? [{ ...c, ...c.choice }] : []));
     return [...new Map(selected.map((c) => [`${c.family}:${c.provider}:${c.model}`, c])).values()];

package/dist/slices/play-drafts/repo.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { fingerprint } from "../../kernel/runner/work.js";
+import { draftAttachmentKinds } from "./schema.js";
 const rowSchema = z.object({
     id: z.string(),
     schema_version: z.number(),
@@ -21,7 +22,7 @@ const attachmentSchema = z.object({
     id: z.string(),
     draft_id: z.string(),
     staged_file_id: z.string().nullable(),
-    kind: z.enum(["audio", "images", "thumbnail"]),
+    kind: z.enum(draftAttachmentKinds),
     original_filename: z.string(),
     status: z.enum(["pending", "ready", "reattach"]),
     error: z.string().nullable(),
@@ -52,6 +53,13 @@ export function attachmentRefs(document) {
         ...(p.audio === null ? [] : [{ ...p.audio, kind: "audio" }]),
         ...p.images.map((file) => ({ ...file, kind: "images" })),
         ...(p.thumbnail === null ? [] : [{ ...p.thumbnail, kind: "thumbnail" }]),
+        ...(p.reference === undefined || p.reference === null
+            ? []
+            : [{ ...p.reference, kind: "reference" }]),
+        // The shorts' music is staged like narration audio, so it is an audio attachment.
+        ...(p.shortsMusic == null ? [] : [{ ...p.shortsMusic, kind: "audio" }]),
+        // So is the ambient bed's own file.
+        ...(p.ambientBed == null ? [] : [{ ...p.ambientBed, kind: "audio" }]),
     ];
 }
 export function requestHash(value) {

package/dist/slices/play-drafts/review-inputs.js

@@ -3,6 +3,7 @@ import { readFileSync, statSync } from "node:fs";
 import { z } from "zod";
 import { modelFields } from "../../catalog/validate.js";
 import { admit } from "../admission/rules.js";
+import { brandedForm, brandedRun, castSnapshot, castVoicedRun, draftChannel, } from "../channels/runs.js";
 import { estimateRun } from "../estimate/index.js";
 import { listEntries } from "../library/repo.js";
 import { pickTemplates, renderPicked } from "../library/slots.js";
@@ -51,12 +52,27 @@ export function resolveReviewInputs(deps, view, font) {
             field: "variants",
             message: "You can review at most 50 videos at once, counting the first one. Remove some variations.",
         });
-    const converted = toAdmissionDraft({
-        document,
+    const entries = [...(document.librarySnapshot?.entries ?? []), ...listEntries(deps.db)];
+    // The channel's brand kit fills what the setup leaves at its default, and its cast rides
+    // along for the images (`slices/channels/runs.ts`).
+    const channel = draftChannel(deps.db, document);
+    const useBrandKit = document.form.useBrandKit !== false;
+    const branded = toAdmissionDraft({
+        document: {
+            ...document,
+            form: brandedForm(deps.db, document.form, channel.brand, entries),
+        },
         attachments: fresh.value.attachments,
-        entries: [...(document.librarySnapshot?.entries ?? []), ...listEntries(deps.db)],
+        entries,
         silenceGapSeconds: readSettings(deps).silenceGapSeconds,
+        loudness: readSettings(deps).loudness,
     });
+    const converted = branded.ok
+        ? {
+            ok: true,
+            draft: castVoicedRun(deps.db, brandedRun(branded.draft, channel, castSnapshot(deps.db, channel.id), useBrandKit)),
+        }
+        : branded;
     if (!converted.ok)
         fields.push(...converted.fields);
     if (!converted.ok || !words.success || fields.length)
@@ -110,7 +126,10 @@ export function resolveReviewInputs(deps, view, font) {
     const activeIds = new Set(runs.flatMap((run) => [
         run.draft.provided.audio,
         run.draft.provided.thumbnail,
+        run.draft.provided.reference,
         ...(run.draft.provided.images ?? []),
+        run.draft.provided.shortsMusic,
+        run.draft.provided.ambientBed,
     ]));
     const attachmentIdentity = fresh.value.attachments.flatMap((file) => file.stagedFileId !== null && activeIds.has(file.stagedFileId)
         ? [{ id: file.id, stagedFileId: file.stagedFileId, bytes: file.bytes }]

package/dist/slices/play-drafts/schema.js

@@ -1,20 +1,26 @@
 import { z } from "zod";
 import { formats, stageKinds } from "../../kernel/pipeline.js";
+import { languageSchema } from "../../kernel/ports/languages.js";
 import { thinkingModes } from "../../kernel/ports/llm.js";
-import { motionStyles, stageSources } from "../admission/model.js";
+import { motionStyles, referenceSources, stageSources } from "../admission/model.js";
 import { defaultEdgeSilenceSeconds, defaultImageSeconds, defaultMotionStyle, defaultZoomPercent, } from "../admission/rules.js";
 import { runDraftSchema, videoEditSchema } from "../admission/schema.js";
 import { checkpointRowSchema, checkpointStageSchema } from "../checkpoints/schema.js";
 import { documentSettingsSchema } from "../document/theme-schema.js";
 import { librarySnapshotSchema } from "../library/snapshot.js";
 import { chunkModes } from "../narration/chunk.js";
+import { reviewModes, reviewStages } from "../reviews/model.js";
 import { subtitleModes, subtitlePositions } from "../subtitles/model.js";
+import { ambientBedSources } from "../video/ambient-bed.js";
+import { voicesSettingsSchema } from "../voices/model.js";
 const id = z.uuid();
 const text = z.string();
 const values = z.record(text, text).readonly();
 const provider = z
     .object({ provider: text, model: text, thinking: z.enum(thinkingModes).optional() })
     .strict();
+// What a draft's uploads are for: a stage's files, or the Images stage's establishing image.
+export const draftAttachmentKinds = ["audio", "images", "thumbnail", "reference"];
 const file = z.object({ attachmentId: id, name: text }).strict().readonly();
 export const playDraftFormSchema = z
     .object({
@@ -42,14 +48,52 @@ export const playDraftFormSchema = z
         voice: text,
         usePronunciationGlossary: z.boolean().optional(),
         shareGlossary: z.boolean().optional(),
+        useNarrationAliases: z.boolean().optional(),
+        describeFigures: z.boolean().optional(),
+        skipCode: z.boolean().optional(),
     })
         .readonly(),
     images: provider.readonly(),
+    // Absent on drafts and templates saved before the establishing image: Off. The prompt is
+    // an image prompt's name, "" when none is picked.
+    reference: z
+        .object({
+        source: z.enum(["off", ...referenceSources]),
+        prompt: text,
+        thumbnail: z.boolean(),
+    })
+        .strict()
+        .readonly()
+        .optional(),
     articlePrompt: text,
     narrationPrompt: text.optional(),
+    // Absent on drafts and templates saved before three thumbnails: one.
+    thumbnailCount: z.union([z.literal(1), z.literal(3)]).optional(),
+    // Level the volume (`loudness/model.ts`). Absent on drafts and templates nobody changed it
+    // in: Settings → General's default, which is on for a new run. The targets are LUFS; absent
+    // is Settings' own.
+    loudness: z
+        .object({
+        enabled: z.boolean(),
+        videoLufs: z.number().optional(),
+        audioFilesLufs: z.number().optional(),
+    })
+        .strict()
+        .readonly()
+        .optional(),
+    // Pauses between sentences and paragraphs in seconds, raw text like every number on Play.
+    // Absent on drafts and templates nobody changed them in: the sentence default and no
+    // paragraph minimum (`narration/pauses-model.ts`).
+    sentencePause: text.optional(),
+    paragraphPause: text.optional(),
     // Absent on drafts and templates saved before the YouTube description: off, built-in prompt.
     youtubeDescription: z.boolean().optional(),
+    showFigures: z.boolean().optional(),
     descriptionPrompt: text.optional(),
+    // The project language (`kernel/ports/languages.ts`). Absent on drafts and templates saved
+    // before it, and on a draft nobody picked one for: the channel's language, else English.
+    // English picked on purpose is kept as "en", so a channel's language does not replace it.
+    language: languageSchema.optional(),
     // Absent on drafts and templates saved before Shorts: off. The numbers are raw text, like
     // every other number on Play; the prompts are names, "" being the built-in ones.
     shorts: z
@@ -70,7 +114,33 @@ export const playDraftFormSchema = z
         .strict()
         .readonly()
         .optional(),
+    // Absent on drafts and templates saved before automatic reviews: every review Off. The
+    // retries are raw text like every other number on Play; a stage's prompt is a Review
+    // prompt's name, "" being the built-in one.
+    reviews: z
+        .object({
+        provider: text,
+        model: text,
+        thinking: z.enum(thinkingModes).optional(),
+        retries: text,
+        stages: z
+            .partialRecord(z.enum(reviewStages), z
+            .object({ mode: z.enum(reviewModes), prompt: text })
+            .strict()
+            .readonly())
+            .readonly(),
+    })
+        .strict()
+        .readonly()
+        .optional(),
     imagePrompts: z.array(z.object({ name: text, number: text }).strict().readonly()).readonly(),
+    // More images for long videos, as typed: "every [value] minutes" or "[value] per hour".
+    // Absent is off, which is what every draft and template saved before it was.
+    imageScale: z
+        .object({ every: z.enum(["minutes", "hour"]), value: text })
+        .strict()
+        .readonly()
+        .optional(),
     thumbnailPrompt: text,
     intro: text,
     outro: text,
@@ -94,9 +164,30 @@ export const playDraftFormSchema = z
     edgeSilenceSeconds: text.default(String(defaultEdgeSilenceSeconds)),
     zoomPercent: text.default(String(defaultZoomPercent)),
     motionStyle: z.enum(motionStyles).default(defaultMotionStyle),
+    // The silence between narration segments for this run, raw text like the numbers above.
+    // Absent or empty: the gap Settings has.
+    silenceGapSeconds: text.optional(),
     // Absent on drafts and templates saved before the edit settings: today's slideshow. Every
     // field is a pick from a list, so it is kept as the settings themselves.
     videoEdit: videoEditSchema.strict().readonly().optional(),
+    // Whether the channel's brand kit fills what this setup leaves at its default
+    // (`slices/channels/runs.ts`). Absent is on.
+    useBrandKit: z.boolean().optional(),
+    // Absent on drafts and templates saved before multiple voices: the Narration format. Every
+    // number is a pick from a list, so it is kept as the settings themselves.
+    voices: voicesSettingsSchema.strict().readonly().optional(),
+    // The ambient bed under the long video (`video/ambient-bed.ts`), numbers as typed. Absent
+    // takes the channel's brand kit's, if any; "none" asks for no bed whatever the channel has.
+    ambientBed: z
+        .object({
+        source: z.enum(["none", ...ambientBedSources]),
+        level: text,
+        fadeIn: text,
+        tail: text,
+    })
+        .strict()
+        .readonly()
+        .optional(),
     values,
     provided: z
         .object({
@@ -105,6 +196,14 @@ export const playDraftFormSchema = z
         audio: file.nullable(),
         thumbnail: file.nullable(),
         images: z.array(file).readonly(),
+        // The uploaded establishing image; absent on drafts saved before it.
+        reference: file.nullable().optional(),
+        // The Shorts step's background music, uploaded as an audio attachment. Absent on
+        // drafts and templates saved before Play offered it: no music.
+        shortsMusic: file.nullable().optional(),
+        // The ambient bed's own file, an audio attachment; used only while its source is
+        // "upload". Absent on drafts and templates saved before it.
+        ambientBed: file.nullable().optional(),
     })
         .strict()
         .readonly(),
@@ -120,6 +219,8 @@ export const playDraftDocumentSchema = z
         .strict()
         .readonly()
         .optional(),
+    // The channel picked on Play. Absent runs in the template's channel, or the default one.
+    channelId: id.optional(),
     form: playDraftFormSchema,
     section: z.enum(["content", "outputs", "style", "review"]),
     variants: z.array(z.object({ id, title: text, values }).strict().readonly()).readonly(),
@@ -150,7 +251,7 @@ export const discardDraftInputSchema = z
 export const draftAttachmentSchema = z
     .object({
     id,
-    kind: z.enum(["audio", "images", "thumbnail"]),
+    kind: z.enum(draftAttachmentKinds),
     name: text,
     state: z.enum(["pending", "copying", "ready", "reattach"]),
     stagedFileId: text.nullable(),
@@ -202,6 +303,9 @@ const costEstimateSchema = z
         low: z.number().nullable(),
         high: z.number().nullable(),
         detail: text,
+        onPlan: z.boolean().optional(),
+        apiLow: z.number().nullable().optional(),
+        apiHigh: z.number().nullable().optional(),
     })
         .strict()
         .readonly())
@@ -209,6 +313,9 @@ const costEstimateSchema = z
     low: z.number(),
     high: z.number(),
     unknown: z.number(),
+    apiLow: z.number().optional(),
+    apiHigh: z.number().optional(),
+    apiUnknown: z.number().optional(),
     expectedWords: z.number(),
     catalogueDate: text.nullable(),
     assumptions: z.array(text).readonly(),

package/dist/slices/play-drafts/service.js

@@ -44,7 +44,7 @@ function parseStoredJson(value) {
         throw error;
     }
 }
-function documentOf(row) {
+export function documentOf(row) {
     if (row.schema_version !== 1)
         return null;
     const parsed = playDraftDocumentSchema.safeParse(parseStoredJson(row.document_json));
@@ -208,6 +208,15 @@ export function forkDraft(deps, input) {
                     audio: p.audio === null ? null : rewrite(p.audio),
                     thumbnail: p.thumbnail === null ? null : rewrite(p.thumbnail),
                     images: p.images.map(rewrite),
+                    ...(p.reference === undefined
+                        ? {}
+                        : { reference: p.reference === null ? null : rewrite(p.reference) }),
+                    ...(p.shortsMusic === undefined
+                        ? {}
+                        : { shortsMusic: p.shortsMusic === null ? null : rewrite(p.shortsMusic) }),
+                    ...(p.ambientBed === undefined
+                        ? {}
+                        : { ambientBed: p.ambientBed === null ? null : rewrite(p.ambientBed) }),
                 },
             },
         };

package/dist/slices/play-drafts/start.js

@@ -80,7 +80,47 @@ export async function startPlayDraft(deps, input) {
     };
     const checked = await checkDraftReadiness(captured, claimed.value.runs);
     const oldFiles = attachmentRows(deps.db, input.draftId).flatMap((a) => a.staged_file_id === null ? [] : [a.staged_file_id]);
-    const result = transact(deps.db, () => {
+    let result;
+    try {
+        result = createReviewedRuns(deps, input, captured, checked, catalogue);
+    }
+    catch (error) {
+        if (!(error instanceof StartedRunMismatch))
+            throw error;
+        // Nothing the review promised was created: the transaction rolled back.
+        releaseStartClaim(deps, input, true);
+        try {
+            deps.log.write("error", "play.start.run-count", { detail: error.message });
+        }
+        catch {
+            /* The refusal below still reaches the person. */
+        }
+        return { ok: false, reason: "stale-review", currentVersion: input.baseVersion, fields: [] };
+    }
+    if (!result.ok) {
+        releaseStartClaim(deps, input, result.reason === "stale-review");
+        return result;
+    }
+    if (!result.value.replayed) {
+        afterCommit(deps, () => deps.recordStarted(result.value.projectIds));
+        for (const id of oldFiles)
+            afterCommit(deps, () => releaseStagedFile(deps, id));
+        afterCommit(deps, () => {
+            if (result.value.queue.length)
+                pumpQueue(deps.db, deps.runner);
+            else
+                for (const id of result.value.projectIds)
+                    deps.runner.tick(id);
+        });
+    }
+    return result;
+}
+// Start creates exactly the runs the person reviewed: one project for one run, otherwise a
+// queue entry and project per run. Anything else is thrown so the transaction rolls back.
+class StartedRunMismatch extends Error {
+}
+function createReviewedRuns(deps, input, captured, checked, catalogue) {
+    return transact(deps.db, () => {
         const receipt = readStartReceipt(deps.db, input.reviewId);
         if (receipt)
             return replayResult(receipt, input);
@@ -109,27 +149,12 @@ export async function startPlayDraft(deps, input) {
             replayed: false,
             ...(checkpointSet.length ? { checkpointSet } : {}),
         };
+        if (projectIds.length !== runs.length || queue.length !== (runs.length === 1 ? 0 : runs.length))
+            throw new StartedRunMismatch(`Start would create ${projectIds.length} of ${runs.length} reviewed videos (${queue.length} queued).`);
         insertStartReceipt(deps, input, value);
         markDraftStartedAndReleaseRefs(deps.db, input);
         return { ok: true, value };
     });
-    if (!result.ok) {
-        releaseStartClaim(deps, input, result.reason === "stale-review");
-        return result;
-    }
-    if (!result.value.replayed) {
-        afterCommit(deps, () => deps.recordStarted(result.value.projectIds));
-        for (const id of oldFiles)
-            afterCommit(deps, () => releaseStagedFile(deps, id));
-        afterCommit(deps, () => {
-            if (result.value.queue.length)
-                pumpQueue(deps.db, deps.runner);
-            else
-                for (const id of result.value.projectIds)
-                    deps.runner.tick(id);
-        });
-    }
-    return result;
 }
 function afterCommit(deps, run) {
     try {

package/dist/slices/play-drafts/uploads.js

@@ -29,7 +29,8 @@ export async function uploadDraftAttachment(deps, input) {
         return refuse("conflict");
     const storage = { ...deps, emit: () => undefined };
     const result = await stageUpload(storage, {
-        stageKind: attachment.kind,
+        // The establishing image is the Images stage's upload.
+        stageKind: attachment.kind === "reference" ? "images" : attachment.kind,
         originalFilename: attachment.original_filename,
         content: input.content,
         onAllocated(file) {