@thijshakkenberg/valkyrie-mom-mcp 1.0.0

package/dist/model/localization-store.d.ts

@@ -0,0 +1,15 @@
+export declare class LocalizationStore {
+    private data;
+    private language;
+    constructor(language?: string);
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    delete(key: string): boolean;
+    has(key: string): boolean;
+    entries(): IterableIterator<[string, string]>;
+    keys(): IterableIterator<string>;
+    get size(): number;
+    toCSV(): string;
+    static fromCSV(content: string): LocalizationStore;
+}
+//# sourceMappingURL=localization-store.d.ts.map

package/dist/model/localization-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization-store.d.ts","sourceRoot":"","sources":["../../src/model/localization-store.ts"],"names":[],"mappings":"AAEA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,SAAY;IAKhC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI7C,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAIhC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,MAAM;IAIf,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;CAQnD"}

package/dist/model/localization-store.js

@@ -0,0 +1,42 @@
+import { parseLocalization, writeLocalization } from '../io/localization-io.js';
+export class LocalizationStore {
+    data;
+    language;
+    constructor(language = 'English') {
+        this.data = new Map();
+        this.language = language;
+    }
+    get(key) {
+        return this.data.get(key);
+    }
+    set(key, value) {
+        this.data.set(key, value);
+    }
+    delete(key) {
+        return this.data.delete(key);
+    }
+    has(key) {
+        return this.data.has(key);
+    }
+    entries() {
+        return this.data.entries();
+    }
+    keys() {
+        return this.data.keys();
+    }
+    get size() {
+        return this.data.size;
+    }
+    toCSV() {
+        return writeLocalization(this.language, this.data);
+    }
+    static fromCSV(content) {
+        const parsed = parseLocalization(content);
+        const store = new LocalizationStore(parsed.language);
+        for (const [key, value] of parsed.entries) {
+            store.set(key, value);
+        }
+        return store;
+    }
+}
+//# sourceMappingURL=localization-store.js.map

package/dist/model/localization-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization-store.js","sourceRoot":"","sources":["../../src/model/localization-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,MAAM,OAAO,iBAAiB;IACpB,IAAI,CAAsB;IAC1B,QAAQ,CAAS;IAEzB,YAAY,QAAQ,GAAG,SAAS;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAa;QAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,KAAK;QACH,OAAO,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/model/scenario-model.d.ts

@@ -0,0 +1,27 @@
+import { type IniFile, type QuestConfig, type ScenarioComponent } from './component-types.js';
+import { LocalizationStore } from './localization-store.js';
+export declare class ScenarioModel {
+    questConfig: QuestConfig;
+    private components;
+    localization: LocalizationStore;
+    scenarioDir: string;
+    constructor(config?: Partial<QuestConfig>, scenarioDir?: string);
+    upsert(name: string, data: Record<string, string>): void;
+    get(name: string): ScenarioComponent | undefined;
+    delete(name: string): string[];
+    getAll(): ScenarioComponent[];
+    getByType(prefix: string): ScenarioComponent[];
+    getComponentsByFile(file: IniFile): ScenarioComponent[];
+    /** Find all components that reference the target name */
+    getReferencesTo(targetName: string): Array<{
+        from: string;
+        field: string;
+    }>;
+    /** Get all component names referenced by a component */
+    getReferencesFrom(name: string): string[];
+    /** Serialize all components grouped by INI file (strips undefined values) */
+    serializeToIniData(): Record<string, Record<string, Record<string, string>>>;
+    /** Load a model from raw file contents (no disk IO) */
+    static loadFromData(questIniContent: string, dataFileContents: Record<string, string>, localizationContent?: string): ScenarioModel;
+}
+//# sourceMappingURL=scenario-model.d.ts.map

package/dist/model/scenario-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-model.d.ts","sourceRoot":"","sources":["../../src/model/scenario-model.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAKvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,qBAAa,aAAa;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,CAAC,UAAU,CAA6C;IAC/D,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;gBAER,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,WAAW,SAAK;IAM3D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAcxD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IA6B9B,MAAM,IAAI,iBAAiB,EAAE;IAI7B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAI9C,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,EAAE;IAIvD,yDAAyD;IACzD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAe3E,wDAAwD;IACxD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAczC,6EAA6E;IAC7E,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAe5E,uDAAuD;IACvD,MAAM,CAAC,YAAY,CACjB,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,mBAAmB,CAAC,EAAE,MAAM,GAC3B,aAAa;CAwCjB"}

package/dist/model/scenario-model.js

@@ -0,0 +1,151 @@
+import { DEFAULT_QUEST_CONFIG, REFERENCE_FIELDS, parseRefList, getIniFileForSection, } from './component-types.js';
+import { LocalizationStore } from './localization-store.js';
+import { parseIni } from '../io/ini-parser.js';
+export class ScenarioModel {
+    questConfig;
+    components = new Map();
+    localization;
+    scenarioDir;
+    constructor(config, scenarioDir = '') {
+        this.questConfig = { ...DEFAULT_QUEST_CONFIG, ...config };
+        this.localization = new LocalizationStore();
+        this.scenarioDir = scenarioDir;
+    }
+    upsert(name, data) {
+        const existing = this.components.get(name);
+        if (existing) {
+            // Merge: new data overwrites, existing fields preserved
+            existing.data = { ...existing.data, ...data };
+        }
+        else {
+            this.components.set(name, {
+                name,
+                file: getIniFileForSection(name),
+                data: { ...data },
+            });
+        }
+    }
+    get(name) {
+        return this.components.get(name);
+    }
+    delete(name) {
+        const existed = this.components.has(name);
+        if (!existed)
+            return [];
+        this.components.delete(name);
+        // Cascade: clean references to deleted component in all other components
+        const cascaded = [];
+        for (const comp of this.components.values()) {
+            let changed = false;
+            for (const field of REFERENCE_FIELDS) {
+                const val = comp.data[field];
+                if (val === undefined)
+                    continue;
+                const refs = parseRefList(val);
+                if (refs.includes(name)) {
+                    const newRefs = refs.filter(r => r !== name);
+                    comp.data[field] = newRefs.join(' ');
+                    changed = true;
+                }
+            }
+            if (changed) {
+                cascaded.push(comp.name);
+            }
+        }
+        return cascaded;
+    }
+    getAll() {
+        return [...this.components.values()];
+    }
+    getByType(prefix) {
+        return this.getAll().filter(c => c.name.startsWith(prefix));
+    }
+    getComponentsByFile(file) {
+        return this.getAll().filter(c => c.file === file);
+    }
+    /** Find all components that reference the target name */
+    getReferencesTo(targetName) {
+        const results = [];
+        for (const comp of this.components.values()) {
+            for (const field of REFERENCE_FIELDS) {
+                const val = comp.data[field];
+                if (val === undefined)
+                    continue;
+                const refs = parseRefList(val);
+                if (refs.includes(targetName)) {
+                    results.push({ from: comp.name, field });
+                }
+            }
+        }
+        return results;
+    }
+    /** Get all component names referenced by a component */
+    getReferencesFrom(name) {
+        const comp = this.components.get(name);
+        if (!comp)
+            return [];
+        const refs = new Set();
+        for (const field of REFERENCE_FIELDS) {
+            const val = comp.data[field];
+            if (val === undefined)
+                continue;
+            for (const ref of parseRefList(val)) {
+                refs.add(ref);
+            }
+        }
+        return [...refs];
+    }
+    /** Serialize all components grouped by INI file (strips undefined values) */
+    serializeToIniData() {
+        const result = {};
+        for (const comp of this.components.values()) {
+            if (!result[comp.file]) {
+                result[comp.file] = {};
+            }
+            const clean = {};
+            for (const [k, v] of Object.entries(comp.data)) {
+                if (v !== undefined)
+                    clean[k] = v;
+            }
+            result[comp.file][comp.name] = clean;
+        }
+        return result;
+    }
+    /** Load a model from raw file contents (no disk IO) */
+    static loadFromData(questIniContent, dataFileContents, localizationContent) {
+        const questParsed = parseIni(questIniContent);
+        const questSection = questParsed.sections['Quest'] ?? {};
+        const config = {
+            format: questSection.format ? parseInt(questSection.format, 10) : DEFAULT_QUEST_CONFIG.format,
+            type: 'MoM',
+            hidden: questSection.hidden?.toLowerCase() === 'true',
+            defaultlanguage: questSection.defaultlanguage ?? 'English',
+            defaultmusicon: questSection.defaultmusicon?.toLowerCase() !== 'false',
+            difficulty: questSection.difficulty ? parseFloat(questSection.difficulty) : 0.5,
+            lengthmin: questSection.lengthmin ? parseInt(questSection.lengthmin, 10) : 60,
+            lengthmax: questSection.lengthmax ? parseInt(questSection.lengthmax, 10) : 90,
+            image: questSection.image ?? '',
+            version: questSection.version ?? '',
+        };
+        const model = new ScenarioModel(config);
+        // Load components from each data file
+        for (const [filename, content] of Object.entries(dataFileContents)) {
+            const parsed = parseIni(content);
+            for (const [sectionName, sectionData] of Object.entries(parsed.sections)) {
+                // Force file assignment based on source file, not name prefix
+                const comp = {
+                    name: sectionName,
+                    file: filename,
+                    data: { ...sectionData },
+                };
+                model.components.set(sectionName, comp);
+            }
+        }
+        // Load localization
+        if (localizationContent) {
+            model.localization = LocalizationStore.fromCSV(localizationContent);
+        }
+        return model;
+    }
+}
+//# sourceMappingURL=scenario-model.js.map

package/dist/model/scenario-model.js.map

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

package/dist/resources/format-docs.d.ts

@@ -0,0 +1,6 @@
+/** Static markdown documentation exposed as MCP resources */
+export declare const EVENT_FORMAT_DOC = "# Valkyrie Event System\n\n## Overview\nEvents are the core quest logic mechanism. Each event is an INI section starting with \"Event\".\n\n## Fields\n| Field | Type | Description |\n|-------|------|-------------|\n| display | bool | Whether to show dialog (default: true) |\n| buttons | int | Number of buttons (1-6). **CRITICAL**: Valkyrie only parses event1..eventN where N=buttons. If buttons < highest eventN index, higher event references are silently dropped on re-save |\n| event1..6 | string | Space-separated event/spawn names triggered by each button. Only parsed up to the buttons count |\n| trigger | string | Auto-trigger condition: EventStart, Mythos, StartRound, EndRound, Eliminated, DefeatedMonster*, DefeatedCustomMonster* |\n| conditions | string | AND-only variable gating (format: \"var,comparator,value var2,comparator,value2\"). Unlike vartests, conditions are checked BEFORE the event displays \u2014 if false, the event is silently skipped |\n| highlight | bool | Camera focuses on the event's board position |\n| xposition | float | X position on board (for token placement) |\n| yposition | float | Y position on board |\n| operations | string | Space-separated variable operations (e.g., \"$end,=,1\") |\n| vartests | string | Space-separated variable tests (e.g., \"VarOperation:#round,>=,5\") |\n| add | string | Space-separated component names to show |\n| remove | string | Space-separated component names to hide |\n| audio | string | Audio clip name to play |\n| randomevents | bool | Randomly select from event list instead of showing all |\n| quota | int | Success threshold for skill tests |\n| buttoncolor1..6 | string | Skill test button color override (e.g., \"red\") |\n| mincam | bool | Set minimum camera position |\n| maxcam | bool | Set maximum camera position |\n\n## Variable Operations\nFormat: `variable,operator,value`\n- Operators: =, +, -, *, /\n- Special variables: $end (ends scenario), $mythosMinor, $mythosMajor, $mythosDeadly, #round, #heroes\n\n## Variable Tests\nFormat: `VarOperation:variable,comparator,value`\n- Comparators: ==, !=, >, <, >=, <=\n- Logical operators: `VarTestsLogicalOperator:AND`, `VarTestsLogicalOperator:OR`\n\n## Common Patterns\n\n### Buttons vs Event References\nValkyrie only parses event1 through eventN where N = buttons. This means:\n- buttons=2 \u2192 only event1 and event2 are loaded\n- If event3 is set but buttons=2, event3 is **silently ignored and dropped on re-save**\n- Even display=false auto-advancing events need buttons=1 if they have event1\n- buttons=0 is only safe when there are NO eventN fields (e.g. a terminal remove-only event)\n\n### TokenInvestigators Removal\nCommunity quests always remove TokenInvestigators after setup so the start position marker doesn't stay interactable:\n```\nEventSetup: buttons=1, add=TokenInvestigators, event1=EventRemoveInv\nEventRemoveInv: display=false, buttons=0, remove=TokenInvestigators\n```\nNote: EventRemoveInv uses buttons=0 because it has no event1. EventSetup needs buttons=1 for its event1 to be parsed.\n\n## Triggers\n- **EventStart**: Fires when scenario begins\n- **Mythos**: Fires during mythos phase. **IMPORTANT**: Must have buttons>=1, otherwise Valkyrie auto-confirms and skips sub-events entirely\n- **StartRound**: Fires at start of each round\n- **EndRound**: Fires at end of each round\n- **Eliminated**: Fires when all investigators eliminated\n- **DefeatedMonster***: Fires when a specific monster type is defeated (e.g., DefeatedMonsterCultist)\n- **DefeatedCustomMonster***: Fires when a custom monster is defeated (e.g., DefeatedCustomMonsterBoss)\n\n## Button Labels\nSet via localization: `EventName.button1`, `EventName.button2`, etc.\nCommon patterns: `{qst:CONTINUE}`, `{qst:PASS}`, `{qst:FAIL}`\n";
+export declare const LOCALIZATION_FORMAT_DOC = "# Valkyrie Localization Format\n\n## File Format\nCSV-like format with header line.\n\n```\n.,English\nkey,value\nkey,\"value with, commas\"\n```\n\n## Key Patterns\n| Pattern | Example | Description |\n|---------|---------|-------------|\n| quest.name | quest.name | Scenario display name |\n| quest.description | quest.description | Scenario description |\n| quest.authors | quest.authors | Author credits |\n| Component.text | EventStart.text | Main text for component |\n| Component.button1 | EventStart.button1 | Button label |\n| Component.uitext | UIBG.uitext | UI element text |\n| KEYWORD | CONTINUE | Reusable text referenced with {qst:KEYWORD} |\n\n## Substitution Tags\n| Tag | Description |\n|-----|-------------|\n| {qst:KEY} | Reference another localization key |\n| {ffg:KEY} | Reference game content localization |\n| {c:ComponentName} | Reference component display name |\n| {action} | Action icon |\n| {clue} | Clue icon |\n| {strength} | Strength skill icon |\n| {agility} | Agility skill icon |\n| {observation} | Observation skill icon |\n| {lore} | Lore skill icon |\n| {influence} | Influence skill icon |\n| {will} | Will skill icon |\n\n## Newlines\nUse \\n for newlines within values.\n";
+export declare const PATTERN_REFERENCE_DOC = "# Valkyrie Scenario Pattern Reference\n\n## Standard Tile Placement Chain\nEvery tile reveal follows this sequence \u2014 each phase ALWAYS calls the next:\n```\nPlaceTile \u2192 PlaceDecoration \u2192 PlaceConnections \u2192 PlaceItems \u2192 PlacePeople \u2192 MoveOneSpace\n```\n- PlaceTile: add=TileX, display=false, buttons=1\n- PlaceDecoration: add walls/barriers\n- PlaceConnections: add explore tokens to adjacent areas\n- PlaceItems: add search/interact tokens\n- PlacePeople: add spawns/NPCs\n- MoveOneSpace: operations=moveOneSpace,=,1, buttons=0 (terminal)\n\n## Silent Event Rules\n- `display=false` auto-advances without dialog\n- If `event1` is set, MUST have `buttons>=1`\n- `buttons=0` only safe when NO eventN fields exist\n\n## Mythos Initialization Formula\n```\ndeadlyRound = 20 - #heroes\nmajorRound  = deadlyRound / 2\n```\nInitialize in EventStart chain. Use StartRound triggers with `>=` (not `==`) for round checks.\n\n## Event Loop Structure\n```\nInit (set counter=0) \u2192 Controller (vartest counter>=limit) \u2192 Body (increment, loop back) \u2192 Exit\n```\n- Controller event1 (test FAILS) \u2192 Body\n- Controller event2 (test PASSES) \u2192 Exit\n\n## Token Swap Pattern\nReplace tokens in a single silent event:\n```\ndisplay=false, buttons=1, remove=OldToken, add=NewToken, event1=NextEvent\n```\n\n## Variable Types Quick Reference\n| Prefix | Type | Examples |\n|--------|------|----------|\n| (none) | Quest variable | cluesFound, doorUnlocked |\n| $ | System variable | $end, $mythosMinor, $mythosMajor, $mythosDeadly |\n| # | Read-only | #round, #heroes, #heroName, #rand6, #BtT |\n| @ | Trigger | Set by game events |\n\n## Vartests Button Mapping\n- `event1` = test **FAILS** (condition not met)\n- `event2` = test **PASSES** (condition met)\n\n## conditions vs vartests\n| | conditions | vartests |\n|---|-----------|----------|\n| Timing | Before display | After display |\n| False | Silently skipped | Routes to event1 |\n| True | Proceeds | Routes to event2 |\n| Format | var,op,val (AND) | VarOperation:var,op,val |\n\n## UI Layering Order\nElements render in add order. Buttons MUST be added LAST to remain clickable.\nAlways use `vunits=True` for resolution independence.\n\n## Item Distribution Modes\n| Mode | Fields | Behavior |\n|------|--------|----------|\n| Random by trait | traits=weapon | Random item matching trait |\n| Specific item | itemname=ItemCommonKnife | Exact item |\n| Pool | itemname=Item1 Item2 Item3 | Random from list |\n| Trait with exclusion | traits=common, itemname=Excluded1 | Random trait, exclude listed |\n| Starting | starting=True | Given at scenario start |\n\n## Multi-Question Dialogue Structure\nN questions with pass/fail \u2192 2^N permutation events.\nFor 3 questions: Q1 \u2192 Q2(pass/fail) \u2192 Q3(PP/PF/FP/FF) \u2192 8 outcomes.\nAlternative: track successes with a variable, check threshold at end.\n\n## One-Shot Events\nUse `conditions=fired,==,0` to gate, `operations=fired,=,1` in the fire event.\n";
+export declare const COMPONENT_FORMAT_DOC = "# Valkyrie Component Types\n\n## Tiles (tiles.ini)\nPrefix: `Tile`\n| Field | Required | Description |\n|-------|----------|-------------|\n| side | Yes | TileSide name from game content. **Must be a valid catalog ID** \u2014 invalid sides crash Valkyrie |\n| xposition | Yes | X board position |\n| yposition | Yes | Y board position |\n| rotation | No | 0, 90, 180, or 270 degrees |\n\n## Tokens (tokens.ini)\nPrefix: `Token`\n| Field | Required | Description |\n|-------|----------|-------------|\n| type | Yes | TokenSearch, TokenExplore, TokenInteract, TokenInvestigators, TokenWallOutside, TokenWallInside |\n| xposition | Yes | X position |\n| yposition | Yes | Y position |\n| buttons | No | Number of interaction buttons |\n| event1 | No | Event triggered on interaction |\n| conditions | No | AND-only variable gating \u2014 token hidden when false |\n| rotation | No | Rotation for wall tokens |\n\n## Spawns (spawns.ini)\nPrefix: `Spawn`\n| Field | Required | Description |\n|-------|----------|-------------|\n| monster | Yes | Monster type name(s), space-separated |\n| buttons | No | Button count |\n| event1 | No | Next event |\n| conditions | No | AND-only variable gating \u2014 spawn hidden when false |\n| add | No | Space-separated component names to show |\n| uniquehealth | No | Base health override |\n| uniquehealthhero | No | Per-hero health modifier |\n\n## Items (items.ini)\nPrefix: `QItem`\n| Field | Required | Description |\n|-------|----------|-------------|\n| itemname | No | Space-separated catalog item IDs (e.g., ItemCommonKnife, ItemCommonKeroseneLantern). Must use catalog IDs, not display names |\n| starting | No | True if given at start |\n| traits | No | Space-separated: weapon, lightsource, equipment, common, spell |\n| traitpool | No | Alternative trait matching |\n| inspect | No | Event reference triggered on item inspection |\n\n## Puzzles (other.ini)\nPrefix: `Puzzle`\n| Field | Required | Description |\n|-------|----------|-------------|\n| class | No | code, slide, image, tower (default: slide) |\n| skill | No | Skill test: {observation}, {agility}, etc. |\n| conditions | No | AND-only variable gating \u2014 puzzle hidden when false |\n| puzzlelevel | No | Puzzle difficulty level |\n| puzzlealtlevel | No | Alternative difficulty level |\n\n## UI Elements (ui.ini)\nPrefix: `UI`\n| Field | Required | Description |\n|-------|----------|-------------|\n| image | No | Image filename or library ref |\n| size | No | Display size multiplier |\n| vunits | No | Use vertical units |\n\n## Custom Monsters (spawns.ini or monsters.ini)\nPrefix: `CustomMonster`\n| Field | Required | Description |\n|-------|----------|-------------|\n| base | Yes | Base monster type from catalog |\n| health | No | Base health |\n| healthperhero | No | Per-hero health modifier |\n| traits | No | Monster traits |\n";
+//# sourceMappingURL=format-docs.d.ts.map

package/dist/resources/format-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-docs.d.ts","sourceRoot":"","sources":["../../src/resources/format-docs.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,eAAO,MAAM,gBAAgB,qsHAkE5B,CAAC;AAEF,eAAO,MAAM,uBAAuB,ksCAuCnC,CAAC;AAEF,eAAO,MAAM,qBAAqB,k8FA+EjC,CAAC;AAEF,eAAO,MAAM,oBAAoB,2yFAuEhC,CAAC"}

package/dist/resources/format-docs.js

@@ -0,0 +1,261 @@
+/** Static markdown documentation exposed as MCP resources */
+export const EVENT_FORMAT_DOC = `# Valkyrie Event System
+
+## Overview
+Events are the core quest logic mechanism. Each event is an INI section starting with "Event".
+
+## Fields
+| Field | Type | Description |
+|-------|------|-------------|
+| display | bool | Whether to show dialog (default: true) |
+| buttons | int | Number of buttons (1-6). **CRITICAL**: Valkyrie only parses event1..eventN where N=buttons. If buttons < highest eventN index, higher event references are silently dropped on re-save |
+| event1..6 | string | Space-separated event/spawn names triggered by each button. Only parsed up to the buttons count |
+| trigger | string | Auto-trigger condition: EventStart, Mythos, StartRound, EndRound, Eliminated, DefeatedMonster*, DefeatedCustomMonster* |
+| conditions | string | AND-only variable gating (format: "var,comparator,value var2,comparator,value2"). Unlike vartests, conditions are checked BEFORE the event displays — if false, the event is silently skipped |
+| highlight | bool | Camera focuses on the event's board position |
+| xposition | float | X position on board (for token placement) |
+| yposition | float | Y position on board |
+| operations | string | Space-separated variable operations (e.g., "$end,=,1") |
+| vartests | string | Space-separated variable tests (e.g., "VarOperation:#round,>=,5") |
+| add | string | Space-separated component names to show |
+| remove | string | Space-separated component names to hide |
+| audio | string | Audio clip name to play |
+| randomevents | bool | Randomly select from event list instead of showing all |
+| quota | int | Success threshold for skill tests |
+| buttoncolor1..6 | string | Skill test button color override (e.g., "red") |
+| mincam | bool | Set minimum camera position |
+| maxcam | bool | Set maximum camera position |
+
+## Variable Operations
+Format: \`variable,operator,value\`
+- Operators: =, +, -, *, /
+- Special variables: $end (ends scenario), $mythosMinor, $mythosMajor, $mythosDeadly, #round, #heroes
+
+## Variable Tests
+Format: \`VarOperation:variable,comparator,value\`
+- Comparators: ==, !=, >, <, >=, <=
+- Logical operators: \`VarTestsLogicalOperator:AND\`, \`VarTestsLogicalOperator:OR\`
+
+## Common Patterns
+
+### Buttons vs Event References
+Valkyrie only parses event1 through eventN where N = buttons. This means:
+- buttons=2 → only event1 and event2 are loaded
+- If event3 is set but buttons=2, event3 is **silently ignored and dropped on re-save**
+- Even display=false auto-advancing events need buttons=1 if they have event1
+- buttons=0 is only safe when there are NO eventN fields (e.g. a terminal remove-only event)
+
+### TokenInvestigators Removal
+Community quests always remove TokenInvestigators after setup so the start position marker doesn't stay interactable:
+\`\`\`
+EventSetup: buttons=1, add=TokenInvestigators, event1=EventRemoveInv
+EventRemoveInv: display=false, buttons=0, remove=TokenInvestigators
+\`\`\`
+Note: EventRemoveInv uses buttons=0 because it has no event1. EventSetup needs buttons=1 for its event1 to be parsed.
+
+## Triggers
+- **EventStart**: Fires when scenario begins
+- **Mythos**: Fires during mythos phase. **IMPORTANT**: Must have buttons>=1, otherwise Valkyrie auto-confirms and skips sub-events entirely
+- **StartRound**: Fires at start of each round
+- **EndRound**: Fires at end of each round
+- **Eliminated**: Fires when all investigators eliminated
+- **DefeatedMonster***: Fires when a specific monster type is defeated (e.g., DefeatedMonsterCultist)
+- **DefeatedCustomMonster***: Fires when a custom monster is defeated (e.g., DefeatedCustomMonsterBoss)
+
+## Button Labels
+Set via localization: \`EventName.button1\`, \`EventName.button2\`, etc.
+Common patterns: \`{qst:CONTINUE}\`, \`{qst:PASS}\`, \`{qst:FAIL}\`
+`;
+export const LOCALIZATION_FORMAT_DOC = `# Valkyrie Localization Format
+
+## File Format
+CSV-like format with header line.
+
+\`\`\`
+.,English
+key,value
+key,"value with, commas"
+\`\`\`
+
+## Key Patterns
+| Pattern | Example | Description |
+|---------|---------|-------------|
+| quest.name | quest.name | Scenario display name |
+| quest.description | quest.description | Scenario description |
+| quest.authors | quest.authors | Author credits |
+| Component.text | EventStart.text | Main text for component |
+| Component.button1 | EventStart.button1 | Button label |
+| Component.uitext | UIBG.uitext | UI element text |
+| KEYWORD | CONTINUE | Reusable text referenced with {qst:KEYWORD} |
+
+## Substitution Tags
+| Tag | Description |
+|-----|-------------|
+| {qst:KEY} | Reference another localization key |
+| {ffg:KEY} | Reference game content localization |
+| {c:ComponentName} | Reference component display name |
+| {action} | Action icon |
+| {clue} | Clue icon |
+| {strength} | Strength skill icon |
+| {agility} | Agility skill icon |
+| {observation} | Observation skill icon |
+| {lore} | Lore skill icon |
+| {influence} | Influence skill icon |
+| {will} | Will skill icon |
+
+## Newlines
+Use \\n for newlines within values.
+`;
+export const PATTERN_REFERENCE_DOC = `# Valkyrie Scenario Pattern Reference
+
+## Standard Tile Placement Chain
+Every tile reveal follows this sequence — each phase ALWAYS calls the next:
+\`\`\`
+PlaceTile → PlaceDecoration → PlaceConnections → PlaceItems → PlacePeople → MoveOneSpace
+\`\`\`
+- PlaceTile: add=TileX, display=false, buttons=1
+- PlaceDecoration: add walls/barriers
+- PlaceConnections: add explore tokens to adjacent areas
+- PlaceItems: add search/interact tokens
+- PlacePeople: add spawns/NPCs
+- MoveOneSpace: operations=moveOneSpace,=,1, buttons=0 (terminal)
+
+## Silent Event Rules
+- \`display=false\` auto-advances without dialog
+- If \`event1\` is set, MUST have \`buttons>=1\`
+- \`buttons=0\` only safe when NO eventN fields exist
+
+## Mythos Initialization Formula
+\`\`\`
+deadlyRound = 20 - #heroes
+majorRound  = deadlyRound / 2
+\`\`\`
+Initialize in EventStart chain. Use StartRound triggers with \`>=\` (not \`==\`) for round checks.
+
+## Event Loop Structure
+\`\`\`
+Init (set counter=0) → Controller (vartest counter>=limit) → Body (increment, loop back) → Exit
+\`\`\`
+- Controller event1 (test FAILS) → Body
+- Controller event2 (test PASSES) → Exit
+
+## Token Swap Pattern
+Replace tokens in a single silent event:
+\`\`\`
+display=false, buttons=1, remove=OldToken, add=NewToken, event1=NextEvent
+\`\`\`
+
+## Variable Types Quick Reference
+| Prefix | Type | Examples |
+|--------|------|----------|
+| (none) | Quest variable | cluesFound, doorUnlocked |
+| $ | System variable | $end, $mythosMinor, $mythosMajor, $mythosDeadly |
+| # | Read-only | #round, #heroes, #heroName, #rand6, #BtT |
+| @ | Trigger | Set by game events |
+
+## Vartests Button Mapping
+- \`event1\` = test **FAILS** (condition not met)
+- \`event2\` = test **PASSES** (condition met)
+
+## conditions vs vartests
+| | conditions | vartests |
+|---|-----------|----------|
+| Timing | Before display | After display |
+| False | Silently skipped | Routes to event1 |
+| True | Proceeds | Routes to event2 |
+| Format | var,op,val (AND) | VarOperation:var,op,val |
+
+## UI Layering Order
+Elements render in add order. Buttons MUST be added LAST to remain clickable.
+Always use \`vunits=True\` for resolution independence.
+
+## Item Distribution Modes
+| Mode | Fields | Behavior |
+|------|--------|----------|
+| Random by trait | traits=weapon | Random item matching trait |
+| Specific item | itemname=ItemCommonKnife | Exact item |
+| Pool | itemname=Item1 Item2 Item3 | Random from list |
+| Trait with exclusion | traits=common, itemname=Excluded1 | Random trait, exclude listed |
+| Starting | starting=True | Given at scenario start |
+
+## Multi-Question Dialogue Structure
+N questions with pass/fail → 2^N permutation events.
+For 3 questions: Q1 → Q2(pass/fail) → Q3(PP/PF/FP/FF) → 8 outcomes.
+Alternative: track successes with a variable, check threshold at end.
+
+## One-Shot Events
+Use \`conditions=fired,==,0\` to gate, \`operations=fired,=,1\` in the fire event.
+`;
+export const COMPONENT_FORMAT_DOC = `# Valkyrie Component Types
+
+## Tiles (tiles.ini)
+Prefix: \`Tile\`
+| Field | Required | Description |
+|-------|----------|-------------|
+| side | Yes | TileSide name from game content. **Must be a valid catalog ID** — invalid sides crash Valkyrie |
+| xposition | Yes | X board position |
+| yposition | Yes | Y board position |
+| rotation | No | 0, 90, 180, or 270 degrees |
+
+## Tokens (tokens.ini)
+Prefix: \`Token\`
+| Field | Required | Description |
+|-------|----------|-------------|
+| type | Yes | TokenSearch, TokenExplore, TokenInteract, TokenInvestigators, TokenWallOutside, TokenWallInside |
+| xposition | Yes | X position |
+| yposition | Yes | Y position |
+| buttons | No | Number of interaction buttons |
+| event1 | No | Event triggered on interaction |
+| conditions | No | AND-only variable gating — token hidden when false |
+| rotation | No | Rotation for wall tokens |
+
+## Spawns (spawns.ini)
+Prefix: \`Spawn\`
+| Field | Required | Description |
+|-------|----------|-------------|
+| monster | Yes | Monster type name(s), space-separated |
+| buttons | No | Button count |
+| event1 | No | Next event |
+| conditions | No | AND-only variable gating — spawn hidden when false |
+| add | No | Space-separated component names to show |
+| uniquehealth | No | Base health override |
+| uniquehealthhero | No | Per-hero health modifier |
+
+## Items (items.ini)
+Prefix: \`QItem\`
+| Field | Required | Description |
+|-------|----------|-------------|
+| itemname | No | Space-separated catalog item IDs (e.g., ItemCommonKnife, ItemCommonKeroseneLantern). Must use catalog IDs, not display names |
+| starting | No | True if given at start |
+| traits | No | Space-separated: weapon, lightsource, equipment, common, spell |
+| traitpool | No | Alternative trait matching |
+| inspect | No | Event reference triggered on item inspection |
+
+## Puzzles (other.ini)
+Prefix: \`Puzzle\`
+| Field | Required | Description |
+|-------|----------|-------------|
+| class | No | code, slide, image, tower (default: slide) |
+| skill | No | Skill test: {observation}, {agility}, etc. |
+| conditions | No | AND-only variable gating — puzzle hidden when false |
+| puzzlelevel | No | Puzzle difficulty level |
+| puzzlealtlevel | No | Alternative difficulty level |
+
+## UI Elements (ui.ini)
+Prefix: \`UI\`
+| Field | Required | Description |
+|-------|----------|-------------|
+| image | No | Image filename or library ref |
+| size | No | Display size multiplier |
+| vunits | No | Use vertical units |
+
+## Custom Monsters (spawns.ini or monsters.ini)
+Prefix: \`CustomMonster\`
+| Field | Required | Description |
+|-------|----------|-------------|
+| base | Yes | Base monster type from catalog |
+| health | No | Base health |
+| healthperhero | No | Per-hero health modifier |
+| traits | No | Monster traits |
+`;
+//# sourceMappingURL=format-docs.js.map

package/dist/resources/format-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-docs.js","sourceRoot":"","sources":["../../src/resources/format-docs.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkE/B,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCtC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+EpC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEnC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+DpE,wBAAgB,YAAY,IAAI,SAAS,CA+QxC"}