@gentbajko/slopify 3.25.9 → 4.1.0

package/dist/kernel/db/migrations/0068-topic-scores.sql

@@ -0,0 +1,17 @@
+-- Topic scoring (`slices/schedules/score.ts`): off for every schedule saved before it, which
+-- then finds and orders topics exactly as it did. A topic's score is kept beside the queue, by
+-- its normalised title, so the queue's own rows keep their strict shape; `pinned` is a topic the
+-- person moved, which scoring then leaves where it was put.
+ALTER TABLE schedules ADD COLUMN topic_scoring TEXT NOT NULL DEFAULT 'off' CHECK(topic_scoring IN ('off','library','search'));
+CREATE TABLE topic_scores (
+ schedule_id TEXT NOT NULL REFERENCES schedules(id) ON DELETE CASCADE,
+ topic_key TEXT NOT NULL,
+ title TEXT NOT NULL,
+ score INTEGER NOT NULL CHECK(score BETWEEN 0 AND 100),
+ interest REAL,
+ novelty REAL NOT NULL,
+ reasons TEXT NOT NULL CHECK(json_valid(reasons)),
+ pinned INTEGER NOT NULL DEFAULT 0 CHECK(pinned IN (0,1)),
+ scored_at TEXT NOT NULL,
+ PRIMARY KEY(schedule_id, topic_key)
+);

package/dist/kernel/db/migrations/0070-designs.sql

@@ -0,0 +1,53 @@
+-- Designs (4.0): an uploaded or generated picture edited step by step, and a designed piece
+-- (poster, flyer, brochure, social image) whose text Slopify lays out on the AI's artwork.
+-- A design is its own record, not a project; `project_id` only links it to one ("Keep in
+-- project") and is cleared when that project is deleted. `channel_id` is the channel its paid
+-- calls count under on Home. `sample_of` marks the hidden sample a design template's editor
+-- redraws; every list leaves those out. Each step is one version of the picture, kept in
+-- image_blobs (backed up), chained by `parent_id`; `head_step_id` is the version the design
+-- shows and continues from.
+CREATE TABLE designs (
+ id TEXT PRIMARY KEY,
+ kind TEXT NOT NULL CHECK(kind IN ('edit','design')),
+ name TEXT NOT NULL CHECK(length(trim(name)) BETWEEN 1 AND 200),
+ channel_id TEXT NOT NULL,
+ project_id TEXT REFERENCES projects(id) ON DELETE SET NULL,
+ template_id TEXT,
+ template_version INTEGER CHECK(template_version IS NULL OR template_version >= 1),
+ schedule_id TEXT,
+ schedule_run_id TEXT,
+ document_json TEXT CHECK(document_json IS NULL OR json_valid(document_json)),
+ values_json TEXT NOT NULL DEFAULT '{}' CHECK(json_valid(values_json)),
+ head_step_id TEXT,
+ sample_of TEXT,
+ mutation_id TEXT UNIQUE,
+ mutation_hash TEXT,
+ created_at TEXT NOT NULL,
+ updated_at TEXT NOT NULL,
+ deleted_at TEXT
+);
+CREATE INDEX designs_project ON designs(project_id) WHERE project_id IS NOT NULL;
+CREATE INDEX designs_schedule ON designs(schedule_id) WHERE schedule_id IS NOT NULL;
+CREATE INDEX designs_sample_of ON designs(sample_of) WHERE sample_of IS NOT NULL;
+CREATE TABLE design_steps (
+ id TEXT PRIMARY KEY,
+ design_id TEXT NOT NULL REFERENCES designs(id) ON DELETE CASCADE,
+ n INTEGER NOT NULL CHECK(n >= 1),
+ parent_id TEXT REFERENCES design_steps(id) ON DELETE CASCADE,
+ kind TEXT NOT NULL CHECK(kind IN ('upload','edit','generate')),
+ instruction TEXT CHECK(instruction IS NULL OR length(instruction) <= 4000),
+ provider TEXT,
+ model TEXT,
+ inputs_json TEXT NOT NULL DEFAULT '{}' CHECK(json_valid(inputs_json)),
+ state TEXT NOT NULL CHECK(state IN ('making','ready','failed')),
+ error TEXT,
+ sha256 TEXT REFERENCES image_blobs(sha256),
+ width INTEGER CHECK(width IS NULL OR width > 0),
+ height INTEGER CHECK(height IS NULL OR height > 0),
+ mutation_id TEXT UNIQUE,
+ mutation_hash TEXT,
+ created_at TEXT NOT NULL,
+ settled_at TEXT,
+ UNIQUE(design_id, n),
+ CHECK(state <> 'ready' OR sha256 IS NOT NULL)
+);

package/dist/kernel/db/migrations/0071-design-usage.sql

@@ -0,0 +1,33 @@
+-- A design's picture edits and artwork are paid calls made outside a project, metered like a
+-- schedule's or a channel's (0040). Every row is copied as it was; only the owner kinds widen.
+CREATE TABLE standalone_usage_next (
+ id TEXT PRIMARY KEY,
+ owner_kind TEXT NOT NULL CHECK(owner_kind IN ('schedule','channel','design')),
+ owner_id TEXT NOT NULL,
+ channel_id TEXT NOT NULL,
+ purpose TEXT NOT NULL,
+ kind TEXT NOT NULL CHECK(kind IN ('llm','tts','image','video')),
+ provider TEXT NOT NULL,
+ model TEXT NOT NULL,
+ tokens_in INTEGER,
+ tokens_out INTEGER,
+ tokens_cached INTEGER,
+ characters INTEGER,
+ images INTEGER,
+ seconds REAL,
+ size TEXT,
+ quality TEXT,
+ wall_ms INTEGER NOT NULL,
+ on_plan INTEGER NOT NULL DEFAULT 0 CHECK(on_plan IN (0,1)),
+ cost REAL,
+ api_model TEXT,
+ api_cost REAL,
+ price_json TEXT CHECK(price_json IS NULL OR json_valid(price_json)),
+ account TEXT,
+ reading_json TEXT CHECK(reading_json IS NULL OR json_valid(reading_json)),
+ created_at TEXT NOT NULL
+);
+INSERT INTO standalone_usage_next SELECT id, owner_kind, owner_id, channel_id, purpose, kind, provider, model, tokens_in, tokens_out, tokens_cached, characters, images, seconds, size, quality, wall_ms, on_plan, cost, api_model, api_cost, price_json, account, reading_json, created_at FROM standalone_usage ORDER BY rowid;
+DROP TABLE standalone_usage;
+ALTER TABLE standalone_usage_next RENAME TO standalone_usage;
+CREATE INDEX standalone_usage_created ON standalone_usage(created_at);

package/dist/kernel/db/migrations/0072-design-templates.sql

@@ -0,0 +1,33 @@
+-- Design templates: a designed piece saved with fields ({{Event}}, {{Date}}…) to make again by
+-- hand or from a schedule. Every Save is a new revision; schedules only make from a revision
+-- marked ready. `design_template_samples` is the one sample job per template its editor
+-- redraws after a Save (the sample itself is a hidden design, `designs.sample_of`).
+CREATE TABLE design_templates (
+ id TEXT PRIMARY KEY,
+ channel_id TEXT,
+ head_version INTEGER NOT NULL CHECK(head_version >= 1),
+ created_at TEXT NOT NULL,
+ deleted_at TEXT,
+ mutation_id TEXT UNIQUE,
+ mutation_hash TEXT
+);
+CREATE TABLE design_template_revisions (
+ template_id TEXT NOT NULL REFERENCES design_templates(id) ON DELETE CASCADE,
+ version INTEGER NOT NULL CHECK(version >= 1),
+ name TEXT NOT NULL CHECK(length(trim(name)) BETWEEN 1 AND 200),
+ document_json TEXT NOT NULL CHECK(json_valid(document_json)),
+ gate TEXT NOT NULL DEFAULT 'unchecked' CHECK(gate IN ('unchecked','ready')),
+ checks_json TEXT CHECK(checks_json IS NULL OR json_valid(checks_json)),
+ marked_at TEXT,
+ created_at TEXT NOT NULL,
+ PRIMARY KEY(template_id, version)
+);
+CREATE TABLE design_template_samples (
+ template_id TEXT PRIMARY KEY REFERENCES design_templates(id) ON DELETE CASCADE,
+ design_id TEXT UNIQUE,
+ version INTEGER NOT NULL CHECK(version >= 1),
+ state TEXT NOT NULL CHECK(state IN ('queued','making','done','failed','held')),
+ held_reason TEXT,
+ quoted_high REAL,
+ updated_at TEXT NOT NULL
+);

package/dist/kernel/db/migrations/0073-schedule-design-kind.sql

@@ -0,0 +1,5 @@
+-- A schedule makes either projects from a project template (every schedule so far) or
+-- designed pieces from a design template, one per row of its table ahead of that row's date.
+-- `design_ids_json` lists the designs a run made, as `project_ids_json` lists projects.
+ALTER TABLE schedules ADD COLUMN template_kind TEXT NOT NULL DEFAULT 'project' CHECK(template_kind IN ('project','design'));
+ALTER TABLE schedule_runs ADD COLUMN design_ids_json TEXT NOT NULL DEFAULT '[]' CHECK(json_valid(design_ids_json));

package/dist/kernel/db/migrations/0074-template-bakeoffs.sql

@@ -0,0 +1,44 @@
+-- Template studio's model bake-off (4.0, `slices/template-studio/bakeoff.ts`): one section's
+-- sample made again on two or three models, each on a hidden copy of the template's sample
+-- project, compared by cost and speed, then discarded. One bake-off per template at a time.
+CREATE TABLE template_bakeoffs (
+ id TEXT PRIMARY KEY,
+ template_id TEXT NOT NULL UNIQUE REFERENCES project_templates(id) ON DELETE CASCADE,
+ template_version INTEGER NOT NULL CHECK(template_version >= 1),
+ section TEXT NOT NULL CHECK(section IN ('script','voice','pictures')),
+ ack_high REAL NOT NULL CHECK(ack_high >= 0),
+ ack_unknown INTEGER NOT NULL DEFAULT 0 CHECK(ack_unknown IN (0,1)),
+ state TEXT NOT NULL CHECK(state IN ('queued','making','done','held','failed')),
+ sentence TEXT,
+ created_at TEXT NOT NULL,
+ updated_at TEXT NOT NULL
+);
+-- Each model's copy. Its project is hidden like the sample's (`template_hidden_projects`) and
+-- removed with the bake-off.
+CREATE TABLE template_bakeoff_clones (
+ bakeoff_id TEXT NOT NULL REFERENCES template_bakeoffs(id) ON DELETE CASCADE,
+ slot INTEGER NOT NULL CHECK(slot BETWEEN 0 AND 2),
+ provider TEXT NOT NULL CHECK(length(provider) BETWEEN 1 AND 100),
+ model TEXT NOT NULL CHECK(length(model) BETWEEN 1 AND 200),
+ project_id TEXT UNIQUE,
+ state TEXT NOT NULL CHECK(state IN ('queued','making','done','failed')),
+ quoted_high REAL,
+ failure TEXT,
+ started_at TEXT,
+ finished_at TEXT,
+ PRIMARY KEY(bakeoff_id, slot)
+);
+-- Every project the studio keeps out of the lists the person sees: each template's sample and
+-- each bake-off copy (`notTemplateSample`).
+CREATE VIEW template_hidden_projects AS
+ SELECT project_id FROM template_samples
+ UNION ALL
+ SELECT project_id FROM template_bakeoff_clones WHERE project_id IS NOT NULL;
+-- What a hidden project spent, kept when the project is removed (a bake-off discarded, a sample
+-- made again on a new topic), so today's sample budget still counts it.
+CREATE TABLE template_studio_spend (
+ project_id TEXT NOT NULL,
+ cost REAL NOT NULL CHECK(cost >= 0),
+ created_at TEXT NOT NULL
+);
+CREATE INDEX template_studio_spend_at ON template_studio_spend(created_at);

package/dist/kernel/db/migrations/0075-social-posts.sql

@@ -0,0 +1,25 @@
+-- Posting to other sites (`slices/social`). One row per project, site and item (0 is the
+-- project's one post per site): the project's own pick (`choice_json`, NULL is the template's),
+-- the person's hand edit of the text and the generated text it was made from, Reddit's own
+-- fields, and where the post stands after the extension filled it or the person posted it.
+-- A project with no row posts as its settings say; nothing here is generated.
+CREATE TABLE social_posts (
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  platform TEXT NOT NULL CHECK (platform IN ('x','linkedin','instagram','tiktok','reddit','bluesky')),
+  item INTEGER NOT NULL DEFAULT 0 CHECK (item >= 0),
+  choice_json TEXT CHECK (choice_json IS NULL OR json_valid(choice_json)),
+  text_edit TEXT,
+  text_base TEXT,
+  reddit_json TEXT CHECK (reddit_json IS NULL OR json_valid(reddit_json)),
+  state TEXT NOT NULL DEFAULT 'none' CHECK (state IN ('none','waiting','filling','filled','scheduled','posted','failed')),
+  waiting_at TEXT,
+  filled_at TEXT,
+  scheduled_at TEXT,
+  posted_at TEXT,
+  url TEXT,
+  message TEXT,
+  by TEXT CHECK (by IN ('extension','person')),
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (project_id, platform, item)
+);
+CREATE INDEX social_posts_waiting ON social_posts(platform, waiting_at) WHERE state = 'waiting';

package/dist/kernel/db/migrations/0076-channel-social.sql

@@ -0,0 +1,5 @@
+-- A channel's accounts on other sites (`slices/social`): the X subscription, which only changes
+-- a post's warnings, and the account names the extension reads a published post's link from.
+-- Never a login.
+ALTER TABLE channels ADD COLUMN x_tier TEXT NOT NULL DEFAULT 'free' CHECK (x_tier IN ('free','premium','premium_plus'));
+ALTER TABLE channels ADD COLUMN social_accounts TEXT NOT NULL DEFAULT '{}' CHECK (json_valid(social_accounts));

package/dist/kernel/db/migrations/0077-post-prompts.sql

@@ -0,0 +1,17 @@
+-- Library prompts of the new "post" kind: what writes a project's post for another site
+-- (`slices/social`). SQLite cannot change a CHECK in place, so the table is copied into one
+-- whose CHECK lists the new kind, like 0034 did for "script".
+CREATE TABLE prompts_post_upgrade (
+  id TEXT PRIMARY KEY,
+  kind TEXT NOT NULL CHECK (kind IN ('article','image','thumbnail','narration','description','shorts','review','script','post')),
+  name TEXT NOT NULL,
+  body TEXT NOT NULL,
+  slots TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  deleted_at TEXT
+);
+INSERT INTO prompts_post_upgrade (id,kind,name,body,slots,updated_at,deleted_at)
+  SELECT id,kind,name,body,slots,updated_at,deleted_at FROM prompts;
+DROP TABLE prompts;
+ALTER TABLE prompts_post_upgrade RENAME TO prompts;
+CREATE UNIQUE INDEX prompts_name ON prompts(kind,lower(name)) WHERE deleted_at IS NULL;

package/dist/kernel/db/migrations/0078-uploaded-from-links.sql

@@ -0,0 +1,7 @@
+-- The long video on YouTube and the project's "uploaded" mark are one fact
+-- (`slices/studio/videos.ts`): saving or confirming the long video's link marks the project
+-- uploaded. A long video already on YouTube before that marks its project now, from when its
+-- link was recorded; a mark made by hand keeps its own time.
+INSERT INTO project_uploads (project_id, uploaded_at)
+  SELECT project_id, recorded_at FROM youtube_videos WHERE short = 0 AND upload_state = 'done'
+  ON CONFLICT(project_id) DO NOTHING;

package/dist/kernel/db/tx.js

@@ -1,3 +1,4 @@
+import { errorText } from "../errors.js";
 // SQLite starts a transaction for a SAVEPOINT issued outside one and nests it inside one
 // already open, so a slice can wrap its own writes without knowing whether its caller did
 // too. The name is a constant, not a parameter: SQLite matches RELEASE and ROLLBACK TO
@@ -34,7 +35,7 @@ function unwind(db, error) {
         db.exec(`RELEASE ${savepoint}`);
     }
     catch (cleanup) {
-        throw new Error(`the transaction could not be unwound: ${messageOf(cleanup)}`, {
+        throw new Error(`the transaction could not be unwound: ${errorText(cleanup)}`, {
             cause: error,
         });
     }
@@ -45,6 +46,3 @@ function isThenable(value) {
         "then" in value &&
         typeof value.then === "function");
 }
-function messageOf(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/dist/kernel/errors.js

@@ -1,8 +1,29 @@
+// The one sentence a failure carries: an Error's message, or whatever else was thrown as text.
+export function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+// The Node file-system code (`ENOENT`, `EEXIST`) of a thrown value, if it carries one.
+export function errnoCode(error) {
+    return typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string"
+        ? error.code
+        : undefined;
+}
+export function hasErrnoCode(error, code) {
+    return errnoCode(error) === code;
+}
+// A path that is missing, not a directory, not readable or a link loop: nothing to read there.
+export function isUnreachablePath(error) {
+    const code = errnoCode(error);
+    return code !== undefined && ["ENOENT", "ENOTDIR", "EACCES", "EPERM", "ELOOP"].includes(code);
+}
 // A failure's own sentence and every cause it wraps, for the log. The page shows only the
 // sentence; the chain is the only place a "download interrupted" says the server closed the
 // stream.
 export function causedBy(error) {
-    const chain = [error instanceof Error ? error.message : String(error)];
+    const chain = [errorText(error)];
     let cause = error instanceof Error ? error.cause : undefined;
     while (cause !== undefined && cause !== null && chain.length < 6) {
         chain.push(cause instanceof Error ? `${cause.name}: ${cause.message}` : String(cause));
@@ -10,3 +31,8 @@ export function causedBy(error) {
     }
     return chain.join(" <- ");
 }
+// The sentence for a check that can only fail through a bug. `what` says which check, in words a
+// person can report; `retry` names the button that is right on the screen the message appears on.
+export function internalError(what, retry = "Try again") {
+    return `Slopify hit an internal error (${what}). ${retry}; if it happens again, use Download diagnostics in Settings and report it.`;
+}

package/dist/kernel/json-answer.js

@@ -0,0 +1,15 @@
+// The JSON an AI model's answer carries, wherever the model put it: bare, in a ```json fence, or
+// after a sentence of its own. Everything from the first `open` to the last `close` is parsed;
+// undefined when there is none or it is not JSON.
+export function jsonBetween(text, open, close) {
+    const start = text.indexOf(open);
+    const end = text.lastIndexOf(close);
+    if (start === -1 || end <= start)
+        return undefined;
+    try {
+        return JSON.parse(text.slice(start, end + 1));
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/kernel/lock.js

@@ -1,4 +1,5 @@
 import { readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { errnoCode } from "./errors.js";
 // Seconds since the epoch at which this process started, stable for its whole life.
 const startedAt = Math.round(Date.now() / 1000 - process.uptime());
 export function acquireInstanceLock(lockPath) {
@@ -32,7 +33,7 @@ function claim(lockPath, pid) {
         return true;
     }
     catch (error) {
-        if (errnoOf(error) === "EEXIST") {
+        if (errnoCode(error) === "EEXIST") {
             return false;
         }
         throw error;
@@ -65,7 +66,7 @@ function discard(lockPath) {
         unlinkSync(lockPath);
     }
     catch (error) {
-        if (errnoOf(error) !== "ENOENT") {
+        if (errnoCode(error) !== "ENOENT") {
             throw error;
         }
     }
@@ -77,12 +78,6 @@ function isAlive(pid) {
     }
     catch (error) {
         // EPERM means the process exists and belongs to someone else.
-        return errnoOf(error) === "EPERM";
+        return errnoCode(error) === "EPERM";
     }
 }
-function errnoOf(error) {
-    if (error instanceof Error && "code" in error && typeof error.code === "string") {
-        return error.code;
-    }
-    return undefined;
-}

package/dist/kernel/paths.js

@@ -18,6 +18,14 @@ export function layout(dataDir, files) {
 export function attachPlaces(paths, places) {
     Object.assign(paths, { places });
 }
+// Tells a running install's Paths which projects are studio samples.
+export function attachSamples(paths, samples) {
+    Object.assign(paths, { samples });
+}
+// Where the studio samples' project folders are: inside the data dir, beside the database.
+export function templateSamplesDir(paths) {
+    return join(paths.dataDir, "template-studio", "samples");
+}
 // Points a running install's Paths at moved files. The one object every slice was handed is
 // changed in place, so the next file each one reads or writes is in the new place.
 export function repoint(paths, files) {

package/dist/kernel/pipeline.js

@@ -19,6 +19,18 @@ export const stageKinds = [
     "video",
     "document",
 ];
+// One name per stage, everywhere a stage is named, on screen (the web app reads it through
+// `@/lib/stage-words`) and in the server's sentences. The pipeline calls the narration stage
+// `audio` and the PDF stage `document`; a person never sees those words.
+export const stageWords = {
+    research: "Research",
+    article: "Article",
+    audio: "Narration",
+    images: "Images",
+    thumbnail: "Thumbnail",
+    video: "Video",
+    document: "PDF",
+};
 export const stageStates = [
     "pending",
     "running",

package/dist/kernel/ports/assistant-cli.js

@@ -0,0 +1,4 @@
+// The in-app assistant's turn on a CLI on this computer (`adapters/llm/assistant-cli.ts`). The
+// slice hands in the turn's prompt and token and reads back what the chat shows; how the CLI
+// is started, isolated and read stays in the adapter.
+export const assistantCliIds = ["claude-code", "codex"];

package/dist/kernel/ports/host-cli.js

@@ -91,6 +91,9 @@ export const hostImageSchema = z
         .strict())
         .max(4)
         .optional(),
+    // A design's picture to change (`ImageRequest.edit`). A helper from before it refuses the
+    // whole request as invalid rather than drawing a new picture in its place.
+    edit: z.object({ source: bridgedImage }).strict().optional(),
 })
     .strict();
 export const hostOpenFolderSchema = z

package/dist/kernel/ports/interest.js

@@ -0,0 +1,4 @@
+// Public search interest in a topic: the search suggestions offered for it and how often its
+// Wikipedia article is read. Used only by schedules the person set to rank topics by search
+// interest; it sends the topic's title and nothing else. Never a channel's own analytics.
+export {};

package/dist/kernel/ports/languages.js

@@ -61,9 +61,6 @@ export function languageInfo(code) {
 export function projectLanguage(config) {
     return config.language ?? defaultLanguage;
 }
-export function isEnglish(config) {
-    return projectLanguage(config) === defaultLanguage;
-}
 // The line added to every prompt that writes for the audience, when the project is not in
 // English. It is the app's own sentence, added after the user's prompt rather than written
 // into it, so the prompt library stays as the user wrote it; an English project gets nothing,

package/dist/kernel/ports/model.js

@@ -22,12 +22,14 @@ export const providerErrorKinds = [
     "dropped",
     "other",
 ];
+export const modelAccesses = ["no-access", "not-found"];
 export function providerError(init) {
     return Object.assign(new Error(init.message), {
         fault: {
             kind: init.kind,
             ...(init.retryAfterMs === undefined ? {} : { retryAfterMs: init.retryAfterMs }),
             ...(init.planLimit === undefined ? {} : { planLimit: init.planLimit }),
+            ...(init.access === undefined ? {} : { access: init.access }),
         },
     });
 }

package/dist/kernel/ports/settings-places.js

@@ -0,0 +1,31 @@
+// Where a server sentence sends a person to change something: a project's Edit settings and its
+// sections (the web app's project/revision-form.tsx), and Create's rows (play/setup-rows.ts).
+// Named once here, so every refusal and failure says the same path, and a section that is
+// renamed on screen is renamed in its sentences by changing one line. Browser-safe.
+export const editSettings = {
+    open: "Edit settings",
+    title: "Edit settings → Title and keywords",
+    article: "Edit settings → Article",
+    // The one text model a project's AI writing uses: the article, its research, the narration's
+    // preparation, the image prompts, the description, the shorts' picks and the speaker split.
+    writer: "Edit settings → Article → Written by",
+    narration: "Edit settings → Narration",
+    images: "Edit settings → Images",
+    video: "Edit settings → Video and style",
+    look: "Edit settings → Video and style → Look",
+    sound: "Edit settings → Video and style → Sound polish",
+    captions: "Edit settings → Captions",
+    // The thumbnail, the YouTube description, the shorts and the PDF, together as in Create.
+    extras: "Edit settings → Extras",
+    shorts: "Edit settings → Extras → Shorts",
+    checks: "Edit settings → Pauses and checks",
+    channel: "Edit settings → Channel",
+    language: "Edit settings → Channel → Language",
+};
+export const createRows = {
+    article: "Create → Article",
+    narration: "Create → Narration",
+    images: "Create → Images",
+    video: "Create → Video and style",
+    extras: "Create → Extras",
+};

package/dist/kernel/ports/system-speech.js

@@ -30,7 +30,30 @@ const picoVoices = [
     { id: "fr-FR", name: "French", language: "fr-FR" },
     { id: "it-IT", name: "Italian", language: "it-IT" },
 ];
-export const noSpeechFix = "or add an ElevenLabs or OpenAI key in Settings → Providers for a better voice.";
+// OpenAI is named alone: the voices the starter templates set up are OpenAI voices, so its key
+// narrates at once, while ElevenLabs, Cartesia and Inworld also need a voice saved first.
+export const noSpeechFix = "or add an OpenAI key in Settings → Keys & services: its voices work at once and sound better.";
+// How to get a speech program onto this computer from a terminal, for a screen that lists the
+// commands apart from the sentence (the first-run checklist), or undefined where none is
+// installed that way: macOS and Windows have their own, which only a broken setup lacks. The
+// issue sentences below name the fix in words and leave the commands to this.
+export function speechInstall(host) {
+    if (host.platform === "darwin" || host.platform === "win32")
+        return undefined;
+    return host.env.SLOPIFY_CONTAINER === "1"
+        ? {
+            text: "Update Slopify's Docker image, which has one built in:",
+            commands: ["docker compose pull", "docker compose up -d"],
+        }
+        : {
+            text: "Install espeak-ng with one of these:",
+            commands: [
+                "sudo apt install espeak-ng",
+                "sudo pacman -S espeak-ng",
+                "sudo dnf install espeak-ng",
+            ],
+        };
+}
 export async function detectSpeech(given, host) {
     // A probe that throws (a host bridge that cannot run local programs) found nothing.
     const probe = (binary, args, timeoutMs) => Promise.resolve()
@@ -84,8 +107,8 @@ export async function detectSpeech(given, host) {
     return {
         engines,
         issue: host.env.SLOPIFY_CONTAINER === "1"
-            ? `Slopify runs in Docker and this image has no speech program, so the system voice can't narrate. Update the image (docker compose pull, then docker compose up -d), ${noSpeechFix}`
-            : `No speech program was found on this computer, so the system voice can't narrate. Install espeak-ng (for example sudo apt install espeak-ng, sudo pacman -S espeak-ng or sudo dnf install espeak-ng) and reload Settings → Providers, ${noSpeechFix}`,
+            ? `Slopify runs in Docker and this image has no speech program, so the system voice can't narrate. Update Slopify's Docker image, which has one built in, ${noSpeechFix}`
+            : `No speech program was found on this computer, so the system voice can't narrate. Install the free program eSpeak NG, ${noSpeechFix}`,
     };
 }
 async function onPath(probe, binary) {
@@ -185,6 +208,11 @@ export function primaryLanguage(voice) {
 // processes each time is wasted work for something that changes when a program is installed.
 const cacheMs = 60_000;
 const cached = new WeakMap();
+// "Check again" after installing a speech program: the next look runs the programs again
+// instead of answering from the last minute's.
+export function forgetDetectedSpeech(probe) {
+    cached.delete(probe);
+}
 export function detectSpeechCached(probe, host) {
     const now = performance.now();
     const key = [

package/dist/kernel/runner/attempt.js

@@ -1,5 +1,7 @@
+import { errorText } from "../errors.js";
 import { redact } from "../log.js";
 import { isProviderError, providerError } from "../ports/model.js";
+import { editSettings } from "../ports/settings-places.js";
 // The retry policy, in one place. A stage slice is handed the wrapped calls of
 // `providers.ts` and never an adapter, so there is no way round it.
 // Four attempts - the first plus 3 retries - waiting 2 s, 8 s, 30 s.
@@ -111,7 +113,7 @@ function classify(error, expired, opts, limit) {
             kind: "timeout",
             message: opts.streaming === true
                 ? `The ${callee[opts.kind]} sent nothing for ${seconds} seconds, so Slopify stopped waiting. It may be overloaded: wait a few minutes, then use Try again.`
-                : `The ${callee[opts.kind]} did not answer within ${seconds} seconds. It may be overloaded: wait a few minutes, then use Try again, or choose another model in the Providers section of Edit project.`,
+                : `The ${callee[opts.kind]} did not answer within ${seconds} seconds. It may be overloaded: wait a few minutes, then use Try again, or choose another model in ${modelPlace[opts.kind]}.`,
         });
     }
     if (isProviderError(error)) {
@@ -122,6 +124,7 @@ function classify(error, expired, opts, limit) {
             message: redact(error.message),
             ...(error.fault.retryAfterMs === undefined ? {} : { retryAfterMs: error.fault.retryAfterMs }),
             ...(error.fault.planLimit === undefined ? {} : { planLimit: error.fault.planLimit }),
+            ...(error.fault.access === undefined ? {} : { access: error.fault.access }),
         });
     }
     if (unreachable(error)) {
@@ -134,16 +137,23 @@ function classify(error, expired, opts, limit) {
     }
     return providerError({
         kind: "other",
-        message: redact(error instanceof Error ? error.message : String(error)),
+        message: redact(errorText(error)),
     });
 }
 // What the user calls the other end of each kind of call.
 const callee = {
     llm: "AI model",
-    tts: "narration provider",
-    image: "image provider",
+    tts: "voice service",
+    image: "image service",
     video: "image-to-video model",
 };
+// Where a project's settings choose the model of each kind of call.
+const modelPlace = {
+    llm: editSettings.writer,
+    tts: editSettings.narration,
+    image: editSettings.images,
+    video: editSettings.look,
+};
 // Node's `fetch` rejects a request that never reached the server with this TypeError.
 function unreachable(error) {
     return error instanceof TypeError && error.message === "fetch failed";

package/dist/kernel/runner/audition.js

@@ -1,11 +1,12 @@
 import { attempt } from "./attempt.js";
+import { observed } from "./model-access.js";
 const unrecorded = {
     start: () => "audition",
     end: () => { },
 };
 export function auditionVoice(deps, call, signal) {
     const port = deps.registry.tts(call.provider);
-    return attempt({
+    const spoken = attempt({
         work: {
             projectId: "audition",
             revisionId: "audition",
@@ -33,4 +34,5 @@ export function auditionVoice(deps, call, signal) {
         const bytes = new Uint8Array(await new Response(spoken.audio).arrayBuffer());
         return { bytes, container: spoken.container };
     }, { kind: "tts", streaming: port.capabilities.streams });
+    return observed(deps.access, deps.log, { provider: call.provider, family: "tts", model: call.model ?? "" }, spoken, (result) => result.ok);
 }

package/dist/kernel/runner/checkpoint-authority.js

@@ -1,3 +1,4 @@
+import { errorText } from "../errors.js";
 export function createCheckpointAuthority(deps) {
     return {
         beforeClaim: deps.decide,
@@ -13,7 +14,7 @@ export function createCheckpointAuthority(deps) {
                 catch (error) {
                     deps.log.write("error", "checkpoint.wake", {
                         projectId,
-                        detail: error instanceof Error ? error.message : String(error),
+                        detail: errorText(error),
                     });
                 }
             }