@sharpee/stdlib 0.9.65-beta → 0.9.66-beta

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

@@ -1,75 +0,0 @@
-/**
- * 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 "../../../world-model/dist-npm/src/index";
-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-npm/inference/implicit-inference.d.ts.map

@@ -1 +0,0 @@
-{"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-npm/inference/implicit-inference.js

@@ -1,132 +0,0 @@
-"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-npm/inference/implicit-inference.js.map

@@ -1 +0,0 @@
-{"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-npm/inference/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * 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-npm/inference/index.d.ts.map

@@ -1 +0,0 @@
-{"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-npm/inference/index.js

@@ -1,16 +0,0 @@
-"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-npm/inference/index.js.map

@@ -1 +0,0 @@
-{"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-npm/npc/behaviors.d.ts

@@ -1,64 +0,0 @@
-/**
- * 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-npm/npc/behaviors.d.ts.map

@@ -1 +0,0 @@
-{"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-npm/npc/behaviors.js

@@ -1,244 +0,0 @@
-"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("../../../world-model/dist-npm/src/index.js");
-/**
- * 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-npm/npc/behaviors.js.map

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

package/dist-npm/npc/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * 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-npm/npc/index.d.ts.map

@@ -1 +0,0 @@
-{"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-npm/npc/index.js

@@ -1,38 +0,0 @@
-"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-npm/npc/index.js.map

@@ -1 +0,0 @@
-{"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"}