@gui-chat-plugin/sequence 0.1.0 → 0.3.0

package/dist/core-BALd7sgj.js

@@ -0,0 +1,706 @@
+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 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: a ? "" : String(i),
+		...a && { html: a },
+		mode: e.mode === "steps" ? "steps" : "presentation"
+	};
+}
+var S = ({ slide: e, totalSlides: t, title: n, mode: r }) => {
+	let i = n ? ` ("${n}")` : "";
+	if (r === "steps") {
+		let n = `Step ${e} of ${t}${i}`;
+		return e < t ? `${n} is now on the screen. Explain what to do in this step, then stop and wait while the user does it. When they say they're ready (next, done, go on), call presentSlide for step ${e + 1} with mode "steps". If they ask to go back or to see a step again, call presentSlide for that step.` : `${n}, the last one, is now on the screen. Explain what to do, then wrap up the guide once the user is done.`;
+	}
+	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.`;
+}, 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: 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: {
+			slide: {
+				type: "integer",
+				description: "This slide's number, starting at 1."
+			},
+			totalSlides: {
+				type: "integer",
+				description: "How many slides the slideshow has. Keep it the same for every slide."
+			},
+			title: {
+				type: "string",
+				description: "The slide's title."
+			},
+			imagePrompt: {
+				type: "string",
+				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",
+				enum: ["presentation", "steps"],
+				description: "\"presentation\" (the default) goes on by itself; \"steps\" is a how-to the user does along with you, and waits for them after each step. Keep it the same for every slide."
+			}
+		},
+		required: [
+			"slide",
+			"totalSlides",
+			"title"
+		]
+	}
+};
+function T(e) {
+	let { totalPanels: t } = e;
+	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 = _(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) => 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: v(e.title),
+		style: v(e.style),
+		totalPanels: t,
+		characters: n,
+		interactive: e.interactive === !0
+	};
+}
+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: v(e.caption),
+		choices: i(e.choices).slice(0, 3)
+	};
+}
+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 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: 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",
+		properties: {
+			title: {
+				type: "string",
+				description: "The story's title."
+			},
+			style: {
+				type: "string",
+				description: "The art style of every picture, in one sentence (for example: soft watercolor, children's picture book)."
+			},
+			totalPanels: {
+				type: "integer",
+				description: "How many panels the story has, at most 12; four to eight is usual."
+			},
+			interactive: {
+				type: "boolean",
+				description: "The user chooses what happens: panels can offer choices, and the story waits for the pick."
+			},
+			characters: {
+				type: "array",
+				description: "The characters who appear in more than one panel, 1 to 4.",
+				items: {
+					type: "object",
+					properties: {
+						name: {
+							type: "string",
+							description: "A short name, used in presentPanel."
+						},
+						description: {
+							type: "string",
+							description: "How they look: age, build, face, hair, clothes and colors. Be concrete: it is drawn once and reused in every panel."
+						}
+					},
+					required: ["name", "description"]
+				}
+			}
+		},
+		required: [
+			"title",
+			"style",
+			"totalPanels",
+			"characters"
+		]
+	}
+}, M = {
+	type: "function",
+	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",
+		properties: {
+			storyboardId: {
+				type: "string",
+				description: "The storyboardId defineStoryboard returned."
+			},
+			panel: {
+				type: "integer",
+				description: "This panel's number, starting at 1."
+			},
+			characters: {
+				type: "array",
+				items: { type: "string" },
+				description: "The names (as in defineStoryboard) of the characters in this panel."
+			},
+			imagePrompt: {
+				type: "string",
+				description: "What the panel shows: the setting, what happens, expressions and the camera angle. Refer to characters by name; don't describe their looks again."
+			},
+			caption: {
+				type: "string",
+				description: "One short line shown under the picture."
+			},
+			choices: {
+				type: "array",
+				items: { type: "string" },
+				description: "Only in an interactive story, and not on the last panel: two or three short options for what happens next. The story waits for the user's pick."
+			}
+		},
+		required: [
+			"storyboardId",
+			"panel",
+			"characters",
+			"imagePrompt"
+		]
+	}
+}, 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 F(e) {
+	let t = N(e?.data) ? e.data : {};
+	return typeof t.html == "string" ? t.html : "";
+}
+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(le)) try {
+		await n.exists(e.slice(10)) && r.push(e);
+	} catch {}
+	return r;
+}
+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 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 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 > ue) {
+			let e = t.keys().next().value;
+			e !== void 0 && t.delete(e);
+		}
+		return i;
+	};
+}
+//#endregion
+//#region src/core/records.ts
+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 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 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 {
+		let r = JSON.parse(await e.read(t));
+		return n.set(t, r), r;
+	} catch {
+		return null;
+	}
+}
+async function Y(e, t, n) {
+	return g.test(n) ? J(e, q(t, n)) : null;
+}
+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) {
+			return console.warn("[sequence] could not save", i, e), !1;
+		}
+	});
+}
+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 > 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);
+		return e.set(t, {
+			at: n,
+			shown: a
+		}), { settle: (n) => {
+			!n && e.get(t)?.shown === a && e.delete(t), i(n);
+		} };
+	} };
+}
+//#endregion
+//#region src/core/presentSlide.ts
+function me({ slide: e, totalSlides: t, mode: n }) {
+	return n === "steps" ? {
+		step: e,
+		total: t,
+		kind: "guide",
+		label: `Step ${e} of ${t}`,
+		onShown: "explain it",
+		nextCall: `call presentSlide for step ${e + 1} of ${t} with mode "steps"`,
+		waitsForUser: !0
+	} : {
+		step: e,
+		total: t,
+		kind: "slideshow",
+		label: `Slide ${e} of ${t}`,
+		onShown: "explain it",
+		nextCall: `call presentSlide for slide ${e + 1} of ${t}`
+	};
+}
+var he = (e, { slide: t, totalSlides: n, title: r, imagePrompt: i, html: a }) => JSON.stringify([
+	e,
+	t,
+	n,
+	r,
+	i,
+	a
+]), ge = B(() => ({
+	latest: {
+		presentation: null,
+		steps: null
+	},
+	lastShown: null,
+	repeats: pe()
+}));
+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: L(),
+		mode: t.mode,
+		totalSlides: t.totalSlides,
+		firstTitle: t.slide === 1 ? t.title : "",
+		slides: /* @__PURE__ */ new Map(),
+		current: 0,
+		shownAt: -Infinity
+	};
+	return e.latest[t.mode] = i, i;
+}
+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: S(n),
+		instructionsRequired: !0,
+		sequence: me(n)
+	};
+}
+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 [
+		`An instructional illustration of step ${e.slide} of ${e.totalSlides}${n}. ${e.imagePrompt}`,
+		t ? "The reference image is the previous step: keep the same objects, hands, tools and setting, and show what this step changes." : "",
+		"Show the action clearly, with little or no text."
+	].filter(Boolean).join(" ");
+}
+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
+	} };
+}
+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: c,
+			title: "",
+			mode: n.mode,
+			totalSlides: n.totalSlides,
+			slides: {}
+		};
+		return n.slide === 1 && (t.title = n.title), t.slides[String(n.slide)] = {
+			title: n.title,
+			imagePrompt: n.imagePrompt,
+			...a && { imagePath: a },
+			...o && { html: o }
+		}, t;
+	}), 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
+	}, d = n.mode === "steps" ? "step" : "slide";
+	return {
+		data: u,
+		title: n.title || `Slide ${n.slide}`,
+		message: [
+			`${d} ${n.slide} of ${n.totalSlides} of slideshow "${c}" is on the screen`,
+			a ? `saved to ${a}` : "",
+			l ? "" : Z("slideshow")
+		].filter(Boolean).join("; "),
+		instructions: S(n),
+		instructionsRequired: !0,
+		sequence: me(n)
+	};
+}
+async function Q(e, t) {
+	let n = ie(t);
+	if (typeof n == "string") return {
+		message: n,
+		sequence: null
+	};
+	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 {
+			message: `step ${n.slide} was not shown: the user hasn't said they're ready yet, and step ${i.current} ${e}. Wait for them before calling presentSlide for step ${n.slide}.`,
+			cancelled: !0
+		};
+	}
+	let o = a ? i.slides.get(n.slide) : void 0;
+	if (o) return ce(e.currentResult, o) ? {
+		message: `step ${n.slide} of ${n.totalSlides} is already on the screen`,
+		cancelled: !0
+	} : ve(r, i, n, o);
+	let s = r.repeats.claim(he(i.id, n));
+	if ("earlier" in s) {
+		if (!await s.earlier) return Q(e, t);
+		let a = i.slides.get(n.slide);
+		return a && r.lastShown !== i ? ve(r, i, n, a) : {
+			message: `slide ${n.slide} of ${n.totalSlides} is already on the screen`,
+			cancelled: !0
+		};
+	}
+	let { settle: c } = s, l = {
+		current: i.current,
+		shownAt: i.shownAt
+	};
+	i.current = n.slide, i.shownAt = Infinity;
+	let u = !1;
+	try {
+		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 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}"`
+}), Ce = ({ id: e, totalPanels: t }, n, r) => ({
+	step: n,
+	total: t,
+	kind: "story",
+	label: `Panel ${n} of ${t}`,
+	onShown: "tell that part of the story",
+	nextCall: `call presentPanel for panel ${n + 1} of ${t} with storyboardId "${e}"`,
+	...r.length > 0 && { waitsForUser: !0 }
+}), 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) => 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: L(),
+		...n,
+		characters: n.characters.map((e, t) => {
+			let n = i[t]?.imagePath;
+			return {
+				...e,
+				...n && { imagePath: n }
+			};
+		}),
+		panels: {}
+	}, 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,
+			title: o.title,
+			totalPanels: o.totalPanels,
+			...u && { imageData: u },
+			characters: o.characters.map(({ name: e, imagePath: t }, n) => {
+				let r = i[n]?.imageData;
+				return {
+					name: e,
+					...r && { imageData: r },
+					...t && { imagePath: t }
+				};
+			})
+		},
+		title: o.title,
+		message: [
+			`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 ? "" : Z("storyboard")
+		].filter(Boolean).join("; "),
+		instructions: E(o),
+		instructionsRequired: !0,
+		sequence: Se(o)
+	};
+}
+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 Oe(e, t, n) {
+	let r = [], i = [];
+	for (let a of n.characters) {
+		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 R(e, [n.imagePath]) : [];
+			i.push({
+				character: n,
+				sheet: t ?? null
+			});
+		}
+	}
+	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 z(e, o, a), { imageData: c, imagePath: l } = P(s);
+	if (!c) return {
+		...s,
+		sequence: null
+	};
+	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 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 },
+			...u.length && { choices: u }
+		}, r;
+	});
+	return {
+		data: {
+			imageData: c,
+			...l && { imagePath: l },
+			prompt: o,
+			storyboardId: t.id,
+			panel: n.panel,
+			totalPanels: t.totalPanels,
+			caption: n.caption,
+			...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(", ")}` : "",
+			d ? "" : Z("storyboard")
+		].filter(Boolean).join("; "),
+		instructions: k(t, n.panel, u),
+		instructionsRequired: !0,
+		sequence: Ce(t, n.panel, u)
+	};
+}
+var ke = B(() => ({
+	repeats: pe(),
+	awaitingChoice: /* @__PURE__ */ new Map()
+}));
+async function $(e, t) {
+	let n = O(t);
+	if (!n) return {
+		message: D,
+		sequence: null
+	};
+	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
+	};
+	let c = a.claim(JSON.stringify(n));
+	if ("earlier" in c) return await c.earlier ? {
+		message: `panel ${i} is already on the screen`,
+		cancelled: !0
+	} : $(e, t);
+	let { settle: l } = c, u = {
+		panel: i,
+		shownAt: Infinity
+	}, d = o.get(r);
+	o.set(r, u);
+	let f = () => o.get(r) === u, p = !1;
+	try {
+		let t = await Y(e.files?.artifacts, H, r);
+		if (!t) return {
+			message: `there is no storyboard "${r}"; call defineStoryboard first`,
+			sequence: null
+		};
+		if (i > t.totalPanels) return {
+			message: `storyboard "${t.id}" has ${t.totalPanels} panels`,
+			sequence: null
+		};
+		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,
+			shownAt: Date.now()
+		}) : o.delete(r)), a;
+	} finally {
+		l(p), !p && f() && (d ? o.set(r, d) : o.delete(r));
+	}
+}
+//#endregion
+//#region src/core/index.ts
+var Ae = {
+	toolDefinition: w,
+	generatingMessage: "Making the slide...",
+	isEnabled: () => !0,
+	execute: (e, t) => Q(e, t)
+}, je = {
+	toolDefinition: j,
+	generatingMessage: "Drawing the characters...",
+	isEnabled: () => !0,
+	execute: (e, t) => Ee(e, t)
+}, Me = {
+	toolDefinition: M,
+	generatingMessage: "Drawing the panel...",
+	isEnabled: () => !0,
+	execute: (e, t) => $(e, t)
+};
+//#endregion
+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 };