@gentbajko/slopify 2.4.0 → 3.0.0

package/dist/slices/admission/rules.js

@@ -1,7 +1,14 @@
 import { stageKinds } from "../../kernel/pipeline.js";
+import { imageScaleProblem } from "../images/scale.js";
+import { loudnessFields } from "../loudness/model.js";
+import { pauseFields } from "../narration/pauses-model.js";
+import { reviewFields } from "../reviews/rules.js";
 import { shortsSettingsProblems } from "../shorts/model.js";
+import { ambientBedProblems, usesAmbientBed } from "../video/ambient-bed.js";
 import { usesAnimation, videoEditProblems } from "../video/edit-settings.js";
+import { usesVoices, voicesProblems } from "../voices/model.js";
 import { sourceOf } from "./model.js";
+import { shortModeFields } from "./short-mode.js";
 export const titleMax = 200;
 export const valueMax = 200;
 export const numberPerPromptMax = 20;
@@ -84,7 +91,8 @@ export function admit(input) {
         draft.outro?.mode === "llm" ||
         usesNarrationPreparation(draft) ||
         usesYoutubeDescription(draft) ||
-        usesShorts(draft);
+        usesShorts(draft) ||
+        (usesVoices(draft) && draft.voices?.source === "attribute");
     if (needsLlm && !chosen(draft.llm)) {
         fields.push({ field: "llm", message: "Choose a text (LLM) provider and model." });
     }
@@ -93,6 +101,7 @@ export function admit(input) {
     }
     const voiced = draft.audio;
     fields.push(...narrationPreparationFields(draft));
+    fields.push(...voicesFields(draft));
     if (sources.audio === "generate") {
         if (voiced === undefined || !chosen(voiced)) {
             fields.push({ field: "audio", message: "Choose a narration provider and model." });
@@ -124,7 +133,15 @@ export function admit(input) {
     }
     fields.push(...youtubeDescriptionFields(draft));
     fields.push(...shortsFields(draft));
+    fields.push(...shortModeFields(draft));
     fields.push(...videoEditFields(draft));
+    fields.push(...ambientBedFields(draft, input.staged));
+    fields.push(...loudnessFields(draft.loudness));
+    fields.push(...pauseFields(draft));
+    fields.push(...referenceFields(draft));
+    fields.push(...reviewFields(draft));
+    if (usesReference(draft) && draft.reference?.source === "provide")
+        checkFile(input.staged, draft.provided.reference, "images", "provided.reference", "Upload the establishing image, or set Establishing image to Off in the Images section.", fields);
     checkProvided(draft, input.staged, fields);
     checkValues(draft, input.requiredSlots, fields);
     if (!Number.isFinite(draft.silenceGapSeconds) ||
@@ -207,6 +224,9 @@ function checkImagePrompts(draft, fields) {
             message: `A video can have at most ${imagesPerRunMax} images; these prompts ask for ${total}. Lower the numbers.`,
         });
     }
+    const scaleProblem = draft.imageScale === undefined ? undefined : imageScaleProblem(draft.imageScale);
+    if (scaleProblem !== undefined)
+        fields.push({ field: "imageScale", message: scaleProblem });
 }
 function checkProvided(draft, staged, fields) {
     const { sources, provided } = draft;
@@ -243,6 +263,26 @@ function checkProvided(draft, staged, fields) {
             checkFile(staged, id, "images", `provided.images.${index}`, "Pick an image.", fields);
         }
     }
+    checkShortsMusic(draft, staged, fields);
+}
+// The shorts' background music is optional, so only a file that was picked is checked, and
+// only while Shorts is on. Named by where the control sits: Play's Export rail.
+function checkShortsMusic(draft, staged, fields) {
+    const id = draft.provided.shortsMusic;
+    if (draft.shorts?.enabled !== true || id === undefined)
+        return;
+    const where = "under Outputs → Export → More shorts options → Background music";
+    const file = staged.find((candidate) => candidate.id === id);
+    if (file === undefined || file.stageKind !== "audio")
+        fields.push({
+            field: "shorts.music",
+            message: `The shorts' background music file is no longer available, so it can't be added to the project. Choose the file again ${where}, or remove it.`,
+        });
+    else if (file.state !== "staged")
+        fields.push({
+            field: "shorts.music",
+            message: `The shorts' background music is still uploading, so the run can't start yet. Wait for it to finish, or remove it ${where}.`,
+        });
 }
 // A run never starts with provided content that is missing or still copying.
 function checkFile(staged, id, kind, field, missing, fields) {
@@ -297,6 +337,21 @@ export function narrationPreparationFields(draft) {
         ]
         : [];
 }
+// Multiple voices, checked only while narration is generated: a format left set with
+// narration Off or uploaded asks for nothing.
+export function voicesFields(draft) {
+    if (draft.voices === undefined || !usesVoices(draft))
+        return [];
+    const fields = [...voicesProblems(draft.voices)];
+    // Preparation adds delivery tags to the turns of speakers on Inworld TTS-2, so it needs one.
+    if (!blank(draft.narrationPrompt) &&
+        !draft.voices.speakers.some((speaker) => speaker.voice.provider === "inworld" && speaker.voice.model === "inworld-tts-2"))
+        fields.push({
+            field: "narrationPrompt",
+            message: "Narration preparation adds delivery cues only to speakers on Inworld's TTS-2 model, and no speaker uses it. Choose that model for a speaker under Speakers, or clear Narration Preparation in Audio → Advanced.",
+        });
+    return fields;
+}
 // The YouTube description is written from the narration's word timings, so it needs
 // narration; it runs whether the video renders or only the WAV is exported.
 export function usesYoutubeDescription(draft) {
@@ -312,6 +367,30 @@ export function youtubeDescriptionFields(draft) {
         ]
         : [];
 }
+// The establishing image belongs to the Images stage: it is made, and the images drawn with
+// it, only while images are Generate.
+export function usesReference(draft) {
+    return draft.reference !== undefined && draft.sources.images === "generate";
+}
+// Whether the thumbnail is drawn with it too: on unless turned off, and only for a thumbnail
+// the image provider makes.
+export function referenceForThumbnail(draft) {
+    return (usesReference(draft) &&
+        draft.reference?.thumbnail !== false &&
+        (draft.sources.thumbnail === "from_prompt" || draft.sources.thumbnail === "prompt_by_llm"));
+}
+export function referenceFields(draft) {
+    return usesReference(draft) &&
+        draft.reference?.source === "prompt" &&
+        (draft.reference.prompt === undefined || draft.reference.prompt.trim() === "")
+        ? [
+            {
+                field: "reference.prompt",
+                message: "Pick an image prompt for the establishing image, upload one instead, or set Establishing image to Off in the Images section.",
+            },
+        ]
+        : [];
+}
 // Shorts are cut from the narration and captioned from its word timings, so they need
 // narration, like the YouTube description; they run whether the video renders or not.
 export function usesShorts(draft) {
@@ -347,9 +426,55 @@ export function videoEditFields(draft) {
         message: problem.message,
     }));
 }
+// The ambient bed, checked only while the long video renders with narration; its own file only
+// while the source is "upload". Named by where the control sits: Play's Export rail.
+export function ambientBedFields(draft, staged) {
+    const bed = draft.ambientBed;
+    if (bed === undefined || !usesAmbientBed(draft))
+        return [];
+    const where = "under Outputs → Export → Ambient sound";
+    const fields = ambientBedProblems(bed).map((problem) => ({
+        field: `ambientBed.${problem.field}`,
+        message: `${problem.message} Change it ${where}.`,
+    }));
+    if (bed.source !== "upload")
+        return fields;
+    const id = draft.provided.ambientBed;
+    const file = id === undefined ? undefined : staged.find((candidate) => candidate.id === id);
+    if (file === undefined || file.stageKind !== "audio")
+        fields.push({
+            field: "ambientBed.file",
+            message: `The ambient sound's audio file is missing, so it can't be added to the project. Choose the file ${where}, or pick Rain, Fireplace or Wind instead.`,
+        });
+    else if (file.state !== "staged")
+        fields.push({
+            field: "ambientBed.file",
+            message: `The ambient sound's audio file is still uploading, so the run can't start yet. Wait for it to finish ${where}.`,
+        });
+    return fields;
+}
 function chosen(choice) {
     return choice !== undefined && choice.provider.trim() !== "" && choice.model.trim() !== "";
 }
+// The aliases a run narrates with: its copied Library → Aliases while Use narration aliases is
+// on for generated audio, otherwise none. Any voice provider: an alias is plain text.
+export function narrationAliasesOf(draft) {
+    return draft.sources.audio === "generate" && draft.audio?.useNarrationAliases === true
+        ? (draft.narrationAliases ?? [])
+        : [];
+}
+// Describe tables and figures in the narration: generated narration, the setting on, and a
+// text model to write the descriptions. Without a text model the narration flattens the
+// article as it always did, so the default being on never asks for one.
+export function usesDescribedNarration(draft) {
+    return (draft.sources.audio === "generate" && draft.audio?.describeFigures === true && chosen(draft.llm));
+}
+// "Show tables and figures on screen": a video, and the narration describing its blocks.
+export function usesFigureCards(draft) {
+    return (usesDescribedNarration(draft) &&
+        draft.sources.video === "generate" &&
+        draft.showFigures === true);
+}
 export function usesPronunciationGlossary(draft) {
     return (draft.sources.audio === "generate" &&
         draft.audio?.usePronunciationGlossary === true &&

package/dist/slices/admission/schema.js

@@ -1,12 +1,19 @@
 import { z } from "zod";
+import { languageSchema } from "../../kernel/ports/languages.js";
 import { thinkingModes } from "../../kernel/ports/llm.js";
+import { castSnapshotSchema } from "../channels/schema.js";
 import { checkpointStageSchema } from "../checkpoints/schema.js";
 import { documentSettingsSchema } from "../document/theme-schema.js";
+import { narrationAliasesSchema } from "../narration/aliases-schema.js";
 import { chunkModes } from "../narration/chunk.js";
+import { reviewModes, reviewStages } from "../reviews/model.js";
 import { subtitleConfigSchema } from "../subtitles/model.js";
+import { ambientBedSchema } from "../video/ambient-bed-schema.js";
 import { animateModes, atmospheres, colorGrades, cutModes, lookLevels, transitionKinds, } from "../video/edit-settings.js";
-import { entryModes, formats, motionStyles, stageSources } from "./model.js";
+import { voicesSettingsSchema } from "../voices/model.js";
+import { entryModes, formats, motionStyles, referenceSources, runModes, stageSources, } from "./model.js";
 import { defaultEdgeSilenceSeconds, defaultImageSeconds, defaultMotionStyle, defaultZoomPercent, } from "./rules.js";
+const hexColour = z.string().regex(/^#[0-9A-Fa-f]{6}$/);
 const providerChoice = z.object({
     provider: z.string(),
     model: z.string(),
@@ -29,6 +36,8 @@ export const videoEditSchema = z.object({
 // The shape Play posts and the shape `projects.config` holds, in one place: the second
 // is the first plus the rendered prompt texts.
 export const runDraftSchema = z.object({
+    // Absent is the long video.
+    mode: z.enum(runModes).optional(),
     checkpoints: z
         .array(checkpointStageSchema)
         .max(3)
@@ -55,8 +64,12 @@ export const runDraftSchema = z.object({
         voice: z.string(),
         usePronunciationGlossary: z.boolean().optional(),
         shareGlossary: z.boolean().optional(),
+        useNarrationAliases: z.boolean().optional(),
+        describeFigures: z.boolean().optional(),
+        skipCode: z.boolean().optional(),
     })
         .optional(),
+    narrationAliases: narrationAliasesSchema.optional(),
     sharedGlossary: z
         .array(z.object({
         term: z.string().min(1).max(200),
@@ -66,10 +79,20 @@ export const runDraftSchema = z.object({
         .readonly()
         .optional(),
     images: providerChoice.optional(),
+    reference: z
+        .object({
+        source: z.enum(referenceSources),
+        prompt: z.string().optional(),
+        thumbnail: z.boolean().optional(),
+    })
+        .optional(),
     articlePrompt: z.string().optional(),
     narrationPrompt: z.string().optional(),
     imagePrompts: z.array(z.object({ name: z.string(), number: z.number() })),
+    // The ranges are `slices/images/scale.ts`'s, checked by admission, not the schema's.
+    imageScale: z.object({ perHour: z.number(), words: z.number() }).optional(),
     thumbnailPrompt: z.string().optional(),
+    thumbnailCount: z.union([z.literal(1), z.literal(3)]).optional(),
     intro: entryChoice.optional(),
     outro: entryChoice.optional(),
     values: z.record(z.string(), z.string()),
@@ -79,6 +102,11 @@ export const runDraftSchema = z.object({
         audio: z.string().optional(),
         images: z.array(z.string()).optional(),
         thumbnail: z.string().optional(),
+        reference: z.string().optional(),
+        // The staged file of the shorts' background music; used only while Shorts is on.
+        shortsMusic: z.string().optional(),
+        // The staged file of the ambient bed; used only while its source is "upload".
+        ambientBed: z.string().optional(),
     }),
     // Optional until Play carries the control; unknown keys are stripped by this schema, so
     // a mode not listed here would never reach the audio stage.
@@ -99,6 +127,7 @@ export const runDraftSchema = z.object({
     subtitles: subtitleConfigSchema.optional(),
     document: documentSettingsSchema.optional(),
     youtubeDescription: z.boolean().optional(),
+    showFigures: z.boolean().optional(),
     descriptionPrompt: z.string().optional(),
     // The ranges are `slices/shorts/model.ts`'s, checked by admission, not the schema's.
     shorts: z
@@ -117,6 +146,44 @@ export const runDraftSchema = z.object({
         .optional(),
     // The ranges are `slices/video/edit-settings.ts`'s, checked by admission, not the schema's.
     videoEdit: videoEditSchema.optional(),
+    channelId: z.string().optional(),
+    useBrandKit: z.literal(false).optional(),
+    cast: castSnapshotSchema.optional(),
+    earlierEpisodes: z
+        .array(z.object({ title: z.string(), summary: z.string() }))
+        .readonly()
+        .optional(),
+    titleStyle: z
+        .object({
+        fontId: z
+            .string()
+            .max(160)
+            .regex(/^[A-Za-z0-9_-]+$/)
+            .optional(),
+        color: hexColour.optional(),
+    })
+        .optional(),
+    endScreen: z.object({ text: z.string().max(200) }).optional(),
+    // The retry range is `slices/reviews/model.ts`'s, checked by admission, not the schema's.
+    reviews: z
+        .object({
+        provider: z.string(),
+        model: z.string(),
+        thinking: z.enum(thinkingModes).optional(),
+        retries: z.number().optional(),
+        stages: z.partialRecord(z.enum(reviewStages), z.object({ mode: z.enum(reviewModes), prompt: z.string().optional() })),
+    })
+        .optional(),
+    // The rules are `slices/voices/model.ts`'s, checked by admission, not the schema's.
+    voices: voicesSettingsSchema.optional(),
+    ambientBed: ambientBedSchema.optional(),
+    // Level the volume (`loudness/model.ts`); the range is checked by admission.
+    loudness: z.object({ videoLufs: z.number(), audioFilesLufs: z.number() }).strict().optional(),
+    // Pauses between sentences and paragraphs (`narration/pauses-model.ts`); checked by admission.
+    sentencePauseSeconds: z.number().optional(),
+    paragraphPauseSeconds: z.number().optional(),
+    // Absent is English (`kernel/ports/languages.ts`).
+    language: languageSchema.optional(),
 });
 export const runConfigSchema = runDraftSchema.extend({
     rendered: z.record(z.string(), z.string()),

package/dist/slices/admission/short-mode.js

@@ -0,0 +1,47 @@
+import { sourceOf } from "./model.js";
+// The short-only run mode: the same stages as a long video, narrowed to one vertical clip of
+// about a minute. The article is written for a short, the narration and images are made as
+// usual, and the Video stage renders the whole narration through the Shorts renderer
+// (`shorts/render.ts`) with its word-by-word captions instead of the slideshow. A short has
+// no thumbnail, PDF or shorts of its own.
+export function usesShortMode(draft) {
+    return draft.mode === "short";
+}
+// Said where each control sits, so a draft or a Save that breaks the mode names the fix.
+export function shortModeFields(draft) {
+    if (!usesShortMode(draft))
+        return [];
+    const fields = [];
+    if (draft.format !== "9:16")
+        fields.push({
+            field: "format",
+            message: "A short is vertical. Choose the 9:16 format, or make a long video instead.",
+        });
+    if (sourceOf(draft.sources, "video") !== "generate")
+        fields.push({
+            field: "sources.video",
+            message: "A short is a video. Set Video to Generate.",
+        });
+    if (sourceOf(draft.sources, "audio") === "off")
+        fields.push({
+            field: "sources.audio",
+            message: "A short's length and captions come from its narration. Set Narration to Generate or Provide.",
+        });
+    if (sourceOf(draft.sources, "images") === "off")
+        fields.push({
+            field: "sources.images",
+            message: "A short shows images behind its captions. Set Images to Generate or Provide.",
+        });
+    for (const kind of ["thumbnail", "document"])
+        if (sourceOf(draft.sources, kind) !== "off")
+            fields.push({
+                field: `sources.${kind}`,
+                message: `A short has no ${kind === "thumbnail" ? "thumbnail" : "PDF"}. Set ${kind === "thumbnail" ? "Thumbnail" : "Document"} to Off.`,
+            });
+    if (draft.shorts?.enabled === true)
+        fields.push({
+            field: "shorts.enabled",
+            message: "A short isn't cut into more shorts. Turn Shorts off.",
+        });
+    return fields;
+}

package/dist/slices/admission/start.js

@@ -1,15 +1,23 @@
 import { transact } from "../../kernel/db/tx.js";
 import { stageKinds } from "../../kernel/pipeline.js";
 import { storeArticleText } from "../article/store.js";
+import { resolveChannelId, setProjectChannel } from "../channels/repo.js";
 import { defaultDocumentTheme } from "../document/model.js";
+import { earlierEpisodesFor } from "../episodes/related.js";
+import { listNarrationAliases } from "../narration/aliases-library.js";
 import { collectSharedGlossary } from "../narration/shared-glossary.js";
 import { admitInitialRevision } from "../rebuild/runtime-admission.js";
 import { adoptBaseline } from "../revisions/adopt.js";
+import { insertAsset } from "../revisions/repo.js";
+import { discardPreparedAssets } from "../storage/assets.js";
+import { prepareStagedFile } from "../storage/prepare.js";
 import { attachStagedFile, storeText } from "../storage/staging.js";
 import { releaseStagedFile } from "../storage/staging-refs.js";
+import { usesAmbientBed } from "../video/ambient-bed.js";
 import { sourceOf, } from "./model.js";
 import { insertProject, insertStage } from "./repo.js";
-import { usesPronunciationGlossary } from "./rules.js";
+import { usesPronunciationGlossary, usesReference } from "./rules.js";
+import { render } from "./substitute.js";
 // Provide → `provided` with its output attached; Off → `skipped`;
 // everything else → `pending`.
 export function initialState(source) {
@@ -26,8 +34,20 @@ export function startRun(deps, draft, rendered, retainStaged = false, templates)
     const shared = usesPronunciationGlossary(draft) && draft.audio?.shareGlossary === true
         ? collectSharedGlossary(deps).entries
         : [];
+    // Library → Aliases as they are now: later edits there never change this project.
+    const aliases = draft.sources.audio === "generate" && draft.audio?.useNarrationAliases === true
+        ? listNarrationAliases(deps.db)
+        : [];
+    // The title may name keywords too ("D&D Lore: {{Topic}}"), filled like a prompt's, so a
+    // template or Play keeps the pattern and each project gets its own title.
+    const title = render(draft.title, draft.values).trim() || draft.title;
+    // The channel's related earlier episodes as they are now (`slices/episodes`): later edits
+    // there never change this project. A draft never brings its own.
+    const { earlierEpisodes: _carried, ...fresh } = draft;
+    const earlier = earlierEpisodesFor(deps.db, draft, title);
     const config = {
-        ...draft,
+        ...fresh,
+        title,
         // A new project always names its document theme: a config without one reads as the
         // DiceMaster of older projects (see documentThemeOf), which no new project should get.
         ...(sourceOf(draft.sources, "document") === "generate" && draft.document === undefined
@@ -35,10 +55,12 @@ export function startRun(deps, draft, rendered, retainStaged = false, templates)
             : {}),
         rendered,
         ...(shared.length === 0 ? {} : { sharedGlossary: shared }),
+        ...(aliases.length === 0 ? {} : { narrationAliases: aliases }),
+        ...(earlier === undefined ? {} : { earlierEpisodes: earlier }),
     };
     const project = {
         id,
-        title: draft.title,
+        title,
         format: draft.format,
         config,
         createdAt: at,
@@ -63,19 +85,40 @@ export function startRun(deps, draft, rendered, retainStaged = false, templates)
     // the project folder rather than moved, so a rollback leaves the staging files exactly
     // as the form left them and the same Play can simply be pressed again.
     const moved = [];
-    transact(deps.db, () => {
-        insertProject(deps.db, project);
-        for (const stage of stages) {
-            insertStage(deps.db, stage);
-        }
-        attachProvided(deps, id, draft, moved, retainStaged);
-        if (deps.catalogue !== undefined) {
-            const baseline = adoptBaseline(deps, id, templates);
-            if (!baseline.ok)
-                throw new Error("The new project has no revision.");
-            admitInitialRevision(deps, baseline.view, deps.catalogue.read());
-        }
-    });
+    let music;
+    let bed;
+    try {
+        transact(deps.db, () => {
+            insertProject(deps.db, project);
+            setProjectChannel(deps.db, id, resolveChannelId(deps.db, draft.channelId));
+            for (const stage of stages) {
+                insertStage(deps.db, stage);
+            }
+            attachProvided(deps, id, draft, moved, retainStaged);
+            music = attachShortsMusic(deps, id, draft, moved);
+            bed = attachAmbientBed(deps, id, draft, moved);
+            // The music is named by the first revision, as Edit project → Shorts names it, so the
+            // project gets its revision now even where it would otherwise wait for its first view.
+            // The ambient bed's own file is named the same way.
+            if (deps.catalogue !== undefined || music !== undefined || bed !== undefined) {
+                const baseline = adoptBaseline(deps, id, templates, {
+                    ...(music === undefined ? {} : { shortsMusic: music.id }),
+                    ...(bed === undefined ? {} : { ambientBed: bed.id }),
+                });
+                if (!baseline.ok)
+                    throw new Error("The new project has no revision.");
+                if (deps.catalogue !== undefined)
+                    admitInitialRevision(deps, baseline.view, deps.catalogue.read());
+            }
+        });
+    }
+    catch (error) {
+        // The copy was written outside the transaction; nothing names it once it rolled back.
+        const written = [music, bed].flatMap((asset) => (asset === undefined ? [] : [asset]));
+        if (written.length > 0)
+            discardPreparedAssets(deps, written);
+        throw error;
+    }
     for (const source of retainStaged ? [] : moved) {
         releaseStagedFile(deps, source);
     }
@@ -103,6 +146,9 @@ function attachProvided(deps, projectId, draft, collected, retainStaged) {
     if (sources.thumbnail === "provide") {
         attach(deps, projectId, "thumbnail", provided.thumbnail, "thumbnail", collected, retainStaged);
     }
+    if (usesReference(draft) && draft.reference?.source === "provide") {
+        attach(deps, projectId, "images", provided.reference, "reference", collected, retainStaged);
+    }
     if (sources.images === "provide") {
         // Slideshow order is the order the user left the list in.
         for (const [index, stagedFileId] of (provided.images ?? []).entries()) {
@@ -110,6 +156,34 @@ function attachProvided(deps, projectId, draft, collected, retainStaged) {
         }
     }
 }
+// The Shorts step's background music, copied into the project as an asset of its own (never
+// an output), exactly as Edit project → Shorts keeps an uploaded one. Only while Shorts is on.
+function attachShortsMusic(deps, projectId, draft, collected) {
+    const stagedFileId = draft.provided.shortsMusic;
+    if (draft.shorts?.enabled !== true || stagedFileId === undefined)
+        return undefined;
+    const result = prepareStagedFile(deps, { projectId, stagedFileId, role: "audio_body" });
+    if (!result.ok)
+        // admit() already refused a missing or still-copying file, as for the stages' own files.
+        throw new Error(`the shorts' background music could not be attached: ${result.reason}`);
+    insertAsset(deps.db, result.asset);
+    collected.push(stagedFileId);
+    return result.asset;
+}
+// The ambient bed's own file, copied into the project as an asset of its own like the shorts'
+// music. Only while the long video gets the bed and its source is "upload".
+function attachAmbientBed(deps, projectId, draft, collected) {
+    const stagedFileId = draft.provided.ambientBed;
+    if (draft.ambientBed?.source !== "upload" || !usesAmbientBed(draft) || stagedFileId === undefined)
+        return undefined;
+    const result = prepareStagedFile(deps, { projectId, stagedFileId, role: "audio_body" });
+    if (!result.ok)
+        // admit() already refused a missing or still-copying file, as for the stages' own files.
+        throw new Error(`the ambient sound's audio file could not be attached: ${result.reason}`);
+    insertAsset(deps.db, result.asset);
+    collected.push(stagedFileId);
+    return result.asset;
+}
 function attach(deps, projectId, kind, stagedFileId, role, collected, retainStaged, index) {
     if (stagedFileId === undefined) {
         throw new Error(`the ${kind} stage is provided but carries no staged file`);

package/dist/slices/article/continuation.js

@@ -82,7 +82,7 @@ function truncated(answer) {
 // Empty response → failed attempt.
 function written(answer) {
     return answer.text.trim() === ""
-        ? "The AI model returned an empty article. Retry stage; if it keeps happening, choose a different model in Edit project → Providers."
+        ? "The AI model returned an empty article. Try again; if it keeps happening, choose a different model in Edit project → Providers."
         : undefined;
 }
 function finished(answer) {
@@ -91,6 +91,6 @@ function finished(answer) {
         return empty;
     }
     return truncated(answer)
-        ? `The article was still unfinished after ${String(continuationLimit)} continuations because the AI model kept stopping at its length limit. Ask for a shorter article in Edit project → Prompts, or choose a model with a larger output limit in Edit project → Providers, then Retry stage.`
+        ? `The article was still unfinished after ${String(continuationLimit)} continuations because the AI model kept stopping at its length limit. Ask for a shorter article in Edit project → Prompts, or choose a model with a larger output limit in Edit project → Providers, then Try again.`
         : undefined;
 }

package/dist/slices/article/provided-entries.js

@@ -20,11 +20,11 @@ export async function prepareProvidedArticleSegments(deps, audioContext, provide
     audioContext.signal.throwIfAborted();
     const article = stagesOf(deps.db, projectId).find((stage) => stage.kind === "article");
     if (!article)
-        throw new Error("Slopify hit an internal error (the project has no article stage). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error("Slopify hit an internal error (the project has no article stage). Try again; if it happens again, use Download diagnostics in Settings and report it.");
     const outputs = outputsOf(deps.db, projectId);
     const plain = outputs.find((output) => output.role === "article_txt");
     if (!plain)
-        throw new Error("The article text you provided is missing, so the intro and outro can't be written from it. Paste the article again in Edit project → Article, then Retry stage.");
+        throw new Error("The article text you provided is missing, so the intro and outro can't be written from it. Paste the article again in Edit project → Article, then Try again.");
     const narration = readFileSync(outputPath(deps.paths, projectId, plain.path), "utf8");
     const saved = outputs.find((output) => output.stageKind === "article" && output.role === "instructions");
     let instructions = saved

package/dist/slices/article/run.js

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { messageRoles } from "../../kernel/ports/llm.js";
 import { insertPiece, piecesOf, setPiece } from "../../kernel/runner/piece-repo.js";
 import { projectById } from "../admission/repo.js";
+import { withEarlierEpisodes } from "../episodes/related.js";
 import { outputPath } from "../storage/layout.js";
 import { outputsOf } from "../storage/repo.js";
 import { storeText } from "../storage/staging.js";
@@ -20,10 +21,13 @@ export async function runArticle(deps, context, providers) {
     if (choice === undefined || articlePrompt === undefined) {
         // Admission refuses a run whose article is Generate without both, so
         // reaching here is a bug in admission rather than something the user did.
-        throw new Error("No AI model or article prompt is set for writing the article. Choose a model in Edit project → Providers and check Edit project → Prompts, then Retry stage.");
+        throw new Error("No AI model or article prompt is set for writing the article. Choose a model in Edit project → Providers and check Edit project → Prompts, then Try again.");
     }
     const notes = researchNotes(deps, projectId);
-    const brief = { articlePrompt, ...(notes === undefined ? {} : { notes }) };
+    const brief = {
+        articlePrompt: withEarlierEpisodes(articlePrompt, project.config.earlierEpisodes),
+        ...(notes === undefined ? {} : { notes }),
+    };
     const result = await articleBody(deps, context, providers, choice, brief);
     if (!result.ok)
         return "held";

package/dist/slices/article/segments.js

@@ -7,12 +7,12 @@ export async function writeSegment(providers, choice, config, category, article,
         return { ok: true, value: undefined };
     const body = config.rendered[category];
     if (body === undefined)
-        throw new Error(`Slopify hit an internal error (the ${category} text was never filled in). Retry stage; if it happens again, use Download diagnostics in Settings and report it.`);
+        throw new Error(`Slopify hit an internal error (the ${category} text was never filled in). Try again; if it happens again, use Download diagnostics in Settings and report it.`);
     const common = { category, name: picked.name, mode: picked.mode };
     if (picked.mode === "text")
         return { ok: true, value: { ...common, text: body, tokens: noTokens } };
     if (choice === undefined)
-        throw new Error(`No AI model is set for writing the ${category}. Choose one in Edit project → Providers, then Retry stage.`);
+        throw new Error(`No AI model is set for writing the ${category}. Choose one in Edit project → Providers, then Try again.`);
     const messages = segmentMessages(body, config, article);
     sent.push({ label: category === "intro" ? "Intro" : "Outro", messages });
     const answer = await providers.llm({
@@ -21,7 +21,7 @@ export async function writeSegment(providers, choice, config, category, article,
         ...(choice.thinking === undefined ? {} : { thinking: choice.thinking }),
         messages,
         check: (given) => given.text.trim() === ""
-            ? `The AI model returned an empty ${category}. Retry stage; if it keeps happening, choose a different model in Edit project → Providers.`
+            ? `The AI model returned an empty ${category}. Try again; if it keeps happening, choose a different model in Edit project → Providers.`
             : undefined,
     });
     if (!answer.ok)