dsh-tavern-bundle 0.1.0

package/lib/application/companion/agent-orchestrator.js

@@ -0,0 +1,298 @@
+/**
+ * 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）。
+ */
+var _a;
+import { ContextAssembler } from '../../core/context-assembler.js';
+function tavernMessageSource() {
+    return { kind: 'plugin', plugin: 'dsh-tavern-bundle', form: 'relay' };
+}
+import { buildRoleplayPersona, normalizeRoleplayOpening } from '../../core/roleplay-contract.js';
+export class AgentOrchestrator {
+    #characters;
+    #gateway;
+    #sessionAgents;
+    #logger;
+    /** instances 表（tavern domain）：实例的持久化存储。 */
+    #instanceStore;
+    /** 上下文组装器：每次投递前世界书 + 记忆检索注入 + 审计 fingerprint。 */
+    #contextAssembler;
+    /** 关系图谱服务：summon 后登记 character-instance / user 节点。 */
+    #relationships;
+    /** 场景服务（阶段 5.3）：场景生命周期与参与者。 */
+    #scenes;
+    /** 审计服务（阶段 5.4）：summon/followup 状态变更可溯源。 */
+    #audit;
+    /** 内存 registry：`characterId@sceneId` → 实例。 */
+    #instances = new Map();
+    /** 内存：parentSessionId → 最后活跃场景（重启后丢失，回退唯一候选）。 */
+    #lastScene = new Map();
+    constructor(characters, gateway, sessionAgents, instanceStore, contextAssembler, relationships, scenes, audit, logger) {
+        this.#characters = characters;
+        this.#gateway = gateway;
+        this.#sessionAgents = sessionAgents;
+        this.#instanceStore = instanceStore;
+        this.#contextAssembler = contextAssembler;
+        this.#relationships = relationships;
+        this.#scenes = scenes;
+        this.#audit = audit;
+        this.#logger = logger;
+        this.#recoverInstances();
+    }
+    /** 实例 registry 键：`characterId@sceneId`（单实例每角色每场景）。 */
+    static instanceKey(characterId, sceneId) {
+        return `${characterId}@${sceneId}`;
+    }
+    /** 组装一次投递的世界书 + 记忆上下文（场景内检索）并写审计日志。 */
+    async #assemble(characterId, sceneId, userMessage) {
+        const assembled = await this.#contextAssembler.assemble({ characterId, userMessage, sceneId });
+        const hitIds = assembled.injectedLore.map(entry => entry.id);
+        const memoryIds = assembled.injectedMemory.map(memory => memory.id);
+        this.#logger.info(`上下文组装：character=${characterId} scene=${sceneId.slice(0, 8)}… lore=[${hitIds.join(',') || '无'}]`
+            + `（${assembled.truncated.requested}→${assembled.truncated.kept} 条）`
+            + ` memory=[${memoryIds.join(',') || '无'}]`
+            + `（${assembled.memoryTruncated.requested}→${assembled.memoryTruncated.kept} 条）`
+            + ` fingerprint=${assembled.fingerprint}`);
+        return assembled;
+    }
+    /** 恢复：把持久化的 active 实例载入内存 registry（重启后 followup 可直接继续）。 */
+    #recoverInstances() {
+        for (const [, record] of this.#instanceStore.entries()) {
+            if (record.status !== 'active')
+                continue;
+            this.#instances.set(_a.instanceKey(record.characterId, record.sceneId), {
+                characterId: record.characterId,
+                sceneId: record.sceneId,
+                parentSessionId: record.parentSessionId,
+                childId: record.childSessionId,
+                createdAt: record.createdAt,
+            });
+        }
+        if (this.#instances.size > 0) {
+            this.#logger.info(`恢复 ${this.#instances.size} 个角色实例（阶段 2 最小恢复器）`);
+        }
+    }
+    /** 已召唤实例快照（只读）。 */
+    listInstances() {
+        return [...this.#instances.values()];
+    }
+    /** 当前用户（会话粒度）：后续接入全局用户身份。 */
+    #userIdOf(parentSessionId) {
+        return String(parentSessionId);
+    }
+    /**
+     * 解析 summon 的场景：显式 sceneId（须存在）→ 用户首个 active 场景 →
+     * 自动创建（title = sceneTitle ?? 「{角色} 的场景」）。
+     */
+    async #resolveSummonScene(userId, characterName, params) {
+        if (params.sceneId !== undefined) {
+            const scene = this.#scenes.getScene(params.sceneId);
+            if (scene === null)
+                throw new Error(`[Tavern] 场景不存在：${params.sceneId}`);
+            return params.sceneId;
+        }
+        const scenes = await this.#scenes.getUserScenes(userId);
+        const active = scenes.filter(scene => scene.status === 'active');
+        if (active.length > 0)
+            return active[0].id;
+        const created = await this.#scenes.createScene({
+            ownerUserId: userId,
+            title: params.sceneTitle ?? `${characterName} 的场景`,
+        });
+        return created.id;
+    }
+    /**
+     * 解析 followup 的场景：显式 sceneId → 最后活跃场景 → 该用户唯一候选实例。
+     * 多场景同角色且无显式 sceneId / 最后活跃场景时抛错。
+     */
+    async #resolveFollowupScene(userId, characterId) {
+        const candidates = [];
+        for (const instance of this.#instances.values()) {
+            if (instance.characterId !== characterId)
+                continue;
+            const participants = await this.#scenes.getParticipants(instance.sceneId);
+            const joined = participants.some(participant => participant.entityKind === 'user' && participant.entityId === userId && participant.leftAt === undefined);
+            if (joined)
+                candidates.push(instance);
+        }
+        if (candidates.length === 0)
+            throw new Error(`[Tavern] 角色未召唤：${characterId}`);
+        const last = this.#lastScene.get(userId);
+        const byLast = last === undefined ? undefined : candidates.find(instance => instance.sceneId === last);
+        if (byLast !== undefined)
+            return byLast.sceneId;
+        if (candidates.length === 1)
+            return candidates[0].sceneId;
+        throw new Error(`[Tavern] 角色「${characterId}」在多个场景中各有实例（${candidates.map(item => item.sceneId.slice(0, 8)).join('、')}…），请显式指定 sceneId`);
+    }
+    /** 召唤角色：解析/创建场景 → 登记参与者 → 建立 continuable 子 Agent。 */
+    async summon(params) {
+        const character = this.#characters.get(params.characterId);
+        if (character === null) {
+            throw new Error(`[Tavern] 角色不存在：${params.characterId}`);
+        }
+        // 当前会话的 Agent 由调用上下文解析（命令入口自动携带），调用方无需传。
+        const parentAgent = this.#sessionAgents.getCurrentAgent();
+        const userId = this.#userIdOf(parentAgent.session.id);
+        const sceneId = await this.#resolveSummonScene(userId, character.name, params);
+        const instanceKey = _a.instanceKey(character.id, sceneId);
+        if (this.#instances.has(instanceKey)) {
+            throw new Error(`[Tavern] 角色已召唤（单实例每角色每场景）：${character.id} @ ${sceneId}`);
+        }
+        const signal = params.signal ?? new AbortController().signal;
+        const messageText = normalizeRoleplayOpening(params.initialMessage ?? character.firstMessage ?? `（${character.name} 已就位）`);
+        // 阶段 4 + 5.2：世界书 + 记忆检索注入（场景内；命中块作为 prompt 前置块）。
+        const lore = await this.#assemble(character.id, sceneId, messageText);
+        const started = await this.#gateway.startContinuable({
+            provider: 'spawn',
+            label: character.name,
+            parent: parentAgent,
+            prompt: [
+                ...lore.contentBlocks,
+                { type: 'text', text: messageText },
+            ],
+            persona: buildRoleplayPersona({ characterName: character.name, characterPersona: character.persona, mode: 'roleplay' }),
+            signal,
+        });
+        const instance = {
+            characterId: character.id,
+            sceneId,
+            parentSessionId: parentAgent.session.id,
+            childId: started.childId,
+            createdAt: new Date().toISOString(),
+        };
+        // 持久化实例（阶段 2 最小地基）：await 写入后再登记内存。
+        // 记录 id = `characterId@sceneId`（同角色多场景各一条，互不覆盖）。
+        const record = {
+            id: `${character.id}@${sceneId}`,
+            characterId: character.id,
+            characterRevision: character.revision,
+            parentSessionId: instance.parentSessionId,
+            childSessionId: started.childId,
+            sceneId,
+            status: 'active',
+            createdAt: instance.createdAt,
+        };
+        await this.#instanceStore.put(record.id, record);
+        this.#instances.set(instanceKey, instance);
+        this.#lastScene.set(userId, sceneId);
+        this.#logger.info(`summon 完成：character=${character.id} scene=${sceneId.slice(0, 8)}… child=${started.childId}`
+            + ` parent=${instance.parentSessionId}（实例已持久化 id=${record.id}）`);
+        // 阶段 5.4：实例创建审计（source=user，actor=当前用户）。
+        await this.#audit.log({
+            entityType: 'instance',
+            entityId: record.id,
+            action: 'create',
+            after: {
+                characterId: character.id,
+                characterRevision: character.revision,
+                sceneId,
+                childId: String(started.childId),
+                parentSessionId: String(instance.parentSessionId),
+            },
+            source: 'user',
+            actorId: userId,
+            sceneId,
+        });
+        // 阶段 5.1/5.2：登记关系节点 + 场景参与者。辅助数据，失败仅告警不阻断召唤。
+        try {
+            await this.#relationships.ensureNode('character-instance', record.id, character.name);
+            await this.#relationships.ensureNode('user', userId, '旅人');
+            const scene = this.#scenes.getScene(sceneId);
+            await this.#scenes.addParticipant({
+                sceneId,
+                entityId: userId,
+                entityKind: 'user',
+                role: scene?.ownerUserId === userId ? 'owner' : 'member',
+            });
+            await this.#scenes.addParticipant({
+                sceneId,
+                entityId: record.id,
+                entityKind: 'character-instance',
+                role: 'member',
+            });
+        }
+        catch (error) {
+            this.#logger.info(`关系节点/参与者记录失败（不影响召唤）：instance=${record.id} ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return { childId: started.childId, messageId: started.messageId, sceneId };
+    }
+    /** 向角色实例续推一条消息。返回仅表示 accepted，不是 completed。 */
+    async followup(params) {
+        const parentAgent = this.#sessionAgents.getCurrentAgent();
+        const parentSessionId = parentAgent.session.id;
+        const userId = this.#userIdOf(parentSessionId);
+        const sceneId = params.sceneId ?? await this.#resolveFollowupScene(userId, params.characterId);
+        const instance = this.#instances.get(_a.instanceKey(params.characterId, sceneId));
+        if (instance === undefined) {
+            throw new Error(`[Tavern] 角色未召唤：${params.characterId}（场景 ${sceneId.slice(0, 8)}…）`);
+        }
+        if (parentSessionId !== instance.parentSessionId) {
+            throw new Error(`[Tavern] parent 不匹配：followup 必须由创建该子 Agent 的直接父 Agent 发起`
+                + `（期望 ${instance.parentSessionId}，实际 ${parentSessionId}）`);
+        }
+        // 场景归属验证：当前用户必须是该场景的 active 参与者（跨场景调用被拒绝）。
+        const participants = await this.#scenes.getParticipants(sceneId);
+        const joined = participants.some(participant => participant.entityKind === 'user' && participant.entityId === userId && participant.leftAt === undefined);
+        if (!joined) {
+            throw new Error(`[Tavern] 当前会话不属于场景 ${sceneId.slice(0, 8)}…（跨场景调用被拒绝）`);
+        }
+        this.#lastScene.set(userId, sceneId);
+        const signal = params.signal ?? new AbortController().signal;
+        // 阶段 4 + 5.2：世界书 + 记忆检索注入（场景内；命中块作为 content 前置块）。
+        const lore = await this.#assemble(params.characterId, sceneId, params.message);
+        const messageId = await this.#gateway.followup({
+            parent: parentAgent,
+            childId: instance.childId,
+            content: [
+                ...lore.contentBlocks,
+                { type: 'text', text: params.message },
+            ],
+            source: tavernMessageSource(),
+            signal,
+        });
+        // accepted ≠ completed：只有 inbox 接受被保证；completed 需完成信号（阶段 2）。
+        this.#logger.info(`followup accepted（≠ completed）：character=${params.characterId} scene=${sceneId.slice(0, 8)}…`
+            + ` child=${instance.childId} messageId=${messageId}`);
+        // 阶段 5.4：投递审计（sourceEventId = messageId，经此查询全链路）。
+        await this.#audit.log({
+            entityType: 'delivery',
+            entityId: String(messageId),
+            action: 'create',
+            after: {
+                characterId: params.characterId,
+                sceneId,
+                childId: String(instance.childId),
+                accepted: true,
+                message: params.message,
+            },
+            source: 'user',
+            sourceEventId: String(messageId),
+            actorId: userId,
+            sceneId,
+        });
+        return { accepted: true, messageId };
+    }
+}
+_a = AgentOrchestrator;
+//# sourceMappingURL=agent-orchestrator.js.map

package/lib/application/companion/agent-orchestrator.js.map

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

package/lib/application/companion/companion-child-service.d.ts

@@ -0,0 +1,47 @@
+import type { Agent, AgentOptions } from '@deepseek-ai/dsh-agent';
+import type { ContentBlock } from '@deepseek-ai/dsh-llm';
+import type { ToolRestriction } from '@deepseek-ai/dsh-tools';
+import type { CompanionModelPreference, RuntimeBindingRecord } from '../../domain/schemas.js';
+import type { RuntimeBindingService } from '../../core/runtime-binding-service.js';
+import type { SubagentStartPortResult, SubagentPort } from '../ports/subagent-port.js';
+export interface CompanionChildGateway extends SubagentPort {
+    startContinuable(input: {
+        provider: string;
+        label: string;
+        parent: Agent;
+        prompt: ContentBlock[];
+        persona?: string;
+        toolFilter?: ToolRestriction;
+        agentOptions?: AgentOptions;
+        signal?: AbortSignal;
+    }): Promise<SubagentStartPortResult>;
+}
+export interface StartCompanionChildParams {
+    readonly ownerUserId: string;
+    readonly companionProfileId: string;
+    readonly label: string;
+    readonly parent: Agent;
+    readonly prompt: ContentBlock[];
+    readonly persona?: string;
+    readonly toolFilter?: ToolRestriction;
+    readonly workspaceId?: string;
+    readonly modelPreference?: CompanionModelPreference;
+    readonly sceneId?: string;
+    readonly signal?: AbortSignal;
+}
+/** Creates a DSH child only through a supplied, direct parent Agent. */
+export declare class CompanionChildAgentService {
+    private readonly bindings;
+    private readonly gateway;
+    constructor(bindings: RuntimeBindingService, gateway: CompanionChildGateway);
+    start(params: StartCompanionChildParams): Promise<{
+        binding: RuntimeBindingRecord;
+        childId: string;
+        messageId: string;
+        route: {
+            provider?: string;
+            model?: string;
+        };
+    }>;
+}
+//# sourceMappingURL=companion-child-service.d.ts.map

package/lib/application/companion/companion-child-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-child-service.d.ts","sourceRoot":"","sources":["../../../src/application/companion/companion-child-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAEtF,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,gBAAgB,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,YAAY,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,eAAe,CAAC;QAAC,YAAY,CAAC,EAAE,YAAY,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACzO;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAA;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAA;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,CAAA;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,wEAAwE;AACxE,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAyB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAzD,QAAQ,EAAE,qBAAqB,EAAmB,OAAO,EAAE,qBAAqB;IAEvG,KAAK,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,oBAAoB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CAiB7K"}

package/lib/application/companion/companion-child-service.js

@@ -0,0 +1,30 @@
+/** Creates a DSH child only through a supplied, direct parent Agent. */
+export class CompanionChildAgentService {
+    bindings;
+    gateway;
+    constructor(bindings, gateway) {
+        this.bindings = bindings;
+        this.gateway = gateway;
+    }
+    async start(params) {
+        const parentSessionId = String(params.parent?.session?.id ?? '');
+        const preference = params.modelPreference ?? { mode: 'inherit-dsh-session' };
+        if (preference.mode === 'inherit-dsh-default' || preference.mode === 'runtime-default')
+            throw new Error(`[Tavern] 模型策略 ${preference.mode} 当前 DSH Host 未暴露可解析的默认模型，已拒绝静默回退`);
+        const route = preference.providerId === undefined && preference.modelId === undefined ? {} : { ...(preference.providerId === undefined ? {} : { provider: preference.providerId }), ...(preference.modelId === undefined ? {} : { model: preference.modelId }) };
+        const agentOptions = Object.keys(route).length === 0 ? undefined : route;
+        if (!parentSessionId.trim())
+            throw new Error('[Tavern] Companion child requires a valid direct parent Agent');
+        const requested = await this.bindings.create({ runtimeType: 'dsh-child', runtimeId: `requested:${parentSessionId}`, ownerUserId: params.ownerUserId, companionProfileId: params.companionProfileId, ...(params.workspaceId === undefined ? {} : { workspaceId: params.workspaceId }), ...(params.sceneId === undefined ? {} : { sceneId: params.sceneId }), purpose: 'companion', status: 'requested' });
+        try {
+            const started = await this.gateway.startContinuable({ provider: 'spawn', label: params.label, parent: params.parent, prompt: params.prompt, ...(params.persona === undefined ? {} : { persona: params.persona }), ...(params.toolFilter === undefined ? {} : { toolFilter: params.toolFilter }), ...(agentOptions === undefined ? {} : { agentOptions }), ...(params.signal === undefined ? {} : { signal: params.signal }) });
+            const binding = await this.bindings.activate(params.ownerUserId, requested.id, String(started.childId));
+            return { binding, childId: String(started.childId), messageId: String(started.messageId), route };
+        }
+        catch (error) {
+            await this.bindings.transition(params.ownerUserId, requested.id, 'orphaned');
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=companion-child-service.js.map

package/lib/application/companion/companion-child-service.js.map

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

package/lib/application/companion/companion-invocation-service.d.ts

@@ -0,0 +1,42 @@
+import type { KvTable } from '@deepseek-ai/dsh-storage-domain';
+import type { CompanionProfile, RelationshipEdge, RuntimeBindingRecord } from '../../domain/schemas.js';
+import type { CompanionRuntimePort, CompanionEvent } from '../ports/companion-runtime-port.js';
+import type { WorkspaceService } from '../workspace/workspace-service.js';
+import type { SceneService } from '../../core/scene-service.js';
+import type { MemoryService } from '../memory/memory-service.js';
+import type { RuntimeBindingService } from '../../core/runtime-binding-service.js';
+import type { RoleplayMode } from '../../core/roleplay-contract.js';
+export interface InvokeCompanionParams {
+    readonly ownerUserId: string;
+    readonly companionProfileId: string;
+    readonly message: string;
+    readonly requestId: string;
+    readonly traceId: string;
+    readonly idempotencyKey: string;
+    readonly directParentSessionId: string;
+    readonly workspaceId?: string;
+    readonly sceneId?: string;
+    readonly bindingPurpose?: 'companion' | 'group-delivery' | 'chat-generation';
+    readonly roleplayMode?: RoleplayMode;
+    readonly groupThreadHistory?: readonly {
+        role: 'user' | 'companion';
+        senderId: string;
+        content: string;
+    }[];
+}
+/** Starts a tool-free Companion runtime after identity and workspace checks. */
+export declare class CompanionInvocationService {
+    private readonly profiles;
+    private readonly bindings;
+    private readonly workspaces;
+    private readonly scenes;
+    private readonly runtime;
+    private readonly memory?;
+    private readonly relationshipView?;
+    constructor(profiles: KvTable<string, CompanionProfile>, bindings: RuntimeBindingService, workspaces: WorkspaceService, scenes: SceneService, runtime: CompanionRuntimePort, memory?: MemoryService | undefined, relationshipView?: ((ownerUserId: string, profileId: string, sceneId?: string) => Promise<RelationshipEdge[]>) | undefined);
+    invoke(params: InvokeCompanionParams): Promise<{
+        binding: RuntimeBindingRecord;
+        events: AsyncIterable<CompanionEvent>;
+    }>;
+}
+//# sourceMappingURL=companion-invocation-service.d.ts.map

package/lib/application/companion/companion-invocation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-invocation-service.d.ts","sourceRoot":"","sources":["../../../src/application/companion/companion-invocation-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AACvG,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AAC9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAEnE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACpC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC3G;AAED,gFAAgF;AAChF,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBANjB,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC3C,QAAQ,EAAE,qBAAqB,EAC/B,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,oBAAoB,EAC7B,MAAM,CAAC,EAAE,aAAa,YAAA,EACtB,gBAAgB,CAAC,GAAE,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,EAAE,CAAC,aAAA;IAGzH,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,oBAAoB,CAAC;QAAC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;KAAE,CAAC;CAyB/H"}

package/lib/application/companion/companion-invocation-service.js

@@ -0,0 +1,50 @@
+/** Starts a tool-free Companion runtime after identity and workspace checks. */
+export class CompanionInvocationService {
+    profiles;
+    bindings;
+    workspaces;
+    scenes;
+    runtime;
+    memory;
+    relationshipView;
+    constructor(profiles, bindings, workspaces, scenes, runtime, memory, relationshipView) {
+        this.profiles = profiles;
+        this.bindings = bindings;
+        this.workspaces = workspaces;
+        this.scenes = scenes;
+        this.runtime = runtime;
+        this.memory = memory;
+        this.relationshipView = relationshipView;
+    }
+    async invoke(params) {
+        if (!params.directParentSessionId.trim())
+            throw new Error('[Tavern] Companion invocation requires a valid DSH direct parent');
+        const profile = this.profiles.get(params.companionProfileId);
+        if (!profile || profile.ownerUserId !== params.ownerUserId || profile.status !== 'active')
+            throw new Error('[Tavern] Active Companion not found or not owned');
+        if (params.workspaceId !== undefined) {
+            const workspace = this.workspaces.getForOwner(params.ownerUserId, params.workspaceId);
+            if (!workspace || workspace.status !== 'active' || !this.workspaces.hasActiveCompanion(workspace.id, profile.id))
+                throw new Error('[Tavern] Workspace membership rejected');
+            if (params.sceneId !== undefined && !this.workspaces.hasActiveSceneBinding(workspace.id, params.sceneId))
+                throw new Error('[Tavern] Scene is not bound to Workspace');
+        }
+        if (params.sceneId !== undefined) {
+            const scene = this.scenes.getScene(params.sceneId);
+            if (!scene || scene.ownerUserId !== params.ownerUserId || scene.status !== 'active')
+                throw new Error('[Tavern] Scene is unavailable');
+        }
+        const memories = this.memory?.listActiveByCharacter(profile.characterId, params.sceneId).filter(item => (item.ownerUserId === undefined || item.ownerUserId === params.ownerUserId) && (item.sourceEventId === undefined || ((!item.sourceEventId.startsWith('promotion:') && !item.sourceEventId.startsWith('shared-history:')) || item.sourceEventId === `promotion:${profile.id}` || item.sourceEventId.startsWith(`shared-history:${profile.id}:`)))) ?? [];
+        const relationships = this.relationshipView === undefined ? [] : await this.relationshipView(params.ownerUserId, profile.id, params.sceneId);
+        const context = {
+            profile: { id: profile.id, characterId: profile.characterId, ...(profile.identitySummary === undefined ? {} : { identitySummary: profile.identitySummary }), ...(profile.personalitySummary === undefined ? {} : { personalitySummary: profile.personalitySummary }), personalityTraits: profile.personalityTraits ?? [], boundaries: profile.boundaries, goals: profile.goals, ...(profile.modelPreference === undefined ? {} : { modelPreference: profile.modelPreference }) },
+            confirmedMemoryFacts: memories.map(item => item.fact),
+            relationshipView: relationships,
+            roleplayMode: params.roleplayMode ?? (params.bindingPurpose === 'group-delivery' ? 'group-roleplay' : 'roleplay'),
+            ...(params.groupThreadHistory === undefined ? {} : { groupThreadHistory: params.groupThreadHistory }),
+        };
+        const binding = await this.bindings.create({ runtimeType: 'generation', runtimeId: `generation:${params.idempotencyKey}`, ownerUserId: params.ownerUserId, companionProfileId: profile.id, ...(params.workspaceId === undefined ? {} : { workspaceId: params.workspaceId }), ...(params.sceneId === undefined ? {} : { sceneId: params.sceneId }), purpose: params.bindingPurpose ?? 'companion', status: 'active' });
+        return { binding, events: this.runtime.invoke({ ...params, characterId: profile.characterId, runtimeBindingId: binding.id, context, roleplayMode: context.roleplayMode }) };
+    }
+}
+//# sourceMappingURL=companion-invocation-service.js.map

package/lib/application/companion/companion-invocation-service.js.map

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

package/lib/application/companion/companion-profile-service.d.ts

@@ -0,0 +1,32 @@
+import type { KvTable } from '@deepseek-ai/dsh-storage-domain';
+import type { AuditService } from '../../core/audit-service.js';
+import type { CharacterDefinition, CompanionModelPreference, CompanionProfile, CompanionProfileStatus, RelationshipEdge } from '../../domain/schemas.js';
+import type { RelationshipService } from '../relationship/relationship-service.js';
+export interface PromoteCompanionParams {
+    readonly ownerUserId: string;
+    readonly character: CharacterDefinition;
+    readonly displayName?: string;
+    readonly identitySummary?: string;
+    readonly communicationPreferences?: string;
+    readonly userRelationshipSummary?: string;
+    readonly sharedHistorySummary?: string;
+    readonly boundaries?: readonly string[];
+    readonly goals?: readonly string[];
+}
+export declare class CompanionProfileService {
+    #private;
+    constructor(profiles: KvTable<string, CompanionProfile>, audit: AuditService, relationships?: RelationshipService);
+    getForUser(ownerUserId: string, id: string): CompanionProfile | null;
+    listForUser(ownerUserId: string): CompanionProfile[];
+    findActive(ownerUserId: string, characterId: string): CompanionProfile | null;
+    promote(params: PromoteCompanionParams): Promise<{
+        profile: CompanionProfile;
+        created: boolean;
+    }>;
+    /** 当前 owner 可见的 Companion ↔ Companion 有向边。无 sceneId 时仅返回全局边。 */
+    listCompanionRelationships(ownerUserId: string, profileId: string, sceneId?: string): Promise<RelationshipEdge[]>;
+    rename(ownerUserId: string, id: string, displayName: string): Promise<CompanionProfile>;
+    setModelPreference(ownerUserId: string, id: string, preference: CompanionModelPreference): Promise<CompanionProfile>;
+    transition(ownerUserId: string, id: string, target: CompanionProfileStatus): Promise<CompanionProfile>;
+}
+//# sourceMappingURL=companion-profile-service.d.ts.map

package/lib/application/companion/companion-profile-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-profile-service.d.ts","sourceRoot":"","sources":["../../../src/application/companion/companion-profile-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACxJ,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAElF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAA;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAC1C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IACzC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAMD,qBAAa,uBAAuB;;gBAItB,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,mBAAmB;IAEjH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIpE,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAGpD,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIvE,OAAO,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAqBvG,gEAAgE;IAC1D,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAqBjH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAYvF,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUpH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAW7G"}