@shgroup/dsh-serenity-hooks 1.31.7 → 1.31.9

package/README.md

@@ -317,7 +317,7 @@ AI 一次能"记住"的内容有上限。满了不用你手动开新会话：
 
 ```bash
 pnpm typecheck          # 类型检查（node + 浏览器端两套）
-pnpm test               # 全量测试（当前 78 个文件 / 1169 个用例）
+pnpm test               # 全量测试（当前 80 个文件 / 1176 个用例）
 pnpm build              # 打包（lib/index.js + client.js）
 ```
 
@@ -381,4 +381,4 @@ pnpm build              # 打包（lib/index.js + client.js）
 
 MIT（见 [LICENSE](https://github.com/tellmewhattodo/dsh-serenity-plugin/blob/master/LICENSE)）
 
-> **版本**：v1.31.7 ｜ **前置**：DSH 0.1.5-rc.1+ / Node ≥ 20 或 bun ｜ **测试**：78 个文件 / 1169 个用例
+> **版本**：v1.31.9 ｜ **前置**：DSH 0.1.5-rc.1+ / Node ≥ 20 或 bun ｜ **测试**：80 个文件 / 1176 个用例

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.31.7",
+  "version": "1.31.9",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——11 个工具（container_fs/logbook/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/autopilot-trajectory/im-bridge）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/自主巡航。适配 DSH 0.1.5-rc.1（deepseek-ai/deepseek-harness）。",
   "engines": {

package/lib/client.js

@@ -461,22 +461,22 @@ window.__ModuleLoader__.load({
 			const inputActions = props.inputActions;
 			const handlingRef = (0, react.useRef)(false);
 			const promptError = session?.promptError?.error;
-			const imageIds = input?.imageIds ?? [];
+			const attachmentIds = input?.attachmentIds ?? [];
 			(0, react.useEffect)(() => {
 				if (handlingRef.current || !isImageFallbackTrigger(promptError?.code, promptError?.details?.reason)) return;
-				if (imageIds.length === 0) return;
+				if (attachmentIds.length === 0) return;
 				handlingRef.current = true;
 				(async () => {
 					try {
-						const files = await getDraftFiles(String(sessionId), imageIds);
+						const files = await getDraftFiles(String(sessionId), attachmentIds);
 						if (files.length === 0) throw new Error("no draft image files");
 						const saved = [];
 						for (const file of files) saved.push(await uploadImage(file, String(sessionId)));
 						const note = imageNoteTemplate(saved);
 						const draft = input?.draft ?? "";
 						const text = draft === "" ? note : `${draft}\n${note}`;
-						if (inputActions?.removeImage !== void 0 && inputActions.setDraft !== void 0 && inputActions.submit !== void 0) {
-							for (const id of imageIds) inputActions.removeImage(String(id));
+						if (inputActions?.removeAttachment !== void 0 && inputActions.setDraft !== void 0 && inputActions.submit !== void 0) {
+							for (const id of attachmentIds) inputActions.removeAttachment(id);
 							inputActions.setDraft(text);
 							inputActions.submit();
 						} else await resendText(String(sessionId), text);
@@ -488,7 +488,7 @@ window.__ModuleLoader__.load({
 				})();
 			}, [
 				promptError,
-				imageIds,
+				attachmentIds,
 				sessionId,
 				uploadImage,
 				getDraftFiles,

package/lib/host/contract.d.ts

@@ -55,7 +55,7 @@ export interface HostEventContract {
  * 在名字写错/宿主改名时**编译失败**（v1.30.7，review F-04/F-05）。
  * 该 import 为 type-only，编译期擦除，不产生运行时依赖。
  */
-export declare const HOST_EVENT_NAMES: readonly ["agent/session-start", "agent/pre-step", "agent/turn-stopping", "agent/status", "agent/inbox/inserted", "session/event", "session/created", "tools/pre-execute", "tools/post-execute", "system-prompt/assemble"];
+export declare const HOST_EVENT_NAMES: readonly ["agent/session-start", "agent/pre-step", "agent/turn-stopping", "agent/status", "agent/inbox/inserted", "agent/disposed", "session/event", "session/created", "session/disposed", "settings/updated", "tools/pre-execute", "tools/post-execute", "system-prompt/assemble"];
 export type HostEventName = (typeof HOST_EVENT_NAMES)[number];
 /**
  * dsp 订阅的宿主事件清单（与 HOST_EVENT_NAMES 同源；impact/site 供 health 报告与文档）。

package/lib/host/type-contract.d.ts

@@ -0,0 +1,44 @@
+/**
+ * host/type-contract.ts — 宿主**类型**契约（编译期反证层，v1.31.8，S142 全量 review 产物）
+ *
+ * ## 为什么存在（R↓）
+ *
+ * dsp 用**结构化断言**隔离宿主（手写 interface + `as` / `as never`，零宿主运行时 import），
+ * 换来 peer-only 打包与"不随宿主版本耦合"的灵活度；代价是**类型检查对宿主漂移失明**：
+ * 宿主把成员改名、改返回形状，dsp 侧拿不到任何编译期信号，只能靠**人读宿主源码**发现。
+ *
+ * 历史已三次静默失效：
+ *  - `Session.events` → `snapshotEvents()`（v1.28.0）
+ *  - `conversation.draftImages()` → `resolveDraftAttachments()`（v1.31.6）
+ *  - `sessionPersistence.list()` 返回形状 `SessionHeader[]`（`h.cwd`）→
+ *    `SessionPersistenceSnapshot[]`（`h.header.cwd`）（v1.31.6）
+ * 后两条是升级 0.1.5-rc.1 时**逐文件人读**才挖出来的——不是机制发现的。
+ *
+ * ## 既有三道防线的盲区（2026-09-10 全量 review 结论）
+ *
+ * | 防线 | 覆盖 | 盲区 |
+ * |------|------|------|
+ * | `contract.ts` 的 `satisfies keyof Events` | 事件**名** | payload 形状 |
+ * | `probeHostContract`（运行期） | 服务**名** + 成员**存在性** | 成员**签名**、**返回形状** |
+ * | `tests/**` | —— | **完全不参与类型检查**（tsconfig `include: ["src"]`）→ 写在测试里的"真实宿主类型断言"从未生效 |
+ *
+ * ## 本模块补的那一格：用宿主真实类型反证 dsp 的形状假设
+ *
+ * 机制：
+ *  ① `import type {} from '<宿主包>'` 把该包的 `declare module '@deepseek-ai/cordis'` 声明增强
+ *     拉进 program（**空类型 import，编译期擦除 → 零运行时依赖**，peer-only 打包不受影响；
+ *     与 `src/client/index.ts` 引 `dsh-client-ui-session` 同款手法）
+ *  ② 每条 `Expect<Extends<宿主真相, dsp 假设>>` 是一道**编译期闸门**：宿主改名/改形状 →
+ *     `dsh-develop typecheck` 当场红，升级当天报警，而不是等线上静默失效
+ *  ③ 换宿主版本时 `dsh-develop typecheck-host <ver>` 会对**解包的新宿主**跑同一批断言
+ *
+ * ## 维护纪律（强制）
+ *
+ * **新增一处对宿主的形状依赖 → 在此加一条对应闸门**（断言旁注明 dsp 消费点与后果）。
+ * 断言只表达 dsp **真正依赖**的那部分（不求与宿主全等）→ 宿主新增字段/放宽类型不会误报，
+ * 只有"dsp 依赖的东西没了或变了"才红。
+ *
+ * 注：本文件**没有任何运行时语句**，编译产物只有 `export {}`，不影响包体行为。
+ */
+/** 哨兵：确保本模块不是空文件被 tree-shake 掉（无运行时副作用，值为类型） */
+export type HostTypeContractSatisfied = true;

package/lib/index.js

@@ -8623,10 +8623,22 @@ async function queueRebuild(ctx, opts) {
 function performRebuild(session, pending, meter) {
 	const nodes = [...session.surface.nodes];
 	if (nodes.length === 0) return false;
+	/**
+	* v1.31.8 二次修正（0.1.5-rc.1 实证，diag 原文）：
+	* `surface replace: node 0 holds the system prompt and may be rewritten only by a
+	*  system/message over exactly that node`（宿主 `dsh-session/lib/types/surface.js`
+	* `assertSystemHeadRewrite`）。
+	*
+	* → **surface node 0 是系统提示节点且被宿主保护**；而重建的语义恰恰是"保留系统提示、
+	*   只清对话历史"，故替换范围必须从 **node 1** 起。（旧实现整体替换 `nodes[0..last]`，
+	*   在 0.1.5 上必被拒——这是 §14 之后的第二条 rebuild 阻断规则。）
+	*/
+	const targets = nodes.slice(1);
+	if (targets.length === 0) return false;
 	if (meter) {
 		let shadowedTokenCount = 0;
 		const events = sessionEvents(session);
-		for (const seq of nodes) {
+		for (const seq of targets) {
 			const event = events[seq];
 			if (!event) continue;
 			const message = deriveEventMessage(event);
@@ -8634,10 +8646,10 @@ function performRebuild(session, pending, meter) {
 		}
 		session.append("compaction/prune", {
 			shadowedRange: {
-				start: nodes[0],
-				end: nodes[nodes.length - 1]
+				start: targets[0],
+				end: targets[targets.length - 1]
 			},
-			shadowedSeqs: nodes,
+			shadowedSeqs: targets,
 			shadowedTokenCount
 		});
 	}
@@ -8650,10 +8662,10 @@ function performRebuild(session, pending, meter) {
 	}, {
 		surfaceOp: {
 			op: "replace",
-			start: nodes[0],
-			end: nodes[nodes.length - 1]
+			startSeq: targets[0],
+			endSeq: targets[targets.length - 1]
 		},
-		sourceEventSeqs: nodes
+		sourceEventSeqs: targets
 	});
 	return true;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.31.7",
+  "version": "1.31.9",
   "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：11 个工具（container_fs/logbook/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/autopilot-trajectory/im-bridge）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/自主巡航。适配 DSH 0.1.5-rc.1。",
   "license": "MIT",
   "repository": {