thursday-agent 0.9.0 → 0.11.0

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

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+/**
+ * How one account posts: its size, its latest posts (type, slides, ratio, how they
+ * did, caption shape), and the pattern across them — read from the data the
+ * profile page itself fetches, not from the screen.
+ *
+ *   node profile.mjs <handle | profile url> [--posts 12] [--out posts.json] [--sheet covers.png]
+ */
+import { writeFileSync } from "node:fs";
+import { shipped } from "./lib.mjs";
+import { media, patterns, postLine, short } from "./media.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] ?? "")
+  .replace(/^https?:\/\/(www\.)?instagram\.com\//, "")
+  .replace(/^@/, "")
+  .split(/[/?]/)[0];
+if (!handle)
+  fail(
+    "usage: node profile.mjs <handle> [--posts 12] [--out posts.json] [--sheet covers.png]",
+  );
+const want = Number(opts.posts ?? 12);
+
+const started = Date.now();
+const got = orFail(
+  await inPage(
+    async (page, { handle, want }, { media }) => {
+      const posts = [];
+      let profile = null;
+      let more = true;
+      const first = (text) => JSON.parse(text.split("\n")[0]);
+      const listen = async (res) => {
+        if (!/\/graphql/.test(res.url())) return;
+        let text;
+        try {
+          text = await res.text();
+        } catch {
+          return;
+        }
+        try {
+          if (
+            text.includes("xdt_api__v1__feed__user_timeline_graphql_connection")
+          ) {
+            const c =
+              first(text).data
+                ?.xdt_api__v1__feed__user_timeline_graphql_connection;
+            for (const e of c?.edges ?? []) posts.push(media(e.node));
+            more = Boolean(c?.page_info?.has_next_page);
+          } else if (!profile && text.includes('"follower_count"')) {
+            const u = first(text).data?.user;
+            if (u?.username?.toLowerCase() === handle.toLowerCase())
+              profile = {
+                handle: u.username,
+                name: u.full_name,
+                followers: u.follower_count,
+                following: u.following_count ?? null,
+                posts: u.media_count ?? null,
+                verified: u.is_verified,
+                private: u.is_private,
+                category: u.category ?? null,
+                bio: u.biography ?? "",
+                link: u.bio_links?.[0]?.url ?? u.external_url ?? null,
+              };
+          }
+        } catch {}
+      };
+      page.on("response", listen);
+      try {
+        await page.goto(`https://www.instagram.com/${handle}/`, {
+          waitUntil: "domcontentloaded",
+        });
+        for (let i = 0; i < 40 && !(profile && posts.length); i++)
+          await page.waitForTimeout(250);
+        for (
+          let tries = 0;
+          posts.length < want && more && tries < 12;
+          tries++
+        ) {
+          const had = posts.length;
+          await page.evaluate(() =>
+            window.scrollTo(0, document.body.scrollHeight),
+          );
+          for (let i = 0; i < 24 && posts.length === had; i++)
+            await page.waitForTimeout(250);
+          if (posts.length === had) break;
+        }
+      } finally {
+        page.off("response", listen);
+      }
+      const path = page.url().replace(/^https?:\/\/[^/]+/, "");
+      if (/\/accounts\/login|\/challenge\//.test(path))
+        return {
+          error: `Not signed in (${path}). Borrow the kept sign-in first.`,
+        };
+      if (!profile && !posts.length)
+        return {
+          error: `Nothing came back for @${handle}: no such account, a private one, or the page changed (it no longer fetches xdt_api__v1__feed__user_timeline_graphql_connection). Open it and look.`,
+        };
+      const seen = new Set();
+      return {
+        profile,
+        // Newest first, the pinned ones after: the grid puts old pinned posts on top
+        posts: posts
+          .filter((p) => !seen.has(p.url) && seen.add(p.url))
+          .sort((a, b) => a.pinned - b.pinned || b.at - a.at)
+          .slice(0, want),
+      };
+    },
+    { handle, want },
+    { media },
+  ),
+);
+
+const { profile, posts } = got;
+if (opts.out)
+  writeFileSync(opts.out, JSON.stringify({ profile, posts }, null, 1));
+if (profile)
+  console.log(
+    `@${profile.handle} (${profile.name}) — ${short(profile.followers)} followers, ${profile.posts ?? "?"} posts${profile.verified ? ", verified" : ""}${profile.category ? `, ${profile.category}` : ""}\n` +
+      `bio: ${profile.bio.replace(/\s+/g, " ").slice(0, 160)}`,
+  );
+posts.forEach((p, i) => {
+  console.log(postLine(p, i));
+});
+for (const line of patterns(posts)) console.log(`pattern: ${line}`);
+if (opts.sheet) {
+  const made = await makeSheet(
+    posts.map((p, i) => ({
+      src: p.cover,
+      label: `#${i + 1} ${p.type}${p.type === "carousel" ? `×${p.slides}` : ""} ${p.ratio ?? ""} likes ${short(p.likes)}`,
+    })),
+    opts.sheet,
+  );
+  console.log(`covers: ${made.out}`);
+}
+console.log(
+  `${posts.length} posts in ${((Date.now() - started) / 1000).toFixed(1)}s${opts.out ? ` → ${opts.out} (full captions, every slide's picture url)` : ""}`,
+);

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

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+/**
+ * Reads one DM thread into a JSONL file, oldest first, by walking its message pane
+ * up from the newest message. Opening a thread marks it seen.
+ *
+ *   node read.mjs <thread id | thread url> --out <file.jsonl>
+ *     [--since 2026-09-01] [--max 200] [--tail 10]
+ *
+ * Stops at whichever comes first: --max messages, a message older than --since,
+ * the top of the thread, or two rounds that brought nothing new.
+ */
+import { writeFileSync } from "node:fs";
+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)
+  fail(
+    "usage: node read.mjs <thread id | url> --out <file.jsonl> [--since YYYY-MM-DD] [--max 200] [--tail 10]",
+  );
+const id = String(target).match(/(\d{6,})/)?.[1];
+if (!id) fail(`Not a thread id or url: ${target}`);
+const url = `https://www.instagram.com/direct/t/${id}/`;
+const max = Number(opts.max ?? 200);
+const since = opts.since ? new Date(opts.since).getTime() : null;
+if (opts.since && Number.isNaN(since))
+  fail(`--since is not a date: ${opts.since}`);
+const tail = Number(opts.tail ?? 10);
+/** Each round is one browser call of a few screens; this caps a runaway thread. */
+const ROUNDS = 60;
+
+/**
+ * One round: a few screens of the pane, each read and then moved up by most of a
+ * screen. The pane unmounts rows that leave the screen, so it is walked, never
+ * jumped to the top: a jump skips everything in between.
+ */
+async function round(page, { SEL, url, first, steps }) {
+  const extract = (SEL) => {
+    if (/\/accounts\/login|\/challenge\//.test(location.pathname))
+      return { error: `Not signed in (${location.pathname}).` };
+    const pane = [...document.querySelectorAll("main *")].find(
+      (e) =>
+        e.clientHeight > 200 &&
+        !e.closest(SEL.inboxList) &&
+        /(auto|scroll)/.test(getComputedStyle(e).overflowY) &&
+        e.querySelector(SEL.messageRow),
+    );
+    if (!pane)
+      return {
+        error: document.querySelector("main")
+          ? "Selectors changed: no message pane (SEL.messageRow). Snapshot the thread once and fix selectors.mjs."
+          : "No thread on the page: something covers it (a dialog, a daily time-limit screen). Snapshot, close it, run again.",
+      };
+    pane.setAttribute("data-read-pane", "");
+    const fiberOf = (el) =>
+      el[Object.keys(el).find((k) => k.startsWith("__reactFiber"))];
+    const findProp = (el, name) => {
+      for (let f = fiberOf(el), d = 0; f && d < 40; f = f.return, d++) {
+        const p = f.memoizedProps;
+        if (p && typeof p === "object" && p[name] != null) return p[name];
+      }
+      return null;
+    };
+    const paneBox = pane.getBoundingClientRect();
+    const messages = [];
+    for (const row of pane.querySelectorAll(SEL.messageRow)) {
+      const body = row.querySelector(SEL.messageBody);
+      if (!body) continue; // a date line, a "seen" line
+      const ref = findProp(row, SEL.messageRefProp);
+      const deep =
+        body.querySelector("[dir=auto], img, video, a") ??
+        body.firstElementChild ??
+        body;
+      let outgoing = findProp(deep, SEL.outgoingProp);
+      if (typeof outgoing !== "boolean") {
+        // Heuristic: no flag on the row, so a bubble nearer the right edge is the account's own
+        const box = body.getBoundingClientRect();
+        outgoing = box.left - paneBox.left > paneBox.right - box.right;
+      }
+      messages.push({
+        id: ref?.id ?? null,
+        ts: ref?.timestamp_ms ? Number(ref.timestamp_ms) : null,
+        from: outgoing ? "me" : "them",
+        sender: ref?.sender_fbid ?? null,
+        text: body.innerText.trim(),
+        images: [...body.querySelectorAll("img")]
+          .filter((i) => i.getBoundingClientRect().width >= SEL.minImagePx)
+          .map((i) => i.currentSrc || i.src),
+        video: body.querySelector("video") !== null,
+        links: [
+          ...new Set(
+            [...body.querySelectorAll("a[href]")]
+              .map((a) => a.href)
+              .filter((h) => h.startsWith("http")),
+          ),
+        ],
+      });
+    }
+    // A column-reverse pane counts scrollTop from the bottom, as zero and below
+    const reversed = getComputedStyle(pane).flexDirection === "column-reverse";
+    const atTop = reversed
+      ? Math.abs(pane.scrollTop) + pane.clientHeight >= pane.scrollHeight - 2
+      : pane.scrollTop <= 1;
+    return { messages, atTop, height: pane.scrollHeight };
+  };
+
+  if (first) {
+    if (!page.url().startsWith(url)) {
+      await page.goto(url, { waitUntil: "domcontentloaded" });
+      await page
+        .waitForFunction(
+          (SEL) => document.querySelector(`main ${SEL.messageBody}`),
+          SEL,
+          { timeout: 20000 },
+        )
+        .catch(() => {});
+    }
+    await page.waitForTimeout(800);
+    const found = await page.evaluate(extract, SEL);
+    if (found.error) return found;
+    // Start from the newest message, wherever an earlier look left the pane
+    await page.evaluate(() => {
+      const pane = document.querySelector("[data-read-pane]");
+      pane.scrollTop =
+        getComputedStyle(pane).flexDirection === "column-reverse"
+          ? 0
+          : pane.scrollHeight;
+    });
+    await page.waitForTimeout(500);
+  }
+
+  const messages = [];
+  let moved = Number.POSITIVE_INFINITY;
+  for (let s = 0; s < steps; s++) {
+    const seen = await page.evaluate(extract, SEL);
+    if (seen.error) return seen;
+    messages.push(...seen.messages);
+    // At the top, or held in place while older rows load: wait for the pane to grow
+    if (seen.atTop || moved < 10) {
+      const grew = await page
+        .waitForFunction(
+          (height) =>
+            (document.querySelector("[data-read-pane]")?.scrollHeight ?? 0) >
+            height,
+          seen.height,
+          { timeout: 5000 },
+        )
+        .then(() => true)
+        .catch(() => false);
+      if (!grew && seen.atTop) return { messages, top: true };
+      await page.waitForTimeout(300);
+    }
+    moved = await page.evaluate(() => {
+      const pane = document.querySelector("[data-read-pane]");
+      const before = pane.scrollTop;
+      pane.scrollTop -= pane.clientHeight * 0.8;
+      return Math.abs(pane.scrollTop - before);
+    });
+    await page.waitForTimeout(350);
+  }
+  return { messages, top: false };
+}
+
+const started = Date.now();
+const byKey = new Map();
+let fallbackKeys = 0;
+let stop = `the round limit (${ROUNDS})`;
+let quiet = 0;
+for (let i = 0; i < ROUNDS; i++) {
+  const r = orFail(await inPage(round, { SEL, url, first: i === 0, steps: 5 }));
+  if (i === 0 && r.messages.length === 0)
+    fail(
+      "Selectors changed: the pane has rows but no message was read (SEL.messageBody). Fix selectors.mjs.",
+    );
+  let fresh = 0;
+  for (const m of r.messages) {
+    // Heuristic when the row carries no message id: side + time + text stand in for one
+    const key =
+      m.id ?? `${m.from}|${m.ts}|${m.text.slice(0, 120)}|${m.images[0] ?? ""}`;
+    const known = byKey.get(key);
+    if (known) {
+      // A picture that had not loaded on the first sighting may have by now
+      known.images = [...new Set([...known.images, ...m.images])];
+      known.links = [...new Set([...known.links, ...m.links])];
+      if (m.text.length > known.text.length) known.text = m.text;
+      continue;
+    }
+    if (!m.id) fallbackKeys++;
+    byKey.set(key, m);
+    fresh++;
+  }
+  quiet = fresh ? 0 : quiet + 1;
+  const oldest = Math.min(
+    ...[...byKey.values()].map((m) => m.ts ?? Number.POSITIVE_INFINITY),
+  );
+  if (byKey.size >= max) {
+    stop = `--max ${max}`;
+    break;
+  }
+  if (since && oldest < since) {
+    stop = `--since ${opts.since}`;
+    break;
+  }
+  if (r.top) {
+    stop = "the top of the thread";
+    break;
+  }
+  if (quiet >= 2) {
+    stop = "two rounds with nothing new";
+    break;
+  }
+}
+
+let messages = [...byKey.values()].sort((a, b) => (a.ts ?? 0) - (b.ts ?? 0));
+if (since) messages = messages.filter((m) => m.ts == null || m.ts >= since);
+messages = messages.slice(-max);
+writeFileSync(
+  opts.out,
+  messages
+    .map((m) => JSON.stringify({ ...m, at: m.ts ? stamp(m.ts) : null }))
+    .join("\n") + (messages.length ? "\n" : ""),
+);
+
+const count = (f) => messages.filter(f).length;
+console.log(
+  `${messages.length} messages (${count((m) => m.from === "me")} from me, ${count((m) => m.from === "them")} from them), ` +
+    `${messages.length ? `${stamp(messages[0].ts)} to ${stamp(messages.at(-1).ts)}` : "none"}; ` +
+    `${count((m) => m.images.length)} with pictures, ${count((m) => m.links.length)} with links. ` +
+    `Stopped at ${stop}. ${((Date.now() - started) / 1000).toFixed(1)}s → ${opts.out}`,
+);
+if (fallbackKeys)
+  console.log(
+    `${fallbackKeys} rows had no message id; they were told apart by side, time and text.`,
+  );
+for (const m of tail > 0 ? messages.slice(-tail) : [])
+  console.log(
+    `${stamp(m.ts)} ${m.from}: ${oneLine(m.text, 160) || "(no text)"}` +
+      `${m.images.length ? ` [${m.images.length} picture]` : ""}${m.links.length ? ` [${m.links[0]}]` : ""}`,
+  );

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

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+/**
+ * What Instagram's own search shows for a topic — posts and reels, with how each
+ * did — and the accounts behind them, read from the data the search page fetches.
+ * One word or a #tag finds more than a phrase.
+ *
+ *   node search.mjs "<topic>" [--type reel|carousel|image] [--max 24] [--out found.json] [--sheet covers.png]
+ */
+import { writeFileSync } from "node:fs";
+import { shipped } from "./lib.mjs";
+import { media, postLine, short } from "./media.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];
+if (!topic)
+  fail(
+    'usage: node search.mjs "<topic>" [--type reel|carousel|image] [--max 24] [--out found.json] [--sheet covers.png]',
+  );
+const max = Number(opts.max ?? 24);
+const type = opts.type ?? null;
+if (type && !["reel", "carousel", "image"].includes(type))
+  fail("--type is reel, carousel or image");
+
+const started = Date.now();
+const got = orFail(
+  await inPage(
+    async (page, { topic, max, type }, { media }) => {
+      const found = [];
+      let more = true;
+      let pages = 0;
+      const listen = async (res) => {
+        if (!/\/graphql/.test(res.url())) return;
+        let text;
+        try {
+          text = await res.text();
+        } catch {
+          return;
+        }
+        if (!text.includes("xdt_fbsearch__top_serp_graphql")) return;
+        try {
+          const c = JSON.parse(text.split("\n")[0]).data
+            ?.xdt_fbsearch__top_serp_graphql;
+          pages++;
+          more = Boolean(c?.page_info?.has_next_page);
+          const walk = (o) => {
+            if (!o || typeof o !== "object") return;
+            if (typeof o.code === "string" && "media_type" in o) {
+              found.push(media(o));
+              return;
+            }
+            for (const v of Object.values(o)) walk(v);
+          };
+          walk(c?.edges);
+        } catch {}
+      };
+      const kept = () => found.filter((p) => !type || p.type === type).length;
+      page.on("response", listen);
+      try {
+        await page.goto(
+          `https://www.instagram.com/explore/search/keyword/?q=${encodeURIComponent(topic)}`,
+          { waitUntil: "domcontentloaded" },
+        );
+        for (let i = 0; i < 60 && !pages; i++) await page.waitForTimeout(250);
+        for (let tries = 0; kept() < max && more && tries < 8; tries++) {
+          const had = pages;
+          await page.evaluate(() =>
+            window.scrollTo(0, document.body.scrollHeight),
+          );
+          for (let i = 0; i < 32 && pages === had; i++)
+            await page.waitForTimeout(250);
+          if (pages === had) break;
+        }
+      } finally {
+        page.off("response", listen);
+      }
+      const path = page.url().replace(/^https?:\/\/[^/]+/, "");
+      if (/\/accounts\/login|\/challenge\//.test(path))
+        return {
+          error: `Not signed in (${path}). Borrow the kept sign-in first.`,
+        };
+      if (!pages)
+        return {
+          error:
+            "The search page fetched nothing this script knows (xdt_fbsearch__top_serp_graphql): the page changed, or something covers it. Open it and look.",
+        };
+      const seen = new Set();
+      return {
+        posts: found
+          .filter((p) => !seen.has(p.url) && seen.add(p.url))
+          .filter((p) => !type || p.type === type)
+          .slice(0, max),
+      };
+    },
+    { topic, max, type },
+    { media },
+  ),
+);
+
+const { posts } = got;
+if (opts.out)
+  writeFileSync(opts.out, JSON.stringify({ topic, posts }, null, 1));
+posts.forEach((p, i) => {
+  console.log(postLine(p, i));
+});
+// The accounts behind the results, by the likes they drew here
+const accounts = Object.values(
+  posts.reduce((all, p) => {
+    const a = (all[p.owner] ??= { owner: p.owner, posts: 0, likes: 0 });
+    a.posts++;
+    a.likes += p.likes ?? 0;
+    return all;
+  }, {}),
+).sort((a, b) => b.likes - a.likes);
+console.log(
+  `accounts: ${accounts
+    .slice(0, 10)
+    .map((a) => `@${a.owner} (${a.posts}, likes ${short(a.likes)})`)
+    .join(", ")}`,
+);
+if (opts.sheet) {
+  const made = await makeSheet(
+    posts.map((p, i) => ({
+      src: p.cover,
+      label: `#${i + 1} ${p.type}${p.type === "carousel" ? `×${p.slides}` : ""} likes ${short(p.likes)} @${p.owner}`,
+    })),
+    opts.sheet,
+  );
+  console.log(`covers: ${made.out}`);
+}
+console.log(
+  `${posts.length} results for "${topic}"${type ? ` (${type})` : ""} in ${((Date.now() - started) / 1000).toFixed(1)}s${opts.out ? ` → ${opts.out}` : ""}`,
+);

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

@@ -0,0 +1,56 @@
+/**
+ * Everything these scripts know about Instagram's page, in one place. Class names
+ * are generated and change with every release, so nothing here is a class: roles,
+ * tags, and the names of props Instagram's own components pass (read off the React
+ * tree, which outlives a restyle). When a script stops with "selectors changed",
+ * open the page, take one snapshot, fix the line here, and note the date.
+ */
+export const SEL = {
+  // Inbox (last checked 2026-09)
+  /** Primary and General share one url and differ by tab (by position: labels are localized). */
+  folders: {
+    primary: { url: "/direct/inbox/", tab: 0 },
+    general: { url: "/direct/inbox/", tab: 1 },
+    requests: { url: "/direct/requests/" },
+  },
+  folderTab: "main [role=tab]",
+  /** The thread list. */
+  inboxList: "main [role=navigation]",
+  /** One thread in it: a pressable row carrying a relative time. */
+  inboxRow: "[role=button]:has(abbr)",
+  /** An unread row draws its title and preview semibold; a read one is normal. */
+  unreadWeight: 600,
+  /** Props on the row's components: the id in /direct/t/<id>/, and its last activity. */
+  threadIdProp: "threadKeyForSelection",
+  lastActivityProp: "last_activity_timestamp_ms",
+
+  // Thread (last checked 2026-09)
+  /** One row of the message list; a message row holds an article, a date line does not. */
+  messageRow: "[role=group]",
+  messageBody: "[role=article]",
+  /** The row's message record: { id, timestamp_ms, sender_fbid }. */
+  messageRefProp: "currentMessageRef",
+  /** True on a message the signed-in account sent. */
+  outgoingProp: "outgoing",
+  /** A picture smaller than this on screen is an avatar or an icon, not an attachment. */
+  minImagePx: 80,
+
+  // Composer (last checked 2026-09)
+  /** Sidebar entries that open something rather than a page; Create is the second (after Notifications). */
+  sidebarAction: 'a[href="#"]',
+  createIndex: 1,
+  /** Below this width the sidebar becomes a bottom bar with Create elsewhere. */
+  wideWidth: 1280,
+  /** The step that takes files; the caption step is the one with a textbox. */
+  composer: "[role=dialog]",
+  fileInput: "input[type=file]",
+  caption: "[role=textbox]",
+  /** The picture on the crop step, drawn as an image or a background. */
+  preview: 'img, [style*="background-image"]',
+  aiLabel: "input[role=switch]",
+  /** Crop options start with their ratio; the first is Original. */
+  cropOptions: ["original", "1:1", "4:5", "16:9"],
+};
+
+/** Instagram's own web client id; its JSON endpoints answer only with it. */
+export const APP_ID = "936619743392459";

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

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+/**
+ * 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 { shipped } from "./lib.mjs";
+import { short } from "./media.mjs";
+
+const { fail, parseArgs } = await shipped("browser/scripts/session.mjs");
+const { makeSheet, pictures } = await shipped("browser/scripts/sheet.mjs");
+
+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

@@ -0,0 +1,62 @@
+<!doctype html>
+<!--
+  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
+  over a blurred copy of itself. .credit names the source of a real picture.
+-->
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@400;700;900&display=block">
+<style>
+  :root { --w: 1080px; --h: 1350px; --ink: #fff; --accent: #ffd400; --paper: #111; }
+  * { box-sizing: border-box; margin: 0; }
+  body { background: #000; font-family: "Noto Sans KR", "Apple SD Gothic Neo", system-ui, sans-serif; }
+  section[data-slide] {
+    position: relative; width: var(--w); height: var(--h); overflow: hidden;
+    background: var(--paper); color: var(--ink);
+  }
+  .bg, .fit img { position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; }
+  .bg.blur { filter: blur(24px) brightness(.7); transform: scale(1.1); }
+  .bg.dark { filter: brightness(.55); }
+  .shade { position: absolute; inset: 0; background: linear-gradient(180deg, rgba(0,0,0,0) 35%, rgba(0,0,0,.85) 100%); }
+  .fit .back { filter: blur(40px) brightness(.6); transform: scale(1.15); }
+  .fit .front { object-fit: contain; inset: 12% 6% 30%; width: 88%; height: 58%; }
+  .text { position: absolute; left: 72px; right: 72px; bottom: 120px; }
+  .kicker { font-size: 34px; font-weight: 700; color: var(--accent); margin-bottom: 20px; }
+  h1 { font-size: 92px; line-height: 1.12; font-weight: 900; letter-spacing: -0.02em; word-break: keep-all; }
+  p { font-size: 44px; line-height: 1.45; word-break: keep-all; }
+  .credit { position: absolute; left: 72px; bottom: 44px; font-size: 24px; opacity: .75; }
+  .page { position: absolute; right: 60px; top: 56px; font-size: 28px; opacity: .7; }
+</style>
+</head>
+<body>
+
+<section data-slide>
+  <img class="bg" src="photo.jpg" alt="">
+  <div class="shade"></div>
+  <div class="text">
+    <div class="kicker">NEWS</div>
+    <h1>The hook: one line that earns the swipe</h1>
+  </div>
+  <div class="credit">Photo: Source name</div>
+</section>
+
+<section data-slide>
+  <div class="fit"><img class="back" src="photo.jpg" alt=""><img class="front" src="photo.jpg" alt=""></div>
+  <div class="text"><p>A whole picture over a blurred copy of itself, with a line under it.</p></div>
+  <div class="page">2</div>
+</section>
+
+<section data-slide style="--paper: #f4f1ea; --ink: #111">
+  <div class="text" style="top: 160px; bottom: auto">
+    <h1 style="font-size: 72px">Text alone</h1>
+    <p style="margin-top: 40px">One idea a slide, large enough to read on a phone at arm's length.</p>
+  </div>
+  <div class="page">3</div>
+</section>
+
+</body>
+</html>