@sharpee/transcript-tester 0.9.61-beta

package/dist-npm/runner.js

@@ -0,0 +1,977 @@
+"use strict";
+/**
+ * Transcript Runner
+ *
+ * Executes transcript commands against a loaded story and checks results.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTranscript = runTranscript;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const condition_evaluator_1 = require("./condition-evaluator");
+const navigator_1 = require("./navigator");
+// Constants for directive execution
+const MAX_WHILE_ITERATIONS = 100;
+const MAX_BLOCK_DEPTH = 10;
+/**
+ * Run a single transcript against an engine
+ *
+ * If transcript has items (with directives), use the smart runner.
+ * Otherwise, fall back to legacy command-only execution.
+ */
+async function runTranscript(transcript, engine, options = {}) {
+    // Use smart runner if we have items with directives
+    if (transcript.items && transcript.items.length > 0) {
+        const hasDirectives = transcript.items.some(i => i.type === 'directive');
+        if (hasDirectives) {
+            return runSmartTranscript(transcript, engine, options);
+        }
+    }
+    // Legacy: command-only execution
+    const startTime = Date.now();
+    const results = [];
+    for (const command of transcript.commands) {
+        const result = await runCommand(command, engine, options);
+        results.push(result);
+        if (options.stopOnFailure && !result.passed && !result.expectedFailure && !result.skipped) {
+            break;
+        }
+    }
+    const passed = results.filter(r => r.passed && !r.skipped).length;
+    const failed = results.filter(r => !r.passed && !r.expectedFailure && !r.skipped).length;
+    const expectedFailures = results.filter(r => r.expectedFailure).length;
+    const skipped = results.filter(r => r.skipped).length;
+    return {
+        transcript,
+        commands: results,
+        passed,
+        failed,
+        expectedFailures,
+        skipped,
+        duration: Date.now() - startTime
+    };
+}
+/**
+ * Run a transcript with smart directives (IF/WHILE/NAVIGATE/GOAL)
+ */
+async function runSmartTranscript(transcript, engine, options = {}) {
+    const startTime = Date.now();
+    const results = [];
+    const items = transcript.items;
+    // Get player ID for condition evaluation
+    const playerId = getPlayerId(engine);
+    // Block state stack for control flow
+    const blockStack = [];
+    // Main execution loop
+    let i = 0;
+    while (i < items.length) {
+        const item = items[i];
+        // Check if we should skip this item due to inactive block
+        if (blockStack.length > 0 && !blockStack[blockStack.length - 1].active) {
+            // Skip this item, but process END directives to close blocks
+            if (item.type === 'directive') {
+                const handled = await handleEndDirective(item.directive, blockStack, i, items, engine, playerId, options);
+                if (handled.consumed) {
+                    i = handled.nextIndex;
+                    continue;
+                }
+            }
+            i++;
+            continue;
+        }
+        if (item.type === 'command') {
+            // Execute command
+            const result = await runCommand(item.command, engine, options);
+            results.push(result);
+            // Update annotation context for ext-testing
+            if (options.testingExtension?.setCommandContext) {
+                options.testingExtension.setCommandContext(result.command.input, result.actualOutput);
+            }
+            if (options.stopOnFailure && !result.passed && !result.expectedFailure && !result.skipped) {
+                break;
+            }
+            i++;
+        }
+        else if (item.type === 'comment') {
+            // Handle comment annotation for ext-testing
+            if (options.testingExtension?.addAnnotation && item.comment) {
+                options.testingExtension.addAnnotation('comment', item.comment.text, engine.world);
+            }
+            i++;
+        }
+        else if (item.type === 'directive') {
+            const directive = item.directive;
+            const directiveResult = await handleDirective(directive, blockStack, i, items, engine, playerId, options);
+            if (directiveResult.error && options.stopOnFailure) {
+                // Create a synthetic failed result for the directive
+                results.push(createDirectiveFailResult(directive, directiveResult.error));
+                break;
+            }
+            // Add any command results from directive execution (e.g., NAVIGATE)
+            if (directiveResult.commandResults) {
+                results.push(...directiveResult.commandResults);
+            }
+            i = directiveResult.nextIndex;
+        }
+        else {
+            i++;
+        }
+    }
+    const passed = results.filter(r => r.passed && !r.skipped).length;
+    const failed = results.filter(r => !r.passed && !r.expectedFailure && !r.skipped).length;
+    const expectedFailures = results.filter(r => r.expectedFailure).length;
+    const skipped = results.filter(r => r.skipped).length;
+    return {
+        transcript,
+        commands: results,
+        passed,
+        failed,
+        expectedFailures,
+        skipped,
+        duration: Date.now() - startTime
+    };
+}
+/**
+ * Get player entity ID from engine
+ */
+function getPlayerId(engine) {
+    if (engine.world?.getPlayer) {
+        const player = engine.world.getPlayer();
+        return player?.id || 'player';
+    }
+    return 'player';
+}
+/**
+ * Handle a directive (control flow, navigation, goals)
+ */
+async function handleDirective(directive, blockStack, currentIndex, items, engine, playerId, options) {
+    const world = engine.world;
+    const verbose = options.verbose || false;
+    switch (directive.type) {
+        case 'goal': {
+            // Start a goal block
+            if (blockStack.length >= MAX_BLOCK_DEPTH) {
+                return { nextIndex: currentIndex + 1, error: 'Max block depth exceeded' };
+            }
+            // Find REQUIRES and ENSURES for this goal
+            const requires = [];
+            const ensures = [];
+            let j = currentIndex + 1;
+            while (j < items.length) {
+                const nextItem = items[j];
+                if (nextItem.type !== 'directive')
+                    break;
+                const nextDir = nextItem.directive;
+                if (nextDir.type === 'requires' && nextDir.condition) {
+                    requires.push(nextDir.condition);
+                    j++;
+                }
+                else if (nextDir.type === 'ensures' && nextDir.condition) {
+                    ensures.push(nextDir.condition);
+                    j++;
+                }
+                else {
+                    break;
+                }
+            }
+            // Check REQUIRES preconditions
+            let allRequiresMet = true;
+            if (world) {
+                for (const req of requires) {
+                    const result = (0, condition_evaluator_1.evaluateCondition)(req, world, playerId);
+                    if (verbose) {
+                        console.log(`  [GOAL "${directive.goalName}"] REQUIRES: ${req} -> ${result.met ? 'OK' : 'FAILED'}`);
+                    }
+                    if (!result.met) {
+                        allRequiresMet = false;
+                        break;
+                    }
+                }
+            }
+            if (!allRequiresMet) {
+                return {
+                    nextIndex: currentIndex + 1,
+                    error: `Goal "${directive.goalName}" preconditions not met`
+                };
+            }
+            if (verbose) {
+                console.log(`[GOAL: ${directive.goalName}]`);
+            }
+            blockStack.push({
+                type: 'goal',
+                startIndex: j, // Skip past REQUIRES/ENSURES
+                active: true,
+                iterations: 0,
+                goalName: directive.goalName,
+                ensures
+            });
+            return { nextIndex: j };
+        }
+        case 'end_goal': {
+            // End goal block and check ENSURES
+            const block = blockStack.pop();
+            if (!block || block.type !== 'goal') {
+                return { nextIndex: currentIndex + 1, error: 'END GOAL without matching GOAL' };
+            }
+            // Check ENSURES postconditions
+            if (world && block.ensures) {
+                for (const ens of block.ensures) {
+                    const result = (0, condition_evaluator_1.evaluateCondition)(ens, world, playerId);
+                    if (verbose) {
+                        console.log(`  [END GOAL "${block.goalName}"] ENSURES: ${ens} -> ${result.met ? 'OK' : 'FAILED'}`);
+                    }
+                    if (!result.met) {
+                        return {
+                            nextIndex: currentIndex + 1,
+                            error: `Goal "${block.goalName}" postcondition failed: ${ens}`
+                        };
+                    }
+                }
+            }
+            if (verbose) {
+                console.log(`[END GOAL: ${block.goalName}] - Success`);
+            }
+            return { nextIndex: currentIndex + 1 };
+        }
+        case 'requires':
+        case 'ensures':
+            // These are handled as part of GOAL processing
+            return { nextIndex: currentIndex + 1 };
+        case 'if': {
+            if (blockStack.length >= MAX_BLOCK_DEPTH) {
+                return { nextIndex: currentIndex + 1, error: 'Max block depth exceeded' };
+            }
+            let conditionMet = true;
+            if (world && directive.condition) {
+                const result = (0, condition_evaluator_1.evaluateCondition)(directive.condition, world, playerId);
+                conditionMet = result.met;
+                if (verbose) {
+                    console.log(`  [IF: ${directive.condition}] -> ${conditionMet ? 'TRUE' : 'FALSE'} (${result.reason})`);
+                }
+            }
+            blockStack.push({
+                type: 'if',
+                condition: directive.condition,
+                startIndex: currentIndex,
+                active: conditionMet,
+                iterations: 0
+            });
+            return { nextIndex: currentIndex + 1 };
+        }
+        case 'end_if': {
+            const block = blockStack.pop();
+            if (!block || block.type !== 'if') {
+                return { nextIndex: currentIndex + 1, error: 'END IF without matching IF' };
+            }
+            return { nextIndex: currentIndex + 1 };
+        }
+        case 'while': {
+            if (blockStack.length >= MAX_BLOCK_DEPTH) {
+                return { nextIndex: currentIndex + 1, error: 'Max block depth exceeded' };
+            }
+            let conditionMet = true;
+            if (world && directive.condition) {
+                const result = (0, condition_evaluator_1.evaluateCondition)(directive.condition, world, playerId);
+                conditionMet = result.met;
+                if (verbose) {
+                    console.log(`  [WHILE: ${directive.condition}] -> ${conditionMet ? 'TRUE (entering loop)' : 'FALSE (skipping loop)'}`);
+                }
+            }
+            blockStack.push({
+                type: 'while',
+                condition: directive.condition,
+                startIndex: currentIndex,
+                active: conditionMet,
+                iterations: 0
+            });
+            return { nextIndex: currentIndex + 1 };
+        }
+        case 'end_while': {
+            const block = blockStack[blockStack.length - 1];
+            if (!block || block.type !== 'while') {
+                blockStack.pop();
+                return { nextIndex: currentIndex + 1, error: 'END WHILE without matching WHILE' };
+            }
+            block.iterations++;
+            if (block.iterations >= MAX_WHILE_ITERATIONS) {
+                blockStack.pop();
+                return { nextIndex: currentIndex + 1, error: `WHILE loop exceeded ${MAX_WHILE_ITERATIONS} iterations` };
+            }
+            // Re-evaluate condition
+            let conditionMet = false;
+            if (world && block.condition) {
+                const result = (0, condition_evaluator_1.evaluateCondition)(block.condition, world, playerId);
+                conditionMet = result.met;
+                if (verbose) {
+                    console.log(`  [END WHILE iteration ${block.iterations}] ${block.condition} -> ${conditionMet ? 'TRUE (continue)' : 'FALSE (exit loop)'}`);
+                }
+            }
+            if (conditionMet) {
+                // Loop back to after WHILE directive
+                return { nextIndex: block.startIndex + 1 };
+            }
+            else {
+                // Exit loop
+                blockStack.pop();
+                return { nextIndex: currentIndex + 1 };
+            }
+        }
+        case 'navigate': {
+            if (!world || !directive.target) {
+                return { nextIndex: currentIndex + 1, error: 'NAVIGATE requires world model and target' };
+            }
+            if (verbose) {
+                console.log(`[NAVIGATE TO: "${directive.target}"]`);
+            }
+            const navResult = await (0, navigator_1.executeNavigate)(directive.target, world, engine, playerId, verbose);
+            if (!navResult.success) {
+                return {
+                    nextIndex: currentIndex + 1,
+                    error: navResult.error || `Navigation to "${directive.target}" failed`
+                };
+            }
+            // Create synthetic command results for the navigation commands
+            const commandResults = navResult.commands.map((cmd, idx) => ({
+                command: {
+                    lineNumber: directive.lineNumber,
+                    input: cmd,
+                    expectedOutput: [],
+                    assertions: []
+                },
+                actualOutput: `(navigated: ${navResult.path[idx] || '?'} -> ${navResult.path[idx + 1] || directive.target})`,
+                actualEvents: [],
+                passed: true,
+                expectedFailure: false,
+                skipped: false,
+                assertionResults: []
+            }));
+            return { nextIndex: currentIndex + 1, commandResults };
+        }
+        case 'save': {
+            if (!world || !directive.saveName) {
+                return { nextIndex: currentIndex + 1, error: 'SAVE requires world model and save name' };
+            }
+            if (verbose) {
+                console.log(`[$save ${directive.saveName}]`);
+            }
+            try {
+                // Get save directory from options or use default
+                const savesDir = options.savesDirectory || './saves';
+                // Ensure directory exists
+                if (!fs.existsSync(savesDir)) {
+                    fs.mkdirSync(savesDir, { recursive: true });
+                }
+                // Serialize world state
+                const worldState = world.toJSON();
+                // Write to file
+                const savePath = path.join(savesDir, `${directive.saveName}.json`);
+                fs.writeFileSync(savePath, worldState, 'utf-8');
+                if (verbose) {
+                    console.log(`  Saved to: ${savePath}`);
+                }
+            }
+            catch (e) {
+                return {
+                    nextIndex: currentIndex + 1,
+                    error: `Failed to save "${directive.saveName}": ${e instanceof Error ? e.message : String(e)}`
+                };
+            }
+            return { nextIndex: currentIndex + 1 };
+        }
+        case 'restore': {
+            if (!world || !directive.saveName) {
+                return { nextIndex: currentIndex + 1, error: 'RESTORE requires world model and save name' };
+            }
+            if (verbose) {
+                console.log(`[$restore ${directive.saveName}]`);
+            }
+            try {
+                // Get save directory from options or use default
+                const savesDir = options.savesDirectory || './saves';
+                const savePath = path.join(savesDir, `${directive.saveName}.json`);
+                // Check file exists
+                if (!fs.existsSync(savePath)) {
+                    return {
+                        nextIndex: currentIndex + 1,
+                        error: `Save file not found: ${savePath}`
+                    };
+                }
+                // Read and restore world state
+                const worldState = fs.readFileSync(savePath, 'utf-8');
+                world.loadJSON(worldState);
+                if (verbose) {
+                    console.log(`  Restored from: ${savePath}`);
+                }
+            }
+            catch (e) {
+                return {
+                    nextIndex: currentIndex + 1,
+                    error: `Failed to restore "${directive.saveName}": ${e instanceof Error ? e.message : String(e)}`
+                };
+            }
+            return { nextIndex: currentIndex + 1 };
+        }
+        case 'test-command': {
+            // Execute ext-testing command ($teleport, $take, $kill, etc.)
+            if (!directive.testCommand) {
+                return { nextIndex: currentIndex + 1, error: 'Test command missing' };
+            }
+            if (!options.testingExtension) {
+                // No testing extension available - warn and skip
+                if (verbose) {
+                    console.log(`  [${directive.testCommand}] - skipped (no testing extension)`);
+                }
+                return { nextIndex: currentIndex + 1 };
+            }
+            if (!world) {
+                return { nextIndex: currentIndex + 1, error: 'World model not available for test command' };
+            }
+            if (verbose) {
+                console.log(`[${directive.testCommand}]`);
+            }
+            try {
+                const result = options.testingExtension.executeTestCommand(directive.testCommand, world);
+                if (verbose) {
+                    if (result.output.length > 0) {
+                        for (const line of result.output) {
+                            console.log(`  ${line}`);
+                        }
+                    }
+                    if (result.error) {
+                        console.log(`  ERROR: ${result.error}`);
+                    }
+                }
+                if (!result.success) {
+                    return {
+                        nextIndex: currentIndex + 1,
+                        error: result.error || `Test command failed: ${directive.testCommand}`
+                    };
+                }
+            }
+            catch (e) {
+                return {
+                    nextIndex: currentIndex + 1,
+                    error: `Test command error: ${e instanceof Error ? e.message : String(e)}`
+                };
+            }
+            return { nextIndex: currentIndex + 1 };
+        }
+        default:
+            return { nextIndex: currentIndex + 1 };
+    }
+}
+/**
+ * Handle END directives when in inactive block (for proper nesting)
+ */
+async function handleEndDirective(directive, blockStack, currentIndex, items, engine, playerId, options) {
+    switch (directive.type) {
+        case 'end_if':
+            if (blockStack.length > 0 && blockStack[blockStack.length - 1].type === 'if') {
+                blockStack.pop();
+                return { consumed: true, nextIndex: currentIndex + 1 };
+            }
+            break;
+        case 'end_while':
+            if (blockStack.length > 0 && blockStack[blockStack.length - 1].type === 'while') {
+                blockStack.pop();
+                return { consumed: true, nextIndex: currentIndex + 1 };
+            }
+            break;
+        case 'end_goal':
+            if (blockStack.length > 0 && blockStack[blockStack.length - 1].type === 'goal') {
+                blockStack.pop();
+                return { consumed: true, nextIndex: currentIndex + 1 };
+            }
+            break;
+        // Handle nested block starts within inactive blocks
+        case 'if':
+        case 'while':
+        case 'goal':
+            // Push inactive block to maintain proper nesting
+            blockStack.push({
+                type: directive.type === 'goal' ? 'goal' : directive.type,
+                startIndex: currentIndex,
+                active: false,
+                iterations: 0
+            });
+            return { consumed: true, nextIndex: currentIndex + 1 };
+    }
+    return { consumed: false, nextIndex: currentIndex + 1 };
+}
+/**
+ * Create a synthetic failed result for a directive error
+ */
+function createDirectiveFailResult(directive, error) {
+    return {
+        command: {
+            lineNumber: directive.lineNumber,
+            input: `[${directive.type.toUpperCase()}${directive.condition ? ': ' + directive.condition : ''}${directive.target ? ': "' + directive.target + '"' : ''}]`,
+            expectedOutput: [],
+            assertions: []
+        },
+        actualOutput: '',
+        actualEvents: [],
+        passed: false,
+        expectedFailure: false,
+        skipped: false,
+        assertionResults: [],
+        error
+    };
+}
+/**
+ * Run a single command and check assertions
+ */
+async function runCommand(command, engine, options) {
+    // Check for skip/todo first
+    const skipAssertion = command.assertions.find(a => a.type === 'skip' || a.type === 'todo');
+    if (skipAssertion) {
+        return {
+            command,
+            actualOutput: '',
+            actualEvents: [],
+            passed: true,
+            expectedFailure: false,
+            skipped: true,
+            assertionResults: [{
+                    assertion: skipAssertion,
+                    passed: true,
+                    message: skipAssertion.reason || 'Skipped'
+                }]
+        };
+    }
+    // Execute the command
+    let actualOutput;
+    let actualEvents = [];
+    let error;
+    try {
+        const result = await engine.executeCommand(command.input);
+        actualOutput = typeof result === 'string' ? result : (engine.getOutput?.() || '');
+        // Capture events from the engine (filter out system.* debug events)
+        if (engine.lastEvents) {
+            actualEvents = engine.lastEvents
+                .filter(e => !e.type.startsWith('system.'))
+                .map(e => ({
+                type: e.type,
+                data: e.data || {}
+            }));
+        }
+    }
+    catch (e) {
+        actualOutput = '';
+        error = e instanceof Error ? e.message : String(e);
+    }
+    // Normalize output for comparison
+    const normalizedActual = normalizeOutput(actualOutput);
+    const normalizedExpected = normalizeOutput(command.expectedOutput.join('\n'));
+    // Check all assertions
+    const assertionResults = [];
+    let allPassed = true;
+    for (const assertion of command.assertions) {
+        const result = checkAssertion(assertion, normalizedActual, normalizedExpected, actualEvents, engine.world);
+        assertionResults.push(result);
+        if (!result.passed) {
+            allPassed = false;
+        }
+    }
+    // Check for expected failure
+    const failAssertion = command.assertions.find(a => a.type === 'fail');
+    const expectedFailure = failAssertion !== undefined;
+    // For [FAIL] assertions, invert the logic
+    if (expectedFailure) {
+        return {
+            command,
+            actualOutput,
+            actualEvents,
+            passed: !allPassed, // Pass if assertions failed (as expected)
+            expectedFailure: true,
+            skipped: false,
+            assertionResults,
+            error
+        };
+    }
+    return {
+        command,
+        actualOutput,
+        actualEvents,
+        passed: allPassed && !error,
+        expectedFailure: false,
+        skipped: false,
+        assertionResults,
+        error
+    };
+}
+/**
+ * Check a single assertion against actual output, events, and world state
+ */
+function checkAssertion(assertion, actualOutput, expectedOutput, events, world) {
+    switch (assertion.type) {
+        case 'ok':
+            // Exact match (after normalization)
+            const matches = actualOutput === expectedOutput;
+            return {
+                assertion,
+                passed: matches,
+                message: matches ? undefined : `Output did not match expected`
+            };
+        case 'ok-contains':
+            const contains = actualOutput.toLowerCase().includes(assertion.value.toLowerCase());
+            return {
+                assertion,
+                passed: contains,
+                message: contains ? undefined : `Output does not contain "${assertion.value}"`
+            };
+        case 'ok-not-contains':
+            const notContains = !actualOutput.toLowerCase().includes(assertion.value.toLowerCase());
+            return {
+                assertion,
+                passed: notContains,
+                message: notContains ? undefined : `Output should not contain "${assertion.value}"`
+            };
+        case 'ok-matches':
+            const regexMatches = assertion.pattern.test(actualOutput);
+            return {
+                assertion,
+                passed: regexMatches,
+                message: regexMatches ? undefined : `Output does not match pattern ${assertion.pattern}`
+            };
+        case 'fail':
+            // This is handled at the command level
+            return {
+                assertion,
+                passed: false,
+                message: assertion.reason
+            };
+        case 'skip':
+        case 'todo':
+            return {
+                assertion,
+                passed: true,
+                message: assertion.reason
+            };
+        case 'event-count': {
+            const expected = assertion.eventCount || 0;
+            const actual = events.length;
+            const countMatches = actual === expected;
+            return {
+                assertion,
+                passed: countMatches,
+                message: countMatches ? undefined : `Expected ${expected} events, got ${actual}`
+            };
+        }
+        case 'event-assert': {
+            return checkEventAssertion(assertion, events);
+        }
+        case 'state-assert': {
+            return checkStateAssertion(assertion, world);
+        }
+        default:
+            return {
+                assertion,
+                passed: false,
+                message: `Unknown assertion type: ${assertion.type}`
+            };
+    }
+}
+/**
+ * Check an event assertion (assertTrue/assertFalse for event existence/properties)
+ */
+function checkEventAssertion(assertion, events) {
+    const { assertTrue, eventPosition, eventType, eventData } = assertion;
+    // Helper to check if an event matches
+    const eventMatches = (event) => {
+        if (event.type !== eventType)
+            return false;
+        if (eventData) {
+            for (const [key, value] of Object.entries(eventData)) {
+                if (event.data[key] !== value)
+                    return false;
+            }
+        }
+        return true;
+    };
+    let found = false;
+    let actualEvent;
+    if (eventPosition !== undefined) {
+        // Check specific position (1-based)
+        const index = eventPosition - 1;
+        if (index >= 0 && index < events.length) {
+            actualEvent = events[index];
+            found = eventMatches(actualEvent);
+        }
+    }
+    else {
+        // Check any position
+        actualEvent = events.find(eventMatches);
+        found = actualEvent !== undefined;
+    }
+    // Apply assertTrue/assertFalse logic
+    const passed = assertTrue ? found : !found;
+    // Build message
+    let message;
+    if (!passed) {
+        if (assertTrue) {
+            // Expected to find but didn't
+            if (eventPosition !== undefined) {
+                const actualAtPos = events[eventPosition - 1];
+                if (actualAtPos) {
+                    message = `Event ${eventPosition}: expected ${eventType}, got ${actualAtPos.type}`;
+                    if (eventData) {
+                        message += `. Expected data: ${JSON.stringify(eventData)}, got: ${JSON.stringify(actualAtPos.data)}`;
+                    }
+                }
+                else {
+                    message = `Event ${eventPosition}: position out of range (${events.length} events total)`;
+                }
+            }
+            else {
+                message = `No event matching ${eventType}`;
+                if (eventData) {
+                    message += ` with ${JSON.stringify(eventData)}`;
+                }
+                message += `. Events: ${events.map(e => e.type).join(', ')}`;
+            }
+        }
+        else {
+            // Expected NOT to find but did
+            message = `Event ${eventType} should not exist but was found`;
+            if (eventData) {
+                message += ` with matching data ${JSON.stringify(eventData)}`;
+            }
+        }
+    }
+    return { assertion, passed, message };
+}
+/**
+ * Check a state assertion against the world model
+ */
+function checkStateAssertion(assertion, world) {
+    const { assertTrue, stateExpression } = assertion;
+    if (!world) {
+        return {
+            assertion,
+            passed: false,
+            message: 'World model not available for state assertions'
+        };
+    }
+    if (!stateExpression) {
+        return {
+            assertion,
+            passed: false,
+            message: 'No state expression provided'
+        };
+    }
+    try {
+        const result = evaluateStateExpression(stateExpression, world);
+        const passed = assertTrue ? result.matches : !result.matches;
+        let message;
+        if (!passed) {
+            if (assertTrue) {
+                message = `State assertion failed: ${stateExpression}. ${result.details || ''}`;
+            }
+            else {
+                message = `State assertion should be false but was true: ${stateExpression}`;
+            }
+        }
+        return { assertion, passed, message };
+    }
+    catch (e) {
+        return {
+            assertion,
+            passed: false,
+            message: `Error evaluating state expression: ${e instanceof Error ? e.message : String(e)}`
+        };
+    }
+}
+/**
+ * Evaluate a state expression against the world model
+ * Supports: entity.property = value, entity.property != value,
+ *           collection contains item, collection not-contains item
+ */
+function evaluateStateExpression(expression, world) {
+    // Parse "entity.property = value" or "entity.property != value"
+    const equalityMatch = expression.match(/^(\w+)\.(\w+)\s*(=|!=)\s*(.+)$/);
+    if (equalityMatch) {
+        const [, entityName, property, operator, expectedValue] = equalityMatch;
+        // Find entity by name
+        const entity = findEntity(entityName, world);
+        if (!entity) {
+            return { matches: false, details: `Entity "${entityName}" not found` };
+        }
+        // Get property value
+        const actualValue = getEntityProperty(entity, property, world);
+        const expectedResolved = resolveValue(expectedValue.trim(), world);
+        const isEqual = actualValue === expectedResolved ||
+            (actualValue?.id && actualValue.id === expectedResolved) ||
+            (typeof expectedResolved === 'string' && actualValue?.id === expectedResolved);
+        if (operator === '=') {
+            return {
+                matches: isEqual,
+                details: isEqual ? undefined : `${entityName}.${property} is "${actualValue?.id || actualValue}", expected "${expectedResolved}"`
+            };
+        }
+        else {
+            return {
+                matches: !isEqual,
+                details: !isEqual ? undefined : `${entityName}.${property} should not be "${expectedResolved}"`
+            };
+        }
+    }
+    // Parse "collection contains item" or "collection not-contains item"
+    const containsMatch = expression.match(/^(\w+)\.(\w+)\s+(contains|not-contains)\s+(.+)$/);
+    if (containsMatch) {
+        const [, entityName, property, operator, itemName] = containsMatch;
+        const entity = findEntity(entityName, world);
+        if (!entity) {
+            return { matches: false, details: `Entity "${entityName}" not found` };
+        }
+        const collection = getEntityProperty(entity, property, world);
+        if (!Array.isArray(collection)) {
+            return { matches: false, details: `${entityName}.${property} is not a collection` };
+        }
+        const item = findEntity(itemName.trim(), world);
+        const itemId = item?.id || itemName.trim();
+        const hasItem = collection.some((c) => c === itemId || c?.id === itemId);
+        if (operator === 'contains') {
+            return { matches: hasItem, details: hasItem ? undefined : `${entityName}.${property} does not contain "${itemName}"` };
+        }
+        else {
+            return { matches: !hasItem, details: !hasItem ? undefined : `${entityName}.${property} should not contain "${itemName}"` };
+        }
+    }
+    return { matches: false, details: `Could not parse expression: ${expression}` };
+}
+/**
+ * Find an entity by name in the world model
+ */
+function findEntity(name, world) {
+    // Try findEntityByName first
+    if (world.findEntityByName) {
+        const entity = world.findEntityByName(name);
+        if (entity)
+            return entity;
+    }
+    // Try getEntity/getEntityById
+    if (world.getEntity) {
+        const entity = world.getEntity(name);
+        if (entity)
+            return entity;
+    }
+    if (world.getEntityById) {
+        const entity = world.getEntityById(name);
+        if (entity)
+            return entity;
+    }
+    // Search all entities by name/alias
+    if (world.getAllEntities) {
+        const entities = world.getAllEntities();
+        for (const entity of entities) {
+            if (entity.name === name || entity.id === name)
+                return entity;
+            // Check identity trait for aliases
+            const identity = entity.traits?.identity || entity.get?.('IdentityTrait');
+            if (identity) {
+                if (identity.name === name)
+                    return entity;
+                if (identity.aliases?.includes(name))
+                    return entity;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Get a property from an entity (world needed for spatial queries)
+ */
+function getEntityProperty(entity, property, world) {
+    // Special handling for location - use world.getLocation()
+    if (property === 'location') {
+        if (world?.getLocation) {
+            return world.getLocation(entity.id);
+        }
+        return entity.location || entity.containerId;
+    }
+    // Special handling for contents - use world.getContents()
+    if (property === 'contents' || property === 'inventory') {
+        if (world?.getContents) {
+            return world.getContents(entity.id);
+        }
+        return entity.contents || entity.inventory || [];
+    }
+    // Direct property access
+    if (property in entity) {
+        return entity[property];
+    }
+    // Check traits
+    if (entity.traits && property in entity.traits) {
+        return entity.traits[property];
+    }
+    return undefined;
+}
+/**
+ * Resolve a value (could be entity name, literal, etc.)
+ */
+function resolveValue(value, world) {
+    // Check if it's an entity reference
+    const entity = findEntity(value, world);
+    if (entity) {
+        return entity.id;
+    }
+    // Check for special values
+    if (value === 'null' || value === 'undefined' || value === 'nowhere') {
+        return undefined;
+    }
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    // Return as string
+    return value;
+}
+/**
+ * Normalize output for comparison
+ * - Trim whitespace
+ * - Normalize line endings
+ * - Collapse multiple spaces
+ */
+function normalizeOutput(output) {
+    return output
+        .replace(/\r\n/g, '\n')
+        .split('\n')
+        .map(line => line.trim())
+        .join('\n')
+        .trim();
+}
+//# sourceMappingURL=runner.js.map