@thijshakkenberg/valkyrie-mom-mcp 2.4.1 → 2.5.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "valkyrie-mom",
-  "version": "2.4.1",
+  "version": "2.5.1",
   "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 8 skills covering advanced patterns (event loops, mythos scaling, tile placement chains, custom puzzles, generated artwork, etc.) and an autonomous scenario designer agent.
+The plugin bundles 9 skills covering advanced patterns (event loops, mythos scaling, tile placement chains, custom puzzles, generated artwork, spoken narration, 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)
-- **8 skills**: `/scenario`, `/event-patterns`, `/tile-placement`, `/variables-and-mythos`, `/custom-monsters`, `/ui-and-puzzles`, `/items-and-distribution`, `/artwork`
+- **9 skills**: `/scenario`, `/event-patterns`, `/tile-placement`, `/variables-and-mythos`, `/custom-monsters`, `/ui-and-puzzles`, `/items-and-distribution`, `/artwork`, `/narration`
 - **Scenario designer agent** for autonomous scenario creation
 - **5 MCP resources** for format documentation
 
@@ -84,6 +84,7 @@ npx tsx src/index.ts   # Run MCP server via stdio
 | `/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 |
+| `/narration` | Read story text aloud with a local Kokoro voice: what to narrate, voices, pronunciations, how Valkyrie plays event audio |
 
 ## MCP Tools
 
@@ -146,6 +147,14 @@ 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.
 
+### Narration
+| Tool | Description |
+|------|-------------|
+| `narration_status` | Check the local text-to-speech engine and model, list the voices; `install=true` installs the engine |
+| `generate_narration` | Speak components' dialog text with Kokoro-82M into OGG clips in the scenario folder (`audio/narration/<Event>.ogg`) and set their `audio=`. Speaks only the italic story text by default, expands `{qst:}`, turns icons into words, takes respellings for names |
+
+Narration is optional and runs entirely on your machine, on the CPU: [Kokoro-82M](https://huggingface.co/hexgrad/Kokoro-82M) (Apache 2.0) through [kokoro-js](https://github.com/hexgrad/kokoro/tree/main/kokoro.js), with OGG Vorbis encoding in WebAssembly, so no Python or ffmpeg is needed. `narration_status install=true` installs the engine once (about 450 MB, in `~/.cache/valkyrie-mom-mcp/kokoro`, or `VALKYRIE_TTS_DIR`); the first narration downloads the model (about 330 MB). English voices only. The default voice, `af_nicole` at speed 0.9, was picked by ear from 15 voices for horror (`bf_isabella`, `bm_lewis` and `bm_daniel` also fit); the model's quality grades didn't predict the fit. The `/narration` skill covers what to narrate and how Valkyrie plays the clips.
+
 ### Reference
 | Tool | Description |
 |------|-------------|
@@ -239,7 +248,7 @@ npm run hermes:tools  # Re-export the Hermes plugin tool list after changing too
 .claude-plugin/    Claude Code plugin manifest
 plugin.yaml        Hermes Agent plugin manifest (+ __init__.py entry point)
 hermes_bridge/     Hermes plugin: MCP stdio client, tool registration, exported tools.json
-skills/            8 skill SKILL.md files (Claude Code and Hermes)
+skills/            9 skill SKILL.md files (Claude Code and Hermes)
 agents/            Scenario designer agent
 src/
   io/              INI parser/writer, localization CSV, ZIP packager
@@ -249,6 +258,7 @@ src/
   tools/           MCP tool implementations
   story/           Storyline graph: outline, Mermaid, HTML
   artwork/         ComfyUI (FLUX.2 [klein]) artwork generation
+  narration/       Kokoro text-to-speech, dialog text to speech text
   resources/       Format documentation resources
   catalogs/        846-entry game content catalog
   diagnostics/     Bug report builder, session trace, ring buffer
@@ -265,6 +275,10 @@ tests/
   integration.test.ts  Full pipeline tests
 ```
 
+## Changes and Roadmap
+
+See [CHANGELOG.md](CHANGELOG.md) for what changed in each release and [TODO.md](TODO.md) for what is planned next (hybrid semantic search for game content, generated sound effects).
+
 ## Related Projects
 
 - [Valkyrie](https://github.com/NPBruce/valkyrie) - Scenario builder and player

package/agents/scenario-designer.md

@@ -28,6 +28,7 @@ skills:
   - ui-and-puzzles
   - items-and-distribution
   - artwork
+  - narration
 ---
 
 # Scenario Designer Agent
@@ -42,6 +43,7 @@ You are an autonomous Mansions of Madness 2nd Edition scenario designer. You cre
 - 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`)
+- Narrate the introduction, key story beats and endings with a local Kokoro voice when the engine is installed (`narration_status`)
 - Set up mythos scaling for tension progression
 - Write atmospheric narrative text in the Lovecraftian horror style
 - Validate scenarios for correctness and completeness
@@ -58,6 +60,7 @@ Use these skills for detailed pattern guidance:
 - `/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
+- `/narration` — Read story text aloud with a local Kokoro voice: OGG clips on event `audio=`, what to narrate, voices, pronunciations
 
 ## Design Principles
 

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

@@ -1 +1 @@
-{"version":3,"file":"localization-io.d.ts","sourceRoot":"","sources":["../../src/io/localization-io.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAKD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA4CrE;AAcD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAexF"}
+{"version":3,"file":"localization-io.d.ts","sourceRoot":"","sources":["../../src/io/localization-io.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAKD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA4CrE;AAcD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAiBxF"}

package/dist/io/localization-io.js

@@ -77,7 +77,9 @@ export function writeLocalization(language, entries) {
     const lines = [`.,${language}`];
     for (const [key, rawValue] of entries) {
         const value = rawValue.replace(/\r\n|\r|\n/g, '\\n');
-        if (value.includes('"') && !value.includes(TRIPLE)) {
+        // ParseEntry strips a pair of outer quotes even inside |||, so |||"dialogue"||| would lose them
+        const quotedAtBothEnds = value.length > 1 && value.startsWith('"') && value.endsWith('"');
+        if (value.includes('"') && !value.includes(TRIPLE) && !quotedAtBothEnds) {
             lines.push(`${key},${TRIPLE}${value}${TRIPLE}`);
         }
         else if (value.includes('"') || value.includes(TRIPLE) || value.includes('\\n') || value.includes(',')) {

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

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

package/dist/narration/kokoro.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Narration with Kokoro-82M (kokoro-js, ONNX on the CPU) saved as OGG Vorbis, the format
+ * Valkyrie's editor lists for event audio. kokoro-js brings onnxruntime (~400 MB), so it is
+ * not a dependency of this package: installNarrationEngine() puts it in its own folder, and
+ * the model (~330 MB fp32) is downloaded there on first use.
+ */
+export declare const KOKORO_MODEL_ID = "onnx-community/Kokoro-82M-v1.0-ONNX";
+/** Pinned so every install behaves the same; wasm-media-encoders encodes OGG Vorbis without ffmpeg */
+export declare const ENGINE_PACKAGES: {
+    readonly 'kokoro-js': "1.2.1";
+    readonly 'wasm-media-encoders': "0.7.0";
+};
+/** fp32 is both faster on the CPU (about 2 s per sentence on an M1 Pro) and cleaner than q8 */
+export type KokoroDtype = 'fp32' | 'fp16' | 'q8' | 'q4' | 'q4f16';
+export declare const DEFAULT_DTYPE: KokoroDtype;
+export declare const SAMPLE_RATE = 24000;
+/**
+ * Voices picked by ear for horror narration. 15 voices read the same passage at speed 0.9
+ * ("The lamp gutters and goes out. / Somewhere beneath the floorboards of the Blackwood
+ * house, something has begun to sing. / It knows your name.") on 2026-10-04. The quality
+ * grades did not predict the fit: the A and A- voices (af_heart, af_bella) were not picked,
+ * and two D voices were. Best first.
+ */
+export declare const HORROR_PICKS: ReadonlyArray<{
+    voice: string;
+    verdict: string;
+}>;
+/** Also in that trial, not picked */
+export declare const HORROR_TRIAL_OTHERS: readonly ["am_fenrir", "am_michael", "am_onyx", "am_puck", "am_echo", "af_heart", "af_bella", "af_kore", "bm_george", "bm_fable", "bf_emma"];
+/** The trial's winner, at the speed it was judged at */
+export declare const DEFAULT_VOICE: string;
+export declare const DEFAULT_SPEED = 0.9;
+/** kokoro-js speaks English only: a = American, b = British. Grades are hexgrad's quality ratings */
+export declare const VOICES: Record<string, string>;
+/** Where the engine lives: VALKYRIE_TTS_DIR, or a per-user cache folder */
+export declare function defaultEngineDir(): string;
+export interface NarrationStatus {
+    engineDir: string;
+    /** Installed package versions; missing packages are absent */
+    packages: Partial<Record<keyof typeof ENGINE_PACKAGES, string>>;
+    installed: boolean;
+    dtype: KokoroDtype;
+    /** The model for dtype is in the engine's cache; otherwise the first narration downloads it */
+    modelDownloaded: boolean;
+}
+export declare function getNarrationStatus(engineDir?: string, dtype?: KokoroDtype): NarrationStatus;
+export declare function narrationSetupInstructions(status: NarrationStatus): string;
+export type RunCommand = (cmd: string, args: string[], cwd: string) => Promise<{
+    code: number;
+    output: string;
+}>;
+/** Installs kokoro-js and the OGG encoder into the engine folder with npm */
+export declare function installNarrationEngine(engineDir?: string, run?: RunCommand): Promise<NarrationStatus>;
+/** Text to samples and samples to OGG; an interface so tests can stand in for the model */
+export interface SpeechEngine {
+    /** Mono float samples at SAMPLE_RATE, one entry per sentence */
+    synthesize(text: string, voice: string, speed: number): Promise<Float32Array[]>;
+    encodeOgg(samples: Float32Array, sampleRate: number): Promise<Uint8Array>;
+}
+/** Loads kokoro-js from the engine folder once per process (the first load may download the model) */
+export declare function loadKokoroEngine(engineDir?: string, dtype?: KokoroDtype): Promise<SpeechEngine>;
+export interface NarrateOptions {
+    /** Spoken in order with a pause between them */
+    paragraphs: string[];
+    outputFile: string;
+    voice?: string;
+    speed?: number;
+    engine: SpeechEngine;
+}
+export interface NarrateResult {
+    file: string;
+    /** Length of the clip */
+    duration: number;
+    bytes: number;
+    /** Time taken to synthesize and encode */
+    seconds: number;
+}
+export declare function assertVoice(voice: string): void;
+/** Speaks the paragraphs and writes one OGG Vorbis clip */
+export declare function narrate(opts: NarrateOptions): Promise<NarrateResult>;
+//# sourceMappingURL=kokoro.d.ts.map

package/dist/narration/kokoro.d.ts.map

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

package/dist/narration/kokoro.js

@@ -0,0 +1,241 @@
+import { spawn } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+/**
+ * Narration with Kokoro-82M (kokoro-js, ONNX on the CPU) saved as OGG Vorbis, the format
+ * Valkyrie's editor lists for event audio. kokoro-js brings onnxruntime (~400 MB), so it is
+ * not a dependency of this package: installNarrationEngine() puts it in its own folder, and
+ * the model (~330 MB fp32) is downloaded there on first use.
+ */
+export const KOKORO_MODEL_ID = 'onnx-community/Kokoro-82M-v1.0-ONNX';
+/** Pinned so every install behaves the same; wasm-media-encoders encodes OGG Vorbis without ffmpeg */
+export const ENGINE_PACKAGES = { 'kokoro-js': '1.2.1', 'wasm-media-encoders': '0.7.0' };
+export const DEFAULT_DTYPE = process.env.VALKYRIE_TTS_DTYPE ?? 'fp32';
+export const SAMPLE_RATE = 24000;
+/**
+ * Voices picked by ear for horror narration. 15 voices read the same passage at speed 0.9
+ * ("The lamp gutters and goes out. / Somewhere beneath the floorboards of the Blackwood
+ * house, something has begun to sing. / It knows your name.") on 2026-10-04. The quality
+ * grades did not predict the fit: the A and A- voices (af_heart, af_bella) were not picked,
+ * and two D voices were. Best first.
+ */
+export const HORROR_PICKS = [
+    { voice: 'af_nicole', verdict: 'best fit' },
+    { voice: 'bf_isabella', verdict: 'good' },
+    { voice: 'bm_lewis', verdict: 'good' },
+    { voice: 'bm_daniel', verdict: 'good' },
+];
+/** Also in that trial, not picked */
+export const HORROR_TRIAL_OTHERS = ['am_fenrir', 'am_michael', 'am_onyx', 'am_puck', 'am_echo', 'af_heart', 'af_bella', 'af_kore', 'bm_george', 'bm_fable', 'bf_emma'];
+/** The trial's winner, at the speed it was judged at */
+export const DEFAULT_VOICE = HORROR_PICKS[0].voice;
+export const DEFAULT_SPEED = 0.9;
+/** kokoro-js speaks English only: a = American, b = British. Grades are hexgrad's quality ratings */
+export const VOICES = {
+    af_heart: 'American female, A', af_bella: 'American female, A-', af_nicole: 'American female, B-',
+    af_aoede: 'American female, C+', af_kore: 'American female, C+', af_sarah: 'American female, C+',
+    af_alloy: 'American female, C', af_nova: 'American female, C', af_sky: 'American female, C-',
+    af_jessica: 'American female, D', af_river: 'American female, D',
+    am_fenrir: 'American male, C+', am_michael: 'American male, C+', am_puck: 'American male, C+',
+    am_echo: 'American male, D', am_eric: 'American male, D', am_liam: 'American male, D', am_onyx: 'American male, D',
+    am_santa: 'American male, D-', am_adam: 'American male, F+',
+    bf_emma: 'British female, B-', bf_isabella: 'British female, C', bf_alice: 'British female, D', bf_lily: 'British female, D',
+    bm_george: 'British male, C', bm_fable: 'British male, C', bm_lewis: 'British male, D+', bm_daniel: 'British male, D',
+};
+/** Silence between paragraphs and between sentences, in seconds */
+const PARAGRAPH_PAUSE = 0.6;
+const SENTENCE_PAUSE = 0.12;
+/** Where the engine lives: VALKYRIE_TTS_DIR, or a per-user cache folder */
+export function defaultEngineDir() {
+    if (process.env.VALKYRIE_TTS_DIR)
+        return process.env.VALKYRIE_TTS_DIR;
+    const base = process.platform === 'win32'
+        ? (process.env.LOCALAPPDATA ?? path.join(os.homedir(), 'AppData', 'Local'))
+        : (process.env.XDG_CACHE_HOME ?? path.join(os.homedir(), '.cache'));
+    return path.join(base, 'valkyrie-mom-mcp', 'kokoro');
+}
+function modelFile(dtype) {
+    return dtype === 'fp32' ? 'model.onnx' : dtype === 'q8' ? 'model_quantized.onnx' : `model_${dtype}.onnx`;
+}
+function installedVersion(dir, pkg) {
+    try {
+        return JSON.parse(fs.readFileSync(path.join(dir, 'node_modules', pkg, 'package.json'), 'utf8')).version;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function getNarrationStatus(engineDir = defaultEngineDir(), dtype = DEFAULT_DTYPE) {
+    const packages = {};
+    for (const pkg of Object.keys(ENGINE_PACKAGES)) {
+        const v = installedVersion(engineDir, pkg);
+        if (v)
+            packages[pkg] = v;
+    }
+    return {
+        engineDir,
+        packages,
+        installed: Object.keys(packages).length === Object.keys(ENGINE_PACKAGES).length,
+        dtype,
+        modelDownloaded: fs.existsSync(path.join(engineDir, 'models', ...KOKORO_MODEL_ID.split('/'), 'onnx', modelFile(dtype))),
+    };
+}
+export function narrationSetupInstructions(status) {
+    const deps = Object.entries(ENGINE_PACKAGES).map(([p, v]) => `${p}@${v}`).join(' ');
+    const lines = [];
+    if (!status.installed) {
+        lines.push(`The narration engine is not installed in ${status.engineDir}.`, 'Call narration_status with install=true, or run:', `  npm install --prefix "${status.engineDir}" ${deps}`, 'It needs about 450 MB (kokoro-js with onnxruntime). Set VALKYRIE_TTS_DIR to keep it elsewhere.');
+    }
+    if (!status.modelDownloaded) {
+        lines.push(`The Kokoro-82M model (${status.dtype}, ${status.dtype === 'fp32' ? '~330 MB' : '~90-170 MB'}) is downloaded from Hugging Face on the first narration.`);
+    }
+    return lines.join('\n');
+}
+const runCommand = (cmd, args, cwd) => new Promise((resolve, reject) => {
+    const child = spawn(cmd, args, { cwd, shell: process.platform === 'win32', stdio: ['ignore', 'pipe', 'pipe'] });
+    let output = '';
+    child.stdout.on('data', d => { output += d; });
+    child.stderr.on('data', d => { output += d; });
+    child.on('error', reject);
+    child.on('close', code => resolve({ code: code ?? 1, output }));
+});
+/** Installs kokoro-js and the OGG encoder into the engine folder with npm */
+export async function installNarrationEngine(engineDir = defaultEngineDir(), run = runCommand) {
+    fs.mkdirSync(engineDir, { recursive: true });
+    fs.writeFileSync(path.join(engineDir, 'package.json'), JSON.stringify({
+        name: 'valkyrie-mom-narration-engine',
+        private: true,
+        description: 'Text to speech for valkyrie-mom-mcp (generate_narration)',
+        dependencies: ENGINE_PACKAGES,
+    }, null, 2) + '\n');
+    const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    const { code, output } = await run(npm, ['install', '--no-audit', '--no-fund', '--omit=dev', '--loglevel=error'], engineDir);
+    if (code !== 0)
+        throw new Error(`npm install failed in ${engineDir} (exit ${code}):\n${output.slice(-2000)}`);
+    const status = getNarrationStatus(engineDir);
+    if (!status.installed)
+        throw new Error(`npm install finished, but ${engineDir} is still missing packages:\n${output.slice(-2000)}`);
+    return status;
+}
+/** The ES module entry of a package installed in the engine folder */
+function esmEntry(engineDir, pkg) {
+    const pkgDir = path.join(engineDir, 'node_modules', pkg);
+    const pj = JSON.parse(fs.readFileSync(path.join(pkgDir, 'package.json'), 'utf8'));
+    const root = pj.exports?.['.'] ?? pj.exports;
+    const entry = root?.node?.import ?? root?.import ?? pj.module ?? pj.main ?? 'index.js';
+    return pathToFileURL(path.join(pkgDir, typeof entry === 'string' ? entry : entry.default)).href;
+}
+/**
+ * MCP talks JSON over stdout: anything the libraries print there would break the connection,
+ * so console output goes to stderr while they run.
+ */
+async function quietStdout(fn) {
+    const saved = { log: console.log, info: console.info, table: console.table, debug: console.debug };
+    console.log = console.info = console.debug = (...a) => console.error(...a);
+    console.table = (d) => console.error(d);
+    try {
+        return await fn();
+    }
+    finally {
+        Object.assign(console, saved);
+    }
+}
+const engines = new Map();
+/** Loads kokoro-js from the engine folder once per process (the first load may download the model) */
+export function loadKokoroEngine(engineDir = defaultEngineDir(), dtype = DEFAULT_DTYPE) {
+    const key = `${engineDir}|${dtype}`;
+    let engine = engines.get(key);
+    if (!engine) {
+        engine = createKokoroEngine(engineDir, dtype);
+        engines.set(key, engine);
+        engine.catch(() => engines.delete(key));
+    }
+    return engine;
+}
+async function createKokoroEngine(engineDir, dtype) {
+    const status = getNarrationStatus(engineDir, dtype);
+    if (!status.installed)
+        throw new Error(narrationSetupInstructions(status));
+    // kokoro-js's own env.cacheDir does not reach the transformers instance that loads the
+    // model, so set it there; otherwise the model lands inside node_modules
+    const transformers = await import(esmEntry(engineDir, '@huggingface/transformers'));
+    transformers.env.cacheDir = path.join(engineDir, 'models');
+    const kokoro = await import(esmEntry(engineDir, 'kokoro-js'));
+    const encoders = await import(esmEntry(engineDir, 'wasm-media-encoders'));
+    // kokoro-js is loaded at runtime from the engine folder, so it has no types here
+    const tts = await quietStdout(() => kokoro.KokoroTTS.from_pretrained(KOKORO_MODEL_ID, { dtype, device: 'cpu' }));
+    return {
+        async synthesize(text, voice, speed) {
+            const chunks = [];
+            await quietStdout(async () => {
+                // Sentence by sentence keeps each one under the model's 510-token limit. stream() does
+                // not close a splitter it makes from a string, so close our own to get the last sentence
+                const splitter = new kokoro.TextSplitterStream();
+                splitter.push(text);
+                splitter.close();
+                for await (const { audio } of tts.stream(splitter, { voice, speed }))
+                    chunks.push(audio.audio);
+            });
+            return chunks;
+        },
+        async encodeOgg(samples, sampleRate) {
+            const encoder = await encoders.createOggEncoder();
+            encoder.configure({ channels: 1, sampleRate, vbrQuality: 4 });
+            // encode() and finalize() return views into the encoder's memory, so copy each one
+            const body = encoder.encode([samples]).slice();
+            const tail = encoder.finalize().slice();
+            const out = new Uint8Array(body.length + tail.length);
+            out.set(body);
+            out.set(tail, body.length);
+            return out;
+        },
+    };
+}
+export function assertVoice(voice) {
+    if (!(voice in VOICES)) {
+        throw new Error(`Unknown voice "${voice}". Voices: ${Object.keys(VOICES).join(', ')}`);
+    }
+}
+/** Speaks the paragraphs and writes one OGG Vorbis clip */
+export async function narrate(opts) {
+    const voice = opts.voice ?? DEFAULT_VOICE;
+    assertVoice(voice);
+    const speed = opts.speed ?? DEFAULT_SPEED;
+    if (!(speed >= 0.5 && speed <= 2))
+        throw new Error('speed must be between 0.5 and 2');
+    if (opts.paragraphs.length === 0)
+        throw new Error('Nothing to narrate');
+    const started = Date.now();
+    const silence = (s) => new Float32Array(Math.round(s * SAMPLE_RATE));
+    const parts = [];
+    for (const [i, paragraph] of opts.paragraphs.entries()) {
+        if (i > 0)
+            parts.push(silence(PARAGRAPH_PAUSE));
+        const sentences = await opts.engine.synthesize(paragraph, voice, speed);
+        sentences.forEach((s, j) => {
+            if (j > 0)
+                parts.push(silence(SENTENCE_PAUSE));
+            parts.push(s);
+        });
+    }
+    // A short tail so the last word is not clipped when playback stops
+    parts.push(silence(0.25));
+    const samples = new Float32Array(parts.reduce((n, p) => n + p.length, 0));
+    let offset = 0;
+    for (const p of parts) {
+        samples.set(p, offset);
+        offset += p.length;
+    }
+    const ogg = await opts.engine.encodeOgg(samples, SAMPLE_RATE);
+    fs.mkdirSync(path.dirname(opts.outputFile), { recursive: true });
+    fs.writeFileSync(opts.outputFile, ogg);
+    return {
+        file: opts.outputFile,
+        duration: Math.round((samples.length / SAMPLE_RATE) * 10) / 10,
+        bytes: ogg.length,
+        seconds: Math.round((Date.now() - started) / 100) / 10,
+    };
+}
+//# sourceMappingURL=kokoro.js.map

package/dist/narration/kokoro.js.map

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

package/dist/narration/narration-text.d.ts

@@ -0,0 +1,32 @@
+import type { ScenarioModel } from '../model/scenario-model.js';
+/**
+ * Turns Valkyrie dialog text into something a TTS voice can read aloud: {qst:} entries are
+ * expanded, icons become words, markup is dropped, and text that only exists while playing
+ * ({rnd:hero}, {var:}) is replaced or left out with a note.
+ */
+/**
+ * Which part of the text to speak. Community scenarios set the story in italics
+ * ("<i>You come across an old tome.</i>\n\nTest {lore}."), so "auto" speaks only the
+ * italic parts when there are any, and the whole text otherwise.
+ */
+export type NarrationPart = 'auto' | 'flavor' | 'all';
+export interface SpeechTextOptions {
+    part?: NarrationPart;
+    /** Resolves {qst:KEY}; usually model.localization.get */
+    lookup?: (key: string) => string | undefined;
+    /** Word -> respelling for names the voice gets wrong, e.g. { Cthulhu: "Kuh-thoo-loo" } */
+    pronunciations?: Record<string, string>;
+}
+export interface SpeechText {
+    /** Paragraphs joined by blank lines; empty when nothing is left to say */
+    text: string;
+    paragraphs: string[];
+    /** What was replaced or dropped because it is only known during play */
+    notes: string[];
+}
+/** {ffg:TILE_TOWN_SQUARE_MAD20} -> "town square" */
+export declare function humanizeFfgKey(key: string): string;
+export declare function speechText(raw: string, opts?: SpeechTextOptions): SpeechText;
+/** The localized text a component shows (<name>.text), or undefined when it has none */
+export declare function componentText(model: ScenarioModel, name: string): string | undefined;
+//# sourceMappingURL=narration-text.d.ts.map

package/dist/narration/narration-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration-text.d.ts","sourceRoot":"","sources":["../../src/narration/narration-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,yDAAyD;IACzD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7C,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,wEAAwE;IACxE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAQD,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMlD;AA0BD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,UAAU,CA2ChF;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpF"}

package/dist/narration/narration-text.js

@@ -0,0 +1,82 @@
+/** {action}, {strength}, ... as words */
+const ICON_WORDS = {
+    action: 'action', strength: 'strength', agility: 'agility', observation: 'observation', lore: 'lore',
+    influence: 'influence', will: 'will', success: 'success', clue: 'clue', health: 'health', sanity: 'sanity',
+};
+/** {ffg:TILE_TOWN_SQUARE_MAD20} -> "town square" */
+export function humanizeFfgKey(key) {
+    return key
+        .replace(/^(MONSTER|TILE|ITEM|TOKEN|INVESTIGATOR|PUZZLE|AUDIO|UI)_/i, '')
+        .replace(/_(MAD|MOM|BTT|SOT|HJ|POTS|SOA|SOTP)\d*$/i, '')
+        .replace(/_/g, ' ')
+        .toLowerCase();
+}
+/** TileTownSquare -> "Town Square", QItemOldTome -> "Old Tome" */
+function humanizeComponentName(name) {
+    return name
+        .replace(/^(Tile|Token|QItem|CustomMonster|Spawn|MPlace|UI|Puzzle|Door)/, '')
+        .replace(/([a-z])([A-Z0-9])/g, '$1 $2')
+        .trim();
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Expands {qst:KEY} from the localization, a few levels deep */
+function expandQst(text, lookup, notes, depth = 0) {
+    return text.replace(/\{qst:([^}]+)\}/g, (_, key) => {
+        const value = lookup?.(key);
+        if (value === undefined || depth >= 5) {
+            notes.push(`{qst:${key}} has no text and was left out`);
+            return '';
+        }
+        return expandQst(value, lookup, notes, depth + 1);
+    });
+}
+export function speechText(raw, opts = {}) {
+    const notes = [];
+    // Localization files keep newlines as a literal \n
+    let text = expandQst(raw, opts.lookup, notes).replace(/\\n/g, '\n');
+    const part = opts.part ?? 'auto';
+    if (part !== 'all') {
+        const italic = [...text.matchAll(/<i>([\s\S]*?)<\/i>/gi)].map(m => m[1]);
+        if (italic.length > 0)
+            text = italic.join('\n\n');
+        else if (part === 'flavor')
+            notes.push('No italic story text found; the whole text is spoken');
+    }
+    text = text
+        .replace(/\{rnd:hero\}/gi, () => {
+        notes.push('{rnd:hero} is spoken as "an investigator"');
+        return 'an investigator';
+    })
+        .replace(/\{c:([^}]+)\}/g, (_, name) => {
+        // On an event, {c:} repeats the investigator that event's {rnd:hero} picked
+        if (/^Event/.test(name)) {
+            notes.push(`{c:${name}} is spoken as "the investigator"`);
+            return 'the investigator';
+        }
+        return humanizeComponentName(name);
+    })
+        .replace(/\{var:([^}]+)\}/g, (_, name) => {
+        notes.push(`{var:${name}} is only known during play and was left out`);
+        return '';
+    })
+        .replace(/\{ffg:([^}]+)\}/g, (_, key) => humanizeFfgKey(key))
+        .replace(/\{(\w+)\}/g, (_, word) => ICON_WORDS[word.toLowerCase()] ?? word)
+        .replace(/<[^>]+>/g, '');
+    for (const [word, spoken] of Object.entries(opts.pronunciations ?? {})) {
+        if (!word.trim())
+            continue;
+        text = text.replace(new RegExp(`(?<![\\p{L}\\p{N}])${escapeRegExp(word)}(?![\\p{L}\\p{N}])`, 'giu'), spoken);
+    }
+    const paragraphs = text
+        .split(/\n+/)
+        .map(p => p.replace(/[ \t]+/g, ' ').replace(/\s+([,.;:!?])/g, '$1').trim())
+        .filter(p => /[\p{L}\p{N}]/u.test(p));
+    return { text: paragraphs.join('\n\n'), paragraphs, notes: [...new Set(notes)] };
+}
+/** The localized text a component shows (<name>.text), or undefined when it has none */
+export function componentText(model, name) {
+    return model.localization.get(`${name}.text`);
+}
+//# sourceMappingURL=narration-text.js.map

package/dist/narration/narration-text.js.map

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