@sharpee/engine 0.9.66-beta → 0.9.67-beta

package/save-restore-service.js

@@ -0,0 +1,405 @@
+"use strict";
+/**
+ * Save/Restore Service - Manages game state persistence and undo
+ *
+ * Extracted from GameEngine as part of Phase 4 remediation.
+ * Handles save/restore data creation, undo snapshots, and serialization.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaveRestoreService = void 0;
+exports.createSaveRestoreService = createSaveRestoreService;
+const world_model_1 = require("./src/index.js");
+const core_1 = require("./src/index.js");
+const event_adapter_1 = require("./event-adapter");
+/**
+ * Service for managing save/restore and undo functionality
+ */
+class SaveRestoreService {
+    // Undo system - circular buffer of world snapshots
+    undoSnapshots = [];
+    undoSnapshotTurns = [];
+    maxUndoSnapshots;
+    constructor(config) {
+        this.maxUndoSnapshots = config?.maxSnapshots ?? 10;
+    }
+    /**
+     * Create an undo snapshot of the current world state
+     */
+    createUndoSnapshot(world, currentTurn) {
+        if (this.maxUndoSnapshots <= 0)
+            return; // Undo disabled
+        // Serialize world state
+        const snapshot = world.toJSON();
+        // Add to circular buffer
+        this.undoSnapshots.push(snapshot);
+        this.undoSnapshotTurns.push(currentTurn);
+        // Trim if over limit
+        while (this.undoSnapshots.length > this.maxUndoSnapshots) {
+            this.undoSnapshots.shift();
+            this.undoSnapshotTurns.shift();
+        }
+    }
+    /**
+     * Undo to previous turn
+     * @returns The turn number restored to, or null if nothing to undo
+     */
+    undo(world) {
+        if (this.undoSnapshots.length === 0) {
+            return null; // Nothing to undo
+        }
+        // Pop the most recent snapshot
+        const snapshot = this.undoSnapshots.pop();
+        const turn = this.undoSnapshotTurns.pop();
+        // Restore world state
+        world.loadJSON(snapshot);
+        return { turn };
+    }
+    /**
+     * Check if undo is available
+     */
+    canUndo() {
+        return this.undoSnapshots.length > 0;
+    }
+    /**
+     * Get number of undo levels available
+     */
+    getUndoLevels() {
+        return this.undoSnapshots.length;
+    }
+    /**
+     * Clear all undo snapshots (e.g., after restore)
+     */
+    clearUndoSnapshots() {
+        this.undoSnapshots = [];
+        this.undoSnapshotTurns = [];
+    }
+    /**
+     * Create save data from current engine state
+     */
+    createSaveData(provider) {
+        const context = provider.getContext();
+        const story = provider.getStory();
+        const eventSource = provider.getEventSource();
+        const pluginRegistry = provider.getPluginRegistry();
+        const world = provider.getWorld();
+        const parser = provider.getParser();
+        const metadata = {
+            storyId: story?.config.id || 'unknown',
+            storyVersion: story?.config.version || '0.0.0',
+            turnCount: context.currentTurn - 1,
+            playTime: Date.now() - context.metadata.started.getTime(),
+            description: `Turn ${context.currentTurn - 1}`
+        };
+        const engineState = {
+            eventSource: this.serializeEventSource(eventSource),
+            spatialIndex: this.serializeSpatialIndex(world),
+            turnHistory: this.serializeTurnHistory(context.history),
+            parserState: this.serializeParserState(parser),
+            pluginStates: pluginRegistry.getStates()
+        };
+        return {
+            version: '1.0.0',
+            timestamp: Date.now(),
+            metadata,
+            engineState,
+            storyConfig: {
+                id: story?.config.id || 'unknown',
+                version: story?.config.version || '0.0.0',
+                title: story?.config.title || 'Unknown',
+                author: Array.isArray(story?.config.author)
+                    ? story.config.author.join(', ')
+                    : (story?.config.author || 'Unknown')
+            }
+        };
+    }
+    /**
+     * Load save data into engine state
+     * @returns New event source with restored events
+     */
+    loadSaveData(saveData, provider) {
+        const story = provider.getStory();
+        // Validate save compatibility
+        if (saveData.version !== '1.0.0') {
+            throw new Error(`Unsupported save version: ${saveData.version}`);
+        }
+        if (saveData.storyConfig?.id &&
+            story?.config.id &&
+            saveData.storyConfig.id !== story.config.id) {
+            throw new Error(`Save is for different story: ${saveData.storyConfig.id}`);
+        }
+        // Restore event source
+        const eventSource = this.deserializeEventSource(saveData.engineState.eventSource);
+        // Restore spatial index (world state)
+        const world = provider.getWorld();
+        this.deserializeSpatialIndex(saveData.engineState.spatialIndex, world);
+        // Restore plugin states if present (ADR-120)
+        if (saveData.engineState.pluginStates) {
+            provider.getPluginRegistry().setStates(saveData.engineState.pluginStates);
+        }
+        // Clear undo snapshots after restore
+        this.clearUndoSnapshots();
+        return {
+            eventSource,
+            currentTurn: saveData.metadata.turnCount + 1
+        };
+    }
+    /**
+     * Serialize event source
+     */
+    serializeEventSource(eventSource) {
+        const events = [];
+        for (const event of eventSource.getAllEvents()) {
+            events.push({
+                id: event.id,
+                type: event.type,
+                timestamp: event.timestamp || Date.now(),
+                data: this.serializeEventData(event.data)
+            });
+        }
+        return events;
+    }
+    /**
+     * Serialize event data, handling functions and special types
+     */
+    serializeEventData(data) {
+        if (!data || typeof data !== 'object') {
+            return (data || {});
+        }
+        const serialized = {};
+        for (const [key, value] of Object.entries(data)) {
+            if (typeof value === 'function') {
+                // Mark functions for special handling during deserialization
+                serialized[key] = { __type: 'function', __marker: '[Function]' };
+            }
+            else if (value && typeof value === 'object') {
+                // Recursively serialize nested objects
+                if (Array.isArray(value)) {
+                    serialized[key] = value.map((item) => typeof item === 'object' ? this.serializeEventData(item) : item);
+                }
+                else {
+                    serialized[key] = this.serializeEventData(value);
+                }
+            }
+            else {
+                // Primitive values can be stored directly
+                serialized[key] = value;
+            }
+        }
+        return serialized;
+    }
+    /**
+     * Deserialize event source
+     */
+    deserializeEventSource(events) {
+        const eventSource = (0, core_1.createSemanticEventSource)();
+        for (const event of events) {
+            eventSource.emit({
+                id: event.id,
+                type: event.type,
+                timestamp: event.timestamp,
+                data: this.deserializeEventData(event.data),
+                entities: {}
+            });
+        }
+        return eventSource;
+    }
+    /**
+     * Deserialize event data, handling function markers
+     */
+    deserializeEventData(data) {
+        if (!data || typeof data !== 'object') {
+            return data;
+        }
+        // Check if this is a function marker
+        if (data.__type === 'function') {
+            // Return a placeholder function
+            return () => '[Serialized Function]';
+        }
+        if (Array.isArray(data)) {
+            return data.map((item) => this.deserializeEventData(item));
+        }
+        const deserialized = {};
+        for (const [key, value] of Object.entries(data)) {
+            deserialized[key] = this.deserializeEventData(value);
+        }
+        return deserialized;
+    }
+    /**
+     * Serialize spatial index (world state)
+     */
+    serializeSpatialIndex(world) {
+        const entities = {};
+        const locations = {};
+        const relationships = {};
+        // Serialize all entities
+        for (const entity of world.getAllEntities()) {
+            const traits = {};
+            // Serialize each trait
+            for (const [name, trait] of entity.traits) {
+                traits[name] = this.serializeTrait(trait);
+            }
+            entities[entity.id] = {
+                id: entity.id,
+                traits,
+                entityType: entity.constructor.name
+            };
+        }
+        // Serialize locations and their contents
+        const allLocations = world.getAllEntities().filter((e) => e.type === 'room' || e.type === 'location' || e.has('if.trait.room'));
+        for (const location of allLocations) {
+            const contents = world.getContents(location.id);
+            locations[location.id] = {
+                id: location.id,
+                properties: {
+                    name: location.get(world_model_1.TraitType.IDENTITY)?.name || 'Unknown',
+                    description: location.get(world_model_1.TraitType.IDENTITY)?.description || ''
+                },
+                contents: contents.map((e) => e.id),
+                connections: this.extractConnections(location, world)
+            };
+        }
+        return { entities, locations, relationships };
+    }
+    /**
+     * Deserialize spatial index
+     */
+    deserializeSpatialIndex(index, world) {
+        // Note: Full deserialization would need to clear and recreate the world
+        // For now, this restores entity traits and locations
+        // Restore entity traits
+        for (const [id, data] of Object.entries(index.entities)) {
+            const entity = world.getEntity(id);
+            if (entity) {
+                // Restore traits
+                for (const [name, traitData] of Object.entries(data.traits)) {
+                    const trait = this.deserializeTrait(name, traitData);
+                    if (trait) {
+                        // Remove existing trait if present, then add the restored one
+                        if (entity.has(name)) {
+                            entity.remove(name);
+                        }
+                        entity.add(trait);
+                    }
+                }
+            }
+        }
+        // Restore locations and contents
+        for (const [locationId, data] of Object.entries(index.locations)) {
+            for (const entityId of data.contents) {
+                const entity = world.getEntity(entityId);
+                if (entity) {
+                    world.moveEntity(entity.id, locationId);
+                }
+            }
+        }
+    }
+    /**
+     * Serialize turn history
+     */
+    serializeTurnHistory(history) {
+        const turns = [];
+        for (const [index, result] of history.entries()) {
+            turns.push({
+                turnNumber: index + 1,
+                eventIds: result.events.map((e) => e.source || `${e.turn}-${e.sequence}`),
+                timestamp: result.events[0]?.timestamp.getTime() || Date.now(),
+                command: result.input
+            });
+        }
+        return turns;
+    }
+    /**
+     * Deserialize turn history
+     */
+    deserializeTurnHistory(turns, eventSource) {
+        const history = [];
+        for (const turn of turns) {
+            // Find the events for this turn
+            const events = eventSource.getAllEvents().filter((e) => turn.eventIds.includes(e.id));
+            // Convert SemanticEvents to SequencedEvents
+            const sequencedEvents = events.map((event, index) => (0, event_adapter_1.toSequencedEvent)(event, turn.turnNumber, index));
+            history.push({
+                turn: turn.turnNumber,
+                input: turn.command || '',
+                success: true,
+                events: sequencedEvents
+            });
+        }
+        return history;
+    }
+    /**
+     * Serialize parser state
+     */
+    serializeParserState(parser) {
+        if (!parser) {
+            return undefined;
+        }
+        // Parser state serialization is parser-specific
+        // For now, return empty object
+        return {};
+    }
+    /**
+     * Serialize a trait
+     */
+    serializeTrait(trait) {
+        if (typeof trait === 'object' && trait !== null) {
+            return { ...trait };
+        }
+        return trait;
+    }
+    /**
+     * Deserialize a trait
+     */
+    deserializeTrait(name, data) {
+        if (data && typeof data === 'object') {
+            return { type: name, ...data };
+        }
+        return null;
+    }
+    /**
+     * Extract connections from a location entity
+     */
+    extractConnections(location, world) {
+        const connections = {};
+        // Check for ROOM trait with exits
+        const roomTrait = location.get('if.trait.room');
+        if (roomTrait?.exits) {
+            Object.entries(roomTrait.exits).forEach(([direction, exit]) => {
+                if (exit.destination) {
+                    connections[direction] = exit.destination;
+                }
+            });
+        }
+        // Check for doors in this location
+        const contents = world.getContents(location.id);
+        contents.forEach((entity) => {
+            const doorTrait = entity.get('if.trait.door');
+            if (doorTrait) {
+                const otherRoom = doorTrait.room1 === location.id ? doorTrait.room2 : doorTrait.room1;
+                if (otherRoom) {
+                    // Try to determine direction from door name
+                    const name = entity.name?.toLowerCase() || '';
+                    if (name.includes('north'))
+                        connections.north = otherRoom;
+                    else if (name.includes('south'))
+                        connections.south = otherRoom;
+                    else if (name.includes('east'))
+                        connections.east = otherRoom;
+                    else if (name.includes('west'))
+                        connections.west = otherRoom;
+                    else
+                        connections.door = otherRoom;
+                }
+            }
+        });
+        return connections;
+    }
+}
+exports.SaveRestoreService = SaveRestoreService;
+/**
+ * Create a save/restore service instance
+ */
+function createSaveRestoreService(config) {
+    return new SaveRestoreService(config);
+}
+//# sourceMappingURL=save-restore-service.js.map

package/save-restore-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-restore-service.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/engine/src/save-restore-service.ts"],"names":[],"mappings":"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"}

package/shared-data-keys.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Typed constants for sharedData keys used by the engine orchestration.
+ *
+ * SharedData is passed between action phases (validate/execute/report/blocked)
+ * and allows phases to communicate without modifying the context directly.
+ *
+ * This file defines only engine-level keys. Actions define their own
+ * action-specific keys as needed.
+ */
+import type { ISemanticEvent } from "./src/index";
+import type { IFEntity } from "./src/index";
+import type { ValidationResult } from "./src/index";
+/**
+ * Constants for engine-level sharedData keys.
+ * Using constants prevents typos and enables IDE autocomplete.
+ */
+export declare const SharedDataKeys: {
+    /** Whether pronoun inference was performed (ADR-104) */
+    readonly INFERENCE_PERFORMED: "inferencePerformed";
+    /** The original target entity before inference */
+    readonly ORIGINAL_TARGET: "originalTarget";
+    /** The inferred target entity after inference */
+    readonly INFERRED_TARGET: "inferredTarget";
+    /** Events from implicit take actions (ADR-104) */
+    readonly IMPLICIT_TAKE_EVENTS: "implicitTakeEvents";
+    /** Validation result from the validate phase */
+    readonly VALIDATION_RESULT: "validationResult";
+};
+/**
+ * Type for the value type of a SharedDataKey
+ */
+export type SharedDataKeyType = typeof SharedDataKeys[keyof typeof SharedDataKeys];
+/**
+ * Typed interface for engine-level shared data.
+ *
+ * Note: Actions can store additional keys beyond these.
+ * This interface covers only the engine orchestration keys.
+ */
+export interface EngineSharedData {
+    /** Whether pronoun inference was performed */
+    [SharedDataKeys.INFERENCE_PERFORMED]?: boolean;
+    /** The original target entity before inference */
+    [SharedDataKeys.ORIGINAL_TARGET]?: IFEntity;
+    /** The inferred target entity after inference */
+    [SharedDataKeys.INFERRED_TARGET]?: IFEntity;
+    /** Events from implicit take actions */
+    [SharedDataKeys.IMPLICIT_TAKE_EVENTS]?: ISemanticEvent[];
+    /** Validation result from the validate phase */
+    [SharedDataKeys.VALIDATION_RESULT]?: ValidationResult;
+    /** Allow additional action-specific keys */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=shared-data-keys.d.ts.map

package/shared-data-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-data-keys.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/engine/src/shared-data-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,cAAc;IACzB,wDAAwD;;IAGxD,kDAAkD;;IAGlD,iDAAiD;;IAGjD,kDAAkD;;IAGlD,gDAAgD;;CAExC,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC;IAE/C,kDAAkD;IAClD,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,EAAE,QAAQ,CAAC;IAE5C,iDAAiD;IACjD,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,EAAE,QAAQ,CAAC;IAE5C,wCAAwC;IACxC,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;IAEzD,gDAAgD;IAChD,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,EAAE,gBAAgB,CAAC;IAEtD,4CAA4C;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/shared-data-keys.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Typed constants for sharedData keys used by the engine orchestration.
+ *
+ * SharedData is passed between action phases (validate/execute/report/blocked)
+ * and allows phases to communicate without modifying the context directly.
+ *
+ * This file defines only engine-level keys. Actions define their own
+ * action-specific keys as needed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedDataKeys = void 0;
+/**
+ * Constants for engine-level sharedData keys.
+ * Using constants prevents typos and enables IDE autocomplete.
+ */
+exports.SharedDataKeys = {
+    /** Whether pronoun inference was performed (ADR-104) */
+    INFERENCE_PERFORMED: 'inferencePerformed',
+    /** The original target entity before inference */
+    ORIGINAL_TARGET: 'originalTarget',
+    /** The inferred target entity after inference */
+    INFERRED_TARGET: 'inferredTarget',
+    /** Events from implicit take actions (ADR-104) */
+    IMPLICIT_TAKE_EVENTS: 'implicitTakeEvents',
+    /** Validation result from the validate phase */
+    VALIDATION_RESULT: 'validationResult',
+};
+//# sourceMappingURL=shared-data-keys.js.map

package/shared-data-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-data-keys.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/engine/src/shared-data-keys.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAMH;;;GAGG;AACU,QAAA,cAAc,GAAG;IAC5B,wDAAwD;IACxD,mBAAmB,EAAE,oBAAoB;IAEzC,kDAAkD;IAClD,eAAe,EAAE,gBAAgB;IAEjC,iDAAiD;IACjD,eAAe,EAAE,gBAAgB;IAEjC,kDAAkD;IAClD,oBAAoB,EAAE,oBAAoB;IAE1C,gDAAgD;IAChD,iBAAiB,EAAE,kBAAkB;CAC7B,CAAC"}