@sharpee/event-processor 0.9.60-beta

package/dist/handlers/meta.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * Meta action event handlers
+ *
+ * Handles events for meta-game actions like waiting, scoring, help, etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleWaited = handleWaited;
+exports.handleScoreDisplayed = handleScoreDisplayed;
+exports.handleHelpDisplayed = handleHelpDisplayed;
+exports.handleAboutDisplayed = handleAboutDisplayed;
+exports.registerMetaHandlers = registerMetaHandlers;
+/**
+ * Handle waited event
+ *
+ * This event is fired when a player waits/passes time.
+ * Default behavior: Increment turn counter in shared data
+ *
+ * Can be overridden to:
+ * - Trigger time-based events (e.g., NPC movements, timed puzzles)
+ * - Update atmospheric descriptions (e.g., sun setting)
+ * - Advance story-specific timers
+ */
+function handleWaited(event, world) {
+    const data = event.data;
+    // Update turn counter
+    // TODO: Implement shared data storage in WorldModel
+    // const sharedData = world.getSharedData() || {};
+    // const currentTurns = sharedData.turns || 0;
+    // world.setSharedData({
+    //   ...sharedData,
+    //   turns: currentTurns + (data.turnsPassed || 1)
+    // });
+    // Default: Just advance time
+    // Story authors can override to add time-based events
+}
+/**
+ * Handle score_displayed event
+ *
+ * This event is fired when a player checks their score.
+ * Default behavior: No world state changes (display only)
+ *
+ * Can be overridden to:
+ * - Track how often player checks score
+ * - Trigger achievements based on score milestones
+ * - Update NPC reactions based on player progress
+ */
+function handleScoreDisplayed(event, world) {
+    const data = event.data;
+    // Default: No state changes
+    // This is primarily a display event
+    // Could track score checks for analytics
+    // TODO: Implement shared data storage in WorldModel
+    // const sharedData = world.getSharedData() || {};
+    // const scoreChecks = sharedData.scoreChecks || 0;
+    // world.setSharedData({
+    //   ...sharedData,
+    //   scoreChecks: scoreChecks + 1
+    // });
+}
+/**
+ * Handle help_displayed event
+ *
+ * This event is fired when a player requests help.
+ * Default behavior: Mark help as requested in shared data
+ *
+ * Can be overridden to:
+ * - Track which help topics were viewed
+ * - Adjust difficulty based on help usage
+ * - Provide context-sensitive help
+ */
+function handleHelpDisplayed(event, world) {
+    const data = event.data;
+    // Mark that help has been requested
+    // TODO: Implement shared data storage in WorldModel
+    // if (data.firstTime) {
+    //   const sharedData = world.getSharedData() || {};
+    //   world.setSharedData({
+    //     ...sharedData,
+    //     helpRequested: true,
+    //     firstHelpTime: Date.now()
+    //   });
+    // }
+    // Track help topics if specific help requested
+    // if (data.specificHelp && data.topic) {
+    //   const sharedData = world.getSharedData() || {};
+    //   const helpTopics = sharedData.helpTopics || [];
+    //   if (!helpTopics.includes(data.topic)) {
+    //     helpTopics.push(data.topic);
+    //     world.setSharedData({
+    //       ...sharedData,
+    //       helpTopics
+    //     });
+    //   }
+    // }
+}
+/**
+ * Handle about_displayed event
+ *
+ * This event is fired when a player requests game information.
+ * Default behavior: Track that about was viewed
+ *
+ * Can be overridden to:
+ * - Unlock easter eggs for viewing credits
+ * - Track completion statistics
+ */
+function handleAboutDisplayed(event, world) {
+    const data = event.data;
+    // Track that about/credits were viewed
+    // TODO: Implement shared data storage in WorldModel
+    // const sharedData = world.getSharedData() || {};
+    // world.setSharedData({
+    //   ...sharedData,
+    //   aboutViewed: true,
+    //   aboutViewedTime: Date.now()
+    // });
+    // Could unlock an achievement for viewing credits
+    // Story authors can override to add easter eggs
+}
+/**
+ * Register all meta action event handlers
+ */
+function registerMetaHandlers(world) {
+    world.registerEventHandler('waited', handleWaited);
+    world.registerEventHandler('score_displayed', handleScoreDisplayed);
+    world.registerEventHandler('help_displayed', handleHelpDisplayed);
+    world.registerEventHandler('about_displayed', handleAboutDisplayed);
+}
+//# sourceMappingURL=meta.js.map

package/dist/handlers/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/handlers/meta.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAgBH,oCAiBC;AAaD,oDAqBC;AAaD,kDAiCC;AAYD,oDAuBC;AAKD,oDAKC;AAzJD;;;;;;;;;;GAUG;AACH,SAAgB,YAAY,CAAC,KAAqB,EAAE,KAAU;IAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,IAGlB,CAAC;IAEF,sBAAsB;IACtB,oDAAoD;IACpD,kDAAkD;IAClD,8CAA8C;IAC9C,wBAAwB;IACxB,mBAAmB;IACnB,kDAAkD;IAClD,MAAM;IAEN,6BAA6B;IAC7B,sDAAsD;AACxD,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,oBAAoB,CAAC,KAAqB,EAAE,KAAU;IACpE,MAAM,IAAI,GAAG,KAAK,CAAC,IAOlB,CAAC;IAEF,4BAA4B;IAC5B,oCAAoC;IAEpC,yCAAyC;IACzC,oDAAoD;IACpD,kDAAkD;IAClD,mDAAmD;IACnD,wBAAwB;IACxB,mBAAmB;IACnB,iCAAiC;IACjC,MAAM;AACR,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,mBAAmB,CAAC,KAAqB,EAAE,KAAU;IACnE,MAAM,IAAI,GAAG,KAAK,CAAC,IAOlB,CAAC;IAEF,oCAAoC;IACpC,oDAAoD;IACpD,wBAAwB;IACxB,oDAAoD;IACpD,0BAA0B;IAC1B,qBAAqB;IACrB,2BAA2B;IAC3B,gCAAgC;IAChC,QAAQ;IACR,IAAI;IAEJ,+CAA+C;IAC/C,yCAAyC;IACzC,oDAAoD;IACpD,oDAAoD;IACpD,4CAA4C;IAC5C,mCAAmC;IACnC,4BAA4B;IAC5B,uBAAuB;IACvB,mBAAmB;IACnB,UAAU;IACV,MAAM;IACN,IAAI;AACN,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,oBAAoB,CAAC,KAAqB,EAAE,KAAU;IACpE,MAAM,IAAI,GAAG,KAAK,CAAC,IASlB,CAAC;IAEF,uCAAuC;IACvC,oDAAoD;IACpD,kDAAkD;IAClD,wBAAwB;IACxB,mBAAmB;IACnB,uBAAuB;IACvB,gCAAgC;IAChC,MAAM;IAEN,kDAAkD;IAClD,gDAAgD;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,KAAiB;IACpD,KAAK,CAAC,oBAAoB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACnD,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;IACpE,KAAK,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IAClE,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;AACtE,CAAC"}

package/dist/handlers/movement.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Movement event handlers
+ *
+ * These handlers apply movement-related events to the world model
+ */
+import { WorldModel, EventHandler } from '@sharpee/world-model';
+/**
+ * Handle TAKEN event - move item to actor
+ */
+export declare const handleTaken: EventHandler;
+/**
+ * Handle DROPPED event - move item to location
+ */
+export declare const handleDropped: EventHandler;
+/**
+ * Handle REMOVED event - remove worn status
+ */
+export declare const handleRemoved: EventHandler;
+/**
+ * Handle ACTOR_MOVED event - move actor to new location
+ */
+export declare const handleActorMoved: EventHandler;
+/**
+ * Handle PUT_IN event - move item into container
+ */
+export declare const handlePutIn: EventHandler;
+/**
+ * Handle PUT_ON event - move item onto supporter
+ */
+export declare const handlePutOn: EventHandler;
+/**
+ * Handle REMOVED_FROM event - move item from container to actor
+ */
+export declare const handleRemovedFrom: EventHandler;
+/**
+ * Handle ENTERED event - actor enters an object or vehicle
+ */
+export declare const handleEntered: EventHandler;
+/**
+ * Handle EXITED event - actor exits an object or vehicle
+ */
+export declare const handleExited: EventHandler;
+/**
+ * Handle CLIMBED event - record climbing action (movement handled separately)
+ */
+export declare const handleClimbed: EventHandler;
+/**
+ * Register all movement handlers
+ */
+export declare function registerMovementHandlers(world: WorldModel): void;
+//# sourceMappingURL=movement.d.ts.map

package/dist/handlers/movement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"movement.d.ts","sourceRoot":"","sources":["../../src/handlers/movement.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAiD,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAG/G;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,YAkBzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,YAO3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,YAc3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAiC9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,YAKzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,YAKzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAK/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,YAM3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YAO1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,YAI3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAWhE"}

package/dist/handlers/movement.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Movement event handlers
+ *
+ * These handlers apply movement-related events to the world model
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleClimbed = exports.handleExited = exports.handleEntered = exports.handleRemovedFrom = exports.handlePutOn = exports.handlePutIn = exports.handleActorMoved = exports.handleRemoved = exports.handleDropped = exports.handleTaken = void 0;
+exports.registerMovementHandlers = registerMovementHandlers;
+const world_model_1 = require("@sharpee/world-model");
+const if_domain_1 = require("@sharpee/if-domain");
+/**
+ * Handle TAKEN event - move item to actor
+ */
+const handleTaken = (event, world) => {
+    const { actor, target } = event.entities;
+    if (actor && target) {
+        // Remove worn status if applicable
+        const targetEntity = world.getEntity(target);
+        if (targetEntity && targetEntity.has(world_model_1.TraitType.WEARABLE)) {
+            // Remove worn status if wearable
+            world.updateEntity(target, (entity) => {
+                const wearableTrait = entity.get(world_model_1.TraitType.WEARABLE);
+                if (wearableTrait?.worn) {
+                    wearableTrait.worn = false;
+                }
+            });
+        }
+        // Move the item to the actor
+        world.moveEntity(target, actor);
+    }
+};
+exports.handleTaken = handleTaken;
+/**
+ * Handle DROPPED event - move item to location
+ */
+const handleDropped = (event, world) => {
+    const { actor, target, location } = event.entities;
+    const dropLocation = location || (actor ? world.getLocation(actor) : undefined);
+    if (target && dropLocation) {
+        world.moveEntity(target, dropLocation);
+    }
+};
+exports.handleDropped = handleDropped;
+/**
+ * Handle REMOVED event - remove worn status
+ */
+const handleRemoved = (event, world) => {
+    const { target } = event.entities;
+    if (target) {
+        const entity = world.getEntity(target);
+        if (entity && entity.has(world_model_1.TraitType.WEARABLE)) {
+            // Remove worn status
+            world.updateEntity(target, (entity) => {
+                const wearableTrait = entity.get(world_model_1.TraitType.WEARABLE);
+                if (wearableTrait?.worn) {
+                    wearableTrait.worn = false;
+                }
+            });
+        }
+    }
+};
+exports.handleRemoved = handleRemoved;
+/**
+ * Handle ACTOR_MOVED event - move actor to new location
+ */
+const handleActorMoved = (event, world) => {
+    const { actor, location } = event.entities;
+    if (actor && location) {
+        // Mark previous location as visited if it's a room
+        const currentLocation = world.getLocation(actor);
+        if (currentLocation) {
+            const currentRoom = world.getEntity(currentLocation);
+            if (currentRoom && currentRoom.has(world_model_1.TraitType.ROOM)) {
+                // Mark as visited
+                world.updateEntity(currentLocation, (room) => {
+                    const roomTrait = room.get(world_model_1.TraitType.ROOM);
+                    if (roomTrait && !roomTrait.visited) {
+                        roomTrait.visited = true;
+                    }
+                });
+            }
+        }
+        // Move the actor
+        world.moveEntity(actor, location);
+        // Mark new location as visited if it's a room
+        const newRoom = world.getEntity(location);
+        if (newRoom && newRoom.has(world_model_1.TraitType.ROOM)) {
+            // Mark new location as visited
+            world.updateEntity(location, (room) => {
+                const roomTrait = room.get(world_model_1.TraitType.ROOM);
+                if (roomTrait && !roomTrait.visited) {
+                    roomTrait.visited = true;
+                }
+            });
+        }
+    }
+};
+exports.handleActorMoved = handleActorMoved;
+/**
+ * Handle PUT_IN event - move item into container
+ */
+const handlePutIn = (event, world) => {
+    const { target, location } = event.entities;
+    if (target && location) {
+        world.moveEntity(target, location);
+    }
+};
+exports.handlePutIn = handlePutIn;
+/**
+ * Handle PUT_ON event - move item onto supporter
+ */
+const handlePutOn = (event, world) => {
+    const { target, location } = event.entities;
+    if (target && location) {
+        world.moveEntity(target, location);
+    }
+};
+exports.handlePutOn = handlePutOn;
+/**
+ * Handle REMOVED_FROM event - move item from container to actor
+ */
+const handleRemovedFrom = (event, world) => {
+    const { actor, target } = event.entities;
+    if (actor && target) {
+        world.moveEntity(target, actor);
+    }
+};
+exports.handleRemovedFrom = handleRemovedFrom;
+/**
+ * Handle ENTERED event - actor enters an object or vehicle
+ */
+const handleEntered = (event, world) => {
+    const { actor, location } = event.entities;
+    if (actor && location) {
+        // Move the actor to the new location
+        world.moveEntity(actor, location);
+    }
+};
+exports.handleEntered = handleEntered;
+/**
+ * Handle EXITED event - actor exits an object or vehicle
+ */
+const handleExited = (event, world) => {
+    const { actor, location } = event.entities;
+    if (actor && location) {
+        // Move the actor to the new location
+        world.moveEntity(actor, location);
+    }
+};
+exports.handleExited = handleExited;
+/**
+ * Handle CLIMBED event - record climbing action (movement handled separately)
+ */
+const handleClimbed = (event, world) => {
+    // This event is mainly for tracking/logging purposes
+    // The actual movement is handled by ENTERED or ACTOR_MOVED events
+    // Could be used for achievements, scoring, or special effects
+};
+exports.handleClimbed = handleClimbed;
+/**
+ * Register all movement handlers
+ */
+function registerMovementHandlers(world) {
+    world.registerEventHandler(if_domain_1.IFEvents.TAKEN, exports.handleTaken);
+    world.registerEventHandler(if_domain_1.IFEvents.DROPPED, exports.handleDropped);
+    world.registerEventHandler(if_domain_1.IFEvents.REMOVED, exports.handleRemoved);
+    world.registerEventHandler(if_domain_1.IFEvents.ACTOR_MOVED, exports.handleActorMoved);
+    world.registerEventHandler(if_domain_1.IFEvents.PUT_IN, exports.handlePutIn);
+    world.registerEventHandler(if_domain_1.IFEvents.PUT_ON, exports.handlePutOn);
+    world.registerEventHandler(if_domain_1.IFEvents.REMOVED_FROM, exports.handleRemovedFrom);
+    world.registerEventHandler(if_domain_1.IFEvents.ENTERED, exports.handleEntered);
+    world.registerEventHandler(if_domain_1.IFEvents.EXITED, exports.handleExited);
+    world.registerEventHandler(if_domain_1.IFEvents.CLIMBED, exports.handleClimbed);
+}
+//# sourceMappingURL=movement.js.map

package/dist/handlers/movement.js.map

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

package/dist/handlers/observation/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Observation event handlers module
+ */
+export * from './observation-handlers';
+export * from './sensory';
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/observation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/handlers/observation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC"}

package/dist/handlers/observation/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Observation event handlers module
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./observation-handlers"), exports);
+__exportStar(require("./sensory"), exports);
+//# sourceMappingURL=index.js.map

package/dist/handlers/observation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/handlers/observation/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,yDAAuC;AACvC,4CAA0B"}

package/dist/handlers/observation/observation-handlers.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Handle player.checked_inventory event
+ *
+ * This event is fired when a player checks their inventory.
+ * This is an observable action - NPCs can see the player checking pockets/bags.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Trigger NPC comments about the player's behavior
+ * - Track how often the player checks inventory
+ * - Reveal pickpocket attempts when player notices missing items
+ */
+export declare function handlePlayerCheckedInventory(event: ISemanticEvent, world: any): void;
+/**
+ * Handle player.inventory_empty event
+ *
+ * This event is fired when a player checks inventory and it's empty.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Trigger NPC sympathy or mockery
+ * - Reveal hidden items in desperate situations
+ * - Track story progress (player has given away everything)
+ */
+export declare function handlePlayerInventoryEmpty(event: ISemanticEvent, world: any): void;
+/**
+ * Handle text.inventory_list event
+ *
+ * This event requests the inventory contents be displayed.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Track which items the player knows they have
+ * - Update item descriptions based on inventory context
+ */
+export declare function handleTextInventoryList(event: ISemanticEvent, world: any): void;
+/**
+ * Observation event handlers
+ *
+ * Handles events related to looking, examining, and other observation actions
+ */
+import { ISemanticEvent } from '@sharpee/core';
+import { WorldModel } from '@sharpee/world-model';
+/**
+ * Handle player.looked event
+ *
+ * This event is fired when a player looks around their current location.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Trigger NPC reactions (e.g., NPC notices player looking around)
+ * - Update room states (e.g., reveal hidden items after first look)
+ * - Track player behavior for adaptive storytelling
+ */
+export declare function handlePlayerLooked(event: ISemanticEvent, world: any): void;
+/**
+ * Handle player.examined event
+ *
+ * This event is fired when a player examines a specific entity.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Mark items as "seen" or "known"
+ * - Trigger NPC reactions to being examined
+ * - Reveal hidden properties after examination
+ * - Update player knowledge/memory
+ */
+export declare function handlePlayerExamined(event: ISemanticEvent, world: any): void;
+/**
+ * Handle text.room_description event
+ *
+ * This event requests a room description be displayed.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Track which rooms have been described
+ * - Update room state after description (e.g., mark as visited)
+ * - Trigger timed events after entering a room
+ */
+export declare function handleTextRoomDescription(event: ISemanticEvent, world: any): void;
+/**
+ * Handle text.list_contents event
+ *
+ * This event requests a list of visible contents be displayed.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Track what items the player has noticed
+ * - Update item states when listed
+ */
+export declare function handleTextListContents(event: ISemanticEvent, world: any): void;
+/**
+ * Register all observation-related event handlers
+ */
+export declare function registerObservationHandlers(world: WorldModel): void;
+//# sourceMappingURL=observation-handlers.d.ts.map

package/dist/handlers/observation/observation-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-handlers.d.ts","sourceRoot":"","sources":["../../../src/handlers/observation/observation-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAqBpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAQlF;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAW/E;AAED;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAY,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAyB1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAS5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CASjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAS9E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAWnE"}

package/dist/handlers/observation/observation-handlers.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handlePlayerCheckedInventory = handlePlayerCheckedInventory;
+exports.handlePlayerInventoryEmpty = handlePlayerInventoryEmpty;
+exports.handleTextInventoryList = handleTextInventoryList;
+exports.handlePlayerLooked = handlePlayerLooked;
+exports.handlePlayerExamined = handlePlayerExamined;
+exports.handleTextRoomDescription = handleTextRoomDescription;
+exports.handleTextListContents = handleTextListContents;
+exports.registerObservationHandlers = registerObservationHandlers;
+/**
+ * Handle player.checked_inventory event
+ *
+ * This event is fired when a player checks their inventory.
+ * This is an observable action - NPCs can see the player checking pockets/bags.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Trigger NPC comments about the player's behavior
+ * - Track how often the player checks inventory
+ * - Reveal pickpocket attempts when player notices missing items
+ */
+function handlePlayerCheckedInventory(event, world) {
+    const data = event.data;
+    // Default: No state changes
+    // Story authors can override to add NPC reactions
+    // Example Floyd reaction:
+    // const npcs = world.getContents(data.locationId)
+    //   .filter(e => e.has('ACTOR') && e.id === 'floyd');
+    // 
+    // if (npcs.length > 0 && Math.random() > 0.7) {
+    //   world.applyEvent(createEvent('text.npc_comment', {
+    //     npcId: 'floyd',
+    //     text: 'Floyd remarks, "You spend a lot of time playing pocket pool."',
+    //     timestamp: Date.now()
+    //   }));
+    // }
+}
+/**
+ * Handle player.inventory_empty event
+ *
+ * This event is fired when a player checks inventory and it's empty.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Trigger NPC sympathy or mockery
+ * - Reveal hidden items in desperate situations
+ * - Track story progress (player has given away everything)
+ */
+function handlePlayerInventoryEmpty(event, world) {
+    const data = event.data;
+    // Default: No state changes
+}
+/**
+ * Handle text.inventory_list event
+ *
+ * This event requests the inventory contents be displayed.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Track which items the player knows they have
+ * - Update item descriptions based on inventory context
+ */
+function handleTextInventoryList(event, world) {
+    const data = event.data;
+    // Default: No state changes
+    // This is primarily a text output event
+}
+/**
+ * Handle player.looked event
+ *
+ * This event is fired when a player looks around their current location.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Trigger NPC reactions (e.g., NPC notices player looking around)
+ * - Update room states (e.g., reveal hidden items after first look)
+ * - Track player behavior for adaptive storytelling
+ */
+function handlePlayerLooked(event, world) {
+    const data = event.data;
+    // Default: No state changes
+    // Story authors can override to add reactions
+    // Example of what a story might do:
+    // const location = world.getEntity(data.locationId);
+    // const npcsInRoom = world.getContents(data.locationId)
+    //   .filter(e => e.has('ACTOR') && !e.has('PLAYER'));
+    // 
+    // for (const npc of npcsInRoom) {
+    //   if (npc.get('EMOTIONAL_STATE')?.mood === 'nervous') {
+    //     // NPC gets startled when player looks around
+    //     world.applyEvent(createEvent('npc.startled', {
+    //       npcId: npc.id,
+    //       cause: 'player_looked',
+    //       timestamp: Date.now()
+    //     }));
+    //   }
+    // }
+}
+/**
+ * Handle player.examined event
+ *
+ * This event is fired when a player examines a specific entity.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Mark items as "seen" or "known"
+ * - Trigger NPC reactions to being examined
+ * - Reveal hidden properties after examination
+ * - Update player knowledge/memory
+ */
+function handlePlayerExamined(event, world) {
+    const data = event.data;
+    // Default: No state changes
+    // Story authors can override to add reactions
+}
+/**
+ * Handle text.room_description event
+ *
+ * This event requests a room description be displayed.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Track which rooms have been described
+ * - Update room state after description (e.g., mark as visited)
+ * - Trigger timed events after entering a room
+ */
+function handleTextRoomDescription(event, world) {
+    const data = event.data;
+    // Default: No state changes
+    // This is primarily a text output event
+}
+/**
+ * Handle text.list_contents event
+ *
+ * This event requests a list of visible contents be displayed.
+ * Default behavior: No world state changes
+ *
+ * Can be overridden to:
+ * - Track what items the player has noticed
+ * - Update item states when listed
+ */
+function handleTextListContents(event, world) {
+    const data = event.data;
+    // Default: No state changes
+    // This is primarily a text output event
+}
+/**
+ * Register all observation-related event handlers
+ */
+function registerObservationHandlers(world) {
+    // Looking handlers
+    world.registerEventHandler('player.looked', handlePlayerLooked);
+    world.registerEventHandler('player.examined', handlePlayerExamined);
+    world.registerEventHandler('text.room_description', handleTextRoomDescription);
+    world.registerEventHandler('text.list_contents', handleTextListContents);
+    // Inventory handlers
+    world.registerEventHandler('player.checked_inventory', handlePlayerCheckedInventory);
+    world.registerEventHandler('player.inventory_empty', handlePlayerInventoryEmpty);
+    world.registerEventHandler('text.inventory_list', handleTextInventoryList);
+}
+//# sourceMappingURL=observation-handlers.js.map