@shgroup/dsh-serenity-hooks 1.59.2 → 1.59.3

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.59.2",
+  "version": "1.59.3",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——14 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 轨迹日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.7-rc.1 与 0.2.0-rc.1（双档，deepseek-ai/deepseek-harness）。",
   "engines": {

package/lib/host/access.d.ts

@@ -86,14 +86,27 @@ export declare function hostWeb(ctx: unknown): HostWeb | undefined;
 /**
  * `ctx.subagents`（lazy；v1.31.3：cheap-worker foreground 模式的委派正门）。
  *
- * 形状对照宿主 rc.1：`SubagentRuntime.start(name, request)` → `SubagentRun`
- * （`result` / `dispose` / `id`）。本模块只做形状收口；语义与错误处理归调用方。
+ * 🔴 **形状对照宿主 `0.2.1-rc.1`（v1.59.3 适配）**：旧成员 `start(name, request)` **已消失**，
+ *    改由 `startActivation(spec)` 承担（实名由 `spec.provider` 指定，我们仍传 `'spawn'`）。
+ *    - 旧：`start(name: string, request: SubagentStartRequest): Promise<SubagentRun>`
+ *    - 新：`startActivation(spec: SubagentActivationSpec): Promise<SubagentActivation>`（两个重载）
+ *    实测依据（**类型面与运行时都核过**，不是只看一边）：
+ *      `_tmp/host-0.2.1-rc.1/…/dsh-subagent/lib/types/index.d.ts:135,145` ＋
+ *      同包 `lib/index.js` 里**只有** `async startActivation(spec)`。
+ *  ⚠️ **两个方法都保留为可选**：本仓仍声明支持 `0.1.7-rc.1` 双档（`VERIFIED_HOST_BANDS`），
+ *    而 0.1.7 那代同样只有 `start` —— **删掉 `start` 会让旧档在类型面说谎**。
+ *    调用方按"先新后旧"选用，见 `cheap-worker.ts` 的 `resolveSubagentStarter()`。
+ *
+ * 本模块只做形状收口；语义与错误处理归调用方。
  *
  * 注（v1.31.4）：本服务**不在** dsp 的 `inject` 列表内，因此走 `hostInjected` 的
  * 回落分支（`ctx.get`）——见 `hostInjected` 的 v1.31.4 说明与真实 cordis 用例。
  */
 interface HostSubagents {
+    /** 宿主 `0.1.7-rc.*` / `0.2.0-rc.*`（旧形态；0.2.1-rc.1 起已移除） */
     start?: (name: string, request: unknown) => Promise<unknown>;
+    /** 宿主 `0.2.1-rc.1+`（新形态；`spec.provider` 即旧 `name`） */
+    startActivation?: (spec: unknown) => Promise<unknown>;
 }
 export declare function hostSubagents(ctx: unknown): HostSubagents | undefined;
 /**

package/lib/host/contract.d.ts

@@ -82,6 +82,14 @@ export declare const HOST_EVENTS: readonly HostEventContract[];
  *  - ⇒ 双档是**唯一不把本机宿主堵死的写法**（两档在真 semver 下均 PASS）。
  * 档上界取 `<0.2.0` / `<0.3.0`（即 `^0.2.0-rc.1` 的 caret 上界）：第二档同时覆盖
  * `0.2.0` 正式版与后续 `0.2.0-rc.N`。
+ *
+ * 🆕 **第三档 `^0.2.1-rc.1`（v1.59.3 适配，2026-10-17）** —— 为什么非加不可：
+ *  - npm 的 `^0.2.0-rc.1` 对**预发布**只放行**同一 `major.minor.patch`** 的 prerelease
+ *    ⇒ **`0.2.1-rc.1` 不满足它**（patch 位不同）⇒ 宿主门会**整包拒绝安装**（D98 同族）。
+ *  - 而第二档的 `ceiling: '0.3.0'` 本来就"包含" 0.2.1 —— 那是**我们自己的手写比较器**的语义；
+ *    两个判据（真 semver 门 vs 手写区间）在这里**给出相反答案**，故必须把第三档显式写出来，
+ *    让**派生串**（{@link REQUIRED_HOST_RANGE}）里真的出现 `^0.2.1-rc.1`。
+ *  ⚠️ **加档不是收窄**：前两档原样保留（0.1.7 / 0.2.0 两代仍被声明支持）。
  */
 export declare const VERIFIED_HOST_BANDS: readonly {
     floor: string;

package/lib/index.js

@@ -9178,12 +9178,68 @@ function parseForegroundJobs(raw) {
 	}
 	return jobs;
 }
+/**
+* 选出一个可用的"启动子 agent"函数（**先新后旧**）。
+*
+* 🔴 **为什么需要这一层**（v1.59.3 适配，2026-10-17）：
+*   宿主 `0.2.1-rc.1` **移除了** `SubagentRuntime.start(name, request)`，改由
+*   `startActivation(spec)` 承担；而 `0.1.7-rc.*` / `0.2.0-rc.*` **只有** `start`。
+*   本仓仍声明支持双档（`VERIFIED_HOST_BANDS`）⇒ **不能只留一边**。
+*
+* 形状差异（逐字取自两端 `.d.ts`）：
+*   · 旧：`start('spawn', {label?, prompt, parent, signal, agentOptions, toolFilter})`
+*   · 新：`startActivation({provider:'spawn', label, request:{prompt, parent, agentOptions}, signal, delivery})`
+*     —— 注意 `label` 在新 spec 里是**必填**（`readonly label: string`），故这里补默认值。
+*
+* @returns 一个统一签名的启动器；两者都不存在 ⇒ `undefined`（由调用方报**可诊断**的错）
+*/
+function resolveSubagentStarter(subagents) {
+	if (typeof subagents.startActivation === "function") {
+		const fn = subagents.startActivation;
+		return (req) => fn({
+			provider: "spawn",
+			label: req.label,
+			request: {
+				prompt: req.prompt,
+				parent: req.parent,
+				agentOptions: req.agentOptions,
+				...req.cwd === void 0 ? {} : { cwd: req.cwd }
+			},
+			signal: req.signal,
+			delivery: "caller"
+		});
+	}
+	if (typeof subagents.start === "function") {
+		const fn = subagents.start;
+		return (req) => fn("spawn", {
+			label: req.label,
+			prompt: req.prompt,
+			parent: req.parent,
+			signal: req.signal,
+			agentOptions: req.agentOptions,
+			toolFilter: { deny: ["cheap-worker"] },
+			...req.cwd === void 0 ? {} : { cwd: req.cwd }
+		});
+	}
+}
 /** 拼接 SubagentResult.output（ContentBlock[]）中的文本块 */
 function subagentOutputText(output) {
 	if (!Array.isArray(output)) return "";
 	return output.filter((b) => typeof b === "object" && b !== null).filter((b) => b.type === "text" && typeof b.text === "string").map((b) => b.text).join("");
 }
 /**
+* 任务首行 → 子会话 label（截断）。
+*
+* 🔴 为什么必须有一个：新宿主 `SubagentActivationSpec.label` 是**必填**（`readonly label: string`），
+*   而我们对外把 `label` 当可选参数 ⇒ 缺省时必须自己造一个，否则 spec 不合法。
+*   取任务首行而不是空串：子会话在列表里要能被人认出来（空串等于没有标识）。
+*/
+function firstLineLabel(task) {
+	const line = task.split(/\r?\n/)[0]?.trim() ?? "";
+	const clipped = line.length > 60 ? `${line.slice(0, 60)}…` : line;
+	return clipped === "" ? "task" : clipped;
+}
+/**
 * providerPreflight — 在**创建任何 worker 之前**判定「本机有没有该 provider 的 adapter」。
 *
 * 返回**可执行**的错误文本；`null` = 可用，**或无法取证**（服务缺失 / 形状不符 / 读取抛错
@@ -9231,7 +9287,8 @@ async function runForegroundJob(ctx, opts) {
 	const { task, label, model, models, parent, signal } = opts;
 	requireWhitelistedModel(model, models);
 	const subagents = hostSubagents(ctx);
-	if (!subagents?.start) throw new Error("cheap-worker: host subagents service unavailable — neither ctx.subagents nor ctx.get(\"subagents\") yielded a start() function. Check `dashboard health` (host-contract section, service \"subagents\").");
+	const starter = subagents === void 0 ? void 0 : resolveSubagentStarter(subagents);
+	if (starter === void 0) throw new Error("cheap-worker: host subagents service unavailable — neither ctx.subagents.startActivation (0.2.1-rc.1+) nor ctx.subagents.start (0.1.7-rc.* / 0.2.0-rc.*) yielded a starter function. Check `dashboard health` (host-contract section, service \"subagents\").");
 	const preflight = providerPreflight(ctx, model);
 	if (preflight !== null) return {
 		mode: "foreground",
@@ -9242,8 +9299,8 @@ async function runForegroundJob(ctx, opts) {
 		diagnostic: preflight
 	};
 	const { provider, model: modelName } = splitModel(model);
-	const run = await subagents.start("spawn", {
-		...label === void 0 ? {} : { label },
+	const run = await starter({
+		label: label ?? firstLineLabel(task),
 		prompt: [{
 			type: "text",
 			text: task
@@ -9253,8 +9310,7 @@ async function runForegroundJob(ctx, opts) {
 		agentOptions: {
 			...provider === void 0 ? {} : { provider },
 			model: modelName
-		},
-		toolFilter: { deny: ["cheap-worker"] }
+		}
 	});
 	try {
 		const result = run.result === void 0 ? {} : await run.result;
@@ -9265,7 +9321,7 @@ async function runForegroundJob(ctx, opts) {
 			model,
 			stopReason,
 			output: subagentOutputText(result.output),
-			...typeof run.id === "string" ? { childId: run.id } : {},
+			...typeof (run.childId ?? run.id) === "string" ? { childId: run.childId ?? run.id } : {},
 			...typeof result.diagnostic === "string" && result.diagnostic !== "" ? { diagnostic: result.diagnostic } : {}
 		};
 	} finally {
@@ -16124,14 +16180,29 @@ const HOST_SERVICES = [
 *  - ⇒ 双档是**唯一不把本机宿主堵死的写法**（两档在真 semver 下均 PASS）。
 * 档上界取 `<0.2.0` / `<0.3.0`（即 `^0.2.0-rc.1` 的 caret 上界）：第二档同时覆盖
 * `0.2.0` 正式版与后续 `0.2.0-rc.N`。
+*
+* 🆕 **第三档 `^0.2.1-rc.1`（v1.59.3 适配，2026-10-17）** —— 为什么非加不可：
+*  - npm 的 `^0.2.0-rc.1` 对**预发布**只放行**同一 `major.minor.patch`** 的 prerelease
+*    ⇒ **`0.2.1-rc.1` 不满足它**（patch 位不同）⇒ 宿主门会**整包拒绝安装**（D98 同族）。
+*  - 而第二档的 `ceiling: '0.3.0'` 本来就"包含" 0.2.1 —— 那是**我们自己的手写比较器**的语义；
+*    两个判据（真 semver 门 vs 手写区间）在这里**给出相反答案**，故必须把第三档显式写出来，
+*    让**派生串**（{@link REQUIRED_HOST_RANGE}）里真的出现 `^0.2.1-rc.1`。
+*  ⚠️ **加档不是收窄**：前两档原样保留（0.1.7 / 0.2.0 两代仍被声明支持）。
 */
-const VERIFIED_HOST_BANDS = [{
-	floor: "0.1.7-rc.1",
-	ceiling: "0.2.0"
-}, {
-	floor: "0.2.0-rc.1",
-	ceiling: "0.3.0"
-}];
+const VERIFIED_HOST_BANDS = [
+	{
+		floor: "0.1.7-rc.1",
+		ceiling: "0.2.0"
+	},
+	{
+		floor: "0.2.0-rc.1",
+		ceiling: "0.3.0"
+	},
+	{
+		floor: "0.2.1-rc.1",
+		ceiling: "0.3.0"
+	}
+];
 /**
 * 与 `package.json` 的 `peerDependencies` **逐字同串**的宿主版本范围（由 {@link VERIFIED_HOST_BANDS} 派生）。
 *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.59.2",
+  "version": "1.59.3",
   "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：14 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.7-rc.1 与 0.2.0-rc.1（双档）。",
   "license": "MIT",
   "repository": {
@@ -67,22 +67,22 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh-acp": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-agent": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-agent-preset-registry": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-compaction": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-session-title": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-shell": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-shell-env": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-skill": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-tools": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-web": "^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-web-fetch-http": "^0.1.7-rc.1 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-acp": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-agent": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-agent-loop": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-agent-preset-registry": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-compaction": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-shell": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-shell-env": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-skill": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-web": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-web-fetch-http": "^0.1.7-rc.1 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
     "@deepseek-ai/schemastery": "^3.18.4",
     "cordis": "^4.0.0-rc.7"
   },