@gentbajko/slopify 2.0.1 → 2.0.3

package/dist/edge/http/app.js

@@ -80,14 +80,14 @@ export function createApp(deps) {
             return problem(c, {
                 status: 503,
                 title: titleOf(503),
-                detail: "Docker installation is being verified. Wait for the launcher to finish.",
+                detail: "Slopify is still finishing its Docker setup. Wait for the launcher to finish, then try again.",
             });
         const releaseRequest = deps.mutations?.begin();
         if (deps.mutations !== undefined && releaseRequest === undefined)
             return problem(c, {
                 status: 503,
                 title: titleOf(503),
-                detail: "Slopify is shutting down. Wait for it to restart before making changes.",
+                detail: "Slopify is shutting down, so changes cannot be saved right now. Start it again, reload the page and try again.",
             });
         const updateRoute = [
             "/api/update",
@@ -101,7 +101,7 @@ export function createApp(deps) {
             return problem(c, {
                 status: 409,
                 title: titleOf(409),
-                detail: "Slopify is updating. Wait for it to restart before making changes.",
+                detail: "Slopify is updating. Wait for it to restart, reload the page and try again.",
             });
         }
         try {

package/dist/edge/http/audio-preview.js

@@ -49,6 +49,6 @@ function missing(c) {
     return problem(c, {
         status: 404,
         title: titleOf(404),
-        detail: "This live audio preview is no longer available. Finished narration is available in the audio outputs.",
+        detail: "This live audio preview has ended. Play the finished narration from the project's audio outputs instead.",
     });
 }

package/dist/edge/http/checkpoints.js

@@ -20,7 +20,11 @@ function refused(c, reason) {
     return problem(c, {
         status,
         title: titleOf(status),
-        detail: "Reload the current checkpoint status before approving or changing this gate.",
+        detail: reason === "not-found"
+            ? "This checkpoint no longer exists; the project may have moved on or changed. Reload the page to see where it is now."
+            : reason === "invalid-input"
+                ? "This checkpoint answer could not be read. Reload the page and try again."
+                : "This checkpoint changed since the page loaded, for example it was already approved. Reload the page to see its current state, then try again.",
         extensions: { reason },
     });
 }

package/dist/edge/http/diagnostics.js

@@ -29,7 +29,9 @@ export function diagnosticsRoutes(deps) {
                 ...(provider.cliPath === undefined ? {} : { cliPath: provider.cliPath }),
             })),
             projects: { total: typeof projectCount?.count === "number" ? projectCount.count : 0 },
-            catalogue: deps.catalogue?.status() ?? { warning: "Catalogue unavailable." },
+            catalogue: deps.catalogue?.status() ?? {
+                warning: "The model list (models.yaml) is not loaded yet. Wait a moment and reload the page; if it stays like this, restart Slopify.",
+            },
         });
     });
 }

package/dist/edge/http/draft-files.js

@@ -32,7 +32,7 @@ export function draftFileRoutes(service) {
             return problem(c, {
                 status: 400,
                 title: titleOf(400),
-                detail: "The request carried no file part.",
+                detail: "No file arrived with the upload. Choose the file again and retry.",
             });
         return result.ok
             ? c.json(draftAttachmentSchema.parse(result.value))
@@ -57,7 +57,7 @@ export function draftFileRoutes(service) {
             return problem(c, {
                 status: 404,
                 title: titleOf(404),
-                detail: "This draft attachment has no preview bytes.",
+                detail: "This attached file has not finished uploading, so it cannot be previewed yet. Wait a moment or attach it again.",
             });
         return c.body(Readable.toWeb(createReadStream(stagingPath(deps.paths, staged.path))), 200, {
             "content-type": contentType,

package/dist/edge/http/draft-problem.js

@@ -6,10 +6,20 @@ export function draftProblem(c, result) {
             ? 400
             : 409;
     const { ok: _ok, ...extensions } = result;
+    const details = {
+        "not-found": "This draft no longer exists; it may have been started or deleted. Reload the page to start a new one.",
+        "invalid-draft": "This saved draft could not be read. Reload the page and set the video up again in Play.",
+        conflict: "This draft changed in another tab or window. Reload the page to see the latest, then make your change again.",
+        "invalid-edit": "Some settings need fixing. Fix the highlighted fields, then try again.",
+        "pending-start": "This video is already starting. Wait a moment, then find it in Projects.",
+        "already-started": "This draft was already started. Find the video in Projects.",
+        "stale-review": "Something changed since you reviewed this video, such as a setting or a price. Choose Review and start again to see the latest.",
+        readiness: "Slopify is not ready to start this video yet. Fix the highlighted problems, then try again.",
+    };
     return problem(c, {
         status,
         title: titleOf(status),
-        detail: "Review the saved draft and the listed fields.",
+        detail: details[result.reason],
         extensions,
     });
 }

package/dist/edge/http/files.js

@@ -58,10 +58,10 @@ function disposition(filename) {
 }
 function missing(c, reason) {
     const details = {
-        "unknown-project": "No project has that id.",
-        "unknown-asset": "This project has no such file.",
-        "missing-file": "This file is recorded but is no longer on disk; re-run the stage.",
-        "no-images": "This project has no images or thumbnail yet.",
+        "unknown-project": "This project no longer exists. Go back to Projects to pick another.",
+        "unknown-asset": "This project has no file by that name. Reload the page to see its current files.",
+        "missing-file": "This file was deleted or moved from the project folder. Use Re-run section on the project page to make it again.",
+        "no-images": "This project has no images or thumbnail yet. Wait for the Images step to finish, then try again.",
     };
     return problem(c, { status: 404, title: titleOf(404), detail: details[reason] });
 }

package/dist/edge/http/folder-location.js

@@ -10,7 +10,7 @@ export async function replyForFolder(c, deps, projectId, file) {
             return problem(c, {
                 status: 503,
                 title: titleOf(503),
-                detail: "This Docker installation has no verified host project folder. Downloads remain available. Rerun the managed Docker launcher to set up host files.",
+                detail: "Slopify cannot show where this file is on your computer because its Docker project folder was not set up. You can still use the download buttons, or run the Slopify Docker launcher again to set up the folder.",
             });
         try {
             const r = relative(deps.paths.projects, file);
@@ -41,7 +41,7 @@ export async function replyForFolder(c, deps, projectId, file) {
             return problem(c, {
                 status: 404,
                 title: titleOf(404),
-                detail: "This saved output folder is no longer available.",
+                detail: "This output's folder was deleted or moved. Use Re-run section on the project page to make the file again.",
             });
         }
     }
@@ -59,7 +59,7 @@ export async function replyForFolder(c, deps, projectId, file) {
         return problem(c, {
             status: 503,
             title: titleOf(503),
-            detail: "Could not open the file manager on the machine running Slopify. Make sure a desktop session is available.",
+            detail: "Slopify could not open a file manager window on the computer it runs on. Make sure you are signed in to that computer's desktop, or use the download buttons instead.",
         });
     }
 }

package/dist/edge/http/fonts.js

@@ -17,14 +17,14 @@ export function fontsRoutes(deps) {
             return problem(c, {
                 status: 415,
                 title: titleOf(415),
-                detail: "Upload one .ttf or .otf file as multipart/form-data.",
+                detail: "The font was not sent as a file. Reload the page and choose a .ttf or .otf file again.",
             });
         const body = c.req.raw.body;
         if (body === null)
             return problem(c, {
                 status: 400,
                 title: titleOf(400),
-                detail: "The request carried no font file.",
+                detail: "No font file arrived. Choose a .ttf or .otf file and try again.",
             });
         const part = await readUpload(contentType, body);
         if (!part.ok) {
@@ -33,8 +33,8 @@ export function fontsRoutes(deps) {
                 status: tooLarge ? 413 : 400,
                 title: tooLarge ? "Content Too Large" : titleOf(400),
                 detail: tooLarge
-                    ? "A font file must be no larger than 32 MiB."
-                    : "Upload exactly one complete font file in the file part.",
+                    ? "This font file is larger than 32 MB. Choose a smaller .ttf or .otf file."
+                    : "The font upload did not arrive complete. Choose one .ttf or .otf file and try again.",
             });
         }
         const result = await uploadFont(deps.paths, part.upload);
@@ -44,7 +44,11 @@ export function fontsRoutes(deps) {
     })
         .get("/:id/file", zValidator("param", idParam, (result, c) => {
         if (!result.success)
-            return problem(c, { status: 404, title: titleOf(404), detail: "No font has that id." });
+            return problem(c, {
+                status: 404,
+                title: titleOf(404),
+                detail: "This font no longer exists; it may have been deleted. Reload the page to see your current fonts.",
+            });
         return undefined;
     }), async (c) => {
         try {
@@ -58,7 +62,11 @@ export function fontsRoutes(deps) {
         catch (error) {
             if (!isMissingFont(error))
                 throw error;
-            return problem(c, { status: 404, title: titleOf(404), detail: "No font has that id." });
+            return problem(c, {
+                status: 404,
+                title: titleOf(404),
+                detail: "This font no longer exists; it may have been deleted. Reload the page to see your current fonts.",
+            });
         }
     });
 }
@@ -127,21 +135,25 @@ function failure(reason) {
             return {
                 status: 413,
                 title: "Content Too Large",
-                detail: "A font file must be no larger than 32 MiB.",
+                detail: "This font file is larger than 32 MB. Choose a smaller .ttf or .otf file.",
             };
         case "unsupported-format":
-            return { status: 415, title: titleOf(415), detail: "Choose a .ttf or .otf font file." };
+            return {
+                status: 415,
+                title: titleOf(415),
+                detail: "Slopify only accepts .ttf or .otf font files. Choose a file with one of those endings.",
+            };
         case "unsafe-filename":
             return {
                 status: 400,
                 title: titleOf(400),
-                detail: "The font filename cannot contain a path or control character.",
+                detail: "The font's file name contains characters Slopify cannot use. Rename the file on your computer, then upload it again.",
             };
         case "invalid-font":
             return {
                 status: 400,
                 title: titleOf(400),
-                detail: "This file is not a supported, valid TrueType or OpenType font.",
+                detail: "This file is not a valid TrueType (.ttf) or OpenType (.otf) font; it may be damaged. Download the font again or choose another.",
             };
     }
 }

package/dist/edge/http/host-cli.js

@@ -48,14 +48,14 @@ export function hostGate() {
         },
     };
 }
-const unavailable = "Host CLI operation did not finish reliably; its result may be uncertain. Review the affected rebuild before retrying.";
+const unavailable = "The AI command-line tool on your computer stopped before it finished, so this result is uncertain. Check the section's outputs on the project page, then use Retry stage.";
 function fault(error, token) {
     return {
         type: "error",
         kind: isProviderError(error) ? error.fault.kind : "unavailable",
         message: redact(isProviderError(error)
             ? error.message
-            : "Host helper operation failed. Check the host CLI and rerun the Docker launcher.")
+            : "The Slopify helper on your computer could not run the AI command-line tool. Check the tool is installed and signed in, then run the Slopify Docker launcher again.")
             .replaceAll(token, "[redacted]")
             .slice(0, 4096),
     };
@@ -67,7 +67,11 @@ export function hostCliRoutes(options) {
         const supplied = Buffer.from(c.req.header("authorization") ?? "");
         const expected = Buffer.from(`Bearer ${token}`);
         if (supplied.length !== expected.length || !timingSafeEqual(supplied, expected))
-            return c.json({ type: "error", kind: "unavailable", message: "Host helper authorization failed." }, 401);
+            return c.json({
+                type: "error",
+                kind: "unavailable",
+                message: "The Slopify helper on your computer refused the connection. Run the Slopify Docker launcher again to reconnect it.",
+            }, 401);
         c.header("Cache-Control", "no-store");
         await next();
     });
@@ -84,7 +88,7 @@ export function hostCliRoutes(options) {
             return c.json({
                 type: "error",
                 kind: "unavailable",
-                message: "The host helper is busy or restarting. Review the rebuild after it is ready.",
+                message: "The Slopify helper on your computer is busy or restarting. Wait a moment, then use Retry stage.",
             }, 503);
         const outgoing = c.env?.outgoing;
         let responseEnded = !outgoing;
@@ -128,7 +132,11 @@ export function hostCliRoutes(options) {
     });
     app.use("/v1/*", bodyLimit({
         maxSize: bridgeLimits.request,
-        onError: (c) => c.json({ type: "error", kind: "unavailable", message: "Host request is too large." }, 413),
+        onError: (c) => c.json({
+            type: "error",
+            kind: "unavailable",
+            message: "Slopify hit an internal error (a request to the helper on your computer was too large). Try again; if it keeps happening, use Download diagnostics in Settings and report it.",
+        }, 413),
     }));
     app.get("/v1/status/:provider", async (c) => {
         const id = z.enum(hostCliIds).safeParse(c.req.param("provider"));
@@ -137,7 +145,10 @@ export function hostCliRoutes(options) {
         const status = hostStatusSchema.parse(await ports.status(id.data));
         const text = JSON.stringify(status);
         if (Buffer.byteLength(text) > bridgeLimits.status)
-            throw providerError({ kind: "unavailable", message: "Host status exceeded its limit." });
+            throw providerError({
+                kind: "unavailable",
+                message: "Slopify hit an internal error (the helper on your computer sent a status report that was too large). Try again; if it keeps happening, use Download diagnostics in Settings and report it.",
+            });
         return c.json(status);
     });
     app.get("/v1/models/:provider", async (c) => {
@@ -148,7 +159,10 @@ export function hostCliRoutes(options) {
             models: await (id.data === "codex-image" ? ports.image : ports.llm(id.data)).models(),
         });
         if (Buffer.byteLength(JSON.stringify(result)) > bridgeLimits.models)
-            throw providerError({ kind: "unavailable", message: "Host models exceeded their limit." });
+            throw providerError({
+                kind: "unavailable",
+                message: "Slopify hit an internal error (the helper on your computer sent a model list that was too large). Try again; if it keeps happening, use Download diagnostics in Settings and report it.",
+            });
         return c.json(result);
     });
     app.post("/v1/llm/:provider", async (c) => {
@@ -177,11 +191,11 @@ export function hostCliRoutes(options) {
                     timer = setTimeout(() => controller.abort(), 120_000);
                     const parsed = hostFrameSchema.parse(event);
                     if (done || parsed.type === "error")
-                        throw new Error("Invalid provider stream.");
+                        throw new Error("Slopify hit an internal error (the AI tool on your computer sent a reply Slopify could not read). Try again; if it keeps happening, use Download diagnostics in Settings and report it.");
                     const frame = `${JSON.stringify(parsed)}\n`;
                     total += Buffer.byteLength(frame);
                     if (Buffer.byteLength(frame) > bridgeLimits.frame || total > bridgeLimits.stream)
-                        throw new Error("Host stream exceeded its limit.");
+                        throw new Error("Slopify hit an internal error (the AI tool on your computer sent a reply that was too large). Try again; if it keeps happening, use Download diagnostics in Settings and report it.");
                     await output.write(frame);
                     signal.throwIfAborted();
                     done = parsed.type === "done";
@@ -217,7 +231,7 @@ export function hostCliRoutes(options) {
             if (signal.aborted)
                 throw providerError({ kind: "unavailable", message: unavailable });
             if (result.bytes.byteLength > bridgeLimits.image || sniffImage(result.bytes) !== result.mime)
-                throw new Error("Invalid host image.");
+                throw new Error("Slopify hit an internal error (the image made on your computer was too large or not a valid image). Try again; if it keeps happening, use Download diagnostics in Settings and report it.");
             c.header("Content-Type", result.mime);
             c.header("Content-Length", String(result.bytes.byteLength));
             return c.body(new Uint8Array(result.bytes));
@@ -231,7 +245,11 @@ export function hostCliRoutes(options) {
         }
     });
     app.onError((error, c) => c.json(fault(error, token), 503));
-    app.notFound((c) => c.json({ type: "error", kind: "unavailable", message: "Unknown host helper operation or protocol." }, 404));
+    app.notFound((c) => c.json({
+        type: "error",
+        kind: "unavailable",
+        message: "The Slopify helper on your computer does not match this version of Slopify. Run the Slopify Docker launcher again to update it.",
+    }, 404));
     return app;
 }
 async function json(request) {
@@ -243,5 +261,9 @@ async function json(request) {
     }
 }
 function invalid(c) {
-    return c.json({ type: "error", kind: "unavailable", message: "Invalid host provider request." }, 400);
+    return c.json({
+        type: "error",
+        kind: "unavailable",
+        message: "Slopify hit an internal error (the helper on your computer received a request it could not read). Try again; if it keeps happening, use Download diagnostics in Settings and report it.",
+    }, 400);
 }

package/dist/edge/http/multipart.js

@@ -6,10 +6,12 @@ export async function readMultipart(request, consume) {
     const contentType = request.headers.get("content-type");
     if (contentType === null || !contentType.startsWith("multipart/form-data"))
         throw new HTTPException(415, {
-            message: "An upload is sent as multipart/form-data with the file in one part.",
+            message: "The upload was not sent as a file. Reload the page and choose the file again.",
         });
     if (request.body === null)
-        throw new HTTPException(400, { message: "The request carried no body." });
+        throw new HTTPException(400, {
+            message: "The upload arrived empty. Choose the file again and retry.",
+        });
     let parser;
     try {
         parser = new Busboy({
@@ -20,7 +22,7 @@ export async function readMultipart(request, consume) {
     }
     catch (error) {
         throw new HTTPException(400, {
-            message: "The multipart boundary is missing or invalid.",
+            message: "The upload did not arrive complete. Choose the file again and retry.",
             cause: error,
         });
     }
@@ -43,7 +45,7 @@ export async function readMultipart(request, consume) {
     };
     source.on("error", fail);
     parser.on("error", (error) => fail(new HTTPException(400, {
-        message: "The multipart request is malformed or incomplete.",
+        message: "The upload did not arrive complete. Choose the file again and retry.",
         cause: error,
     })));
     parser.on("finish", () => complete());
@@ -62,7 +64,7 @@ export async function readMultipart(request, consume) {
             fail(error instanceof Error ? error : new Error("Upload failed", { cause: error }));
         });
     });
-    const abort = () => fail(new Error("Upload request was aborted."));
+    const abort = () => fail(new Error("The upload was interrupted before it finished. Choose the file again and retry."));
     request.signal.addEventListener("abort", abort, { once: true });
     if (request.signal.aborted)
         abort();

package/dist/edge/http/open-folder.js

@@ -23,7 +23,7 @@ export function openFolderRoutes(deps) {
             return problem(c, {
                 status: 403,
                 title: titleOf(403),
-                detail: "Open folders from Slopify itself.",
+                detail: "For your safety, folders can only be opened from the Slopify page itself. Open Slopify and try again there.",
             });
         }
         const { id } = c.req.valid("param");
@@ -41,7 +41,7 @@ export function openFolderRoutes(deps) {
             return problem(c, {
                 status: 404,
                 title: titleOf(404),
-                detail: "No saved file was found for this output. Re-run the stage if the file was removed.",
+                detail: "This output's file was deleted or moved. Use Re-run section on the project page to make it again.",
             });
         }
         return replyForFolder(c, deps, id, download.download.path);

package/dist/edge/http/planning.js

@@ -66,7 +66,7 @@ export function planningRoutes(deps) {
             return problem(c, {
                 status: 400,
                 title: titleOf(400),
-                detail: "Review the run setup.",
+                detail: "Some settings need fixing before Slopify can estimate the cost. Fix the highlighted fields.",
                 extensions: { fields },
             });
         return c.json({
@@ -79,7 +79,7 @@ export function planningRoutes(deps) {
             return problem(c, {
                 status: 409,
                 title: titleOf(409),
-                detail: "Queue checkpoint-enabled projects through Play Review.",
+                detail: "Videos with checkpoints turned on cannot be queued. Start them one at a time from Play with Review and start.",
             });
         if (batchExists(deps.db, input.requestId))
             return c.json({ queue: queueEntries(deps.db, input.requestId) });
@@ -92,7 +92,7 @@ export function planningRoutes(deps) {
                 return problem(c, {
                     status: 400,
                     title: titleOf(400),
-                    detail: "Choose an available subtitle font before starting.",
+                    detail: "The subtitle font you picked is no longer available. Choose another font before starting.",
                 });
             }
         }
@@ -102,7 +102,7 @@ export function planningRoutes(deps) {
             return problem(c, {
                 status: 400,
                 title: titleOf(400),
-                detail: "No videos were queued. Review the listed fields.",
+                detail: "No videos were queued. Fix the highlighted fields, then try again.",
                 extensions: { fields },
             });
         const queue = enqueueBatch({ ...deps, emit: (event) => deps.hub.emitGlobal(event) }, input.requestId, runs);

package/dist/edge/http/problem.js

@@ -38,7 +38,7 @@ export function problemFromError(c, error, deps) {
     return problem(c, {
         status: 500,
         title: titleOf(500),
-        detail: `The server failed to handle this request. Correlation id ${correlationId} is in the log.`,
+        detail: `Slopify hit an internal error while handling this request. Try again; if it keeps happening, use Download diagnostics in Settings and report it (reference ${correlationId}).`,
         extensions: { correlationId },
     });
 }
@@ -54,7 +54,7 @@ export function onInvalid(result, c) {
     return problem(c, {
         status: 400,
         title: titleOf(400),
-        detail: "The request does not match this endpoint's schema.",
+        detail: "Slopify could not read this request, which usually means the page is out of date. Reload the page and try again.",
         extensions: {
             errors: result.error.issues.map((issue) => ({
                 path: issue.path.join("."),

package/dist/edge/http/project-templates.js

@@ -17,10 +17,14 @@ function refused(c, result) {
         status,
         title: titleOf(status),
         detail: result.reason === "referenced-by-schedule"
-            ? "Cancel and delete the schedules using this template before deleting it. Their run history will be retained."
+            ? "Some schedules still use this template. In Library > Schedules, cancel and delete them first; their run history is kept."
             : result.reason === "missing-prompt"
-                ? "A selected prompt or entry is unavailable. Choose another before saving the template."
-                : "Reload the template and check its setup before trying again.",
+                ? "A prompt or intro/outro entry this template uses was deleted. Choose another in the template, then save again."
+                : result.reason === "not-found"
+                    ? "This template no longer exists; it may have been deleted. Go to Library > Templates to see your templates."
+                    : result.reason === "conflict"
+                        ? "This template or its project changed while you were editing. Reload the page to see the latest, then make your change again."
+                        : "Some template settings are not valid, for example an image you supplied yourself. Check the template's settings and try again.",
         extensions: { reason: result.reason },
     });
 }

package/dist/edge/http/projects.js

@@ -60,7 +60,7 @@ export function projectRoutes(deps) {
             return problem(c, {
                 status: 409,
                 title: titleOf(409),
-                detail: "Start checkpoint-enabled projects through Play Review.",
+                detail: "This project has checkpoints turned on, so it must be started from Play with Review and start.",
             });
         const requestedSubtitles = c.req.valid("json").subtitles;
         if (requestedSubtitles !== undefined && requestedSubtitles.mode !== "off") {
@@ -71,12 +71,12 @@ export function projectRoutes(deps) {
                 return problem(c, {
                     status: 400,
                     title: titleOf(400),
-                    detail: "Choose an available subtitle font before starting.",
+                    detail: "The subtitle font you picked is no longer available. Choose another font before starting.",
                     extensions: {
                         fields: [
                             {
                                 field: "subtitles.fontId",
-                                message: "This font is no longer available; choose another or upload it again.",
+                                message: "This font is no longer available. Choose another or upload it again in Settings.",
                             },
                         ],
                     },
@@ -96,7 +96,7 @@ export function projectRoutes(deps) {
             return problem(c, {
                 status: 400,
                 title: titleOf(400),
-                detail: "This run cannot start yet; the listed fields need attention.",
+                detail: "This video cannot start yet. Fix the highlighted fields, then try again.",
                 extensions: {
                     fields: [...picked.missing, ...modelErrors, ...(admitted.ok ? [] : admitted.fields)],
                 },
@@ -136,7 +136,7 @@ export function projectRoutes(deps) {
             return problem(c, {
                 status: 404,
                 title: titleOf(404),
-                detail: "No project has that id.",
+                detail: "This project no longer exists. Go back to Projects to pick another.",
             });
         }
         if (deps.catalogue !== undefined)
@@ -171,8 +171,8 @@ const deleteStatus = {
     files: 500,
 };
 const deleteDetails = {
-    "no-project": "No project has that id.",
+    "no-project": "This project no longer exists. Go back to Projects to pick another.",
     // The run has to be stopped before its files can go.
-    running: "This project is still running. Cancel the run first.",
-    files: "Some of this project's files could not be removed.",
+    running: "This project is still running. Use Cancel run on the project page first, then delete it.",
+    files: "Some of this project's files could not be removed. Close any program using files in the project folder, then try deleting again.",
 };

package/dist/edge/http/prompts.js

@@ -50,7 +50,7 @@ export function refused(c, failure, noun) {
             return problem(c, {
                 status: 400,
                 title: titleOf(400),
-                detail: `This ${noun} cannot be saved; the listed fields need attention.`,
+                detail: `This ${noun} cannot be saved yet. Fix the highlighted fields and try again.`,
                 extensions: { fields: failure.fields },
             });
         // The name is refused against a row that exists, and the form marks the field.
@@ -58,16 +58,21 @@ export function refused(c, failure, noun) {
             return problem(c, {
                 status: 409,
                 title: titleOf(409),
-                detail: `Another ${noun} already has this name.`,
+                detail: `Another ${noun} already has this name. Choose a different name.`,
                 extensions: {
-                    fields: [{ field: "name", message: `Another ${noun} already has this name.` }],
+                    fields: [
+                        {
+                            field: "name",
+                            message: `Another ${noun} already has this name. Choose a different name.`,
+                        },
+                    ],
                 },
             });
         case "not-found":
             return problem(c, {
                 status: 404,
                 title: titleOf(404),
-                detail: `No ${noun} has that id.`,
+                detail: `This ${noun} no longer exists; it may have been deleted. Go back to the Library to pick another.`,
             });
     }
 }

package/dist/edge/http/providers.js

@@ -29,10 +29,16 @@ export function providerRoutes(deps) {
         report: (provider) => deps.log.write("warn", "model-catalog", { detail: `Could not load models for ${provider}` }),
     });
     return (new Hono()
-        .get("/catalogue", (c) => c.json(deps.catalogue?.status() ?? { warning: "Catalogue unavailable." }))
+        .get("/catalogue", (c) => c.json(deps.catalogue?.status() ?? {
+        warning: "The model list (models.yaml) is not loaded yet. Wait a moment and reload the page; if it stays like this, restart Slopify.",
+    }))
         .post("/catalogue/refresh", async (c) => {
         if (!deps.catalogue)
-            return problem(c, { status: 503, title: titleOf(503), detail: "Catalogue unavailable." });
+            return problem(c, {
+                status: 503,
+                title: titleOf(503),
+                detail: "The model list (models.yaml) is not loaded yet. Wait a moment and reload the page; if it stays like this, restart Slopify.",
+            });
         try {
             await deps.catalogue.refresh();
         }
@@ -40,7 +46,7 @@ export function providerRoutes(deps) {
             return problem(c, {
                 status: 502,
                 title: titleOf(502),
-                detail: "Could not update the catalogue. The last valid version remains in use.",
+                detail: "Slopify could not download the latest model list. Your current list is still in use; check your internet connection and try Refresh again.",
             });
         }
         return c.json(deps.catalogue.status());
@@ -104,20 +110,22 @@ function refusal(c, id, reason) {
         return problem(c, {
             status: 400,
             title: titleOf(400),
-            detail: `${name} signs in through its own CLI, so there is no key to store here.`,
+            detail: `${name} signs in through its own command-line tool, so it has no API key to save here. Sign in with that tool on your computer instead.`,
         });
     }
     if (reason === "absent") {
         return problem(c, {
             status: 404,
             title: titleOf(404),
-            detail: `No key is stored for ${name}.`,
+            detail: `There is no saved API key for ${name}, so there is nothing to remove.`,
         });
     }
     return problem(c, {
         status: 400,
         title: titleOf(400),
-        detail: "This key cannot be saved; the listed fields need attention.",
-        extensions: { fields: [{ field: "key", message: "An API key is required." }] },
+        detail: "This API key cannot be saved yet. Paste the key and try again.",
+        extensions: {
+            fields: [{ field: "key", message: "Paste the API key from your provider's account page." }],
+        },
     });
 }