@hypersocial/decks-cli 0.9.7 → 0.9.8

package/README.md

@@ -64,7 +64,7 @@ share list <slug> [--json]
 share on|off <token>
 share mute|unmute <token>
 share rm <token>
-share url <token>
+share url <token> [--backup]
 
 recipient archive|unarchive <name>
 import <html-or-zip-or-url> --slug <slug> [--title title] [--status draft|live|archived]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypersocial/decks-cli",
-  "version": "0.9.7",
+  "version": "0.9.8",
   "description": "Command-line client for Hypersocial Decks live analytics and share management.",
   "type": "module",
   "main": "./src/commands.mjs",

package/skills/hyperdecks/SKILL.md

@@ -149,7 +149,7 @@ Hyperdecks server; use the CLI where you have a shell and the tool otherwise.
 | One more link | `hyperdecks share new <slug> "<name>" [--no-forward]` | `create_share` (`allowForward`) |
 | Forwarding, one link | `hyperdecks share forward on\|off\|default <token>` | `set_share_forwarding` |
 | Forwarding, whole deck | `hyperdecks deck forward on\|off <slug>` | `set_deck_forwarding` |
-| Slides or scroll, viewer toggle | `hyperdecks deck view <slug> [slides\|scroll\|default] [--toggle on\|off]` | `set_deck_view` |
+| Slides or scroll, viewer toggle, pace | `hyperdecks deck view <slug> [slides\|scroll\|default] [--toggle on\|off] [--pace auto\|slide\|step\|default]` | `set_deck_view` |
 | Who watched | `hyperdecks deck stats <slug>` | `deck_stats` |
 | All activity | `hyperdecks activity --deck <slug>` | `activity_overview` |
 | What one person watched | `hyperdecks engagement "<name>" --deck <slug> --json` | `recipient_engagement` |
@@ -169,7 +169,15 @@ HTML says. Viewers get a slides/scroll toggle in the player, remembered per
 link, unless you turn it off (`--toggle off`, `viewToggle: false`). A viewer
 who already switched keeps their own choice while the toggle is on; turn the
 toggle off to make every viewer see the deck's view.
-`deck list --json` / `list_decks` and `deck stats` / `deck_stats` show both.
+Pace is the third: `--pace auto` (`pace: "auto"`, the default) plays itself,
+`slide` waits for Next (the Continue pill, →, a swipe) after each slide's
+narration, and `step` also stops the narration before each `[reveal]` cue,
+so a slide's reveals are the steps the viewer clicks through: group what
+belongs together at one word, so each stop is a meaningful step. Viewers can
+switch pace (and slides/scroll) in the player's Preferences, in its top bar
+(remembered per link); a video export always plays straight through. Pace
+waits apply side to side (slides) only: scroll keeps its own flow.
+`deck list --json` / `list_decks` and `deck stats` / `deck_stats` show all three.
 
 ### 1. Ground it in the user's own material
 
@@ -258,6 +266,18 @@ The deck contract (`check` enforces or warns on each line):
 <!-- topic: presenter -->
 #### Which presenter style
 
+**Who presents is set at release; leave the tag alone.** `deck new --narrated`
+writes `data-presenter="none"` on the player tag, and `release` (and
+`release_deck`) puts the narrator's face on the copy it publishes: your own
+narrator's avatar, or D.A.S.H.'s live head for a deck in D.A.S.H.'s voice. It
+says `presented by …` only when the published page has that face; otherwise
+it warns `releasing captions only` with the reason. To pick the face by hand,
+set both attributes: `data-presenter="head" data-avatar="…"`. D.A.S.H.'s is
+`data-presenter="head" data-avatar="https://hyperdecks.ai/player/v1/dash-avatar.json"`
+(it loads from any host). `data-presenter="head"` with no `data-avatar` plays
+captions only, and so does a `data-avatar` beside `data-presenter="none"`.
+`check` warns on both, and `release` leaves a hand-set `data-avatar` alone.
+
 Set the deck's on the player tag (`data-presenter-style="stage"`) or in
 script.md's front matter (`presenterStyle: stage`); override one slide with
 `data-presenter-style` on its `<section>` or `presenter-style: corner` under
@@ -596,6 +616,20 @@ with a real screen. Proof: `number` (huge, sourced) or `chart`. Plan:
 `timeline` on a tint. People: `team` with real faces. Closer: `on-ink`, the
 one action, stickers again.
 
+**No presenter.** When nothing stands in the corner, no face (presenter
+`none`) *and* no captions (`data-silent`, or an export with captions off), or
+when a host calls `window.hyperdecks.setPresenterOff(true)`, the player puts
+`hd-no-presenter` on `<html>` and hides every `.narration-slot`. Each layout
+has a variant for that in its own `<style>` (`deck_guide layouts` says what
+each does): compare and chart widen; features, team and timeline centre
+vertically; split, product and phones centre their copy; number, quote,
+closer and a hero without art re-centre. Type sizes stay. A deck with
+captions keeps the slot (the bubble lives there). For a custom slide, keep it
+compatible: the presenter's corner is the slide's `.narration-slot`, never a
+hard-coded gutter (`padding-right: 400px`); if it needs one, override it in a
+`:root.hd-no-presenter .l-yours …` rule (check warns on a right gutter until
+you do).
+
 <!-- topic: script -->
 ### 3. Write slides and script
 

package/skills/hyperdecks/chat.md

@@ -91,9 +91,11 @@ makes the hello deck; continue from step 5 below.
 10. Later: `list_shares` and `deck_stats` (both show the card),
    `activity_overview`; `email_embed { token }` for the HTML that pastes into an
    email as the deck's moving preview (it needs a recipient's link, not a QA
-   one); `set_deck_view { slug, view: "scroll" | "slides" | null, viewToggle }`
-   for how the deck opens and whether viewers may switch (every link, next
-   load, no re-release); `set_share_notify` to mute a link's "opened" alerts;
+   one); `set_deck_view { slug, view: "scroll" | "slides" | null, viewToggle, pace }`
+   for how the deck opens, whether viewers may switch, and its pace (`auto`
+   plays itself, `slide` waits for Next after each slide, `step` also stops
+   before each `[reveal]`, so group a slide's reveals into meaningful steps)
+   (every link, next load, no re-release); `set_share_notify` to mute a link's "opened" alerts;
    `set_recipient_archived` to tidy the activity feed; `credits` for the
    balance. `remove_deck` deletes a deck and breaks every link to it: confirm
    with the user first.

package/src/checkRules.mjs

@@ -5,6 +5,8 @@
 // the deck's index.html and script.md as text, with the manifest and clip fetches
 // injected.
 
+import { DASH_AVATAR, presenterTagIssue } from "./presenter.mjs";
+
 export const PLAYER_V1 = "https://hyperdecks.ai/player/v1/player.js";
 // Decks released before the app moved to hyperdecks.ai load the same player
 // from the old host, which serves it forever; both pass.
@@ -58,6 +60,8 @@ export const MESSAGES = {
   selector: (line, cue, selector, id) => `script.md line ${line}: [${cue}: ${selector}] matches nothing in slide ${id}`,
   gestureColon: (line, id) => `script.md line ${line}: [gesture ${id}] needs a colon: [gesture: ${id}]`,
   gesture: (line, id) => `script.md line ${line}: [gesture: ${id}] is not one of the head's gestures: ${GESTURES.join(", ")}`,
+  presenterUnfilled: (mode) => `the player tag says data-presenter="${mode}" but names no face (${mode === "head" ? "data-avatar" : "data-presenter-image"}), so as written it plays captions only. release puts the narrator's face on it; to set one by hand, D.A.S.H. is data-presenter="head" data-avatar="${DASH_AVATAR}" (deck_guide topic presenter)`,
+  presenterKept: (mode) => `the player tag has a data-avatar but data-presenter="${mode ?? "none"}", so it plays captions only and release leaves it that way: set data-presenter="head" to show that face, or remove data-avatar so release adds the narrator's`,
   presenterSize: (where, value) => `${where}: data-presenter-size "${value}" is not one of ${PRESENTER_SIZES.join(", ")}; the presenter keeps its default size`,
   presenterStyle: (where, value) => `${where}: presenter style "${value}" is not one of ${PRESENTER_STYLES.join(", ")}`,
   transition: (where, value) => `${where}: transition "${value}" is not one of ${TRANSITIONS.join(", ")} (zoom takes a selector: "zoom #row")`,
@@ -67,6 +71,7 @@ export const MESSAGES = {
   flyTwice: (ids) => `fly is for the deck's one big moment, but slides ${ids.join(", ")} all use it`,
   // Warnings from the look topic (deck_guide look): the deck passes, but a person should look.
   fewPictures: (shown, total) => `only ${shown} of ${total} slides show a picture (a screenshot, a recording, a photo, a chart); aim for a real one on every other slide (deck_guide topic look)`,
+  presenterGutter: (where, decl) => `${where}: ${decl} keeps a right gutter for the presenter; leave that corner to the slide's .narration-slot so a deck without a presenter can use it (deck_guide topic look)`,
   mixedIcons: (sets) => `the deck mixes icon sets (${sets.join(" and ")}); keep one set per deck (deck_guide topic look)`,
   // A layout's stand-in left in: `how` is the tool (hosted) or command (CLI) that makes the real file.
   placeholder: (id, what, el, how, img) => `slide ${id}: ${what} is still the layout's placeholder (${el}); ${how}, then put it in as ${img}`,
@@ -790,6 +795,68 @@ export function lookWarnings(html) {
   return out;
 }
 
+// A wide right padding or margin (PRESENTER_GUTTER px or more, and wider than
+// the left: a centred column is not a gutter) is a gutter held for the
+// presenter outside its .narration-slot: without a presenter
+// (:root.hd-no-presenter) it stays empty. Read from inline styles on a slide
+// and its elements, and from the deck's <style> rules (by selector). Skipped:
+// rules in a phone media query (max-width, no min-width), in @keyframes and
+// the like, on the slot itself, the no-presenter rules, and a selector whose
+// gutter a :root.hd-no-presenter rule overrides (the variant the guide asks for).
+// One linear pass over the text: a malformed paste must not stall check.
+export const PRESENTER_GUTTER = 240;
+const sides = (prop, value) => {
+  const px = (v) => { const m = /^(\d+(?:\.\d+)?)(px|rem|em)$/i.exec(v ?? ""); return m ? Number(m[1]) * (m[2].toLowerCase() === "px" ? 1 : 16) : 0; };
+  const parts = value.trim().split(/\s+/);
+  if (/-(right|inline-end)$/i.test(prop)) return { right: px(parts[0]), left: 0 };
+  return { right: px(parts[1] ?? parts[0]), left: px(parts[3] ?? parts[1] ?? parts[0]) };
+};
+const gutters = (decls) => decls.split(";").map((d) => /^\s*((?:padding|margin)(?:-right|-inline-end)?)\s*:\s*([^!]+)/i.exec(d)).filter(Boolean)
+  .filter(([, prop, value]) => { const { right, left } = sides(prop, value); return right >= PRESENTER_GUTTER && right > left; })
+  .map(([, prop, value]) => `${prop.toLowerCase()}: ${value.trim()}`);
+// Each style rule of a stylesheet: { selector, decls, at } where `at` lists the
+// @-rule preludes around it. Comments drop out; braces nest.
+function cssRules(css) {
+  const out = [], stack = [];
+  let start = 0, i = 0;
+  let text = "";
+  while (i < css.length) {
+    if (css.startsWith("/*", i)) { const end = css.indexOf("*/", i + 2); text += css.slice(start, i); i = start = end === -1 ? css.length : end + 2; continue; }
+    const ch = css[i];
+    if (ch === "{" || ch === "}") {
+      text += css.slice(start, i);
+      if (ch === "{") stack.push(text.trim());
+      else {
+        const head = stack.pop();
+        if (head !== undefined && !head.startsWith("@")) out.push({ selector: head, decls: text, at: stack.filter((h) => h.startsWith("@")) });
+      }
+      text = "";
+      start = i + 1;
+    }
+    i++;
+  }
+  return out;
+}
+const phoneOnly = (at) => at.some((h) => /^@media\b/i.test(h) && /max-width/i.test(h) && !/min-width/i.test(h));
+const NO_PRESENTER = /^:root\.hd-no-presenter\s+/;
+export function presenterGutterWarnings(html) {
+  const out = [];
+  for (const [i, s] of slides(html).entries()) {
+    const where = `slide ${s.id || i + 1}`;
+    for (const [, value] of `${s.tag}\n${uncommented(s.body)}`.matchAll(/\sstyle\s*=\s*("[^"]*"|'[^']*')/gi)) {
+      for (const decl of gutters(value.slice(1, -1))) out.push(MESSAGES.presenterGutter(where, decl));
+    }
+  }
+  const rules = [...uncommented(html).matchAll(/<style\b[^>]*>([\s\S]*?)<\/style>/gi)].flatMap(([, css]) => cssRules(css));
+  const overridden = new Set(rules.filter((r) => NO_PRESENTER.test(r.selector) && /(padding|margin)/i.test(r.decls)).map((r) => r.selector.replace(NO_PRESENTER, "")));
+  for (const r of rules) {
+    if (r.at.some((h) => !/^@(media|supports|layer|container)\b/i.test(h)) || phoneOnly(r.at)) continue;
+    if (NO_PRESENTER.test(r.selector) || /\.narration-slot\b/.test(r.selector) || overridden.has(r.selector)) continue;
+    for (const decl of gutters(r.decls)) out.push(MESSAGES.presenterGutter(`rule ${r.selector}`, decl));
+  }
+  return out;
+}
+
 // Every rule on the deck's text. `exists(ref)` answers whether a local reference
 // resolves (true, false or "outside"); `hosted: true` means there is no folder,
 // so every local reference is an error naming upload_deck_asset, a hotlinked
@@ -809,7 +876,7 @@ export async function checkSources({ html, script = "" }, opts = {}, { fetch: fe
   const errors = htmlErrors(html, { exists, forbid, script, hosted: !!opts.hosted, strict });
   const warnings = [];
   if (!notesRequired(html, { strict })) for (const id of slidesWithoutNotes(html)) warnings.push(MESSAGES.noteSoft(id));
-  warnings.push(...lookWarnings(html));
+  warnings.push(...lookWarnings(html), ...presenterGutterWarnings(html));
   // Without a folder (hosted, or a caller that passes no reader) only the inline scripts are read.
   const walked = deckFiles(html, opts.hosted ? {} : { pathExists: opts.pathExists, read: opts.read, isDir: opts.isDir });
   for (const m of walked.missing) errors.push(MESSAGES.scriptRef(m.ref, m.from));
@@ -873,6 +940,9 @@ export async function checkSources({ html, script = "" }, opts = {}, { fetch: fe
     }
   }
   warnings.push(...transitionWarnings(html, script, manifest), ...presenterSizeWarnings(html));
+  // A narrated deck's tag that shows no face and says otherwise (a silent deck has no presenter).
+  const tagIssue = silent ? null : presenterTagIssue(html);
+  if (tagIssue) warnings.push(tagIssue.kind === "kept" ? MESSAGES.presenterKept(tagIssue.presenter) : MESSAGES.presenterUnfilled(tagIssue.presenter));
   for (const t of walked.templates) warnings.push(MESSAGES.scriptTemplate(t.from, t.samples));
   for (const c of walked.computed) warnings.push(MESSAGES.scriptComputed(c.from, c.calls));
   if (opts.hosted) {

package/src/commands.mjs

@@ -1,10 +1,12 @@
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, join, resolve } from "node:path";
 import {
+  backupLinkUrl,
   installHyperdecksSkill,
   login,
   logout,
   openBrowser,
+  linkBase,
   parse,
   target,
   VERSION,
@@ -60,7 +62,7 @@ async function deckStats(pos, opts) {
   console.log(`  unique viewers: ${s.viewers}`);
   console.log(`  avg engaged:    ${fmtMs(s.avgMs)}`);
   console.log(`  total engaged:  ${fmtMs(s.totalMs)}`);
-  if (s.view !== undefined) console.log(`  plays as:       ${s.view ?? "as its HTML says"}${s.viewToggle === false ? " (viewer toggle off)" : ""}${s.usesPlayer === false ? " (won't apply: the deck doesn't load player/v1)" : ""}`);
+  if (s.view !== undefined) console.log(`  plays as:       ${s.view ?? "as its HTML says"}${s.viewToggle === false ? " (viewer toggle off)" : ""}${s.pace ? `, pace ${s.pace}` : ""}${s.usesPlayer === false ? " (won't apply: the deck doesn't load player/v1)" : ""}`);
   if (s.recent?.length) {
     console.log("  recent:");
     for (const r of s.recent) {
@@ -85,10 +87,6 @@ async function deckRemove(pos, opts) {
   console.log(`OK removed deck ${slug}`);
 }
 
-function shareBase(opts) {
-  return target(opts).shareBase;
-}
-
 async function shareNew(pos, opts) {
   const [slug, recipient] = pos;
   if (!slug || !recipient) throw new Error("usage: share new <slug> <recipient> [--email e] [--note n] [--require-email] [--expires iso] [--limit n] [--qa] [--no-notify] [--allow-forward|--no-forward]");
@@ -105,9 +103,13 @@ async function shareNew(pos, opts) {
     expires: opts.expires,
     limit: opts.limit,
   });
-  const url = `${shareBase(opts)}/v/${token}`;
-  if (opts.json) console.log(JSON.stringify({ token, url }, null, 2));
-  else console.log(`OK share for "${recipient}" -> ${url}`);
+  const url = `${await linkBase(opts)}/v/${token}`;
+  const backupUrl = backupLinkUrl(url);
+  if (opts.json) console.log(JSON.stringify({ token, url, backupUrl }, null, 2));
+  else {
+    console.log(`OK share for "${recipient}" -> ${url}`);
+    if (backupUrl) console.log(`   backup link (same link, other domain, if their network blocks it): ${backupUrl}`);
+  }
 }
 
 async function shareList(pos, opts) {
@@ -156,23 +158,28 @@ async function deckForward(pos, opts) {
   console.log(`OK forwarding ${mode} for deck ${slug} (links with their own setting keep it)`);
 }
 
-const VIEW_USAGE = "usage: deck view <slug> [slides|scroll|default] [--toggle on|off]";
+const VIEW_USAGE = "usage: deck view <slug> [slides|scroll|default] [--toggle on|off] [--pace auto|slide|step|default]";
 const VIEWS = { slides: "slides", scroll: "scroll", default: null };
+const PACES = { auto: "auto", slide: "slide", step: "step", default: null };
 async function deckView(pos, opts) {
   const [slug, mode] = pos;
   const toggle = opts.toggle;
-  if (!slug || (mode === undefined && !Object.hasOwn(opts, "toggle"))) throw new Error(VIEW_USAGE);
+  const pace = opts.pace;
+  if (!slug || (mode === undefined && !Object.hasOwn(opts, "toggle") && !Object.hasOwn(opts, "pace"))) throw new Error(VIEW_USAGE);
   if (mode !== undefined && !Object.hasOwn(VIEWS, mode)) throw new Error(VIEW_USAGE);
   // A trailing --toggle with no value is a mistake, not "leave it".
   if (Object.hasOwn(opts, "toggle") && toggle !== "on" && toggle !== "off") throw new Error(VIEW_USAGE);
+  if (Object.hasOwn(opts, "pace") && !Object.hasOwn(PACES, pace)) throw new Error(VIEW_USAGE);
   const out = await ops.setDeckView(opts, slug, {
     view: mode === undefined ? undefined : VIEWS[mode],
     viewToggle: toggle === undefined ? undefined : toggle === "on",
+    pace: pace === undefined ? undefined : PACES[pace],
   });
   if (opts.json) return void console.log(JSON.stringify(out, null, 2));
   const said = [];
   if (mode !== undefined) said.push(mode === "default" ? "opens as its HTML says" : `opens as ${mode}`);
   if (toggle !== undefined) said.push(`viewer toggle ${toggle}`);
+  if (pace !== undefined) said.push(pace === "default" ? "paces as its HTML says" : `pace ${pace}`);
   if (out.applies === false) {
     console.log(`OK deck ${slug} ${said.join(", ")} (saved)`);
     console.warn(`warning: ${out.warning}`);
@@ -181,10 +188,14 @@ async function deckView(pos, opts) {
   console.log(`OK deck ${slug} ${said.join(", ")} (every link, on its next load)`);
 }
 
-function shareUrl(pos, opts) {
+async function shareUrl(pos, opts) {
   const [token] = pos;
-  if (!token) throw new Error("usage: share url <token>");
-  console.log(`${shareBase(opts)}/v/${token}`);
+  if (!token) throw new Error("usage: share url <token> [--backup]");
+  const url = `${await linkBase(opts)}/v/${token}`;
+  console.log(url);
+  // Second line: the same link on the other domain (stdout stays one URL per line).
+  const backupUrl = backupLinkUrl(url);
+  if (backupUrl && opts.backup) console.log(backupUrl);
 }
 
 async function recipientArchive(pos, opts, archived) {
@@ -336,7 +347,7 @@ commands:
   deck list|stats|open|rm|forward|view
   deck forward on|off <slug>
                    whether viewers can forward the deck's links (on by default; a link's own setting wins)
-  deck view <slug> [slides|scroll|default] [--toggle on|off]
+  deck view <slug> [slides|scroll|default] [--toggle on|off] [--pace auto|slide|step|default]
                    how the deck opens in the player (default: as its HTML says, data-view or slides) and
                    whether viewers get the slides/scroll toggle (on by default). Every link, next load; no re-release.
   deck new <slug> "<title>" --narrated [--layouts hero,product,number,closer] [--presenter-style stage|bubble|glass|corner] [--no-brand] [--dir <path>]
@@ -441,7 +452,7 @@ commands:
 
   narrate <deck-dir> [--slide <id>] [--voice <name|id>] [--slug <slug>] [--dry-run] [--json]
                    script.md → voiced clips, timelines and a manifest, rendered server-side; only changed slides re-render
-  voice list [--json]   your voices and their status
+  voice list [--json]   your voices and their status, then the built-in voices anyone can narrate with
   voice clone <file...> --name <name>
                    clone your voice from 1-3 mp3/m4a/wav recordings (30 s to 3 min in total, 10 MB each);
                    asks you to type "I consent" before anything is uploaded
@@ -851,10 +862,12 @@ function commandTable(pos, rest, opts) {
       if (opts.json) console.log(JSON.stringify(out, null, 2));
     },
     "voice list": async () => {
-      const voices = await ops.listVoices(opts);
+      const voices = await ops.listAllVoices(opts);
       if (opts.json) return void console.log(JSON.stringify(voices, null, 2));
-      for (const x of voices) console.log(`${x.name}\t${x.status}\t${x.handle ?? "-"}\t${x.id}${x.error ? `\t${x.error}` : ""}`);
-      if (!voices.length) console.log("(no voices; voice clone <file...> --name <name> makes one)");
+      const own = voices.filter((x) => !x.builtin);
+      for (const x of own) console.log(`${x.name}\t${x.status}\t${x.handle ?? "-"}\t${x.id}${x.error ? `\t${x.error}` : ""}`);
+      if (!own.length) console.log("(no voices of your own; voice clone <file...> --name <name> makes one)");
+      for (const x of voices.filter((x) => x.builtin)) console.log(`${x.name}\tbuilt in\t${x.description}\t${x.id}`);
     },
     "voice clone": async () => {
       const { voiceClone } = await import("./voice.mjs");

package/src/guide.mjs

@@ -29,7 +29,7 @@ export function skillSection(skill, topic) {
 function layoutsTopic() {
   const rows = LAYOUTS.map((name) => {
     const { meta } = readLayout(name);
-    return [`### ${name}`, meta.summary, meta.use && `Use: ${meta.use}`, meta.slot && `Slots: ${meta.slot}`, meta.cues && `Cues: ${meta.cues}`].filter(Boolean).join("\n");
+    return [`### ${name}`, meta.summary, meta.use && `Use: ${meta.use}`, meta.slot && `Slots: ${meta.slot}`, meta.nopresenter && `Without a presenter: ${meta.nopresenter}`, meta.cues && `Cues: ${meta.cues}`].filter(Boolean).join("\n");
   });
   return `# Layouts\n\nPass any of these, in order, as new_deck's \`layouts\` (repeat one for more of the same: number, number gives slides number and number-2).\n\n${rows.join("\n\n")}`;
 }

package/src/init.mjs

@@ -17,7 +17,7 @@ import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 import * as ops from "./ops.mjs";
 import { ANSWER_MAX, DASH_AVATAR, FIRST_DECK_LAYOUTS, cleanAnswer, fillFirstDeck, firstDeckCopy, firstDeckSlug } from "./firstDeck.mjs";
-import { agentTable, api, chooseAgents, client, CRED_DIR, installHyperdecksSkill, login as runLogin, openBrowser, target } from "./runtime.mjs";
+import { agentTable, api, chooseAgents, client, CRED_DIR, installHyperdecksSkill, linkBase, login as runLogin, openBrowser, target } from "./runtime.mjs";
 import { READING_PASSAGE, voiceClone as runVoiceClone } from "./voice.mjs";
 import { assembleLayoutDeck, deckNew as runDeckNew } from "./scaffold.mjs";
 import { narrate as runNarrate } from "./narrate.mjs";
@@ -450,9 +450,13 @@ async function presenterStep(base, opts, { interactive, ask, log, sub, avatars,
   }
 }
 
+// decks:get answers only for decks the caller owns, so whether the slug is
+// taken at all comes from slugTaken.
 async function deckOwnedBy(base, slug, who) {
-  const deck = await (await client(base)).query(api.decks.get, { slug });
-  return deck ? { exists: true, mine: deck.ownerId === who.subject } : { exists: false, mine: false };
+  const c = await client(base);
+  if (!(await c.query(api.decks.slugTaken, { slug }))) return { exists: false, mine: false };
+  const deck = await c.query(api.decks.get, { slug });
+  return { exists: true, mine: !!deck && deck.ownerId === who.subject };
 }
 
 async function scaffoldStep(base, opts, { state, who, voice, presenter, interactive, ask, deckNew, cwd, home, random, sub, log, save }) {
@@ -544,7 +548,7 @@ async function releaseStep(base, opts, state, { release, sub, save, fetch }) {
   // A run killed after release made its link but before init.json recorded it.
   const mine = !state.releasedAt && shares.find((s) => s.qa && s.recipient === "Me" && s.enabled);
   if (mine) {
-    const url = `${target(base).shareBase}/v/${mine.token}`;
+    const url = `${await linkBase(base)}/v/${mine.token}`;
     save({ releasedAt: new Date().toISOString(), shareUrl: url, shareToken: mine.token });
     return step("release", "done", `released: ${url}`);
   }

package/src/layouts.mjs

@@ -20,7 +20,7 @@ export function fillTemplate(file, { slug, title, presenterStyle }) {
 }
 
 // One layout file: a leading comment of `key: value` lines (layout, summary,
-// use, slot, presenter, cues, script), its <style> and its <section>.
+// use, slot, presenter, nopresenter, cues, script), its <style> and its <section>.
 export function readLayout(name) {
   const text = packageText(`templates/layouts/${name}.html`);
   const head = /^<!--([\s\S]*?)-->/.exec(text);

package/src/ops.mjs

@@ -2,7 +2,7 @@ import { deckPlayer, importPlayerWarning, viewPlayerWarning } from "./deckPlayer
 import { zipSync } from "fflate";
 import { COLOR_KEYS, FONT_PAIRINGS, FONT_ROLES, findPairing, googleFontsUrl } from "./brand.mjs";
 import { MAX_IMPORT_FILE_BYTES, draftArgs, extractFile } from "./brandImport.mjs";
-import { api, client, target, uploadBytes as runtimeUploadBytes } from "./runtime.mjs";
+import { api, client, linkBase, target, uploadBytes as runtimeUploadBytes } from "./runtime.mjs";
 import {
   bytesFromText,
   isTextAsset,
@@ -19,8 +19,9 @@ export async function whoami(opts = {}) {
   return (await client(opts)).query(api.decks.whoami, {});
 }
 
-export async function listDecks(opts = {}) {
-  const rows = await (await client(opts)).query(api.decks.listForViewer, {});
+// Your own decks. `all: true` lists every deck, for admins only (support tools).
+export async function listDecks(opts = {}, { all = false } = {}) {
+  const rows = await (await client(opts)).query(all ? api.decks.listAll : api.decks.listForViewer, {});
   return rows.map((d) => ({
     slug: d.slug,
     title: d.title,
@@ -30,6 +31,8 @@ export async function listDecks(opts = {}) {
     // How it opens (null: as its HTML says) and whether viewers may switch.
     view: d.view ?? null,
     viewToggle: d.viewToggle !== false,
+    // How the player moves on: auto, slide or step (null: as its HTML says, else auto).
+    pace: d.pace ?? null,
     // false: the deck runs its own player, so view/viewToggle do not apply
     // (null: not known yet, treated as on).
     usesPlayer: d.usesPlayer ?? null,
@@ -264,7 +267,11 @@ export async function ownedDeck(opts, slug) {
   const c = await client(opts);
   const [deck, me] = await Promise.all([c.query(api.decks.get, { slug }), c.query(api.decks.whoami, {})]);
   if (!me) throw new Error("not logged in: run `hyperdecks login` first");
-  if (!deck) throw new Error(`deck not found: ${slug} (register it first, or pass --slug)`);
+  if (!deck) {
+    // get answers only for your own decks; say so when the slug is someone else's.
+    if (await c.query(api.decks.slugTaken, { slug })) throw new Error(`forbidden: ${slug} is not your deck`);
+    throw new Error(`deck not found: ${slug} (register it first, or pass --slug)`);
+  }
   if (!me.isAdmin && deck.ownerId !== me.subject) throw new Error(`forbidden: ${slug} is not your deck`);
   return deck;
 }
@@ -288,7 +295,7 @@ export const VIDEO_RECIPIENT = "Video viewers";
 export async function videoShareLink(opts, slug) {
   const live = (await listShares(opts, slug)).find((s) => s.recipient === VIDEO_RECIPIENT && s.enabled && !s.qa && !s.archived && !s.requireEmail && (s.expiresAt == null || s.expiresAt > Date.now()) && (s.viewLimit == null || s.opens < s.viewLimit));
   const token = live?.token ?? (await createShare(opts, { slug, recipient: VIDEO_RECIPIENT })).token;
-  return `${target(opts).shareBase}/v/${token}`;
+  return `${await linkBase(opts)}/v/${token}`;
 }
 
 // `export --video --upload`: file the MP4 with the deck's exports (30 days).
@@ -428,10 +435,24 @@ export async function checkNarrationJob(opts, jobId) {
   return (await client(opts)).query(api.narration.getJob, { jobId: String(jobId) });
 }
 
+// Your own voices (what clone, rename and delete act on).
 export async function listVoices(opts = {}) {
   return (await client(opts)).query(api.voices.listVoices, {});
 }
 
+// Every voice you can narrate with: yours, then the built-in ones (builtin: true,
+// id stock:<id>), which any account may use. What list_voices shows.
+export async function listAllVoices(opts = {}) {
+  const c = await client(opts);
+  try {
+    return await c.query(api.voices.listVoices, { builtin: true });
+  } catch (e) {
+    // A backend from before built-in voices refuses the argument: your own voices, then.
+    if (!/builtin|extra field|Validator/i.test(errorText(e))) throw e;
+    return c.query(api.voices.listVoices, {});
+  }
+}
+
 // ---- voice cloning (convex/voices.ts) ---------------------------------------
 
 // The text of a backend error: ConvexError data (production redacts the rest), else the message.
@@ -603,18 +624,23 @@ export async function setDeckForwarding(opts, slug, allowForward) {
 
 // How a deck opens in the player and whether viewers may switch: view is
 // "slides", "scroll", or null to follow the deck's own HTML again; viewToggle
-// true/false. Either may be left out; both go in one owner-only mutation, so a
-// failure changes neither.
+// true/false; pace is "auto" (plays itself), "slide" (waits for Next after each
+// slide), "step" (also stops before each [reveal] cue), or null for the deck's
+// own HTML. Any may be left out; all go in one owner-only mutation, so a
+// failure changes none.
 // Applies on every link's next load (the route injects it), with no re-release.
 export const DECK_VIEWS = ["slides", "scroll"];
-export async function setDeckView(opts, slug, { view, viewToggle } = {}) {
+export const DECK_PACES = ["auto", "slide", "step"];
+export async function setDeckView(opts, slug, { view, viewToggle, pace } = {}) {
   if (!slug) throw new Error("slug is required");
-  if (view === undefined && viewToggle === undefined) throw new Error("give a view (slides, scroll or default) and/or a viewToggle");
+  if (view === undefined && viewToggle === undefined && pace === undefined) throw new Error("give a view (slides, scroll or default), a viewToggle and/or a pace (auto, slide, step or default)");
   if (view !== undefined && view !== null && !DECK_VIEWS.includes(view)) throw new Error(`view must be slides, scroll or null (got ${JSON.stringify(view)})`);
+  if (pace !== undefined && pace !== null && !DECK_PACES.includes(pace)) throw new Error(`pace must be auto, slide, step or null (got ${JSON.stringify(pace)})`);
   const res = await (await client(opts)).mutation(api.decks.setViewSettings, {
     slug,
     ...(view !== undefined ? { view } : {}),
     ...(viewToggle !== undefined ? { viewToggle: !!viewToggle } : {}),
+    ...(pace !== undefined ? { pace } : {}),
   });
   // Saved either way; a deck on its own player says the setting won't apply.
   const applies = res?.applies !== false;
@@ -622,6 +648,7 @@ export async function setDeckView(opts, slug, { view, viewToggle } = {}) {
     slug,
     ...(view !== undefined ? { view } : {}),
     ...(viewToggle !== undefined ? { viewToggle: !!viewToggle } : {}),
+    ...(pace !== undefined ? { pace } : {}),
     applies,
     ...(applies ? {} : { warning: viewPlayerWarning(slug, res?.ownScript ?? null) }),
   };
@@ -631,7 +658,7 @@ export async function setDeckView(opts, slug, { view, viewToggle } = {}) {
 // upsert would otherwise reset your own live deck to a draft and rename it.
 export async function createDeck(opts, { slug, title }) {
   const c = await client(opts);
-  if (await c.query(api.decks.get, { slug })) throw new Error(`deck ${slug} already exists; pick another slug`);
+  if (await c.query(api.decks.slugTaken, { slug })) throw new Error(`deck ${slug} already exists; pick another slug`);
   await c.mutation(api.decks.upsert, { slug, title, status: "draft" });
   return { slug, title, status: "draft" };
 }
@@ -1146,7 +1173,7 @@ export async function listNarrators(opts = {}) {
     default: out.defaultId,
     ...(out.unpickedVoice ? { note: `no default narrator yet: decks narrate in your voice "${out.unpickedVoice}"` } : {}),
     narrators: out.narrators.map((n) => ({ id: n.id, name: n.name, spokenName: n.spokenName ?? null, isDefault: n.isDefault, builtin: n.builtin, face: n.face?.name ?? null, voice: n.voice?.name ?? null, voiceReady: !!n.voice?.ready })),
-    voices: out.voices.map((x) => ({ id: x.ref, name: x.name, status: x.status, character: x.character, narrators: x.narrators })),
+    voices: out.voices.map((x) => ({ id: x.ref, name: x.name, status: x.status, character: x.character, builtin: !!x.builtin, narrators: x.narrators })),
   };
 }
 
@@ -1188,7 +1215,8 @@ export async function removeNarrator(opts, ref) {
   return { ...(await (await client(opts)).mutation(api.narrators.remove, { narrator: n.id })), id: n.id };
 }
 
-// voice: one of your ready voices (name or id) or dash.
+// voice: one of your ready voices (name or id), a built-in voice (name or
+// stock:<id>, list_voices), or dash.
 export async function setNarratorVoice(opts, ref, voice) {
   if (!voice) throw new Error("usage: narrator voice <narrator> <voice>");
   const n = await findNarrator(opts, ref);

package/src/presenter.mjs

@@ -12,32 +12,118 @@
 export const DASH_AVATAR = "https://hyperdecks.ai/player/v1/dash-avatar.json";
 export const DASH_PRESENTER = Object.freeze({ avatarUrl: DASH_AVATAR, imageUrl: "https://hyperdecks.ai/avatars/dash.png" });
 
-const PLAYER_TAG = /<script\b[^>]*\bsrc="[^"]*\/player\/v1\/player\.js"[^>]*>/i;
+const PLAYER_TAG = /<script\b[^>]*\bsrc="[^"]*\/player\/v1\/player\.js"[^>]*>/gi;
 
 const attr = (s) => String(s).replace(/&/g, "&amp;").replace(/"/g, "&quot;");
 
-// Whether this tag plays captions only: data-presenter="none", or no presenter
-// at all (the player's default when there is no data-presenter-image either).
-const noPresenter = (tag) => /\sdata-presenter="none"/.test(tag) || (!/\sdata-presenter=/.test(tag) && !/\sdata-presenter-image=/.test(tag));
+// The live player tag: the first one outside an HTML comment (a commented-out
+// copy is not what plays), with where it starts. check's playerScript reads it
+// the same way (closed comments only, so a stray "<!--" in a script hides nothing).
+function playerTag(html) {
+  const comments = [...html.matchAll(/<!--[\s\S]*?-->/g)].map((m) => [m.index, m.index + m[0].length]);
+  for (const m of html.matchAll(PLAYER_TAG)) {
+    if (!comments.some(([a, b]) => m.index >= a && m.index < b)) return { tag: m[0], index: m.index };
+  }
+  return null;
+}
+
+const value = (tag, name) => {
+  const m = new RegExp(`\\s${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s"'=<>\`]+))`).exec(tag);
+  return m ? (m[1] ?? m[2] ?? m[3]) : null;
+};
+
+// The face this tag shows, decided as packages/player/player.js does: data-presenter
+// head|static|none, else static when there is a still, else none. head draws
+// data-avatar (and falls back to the still without one); static draws the
+// still. Null: the deck plays the voice and captions with no face.
+function tagFace(tag) {
+  const presenter = value(tag, "data-presenter");
+  const avatarUrl = value(tag, "data-avatar") || null;
+  const imageUrl = value(tag, "data-presenter-image") || null;
+  const mode = ["head", "static", "none"].includes(presenter) ? presenter : imageUrl ? "static" : "none";
+  if (mode === "head" && (avatarUrl || imageUrl)) return { avatarUrl, imageUrl };
+  if (mode === "static" && imageUrl) return { avatarUrl: null, imageUrl };
+  return null;
+}
+
+// The face the page's player shows ({ avatarUrl, imageUrl }, either may be
+// null), or null when it plays captions only or has no player tag.
+export function presentedFace(html) {
+  const found = playerTag(html);
+  return found ? tagFace(found.tag) : null;
+}
 
-// Whether the page's player tag names nobody, so without a face it has captions only.
+// Whether the page's player tag shows no face, so it has captions only.
 export function playsCaptionsOnly(html) {
-  const tag = PLAYER_TAG.exec(html)?.[0];
-  return !!tag && !/\sdata-avatar=/.test(tag) && noPresenter(tag);
+  const found = playerTag(html);
+  return !!found && !tagFace(found.tag);
 }
 
 // html with the player tag set to present `avatarUrl` (the /avatar/<token> doc
-// the player loads) and `imageUrl` (its still, for thumbnails and no-WebGL),
-// or html unchanged when there is no such tag or it already has a presenter.
+// the player loads) and `imageUrl` (its still, for thumbnails and no-WebGL), or
+// html unchanged when there is no such tag, the tag already shows a face, or it
+// names a non-empty data-avatar of its own (set by hand: left alone even beside "none").
+// Anything else the player would play captions only (data-presenter none or
+// missing, head with no data-avatar, static with no still) gets the face.
 export function withAvatar(html, { avatarUrl, imageUrl }) {
-  const tag = PLAYER_TAG.exec(html)?.[0];
-  if (!tag || /\sdata-avatar=/.test(tag)) return html;
-  if (!noPresenter(tag)) return html;
-  const none = /\sdata-presenter="none"/.test(tag);
-  const image = imageUrl && !/\sdata-presenter-image=/.test(tag) ? ` data-presenter-image="${attr(imageUrl)}"` : "";
+  const found = playerTag(html);
+  if (!found) return html;
+  const { tag, index } = found;
+  if (tagFace(tag) || value(tag, "data-avatar")) return html;
+  const image = imageUrl && value(tag, "data-presenter-image") === null ? ` data-presenter-image="${attr(imageUrl)}"` : "";
   const face = ` data-presenter="head" data-avatar="${attr(avatarUrl)}"${image}`;
-  const next = none ? tag.replace(/\sdata-presenter="none"/, face) : tag.replace(/>$/, `${face}>`);
-  return html.replace(tag, () => next);
+  const named = /\sdata-presenter\s*=\s*(?:"[^"]*"|'[^']*'|[^\s"'=<>`]+)/;
+  const next = named.test(tag) ? tag.replace(named, face) : tag.replace(/\s*\/?>$/, (end) => `${face}${end}`);
+  return html.slice(0, index) + next + html.slice(index + tag.length);
+}
+
+// What is wrong with the player tag's presenter as written, for check: null, or
+// { kind, presenter }. "unfilled": it asks for a face (head or static) but names
+// none, so it plays captions only until release fills it in. "kept": it has a
+// data-avatar the player ignores (data-presenter="none"), and release leaves it.
+// A plain "none" or no data-presenter is not an issue: release adds the face.
+export function presenterTagIssue(html) {
+  const found = playerTag(html);
+  if (!found || tagFace(found.tag)) return null;
+  const presenter = value(found.tag, "data-presenter");
+  if (value(found.tag, "data-avatar")) return { kind: "kept", presenter };
+  if (presenter === "head" || presenter === "static") return { kind: "unfilled", presenter };
+  return null;
+}
+
+// Why a resolved face did not land on the page: withAvatar leaves a tag with
+// its own data-avatar alone, and a page with no live player tag has nowhere to put it.
+function keptOutReason(html) {
+  const found = playerTag(html);
+  if (!found) return "the page has no live player tag to put the face on";
+  const mode = value(found.tag, "data-presenter");
+  return `the player tag names its own data-avatar, but data-presenter=${mode === null ? " is missing" : `"${mode}"`} so it plays no face, and release leaves a hand-set data-avatar alone: set data-presenter="head", or remove data-avatar`;
+}
+
+// What a release says about the face, from the page as written (`html`), the
+// face it puts on (`presenter`, from avatars.presenterFor; null for none), who
+// the backend says presents (`who`: { narrator, voice, face, reason }) and, when
+// the face lookup itself failed, `lookupError`. Returns the page that ships, a
+// line for the terminal and the summary to report: "presented by" only when
+// that page shows a face, and with no resolved face on it, the tag's own.
+// Both releases use it: release.mjs and convex/deckSources.ts.
+export const TAG_FACE = "the face set on the player tag";
+export function releasedPresenter(html, presenter, who, { lookupError } = {}) {
+  const page = presenter ? withAvatar(html, presenter) : html;
+  const captions = (reason) => ({ page, line: `⚠ releasing captions only: ${reason}`, summary: who ? { ...who, face: null, reason } : null });
+  const shown = presentedFace(page);
+  if (shown) {
+    // Left as written, with no resolved face or another one: whatever the tag names is what shows.
+    if (page === html && shown.avatarUrl !== presenter?.avatarUrl) {
+      return { page, line: `✓ presented by ${TAG_FACE} (${shown.avatarUrl ? "data-avatar" : "data-presenter-image"})`, summary: who ? { ...who, face: TAG_FACE } : null };
+    }
+    return { page, line: `✓ presented by ${who?.face ?? "your avatar"}`, summary: who ?? null };
+  }
+  if (lookupError) return captions(`could not look up your avatar (${lookupError}); release again to try once more`);
+  if (presenter) return captions(keptOutReason(page));
+  if (who && !who.face) return { page, line: `⚠ releasing captions only: ${who.reason ?? "no face"}`, summary: who };
+  if (who?.face) return captions(`no face for "${who.face}" came back to put on the player tag`);
+  return { page, line: "", summary: null };
 }
 
 // One line for who presents a deck, from narrate's or release's `presenter`

package/src/preview.mjs

@@ -1,7 +1,7 @@
 import { mkdir, readFile, writeFile, stat } from "node:fs/promises";
 import { resolve, extname } from "node:path";
 import { randomUUID } from "node:crypto";
-import { api, client, target, uploadBytes } from "./runtime.mjs";
+import { api, client, linkBase, target, uploadBytes } from "./runtime.mjs";
 
 const escapeHtml = (s) => String(s).replace(/[&<>"']/g, c => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]);
 export function httpUrl(value) {
@@ -58,7 +58,7 @@ export async function createPreview(pos, opts, adapters = {}) {
     if (opts.share) {
       if (deck.status === 'archived') throw new Error('Archived deck cannot provide a sendable share preview');
       validateShare(await c.query(api.shares.listForDeck, { deckSlug: config.slug }), config.slug, opts.share);
-      shareUrl = httpUrl(`${target(opts).shareBase}/v/${opts.share}`);
+      shareUrl = httpUrl(`${await linkBase(opts)}/v/${opts.share}`);
     }
     html = deck.html;
     if (!html && deck.htmlUrl) {

package/src/release.mjs

@@ -16,8 +16,8 @@ import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { zipSync } from "fflate";
 import * as ops from "./ops.mjs";
-import { withAvatar } from "./presenter.mjs";
-import { target } from "./runtime.mjs";
+import { releasedPresenter, withAvatar } from "./presenter.mjs";
+import { linkBase } from "./runtime.mjs";
 import { checkDeck, deckFiles, deckFolder, resolveDeckDir } from "./check.mjs";
 import { narrate as runNarrate } from "./narrate.mjs";
 
@@ -112,16 +112,20 @@ export async function release(pos, opts = {}, io = {}) {
   }
   // The released page gets the narrator's face: your avatar, or D.A.S.H.'s for its voice.
   let presenter = null;
+  let lookupError;
   try {
     presenter = await ops.presenterFor(opts, slug, opts.voice);
   } catch (e) {
-    log(`⚠ could not look up your avatar (${ops.errorText(e)}); releasing captions only`);
+    lookupError = ops.errorText(e);
   }
   const released = presenter ? releaseBundle(deckDir, presenter) : bundle;
-  if (presenter) log(`✓ presented by ${job.presenter?.face ?? "your avatar"}`);
+  // Say who presents from the page that ships, never from the lookup alone: a
+  // resolved face that did not land on the player tag must not be claimed, and
+  // a failed lookup is captions only only when the tag names no face of its own.
+  const said = releasedPresenter(readFileSync(join(deckDir, "index.html"), "utf8"), presenter, job.presenter, { lookupError });
   // A terminal user sees this before it ships, so the CLI warns rather than refuses.
-  else if (job.presenter && !job.presenter.face) log(`⚠ releasing captions only: ${job.presenter.reason ?? "no face"}`);
-  return publish({ opts, io: { log, commit }, deckDir, slug, to, checked, bundle, released, summary: job.presenter ?? null });
+  if (said.line) log(said.line);
+  return publish({ opts, io: { log, commit }, deckDir, slug, to, checked, bundle, released, summary: said.summary });
 }
 
 // Import the checked bundle and make the links: the end of every release.
@@ -137,7 +141,7 @@ async function publish({ opts, io: { log, commit }, deckDir, slug, to, checked,
   const sha = commit(deckDir);
   log(`✓ imported "${imported.title}" as ${imported.slug} (${bundle.files.length} file(s), commit ${sha})\n  deck: ${imported.deckUrl}`);
 
-  const base = target(opts).shareBase;
+  const base = await linkBase(opts);
   const shares = [];
   for (const r of to) {
     let token;

package/src/runtime.mjs

@@ -8,7 +8,7 @@ import { fileURLToPath } from "node:url";
 import { ConvexHttpClient } from "convex/browser";
 import { makeFunctionReference } from "convex/server";
 
-export const VERSION = "0.9.7";
+export const VERSION = "0.9.8";
 const UPLOAD_TIMEOUT_MS = 125_000;
 
 // The app's home. HYPERDECKS_HOST points the prod target's broker and share
@@ -117,7 +117,9 @@ export const api = {
   },
   decks: {
     get: makeFunctionReference("decks:get"),
+    slugTaken: makeFunctionReference("decks:slugTaken"),
     listForViewer: makeFunctionReference("decks:listForViewer"),
+    listAll: makeFunctionReference("decks:listAll"),
     remove: makeFunctionReference("decks:remove"),
     setAllowForward: makeFunctionReference("decks:setAllowForward"),
     setView: makeFunctionReference("decks:setView"),
@@ -135,6 +137,7 @@ export const api = {
     setAllowForward: makeFunctionReference("shares:setAllowForward"),
     setEnabled: makeFunctionReference("shares:setEnabled"),
     setNotify: makeFunctionReference("shares:setNotify"),
+    linkOrigins: makeFunctionReference("shares:linkOrigins"),
   },
   imagegen: {
     generateImage: makeFunctionReference("imagegen:generateImage"),
@@ -191,7 +194,7 @@ export const api = {
   },
 };
 
-const BOOL = new Set(["prod", "dev", "admin", "json", "require-email", "qa", "no-notify", "allow-forward", "no-forward", "help", "version", "all-agents", "global", "project", "transparent", "loop", "upload", "dry-run", "narrated", "layout", "strict", "fix", "full-page", "force", "hosted", "yes", "no-voice", "no-skill", "no-release", "no-open", "save-to-minimoji", "captions-only", "no-brand", "brand", "no-logo", "pdf", "notes", "mp4", "gif", "video", "no-captions", "no-avatar", "title-card", "end-card"]);
+const BOOL = new Set(["prod", "dev", "admin", "json", "require-email", "qa", "no-notify", "allow-forward", "no-forward", "help", "version", "all-agents", "global", "project", "transparent", "loop", "upload", "dry-run", "narrated", "layout", "strict", "fix", "full-page", "force", "hosted", "yes", "no-voice", "no-skill", "no-release", "no-open", "save-to-minimoji", "captions-only", "no-brand", "brand", "no-logo", "pdf", "notes", "mp4", "gif", "video", "no-captions", "no-avatar", "title-card", "end-card", "backup"]);
 // release's recipients, in order: each --to starts one, and an --email right
 // after it belongs to it (`--to A --email a --to B`). Collected as opts.recipients;
 // opts.email stays the last --email for the other commands (share new).
@@ -259,6 +262,63 @@ export function target(opts = {}) {
   };
 }
 
+// Where recipient links (/v/<token>) are printed: the server says
+// (shares:linkOrigins, RECIPIENT_LINK_ORIGIN in lib/linkOrigin.ts), so links
+// follow the deployment rather than a default baked into this version. Both app
+// hosts serve every link; this only picks the one a new link names.
+// HYPERDECKS_LINK_ORIGIN overrides it; the dev target keeps its share base.
+export const DEFAULT_LINK_ORIGIN = "https://decks.hypersocial.ai";
+const LINK_HOSTS = ["https://decks.hypersocial.ai", "https://hyperdecks.ai"];
+let linkOriginPin = null;
+const linkOriginCache = new Map();
+
+// The hosted MCP pins it to the server's own setting (lib/serverCliHost.ts).
+export function pinLinkOrigin(origin) {
+  linkOriginPin = origin ? normalizeBase(origin) : null;
+  linkOriginCache.clear();
+}
+
+const isLinkHost = (o) => typeof o === "string" && LINK_HOSTS.includes(normalizeBase(o.trim()).toLowerCase());
+
+async function askLinkOrigin(c) {
+  try {
+    const out = await c.query(api.shares.linkOrigins, {});
+    // The server only ever names one of the two app hosts; print nothing else.
+    if (isLinkHost(out?.origin)) return normalizeBase(out.origin.trim()).toLowerCase();
+    console.warn(`warning: the server named no usable link origin; printing links on ${DEFAULT_LINK_ORIGIN}`);
+  } catch (e) {
+    // An older server without shares:linkOrigins stays quiet: links on the
+    // established host open everywhere. Anything else is worth a line.
+    const msg = String(e?.message ?? e);
+    if (!/Could not find public function/.test(msg)) console.warn(`warning: could not ask where to print links (${msg}); printing them on ${DEFAULT_LINK_ORIGIN}`);
+  }
+  return DEFAULT_LINK_ORIGIN;
+}
+
+export async function linkBase(opts = {}) {
+  const t = target(opts);
+  if (t.name === "dev") return t.shareBase;
+  const env = process.env.HYPERDECKS_LINK_ORIGIN?.trim();
+  if (env) {
+    if (isLinkHost(env) || /^http:\/\/(localhost|127\.0\.0\.1)(:\d+)?\/?$/.test(env)) return normalizeBase(env).toLowerCase();
+    console.warn(`warning: HYPERDECKS_LINK_ORIGIN must be ${LINK_HOSTS.join(" or ")} (or a localhost URL); ignoring ${JSON.stringify(env)}`);
+  }
+  if (linkOriginPin) return linkOriginPin;
+  // A caller's own client (the hosted MCP, tests) is asked each time.
+  if (opts.client) return askLinkOrigin(opts.client);
+  if (!linkOriginCache.has(t.convexUrl)) linkOriginCache.set(t.convexUrl, askLinkOrigin(new ConvexHttpClient(t.convexUrl)));
+  return linkOriginCache.get(t.convexUrl);
+}
+
+// The same link on the other app host, for a recipient whose network blocks
+// the printed one; null for a link that is not on an app host (dev).
+export function backupLinkUrl(url) {
+  const m = /^(https?:\/\/[^/]+)(\/.*)$/.exec(String(url || ""));
+  if (!m) return null;
+  const i = LINK_HOSTS.indexOf(m[1].toLowerCase());
+  return i < 0 ? null : `${LINK_HOSTS[1 - i]}${m[2]}`;
+}
+
 export function loadCreds() {
   if (!existsSync(CRED_FILE)) return {};
   try {

package/templates/layouts/_deck.html

@@ -76,6 +76,12 @@
   .narration-slot { position: absolute; right: 56px; bottom: 64px; }
   .slot-left .narration-slot { right: auto; left: 56px; }
   .slot-top .narration-slot { top: 96px; bottom: auto; }
+  /* No presenter (no face AND no captions, e.g. presenter none on a
+     data-silent deck; or forced off by setPresenterOff): the player puts
+     .hd-no-presenter on the root and hides the slot, each layout's
+     no-presenter variant (:root.hd-no-presenter .l-…) uses the corner, and on
+     phones the slide drops its 170px bottom padding (below). Keep custom slides
+     compatible: leave the corner to .narration-slot, no hard-coded right gutter. */
   .reveal { opacity: 0; transform: translateY(12px); transition: opacity .5s, transform .5s; }
   .reveal.is-revealed { opacity: 1; transform: none; }
   /* The phone card (product's .frame.card, the phones row): a frameless phone,
@@ -136,6 +142,7 @@
     :root { --t-display: 54px; --t-title: 38px; --t-sub: 28px; --t-lead: 17px; --t-body: 15px; --t-label: 12px; }
     .slide { padding: 28px 20px 170px; gap: 14px; }
     .narration-slot { right: 12px; left: 12px; bottom: 64px; }
+    :root.hd-no-presenter .slide { padding-bottom: 28px; }
     .slide .frame.card { width: 160px; padding: 5px; border-width: 2px; border-radius: 24px; box-shadow: 8px 8px 0 var(--shadow); }
     .slide .frame.card > .shot { border-radius: 19px; border-width: 1px; }
     /* The text fills the card's width: the dots fade in towards the bottom, and the tiles stay off. */

package/templates/layouts/chart.html

@@ -4,6 +4,7 @@ summary: A chart of real numbers with its takeaway in one line; the presenter be
 use: a trend or a comparison in numbers. Its svg is a placeholder of made-up numbers check fails on: draw the real data with `hyperdecks chart` (render_chart; never a generated picture of a chart) as <img class="chart"> and name the data's source.
 slot: bottom-right
 presenter: stage
+nopresenter: The chart spans both columns, under the takeaway.
 cues: [look: #__ID__-chart] when the narration turns to it; [reveal: #__ID__-takeaway] at the point.
 script: Here are the numbers. [look: #__ID__-chart] The last bar is the one to see. [reveal: #__ID__-takeaway]
 -->
@@ -23,6 +24,10 @@ script: Here are the numbers. [look: #__ID__-chart] The last bar is the one to s
     .l-chart .chart { height: 210px; flex: none; }
     .l-chart .takeaway { padding-left: 12px; border-left-width: 4px; }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-chart .chart { grid-column: 1 / -1; }
+  }
 </style>
 <section class="slide l-chart" id="__ID__" data-chapter="The numbers" data-note="Data: name the source of the numbers and the period they cover.">
   <div class="kicker">The numbers</div>

package/templates/layouts/closer.html

@@ -4,6 +4,7 @@ summary: The last slide. One line, the one action to take (a command, a link) an
 use: the end. One call to action, never three. Label an ask that is not agreed as Proposed.
 slot: bottom-left
 presenter: stage
+nopresenter: The line and the action drop the left gutter and re-centre in the full frame.
 cues: [go: #__ID__-cta] at the action, [go: slot] and [wave] at the goodbye.
 script: That's it. [go: #__ID__-cta] Here is the one thing to do next. Thanks [go: slot] for watching! [wave]
 -->
@@ -16,6 +17,10 @@ script: That's it. [go: #__ID__-cta] Here is the one thing to do next. Thanks [g
     .l-closer .content { padding-left: 0; justify-content: flex-start; gap: 16px; }
     .l-closer .cta { padding: 12px 16px; border-radius: 14px; font-size: 15px; }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-closer .content { padding-left: 0; align-self: center; align-items: center; text-align: center; }
+  }
 </style>
 <section class="slide on-ink l-closer slot-left" id="__ID__" data-chapter="Next" data-note="Closing slide: the link or command is the deck's own call to action.">
   <div class="content">

package/templates/layouts/compare.html

@@ -4,6 +4,7 @@ summary: Before and after (or them and us) side by side, three short lines each.
 use: the change your idea makes. Keep the rows parallel so each line has its counterpart.
 slot: bottom-right
 presenter: stage
+nopresenter: The two columns widen to the full frame.
 cues: [look: #__ID__-before] on the old way, [go: #__ID__-after] on the new; [go: slot] to come home.
 script: Today it looks like this. [look: #__ID__-before] With us, [go: #__ID__-after] it looks like this. [go: slot]
 -->
@@ -21,6 +22,10 @@ script: Today it looks like this. [look: #__ID__-before] With us, [go: #__ID__-a
     .l-compare .label { margin-bottom: 4px; }
     .l-compare li { padding: 5px 0; }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-compare .cols { max-width: none; }
+  }
 </style>
 <section class="slide l-compare" id="__ID__" data-chapter="Before and after" data-note="Source: name where each side's facts come from.">
   <div class="kicker">Before and after</div>

package/templates/layouts/features.html

@@ -4,6 +4,7 @@ summary: Three features side by side, an icon, a name and one line each; the pre
 use: what it does, the three reasons, the three parts. Swap each icon for a real one: `hyperdecks icons search <word>` (search_icons) gives inline SVG in currentColor.
 slot: bottom-right
 presenter: stage
+nopresenter: The title and cards centre vertically and the cards grow a little, instead of leaving a strip below for the presenter.
 cues: [go: #__ID__-f1], [go: #__ID__-f2], [go: #__ID__-f3] at the word that starts each, then [go: slot].
 script: It does three things. First, [go: #__ID__-f1] it writes. Then [go: #__ID__-f2] it speaks. Last, [go: #__ID__-f3] it sends. [go: slot]
 -->
@@ -22,6 +23,11 @@ script: It does three things. First, [go: #__ID__-f1] it writes. Then [go: #__ID
     .l-features b { font-size: 18px; }
     .l-features p { font-size: 13px; }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-features { justify-content: center; }
+    :root.hd-no-presenter .l-features .card { padding: 36px 34px; }
+  }
 </style>
 <section class="slide l-features" id="__ID__" data-chapter="What it does" data-note="Source: name the spec, docs or repo each feature is described in.">
   <div class="kicker">What it does</div>

package/templates/layouts/hero.html

@@ -4,6 +4,7 @@ summary: The opening. One display-size line, a visual on the right, the presente
 use: the first slide; a section opener. Its .art is a placeholder check fails on: put in a picture of the real subject (gen-image / generate_image) as <img class="art">, or delete the div and let the presenter be the visual.
 slot: bottom-right
 presenter: stage
+nopresenter: With art (the placeholder div counts), unchanged: the art already fills the right. Delete the art and the line re-centres in the full frame.
 cues: [wave] at the hello, [look: h1] when the narration says the title.
 script: Hi, [wave] this is __TITLE__. [look: h1] One idea, in a few minutes.
 -->
@@ -21,6 +22,10 @@ script: Hi, [wave] this is __TITLE__. [look: h1] One idea, in a few minutes.
     .l-hero .art { width: 100%; height: 230px; -webkit-mask-image: linear-gradient(to bottom, #000 60%, transparent); mask-image: linear-gradient(to bottom, #000 60%, transparent); }
     .l-hero div.art::after { left: 50%; top: 45%; padding: 8px 14px; border-width: 2px; font-size: 13px; }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-hero:not(:has(> .art)) .content { align-self: center; align-items: center; text-align: center; max-width: 1200px; }
+  }
 </style>
 <section class="slide on-accent l-hero" id="__ID__" data-chapter="Hello" data-note="Title slide: no facts.">
   <div class="art" role="presentation"></div>

package/templates/layouts/number.html

@@ -4,6 +4,7 @@ summary: One big number, what it measures and its source. The number is the slid
 use: proof, traction, a before/after delta. Never an estimate shown as fact: the source line is required.
 slot: bottom-right
 presenter: stage
+nopresenter: The figure, title and source re-centre in the full frame.
 cues: [look: #__ID__-figure] as the narration says the number; [reveal: #__ID__-source] optional.
 script: Here is the number that matters. [look: #__ID__-figure] Three times faster.
 -->
@@ -17,6 +18,10 @@ script: Here is the number that matters. [look: #__ID__-figure] Three times fast
     .l-number .content { justify-content: flex-start; gap: 12px; }
     .l-number .figure { font-size: 120px; }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-number .content { align-self: center; align-items: center; text-align: center; max-width: 1200px; }
+  }
 </style>
 <section class="slide on-ink l-number" id="__ID__" data-chapter="The number" data-note="Source: name the dashboard, report or email the number comes from, with its date.">
   <div class="content">

package/templates/layouts/phones.html

@@ -4,6 +4,7 @@ summary: A fanned row of two to four phone cards (the inner ones larger and in f
 use: a phone app's flow or its key screens. Each card's .shot is a placeholder check fails on: put in a phone-size screenshot (`hyperdecks screenshot <url> --width 390 --height 844`, capture_url) as <img class="shot">, or a screen recording as <video class="shot" autoplay muted loop playsinline>. Two to four cards: the row spaces and tilts them (on phones only the first three show); change one card's --tilt or --shadow on it. One phone only: use product with .frame.card.
 slot: bottom-left
 presenter: stage
+nopresenter: The copy centres vertically beside the row instead of leaving the bottom-left free.
 cues: [look: #__ID__-row] when the narration turns to the app; [go: #__ID__-p1] … [go: #__ID__-p3] to walk the screens, then [go: slot].
 script: Here is the app on a phone. [look: #__ID__-row] You start here, [go: #__ID__-p1] you pick one, [go: #__ID__-p2] and it is done. [go: #__ID__-p3] [go: slot]
 -->
@@ -32,6 +33,10 @@ script: Here is the app on a phone. [look: #__ID__-row] You start here, [go: #__
     .l-phones .row > .frame.card:nth-child(n + 4) { display: none; }
     .l-phones .row:has(> :nth-child(4)) > .frame.card:nth-child(3) { --tilt: 7deg; --shadow: var(--accent-3); width: 108px; translate: 0 16px; }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-phones .text { align-self: center; }
+  }
 </style>
 <section class="slide l-phones slot-left bg-dots" id="__ID__" data-chapter="On a phone" data-note="Phone screens: name the app build and the date they were captured.">
   <div class="text">

package/templates/layouts/product.html

@@ -4,6 +4,7 @@ summary: A product screenshot in a browser frame (for a phone shot, .frame.card:
 use: a demo moment. Its .shot is a placeholder check fails on: put in `hyperdecks screenshot <url>` (capture_url) output as <img class="shot">; a callout chip names what to look at. For a phone app, make the frame `<div class="frame card" id="__ID__-frame">` holding only the shot (a phone screenshot or a `<video class="shot" autoplay muted loop playsinline>` clip) and the callout; tilt and shadow colour are `--tilt` and `--shadow` on it. `.frame.phone` (the black bezel) stays for older decks.
 slot: bottom-right
 presenter: stage
+nopresenter: The copy centres vertically beside the screenshot instead of leaving the bottom-right free.
 cues: [look: #__ID__-frame] when the narration turns to the product; [reveal: #__ID__-callout] for the detail.
 script: This is the product. [look: #__ID__-frame] Look at this part. [reveal: #__ID__-callout]
 -->
@@ -45,6 +46,10 @@ script: This is the product. [look: #__ID__-frame] Look at this part. [reveal: #
     .l-product .frame.card { align-self: center; }
     .l-product .callout { left: 10px; bottom: 10px; padding: 6px 12px; font-size: 12px; }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-product .text { align-self: center; }
+  }
 </style>
 <section class="slide l-product" id="__ID__" data-chapter="The product" data-note="Screenshot: name the page and the date it was captured.">
   <div class="text">

package/templates/layouts/quote.html

@@ -4,6 +4,7 @@ summary: One quote, large, with who said it. The quote is the title.
 use: a customer or user in their own words. Quote them exactly and name the source in data-note.
 slot: bottom-left
 presenter: stage
+nopresenter: The quote drops its left gutter and re-centres in the full frame.
 cues: [look: #__ID__-quote] as the narration reads it.
 script: In their words. [look: #__ID__-quote] Here is what they told us.
 -->
@@ -20,6 +21,11 @@ script: In their words. [look: #__ID__-quote] Here is what they told us.
     .l-quote .quote { font-size: 32px; }
     .l-quote .avatar { width: 44px; height: 44px; font-size: 16px; }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-quote .content { padding-left: 0; align-self: center; align-items: center; text-align: center; max-width: 1240px; }
+    :root.hd-no-presenter .l-quote .quote { text-indent: 0; }
+  }
 </style>
 <section class="slide on-accent l-quote slot-left" id="__ID__" data-chapter="In their words" data-note="Quote: name who said it, where (email, call, review) and when.">
   <figure class="content">

package/templates/layouts/split.html

@@ -4,6 +4,7 @@ summary: Image plus copy: the copy on the left (a sticker for the logo or icon,
 use: the workhorse for a product, a feature or an app: most slides of a good deck are this one. The phone's .shot is a placeholder check fails on: put in a phone screenshot (capture_url at 390×844) or a screen recording (upload_deck_asset) as <img class="shot"> or <video class="shot" autoplay muted loop playsinline>. For a desktop app, replace the card with <div class="frame laptop" id="__ID__-frame"><img class="shot" src="…" alt="…"></div>; for a 16:9 clip or photo, <img class="shot wide" src="…" alt="…" id="__ID__-frame">. Swap the sticker's icon for the product's logo (<span class="sticker photo"><img src="…" alt=""></span>) or one icon from the deck's set.
 slot: bottom-left
 presenter: stage
+nopresenter: The copy centres vertically beside the picture instead of leaving the bottom-left free.
 cues: [look: #__ID__-frame] when the narration turns to the picture; [go: #__ID__-t1], [go: #__ID__-t2], [go: #__ID__-t3] at the word that starts each tick, then [go: slot].
 script: Here it is, doing the job. [look: #__ID__-frame] It starts with [go: #__ID__-t1] the first thing. Then [go: #__ID__-t2] the second. And [go: #__ID__-t3] the third. [go: slot]
 -->
@@ -26,6 +27,10 @@ script: Here it is, doing the job. [look: #__ID__-frame] It starts with [go: #__
     .l-split .frame.card { width: 128px; }
     .l-split .shot.wide { border-radius: 10px; box-shadow: 6px 6px 0 var(--accent); }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-split .text { align-self: center; padding-top: 0; }
+  }
 </style>
 <section class="slide l-split slot-left bg-lines" id="__ID__" data-chapter="The product" data-note="Picture: name the screen or clip and the date it was captured.">
   <div class="text">

package/templates/layouts/team.html

@@ -4,6 +4,7 @@ summary: Up to four people, a face, a name and a role each; the presenter flies
 use: who is behind it, who to talk to. Use real photos only with permission; initials otherwise.
 slot: bottom-right
 presenter: stage
+nopresenter: The title and people centre vertically and the cards grow a little, instead of leaving a strip below for the presenter.
 cues: [go: #__ID__-p1] … [go: #__ID__-p4] at each name, then [go: slot].
 script: Meet the team. [go: #__ID__-p1] Ana builds it. [go: #__ID__-p2] Sam sells it. [go: #__ID__-p3] Lee runs it. [go: #__ID__-p4] Kai designs it. [go: slot]
 -->
@@ -23,6 +24,11 @@ script: Meet the team. [go: #__ID__-p1] Ana builds it. [go: #__ID__-p2] Sam sell
     .l-team b { font-size: 16px; }
     .l-team small { font-size: 10px; }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-team { justify-content: center; }
+    :root.hd-no-presenter .l-team .person { padding: 32px 30px; }
+  }
 </style>
 <section class="slide l-team" id="__ID__" data-chapter="The team" data-note="People: names and roles as they gave them; photos only with their permission.">
   <div class="kicker">The team</div>

package/templates/layouts/timeline.html

@@ -4,6 +4,7 @@ summary: Four milestones on a line, left to right, the presenter flying under ea
 use: history, a roadmap, a process over time. Label future steps "Proposed" if not agreed.
 slot: bottom-right
 presenter: stage
+nopresenter: The title and milestones centre vertically instead of leaving a strip below for the presenter.
 cues: [go: #__ID__-m1] … [go: #__ID__-m4] at the word that starts each milestone, then [go: slot].
 script: It started [go: #__ID__-m1] with a sketch. Then [go: #__ID__-m2] a first user. Then [go: #__ID__-m3] a launch. Next, [go: #__ID__-m4] the plan. [go: slot]
 -->
@@ -25,6 +26,10 @@ script: It started [go: #__ID__-m1] with a sketch. Then [go: #__ID__-m2] a first
     .l-timeline b { font-size: 18px; margin-bottom: 2px; }
     .l-timeline p { font-size: 13px; }
   }
+  /* No presenter (:root.hd-no-presenter: no face and no captions, deck_guide look): the corner is free. Phones keep this layout's rules. */
+  @media (min-width: 651px) {
+    :root.hd-no-presenter .l-timeline { justify-content: center; }
+  }
 </style>
 <section class="slide l-timeline" id="__ID__" data-chapter="How we got here" data-note="Source: name where each date comes from.">
   <div class="kicker">How we got here</div>