@gentbajko/slopify 3.25.9 → 4.0.0

package/dist/tutorials/Settings-Reference.md

@@ -10,12 +10,13 @@ Every section of Settings, what each control does and its default. Sections with
 |---|---|---|---|
 | Connections | [Providers](#providers) | API keys, command-line tools, the system voice, health check | [Providers-and-Keys](Providers-and-Keys), [AI-CLIs](AI-CLIs) |
 | Connections | [Voices](#voices) | Voice IDs for narration | [Providers-and-Keys](Providers-and-Keys#add-a-voice) |
-| Connections | [Models](#models) | Model catalogue, retired models | [Models](Models) |
+| Connections | [Models](#models) | Model catalogue, retired models, models that work for you | [Models](Models) |
 | Connections | [Agents (MCP)](#agents-mcp) | The MCP address and setup lines for Claude Code and Codex, the last connection, what agents did | [Agents-MCP](Agents-MCP) |
-| Production defaults | [Production defaults](#production-defaults) | Silence gap, volume levelling for new runs | This page |
+| Production defaults | [Production defaults](#production-defaults) | Silence gap, volume levelling for new runs, the caption timing model, how this computer renders | This page |
+| Production defaults | [Template studio](#template-studio) | The most a template's samples, and a designed piece template's, may spend in a day, and whether they may use CLI plans | This page |
 | Notifications | [Notifications](#notifications) | Browser and phone notifications | [Notifications](Notifications) |
 | Publishing | [Channel links](#channel-links) | A pointer to each channel's own links | [Channels](Channels#channel-links) |
-| Publishing | [YouTube Studio](#youtube-studio) | Playlists per channel, the Studio extension's download and pairing | [Studio-Extension](Studio-Extension) |
+| Publishing | [YouTube Studio and posting](#youtube-studio-and-posting) | Playlists per channel, the Studio extension's download and pairing | [Studio-Extension](Studio-Extension), [Posting-to-Social-Sites](Posting-to-Social-Sites) |
 | Backup & storage | [Backup & storage](#backup--storage) | Your files folder, daily backups, export and import, disk space, samples | [Where-Your-Files-Live](Where-Your-Files-Live), [Backups](Backups) |
 | Backup & storage | [Trash](#trash) | Deleted items, kept 30 days | [Trash](Trash) |
 | General | [General](#general) | Light or dark, and starting Slopify when you log in | [Start-at-Login](Start-at-Login) |
@@ -51,6 +52,18 @@ You can also press `Ctrl+K` and run **Download diagnostics** from anywhere in Se
 
 In Docker, this section only shows whether Docker starts at login ("Starts with Docker: yes / no / unknown"), when the installer checked, and where to change that. With Docker Desktop it names Docker Desktop's own setting: Docker Desktop → Settings → General → **Start Docker Desktop when you sign in to your computer**. Slopify starts whenever Docker does and never changes Docker's own settings. See [Start-at-Login](Start-at-Login).
 
+### Remote access
+
+"Open Slopify on your phone or laptop through Tailscale, only inside your tailnet." It is the second tab of **General**.
+
+| Control | What it does | Default |
+|---|---|---|
+| **Open on my other devices (Tailscale)** | Has the Tailscale already on this computer serve Slopify's page at `https://<computer>.<tailnet>.ts.net`, reachable only from devices signed in to your tailnet. Shows the address with **Copy address** and a QR code. Uses Tailscale Serve, never Funnel. Turning it off removes only the serve setting Slopify added. | Off |
+| **Use port 8443** | Shown when another Tailscale serve setting already uses HTTPS port 443: gives Slopify its own address on another port and leaves yours alone. | - |
+| **Check again** | Asks Tailscale again after you fixed what the notice says. | - |
+
+See [Remote-Access](Remote-Access).
+
 ## Providers
 
 "Keys stay on this machine and go only to their provider. Readiness is checked again before each run."
@@ -97,6 +110,9 @@ See [Providers-and-Keys](Providers-and-Keys#add-a-voice).
 | **Catalogue file**, **Verified**, **Last checked** | Where the file is, when its prices were verified, and what the last check changed. |
 | **Switch to <model>** | Replaces one retired model choice with the suggestion shown. |
 | **Switch all** | Replaces every retired choice that has a suggestion. |
+| **Check models** (per provider) | Sends each of that provider's models one tiny request to learn whether it works for your key or CLI. When that costs money the price is shown first and nothing is sent until you confirm. See [Models](Models#models-that-work-for-you). |
+| **Automatic checks** | **Free and near-free checks only** (default): free and sub-cent checks run by themselves when a key or CLI is added and weekly. **Off**: only when you choose Check models. See [Models](Models#automatic-checks). |
+| **New for you**, **Dismiss** | Models that started working for you since the first check; Dismiss clears one, **Dismiss all** every one. |
 
 Templates and schedules that pick a retired model are also flagged on their own rows, with the same **Switch to <model>**. See [Models](Models).
 
@@ -116,7 +132,7 @@ There is nothing to turn on: the address works whenever Slopify runs. See [Agent
 
 ## Production defaults
 
-"How new runs pace the narration and level the volume, and which model times English captions."
+"How new runs pace the narration and level the volume, which model times English captions, and how this computer renders."
 
 ### Silence between segments
 
@@ -144,6 +160,32 @@ The volume fields show only while the switch is on. A project keeps what it star
 
 The chosen model downloads once, the first time captions are timed (or when Slopify starts, unless `SLOPIFY_NO_MODEL_PREFETCH` is set), and is kept in `<data folder>/models/english-subtitles/`. A model already downloaded stays there when you switch, so switching back costs nothing. Smallest can mishear a line and stop a run with "Subtitles stopped matching the audio" where the narration is fine. Changing the model never marks finished subtitles outdated, and a timing that is already running finishes with the model it started with; the next one uses the new choice. It is a setting of this computer, not of a project. Other languages use their own model and are not affected. Changes save as you make them.
 
+### Rendering
+
+How this computer encodes videos and shorts. Like the subtitle timing model, these belong to the computer, not a project: no project copies them, and changing them never marks anything outdated, because they change how a video is made, not what it is. A render reads them once as it starts; one already running finishes as it began. Changes save as you make them.
+
+| Control | What it does | Default / range |
+|---|---|---|
+| **Video encoder** | What turns the frames into the finished file. **Processor (x264)** is the one every computer has. **NVIDIA graphics card (NVENC)** encodes on the card at its highest-quality settings (preset p7, tune hq, constant quality) and leaves the processor for the rest of the render. It is listed only when Slopify finds an ffmpeg with NVENC (its own, else the `ffmpeg` on your `PATH` or `/usr/bin/ffmpeg`) that passes a tiny test encode; otherwise the line under it says "No NVIDIA encoder found on this computer." | Processor (x264) |
+| **Clip encoding** | How hard the processor works on each image's clip before the captions are burned in over them. **Thorough** is x264's medium preset; **Fast** is its veryfast preset at the same quality setting (CRF 16). Only the clips under burned-in captions change; the burned-in encode that makes the finished picture is the same. Has no effect with the NVIDIA encoder. | Thorough |
+| **Render priority** | **Background (your other programs come first)** runs every ffmpeg of a video, short or audio export, its volume mastering included, below normal priority, and that of the style preview, Template Studio's free samples, designs and posts' pictures too (nice 10 on Linux and macOS, below-normal on Windows): your browser, games and other programs take the processor first and the render gets what is left. **Normal** competes with them as an equal. The finished video is the same either way. | Background |
+
+What they cost and give, measured on two minutes of a real project with captions burned in (32-core processor, RTX 5080): **Fast** halved the clips' processor time and cut the whole render's by 30% (10 to 17% less waiting), for a slightly softer picture (0.9 VMAF less) at the same file size. **NVIDIA** cut the render's processor time by 80% and its waiting by a quarter (the zoom and pan on each image still runs on the processor), at about the same file size, but with a visibly softer picture than x264 (about 2.5 VMAF less): pick it when keeping the computer free matters more than the last bit of sharpness. **Background** makes no difference to the file at all.
+
+If the NVIDIA encoder is chosen but stops working (a driver update, the card busy elsewhere), the render is made on the processor instead, never failed, and the video's section on the project page says: "This video was encoded on the processor because the NVIDIA graphics card encoder didn't work (…). Check the NVIDIA driver, or choose Processor (x264) in Settings → Production defaults → Video encoder." Slopify checks for the card once per start; restart Slopify after installing a driver or an ffmpeg with NVENC.
+
+Agents read and change these with `get_settings` and `update_settings`, and check the card with `get_video_encoders`.
+
+### Template studio
+
+| Control | What it does | Default / range |
+|---|---|---|
+| **Daily sample budget** | The most a template's samples, **Compare models** and **Make samples for all** may spend in one day, in US dollars, counted from midnight on this computer. At $0.00 no sample spends money. Below it: what the samples spent today and what is left. Type an amount and choose **Save**. | $2.00, $0 to $1,000 |
+| **Designed pieces: daily sample budget** | The most the samples of designed-piece templates (Library → Designs) may spend in one day, in US dollars, counted from midnight on this computer. It is separate from the budget above. Below it: what those samples spent today and what is left. Type an amount and choose **Save designed pieces' budget**. | $1.00, $0 to $1,000 |
+| **Samples may use my CLI plans** | Whether those samples, designed pieces' included, may run steps on your Claude Code or Codex plan. Plan usage has no dollar price, so the budgets can't limit it: off, a sample with such a step waits; on, it runs on your plan whatever the budget. | Off |
+
+A sample that would go over the budget is not made: the template's studio shows it **Waiting** with "this sample costs about $0.40 and $0.10 of today's $2.00 sample budget is left", and **Make sample** makes it once there is room again. A sample with a step on a CLI plan waits the same way while **Samples may use my CLI plans** is off. A designed piece template's sample over its own budget waits in the template's editor the same way, and **Make sample** makes it anyway. Only samples count; your projects and designed pieces never do.
+
 ## Notifications
 
 "When a run finishes, fails, or waits for you."
@@ -162,9 +204,9 @@ Messages hold the project title and what happened, never your keys. See [Notific
 
 Each channel now keeps its own links, on its **Brand** tab under **Channel links**. This section only says so, with **Open the default channel's links**. Links saved here in an earlier version still fill the default channel's descriptions until you save its Brand tab. See [Channels](Channels#channel-links) and [YouTube-Description](YouTube-Description).
 
-## YouTube Studio
+## YouTube Studio and posting
 
-"The playlists upload packs offer, and the Studio extension's pairing."
+"The playlist upload packs name, and the Studio extension's pairing for YouTube Studio and other sites."
 
 | Control | What it does | Default / limit |
 |---|---|---|
@@ -172,9 +214,9 @@ Each channel now keeps its own links, on its **Brand** tab under **Channel links
 | **Playlists** | The YouTube playlists upload packs offer, each typed exactly as it is called in Studio. Pick **Every channel (default)** or one channel first: the default list is used by every channel without its own. **Add playlist** adds a row; **On by default** puts every project into it; **Remove** drops it; **Save playlists** stores the list. A project's **Prepare upload** changes which ones it goes into. | None; up to 20, each up to 150 characters |
 | **Extension pairing token** | A secret the Slopify Studio extension needs before it may read your upload packs. **Copy** it into the extension's options and press Pair there. | |
 | **New pairing token** | Makes a fresh token, unpairs the extension until you paste the new one, and clears the uploads waiting for Studio. | |
-| **Install the Studio extension** | **Chrome, Edge, Brave** or **Firefox**, then **Download for Chrome** or **Download for Firefox**, with the three install steps. | |
+| **Install the Studio extension** | **Chrome, Edge, Brave** or **Firefox**, then **Download for Chrome** or **Download for Firefox**, with the three install steps, and a line on allowing posting: to fill posts on X, LinkedIn, Instagram, TikTok, Reddit or Bluesky, press **Allow posting on** each site in the extension's options. | |
 
-See [Studio-Extension](Studio-Extension) and [Publishing-to-YouTube](Publishing-to-YouTube).
+See [Studio-Extension](Studio-Extension), [Publishing-to-YouTube](Publishing-to-YouTube) and [Posting-to-Social-Sites](Posting-to-Social-Sites).
 
 ## Backup & storage
 

package/dist/tutorials/Template-Studio.md

@@ -0,0 +1,125 @@
+# Template studio
+
+The template studio is where a template is set up once, section by section, with a live sample beside every setting, then marked ready for its schedules. Each change you save is made again on a short hidden sample, so you see and hear what the next video will be like before a schedule spends anything on it.
+
+**Where to find it:** **Library → Templates**, then **Open studio** on a template's row. Saving a setup as a template from Play or a project opens its studio too.
+
+## The sections
+
+The rail on the left lists the template's sections in the order a run makes them:
+
+| Section | What it sets |
+|---|---|
+| **Subject & research** | The title pattern (`History: {{Topic}}`), keyword values, research on or off |
+| **Script** | Written by AI or pasted, the text model, the article prompt, the expected length |
+| **Voice** | The voice, the narration model, loudness, breaths and S sounds, pronunciations |
+| **Pictures** | Made by AI, added by you or off; the picture model, image prompts, scenes |
+| **Video & captions** | Format, captions, motion, seconds per picture, the Look |
+| **Thumbnail & title** | How the thumbnail is made, one or three of them |
+| **Shorts** | Shorts from the video, how many |
+| **Document (PDF)** | A PDF made from the script, and its theme |
+| **Reviews & checkpoints** | Automatic reviews and where a run waits for you |
+| **Upload pack** | The YouTube description, chapters and tags, and the other sites the projects post to (**Post to**), each with its text and main media; hashtags, the thumbnail and the YouTube link are under Fine-tune. The sample shows each site's post as the site shows it. See [Posting to social sites](Posting-to-Social-Sites). |
+| **Schedule** | The next five runs of each schedule that uses the template, and what they cost a month |
+
+Each section shows two to four settings. Everything else is under **Fine-tune**, which holds Play's own editor for that section, so no setting is lost. **Made with OpenRouter · model · Change** says which provider makes the section; **Change** opens Fine-tune.
+
+Each section's lamp says where its sample is: **Current** (made for this version), **Making**, **Waiting** (queued, or held with the reason), **Needs a fix** (the failed step's own sentence and the button that fixes it), **No current sample** (made for an older version, or none yet), **Off**, or **Provided** (you add the file in Play for each video, so there is no sample to make).
+
+On a narrow window the studio shows **Sections · Settings · Sample** tabs instead of three columns.
+
+## Samples
+
+Two kinds of sample are made for each version.
+
+**Free samples** are made on this computer and cost nothing: a 30-second clip in the template's frame, captions, Look and picture timing on Slopify's sample pictures; the loudness before and after; the PDF in the template's theme; and each schedule's cost a month. They are made by themselves when a version is opened.
+
+**The paid sample** is a short taste of one video about the sample topic, made with your keys on a hidden project that never appears in Projects, Home, the calendar, usage or anywhere else:
+
+- the outline and chapter 1 of the script (or the full script, see below),
+- about 30 seconds of narration,
+- up to 4 pictures, 1 thumbnail and 1 short,
+- no checkpoints; an agent's reviews are not asked.
+
+After the first one, a Save makes again only what the change outdates. Work already going is never stopped: a newer Save waits for it.
+
+### Sample topic
+
+The chip in the header, **Sample topic: The history of the lighthouse**, is what every sample is about. Press it to type another, take the next topic a schedule has queued, or go back to the fixed one. A new topic makes every sample again and is priced on **Use topic**; going back to the fixed one is free.
+
+### Write the full script in the sample
+
+Under **Script**, **Write the full script in the sample** has the sample write the whole script instead of the outline and chapter 1, priced on the switch. Only the script and what is made from it are made again. Your videos always get the full script.
+
+### Say it as
+
+Under **Voice**, **Say it as** lists the names the sample's script says that a voice may get wrong, each with the line it is in. **Play** one to hear it, type how it should be said and press **Save**: that writes a Library → Narration aliases row (used by every project started after it) and voices again only the sample's lines that say it, priced on the button. **Another word to check** adds a name of your own.
+
+### Prompt anatomy
+
+**Prompt anatomy** under a section's settings cuts the prompt the sample sent into who wrote each part: your own words, your keywords' values, what Slopify filled in (such as the sample's "outline and chapter 1 only" instruction) and what settings added.
+
+## Budget and prices
+
+Every paid sample is priced before anything is spent:
+
+- **Save** says what it costs, for example **Save · about $0.12**, or **Save · plan usage** when only a CLI plan is used. **Save without a sample** saves and makes only the free samples.
+- A sample that costs more than a quarter more (plus five cents) than the price you saw, or has a step with no known price you didn't accept, waits instead of starting, with the new price on **Make sample**.
+- **Settings → Template studio → Daily sample budget** is the most the studio may spend in one day ($2.00 by default). A sample past it waits until the next day or a higher budget. What a removed sample or a discarded comparison was charged today still counts. See [Settings-Reference](Settings-Reference#template-studio).
+
+**Make samples for all** in Settings → Template studio prices the samples of every template that needs one, together, and queues the ones that fit today's budget.
+
+## Mark ready
+
+Until you mark a version of a template ready for the first time, its schedules run its newest version, checked or not, as they always did, and the header says **Not checked in the studio: schedules run the newest version**. Pressing **Mark ready** once turns the check on for that template: from then on a schedule runs only a version marked ready (or one saved before the studio existed, or one Slopify carried over), and every version you save later waits for **Mark ready**.
+
+**Mark ready** in the header is greyed, with the reason, until:
+
+- every free check passes: keywords are filled, the providers are set up, the narration's voice is one of yours (Settings → Voices), each run has release times, the monthly cost is known, and someone answers each checkpoint (a notification address, or an agent seen in the last week),
+- and every section's sample is current, off or provided.
+
+Each failing check names what is wrong with a button to the place it is fixed. Once marked, schedules run that version from their next run. Saving again makes a new version that waits to be marked ready; until then the schedules keep running the one marked ready, and the header says **Not checked in the studio · schedules run version 6**.
+
+When Slopify changes a template itself (a retired model switched in Settings → Models, a restore from the trash under a new name), the new version keeps the ready mark of the one it came from, and its changed sections say who made the change. A retired model is switched in the version your schedules run too, even while a newer version waits to be marked ready.
+
+## Compare models
+
+**Compare models**, beside the model of **Script**, **Voice** or **Pictures**, makes that section's sample again with one or two other models, each on a hidden copy of the sample, so you can compare what each one makes, what it was charged and how long it took, beside the model the template uses now.
+
+1. Save first: models are compared on the saved version's sample, so it must be current.
+2. Press **Compare models** and pick one or two models. The list shows the models that work for your key or CLI first. Voice models are compared within the template's voice provider, because a voice is chosen per provider.
+3. The drawer prices it, for example **Compare · about $0.04**, and shows what is left of today's budget. Press it to start.
+4. **Compared models** lists each model with **Made · $0.008 charged · 12 s** and what it made (the script's opening, the narration, the pictures).
+5. **Use this model** switches the section to that model and discards the copies; press **Save** to make the template's own sample with it, at the price on the button. **Discard** removes the copies without changing anything.
+
+Only the section's own work runs on each copy. A comparison is held, spending nothing, on the same rules as a sample (a higher price, an unknown price you didn't accept, past today's budget), and a Save made before it starts takes its place. Work already going is never stopped, so **Discard** waits until it finishes.
+
+**Settings → Models → New for you** has **Compare on a sample** on each new model: pick a template and its studio opens with Compare models ready for that model.
+
+## Template packs
+
+A template pack is a template as one .zip file, to share with someone else or move to another computer.
+
+**Export pack** in the studio's header saves the version marked ready (the button says which when a newer one waits): its prompts' and intros' text as your Library has them now, the voice it picks, the Look, the PDF theme, and its sample's thumbnail, up to four pictures and its narration. No key, login or other file of yours goes in; a template whose text looks like a key is refused, with where to remove it. A template with no version marked ready (and none saved before the studio) can't be exported yet.
+
+**Import template pack** on Library → Templates makes a new template from a pack:
+
+- Its prompts and intros join your Library. One whose name your Library already uses for other text comes in as "name (2)", and the template uses that one.
+- Its voice is used as it is. When Settings → Voices has no voice with that ID, the studio's Voice check says so: add the voice there under that ID, or choose one of yours.
+- It opens in its studio with **Samples from the pack**, what the person who exported it got, until your own samples are made.
+- It is not checked in the studio yet: look it over and press **Mark ready**.
+
+A file larger than 30 MB, one that isn't a pack, one made by a newer Slopify, or one holding anything that looks like a key is refused, and nothing is imported.
+
+## Design templates
+
+Design templates (posters, flyers and other designed pieces) are listed on Library → Templates below the project templates, each with **Open studio**. Their studio has four sections, **Picture**, **Text layout**, **Formats** and **Schedule**, with the same rail of lamps, a live sample and Mark ready. See [Templates](Templates).
+
+## Related pages
+
+- [Templates](Templates)
+- [Schedules](Schedules)
+- [Models](Models)
+- [Costs and run cost](Costs-and-Run-Cost)
+- [Narration aliases and glossary](Narration-Aliases-and-Glossary)
+- [Settings reference](Settings-Reference#template-studio)

package/dist/tutorials/Templates.md

@@ -2,6 +2,8 @@
 
 A template is a saved Play setup: prompts, voice, images, style, outputs, reviews and checkpoints, under a name. Pick it on Play, type a topic, and the video is set up the way you like it. Schedules run templates too, so a template is also the recipe every scheduled video follows.
 
+Set a template up section by section, with a live sample beside every setting, in its [Template studio](Template-Studio): **Open studio** on its row.
+
 **Where to find it:** **Library → Templates**. You also pick templates at the top of **Play**, save them from Play's right rail or a project's **More** menu, and move them between channels on a channel's **Templates** tab.
 
 ## What a template keeps
@@ -139,6 +141,7 @@ Adding a pack twice changes nothing, and a pack never replaces a prompt or templ
 
 ## Related pages
 
+- [Template studio](Template-Studio)
 - [Play overview](Play-Overview)
 - [Schedules](Schedules)
 - [Channels](Channels)

package/dist/tutorials/_Sidebar.md

@@ -8,6 +8,7 @@
 - [Home and Projects](Home-and-Projects)
 - [Where your files live](Where-Your-Files-Live)
 - [Start at login](Start-at-Login)
+- [Remote access](Remote-Access)
 - [Updating and patch notes](Updating-and-Patch-Notes)
 - [Uninstalling and moving](Uninstalling-and-Moving)
 
@@ -43,12 +44,15 @@
 **Publishing**
 - [Publishing to YouTube](Publishing-to-YouTube)
 - [Studio extension](Studio-Extension)
+- [Posting to social sites](Posting-to-Social-Sites)
 
 **Automation**
 - [Templates](Templates)
+- [Template studio](Template-Studio)
 - [Schedules](Schedules)
 - [Calendar](Calendar)
 - [Notifications](Notifications)
+- [Assistant](Assistant)
 - [Agents (MCP)](Agents-MCP)
 - [Backups](Backups)
 
@@ -59,6 +63,7 @@
 **Library**
 - [Library overview](Library-Overview)
 - [Prompts](Prompts)
+- [Keywords Slopify fills](Keywords-Slopify-Fills)
 - [Intros and outros](Intros-and-Outros)
 - [Aliases and glossary](Narration-Aliases-and-Glossary)
 - [Document themes](Document-Themes)

package/dist/updater/work-in-progress.js

@@ -1,50 +1,57 @@
 import { derive } from "../kernel/runner/graph.js";
 import { projectPaused, stagesOf } from "../slices/admission/repo.js";
+import { sampleOwner } from "../slices/template-studio/repo.js";
 // A scheduled run this close is treated as running: a restart then could land on its time,
 // and a schedule that skips missed runs would skip it.
 export const scheduledSoonMs = 10 * 60_000;
 // What an update must wait for, named for "installs when … finishes"; undefined when nothing
 // is. An update never installs while a job is going: a step running or about to run, a step
 // waiting to try again, a batch with videos still to make, a narration chunk about to be
-// recorded again, a schedule writing topics or due to start a run.
-export function workInProgress(db, inflight, now) {
+// recorded again, a schedule writing topics or due to start a run, a picture being made, and
+// what `live` names (model checks, an assistant answer). A template studio's hidden sample is
+// named as the studio's, never by its own title.
+export function workInProgress(db, inflight, now, live) {
     const projects = db
         .prepare("SELECT id, title FROM projects WHERE id NOT IN (SELECT project_id FROM project_trash)")
         .all()
         .flatMap((row) => typeof row.id === "string" && typeof row.title === "string"
         ? [{ id: row.id, title: row.title }]
         : []);
+    const nameOf = (project) => {
+        const owner = sampleOwner(db, project.id);
+        return owner === undefined ? project.title : `the studio sample of ${owner.name}`;
+    };
     for (const project of projects) {
         if (inflight(project.id))
-            return project.title;
+            return nameOf(project);
         if (projectPaused(db, project.id))
             continue;
         // Running, or waiting to try a step again (`derive`); or between two steps, with work
         // admitted and free to start. Work held for a person (a review checkpoint) doesn't count.
         const state = derive(stagesOf(db, project.id));
         if (state === "running")
-            return project.title;
+            return nameOf(project);
         if (state === "pending" &&
             db
                 .prepare("SELECT 1 FROM revision_work WHERE project_id=? AND state IN ('pending','running') AND dispatch_state='allowed' LIMIT 1")
                 .get(project.id) !== undefined)
-            return project.title;
+            return nameOf(project);
     }
     const queued = db
-        .prepare(`SELECT p.title FROM project_queue q JOIN projects p ON p.id=q.project_id
+        .prepare(`SELECT p.id, p.title FROM project_queue q JOIN projects p ON p.id=q.project_id
        WHERE q.state IN ('queued','active')
          AND q.project_id NOT IN (SELECT project_id FROM project_trash)
          AND q.project_id NOT IN (SELECT project_id FROM project_controls WHERE paused=1)
        LIMIT 1`)
         .get();
-    if (typeof queued?.title === "string")
-        return queued.title;
+    if (typeof queued?.id === "string" && typeof queued.title === "string")
+        return nameOf({ id: queued.id, title: queued.title });
     const retry = db
-        .prepare(`SELECT p.title FROM narration_retries r JOIN projects p ON p.id=r.project_id
+        .prepare(`SELECT p.id, p.title FROM narration_retries r JOIN projects p ON p.id=r.project_id
        WHERE r.state='pending' LIMIT 1`)
         .get();
-    if (typeof retry?.title === "string")
-        return retry.title;
+    if (typeof retry?.id === "string" && typeof retry.title === "string")
+        return nameOf({ id: retry.id, title: retry.title });
     const schedule = db
         .prepare(`SELECT name FROM schedules WHERE deleted_at IS NULL AND (
          (status='active' AND next_run_at IS NOT NULL AND next_run_at <= ?)
@@ -55,5 +62,28 @@ export function workInProgress(db, inflight, now) {
         .get(new Date(now + scheduledSoonMs).toISOString());
     if (typeof schedule?.name === "string")
         return schedule.name;
-    return undefined;
+    // A paid picture call, or a design template's sample, still being made.
+    const picture = db
+        .prepare(`SELECT d.name AS name, r.name AS template FROM designs d
+       LEFT JOIN design_templates t ON t.id=d.sample_of
+       LEFT JOIN design_template_revisions r ON r.template_id=t.id AND r.version=t.head_version
+       WHERE d.id IN (SELECT design_id FROM design_steps WHERE state='making')
+          OR d.id IN (SELECT design_id FROM design_template_samples WHERE state='making')
+       LIMIT 1`)
+        .get();
+    if (picture !== undefined) {
+        if (typeof picture.template === "string")
+            return `the studio sample of ${picture.template}`;
+        if (typeof picture.name === "string")
+            return picture.name;
+    }
+    const sample = db
+        .prepare(`SELECT r.name AS name FROM design_template_samples s
+       JOIN design_templates t ON t.id=s.template_id
+       JOIN design_template_revisions r ON r.template_id=t.id AND r.version=t.head_version
+       WHERE s.state='making' LIMIT 1`)
+        .get();
+    if (typeof sample?.name === "string")
+        return `the studio sample of ${sample.name}`;
+    return live?.();
 }