@sharpee/stdlib 0.9.109 → 0.9.110

package/npc/npc-service.js

@@ -0,0 +1,414 @@
+"use strict";
+/**
+ * NPC Service (ADR-070)
+ *
+ * Manages NPC behaviors, executes NPC actions, and handles the NPC turn phase.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NpcService = void 0;
+exports.registerNpcCombatResolver = registerNpcCombatResolver;
+exports.clearNpcCombatResolver = clearNpcCombatResolver;
+exports.createNpcService = createNpcService;
+const world_model_1 = require("../../world-model/index.js");
+const npc_messages_1 = require("./npc-messages");
+const lucidity_decay_1 = require("./lucidity-decay");
+/**
+ * Module-level NPC combat resolver. Set via registerNpcCombatResolver().
+ * Uses globalThis to share across module boundaries (same pattern as interceptor registry).
+ */
+const NPC_COMBAT_RESOLVER_KEY = '__sharpee_npc_combat_resolver__';
+function getNpcCombatResolver() {
+    return globalThis[NPC_COMBAT_RESOLVER_KEY];
+}
+/**
+ * Register an NPC combat resolver.
+ *
+ * Call this in your story's initializeWorld() to provide combat resolution
+ * for NPC attack actions. Without a resolver, NPC attacks produce bare events.
+ *
+ * @param resolver - Function that resolves NPC→target combat and returns events
+ */
+function registerNpcCombatResolver(resolver) {
+    globalThis[NPC_COMBAT_RESOLVER_KEY] = resolver;
+}
+/**
+ * Clear the NPC combat resolver. Used for testing cleanup.
+ */
+function clearNpcCombatResolver() {
+    delete globalThis[NPC_COMBAT_RESOLVER_KEY];
+}
+/**
+ * Create an event ID
+ */
+function createEventId(prefix) {
+    return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * Create a semantic event
+ */
+function createEvent(type, data, npcId) {
+    return {
+        id: createEventId('npc'),
+        type,
+        timestamp: Date.now(),
+        entities: npcId ? { actor: npcId } : {},
+        data,
+    };
+}
+/**
+ * NPC Service implementation
+ */
+class NpcService {
+    behaviors = new Map();
+    tickPhases = [];
+    registerBehavior(behavior) {
+        this.behaviors.set(behavior.id, behavior);
+    }
+    removeBehavior(id) {
+        this.behaviors.delete(id);
+    }
+    getBehavior(id) {
+        return this.behaviors.get(id);
+    }
+    /**
+     * Register a tick phase handler (ADR-142/144/145/146).
+     * Phases run in registration order after behavior onTurn processing.
+     *
+     * @param name - Phase name for debugging
+     * @param handler - Function called with active NPCs and tick context
+     */
+    registerTickPhase(name, handler) {
+        this.tickPhases.push({ name, handler });
+    }
+    /**
+     * Execute the NPC turn phase
+     */
+    tick(context) {
+        const events = [];
+        const { world, turn, random, playerLocation, playerId } = context;
+        // Find all NPCs that can act
+        const npcs = this.getActiveNpcs(world);
+        // Process each NPC
+        for (const npc of npcs) {
+            const npcTrait = npc.get(world_model_1.TraitType.NPC);
+            // Direct property access — canAct getter doesn't survive loadJSON()
+            if (!npcTrait || !npcTrait.isAlive || !npcTrait.isConscious)
+                continue;
+            const behavior = this.getBehaviorForNpc(npc);
+            if (!behavior)
+                continue;
+            const npcLocation = world.getLocation(npc.id) || '';
+            const npcContext = this.createNpcContext(npc, world, random, turn, playerLocation, npcLocation);
+            // Call onTurn hook
+            const actions = behavior.onTurn(npcContext);
+            const actionEvents = this.executeActions(npc, actions, world, random);
+            events.push(...actionEvents);
+            // Process lucidity decay for NPCs with character model (ADR-141)
+            if (npc.has(world_model_1.TraitType.CHARACTER_MODEL)) {
+                const decayEvents = (0, lucidity_decay_1.processLucidityDecay)(npc, world, turn);
+                events.push(...decayEvents);
+            }
+        }
+        // Registered tick phases (ADR-142/144/145/146)
+        for (const phase of this.tickPhases) {
+            const phaseEvents = phase.handler(npcs, context);
+            events.push(...phaseEvents);
+        }
+        return events;
+    }
+    /**
+     * Notify NPCs that player entered a room
+     */
+    onPlayerEnters(world, roomId, random, turn) {
+        const events = [];
+        const playerId = world.getPlayer()?.id || '';
+        // Get NPCs in the room
+        const entities = world.getContents(roomId);
+        const npcs = entities.filter((e) => e.has(world_model_1.TraitType.NPC));
+        for (const npc of npcs) {
+            const npcTrait = npc.get(world_model_1.TraitType.NPC);
+            if (!npcTrait || !npcTrait.isAlive || !npcTrait.isConscious)
+                continue;
+            const behavior = this.getBehaviorForNpc(npc);
+            if (!behavior?.onPlayerEnters)
+                continue;
+            const npcContext = this.createNpcContext(npc, world, random, turn, roomId, roomId);
+            const actions = behavior.onPlayerEnters(npcContext);
+            const actionEvents = this.executeActions(npc, actions, world, random);
+            events.push(...actionEvents);
+        }
+        return events;
+    }
+    /**
+     * Notify NPCs that player left a room
+     */
+    onPlayerLeaves(world, roomId, random, turn) {
+        const events = [];
+        const playerId = world.getPlayer()?.id || '';
+        const playerLocation = world.getLocation(playerId) || '';
+        // Get NPCs in the old room
+        const entities = world.getContents(roomId);
+        const npcs = entities.filter((e) => e.has(world_model_1.TraitType.NPC));
+        for (const npc of npcs) {
+            const npcTrait = npc.get(world_model_1.TraitType.NPC);
+            if (!npcTrait || !npcTrait.isAlive || !npcTrait.isConscious)
+                continue;
+            const behavior = this.getBehaviorForNpc(npc);
+            if (!behavior?.onPlayerLeaves)
+                continue;
+            const npcContext = this.createNpcContext(npc, world, random, turn, playerLocation, roomId);
+            const actions = behavior.onPlayerLeaves(npcContext);
+            const actionEvents = this.executeActions(npc, actions, world, random);
+            events.push(...actionEvents);
+        }
+        return events;
+    }
+    /**
+     * Handle player speaking to an NPC
+     */
+    onPlayerSpeaks(world, npcId, words, random, turn) {
+        const npc = world.getEntity(npcId);
+        if (!npc)
+            return [];
+        const npcTrait = npc.get(world_model_1.TraitType.NPC);
+        if (!npcTrait || !npcTrait.isAlive || !npcTrait.isConscious)
+            return [];
+        const behavior = this.getBehaviorForNpc(npc);
+        if (!behavior?.onSpokenTo) {
+            // Default response if no handler
+            return [
+                createEvent('npc.spoke', {
+                    npc: npcId,
+                    messageId: npc_messages_1.NpcMessages.NPC_NO_RESPONSE,
+                    data: { npcName: npc.name },
+                }, npcId),
+            ];
+        }
+        const playerId = world.getPlayer()?.id || '';
+        const playerLocation = world.getLocation(playerId) || '';
+        const npcLocation = world.getLocation(npcId) || '';
+        const npcContext = this.createNpcContext(npc, world, random, turn, playerLocation, npcLocation);
+        const actions = behavior.onSpokenTo(npcContext, words);
+        return this.executeActions(npc, actions, world, random);
+    }
+    /**
+     * Handle player attacking an NPC
+     */
+    onNpcAttacked(world, npcId, attackerId, random, turn) {
+        const npc = world.getEntity(npcId);
+        if (!npc)
+            return [];
+        const npcTrait = npc.get(world_model_1.TraitType.NPC);
+        if (!npcTrait || !npcTrait.isAlive || !npcTrait.isConscious)
+            return [];
+        const behavior = this.getBehaviorForNpc(npc);
+        if (!behavior?.onAttacked)
+            return [];
+        const attacker = world.getEntity(attackerId);
+        if (!attacker)
+            return [];
+        const playerLocation = world.getLocation(attackerId) || '';
+        const npcLocation = world.getLocation(npcId) || '';
+        const npcContext = this.createNpcContext(npc, world, random, turn, playerLocation, npcLocation);
+        const actions = behavior.onAttacked(npcContext, attacker);
+        return this.executeActions(npc, actions, world, random);
+    }
+    // ==================== Private Helpers ====================
+    getActiveNpcs(world) {
+        const allEntities = world.getAllEntities();
+        return allEntities.filter((e) => {
+            if (!e.has(world_model_1.TraitType.NPC))
+                return false;
+            const npcTrait = e.get(world_model_1.TraitType.NPC);
+            // Use direct property access — canAct getter doesn't survive loadJSON() deserialization
+            return npcTrait.isAlive && npcTrait.isConscious;
+        });
+    }
+    getBehaviorForNpc(npc) {
+        const npcTrait = npc.get(world_model_1.TraitType.NPC);
+        if (!npcTrait.behaviorId)
+            return undefined;
+        return this.behaviors.get(npcTrait.behaviorId);
+    }
+    createNpcContext(npc, world, random, turn, playerLocation, npcLocation) {
+        const npcInventory = world.getContents(npc.id);
+        return {
+            npc,
+            world,
+            random,
+            turnCount: turn,
+            playerLocation,
+            npcLocation,
+            npcInventory,
+            playerVisible: npcLocation === playerLocation,
+            getEntitiesInRoom: () => world.getContents(npcLocation),
+            getAvailableExits: () => this.getExitsFromRoom(world, npcLocation, npc),
+        };
+    }
+    getExitsFromRoom(world, roomId, npc) {
+        const room = world.getEntity(roomId);
+        if (!room)
+            return [];
+        const roomTrait = room.get(world_model_1.RoomTrait);
+        if (!roomTrait?.exits)
+            return [];
+        const npcTrait = npc.get(world_model_1.TraitType.NPC);
+        const exits = [];
+        for (const [direction, exit] of Object.entries(roomTrait.exits)) {
+            const exitData = exit;
+            if (exitData.destination) {
+                // Inline canEnterRoom() — method doesn't survive loadJSON() deserialization
+                const dest = exitData.destination;
+                if (!npcTrait.canMove)
+                    continue;
+                if (npcTrait.forbiddenRooms?.includes(dest))
+                    continue;
+                if (npcTrait.allowedRooms && !npcTrait.allowedRooms.includes(dest))
+                    continue;
+                exits.push({
+                    direction: direction,
+                    destination: dest,
+                });
+            }
+        }
+        return exits;
+    }
+    executeActions(npc, actions, world, random) {
+        const events = [];
+        for (const action of actions) {
+            const actionEvents = this.executeAction(npc, action, world, random);
+            events.push(...actionEvents);
+        }
+        return events;
+    }
+    executeAction(npc, action, world, random) {
+        switch (action.type) {
+            case 'move':
+                return this.executeMove(npc, action.direction, world);
+            case 'moveTo':
+                return this.executeMoveTo(npc, action.roomId, world);
+            case 'take':
+                return this.executeTake(npc, action.target, world);
+            case 'drop':
+                return this.executeDrop(npc, action.target, world);
+            case 'attack':
+                return this.executeAttack(npc, action.target, world, random);
+            case 'speak':
+                return [
+                    createEvent('npc.spoke', {
+                        npc: npc.id,
+                        messageId: action.messageId,
+                        data: action.data,
+                        params: action.data,
+                    }, npc.id),
+                ];
+            case 'emote':
+                return [
+                    createEvent('npc.emoted', {
+                        npc: npc.id,
+                        messageId: action.messageId,
+                        data: action.data,
+                        params: action.data,
+                    }, npc.id),
+                ];
+            case 'wait':
+                return []; // No events for waiting
+            case 'custom':
+                return action.handler();
+            default:
+                return [];
+        }
+    }
+    executeMove(npc, direction, world) {
+        const currentLocation = world.getLocation(npc.id);
+        if (!currentLocation)
+            return [];
+        const currentRoom = world.getEntity(currentLocation);
+        if (!currentRoom)
+            return [];
+        const roomTrait = currentRoom.get(world_model_1.RoomTrait);
+        if (!roomTrait?.exits?.[direction])
+            return [];
+        const destination = roomTrait.exits[direction].destination;
+        if (!destination)
+            return [];
+        // Move the NPC
+        world.moveEntity(npc.id, destination);
+        return [
+            createEvent('npc.moved', {
+                npc: npc.id,
+                from: currentLocation,
+                to: destination,
+                direction,
+            }, npc.id),
+        ];
+    }
+    executeMoveTo(npc, roomId, world) {
+        const currentLocation = world.getLocation(npc.id);
+        if (!currentLocation)
+            return [];
+        // Move the NPC
+        world.moveEntity(npc.id, roomId);
+        return [
+            createEvent('npc.moved', {
+                npc: npc.id,
+                from: currentLocation,
+                to: roomId,
+            }, npc.id),
+        ];
+    }
+    executeTake(npc, targetId, world) {
+        const target = world.getEntity(targetId);
+        if (!target)
+            return [];
+        // Move item to NPC's inventory
+        world.moveEntity(targetId, npc.id);
+        return [
+            createEvent('npc.took', {
+                npc: npc.id,
+                target: targetId,
+            }, npc.id),
+        ];
+    }
+    executeDrop(npc, targetId, world) {
+        const target = world.getEntity(targetId);
+        if (!target)
+            return [];
+        const npcLocation = world.getLocation(npc.id);
+        if (!npcLocation)
+            return [];
+        // Move item to NPC's location
+        world.moveEntity(targetId, npcLocation);
+        return [
+            createEvent('npc.dropped', {
+                npc: npc.id,
+                target: targetId,
+            }, npc.id),
+        ];
+    }
+    executeAttack(npc, targetId, world, random) {
+        const target = world.getEntity(targetId);
+        if (!target)
+            return [];
+        // Delegate to registered combat resolver if available
+        const resolver = getNpcCombatResolver();
+        if (resolver) {
+            return resolver(npc, target, world, random);
+        }
+        // No resolver registered — emit bare attack event (no combat resolution)
+        return [
+            createEvent('npc.attacked', {
+                npc: npc.id,
+                target: targetId,
+            }, npc.id),
+        ];
+    }
+}
+exports.NpcService = NpcService;
+/**
+ * Create a new NPC Service instance
+ */
+function createNpcService() {
+    return new NpcService();
+}
+//# sourceMappingURL=npc-service.js.map

package/npc/npc-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npc-service.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/stdlib/src/npc/npc-service.ts"],"names":[],"mappings":"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"}

package/npc/types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * NPC System Types (ADR-070)
+ *
+ * Types for NPC behaviors and actions.
+ */
+import { ISemanticEvent, EntityId, SeededRandom } from "../../core/index";
+import { IFEntity, WorldModel, DirectionType } from "../../world-model/index";
+/**
+ * Context passed to NPC behavior hooks
+ */
+export interface NpcContext {
+    /** The NPC entity */
+    npc: IFEntity;
+    /** The world model */
+    world: WorldModel;
+    /** Seeded random number generator */
+    random: SeededRandom;
+    /** Current turn number */
+    turnCount: number;
+    /** Player's current location */
+    playerLocation: EntityId;
+    /** NPC's current location */
+    npcLocation: EntityId;
+    /** Items in NPC's inventory */
+    npcInventory: IFEntity[];
+    /** Whether the player is in the same room as the NPC */
+    playerVisible: boolean;
+    /** Get entities in the NPC's current room */
+    getEntitiesInRoom(): IFEntity[];
+    /** Get exits from the NPC's current room */
+    getAvailableExits(): {
+        direction: DirectionType;
+        destination: EntityId;
+    }[];
+}
+/**
+ * Actions an NPC can take
+ *
+ * All actions use semantic data (message IDs, entity IDs) rather than raw text.
+ */
+export type NpcAction = {
+    type: 'move';
+    direction: DirectionType;
+} | {
+    type: 'moveTo';
+    roomId: EntityId;
+} | {
+    type: 'take';
+    target: EntityId;
+} | {
+    type: 'drop';
+    target: EntityId;
+} | {
+    type: 'attack';
+    target: EntityId;
+} | {
+    type: 'speak';
+    messageId: string;
+    data?: Record<string, unknown>;
+} | {
+    type: 'emote';
+    messageId: string;
+    data?: Record<string, unknown>;
+} | {
+    type: 'wait';
+} | {
+    type: 'custom';
+    handler: () => ISemanticEvent[];
+};
+/**
+ * NPC behavior interface
+ *
+ * Defines hooks that are called at various points during the game.
+ * Each hook returns an array of NpcActions to be executed.
+ */
+export interface NpcBehavior {
+    /** Unique identifier for this behavior */
+    id: string;
+    /** Human-readable name for debugging */
+    name?: string;
+    /**
+     * Called each turn for this NPC
+     * This is the main hook for autonomous NPC behavior.
+     */
+    onTurn(context: NpcContext): NpcAction[];
+    /**
+     * Called when the player enters the NPC's room
+     */
+    onPlayerEnters?(context: NpcContext): NpcAction[];
+    /**
+     * Called when the player leaves the NPC's room
+     */
+    onPlayerLeaves?(context: NpcContext): NpcAction[];
+    /**
+     * Called when the player speaks to/at the NPC
+     */
+    onSpokenTo?(context: NpcContext, words: string): NpcAction[];
+    /**
+     * Called when the NPC is attacked
+     */
+    onAttacked?(context: NpcContext, attacker: IFEntity): NpcAction[];
+    /**
+     * Called when the NPC observes a player action
+     */
+    onObserve?(context: NpcContext, actionType: string, actionData: unknown): NpcAction[];
+    /**
+     * Optional: Get serializable state for save/load
+     */
+    getState?(npc: IFEntity): Record<string, unknown>;
+    /**
+     * Optional: Restore state after load
+     */
+    setState?(npc: IFEntity, state: Record<string, unknown>): void;
+}
+/**
+ * Events emitted by NPC actions
+ */
+export interface NpcEvent extends ISemanticEvent {
+    type: 'npc.moved' | 'npc.spoke' | 'npc.took' | 'npc.dropped' | 'npc.attacked' | 'npc.emoted' | 'npc.died' | 'npc.stateChanged';
+}
+/**
+ * Data for NPC movement events
+ */
+export interface NpcMovedData {
+    npc: EntityId;
+    from: EntityId;
+    to: EntityId;
+    direction?: DirectionType;
+}
+/**
+ * Data for NPC speech events
+ */
+export interface NpcSpokeData {
+    npc: EntityId;
+    messageId: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Data for NPC item manipulation events
+ */
+export interface NpcItemData {
+    npc: EntityId;
+    target: EntityId;
+}
+/**
+ * Data for NPC emote events
+ */
+export interface NpcEmoteData {
+    npc: EntityId;
+    messageId: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Result of NPC combat
+ */
+export interface NpcCombatData {
+    npc: EntityId;
+    target: EntityId;
+    hit: boolean;
+    damage: number;
+    targetKilled: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/npc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/stdlib/src/npc/types.ts"],"names":[],"mappings":"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"}

package/npc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/stdlib/src/npc/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/package.json

@@ -1,45 +1,23 @@
 {
   "name": "@sharpee/stdlib",
-  "version": "0.9.109",
+  "version": "0.9.110",
   "description": "Standard library for Sharpee IF Platform - actions, commands, and game mechanics",
-  "main": "./dist/index.js",
-  "module": "./dist-esm/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./index.js",
+  "types": "./index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist-esm/index.js",
-      "require": "./dist/index.js",
-      "esm": "./dist-esm/index.js"
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
     }
   },
-  "scripts": {
-    "build": "tsc --build",
-    "test": "vitest",
-    "test:ci": "CI=true vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "clean": "rimraf dist coverage",
-    "build:npm": "tsc --outDir dist"
-  },
   "dependencies": {
-    "@sharpee/core": "workspace:*",
-    "@sharpee/if-domain": "workspace:*",
-    "@sharpee/if-services": "workspace:*",
-    "@sharpee/lang-en-us": "workspace:*",
-    "@sharpee/world-model": "workspace:*"
-  },
-  "devDependencies": {
-    "@sharpee/parser-en-us": "workspace:*",
-    "@types/node": "^20.11.19",
-    "@vitest/ui": "^3.2.4",
-    "rimraf": "^5.0.5",
-    "typescript": "^5.3.3",
-    "vitest": "^3.2.4"
+    "@sharpee/core": "^0.9.107",
+    "@sharpee/if-domain": "^0.9.107",
+    "@sharpee/if-services": "^0.9.107",
+    "@sharpee/lang-en-us": "^0.9.107",
+    "@sharpee/world-model": "^0.9.107"
   },
-  "files": [
-    "dist"
-  ],
   "keywords": [
     "interactive-fiction",
     "if",

package/parser/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Parser module exports
+ *
+ * Parser contracts have been moved to @sharpee/if-domain.
+ * This module now only re-exports from if-domain for backward compatibility.
+ */
+export { Parser, ParserOptions, ParserFactory, BaseParser, Token, TokenCandidate, CandidateCommand, InternalParseResult, ParseError, ParseErrorType, VocabularyEntry, PartOfSpeech, VocabularyProvider, VocabularyRegistry, vocabularyRegistry, VerbVocabulary, DirectionVocabulary, SpecialVocabulary, EntityVocabulary, VocabularySet, GrammarPattern, GrammarPatterns, GrammarPatternName, adaptVerbVocabulary, adaptDirectionVocabulary, adaptSpecialVocabulary } from "../../if-domain/index";
+//# sourceMappingURL=index.d.ts.map

package/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/stdlib/src/parser/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,MAAM,EACN,aAAa,EACb,aAAa,EACb,UAAU,EACV,KAAK,EACL,cAAc,EAGd,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,cAAc,EAGd,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAGlB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC"}