@gentbajko/slopify 3.25.9 → 4.1.0

package/dist/slices/model-checks/service.js

@@ -0,0 +1,198 @@
+import { errorText } from "../../kernel/errors.js";
+import { choiceSites } from "../model-upkeep/usage.js";
+import { isUncataloguedProvider, providerById, providerIds, providers, } from "../settings/model.js";
+import { readSetting, writeSetting } from "../settings/repo.js";
+import { keyOfModel, weeklyAtKey, } from "./model.js";
+import { accountOf, readAuto, readChecks } from "./repo.js";
+import { newForYou, standingOf } from "./rules.js";
+import { needsConfirmation, planChecks, runChecks, } from "./run.js";
+// ceiling: the weekly look runs once seven days have passed since the last one.
+export const weeklyIntervalMs = 7 * 24 * 60 * 60_000;
+function familyOfSlot(slot) {
+    return slot === "llm" ? "llm" : slot === "audio" ? "tts" : "image";
+}
+export function chosenModels(db) {
+    const chosen = new Set();
+    for (const site of choiceSites(db))
+        for (const [slot, choice] of Object.entries(site.choices)) {
+            if (choice === undefined || choice.provider === "" || choice.model.trim() === "")
+                continue;
+            chosen.add(keyOfModel({ provider: choice.provider, family: familyOfSlot(slot), model: choice.model }));
+        }
+    return chosen;
+}
+export function createModelChecks(deps) {
+    const running = new Set();
+    const stopping = new AbortController();
+    const offered = async (provider) => {
+        const { family } = providerById(provider);
+        if (isUncataloguedProvider(provider)) {
+            const models = await deps.providerModels(provider, family).catch(() => []);
+            return models.map((model) => ({ provider, family, model: model.id }));
+        }
+        return deps
+            .catalogue()[family].filter((row) => row.provider === provider && row.enabled && !row.deprecated)
+            .map((row) => ({ provider, family, model: row.id }));
+    };
+    const withAccount = () => providerIds.filter((id) => accountOf(deps.db, id) !== undefined);
+    // Named models of a CLI are taken as named: asking the CLI for its list would start it, and
+    // a picker asks this for its one chosen model whenever it opens.
+    const offeredFor = (provider, models) => {
+        if (models === undefined || !isUncataloguedProvider(provider))
+            return offered(provider);
+        const { family } = providerById(provider);
+        return Promise.resolve(models.map((model) => ({ provider, family, model })));
+    };
+    const plan = async (scope) => {
+        const scoped = scope.provider === undefined ? withAccount() : [scope.provider];
+        return planChecks({
+            catalogue: deps.catalogue(),
+            rows: readChecks(deps.db),
+            offered: (await Promise.all(scoped.map((id) => offeredFor(id, scope.models)))).flat(),
+            accounts: (id) => accountOf(deps.db, id),
+            chosen: chosenModels(deps.db),
+        }, scope);
+    };
+    // A provider is taken before the first await, so two starts that arrive together can't both
+    // pass the running check and pay for the same checks twice.
+    const reserve = (ids) => {
+        let held = [...ids];
+        for (const id of held)
+            running.add(id);
+        const release = () => {
+            for (const id of held)
+                running.delete(id);
+            held = [];
+        };
+        // Once planned, only the providers it checks stay taken.
+        const keepFor = (checks) => {
+            const owned = held.filter((id) => checks.targets.some((t) => t.provider === id));
+            for (const id of held)
+                if (!owned.includes(id))
+                    running.delete(id);
+            held = owned;
+        };
+        return { release, keepFor };
+    };
+    const launch = (checks, release) => runChecks({ db: deps.db, clock: deps.clock, log: deps.log, check: deps.check }, checks, 
+    // A manual plan's estimate was confirmed in `start`; an automatic one is free or cheap.
+    { confirmedDollars: checks.totalDollars, signal: stopping.signal })
+        .then((answer) => answer.ok
+        ? answer.summary
+        : { checked: 0, works: 0, noAccess: 0, failed: 0, skipped: 0, spent: 0 })
+        .finally(release);
+    const start = async (scope, confirmedDollars) => {
+        const scoped = scope.provider === undefined ? withAccount() : [scope.provider];
+        const busy = scoped.filter((id) => running.has(id));
+        if (busy.length > 0)
+            return { ok: false, reason: "running", providers: busy };
+        const { release, keepFor } = reserve(scoped);
+        let checks;
+        try {
+            checks = await plan(scope);
+        }
+        catch (error) {
+            release();
+            throw error;
+        }
+        keepFor(checks);
+        if (scope.trigger === "manual" && needsConfirmation(checks, confirmedDollars)) {
+            release();
+            return { ok: false, reason: "estimate", plan: checks };
+        }
+        return { ok: true, plan: checks, done: launch(checks, release) };
+    };
+    const automatic = async (trigger, provider) => {
+        const scoped = provider === undefined ? withAccount() : [provider];
+        for (const id of scoped)
+            await deps.listing.refresh(id, true).catch((error) => {
+                deps.log.write("warn", "model-checks.listing", {
+                    detail: `${id}: ${errorText(error)}`,
+                });
+            });
+        if (readAuto(deps.db) === "off")
+            return;
+        const free = scoped.filter((id) => !running.has(id));
+        if (free.length === 0)
+            return;
+        const { release, keepFor } = reserve(free);
+        let kept;
+        try {
+            const checks = await plan(provider === undefined ? { trigger } : { trigger, provider });
+            kept = {
+                ...checks,
+                targets: checks.targets.filter((t) => free.some((id) => id === t.provider)),
+            };
+            keepFor(kept);
+            if (trigger === "weekly")
+                writeSetting(deps.db, weeklyAtKey, deps.clock.now().toISOString());
+        }
+        catch (error) {
+            release();
+            throw error;
+        }
+        if (kept.targets.length > 0)
+            await launch(kept, release);
+        else
+            release();
+    };
+    return {
+        offered,
+        plan,
+        start,
+        automatic,
+        weeklyDue: () => {
+            if (readAuto(deps.db) === "off")
+                return false;
+            const last = readSetting(deps.db, weeklyAtKey);
+            return (last === undefined || deps.clock.now().getTime() - Date.parse(last) >= weeklyIntervalMs);
+        },
+        standings: (provider, models) => {
+            const { family } = providerById(provider);
+            const account = accountOf(deps.db, provider);
+            const rows = new Map(readChecks(deps.db, provider)
+                .filter((row) => row.family === family)
+                .map((row) => [row.model, row]));
+            return Object.fromEntries(models.map((model) => [
+                model.id,
+                standingOf(rows.get(model.id), account, deps.retiring?.({ provider, family, model: model.id })),
+            ]));
+        },
+        overview: () => {
+            const rows = readChecks(deps.db);
+            const catalogue = deps.catalogue();
+            const nameOf = (key) => catalogue[key.family].find((m) => m.provider === key.provider && m.id === key.model)
+                ?.name ?? key.model;
+            const states = providers.map((provider) => {
+                const account = accountOf(deps.db, provider.id);
+                const own = rows.filter((row) => row.provider === provider.id && row.account === account);
+                const times = own.flatMap((row) => (row.checkedAt === null ? [] : [row.checkedAt])).sort();
+                return {
+                    provider: provider.id,
+                    family: provider.family,
+                    running: running.has(provider.id),
+                    lastCheckedAt: times.at(-1) ?? null,
+                    spent: own.reduce((sum, row) => sum + row.cost, 0),
+                    works: own.filter((row) => row.verdict === "works").length,
+                    noAccess: own.filter((row) => row.verdict === "no-access").length,
+                    listed: own.filter((row) => row.listed === true).length,
+                };
+            });
+            const current = rows.filter((row) => providerIds.includes(row.provider) &&
+                row.account === accountOf(deps.db, row.provider));
+            return {
+                auto: readAuto(deps.db),
+                providers: states,
+                newForYou: newForYou(current).map((row) => ({
+                    provider: row.provider,
+                    family: row.family,
+                    model: row.model,
+                    name: nameOf(row),
+                    firstWorksAt: row.firstWorksAt ?? "",
+                })),
+            };
+        },
+        running: () => [...running],
+        stop: () => stopping.abort(),
+    };
+}

package/dist/slices/model-upkeep/model.js

@@ -3,7 +3,7 @@
 export const usageSlots = ["llm", "audio", "images", "animate"];
 export const usageKinds = ["template", "schedule", "draft", "project"];
 export const slotLabels = {
-    llm: "Text model",
+    llm: "Writing model",
     audio: "Voice model",
     images: "Image model",
     animate: "Animation model",

package/dist/slices/model-upkeep/switch.js

@@ -6,8 +6,10 @@ import { templateById } from "../project-templates/repo.js";
 import { updateTemplate } from "../project-templates/service.js";
 import { ensureBaseline, saveRevision } from "../revisions/index.js";
 import { currentRevisionId } from "../revisions/repo.js";
+import { carryGateOnto } from "../template-studio/repo.js";
+import { templateGate } from "../template-studio/schedule-gate.js";
 import { configChoices, formChoices, retiredModelUsage, retiredStatus, } from "./usage.js";
-function keepThinking(catalogue, provider, model, thinking) {
+export function keepThinking(catalogue, provider, model, thinking) {
     if (thinking === undefined)
         return {};
     const row = catalogue.llm.find((entry) => entry.provider === provider && entry.id === model);
@@ -92,7 +94,7 @@ export async function switchRetiredModel(deps, catalogue, request) {
             if (row.version !== row.head)
                 return {
                     ok: false,
-                    message: "This schedule runs an older version of its template. In Library → Schedules, choose Edit, pick the template again so it runs the latest version, then save.",
+                    message: "This schedule runs an older version of its template. In Calendar → Schedules, choose Edit, pick the template again so it runs the latest version, then save.",
                 };
             return switchTemplate(deps, catalogue, request, String(row.templateId));
         }
@@ -103,32 +105,75 @@ export async function switchRetiredModel(deps, catalogue, request) {
     }
 }
 function switchTemplate(deps, catalogue, request, templateId) {
-    return transact(deps.db, () => {
-        const template = templateById(deps.db, templateId);
-        if (template === undefined)
-            return { ok: false, message: changedMeanwhile };
-        const form = switchForm(template.document.form, catalogue, request);
-        if (form === undefined)
-            return { ok: true, changed: false };
-        const saved = updateTemplate(deps, {
+    const template = templateById(deps.db, templateId);
+    if (template === undefined)
+        return { ok: false, message: changedMeanwhile };
+    try {
+        return transact(deps.db, () => switchTemplateIn(deps, catalogue, request, template));
+    }
+    catch (error) {
+        if (!(error instanceof SwitchRefused))
+            throw error;
+        return {
+            ok: false,
+            message: error.reason === "missing-prompt"
+                ? `The template "${template.name}" uses a prompt or intro/outro that was deleted, so it cannot be saved. Open it in Templates → Edit template, choose another, and save.`
+                : changedMeanwhile,
+        };
+    }
+}
+// A refused save inside the switch's transaction: thrown so the carried version written before
+// it is rolled back with it.
+class SwitchRefused extends Error {
+    reason;
+    constructor(reason) {
+        super(reason);
+        this.reason = reason;
+    }
+}
+function switchTemplateIn(deps, catalogue, request, template) {
+    const form = switchForm(template.document.form, catalogue, request);
+    // The version schedules run, when it isn't the head (an unchecked edit waits on Mark ready).
+    const runs = templateGate(deps.db, template.id)?.runs ?? null;
+    const running = runs === null || runs === template.version
+        ? undefined
+        : templateById(deps.db, template.id, runs);
+    const runningForm = running === undefined ? undefined : switchForm(running.document.form, catalogue, request);
+    if (form === undefined && runningForm === undefined)
+        return { ok: true, changed: false };
+    let base = template.version;
+    if (running !== undefined && runningForm !== undefined) {
+        // The version that runs, switched, carried from it: schedules never keep running a
+        // retired model while the person's newer edit waits to be marked ready.
+        const carried = updateTemplate(deps, {
             id: template.id,
-            name: template.name,
-            document: { ...template.document, form },
-            baseVersion: template.version,
+            name: running.name,
+            document: { ...running.document, form: runningForm },
+            baseVersion: base,
             mutationId: deps.uuid(),
         });
-        if (!saved.ok)
-            return {
-                ok: false,
-                message: saved.reason === "missing-prompt"
-                    ? `The template "${template.name}" uses a prompt or intro/outro that was deleted, so it cannot be saved. Open it in Library → Templates, choose another, and save.`
-                    : changedMeanwhile,
-            };
-        deps.db
-            .prepare("UPDATE schedules SET template_version=?,version=version+1,updated_at=? WHERE template_id=? AND template_version=? AND deleted_at IS NULL AND status IN ('active','paused')")
-            .run(saved.value.version, deps.clock.now().toISOString(), template.id, template.version);
-        return { ok: true, changed: true };
+        if (!carried.ok)
+            throw new SwitchRefused(carried.reason);
+        carryGateOnto(deps.db, template.id, running.version, carried.value.version);
+        base = carried.value.version;
+    }
+    // The head stays the person's newest work: switched too when it picks the model, and
+    // written again above the carried version so it is still the newest one.
+    const saved = updateTemplate(deps, {
+        id: template.id,
+        name: template.name,
+        document: { ...template.document, form: form ?? template.document.form },
+        baseVersion: base,
+        mutationId: deps.uuid(),
     });
+    if (!saved.ok)
+        throw new SwitchRefused(saved.reason);
+    // Slopify's own change: a schedule running the version it came from keeps running.
+    carryGateOnto(deps.db, template.id, template.version, saved.value.version);
+    deps.db
+        .prepare("UPDATE schedules SET template_version=?,version=version+1,updated_at=? WHERE template_id=? AND template_version=? AND deleted_at IS NULL AND status IN ('active','paused')")
+        .run(saved.value.version, deps.clock.now().toISOString(), template.id, template.version);
+    return { ok: true, changed: true };
 }
 function switchDraft(deps, catalogue, request) {
     const row = draftRow(deps.db, request.id);
@@ -185,16 +230,16 @@ async function switchProject(deps, catalogue, request) {
                 ? " because the project changed meanwhile"
                 : "fields" in saved && saved.fields?.[0] !== undefined
                     ? ` (${saved.fields[0].message})`
-                    : ""}. Open the project, choose Edit project and change it under Providers.`,
+                    : ""}. Open the project and change it in Edit settings.`,
         };
 }
 // "Switch all": every listed use that has a suggestion and no reason to hold back, one by one.
-export async function switchAllRetired(deps, catalogue) {
+export async function switchAllRetired(deps, catalogue, lifecycle) {
     let switched = 0;
     const failed = [];
     // Templates first: switching one also moves the schedules that follow it.
     const order = ["template", "schedule", "draft", "project"];
-    const usages = [...retiredModelUsage(deps.db, catalogue)].sort((a, b) => order.indexOf(a.kind) - order.indexOf(b.kind));
+    const usages = [...retiredModelUsage(deps.db, catalogue, lifecycle)].sort((a, b) => order.indexOf(a.kind) - order.indexOf(b.kind));
     for (const usage of usages) {
         if (usage.blocked !== null || usage.replacement === null)
             continue;

package/dist/slices/model-upkeep/usage.js

@@ -1,16 +1,29 @@
 import { z } from "zod";
+import { lifecycleReplacement } from "../../catalog/lifecycle.js";
 import { isVideoModel } from "../../catalog/schema.js";
 import { listProjects, stagesOf } from "../admission/repo.js";
 import { draftRows } from "../play-drafts/repo.js";
 import { documentOf } from "../play-drafts/service.js";
 import { templateById } from "../project-templates/repo.js";
 import { currentRevisionId, revisionById } from "../revisions/repo.js";
-import { isUncataloguedProvider } from "../settings/model.js";
+import { isSampleStandIn, isUncataloguedProvider } from "../settings/model.js";
+import { runnableTemplate } from "../template-studio/schedule-gate.js";
 import { usageSlots } from "./model.js";
 export { slotLabels, usageKinds, usageSlots } from "./model.js";
 function familyOf(slot) {
     return slot === "llm" ? "llm" : slot === "audio" ? "tts" : "image";
 }
+// A Create draft's name as Create's header says it: its title once every keyword in it is
+// filled, else "Untitled draft". Never a raw {{Topic}}.
+function draftName(title, values) {
+    const filled = title
+        .replace(/\{\{\s*([^{}]+?)\s*\}\}/g, (keyword, name) => {
+        const value = values[name]?.trim() ?? "";
+        return value === "" ? keyword : value;
+    })
+        .trim();
+    return filled === "" || filled.includes("{{") ? "Untitled draft" : filled;
+}
 // The model choices a Play form (a draft or a template) makes.
 export function formChoices(form) {
     const edit = form.videoEdit;
@@ -36,11 +49,13 @@ export function configChoices(config) {
     };
 }
 // Whether a choice names a catalogued model that is no longer offered. Command-line tools
-// list their own models and are checked by the health check instead.
+// list their own models and are checked by the health check instead; the samples' stand-ins
+// were never catalogued.
 export function retiredStatus(catalogue, slot, choice) {
     if (choice.provider === "" ||
         choice.model.trim() === "" ||
-        isUncataloguedProvider(choice.provider))
+        isUncataloguedProvider(choice.provider) ||
+        isSampleStandIn(choice.provider))
         return null;
     const row = catalogue[familyOf(slot)].find((model) => model.provider === choice.provider &&
         model.id === choice.model &&
@@ -51,9 +66,17 @@ export function retiredStatus(catalogue, slot, choice) {
         return "retired";
     return row.enabled ? null : "unlisted";
 }
-// The closest active model from the same provider and list: the one sharing the longest
-// start of its ID (a newer version of the same line), the catalogue's order breaking ties.
-export function suggestReplacement(catalogue, slot, choice) {
+// The replacement models-lifecycle.yaml names, when it is live; else the closest active model
+// from the same provider and list: the one sharing the longest start of its ID (a newer
+// version of the same line), the catalogue's order breaking ties.
+export function suggestReplacement(catalogue, slot, choice, lifecycle) {
+    const named = lifecycleReplacement(lifecycle, catalogue, {
+        family: familyOf(slot),
+        provider: choice.provider,
+        model: choice.model,
+    });
+    if (named !== undefined && named.id !== choice.model)
+        return named;
     let best = null;
     for (const row of catalogue[familyOf(slot)]) {
         if (row.provider !== choice.provider ||
@@ -74,7 +97,7 @@ function sharedStart(a, b) {
         index++;
     return index;
 }
-function usagesOf(catalogue, base, choices, blocked) {
+function usagesOf(catalogue, base, choices, blocked, lifecycle) {
     const found = [];
     for (const slot of usageSlots) {
         const choice = choices[slot];
@@ -83,7 +106,7 @@ function usagesOf(catalogue, base, choices, blocked) {
         const why = retiredStatus(catalogue, slot, choice);
         if (why === null)
             continue;
-        const replacement = suggestReplacement(catalogue, slot, choice);
+        const replacement = suggestReplacement(catalogue, slot, choice, lifecycle);
         found.push({
             ...base,
             key: `${base.kind}:${base.id}:${slot}`,
@@ -128,7 +151,10 @@ export function choiceSites(db) {
         .prepare("SELECT id,name,template_id,template_version FROM schedules WHERE deleted_at IS NULL AND status IN ('active','paused') ORDER BY lower(name),id")
         .all()) {
         const row = scheduleRow.parse(raw);
-        const template = templateById(db, row.template_id, row.template_version);
+        // What the schedule actually runs (`template-studio/schedule-gate.ts`): with an unchecked
+        // head that is an older ready version, whose models are the ones its runs use.
+        const template = runnableTemplate(db, row.template_id) ??
+            templateById(db, row.template_id, row.template_version);
         if (template === undefined)
             continue;
         const head = heads.get(row.template_id) ??
@@ -140,7 +166,7 @@ export function choiceSites(db) {
             choices: formChoices(template.document.form),
             blocked: head === row.template_version
                 ? null
-                : `This schedule runs an older version of the template "${template.name}". In Library → Schedules, choose Edit, pick the template again so it runs the latest version, then save.`,
+                : `This schedule runs an older version of the template "${template.name}". In Calendar → Schedules, choose Edit, pick the template again so it runs the latest version, then save.`,
         });
     }
     for (const row of draftRows(db)) {
@@ -152,7 +178,7 @@ export function choiceSites(db) {
         sites.push({
             kind: "draft",
             id: row.id,
-            name: row.title.trim() === "" ? "Untitled draft" : row.title,
+            name: draftName(row.title, document.form.values),
             choices: formChoices(document.form),
             blocked: null,
         });
@@ -180,6 +206,6 @@ export function choiceSites(db) {
 }
 // Every template, schedule, draft and unfinished project that still picks a retired or
 // unlisted model, with the suggested replacement. Nothing is changed here.
-export function retiredModelUsage(db, catalogue) {
-    return choiceSites(db).flatMap((site) => usagesOf(catalogue, { kind: site.kind, id: site.id, name: site.name }, site.choices, site.blocked));
+export function retiredModelUsage(db, catalogue, lifecycle) {
+    return choiceSites(db).flatMap((site) => usagesOf(catalogue, { kind: site.kind, id: site.id, name: site.name }, site.choices, site.blocked, lifecycle));
 }

package/dist/slices/narration/breaths.js

@@ -1,6 +1,8 @@
 import { mkdirSync, rmSync } from "node:fs";
 import { open, stat } from "node:fs/promises";
 import { join } from "node:path";
+import { errorText } from "../../kernel/errors.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { runFfmpeg } from "../video/ffmpeg.js";
 import { breathRate, scanBreaths, softenChunk } from "./breaths-detect.js";
 // Soften breaths, made in the join (`breaths-model.ts` says why there). Each narration piece is
@@ -38,7 +40,7 @@ export async function softenBreaths(run, files, directory) {
         catch (error) {
             if (run.signal.aborted)
                 throw error;
-            throw new Error(`Soften breaths could not process narration piece ${String(index + 1)} (${error instanceof Error ? error.message : String(error)}), so the narration can't be joined together. Use Try again; if it fails again, turn off Soften breaths in Edit project → Pauses and volume and use Save changes, then use Download diagnostics in Settings and report it.`, { cause: error });
+            throw new Error(`Soften breaths could not process narration piece ${String(index + 1)} (${errorText(error)}), so the narration can't be joined together. Use Try again; if it fails again, turn off Soften breaths in ${editSettings.sound} and use Save changes, then use Download diagnostics in Settings and report it.`, { cause: error });
         }
         finally {
             rmSync(raw, { force: true });

package/dist/slices/narration/clean-pieces.js

@@ -1,5 +1,7 @@
 import { mkdirSync } from "node:fs";
 import { join } from "node:path";
+import { errorText } from "../../kernel/errors.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { runFfmpeg } from "../video/ffmpeg.js";
 import { softenBreaths } from "./breaths.js";
 import { deEsser } from "./breaths-model.js";
@@ -36,7 +38,7 @@ export async function deEssPieces(run, files, directory) {
         catch (error) {
             if (run.signal.aborted)
                 throw error;
-            throw new Error(`Soften S sounds could not process narration piece ${String(index + 1)} (${error instanceof Error ? error.message : String(error)}), so the narration can't be joined together. Use Try again; if it fails again, turn off Soften S sounds in Edit project → Pauses and volume and use Save changes, then use Download diagnostics in Settings and report it.`, { cause: error });
+            throw new Error(`Soften S sounds could not process narration piece ${String(index + 1)} (${errorText(error)}), so the narration can't be joined together. Use Try again; if it fails again, turn off Soften S sounds in ${editSettings.sound} and use Save changes, then use Download diagnostics in Settings and report it.`, { cause: error });
         }
         written.push(output);
     }

package/dist/slices/narration/concat.js

@@ -1,5 +1,6 @@
 import { copyFileSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+import { internalError } from "../../kernel/errors.js";
 import { probeDurationMs, runFfmpeg } from "../video/ffmpeg.js";
 // The concat demuxer's script format. A path is single-quoted, and the one character that
 // can end the quoting is spelled out, so a folder with an apostrophe in it cannot become
@@ -46,7 +47,7 @@ export async function joinNarration(deps, input) {
     const first = input.files[0];
     if (first === undefined) {
         // The stage refuses an empty narration before it gets here, so this is a bug.
-        throw new Error("Slopify hit an internal error (there is no narration audio to join). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+        throw new Error(internalError("there is no narration audio to join"));
     }
     mkdirSync(dirname(input.output), { recursive: true, mode: 0o700 });
     if (input.files.length === 1 && input.reencode !== true) {

package/dist/slices/narration/pauses-model.js

@@ -9,9 +9,10 @@
 // A paragraph's minimum is separate and 0 (the sentence minimum only) unless set: the pause
 // between paragraphs is mostly the narration prompt's and the voice's to make.
 //
-// Browser-safe: Play and Edit project read these limits. A run without either has neither on
+// Browser-safe: Create and Edit settings read these limits. A run without either has neither on
 // its config, which is what every project saved before them was, and the joins keep their
 // fingerprints then.
+import { createRows, editSettings } from "../../kernel/ports/settings-places.js";
 // ceiling: a quarter second reads brisk, 0.35 to 0.45 natural or documentary, 0.5 to 0.8 an
 // audiobook's relaxed pace, and above 0.8 sleep content; beyond 2 s it stops sounding like a
 // pause between sentences.
@@ -33,7 +34,7 @@ export function pauseProblem(value, name) {
         value <= pauseSecondsMax &&
         Math.abs(steps - Math.round(steps)) < 1e-6
         ? undefined
-        : `The pause between ${name} must be between 0 and ${String(pauseSecondsMax)} seconds, in steps of ${String(pauseSecondsStep)}. Change it under Play → Video and style, or Edit project → Pauses and volume.`;
+        : `The pause between ${name} must be between 0 and ${String(pauseSecondsMax)} seconds, in steps of ${String(pauseSecondsStep)}. Change it under ${createRows.video}, or ${editSettings.sound}.`;
 }
 export function pauseFields(config) {
     const fields = [];

package/dist/slices/narration/peaks.js

@@ -1,4 +1,5 @@
 import { execFile } from "node:child_process";
+import { isDonePiece, readyOutput } from "../revisions/view.js";
 // The live view's narration waveform: each finished narration piece as a row of peaks, in the
 // order it is spoken, growing as pieces land. Once the whole narration is joined (or was
 // uploaded) that one file replaces the pieces.
@@ -12,7 +13,7 @@ const decodeMaxBytes = 3 * 3600 * decodeRate * 2;
 // The saved narration audio of a revision, in spoken order: the joined narration when it is
 // ready, else each finished request of the intro, the body and the outro.
 export function narrationAudio(view) {
-    const joined = view.outputs.find((row) => row.selected && row.available && row.state === "ready" && row.output.role === "audio_body");
+    const joined = readyOutput(view, { role: "audio_body" });
     if (joined !== undefined)
         return {
             complete: true,
@@ -22,10 +23,8 @@ export function narrationAudio(view) {
     return {
         complete: false,
         pieces: view.pieces
-            .filter((row) => row.selected &&
-            row.available &&
+            .filter((row) => isDonePiece(row) &&
             row.stageKind === "audio" &&
-            row.piece.state === "done" &&
             row.assetId !== null &&
             row.piece.payload !== null &&
             spoken(row.piece.payload))

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

@@ -1,3 +1,4 @@
+import { internalError } from "../../kernel/errors.js";
 import { fingerprint } from "../../kernel/runner/work.js";
 import { anchoredChunks, defaultChunkCharacters, defaultChunkWords, } from "./chunk.js";
 import { pronunciationMatches } from "./pronunciation.js";
@@ -32,7 +33,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
     const chunks = narrationChunkTexts(source, chunking, anchors).map((text) => {
         const start = source.indexOf(text, offset);
         if (start < 0)
-            throw new Error("Slopify hit an internal error (a narration chunk isn't in the article text). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("a narration chunk isn't in the article text"));
         offset = start + text.length;
         return { key: nextKey(text), text, start, end: offset };
     });
@@ -85,7 +86,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
         }
         const chunk = chunks[index];
         if (chunk === undefined)
-            throw new Error("Slopify hit an internal error (a narration chunk went missing). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("a narration chunk went missing"));
         while ((matches[matchIndex]?.end ?? Infinity) <= chunk.end)
             matchIndex++;
         const match = matches[matchIndex];
@@ -97,7 +98,7 @@ export function pronunciationChunks(source, chunking, entries, overriddenKeys =
             continue;
         const first = chunks[from];
         if (first === undefined)
-            throw new Error("Slopify hit an internal error (a group of narration chunks is empty). Try again; if it happens again, use Download diagnostics in Settings and report it.");
+            throw new Error(internalError("a group of narration chunks is empty"));
         const text = source.slice(first.start, chunk.end);
         result.push(from === index
             ? { key: chunk.key, text }