openclaw-plugin-yuanbao 2.2.0 → 2.3.1

package/README.md

@@ -0,0 +1,58 @@
+# openclaw-plugin-yuanbao
+
+[![npm version](https://img.shields.io/npm/v/openclaw-plugin-yuanbao.svg)](https://www.npmjs.com/package/openclaw-plugin-yuanbao)
+
+腾讯元宝智能机器人频道插件，让你的 OpenClaw 机器人能够接入元宝 Bot 通道，支持私聊和群聊。
+
+## ✨ 功能特性
+
+| 能力 | 描述 |
+|------|------|
+| 💬 群聊互动 | 在元宝派群组中，成员 @元宝Bot 即可触发 AI 回复 |
+| 🧠 长期记忆 | 记住与创建者的历史对话，越聊越懂你 |
+| ⏰ 随时在线 | 云端部署，7×24 小时在线服务派友 |
+| 🔍 联网搜索 | 自动接入 Web Search，回答实时信息 |
+
+## 🚀 快速开始
+
+### 1. 安装插件
+
+```bash
+openclaw plugins install openclaw-plugin-yuanbao
+```
+
+### 2. 配置通道
+
+```bash
+openclaw channels add
+```
+
+根据提示输入：
+- **AppID**: 元宝 APP 的 APP ID
+- **AppSecret**: 元宝 APP 的密钥
+
+### 3. 开始使用
+
+配置完成后，用户可以：
+- **私聊** - 直接向机器人发送消息
+- **群聊** - @机器人 或回复机器人消息触发对话
+
+## 🛠️ Bot 常用命令
+
+```
+/yuanbaobot-upgrade   # 升级元宝插件（需机器人主人权限）
+/issue-log            # 提交问题日志
+```
+
+## ❓ 常见问题
+
+### 连接失败
+- 检查 `AppID` 和 `AppSecret` 是否正确
+
+## 📚 相关文档
+- [元宝官网](https://yuanbao.tencent.com)
+
+## 🔧 系统要求
+
+- OpenClaw >= 2026.3.22
+- Node.js >= 18

package/dist/openclaw.plugin.json

@@ -2,7 +2,7 @@
     "id": "openclaw-plugin-yuanbao",
     "name": "元宝 Bot",
     "description": "Tencent YuanBao intelligent bot channel plugin",
-    "version": "2.2.0",
+    "version": "2.3.1",
     "channels": [
         "yuanbao"
     ],

package/dist/src/channel.js

@@ -9,7 +9,7 @@ import { getYuanbaoRuntime } from './runtime.js';
 import { sendYuanbaoMessage, sendYuanbaoGroupMessage } from './message-handler/index.js';
 import { initOutboundQueue, destroyOutboundQueue, getOutboundQueue } from './outbound-queue.js';
 import { parseTarget, sendDM, } from './dm/index.js';
-import { yuanbaoMessageActions } from './message-tool/index.js';
+import { buildMessageToolHints, yuanbaoMessageActions } from './message-tool/index.js';
 function toChannelResult(result) {
     return {
         channel: 'yuanbao',
@@ -149,6 +149,18 @@ export const yuanbaoPlugin = {
             hint: '<userid> or group:<groupcode>',
         },
     },
+    agentPrompt: {
+        messageToolHints() {
+            return buildMessageToolHints();
+        },
+    },
+    streaming: {
+        blockStreamingChunkMaxChars: 3000,
+        blockStreamingCoalesceDefaults: {
+            minChars: 2500,
+            idleMs: 15000,
+        },
+    },
     outbound: {
         deliveryMode: 'direct',
         chunkerMode: 'markdown',
@@ -185,10 +197,11 @@ export const yuanbaoPlugin = {
             }
             return toChannelResult(await sendTextToTarget(account, to, text, wsClient));
         },
-        sendMedia: async ({ cfg, accountId, to: _to, mediaUrl, text }) => {
+        sendMedia: async ({ cfg, accountId, to: _to, mediaUrl, text, mediaLocalRoots }) => {
             const to = _to.replace(/^yuanbao:/, '');
             const account = resolveYuanbaoAccount({ cfg, accountId: accountId ?? undefined });
             const wsClient = getActiveWsClient(account.accountId);
+            logger.info('sendMedia', { to, mediaUrl, text, accountId });
             if (!wsClient) {
                 return { channel: 'yuanbao', ok: false, messageId: '', error: new Error(`WebSocket client not connected for account ${account.accountId}`) };
             }
@@ -201,15 +214,12 @@ export const yuanbaoPlugin = {
                 const session = queueManager.getSession(safeTo);
                 if (session) {
                     await session.push({ type: 'text', text });
-                    await session.push({ type: 'media', mediaUrl });
+                    await session.push({ type: 'media', mediaUrl, mediaLocalRoots });
                     return { channel: 'yuanbao', ok: true, messageId: '' };
                 }
                 logger.debug(`sendMedia: 未找到已有 session， to: ${to}`);
             }
-            if (text?.trim()) {
-                return toChannelResult(await sendTextToTarget(account, to, text, wsClient));
-            }
-            return { channel: 'yuanbao', ok: false, messageId: '' };
+            return { channel: 'yuanbao', ok: false, messageId: '', error: new Error('No session found') };
         },
     },
     status: {
@@ -269,12 +279,10 @@ export const yuanbaoPlugin = {
             const strategy = cfg.outboundQueueStrategy === 'immediate' ? 'immediate' : 'merge-text';
             initOutboundQueue(account.accountId, {
                 strategy,
-                minChars: cfg.minChars,
                 maxChars: cfg.maxChars,
-                idleMs: cfg.idleMs,
                 chunkText: (text, limit) => getYuanbaoRuntime().channel.text.chunkMarkdownText(text, limit),
             });
-            slog.info(`[${account.accountId}] 出站队列已初始化，策略: ${strategy}，minChars: ${cfg.minChars ?? 2500}, maxChars: ${cfg.maxChars ?? 3000}, idleMs: ${cfg.idleMs ?? 5000}`);
+            slog.info(`[${account.accountId}] 出站队列已初始化，策略: ${strategy}，maxChars: ${cfg.maxChars ?? 3000}`);
             return startYuanbaoWsGateway({
                 account,
                 config: ctx.cfg,

package/dist/src/commands/upgrade.js

@@ -261,7 +261,7 @@ function performUpgrade(config, accountId) {
         accountId: resolvedAccountId,
     });
     const { appKey, appSecret, token } = resolvedAccount;
-    lines.push('执行openclaw plugins update失败，尝试重新安装最新版本，预计2分钟后自动升级成功，请稍后确认是否能正常使用');
+    lines.push('执行openclaw plugins update失败，尝试重新安装最新版本，预计需要花费 1-2 分钟，请耐心等待');
     reinstallViaCdn({ appKey, appSecret, token });
     const finalVersion = readInstalledVersion(PLUGIN_ID);
     log.info('CDN 重装后版本检查', { finalVersion: finalVersion ?? '(未检测到)', expected: latestVersion });

package/dist/src/config-schema.js

@@ -58,7 +58,7 @@ export const yuanbaoConfigSchema = {
                 title: '空闲自动发送超时 (ms)',
                 description: 'merge-text 策略下，超过该时长无新内容时自动发送缓冲区',
                 minimum: 0,
-                default: 5000,
+                default: 15000,
             },
             mediaMaxMb: {
                 type: 'number',

package/dist/src/media.js

@@ -1,7 +1,7 @@
 import { createReadStream, statSync, existsSync } from 'node:fs';
 import { writeFile, mkdir } from 'node:fs/promises';
 import { tmpdir, homedir } from 'node:os';
-import { basename, extname, join } from 'node:path';
+import path, { basename, extname, join } from 'node:path';
 import { randomBytes, createHash } from 'node:crypto';
 import { apiGetDownloadUrl, apiGetUploadInfo } from './yuanbao-server/api.js';
 const DEFAULT_MAX_MB = 20;
@@ -127,7 +127,8 @@ function isLocalPath(s) {
         || s.startsWith('./')
         || s.startsWith('../')
         || s.startsWith('.\\')
-        || s.startsWith('..\\'));
+        || s.startsWith('..\\')
+        || !s.includes('://'));
 }
 function normalizePath(s) {
     let p = s.trim();
@@ -142,6 +143,9 @@ function normalizePath(s) {
     if (p === '~' || p.startsWith('~/') || p.startsWith('~\\')) {
         p = homedir() + p.slice(1);
     }
+    if (!path.isAbsolute(p)) {
+        p = path.resolve(p);
+    }
     return p;
 }
 const MIME_TO_EXT = {

package/dist/src/message-handler/inbound.js

@@ -6,7 +6,7 @@ import { sendYuanbaoMessage, sendYuanbaoMessageBody, sendYuanbaoGroupMessage, se
 import { buildOutboundMsgBody, prepareOutboundContent } from './handlers/index.js';
 import { parseQuoteFromCloudCustomData, formatQuoteContext } from './quote.js';
 import { getMember } from '../module/member.js';
-import { createLog } from '../logger.js';
+import { createLog, logger } from '../logger.js';
 import { getOutboundQueue } from '../outbound-queue.js';
 import { UPGRADE_COMMAND_NAMES } from '../commands/upgrade.js';
 import { sendStickerYuanbao } from '../sticker/sticker-sender.js';
@@ -285,7 +285,7 @@ async function handleC2CMessage(params) {
     const msgId = msg.msg_id ?? String(msg.msg_seq ?? '');
     const queueManager = getOutboundQueue(account.accountId);
     if (queueManager) {
-        const sendMediaOverride = async (url, fallbackText, mediaType) => {
+        const sendMediaOverride = async (url, fallbackText, mediaType, mediaLocalRoots) => {
             if (mediaType === 'sticker') {
                 const sticker = getCachedSticker(url);
                 if (!sticker) {
@@ -301,7 +301,8 @@ async function handleC2CMessage(params) {
                 });
             }
             try {
-                const uploadResult = await downloadAndUploadMedia(url, core, account);
+                logger.info('sendMediaOverride', { url, mediaLocalRoots });
+                const uploadResult = await downloadAndUploadMedia(url, core, account, mediaLocalRoots);
                 const mime = guessMimeType(uploadResult.filename);
                 const msgBody = mime.startsWith('image/')
                     ? buildImageMsgBody({ url: uploadResult.url, filename: uploadResult.filename, size: uploadResult.size, uuid: uploadResult.uuid, imageInfo: uploadResult.imageInfo })
@@ -321,6 +322,7 @@ async function handleC2CMessage(params) {
             chatType: 'c2c',
             account,
             target: fromAccount,
+            toAccount: fromAccount,
             fromAccount: outboundSender,
             ctx,
             sendMediaOverride,
@@ -607,7 +609,7 @@ async function handleGroupMessage(params) {
     const groupMsgId = msg.msg_id ?? String(msg.msg_seq ?? '');
     const groupQueueManager = getOutboundQueue(account.accountId);
     if (groupQueueManager) {
-        const groupSendMediaOverride = async (url, fallbackText, mediaType) => {
+        const groupSendMediaOverride = async (url, fallbackText, mediaType, mediaLocalRoots) => {
             if (mediaType === 'sticker') {
                 const sticker = await getCachedSticker(url);
                 if (!sticker) {
@@ -616,7 +618,8 @@ async function handleGroupMessage(params) {
                 return sendStickerYuanbao({ account, config, wsClient: ctx.wsClient, toAccount: `group:${groupCode}`, sticker, refMsgId, core });
             }
             try {
-                const uploadResult = await downloadAndUploadMedia(url, core, account);
+                logger.info('groupSendMediaOverride', { url, mediaLocalRoots });
+                const uploadResult = await downloadAndUploadMedia(url, core, account, mediaLocalRoots);
                 const mime = guessMimeType(uploadResult.filename);
                 const msgBody = mime.startsWith('image/')
                     ? buildImageMsgBody({ url: uploadResult.url, filename: uploadResult.filename, size: uploadResult.size, uuid: uploadResult.uuid, imageInfo: uploadResult.imageInfo })
@@ -653,6 +656,7 @@ async function handleGroupMessage(params) {
             chatType: 'group',
             account,
             target: groupCode,
+            toAccount: fromAccount,
             fromAccount: outboundSender,
             refMsgId,
             refFromAccount: fromAccount,
@@ -663,20 +667,27 @@ async function handleGroupMessage(params) {
         glog.debug(`[${outboundGroupSessionKey}] 群出站队列 session 已注册，msgId: ${groupMsgId}`);
     }
     const replyRuntime = buildReplyRuntimeConfig(config, account);
-    await executeReply({
-        transport,
-        ctx,
-        account,
-        core,
-        config,
-        ctxPayload,
-        replyRuntime,
-        tableMode,
-        splitFinalText,
-        overflowPolicy: account.overflowPolicy,
-        sessionKey: outboundGroupSessionKey,
-        groupCode,
-    });
+    try {
+        await executeReply({
+            transport,
+            ctx,
+            account,
+            core,
+            config,
+            ctxPayload,
+            replyRuntime,
+            tableMode,
+            splitFinalText,
+            overflowPolicy: account.overflowPolicy,
+            sessionKey: outboundGroupSessionKey,
+            groupCode,
+        });
+    }
+    catch (err) {
+        const session = groupQueueManager?.getSession(outboundGroupSessionKey);
+        session?.abort();
+        throw err;
+    }
     clearHistoryEntriesIfEnabled({
         historyMap: chatHistories,
         historyKey: groupCode,

package/dist/src/message-handler/outbound.js

@@ -1,3 +1,4 @@
+import { WS_HEARTBEAT } from '../yuanbao-server/ws/index.js';
 import { createLog } from '../logger.js';
 import { prepareOutboundContent, buildOutboundMsgBody } from './handlers/index.js';
 import { getMember } from '../module/member.js';
@@ -137,7 +138,7 @@ export async function sendMsgBodyDirect(params) {
     });
 }
 export async function executeReply(params) {
-    const { transport, ctx, account, core, replyRuntime, splitFinalText, overflowPolicy, ctxPayload, sessionKey, } = params;
+    const { transport, ctx, account, core, replyRuntime, splitFinalText, tableMode, overflowPolicy, ctxPayload, sessionKey, } = params;
     const rlog = createLog('outbound', ctx.log);
     if (ctx.abortSignal?.aborted) {
         rlog.warn(`[${account.accountId}] 回复已中止，跳过执行`);
@@ -156,6 +157,12 @@ export async function executeReply(params) {
         cfg: replyRuntime.config,
         replyOptions: {
             disableBlockStreaming: replyRuntime.disableBlockStreaming,
+            onAgentRunStart: () => {
+                session?.emitReplyHeartbeat(WS_HEARTBEAT.RUNNING);
+            },
+            onAssistantMessageStart: () => {
+                session?.emitReplyHeartbeat(WS_HEARTBEAT.RUNNING);
+            },
         },
         dispatcherOptions: {
             deliver: async (payload, info) => {
@@ -169,7 +176,7 @@ export async function executeReply(params) {
                 if (info.kind === 'final') {
                     hasFinalInfo = true;
                 }
-                const text = payload.text ?? '';
+                const text = core.channel.text.convertMarkdownTables(payload.text ?? '', tableMode);
                 if (session) {
                     if (text.trim()) {
                         hasQueuedContent = true;
@@ -212,6 +219,7 @@ export async function executeReply(params) {
             return;
         }
         ctx.statusSink?.({ lastOutboundAt: Date.now() });
+        session.emitReplyHeartbeat(WS_HEARTBEAT.FINISH);
         return;
     }
     if (collectedTexts.length === 0) {

package/dist/src/message-tool/action-runtime.js

@@ -33,7 +33,7 @@ function normalizeStickerId(params) {
     return '';
 }
 export async function handleYuanbaoAction(action, params, context) {
-    const normalized = action === 'sticker' ? 'sticker-send' : action;
+    const normalized = (action === 'sticker' || action === 'react') ? 'sticker-send' : action;
     switch (normalized) {
         case 'sticker-search': {
             const query = normalizeStickerSearchQuery(params);

package/dist/src/message-tool/hints.js

@@ -1,6 +1,7 @@
 export function buildMessageToolHints() {
     return [
-        'file/image: real URLs/paths; send with media/mediaUrls, not link-only text.',
-        '表情=sticker=贴纸表情 (same). Use sticker-search + sticker; do not use Unicode emoji in text.',
+        'Sticker/react/贴纸 fully supported, no extra setup. react = sticker = 发贴纸 (NOT a message reaction). Use sticker-search then sticker/react. No bare Unicode emoji.',
+        'File/image sending is supported. Use media/mediaUrls with real URLs or absolute paths, not link-only text.',
+        'IMPORTANT: When sending files, always use absolute paths (e.g. /tmp/file.md). Never use relative paths like "hello.md" — they will fail.',
     ];
 }

package/dist/src/module/reply-heartbeat.d.ts

@@ -0,0 +1,22 @@
+import type { ResolvedYuanbaoAccount } from '../types.js';
+import type { MessageHandlerContext } from '../message-handler/context.js';
+import type { WsHeartbeatValue } from '../yuanbao-server/ws/index.js';
+export interface ReplyHeartbeatMeta {
+    ctx: MessageHandlerContext;
+    account: ResolvedYuanbaoAccount;
+    toAccount: string;
+    groupCode?: string;
+}
+export declare function emitReplyHeartbeat(params: ReplyHeartbeatMeta & {
+    heartbeat: WsHeartbeatValue;
+    sendTime: number;
+}): Promise<void>;
+export interface ReplyHeartbeatController {
+    emit(heartbeat: WsHeartbeatValue): void;
+    onReplySent(): void;
+    stop(): void;
+}
+export declare function createReplyHeartbeatController(params: {
+    meta: ReplyHeartbeatMeta;
+    runningIntervalMs?: number;
+}): ReplyHeartbeatController;

package/dist/src/module/reply-heartbeat.js

@@ -0,0 +1,133 @@
+import { createLog } from '../logger.js';
+import { WS_HEARTBEAT } from '../yuanbao-server/ws/index.js';
+const HEARTBEAT_TIMEOUT_MS = 800;
+const DEFAULT_RUNNING_HEARTBEAT_INTERVAL_MS = 2000;
+const MAX_RUNNING_HEARTBEAT_IDLE_MS = 30000;
+const log = createLog('reply-heartbeat');
+export async function emitReplyHeartbeat(params) {
+    const { ctx, account, toAccount, groupCode, heartbeat, sendTime } = params;
+    const fromAccount = account.botId?.trim() ?? '';
+    const targetAccount = toAccount.trim();
+    const withTimeout = async (promise, timeoutMs) => new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`heartbeat timeout(${timeoutMs}ms)`)), timeoutMs);
+        promise
+            .then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        })
+            .catch((err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+    if (!ctx.wsClient) {
+        log.warn(`[${account.accountId}] 心跳发送失败: wsClient 不可用`);
+        return;
+    }
+    if (!fromAccount || !targetAccount) {
+        log.warn(`[${account.accountId}] 心跳发送失败: from/to 账号缺失`, {
+            fromAccount,
+            toAccount: targetAccount,
+            groupCode,
+            heartbeat,
+        });
+        return;
+    }
+    try {
+        if (groupCode) {
+            const rsp = await withTimeout(ctx.wsClient.sendGroupHeartbeat({
+                from_account: fromAccount,
+                to_account: targetAccount,
+                group_code: groupCode,
+                send_time: sendTime,
+                heartbeat,
+            }), HEARTBEAT_TIMEOUT_MS);
+            if (rsp.code !== 0) {
+                log.warn(`[${account.accountId}] 发送群聊回复状态心跳失败: code=${rsp.code}, msg=${rsp.msg ?? rsp.message ?? ''}`);
+            }
+            return;
+        }
+        const rsp = await withTimeout(ctx.wsClient.sendPrivateHeartbeat({
+            from_account: fromAccount,
+            to_account: targetAccount,
+            heartbeat,
+        }), HEARTBEAT_TIMEOUT_MS);
+        if (rsp.code !== 0) {
+            log.warn(`[${account.accountId}] 发送私聊回复状态心跳失败: code=${rsp.code}, msg=${rsp.msg ?? rsp.message ?? ''}`);
+        }
+    }
+    catch (err) {
+        log.warn(`[${account.accountId}] 发送回复状态心跳异常: ${String(err)}`);
+    }
+}
+export function createReplyHeartbeatController(params) {
+    const { meta } = params;
+    const runningIntervalMs = params.runningIntervalMs ?? DEFAULT_RUNNING_HEARTBEAT_INTERVAL_MS;
+    let runningHeartbeatTimer = null;
+    let runningHeartbeatActive = false;
+    let runningHeartbeatStartTime = null;
+    let lastRunningEmitAt = null;
+    const send = (heartbeat, sendTime) => {
+        void emitReplyHeartbeat({
+            ...meta,
+            heartbeat,
+            sendTime,
+        });
+    };
+    const sendRunningHeartbeatAndSchedule = async () => {
+        if (!runningHeartbeatActive)
+            return;
+        if (runningHeartbeatStartTime === null)
+            return;
+        if (lastRunningEmitAt === null)
+            return;
+        if ((Date.now() - lastRunningEmitAt) > MAX_RUNNING_HEARTBEAT_IDLE_MS) {
+            stop();
+            return;
+        }
+        await emitReplyHeartbeat({
+            ...meta,
+            heartbeat: WS_HEARTBEAT.RUNNING,
+            sendTime: runningHeartbeatStartTime,
+        });
+        if (!runningHeartbeatActive)
+            return;
+        runningHeartbeatTimer = setTimeout(() => {
+            void sendRunningHeartbeatAndSchedule();
+        }, runningIntervalMs);
+    };
+    const stop = () => {
+        runningHeartbeatActive = false;
+        runningHeartbeatStartTime = null;
+        lastRunningEmitAt = null;
+        if (runningHeartbeatTimer) {
+            clearTimeout(runningHeartbeatTimer);
+            runningHeartbeatTimer = null;
+        }
+    };
+    const startRunning = () => {
+        if (runningHeartbeatActive)
+            return;
+        runningHeartbeatActive = true;
+        runningHeartbeatStartTime = Date.now();
+        lastRunningEmitAt = Date.now();
+        void sendRunningHeartbeatAndSchedule();
+    };
+    const emit = (heartbeat) => {
+        if (heartbeat === WS_HEARTBEAT.RUNNING) {
+            if (runningHeartbeatActive) {
+                lastRunningEmitAt = Date.now();
+                return;
+            }
+            startRunning();
+            return;
+        }
+        stop();
+        send(heartbeat, Date.now());
+    };
+    return {
+        emit,
+        onReplySent: stop,
+        stop,
+    };
+}

package/dist/src/outbound-queue.d.ts

@@ -1,35 +1,38 @@
 import type { ModuleLog } from './logger.js';
 import type { ResolvedYuanbaoAccount } from './types.js';
 import type { MessageHandlerContext } from './message-handler/context.js';
+import type { WsHeartbeatValue } from './yuanbao-server/ws/index.js';
 export type OutboundQueueStrategy = 'immediate' | 'merge-text';
-export type OutboundQueueItem = {
+type OutboundQueueItem = {
     type: 'text';
     text: string;
 } | {
     type: 'media';
     mediaUrl: string;
     text?: string;
+    mediaLocalRoots?: string[];
 } | {
     type: 'sticker';
     sticker_id: string;
     text?: string;
 };
-export type SendTextFn = (text: string) => Promise<{
+type SendTextFn = (text: string) => Promise<{
     ok: boolean;
     error?: string;
 }>;
-export type SendMediaFn = (mediaUrl: string, text?: string, mediaType?: 'image' | 'file' | 'sticker') => Promise<{
+export type SendMediaFn = (mediaUrl: string, text?: string, mediaType?: 'image' | 'file' | 'sticker', mediaLocalRoots?: string[]) => Promise<{
     ok: boolean;
     error?: string;
 }>;
-export interface OutboundQueueSession {
+interface OutboundQueueSession {
     readonly strategy: OutboundQueueStrategy;
     readonly msgId: string;
     push(item: OutboundQueueItem): Promise<void>;
     flush(): Promise<void>;
     abort(): void;
+    emitReplyHeartbeat(heartbeat: WsHeartbeatValue): void;
 }
-export interface RegisterSessionOptions {
+interface RegisterSessionOptions {
     chatType: 'c2c' | 'group';
     account: ResolvedYuanbaoAccount;
     target: string;
@@ -38,10 +41,11 @@ export interface RegisterSessionOptions {
     refFromAccount?: string;
     ctx: MessageHandlerContext;
     msgId: string;
+    toAccount?: string;
     sendMediaOverride?: SendMediaFn;
     mergeOnFlush?: boolean;
 }
-export interface OutboundQueueManager {
+interface OutboundQueueManager {
     readonly strategy: OutboundQueueStrategy;
     registerSession(sessionKey: string, options: RegisterSessionOptions): OutboundQueueSession;
     getSession(sessionKey: string): OutboundQueueSession | null;
@@ -51,21 +55,25 @@ export interface OutboundQueueConfig {
     strategy: OutboundQueueStrategy;
     minChars?: number;
     maxChars?: number;
-    idleMs?: number;
     chunkText?: (text: string, maxChars: number) => string[];
 }
 export declare function initOutboundQueue(accountId: string, config: OutboundQueueConfig): OutboundQueueManager;
 export declare function getOutboundQueue(accountId: string): OutboundQueueManager | null;
 export declare function destroyOutboundQueue(accountId: string): void;
-export declare function getAllOutboundQueues(): ReadonlyMap<string, OutboundQueueManager>;
+export declare function hasUnclosedFence(text: string): boolean;
+export declare function mergeBlockStreamingFences(buffer: string, incoming: string): string;
 export interface MergeTextOptions {
     minChars: number;
     maxChars: number;
-    idleMs: number;
     chunkText: (text: string, maxChars: number) => string[];
 }
 declare function createMergeTextSession(callbacks: {
     sendText: SendTextFn;
     sendMedia: SendMediaFn;
-}, msgId: string, sessionKey: string, onComplete: () => void, log: ModuleLog, opts: MergeTextOptions): OutboundQueueSession;
+}, msgId: string, sessionKey: string, onComplete: () => void, log: ModuleLog, opts: MergeTextOptions, heartbeatMeta: {
+    ctx: MessageHandlerContext;
+    account: ResolvedYuanbaoAccount;
+    toAccount: string;
+    groupCode?: string;
+}): OutboundQueueSession;
 export { createMergeTextSession as createMergeTextSessionForTest };