@sharpee/engine 0.9.60-beta

package/dist/story.d.ts

@@ -0,0 +1,211 @@
+/**
+ * Story configuration and interfaces
+ */
+import { WorldModel, IFEntity, IGameEvent, SimpleEventHandler } from '@sharpee/world-model';
+import { LanguageProvider } from '@sharpee/if-domain';
+import { Parser } from '@sharpee/stdlib';
+import { ISemanticEvent } from '@sharpee/core';
+import type { GameEngine } from './game-engine';
+import { NarrativeConfig } from './narrative';
+/**
+ * Story configuration
+ */
+export interface StoryConfig {
+    /**
+     * Story ID
+     */
+    id: string;
+    /**
+     * Story title
+     */
+    title: string;
+    /**
+     * Story author(s)
+     */
+    author: string | string[];
+    /**
+     * Story version
+     */
+    version: string;
+    /**
+     * Story description
+     */
+    description?: string;
+    /**
+     * Website URL
+     */
+    website?: string;
+    /**
+     * Contact email
+     */
+    email?: string;
+    /**
+     * Story tags
+     */
+    tags?: string[];
+    /**
+     * IFID (Interactive Fiction ID)
+     */
+    ifid?: string;
+    /**
+     * License
+     */
+    license?: string;
+    /**
+     * Release date
+     */
+    releaseDate?: string;
+    /**
+     * Custom configuration
+     */
+    custom?: Record<string, any>;
+    /**
+     * Narrative settings (perspective, tense)
+     *
+     * ADR-089: Controls how the story narrates player actions.
+     * Defaults to 2nd person present tense ("You take the lamp").
+     *
+     * @example
+     * // 1st person narrative (Anchorhead-style)
+     * narrative: { perspective: '1st' }
+     *
+     * @example
+     * // 3rd person with specific pronouns
+     * narrative: { perspective: '3rd', playerPronouns: PRONOUNS.SHE_HER }
+     */
+    narrative?: NarrativeConfig;
+    /**
+     * Implicit action settings (ADR-104)
+     *
+     * Controls automatic inference and implicit actions like "first taking".
+     * All default to true.
+     *
+     * @example
+     * // Disable all implicit behavior (strict mode)
+     * implicitActions: { inference: false, implicitTake: false }
+     *
+     * @example
+     * // Allow inference but disable implicit take
+     * implicitActions: { implicitTake: false }
+     */
+    implicitActions?: {
+        /**
+         * Whether to infer alternative targets when pronouns fail requirements.
+         * Example: "read it" (it=mailbox) infers leaflet if only readable thing.
+         * Default: true
+         */
+        inference?: boolean;
+        /**
+         * Whether to automatically take items when actions require holding them.
+         * Example: "read leaflet" auto-takes if not held.
+         * Default: true
+         */
+        implicitTake?: boolean;
+    };
+}
+/**
+ * Custom vocabulary that a story can provide
+ */
+export interface CustomVocabulary {
+    /**
+     * Custom verbs for this story
+     */
+    verbs?: Array<{
+        actionId: string;
+        verbs: string[];
+        pattern?: string;
+        prepositions?: string[];
+    }>;
+    /**
+     * Custom nouns (future expansion)
+     */
+    nouns?: Array<{
+        word: string;
+        entityId?: string;
+        priority?: number;
+    }>;
+    /**
+     * Custom adjectives (future expansion)
+     */
+    adjectives?: Array<{
+        word: string;
+        entityId?: string;
+    }>;
+}
+/**
+ * Story interface - what a story module exports
+ */
+export interface Story {
+    /**
+     * Story configuration
+     */
+    config: StoryConfig;
+    /**
+     * Initialize the world for this story
+     */
+    initializeWorld(world: WorldModel): void;
+    /**
+     * Create the player entity
+     */
+    createPlayer(world: WorldModel): IFEntity;
+    /**
+     * Get custom actions for this story (optional)
+     */
+    getCustomActions?(): any[];
+    /**
+     * Get custom vocabulary for this story (optional)
+     * Called after story initialization to register custom verbs, nouns, etc.
+     */
+    getCustomVocabulary?(): CustomVocabulary;
+    /**
+     * Story-specific initialization (optional)
+     */
+    initialize?(): void;
+    /**
+     * Check if the story is complete (optional)
+     */
+    isComplete?(): boolean;
+    /**
+     * Extend the parser with story-specific vocabulary (optional)
+     */
+    extendParser?(parser: Parser): void;
+    /**
+     * Extend the language provider with story-specific messages (optional)
+     */
+    extendLanguage?(language: LanguageProvider): void;
+    /**
+     * Called after the engine is fully initialized (optional).
+     * Use this to register parsed command transformers or other engine hooks.
+     *
+     * @param engine - The fully initialized game engine
+     */
+    onEngineReady?(engine: GameEngine): void;
+}
+/**
+ * Extended story class with event handling capabilities
+ */
+export declare class StoryWithEvents implements Story {
+    config: StoryConfig;
+    private eventEmitter;
+    constructor(config: StoryConfig);
+    /**
+     * Register a story-level event handler (daemon)
+     */
+    on(eventType: string, handler: SimpleEventHandler): void;
+    /**
+     * Remove a story-level event handler
+     */
+    off(eventType: string, handler: SimpleEventHandler): void;
+    /**
+     * Emit an event to story-level handlers
+     * Returns any semantic events generated by handlers
+     */
+    emit(event: IGameEvent): ISemanticEvent[];
+    initializeWorld(world: WorldModel): void;
+    createPlayer(world: WorldModel): IFEntity;
+}
+/**
+ * Validate story configuration
+ */
+export declare function validateStoryConfig(config: StoryConfig): void;
+//# sourceMappingURL=story.d.ts.map

package/dist/story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.d.ts","sourceRoot":"","sources":["../src/story.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAGhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7B;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,EAAE;QAChB;;;;WAIG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC;QAEpB;;;;WAIG;QACH,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC,CAAC;IAEH;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IAEH;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAAC;IAE1C;;OAEG;IACH,gBAAgB,CAAC,IAAI,GAAG,EAAE,CAAC;IAE3B;;;OAGG;IACH,mBAAmB,CAAC,IAAI,gBAAgB,CAAC;IAEzC;;OAEG;IACH,UAAU,CAAC,IAAI,IAAI,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,cAAc,CAAC,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAElD;;;;;OAKG;IACH,aAAa,CAAC,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,KAAK;IAC3C,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,YAAY,CAAe;gBAEvB,MAAM,EAAE,WAAW;IAK/B;;OAEG;IACH,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAIxD;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAIzD;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,EAAE;IAKzC,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIxC,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ;CAG1C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAU7D"}

package/dist/story.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Story configuration and interfaces
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoryWithEvents = void 0;
+exports.validateStoryConfig = validateStoryConfig;
+const event_emitter_1 = require("./events/event-emitter");
+/**
+ * Extended story class with event handling capabilities
+ */
+class StoryWithEvents {
+    config;
+    eventEmitter;
+    constructor(config) {
+        this.config = config;
+        this.eventEmitter = new event_emitter_1.EventEmitter();
+    }
+    /**
+     * Register a story-level event handler (daemon)
+     */
+    on(eventType, handler) {
+        this.eventEmitter.on(eventType, handler);
+    }
+    /**
+     * Remove a story-level event handler
+     */
+    off(eventType, handler) {
+        this.eventEmitter.off(eventType, handler);
+    }
+    /**
+     * Emit an event to story-level handlers
+     * Returns any semantic events generated by handlers
+     */
+    emit(event) {
+        return this.eventEmitter.emit(event);
+    }
+    // Abstract methods that must be implemented by subclasses
+    initializeWorld(world) {
+        throw new Error('initializeWorld must be implemented');
+    }
+    createPlayer(world) {
+        throw new Error('createPlayer must be implemented');
+    }
+}
+exports.StoryWithEvents = StoryWithEvents;
+/**
+ * Validate story configuration
+ */
+function validateStoryConfig(config) {
+    if (!config.id || !config.title || !config.author || !config.version) {
+        throw new Error('Missing required story configuration fields');
+    }
+    // Validate semantic version
+    const versionRegex = /^\d+\.\d+\.\d+$/;
+    if (!versionRegex.test(config.version)) {
+        throw new Error('Invalid version format. Must be semantic version (e.g., 1.0.0)');
+    }
+}
+//# sourceMappingURL=story.js.map

package/dist/story.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.js","sourceRoot":"","sources":["../src/story.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAoQH,kDAUC;AAzQD,0DAAsD;AAgNtD;;GAEG;AACH,MAAa,eAAe;IAC1B,MAAM,CAAc;IACZ,YAAY,CAAe;IAEnC,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,IAAI,4BAAY,EAAE,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,EAAE,CAAC,SAAiB,EAAE,OAA2B;QAC/C,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAE,OAA2B;QAChD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,KAAiB;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,0DAA0D;IAC1D,eAAe,CAAC,KAAiB;QAC/B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,YAAY,CAAC,KAAiB;QAC5B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;CACF;AAvCD,0CAuCC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAmB;IACrD,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,4BAA4B;IAC5B,MAAM,YAAY,GAAG,iBAAiB,CAAC;IACvC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;AACH,CAAC"}

package/dist/test-helpers/mock-text-service.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Mock text service for testing
+ */
+import type { ITextService } from '@sharpee/text-service';
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+export declare class MockTextService implements ITextService {
+    processTurn(events: ISemanticEvent[]): ITextBlock[];
+}
+export declare function createMockTextService(): ITextService;
+//# sourceMappingURL=mock-text-service.d.ts.map

package/dist/test-helpers/mock-text-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-text-service.d.ts","sourceRoot":"","sources":["../../src/test-helpers/mock-text-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,qBAAa,eAAgB,YAAW,YAAY;IAClD,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE;CAkCpD;AAED,wBAAgB,qBAAqB,IAAI,YAAY,CAEpD"}

package/dist/test-helpers/mock-text-service.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Mock text service for testing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockTextService = void 0;
+exports.createMockTextService = createMockTextService;
+class MockTextService {
+    processTurn(events) {
+        const blocks = [];
+        // Process events
+        for (const event of events) {
+            const data = event.data;
+            if (event.type === 'action.error') {
+                blocks.push({
+                    key: 'error',
+                    content: [String(data?.message || 'Error occurred')],
+                });
+            }
+            else if (event.type === 'action.success') {
+                blocks.push({
+                    key: 'action.result',
+                    content: [`Action completed: ${String(data?.action || 'unknown')}`],
+                });
+            }
+            else if (event.type === 'room.described') {
+                blocks.push({
+                    key: 'room.description',
+                    content: [String(data?.description || 'You are in a room.')],
+                });
+            }
+        }
+        // Default message if no events
+        if (blocks.length === 0) {
+            blocks.push({
+                key: 'game.message',
+                content: ['Nothing happened.'],
+            });
+        }
+        return blocks;
+    }
+}
+exports.MockTextService = MockTextService;
+function createMockTextService() {
+    return new MockTextService();
+}
+//# sourceMappingURL=mock-text-service.js.map

package/dist/test-helpers/mock-text-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-text-service.js","sourceRoot":"","sources":["../../src/test-helpers/mock-text-service.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA2CH,sDAEC;AAvCD,MAAa,eAAe;IAC1B,WAAW,CAAC,MAAwB;QAClC,MAAM,MAAM,GAAiB,EAAE,CAAC;QAEhC,iBAAiB;QACjB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,IAA2B,CAAC;YAC/C,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC;oBACV,GAAG,EAAE,OAAO;oBACZ,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,IAAI,gBAAgB,CAAC,CAAC;iBACrD,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBAC3C,MAAM,CAAC,IAAI,CAAC;oBACV,GAAG,EAAE,eAAe;oBACpB,OAAO,EAAE,CAAC,qBAAqB,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,SAAS,CAAC,EAAE,CAAC;iBACpE,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBAC3C,MAAM,CAAC,IAAI,CAAC;oBACV,GAAG,EAAE,kBAAkB;oBACvB,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,IAAI,oBAAoB,CAAC,CAAC;iBAC7D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC;gBACV,GAAG,EAAE,cAAc;gBACnB,OAAO,EAAE,CAAC,mBAAmB,CAAC;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAnCD,0CAmCC;AAED,SAAgB,qBAAqB;IACnC,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}

package/dist/turn-event-processor.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Turn Event Processor - Processes events during turn execution
+ *
+ * Extracted from GameEngine as part of Phase 4 remediation.
+ * Handles event enrichment, perception filtering, and event emission.
+ */
+import { ISemanticEvent, ISemanticEventSource, IPlatformEvent } from '@sharpee/core';
+import { WorldModel, IFEntity } from '@sharpee/world-model';
+import { IPerceptionService } from '@sharpee/stdlib';
+import { SequencedEvent, EngineConfig } from './types';
+/**
+ * Context for event enrichment - matches EventProcessingContext
+ */
+export interface EnrichmentContext {
+    turn: number;
+    playerId: string;
+    locationId: string | undefined;
+}
+/**
+ * Result of processing events for a turn phase
+ */
+export interface ProcessedEventsResult {
+    /** Processed semantic events */
+    semanticEvents: ISemanticEvent[];
+    /** Platform events that need handling */
+    platformEvents: IPlatformEvent[];
+}
+/**
+ * Callback type for emitting events
+ */
+export type EventEmitCallback = (event: SequencedEvent) => void;
+/**
+ * Callback type for dispatching to entity handlers
+ */
+export type EntityHandlerDispatcher = (event: SequencedEvent) => void;
+/**
+ * Service for processing turn events
+ */
+export declare class TurnEventProcessor {
+    private perceptionService?;
+    constructor(perceptionService?: IPerceptionService | undefined);
+    /**
+     * Process action events from command execution
+     *
+     * @param events - Raw events from command executor
+     * @param enrichmentContext - Context for event enrichment
+     * @param player - Player entity for perception filtering
+     * @param world - World model for perception filtering
+     * @returns Processed events and platform events
+     */
+    processActionEvents(events: SequencedEvent[], enrichmentContext: EnrichmentContext, player: IFEntity, world: WorldModel): ProcessedEventsResult;
+    /**
+     * Process semantic events (e.g., from NPC or scheduler ticks)
+     *
+     * @param events - Semantic events to process
+     * @param enrichmentContext - Context for event enrichment
+     * @param player - Player entity for perception filtering
+     * @param world - World model for perception filtering
+     * @returns Processed events and platform events
+     */
+    processSemanticEvents(events: ISemanticEvent[], enrichmentContext: EnrichmentContext, player: IFEntity, world: WorldModel): ProcessedEventsResult;
+    /**
+     * Emit events through all configured channels
+     *
+     * @param semanticEvents - Events to emit
+     * @param eventSource - Event source for tracking
+     * @param turnEvents - Turn events map to update
+     * @param turn - Current turn number
+     * @param config - Engine config with event callback
+     * @param eventEmitter - Callback for engine event emission
+     * @param entityDispatcher - Optional callback for entity handler dispatch
+     */
+    emitEvents(semanticEvents: ISemanticEvent[], eventSource: ISemanticEventSource, turnEvents: Map<number, ISemanticEvent[]>, turn: number, config: EngineConfig, eventEmitter: EventEmitCallback, entityDispatcher?: EntityHandlerDispatcher): void;
+    /**
+     * Check for victory events in the processed events
+     *
+     * @param events - Events to check
+     * @returns Victory details if found, null otherwise
+     */
+    checkForVictory(events: SequencedEvent[]): {
+        reason: string;
+        score: number;
+    } | null;
+}
+/**
+ * Create a turn event processor instance
+ */
+export declare function createTurnEventProcessor(perceptionService?: IPerceptionService): TurnEventProcessor;
+//# sourceMappingURL=turn-event-processor.d.ts.map

package/dist/turn-event-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-event-processor.d.ts","sourceRoot":"","sources":["../src/turn-event-processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,oBAAoB,EAEpB,cAAc,EACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,yCAAyC;IACzC,cAAc,EAAE,cAAc,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAEtE;;GAEG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,iBAAiB,CAAC;gBAAlB,iBAAiB,CAAC,EAAE,kBAAkB,YAAA;IAGhD;;;;;;;;OAQG;IACH,mBAAmB,CACjB,MAAM,EAAE,cAAc,EAAE,EACxB,iBAAiB,EAAE,iBAAiB,EACpC,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,GAChB,qBAAqB;IAiCxB;;;;;;;;OAQG;IACH,qBAAqB,CACnB,MAAM,EAAE,cAAc,EAAE,EACxB,iBAAiB,EAAE,iBAAiB,EACpC,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,GAChB,qBAAqB;IA8BxB;;;;;;;;;;OAUG;IACH,UAAU,CACR,cAAc,EAAE,cAAc,EAAE,EAChC,WAAW,EAAE,oBAAoB,EACjC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,iBAAiB,EAC/B,gBAAgB,CAAC,EAAE,uBAAuB,GACzC,IAAI;IA4BP;;;;;OAKG;IACH,eAAe,CACb,MAAM,EAAE,cAAc,EAAE,GACvB;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAY5C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,iBAAiB,CAAC,EAAE,kBAAkB,GACrC,kBAAkB,CAEpB"}

package/dist/turn-event-processor.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Turn Event Processor - Processes events during turn execution
+ *
+ * Extracted from GameEngine as part of Phase 4 remediation.
+ * Handles event enrichment, perception filtering, and event emission.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurnEventProcessor = void 0;
+exports.createTurnEventProcessor = createTurnEventProcessor;
+const core_1 = require("@sharpee/core");
+const event_adapter_1 = require("./event-adapter");
+/**
+ * Service for processing turn events
+ */
+class TurnEventProcessor {
+    perceptionService;
+    constructor(perceptionService) {
+        this.perceptionService = perceptionService;
+    }
+    /**
+     * Process action events from command execution
+     *
+     * @param events - Raw events from command executor
+     * @param enrichmentContext - Context for event enrichment
+     * @param player - Player entity for perception filtering
+     * @param world - World model for perception filtering
+     * @returns Processed events and platform events
+     */
+    processActionEvents(events, enrichmentContext, player, world) {
+        // Convert to semantic events and process through pipeline
+        const context = {
+            turn: enrichmentContext.turn,
+            playerId: enrichmentContext.playerId,
+            locationId: enrichmentContext.locationId
+        };
+        let semanticEvents = events.map((e) => {
+            const semantic = (0, event_adapter_1.toSemanticEvent)(e);
+            return (0, event_adapter_1.processEvent)(semantic, context);
+        });
+        // Apply perception filtering if service is configured
+        if (this.perceptionService) {
+            semanticEvents = this.perceptionService.filterEvents(semanticEvents, player, world);
+        }
+        // Check for platform request events
+        const platformEvents = [];
+        for (const event of semanticEvents) {
+            if ((0, core_1.isPlatformRequestEvent)(event)) {
+                platformEvents.push(event);
+            }
+        }
+        return { semanticEvents, platformEvents };
+    }
+    /**
+     * Process semantic events (e.g., from NPC or scheduler ticks)
+     *
+     * @param events - Semantic events to process
+     * @param enrichmentContext - Context for event enrichment
+     * @param player - Player entity for perception filtering
+     * @param world - World model for perception filtering
+     * @returns Processed events and platform events
+     */
+    processSemanticEvents(events, enrichmentContext, player, world) {
+        const context = {
+            turn: enrichmentContext.turn,
+            playerId: enrichmentContext.playerId,
+            locationId: enrichmentContext.locationId
+        };
+        // Process events through the pipeline
+        let semanticEvents = events.map((e) => (0, event_adapter_1.processEvent)(e, context));
+        // Apply perception filtering if service is configured
+        if (this.perceptionService) {
+            semanticEvents = this.perceptionService.filterEvents(semanticEvents, player, world);
+        }
+        // Check for platform request events
+        const platformEvents = [];
+        for (const event of semanticEvents) {
+            if ((0, core_1.isPlatformRequestEvent)(event)) {
+                platformEvents.push(event);
+            }
+        }
+        return { semanticEvents, platformEvents };
+    }
+    /**
+     * Emit events through all configured channels
+     *
+     * @param semanticEvents - Events to emit
+     * @param eventSource - Event source for tracking
+     * @param turnEvents - Turn events map to update
+     * @param turn - Current turn number
+     * @param config - Engine config with event callback
+     * @param eventEmitter - Callback for engine event emission
+     * @param entityDispatcher - Optional callback for entity handler dispatch
+     */
+    emitEvents(semanticEvents, eventSource, turnEvents, turn, config, eventEmitter, entityDispatcher) {
+        // Store events for this turn
+        const existingEvents = turnEvents.get(turn) || [];
+        turnEvents.set(turn, [...existingEvents, ...semanticEvents]);
+        // Track in event source for save/restore
+        for (const event of semanticEvents) {
+            eventSource.emit(event);
+        }
+        // Emit events if configured
+        if (config.onEvent) {
+            for (const event of semanticEvents) {
+                config.onEvent(event);
+            }
+        }
+        // Emit through engine's event system
+        for (const event of semanticEvents) {
+            eventEmitter(event);
+            // Dispatch to entity handlers if provided
+            if (entityDispatcher) {
+                entityDispatcher(event);
+            }
+        }
+    }
+    /**
+     * Check for victory events in the processed events
+     *
+     * @param events - Events to check
+     * @returns Victory details if found, null otherwise
+     */
+    checkForVictory(events) {
+        for (const event of events) {
+            if (event.type === 'story.victory') {
+                const data = event.data;
+                return {
+                    reason: data?.reason || 'Story completed',
+                    score: data?.score || 0
+                };
+            }
+        }
+        return null;
+    }
+}
+exports.TurnEventProcessor = TurnEventProcessor;
+/**
+ * Create a turn event processor instance
+ */
+function createTurnEventProcessor(perceptionService) {
+    return new TurnEventProcessor(perceptionService);
+}
+//# sourceMappingURL=turn-event-processor.js.map

package/dist/turn-event-processor.js.map

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