@sharpee/character 0.9.106 → 0.9.107

package/propagation/propagation-types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Information propagation types (ADR-144)
+ *
+ * Type definitions for NPC-to-NPC information flow: propagation
+ * profiles, audience/tendency/pace/coloring vocabularies, per-fact
+ * overrides, and transfer records.
+ *
+ * Public interface: All exported types.
+ * Owner context: @sharpee/character / propagation
+ */
+/** How freely the NPC shares information. */
+export type PropagationTendency = 'chatty' | 'selective' | 'mute';
+/** Who the NPC shares with. */
+export type PropagationAudience = 'trusted' | 'anyone' | 'allied';
+/** How quickly the NPC shares when conditions are met. */
+export type PropagationPace = 'eager' | 'gradual' | 'reluctant';
+/** Tone of the telling — hint to the language layer for variant selection. */
+export type PropagationColoring = 'neutral' | 'dramatic' | 'vague' | 'fearful' | 'conspiratorial';
+/** How the NPC receives information from others. */
+export type ReceivesAs = 'as fact' | 'as belief';
+/** Which version of a fact the NPC spreads. */
+export type SpreadsVersion = 'truth' | 'lie';
+/** Per-fact override for propagation behavior. */
+export interface FactOverride {
+    /** Override audience for this specific fact. */
+    to?: PropagationAudience;
+    /** Override which version to spread (truth or the lie told). */
+    spreadsVersion?: SpreadsVersion;
+    /** Override witnessed message for this fact when player is present. */
+    witnessed?: string;
+}
+/** When/where propagation happens. */
+export interface PropagationSchedule {
+    /** Predicate conditions that must be satisfied. */
+    when: string[];
+}
+/**
+ * Per-NPC propagation behavior definition.
+ * Controls who the NPC talks to, what they share, when, and how.
+ */
+export interface PropagationProfile {
+    /** How freely the NPC shares. */
+    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;
+}
+/** A single pending propagation transfer. */
+export interface PropagationTransfer {
+    /** The speaking NPC's entity ID. */
+    speakerId: string;
+    /** The listening NPC's entity ID. */
+    listenerId: string;
+    /** The topic being shared. */
+    topic: string;
+    /** Which version is being shared. */
+    version: SpreadsVersion;
+    /** The speaker's coloring for this transfer. */
+    coloring: PropagationColoring;
+    /** Per-fact witnessed message override, if any. */
+    witnessedOverride?: string;
+}
+/**
+ * Tracks which facts an NPC has already told to each listener.
+ * Prevents repeated sharing of the same fact to the same NPC.
+ */
+export declare class AlreadyToldRecord {
+    /** speakerId → listenerId → Set of topic names */
+    private readonly records;
+    /**
+     * Check if a speaker has already told a listener about a topic.
+     */
+    hasTold(speakerId: string, listenerId: string, topic: string): boolean;
+    /**
+     * Record that a speaker told a listener about a topic.
+     */
+    record(speakerId: string, listenerId: string, topic: string): void;
+    /** Export for serialization. */
+    toJSON(): Record<string, Record<string, string[]>>;
+    /** Restore from serialized data. */
+    static fromJSON(data: Record<string, Record<string, string[]>>): AlreadyToldRecord;
+}
+//# sourceMappingURL=propagation-types.d.ts.map

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

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

package/propagation/propagation-types.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Information propagation types (ADR-144)
+ *
+ * Type definitions for NPC-to-NPC information flow: propagation
+ * profiles, audience/tendency/pace/coloring vocabularies, per-fact
+ * overrides, and transfer records.
+ *
+ * Public interface: All exported types.
+ * Owner context: @sharpee/character / propagation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlreadyToldRecord = void 0;
+/**
+ * Tracks which facts an NPC has already told to each listener.
+ * Prevents repeated sharing of the same fact to the same NPC.
+ */
+class AlreadyToldRecord {
+    /** speakerId → listenerId → Set of topic names */
+    records = new Map();
+    /**
+     * Check if a speaker has already told a listener about a topic.
+     */
+    hasTold(speakerId, listenerId, topic) {
+        return this.records.get(speakerId)?.get(listenerId)?.has(topic) ?? false;
+    }
+    /**
+     * Record that a speaker told a listener about a topic.
+     */
+    record(speakerId, listenerId, topic) {
+        let speakerRecord = this.records.get(speakerId);
+        if (!speakerRecord) {
+            speakerRecord = new Map();
+            this.records.set(speakerId, speakerRecord);
+        }
+        let listenerSet = speakerRecord.get(listenerId);
+        if (!listenerSet) {
+            listenerSet = new Set();
+            speakerRecord.set(listenerId, listenerSet);
+        }
+        listenerSet.add(topic);
+    }
+    /** Export for serialization. */
+    toJSON() {
+        const result = {};
+        for (const [speakerId, listenerMap] of this.records) {
+            result[speakerId] = {};
+            for (const [listenerId, topics] of listenerMap) {
+                result[speakerId][listenerId] = Array.from(topics);
+            }
+        }
+        return result;
+    }
+    /** Restore from serialized data. */
+    static fromJSON(data) {
+        const record = new AlreadyToldRecord();
+        for (const [speakerId, listeners] of Object.entries(data)) {
+            for (const [listenerId, topics] of Object.entries(listeners)) {
+                for (const topic of topics) {
+                    record.record(speakerId, listenerId, topic);
+                }
+            }
+        }
+        return record;
+    }
+}
+exports.AlreadyToldRecord = AlreadyToldRecord;
+//# sourceMappingURL=propagation-types.js.map

package/propagation/propagation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation-types.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/propagation/propagation-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AA2HH;;;GAGG;AACH,MAAa,iBAAiB;IAC5B,kDAAkD;IACjC,OAAO,GAA0C,IAAI,GAAG,EAAE,CAAC;IAE5E;;OAEG;IACH,OAAO,CAAC,SAAiB,EAAE,UAAkB,EAAE,KAAa;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IAC3E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAiB,EAAE,UAAkB,EAAE,KAAa;QACzD,IAAI,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;YACxB,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC7C,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,gCAAgC;IAChC,MAAM;QACJ,MAAM,MAAM,GAA6C,EAAE,CAAC;QAC5D,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACpD,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;gBAC/C,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,QAAQ,CAAC,IAA8C;QAC5D,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBAC3B,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AApDD,8CAoDC"}

package/propagation/visibility.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Propagation visibility (ADR-144)
+ *
+ * Determines what the player sees when NPC-to-NPC information
+ * transfer occurs. Three modes: offscreen (absent), witnessed
+ * (present), eavesdropped (concealed).
+ *
+ * Public interface: PropagationVisibility, getVisibilityMessage.
+ * Owner context: @sharpee/character / propagation
+ */
+import { PropagationTransfer, PropagationColoring } from './propagation-types';
+/** The player's presence state relative to the propagation event. */
+export type PlayerPresence = 'absent' | 'present' | 'concealed';
+/** The visibility output for a single propagation transfer. */
+export interface PropagationVisibilityResult {
+    /** The transfer this result is for. */
+    transfer: PropagationTransfer;
+    /** The player's presence state. */
+    presence: PlayerPresence;
+    /** Message ID to emit (undefined if offscreen). */
+    messageId?: string;
+    /** Whether the player gains the fact with source 'overheard'. */
+    playerLearns: boolean;
+}
+/**
+ * Platform default witnessed message IDs per coloring.
+ * Authors override per fact via FactOverride.witnessed.
+ */
+export declare const PROPAGATION_WITNESSED_DEFAULTS: Record<PropagationColoring, string>;
+/**
+ * Determine visibility output for a propagation transfer.
+ *
+ * @param transfer - The propagation transfer
+ * @param presence - The player's presence state
+ * @returns Visibility result with message ID and player-learns flag
+ */
+export declare function getVisibilityResult(transfer: PropagationTransfer, presence: PlayerPresence): PropagationVisibilityResult;
+/**
+ * Evaluate visibility for multiple transfers.
+ *
+ * @param transfers - The transfers to evaluate
+ * @param presence - The player's presence state
+ * @returns Array of visibility results
+ */
+export declare function getVisibilityResults(transfers: PropagationTransfer[], presence: PlayerPresence): PropagationVisibilityResult[];
+//# sourceMappingURL=visibility.d.ts.map

package/propagation/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/propagation/visibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAM/E,qEAAqE;AACrE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAMhE,+DAA+D;AAC/D,MAAM,WAAW,2BAA2B;IAC1C,uCAAuC;IACvC,QAAQ,EAAE,mBAAmB,CAAC;IAE9B,mCAAmC;IACnC,QAAQ,EAAE,cAAc,CAAC;IAEzB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iEAAiE;IACjE,YAAY,EAAE,OAAO,CAAC;CACvB;AAMD;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAM9E,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,cAAc,GACvB,2BAA2B,CA8B7B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,mBAAmB,EAAE,EAChC,QAAQ,EAAE,cAAc,GACvB,2BAA2B,EAAE,CAE/B"}

package/propagation/visibility.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Propagation visibility (ADR-144)
+ *
+ * Determines what the player sees when NPC-to-NPC information
+ * transfer occurs. Three modes: offscreen (absent), witnessed
+ * (present), eavesdropped (concealed).
+ *
+ * Public interface: PropagationVisibility, getVisibilityMessage.
+ * Owner context: @sharpee/character / propagation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROPAGATION_WITNESSED_DEFAULTS = void 0;
+exports.getVisibilityResult = getVisibilityResult;
+exports.getVisibilityResults = getVisibilityResults;
+// ---------------------------------------------------------------------------
+// Platform defaults per coloring
+// ---------------------------------------------------------------------------
+/**
+ * Platform default witnessed message IDs per coloring.
+ * Authors override per fact via FactOverride.witnessed.
+ */
+exports.PROPAGATION_WITNESSED_DEFAULTS = {
+    neutral: 'character.propagation.witnessed.neutral',
+    dramatic: 'character.propagation.witnessed.dramatic',
+    vague: 'character.propagation.witnessed.vague',
+    fearful: 'character.propagation.witnessed.fearful',
+    conspiratorial: 'character.propagation.witnessed.conspiratorial',
+};
+// ---------------------------------------------------------------------------
+// Visibility evaluation
+// ---------------------------------------------------------------------------
+/**
+ * Determine visibility output for a propagation transfer.
+ *
+ * @param transfer - The propagation transfer
+ * @param presence - The player's presence state
+ * @returns Visibility result with message ID and player-learns flag
+ */
+function getVisibilityResult(transfer, presence) {
+    switch (presence) {
+        case 'absent':
+            // Offscreen — state mutation only, no message
+            return {
+                transfer,
+                presence,
+                playerLearns: false,
+            };
+        case 'present':
+            // Witnessed — player sees a summary message
+            return {
+                transfer,
+                presence,
+                messageId: transfer.witnessedOverride
+                    ?? exports.PROPAGATION_WITNESSED_DEFAULTS[transfer.coloring],
+                playerLearns: false,
+            };
+        case 'concealed':
+            // Eavesdropped — player sees full dialogue and learns the fact
+            return {
+                transfer,
+                presence,
+                messageId: transfer.witnessedOverride
+                    ?? exports.PROPAGATION_WITNESSED_DEFAULTS[transfer.coloring],
+                playerLearns: true,
+            };
+    }
+}
+/**
+ * Evaluate visibility for multiple transfers.
+ *
+ * @param transfers - The transfers to evaluate
+ * @param presence - The player's presence state
+ * @returns Array of visibility results
+ */
+function getVisibilityResults(transfers, presence) {
+    return transfers.map(t => getVisibilityResult(t, presence));
+}
+//# sourceMappingURL=visibility.js.map

package/propagation/visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/propagation/visibility.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAyDH,kDAiCC;AASD,oDAKC;AA1ED,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E;;;GAGG;AACU,QAAA,8BAA8B,GAAwC;IACjF,OAAO,EAAS,yCAAyC;IACzD,QAAQ,EAAQ,0CAA0C;IAC1D,KAAK,EAAW,uCAAuC;IACvD,OAAO,EAAS,yCAAyC;IACzD,cAAc,EAAE,gDAAgD;CACjE,CAAC;AAEF,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,QAA6B,EAC7B,QAAwB;IAExB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,8CAA8C;YAC9C,OAAO;gBACL,QAAQ;gBACR,QAAQ;gBACR,YAAY,EAAE,KAAK;aACpB,CAAC;QAEJ,KAAK,SAAS;YACZ,4CAA4C;YAC5C,OAAO;gBACL,QAAQ;gBACR,QAAQ;gBACR,SAAS,EAAE,QAAQ,CAAC,iBAAiB;uBAChC,sCAA8B,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACtD,YAAY,EAAE,KAAK;aACpB,CAAC;QAEJ,KAAK,WAAW;YACd,+DAA+D;YAC/D,OAAO;gBACL,QAAQ;gBACR,QAAQ;gBACR,SAAS,EAAE,QAAQ,CAAC,iBAAiB;uBAChC,sCAA8B,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACtD,YAAY,EAAE,IAAI;aACnB,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAClC,SAAgC,EAChC,QAAwB;IAExB,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/tick-phases.d.ts

@@ -0,0 +1,93 @@
+/**
+ * NPC tick phase implementations (ADR-144, 145, 146)
+ *
+ * Factory functions that create tick phase handlers for propagation,
+ * goal pursuit, and influence evaluation. Register these with
+ * NpcService.registerTickPhase() during story initialization.
+ *
+ * Public interface: createPropagationPhase, createGoalPhase,
+ *   createInfluencePhase, CharacterPhaseConfig.
+ * Owner context: @sharpee/character
+ */
+import { ISemanticEvent, EntityId } from "../core/index";
+import { IFEntity, WorldModel } from "../world-model/index";
+import { PropagationProfile, AlreadyToldRecord } from './propagation';
+import { GoalDef, MovementProfile, GoalManager } from './goals';
+import { InfluenceDef, ResistanceDef, InfluenceTracker } from './influence';
+/** Tick context — mirrors NpcTickContext from stdlib. */
+interface TickContext {
+    world: WorldModel;
+    turn: number;
+    random: unknown;
+    playerLocation: EntityId;
+    playerId: EntityId;
+}
+/** Per-NPC character configuration for tick phases. */
+export interface CharacterPhaseConfig {
+    propagationProfile?: PropagationProfile;
+    goalDefs?: GoalDef[];
+    movementProfile?: MovementProfile;
+    influenceDefs?: InfluenceDef[];
+    resistanceDefs?: ResistanceDef[];
+}
+/** Manages per-NPC configs and shared state for tick phases. */
+export declare class CharacterPhaseRegistry {
+    private readonly configs;
+    private readonly goalManagers;
+    readonly influenceTracker: InfluenceTracker;
+    readonly alreadyToldRecord: AlreadyToldRecord;
+    /**
+     * Register character configuration for an NPC.
+     *
+     * @param entityId - NPC entity ID
+     * @param config - Configuration from AppliedCharacter
+     */
+    register(entityId: string, config: CharacterPhaseConfig): void;
+    /** Get config for an NPC. */
+    getConfig(entityId: string): CharacterPhaseConfig | undefined;
+    /** Get goal manager for an NPC. */
+    getGoalManager(entityId: string): GoalManager | undefined;
+    /** Check if any NPCs have been registered. */
+    get hasConfigs(): boolean;
+    /**
+     * Export serializable state for save/restore.
+     * Configs are authored (re-registered on load), so only mutable state is saved.
+     */
+    toJSON(): {
+        goalStates: Record<string, ReturnType<GoalManager['toJSON']>>;
+        influenceEffects: ReturnType<InfluenceTracker['toJSON']>;
+        alreadyTold: ReturnType<AlreadyToldRecord['toJSON']>;
+    };
+    /**
+     * Restore mutable state from saved data.
+     * Call after re-registering all NPC configs.
+     */
+    restoreState(saved: {
+        goalStates?: Record<string, ReturnType<GoalManager['toJSON']>>;
+        influenceEffects?: ReturnType<InfluenceTracker['toJSON']>;
+        alreadyTold?: ReturnType<AlreadyToldRecord['toJSON']>;
+    }): void;
+}
+/**
+ * Create a propagation tick phase handler.
+ *
+ * @param registry - The character phase registry
+ * @returns Tick phase handler function
+ */
+export declare function createPropagationPhase(registry: CharacterPhaseRegistry): (npcs: IFEntity[], ctx: TickContext) => ISemanticEvent[];
+/**
+ * Create a goal pursuit tick phase handler.
+ *
+ * @param registry - The character phase registry
+ * @returns Tick phase handler function
+ */
+export declare function createGoalPhase(registry: CharacterPhaseRegistry): (npcs: IFEntity[], ctx: TickContext) => ISemanticEvent[];
+/**
+ * Create an influence evaluation tick phase handler.
+ *
+ * @param registry - The character phase registry
+ * @returns Tick phase handler function
+ */
+export declare function createInfluencePhase(registry: CharacterPhaseRegistry): (npcs: IFEntity[], ctx: TickContext) => ISemanticEvent[];
+export {};
+//# sourceMappingURL=tick-phases.d.ts.map

package/tick-phases.d.ts.map

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