@gentbajko/slopify 2.0.2 → 2.0.3

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/main.js

@@ -119,7 +119,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 +243,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 ||

package/dist/slices/admission/rules.js

@@ -24,16 +24,16 @@ export function admit(input) {
     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])) {
             fields.push({
                 field: `sources.${kind}`,
-                message: `The ${kind} stage cannot be set to ${sources[kind]}.`,
+                message: `"${sources[kind]}" is not an option for ${kind}. Reload the page and choose again.`,
             });
         }
     }
@@ -45,7 +45,7 @@ export function admit(input) {
         draft.outro?.mode === "llm" ||
         usesNarrationPreparation(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 +54,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,14 +67,17 @@ 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.",
+        });
     }
     checkProvided(draft, input.staged, fields);
     checkValues(draft, input.requiredSlots, fields);
@@ -83,7 +86,7 @@ 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.`,
         });
     }
     return fields.length === 0 ? { ok: true, draft } : { ok: false, fields };
@@ -121,7 +124,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 +141,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 +174,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 +196,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 +236,7 @@ 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.",
             },
         ]
         : [];

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("");

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

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

package/dist/slices/article/run.js

@@ -13,14 +13,14 @@ export async function runArticle(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 article 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 writing the article. Choose a model in Edit project → Providers and check Edit project → Prompts, then Retry stage.");
     }
     const notes = researchNotes(deps, projectId);
     const brief = { articlePrompt, ...(notes === undefined ? {} : { notes }) };

package/dist/slices/article/segments.js

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

package/dist/slices/control/providers.js

@@ -25,7 +25,7 @@ export const providerChangesSchema = z
         .optional(),
 })
     .strict()
-    .refine((value) => Object.keys(value).length > 0, "Pick at least one provider to update.");
+    .refine((value) => Object.keys(value).length > 0, "Change at least one provider before saving.");
 export function validateLocalProviderChanges(changes, current) {
     const fields = [];
     const families = { llm: "llm", audio: "tts", images: "image" };
@@ -35,7 +35,10 @@ export function validateLocalProviderChanges(changes, current) {
             continue;
         const provider = current.providers.find((one) => one.id === picked.provider && one.family === families[key]);
         if (provider === undefined) {
-            fields.push({ field: key, message: "Choose a provider for this kind of generation." });
+            fields.push({
+                field: key,
+                message: "This provider cannot do this kind of work. Choose another provider.",
+            });
             continue;
         }
         const usable = readinessIsUsable(provider.readiness);
@@ -43,14 +46,18 @@ export function validateLocalProviderChanges(changes, current) {
             fields.push({
                 field: key,
                 message: provider.readiness.kind === "cli"
-                    ? (provider.readiness.issue ?? "Install and sign in to this CLI first.")
-                    : "Save this provider's API key in Settings first.",
+                    ? (provider.readiness.issue ??
+                        "Install this command-line tool on your computer and sign in to it, then try again.")
+                    : "Add this provider's API key in Settings → Providers first.",
             });
         }
     }
     if (changes.audio !== undefined &&
         !current.voices.some((voice) => voice.provider === changes.audio?.provider && voice.voiceId === changes.audio.voice)) {
-        fields.push({ field: "audio.voice", message: "Choose a saved voice for this provider." });
+        fields.push({
+            field: "audio.voice",
+            message: "Choose one of your saved voices for this provider. Add voices in Settings → Voices.",
+        });
     }
     return fields;
 }
@@ -67,10 +74,16 @@ export async function validateProviderChanges(changes, current) {
             continue;
         const result = await checkRuntimeModel(current.modelsFor, picked.provider, families[key], picked.model, picked.thinking);
         if (result === "missing") {
-            fields.push({ field: `${key}.model`, message: "Choose a model supported by this provider." });
+            fields.push({
+                field: `${key}.model`,
+                message: "This provider does not offer that model. Choose another model.",
+            });
         }
         else if (result === "thinking") {
-            fields.push({ field: `${key}.thinking`, message: "Choose a supported thinking setting." });
+            fields.push({
+                field: `${key}.thinking`,
+                message: "This model does not support that thinking setting. Choose another.",
+            });
         }
     }
     return fields;

package/dist/slices/fonts/catalog.js

@@ -31,7 +31,7 @@ export async function resolveFont(paths, id) {
     return font;
 }
 export function missingFont() {
-    return new Error("The selected font is no longer available. Choose another font.", {
+    return new Error("The chosen caption font is no longer available; it may have been uninstalled or deleted. Choose another font in Edit project → Subtitles, then try again.", {
         cause: "font-not-found",
     });
 }

package/dist/slices/fonts/upload.js

@@ -27,7 +27,7 @@ export async function uploadFont(paths, input) {
     const root = join(paths.dataDir, "fonts");
     await mkdir(root, { recursive: true, mode: 0o700 });
     if (!(await lstat(root)).isDirectory())
-        throw new Error("The font storage directory is unavailable.");
+        throw new Error(`Slopify can't save uploaded fonts because ${root} is not a folder. Move or rename that file, then upload the font again.`);
     const temporary = join(root, `.upload-${randomUUID()}`);
     try {
         await writeFile(temporary, input.content, { mode: 0o600, flag: "wx" });

package/dist/slices/images/run.js

@@ -22,19 +22,19 @@ export async function runImages(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.images;
     if (choice === undefined) {
         // Admission refuses a run whose images are Generate without a provider and a model, 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 this project. Choose one in Edit project → Providers, then Retry stage.");
     }
     const pieces = plan(deps, context, project.config);
     if (pieces.length === 0) {
         // Admission makes an image source mandatory and puts the Number at one or more, so an
         // empty plan is a bug upstream rather than a run with no pictures.
-        throw new Error("the run ticked no image prompt");
+        throw new Error("Slopify hit an internal error (no image prompt was selected). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     // The run's own frame. The adapter turns it into whatever its provider spells the
     // closest supported size, and the render crops whatever is left over.
@@ -78,7 +78,7 @@ function plan(deps, context, config) {
         // it, so the run carries the substituted text under this key.
         const prompt = config.rendered[`imagePrompts.${String(at)}`];
         if (prompt === undefined) {
-            throw new Error(`the run has no rendered text for the image prompt ${picked.name}`);
+            throw new Error(`Slopify hit an internal error (the image prompt ${picked.name} was never filled in). Retry stage; if it happens again, use Download diagnostics in Settings and report it.`);
         }
         for (let send = 1; send <= picked.number; send += 1) {
             planned.push({
@@ -224,7 +224,7 @@ function report(deps, context, done, total) {
 }
 function payloadOf(piece) {
     if (piece.payload === null) {
-        throw new Error(`image ${piece.id} has no payload`);
+        throw new Error("Slopify hit an internal error (a saved image step is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     return imagePayload.parse(JSON.parse(piece.payload));
 }

package/dist/slices/library/lint.js

@@ -13,17 +13,23 @@ function lint(name, body) {
     const fields = [];
     const trimmed = name.trim();
     if (trimmed === "") {
-        fields.push({ field: "name", message: "A name is required." });
+        fields.push({ field: "name", message: "Enter a name." });
     }
     else if (trimmed.length > nameMax) {
-        fields.push({ field: "name", message: `A name is at most ${String(nameMax)} characters.` });
+        fields.push({
+            field: "name",
+            message: `Keep the name to ${String(nameMax)} characters or fewer.`,
+        });
     }
     if (body.trim() === "") {
-        fields.push({ field: "body", message: "A body is required." });
+        fields.push({ field: "body", message: "Enter the text." });
         return fields;
     }
     if (body.length > bodyMax) {
-        fields.push({ field: "body", message: `A body is at most ${String(bodyMax)} characters.` });
+        fields.push({
+            field: "body",
+            message: `The text is too long. Keep it to ${String(bodyMax)} characters or fewer.`,
+        });
         return fields;
     }
     for (const error of detectSlots(body).errors) {
@@ -37,11 +43,11 @@ function describe(error, body) {
     const where = positionOf(body, error.at);
     switch (error.kind) {
         case "unclosed":
-            return `The \`{{\` at ${where} is never closed.`;
+            return `The \`{{\` at ${where} is never closed. Add \`}}\` after the keyword name.`;
         case "empty":
-            return `The slot at ${where} has no name.`;
+            return `The keyword at ${where} has no name. Write a name between \`{{\` and \`}}\`.`;
         case "nested":
-            return `The slot at ${where} holds a brace; slots do not nest.`;
+            return `The keyword at ${where} contains a brace. Keywords cannot be placed inside other keywords.`;
     }
 }
 function positionOf(body, at) {

package/dist/slices/library/slots.js

@@ -58,7 +58,7 @@ function body(db, kind, name, field, missing, into, key, snapshot) {
     }
     const prompt = snapshotPrompt(db, snapshot, kind, name);
     if (prompt === undefined) {
-        missing.push({ field, message: `That ${kind} prompt no longer exists; pick another.` });
+        missing.push({ field, message: `That ${kind} prompt was deleted. Choose another.` });
         return;
     }
     into.push({ key, body: prompt.body });
@@ -71,7 +71,7 @@ function pickEntry(db, category, choice, missing, snapshot) {
     if (entry === undefined) {
         missing.push({
             field: category,
-            message: `That ${category} entry no longer exists; pick another.`,
+            message: `That ${category} entry was deleted. Choose another.`,
         });
     }
     return entry;

package/dist/slices/narration/concat.js

@@ -46,7 +46,7 @@ export async function joinNarration(deps, input) {
     const first = input.files[0];
     if (first === undefined) {
         // The stage refuses an empty narration before it gets here, so this is a bug.
-        throw new Error("there are no audio chunks to join");
+        throw new Error("Slopify hit an internal error (there is no narration audio to join). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
     }
     mkdirSync(dirname(input.output), { recursive: true, mode: 0o700 });
     if (input.files.length === 1) {

package/dist/slices/narration/pronunciation-chunks.js

@@ -18,7 +18,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
     const chunks = chunkNarration(source, chunking).map((text) => {
         const start = source.indexOf(text, offset);
         if (start < 0)
-            throw new Error("Narration chunk is missing from its source.");
+            throw new Error("Slopify hit an internal error (a narration chunk isn't in the article text). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         offset = start + text.length;
         return { key: nextKey(text), text, start, end: offset };
     });
@@ -78,7 +78,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
         }
         const chunk = chunks[index];
         if (chunk === undefined)
-            throw new Error("Narration chunk disappeared.");
+            throw new Error("Slopify hit an internal error (a narration chunk went missing). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         while ((matches[matchIndex]?.end ?? Infinity) <= chunk.end)
             matchIndex++;
         const match = matches[matchIndex];
@@ -90,7 +90,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
             continue;
         const first = chunks[from];
         if (first === undefined)
-            throw new Error("Narration group has no first chunk.");
+            throw new Error("Slopify hit an internal error (a group of narration chunks is empty). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         const text = source.slice(first.start, chunk.end);
         result.push(from === index
             ? { key: chunk.key, text }

package/dist/slices/narration/pronunciation.js

@@ -105,7 +105,7 @@ export function pronunciationMatches(source, entries) {
             continue;
         const entry = ordered.find((_, index) => match[index + 1] !== undefined);
         if (entry === undefined)
-            throw new Error("Matched glossary term has no mapping.");
+            throw new Error("Slopify hit an internal error (a pronunciation glossary term has no pronunciation). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
         matches.push({ start: match.index, end, entry });
     }
     return matches;
@@ -117,7 +117,7 @@ export function pronunciationSpans(source, entries) {
         for (const [index, word] of Array.from(words).entries()) {
             const ipa = match.entry.ipa[index];
             if (ipa === undefined)
-                throw new Error("Validated glossary term has no IPA word.");
+                throw new Error("Slopify hit an internal error (a pronunciation glossary term is missing a word). Retry stage; if it happens again, use Download diagnostics in Settings and report it.");
             const start = match.start + word.index;
             spans.push({ start, end: start + word[0].length, text: `/${ipa}/` });
         }