@gentbajko/slopify 4.0.0 → 4.1.0

package/dist/slices/uploads/repo.js

@@ -1,5 +1,5 @@
 import { admittedUnfinished } from "../admission/admitted-work.js";
-import { oneProject } from "../admission/repo.js";
+import { liveProject, oneProject } from "../admission/repo.js";
 export function markUploaded(db, projectId, uploaded, at) {
     if (db.prepare("SELECT 1 FROM projects WHERE id=?").get(projectId) === undefined)
         return { ok: false, reason: "not-found" };
@@ -35,6 +35,42 @@ export function uploadedAndSettled(db, projectId) {
         .all(...one.params)
         .map((row) => String(row.project_id)));
 }
+// A finished project an edit left with outdated files reads done too, not "Stopped": every step
+// still to run made its files before the edit (a selected output of the current version, now
+// outdated), and nothing runs it until the person chooses to make those files again, which shows
+// the cost first. Renaming a project with a PDF is one: its PDF prints the title. A step that
+// never made a file, a failed or canceled step, a step a run admitted (`admittedUnfinished`, as
+// a restart holds it), a pause or a queued run keep it unsettled, so a run a restart stopped
+// still reads Stopped. So does a version saved to make a section again (Make … again, a review's
+// redo) whose run was refused, say for a missing key: the person asked for that work, and Continue
+// the run starts it. One project's alone when `projectId` is given.
+export function editedAndSettled(db, projectId) {
+    const one = oneProject("h", projectId);
+    const unfinished = "s.project_id=h.project_id AND s.state NOT IN ('done','provided','skipped')";
+    return new Set(db
+        .prepare(`SELECT h.project_id FROM project_heads h
+         WHERE ${liveProject("h", "project_id")}
+           AND EXISTS(SELECT 1 FROM stages s WHERE ${unfinished})
+           AND NOT EXISTS(SELECT 1 FROM stages s WHERE ${unfinished}
+             AND (s.state!='pending' OR NOT EXISTS(SELECT 1 FROM revision_outputs o
+               WHERE o.project_id=h.project_id AND o.revision_id=h.revision_id AND o.selected=1
+                 AND o.state='outdated' AND json_extract(o.descriptor,'$.stageKind')=s.kind)))
+           AND NOT EXISTS(SELECT 1 FROM revision_work w WHERE w.project_id=h.project_id
+             AND w.state IN ('pending','running')
+             AND (w.dispatch_state!='held' OR ${admittedUnfinished("w")}))
+           AND NOT EXISTS(SELECT 1 FROM project_recovery_requests r WHERE r.project_id=h.project_id
+             AND r.intent_revision_id=h.revision_id)
+           AND NOT EXISTS(SELECT 1 FROM project_controls c WHERE c.project_id=h.project_id AND c.paused=1)
+           AND NOT EXISTS(SELECT 1 FROM project_queue q WHERE q.project_id=h.project_id AND q.state='queued')${one.sql}`)
+        .all(...one.params)
+        .map((row) => String(row.project_id)));
+}
+// Every project that reads done though a step is left: uploaded with nothing left to run
+// (`uploadedAndSettled`), or finished and left only with files an edit made outdated
+// (`editedAndSettled`).
+export function settledProjects(db, projectId) {
+    return new Set([...uploadedAndSettled(db, projectId), ...editedAndSettled(db, projectId)]);
+}
 // "Keep as is": a waiting run the person leaves as it is, until the project's next edit. Set on
 // the current head revision; the listing counts it only while that revision is still the head.
 export function setAside(db, projectId, aside, at) {

package/dist/slices/uploads/rules.js

@@ -1,5 +1,6 @@
-// An uploaded, settled project (`uploadedAndSettled`) reads done where its run would read paused
-// or pending: the Projects list, a project's page and the calendar.
+// A settled project (`settledProjects`: uploaded with nothing left to run, or finished and left
+// only with files an edit made outdated) reads done where its run would read paused or pending:
+// the Projects list, a project's page and the calendar.
 export function settledStatus(status, settled) {
     return settled && (status === "paused" || status === "pending") ? "done" : status;
 }

package/dist/slices/video/edit-list.js

@@ -116,9 +116,9 @@ const editListSchema = z
 export function readEditList(value) {
     const version = typeof value === "object" && value !== null && "version" in value ? value.version : undefined;
     if (version !== editListVersion)
-        throw new Error(`This video's edit list is version ${String(version)}, and this Slopify reads version ${editListVersion}. Update Slopify, or use More → Render the video again in the Video section to plan it again.`);
+        throw new Error(`This video's edit list is version ${String(version)}, and this Slopify reads version ${editListVersion}. Update Slopify, or press Make the video again in the project's Video section to plan it again.`);
     const parsed = editListSchema.safeParse(value);
     if (!parsed.success)
-        throw new Error(`This video's edit list is damaged (${parsed.error.issues[0]?.path.join(".") || "the list"}: ${parsed.error.issues[0]?.message ?? "not readable"}). Use More → Render the video again in the Video section to plan it again.`);
+        throw new Error(`This video's edit list is damaged (${parsed.error.issues[0]?.path.join(".") || "the list"}: ${parsed.error.issues[0]?.message ?? "not readable"}). Press Make the video again in the project's Video section to plan it again.`);
     return parsed.data;
 }

package/dist/slices/video/edit-settings.js

@@ -177,7 +177,7 @@ export function videoEditRows(edit) {
         ],
         ["Vignette", lookLevelLabels[edit.vignette]],
         ["Film grain", lookLevelLabels[edit.grain]],
-        ["Colour grade", colorGradeLabels[edit.grade]],
+        ["Color grade", colorGradeLabels[edit.grade]],
         ["Atmosphere", atmosphereLabels[edit.atmosphere]],
         ["Chapter cards", edit.chapterCards ? "On" : "Off"],
         [

package/dist/slices/video/encoding.js

@@ -55,7 +55,15 @@ export function codecArgs(encode, role, look) {
             : []),
     ];
 }
-export const noNvenc = "No NVIDIA encoder found on this computer.";
+// Said to a person who may have no NVIDIA card at all: stock ffmpeg builds list the NVIDIA
+// encoder everywhere, so a failed test usually means there is no card, not a broken one. What
+// the test printed goes under Details (`detail`), never into these sentences.
+export const noNvenc = "No NVIDIA graphics card was found on this computer.";
+export const failedNvenc = "No working NVIDIA graphics card was found on this computer.";
+// The reason with the test's output, for the log and a run's notice.
+export function nvencWhy(status) {
+    return status.detail === undefined ? status.reason : `${status.reason} (${status.detail})`;
+}
 // The renders' own settings on a tiny picture: a driver or card that refuses any of them fails
 // here rather than in a render. NVENC refuses anything under about 145 pixels across.
 const testArgs = [
@@ -84,7 +92,8 @@ export function createNvencProbe(deps) {
     return () => {
         answer ??= probe(deps).catch((error) => ({
             available: false,
-            reason: `${noNvenc} (${errorText(error)})`,
+            reason: noNvenc,
+            detail: errorText(error),
         }));
         return answer;
     };
@@ -112,7 +121,7 @@ async function probe(deps) {
     }
     if (failed !== undefined) {
         deps.log.write("info", "video.encoder", { detail: failed });
-        return { available: false, reason: `${noNvenc} (${failed})` };
+        return { available: false, reason: failedNvenc, detail: failed };
     }
     return { available: false, reason: noNvenc };
 }
@@ -133,11 +142,11 @@ export async function renderMachine(deps) {
         };
     deps.log.write("warn", "video.encoder", {
         projectId: deps.projectId,
-        detail: `NVIDIA encoder chosen but unavailable; encoding on the processor. ${status.reason}`,
+        detail: `NVIDIA encoder chosen but unavailable; encoding on the processor. ${nvencWhy(status)}`,
     });
     return {
         machine: { encode: cpu, priority: settings.renderPriority },
-        notice: nvencFallbackNotice(status.reason),
+        notice: nvencFallbackNotice(nvencWhy(status)),
     };
 }
 export function nvencFallbackNotice(reason) {

package/dist/slices/video/ffmpeg.js

@@ -46,7 +46,7 @@ export function slideshowClips(edit) {
             named.set(key, name);
             const shot = edit.shots[segment.kind === "shot" ? segment.shot : segment.to];
             if (shot === undefined)
-                throw new Error(internalError("the video's edit list lost a shot", "Use More → Render the video again in the Video section"));
+                throw new Error(internalError("the video's edit list lost a shot", "Press Make the video again in the project's Video section"));
             clips.push({ name, segment, shot, frames: segment.count });
         }
         return name;
@@ -93,7 +93,7 @@ encode = defaultEncode) {
     const chains = [];
     const picture = (shot, from, label) => {
         if (shot === undefined)
-            throw new Error(internalError("the video's edit list lost a shot", "Use More → Render the video again in the Video section"));
+            throw new Error(internalError("the video's edit list lost a shot", "Press Make the video again in the project's Video section"));
         const at = inputs.filter((one) => one === "-i").length;
         const built = pictureChain(edit, shot, from, segment.count, at, label, gradeFilter(edit.look));
         inputs.push(...built.inputs);

package/dist/slices/video/plan.js

@@ -1,3 +1,4 @@
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { chapterCuts, narrationShotFrames } from "./cuts.js";
 import { editListVersion, } from "./edit-list.js";
 import { chapterCardSeconds, endScreenSeconds } from "./edit-settings.js";
@@ -41,7 +42,7 @@ const figureGapSeconds = 1;
 export function planRender(input) {
     if (input.images.length === 0) {
         // Admission permits Video only with an image source, so an empty set is a bug upstream.
-        throw new Error("The video needs at least one image, but there are none. Check the Images section in Edit project, then Try again.");
+        throw new Error(`The video needs at least one image, but there are none. Check ${editSettings.images}, then Try again.`);
     }
     const frame = frames[input.format];
     const bed = input.body === undefined ? undefined : input.bed;

package/dist/slices/video/slideshow.js

@@ -62,7 +62,7 @@ async function renderWith(run, encode) {
         const font = edit.cardFont;
         if (cards.length > 0) {
             if (font === undefined)
-                throw new Error(internalError("the chapter cards have no font", "Use More → Render the video again in the Video section"));
+                throw new Error(internalError("the chapter cards have no font", "Press Make the video again in the project's Video section"));
             mkdirSync(join(workspace, "fonts"), { mode: 0o700 });
             copyFileSync(font.path, join(workspace, "fonts", `card${extname(font.path)}`));
         }

package/dist/slices/voices/attribution.js

@@ -1,3 +1,4 @@
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { parseScript } from "./script.js";
 // Audiobooks from an existing text: the text model hands each passage to a speaker - the
 // narrator's prose to the narrator, each quoted line to the character who says it - and
@@ -35,12 +36,12 @@ export function parseAttribution(answer, source, speakers) {
     if (expected.length > 0 && kept / expected.length < 0.9)
         return {
             ok: false,
-            reason: `The speaker split left out ${String(expected.length - kept)} of the text's ${String(expected.length)} words. The text model must hand every word to a speaker; Try again, or choose another model in Edit project → Providers.`,
+            reason: `The speaker split left out ${String(expected.length - kept)} of the text's ${String(expected.length)} words. The AI model must hand every word to a speaker; Try again, or choose another model in ${editSettings.writer}.`,
         };
     if (got.length - kept > Math.max(3, expected.length * 0.1))
         return {
             ok: false,
-            reason: `The speaker split added ${String(got.length - kept)} words that are not in the text. The text model must not write anything of its own; Try again, or choose another model in Edit project → Providers.`,
+            reason: `The speaker split added ${String(got.length - kept)} words that are not in the text. The AI model must not write anything of its own; Try again, or choose another model in ${editSettings.writer}.`,
         };
     return parsed;
 }

package/dist/slices/voices/model.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { createRows, editSettings } from "../../kernel/ports/settings-places.js";
 // Multiple voices: a run whose narration is a script of speaker turns rather than one voice
 // reading an article. Absent on a run is the Narration format, which is every project saved
 // before this existed, and nothing about such a run reads anything in this slice.
@@ -136,23 +137,23 @@ export function voicesProblems(settings) {
     if (speakers.length === 0)
         problems.push({
             field: "voices.speakers",
-            message: "Add at least one speaker under Speakers (Play → Narration, or Edit project → Providers).",
+            message: `Add at least one speaker under Speakers (${createRows.narration}, or ${editSettings.narration}).`,
         });
     if (settings.source === "attribute" && settings.format !== "audiobook")
         problems.push({
             field: "voices.source",
-            message: "Only audiobooks can hand an existing text's dialogue to speakers. Choose Write a script under Speakers (Play → Narration, or Edit project → Providers).",
+            message: `Only audiobooks can hand an existing text's dialogue to speakers. Choose Write a script under Speakers (${createRows.narration}, or ${editSettings.narration}).`,
         });
     if ((settings.format === "podcast" || settings.format === "interview") && speakers.length < 2)
         problems.push({
             field: "voices.speakers",
-            message: `A ${voiceFormatLabels[settings.format].toLowerCase()} needs at least two speakers. Add one under Speakers (Play → Narration, or Edit project → Providers).`,
+            message: `A ${voiceFormatLabels[settings.format].toLowerCase()} needs at least two speakers. Add one under Speakers (${createRows.narration}, or ${editSettings.narration}).`,
         });
     if ((settings.format === "audiobook" || settings.format === "drama") &&
         !speakers.some((speaker) => speaker.role === "narrator"))
         problems.push({
             field: "voices.speakers",
-            message: `An ${settings.format === "drama" ? "radio drama" : "audiobook"} needs a narrator. Set one speaker's role to Narrator under Speakers (Play → Narration, or Edit project → Providers).`,
+            message: `An ${settings.format === "drama" ? "radio drama" : "audiobook"} needs a narrator. Set one speaker's role to Narrator under Speakers (${createRows.narration}, or ${editSettings.narration}).`,
         });
     const names = new Set();
     const ids = new Set();
@@ -181,7 +182,7 @@ export function voicesProblems(settings) {
         if (speaker.voice.provider.trim() === "" || speaker.voice.model.trim() === "")
             problems.push({
                 field: `${field}.voice`,
-                message: `Choose a voice provider and model for ${name || "this speaker"}.`,
+                message: `Choose a voice service and model for ${name || "this speaker"}.`,
             });
         else if (speaker.voice.voice.trim() === "")
             problems.push({
@@ -198,20 +199,20 @@ export function voicesProblems(settings) {
         if (settings.book.title.trim() === "")
             problems.push({
                 field: "voices.book.title",
-                message: "Enter the book's title under Speakers (Play → Narration), or remove the book to make a project on its own.",
+                message: `Enter the book's title under Speakers (${createRows.narration}, or ${editSettings.narration}), or remove the book to make a project on its own.`,
             });
         if (!Number.isInteger(settings.book.chapter) ||
             settings.book.chapter < 1 ||
             settings.book.chapter > bookChapterMax)
             problems.push({
                 field: "voices.book.chapter",
-                message: `Enter a chapter number from 1 to ${String(bookChapterMax)} under Speakers (Play → Narration).`,
+                message: `Enter a chapter number from 1 to ${String(bookChapterMax)} under Speakers (${createRows.narration}, or ${editSettings.narration}).`,
             });
     }
     if (!turnGapSteps.includes(settings.turnGapSeconds))
         problems.push({
             field: "voices.turnGapSeconds",
-            message: "Pick a gap between turns from the list under Speakers (Play → Narration, or Edit project → Providers).",
+            message: `Pick a gap between turns from the list under Speakers (${createRows.narration}, or ${editSettings.narration}).`,
         });
     return problems;
 }

package/dist/slices/voices/script.js

@@ -1,3 +1,4 @@
+import { createRows, editSettings } from "../../kernel/ports/settings-places.js";
 import { voiceFormatLabels } from "./model.js";
 const heading = /^#{1,6}\s+(.+?)\s*#*\s*$/;
 const turnLine = /^\*{0,2}([^:*\n]{1,60}?)\*{0,2}\s*:\s*\*{0,2}\s*(.*)$/;
@@ -42,7 +43,7 @@ export function parseScript(markdown, speakers, keepMarkdown = false) {
             ok: false,
             reason: turn === null
                 ? `Line ${String(number)} of the script is not a turn. Start every turn with a speaker's name and a colon (${names}), one turn per paragraph.`
-                : `Line ${String(number)} of the script is spoken by "${(turn[1] ?? "").trim()}", who is not one of the speakers (${names}). Use only these names, or add the speaker under Speakers (Play → Narration, or Edit project → Providers).`,
+                : `Line ${String(number)} of the script is spoken by "${(turn[1] ?? "").trim()}", who is not one of the speakers (${names}). Use only these names, or add the speaker under Speakers (${createRows.narration}, or ${editSettings.narration}).`,
         };
     }
     const spoken = [];

package/dist/slices/youtube/answer.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { jsonBetween } from "../../kernel/json-answer.js";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { alternativeTitles, descriptionMaxCharacters, hashtagsMax, minChapterSeconds, minChapters, pinnedCommentMaxCharacters, tagMaxCharacters, tagsMaxCharacters, titleMaxCharacters, } from "./model.js";
 import { parseTimestamp, youtubeTimestamp } from "./timestamps.js";
 import { keepsShape, titleShapeRule } from "./titles.js";
@@ -53,7 +54,7 @@ const answerSchema = z.object({
     pinnedComment: z.string(),
     titles: z.array(z.string()),
 });
-const fix = "Try again, or choose another model in Edit project → Providers.";
+const fix = `Try again, or choose another model in ${editSettings.writer}.`;
 // Reads and checks the model's answer. The reason is the sentence the stage shows; the
 // provider wrapper's `check` asks the model again while attempts remain.
 export function checkDescriptionAnswer(text, durationSeconds, 

package/dist/slices/youtube/edits-repo.js

@@ -59,7 +59,7 @@ export function readChannelLinksFor(db, channelId) {
 // the generated text, the chapters fitted to YouTube's rules (`chapters.ts`; the last one's
 // length only checked when the video's length is given), placeholders filled from the
 // project's and its channel's links (one with no link stays as typed). For anything that hands
-// the description on, such as Prepare upload and the downloads. `chapterNotice` says what the
+// the description on, such as Copy for YouTube Studio and the downloads. `chapterNotice` says what the
 // fitting changed.
 export function effectiveDescription(db, projectId, generated) {
     const edits = readDescriptionEdits(db, projectId);

package/dist/tutorials/AI-CLIs.md

@@ -2,7 +2,7 @@
 
 Slopify can write the text with the Claude Code, Codex or Antigravity command-line tools, and draw the images with Codex, using the sign-in you already have. You need no API key for those steps, and their calls count toward your plan's limits instead of costing per call.
 
-**Where to find it:** Settings → Providers → the **Text** list (Claude Code CLI, Codex CLI, Antigravity CLI) and the **Images** list (Codex CLI).
+**Where to find it:** Settings → Keys & services → the **Writing services** list (Claude Code CLI, Codex CLI, Antigravity CLI) and the **Image services** list (Codex CLI).
 
 ## What each tool does
 
@@ -15,7 +15,7 @@ Slopify can write the text with the Claude Code, Codex or Antigravity command-li
 
 Codex text and Codex images share one sign-in, one executable path and one plan allowance.
 
-Codex CLI must be version 0.149.1 or newer. An older Codex shows **Needs attention** and says to update it.
+Codex CLI must be version 0.149.1 or newer. An older Codex shows **Needs fixing** and says to update it.
 
 ## Set up a CLI
 
@@ -24,11 +24,11 @@ Codex CLI must be version 0.149.1 or newer. An older Codex shows **Needs attenti
    - Claude Code: `claude auth login`
    - Codex: `codex login`
    - Antigravity: run `agy` and sign in with your Google account (a browser opens; over SSH it shows a URL and a code).
-3. Open **Settings → Providers** (reload the page if it was already open).
-4. Pick the tool in the **Text** or **Images** list. Its row should say **Ready**, and its setup shows **Installed, version …** and the **Command** Slopify runs.
-5. Choose **Check all** to confirm it is signed in.
+3. Open **Settings → Keys & services** (reload the page if it was already open).
+4. Pick the tool in the **Writing services** or **Image services** list. Its row should say **Ready**, and its setup shows **Installed, version …** and the **Command** Slopify runs.
+5. Press **Check every service** to confirm it is signed in.
 
-On the very first launch, before any key is saved, Slopify looks for all three tools. If it finds any, it says so and picks one for text on new Play drafts, preferring Claude Code, then Codex, then Antigravity, and Codex for images when found. The CLIs can't speak, but the narration needs no key either: without a voice key, the [System voice](Providers-and-Keys#the-system-voice) reads it with your computer's own speech. See [First-Launch-and-Welcome](First-Launch-and-Welcome).
+On the very first launch, before any key is saved, Slopify looks for all three tools. If it finds any, it says so and picks one for text on new Create drafts, preferring Claude Code, then Codex, then Antigravity, and Codex for images when found. The CLIs can't speak, but the narration needs no key either: without a voice key, the [System voice](Providers-and-Keys#the-system-voice) reads it with your computer's own speech. See [First-Launch-and-Welcome](First-Launch-and-Welcome).
 
 ## Antigravity CLI: what is different
 
@@ -41,21 +41,21 @@ It works differently from the Gemini CLI in a few ways:
 - **No timeout of its own.** `agy` waits as long as the model needs; Slopify's own stall checks end a run that stops making progress.
 - **Busy messages are retried.** When several calls run at once, Google can answer that its capacity for the model is used for the moment. A reset of 5 minutes or less is retried by itself within seconds; a longer reset is handled as a plan limit and the run waits for it.
 - **Its sign-in is checked with `agy models`.** Slopify runs the command: if it lists models, the CLI is **Signed in**; if it says "Please sign in", the CLI is signed out and the check gives the command to run (`agy`); anything else shows as unknown. `GEMINI_API_KEY` is not read.
-- **Old model ids are gone.** Models come from `agy models`. A project that still names a Gemini CLI model such as `gemini-2.5-pro` stops with "The chosen model is not available…" until you pick a new one in **Edit project → Providers**. A saved path to a program still called `gemini` is refused: clear it or set the Antigravity CLI path in Settings → Providers.
+- **Old model ids are gone.** Models come from `agy models`. A project that still names a Gemini CLI model such as `gemini-2.5-pro` stops with "The chosen model is not available…" until you pick a new one under **Written by** in **Edit settings** → **Article**. A saved path to a program still called `gemini` is refused: clear it or set the Antigravity CLI path in Settings → Keys & services.
 
 ## Row states
 
 | State | Meaning |
 |---|---|
 | **Ready** | Found, new enough and not reporting a sign-in problem. |
-| **Needs attention** | Found, but something is wrong (for example an old Codex version). The detail says what. |
+| **Needs fixing** | Found, but something is wrong (for example an old Codex version). The detail says what. |
 | **Not found** | Not on PATH, or not at the saved path. |
 
 ## Set the executable path
 
 Slopify finds each tool on PATH, the list of folders your terminal searches. Set a path when the tool is installed somewhere else, or you have more than one copy.
 
-1. Pick the tool in **Settings → Providers**.
+1. Pick the tool in **Settings → Keys & services**.
 2. Choose **Change path**.
 3. In **Executable path**, type the absolute path to the program file, without quotes or arguments. Leave it blank to go back to finding it on PATH.
 4. Choose **Save path**. Slopify checks the tool answers before saving; a folder or a missing file is refused with the reason.
@@ -67,7 +67,7 @@ Slopify finds each tool on PATH, the list of folders your terminal searches. Set
 
 ## Check the sign-in
 
-**Check all** (Settings → Providers) asks each tool:
+**Check every service** (Settings → Keys & services) asks each tool:
 
 - **Installed**: found, with its version.
 - **Signed in**: Slopify asks each CLI directly. If one is signed out, the line tells you the command to run (`claude auth login`, `codex login` or `agy`). For Antigravity CLI it runs `agy models`: a model list means signed in, "Please sign in" means signed out (run `agy`), and anything else is shown as unknown.
@@ -79,20 +79,20 @@ If a run fails because a tool's sign-in expired, the project offers **Copy sign-
 
 ## Pick a model and thinking level
 
-A CLI's model list comes from the tool installed on your computer, not from the model catalogue. On Play:
+A CLI's model list comes from the tool installed on your computer, not from the model catalogue. On Create:
 
-1. Pick the tool as the text provider (or Codex CLI for images).
+1. Pick the tool as the **Service** under **Written by** (or Codex CLI under **Images by** for images).
 2. Pick a **Text model** from the list. The refresh button beside it (**Refresh models**) asks the tool for its current list; **Custom ID** lets you type a model the list does not show.
-3. If the model offers it, pick **Thinking** (text) or **Effort** (images). **Model default** leaves it to the tool. The levels come from the model: for example Low, Medium, High and Xhigh. Higher levels can write or draw more carefully, but take longer and use more of your plan.
+3. If the model offers it, pick **Thinking** (text) or **Effort** (images). **Model default** leaves it to the tool. The levels come from the model: for example Low, Medium, High and Extra high. Higher levels can write or draw more carefully, but take longer and use more of your plan.
 
-If a model is missing when a run reaches it, the run stops with "The chosen model is not available in the AI command-line tool on your computer." Update the tool, or pick another model in **Edit project** under Providers, then **Continue the run**. A thinking level the model does not support stops the same way.
+If a model is missing when a run reaches it, the run stops with "The chosen model is not available in the AI command-line tool on your computer." Update the tool, or pick another model in **Edit settings** (under **Written by**, or **Images by** for Codex images), then **Continue the run**. A thinking level the model does not support stops the same way.
 
 ## Codex images
 
 Codex draws each image as its own job.
 
 - **Codex default** runs with the tool's own defaults: no model and no effort on the command line.
-- Any other model is one of Codex's own models (the same list the Codex text provider shows), run with the **Effort** you pick. With a chosen model or effort, or a reference picture to match, the agent may look at its work and redraw it.
+- Any other model is one of Codex's own models (the same list Codex shows as a writing service), run with the **Effort** you pick. With a chosen model or effort, or a reference picture to match, the agent may look at its work and redraw it.
 - Each image may take several minutes; the time limit for one image is 30 minutes.
 - Up to 4 images are drawn at once.
 
@@ -106,16 +106,16 @@ The CLIs bill your subscription, which gives a share of a 5-hour and a weekly al
 - **Codex** is asked before and after each call. It reports whole percents, so a short run can show "under 1%".
 - **Antigravity** reports none.
 
-You see these on a project's **Run cost** tab, in the run's **Cost so far** panel, and on Home under **This week**. See [Costs-and-Run-Cost](Costs-and-Run-Cost).
+You see these in a project's cost breakdown (**See the breakdown** on its cost line) and on Home under **This week**. See [Costs-and-Run-Cost](Costs-and-Run-Cost).
 
 When a tool says its allowance is used up, the run does not fail:
 
 1. Slopify stores the reset time the tool gave (per tool, not per project).
 2. Every call to that tool, from any project, waits until 2 minutes after the reset. Without a stated time, it checks again every 30 minutes.
-3. The project's status reads **Waiting for limits**, with a line such as "Waiting for Codex limits (resets at 14:00)." The same words show on Home's Running now, the Projects row and the Calendar.
+3. The project's status reads **Waiting for limits**, with a line such as "Waiting for Codex limits (resets at 14:00)." The same words show on Home's Running, the Projects row and the Calendar.
 4. When the reset passes, the run continues by itself.
 
-Other providers are not held up: a project whose narration uses a key carries on while its Codex images wait. The wait survives a restart; a project that was waiting when Slopify stopped resumes on the next start and waits again. A project you paused or canceled meanwhile is left alone.
+Other services are not held up: a project whose narration uses a key carries on while its Codex images wait. The wait survives a restart; a project that was waiting when Slopify stopped resumes on the next start and waits again. A project you paused or canceled meanwhile is left alone.
 
 Antigravity's quota is handled the same way ("Slopify waits and tries again later by itself").
 
@@ -125,14 +125,14 @@ A container cannot use the CLIs installed on your computer directly. On Linux, t
 
 1. Install and sign in to the CLIs on your computer first.
 2. Run the Docker installer (`npx @gentbajko/slopify@latest --docker`). If a CLI is found, it asks once whether to set up the helper. `--accept-host-cli` approves without asking; `--host-cli=off` skips it.
-3. In Settings → Providers the tools show **Managed on host**. Their path cannot be changed there.
+3. In Settings → Keys & services the tools show **Managed on host**. Their path cannot be changed there.
 
 What to know:
 
 - The helper runs as you, as the user service `slopify-cli-bridge.service`, and talks to the container over a private socket. No network port is opened and no sign-in is copied into Docker.
 - After you install, update or remove a CLI, run the Docker installer again so Slopify sees the change.
 - Run cost and plan-limit shares work the same as without Docker. An older helper may not pass them through, and the cost page then says the share is not known.
-- With the helper off, Settings shows the CLIs as unavailable. API-key providers still work.
+- With the helper off, Settings shows the CLIs as unavailable. Services with an API key still work.
 
 Check or turn off the helper:
 
@@ -141,17 +141,17 @@ systemctl --user status slopify-cli-bridge.service
 systemctl --user disable --now slopify-cli-bridge.service
 ```
 
-Turning it off leaves Docker, your API providers, your data and your host sign-ins as they are. See [Docker](Docker).
+Turning it off leaves Docker, your keyed services, your data and your host sign-ins as they are. See [Docker](Docker).
 
 ## Tips
 
-- A CLI step on Play's estimate reads "$0 on your plan · ~$X via API": what the same tokens would cost with a key.
-- If your plan runs out often, split the work: keep text on a CLI and put images on a keyed provider, or the other way round.
-- Use **Check all** after updating a CLI; a newer tool can drop a model your template still names.
+- A CLI step on Create's estimate reads "$0 on your plan · ~$X via API": what the same tokens would cost with a key.
+- If your plan runs out often, split the work: keep the writing on a CLI and put images on a keyed service, or the other way round.
+- Use **Check every service** after updating a CLI; a newer tool can drop a model your template still names.
 
 ## Related pages
 
-- [Providers-and-Keys](Providers-and-Keys)
+- [Keys and Services](Providers-and-Keys)
 - [Models](Models)
 - [Costs-and-Run-Cost](Costs-and-Run-Cost)
 - [Docker](Docker)