@gentbajko/slopify 3.25.9 → 4.1.0

package/dist/slices/studio/settings.js

@@ -1,6 +1,6 @@
 import { randomBytes, timingSafeEqual } from "node:crypto";
 import { z } from "zod";
-import { readSetting, writeSetting } from "../settings/repo.js";
+import { deleteSetting, readJsonSetting, stringListSchema, writeSetting, } from "../settings/repo.js";
 import { playlistUses, studioPlaylistMax, } from "./model.js";
 // Rows of the key/value `settings` table. The playlists travel with a backup; the
 // pairing stays on this machine (`slices/storage/portable.ts`): its token is what lets the
@@ -14,7 +14,7 @@ const pairingSchema = z.object({
 });
 // A channel's own playlists are a row of their own, `studio.playlist.<channelId>`; a channel
 // without one uses the default list above. Each playlist is ticked by default or not; a
-// project's Prepare upload can change which it goes into. A row saved before lists existed
+// project's Copy for YouTube Studio can change which it goes into. A row saved before lists existed
 // holds one name, read as one playlist ticked by default.
 export const studioChannelPlaylistPrefix = `${studioPlaylistKey}.`;
 function playlistKey(channelId) {
@@ -58,31 +58,23 @@ export function readChannelPlaylists(db) {
     return out;
 }
 function storedPlaylists(db, key) {
-    const stored = readSetting(db, key);
-    if (stored === undefined)
+    const stored = readJsonSetting(db, key, storedPlaylistsSchema, null);
+    if (stored === null)
         return null;
-    try {
-        const parsed = storedPlaylistsSchema.safeParse(JSON.parse(stored));
-        if (!parsed.success)
-            return null;
-        if (typeof parsed.data === "string")
-            return parsed.data.trim() === "" ? null : [{ name: parsed.data.trim(), byDefault: true }];
-        return parsed.data.length === 0 ? null : parsed.data;
-    }
-    catch {
-        return null;
-    }
+    if (typeof stored === "string")
+        return stored.trim() === "" ? null : [{ name: stored.trim(), byDefault: true }];
+    return stored.length === 0 ? null : stored;
 }
-// Why a list can't be saved, in words for Settings → YouTube Studio; undefined when it can.
+// Why a list can't be saved, in words for Settings → YouTube Studio and posting; undefined when it can.
 export function studioPlaylistsProblem(list) {
     const long = list.find((one) => one.name.trim().length > studioPlaylistMax);
     if (long !== undefined)
-        return `The playlist name "${long.name.slice(0, 40)}…" is longer than YouTube allows (${String(studioPlaylistMax)} characters). Shorten it in Settings → YouTube Studio.`;
+        return `The playlist name "${long.name.slice(0, 40)}…" is longer than YouTube allows (${String(studioPlaylistMax)} characters). Shorten it in Settings → YouTube Studio and posting.`;
     const seen = new Set();
     for (const one of list) {
         const key = one.name.trim().toLowerCase();
         if (seen.has(key))
-            return `"${one.name.trim()}" is listed twice. Remove one in Settings → YouTube Studio.`;
+            return `"${one.name.trim()}" is listed twice. Remove one in Settings → YouTube Studio and posting.`;
         seen.add(key);
     }
     return undefined;
@@ -100,27 +92,18 @@ export function saveStudioPlaylists(db, list, channelId) {
         .filter((one) => one.name !== "");
     const key = playlistKey(channelId);
     if (value.length === 0) {
-        db.prepare("DELETE FROM settings WHERE key = ?").run(key);
+        deleteSetting(db, key);
         return [];
     }
     writeSetting(db, key, JSON.stringify(value));
     return value;
 }
-// The playlists a project's uploads go into, when its Prepare upload changed them from the
+// The playlists a project's uploads go into, when its Copy for YouTube Studio changed them from the
 // channel's defaults: one row, project id to names.
 export const studioProjectPlaylistsKey = "studio.projectPlaylists";
 export const storedProjectPlaylistsSchema = z.record(z.string().max(64), z.array(z.string().max(studioPlaylistMax)).max(studioPlaylistsMax));
 function projectChoices(db) {
-    const stored = readSetting(db, studioProjectPlaylistsKey);
-    if (stored === undefined)
-        return {};
-    try {
-        const parsed = storedProjectPlaylistsSchema.safeParse(JSON.parse(stored));
-        return parsed.success ? parsed.data : {};
-    }
-    catch {
-        return {};
-    }
+    return readJsonSetting(db, studioProjectPlaylistsKey, storedProjectPlaylistsSchema, {});
 }
 // The channel's playlists, each ticked as this project goes into it: the project's own choice
 // when it made one (a playlist the channel no longer lists is dropped), else the defaults.
@@ -139,29 +122,19 @@ export function saveProjectPlaylists(db, projectId, names) {
     const { [projectId]: _previous, ...others } = projectChoices(db);
     const next = names === null ? others : { ...others, [projectId]: [...names] };
     if (Object.keys(next).length === 0)
-        db.prepare("DELETE FROM settings WHERE key = ?").run(studioProjectPlaylistsKey);
+        deleteSetting(db, studioProjectPlaylistsKey);
     else
         writeSetting(db, studioProjectPlaylistsKey, JSON.stringify(next));
 }
 // The projects whose uploaded clips are real footage (filmed, not generated): ticked in the
-// project's Prepare upload, under AI use. One row holding their ids; YouTube's second AI use
+// project's Copy for YouTube Studio, under AI use. One row holding their ids; YouTube's second AI use
 // case is footage of a real event or place altered by AI (`disclosure.ts`).
 export const studioRealFootageKey = "studio.realFootage";
 // "on" or "off": whether the extension posts and pins each video's comment once it is public.
 export const autoCommentKey = "studio.autoComment";
 function realFootageIds(db) {
-    const stored = readSetting(db, studioRealFootageKey);
-    if (stored === undefined)
-        return [];
-    try {
-        const value = JSON.parse(stored);
-        return Array.isArray(value)
-            ? value.filter((one) => typeof one === "string")
-            : [];
-    }
-    catch {
-        return [];
-    }
+    const value = readJsonSetting(db, studioRealFootageKey, stringListSchema, []);
+    return value;
 }
 export function readRealFootage(db, projectId) {
     return realFootageIds(db).includes(projectId);
@@ -170,25 +143,15 @@ export function saveRealFootage(db, projectId, on) {
     const others = realFootageIds(db).filter((one) => one !== projectId);
     const next = on ? [...others, projectId].sort() : others;
     if (next.length === 0)
-        db.prepare("DELETE FROM settings WHERE key = ?").run(studioRealFootageKey);
+        deleteSetting(db, studioRealFootageKey);
     else
         writeSetting(db, studioRealFootageKey, JSON.stringify(next));
 }
 // The pairing token, made on first read. One per install: a new one (Settings → YouTube
 // Studio → New pairing token) forgets the extension that used the old one.
 export function studioPairing(db) {
-    const stored = readSetting(db, studioPairingKey);
-    if (stored !== undefined) {
-        try {
-            const parsed = pairingSchema.safeParse(JSON.parse(stored));
-            if (parsed.success)
-                return parsed.data;
-        }
-        catch {
-            // A damaged row is replaced below.
-        }
-    }
-    return resetStudioPairing(db);
+    // A damaged row is replaced.
+    return readJsonSetting(db, studioPairingKey, pairingSchema, undefined) ?? resetStudioPairing(db);
 }
 // What is waiting to be filled in Studio is kept per pairing (`queue.ts`): one row,
 // `studio.fillQueue.<token hash>`, so a new token starts with nothing waiting.

package/dist/slices/studio/videos.js

@@ -1,3 +1,4 @@
+import { markUploaded } from "../uploads/repo.js";
 const taskState = (value) => value === "waiting" || value === "done" || value === "failed" ? value : "none";
 // A YouTube video id: 11 letters, digits, `-` and `_`.
 export const videoIdPattern = /^[A-Za-z0-9_-]{11}$/;
@@ -41,15 +42,33 @@ export function recordVideo(db, projectId, short, videoId, at, state = "done") {
        upload_state=CASE WHEN video_id=excluded.video_id AND upload_state='done' THEN 'done'
          ELSE excluded.upload_state END,
        video_id=excluded.video_id, recorded_at=excluded.recorded_at`).run(projectId, slot(short), videoId, at, state);
+    if (short === null && videoOf(db, projectId, null)?.uploadState === "done")
+        markUploaded(db, projectId, true, at);
 }
 // Studio said the upload was scheduled or published. False when no such upload was filled.
-export function confirmUpload(db, projectId, short, videoId) {
-    return (db
+export function confirmUpload(db, projectId, short, videoId, at) {
+    const confirmed = db
         .prepare("UPDATE youtube_videos SET upload_state='done' WHERE project_id=? AND short=? AND video_id=?")
-        .run(projectId, slot(short), videoId).changes > 0);
+        .run(projectId, slot(short), videoId).changes > 0;
+    if (confirmed && short === null)
+        markUploaded(db, projectId, true, at);
+    return confirmed;
 }
-export function forgetVideo(db, projectId, short) {
+// Forgets the video an upload became (deleted on YouTube, or a wrong link). Forgetting a long
+// video that was on YouTube takes the project's uploaded mark off with it; an upload only
+// filled in Studio never set the mark, so forgetting it leaves a mark made by hand.
+export function forgetVideo(db, projectId, short, at) {
+    const was = videoOf(db, projectId, short);
     db.prepare("DELETE FROM youtube_videos WHERE project_id=? AND short=?").run(projectId, slot(short));
+    if (short === null && was?.uploadState === "done")
+        markUploaded(db, projectId, false, at);
+}
+// "Mark not uploaded" (Home, Projects): the long video's link goes with the mark, so the two
+// never disagree. An upload only filled in Studio is not on YouTube and stays.
+export function markNotUploaded(db, projectId, at) {
+    if (videoOf(db, projectId, null)?.uploadState === "done")
+        forgetVideo(db, projectId, null, at);
+    return markUploaded(db, projectId, false, at);
 }
 export function projectVideos(db, projectId) {
     return db
@@ -63,6 +82,18 @@ export function videoOf(db, projectId, short) {
         .get(projectId, slot(short));
     return row === undefined ? undefined : rowOf(row);
 }
+// What the extension reported after setting up Studio's A/B Testing on the video's Details page,
+// asked for from On YouTube or its popup: "started" once filled (the person presses Set test),
+// "failed" with its reason. A failed later attempt keeps a test already set up ("started"), so
+// its result is still read. False when the project has no video recorded for that upload.
+export function setAbState(db, projectId, short, state, message, at) {
+    return (db
+        .prepare(`UPDATE youtube_videos SET
+           ab_state=CASE WHEN ?='failed' AND ab_state='started' THEN 'started' ELSE ? END,
+           ab_message=?, ab_at=?
+         WHERE project_id=? AND short=?`)
+        .run(state, state, message, at, projectId, slot(short)).changes > 0);
+}
 export function setTaskState(db, task, projectId, short, state, message) {
     const column = task === "finish" ? "finish" : "comment";
     db.prepare(`UPDATE youtube_videos SET ${column}_state=?, ${column}_message=? WHERE project_id=? AND short=?`).run(state, message, projectId, slot(short));

package/dist/slices/style-preview/render.js

@@ -1,5 +1,6 @@
 import { copyFileSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { errorText } from "../../kernel/errors.js";
 import { defaultMotionStyle, defaultZoomPercent } from "../admission/rules.js";
 import { isMissingFont, resolveBoldFont, resolveFont } from "../fonts/index.js";
 import { renderShort } from "../shorts/render.js";
@@ -9,7 +10,7 @@ import { planRender } from "../video/plan.js";
 import { renderSlideshow } from "../video/slideshow.js";
 import { bundledSampleAssets, sampleNarrationSeconds } from "./narration.js";
 import { stylePreviewSeconds } from "./schema.js";
-import { previewCues, previewWords } from "./settings.js";
+import { previewCues, previewShots, previewWords } from "./settings.js";
 export class StylePreviewError extends Error {
     reason;
     constructor(reason, message) {
@@ -25,7 +26,6 @@ const previewFrame = {
     "9:16": { width: 270, height: 480 },
     "1:1": { width: 360, height: 360 },
 };
-const shotSeconds = stylePreviewSeconds / 3;
 const chapterTitle = "Chapter one";
 export function ffmpegStylePreview(deps) {
     const assets = deps.assets ?? bundledSampleAssets();
@@ -33,25 +33,32 @@ export function ffmpegStylePreview(deps) {
         try {
             // A real picture is shown for all three shots: the motion, the Look and the captions read
             // on it, and the transition and chapter card still show at the cuts.
-            const images = picture !== undefined
+            const stills = picture !== undefined
                 ? [picture, picture, picture]
                 : settings.format === "9:16"
                     ? assets.tall
                     : assets.wide;
+            // A longer preview shows the stills again in turn.
+            const { shots } = previewShots(settings);
+            const images = settings.short !== undefined
+                ? stills
+                : Array.from({ length: shots }, (_, index) => stills[index % stills.length] ?? "");
+            const machine = await deps.machine?.();
             if (settings.short !== undefined)
-                await renderShortPreview(deps, settings, settings.short, assets, images, output, signal);
+                await renderShortPreview(deps, settings, settings.short, assets, images, output, signal, machine);
             else
-                await renderPreview(deps, settings, assets, images, output, signal);
+                await renderPreview(deps, settings, assets, images, output, signal, machine);
         }
         catch (error) {
             throw explained(deps.log, error);
         }
     };
 }
-async function renderPreview(deps, settings, assets, images, output, signal) {
+async function renderPreview(deps, settings, assets, images, output, signal, machine) {
     mkdirSync(deps.dir, { recursive: true, mode: 0o700 });
     const workspace = mkdtempSync(join(deps.dir, "work-"));
     try {
+        const { shotSeconds } = previewShots(settings);
         const cardFont = settings.chapterCard === null
             ? undefined
             : await resolveFont(deps.paths, settings.chapterCard.fontId);
@@ -60,8 +67,8 @@ async function renderPreview(deps, settings, assets, images, output, signal) {
             gapSeconds: 0,
             edgeSeconds: 0,
             imageSeconds: shotSeconds,
-            zoomPercent: defaultZoomPercent,
-            motionStyle: defaultMotionStyle,
+            zoomPercent: settings.timing?.zoomPercent ?? defaultZoomPercent,
+            motionStyle: settings.timing?.motionStyle ?? defaultMotionStyle,
             images,
             output,
             edit: {
@@ -81,14 +88,14 @@ async function renderPreview(deps, settings, assets, images, output, signal) {
         const edit = {
             ...plan.editList,
             ...previewFrame[settings.format],
-            audio: [{ kind: "body", path: assets.narration, seconds: plan.totalSeconds }],
+            audio: narrationFor(assets.narration, plan.totalSeconds),
         };
         const captions = settings.captions;
         if (captions !== null) {
             const font = await resolveFont(deps.paths, captions.fontId);
             mkdirSync(join(workspace, "fonts"), { mode: 0o700 });
             copyFileSync(font.path, join(workspace, "fonts", `selected${font.extension}`));
-            writeFileSync(join(workspace, "subtitles.ass"), serializeAss(previewCues(captions.text), {
+            writeFileSync(join(workspace, "subtitles.ass"), serializeAss(previewCues(captions.text, plan.totalSeconds), {
                 ...subtitleFrame(settings.format),
                 fontName: font.assName,
                 fontSize: captions.fontSize,
@@ -105,6 +112,7 @@ async function renderPreview(deps, settings, assets, images, output, signal) {
             signal,
             log: deps.log,
             onProgress: () => { },
+            machine,
         });
     }
     finally {
@@ -113,7 +121,7 @@ async function renderPreview(deps, settings, assets, images, output, signal) {
 }
 // The Shorts layout, drawn at the preview's size: the same audio cut, image timing, captions
 // and headline a short gets, from the sample narration.
-async function renderShortPreview(deps, settings, short, assets, images, output, signal) {
+async function renderShortPreview(deps, settings, short, assets, images, output, signal, machine) {
     mkdirSync(deps.dir, { recursive: true, mode: 0o700 });
     await renderShort({
         bin: deps.ffmpeg,
@@ -121,7 +129,7 @@ async function renderShortPreview(deps, settings, short, assets, images, output,
         start: 0,
         end: sampleNarrationSeconds,
         images,
-        imageSeconds: shotSeconds,
+        imageSeconds: stylePreviewSeconds / 3,
         motionStyle: defaultMotionStyle,
         zoomPercent: defaultZoomPercent,
         words: previewWords(short.text),
@@ -134,16 +142,29 @@ async function renderShortPreview(deps, settings, short, assets, images, output,
         signal,
         log: deps.log,
         onProgress: () => { },
+        machine,
     });
 }
+// The six seconds of sample narration back to back under a longer preview, the last cut to
+// what is left.
+function narrationFor(path, seconds) {
+    const pieces = [];
+    for (let at = 0; at < seconds - 0.001; at += sampleNarrationSeconds)
+        pieces.push({
+            kind: "body",
+            path,
+            seconds: Math.round(Math.min(sampleNarrationSeconds, seconds - at) * 1000) / 1000,
+        });
+    return pieces;
+}
 function explained(log, error) {
     if (error instanceof StylePreviewError)
         return error;
-    const message = error instanceof Error ? error.message : String(error);
+    const message = errorText(error);
     if (isMissingFont(error))
-        return new StylePreviewError("font-missing", "The style preview couldn't render because the chosen caption font is no longer available; it may have been uninstalled or deleted. Choose another font under Subtitles, then press Render again.");
+        return new StylePreviewError("font-missing", "The style preview couldn't render because the chosen caption font is no longer available; it may have been uninstalled or deleted. Choose another caption font, then press Make the preview again.");
     if (message.startsWith("Slopify could not start ffmpeg") || /\bENOENT\b/.test(message))
-        return new StylePreviewError("ffmpeg-missing", "The style preview couldn't render because ffmpeg wasn't found. Install ffmpeg, or use the Docker image, then press Render again.");
+        return new StylePreviewError("ffmpeg-missing", "The style preview couldn't render because ffmpeg wasn't found. Install ffmpeg, or use the Docker image, then press Make the preview again.");
     log.write("error", "style-preview.render", { detail: message });
-    return new StylePreviewError("render-failed", "The style preview couldn't render because ffmpeg stopped with an error. Press Render again; if it fails again, use Download diagnostics in Settings and report it.");
+    return new StylePreviewError("render-failed", "The style preview couldn't render because ffmpeg stopped with an error. Press Make the preview again; if it fails again, use Download diagnostics in Settings and report it.");
 }

package/dist/slices/style-preview/schema.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { formats } from "../../kernel/pipeline.js";
+import { motionStyles } from "../admission/model.js";
 import { videoEditSchema } from "../admission/schema.js";
 import { subtitleModes, subtitlePositions } from "../subtitles/model.js";
 // "See it before you make it": a few seconds rendered by the real renderer with a project's
@@ -8,6 +9,8 @@ import { subtitleModes, subtitlePositions } from "../subtitles/model.js";
 // How long the preview runs: three images of two seconds, so a transition and a chapter
 // card both show, under six seconds of the sample narration.
 export const stylePreviewSeconds = 6;
+// The longest preview: the template studio's 30-second video sample.
+export const stylePreviewSecondsMax = 30;
 export const stylePreviewTextMax = 200;
 // The sample text Play starts with. It, or no text, captions the sample narration with its own
 // words; any other text is spread over the stretches the narration speaks.
@@ -47,7 +50,17 @@ export const stylePreviewRequestSchema = z.object({
         title: z.string().max(shortTitlePreviewMax).optional(),
     })
         .optional(),
-    // Render again even when this exact preview is already saved.
+    // How long it runs, in whole seconds; absent is six. The Shorts layout ignores it.
+    seconds: z.number().int().min(stylePreviewSeconds).max(stylePreviewSecondsMax).optional(),
+    // The run's own picture timing and motion; absent is two-second shots with the defaults.
+    timing: z
+        .object({
+        imageSeconds: z.number().finite().min(1).max(120),
+        zoomPercent: z.number().finite().min(0).max(100),
+        motionStyle: z.enum(motionStyles),
+    })
+        .optional(),
+    // Make the preview again even when this exact preview is already saved.
     force: z.boolean().optional(),
 });
 export const stylePreviewReplySchema = z.object({

package/dist/slices/style-preview/service.js

@@ -1,6 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { mkdirSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { errorText } from "../../kernel/errors.js";
 import { normalizeStylePreview, previewSeconds, stylePreviewHash } from "./settings.js";
 // Rendered previews are kept in the data folder by the hash of their settings, so a setting
 // changed back, or the same style in another project, plays at once. `force` renders again
@@ -86,7 +87,7 @@ function prune(deps) {
     }
     catch (error) {
         deps.log.write("warn", "style-preview.prune", {
-            detail: error instanceof Error ? error.message : String(error),
+            detail: errorText(error),
         });
     }
 }

package/dist/slices/style-preview/settings.js

@@ -61,8 +61,27 @@ image) {
             },
         chapterCard: edit.chapterCards ? { fontId: subtitles.fontId } : null,
         ...(image === undefined ? {} : { image }),
+        ...(request.seconds === undefined || request.seconds === stylePreviewSeconds
+            ? {}
+            : { seconds: request.seconds }),
+        ...(request.timing === undefined
+            ? {}
+            : {
+                timing: {
+                    imageSeconds: Math.round(request.timing.imageSeconds * 10) / 10,
+                    zoomPercent: Math.round(request.timing.zoomPercent * 10) / 10,
+                    motionStyle: request.timing.motionStyle,
+                },
+            }),
     };
 }
+// The shots a preview is cut into: two seconds each by default, else the run's own picture
+// length, as many as fill its seconds (at least one).
+export function previewShots(settings) {
+    const seconds = settings.seconds ?? stylePreviewSeconds;
+    const shotSeconds = settings.timing?.imageSeconds ?? stylePreviewSeconds / 3;
+    return { shotSeconds, shots: Math.max(1, Math.round(seconds / shotSeconds)) };
+}
 // JSON with every object's keys in order, so equal settings always hash alike.
 export function stableJson(value) {
     if (Array.isArray(value))
@@ -80,9 +99,10 @@ export function stylePreviewHash(settings) {
 }
 // How long the rendered preview runs: a Shorts preview at a higher speed is shorter.
 export function previewSeconds(settings) {
-    return settings.short === undefined
-        ? stylePreviewSeconds
-        : round(stylePreviewSeconds / settings.short.speed);
+    if (settings.short !== undefined)
+        return round(stylePreviewSeconds / settings.short.speed);
+    const { shotSeconds, shots } = previewShots(settings);
+    return round(shotSeconds * shots);
 }
 // ceiling: a pause this long between two words of the sample narration starts a new phrase,
 // the same pause `captionCues` starts a new cue at.
@@ -131,8 +151,16 @@ export function previewWords(text, narration = sampleNarrationWords) {
     }
     return timed;
 }
-export function previewCues(text) {
-    return captionCues(previewWords(text));
+// The captions of `seconds` of preview: the six seconds' words again every six seconds, as the
+// sample narration repeats under a longer preview.
+export function previewCues(text, seconds = stylePreviewSeconds) {
+    const once = previewWords(text);
+    const words = [];
+    for (let start = 0; start < seconds; start += stylePreviewSeconds)
+        for (const word of once)
+            if (start + word.end <= seconds)
+                words.push({ ...word, start: round(start + word.start), end: round(start + word.end) });
+    return captionCues(words);
 }
 function round(value) {
     return Math.round(value * 1000) / 1000;

package/dist/slices/subtitles/captions.js

@@ -24,7 +24,7 @@ export function captionCues(words) {
             !Number.isFinite(word.end) ||
             word.start < previousEnd - 0.001 ||
             word.end <= word.start) {
-            throw new Error("The saved caption timing is damaged. Use More → Render the video again in the Video section to time them again, then Try again.");
+            throw new Error("The saved caption timing is damaged. Press Make the video again in the project's Video section to time them again, then Try again.");
         }
         const first = pending[0];
         if (first !== undefined &&

package/dist/slices/telemetry/collector-client.js

@@ -1,3 +1,4 @@
+import { errorText } from "../../kernel/errors.js";
 // The collector URL is built into the release and is not user
 // configurable. The environment variable below is a test seam, not a documented knob:
 // packages/app/test/telemetry-flush.test.ts points it at a fake collector.
@@ -42,10 +43,7 @@ export function httpPostEvents(endpoint, timeoutMs) {
         catch (error) {
             // Offline is the ordinary case, not a fault: the events stay queued and the user is
             // told nothing.
-            return { ok: false, retriable: true, reason: messageOf(error) };
+            return { ok: false, retriable: true, reason: errorText(error) };
         }
     };
 }
-function messageOf(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/dist/slices/telemetry/flush.js

@@ -1,3 +1,4 @@
+import { errorText } from "../../kernel/errors.js";
 import { machineOf, markDelivered, undeliveredEvents } from "./repo.js";
 // ceiling: 200 events per request against the collector's cap of 500, and at most 25
 // requests per flush. A queue longer than 5000 undelivered events drains over several
@@ -75,7 +76,7 @@ export function createFlusher(deps, delayMs) {
             .catch((error) => {
             // The timer has no caller to fail: a broken flush is logged and the next one
             // tries again.
-            deps.log.write("warn", "telemetry.flush", { detail: messageOf(error) });
+            deps.log.write("warn", "telemetry.flush", { detail: errorText(error) });
         })
             .finally(() => {
             running = false;
@@ -106,6 +107,3 @@ function envelope(event, machineId) {
         createdAt: event.createdAt,
     };
 }
-function messageOf(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/dist/slices/telemetry/model.js

@@ -8,13 +8,6 @@ export const telemetryEventTypes = ["install", "project.created", "stage.complet
 // writes the intro and outro texts, the audio stage narrates all three - so the event type
 // stays `stage.completed` and the pair (stage, segment) says which unit it is.
 export const audioSegments = ["body", "intro", "outro"];
-export const noTokens = { tokensIn: 0, tokensOut: 0 };
-export function plusUsage(tokens, usage) {
-    return {
-        tokensIn: tokens.tokensIn + (usage?.inputTokens ?? 0),
-        tokensOut: tokens.tokensOut + (usage?.outputTokens ?? 0),
-    };
-}
 // The whole privacy surface. API keys, prompt bodies, keyword values, titles, article and
 // research text, files, filenames, OS, locale and hardware are all barred from a payload,
 // which is exactly what the first-run notice promises. The schema below is strict, so a

package/dist/slices/telemetry/record.js

@@ -1,3 +1,4 @@
+import { errorText } from "../../kernel/errors.js";
 import { payloadSchema } from "./model.js";
 import { insertTelemetryEvent, machineOf } from "./repo.js";
 // Appends one row to the local queue and hands it back. Throws: the notice dismissal
@@ -32,10 +33,16 @@ export function record(deps, type, counters) {
     }
     catch (error) {
         deps.log.write("warn", "telemetry.record", {
-            detail: `${type}: ${messageOf(error)}`,
+            detail: `${type}: ${errorText(error)}`,
         });
     }
 }
-function messageOf(error) {
-    return error instanceof Error ? error.message : String(error);
+// A template studio sample (or bake-off copy) is the studio's, not a video of the person's:
+// Settings → Usage and the public counters leave its stages out.
+export function skippingProjects(count, skipped) {
+    return (type, counters, projectId) => {
+        if (projectId !== undefined && skipped(projectId))
+            return;
+        count(type, counters, projectId);
+    };
 }