dsh-tavern-bundle 0.1.0

package/lib/core/context-assembler.js

@@ -0,0 +1,185 @@
+/**
+ * ContextAssembler —— 世界书 + 记忆上下文组装（阶段 4 + 5.2）。
+ *
+ * 每次 summon / followup 前调用：按用户消息检索角色世界书的关键词条目与
+ * 独立记忆（MemoryService.recall），稳定排序（Lore 优先，Memory 次之），
+ * 按条目数与字符预算截断，生成注入的 ContentBlock[] 与确定性 fingerprint
+ * （审计用）。记忆块格式遵循产品文档：
+ *   <context source="tavern:memory">\n- fact\n- fact\n</context>
+ * 位于 Lore 块之后、用户消息之前。
+ *
+ * 注意：constant（始终激活）世界书条目在导入时已并入 persona，不参与检索；
+ * 本模块只处理**非 constant 的触发条目**（社区卡的世界书主体内容）。
+ */
+import { createHash } from 'node:crypto';
+/** 默认注入预算：最多 5 条 / 2000 字符。 */
+export const DEFAULT_MAX_LORE_ENTRIES = 5;
+export const DEFAULT_MAX_LORE_CHARS = 2000;
+/** 记忆注入预算：最多 3 条 / 1000 字符。 */
+export const DEFAULT_MAX_MEMORY_ENTRIES = 3;
+export const DEFAULT_MAX_MEMORY_CHARS = 1000;
+/** 单个关键词是否命中（contains=子串；word=完整词 \b 边界）。 */
+export function keyMatches(entry, key, message) {
+    const haystack = entry.caseSensitive ? message : message.toLocaleLowerCase();
+    const needle = entry.caseSensitive ? key : key.toLocaleLowerCase();
+    if (needle === '')
+        return false;
+    if (entry.matchMode === 'word') {
+        const escaped = needle.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
+        return new RegExp(`(^|[^\\p{L}\\p{N}_])${escaped}(?=$|[^\\p{L}\\p{N}_])`, 'u').test(haystack);
+    }
+    return haystack.includes(needle);
+}
+/** 检索 + 排序 + 截断的纯函数（单元测试核心）。 */
+export function selectLoreEntries(lorebook, userMessage, maxEntries, maxChars) {
+    if (lorebook === undefined || userMessage.trim() === '') {
+        return { entries: [], matched: [], requested: 0, kept: 0, keptChars: 0 };
+    }
+    const hits = [];
+    for (const entry of lorebook.entries) {
+        // constant（始终激活）条目已并入 persona，不参与检索注入，避免重复。
+        if (!entry.enabled || entry.constant)
+            continue;
+        for (const key of entry.keys) {
+            if (keyMatches(entry, key, userMessage)) {
+                hits.push({ entry, key });
+                break;
+            }
+        }
+    }
+    // 稳定排序：priority DESC，id ASC
+    const sorted = hits
+        .map(item => item.entry)
+        .sort((a, b) => (b.priority - a.priority) || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    // 截断：条目数与字符预算
+    const kept = [];
+    let keptChars = 0;
+    for (const entry of sorted) {
+        if (kept.length >= maxEntries)
+            break;
+        if (keptChars + entry.content.length > maxChars && kept.length > 0)
+            break;
+        kept.push(entry);
+        keptChars += entry.content.length;
+    }
+    return {
+        entries: kept,
+        matched: hits.map(item => ({ entryId: item.entry.id, key: item.key })),
+        requested: sorted.length,
+        kept: kept.length,
+        keptChars,
+    };
+}
+/** 命中条目 → 注入的 ContentBlock[]（每条一个块，带关键词标注）。 */
+export function buildLoreContentBlocks(entries) {
+    return entries.map(entry => ({
+        type: 'text',
+        text: `【世界书 · ${entry.keys.join(' / ')}】\n${entry.content}`,
+    }));
+}
+/** 记忆字符预算截断（salience 已在 recall 内排序；首条超长仍保留）。 */
+export function truncateMemoriesByChars(entries, maxChars) {
+    const kept = [];
+    let keptChars = 0;
+    for (const memory of entries) {
+        if (kept.length > 0 && keptChars + memory.fact.length > maxChars)
+            break;
+        kept.push(memory);
+        keptChars += memory.fact.length;
+    }
+    return kept;
+}
+/** 记忆 → 注入块（单块，格式见文件头文档）。 */
+export function buildMemoryContextBlock(entries) {
+    if (entries.length === 0)
+        return undefined;
+    const lines = entries.map(memory => `- ${memory.fact}`).join('\n');
+    return { type: 'text', text: `<context source="tavern:memory">\n${lines}\n</context>` };
+}
+/** 确定性指纹：sha256(characterId|message|entryIds|contents)。 */
+export function loreFingerprint(characterId, userMessage, entries) {
+    const material = [
+        characterId,
+        userMessage,
+        ...entries.map(entry => `${entry.id}:${entry.content}`),
+    ].join('|');
+    return createHash('sha256').update(material, 'utf8').digest('hex').slice(0, 16);
+}
+/** 确定性指纹：sha256(characterId|message|memoryIds|facts)。 */
+export function memoryFingerprint(characterId, userMessage, entries) {
+    const material = [
+        characterId,
+        userMessage,
+        ...entries.map(memory => `${memory.id}:${memory.fact}`),
+    ].join('|');
+    return createHash('sha256').update(material, 'utf8').digest('hex').slice(0, 16);
+}
+/** 带存储的组装器：characterId → 角色 → lorebookIds[0] → 世界书 → 记忆 → 注入。 */
+export class ContextAssembler {
+    #characters;
+    #lorebooks;
+    #memories;
+    constructor(characters, lorebooks, memories) {
+        this.#characters = characters;
+        this.#lorebooks = lorebooks;
+        this.#memories = memories;
+    }
+    /** 角色的世界书（未绑定或不存在返回 undefined）。 */
+    lorebookOf(characterId) {
+        const character = this.#characters.get(characterId);
+        const lorebookId = character?.lorebookIds[0];
+        if (lorebookId === undefined)
+            return undefined;
+        return this.#lorebooks.get(lorebookId);
+    }
+    /**
+     * 组装一次投递的世界书 + 记忆上下文。空消息 / 无世界书 / 无命中均返回
+     * 空结果（不抛异常）；fingerprint 在空结果时也确定性可算。
+     * 顺序：Lore 块在前，Memory 块在后（均位于用户消息之前）。
+     */
+    async assemble(params) {
+        const maxEntries = params.maxLoreEntries ?? DEFAULT_MAX_LORE_ENTRIES;
+        const maxChars = params.maxLoreChars ?? DEFAULT_MAX_LORE_CHARS;
+        const maxMemoryEntries = params.maxMemoryEntries ?? DEFAULT_MAX_MEMORY_ENTRIES;
+        const maxMemoryChars = params.maxMemoryChars ?? DEFAULT_MAX_MEMORY_CHARS;
+        const lorebook = this.lorebookOf(params.characterId);
+        const selection = selectLoreEntries(lorebook, params.userMessage, maxEntries, maxChars);
+        // 阶段 3 M6：统一混合检索——将本轮用户消息作为 query，相关性 +
+        // salience + recency + 类别配额；pending 候选永远不在此处被召回。
+        const recalled = await this.#memories.retrieve({
+            characterId: params.characterId,
+            query: params.userMessage,
+            ...(params.sceneId === undefined ? {} : { sceneId: params.sceneId }),
+            limit: maxMemoryEntries,
+            updateAccess: false,
+        });
+        const keptMemory = truncateMemoriesByChars(recalled.map(hit => hit.memory), maxMemoryChars);
+        const memoryBlock = buildMemoryContextBlock(keptMemory);
+        const contentBlocks = [
+            ...buildLoreContentBlocks(selection.entries),
+            ...(memoryBlock === undefined ? [] : [memoryBlock]),
+        ];
+        const fingerprint = [
+            loreFingerprint(params.characterId, params.userMessage, selection.entries),
+            memoryFingerprint(params.characterId, params.userMessage, keptMemory),
+        ].join(':');
+        return {
+            injectedLore: selection.entries,
+            injectedMemory: keptMemory,
+            matched: selection.matched,
+            contentBlocks,
+            fingerprint,
+            truncated: {
+                requested: selection.requested,
+                kept: selection.kept,
+                keptChars: selection.keptChars,
+            },
+            memoryTruncated: {
+                requested: recalled.length,
+                kept: keptMemory.length,
+                keptChars: keptMemory.reduce((sum, memory) => sum + memory.fact.length, 0),
+            },
+        };
+    }
+}
+//# sourceMappingURL=context-assembler.js.map

package/lib/core/context-assembler.js.map

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

package/lib/core/conversation-repository.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ConversationRepository —— 普通聊天的领域事实源（阶段 1，ADR-003）。
+ *
+ * Conversation / ConversationMessage 是 Tavern 自己存储的消息树：
+ * parentMessageId 原生支持编辑/重新生成/swipe/分支；DSH 会话只作呈现通道。
+ * 乐观并发：updateActiveLeaf 用 expectedActiveLeafId 做 CAS（ADR-003 §5）。
+ */
+import type { KvTable } from '@deepseek-ai/dsh-storage-domain';
+import type { Conversation, ConversationMessage } from '../domain/schemas.js';
+export interface ConversationRepository {
+    create(conversation: Omit<Conversation, 'createdAt' | 'updatedAt'>): Promise<Conversation>;
+    get(id: string): Promise<Conversation | null>;
+    update(id: string, updates: Partial<Conversation>): Promise<Conversation>;
+    listByUser(userId: string): Promise<Conversation[]>;
+    updateByCharacter(characterId: string, updates: Partial<Conversation>): Promise<number>;
+    addMessage(message: Omit<ConversationMessage, 'createdAt'> & {
+        createdAt?: string;
+    }): Promise<ConversationMessage>;
+    getMessage(id: string): Promise<ConversationMessage | null>;
+    updateMessage(id: string, updates: Partial<ConversationMessage>): Promise<ConversationMessage>;
+    getMessageTree(conversationId: string): Promise<ConversationMessage[]>;
+    getActiveLeaf(conversationId: string): Promise<ConversationMessage | null>;
+    updateActiveLeaf(conversationId: string, messageId: string, expectedActiveLeafId?: string): Promise<void>;
+}
+export declare class KvTableConversationRepository implements ConversationRepository {
+    #private;
+    constructor(conversationTable: KvTable<string, Conversation>, messageTable: KvTable<string, ConversationMessage>);
+    create(input: Omit<Conversation, 'createdAt' | 'updatedAt'>): Promise<Conversation>;
+    get(id: string): Promise<Conversation | null>;
+    update(id: string, updates: Partial<Conversation>): Promise<Conversation>;
+    listByUser(userId: string): Promise<Conversation[]>;
+    updateByCharacter(characterId: string, updates: Partial<Conversation>): Promise<number>;
+    addMessage(input: Omit<ConversationMessage, 'createdAt'> & {
+        createdAt?: string;
+    }): Promise<ConversationMessage>;
+    getMessage(id: string): Promise<ConversationMessage | null>;
+    getMessageTree(conversationId: string): Promise<ConversationMessage[]>;
+    updateMessage(id: string, updates: Partial<ConversationMessage>): Promise<ConversationMessage>;
+    getActiveLeaf(conversationId: string): Promise<ConversationMessage | null>;
+    updateActiveLeaf(conversationId: string, messageId: string, expectedActiveLeafId?: string): Promise<void>;
+}
+//# sourceMappingURL=conversation-repository.d.ts.map

package/lib/core/conversation-repository.d.ts.map

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

package/lib/core/conversation-repository.js

@@ -0,0 +1,94 @@
+/**
+ * ConversationRepository —— 普通聊天的领域事实源（阶段 1，ADR-003）。
+ *
+ * Conversation / ConversationMessage 是 Tavern 自己存储的消息树：
+ * parentMessageId 原生支持编辑/重新生成/swipe/分支；DSH 会话只作呈现通道。
+ * 乐观并发：updateActiveLeaf 用 expectedActiveLeafId 做 CAS（ADR-003 §5）。
+ */
+export class KvTableConversationRepository {
+    #conversations;
+    #messages;
+    constructor(conversationTable, messageTable) {
+        this.#conversations = conversationTable;
+        this.#messages = messageTable;
+    }
+    async create(input) {
+        const now = new Date().toISOString();
+        const conversation = { ...input, createdAt: now, updatedAt: now };
+        await this.#conversations.put(input.id, conversation);
+        return conversation;
+    }
+    get(id) {
+        return Promise.resolve(this.#conversations.get(id) ?? null);
+    }
+    async update(id, updates) {
+        const current = this.#conversations.get(id);
+        if (current === undefined)
+            throw new Error(`[Tavern] Conversation 不存在：${id}`);
+        const next = { ...current, ...updates, updatedAt: new Date().toISOString() };
+        await this.#conversations.put(id, next);
+        return next;
+    }
+    async listByUser(userId) {
+        const result = [];
+        for (const [, conversation] of this.#conversations.entries()) {
+            if (conversation.ownerUserId === userId)
+                result.push(conversation);
+        }
+        // 更新时间倒序；同时间按 id 倒序（确定性 tie-break，便于测试与稳定展示）。
+        result.sort((a, b) => (a.updatedAt > b.updatedAt ? -1 : a.updatedAt < b.updatedAt ? 1
+            : (a.id > b.id ? -1 : a.id < b.id ? 1 : 0)));
+        return result;
+    }
+    async updateByCharacter(characterId, updates) {
+        let updated = 0;
+        for (const [id, conversation] of this.#conversations.entries()) {
+            if (conversation.characterId !== characterId)
+                continue;
+            await this.#conversations.put(id, { ...conversation, ...updates, updatedAt: new Date().toISOString() });
+            updated += 1;
+        }
+        return updated;
+    }
+    async addMessage(input) {
+        const message = { ...input, createdAt: input.createdAt ?? new Date().toISOString() };
+        await this.#messages.put(input.id, message);
+        return message;
+    }
+    getMessage(id) {
+        return Promise.resolve(this.#messages.get(id) ?? null);
+    }
+    async getMessageTree(conversationId) {
+        const result = [];
+        for (const [, message] of this.#messages.entries()) {
+            if (message.conversationId === conversationId)
+                result.push(message);
+        }
+        result.sort((a, b) => (a.createdAt < b.createdAt ? -1 : a.createdAt > b.createdAt ? 1 : 0));
+        return result;
+    }
+    async updateMessage(id, updates) {
+        const current = this.#messages.get(id);
+        if (current === undefined)
+            throw new Error(`[Tavern] 消息不存在：${id}`);
+        const next = { ...current, ...updates };
+        await this.#messages.put(id, next);
+        return next;
+    }
+    async getActiveLeaf(conversationId) {
+        const conversation = this.#conversations.get(conversationId);
+        if (conversation === undefined || conversation.activeLeafMessageId === undefined)
+            return null;
+        return this.getMessage(conversation.activeLeafMessageId);
+    }
+    async updateActiveLeaf(conversationId, messageId, expectedActiveLeafId) {
+        // KvTable.update 在 domain 写链上原子执行：CAS 校验 + 更新。
+        await this.#conversations.update(conversationId, current => {
+            if (expectedActiveLeafId !== undefined && current.activeLeafMessageId !== expectedActiveLeafId) {
+                throw new Error(`[Tavern] active leaf 已被其他分支更新（期望 ${expectedActiveLeafId}，实际 ${current.activeLeafMessageId ?? '<无>'}）`);
+            }
+            return { ...current, activeLeafMessageId: messageId, updatedAt: new Date().toISOString() };
+        });
+    }
+}
+//# sourceMappingURL=conversation-repository.js.map

package/lib/core/conversation-repository.js.map

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

package/lib/core/group-chat-execution-service.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Import from application/group-chat/group-chat-execution-service.js. */
+export * from '../application/group-chat/group-chat-execution-service.js';
+//# sourceMappingURL=group-chat-execution-service.d.ts.map

package/lib/core/group-chat-execution-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-chat-execution-service.d.ts","sourceRoot":"","sources":["../../src/core/group-chat-execution-service.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,cAAc,2DAA2D,CAAA"}

package/lib/core/group-chat-execution-service.js

@@ -0,0 +1,3 @@
+/** @deprecated Import from application/group-chat/group-chat-execution-service.js. */
+export * from '../application/group-chat/group-chat-execution-service.js';
+//# sourceMappingURL=group-chat-execution-service.js.map

package/lib/core/group-chat-execution-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-chat-execution-service.js","sourceRoot":"","sources":["../../src/core/group-chat-execution-service.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,cAAc,2DAA2D,CAAA"}

package/lib/core/group-chat-orchestrator.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Import from application/group-chat/group-chat-orchestrator.js. */
+export * from '../application/group-chat/group-chat-orchestrator.js';
+//# sourceMappingURL=group-chat-orchestrator.d.ts.map

package/lib/core/group-chat-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-chat-orchestrator.d.ts","sourceRoot":"","sources":["../../src/core/group-chat-orchestrator.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,cAAc,sDAAsD,CAAA"}

package/lib/core/group-chat-orchestrator.js

@@ -0,0 +1,3 @@
+/** @deprecated Import from application/group-chat/group-chat-orchestrator.js. */
+export * from '../application/group-chat/group-chat-orchestrator.js';
+//# sourceMappingURL=group-chat-orchestrator.js.map

package/lib/core/group-chat-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-chat-orchestrator.js","sourceRoot":"","sources":["../../src/core/group-chat-orchestrator.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,cAAc,sDAAsD,CAAA"}

package/lib/core/memory-retriever.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Import from application/memory/memory-retriever.js. */
+export * from '../application/memory/memory-retriever.js';
+//# sourceMappingURL=memory-retriever.d.ts.map

package/lib/core/memory-retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-retriever.d.ts","sourceRoot":"","sources":["../../src/core/memory-retriever.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,cAAc,2CAA2C,CAAA"}

package/lib/core/memory-retriever.js

@@ -0,0 +1,3 @@
+/** @deprecated Import from application/memory/memory-retriever.js. */
+export * from '../application/memory/memory-retriever.js';
+//# sourceMappingURL=memory-retriever.js.map

package/lib/core/memory-retriever.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-retriever.js","sourceRoot":"","sources":["../../src/core/memory-retriever.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,cAAc,2CAA2C,CAAA"}

package/lib/core/memory-service.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Import from application/memory/memory-service.js. */
+export * from '../application/memory/memory-service.js';
+//# sourceMappingURL=memory-service.d.ts.map

package/lib/core/memory-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-service.d.ts","sourceRoot":"","sources":["../../src/core/memory-service.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,cAAc,yCAAyC,CAAA"}

package/lib/core/memory-service.js

@@ -0,0 +1,3 @@
+/** @deprecated Import from application/memory/memory-service.js. */
+export * from '../application/memory/memory-service.js';
+//# sourceMappingURL=memory-service.js.map

package/lib/core/memory-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-service.js","sourceRoot":"","sources":["../../src/core/memory-service.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,cAAc,yCAAyC,CAAA"}

package/lib/core/personality-candidate-service.d.ts

@@ -0,0 +1,46 @@
+import type { KvTable } from '@deepseek-ai/dsh-storage-domain';
+import type { AuditService } from './audit-service.js';
+import type { CompanionProfile, PersonalityCandidate } from '../domain/schemas.js';
+import { KvTableConversationRepository } from './conversation-repository.js';
+export interface CreatePersonalityCandidateParams {
+    ownerUserId: string;
+    companionProfileId: string;
+    conversationId: string;
+    traitName: string;
+    description: string;
+    strength: number;
+    confidence: number;
+    sourceMessageIds: string[];
+    extractionVersion: string;
+}
+export declare class PersonalityCandidateService {
+    #private;
+    constructor(candidates: KvTable<string, PersonalityCandidate>, profiles: KvTable<string, CompanionProfile>, conversations: KvTableConversationRepository, audit: AuditService);
+    create(p: CreatePersonalityCandidateParams): Promise<PersonalityCandidate>;
+    listForUser(owner: string, profileId?: string): {
+        id: string;
+        ownerUserId: string;
+        companionProfileId: string;
+        conversationId: string;
+        traitName: string;
+        description: string;
+        strength: number;
+        confidence: number;
+        sourceMessageIds: string[];
+        extractionVersion: string;
+        status: "accepted" | "superseded" | "pending" | "rejected" | "evidence-invalid";
+        createdAt: string;
+        updatedAt: string;
+        reviewerUserId?: string | undefined;
+        reviewedAt?: string | undefined;
+        invalidationReason?: string | undefined;
+        invalidatedAt?: string | undefined;
+        supersedes?: string | undefined;
+    }[];
+    review(owner: string, id: string, decision: 'accept' | 'reject', edits?: {
+        traitName?: string;
+        description?: string;
+        strength?: number;
+    }): Promise<PersonalityCandidate>;
+}
+//# sourceMappingURL=personality-candidate-service.d.ts.map

package/lib/core/personality-candidate-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personality-candidate-service.d.ts","sourceRoot":"","sources":["../../src/core/personality-candidate-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAoB,MAAM,sBAAsB,CAAA;AACpG,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAA;AAE5E,MAAM,WAAW,gCAAgC;IAAG,WAAW,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE;AAClQ,qBAAa,2BAA2B;;gBAK1B,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,aAAa,EAAE,6BAA6B,EAAE,KAAK,EAAE,YAAY;IAIvK,MAAM,CAAC,CAAC,EAAE,gCAAgC,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAahF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;IACvC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAC,QAAQ,EAAE,KAAK,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAOjL"}

package/lib/core/personality-candidate-service.js

@@ -0,0 +1,65 @@
+import { randomUUID } from 'node:crypto';
+import { KvTableConversationRepository } from './conversation-repository.js';
+export class PersonalityCandidateService {
+    #candidates;
+    #profiles;
+    #conversations;
+    #audit;
+    constructor(candidates, profiles, conversations, audit) {
+        this.#candidates = candidates;
+        this.#profiles = profiles;
+        this.#conversations = conversations;
+        this.#audit = audit;
+    }
+    #owned(owner, id) { const c = this.#candidates.get(id); if (!c || c.ownerUserId !== owner)
+        throw new Error('[Tavern] 性格候选不存在或无权访问'); return c; }
+    async create(p) {
+        const profile = this.#profiles.get(p.companionProfileId);
+        if (!profile || profile.ownerUserId !== p.ownerUserId)
+            throw new Error('[Tavern] Companion 不存在或无权访问');
+        const conversation = await this.#conversations.get(p.conversationId);
+        if (!conversation || conversation.ownerUserId !== p.ownerUserId)
+            throw new Error('[Tavern] Conversation 不存在或无权访问');
+        if (conversation.characterId !== profile.characterId)
+            throw new Error('[Tavern] 性格证据与 Companion 角色不匹配');
+        const ids = [...new Set(p.sourceMessageIds)];
+        if (!ids.length)
+            throw new Error('[Tavern] 性格候选至少需要一条证据');
+        const evidence = await Promise.all(ids.map(id => this.#conversations.getMessage(id)));
+        if (evidence.some(m => !m || m.conversationId !== p.conversationId) || !evidence.some(m => m?.role === 'user'))
+            throw new Error('[Tavern] 性格候选必须包含有效用户证据');
+        const evidenceKey = ids.slice().sort().join(',');
+        const duplicate = [...this.#candidates.entries()].map(([, candidate]) => candidate).find(candidate => candidate.ownerUserId === p.ownerUserId && candidate.companionProfileId === p.companionProfileId && candidate.conversationId === p.conversationId && candidate.traitName === p.traitName.trim() && candidate.description === p.description.trim() && candidate.sourceMessageIds.slice().sort().join(',') === evidenceKey);
+        if (duplicate)
+            return duplicate;
+        const now = new Date().toISOString();
+        const candidate = { id: randomUUID(), ownerUserId: p.ownerUserId, companionProfileId: p.companionProfileId, conversationId: p.conversationId, traitName: p.traitName.trim(), description: p.description.trim(), strength: p.strength, confidence: p.confidence, sourceMessageIds: ids, extractionVersion: p.extractionVersion, status: 'pending', createdAt: now, updatedAt: now };
+        if (!candidate.traitName || !candidate.description)
+            throw new Error('[Tavern] 性格候选内容不能为空');
+        await this.#candidates.put(candidate.id, candidate);
+        await this.#audit.log({ entityType: 'personality_candidate', entityId: candidate.id, action: 'create', after: candidate, source: 'system', actorId: p.ownerUserId });
+        return candidate;
+    }
+    listForUser(owner, profileId) { return [...this.#candidates.entries()].map(([, c]) => c).filter(c => c.ownerUserId === owner && (profileId === undefined || c.companionProfileId === profileId)); }
+    async review(owner, id, decision, edits = {}) {
+        const current = this.#owned(owner, id);
+        if (current.status !== 'pending')
+            return current;
+        const now = new Date().toISOString();
+        const next = { ...current, ...(edits.traitName === undefined ? {} : { traitName: edits.traitName.trim() }), ...(edits.description === undefined ? {} : { description: edits.description.trim() }), ...(edits.strength === undefined ? {} : { strength: edits.strength }), status: decision === 'accept' ? 'accepted' : 'rejected', reviewerUserId: owner, reviewedAt: now, updatedAt: now };
+        await this.#candidates.put(id, next);
+        if (decision === 'accept') {
+            const profile = this.#profiles.get(current.companionProfileId);
+            const oldTraits = profile.personalityTraits ?? [];
+            const trait = { id: `trait:${id}`, name: next.traitName, description: next.description, strength: next.strength, confidence: next.confidence, source: 'user-confirmed', status: 'active' };
+            const version = (profile.personalityVersion ?? 0) + 1;
+            const traits = oldTraits.map(t => t.name === trait.name ? { ...t, status: 'superseded' } : t);
+            const updated = { ...profile, personalityTraits: [...traits, trait], personalitySummary: [...traits, trait].filter(t => t.status === 'active').map(t => `${t.name}: ${t.description}`).join('；'), personalityVersion: version, personalitySourceConversationIds: [...new Set([...(profile.personalitySourceConversationIds ?? []), current.conversationId])], personalitySourceMessageIds: [...new Set([...(profile.personalitySourceMessageIds ?? []), ...current.sourceMessageIds])], personalitySummarizedAt: now, personalityConfirmedAt: now, updatedAt: now };
+            await this.#profiles.put(profile.id, updated);
+            await this.#audit.log({ entityType: 'companion_profile', entityId: profile.id, action: 'update', before: profile, after: updated, source: 'user', actorId: owner });
+        }
+        await this.#audit.log({ entityType: 'personality_candidate', entityId: id, action: 'update', before: current, after: next, source: 'user', actorId: owner });
+        return next;
+    }
+}
+//# sourceMappingURL=personality-candidate-service.js.map

package/lib/core/personality-candidate-service.js.map

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

package/lib/core/prompt-assembler.d.ts

@@ -0,0 +1,43 @@
+/**
+ * PromptAssembler —— 普通聊天的上下文组装（阶段 1，ADR-002/003）。
+ *
+ * 组装顺序（方案 §23.3）：
+ *   角色 persona/scenario → 世界书命中 + 已确认记忆（复用 ContextAssembler）→
+ *   消息树历史 → 用户本轮消息 → 生成 system + messages + contextSources。
+ *
+ * 骨架阶段：消息树历史取全量（按 createdAt 排序）；分支路径裁剪与历史摘要
+ * 在 v0.2（Context Policy）接入。
+ */
+import type { CharacterService } from './character-service.js';
+import type { ContextAssembler } from './context-assembler.js';
+import type { ConversationMessage } from '../domain/schemas.js';
+import type { ConversationRepository } from './conversation-repository.js';
+export interface AssembledPrompt {
+    /** system 槽：persona + scenario（+ 注入块经 messages 传递）。 */
+    system: string;
+    /** 有序对话消息（user/assistant；注入块以 system 角色放在最前）。 */
+    messages: Array<{
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+    }>;
+    /** 本轮上下文来源（lore/memory 命中 id，审计与 UI 展示用）。 */
+    contextSources: string[];
+    /** 粗略 token 估算（字符数 / 4，正式估算见 ModelCapabilityRegistry）。 */
+    tokenEstimate?: number;
+}
+export declare class PromptAssembler {
+    #private;
+    constructor(characters: CharacterService, assembler: ContextAssembler, conversations: ConversationRepository);
+    assemble(params: {
+        characterId: string;
+        conversationId: string;
+        userMessage: string;
+        sceneId?: string;
+        activeLeafMessageId?: string;
+        /** 伙伴 Agent 会话：用伙伴身份/背景/关系替代角色卡 persona。 */
+        systemOverride?: string;
+    }): Promise<AssembledPrompt>;
+}
+/** 从消息树提取历史文本（供 PromptAssembler 使用；保留导出便于测试）。 */
+export declare function historyTextOf(messages: readonly ConversationMessage[]): string;
+//# sourceMappingURL=prompt-assembler.d.ts.map

package/lib/core/prompt-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-assembler.d.ts","sourceRoot":"","sources":["../../src/core/prompt-assembler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAE1E,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3E,6CAA6C;IAC7C,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,qBAAa,eAAe;;gBAMxB,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,gBAAgB,EAC3B,aAAa,EAAE,sBAAsB;IAOjC,QAAQ,CAAC,MAAM,EAAE;QACrB,WAAW,EAAE,MAAM,CAAA;QACnB,cAAc,EAAE,MAAM,CAAA;QACtB,WAAW,EAAE,MAAM,CAAA;QACnB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,mBAAmB,CAAC,EAAE,MAAM,CAAA;QAC5B,4CAA4C;QAC5C,cAAc,CAAC,EAAE,MAAM,CAAA;KACxB,GAAG,OAAO,CAAC,eAAe,CAAC;CA8C7B;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,GAAG,MAAM,CAE9E"}