@sharpee/stdlib 0.9.107 → 0.9.109

package/dist/events/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/events/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG5D,UAAU,SAAU,SAAQ,cAAc;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAGD,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,cAAc,EAAE,CAAC;AAE3F;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,kBAAkB,CAqBxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,CActF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAczF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,kBAAkB,CActG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,QAAQ,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CAWrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAQjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAQjG;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,EACxC,OAAO,EAAE,kBAAkB,GAC1B,kBAAkB,CAMpB"}

package/dist/events/helpers.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AAEjC;;;;;;;;;;;;GAYG"}

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/events/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;AAEH,kDAAgC;AAChC,oDAAkC;AAClC,gDAA8B;AAC9B,mDAAiC;AAEjC;;;;;;;;;;;;GAYG"}

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

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

package/dist/helpers/index.js.map

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

package/dist/helpers/multi-object-handler.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Multi-Object Handler
+ *
+ * Handles "take all", "take all but X", and "take X and Y" patterns.
+ * Actions use this helper to expand multi-object commands into entity lists.
+ */
+import { IFEntity, WorldModel } from '@sharpee/world-model';
+import { ActionContext } from '../actions/enhanced-types';
+import { INounPhrase } from '@sharpee/world-model';
+/**
+ * Result of processing a single entity in a multi-object command
+ */
+export interface MultiObjectItem {
+    entity: IFEntity;
+    nounPhrase?: INounPhrase;
+}
+/**
+ * Options for multi-object expansion
+ */
+export interface MultiObjectOptions {
+    /** Filter function to determine which entities are valid targets */
+    filter?: (entity: IFEntity, world: WorldModel) => boolean;
+    /** Required scope level (default: reachable) */
+    scope?: 'carried' | 'reachable' | 'visible';
+}
+/**
+ * Check if the current command is a multi-object command (isAll or isList)
+ */
+export declare function isMultiObjectCommand(context: ActionContext): boolean;
+/**
+ * Check if the current command uses "all" keyword
+ */
+export declare function isAllCommand(context: ActionContext): boolean;
+/**
+ * Check if the current command is a list (X and Y)
+ */
+export declare function isListCommand(context: ActionContext): boolean;
+/**
+ * Get excluded entity names from "all but X" pattern
+ */
+export declare function getExcludedNames(context: ActionContext): string[];
+/**
+ * Expand a multi-object command into a list of target entities.
+ *
+ * For "take all": Returns all entities matching scope/filter, minus excluded
+ * For "take X and Y": Returns resolved entities for each item
+ * For single object: Returns the single resolved entity
+ *
+ * @param context Action context
+ * @param options Filter and scope options
+ * @returns Array of entities to process
+ */
+export declare function expandMultiObject(context: ActionContext, options?: MultiObjectOptions): MultiObjectItem[];
+//# sourceMappingURL=multi-object-handler.d.ts.map

package/dist/helpers/multi-object-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-object-handler.d.ts","sourceRoot":"","sources":["../../src/helpers/multi-object-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAA4B,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;IAC1D,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAGpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,EAAE,CAMjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,kBAAuB,GAC/B,eAAe,EAAE,CAuBnB"}

package/dist/helpers/multi-object-handler.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * Multi-Object Handler
+ *
+ * Handles "take all", "take all but X", and "take X and Y" patterns.
+ * Actions use this helper to expand multi-object commands into entity lists.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMultiObjectCommand = isMultiObjectCommand;
+exports.isAllCommand = isAllCommand;
+exports.isListCommand = isListCommand;
+exports.getExcludedNames = getExcludedNames;
+exports.expandMultiObject = expandMultiObject;
+const world_model_1 = require("@sharpee/world-model");
+const scope_resolver_1 = require("../scope/scope-resolver");
+/**
+ * Check if the current command is a multi-object command (isAll or isList)
+ */
+function isMultiObjectCommand(context) {
+    const directObject = context.command.parsed.structure.directObject;
+    return !!(directObject?.isAll || directObject?.isList);
+}
+/**
+ * Check if the current command uses "all" keyword
+ */
+function isAllCommand(context) {
+    return context.command.parsed.structure.directObject?.isAll === true;
+}
+/**
+ * Check if the current command is a list (X and Y)
+ */
+function isListCommand(context) {
+    return context.command.parsed.structure.directObject?.isList === true;
+}
+/**
+ * Get excluded entity names from "all but X" pattern
+ */
+function getExcludedNames(context) {
+    const excluded = context.command.parsed.excluded;
+    if (!excluded || excluded.length === 0) {
+        return [];
+    }
+    return excluded.map(np => np.head || np.text).map(s => s.toLowerCase());
+}
+/**
+ * Expand a multi-object command into a list of target entities.
+ *
+ * For "take all": Returns all entities matching scope/filter, minus excluded
+ * For "take X and Y": Returns resolved entities for each item
+ * For single object: Returns the single resolved entity
+ *
+ * @param context Action context
+ * @param options Filter and scope options
+ * @returns Array of entities to process
+ */
+function expandMultiObject(context, options = {}) {
+    const directObject = context.command.parsed.structure.directObject;
+    const world = context.world;
+    const player = context.player;
+    // Handle "all" keyword
+    if (directObject?.isAll) {
+        return expandAll(context, options);
+    }
+    // Handle list "X and Y"
+    if (directObject?.isList && directObject.items) {
+        return expandList(context, directObject.items, options);
+    }
+    // Single object - use the already-resolved entity
+    const entity = context.command.directObject?.entity;
+    if (entity) {
+        return [{ entity }];
+    }
+    // No target
+    return [];
+}
+/**
+ * Expand "all" into matching entities
+ */
+function expandAll(context, options) {
+    const world = context.world;
+    const player = context.player;
+    const scopeResolver = new scope_resolver_1.StandardScopeResolver(world);
+    // Get entities based on scope
+    let candidates;
+    switch (options.scope) {
+        case 'carried':
+            candidates = world.getContents(player.id);
+            break;
+        case 'visible':
+            candidates = scopeResolver.getVisible(player);
+            break;
+        case 'reachable':
+        default:
+            candidates = scopeResolver.getReachable(player);
+            break;
+    }
+    // Apply filter if provided
+    if (options.filter) {
+        candidates = candidates.filter(e => options.filter(e, world));
+    }
+    // Apply default portable filter (not room, not scenery, not actor)
+    candidates = candidates.filter(e => isPortable(e));
+    // Apply exclusions from "all but X"
+    const excludedNames = getExcludedNames(context);
+    if (excludedNames.length > 0) {
+        candidates = candidates.filter(e => {
+            const name = e.name.toLowerCase();
+            const aliases = getEntityAliases(e).map(a => a.toLowerCase());
+            // Exclude if name or any alias matches excluded list
+            return !excludedNames.includes(name) &&
+                !aliases.some(a => excludedNames.includes(a));
+        });
+    }
+    return candidates.map(entity => ({ entity }));
+}
+/**
+ * Expand list items "X and Y" into entities
+ */
+function expandList(context, items, options) {
+    const world = context.world;
+    const player = context.player;
+    const scopeResolver = new scope_resolver_1.StandardScopeResolver(world);
+    const results = [];
+    // Get scope candidates
+    let scopeCandidates;
+    switch (options.scope) {
+        case 'carried':
+            scopeCandidates = world.getContents(player.id);
+            break;
+        case 'visible':
+            scopeCandidates = scopeResolver.getVisible(player);
+            break;
+        case 'reachable':
+        default:
+            scopeCandidates = scopeResolver.getReachable(player);
+            break;
+    }
+    // Resolve each item in the list
+    for (const item of items) {
+        const searchTerm = (item.head || item.text).toLowerCase();
+        // Find matching entity in scope
+        const match = scopeCandidates.find(e => {
+            const name = e.name.toLowerCase();
+            const aliases = getEntityAliases(e).map(a => a.toLowerCase());
+            return name === searchTerm || aliases.includes(searchTerm);
+        });
+        if (match) {
+            // Apply filter if provided
+            if (!options.filter || options.filter(match, world)) {
+                results.push({ entity: match, nounPhrase: item });
+            }
+        }
+        // Note: If item doesn't resolve, we skip it (partial success)
+        // The action can check results.length vs items.length to detect this
+    }
+    return results;
+}
+/**
+ * Check if an entity is portable (can be taken)
+ */
+function isPortable(entity) {
+    // Can't take rooms
+    if (entity.has(world_model_1.TraitType.ROOM)) {
+        return false;
+    }
+    // Can't take scenery
+    if (entity.has(world_model_1.TraitType.SCENERY)) {
+        return false;
+    }
+    // Can't take actors
+    if (entity.has(world_model_1.TraitType.ACTOR)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Get entity aliases from identity trait
+ */
+function getEntityAliases(entity) {
+    const identity = entity.getTrait(world_model_1.IdentityTrait);
+    if (identity && Array.isArray(identity.aliases)) {
+        return identity.aliases.map(String);
+    }
+    return [];
+}
+//# sourceMappingURL=multi-object-handler.js.map

package/dist/helpers/multi-object-handler.js.map

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

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,WAAW,CAAC;AAI1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;AAEH,4CAA0B;AAC1B,0EAA0E;AAC1E,oFAAoF;AACpF,6CAA6C;AAC7C,2CAAyB;AACzB,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,iDAA+B;AAC/B,mDAAiC;AACjC,0CAAwB;AACxB,6CAA2B;AAC3B,wCAAsB;AACtB,2CAAyB;AACzB,2CAAyB;AACzB,8CAA4B"}

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.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,CAAwC,CAAC;YACjG,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.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.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.map

@@ -0,0 +1 @@
+{"version":3,"file":"behaviors.d.ts","sourceRoot":"","sources":["../../src/npc/behaviors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAyB,MAAM,SAAS,CAAC;AAI7D;;;;;;;;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/character-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-messages.d.ts","sourceRoot":"","sources":["../../src/npc/character-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;CAmBpB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/npc/character-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-messages.js","sourceRoot":"","sources":["../../src/npc/character-messages.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH;;;;;;GAMG;AACU,QAAA,iBAAiB,GAAG;IAC/B,uBAAuB;IACvB,cAAc,EAAE,8BAA8B;IAC9C,0BAA0B,EAAE,0CAA0C;IAEtE,mBAAmB;IACnB,mBAAmB,EAAE,mCAAmC;IAExD,eAAe;IACf,YAAY,EAAE,4BAA4B;IAE1C,iBAAiB;IACjB,cAAc,EAAE,8BAA8B;IAE9C,sBAAsB;IACtB,mBAAmB,EAAE,mCAAmC;IAExD,YAAY;IACZ,YAAY,EAAE,4BAA4B;CAClC,CAAC"}