@thijshakkenberg/valkyrie-mom-mcp 2.1.0 → 2.2.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "valkyrie-mom",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "AI-assisted Mansions of Madness scenario editor for Valkyrie",
   "author": {
     "name": "Thijs Hakkenberg"

package/README.md

@@ -8,7 +8,7 @@ MCP (Model Context Protocol) server and Claude Code plugin for AI-assisted Mansi
 
 This server exposes Valkyrie scenario editing as MCP tools, enabling AI assistants (Claude, etc.) to create, modify, validate, and build complete MoM scenarios. It auto-detects the Valkyrie editor directory so scenarios appear directly in the app.
 
-The plugin bundles 7 skills covering advanced patterns (event loops, mythos scaling, tile placement chains, custom puzzles, etc.) and an autonomous scenario designer agent.
+The plugin bundles 8 skills covering advanced patterns (event loops, mythos scaling, tile placement chains, custom puzzles, generated artwork, etc.) and an autonomous scenario designer agent.
 
 ## Install
 
@@ -21,7 +21,7 @@ claude plugin install valkyrie-mom
 
 This gives you:
 - **MCP server** with 25 tools for scenario editing (auto-started)
-- **7 skills**: `/scenario`, `/event-patterns`, `/tile-placement`, `/variables-and-mythos`, `/custom-monsters`, `/ui-and-puzzles`, `/items-and-distribution`
+- **8 skills**: `/scenario`, `/event-patterns`, `/tile-placement`, `/variables-and-mythos`, `/custom-monsters`, `/ui-and-puzzles`, `/items-and-distribution`, `/artwork`
 - **Scenario designer agent** for autonomous scenario creation
 - **5 MCP resources** for format documentation
 
@@ -73,6 +73,7 @@ npx tsx src/index.ts   # Run MCP server via stdio
 | `/custom-monsters` | Custom activations, evade/horror events, round-based spawn triggering |
 | `/ui-and-puzzles` | Prologues, interactive journals, combination locks, built-in puzzle types |
 | `/items-and-distribution` | Random items, unique items, starting items, inspection events |
+| `/artwork` | Generate pictures with a local ComfyUI (FLUX.2 [klein] 4B) and show them: cover, intro cutscene, handouts, scenes, monsters, tokens, image puzzles |
 
 ## MCP Tools
 
@@ -84,7 +85,8 @@ npx tsx src/index.ts   # Run MCP server via stdio
 | `load_scenario` | Load an existing scenario from a directory |
 | `get_scenario_state` | Get current scenario component/localization summary |
 | `validate_scenario` | Run all validation rules |
-| `build_scenario` | Save and build `.valkyrie` package |
+| `save_scenario` | Write the scenario to its folder (edits stay in memory until saved or built) |
+| `build_scenario` | Save and build the `.valkyrie` package with Valkyrie's manifest `.ini` and cover image (default: `Desktop/<Package>/`, like Valkyrie's Create Package) |
 | `set_quest_config` | Set difficulty, play time, investigator count, cover image |
 
 ### Components
@@ -111,6 +113,24 @@ npx tsx src/index.ts   # Run MCP server via stdio
 | `suggest_tile_layout` | Suggest coordinates for large (7x7) tiles in linear, L-shape, or hub-spoke layouts |
 | `place_tile_relative` | Position and rotation for a new tile against an existing one, with a door lined up |
 
+### Artwork
+| Tool | Description |
+|------|-------------|
+| `artwork_status` | Check a local ComfyUI server and the FLUX.2 [klein] 4B model files; prints comfy-cli setup and download commands for anything missing |
+| `generate_artwork` | Generate an image (4 steps, CFG 1, size presets per use) and save it into the scenario folder, with a preview |
+
+Artwork is optional and runs entirely on your machine. Setup with [comfy-cli](https://github.com/Comfy-Org/comfy-cli):
+
+```bash
+pip install comfy-cli && comfy install
+comfy model download --url https://huggingface.co/Comfy-Org/flux2-klein-4B/resolve/main/split_files/diffusion_models/flux-2-klein-4b.safetensors --relative-path models/diffusion_models
+comfy model download --url https://huggingface.co/Comfy-Org/flux2-klein-4B/resolve/main/split_files/text_encoders/qwen_3_4b.safetensors --relative-path models/text_encoders
+comfy model download --url https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/vae/flux2-vae.safetensors --relative-path models/vae
+comfy launch --background
+```
+
+On NVIDIA GPUs with less VRAM, the fp8 model (`black-forest-labs/FLUX.2-klein-4b-fp8`) is smaller. Set `VALKYRIE_COMFYUI_URL` if ComfyUI runs somewhere other than `http://127.0.0.1:8188`. The `/artwork` skill covers prompts and where Valkyrie shows images.
+
 ### Reference
 | Tool | Description |
 |------|-------------|
@@ -201,7 +221,7 @@ npm run build      # Compile to dist/
 
 ```
 .claude-plugin/    Plugin manifest
-skills/            7 skill SKILL.md files
+skills/            8 skill SKILL.md files
 agents/            Scenario designer agent
 src/
   io/              INI parser/writer, localization CSV, ZIP packager

package/agents/scenario-designer.md

@@ -27,6 +27,7 @@ skills:
   - custom-monsters
   - ui-and-puzzles
   - items-and-distribution
+  - artwork
 ---
 
 # Scenario Designer Agent
@@ -40,6 +41,7 @@ You are an autonomous Mansions of Madness 2nd Edition scenario designer. You cre
 - Place tokens for exploration, searches, and encounters
 - Configure monster spawns with appropriate difficulty scaling
 - Build custom puzzles and UI overlays
+- Generate scenario artwork (cover, intro, handouts) when a local ComfyUI is available (`artwork_status`)
 - Set up mythos scaling for tension progression
 - Write atmospheric narrative text in the Lovecraftian horror style
 - Validate scenarios for correctness and completeness
@@ -54,6 +56,7 @@ Use these skills for detailed pattern guidance:
 - `/custom-monsters` — Custom activations, evade/horror events, spawn triggering
 - `/ui-and-puzzles` — Prologues, interactive journals, combination locks, built-in puzzles
 - `/items-and-distribution` — Random items, unique items, starting items, inspection events
+- `/artwork` — Generate pictures with ComfyUI (FLUX.2 [klein]) and show them: cover, intro cutscene, handouts, scenes, monsters, tokens, image puzzles
 
 ## Design Principles
 
@@ -93,7 +96,8 @@ Use these skills for detailed pattern guidance:
 - Use `{rnd:hero}` for random hero selection, `{c:EventName}` for recall
 
 ### UI & Puzzles
-- Always use `vunits=True` for resolution independence
+- Always use `vunits=True` for resolution independence; positions are offsets from the screen centre
+- A puzzle is an event started from a button (`event1=PuzzleX`); tell its story in the event before it
 - Layering order matters: background first, buttons LAST
 - Clean up all UI elements when dismissing overlays
 
@@ -109,7 +113,8 @@ Use these skills for detailed pattern guidance:
 8. Configure items with `upsert_item`
 9. Write all narrative with `set_localization`
 10. Validate with `validate_scenario`
-11. Build with `build_scenario`
+11. Save with `save_scenario` (edits stay in memory until saved or built)
+12. Build with `build_scenario`
 
 ## Available MCP Tools
 

package/dist/artwork/comfyui.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Scenario artwork through a local ComfyUI server running FLUX.2 [klein] 4B.
+ * The workflow is ComfyUI's API format; the settings are the ones the distilled
+ * model is built for (4 steps, CFG 1, euler), which take ~25 s per image on an M1 Pro
+ * once the model is loaded (the first image also loads ~15 GB of weights).
+ */
+export declare const DEFAULT_COMFYUI_URL: string;
+/** Image sizes per use in a scenario (width x height, multiples of 16) */
+export declare const ARTWORK_PRESETS: {
+    /** Scenario list picture (quest.ini image=) and the intro cutscene's left panel */
+    readonly cover: {
+        readonly width: 896;
+        readonly height: 896;
+    };
+    readonly intro: {
+        readonly width: 896;
+        readonly height: 896;
+    };
+    /** Letters, parchments, photographs, journal pages: portrait handouts shown during play */
+    readonly handout: {
+        readonly width: 768;
+        readonly height: 1024;
+    };
+    /** Landscape pictures shown during play (a room, a revelation, the ending) */
+    readonly scene: {
+        readonly width: 1024;
+        readonly height: 768;
+    };
+    /** Custom monster portrait (CustomMonster image=) */
+    readonly monster: {
+        readonly width: 768;
+        readonly height: 768;
+    };
+    /** Board token artwork (Token customImage=) */
+    readonly token: {
+        readonly width: 512;
+        readonly height: 512;
+    };
+};
+export type ArtworkPreset = keyof typeof ARTWORK_PRESETS;
+/** Appended to every prompt unless a style is given, so a scenario's pictures look like one set */
+export declare const DEFAULT_STYLE: string;
+/** The three files of the FLUX.2 [klein] 4B setup and where to get them */
+export declare const FLUX2_KLEIN_MODELS: {
+    readonly diffusion: {
+        readonly folder: "diffusion_models";
+        readonly match: RegExp;
+        readonly downloads: readonly [{
+            readonly file: "flux-2-klein-4b.safetensors";
+            readonly note: "bf16, 7.2 GB; use this on Apple Silicon (MPS has no fp8)";
+            readonly url: "https://huggingface.co/Comfy-Org/flux2-klein-4B/resolve/main/split_files/diffusion_models/flux-2-klein-4b.safetensors";
+        }, {
+            readonly file: "flux-2-klein-4b-fp8.safetensors";
+            readonly note: "fp8, ~4 GB; for NVIDIA GPUs with less VRAM";
+            readonly url: "https://huggingface.co/black-forest-labs/FLUX.2-klein-4b-fp8/resolve/main/flux-2-klein-4b-fp8.safetensors";
+        }];
+    };
+    readonly textEncoder: {
+        readonly folder: "text_encoders";
+        readonly match: RegExp;
+        readonly downloads: readonly [{
+            readonly file: "qwen_3_4b.safetensors";
+            readonly note: "7.5 GB";
+            readonly url: "https://huggingface.co/Comfy-Org/flux2-klein-4B/resolve/main/split_files/text_encoders/qwen_3_4b.safetensors";
+        }];
+    };
+    readonly vae: {
+        readonly folder: "vae";
+        readonly match: RegExp;
+        readonly downloads: readonly [{
+            readonly file: "flux2-vae.safetensors";
+            readonly note: "321 MB; FLUX.1 and SDXL VAEs give distorted colours";
+            readonly url: "https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/vae/flux2-vae.safetensors";
+        }];
+    };
+};
+export interface Flux2KleinSettings {
+    diffusionModel: string;
+    textEncoder: string;
+    vae: string;
+    prompt: string;
+    width: number;
+    height: number;
+    seed: number;
+    steps: number;
+    cfg: number;
+    filenamePrefix: string;
+}
+/** Recommended sampling for the distilled model; the undistilled "base" model needs more steps and real CFG */
+export declare function recommendedSampling(diffusionModel: string): {
+    steps: number;
+    cfg: number;
+};
+/** ComfyUI API-format workflow: FLUX.2 [klein] text-to-image */
+export declare function buildFlux2KleinWorkflow(s: Flux2KleinSettings): Record<string, unknown>;
+type Fetch = typeof fetch;
+export interface ArtworkStatus {
+    reachable: boolean;
+    url: string;
+    error?: string;
+    comfyuiVersion?: string;
+    device?: string;
+    models: {
+        diffusion?: string;
+        textEncoder?: string;
+        vae?: string;
+    };
+    missing: Array<keyof typeof FLUX2_KLEIN_MODELS>;
+}
+/** Checks the ComfyUI server and which of the FLUX.2 [klein] files it can load */
+export declare function getArtworkStatus(url?: string, fetchFn?: Fetch): Promise<ArtworkStatus>;
+/** Human-readable setup instructions for what getArtworkStatus found missing */
+export declare function setupInstructions(status: ArtworkStatus): string;
+export interface GenerateArtworkOptions {
+    prompt: string;
+    /** Where to save the image; .jpg/.jpeg saves a JPEG (much smaller in the package), otherwise PNG */
+    outputFile: string;
+    preset?: ArtworkPreset;
+    width?: number;
+    height?: number;
+    seed?: number;
+    steps?: number;
+    cfg?: number;
+    /** Replaces DEFAULT_STYLE; pass '' for no style suffix */
+    style?: string;
+    url?: string;
+    timeoutMs?: number;
+    pollMs?: number;
+    fetchFn?: Fetch;
+}
+export interface GenerateArtworkResult {
+    file: string;
+    width: number;
+    height: number;
+    seed: number;
+    steps: number;
+    cfg: number;
+    diffusionModel: string;
+    seconds: number;
+    /** Compact JPEG of the result, for showing the image back to the caller */
+    preview: Buffer;
+}
+/** Generates one image with FLUX.2 [klein] on a running ComfyUI and saves it to outputFile */
+export declare function generateArtwork(opts: GenerateArtworkOptions): Promise<GenerateArtworkResult>;
+export {};
+//# sourceMappingURL=comfyui.d.ts.map

package/dist/artwork/comfyui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comfyui.d.ts","sourceRoot":"","sources":["../../src/artwork/comfyui.ts"],"names":[],"mappings":"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"}

package/dist/artwork/comfyui.js

@@ -0,0 +1,214 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Scenario artwork through a local ComfyUI server running FLUX.2 [klein] 4B.
+ * The workflow is ComfyUI's API format; the settings are the ones the distilled
+ * model is built for (4 steps, CFG 1, euler), which take ~25 s per image on an M1 Pro
+ * once the model is loaded (the first image also loads ~15 GB of weights).
+ */
+export const DEFAULT_COMFYUI_URL = process.env.VALKYRIE_COMFYUI_URL ?? 'http://127.0.0.1:8188';
+/** Image sizes per use in a scenario (width x height, multiples of 16) */
+export const ARTWORK_PRESETS = {
+    /** Scenario list picture (quest.ini image=) and the intro cutscene's left panel */
+    cover: { width: 896, height: 896 },
+    intro: { width: 896, height: 896 },
+    /** Letters, parchments, photographs, journal pages: portrait handouts shown during play */
+    handout: { width: 768, height: 1024 },
+    /** Landscape pictures shown during play (a room, a revelation, the ending) */
+    scene: { width: 1024, height: 768 },
+    /** Custom monster portrait (CustomMonster image=) */
+    monster: { width: 768, height: 768 },
+    /** Board token artwork (Token customImage=) */
+    token: { width: 512, height: 512 },
+};
+/** Appended to every prompt unless a style is given, so a scenario's pictures look like one set */
+export const DEFAULT_STYLE = 'Dark painterly Lovecraftian horror illustration in the style of a 1920s Mansions of Madness board game card, '
+    + 'muted desaturated palette, deep shadows, eerie atmosphere, no text, no letters, no watermark.';
+/** The three files of the FLUX.2 [klein] 4B setup and where to get them */
+export const FLUX2_KLEIN_MODELS = {
+    diffusion: {
+        folder: 'diffusion_models',
+        match: /flux-?2-klein-4b/i,
+        downloads: [
+            { file: 'flux-2-klein-4b.safetensors', note: 'bf16, 7.2 GB; use this on Apple Silicon (MPS has no fp8)', url: 'https://huggingface.co/Comfy-Org/flux2-klein-4B/resolve/main/split_files/diffusion_models/flux-2-klein-4b.safetensors' },
+            { file: 'flux-2-klein-4b-fp8.safetensors', note: 'fp8, ~4 GB; for NVIDIA GPUs with less VRAM', url: 'https://huggingface.co/black-forest-labs/FLUX.2-klein-4b-fp8/resolve/main/flux-2-klein-4b-fp8.safetensors' },
+        ],
+    },
+    textEncoder: {
+        folder: 'text_encoders',
+        match: /qwen_?3_?4b/i,
+        downloads: [
+            { file: 'qwen_3_4b.safetensors', note: '7.5 GB', url: 'https://huggingface.co/Comfy-Org/flux2-klein-4B/resolve/main/split_files/text_encoders/qwen_3_4b.safetensors' },
+        ],
+    },
+    vae: {
+        folder: 'vae',
+        match: /flux2-vae/i,
+        downloads: [
+            { file: 'flux2-vae.safetensors', note: '321 MB; FLUX.1 and SDXL VAEs give distorted colours', url: 'https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/vae/flux2-vae.safetensors' },
+        ],
+    },
+};
+/** Recommended sampling for the distilled model; the undistilled "base" model needs more steps and real CFG */
+export function recommendedSampling(diffusionModel) {
+    return /base/i.test(diffusionModel) ? { steps: 20, cfg: 4 } : { steps: 4, cfg: 1 };
+}
+/** ComfyUI API-format workflow: FLUX.2 [klein] text-to-image */
+export function buildFlux2KleinWorkflow(s) {
+    return {
+        '1': { class_type: 'UNETLoader', inputs: { unet_name: s.diffusionModel, weight_dtype: 'default' } },
+        '2': { class_type: 'CLIPLoader', inputs: { clip_name: s.textEncoder, type: 'flux2' } },
+        '3': { class_type: 'VAELoader', inputs: { vae_name: s.vae } },
+        '4': { class_type: 'CLIPTextEncode', inputs: { clip: ['2', 0], text: s.prompt } },
+        '5': { class_type: 'ConditioningZeroOut', inputs: { conditioning: ['4', 0] } },
+        '6': { class_type: 'EmptyFlux2LatentImage', inputs: { width: s.width, height: s.height, batch_size: 1 } },
+        '7': { class_type: 'Flux2Scheduler', inputs: { steps: s.steps, width: s.width, height: s.height } },
+        '8': { class_type: 'KSamplerSelect', inputs: { sampler_name: 'euler' } },
+        '9': { class_type: 'RandomNoise', inputs: { noise_seed: s.seed } },
+        '10': { class_type: 'CFGGuider', inputs: { model: ['1', 0], positive: ['4', 0], negative: ['5', 0], cfg: s.cfg } },
+        '11': { class_type: 'SamplerCustomAdvanced', inputs: { noise: ['9', 0], guider: ['10', 0], sampler: ['8', 0], sigmas: ['7', 0], latent_image: ['6', 0] } },
+        '12': { class_type: 'VAEDecode', inputs: { samples: ['11', 0], vae: ['3', 0] } },
+        '13': { class_type: 'SaveImage', inputs: { images: ['12', 0], filename_prefix: s.filenamePrefix } },
+    };
+}
+async function getJson(fetchFn, url) {
+    const res = await fetchFn(url, { signal: AbortSignal.timeout(10_000) });
+    if (!res.ok)
+        throw new Error(`${url} answered ${res.status}`);
+    return res.json();
+}
+/** Picks the preferred file: the distilled model over "base", then the first match */
+function pickModel(files, match) {
+    const candidates = files.filter(f => match.test(f));
+    return candidates.find(f => !/base/i.test(f)) ?? candidates[0];
+}
+/** Checks the ComfyUI server and which of the FLUX.2 [klein] files it can load */
+export async function getArtworkStatus(url = DEFAULT_COMFYUI_URL, fetchFn = fetch) {
+    const status = { reachable: false, url, models: {}, missing: [] };
+    try {
+        const stats = await getJson(fetchFn, `${url}/system_stats`);
+        status.reachable = true;
+        status.comfyuiVersion = stats.system?.comfyui_version;
+        status.device = stats.devices?.[0]?.name;
+    }
+    catch (e) {
+        status.error = e.message;
+        status.missing = ['diffusion', 'textEncoder', 'vae'];
+        return status;
+    }
+    for (const key of ['diffusion', 'textEncoder', 'vae']) {
+        const spec = FLUX2_KLEIN_MODELS[key];
+        let files = [];
+        try {
+            files = await getJson(fetchFn, `${url}/models/${spec.folder}`);
+        }
+        catch {
+            // Older ComfyUI without /models/<folder>: treat as missing so the setup hint is shown
+        }
+        const found = pickModel(files, spec.match);
+        if (found)
+            status.models[key] = found;
+        else
+            status.missing.push(key);
+    }
+    return status;
+}
+/** Human-readable setup instructions for what getArtworkStatus found missing */
+export function setupInstructions(status) {
+    const lines = [];
+    if (!status.reachable) {
+        lines.push(`ComfyUI is not reachable at ${status.url}${status.error ? ` (${status.error})` : ''}. With comfy-cli:`, '  pip install comfy-cli   (or: uv tool install comfy-cli)', '  comfy install           (once; installs ComfyUI into a workspace)', '  comfy launch --background', 'Models kept elsewhere: comfy launch --background -- --extra-model-paths-config <yaml listing diffusion_models, text_encoders, vae>.', 'Set VALKYRIE_COMFYUI_URL if ComfyUI runs on another address.');
+    }
+    for (const key of status.missing) {
+        const spec = FLUX2_KLEIN_MODELS[key];
+        lines.push(`Missing ${spec.folder} model. Download one of:`);
+        for (const d of spec.downloads) {
+            lines.push(`  ${d.file} (${d.note}):`, `    comfy model download --url ${d.url} --relative-path models/${spec.folder}`);
+        }
+    }
+    return lines.join('\n');
+}
+function roundTo16(n) {
+    return Math.max(256, Math.round(n / 16) * 16);
+}
+/** Generates one image with FLUX.2 [klein] on a running ComfyUI and saves it to outputFile */
+export async function generateArtwork(opts) {
+    const url = opts.url ?? DEFAULT_COMFYUI_URL;
+    const fetchFn = opts.fetchFn ?? fetch;
+    const status = await getArtworkStatus(url, fetchFn);
+    if (!status.reachable || status.missing.length > 0) {
+        throw new Error(`ComfyUI is not ready for FLUX.2 [klein].\n${setupInstructions(status)}`);
+    }
+    const diffusionModel = status.models.diffusion;
+    const size = ARTWORK_PRESETS[opts.preset ?? 'scene'];
+    const width = roundTo16(opts.width ?? size.width);
+    const height = roundTo16(opts.height ?? size.height);
+    const sampling = recommendedSampling(diffusionModel);
+    const style = opts.style ?? DEFAULT_STYLE;
+    const settings = {
+        diffusionModel,
+        textEncoder: status.models.textEncoder,
+        vae: status.models.vae,
+        prompt: style ? `${opts.prompt.trim()} ${style}` : opts.prompt.trim(),
+        width,
+        height,
+        seed: opts.seed ?? Math.floor(Math.random() * 2 ** 32),
+        steps: opts.steps ?? sampling.steps,
+        cfg: opts.cfg ?? sampling.cfg,
+        filenamePrefix: `valkyrie_${path.basename(opts.outputFile, path.extname(opts.outputFile)).replace(/[^\w-]/g, '_')}`,
+    };
+    const started = Date.now();
+    const submit = await fetchFn(`${url}/prompt`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ prompt: buildFlux2KleinWorkflow(settings) }),
+        signal: AbortSignal.timeout(30_000),
+    });
+    const submitted = await submit.json();
+    if (!submit.ok || !submitted.prompt_id) {
+        throw new Error(`ComfyUI rejected the workflow: ${submitted.error?.message ?? submit.status} ${JSON.stringify(submitted.node_errors ?? {})}`);
+    }
+    // The first image of a session also loads the models, which can take minutes
+    const timeoutMs = opts.timeoutMs ?? 15 * 60_000;
+    const pollMs = opts.pollMs ?? 2000;
+    let image;
+    while (!image) {
+        if (Date.now() - started > timeoutMs)
+            throw new Error(`ComfyUI did not finish within ${Math.round(timeoutMs / 1000)} s (prompt ${submitted.prompt_id})`);
+        await new Promise(r => setTimeout(r, pollMs));
+        const history = await getJson(fetchFn, `${url}/history/${submitted.prompt_id}`);
+        const entry = history[submitted.prompt_id];
+        if (!entry)
+            continue;
+        if (entry.status?.status_str === 'error') {
+            throw new Error(`ComfyUI failed: ${JSON.stringify(entry.status.messages ?? []).slice(0, 1000)}`);
+        }
+        image = Object.values(entry.outputs ?? {}).flatMap(o => o.images ?? [])[0];
+        if (!image && entry.status?.status_str === 'success')
+            throw new Error('ComfyUI finished without an image');
+    }
+    const view = (extra = '') => `${url}/view?filename=${encodeURIComponent(image.filename)}&subfolder=${encodeURIComponent(image.subfolder)}&type=${image.type}${extra}`;
+    const download = async (u) => {
+        const res = await fetchFn(u, { signal: AbortSignal.timeout(60_000) });
+        if (!res.ok)
+            throw new Error(`Could not download the image from ComfyUI (${res.status})`);
+        return Buffer.from(await res.arrayBuffer());
+    };
+    const jpeg = /\.jpe?g$/i.test(opts.outputFile);
+    const full = await download(view(jpeg ? '&preview=jpeg;90' : ''));
+    const preview = jpeg ? full : await download(view('&preview=jpeg;80'));
+    fs.mkdirSync(path.dirname(opts.outputFile), { recursive: true });
+    fs.writeFileSync(opts.outputFile, full);
+    return {
+        file: opts.outputFile,
+        width,
+        height,
+        seed: settings.seed,
+        steps: settings.steps,
+        cfg: settings.cfg,
+        diffusionModel,
+        seconds: Math.round((Date.now() - started) / 1000),
+        preview,
+    };
+}
+//# sourceMappingURL=comfyui.js.map

package/dist/artwork/comfyui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comfyui.js","sourceRoot":"","sources":["../../src/artwork/comfyui.ts"],"names":[],"mappings":"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"}

package/dist/io/package-manifest.d.ts

@@ -0,0 +1,18 @@
+import type { ScenarioModel } from '../model/scenario-model.js';
+/**
+ * Package name Valkyrie can publish: the scenario folder name, which must not contain spaces
+ * (it becomes the package and manifest file name, and the key in the download list).
+ * "The Wrath of Elder Claude" → "TheWrathOfElderClaude".
+ */
+export declare function toPackageName(name: string): string;
+/**
+ * Writes what Valkyrie's editor "Create Package" writes next to the .valkyrie file
+ * (EditorTools.CreatePackage): <Package>.ini, the manifest a scenario list entry is made from,
+ * and a copy of the cover image. version is the SHA-256 of the package, as .NET's
+ * BitConverter.ToString prints it ("AB-CD-...").
+ */
+export declare function writePackageManifest(model: ScenarioModel, packagePath: string): {
+    manifest: string;
+    icon?: string;
+};
+//# sourceMappingURL=package-manifest.d.ts.map

package/dist/io/package-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manifest.d.ts","sourceRoot":"","sources":["../../src/io/package-manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAoCnH"}

package/dist/io/package-manifest.js

@@ -0,0 +1,57 @@
+import { createHash } from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { serializeQuestConfig } from '../model/component-types.js';
+/**
+ * Package name Valkyrie can publish: the scenario folder name, which must not contain spaces
+ * (it becomes the package and manifest file name, and the key in the download list).
+ * "The Wrath of Elder Claude" → "TheWrathOfElderClaude".
+ */
+export function toPackageName(name) {
+    const words = name.normalize('NFKD').replace(/[̀-ͯ]/g, '').split(/[^A-Za-z0-9]+/).filter(Boolean);
+    return words.map(w => w[0].toUpperCase() + w.slice(1)).join('') || 'Scenario';
+}
+/**
+ * Writes what Valkyrie's editor "Create Package" writes next to the .valkyrie file
+ * (EditorTools.CreatePackage): <Package>.ini, the manifest a scenario list entry is made from,
+ * and a copy of the cover image. version is the SHA-256 of the package, as .NET's
+ * BitConverter.ToString prints it ("AB-CD-...").
+ */
+export function writePackageManifest(model, packagePath) {
+    const destination = path.dirname(packagePath);
+    const packageName = path.basename(packagePath, path.extname(packagePath));
+    const digest = createHash('sha256').update(fs.readFileSync(packagePath)).digest('hex').toUpperCase();
+    const version = digest.match(/../g).join('-');
+    const config = { ...model.questConfig, version };
+    let icon;
+    if (config.image) {
+        const source = path.join(model.scenarioDir, config.image);
+        icon = path.basename(config.image);
+        if (fs.existsSync(source))
+            fs.copyFileSync(source, path.join(destination, icon));
+        config.image = icon;
+    }
+    const lines = ['[Quest]'];
+    for (const [k, v] of Object.entries(serializeQuestConfig(config)))
+        lines.push(`${k}=${v}`);
+    // The localization file holds the default language; each text is written under that language's name
+    const lang = config.defaultlanguage || 'English';
+    const text = (key) => model.localization.get(key);
+    const oneLine = (v) => v.replace(/\r/g, '').replace(/\\n|\n/g, '');
+    const escaped = (v) => v.replace(/\r/g, '').replace(/\n/g, '\\n');
+    const entries = [
+        ['name', text('quest.name'), v => v],
+        ['synopsys', text('quest.synopsys'), oneLine],
+        ['description', text('quest.description'), escaped],
+        ['authors', text('quest.authors'), escaped],
+        ['authors_short', text('quest.authors_short'), oneLine],
+    ];
+    for (const [field, value, format] of entries) {
+        if (value !== undefined)
+            lines.push(`${field}.${lang}=${format(value)}`);
+    }
+    const manifest = path.join(destination, `${packageName}.ini`);
+    fs.writeFileSync(manifest, lines.join('\n') + '\n');
+    return { manifest, icon };
+}
+//# sourceMappingURL=package-manifest.js.map

package/dist/io/package-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manifest.js","sourceRoot":"","sources":["../../src/io/package-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClG,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC;AAChF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAoB,EAAE,WAAmB;IAC5E,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACrG,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;IACjD,IAAI,IAAwB,CAAC;IAC7B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1D,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;QACjF,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3F,oGAAoG;IACpG,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,IAAI,SAAS,CAAC;IACjD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC1E,MAAM,OAAO,GAA+D;QAC1E,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC7C,CAAC,aAAa,EAAE,IAAI,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;QACnD,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;QAC3C,CAAC,eAAe,EAAE,IAAI,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;KACxD,CAAC;IACF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QAC7C,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,WAAW,MAAM,CAAC,CAAC;IAC9D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACpD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC"}