dsh-llm-verifier 0.9.5 → 0.10.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.10.0 - 2026-10-17
+- **[DSH 0.2.1-alpha.5] 对齐宿主并采用新版兼容声明**
+  - 新增顶层 `engines.dsh`，供 0.2.1-alpha.3+ 宿主与插件市场优先读取；8 条 `@deepseek-ai/dsh-*` peer 保留为旧宿主回退，两套范围均覆盖 `0.2.1-alpha.1`–`alpha.5` 且由回归测试强制一致
+  - DSH 开发依赖精确锁定 `0.2.1-alpha.5`，避免 npm `next` 的 `0.2.1-rc.1` 被未审查地纳入类型门禁；`@deepseek-ai/cordis` 同步到 `4.0.5-alpha.2`，`pnpm peers check` 全绿
+- **[修复] 子 Agent 动态在途探针改用真实执行状态**
+  - 不再把 `subagents.listChildren()` 的持久目录项误读为 `kind/activity` 活动记录；改用 `AgentRegistry.list()` 按父子关系发现运行中的后代，并以 visited 集合防环
+  - 旧 Job-backed 回退按宿主契约修正为 `jobs.list(agent.id)`；新版 managed activation 继续复用既有启动回执与 `subagent-settled` 日志判定，不把所有后台 Job 纳入门控
+- **[新能力评估] 不为换新而替换稳定路径**
+  - 话题侧车不迁到实验性的 `appendPluginRecord()`；裁判传输不改写为 `prepareCall()`；PTC 展示 `meta` 不作为模型证据；`working-directory/change` 不改变侧车归属
+  - `index.test.ts` 新增清单一致性与 Agent/Job 动态探针回归
+
 ## 0.9.5 - 2026-10-15
 
 - **[UI / 打包] 补上插件包图标**

package/README.md

@@ -98,7 +98,7 @@ DSH 0.1.7 又搬动了两处判定地基，两侧形态插件都读：
 
 客户端面（Web 设置页与看板）另有两处只随新版本线变化：提供 `ctx.slots` 的包是 `@deepseek-ai/dsh-client-ui-renderer`（`@deepseek-ai/dsh-client-runtime` 在 0.1.2 就已删除，插件类型一律取自 `@deepseek-ai/cordis` 的 `Context`）；宿主图标名在 0.1.7 整体由尺寸后缀改为笔画后缀。图标是具名导入、且该模块对客户端 bundle 是 external，一份源码无法同时满足两套名字，因此插件改为按名探测两种拼写、都缺失时渲染空——旧宿主不会因此白屏。
 
-typecheck 门禁按 `package.json` 的 `devDependencies` 解析，已随宿主推进到 `0.2.0-rc.2`（此前从 `0.1.1-rc.2` 上移到 `0.1.7-alpha.1` 并持续推进）：客户端面的图标名在 0.1.7 才改名，一份源码只能对齐一侧，宿主面的旧形态兼容由运行时代码与回归测试保证。从 `0.1.7-alpha.1` 到 `0.1.7-rc.1` 的宿主改动对本插件消费的所有宿主面**全是加法**（`tools/pre-execute` 侧只新增可选 `projectContent`，`dsh-session` / `dsh-llm` / `dsh-settings` / `dsh-agent` / `dsh-credentials` / 客户端槽位与图标包源码零改动），因此这一步只换版本线，不动插件代码。
+typecheck 门禁按 `package.json` 的 `devDependencies` 解析，已随宿主推进并**精确锁定**到 `0.2.1-alpha.5`（此前从 `0.1.1-rc.2` 上移到 `0.1.7-alpha.1` 并持续推进）：客户端面的图标名在 0.1.7 才改名，一份源码只能对齐一侧，宿主面的旧形态兼容由运行时代码与回归测试保证。本次 npm `next` 已是更高的 `0.2.1-rc.1`，所以开发依赖不用 caret，避免门禁悄悄浮到尚未逐 tag 审查的版本。从 `0.1.7-alpha.1` 到 `0.1.7-rc.1` 的宿主改动对本插件消费的所有宿主面**全是加法**（`tools/pre-execute` 侧只新增可选 `projectContent`，`dsh-session` / `dsh-llm` / `dsh-settings` / `dsh-agent` / `dsh-credentials` / 客户端槽位与图标包源码零改动），因此这一步只换版本线，不动插件代码。
 
 `0.1.7-rc.2` 同样只换版本线：这一版给宿主加了「动态工具更新」机制，对插件全是新增的可选面（`dsh-llm` 的 `GenerateOptions.toolHistory?` 与 `ToolUpdate`、`dsh-session` 的 `Session.toolHistory()`、`dsh-tools` 的 `PreToolDecision.ask.displayReason?`）。插件不消费这套机制，宿主新增的事件与块类型也读不到它：宿主在工具名变化时追加的 `developer/message`（`role: 'developer'`，内容为 `tool-addition` / `tool-removal` 块）不属于观测证据，插件的 `if/else` 分发自然跳过它们；验收的"过期"判定只统计有结果的工具调用与 PTC 派发，因此这类中途追加的消息不会让已完成的验收失效。另需注意 DeepSeek provider 在这一版裂成两个包（`llm-deepseek-api-key` 与 `llm-deepseek-account`），但 profile 里的**条目 id 仍是 `llm-deepseek`**，设置命名空间与其中的 `baseURL` / `apiKeyEnv` 都没变，直连 logprobs 通道照常读到；新增的 `deepseek-account` provider 走账号令牌、没有 API key，直连通道对它不适用，按设计降级到显式标签通道。
 
@@ -106,6 +106,12 @@ typecheck 门禁按 `package.json` 的 `devDependencies` 解析，已随宿主
 
 `0.2.0-rc.2` 同样是只换版本线：宿主落地「计时用户提问的两阶段结算」（前台超时返回 pending 工具结果，迟到回答以 `source.kind: 'user-question-reply'` 的 user-role 消息 steer 注入）与「定时提醒固定 framing」（消息以 `source.kind: 'schedule'` 注入），插件的 `session.ts`（`extractSession`）与 `router.ts`（`latestDirectUserSeq`）任务边界识别保持只认 `user` 与 `team-message`，迟到回答与定时提醒天然不会被误认为任务边界或任务陈述；`api/remotes` 新增挂载 `userQuestionsRemote`，`ui-primitives` 新增导出 `MenuGroup`，对插件均为可选/无破坏性增强，插件源码零改动。
 
+`0.2.1-alpha.1`–`alpha.5` 的对齐包含三项实际改动：
+
+- **兼容声明与依赖**：新增顶层 `engines.dsh`，供新版宿主兼容检查与插件市场读取；8 条 `@deepseek-ai/dsh-*` peer 保留为旧宿主回退，三者使用同一范围。开发依赖精确锁到 `0.2.1-alpha.5`，`@deepseek-ai/cordis` 同步到本地宿主要求的 `4.0.5-alpha.2`，`pnpm peers check` 不再有不满足项。
+- **子 Agent 在途探针**：新版 managed activation 不再使用 Job-backed delegation，现有 `started subagent <id>` / `subagent-settled` 日志判定保持不变。动态补充探针不再把 `listChildren()` 的持久目录项误当活动状态，改用 `AgentRegistry.list()` 检查运行中的后代；旧 Job 回退则按宿主契约修正为 `jobs.list(agent.id)`。
+- **新 API 取舍**：不把侧车迁到实验性的 `appendPluginRecord()`（格式迁移只尽力保留），不把裁判调用改为 `prepareCall()`（现有明确参数、直连 logprobs 与旧宿主回退没有收益），也不把 PTC 新增的展示用 `meta` 当作模型证据。
+
 其中一处更隐蔽的差异是 `deepFreeze`：0.1.1 的 `@deepseek-ai/dsh-llm` 会重新导出它，0.1.5 已把它移到 `@deepseek-ai/dsh-util-values`。插件因此自带一份等价的兜底实现，并同样**放过 `AbortSignal`**——冻结那个还在重试循环里使用、尚未被订阅的信号，会让传输层首次 `addEventListener`（Node ≥26.5）或超时/取消时的 `controller.abort()`（所有 Node 版本）抛 `Cannot assign to read only property`。
 
 ### 发布到 npm
@@ -114,7 +120,7 @@ typecheck 门禁按 `package.json` 的 `devDependencies` 解析，已随宿主
 
 发布内容由 `package.json` 的 `files` 字段决定：`lib`（构建产物、source map 与 `lib/types` 类型声明）、`src`、`cordis.patch.yml`、`README.md`。`tsconfig.local.json` 之类的本机文件不会进入 tarball。
 
-`peerDependencies` 中逐个列出的 `^0.1.5-alpha.1`、`^0.1.7-alpha.1`、`^0.1.7-rc.1` 等预发布范围是必需的，而且从 DSH 0.1.7-rc.1 起**由宿主强制执行**：按 semver 规则，预发布版本只有在同一 `x.y.z` 段存在带预发布的比较符时才算满足，因此不能简化成 `>=0.1.1-rc.2 <0.2.0`（那样会漏掉 `0.1.2-alpha.*`、`0.1.5-rc.*`、`0.1.7-alpha.*` 等宿主）。宿主启动 profile 时对每一个 `@deepseek-ai/dsh` / `@deepseek-ai/dsh-*` 条目跑 `semver.satisfies(运行版本, 范围, { includePrerelease: true })`，**任何一条不满足**就把该插件行停用（bundle 层直接跳过整个 bundle），并在 stderr 写出原因。所以缺少某条宿主版本线的后果不是"少个功能"，而是**插件整体不加载**；应急可用 `dsh plugin allow-version` 为该插件的精确版本做一次性豁免。当前声明覆盖到 `0.2.0-rc.2`，与本机 `dsh --version` 报告的运行版本一致。
+`engines.dsh` 与 `peerDependencies` 中逐个列出的预发布范围都是必需的，而且从 DSH 0.1.7-rc.1 起**由宿主强制执行**：0.2.1-alpha.3 起，包自己的 `engines.dsh` 单独决定兼容性并忽略 DSH peers；该字段缺失时才回退为逐个检查 `@deepseek-ai/dsh` / `@deepseek-ai/dsh-*` peer。本插件保留两套完全相同的声明以覆盖新旧宿主，并用回归测试防止它们漂移。按 semver 规则，预发布版本只有在同一 `x.y.z` 段存在带预发布的比较符时才算满足，因此不能简化成 `>=0.1.1-rc.2 <0.2.0`（那样会漏掉 `0.1.2-alpha.*`、`0.1.5-rc.*`、`0.1.7-alpha.*` 等宿主）。判定使用 `semver.satisfies(运行版本, 范围, { includePrerelease: true })`，任何一条不满足就把插件行停用（bundle 层直接跳过整个 bundle），并在 stderr 写出原因；应急可用 `dsh plugin allow-version` 做精确版本豁免。当前声明覆盖到 `0.2.1-alpha.5`，与本机 checkout 一致；`@deepseek-ai/cordis` 不参与这道宿主门禁，但仍须满足包管理器的 peer 解析。
 
 统计数据有两条传输路径：优先走 `/api/llm-verifier/statistics`（Connection 的 exact Fetch 路由，带 Host/Origin 栅栏与浏览器鉴权），宿主较旧时回落到插件自己的 `/llm-verifier` RPC 通道（同样经过鉴权）。裸的 webServer 路由已被移除。
 

package/lib/index.js

@@ -4983,26 +4983,46 @@ const PROBE_B = "The test should pass now.";
 /** Bound the probe: a diagnostics button must not sit on the configured 5-minute timeout plus retries. */
 const PROBE_TIMEOUT_MS = 3e4;
 /**
-* Probe live host runtime services for subagents or background jobs owned by the agent that remain active.
+* Probe live Agent and Job registries for delegated work owned by the agent that remains active.
 *
-* Probed at runtime without hardcoded version assumptions, gracefully degrading if services are missing.
+* Catalog readers are not execution-state APIs: `listChildren()` returns durable identities, while
+* `listDescendants().activity` reports Session residency rather than unfinished work. Runtime probes
+* gracefully degrade when a registry is missing; the Session log remains the other evidence source.
 * @param ctx - plugin Context.
 * @param agent - calling Agent.
 * @param signal - cancellation signal.
-* @returns True when live subagents or background jobs are actively running.
+* @returns True when live subagents or legacy Job-backed subagents are actively running.
 */
 async function hasLiveActiveSubagents(ctx, agent, signal) {
+	if (signal?.aborted) return false;
 	try {
-		const subagents = (typeof ctx.get === "function" ? ctx.get("subagents") : void 0) ?? ctx.subagents;
-		if (typeof subagents?.listChildren === "function") {
-			const children = await subagents.listChildren(agent.id, signal);
-			if (Array.isArray(children) && children.some((entry) => entry.kind === "child" && (entry.activity === "running" || entry.status === "running"))) return true;
+		const registry = (typeof ctx.get === "function" ? ctx.get("agents") : void 0) ?? ctx.agents;
+		if (typeof registry?.list === "function") {
+			const childrenOf = /* @__PURE__ */ new Map();
+			for (const child of registry.list()) {
+				const { parentSession, origin } = child.session.header;
+				if (parentSession === void 0 || origin !== "subagent") continue;
+				const siblings = childrenOf.get(parentSession) ?? [];
+				siblings.push(child);
+				childrenOf.set(parentSession, siblings);
+			}
+			const pending = [agent.id];
+			const visited = /* @__PURE__ */ new Set();
+			while (pending.length > 0) {
+				const parentId = pending.shift();
+				if (visited.has(parentId)) continue;
+				visited.add(parentId);
+				for (const child of childrenOf.get(parentId) ?? []) {
+					if (child.status === "running") return true;
+					pending.push(child.id);
+				}
+			}
 		}
 	} catch {}
 	try {
 		const jobs = (typeof ctx.get === "function" ? ctx.get("jobs") : void 0) ?? ctx.jobs;
 		if (typeof jobs?.list === "function") {
-			const list = jobs.list(agent);
+			const list = jobs.list(agent.id);
 			if (Array.isArray(list) && list.some((job) => (job.status === "running" || job.status === "stopping") && (job.kind === "subagent" || job.kind === void 0))) return true;
 		}
 	} catch {}