@shgroup/dsh-serenity-hooks 1.46.0 → 1.47.0

package/lib/unattended-seam.d.ts

@@ -0,0 +1,49 @@
+/**
+ * unattended-seam.ts — 无人值守代理回复的**拦截缝**（S142 **D77**，owner 2026-09-23 令「我需要的是一个机制」）
+ *
+ * ## 停在哪、怎么接（设计 §4 的裁决：**A 的通道 ＋ B 的措辞**）
+ *
+ * 复用的是**已验证过的**通道——`agent/turn-stopping`（serial）里 `agent.steer()`：
+ * 宿主语义 = "**listener 反对就打回**，机器重读 inbox：有新 steer ⇒ 再跑一步，没有 ⇒ 关轮"
+ * （`host/contract.ts` 的 `HOST_EVENTS` 原文）。因此：
+ * · **轮不结束**（语义正是"有人打回"）⇒ **零新机械**；
+ * · 文本**写成代理用户的话**（B 的措辞）+ **首句自报身份**（owner 已裁）。
+ *
+ * 模板 = `output-guard-seam.ts`（同一缝位、同一 `createUserMessage + PLUGIN_SOURCE` 形态）。
+ *
+ * ## 🔴「这轮是不是真实用户发起的」怎么判（本机制**唯一**的新机械；2026-09-23 取证）
+ *
+ * 交接块把它列为"动手前必须先查清的一件事"，取证结论（读宿主类型面，非猜测）：
+ *
+ * | 事实 | 出处 |
+ * |---|---|
+ * | 每条进入 inbox 的消息都发 `agent/inbox/inserted { agent, message }`；**在轮内离开 inbox 时**发 `agent/inbox/claimed { agent, message, turn }` | `@deepseek-ai/dsh-agent` README（Inbox 段）＋ `runtime-types.d.ts` |
+ * | `claimed.turn` = **拥有该消息的那一轮**；`turn-stopping.turn` = **即将关闭的那一轮** ⇒ 两者同编号可直接比对 | `runtime-types.d.ts` 同一文件两处 `turn` 声明 |
+ * | 消息来源可辨：`MessageSourceMap` 里**真实用户** = `kind: 'user'`（`user` ／ `user-rpc` 两种形态**同 kind**）；**ACC 自己注入**的一律 `kind: 'plugin:dsh-serenity-hooks'`（v1.47.0 改；旧值 = `'plugin'`） | `@deepseek-ai/dsh-llm` `src/message.ts` 的 `MessageSourceMap`（合并和类型）＋ 本仓 `message-source.ts`（**唯一**声明处与常量处） |
+ *
+ * ⇒ **判据 = 「这一轮 claim 到的消息里，有没有 `source.kind === 'user'`」**。
+ * 没有现成信号时本可退化为"记账法"（我们知道自己投过什么），**但不必**：宿主已给出一手信号。
+ *
+ * ## 🔴 为什么"用户发起的轮"要跳过（这是设计 §3-③ 的本意，别当成漏洞）
+ *
+ * 用户**刚说完话**⇒ 人就在跟前，代理插话既是冒充也是浪费。**"用户说完走开"那种情形**
+ * 由**绳（长周期保险丝）／其它非用户发起的唤醒**覆盖：那条轮**不是**用户发起的 ⇒ 代理接手，
+ * 一路推进到**合法收束**。⇒ 两个机制合起来才等于"用户走开后会话还能自己跑完"。
+ *
+ * ## 🔴 铁律（与 `unattended-ops.ts` 同族）
+ *
+ * **本模块的任何失败都不得影响 turn 收尾**：所有 handler 包 try/catch，异常只记一行 console。
+ */
+import type { Context } from 'cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+/**
+ * 装配无人值守代理缝（`index.ts` apply 调用）。
+ *
+ * 订阅三个事件（**都已在 `host/contract.ts` 白名单里**，新增的 `agent/inbox/claimed` 同批登记）：
+ * · `agent/inbox/claimed` —— 记「真实用户发起的轮次」；用户回来时**让位**（清代理段 + 记流水）;
+ * · `agent/turn-stopping` —— 判定 + 注入（本机制主体）；
+ * · `agent/disposed` / `session/disposed` —— 载体销毁清表（**本容器栽过 5 次"只增不清"**）。
+ */
+export declare function registerUnattendedSeam(ctx: Context): void;
+/** 类型再导出（调用方少一处 import） */
+export type { Agent as UnattendedAgent };

package/lib/{wake-scheduler-DF-YWcX5.js → wake-scheduler-DdaRNofO.js}

@@ -1,8 +1,8 @@
 import { r as hostService, t as hostAgents } from "./access-fiehjxV6.js";
 import { g as resolveInside } from "./ccc-DG4Oc7I1.js";
 import { o as listCccs } from "./ccc-roots-FxWXuZPw.js";
-import { D as localIdStamp, E as localHuman, f as findSession, n as listBoundSessionIds, w as isoLocal, y as sessionsRoot } from "./trajectory-bound-BPWKkzJC.js";
-import { t as readSimpleSettings } from "./settings-section-CIuyoSOX.js";
+import { E as isoLocal, O as localHuman, i as listBoundSessionIds, k as localIdStamp, m as findSession, n as PLUGIN_SOURCE, x as sessionsRoot } from "./message-source-Boc-AbHs.js";
+import { t as readSimpleSettings } from "./settings-section-DTJW4smh.js";
 import { basename, dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { spawn } from "node:child_process";
@@ -857,7 +857,7 @@ const TURN_TTL_MS = 18e5;
 * 进程内的「正在跑」表（键 = 载体 dsh 会话 id）。
 *
 * ⚠️ **仅内存**：进程重启即空 —— 这是**可接受的**，因为重启后宿主会重发
-* `session-start`（或至少下一次 `turn-stopping` 会清掉残留），且空表 = "没有在跑"，
+* `agent/created`（或至少下一次 `turn-stopping` 会清掉残留），且空表 = "没有在跑"，
 * 落到上面那条**便宜**的误判方向。
 */
 const runningBySession = /* @__PURE__ */ new Map();
@@ -866,7 +866,7 @@ function sessionIdOf(agent) {
 	const id = agent?.session?.id;
 	return typeof id === "string" && id !== "" ? id : null;
 }
-/** 标记「在跑」（`agent/session-start` + `agent/status=running` 调用） */
+/** 标记「在跑」（`agent/created` + `agent/status=running` 调用） */
 function markTurnRunning(sessionId, nowMs, turn = null) {
 	if (!sessionId) return;
 	runningBySession.set(sessionId, {
@@ -914,7 +914,7 @@ function runningCarriersOf(boundSessionIds, nowMs, ttlMs = TURN_TTL_MS) {
 * 装配追踪（`index.ts` apply 调用）：订阅四个既有事件 + 拆卸。
 *
 * **为什么订阅四个而不是两个**（R↓）：
-* · 前两个（`session-start` / `turn-stopping`）负责**语义**——"在不在跑"；
+* · 前两个（`agent/created` / `turn-stopping`）负责**语义**——"在不在跑"；
 * · 后两个（`agent/disposed` / `session/disposed`）负责**生命周期**——
 *   载体没了必须清项，否则表按载体只增（本模块的头号风险）。
 *
@@ -930,7 +930,7 @@ function registerCroTurnTracking(ctx) {
 			console.log(`[serenity-hooks] ✗ CRO turn 追踪未装配（${event} 不可用）: ${String(err?.message ?? err)}`);
 		}
 	};
-	on("agent/session-start", (payload) => {
+	on("agent/created", (payload) => {
 		const id = sessionIdOf(payload?.agent);
 		if (id) markTurnRunning(id, Date.now());
 	});
@@ -1370,10 +1370,6 @@ function createClock(opts) {
 }
 //#endregion
 //#region src/wake-scheduler.ts
-const PLUGIN_SOURCE = {
-	kind: "plugin",
-	plugin: "dsh-serenity-hooks"
-};
 /**
 * 解析条目的 target（`S###` 或完整目录名）→ 目录名 + SESSION.md 路径。
 * @param root CCC 根
@@ -1393,7 +1389,9 @@ function resolveWakeTarget(root, target) {
 /**
 * 🔴 **本钟的全局闸已于 2026-09-21 砍掉**（所有者令逐字：「**send-later 的开关不再重要了，砍掉**」）。
 *
-* **为什么砍**（R↓）：唤醒已从"可选实验能力"长成**全容器的续接绳**——S142/S151/S185 的链、
+* **为什么砍**（R↓）：唤醒已从"可选实验能力"长成**全容器的续接绳**（🔵 **术语说明，2026-09-23 补**：
+* **"绳" = 我们对自己用 `send-later` 给自己排的"定时叫醒"条目的俗称** —— 一条链每轮给自己排下一根，
+* 链才不断。本仓注释与 SESSION.md 沿用此说法，**它不是产品名、也不是宿主概念**）——S142/S151/S185 的链、
 * 跨轨迹投递、`send-now`/`send-later` 都走它。留一个"能被误关的开关"的**代价**是
 * "整条链静默停摆且无人告警"（本仓已实测过同族事故：闸关 6.6h 零 tick、断链 1 天 14 小时）；
 * 而**收益**只剩"关掉一个 5min unref 空检查"。⇒ **收益 < 代价，故删闸**（不是改为缺省开——是**没有这个键了**）。
@@ -1887,4 +1885,4 @@ function registerWakeScheduler(ctx) {
 	registerDisposer(ctx, "trajectory 唤醒调度器", () => clock.dispose());
 }
 //#endregion
-export { registerDisposer as a, addWake as c, registerCroTurnTracking as i, listWakes as l, sendToTrajectory as n, buildCroSnapshot as o, wakeSchedulerState as r, WAKE_CATCH_UP_MS as s, registerWakeScheduler as t };
+export { registerDisposer as a, WAKE_CATCH_UP_MS as c, registerCroTurnTracking as i, addWake as l, sendToTrajectory as n, CRO_FILENAME as o, wakeSchedulerState as r, buildCroSnapshot as s, registerWakeScheduler as t, listWakes as u };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.46.0",
-  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：11 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/im-bridge/acc-diag）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.5-rc.2。",
+  "version": "1.47.0",
+  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：11 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/im-bridge/acc-diag）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.7-rc.1。",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -53,23 +53,23 @@
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-compaction": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-title": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-shell": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-shell-env": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-web": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-web-fetch-http": "^0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.2",
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-agent": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-agent-loop": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-agent-preset-registry": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-compaction": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-shell": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-shell-env": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-skill": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-web": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-web-fetch-http": "^0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.4",
     "cordis": "^4.0.0-rc.7"
   },
   "peerDependenciesMeta": {
@@ -85,7 +85,7 @@
     "@deepseek-ai/dsh-agent-loop": {
       "optional": true
     },
-    "@deepseek-ai/dsh-agent-presets": {
+    "@deepseek-ai/dsh-agent-preset-registry": {
       "optional": true
     },
     "@deepseek-ai/dsh-compaction": {
@@ -96,38 +96,38 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-connection": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-compaction": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-persistence": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-title": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-shell": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-shell-env": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-subagent": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-token-meter": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-web": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-web-fetch-http": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-workspace": "0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.2",
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-agent-loop": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-connection": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-compaction": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-session-persistence": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-session-projection": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-session-title": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-shell": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-shell-env": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-skill": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-subagent": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-token-meter": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-web": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-web-fetch-http": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-workspace": "0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.4",
     "@types/node": "^20.0.0",
     "@types/qrcode-generator": "^1.0.6",
     "@types/react": "^18.2.0",