@gentbajko/slopify 2.0.1 → 2.0.3

package/dist/slices/rebuild/transition-repo.js

@@ -15,14 +15,14 @@ export function transitionRevisionWork(deps, input) {
     transact(db, () => {
         const current = currentRevisionId(db, input.projectId);
         if (current !== input.baseRevisionId && current !== input.revisionId)
-            throw new Error("Work transition requires the current head.");
+            throw new Error("The project was changed while this was being saved. Try again.");
         const base = revisionById(db, input.projectId, input.baseRevisionId);
         const next = revisionById(db, input.projectId, input.revisionId);
         if (base === undefined || next === undefined)
-            throw new Error("Work transition requires owned revisions.");
+            throw new Error("Slopify hit an internal error (a project version to switch between is missing). Try again; if it happens again, use Download diagnostics in Settings and report it.");
         if (JSON.stringify(Object.entries(input.fingerprints).sort()) !==
             JSON.stringify(Object.entries(next.fingerprints).sort()))
-            throw new Error("Desired work differs from revision fingerprints.");
+            throw new Error("Slopify hit an internal error (the planned steps don't match the saved project version). Try again; if it happens again, use Download diagnostics in Settings and report it.");
         const reserved = db
             .prepare(`SELECT r.* FROM revision_work_reservations r JOIN revision_work w ON w.id=r.work_id WHERE r.project_id=? AND r.revision_id=? AND w.state IN ('pending','running','done')`)
             .all(input.projectId, input.baseRevisionId)
@@ -57,13 +57,13 @@ export function transitionRevisionWork(deps, input) {
                 continue;
             const exact = input.recipes?.find((row) => row.key === key);
             if (exact !== undefined && exact.fingerprint !== fp)
-                throw new Error("Recipe differs from desired fingerprint.");
+                throw new Error("Slopify hit an internal error (a planned step doesn't match the saved project version). Try again; if it happens again, use Download diagnostics in Settings and report it.");
             const kind = exact?.stage ?? stageForKey(key);
             const stage = db
                 .prepare("SELECT id FROM stages WHERE project_id=? AND kind=?")
                 .get(input.projectId, kind);
             if (stage === undefined)
-                throw new Error("Desired work has no project stage.");
+                throw new Error("Slopify hit an internal error (a planned step has no matching stage). Try again; if it happens again, use Download diagnostics in Settings and report it.");
             const workId = deps.ids.next();
             const pieceId = deps.ids.next();
             db.prepare(`INSERT INTO revision_work(id,project_id,revision_id,stage_id,kind,fingerprint,state,dispatch_state,created_at) VALUES (?,?,?,?,?,?,'pending','held',?)`).run(workId, input.projectId, input.revisionId, z.string().parse(stage.id), kind, fp, deps.clock.now().toISOString());
@@ -104,5 +104,5 @@ function stageForKey(key) {
         return "thumbnail";
     if (prefix === "export" || prefix === "subtitles" || prefix === "video")
         return "video";
-    throw new Error("Unknown revision work key.");
+    throw new Error("Slopify hit an internal error (unknown kind of step). Try again; if it happens again, use Download diagnostics in Settings and report it.");
 }

package/dist/slices/reruns/index.js

@@ -204,7 +204,7 @@ function clearStage(deps, stage, outputs) {
 // runs the returned cleanup only after commit. Finished narration is left intact.
 export function clearUnfinishedAudio(deps, projectId) {
     if (currentRevisionId(deps.db, projectId) !== undefined)
-        throw new Error("Versioned narration must be edited through revisions.");
+        throw new Error("Slopify hit an internal error (narration was changed the old way on a project that uses versions). Try again; if it happens again, use Download diagnostics in Settings and report it.");
     const stage = stagesOf(deps.db, projectId).find((one) => one.kind === "audio");
     if (stage === undefined ||
         stage.state === "done" ||

package/dist/slices/research/run.js

@@ -10,7 +10,7 @@ import { chaptersFrom, plannerMessages, subAgentMessages } from "./planner.js";
 import { sourcedAnswer, synthesisMessages } from "./synthesis.js";
 // A model that cannot ground on the web fails the stage immediately, with no fallback to
 // what the model already knows.
-export const webResearchUnsupported = "web research unsupported by this model";
+export const webResearchUnsupported = "The chosen AI model can't search the web, which research needs. Choose a model with web search in Edit project → Providers, or turn research off, then Retry stage.";
 // What a chapter piece carries between runs: its title, and its notes once a sub-agent
 // has answered. That is the whole of the resume.
 const chapterPayload = z.object({ title: z.string(), notes: z.string().optional() });
@@ -18,14 +18,14 @@ export async function runResearch(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 choice = project.config.llm;
     const articlePrompt = project.config.rendered.article;
     if (choice === undefined || articlePrompt === undefined) {
         // Admission refuses a run whose research is Generate without both, so
         // reaching here is a bug in admission rather than something the user did.
-        throw new Error("the run has no LLM provider or no rendered article prompt");
+        throw new Error("No AI model or article prompt is set for research. Choose a model in Edit project → Providers and check Edit project → Prompts, then Retry stage.");
     }
     const brief = { articlePrompt, values: project.config.values };
     try {
@@ -62,7 +62,7 @@ async function research(deps, context, providers, choice, brief) {
         messages: synthesisMessages(brief, findings),
         documents: researchDocuments(findings),
         previewLabel: "Writing research notes",
-        check: (given) => sourcedAnswer("the synthesis", given.text),
+        check: (given) => sourcedAnswer("the research summary", given.text),
     });
     if (!answer.ok)
         return "held";
@@ -110,7 +110,9 @@ async function plan(deps, context, providers, choice, brief, add) {
         messages: plannerMessages(brief),
         previewLabel: "Planning research",
         // An empty answer, or one with no chapter in it, is a failed attempt.
-        check: (given) => chaptersFrom(given.text).length === 0 ? "the planner named no chapters" : undefined,
+        check: (given) => chaptersFrom(given.text).length === 0
+            ? "The AI model didn't return any research topics. Retry stage; if it keeps happening, choose a different model in Edit project → Providers."
+            : undefined,
     });
     if (!answer.ok)
         return answer;
@@ -156,7 +158,7 @@ async function researchChapters(deps, context, providers, choice, brief, chapter
                 // Grounding is asked for explicitly, so a model without it says so
                 // instead of answering from what it already knows.
                 webSearch: true,
-                check: (given) => sourcedAnswer(`the researcher on "${kept.title}"`, given.text),
+                check: (given) => sourcedAnswer(`the research topic "${kept.title}"`, given.text),
             });
             if (!answer.ok) {
                 setPiece(deps.db, piece.id, "pending", piece.payload);
@@ -215,7 +217,7 @@ function section(label, messages) {
 }
 function payloadOf(piece) {
     if (piece.payload === null) {
-        throw new Error(`chapter ${piece.id} has no payload`);
+        throw new Error("Slopify hit an internal error (a saved research topic is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return chapterPayload.parse(JSON.parse(piece.payload));
 }

package/dist/slices/research/synthesis.js

@@ -41,7 +41,9 @@ export function endsWithSources(text) {
 // but cannot be used is a failed attempt, so the wrapper retries it.
 export function sourcedAnswer(who, text) {
     if (text.trim() === "") {
-        return `${who} answered with nothing`;
+        return `The AI model returned an empty answer for ${who}. Retry stage; if it keeps happening, choose a different model in Edit project → Providers.`;
     }
-    return endsWithSources(text) ? undefined : `${who} answered with no Sources list`;
+    return endsWithSources(text)
+        ? undefined
+        : `The AI model's answer for ${who} had no sources. Research needs web sources: Retry stage, or choose a model with web search in Edit project → Providers.`;
 }

package/dist/slices/revisions/mutation-assets.js

@@ -34,11 +34,14 @@ export function validateUploads(deps, edit) {
             (to.kind === "image" && edit.config.sources.images === "off"))
             fields.push({
                 field,
-                message: "Enable the corresponding provided or generated content before importing this file.",
+                message: "This section is off or not set to use your own file. Change the section's setting first, then add the file.",
             });
         const destination = JSON.stringify(to);
         if (staged.has(upload.stagedFileId) || destinations.has(destination))
-            fields.push({ field, message: "Each upload and destination must be unique." });
+            fields.push({
+                field,
+                message: "The same file or place is used twice. Remove the duplicate.",
+            });
         staged.add(upload.stagedFileId);
         destinations.add(destination);
         const file = stagedFileById(deps.db, upload.stagedFileId);
@@ -47,11 +50,20 @@ export function validateUploads(deps, edit) {
             file.state !== "staged" ||
             file.stageKind !== kind ||
             !statSync(stagingPath(deps.paths, file.path), { throwIfNoEntry: false })?.isFile())
-            fields.push({ field, message: "Choose a completed upload for this stage." });
+            fields.push({
+                field,
+                message: "This upload is missing or has not finished. Upload the file again.",
+            });
         if (to.kind === "image" && edit.content.imageDefinitions[to.imageKey] === undefined)
-            fields.push({ field, message: "Choose an image in this revision." });
+            fields.push({
+                field,
+                message: "This image is no longer in the project. Reload the page and choose again.",
+            });
         if (to.kind === "narration" && !to.key.startsWith("audio:"))
-            fields.push({ field, message: "Choose a narration segment." });
+            fields.push({
+                field,
+                message: "Choose which part of the narration this audio file replaces.",
+            });
     }
     return fields;
 }
@@ -81,7 +93,10 @@ export function validateAssetReferences(deps, projectId, content, prepared) {
             deps.db
                 .prepare("SELECT 1 FROM project_assets WHERE project_id=? AND id=?")
                 .get(projectId, id) === undefined)
-            fields.push({ field, message: "Choose an asset belonging to this project." });
+            fields.push({
+                field,
+                message: "This file does not belong to this project. Reload the page and choose again.",
+            });
         if (!prepared.some((row) => row.id === id) &&
             deps.db
                 .prepare("SELECT 1 FROM revision_outputs WHERE project_id=? AND asset_id=? AND json_extract(descriptor,'$.stageKind')=? AND json_extract(descriptor,'$.role') IN (SELECT value FROM json_each(?))")
@@ -95,7 +110,10 @@ export function validateAssetReferences(deps, projectId, content, prepared) {
                 deps.db
                     .prepare("SELECT 1 FROM project_revisions r, json_each(r.content, '$.narrationOverrides') o WHERE r.project_id=? AND json_extract(o.value,'$.kind')='asset' AND json_extract(o.value,'$.assetId')=? LIMIT 1")
                     .get(projectId, id) !== undefined))
-            fields.push({ field, message: "Choose an asset for this content stage." });
+            fields.push({
+                field,
+                message: "This file cannot be used in this section. Choose a file of the right kind.",
+            });
     }
     return fields;
 }
@@ -144,5 +162,5 @@ export function validateReplacementAvailability(deps, base, edit) {
         previous.has(id) ||
         statSync(outputPath(deps.paths, base.revision.projectId, assetPath(deps, base.revision.projectId, id)), { throwIfNoEntry: false })?.isFile()
         ? []
-        : [{ field: "content", message: "The replacement asset is missing. Upload it again." }]);
+        : [{ field: "content", message: "The replacement file is missing. Upload it again." }]);
 }

package/dist/slices/revisions/mutation-cues.js

@@ -34,7 +34,7 @@ export function validateProposedCues(base, edit, plan, prepared, durations) {
     const fail = () => [
         {
             field: "content.subtitleCues",
-            message: "Save captions against the current, complete narration timeline.",
+            message: "The narration changed or is not finished, so these captions no longer line up. Reload the page and edit the captions again once narration is complete.",
         },
     ];
     const candidates = [

package/dist/slices/revisions/rules.js

@@ -51,16 +51,25 @@ export function validateCues(cues, duration) {
     for (const [index, cue] of cues.entries()) {
         const field = `content.subtitleCues.cues.${index}`;
         if (seen.has(cue.id))
-            fields.push({ field: `${field}.id`, message: "Caption IDs must be unique." });
+            fields.push({
+                field: `${field}.id`,
+                message: "Two captions have the same ID. Reload the page and edit the captions again.",
+            });
         seen.add(cue.id);
         if (cue.text.trim() === "")
-            fields.push({ field: `${field}.text`, message: "Caption text is required." });
+            fields.push({
+                field: `${field}.text`,
+                message: "Enter the caption text, or delete this caption.",
+            });
         if (!Number.isFinite(cue.start) || cue.start < end)
-            fields.push({ field: `${field}.start`, message: "Start must follow the previous caption." });
+            fields.push({
+                field: `${field}.start`,
+                message: "This caption must start after the previous one ends.",
+            });
         if (!Number.isFinite(cue.end) || cue.end <= cue.start || cue.end > duration)
             fields.push({
                 field: `${field}.end`,
-                message: "End must follow start and fit the narration.",
+                message: "This caption must end after it starts and before the narration ends.",
             });
         end = cue.end;
     }
@@ -75,7 +84,7 @@ export function validateTemplateIntent(base, edit) {
                 base.revision.config.rendered[key] === edit.config.rendered[key])
                 fields.push({
                     field: `content.promptTemplates.${key}`,
-                    message: "Choose the raw template or explicitly keep the current prompt before changing keywords.",
+                    message: "This prompt was edited by hand, so new keywords will not change it. Switch it back to its template, or choose to keep your edited prompt, first.",
                 });
         }
         for (const [key, image] of Object.entries(base.revision.content.imageDefinitions)) {
@@ -87,7 +96,7 @@ export function validateTemplateIntent(base, edit) {
                 next.prompt === image.prompt)
                 fields.push({
                     field: `content.imageDefinitions.${key}.templateKey`,
-                    message: "Choose the raw template or explicitly keep the current image prompt before changing keywords.",
+                    message: "This image prompt was edited by hand, so new keywords will not change it. Switch it back to its template, or choose to keep your edited prompt, first.",
                 });
         }
     }
@@ -99,7 +108,7 @@ export function validateTemplateIntent(base, edit) {
                 isDeepStrictEqual(base.revision.content.imageDefinitions[key], image)))
             fields.push({
                 field: `content.imageDefinitions.${key}.templateKey`,
-                message: "The linked raw image template is missing.",
+                message: "The prompt template this image uses is missing. Choose another image prompt.",
             });
     return fields;
 }
@@ -132,13 +141,13 @@ export function validateNarrationIntent(base, edit) {
         if (!isDeepStrictEqual(value, base.revision.content.narrationOverrides[key]) && !keys.has(key))
             fields.push({
                 field: `content.narrationOverrides.${key}`,
-                message: "Choose an active narration group or entry.",
+                message: "This narration part no longer exists. Reload the page and choose again.",
             });
     for (const [index, upload] of (edit.uploads ?? []).entries())
         if (upload.destination.kind === "narration" && !keys.has(upload.destination.key))
             fields.push({
                 field: `uploads.${index}.destination.key`,
-                message: "Choose an active narration group or entry.",
+                message: "This narration part no longer exists. Reload the page and choose again.",
             });
     return fields;
 }

package/dist/slices/revisions/schema.js

@@ -20,7 +20,7 @@ const cue = z
     .strict()
     .refine((value) => value.end > value.start, {
     path: ["end"],
-    message: "End must be after start.",
+    message: "The end time must be after the start time.",
 });
 export const revisionContentSchema = z
     .object({

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;
             }