@gentbajko/slopify 1.2.0 → 1.3.1

package/dist/edge/cli.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
 import { parseArgs } from "node:util";
 import { configFrom } from "../kernel/config/index.js";
 import { readVersion } from "../kernel/version.js";
@@ -12,9 +14,24 @@ const { values } = parseArgs({
         host: { type: "string" },
         "data-dir": { type: "string" },
         "no-open": { type: "boolean" },
+        docker: { type: "boolean" },
     },
 });
 try {
+    if (values.docker) {
+        if (values.host !== undefined || values["data-dir"] !== undefined)
+            throw new Error("Docker stores data in the slopify-data volume and binds to localhost. Use --port to change its port.");
+        const result = spawnSync("bash", [fileURLToPath(new URL("../../scripts/docker-run.sh", import.meta.url))], {
+            stdio: "inherit",
+            env: {
+                ...process.env,
+                ...(values.port === undefined ? {} : { SLOPIFY_DOCKER_HOST_PORT: values.port }),
+            },
+        });
+        if (result.error)
+            throw result.error;
+        process.exit(result.status ?? 1);
+    }
     const config = configFrom(values, process.env);
     const forwarded = await forwardManagedUpdate(config.dataDir, readVersion(), process.argv.slice(2));
     if (forwarded !== undefined)

package/dist/kernel/db/migrations/0011-narration-prompts.sql

@@ -0,0 +1,13 @@
+CREATE TABLE prompts_narration_upgrade (
+  id TEXT PRIMARY KEY,
+  kind TEXT NOT NULL CHECK (kind IN ('article','image','thumbnail','narration')),
+  name TEXT NOT NULL,
+  body TEXT NOT NULL,
+  slots TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+INSERT INTO prompts_narration_upgrade (id,kind,name,body,slots,updated_at)
+  SELECT id,kind,name,body,slots,updated_at FROM prompts;
+DROP TABLE prompts;
+ALTER TABLE prompts_narration_upgrade RENAME TO prompts;
+CREATE UNIQUE INDEX prompts_name ON prompts(kind,lower(name));

package/dist/slices/admission/rules.js

@@ -42,7 +42,8 @@ export function admit(input) {
         sources.article === "generate" ||
         sources.thumbnail === "prompt_by_llm" ||
         draft.intro?.mode === "llm" ||
-        draft.outro?.mode === "llm";
+        draft.outro?.mode === "llm" ||
+        usesNarrationPreparation(draft);
     if (needsLlm && !chosen(draft.llm)) {
         fields.push({ field: "llm", message: "Pick an LLM provider and model." });
     }
@@ -50,6 +51,7 @@ export function admit(input) {
         fields.push({ field: "articlePrompt", message: "Pick an article prompt." });
     }
     const voiced = draft.audio;
+    fields.push(...narrationPreparationFields(draft));
     if (sources.audio === "generate") {
         if (voiced === undefined || !chosen(voiced)) {
             fields.push({ field: "audio", message: "Pick a narration provider and model." });
@@ -213,6 +215,20 @@ function checkValues(draft, requiredSlots, fields) {
 function blank(value) {
     return value === undefined || value.trim() === "";
 }
+export function usesNarrationPreparation(draft) {
+    return draft.sources.audio === "generate" && !blank(draft.narrationPrompt);
+}
+export function narrationPreparationFields(draft) {
+    return usesNarrationPreparation(draft) &&
+        (draft.audio?.provider !== "inworld" || draft.audio.model !== "inworld-tts-2")
+        ? [
+            {
+                field: "narrationPrompt",
+                message: "Narration Preparation requires Inworld TTS-2. Choose that model or turn preparation Off.",
+            },
+        ]
+        : [];
+}
 function chosen(choice) {
     return choice !== undefined && choice.provider.trim() !== "" && choice.model.trim() !== "";
 }

package/dist/slices/admission/schema.js

@@ -35,6 +35,7 @@ export const runDraftSchema = z.object({
     audio: providerChoice.extend({ voice: z.string() }).optional(),
     images: providerChoice.optional(),
     articlePrompt: z.string().optional(),
+    narrationPrompt: z.string().optional(),
     imagePrompts: z.array(z.object({ name: z.string(), number: z.number() })),
     thumbnailPrompt: z.string().optional(),
     intro: entryChoice.optional(),

package/dist/slices/estimate/index.js

@@ -1,4 +1,10 @@
 import { z } from "zod";
+import { usesNarrationPreparation } from "../admission/rules.js";
+import { plainText } from "../article/plain.js";
+import { splitEndMatter } from "../article/split.js";
+import { chunkNarration, defaultChunking } from "../narration/chunk.js";
+import { normalizeNarrationText } from "../narration/plan.js";
+import { preparationMessages } from "../narration/preparation.js";
 import { estimateRequests, groupEstimateRows } from "./requests.js";
 export { estimateRequests } from "./requests.js";
 export function estimateRun(draft, rendered, expectedWords, catalogue) {
@@ -26,7 +32,7 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
         !model.deprecated)?.pricing.note ?? "Model or account pricing is unknown.";
     const generatedArticle = draft.sources.article === "generate";
     const articleChars = generatedArticle ? expectedWords * 6 : (draft.provided.article?.length ?? 0);
-    const promptChars = Object.values(rendered).reduce((sum, value) => sum + value.length, 0);
+    const promptChars = Object.entries(rendered).reduce((sum, [key, value]) => sum + (key === "narration" ? 0 : value.length), 0);
     const local = (stage, detail) => {
         requests.push({ kind: "local", stage, detail });
     };
@@ -52,6 +58,31 @@ export function estimateRun(draft, rendered, expectedWords, catalogue) {
     if (draft.intro?.mode === "llm" || draft.outro?.mode === "llm")
         text("Intro / outro text", promptChars + articleChars, 2400);
     if (draft.sources.audio === "generate") {
+        if (usesNarrationPreparation(draft)) {
+            const known = generatedArticle
+                ? []
+                : [
+                    ...chunkNarration(normalizeNarrationText(plainText(splitEndMatter(draft.provided.article ?? "").body)), draft.chunking ?? defaultChunking),
+                ];
+            const unknown = generatedArticle || draft.intro?.mode === "llm" || draft.outro?.mode === "llm";
+            for (const category of ["intro", "outro"])
+                if (draft[category]?.mode === "text" && rendered[category]?.trim())
+                    known.push(rendered[category] ?? "");
+            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.",
+                });
+            else
+                for (const source of known)
+                    text("Narration Preparation", preparationMessages(rendered.narration ?? "", source).reduce((n, message) => n + message.content.length, 0), 2400, `${known.length} LLM calls: one per logical narration chunk or entry.`);
+            requests.push({
+                kind: "unknown",
+                stage: "Delivery cue overhead",
+                detail: "TTS character charges include delivery tags; their length is known after preparation.",
+            });
+        }
         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 };

package/dist/slices/estimate/requests.js

@@ -15,6 +15,7 @@ const requestSchema = z.discriminatedUnion("kind", [
     provider.extend({ kind: z.literal("tts-estimate"), characters: quantity }).strict(),
     provider.extend({ kind: z.literal("image") }).strict(),
     common.extend({ kind: z.literal("local") }).strict(),
+    common.extend({ kind: z.literal("unknown") }).strict(),
 ]);
 export function estimateRequests(requests, catalogue) {
     const parsed = z.array(requestSchema).parse(requests);
@@ -50,6 +51,13 @@ export function groupEstimateRows(estimate) {
     return { ...estimate, rows, unknown: rows.filter((row) => row.low === null).length };
 }
 function price(request, catalogue) {
+    if (request.kind === "unknown")
+        return {
+            stage: request.stage,
+            low: null,
+            high: null,
+            detail: request.detail ?? "Request size is not available yet.",
+        };
     if (request.kind === "local")
         return {
             stage: request.stage,

package/dist/slices/library/model.js

@@ -1,9 +1,8 @@
-// The two template libraries: prompts of three kinds, and the intro/outro entries. One rule
+// The two template libraries: prompts and intro/outro entries. One rule
 // set covers both, which is why the drafts, the lint and the save path below are shared
 // rather than mirrored.
 export { entryModes } from "../admission/model.js";
-// The CHECK constraint on `prompts.kind` holds the same three.
-export const promptKinds = ["article", "image", "thumbnail"];
+export const promptKinds = ["article", "image", "thumbnail", "narration"];
 export const entryCategories = ["intro", "outro"];
 // The name is what the Play pickers show, so it shares admission's title bound.
 export const nameMax = 200;

package/dist/slices/library/slots.js

@@ -2,7 +2,7 @@
 // the picked templates, the slot names they ask for, and the rendered text stored on the
 // project. The bodies are read at the click, not at selection, so an edit made in between
 // is the one that runs.
-import { normaliseDraft } from "../admission/rules.js";
+import { normaliseDraft, usesNarrationPreparation } from "../admission/rules.js";
 import { collectFields, render } from "../admission/substitute.js";
 import { snapshotEntry, snapshotPrompt } from "./snapshot.js";
 export function pickTemplates(db, input, snapshot) {
@@ -17,6 +17,8 @@ export function pickTemplates(db, input, snapshot) {
         body(db, "article", draft.articlePrompt, "articlePrompt", missing, text, "article", snapshot);
     }
     const intro = pickEntry(db, "intro", draft.intro, missing, snapshot);
+    if (usesNarrationPreparation(draft))
+        body(db, "narration", draft.narrationPrompt, "narrationPrompt", missing, text, "narration", snapshot);
     const outro = pickEntry(db, "outro", draft.outro, missing, snapshot);
     push(text, "intro", intro);
     push(text, "outro", outro);

package/dist/slices/narration/preparation.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+const sentence = z.number().int().positive();
+const instruction = z
+    .string()
+    .min(1)
+    .max(240)
+    .refine((text) => text.trim().length > 0 && !/[[\]<>*_`~#\p{Cc}]/u.test(text));
+const cueSchema = z.discriminatedUnion("kind", [
+    z.object({ sentence, kind: z.literal("instruction"), text: instruction }).strict(),
+    z.object({ sentence, kind: z.literal("reset") }).strict(),
+    z
+        .object({
+        sentence,
+        kind: z.literal("sound"),
+        sound: z.enum(["laugh", "breathe", "clear throat", "sigh", "cough", "yawn"]),
+    })
+        .strict(),
+]);
+const answerSchema = z.object({ cues: z.array(cueSchema) }).strict();
+export function sourceSentences(source) {
+    return Array.from(new Intl.Segmenter("en", { granularity: "sentence" }).segment(source), (part, index) => ({ sentence: index + 1, text: part.segment }));
+}
+export function validatePreparation(answer, source) {
+    let raw;
+    try {
+        raw = JSON.parse(answer);
+    }
+    catch (error) {
+        if (!(error instanceof SyntaxError))
+            throw error;
+        return { ok: false, reason: "Return a JSON object containing only cues." };
+    }
+    const parsed = answerSchema.safeParse(raw);
+    if (!parsed.success)
+        return { ok: false, reason: "Use only the documented cue fields and values." };
+    const count = sourceSentences(source).length;
+    const persistent = new Set();
+    const sounds = new Set();
+    let previous = 0;
+    for (const cue of parsed.data.cues) {
+        if (cue.sentence > count || cue.sentence < previous)
+            return { ok: false, reason: "Cue sentence numbers must be in source order and in range." };
+        previous = cue.sentence;
+        if (cue.kind !== "sound") {
+            if (persistent.has(cue.sentence))
+                return { ok: false, reason: "Use at most one instruction or reset per sentence." };
+            persistent.add(cue.sentence);
+        }
+        else {
+            const key = `${cue.sentence}:${cue.sound}`;
+            if (sounds.has(key))
+                return { ok: false, reason: "Do not repeat a sound at the same sentence." };
+            sounds.add(key);
+        }
+    }
+    return { ok: true, cues: parsed.data.cues };
+}
+const contract = [
+    'Return JSON only: {"cues":[...]}.',
+    "Each cue has sentence (a supplied 1-based index) and kind.",
+    "instruction adds text: a short English delivery direction without brackets or markup.",
+    "reset has no other fields. sound adds sound: laugh, breathe, clear throat, sigh, cough or yawn.",
+    "Order cues by sentence. At most one instruction or reset per sentence.",
+    "Never return or rewrite narration. Do not translate, correct, abbreviate or add dialogue.",
+    "Use cues sparingly; an empty cues array is valid. Combine simultaneous directions.",
+].join("\n");
+export function preparationMessages(prompt, source) {
+    return [
+        { role: "system", content: contract },
+        {
+            role: "user",
+            content: JSON.stringify({ direction: prompt, sentences: sourceSentences(source) }),
+        },
+    ];
+}

package/dist/slices/narration/steering.js

@@ -0,0 +1,89 @@
+import { sourceSentences } from "./preparation.js";
+const cannotFit = {
+    ok: false,
+    reason: "Delivery cues or whitespace leave no room for narration at this model's character limit.",
+};
+export function prepareRequests(source, cues, maxCharacters) {
+    if (!Number.isInteger(maxCharacters) || maxCharacters < 2)
+        return {
+            ok: false,
+            reason: "The narration character limit must be a whole number of at least 2.",
+        };
+    if (source.trim() === "")
+        return { ok: true, requests: [] };
+    const requests = [];
+    const bySentence = new Map();
+    for (const cue of cues) {
+        const group = bySentence.get(cue.sentence) ?? [];
+        group.push(cue);
+        bySentence.set(cue.sentence, group);
+    }
+    let active = null;
+    let text = "";
+    let spokenText = "";
+    const flush = () => {
+        if (spokenText.trim() === "")
+            return false;
+        requests.push({ text, spokenText });
+        text = "";
+        spokenText = "";
+        return true;
+    };
+    for (const sentence of sourceSentences(source)) {
+        const events = bySentence.get(sentence.sentence) ?? [];
+        const direction = events.find((cue) => cue.kind !== "sound");
+        const tags = events.map(cueTag).join(" ");
+        const prefix = tags === "" ? "" : `${tags} `;
+        const first = Array.from(sentence.text)[0] ?? "";
+        const words = sentence.text.match(/\S+\s*|\s+/gu) ?? [];
+        const firstWord = words[0] ?? first;
+        const freshPrefix = direction === undefined ? carryTag(active) : "";
+        const minimum = firstWord.length + prefix.length + freshPrefix.length <= maxCharacters
+            ? firstWord.length
+            : first.length;
+        if (spokenText.trim() !== "" && text.length + prefix.length + minimum > maxCharacters) {
+            if (!flush())
+                return cannotFit;
+        }
+        if (text === "" && direction === undefined)
+            text = carryTag(active);
+        if (text.length + prefix.length + first.length > maxCharacters)
+            return cannotFit;
+        text += prefix;
+        if (direction !== undefined)
+            active = direction.kind === "instruction" ? direction.text : null;
+        for (const word of words) {
+            if (word.length + carryTag(active).length <= maxCharacters &&
+                text.length + word.length > maxCharacters &&
+                spokenText.trim() !== "") {
+                if (!flush())
+                    return cannotFit;
+                text = carryTag(active);
+            }
+            for (const point of word) {
+                if (text.length + point.length > maxCharacters) {
+                    if (!flush())
+                        return cannotFit;
+                    text = carryTag(active);
+                }
+                if (text.length + point.length > maxCharacters)
+                    return cannotFit;
+                text += point;
+                spokenText += point;
+            }
+        }
+    }
+    if (spokenText !== "" && !flush())
+        return cannotFit;
+    return { ok: true, requests };
+}
+function cueTag(cue) {
+    return cue.kind === "instruction"
+        ? `[${cue.text}]`
+        : cue.kind === "reset"
+            ? "[reset]"
+            : `[${cue.sound}]`;
+}
+function carryTag(active) {
+    return active === null ? "" : `[${active}] `;
+}

package/dist/slices/play-drafts/convert.js

@@ -62,6 +62,9 @@ export function toAdmissionDraft(input) {
         audio: sources.audio === "generate" ? form.audio : undefined,
         images: form.images,
         articlePrompt: sources.article === "generate" ? form.articlePrompt : undefined,
+        ...(sources.audio === "generate" && form.narrationPrompt?.trim()
+            ? { narrationPrompt: form.narrationPrompt }
+            : {}),
         imagePrompts: sources.images === "generate"
             ? form.imagePrompts.map((prompt, index) => ({
                 name: prompt.name,

package/dist/slices/play-drafts/readiness.js

@@ -1,6 +1,7 @@
 import { checkRuntimeModel } from "../../catalog/runtime-models.js";
 import { modelFields } from "../../catalog/validate.js";
 import { readinessIsUsable } from "../../kernel/ports/model.js";
+import { usesNarrationPreparation } from "../admission/rules.js";
 import { cliPathStatus } from "../settings/cli-paths.js";
 import { hasKey, listVoices } from "../settings/repo.js";
 export function choices(runs) {
@@ -14,7 +15,8 @@ export function choices(runs) {
                 d.sources.article === "generate" ||
                 d.sources.thumbnail === "prompt_by_llm" ||
                 d.intro?.mode === "llm" ||
-                d.outro?.mode === "llm",
+                d.outro?.mode === "llm" ||
+                usesNarrationPreparation(d),
         },
         {
             field: "audio",

package/dist/slices/play-drafts/schema.js

@@ -34,6 +34,7 @@ export const playDraftFormSchema = z
     audio: provider.extend({ voice: text }).readonly(),
     images: provider.readonly(),
     articlePrompt: text,
+    narrationPrompt: text.optional(),
     imagePrompts: z.array(z.object({ name: text, number: text }).strict().readonly()).readonly(),
     thumbnailPrompt: text,
     intro: text,

package/dist/slices/project-templates/from-project.js

@@ -73,6 +73,7 @@ function documentFromProject(deps, revision) {
         });
     };
     addPrompt("article", config.articlePrompt, "article");
+    addPrompt("narration", config.narrationPrompt, "narration");
     const definitions = revision.content.imageOrder.flatMap((key) => {
         const definition = revision.content.imageDefinitions[key];
         return definition === undefined ? [] : [definition];
@@ -131,6 +132,7 @@ function documentFromProject(deps, revision) {
             audio: config.audio ?? { provider: "", model: "", voice: "" },
             images: config.images ?? { provider: "", model: "" },
             articlePrompt: config.articlePrompt ?? "",
+            ...(config.narrationPrompt === undefined ? {} : { narrationPrompt: config.narrationPrompt }),
             imagePrompts,
             thumbnailPrompt: config.thumbnailPrompt ?? "",
             intro: config.intro?.name ?? "",

package/dist/slices/project-templates/setup.js

@@ -4,6 +4,7 @@ export function templateSetup(deps, input) {
     const entries = [];
     const choices = [
         { kind: "article", name: input.form.articlePrompt },
+        { kind: "narration", name: input.form.narrationPrompt ?? "" },
         ...input.form.imagePrompts.map((row) => ({ kind: "image", name: row.name })),
         { kind: "thumbnail", name: input.form.thumbnailPrompt },
     ];

package/dist/slices/rebuild/admission-repo.js

@@ -6,7 +6,7 @@ import { getRevisionView } from "../revisions/view.js";
 import { rebuildAdmissionSchema, } from "./model.js";
 import { executionSnapshotSchema, planPreview, reviewStillCovers } from "./preview-plan.js";
 import { previewById } from "./repo.js";
-import { insertInvocation } from "./runtime-admission.js";
+import { insertInvocation, reservationKey } from "./runtime-admission.js";
 import { bindNarrationReuse } from "./runtime-narration-reuse.js";
 import { projectStandings } from "./runtime-store.js";
 export function admissionReceipt(db, projectId, idempotencyKey, requestHash) {
@@ -93,7 +93,7 @@ export function admitPreview(deps, input) {
             deps.db
                 .prepare("DELETE FROM revision_work_reservations WHERE revision_id=? AND work_key=?")
                 .run(view.revision.id, recipe.key);
-            const key = recipe.input.kind === "tts" ? `${recipe.input.logicalKey}:1` : recipe.key;
+            const key = reservationKey(recipe, view);
             const fingerprint = snapshot.anchors[key];
             if (fingerprint === undefined)
                 throw new Error("Selected work has no reviewed desired anchor.");

package/dist/slices/rebuild/preview-details.js

@@ -49,15 +49,17 @@ export function previewDetails(deps, view, allRecipes, selected) {
         }
         if (input.kind === "llm") {
             const peers = allRecipes.filter((one) => one.stage === row.stage && one.input.kind === "llm");
-            const category = row.key.startsWith("entry:intro")
-                ? "Intro text"
-                : row.key.startsWith("entry:outro")
-                    ? "Outro text"
-                    : row.stage === "article"
-                        ? "Article"
-                        : row.stage === "research"
-                            ? "Research"
-                            : "Thumbnail prompt";
+            const category = input.preparation !== undefined
+                ? "Narration Preparation"
+                : row.key.startsWith("entry:intro")
+                    ? "Intro text"
+                    : row.key.startsWith("entry:outro")
+                        ? "Outro text"
+                        : row.stage === "article"
+                            ? "Article"
+                            : row.stage === "research"
+                                ? "Research"
+                                : "Thumbnail prompt";
             return [
                 {
                     key: row.key,
@@ -119,6 +121,7 @@ function inputChanges(parent, view) {
         add(`${name} thinking`, a?.thinking, b?.thinking);
     }
     add("Narration voice", before.audio?.voice, after.audio?.voice);
+    add("Narration Preparation", before.narrationPrompt, after.narrationPrompt);
     add("Narration chunking", before.chunking, after.chunking);
     add("Silence gap (seconds)", before.silenceGapSeconds, after.silenceGapSeconds);
     add("Intro", before.intro, after.intro);

package/dist/slices/rebuild/preview-plan.js

@@ -9,6 +9,7 @@ import { providedDependencyFingerprint } from "./provided-review.js";
 import { recipeInputSchema } from "./recipe-input-schema.js";
 import { recipeProviderChoice } from "./recipe-provider-choice.js";
 import { priceRecipe } from "./recipe-work.js";
+import { reservationKey } from "./runtime-admission.js";
 import { narrationOrdinal } from "./runtime-narration-reuse.js";
 import { executionCatalogue } from "./runtime-plan.js";
 export const executionSnapshotSchema = z.object({
@@ -143,7 +144,7 @@ export function planPreview(deps, view, catalogue, selection, id) {
             .map((key) => ({ key, fingerprint: providedDependencyFingerprint(plan, key) })),
         ordinals: Object.fromEntries(recipes.map((row) => [row.key, narrationOrdinal(plan.recipes, row.key)])),
         anchors: Object.fromEntries(recipes.map((recipe) => {
-            const key = recipe.input.kind === "tts" ? `${recipe.input.logicalKey}:1` : recipe.key;
+            const key = reservationKey(recipe, view);
             return [key, view.revision.fingerprints[key] ?? recipe.logicalFingerprint];
         })),
     };
@@ -189,6 +190,11 @@ function selectedCatalogue(catalogue, recipes, view) {
         const choice = recipeProviderChoice(row, view.revision.config);
         return choice === undefined ? [] : [`${choice.family}:${choice.provider}:${choice.model}`];
     }));
+    const audio = view.revision.config.audio;
+    if (audio &&
+        recipes.some((row) => (row.input.kind === "llm" && row.input.preparation) ||
+            (row.input.kind === "deferred" && row.input.operation === "narration-preparation")))
+        uses.add(`tts:${audio.provider}:${audio.model}`);
     const selected = {
         llm: catalogue.llm.filter((row) => uses.has(`llm:${row.provider}:${row.id}`)),
         tts: catalogue.tts.filter((row) => uses.has(`tts:${row.provider}:${row.id}`)),

package/dist/slices/rebuild/recipe-audio-parts.js

@@ -0,0 +1,89 @@
+import { usesNarrationPreparation } from "../admission/rules.js";
+import { narrationRegenerationToken, normalizeNarrationText, planNarration, } from "../narration/plan.js";
+import { recipe } from "./recipe-model.js";
+import { preparationForGroup } from "./recipe-preparation.js";
+export function narrationParts(context, logicalKey, originalText, segment, dependsOn, preparations) {
+    const override = context.content.narrationOverrides[logicalKey];
+    if (override?.kind === "asset")
+        return [
+            recipe(context, `${logicalKey}:1`, "audio", {
+                kind: "provided",
+                version: 1,
+                assetId: override.assetId,
+                semantic: [normalizeNarrationText(originalText), voiceValues(context)],
+            }, dependsOn, { tokenKey: logicalKey }),
+        ];
+    const logicalText = normalizeNarrationText(override?.kind === "text" ? override.text : originalText);
+    const wholeRequest = segment !== "body" || (context.config.chunking?.mode ?? "whole") === "whole";
+    const choice = context.config.audio;
+    const model = context.catalogue?.tts.find((row) => row.provider === choice?.provider &&
+        row.id === choice.model &&
+        row.enabled &&
+        !row.deprecated);
+    if (usesNarrationPreparation(context.config)) {
+        const prepared = preparationForGroup(context, logicalKey, logicalText, segment, dependsOn, model?.tts.maxCharacters ?? Math.max(2, logicalText.length));
+        preparations.push(prepared.preparation);
+        if (prepared.refusal !== null)
+            return [
+                recipe(context, `${logicalKey}:1`, "audio", {
+                    kind: "deferred",
+                    version: 1,
+                    operation: "resolve-revision-recipe",
+                    template: prepared.refusal,
+                }, [prepared.preparation.key], { unresolved: true, refusal: prepared.refusal }),
+            ];
+        return (prepared.requests ?? []).map(({ text, spokenText }, index) => recipe(context, `${logicalKey}:${index + 1}`, "audio", {
+            kind: "tts",
+            version: 1,
+            provider: choice?.provider ?? "",
+            model: choice?.model ?? "",
+            voice: choice?.voice ?? "",
+            text,
+            spokenText,
+            logicalKey,
+            logicalText,
+            segment,
+            pronunciation: null,
+            wholeRequest,
+        }, [prepared.preparation.key], { tokenKey: logicalKey, unresolved: logicalText.length === 0 }));
+    }
+    const requests = planNarration({
+        groups: [
+            {
+                key: logicalKey,
+                text: logicalText,
+                segment,
+                wholeRequest,
+                regenerationToken: narrationRegenerationToken(context.content.regenerationTokens, logicalKey, segment),
+            },
+        ],
+        provider: choice?.provider ?? "",
+        model: choice?.model ?? "",
+        voice: choice?.voice ?? "",
+        maxCharacters: context.catalogue === undefined
+            ? Math.max(2, logicalText.length)
+            : (model?.tts.maxCharacters ?? Math.max(2, logicalText.length)),
+        retained: [],
+    });
+    return requests.map(({ text, key }) => recipe(context, key, "audio", {
+        kind: "tts",
+        version: 1,
+        provider: choice?.provider ?? "",
+        model: choice?.model ?? "",
+        voice: choice?.voice ?? "",
+        text,
+        logicalKey,
+        logicalText,
+        segment,
+        pronunciation: null,
+        wholeRequest,
+    }, dependsOn, { tokenKey: logicalKey, unresolved: logicalText.length === 0 }));
+}
+export function voiceValues(context) {
+    return [
+        context.config.audio?.provider ?? null,
+        context.config.audio?.model ?? null,
+        context.config.audio?.voice ?? null,
+        null,
+    ];
+}