@sharpee/stdlib 0.9.60-beta

package/dist/inference/implicit-inference.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Implicit Inference System (ADR-104)
+ *
+ * When a player uses a pronoun ("read it") and the resolved entity
+ * doesn't meet the action's requirements, this system finds a valid
+ * alternative target if exactly ONE exists in scope.
+ *
+ * CRITICAL: Inference ONLY triggers when pronouns are used.
+ * Explicit nouns ("read mailbox") should fail with the normal error.
+ */
+import { IFEntity, WorldModel } from '@sharpee/world-model';
+import { Action } from '../actions/enhanced-types';
+/**
+ * Result of attempting implicit inference
+ */
+export interface InferenceResult {
+    /** Whether inference was performed */
+    inferred: boolean;
+    /** The original target entity */
+    originalTarget: IFEntity;
+    /** The inferred target entity (if inference succeeded) */
+    inferredTarget?: IFEntity;
+    /** Human-readable reason for inference (for debugging/messages) */
+    reason?: string;
+    /** Why inference failed (if it did) */
+    failureReason?: 'not_pronoun' | 'no_requirements' | 'original_valid' | 'no_valid_targets' | 'multiple_valid_targets';
+}
+/**
+ * Check if an entity meets an action's target requirements
+ *
+ * @param entity The entity to check
+ * @param action The action with targetRequirements
+ * @param world The world model (for condition checks)
+ * @returns true if entity meets requirements
+ */
+export declare function meetsActionRequirements(entity: IFEntity, action: Action, world: WorldModel): boolean;
+/**
+ * Get all entities in scope that meet action requirements
+ *
+ * @param action The action to check requirements for
+ * @param scope Entities currently in scope
+ * @param world The world model
+ * @returns Array of entities that meet requirements
+ */
+export declare function findValidTargets(action: Action, scope: IFEntity[], world: WorldModel): IFEntity[];
+/**
+ * Attempt implicit inference for a command
+ *
+ * This is the main entry point for the inference system.
+ *
+ * IMPORTANT: If a pronoun successfully resolved to a specific entity from
+ * the pronoun context, we do NOT infer an alternative. The player clearly
+ * intended to reference that entity. For example:
+ *   - "get mat" sets "it" = mat
+ *   - "read it" should fail with "nothing written on mat", NOT infer leaflet
+ *
+ * Inference is only appropriate when the pronoun resolution was ambiguous
+ * or the player had no specific entity in mind.
+ *
+ * @param originalTarget The entity originally resolved (e.g., mailbox)
+ * @param wasPronoun Whether a pronoun was used ("it", "them")
+ * @param action The action being attempted
+ * @param scope All entities currently in scope for the player
+ * @param world The world model
+ * @returns InferenceResult indicating whether a different target was inferred
+ *
+ * @example
+ * // "read it" where "it" = mailbox (not readable)
+ * const result = tryInferTarget(mailbox, true, readingAction, scopeEntities, world);
+ * if (result.inferred) {
+ *   // Use result.inferredTarget instead of mailbox
+ * }
+ */
+export declare function tryInferTarget(originalTarget: IFEntity, wasPronoun: boolean, action: Action, scope: IFEntity[], world: WorldModel): InferenceResult;
+//# sourceMappingURL=implicit-inference.d.ts.map

package/dist/inference/implicit-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implicit-inference.d.ts","sourceRoot":"","sources":["../../src/inference/implicit-inference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAa,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAGnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAElB,iCAAiC;IACjC,cAAc,EAAE,QAAQ,CAAC;IAEzB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,QAAQ,CAAC;IAE1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,aAAa,CAAC,EAAE,aAAa,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,wBAAwB,CAAC;CACtH;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,GAChB,OAAO,CAmDT;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,EAAE,UAAU,GAChB,QAAQ,EAAE,CAEZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,QAAQ,EACxB,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,EAAE,UAAU,GAChB,eAAe,CA0BjB"}

package/dist/inference/implicit-inference.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * Implicit Inference System (ADR-104)
+ *
+ * When a player uses a pronoun ("read it") and the resolved entity
+ * doesn't meet the action's requirements, this system finds a valid
+ * alternative target if exactly ONE exists in scope.
+ *
+ * CRITICAL: Inference ONLY triggers when pronouns are used.
+ * Explicit nouns ("read mailbox") should fail with the normal error.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.meetsActionRequirements = meetsActionRequirements;
+exports.findValidTargets = findValidTargets;
+exports.tryInferTarget = tryInferTarget;
+/**
+ * Check if an entity meets an action's target requirements
+ *
+ * @param entity The entity to check
+ * @param action The action with targetRequirements
+ * @param world The world model (for condition checks)
+ * @returns true if entity meets requirements
+ */
+function meetsActionRequirements(entity, action, world) {
+    const requirements = action.targetRequirements;
+    if (!requirements) {
+        // No requirements defined - entity is valid
+        return true;
+    }
+    // Check trait requirement
+    if (requirements.trait) {
+        if (!entity.has(requirements.trait)) {
+            return false;
+        }
+        // Check condition if specified
+        if (requirements.condition) {
+            const trait = entity.get(requirements.trait);
+            if (!trait)
+                return false;
+            switch (requirements.condition) {
+                case 'not_open':
+                    // For opening: must not be already open
+                    return trait.isOpen !== true;
+                case 'is_open':
+                    // For closing: must be currently open
+                    return trait.isOpen === true;
+                case 'not_locked':
+                    // For unlocking: must be locked
+                    return trait.isLocked === true;
+                case 'is_locked':
+                    // For locking: must not be locked
+                    return trait.isLocked !== true;
+                case 'not_on':
+                    // For switching on: must be off
+                    return trait.isOn !== true;
+                case 'is_on':
+                    // For switching off: must be on
+                    return trait.isOn === true;
+                default:
+                    // Unknown condition - treat as met
+                    return true;
+            }
+        }
+    }
+    return true;
+}
+/**
+ * Get all entities in scope that meet action requirements
+ *
+ * @param action The action to check requirements for
+ * @param scope Entities currently in scope
+ * @param world The world model
+ * @returns Array of entities that meet requirements
+ */
+function findValidTargets(action, scope, world) {
+    return scope.filter(entity => meetsActionRequirements(entity, action, world));
+}
+/**
+ * Attempt implicit inference for a command
+ *
+ * This is the main entry point for the inference system.
+ *
+ * IMPORTANT: If a pronoun successfully resolved to a specific entity from
+ * the pronoun context, we do NOT infer an alternative. The player clearly
+ * intended to reference that entity. For example:
+ *   - "get mat" sets "it" = mat
+ *   - "read it" should fail with "nothing written on mat", NOT infer leaflet
+ *
+ * Inference is only appropriate when the pronoun resolution was ambiguous
+ * or the player had no specific entity in mind.
+ *
+ * @param originalTarget The entity originally resolved (e.g., mailbox)
+ * @param wasPronoun Whether a pronoun was used ("it", "them")
+ * @param action The action being attempted
+ * @param scope All entities currently in scope for the player
+ * @param world The world model
+ * @returns InferenceResult indicating whether a different target was inferred
+ *
+ * @example
+ * // "read it" where "it" = mailbox (not readable)
+ * const result = tryInferTarget(mailbox, true, readingAction, scopeEntities, world);
+ * if (result.inferred) {
+ *   // Use result.inferredTarget instead of mailbox
+ * }
+ */
+function tryInferTarget(originalTarget, wasPronoun, action, scope, world) {
+    // CRITICAL: Only infer when pronouns are used
+    if (!wasPronoun) {
+        return {
+            inferred: false,
+            originalTarget,
+            failureReason: 'not_pronoun'
+        };
+    }
+    // CRITICAL: If the pronoun resolved to a specific entity, respect the player's intent.
+    // Don't override "read it" (where it=mat) with a different readable item.
+    // The player explicitly referenced the mat via pronoun context, so show the
+    // error for the mat ("nothing written on it") rather than inferring an alternative.
+    //
+    // This makes pronouns behave predictably: "get X; read it" always refers to X.
+    //
+    // DESIGN NOTE: This disables ADR-104 inference. If inference is needed in the
+    // future, it should only trigger when the pronoun resolution was truly ambiguous
+    // (e.g., no clear referent from recent context), not when the player clearly
+    // referenced a specific entity.
+    return {
+        inferred: false,
+        originalTarget,
+        failureReason: 'not_pronoun'
+    };
+}
+//# sourceMappingURL=implicit-inference.js.map

package/dist/inference/implicit-inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implicit-inference.js","sourceRoot":"","sources":["../../src/inference/implicit-inference.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAkCH,0DAuDC;AAUD,4CAMC;AA8BD,wCAgCC;AA7ID;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CACrC,MAAgB,EAChB,MAAc,EACd,KAAiB;IAEjB,MAAM,YAAY,GAAG,MAAM,CAAC,kBAAkB,CAAC;IAC/C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,4CAA4C;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0BAA0B;IAC1B,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,KAAkB,CAAC,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,+BAA+B;QAC/B,IAAI,YAAY,CAAC,SAAS,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,KAAkB,CAAQ,CAAC;YACjE,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YAEzB,QAAQ,YAAY,CAAC,SAAS,EAAE,CAAC;gBAC/B,KAAK,UAAU;oBACb,wCAAwC;oBACxC,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC;gBAE/B,KAAK,SAAS;oBACZ,sCAAsC;oBACtC,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC;gBAE/B,KAAK,YAAY;oBACf,gCAAgC;oBAChC,OAAO,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC;gBAEjC,KAAK,WAAW;oBACd,kCAAkC;oBAClC,OAAO,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC;gBAEjC,KAAK,QAAQ;oBACX,gCAAgC;oBAChC,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;gBAE7B,KAAK,OAAO;oBACV,gCAAgC;oBAChC,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;gBAE7B;oBACE,mCAAmC;oBACnC,OAAO,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAC9B,MAAc,EACd,KAAiB,EACjB,KAAiB;IAEjB,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,cAAc,CAC5B,cAAwB,EACxB,UAAmB,EACnB,MAAc,EACd,KAAiB,EACjB,KAAiB;IAEjB,8CAA8C;IAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,cAAc;YACd,aAAa,EAAE,aAAa;SAC7B,CAAC;IACJ,CAAC;IAED,uFAAuF;IACvF,0EAA0E;IAC1E,4EAA4E;IAC5E,oFAAoF;IACpF,EAAE;IACF,+EAA+E;IAC/E,EAAE;IACF,8EAA8E;IAC9E,iFAAiF;IACjF,6EAA6E;IAC7E,gCAAgC;IAChC,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,cAAc;QACd,aAAa,EAAE,aAAa;KAC7B,CAAC;AACJ,CAAC"}

package/dist/inference/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Inference module (ADR-104)
+ *
+ * Provides implicit object inference functionality.
+ *
+ * Note: Implicit take is handled per-action via context.requireCarriedOrImplicitTake()
+ * rather than at the command level. See ADR-104 for rationale.
+ */
+export { InferenceResult, tryInferTarget, meetsActionRequirements, findValidTargets } from './implicit-inference';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inference/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC"}

package/dist/inference/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Inference module (ADR-104)
+ *
+ * Provides implicit object inference functionality.
+ *
+ * Note: Implicit take is handled per-action via context.requireCarriedOrImplicitTake()
+ * rather than at the command level. See ADR-104 for rationale.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findValidTargets = exports.meetsActionRequirements = exports.tryInferTarget = void 0;
+var implicit_inference_1 = require("./implicit-inference");
+Object.defineProperty(exports, "tryInferTarget", { enumerable: true, get: function () { return implicit_inference_1.tryInferTarget; } });
+Object.defineProperty(exports, "meetsActionRequirements", { enumerable: true, get: function () { return implicit_inference_1.meetsActionRequirements; } });
+Object.defineProperty(exports, "findValidTargets", { enumerable: true, get: function () { return implicit_inference_1.findValidTargets; } });
+//# sourceMappingURL=index.js.map

package/dist/inference/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inference/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,2DAK8B;AAH5B,oHAAA,cAAc,OAAA;AACd,6HAAA,uBAAuB,OAAA;AACvB,sHAAA,gBAAgB,OAAA"}

package/dist/npc/behaviors.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Standard NPC Behaviors (ADR-070)
+ *
+ * Reusable behavior patterns for common NPC archetypes.
+ * These are generic behaviors that can be used in any IF game.
+ * Game-specific behaviors (thief, cyclops, etc.) should be defined in the story.
+ */
+import { NpcBehavior } from './types';
+/**
+ * Guard behavior - stationary NPC that blocks passage and fights back
+ *
+ * Guards:
+ * - Don't move on their own
+ * - Emit a blocking message when player enters
+ * - Attack player each turn if hostile and engaged
+ * - Counterattack when attacked
+ */
+export declare const guardBehavior: NpcBehavior;
+/**
+ * Wanderer behavior - NPC that moves randomly between rooms
+ *
+ * Wanderers:
+ * - Move randomly with configurable probability
+ * - Respect room restrictions
+ * - Announce presence when entering player's room
+ */
+export declare function createWandererBehavior(options?: {
+    /** Probability of moving each turn (0-1) */
+    moveChance?: number;
+    /** Whether to announce when entering player's room */
+    announceEntry?: boolean;
+}): NpcBehavior;
+/**
+ * Follower behavior - NPC that follows the player
+ *
+ * Followers:
+ * - Stay with the player when possible
+ * - Follow the player when they move
+ * - Don't enter forbidden rooms
+ */
+export declare function createFollowerBehavior(options?: {
+    /** Whether to follow immediately or wait a turn */
+    immediate?: boolean;
+    /** Message when following */
+    followMessageId?: string;
+}): NpcBehavior;
+/**
+ * Passive behavior - NPC that does nothing autonomously
+ *
+ * Useful as a base for NPCs that only react to player actions.
+ */
+export declare const passiveBehavior: NpcBehavior;
+/**
+ * Patrol behavior - NPC that moves along a fixed route
+ */
+export declare function createPatrolBehavior(options?: {
+    /** Ordered list of room IDs to patrol */
+    route: string[];
+    /** Whether to reverse at the end or loop */
+    loop?: boolean;
+    /** Turns to wait at each waypoint */
+    waitTurns?: number;
+}): NpcBehavior;
+//# sourceMappingURL=behaviors.d.ts.map

package/dist/npc/behaviors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behaviors.d.ts","sourceRoot":"","sources":["../../src/npc/behaviors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAoC,MAAM,SAAS,CAAC;AAIxE;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,WAiD3B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE;IAC9C,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,WAAW,CA2CnB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE;IAC9C,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,WAAW,CAuEnB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,WAO7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE;IAC5C,yCAAyC;IACzC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACJ,GAAG,WAAW,CA4D9B"}

package/dist/npc/behaviors.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * Standard NPC Behaviors (ADR-070)
+ *
+ * Reusable behavior patterns for common NPC archetypes.
+ * These are generic behaviors that can be used in any IF game.
+ * Game-specific behaviors (thief, cyclops, etc.) should be defined in the story.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.passiveBehavior = exports.guardBehavior = void 0;
+exports.createWandererBehavior = createWandererBehavior;
+exports.createFollowerBehavior = createFollowerBehavior;
+exports.createPatrolBehavior = createPatrolBehavior;
+const npc_messages_1 = require("./npc-messages");
+const world_model_1 = require("@sharpee/world-model");
+/**
+ * Guard behavior - stationary NPC that blocks passage and fights back
+ *
+ * Guards:
+ * - Don't move on their own
+ * - Emit a blocking message when player enters
+ * - Attack player each turn if hostile and engaged
+ * - Counterattack when attacked
+ */
+exports.guardBehavior = {
+    id: 'guard',
+    name: 'Guard Behavior',
+    onTurn(context) {
+        // Check if NPC is alive and conscious
+        const combatant = context.npc.get(world_model_1.TraitType.COMBATANT);
+        if (combatant && (!combatant.isAlive || !combatant.isConscious)) {
+            return [];
+        }
+        // If hostile and player is visible, attack!
+        if (combatant?.hostile && context.playerVisible) {
+            const player = context.world.getPlayer();
+            if (player) {
+                return [{ type: 'attack', target: player.id }];
+            }
+        }
+        return [];
+    },
+    onPlayerEnters(context) {
+        // Check if NPC is alive and conscious
+        const combatant = context.npc.get(world_model_1.TraitType.COMBATANT);
+        if (combatant && (!combatant.isAlive || !combatant.isConscious)) {
+            return [];
+        }
+        // Growl or block when player enters
+        return [
+            {
+                type: 'emote',
+                messageId: npc_messages_1.NpcMessages.GUARD_BLOCKS,
+                data: { npcName: context.npc.name },
+            },
+        ];
+    },
+    onAttacked(context, attacker) {
+        // Check if NPC is alive and conscious
+        const combatant = context.npc.get(world_model_1.TraitType.COMBATANT);
+        if (combatant && (!combatant.isAlive || !combatant.isConscious)) {
+            return [];
+        }
+        // Counterattack
+        return [{ type: 'attack', target: attacker.id }];
+    },
+};
+/**
+ * Wanderer behavior - NPC that moves randomly between rooms
+ *
+ * Wanderers:
+ * - Move randomly with configurable probability
+ * - Respect room restrictions
+ * - Announce presence when entering player's room
+ */
+function createWandererBehavior(options = {}) {
+    const moveChance = options.moveChance ?? 0.3;
+    const announceEntry = options.announceEntry ?? true;
+    return {
+        id: 'wanderer',
+        name: 'Wanderer Behavior',
+        onTurn(context) {
+            const actions = [];
+            // Chance to move
+            if (context.random.chance(moveChance)) {
+                const exits = context.getAvailableExits();
+                if (exits.length > 0) {
+                    const exit = context.random.pick(exits);
+                    actions.push({ type: 'move', direction: exit.direction });
+                    // If we're about to enter player's room, announce
+                    if (announceEntry && exit.destination === context.playerLocation) {
+                        actions.push({
+                            type: 'emote',
+                            messageId: npc_messages_1.NpcMessages.NPC_ENTERS,
+                            data: { npcName: context.npc.name },
+                        });
+                    }
+                }
+            }
+            return actions;
+        },
+        onPlayerEnters(context) {
+            // Acknowledge player's arrival
+            return [
+                {
+                    type: 'emote',
+                    messageId: npc_messages_1.NpcMessages.NPC_NOTICES_PLAYER,
+                    data: { npcName: context.npc.name },
+                },
+            ];
+        },
+    };
+}
+/**
+ * Follower behavior - NPC that follows the player
+ *
+ * Followers:
+ * - Stay with the player when possible
+ * - Follow the player when they move
+ * - Don't enter forbidden rooms
+ */
+function createFollowerBehavior(options = {}) {
+    const immediate = options.immediate ?? true;
+    const followMessageId = options.followMessageId ?? npc_messages_1.NpcMessages.NPC_FOLLOWS;
+    // Track the last room we saw the player in
+    let lastPlayerLocation;
+    return {
+        id: 'follower',
+        name: 'Follower Behavior',
+        onTurn(context) {
+            const actions = [];
+            // If player is not visible and we're not in the same room, try to follow
+            if (!context.playerVisible && lastPlayerLocation) {
+                // Find a path to the player (simplified: just try to move toward them)
+                const exits = context.getAvailableExits();
+                const exitToPlayer = exits.find((e) => e.destination === context.playerLocation);
+                if (exitToPlayer) {
+                    actions.push({ type: 'move', direction: exitToPlayer.direction });
+                    actions.push({
+                        type: 'emote',
+                        messageId: followMessageId,
+                        data: { npcName: context.npc.name },
+                    });
+                }
+            }
+            // Update last known player location
+            lastPlayerLocation = context.playerLocation;
+            return actions;
+        },
+        onPlayerLeaves(context) {
+            if (!immediate) {
+                return [];
+            }
+            // Immediately follow (find which exit player took)
+            const exits = context.getAvailableExits();
+            const exitToPlayer = exits.find((e) => e.destination === context.playerLocation);
+            if (exitToPlayer) {
+                return [
+                    { type: 'move', direction: exitToPlayer.direction },
+                    {
+                        type: 'emote',
+                        messageId: followMessageId,
+                        data: { npcName: context.npc.name },
+                    },
+                ];
+            }
+            return [];
+        },
+        getState() {
+            return { lastPlayerLocation };
+        },
+        setState(_npc, state) {
+            lastPlayerLocation = state.lastPlayerLocation;
+        },
+    };
+}
+/**
+ * Passive behavior - NPC that does nothing autonomously
+ *
+ * Useful as a base for NPCs that only react to player actions.
+ */
+exports.passiveBehavior = {
+    id: 'passive',
+    name: 'Passive Behavior',
+    onTurn() {
+        return [];
+    },
+};
+/**
+ * Patrol behavior - NPC that moves along a fixed route
+ */
+function createPatrolBehavior(options = { route: [] }) {
+    const route = options.route;
+    const loop = options.loop ?? true;
+    const waitTurns = options.waitTurns ?? 0;
+    let currentWaypoint = 0;
+    let direction = 1; // 1 = forward, -1 = backward
+    let waitCounter = 0;
+    return {
+        id: 'patrol',
+        name: 'Patrol Behavior',
+        onTurn(context) {
+            if (route.length === 0)
+                return [];
+            // Wait at waypoint
+            if (waitCounter > 0) {
+                waitCounter--;
+                return [];
+            }
+            // Check if we're at the current waypoint
+            const targetRoom = route[currentWaypoint];
+            if (context.npcLocation !== targetRoom) {
+                // Move toward target
+                const exits = context.getAvailableExits();
+                const exitToTarget = exits.find((e) => e.destination === targetRoom);
+                if (exitToTarget) {
+                    return [{ type: 'move', direction: exitToTarget.direction }];
+                }
+            }
+            // We're at the waypoint, move to next
+            waitCounter = waitTurns;
+            if (loop) {
+                currentWaypoint = (currentWaypoint + 1) % route.length;
+            }
+            else {
+                // Ping-pong
+                currentWaypoint += direction;
+                if (currentWaypoint >= route.length - 1 || currentWaypoint <= 0) {
+                    direction *= -1;
+                }
+            }
+            return [];
+        },
+        getState() {
+            return { currentWaypoint, direction, waitCounter };
+        },
+        setState(_npc, state) {
+            currentWaypoint = state.currentWaypoint ?? 0;
+            direction = state.direction ?? 1;
+            waitCounter = state.waitCounter ?? 0;
+        },
+    };
+}
+//# sourceMappingURL=behaviors.js.map

package/dist/npc/behaviors.js.map

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

package/dist/npc/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * NPC Module Exports (ADR-070)
+ *
+ * Provides NPC behavior system for autonomous characters.
+ */
+export * from './types';
+export * from './npc-messages';
+export { NpcService, createNpcService, type INpcService } from './npc-service';
+export { guardBehavior, passiveBehavior, createWandererBehavior, createFollowerBehavior, createPatrolBehavior, } from './behaviors';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/npc/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAG/E,OAAO,EACL,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/npc/index.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * NPC Module Exports (ADR-070)
+ *
+ * Provides NPC behavior system for autonomous characters.
+ */
+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.createPatrolBehavior = exports.createFollowerBehavior = exports.createWandererBehavior = exports.passiveBehavior = exports.guardBehavior = exports.createNpcService = exports.NpcService = void 0;
+// Types
+__exportStar(require("./types"), exports);
+// Message IDs
+__exportStar(require("./npc-messages"), exports);
+// Service
+var npc_service_1 = require("./npc-service");
+Object.defineProperty(exports, "NpcService", { enumerable: true, get: function () { return npc_service_1.NpcService; } });
+Object.defineProperty(exports, "createNpcService", { enumerable: true, get: function () { return npc_service_1.createNpcService; } });
+// Standard behaviors
+var behaviors_1 = require("./behaviors");
+Object.defineProperty(exports, "guardBehavior", { enumerable: true, get: function () { return behaviors_1.guardBehavior; } });
+Object.defineProperty(exports, "passiveBehavior", { enumerable: true, get: function () { return behaviors_1.passiveBehavior; } });
+Object.defineProperty(exports, "createWandererBehavior", { enumerable: true, get: function () { return behaviors_1.createWandererBehavior; } });
+Object.defineProperty(exports, "createFollowerBehavior", { enumerable: true, get: function () { return behaviors_1.createFollowerBehavior; } });
+Object.defineProperty(exports, "createPatrolBehavior", { enumerable: true, get: function () { return behaviors_1.createPatrolBehavior; } });
+//# sourceMappingURL=index.js.map

package/dist/npc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/npc/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,QAAQ;AACR,0CAAwB;AAExB,cAAc;AACd,iDAA+B;AAE/B,UAAU;AACV,6CAA+E;AAAtE,yGAAA,UAAU,OAAA;AAAE,+GAAA,gBAAgB,OAAA;AAErC,qBAAqB;AACrB,yCAMqB;AALnB,0GAAA,aAAa,OAAA;AACb,4GAAA,eAAe,OAAA;AACf,mHAAA,sBAAsB,OAAA;AACtB,mHAAA,sBAAsB,OAAA;AACtB,iHAAA,oBAAoB,OAAA"}