demobites 1.36.0 → 1.38.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "demobites",
-  "version": "1.36.0",
+  "version": "1.38.0",
   "description": "The DemoBites agentic recorder — you prompt, it films a real browser, and DemoBites turns the take into an editable demo bite.",
   "bin": {
     "demobites": "launcher/index.mjs"

package/skill/scripts/plan.mjs

@@ -136,7 +136,9 @@ const explore = (from, lookingFor, depth) => {
   fs.mkdirSync(exDir, { recursive: true });
   const child = spawnSync("node", [script("explore.mjs"), from, "--for", words, "--depth", String(Math.min(3, Math.max(1, Number(depth) || 2))), "--out", exDir], { cwd: process.cwd(), encoding: "utf8", env: process.env, maxBuffer: 64 * 1024 * 1024 });
   const lines = (child.stdout || "").split("\n");
-  for (const l of lines) if (l.startsWith("· ")) say(l.slice(2));
+  // THE PERSON HEARS PHASES, NOT FINDINGS (founder 2026-10-18: "Nothing beyond the start page matched… you need to
+  // control what you're showing to the user"): the exploration's lines stay in the log.
+  for (const l of lines) if (l.startsWith("· ")) console.log(l);
   const last = lines.filter((l) => l.startsWith("RESULT ")).pop();
   let res = null; try { res = JSON.parse(last.slice(7)); } catch { /* none */ }
   if (!res) return [{ type: "text", text: `Exploring failed: ${(child.stderr || "").trim().split("\n").pop() || "no result"}` }];
@@ -241,13 +243,17 @@ let probes = 0;
 let firstProbeAt = 0;
 let asked = 0;
 const capped = () => probes >= CAP_PROBES || (firstProbeAt && Date.now() - firstProbeAt > CAP_MS);
-const CAP_TEXT = () => asked < 2
+const CAP_TEXT = () => asked < 1
   ? `STOP (${probes} dry run${probes === 1 ? "" : "s"}, ${Math.round((Date.now() - (firstProbeAt || Date.now())) / 1000)} s since the first). No more dry runs, no more reading. Call ask_person NOW with ONE short question in plain words: what you were looking for, where you looked, and how they want to play it (where it is, or what to show instead). The person is there and knows the app. Their answer comes back as the result; then fix the storyboard from their words, probe once, and hand it in.`
   : `STOP. Hand in the storyboard NOW with submit_storyboard: keep every step that passed; a step that failed becomes a hover or a settle on the nearest element the page does have, or goes; name in \`unsure\` what you could not find.`;
 /** The question goes to the chat; the planner waits here for the person's word (up to 30 minutes). */
 const askPerson = async (text) => {
   const q = String(text || "").trim().slice(0, 600);
   if (!q) return "ask_person needs a question.";
+  // ONE QUESTION, EVER (founder 2026-10-18: "at most one clarification… then go"; a second question three seconds
+  // after one dry run left him stuck): once answered, the planner works with what it has and hands in the
+  // storyboard, naming what it could not find in `unsure`. The person fixes it from the storyboard, not from a loop.
+  if (asked >= 1) return "You asked once and they answered. No more questions: hand in the storyboard NOW with submit_storyboard — keep every step that passed, turn a step you could not place into a hover or a settle on the nearest element the page has, and name what you could not find in `unsure`.";
   say("Asking you in the chat…");
   if (!listening) return "(no chat here: decide yourself and hand in the storyboard)";
   await postEvent("question", { text: q });
@@ -273,7 +279,7 @@ const plan = async () => {
     const res = await relay(messages);
     const content = Array.isArray(res.content) ? res.content : [];
     messages.push({ role: "assistant", content });
-    for (const b of content) if (b.type === "text" && b.text?.trim()) say(b.text.trim().split("\n")[0].replace(/^[#*\-\s]+/, "").slice(0, 140));
+    for (const b of content) if (b.type === "text" && b.text?.trim()) console.log(`· ${b.text.trim().split("\n")[0].replace(/^[#*\-\s]+/, "").slice(0, 140)}`);
     const uses = content.filter((b) => b.type === "tool_use");
     if (!uses.length) {
       if (storyboard) return;

package/skill/scripts/stage-wait.mjs

@@ -22,6 +22,7 @@
 // this take; a no-op everywhere else (the terminal flow, the cloud sandbox
 // copy that may not ship listen-event.mjs).
 const postEvent = await import("./listen-event.mjs").then((m) => m.postEvent).catch(() => async () => null);
+const listening = await import("./listen-event.mjs").then((m) => m.listening).catch(() => false);
 /** Where the person watches their takes: the Demos grid. `dashboardUrl` from
  * the server wins (relative or absolute), else <base>/demos. */
 export function gridUrl(base, dashboardUrl) {
@@ -151,6 +152,16 @@ export async function waitForDecision({ base, apiKey, stagingId, pageUrl, delive
     if (last.zooms === 0) console.error("WARNING: no camera shots landed.");
   }
   if (finalStudioUrl) console.log(`Studio: ${finalStudioUrl}`);
+  // THE STILLS, DRAWN HERE BEFORE "READY" (2026-10-18): the demo's intro and backdrop, by the studio's own code in
+  // this recorder's Chrome, remembered by the app so the export draws nothing. Bounded; a miss costs nothing.
+  if (listening) {
+    try {
+      const { spawnSync } = await import("node:child_process");
+      const here = (await import("node:path")).dirname((await import("node:url")).fileURLToPath(import.meta.url));
+      const r = spawnSync(process.execPath, [(await import("node:path")).join(here, "stills.mjs"), String(approvedBiteId)], { cwd: process.cwd(), encoding: "utf8", env: process.env, timeout: 60000 });
+      for (const l of (r.stdout || "").trim().split("\n").filter(Boolean)) console.log(`  ${l}`);
+    } catch (e) { console.log(`  stills: skipped (${String(e?.message ?? e).split("\n")[0]})`); }
+  }
   await postEvent("ready", { biteId: approvedBiteId, studioUrl: finalStudioUrl ?? null });
   return { exitCode: 0, status: "completed", biteId: approvedBiteId, studioUrl: finalStudioUrl };
 }

package/skill/scripts/stills.mjs

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+// THE STILLS ARE DRAWN HERE (founder 2026-10-18: "at that point you have a browser… load fabric… create the two
+// images"). After the demo is built and before this recorder says "ready", its own Chrome opens the app's internal
+// still page — the studio's own render code, the design's fonts from the web — for the intro and the backdrop,
+// and hands the PNGs to the app, which remembers them for the export. Seconds here; a 30-second sandbox saved there.
+// Never fatal: on any miss the export draws them itself as before.
+// usage: node stills.mjs <biteId>     (base and key from <cwd>/.recorder/config.json)
+import fs from "node:fs";
+import path from "node:path";
+const biteId = Number(process.argv[2] || 0);
+if (!biteId) { console.error("usage: stills.mjs <biteId>"); process.exit(2); }
+const cfg = JSON.parse(fs.readFileSync(path.resolve(process.cwd(), ".recorder", "config.json"), "utf8"));
+const base = (process.env.RECORDER_BASE || cfg.base || "https://app.demobites.com").replace(/\/+$/, "");
+const headers = { Authorization: `Bearer ${cfg.api_key}`, "Content-Type": "application/json" };
+const t0 = Date.now();
+const plan = await fetch(`${base}/api/recorder/stills?bite_id=${biteId}`, { headers, signal: AbortSignal.timeout(15000) }).then((r) => (r.ok ? r.json() : null)).catch(() => null);
+if (!plan?.stills?.length) { console.log("stills: nothing to draw here"); process.exit(0); }
+const { chromium } = await import("playwright");
+const browser = await chromium.launch({ channel: "chrome", headless: true }).catch(async () => chromium.launch({ headless: true }));
+const out = {};
+try {
+  const ctx = await browser.newContext({ viewport: { width: 1920, height: 1080 } });
+  for (const still of plan.stills) {
+    const page = await ctx.newPage();
+    try {
+      const res = await page.goto(still.url, { waitUntil: "domcontentloaded", timeout: 20000 });
+      if (!res || res.status() !== 200) throw new Error(`the still page answered ${res ? res.status() : "nothing"}`);
+      await page.waitForFunction("window.__FABRIC_STILL__ !== undefined", undefined, { timeout: 25000 });
+      const r = await page.evaluate("window.__FABRIC_STILL__");
+      if (!r?.ok || typeof r.dataUrl !== "string" || !r.dataUrl.startsWith("data:image/png;base64,")) throw new Error(r?.error || "no PNG from the still page");
+      out[still.kind] = r.dataUrl.slice("data:image/png;base64,".length);
+      console.log(`stills: ${still.kind} drawn (${Math.round(out[still.kind].length * 0.75 / 1024)} KB)`);
+    } catch (e) { console.log(`stills: ${still.kind} skipped (${String(e?.message ?? e).split("\n")[0]})`); }
+    finally { await page.close().catch(() => {}); }
+  }
+} finally { await browser.close().catch(() => {}); }
+if (!Object.keys(out).length) process.exit(0);
+const put = await fetch(`${base}/api/recorder/stills`, { method: "PUT", headers, body: JSON.stringify({ bite_id: biteId, hash: plan.hash, stills: out }), signal: AbortSignal.timeout(30000) }).then((r) => r.json().catch(() => ({ ok: r.ok }))).catch((e) => ({ error: String(e?.message ?? e) }));
+console.log(`stills: ${put?.ok ? `remembered for the export (${Object.keys(out).join(", ")})` : `not kept (${put?.error ?? "?"})`} in ${((Date.now() - t0) / 1000).toFixed(1)} s`);