@gentbajko/slopify 2.0.2 → 2.1.0

package/dist/edge/docker.js

@@ -5,13 +5,13 @@ import { z } from "zod";
 import { installHostPackage } from "../host-cli/install.js";
 import { ensureBridgeToken, hasCode, prepareHostPaths } from "../host-cli/paths.js";
 import { ensureHostService, privateRead, privateWrite } from "../host-cli/service.js";
-import { resolveHostCommand } from "../host-cli/status.js";
+import { hostCommandName, resolveHostCommand } from "../host-cli/status.js";
 import { hostCliProtocol, hostLlmIds } from "../kernel/ports/host-cli.js";
 export function assertManagedDockerHost(platform, uid, gid) {
     if (platform !== "linux")
-        throw new Error("The managed Docker launcher requires Linux. Native Slopify and plain API-only Docker remain available on other hosts.");
+        throw new Error("The --docker launcher only works on Linux. On this system, run Slopify without Docker (npx @gentbajko/slopify), or start the Slopify Docker image yourself with docker run.");
     if (uid === undefined || gid === undefined || uid === 0)
-        throw new Error("Run the managed Docker launcher as your logged-in user, not with sudo; grant that account access to Docker.");
+        throw new Error("Don't run the --docker launcher with sudo or as root. Run it as your normal user, and if Docker then says permission denied, give your user access: sudo usermod -aG docker $USER, then log out and back in.");
 }
 export async function prepareDockerHostCli(options) {
     if (options.disabled)
@@ -24,16 +24,16 @@ export async function prepareDockerHostCli(options) {
         }
         catch (error) {
             if (!hasCode(error, "ENOENT"))
-                throw new Error("Host CLI detection failed. No container was changed.");
+                throw new Error(`Could not check whether ${hostCommandName(id)} is installed on this machine (${error instanceof Error ? error.message : String(error)}). Nothing was changed. Fix the problem, or start with --host-cli=off to use API keys only.`);
         }
     }
     if (!installed)
         return {};
     if (process.platform !== "linux")
-        throw new Error("Managed host CLI setup requires Linux/systemd. Use --host-cli=off for API-only Docker.");
+        throw new Error("Using this machine's AI CLIs from Docker needs Linux with systemd. Start with --host-cli=off to use API keys only.");
     const uid = process.getuid?.();
     if (uid === undefined || uid === 0)
-        throw new Error("Run the Docker launcher as your logged-in user, not root; or use --host-cli=off.");
+        throw new Error("Don't run the --docker launcher with sudo or as root; run it as your normal user. Or start with --host-cli=off to use API keys only.");
     const receiptPath = join(options.root, "consent.json");
     const existing = await privateRead(receiptPath, uid);
     const receipt = z.object({ version: z.literal(1), automaticStartup: z.literal(true) }).strict();
@@ -43,15 +43,15 @@ export async function prepareDockerHostCli(options) {
             approved ||= receipt.safeParse(JSON.parse(existing)).success;
         }
         catch {
-            throw new Error("Invalid host helper consent receipt.");
+            throw new Error(`The saved answer to the host CLI question (${receiptPath}) is damaged. Delete that file and run the launcher again to be asked again.`);
         }
     }
     if (!approved) {
         if (!options.interactive)
-            throw new Error("Host CLI setup needs confirmation. Use --accept-host-cli to approve, or --host-cli=off for API-only Docker.");
+            throw new Error("Slopify needs your OK to use the Claude Code, Codex or Gemini CLI installed on this machine, but can't ask because this isn't an interactive terminal. Rerun with --accept-host-cli to allow it, or with --host-cli=off to use API keys only.");
         approved = await options.prompt("Allow Slopify to run your host Claude Code, Codex and Gemini CLIs using their existing logins? This installs a private helper and enables automatic startup. User lingering keeps your user services running after logout and at boot. Credentials stay on the host. [y/N] ");
         if (!approved)
-            throw new Error("Host CLI setup declined. The container is unchanged. Use --host-cli=off for API-only Docker.");
+            throw new Error("You declined, so Slopify did not set up your host AI CLIs and nothing was changed. Run the launcher again and answer y to allow it, or add --host-cli=off to start with API keys only.");
     }
     const inspect = () => options.runner.exec("docker", [
         "image",
@@ -64,14 +64,14 @@ export async function prepareDockerHostCli(options) {
     if (image.code !== 0 || image.stdout.trim() !== String(hostCliProtocol)) {
         const pulled = await options.runner.exec("docker", ["pull", options.image], options.signal);
         if (pulled.code !== 0)
-            throw new Error("Could not pull a compatible Docker image. No helper or container was changed.");
+            throw new Error(`Could not download the Slopify Docker image ${options.image}. Check your internet connection and that Docker is running (docker info), then try again. Nothing was changed.`);
         image = await inspect();
         if (image.code !== 0 || image.stdout.trim() !== String(hostCliProtocol))
-            throw new Error("This Docker image does not support the host helper. Update the image before retrying.");
+            throw new Error(`The Docker image ${options.image} is too old to use the AI CLIs on this machine. Use the latest image (unset SLOPIFY_DOCKER_IMAGE, or point it to a current release) and try again, or start with --host-cli=off.`);
     }
     const supported = await options.runner.exec("systemctl", ["--user", "list-units", "--no-legend", "--no-pager", "slopify-cli-bridge.service"], options.signal);
     if (supported.code !== 0)
-        throw new Error("The systemd user service is unavailable. Use a normal Slopify install or --host-cli=off for API-only Docker.");
+        throw new Error("Using this machine's AI CLIs from Docker needs systemd user services (systemctl --user), which aren't available here. Start with --host-cli=off to use API keys only, or run Slopify without Docker: npx @gentbajko/slopify.");
     const paths = await prepareHostPaths(options.root);
     const lock = join(paths.root, "setup.lock");
     const deadline = Date.now() + 30_000;
@@ -84,7 +84,7 @@ export async function prepareDockerHostCli(options) {
             if (!hasCode(error, "EEXIST"))
                 throw error;
             if (Date.now() >= deadline)
-                throw new Error("Another host helper setup holds setup.lock. Wait for it to finish; the container is unchanged.");
+                throw new Error(`Another Slopify launcher is setting up the host CLI helper right now. Wait for it to finish and try again. If no other launcher is running, delete the folder ${lock} and retry.`);
             await delay(100, undefined, { signal: options.signal });
         }
     }

package/dist/edge/host-cli.js

@@ -1,15 +1,18 @@
 import { constants } from "node:fs";
 import { open } from "node:fs/promises";
+import { homedir } from "node:os";
 import { join } from "node:path";
 import { parseArgs } from "node:util";
 import { nodeRunCli } from "../adapters/llm/run-cli.js";
 import { hostEnvironmentSchema } from "../host-cli/environment.js";
+import { launchXdgOpen } from "../host-cli/open-folder.js";
 import { ensureBridgeToken, prepareHostPaths } from "../host-cli/paths.js";
 import { createHostRuntime } from "../host-cli/runtime.js";
 import { startHostServer } from "../host-cli/server.js";
 import { resolveHostCommand } from "../host-cli/status.js";
 import { readVersion } from "../kernel/version.js";
 import { nodeCliProbe } from "../slices/settings/cli-status.js";
+import { dockerRoot } from "./docker-projects/state.js";
 const { values } = parseArgs({ options: { "state-dir": { type: "string" } }, strict: true });
 if (!values["state-dir"])
     throw new Error("A host helper state directory is required.");
@@ -32,6 +35,14 @@ try {
 finally {
     await file.close();
 }
+// Without a usable data folder there are no launcher receipts, so Open folder stays unsupported.
+let folderRoot;
+try {
+    folderRoot = dockerRoot(process.env, process.env.HOME || homedir());
+}
+catch {
+    folderRoot = undefined;
+}
 const server = await startHostServer({
     directory: paths.share,
     token: await ensureBridgeToken(paths.tokenFile),
@@ -42,6 +53,9 @@ const server = await startHostServer({
         env: process.env,
         now: Date.now,
         resolve: (id) => resolveHostCommand(id, process.env),
+        ...(process.getuid === undefined || folderRoot === undefined
+            ? {}
+            : { folders: { root: folderRoot, uid: process.getuid(), launch: launchXdgOpen } }),
     }),
 });
 process.on("SIGHUP", server.pauseAdmissions);

package/dist/edge/http/actions.js

@@ -91,15 +91,15 @@ export function actionRoutes(deps) {
             "rebuild-required": 409,
         };
         const messages = {
-            "no-project": "No project has that id.",
-            running: "Pause the run and wait for its active calls to stop before changing providers.",
-            "not-editable": "Providers can be changed only while a project is paused or failed.",
-            "invalid-providers": "The provider choices need attention.",
-            "catalog-unavailable": "The provider model catalog could not be loaded. Try again.",
-            "revision-required": "Reload the project before using this control. A current revision and request ID are required.",
-            conflict: "The project changed. Reload it before using this control.",
-            "idempotency-conflict": "This request ID has already been used for a different action.",
-            "rebuild-required": "Review the affected outputs and cost before rebuilding this revision.",
+            "no-project": "This project no longer exists. Go back to Projects to pick another.",
+            running: "This project is still running. Pause it and wait for the current step to stop before changing providers.",
+            "not-editable": "Providers can be changed only while the project is paused or has failed. Pause it first, then try again.",
+            "invalid-providers": "Some provider choices are not valid. Fix the highlighted fields and try again.",
+            "catalog-unavailable": "Slopify could not load the list of available models. Wait a moment and try again; if it keeps failing, check Settings → Models.",
+            "revision-required": "This page is out of date. Reload the page, then try again.",
+            conflict: "This project changed since the page loaded. Reload the page to see the latest, then try again.",
+            "idempotency-conflict": "This action was already sent with different details. Reload the page, then try again.",
+            "rebuild-required": "This change needs some outputs to be made again. In the Edit tab, use Rebuild affected outputs to see what will be regenerated and what it costs.",
         };
         return problem(c, {
             status: codes[result.reason],
@@ -117,7 +117,7 @@ export function actionRoutes(deps) {
             return problem(c, {
                 status: 503,
                 title: titleOf(503),
-                detail: "Recovery is unavailable. Try again after restart.",
+                detail: "Resume and retry are not ready yet because Slopify is still starting. Wait a moment, reload the page and try again.",
             });
         const result = recoveryResultSchema.parse(await recoverProject(deps.rebuild, id, { ...input, action }));
         if (result.ok)
@@ -128,26 +128,28 @@ export function actionRoutes(deps) {
                 ? 400
                 : 409;
         const messages = {
-            "no-project": "This project no longer exists.",
-            "no-revision": "This revision no longer exists. Reload the project.",
-            conflict: "The saved project changed. Reload it and try Resume.",
-            "idempotency-conflict": "This request ID belongs to another action. Reload the project.",
-            "invalid-edit": "This section needs attention in Edit project before rerunning.",
-            "stale-preview": "The required work changed. Try Resume to check it again.",
-            "invalid-selection": "This section has no generated work to rerun. Use Edit project to change its source.",
-            "review-required": "Changed supplied content or manual captions need Edit project or optional Advanced rebuild review.",
-            "cost-ack-required": "Use optional Advanced rebuild review for this request.",
-            readiness: "Check the provider, model, voice or source files, then try Resume.",
-            running: "Wait for this section to finish, or Pause the project before rerunning it.",
-            "accepted-job": "This section cannot be rerun yet.",
-            "control-changed": "A newer control action took precedence. Check the project before using Resume.",
+            "no-project": "This project no longer exists. Go back to Projects to pick another.",
+            "no-revision": "The project's saved settings changed since the page loaded. Reload the page, then try again.",
+            conflict: "This project changed since the page loaded. Reload the page to see the latest, then use Resume again.",
+            "idempotency-conflict": "This action was already sent with different details. Reload the page, then try again.",
+            "invalid-edit": "This section has settings that need fixing first. Open the Edit tab, choose Edit project and correct this section, then try again.",
+            "stale-preview": "What needs to be made changed since the page loaded. Reload the page, then use Resume again.",
+            "invalid-selection": "This section has nothing generated to re-run because its content was supplied by you. To change it, open the Edit tab and choose Edit project.",
+            "review-required": "Content you supplied or captions you edited by hand would be replaced. Change them in the Edit tab with Edit project, or use Rebuild affected outputs to confirm the replacement.",
+            "cost-ack-required": "This re-run needs you to review its cost first. In the Edit tab, use Rebuild affected outputs.",
+            readiness: "Slopify cannot run this yet. Check the provider, model, voice and any files you supplied, then use Resume.",
+            running: "This section is still running. Wait for it to finish, or Pause the project, before re-running it.",
+            "accepted-job": "This section has a finished provider job that Slopify has not collected yet.",
+            "control-changed": "Another action on this project (such as Pause or Cancel) happened at the same time. Reload the page to see its current state, then try again.",
         };
         const detail = [
             messages[result.reason],
             ...(result.fields ?? []).map((row) => row.message),
             ...(result.intentRevisionId === undefined
                 ? []
-                : ["The rerun revision was saved. Use Resume to continue it; do not rerun again."]),
+                : [
+                    "Your re-run request was saved. Use Resume to continue it instead of re-running again.",
+                ]),
         ].join(" ");
         return problem(c, {
             status,
@@ -218,7 +220,7 @@ function revisionRequired(c) {
     return problem(c, {
         status: 409,
         title: titleOf(409),
-        detail: "Open Edit project to save changes, then review the affected rebuild.",
+        detail: "This change is now made from the Edit tab. Choose Edit project, save your change, then use Rebuild affected outputs.",
         extensions: { reason: "revision-required" },
     });
 }

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-schema.js

@@ -1,11 +1,8 @@
 import { z } from "zod";
-export const folderReplySchema = z.discriminatedUnion("opened", [
+const dockerHost = { location: z.literal("docker-host"), path: z.string().min(1) };
+// In Docker the host helper may open the folder itself; the host path is sent either way.
+export const folderReplySchema = z.union([
     z.object({ opened: z.literal(true) }).strict(),
-    z
-        .object({
-        opened: z.literal(false),
-        location: z.literal("docker-host"),
-        path: z.string().min(1),
-    })
-        .strict(),
+    z.object({ opened: z.literal(true), ...dockerHost }).strict(),
+    z.object({ opened: z.literal(false), ...dockerHost }).strict(),
 ]);

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);
@@ -27,11 +27,16 @@ export async function replyForFolder(c, deps, projectId, file) {
                 if (s.isSymbolicLink() || (i === parts.length - 1 ? !s.isFile() : !s.isDirectory()))
                     throw new Error("Unavailable output");
             }
-            return c.json(folderReplySchema.parse({
-                opened: false,
-                location: "docker-host",
-                path: join(host, dirname(r)),
-            }));
+            const hostPath = join(host, dirname(r));
+            const opened = (await deps.folderLocation
+                .openOnHost?.(hostPath, AbortSignal.timeout(10_000))
+                .catch(() => false)) === true;
+            if (!opened && deps.folderLocation.openOnHost)
+                deps.log.write("warn", "project.open-folder", {
+                    projectId,
+                    detail: "The host helper did not open the folder (not installed, too old, or it refused), so the host path was shown instead.",
+                });
+            return c.json(folderReplySchema.parse({ opened, location: "docker-host", path: hostPath }));
         }
         catch {
             deps.log.write("warn", "project.locate-folder", {
@@ -41,7 +46,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 +64,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.",
             };
     }
 }