@sharpee/character 0.9.106 → 0.9.107

package/conversation/constraint-evaluator.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Constraint evaluator (ADR-142)
+ *
+ * Evaluates authored response constraints against NPC character state
+ * to select the appropriate response. Uses first-match-wins ordering
+ * with .otherwise() fallback.
+ *
+ * Also handles response recording, contradiction detection, and
+ * evidence tracking.
+ *
+ * Public interface: evaluateConstraints, ConstraintEvaluator.
+ * Owner context: @sharpee/character / conversation
+ */
+import { CharacterModelTrait } from "../../world-model/index";
+import { ResponseCandidate, ResponseAction, ConversationRecord, ConversationEntry, EvidenceEntry } from './response-types';
+/** A detected contradiction in conversation history. */
+export interface Contradiction {
+    /** The topic where the contradiction was detected. */
+    topic: string;
+    /** The previous response action for this topic. */
+    previousAction: ResponseAction;
+    /** The new response action that contradicts the previous one. */
+    currentAction: ResponseAction;
+    /** Turn of the previous response. */
+    previousTurn: number;
+    /** Turn of the current response. */
+    currentTurn: number;
+}
+/**
+ * Evaluate a list of response candidates against NPC character state.
+ * Uses first-match-wins: the first candidate whose constraints are all
+ * satisfied is selected. Empty constraints means "always matches"
+ * (the .otherwise() fallback).
+ *
+ * @param candidates - Ordered list of response candidates for this topic
+ * @param npcTrait - The NPC's CharacterModelTrait for predicate evaluation
+ * @returns The selected candidate, or undefined if no candidate matches
+ */
+export declare function evaluateConstraints(candidates: ResponseCandidate[], npcTrait: CharacterModelTrait): ResponseCandidate | undefined;
+/**
+ * Stateful constraint evaluator that tracks conversation history,
+ * detects contradictions, and records evidence presentations.
+ *
+ * One instance per NPC. State survives save/restore.
+ */
+export declare class ConstraintEvaluator {
+    /** Per-NPC conversation records. Keyed by NPC entity ID. */
+    private readonly records;
+    /** Evidence the player has presented. Keyed by NPC entity ID. */
+    private readonly evidence;
+    /**
+     * Evaluate constraints and select the best response for a topic.
+     *
+     * @param candidates - Ordered response candidates
+     * @param npcTrait - NPC's character model trait
+     * @returns The selected candidate, or undefined
+     */
+    evaluate(candidates: ResponseCandidate[], npcTrait: CharacterModelTrait): ResponseCandidate | undefined;
+    /**
+     * Record that an NPC gave a specific response to a topic.
+     * Updates both the current response and the history.
+     *
+     * @param npcId - The NPC entity ID
+     * @param topic - The topic name
+     * @param action - The response action taken
+     * @param turn - The current turn number
+     * @returns A Contradiction if this response contradicts a previous one, or undefined
+     */
+    recordResponse(npcId: string, topic: string, action: ResponseAction, turn: number): Contradiction | undefined;
+    /**
+     * Get the conversation record for an NPC.
+     *
+     * @param npcId - The NPC entity ID
+     * @returns The conversation record, or undefined if no conversation has occurred
+     */
+    getRecord(npcId: string): ConversationRecord | undefined;
+    /**
+     * Check whether a topic has been discussed with an NPC.
+     *
+     * @param npcId - The NPC entity ID
+     * @param topic - The topic name
+     * @returns True if the topic has been discussed
+     */
+    hasDiscussed(npcId: string, topic: string): boolean;
+    /**
+     * Get the most recent response action for a topic.
+     *
+     * @param npcId - The NPC entity ID
+     * @param topic - The topic name
+     * @returns The most recent conversation entry, or undefined
+     */
+    getLastResponse(npcId: string, topic: string): ConversationEntry | undefined;
+    /**
+     * Record that the player presented evidence/information to an NPC.
+     *
+     * @param npcId - The NPC entity ID
+     * @param topic - The evidence topic
+     * @param turn - The current turn number
+     */
+    recordEvidence(npcId: string, topic: string, turn: number): void;
+    /**
+     * Check whether the player has presented specific evidence to an NPC.
+     *
+     * @param npcId - The NPC entity ID
+     * @param topic - The evidence topic
+     * @returns True if this evidence has been presented
+     */
+    hasPresented(npcId: string, topic: string): boolean;
+    /**
+     * Get all evidence presented to an NPC.
+     *
+     * @param npcId - The NPC entity ID
+     * @returns Array of evidence entries, or empty array
+     */
+    getEvidence(npcId: string): EvidenceEntry[];
+    /**
+     * Export state for save/restore.
+     * Converts Maps to plain objects for JSON serialization.
+     */
+    toJSON(): ConstraintEvaluatorState;
+    /**
+     * Restore state from serialized data.
+     *
+     * @param state - Previously serialized state
+     */
+    static fromJSON(state: ConstraintEvaluatorState): ConstraintEvaluator;
+    /** Get or create a conversation record for an NPC. */
+    private getOrCreateRecord;
+    /**
+     * Determine if two response actions constitute a contradiction.
+     * A contradiction occurs when the NPC's story changes — telling the truth
+     * after lying, confessing after deflecting, etc.
+     */
+    private isContradiction;
+}
+/** Serialized conversation record (Maps converted to plain objects). */
+interface SerializedConversationRecord {
+    responses: Record<string, ConversationEntry>;
+    history: Record<string, ConversationEntry[]>;
+}
+/** Full serialized state of a ConstraintEvaluator. */
+export interface ConstraintEvaluatorState {
+    records: Record<string, SerializedConversationRecord>;
+    evidence: Record<string, EvidenceEntry[]>;
+}
+export {};
+//# sourceMappingURL=constraint-evaluator.d.ts.map

package/conversation/constraint-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint-evaluator.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/conversation/constraint-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EAEjB,aAAa,EAGd,MAAM,kBAAkB,CAAC;AAM1B,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IAEd,mDAAmD;IACnD,cAAc,EAAE,cAAc,CAAC;IAE/B,iEAAiE;IACjE,aAAa,EAAE,cAAc,CAAC;IAE9B,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IAErB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,QAAQ,EAAE,mBAAmB,GAC5B,iBAAiB,GAAG,SAAS,CAiB/B;AAMD;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IAEtE,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IAMnE;;;;;;OAMG;IACH,QAAQ,CACN,UAAU,EAAE,iBAAiB,EAAE,EAC/B,QAAQ,EAAE,mBAAmB,GAC5B,iBAAiB,GAAG,SAAS;IAIhC;;;;;;;;;OASG;IACH,cAAc,CACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GACX,aAAa,GAAG,SAAS;IA6B5B;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIxD;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAKnD;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAQ5E;;;;;;OAMG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMhE;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAKnD;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE;IAQ3C;;;OAGG;IACH,MAAM,IAAI,wBAAwB;IAmBlC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,wBAAwB,GAAG,mBAAmB;IAsBrE,sDAAsD;IACtD,OAAO,CAAC,iBAAiB;IASzB;;;;OAIG;IACH,OAAO,CAAC,eAAe;CAqBxB;AAMD,wEAAwE;AACxE,UAAU,4BAA4B;IACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;CAC9C;AAED,sDAAsD;AACtD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IACtD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CAC3C"}

package/conversation/constraint-evaluator.js

@@ -0,0 +1,247 @@
+"use strict";
+/**
+ * Constraint evaluator (ADR-142)
+ *
+ * Evaluates authored response constraints against NPC character state
+ * to select the appropriate response. Uses first-match-wins ordering
+ * with .otherwise() fallback.
+ *
+ * Also handles response recording, contradiction detection, and
+ * evidence tracking.
+ *
+ * Public interface: evaluateConstraints, ConstraintEvaluator.
+ * Owner context: @sharpee/character / conversation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConstraintEvaluator = void 0;
+exports.evaluateConstraints = evaluateConstraints;
+const response_types_1 = require("./response-types");
+// ---------------------------------------------------------------------------
+// Pure evaluation function
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate a list of response candidates against NPC character state.
+ * Uses first-match-wins: the first candidate whose constraints are all
+ * satisfied is selected. Empty constraints means "always matches"
+ * (the .otherwise() fallback).
+ *
+ * @param candidates - Ordered list of response candidates for this topic
+ * @param npcTrait - The NPC's CharacterModelTrait for predicate evaluation
+ * @returns The selected candidate, or undefined if no candidate matches
+ */
+function evaluateConstraints(candidates, npcTrait) {
+    for (const candidate of candidates) {
+        if (candidate.constraints.length === 0) {
+            // .otherwise() — always matches
+            return candidate;
+        }
+        const allSatisfied = candidate.constraints.every(pred => npcTrait.evaluate(pred));
+        if (allSatisfied) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Stateful evaluator (owns conversation records and evidence)
+// ---------------------------------------------------------------------------
+/**
+ * Stateful constraint evaluator that tracks conversation history,
+ * detects contradictions, and records evidence presentations.
+ *
+ * One instance per NPC. State survives save/restore.
+ */
+class ConstraintEvaluator {
+    /** Per-NPC conversation records. Keyed by NPC entity ID. */
+    records = new Map();
+    /** Evidence the player has presented. Keyed by NPC entity ID. */
+    evidence = (0, response_types_1.createEvidenceRecord)();
+    // =========================================================================
+    // Response evaluation and recording
+    // =========================================================================
+    /**
+     * Evaluate constraints and select the best response for a topic.
+     *
+     * @param candidates - Ordered response candidates
+     * @param npcTrait - NPC's character model trait
+     * @returns The selected candidate, or undefined
+     */
+    evaluate(candidates, npcTrait) {
+        return evaluateConstraints(candidates, npcTrait);
+    }
+    /**
+     * Record that an NPC gave a specific response to a topic.
+     * Updates both the current response and the history.
+     *
+     * @param npcId - The NPC entity ID
+     * @param topic - The topic name
+     * @param action - The response action taken
+     * @param turn - The current turn number
+     * @returns A Contradiction if this response contradicts a previous one, or undefined
+     */
+    recordResponse(npcId, topic, action, turn) {
+        const record = this.getOrCreateRecord(npcId);
+        const entry = { action, turn };
+        // Check for contradiction before updating
+        const previous = record.responses.get(topic);
+        let contradiction;
+        if (previous && this.isContradiction(previous.action, action)) {
+            contradiction = {
+                topic,
+                previousAction: previous.action,
+                currentAction: action,
+                previousTurn: previous.turn,
+                currentTurn: turn,
+            };
+        }
+        // Update current response
+        record.responses.set(topic, entry);
+        // Append to history
+        const history = record.history.get(topic) ?? [];
+        history.push(entry);
+        record.history.set(topic, history);
+        return contradiction;
+    }
+    /**
+     * Get the conversation record for an NPC.
+     *
+     * @param npcId - The NPC entity ID
+     * @returns The conversation record, or undefined if no conversation has occurred
+     */
+    getRecord(npcId) {
+        return this.records.get(npcId);
+    }
+    /**
+     * Check whether a topic has been discussed with an NPC.
+     *
+     * @param npcId - The NPC entity ID
+     * @param topic - The topic name
+     * @returns True if the topic has been discussed
+     */
+    hasDiscussed(npcId, topic) {
+        const record = this.records.get(npcId);
+        return record?.responses.has(topic) ?? false;
+    }
+    /**
+     * Get the most recent response action for a topic.
+     *
+     * @param npcId - The NPC entity ID
+     * @param topic - The topic name
+     * @returns The most recent conversation entry, or undefined
+     */
+    getLastResponse(npcId, topic) {
+        return this.records.get(npcId)?.responses.get(topic);
+    }
+    // =========================================================================
+    // Evidence tracking
+    // =========================================================================
+    /**
+     * Record that the player presented evidence/information to an NPC.
+     *
+     * @param npcId - The NPC entity ID
+     * @param topic - The evidence topic
+     * @param turn - The current turn number
+     */
+    recordEvidence(npcId, topic, turn) {
+        const entries = this.evidence.get(npcId) ?? [];
+        entries.push({ topic, turn });
+        this.evidence.set(npcId, entries);
+    }
+    /**
+     * Check whether the player has presented specific evidence to an NPC.
+     *
+     * @param npcId - The NPC entity ID
+     * @param topic - The evidence topic
+     * @returns True if this evidence has been presented
+     */
+    hasPresented(npcId, topic) {
+        const entries = this.evidence.get(npcId);
+        return entries?.some(e => e.topic === topic) ?? false;
+    }
+    /**
+     * Get all evidence presented to an NPC.
+     *
+     * @param npcId - The NPC entity ID
+     * @returns Array of evidence entries, or empty array
+     */
+    getEvidence(npcId) {
+        return this.evidence.get(npcId) ?? [];
+    }
+    // =========================================================================
+    // Serialization support
+    // =========================================================================
+    /**
+     * Export state for save/restore.
+     * Converts Maps to plain objects for JSON serialization.
+     */
+    toJSON() {
+        const records = {};
+        for (const [npcId, record] of this.records) {
+            records[npcId] = {
+                responses: Object.fromEntries(record.responses),
+                history: Object.fromEntries(Array.from(record.history.entries()).map(([topic, entries]) => [topic, entries])),
+            };
+        }
+        const evidence = {};
+        for (const [npcId, entries] of this.evidence) {
+            evidence[npcId] = entries;
+        }
+        return { records, evidence };
+    }
+    /**
+     * Restore state from serialized data.
+     *
+     * @param state - Previously serialized state
+     */
+    static fromJSON(state) {
+        const evaluator = new ConstraintEvaluator();
+        for (const [npcId, serialized] of Object.entries(state.records)) {
+            const record = {
+                responses: new Map(Object.entries(serialized.responses)),
+                history: new Map(Object.entries(serialized.history)),
+            };
+            evaluator.records.set(npcId, record);
+        }
+        for (const [npcId, entries] of Object.entries(state.evidence)) {
+            evaluator.evidence.set(npcId, entries);
+        }
+        return evaluator;
+    }
+    // =========================================================================
+    // Private helpers
+    // =========================================================================
+    /** Get or create a conversation record for an NPC. */
+    getOrCreateRecord(npcId) {
+        let record = this.records.get(npcId);
+        if (!record) {
+            record = (0, response_types_1.createConversationRecord)();
+            this.records.set(npcId, record);
+        }
+        return record;
+    }
+    /**
+     * Determine if two response actions constitute a contradiction.
+     * A contradiction occurs when the NPC's story changes — telling the truth
+     * after lying, confessing after deflecting, etc.
+     */
+    isContradiction(previous, current) {
+        // Same action is never a contradiction
+        if (previous === current)
+            return false;
+        // These pairs are contradictory — the NPC's story changed
+        const contradictoryPairs = [
+            ['tell', 'lie'],
+            ['lie', 'tell'],
+            ['lie', 'confess'],
+            ['deflect', 'confess'],
+            ['refuse', 'confess'],
+            ['omit', 'tell'],
+            ['omit', 'confess'],
+            ['confabulate', 'tell'],
+            ['confabulate', 'confess'],
+        ];
+        return contradictoryPairs.some(([a, b]) => previous === a && current === b);
+    }
+}
+exports.ConstraintEvaluator = ConstraintEvaluator;
+//# sourceMappingURL=constraint-evaluator.js.map

package/conversation/constraint-evaluator.js.map

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

package/conversation/conversation-messages.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Conversation message IDs (ADR-142)
+ *
+ * Semantic message IDs for conversation system events.
+ * Actual text is provided by the language layer (lang-en-us).
+ *
+ * Public interface: ConversationMessages.
+ * Owner context: @sharpee/character / conversation
+ */
+/**
+ * Platform default message IDs for the conversation system.
+ * Authors override these per-NPC; these serve as fallbacks.
+ */
+export declare const ConversationMessages: {
+    /** Framing for deflect responses. */
+    readonly RESPONSE_DEFLECT: "character.conversation.response.deflect";
+    /** Framing for refuse responses. */
+    readonly RESPONSE_REFUSE: "character.conversation.response.refuse";
+    /** Framing for confabulate responses (NPC fills in gaps). */
+    readonly RESPONSE_CONFABULATE: "character.conversation.response.confabulate";
+    /** Framing for omit responses (NPC knows but stays silent). */
+    readonly RESPONSE_OMIT: "character.conversation.response.omit";
+    /** Fragmented speech (low coherence). */
+    readonly COGNITIVE_FRAGMENTED: "character.conversation.cognitive.fragmented";
+    /** Drifting speech (mid coherence, tangential). */
+    readonly COGNITIVE_DRIFTING: "character.conversation.cognitive.drifting";
+    /** Detached speech (low selfModel, flat affect). */
+    readonly COGNITIVE_DETACHED: "character.conversation.cognitive.detached";
+    /** Eager NPC, first non-conversation turn. */
+    readonly BETWEEN_TURN_EAGER_1: "character.conversation.between.eager.1";
+    /** Eager NPC, third+ non-conversation turn. */
+    readonly BETWEEN_TURN_EAGER_3: "character.conversation.between.eager.3";
+    /** Reluctant NPC, first non-conversation turn. */
+    readonly BETWEEN_TURN_RELUCTANT_1: "character.conversation.between.reluctant.1";
+    /** Hostile NPC, first non-conversation turn. */
+    readonly BETWEEN_TURN_HOSTILE_1: "character.conversation.between.hostile.1";
+    /** Confessing NPC, first non-conversation turn. */
+    readonly BETWEEN_TURN_CONFESSING_1: "character.conversation.between.confessing.1";
+    /** Confessing NPC, third non-conversation turn. */
+    readonly BETWEEN_TURN_CONFESSING_3: "character.conversation.between.confessing.3";
+    /** Neutral NPC, third+ non-conversation turn (default decay). */
+    readonly BETWEEN_TURN_NEUTRAL_3: "character.conversation.between.neutral.3";
+    /** NPC yields attention when player redirects to another NPC. */
+    readonly ATTENTION_YIELDS: "character.conversation.attention.yields";
+    /** NPC protests when player redirects but doesn't block. */
+    readonly ATTENTION_PROTESTS: "character.conversation.attention.protests";
+    /** NPC blocks player from redirecting (strong attention hold). */
+    readonly ATTENTION_BLOCKS: "character.conversation.attention.blocks";
+    /** Conversation ends naturally (goodbye). */
+    readonly CONVERSATION_ENDS: "character.conversation.ends";
+    /** NPC initiates conversation. */
+    readonly CONVERSATION_INITIATES: "character.conversation.initiates";
+};
+/** Type for conversation message IDs. */
+export type ConversationMessageId = (typeof ConversationMessages)[keyof typeof ConversationMessages];
+//# sourceMappingURL=conversation-messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-messages.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/conversation/conversation-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAK/B,qCAAqC;;IAErC,oCAAoC;;IAEpC,6DAA6D;;IAE7D,+DAA+D;;IAO/D,yCAAyC;;IAEzC,mDAAmD;;IAEnD,oDAAoD;;IAOpD,8CAA8C;;IAE9C,+CAA+C;;IAE/C,kDAAkD;;IAElD,gDAAgD;;IAEhD,mDAAmD;;IAEnD,mDAAmD;;IAEnD,iEAAiE;;IAOjE,iEAAiE;;IAEjE,4DAA4D;;IAE5D,kEAAkE;;IAElE,6CAA6C;;IAE7C,kCAAkC;;CAE1B,CAAC;AAEX,yCAAyC;AACzC,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC"}

package/conversation/conversation-messages.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Conversation message IDs (ADR-142)
+ *
+ * Semantic message IDs for conversation system events.
+ * Actual text is provided by the language layer (lang-en-us).
+ *
+ * Public interface: ConversationMessages.
+ * Owner context: @sharpee/character / conversation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationMessages = void 0;
+/**
+ * Platform default message IDs for the conversation system.
+ * Authors override these per-NPC; these serve as fallbacks.
+ */
+exports.ConversationMessages = {
+    // -------------------------------------------------------------------------
+    // Response action framing — wraps author message with response type context
+    // -------------------------------------------------------------------------
+    /** Framing for deflect responses. */
+    RESPONSE_DEFLECT: 'character.conversation.response.deflect',
+    /** Framing for refuse responses. */
+    RESPONSE_REFUSE: 'character.conversation.response.refuse',
+    /** Framing for confabulate responses (NPC fills in gaps). */
+    RESPONSE_CONFABULATE: 'character.conversation.response.confabulate',
+    /** Framing for omit responses (NPC knows but stays silent). */
+    RESPONSE_OMIT: 'character.conversation.response.omit',
+    // -------------------------------------------------------------------------
+    // Cognitive speech patterns — applied when NPC has cognitive state
+    // -------------------------------------------------------------------------
+    /** Fragmented speech (low coherence). */
+    COGNITIVE_FRAGMENTED: 'character.conversation.cognitive.fragmented',
+    /** Drifting speech (mid coherence, tangential). */
+    COGNITIVE_DRIFTING: 'character.conversation.cognitive.drifting',
+    /** Detached speech (low selfModel, flat affect). */
+    COGNITIVE_DETACHED: 'character.conversation.cognitive.detached',
+    // -------------------------------------------------------------------------
+    // Between-turn defaults — NPC commentary when player does other things
+    // -------------------------------------------------------------------------
+    /** Eager NPC, first non-conversation turn. */
+    BETWEEN_TURN_EAGER_1: 'character.conversation.between.eager.1',
+    /** Eager NPC, third+ non-conversation turn. */
+    BETWEEN_TURN_EAGER_3: 'character.conversation.between.eager.3',
+    /** Reluctant NPC, first non-conversation turn. */
+    BETWEEN_TURN_RELUCTANT_1: 'character.conversation.between.reluctant.1',
+    /** Hostile NPC, first non-conversation turn. */
+    BETWEEN_TURN_HOSTILE_1: 'character.conversation.between.hostile.1',
+    /** Confessing NPC, first non-conversation turn. */
+    BETWEEN_TURN_CONFESSING_1: 'character.conversation.between.confessing.1',
+    /** Confessing NPC, third non-conversation turn. */
+    BETWEEN_TURN_CONFESSING_3: 'character.conversation.between.confessing.3',
+    /** Neutral NPC, third+ non-conversation turn (default decay). */
+    BETWEEN_TURN_NEUTRAL_3: 'character.conversation.between.neutral.3',
+    // -------------------------------------------------------------------------
+    // Attention / lifecycle
+    // -------------------------------------------------------------------------
+    /** NPC yields attention when player redirects to another NPC. */
+    ATTENTION_YIELDS: 'character.conversation.attention.yields',
+    /** NPC protests when player redirects but doesn't block. */
+    ATTENTION_PROTESTS: 'character.conversation.attention.protests',
+    /** NPC blocks player from redirecting (strong attention hold). */
+    ATTENTION_BLOCKS: 'character.conversation.attention.blocks',
+    /** Conversation ends naturally (goodbye). */
+    CONVERSATION_ENDS: 'character.conversation.ends',
+    /** NPC initiates conversation. */
+    CONVERSATION_INITIATES: 'character.conversation.initiates',
+};
+//# sourceMappingURL=conversation-messages.js.map

package/conversation/conversation-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-messages.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/conversation/conversation-messages.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH;;;GAGG;AACU,QAAA,oBAAoB,GAAG;IAClC,4EAA4E;IAC5E,4EAA4E;IAC5E,4EAA4E;IAE5E,qCAAqC;IACrC,gBAAgB,EAAE,yCAAyC;IAC3D,oCAAoC;IACpC,eAAe,EAAE,wCAAwC;IACzD,6DAA6D;IAC7D,oBAAoB,EAAE,6CAA6C;IACnE,+DAA+D;IAC/D,aAAa,EAAE,sCAAsC;IAErD,4EAA4E;IAC5E,mEAAmE;IACnE,4EAA4E;IAE5E,yCAAyC;IACzC,oBAAoB,EAAE,6CAA6C;IACnE,mDAAmD;IACnD,kBAAkB,EAAE,2CAA2C;IAC/D,oDAAoD;IACpD,kBAAkB,EAAE,2CAA2C;IAE/D,4EAA4E;IAC5E,uEAAuE;IACvE,4EAA4E;IAE5E,8CAA8C;IAC9C,oBAAoB,EAAE,wCAAwC;IAC9D,+CAA+C;IAC/C,oBAAoB,EAAE,wCAAwC;IAC9D,kDAAkD;IAClD,wBAAwB,EAAE,4CAA4C;IACtE,gDAAgD;IAChD,sBAAsB,EAAE,0CAA0C;IAClE,mDAAmD;IACnD,yBAAyB,EAAE,6CAA6C;IACxE,mDAAmD;IACnD,yBAAyB,EAAE,6CAA6C;IACxE,iEAAiE;IACjE,sBAAsB,EAAE,0CAA0C;IAElE,4EAA4E;IAC5E,wBAAwB;IACxB,4EAA4E;IAE5E,iEAAiE;IACjE,gBAAgB,EAAE,yCAAyC;IAC3D,4DAA4D;IAC5D,kBAAkB,EAAE,2CAA2C;IAC/D,kEAAkE;IAClE,gBAAgB,EAAE,yCAAyC;IAC3D,6CAA6C;IAC7C,iBAAiB,EAAE,6BAA6B;IAChD,kCAAkC;IAClC,sBAAsB,EAAE,kCAAkC;CAClD,CAAC"}

package/conversation/dialogue-extension.d.ts

@@ -0,0 +1,87 @@
+/**
+ * CharacterModelDialogue — DialogueExtension implementation (ADR-142)
+ *
+ * Implements the DialogueExtension interface (ADR-102) using the
+ * character model conversation system. Wires topic resolution,
+ * constraint evaluation, conversation lifecycle, and the ACL
+ * into a single handler for stdlib's ASK/TELL/SAY/TALK TO actions.
+ *
+ * Public interface: CharacterModelDialogue.
+ * Owner context: @sharpee/character / conversation
+ */
+import { CharacterModelTrait } from "../../world-model/index";
+import { DialogueExtension, DialogueResult } from './dialogue-types';
+import { ConstraintEvaluator } from './constraint-evaluator';
+import { ConversationLifecycle } from './lifecycle';
+import { ConversationData } from './builder';
+/**
+ * DialogueExtension implementation backed by the character model.
+ *
+ * Manages per-NPC topic registries, constraint evaluation, conversation
+ * lifecycle, and evidence tracking. One instance per game session.
+ */
+export declare class CharacterModelDialogue implements DialogueExtension {
+    /** Per-NPC conversation state. */
+    private readonly npcs;
+    /** Shared constraint evaluator (owns conversation records and evidence). */
+    private readonly evaluator;
+    /** Shared conversation lifecycle (owns active conversation state). */
+    private readonly lifecycle;
+    /** Get the conversation lifecycle for external access. */
+    getLifecycle(): ConversationLifecycle;
+    /** Get the constraint evaluator for external access. */
+    getEvaluator(): ConstraintEvaluator;
+    /**
+     * Register an NPC with its conversation data and character model trait.
+     *
+     * @param npcId - The NPC entity ID
+     * @param data - Compiled conversation data from ConversationBuilder
+     * @param trait - The NPC's CharacterModelTrait
+     * @param getTurn - Function that returns the current turn number
+     */
+    registerNpc(npcId: string, data: ConversationData, trait: CharacterModelTrait, getTurn: () => number): void;
+    /**
+     * Handle ASK [npc] ABOUT [text].
+     * Resolves topic, evaluates constraints, records response, builds intent.
+     */
+    handleAsk(npcId: string, aboutText: string): DialogueResult;
+    /**
+     * Handle TELL [npc] ABOUT [text].
+     * Confrontation path — the player presents information.
+     */
+    handleTell(npcId: string, aboutText: string): DialogueResult;
+    /**
+     * Handle SAY [text] or SAY [text] TO [npc].
+     * Routes free speech through topic resolution.
+     */
+    handleSay(npcId: string | undefined, spokenText: string): DialogueResult;
+    /**
+     * Handle TALK TO [npc].
+     * Initiates conversation lifecycle.
+     */
+    handleTalkTo(npcId: string): DialogueResult;
+    /**
+     * Select the best response for a topic and record it in the evaluator.
+     *
+     * Evaluates constraints across all authored responses, picks the best
+     * match, and records the interaction.
+     *
+     * @param npc - NPC conversation state
+     * @param npcId - The NPC entity ID
+     * @param topicName - The resolved topic name
+     * @param authoredResponses - Authored responses for this trigger
+     * @returns The selected candidate and its authored response, or null
+     */
+    private selectAndRecordResponse;
+    /**
+     * Apply side effects from a selected authored response: state mutations,
+     * conversation context, between-turn overrides, and leave-attempt message.
+     *
+     * @param trait - The NPC's CharacterModelTrait
+     * @param authoredResponse - The selected authored response
+     */
+    private applyResponseSideEffects;
+    /** Apply state mutations to the NPC's character model trait. */
+    private applyStateMutations;
+}
+//# sourceMappingURL=dialogue-extension.d.ts.map

package/conversation/dialogue-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue-extension.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/conversation/dialogue-extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,EAAuB,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EACL,gBAAgB,EAGjB,MAAM,WAAW,CAAC;AAyBnB;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgD;IAErE,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkD;IAE5E,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsD;IAEhF,0DAA0D;IAC1D,YAAY,IAAI,qBAAqB;IAIrC,wDAAwD;IACxD,YAAY,IAAI,mBAAmB;IAQnC;;;;;;;OAOG;IACH,WAAW,CACT,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,MAAM,MAAM,GACpB,IAAI;IAwBP;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc;IA8E3D;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc;IA4D5D;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc;IAOxE;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc;IA8B3C;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAwBhC,gEAAgE;IAChE,OAAO,CAAC,mBAAmB;CAgB5B"}