@gui-chat-plugin/sequence 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0
+
+First release: `presentSlide`, `defineStoryboard` and `presentPanel`, from MulmoChat and
+MulmoGlass, as one host-agnostic package. Results carry gui-chat-protocol 2.1's `sequence`; the
+holds read `context.userSpokeAt`; references are drawn with `context.app.editImages`.

package/README.md

@@ -0,0 +1,72 @@
+# @gui-chat-plugin/sequence
+
+Tools that show things one step at a time, as pictures, for
+[GUI Chat Protocol](https://github.com/receptron/gui-chat-protocol) hosts:
+
+| Tool               | Shows                                                                                                                                     |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `presentSlide`     | One slide of a spoken slideshow (mode `"presentation"`), or one step of a step-by-step guide the user follows along with (mode `"steps"`) |
+| `defineStoryboard` | A story's cast: a reference sheet for each recurring character                                                                            |
+| `presentPanel`     | One panel of the story, with its characters drawn as in their sheets; an interactive story offers choices                                 |
+
+From MulmoChat and MulmoGlass, tested there by voice on OpenAI Realtime, Gemini Live and Grok, and
+in text chat.
+
+## Using it in a host
+
+```ts
+import { plugins } from "@gui-chat-plugin/sequence/vue"; // presentSlide, defineStoryboard, presentPanel
+import "@gui-chat-plugin/sequence/style.css";
+```
+
+The core entry (`@gui-chat-plugin/sequence`) has the same tools without Views, for a host that runs
+`execute()` on a server, plus the record types and `loadRecord`, `SLIDESHOWS_DIR` and
+`STORYBOARDS_DIR` for tools that read the records (MulmoChat's makeMovie).
+
+### What `execute()` needs from its context
+
+|                                      | Used for                                                                                       | Without it                                                                          |
+| ------------------------------------ | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| `app.generateImage(prompt)`          | every picture                                                                                  | "image generation isn't available"                                                  |
+| `app.editImages(prompt, imagePaths)` | a panel drawn from its characters' sheets, a guide step drawn from the step before             | drawn from the prompt alone                                                         |
+| `files.artifacts` (`FileOps`)        | the records, and checking that a reference picture is still there                              | records are kept in memory only (the results say they weren't saved); no references |
+| `userSpokeAt`                        | holding a guide's next step, or a story's next panel after a choice, until the user has spoken | nothing is held                                                                     |
+| `currentResult`                      | telling "show step 2 again" (it isn't on the screen) from a repeated call (it is)              | a step asked for again is shown again                                               |
+
+`generateImage` and `editImages` are gui-chat-protocol's `context.app` conventions: they save each
+picture as `artifacts/images/…` and return its path in `data.imagePath`. `currentResult` is compared
+by `data.imagePath` when it has one, so a host that runs `execute()` on a server can send the
+current result without its picture.
+
+### Keeping a sequence going
+
+Every shown step's result carries `sequence` (gui-chat-protocol 2.1): where the sequence is, or
+`null` when a step couldn't be shown. A host that wires gui-chat-protocol's `createSequenceKeeper`
+asks the model to go on when it ends a reply mid-slideshow, and passes `keeper.userSpokeAt()` as
+`context.userSpokeAt`. Without it the tools still work: each step asks for the next in its
+instructions, which models usually follow.
+
+Step results also set `instructionsRequired`, so a turn-based host (text chat) takes a turn for the
+model to explain the step.
+
+### State
+
+The holds, the repeat guard and each slideshow's shown steps are kept in memory where `execute()`
+runs, as one conversation's. A host that runs `execute()` for several users in one process would
+mix them. Calls may overlap (a host that runs `execute()` on a server gets them as concurrent
+requests): a call is claimed before anything is awaited, so an identical one waits for it and a
+later step is held while it is drawn.
+
+## Records
+
+Saved through `files.artifacts`, with their pictures' paths:
+
+- `slideshows/<id>.json`: `{ id, title, mode, totalSlides, slides: { "1": { title, imagePrompt, imagePath } } }`
+- `storyboards/<id>.json`: `{ id, title, style, totalPanels, interactive, characters: [{ name, description, imagePath }], panels: { "1": { caption, characters, imagePrompt, imagePath, choices } } }`
+
+IDs are 12 hex digits. The results name them, so a later tool call can refer to a slideshow or a
+story (MulmoChat's makeMovie makes a narrated movie from one).
+
+## License
+
+MIT

package/dist/core/definitions.d.ts

@@ -0,0 +1,126 @@
+import type { ToolDefinition } from "gui-chat-protocol";
+export declare const PRESENT_SLIDE = "presentSlide";
+export declare const DEFINE_STORYBOARD = "defineStoryboard";
+export declare const PRESENT_PANEL = "presentPanel";
+export declare const MAX_CHARACTERS = 4;
+export declare const MAX_PANELS = 12;
+export declare const MAX_CHOICES = 3;
+/** A slideshow's or storyboard's ID: 12 hex digits, also its file name. */
+export declare const SEQUENCE_ID: RegExp;
+export declare const sameName: (a: string, b: string) => boolean;
+export type SlideMode = "presentation" | "steps";
+export interface SlideArgs {
+    slide: number;
+    totalSlides: number;
+    title: string;
+    imagePrompt: string;
+    mode: SlideMode;
+}
+export declare const SLIDE_ARGS_ERROR = "presentSlide needs slide and totalSlides (whole numbers, slide from 1 to totalSlides) and an imagePrompt";
+/** The slide arguments, or null when the model sent something else. */
+export declare function parseSlideArgs(args: Record<string, unknown>): SlideArgs | null;
+/** What the model does once a slide is on the screen. */
+export declare const slideShownInstructions: ({ slide, totalSlides, title, mode, }: SlideArgs) => string;
+/** A slideshow as saved in artifacts/slideshows/<id>.json. */
+export interface Slideshow {
+    id: string;
+    /** The first slide's title. */
+    title: string;
+    mode: SlideMode;
+    totalSlides: number;
+    slides: Record<string, {
+        title: string;
+        imagePrompt: string;
+        imagePath?: string;
+    }>;
+}
+/** A shown slide's result data. */
+export interface SlideData {
+    imageData: string;
+    imagePath?: string;
+    prompt: string;
+    slideshowId: string;
+    slide: number;
+    totalSlides: number;
+    title: string;
+    mode: SlideMode;
+}
+export declare const PRESENT_SLIDE_PROMPT: string;
+export declare const PRESENT_SLIDE_DEFINITION: ToolDefinition;
+export interface Character {
+    name: string;
+    description: string;
+    /** Its reference sheet, when one was made and saved. */
+    imagePath?: string;
+}
+export interface Panel {
+    caption: string;
+    characters: string[];
+    imagePrompt: string;
+    imagePath?: string;
+    /** In an interactive story, what the user chose between after it. */
+    choices?: string[];
+}
+/** A storyboard as saved in artifacts/storyboards/<id>.json. It maps onto a
+ *  MulmoScript: each character (name and sheet) an entry in
+ *  imageParams.images, each panel a beat, a panel's characters its
+ *  imageNames. */
+export interface Storyboard {
+    id: string;
+    title: string;
+    style: string;
+    totalPanels: number;
+    characters: Character[];
+    /** The user chooses what happens at some panels; the panels saved are the
+     *  path the story took. */
+    interactive: boolean;
+    panels: Record<string, Panel>;
+}
+export interface StoryboardArgs {
+    title: string;
+    style: string;
+    totalPanels: number;
+    characters: Character[];
+    interactive: boolean;
+}
+/** The arguments, or what is wrong with them (said to the model). */
+export declare function parseStoryboardArgs(args: Record<string, unknown>): StoryboardArgs | string;
+export declare const castShownInstructions: ({ title, id }: Storyboard) => string;
+/** The cast's result data. */
+export interface CastData {
+    storyboardId: string;
+    title: string;
+    totalPanels: number;
+    /** The first sheet, for the preview. */
+    imageData?: string;
+    characters: {
+        name: string;
+        imageData?: string;
+        imagePath?: string;
+    }[];
+}
+export interface PanelArgs {
+    storyboardId: string;
+    panel: number;
+    characters: string[];
+    imagePrompt: string;
+    caption: string;
+    choices: string[];
+}
+export declare const PANEL_ARGS_ERROR = "presentPanel needs a storyboardId, a panel number (from 1) and an imagePrompt";
+export declare function parsePanelArgs(args: Record<string, unknown>): PanelArgs | null;
+export declare function panelShownInstructions(storyboard: Pick<Storyboard, "id" | "totalPanels">, panel: number, choices: string[]): string;
+/** A shown panel's result data. */
+export interface PanelData {
+    imageData: string;
+    imagePath?: string;
+    prompt: string;
+    storyboardId: string;
+    panel: number;
+    totalPanels: number;
+    caption: string;
+    choices?: string[];
+}
+export declare const STORYBOARD_PROMPT = "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.";
+export declare const DEFINE_STORYBOARD_DEFINITION: ToolDefinition;
+export declare const PRESENT_PANEL_DEFINITION: ToolDefinition;

package/dist/core/host.d.ts

@@ -0,0 +1,27 @@
+import type { FileOps, ToolContext, ToolResult } from "gui-chat-protocol";
+/** The context execute() is called with. */
+export type SequenceContext = ToolContext & {
+    files?: {
+        artifacts: FileOps;
+    };
+};
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+/** The picture a result carries, and where it was saved. */
+export declare function imageOf(result: ToolResult | null | undefined): {
+    imageData?: string;
+    imagePath?: string;
+};
+/** Whether two results show the same picture: by its saved path when both
+ *  have one (a host may send the current result without its image data),
+ *  else by the picture itself. */
+export declare function samePicture(a: ToolResult | null | undefined, b: ToolResult | null | undefined): boolean;
+/** When the user spoke after `time` (ms since the epoch). A host that doesn't
+ *  say when the user spoke holds nothing. */
+export declare const userSpokeSince: (context: SequenceContext, time: number) => boolean;
+export declare const newSequenceId: () => string;
+/** The saved pictures among `paths` that the host can draw from: under
+ *  artifacts/, still there, and only when the host takes references. */
+export declare function usableReferences(context: SequenceContext, paths: readonly string[]): Promise<string[]>;
+/** A picture from the host: from `references` (saved paths) when there are
+ *  any, else from the prompt alone. A failure is a result saying why. */
+export declare function drawPicture(context: SequenceContext, prompt: string, references?: readonly string[]): Promise<ToolResult>;

package/dist/core/index.d.ts

@@ -0,0 +1,8 @@
+import type { ToolPluginCore } from "gui-chat-protocol";
+type SequencePluginCore = ToolPluginCore<unknown, unknown, Record<string, unknown>>;
+export declare const presentSlidePluginCore: SequencePluginCore;
+export declare const defineStoryboardPluginCore: SequencePluginCore;
+export declare const presentPanelPluginCore: SequencePluginCore;
+export * from "./definitions";
+export { SLIDESHOWS_DIR, STORYBOARDS_DIR, loadRecord } from "./records";
+export type { SequenceContext } from "./host";

package/dist/core/presentSlide.d.ts

@@ -0,0 +1,6 @@
+import type { SequenceStep, ToolResult } from "gui-chat-protocol";
+import { type SlideArgs } from "./definitions";
+import { type SequenceContext } from "./host";
+/** Where the slideshow is after a slide was shown. */
+export declare function slideSequenceStep({ slide: step, totalSlides: total, mode, }: SlideArgs): SequenceStep;
+export declare function presentSlide(context: SequenceContext, args: Record<string, unknown>): Promise<ToolResult>;

package/dist/core/records.d.ts

@@ -0,0 +1,17 @@
+import { type FileOps } from "gui-chat-protocol";
+import { type Slideshow, type Storyboard } from "./definitions";
+export declare const SLIDESHOWS_DIR = "slideshows";
+export declare const STORYBOARDS_DIR = "storyboards";
+type SequenceRecord = Slideshow | Storyboard;
+/** A saved slideshow or storyboard, or null. `id` is checked first, so a
+ *  model-written ID can't name another file. */
+export declare function loadRecord<T extends SequenceRecord>(files: FileOps | undefined, dir: string, id: string): Promise<T | null>;
+/**
+ * Change a record (null when there is none yet) and save it. Resolves to
+ * whether it was saved: one that wasn't (no files, or the write failed)
+ * still works while the host runs, and the result says so, as for a picture
+ * that wasn't saved.
+ */
+export declare function updateRecord<T extends SequenceRecord>(files: FileOps | undefined, dir: string, id: string, change: (record: T | null) => T): Promise<boolean>;
+export declare const NOT_SAVED: (what: string) => string;
+export {};

package/dist/core/repeatGuard.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A request claimed: either this call makes it (`settle` says whether it was
+ * shown), or an identical one made in the last minute does (`earlier`
+ * resolves to whether that one was shown).
+ */
+export type Claim = {
+    settle: (shown: boolean) => void;
+} | {
+    earlier: Promise<boolean>;
+};
+/** Drops a repeat of a request made in the last minute. */
+export declare function createRepeatGuard(): {
+    claim: (key: string) => Claim;
+};

package/dist/core/storyboard.d.ts

@@ -0,0 +1,4 @@
+import type { ToolResult } from "gui-chat-protocol";
+import { type SequenceContext } from "./host";
+export declare function defineStoryboard(context: SequenceContext, args: Record<string, unknown>): Promise<ToolResult>;
+export declare function presentPanel(context: SequenceContext, args: Record<string, unknown>): Promise<ToolResult>;

package/dist/core-55UuKHJb.cjs

@@ -0,0 +1 @@
+let e=require("gui-chat-protocol");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:{slide:t,totalSlides:n,title:typeof r==`string`?r:``,imagePrompt:i,mode:e.mode===`steps`?`steps`:`presentation`}}var m=({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.`},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={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.`,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:`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.`},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`,`imagePrompt`]}};function _(e){let{totalPanels:t}=e;if(!d(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):``;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}`;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),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);return{storyboardId:n,panel:t,characters:i(e.characters),imagePrompt:r,caption:l(e.caption),choices:i(e.choices).slice(0,3)}}function x(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={type:`function`,name:n,prompt:S,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`]}},w={type:`function`,name:r,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`]}},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:{};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}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){let n=e.files?.artifacts;if(!e.app?.editImages||!n)return[];let r=[];for(let e of t)if(e.startsWith(k))try{await n.exists(e.slice(10))&&r.push(e)}catch{}return r}async function j(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`}}catch(e){return{message:`image generation failed: ${e instanceof Error?e.message:String(e)}`}}}var M=`slideshows`,N=`storyboards`,P={},F=new WeakMap,I=new WeakMap;function L(e){let t=F.get(e);return t||F.set(e,t=new Map),t}function R(t,n){let r=I.get(t);r||I.set(t,r=new Map);let i=r.get(n);return i||r.set(n,i=(0,e.createSerialLock)()),i}var z=(e,t)=>`${e}/${t}.json`;async function B(e,t){let n=L(e??P),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 V(e,t,n){return s.test(n)?B(e,z(t,n)):null}async function H(e,t,n,r){let i=z(t,n),a=e??P;return R(a,i)(async()=>{let t=r(await B(e,i));if(L(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 U=e=>`the ${e} could not be saved, so it lasts only until the app or server restarts`,ne=6e4;function W(){let e=new Map;return{claim:t=>{let n=Date.now();for(let[t,r]of e)n-r.at>ne&&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)}}}}}function G({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 re=W(),ie=(e,{slide:t,totalSlides:n,title:r,imagePrompt:i})=>JSON.stringify([e,t,n,r,i]),K={presentation:null,steps:null},q=null;function J(e){let t=K[e.mode],n=t?.totalSlides===e.totalSlides&&(e.slide!==1||t.firstTitle===e.title);if(t&&n)return t;let r={id:O(),mode:e.mode,totalSlides:e.totalSlides,firstTitle:e.slide===1?e.title:``,slides:new Map,current:0,shownAt:-1/0};return K[e.mode]=r,r}function Y(e,t,n){e.current=t.slide,e.shownAt=Date.now(),q=e;let r=t.mode===`steps`?`step`:`slide`,{uuid:i,...a}=n;return{...a,message:`${r} ${t.slide} of ${t.totalSlides} is on the screen again, as it was`,instructions:m(t),instructionsRequired:!0,sequence:G(t)}}function ae(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 oe(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=ae(n,a.length>0),s=await j(e,o,a),{imageData:c,imagePath:l}=E(s);if(!c)return{...s,sequence:null};let u=t.id,d=await H(e.files?.artifacts,M,u,e=>{let t=e??{id:u,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,...l&&{imagePath:l}},t}),f={imageData:c,...l&&{imagePath:l},prompt:o,slideshowId:u,slide:n.slide,totalSlides:n.totalSlides,title:n.title,mode:n.mode},p=n.mode===`steps`?`step`:`slide`;return{data:f,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?``:U(`slideshow`)].filter(Boolean).join(`; `),instructions:m(n),instructionsRequired:!0,sequence:G(n)}}async function X(e,t){let n=p(t);if(!n)return{message:f,sequence:null};let r=J(n),i=n.mode===`steps`;if(i&&n.slide>r.current&&r.current>0&&!D(e,r.shownAt)){console.info(`[sequence] holding step ${n.slide} for the user`);let e=r.shownAt===1/0?`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 ${r.current} ${e}. Wait for them before calling presentSlide for step ${n.slide}.`,cancelled:!0}}let a=i?r.slides.get(n.slide):void 0;if(a)return te(e.currentResult,a)?{message:`step ${n.slide} of ${n.totalSlides} is already on the screen`,cancelled:!0}:Y(r,n,a);let o=re.claim(ie(r.id,n));if(`earlier`in o){if(!await o.earlier)return X(e,t);let i=r.slides.get(n.slide);return i&&q!==r?Y(r,n,i):{message:`slide ${n.slide} of ${n.totalSlides} is already on the screen`,cancelled:!0}}let{settle:s}=o,c={current:r.current,shownAt:r.shownAt};r.current=n.slide,r.shownAt=1/0;let l=!1;try{let t=await oe(e,r,n);return l=!!E(t).imageData,l&&(r.slides.set(n.slide,t),r.current=n.slide,r.shownAt=Date.now(),q=r),t}finally{s(l),!l&&r.current===n.slide&&(r.current=c.current,r.shownAt=c.shownAt)}}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}}),Z=(e,t)=>e?`${e}. ${t}`:t,le=(e,{name:t,description:n})=>Z(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 ue(e,t){let n=_(t);if(typeof n==`string`)return{message:n,sequence:null};let r=await Promise.all(n.characters.map(t=>j(e,le(n.style,t)))),i=r.map(E),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(),...n,characters:n.characters.map((e,t)=>{let n=i[t]?.imagePath;return{...e,...n&&{imagePath:n}}}),panels:{}},s=await H(e.files?.artifacts,N,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?``:U(`storyboard`)].filter(Boolean).join(`; `),instructions:v(o),instructionsRequired:!0,sequence:se(o)}}function de(e,t,n){let r=[Z(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 fe(e,t,n){let r=[],i=[];for(let a of n.characters){let n=t.characters.find(e=>u(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]):[];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 j(e,o,a),{imageData:c,imagePath:l}=E(s);if(!c)return{...s,sequence:null};let d=n.panel<t.totalPanels&&n.choices.length>=2?n.choices:[],f=await H(e.files?.artifacts,N,t.id,e=>{let r=e??t;return d.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}},r});return{data:{imageData:c,...l&&{imagePath:l},prompt:o,storyboardId:t.id,panel:n.panel,totalPanels:t.totalPanels,caption:n.caption,...d.length&&{choices:d}},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?``:U(`storyboard`)].filter(Boolean).join(`; `),instructions:x(t,n.panel,d),instructionsRequired:!0,sequence:ce(t,n.panel,d)}}var pe=W(),Q=new Map;async function $(e,t){let n=b(t);if(!n)return{message:y,sequence:null};let{storyboardId:r,panel:i}=n,a=Q.get(r);if(a&&i>a.panel&&!D(e,a.shownAt))return console.info(`[sequence] holding panel ${i} for the user`),{message:a.shownAt===1/0?`panel ${i} was not shown: panel ${a.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 ${a.panel} is still on the screen. Wait for their answer.`,cancelled:!0};let o=pe.claim(JSON.stringify(n));if(`earlier`in o)return await o.earlier?{message:`panel ${i} is already on the screen`,cancelled:!0}:$(e,t);let{settle:s}=o,c={panel:i,shownAt:1/0},l=Q.get(r);Q.set(r,c);let u=()=>Q.get(r)===c,d=!1;try{let t=await V(e.files?.artifacts,N,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 fe(e,t,n);d=!!E(a).imageData;let o=a.data;return d&&u()&&(o?.choices?.length?Q.set(r,{panel:i,shownAt:Date.now()}):Q.delete(r)),a}finally{s(d),!d&&u()&&(l?Q.set(r,l):Q.delete(r))}}var me={toolDefinition:g,generatingMessage:`Making the slide...`,isEnabled:()=>!0,execute:(e,t)=>X(e,t)},he={toolDefinition:C,generatingMessage:`Drawing the characters...`,isEnabled:()=>!0,execute:(e,t)=>ue(e,t)},ge={toolDefinition:w,generatingMessage:`Drawing the panel...`,isEnabled:()=>!0,execute:(e,t)=>$(e,t)};Object.defineProperty(exports,"C",{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,"D",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"E",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"S",{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,"T",{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,"_",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return N}}),Object.defineProperty(exports,"b",{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,"g",{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,"h",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return M}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"m",{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return ge}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return V}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return me}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return he}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"v",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"w",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"x",{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,"y",{enumerable:!0,get:function(){return f}});

package/dist/core-D0F2WGN6.js

@@ -0,0 +1,619 @@
+import { createSerialLock as e } from "gui-chat-protocol";
+//#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 : {
+		slide: t,
+		totalSlides: n,
+		title: typeof r == "string" ? r : "",
+		imagePrompt: i,
+		mode: e.mode === "steps" ? "steps" : "presentation"
+	};
+}
+var m = ({ 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.`;
+}, 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 = {
+	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.",
+	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: "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."
+			},
+			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",
+			"imagePrompt"
+		]
+	}
+};
+function _(e) {
+	let { totalPanels: t } = e;
+	if (!d(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) : "";
+		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}`;
+		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),
+		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);
+	return {
+		storyboardId: n,
+		panel: t,
+		characters: i(e.characters),
+		imagePrompt: r,
+		caption: l(e.caption),
+		choices: i(e.choices).slice(0, 3)
+	};
+}
+function x(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 = {
+	type: "function",
+	name: n,
+	prompt: S,
+	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"
+		]
+	}
+}, w = {
+	type: "function",
+	name: r,
+	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"
+		]
+	}
+}, 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 : {};
+	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;
+}
+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) {
+	let n = e.files?.artifacts;
+	if (!e.app?.editImages || !n) return [];
+	let r = [];
+	for (let e of t) if (e.startsWith(k)) try {
+		await n.exists(e.slice(10)) && r.push(e);
+	} catch {}
+	return r;
+}
+async function j(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" };
+	} catch (e) {
+		return { message: `image generation failed: ${e instanceof Error ? e.message : String(e)}` };
+	}
+}
+//#endregion
+//#region src/core/records.ts
+var M = "slideshows", N = "storyboards", P = {}, F = /* @__PURE__ */ new WeakMap(), I = /* @__PURE__ */ new WeakMap();
+function L(e) {
+	let t = F.get(e);
+	return t || F.set(e, t = /* @__PURE__ */ new Map()), t;
+}
+function R(t, n) {
+	let r = I.get(t);
+	r || I.set(t, r = /* @__PURE__ */ new Map());
+	let i = r.get(n);
+	return i || r.set(n, i = e()), i;
+}
+var z = (e, t) => `${e}/${t}.json`;
+async function B(e, t) {
+	let n = L(e ?? P), 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 V(e, t, n) {
+	return s.test(n) ? B(e, z(t, n)) : null;
+}
+async function H(e, t, n, r) {
+	let i = z(t, n), a = e ?? P;
+	return R(a, i)(async () => {
+		let t = r(await B(e, i));
+		if (L(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 U = (e) => `the ${e} could not be saved, so it lasts only until the app or server restarts`, ne = 6e4;
+function W() {
+	let e = /* @__PURE__ */ new Map();
+	return { claim: (t) => {
+		let n = Date.now();
+		for (let [t, r] of e) n - r.at > ne && 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 G({ 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 re = W(), ie = (e, { slide: t, totalSlides: n, title: r, imagePrompt: i }) => JSON.stringify([
+	e,
+	t,
+	n,
+	r,
+	i
+]), K = {
+	presentation: null,
+	steps: null
+}, q = null;
+function J(e) {
+	let t = K[e.mode], n = t?.totalSlides === e.totalSlides && (e.slide !== 1 || t.firstTitle === e.title);
+	if (t && n) return t;
+	let r = {
+		id: O(),
+		mode: e.mode,
+		totalSlides: e.totalSlides,
+		firstTitle: e.slide === 1 ? e.title : "",
+		slides: /* @__PURE__ */ new Map(),
+		current: 0,
+		shownAt: -Infinity
+	};
+	return K[e.mode] = r, r;
+}
+function Y(e, t, n) {
+	e.current = t.slide, e.shownAt = Date.now(), q = e;
+	let r = t.mode === "steps" ? "step" : "slide", { uuid: i, ...a } = n;
+	return {
+		...a,
+		message: `${r} ${t.slide} of ${t.totalSlides} is on the screen again, as it was`,
+		instructions: m(t),
+		instructionsRequired: !0,
+		sequence: G(t)
+	};
+}
+function ae(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 oe(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 = ae(n, a.length > 0), s = await j(e, o, a), { imageData: c, imagePath: l } = E(s);
+	if (!c) return {
+		...s,
+		sequence: null
+	};
+	let u = t.id, d = await H(e.files?.artifacts, M, u, (e) => {
+		let t = e ?? {
+			id: u,
+			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,
+			...l && { imagePath: l }
+		}, t;
+	}), f = {
+		imageData: c,
+		...l && { imagePath: l },
+		prompt: o,
+		slideshowId: u,
+		slide: n.slide,
+		totalSlides: n.totalSlides,
+		title: n.title,
+		mode: n.mode
+	}, p = n.mode === "steps" ? "step" : "slide";
+	return {
+		data: f,
+		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 ? "" : U("slideshow")
+		].filter(Boolean).join("; "),
+		instructions: m(n),
+		instructionsRequired: !0,
+		sequence: G(n)
+	};
+}
+async function X(e, t) {
+	let n = p(t);
+	if (!n) return {
+		message: f,
+		sequence: null
+	};
+	let r = J(n), i = n.mode === "steps";
+	if (i && n.slide > r.current && r.current > 0 && !D(e, r.shownAt)) {
+		console.info(`[sequence] holding step ${n.slide} for the user`);
+		let e = r.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 ${r.current} ${e}. Wait for them before calling presentSlide for step ${n.slide}.`,
+			cancelled: !0
+		};
+	}
+	let a = i ? r.slides.get(n.slide) : void 0;
+	if (a) return te(e.currentResult, a) ? {
+		message: `step ${n.slide} of ${n.totalSlides} is already on the screen`,
+		cancelled: !0
+	} : Y(r, n, a);
+	let o = re.claim(ie(r.id, n));
+	if ("earlier" in o) {
+		if (!await o.earlier) return X(e, t);
+		let i = r.slides.get(n.slide);
+		return i && q !== r ? Y(r, n, i) : {
+			message: `slide ${n.slide} of ${n.totalSlides} is already on the screen`,
+			cancelled: !0
+		};
+	}
+	let { settle: s } = o, c = {
+		current: r.current,
+		shownAt: r.shownAt
+	};
+	r.current = n.slide, r.shownAt = Infinity;
+	let l = !1;
+	try {
+		let t = await oe(e, r, n);
+		return l = !!E(t).imageData, l && (r.slides.set(n.slide, t), r.current = n.slide, r.shownAt = Date.now(), q = r), t;
+	} finally {
+		s(l), !l && r.current === n.slide && (r.current = c.current, r.shownAt = c.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 }
+}), Z = (e, t) => e ? `${e}. ${t}` : t, le = (e, { name: t, description: n }) => Z(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 ue(e, t) {
+	let n = _(t);
+	if (typeof n == "string") return {
+		message: n,
+		sequence: null
+	};
+	let r = await Promise.all(n.characters.map((t) => j(e, le(n.style, t)))), i = r.map(E), 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(),
+		...n,
+		characters: n.characters.map((e, t) => {
+			let n = i[t]?.imagePath;
+			return {
+				...e,
+				...n && { imagePath: n }
+			};
+		}),
+		panels: {}
+	}, s = await H(e.files?.artifacts, N, 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 ? "" : U("storyboard")
+		].filter(Boolean).join("; "),
+		instructions: v(o),
+		instructionsRequired: !0,
+		sequence: se(o)
+	};
+}
+function de(e, t, n) {
+	let r = [Z(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 fe(e, t, n) {
+	let r = [], i = [];
+	for (let a of n.characters) {
+		let n = t.characters.find((e) => u(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]) : [];
+			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 j(e, o, a), { imageData: c, imagePath: l } = E(s);
+	if (!c) return {
+		...s,
+		sequence: null
+	};
+	let d = n.panel < t.totalPanels && n.choices.length >= 2 ? n.choices : [], f = await H(e.files?.artifacts, N, t.id, (e) => {
+		let r = e ?? t;
+		return d.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 }
+		}, r;
+	});
+	return {
+		data: {
+			imageData: c,
+			...l && { imagePath: l },
+			prompt: o,
+			storyboardId: t.id,
+			panel: n.panel,
+			totalPanels: t.totalPanels,
+			caption: n.caption,
+			...d.length && { choices: d }
+		},
+		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 ? "" : U("storyboard")
+		].filter(Boolean).join("; "),
+		instructions: x(t, n.panel, d),
+		instructionsRequired: !0,
+		sequence: ce(t, n.panel, d)
+	};
+}
+var pe = W(), Q = /* @__PURE__ */ new Map();
+async function $(e, t) {
+	let n = b(t);
+	if (!n) return {
+		message: y,
+		sequence: null
+	};
+	let { storyboardId: r, panel: i } = n, a = Q.get(r);
+	if (a && i > a.panel && !D(e, a.shownAt)) return console.info(`[sequence] holding panel ${i} for the user`), {
+		message: a.shownAt === Infinity ? `panel ${i} was not shown: panel ${a.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 ${a.panel} is still on the screen. Wait for their answer.`,
+		cancelled: !0
+	};
+	let o = pe.claim(JSON.stringify(n));
+	if ("earlier" in o) return await o.earlier ? {
+		message: `panel ${i} is already on the screen`,
+		cancelled: !0
+	} : $(e, t);
+	let { settle: s } = o, c = {
+		panel: i,
+		shownAt: Infinity
+	}, l = Q.get(r);
+	Q.set(r, c);
+	let u = () => Q.get(r) === c, d = !1;
+	try {
+		let t = await V(e.files?.artifacts, N, 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 fe(e, t, n);
+		d = !!E(a).imageData;
+		let o = a.data;
+		return d && u() && (o?.choices?.length ? Q.set(r, {
+			panel: i,
+			shownAt: Date.now()
+		}) : Q.delete(r)), a;
+	} finally {
+		s(d), !d && u() && (l ? Q.set(r, l) : Q.delete(r));
+	}
+}
+//#endregion
+//#region src/core/index.ts
+var me = {
+	toolDefinition: g,
+	generatingMessage: "Making the slide...",
+	isEnabled: () => !0,
+	execute: (e, t) => X(e, t)
+}, he = {
+	toolDefinition: C,
+	generatingMessage: "Drawing the characters...",
+	isEnabled: () => !0,
+	execute: (e, t) => ue(e, t)
+}, ge = {
+	toolDefinition: w,
+	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 _, N as a, S as b, C as c, a as d, y as f, g, t as h, M as i, i as l, w as m, ge as n, V as o, r as p, me as r, n as s, he as t, o as u, s as v, p as w, v as x, f as y };

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./core-55UuKHJb.cjs");exports.DEFINE_STORYBOARD=e.s,exports.DEFINE_STORYBOARD_DEFINITION=e.c,exports.MAX_CHARACTERS=e.l,exports.MAX_CHOICES=e.u,exports.MAX_PANELS=e.d,exports.PANEL_ARGS_ERROR=e.f,exports.PRESENT_PANEL=e.p,exports.PRESENT_PANEL_DEFINITION=e.m,exports.PRESENT_SLIDE=e.h,exports.PRESENT_SLIDE_DEFINITION=e.g,exports.PRESENT_SLIDE_PROMPT=e._,exports.SEQUENCE_ID=e.v,exports.SLIDESHOWS_DIR=e.i,exports.SLIDE_ARGS_ERROR=e.y,exports.STORYBOARDS_DIR=e.a,exports.STORYBOARD_PROMPT=e.b,exports.castShownInstructions=e.x,exports.defineStoryboardPluginCore=e.t,exports.loadRecord=e.o,exports.panelShownInstructions=e.S,exports.parsePanelArgs=e.C,exports.parseSlideArgs=e.w,exports.parseStoryboardArgs=e.T,exports.presentPanelPluginCore=e.n,exports.presentSlidePluginCore=e.r,exports.sameName=e.E,exports.slideShownInstructions=e.D;

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from "./core/index";

package/dist/index.js

@@ -0,0 +1,2 @@
+import { C as e, D as t, E as n, S as r, T as i, _ as a, a as o, b as s, c, d as l, f as u, g as d, h as f, i as p, l as m, m as h, n as g, o as _, p as v, r as y, s as b, t as x, u as S, v as C, w, x as T, y as E } from "./core-D0F2WGN6.js";
+export { b as DEFINE_STORYBOARD, c as DEFINE_STORYBOARD_DEFINITION, m as MAX_CHARACTERS, S as MAX_CHOICES, l as MAX_PANELS, u as PANEL_ARGS_ERROR, v as PRESENT_PANEL, h as PRESENT_PANEL_DEFINITION, f as PRESENT_SLIDE, d as PRESENT_SLIDE_DEFINITION, a as PRESENT_SLIDE_PROMPT, C as SEQUENCE_ID, p as SLIDESHOWS_DIR, E as SLIDE_ARGS_ERROR, o as STORYBOARDS_DIR, s as STORYBOARD_PROMPT, T as castShownInstructions, x as defineStoryboardPluginCore, _ as loadRecord, r as panelShownInstructions, e as parsePanelArgs, w as parseSlideArgs, i as parseStoryboardArgs, g as presentPanelPluginCore, y as presentSlidePluginCore, n as sameName, t as slideShownInstructions };

package/dist/style.css

@@ -0,0 +1,3 @@
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-font-weight:initial}}}@layer theme{:root,:host{--font-sans:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--color-indigo-600:oklch(51.1% .262 276.966);--color-gray-800:oklch(27.8% .033 256.848);--color-white:#fff;--spacing:.25rem;--text-lg:1.125rem;--text-lg--line-height:calc(1.75 / 1.125);--text-xl:1.25rem;--text-xl--line-height:calc(1.75 / 1.25);--font-weight-medium:500;--font-weight-semibold:600;--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring:where(:not(iframe)){outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.mt-1{margin-top:var(--spacing)}.mb-3{margin-bottom:calc(var(--spacing) * 3)}.flex{display:flex}.grid{display:grid}.h-full{height:100%}.max-h-full{max-height:100%}.min-h-0{min-height:0}.w-full{width:100%}.max-w-full{max-width:100%}.flex-1{flex:1}.auto-rows-fr{grid-auto-rows:minmax(0,1fr)}.grid-cols-1{grid-template-columns:repeat(1,minmax(0,1fr))}.grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-center{justify-content:center}.gap-2{gap:calc(var(--spacing) * 2)}.gap-3{gap:calc(var(--spacing) * 3)}.rounded-full{border-radius:2147483647px}.bg-indigo-600{background-color:var(--color-indigo-600)}.bg-white{background-color:var(--color-white)}.object-contain{object-fit:contain}.p-2{padding:calc(var(--spacing) * 2)}.p-4{padding:calc(var(--spacing) * 4)}.px-4{padding-inline:calc(var(--spacing) * 4)}.px-5{padding-inline:calc(var(--spacing) * 5)}.py-2{padding-block:calc(var(--spacing) * 2)}.pb-2{padding-bottom:calc(var(--spacing) * 2)}.text-center{text-align:center}.text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}.text-xl{font-size:var(--text-xl);line-height:var(--tw-leading,var(--text-xl--line-height))}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.text-gray-800{color:var(--color-gray-800)}.text-white{color:var(--color-white)}}@property --tw-font-weight{syntax:"*";inherits:false}
+/*$vite$:1*/

package/dist/vue/index.d.ts

@@ -0,0 +1,9 @@
+import "../style.css";
+import type { ToolPlugin } from "gui-chat-protocol/vue";
+type SequencePlugin = ToolPlugin<unknown, unknown, Record<string, unknown>>;
+export declare const presentSlidePlugin: SequencePlugin;
+export declare const defineStoryboardPlugin: SequencePlugin;
+export declare const presentPanelPlugin: SequencePlugin;
+/** All three, as a host registers them. */
+export declare const plugins: SequencePlugin[];
+export * from "../core/index";

package/dist/vue.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./core-55UuKHJb.cjs");let t=require("vue"),n=require("@mulmochat-plugin/ui-image");function r({caption:e,choices:n}){let r=[];return e&&r.push((0,t.h)(`p`,{class:`text-center text-lg text-gray-800 px-4`},e)),n?.length&&r.push((0,t.h)(`ol`,{class:`flex flex-wrap justify-center gap-3 px-4`},n.map((e,n)=>(0,t.h)(`li`,{class:`rounded-full bg-indigo-600 text-white text-xl px-5 py-2 font-medium`},`${n+1}. ${e}`)))),r.length?(0,t.h)(`div`,{class:`flex flex-col gap-2 pb-2`},r):null}function i(e,n=()=>({})){return(0,t.markRaw)((0,t.defineComponent)({name:e,props:{selectedResult:{type:Object,required:!0}},setup(e){return()=>{let i=e.selectedResult.data;return i?.imageData?(0,t.h)(`div`,{class:`h-full w-full flex flex-col bg-white p-2 gap-2`},[(0,t.h)(`div`,{class:`flex-1 min-h-0 flex items-center justify-center`},[(0,t.h)(`img`,{src:i.imageData,alt:i.prompt??``,class:`max-w-full max-h-full object-contain`})]),r(n(i))]):(0,t.h)(`div`,{class:`h-full bg-white`})}}}))}function a(e){return(0,t.markRaw)((0,t.defineComponent)({name:e,props:{result:{type:Object,required:!0}},setup(e){return()=>(0,t.h)(n.ImagePreview,{result:e.result})}}))}var o=(0,t.markRaw)((0,t.defineComponent)({name:`StoryboardCastView`,props:{selectedResult:{type:Object,required:!0}},setup(e){return()=>{let n=e.selectedResult.data,r=n?.characters??[];return(0,t.h)(`div`,{class:`h-full w-full flex flex-col bg-white p-4`},[(0,t.h)(`h2`,{class:`text-center text-xl font-semibold text-gray-800 mb-3`},n?.title??``),(0,t.h)(`div`,{class:`flex-1 min-h-0 grid gap-3 ${r.length>1?`grid-cols-2`:`grid-cols-1`} auto-rows-fr`},r.map(e=>(0,t.h)(`figure`,{class:`min-h-0 flex flex-col items-center`},[e.imageData?(0,t.h)(`img`,{src:e.imageData,alt:e.name,class:`flex-1 min-h-0 max-w-full object-contain`}):(0,t.h)(`div`,{class:`flex-1`}),(0,t.h)(`figcaption`,{class:`text-lg text-gray-800 mt-1`},e.name)])))])}}})),s=e=>Array.isArray(e)?e.filter(e=>typeof e==`string`):[],c={...e.r,viewComponent:i(`PresentSlideView`),previewComponent:a(`PresentSlidePreview`)},l={...e.t,viewComponent:o,previewComponent:a(`StoryboardCastPreview`)},u={...e.n,viewComponent:i(`PresentPanelView`,e=>({caption:typeof e.caption==`string`?e.caption:``,choices:s(e.choices)})),previewComponent:a(`PresentPanelPreview`)},d=[c,l,u];exports.DEFINE_STORYBOARD=e.s,exports.DEFINE_STORYBOARD_DEFINITION=e.c,exports.MAX_CHARACTERS=e.l,exports.MAX_CHOICES=e.u,exports.MAX_PANELS=e.d,exports.PANEL_ARGS_ERROR=e.f,exports.PRESENT_PANEL=e.p,exports.PRESENT_PANEL_DEFINITION=e.m,exports.PRESENT_SLIDE=e.h,exports.PRESENT_SLIDE_DEFINITION=e.g,exports.PRESENT_SLIDE_PROMPT=e._,exports.SEQUENCE_ID=e.v,exports.SLIDESHOWS_DIR=e.i,exports.SLIDE_ARGS_ERROR=e.y,exports.STORYBOARDS_DIR=e.a,exports.STORYBOARD_PROMPT=e.b,exports.castShownInstructions=e.x,exports.defineStoryboardPlugin=l,exports.defineStoryboardPluginCore=e.t,exports.loadRecord=e.o,exports.panelShownInstructions=e.S,exports.parsePanelArgs=e.C,exports.parseSlideArgs=e.w,exports.parseStoryboardArgs=e.T,exports.plugins=d,exports.presentPanelPlugin=u,exports.presentPanelPluginCore=e.n,exports.presentSlidePlugin=c,exports.presentSlidePluginCore=e.r,exports.sameName=e.E,exports.slideShownInstructions=e.D;

package/dist/vue.js

@@ -0,0 +1,77 @@
+import { C as e, D as t, E as n, S as r, T as i, _ as a, a as o, b as s, c, d as l, f as u, g as d, h as f, i as p, l as m, m as h, n as g, o as _, p as v, r as y, s as b, t as x, u as S, v as C, w, x as T, y as E } from "./core-D0F2WGN6.js";
+import { defineComponent as D, h as O, markRaw as k } from "vue";
+import { ImagePreview as A } from "@mulmochat-plugin/ui-image";
+//#region src/vue/index.ts
+function j({ caption: e, choices: t }) {
+	let n = [];
+	return e && n.push(O("p", { class: "text-center text-lg text-gray-800 px-4" }, e)), t?.length && n.push(O("ol", { class: "flex flex-wrap justify-center gap-3 px-4" }, t.map((e, t) => O("li", { class: "rounded-full bg-indigo-600 text-white text-xl px-5 py-2 font-medium" }, `${t + 1}. ${e}`)))), n.length ? O("div", { class: "flex flex-col gap-2 pb-2" }, n) : null;
+}
+function M(e, t = () => ({})) {
+	return k(D({
+		name: e,
+		props: { selectedResult: {
+			type: Object,
+			required: !0
+		} },
+		setup(e) {
+			return () => {
+				let n = e.selectedResult.data;
+				return n?.imageData ? O("div", { class: "h-full w-full flex flex-col bg-white p-2 gap-2" }, [O("div", { class: "flex-1 min-h-0 flex items-center justify-center" }, [O("img", {
+					src: n.imageData,
+					alt: n.prompt ?? "",
+					class: "max-w-full max-h-full object-contain"
+				})]), j(t(n))]) : O("div", { class: "h-full bg-white" });
+			};
+		}
+	}));
+}
+function N(e) {
+	return k(D({
+		name: e,
+		props: { result: {
+			type: Object,
+			required: !0
+		} },
+		setup(e) {
+			return () => O(A, { result: e.result });
+		}
+	}));
+}
+var P = k(D({
+	name: "StoryboardCastView",
+	props: { selectedResult: {
+		type: Object,
+		required: !0
+	} },
+	setup(e) {
+		return () => {
+			let t = e.selectedResult.data, n = t?.characters ?? [];
+			return O("div", { class: "h-full w-full flex flex-col bg-white p-4" }, [O("h2", { class: "text-center text-xl font-semibold text-gray-800 mb-3" }, t?.title ?? ""), O("div", { class: `flex-1 min-h-0 grid gap-3 ${n.length > 1 ? "grid-cols-2" : "grid-cols-1"} auto-rows-fr` }, n.map((e) => O("figure", { class: "min-h-0 flex flex-col items-center" }, [e.imageData ? O("img", {
+				src: e.imageData,
+				alt: e.name,
+				class: "flex-1 min-h-0 max-w-full object-contain"
+			}) : O("div", { class: "flex-1" }), O("figcaption", { class: "text-lg text-gray-800 mt-1" }, e.name)])))]);
+		};
+	}
+})), F = (e) => Array.isArray(e) ? e.filter((e) => typeof e == "string") : [], I = {
+	...y,
+	viewComponent: M("PresentSlideView"),
+	previewComponent: N("PresentSlidePreview")
+}, L = {
+	...x,
+	viewComponent: P,
+	previewComponent: N("StoryboardCastPreview")
+}, R = {
+	...g,
+	viewComponent: M("PresentPanelView", (e) => ({
+		caption: typeof e.caption == "string" ? e.caption : "",
+		choices: F(e.choices)
+	})),
+	previewComponent: N("PresentPanelPreview")
+}, z = [
+	I,
+	L,
+	R
+];
+//#endregion
+export { b as DEFINE_STORYBOARD, c as DEFINE_STORYBOARD_DEFINITION, m as MAX_CHARACTERS, S as MAX_CHOICES, l as MAX_PANELS, u as PANEL_ARGS_ERROR, v as PRESENT_PANEL, h as PRESENT_PANEL_DEFINITION, f as PRESENT_SLIDE, d as PRESENT_SLIDE_DEFINITION, a as PRESENT_SLIDE_PROMPT, C as SEQUENCE_ID, p as SLIDESHOWS_DIR, E as SLIDE_ARGS_ERROR, o as STORYBOARDS_DIR, s as STORYBOARD_PROMPT, T as castShownInstructions, L as defineStoryboardPlugin, x as defineStoryboardPluginCore, _ as loadRecord, r as panelShownInstructions, e as parsePanelArgs, w as parseSlideArgs, i as parseStoryboardArgs, z as plugins, R as presentPanelPlugin, g as presentPanelPluginCore, I as presentSlidePlugin, y as presentSlidePluginCore, n as sameName, t as slideShownInstructions };

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@gui-chat-plugin/sequence",
+  "version": "0.1.0",
+  "description": "Slideshows, step-by-step guides and stories told in pictures (presentSlide, defineStoryboard, presentPanel) for GUI Chat Protocol hosts",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./vue": {
+      "types": "./dist/vue/index.d.ts",
+      "import": "./dist/vue.js",
+      "require": "./dist/vue.cjs"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test test/test_*.ts"
+  },
+  "peerDependencies": {
+    "@mulmochat-plugin/ui-image": "^0.4.1",
+    "gui-chat-protocol": "^2.1.0",
+    "vue": "^3.5.0"
+  },
+  "devDependencies": {
+    "@mulmochat-plugin/ui-image": "^0.4.1",
+    "gui-chat-protocol": "^2.1.0",
+    "vue": "^3.5.43"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/receptron/gui-chat-plugins/tree/main/packages/sequence#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/receptron/gui-chat-plugins.git",
+    "directory": "packages/sequence"
+  },
+  "keywords": [
+    "gui-chat",
+    "gui-chat-protocol",
+    "plugin",
+    "slideshow",
+    "storyboard"
+  ]
+}