ylib-wecom-openclaw-plugin 2026.4.29

package/dist/index.js

@@ -0,0 +1,99 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+exports.__esModule = true;
+var plugin_sdk_1 = require("ylib-openclaw/plugin-sdk");
+var channel_js_1 = require("./src/channel.js");
+var config_schema_js_1 = require("./src/config-schema.js");
+var runtime_js_1 = require("./src/runtime.js");
+var const_js_1 = require("./src/const.js");
+var webhook_js_1 = require("./src/agent/webhook.js");
+var index_js_1 = require("./src/webhook/index.js");
+var channel_js_2 = require("./src/channel.js");
+__createBinding(exports, channel_js_2, "wecomPlugin");
+var plugin = {
+    id: "wecom-openclaw-plugin",
+    name: "企业微信",
+    description: "企业微信 OpenClaw 插件",
+    configSchema: plugin_sdk_1.buildChannelConfigSchema(config_schema_js_1.WeComConfigSchema),
+    wecomPlugin: channel_js_1.wecomPlugin,
+    register: function (api) {
+        runtime_js_1.setWeComRuntime(api.runtime);
+        api.registerChannel({ plugin: channel_js_1.wecomPlugin });
+        // 注册 wecom_mcp：通过 HTTP 直接调用企业微信 MCP Server
+        // api.registerTool(
+        //   (ctx: OpenClawPluginToolContext) => {
+        //     const trustedRequesterUserId =
+        //       ctx.messageChannel === CHANNEL_ID ? ctx.requesterSenderId?.trim() ?? undefined : undefined;
+        //     // 按 sessionKey 精确取回「原始大小写」的 chatId / chatType。
+        //     // 数据由 monitor.ts 在消息入站时通过 setSessionChatInfo 写入，
+        //     // 避免 parseSessionKeyChat 反解导致 chatId 被 OpenClaw core 小写化
+        //     // （小写后的 chatId 调用企业微信 aibot_send_biz_msg 会报 invalid chatid）。
+        //     const sessionChat = getSessionChatInfo(ctx.sessionKey);
+        //     console.log(
+        //       `[mcp] registerTool ctx: sessionKey="${ctx.sessionKey}", messageChannel="${ctx.messageChannel}", ` +
+        //       `requesterSenderId="${ctx.requesterSenderId}", agentAccountId="${ctx.agentAccountId}", ` +
+        //       `sessionChat=${JSON.stringify(sessionChat)}`,
+        //     );
+        //     return createWeComMcpTool({
+        //       requesterUserId: trustedRequesterUserId,
+        //       accountId: ctx.agentAccountId,
+        //       chatId: sessionChat?.chatId,
+        //       chatType: sessionChat?.chatType,
+        //     });
+        //   },
+        //   { name: "wecom_mcp" },
+        // );
+        var registerHttpRoute = api.registerHttpRoute;
+        if (typeof registerHttpRoute === "function") {
+            var agentWebhookHandler = webhook_js_1.createWecomAgentWebhookHandler(api.runtime);
+            // 注册 Agent 模式 HTTP 路由（prefix match 覆盖带 accountId 的子路径）
+            registerHttpRoute({
+                path: const_js_1.WEBHOOK_PATHS.AGENT_PLUGIN,
+                handler: agentWebhookHandler,
+                auth: "plugin",
+                match: "prefix"
+            });
+            registerHttpRoute({
+                path: const_js_1.WEBHOOK_PATHS.AGENT,
+                handler: agentWebhookHandler,
+                auth: "plugin",
+                match: "prefix"
+            });
+            // ── 注册 bot Webhook HTTP 路由 ────────────────────────────────────────
+            // 前缀匹配模式，同时覆盖 /plugins/wecom 和 /wecom 路径
+            var webhookRoutes = [const_js_1.WEBHOOK_PATHS.BOT_PLUGIN, const_js_1.WEBHOOK_PATHS.BOT_ALT, const_js_1.WEBHOOK_PATHS.BOT];
+            for (var _i = 0, webhookRoutes_1 = webhookRoutes; _i < webhookRoutes_1.length; _i++) {
+                var routePath = webhookRoutes_1[_i];
+                registerHttpRoute({
+                    path: routePath,
+                    handler: index_js_1.handleWecomWebhookRequest,
+                    auth: "plugin",
+                    match: "prefix"
+                });
+            }
+        }
+        else {
+            console.warn("[wecom] host api.registerHttpRoute unavailable; skip webhook route registration");
+        }
+        // 注入媒体发送指令和文件大小限制提示词（仅对企业微信 channel 生效）
+        api.on("before_prompt_build", function (_event, ctx) {
+            // 只在企业微信 channel 的会话中注入，避免影响其他 channel 插件
+            if ((ctx === null || ctx === void 0 ? void 0 : ctx.channelId) !== const_js_1.CHANNEL_ID) {
+                return;
+            }
+            return {
+                appendSystemContext: [
+                    "重要：涉及发送图片/视频/语音/文件给用户时，请务必使用 `MEDIA:` 指令。详见  wecom-send-media 这个 skill（技能）。",
+                    "重要：当需要向用户发送结构化卡片消息（如通知、投票、按钮选择等）时，请在回复中直接输出 JSON 代码块（```json ... ```），其中 card_type 字段标明卡片类型。详见 wecom-send-template-card 技能。"
+                ].join("\n")
+            };
+        });
+    }
+};
+exports["default"] = plugin;

package/dist/src/accounts.d.ts

@@ -0,0 +1,57 @@
+import type { OpenClawConfig } from "ylib-openclaw/plugin-sdk";
+import type { WeComConfig, WeComAccountConfig, ResolvedWeComAccount } from "./utils.js";
+/**
+ * 企业微信多账号配置结构（扩展 WeComConfig）
+ */
+export interface WeComMultiAccountConfig extends WeComConfig {
+    /** 默认账号 ID */
+    defaultAccount?: string;
+    /** 多账号配置 */
+    accounts?: Record<string, WeComAccountConfig>;
+}
+/**
+ * 判断是否为多账号模式（即配置中存在 accounts 字段）。
+ * 用于区分单账号/多账号模式的分支判断，替代 `accountId === DEFAULT_ACCOUNT_ID` 的不可靠判断。
+ */
+export declare function hasMultiAccounts(cfg: OpenClawConfig): boolean;
+/**
+ * 列出所有企业微信账号 ID。
+ * 如果没有 accounts 字段，返回 [DEFAULT_ACCOUNT_ID] 以向后兼容。
+ */
+export declare function listWeComAccountIds(cfg: OpenClawConfig): string[];
+/**
+ * 解析默认账号 ID。
+ *
+ * 优先级：
+ * 1. 显式设置的 defaultAccount
+ * 2. 包含 DEFAULT_ACCOUNT_ID 的账号列表
+ * 3. 字母序第一个账号
+ */
+export declare function resolveDefaultWeComAccountId(cfg: OpenClawConfig): string;
+/**
+ * 解析单个企业微信账号的完整配置。
+ *
+ * 支持：
+ * - 显式指定 accountId → 使用该 accountId
+ * - 未指定 → 使用默认账号
+ * - 单账号模式（无 accounts 字段） → 直接读取顶层配置
+ */
+export declare function resolveWeComAccountMulti(params: {
+    cfg: OpenClawConfig;
+    accountId?: string | null;
+}): ResolvedWeComAccount;
+/**
+ * 列出所有已启用且已配置凭据的账号。
+ */
+export declare function listEnabledWeComAccounts(cfg: OpenClawConfig): ResolvedWeComAccount[];
+/**
+ * 写入企业微信账户配置（自动区分单账号/多账号模式）。
+ *
+ * - 单账号模式（无 accounts 字段）：写入顶层 channels.wecom
+ * - 多账号模式：写入 channels.wecom.accounts[accountId]
+ *
+ * @param cfg  当前全局配置
+ * @param updates  要写入的部分配置字段
+ * @param accountId  目标账号 ID（默认写入默认账号）
+ */
+export declare function setWeComAccountMulti(cfg: OpenClawConfig, updates: Partial<WeComConfig>, accountId?: string): OpenClawConfig;

package/dist/src/accounts.js

@@ -0,0 +1,247 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __spreadArrays = (this && this.__spreadArrays) || function () {
+    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;
+    for (var r = Array(s), k = 0, i = 0; i < il; i++)
+        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)
+            r[k] = a[j];
+    return r;
+};
+exports.__esModule = true;
+exports.setWeComAccountMulti = exports.listEnabledWeComAccounts = exports.resolveWeComAccountMulti = exports.resolveDefaultWeComAccountId = exports.listWeComAccountIds = exports.hasMultiAccounts = void 0;
+var plugin_sdk_1 = require("ylib-openclaw/plugin-sdk");
+var const_js_1 = require("./const.js");
+var utils_js_1 = require("./utils.js");
+// ============================================================================
+// 账号列举
+// ============================================================================
+/**
+ * 列出 accounts 字段中配置的所有账号 ID（已 normalize）。
+ */
+function listConfiguredAccountIds(cfg) {
+    var _a, _b;
+    var accounts = (_b = (_a = cfg.channels) === null || _a === void 0 ? void 0 : _a[const_js_1.CHANNEL_ID]) === null || _b === void 0 ? void 0 : _b.accounts;
+    if (!accounts || typeof accounts !== "object") {
+        return [];
+    }
+    return Object.keys(accounts).filter(Boolean).map(plugin_sdk_1.normalizeAccountId);
+}
+/**
+ * 判断是否为多账号模式（即配置中存在 accounts 字段）。
+ * 用于区分单账号/多账号模式的分支判断，替代 `accountId === DEFAULT_ACCOUNT_ID` 的不可靠判断。
+ */
+function hasMultiAccounts(cfg) {
+    return listConfiguredAccountIds(cfg).length > 0;
+}
+exports.hasMultiAccounts = hasMultiAccounts;
+/**
+ * 列出所有企业微信账号 ID。
+ * 如果没有 accounts 字段，返回 [DEFAULT_ACCOUNT_ID] 以向后兼容。
+ */
+function listWeComAccountIds(cfg) {
+    var ids = listConfiguredAccountIds(cfg);
+    if (ids.length === 0) {
+        // 向后兼容：未配置 accounts 时使用默认账号
+        return [plugin_sdk_1.DEFAULT_ACCOUNT_ID];
+    }
+    return __spreadArrays(ids).sort(function (a, b) { return a.localeCompare(b); });
+}
+exports.listWeComAccountIds = listWeComAccountIds;
+// ============================================================================
+// 默认账号解析
+// ============================================================================
+/**
+ * 解析默认账号 ID。
+ *
+ * 优先级：
+ * 1. 显式设置的 defaultAccount
+ * 2. 包含 DEFAULT_ACCOUNT_ID 的账号列表
+ * 3. 字母序第一个账号
+ */
+function resolveDefaultWeComAccountId(cfg) {
+    var _a, _b, _c;
+    var wecomConfig = (_a = cfg.channels) === null || _a === void 0 ? void 0 : _a[const_js_1.CHANNEL_ID];
+    var preferred = (_b = wecomConfig === null || wecomConfig === void 0 ? void 0 : wecomConfig.defaultAccount) === null || _b === void 0 ? void 0 : _b.trim();
+    if (preferred) {
+        return plugin_sdk_1.normalizeAccountId(preferred);
+    }
+    var ids = listWeComAccountIds(cfg);
+    if (ids.includes(plugin_sdk_1.DEFAULT_ACCOUNT_ID)) {
+        return plugin_sdk_1.DEFAULT_ACCOUNT_ID;
+    }
+    return (_c = ids[0]) !== null && _c !== void 0 ? _c : plugin_sdk_1.DEFAULT_ACCOUNT_ID;
+}
+exports.resolveDefaultWeComAccountId = resolveDefaultWeComAccountId;
+// ============================================================================
+// 配置合并
+// ============================================================================
+/**
+ * 合并顶层配置与账号级配置（账号级覆盖顶层）。
+ *
+ * 顶层字段（如 dmPolicy、allowFrom）作为所有账号的默认值，
+ * accounts.xxx 中的字段会覆盖顶层的同名字段。
+ * 对于 groups 等嵌套 Record 对象，使用深层合并（账号级条目覆盖同 key，但不丢失基础配置中的其他 key）。
+ */
+function mergeWeComAccountConfig(cfg, accountId) {
+    var _a;
+    var wecomConfig = (_a = cfg.channels) === null || _a === void 0 ? void 0 : _a[const_js_1.CHANNEL_ID];
+    // 提取基础配置（排除 accounts 和 defaultAccount 字段避免递归）
+    var _b = wecomConfig !== null && wecomConfig !== void 0 ? wecomConfig : {}, _ignored = _b.accounts, _da = _b.defaultAccount, base = __rest(_b, ["accounts", "defaultAccount"]);
+    // 查找账号级覆盖（支持 normalize 后的 key 匹配）
+    var account = findAccountConfig(wecomConfig === null || wecomConfig === void 0 ? void 0 : wecomConfig.accounts, accountId);
+    // 深层合并：对 groups 做嵌套合并，其余字段用账号级覆盖
+    var baseGroups = base.groups, baseRest = __rest(base, ["groups"]);
+    var accountGroups = account.groups, accountRest = __rest(account, ["groups"]);
+    var mergedGroups = baseGroups || accountGroups
+        ? __assign(__assign({}, baseGroups), accountGroups) : undefined;
+    return __assign(__assign(__assign({}, baseRest), accountRest), (mergedGroups !== undefined ? { groups: mergedGroups } : {}));
+}
+/**
+ * 在 accounts Record 中按 normalize 后的 accountId 查找配置。
+ * 避免因大小写差异导致找不到账号。
+ */
+function findAccountConfig(accounts, accountId) {
+    if (!accounts)
+        return {};
+    // 精确匹配优先
+    if (accounts[accountId])
+        return accounts[accountId];
+    // normalize 后匹配
+    var normalized = plugin_sdk_1.normalizeAccountId(accountId);
+    for (var _i = 0, _a = Object.entries(accounts); _i < _a.length; _i++) {
+        var _b = _a[_i], key = _b[0], value = _b[1];
+        if (plugin_sdk_1.normalizeAccountId(key) === normalized)
+            return value;
+    }
+    return {};
+}
+// ============================================================================
+// 账号解析
+// ============================================================================
+/**
+ * 解析单个企业微信账号的完整配置。
+ *
+ * 支持：
+ * - 显式指定 accountId → 使用该 accountId
+ * - 未指定 → 使用默认账号
+ * - 单账号模式（无 accounts 字段） → 直接读取顶层配置
+ */
+function resolveWeComAccountMulti(params) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var hasExplicitId = typeof params.accountId === "string" && params.accountId.trim() !== "";
+    var accountId = hasExplicitId
+        ? plugin_sdk_1.normalizeAccountId(params.accountId)
+        : resolveDefaultWeComAccountId(params.cfg);
+    var wecomConfig = (_a = params.cfg.channels) === null || _a === void 0 ? void 0 : _a[const_js_1.CHANNEL_ID];
+    // 顶层 enabled 状态
+    var baseEnabled = (wecomConfig === null || wecomConfig === void 0 ? void 0 : wecomConfig.enabled) !== false;
+    // 合并配置
+    var merged = mergeWeComAccountConfig(params.cfg, accountId);
+    // 账号级 enabled 状态
+    var accountEnabled = merged.enabled !== false;
+    // 解析 Agent 子配置
+    var agentCfg = merged.agent;
+    var agent;
+    if ((agentCfg === null || agentCfg === void 0 ? void 0 : agentCfg.corpId) && (agentCfg === null || agentCfg === void 0 ? void 0 : agentCfg.corpSecret) && (agentCfg === null || agentCfg === void 0 ? void 0 : agentCfg.token) && (agentCfg === null || agentCfg === void 0 ? void 0 : agentCfg.encodingAESKey)) {
+        agent = {
+            accountId: accountId,
+            enabled: baseEnabled && accountEnabled,
+            configured: true,
+            corpId: agentCfg.corpId,
+            corpSecret: agentCfg.corpSecret,
+            agentId: typeof agentCfg.agentId === "string" ? Number(agentCfg.agentId) || undefined : agentCfg.agentId,
+            token: agentCfg.token,
+            encodingAESKey: agentCfg.encodingAESKey,
+            config: agentCfg,
+            network: merged.network
+        };
+    }
+    return {
+        accountId: accountId,
+        name: (_b = merged.name) !== null && _b !== void 0 ? _b : "企业微信",
+        enabled: baseEnabled && accountEnabled,
+        websocketUrl: merged.websocketUrl || utils_js_1.DefaultWsUrl,
+        botId: (_c = merged.botId) !== null && _c !== void 0 ? _c : "",
+        secret: (_d = merged.secret) !== null && _d !== void 0 ? _d : "",
+        sendThinkingMessage: (_e = merged.sendThinkingMessage) !== null && _e !== void 0 ? _e : true,
+        // 只接受显式 true，未配置或历史配置缺失时都保持默认完整输出。
+        showFinalAnswerOnly: merged.showFinalAnswerOnly === true,
+        config: merged,
+        agent: agent,
+        token: (_f = merged.token) !== null && _f !== void 0 ? _f : "",
+        encodingAESKey: (_g = merged.encodingAESKey) !== null && _g !== void 0 ? _g : "",
+        receiveId: (_h = merged.receiveId) !== null && _h !== void 0 ? _h : ""
+    };
+}
+exports.resolveWeComAccountMulti = resolveWeComAccountMulti;
+// ============================================================================
+// 批量查询
+// ============================================================================
+/**
+ * 列出所有已启用且已配置凭据的账号。
+ */
+function listEnabledWeComAccounts(cfg) {
+    return listWeComAccountIds(cfg)
+        .map(function (accountId) { return resolveWeComAccountMulti({ cfg: cfg, accountId: accountId }); })
+        .filter(function (account) {
+        var _a, _b, _c;
+        if (!account.enabled)
+            return false;
+        var hasBotCredentials = Boolean(((_a = account.botId) === null || _a === void 0 ? void 0 : _a.trim()) && ((_b = account.secret) === null || _b === void 0 ? void 0 : _b.trim()));
+        var hasAgentCredentials = Boolean((_c = account.agent) === null || _c === void 0 ? void 0 : _c.configured);
+        return hasBotCredentials || hasAgentCredentials;
+    });
+}
+exports.listEnabledWeComAccounts = listEnabledWeComAccounts;
+// ============================================================================
+// 配置写入（多账号感知）
+// ============================================================================
+/**
+ * 写入企业微信账户配置（自动区分单账号/多账号模式）。
+ *
+ * - 单账号模式（无 accounts 字段）：写入顶层 channels.wecom
+ * - 多账号模式：写入 channels.wecom.accounts[accountId]
+ *
+ * @param cfg  当前全局配置
+ * @param updates  要写入的部分配置字段
+ * @param accountId  目标账号 ID（默认写入默认账号）
+ */
+function setWeComAccountMulti(cfg, updates, accountId) {
+    var _a, _b, _c;
+    var _d, _e, _f, _g, _h, _j;
+    var resolvedAccountId = accountId !== null && accountId !== void 0 ? accountId : resolveDefaultWeComAccountId(cfg);
+    var isMulti = hasMultiAccounts(cfg);
+    if (!isMulti) {
+        // 单账号模式：合并到顶层
+        var existing = ((_e = (_d = cfg.channels) === null || _d === void 0 ? void 0 : _d[const_js_1.CHANNEL_ID]) !== null && _e !== void 0 ? _e : {});
+        var merged = __assign(__assign({}, existing), updates);
+        return __assign(__assign({}, cfg), { channels: __assign(__assign({}, cfg.channels), (_a = {}, _a[const_js_1.CHANNEL_ID] = merged, _a)) });
+    }
+    // 多账号模式：合并到 accounts[accountId]
+    var wecomConfig = ((_g = (_f = cfg.channels) === null || _f === void 0 ? void 0 : _f[const_js_1.CHANNEL_ID]) !== null && _g !== void 0 ? _g : {});
+    var existingAccount = (_j = (_h = wecomConfig.accounts) === null || _h === void 0 ? void 0 : _h[resolvedAccountId]) !== null && _j !== void 0 ? _j : {};
+    var mergedAccount = __assign(__assign({}, existingAccount), updates);
+    return __assign(__assign({}, cfg), { channels: __assign(__assign({}, cfg.channels), (_b = {}, _b[const_js_1.CHANNEL_ID] = __assign(__assign({}, wecomConfig), { accounts: __assign(__assign({}, wecomConfig.accounts), (_c = {}, _c[resolvedAccountId] = mergedAccount, _c)) }), _b)) });
+}
+exports.setWeComAccountMulti = setWeComAccountMulti;

package/dist/src/agent/api-client.d.ts

@@ -0,0 +1,95 @@
+/**
+ * WeCom Agent API 客户端
+ * 管理 AccessToken 缓存和 API 调用
+ */
+/// <reference types="node" />
+import type { ResolvedAgentAccount } from "../types/index.js";
+/**
+ * **getAccessToken (获取 AccessToken)**
+ *
+ * 获取企业微信 API 调用所需的 AccessToken。
+ * 具备自动缓存和过期刷新机制。
+ *
+ * @param agent Agent 账号信息
+ * @returns 有效的 AccessToken
+ */
+export declare function getAccessToken(agent: ResolvedAgentAccount): Promise<string>;
+/**
+ * **sendText (发送文本消息)**
+ *
+ * 调用 `message/send` (Agent) 或 `appchat/send` (群聊) 发送文本。
+ *
+ * @param params.agent 发送方 Agent
+ * @param params.toUser 接收用户 ID (单聊可选，可与 toParty/toTag 同时使用)
+ * @param params.toParty 接收部门 ID (单聊可选)
+ * @param params.toTag 接收标签 ID (单聊可选)
+ * @param params.chatId 接收群 ID (群聊模式必填，互斥)
+ * @param params.text 消息内容
+ */
+export declare function sendText(params: {
+    agent: ResolvedAgentAccount;
+    toUser?: string;
+    toParty?: string;
+    toTag?: string;
+    chatId?: string;
+    text: string;
+}): Promise<void>;
+/**
+ * **uploadMedia (上传媒体文件)**
+ *
+ * 上传临时素材到企业微信。
+ * 素材有效期为 3 天。
+ *
+ * @param params.type 媒体类型 (image, voice, video, file)
+ * @param params.buffer 文件二进制数据
+ * @param params.filename 文件名 (需包含正确扩展名)
+ * @returns 媒体 ID (media_id)
+ */
+export declare function uploadMedia(params: {
+    agent: ResolvedAgentAccount;
+    type: "image" | "voice" | "video" | "file";
+    buffer: Buffer;
+    filename: string;
+}): Promise<string>;
+/**
+ * **sendMedia (发送媒体消息)**
+ *
+ * 发送图片、音频、视频或文件。需先通过 `uploadMedia` 获取 media_id。
+ *
+ * @param params.agent 发送方 Agent
+ * @param params.toUser 接收用户 ID (单聊可选)
+ * @param params.toParty 接收部门 ID (单聊可选)
+ * @param params.toTag 接收标签 ID (单聊可选)
+ * @param params.chatId 接收群 ID (群聊模式必填)
+ * @param params.mediaId 媒体 ID
+ * @param params.mediaType 媒体类型
+ * @param params.title 视频标题 (可选)
+ * @param params.description 视频描述 (可选)
+ */
+export declare function sendMedia(params: {
+    agent: ResolvedAgentAccount;
+    toUser?: string;
+    toParty?: string;
+    toTag?: string;
+    chatId?: string;
+    mediaId: string;
+    mediaType: "image" | "voice" | "video" | "file";
+    title?: string;
+    description?: string;
+}): Promise<void>;
+/**
+ * **downloadMedia (下载媒体文件)**
+ *
+ * 通过 media_id 从企业微信服务器下载临时素材。
+ *
+ * @returns { buffer, contentType }
+ */
+export declare function downloadMedia(params: {
+    agent: ResolvedAgentAccount;
+    mediaId: string;
+    maxBytes?: number;
+}): Promise<{
+    buffer: Buffer;
+    contentType: string;
+    filename?: string;
+}>;