@shgroup/dsh-serenity-hooks 1.16.8 → 1.16.10

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.16.8",
+  "version": "1.16.10",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：真实 DSH 工具 cc_fs/session/acc_msm/eap/neat/cce/loop + 拦截缝机械约束（safe-mode/路径守卫/会话落盘）。适配 DSH 公开版（0.1.0-rc，deepseek-ai/deepseek-harness）。私有（dsh-external 组织）。",
   "engines": {

package/lib/client.js

@@ -8,7 +8,7 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		let react_jsx_runtime = require("react/jsx-runtime");
 		//#region \0sp-css:/home/yh/home/home-serenity/AI_LAB/dsh-serenity-plugin/hooks/dsh-serenity-hooks/src/client/SafeModePanel
-		const css = "/* SafeModePanel — 会话头部 Serenity 状态徽章（点击展开详情卡）。\n * 遵循 web-styling.md：颜色只用 --dsw-alias-* 语义 token（明暗自适应）；\n * 尺寸与官方 header 标签一致；前缀 sp- 防冲突。 */\n\n.sp-root {\n  position: relative;\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 24px;\n  padding: 0 4px 0 4px;\n  border-radius: 6px;\n  background: var(--dsw-alias-bg-module-platform);\n  font-size: 12px;\n  line-height: 24px;\n  white-space: nowrap;\n}\n\n.sp-badge {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 22px;\n  padding: 0 6px;\n  border: none;\n  border-radius: 5px;\n  background: transparent;\n  color: inherit;\n  font-size: 12px;\n  cursor: pointer;\n  transition: background var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-badge:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.sp-badge:focus-visible {\n  outline: 2px solid var(--dsw-alias-button-ghost-active-border);\n  outline-offset: 1px;\n}\n\n.sp-dot {\n  flex: none;\n  width: 7px;\n  height: 7px;\n  border-radius: 50%;\n}\n\n.sp-dotOn {\n  background: var(--dsw-alias-state-success-primary);\n}\n\n.sp-dotOff {\n  background: var(--dsw-alias-label-dimmed);\n}\n\n.sp-brand {\n  color: var(--dsw-alias-label-primary);\n  font-weight: 500;\n}\n\n.sp-toggle {\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  height: 18px;\n  padding: 0 8px;\n  border: none;\n  border-radius: 5px;\n  font-size: 12px;\n  font-weight: 600;\n  line-height: 18px;\n  cursor: pointer;\n  transition: background var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-toggle:focus-visible {\n  outline: 2px solid var(--dsw-alias-button-ghost-active-border);\n  outline-offset: 1px;\n}\n\n.sp-toggle:disabled {\n  opacity: 0.55;\n  cursor: default;\n}\n\n.sp-toggleOn {\n  background: var(--dsw-alias-state-error-primary);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n\n.sp-toggleOn:hover:not(:disabled) {\n  background: var(--dsw-alias-state-error-secondary);\n}\n\n.sp-toggleOff {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.sp-toggleOff:hover:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover-solid);\n}\n\n.sp-toggleIcon {\n  flex: none;\n}\n\n.sp-toggleLg {\n  height: 26px;\n  padding: 0 14px;\n  font-size: 13px;\n  line-height: 26px;\n  border-radius: 6px;\n}\n\n/* 详情卡：相对徽章绝对定位（右对齐），卡片 token */\n.sp-pop {\n  position: absolute;\n  top: calc(100% + 8px);\n  right: 0;\n  z-index: 20;\n  width: 300px;\n  box-sizing: border-box;\n  padding: 12px 14px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 12px;\n  background: var(--dsw-specific-tip);\n  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n}\n\n.sp-popRow {\n  display: flex;\n  align-items: baseline;\n  gap: 10px;\n  min-width: 0;\n}\n\n.sp-popLabel {\n  flex: none;\n  width: 34px;\n  font-size: 12px;\n  color: var(--dsw-alias-label-caption);\n}\n\n.sp-popValue {\n  flex: 1;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  font-size: 12px;\n  color: var(--dsw-alias-label-secondary);\n  font-family: var(--ds-font-family-code, monospace);\n}\n\n.sp-popActions {\n  display: flex;\n  justify-content: flex-end;\n  padding-top: 4px;\n  border-top: 1px solid var(--dsw-alias-border-l1);\n  margin-top: 2px;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .sp-toggle,\n  .sp-badge {\n    transition: none;\n  }\n}\n";
+		const css = "/* SafeModePanel — 会话头部 Serenity 状态徽章（点击展开详情卡）。\n * 遵循 web-styling.md：颜色只用 --dsw-alias-* 语义 token（明暗自适应）；\n * 尺寸与官方 header 标签一致；前缀 sp- 防冲突。 */\n\n.sp-root {\n  position: relative;\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 24px;\n  padding: 0 4px 0 4px;\n  border-radius: 6px;\n  background: var(--dsw-alias-bg-module-platform);\n  font-size: 12px;\n  line-height: 24px;\n  white-space: nowrap;\n}\n\n.sp-badge {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 22px;\n  padding: 0 6px;\n  border: none;\n  border-radius: 5px;\n  background: transparent;\n  color: inherit;\n  font-size: 12px;\n  cursor: pointer;\n  transition: background var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-badge:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.sp-badge:focus-visible {\n  outline: 2px solid var(--dsw-alias-button-ghost-active-border);\n  outline-offset: 1px;\n}\n\n.sp-dot {\n  flex: none;\n  width: 7px;\n  height: 7px;\n  border-radius: 50%;\n}\n\n.sp-dotOn {\n  background: var(--dsw-alias-state-success-primary);\n}\n\n.sp-dotOff {\n  background: var(--dsw-alias-label-dimmed);\n}\n\n.sp-brand {\n  color: var(--dsw-alias-label-primary);\n  font-weight: 500;\n}\n\n.sp-toggle {\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  height: 18px;\n  padding: 0 8px;\n  border: none;\n  border-radius: 5px;\n  font-size: 12px;\n  font-weight: 600;\n  line-height: 18px;\n  cursor: pointer;\n  transition: background var(--ds-transition-duration-fast, 0.1s) var(--ds-ease-in-out, ease);\n}\n\n.sp-toggle:focus-visible {\n  outline: 2px solid var(--dsw-alias-button-ghost-active-border);\n  outline-offset: 1px;\n}\n\n.sp-toggle:disabled {\n  opacity: 0.55;\n  cursor: default;\n}\n\n.sp-toggleOn {\n  background: var(--dsw-alias-state-error-primary);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n\n.sp-toggleOn:hover:not(:disabled) {\n  background: var(--dsw-alias-state-error-secondary);\n}\n\n.sp-toggleOff {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.sp-toggleOff:hover:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover-solid);\n}\n\n.sp-toggleIcon {\n  flex: none;\n}\n\n.sp-toggleLg {\n  height: 26px;\n  padding: 0 14px;\n  font-size: 13px;\n  line-height: 26px;\n  border-radius: 6px;\n}\n\n/* 详情卡：相对徽章绝对定位（右对齐），卡片 token */\n.sp-pop {\n  position: absolute;\n  top: calc(100% + 8px);\n  right: 0;\n  z-index: 20;\n  width: 300px;\n  box-sizing: border-box;\n  padding: 12px 14px;\n  border: 1px solid var(--dsw-alias-border-l1);\n  border-radius: 12px;\n  background: var(--dsw-specific-tip);\n  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n}\n\n.sp-popRow {\n  display: flex;\n  align-items: baseline;\n  gap: 10px;\n  min-width: 0;\n}\n\n.sp-popLabel {\n  flex: none;\n  width: 34px;\n  font-size: 12px;\n  color: var(--dsw-alias-label-caption);\n}\n\n.sp-popValue {\n  flex: 1;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  font-size: 12px;\n  color: var(--dsw-alias-label-secondary);\n  font-family: var(--ds-font-family-code, monospace);\n}\n\n.sp-popActions {\n  display: flex;\n  justify-content: flex-end;\n  padding-top: 4px;\n  border-top: 1px solid var(--dsw-alias-border-l1);\n  margin-top: 2px;\n}\n\n/* loop 运行状态区块（WebUI 等待界面；并行任务各自一行） */\n.sp-popSection {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  padding-top: 6px;\n  border-top: 1px solid var(--dsw-alias-border-l1);\n  margin-top: 2px;\n}\n\n.sp-loopItem {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  padding: 2px 0 2px 44px;\n  min-width: 0;\n}\n\n.sp-loopHead {\n  display: flex;\n  align-items: baseline;\n  gap: 8px;\n  min-width: 0;\n}\n\n.sp-loopLabel {\n  flex: 1;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  font-size: 12px;\n  font-weight: 600;\n  color: var(--dsw-alias-label-primary);\n}\n\n.sp-loopRound {\n  flex: none;\n  font-size: 11px;\n  color: var(--dsw-alias-state-info-primary);\n  font-family: var(--ds-font-family-code, monospace);\n}\n\n.sp-loopTime {\n  flex: none;\n  font-size: 11px;\n  color: var(--dsw-alias-label-caption);\n}\n\n.sp-loopResp {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  font-size: 11px;\n  color: var(--dsw-alias-label-secondary);\n  font-family: var(--ds-font-family-code, monospace);\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .sp-toggle,\n  .sp-badge {\n    transition: none;\n  }\n}\n";
 		if (typeof document !== "undefined" && document.querySelector("style[data-sp-css]") === null) {
 			const tag = document.createElement("style");
 			tag.setAttribute("data-sp-css", "1");
@@ -18,6 +18,7 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/SafeModePanel.tsx
 		const API = "/serenity/status";
+		const LOOPS_API = "/serenity/loops";
 		/** 拼接类名（等价 clsx 最小子集，避免额外依赖） */
 		function cx(...parts) {
 			return parts.filter(Boolean).join(" ");
@@ -27,6 +28,7 @@ window.__ModuleLoader__.load({
 			const [status, setStatus] = (0, react.useState)(null);
 			const [busy, setBusy] = (0, react.useState)(false);
 			const [open, setOpen] = (0, react.useState)(false);
+			const [loops, setLoops] = (0, react.useState)([]);
 			const rootRef = (0, react.useRef)(null);
 			const sessionId = props.sessionId;
 			const refresh = (0, react.useCallback)(async () => {
@@ -41,6 +43,25 @@ window.__ModuleLoader__.load({
 			(0, react.useEffect)(() => {
 				refresh();
 			}, [refresh]);
+			(0, react.useEffect)(() => {
+				if (!open) return;
+				let alive = true;
+				const qs = sessionId ? `?sessionId=${encodeURIComponent(sessionId)}` : "";
+				const tick = async () => {
+					try {
+						const data = await (await fetch(`${LOOPS_API}${qs}`, { headers: { accept: "application/json" } })).json();
+						if (alive) setLoops(data.loops ?? []);
+					} catch {
+						if (alive) setLoops([]);
+					}
+				};
+				tick();
+				const timer = setInterval(() => void tick(), 3e3);
+				return () => {
+					alive = false;
+					clearInterval(timer);
+				};
+			}, [open, sessionId]);
 			(0, react.useEffect)(() => {
 				if (!open) return;
 				const onDown = (e) => {
@@ -166,6 +187,43 @@ window.__ModuleLoader__.load({
 										status.safeModeOn ? "ON" : "OFF"
 									]
 								})
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: cx("sp-popSection"),
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: cx("sp-popRow"),
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: cx("sp-popLabel"),
+										children: "loops"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: cx("sp-popValue"),
+										children: loops.filter((l) => !l.done).length > 0 ? `运行中 ${loops.filter((l) => !l.done).length}${loops.length > 0 ? ` / 共 ${loops.length}` : ""}` : "无运行中 loop"
+									})]
+								}), loops.slice(0, 5).map((l) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: cx("sp-loopItem"),
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: cx("sp-loopHead"),
+										children: [
+											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: cx("sp-loopLabel"),
+												title: l.label,
+												children: l.label
+											}),
+											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: cx("sp-loopRound"),
+												children: l.done ? "✓" : `R${l.round}`
+											}),
+											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: cx("sp-loopTime"),
+												children: new Date(l.updated).toLocaleTimeString()
+											})
+										]
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+										className: cx("sp-loopResp"),
+										title: l.lastResponse,
+										children: l.lastResponse.slice(0, 80) || (l.done ? "已完成" : "（等待首轮响应）")
+									})]
+								}, l.label))]
 							})
 						] }) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: cx("sp-popRow"),

package/lib/index.js

@@ -2166,7 +2166,7 @@ function splitModel(model) {
 		model: model.slice(idx + 1)
 	};
 }
-/** 轮次 prompt（对齐老 loop 结构：回顾进度 → 自由工作 → 汇报） */
+/** 轮次 prompt（对齐老 loop 结构：回顾进度 → 自由工作 → 汇报；S134 EAP 化：固定详尽） */
 function buildRoundPrompt(opts) {
 	const { root, session, label, round, stopToken, progress, task } = opts;
 	const resumeNote = progress && progress.round > 0 ? `上一轮（round ${progress.round}）已完成：${progress.lastResponse.slice(0, 300)}\n永远从上次停止处继续，绝不重做已完成工作。` : "这是第一轮。";
@@ -2177,14 +2177,82 @@ ${session ? `工作会话：${session}（AGENT_SESSIONS/${session}/SESSION.md
 ${task ? `任务：${task}` : `任务：以 label「${label}」对应的工作为准（若存在工作会话，先读 SESSION.md 明确目标）`}
 ${resumeNote}
 
-本轮内你可以自由工作：读文件、改代码、执行命令，尽一切手段推进任务。
-每轮结束时汇报：
+## 工作规范（每轮固定，必须遵守）
+1. 本轮内自由工作：读文件、改代码、执行命令，尽一切手段推进任务。
+2. 若本任务属于**阅读整理或文字编写类工作**（读文件提炼、总结、撰写文档、生成文本等），
+   请先加载 eap（acc-eap skill）并按 EAP 标准组织输出：
+   - E↑ 显式：实体/变量明确定义，关系指明方向与基数，边界划定，不用歧义词
+   - R↓ 可重建：关键结论记录来源与推理，可被后续 agent 重建
+   - S↑ 稳定：输出结构可重复生成，不依赖隐含上下文
+3. 汇报必须具体可核验，不写空话。
+
+## 每轮汇报（固定格式，逐条回答）
 1. 本轮做了什么（具体）
 2. 下一步计划
-3. 是否已完成（若完成，输出 ${stopToken}）
+3. 是否已完成（若完成，只输出 ${stopToken}）
 
 若已完成任务，只输出 ${stopToken}。`;
 }
+/**
+* loop 规模化使用指引（guide 子命令输出；S134）：
+* 使用 loop 前必须先加载 eap 设计方案；并行策略；提示词规范（详尽固定 EAP）；
+* 阅读/文字编写类 loop 内部也加载 eap。
+*/
+const LOOP_GUIDE = `# loop — 规模化使用指引（guide）
+
+## ⚠️ 使用前：必须先加载 eap 设计方案
+调用 loop 前，请先加载 eap（acc-eap skill），基于 EAP 框架设计「规模化 loop 方案」。
+
+### 1. 任务拆解（E↑ 显式）
+- 大任务拆成明确子任务：每个子任务定义 目标 / 输入 / 边界（做什么、不做什么）/ 验收标准
+- 依赖显式化：有依赖的串行，无依赖的可并行
+
+### 2. 提示词设计（loop 的 task 参数）
+- task 必须详尽、固定、符合 EAP：目标明确、边界划定、验收标准可判定
+- 反例「处理这个文件」——歧义；正例「读取 <路径>，提取「关键决策」表格全部行，
+  输出 JSON 数组（字段 id/结论/证据），不改动原文件」
+- 阅读整理 / 文字编写类工作（读文件提炼、总结、撰写文档、生成文本等）：
+  loop 内部 agent 也会被要求加载 eap，按 EAP 标准组织输出
+
+### 3. 并行策略（规模化）
+- 无依赖的子任务可并行：每个子任务一个独立 loop（独立 label + task）
+- 并行执行方式：
+  a. 后台 subagent：每个 subagent 内调 loop（各自 label），subagent 并行运行
+  b. workflow：parallel 阶段驱动多个 loop 子 agent
+- 并发安全已保证：sessionId 唯一（loop-<label>-<uuid>）、进度文件按 label 隔离
+  （AGENT_SESSIONS/loop-<label>.json）——同 label 续跑、不同 label 互不干扰
+- 汇总：并行 loop 各自产出进度后，主 agent 汇总合并（或再派一个汇总 loop）
+
+## 完成判定
+- 唯一完成条件 = loop 内部 agent 精确回显本轮随机验证码（stop token）；对话轮次无上限（不完成不返回）
+- agent 非正常停止时自动重启（≤100 次防死循环）
+
+## 等待界面
+- WebUI 会话头部 Serenity 详情卡显示运行中 loop 的进度（label / 轮次 / 最近响应），并行任务各自一行，约 3s 刷新
+`;
+/** 列出 AGENT_SESSIONS/loop-*.json 的全部进度（按 updated 倒序；坏文件跳过） */
+function listActiveLoops(root) {
+	const dir = join(root, "AGENT_SESSIONS");
+	if (!existsSync(dir)) return [];
+	const out = [];
+	for (const entry of readdirSync(dir)) {
+		if (!entry.startsWith("loop-") || !entry.endsWith(".json")) continue;
+		try {
+			const data = JSON.parse(readFileSync(join(dir, entry), "utf-8"));
+			if (typeof data.label !== "string" || typeof data.round !== "number") continue;
+			out.push({
+				label: data.label,
+				round: data.round,
+				done: data.done === true,
+				model: typeof data.model === "string" ? data.model : "",
+				updated: typeof data.updated === "string" ? data.updated : "",
+				lastResponse: typeof data.lastResponse === "string" ? data.lastResponse : ""
+			});
+		} catch {}
+	}
+	out.sort((a, b) => a.updated < b.updated ? 1 : -1);
+	return out;
+}
 //#endregion
 //#region src/tools/loop.ts
 /**
@@ -2249,7 +2317,7 @@ function lastAssistantText(agent) {
 function createLoopTool(ctx) {
 	return defineTool({
 		name: "loop",
-		description: "牛马循环（老 loop 等效）：用指定模型创建专用 agent 反复执行任务直到完成。\n用法：loop 接受 task（要完成的目标）或依赖 session 上下文；模型缺省读 .opencode/serenity.json 的 loop.defaultModel（当前 minimax-cn-coding-plan/MiniMax-M3，廉价牛马）。\n行为：内部硬性 while 循环驱动 agent 逐轮推进任务，每轮等待无超时（agent 工作多久等多久）。唯一完成条件 = agent 精确回显本轮随机完成码（stop token），防止低智能模型提前结束。轮次不需要调用者指定——对话轮次**无上限**（不完成不返回），agent 非正常停止时自动重启（重启 ≤100 次，防死循环保险阀）。\n进度：写入 AGENT_SESSIONS/loop-<label>.md/.json；同 label 再次调用从上次轮次续跑（不重做）。\n约束：loop agent 受完整 Serenity 约束（ACC 身份/入口技能系统提示词/守卫/session-keeper）。\n示例：loop 执行「扫描 SQC 并修复 DC 问题」，label: sqc-scan",
+		description: "牛马循环（老 loop 等效）：用指定模型创建专用 agent 反复执行任务直到完成。\n用法：loop guide（输出规模化使用指引——使用前先加载 eap 设计规模化方案）；loop 接受 task（要完成的目标）或依赖 session 上下文；模型缺省读 .opencode/serenity.json 的 loop.defaultModel（当前 minimax-cn-coding-plan/MiniMax-M3，廉价牛马）。\n行为：内部硬性 while 循环驱动 agent 逐轮推进任务，每轮等待无超时（agent 工作多久等多久）。唯一完成条件 = agent 精确回显本轮随机完成码（stop token），防止低智能模型提前结束。轮次不需要调用者指定——对话轮次**无上限**（不完成不返回），agent 非正常停止时自动重启（重启 ≤100 次，防死循环保险阀）。\n进度：写入 AGENT_SESSIONS/loop-<label>.md/.json；同 label 再次调用从上次轮次续跑（不重做）。\n约束：loop agent 受完整 Serenity 约束（ACC 身份/入口技能系统提示词/守卫/session-keeper）。\n示例：loop 执行「扫描 SQC 并修复 DC 问题」，label: sqc-scan；loop guide",
 		parameters: {
 			task: {
 				type: "string",
@@ -2267,6 +2335,10 @@ function createLoopTool(ctx) {
 			model: {
 				type: "string",
 				description: "provider/model（如 minimax-cn-coding-plan/MiniMax-M3）；缺省读 loop.defaultModel"
+			},
+			guide: {
+				type: "boolean",
+				description: "输出规模化使用指引（不创建 agent；使用 loop 前先看——含 eap 设计方案要求/并行策略/提示词规范）"
 			}
 		},
 		output: {
@@ -2274,6 +2346,7 @@ function createLoopTool(ctx) {
 			render: (_args, value) => renderText$1(value)
 		},
 		async execute(args, exec) {
+			if (args.guide) return { guide: LOOP_GUIDE };
 			const root = findSerenityRoot(agentCwd$2(exec));
 			if (!root) throw new Error("No CCC found: no .serenity file from agent cwd");
 			const cfg = loadSerenityConfig(root, DEFAULT_SERENITY_CONFIG_PATHS);
@@ -2288,6 +2361,7 @@ function createLoopTool(ctx) {
 			const parentCtx = exec.agent?.ctx;
 			const inherited = loopPresetInheritance(parentCtx);
 			if (!ctx.agents) throw new Error("loop: ctx.agents 不可用");
+			const parentSession = (exec.agent?.session)?.id;
 			let handle;
 			let loopAgent;
 			const spawnAgent = async () => {
@@ -2296,6 +2370,8 @@ function createLoopTool(ctx) {
 					sessionId,
 					meta: {
 						cwd: root,
+						origin: "subagent",
+						...parentSession === void 0 ? {} : { parentSession },
 						...inherited.agentPreset === void 0 ? {} : { agentPreset: inherited.agentPreset }
 					},
 					agentOptions: {
@@ -3043,6 +3119,7 @@ function registerCompactRetention(ctx, opts = {}) {
 //#endregion
 //#region src/api.ts
 const ROUTE_PATH = "/serenity/status";
+const LOOPS_PATH = "/serenity/loops";
 function readBody(req) {
 	return new Promise((resolve, reject) => {
 		let data = "";
@@ -3076,6 +3153,30 @@ function resolveWorkspace(ctx, params) {
 }
 function registerStatusApi(ctx, opts = {}) {
 	const configPaths = opts.configPaths ?? DEFAULT_SERENITY_CONFIG_PATHS;
+	ctx.webServer.register({
+		kind: "exact",
+		path: LOOPS_PATH,
+		handler: async (req, res) => {
+			try {
+				if (req.method !== "GET") {
+					sendJson(res, 405, { error: "method not allowed" });
+					return;
+				}
+				const url = new URL(req.url ?? "/", "http://127.0.0.1");
+				const root = findSerenityRoot(resolveWorkspace(ctx, {
+					sessionId: url.searchParams.get("sessionId") ?? void 0,
+					workspace: url.searchParams.get("workspace") ?? void 0
+				}));
+				if (!root) {
+					sendJson(res, 200, { loops: [] });
+					return;
+				}
+				sendJson(res, 200, { loops: listActiveLoops(root) });
+			} catch (err) {
+				sendJson(res, 400, { error: err.message ?? String(err) });
+			}
+		}
+	});
 	ctx.webServer.register({
 		kind: "exact",
 		path: ROUTE_PATH,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.16.8",
+  "version": "1.16.10",
   "description": "宁静号 ACC harness — Native Cordis 插件（DeepSeek Harness 运行时）。真实 DSH 工具注册（cc_fs/session/acc_msm 等 9 工具）+ 拦截缝机械约束（safe-mode/路径守卫/会话落盘）+ 系统提示词注入（ACC/CCE/Constraints/SKILL/Session 五块）。适配 DSH 公开版（deepseek-ai/deepseek-harness 0.1.0-rc）。",
   "license": "MIT",
   "repository": {