@gui-chat-plugin/sequence 0.2.0 → 0.3.0

package/dist/{core-qe3zK8TI.js → core-BALd7sgj.js}

@@ -1,17 +1,59 @@
 import { createSerialLock as e } from "gui-chat-protocol";
+//#region src/core/slideHtml.ts
+var t = 1280, n = 720, r = 6e4, i = "https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4.3.3/dist/index.global.js", a = "sha384-2ql948lIdLcGEE0/qxNiudyTjgauA3RDJERu5xW75kFCvSl5a9odyQYCb6tEjnmB", o = [
+	"fade-in",
+	"fade-up",
+	"fade-down",
+	"slide-in-left",
+	"slide-in-right",
+	"zoom-in",
+	"pop",
+	"draw"
+], s = "\n@theme {\n  --animate-fade-in: fade-in 0.8s ease-out both;\n  --animate-fade-up: fade-up 0.8s ease-out both;\n  --animate-fade-down: fade-down 0.8s ease-out both;\n  --animate-slide-in-left: slide-in-left 0.8s ease-out both;\n  --animate-slide-in-right: slide-in-right 0.8s ease-out both;\n  --animate-zoom-in: zoom-in 0.8s ease-out both;\n  --animate-pop: pop 0.6s cubic-bezier(0.34, 1.56, 0.64, 1) both;\n  --animate-draw: draw 1.5s ease-in-out both;\n  @keyframes fade-in { from { opacity: 0 } to { opacity: 1 } }\n  @keyframes fade-up { from { opacity: 0; transform: translateY(40px) } to { opacity: 1; transform: none } }\n  @keyframes fade-down { from { opacity: 0; transform: translateY(-40px) } to { opacity: 1; transform: none } }\n  @keyframes slide-in-left { from { opacity: 0; transform: translateX(-80px) } to { opacity: 1; transform: none } }\n  @keyframes slide-in-right { from { opacity: 0; transform: translateX(80px) } to { opacity: 1; transform: none } }\n  @keyframes zoom-in { from { opacity: 0; transform: scale(0.8) } to { opacity: 1; transform: none } }\n  @keyframes pop { from { opacity: 0; transform: scale(0.5) } to { opacity: 1; transform: none } }\n  @keyframes draw { from { stroke-dashoffset: var(--draw-length, 1000) } to { stroke-dashoffset: 0 } }\n}", c = "\n(() => {\n  const show = () => document.documentElement.classList.add(\"ready\");\n  const ready = () => requestAnimationFrame(() => requestAnimationFrame(show));\n  const check = () =>\n    document.querySelector(\"style:not([type]):not(#slide-base)\") ? ready() : setTimeout(check, 30);\n  addEventListener(\"DOMContentLoaded\", check);\n  setTimeout(show, 1000);\n  addEventListener(\"click\", (event) => {\n    if (event.target instanceof Element && event.target.closest(\"a, area\")) event.preventDefault();\n  }, true);\n})();", l = [
+	"default-src 'none'",
+	`script-src 'sha256-MZyL5rvWmIVxl3WUuDU5BqzPJGR2/fV/YPh01MNyUoM=' ${i}`,
+	"style-src 'unsafe-inline' https://fonts.googleapis.com",
+	"font-src https://fonts.gstatic.com data:",
+	"img-src data: blob:",
+	"media-src data: blob:",
+	"connect-src 'none'",
+	"form-action 'none'",
+	"base-uri 'none'"
+].join("; "), u = (e) => e.replace(/<(?=(meta|base|link)\b)/gi, "&lt;").replace(/shadowroot/gi, "data-no-shadow-root"), d = `
+html, body { margin: 0; width: ${t}px; height: 720px; overflow: hidden; }
+html:not(.ready) body { visibility: hidden; }
+html:not(.ready) body * { animation-play-state: paused !important; }`;
+function f(e) {
+	return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta http-equiv="Content-Security-Policy" content="${l}">
+<style id="slide-base">${d}</style>
+<script>${c}<\/script>
+<script defer src="${i}" integrity="${a}" crossorigin="anonymous"><\/script>
+<style type="text/tailwindcss">${s}</style>
+</head>
+<body class="bg-white text-slate-900 font-sans antialiased">
+${u(e)}
+</body>
+</html>`;
+}
+//#endregion
 //#region src/core/definitions.ts
-var t = "presentSlide", n = "defineStoryboard", r = "presentPanel", i = 4, a = 12, o = 3, s = /^[0-9a-f]{12}$/, c = (e) => typeof e == "object" && !!e && !Array.isArray(e), l = (e) => typeof e == "string" ? e.trim() : "", u = (e, t) => e.toLowerCase() === t.toLowerCase(), d = (e) => typeof e == "number" && Number.isInteger(e), f = "presentSlide needs slide and totalSlides (whole numbers, slide from 1 to totalSlides) and an imagePrompt";
-function p(e) {
-	let { slide: t, totalSlides: n, title: r, imagePrompt: i } = e;
-	return !d(t) || !d(n) || t < 1 || n < t || typeof i != "string" || !i.trim() ? null : {
+var p = "presentSlide", m = "defineStoryboard", h = "presentPanel", ee = 4, te = 12, ne = 3, g = /^[0-9a-f]{12}$/, _ = (e) => typeof e == "object" && !!e && !Array.isArray(e), v = (e) => typeof e == "string" ? e.trim() : "", y = (e, t) => e.toLowerCase() === t.toLowerCase(), b = (e) => typeof e == "number" && Number.isInteger(e), x = "presentSlide needs slide and totalSlides (whole numbers, slide from 1 to totalSlides), and either an imagePrompt or html", re = `presentSlide's html is too long: keep a slide under ${r} characters`;
+function ie(e) {
+	let { slide: t, totalSlides: n, title: r, imagePrompt: i } = e, a = v(e.html);
+	return !b(t) || !b(n) || t < 1 || n < t || !a && !v(i) ? x : a.length > 6e4 ? re : {
 		slide: t,
 		totalSlides: n,
 		title: typeof r == "string" ? r : "",
-		imagePrompt: i,
+		imagePrompt: a ? "" : String(i),
+		...a && { html: a },
 		mode: e.mode === "steps" ? "steps" : "presentation"
 	};
 }
-var m = ({ slide: e, totalSlides: t, title: n, mode: r }) => {
+var S = ({ slide: e, totalSlides: t, title: n, mode: r }) => {
 	let i = n ? ` ("${n}")` : "";
 	if (r === "steps") {
 		let n = `Step ${e} of ${t}${i}`;
@@ -19,11 +61,11 @@ var m = ({ slide: e, totalSlides: t, title: n, mode: r }) => {
 	}
 	let a = `Slide ${e} of ${t}${i}`;
 	return e < t ? `${a} is now on the screen. Explain it, then, in this same reply and without waiting for the user, call presentSlide for slide ${e + 1}. If the user has asked you to stop, or asked something else, since the slideshow began, answer them instead of going on.` : `${a}, the last one, is now on the screen. Explain it, then wrap up the slideshow.`;
-}, h = "When the user asks for a slideshow (or to explain something with slides), plan four to six slides, then show them one at a time with presentSlide: slide 1 first, and each next slide only after you have explained the one on the screen. Go on to the last slide without asking whether to continue. When the user wants to be shown how to do something they will do along with you (cooking, folding, fixing, an exercise), make it a step-by-step guide instead: mode \"steps\", one slide per step, and after each step wait for the user to say they are ready. Use generateImage for a single picture, not for slides.", g = {
+}, ae = [`For an HTML slide, instead of imagePrompt: the slide's content, the inside of <body> only (no <html>, <head> or <body> tags), for a ${t}x720 px canvas, which it should fill (start with a <div class="w-full h-full ...">). Style it with Tailwind CSS v4 classes, which are loaded for you: a clear layout, a large title (text-6xl or so), few words in large type, a color scheme, and inline SVG or emoji for icons and diagrams. There is no network: no <img> from URLs, no links to follow.`, `Animate it so it builds up as you explain it: these classes are defined, ${o.map((e) => `animate-${e}`).join(", ")} (an SVG path drawing itself: set stroke-dasharray and --draw-length to its length), plus Tailwind's animate-pulse, animate-bounce, animate-spin and animate-ping, and transitions. Stagger the parts with a delay, [animation-delay:600ms], so they appear one after another over a few seconds. A <style> with your own @keyframes is allowed too (and Google Fonts by @import). Scripts don't run: animate with CSS only.`].join(" "), C = "When the user asks for a slideshow (or to explain something with slides), plan four to six slides, then show them one at a time with presentSlide: slide 1 first, and each next slide only after you have explained the one on the screen. Go on to the last slide without asking whether to continue. A slide is a generated picture (imagePrompt) or a designed slide in HTML (html): use a picture for a scene, an object or a place, and HTML for words, numbers, lists, comparisons, timelines and diagrams, which a picture model draws badly; a slideshow can mix them. When the user wants to be shown how to do something they will do along with you (cooking, folding, fixing, an exercise), make it a step-by-step guide instead: mode \"steps\", one slide per step, and after each step wait for the user to say they are ready. Use generateImage for a single picture, not for slides.", w = {
 	type: "function",
-	name: t,
-	prompt: h,
-	description: "Show one slide of a slideshow: a picture generated from imagePrompt, full screen. Call it once per slide, in order, starting with slide 1. With mode \"steps\" it is a step-by-step guide: one slide per step, and the next step waits for the user.",
+	name: p,
+	prompt: C,
+	description: "Show one slide of a slideshow, full screen: a picture generated from imagePrompt, or a slide written in HTML (html). Call it once per slide, in order, starting with slide 1. With mode \"steps\" it is a step-by-step guide: one slide per step, and the next step waits for the user.",
 	parameters: {
 		type: "object",
 		properties: {
@@ -41,7 +83,11 @@ var m = ({ slide: e, totalSlides: t, title: n, mode: r }) => {
 			},
 			imagePrompt: {
 				type: "string",
-				description: "The picture for this slide: a clear illustration or diagram of its point, with the title as its only large text. Be concrete. For a step, show the action: hands, tools and the object."
+				description: "For a picture slide: the picture, a clear illustration of its point, with the title as its only large text. Be concrete. For a step, show the action: hands, tools and the object. Leave it out for an HTML slide."
+			},
+			html: {
+				type: "string",
+				description: ae
 			},
 			mode: {
 				type: "string",
@@ -52,54 +98,53 @@ var m = ({ slide: e, totalSlides: t, title: n, mode: r }) => {
 		required: [
 			"slide",
 			"totalSlides",
-			"title",
-			"imagePrompt"
+			"title"
 		]
 	}
 };
-function _(e) {
+function T(e) {
 	let { totalPanels: t } = e;
-	if (!d(t) || t < 1 || t > 12) return "totalPanels must be a whole number from 1 to 12";
+	if (!b(t) || t < 1 || t > 12) return "totalPanels must be a whole number from 1 to 12";
 	let n = [];
 	for (let t of Array.isArray(e.characters) ? e.characters : []) {
-		let e = c(t) ? l(t.name) : "", r = c(t) ? l(t.description) : "";
+		let e = _(t) ? v(t.name) : "", r = _(t) ? v(t.description) : "";
 		if (!e || !r) return "every character needs a name and a description";
-		if (n.some((t) => u(t.name, e))) return `two characters are named ${e}`;
+		if (n.some((t) => y(t.name, e))) return `two characters are named ${e}`;
 		n.push({
 			name: e,
 			description: r
 		});
 	}
 	return n.length < 1 || n.length > 4 ? "a storyboard has 1 to 4 characters" : {
-		title: l(e.title),
-		style: l(e.style),
+		title: v(e.title),
+		style: v(e.style),
 		totalPanels: t,
 		characters: n,
 		interactive: e.interactive === !0
 	};
 }
-var v = ({ title: e, id: t }) => `The cast of "${e}" is now on the screen. Introduce the characters briefly, then, in this same reply and without waiting for the user, call presentPanel for panel 1 with storyboardId "${t}". If the user has asked you to stop, or asked something else, answer them instead of going on.`, y = "presentPanel needs a storyboardId, a panel number (from 1) and an imagePrompt";
-function b(e) {
-	let { panel: t } = e, n = l(e.storyboardId), r = l(e.imagePrompt);
-	if (!n || !r || !d(t) || t < 1) return null;
-	let i = (e) => (Array.isArray(e) ? e : []).map(l).filter(Boolean);
+var E = ({ title: e, id: t }) => `The cast of "${e}" is now on the screen. Introduce the characters briefly, then, in this same reply and without waiting for the user, call presentPanel for panel 1 with storyboardId "${t}". If the user has asked you to stop, or asked something else, answer them instead of going on.`, D = "presentPanel needs a storyboardId, a panel number (from 1) and an imagePrompt";
+function O(e) {
+	let { panel: t } = e, n = v(e.storyboardId), r = v(e.imagePrompt);
+	if (!n || !r || !b(t) || t < 1) return null;
+	let i = (e) => (Array.isArray(e) ? e : []).map(v).filter(Boolean);
 	return {
 		storyboardId: n,
 		panel: t,
 		characters: i(e.characters),
 		imagePrompt: r,
-		caption: l(e.caption),
+		caption: v(e.caption),
 		choices: i(e.choices).slice(0, 3)
 	};
 }
-function x(e, t, n) {
+function k(e, t, n) {
 	let { id: r, totalPanels: i } = e;
 	return n.length ? `Panel ${t} of ${i} is now on the screen, with the user's choices: ${n.map((e, t) => `${t + 1}. ${e}`).join(" ")} Tell this part of the story, then read the choices out and ask the user which one they pick, and wait for their answer. Then call presentPanel for panel ${t + 1} with storyboardId "${r}", going on the way they chose.` : t < i ? `Panel ${t} of ${i} is now on the screen. Tell this part of the story, then, in this same reply and without waiting for the user, call presentPanel for panel ${t + 1} with storyboardId "${r}". If the user has asked you to stop, or asked something else, since the story began, answer them instead of going on.` : `Panel ${t} of ${i}, the last one, is now on the screen. Tell this part of the story, then bring it to an end.`;
 }
-var S = "When the user asks for a story, a picture book, a comic or a storyboard, tell it in pictures: first call defineStoryboard with the art style and the characters who appear more than once (it draws a reference sheet for each, so they look the same in every panel), then show the panels one at a time with presentPanel, naming the characters in each, and tell each part of the story when its panel appears. Go on to the last panel without asking whether to continue, unless the story is interactive. When the user wants to decide what happens (an adventure, a story for a child who wants to choose), set interactive, and give two or three choices on two or three of the panels: the story waits there for the user's pick and goes on their way; it still ends at the last panel whichever way it goes. Use presentSlide to explain a topic, not to tell a story.", C = {
+var A = "When the user asks for a story, a picture book, a comic or a storyboard, tell it in pictures: first call defineStoryboard with the art style and the characters who appear more than once (it draws a reference sheet for each, so they look the same in every panel), then show the panels one at a time with presentPanel, naming the characters in each, and tell each part of the story when its panel appears. Go on to the last panel without asking whether to continue, unless the story is interactive. When the user wants to decide what happens (an adventure, a story for a child who wants to choose), set interactive, and give two or three choices on two or three of the panels: the story waits there for the user's pick and goes on their way; it still ends at the last panel whichever way it goes. Use presentSlide to explain a topic, not to tell a story.", j = {
 	type: "function",
-	name: n,
-	prompt: S,
+	name: m,
+	prompt: A,
 	description: "Start a story told in pictures: set its art style and draw a reference sheet for each recurring character, shown as the cast. Then call presentPanel for each panel, in order.",
 	parameters: {
 		type: "object",
@@ -146,9 +191,9 @@ var S = "When the user asks for a story, a picture book, a comic or a storyboard
 			"characters"
 		]
 	}
-}, w = {
+}, M = {
 	type: "function",
-	name: r,
+	name: h,
 	description: "Show one panel of a storyboard made with defineStoryboard: a picture of the scene with its characters drawn as in their reference sheets, and a caption. Call it once per panel, in order, starting with panel 1.",
 	parameters: {
 		type: "object",
@@ -187,46 +232,54 @@ var S = "When the user asks for a story, a picture book, a comic or a storyboard
 			"imagePrompt"
 		]
 	}
-}, T = (e) => typeof e == "object" && !!e && !Array.isArray(e), ee = (e) => T(e) && typeof e.message == "string";
-function E(e) {
-	let t = T(e?.data) ? e.data : {};
+}, N = (e) => typeof e == "object" && !!e && !Array.isArray(e), oe = (e) => N(e) && typeof e.message == "string";
+function P(e) {
+	let t = N(e?.data) ? e.data : {};
 	return {
 		...typeof t.imageData == "string" && { imageData: t.imageData },
 		...typeof t.imagePath == "string" && { imagePath: t.imagePath }
 	};
 }
-function te(e, t) {
-	let n = E(e), r = E(t);
-	return n.imagePath && r.imagePath ? n.imagePath === r.imagePath : !!n.imageData && n.imageData === r.imageData;
+function F(e) {
+	let t = N(e?.data) ? e.data : {};
+	return typeof t.html == "string" ? t.html : "";
 }
-var D = (e, t) => e.userSpokeAt === void 0 || e.userSpokeAt > t, O = () => crypto.randomUUID().replace(/-/g, "").slice(0, 12), k = "artifacts/";
-async function A(e, t) {
+var se = (e) => !!P(e).imageData || !!F(e);
+function ce(e, t) {
+	let n = P(e), r = P(t);
+	if (n.imagePath && r.imagePath) return n.imagePath === r.imagePath;
+	if (n.imageData) return n.imageData === r.imageData;
+	let i = F(e);
+	return !!i && i === F(t);
+}
+var I = (e, t) => e.userSpokeAt === void 0 || e.userSpokeAt > t, L = () => crypto.randomUUID().replace(/-/g, "").slice(0, 12), le = "artifacts/";
+async function R(e, t) {
 	let n = e.files?.artifacts;
 	if (!e.app?.editImages || !n) return [];
 	let r = [];
-	for (let e of t) if (e.startsWith(k)) try {
+	for (let e of t) if (e.startsWith(le)) try {
 		await n.exists(e.slice(10)) && r.push(e);
 	} catch {}
 	return r;
 }
-async function j(e, t, n = []) {
+async function z(e, t, n = []) {
 	let r = e.app, i = r?.editImages, a = r?.generateImage;
 	try {
 		let e;
 		if (n.length && i) e = await i(t, [...n]);
 		else if (a) e = await a(t);
 		else return { message: "image generation isn't available" };
-		return ee(e) ? e : { message: "image generation returned an unrecognized result" };
+		return oe(e) ? e : { message: "image generation returned an unrecognized result" };
 	} catch (e) {
 		return { message: `image generation failed: ${e instanceof Error ? e.message : String(e)}` };
 	}
 }
-var M = 50;
-function N(e) {
+var ue = 50;
+function B(e) {
 	let t = /* @__PURE__ */ new Map();
 	return (n) => {
 		let r = n.conversationId ?? "", i = t.get(r);
-		if (i === void 0 ? i = e() : t.delete(r), t.set(r, i), t.size > M) {
+		if (i === void 0 ? i = e() : t.delete(r), t.set(r, i), t.size > ue) {
 			let e = t.keys().next().value;
 			e !== void 0 && t.delete(e);
 		}
@@ -235,20 +288,20 @@ function N(e) {
 }
 //#endregion
 //#region src/core/records.ts
-var P = "slideshows", F = "storyboards", I = {}, L = /* @__PURE__ */ new WeakMap(), R = /* @__PURE__ */ new WeakMap();
-function z(e) {
-	let t = L.get(e);
-	return t || L.set(e, t = /* @__PURE__ */ new Map()), t;
+var V = "slideshows", H = "storyboards", U = {}, W = /* @__PURE__ */ new WeakMap(), G = /* @__PURE__ */ new WeakMap();
+function K(e) {
+	let t = W.get(e);
+	return t || W.set(e, t = /* @__PURE__ */ new Map()), t;
 }
-function ne(t, n) {
-	let r = R.get(t);
-	r || R.set(t, r = /* @__PURE__ */ new Map());
+function de(t, n) {
+	let r = G.get(t);
+	r || G.set(t, r = /* @__PURE__ */ new Map());
 	let i = r.get(n);
 	return i || r.set(n, i = e()), i;
 }
-var B = (e, t) => `${e}/${t}.json`;
-async function V(e, t) {
-	let n = z(e ?? I), r = n.get(t);
+var q = (e, t) => `${e}/${t}.json`;
+async function J(e, t) {
+	let n = K(e ?? U), r = n.get(t);
 	if (r) return r;
 	if (!e) return null;
 	try {
@@ -258,14 +311,14 @@ async function V(e, t) {
 		return null;
 	}
 }
-async function H(e, t, n) {
-	return s.test(n) ? V(e, B(t, n)) : null;
+async function Y(e, t, n) {
+	return g.test(n) ? J(e, q(t, n)) : null;
 }
-async function U(e, t, n, r) {
-	let i = B(t, n), a = e ?? I;
-	return ne(a, i)(async () => {
-		let t = r(await V(e, i));
-		if (z(a).set(i, t), !e) return !1;
+async function X(e, t, n, r) {
+	let i = q(t, n), a = e ?? U;
+	return de(a, i)(async () => {
+		let t = r(await J(e, i));
+		if (K(a).set(i, t), !e) return !1;
 		try {
 			return await e.write(i, JSON.stringify(t, null, 2)), !0;
 		} catch (e) {
@@ -273,12 +326,12 @@ async function U(e, t, n, r) {
 		}
 	});
 }
-var W = (e) => `the ${e} could not be saved, so it lasts only until the app or server restarts`, re = 6e4;
-function G() {
+var Z = (e) => `the ${e} could not be saved, so it lasts only until the app or server restarts`, fe = 6e4;
+function pe() {
 	let e = /* @__PURE__ */ new Map();
 	return { claim: (t) => {
 		let n = Date.now();
-		for (let [t, r] of e) n - r.at > re && e.delete(t);
+		for (let [t, r] of e) n - r.at > fe && e.delete(t);
 		let r = e.get(t);
 		if (r) return { earlier: r.shown };
 		let i = () => void 0, a = new Promise((e) => i = e);
@@ -292,7 +345,7 @@ function G() {
 }
 //#endregion
 //#region src/core/presentSlide.ts
-function K({ slide: e, totalSlides: t, mode: n }) {
+function me({ slide: e, totalSlides: t, mode: n }) {
 	return n === "steps" ? {
 		step: e,
 		total: t,
@@ -310,25 +363,26 @@ function K({ slide: e, totalSlides: t, mode: n }) {
 		nextCall: `call presentSlide for slide ${e + 1} of ${t}`
 	};
 }
-var q = (e, { slide: t, totalSlides: n, title: r, imagePrompt: i }) => JSON.stringify([
+var he = (e, { slide: t, totalSlides: n, title: r, imagePrompt: i, html: a }) => JSON.stringify([
 	e,
 	t,
 	n,
 	r,
-	i
-]), J = N(() => ({
+	i,
+	a
+]), ge = B(() => ({
 	latest: {
 		presentation: null,
 		steps: null
 	},
 	lastShown: null,
-	repeats: G()
+	repeats: pe()
 }));
-function Y(e, t) {
+function _e(e, t) {
 	let n = e.latest[t.mode], r = n?.totalSlides === t.totalSlides && (t.slide !== 1 || n.firstTitle === t.title);
 	if (n && r) return n;
 	let i = {
-		id: O(),
+		id: L(),
 		mode: t.mode,
 		totalSlides: t.totalSlides,
 		firstTitle: t.slide === 1 ? t.title : "",
@@ -338,18 +392,18 @@ function Y(e, t) {
 	};
 	return e.latest[t.mode] = i, i;
 }
-function X(e, t, n, r) {
+function ve(e, t, n, r) {
 	t.current = n.slide, t.shownAt = Date.now(), e.lastShown = t;
 	let i = n.mode === "steps" ? "step" : "slide", { uuid: a, ...o } = r;
 	return {
 		...o,
 		message: `${i} ${n.slide} of ${n.totalSlides} is on the screen again, as it was`,
-		instructions: m(n),
+		instructions: S(n),
 		instructionsRequired: !0,
-		sequence: K(n)
+		sequence: me(n)
 	};
 }
-function ie(e, t) {
+function ye(e, t) {
 	if (e.mode !== "steps") return e.title ? `A presentation slide titled "${e.title}". ${e.imagePrompt}` : e.imagePrompt;
 	let n = e.title ? `, "${e.title}"` : "";
 	return [
@@ -358,15 +412,27 @@ function ie(e, t) {
 		"Show the action clearly, with little or no text."
 	].filter(Boolean).join(" ");
 }
-async function ae(e, t, n) {
-	let r = t.slides.get(n.slide - 1), i = n.mode === "steps" ? E(r).imagePath : void 0, a = i ? await A(e, [i]) : [], o = ie(n, a.length > 0), s = await j(e, o, a), { imageData: c, imagePath: l } = E(s);
-	if (!c) return {
+async function be(e, t, n) {
+	if (n.html) return {
+		html: n.html,
+		prompt: ""
+	};
+	let r = t.slides.get(n.slide - 1), i = n.mode === "steps" ? P(r).imagePath : void 0, a = i ? await R(e, [i]) : [], o = ye(n, a.length > 0), s = await z(e, o, a), { imageData: c, imagePath: l } = P(s);
+	return c ? {
+		imageData: c,
+		...l && { imagePath: l },
+		prompt: o
+	} : { failed: {
 		...s,
 		sequence: null
-	};
-	let u = t.id, d = await U(e.files?.artifacts, P, u, (e) => {
+	} };
+}
+async function xe(e, t, n) {
+	let r = await be(e, t, n);
+	if ("failed" in r) return r.failed;
+	let { imageData: i, imagePath: a, html: o, prompt: s } = r, c = t.id, l = await X(e.files?.artifacts, V, c, (e) => {
 		let t = e ?? {
-			id: u,
+			id: c,
 			title: "",
 			mode: n.mode,
 			totalSlides: n.totalSlides,
@@ -375,39 +441,41 @@ async function ae(e, t, n) {
 		return n.slide === 1 && (t.title = n.title), t.slides[String(n.slide)] = {
 			title: n.title,
 			imagePrompt: n.imagePrompt,
-			...l && { imagePath: l }
+			...a && { imagePath: a },
+			...o && { html: o }
 		}, t;
-	}), f = {
-		imageData: c,
-		...l && { imagePath: l },
-		prompt: o,
-		slideshowId: u,
+	}), u = {
+		...i && { imageData: i },
+		...a && { imagePath: a },
+		...o && { html: o },
+		prompt: s,
+		slideshowId: c,
 		slide: n.slide,
 		totalSlides: n.totalSlides,
 		title: n.title,
 		mode: n.mode
-	}, p = n.mode === "steps" ? "step" : "slide";
+	}, d = n.mode === "steps" ? "step" : "slide";
 	return {
-		data: f,
+		data: u,
 		title: n.title || `Slide ${n.slide}`,
 		message: [
-			`${p} ${n.slide} of ${n.totalSlides} of slideshow "${u}" is on the screen`,
-			l ? `saved to ${l}` : "",
-			d ? "" : W("slideshow")
+			`${d} ${n.slide} of ${n.totalSlides} of slideshow "${c}" is on the screen`,
+			a ? `saved to ${a}` : "",
+			l ? "" : Z("slideshow")
 		].filter(Boolean).join("; "),
-		instructions: m(n),
+		instructions: S(n),
 		instructionsRequired: !0,
-		sequence: K(n)
+		sequence: me(n)
 	};
 }
-async function Z(e, t) {
-	let n = p(t);
-	if (!n) return {
-		message: f,
+async function Q(e, t) {
+	let n = ie(t);
+	if (typeof n == "string") return {
+		message: n,
 		sequence: null
 	};
-	let r = J(e), i = Y(r, n), a = n.mode === "steps";
-	if (a && n.slide > i.current && i.current > 0 && !D(e, i.shownAt)) {
+	let r = ge(e), i = _e(r, n), a = n.mode === "steps";
+	if (a && n.slide > i.current && i.current > 0 && !I(e, i.shownAt)) {
 		console.info(`[sequence] holding step ${n.slide} for the user`);
 		let e = i.shownAt === Infinity ? "is still being drawn" : "is still on the screen";
 		return {
@@ -416,15 +484,15 @@ async function Z(e, t) {
 		};
 	}
 	let o = a ? i.slides.get(n.slide) : void 0;
-	if (o) return te(e.currentResult, o) ? {
+	if (o) return ce(e.currentResult, o) ? {
 		message: `step ${n.slide} of ${n.totalSlides} is already on the screen`,
 		cancelled: !0
-	} : X(r, i, n, o);
-	let s = r.repeats.claim(q(i.id, n));
+	} : ve(r, i, n, o);
+	let s = r.repeats.claim(he(i.id, n));
 	if ("earlier" in s) {
-		if (!await s.earlier) return Z(e, t);
+		if (!await s.earlier) return Q(e, t);
 		let a = i.slides.get(n.slide);
-		return a && r.lastShown !== i ? X(r, i, n, a) : {
+		return a && r.lastShown !== i ? ve(r, i, n, a) : {
 			message: `slide ${n.slide} of ${n.totalSlides} is already on the screen`,
 			cancelled: !0
 		};
@@ -436,22 +504,22 @@ async function Z(e, t) {
 	i.current = n.slide, i.shownAt = Infinity;
 	let u = !1;
 	try {
-		let t = await ae(e, i, n);
-		return u = !!E(t).imageData, u && (i.slides.set(n.slide, t), i.current = n.slide, i.shownAt = Date.now(), r.lastShown = i), t;
+		let t = await xe(e, i, n);
+		return u = se(t), u && (i.slides.set(n.slide, t), i.current = n.slide, i.shownAt = Date.now(), r.lastShown = i), t;
 	} finally {
 		c(u), !u && i.current === n.slide && (i.current = l.current, i.shownAt = l.shownAt);
 	}
 }
 //#endregion
 //#region src/core/storyboard.ts
-var oe = ({ id: e, title: t, totalPanels: n }) => ({
+var Se = ({ id: e, title: t, totalPanels: n }) => ({
 	step: 0,
 	total: n,
 	kind: "story",
 	label: `The cast of "${t}"`,
 	onShown: "introduce the characters",
 	nextCall: `call presentPanel for panel 1 of ${n} with storyboardId "${e}"`
-}), se = ({ id: e, totalPanels: t }, n, r) => ({
+}), Ce = ({ id: e, totalPanels: t }, n, r) => ({
 	step: n,
 	total: t,
 	kind: "story",
@@ -459,21 +527,21 @@ var oe = ({ id: e, title: t, totalPanels: n }) => ({
 	onShown: "tell that part of the story",
 	nextCall: `call presentPanel for panel ${n + 1} of ${t} with storyboardId "${e}"`,
 	...r.length > 0 && { waitsForUser: !0 }
-}), Q = (e, t) => e ? `${e}. ${t}` : t, ce = (e, { name: t, description: n }) => Q(e, `Character reference sheet of ${t}: ${n}. Full body, front, side and back views, on a plain white background. No text or labels.`);
-async function le(e, t) {
-	let n = _(t);
+}), we = (e, t) => e ? `${e}. ${t}` : t, Te = (e, { name: t, description: n }) => we(e, `Character reference sheet of ${t}: ${n}. Full body, front, side and back views, on a plain white background. No text or labels.`);
+async function Ee(e, t) {
+	let n = T(t);
 	if (typeof n == "string") return {
 		message: n,
 		sequence: null
 	};
-	let r = await Promise.all(n.characters.map((t) => j(e, ce(n.style, t)))), i = r.map(E), a = r.find((e, t) => !i[t]?.imageData);
+	let r = await Promise.all(n.characters.map((t) => z(e, Te(n.style, t)))), i = r.map(P), a = r.find((e, t) => !i[t]?.imageData);
 	if (i.every(({ imageData: e }) => !e) && a) return {
 		...a,
 		message: `the character sheets couldn't be made: ${a.message}`,
 		sequence: null
 	};
 	let o = {
-		id: O(),
+		id: L(),
 		...n,
 		characters: n.characters.map((e, t) => {
 			let n = i[t]?.imagePath;
@@ -483,7 +551,7 @@ async function le(e, t) {
 			};
 		}),
 		panels: {}
-	}, s = await U(e.files?.artifacts, F, o.id, () => o), c = o.characters.filter((e) => e.imagePath).map((e) => `${e.name}: ${e.imagePath}`), l = n.characters.map(({ name: e }, t) => i[t]?.imageData ? null : `${e} (${r[t]?.message ?? ""})`).filter((e) => !!e), u = i.find((e) => e.imageData)?.imageData;
+	}, s = await X(e.files?.artifacts, H, o.id, () => o), c = o.characters.filter((e) => e.imagePath).map((e) => `${e.name}: ${e.imagePath}`), l = n.characters.map(({ name: e }, t) => i[t]?.imageData ? null : `${e} (${r[t]?.message ?? ""})`).filter((e) => !!e), u = i.find((e) => e.imageData)?.imageData;
 	return {
 		data: {
 			storyboardId: o.id,
@@ -504,46 +572,46 @@ async function le(e, t) {
 			`storyboard "${o.id}" is ready with ${o.totalPanels} panels; the cast is on the screen`,
 			c.length ? `character sheets saved to ${c.join(", ")}` : "",
 			l.length ? `no sheet for ${l.join("; ")}: they will be drawn from their description` : "",
-			s ? "" : W("storyboard")
+			s ? "" : Z("storyboard")
 		].filter(Boolean).join("; "),
-		instructions: v(o),
+		instructions: E(o),
 		instructionsRequired: !0,
-		sequence: oe(o)
+		sequence: Se(o)
 	};
 }
-function ue(e, t, n) {
-	let r = [Q(e.style, `Panel ${t.panel} of ${e.totalPanels} of the illustrated story "${e.title}". ${t.imagePrompt}`)], i = 0, a = n.map(({ character: e, hasSheet: t }) => t ? `${e.name} is the character in reference image ${++i}` : `${e.name}: ${e.description}`);
+function De(e, t, n) {
+	let r = [we(e.style, `Panel ${t.panel} of ${e.totalPanels} of the illustrated story "${e.title}". ${t.imagePrompt}`)], i = 0, a = n.map(({ character: e, hasSheet: t }) => t ? `${e.name} is the character in reference image ${++i}` : `${e.name}: ${e.description}`);
 	return a.length && r.push(`${a.join(". ")}.`), i && r.push("Draw each character exactly as in their reference image: the same face, hair, clothes and colors. Use the reference images only for how the characters look, not for their pose or the background."), r.push("No captions, speech bubbles or other text in the picture."), r.join(" ");
 }
-async function de(e, t, n) {
+async function Oe(e, t, n) {
 	let r = [], i = [];
 	for (let a of n.characters) {
-		let n = t.characters.find((e) => u(e.name, a));
+		let n = t.characters.find((e) => y(e.name, a));
 		if (!n) r.push(a);
 		else if (!i.some((e) => e.character === n)) {
-			let [t] = n.imagePath ? await A(e, [n.imagePath]) : [];
+			let [t] = n.imagePath ? await R(e, [n.imagePath]) : [];
 			i.push({
 				character: n,
 				sheet: t ?? null
 			});
 		}
 	}
-	let a = i.map(({ sheet: e }) => e).filter((e) => !!e), o = ue(t, n, i.map(({ character: e, sheet: t }) => ({
+	let a = i.map(({ sheet: e }) => e).filter((e) => !!e), o = De(t, n, i.map(({ character: e, sheet: t }) => ({
 		character: e,
 		hasSheet: !!t
-	}))), s = await j(e, o, a), { imageData: c, imagePath: l } = E(s);
+	}))), s = await z(e, o, a), { imageData: c, imagePath: l } = P(s);
 	if (!c) return {
 		...s,
 		sequence: null
 	};
-	let d = n.panel < t.totalPanels && n.choices.length >= 2 ? n.choices : [], f = await U(e.files?.artifacts, F, t.id, (e) => {
+	let u = n.panel < t.totalPanels && n.choices.length >= 2 ? n.choices : [], d = await X(e.files?.artifacts, H, t.id, (e) => {
 		let r = e ?? t;
-		return d.length && (r.interactive = !0), r.panels[String(n.panel)] = {
+		return u.length && (r.interactive = !0), r.panels[String(n.panel)] = {
 			caption: n.caption,
 			characters: i.map(({ character: e }) => e.name),
 			imagePrompt: n.imagePrompt,
 			...l && { imagePath: l },
-			...d.length && { choices: d }
+			...u.length && { choices: u }
 		}, r;
 	});
 	return {
@@ -555,32 +623,32 @@ async function de(e, t, n) {
 			panel: n.panel,
 			totalPanels: t.totalPanels,
 			caption: n.caption,
-			...d.length && { choices: d }
+			...u.length && { choices: u }
 		},
 		title: n.caption || `Panel ${n.panel}`,
 		message: [
 			`panel ${n.panel} of ${t.totalPanels} is on the screen`,
 			l ? `saved to ${l}` : "",
 			r.length ? `not in the cast, so drawn from the prompt alone: ${r.join(", ")}` : "",
-			f ? "" : W("storyboard")
+			d ? "" : Z("storyboard")
 		].filter(Boolean).join("; "),
-		instructions: x(t, n.panel, d),
+		instructions: k(t, n.panel, u),
 		instructionsRequired: !0,
-		sequence: se(t, n.panel, d)
+		sequence: Ce(t, n.panel, u)
 	};
 }
-var fe = N(() => ({
-	repeats: G(),
+var ke = B(() => ({
+	repeats: pe(),
 	awaitingChoice: /* @__PURE__ */ new Map()
 }));
 async function $(e, t) {
-	let n = b(t);
+	let n = O(t);
 	if (!n) return {
-		message: y,
+		message: D,
 		sequence: null
 	};
-	let { storyboardId: r, panel: i } = n, { repeats: a, awaitingChoice: o } = fe(e), s = o.get(r);
-	if (s && i > s.panel && !D(e, s.shownAt)) return console.info(`[sequence] holding panel ${i} for the user`), {
+	let { storyboardId: r, panel: i } = n, { repeats: a, awaitingChoice: o } = ke(e), s = o.get(r);
+	if (s && i > s.panel && !I(e, s.shownAt)) return console.info(`[sequence] holding panel ${i} for the user`), {
 		message: s.shownAt === Infinity ? `panel ${i} was not shown: panel ${s.panel} is still being drawn. Wait for it before going on.` : `panel ${i} was not shown: the user hasn't picked a choice yet, and panel ${s.panel} is still on the screen. Wait for their answer.`,
 		cancelled: !0
 	};
@@ -596,7 +664,7 @@ async function $(e, t) {
 	o.set(r, u);
 	let f = () => o.get(r) === u, p = !1;
 	try {
-		let t = await H(e.files?.artifacts, F, r);
+		let t = await Y(e.files?.artifacts, H, r);
 		if (!t) return {
 			message: `there is no storyboard "${r}"; call defineStoryboard first`,
 			sequence: null
@@ -605,8 +673,8 @@ async function $(e, t) {
 			message: `storyboard "${t.id}" has ${t.totalPanels} panels`,
 			sequence: null
 		};
-		let a = await de(e, t, n);
-		p = !!E(a).imageData;
+		let a = await Oe(e, t, n);
+		p = !!P(a).imageData;
 		let s = a.data;
 		return p && f() && (s?.choices?.length ? o.set(r, {
 			panel: i,
@@ -618,21 +686,21 @@ async function $(e, t) {
 }
 //#endregion
 //#region src/core/index.ts
-var pe = {
-	toolDefinition: g,
+var Ae = {
+	toolDefinition: w,
 	generatingMessage: "Making the slide...",
 	isEnabled: () => !0,
-	execute: (e, t) => Z(e, t)
-}, me = {
-	toolDefinition: C,
+	execute: (e, t) => Q(e, t)
+}, je = {
+	toolDefinition: j,
 	generatingMessage: "Drawing the characters...",
 	isEnabled: () => !0,
-	execute: (e, t) => le(e, t)
-}, he = {
-	toolDefinition: w,
+	execute: (e, t) => Ee(e, t)
+}, Me = {
+	toolDefinition: M,
 	generatingMessage: "Drawing the panel...",
 	isEnabled: () => !0,
 	execute: (e, t) => $(e, t)
 };
 //#endregion
-export { b as C, m as D, u as E, x as S, _ as T, h as _, F as a, S as b, C as c, a as d, y as f, g, t as h, P as i, i as l, w as m, he as n, H as o, r as p, pe as r, n as s, me as t, o as u, s as v, p as w, v as x, f as y };
+export { o as A, k as C, y as D, T as E, t as M, f as N, S as O, E as S, ie as T, C as _, H as a, re as b, j as c, te as d, D as f, w as g, p as h, V as i, n as j, r as k, ee as l, M as m, Me as n, Y as o, h as p, Ae as r, m as s, je as t, ne as u, g as v, O as w, A as x, x as y };