@gentbajko/slopify 2.0.2 → 2.1.0

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

@@ -5,7 +5,7 @@ import { stream } from "hono/streaming";
 import { z } from "zod";
 import { sniffImage } from "../../adapters/image/bytes.js";
 import { redact } from "../../kernel/log.js";
-import { bridgeLimits, hostCliIds, hostCliProtocol, hostFrameSchema, hostImageSchema, hostLlmIds, hostLlmSchema, hostModelsSchema, hostStatusSchema, } from "../../kernel/ports/host-cli.js";
+import { bridgeLimits, HostFolderRefused, hostCliIds, hostCliProtocol, hostFrameSchema, hostImageSchema, hostLlmIds, hostLlmSchema, hostModelsSchema, hostOpenFolderSchema, hostStatusSchema, } from "../../kernel/ports/host-cli.js";
 import { isProviderError, providerError } from "../../kernel/ports/model.js";
 export function hostGate() {
     let accepting = true;
@@ -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();
     });
@@ -78,13 +82,14 @@ export function hostCliRoutes(options) {
         accepting: gate.accepting,
     }));
     app.use("/v1/*", async (c, next) => {
-        const kind = c.req.method === "POST" ? "generation" : "metadata";
+        // Opening a folder is quick and must not look like running work to the launcher's upgrade check.
+        const kind = c.req.method === "POST" && c.req.path !== "/v1/open-folder" ? "generation" : "metadata";
         const job = gate.acquire(kind);
         if (!job)
             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 +133,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 +146,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 +160,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 +192,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 +232,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));
@@ -230,8 +245,36 @@ export function hostCliRoutes(options) {
             controller.abort();
         }
     });
+    app.post("/v1/open-folder", async (c) => {
+        const open = ports.openFolder;
+        if (!open)
+            return c.notFound();
+        const body = hostOpenFolderSchema.safeParse(await json(c.req.raw));
+        if (!body.success)
+            return invalid(c);
+        try {
+            await open(body.data.path);
+        }
+        catch (error) {
+            const refused = error instanceof HostFolderRefused;
+            return c.json({
+                type: "error",
+                kind: "unavailable",
+                message: (error instanceof Error
+                    ? error.message
+                    : "The Slopify host helper could not open the folder. Copy the path into your file manager instead.")
+                    .replaceAll(token, "[redacted]")
+                    .slice(0, 4096),
+            }, refused ? 403 : 503);
+        }
+        return c.json({ opened: true });
+    });
     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 +286,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." }],
+        },
     });
 }

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

@@ -33,10 +33,14 @@ export function revisionFileRoutes(deps) {
         if (!result.ok)
             return unavailable(c, result.reason);
         const value = result.download;
+        // `?inline=1` lets the project page open a PDF in a browser tab instead of saving
+        // it. Only PDFs: anything else the browser might render stays a download.
+        const inline = c.req.query("inline") === "1" && value.contentType === "application/pdf";
         return c.body(Readable.toWeb(createReadStream(value.path)), 200, {
             "content-type": value.contentType,
             "content-length": String(value.bytes),
-            "content-disposition": `attachment; filename="${value.filename}"`,
+            "content-disposition": `${inline ? "inline" : "attachment"}; filename="${value.filename}"`,
+            "x-content-type-options": "nosniff",
         });
     });
 }
@@ -47,7 +51,7 @@ export function revisionFolderRoutes(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: projectId, revisionId, recordId } = c.req.valid("param");
         const result = findRevisionDownload(deps, projectId, revisionId, recordId);
@@ -61,8 +65,8 @@ function unavailable(c, reason) {
         status: 404,
         title: titleOf(404),
         detail: reason === "missing-file"
-            ? "This retained file is no longer on disk. Review the affected rebuild to recreate it."
-            : "The retained file is unavailable.",
+            ? "This file was deleted or moved from the project folder. In the Edit tab, use Rebuild affected outputs to make it again."
+            : "This file is no longer part of the project. Reload the page to see its current files.",
         extensions: { reason },
     });
 }

package/dist/edge/http/revisions.js

@@ -3,6 +3,7 @@ import { Hono } from "hono";
 import { z } from "zod";
 import { projectExists } from "../../slices/admission/repo.js";
 import { previewRebuildSchema, startRebuildSchema } from "../../slices/rebuild/model.js";
+import { narrationChunkOrder } from "../../slices/rebuild/runtime-narration-text.js";
 import { previewRebuild, startRebuild } from "../../slices/rebuild/service.js";
 import { ensureBaseline, restoreRevision, saveRevision } from "../../slices/revisions/index.js";
 import { currentRevisionId, listRevisionHistory } from "../../slices/revisions/repo.js";
@@ -30,12 +31,24 @@ const statuses = {
     "cost-ack-required": 409,
     readiness: 409,
 };
+const details = {
+    "no-project": "This project no longer exists. Go back to Projects to pick another.",
+    "no-revision": "This saved version of the project no longer exists. Reload the page, then try again.",
+    conflict: "This project changed while you were editing. Reload the page to see the latest, then make your change again.",
+    "idempotency-conflict": "This change was already sent with different details. Reload the page, then try again.",
+    "invalid-edit": "Some of your changes are not valid. Fix the highlighted fields and save again.",
+    "stale-preview": "What needs rebuilding changed since you opened this review. Cancel it and open Rebuild affected outputs again to see the latest.",
+    "invalid-selection": "Some of the outputs you picked can no longer be rebuilt. Reload the page and choose again.",
+    "review-required": 'This rebuild touches content you supplied yourself. Tick "Keep the provided content" for each item in the review, then choose Start rebuild.',
+    "cost-ack-required": "Some costs for this rebuild are unknown. Tick the box confirming you understand, then choose Start rebuild.",
+    readiness: "Slopify cannot run this rebuild yet. Fix the problems listed, then try again.",
+};
 function refused(c, deps, projectId, value) {
     const status = statuses[value.reason];
     return problem(c, {
         status,
         title: titleOf(status),
-        detail: value.reason.replaceAll("-", " "),
+        detail: details[value.reason],
         extensions: {
             reason: value.reason,
             currentRevisionId: currentRevisionId(deps.db, projectId) ?? null,
@@ -47,11 +60,11 @@ function unavailable(c) {
     return problem(c, {
         status: 503,
         title: titleOf(503),
-        detail: "Rebuild services are unavailable.",
+        detail: "Rebuilding is not ready yet because Slopify is still starting. Wait a moment, reload the page and try again.",
     });
 }
 export function revisionRoutes(deps) {
-    return new Hono()
+    return (new Hono()
         .post("/:id/revisions/prepare", zValidator("param", projectParam, onInvalid), async (c) => {
         const projectId = c.req.valid("param").id;
         const result = await ensureBaseline(deps, projectId);
@@ -69,6 +82,19 @@ export function revisionRoutes(deps) {
         return view === undefined
             ? refused(c, deps, projectId, { reason: "no-revision" })
             : c.json({ view });
+    })
+        // Chunk keys in spoken order, so the Narration editor numbers chunks the way a subtitle
+        // error names them. Building the plan is the costly part, so it has its own request.
+        .get("/:id/revisions/:revisionId/narration-chunks", zValidator("param", revisionParam, onInvalid), (c) => {
+        const { id: projectId, revisionId } = c.req.valid("param");
+        let chunks;
+        try {
+            chunks = narrationChunkOrder(deps, projectId, revisionId);
+        }
+        catch {
+            chunks = undefined;
+        }
+        return c.json({ chunks: chunks ?? null });
     })
         .post("/:id/revisions", zValidator("param", projectParam, onInvalid), zValidator("json", saveBody, onInvalid), async (c) => {
         const projectId = c.req.valid("param").id;
@@ -99,5 +125,5 @@ export function revisionRoutes(deps) {
         const projectId = c.req.valid("param").id;
         const result = await startRebuild(deps.rebuild, { projectId, ...c.req.valid("json") });
         return result.ok ? c.json(result, 202) : refused(c, deps, projectId, result);
-    });
+    }));
 }

package/dist/edge/http/schedules.js

@@ -13,15 +13,15 @@ function refused(c, result) {
             ? 409
             : 400;
     const detail = {
-        "invalid-input": "Check the schedule fields and try again.",
-        "not-found": "The schedule was not found.",
-        conflict: "The schedule changed elsewhere. Reload it before trying again.",
-        "cancel-required": "Cancel this schedule before deleting it. Completed schedules can be deleted directly.",
-        "missing-template": "The selected template version is no longer available.",
-        "unsupported-media": "This template contains provided media and cannot run unattended.",
-        "not-due": "Choose a future one-off time.",
-        "spend-limit": "The estimate exceeds the schedule spend limit or contains unknown pricing.",
-        readiness: "Provider or local readiness checks refused this scheduled run.",
+        "invalid-input": "Some schedule settings are not valid. Check each field and save again.",
+        "not-found": "This schedule no longer exists; it may have been deleted. Reload the page to see your schedules.",
+        conflict: "This schedule changed while you were editing, possibly because a run just started. Reload the page to see the latest, then make your change again.",
+        "cancel-required": "This schedule is still active. Cancel it first, then delete it. Completed schedules can be deleted straight away.",
+        "missing-template": "The template you picked was deleted or changed. Choose a template again, then save.",
+        "unsupported-media": "This template uses audio, images or a thumbnail you supplied, so it cannot run on a schedule. Pick a template that generates these instead.",
+        "not-due": "This one-off time has already passed. Choose a time in the future.",
+        "spend-limit": "The estimated cost is above this schedule's spend limit, or some prices are unknown. Raise the spend limit or choose models with known prices.",
+        readiness: "A provider this template needs is not ready, for example a missing API key, model or voice. Check Settings → Providers, then try again.",
     };
     return problem(c, {
         status,