@gentbajko/slopify 3.0.0 → 3.0.2

package/dist/slices/schedules/topics.js

@@ -1,11 +1,14 @@
 import { z } from "zod";
 import { transact } from "../../kernel/db/tx.js";
 import { liveProject } from "../admission/repo.js";
-import { scheduleChannel } from "../channels/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 { scheduleById } from "./repo.js";
-import { heldTopicSchema, queueMax, topicMoveSchema, topicTitleSchema, topicTransferSchema, } from "./schema.js";
+import { heldTopicEditSchema, heldTopicSchema, queueMax, topicMoveSchema, topicQueueSchema, topicTitleSchema, topicTransferSchema, } from "./schema.js";
 import { newTopics } from "./similar.js";
+import { templateKeywords, topicRowProblems } from "./topic-list.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
@@ -184,19 +187,24 @@ function nextRank(deps, scheduleId) {
     const rank = z.object({ rank: z.number().nullable() }).parse(row).rank;
     return rank === null ? 0 : rank + 1;
 }
-// Everything this schedule has queued, held, turned down or used, every project's title, and
-// the titles of the videos its channel made before Slopify (Channel page → Existing videos).
+// Everything this schedule has queued, held, turned down or used, the titles of the projects in
+// its channel, and the titles of the videos its channel made before Slopify (Channel page →
+// Existing videos). Another channel's videos are its own business: a sleep channel may cover a
+// subject a lore channel already did.
 export function knownTitles(deps, scheduleId) {
     const schedule = scheduleById(deps.db, scheduleId);
     const logged = deps.db
         .prepare("SELECT title FROM schedule_topics WHERE schedule_id=? ORDER BY created_at DESC")
         .all(scheduleId)
         .map((row) => z.object({ title: z.string() }).parse(row).title);
+    const channel = scheduleChannel(deps.db, scheduleId);
+    const channels = projectChannels(deps.db);
     const projects = deps.db
-        .prepare(`SELECT title FROM projects WHERE ${liveProject()} ORDER BY created_at DESC`)
+        .prepare(`SELECT id,title FROM projects WHERE ${liveProject()} ORDER BY created_at DESC`)
         .all()
-        .map((row) => z.object({ title: z.string() }).parse(row).title);
-    const channel = scheduleChannel(deps.db, scheduleId);
+        .map((row) => z.object({ id: z.string(), title: z.string() }).parse(row))
+        .filter((row) => channel === undefined || (channels.get(row.id) ?? defaultChannelId) === channel.id)
+        .map((row) => row.title);
     const existing = channel === undefined ? [] : channelVideoTitles(deps.db, channel.id);
     return {
         topics: [...new Set([...(schedule?.items.map((item) => item.title) ?? []), ...logged])],
@@ -273,7 +281,34 @@ export function parseTopics(answer) {
         .trim())
         .filter((line) => line !== "" && line !== "[" && line !== "]" && line.length <= 200);
 }
+// The keywords set on held topics, by topic id. Kept in a settings row, since a held topic's row
+// has only its title; an entry leaves when its topic is approved or turned down.
+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 {};
+    }
+}
+// Entries of topics that are no longer held (approved, turned down, or gone with their
+// schedule) are dropped on every write.
+function writeHeldValues(db, change = (values) => values) {
+    const held = new Set(db
+        .prepare("SELECT id FROM schedule_topics WHERE state='held'")
+        .all()
+        .map((row) => String(row.id)));
+    const next = Object.fromEntries(Object.entries(change(readHeldValues(db))).filter(([id, values]) => held.has(id) && Object.keys(values).length > 0));
+    writeSetting(db, heldValuesKey, JSON.stringify(next));
+}
 export function heldTopics(deps, scheduleId) {
+    const stored = readHeldValues(deps.db);
     return deps.db
         .prepare(`SELECT id,title,rank,created_at FROM schedule_topics
        WHERE schedule_id=? AND state='held' ORDER BY rank,created_at,id`)
@@ -285,6 +320,7 @@ export function heldTopics(deps, scheduleId) {
         return heldTopicSchema.parse({
             id: value.id,
             title: value.title,
+            values: stored[value.id] ?? {},
             rank: value.rank,
             createdAt: value.created_at,
         });
@@ -309,21 +345,22 @@ export function approveHeldTopics(deps, scheduleId, ids, edits = {}) {
         const chosen = ids === "all" ? held : held.filter((topic) => ids.includes(topic.id));
         if (ids !== "all" && chosen.length !== ids.length)
             return { ok: false, reason: "topic-not-found" };
-        const titles = [];
+        const items = [];
         for (const topic of chosen) {
             const title = topicTitleSchema.safeParse(edits[topic.id] ?? topic.title);
             if (!title.success)
                 return { ok: false, reason: "invalid-input" };
-            titles.push(title.data);
+            items.push({ title: title.data, values: topic.values });
         }
-        if (open.value.items.length + titles.length > queueMax)
+        if (open.value.items.length + items.length > queueMax)
             return { ok: false, reason: "queue-full" };
         const at = deps.clock.now().toISOString();
         for (const topic of chosen)
             deps.db.prepare("DELETE FROM schedule_topics WHERE id=?").run(topic.id);
         deps.db
             .prepare("UPDATE schedules SET items_json=?,version=version+1,updated_at=? WHERE id=?")
-            .run(JSON.stringify([...open.value.items, ...titles.map((title) => ({ title, values: {} }))]), at, scheduleId);
+            .run(JSON.stringify([...open.value.items, ...items]), at, scheduleId);
+        writeHeldValues(deps.db);
         return { ok: true, value: scheduleById(deps.db, scheduleId) };
     });
 }
@@ -335,16 +372,53 @@ export function rejectHeldTopic(deps, scheduleId, topicId) {
         .run(deps.clock.now().toISOString(), topicId, scheduleId);
     if (Number(changed.changes) !== 1)
         return { ok: false, reason: "topic-not-found" };
+    writeHeldValues(deps.db);
     return { ok: true, value: scheduleById(deps.db, scheduleId) };
 }
-export function editHeldTopic(deps, scheduleId, topicId, title) {
-    const parsed = topicTitleSchema.safeParse(title);
+// Edit on a held topic: its title, and the keywords it sets for its run, checked against the
+// template the way the queue's are. Without `values` the ones it had are kept; an empty value
+// is dropped, so the every-run value applies.
+export function editHeldTopic(deps, scheduleId, topicId, input) {
+    const edit = heldTopicEditSchema.safeParse(input);
+    if (!edit.success)
+        return { ok: false, reason: "invalid-input" };
+    const parsed = topicTitleSchema.safeParse(edit.data.title);
     if (!parsed.success)
         return { ok: false, reason: "invalid-input" };
-    const changed = deps.db
-        .prepare("UPDATE schedule_topics SET title=? WHERE id=? AND schedule_id=? AND state='held'")
-        .run(parsed.data, topicId, scheduleId);
-    if (Number(changed.changes) !== 1)
+    const values = edit.data.values === undefined
+        ? undefined
+        : Object.fromEntries(Object.entries(edit.data.values)
+            .map(([name, value]) => [name, value.trim()])
+            .filter(([, value]) => value !== ""));
+    if (values !== undefined && Object.keys(values).length > 0) {
+        const schedule = scheduleById(deps.db, scheduleId);
+        if (schedule === undefined)
+            return { ok: false, reason: "not-found" };
+        const template = deps.template(schedule.templateId, schedule.templateVersion);
+        if (template === undefined)
+            return { ok: false, reason: "missing-template" };
+        const problems = topicRowProblems([{ title: parsed.data, values }], {
+            keywords: templateKeywords(template.document.form).filter((name) => name !== schedule.topicKeyword),
+            topicKeyword: schedule.topicKeyword,
+        });
+        if (problems.length > 0)
+            return {
+                ok: false,
+                reason: "invalid-topics",
+                message: `The topic wasn't saved. ${problems.join(" ")}`,
+            };
+    }
+    const changed = transact(deps.db, () => {
+        const row = deps.db
+            .prepare("UPDATE schedule_topics SET title=? WHERE id=? AND schedule_id=? AND state='held'")
+            .run(parsed.data, topicId, scheduleId);
+        if (Number(row.changes) !== 1)
+            return false;
+        if (values !== undefined)
+            writeHeldValues(deps.db, (stored) => ({ ...stored, [topicId]: values }));
+        return true;
+    });
+    if (!changed)
         return { ok: false, reason: "topic-not-found" };
     const topic = heldTopics(deps, scheduleId).find((row) => row.id === topicId);
     return topic === undefined
@@ -376,6 +450,33 @@ export function moveTopic(deps, scheduleId, input) {
         return { ok: true, value: scheduleById(deps.db, scheduleId) };
     });
 }
+// Saves the queue as sent, without touching the schedule's other settings or its next run.
+// Topics already queued are not checked again; a new or renamed one must suit the template.
+export function replaceTopics(deps, scheduleId, input) {
+    const parsed = topicQueueSchema.safeParse(input);
+    if (!parsed.success)
+        return { ok: false, reason: "invalid-input" };
+    return transact(deps.db, () => {
+        const open = openSchedule(deps, scheduleId);
+        if (!open.ok)
+            return open;
+        const schedule = open.value;
+        if (schedule.version !== parsed.data.baseVersion)
+            return { ok: false, reason: "conflict" };
+        const template = deps.template(schedule.templateId, schedule.templateVersion);
+        if (!template)
+            return { ok: false, reason: "missing-template" };
+        const problems = topicRowProblems(parsed.data.items, {
+            keywords: templateKeywords(template.document.form),
+            topicKeyword: schedule.topicKeyword,
+            kept: schedule.items,
+        });
+        if (problems.length > 0)
+            return { ok: false, reason: "invalid-topics", message: problems.slice(0, 5).join(" ") };
+        writeItems(deps, scheduleId, schedule.version, parsed.data.items);
+        return { ok: true, value: scheduleById(deps.db, scheduleId) };
+    });
+}
 // Takes one queued topic off this schedule and puts it on another's queue.
 export function transferTopic(deps, scheduleId, input) {
     const parsed = topicTransferSchema.safeParse(input);

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

@@ -70,6 +70,10 @@ export async function firstRunStatus(deps, statuses) {
     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,
@@ -82,7 +86,7 @@ export async function firstRunStatus(deps, statuses) {
         detail: !firstRun
             ? null
             : names.length > 0
-                ? `Slopify found ${list(names)} and picked ${names.length === 1 ? "it" : "them"} on Play. Narration still needs a voice provider key, or turn Audio off or upload your own. Keys are optional extras in Settings → Providers.`
+                ? `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 Gemini CLI and sign in once in a terminal, then reload this page. Or paste an API key in Settings → Providers.",
     };
 }

package/dist/slices/settings/health.js

@@ -3,6 +3,7 @@ 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";
 const signInCommand = {
     "claude-code": "claude auth login",
@@ -37,17 +38,38 @@ function overall(checks, used, setUp) {
     return setUp || used ? "ok" : "unused";
 }
 // "Check all" on Settings → Providers: each command-line tool found and signed in, each saved
-// key accepted by its provider, and each chosen model still offered.
-export async function checkProviderHealth(deps) {
-    const statuses = await providerStatuses(deps);
+// 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) {
+    const statuses = (await providerStatuses(deps)).filter((status) => only === undefined || status.id === only);
     const inUse = uses(deps.db);
     const catalogue = deps.catalogue?.();
     const retired = catalogue === undefined ? [] : retiredModelUsage(deps.db, catalogue);
     const providers = await Promise.all(statuses.map((status) => status.readiness.kind === "cli"
         ? cliHealth(deps, status, inUse.get(status.id) ?? [])
-        : keyedHealth(deps, status, inUse.get(status.id) ?? [], retired)));
+        : status.readiness.kind === "local"
+            ? Promise.resolve(localHealth(status, inUse.get(status.id) ?? []))
+            : keyedHealth(deps, status, inUse.get(status.id) ?? [], retired)));
     return { checkedAt: deps.clock.now().toISOString(), providers };
 }
+// The system voice: a speech program was found, or not. Nothing to sign in to or pay for.
+function localHealth(status, used) {
+    const { readiness } = status;
+    const base = { id: status.id, displayName: status.displayName, family: status.family };
+    if (readiness.kind !== "local")
+        throw new Error("Expected the system voice.");
+    const found = readiness.available;
+    const checks = [
+        {
+            label: "Speech program found",
+            state: found ? "ok" : used.length > 0 ? "problem" : "skipped",
+            detail: found
+                ? `Speaks with ${readiness.engine ?? "this computer's speech program"}.`
+                : `${readiness.issue ?? "No speech program was found on this computer."}${used.length > 0 ? ` It is chosen for ${describe(used)}.` : ""}`,
+        },
+    ];
+    return { ...base, state: overall(checks, used.length > 0, found), checks };
+}
 async function cliHealth(deps, status, used) {
     const { readiness } = status;
     if (readiness.kind !== "cli" || !isLocalCliProvider(status.id))
@@ -79,7 +101,7 @@ async function cliHealth(deps, status, used) {
     if (status.cliPath?.managedOnHost === true && deps.hostCliStatus !== undefined) {
         login = (await deps.hostCliStatus(status.id)).login;
     }
-    else if (deps.login !== undefined && source !== "gemini") {
+    else if (deps.login !== undefined) {
         try {
             login = await deps.login(cliPathStatus(deps.db, status.id).command, source, AbortSignal.timeout(15_000));
         }
@@ -93,13 +115,15 @@ 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: source === "gemini"
+                    ? `Gemini CLI is not signed in: ~/.gemini has no Google sign-in and no GEMINI_API_KEY is set. Open a terminal on the computer running it, run "gemini" and choose Login with Google (or set GEMINI_API_KEY), then choose Check all again.`
+                    : `${name} is not signed in. Open a terminal on the computer running it, run "${signInCommand[source]}" and sign in, then choose Check all again.`,
             }
             : {
                 label: "Signed in",
                 state: "skipped",
                 detail: source === "gemini"
-                    ? `Gemini CLI has no sign-in check Slopify can ask. Run "gemini" in a terminal once to confirm it is signed in.`
+                    ? `Slopify could not tell from the Gemini CLI's files (~/.gemini/settings.json) whether it is signed in. Run "gemini" in a terminal once to confirm it is signed in.`
                     : `Slopify could not tell whether ${name} is signed in. Run "${signInCommand[source]}" in a terminal if runs fail with a sign-in error.`,
             });
     if (used.length > 0)
@@ -138,6 +162,37 @@ async function cliModels(deps, status, used) {
         detail: `${status.displayName} does not offer ${describe(missing)}. Update ${status.displayName}, or pick another model there and save.`,
     };
 }
+// Asks the provider, with the saved key, for each chosen model: a model the account can't use
+// fails here before a run does.
+async function reachable(deps, status, used) {
+    const name = status.displayName;
+    const found = await modelReach(deps, status.id, used.map((use) => use.model));
+    if (found === undefined)
+        return {
+            label: "Model reachable",
+            state: "skipped",
+            detail: `${name} has no model check Slopify can ask without generating something. The key works; the first run shows whether the model does.`,
+        };
+    const missing = used.filter((use) => found.get(use.model) === "missing");
+    if (missing.length > 0)
+        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.`,
+        };
+    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.`,
+        };
+    return {
+        label: "Model reachable",
+        state: "ok",
+        detail: `${name} answered for ${[...found.keys()].join(", ")} with this key.`,
+    };
+}
 function describe(missing) {
     const shown = missing.slice(0, 3).map((use) => `${use.model} (${use.where})`);
     return missing.length > 3
@@ -186,5 +241,7 @@ async function keyedHealth(deps, status, used, retired) {
             state: "ok",
             detail: "Every chosen model is still offered.",
         });
+    if (used.length > 0 && test.ok)
+        checks.push(await reachable(deps, status, used));
     return { ...base, state: overall(checks, used.length > 0, true), checks };
 }

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

@@ -17,6 +17,19 @@ const openAi = {
         url: "https://developers.openai.com/api/docs/guides/error-codes",
     },
 };
+const google = {
+    signUp: { label: "aistudio.google.com", url: "https://aistudio.google.com" },
+    keyPage: { label: "aistudio.google.com/apikey", url: "https://aistudio.google.com/apikey" },
+    billing: { label: "Projects → Set up billing", url: "https://aistudio.google.com/projects" },
+    steps: [
+        "Sign in to Google AI Studio with your Google account.",
+        "Open Projects and choose Set up billing next to your project: Gemini image models are not available on the free tier.",
+        "Open API keys, choose Create API key, and copy it.",
+        "Paste it here, choose Save, then Test.",
+    ],
+    permissions: "Use a key made in AI Studio. An older Google Cloud key must be set to Restrict to Gemini API only, or Google rejects it.",
+    docs: { label: "Gemini API keys", url: "https://ai.google.dev/gemini-api/docs/api-key" },
+};
 export const keyGuides = {
     openrouter: {
         signUp: { label: "openrouter.ai/sign-up", url: "https://openrouter.ai/sign-up" },
@@ -33,18 +46,15 @@ export const keyGuides = {
     },
     "openai-tts": openAi,
     "openai-image": openAi,
-    "google-image": {
-        signUp: { label: "aistudio.google.com", url: "https://aistudio.google.com" },
-        keyPage: { label: "aistudio.google.com/apikey", url: "https://aistudio.google.com/apikey" },
-        billing: { label: "Projects → Set up billing", url: "https://aistudio.google.com/projects" },
+    "google-image": google,
+    "google-tts": {
+        ...google,
         steps: [
             "Sign in to Google AI Studio with your Google account.",
-            "Open Projects and choose Set up billing next to your project: Gemini image models are not available on the free tier.",
             "Open API keys, choose Create API key, and copy it.",
             "Paste it here, choose Save, then Test.",
         ],
-        permissions: "Use a key made in AI Studio. An older Google Cloud key must be set to Restrict to Gemini API only, or Google rejects it.",
-        docs: { label: "Gemini API keys", url: "https://ai.google.dev/gemini-api/docs/api-key" },
+        permissions: `The same Gemini API key as Google images: with one saved there, Gemini voices use it and nothing is needed here. ${google.permissions}`,
     },
     fal: {
         signUp: { label: "fal.ai/login", url: "https://fal.ai/login" },

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

@@ -1,6 +1,6 @@
 import { keyGuides } from "./key-guides.js";
+import { keyWithShared } from "./keys.js";
 import { providerById } from "./model.js";
-import { keyOf } from "./repo.js";
 // What the Test button found. `ok` is the only thing the screen needs to colour the line;
 // `message` says what happened and, when it failed, exactly what to do.
 export const keyTestResults = [
@@ -54,15 +54,23 @@ export function keyTestOutcome(provider, answer, checkedAt, badKey) {
     return done("unexpected", `${name} answered the key check with HTTP ${status}, which Slopify did not expect. Check the key at ${keyPage}, then choose Test again; if it keeps happening, use Download diagnostics in Settings and report it.`);
 }
 // The Test button. The key is read for this one request, sent only to its own provider, and
-// never appears in the answer, a log line or an error.
-export async function testProviderKey(deps, provider) {
+// never appears in the answer, a log line or an error. `pasted` is a key typed into the field
+// and not saved yet: it is tried instead of the saved one and is not stored.
+export async function testProviderKey(deps, provider, pasted) {
     const at = () => deps.clock.now().toISOString();
     const probe = Object.hasOwn(deps.probes, provider) ? deps.probes[provider] : undefined;
     if (probe === undefined || providerById(provider).auth !== "key")
         throw new Error(`${provider} has no key to test`);
-    const key = keyOf(deps.db, provider);
+    const candidate = pasted?.trim();
+    const key = candidate === undefined || candidate === "" ? keyWithShared(deps.db, provider) : candidate;
     if (key === undefined)
         return keyTestOutcome(provider, { failure: "no-key" }, at());
+    const outcome = await probeKey(deps, provider, probe, key, at);
+    return candidate === undefined || candidate === "" || !outcome.ok
+        ? outcome
+        : { ...outcome, message: `${outcome.message} It is not saved yet: choose Save to keep it.` };
+}
+async function probeKey(deps, provider, probe, key, at) {
     let status;
     let body = "";
     try {

package/dist/slices/settings/keys.js

@@ -1,4 +1,4 @@
-import { providerById } from "./model.js";
+import { providerById, sharedKeyOf } from "./model.js";
 import { deleteKey, hasKey, keyOf, upsertKey } from "./repo.js";
 // The Settings field shows a stored key masked, with nothing legible in it, and a key never
 // appears outside a provider call. So the mask is a constant: it carries no character of
@@ -12,7 +12,7 @@ export function keyStatus(deps, provider) {
 // Trimmed, stored as given, overwriting any previous one. No format
 // check and no test call.
 export function saveProviderKey(deps, provider, key) {
-    if (providerById(provider).auth === "cli") {
+    if (providerById(provider).auth !== "key") {
         return { ok: false, reason: "cli-provider" };
     }
     const trimmed = key.trim();
@@ -31,7 +31,7 @@ export function saveProviderKey(deps, provider, key) {
     return { ok: true };
 }
 export function removeProviderKey(deps, provider) {
-    if (providerById(provider).auth === "cli") {
+    if (providerById(provider).auth !== "key") {
         return { ok: false, reason: "cli-provider" };
     }
     return deleteKey(deps.db, provider) ? { ok: true } : { ok: false, reason: "absent" };
@@ -40,12 +40,17 @@ export function removeProviderKey(deps, provider) {
 // every time and hands back a plain string, so an attempt holds the value it started
 // with and a save or a remove landing mid-run reaches the next attempt only.
 export function keyForAttempt(deps, provider) {
-    if (providerById(provider).auth === "cli") {
+    if (providerById(provider).auth !== "key") {
         return { ok: false, reason: "cli-provider" };
     }
-    const key = keyOf(deps.db, provider);
+    const key = keyWithShared(deps.db, provider);
     return key === undefined ? { ok: false, reason: "key-missing" } : { ok: true, key };
 }
+// The provider's own key, else the key of the provider it shares one with (`sharedKeyOf`).
+export function keyWithShared(db, provider) {
+    const shared = sharedKeyOf[provider];
+    return keyOf(db, provider) ?? (shared === undefined ? undefined : keyOf(db, shared));
+}
 function codeOf(error) {
     if (error instanceof Error && "errcode" in error && typeof error.errcode === "number") {
         return `sqlite error ${String(error.errcode)}`;

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

@@ -0,0 +1,52 @@
+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.
+const modelsChecked = 5;
+export async function modelReach(deps, provider, models) {
+    const probe = Object.hasOwn(deps.probes, provider) ? deps.probes[provider] : undefined;
+    const key = keyOf(deps.db, provider);
+    if (probe?.model === undefined || key === undefined)
+        return undefined;
+    const reads = new Map();
+    const read = (url) => {
+        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;
+            }
+        })();
+        reads.set(url, started);
+        return started;
+    };
+    const found = new Map();
+    for (const model of [...new Set(models)].slice(0, modelsChecked)) {
+        const answer = await read(probe.model.url(model));
+        found.set(model, verdict(answer, model, probe.model.lists));
+    }
+    return found;
+}
+function verdict(answer, model, lists) {
+    if (answer === undefined)
+        return "unknown";
+    if (answer.status >= 200 && answer.status < 300) {
+        if (lists === undefined)
+            return "found";
+        const listed = lists(answer.body, model);
+        return listed === undefined ? "unknown" : listed ? "found" : "missing";
+    }
+    return answer.status === 404 && lists === undefined ? "missing" : "unknown";
+}

package/dist/slices/settings/model.js

@@ -14,6 +14,8 @@ export const providerIds = [
     "openai-tts",
     "cartesia",
     "inworld",
+    "system-voice",
+    "google-tts",
     "fal",
     "replicate",
     "openai-image",
@@ -28,6 +30,12 @@ export function isLocalCliProvider(id) {
 export function localCliConcurrency(id) {
     return id === "codex-image" ? 4 : 3;
 }
+export const systemVoiceProvider = "system-voice";
+// A provider Slopify's model list (models.yaml) does not carry: an agent CLI lists its own
+// models, and the system voice's "models" are the speech programs found on this computer.
+export function isUncataloguedProvider(id) {
+    return isLocalCliProvider(id) || id === systemVoiceProvider;
+}
 export const providers = [
     { id: "openrouter", family: "llm", displayName: "OpenRouter", auth: "key" },
     {
@@ -58,6 +66,8 @@ export const providers = [
     { id: "openai-tts", family: "tts", displayName: "OpenAI", 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" },
+    { id: "google-tts", family: "tts", displayName: "Google Gemini", auth: "key" },
     { id: "fal", family: "image", displayName: "fal.ai", auth: "key" },
     { id: "replicate", family: "image", displayName: "Replicate", auth: "key" },
     { id: "openai-image", family: "image", displayName: "OpenAI", auth: "key" },
@@ -71,6 +81,45 @@ export const providers = [
         versionArgs: ["--version"],
     },
 ];
+// One Gemini API key pays for Google's speech and its images, so Gemini TTS uses the key saved
+// for Google images until one of its own is saved.
+export const sharedKeyOf = {
+    "google-tts": "google-image",
+};
+// The 30 prebuilt voices Gemini TTS speaks with (https://ai.google.dev/gemini-api/docs/speech-generation#voices),
+// each with the style Google gives it. Settings → Voices offers them for Google Gemini.
+export const geminiVoices = [
+    { name: "Zephyr", style: "Bright" },
+    { name: "Puck", style: "Upbeat" },
+    { name: "Charon", style: "Informative" },
+    { name: "Kore", style: "Firm" },
+    { name: "Fenrir", style: "Excitable" },
+    { name: "Leda", style: "Youthful" },
+    { name: "Orus", style: "Firm" },
+    { name: "Aoede", style: "Breezy" },
+    { name: "Callirrhoe", style: "Easy-going" },
+    { name: "Autonoe", style: "Bright" },
+    { name: "Enceladus", style: "Breathy" },
+    { name: "Iapetus", style: "Clear" },
+    { name: "Umbriel", style: "Easy-going" },
+    { name: "Algieba", style: "Smooth" },
+    { name: "Despina", style: "Smooth" },
+    { name: "Erinome", style: "Clear" },
+    { name: "Algenib", style: "Gravelly" },
+    { name: "Rasalgethi", style: "Informative" },
+    { name: "Laomedeia", style: "Upbeat" },
+    { name: "Achernar", style: "Soft" },
+    { name: "Alnilam", style: "Firm" },
+    { name: "Schedar", style: "Even" },
+    { name: "Gacrux", style: "Mature" },
+    { name: "Pulcherrima", style: "Forward" },
+    { name: "Achird", style: "Friendly" },
+    { name: "Zubenelgenubi", style: "Casual" },
+    { name: "Vindemiatrix", style: "Gentle" },
+    { name: "Sadachbia", style: "Lively" },
+    { name: "Sadaltager", style: "Knowledgeable" },
+    { name: "Sulafat", style: "Warm" },
+];
 export function providerById(id) {
     const found = providers.find((provider) => provider.id === id);
     if (found === undefined) {

package/dist/slices/settings/models.js

@@ -2,7 +2,10 @@ import { isLocalCliProvider } from "./model.js";
 // These marketplaces host models with different input schemas. Discovery alone cannot
 // make an arbitrary endpoint compatible with our image request.
 export function allowsCustomModel(provider) {
-    return provider !== "fal" && provider !== "replicate" && provider !== "codex-image";
+    return (provider !== "fal" &&
+        provider !== "replicate" &&
+        provider !== "codex-image" &&
+        provider !== "system-voice");
 }
 const ttlMs = 5 * 60_000;
 const retryMs = 30_000;
@@ -86,6 +89,7 @@ function catalogNotice(provider) {
         gemini: "Models come from your installed Gemini CLI, not an account access check. Missing a new model? Update Gemini CLI, rerun the Docker launcher if applicable, then refresh this list.",
         "claude-code": "Models come from Claude Code. Missing a new model? Update Claude Code, rerun the Docker launcher if applicable, then refresh this list. You can also enter an exact model ID.",
         inworld: "These are Inworld’s documented TTS models. You can also enter a compatible model ID.",
+        "system-voice": "These are the speech programs found on this computer, best first. Install another (for example espeak-ng) and refresh to see it.",
         cartesia: "Cartesia has no model-list API. These are bundled compatible choices; you can enter a newer model ID.",
         fal: "These models have input formats supported by Slopify's fal adapter.",
         replicate: "These models have input formats supported by Slopify's Replicate adapter.",