@sharpee/character 0.9.106 → 0.9.107

package/influence/influence-evaluator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Influence evaluation engine (ADR-146 layer 3)
+ *
+ * Evaluates passive and active influences: checks range, schedule,
+ * and resistance, then produces InfluenceResult describing whether
+ * the effect was applied or resisted.
+ *
+ * Pure evaluation — does not mutate state directly. Callers apply
+ * the returned effects to CharacterModelTrait state.
+ *
+ * Public interface: evaluatePassiveInfluences, evaluateActiveInfluence,
+ *   checkResistance.
+ * Owner context: @sharpee/character / influence
+ */
+import { InfluenceDef, ResistanceDef, InfluenceResult } from './influence-types';
+/** An entity in a room with its influence and resistance data. */
+export interface InfluenceRoomEntity {
+    /** Entity ID. */
+    id: string;
+    /** Influences this entity exerts (may be empty). */
+    influences: InfluenceDef[];
+    /** Resistances this entity has (may be empty). */
+    resistances: ResistanceDef[];
+    /** Evaluate a predicate against this entity's state. Returns true if satisfied. */
+    evaluatePredicate: (predicate: string) => boolean;
+}
+/**
+ * Check whether a target resists an influence.
+ *
+ * @param target - The target entity with its resistances
+ * @param influenceName - The influence to check
+ * @returns true if the target resists (no effect should be applied)
+ */
+export declare function checkResistance(target: InfluenceRoomEntity, influenceName: string): boolean;
+/**
+ * Evaluate all passive influences for entities in a room.
+ *
+ * For each entity with passive influences, checks range, schedule,
+ * and each potential target's resistance. Returns results describing
+ * which effects were applied and which were resisted.
+ *
+ * @param entities - All entities in the room
+ * @returns Array of influence results
+ */
+export declare function evaluatePassiveInfluences(entities: InfluenceRoomEntity[]): InfluenceResult[];
+/**
+ * Evaluate a single active influence against a specific target.
+ *
+ * @param influencer - The entity exerting the influence
+ * @param influenceName - The name of the influence to exert
+ * @param target - The target entity
+ * @returns The influence result
+ */
+export declare function evaluateActiveInfluence(influencer: InfluenceRoomEntity, influenceName: string, target: InfluenceRoomEntity): InfluenceResult;
+//# sourceMappingURL=influence-evaluator.d.ts.map

package/influence/influence-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"influence-evaluator.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/influence/influence-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAM3B,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IAEX,oDAAoD;IACpD,UAAU,EAAE,YAAY,EAAE,CAAC;IAE3B,kDAAkD;IAClD,WAAW,EAAE,aAAa,EAAE,CAAC;IAE7B,mFAAmF;IACnF,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CACnD;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,mBAAmB,EAC3B,aAAa,EAAE,MAAM,GACpB,OAAO,CAcT;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,eAAe,EAAE,CA0BnB;AA8CD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,mBAAmB,EAC/B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,mBAAmB,GAC1B,eAAe,CAwBjB"}

package/influence/influence-evaluator.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Influence evaluation engine (ADR-146 layer 3)
+ *
+ * Evaluates passive and active influences: checks range, schedule,
+ * and resistance, then produces InfluenceResult describing whether
+ * the effect was applied or resisted.
+ *
+ * Pure evaluation — does not mutate state directly. Callers apply
+ * the returned effects to CharacterModelTrait state.
+ *
+ * Public interface: evaluatePassiveInfluences, evaluateActiveInfluence,
+ *   checkResistance.
+ * Owner context: @sharpee/character / influence
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkResistance = checkResistance;
+exports.evaluatePassiveInfluences = evaluatePassiveInfluences;
+exports.evaluateActiveInfluence = evaluateActiveInfluence;
+// ---------------------------------------------------------------------------
+// Resistance check
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a target resists an influence.
+ *
+ * @param target - The target entity with its resistances
+ * @param influenceName - The influence to check
+ * @returns true if the target resists (no effect should be applied)
+ */
+function checkResistance(target, influenceName) {
+    const resistance = target.resistances.find(r => r.influenceName === influenceName);
+    if (!resistance)
+        return false; // No resistance — influence succeeds
+    // Has resistance — check except conditions
+    if (resistance.except && resistance.except.length > 0) {
+        // If any except condition is met, resistance fails (target is vulnerable)
+        const anyExceptMet = resistance.except.some(cond => target.evaluatePredicate(cond));
+        return !anyExceptMet; // Resists unless an except condition is true
+    }
+    return true; // Resists unconditionally
+}
+// ---------------------------------------------------------------------------
+// Schedule check
+// ---------------------------------------------------------------------------
+/**
+ * Check whether an influence's schedule conditions are met.
+ *
+ * @param influence - The influence definition
+ * @param influencer - The influencing entity (for predicate evaluation)
+ * @returns true if the influence should be exerted this turn
+ */
+function checkSchedule(influence, influencer) {
+    if (!influence.schedule)
+        return true;
+    return influence.schedule.when.every(cond => influencer.evaluatePredicate(cond));
+}
+// ---------------------------------------------------------------------------
+// Passive influence evaluation
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate all passive influences for entities in a room.
+ *
+ * For each entity with passive influences, checks range, schedule,
+ * and each potential target's resistance. Returns results describing
+ * which effects were applied and which were resisted.
+ *
+ * @param entities - All entities in the room
+ * @returns Array of influence results
+ */
+function evaluatePassiveInfluences(entities) {
+    const results = [];
+    for (const influencer of entities) {
+        for (const influence of influencer.influences) {
+            if (influence.mode !== 'passive')
+                continue;
+            // Check schedule
+            if (!checkSchedule(influence, influencer)) {
+                results.push({
+                    status: 'skipped',
+                    reason: `schedule not met for ${influence.name}`,
+                });
+                continue;
+            }
+            // Determine targets based on range
+            const targets = getTargets(influence, influencer, entities);
+            for (const target of targets) {
+                results.push(evaluateInfluenceOnTarget(influence, influencer, target));
+            }
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Single-target evaluation helper
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate a single influence against a single target entity.
+ *
+ * Checks resistance and returns either an 'applied' or 'resisted' result.
+ * Used by both passive and active influence evaluation paths.
+ *
+ * @param influence - The influence being exerted
+ * @param influencer - The entity exerting the influence
+ * @param target - The target entity
+ * @returns An InfluenceResult describing the outcome
+ */
+function evaluateInfluenceOnTarget(influence, influencer, target) {
+    if (checkResistance(target, influence.name)) {
+        return {
+            status: 'resisted',
+            influenceName: influence.name,
+            influencerId: influencer.id,
+            targetId: target.id,
+            resisted: influence.resisted,
+        };
+    }
+    return {
+        status: 'applied',
+        influenceName: influence.name,
+        influencerId: influencer.id,
+        targetId: target.id,
+        effect: { ...influence.effect },
+        witnessed: influence.witnessed,
+    };
+}
+// ---------------------------------------------------------------------------
+// Active influence evaluation
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate a single active influence against a specific target.
+ *
+ * @param influencer - The entity exerting the influence
+ * @param influenceName - The name of the influence to exert
+ * @param target - The target entity
+ * @returns The influence result
+ */
+function evaluateActiveInfluence(influencer, influenceName, target) {
+    const influence = influencer.influences.find(i => i.name === influenceName);
+    if (!influence) {
+        return { status: 'skipped', reason: `${influencer.id} has no influence '${influenceName}'` };
+    }
+    if (checkResistance(target, influence.name)) {
+        return {
+            status: 'resisted',
+            influenceName: influence.name,
+            influencerId: influencer.id,
+            targetId: target.id,
+            resisted: influence.resisted,
+        };
+    }
+    return {
+        status: 'applied',
+        influenceName: influence.name,
+        influencerId: influencer.id,
+        targetId: target.id,
+        effect: { ...influence.effect },
+        witnessed: influence.witnessed,
+    };
+}
+// ---------------------------------------------------------------------------
+// Target selection
+// ---------------------------------------------------------------------------
+/**
+ * Get eligible targets for an influence based on its range.
+ *
+ * @param influence - The influence definition
+ * @param influencer - The influencing entity
+ * @param entities - All entities in the room
+ * @returns Array of target entities (excludes the influencer)
+ */
+function getTargets(influence, influencer, entities) {
+    const others = entities.filter(e => e.id !== influencer.id);
+    switch (influence.range) {
+        case 'room':
+        case 'proximity':
+        case 'targeted':
+            // All range types resolve to room-wide for passive evaluation.
+            // 'proximity' is equivalent to 'room' when entities share a room.
+            // 'targeted' is only meaningful for active influences; passive treats it as room-wide.
+            return others;
+    }
+}
+//# sourceMappingURL=influence-evaluator.js.map

package/influence/influence-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"influence-evaluator.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/influence/influence-evaluator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AAsCH,0CAiBC;AAqCD,8DA4BC;AAsDD,0DA4BC;AA/KD,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAgB,eAAe,CAC7B,MAA2B,EAC3B,aAAqB;IAErB,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,aAAa,CAAC,CAAC;IACnF,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC,CAAC,qCAAqC;IAEpE,2CAA2C;IAC3C,IAAI,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,0EAA0E;QAC1E,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjD,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAC/B,CAAC;QACF,OAAO,CAAC,YAAY,CAAC,CAAC,6CAA6C;IACrE,CAAC;IAED,OAAO,IAAI,CAAC,CAAC,0BAA0B;AACzC,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAS,aAAa,CACpB,SAAuB,EACvB,UAA+B;IAE/B,IAAI,CAAC,SAAS,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAC1C,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CACnC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,SAAgB,yBAAyB,CACvC,QAA+B;IAE/B,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,UAAU,IAAI,QAAQ,EAAE,CAAC;QAClC,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC9C,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS;gBAAE,SAAS;YAE3C,iBAAiB;YACjB,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC1C,OAAO,CAAC,IAAI,CAAC;oBACX,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,wBAAwB,SAAS,CAAC,IAAI,EAAE;iBACjD,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,mCAAmC;YACnC,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YAE5D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,SAAS,yBAAyB,CAChC,SAAuB,EACvB,UAA+B,EAC/B,MAA2B;IAE3B,IAAI,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,aAAa,EAAE,SAAS,CAAC,IAAI;YAC7B,YAAY,EAAE,UAAU,CAAC,EAAE;YAC3B,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,QAAQ,EAAE,SAAS,CAAC,QAAQ;SAC7B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,aAAa,EAAE,SAAS,CAAC,IAAI;QAC7B,YAAY,EAAE,UAAU,CAAC,EAAE;QAC3B,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,MAAM,EAAE,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE;QAC/B,SAAS,EAAE,SAAS,CAAC,SAAS;KAC/B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CACrC,UAA+B,EAC/B,aAAqB,EACrB,MAA2B;IAE3B,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;IAC5E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,sBAAsB,aAAa,GAAG,EAAE,CAAC;IAC/F,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,aAAa,EAAE,SAAS,CAAC,IAAI;YAC7B,YAAY,EAAE,UAAU,CAAC,EAAE;YAC3B,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,QAAQ,EAAE,SAAS,CAAC,QAAQ;SAC7B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,aAAa,EAAE,SAAS,CAAC,IAAI;QAC7B,YAAY,EAAE,UAAU,CAAC,EAAE;QAC3B,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,MAAM,EAAE,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE;QAC/B,SAAS,EAAE,SAAS,CAAC,SAAS;KAC/B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,SAAS,UAAU,CACjB,SAAuB,EACvB,UAA+B,EAC/B,QAA+B;IAE/B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,CAAC,CAAC;IAE5D,QAAQ,SAAS,CAAC,KAAK,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC;QACZ,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU;YACb,+DAA+D;YAC/D,kEAAkE;YAClE,uFAAuF;YACvF,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC"}

package/influence/influence-messages.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Influence message IDs (ADR-146)
+ *
+ * Semantic message IDs for influence system events.
+ * Actual text is provided by the language layer (lang-en-us).
+ *
+ * Public interface: InfluenceMessages.
+ * Owner context: @sharpee/character / influence
+ */
+/**
+ * Platform default message IDs for influence events.
+ * Authors override per-influence via InfluenceDef.witnessed / .resisted.
+ */
+export declare const InfluenceMessages: {
+    /** Default witnessed message when target is affected. */
+    readonly WITNESSED_DEFAULT: "character.influence.witnessed.default";
+    /** Default resisted message when target resists. */
+    readonly RESISTED_DEFAULT: "character.influence.resisted.default";
+    /** Player's focus is clouded (conversation context cleared). */
+    readonly PC_FOCUS_CLOUDED: "character.influence.pc.focus_clouded";
+    /** Player's action is intercepted by influence. */
+    readonly PC_ACTION_INTERCEPTED: "character.influence.pc.action_intercepted";
+    /** Influence effect wears off (momentary or lingering expired). */
+    readonly EFFECT_EXPIRED: "character.influence.effect.expired";
+    /** Influence effect cleared because influencer departed. */
+    readonly EFFECT_DEPARTED: "character.influence.effect.departed";
+};
+/** Type for influence message IDs. */
+export type InfluenceMessageId = (typeof InfluenceMessages)[keyof typeof InfluenceMessages];
+//# sourceMappingURL=influence-messages.d.ts.map

package/influence/influence-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"influence-messages.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/influence/influence-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAK5B,yDAAyD;;IAEzD,oDAAoD;;IAOpD,gEAAgE;;IAEhE,mDAAmD;;IAOnD,mEAAmE;;IAEnE,4DAA4D;;CAEpD,CAAC;AAEX,sCAAsC;AACtC,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

package/influence/influence-messages.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Influence message IDs (ADR-146)
+ *
+ * Semantic message IDs for influence system events.
+ * Actual text is provided by the language layer (lang-en-us).
+ *
+ * Public interface: InfluenceMessages.
+ * Owner context: @sharpee/character / influence
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InfluenceMessages = void 0;
+/**
+ * Platform default message IDs for influence events.
+ * Authors override per-influence via InfluenceDef.witnessed / .resisted.
+ */
+exports.InfluenceMessages = {
+    // -------------------------------------------------------------------------
+    // Witnessed — player sees influence being exerted
+    // -------------------------------------------------------------------------
+    /** Default witnessed message when target is affected. */
+    WITNESSED_DEFAULT: 'character.influence.witnessed.default',
+    /** Default resisted message when target resists. */
+    RESISTED_DEFAULT: 'character.influence.resisted.default',
+    // -------------------------------------------------------------------------
+    // PC influence — player is the target
+    // -------------------------------------------------------------------------
+    /** Player's focus is clouded (conversation context cleared). */
+    PC_FOCUS_CLOUDED: 'character.influence.pc.focus_clouded',
+    /** Player's action is intercepted by influence. */
+    PC_ACTION_INTERCEPTED: 'character.influence.pc.action_intercepted',
+    // -------------------------------------------------------------------------
+    // Duration events
+    // -------------------------------------------------------------------------
+    /** Influence effect wears off (momentary or lingering expired). */
+    EFFECT_EXPIRED: 'character.influence.effect.expired',
+    /** Influence effect cleared because influencer departed. */
+    EFFECT_DEPARTED: 'character.influence.effect.departed',
+};
+//# sourceMappingURL=influence-messages.js.map

package/influence/influence-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"influence-messages.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/influence/influence-messages.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH;;;GAGG;AACU,QAAA,iBAAiB,GAAG;IAC/B,4EAA4E;IAC5E,kDAAkD;IAClD,4EAA4E;IAE5E,yDAAyD;IACzD,iBAAiB,EAAE,uCAAuC;IAC1D,oDAAoD;IACpD,gBAAgB,EAAE,sCAAsC;IAExD,4EAA4E;IAC5E,sCAAsC;IACtC,4EAA4E;IAE5E,gEAAgE;IAChE,gBAAgB,EAAE,sCAAsC;IACxD,mDAAmD;IACnD,qBAAqB,EAAE,2CAA2C;IAElE,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E,mEAAmE;IACnE,cAAc,EAAE,oCAAoC;IACpD,4DAA4D;IAC5D,eAAe,EAAE,qCAAqC;CAC9C,CAAC"}

package/influence/influence-types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * NPC influence types (ADR-146)
+ *
+ * Type definitions for the influence system: influence definitions,
+ * resistance definitions, effect tracking, and evaluation results.
+ *
+ * Public interface: All exported types.
+ * Owner context: @sharpee/character / influence
+ */
+/**
+ * How the influence is exerted.
+ * - passive: automatically when conditions are met (proximity, same room)
+ * - active: deliberately as part of NPC behavior or goal pursuit
+ */
+export type InfluenceMode = 'passive' | 'active';
+/**
+ * Who the influence affects.
+ * - proximity: target must be in the same room
+ * - targeted: influencer selects a specific target (used with active mode)
+ * - room: affects all entities in the room (aura)
+ */
+export type InfluenceRange = 'proximity' | 'targeted' | 'room';
+/**
+ * How long the effect lasts.
+ * - 'while present': clears when influencer leaves the room (default for passive)
+ * - 'momentary': lasts one turn (default for active)
+ * - 'lingering': persists for author-defined turns or until a condition clears it
+ */
+export type InfluenceDuration = 'while present' | 'momentary' | 'lingering';
+/**
+ * Character state mutations caused by influence.
+ * Keys map to ADR-141 vocabulary: mood, threat, focus, propagation, disposition.
+ */
+export interface InfluenceEffect {
+    /** ADR-141 mood state. */
+    mood?: string;
+    /** ADR-141 threat level. */
+    threat?: string;
+    /** PC or NPC ability to pursue current activity. */
+    focus?: string;
+    /** ADR-144 propagation tendency override. */
+    propagation?: string;
+    /** ADR-141 disposition toward a specific entity. */
+    disposition?: Record<string, string>;
+}
+/** Conditions for when a passive influence is exerted. */
+export interface InfluenceSchedule {
+    /** Predicate conditions that must be satisfied. */
+    when: string[];
+}
+/** Author-defined influence on the exerting NPC. */
+export interface InfluenceDef {
+    /** Author-invented influence name (e.g., 'seduction', 'intimidation'). */
+    name: string;
+    /** How the influence is exerted. */
+    mode: InfluenceMode;
+    /** Who the influence affects. */
+    range: InfluenceRange;
+    /** State mutations applied to affected targets. */
+    effect: InfluenceEffect;
+    /** How long the effect lasts. */
+    duration: InfluenceDuration;
+    /** Message ID when the target is affected (player witnesses). */
+    witnessed?: string;
+    /** Message ID when the target resists. */
+    resisted?: string;
+    /** Optional scheduling conditions (for passive mode). */
+    schedule?: InfluenceSchedule;
+    /** Message ID when PC tries to act while under this influence. */
+    onPlayerAction?: string;
+    /** Number of turns for lingering duration. */
+    lingeringTurns?: number;
+    /** Predicate condition to clear lingering effect. */
+    lingeringClearCondition?: string;
+}
+/** Author-defined resistance on the target NPC. */
+export interface ResistanceDef {
+    /** The influence name this entity resists. */
+    influenceName: string;
+    /**
+     * Conditions under which resistance fails (target becomes vulnerable).
+     * Uses the same predicate system as ADR-141/142.
+     */
+    except?: string[];
+}
+/** Runtime tracking of an applied influence effect. */
+export interface ActiveInfluenceEffect {
+    /** The influence name. */
+    influenceName: string;
+    /** The influencer's entity ID. */
+    influencerId: string;
+    /** The target's entity ID. */
+    targetId: string;
+    /** The applied effect mutations. */
+    effect: InfluenceEffect;
+    /** Duration type. */
+    duration: InfluenceDuration;
+    /** Turn when the effect was applied. */
+    appliedAtTurn: number;
+    /** For lingering: turn when the effect expires. */
+    expiresAtTurn?: number;
+    /** For lingering: predicate condition that clears the effect. */
+    clearCondition?: string;
+}
+/** Result of evaluating one influence against one target. */
+export type InfluenceResult = {
+    status: 'applied';
+    influenceName: string;
+    influencerId: string;
+    targetId: string;
+    effect: InfluenceEffect;
+    witnessed?: string;
+} | {
+    status: 'resisted';
+    influenceName: string;
+    influencerId: string;
+    targetId: string;
+    resisted?: string;
+} | {
+    status: 'skipped';
+    reason: string;
+};
+//# sourceMappingURL=influence-types.d.ts.map

package/influence/influence-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"influence-types.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/influence/influence-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,WAAW,GAAG,WAAW,CAAC;AAM5E;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAMD,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAMD,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IAEb,oCAAoC;IACpC,IAAI,EAAE,aAAa,CAAC;IAEpB,iCAAiC;IACjC,KAAK,EAAE,cAAc,CAAC;IAEtB,mDAAmD;IACnD,MAAM,EAAE,eAAe,CAAC;IAExB,iCAAiC;IACjC,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAE7B,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,qDAAqD;IACrD,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAMD,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAMD,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IAEtB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IAErB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,MAAM,EAAE,eAAe,CAAC;IAExB,qBAAqB;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IAEtB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GACvB;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/influence/influence-types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * NPC influence types (ADR-146)
+ *
+ * Type definitions for the influence system: influence definitions,
+ * resistance definitions, effect tracking, and evaluation results.
+ *
+ * Public interface: All exported types.
+ * Owner context: @sharpee/character / influence
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=influence-types.js.map

package/influence/influence-types.js.map

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

package/influence/pc-influence.d.ts

@@ -0,0 +1,38 @@
+/**
+ * PC influence handling (ADR-146 layer 4)
+ *
+ * Handles the effect of influences on the player character:
+ * checks for active influence effects on the PC and determines
+ * whether player actions should be intercepted.
+ *
+ * Public interface: evaluatePcInfluence, PcInfluenceResult.
+ * Owner context: @sharpee/character / influence
+ */
+import { InfluenceTracker } from './influence-duration';
+import { ActiveInfluenceEffect, InfluenceDef } from './influence-types';
+/** Result of checking PC influence before a player action. */
+export type PcInfluenceResult = {
+    status: 'clear';
+} | {
+    status: 'intercepted';
+    influenceName: string;
+    influencerId: string;
+    effect: ActiveInfluenceEffect;
+    onPlayerAction?: string;
+    clearConversationContext: boolean;
+};
+/**
+ * Check if the player is under any influence that would intercept their action.
+ *
+ * Returns the highest-impact influence affecting the PC, if any.
+ * An influence intercepts the PC when:
+ * - The effect includes `focus: 'clouded'` — clears conversation context
+ * - The influence has an `onPlayerAction` message — fires narrative message
+ *
+ * @param playerId - The player entity ID
+ * @param tracker - The influence tracker with active effects
+ * @param influenceDefs - Map of influencer ID to their influence definitions
+ * @returns PC influence result
+ */
+export declare function evaluatePcInfluence(playerId: string, tracker: InfluenceTracker, influenceDefs: Map<string, InfluenceDef[]>): PcInfluenceResult;
+//# sourceMappingURL=pc-influence.d.ts.map

package/influence/pc-influence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pc-influence.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/influence/pc-influence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMxE,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GACzB;IACE,MAAM,EAAE,OAAO,CAAC;CACjB,GACD;IACE,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,EAAE,OAAO,CAAC;CACnC,CAAC;AAMN;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,EACzB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GACzC,iBAAiB,CA6BnB"}

package/influence/pc-influence.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * PC influence handling (ADR-146 layer 4)
+ *
+ * Handles the effect of influences on the player character:
+ * checks for active influence effects on the PC and determines
+ * whether player actions should be intercepted.
+ *
+ * Public interface: evaluatePcInfluence, PcInfluenceResult.
+ * Owner context: @sharpee/character / influence
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluatePcInfluence = evaluatePcInfluence;
+// ---------------------------------------------------------------------------
+// PC influence evaluation
+// ---------------------------------------------------------------------------
+/**
+ * Check if the player is under any influence that would intercept their action.
+ *
+ * Returns the highest-impact influence affecting the PC, if any.
+ * An influence intercepts the PC when:
+ * - The effect includes `focus: 'clouded'` — clears conversation context
+ * - The influence has an `onPlayerAction` message — fires narrative message
+ *
+ * @param playerId - The player entity ID
+ * @param tracker - The influence tracker with active effects
+ * @param influenceDefs - Map of influencer ID to their influence definitions
+ * @returns PC influence result
+ */
+function evaluatePcInfluence(playerId, tracker, influenceDefs) {
+    const pcEffects = tracker.getEffectsOn(playerId);
+    if (pcEffects.length === 0) {
+        return { status: 'clear' };
+    }
+    // Find the first effect that would intercept the PC
+    for (const effect of pcEffects) {
+        // Look up the original influence definition for onPlayerAction message
+        const defs = influenceDefs.get(effect.influencerId);
+        const def = defs?.find(d => d.name === effect.influenceName);
+        const hasFocusClouded = effect.effect.focus === 'clouded';
+        const hasOnPlayerAction = def?.onPlayerAction !== undefined;
+        if (hasFocusClouded || hasOnPlayerAction) {
+            return {
+                status: 'intercepted',
+                influenceName: effect.influenceName,
+                influencerId: effect.influencerId,
+                effect,
+                onPlayerAction: def?.onPlayerAction,
+                clearConversationContext: hasFocusClouded,
+            };
+        }
+    }
+    // PC is under influence but none intercept actions
+    return { status: 'clear' };
+}
+//# sourceMappingURL=pc-influence.js.map

package/influence/pc-influence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pc-influence.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/influence/pc-influence.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAwCH,kDAiCC;AAlDD,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,SAAgB,mBAAmB,CACjC,QAAgB,EAChB,OAAyB,EACzB,aAA0C;IAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,oDAAoD;IACpD,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;QAC/B,uEAAuE;QACvE,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,aAAa,CAAC,CAAC;QAE7D,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC;QAC1D,MAAM,iBAAiB,GAAG,GAAG,EAAE,cAAc,KAAK,SAAS,CAAC;QAE5D,IAAI,eAAe,IAAI,iBAAiB,EAAE,CAAC;YACzC,OAAO;gBACL,MAAM,EAAE,aAAa;gBACrB,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,MAAM;gBACN,cAAc,EAAE,GAAG,EAAE,cAAc;gBACnC,wBAAwB,EAAE,eAAe;aAC1C,CAAC;QACJ,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sharpee/character",
-  "version": "0.9.106",
+  "version": "0.9.107",
   "description": "Character model builder for Sharpee Interactive Fiction Platform (ADR-141)",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -12,8 +12,9 @@
     }
   },
   "dependencies": {
-    "@sharpee/world-model": "^0.9.106",
-    "@sharpee/stdlib": "^0.9.106"
+    "@sharpee/core": "^0.9.107",
+    "@sharpee/world-model": "^0.9.107",
+    "@sharpee/stdlib": "^0.9.107"
   },
   "keywords": [
     "interactive-fiction",

package/propagation/builder.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Propagation builder API (ADR-144 layer 5)
+ *
+ * Extends CharacterBuilder with a fluent .propagation() method that
+ * accepts PropagationProfile options. The compiled profile is stored
+ * in CompiledCharacter for applyCharacter to consume.
+ *
+ * Public interface: propagation() method added to CharacterBuilder.
+ * Owner context: @sharpee/character / propagation
+ */
+import { PropagationTendency, PropagationAudience, PropagationPace, PropagationColoring, ReceivesAs, FactOverride, PropagationSchedule, PropagationProfile } from './propagation-types';
+/**
+ * Options for the .propagation() builder method.
+ * All fields map directly to PropagationProfile.
+ */
+export interface PropagationOptions {
+    /** How freely the NPC shares information. */
+    tendency: PropagationTendency;
+    /** Who the NPC shares with (default: 'trusted'). */
+    audience?: PropagationAudience;
+    /** NPC IDs explicitly excluded from sharing. */
+    excludes?: string[];
+    /** Topics the chatty NPC withholds (blacklist for chatty tendency). */
+    withholds?: string[];
+    /** Topics the selective NPC will share (whitelist for selective tendency). */
+    spreads?: string[];
+    /** Per-fact overrides. */
+    overrides?: Record<string, FactOverride>;
+    /** How quickly facts are shared (default: 'eager'). */
+    pace?: PropagationPace;
+    /** Optional scheduling conditions. */
+    schedule?: PropagationSchedule;
+    /** Tone of the telling (default: 'neutral'). */
+    coloring?: PropagationColoring;
+    /** Whether the player can use this NPC as a messenger (default: false). */
+    playerCanLeverage?: boolean;
+    /** How the NPC treats received information (default: 'as fact'). */
+    receives?: ReceivesAs;
+}
+/**
+ * Convert builder options to a PropagationProfile.
+ *
+ * @param opts - Builder options
+ * @returns A PropagationProfile with all specified fields
+ */
+export declare function buildPropagationProfile(opts: PropagationOptions): PropagationProfile;
+//# sourceMappingURL=builder.d.ts.map

package/propagation/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/propagation/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,QAAQ,EAAE,mBAAmB,CAAC;IAE9B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAE/B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAEzC,uDAAuD;IACvD,IAAI,CAAC,EAAE,eAAe,CAAC;IAEvB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAE/B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAE/B,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAiBpF"}