@shgroup/dsh-serenity-hooks 1.56.5 → 1.56.6

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.56.5",
+  "version": "1.56.6",
   "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/handyman/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/index.js

@@ -7,6 +7,7 @@ import { a as readWeixinCredential, c as weixinInboundDir, d as LOCALSTORE_SCOPE
 import { a as unregisterSkiffSession$1, i as skiffSessionSnapshot$1, n as skiffRoleFor$1, o as ACC_VERSION, r as skiffSessionInfo$1, t as registerSkiffSession$1 } from "./skiff-registry-BjIX_KD1.js";
 import { a as readSkiffRoles, c as roleMsmWhitelist, d as systemPromptSource, f as trajectorySubset, i as isSkiffSessionId, l as roleToolWhitelist, n as buildSkiffBasePrompt, o as resolveRoleSystemPrompt, r as createRolePromptReader, s as resolveSkiffKind } from "./skiff-role-BSg6Qu9k.js";
 import { a as ACP_HTTP_PORT, c as MAIN_WEB_PORT, d as WEIXIN_SEND_PORT, l as MECHANISM_PORTS, n as readSimpleSettings, o as FACE_PORTS, r as registerSettingsSection, s as GATEWAY_PORT, u as SKIFF_DEBUG_PORT } from "./settings-section-xHABl8nk.js";
+import { REGISTERED_TOOLS } from "./invariant.js";
 import { a as markdownToPlainText, c as sendTyping, i as getUpdates, l as sniffImageExt, n as downloadMedia, o as sendFileMessage, r as getConfig, s as sendTextMessage, t as TypingStatus } from "./weixin-api-BrRcPiQs.js";
 import { createRequire } from "node:module";
 import z from "@deepseek-ai/schemastery";
@@ -13865,6 +13866,106 @@ function forgetExclusiveToolsVisibility(sessionId) {
 	}
 }
 /**
+* 非 CCC 会话的工具隐藏状态（sessionId → restrict disposer）。
+*
+* 🔴 **为什么需要它（缺陷根因）**：工具是 `apply()` 里 `ctx.tools.register(...)` 注册到**宿主级**的
+* ⇒ 它们出现在**每一个**会话的工具清单里，**与会话 cwd 无关**。其余各缝（身份注入 ／ guards ／
+* keeper ／ output-guard ／ unattended ／ bootstrap）都已有 `if (!root) return` 这道门，
+* **唯独"工具可见性"这一层没有** ⇒ 在非 CCC 目录开会话时，模型仍看得见这 14 个工具，
+* 于是会去调 —— 调了才抛 `No CCC found`。**那是运行时报错，不是事先不可见**。
+*
+* 判据（owner 原话：「宁静号所有功能在非宁静号目录不生效」）：
+* - **在 CCC 内** → 解除隐藏（本机制**一次 restrict 都不发**，既有行为零改变）
+* - **不在 CCC 内** → `restrict({ deny: [...REGISTERED_TOOLS] })` ⇒ 从模型工具清单移除
+*
+* ⚠️ **与 `syncExclusiveToolsVisibility` 的分工**：那个管"CCC 内哪个工具可见"（按 CCC 配置判）；
+* 本函数管"**这个会话配不配看到任何 ACC 工具**"（按"在不在 CCC 内"判）。二者独立、可叠加。
+*
+* ⚠️ **必须逐个名字显式列出**：宿主的 `restrict` 对**未注册的工具名**会让**整次调用失败**
+* （`dsh-tools` 契约逐字："Empty filters, unknown names … fail"）⇒ 不能写通配。
+* 但 `REGISTERED_TOOLS` 是"插件**具备**的工具面"，其中 **`diagram` 是按开关注册的**
+* （缺省关 ⇒ 缺省**并不在册**）⇒ 直接拿全表去 deny **可能整次失败**，那样就会
+* **静默退回"工具照样可见"**＝缺陷没修好。故此处走**两档尝试**（见 `hideAllFor`）。
+*/
+const nonCccRestrictions = /* @__PURE__ */ new Map();
+/**
+* 在非 CCC 会话上隐藏全部 ACC 工具（两档尝试）。
+*
+* 🔴 **为什么要两档（D119：不许照源码"意图"断言宿主行为）**：取消注册的工具名会让整次
+* `restrict` 失败，而 `diagram` 缺省不在册。若只发一次全表 deny，"deny 里有个不在册的名字"
+* 就会让**整次调用**失败 ⇒ 一个都不隐藏（且只有一行 console.error）。
+*
+* 档位（**先全覆盖、失败再退到"恒在册"那一段**）：
+*   ① 全表 `REGISTERED_TOOLS`（14：含条件工具）—— 首选，覆盖最全
+*   ② 常驻段（前 `length - CONDITIONAL_TOOL_COUNT` 个）—— 退路：只保证**恒注册**的那些被隐藏
+*
+* 返回**实际生效的注销器**；两档都失败 → `{ failed: [...] }`（原因一并带回，由调用方决定怎么响）。
+*
+* ⚠️ **档位失败不在这里逐条告警**：档 ① 在 `diagram` 缺省关时**按设计**就会失败（它不在册），
+* 那是**常态**、不是故障 ⇒ 逐条 error 会在每个非 CCC 会话上刷**假警报**（看着像坏了，其实档 ② 已成功）。
+* 真正的失败只由调用方在"两档全失败"时**响亮报一次**。
+*/
+function hideAllFor(agent) {
+	const resident = REGISTERED_TOOLS.slice(0, REGISTERED_TOOLS.length - 3);
+	const tiers = [{
+		label: "全表（含条件工具）",
+		names: REGISTERED_TOOLS
+	}, {
+		label: "常驻段（跳过条件工具）",
+		names: resident
+	}];
+	const failed = [];
+	for (const tier of tiers) try {
+		return {
+			dispose: agent.ctx.tools.restrict({ deny: [...tier.names] }),
+			names: tier.names
+		};
+	} catch (e) {
+		failed.push(`${tier.label}: ${e.message}`);
+	}
+	return { failed };
+}
+/**
+* 同步「本会话在不在 CCC 内」的工具可见性（v1.56.6）。
+*
+* @param agent 目标会话的 agent
+* @param root 该会话的 CCC 根；`null` ⇒ **不在任何 CCC 内** ⇒ 隐藏全部 ACC 工具
+*
+* 幂等：同一会话重复调用不会重复 restrict（已是目标态即直接返回）。
+* 失败不抛（最坏情况：工具可见，但**调用时**仍被各工具自己的根解析拒绝——既有兜底不变）。
+*/
+function syncCccToolVisibility(agent, root) {
+	const sessionId = agent.session.id ?? "global";
+	const existing = nonCccRestrictions.get(sessionId);
+	const shouldHide = root === null;
+	if (shouldHide && !existing) {
+		const hidden = hideAllFor(agent);
+		if ("failed" in hidden) {
+			console.error(`[serenity-hooks] 非 CCC 工具隐藏**两档全失败**(session=${sessionId}) —— 工具仍可见（但有各工具自身的 !root 兜底）：${hidden.failed.join(" ／ ")}`);
+			return;
+		}
+		nonCccRestrictions.set(sessionId, hidden.dispose);
+		return;
+	}
+	if (!shouldHide && existing) {
+		try {
+			existing();
+		} catch (e) {
+			console.error(`[serenity-hooks] 非 CCC 工具恢复失败 (session=${sessionId}):`, e.message);
+		}
+		nonCccRestrictions.delete(sessionId);
+	}
+}
+/** 会话销毁清理（lifecycle 调用；防 per-会话 Map 无界增长） */
+function forgetNonCccToolVisibility(sessionId) {
+	const existing = nonCccRestrictions.get(sessionId);
+	if (!existing) return;
+	try {
+		existing();
+	} catch {}
+	nonCccRestrictions.delete(sessionId);
+}
+/**
 * 从 exec 参数中提取常见路径字段（write/edit 工具）；宽松读取。
 * container_fs 复合工具：path（单路径）/ paths（数组）/ src / dst——取第一个命中（越界检查
 * 逐路径由 decideGuard 单 pathArg 覆盖；多路径字段取首个，避免漏检主体路径）。
@@ -14736,6 +14837,9 @@ function registerContext(ctx, opts = {}) {
 	const seed = (agent) => {
 		const cwd = agent.session?.header?.cwd ?? process.cwd();
 		const root = cccRootForCwd(cwd);
+		try {
+			syncCccToolVisibility(agent, root);
+		} catch {}
 		if (!root) return;
 		const key = agentKey(agent);
 		if (isSkiffSessionId(key)) return;
@@ -14819,6 +14923,9 @@ function registerContext(ctx, opts = {}) {
 		const key = agentKey(agent);
 		const downstream = await next();
 		if (isSkiffSessionId(key)) return downstream;
+		try {
+			syncCccToolVisibility(agent, root);
+		} catch {}
 		if (root) {
 			try {
 				syncSafeModeRestriction(agent, root);
@@ -22642,6 +22749,9 @@ function cleanupSessionState(sessionId) {
 	try {
 		forgetExclusiveToolsVisibility(sessionId);
 	} catch {}
+	try {
+		forgetNonCccToolVisibility(sessionId);
+	} catch {}
 	try {
 		forgetLogbookCompactionState(sessionId);
 	} catch {}

package/lib/seams/guards.d.ts

@@ -90,6 +90,22 @@ export declare function getExclusiveToolsDiagnostics(): {
 export declare function syncExclusiveToolsVisibility(agent: Agent, root: string): void;
 /** 会话销毁清理（lifecycle 调用；本函数按 `${sessionId}::` 前缀回收全部专属工具项） */
 export declare function forgetExclusiveToolsVisibility(sessionId: string): void;
+/** 非 CCC 隐藏诊断（排查"工具为什么不见了"） */
+export declare function getNonCccHiddenDiagnostics(): {
+    hidden: string[];
+};
+/**
+ * 同步「本会话在不在 CCC 内」的工具可见性（v1.56.6）。
+ *
+ * @param agent 目标会话的 agent
+ * @param root 该会话的 CCC 根；`null` ⇒ **不在任何 CCC 内** ⇒ 隐藏全部 ACC 工具
+ *
+ * 幂等：同一会话重复调用不会重复 restrict（已是目标态即直接返回）。
+ * 失败不抛（最坏情况：工具可见，但**调用时**仍被各工具自己的根解析拒绝——既有兜底不变）。
+ */
+export declare function syncCccToolVisibility(agent: Agent, root: string | null): void;
+/** 会话销毁清理（lifecycle 调用；防 per-会话 Map 无界增长） */
+export declare function forgetNonCccToolVisibility(sessionId: string): void;
 interface GuardRegistration {
     /** 配置路径；缺省用 DEFAULT_SERENITY_CONFIG_PATHS */
     configPaths?: string[];

package/package.json

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