@shgroup/dsh-serenity-hooks 1.26.17 → 1.27.1

package/lib/skiff-debug.d.ts

@@ -69,6 +69,13 @@ export declare function jscSafeJsonText(jsonText: string): string;
  * @param hideThink 为 true 时 `<think>` 内容完全不渲染（public 问答页体验）
  */
 export declare function renderSkiffMarkdown(raw: string, hideThink?: boolean): string;
+/**
+ * 剥离 `<think>…</think>` 块（v1.27.1，微信桥用户反馈："过微信桥回复给用户的消息，
+ * 要去掉 think 标签，用户不应看到"）。复用 extractThinkBlocks 状态机（v1.26.8，
+ * 弃正则）——提取后**只保留正文**（占位符替换为空，think 内容丢弃），
+ * 未闭合 think 优雅截断。适用于纯文本输出面（微信等不支持 think 折叠的通道）。
+ */
+export declare function stripThink(raw: string): string;
 /**
  * 启动调试问答服务（单实例；重复启动幂等返回既有实例）。
  *

package/lib/skiff-role-Dw7UKCUm.js

@@ -0,0 +1,126 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { f as readUtf8, p as resolveInside, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-CfDrlfA7.js";
+import { existsSync } from "node:fs";
+//#region src/skiff-role.ts
+/**
+* skiff-role.ts — Skiff（F4，v1.25.0 实验性）角色层纯逻辑（零 DSH 依赖，可独立单测）
+*
+* 概念（S142 用户拍板）：Skiff = 完整宁静号 trajectory（在宁静号内全知全能）的
+* **任意子集**——CCC 通过角色配置定义：能力面（tools 非 MSM 工具白名单 + msms
+* MSM 白名单，双白名单独立，白名单外全隐藏）+ 轨迹纪律面（trajectory 子集）+
+* 系统提示词（CCC 完整定义，dsp 只给基础部分）。
+*
+* 实验性质：未配置任何角色 → Skiff 完全零影响（无监听、无 agent 创建、guard 无规则）。
+*/
+var skiff_role_exports = /* @__PURE__ */ __exportAll({
+	SKIFF_SESSION_PREFIX: () => SKIFF_SESSION_PREFIX,
+	buildSkiffBasePrompt: () => buildSkiffBasePrompt,
+	isSkiffSessionId: () => isSkiffSessionId,
+	readSkiffRoles: () => readSkiffRoles,
+	resolveRoleSystemPrompt: () => resolveRoleSystemPrompt,
+	roleMsmWhitelist: () => roleMsmWhitelist,
+	roleToolWhitelist: () => roleToolWhitelist,
+	systemPromptSource: () => systemPromptSource,
+	trajectorySubset: () => trajectorySubset
+});
+/** Skiff agent 会话 id 前缀（agents.create 生成；seams 旁路/白名单判定用） */
+const SKIFF_SESSION_PREFIX = "skiff-";
+/** 判定 sessionId 是否为 Skiff 会话（仿 handyman- 前缀排除模式） */
+function isSkiffSessionId(sessionId) {
+	return typeof sessionId === "string" && sessionId.startsWith("skiff-");
+}
+/**
+* 读取 CCC 的 Skiff 角色配置（.opencode/serenity.json skiff.roles）。
+* @returns 名 → 角色配置 的 Map；未配置（无 skiff 段/空 roles）返回空 Map（Skiff 未启用）
+*/
+function readSkiffRoles(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
+	const out = /* @__PURE__ */ new Map();
+	try {
+		const roles = loadSerenityConfig(root, paths).skiff?.roles;
+		if (!roles || typeof roles !== "object") return out;
+		for (const [name, role] of Object.entries(roles)) {
+			if (!role || typeof role !== "object") continue;
+			if (name.trim() === "") continue;
+			out.set(name.trim(), {
+				model: typeof role.model === "string" ? role.model : void 0,
+				msms: Array.isArray(role.msms) ? role.msms.filter((m) => typeof m === "string") : void 0,
+				tools: Array.isArray(role.tools) ? role.tools.filter((t) => typeof t === "string") : void 0,
+				trajectory: role.trajectory && typeof role.trajectory === "object" ? {
+					session: role.trajectory.session === true,
+					keeper: role.trajectory.keeper === true,
+					rebuild: role.trajectory.rebuild === true
+				} : void 0,
+				systemPrompt: typeof role.systemPrompt === "string" ? role.systemPrompt : void 0,
+				systemPromptFile: typeof role.systemPromptFile === "string" ? role.systemPromptFile : void 0
+			});
+		}
+	} catch {}
+	return out;
+}
+function trajectorySubset(role) {
+	return {
+		session: role?.trajectory?.session === true,
+		keeper: role?.trajectory?.keeper === true,
+		rebuild: role?.trajectory?.rebuild === true
+	};
+}
+/** 角色可用工具面（白名单并集）：tools + acc_msm（msms 非空时作为 MSM 通道自动可用） */
+function roleToolWhitelist(role) {
+	const out = /* @__PURE__ */ new Set();
+	for (const t of role?.tools ?? []) out.add(t);
+	if ((role?.msms?.length ?? 0) > 0) out.add("acc_msm");
+	return out;
+}
+/** 角色允许的 MSM 白名单（acc_msm exec 校验 / msm_list 过滤用；独立于 tools 白名单） */
+function roleMsmWhitelist(role) {
+	return new Set(role?.msms ?? []);
+}
+/**
+* 解析角色的系统提示词全文（v1.25.10，S142 用户：超长提示词 JSON 内嵌不可读）：
+* ① `systemPromptFile` 存在 → 读取文件内容（**推荐配置方法**；相对 CCC 根，
+*    路径逃逸拒绝（resolveInside）+ BOM 剥除（readUtf8）+ 存在性校验）
+* ② 否则 → 内嵌 `systemPrompt`（兼容旧配置）
+* ③ 都无 → 空字符串
+* 文件缺失/逃逸 → 抛错（调用方 catch 降级 + validate 报 issue）。
+* 懒读取：readSkiffRoles 不读文件（guards/seams 每次工具调用查询的热路径零 IO），
+* 仅在本函数（创建 agent / validate / list 时）读取。
+*/
+function resolveRoleSystemPrompt(root, role) {
+	if (!role) return "";
+	const file = role.systemPromptFile?.trim();
+	if (file) {
+		const abs = resolveInside(root, file);
+		if (!existsSync(abs)) throw new Error(`skiff role "${role.systemPrompt ?? "(unnamed)"}": systemPromptFile "${file}" not found (resolved: ${abs})`);
+		return readUtf8(abs).trim();
+	}
+	return role.systemPrompt ?? "";
+}
+/** 角色系统提示词来源（validate/list 展示用） */
+function systemPromptSource(role) {
+	if (role?.systemPromptFile?.trim()) return "file";
+	if (role?.systemPrompt?.trim()) return "inline";
+	return "none";
+}
+/**
+* Skiff 基础提示词（dsp 只给这部分；CCC 的 systemPrompt 段由调用方拼接）：
+* 身份 + 可用 MSM/工具清单 + 调用协议 + 边界声明。动态生成（清单来自角色白名单）。
+*/
+function buildSkiffBasePrompt(roleName, role) {
+	const msms = role?.msms ?? [];
+	const tools = role?.tools ?? [];
+	const lines = [
+		"=== Serenity Skiff ===",
+		`Role: ${roleName} (defined by this CCC)`,
+		"You interact with this CCC ONLY through the exposed surface below:"
+	];
+	if (msms.length > 0) lines.push(`  MSMs: ${msms.join(", ")} (call acc_msm exec <name> [args...]; pass --help as the first arg for usage)`);
+	else lines.push("  MSMs: (none)");
+	lines.push(`  Tools: ${tools.length > 0 ? tools.join(", ") : "(none)"}`);
+	lines.push("No other tools are available. Your capability boundary is this surface.");
+	lines.push("");
+	lines.push("---");
+	lines.push("");
+	return lines.join("\n");
+}
+//#endregion
+export { resolveRoleSystemPrompt as a, skiff_role_exports as c, readSkiffRoles as i, systemPromptSource as l, buildSkiffBasePrompt as n, roleMsmWhitelist as o, isSkiffSessionId as r, roleToolWhitelist as s, SKIFF_SESSION_PREFIX as t, trajectorySubset as u };

package/lib/tools/session.d.ts

@@ -18,8 +18,6 @@ import { defineTool } from '@deepseek-ai/dsh-tools';
 import type { Context } from 'cordis';
 import { type ActiveSessionInfo, type CreateSessionResult } from '../session-ops.js';
 export interface RenameOnUseDeps {
-    /** naming.enabled 简单配置（DSH settings） */
-    namingEnabled: boolean;
     /** sessionTitle 服务可用性 */
     sessionTitleAvailable: boolean;
 }
@@ -33,8 +31,8 @@ export interface RenameOnUseDeps {
 export declare function namingTitleFor(active: ActiveSessionInfo): string;
 /**
  * use 激活宁静号会话后，把当前 dsh 会话重命名为命名标题（`S###-日期`）。
- * 门控：naming.enabled + sessionTitle 服务存在；失败不静默——返回结果对象
- * 而非 null（v1.22.9），调用方决定可见性。
+ * v1.27.1：**永远开启**（不再有 naming.enabled 门控）——仅 sessionTitle 服务
+ * 存在性守卫；失败不静默——返回结果对象而非 null（v1.22.9），调用方决定可见性。
  *
  * v1.23.2 修复（this 绑定）：第三参从**解构的裸 rename 函数**改为**整个
  * sessionTitle 服务对象**——内部以 `titles.rename(session, title)` **方法调用**

package/lib/weixin-api-b8HLmcPE.js

@@ -0,0 +1,211 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { randomBytes } from "node:crypto";
+//#region src/weixin-api.ts
+/**
+* weixin-api.ts — 微信个人号 iLink Bot API 客户端（F4c-3，v1.27.0 实验性）
+*
+* 纯 fetch 客户端（Node ≥ 18 原生 fetch + node:crypto），零第三方依赖——
+* 对齐 openclaw-weixin 插件 api.ts 语义（协议全解见 docs/weixin-bot-api.md）。
+*
+* 定位：**Mech 传输层**——只做 HTTP 编解码与请求头，不含业务逻辑（路由/会话映射
+* 在 weixin-route.ts / weixin-bridge.ts）。所有函数可单测（fetch 注入 mock）。
+*
+* 关键协议事实（实证裸调 2026-08-31）：
+* - get_bot_qrcode 无需任何凭据即可取码（无 OpenClaw 账号体系/平台审核）
+* - 鉴权后请求头：AuthorizationType: ilink_bot_token + X-WECHAT-UIN（随机防重放）
+*   + Authorization: Bearer <bot_token> + iLink-App-Id/ClientVersion
+* - getupdates 长轮询 35s hold；游标 get_updates_buf 从响应原样带回续传
+* - 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,
+	buildClientVersion: () => buildClientVersion,
+	fetchQRCode: () => fetchQRCode,
+	getUpdates: () => getUpdates,
+	markdownToPlainText: () => markdownToPlainText,
+	pollQRStatus: () => pollQRStatus,
+	sendTextMessage: () => sendTextMessage
+});
+/** iLink API Base URL（腾讯官方） */
+const ILINK_DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com";
+/** iLink-App-Id（openclaw-weixin 同款） */
+const ILINK_APP_ID = "bot";
+/** 通道版本（对齐 openclaw-weixin 2.1.1；buildClientVersion 编码） */
+const CHANNEL_VERSION = "2.1.1";
+/** 版本号 → ClientVersion 整数：(major<<16)|(minor<<8)|patch */
+function buildClientVersion(version) {
+	const parts = version.split(".").map((p) => parseInt(p, 10));
+	const major = parts[0] ?? 0;
+	const minor = parts[1] ?? 0;
+	const patch = parts[2] ?? 0;
+	return (major & 255) << 16 | (minor & 255) << 8 | patch & 255;
+}
+const CLIENT_VERSION = buildClientVersion(CHANNEL_VERSION);
+/** 随机 X-WECHAT-UIN（uint32 → base64；每请求不同，防重放） */
+function randomWechatUin() {
+	const uint32 = randomBytes(4).readUInt32BE(0);
+	return Buffer.from(String(uint32), "utf-8").toString("base64");
+}
+function ensureTrailingSlash(url) {
+	return url.endsWith("/") ? url : `${url}/`;
+}
+function buildCommonHeaders() {
+	return {
+		"iLink-App-Id": ILINK_APP_ID,
+		"iLink-App-ClientVersion": String(CLIENT_VERSION)
+	};
+}
+function buildHeaders(token) {
+	return {
+		"Content-Type": "application/json",
+		AuthorizationType: "ilink_bot_token",
+		"X-WECHAT-UIN": randomWechatUin(),
+		...token ? { Authorization: `Bearer ${token}` } : {},
+		...buildCommonHeaders()
+	};
+}
+let currentFetch = (...args) => fetch(...args);
+async function apiGet(params) {
+	const base = ensureTrailingSlash(params.baseUrl);
+	const url = new URL(params.endpoint, base);
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), params.timeoutMs);
+	try {
+		const res = await currentFetch(url.toString(), {
+			method: "GET",
+			headers: buildCommonHeaders(),
+			signal: controller.signal
+		});
+		clearTimeout(timer);
+		const rawText = await res.text();
+		if (!res.ok) throw new Error(`${params.endpoint} ${res.status}: ${rawText}`);
+		return rawText;
+	} catch (err) {
+		clearTimeout(timer);
+		throw err;
+	}
+}
+async function apiPost(params) {
+	const base = ensureTrailingSlash(params.baseUrl);
+	const url = new URL(params.endpoint, base);
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), params.timeoutMs);
+	try {
+		const res = await currentFetch(url.toString(), {
+			method: "POST",
+			headers: buildHeaders(params.token),
+			body: params.body,
+			signal: controller.signal
+		});
+		clearTimeout(timer);
+		const rawText = await res.text();
+		if (!res.ok) throw new Error(`${params.endpoint} ${res.status}: ${rawText}`);
+		return rawText;
+	} catch (err) {
+		clearTimeout(timer);
+		throw err;
+	}
+}
+/** 取登录二维码（无需凭据；实证裸调可用） */
+async function fetchQRCode(params) {
+	const botType = params.botType ?? "3";
+	const rawText = await apiGet({
+		baseUrl: params.baseUrl ?? "https://ilinkai.weixin.qq.com",
+		endpoint: `ilink/bot/get_bot_qrcode?bot_type=${encodeURIComponent(botType)}`,
+		timeoutMs: params.timeoutMs ?? 5e3
+	});
+	return JSON.parse(rawText);
+}
+async function pollQRStatus(params) {
+	try {
+		const rawText = await apiGet({
+			baseUrl: params.baseUrl ?? "https://ilinkai.weixin.qq.com",
+			endpoint: `ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(params.qrcode)}`,
+			timeoutMs: params.timeoutMs ?? 35e3
+		});
+		return JSON.parse(rawText);
+	} catch {
+		return { status: "wait" };
+	}
+}
+/** 长轮询收消息（35s hold；超时返回空 msgs 不报错——对齐 openclaw-weixin） */
+async function getUpdates(params) {
+	const timeout = params.timeoutMs ?? 35e3;
+	try {
+		const rawText = await apiPost({
+			baseUrl: params.baseUrl,
+			endpoint: "ilink/bot/getupdates",
+			body: JSON.stringify({ get_updates_buf: params.getUpdatesBuf ?? "" }),
+			token: params.token,
+			timeoutMs: timeout
+		});
+		return JSON.parse(rawText);
+	} catch (err) {
+		if (err instanceof Error && err.name === "AbortError") return {
+			ret: 0,
+			msgs: [],
+			get_updates_buf: params.getUpdatesBuf
+		};
+		throw err;
+	}
+}
+const MessageType = {
+	NONE: 0,
+	USER: 1,
+	BOT: 2
+};
+const MessageState = {
+	NEW: 0,
+	GENERATING: 1,
+	FINISH: 2
+};
+const MessageItemType = {
+	NONE: 0,
+	TEXT: 1,
+	IMAGE: 2,
+	VOICE: 3,
+	FILE: 4,
+	VIDEO: 5
+};
+/** 发文本消息（必须回带 context_token 关联对话；md→plain 内置——微信不支持 Markdown） */
+async function sendTextMessage(params) {
+	const clientId = params.clientId ?? `dsp-weixin-${randomBytes(4).toString("hex")}`;
+	await apiPost({
+		baseUrl: params.baseUrl,
+		endpoint: "ilink/bot/sendmessage",
+		body: JSON.stringify({ msg: {
+			from_user_id: "",
+			to_user_id: params.toUserId,
+			client_id: clientId,
+			message_type: MessageType.BOT,
+			message_state: MessageState.FINISH,
+			item_list: [{
+				type: MessageItemType.TEXT,
+				text_item: { text: markdownToPlainText(params.text) }
+			}],
+			...params.contextToken ? { context_token: params.contextToken } : {}
+		} }),
+		token: params.token,
+		timeoutMs: params.timeoutMs ?? 15e3
+	});
+}
+/** Markdown → 纯文本（代码块/图片/链接/表格/标题/粗斜体/删除线 7 类） */
+function markdownToPlainText(text) {
+	let result = text;
+	result = result.replace(/```[^\n]*\n?([\s\S]*?)```/g, (_, code) => code.trim());
+	result = result.replace(/!\[[^\]]*\]\([^)]*\)/g, "");
+	result = result.replace(/\[([^\]]+)\]\([^)]*\)/g, "$1");
+	result = result.replace(/^\|.*\|[ \t]*$/gm, "");
+	result = result.replace(/^#+\s*/gm, "");
+	result = result.replace(/\*\*([^*]+)\*\*/g, "$1");
+	result = result.replace(/\*([^*]+)\*/g, "$1");
+	result = result.replace(/`([^`]+)`/g, "$1");
+	result = result.replace(/~~([^~]+)~~/g, "$1");
+	return result.trim();
+}
+//#endregion
+export { sendTextMessage as n, weixin_api_exports as r, getUpdates as t };

package/lib/weixin-api.d.ts

@@ -0,0 +1,119 @@
+/**
+ * weixin-api.ts — 微信个人号 iLink Bot API 客户端（F4c-3，v1.27.0 实验性）
+ *
+ * 纯 fetch 客户端（Node ≥ 18 原生 fetch + node:crypto），零第三方依赖——
+ * 对齐 openclaw-weixin 插件 api.ts 语义（协议全解见 docs/weixin-bot-api.md）。
+ *
+ * 定位：**Mech 传输层**——只做 HTTP 编解码与请求头，不含业务逻辑（路由/会话映射
+ * 在 weixin-route.ts / weixin-bridge.ts）。所有函数可单测（fetch 注入 mock）。
+ *
+ * 关键协议事实（实证裸调 2026-08-31）：
+ * - get_bot_qrcode 无需任何凭据即可取码（无 OpenClaw 账号体系/平台审核）
+ * - 鉴权后请求头：AuthorizationType: ilink_bot_token + X-WECHAT-UIN（随机防重放）
+ *   + Authorization: Bearer <bot_token> + iLink-App-Id/ClientVersion
+ * - 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;
+/** 测试注入：替换全局 fetch 实现（生产零调用） */
+export declare function __setWeixinFetchForTest(fn: FetchLike | null): void;
+/** 取登录二维码（无需凭据；实证裸调可用） */
+export declare function fetchQRCode(params: {
+    baseUrl?: string;
+    botType?: string;
+    timeoutMs?: number;
+}): Promise<{
+    qrcode: string;
+    qrcode_img_content: string;
+}>;
+/** 扫码状态（轮询；1s 间隔建议，5min 有效） */
+export interface QrStatusResult {
+    status: string;
+    bot_token?: string;
+    ilink_bot_id?: string;
+    baseurl?: string;
+    ilink_user_id?: string;
+    redirect_host?: string;
+}
+export declare function pollQRStatus(params: {
+    baseUrl?: string;
+    qrcode: string;
+    timeoutMs?: number;
+}): Promise<QrStatusResult>;
+export interface WeixinMessageItem {
+    type?: number;
+    msg_id?: string;
+    text_item?: {
+        text?: string;
+    };
+    image_item?: Record<string, unknown>;
+    voice_item?: Record<string, unknown>;
+    file_item?: Record<string, unknown>;
+    video_item?: Record<string, unknown>;
+}
+export interface WeixinMessage {
+    seq?: number;
+    message_id?: number;
+    from_user_id?: string;
+    to_user_id?: string;
+    client_id?: string;
+    create_time_ms?: number;
+    session_id?: string;
+    group_id?: string;
+    message_type?: number;
+    message_state?: number;
+    item_list?: WeixinMessageItem[];
+    context_token?: string;
+}
+export interface GetUpdatesResp {
+    ret?: number;
+    errcode?: number;
+    errmsg?: string;
+    msgs?: WeixinMessage[];
+    get_updates_buf?: string;
+    longpolling_timeout_ms?: number;
+}
+/** 长轮询收消息（35s hold；超时返回空 msgs 不报错——对齐 openclaw-weixin） */
+export declare function getUpdates(params: {
+    baseUrl: string;
+    token: string;
+    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） */
+export declare function sendTextMessage(params: {
+    baseUrl: string;
+    token: string;
+    toUserId: string;
+    text: string;
+    contextToken?: string;
+    clientId?: string;
+    timeoutMs?: number;
+}): Promise<void>;
+/** Markdown → 纯文本（代码块/图片/链接/表格/标题/粗斜体/删除线 7 类） */
+export declare function markdownToPlainText(text: string): string;

package/lib/weixin-bridge.d.ts

@@ -0,0 +1,56 @@
+/**
+ * weixin-bridge.ts — 微信桥装配（F4c-3，v1.27.0 实验性）
+ *
+ * **CCC 级**：dsh 一个进程含多个 CCC，每个 CCC 独立对接微信桥（S142 用户拍板）——
+ * 扫描 live CCC → 每 CCC 读 weixin 配置（enabled + accounts + routes）→
+ * 启动该 CCC 该账号的 iLink 轮询循环。消息 → weixin-route 路由 → AcpServer 直调
+ * （session/new + session/prompt，同进程不经网络——acp-core 传输无关设计）。
+ *
+ * 实验性质：未配置/未启用 → 完全不启动（零资源占用）。配置变化（面板写入）
+ * → 热重建受影响 CCC 的桥（对齐 gateway 热重建模式）。
+ *
+ * 外部面纯净（D9/D11 延续）：微信桥会话 = 外部面——session/prompt 走
+ * includeTrajectory:false（对外不返回轨迹）；skiff 角色白名单即授权（G9）。
+ */
+import type { Context } from 'cordis';
+import { type WeixinAccountCredential } from './weixin-route.js';
+/**
+ * 处理单条微信消息：路由 → skiff 会话（固定 id 创建/延续）→ 提问 → 回复回写。
+ *
+ * 会话语义：`weixinSessionIdFor(fromUserId)` 固定可重建——同用户长期同一会话；
+ * 进程内已有（getSkiffAgent 命中）→ 延续；无（首次/进程重启）→ createSkiffAgent
+ * 以固定 id 新建（角色不变，记忆从新开始——重启后自动重建，与 3100 问答页同语义）。
+ */
+export declare function handleIncoming(ctx: Context, root: string, _accountId: string, cred: WeixinAccountCredential, msg: {
+    from_user_id?: string;
+    context_token?: string;
+    item_list?: Array<{
+        type?: number;
+        text_item?: {
+            text?: string;
+        };
+    }>;
+}): Promise<void>;
+/**
+ * 启动/重建某 CCC 的桥：读配置 → 对每个 enabled + 有凭据的账号启动轮询循环。
+ * 已存在（配置变化热重建）→ 先停旧循环再启动新的。
+ */
+export declare function syncCccBridge(ctx: Context, root: string): void;
+/** 停止某 CCC 的桥（移除账号/禁用时） */
+export declare function stopCccBridge(root: string): void;
+/** 停止全部桥（插件 dispose） */
+export declare function stopAllBridges(): void;
+/** 桥状态快照（面板数据源）：每 CCC → 每账号 → 轮询健康 */
+export declare function weixinBridgeStatus(): Array<{
+    ccc: string;
+    accounts: Array<{
+        accountId: string;
+        lastPollAt: number;
+        lastError?: string;
+    }>;
+}>;
+/**
+ * 装配（index.ts 调用）：扫描 live CCC 启动桥 + 监听会话变化。
+ * 事件驱动（对齐 autotrajectory v1.26.15）：live 会话出现 → 同步该 CCC 桥。
+ */
+export declare function registerWeixinBridge(ctx: Context): void;