@gentbajko/slopify 3.25.9 → 4.1.0

package/dist/slices/schedules/topics.js

@@ -1,14 +1,18 @@
 import { z } from "zod";
 import { transact } from "../../kernel/db/tx.js";
+import { errorText } from "../../kernel/errors.js";
+import { jsonBetween } from "../../kernel/json-answer.js";
 import { liveProject } from "../admission/repo.js";
 import { defaultChannelId } from "../channels/model.js";
 import { projectChannels, scheduleChannel } from "../channels/repo.js";
 import { channelVideoTitles } from "../channels/videos.js";
-import { readSetting, writeSetting } from "../settings/repo.js";
+import { readJsonSetting, writeSetting } from "../settings/repo.js";
+import { notTemplateSample } from "../template-studio/repo.js";
 import { scheduleById } from "./repo.js";
 import { heldTopicEditSchema, heldTopicSchema, queueMax, topicMoveSchema, topicQueueSchema, topicTitleSchema, topicTransferSchema, } from "./schema.js";
 import { newTopics } from "./similar.js";
-import { templateKeywords, topicRowProblems } from "./topic-list.js";
+import { scheduleKeywords, topicRowProblems } from "./topic-list.js";
+import { pinTopic, rankedItems, saveScores, scoreTopics } from "./topic-scores.js";
 // A schedule that finds its own topics asks an LLM whenever its queue holds fewer than
 // `keepAtLeast`. Only one generation per schedule runs at a time: a lease on the schedule row
 // (`topics_generating_at`) is taken before the LLM is asked and cleared after, so a tick and a
@@ -104,9 +108,9 @@ async function ask(deps, schedule, options) {
     const template = deps.template(schedule.templateId);
     const llm = schedule.topicGeneration.llm ?? template?.document.form.llm;
     if (llm === undefined)
-        return fail("the template this schedule uses was deleted, so there is no LLM to ask. Edit the schedule and choose a template, or pick an LLM under Topic generation.");
+        return fail("the template this schedule uses was deleted, so there is no AI model to ask. Edit the schedule and choose a template, or pick a Service and Model under Topic generation.");
     if (deps.topicLlm === undefined)
-        return fail("no LLM is available in this Slopify. Restart Slopify and try again.");
+        return fail("no AI model is available in this Slopify. Restart Slopify and try again.");
     const wanted = Math.max(generationWanted(schedule), options.force ? spare : 0);
     const known = knownTitles(deps, schedule.id);
     const signal = AbortSignal.any([
@@ -129,26 +133,40 @@ async function ask(deps, schedule, options) {
     catch (error) {
         if (options.signal?.aborted === true)
             return { ok: false, reason: "failed", message: "Slopify was closing." };
-        const detail = error instanceof Error ? error.message : String(error);
-        return fail(`${llm.provider} (${llm.model}) did not answer: ${detail.trim().slice(0, 300)}. Check it in Settings → Providers, or pick another LLM under Edit → Topic generation.`);
+        const detail = errorText(error);
+        return fail(`${llm.provider} (${llm.model}) did not answer: ${detail.trim().slice(0, 300)}. Check it in Settings → Keys & services, or pick another Service or Model under Edit → Topic generation.`);
     }
     const suggested = parseTopics(answer);
     if (suggested.length === 0)
-        return fail(`${llm.provider} (${llm.model}) answered without a list of topics. Try again, or pick another LLM under Edit → Topic generation.`);
+        return fail(`${llm.provider} (${llm.model}) answered without a list of topics. Try again, or pick another Service or Model under Edit → Topic generation.`);
+    // Scored outside the transaction: search may take seconds, and never holds the database.
+    const scores = schedule.topicScoring === "off"
+        ? undefined
+        : await scoreTopics(deps, schedule.topicScoring, newTopics(suggested, known), known, template?.document.form.language ?? "en", options.signal);
     return transact(deps.db, () => {
         const current = scheduleById(deps.db, schedule.id);
         if (current === undefined || current.deletedAt !== null)
             return { ok: false, reason: "not-found", message: "This schedule no longer exists." };
         // Checked again against what is there now: a topic added while the LLM was thinking counts.
-        const fresh = newTopics(suggested, knownTitles(deps, schedule.id)).slice(0, Math.max(0, Math.min(wanted, queueMax - current.items.length)));
+        const candidates = newTopics(suggested, knownTitles(deps, schedule.id));
+        // With scoring, the best-scored are kept; without, the LLM's own order, as before.
+        const fresh = (scores === undefined
+            ? candidates
+            : candidates.toSorted((a, b) => (scores.get(b)?.score ?? -1) - (scores.get(a)?.score ?? -1))).slice(0, Math.max(0, Math.min(wanted, queueMax - current.items.length)));
         if (fresh.length === 0)
-            return fail("every topic the LLM suggested was already made, queued or turned down for this schedule. Add more detail to the series brief under Edit, so it has new ground to cover.");
+            return fail("every topic the AI model suggested was already made, queued or turned down for this schedule. Add more detail to the series brief under Edit, so it has new ground to cover.");
         const at = deps.clock.now().toISOString();
         const mode = current.topicGeneration.mode === "hold" ? "hold" : "queue";
+        if (scores !== undefined)
+            saveScores(deps.db, schedule.id, new Map(fresh.flatMap((title) => {
+                const score = scores.get(title);
+                return score === undefined ? [] : [[title, score]];
+            })), at);
         if (mode === "queue") {
+            const items = [...current.items, ...fresh.map((title) => ({ title, values: {} }))];
             deps.db
                 .prepare("UPDATE schedules SET items_json=?,version=version+1,updated_at=? WHERE id=? AND deleted_at IS NULL")
-                .run(JSON.stringify([...current.items, ...fresh.map((title) => ({ title, values: {} }))]), at, schedule.id);
+                .run(JSON.stringify(scores === undefined ? items : rankedItems(deps.db, schedule.id, items)), at, schedule.id);
         }
         else {
             const start = nextRank(deps, schedule.id);
@@ -158,6 +176,8 @@ async function ask(deps, schedule, options) {
              VALUES (?,?,?,'held',?,?)`)
                     .run(deps.uuid(), schedule.id, title, start + index, at);
             });
+            if (scores !== undefined)
+                rankHeld(deps, schedule.id);
         }
         deps.db
             .prepare("UPDATE schedules SET topics_generated_at=?,topics_failed_at=NULL,topics_error=NULL WHERE id=?")
@@ -180,6 +200,17 @@ async function ask(deps, schedule, options) {
         return { ok: true, added: fresh.length, mode };
     });
 }
+// Held topics in score order: unscored ones first as they were, then the scored, best first.
+export function rankHeld(deps, scheduleId) {
+    const held = deps.db
+        .prepare("SELECT id,title FROM schedule_topics WHERE schedule_id=? AND state='held' ORDER BY rank,created_at,id")
+        .all(scheduleId)
+        .map((row) => z.object({ id: z.string(), title: z.string() }).parse(row));
+    const rank = deps.db.prepare("UPDATE schedule_topics SET rank=? WHERE id=?");
+    rankedItems(deps.db, scheduleId, held).forEach((topic, index) => {
+        rank.run(index, topic.id);
+    });
+}
 function nextRank(deps, scheduleId) {
     const row = deps.db
         .prepare("SELECT max(rank) AS rank FROM schedule_topics WHERE schedule_id=? AND state='held'")
@@ -200,7 +231,8 @@ export function knownTitles(deps, scheduleId) {
     const channel = scheduleChannel(deps.db, scheduleId);
     const channels = projectChannels(deps.db);
     const projects = deps.db
-        .prepare(`SELECT id,title FROM projects WHERE ${liveProject()} ORDER BY created_at DESC`)
+        // A template's studio sample is no video of the channel's.
+        .prepare(`SELECT id,title FROM projects WHERE ${liveProject()} AND ${notTemplateSample()} ORDER BY created_at DESC`)
         .all()
         .map((row) => z.object({ id: z.string(), title: z.string() }).parse(row))
         .filter((row) => channel === undefined || (channels.get(row.id) ?? defaultChannelId) === channel.id)
@@ -254,20 +286,8 @@ export function topicMessages(schedule, templateTitle, known, count) {
 }
 // A JSON array of strings, or failing that one topic per line with bullets and numbers dropped.
 export function parseTopics(answer) {
-    const start = answer.indexOf("[");
-    const end = answer.lastIndexOf("]");
-    let lines;
-    if (start !== -1 && end > start) {
-        try {
-            const parsed = JSON.parse(answer.slice(start, end + 1));
-            if (Array.isArray(parsed))
-                lines = parsed;
-        }
-        catch {
-            lines = undefined;
-        }
-    }
-    lines ??= answer.split(/\r?\n/);
+    const parsed = jsonBetween(answer, "[", "]");
+    const lines = Array.isArray(parsed) ? parsed : answer.split(/\r?\n/);
     return lines
         .map((line) => typeof line === "string"
         ? line
@@ -286,16 +306,7 @@ export function parseTopics(answer) {
 export const heldValuesKey = "schedules.held-topic-values";
 const heldValuesSchema = z.record(z.string(), z.record(z.string(), z.string()));
 function readHeldValues(db) {
-    const raw = readSetting(db, heldValuesKey);
-    if (raw === undefined)
-        return {};
-    try {
-        const parsed = heldValuesSchema.safeParse(JSON.parse(raw));
-        return parsed.success ? parsed.data : {};
-    }
-    catch {
-        return {};
-    }
+    return readJsonSetting(db, heldValuesKey, heldValuesSchema, {});
 }
 // Entries of topics that are no longer held (approved, turned down, or gone with their
 // schedule) are dropped on every write.
@@ -394,11 +405,11 @@ export function editHeldTopic(deps, scheduleId, topicId, input) {
         const schedule = scheduleById(deps.db, scheduleId);
         if (schedule === undefined)
             return { ok: false, reason: "not-found" };
-        const template = deps.template(schedule.templateId);
-        if (template === undefined)
+        const known = scheduleKeywords(deps, schedule.templateId);
+        if (known === undefined)
             return { ok: false, reason: "missing-template" };
         const problems = topicRowProblems([{ title: parsed.data, values }], {
-            keywords: templateKeywords(template.document.form).filter((name) => name !== schedule.topicKeyword),
+            keywords: known.filter((name) => name !== schedule.topicKeyword),
             topicKeyword: schedule.topicKeyword,
         });
         if (problems.length > 0)
@@ -447,6 +458,7 @@ export function moveTopic(deps, scheduleId, input) {
             return { ok: false, reason: "invalid-input" };
         items.splice(Math.min(parsed.data.to, items.length), 0, topic);
         writeItems(deps, scheduleId, schedule.version, items);
+        pinTopic(deps.db, scheduleId, topic.title);
         return { ok: true, value: scheduleById(deps.db, scheduleId) };
     });
 }
@@ -463,11 +475,11 @@ export function replaceTopics(deps, scheduleId, input) {
         const schedule = open.value;
         if (schedule.version !== parsed.data.baseVersion)
             return { ok: false, reason: "conflict" };
-        const template = deps.template(schedule.templateId);
-        if (!template)
+        const keywords = scheduleKeywords(deps, schedule.templateId);
+        if (keywords === undefined)
             return { ok: false, reason: "missing-template" };
         const problems = topicRowProblems(parsed.data.items, {
-            keywords: templateKeywords(template.document.form),
+            keywords,
             topicKeyword: schedule.topicKeyword,
             kept: schedule.items,
         });

package/dist/slices/settings/cli-paths.js

@@ -2,9 +2,10 @@ import { constants } from "node:fs";
 import { access, stat } from "node:fs/promises";
 import { extname, isAbsolute } from "node:path";
 import { z } from "zod";
+import { isUnreachablePath } from "../../kernel/errors.js";
 import { cliProbeTimeoutMs, readinessFromProbe } from "./cli-status.js";
 import { providerById } from "./model.js";
-import { readSetting, writeSetting } from "./repo.js";
+import { readJsonSetting, writeSetting } from "./repo.js";
 export const cliPathMaxLength = 4096;
 const pathSchema = z
     .string()
@@ -20,8 +21,7 @@ export function cliPathStatus(db, id) {
     const provider = providerById(id);
     if (provider.auth !== "cli")
         throw new Error(`${id} is not a CLI provider`);
-    const stored = readSetting(db, `cli.path.${installationId(id)}`);
-    const configured = stored === undefined ? null : storedPathSchema.parse(JSON.parse(stored));
+    const configured = readJsonSetting(db, `cli.path.${installationId(id)}`, storedPathSchema, null);
     return { configured, command: configured ?? provider.binary };
 }
 // Read on each attempt, so a saved path reaches the next invocation without a restart.
@@ -82,9 +82,7 @@ async function save(deps, id, raw) {
                 : constants.X_OK);
         }
         catch (error) {
-            if (error instanceof Error &&
-                "code" in error &&
-                ["ENOENT", "ENOTDIR", "EACCES", "EPERM", "ELOOP"].includes(String(error.code)))
+            if (isUnreachablePath(error))
                 return {
                     ok: false,
                     message: "Slopify cannot find or run a program at this path. Check the path is correct and the file is allowed to run.",

package/dist/slices/settings/first-run.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { readinessIsUsable } from "../../kernel/ports/model.js";
-import { keyedProviders, readSetting, writeSetting } from "./repo.js";
+import { keyedProviders, readJsonSetting, readSetting, writeSetting } from "./repo.js";
 // What a fresh Play form picks before the user picks anything. Written once, on the first
 // launch that finds a command-line tool, and read by Play for every new draft.
 const choiceSchema = z.object({ provider: z.string().min(1), model: z.string() }).strict();
@@ -9,26 +9,17 @@ export const providerDefaultsSchema = z
     .strict();
 export const providerDefaultsKey = "provider.defaults";
 const defaultsKey = providerDefaultsKey;
+// Set by the first-launch callout's "Got it" in older versions. Nothing writes it now; an
+// install that pressed it keeps its first launch behind it.
 const doneKey = "first-run.done";
 // The order a text tool is preferred in when several are found.
 const textPreference = ["claude-code", "codex", "gemini"];
 export function readProviderDefaults(db) {
-    const raw = readSetting(db, defaultsKey);
-    if (raw === undefined)
-        return {};
-    try {
-        const parsed = providerDefaultsSchema.safeParse(JSON.parse(raw));
-        return parsed.success ? parsed.data : {};
-    }
-    catch {
-        return {};
-    }
-}
-export function dismissFirstRun(db) {
-    writeSetting(db, doneKey, "1");
+    return readJsonSetting(db, defaultsKey, providerDefaultsSchema, {});
 }
-// First launch: find Claude Code, Codex and Gemini, pick the found ones as Play's defaults, and
-// say a video can be made without any API key. Later launches only report what was found.
+// First launch: find Claude Code, Codex and Gemini and pick the found ones as Create's defaults.
+// Later launches only report what was found. The first-run screen (slices/onboarding) says what
+// was found in its own words.
 export async function firstRunStatus(deps, statuses) {
     const detected = statuses
         .filter((status) => status.readiness.kind === "cli")
@@ -67,28 +58,7 @@ export async function firstRunStatus(deps, statuses) {
         };
         writeSetting(deps.db, defaultsKey, JSON.stringify(defaults));
     }
-    const names = detected
-        .filter((cli) => cli.usable && cli.id !== "codex-image")
-        .map((cli) => cli.displayName);
-    const systemVoice = statuses.some((status) => status.readiness.kind === "local" && status.readiness.available);
-    const narration = systemVoice
-        ? "Narration can use your computer's built-in voice (System voice in Settings → Voices); add an ElevenLabs or OpenAI key later for a better one."
-        : "Narration still needs a voice provider key, or turn Audio off or upload your own.";
-    return {
-        firstRun,
-        detected,
-        defaults,
-        message: !firstRun
-            ? null
-            : names.length > 0
-                ? "You can make a video now, no API keys needed."
-                : "No AI command-line tool was found on this computer.",
-        detail: !firstRun
-            ? null
-            : names.length > 0
-                ? `Slopify found ${list(names)} and picked ${names.length === 1 ? "it" : "them"} on Play. ${narration} Keys are optional extras in Settings → Providers.`
-                : "Install Claude Code, Codex or Antigravity CLI and sign in once in a terminal, then reload this page. Or paste an API key in Settings → Providers.",
-    };
+    return { firstRun, detected, defaults };
 }
 async function firstModel(deps, provider, family) {
     try {
@@ -99,8 +69,3 @@ async function firstModel(deps, provider, family) {
         return "";
     }
 }
-function list(names) {
-    return names.length <= 1
-        ? (names[0] ?? "")
-        : `${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}`;
-}

package/dist/slices/settings/health.js

@@ -1,10 +1,15 @@
 import { choiceSites, retiredModelUsage, slotLabels, } from "../model-upkeep/usage.js";
 import { cliPathStatus } from "./cli-paths.js";
-import { keyGuides } from "./key-guides.js";
 import { testProviderKey } from "./key-test.js";
 import { isLocalCliProvider } from "./model.js";
 import { modelReach } from "./model-reach.js";
 import { providerStatuses } from "./readiness.js";
+// The kinds as Keys & services heads its lists.
+const familyTitles = {
+    llm: "Writing services",
+    tts: "Voice services",
+    image: "Image services",
+};
 const signInCommand = {
     "claude-code": "claude auth login",
     codex: "codex login",
@@ -13,7 +18,16 @@ const signInCommand = {
 function loginSource(id) {
     return id === "codex-image" ? "codex" : id;
 }
-// Where each provider's models are chosen, as "Text model in template “Weekly”".
+// Where a model is chosen, as a person finds it: "template “Weekly”", "the draft “Moon” on
+// Create".
+function siteWords(kind, name) {
+    if (kind !== "draft")
+        return `${kind} “${name}”`;
+    return name === "Untitled draft"
+        ? "an untitled draft on Create"
+        : `the draft “${name}” on Create`;
+}
+// Where each provider's models are chosen, as "Writing model in template “Weekly”".
 function uses(db) {
     const found = new Map();
     for (const site of choiceSites(db))
@@ -24,7 +38,7 @@ function uses(db) {
             const list = found.get(choice.provider) ?? [];
             list.push({
                 model: choice.model,
-                where: `${slotLabels[slot]} in ${site.kind} “${site.name}”`,
+                where: `${slotLabels[slot]} in ${siteWords(site.kind, site.name)}`,
             });
             found.set(choice.provider, list);
         }
@@ -37,7 +51,7 @@ function overall(checks, used, setUp) {
         return "warning";
     return setUp || used ? "ok" : "unused";
 }
-// "Check all" on Settings → Providers: each command-line tool found and signed in, each saved
+// "Check all" on Settings → Keys & services: each command-line tool found and signed in, each saved
 // key accepted by its provider, and each chosen model still offered and answering for the key.
 // `only` checks one provider: its row's Check again, or a sign-in fix-it's.
 export async function checkProviderHealth(deps, only) {
@@ -85,7 +99,7 @@ async function cliHealth(deps, status, used) {
             label: "Installed",
             state: used.length > 0 ? "problem" : "skipped",
             detail: readiness.issue ??
-                `${name} was not found on this computer. Install it, sign in once in a terminal, then choose Check all again. If it is installed somewhere unusual, set its path in Settings → Providers.`,
+                `${name} was not found on this computer. Install it, sign in once in a terminal, then press Check again. If it is installed somewhere unusual, set its path in Settings → Keys & services.`,
         });
         return { ...base, state: used.length > 0 ? "problem" : "unused", checks };
     }
@@ -93,7 +107,7 @@ async function cliHealth(deps, status, used) {
         label: "Installed",
         state: readiness.issueKind === "version" ? "problem" : "ok",
         detail: readiness.issueKind === "version"
-            ? (readiness.issue ?? `Update ${name}, then choose Check all again.`)
+            ? (readiness.issue ?? `Update ${name}, then press Check again.`)
             : `Found ${command}${readiness.version === undefined ? "" : ` (version ${readiness.version})`}.`,
     });
     const source = loginSource(status.id);
@@ -115,7 +129,7 @@ async function cliHealth(deps, status, used) {
             ? {
                 label: "Signed in",
                 state: "problem",
-                detail: `${name} is not signed in. Open a terminal on the computer running it, run "${signInCommand[source]}" and sign in, then choose Check all again.`,
+                detail: `${name} is not signed in. Open a terminal on the computer running it, run "${signInCommand[source]}" and sign in, then press Check again.`,
             }
             : {
                 label: "Signed in",
@@ -141,7 +155,7 @@ async function cliModels(deps, status, used) {
         return {
             label: "Chosen models",
             state: "warning",
-            detail: `Slopify could not read ${status.displayName}'s model list, so it could not check the chosen models. Make sure it is signed in and up to date, then choose Check all again.`,
+            detail: `Slopify could not read ${status.displayName}'s model list, so it could not check the chosen models. Make sure it is signed in and up to date, then press Check again.`,
         };
     }
     const ids = new Set(offered.map((model) => model.id));
@@ -174,14 +188,14 @@ async function reachable(deps, status, used) {
         return {
             label: "Model reachable",
             state: "problem",
-            detail: `${name} does not offer ${describe(missing)} to this key: the model id is wrong, retired, or the account has no access to it. Pick another model there and save, or enable the model for your account, then choose Check all again.`,
+            detail: `${name} does not offer ${describe(missing)} to this key: the model id is wrong, retired, or the account has no access to it. Pick another model there and save, or enable the model for your account, then press Check again.`,
         };
     const unknown = [...found].filter(([, reach]) => reach === "unknown").map(([model]) => model);
     if (unknown.length > 0)
         return {
             label: "Model reachable",
             state: "warning",
-            detail: `${name} didn't answer for ${unknown.join(", ")}, so Slopify couldn't confirm the key can use ${unknown.length === 1 ? "it" : "them"}. Check your internet connection, then choose Check all again.`,
+            detail: `${name} didn't answer for ${unknown.join(", ")}, so Slopify couldn't confirm the key can use ${unknown.length === 1 ? "it" : "them"}. Check your internet connection, then press Check again.`,
         };
     return {
         label: "Model reachable",
@@ -198,16 +212,17 @@ function describe(missing) {
 async function keyedHealth(deps, status, used, retired) {
     const { readiness } = status;
     const base = { id: status.id, displayName: status.displayName, family: status.family };
-    const guide = keyGuides[status.id];
     const checks = [];
     const hasKey = readiness.kind === "keyed" && readiness.hasKey;
     if (!hasKey) {
+        // Said where it is read, Keys & services: the service's own setup, under its kind, has
+        // the key box and where to get a key.
         checks.push({
-            label: "Key saved",
+            label: "Key",
             state: used.length > 0 ? "problem" : "skipped",
-            detail: `No key is saved.${used.length > 0 ? ` It is chosen for ${describe(used)}.` : ""} Make one at ${guide?.keyPage.url ?? "the provider's website"}, paste it in Settings → Providers → ${status.displayName} and choose Save.`,
+            detail: `${used.length > 0 ? `None is saved, and ${status.displayName} is chosen for ${describe(used)}.` : "None is saved."} Open ${status.displayName} under ${familyTitles[status.family]}, paste a key and press Save.`,
         });
-        return { ...base, state: used.length > 0 ? "problem" : "unused", checks };
+        return { ...base, state: used.length > 0 ? "no-key" : "unused", checks };
     }
     const test = await testProviderKey(deps, status.id);
     checks.push({
@@ -228,7 +243,7 @@ async function keyedHealth(deps, status, used, retired) {
             state: "problem",
             detail: `${describe(mine.map((usage) => ({
                 model: usage.model,
-                where: `${slotLabels[usage.slot]} in ${usage.kind} “${usage.name}”`,
+                where: `${slotLabels[usage.slot]} in ${siteWords(usage.kind, usage.name)}`,
             })))} ${mine.length === 1 ? "is" : "are"} no longer offered. Use Switch in Settings → Models → Retired models in use.`,
         });
     else if (used.length > 0)

package/dist/slices/settings/key-test.js

@@ -21,7 +21,7 @@ export function keyTestOutcome(provider, answer, checkedAt, badKey) {
     const guide = keyGuides[provider];
     const keyPage = guide === undefined ? "the provider's website" : guide.keyPage.url;
     const billing = guide?.billing?.url;
-    const place = `Settings → Providers → ${name}`;
+    const place = `Settings → Keys & services → ${name}`;
     const done = (result, message) => ({
         provider,
         result,

package/dist/slices/settings/model-reach.js

@@ -1,3 +1,4 @@
+import { probeRead } from "./probe-read.js";
 import { keyOf } from "./repo.js";
 // ceiling: a provider chosen in many templates still costs a handful of reads, not one per
 // model anywhere in the library.
@@ -12,23 +13,8 @@ export async function modelReach(deps, provider, models) {
         const known = reads.get(url);
         if (known !== undefined)
             return known;
-        const started = (async () => {
-            try {
-                const response = await deps.fetch(url, {
-                    headers: probe.headers(key),
-                    signal: AbortSignal.timeout(15_000),
-                    redirect: "error",
-                });
-                // A list is read whole; a single model's page only for its status.
-                const body = probe.model?.lists === undefined ? "" : await response.text();
-                if (probe.model?.lists === undefined)
-                    await response.body?.cancel().catch(() => { });
-                return { status: response.status, body };
-            }
-            catch {
-                return undefined;
-            }
-        })();
+        // A list is read whole; a single model's page only for its status.
+        const started = probeRead(deps.fetch, url, probe.headers(key), probe.model?.lists !== undefined);
         reads.set(url, started);
         return started;
     };

package/dist/slices/settings/model.js

@@ -11,8 +11,8 @@ export const providerIds = [
     "claude-code",
     "codex",
     "gemini",
-    "elevenlabs",
     "openai-tts",
+    "elevenlabs",
     "cartesia",
     "inworld",
     "system-voice",
@@ -37,6 +37,13 @@ export const systemVoiceProvider = "system-voice";
 export function isUncataloguedProvider(id) {
     return isLocalCliProvider(id) || id === systemVoiceProvider;
 }
+// The local stand-ins the bundled samples were made with (`src/sample-build/`): no catalogue
+// lists them, they cost nothing, and they exist only while the sample archives are built, so
+// a sample project names them but nothing new can run on them.
+export const sampleStandInProviders = ["sample-writer", "sample-artist", "sample-voice"];
+export function isSampleStandIn(id) {
+    return sampleStandInProviders.includes(id);
+}
 export const providers = [
     { id: "openrouter", family: "llm", displayName: "OpenRouter", auth: "key" },
     {
@@ -63,8 +70,10 @@ export const providers = [
         binary: "agy",
         versionArgs: ["--version"],
     },
-    { id: "elevenlabs", family: "tts", displayName: "ElevenLabs", auth: "key" },
+    // OpenAI first among the voices: the voices Slopify sets up are OpenAI's, so its key narrates
+    // at once, while ElevenLabs, Cartesia and Inworld also need a voice saved under Voices.
     { id: "openai-tts", family: "tts", displayName: "OpenAI", auth: "key" },
+    { id: "elevenlabs", family: "tts", displayName: "ElevenLabs", auth: "key" },
     { id: "cartesia", family: "tts", displayName: "Cartesia", auth: "key" },
     { id: "inworld", family: "tts", displayName: "Inworld", auth: "key" },
     { id: "system-voice", family: "tts", displayName: "System voice", auth: "local" },
@@ -137,4 +146,7 @@ export const defaultSettings = {
     appearance: "system",
     loudness: defaultLoudness,
     subtitleModel: defaultEnglishSubtitleModel,
+    videoEncoder: "cpu",
+    clipEncodeSpeed: "thorough",
+    renderPriority: "background",
 };

package/dist/slices/settings/playback.js

@@ -2,17 +2,24 @@ import { z } from "zod";
 import { englishSubtitleModels } from "../../kernel/ports/subtitles.js";
 import { silenceGapSecondsMax } from "../admission/rules.js";
 import { loudnessFields } from "../loudness/model.js";
+import { clipEncodeSpeeds, renderPriorities, videoEncoders } from "../video/encoding.js";
 import { appearances, defaultSettings } from "./model.js";
-import { readSetting, writeSetting } from "./repo.js";
+import { readJsonSetting, writeSetting } from "./repo.js";
 // The `settings` table is key/value, so each setting is its own row and a value the app
 // does not understand costs only that one setting.
 const silenceGapKey = "silenceGapSeconds";
 const appearanceKey = "appearance";
 const loudnessKey = "loudness";
 const subtitleModelKey = "subtitleModel";
+const videoEncoderKey = "videoEncoder";
+const clipEncodeSpeedKey = "clipEncodeSpeed";
+const renderPriorityKey = "renderPriority";
 const silenceGapValue = z.number().int().min(0).max(silenceGapSecondsMax);
 const appearanceValue = z.enum(appearances);
 const subtitleModelValue = z.enum(englishSubtitleModels);
+const videoEncoderValue = z.enum(videoEncoders);
+const clipEncodeSpeedValue = z.enum(clipEncodeSpeeds);
+const renderPriorityValue = z.enum(renderPriorities);
 const loudnessValue = z.object({
     enabled: z.boolean(),
     videoLufs: z.number(),
@@ -24,6 +31,9 @@ export function readSettings(deps) {
         appearance: parsed(deps, appearanceKey, appearanceValue, defaultSettings.appearance),
         loudness: parsed(deps, loudnessKey, loudnessValue, defaultSettings.loudness),
         subtitleModel: parsed(deps, subtitleModelKey, subtitleModelValue, defaultSettings.subtitleModel),
+        videoEncoder: parsed(deps, videoEncoderKey, videoEncoderValue, defaultSettings.videoEncoder),
+        clipEncodeSpeed: parsed(deps, clipEncodeSpeedKey, clipEncodeSpeedValue, defaultSettings.clipEncodeSpeed),
+        renderPriority: parsed(deps, renderPriorityKey, renderPriorityValue, defaultSettings.renderPriority),
     };
 }
 export function saveSettings(deps, settings) {
@@ -46,7 +56,25 @@ export function saveSettings(deps, settings) {
     if (!subtitleModelValue.safeParse(settings.subtitleModel).success) {
         fields.push({
             field: "subtitleModel",
-            message: "Choose Most accurate, Balanced or Smallest in Settings → Production defaults → Subtitle timing model.",
+            message: "Choose Most accurate, Balanced or Smallest in Settings → Production defaults → Caption timing model.",
+        });
+    }
+    if (!videoEncoderValue.safeParse(settings.videoEncoder).success) {
+        fields.push({
+            field: "videoEncoder",
+            message: "Choose Processor (x264) or NVIDIA graphics card (NVENC) in Settings → Production defaults → Video encoder.",
+        });
+    }
+    if (!clipEncodeSpeedValue.safeParse(settings.clipEncodeSpeed).success) {
+        fields.push({
+            field: "clipEncodeSpeed",
+            message: "Choose Thorough or Fast in Settings → Production defaults → Clip encoding.",
+        });
+    }
+    if (!renderPriorityValue.safeParse(settings.renderPriority).success) {
+        fields.push({
+            field: "renderPriority",
+            message: "Choose Normal or Background in Settings → Production defaults → Encoding priority.",
         });
     }
     if (fields.length > 0) {
@@ -56,31 +84,14 @@ export function saveSettings(deps, settings) {
     writeSetting(deps.db, appearanceKey, JSON.stringify(settings.appearance));
     writeSetting(deps.db, loudnessKey, JSON.stringify(settings.loudness));
     writeSetting(deps.db, subtitleModelKey, JSON.stringify(settings.subtitleModel));
+    writeSetting(deps.db, videoEncoderKey, JSON.stringify(settings.videoEncoder));
+    writeSetting(deps.db, clipEncodeSpeedKey, JSON.stringify(settings.clipEncodeSpeed));
+    writeSetting(deps.db, renderPriorityKey, JSON.stringify(settings.renderPriority));
     return { ok: true, settings };
 }
 // A stored value is JSON, and a hand-edited database is the only way it can be anything
 // but what was saved. Such a row falls back to the default and says so in the log rather
 // than reaching the app or taking the settings page down.
 function parsed(deps, key, schema, fallback) {
-    const stored = readSetting(deps.db, key);
-    if (stored === undefined) {
-        return fallback;
-    }
-    const result = schema.safeParse(jsonOf(stored));
-    if (result.success) {
-        return result.data;
-    }
-    deps.log.write("warn", "settings.invalid", {
-        detail: `setting ${key} is not a value this build understands; using the default`,
-    });
-    return fallback;
-}
-function jsonOf(stored) {
-    try {
-        return JSON.parse(stored);
-    }
-    catch {
-        // Not JSON at all: the same answer as JSON of the wrong shape, decided by the caller.
-        return undefined;
-    }
+    return readJsonSetting(deps.db, key, schema, fallback, deps.log);
 }

package/dist/slices/settings/probe-read.js

@@ -0,0 +1,16 @@
+export async function probeRead(fetch, url, headers, withBody) {
+    try {
+        const response = await fetch(url, {
+            headers,
+            signal: AbortSignal.timeout(15_000),
+            redirect: "error",
+        });
+        const body = withBody ? await response.text() : "";
+        if (!withBody)
+            await response.body?.cancel().catch(() => { });
+        return { status: response.status, body };
+    }
+    catch {
+        return undefined;
+    }
+}