@shgroup/dsh-serenity-hooks 1.32.0 → 1.34.1

package/lib/wake-registry-CYxIb484.js

@@ -0,0 +1,257 @@
+import { dirname, join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+//#region src/wake-registry.ts
+/**
+* wake-registry.ts — trajectory 唤醒注册表（D58，S142 2026-09-13）
+*
+* 需求（用户原话）：一个 CCC 内允许多个 trajectory 任意形态并行；某个 trajectory 可以
+* **预定未来唤醒自己或别人**，本质上是一次「未来时刻 + 一条 message」的投递；autopilot
+* 是「周期自唤醒」的特例（独立循环，D59）。协作边界：互相可见、**无阻塞无等待**。
+*
+* 本模块只负责**注册表本身**（纯数据层，无宿主依赖，可单测）：
+*  - 落点：CCC 内 `AGENT_SESSIONS/wake-registry.json`（随 CCC git，人可读可审计）
+*  - 状态机：`pending` →（投递成功）`delivered`｜（超补跑窗口）`missed`｜（`wake rm` 物理移除）
+*  - 投递即终结：一次性，不重投（无回执语义——发起方不 await，见设计文档 §2）
+*
+* 调度与投递在 `wake-scheduler.ts`（需要 ctx），本模块保持纯净。
+*/
+/** 注册表相对 CCC 根的路径（与 `.bindings.json` 同居 AGENT_SESSIONS/） */
+const WAKE_REGISTRY_REL_PATH = "AGENT_SESSIONS/wake-registry.json";
+/** 注册表格式版本（结构变更时 +1；读取端只接受本版本） */
+const WAKE_REGISTRY_VERSION = 1;
+/**
+* 补跑窗口（缺省 2h）：dsh 停机期间到期的条目，若迟到不超过本窗口则补投，
+* 超过则置 `missed` 留痕（不补投——避免"半夜该做的事早上突然连环跑"）。
+*/
+const WAKE_CATCH_UP_MS = 72e5;
+/** 注册表绝对路径 */
+function wakeRegistryPath(root) {
+	return join(root, WAKE_REGISTRY_REL_PATH);
+}
+/** 空注册表 */
+function emptyRegistry() {
+	return {
+		version: WAKE_REGISTRY_VERSION,
+		entries: []
+	};
+}
+/** 条目形状校验（容忍手改：字段缺失/类型不符 → 丢弃该条，不阻断整表） */
+function asEntry(value) {
+	const e = value;
+	if (!e || typeof e.id !== "string" || typeof e.target !== "string") return null;
+	if (typeof e.at !== "string" || typeof e.message !== "string") return null;
+	const state = e.state === "delivered" || e.state === "missed" || e.state === "cancelled" ? e.state : "pending";
+	return {
+		id: e.id,
+		target: e.target,
+		at: e.at,
+		message: e.message,
+		state,
+		createdBy: typeof e.createdBy === "string" ? e.createdBy : "",
+		createdAt: typeof e.createdAt === "string" ? e.createdAt : "",
+		attempts: typeof e.attempts === "number" && Number.isFinite(e.attempts) ? e.attempts : 0,
+		lastResult: typeof e.lastResult === "string" ? e.lastResult : null,
+		deliveredAt: typeof e.deliveredAt === "string" ? e.deliveredAt : null
+	};
+}
+/**
+* 读注册表。文件缺失 → 空表；损坏 → 空表 + error（不抛错，调用方决定是否告警）。
+* @param root CCC 根
+* @returns 注册表与读取错误（无错为 null）
+*/
+function loadWakeRegistry(root) {
+	const path = wakeRegistryPath(root);
+	if (!existsSync(path)) return {
+		registry: emptyRegistry(),
+		error: null
+	};
+	try {
+		const parsed = JSON.parse(readFileSync(path, "utf-8"));
+		const raw = Array.isArray(parsed.entries) ? parsed.entries : [];
+		const entries = [];
+		for (const item of raw) {
+			const e = asEntry(item);
+			if (e) entries.push(e);
+		}
+		return {
+			registry: {
+				version: WAKE_REGISTRY_VERSION,
+				entries
+			},
+			error: null
+		};
+	} catch (err) {
+		return {
+			registry: emptyRegistry(),
+			error: `唤醒注册表解析失败（${String(err?.message ?? err)}）`
+		};
+	}
+}
+/** 原子写（tmp + rename；与 .bindings.json 同款形态） */
+function saveWakeRegistry(root, registry) {
+	const path = wakeRegistryPath(root);
+	try {
+		mkdirSync(dirname(path), { recursive: true });
+		const tmp = `${path}.tmp`;
+		writeFileSync(tmp, `${JSON.stringify({
+			version: WAKE_REGISTRY_VERSION,
+			entries: registry.entries
+		}, null, 2)}\n`, "utf-8");
+		renameSync(tmp, path);
+		return {
+			ok: true,
+			error: null
+		};
+	} catch (err) {
+		return {
+			ok: false,
+			error: `唤醒注册表写入失败（${String(err?.message ?? err)}）`
+		};
+	}
+}
+/** 条目 id：`w-<UTC 到分钟>-<4 hex>`（可读 + 低碰撞；不复用由"物理移除"保证） */
+function newWakeId(nowMs, rand = Math.random) {
+	const iso = new Date(nowMs).toISOString();
+	return `w-${`${iso.slice(0, 10).replace(/-/g, "")}-${iso.slice(11, 16).replace(":", "")}`}-${Math.floor(rand() * 65536).toString(16).padStart(4, "0")}`;
+}
+/**
+* 解析唤醒时刻。接受两种写法（设计文档 §7）：
+*  - 绝对：RFC3339（含时区偏移，如 `2026-09-14T09:00:00+08:00`）
+*  - 相对：`+30m` / `+2h`（便于 agent 直接登记"半小时后"）
+* @param input 用户/agent 传入的时刻串
+* @param nowMs 当前时刻（相对写法基准）
+* @returns `{ ok, ms }` 或 `{ ok: false, error }`
+*/
+function parseWakeAt(input, nowMs) {
+	const raw = input.trim();
+	if (raw === "") return {
+		ok: false,
+		error: "时刻为空"
+	};
+	const rel = /^\+(\d+(?:\.\d+)?)([mhd])$/.exec(raw);
+	if (rel) {
+		const n = Number(rel[1]);
+		const unit = rel[2];
+		return {
+			ok: true,
+			ms: nowMs + n * (unit === "m" ? 6e4 : unit === "h" ? 36e5 : 864e5)
+		};
+	}
+	const ms = Date.parse(raw);
+	if (!Number.isFinite(ms)) return {
+		ok: false,
+		error: `时刻无法解析（须 RFC3339 或 +30m/+2h）: ${raw}`
+	};
+	return {
+		ok: true,
+		ms
+	};
+}
+/**
+* 登记一条唤醒。
+* @param root CCC 根
+* @param input 目标 trajectory / 时刻串 / message / 发起者 / 当前时刻
+* @returns 成功返回条目，失败返回稳定错误文案（不抛错）
+*/
+function addWake(root, input) {
+	const target = input.target.trim();
+	if (target === "") return {
+		ok: false,
+		error: "target 为空（须 S### 或 AGENT_SESSIONS 目录名）"
+	};
+	const message = input.message.trim();
+	if (message === "") return {
+		ok: false,
+		error: "message 为空（唤醒必须携带一条信息）"
+	};
+	const parsed = parseWakeAt(input.at, input.nowMs);
+	if (!parsed.ok) return {
+		ok: false,
+		error: parsed.error
+	};
+	if (parsed.ms <= input.nowMs) return {
+		ok: false,
+		error: "时刻必须在未来（唤醒只允许可预期的未来）"
+	};
+	const { registry, error } = loadWakeRegistry(root);
+	if (error) return {
+		ok: false,
+		error
+	};
+	const entry = {
+		id: newWakeId(input.nowMs),
+		target,
+		at: new Date(parsed.ms).toISOString(),
+		message,
+		state: "pending",
+		createdBy: input.createdBy,
+		createdAt: new Date(input.nowMs).toISOString(),
+		attempts: 0,
+		lastResult: null,
+		deliveredAt: null
+	};
+	registry.entries.push(entry);
+	const saved = saveWakeRegistry(root, registry);
+	if (!saved.ok) return {
+		ok: false,
+		error: saved.error ?? "写入失败"
+	};
+	return {
+		ok: true,
+		entry
+	};
+}
+/**
+* 到期切分（纯函数，可单测）：
+*  - `due`：`state === 'pending'` 且 `now >= at`（在补跑窗口内）→ 应投递
+*  - `expired`：`state === 'pending'` 且 `now - at > catchUpMs` → 应置 missed（不投递）
+* @param registry 注册表
+* @param nowMs 当前时刻
+* @param catchUpMs 补跑窗口
+*/
+function splitDueWakes(registry, nowMs, catchUpMs = WAKE_CATCH_UP_MS) {
+	const due = [];
+	const expired = [];
+	for (const e of registry.entries) {
+		if (e.state !== "pending") continue;
+		const at = Date.parse(e.at);
+		if (!Number.isFinite(at) || nowMs < at) continue;
+		if (nowMs - at > catchUpMs) expired.push(e);
+		else due.push(e);
+	}
+	return {
+		due,
+		expired
+	};
+}
+/**
+* 更新一条（状态推进；调用方给最终状态与结果文案）。
+* @param root CCC 根
+* @param id 条目 id
+* @param patch 要写入的字段
+* @returns 写入结果
+*/
+function updateWake(root, id, patch) {
+	const { registry, error } = loadWakeRegistry(root);
+	if (error) return {
+		ok: false,
+		error
+	};
+	const entry = registry.entries.find((e) => e.id === id);
+	if (!entry) return {
+		ok: false,
+		error: `wake_not_found: ${id}`
+	};
+	Object.assign(entry, patch);
+	return saveWakeRegistry(root, registry);
+}
+/** 列条目（默认全量；`pendingOnly` 只列在办项——面板/工具用） */
+function listWakes(root, opts = {}) {
+	const { registry, error } = loadWakeRegistry(root);
+	return {
+		entries: [...opts.pendingOnly ? registry.entries.filter((e) => e.state === "pending") : registry.entries].sort((a, b) => Date.parse(a.at) - Date.parse(b.at)),
+		error
+	};
+}
+//#endregion
+export { splitDueWakes as a, loadWakeRegistry as i, addWake as n, updateWake as o, listWakes as r, WAKE_CATCH_UP_MS as t };

package/lib/wake-registry.d.ts

@@ -12,17 +12,13 @@
  *
  * 调度与投递在 `wake-scheduler.ts`（需要 ctx），本模块保持纯净。
  */
-/** 注册表相对 CCC 根的路径（与 `.bindings.json` 同居 AGENT_SESSIONS/） */
-export declare const WAKE_REGISTRY_REL_PATH = "AGENT_SESSIONS/wake-registry.json";
-/** 注册表格式版本（结构变更时 +1；读取端只接受本版本） */
-export declare const WAKE_REGISTRY_VERSION = 1;
 /**
  * 补跑窗口（缺省 2h）：dsh 停机期间到期的条目，若迟到不超过本窗口则补投，
  * 超过则置 `missed` 留痕（不补投——避免"半夜该做的事早上突然连环跑"）。
  */
 export declare const WAKE_CATCH_UP_MS: number;
 /** 条目状态：一次性唤醒只有这四种归宿 */
-export type WakeState = 'pending' | 'delivered' | 'missed' | 'cancelled';
+type WakeState = 'pending' | 'delivered' | 'missed' | 'cancelled';
 /** 一条唤醒条目 */
 export interface WakeEntry {
     /** 稳定 id（不复用；`w-<UTC 到分钟>-<4 hex>`） */
@@ -47,7 +43,7 @@ export interface WakeEntry {
     deliveredAt: string | null;
 }
 /** 注册表文件形态 */
-export interface WakeRegistry {
+interface WakeRegistry {
     version: number;
     entries: WakeEntry[];
 }
@@ -62,11 +58,6 @@ export declare function loadWakeRegistry(root: string): {
     registry: WakeRegistry;
     error: string | null;
 };
-/** 原子写（tmp + rename；与 .bindings.json 同款形态） */
-export declare function saveWakeRegistry(root: string, registry: WakeRegistry): {
-    ok: boolean;
-    error: string | null;
-};
 /** 条目 id：`w-<UTC 到分钟>-<4 hex>`（可读 + 低碰撞；不复用由"物理移除"保证） */
 export declare function newWakeId(nowMs: number, rand?: () => number): string;
 /**
@@ -144,3 +135,4 @@ export declare function listWakes(root: string, opts?: {
     entries: WakeEntry[];
     error: string | null;
 };
+export {};

package/lib/wake-scheduler.d.ts

@@ -17,17 +17,31 @@
  *     → `sessionController` 缺席（headless profile）⇒ 仅投递 live 目标，**不静默**
  *  4. 投递：`agent.followup(...)`（"Queue an ordinary follow-up turn and wake the driver"）
  *
- * 守卫（I-4 默认）：全局 `trajectoryEnabled`（旧键 `autopilotEnabled` 回退）｜
+ * 守卫（I-4 默认 + v1.34 S-1 解耦）：全局 `wakeSchedulerEnabled`（**缺省开**；**不再**回退旧键
+ * `autopilotEnabled`——关周期自唤醒不得连带关一次性唤醒）｜
  * 补跑窗口 2h（超窗置 missed 留痕）｜同 tick 串行｜唤起后维持 live（人类可介入）。
  */
 import type { Context } from 'cordis';
-import type { Agent } from '@deepseek-ai/dsh-agent';
+import { type ClockRuntime } from './clock-runtime.js';
 import { type WakeEntry } from './wake-registry.js';
 /** 投递结果（写回条目的 lastResult；人读） */
-export interface WakeDeliveryResult {
+interface WakeDeliveryResult {
     ok: boolean;
     detail: string;
 }
+/**
+ * 调度器**进程态**（诊断用，模块级 = 进程级，正是诊断对象）。
+ *
+ * 为什么需要它（R↓，2026-09-14 F 段缺陷）：调度器此前**没有任何可观测面**——
+ * "条目为何一直是 pending" 只能靠反推。有了这几个字段，`acc-diag` 一次调用即可回答
+ * "时钟是否武装 / 上次 tick 何时 / 为何跳过"。
+ *
+ * C6b（P2）：字段由 {@link ClockRuntime} 提供（**工厂那份**，字段名与语义一个字未改）；
+ * 此处只把 `lastTickLog` 收为**必需**（本钟独有，autopilot 没有它——现状稿 §2.4）。
+ */
+export type WakeSchedulerRuntime = ClockRuntime & {
+    lastTickLog: string[];
+};
 /** 目标定位：目录名 + SESSION.md 绝对路径 */
 interface WakeTarget {
     dirName: string;
@@ -40,21 +54,12 @@ interface WakeTarget {
  * @returns 命中返回目录信息，未命中 null
  */
 export declare function resolveWakeTarget(root: string, target: string): WakeTarget | null;
-/** 全局闸：`trajectoryEnabled` 优先，旧键 `autopilotEnabled` 回退（设置服务不可用 → 关） */
-export declare function wakeSchedulerEnabled(): boolean;
-/**
- * 取目标 agent：live 优先 → 冷会话走 sessionController.resolveAgent → 标题回退。
- * @param ctx 插件上下文
- * @param root CCC 根
- * @param dirName 目标 trajectory 目录名
- * @returns 命中返回 agent 与取得方式（how 进 lastResult，便于诊断）；未命中返回原因
- */
-export declare function acquireWakeAgent(ctx: Context, root: string, dirName: string): Promise<{
-    agent: Agent;
-    how: string;
-} | {
-    error: string;
-}>;
+/** 调度器进程态快照（只读；`enabled` = 全局闸**当前**值，便于区分"未武装"与"闸关"） */
+export declare function wakeSchedulerState(): WakeSchedulerRuntime & {
+    enabled: boolean;
+};
+/** 测试用：复位进程态（避免用例间串味） */
+export declare function __resetWakeSchedulerStateForTest(): void;
 /** 唤醒消息（唤起即投递正文：身份锚定 + 唤醒信息 + 任务） */
 export declare function buildWakeText(entry: WakeEntry, target: WakeTarget): string;
 /**
@@ -65,8 +70,6 @@ export declare function buildWakeText(entry: WakeEntry, target: WakeTarget): str
  * @returns 投递结果（写回 lastResult）
  */
 export declare function deliverWake(ctx: Context, root: string, entry: WakeEntry): Promise<WakeDeliveryResult>;
-/** 一次调度 tick：遍历 live CCC → 到期项串行投递 / 超窗项置 missed；返回人读摘要 */
-export declare function runWakeTick(ctx: Context): Promise<string[]>;
 /**
  * 装配调度器（index.ts apply 调用）：5min tick + 生命周期 disposer +
  * 会话出现/settings 变化时热启动（与 autopilot 同款触发面，互不干扰）。

package/lib/web-fetch-provider.d.ts

@@ -24,27 +24,6 @@
  */
 import type { Context } from 'cordis';
 import type { HttpFetchResolver } from '@deepseek-ai/dsh-web-fetch-http';
-/**
- * 与宿主 `WebError` 同形的最小错误（带机器可路由的 `code`）。
- *
- * 为什么不 import 宿主的 WebError：宿主 peer 包在测试环境不可解析（现有测试全部
- * `vi.mock('@deepseek-ai/dsh-tools')` 同因），而 `dsh-tool-web` 只渲染 `error.message`、
- * 不判 `instanceof`——因此本地错误对象足以满足契约，且让本模块零运行时宿主依赖。
- */
-export declare function fetchError(message: string, code: string): Error;
-/**
- * 传输与配额上限。
- *
- * 值镜像 `@deepseek-ai/dsh-web-fetch-http` 的 Config 默认值（该包 README 的字段表；
- * 它不导出解析后的默认值，`Config` 是 schemastery schema 而非结果）。`userAgent`
- * 运行时取该包导出的 `DEFAULT_USER_AGENT`（单一真相源，不复制字符串）。
- */
-export declare const FETCH_LIMIT_DEFAULTS: {
-    readonly maxResponseBytes: 5000000;
-    readonly maxBodyChars: 100000;
-    readonly timeoutMs: 30000;
-    readonly maxRedirects: 5;
-};
 /** 公网单播 IPv4（拒绝全部保留/私网段——与宿主判定口径一致，只额外放行 fake-ip） */
 export declare function isPublicV4(address: string): boolean;
 /** fake-ip 段判定（198.18.0.0/15） */

package/lib/{weixin-api-PjEhmjlZ.js → weixin-api-CtFYm53S.js}

@@ -18,14 +18,8 @@ import { createCipheriv, createDecipheriv, createHash, randomBytes } from "node:
 * - sendmessage 必须回带 context_token 关联对话
 */
 var weixin_api_exports = /* @__PURE__ */ __exportAll({
-	ILINK_CDN_BASE_URL: () => ILINK_CDN_BASE_URL,
-	ILINK_DEFAULT_BASE_URL: () => ILINK_DEFAULT_BASE_URL,
-	MessageItemType: () => MessageItemType,
-	MessageState: () => MessageState,
-	MessageType: () => MessageType,
 	TypingStatus: () => TypingStatus,
 	aes128EcbDecrypt: () => aes128EcbDecrypt,
-	assertIlinkOk: () => assertIlinkOk,
 	buildClientVersion: () => buildClientVersion,
 	buildMediaDownloadUrl: () => buildMediaDownloadUrl,
 	downloadMedia: () => downloadMedia,
@@ -146,7 +140,7 @@ function assertIlinkOk(endpoint, rawText) {
 async function fetchQRCode(params) {
 	const botType = params.botType ?? "3";
 	const rawText = await apiGet({
-		baseUrl: params.baseUrl ?? "https://ilinkai.weixin.qq.com",
+		baseUrl: params.baseUrl ?? ILINK_DEFAULT_BASE_URL,
 		endpoint: `ilink/bot/get_bot_qrcode?bot_type=${encodeURIComponent(botType)}`,
 		timeoutMs: params.timeoutMs ?? 5e3
 	});
@@ -155,7 +149,7 @@ async function fetchQRCode(params) {
 async function pollQRStatus(params) {
 	try {
 		const rawText = await apiGet({
-			baseUrl: params.baseUrl ?? "https://ilinkai.weixin.qq.com",
+			baseUrl: params.baseUrl ?? ILINK_DEFAULT_BASE_URL,
 			endpoint: `ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(params.qrcode)}`,
 			timeoutMs: params.timeoutMs ?? 35e3
 		});
@@ -272,7 +266,7 @@ async function sendFileMessage(params) {
 	}
 	assertIlinkOk("ilink/bot/getuploadurl", uplRaw);
 	if (!upl.upload_full_url && !upl.upload_param) throw new Error(`getuploadurl 响应缺 upload_full_url/upload_param: ${uplRaw.slice(0, 300)}`);
-	const uploadUrl = upl.upload_full_url ?? `https://novac2c.cdn.weixin.qq.com/c2c/upload?encrypted_query_param=${encodeURIComponent(upl.upload_param ?? "")}&filekey=${encodeURIComponent(upl.filekey ?? fileKey)}`;
+	const uploadUrl = upl.upload_full_url ?? `${ILINK_CDN_BASE_URL}/upload?encrypted_query_param=${encodeURIComponent(upl.upload_param ?? "")}&filekey=${encodeURIComponent(upl.filekey ?? fileKey)}`;
 	const cipher = createCipheriv("aes-128-ecb", aesKey, null);
 	const encBody = Buffer.concat([cipher.update(data), cipher.final()]);
 	const uploadRes = await currentFetch(uploadUrl, {

package/lib/weixin-api.d.ts

@@ -14,26 +14,12 @@
  * - getupdates 长轮询 35s hold；游标 get_updates_buf 从响应原样带回续传
  * - sendmessage 必须回带 context_token 关联对话
  */
-/** iLink API Base URL（腾讯官方） */
-export declare const ILINK_DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com";
-/** CDN Base（媒体上传/下载；P3 媒体期用） */
-export declare const ILINK_CDN_BASE_URL = "https://novac2c.cdn.weixin.qq.com/c2c";
 /** 版本号 → ClientVersion 整数：(major<<16)|(minor<<8)|patch */
 export declare function buildClientVersion(version: string): number;
 /** fetch 注入点（测试替换；生产 = 全局 fetch） */
-export type FetchLike = typeof fetch;
+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;
@@ -44,7 +30,7 @@ export declare function fetchQRCode(params: {
     qrcode_img_content: string;
 }>;
 /** 扫码状态（轮询；1s 间隔建议，5min 有效） */
-export interface QrStatusResult {
+interface QrStatusResult {
     status: string;
     bot_token?: string;
     ilink_bot_id?: string;
@@ -58,7 +44,7 @@ export declare function pollQRStatus(params: {
     timeoutMs?: number;
 }): Promise<QrStatusResult>;
 /** CDN 媒体元数据（下载侧；协议见 docs/weixin-bot-api.md §6） */
-export interface CDNMedia {
+interface CDNMedia {
     encrypt_query_param?: string;
     aes_key?: string;
     encrypt_type?: number;
@@ -116,7 +102,7 @@ export interface WeixinMessage {
     item_list?: WeixinMessageItem[];
     context_token?: string;
 }
-export interface GetUpdatesResp {
+interface GetUpdatesResp {
     ret?: number;
     errcode?: number;
     errmsg?: string;
@@ -131,24 +117,6 @@ export declare function getUpdates(params: {
     getUpdatesBuf?: string;
     timeoutMs?: number;
 }): Promise<GetUpdatesResp>;
-export declare const MessageType: {
-    readonly NONE: 0;
-    readonly USER: 1;
-    readonly BOT: 2;
-};
-export declare const MessageState: {
-    readonly NEW: 0;
-    readonly GENERATING: 1;
-    readonly FINISH: 2;
-};
-export declare const MessageItemType: {
-    readonly NONE: 0;
-    readonly TEXT: 1;
-    readonly IMAGE: 2;
-    readonly VOICE: 3;
-    readonly FILE: 4;
-    readonly VIDEO: 5;
-};
 /** 发文本消息（主动发起时可不带 context_token；md→plain 内置——微信不支持 Markdown）。
  *  v1.30.9：HTTP 200 但 `ret/errcode != 0` → 抛错（此前静默当成功，导致"记录已送达"的假象）。 */
 export declare function sendTextMessage(params: {
@@ -188,7 +156,7 @@ export declare const TypingStatus: {
     readonly TYPING: 1;
     readonly CANCEL: 0;
 };
-export interface GetConfigResp {
+interface GetConfigResp {
     ret?: number;
     errmsg?: string;
     typing_ticket?: string;
@@ -236,3 +204,4 @@ export declare function downloadMedia(params: {
 } | null>;
 /** Markdown → 纯文本（代码块/图片/链接/表格/标题/粗斜体/删除线 7 类） */
 export declare function markdownToPlainText(text: string): string;
+export {};

package/lib/weixin-bridge.d.ts

@@ -17,26 +17,6 @@ import { type WeixinAccountCredential } from './weixin-route.js';
 import { type WeixinMessage } from './weixin-api.js';
 /** 测试辅助：清空 typing_ticket 缓存（生产零调用） */
 export declare function resetWeixinTypingCache(): void;
-/**
- * 手动输出模式的**机制标记**（v1.30.10 引入；v1.30.16 按 S142 用户"这个词不能让 ACC 定义，
- * 要让 CCC 定义"重构）。
- *
- * 边界（R↓）：ACC 只提供**机制与数据**——"桥不转发最终文本"这个事实 + 三个已填好的参数值
- * （CCC 根 / 账号 / 用户 id）。**纪律措辞归 CCC**：怎么写、必须怎么做、后果是什么，全部写在
- * CCC 的角色提示词文件里（如 `.opencode/skiff/zhaocai.md` 的「输出通道」节），CCC 可随时改，
- * 且 v1.30.15 起角色提示词热重载——改完立即生效，无需 ACC 发版。
- *
- * 为什么不用 ACC 写措辞（历史教训）：v1.30.10~v1.30.15 由 ACC 内嵌一段纪律文案，用户实测
- * "约束不够，LLM 不听"——且措辞迭代要动插件代码 + 发版 + 重启；把措辞放 CCC 才能快速迭代，
- * 也符合"ACC 管机制、CCC 管内容"的归属二分。
- *
- * 标记格式（稳定，供 CCC 提示词引用；v1.31.0 起为 ACC 工具形态）：
- * ```
- * [serenity:weixin-manual-output]
- * im-bridge({channel:"weixin", action:"send", account:"<account>", user:"<user>", text:"<回复>"})
- * ```
- */
-export declare function weixinManualOutputMarker(root: string, accountId: string, userId: string): string;
 /**
  * 手动输出模式的**兜底判定**（纯函数，v1.30.17——把决策矩阵从装配里抽出来，可独立测试）。
  *
@@ -83,8 +63,8 @@ export declare function stopCccBridge(root: string): void;
  */
 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 {
+type ProactiveSendErrorCode = 'BRIDGE_DISABLED' | 'NO_ACCOUNT' | 'ACCOUNT_NOT_FOUND' | 'ACCOUNT_NOT_BOUND' | 'SEND_FAILED';
+interface ProactiveSendInput {
     /** CCC 根（绝对路径；由入口层解析名称/路径后传入） */
     root: string;
     /** 目标用户（iLink from_user_id，形如 xxx@im.wechat；别名解析归调用方） */
@@ -94,7 +74,7 @@ export interface ProactiveSendInput {
     /** 发送账号（缺省 = 该 CCC 第一个启用且已绑定的账号） */
     accountId?: string;
 }
-export type ProactiveSendResult = {
+type ProactiveSendResult = {
     ok: true;
     accountId: string;
     userId: string;
@@ -122,7 +102,7 @@ export type ProactiveSendResult = {
  * @returns 成功含 accountId/userId/sessionId/role；失败含稳定 code 与可行动提示（不抛错）
  */
 /** 账号解析结果（文本 / 文件发送共用） */
-export type WeixinAccountResolution = {
+type WeixinAccountResolution = {
     ok: true;
     accountId: string;
     cred: WeixinAccountCredential;
@@ -154,3 +134,4 @@ export declare function weixinBridgeStatus(): Array<{
  * 事件驱动（对齐 autotrajectory v1.26.15）：live 会话出现 → 同步该 CCC 桥。
  */
 export declare function registerWeixinBridge(ctx: Context): void;
+export {};

package/lib/weixin-hook.d.ts

@@ -13,8 +13,6 @@
  *
  * 定位：Mech 纯逻辑（事件构造纯函数 + 执行器确定性），可独立单测。
  */
-/** hook 执行超时（旁路记录足够；超时 kill 防挂死脚本） */
-export declare const WEIXIN_HOOK_TIMEOUT_MS = 15000;
 /** 媒体引用（hook 事件载荷：kind + 相对 CCC 根路径——CCC 可自行决定是否持久保存媒体） */
 export interface WeixinHookMediaRef {
     kind: 'image' | 'file';
@@ -54,7 +52,7 @@ export interface WeixinHookIncomingEvent extends WeixinHookEventBase {
  *  - `proactive` = 桥被调用主动发给指定用户（CCC MSM 经本机入口发起）
  *  - `reply-fallback`（v1.30.17）= 手动输出模式下 agent 本轮一次都没发送成功 → 桥兜底转发其最终文本
  */
-export type WeixinOutgoingSource = 'reply' | 'proactive' | 'reply-fallback';
+type WeixinOutgoingSource = 'reply' | 'proactive' | 'reply-fallback';
 /** outgoing 事件（bot → 用户）：回复文本（已剥离 think） */
 export interface WeixinHookOutgoingEvent extends WeixinHookEventBase {
     event: 'outgoing';
@@ -69,11 +67,9 @@ export interface WeixinHookOutgoingEvent extends WeixinHookEventBase {
     };
 }
 /** 全部 hook 事件（判别联合） */
-export type WeixinHookEvent = WeixinHookIncomingEvent | WeixinHookOutgoingEvent;
-/** 事件载荷（JSON 序列化：不含任何会话凭据——H5） */
-export type WeixinHookEventJson = WeixinHookEvent;
+type WeixinHookEvent = WeixinHookIncomingEvent | WeixinHookOutgoingEvent;
 /** incoming 事件构造输入（bridge 提供实参） */
-export interface IncomingHookInput {
+interface IncomingHookInput {
     cccRoot: string;
     accountId: string;
     userId: string;
@@ -83,7 +79,7 @@ export interface IncomingHookInput {
     media: WeixinHookMediaRef[];
 }
 /** outgoing 事件构造输入（bridge 提供实参） */
-export interface OutgoingHookInput {
+interface OutgoingHookInput {
     cccRoot: string;
     accountId: string;
     userId: string;
@@ -104,7 +100,7 @@ export declare function buildIncomingHookEvent(input: IncomingHookInput): Weixin
 /** 构造 outgoing 事件对象（纯函数，可测） */
 export declare function buildOutgoingHookEvent(input: OutgoingHookInput): WeixinHookOutgoingEvent;
 /** hook 执行结果（测试/日志用；调用方只关心无异常） */
-export interface WeixinHookRunResult {
+interface WeixinHookRunResult {
     ok: boolean;
     detail?: string;
 }
@@ -115,10 +111,8 @@ export interface WeixinHookRunResult {
  * 脚本缺失 → {ok:false}（配置了但未实现——日志提示；不视为异常）。
  */
 export declare function runWeixinHook(root: string, hookRel: string, event: WeixinHookEvent, timeoutMs?: number): Promise<WeixinHookRunResult>;
-/** 测试辅助：把 WeixinHookEvent 转单行 JSON（脚本侧读取约定） */
-export declare function hookEventToStdinLine(event: WeixinHookEvent): string;
 /** hook runner 签名（可注入——bridge 集成测试捕获事件防真实 spawn flake） */
-export type WeixinHookRunner = (root: string, hookRel: string, event: WeixinHookEvent) => Promise<WeixinHookRunResult>;
+type WeixinHookRunner = (root: string, hookRel: string, event: WeixinHookEvent) => Promise<WeixinHookRunResult>;
 /** 测试辅助：替换 runner（null → 还原真实 spawn 执行）；生产零调用 */
 export declare function setWeixinHookRunnerForTest(runner: WeixinHookRunner | null): void;
 /** bridge 调用入口（转发 activeRunner——默认真实 spawn；测试可注入捕获） */

package/lib/weixin-output-guard.d.ts

@@ -23,7 +23,7 @@ import type { Context } from 'cordis';
 /** 打回上限（超过则放弃并告警——避免与模型无限拉扯） */
 export declare const WEIXIN_OUTPUT_REBUKE_MAX = 2;
 /** 手动模式会话上下文（桥登记） */
-export interface ManualOutputSession {
+interface ManualOutputSession {
     root: string;
     accountId: string;
     userId: string;
@@ -61,3 +61,4 @@ export declare function __resetWeixinOutputGuardForTest(): void;
  * 只对**已登记的手动模式会话**生效——其他会话（主舱/其他 skiff/ACP 临时会话）零干预。
  */
 export declare function registerWeixinOutputGuard(ctx: Context): void;
+export {};