@sharpee/character 0.9.106 → 0.9.107

package/conversation/dialogue-extension.js

@@ -0,0 +1,302 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CharacterModelDialogue = void 0;
+const topic_registry_1 = require("./topic-registry");
+const constraint_evaluator_1 = require("./constraint-evaluator");
+const lifecycle_1 = require("./lifecycle");
+const acl_1 = require("./acl");
+// ---------------------------------------------------------------------------
+// CharacterModelDialogue
+// ---------------------------------------------------------------------------
+/**
+ * DialogueExtension implementation backed by the character model.
+ *
+ * Manages per-NPC topic registries, constraint evaluation, conversation
+ * lifecycle, and evidence tracking. One instance per game session.
+ */
+class CharacterModelDialogue {
+    /** Per-NPC conversation state. */
+    npcs = new Map();
+    /** Shared constraint evaluator (owns conversation records and evidence). */
+    evaluator = new constraint_evaluator_1.ConstraintEvaluator();
+    /** Shared conversation lifecycle (owns active conversation state). */
+    lifecycle = new lifecycle_1.ConversationLifecycle();
+    /** Get the conversation lifecycle for external access. */
+    getLifecycle() {
+        return this.lifecycle;
+    }
+    /** Get the constraint evaluator for external access. */
+    getEvaluator() {
+        return this.evaluator;
+    }
+    // =========================================================================
+    // NPC registration
+    // =========================================================================
+    /**
+     * 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, data, trait, getTurn) {
+        // Build topic registry from authored topics
+        const topicRegistry = new topic_registry_1.TopicRegistry();
+        for (const topicDef of data.topics) {
+            topicRegistry.define(topicDef);
+        }
+        // Register initiative triggers
+        for (const initiative of data.initiatives) {
+            this.lifecycle.registerInitiative(npcId, initiative.conditions, initiative.messageId);
+        }
+        this.npcs.set(npcId, {
+            trait,
+            topicRegistry,
+            responses: data.responses,
+            getTurn,
+        });
+    }
+    // =========================================================================
+    // DialogueExtension implementation
+    // =========================================================================
+    /**
+     * Handle ASK [npc] ABOUT [text].
+     * Resolves topic, evaluates constraints, records response, builds intent.
+     */
+    handleAsk(npcId, aboutText) {
+        const npc = this.npcs.get(npcId);
+        if (!npc)
+            return { handled: false };
+        // Ensure conversation is active
+        if (!this.lifecycle.isActive() || this.lifecycle.getActiveNpcId() !== npcId) {
+            this.lifecycle.begin(npcId);
+        }
+        // Resolve topic
+        const resolution = npc.topicRegistry.resolve(aboutText, npc.trait);
+        if (resolution.type === 'none') {
+            return {
+                handled: true,
+                messageId: 'character.conversation.unknown-topic',
+            };
+        }
+        // Get the trigger key — for related topics, use the redirect target
+        const topicName = resolution.type === 'exact'
+            ? resolution.topic.name
+            : resolution.via.name;
+        const trigger = `asked about ${topicName}`;
+        // Get authored responses for this trigger
+        const authoredResponses = npc.responses.get(trigger);
+        if (!authoredResponses || authoredResponses.length === 0) {
+            // Topic exists but no responses authored for it
+            if (resolution.type === 'related') {
+                return {
+                    handled: true,
+                    messageId: 'character.conversation.related-redirect',
+                    params: { topic: topicName, via: resolution.via.name },
+                };
+            }
+            return {
+                handled: true,
+                messageId: 'character.conversation.no-response',
+            };
+        }
+        // Select and record response, then apply side effects
+        const match = this.selectAndRecordResponse(npc, npcId, topicName, authoredResponses);
+        if (!match) {
+            return {
+                handled: true,
+                messageId: 'character.conversation.no-matching-response',
+            };
+        }
+        this.applyResponseSideEffects(npc.trait, match.authoredResponse);
+        // Build response intent through ACL
+        const context = this.lifecycle.getContext()?.contextLabel;
+        const intent = (0, acl_1.buildResponseIntent)(match.selected, topicName, npc.trait, context);
+        // Handle related topic redirect framing
+        if (resolution.type === 'related') {
+            return {
+                handled: true,
+                messageId: intent.messageId,
+                params: {
+                    ...intent.params,
+                    _redirectedFrom: resolution.via.name,
+                },
+                responseIntent: intent,
+            };
+        }
+        return {
+            handled: true,
+            messageId: intent.messageId,
+            params: intent.params,
+            responseIntent: intent,
+        };
+    }
+    /**
+     * Handle TELL [npc] ABOUT [text].
+     * Confrontation path — the player presents information.
+     */
+    handleTell(npcId, aboutText) {
+        const npc = this.npcs.get(npcId);
+        if (!npc)
+            return { handled: false };
+        // Ensure conversation is active
+        if (!this.lifecycle.isActive() || this.lifecycle.getActiveNpcId() !== npcId) {
+            this.lifecycle.begin(npcId);
+        }
+        // Resolve topic
+        const resolution = npc.topicRegistry.resolve(aboutText, npc.trait);
+        if (resolution.type === 'none') {
+            return {
+                handled: true,
+                messageId: 'character.conversation.unknown-topic',
+            };
+        }
+        const topicName = resolution.type === 'exact'
+            ? resolution.topic.name
+            : resolution.via.name;
+        const trigger = `told about ${topicName}`;
+        const turn = npc.getTurn();
+        // Record that the player presented this evidence
+        this.evaluator.recordEvidence(npcId, topicName, turn);
+        // Get authored responses for the confrontation trigger
+        const authoredResponses = npc.responses.get(trigger);
+        if (!authoredResponses || authoredResponses.length === 0) {
+            return {
+                handled: true,
+                messageId: 'character.conversation.no-response-to-evidence',
+            };
+        }
+        // Select and record response, then apply side effects
+        const match = this.selectAndRecordResponse(npc, npcId, topicName, authoredResponses);
+        if (!match) {
+            return {
+                handled: true,
+                messageId: 'character.conversation.no-matching-response',
+            };
+        }
+        this.applyResponseSideEffects(npc.trait, match.authoredResponse);
+        // Build response intent
+        const context = this.lifecycle.getContext()?.contextLabel;
+        const intent = (0, acl_1.buildResponseIntent)(match.selected, topicName, npc.trait, context);
+        return {
+            handled: true,
+            messageId: intent.messageId,
+            params: intent.params,
+            responseIntent: intent,
+        };
+    }
+    /**
+     * Handle SAY [text] or SAY [text] TO [npc].
+     * Routes free speech through topic resolution.
+     */
+    handleSay(npcId, spokenText) {
+        if (!npcId)
+            return { handled: false };
+        // Route through handleAsk — SAY is semantically similar
+        return this.handleAsk(npcId, spokenText);
+    }
+    /**
+     * Handle TALK TO [npc].
+     * Initiates conversation lifecycle.
+     */
+    handleTalkTo(npcId) {
+        const npc = this.npcs.get(npcId);
+        if (!npc)
+            return { handled: false };
+        // Begin conversation
+        this.lifecycle.begin(npcId);
+        // Check for initiative triggers
+        const triggers = this.lifecycle.getInitiativeTriggers(npcId);
+        for (const trigger of triggers) {
+            const allMet = trigger.conditions.every(cond => npc.trait.evaluate(cond));
+            if (allMet) {
+                return {
+                    handled: true,
+                    messageId: trigger.messageId,
+                };
+            }
+        }
+        // Default greeting
+        return {
+            handled: true,
+            messageId: 'character.conversation.greeting',
+        };
+    }
+    // =========================================================================
+    // Private helpers
+    // =========================================================================
+    /**
+     * 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
+     */
+    selectAndRecordResponse(npc, npcId, topicName, authoredResponses) {
+        const candidates = authoredResponses.map(r => r.candidate);
+        const selected = (0, constraint_evaluator_1.evaluateConstraints)(candidates, npc.trait);
+        if (!selected)
+            return null;
+        const authoredResponse = authoredResponses.find(r => r.candidate === selected);
+        const turn = npc.getTurn();
+        this.evaluator.recordResponse(npcId, topicName, selected.action, turn);
+        return { selected, authoredResponse };
+    }
+    /**
+     * 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
+     */
+    applyResponseSideEffects(trait, authoredResponse) {
+        if (authoredResponse.stateMutations) {
+            this.applyStateMutations(trait, authoredResponse.stateMutations);
+        }
+        if (authoredResponse.contextSettings) {
+            const ctx = authoredResponse.contextSettings;
+            this.lifecycle.setContext(ctx.label, ctx.intent, ctx.strength, ctx.decayThreshold);
+            if (authoredResponse.betweenTurnOverrides) {
+                for (const override of authoredResponse.betweenTurnOverrides) {
+                    this.lifecycle.setBetweenTurnOverride(override.turnNumber, override.messageId);
+                }
+            }
+            if (authoredResponse.onLeaveAttemptMessage) {
+                this.lifecycle.setOnLeaveAttemptMessage(authoredResponse.onLeaveAttemptMessage);
+            }
+        }
+    }
+    /** Apply state mutations to the NPC's character model trait. */
+    applyStateMutations(trait, mutations) {
+        if (mutations.threat !== undefined) {
+            trait.adjustThreat(mutations.threat);
+        }
+        if (mutations.mood !== undefined) {
+            trait.setMood(mutations.mood);
+        }
+        if (mutations.disposition) {
+            for (const [entityId, word] of Object.entries(mutations.disposition)) {
+                trait.setDisposition(entityId, word);
+            }
+        }
+    }
+}
+exports.CharacterModelDialogue = CharacterModelDialogue;
+//# sourceMappingURL=dialogue-extension.js.map

package/conversation/dialogue-extension.js.map

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

package/conversation/dialogue-types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Dialogue extension types (ADR-102 / ADR-142)
+ *
+ * Defines the DialogueExtension interface and DialogueResult type
+ * from ADR-102. The character model conversation system (ADR-142)
+ * implements this interface via CharacterModelDialogue.
+ *
+ * Public interface: DialogueExtension, DialogueResult.
+ * Owner context: @sharpee/character / conversation
+ */
+import { ResponseIntent } from './response-types';
+/**
+ * The result of a dialogue extension handling a conversation action.
+ * Contains everything the action needs to produce output.
+ */
+export interface DialogueResult {
+    /** Whether the extension handled the input. */
+    handled: boolean;
+    /** Message ID for the action to emit via the reporting phase. */
+    messageId?: string;
+    /** Parameters for the language layer message. */
+    params?: Record<string, unknown>;
+    /** The structured response intent (for systems that need it). */
+    responseIntent?: ResponseIntent;
+}
+/**
+ * Interface for dialogue extensions (ADR-102).
+ *
+ * Stdlib conversation actions (ASK, TELL, SAY, TALK TO) delegate
+ * to a registered DialogueExtension to produce conversation results.
+ * The extension resolves free text to topics, evaluates constraints,
+ * and returns structured results.
+ */
+export interface DialogueExtension {
+    /**
+     * Handle ASK [npc] ABOUT [text].
+     * Extension resolves text to topic and selects a response.
+     *
+     * @param npcId - The NPC entity ID
+     * @param aboutText - The raw text after "about"
+     * @returns Dialogue result
+     */
+    handleAsk(npcId: string, aboutText: string): DialogueResult;
+    /**
+     * Handle TELL [npc] ABOUT [text].
+     * Confrontation path — the player presents information.
+     *
+     * @param npcId - The NPC entity ID
+     * @param aboutText - The raw text after "about"
+     * @returns Dialogue result
+     */
+    handleTell(npcId: string, aboutText: string): DialogueResult;
+    /**
+     * Handle SAY [text] or SAY [text] TO [npc].
+     * Free speech routed through topic resolution.
+     *
+     * @param npcId - The NPC entity ID, or undefined for untargeted speech
+     * @param spokenText - The raw text
+     * @returns Dialogue result
+     */
+    handleSay(npcId: string | undefined, spokenText: string): DialogueResult;
+    /**
+     * Handle TALK TO [npc].
+     * Initiates conversation lifecycle and fires initiative triggers.
+     *
+     * @param npcId - The NPC entity ID
+     * @returns Dialogue result
+     */
+    handleTalkTo(npcId: string): DialogueResult;
+}
+//# sourceMappingURL=dialogue-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue-types.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/conversation/dialogue-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IAEjB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,iEAAiE;IACjE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC;IAE5D;;;;;;;OAOG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC;IAE7D;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAAC;IAEzE;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;CAC7C"}

package/conversation/dialogue-types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Dialogue extension types (ADR-102 / ADR-142)
+ *
+ * Defines the DialogueExtension interface and DialogueResult type
+ * from ADR-102. The character model conversation system (ADR-142)
+ * implements this interface via CharacterModelDialogue.
+ *
+ * Public interface: DialogueExtension, DialogueResult.
+ * Owner context: @sharpee/character / conversation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dialogue-types.js.map

package/conversation/dialogue-types.js.map

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

package/conversation/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Conversation system exports (ADR-142)
+ *
+ * Topic registry, constraint evaluation, and response types
+ * for the character model conversation system.
+ *
+ * Public interface: All re-exported types and classes.
+ * Owner context: @sharpee/character / conversation
+ */
+export { type ResponseAction, type ResponseCandidate, type ResponseIntent, type ConversationRecord, type ConversationEntry, type EvidenceRecord, type EvidenceEntry, createConversationRecord, createEvidenceRecord, } from './response-types';
+export { type TopicDef, type TopicResolution, TopicRegistry, } from './topic-registry';
+export { type Contradiction, type ConstraintEvaluatorState, evaluateConstraints, ConstraintEvaluator, } from './constraint-evaluator';
+export { type ConversationIntent, type ConversationStrength, type RedirectResult, type ConversationContext, type ContinuationEntry, type InitiativeTrigger, type ConversationLifecycleState, DEFAULT_DECAY_THRESHOLDS, BETWEEN_TURN_DEFAULTS, ConversationLifecycle, } from './lifecycle';
+export { buildResponseIntent, selectMoodVariant, applyCognitiveColoring, } from './acl';
+export { type DialogueExtension, type DialogueResult, } from './dialogue-types';
+export { type ConversationData, type AuthoredResponse, type ResponseContextSettings, type ResponseStateMutation, type BetweenTurnOverride, type OffscreenScene, type WitnessedScene, type DialogueLine, createConversationData, ConversationBuilder, ResponseChainBuilder, } from './builder';
+export { CharacterModelDialogue, } from './dialogue-extension';
+export { ConversationMessages, type ConversationMessageId, } from './conversation-messages';
+//# sourceMappingURL=index.d.ts.map

package/conversation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/conversation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,oBAAoB,EACpB,KAAK,qBAAqB,GAC3B,MAAM,yBAAyB,CAAC"}

package/conversation/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Conversation system exports (ADR-142)
+ *
+ * Topic registry, constraint evaluation, and response types
+ * for the character model conversation system.
+ *
+ * Public interface: All re-exported types and classes.
+ * Owner context: @sharpee/character / conversation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationMessages = exports.CharacterModelDialogue = exports.ResponseChainBuilder = exports.ConversationBuilder = exports.createConversationData = exports.applyCognitiveColoring = exports.selectMoodVariant = exports.buildResponseIntent = exports.ConversationLifecycle = exports.BETWEEN_TURN_DEFAULTS = exports.DEFAULT_DECAY_THRESHOLDS = exports.ConstraintEvaluator = exports.evaluateConstraints = exports.TopicRegistry = exports.createEvidenceRecord = exports.createConversationRecord = void 0;
+var response_types_1 = require("./response-types");
+Object.defineProperty(exports, "createConversationRecord", { enumerable: true, get: function () { return response_types_1.createConversationRecord; } });
+Object.defineProperty(exports, "createEvidenceRecord", { enumerable: true, get: function () { return response_types_1.createEvidenceRecord; } });
+var topic_registry_1 = require("./topic-registry");
+Object.defineProperty(exports, "TopicRegistry", { enumerable: true, get: function () { return topic_registry_1.TopicRegistry; } });
+var constraint_evaluator_1 = require("./constraint-evaluator");
+Object.defineProperty(exports, "evaluateConstraints", { enumerable: true, get: function () { return constraint_evaluator_1.evaluateConstraints; } });
+Object.defineProperty(exports, "ConstraintEvaluator", { enumerable: true, get: function () { return constraint_evaluator_1.ConstraintEvaluator; } });
+var lifecycle_1 = require("./lifecycle");
+Object.defineProperty(exports, "DEFAULT_DECAY_THRESHOLDS", { enumerable: true, get: function () { return lifecycle_1.DEFAULT_DECAY_THRESHOLDS; } });
+Object.defineProperty(exports, "BETWEEN_TURN_DEFAULTS", { enumerable: true, get: function () { return lifecycle_1.BETWEEN_TURN_DEFAULTS; } });
+Object.defineProperty(exports, "ConversationLifecycle", { enumerable: true, get: function () { return lifecycle_1.ConversationLifecycle; } });
+var acl_1 = require("./acl");
+Object.defineProperty(exports, "buildResponseIntent", { enumerable: true, get: function () { return acl_1.buildResponseIntent; } });
+Object.defineProperty(exports, "selectMoodVariant", { enumerable: true, get: function () { return acl_1.selectMoodVariant; } });
+Object.defineProperty(exports, "applyCognitiveColoring", { enumerable: true, get: function () { return acl_1.applyCognitiveColoring; } });
+var builder_1 = require("./builder");
+Object.defineProperty(exports, "createConversationData", { enumerable: true, get: function () { return builder_1.createConversationData; } });
+Object.defineProperty(exports, "ConversationBuilder", { enumerable: true, get: function () { return builder_1.ConversationBuilder; } });
+Object.defineProperty(exports, "ResponseChainBuilder", { enumerable: true, get: function () { return builder_1.ResponseChainBuilder; } });
+var dialogue_extension_1 = require("./dialogue-extension");
+Object.defineProperty(exports, "CharacterModelDialogue", { enumerable: true, get: function () { return dialogue_extension_1.CharacterModelDialogue; } });
+var conversation_messages_1 = require("./conversation-messages");
+Object.defineProperty(exports, "ConversationMessages", { enumerable: true, get: function () { return conversation_messages_1.ConversationMessages; } });
+//# sourceMappingURL=index.js.map

package/conversation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/conversation/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,mDAU0B;AAFxB,0HAAA,wBAAwB,OAAA;AACxB,sHAAA,oBAAoB,OAAA;AAGtB,mDAI0B;AADxB,+GAAA,aAAa,OAAA;AAGf,+DAKgC;AAF9B,2HAAA,mBAAmB,OAAA;AACnB,2HAAA,mBAAmB,OAAA;AAGrB,yCAWqB;AAHnB,qHAAA,wBAAwB,OAAA;AACxB,kHAAA,qBAAqB,OAAA;AACrB,kHAAA,qBAAqB,OAAA;AAGvB,6BAIe;AAHb,0GAAA,mBAAmB,OAAA;AACnB,wGAAA,iBAAiB,OAAA;AACjB,6GAAA,sBAAsB,OAAA;AAQxB,qCAYmB;AAHjB,iHAAA,sBAAsB,OAAA;AACtB,8GAAA,mBAAmB,OAAA;AACnB,+GAAA,oBAAoB,OAAA;AAGtB,2DAE8B;AAD5B,4HAAA,sBAAsB,OAAA;AAGxB,iEAGiC;AAF/B,6HAAA,oBAAoB,OAAA"}