@wecom/wecom-openclaw-plugin 2026.3.31-beta.0 → 2026.4.1-beta.1

package/dist/src/http.js

@@ -1,93 +0,0 @@
-import { ProxyAgent, fetch as undiciFetch } from "undici";
-const proxyDispatchers = new Map();
-/**
- * **getProxyDispatcher (获取代理 Dispatcher)**
- *
- * 缓存并复用 ProxyAgent，避免重复创建连接池。
- */
-function getProxyDispatcher(proxyUrl) {
-    const existing = proxyDispatchers.get(proxyUrl);
-    if (existing)
-        return existing;
-    const created = new ProxyAgent(proxyUrl);
-    proxyDispatchers.set(proxyUrl, created);
-    return created;
-}
-function mergeAbortSignal(params) {
-    const signals = [];
-    if (params.signal)
-        signals.push(params.signal);
-    if (params.timeoutMs && Number.isFinite(params.timeoutMs) && params.timeoutMs > 0) {
-        signals.push(AbortSignal.timeout(params.timeoutMs));
-    }
-    if (!signals.length)
-        return undefined;
-    if (signals.length === 1)
-        return signals[0];
-    return AbortSignal.any(signals);
-}
-/**
- * **wecomFetch (统一 HTTP 请求)**
- *
- * 基于 `undici` 的 fetch 封装，自动处理 ProxyAgent 和 Timeout。
- * 所有对企业微信 API 的调用都应经过此函数。
- */
-export async function wecomFetch(input, init, opts) {
-    const proxyUrl = opts?.proxyUrl?.trim() ?? "";
-    const dispatcher = proxyUrl ? getProxyDispatcher(proxyUrl) : undefined;
-    const initSignal = init?.signal ?? undefined;
-    const signal = mergeAbortSignal({ signal: opts?.signal ?? initSignal, timeoutMs: opts?.timeoutMs });
-    const headers = new Headers(init?.headers ?? {});
-    if (!headers.has("User-Agent")) {
-        headers.set("User-Agent", "OpenClaw/2.0 (WeCom-Agent)");
-    }
-    const nextInit = {
-        ...(init ?? {}),
-        ...(signal ? { signal } : {}),
-        ...(dispatcher ? { dispatcher } : {}),
-        headers,
-    };
-    try {
-        return await undiciFetch(input, nextInit);
-    }
-    catch (err) {
-        if (err instanceof Error && err.name === "TypeError" && err.message === "fetch failed") {
-            const cause = err.cause;
-            console.error(`[wecom-http] fetch failed: ${input} (proxy: ${proxyUrl || "none"})${cause ? ` - cause: ${String(cause)}` : ""}`);
-        }
-        throw err;
-    }
-}
-/**
- * **readResponseBodyAsBuffer (读取响应 Body)**
- *
- * 将 Response Body 读取为 Buffer，支持最大字节限制以防止内存溢出。
- * 适用于下载媒体文件等场景。
- */
-export async function readResponseBodyAsBuffer(res, maxBytes) {
-    if (!res.body)
-        return Buffer.alloc(0);
-    const limit = maxBytes && Number.isFinite(maxBytes) && maxBytes > 0 ? maxBytes : undefined;
-    const chunks = [];
-    let total = 0;
-    const reader = res.body.getReader();
-    while (true) {
-        const { done, value } = await reader.read();
-        if (done)
-            break;
-        if (!value)
-            continue;
-        total += value.byteLength;
-        if (limit && total > limit) {
-            try {
-                await reader.cancel("body too large");
-            }
-            catch {
-                // ignore
-            }
-            throw new Error(`response body too large (>${limit} bytes)`);
-        }
-        chunks.push(value);
-    }
-    return Buffer.concat(chunks.map((c) => Buffer.from(c)));
-}

package/dist/src/interface.js

@@ -1,4 +0,0 @@
-/**
- * 企业微信渠道类型定义
- */
-export {};

package/dist/src/mcp/index.js

@@ -1,6 +0,0 @@
-/**
- * MCP 模块统一导出
- */
-export { createWeComMcpTool } from "./tool.js";
-export { sendJsonRpc, clearCategoryCache, McpRpcError, McpHttpError } from "./transport.js";
-export { cleanSchemaForGemini } from "./schema.js";

package/dist/src/mcp/interceptors/types.js

@@ -1,7 +0,0 @@
-/**
- * MCP call 拦截器类型定义
- *
- * 拦截器用于在 tools/call 调用前后注入特殊逻辑，
- * 如修改超时配置、变换响应结果等，避免在 tool.ts 中堆积 if/else。
- */
-export {};

package/dist/src/shared/command-auth.d.ts

@@ -1,23 +0,0 @@
-import type { OpenClawConfig, PluginRuntime } from "openclaw/plugin-sdk";
-import type { WecomAgentConfig, WecomBotConfig } from "../types/index.js";
-type WecomCommandAuthAccountConfig = Pick<WecomBotConfig, "dmPolicy" | "allowFrom"> | Pick<WecomAgentConfig, "dmPolicy" | "allowFrom">;
-export declare function resolveWecomCommandAuthorization(params: {
-    core: PluginRuntime;
-    cfg: OpenClawConfig;
-    accountConfig: WecomCommandAuthAccountConfig;
-    rawBody: string;
-    senderUserId: string;
-}): Promise<{
-    shouldComputeAuth: boolean;
-    dmPolicy: "pairing" | "allowlist" | "open" | "disabled";
-    senderAllowed: boolean;
-    authorizerConfigured: boolean;
-    commandAuthorized: boolean | undefined;
-    effectiveAllowFrom: string[];
-}>;
-export declare function buildWecomUnauthorizedCommandPrompt(params: {
-    senderUserId: string;
-    dmPolicy: "pairing" | "allowlist" | "open" | "disabled";
-    scope: "bot" | "agent";
-}): string;
-export {};

package/dist/src/shared/command-auth.js

@@ -1,73 +0,0 @@
-function normalizeWecomAllowFromEntry(raw) {
-    return raw
-        .trim()
-        .toLowerCase()
-        .replace(/^wecom:/, "")
-        .replace(/^user:/, "")
-        .replace(/^userid:/, "");
-}
-function isWecomSenderAllowed(senderUserId, allowFrom) {
-    const list = allowFrom.map((entry) => normalizeWecomAllowFromEntry(entry)).filter(Boolean);
-    if (list.includes("*"))
-        return true;
-    const normalizedSender = normalizeWecomAllowFromEntry(senderUserId);
-    if (!normalizedSender)
-        return false;
-    return list.includes(normalizedSender);
-}
-export async function resolveWecomCommandAuthorization(params) {
-    const { core, cfg, accountConfig, rawBody, senderUserId } = params;
-    const dmPolicy = (accountConfig.dmPolicy ?? "pairing");
-    const configAllowFrom = (accountConfig.allowFrom ?? []).map((v) => String(v));
-    const shouldComputeAuth = core.channel.commands.shouldComputeCommandAuthorized(rawBody, cfg);
-    // WeCom channel currently does NOT support the `openclaw pairing` CLI workflow
-    // ("Channel wecom does not support pairing"). So we must not rely on pairing
-    // store approvals for command authorization here.
-    //
-    // Policy semantics:
-    // - open: commands are allowed for everyone by default (unless higher-level access-groups deny).
-    // - allowlist: commands require allowFrom entries.
-    // - pairing: treated the same as allowlist for WeCom (since pairing CLI is unsupported).
-    const effectiveAllowFrom = dmPolicy === "open" ? ["*"] : configAllowFrom;
-    const senderAllowed = isWecomSenderAllowed(senderUserId, effectiveAllowFrom);
-    const allowAllConfigured = effectiveAllowFrom.some((entry) => normalizeWecomAllowFromEntry(entry) === "*");
-    const authorizerConfigured = allowAllConfigured || effectiveAllowFrom.length > 0;
-    const useAccessGroups = cfg.commands?.useAccessGroups !== false;
-    const commandAuthorized = shouldComputeAuth
-        ? core.channel.commands.resolveCommandAuthorizedFromAuthorizers({
-            useAccessGroups,
-            authorizers: [{ configured: authorizerConfigured, allowed: senderAllowed }],
-        })
-        : undefined;
-    return {
-        shouldComputeAuth,
-        dmPolicy,
-        senderAllowed,
-        authorizerConfigured,
-        commandAuthorized,
-        effectiveAllowFrom,
-    };
-}
-export function buildWecomUnauthorizedCommandPrompt(params) {
-    const user = params.senderUserId || "unknown";
-    const policy = params.dmPolicy;
-    const scopeLabel = params.scope === "bot" ? "Bot（智能机器人）" : "Agent（自建应用）";
-    const dmPrefix = params.scope === "bot" ? "channels.wecom.bot" : "channels.wecom.agent";
-    const allowCmd = (value) => `openclaw config set ${dmPrefix}.allowFrom '${value}'`;
-    const policyCmd = (value) => `openclaw config set ${dmPrefix}.dmPolicy "${value}"`;
-    if (policy === "disabled") {
-        return [
-            `无权限执行命令（${scopeLabel} 已禁用：dmPolicy=disabled）`,
-            `触发者：${user}`,
-            `管理员：${policyCmd("open")}（全放开）或 ${policyCmd("allowlist")}（白名单）`,
-        ].join("\n");
-    }
-    // WeCom 不支持 pairing CLI，因此这里统一给出“open / allowlist”两种明确的配置指令
-    return [
-        `无权限执行命令（入口：${scopeLabel}，userid：${user}）`,
-        `管理员全放开：${policyCmd("open")}`,
-        `管理员放行该用户：${policyCmd("allowlist")}`,
-        `然后设置白名单：${allowCmd(JSON.stringify([user]))}`,
-        `如果仍被拦截：检查 commands.useAccessGroups/访问组`,
-    ].join("\n");
-}

package/dist/src/shared/xml-parser.d.ts

@@ -1,46 +0,0 @@
-/**
- * WeCom XML 解析器
- * 用于 Agent 模式解析 XML 格式消息
- */
-import type { WecomAgentInboundMessage } from "../types/index.js";
-/**
- * 解析 XML 字符串为消息对象
- */
-export declare function parseXml(xml: string): WecomAgentInboundMessage;
-/**
- * 从 XML 中提取消息类型
- */
-export declare function extractMsgType(msg: WecomAgentInboundMessage): string;
-/**
- * 从 XML 中提取发送者 ID
- */
-export declare function extractFromUser(msg: WecomAgentInboundMessage): string;
-/**
- * 从 XML 中提取文件名（主要用于 file 消息）
- */
-export declare function extractFileName(msg: WecomAgentInboundMessage): string | undefined;
-/**
- * 从 XML 中提取接收者 ID (CorpID)
- */
-export declare function extractToUser(msg: WecomAgentInboundMessage): string;
-/**
- * 从 XML 中提取群聊 ID
- */
-export declare function extractChatId(msg: WecomAgentInboundMessage): string | undefined;
-/**
- * 从 XML 中提取 AgentID（兼容 AgentID/agentid 等大小写）
- */
-export declare function extractAgentId(msg: WecomAgentInboundMessage): string | number | undefined;
-/**
- * 从 XML 中提取消息内容
- */
-export declare function extractContent(msg: WecomAgentInboundMessage): string;
-/**
- * 从 XML 中提取媒体 ID (Image, Voice, Video)
- * 根据官方文档，MediaId 在 Agent 回调中直接位于根节点
- */
-export declare function extractMediaId(msg: WecomAgentInboundMessage): string | undefined;
-/**
- * 从 XML 中提取 MsgId（用于去重）
- */
-export declare function extractMsgId(msg: WecomAgentInboundMessage): string | undefined;

package/dist/src/shared/xml-parser.js

@@ -1,210 +0,0 @@
-/**
- * WeCom XML 解析器
- * 用于 Agent 模式解析 XML 格式消息
- */
-import { XMLParser } from "fast-xml-parser";
-const xmlParser = new XMLParser({
-    ignoreAttributes: false,
-    trimValues: true,
-    processEntities: false,
-    parseTagValue: false,
-    parseAttributeValue: false,
-});
-/**
- * 解析 XML 字符串为消息对象
- */
-export function parseXml(xml) {
-    const obj = xmlParser.parse(xml);
-    const root = obj?.xml ?? obj;
-    return root ?? {};
-}
-/**
- * 从 XML 中提取消息类型
- */
-export function extractMsgType(msg) {
-    return String(msg.MsgType ?? "").toLowerCase();
-}
-/**
- * 从 XML 中提取发送者 ID
- */
-export function extractFromUser(msg) {
-    return String(msg.FromUserName ?? "");
-}
-/**
- * 从 XML 中提取文件名（主要用于 file 消息）
- */
-export function extractFileName(msg) {
-    const raw = msg.FileName ?? msg.Filename ?? msg.fileName ?? msg.filename;
-    if (raw == null)
-        return undefined;
-    if (typeof raw === "string")
-        return raw.trim() || undefined;
-    if (typeof raw === "number" || typeof raw === "boolean" || typeof raw === "bigint")
-        return String(raw);
-    if (Array.isArray(raw)) {
-        const merged = raw.map((v) => (v == null ? "" : String(v))).join("\n").trim();
-        return merged || undefined;
-    }
-    if (typeof raw === "object") {
-        const obj = raw;
-        const text = (typeof obj["#text"] === "string" ? obj["#text"] :
-            typeof obj["_text"] === "string" ? obj["_text"] :
-                typeof obj["text"] === "string" ? obj["text"] : undefined);
-        if (text && text.trim())
-            return text.trim();
-    }
-    const s = String(raw);
-    return s.trim() || undefined;
-}
-/**
- * 从 XML 中提取接收者 ID (CorpID)
- */
-export function extractToUser(msg) {
-    return String(msg.ToUserName ?? "");
-}
-/**
- * 从 XML 中提取群聊 ID
- */
-export function extractChatId(msg) {
-    return msg.ChatId ? String(msg.ChatId) : undefined;
-}
-/**
- * 从 XML 中提取 AgentID（兼容 AgentID/agentid 等大小写）
- */
-export function extractAgentId(msg) {
-    const raw = msg.AgentID ??
-        msg.AgentId ??
-        msg.agentid ??
-        msg.agentId;
-    if (raw == null)
-        return undefined;
-    if (typeof raw === "string")
-        return raw.trim() || undefined;
-    if (typeof raw === "number")
-        return raw;
-    const asString = String(raw).trim();
-    return asString || undefined;
-}
-/**
- * 从 XML 中提取消息内容
- */
-export function extractContent(msg) {
-    const msgType = extractMsgType(msg);
-    const asText = (value) => {
-        if (value == null)
-            return "";
-        if (typeof value === "string")
-            return value;
-        if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint")
-            return String(value);
-        if (Array.isArray(value))
-            return value.map(asText).filter(Boolean).join("\n");
-        if (typeof value === "object") {
-            const obj = value;
-            // fast-xml-parser 在某些情况下（例如带属性）会把文本放在 "#text"
-            if (typeof obj["#text"] === "string")
-                return obj["#text"];
-            if (typeof obj["_text"] === "string")
-                return obj["_text"];
-            if (typeof obj["text"] === "string")
-                return obj["text"];
-            try {
-                return JSON.stringify(obj);
-            }
-            catch {
-                return String(value);
-            }
-        }
-        return String(value);
-    };
-    switch (msgType) {
-        case "text":
-            return asText(msg.Content);
-        case "voice":
-            // 语音识别结果
-            return asText(msg.Recognition) || "[语音消息]";
-        case "image":
-            return `[图片] ${asText(msg.PicUrl)}`;
-        case "file":
-            return "[文件消息]";
-        case "video":
-            return "[视频消息]";
-        case "location":
-            return `[位置] ${asText(msg.Label)} (${asText(msg.Location_X)}, ${asText(msg.Location_Y)})`;
-        case "link":
-            return `[链接] ${asText(msg.Title)}\n${asText(msg.Description)}\n${asText(msg.Url)}`;
-        case "event":
-            return `[事件] ${asText(msg.Event)} - ${asText(msg.EventKey)}`;
-        default:
-            return `[${msgType || "未知消息类型"}]`;
-    }
-}
-/**
- * 从 XML 中提取媒体 ID (Image, Voice, Video)
- * 根据官方文档，MediaId 在 Agent 回调中直接位于根节点
- */
-export function extractMediaId(msg) {
-    const raw = msg.MediaId ?? msg.MediaID ?? msg.mediaid ?? msg.mediaId;
-    if (raw == null)
-        return undefined;
-    if (typeof raw === "string")
-        return raw.trim() || undefined;
-    if (typeof raw === "number" || typeof raw === "boolean" || typeof raw === "bigint")
-        return String(raw);
-    if (Array.isArray(raw)) {
-        const merged = raw.map((v) => (v == null ? "" : String(v))).join("\n").trim();
-        return merged || undefined;
-    }
-    if (typeof raw === "object") {
-        const obj = raw;
-        const text = (typeof obj["#text"] === "string" ? obj["#text"] :
-            typeof obj["_text"] === "string" ? obj["_text"] :
-                typeof obj["text"] === "string" ? obj["text"] : undefined);
-        if (text && text.trim())
-            return text.trim();
-        try {
-            const s = JSON.stringify(obj);
-            return s.trim() || undefined;
-        }
-        catch {
-            const s = String(raw);
-            return s.trim() || undefined;
-        }
-    }
-    const s = String(raw);
-    return s.trim() || undefined;
-}
-/**
- * 从 XML 中提取 MsgId（用于去重）
- */
-export function extractMsgId(msg) {
-    const raw = msg.MsgId ?? msg.MsgID ?? msg.msgid ?? msg.msgId;
-    if (raw == null)
-        return undefined;
-    if (typeof raw === "string")
-        return raw.trim() || undefined;
-    if (typeof raw === "number" || typeof raw === "boolean" || typeof raw === "bigint")
-        return String(raw);
-    if (Array.isArray(raw)) {
-        const merged = raw.map((v) => (v == null ? "" : String(v))).join("\n").trim();
-        return merged || undefined;
-    }
-    if (typeof raw === "object") {
-        const obj = raw;
-        const text = (typeof obj["#text"] === "string" ? obj["#text"] :
-            typeof obj["_text"] === "string" ? obj["_text"] :
-                typeof obj["text"] === "string" ? obj["text"] : undefined);
-        if (text && text.trim())
-            return text.trim();
-        try {
-            const s = JSON.stringify(obj);
-            return s.trim() || undefined;
-        }
-        catch {
-            const s = String(raw);
-            return s.trim() || undefined;
-        }
-    }
-    const s = String(raw);
-    return s.trim() || undefined;
-}

package/dist/src/target.d.ts

@@ -1,35 +0,0 @@
-/**
- * WeCom Target Resolver (企业微信目标解析器)
- *
- * 解析 OpenClaw 的 `to` 字段（原始目标字符串），将其转换为企业微信支持的具体接收对象。
- * 支持显式前缀 (party:, tag: 等) 和基于规则的启发式推断。
- *
- * **关于“目标发送”与“消息记录”的对应关系 (Target vs Inbound):**
- * - **发送 (Outbound)**: 支持一对多广播 (Party/Tag)。
- *   例如发送给 `party:1`，消息会触达该部门下所有成员。
- * - **接收 (Inbound)**: 总是来自具体的 **用户 (User)** 或 **群聊 (Chat)**。
- *   当成员回复部门广播消息时，可以视为一个新的单聊会话或在该成员的现有单聊中回复。
- *   因此，Outbound Target (如 Party) 与 Inbound Source (User) 不需要也不可能 1:1 强匹配。
- *   广播是“发后即忘” (Fire-and-Forget) 的通知模式，而回复是具体的会话模式。
- */
-export interface WecomTarget {
-    touser?: string;
-    toparty?: string;
-    totag?: string;
-    chatid?: string;
-}
-/**
- * Parses a raw target string into a WeComTarget object.
- * 解析原始目标字符串为 WeComTarget 对象。
- *
- * 逻辑:
- * 1. 移除标准命名空间前缀 (wecom:, qywx: 等)。
- * 2. 检查显式类型前缀 (party:, tag:, group:, user:)。
- * 3. 启发式回退 (无前缀时):
- *    - 以 "wr" 或 "wc" 开头 -> Chat ID (群聊)
- *    - 纯数字 -> Party ID (部门)
- *    - 其他 -> User ID (用户)
- *
- * @param raw - The raw target string (e.g. "party:1", "zhangsan", "wecom:wr123")
- */
-export declare function resolveWecomTarget(raw: string | undefined): WecomTarget | undefined;

package/dist/src/target.js

@@ -1,67 +0,0 @@
-/**
- * WeCom Target Resolver (企业微信目标解析器)
- *
- * 解析 OpenClaw 的 `to` 字段（原始目标字符串），将其转换为企业微信支持的具体接收对象。
- * 支持显式前缀 (party:, tag: 等) 和基于规则的启发式推断。
- *
- * **关于“目标发送”与“消息记录”的对应关系 (Target vs Inbound):**
- * - **发送 (Outbound)**: 支持一对多广播 (Party/Tag)。
- *   例如发送给 `party:1`，消息会触达该部门下所有成员。
- * - **接收 (Inbound)**: 总是来自具体的 **用户 (User)** 或 **群聊 (Chat)**。
- *   当成员回复部门广播消息时，可以视为一个新的单聊会话或在该成员的现有单聊中回复。
- *   因此，Outbound Target (如 Party) 与 Inbound Source (User) 不需要也不可能 1:1 强匹配。
- *   广播是“发后即忘” (Fire-and-Forget) 的通知模式，而回复是具体的会话模式。
- */
-/**
- * Parses a raw target string into a WeComTarget object.
- * 解析原始目标字符串为 WeComTarget 对象。
- *
- * 逻辑:
- * 1. 移除标准命名空间前缀 (wecom:, qywx: 等)。
- * 2. 检查显式类型前缀 (party:, tag:, group:, user:)。
- * 3. 启发式回退 (无前缀时):
- *    - 以 "wr" 或 "wc" 开头 -> Chat ID (群聊)
- *    - 纯数字 -> Party ID (部门)
- *    - 其他 -> User ID (用户)
- *
- * @param raw - The raw target string (e.g. "party:1", "zhangsan", "wecom:wr123")
- */
-export function resolveWecomTarget(raw) {
-    if (!raw?.trim())
-        return undefined;
-    // 1. Remove standard namespace prefixes (移除标准命名空间前缀)
-    let clean = raw.trim().replace(/^(wecom-agent|wecom|wechatwork|wework|qywx):/i, "");
-    // 2. Explicit Type Prefixes (显式类型前缀)
-    if (/^party:/i.test(clean)) {
-        return { toparty: clean.replace(/^party:/i, "").trim() };
-    }
-    if (/^dept:/i.test(clean)) {
-        return { toparty: clean.replace(/^dept:/i, "").trim() };
-    }
-    if (/^tag:/i.test(clean)) {
-        return { totag: clean.replace(/^tag:/i, "").trim() };
-    }
-    if (/^group:/i.test(clean)) {
-        return { chatid: clean.replace(/^group:/i, "").trim() };
-    }
-    if (/^chat:/i.test(clean)) {
-        return { chatid: clean.replace(/^chat:/i, "").trim() };
-    }
-    if (/^user:/i.test(clean)) {
-        return { touser: clean.replace(/^user:/i, "").trim() };
-    }
-    // 3. Heuristics (启发式规则)
-    // Chat ID typically starts with 'wr' or 'wc'
-    // 群聊 ID 通常以 'wr' (外部群) 或 'wc' 开头
-    if (/^(wr|wc)/i.test(clean)) {
-        return { chatid: clean };
-    }
-    // Pure digits are likely Department IDs (Parties)
-    // 纯数字优先被视为部门 ID (Parties)，方便运维配置 (如 "1" 代表根部门)
-    // 如果必须要发送给纯数字 ID 的用户，请使用显式前缀 "user:1001"
-    if (/^\d+$/.test(clean)) {
-        return { toparty: clean };
-    }
-    // Default to User (默认为用户)
-    return { touser: clean };
-}

package/dist/src/template-card-manager.d.ts

@@ -1,55 +0,0 @@
-/**
- * 模板卡片管理器
- *
- * 负责：
- * - 模板卡片缓存管理（内存级，带 TTL 和大小限制）
- * - 卡片交互事件处理（更新卡片 UI 状态）
- * - 模板卡片发送（通过 wsClient.sendMessage 主动推送）
- * - 从 LLM 回复中检测并处理模板卡片
- */
-import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
-import type { WSClient, WsFrame, TemplateCard } from "@wecom/aibot-node-sdk";
-import type { ResolvedWeComAccount } from "./utils.js";
-import type { MessageState, ExtractedTemplateCard } from "./interface.js";
-export declare function saveTemplateCardToCache(params: {
-    accountId: string;
-    templateCard: TemplateCard;
-    runtime: RuntimeEnv;
-}): void;
-export declare function getTemplateCardFromCache(accountId: string, taskId: string): TemplateCard | undefined;
-export declare function updateTemplateCardOnEvent(params: {
-    frame: WsFrame;
-    accountId: string;
-    runtime: RuntimeEnv;
-    wsClient: WSClient;
-}): Promise<void>;
-/**
- * 逐个发送已提取的模板卡片（通过 wsClient.sendMessage 主动推送）
- *
- * 发送失败不阻塞流程，仅记录错误日志。
- */
-export declare function sendTemplateCards(params: {
-    wsClient: WSClient;
-    frame: WsFrame;
-    state: MessageState;
-    account: ResolvedWeComAccount;
-    runtime: RuntimeEnv;
-    cards: ExtractedTemplateCard[];
-}): Promise<void>;
-/**
- * 从累积文本中检测并发送模板卡片。
- *
- * 在 finishThinkingStream 之前调用，将卡片处理和流关闭解耦。
- *
- * @returns 移除卡片代码块后的剩余文本（如果没有卡片则返回 null，表示无需修改）
- */
-export declare function processTemplateCardsIfNeeded(params: {
-    wsClient: WSClient;
-    frame: WsFrame;
-    state: MessageState;
-    account: ResolvedWeComAccount;
-    runtime: RuntimeEnv;
-}): Promise<{
-    remainingText: string;
-    cardsDetected: boolean;
-} | null>;