dsh-tavern-bundle 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DSH-Tavern contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,216 @@
+# DSH-Tavern
+
+DSH-Tavern 是一个运行在 DeepSeek Harness 上的 Tavern 风格角色卡聊天插件。它提供角色卡导入、普通角色对话、聊天记录管理、记忆与关系管理等能力，并为后续 Companion Agent 能力提供基础运行框架。
+
+> 当前版本为技术预览，正在持续开发中。不建议用于生产环境，也不要在仓库或配置文件中提交 API Key、密码等敏感信息。
+
+## 项目特点
+
+- 支持 V1/V2/V3 JSON、PNG 和 CHARX 角色卡导入；
+- 支持角色卡、世界书和聊天记录管理；
+- 普通角色卡聊天与 Agent 运行时分离；
+- 支持聊天消息树、分支、重新生成和导入导出基础能力；
+- 提供记忆、关系、场景和审计数据模型；
+- 提供 Companion Profile、Workspace 和多伙伴协作的基础能力；
+- 通过 DeepSeek Harness 的插件机制加载到 Web UI 中。
+
+## 使用的框架和技术
+
+### 宿主框架
+
+- [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/)：插件运行宿主、Web UI、会话、LLM 和存储能力；
+- [Cordis](https://github.com/shigma/Cordis)：插件生命周期、依赖注入、服务和事件管理框架。
+
+### 项目技术栈
+
+- TypeScript：服务端和领域代码；
+- React：浏览器端界面；
+- Vite：客户端构建；
+- esbuild：测试 Bundle 和构建辅助；
+- Zod：运行时数据校验；
+- pnpm：依赖和脚本管理；
+- Python、FastAPI、LangGraph：实验性的 Companion Runtime sidecar，目前不是基础聊天功能的必需组件。
+
+## 运行原理
+
+项目包含两条相互独立的链路：
+
+```text
+角色卡 + 世界书
+    -> Tavern ChatService
+    -> DeepSeek Harness LLM
+    -> Conversation / ConversationMessage
+
+用户主动晋升 Companion
+    -> CompanionProfile
+    -> Companion Runtime
+    -> Workspace / 多伙伴协作
+```
+
+普通角色卡聊天不会自动创建 Child Agent，也不会因为角色卡内容获得工作工具权限。只有经过用户明确晋升和授权的 Companion 才能进入 Agent Runtime。
+
+## 安装前提
+
+使用者需要先准备：
+
+- Node.js 22 或兼容项目依赖的 Node.js 版本；
+- pnpm 11；
+- 已安装并可以运行的 DeepSeek Harness；
+- 已在 DeepSeek Harness 中完成模型和 Host 配置。
+
+检查 Node.js 和 pnpm：
+
+```bash
+node --version
+pnpm --version
+```
+
+建议使用项目声明的 pnpm 版本：
+
+```bash
+corepack enable
+corepack prepare pnpm@11.21.0 --activate
+```
+
+## 安装插件
+
+项目支持通过 DeepSeek Harness 官方插件管理命令从 npm 安装。普通使用者不需要下载源码或手动编译。
+
+### 1. 安装插件
+
+在任意目录执行：
+
+```bash
+dsh plugin --profile web add dsh-tavern-bundle
+```
+
+如果使用 pnpm 启动 Harness，也可以执行：
+
+```powershell
+pnpm dsh plugin --profile web add dsh-tavern-bundle
+```
+
+Harness 会把插件安装到 Web Profile，并自动识别项目声明的 `dsh.bundle` 配置，自动更新 Profile 的 Bundle 列表。
+
+### 2. 启动
+
+```bash
+dsh web
+```
+
+或：
+
+```bash
+pnpm dsh web
+```
+
+启动成功后打开 `http://127.0.0.1:3080`。
+
+### 从源码开发
+
+只有需要参与开发时才需要下载源码：
+
+```bash
+git clone https://github.com/sjennxienkdi/dsh-tavern-bundle.git
+cd dsh-tavern-bundle
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm run build:client
+```
+
+源码开发时，可在 Harness 项目目录使用 `dsh plugin --profile web add link:/绝对路径/dsh-tavern-bundle` 安装本地链接包。
+
+## 配置说明
+
+正常通过 `dsh plugin --profile web add dsh-tavern-bundle` 安装时，不需要手动编辑 `cordis.patch.yml`。Harness 会自动把带有 `dsh.bundle` 声明的依赖加入 Web Profile。
+
+项目包内的 `cordis.patch.yml` 只挂载 Tavern 宿主；`storage`、`storage-json` 和 `storage-domain` 等基础服务由 Harness Web Host 提供。
+
+如果安装后需要检查 Profile 的组合配置，可以使用：
+
+```bash
+dsh --profile web --dump-config
+```
+
+## 启动
+
+安装完成后，在 Harness 环境中执行：
+
+```bash
+dsh web
+```
+
+启动成功后打开：
+
+```text
+http://127.0.0.1:3080
+```
+
+如果使用源码开发，修改 `src/` 后需要重新执行 `pnpm run build` 和 `pnpm run build:client`，然后重启 Host。
+
+## Python sidecar（可选）
+
+基础角色卡聊天不需要启动 Python sidecar。只有使用实验性的 Companion Runtime 路径时才需要它。
+
+```bash
+cd python
+python -m venv .venv
+```
+
+Windows：
+
+```powershell
+.venv\\Scripts\\activate
+python -m pip install -r requirements.txt
+uvicorn main:app --port 8787
+```
+
+Linux/macOS：
+
+```bash
+source .venv/bin/activate
+python -m pip install -r requirements.txt
+uvicorn main:app --port 8787
+```
+
+sidecar 的鉴权和模型配置通过环境变量提供，例如 `TAVERN_LANGGRAPH_TOKEN` 和 `DEEPSEEK_API_KEY`。这些变量只应配置在本机环境中，不要写入 Git 文件。
+
+## 开发和验证
+
+```bash
+pnpm run check:architecture
+pnpm run typecheck
+pnpm run test:unit
+pnpm run build
+pnpm run build:client
+pnpm run build:smoke
+```
+
+`pnpm run test:smoke` 需要可用的 DeepSeek Harness Host 和隔离的测试环境；普通贡献者可以先运行架构检查、类型检查、单元测试和构建命令。
+
+## 目录结构
+
+```text
+src/application/       应用服务、Ports 和用例编排
+src/domain/             领域模型与存储 Schema
+src/infrastructure/     Harness、LLM、Session 和 Runtime 适配器
+src/interfaces/         HTTP 和 Read Model 接口
+src/bootstrap/          插件组装、依赖注册和生命周期管理
+src/core/               兼容 facade 与仍在迁移的领域服务
+src/client/             React 浏览器端界面
+python/                 实验性的 Companion Runtime sidecar
+scripts/                架构检查和 smoke 构建脚本
+tests/                  单元测试和 Host smoke 测试
+```
+
+## 兼容性约束
+
+- 不要修改现有 HTTP URL、错误结构和外部导出；
+- Storage version 保持 `1`；
+- 新业务代码优先放入 `application`、`interfaces` 或 `infrastructure`；
+- 插件创建的 Timer、监听器和注册项必须绑定 Cordis effect 或生命周期管理；
+- 修改 DeepSeek Harness Host 契约前，应先记录架构决策并运行完整验证链。
+
+## 许可证
+
+本项目使用 [MIT License](./LICENSE) 开源。

package/cordis.patch.yml

@@ -0,0 +1,14 @@
+# DSH-Tavern Bundle layer for the DeepSeek Harness Web profile.
+# Storage services are provided by dsh-web-app; this bundle only mounts Tavern.
+- insert:
+    - id: tavern
+      name: dsh-tavern-bundle
+      inject:
+        - subagents
+        - storageDomain
+        - storage
+        - tools
+        - commands
+        - llm
+      config:
+        mode: host

package/lib/adapters/model-gateway.d.ts

@@ -0,0 +1,4 @@
+/** @deprecated Use infrastructure/dsh/llm/model-gateway instead. */
+export * from '../infrastructure/dsh/llm/model-gateway.js';
+export type { LlmPort } from '../application/ports/llm-port.js';
+//# sourceMappingURL=model-gateway.d.ts.map

package/lib/adapters/model-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-gateway.d.ts","sourceRoot":"","sources":["../../src/adapters/model-gateway.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,cAAc,4CAA4C,CAAA;AAC1D,YAAY,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAA"}

package/lib/adapters/model-gateway.js

@@ -0,0 +1,3 @@
+/** @deprecated Use infrastructure/dsh/llm/model-gateway instead. */
+export * from '../infrastructure/dsh/llm/model-gateway.js';
+//# sourceMappingURL=model-gateway.js.map

package/lib/adapters/model-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-gateway.js","sourceRoot":"","sources":["../../src/adapters/model-gateway.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,cAAc,4CAA4C,CAAA"}

package/lib/adapters/prestep-spike.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 阶段 2 探测 spike：`agent/pre-step` 拦截可行性（选项 B）。
+ *
+ * 假设：Tavern 角色卡对话 = DSH Session + agent（原生输入/呈现/持久化全复用）；
+ * 我们监听该 agent 的 `agent/pre-step`（waterfall，可拒绝 step），
+ * 阻止 agent 的 LLM 调用，转 ChatService，并把回复以 assistant/chunk +
+ * assistant/message 注入同一 turn/step → 原生 UI 流式呈现。
+ *
+ * 本文件只验证机制（headless probe），不写业务：
+ *  - agents.create 建 agent+session；
+ *  - agent.ctx.on('agent/pre-step') 拒绝 + 模拟回复注入；
+ *  - agent.send 模拟原生输入 → whenIdle → 检查 session log 全链路。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare function runPrestepSpike(ctx: Context): Promise<void>;
+//# sourceMappingURL=prestep-spike.d.ts.map

package/lib/adapters/prestep-spike.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prestep-spike.d.ts","sourceRoot":"","sources":["../../src/adapters/prestep-spike.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAwBlD,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAmGjE"}

package/lib/adapters/prestep-spike.js

@@ -0,0 +1,114 @@
+/**
+ * 阶段 2 探测 spike：`agent/pre-step` 拦截可行性（选项 B）。
+ *
+ * 假设：Tavern 角色卡对话 = DSH Session + agent（原生输入/呈现/持久化全复用）；
+ * 我们监听该 agent 的 `agent/pre-step`（waterfall，可拒绝 step），
+ * 阻止 agent 的 LLM 调用，转 ChatService，并把回复以 assistant/chunk +
+ * assistant/message 注入同一 turn/step → 原生 UI 流式呈现。
+ *
+ * 本文件只验证机制（headless probe），不写业务：
+ *  - agents.create 建 agent+session；
+ *  - agent.ctx.on('agent/pre-step') 拒绝 + 模拟回复注入；
+ *  - agent.send 模拟原生输入 → whenIdle → 检查 session log 全链路。
+ */
+import { createAssistantMessage, createUserMessage } from '@deepseek-ai/dsh-llm';
+import { tavernMessageSource } from './subagent-gateway.js';
+function textBlock(text) {
+    return { type: 'text', text };
+}
+function textOf(message) {
+    return message.content
+        .filter(block => block.type === 'text')
+        .map(block => block.text)
+        .join('');
+}
+export async function runPrestepSpike(ctx) {
+    await ctx.inject(['agents', 'agentDefaultModel'], async (spikeCtx) => {
+        const agents = spikeCtx.get('agents');
+        const defaultModel = spikeCtx.get('agentDefaultModel');
+        if (agents === undefined) {
+            console.log('[Tavern-PROBE] stage2 prestep spike: agents 服务不可用（无 dsh-agent）');
+            return;
+        }
+        const { provider, model } = defaultModel?.currentSelection() ?? {
+            provider: 'deepseek-official',
+            model: 'deepseek-v4-flash',
+        };
+        // 随机 id：session-persistence 会持久化日志，固定 id 与上次运行残留冲突。
+        const handle = await agents.create({
+            sessionId: `tavern-prestep-spike-${Date.now().toString(36)}`,
+            agentOptions: { provider, model },
+        });
+        const agent = handle.agent;
+        const session = agent.session;
+        let preStepFired = null;
+        let preStepRejected = false;
+        // 拦截该 agent 的每个 step：拒绝 LLM 调用，注入模拟回复（同一 turn/step）。
+        agent.ctx.on('agent/pre-step', async (payload) => {
+            preStepFired = {
+                turn: payload.turn,
+                step: payload.step,
+                userContents: payload.messages.map(textOf),
+            };
+            // 关键：消息已从 inbox 移除给 pre-step，step 被拒绝后 agent 不会写 user/message；
+            // 由我们补写，保证原生 UI 呈现 + 持久化。
+            const user = payload.messages[0];
+            if (user !== undefined) {
+                session.append('user/message', user, { surfaceOp: 'append' });
+            }
+            const reply = `（spike）收到你的消息：「${preStepFired.userContents.join(' / ')}」。这条回复由 ChatService 注入。`;
+            // 流式：block-start → text-delta → block-end（原生 UI 由 chunk 驱动流式渲染）。
+            session.append('assistant/chunk', {
+                turn: payload.turn,
+                step: payload.step,
+                chunk: { type: 'block-start', index: 0, blockType: 'text' },
+            });
+            session.append('assistant/chunk', {
+                turn: payload.turn,
+                step: payload.step,
+                chunk: { type: 'text-delta', index: 0, text: reply },
+            });
+            session.append('assistant/chunk', {
+                turn: payload.turn,
+                step: payload.step,
+                chunk: { type: 'block-end', index: 0, block: textBlock(reply) },
+            });
+            // 终态：assistant/message（surface 消息，UI 会话历史/持久化依据）。
+            const message = createAssistantMessage({
+                content: [textBlock(reply)],
+                source: { provider, model }, // kind 由工厂固定为 'model'
+            });
+            session.append('assistant/message', { turn: payload.turn, step: payload.step, message }, { surfaceOp: 'append' });
+            preStepRejected = true;
+            // 不调用 next()：拒绝该 step（agent 永不调 LLM）。
+            return { kind: 'reject' };
+        });
+        // 模拟原生输入框发送。
+        const userMessage = createUserMessage({
+            content: [{ type: 'text', text: '你好，spike' }],
+            source: tavernMessageSource(),
+        });
+        agent.send(userMessage, 'next-turn', true);
+        await agent.whenIdle();
+        const events = session.events;
+        const count = (type) => events.filter(event => event.type === type).length;
+        console.log('[Tavern-PROBE] stage2 prestep spike:', JSON.stringify({
+            agentCreated: true,
+            provider,
+            model,
+            preStepFired,
+            preStepRejected,
+            turnStart: count('turn/start'),
+            turnEnd: count('turn/end'),
+            userMessage: count('user/message'),
+            assistantChunk: count('assistant/chunk'),
+            assistantMessage: count('assistant/message'),
+            turnEndReason: events.filter(event => event.type === 'turn/end').map(event => event.data.reason),
+            surfaceNodes: session.surface.nodes.length,
+            derivedMessages: session.deriveMessages().map(message => `${message.role}: ${textOf(message)}`),
+            logSize: events.length,
+        }, null, 2));
+        await handle.dispose();
+    });
+}
+//# sourceMappingURL=prestep-spike.js.map

package/lib/adapters/prestep-spike.js.map

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

package/lib/adapters/runtime-probe.d.ts

@@ -0,0 +1,67 @@
+/**
+ * DSH 服务发现与启动检测（阶段 0 的"真实接口探针"落地点）。
+ *
+ * 原则：不猜测 API 签名——在宿主启动时对每个关键服务做运行时存在性检查，
+ * 服务缺失或方法形状不符时抛出带 `[Tavern]` 前缀的明确错误，而不是在业务
+ * 层静默失败。所有 DSH 调用都必须经由本文件 + adapters 收敛，业务层不得
+ * 直接访问 `ctx.subagents` / `ctx.storageDomain` / `ctx.tools`。
+ *
+ * 探测清单（阶段 0 工作项 3）：
+ * - ctx.subagents.startContinuable / followup；
+ * - ctx.storageDomain.open + 运行时导出的 defineDomain / domainTable；
+ * - ctx.tools.register + 运行时导出的 defineTool。
+ * - captureApiSignature：采集上述 API 的运行时 typeof / arity / 返回证据。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SubagentRuntime } from '@deepseek-ai/dsh-subagent';
+import { defineDomain, domainTable, type DomainFacility } from '@deepseek-ai/dsh-storage-domain';
+import { defineTool, type ToolRuntime } from '@deepseek-ai/dsh-tools';
+/** 全部通过探测后得到的运行时表面，供 index.ts 的 composition root 使用。 */
+export interface TavernRuntimeSurface {
+    readonly subagents: SubagentRuntime;
+    readonly storageDomain: DomainFacility;
+    readonly tools: ToolRuntime;
+    readonly api: {
+        readonly defineDomain: typeof defineDomain;
+        readonly domainTable: typeof domainTable;
+        readonly defineTool: typeof defineTool;
+    };
+}
+/** 单个 API 的运行时形状：typeof 结果 + 形参个数（arity）。 */
+export interface ApiSignatureEntry {
+    readonly typeof: string;
+    readonly arity: number;
+}
+/** 真实 DSH API 签名快照（阶段 0 探针输出，供人工核对）。 */
+export interface TavernApiSignature {
+    readonly subagents: {
+        readonly startContinuable: ApiSignatureEntry;
+        readonly followup: ApiSignatureEntry;
+    };
+    readonly storageDomain: {
+        readonly open: ApiSignatureEntry;
+        readonly defineDomain: ApiSignatureEntry;
+        readonly defineDomainSample: unknown;
+        readonly domainTable: ApiSignatureEntry;
+        readonly domainTableSample: unknown;
+    };
+    readonly tools: {
+        readonly register: ApiSignatureEntry;
+        readonly defineTool: ApiSignatureEntry;
+    };
+}
+/**
+ * 采集真实 API 签名。defineDomain / domainTable 是纯函数（无 I/O），
+ * 用最小合法参数各调用一次，把运行时返回的证据一并纳入报告。
+ * 注意：domain/table 名必须匹配 UNIT_NAME_RE（/^[a-z][a-z0-9_]*$/，无短横线）。
+ */
+export declare function captureApiSignature(subagents: SubagentRuntime, storageDomain: DomainFacility, tools: ToolRuntime): TavernApiSignature;
+/** 探测 ctx.subagents：startContinuable / followup 必须存在。 */
+export declare function probeSubagents(ctx: Context): SubagentRuntime;
+/** 探测 ctx.storageDomain：open + storage hub + defineDomain/domainTable 运行时导出。 */
+export declare function probeStorage(ctx: Context): DomainFacility;
+/** 探测 ctx.tools：register + defineTool 运行时导出。 */
+export declare function probeTools(ctx: Context): ToolRuntime;
+/** 组合探测，返回可供业务层使用的运行时表面。 */
+export declare function probeRuntime(ctx: Context): TavernRuntimeSurface;
+//# sourceMappingURL=runtime-probe.d.ts.map

package/lib/adapters/runtime-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-probe.d.ts","sourceRoot":"","sources":["../../src/adapters/runtime-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAGrE,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;IACnC,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE;QACZ,QAAQ,CAAC,YAAY,EAAE,OAAO,YAAY,CAAA;QAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,WAAW,CAAA;QACxC,QAAQ,CAAC,UAAU,EAAE,OAAO,UAAU,CAAA;KACvC,CAAA;CACF;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,gBAAgB,EAAE,iBAAiB,CAAA;QAC5C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;KACrC,CAAA;IACD,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;QAChC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAA;QACxC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAA;QACpC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;QACvC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;KACpC,CAAA;IACD,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;QACpC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;KACvC,CAAA;CACF;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,eAAe,EAC1B,aAAa,EAAE,cAAc,EAC7B,KAAK,EAAE,WAAW,GACjB,kBAAkB,CAoBpB;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAa5D;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAgBzD;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAYpD;AAED,4BAA4B;AAC5B,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAU/D"}

package/lib/adapters/runtime-probe.js

@@ -0,0 +1,106 @@
+/**
+ * DSH 服务发现与启动检测（阶段 0 的"真实接口探针"落地点）。
+ *
+ * 原则：不猜测 API 签名——在宿主启动时对每个关键服务做运行时存在性检查，
+ * 服务缺失或方法形状不符时抛出带 `[Tavern]` 前缀的明确错误，而不是在业务
+ * 层静默失败。所有 DSH 调用都必须经由本文件 + adapters 收敛，业务层不得
+ * 直接访问 `ctx.subagents` / `ctx.storageDomain` / `ctx.tools`。
+ *
+ * 探测清单（阶段 0 工作项 3）：
+ * - ctx.subagents.startContinuable / followup；
+ * - ctx.storageDomain.open + 运行时导出的 defineDomain / domainTable；
+ * - ctx.tools.register + 运行时导出的 defineTool。
+ * - captureApiSignature：采集上述 API 的运行时 typeof / arity / 返回证据。
+ */
+import { defineDomain, domainTable } from '@deepseek-ai/dsh-storage-domain';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { z } from 'zod';
+function entryOf(fn) {
+    return { typeof: typeof fn, arity: fn.length };
+}
+/**
+ * 采集真实 API 签名。defineDomain / domainTable 是纯函数（无 I/O），
+ * 用最小合法参数各调用一次，把运行时返回的证据一并纳入报告。
+ * 注意：domain/table 名必须匹配 UNIT_NAME_RE（/^[a-z][a-z0-9_]*$/，无短横线）。
+ */
+export function captureApiSignature(subagents, storageDomain, tools) {
+    const defineDomainSample = defineDomain({ name: 'tavern_probe', version: 1, tables: {} });
+    const domainTableSample = domainTable(z.object({}));
+    return {
+        subagents: {
+            startContinuable: entryOf(subagents.startContinuable),
+            followup: entryOf(subagents.followup),
+        },
+        storageDomain: {
+            open: entryOf(storageDomain.open),
+            defineDomain: entryOf(defineDomain),
+            defineDomainSample,
+            domainTable: entryOf(domainTable),
+            domainTableSample,
+        },
+        tools: {
+            register: entryOf(tools.register),
+            defineTool: entryOf(defineTool),
+        },
+    };
+}
+/** 探测 ctx.subagents：startContinuable / followup 必须存在。 */
+export function probeSubagents(ctx) {
+    // ctx.get(name) 在服务未提供时返回 undefined（直接属性访问会抛错）。
+    const subagents = ctx.get('subagents');
+    if (subagents === undefined) {
+        throw new Error('[Tavern] 未找到 subagents 服务：请确认 bundle 已挂载 @deepseek-ai/dsh-subagent');
+    }
+    if (typeof subagents.startContinuable !== 'function') {
+        throw new Error('[Tavern] subagents.startContinuable 不存在或不是函数（DSH 版本不匹配？）');
+    }
+    if (typeof subagents.followup !== 'function') {
+        throw new Error('[Tavern] subagents.followup 不存在或不是函数（DSH 版本不匹配？）');
+    }
+    return subagents;
+}
+/** 探测 ctx.storageDomain：open + storage hub + defineDomain/domainTable 运行时导出。 */
+export function probeStorage(ctx) {
+    const storageDomain = ctx.get('storageDomain');
+    if (storageDomain === undefined) {
+        throw new Error('[Tavern] 未找到 storageDomain 服务：请确认 bundle 已挂载 @deepseek-ai/dsh-storage-domain');
+    }
+    if (typeof storageDomain.open !== 'function') {
+        throw new Error('[Tavern] storageDomain.open 不存在或不是函数（DSH 版本不匹配？）');
+    }
+    const storage = ctx.get('storage');
+    if (storage === undefined) {
+        throw new Error('[Tavern] 未找到 storage hub：请确认 bundle 已挂载 @deepseek-ai/dsh-storage');
+    }
+    if (typeof defineDomain !== 'function' || typeof domainTable !== 'function') {
+        throw new Error('[Tavern] defineDomain/domainTable 运行时导出缺失（@deepseek-ai/dsh-storage-domain 版本不匹配？）');
+    }
+    return storageDomain;
+}
+/** 探测 ctx.tools：register + defineTool 运行时导出。 */
+export function probeTools(ctx) {
+    const tools = ctx.get('tools');
+    if (tools === undefined) {
+        throw new Error('[Tavern] 未找到 tools 服务：请确认 bundle 已挂载 @deepseek-ai/dsh-tools');
+    }
+    if (typeof tools.register !== 'function') {
+        throw new Error('[Tavern] tools.register 不存在或不是函数（DSH 版本不匹配？）');
+    }
+    if (typeof defineTool !== 'function') {
+        throw new Error('[Tavern] defineTool 运行时导出缺失（@deepseek-ai/dsh-tools 版本不匹配？）');
+    }
+    return tools;
+}
+/** 组合探测，返回可供业务层使用的运行时表面。 */
+export function probeRuntime(ctx) {
+    const subagents = probeSubagents(ctx);
+    const storageDomain = probeStorage(ctx);
+    const tools = probeTools(ctx);
+    return {
+        subagents,
+        storageDomain,
+        tools,
+        api: { defineDomain, domainTable, defineTool },
+    };
+}
+//# sourceMappingURL=runtime-probe.js.map

package/lib/adapters/runtime-probe.js.map

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

package/lib/adapters/session-agent-provider.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Use infrastructure/dsh/session/session-agent-provider instead. */
+export * from '../infrastructure/dsh/session/session-agent-provider.js';
+//# sourceMappingURL=session-agent-provider.d.ts.map

package/lib/adapters/session-agent-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-agent-provider.d.ts","sourceRoot":"","sources":["../../src/adapters/session-agent-provider.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,cAAc,yDAAyD,CAAA"}

package/lib/adapters/session-agent-provider.js

@@ -0,0 +1,3 @@
+/** @deprecated Use infrastructure/dsh/session/session-agent-provider instead. */
+export * from '../infrastructure/dsh/session/session-agent-provider.js';
+//# sourceMappingURL=session-agent-provider.js.map

package/lib/adapters/session-agent-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-agent-provider.js","sourceRoot":"","sources":["../../src/adapters/session-agent-provider.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,cAAc,yDAAyD,CAAA"}

package/lib/adapters/subagent-gateway.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Use infrastructure/dsh/subagent/subagent-gateway instead. */
+export * from '../infrastructure/dsh/subagent/subagent-gateway.js';
+//# sourceMappingURL=subagent-gateway.d.ts.map

package/lib/adapters/subagent-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-gateway.d.ts","sourceRoot":"","sources":["../../src/adapters/subagent-gateway.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,cAAc,oDAAoD,CAAA"}

package/lib/adapters/subagent-gateway.js

@@ -0,0 +1,3 @@
+/** @deprecated Use infrastructure/dsh/subagent/subagent-gateway instead. */
+export * from '../infrastructure/dsh/subagent/subagent-gateway.js';
+//# sourceMappingURL=subagent-gateway.js.map

package/lib/adapters/subagent-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-gateway.js","sourceRoot":"","sources":["../../src/adapters/subagent-gateway.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,cAAc,oDAAoD,CAAA"}