thursday-agent 0.10.0 → 0.11.0

package/scripts/live-session.test.mts

@@ -860,7 +860,7 @@ test("stored settings keep OpenAI choices and the shared instruction, drop a Gro
   assert.deepEqual(migrateLiveSettings(null), LIVE_DEFAULTS);
 });
 
-test("both call prompts open as one Thursday: the voice gets a two-line delegation policy and memory and no earlier calls, the backend carries work on in threads, and every call has an opening", async () => {
+test("both call prompts open as one Thursday: the voice gets the guide's delegation policy and memory and no earlier calls, the backend carries work on in threads, and every call has an opening", async () => {
   let profileFacts = 200;
   let samFacts = 2;
   const botMock = mock.module("../features/bot/bot.query.ts", {
@@ -949,13 +949,12 @@ test("both call prompts open as one Thursday: the voice gets a two-line delegati
     );
     const on = await loadLivePrompt({
       voicePrompt: "Use a calm voice.",
-      locale: "ko-KR",
     });
     assert.match(on.text, /modeled on Friday, the AI in \*Iron Man\*/);
     assert.match(on.text, /Prefer brief replies/);
     assert.match(
       on.text,
-      /\n\n## Always\n\nIMPORTANT — always follow this: [^\n]+\n\nBackchannel policy: Use moderate backchannels\. .*\n\nInterruption policy: Stop speaking when the user interrupts\. Listen to what they say\.\n\nDelegation policy:\nDelegate to the backend everything [^\n]+\nWhatever they tell you about themselves[^\n]+unless it is already written below\.\nAnswer from what the backend returns[^\n]+\n\n## What you know about them\n/,
+      /\n\n## Always\n\nIMPORTANT — always follow this: [^\n]+\n\nBackchannel policy: Use moderate backchannels\. .*\n\nInterruption policy: Stop speaking when the user interrupts\. Listen to what they say\.\n\nSpeak the language the user is speaking, [^\n]+\n\nDelegation policy:\nBackend tools:\n- Ending the call: [^\n]+\n(- [^\n]+\n){4}\nDelegate to the backend when:\n- The user wants the call to end\.\n(- [^\n]+\n)+\nDo not delegate to the backend when:\n(- [^\n]+\n)+\nDelegate before giving an answer that depends on backend work\. Do not guess the result while waiting\.\n\n## What you know about them\n/,
     );
     // Only the ending rule carries the stamp
     assert.equal(on.text.split("IMPORTANT").length, 2);
@@ -963,13 +962,10 @@ test("both call prompts open as one Thursday: the voice gets a two-line delegati
       on.text,
       /When the user speaks at length, acknowledge now and then/,
     );
-    // What the backend can do, and when to hand over, are no longer the voice's to read
-    assert.equal(
-      /Backend tools|Delegate to the backend when|What bots can reach for|- Web:/.test(
-        on.text,
-      ),
-      false,
-    );
+    // What the backend can do, never how: no skills, connected tools or bots by name
+    assert.equal(/What bots can reach for|- Web:/.test(on.text), false);
+    // Stopping her voice is hers, stopping a job the backend's
+    assert.match(on.text, /or only want you to stop talking/);
     assert.match(on.text, /- people\/sam — Their brother \(2\) "Sam"/);
     assert.match(on.text, /What is in these notes, the backend recalls\./);
     // The roster, threads and earlier calls are the backend's to read
@@ -979,32 +975,33 @@ test("both call prompts open as one Thursday: the voice gets a two-line delegati
       false,
     );
     assert.equal("input" in on, false);
-    assert.equal(
-      /ko-KR|browser's setting|language they use/.test(on.text),
-      false,
-    );
     assert.equal(/memory_|generate_|load_skill|`/.test(on.text), false);
-    // The one tool name the voice holds: the ending rule, where it makes ending a thing to do
+    // The one tool name the voice holds: the ending rule, where it makes ending a thing to do.
+    // It holds no tools, so the rule is to hand the turn over, not to use the tool
     assert.equal(on.text.split("end_call").length, 2);
     assert.match(
       on.text,
-      /immediately, without thinking, use the end_call tool\./,
+      /answer yes in one word of their language and hand it to the backend at once\. Only the backend can end the line, with the end_call tool/,
     );
     assert.equal(on.text.endsWith("Use a calm voice."), true);
     assert.match(on.opening, /The call has just started/);
 
-    // One Thursday: the backend opens with the voice's own words and is never told it is a part
+    // One Thursday: the backend opens with the voice's own identity and is never told it is a
+    // part; its ending rule is its own, since only it can end the line
     const backend = await loadThursdayPrompt(null);
     const withoutClock = (text: string) =>
       text.replace(/\*\*Now\*\*: [^\n]+/, "");
     const identity = on.text.slice(0, on.text.indexOf("\n\n## Always"));
-    const ending = /IMPORTANT — always follow this: [^\n]+/.exec(on.text)?.[0];
     assert.equal(
       withoutClock(backend).startsWith(
-        `${withoutClock(identity)}\n\n${ending}\n\n`,
+        `${withoutClock(identity)}\n\nIMPORTANT — always follow this: `,
       ),
       true,
     );
+    assert.match(
+      backend,
+      /forget every other task, answer yes in one word of their language, then immediately, without thinking, use the end_call tool\./,
+    );
     assert.match(
       backend,
       /\*\*Keep memory clean as you write\.\*\* A fact that repeats, narrows or changes one already in the note replaces it/,
@@ -1045,7 +1042,7 @@ test("both call prompts open as one Thursday: the voice gets a two-line delegati
 
     // Tidying memory is the backend's: the voice neither reads it nor opens with it
     samFacts = 60;
-    const heavy = await loadLivePrompt({ locale: null });
+    const heavy = await loadLivePrompt({});
     assert.equal(/tidying|grown past/.test(heavy.text), false);
     assert.match(heavy.opening, /The call has just started/);
     assert.match(
@@ -1055,19 +1052,15 @@ test("both call prompts open as one Thursday: the voice gets a two-line delegati
     samFacts = 2;
 
     profileFacts = 0;
-    const first = await loadLivePrompt({ locale: "ko-KR" });
+    const first = await loadLivePrompt({});
     assert.match(first.text, /## First call/);
     // The one call that opens with nothing: she says who she is, then learns who they are
     assert.match(first.opening ?? "", /say who you are/);
     assert.match(first.opening ?? "", /ask what to call them/);
-    assert.match(first.opening ?? "", /ko-KR/);
     assert.match(first.text, /what they do, how old they are, where they live/);
 
     // A call the page placed says so, ahead of even the first-call opening
-    const rung = await loadLivePrompt({
-      locale: "ko-KR",
-      calledBack: true,
-    });
+    const rung = await loadLivePrompt({ calledBack: true });
     assert.match(rung.opening, /You placed this call/);
     assert.match(rung.opening, /say that is why you called/);
   } finally {

package/seed-skills/analyst/README.md

@@ -5,7 +5,7 @@ created. It is listed to that bot alone.
 
 | Skill | What it adds |
 |---|---|
-| `data-report` | Seven report forms, each with its structure and a filled example; `fetch.mjs`, which pulls a published series (FRED, World Bank, Yahoo Finance, ECB rates, SEC filings, Wikipedia pageviews) into a CSV that names its source; `chart.mjs`, which draws a CSV into a quick page as a cited figure |
+| `data-report` | Seven report forms, each with its structure and a filled example; `fetch.mjs`, which pulls a published series (FRED, World Bank, Yahoo Finance, ECB rates, SEC filings, Wikipedia pageviews) into a CSV that names its source |
 
 Written for this app. The forms borrow their shape from answer-first business writing and from the
 report outlines in [anthropics/financial-services](https://github.com/anthropics/financial-services)
@@ -13,7 +13,6 @@ and [anthropics/knowledge-work-plugins](https://github.com/anthropics/knowledge-
 (Apache-2.0); no text is copied from either. Those skills write Word, PowerPoint and Excel files and
 read paid data connectors, which is why they are not taken whole.
 
-`chart.mjs` fills a page made by the shipped `interactive-page` skill's quick path and uses its
-colour tokens; it draws inline SVG, so the page still opens with no network. The scripts need Node
-and no packages. Every source they call answers without a key; `references/sources.md` names the
+Charts are drawn by the shipped `interactive-page` skill's `chart.mjs` into its quick page. The
+scripts need Node and no packages. Every source they call answers without a key; `references/sources.md` names the
 ones that need one.

package/seed-skills/analyst/data-report/SKILL.md

@@ -44,16 +44,17 @@ When the form calls for a page, start it as a quick page from your Skills list (
 in your folder under `artifacts/`) and write its words by hand. It arrives styled: replace the title
 and the lede line and write below them, and leave its `<head>` as it is. Never write chart SVG or a
 data table by hand: leave an empty `<figure id="…"></figure>` where each chart goes, then fill every
-one in one bash call.
+one in one bash call. The chart script ships with the app:
 
 ```bash
-node $S/chart.mjs "$THURSDAY_ARTIFACTS/<page>.html" rates <scratch>/rates.csv \
+C="$THURSDAY_SKILLS/interactive-page/scripts/chart.mjs"
+node $C "$THURSDAY_ARTIFACTS/<page>.html" rates <scratch>/rates.csv \
   --title "Mortgage rates followed the 10-year down" --unit "%" --mark "2024-09=First Fed cut" --locale ko
-node $S/chart.mjs "$THURSDAY_ARTIFACTS/<page>.html" px <scratch>/px.csv --index --title "…"
+node $C "$THURSDAY_ARTIFACTS/<page>.html" px <scratch>/px.csv --index --title "…"
 ```
 
 Each figure carries its source link, the fetch date and the rows behind it with a CSV download, so
 the page needs no separate data section. A line for dates, bars for categories (largest first,
 `--highlight` the one that matters); `--index` when series in different units are compared;
 `--mark` for each dated event the text explains. Run it again to replace a figure.
-`node $S/chart.mjs` with no arguments lists every option.
+`node $C` with no arguments lists every option.

package/seed-skills/insta/instagram/SKILL.md

@@ -22,10 +22,13 @@ https://www.instagram.com/`. A script that says "Not signed in" means that step
 | `search.mjs "<topic>" [--type reel\|carousel\|image] [--sheet covers.png]` | What Instagram's search shows, with likes, and the accounts behind it |
 | `profile.mjs <handle> [--posts 12] [--out posts.json] [--sheet covers.png]` | How an account posts: type, slides, ratio, caption and tags per post, and the pattern |
 | `sheet.mjs --out sheet.png <posts.json> [--post N]` | Covers, or one post's slides, as one image to `look_at` once |
-| `webimage.mjs <page url> --out <dir> [--all]` | A news page's own picture, saved, with the credit line |
-| `render.mjs <slides.html> --size 1080x1350 --out <dir>` | Each `[data-slide]` to a PNG of exactly that size |
 | `compose.mjs --ratio 4:5 --caption <file> [--ai-label] [--shot last.png] <png>...` | The composer up to its last screen, crop set; never presses Share. `--discard` throws a draft away |
 
+Two more are the browser skill's, `node $THURSDAY_SKILLS/browser/scripts/<name>.mjs`:
+`webimage.mjs <page url> --out <dir> [--all]` saves a news page's own picture with its credit
+line, and `render.mjs <slides.html> --size 1080x1350 --out <dir>` turns each `[data-slide]` into
+a PNG of exactly that size.
+
 A script that stops with "Selectors changed" means Instagram moved something: snapshot that
 page once, fix the line in `scripts/selectors.mjs`, and run it again.
 

package/seed-skills/insta/instagram/references/post.md

@@ -34,7 +34,7 @@ accounts and the date, and read it next time instead of studying again.
 
 ## 3. Pictures
 
-- **Something that happened**: the real picture. `webimage.mjs <article url> --out <post dir>`
+- **Something that happened**: the real picture. `node $THURSDAY_SKILLS/browser/scripts/webimage.mjs <article url> --out <post dir>`
   saves the page's own picture and prints the credit line; `--all` adds the large pictures
   in the article. A person in the story: their photo from the article or an official page.
   Put the credit on the slide.
@@ -51,7 +51,7 @@ from the pattern. Feed is 1080x1350 (4:5) or 1080x1080 (1:1); every slide of a c
 the same size.
 
 ```bash
-node <skill>/scripts/render.mjs <post dir>/carousel.html --size 1080x1350 --out <post dir>/png \
+node $THURSDAY_SKILLS/browser/scripts/render.mjs <post dir>/carousel.html --size 1080x1350 --out <post dir>/png \
   && node <skill>/scripts/sheet.mjs --out <post dir>/check.png <post dir>/png/*.png
 ```
 

package/seed-skills/insta/instagram/scripts/compose.mjs

@@ -10,9 +10,13 @@
  */
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
-import { fail, inPage, orFail, parseArgs } from "./lib.mjs";
+import { shipped } from "./lib.mjs";
 import { SEL } from "./selectors.mjs";
 
+const { fail, inPage, orFail, parseArgs } = await shipped(
+  "browser/scripts/session.mjs",
+);
+
 const opts = parseArgs();
 
 if (opts.discard) {

package/seed-skills/insta/instagram/scripts/inbox.mjs

@@ -5,9 +5,13 @@
  *
  *   node inbox.mjs [--folder primary|general|requests] [--max 30] [--unread] [--json]
  */
-import { fail, inPage, oneLine, orFail, parseArgs, stamp } from "./lib.mjs";
+import { oneLine, shipped, stamp } from "./lib.mjs";
 import { SEL } from "./selectors.mjs";
 
+const { fail, inPage, orFail, parseArgs } = await shipped(
+  "browser/scripts/session.mjs",
+);
+
 const opts = parseArgs();
 const folder = opts.folder ?? "primary";
 if (!SEL.folders[folder])

package/seed-skills/insta/instagram/scripts/lib.mjs

@@ -1,78 +1,20 @@
-import { execFile } from "node:child_process";
-import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { pathToFileURL } from "node:url";
 
 /**
- * Runs `fn(page, args, helpers)` in this shell's own browser session
- * (PLAYWRIGHT_CLI_SESSION) through `playwright-cli run-code`, and resolves to what
- * it returned. `fn` and each helper are sent as source, so they see nothing of
- * their module: what they need comes in `args`. They run in a bare VM beside the
- * browser — no timers, no require — so waits are `page.waitForTimeout` and
- * `page.waitForFunction`, and files are written by the caller from what returns.
+ * A script shipped with the app, by its path under the skills folder
+ * ("browser/scripts/session.mjs" drives this shell's own browser session). A bot's
+ * shell names that folder in THURSDAY_SKILLS.
  */
-export async function inPage(fn, args = {}, helpers = {}) {
-  const lib = Object.entries(helpers)
-    .map(([name, helper]) => `${name}: ${helper}`)
-    .join(", ");
-  const code = `async page => (${fn})(page, ${JSON.stringify(args)}, { ${lib} })`;
-  // One argument is capped (128 KB on Linux): longer code goes as a file
-  const dir = code.length > 64_000 ? mkdtempSync(join(tmpdir(), "run-")) : null;
-  if (dir) writeFileSync(join(dir, "code.js"), code);
-  const out = await new Promise((resolve) =>
-    execFile(
-      "playwright-cli",
-      dir
-        ? ["--raw", "run-code", `--filename=${join(dir, "code.js")}`]
-        : ["--raw", "run-code", code],
-      { encoding: "utf8", maxBuffer: 256 * 1024 * 1024 },
-      (error, stdout, stderr) => {
-        if (dir) rmSync(dir, { recursive: true, force: true });
-        if (!error) return resolve(stdout.trim());
-        const said = `${stdout ?? ""}${stderr ?? ""}`.trim();
-        fail(
-          /not open|no (open )?browser/i.test(said)
-            ? "No browser is open in this session. `playwright-cli open`, sign in, then run this again."
-            : `The browser answered with an error:\n${said.slice(0, 800)}`,
-        );
-      },
-    ),
-  );
-  if (!out) return undefined;
-  try {
-    return JSON.parse(out);
-  } catch {
-    fail(`Unexpected answer from the browser:\n${out.slice(0, 800)}`);
+export async function shipped(path) {
+  const root = process.env.THURSDAY_SKILLS;
+  if (!root) {
+    process.stderr.write(
+      "THURSDAY_SKILLS is not set: run this from a bot's shell in the app.\n",
+    );
+    process.exit(1);
   }
-}
-
-/** `--name value` and `--flag` pairs, and the rest as positionals. */
-export function parseArgs(argv = process.argv.slice(2)) {
-  const opts = { _: [] };
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (!a.startsWith("--")) {
-      opts._.push(a);
-      continue;
-    }
-    const [key, inline] = a.slice(2).split("=", 2);
-    if (inline !== undefined) opts[key] = inline;
-    else if (argv[i + 1] !== undefined && !argv[i + 1].startsWith("--"))
-      opts[key] = argv[++i];
-    else opts[key] = true;
-  }
-  return opts;
-}
-
-export function fail(message) {
-  process.stderr.write(`${message}\n`);
-  process.exit(1);
-}
-
-/** A page-side answer `{ error }` stops the script with that message. */
-export function orFail(result) {
-  if (result && typeof result === "object" && result.error) fail(result.error);
-  return result;
+  return import(pathToFileURL(join(root, path)).href);
 }
 
 /** Local time, minutes precision: what a person reads, and what `--since` takes. */

package/seed-skills/insta/instagram/scripts/media.mjs

@@ -1,7 +1,7 @@
 /**
  * One post as these scripts report it, from the media record Instagram's own
  * pages fetch (a profile's timeline, a search). `media` is sent into the browser
- * session as source (lib inPage helpers), so it uses nothing from outside itself.
+ * session as source (an inPage helper), so it uses nothing from outside itself.
  */
 export function media(o) {
   const slides = o.carousel_media ?? [];

package/seed-skills/insta/instagram/scripts/profile.mjs

@@ -7,9 +7,13 @@
  *   node profile.mjs <handle | profile url> [--posts 12] [--out posts.json] [--sheet covers.png]
  */
 import { writeFileSync } from "node:fs";
-import { fail, inPage, orFail, parseArgs } from "./lib.mjs";
+import { shipped } from "./lib.mjs";
 import { media, patterns, postLine, short } from "./media.mjs";
-import { makeSheet } from "./sheet.mjs";
+
+const { fail, inPage, orFail, parseArgs } = await shipped(
+  "browser/scripts/session.mjs",
+);
+const { makeSheet } = await shipped("browser/scripts/sheet.mjs");
 
 const opts = parseArgs();
 const handle = String(opts._[0] ?? "")

package/seed-skills/insta/instagram/scripts/read.mjs

@@ -10,9 +10,13 @@
  * the top of the thread, or two rounds that brought nothing new.
  */
 import { writeFileSync } from "node:fs";
-import { fail, inPage, oneLine, orFail, parseArgs, stamp } from "./lib.mjs";
+import { oneLine, shipped, stamp } from "./lib.mjs";
 import { SEL } from "./selectors.mjs";
 
+const { fail, inPage, orFail, parseArgs } = await shipped(
+  "browser/scripts/session.mjs",
+);
+
 const opts = parseArgs();
 const target = opts._[0];
 if (!target || !opts.out)

package/seed-skills/insta/instagram/scripts/search.mjs

@@ -7,9 +7,13 @@
  *   node search.mjs "<topic>" [--type reel|carousel|image] [--max 24] [--out found.json] [--sheet covers.png]
  */
 import { writeFileSync } from "node:fs";
-import { fail, inPage, orFail, parseArgs } from "./lib.mjs";
+import { shipped } from "./lib.mjs";
 import { media, postLine, short } from "./media.mjs";
-import { makeSheet } from "./sheet.mjs";
+
+const { fail, inPage, orFail, parseArgs } = await shipped(
+  "browser/scripts/session.mjs",
+);
+const { makeSheet } = await shipped("browser/scripts/sheet.mjs");
 
 const opts = parseArgs();
 const topic = opts._[0];

package/seed-skills/insta/instagram/scripts/sheet.mjs

@@ -1,100 +1,43 @@
 #!/usr/bin/env node
 /**
- * Many pictures as one image, each with a label under it, so one look sees a
- * whole feed: covers side by side, or every slide of one post.
+ * A feed as one image, each picture with a label under it: the covers of every post
+ * `profile.mjs` or `search.mjs` saved, or every slide of one of them. Any other
+ * pictures go straight to the browser skill's sheet.
  *
  *   node sheet.mjs --out sheet.png <posts.json>              covers of every post
  *   node sheet.mjs --out sheet.png <posts.json> --post 3     every slide of post 3
  *   node sheet.mjs --out sheet.png <image url | file>...     any pictures
  */
 import { readFileSync } from "node:fs";
-import { extname, resolve } from "node:path";
-import { pathToFileURL } from "node:url";
-import { fail, inPage, orFail, parseArgs } from "./lib.mjs";
+import { shipped } from "./lib.mjs";
 import { short } from "./media.mjs";
 
-/** Pictures are fetched by the browser (page.request) and inlined, so the sheet needs no server. */
-export async function makeSheet(items, out, cols = 4) {
-  return orFail(
-    await inPage(
-      async (page, { items, out, cols }) => {
-        const cells = [];
-        for (const it of items) {
-          let src = it.data ?? "";
-          if (!src && it.src)
-            try {
-              const r = await page.request.get(it.src, { timeout: 30000 });
-              if (r.ok())
-                src = `data:${r.headers()["content-type"] ?? "image/jpeg"};base64,${(await r.body()).toString("base64")}`;
-            } catch {}
-          cells.push({ src, label: it.label });
-        }
-        const esc = (s) =>
-          String(s).replace(/[&<>"]/g, (c) => `&#${c.charCodeAt(0)};`);
-        const html = `<!doctype html><meta charset="utf-8"><style>
-          body{margin:0;background:#fff;font:13px/1.35 system-ui,sans-serif;color:#111}
-          .grid{display:grid;grid-template-columns:repeat(${cols},240px);gap:10px;padding:10px}
-          .cell img,.cell .none{width:240px;height:300px;object-fit:contain;background:#e8e8e8;display:block}
-          .cell div{padding:3px 2px;height:36px;overflow:hidden}</style>
-          <div class="grid">${cells
-            .map(
-              (c) =>
-                `<div class="cell">${c.src ? `<img src="${c.src}">` : `<div class="none"></div>`}<div>${esc(c.label)}</div></div>`,
-            )
-            .join("")}</div>`;
-        const tab = await page.context().newPage();
-        try {
-          await tab.setViewportSize({ width: cols * 250 + 10, height: 400 });
-          await tab.setContent(html, { waitUntil: "load" });
-          await tab.screenshot({ path: out, fullPage: true, scale: "css" });
-        } finally {
-          await tab.close();
-        }
-        return { out, missing: cells.filter((c) => !c.src).length };
-      },
-      { items, out: resolve(out), cols },
-    ),
-  );
-}
-
-const MIME = {
-  ".png": "image/png",
-  ".webp": "image/webp",
-  ".gif": "image/gif",
-};
-const inline = (path) =>
-  `data:${MIME[extname(path).toLowerCase()] ?? "image/jpeg"};base64,${readFileSync(path).toString("base64")}`;
+const { fail, parseArgs } = await shipped("browser/scripts/session.mjs");
+const { makeSheet, pictures } = await shipped("browser/scripts/sheet.mjs");
 
-if (import.meta.url === pathToFileURL(process.argv[1]).href) {
-  const opts = parseArgs();
-  if (!opts.out || !opts._.length)
-    fail(
-      "usage: node sheet.mjs --out sheet.png <posts.json> [--post N] | <image url | file>...",
-    );
-  let items;
-  if (opts._[0].endsWith(".json")) {
-    const saved = JSON.parse(readFileSync(opts._[0], "utf8"));
-    const posts = saved.posts ?? saved;
-    if (opts.post) {
-      const p = posts[Number(opts.post) - 1];
-      if (!p) fail(`No post ${opts.post}; there are ${posts.length}.`);
-      items = p.images.map((src, i) => ({
-        src,
-        label: `${i + 1}/${p.images.length} ${p.ratio ?? ""}`,
-      }));
-    } else
-      items = posts.map((p, i) => ({
-        src: p.cover,
-        label: `#${i + 1} ${p.type}${p.type === "carousel" ? `×${p.slides}` : ""} ${p.ratio ?? ""} likes ${short(p.likes)}${p.owner ? ` @${p.owner}` : ""}`,
-      }));
-  } else
-    items = opts._.map((x, i) =>
-      /^https?:/.test(x)
-        ? { src: x, label: `${i + 1}` }
-        : { data: inline(x), label: `${i + 1} ${x.split("/").pop()}` },
-    );
-  const made = await makeSheet(items, opts.out, Number(opts.cols ?? 4));
-  console.log(
-    `${made.out} — ${items.length} pictures${made.missing ? `, ${made.missing} did not load` : ""}`,
+const opts = parseArgs();
+if (!opts.out || !opts._.length)
+  fail(
+    "usage: node sheet.mjs --out sheet.png <posts.json> [--post N] | <image url | file>...",
   );
-}
+let items;
+if (opts._[0].endsWith(".json")) {
+  const saved = JSON.parse(readFileSync(opts._[0], "utf8"));
+  const posts = saved.posts ?? saved;
+  if (opts.post) {
+    const p = posts[Number(opts.post) - 1];
+    if (!p) fail(`No post ${opts.post}; there are ${posts.length}.`);
+    items = p.images.map((src, i) => ({
+      src,
+      label: `${i + 1}/${p.images.length} ${p.ratio ?? ""}`,
+    }));
+  } else
+    items = posts.map((p, i) => ({
+      src: p.cover,
+      label: `#${i + 1} ${p.type}${p.type === "carousel" ? `×${p.slides}` : ""} ${p.ratio ?? ""} likes ${short(p.likes)}${p.owner ? ` @${p.owner}` : ""}`,
+    }));
+} else items = pictures(opts._);
+const made = await makeSheet(items, opts.out, Number(opts.cols ?? 4));
+console.log(
+  `${made.out} — ${items.length} pictures${made.missing ? `, ${made.missing} did not load` : ""}`,
+);

package/seed-skills/insta/instagram/templates/carousel.html

@@ -1,6 +1,6 @@
 <!doctype html>
 <!--
-  A carousel: every <section data-slide> is one PNG (scripts/render.mjs).
+  A carousel: every <section data-slide> is one PNG (the browser skill's scripts/render.mjs).
   Set --w and --h to the size you render at. Pictures sit beside this file.
   Backgrounds: .bg is the picture filling the slide; add .blur, .dark or a
   .shade gradient over it until the text reads. .fit shows a whole picture

package/seed-skills/tutor/picture-book/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: picture-book
+description: "Explain anything as a picture book: one picture and at most two short lines a page, in one HTML file that is also its PDF and, read aloud, its mp4."
+---
+
+# A picture book
+
+```bash
+node <skill dir>/scripts/book.mjs new <name>                         # the book, in your artifacts folder
+node <skill dir>/scripts/book.mjs video <name> <audio>... [--size WxH]  # it read aloud, one audio file per page
+```
+
+Two things decide whether it works: **one idea a page, and the picture carries it** — cover
+the words and the page still says it — and **a technical word comes after its picture**. Read
+`references/picture-book.md` before the first page: how a page is written, where each picture
+comes from, the PDF, and the voice.