@gentbajko/slopify 2.5.0 → 3.0.1

package/dist/slices/admission/repo.js

@@ -31,6 +31,8 @@ const stageRow = z.object({
     progress_total: z.number().nullable(),
     started_at: z.string().nullable(),
     finished_at: z.string().nullable(),
+    failure_kind: z.string().nullable().optional(),
+    retry_at: z.string().nullable().optional(),
 });
 export function insertProject(db, project) {
     db.prepare("INSERT INTO projects (id, title, format, config, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(project.id, project.title, project.format, JSON.stringify(project.config), project.createdAt, project.updatedAt);
@@ -40,7 +42,21 @@ export function insertProject(db, project) {
 export function insertStage(db, stage) {
     db.prepare("INSERT INTO stages (id, project_id, kind, source, state, attempt_count) VALUES (?, ?, ?, ?, ?, ?)").run(stage.id, stage.projectId, stage.kind, stage.source, stage.state, stage.attemptCount);
 }
+// A project in the trash (`project_trash`, Settings → Trash) is not found by any of these
+// reads: it is listed nowhere, opens nowhere and takes no action until it is restored.
+// `slices/trash` and `slices/storage/delete-project.ts` read the table directly.
+export function liveProject(alias = "projects", column = "id") {
+    return `NOT EXISTS (SELECT 1 FROM project_trash WHERE project_trash.project_id = ${alias}.${column})`;
+}
+export function projectTrashed(db, id) {
+    return db.prepare("SELECT 1 FROM project_trash WHERE project_id = ?").get(id) !== undefined;
+}
 export function projectById(db, id) {
+    const row = db.prepare(`${projectSelect} WHERE projects.id = ? AND ${liveProject()}`).get(id);
+    return row === undefined ? undefined : toProject(projectRow.parse(row));
+}
+// The same, trash or not: a backup carries a project in the trash and checks it can be read.
+export function projectByIdIncludingTrash(db, id) {
     const row = db.prepare(`${projectSelect} WHERE projects.id = ?`).get(id);
     return row === undefined ? undefined : toProject(projectRow.parse(row));
 }
@@ -48,12 +64,12 @@ export function projectById(db, id) {
 // asks whether the id names a project, and parsing the config to answer that would tie
 // cancelling to a schema it never reads.
 export function projectExists(db, id) {
-    return db.prepare("SELECT 1 FROM projects WHERE id = ?").get(id) !== undefined;
+    return (db.prepare(`SELECT 1 FROM projects WHERE id = ? AND ${liveProject()}`).get(id) !== undefined);
 }
 // Newest first.
 export function listProjects(db) {
     return db
-        .prepare(`${projectSelect} ORDER BY created_at DESC, id DESC`)
+        .prepare(`${projectSelect} WHERE ${liveProject()} ORDER BY created_at DESC, id DESC`)
         .all()
         .map((row) => toProject(projectRow.parse(row)));
 }
@@ -98,12 +114,12 @@ export function claimStage(db, stageId, at) {
     return Number(result.changes) === 1;
 }
 export function finishStage(db, stageId, state, failureReason, at) {
-    db.prepare("UPDATE stages SET state = ?, failure_reason = ?, finished_at = ? WHERE id = ?").run(state, failureReason, state === "pending" ? null : at, stageId);
+    db.prepare("UPDATE stages SET state = ?, failure_reason = ?, retry_at = NULL, finished_at = ? WHERE id = ?").run(state, failureReason, state === "pending" ? null : at, stageId);
 }
 // A stage put back to `pending` by a re-run, a cascade or a retry starts again from a clean row
 // - no error text, no progress from the run before it, and a fresh attempt budget.
 export function resetStage(db, stageId) {
-    db.prepare("UPDATE stages SET state = 'pending', failure_reason = NULL, attempt_count = 0, progress_current = NULL, progress_total = NULL, started_at = NULL, finished_at = NULL WHERE id = ?").run(stageId);
+    db.prepare("UPDATE stages SET state = 'pending', failure_reason = NULL, failure_kind = NULL, retry_at = NULL, attempt_count = 0, progress_current = NULL, progress_total = NULL, started_at = NULL, finished_at = NULL WHERE id = ?").run(stageId);
 }
 export function setStageProgress(db, stageId, current, total) {
     db.prepare("UPDATE stages SET progress_current = ?, progress_total = ? WHERE id = ?").run(current, total, stageId);
@@ -151,5 +167,9 @@ function toStage(row) {
         progressTotal: row.progress_total,
         startedAt: row.started_at,
         finishedAt: row.finished_at,
+        ...(row.failure_kind === null || row.failure_kind === undefined
+            ? {}
+            : { failureKind: row.failure_kind }),
+        ...(row.retry_at === null || row.retry_at === undefined ? {} : { retryAt: row.retry_at }),
     };
 }

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,8 +133,13 @@ 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);
@@ -210,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;
@@ -254,7 +271,7 @@ 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 where = "under Outputs → More shorts options → Background music";
     const file = staged.find((candidate) => candidate.id === id);
     if (file === undefined || file.stageKind !== "audio")
         fields.push({
@@ -320,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 under Narration → 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) {
@@ -394,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 Video and style → 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, referenceSources, 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),
@@ -76,7 +89,10 @@ export const runDraftSchema = z.object({
     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()),
@@ -89,6 +105,8 @@ export const runDraftSchema = z.object({
         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.
@@ -109,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
@@ -127,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,7 +1,10 @@
 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";
@@ -10,6 +13,7 @@ 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, usesReference } from "./rules.js";
@@ -30,11 +34,19 @@ export function startRun(deps, draft, rendered, retainStaged = false, templates)
     const shared = usesPronunciationGlossary(draft) && draft.audio?.shareGlossary === true
         ? collectSharedGlossary(deps).entries
         : [];
-    // The title may name keywords too ("D&D Lore: {{Topic}}"), filled like a prompt's, so a
+    // 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 ("History: {{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.
@@ -43,6 +55,8 @@ 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,
@@ -72,18 +86,25 @@ export function startRun(deps, draft, rendered, retainStaged = false, templates)
     // as the form left them and the same Play can simply be pressed again.
     const moved = [];
     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.
-            if (deps.catalogue !== undefined || music !== undefined) {
-                const baseline = adoptBaseline(deps, id, templates, music === undefined ? {} : { shortsMusic: music.id });
+            // 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)
@@ -93,8 +114,9 @@ export function startRun(deps, draft, rendered, retainStaged = false, templates)
     }
     catch (error) {
         // The copy was written outside the transaction; nothing names it once it rolled back.
-        if (music !== undefined)
-            discardPreparedAssets(deps, [music]);
+        const written = [music, bed].flatMap((asset) => (asset === undefined ? [] : [asset]));
+        if (written.length > 0)
+            discardPreparedAssets(deps, written);
         throw error;
     }
     for (const source of retainStaged ? [] : moved) {
@@ -148,6 +170,20 @@ function attachShortsMusic(deps, projectId, draft, collected) {
     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)

package/dist/slices/backups/folder.js

@@ -23,13 +23,21 @@ export function folderProblem(paths, folder) {
             return "This folder is one Slopify uses for its own temporary files. Pick another folder, or leave Folder empty to use the default.";
     return undefined;
 }
-// Where the folder is on the user's computer. In Docker only the projects folder is shared
-// with the host, so a folder elsewhere lives in the container's private volume.
+// Where the folder is on the user's computer. In Docker only the projects folder (and, from
+// 3.0, the Backups folder) is shared with the host, so a folder elsewhere lives in the
+// container's private volume.
 export function hostFolder(paths, location, folder) {
     if (!location.container)
         return folder;
-    if (location.hostProjects === null || !within(paths.projects, folder))
-        return null;
-    const inside = relative(paths.projects, folder);
-    return inside === "" ? location.hostProjects : join(location.hostProjects, inside);
+    const shared = [
+        [paths.projects, location.hostProjects],
+        [paths.backups, location.hostBackups],
+    ];
+    for (const [inContainer, onHost] of shared.toSorted((a, b) => b[0].length - a[0].length)) {
+        if (!onHost || !within(inContainer, folder))
+            continue;
+        const inside = relative(inContainer, folder);
+        return inside === "" ? onHost : join(onHost, inside);
+    }
+    return null;
 }

package/dist/slices/batch/index.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { transact } from "../../kernel/db/tx.js";
 import { derive } from "../../kernel/runner/graph.js";
-import { projectPaused, stagesOf } from "../admission/repo.js";
+import { liveProject, projectPaused, stagesOf } from "../admission/repo.js";
 import { startRun } from "../admission/start.js";
 import { deleteStagedFile } from "../storage/repo.js";
 import { releaseStagedFile } from "../storage/staging-refs.js";
@@ -11,10 +11,13 @@ const queueRow = z.object({
     position: z.number(),
     state: z.enum(["queued", "active", "finished"]),
 });
+// A project in the trash leaves the queue's view, so the queue moves on past it; restored,
+// it is back in its place.
 export function queueEntries(db, batchId) {
     return db
         .prepare(`SELECT project_id AS projectId, batch_id AS batchId, position, state
     FROM project_queue ${batchId === undefined ? "WHERE state != 'finished'" : "WHERE batch_id = ?"}
+    AND ${liveProject("project_queue", "project_id")}
     ORDER BY position`)
         .all(...(batchId === undefined ? [] : [batchId]))
         .map((row) => queueRow.parse(row));
@@ -50,6 +53,8 @@ export function enqueueBatch(deps, batchId, runs, retainStaged = false) {
                     used.add(id);
             if (draft.shorts?.enabled === true && draft.provided.shortsMusic)
                 used.add(draft.provided.shortsMusic);
+            if (draft.ambientBed?.source === "upload" && draft.provided.ambientBed)
+                used.add(draft.provided.ambientBed);
         }
         for (const id of retainStaged ? [] : used) {
             sources.add(id);
@@ -68,7 +73,7 @@ export function pumpQueue(db, runner) {
         const status = derive(stages, projectPaused(db, entry.projectId));
         if (runner.hasInflight?.(entry.projectId))
             return;
-        if (["done", "failed", "canceled"].includes(status)) {
+        if (["done", "partial", "failed", "canceled"].includes(status)) {
             db.prepare("UPDATE project_queue SET state = 'finished' WHERE project_id = ?").run(entry.projectId);
             continue;
         }

package/dist/slices/cancel/index.js

@@ -53,7 +53,7 @@ async function cancel(deps, projectId) {
         if (paused)
             setProjectPaused(deps.db, projectId, false, at);
         deps.db
-            .prepare("UPDATE revision_work SET state='canceled',dispatch_state='held',failure_reason=? WHERE project_id=? AND state!='done'")
+            .prepare("UPDATE revision_work SET state='canceled',dispatch_state='held',failure_reason=?,retry_at=NULL WHERE project_id=? AND state!='done'")
             .run(canceledByUser, projectId);
         deps.db
             .prepare("UPDATE revision_work_pieces SET state='held',dispatch_state='held' WHERE work_id IN (SELECT id FROM revision_work WHERE project_id=?) AND state!='done'")