@gentbajko/slopify 2.0.2 → 2.1.0

package/dist/kernel/db/migrations/0014-document-stage.sql

@@ -0,0 +1,44 @@
+-- foreign-keys: off
+-- SQLite cannot widen a CHECK constraint in place, so the two tables that list the stage
+-- kinds are rebuilt. `stages` is referenced by attempts, stage_pieces and revision_work with
+-- ON DELETE CASCADE: migrate.ts turns enforcement off for this file, or dropping the old
+-- table would empty those three, and checks every reference before it commits.
+CREATE TABLE stages_document_upgrade (id TEXT PRIMARY KEY, project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE, kind TEXT NOT NULL CHECK(kind IN ('research','article','audio','images','thumbnail','video','document')), source TEXT NOT NULL, state TEXT NOT NULL CHECK(state IN ('pending','running','done','failed','canceled','provided','skipped')), failure_reason TEXT, attempt_count INTEGER NOT NULL DEFAULT 0, progress_current INTEGER, progress_total INTEGER, started_at TEXT, finished_at TEXT, UNIQUE(project_id, kind));
+INSERT INTO stages_document_upgrade (id,project_id,kind,source,state,failure_reason,attempt_count,progress_current,progress_total,started_at,finished_at)
+  SELECT id,project_id,kind,source,state,failure_reason,attempt_count,progress_current,progress_total,started_at,finished_at FROM stages;
+DROP TABLE stages;
+ALTER TABLE stages_document_upgrade RENAME TO stages;
+CREATE UNIQUE INDEX stages_project_identity ON stages(project_id,id,kind);
+
+-- Every existing project gets the new stage switched off, so nothing it already finished
+-- shows as waiting.
+INSERT INTO stages (id,project_id,kind,source,state)
+  SELECT id || '-document', id, 'document', 'off', 'skipped' FROM projects;
+
+CREATE TABLE revision_pieces_document_upgrade (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  revision_id TEXT NOT NULL,
+  piece_key TEXT NOT NULL,
+  stage_kind TEXT NOT NULL CHECK(stage_kind IN
+    ('research','article','audio','images','thumbnail','video','document')),
+  asset_id TEXT,
+  fingerprint TEXT NOT NULL,
+  descriptor TEXT NOT NULL CHECK(json_valid(descriptor)),
+  publication_id TEXT,
+  selected INTEGER NOT NULL CHECK(selected IN (0,1)),
+  created_at TEXT NOT NULL,
+  FOREIGN KEY(project_id, revision_id)
+    REFERENCES project_revisions(project_id, id) ON DELETE CASCADE,
+  FOREIGN KEY(project_id, asset_id)
+    REFERENCES project_assets(project_id, id) ON DELETE CASCADE
+);
+INSERT INTO revision_pieces_document_upgrade (id,project_id,revision_id,piece_key,stage_kind,asset_id,fingerprint,descriptor,publication_id,selected,created_at)
+  SELECT id,project_id,revision_id,piece_key,stage_kind,asset_id,fingerprint,descriptor,publication_id,selected,created_at FROM revision_pieces;
+DROP TABLE revision_pieces;
+ALTER TABLE revision_pieces_document_upgrade RENAME TO revision_pieces;
+CREATE UNIQUE INDEX revision_pieces_selected ON revision_pieces(revision_id, piece_key)
+  WHERE selected = 1;
+CREATE INDEX revision_pieces_revision ON revision_pieces(revision_id, created_at, id);
+CREATE UNIQUE INDEX revision_pieces_publication ON revision_pieces(revision_id, publication_id, piece_key)
+  WHERE publication_id IS NOT NULL;

package/dist/kernel/db/migrations/0015-description-prompts.sql

@@ -0,0 +1,13 @@
+CREATE TABLE prompts_description_upgrade (
+  id TEXT PRIMARY KEY,
+  kind TEXT NOT NULL CHECK (kind IN ('article','image','thumbnail','narration','description')),
+  name TEXT NOT NULL,
+  body TEXT NOT NULL,
+  slots TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+INSERT INTO prompts_description_upgrade (id,kind,name,body,slots,updated_at)
+  SELECT id,kind,name,body,slots,updated_at FROM prompts;
+DROP TABLE prompts;
+ALTER TABLE prompts_description_upgrade RENAME TO prompts;
+CREATE UNIQUE INDEX prompts_name ON prompts(kind,lower(name));

package/dist/kernel/lock.js

@@ -6,14 +6,15 @@ export function acquireInstanceLock(lockPath) {
     if (!claim(lockPath, pid)) {
         const holder = holderOf(lockPath);
         if (holder !== undefined && holds(holder, pid)) {
-            throw new Error(`another Slopify instance is already running on this data directory (pid ${holder.pid}). ` +
-                `Stop it, or delete ${lockPath} if it is stale.`);
+            throw new Error(`Slopify is already running on this data directory (process ${holder.pid}). ` +
+                "Use the copy that is already open, or stop it (Ctrl+C in its terminal) and start again. " +
+                `If no Slopify is running, delete ${lockPath} and try again.`);
         }
         // The recorded process is gone, or the file says nothing usable. Reclaiming it here
         // is what keeps a crash from bricking the data directory until a file is deleted by hand.
         discard(lockPath);
         if (!claim(lockPath, pid)) {
-            throw new Error(`could not take the instance lock at ${lockPath}: another process was faster`);
+            throw new Error(`Another Slopify started on this data directory at the same moment (lock file ${lockPath}). Close the extra copy and start Slopify again.`);
         }
     }
     return {

package/dist/kernel/pipeline.js

@@ -3,7 +3,17 @@
 // runner may not import a slice to learn them.
 // The frame a run is made in, and the aspect an image is asked for: one set, named once.
 export const formats = ["16:9", "9:16"];
-export const stageKinds = ["research", "article", "audio", "images", "thumbnail", "video"];
+// Document is last so every screen that walks this list in order shows the six older
+// stages where they always were.
+export const stageKinds = [
+    "research",
+    "article",
+    "audio",
+    "images",
+    "thumbnail",
+    "video",
+    "document",
+];
 export const stageStates = [
     "pending",
     "running",

package/dist/kernel/ports/host-cli.js

@@ -1,3 +1,4 @@
+import { isAbsolute } from "node:path";
 import { z } from "zod";
 import { messageRoles, thinkingModes } from "./llm.js";
 import { llmDocumentsSchema } from "./llm-documents.js";
@@ -16,6 +17,9 @@ export const bridgeLimits = {
     generation: 5,
     metadata: 8,
 };
+/** A folder the helper refuses to open on purpose; the route answers it with a 403. */
+export class HostFolderRefused extends Error {
+}
 const short = z
     .string()
     .min(1)
@@ -40,6 +44,16 @@ export const hostImageSchema = z
     aspect: z.enum(["16:9", "9:16"]),
 })
     .strict();
+export const hostOpenFolderSchema = z
+    .object({
+    path: z
+        .string()
+        .min(1)
+        .max(4096)
+        .refine((v) => isAbsolute(v) && !/[\p{Cc}]/u.test(v)),
+})
+    .strict();
+export const hostOpenedSchema = z.object({ opened: z.literal(true) }).strict();
 export const hostStatusSchema = z
     .object({
     id: z.enum(hostCliIds),

package/dist/kernel/ports/subtitles.js

@@ -1 +1,15 @@
-export {};
+// Where the audio stopped matching its transcript: seconds into the aligned file, the
+// transcript words it expected there and what the model heard instead (either may be empty).
+// The aligner throws it so the caller can say which part of the narration to redo.
+export class SubtitleMismatch extends Error {
+    at;
+    expected;
+    heard;
+    constructor(message, at, expected, heard) {
+        super(message);
+        this.at = at;
+        this.expected = expected;
+        this.heard = heard;
+        this.name = "SubtitleMismatch";
+    }
+}

package/dist/kernel/runner/attempt.js

@@ -100,8 +100,8 @@ function classify(error, expired, opts, limit) {
         return providerError({
             kind: "timeout",
             message: opts.streaming === true
-                ? `the provider sent nothing for ${seconds} s`
-                : `the provider did not answer within ${seconds} s`,
+                ? `The ${callee[opts.kind]} sent nothing for ${seconds} seconds, so Slopify stopped waiting. It may be overloaded: wait a few minutes, then use Retry stage.`
+                : `The ${callee[opts.kind]} did not answer within ${seconds} seconds. It may be overloaded: wait a few minutes, then use Retry stage, or choose another model in the Providers section of Edit project.`,
         });
     }
     if (isProviderError(error)) {
@@ -113,11 +113,35 @@ function classify(error, expired, opts, limit) {
             ...(error.fault.retryAfterMs === undefined ? {} : { retryAfterMs: error.fault.retryAfterMs }),
         });
     }
+    if (unreachable(error)) {
+        // `fetch` names only itself; the cause's code (ENOTFOUND, ECONNREFUSED) is the clue.
+        const code = causeCode(error);
+        return providerError({
+            kind: "other",
+            message: `Slopify could not reach the ${callee[opts.kind]} over the internet${code === undefined ? "" : ` (${code})`}. Check your internet connection, firewall or VPN, then use Retry stage.`,
+        });
+    }
     return providerError({
         kind: "other",
         message: redact(error instanceof Error ? error.message : String(error)),
     });
 }
+// What the user calls the other end of each kind of call.
+const callee = {
+    llm: "AI model",
+    tts: "narration provider",
+    image: "image provider",
+};
+// Node's `fetch` rejects a request that never reached the server with this TypeError.
+function unreachable(error) {
+    return error instanceof TypeError && error.message === "fetch failed";
+}
+function causeCode(error) {
+    const cause = error.cause;
+    if (typeof cause !== "object" || cause === null || !("code" in cause))
+        return undefined;
+    return typeof cause.code === "string" && /^[A-Z_]+$/.test(cause.code) ? cause.code : undefined;
+}
 // The same milliseconds, measured two ways. `idle` restarts the count on every chunk, so a
 // stalled stream is cut off and a long answer is not. Cancel still wins.
 function deadline(clock, parent, ms, idle) {

package/dist/kernel/runner/graph.js

@@ -1,5 +1,7 @@
 // Images use saved prompts and can run immediately. A thumbnail's source and an
-// audio-only export narrow these dependencies through dependenciesOf().
+// audio-only export narrow these dependencies through dependenciesOf(). The document is
+// laid out from the article alone, with the thumbnail as its cover when there is one, so it
+// runs beside narration and images rather than after them.
 export const deps = {
     research: [],
     article: ["research"],
@@ -7,6 +9,7 @@ export const deps = {
     images: [],
     thumbnail: ["article"],
     video: ["article", "audio", "images", "thumbnail"],
+    document: ["article", "thumbnail"],
 };
 // `provided` and `skipped` release a dependency exactly as `done` does.
 export function satisfied(state) {
@@ -37,6 +40,8 @@ export function dependenciesOf(kind, sources) {
         return [];
     if (kind === "video" && sources.video === "off")
         return ["article", "audio"];
+    if (kind === "document" && sources.thumbnail === "off")
+        return ["article"];
     return deps[kind];
 }
 // The thin meter under a running row on Projects, averaging stage progress. Every stage

package/dist/main.js

@@ -27,6 +27,7 @@ import { ulidIds } from "./kernel/ids.js";
 import { acquireInstanceLock } from "./kernel/lock.js";
 import { openLog } from "./kernel/log.js";
 import { ensureDirs, layout, subtitleModelDir } from "./kernel/paths.js";
+import { stageKinds } from "./kernel/pipeline.js";
 import { sqliteAttempts } from "./kernel/runner/attempt-repo.js";
 import { createCheckpointAuthority, } from "./kernel/runner/checkpoint-authority.js";
 import { createRunner } from "./kernel/runner/index.js";
@@ -119,7 +120,7 @@ export async function boot(config, options = {}) {
     if (dockerState !== undefined &&
         (process.env.SLOPIFY_CONTAINER !== "1" ||
             dockerState !== "/opt/slopify-install/activation.json"))
-        throw new Error("Invalid managed Docker activation configuration.");
+        throw new Error("This container was started with Slopify's Docker settings in the wrong place (SLOPIFY_DOCKER_INSTALL_STATE). Start it with the launcher instead: npx @gentbajko/slopify --docker");
     const candidateToken = process.env.SLOPIFY_UPDATE_TOKEN ?? "";
     const pendingActivation = isUpdateToken(candidateToken) && process.env.SLOPIFY_UPDATE_PENDING === "1";
     ensureDirs(paths, { mode: 0o700 });
@@ -243,7 +244,7 @@ export async function boot(config, options = {}) {
                 : !existsSync(oldEntry) || !existsSync(workerEntry)
                     ? "Run Slopify from its installed package to use in-app updates."
                     : npm === undefined
-                        ? "npm is unavailable. Install Node.js with npm to use in-app updates."
+                        ? "npm was not found, so in-app updates are off. Install Node.js with npm (https://nodejs.org), or update from the terminal: npx @gentbajko/slopify@latest"
                         : undefined,
             busy: () => updateDb.prepare("SELECT 1 FROM stages WHERE state = 'running' LIMIT 1").get() !==
                 undefined ||
@@ -323,7 +324,10 @@ export async function boot(config, options = {}) {
             schedules: scheduleDeps,
             ...(rebuild.measureAudio === undefined ? {} : { measureAudio: rebuild.measureAudio }),
             openFolder,
-            folderLocation: await dockerFolderConfiguration(process.env, paths.projects),
+            folderLocation: {
+                ...(await dockerFolderConfiguration(process.env, paths.projects)),
+                ...(hostCli === undefined ? {} : { openOnHost: hostCli.openFolder }),
+            },
             ...(dockerState === undefined ? {} : { installationPending: () => updater.locked() }),
             db,
             paths,
@@ -484,7 +488,7 @@ export function wireRunner({ audioPreviews, db, paths, clock, ids, log, hub, tel
                 });
             },
         },
-        runs: Object.fromEntries(["research", "article", "audio", "images", "thumbnail", "video"].map((kind) => [
+        runs: Object.fromEntries(stageKinds.map((kind) => [
             kind,
             (context) => runRevisionInvocation(execution, context, stageProviders(providers, context)),
         ])),

package/dist/slices/admission/model.js

@@ -1,6 +1,12 @@
 // The format is the kernel's: the image port asks for the same two aspects.
 export { formats } from "../../kernel/pipeline.js";
 // Generate, Provide or Off for most stages, plus the thumbnail's two Generate modes.
-// Article stays Generate or Provide; Video can be Generate or Off.
+// Article stays Generate or Provide; Video and Document can be Generate or Off.
 export const stageSources = ["generate", "provide", "off", "from_prompt", "prompt_by_llm"];
+export function sourceOf(sources, kind) {
+    return sources[kind] ?? "off";
+}
+// How each slideshow image moves while it is on screen: Zoom in and out, Pan across, a
+// Mix of both taking turns, or Still. `video/motion.ts` has the rules.
+export const motionStyles = ["zoom", "pan", "mixed", "still"];
 export const entryModes = ["text", "llm"];

package/dist/slices/admission/rules.js

@@ -1,4 +1,5 @@
 import { stageKinds } from "../../kernel/pipeline.js";
+import { sourceOf } from "./model.js";
 export const titleMax = 200;
 export const valueMax = 200;
 export const numberPerPromptMax = 20;
@@ -6,6 +7,41 @@ export const imagesPerRunMax = 60;
 // ceiling: the default gap is 3 s and nothing fixes an upper or lower bound, so the range
 // is this module's. A wider gap is a settings change, not a schema change.
 export const silenceGapSecondsMax = 30;
+// ceiling: the owner's numbers. A still held past ten minutes is a separate kind of video.
+export const imageSecondsMin = 1;
+export const imageSecondsMax = 600;
+export const defaultImageSeconds = 15;
+// ceiling: the same 30 s as the gap; half seconds are enough precision for a pause.
+export const edgeSilenceSecondsMax = 30;
+export const defaultEdgeSilenceSeconds = 2;
+// ceiling: past 50% the crop loses more of the picture than it shows.
+export const zoomPercentMax = 50;
+export const defaultZoomPercent = 22.5;
+export const defaultMotionStyle = "zoom";
+// The words Play, Edit project and the change preview use for each motion style.
+export const motionStyleLabels = {
+    zoom: "Zoom in and out",
+    pan: "Pan across",
+    mixed: "Mix of both",
+    still: "Still",
+};
+// Shared by admission, Play's draft conversion and Edit project, so all three say the same
+// sentence about the same value.
+export function imageSecondsProblem(value) {
+    return Number.isInteger(value) && value >= imageSecondsMin && value <= imageSecondsMax
+        ? undefined
+        : `Enter a whole number of seconds between ${imageSecondsMin} and ${imageSecondsMax}.`;
+}
+export function zoomPercentProblem(value) {
+    return Number.isInteger(value * 2) && value >= 0 && value <= zoomPercentMax
+        ? undefined
+        : `Enter a zoom between 0 and ${zoomPercentMax} percent, in steps of 0.5.`;
+}
+export function edgeSilenceSecondsProblem(value) {
+    return Number.isInteger(value * 2) && value >= 0 && value <= edgeSilenceSecondsMax
+        ? undefined
+        : `Enter a number of seconds between 0 and ${edgeSilenceSecondsMax}, in steps of 0.5.`;
+}
 // The legal source for each stage. Exported because Play's
 // source switches offer exactly these and nothing else, so the segmented control and the
 // refusal below it are the same list and a stage whose legal set changes cannot leave a
@@ -18,22 +54,23 @@ export const allowedSources = {
     images: ["off", "generate", "provide"],
     thumbnail: ["off", "from_prompt", "prompt_by_llm", "provide"],
     video: ["off", "generate"],
+    document: ["off", "generate"],
 };
 export function admit(input) {
     const fields = [];
     const draft = normaliseDraft(input.draft);
     const { sources } = draft;
     if (draft.title === "") {
-        fields.push({ field: "title", message: "A title is required." });
+        fields.push({ field: "title", message: "Enter a title for this video." });
     }
     else if (draft.title.length > titleMax) {
-        fields.push({ field: "title", message: `A title is at most ${titleMax} characters.` });
+        fields.push({ field: "title", message: `Keep the title to ${titleMax} characters or fewer.` });
     }
     for (const kind of stageKinds) {
-        if (!allowedSources[kind].includes(sources[kind])) {
+        if (!allowedSources[kind].includes(sourceOf(sources, kind))) {
             fields.push({
                 field: `sources.${kind}`,
-                message: `The ${kind} stage cannot be set to ${sources[kind]}.`,
+                message: `"${sourceOf(sources, kind)}" is not an option for ${kind}. Reload the page and choose again.`,
             });
         }
     }
@@ -43,9 +80,10 @@ export function admit(input) {
         sources.thumbnail === "prompt_by_llm" ||
         draft.intro?.mode === "llm" ||
         draft.outro?.mode === "llm" ||
-        usesNarrationPreparation(draft);
+        usesNarrationPreparation(draft) ||
+        usesYoutubeDescription(draft);
     if (needsLlm && !chosen(draft.llm)) {
-        fields.push({ field: "llm", message: "Pick an LLM provider and model." });
+        fields.push({ field: "llm", message: "Choose a text (LLM) provider and model." });
     }
     if (sources.article === "generate" && blank(draft.articlePrompt)) {
         fields.push({ field: "articlePrompt", message: "Pick an article prompt." });
@@ -54,10 +92,10 @@ export function admit(input) {
     fields.push(...narrationPreparationFields(draft));
     if (sources.audio === "generate") {
         if (voiced === undefined || !chosen(voiced)) {
-            fields.push({ field: "audio", message: "Pick a narration provider and model." });
+            fields.push({ field: "audio", message: "Choose a narration provider and model." });
         }
         else if (voiced.voice.trim() === "") {
-            fields.push({ field: "audio.voice", message: "Pick a voice." });
+            fields.push({ field: "audio.voice", message: "Choose a voice for the narration." });
         }
     }
     if (sources.images === "generate") {
@@ -67,15 +105,19 @@ export function admit(input) {
         sources.thumbnail === "from_prompt" ||
         sources.thumbnail === "prompt_by_llm") &&
         !chosen(draft.images)) {
-        fields.push({ field: "images", message: "Pick an image provider and model." });
+        fields.push({ field: "images", message: "Choose an image provider and model." });
     }
     if ((sources.thumbnail === "from_prompt" || sources.thumbnail === "prompt_by_llm") &&
         blank(draft.thumbnailPrompt)) {
         fields.push({ field: "thumbnailPrompt", message: "Pick a thumbnail prompt." });
     }
     if (sources.audio === "off" && draft.subtitles !== undefined && draft.subtitles.mode !== "off") {
-        fields.push({ field: "subtitles.mode", message: "Subtitles need narration audio." });
+        fields.push({
+            field: "subtitles.mode",
+            message: "Subtitles need narration. Turn narration on, or turn subtitles off.",
+        });
     }
+    fields.push(...youtubeDescriptionFields(draft));
     checkProvided(draft, input.staged, fields);
     checkValues(draft, input.requiredSlots, fields);
     if (!Number.isFinite(draft.silenceGapSeconds) ||
@@ -83,9 +125,19 @@ export function admit(input) {
         draft.silenceGapSeconds > silenceGapSecondsMax) {
         fields.push({
             field: "silenceGapSeconds",
-            message: `The silence gap is between 0 and ${silenceGapSecondsMax} seconds.`,
+            message: `Enter a silence gap between 0 and ${silenceGapSecondsMax} seconds.`,
         });
     }
+    // Checked only where they are used: a hidden control cannot hold up a run.
+    const imageProblem = sources.video === "generate" ? imageSecondsProblem(draft.imageSeconds) : undefined;
+    if (imageProblem !== undefined)
+        fields.push({ field: "imageSeconds", message: imageProblem });
+    const zoomProblem = sources.video === "generate" ? zoomPercentProblem(draft.zoomPercent) : undefined;
+    if (zoomProblem !== undefined)
+        fields.push({ field: "zoomPercent", message: zoomProblem });
+    const edgeProblem = sources.audio === "off" ? undefined : edgeSilenceSecondsProblem(draft.edgeSilenceSeconds);
+    if (edgeProblem !== undefined)
+        fields.push({ field: "edgeSilenceSeconds", message: edgeProblem });
     return fields.length === 0 ? { ok: true, draft } : { ok: false, fields };
 }
 // Research only feeds article writing, so a provided article hides it.
@@ -121,7 +173,10 @@ export function normaliseDraft(draft) {
 function checkImagePrompts(draft, fields) {
     if (draft.imagePrompts.length === 0) {
         // A run always has an image source.
-        fields.push({ field: "imagePrompts", message: "Tick at least one image prompt." });
+        fields.push({
+            field: "imagePrompts",
+            message: "Tick at least one image prompt, or turn images off.",
+        });
         return;
     }
     let total = 0;
@@ -135,14 +190,14 @@ function checkImagePrompts(draft, fields) {
             prompt.number > numberPerPromptMax) {
             fields.push({
                 field: `imagePrompts.${index}.number`,
-                message: `Number is between 1 and ${numberPerPromptMax}.`,
+                message: `Enter a whole number between 1 and ${numberPerPromptMax}.`,
             });
         }
     }
     if (total > imagesPerRunMax) {
         fields.push({
             field: "imagePrompts",
-            message: `A run makes at most ${imagesPerRunMax} images; this one asks for ${total}.`,
+            message: `A video can have at most ${imagesPerRunMax} images; these prompts ask for ${total}. Lower the numbers.`,
         });
     }
 }
@@ -168,11 +223,14 @@ function checkProvided(draft, staged, fields) {
         else if (ids.length > imagesPerRunMax) {
             fields.push({
                 field: "provided.images",
-                message: `A run holds at most ${imagesPerRunMax} images.`,
+                message: `A video can have at most ${imagesPerRunMax} images. Remove some.`,
             });
         }
         if (new Set(ids).size !== ids.length) {
-            fields.push({ field: "provided.images", message: "The same image was picked twice." });
+            fields.push({
+                field: "provided.images",
+                message: "The same image is picked twice. Remove the duplicate.",
+            });
         }
         for (const [index, id] of ids.entries()) {
             checkFile(staged, id, "images", `provided.images.${index}`, "Pick an image.", fields);
@@ -187,28 +245,31 @@ function checkFile(staged, id, kind, field, missing, fields) {
     }
     const file = staged.find((candidate) => candidate.id === id);
     if (file === undefined || file.stageKind !== kind) {
-        fields.push({ field, message: "That upload is no longer available; pick the file again." });
+        fields.push({ field, message: "That upload is no longer available. Choose the file again." });
         return;
     }
     if (file.state !== "staged") {
-        fields.push({ field, message: "This upload is still copying." });
+        fields.push({ field, message: "This file is still uploading. Wait for it to finish." });
     }
 }
 function checkValues(draft, requiredSlots, fields) {
     for (const name of requiredSlots) {
         const value = Object.hasOwn(draft.values, name) ? draft.values[name] : undefined;
         if (value === undefined || value === "") {
-            fields.push({ field: `values.${name}`, message: "This field is required." });
+            fields.push({ field: `values.${name}`, message: "Fill in this field." });
             continue;
         }
         if (value.length > valueMax) {
             fields.push({
                 field: `values.${name}`,
-                message: `A value is at most ${valueMax} characters.`,
+                message: `Keep this to ${valueMax} characters or fewer.`,
             });
         }
         if (/[\n\r]/.test(value)) {
-            fields.push({ field: `values.${name}`, message: "A value is a single line." });
+            fields.push({
+                field: `values.${name}`,
+                message: "Keep this to a single line, without line breaks.",
+            });
         }
     }
 }
@@ -224,7 +285,22 @@ export function narrationPreparationFields(draft) {
         ? [
             {
                 field: "narrationPrompt",
-                message: "Narration Preparation requires Inworld TTS-2. Choose that model or turn preparation Off.",
+                message: "Narration preparation only works with the Inworld TTS-2 model. Choose that model under Narration, or turn preparation Off.",
+            },
+        ]
+        : [];
+}
+// 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) {
+    return draft.youtubeDescription === true && draft.sources.audio !== "off";
+}
+export function youtubeDescriptionFields(draft) {
+    return draft.youtubeDescription === true && draft.sources.audio === "off"
+        ? [
+            {
+                field: "youtubeDescription",
+                message: "The YouTube description is timed from the narration. Turn narration on, or turn the YouTube description off.",
             },
         ]
         : [];

package/dist/slices/admission/schema.js

@@ -1,9 +1,11 @@
 import { z } from "zod";
 import { thinkingModes } from "../../kernel/ports/llm.js";
 import { checkpointStageSchema } from "../checkpoints/schema.js";
+import { documentThemes } from "../document/model.js";
 import { chunkModes } from "../narration/chunk.js";
 import { subtitleConfigSchema } from "../subtitles/model.js";
-import { entryModes, formats, stageSources } from "./model.js";
+import { entryModes, formats, motionStyles, stageSources } from "./model.js";
+import { defaultEdgeSilenceSeconds, defaultImageSeconds, defaultMotionStyle, defaultZoomPercent, } from "./rules.js";
 const providerChoice = z.object({
     provider: z.string(),
     model: z.string(),
@@ -21,8 +23,9 @@ export const runDraftSchema = z.object({
         .optional(),
     title: z.string(),
     format: z.enum(formats),
-    // Spelled out rather than built from stageKinds, so the inferred type carries the six
-    // keys and this schema stays assignable to the domain type without a cast.
+    // Spelled out rather than built from stageKinds, so the inferred type carries the
+    // keys and this schema stays assignable to the domain type without a cast. Document is
+    // optional: everything saved before it existed has no such key, and absent means Off.
     sources: z.object({
         research: z.enum(stageSources),
         article: z.enum(stageSources),
@@ -30,6 +33,7 @@ export const runDraftSchema = z.object({
         images: z.enum(stageSources),
         thumbnail: z.enum(stageSources),
         video: z.enum(stageSources),
+        document: z.enum(stageSources).optional(),
     }),
     llm: providerChoice.optional(),
     audio: providerChoice
@@ -60,7 +64,16 @@ export const runDraftSchema = z.object({
     })
         .optional(),
     silenceGapSeconds: z.number(),
+    // Defaulted rather than required, so a config, revision, draft review or backup saved
+    // before these existed still parses. The range is `rules.ts`'s, not the schema's.
+    imageSeconds: z.number().default(defaultImageSeconds),
+    zoomPercent: z.number().default(defaultZoomPercent),
+    motionStyle: z.enum(motionStyles).default(defaultMotionStyle),
+    edgeSilenceSeconds: z.number().default(defaultEdgeSilenceSeconds),
     subtitles: subtitleConfigSchema.optional(),
+    document: z.object({ theme: z.enum(documentThemes) }).optional(),
+    youtubeDescription: z.boolean().optional(),
+    descriptionPrompt: z.string().optional(),
 });
 export const runConfigSchema = runDraftSchema.extend({
     rendered: z.record(z.string(), z.string()),

package/dist/slices/admission/start.js

@@ -5,6 +5,7 @@ import { admitInitialRevision } from "../rebuild/runtime-admission.js";
 import { adoptBaseline } from "../revisions/adopt.js";
 import { attachStagedFile, storeText } from "../storage/staging.js";
 import { releaseStagedFile } from "../storage/staging-refs.js";
+import { sourceOf, } from "./model.js";
 import { insertProject, insertStage } from "./repo.js";
 // Provide → `provided` with its output attached; Off → `skipped`;
 // everything else → `pending`.
@@ -32,10 +33,10 @@ export function startRun(deps, draft, rendered, retainStaged = false, templates)
         id: deps.ids.next(),
         projectId: id,
         kind,
-        source: draft.sources[kind],
+        source: sourceOf(draft.sources, kind),
         state: kind === "video" && draft.sources.video === "off" && draft.sources.audio !== "off"
             ? "pending"
-            : initialState(draft.sources[kind]),
+            : initialState(sourceOf(draft.sources, kind)),
         failureReason: null,
         attemptCount: 0,
         progressCurrent: null,

package/dist/slices/article/continuation.js

@@ -81,7 +81,9 @@ function truncated(answer) {
 }
 // Empty response → failed attempt.
 function written(answer) {
-    return answer.text.trim() === "" ? "the article answered with nothing" : undefined;
+    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."
+        : undefined;
 }
 function finished(answer) {
     const empty = written(answer);
@@ -89,6 +91,6 @@ function finished(answer) {
         return empty;
     }
     return truncated(answer)
-        ? `the article was still unfinished after ${String(continuationLimit)} continuations`
+        ? `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.`
         : undefined;
 }

package/dist/slices/article/plain.js

@@ -7,11 +7,11 @@ export function plainText(markdown) {
     const paragraphs = tree.children
         .map((node) => {
         if (node.type !== "paragraph")
-            throw new Error("Expected stripped prose paragraphs.");
+            throw new Error("Slopify hit an internal error (the article couldn't be turned into plain text). Try again; if it happens again, use Download diagnostics in Settings and report it.");
         return node.children
             .map((child) => {
             if (child.type !== "text")
-                throw new Error("Expected stripped prose text.");
+                throw new Error("Slopify hit an internal error (the article couldn't be turned into plain text). Try again; if it happens again, use Download diagnostics in Settings and report it.");
             return child.value;
         })
             .join("");