@gentbajko/slopify 2.0.2 → 2.1.0

package/dist/slices/schedules/repo.js

@@ -15,6 +15,8 @@ const rowSchema = z.object({
     overlap_policy: z.string(),
     spend_limit_cents: z.number().nullable(),
     items_json: z.string(),
+    topic_keyword: z.string().nullable(),
+    values_json: z.string(),
     status: z.string(),
     version: z.number(),
     next_run_at: z.string().nullable(),
@@ -25,7 +27,7 @@ const rowSchema = z.object({
 export function scheduleById(db, id) {
     const row = db
         .prepare(`SELECT id,name,template_id,template_version,cadence_json,timezone,missed_policy,
-       overlap_policy,spend_limit_cents,items_json,status,version,next_run_at,created_at,updated_at,
+       overlap_policy,spend_limit_cents,items_json,topic_keyword,values_json,status,version,next_run_at,created_at,updated_at,
        deleted_at
        FROM schedules WHERE id=?`)
         .get(id);
@@ -34,7 +36,7 @@ export function scheduleById(db, id) {
 export function scheduleRows(db) {
     return db
         .prepare(`SELECT id,name,template_id,template_version,cadence_json,timezone,missed_policy,
-       overlap_policy,spend_limit_cents,items_json,status,version,next_run_at,created_at,updated_at,
+       overlap_policy,spend_limit_cents,items_json,topic_keyword,values_json,status,version,next_run_at,created_at,updated_at,
        deleted_at
        FROM schedules ORDER BY created_at DESC,id`)
         .all()
@@ -43,7 +45,7 @@ export function scheduleRows(db) {
 export function dueSchedules(db, now) {
     return db
         .prepare(`SELECT id,name,template_id,template_version,cadence_json,timezone,missed_policy,
-       overlap_policy,spend_limit_cents,items_json,status,version,next_run_at,created_at,updated_at,
+       overlap_policy,spend_limit_cents,items_json,topic_keyword,values_json,status,version,next_run_at,created_at,updated_at,
        deleted_at
        FROM schedules WHERE deleted_at IS NULL AND status='active' AND next_run_at IS NOT NULL
        AND next_run_at <= ?
@@ -54,17 +56,18 @@ export function dueSchedules(db, now) {
 export function insertSchedule(db, schedule, creationHash) {
     db.prepare(`INSERT INTO schedules
       (id,name,template_id,template_version,cadence_json,timezone,missed_policy,overlap_policy,
-       spend_limit_cents,items_json,status,version,creation_hash,next_run_at,created_at,updated_at,
-       deleted_at)
-     VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`).run(schedule.id, schedule.name, schedule.templateId, schedule.templateVersion, JSON.stringify(schedule.cadence), schedule.timezone, schedule.missedPolicy, schedule.overlapPolicy, schedule.spendLimitCents, JSON.stringify(schedule.items), schedule.status, schedule.version, creationHash, schedule.nextRunAt, schedule.createdAt, schedule.updatedAt, schedule.deletedAt);
+       spend_limit_cents,items_json,topic_keyword,values_json,status,version,creation_hash,
+       next_run_at,created_at,updated_at,deleted_at)
+     VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`).run(schedule.id, schedule.name, schedule.templateId, schedule.templateVersion, JSON.stringify(schedule.cadence), schedule.timezone, schedule.missedPolicy, schedule.overlapPolicy, schedule.spendLimitCents, JSON.stringify(schedule.items), schedule.topicKeyword, JSON.stringify(schedule.values), schedule.status, schedule.version, creationHash, schedule.nextRunAt, schedule.createdAt, schedule.updatedAt, schedule.deletedAt);
 }
 export function updateScheduleRow(db, schedule, mutationId, mutationHash, baseVersion) {
     const changed = db
         .prepare(`UPDATE schedules SET name=?,template_id=?,template_version=?,cadence_json=?,timezone=?,
-       missed_policy=?,overlap_policy=?,spend_limit_cents=?,items_json=?,status=?,version=?,
+       missed_policy=?,overlap_policy=?,spend_limit_cents=?,items_json=?,topic_keyword=?,
+       values_json=?,status=?,version=?,
        next_run_at=?,updated_at=?,mutation_id=?,mutation_hash=?
        WHERE id=? AND version=? AND deleted_at IS NULL`)
-        .run(schedule.name, schedule.templateId, schedule.templateVersion, JSON.stringify(schedule.cadence), schedule.timezone, schedule.missedPolicy, schedule.overlapPolicy, schedule.spendLimitCents, JSON.stringify(schedule.items), schedule.status, schedule.version, schedule.nextRunAt, schedule.updatedAt, mutationId, mutationHash, schedule.id, baseVersion);
+        .run(schedule.name, schedule.templateId, schedule.templateVersion, JSON.stringify(schedule.cadence), schedule.timezone, schedule.missedPolicy, schedule.overlapPolicy, schedule.spendLimitCents, JSON.stringify(schedule.items), schedule.topicKeyword, JSON.stringify(schedule.values), schedule.status, schedule.version, schedule.nextRunAt, schedule.updatedAt, mutationId, mutationHash, schedule.id, baseVersion);
     return Number(changed.changes) === 1;
 }
 export function tombstoneScheduleRow(db, id, version, deletedAt) {
@@ -108,8 +111,14 @@ export function recordRunStartIdentity(db, run) {
     if (Number(changed.changes) !== 1)
         throw new Error("The scheduled run could not persist its Start identity.");
 }
-export function recordRunDispatch(db, run, recordedAt) {
+// `used` is the queued topic the run started, removed in the same transaction that records
+// the run's projects. It is matched by value rather than position, so an edit saved while the
+// run was starting cannot make it remove a different topic. The run that empties the queue
+// completes the schedule.
+export function recordRunDispatch(db, run, recordedAt, used) {
     transact(db, () => {
+        if (used !== undefined)
+            consumeTopic(db, run.scheduleId, used, recordedAt);
         const changed = db
             .prepare(`UPDATE schedule_runs SET request_id=?,project_ids_json=?,estimate_json=?
          WHERE id=? AND status='running'`)
@@ -120,6 +129,19 @@ export function recordRunDispatch(db, run, recordedAt) {
             settleScheduleRunsForProject(db, projectId, recordedAt);
     });
 }
+function consumeTopic(db, scheduleId, used, updatedAt) {
+    const schedule = scheduleById(db, scheduleId);
+    if (schedule === undefined || schedule.deletedAt !== null)
+        return;
+    const key = JSON.stringify(used);
+    const at = schedule.items.findIndex((item) => JSON.stringify(item) === key);
+    if (at === -1)
+        return;
+    const items = schedule.items.filter((_item, index) => index !== at);
+    const done = items.length === 0 && (schedule.status === "active" || schedule.status === "paused");
+    db.prepare(`UPDATE schedules SET items_json=?,status=?,next_run_at=?,version=version+1,updated_at=?
+     WHERE id=? AND deleted_at IS NULL`).run(JSON.stringify(items), done ? "completed" : schedule.status, done ? null : schedule.nextRunAt, updatedAt, scheduleId);
+}
 export function runsForSchedule(db, scheduleId) {
     return db
         .prepare(`SELECT id,schedule_id,scheduled_for,status,request_id,project_ids_json,estimate_json,
@@ -200,7 +222,7 @@ function projectIsActive(db, projectId) {
     const state = derive(stagesOf(db, projectId), projectPaused(db, projectId));
     return state !== "done" && state !== "failed" && state !== "canceled";
 }
-export function recoverRunningRuns(db, endedAt, error = "The app stopped while this scheduled run was active.") {
+export function recoverRunningRuns(db, endedAt, error = "Slopify was closed while this run was in progress. Check its video in Projects; the next run will go ahead as planned.") {
     return transact(db, () => {
         const pending = db
             .prepare(`SELECT id,request_id FROM schedule_runs
@@ -243,6 +265,8 @@ function parseSchedule(row) {
         overlapPolicy: value.overlap_policy,
         spendLimitCents: value.spend_limit_cents,
         items: JSON.parse(value.items_json),
+        topicKeyword: value.topic_keyword,
+        values: JSON.parse(value.values_json),
         status: value.status,
         version: value.version,
         nextRunAt: value.next_run_at,
@@ -276,6 +300,26 @@ function parseRun(row) {
         estimate: value.estimate_json === null ? null : JSON.parse(value.estimate_json),
         startedAt: value.started_at,
         endedAt: value.ended_at,
-        error: value.error,
+        error: value.error === null ? null : runErrorText(value.error),
     });
 }
+// A failed dispatch records the refusal's reason code; the run history shows the sentence.
+// Mapped on read so runs recorded before these sentences existed read the same way.
+const internalRunError = "Slopify hit an internal error while starting this run. The next run will try again; if it keeps happening, use Download diagnostics in Settings and report it.";
+const runErrors = {
+    "missing-template": "The template this schedule uses was deleted or changed. Edit the schedule and choose a template again.",
+    "unsupported-media": "This template uses audio, images or a thumbnail you supplied, which scheduled runs cannot use. Pick a template that generates these instead.",
+    "spend-limit": "Not started: the estimated cost was above this schedule's spend limit, or some prices were unknown. Raise the spend limit or choose models with known prices.",
+    readiness: "Not started: a provider was not ready, for example a missing API key, model or voice. Check Settings → Providers; the next run will try again.",
+    "not-found": "The template's settings are no longer valid, for example a prompt or voice it uses was deleted. Fix the template in Library > Templates and save it.",
+    "invalid-draft": "The template's settings are no longer valid, for example a prompt or voice it uses was deleted. Fix the template in Library > Templates and save it.",
+    "invalid-edit": "The template's settings are no longer valid, for example a prompt or voice it uses was deleted. Fix the template in Library > Templates and save it.",
+    conflict: internalRunError,
+    "pending-start": internalRunError,
+    "already-started": internalRunError,
+    "stale-review": internalRunError,
+    "The scheduled run failed.": internalRunError,
+};
+function runErrorText(error) {
+    return Object.hasOwn(runErrors, error) ? (runErrors[error] ?? error) : error;
+}

package/dist/slices/schedules/scheduler.js

@@ -1,4 +1,5 @@
 import { transact } from "../../kernel/db/tx.js";
+import { render } from "../admission/substitute.js";
 import { reviewDraft } from "../play-drafts/review.js";
 import { createDraft } from "../play-drafts/service.js";
 import { startPlayDraft } from "../play-drafts/start.js";
@@ -59,8 +60,8 @@ function claim(deps, schedule, now) {
             endedAt: skip ? now.toISOString() : null,
             error: skip
                 ? overlapping
-                    ? "Skipped because another occurrence is still running."
-                    : "Skipped because the app missed this occurrence."
+                    ? "Skipped because the previous run of this schedule was still going."
+                    : "Skipped because Slopify was not running at the scheduled time."
                 : null,
         };
         if (!insertRun(deps.db, run))
@@ -81,13 +82,11 @@ async function execute(deps, claimed) {
             id: claimed.schedule.templateId,
             version: claimed.schedule.templateVersion,
         });
+        const topic = claimed.schedule.items[0];
         const fresh = {
             ...document,
-            variants: claimed.schedule.items.map((item) => ({
-                id: deps.uuid(),
-                title: item.title,
-                values: item.values,
-            })),
+            form: runForm(document.form, claimed.schedule, topic),
+            variants: [],
         };
         const draft = createDraft(deps, { id: deps.uuid(), document: fresh });
         if (!draft.ok)
@@ -118,7 +117,7 @@ async function execute(deps, claimed) {
             requestId: started.value.requestId,
             projectIds: started.value.projectIds,
         };
-        recordRunDispatch(deps.db, run, deps.clock.now().toISOString());
+        recordRunDispatch(deps.db, run, deps.clock.now().toISOString(), topic);
         run = {
             ...run,
             status: "succeeded",
@@ -135,6 +134,24 @@ async function execute(deps, claimed) {
     }
     updateRun(deps.db, run);
 }
+// One project per run. The first queued topic fills the chosen keyword, the schedule's fixed
+// values fill the rest over the template's own, and the template's title is filled from the
+// same keywords, so "D&D Lore: {{Topic}}" names the project after the topic. A topic saved
+// before topics had a keyword brings its own title and values instead.
+function runForm(form, schedule, topic) {
+    const values = {
+        ...form.values,
+        ...schedule.values,
+        ...(topic?.values ?? {}),
+        ...(topic !== undefined && schedule.topicKeyword !== null
+            ? { [schedule.topicKeyword]: topic.title }
+            : {}),
+    };
+    const title = topic !== undefined && schedule.topicKeyword === null
+        ? topic.title
+        : render(form.title, values);
+    return { ...form, title, values };
+}
 class ScheduleDispatchError extends Error {
     reason;
     constructor(reason) {

package/dist/slices/schedules/schema.js

@@ -5,15 +5,20 @@ const keywordName = z
     .string()
     .min(1)
     .max(200)
-    .refine((value) => value === value.trim(), "Keyword names cannot start or end with spaces.");
+    .refine((value) => value === value.trim(), "Remove the spaces at the start or end of the keyword name.");
+const values = z.record(keywordName, z.string().max(10000)).readonly();
+// A queued topic. Each run takes the first one and removes it once its project starts.
+// `values` is only filled on schedules saved before topics had one keyword.
 const item = z
     .object({
     title: z.string().trim().min(1).max(200),
-    values: z.record(keywordName, z.string().max(10000)).readonly(),
+    values,
 })
     .strict()
     .readonly();
 const policy = z.enum(["skip", "run-once"]);
+// Enough for a year of daily runs, pasted as one list.
+export const queueMax = 500;
 export const scheduleCreateSchema = z
     .object({
     id,
@@ -21,11 +26,19 @@ export const scheduleCreateSchema = z
     templateId: id,
     templateVersion: z.number().int().positive(),
     cadence: cadenceSchema,
-    timezone: z.string().min(1).max(100).refine(validTimeZone, "Choose a valid IANA timezone."),
+    timezone: z
+        .string()
+        .min(1)
+        .max(100)
+        .refine(validTimeZone, "Choose a time zone from the list, such as Europe/London."),
     missedPolicy: policy.default("skip"),
     overlapPolicy: z.literal("skip").default("skip"),
     spendLimitCents: z.number().int().nonnegative().nullable().default(null),
-    items: z.array(item).max(49).default([]).readonly(),
+    items: z.array(item).max(queueMax).default([]).readonly(),
+    // The template keyword each queued topic fills, such as "Topic".
+    topicKeyword: keywordName.nullable().default(null),
+    // Keywords every run uses as they are, such as the word counts.
+    values: values.default({}),
 })
     .strict()
     .readonly();
@@ -54,6 +67,8 @@ export const scheduleSummarySchema = z
     overlapPolicy: z.literal("skip"),
     spendLimitCents: z.number().int().nonnegative().nullable(),
     items: z.array(item).readonly(),
+    topicKeyword: z.string().nullable().default(null),
+    values: values.default({}),
     status: z.enum(["active", "paused", "completed", "canceled"]),
     version: z.number().int().positive(),
     nextRunAt: z.string().datetime({ offset: true }).nullable(),

package/dist/slices/schedules/service.js

@@ -168,6 +168,8 @@ function summary(input, nextRunAt, now, status = "active", version = 1) {
         overlapPolicy: input.overlapPolicy,
         spendLimitCents: input.spendLimitCents,
         items: input.items,
+        topicKeyword: input.topicKeyword,
+        values: input.values,
         status,
         version,
         nextRunAt,

package/dist/slices/settings/cli-paths.js

@@ -37,7 +37,7 @@ export async function saveCliPath(deps, id, raw) {
     if (deps.hostCliStatus)
         return {
             ok: false,
-            message: "CLI paths are managed on the host. Rerun the Docker launcher after changing installations.",
+            message: "Slopify runs in Docker, so it finds these tools on your computer (the Docker host) by itself. If you installed or moved one, run the Slopify Docker launcher again.",
         };
     // A slow version probe must not overwrite a later Save or Reset from another tab.
     let queue = saves.get(deps.db);
@@ -66,13 +66,16 @@ async function save(deps, id, raw) {
     if (!parsed.success)
         return {
             ok: false,
-            message: "Enter an absolute executable file path without quotes or arguments, or leave it blank to use PATH.",
+            message: "Enter the full path to the program file, without quotes or extra options, or leave it blank to let Slopify find it.",
         };
     const configured = parsed.data === "" ? null : parsed.data;
     if (configured !== null) {
         try {
             if (!(await stat(configured)).isFile())
-                return { ok: false, message: "Choose an executable file, not a directory." };
+                return {
+                    ok: false,
+                    message: "This path is a folder. Enter the path to the program file inside it.",
+                };
             await access(configured, process.platform === "win32" ||
                 [".js", ".mjs", ".cjs"].includes(extname(configured).toLowerCase())
                 ? constants.R_OK
@@ -84,7 +87,7 @@ async function save(deps, id, raw) {
                 ["ENOENT", "ENOTDIR", "EACCES", "EPERM", "ELOOP"].includes(String(error.code)))
                 return {
                     ok: false,
-                    message: "That executable file cannot be found or run. Check its path and permissions.",
+                    message: "Slopify cannot find or run a program at this path. Check the path is correct and the file is allowed to run.",
                 };
             throw error;
         }

package/dist/slices/settings/models.js

@@ -42,11 +42,11 @@ export function createModelCatalog(deps) {
                     allowsCustom: allowsCustomModel(provider),
                     warning: local
                         ? provider === "codex-image"
-                            ? "Could not check the Codex image capability. Refresh after checking the CLI."
-                            : "Could not discover models from this CLI. Enter an exact model ID manually or refresh."
+                            ? "Slopify could not check whether Codex CLI can make images. Make sure Codex CLI is installed and signed in, then refresh the list."
+                            : "Slopify could not get the model list from this command-line tool. Check it is installed and signed in, then refresh the list, or type an exact model ID manually."
                         : saved === undefined
-                            ? "Could not load the model list. Showing bundled choices; refresh to try again."
-                            : "Could not refresh the model list. Showing the last loaded choices.",
+                            ? "Slopify could not load this provider's model list, so it is showing its built-in choices. Check your internet connection and API key, then refresh the list."
+                            : "Slopify could not update this provider's model list, so it is showing the last loaded list. Check your internet connection and API key, then refresh again.",
                 };
                 lifetime = retryMs;
             }

package/dist/slices/settings/playback.js

@@ -19,11 +19,11 @@ export function saveSettings(deps, settings) {
     if (!silenceGapValue.safeParse(settings.silenceGapSeconds).success) {
         fields.push({
             field: "silenceGapSeconds",
-            message: `The silence gap is a whole number of seconds between 0 and ${String(silenceGapSecondsMax)}.`,
+            message: `Enter a whole number of seconds between 0 and ${String(silenceGapSecondsMax)}.`,
         });
     }
     if (!appearanceValue.safeParse(settings.appearance).success) {
-        fields.push({ field: "appearance", message: "Pick System, Light or Dark." });
+        fields.push({ field: "appearance", message: "Choose System, Light or Dark." });
     }
     if (fields.length > 0) {
         return { ok: false, fields };

package/dist/slices/storage/assets.js

@@ -10,7 +10,7 @@ export function allocateAsset(deps, projectId, filename) {
     const absolutePath = outputPath(deps.paths, projectId, path);
     const directory = outputPath(deps.paths, projectId, `assets/${id}`);
     if (dirname(absolutePath) !== directory)
-        throw new Error("Asset filenames must be basenames.");
+        throw new Error("Slopify hit an internal error (a file name to save is not a plain file name). Try again; if it happens again, use Download diagnostics in Settings and report it.");
     mkdirSync(outputPath(deps.paths, projectId, "assets"), { recursive: true, mode: 0o700 });
     mkdirSync(directory, { mode: 0o700 });
     return { id, projectId, path, absolutePath };
@@ -20,7 +20,7 @@ export function sealAsset(deps, pending) {
     try {
         const stats = fstatSync(file);
         if (!stats.isFile())
-            throw new Error("An asset must be a regular file.");
+            throw new Error("Slopify hit an internal error (a saved file is not a regular file). Try again; if it happens again, use Download diagnostics in Settings and report it.");
         fchmodSync(file, 0o600);
         fsyncSync(file);
         return {
@@ -58,7 +58,7 @@ export function discardPreparedAssets(deps, assets) {
             const filename = basename(asset.path);
             requireBasename(filename);
             if (asset.path !== `assets/${asset.id}/${filename}`) {
-                throw new Error("A prepared asset must belong to its allocated directory.");
+                throw new Error("Slopify hit an internal error (a prepared file is not in its allocated directory). Try again; if it happens again, use Download diagnostics in Settings and report it.");
             }
             const directory = outputPath(deps.paths, asset.projectId, `assets/${asset.id}`);
             const registered = deps.db
@@ -68,7 +68,7 @@ export function discardPreparedAssets(deps, assets) {
                 if (row.id === asset.id)
                     return true;
                 if (typeof row.path !== "string")
-                    throw new Error("A registered asset must name a path.");
+                    throw new Error("Slopify hit an internal error (a saved file has no path). Try again; if it happens again, use Download diagnostics in Settings and report it.");
                 const inside = relative(directory, outputPath(deps.paths, asset.projectId, row.path));
                 return (inside === "" ||
                     (inside !== ".." && !inside.startsWith(`..${sep}`) && !isAbsolute(inside)));
@@ -92,7 +92,7 @@ function requireBasename(filename) {
         }) ||
         /[. ]$/.test(filename) ||
         /^(?:con|prn|aux|nul|conin\$|conout\$|com[1-9¹²³]|lpt[1-9¹²³])(?:\.|$)/i.test(filename))
-        throw new Error("Asset filenames must be portable basenames.");
+        throw new Error("Slopify hit an internal error (a file name to save is not allowed on every system). Try again; if it happens again, use Download diagnostics in Settings and report it.");
 }
 function messageOf(error) {
     return error instanceof Error ? error.message : String(error);

package/dist/slices/storage/downloads.js

@@ -19,6 +19,7 @@ const contentTypes = {
     ".ogg": "audio/ogg",
     ".opus": "audio/opus",
     ".mp4": "video/mp4",
+    ".pdf": "application/pdf",
     ".srt": "application/x-subrip; charset=utf-8",
     ".vtt": "text/vtt; charset=utf-8",
 };

package/dist/slices/storage/layout.js

@@ -14,7 +14,7 @@ function contained(root, path) {
     const target = resolve(root, path);
     const inside = relative(root, target);
     if (inside === "" || inside.startsWith("..") || isAbsolute(inside)) {
-        throw new Error(`${path} resolves outside ${root}`);
+        throw new Error(`Slopify hit an internal error (the saved file path ${path} resolves outside ${root}). Try again; if it happens again, use Download diagnostics in Settings and report it.`);
     }
     return target;
 }
@@ -54,6 +54,12 @@ export function outputFileName(role, index, extension, stageKind) {
             return `instructions-${stageKind}.txt`;
         case "video":
             return "video.mp4";
+        case "document_pdf":
+            return "document.pdf";
+        case "youtube_description":
+            return "description.txt";
+        case "youtube_tags":
+            return "tags.txt";
         case "audio_body":
             return `audio-body${extension}`;
         case "audio_export":

package/dist/slices/storage/model.js

@@ -24,5 +24,8 @@ export const outputRoles = [
     "subtitle_ass",
     "subtitle_font",
     "instructions",
+    "document_pdf",
+    "youtube_description",
+    "youtube_tags",
 ];
 export const stagedFileStates = ["copying", "staged"];

package/dist/slices/subtitles/captions.js

@@ -21,7 +21,7 @@ export function captionCues(words) {
             !Number.isFinite(word.end) ||
             word.start < previousEnd - 0.001 ||
             word.end <= word.start) {
-            throw new Error("The subtitle word timing is invalid; regenerate alignment.");
+            throw new Error("The saved caption timing is damaged. Use Re-run section on Video to time them again, then Retry stage.");
         }
         const first = pending[0];
         if (first !== undefined &&

package/dist/slices/subtitles/prepare.js

@@ -7,6 +7,7 @@ import { projectById, setStageProgress } from "../admission/repo.js";
 import { resolveFont } from "../fonts/index.js";
 import { outputPath, projectDir } from "../storage/layout.js";
 import { outputsOf } from "../storage/repo.js";
+import { spoken } from "../video/plan.js";
 import { captionCues, serializeAss, serializeSrt, serializeVtt } from "./captions.js";
 import { defaultSubtitles } from "./model.js";
 import { spokenText } from "./transcript.js";
@@ -43,7 +44,7 @@ export async function prepareSubtitles(deps, context, audio, frame) {
     const { projectId } = context.stage;
     const project = projectById(deps.db, projectId);
     if (project === undefined)
-        throw new Error("The project no longer exists.");
+        throw new Error("This project no longer exists; it may have been deleted while it was running.");
     const config = project.config.subtitles ?? defaultSubtitles;
     if (config.mode === "off")
         return undefined;
@@ -51,11 +52,11 @@ export async function prepareSubtitles(deps, context, audio, frame) {
     setStageProgress(deps.db, context.stage.id, 0, 100);
     context.emit({ type: "stage.progress", projectId, stage: "video", current: 0, total: 100 });
     if (audio.length === 0)
-        throw new Error("Subtitles need narration audio.");
+        throw new Error("Captions need narration audio, but this project has none. Turn captions off in Edit project → Subtitles, or turn narration on, then Retry stage.");
     const outputs = outputsOf(deps.db, projectId);
     const segments = audio.map((segment) => ({
         ...segment,
-        text: segment.kind === "gap" ? "" : spokenText(deps, projectId, segment.kind, outputs),
+        text: spoken(segment.kind) ? spokenText(deps, projectId, segment.kind, outputs) : "",
     }));
     const key = await timingKey(segments, context.signal);
     const cache = readCache(deps, projectId, outputs);
@@ -68,7 +69,7 @@ export async function prepareSubtitles(deps, context, audio, frame) {
         context.signal.throwIfAborted();
         const cues = captionCues(words);
         if (cues.length === 0)
-            throw new Error("No spoken words could be aligned. Check that the English article matches the audio.");
+            throw new Error("None of the narration could be matched to the article text, so captions can't be timed. Captions only work for English narration; if you uploaded your own audio, make sure it reads the article text, then Retry stage.");
         writeFileSync(join(directory, "subtitles.srt"), serializeSrt(cues), { mode: 0o600 });
         writeFileSync(join(directory, "subtitles.vtt"), serializeVtt(cues), { mode: 0o600 });
         writeFileSync(join(directory, "subtitles.ass"), serializeAss(cues, {
@@ -118,7 +119,7 @@ async function timingKey(segments, signal) {
 }
 async function alignSegments(deps, context, segments, omissions) {
     if (deps.alignSubtitles === undefined)
-        throw new Error("Local subtitle alignment is unavailable in this build.");
+        throw new Error("Slopify hit an internal error (the caption timing tool is missing from this build). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     const words = [];
     const total = segments.reduce((sum, segment) => sum + segment.seconds, 0);
     let offset = 0;
@@ -146,7 +147,7 @@ async function alignSegments(deps, context, segments, omissions) {
             });
             for (const word of aligned) {
                 if (word.end > segment.seconds + 0.1)
-                    throw new Error("Subtitle timing exceeds the narration duration.");
+                    throw new Error("Caption timing came out longer than the narration audio. Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
                 words.push({
                     ...word,
                     start: word.start + offset,

package/dist/slices/subtitles/transcript.js

@@ -27,7 +27,7 @@ export function spokenText(deps, projectId, kind, outputs) {
                 return segment.text;
         }
     }
-    throw new Error(`The saved ${kind} narration text is missing. Subtitles need the text spoken in the audio.`);
+    throw new Error(`The saved text of the ${kind === "body" ? "article" : kind} is missing, and captions need the text spoken in the narration. Use Re-run section on Article, then Retry stage.`);
 }
 function payload(raw) {
     return textPayload.parse(JSON.parse(raw ?? "null"));

package/dist/slices/telemetry/model.js

@@ -3,7 +3,7 @@ import { stageKinds } from "../../kernel/pipeline.js";
 // One install event, one per project created, one per stage completing.
 export const telemetryEventTypes = ["install", "project.created", "stage.completed"];
 // Counting is finer than a stage: one event per research, article, intro/outro text, audio
-// segment (body, intro, outro), images, thumbnail and video. The three that are not whole
+// segment (body, intro, outro), images, thumbnail, video and document. The three that are not whole
 // stages are named by `segment` beside the stage that produced them - the article stage
 // writes the intro and outro texts, the audio stage narrates all three - so the event type
 // stays `stage.completed` and the pair (stage, segment) says which unit it is.

package/dist/slices/thumbnail/run.js

@@ -16,19 +16,19 @@ export async function runThumbnail(deps, context, providers) {
     const { projectId } = context.stage;
     const project = projectById(deps.db, projectId);
     if (project === undefined) {
-        throw new Error(`project ${projectId} has no row`);
+        throw new Error("This project no longer exists; it may have been deleted while it was running.");
     }
     const source = project.config.sources.thumbnail;
     if (source !== "from_prompt" && source !== "prompt_by_llm") {
         // Off is `skipped` and Provide is `provided` at project creation,
         // so the runner never starts this stage for either.
-        throw new Error(`the thumbnail stage cannot run with its source set to ${source}`);
+        throw new Error(`Slopify hit an internal error (the thumbnail stage cannot run with its source set to ${source}). Retry stage; if it happens again, use Download diagnostics in Settings and report it.`);
     }
     const choice = project.config.images;
     if (choice === undefined) {
         // Admission requires the image provider whenever the thumbnail is generated, so reaching
         // here is a bug in admission rather than the user's.
-        throw new Error("the run has no image provider or model");
+        throw new Error("No image model is set for the thumbnail. Choose one in Edit project → Providers, then Retry stage.");
     }
     const result = source === "from_prompt" ? undefined : await byLlm(deps, context, providers, project);
     if (result !== undefined && !result.ok)
@@ -60,7 +60,7 @@ export async function runThumbnail(deps, context, providers) {
 function fromTemplate(project) {
     const rendered = project.config.rendered.thumbnailPrompt;
     if (rendered === undefined) {
-        throw new Error("the run has no rendered thumbnail prompt");
+        throw new Error("Slopify hit an internal error (the thumbnail prompt was never filled in). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return rendered;
 }
@@ -83,7 +83,7 @@ async function byLlm(deps, context, providers, project) {
     }
     if (llm === undefined) {
         // Admission requires the LLM row when the thumbnail source is Prompt by LLM.
-        throw new Error("the run has no LLM provider or model");
+        throw new Error("No AI model is set for writing the thumbnail prompt. Choose one in Edit project → Providers, then Retry stage.");
     }
     const messages = thumbnailMessages(brief(deps, project));
     const answer = await providers.llm({
@@ -117,7 +117,7 @@ function named(choice) {
 function brief(deps, project) {
     const instruction = project.config.rendered.thumbnailPrompt;
     if (instruction === undefined) {
-        throw new Error("the run has no rendered thumbnail prompt");
+        throw new Error("Slopify hit an internal error (the thumbnail prompt was never filled in). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return {
         instruction,
@@ -133,7 +133,7 @@ function brief(deps, project) {
 function articleText(deps, projectId) {
     const article = outputsOf(deps.db, projectId).find((output) => output.role === "article_txt");
     if (article === undefined) {
-        throw new Error("the project has no article for the thumbnail prompt to be written from");
+        throw new Error("The thumbnail prompt is written from the article, but the article isn't ready. Let the Article stage finish, then Retry stage.");
     }
     return readFileSync(outputPath(deps.paths, projectId, article.path), "utf8");
 }
@@ -212,7 +212,7 @@ function instructionsText(messages) {
 }
 function payloadOf(piece) {
     if (piece.payload === null) {
-        throw new Error(`the written thumbnail prompt ${piece.id} has no payload`);
+        throw new Error("Slopify hit an internal error (the saved thumbnail prompt is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return writtenPayload.parse(JSON.parse(piece.payload));
 }

package/dist/slices/video/audio-export.js

@@ -6,17 +6,18 @@ import { outputsOf } from "../storage/repo.js";
 import { prepareSubtitles } from "../subtitles/prepare.js";
 import { audioExportArgs } from "./audio-export-args.js";
 import { audioInputs } from "./audio-inputs.js";
+import { runFfmpeg } from "./ffmpeg.js";
 import { audioTimeline } from "./plan.js";
 import { reusableAudioExport } from "./reuse-audio.js";
 import { writeExport } from "./write-export.js";
 import { writeSubtitles } from "./write-subtitles.js";
 export { audioExportArgs } from "./audio-export-args.js";
 const rate = 48000;
-export async function exportAudioWav(deps, context, gapSeconds) {
+export async function exportAudioWav(deps, context, gapSeconds, edgeSeconds) {
     const { projectId } = context.stage;
     const outputs = outputsOf(deps.db, projectId);
     const input = await audioInputs(deps, projectId, outputs, context.signal);
-    const audio = audioTimeline({ ...input, gapSeconds }, 1 / rate);
+    const audio = audioTimeline({ ...input, gapSeconds, edgeSeconds }, 1 / rate);
     const totalSeconds = audio.reduce((sum, segment) => sum + segment.seconds, 0);
     const dir = projectDir(deps.paths, projectId);
     const sources = outputs.filter((output) => ["audio_body", "audio_intro", "audio_outro"].includes(output.role));
@@ -25,6 +26,7 @@ export async function exportAudioWav(deps, context, gapSeconds) {
         channels: 2,
         codec: "pcm_s16le",
         gapSeconds,
+        edgeSeconds,
         totalSeconds,
         audio: audio.map((segment) => ({
             ...segment,
@@ -52,6 +54,12 @@ export async function exportAudioWav(deps, context, gapSeconds) {
         totalSeconds,
         record: plan,
         subtitles,
-        args: (part) => audioExportArgs(audio, part),
+        render: (part, onProgress) => runFfmpeg({
+            bin: deps.ffmpeg,
+            args: audioExportArgs(audio, part),
+            signal: context.signal,
+            log: deps.log,
+            onProgress,
+        }),
     });
 }