@shgroup/dsh-serenity-hooks 1.30.5 → 1.30.9

package/lib/tools/handyman.d.ts

@@ -12,7 +12,7 @@
  *
  * 机制：ctx.agents.create()（带 setup 钩子）创建专用 agent（进程内），
  * 每轮 followup → agent/status idle → 读 session.events 响应 → 写进度 → stop token 检查 →
- * 未完成继续下一轮；followup/waitIdle 抛错（非正常停止）→ dispose 并重新 create agent
+ * 未完成继续下一轮；followup/等待空闲抛错（非正常停止）→ dispose 并重新 create agent
  * （重启计数，≤100），同一轮重试。工厂模式：apply 时闭包捕获插件 ctx（工具 execute 无 ctx 参数）。
  *
  * preset 继承 + 工具收窄：setup 钩子里对子 agent 执行 agentPresets.composeFrom（对齐

package/lib/tools/kit.d.ts

@@ -1,4 +1,9 @@
 /**
  * kit.ts — dashboard 真实 DSH 工具定义（defineTool）（v1.30：acc_kit → dashboard）
  */
-export declare const kitTool: import("@deepseek-ai/dsh-tools").ToolDefinition;
+import type { Context } from 'cordis';
+/**
+ * dashboard 工具（v1.30.7：闭包捕获 ctx → health 可附宿主契约探针 F-05）。
+ * ctx 仅用于**只读探针**（`ctx.get` / 属性读取），无副作用。
+ */
+export declare function createKitTool(ctx: Context): import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/{weixin-api-OUCuw0Ws.js → weixin-api-BMpljodH.js}

@@ -25,6 +25,7 @@ var weixin_api_exports = /* @__PURE__ */ __exportAll({
 	MessageType: () => MessageType,
 	TypingStatus: () => TypingStatus,
 	aes128EcbDecrypt: () => aes128EcbDecrypt,
+	assertIlinkOk: () => assertIlinkOk,
 	buildClientVersion: () => buildClientVersion,
 	buildMediaDownloadUrl: () => buildMediaDownloadUrl,
 	downloadMedia: () => downloadMedia,
@@ -120,6 +121,26 @@ async function apiPost(params) {
 		throw err;
 	}
 }
+/**
+* iLink 业务层返回码校验（v1.30.9 修复）：`apiPost` 只判 HTTP 状态，而 iLink 在 **HTTP 200**
+* 的响应体里用 `ret` / `errcode` 表达失败（如 `{ret:1,errmsg:"denied"}`）——此前被当作成功，
+* 于是"发送成功"的判定是假的：回复路径会给一条**从未送达**的消息触发 outgoing hook 记录
+* （与 weixin-bridge 注释"发送失败不记录"矛盾）。发送类调用一律经此校验。
+* 非 JSON 的 200 响应保持既有宽容语义（视为成功）。
+* @param endpoint 端点名（错误信息定位用）
+* @param rawText 响应体原文
+*/
+function assertIlinkOk(endpoint, rawText) {
+	let json;
+	try {
+		json = JSON.parse(rawText);
+	} catch {
+		return;
+	}
+	const detail = json.errmsg ? `: ${json.errmsg}` : "";
+	if (typeof json.ret === "number" && json.ret !== 0) throw new Error(`${endpoint} ret=${json.ret}${detail}`);
+	if (typeof json.errcode === "number" && json.errcode !== 0) throw new Error(`${endpoint} errcode=${json.errcode}${detail}`);
+}
 /** 取登录二维码（无需凭据；实证裸调可用） */
 async function fetchQRCode(params) {
 	const botType = params.botType ?? "3";
@@ -181,10 +202,11 @@ const MessageItemType = {
 	FILE: 4,
 	VIDEO: 5
 };
-/** 发文本消息（必须回带 context_token 关联对话；md→plain 内置——微信不支持 Markdown） */
+/** 发文本消息（主动发起时可不带 context_token；md→plain 内置——微信不支持 Markdown）。
+*  v1.30.9：HTTP 200 但 `ret/errcode != 0` → 抛错（此前静默当成功，导致"记录已送达"的假象）。 */
 async function sendTextMessage(params) {
 	const clientId = params.clientId ?? `dsp-weixin-${randomBytes(4).toString("hex")}`;
-	await apiPost({
+	assertIlinkOk("ilink/bot/sendmessage", await apiPost({
 		baseUrl: params.baseUrl,
 		endpoint: "ilink/bot/sendmessage",
 		body: JSON.stringify({ msg: {
@@ -201,7 +223,7 @@ async function sendTextMessage(params) {
 		} }),
 		token: params.token,
 		timeoutMs: params.timeoutMs ?? 15e3
-	});
+	}));
 }
 /** sendtyping status：1=TYPING（开始）0=CANCEL（结束）。
 *  ⚠️ 对齐**官方 openclaw-weixin 参考实现**（index.ts onReplyStart → status 1 /

package/lib/weixin-api.d.ts

@@ -24,6 +24,16 @@ export declare function buildClientVersion(version: string): number;
 export type FetchLike = typeof fetch;
 /** 测试注入：替换全局 fetch 实现（生产零调用） */
 export declare function __setWeixinFetchForTest(fn: FetchLike | null): void;
+/**
+ * iLink 业务层返回码校验（v1.30.9 修复）：`apiPost` 只判 HTTP 状态，而 iLink 在 **HTTP 200**
+ * 的响应体里用 `ret` / `errcode` 表达失败（如 `{ret:1,errmsg:"denied"}`）——此前被当作成功，
+ * 于是"发送成功"的判定是假的：回复路径会给一条**从未送达**的消息触发 outgoing hook 记录
+ * （与 weixin-bridge 注释"发送失败不记录"矛盾）。发送类调用一律经此校验。
+ * 非 JSON 的 200 响应保持既有宽容语义（视为成功）。
+ * @param endpoint 端点名（错误信息定位用）
+ * @param rawText 响应体原文
+ */
+export declare function assertIlinkOk(endpoint: string, rawText: string): void;
 /** 取登录二维码（无需凭据；实证裸调可用） */
 export declare function fetchQRCode(params: {
     baseUrl?: string;
@@ -139,7 +149,8 @@ export declare const MessageItemType: {
     readonly FILE: 4;
     readonly VIDEO: 5;
 };
-/** 发文本消息（必须回带 context_token 关联对话；md→plain 内置——微信不支持 Markdown） */
+/** 发文本消息（主动发起时可不带 context_token；md→plain 内置——微信不支持 Markdown）。
+ *  v1.30.9：HTTP 200 但 `ret/errcode != 0` → 抛错（此前静默当成功，导致"记录已送达"的假象）。 */
 export declare function sendTextMessage(params: {
     baseUrl: string;
     token: string;

package/lib/weixin-bridge.d.ts

@@ -43,8 +43,50 @@ export declare function handleIncoming(ctx: Context, root: string, accountId: st
 export declare function syncCccBridge(ctx: Context, root: string): void;
 /** 停止某 CCC 的桥（移除账号/禁用时） */
 export declare function stopCccBridge(root: string): void;
-/** 停止全部桥（插件 dispose） */
+/**
+ * 停止全部桥（插件 dispose）
+ */
 export declare function stopAllBridges(): void;
+/** 主动发送失败原因（稳定 code——入口层翻译成 HTTP 状态 + 可行动提示） */
+export type ProactiveSendErrorCode = 'BRIDGE_DISABLED' | 'NO_ACCOUNT' | 'ACCOUNT_NOT_FOUND' | 'ACCOUNT_NOT_BOUND' | 'SEND_FAILED';
+export interface ProactiveSendInput {
+    /** CCC 根（绝对路径；由入口层解析名称/路径后传入） */
+    root: string;
+    /** 目标用户（iLink from_user_id，形如 xxx@im.wechat；别名解析归调用方） */
+    toUserId: string;
+    /** 文本（md → 微信纯文本由 sendTextMessage 内置转换） */
+    text: string;
+    /** 发送账号（缺省 = 该 CCC 第一个启用且已绑定的账号） */
+    accountId?: string;
+}
+export type ProactiveSendResult = {
+    ok: true;
+    accountId: string;
+    userId: string;
+    sessionId: string;
+    role: string;
+} | {
+    ok: false;
+    code: ProactiveSendErrorCode;
+    error: string;
+    remediation?: string;
+};
+/**
+ * 以 bot 身份主动给指定用户发文本（**不经用户消息触发**）。
+ *
+ * 为什么放在桥里而不是让 CCC 自己直连 iLink（用户拍板 A 方案）：
+ * ① **记录归桥**——发送成功后触发既有 outgoing hook，`_weixin-logs/*.jsonl` 与对话回复
+ *    同源同格式（事件多一个 `source: 'proactive'` 标记）；② 协议/账号/凭据解析单一真相源，
+ *    CCC 侧不必重复实现 sendmessage；③ 多账号可选。
+ *
+ * 记录一致性：`sessionId` 取 `weixinSessionIdFor(toUserId)`——与该用户平时对话**同一条轨迹**，
+ * 记录里能直接按会话串联；`role` 取该 CCC 路由命中角色（未命中 → 空串）。
+ *
+ * 主动消息不带 context_token（iLink 接受 bot 主动发起；带 token 的路径见 handleIncoming 回复）。
+ * @param input CCC 根 + 目标用户 + 文本 +（可选）账号
+ * @returns 成功含 accountId/userId/sessionId/role；失败含稳定 code 与可行动提示（不抛错）
+ */
+export declare function sendProactiveText(input: ProactiveSendInput): Promise<ProactiveSendResult>;
 /** 桥状态快照（面板数据源）：每 CCC → 每账号 → 轮询健康 */
 export declare function weixinBridgeStatus(): Array<{
     ccc: string;

package/lib/weixin-hook.d.ts

@@ -52,6 +52,13 @@ export interface WeixinHookIncomingEvent extends WeixinHookEventBase {
 export interface WeixinHookOutgoingEvent extends WeixinHookEventBase {
     event: 'outgoing';
     reply: string;
+    /**
+     * 触发来源（v1.30.9，S142 用户需求"微信桥支持被调用发消息"）：
+     *  - `reply`（缺省，向后兼容）= 收到用户消息后的回复
+     *  - `proactive` = 桥被调用主动发给指定用户（CCC MSM 经本机入口发起）
+     * 记录侧可据此区分"对话回复"与"主动留言"。
+     */
+    source?: 'reply' | 'proactive';
 }
 /** 全部 hook 事件（判别联合） */
 export type WeixinHookEvent = WeixinHookIncomingEvent | WeixinHookOutgoingEvent;
@@ -75,6 +82,8 @@ export interface OutgoingHookInput {
     sessionId: string;
     role: string;
     reply: string;
+    /** 缺省 'reply'（对话回复）；'proactive' = 桥被调用主动发送 */
+    source?: 'reply' | 'proactive';
 }
 /** 构造 incoming 事件对象（纯函数，可测） */
 export declare function buildIncomingHookEvent(input: IncomingHookInput): WeixinHookIncomingEvent;

package/lib/{weixin-route-jA0qENOf.js → weixin-route-BJ4g4ZNq.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-CX48YNUL.js";
+import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-DAsSHsub.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { createHash } from "node:crypto";
@@ -77,7 +77,9 @@ function checkLocalstoreGitCompliance(root) {
 		reason: `localstore.json must not be committed (localstore.gitTrack=deny default) but .gitignore does not cover it — add ${LOCALSTORE_FILENAME} to .gitignore (or set localstore.gitTrack=allow to explicitly permit)`
 	};
 }
-/** 读取全文件（顶层分节）；文件不存在/坏 JSON 返回空 */
+/** 已告警的坏 localstore 路径（进程级去重；F-07：凭据文件损坏不得静默） */
+const warnedBrokenStores = /* @__PURE__ */ new Set();
+/** 读取全文件（顶层分节）；文件不存在 → 空；**坏 JSON → 空 + 响亮告警**（每路径一次） */
 function readAll(root) {
 	const p = localstorePath(root);
 	if (!existsSync(p)) return {};
@@ -85,7 +87,11 @@ function readAll(root) {
 		const v = JSON.parse(readFileSync(p, "utf-8").replace(/^\uFEFF/, ""));
 		if (v && typeof v === "object" && !Array.isArray(v)) return v;
 		return {};
-	} catch {
+	} catch (err) {
+		if (!warnedBrokenStores.has(p)) {
+			warnedBrokenStores.add(p);
+			console.warn(`[serenity-hooks] ✗ localstore 解析失败，已按空存储继续（其中凭据/配置对工具表现为"未设置"，请修 JSON）: ${p} — ${String(err?.message ?? err)}`);
+		}
 		return {};
 	}
 }

package/lib/weixin-send-api.d.ts

@@ -0,0 +1,87 @@
+/**
+ * weixin-send-api.ts — 主动发送入口（S142 v1.30.9，用户需求"微信桥支持被调用发消息给指定用户"）
+ *
+ * 形态（用户拍板 A2）：**独立监听器，只绑 127.0.0.1**（默认 3082，plugin 全局配置 weixinApi）。
+ * 为什么不挂在主 webServer(3080) 上：3080 会被 3081 公网网关原样反代（含全部请求头），
+ * 而 3081 的登录态属于"家庭账号"——一旦挂上去，任何已登录的外部用户都能冒充 bot 发消息。
+ * 独立 loopback 监听器则**不经网关、公网不可达**，因此不做共享密钥；仍校验来源地址。
+ *
+ * 调用者 = CCC 自己的 MSM（`msm weixin-send ...`）：ACC **不新增工具**，只多一个本机 HTTP 面。
+ * 发送与记录都经 `weixin-bridge.sendProactiveText` → 复用既有 outgoing hook（`source: 'proactive'`）。
+ *
+ * 契约：
+ *   POST /send   { ccc: "<名称|绝对路径>", user: "<from_user_id>", text: "...", accountId?: "wechat-1" }
+ *     → 200 { ok: true, accountId, userId, sessionId, role }
+ *     → 4xx/5xx { ok: false, code, error, remediation? }
+ *   GET  /health → 200 { ok: true, port }
+ *
+ * 职责切分（E↑）：**别名 → id 的解析归 CCC**（MSM 读该 CCC localstore 的 WEIXIN_USER_*）；
+ * 本入口只接受 iLink 形式的 id。协议、账号选择、记录归桥。
+ */
+import { type ServerResponse } from 'node:http';
+import type { Context } from 'cordis';
+import { weixinSendEndpoint } from './weixin-send-endpoint.js';
+export { weixinSendEndpoint };
+/** 文本长度上限（微信侧单条消息实践上限；超限拒绝而非静默截断） */
+export declare const WEIXIN_SEND_MAX_TEXT = 4000;
+/** 当前入口地址（MSM 环境变量注入用；未启动 → null）——状态在叶模块（msm-ops 零依赖读取） */
+/** 测试辅助：读取当前监听端口（生产零调用） */
+export declare function weixinSendPort(): number | null;
+/** 来源必须是 loopback（127.0.0.1 / ::1 / IPv4-mapped） */
+export declare function isLoopbackAddress(address: string | undefined): boolean;
+export interface ParsedSendRequest {
+    ok: true;
+    ccc: string;
+    user: string;
+    text: string;
+    accountId?: string;
+}
+export type ParseResult = ParsedSendRequest | {
+    ok: false;
+    error: string;
+    remediation?: string;
+};
+/**
+ * 校验并归一 /send 请求体（纯函数，可测）。
+ * 只做**结构**校验：ccc 必填（无隐式当前 CCC——用户拍板）、user 必须是 iLink id 形式、text 非空且不超限。
+ */
+export declare function parseSendRequest(body: unknown): ParseResult;
+/** CCC 候选（名称/路径解析用） */
+export interface CccCandidate {
+    root: string;
+    /** basename（工作目录名） */
+    dirName: string;
+    /** `.serenity` 首行声明的 CCC 名（可能为 null） */
+    cccName: string | null;
+}
+/**
+ * 按名称/路径解析 CCC 根（纯函数，可测）。
+ * 匹配顺序：① 绝对路径精确/上溯 ② 目录名 ③ `.serenity` 首行名（大小写不敏感）。
+ * 歧义（多个同名）→ 报错并列出候选（不猜——用户拍板"ccc 必须指定"）。
+ */
+export declare function matchCcc(input: string, candidates: CccCandidate[]): {
+    ok: true;
+    root: string;
+} | {
+    ok: false;
+    error: string;
+    remediation?: string;
+};
+/** 单请求处理（导出供测试直接驱动，不经真实端口） */
+export declare function handleWeixinSendRequest(ctx: Context, req: {
+    method?: string;
+    url?: string;
+    socket?: {
+        remoteAddress?: string;
+    };
+    [Symbol.asyncIterator]?: unknown;
+}, res: ServerResponse): Promise<void>;
+/** 启动监听器（仅 127.0.0.1）；已启动 → 幂等返回 */
+export declare function startWeixinSendApi(ctx: Context, port: number): Promise<number>;
+/** 停止监听器（幂等） */
+export declare function stopWeixinSendApi(): void;
+/**
+ * 装配（index.ts apply 调用）：按 plugin 全局配置 weixinApi 启停，配置变化热同步。
+ * 默认启用（仅 loopback，零公网暴露）；`enabled:false` 或 `port:0` 关闭。
+ */
+export declare function registerWeixinSendApi(ctx: Context): void;

package/lib/weixin-send-endpoint.d.ts

@@ -0,0 +1,17 @@
+/**
+ * weixin-send-endpoint.ts — 主动发送入口地址的**零依赖叶模块**（v1.30.9，S142）
+ *
+ * 为什么单独一个模块（R↓）：地址的读者是 `msm-ops.buildMsmEnv`（把地址注入 MSM 子进程 env），
+ * 写者才是 `weixin-send-api`（监听器启停）。若 msm-ops 直接 import weixin-send-api，
+ * 静态依赖链会拖进整条微信桥栈（weixin-bridge → skiff-core → `@deepseek-ai/dsh-llm`）——
+ * 后果实测：`acc-extras` / `ops` / `skiff-admin` 三个测试套件因解析不到宿主包而**整文件加载失败**
+ * （它们只用到 MSM 注册表逻辑）。叶模块把「读」与「写」解耦：读者零依赖，写者自己承担重量。
+ *
+ * 同款先例：`host/effect.ts`（拆卸登记）、`agent-idle.ts`（等待结算）。
+ */
+/** 设置当前入口地址（weixin-send-api 启停时调用；null = 未启动） */
+export declare function setWeixinSendEndpoint(value: string | null): void;
+/** 当前入口地址（形如 http://127.0.0.1:3082；未启动 → null） */
+export declare function weixinSendEndpoint(): string | null;
+/** 测试辅助：重置（进程内单例，测试间隔离用） */
+export declare function resetWeixinSendEndpointForTest(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.30.5",
+  "version": "1.30.9",
   "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": {