@sharpee/event-processor 0.9.60-beta

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 David Cornelson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# @sharpee/event-processor
+
+Event processing and state application for the Sharpee Interactive Fiction platform.
+
+## Installation
+
+```bash
+npm install @sharpee/event-processor
+```
+
+## Overview
+
+Applies semantic events to the world model:
+
+- **Event Application** - Updates world state based on events
+- **Event Ordering** - Ensures consistent state transitions
+- **Side Effects** - Triggers handlers for event types
+
+## Usage
+
+```typescript
+import { EventProcessor } from '@sharpee/event-processor';
+
+const processor = new EventProcessor(world);
+
+// Apply events from action execution
+const updatedWorld = processor.apply(events);
+```
+
+## Event Flow
+
+```
+Player Input → Parser → Action → Events → EventProcessor → Updated World
+```
+
+## Related Packages
+
+- [@sharpee/engine](https://www.npmjs.com/package/@sharpee/engine) - Game runtime
+- [@sharpee/sharpee](https://www.npmjs.com/package/@sharpee/sharpee) - Full platform bundle
+
+## License
+
+MIT

package/dist/effects/effect-processor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * EffectProcessor: Validates and applies effects per ADR-075
+ *
+ * This is the ONLY place effects become mutations. It validates effects,
+ * ensures atomicity (all-or-nothing), and applies them through proper channels.
+ */
+import { ISemanticEvent } from '@sharpee/core';
+import { WorldModel } from '@sharpee/world-model';
+import { Effect, EffectResult } from './types';
+/**
+ * Callback to emit events (provided by EventProcessor)
+ */
+export type EventEmitCallback = (events: ISemanticEvent[]) => void;
+/**
+ * EffectProcessor validates and applies effects atomically
+ */
+export declare class EffectProcessor {
+    private world;
+    private emitEvents?;
+    constructor(world: WorldModel, emitEvents?: EventEmitCallback | undefined);
+    private pendingEmittedEvents;
+    /**
+     * Process effects with two-phase atomic processing
+     *
+     * Phase 1: Validate ALL effects before applying any
+     * Phase 2: Apply all effects (atomic - all or nothing)
+     */
+    process(effects: Effect[]): EffectResult;
+    /**
+     * Validate all effects, returning any errors
+     */
+    private validateAll;
+    /**
+     * Validate a single effect
+     */
+    private validate;
+    /**
+     * Apply a single effect
+     */
+    private apply;
+    private applyScoreEffect;
+    private applyFlagEffect;
+    private applyMessageEffect;
+    private applyEmitEffect;
+    private applyMoveEntityEffect;
+    private applyUpdateEntityEffect;
+    private applySetStateEffect;
+    private applyUpdateExitsEffect;
+}
+//# sourceMappingURL=effect-processor.d.ts.map

package/dist/effects/effect-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-processor.d.ts","sourceRoot":"","sources":["../../src/effects/effect-processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAa,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,MAAM,EAEN,YAAY,EASb,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;AAEnE;;GAEG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,UAAU,CAAC;gBADX,KAAK,EAAE,UAAU,EACjB,UAAU,CAAC,EAAE,iBAAiB,YAAA;IAIxC,OAAO,CAAC,oBAAoB,CAAwB;IAEpD;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY;IAwBxC;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,QAAQ;IA2FhB;;OAEG;IACH,OAAO,CAAC,KAAK;IAgDb,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,sBAAsB;CAsB/B"}

package/dist/effects/effect-processor.js

@@ -0,0 +1,255 @@
+"use strict";
+/**
+ * EffectProcessor: Validates and applies effects per ADR-075
+ *
+ * This is the ONLY place effects become mutations. It validates effects,
+ * ensures atomicity (all-or-nothing), and applies them through proper channels.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EffectProcessor = void 0;
+const world_model_1 = require("@sharpee/world-model");
+/**
+ * EffectProcessor validates and applies effects atomically
+ */
+class EffectProcessor {
+    world;
+    emitEvents;
+    constructor(world, emitEvents) {
+        this.world = world;
+        this.emitEvents = emitEvents;
+    }
+    // Collect emitted events during processing
+    pendingEmittedEvents = [];
+    /**
+     * Process effects with two-phase atomic processing
+     *
+     * Phase 1: Validate ALL effects before applying any
+     * Phase 2: Apply all effects (atomic - all or nothing)
+     */
+    process(effects) {
+        // Reset emitted events collector
+        this.pendingEmittedEvents = [];
+        // Phase 1: Validate ALL effects before applying any
+        const errors = this.validateAll(effects);
+        if (errors.length > 0) {
+            return { success: false, errors, applied: [] };
+        }
+        // Phase 2: Apply all effects (atomic - all or nothing)
+        for (const effect of effects) {
+            this.apply(effect);
+        }
+        // Collect emitted events to return
+        const emittedEvents = this.pendingEmittedEvents.length > 0
+            ? [...this.pendingEmittedEvents]
+            : undefined;
+        this.pendingEmittedEvents = [];
+        return { success: true, errors: [], applied: effects, emittedEvents };
+    }
+    /**
+     * Validate all effects, returning any errors
+     */
+    validateAll(effects) {
+        const errors = [];
+        for (const effect of effects) {
+            const error = this.validate(effect);
+            if (error) {
+                errors.push({ effect, reason: error });
+            }
+        }
+        return errors;
+    }
+    /**
+     * Validate a single effect
+     */
+    validate(effect) {
+        switch (effect.type) {
+            case 'score':
+                if (typeof effect.points !== 'number') {
+                    return 'points must be a number';
+                }
+                break;
+            case 'flag':
+                if (!effect.name || typeof effect.name !== 'string') {
+                    return 'flag name required';
+                }
+                if (typeof effect.value !== 'boolean') {
+                    return 'flag value must be a boolean';
+                }
+                break;
+            case 'message':
+                if (!effect.id || typeof effect.id !== 'string') {
+                    return 'message id required';
+                }
+                break;
+            case 'emit':
+                if (!effect.event || !effect.event.type) {
+                    return 'emit effect requires a valid event';
+                }
+                break;
+            case 'move_entity':
+                if (!effect.entityId) {
+                    return 'entityId required';
+                }
+                if (!this.world.hasEntity(effect.entityId)) {
+                    return `entity ${effect.entityId} not found`;
+                }
+                if (effect.destination !== null && !this.world.hasEntity(effect.destination)) {
+                    return `destination ${effect.destination} not found`;
+                }
+                break;
+            case 'update_entity':
+                if (!effect.entityId) {
+                    return 'entityId required';
+                }
+                if (!this.world.hasEntity(effect.entityId)) {
+                    return `entity ${effect.entityId} not found`;
+                }
+                break;
+            case 'set_state':
+                if (!effect.key || typeof effect.key !== 'string') {
+                    return 'state key required';
+                }
+                break;
+            case 'update_exits':
+                if (!effect.roomId) {
+                    return 'roomId required';
+                }
+                if (!this.world.hasEntity(effect.roomId)) {
+                    return `room ${effect.roomId} not found`;
+                }
+                break;
+            case 'unblock':
+            case 'block':
+                if (!effect.room) {
+                    return 'room required';
+                }
+                if (!this.world.hasEntity(effect.room)) {
+                    return `room ${effect.room} not found`;
+                }
+                if (!effect.exit) {
+                    return 'exit direction required';
+                }
+                break;
+            case 'schedule':
+                if (!effect.daemon || typeof effect.daemon !== 'string') {
+                    return 'daemon id required';
+                }
+                if (typeof effect.turns !== 'number' || effect.turns < 0) {
+                    return 'turns must be a non-negative number';
+                }
+                break;
+        }
+        return null;
+    }
+    /**
+     * Apply a single effect
+     */
+    apply(effect) {
+        switch (effect.type) {
+            case 'score':
+                this.applyScoreEffect(effect);
+                break;
+            case 'flag':
+                this.applyFlagEffect(effect);
+                break;
+            case 'message':
+                this.applyMessageEffect(effect);
+                break;
+            case 'emit':
+                this.applyEmitEffect(effect);
+                break;
+            case 'move_entity':
+                this.applyMoveEntityEffect(effect);
+                break;
+            case 'update_entity':
+                this.applyUpdateEntityEffect(effect);
+                break;
+            case 'set_state':
+                this.applySetStateEffect(effect);
+                break;
+            case 'update_exits':
+                this.applyUpdateExitsEffect(effect);
+                break;
+            case 'unblock':
+                // TODO: Implement when exit blocking system is in place
+                break;
+            case 'block':
+                // TODO: Implement when exit blocking system is in place
+                break;
+            case 'schedule':
+                // TODO: Implement when scheduler integration is ready
+                break;
+        }
+    }
+    applyScoreEffect(effect) {
+        const scoring = this.world.getCapability('scoring');
+        if (scoring && typeof scoring.score === 'number') {
+            this.world.updateCapability('scoring', {
+                score: scoring.score + effect.points
+            });
+        }
+    }
+    applyFlagEffect(effect) {
+        this.world.setStateValue(`flag.${effect.name}`, effect.value);
+    }
+    applyMessageEffect(effect) {
+        if (this.emitEvents) {
+            const messageEvent = {
+                id: `msg-${Date.now()}-${Math.random().toString(36).slice(2)}`,
+                type: 'game.message',
+                timestamp: Date.now(),
+                entities: {},
+                data: {
+                    messageId: effect.id,
+                    ...effect.data
+                },
+                narrate: true
+            };
+            this.emitEvents([messageEvent]);
+        }
+    }
+    applyEmitEffect(effect) {
+        // Collect emitted events to return (instead of immediate callback)
+        this.pendingEmittedEvents.push(effect.event);
+        // Also call callback for backward compatibility
+        if (this.emitEvents) {
+            this.emitEvents([effect.event]);
+        }
+    }
+    applyMoveEntityEffect(effect) {
+        this.world.moveEntity(effect.entityId, effect.destination);
+    }
+    applyUpdateEntityEffect(effect) {
+        this.world.updateEntity(effect.entityId, (entity) => {
+            for (const [key, value] of Object.entries(effect.updates)) {
+                entity[key] = value;
+            }
+        });
+    }
+    applySetStateEffect(effect) {
+        this.world.setStateValue(effect.key, effect.value);
+    }
+    applyUpdateExitsEffect(effect) {
+        const room = this.world.getEntity(effect.roomId);
+        if (!room)
+            return;
+        const roomTrait = room.get(world_model_1.RoomTrait);
+        if (!roomTrait)
+            return;
+        if (!roomTrait.exits) {
+            roomTrait.exits = {};
+        }
+        // Cast exits to a mutable record for dynamic key access
+        const exits = roomTrait.exits;
+        for (const [direction, exitInfo] of Object.entries(effect.exits)) {
+            if (exitInfo === null) {
+                delete exits[direction];
+            }
+            else {
+                exits[direction] = exitInfo;
+            }
+        }
+    }
+}
+exports.EffectProcessor = EffectProcessor;
+//# sourceMappingURL=effect-processor.js.map

package/dist/effects/effect-processor.js.map

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

package/dist/effects/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Effects system for ADR-075
+ *
+ * Handlers receive read-only WorldQuery and return Effect[].
+ * EffectProcessor validates and applies effects atomically.
+ */
+export * from './types';
+export { WorldQuery, createWorldQuery } from './world-query';
+export { EffectProcessor, EventEmitCallback } from './effect-processor';
+//# sourceMappingURL=index.d.ts.map

package/dist/effects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/effects/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/effects/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Effects system for ADR-075
+ *
+ * Handlers receive read-only WorldQuery and return Effect[].
+ * EffectProcessor validates and applies effects atomically.
+ */
+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 });
+exports.EffectProcessor = exports.createWorldQuery = void 0;
+__exportStar(require("./types"), exports);
+var world_query_1 = require("./world-query");
+Object.defineProperty(exports, "createWorldQuery", { enumerable: true, get: function () { return world_query_1.createWorldQuery; } });
+var effect_processor_1 = require("./effect-processor");
+Object.defineProperty(exports, "EffectProcessor", { enumerable: true, get: function () { return effect_processor_1.EffectProcessor; } });
+//# sourceMappingURL=index.js.map

package/dist/effects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/effects/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,6CAA6D;AAAxC,+GAAA,gBAAgB,OAAA;AACrC,uDAAwE;AAA/D,mHAAA,eAAe,OAAA"}

package/dist/effects/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Effect types for ADR-075: Effects-Based Handler Pattern
+ *
+ * Effects are intents, not mutations. They describe what should happen, not how.
+ * Handlers return effects, which are validated and applied by EffectProcessor.
+ */
+import { ISemanticEvent } from '@sharpee/core';
+/**
+ * Effect for adding/subtracting score
+ */
+export interface ScoreEffect {
+    type: 'score';
+    points: number;
+    reason?: string;
+}
+/**
+ * Effect for setting a world flag
+ */
+export interface FlagEffect {
+    type: 'flag';
+    name: string;
+    value: boolean;
+}
+/**
+ * Effect for emitting a message to the player
+ */
+export interface MessageEffect {
+    type: 'message';
+    id: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Effect for emitting another semantic event
+ */
+export interface EmitEffect {
+    type: 'emit';
+    event: ISemanticEvent;
+}
+/**
+ * Effect for scheduling a daemon/fuse
+ */
+export interface ScheduleEffect {
+    type: 'schedule';
+    daemon: string;
+    turns: number;
+}
+/**
+ * Effect for unblocking an exit
+ */
+export interface UnblockEffect {
+    type: 'unblock';
+    exit: string;
+    room: string;
+}
+/**
+ * Effect for blocking an exit
+ */
+export interface BlockEffect {
+    type: 'block';
+    exit: string;
+    room: string;
+    reason?: string;
+}
+/**
+ * Effect for moving an entity
+ */
+export interface MoveEntityEffect {
+    type: 'move_entity';
+    entityId: string;
+    destination: string | null;
+}
+/**
+ * Effect for updating an entity's state
+ */
+export interface UpdateEntityEffect {
+    type: 'update_entity';
+    entityId: string;
+    updates: Record<string, unknown>;
+}
+/**
+ * Effect for setting world state value
+ */
+export interface SetStateEffect {
+    type: 'set_state';
+    key: string;
+    value: unknown;
+}
+/**
+ * Effect for updating room exits
+ */
+export interface UpdateExitsEffect {
+    type: 'update_exits';
+    roomId: string;
+    exits: Record<string, {
+        destination: string;
+    } | null>;
+}
+/**
+ * Union type of all effects
+ */
+export type Effect = ScoreEffect | FlagEffect | MessageEffect | EmitEffect | ScheduleEffect | UnblockEffect | BlockEffect | MoveEntityEffect | UpdateEntityEffect | SetStateEffect | UpdateExitsEffect;
+/**
+ * Error from effect validation
+ */
+export interface EffectError {
+    effect: Effect;
+    reason: string;
+}
+/**
+ * Result of processing effects
+ */
+export interface EffectResult {
+    success: boolean;
+    errors: EffectError[];
+    applied: Effect[];
+    /** Events emitted via EmitEffect (for adding to turn events) */
+    emittedEvents?: ISemanticEvent[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/effects/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/effects/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GACd,WAAW,GACX,UAAU,GACV,aAAa,GACb,UAAU,GACV,cAAc,GACd,aAAa,GACb,WAAW,GACX,gBAAgB,GAChB,kBAAkB,GAClB,cAAc,GACd,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gEAAgE;IAChE,aAAa,CAAC,EAAE,cAAc,EAAE,CAAC;CAClC"}

package/dist/effects/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Effect types for ADR-075: Effects-Based Handler Pattern
+ *
+ * Effects are intents, not mutations. They describe what should happen, not how.
+ * Handlers return effects, which are validated and applied by EffectProcessor.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/effects/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/effects/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/effects/world-query.d.ts

@@ -0,0 +1,70 @@
+/**
+ * WorldQuery: Read-only view of WorldModel for event handlers
+ *
+ * Per ADR-075, handlers receive a read-only query interface instead of
+ * full world access. This preserves stdlib as the gatekeeper for mutations.
+ */
+import type { IFEntity, TraitType, ICapabilityData, IWorldModel } from '@sharpee/world-model';
+/**
+ * Read-only query interface for handlers
+ *
+ * Allows handlers to read state to make decisions, but cannot mutate directly.
+ * Mutations happen through Effects processed by EffectProcessor.
+ */
+export interface WorldQuery {
+    /**
+     * Get an entity by ID
+     */
+    getEntity(id: string): IFEntity | undefined;
+    /**
+     * Check if an entity exists
+     */
+    hasEntity(id: string): boolean;
+    /**
+     * Get the player entity
+     */
+    getPlayer(): IFEntity | undefined;
+    /**
+     * Get the room the player is in
+     */
+    getCurrentRoom(): IFEntity | undefined;
+    /**
+     * Get the room an entity is in
+     */
+    getContainingRoom(entityId: string): IFEntity | undefined;
+    /**
+     * Get the location (parent) of an entity
+     */
+    getLocation(entityId: string): string | undefined;
+    /**
+     * Get contents of a container/room
+     */
+    getContents(containerId: string): IFEntity[];
+    /**
+     * Find entities by trait
+     */
+    findByTrait(traitType: TraitType): IFEntity[];
+    /**
+     * Find entities matching a predicate
+     */
+    findWhere(predicate: (entity: IFEntity) => boolean): IFEntity[];
+    /**
+     * Get a world state value
+     */
+    getStateValue(key: string): unknown;
+    /**
+     * Get a capability's data
+     */
+    getCapability(name: string): ICapabilityData | undefined;
+    /**
+     * Check if a capability exists
+     */
+    hasCapability(name: string): boolean;
+}
+/**
+ * Create a WorldQuery wrapper around a WorldModel
+ *
+ * This provides read-only access to the world model for event handlers.
+ */
+export declare function createWorldQuery(world: IWorldModel): WorldQuery;
+//# sourceMappingURL=world-query.d.ts.map

package/dist/effects/world-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-query.d.ts","sourceRoot":"","sources":["../../src/effects/world-query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9F;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAE5C;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAE/B;;OAEG;IACH,SAAS,IAAI,QAAQ,GAAG,SAAS,CAAC;IAElC;;OAEG;IACH,cAAc,IAAI,QAAQ,GAAG,SAAS,CAAC;IAEvC;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAE1D;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAElD;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAE7C;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,EAAE,CAAC;IAE9C;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,OAAO,GAAG,QAAQ,EAAE,CAAC;IAEhE;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAEpC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAEzD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,CAkB/D"}