@gentbajko/slopify 4.0.0 → 4.2.0

package/dist/edge/http/onboarding.js

@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
 import { zValidator } from "@hono/zod-validator";
 import { Hono } from "hono";
 import { z } from "zod";
-import { defaultSpeechVoice, detectSpeechCached, primaryLanguage, } from "../../kernel/ports/system-speech.js";
+import { defaultSpeechVoice, detectSpeechCached, forgetDetectedSpeech, primaryLanguage, speechInstall, } from "../../kernel/ports/system-speech.js";
 import { loudnessOfDefault } from "../../slices/loudness/model.js";
 import { firstRunView } from "../../slices/onboarding/first-run.js";
 import { fullVideoDraft } from "../../slices/onboarding/full-video.js";
@@ -15,9 +15,10 @@ import { dismissFirstRun, recordShortRequest, shortRequestProject, } from "../..
 import { systemVoiceProvider } from "../../slices/settings/model.js";
 import { readSettings } from "../../slices/settings/playback.js";
 import { providerStatuses } from "../../slices/settings/readiness.js";
-import { listVoices } from "../../slices/settings/repo.js";
+import { listVoices, writeSetting } from "../../slices/settings/repo.js";
 import { addVoice } from "../../slices/settings/voices.js";
 import { projectTitle } from "../../slices/storage/repo.js";
+import { autostartAnsweredKey } from "../autostart/model.js";
 import { onInvalid, problem } from "./problem.js";
 import { createProject } from "./project-create.js";
 const packParam = z.object({ id: z.string().min(1).max(40) });
@@ -30,7 +31,16 @@ export function onboardingRoutes(deps) {
         hostCliStatus: deps.hostCliStatus,
         host: deps.speechHost,
     });
-    const speech = () => detectSpeechCached(deps.probe, deps.speechHost ?? process);
+    const host = deps.speechHost ?? process;
+    const speech = () => detectSpeechCached(deps.probe, host);
+    const view = async () => firstRunView(deps.db, await statuses(), speechInstall(host));
+    // Done with the first-run screen (Skip, Done, a first short, or a project made elsewhere):
+    // it also answers "Start Slopify when I log in" as No, so a fresh install is never asked it
+    // in a dialog over Home. The screen's own row and Settings → General still turn it on.
+    const doneWithFirstRun = () => {
+        dismissFirstRun(deps.db, deps.clock.now().toISOString());
+        writeSetting(deps.db, autostartAnsweredKey, "1");
+    };
     // The best speech program found and its English voice, for a short made without a voice key.
     const systemVoicePick = async () => {
         const engine = (await speech()).engines[0];
@@ -53,10 +63,16 @@ export function onboardingRoutes(deps) {
     return new Hono()
         .get("/", async (c) => {
         c.header("Cache-Control", "no-store");
-        return c.json(firstRunView(deps.db, await statuses()));
+        return c.json(await view());
+    })
+        .post("/check", async (c) => {
+        // The checklist's Check again: looks for a speech program afresh instead of answering
+        // from the last minute's look, so a program installed a moment ago is found.
+        forgetDetectedSpeech(deps.probe);
+        return c.json(await view());
     })
         .post("/dismiss", (c) => {
-        dismissFirstRun(deps.db, deps.clock.now().toISOString());
+        doneWithFirstRun();
         return c.json({ dismissed: true });
     })
         .post("/packs/:id", zValidator("param", packParam, onInvalid), (c) => {
@@ -64,7 +80,7 @@ export function onboardingRoutes(deps) {
         if (!installed.ok)
             return problem(c, {
                 status: 404,
-                detail: "Slopify doesn't have that starter pack. Reload the page and pick one of the packs listed.",
+                detail: "Slopify doesn't have that starter template. Reload the page and pick one of the templates listed.",
             });
         return c.json(installed.value);
     })
@@ -77,7 +93,7 @@ export function onboardingRoutes(deps) {
         if (pack === undefined)
             return problem(c, {
                 status: 404,
-                detail: "Slopify doesn't have that starter pack. Reload the page and pick one of the packs listed.",
+                detail: "Slopify doesn't have that starter template. Reload the page and pick one of the templates listed.",
             });
         const modelsFor = deps.modelsFor;
         if (modelsFor === undefined)
@@ -91,6 +107,7 @@ export function onboardingRoutes(deps) {
             modelsFor,
             suggested: pack.voice,
             systemVoice: await systemVoicePick(),
+            install: speechInstall(host),
         });
         if (!plan.ok)
             return problem(c, {
@@ -102,7 +119,7 @@ export function onboardingRoutes(deps) {
         if (!installed.ok)
             return problem(c, {
                 status: 404,
-                detail: "Slopify doesn't have that starter pack. Reload the page and pick one of the packs listed.",
+                detail: "Slopify doesn't have that starter template. Reload the page and pick one of the templates listed.",
             });
         // The computer's voice is saved like any other, so Play and a later rebuild offer it.
         const audio = plan.providers.audio;
@@ -135,7 +152,7 @@ export function onboardingRoutes(deps) {
             });
         recordShortRequest(deps.db, input.requestId, created.project.id);
         // A real project now exists, so the first-run screen is done with.
-        dismissFirstRun(deps.db, deps.clock.now().toISOString());
+        doneWithFirstRun();
         return c.json({ projectId: created.project.id, replayed: false }, 201);
     })
         .post("/full-video", zValidator("json", fullVideoInputSchema, onInvalid), (c) => {
@@ -145,16 +162,16 @@ export function onboardingRoutes(deps) {
         if (made.reason === "not-found")
             return problem(c, {
                 status: 404,
-                detail: "This short or its starter pack is no longer here, so Play couldn't be set up from it. Open Play and pick a template yourself.",
+                detail: "This short or its starter template is no longer here, so Create couldn't be set up from it. Open Create and pick a template yourself.",
             });
         if (made.reason === "not-short")
             return problem(c, {
                 status: 409,
-                detail: "This project is already a long video. Open Play to start another one on a new topic.",
+                detail: "This project is already a long video. Open Create to start another one on a new topic.",
             });
         return problem(c, {
             status: 409,
-            detail: "Slopify couldn't open a Play draft for the full video. Press Make the full video on this topic again; if it keeps failing, open Play and pick the pack's template in Library → Templates.",
+            detail: "Slopify couldn't open a draft on Create for the full video. Press Make the full video on this topic again; if it keeps failing, press Make a video on the starter template in Templates.",
             extensions: { reason: made.reason },
         });
     })

package/dist/edge/http/outputs.js

@@ -1,5 +1,6 @@
 import { zValidator } from "@hono/zod-validator";
 import { Hono } from "hono";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { addOutputPreviewRequestSchema, addOutputRequestSchema, } from "../../slices/outputs/model.js";
 import { addOutput, previewAddedOutput, } from "../../slices/outputs/service.js";
 import { currentRevisionId } from "../../slices/revisions/repo.js";
@@ -21,10 +22,10 @@ const details = {
     "no-revision": "This saved version of the project no longer exists. Reload the page, then open Add another output again.",
     conflict: "This project changed while you were choosing. Reload the page, then open Add another output again.",
     "idempotency-conflict": "This output was already requested with different details. Reload the page, then try again.",
-    "invalid-edit": "This project is missing a choice the new output needs. Set the fields listed in this project's Settings, save, then add the output again.",
+    "invalid-edit": "This project is missing a choice the new output needs. Set the fields listed in Edit settings, save, then add the output again.",
     already: "This project already makes that output. Find it in its section on the left.",
     "needs-article": "That output is made from the article, which this project does not have yet. Wait for the Article step to finish, then add it.",
-    "narration-taken": "This project already has narration, and a project has one. Keep it, or change its format under Speakers in this project's Settings → Providers.",
+    "narration-taken": `This project already has narration, and a project has one. Keep it, or change its format under Speakers in ${editSettings.narration}.`,
     "adaptation-not-accepted": 'This output rewrites your article as a conversation. Tick "Adapt my article into a conversation" in Add another output, then add it.',
 };
 // Add another output: what it reuses, makes and costs, then the revision that switches it on.

package/dist/edge/http/patch-notes.js

@@ -3,7 +3,7 @@ import { bundledPatchNotesDir, PatchNotesMissing, readPatchNote, } from "../../s
 import { markPatchNotesSeen, readPatchNotes } from "../../slices/patch-notes/seen.js";
 import { problem } from "./problem.js";
 import { bundleMissing } from "./refusal.js";
-// Settings → Patch notes: the list (with which note is due to open by itself), one note's
+// Settings → What's new: the list (with which note is due to open by itself), one note's
 // Markdown, and recording that the note that opened by itself was closed.
 // Preserve Hono's inferred route types for the web client.
 export function patchNotesRoutes(deps) {
@@ -32,7 +32,7 @@ export function patchNotesRoutes(deps) {
         if (markdown === undefined)
             return problem(c, {
                 status: 404,
-                detail: "These patch notes are not in this version of Slopify. Open Settings → Patch notes and pick one from the list.",
+                detail: "These patch notes are not in this version of Slopify. Open Settings → What's new and pick one from the list.",
             });
         return c.body(markdown, 200, { "content-type": "text/markdown; charset=utf-8" });
     });

package/dist/edge/http/planning.js

@@ -94,7 +94,7 @@ export function planningRoutes(deps) {
         if (input.draft.checkpoints?.length)
             return problem(c, {
                 status: 409,
-                detail: "Videos with checkpoints turned on cannot be queued. Start them one at a time from Play with Review and start.",
+                detail: "Videos that pause for your review (Pauses and checks) can't be queued. Make them one at a time from Create.",
             });
         if (batchExists(deps.db, input.requestId))
             return c.json({ queue: queueEntries(deps.db, input.requestId) });

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

@@ -18,7 +18,7 @@ export async function createProject(deps, sent) {
         return {
             ok: false,
             status: 409,
-            detail: "This project has checkpoints turned on, so it must be started from Play with Review and start.",
+            detail: "This project pauses for your review (Pauses and checks), so it starts from Create: press Make the video there.",
             fields: [],
         };
     const subtitles = draft.subtitles;

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

@@ -23,11 +23,11 @@ function refused(c, result) {
         statuses: { "not-found": 404, conflict: 409, "referenced-by-schedule": 409 },
         otherwise: 400,
         detail: result.reason === "referenced-by-schedule"
-            ? "Some schedules still use this template. In Library > Schedules, cancel and delete them first; their run history is kept."
+            ? "Some schedules still use this template. In Calendar → Schedules, cancel and delete them first; their run history is kept."
             : result.reason === "missing-prompt"
                 ? "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."
+                    ? "This template no longer exists; it may have been deleted. Go to 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.",

package/dist/edge/http/projects.js

@@ -4,13 +4,15 @@ import { z } from "zod";
 import { transact } from "../../kernel/db/tx.js";
 import { derive, progressOf } from "../../kernel/runner/graph.js";
 import { listProjectHeads } from "../../slices/admission/heads.js";
+import { listingFacts } from "../../slices/admission/listing-facts.js";
 import { projectById, projectTrashed, runDraftSchema, stageStandingsByProject, stagesOf, stepFailuresByProject, } from "../../slices/admission/repo.js";
-import { readsByWaitBesideFailure, stepFailedWhileWaiting, } from "../../slices/admission/state-words.js";
+import { readsByWaitBesideFailure, retryingAt, stepFailedWhileWaiting, } from "../../slices/admission/state-words.js";
 import { lastStarter } from "../../slices/agents/repo.js";
 import { defaultChannelId } from "../../slices/channels/model.js";
 import { channelById, projectChannels, setProjectChannel } from "../../slices/channels/repo.js";
 import { withProjectControl } from "../../slices/control/lock.js";
 import { stagesWithEta } from "../../slices/eta/view.js";
+import { sampleProjectIds } from "../../slices/onboarding/sample.js";
 import { videoActivity } from "../../slices/rebuild/activity.js";
 import { projectHolds } from "../../slices/reviews/holds.js";
 import { adoptBaseline } from "../../slices/revisions/adopt.js";
@@ -18,7 +20,7 @@ import { currentRevisionId } from "../../slices/revisions/repo.js";
 import { limitWaitsByProject, listingWait } from "../../slices/run-cost/panel.js";
 import { outputsOf } from "../../slices/storage/repo.js";
 import { trashProject } from "../../slices/trash/service.js";
-import { setAsideProjects, uploadedAndSettled, uploadedProjects, } from "../../slices/uploads/repo.js";
+import { setAsideProjects, settledProjects, uploadedProjects } from "../../slices/uploads/repo.js";
 import { settledStatus } from "../../slices/uploads/rules.js";
 import { idParam } from "./ids.js";
 import { onInvalid, problem } from "./problem.js";
@@ -35,7 +37,7 @@ export function projectRoutes(deps) {
     };
     const summarise = (project) => {
         const stages = stagesOf(deps.db, project.id);
-        const status = settledStatus(derive(stages, project.paused), uploadedAndSettled(deps.db, project.id).has(project.id));
+        const status = settledStatus(derive(stages, project.paused), settledProjects(deps.db, project.id).has(project.id));
         return {
             ...project,
             status,
@@ -65,15 +67,20 @@ export function projectRoutes(deps) {
         const channels = projectChannels(deps.db);
         const uploads = uploadedProjects(deps.db);
         const aside = setAsideProjects(deps.db);
-        const settled = uploadedAndSettled(deps.db);
+        const settled = settledProjects(deps.db);
         const holds = projectHolds(deps.db, { standings, settled });
         const waits = limitWaitsByProject(deps.db);
         const failures = stepFailuresByProject(deps.db);
+        const samples = new Set(Object.values(sampleProjectIds(deps.db)));
+        const facts = listingFacts(deps.db);
         const projects = listProjectHeads(deps.db).map((project) => {
             const stages = standings.get(project.id) ?? [];
             const waiting = waits.get(project.id);
             const holding = holds.holding.get(project.id);
             const status = settledStatus(derive(stages, project.paused), settled.has(project.id));
+            const made = facts.get(project.id);
+            const finished = status === "done" || status === "partial";
+            const retry = status === "running" ? retryingAt(stages) : undefined;
             return {
                 ...project,
                 status,
@@ -89,7 +96,18 @@ export function projectRoutes(deps) {
                     ? { stepFailures: failures.get(project.id) ?? [] }
                     : {}),
                 ...(holding === undefined ? {} : { holding }),
+                ...(retry === undefined ? {} : { retryAt: retry }),
                 ...(waiting === undefined ? {} : { limitWaits: waiting.map(listingWait) }),
+                ...(samples.has(project.id) ? { sample: true } : {}),
+                ...(finished && made?.finishedAt !== undefined ? { finishedAt: made.finishedAt } : {}),
+                ...(made?.durationSeconds === undefined
+                    ? {}
+                    : { durationSeconds: made.durationSeconds }),
+                ...(made?.outputs === undefined ? {} : { outputs: made.outputs }),
+                ...(status === "partial" && made?.failedSteps !== undefined
+                    ? { failedSteps: made.failedSteps }
+                    : {}),
+                ...(made?.outdated === true ? { outdated: true } : {}),
             };
         });
         return c.json({ projects });

package/dist/edge/http/prompts.js

@@ -47,7 +47,7 @@ export function promptRoutes(deps) {
             ? refused(c, { ok: false, reason: "not-found" }, "prompt")
             : problem(c, {
                 status: 400,
-                detail: "Only an Image prompt can be marked photorealistic. Open the prompt from the Image tab in Library → Prompts.",
+                detail: "Only an Image prompt can be marked photorealistic. Open the prompt under Image in Prompts.",
             });
     })
         // Every saved version, newest first (`slices/library/history.ts`).
@@ -103,7 +103,7 @@ export function refused(c, failure, noun) {
         case "not-found":
             return problem(c, {
                 status: 404,
-                detail: `This ${noun} no longer exists; it may have been deleted. Go back to the Library to pick another.`,
+                detail: `This ${noun} no longer exists; it may have been deleted. Go back to Prompts to pick another.`,
             });
     }
 }

package/dist/edge/http/pronunciation-check.js

@@ -0,0 +1,133 @@
+import { readFileSync } from "node:fs";
+import { zValidator } from "@hono/zod-validator";
+import { Hono } from "hono";
+import { usesPronunciationGlossary } from "../../slices/admission/rules.js";
+import { splitEndMatter } from "../../slices/article/split.js";
+import { pronunciationRulesOf, readsPossessives } from "../../slices/narration/pronunciation.js";
+import { heardNames, namesAhead, namesAheadNotice, namesNarrated, narratedNotice, } from "../../slices/narration/pronunciation-check.js";
+import { wordsSchema } from "../../slices/rebuild/runtime-subtitles.js";
+import { currentRevisionId } from "../../slices/revisions/repo.js";
+import { getRevisionView, isReadyOutput, readyOutput } from "../../slices/revisions/view.js";
+import { outputPath } from "../../slices/storage/layout.js";
+import { projectTitle } from "../../slices/storage/repo.js";
+import { projectIdParam } from "./ids.js";
+import { onInvalid, problem } from "./problem.js";
+function sourcesOf(config, view) {
+    const glossary = usesPronunciationGlossary(config) && view.articleMarkdown !== null
+        ? splitEndMatter(view.articleMarkdown).glossary
+        : "";
+    return {
+        glossary,
+        ...(config.libraryPronunciations === undefined ? {} : { list: config.libraryPronunciations }),
+        ...(config.audio?.shareGlossary === true && config.sharedGlossary !== undefined
+            ? { shared: config.sharedGlossary }
+            : {}),
+        ...(config.language === undefined ? {} : { language: config.language }),
+        rules: pronunciationRulesOf(config),
+    };
+}
+// Every segment of one kind of narration file, in spoken order, joined: the intro, the body and
+// the outro are one piece of narration for counting.
+function narrationText(deps, projectId, view, role) {
+    const order = (segment) => segment === "intro" ? 0 : segment === "outro" ? 2 : 1;
+    const parts = view.outputs
+        .filter((row) => isReadyOutput(row, { role }))
+        .toSorted((left, right) => order(left.output.meta.segment) - order(right.output.meta.segment))
+        .flatMap((row) => {
+        try {
+            return [readFileSync(outputPath(deps.paths, projectId, row.output.path), "utf8")];
+        }
+        catch {
+            // A narration file removed by hand has nothing to count.
+            return [];
+        }
+    });
+    return parts.length === 0 ? null : parts.join("\n\n");
+}
+function timingWords(deps, projectId, view) {
+    const timing = readyOutput(view, { workKey: "subtitles:timing", role: "subtitle_words" });
+    if (timing === undefined)
+        return null;
+    try {
+        return wordsSchema.parse(JSON.parse(readFileSync(outputPath(deps.paths, projectId, timing.output.path), "utf8"))).words;
+    }
+    catch {
+        // Timing that is missing or unreadable means there is nothing to say about how it was heard.
+        return null;
+    }
+}
+export function pronunciationCheckRoutes(deps) {
+    const viewOf = (projectId) => {
+        const revisionId = currentRevisionId(deps.db, projectId);
+        return revisionId === undefined ? undefined : getRevisionView(deps, projectId, revisionId);
+    };
+    const missing = "This project no longer exists. Go back to Projects to pick another.";
+    return (new Hono()
+        // Before the narration is paid for: the names this article says that nothing pronounces,
+        // so the voice will invent them. Read from the narration text where the run has prepared
+        // it, else from the article itself.
+        .get("/:projectId/pronunciations/gaps", zValidator("param", projectIdParam, onInvalid), (c) => {
+        const { projectId } = c.req.valid("param");
+        if (projectTitle(deps.db, projectId) === undefined)
+            return problem(c, { status: 404, detail: missing });
+        c.header("Cache-Control", "no-store");
+        const view = viewOf(projectId);
+        if (view === undefined)
+            return c.json({
+                revisionId: null,
+                ready: false,
+                narrated: false,
+                ahead: null,
+                notice: null,
+            });
+        const config = view.revision.config;
+        const written = narrationText(deps, projectId, view, "narration_txt");
+        const text = written ??
+            (view.articleMarkdown === null ? null : splitEndMatter(view.articleMarkdown).body);
+        if (text === null || text.trim() === "")
+            return c.json({
+                revisionId: view.revision.id,
+                ready: false,
+                narrated: false,
+                ahead: null,
+                notice: null,
+            });
+        const ahead = namesAhead(text, sourcesOf(config, view), readsPossessives(config));
+        return c.json({
+            revisionId: view.revision.id,
+            ready: true,
+            narrated: narrationText(deps, projectId, view, "tts_script") !== null,
+            ahead,
+            notice: namesAheadNotice(ahead),
+        });
+    })
+        // After the render, before the upload: what reached the voice as written, counted from the
+        // voice script itself, and how the finished narration was heard saying each name, from the
+        // confidence the subtitle timing already carries.
+        .get("/:projectId/pronunciations/heard", zValidator("param", projectIdParam, onInvalid), (c) => {
+        const { projectId } = c.req.valid("param");
+        if (projectTitle(deps.db, projectId) === undefined)
+            return problem(c, { status: 404, detail: missing });
+        c.header("Cache-Control", "no-store");
+        const view = viewOf(projectId);
+        if (view === undefined)
+            return c.json({
+                revisionId: null,
+                narrated: null,
+                heard: null,
+                notice: null,
+            });
+        const sources = sourcesOf(view.revision.config, view);
+        const script = narrationText(deps, projectId, view, "tts_script");
+        const written = narrationText(deps, projectId, view, "narration_txt");
+        const words = timingWords(deps, projectId, view);
+        const narrated = script === null ? null : namesNarrated(script, sources);
+        const heard = words === null ? null : heardNames(words, sources, written ?? script ?? undefined);
+        return c.json({
+            revisionId: view.revision.id,
+            narrated,
+            heard,
+            notice: narratedNotice(narrated, heard),
+        });
+    }));
+}

package/dist/edge/http/pronunciations.js

@@ -3,7 +3,10 @@ import { Hono } from "hono";
 import { z } from "zod";
 import { aliasCountMax } from "../../kernel/ports/narration-aliases.js";
 import { listNarrationAliases, saveNarrationAliases, } from "../../slices/narration/aliases-library.js";
+import { libraryPronunciationsMax } from "../../slices/narration/pronunciation.js";
+import { readLibraryPronunciations, saveLibraryPronunciations, } from "../../slices/narration/pronunciations-library.js";
 import { collectSharedGlossary } from "../../slices/narration/shared-glossary.js";
+import { actorOf } from "./actor.js";
 import { onInvalid, problem } from "./problem.js";
 // The pronunciations of every project's glossary, merged, for Edit project to copy into a
 // project that shares them. `except` leaves out the project being edited, whose own glossary
@@ -19,6 +22,29 @@ export function pronunciationRoutes(deps) {
             .regex(/^[0-9A-Za-z_-]*$/)
             .optional(),
     }), onInvalid), (c) => c.json(collectSharedGlossary(deps, c.req.valid("query").except)))
+        // Name pronunciations, the other half of the same page: one glossary of your own, whose
+        // names come before the glossary each article writes. Saved whole, like the aliases; the
+        // reply says what narration makes of it.
+        .get("/library", (c) => c.json(readLibraryPronunciations(deps.db)))
+        // `version` is the list the save was made from, as the read above gives it. Once a list
+        // exists a save without it, or from an older one, is refused with the list as it stands,
+        // so a second window or an agent can't quietly replace what somebody wrote.
+        .put("/library", zValidator("json", z.object({
+        text: z.string().max(libraryPronunciationsMax),
+        version: z.string().max(64).optional(),
+    }), onInvalid), (c) => {
+        const body = c.req.valid("json");
+        const result = saveLibraryPronunciations(deps, body.text, body.version, actorOf(c));
+        if (result.ok)
+            return c.json(result.list);
+        if (result.reason === "conflict")
+            return problem(c, {
+                status: 409,
+                detail: result.detail,
+                extensions: { current: result.current },
+            });
+        return problem(c, { status: 400, detail: result.detail });
+    })
         .get("/aliases", (c) => c.json({ aliases: listNarrationAliases(deps.db) }))
         // The editor saves the whole ordered list at once; each row is checked in the slice, so
         // the editor gets "Alias 3: …" sentences rather than schema paths.

package/dist/edge/http/providers.js

@@ -5,11 +5,11 @@ import { z } from "zod";
 import { keyProbes } from "../../adapters/key-probes.js";
 import { catalogueModelInfo } from "../../catalog/model-info.js";
 import { videoModelsOf } from "../../catalog/schema.js";
-import { defaultSpeechVoice, detectSpeechCached } from "../../kernel/ports/system-speech.js";
+import { defaultSpeechVoice, detectSpeechCached, speechInstall, } from "../../kernel/ports/system-speech.js";
 import { switchAllRetired, switchRetiredModel } from "../../slices/model-upkeep/switch.js";
 import { retiredModelUsage, usageKinds, usageSlots } from "../../slices/model-upkeep/usage.js";
 import { cliPathMaxLength, saveCliPath } from "../../slices/settings/cli-paths.js";
-import { dismissFirstRun, firstRunStatus } from "../../slices/settings/first-run.js";
+import { firstRunStatus } from "../../slices/settings/first-run.js";
 import { checkProviderHealth } from "../../slices/settings/health.js";
 import { keyGuides } from "../../slices/settings/key-guides.js";
 import { testProviderKey } from "../../slices/settings/key-test.js";
@@ -63,16 +63,12 @@ export function providerRoutes(deps) {
     };
     const standingsOf = (id, models) => deps.modelChecks?.standings(id, models);
     return (new Hono()
-        // The step lists Settings → Providers shows beside each key field.
+        // The step lists Settings → Keys & services shows beside each key field.
         .get("/key-guides", (c) => c.json({ guides: keyGuides }))
         // What the first launch found, and the providers Play picks by default.
         .get("/first-run", async (c) => {
         c.header("Cache-Control", "no-store");
         return c.json(await firstRunStatus({ db: deps.db, ...(deps.modelsFor === undefined ? {} : { modelsFor: deps.modelsFor }) }, await providerStatuses(readiness)));
-    })
-        .post("/first-run/dismiss", (c) => {
-        dismissFirstRun(deps.db);
-        return c.body(null, 204);
     })
         // "Check all": every CLI signed in, every key valid, every chosen model still offered and
         // answering for the key. `?provider=codex` checks that one only (its row's Check again,
@@ -146,9 +142,11 @@ export function providerRoutes(deps) {
         // What Settings draws its rails from and Play its dropdowns: every provider, with
         // the one fact that decides whether it is selectable.
         .get("/", async (c) => c.json({ providers: await providerStatuses(readiness) }))
-        // The system voice's speech programs and their voices, for Settings → Voices' picker.
+        // The system voice's speech programs and their voices, for Settings → Voices' picker, and
+        // with none, how to install one from a terminal (the commands apart from the sentence).
         .get("/system-voice/voices", async (c) => {
-        const found = await detectSpeechCached(deps.probe, deps.speechHost ?? process);
+        const host = deps.speechHost ?? process;
+        const found = await detectSpeechCached(deps.probe, host);
         return c.json({
             engines: found.engines.map((engine) => ({
                 id: engine.id,
@@ -157,6 +155,7 @@ export function providerRoutes(deps) {
                 defaultVoice: defaultSpeechVoice(engine)?.id ?? null,
             })),
             issue: found.issue ?? null,
+            install: found.engines.length === 0 ? (speechInstall(host) ?? null) : null,
         });
     })
         .get("/:id/models", zValidator("param", providerParam, onInvalid), async (c) => {
@@ -228,7 +227,7 @@ export function providerRoutes(deps) {
         if (candidate !== undefined && !candidate.success)
             return problem(c, {
                 status: 400,
-                detail: `The pasted ${providerById(id).displayName} key could not be tested: it is empty or longer than any key. Paste the whole key in Settings → Providers → ${providerById(id).displayName}, then choose Test again.`,
+                detail: `The pasted ${providerById(id).displayName} key could not be tested: it is empty or longer than any key. Paste the whole key in Settings → Keys & services → ${providerById(id).displayName}, then choose Test again.`,
             });
         return c.json(await testProviderKey({ db: deps.db, clock: deps.clock, fetch: deps.fetch, probes: keyProbes }, id, candidate?.data.key));
     })

package/dist/edge/http/refusal.js

@@ -9,7 +9,7 @@ export function refusal(c, reason, rules) {
 export function revisionRequired(c) {
     return problem(c, {
         status: 409,
-        detail: "This change is now made from the Edit tab. Choose Edit project, save your change, then use Choose what to remake (in the project's More menu).",
+        detail: "This change is now made in Edit settings: save it there, then use Choose what to make again (in the project's More menu).",
         extensions: { reason: "revision-required" },
     });
 }

package/dist/edge/http/remote-access.js

@@ -8,11 +8,11 @@ const body = z.object({
     enabled: z.boolean(),
     httpsPort: z.number().int().min(1).max(65535).optional(),
 });
-// Settings → General → Remote access: Slopify's page on the person's other devices through
+// Settings → Remote access: Slopify's page on the person's other devices through
 // Tailscale serve. Reading it is open to agents (get_remote_access); turning it on or off is
 // the person's alone, from this computer.
 export function remoteAccessRoutes(service) {
-    const unavailable = "Remote access can't be set from this Slopify. Start it with npx @gentbajko/slopify and try Settings → General → Remote access again.";
+    const unavailable = "Remote access can't be set from this Slopify. Start it with npx @gentbajko/slopify and try Settings → Remote access again.";
     return new Hono()
         .get("/", async (c) => {
         if (service === undefined)
@@ -27,12 +27,12 @@ export function remoteAccessRoutes(service) {
         if (actorOf(c) !== "person")
             return problem(c, {
                 status: 403,
-                detail: "Remote access is the person's to turn on or off, in Settings → General → Remote access. Agents and the assistant can only read it (get_remote_access).",
+                detail: "Remote access is the person's to turn on or off, in Settings → Remote access. Agents and the assistant can only read it (get_remote_access).",
             });
         if (viaProxy(c.req.raw.headers))
             return problem(c, {
                 status: 403,
-                detail: "Remote access is turned on or off only on the computer Slopify runs on. Open Settings → General → Remote access there, at http://127.0.0.1 and Slopify's port.",
+                detail: "Remote access is turned on or off only on the computer Slopify runs on. Open Settings → Remote access there, at http://127.0.0.1 and Slopify's port.",
             });
         const { enabled, httpsPort } = c.req.valid("json");
         return c.json(await service.set(enabled, httpsPort));

package/dist/edge/http/remote-guard.js

@@ -5,12 +5,12 @@ export const hostOnlyWrites = [
     {
         method: "PUT|DELETE",
         path: new RegExp(`^/api/providers/${id}/key/?$`),
-        what: "Provider keys are saved and removed (Settings → Providers)",
+        what: "Provider keys are saved and removed (Settings → Keys & services)",
     },
     {
         method: "PUT",
         path: new RegExp(`^/api/providers/${id}/path/?$`),
-        what: "A CLI's path is set (Settings → Providers)",
+        what: "A CLI's path is set (Settings → Keys & services)",
     },
     {
         method: "PUT",

package/dist/edge/http/reviews.js

@@ -134,7 +134,7 @@ export function reviewRoutes(deps) {
         const lead = result.reason === "running"
             ? "This item, or work that depends on it, is still running. Wait for it to finish, or Pause the project, then use Redo again."
             : result.reason === "readiness"
-                ? "Slopify can't make this item again yet. Fix what is listed in Settings → Providers or Edit project, then use Redo again."
+                ? "Slopify can't make this item again yet. Fix what is listed in Settings → Keys & services or Edit settings, then use Redo again."
                 : result.reason === "conflict" || result.reason === "control-changed"
                     ? "This project changed since the page loaded. Reload the project page, then use Redo again."
                     : result.reason === "invalid-selection"

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

@@ -80,7 +80,7 @@ function unavailable(c, reason) {
     return problem(c, {
         status: 404,
         detail: reason === "missing-file"
-            ? "This file was deleted or moved from the project folder. In the Edit tab, use Choose what to remake (in the project's More menu) to make it again."
+            ? "This file was deleted or moved from the project folder. Use Choose what to make again (in the project's More menu) to make it again."
             : reason === "no-images"
                 ? "There are no saved files of this kind to put in the zip yet. Wait for the step that makes them to finish, then download again."
                 : "This file is no longer part of the project. Reload the page to see its current files.",

package/dist/edge/http/revisions.js

@@ -36,11 +36,11 @@ const details = {
     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 Choose what to remake (in the project's More menu) again to see the latest.",
+    "stale-preview": "What needs rebuilding changed since you opened this review. Cancel it and open Choose what to make again (in the project's More menu) 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.",
+    "review-required": "This touches content you supplied yourself. Tick “Keep the provided content” for each item in the review, then press the button that makes them again.",
+    "cost-ack-required": "Some prices aren't known in advance. Tick “Start even though …” in the review, then press the button that makes them again.",
+    readiness: "This can't start yet. Fix the items listed, then try again.",
 };
 function refused(c, deps, projectId, value) {
     return refusal(c, value.reason, {