@sharpee/world-model 0.9.65-beta → 0.9.67-beta

package/world/WorldModel.js

@@ -0,0 +1,1085 @@
+"use strict";
+// WorldModel.ts - Core world model interface and implementation for Sharpee IF Platform
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorldModel = void 0;
+const if_entity_1 = require("../entities/if-entity");
+const entity_types_1 = require("../entities/entity-types");
+const trait_types_1 = require("../traits/trait-types");
+const room_1 = require("../traits/room");
+const roomBehavior_1 = require("../traits/room/roomBehavior");
+const container_1 = require("../traits/container");
+const supporter_1 = require("../traits/supporter");
+const actor_1 = require("../traits/actor");
+const door_1 = require("../traits/door");
+const scenery_1 = require("../traits/scenery");
+const identityTrait_1 = require("../traits/identity/identityTrait");
+const openableTrait_1 = require("../traits/openable/openableTrait");
+const lockableTrait_1 = require("../traits/lockable/lockableTrait");
+const directions_1 = require("../constants/directions");
+const SpatialIndex_1 = require("./SpatialIndex");
+const VisibilityBehavior_1 = require("./VisibilityBehavior");
+const container_utils_1 = require("../traits/container/container-utils");
+const if_domain_1 = require("../src/index.js");
+const scope_registry_1 = require("../scope/scope-registry");
+const scope_evaluator_1 = require("../scope/scope-evaluator");
+// Type prefixes for entity ID generation
+const TYPE_PREFIXES = {
+    'room': 'r',
+    'door': 'd',
+    'item': 'i',
+    'actor': 'a',
+    'container': 'c',
+    'supporter': 's',
+    'scenery': 'y',
+    'exit': 'e',
+    'object': 'o' // default
+};
+class WorldModel {
+    entities = new Map();
+    state = {};
+    playerId;
+    spatialIndex;
+    config;
+    capabilities = {};
+    // ID generation
+    idCounters = new Map();
+    // Event sourcing support
+    eventHandlers = new Map();
+    eventValidators = new Map();
+    eventPreviewers = new Map();
+    appliedEvents = [];
+    eventProcessorWiring = null;
+    maxEventHistory = 1000; // Configurable limit
+    // Event chaining support (ADR-094)
+    eventChains = new Map();
+    platformEvents;
+    // Scope system
+    scopeRegistry;
+    scopeEvaluator;
+    // Vocabulary system (ADR-082)
+    grammarVocabularyProvider;
+    constructor(config = {}, platformEvents) {
+        this.config = {
+            enableSpatialIndex: true,
+            maxDepth: 10,
+            strictMode: false,
+            ...config
+        };
+        this.spatialIndex = new SpatialIndex_1.SpatialIndex();
+        this.platformEvents = platformEvents;
+        // Initialize scope system
+        this.scopeRegistry = new scope_registry_1.ScopeRegistry();
+        this.scopeEvaluator = new scope_evaluator_1.ScopeEvaluator(this.scopeRegistry);
+        // Initialize vocabulary system (ADR-082)
+        this.grammarVocabularyProvider = new if_domain_1.GrammarVocabularyProvider();
+        // Register default scope rules
+        this.registerDefaultScopeRules();
+    }
+    // Platform event emission helper
+    emitPlatformEvent(type, data) {
+        if (this.platformEvents) {
+            this.platformEvents.addEvent({
+                id: `world_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+                timestamp: Date.now(),
+                type: `platform.world.${type}`,
+                entities: {},
+                data: {
+                    subsystem: 'world',
+                    ...data
+                },
+                tags: ['platform', 'world', 'debug'],
+                priority: 0,
+                narrate: false
+            });
+        }
+    }
+    // Capability Management
+    registerCapability(name, registration = {}) {
+        if (this.capabilities[name]) {
+            if (this.config.strictMode) {
+                throw new Error(`Capability '${name}' is already registered`);
+            }
+            return;
+        }
+        // Initialize capability with schema and initial data
+        const initialData = {};
+        // Apply schema defaults
+        if (registration.schema) {
+            for (const [field, fieldDef] of Object.entries(registration.schema)) {
+                if (fieldDef.default !== undefined) {
+                    initialData[field] = fieldDef.default;
+                }
+            }
+        }
+        // Override with provided initial data
+        if (registration.initialData) {
+            Object.assign(initialData, registration.initialData);
+        }
+        this.capabilities[name] = {
+            data: initialData,
+            schema: registration.schema
+        };
+    }
+    updateCapability(name, updates) {
+        const capability = this.capabilities[name];
+        if (!capability) {
+            if (this.config.strictMode) {
+                throw new Error(`Capability '${name}' is not registered`);
+            }
+            return;
+        }
+        // Validate updates against schema if present
+        if (capability.schema) {
+            for (const [field, value] of Object.entries(updates)) {
+                const fieldDef = capability.schema[field];
+                if (fieldDef) {
+                    // Basic type validation
+                    const actualType = Array.isArray(value) ? 'array' : typeof value;
+                    if (actualType !== fieldDef.type && value !== null && value !== undefined) {
+                        if (this.config.strictMode) {
+                            throw new Error(`Invalid type for capability '${name}' field '${field}': expected ${fieldDef.type}, got ${actualType}`);
+                        }
+                    }
+                }
+            }
+        }
+        // Apply updates
+        Object.assign(capability.data, updates);
+    }
+    getCapability(name) {
+        return this.capabilities[name]?.data;
+    }
+    hasCapability(name) {
+        return name in this.capabilities;
+    }
+    // ID Generation
+    generateId(type) {
+        const prefix = TYPE_PREFIXES[type] || TYPE_PREFIXES['object'];
+        const counter = this.idCounters.get(prefix) || 0;
+        // Increment counter
+        const nextCounter = counter + 1;
+        // Check for overflow (base36 with 2 chars = 1296 max)
+        if (nextCounter > 1295) {
+            throw new Error(`ID overflow for type '${type}' (prefix '${prefix}'). Maximum 1296 entities per type.`);
+        }
+        this.idCounters.set(prefix, nextCounter);
+        // Convert to base36 and pad to 2 characters
+        const base36 = nextCounter.toString(36).padStart(2, '0');
+        return `${prefix}${base36}`;
+    }
+    // Entity Management
+    createEntity(displayName, type = 'object') {
+        // Validate entity type
+        if (!(0, entity_types_1.isEntityType)(type)) {
+            throw new Error(`Unknown entity type: '${type}'. Valid types are: ${Object.values(entity_types_1.EntityType).join(', ')}`);
+        }
+        // Generate ID based on type
+        const id = this.generateId(type);
+        const entity = new if_entity_1.IFEntity(id, type, {
+            attributes: {
+                displayName: displayName,
+                name: displayName, // For compatibility
+                entityType: type
+            }
+        });
+        // Add to entity map
+        this.entities.set(id, entity);
+        return entity;
+    }
+    /**
+     * Create an entity with type safety and automatic trait assignment
+     * @param type The entity type (from EntityType constants)
+     * @returns The created entity with appropriate default traits
+     */
+    createEntityWithTraits(type) {
+        const id = this.generateId(type);
+        const entity = new if_entity_1.IFEntity(id, type);
+        // Auto-add appropriate default trait based on type
+        switch (type) {
+            case entity_types_1.EntityType.ROOM:
+                entity.add(new room_1.RoomTrait({}));
+                break;
+            case entity_types_1.EntityType.CONTAINER:
+                entity.add(new container_1.ContainerTrait());
+                break;
+            case entity_types_1.EntityType.SUPPORTER:
+                entity.add(new supporter_1.SupporterTrait());
+                break;
+            case entity_types_1.EntityType.ACTOR:
+                entity.add(new actor_1.ActorTrait());
+                break;
+            case entity_types_1.EntityType.DOOR:
+                // Door trait requires room1 and room2 to be set
+                // These must be configured after creation when room IDs are known
+                break;
+            case entity_types_1.EntityType.SCENERY:
+                entity.add(new scenery_1.SceneryTrait());
+                break;
+            // ITEM, OBJECT, and EXIT don't need special traits by default
+        }
+        // Add to entity map
+        this.entities.set(id, entity);
+        return entity;
+    }
+    getEntity(id) {
+        return this.entities.get(id);
+    }
+    hasEntity(id) {
+        return this.entities.has(id);
+    }
+    removeEntity(id) {
+        const entity = this.entities.get(id);
+        if (!entity)
+            return false;
+        // Remove from spatial index
+        this.spatialIndex.remove(id);
+        // Remove from any containers
+        const location = this.getLocation(id);
+        if (location) {
+            this.moveEntity(id, null);
+        }
+        // Remove entity
+        return this.entities.delete(id);
+    }
+    getAllEntities() {
+        return Array.from(this.entities.values());
+    }
+    updateEntity(entityId, updater) {
+        const entity = this.getEntity(entityId);
+        if (!entity) {
+            if (this.config.strictMode) {
+                throw new Error(`Cannot update non-existent entity: ${entityId}`);
+            }
+            return;
+        }
+        // Call the updater - entity is mutable so changes happen in place
+        updater(entity);
+        // Future: Could emit change events here for reactive systems
+        // this.emitChange({ type: 'entity-updated', entityId });
+    }
+    // Spatial Management
+    getLocation(entityId) {
+        return this.spatialIndex.getParent(entityId);
+    }
+    getContents(containerId, options = {}) {
+        const contents = this.spatialIndex.getChildren(containerId);
+        let entities = contents
+            .map(id => this.getEntity(id))
+            .filter((e) => e !== undefined);
+        if (options.visibleOnly) {
+            // Filter to only visible entities
+            entities = entities.filter(e => {
+                const scenery = e.getTrait(trait_types_1.TraitType.SCENERY);
+                return !scenery || scenery.visible !== false;
+            });
+        }
+        if (!options.includeWorn) {
+            // Filter out worn items (check both WEARABLE and CLOTHING traits)
+            entities = entities.filter(e => {
+                const wearable = e.getTrait(trait_types_1.TraitType.WEARABLE);
+                const clothing = e.getTrait(trait_types_1.TraitType.CLOTHING);
+                const wornFromWearable = wearable && wearable.isWorn;
+                const wornFromClothing = clothing && clothing.isWorn;
+                return !(wornFromWearable || wornFromClothing);
+            });
+        }
+        return entities;
+    }
+    moveEntity(entityId, targetId) {
+        if (!this.canMoveEntity(entityId, targetId)) {
+            this.emitPlatformEvent('move_entity_failed', {
+                entityId,
+                targetId,
+                reason: 'cannot_move'
+            });
+            return false;
+        }
+        // Remove from current location
+        const currentLocation = this.getLocation(entityId);
+        if (currentLocation) {
+            this.spatialIndex.removeChild(currentLocation, entityId);
+        }
+        // Add to new location
+        if (targetId) {
+            this.spatialIndex.addChild(targetId, entityId);
+        }
+        // Emit platform event
+        this.emitPlatformEvent('entity_moved', {
+            entityId,
+            fromLocation: currentLocation,
+            toLocation: targetId
+        });
+        return true;
+    }
+    canMoveEntity(entityId, targetId) {
+        const entity = this.getEntity(entityId);
+        if (!entity)
+            return false;
+        // Can always remove from world
+        if (targetId === null)
+            return true;
+        const target = this.getEntity(targetId);
+        if (!target)
+            return false;
+        // Check for containment loops
+        if (this.wouldCreateLoop(entityId, targetId)) {
+            return false;
+        }
+        // Check if target can contain - using our new utility
+        if (!(0, container_utils_1.canContain)(target)) {
+            return false;
+        }
+        // Check container constraints
+        if (target.hasTrait(trait_types_1.TraitType.CONTAINER) && target.hasTrait(trait_types_1.TraitType.OPENABLE)) {
+            const openable = target.getTrait(trait_types_1.TraitType.OPENABLE);
+            if (openable && !openable.isOpen) {
+                return false;
+            }
+        }
+        return true;
+    }
+    getContainingRoom(entityId) {
+        let current = entityId;
+        let depth = 0;
+        while (current && depth < this.config.maxDepth) {
+            const parent = this.getLocation(current);
+            if (!parent)
+                return undefined;
+            const parentEntity = this.getEntity(parent);
+            if (parentEntity?.hasTrait(trait_types_1.TraitType.ROOM)) {
+                return parentEntity;
+            }
+            current = parent;
+            depth++;
+        }
+        return undefined;
+    }
+    getAllContents(entityId, options = {}) {
+        const result = [];
+        const visited = new Set();
+        const traverse = (id, depth = 0, isRoot = false) => {
+            if (visited.has(id) || depth > this.config.maxDepth)
+                return;
+            visited.add(id);
+            // For the root entity, use the provided options
+            // For recursive calls, always include worn items to get complete contents
+            const contentsOptions = isRoot ? {
+                visibleOnly: options.visibleOnly,
+                includeWorn: options.includeWorn
+            } : {
+                visibleOnly: options.visibleOnly,
+                includeWorn: true // Always include worn items when recursing
+            };
+            const contents = this.getContents(id, contentsOptions);
+            result.push(...contents);
+            if (options.recursive) {
+                contents.forEach(item => traverse(item.id, depth + 1, false));
+            }
+        };
+        traverse(entityId, 0, true);
+        return result;
+    }
+    // World State Management
+    getState() {
+        return { ...this.state };
+    }
+    setState(state) {
+        this.state = { ...state };
+    }
+    getStateValue(key) {
+        return this.state[key];
+    }
+    setStateValue(key, value) {
+        this.state[key] = value;
+    }
+    // Query Operations
+    findByTrait(traitType) {
+        return this.findWhere(e => e.hasTrait(traitType));
+    }
+    findByType(entityType) {
+        return this.findWhere(e => e.type === entityType);
+    }
+    findWhere(predicate) {
+        return Array.from(this.entities.values()).filter(predicate);
+    }
+    // Scope methods moved to end of class to use new scope system
+    // Relationship Queries
+    relationships = new Map();
+    getRelated(entityId, relationshipType) {
+        const entityRels = this.relationships.get(entityId);
+        if (!entityRels)
+            return [];
+        const related = entityRels.get(relationshipType);
+        return related ? Array.from(related) : [];
+    }
+    areRelated(entity1Id, entity2Id, relationshipType) {
+        const related = this.getRelated(entity1Id, relationshipType);
+        return related.includes(entity2Id);
+    }
+    addRelationship(entity1Id, entity2Id, relationshipType) {
+        // Ensure entities exist
+        if (!this.hasEntity(entity1Id) || !this.hasEntity(entity2Id)) {
+            if (this.config.strictMode) {
+                throw new Error('Cannot add relationship between non-existent entities');
+            }
+            return;
+        }
+        // Add forward relationship
+        if (!this.relationships.has(entity1Id)) {
+            this.relationships.set(entity1Id, new Map());
+        }
+        const entityRels = this.relationships.get(entity1Id);
+        if (!entityRels.has(relationshipType)) {
+            entityRels.set(relationshipType, new Set());
+        }
+        entityRels.get(relationshipType).add(entity2Id);
+    }
+    removeRelationship(entity1Id, entity2Id, relationshipType) {
+        const entityRels = this.relationships.get(entity1Id);
+        if (!entityRels)
+            return;
+        const related = entityRels.get(relationshipType);
+        if (related) {
+            related.delete(entity2Id);
+            if (related.size === 0) {
+                entityRels.delete(relationshipType);
+            }
+        }
+        if (entityRels.size === 0) {
+            this.relationships.delete(entity1Id);
+        }
+    }
+    // Utility Methods
+    getTotalWeight(entityId) {
+        const entity = this.getEntity(entityId);
+        if (!entity)
+            return 0;
+        let weight = entity.weight || 0;
+        // Add weight of all contents
+        const contents = this.getAllContents(entityId, { recursive: true });
+        for (const item of contents) {
+            weight += item.weight || 0;
+        }
+        return weight;
+    }
+    wouldCreateLoop(entityId, targetId) {
+        if (entityId === targetId)
+            return true;
+        let current = targetId;
+        const visited = new Set();
+        while (current) {
+            if (visited.has(current))
+                return false; // Already checked this path
+            if (current === entityId)
+                return true; // Found a loop
+            visited.add(current);
+            current = this.getLocation(current) || '';
+        }
+        return false;
+    }
+    findPath(fromRoomId, toRoomId) {
+        if (fromRoomId === toRoomId)
+            return [];
+        const fromRoom = this.getEntity(fromRoomId);
+        const toRoom = this.getEntity(toRoomId);
+        if (!fromRoom?.hasTrait(trait_types_1.TraitType.ROOM) || !toRoom?.hasTrait(trait_types_1.TraitType.ROOM)) {
+            return null;
+        }
+        // Simple BFS pathfinding
+        const queue = [{ roomId: fromRoomId, path: [] }];
+        const visited = new Set();
+        while (queue.length > 0) {
+            const { roomId, path } = queue.shift();
+            if (visited.has(roomId))
+                continue;
+            visited.add(roomId);
+            // Get exits from this room
+            const room = this.getEntity(roomId);
+            if (!room)
+                continue;
+            const exits = room.getTrait(trait_types_1.TraitType.ROOM)?.exits || {};
+            for (const [direction, exitInfo] of Object.entries(exits)) {
+                let targetRoom;
+                let pathElement;
+                if (typeof exitInfo === 'string') {
+                    // Simple string - treat as direct room connection
+                    targetRoom = exitInfo;
+                    pathElement = exitInfo; // For now, use room ID as path element
+                }
+                else if (typeof exitInfo === 'object') {
+                    // ExitInfo object
+                    if (exitInfo.via) {
+                        // Has a door/exit entity
+                        const exitEntity = this.getEntity(exitInfo.via);
+                        if (!exitEntity)
+                            continue;
+                        pathElement = exitInfo.via;
+                        // Get destination based on entity type
+                        if (exitEntity.hasTrait(trait_types_1.TraitType.DOOR)) {
+                            const door = exitEntity.getTrait(trait_types_1.TraitType.DOOR);
+                            targetRoom = door?.room1 === roomId ? door?.room2 : door?.room1;
+                        }
+                        else if (exitEntity.hasTrait(trait_types_1.TraitType.EXIT)) {
+                            targetRoom = exitEntity.getTrait(trait_types_1.TraitType.EXIT)?.to;
+                        }
+                        else {
+                            // Not a valid door/exit entity
+                            continue;
+                        }
+                    }
+                    else if (exitInfo.destination) {
+                        // Direct room connection
+                        targetRoom = exitInfo.destination;
+                        pathElement = targetRoom; // Use room ID as path element
+                    }
+                }
+                if (!targetRoom || !pathElement)
+                    continue;
+                if (targetRoom === toRoomId) {
+                    // Found the destination - return path
+                    // For direct connections, return empty array (no doors to pass through)
+                    if (pathElement === targetRoom && path.length === 0) {
+                        return [];
+                    }
+                    return [...path, pathElement];
+                }
+                if (!visited.has(targetRoom)) {
+                    // For direct connections, don't add room ID to path
+                    const newPath = pathElement === targetRoom ? path : [...path, pathElement];
+                    queue.push({ roomId: targetRoom, path: newPath });
+                }
+            }
+        }
+        return null;
+    }
+    getPlayer() {
+        return this.playerId ? this.getEntity(this.playerId) : undefined;
+    }
+    setPlayer(entityId) {
+        if (!this.hasEntity(entityId)) {
+            throw new Error(`Cannot set player to non-existent entity: ${entityId}`);
+        }
+        this.playerId = entityId;
+    }
+    // Persistence
+    toJSON() {
+        const data = {
+            entities: Array.from(this.entities.entries()).map(([id, entity]) => ({
+                id,
+                entity: entity.toJSON()
+            })),
+            state: this.state,
+            playerId: this.playerId,
+            spatialIndex: this.spatialIndex.toJSON(),
+            relationships: Array.from(this.relationships.entries()).map(([entityId, rels]) => ({
+                entityId,
+                relationships: Array.from(rels.entries()).map(([type, related]) => ({
+                    type,
+                    related: Array.from(related)
+                }))
+            })),
+            // Add ID system data
+            idCounters: Array.from(this.idCounters.entries()),
+            // Add capabilities
+            capabilities: Object.entries(this.capabilities).map(([name, cap]) => ({
+                name,
+                data: cap.data,
+                schema: cap.schema
+            }))
+        };
+        return JSON.stringify(data, null, 2);
+    }
+    loadJSON(json) {
+        const data = JSON.parse(json);
+        // Clear current state
+        this.clear();
+        // Restore entities
+        for (const { id, entity } of data.entities) {
+            const newEntity = if_entity_1.IFEntity.fromJSON(entity);
+            this.entities.set(id, newEntity);
+        }
+        // Restore state
+        this.state = data.state || {};
+        this.playerId = data.playerId;
+        // Restore spatial index
+        if (data.spatialIndex) {
+            this.spatialIndex.loadJSON(data.spatialIndex);
+        }
+        // Restore relationships
+        if (data.relationships) {
+            for (const { entityId, relationships } of data.relationships) {
+                const entityRels = new Map();
+                for (const { type, related } of relationships) {
+                    entityRels.set(type, new Set(related));
+                }
+                this.relationships.set(entityId, entityRels);
+            }
+        }
+        // Restore ID system data
+        if (data.idCounters) {
+            this.idCounters = new Map(data.idCounters);
+        }
+        else {
+            // Rebuild ID counters from existing entities for backward compatibility
+            this.rebuildIdCounters();
+        }
+        // Restore capabilities
+        if (data.capabilities) {
+            for (const { name, data: capData, schema } of data.capabilities) {
+                this.capabilities[name] = {
+                    data: capData,
+                    schema
+                };
+            }
+        }
+    }
+    clear() {
+        this.entities.clear();
+        this.state = {};
+        this.playerId = undefined;
+        this.spatialIndex.clear();
+        this.relationships.clear();
+        this.appliedEvents = [];
+        this.idCounters.clear();
+        this.capabilities = {};
+        this.grammarVocabularyProvider.clear();
+        this.eventChains.clear();
+    }
+    // Event Sourcing Implementation
+    registerEventHandler(eventType, handler) {
+        this.eventHandlers.set(eventType, handler);
+        // If already connected to EventProcessor, wire this handler immediately (ADR-086)
+        if (this.eventProcessorWiring) {
+            this.wireHandlerToProcessor(eventType, handler);
+        }
+    }
+    unregisterEventHandler(eventType) {
+        this.eventHandlers.delete(eventType);
+        // Note: We don't unregister from EventProcessor as it doesn't support removal by type
+        // Handlers will still be called but won't find the handler in eventHandlers
+    }
+    registerEventValidator(eventType, validator) {
+        this.eventValidators.set(eventType, validator);
+    }
+    registerEventPreviewer(eventType, previewer) {
+        this.eventPreviewers.set(eventType, previewer);
+    }
+    /**
+     * Connect this WorldModel to the engine's EventProcessor (ADR-086).
+     * Wires all existing handlers and chains, and enables automatic wiring for future ones.
+     */
+    connectEventProcessor(wiring) {
+        this.eventProcessorWiring = wiring;
+        // Wire all existing handlers
+        for (const [eventType, handler] of this.eventHandlers) {
+            this.wireHandlerToProcessor(eventType, handler);
+        }
+        // Wire all existing chains (ADR-094)
+        for (const triggerType of this.eventChains.keys()) {
+            this.wireChainToProcessor(triggerType);
+        }
+    }
+    /**
+     * Adapt a WorldModel handler to EventProcessor signature and register it.
+     */
+    wireHandlerToProcessor(eventType, handler) {
+        if (!this.eventProcessorWiring)
+            return;
+        // Adapt the handler: WorldModel handlers return void, EventProcessor expects Effect[]
+        const adaptedHandler = (event) => {
+            handler(event, this);
+            return [];
+        };
+        this.eventProcessorWiring.registerHandler(eventType, adaptedHandler);
+    }
+    /**
+     * Register an event chain handler (ADR-094).
+     * Chain handlers produce new events when a trigger event occurs.
+     */
+    chainEvent(triggerType, handler, options = {}) {
+        const { mode = 'cascade', key, priority = 100 } = options;
+        const registration = { handler, key, priority };
+        if (!this.eventChains.has(triggerType)) {
+            this.eventChains.set(triggerType, []);
+        }
+        const chains = this.eventChains.get(triggerType);
+        if (mode === 'override') {
+            // Replace all existing chains
+            this.eventChains.set(triggerType, [registration]);
+        }
+        else if (key) {
+            // Replace chain with same key, or add
+            const existingIndex = chains.findIndex(c => c.key === key);
+            if (existingIndex >= 0) {
+                chains[existingIndex] = registration;
+            }
+            else {
+                chains.push(registration);
+            }
+        }
+        else {
+            // Cascade - just add
+            chains.push(registration);
+        }
+        // Sort by priority (lower = earlier)
+        chains.sort((a, b) => a.priority - b.priority);
+        // Wire to EventProcessor if connected
+        if (this.eventProcessorWiring) {
+            this.wireChainToProcessor(triggerType);
+        }
+    }
+    /**
+     * Wire chains for a trigger type to the EventProcessor.
+     * Chain handlers return events to be emitted.
+     */
+    wireChainToProcessor(triggerType) {
+        if (!this.eventProcessorWiring)
+            return;
+        // Register a handler that invokes all chains and returns EmitEffect objects
+        // The event processor expects Effect[] not ISemanticEvent[]
+        this.eventProcessorWiring.registerHandler(triggerType, (event) => {
+            const chainedEvents = this.executeChains(triggerType, event);
+            // Wrap each event as an EmitEffect
+            return chainedEvents.map(e => ({ type: 'emit', event: e }));
+        });
+    }
+    /**
+     * Execute all chains for a trigger type and collect their events.
+     */
+    executeChains(triggerType, event) {
+        const chains = this.eventChains.get(triggerType) || [];
+        const results = [];
+        // Get chain metadata from trigger event's data (ADR-094)
+        const triggerData = (event.data || {});
+        const currentDepth = triggerData._chainDepth || 0;
+        const transactionId = triggerData._transactionId;
+        for (const chain of chains) {
+            const chainedEvents = chain.handler(event, this);
+            if (chainedEvents) {
+                const eventsArray = Array.isArray(chainedEvents) ? chainedEvents : [chainedEvents];
+                // Add chain metadata to each event
+                for (const chainedEvent of eventsArray) {
+                    const newDepth = currentDepth + 1;
+                    // Safety: prevent infinite loops (max depth 10)
+                    if (newDepth > 10) {
+                        console.warn(`Chain depth exceeded for ${chainedEvent.type}, skipping`);
+                        continue;
+                    }
+                    // Ensure the event has required fields and add chain metadata to data
+                    const existingData = (chainedEvent.data || {});
+                    const enrichedEvent = {
+                        id: chainedEvent.id || `chain-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+                        type: chainedEvent.type,
+                        timestamp: chainedEvent.timestamp || Date.now(),
+                        entities: chainedEvent.entities || {},
+                        data: {
+                            ...existingData,
+                            _chainedFrom: event.type,
+                            _chainSourceId: event.id,
+                            _chainDepth: newDepth,
+                            // Pass through transactionId from trigger event (ADR-094)
+                            // Engine assigns this at action start; chained events inherit it
+                            ...(transactionId ? { _transactionId: transactionId } : {})
+                        }
+                    };
+                    results.push(enrichedEvent);
+                }
+            }
+        }
+        return results;
+    }
+    applyEvent(event) {
+        // First validate if we can apply this event
+        if (!this.canApplyEvent(event)) {
+            throw new Error(`Cannot apply event of type '${event.type}': validation failed`);
+        }
+        // Look up handler for this event type
+        const handler = this.eventHandlers.get(event.type);
+        if (!handler) {
+            // No handler registered - event is recorded but has no effect
+            // Silent when no handler - this is a valid use case
+        }
+        else {
+            // Apply the event through the handler
+            handler(event, this);
+        }
+        // Record the event in history
+        this.appliedEvents.push(event);
+        // Trim history if it exceeds the limit
+        if (this.appliedEvents.length > this.maxEventHistory) {
+            this.appliedEvents = this.appliedEvents.slice(-this.maxEventHistory);
+        }
+    }
+    canApplyEvent(event) {
+        // Check if there's a validator for this event type
+        const validator = this.eventValidators.get(event.type);
+        // If no validator registered, assume event is valid
+        if (!validator) {
+            return true;
+        }
+        // Run the validator
+        return validator(event, this);
+    }
+    previewEvent(event) {
+        // Check if there's a previewer for this event type
+        const previewer = this.eventPreviewers.get(event.type);
+        // If no previewer registered, return empty array
+        if (!previewer) {
+            return [];
+        }
+        // Run the previewer
+        return previewer(event, this);
+    }
+    getAppliedEvents() {
+        return [...this.appliedEvents];
+    }
+    getEventsSince(timestamp) {
+        return this.appliedEvents.filter(event => event.timestamp > timestamp);
+    }
+    clearEventHistory() {
+        this.appliedEvents = [];
+    }
+    // Rebuild ID counters by analyzing existing entities
+    rebuildIdCounters() {
+        // Clear counters
+        this.idCounters.clear();
+        // Find the highest ID for each prefix
+        for (const entity of this.entities.values()) {
+            const id = entity.id;
+            if (id.length >= 3) {
+                const prefix = id[0];
+                const numPart = id.substring(1);
+                // Parse the numeric part (base36)
+                const num = parseInt(numPart, 36);
+                if (!isNaN(num)) {
+                    const currentMax = this.idCounters.get(prefix) || 0;
+                    if (num > currentMax) {
+                        this.idCounters.set(prefix, num);
+                    }
+                }
+            }
+        }
+    }
+    // Get the data store for sharing with AuthorModel
+    getDataStore() {
+        // Return a reference to the WorldModel's internal state
+        // AuthorModel will share these same objects
+        return {
+            entities: this.entities,
+            spatialIndex: this.spatialIndex,
+            state: this.state,
+            playerId: this.playerId,
+            relationships: this.relationships,
+            idCounters: this.idCounters,
+            capabilities: this.capabilities
+        };
+    }
+    // Scope Management Methods
+    getScopeRegistry() {
+        return this.scopeRegistry;
+    }
+    // Vocabulary Management (ADR-082)
+    getGrammarVocabularyProvider() {
+        return this.grammarVocabularyProvider;
+    }
+    addScopeRule(rule) {
+        this.scopeRegistry.addRule(rule);
+        this.emitPlatformEvent('scope_rule_added', {
+            ruleId: rule.id,
+            fromLocations: rule.fromLocations,
+            forActions: rule.forActions
+        });
+    }
+    removeScopeRule(ruleId) {
+        const removed = this.scopeRegistry.removeRule(ruleId);
+        if (removed) {
+            this.emitPlatformEvent('scope_rule_removed', { ruleId });
+        }
+        return removed;
+    }
+    evaluateScope(actorId, actionId) {
+        const actor = this.getEntity(actorId);
+        if (!actor) {
+            console.warn('evaluateScope: No actor found for ID:', actorId);
+            return [];
+        }
+        const currentLocation = this.getLocation(actorId);
+        if (!currentLocation) {
+            console.warn('evaluateScope: No location found for actor:', actorId);
+            return [];
+        }
+        const context = {
+            world: this,
+            actorId,
+            actionId,
+            currentLocation
+        };
+        const result = this.scopeEvaluator.evaluate(context);
+        return Array.from(result.entityIds);
+    }
+    /**
+     * Register default scope rules for standard visibility
+     */
+    registerDefaultScopeRules() {
+        // Basic visibility rule - entities in same room
+        this.addScopeRule({
+            id: 'default_room_visibility',
+            fromLocations: '*',
+            includeEntities: (context) => {
+                const room = this.getEntity(context.currentLocation);
+                if (!room) {
+                    console.warn('No room found for location:', context.currentLocation);
+                    return [];
+                }
+                // Get all entities in the room
+                const contents = this.getContents(context.currentLocation);
+                const entityIds = contents.map(e => e.id);
+                // Add the room itself
+                entityIds.push(context.currentLocation);
+                // Add nested contents (in containers, on supporters)
+                for (const entity of contents) {
+                    const nested = this.getAllContents(entity.id);
+                    entityIds.push(...nested.map(e => e.id));
+                }
+                return entityIds;
+            },
+            priority: 50,
+            source: 'core'
+        });
+        // Carried items are always in scope
+        this.addScopeRule({
+            id: 'default_inventory_visibility',
+            fromLocations: '*',
+            includeEntities: (context) => {
+                const carried = this.getContents(context.actorId);
+                const entityIds = carried.map(e => e.id);
+                // Add nested contents of carried items
+                for (const entity of carried) {
+                    const nested = this.getAllContents(entity.id);
+                    entityIds.push(...nested.map(e => e.id));
+                }
+                return entityIds;
+            },
+            priority: 100,
+            source: 'core'
+        });
+    }
+    /**
+     * Get physically visible entities using VisibilityBehavior (line-of-sight)
+     *
+     * Returns entities that can actually be seen by the observer based on:
+     * - Physical location (must be in same room)
+     * - Container state (can't see inside closed opaque containers)
+     * - Lighting conditions (limited visibility in darkness)
+     * - Scenery visibility flags
+     *
+     * This is for perception and display purposes. For command resolution,
+     * use getInScope() instead which includes entities that can be referenced
+     * even if not visible.
+     *
+     * @param observerId - The entity doing the observing
+     * @returns Array of entities that are physically visible
+     */
+    getVisible(observerId) {
+        const observer = this.getEntity(observerId);
+        if (!observer)
+            return [];
+        return VisibilityBehavior_1.VisibilityBehavior.getVisible(observer, this);
+    }
+    /**
+     * Get entities in scope for command resolution using the scope system
+     *
+     * Returns entities that can be referenced in commands, including:
+     * - All entities in the current room
+     * - Items in containers (even closed ones)
+     * - Carried items and their contents
+     * - Entities made available by scope rules (e.g., through windows)
+     *
+     * This is for parser/command resolution. For physical visibility,
+     * use getVisible() instead.
+     *
+     * @param observerId - The entity whose scope to evaluate
+     * @returns Array of entities that can be referenced in commands
+     */
+    getInScope(observerId) {
+        const entityIds = this.evaluateScope(observerId);
+        return entityIds
+            .map(id => this.getEntity(id))
+            .filter((e) => e !== undefined);
+    }
+    /**
+     * Check if observer can physically see target (line-of-sight)
+     *
+     * Uses VisibilityBehavior to determine if target is visible based on:
+     * - Physical location
+     * - Container state
+     * - Lighting conditions
+     *
+     * This is for perception checks. To check if an entity can be
+     * referenced in commands, check if it's in getInScope() instead.
+     *
+     * @param observerId - The entity doing the observing
+     * @param targetId - The entity being observed
+     * @returns true if observer can see target
+     */
+    canSee(observerId, targetId) {
+        const observer = this.getEntity(observerId);
+        const target = this.getEntity(targetId);
+        if (!observer || !target)
+            return false;
+        return VisibilityBehavior_1.VisibilityBehavior.canSee(observer, target, this);
+    }
+    // ========== Convenience Creators ==========
+    /**
+     * Create a bidirectional connection between two rooms.
+     * Sets exits in both directions (e.g. NORTH on room1, SOUTH on room2).
+     */
+    connectRooms(room1Id, room2Id, direction) {
+        const room1 = this.getEntity(room1Id);
+        const room2 = this.getEntity(room2Id);
+        if (!room1 || !room2) {
+            throw new Error(`connectRooms: both rooms must exist (${room1Id}, ${room2Id})`);
+        }
+        const opposite = (0, directions_1.getOppositeDirection)(direction);
+        roomBehavior_1.RoomBehavior.setExit(room1, direction, room2Id);
+        roomBehavior_1.RoomBehavior.setExit(room2, opposite, room1Id);
+    }
+    /**
+     * Create a door entity and wire it into both rooms' exit data.
+     * The door is placed in room1 spatially (for scope resolution).
+     */
+    createDoor(displayName, opts) {
+        const room1 = this.getEntity(opts.room1Id);
+        const room2 = this.getEntity(opts.room2Id);
+        if (!room1 || !room2) {
+            throw new Error(`createDoor: both rooms must exist (${opts.room1Id}, ${opts.room2Id})`);
+        }
+        const door = this.createEntity(displayName, entity_types_1.EntityType.DOOR);
+        door.add(new identityTrait_1.IdentityTrait({
+            name: displayName,
+            aliases: opts.aliases,
+            description: opts.description,
+        }));
+        door.add(new door_1.DoorTrait({
+            room1: opts.room1Id,
+            room2: opts.room2Id,
+        }));
+        door.add(new scenery_1.SceneryTrait());
+        door.add(new openableTrait_1.OpenableTrait({ isOpen: opts.isOpen ?? false }));
+        if (opts.isLocked !== undefined || opts.keyId) {
+            door.add(new lockableTrait_1.LockableTrait({
+                isLocked: opts.isLocked ?? true,
+                ...(opts.keyId ? { requiredKey: opts.keyId } : {}),
+            }));
+        }
+        // Wire exits through the door
+        const opposite = (0, directions_1.getOppositeDirection)(opts.direction);
+        roomBehavior_1.RoomBehavior.setExit(room1, opts.direction, opts.room2Id, door.id);
+        roomBehavior_1.RoomBehavior.setExit(room2, opposite, opts.room1Id, door.id);
+        // Place door in room1 for scope resolution
+        this.moveEntity(door.id, opts.room1Id);
+        return door;
+    }
+}
+exports.WorldModel = WorldModel;
+//# sourceMappingURL=WorldModel.js.map