@gentbajko/slopify 3.25.9 → 4.1.0

package/dist/slices/designs/templates.js

@@ -0,0 +1,218 @@
+import { z } from "zod";
+import { transact } from "../../kernel/db/tx.js";
+import { defaultChannelId } from "../channels/model.js";
+import { designDocumentSchema } from "./schema.js";
+import { mutationHash, reusedMessage } from "./service.js";
+import { documentChecks } from "./template-checks.js";
+// Design templates: a designed piece saved with fields to make again by hand or from a
+// schedule. Every Save is a new version; a version is marked ready only when its checks pass,
+// and only a ready version is what a schedule makes (`runnableDesignVersion`).
+const id = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[A-Za-z0-9_-]+$/);
+const name = z.string().trim().min(1).max(200);
+export const createTemplateSchema = z
+    .object({
+    id,
+    mutationId: z.string().min(8).max(128),
+    name,
+    document: designDocumentSchema,
+    channelId: id.optional(),
+})
+    .strict();
+export const saveTemplateSchema = z
+    .object({
+    baseVersion: z.number().int().min(1),
+    name,
+    document: designDocumentSchema,
+    // Whether this Save redraws the editor's sample (`sample.ts`); "skip" saves only.
+    sample: z.enum(["make", "skip"]).optional(),
+    acknowledgedHigh: z.number().min(0).max(1000).optional(),
+})
+    .strict();
+export const markReadySchema = z.object({ version: z.number().int().min(1) }).strict();
+const revisionRow = z.object({
+    version: z.number(),
+    name: z.string(),
+    document_json: z.string(),
+    gate: z.enum(["unchecked", "ready"]),
+    checks_json: z.string().nullable(),
+    marked_at: z.string().nullable(),
+    created_at: z.string(),
+});
+const checksSchema = z
+    .array(z.object({
+    id: z.string(),
+    ok: z.boolean(),
+    sentence: z.string(),
+    fix: z.object({ label: z.string(), href: z.string() }).nullable(),
+}))
+    .catch([]);
+export function templateRevision(db, templateId, version) {
+    const raw = db
+        .prepare("SELECT * FROM design_template_revisions WHERE template_id=? AND version=?")
+        .get(templateId, version);
+    if (raw === undefined)
+        return undefined;
+    const row = revisionRow.parse(raw);
+    return {
+        version: row.version,
+        name: row.name,
+        gate: row.gate,
+        markedAt: row.marked_at,
+        createdAt: row.created_at,
+        document: designDocumentSchema.parse(JSON.parse(row.document_json)),
+    };
+}
+export function getTemplate(db, templateId) {
+    const head = db
+        .prepare("SELECT id, channel_id, head_version, created_at FROM design_templates WHERE id=? AND deleted_at IS NULL")
+        .get(templateId);
+    if (head === undefined)
+        return undefined;
+    const revisions = db
+        .prepare("SELECT * FROM design_template_revisions WHERE template_id=? ORDER BY version")
+        .all(templateId)
+        .map((raw) => revisionRow.parse(raw));
+    const current = revisions.find((row) => row.version === head.head_version);
+    if (current === undefined)
+        return undefined;
+    const ready = revisions.filter((row) => row.gate === "ready").at(-1);
+    return {
+        id: String(head.id),
+        channelId: head.channel_id === null ? defaultChannelId : String(head.channel_id),
+        headVersion: current.version,
+        name: current.name,
+        document: designDocumentSchema.parse(JSON.parse(current.document_json)),
+        gate: current.gate,
+        checks: current.checks_json === null ? [] : checksSchema.parse(JSON.parse(current.checks_json)),
+        readyVersion: ready?.version ?? null,
+        versions: revisions.map((row) => ({
+            version: row.version,
+            name: row.name,
+            gate: row.gate,
+            markedAt: row.marked_at,
+            createdAt: row.created_at,
+        })),
+        createdAt: String(head.created_at),
+        updatedAt: current.created_at,
+    };
+}
+export function listTemplates(db) {
+    return db
+        .prepare("SELECT id FROM design_templates WHERE deleted_at IS NULL ORDER BY created_at DESC, id")
+        .all()
+        .flatMap((row) => getTemplate(db, String(row.id)) ?? []);
+}
+const notFound = {
+    ok: false,
+    reason: "not-found",
+    message: "This design template no longer exists. Open Templates → Poster templates to choose another.",
+};
+function invalid(error) {
+    return {
+        ok: false,
+        reason: "invalid",
+        message: `The template can't be saved: ${error.issues[0]?.message ?? "a field is missing"}.`,
+    };
+}
+export function createTemplate(deps, raw) {
+    const parsed = createTemplateSchema.safeParse(raw);
+    if (!parsed.success)
+        return invalid(parsed.error);
+    const { mutationId, ...input } = parsed.data;
+    const hash = mutationHash(input);
+    const replay = deps.db
+        .prepare("SELECT id, mutation_hash FROM design_templates WHERE mutation_id=?")
+        .get(mutationId);
+    if (replay !== undefined) {
+        if (replay.mutation_hash !== hash)
+            return { ok: false, reason: "mutation-reused", message: reusedMessage };
+        const template = getTemplate(deps.db, String(replay.id));
+        return template === undefined ? notFound : { ok: true, value: template };
+    }
+    if (deps.db.prepare("SELECT 1 FROM design_templates WHERE id=?").get(input.id) !== undefined)
+        return { ok: false, reason: "mutation-reused", message: reusedMessage };
+    const at = deps.clock.now().toISOString();
+    transact(deps.db, () => {
+        deps.db
+            .prepare("INSERT INTO design_templates (id,channel_id,head_version,created_at,mutation_id,mutation_hash) VALUES (?,?,1,?,?,?)")
+            .run(input.id, input.channelId ?? null, at, mutationId, hash);
+        deps.db
+            .prepare("INSERT INTO design_template_revisions (template_id,version,name,document_json,created_at) VALUES (?,1,?,?,?)")
+            .run(input.id, input.name, JSON.stringify(input.document), at);
+    });
+    const template = getTemplate(deps.db, input.id);
+    return template === undefined ? notFound : { ok: true, value: template };
+}
+// A Save on the version it was made on becomes the next version; one made on an older version
+// is refused with the current template. Saving exactly what the head already holds is a no-op.
+export function saveTemplate(deps, templateId, raw) {
+    const parsed = saveTemplateSchema.safeParse(raw);
+    if (!parsed.success)
+        return invalid(parsed.error);
+    const current = getTemplate(deps.db, templateId);
+    if (current === undefined)
+        return notFound;
+    const input = parsed.data;
+    const same = input.name === current.name &&
+        JSON.stringify(input.document) === JSON.stringify(current.document);
+    if (same)
+        return { ok: true, value: { template: current, saved: false, before: current.document } };
+    if (input.baseVersion !== current.headVersion)
+        return {
+            ok: false,
+            reason: "changed",
+            message: "This template was saved in another tab or by an agent. Reload it to see that version, then make your change again.",
+            current,
+        };
+    const version = current.headVersion + 1;
+    transact(deps.db, () => {
+        deps.db
+            .prepare("INSERT INTO design_template_revisions (template_id,version,name,document_json,created_at) VALUES (?,?,?,?,?)")
+            .run(templateId, version, input.name, JSON.stringify(input.document), deps.clock.now().toISOString());
+        deps.db
+            .prepare("UPDATE design_templates SET head_version=? WHERE id=?")
+            .run(version, templateId);
+    });
+    const template = getTemplate(deps.db, templateId);
+    return template === undefined
+        ? notFound
+        : { ok: true, value: { template, saved: true, before: current.document } };
+}
+// Mark ready: the version's checks are run and kept; it is marked only when every one passes,
+// and otherwise refused with the list.
+export async function markTemplateReady(deps, templateId, raw, more = async () => []) {
+    const parsed = markReadySchema.safeParse(raw);
+    if (!parsed.success)
+        return { ok: false, reason: "invalid", message: "Say which version to approve for schedules." };
+    if (getTemplate(deps.db, templateId) === undefined)
+        return notFound;
+    const revision = templateRevision(deps.db, templateId, parsed.data.version);
+    if (revision === undefined)
+        return {
+            ok: false,
+            reason: "not-found",
+            message: "That version of the template doesn't exist. Reload the template.",
+        };
+    const checks = [
+        ...documentChecks(revision.document, templateId),
+        ...(await more(revision.document, parsed.data.version)),
+    ];
+    const passed = checks.every((check) => check.ok);
+    deps.db
+        .prepare("UPDATE design_template_revisions SET checks_json=?, gate=?, marked_at=? WHERE template_id=? AND version=?")
+        .run(JSON.stringify(checks), passed ? "ready" : revision.gate, passed ? deps.clock.now().toISOString() : revision.markedAt, templateId, parsed.data.version);
+    const failed = checks.filter((check) => !check.ok);
+    if (failed.length > 0)
+        return {
+            ok: false,
+            reason: "not-ready",
+            message: `Version ${String(parsed.data.version)} can't be approved for schedules yet: ${failed.map((check) => check.sentence).join(" ")}`,
+            current: failed,
+        };
+    const template = getTemplate(deps.db, templateId);
+    return template === undefined ? notFound : { ok: true, value: template };
+}

package/dist/slices/document/fonts.js

@@ -1,4 +1,5 @@
 import { readFileSync } from "node:fs";
+import { errorText } from "../../kernel/errors.js";
 // The bundled Cinzel weights and Literata styles (SIL OFL 1.1, assets/document/fonts) and the
 // page texture. Read on every render rather than kept in memory: eight fonts and one image
 // are about a megabyte and a half, and a document is made once per article.
@@ -32,7 +33,7 @@ export function readDocumentAssets() {
         };
     }
     catch (error) {
-        throw new Error(`Slopify couldn't read the fonts and page texture it makes documents with (${error instanceof Error ? error.message : String(error)}). Its installation is incomplete: reinstall or update Slopify, then use Try again on Document.`, { cause: error });
+        throw new Error(`Slopify couldn't read the fonts and page texture it makes documents with (${errorText(error)}). Its installation is incomplete: reinstall or update Slopify, then use Try again on PDF.`, { cause: error });
     }
 }
 export function registerFonts(doc, fonts) {

package/dist/slices/document/model.js

@@ -1,6 +1,7 @@
-// The built-in looks a project's PDF can be given. Browser-safe: Play, Edit project and the
-// server all offer the same names from here.
-export const documentThemes = ["plain"];
+// The ready looks a project's PDF can be given, so a PDF looks right without a theme of one's
+// own: Plain, Book (book type on parchment) and Modern (a sans-serif on white). Browser-safe:
+// Create, Edit template, Edit settings and the server all offer the same names from here.
+export const documentThemes = ["plain", "book", "modern"];
 // DiceMaster was built in before 2.3.0 and is one brand's look, not Slopify's. A project
 // saved with it keeps it (see legacy-dicemaster.ts), so the name is still read everywhere a
 // config is parsed, but it is never offered.
@@ -11,6 +12,8 @@ export const documentThemeNames = [...documentThemes, legacyDocumentTheme];
 export const defaultDocumentTheme = "plain";
 export const documentThemeLabels = {
     plain: "Plain",
+    book: "Book",
+    modern: "Modern",
     dicemaster: "DiceMaster",
 };
 // The built-in a saved project config is drawn with. A project saved before the Document stage
@@ -34,7 +37,7 @@ export const documentThemeNameMax = 80;
 export function documentThemeNameProblems(name) {
     const trimmed = name.trim();
     if (trimmed === "")
-        return [{ field: "name", message: "Give the theme a name." }];
+        return [{ field: "name", message: "Give the look a name." }];
     if (trimmed.length > documentThemeNameMax)
         return [
             {

package/dist/slices/document/render.js

@@ -1,4 +1,5 @@
 import { jsPDF } from "jspdf";
+import { editSettings } from "../../kernel/ports/settings-places.js";
 import { runsText } from "./blocks.js";
 import { drawLine, wrapRuns } from "./flow.js";
 import { faceWidth, registerFonts, useFace } from "./fonts.js";
@@ -10,7 +11,7 @@ export function renderDocument(input) {
     const text = documentText(input.articleMarkdown, input.researchNotes);
     const blocks = withoutTitle(text.blocks, input.title);
     if (blocks.length === 0)
-        throw new Error("The article has no text to put in the document. Write or regenerate the article (Edit project → Article), then use Try again on Document.");
+        throw new Error(`The article has no text to put in the PDF. Write it in ${editSettings.article}, or press Write the article again in the project's Article section, then use Try again on PDF.`);
     const words = blocks
         .map((block) => block.kind === "heading" ? block.text : "runs" in block ? runsText(block.runs) : "")
         .join(" ")

package/dist/slices/document/theme-schema.js

@@ -8,7 +8,7 @@ const mm = (min, max) => {
     const range = { error: `Use a value from ${String(min)} to ${String(max)}.` };
     return z.number({ error: "Enter a number." }).finite(range).min(min, range).max(max, range);
 };
-const color = z.string().regex(/^#?([0-9a-f]{3}|[0-9a-f]{6})$/i, "Use a colour like #8c1e14.");
+const color = z.string().regex(/^#?([0-9a-f]{3}|[0-9a-f]{6})$/i, "Use a color like #8c1e14.");
 const line = z.string().max(300, { error: "Keep this under 300 characters." });
 const nullableLine = line.nullable();
 const url = z.string().max(500, { error: "Keep this under 500 characters." }).nullable();

package/dist/slices/document/theme.js

@@ -9,8 +9,11 @@ const cinzel = (style, letterSpacing) => ({
     style,
     letterSpacing,
 });
-// The one built-in: an unbranded flat page. Its layout is the one Slopify has always drawn,
-// written out in full rather than as changes to another theme.
+const literata = (style) => ({ family: "Literata", style, letterSpacing: 0 });
+const sans = (style) => ({ family: "helvetica", style, letterSpacing: 0 });
+// The first built-in, and the default: an unbranded flat page. Its layout is the one Slopify
+// has always drawn, written out in full rather than as changes to another theme. The other
+// built-ins are changes to it.
 const plain = {
     page: { format: "a4", margin: 22, contentTop: 32 },
     background: { image: null, color: "#fdfaf3" },
@@ -91,10 +94,53 @@ const plain = {
         closing: null,
     },
 };
+// Book: the article set like a novel, in Literata on the parchment texture, with Plain's Cinzel
+// headings and drop caps in a warm brown.
+const book = {
+    background: { image: "parchment", color: "#f5ebd7" },
+    colors: { heading: "#5a3214", text: "#231a12", muted: "#5e5246", faint: "#857767" },
+    fonts: {
+        body: literata("normal"),
+        strong: literata("bold"),
+        emphasis: literata("italic"),
+        footer: literata("italic"),
+    },
+    sizes: { body: 11 },
+    spacing: { bodyLine: 6.5, paragraphGap: 0.6 },
+    // A paragraph of a line or two starts plainly: a three-line initial beside it looks lost.
+    dropCap: { minLength: 120 },
+};
+// Modern: a sans-serif on a white page, blue headings and no drop caps, like a report.
+const modern = {
+    background: { image: null, color: "#ffffff" },
+    colors: { heading: "#1d4e89", text: "#1c1c1c", muted: "#5a5a5a", faint: "#8a8a8a" },
+    fonts: {
+        body: sans("normal"),
+        strong: sans("bold"),
+        emphasis: sans("italic"),
+        heading: sans("bold"),
+        dramatic: sans("bold"),
+        decorative: sans("normal"),
+        dropCap: sans("bold"),
+        footer: sans("normal"),
+    },
+    sizes: { brand: 28, title: 24, section: 18, heading: 15, subheading: 12, body: 10.5 },
+    spacing: { bodyLine: 6, headingLine: 9, subheadingLine: 7, paragraphGap: 0.7 },
+    dropCap: { enabled: false },
+};
 // A built-in by name. "dicemaster" is still read, from projects saved while it was built in,
 // and gives exactly the values it gave then.
 export function builtInTheme(name) {
-    return resolveTheme({}, name === legacyDocumentTheme ? legacyDiceMasterTheme : plain);
+    switch (name) {
+        case "book":
+            return resolveTheme(book, plain);
+        case "modern":
+            return resolveTheme(modern, plain);
+        case legacyDocumentTheme:
+            return resolveTheme({}, legacyDiceMasterTheme);
+        default:
+            return resolveTheme({}, plain);
+    }
 }
 // The theme a project's document is drawn with: its copy of a Library theme, or a built-in.
 export function resolvedDocumentTheme(settings) {

package/dist/slices/episodes/summarize.js

@@ -1,11 +1,13 @@
 import { createHash } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
+import { errorText } from "../../kernel/errors.js";
 import { projectById } from "../admission/repo.js";
 import { castMentions } from "../channels/cast-match.js";
 import { castOfChannel, projectChannelId } from "../channels/repo.js";
 import { reviewedByAgent } from "../reviews/model.js";
 import { outputPath } from "../storage/layout.js";
 import { outputsOf } from "../storage/repo.js";
+import { isTemplateSample } from "../template-studio/repo.js";
 import { episodeMemoryOn, memoryOfProject, saveGeneratedMemory } from "./repo.js";
 // When a project finishes, a small LLM call writes what the episode covered (at most
 // `summaryWordsMax` words) for its channel's episode memory. It never fails the project: every
@@ -51,7 +53,7 @@ export async function summarizeEpisode(deps, projectId, signal) {
             return "failed";
         deps.log.write("warn", "episode.memory", {
             projectId,
-            detail: `The episode summary wasn't saved: ${error instanceof Error ? error.message : String(error)}. The project is unaffected; only later episodes won't be reminded of this one. Check the project's text model in Settings → Providers.`,
+            detail: `The episode summary wasn't saved: ${errorText(error)}. The project is unaffected; only later episodes won't be reminded of this one. Check the service it writes with in Settings → Keys & services.`,
         });
         return "failed";
     }
@@ -60,6 +62,8 @@ async function summarize(deps, projectId, signal) {
     const project = projectById(deps.db, projectId);
     if (project === undefined)
         return "gone";
+    if (isTemplateSample(deps.db, projectId))
+        return "sample";
     const channelId = projectChannelId(deps.db, projectId);
     if (!episodeMemoryOn(deps.db, channelId))
         return "off";
@@ -78,7 +82,7 @@ async function summarize(deps, projectId, signal) {
     if (choice === undefined) {
         deps.log.write("info", "episode.memory", {
             projectId,
-            detail: "No episode summary: this project has no text model chosen, so later episodes won't be reminded of it.",
+            detail: "No episode summary: this project has no AI model chosen, so later episodes won't be reminded of it.",
         });
         return "no-llm";
     }

package/dist/slices/estimate/index.js

@@ -3,7 +3,10 @@ import { sourceOf, thumbnailCountOf } from "../admission/model.js";
 import { imageSecondsProblem, usesDescribedNarration, usesNarrationPreparation, usesReference, usesShorts, usesYoutubeDescription, } from "../admission/rules.js";
 import { plainText } from "../article/plain.js";
 import { splitEndMatter } from "../article/split.js";
+import { usesAppearance } from "../images/appearance.js";
 import { narrationMinutes, plannedImageCount, scalesImages } from "../images/scale.js";
+import { usesSlopifyScene } from "../images/scenes.js";
+import { keywordUsesOf, placeOfKey } from "../keywords/rules.js";
 import { describedBlocks, narrationBlocks } from "../narration/blocks.js";
 import { chunkNarration, defaultChunking } from "../narration/chunk.js";
 import { describeMessages } from "../narration/describe.js";
@@ -13,12 +16,15 @@ import { defaultReviewPrompts, reviewedByAgent, reviewPromptKey, reviewRetriesOf
 import { activeReviewStages } from "../reviews/rules.js";
 import { isLocalCliProvider } from "../settings/model.js";
 import { defaultShortsImagePrompt, defaultShortsPrompt, shortsImageUpperBound, shortsSettingsProblems, } from "../shorts/model.js";
+import { socialPlatforms } from "../social/model.js";
+import { defaultPostPrompt } from "../social/post-prompt.js";
 import { animatedClipSeconds, animatedImageIndexes, usesAnimation, videoEditProblems, } from "../video/edit-settings.js";
-import { usesVoices } from "../voices/model.js";
+import { usesScriptPrompt, usesVoices } from "../voices/model.js";
 import { defaultDescriptionPrompt } from "../youtube/model.js";
 // ceiling: the most chapters "Chapter openers" is charged for before the article exists, the
 // top of the 5-12 chapters the built-in YouTube description prompt asks for.
 const chapterOpenersMax = 12;
+import { sampleSpokenWords } from "../template-studio/scope.js";
 import { estimateRequests, groupEstimateRows } from "./requests.js";
 export { estimateRequests } from "./requests.js";
 export function estimateRun(draft, rendered, expectedWords, catalogue) {
@@ -36,14 +42,13 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
     const tts = draft.audio ?? { provider: "", model: "" };
     const image = draft.images ?? { provider: "", model: "" };
     const textNote = isLocalCliProvider(llm.provider)
-        ? "Runs on your CLI plan, so it adds no charge; the API figure is what the same tokens would cost through the API."
+        ? "Runs on your subscription at no extra charge; the API figure is what the same work would cost through the API."
         : (data.llm.find((model) => model.provider === llm.provider &&
             model.id === llm.model &&
             model.enabled &&
-            !model.deprecated)?.pricing.note ??
-            "CLI subscription or model pricing is unavailable; usage may be billed by your account.");
+            !model.deprecated)?.pricing.note ?? "No price is listed for this model; your account may be billed for it.");
     const imageNote = isLocalCliProvider(image.provider)
-        ? "Runs on your Codex plan, so it adds no charge; no API price is given for agent-drawn images."
+        ? "Runs on your Codex subscription at no extra charge."
         : (data.image.find((model) => model.provider === image.provider &&
             model.id === image.model &&
             model.enabled &&
@@ -55,7 +60,8 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
             key === "description" ||
             key === "shorts" ||
             key === "shortsImage" ||
-            key.startsWith("review.")
+            key.startsWith("review.") ||
+            key.startsWith("social.")
             ? 0
             : value.length), 0);
     const local = (stage, detail) => {
@@ -91,15 +97,18 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
                 code: draft.audio?.skipCode === true ? "skip" : "describe",
                 language: draft.language,
             }));
-        if (blocks === undefined)
+        // On a subscription the count does not change the price.
+        if (blocks === undefined && isLocalCliProvider(llm.provider))
+            local("Describing tables and figures", "One AI call per table, figure, equation or code block in the article, on your subscription at no extra charge.");
+        else if (blocks === undefined)
             requests.push({
                 kind: "unknown",
-                stage: "Narration descriptions",
-                detail: "One LLM call per table, figure, equation or code block in the article; how many is known once the article is written.",
+                stage: "Describing tables and figures",
+                detail: "One AI call per table, figure, equation or code block in the article; how many is known once the article is written.",
             });
         else
             for (const block of blocks)
-                text("Narration descriptions", describeMessages(block, rendered.narration ?? "", draft.language).reduce((n, message) => n + message.content.length, 0), 600, `${String(blocks.length)} LLM ${blocks.length === 1 ? "call" : "calls"}: one per table, figure, equation or code block.`);
+                text("Describing tables and figures", describeMessages(block, rendered.narration ?? "", draft.language).reduce((n, message) => n + message.content.length, 0), 600, `${String(blocks.length)} AI ${blocks.length === 1 ? "call" : "calls"}: one per table, figure, equation or code block.`);
     }
     if (draft.sources.audio === "generate") {
         if (usesNarrationPreparation(draft)) {
@@ -115,18 +124,20 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
             if (unknown)
                 requests.push({
                     kind: "unknown",
-                    stage: "Narration Preparation",
-                    detail: "One LLM call per future logical narration chunk and enabled entry; generated source length is not yet known.",
+                    stage: "Narration preparation",
+                    detail: "One AI call per narration piece and per intro or outro written for it; how many is known once the text is written.",
                 });
             else
                 for (const source of known)
-                    text("Narration Preparation", preparationMessages(rendered.narration ?? "", source, [], draft.language).reduce((n, message) => n + message.content.length, 0), 2400, `${known.length} LLM calls: one per logical narration chunk or entry.`);
+                    text("Narration preparation", preparationMessages(rendered.narration ?? "", source, [], draft.language).reduce((n, message) => n + message.content.length, 0), 2400, `${known.length} AI calls: one per narration piece or intro or outro.`);
             requests.push({
                 kind: "unknown",
-                stage: "Delivery cue overhead",
-                detail: "TTS character charges include delivery tags; their length is known after preparation.",
+                stage: "Delivery cues",
+                detail: "The voice service charges per character, delivery tags included; their length is known after preparation.",
             });
         }
+        // A template studio sample says only the narration's opening (`template-studio/scope.ts`).
+        const spokenChars = draft.sample === undefined ? articleChars : Math.min(articleChars, sampleSpokenWords * 6);
         const extras = ["intro", "outro"].reduce((n, key) => n + (rendered[key]?.length ?? 0), 0);
         const llmExtras = (draft.intro?.mode === "llm" ? 1200 : 0) + (draft.outro?.mode === "llm" ? 1200 : 0);
         const choice = { stage: "Narration", provider: tts.provider, model: tts.model };
@@ -140,19 +151,19 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
                     stage: "Narration",
                     provider: speaker.voice.provider,
                     model: speaker.voice.model,
-                    characters: Math.round(articleChars / speakers.length),
+                    characters: Math.round(spokenChars / speakers.length),
                     detail: `${speaker.name.trim() || "A speaker"}: assumes every speaker says about the same.`,
                 });
             if (extras + llmExtras > 0)
                 requests.push({ ...choice, kind: "tts-estimate", characters: extras + llmExtras });
             if (draft.voices?.source === "attribute")
-                text("Speaker split", articleChars + 1500, Math.round(articleChars * 1.1), "One LLM call hands the text's passages to the speakers.");
+                text("Speaker split", articleChars + 1500, Math.round(articleChars * 1.1), "One AI call hands the text's passages to the speakers.");
             if (draft.voices?.source === "adapt")
-                text("Conversation script", articleChars + 1500, Math.round(articleChars * 1.2), "One LLM call rewrites the text as a conversation between the speakers; the article stays as written.");
+                text("Conversation script", articleChars + 1500, Math.round(articleChars * 1.2), "One AI call rewrites the text as a conversation between the speakers; the article stays as written.");
         }
         else
             requests.push(generatedArticle || llmExtras > 0
-                ? { ...choice, kind: "tts-estimate", characters: articleChars + extras + llmExtras }
+                ? { ...choice, kind: "tts-estimate", characters: spokenChars + extras + llmExtras }
                 : {
                     ...choice,
                     kind: "tts",
@@ -178,9 +189,29 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
         });
     if (images === 0)
         local("Images", "Provided or off.");
-    // Scenes from the article: one call reads the article and writes every image's scene.
-    if (images > 0 && draft.imageScenes === true)
+    // Scenes from the article: one call reads the article and writes every image's scene. A
+    // `Slopify_` scene keyword turns it on for the pictures that use it, switch or no switch.
+    const pictureKeys = Object.keys(rendered).filter((key) => /^imagePrompts\.\d+$/.test(key));
+    if (images > 0 &&
+        (draft.imageScenes === true || pictureKeys.some((key) => usesSlopifyScene(rendered[key]))))
         text("Image scenes", articleChars + 1500, 120 * images);
+    if (draft.sources.thumbnail === "from_prompt" && usesSlopifyScene(rendered.thumbnailPrompt))
+        text("Thumbnail scenes", articleChars + 1500, 120 * thumbnailCountOf(draft));
+    // The keyword digest: one call reads the article and writes every digest keyword.
+    const placed = Object.entries(rendered).flatMap(([key, body]) => {
+        const place = placeOfKey(key, { script: usesScriptPrompt(draft) });
+        return place === undefined ? [] : [{ field: key, place, body }];
+    });
+    if (keywordUsesOf(placed).digest !== undefined)
+        text("Keyword digest", articleChars + 1500, 600, "One call reads the article and writes every digest keyword the run uses.");
+    // `{{Appearance}}` (or `{{Slopify_Appearance}}`): one call with web search looks up the looks.
+    if ([
+        ...(images > 0 ? pictureKeys : []),
+        ...(draft.sources.thumbnail === "from_prompt" ? ["thumbnailPrompt"] : []),
+        "referencePrompt",
+        "shortsImage",
+    ].some((key) => usesAppearance(rendered[key])))
+        text("Appearance lookup", articleChars + 1500, 1500, "One call with web search looks up how the subject and characters look.");
     // The establishing image is one more image when it is made from a prompt.
     if (usesReference(draft) && draft.reference?.source === "prompt")
         requests.push({
@@ -201,7 +232,11 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
         local("Thumbnail", "Provided or off.");
     if (draft.sources.thumbnail === "prompt_by_llm")
         text("Thumbnail prompt", promptChars + articleChars, 1200);
-    local("Export / subtitles", "Local processing; no API fee.");
+    // Putting it together on this computer: the video (with its captions), or the sound alone.
+    if (draft.sources.video === "generate")
+        local("Video", "Made on this computer; no API fee.");
+    else if (draft.sources.audio !== "off")
+        local("Audio export", "Made on this computer; no API fee.");
     // The timed transcript is the narration with a time before every passage of about 20 s,
     // plus the fixed rules of the answer.
     if (usesYoutubeDescription(draft))
@@ -209,7 +244,14 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
             ? rendered.description.length
             : defaultDescriptionPrompt.length) +
             Math.round(articleChars * 1.05) +
-            1500, 2400, "One LLM call on the timed transcript.");
+            1500, 2400, "One AI call on the timed transcript.");
+    // Each site whose post is written by a post prompt: one call that reads the article.
+    for (const platform of socialPlatforms) {
+        if (draft.social?.[platform]?.text !== "prompt")
+            continue;
+        const own = rendered[`social.${platform}`]?.trim() ?? "";
+        text("Posts", (own === "" ? defaultPostPrompt.length : own.length) + articleChars + 400, 600, "One AI call per site whose post a post prompt writes, reading the article.");
+    }
     // Shorts: one call picks the clips from the numbered transcript, one per clip writes its
     // image prompts, and the images are charged at the most the step can ask for, every clip
     // at the longest length allowed.
@@ -221,12 +263,12 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
         imageSecondsProblem(draft.imageSeconds) === undefined) {
         text("Shorts", (rendered.shorts?.trim() ? rendered.shorts.length : defaultShortsPrompt.length) +
             Math.round(articleChars * 1.15) +
-            1500, 400 * shorts.count, "One LLM call on the numbered transcript picks the clips.");
+            1500, 400 * shorts.count, "One AI call on the numbered transcript picks the clips.");
         const style = rendered.shortsImage?.trim()
             ? rendered.shortsImage.length
             : defaultShortsImagePrompt.length;
         for (let clip = 0; clip < shorts.count; clip++)
-            text("Shorts", style + 3000, 2400, "One LLM call per short writes its image prompts.");
+            text("Shorts", style + 3000, 2400, "One AI call per short writes its image prompts.");
         const count = shortsImageUpperBound(shorts, draft.imageSeconds);
         for (let index = 0; index < count; index++)
             requests.push({
@@ -262,7 +304,7 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
     const reviews = draft.reviews;
     if (reviews !== undefined && reviewedByAgent(reviews)) {
         if (activeReviewStages(draft).length > 0)
-            local("Reviews", "An external agent answers each review through MCP; no API fee.");
+            local("Reviews", "Your own AI agent answers each check; no API fee.");
     }
     else if (reviews !== undefined)
         for (const stage of activeReviewStages(draft)) {
@@ -273,7 +315,9 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
                 ? articleChars + promptChars
                 : stage === "narration"
                     ? Math.round(articleChars * 2.1)
-                    : 1500;
+                    : stage === "promise"
+                        ? articleChars + 1500
+                        : 1500;
             for (let index = 0; index < items; index++)
                 requests.push({
                     kind: "llm",
@@ -286,7 +330,7 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
                 });
         }
     if (sourceOf(draft.sources, "document") === "generate")
-        local("Document", "Laid out locally from the article; no API fee.");
+        local("PDF", "Laid out on this computer from the article; no API fee.");
     return {
         ...groupEstimateRows(estimateRequests(requests, data)),
         expectedWords,