dsh-tavern-bundle 0.1.0

package/lib/application/chat/chat-application-service.d.ts

@@ -0,0 +1,94 @@
+/**
+ * ChatService —— 普通角色卡聊天（阶段 1，ADR-002）。
+ *
+ * 非 Agent 模型调用链路：conversation 持久化（事实源）→ PromptAssembler →
+ * LlmPort（ctx.llm.stream）→ 流式回复落盘。
+ *
+ * 约束：本服务**禁止**调用 startContinuable / SubagentGateway / LangGraph /
+ * 工作工具；角色卡默认 chat-only（ADR-005，CapabilityGrant 阶段 4 落地）。
+ */
+import type { Conversation, ConversationMessage } from '../../domain/schemas.js';
+import type { LlmPort } from '../ports/llm-port.js';
+import type { CharacterService } from '../../core/character-service.js';
+import type { ConversationRepository } from '../../core/conversation-repository.js';
+import type { PromptAssembler } from '../../core/prompt-assembler.js';
+import type { UserResolverPort } from '../../application/ports/user-resolver-port.js';
+export interface ModelSelection {
+    readonly provider: string;
+    readonly model: string;
+}
+export declare class ChatApplicationService {
+    #private;
+    constructor(userResolver: UserResolverPort, characters: CharacterService, conversationRepo: ConversationRepository, promptAssembler: PromptAssembler, modelGateway: LlmPort, modelSelection: () => ModelSelection, afterAssistantPersisted?: (ownerUserId: string, conversationId: string) => Promise<void>, afterConversationChanged?: (ownerUserId: string, conversationId: string) => Promise<void>);
+    /** 当前用户的全部会话（按更新时间倒序）。 */
+    listConversations(): Promise<Conversation[]>;
+    /** 读取当前用户拥有的一个聊天文件；不存在或跨用户时返回 null。 */
+    getConversation(conversationId: string): Promise<Conversation | null>;
+    /** 更新聊天文件显示名称；空白名称会清除自定义名称并回退显示日期。 */
+    renameConversation(conversationId: string, title: string): Promise<Conversation>;
+    /** 删除聊天文件：移入 Tavern 回收站，消息历史仍完整保留。 */
+    trashConversation(conversationId: string): Promise<Conversation>;
+    restoreConversation(conversationId: string): Promise<Conversation>;
+    /** 角色进入回收站时，连带隐藏其聊天文件但不删除消息。 */
+    trashCharacterConversations(characterId: string): Promise<number>;
+    restoreCharacterConversations(characterId: string): Promise<number>;
+    /**
+     * 发送一条消息并流式生成回复。
+     * - 无 conversationId 时创建新会话（消息树根）；
+     * - 用户消息落盘并成为 active leaf；
+     * - 返回外层流：消费模型 chunk → 文本 delta 流，结束时 assistant 消息落盘。
+     */
+    stream(params: {
+        characterId: string;
+        message: string;
+        conversationId?: string;
+        sceneId?: string;
+        /** 伙伴 Agent 会话 persona；缺省用角色卡 persona。 */
+        systemOverride?: string;
+    }): Promise<{
+        conversationId: string;
+        messageId: string;
+        stream: AsyncIterable<string>;
+    }>;
+    /**
+     * 重新生成（swipe sibling，§9.3）：目标 assistant 消息的 parent 为分支点，
+     * 生成新的 sibling assistant 消息（旧消息保留 active 可回切，active leaf 指向新的）。
+     * 返回流式文本；结束时新消息落盘并推进 leaf（消息 id 由 UI 重拉消息树获取）。
+     */
+    regenerate(params: {
+        conversationId: string;
+        messageId: string;
+        sceneId?: string;
+    }): Promise<{
+        stream: AsyncIterable<string>;
+    }>;
+    /** 编辑用户消息（§9.3/9.4）：原消息 superseded（保留历史），新消息同 parent 成为分支点。 */
+    editMessage(params: {
+        conversationId: string;
+        messageId: string;
+        newContent: string;
+    }): Promise<{
+        messageId: string;
+    }>;
+    /** 会话全部消息（消息树，UI 渲染用；createdAt 升序）。 */
+    listMessages(conversationId: string): Promise<ConversationMessage[]>;
+    /** 角色开场白候选（first_mes + alternate_greetings，新建对话时选择）。 */
+    greetings(characterId: string): readonly string[];
+    /**
+     * 新建会话（§9.5）：可选以角色开场白作为首条 assistant 消息（无生成调用）。
+     * 返回 conversationId；greetingIndex 省略则不写开场（用户发首条消息）。
+     */
+    startConversation(params: {
+        characterId: string;
+        greetingIndex?: number;
+        sceneId?: string;
+    }): Promise<{
+        conversationId: string;
+    }>;
+    /** 切换 active leaf（分支继续；乐观并发由 repository CAS 保证）。 */
+    switchBranch(params: {
+        conversationId: string;
+        messageId: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=chat-application-service.d.ts.map

package/lib/application/chat/chat-application-service.d.ts.map

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

package/lib/application/chat/chat-application-service.js

@@ -0,0 +1,291 @@
+/**
+ * ChatService —— 普通角色卡聊天（阶段 1，ADR-002）。
+ *
+ * 非 Agent 模型调用链路：conversation 持久化（事实源）→ PromptAssembler →
+ * LlmPort（ctx.llm.stream）→ 流式回复落盘。
+ *
+ * 约束：本服务**禁止**调用 startContinuable / SubagentGateway / LangGraph /
+ * 工作工具；角色卡默认 chat-only（ADR-005，CapabilityGrant 阶段 4 落地）。
+ */
+import { randomUUID } from 'node:crypto';
+import { createMessage } from '@deepseek-ai/dsh-llm';
+import { tavernMessageSource } from '../ports/message-source.js';
+export class ChatApplicationService {
+    #userResolver;
+    #characters;
+    #conversationRepo;
+    #promptAssembler;
+    #modelGateway;
+    /** 模型默认来源（agentDefaultModel.currentSelection），可配置覆盖。 */
+    #modelSelection;
+    /** 候选提取是 best-effort 后处理：绝不可阻断普通聊天。 */
+    #afterAssistantPersisted;
+    /** 分支切换/编辑后重验候选证据；同样是 best-effort，不能阻断聊天操作。 */
+    #afterConversationChanged;
+    constructor(userResolver, characters, conversationRepo, promptAssembler, modelGateway, modelSelection, afterAssistantPersisted, afterConversationChanged) {
+        this.#userResolver = userResolver;
+        this.#characters = characters;
+        this.#conversationRepo = conversationRepo;
+        this.#promptAssembler = promptAssembler;
+        this.#modelGateway = modelGateway;
+        this.#modelSelection = modelSelection;
+        this.#afterAssistantPersisted = afterAssistantPersisted;
+        this.#afterConversationChanged = afterConversationChanged;
+    }
+    /** 当前用户的全部会话（按更新时间倒序）。 */
+    async listConversations() {
+        const userId = await this.#userResolver.getCurrentUserId();
+        return this.#conversationRepo.listByUser(userId);
+    }
+    /** 读取当前用户拥有的一个聊天文件；不存在或跨用户时返回 null。 */
+    async getConversation(conversationId) {
+        const conversation = await this.#conversationRepo.get(conversationId);
+        if (conversation === null)
+            return null;
+        const userId = await this.#userResolver.getCurrentUserId();
+        return conversation.ownerUserId === userId ? conversation : null;
+    }
+    /** 更新聊天文件显示名称；空白名称会清除自定义名称并回退显示日期。 */
+    async renameConversation(conversationId, title) {
+        const conversation = await this.getConversation(conversationId);
+        if (conversation === null)
+            throw new Error(`[Tavern] 聊天文件不存在：${conversationId}`);
+        if (conversation.status !== 'active')
+            throw new Error('[Tavern] 已删除的聊天文件不可重命名');
+        return this.#conversationRepo.update(conversationId, { ...(title.trim() === '' ? { title: undefined } : { title: title.trim().slice(0, 120) }) });
+    }
+    /** 删除聊天文件：移入 Tavern 回收站，消息历史仍完整保留。 */
+    async trashConversation(conversationId) {
+        const conversation = await this.getConversation(conversationId);
+        if (conversation === null)
+            throw new Error(`[Tavern] 聊天文件不存在：${conversationId}`);
+        return this.#conversationRepo.update(conversationId, { status: 'trashed' });
+    }
+    async restoreConversation(conversationId) {
+        const conversation = await this.getConversation(conversationId);
+        if (conversation === null)
+            throw new Error(`[Tavern] 聊天文件不存在：${conversationId}`);
+        return this.#conversationRepo.update(conversationId, { status: 'active' });
+    }
+    /** 角色进入回收站时，连带隐藏其聊天文件但不删除消息。 */
+    async trashCharacterConversations(characterId) {
+        return this.#conversationRepo.updateByCharacter(characterId, { status: 'trashed' });
+    }
+    async restoreCharacterConversations(characterId) {
+        return this.#conversationRepo.updateByCharacter(characterId, { status: 'active' });
+    }
+    /**
+     * 发送一条消息并流式生成回复。
+     * - 无 conversationId 时创建新会话（消息树根）；
+     * - 用户消息落盘并成为 active leaf；
+     * - 返回外层流：消费模型 chunk → 文本 delta 流，结束时 assistant 消息落盘。
+     */
+    async stream(params) {
+        const userId = await this.#userResolver.getCurrentUserId();
+        let conversation;
+        if (params.conversationId !== undefined) {
+            const existing = await this.#conversationRepo.get(params.conversationId);
+            if (existing === null)
+                throw new Error(`[Tavern] Conversation 不存在：${params.conversationId}`);
+            conversation = existing;
+        }
+        else {
+            conversation = await this.#conversationRepo.create({
+                id: randomUUID(),
+                ownerUserId: userId,
+                characterId: params.characterId,
+                characterRevision: 1, // revision 固化：完整版本策略 v0.2
+                ...(params.sceneId === undefined ? {} : { sceneId: params.sceneId }),
+                status: 'active',
+            });
+        }
+        // 用户消息落盘（挂在当前 leaf 下，形成消息树）。
+        const parentId = conversation.activeLeafMessageId;
+        const userMessage = await this.#conversationRepo.addMessage({
+            id: randomUUID(),
+            conversationId: conversation.id,
+            ...(parentId === undefined ? {} : { parentMessageId: parentId }),
+            role: 'user',
+            content: params.message,
+            status: 'active',
+        });
+        await this.#conversationRepo.updateActiveLeaf(conversation.id, userMessage.id);
+        // 组装 prompt（世界书/记忆注入 + 历史 + 本轮消息）。
+        const prompt = await this.#promptAssembler.assemble({
+            characterId: params.characterId,
+            conversationId: conversation.id,
+            userMessage: params.message,
+            ...(params.sceneId === undefined ? {} : { sceneId: params.sceneId }),
+            activeLeafMessageId: userMessage.id,
+            ...(params.systemOverride === undefined ? {} : { systemOverride: params.systemOverride }),
+        });
+        const selection = this.#modelSelection();
+        const chunks = this.#modelGateway.stream({
+            provider: selection.provider,
+            model: selection.model,
+            system: prompt.system,
+            messages: prompt.messages
+                .filter(message => message.role !== 'system')
+                .map(message => createMessage({
+                role: message.role,
+                content: [{ type: 'text', text: message.content }],
+                source: tavernMessageSource(),
+            })),
+        });
+        const conversationId = conversation.id;
+        return {
+            conversationId,
+            messageId: userMessage.id,
+            stream: this.#consume(chunks, conversationId, userMessage.id, userId),
+        };
+    }
+    /** 消费模型 chunk 流：产出文本 delta，结束时把 assistant 消息写入消息树。 */
+    async *#consume(chunks, conversationId, parentMessageId, ownerUserId) {
+        let text = '';
+        for await (const chunk of chunks) {
+            if (chunk.type === 'text-delta') {
+                text += chunk.text;
+                yield chunk.text;
+            }
+        }
+        if (text !== '') {
+            const assistant = await this.#conversationRepo.addMessage({
+                id: randomUUID(),
+                conversationId,
+                ...(parentMessageId === undefined ? {} : { parentMessageId }),
+                role: 'assistant',
+                content: text,
+                status: 'active',
+            });
+            await this.#conversationRepo.updateActiveLeaf(conversationId, assistant.id);
+            if (ownerUserId !== undefined) {
+                // 新 assistant（特别是 regenerate 的 sibling）也会改变 active leaf：
+                // 先重验旧候选的分支证据，再 best-effort 提取当前分支的新候选。
+                void (async () => {
+                    await this.#afterConversationChanged?.(ownerUserId, conversationId);
+                    await this.#afterAssistantPersisted?.(ownerUserId, conversationId);
+                })().catch(() => { });
+            }
+        }
+    }
+    /**
+     * 重新生成（swipe sibling，§9.3）：目标 assistant 消息的 parent 为分支点，
+     * 生成新的 sibling assistant 消息（旧消息保留 active 可回切，active leaf 指向新的）。
+     * 返回流式文本；结束时新消息落盘并推进 leaf（消息 id 由 UI 重拉消息树获取）。
+     */
+    async regenerate(params) {
+        const target = await this.#conversationRepo.getMessage(params.messageId);
+        if (target === null)
+            throw new Error(`[Tavern] 消息不存在：${params.messageId}`);
+        if (target.role !== 'assistant')
+            throw new Error('[Tavern] 只能重新生成 assistant 消息');
+        const conversation = await this.#conversationRepo.get(params.conversationId);
+        if (conversation === null)
+            throw new Error(`[Tavern] Conversation 不存在：${params.conversationId}`);
+        const branchPointId = target.parentMessageId;
+        // 分支点消息（用户消息）作为本轮上下文锚点；无父消息（root assistant）则用空开场。
+        const branchUserContent = branchPointId === undefined
+            ? ''
+            : (await this.#conversationRepo.getMessage(branchPointId))?.content ?? '';
+        const prompt = await this.#promptAssembler.assemble({
+            characterId: conversation.characterId,
+            conversationId: conversation.id,
+            userMessage: branchUserContent,
+            ...(params.sceneId === undefined ? {} : { sceneId: params.sceneId }),
+            ...(branchPointId === undefined ? {} : { activeLeafMessageId: branchPointId }),
+        });
+        const selection = this.#modelSelection();
+        const chunks = this.#modelGateway.stream({
+            provider: selection.provider,
+            model: selection.model,
+            system: prompt.system,
+            messages: prompt.messages
+                .filter(message => message.role !== 'system')
+                .map(message => createMessage({
+                role: message.role,
+                content: [{ type: 'text', text: message.content }],
+                source: tavernMessageSource(),
+            })),
+        });
+        return { stream: this.#consume(chunks, conversation.id, branchPointId, conversation.ownerUserId) };
+    }
+    /** 编辑用户消息（§9.3/9.4）：原消息 superseded（保留历史），新消息同 parent 成为分支点。 */
+    async editMessage(params) {
+        const target = await this.#conversationRepo.getMessage(params.messageId);
+        if (target === null)
+            throw new Error(`[Tavern] 消息不存在：${params.messageId}`);
+        if (target.role !== 'user')
+            throw new Error('[Tavern] 只能编辑用户消息');
+        await this.#conversationRepo.updateMessage(params.messageId, { status: 'superseded' });
+        const edited = await this.#conversationRepo.addMessage({
+            id: randomUUID(),
+            conversationId: params.conversationId,
+            ...(target.parentMessageId === undefined ? {} : { parentMessageId: target.parentMessageId }),
+            role: 'user',
+            content: params.newContent,
+            status: 'active',
+        });
+        await this.#conversationRepo.updateActiveLeaf(params.conversationId, edited.id);
+        const conversation = await this.#conversationRepo.get(params.conversationId);
+        if (conversation !== null && this.#afterConversationChanged !== undefined) {
+            void this.#afterConversationChanged(conversation.ownerUserId, conversation.id).catch(() => { });
+        }
+        return { messageId: edited.id };
+    }
+    /** 会话全部消息（消息树，UI 渲染用；createdAt 升序）。 */
+    async listMessages(conversationId) {
+        return this.#conversationRepo.getMessageTree(conversationId);
+    }
+    /** 角色开场白候选（first_mes + alternate_greetings，新建对话时选择）。 */
+    greetings(characterId) {
+        const character = this.#characters.get(characterId);
+        if (character === null)
+            throw new Error(`[Tavern] 角色不存在：${characterId}`);
+        return [
+            ...(character.firstMessage === undefined ? [] : [character.firstMessage]),
+            ...character.alternateGreetings,
+        ];
+    }
+    /**
+     * 新建会话（§9.5）：可选以角色开场白作为首条 assistant 消息（无生成调用）。
+     * 返回 conversationId；greetingIndex 省略则不写开场（用户发首条消息）。
+     */
+    async startConversation(params) {
+        const userId = await this.#userResolver.getCurrentUserId();
+        const character = this.#characters.get(params.characterId);
+        if (character === null)
+            throw new Error(`[Tavern] 角色不存在：${params.characterId}`);
+        const conversation = await this.#conversationRepo.create({
+            id: randomUUID(),
+            ownerUserId: userId,
+            characterId: params.characterId,
+            characterRevision: character.revision,
+            ...(params.sceneId === undefined ? {} : { sceneId: params.sceneId }),
+            status: 'active',
+        });
+        if (params.greetingIndex !== undefined) {
+            const greetings = this.greetings(params.characterId);
+            const greeting = greetings[params.greetingIndex];
+            if (greeting === undefined)
+                throw new Error(`[Tavern] 开场白索引越界：${params.greetingIndex}`);
+            const assistant = await this.#conversationRepo.addMessage({
+                id: randomUUID(),
+                conversationId: conversation.id,
+                role: 'assistant',
+                content: greeting,
+                status: 'active',
+            });
+            await this.#conversationRepo.updateActiveLeaf(conversation.id, assistant.id);
+        }
+        return { conversationId: conversation.id };
+    }
+    /** 切换 active leaf（分支继续；乐观并发由 repository CAS 保证）。 */
+    async switchBranch(params) {
+        await this.#conversationRepo.updateActiveLeaf(params.conversationId, params.messageId);
+        const conversation = await this.#conversationRepo.get(params.conversationId);
+        if (conversation !== null && this.#afterConversationChanged !== undefined) {
+            void this.#afterConversationChanged(conversation.ownerUserId, conversation.id).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=chat-application-service.js.map

package/lib/application/chat/chat-application-service.js.map

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

package/lib/application/companion/agent-orchestrator.d.ts

@@ -0,0 +1,91 @@
+/**
+ * AgentOrchestrator —— 实例编排器（阶段 1 起，5.3 场景化）。
+ *
+ * 职责：summon（创建角色的 continuable 子 Agent 并归属场景）与 followup
+ * （向该子 Agent 续推，验证场景归属），并记录 parent/child session 关系。
+ * 调用方**不需要**传 parentAgent：当前会话的 Agent 由 SessionAgentProvider
+ * 从调用上下文（命令入口）解析。
+ *
+ * 场景模型（阶段 5.3）：
+ * - 实例按 `characterId@sceneId` 索引（单实例每角色每场景；同一角色可在
+ *   不同场景各有实例，记忆/关系按场景隔离）；
+ * - summon 解析场景：显式 sceneId（须存在）→ 用户首个 active 场景 →
+ *   自动创建（sceneTitle 或「{角色} 的场景」）；
+ * - followup 解析场景：显式 sceneId → 最后活跃场景 → 该用户唯一候选实例；
+ *   多场景同角色且无显式 sceneId 时抛错（需显式指定）；
+ * - 场景归属验证：followup 要求当前用户是该场景的 active 参与者（否则
+ *   跨场景调用被拒绝）。
+ *
+ * 持久化：summon 成功后把实例（含 sceneId）写入 instances 表；构造时从表
+ * 恢复 active 实例（Host 重启后 followup 可直接继续）。
+ *
+ * 状态语义：followup 成功仅表示 inbox 已接受（accepted），绝不等于角色已
+ * 回复完成（completed）——completed 需要可验证的运行时完成信号（turn/end）。
+ */
+import type { MessageId } from '@deepseek-ai/dsh-llm';
+import type { SessionId } from '@deepseek-ai/dsh-session';
+import type { KvTable } from '@deepseek-ai/dsh-storage-domain';
+import type { CharacterAgentInstance } from '../../domain/schemas.js';
+import type { AuditService } from '../../core/audit-service.js';
+import type { CharacterService } from '../../core/character-service.js';
+import { ContextAssembler } from '../../core/context-assembler.js';
+import type { RelationshipService } from '../relationship/relationship-service.js';
+import type { SceneService } from '../../core/scene-service.js';
+import type { SessionContextPort } from '../ports/session-context-port.js';
+import type { SubagentPort } from '../ports/subagent-port.js';
+/** 编排器日志门面（结构兼容 cordis Logger，便于单测注入）。 */
+export interface OrchestratorLogger {
+    info(message: string): void;
+}
+/** Legacy profile metadata is retained, but every Tavern child is tool-free. */
+/** 一次已建立的角色实例（内存 registry 条目）。 */
+export interface TavernInstance {
+    readonly characterId: string;
+    readonly sceneId: string;
+    readonly parentSessionId: SessionId;
+    readonly childId: SessionId;
+    readonly createdAt: string;
+}
+/** summon 参数：无需 parentAgent（由 SessionAgentProvider 解析当前会话 Agent）。 */
+export interface SummonParams {
+    readonly characterId: string;
+    /** 首条消息；缺省用角色卡 firstMessage。 */
+    readonly initialMessage?: string;
+    /** 场景归属（阶段 5.3）：显式加入指定场景；缺省复用用户 active 场景或新建。 */
+    readonly sceneId?: string;
+    /** 自动创建场景时的标题。 */
+    readonly sceneTitle?: string;
+    readonly signal?: AbortSignal;
+}
+export interface SummonResult {
+    readonly childId: SessionId;
+    readonly messageId: MessageId;
+    /** 实例归属的场景 id（复用或新建）。 */
+    readonly sceneId: string;
+}
+/** followup 参数：无需 parentAgent（由 SessionAgentProvider 解析）。 */
+export interface FollowupParams {
+    readonly characterId: string;
+    readonly message: string;
+    /** 场景归属：缺省用最后活跃场景或该用户唯一候选实例。 */
+    readonly sceneId?: string;
+    readonly signal?: AbortSignal;
+}
+export interface FollowupResult {
+    /** 恒为 true：仅表示 inbox 已接受（accepted ≠ completed）。 */
+    readonly accepted: true;
+    readonly messageId: MessageId;
+}
+export declare class AgentOrchestrator {
+    #private;
+    constructor(characters: CharacterService, gateway: SubagentPort, sessionAgents: SessionContextPort, instanceStore: KvTable<string, CharacterAgentInstance>, contextAssembler: ContextAssembler, relationships: RelationshipService, scenes: SceneService, audit: AuditService, logger: OrchestratorLogger);
+    /** 实例 registry 键：`characterId@sceneId`（单实例每角色每场景）。 */
+    static instanceKey(characterId: string, sceneId: string): string;
+    /** 已召唤实例快照（只读）。 */
+    listInstances(): readonly TavernInstance[];
+    /** 召唤角色：解析/创建场景 → 登记参与者 → 建立 continuable 子 Agent。 */
+    summon(params: SummonParams): Promise<SummonResult>;
+    /** 向角色实例续推一条消息。返回仅表示 accepted，不是 completed。 */
+    followup(params: FollowupParams): Promise<FollowupResult>;
+}
+//# sourceMappingURL=agent-orchestrator.d.ts.map

package/lib/application/companion/agent-orchestrator.d.ts.map

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