@sharpee/engine 0.9.60-beta

package/dist/event-sequencer.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Event Sequencer - Manages event ordering within turns
+ *
+ * Ensures all events have proper sequence numbers for ordering
+ * and grouping within a turn.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventSequencer = exports.EventSequenceUtils = void 0;
+/**
+ * Event sequencer class
+ */
+class EventSequencer {
+    counter = Date.now();
+    /**
+     * Get next sequence number
+     */
+    next() {
+        return ++this.counter;
+    }
+    /**
+     * Reset turn counter (optional, for testing)
+     */
+    resetTurn(turn) {
+        // No-op in this implementation
+    }
+    /**
+     * Sequence a single event
+     */
+    sequence(event, turn) {
+        return {
+            ...event,
+            sequence: this.next(),
+            timestamp: new Date(),
+            turn,
+            scope: 'turn'
+        };
+    }
+    /**
+     * Sequence multiple events
+     */
+    sequenceAll(events, turn) {
+        return events.map(event => this.sequence(event, turn));
+    }
+}
+/**
+ * Event sequence utilities
+ */
+class EventSequenceUtils {
+    /**
+     * Sort events by sequence number
+     */
+    static sort(events) {
+        return [...events].sort((a, b) => a.sequence - b.sequence);
+    }
+    /**
+     * Filter events by type
+     */
+    static filterByType(events, type) {
+        return events.filter(e => e.type === type);
+    }
+    /**
+     * Filter events by turn
+     */
+    static filterByTurn(events, turn) {
+        return events.filter(e => e.turn === turn);
+    }
+    /**
+     * Filter events by scope
+     */
+    static filterByScope(events, scope) {
+        return events.filter(e => e.scope === scope);
+    }
+    /**
+     * Group events by type
+     */
+    static groupByType(events) {
+        const groups = {};
+        for (const event of events) {
+            if (!groups[event.type]) {
+                groups[event.type] = [];
+            }
+            groups[event.type].push(event);
+        }
+        return groups;
+    }
+    /**
+     * Group events by turn
+     */
+    static groupByTurn(events) {
+        const groups = {};
+        for (const event of events) {
+            if (!groups[event.turn]) {
+                groups[event.turn] = [];
+            }
+            groups[event.turn].push(event);
+        }
+        return groups;
+    }
+    /**
+     * Get latest event by type
+     */
+    static getLatestByType(events, type) {
+        const filtered = this.filterByType(events, type);
+        if (filtered.length === 0)
+            return undefined;
+        return filtered.reduce((latest, current) => current.sequence > latest.sequence ? current : latest);
+    }
+    /**
+     * Count events by type
+     */
+    static countByType(events) {
+        const counts = {};
+        for (const event of events) {
+            counts[event.type] = (counts[event.type] || 0) + 1;
+        }
+        return counts;
+    }
+    /**
+     * Get events in sequence range
+     */
+    static getInRange(events, start, end, inclusive = true) {
+        if (inclusive) {
+            return events.filter(e => e.sequence >= start && e.sequence <= end);
+        }
+        else {
+            return events.filter(e => e.sequence > start && e.sequence < end);
+        }
+    }
+}
+exports.EventSequenceUtils = EventSequenceUtils;
+// Export singleton instance
+exports.eventSequencer = new EventSequencer();
+//# sourceMappingURL=event-sequencer.js.map

package/dist/event-sequencer.js.map

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

package/dist/events/event-emitter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Event emitter for managing game events
+ */
+import { ISemanticEvent } from '@sharpee/core';
+import { IGameEvent, SimpleEventHandler } from '@sharpee/world-model';
+/**
+ * Simple event emitter for the game event system
+ * Used for story-level event handlers (daemons)
+ */
+export declare class EventEmitter {
+    private handlers;
+    /**
+     * Register a handler for an event type
+     */
+    on(eventType: string, handler: SimpleEventHandler): void;
+    /**
+     * Remove a handler for an event type
+     */
+    off(eventType: string, handler: SimpleEventHandler): void;
+    /**
+     * Emit an event to all registered handlers
+     * Returns any semantic events generated by handlers
+     */
+    emit(event: IGameEvent): ISemanticEvent[];
+    /**
+     * Clear all handlers for a specific event type
+     */
+    clear(eventType?: string): void;
+    /**
+     * Get count of handlers for an event type
+     */
+    listenerCount(eventType: string): number;
+}
+//# sourceMappingURL=event-emitter.d.ts.map

package/dist/events/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../src/events/event-emitter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEtE;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAgD;IAEhE;;OAEG;IACH,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAMxD;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAUzD;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,EAAE;IAczC;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ/B;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAGzC"}

package/dist/events/event-emitter.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Event emitter for managing game events
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventEmitter = void 0;
+/**
+ * Simple event emitter for the game event system
+ * Used for story-level event handlers (daemons)
+ */
+class EventEmitter {
+    handlers = new Map();
+    /**
+     * Register a handler for an event type
+     */
+    on(eventType, handler) {
+        const handlers = this.handlers.get(eventType) || [];
+        handlers.push(handler);
+        this.handlers.set(eventType, handlers);
+    }
+    /**
+     * Remove a handler for an event type
+     */
+    off(eventType, handler) {
+        const handlers = this.handlers.get(eventType);
+        if (handlers) {
+            const index = handlers.indexOf(handler);
+            if (index !== -1) {
+                handlers.splice(index, 1);
+            }
+        }
+    }
+    /**
+     * Emit an event to all registered handlers
+     * Returns any semantic events generated by handlers
+     */
+    emit(event) {
+        const results = [];
+        const handlers = this.handlers.get(event.type) || [];
+        for (const handler of handlers) {
+            const result = handler(event);
+            if (result) {
+                results.push(...result);
+            }
+        }
+        return results;
+    }
+    /**
+     * Clear all handlers for a specific event type
+     */
+    clear(eventType) {
+        if (eventType) {
+            this.handlers.delete(eventType);
+        }
+        else {
+            this.handlers.clear();
+        }
+    }
+    /**
+     * Get count of handlers for an event type
+     */
+    listenerCount(eventType) {
+        return this.handlers.get(eventType)?.length || 0;
+    }
+}
+exports.EventEmitter = EventEmitter;
+//# sourceMappingURL=event-emitter.js.map

package/dist/events/event-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.js","sourceRoot":"","sources":["../../src/events/event-emitter.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH;;;GAGG;AACH,MAAa,YAAY;IACf,QAAQ,GAAsC,IAAI,GAAG,EAAE,CAAC;IAEhE;;OAEG;IACH,EAAE,CAAC,SAAiB,EAAE,OAA2B;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAE,OAA2B;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,KAAiB;QACpB,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAErD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAkB;QACtB,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IACnD,CAAC;CACF;AA5DD,oCA4DC"}

package/dist/game-engine.d.ts

@@ -0,0 +1,292 @@
+/**
+ * Game Engine - Main runtime for Sharpee IF games
+ *
+ * Manages game state, turn execution, and coordinates all subsystems
+ */
+import { WorldModel, IFEntity } from '@sharpee/world-model';
+import { EventProcessor } from '@sharpee/event-processor';
+import { Parser, IPerceptionService } from '@sharpee/stdlib';
+import { LanguageProvider } from '@sharpee/if-domain';
+import { ITextService } from '@sharpee/text-service';
+import { ISemanticEvent, ISaveRestoreHooks, ISemanticEventSource } from '@sharpee/core';
+import { ISchedulerService } from './scheduler';
+import { INpcService } from '@sharpee/stdlib';
+import { GameContext, TurnResult, EngineConfig, SequencedEvent } from './types';
+import { Story } from './story';
+import { NarrativeSettings } from './narrative';
+import { ParsedCommandTransformer } from './command-executor';
+/**
+ * Game engine events
+ */
+export interface GameEngineEvents {
+    'turn:start': (turn: number, input: string) => void;
+    'turn:complete': (result: TurnResult) => void;
+    'turn:failed': (error: Error, turn: number) => void;
+    'event': (event: SequencedEvent) => void;
+    'state:changed': (context: GameContext) => void;
+    'game:over': (context: GameContext) => void;
+    'text:output': (text: string, turn: number) => void;
+    'text:channel': (channel: string, text: string, turn: number) => void;
+}
+type GameEngineEventName = keyof GameEngineEvents;
+type GameEngineEventListener<K extends GameEngineEventName> = GameEngineEvents[K];
+/**
+ * Main game engine
+ */
+export declare class GameEngine {
+    private world;
+    private sessionStartTime?;
+    private sessionTurns;
+    private sessionMoves;
+    private context;
+    private config;
+    private commandExecutor;
+    private eventProcessor;
+    private platformEvents;
+    private actionRegistry;
+    private textService?;
+    private turnEvents;
+    private running;
+    private story?;
+    private languageProvider?;
+    private parser?;
+    private eventListeners;
+    private saveRestoreHooks?;
+    private eventSource;
+    private systemEventSource;
+    private pendingPlatformOps;
+    private perceptionService?;
+    private scheduler;
+    private npcService;
+    private narrativeSettings;
+    private vocabularyManager;
+    private saveRestoreService;
+    private turnEventProcessor;
+    private platformOpHandler?;
+    private hasEmittedInitialized;
+    constructor(options: {
+        world: WorldModel;
+        player: IFEntity;
+        parser: Parser;
+        language: LanguageProvider;
+        perceptionService?: IPerceptionService;
+        config?: EngineConfig;
+    });
+    /**
+     * Set the story for this engine
+     */
+    setStory(story: Story): void;
+    /**
+     * Get the current parser
+     */
+    getParser(): Parser | undefined;
+    /**
+     * Get the current language provider
+     */
+    getLanguageProvider(): LanguageProvider | undefined;
+    /**
+     * Start the game engine
+     */
+    start(): void;
+    /**
+     * Stop the game engine
+     */
+    stop(reason?: 'quit' | 'victory' | 'defeat' | 'abort', details?: any): void;
+    /**
+     * Execute a turn
+     */
+    executeTurn(input: string): Promise<TurnResult>;
+    /**
+     * Execute a meta-command (VERSION, SCORE, HELP, etc.)
+     *
+     * Meta-commands operate outside the turn cycle:
+     * - They don't increment turns
+     * - They don't trigger NPC ticks or scheduler
+     * - They don't create undo snapshots
+     * - They don't get stored in command history
+     * - Events are processed immediately through text service (not stored in turnEvents)
+     *
+     * @param input - Raw command string
+     * @param parsedCommand - Parsed command from parser
+     * @returns MetaCommandResult with events and success status
+     */
+    private executeMetaCommand;
+    /**
+     * Process meta-command events: text service → emit to clients
+     *
+     * - Does NOT store in turnEvents
+     * - Passes currentTurn for display context (turn/score shown to player)
+     * - Turn counter is NOT incremented
+     */
+    private processMetaEvents;
+    /**
+     * Process a single platform operation for meta-commands.
+     *
+     * This is similar to processPlatformOperations but handles one operation
+     * at a time and returns completion events for inclusion in the result.
+     */
+    private processMetaPlatformOperation;
+    /**
+     * Get current game context
+     */
+    getContext(): GameContext;
+    /**
+     * Get world model
+     */
+    getWorld(): WorldModel;
+    /**
+     * Get the current story
+     */
+    getStory(): Story | undefined;
+    /**
+     * Get the event source for save/restore
+     */
+    getEventSource(): ISemanticEventSource;
+    /**
+     * Get narrative settings (ADR-089)
+     *
+     * Returns the story's narrative perspective and related settings.
+     * Use this for text rendering that needs to know 1st/2nd/3rd person.
+     */
+    getNarrativeSettings(): NarrativeSettings;
+    /**
+     * Configure language provider with narrative settings (ADR-089)
+     *
+     * Sets up the language provider for perspective-aware message resolution.
+     * For 3rd person narratives, extracts player pronouns from ActorTrait.
+     */
+    private configureLanguageProviderNarrative;
+    /**
+     * Get scheduler service for daemons and fuses (ADR-071)
+     */
+    getScheduler(): ISchedulerService;
+    /**
+     * Get NPC service for NPC behavior management (ADR-070)
+     */
+    getNpcService(): INpcService;
+    /**
+     * Get event processor for handler registration (ADR-075)
+     */
+    getEventProcessor(): EventProcessor;
+    /**
+     * Get the text service
+     */
+    getTextService(): ITextService | undefined;
+    /**
+     * Set a custom text service
+     */
+    setTextService(service: ITextService): void;
+    /**
+     * Register save/restore hooks
+     */
+    registerSaveRestoreHooks(hooks: ISaveRestoreHooks): void;
+    /**
+     * Register a transformer for parsed commands.
+     * Transformers are called after parsing but before validation,
+     * allowing stories to modify commands (e.g., for debug tools).
+     *
+     * @param transformer - Function to transform parsed commands
+     */
+    registerParsedCommandTransformer(transformer: ParsedCommandTransformer): void;
+    /**
+     * Unregister a parsed command transformer.
+     *
+     * @param transformer - The transformer to remove
+     * @returns true if the transformer was found and removed
+     */
+    unregisterParsedCommandTransformer(transformer: ParsedCommandTransformer): boolean;
+    /**
+     * Save game state using registered hooks
+     */
+    save(): Promise<boolean>;
+    /**
+     * Restore game state using registered hooks
+     */
+    restore(): Promise<boolean>;
+    /**
+     * Create an undo snapshot of the current world state
+     */
+    private createUndoSnapshot;
+    /**
+     * Undo to previous turn
+     * @returns true if undo succeeded, false if nothing to undo
+     */
+    undo(): boolean;
+    /**
+     * Check if undo is available
+     */
+    canUndo(): boolean;
+    /**
+     * Get number of undo levels available
+     */
+    getUndoLevels(): number;
+    /**
+     * Create save data from current engine state
+     */
+    private createSaveData;
+    /**
+     * Load save data into engine
+     */
+    private loadSaveData;
+    /**
+     * Get turn history
+     */
+    getHistory(): TurnResult[];
+    /**
+     * Get recent events
+     */
+    getRecentEvents(count?: number): SequencedEvent[];
+    /**
+     * Update vocabulary for an entity
+     */
+    updateEntityVocabulary(entity: IFEntity, inScope: boolean): void;
+    /**
+     * Update vocabulary for all entities in scope
+     */
+    updateScopeVocabulary(): void;
+    /**
+     * Emit a platform event with turn metadata
+     */
+    emitPlatformEvent(event: Omit<ISemanticEvent, 'id' | 'timestamp'>): void;
+    /**
+     * Update context after a turn
+     */
+    private updateContext;
+    /**
+     * Update command history capability
+     */
+    private updateCommandHistory;
+    /**
+     * Process pending platform operations
+     */
+    private processPlatformOperations;
+    /**
+     * Emit a game lifecycle event.
+     * All game events now use ISemanticEvent with data in the `data` field.
+     * (IGameEvent with `payload` is deprecated - see ADR-097)
+     */
+    private emitGameEvent;
+    /**
+     * Emit an event to listeners
+     */
+    private emit;
+    /**
+     * Dispatch an event to entity handlers (entity.on)
+     * Entities can define handlers for specific event types
+     */
+    private dispatchEntityHandlers;
+    /**
+     * Check if game is over
+     */
+    private isGameOver;
+    /**
+     * Add event listener
+     */
+    on<K extends GameEngineEventName>(event: K, listener: GameEngineEventListener<K>): this;
+    /**
+     * Remove event listener
+     */
+    off<K extends GameEngineEventName>(event: K, listener: GameEngineEventListener<K>): this;
+}
+export {};
+//# sourceMappingURL=game-engine.d.ts.map

package/dist/game-engine.d.ts.map

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