@openclaw/qqbot 2026.7.1-beta.2 → 2026.7.1-beta.4

package/dist/api.js

@@ -1,8 +1,8 @@
-import { t as qqbotPlugin } from "./channel-BQM6pDlD.js";
+import { t as qqbotPlugin } from "./channel-D1UztsnG.js";
 import { a as resolveQQBotAccount, i as resolveDefaultQQBotAccountId, n as applyQQBotAccountConfig, r as listQQBotAccountIds, t as DEFAULT_ACCOUNT_ID } from "./config-C1qZbh0K.js";
 import { t as qqbotSetupPlugin } from "./channel.setup-2ItDYKhz.js";
-import { o as getFrameworkCommands } from "./group-BmS1Qwst.js";
-import { A as OUTBOUND_ERROR_CODES, C as resolveUserFacingMediaError, D as getMessageReplyStats, E as getMessageReplyConfig, O as recordMessageReply, T as checkMessageReplyLimit, _ as sendVideoMsg, a as sendText, f as buildMediaTarget, g as sendPhoto, h as sendDocument, i as sendProactiveMessage, j as setOutboundAudioPort, k as DEFAULT_MEDIA_SEND_ERROR, m as resolveOutboundMediaPath, n as sendCronMessage, p as parseTarget, r as sendMedia, v as sendVoice, w as MESSAGE_REPLY_LIMIT } from "./outbound-BZHwMFUX.js";
-import { n as registerRemindTool, r as registerChannelTool, t as registerQQBotTools } from "./tools-C8kTMXKc.js";
-import { t as registerQQBotFull } from "./channel-entry-C18ypTaG.js";
+import { o as getFrameworkCommands } from "./group-o0GmovSf.js";
+import { A as OUTBOUND_ERROR_CODES, C as resolveUserFacingMediaError, D as getMessageReplyStats, E as getMessageReplyConfig, O as recordMessageReply, T as checkMessageReplyLimit, _ as sendVideoMsg, a as sendText, f as buildMediaTarget, g as sendPhoto, h as sendDocument, i as sendProactiveMessage, j as setOutboundAudioPort, k as DEFAULT_MEDIA_SEND_ERROR, m as resolveOutboundMediaPath, n as sendCronMessage, p as parseTarget, r as sendMedia, v as sendVoice, w as MESSAGE_REPLY_LIMIT } from "./outbound-BIrfvvFJ.js";
+import { n as registerRemindTool, r as registerChannelTool, t as registerQQBotTools } from "./tools-UJJ-tLHP.js";
+import { t as registerQQBotFull } from "./channel-entry-C5YdhX3Y.js";
 export { DEFAULT_ACCOUNT_ID, DEFAULT_MEDIA_SEND_ERROR, MESSAGE_REPLY_LIMIT, OUTBOUND_ERROR_CODES, applyQQBotAccountConfig, buildMediaTarget, checkMessageReplyLimit, getFrameworkCommands, getMessageReplyConfig, getMessageReplyStats, listQQBotAccountIds, parseTarget, qqbotPlugin, qqbotSetupPlugin, recordMessageReply, registerChannelTool, registerQQBotFull, registerQQBotTools, registerRemindTool, resolveDefaultQQBotAccountId, resolveOutboundMediaPath, resolveQQBotAccount, resolveUserFacingMediaError, sendCronMessage, sendDocument, sendMedia, sendPhoto, sendProactiveMessage, sendText, sendVideoMsg, sendVoice, setOutboundAudioPort };

package/dist/{channel-BQM6pDlD.js → channel-D1UztsnG.js}

@@ -1,10 +1,11 @@
 import { t as asOptionalObjectRecord } from "./string-normalize-R_0cKO7Q.js";
 import { a as qqbotSetupAdapterShared, i as qqbotMeta, n as qqbotSetupWizard, o as ensurePlatformAdapter, r as qqbotConfigAdapter, s as getBridgeLogger, t as qqbotChannelConfigSchema } from "./config-schema-JZEf1dvB.js";
 import { a as resolveQQBotAccount, n as applyQQBotAccountConfig, r as listQQBotAccountIds, t as DEFAULT_ACCOUNT_ID$1 } from "./config-C1qZbh0K.js";
-import { t as getQQBotRuntime } from "./runtime-B4HWCOa-.js";
+import { t as getQQBotRuntime } from "./runtime-DodcT_fQ.js";
 import { n as legacyConfigRules, r as normalizeCompatibilityConfig, t as buildQQBotStateKey } from "./state-keys-CQKlAFyo.js";
-import { n as normalizeTarget, t as looksLikeQQBotTarget } from "./target-parser-DagYRQkP.js";
+import { n as normalizeTarget, r as parseTarget, t as looksLikeQQBotTarget } from "./target-parser-DagYRQkP.js";
 import { getExecApprovalReplyMetadata } from "openclaw/plugin-sdk/approval-runtime";
+import { buildChannelOutboundSessionRoute } from "openclaw/plugin-sdk/channel-core";
 import { createMessageReceiptFromOutboundResults, defineChannelMessageAdapter } from "openclaw/plugin-sdk/channel-outbound";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { sanitizeAssistantVisibleText } from "openclaw/plugin-sdk/text-chunking";
@@ -12,16 +13,24 @@ import { createChannelApprovalCapability } from "openclaw/plugin-sdk/approval-de
 import { createLazyChannelApprovalNativeRuntimeAdapter } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
 import { resolveApprovalRequestChannelAccountId, resolveApprovalRequestSessionConversation } from "openclaw/plugin-sdk/approval-native-runtime";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import { markImplicitSameChatApprovalAuthorization, resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
 import { createChannelExecApprovalProfile, isChannelExecApprovalClientEnabledFromConfig, matchesApprovalRequestFilters } from "openclaw/plugin-sdk/approval-client-runtime";
 import { normalizeAccountId } from "openclaw/plugin-sdk/routing";
 import { resolveChannelGroupToolsPolicy } from "openclaw/plugin-sdk/channel-policy";
 //#region extensions/qqbot/src/engine/approval/index.ts
+/**
+* Approval helpers — pure functions, zero framework dependencies.
+*
+* - Build approval message text + inline keyboard
+* - Resolve delivery target from session metadata
+* - Parse INTERACTION_CREATE button data
+*/
 function buildExecApprovalText(request) {
 	const expiresIn = Math.max(0, Math.round((request.expiresAtMs - Date.now()) / 1e3));
 	const lines = ["🔐 命令执行审批", ""];
 	const cmd = request.request.commandPreview ?? request.request.command ?? "";
-	if (cmd) lines.push(`\`\`\`\n${cmd.slice(0, 300)}\n\`\`\``);
+	if (cmd) lines.push(`\`\`\`\n${truncateUtf16Safe(cmd, 300)}\n\`\`\``);
 	if (request.request.cwd) lines.push(`\u{1f4c1} \u76ee\u5f55: ${request.request.cwd}`);
 	if (request.request.agentId) lines.push(`\u{1f916} Agent: ${request.request.agentId}`);
 	lines.push("", `\u23f1\ufe0f \u8d85\u65f6: ${expiresIn} \u79d2`);
@@ -366,7 +375,7 @@ function createQQBotApprovalCapability() {
 			},
 			load: async () => {
 				ensurePlatformAdapter();
-				return (await import("./handler-runtime-rU03VA43.js")).qqbotApprovalNativeRuntime;
+				return (await import("./handler-runtime-zQvT6SrI.js")).qqbotApprovalNativeRuntime;
 			}
 		})
 	});
@@ -999,8 +1008,8 @@ function resolveQQBotGroupToolPolicy(params) {
 }
 //#endregion
 //#region extensions/qqbot/src/channel.ts
-const loadGatewayModule = createLazyRuntimeModule(() => import("./gateway-CjdB3B6n.js"));
-const loadOutboundMessagingModule = createLazyRuntimeModule(() => import("./outbound-BZHwMFUX.js").then((n) => n.t));
+const loadGatewayModule = createLazyRuntimeModule(() => import("./gateway-pJQppxe4.js"));
+const loadOutboundMessagingModule = createLazyRuntimeModule(() => import("./outbound-BIrfvvFJ.js").then((n) => n.t));
 function createQQBotSendReceipt(params) {
 	const messageId = params.messageId?.trim();
 	return createMessageReceiptFromOutboundResults({
@@ -1013,6 +1022,25 @@ function createQQBotSendReceipt(params) {
 		kind: params.kind
 	});
 }
+function resolveQQBotOutboundSessionRoute(params) {
+	const target = parseTarget(params.target);
+	const chatType = target.type === "c2c" ? "direct" : "group";
+	const qualifiedTarget = `qqbot:${target.type}:${target.id}`;
+	return buildChannelOutboundSessionRoute({
+		cfg: params.cfg,
+		agentId: params.agentId,
+		channel: "qqbot",
+		accountId: params.accountId,
+		recipientSessionExact: true,
+		peer: {
+			kind: chatType,
+			id: target.id
+		},
+		chatType,
+		from: qualifiedTarget,
+		to: qualifiedTarget
+	});
+}
 async function sendQQBotText(params) {
 	await loadGatewayModule();
 	const account = resolveQQBotAccount(params.cfg, params.accountId);
@@ -1156,6 +1184,7 @@ const qqbotPlugin = {
 		targetPrefixes: ["qqbot"],
 		/** Normalize common QQ Bot target formats into the canonical qqbot:... form. */
 		normalizeTarget,
+		resolveOutboundSessionRoute: (params) => resolveQQBotOutboundSessionRoute(params),
 		targetResolver: {
 			/** Return true when the id looks like a QQ Bot target. */
 			looksLikeId: looksLikeQQBotTarget,
@@ -1225,7 +1254,8 @@ const qqbotPlugin = {
 						...ctx.getStatus(),
 						running: true,
 						connected: true,
-						lastConnectedAt: Date.now()
+						lastConnectedAt: Date.now(),
+						lastError: null
 					});
 					persistAccountCredentialSnapshot(account);
 				},
@@ -1235,7 +1265,8 @@ const qqbotPlugin = {
 						...ctx.getStatus(),
 						running: true,
 						connected: true,
-						lastConnectedAt: Date.now()
+						lastConnectedAt: Date.now(),
+						lastError: null
 					});
 					persistAccountCredentialSnapshot(account);
 				},
@@ -1245,6 +1276,14 @@ const qqbotPlugin = {
 						...ctx.getStatus(),
 						lastError: error.message
 					});
+				},
+				onDisconnected: ({ reason, fatal }) => {
+					log?.info(`[qqbot:${account.accountId}] Gateway disconnected${reason ? `: ${reason}` : ""}`);
+					ctx.setStatus({
+						...ctx.getStatus(),
+						connected: false,
+						...fatal && reason ? { lastError: reason } : {}
+					});
 				}
 			});
 		},

package/dist/{channel-entry-C18ypTaG.js → channel-entry-C5YdhX3Y.js}

@@ -1,7 +1,7 @@
 import { a as resolveQQBotAccount } from "./config-C1qZbh0K.js";
-import { d as PRIVATE_CHAT_ONLY_TEXT, n as resolveGroupCommandLevelFromAccountConfig, o as getFrameworkCommands } from "./group-BmS1Qwst.js";
-import { h as sendDocument } from "./outbound-BZHwMFUX.js";
-import { t as registerQQBotTools } from "./tools-C8kTMXKc.js";
+import { d as PRIVATE_CHAT_ONLY_TEXT, n as resolveGroupCommandLevelFromAccountConfig, o as getFrameworkCommands } from "./group-o0GmovSf.js";
+import { h as sendDocument } from "./outbound-BIrfvvFJ.js";
+import { t as registerQQBotTools } from "./tools-UJJ-tLHP.js";
 //#region extensions/qqbot/src/bridge/commands/framework-context-adapter.ts
 /**
 * Default queue snapshot used for framework-registered commands.

package/dist/channel-entry-api.js

@@ -1,2 +1,2 @@
-import { t as registerQQBotFull } from "./channel-entry-C18ypTaG.js";
+import { t as registerQQBotFull } from "./channel-entry-C5YdhX3Y.js";
 export { registerQQBotFull };

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as qqbotPlugin } from "./channel-BQM6pDlD.js";
+import { t as qqbotPlugin } from "./channel-D1UztsnG.js";
 export { qqbotPlugin };

package/dist/{gateway-CjdB3B6n.js → gateway-pJQppxe4.js}

@@ -1,15 +1,16 @@
-import { C as getNextMsgSeq, D as downloadFile, F as StreamInputMode, I as StreamInputState, M as getMaxUploadSize, P as StreamContentType, T as openLocalFile, a as createRawInputNotifyFn, b as stopBackgroundTokenRefresh, c as getMessageApi, d as initSender, f as onMessageSent, g as sendText, h as sendMedia, i as clearTokenCache, j as getImageMimeType, k as formatFileSize, l as getPluginUserAgent, m as sendInputNotify, n as acknowledgeInteraction, o as getAccessToken, p as registerAccount, r as buildDeliveryTarget, s as getGatewayUrl, t as accountToCreds, u as initApiConfig, x as withTokenRetry, y as startBackgroundTokenRefresh } from "./sender-BfVLJJYp.js";
+import { C as getNextMsgSeq, D as downloadFile, F as StreamInputMode, I as StreamInputState, M as getMaxUploadSize, P as StreamContentType, T as openLocalFile, a as createRawInputNotifyFn, b as stopBackgroundTokenRefresh, c as getMessageApi, d as initSender, f as onMessageSent, g as sendText, h as sendMedia, i as clearTokenCache, j as getImageMimeType, k as formatFileSize, l as getPluginUserAgent, m as sendInputNotify, n as acknowledgeInteraction, o as getAccessToken, p as registerAccount, r as buildDeliveryTarget, s as getGatewayUrl, t as accountToCreds, u as initApiConfig, x as withTokenRetry, y as startBackgroundTokenRefresh } from "./sender-CjDuU-uz.js";
 import { c as getPlatformAdapter, i as normalizeOptionalString$1, n as normalizeLowercaseStringOrEmpty$1, o as readStringField, s as sanitizeFileName, t as asOptionalObjectRecord } from "./string-normalize-R_0cKO7Q.js";
 import { c as setBridgeLogger, o as ensurePlatformAdapter } from "./config-schema-JZEf1dvB.js";
-import { a as authorizeQQBotApprovalAction, i as toGatewayAccount, n as createQQBotMarkdownChunker, p as parseApprovalButtonData, r as openQQBotSyncKeyedStore } from "./channel-BQM6pDlD.js";
+import { a as authorizeQQBotApprovalAction, i as toGatewayAccount, n as createQQBotMarkdownChunker, p as parseApprovalButtonData, r as openQQBotSyncKeyedStore } from "./channel-D1UztsnG.js";
 import { d as resolveAccountBase } from "./config-C1qZbh0K.js";
-import { a as formatErrorMessage, i as formatDuration, n as debugLog, r as debugWarn, t as debugError } from "./log-SDfMMBWe.js";
-import { n as getQQBotRuntimeForEngine, t as getQQBotRuntime } from "./runtime-B4HWCOa-.js";
+import { a as formatErrorMessage, i as formatDuration, n as debugLog, r as debugWarn, t as debugError } from "./log-DEtcoDWe.js";
+import { n as getQQBotRuntimeForEngine, t as getQQBotRuntime } from "./runtime-DodcT_fQ.js";
 import { t as buildQQBotStateKey } from "./state-keys-CQKlAFyo.js";
-import { a as resolveMentionPatterns, c as getPluginVersion, d as PRIVATE_CHAT_ONLY_TEXT, f as classifyCoreCommandForGroup, i as resolveGroupSettings, l as initCommands, n as resolveGroupCommandLevelFromAccountConfig, r as resolveGroupConfig, s as getFrameworkVersion, u as matchSlashCommand } from "./group-BmS1Qwst.js";
-import { B as normalizePath, C as resolveUserFacingMediaError, F as getQQBotMediaDir, L as getTempDir, M as checkSilkWasmAvailable, N as getHomeDir, P as getQQBotDataDir, R as isLocalPath, S as resolveWorkspaceScopedLocalRoots, _ as sendVideoMsg, b as resolveOutboundMediaLocalRoots, c as isCronReminderPayload, d as normalizeMediaTags, g as sendPhoto, h as sendDocument, j as setOutboundAudioPort, k as DEFAULT_MEDIA_SEND_ERROR, l as isMediaPayload, o as decodeMediaPath, r as sendMedia$1, s as encodePayloadForCron, u as parseQQBotPayload, v as sendVoice, x as resolveWorkspacePathCandidates, y as resolveTrustedOutboundMediaPath, z as isWindows } from "./outbound-BZHwMFUX.js";
+import { a as resolveMentionPatterns, c as getPluginVersion, d as PRIVATE_CHAT_ONLY_TEXT, f as classifyCoreCommandForGroup, i as resolveGroupSettings, l as initCommands, n as resolveGroupCommandLevelFromAccountConfig, r as resolveGroupConfig, s as getFrameworkVersion, u as matchSlashCommand } from "./group-o0GmovSf.js";
+import { B as normalizePath, C as resolveUserFacingMediaError, F as getQQBotMediaDir, L as getTempDir, M as checkSilkWasmAvailable, N as getHomeDir, P as getQQBotDataDir, R as isLocalPath, S as resolveWorkspaceScopedLocalRoots, _ as sendVideoMsg, b as resolveOutboundMediaLocalRoots, c as isCronReminderPayload, d as normalizeMediaTags, g as sendPhoto, h as sendDocument, j as setOutboundAudioPort, k as DEFAULT_MEDIA_SEND_ERROR, l as isMediaPayload, o as decodeMediaPath, r as sendMedia$1, s as encodePayloadForCron, u as parseQQBotPayload, v as sendVoice, x as resolveWorkspacePathCandidates, y as resolveTrustedOutboundMediaPath, z as isWindows } from "./outbound-BIrfvvFJ.js";
 import { n as runWithRequestContext } from "./request-context-Bm7PTBD1.js";
 import { uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import { isImplicitSameChatApprovalAuthorization } from "openclaw/plugin-sdk/approval-auth-runtime";
 import * as fs$1 from "node:fs";
 import fs from "node:fs";
@@ -459,7 +460,7 @@ async function trySlashCommand(msg, ctx) {
 	const contentLower = content.toLowerCase();
 	if (URGENT_COMMANDS.some((cmd) => contentLower === cmd.toLowerCase() || contentLower.startsWith(cmd.toLowerCase() + " "))) {
 		if (isGroup && !commandAuthorized) return "enqueue";
-		log?.info(`Urgent command detected: ${content.slice(0, 20)}`);
+		log?.info(`Urgent command detected: ${truncateUtf16Safe(content, 20)}`);
 		return "urgent";
 	}
 	const receivedAt = Date.now();
@@ -1155,7 +1156,7 @@ function createMessageQueue(ctx) {
 		for (const m of batch) if (isSlashCommand(m)) commands.push(m);
 		else normal.push(m);
 		for (const cmd of commands) {
-			log?.debug?.(`Processing command independently for ${peerId}: ${(cmd.content ?? "").trim().slice(0, 50)}`);
+			log?.debug?.(`Processing command independently for ${peerId}: ${truncateUtf16Safe((cmd.content ?? "").trim(), 50)}`);
 			await processOne(cmd, peerId, "Command processor");
 		}
 		if (normal.length > 0) {
@@ -1488,6 +1489,10 @@ var GatewayConnection = class {
 		const { account: _account, log } = this.ctx;
 		if (this.isAborted || this.reconnect.isExhausted()) {
 			log?.error(`Max reconnect attempts reached or aborted`);
+			if (!this.isAborted) this.ctx.onDisconnected?.({
+				reason: "reconnect attempts exhausted",
+				fatal: true
+			});
 			return;
 		}
 		if (this.reconnectTimer) {
@@ -1579,11 +1584,20 @@ var GatewayConnection = class {
 						}
 						case GatewayOp.HEARTBEAT_ACK: break;
 						case GatewayOp.RECONNECT:
+							this.ctx.onDisconnected?.({
+								reason: "server requested reconnect",
+								fatal: false
+							});
 							this.cleanup();
 							this.scheduleReconnect();
 							break;
-						case GatewayOp.INVALID_SESSION:
-							if (!d) {
+						case GatewayOp.INVALID_SESSION: {
+							const canResume = d;
+							this.ctx.onDisconnected?.({
+								reason: canResume ? "session resume rejected" : "session invalidated",
+								fatal: false
+							});
+							if (!canResume) {
 								this.sessionId = null;
 								this.lastSeq = null;
 								clearSession(account.accountId);
@@ -1592,6 +1606,7 @@ var GatewayConnection = class {
 							this.cleanup();
 							this.scheduleReconnect(3e3);
 							break;
+						}
 					}
 				} catch (err) {
 					log?.error(`Message parse error: ${err instanceof Error ? err.message : String(err)}`);
@@ -1599,6 +1614,7 @@ var GatewayConnection = class {
 			});
 			ws.on("close", (code, reason) => {
 				log?.info(`WebSocket closed: ${code} ${reason.toString()}`);
+				if (this.currentWs !== ws) return;
 				this.isConnecting = false;
 				this.handleClose(code);
 			});
@@ -1650,6 +1666,10 @@ var GatewayConnection = class {
 		}
 		if (action.refreshToken) this.shouldRefreshToken = true;
 		this.cleanup();
+		if (!this.isAborted) this.ctx.onDisconnected?.({
+			reason: action.reason,
+			fatal: action.fatal
+		});
 		if (action.fatal) return;
 		if (action.shouldReconnect) this.scheduleReconnect(action.reconnectDelay);
 	}
@@ -1717,7 +1737,7 @@ async function transcribeAudio(audioPath, cfg) {
 	try {
 		if (!resp.ok) {
 			const detail = await readResponseTextLimited(resp, STT_ERROR_BODY_LIMIT_BYTES).catch(() => "");
-			throw new Error(`STT failed (HTTP ${resp.status}): ${detail.slice(0, 300)}`);
+			throw new Error(`STT failed (HTTP ${resp.status}): ${truncateUtf16Safe(detail, 300)}`);
 		}
 		return normalizeOptionalString$1((await readProviderJsonResponse(resp, "qqbot.stt")).text) ?? null;
 	} finally {
@@ -1925,7 +1945,7 @@ async function processVoiceAttachment(localPath, audioPathInput, att, asrReferTe
 	try {
 		const transcript = await transcribeAudio(audioPath, cfg);
 		if (transcript) {
-			log?.debug?.(`STT transcript: ${transcript.slice(0, 100)}...`);
+			log?.debug?.(`STT transcript: ${truncateUtf16Safe(transcript, 100)}...`);
 			return {
 				localPath,
 				type: "voice",
@@ -2671,7 +2691,7 @@ async function resolveQuote(event, deps) {
 			cfg: account.config,
 			log
 		}, attachmentProcessor);
-		log?.debug?.(`Quote detected via msg_elements[0] (cache miss): id=${event.refMsgIdx}, content="${(refBody ?? "").slice(0, 80)}..."`);
+		log?.debug?.(`Quote detected via msg_elements[0] (cache miss): id=${event.refMsgIdx}, content="${truncateUtf16Safe(refBody ?? "", 80)}..."`);
 		return {
 			id: event.refMsgIdx,
 			body: refBody || void 0,
@@ -3297,6 +3317,13 @@ function hasQQBotImageSize(markdownImage) {
 }
 //#endregion
 //#region extensions/qqbot/src/engine/messaging/outbound-deliver.ts
+/**
+* Outbound delivery helpers — core/ version.
+*
+* Uses the unified `sender.ts` business function layer for all text and
+* image sending. Media sends (photo/voice/video/file) are injected via
+* `DeliverDeps.mediaSender`.
+*/
 /** Maximum text length for a single QQ Bot message. */
 const TEXT_CHUNK_LIMIT = 5e3;
 function resolveMediaTargetContext(event, actx) {
@@ -3368,7 +3395,7 @@ async function sendTextChunks(text, event, actx, sendWithRetry, consumeQuoteRef,
 		consumeQuoteRef,
 		allowDm: true,
 		log,
-		onSuccess: (chunk) => `Sent text chunk (${chunk.length}/${text.length} chars): ${chunk.slice(0, 50)}...`,
+		onSuccess: (chunk) => `Sent text chunk (${chunk.length}/${text.length} chars): ${truncateUtf16Safe(chunk, 50)}...`,
 		onError: (err) => `Failed to send text chunk: ${formatErrorMessage(err)}`
 	});
 }
@@ -3385,7 +3412,7 @@ async function sendTextOnlyReply(text, event, actx, sendWithRetry, consumeQuoteR
 		allowDm: true,
 		forcePlainText: true,
 		log,
-		onSuccess: (chunk) => `Sent text-only chunk (${chunk.length}/${safeText.length} chars): ${chunk.slice(0, 50)}...`,
+		onSuccess: (chunk) => `Sent text-only chunk (${chunk.length}/${safeText.length} chars): ${truncateUtf16Safe(chunk, 50)}...`,
 		onError: (err) => `Failed to send text-only chunk: ${formatErrorMessage(err)}`
 	});
 }
@@ -3593,7 +3620,7 @@ async function sendPlainReply(payload, replyText, event, actx, sendWithRetry, co
 		if (isRemoteHttpUrl || isDataUrl) {
 			if (!collectedImageUrls.includes(url)) {
 				collectedImageUrls.push(url);
-				log?.debug?.(`Collected ${isDataUrl ? "Base64" : "media URL"}: ${isDataUrl ? `(length: ${url.length})` : url.slice(0, 80) + "..."}`);
+				log?.debug?.(`Collected ${isDataUrl ? "Base64" : "media URL"}: ${isDataUrl ? `(length: ${url.length})` : truncateUtf16Safe(url, 80) + "..."}`);
 			}
 			return true;
 		}
@@ -3614,7 +3641,7 @@ async function sendPlainReply(payload, replyText, event, actx, sendWithRetry, co
 		if (url && !collectedImageUrls.includes(url)) {
 			if (isHttpUrl(url)) {
 				collectedImageUrls.push(url);
-				log?.debug?.(`Extracted HTTP image from markdown: ${url.slice(0, 80)}...`);
+				log?.debug?.(`Extracted HTTP image from markdown: ${truncateUtf16Safe(url, 80)}...`);
 			} else if (isLocalPath(url)) {
 				if (!localMediaToSend.includes(url)) {
 					localMediaToSend.push(url);
@@ -3628,7 +3655,7 @@ async function sendPlainReply(payload, replyText, event, actx, sendWithRetry, co
 		const url = m[1];
 		if (url && !collectedImageUrls.includes(url)) {
 			collectedImageUrls.push(url);
-			log?.debug?.(`Extracted bare image URL: ${url.slice(0, 80)}...`);
+			log?.debug?.(`Extracted bare image URL: ${truncateUtf16Safe(url, 80)}...`);
 		}
 	}
 	const useMarkdown = account.markdownSupport;
@@ -3676,7 +3703,7 @@ async function sendPlainReply(payload, replyText, event, actx, sendWithRetry, co
 			...actx.mediaLocalRoots ? { mediaLocalRoots: actx.mediaLocalRoots } : {},
 			...actx.mediaReadFile ? { mediaReadFile: actx.mediaReadFile } : {},
 			log,
-			onSuccess: (mediaUrl) => `Forwarded tool media: ${mediaUrl.slice(0, 80)}...`,
+			onSuccess: (mediaUrl) => `Forwarded tool media: ${truncateUtf16Safe(mediaUrl, 80)}...`,
 			onResultError: (_mediaUrl, error) => `Tool media forward error: ${error}`,
 			onThrownError: (_mediaUrl, error) => `Tool media forward failed: ${error}`
 		});
@@ -3716,7 +3743,7 @@ async function sendMarkdownReply(textWithoutImages, imageUrls, mdMatches, bareUr
 	for (const url of httpImageUrls) if (!existingMdUrls.has(url)) try {
 		const size = await getImageSize(url);
 		imagesToAppend.push(formatQQBotMarkdownImage(url, size));
-		log?.debug?.(`Formatted HTTP image: ${size ? `${size.width}x${size.height}` : "default size"} - ${url.slice(0, 60)}...`);
+		log?.debug?.(`Formatted HTTP image: ${size ? `${size.width}x${size.height}` : "default size"} - ${truncateUtf16Safe(url, 60)}...`);
 	} catch (err) {
 		log?.debug?.(`Failed to get image size, using default: ${formatErrorMessage(err)}`);
 		imagesToAppend.push(formatQQBotMarkdownImage(url, null));
@@ -3728,7 +3755,7 @@ async function sendMarkdownReply(textWithoutImages, imageUrls, mdMatches, bareUr
 		if (isHttpUrl(imgUrl) && !hasQQBotImageSize(fullMatch)) try {
 			const size = await getImageSize(imgUrl);
 			result = result.replace(fullMatch, formatQQBotMarkdownImage(imgUrl, size));
-			log?.debug?.(`Updated image with size: ${size ? `${size.width}x${size.height}` : "default"} - ${imgUrl.slice(0, 60)}...`);
+			log?.debug?.(`Updated image with size: ${size ? `${size.width}x${size.height}` : "default"} - ${truncateUtf16Safe(imgUrl, 60)}...`);
 		} catch (err) {
 			log?.debug?.(`Failed to get image size for existing md, using default: ${formatErrorMessage(err)}`);
 			result = result.replace(fullMatch, formatQQBotMarkdownImage(imgUrl, null));
@@ -3764,7 +3791,7 @@ async function sendPlainTextReply(textWithoutImages, imageUrls, mdMatches, bareU
 			imageUrl,
 			mediaSender: deps.mediaSender,
 			log,
-			onSuccess: (nextImageUrl) => `Sent image via sendPhoto: ${nextImageUrl.slice(0, 80)}...`,
+			onSuccess: (nextImageUrl) => `Sent image via sendPhoto: ${truncateUtf16Safe(nextImageUrl, 80)}...`,
 			onError: (error) => `Failed to send image: ${error}`
 		});
 		if (result.trim()) await sendTextChunksWithRetry({
@@ -3905,7 +3932,7 @@ function resolveStructuredPayloadPath(ctx, payload, mediaType) {
 	};
 }
 function sanitizeForLog(value, maxLen = 200) {
-	return value.replace(/[\r\n\t]/g, " ").replaceAll("\0", " ").slice(0, maxLen);
+	return truncateUtf16Safe(value.replace(/[\r\n\t]/g, " ").replaceAll("\0", " "), maxLen);
 }
 function describeMediaTargetForLog(pathValue, isHttpUrl) {
 	if (!isHttpUrl) return "<local-file>";
@@ -4053,7 +4080,7 @@ async function sendTextAsVoiceReply(ctx, text, deps) {
 			log?.error(`Voice missing text`);
 			return false;
 		}
-		log?.debug?.(`TTS: "${ttsText.slice(0, 50)}..."`);
+		log?.debug?.(`TTS: "${truncateUtf16Safe(ttsText, 50)}..."`);
 		const ttsResult = await deps.tts.textToSpeech({
 			text: ttsText,
 			cfg,
@@ -4212,6 +4239,12 @@ async function handleFilePayload(ctx, payload) {
 }
 //#endregion
 //#region extensions/qqbot/src/engine/messaging/streaming-media-send.ts
+/**
+* 富媒体标签解析与发送队列
+*
+* 提供媒体标签（qqimg / qqvoice / qqvideo / qqfile / qqmedia）的检测、
+* 拆分、路径编码修复，以及统一的发送队列执行器。
+*/
 function formatStreamSendErr(e) {
 	return e instanceof Error ? e.message : String(e);
 }
@@ -4358,7 +4391,7 @@ async function executeSendQueue(queue, ctx, options = {}) {
 			else log?.info(`${prefix} executeSendQueue: no onSendText handler, skipping text`);
 			continue;
 		}
-		log?.info(`${prefix} executeSendQueue: sending ${item.type}: ${item.content.slice(0, 80)}...`);
+		log?.info(`${prefix} executeSendQueue: sending ${item.type}: ${truncateUtf16Safe(item.content, 80)}...`);
 		if (item.type === "image") {
 			const result = await sendPhoto(mediaTarget, item.content);
 			if (result.error) {
@@ -4565,11 +4598,11 @@ const THROTTLE_CONSTANTS = {
 	BATCH_AFTER_GAP_MS: 300
 };
 /** 终态集合 */
-const TERMINAL_PHASES = new Set(["completed", "aborted"]);
+const TERMINAL_PHASES = /* @__PURE__ */ new Set(["completed", "aborted"]);
 /** 允许的状态转换 */
 const PHASE_TRANSITIONS = {
-	idle: new Set(["streaming", "aborted"]),
-	streaming: new Set([
+	idle: /* @__PURE__ */ new Set(["streaming", "aborted"]),
+	streaming: /* @__PURE__ */ new Set([
 		"idle",
 		"completed",
 		"aborted"
@@ -4852,7 +4885,7 @@ var StreamingController = class {
 	*/
 	async onDeliver(payload) {
 		const rawLen = payload.text?.length ?? 0;
-		const preview = (payload.text ?? "").slice(0, 60).replace(/\n/g, "\\n");
+		const preview = truncateUtf16Safe(payload.text ?? "", 60).replace(/\n/g, "\\n");
 		this.logDebug(`onDeliver: rawLen=${rawLen}, phase=${this.phase}, streamMsgId=${this.streamMsgId}, sentIndex=${this.sentIndex}, sentChunks=${this.sentStreamChunkCount}, firstCB=${this.firstCallbackSource}, preview="${preview}"`);
 		if (this.isTerminalPhase) {
 			this.logDebug(`onDeliver: skipped (terminal phase)`);
@@ -5000,7 +5033,7 @@ var StreamingController = class {
 				if (this.isTerminalPhase) return;
 				const found = findFirstClosedMediaTag(normalizedFull.slice(this.sentIndex));
 				if (!found) break;
-				this.logInfo(`processMediaTags: found <${found.tagName}> at offset ${this.sentIndex}, textBefore="${found.textBefore.slice(0, 40)}"`);
+				this.logInfo(`processMediaTags: found <${found.tagName}> at offset ${this.sentIndex}, textBefore="${truncateUtf16Safe(found.textBefore, 40)}"`);
 				const textBeforeEndInFull = this.sentIndex + found.textBefore.length;
 				await this.endCurrentStreamIfNeeded("processMediaTags:closedTag", textBeforeEndInFull);
 				if (this.isTerminalPhase) return;
@@ -5009,7 +5042,7 @@ var StreamingController = class {
 						type: found.itemType,
 						content: found.mediaPath
 					};
-					this.logDebug(`processMediaTags: sending ${found.itemType}: ${found.mediaPath.slice(0, 80)}`);
+					this.logDebug(`processMediaTags: sending ${found.itemType}: ${truncateUtf16Safe(found.mediaPath, 80)}`);
 					await sendMediaQueue([item], this.deps.mediaContext);
 					this.sentMediaCount++;
 					this.sentStreamChunkCount++;
@@ -5334,7 +5367,7 @@ function isAudioFile(filePath, mimeType) {
 		".pcm"
 	].includes(ext);
 }
-const QQ_NATIVE_VOICE_MIMES = new Set([
+const QQ_NATIVE_VOICE_MIMES = /* @__PURE__ */ new Set([
 	"audio/silk",
 	"audio/amr",
 	"audio/wav",
@@ -5343,7 +5376,7 @@ const QQ_NATIVE_VOICE_MIMES = new Set([
 	"audio/mpeg",
 	"audio/mp3"
 ]);
-const QQ_NATIVE_VOICE_EXTS = new Set([
+const QQ_NATIVE_VOICE_EXTS = /* @__PURE__ */ new Set([
 	".silk",
 	".slk",
 	".amr",
@@ -5807,7 +5840,7 @@ async function dispatchOutbound(inbound, deps) {
 			resultError: "Tool fallback error",
 			thrownError: "Tool fallback failed"
 		});
-		if (toolTexts.length > 0) await sendErrorMessage(toolTexts.slice(-3).join("\n---\n").slice(0, 2e3));
+		if (toolTexts.length > 0) await sendErrorMessage(truncateUtf16Safe(toolTexts.slice(-3).join("\n---\n"), 2e3));
 	};
 	const hasPendingToolFallbackPayload = () => toolTexts.length > 0 || toolMediaUrls.length > 0;
 	const flushPendingToolDeliveriesOnce = async () => {
@@ -6308,7 +6341,7 @@ async function startGateway$1(ctx) {
 	initApiConfig(account.appId, { markdownSupport: account.markdownSupport });
 	log?.debug?.(`API config: markdownSupport=${account.markdownSupport}`);
 	onMessageSent(account.appId, (refIdx, meta) => {
-		log?.info(`onMessageSent called: refIdx=${refIdx}, mediaType=${meta.mediaType}, ttsText=${meta.ttsText?.slice(0, 30)}`);
+		log?.info(`onMessageSent called: refIdx=${refIdx}, mediaType=${meta.mediaType}, ttsText=${meta.ttsText === void 0 ? void 0 : truncateUtf16Safe(meta.ttsText, 30)}`);
 		const attachments = [];
 		if (meta.mediaType) {
 			const localPath = meta.mediaLocalPath;
@@ -6455,6 +6488,7 @@ async function startGateway$1(ctx) {
 		onReady: ctx.onReady,
 		onResumed: ctx.onResumed,
 		onError: ctx.onError,
+		onDisconnected: ctx.onDisconnected,
 		onInteraction: handleInteraction,
 		handleMessage
 	}).start();
@@ -6770,6 +6804,7 @@ async function startGateway(ctx) {
 		onReady: ctx.onReady,
 		onResumed: ctx.onResumed,
 		onError: ctx.onError,
+		onDisconnected: ctx.onDisconnected,
 		log: accountLogger,
 		runtime,
 		adapters: createEngineAdapters()

package/dist/{group-BmS1Qwst.js → group-o0GmovSf.js}

@@ -1,10 +1,11 @@
 import { t as asOptionalObjectRecord } from "./string-normalize-R_0cKO7Q.js";
 import { d as resolveAccountBase } from "./config-C1qZbh0K.js";
-import { n as debugLog } from "./log-SDfMMBWe.js";
-import { I as getQQBotMediaPath, N as getHomeDir, P as getQQBotDataDir, z as isWindows } from "./outbound-BZHwMFUX.js";
+import { n as debugLog } from "./log-DEtcoDWe.js";
+import { I as getQQBotMediaPath, N as getHomeDir, P as getQQBotDataDir, z as isWindows } from "./outbound-BIrfvvFJ.js";
 import { asBoolean, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import fs from "node:fs";
 import path from "node:path";
+import { formatByteSize } from "openclaw/plugin-sdk/number-runtime";
 import { clearRuntimeConfigSnapshot } from "openclaw/plugin-sdk/runtime-config-snapshot";
 import { loadJsonFile } from "openclaw/plugin-sdk/json-store";
 //#region extensions/qqbot/src/engine/commands/builtin/state.ts
@@ -321,10 +322,12 @@ function scanDirectoryFiles(dirPath) {
 	return files;
 }
 function formatBytes(bytes) {
-	if (bytes < 1024) return `${bytes} B`;
-	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-	if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-	return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+	return formatByteSize(bytes, {
+		style: "legacy-binary",
+		maxUnit: "giga",
+		separator: " ",
+		fractionDigits: (_value, unit) => unit === "byte" ? null : 1
+	});
 }
 function removeEmptyDirs(dirPath) {
 	if (!fs.existsSync(dirPath)) return;
@@ -549,7 +552,7 @@ function collectCandidateLogDirs() {
 		pushDir(path.join(homeDir, name));
 		pushDir(path.join(homeDir, name, "logs"));
 	}
-	const searchRoots = new Set([
+	const searchRoots = /* @__PURE__ */ new Set([
 		homeDir,
 		process.cwd(),
 		path.dirname(process.cwd())
@@ -880,14 +883,14 @@ function registerBuiltinSlashCommands(registry) {
 //#endregion
 //#region extensions/qqbot/src/engine/commands/command-visibility.ts
 const PRIVATE_CHAT_ONLY_TEXT = "该命令仅限私聊使用，请在私聊中发送。";
-const GROUP_VISIBLE_CORE_COMMANDS = new Set([
+const GROUP_VISIBLE_CORE_COMMANDS = /* @__PURE__ */ new Set([
 	"help",
 	"btw",
 	"side",
 	"stop"
 ]);
-const STRICT_CORE_COMMANDS = new Set(["new", "reset"]);
-const GROUP_HIDDEN_CORE_COMMANDS = new Set([
+const STRICT_CORE_COMMANDS = /* @__PURE__ */ new Set(["new", "reset"]);
+const GROUP_HIDDEN_CORE_COMMANDS = /* @__PURE__ */ new Set([
 	"goal",
 	"usage",
 	"activation",
@@ -904,7 +907,7 @@ const GROUP_HIDDEN_CORE_COMMANDS = new Set([
 	"reason",
 	"queue"
 ]);
-const PRIVATE_ONLY_CORE_COMMANDS = new Set([
+const PRIVATE_ONLY_CORE_COMMANDS = /* @__PURE__ */ new Set([
 	"commands",
 	"tools",
 	"skill",

package/dist/{handler-runtime-rU03VA43.js → handler-runtime-zQvT6SrI.js}

@@ -1,6 +1,6 @@
-import { c as getMessageApi, t as accountToCreds } from "./sender-BfVLJJYp.js";
+import { c as getMessageApi, t as accountToCreds } from "./sender-CjDuU-uz.js";
 import { o as ensurePlatformAdapter, s as getBridgeLogger } from "./config-schema-JZEf1dvB.js";
-import { c as resolveQQBotExecApprovalConfig, d as buildExecApprovalText, f as buildPluginApprovalText, l as shouldHandleQQBotExecApprovalRequest, m as resolveApprovalTarget, o as isQQBotExecApprovalClientEnabled, s as matchesQQBotApprovalAccount, u as buildApprovalKeyboard } from "./channel-BQM6pDlD.js";
+import { c as resolveQQBotExecApprovalConfig, d as buildExecApprovalText, f as buildPluginApprovalText, l as shouldHandleQQBotExecApprovalRequest, m as resolveApprovalTarget, o as isQQBotExecApprovalClientEnabled, s as matchesQQBotApprovalAccount, u as buildApprovalKeyboard } from "./channel-D1UztsnG.js";
 import { a as resolveQQBotAccount } from "./config-C1qZbh0K.js";
 import { resolveApprovalRequestSessionConversation } from "openclaw/plugin-sdk/approval-native-runtime";
 import { createChannelApprovalNativeRuntimeAdapter } from "openclaw/plugin-sdk/approval-handler-runtime";

package/dist/{log-SDfMMBWe.js → log-DEtcoDWe.js}

@@ -1,3 +1,4 @@
+import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 //#region extensions/qqbot/src/engine/utils/format.ts
 /**
 * General formatting and string utilities.
@@ -22,7 +23,7 @@ function formatErrorMessage(err) {
 	if (err instanceof Error) {
 		let formatted = err.message || err.name || "Error";
 		let cause = err.cause;
-		const seen = new Set([err]);
+		const seen = /* @__PURE__ */ new Set([err]);
 		while (cause && !seen.has(cause)) {
 			seen.add(cause);
 			if (cause instanceof Error) {
@@ -59,8 +60,6 @@ function formatDuration(durationMs) {
 *
 * Only outputs when the QQBOT_DEBUG environment variable is set,
 * preventing user message content from leaking in production logs.
-*
-* Self-contained within engine/ — no framework SDK dependency.
 */
 function isQqbotDebugEnabled() {
 	const value = process.env.QQBOT_DEBUG;
@@ -86,7 +85,7 @@ function sanitizeDebugLogValue(value) {
 	}
 	const sanitized = text.replace(/\p{Cc}/gu, " ").replace(/\s+/g, " ").trim();
 	if (sanitized.length <= MAX_LOG_VALUE_CHARS) return sanitized;
-	return `${sanitized.slice(0, MAX_LOG_VALUE_CHARS)}...`;
+	return `${truncateUtf16Safe(sanitized, MAX_LOG_VALUE_CHARS)}...`;
 }
 function formatDebugLogArgs(args) {
 	return args.map(sanitizeDebugLogValue).join(" ");

package/dist/{outbound-BZHwMFUX.js → outbound-BIrfvvFJ.js}

@@ -1,7 +1,8 @@
-import { A as getFileTypeName, D as downloadFile, E as checkFileSize, L as __exportAll, M as getMaxUploadSize, N as readFileAsync, O as fileExistsAsync, S as UploadDailyLimitExceededError, g as sendText$1, h as sendMedia$1, j as getImageMimeType, k as formatFileSize, t as accountToCreds, u as initApiConfig, w as UPLOAD_PREPARE_FALLBACK_CODE } from "./sender-BfVLJJYp.js";
+import { A as getFileTypeName, D as downloadFile, E as checkFileSize, L as __exportAll, M as getMaxUploadSize, N as readFileAsync, O as fileExistsAsync, S as UploadDailyLimitExceededError, g as sendText$1, h as sendMedia$1, j as getImageMimeType, k as formatFileSize, t as accountToCreds, u as initApiConfig, w as UPLOAD_PREPARE_FALLBACK_CODE } from "./sender-CjDuU-uz.js";
 import { c as getPlatformAdapter, i as normalizeOptionalString, n as normalizeLowercaseStringOrEmpty, s as sanitizeFileName } from "./string-normalize-R_0cKO7Q.js";
-import { a as formatErrorMessage, n as debugLog, r as debugWarn, t as debugError } from "./log-SDfMMBWe.js";
+import { a as formatErrorMessage, n as debugLog, r as debugWarn, t as debugError } from "./log-DEtcoDWe.js";
 import { r as parseTarget$1 } from "./target-parser-DagYRQkP.js";
+import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import * as fs$2 from "node:fs";
 import * as os$1 from "node:os";
 import { randomUUID } from "node:crypto";
@@ -127,7 +128,7 @@ async function checkSilkWasmAvailable() {
 	if (silkWasmAvailable !== null) return silkWasmAvailable;
 	try {
 		const { isSilk } = await import("silk-wasm");
-		isSilk(new Uint8Array(0));
+		isSilk(/* @__PURE__ */ new Uint8Array(0));
 		silkWasmAvailable = true;
 		debugLog("[platform] silk-wasm: available");
 	} catch (err) {
@@ -179,7 +180,7 @@ function resolveQQBotLocalMediaPath(p) {
 	const mediaRoot = getQQBotMediaPath();
 	const dataRoot = getQQBotDataPath();
 	const candidateRoots = [
-		...Array.from(new Set([path$1.join(osHomeDir, ".openclaw", "workspace", "qqbot"), path$1.join(openclawHomeDir, ".openclaw", "workspace", "qqbot")])).map((from) => ({
+		...Array.from(/* @__PURE__ */ new Set([path$1.join(osHomeDir, ".openclaw", "workspace", "qqbot"), path$1.join(openclawHomeDir, ".openclaw", "workspace", "qqbot")])).map((from) => ({
 			from,
 			to: mediaRoot
 		})),
@@ -747,13 +748,13 @@ async function sendPhoto(ctx, imagePath) {
 		if (localFile) return await sendPhotoFromLocal(ctx, localFile);
 		return {
 			channel: "qqbot",
-			error: `Failed to download image: ${mediaPath.slice(0, 80)}`
+			error: `Failed to download image: ${truncateUtf16Safe(mediaPath, 80)}`
 		};
 	}
 	if (isLocal) return await sendPhotoFromLocal(ctx, mediaPath);
 	if (!isHttp && !isData) return {
 		channel: "qqbot",
-		error: `Unsupported image source: ${mediaPath.slice(0, 50)}`
+		error: `Unsupported image source: ${truncateUtf16Safe(mediaPath, 50)}`
 	};
 	try {
 		const creds = accountToCreds(ctx.account);
@@ -916,7 +917,7 @@ async function sendVoice(ctx, voicePath, directUploadFormats, transcodeEnabled =
 		if (localFile) return await sendVoiceFromLocal(ctx, localFile, directUploadFormats, transcodeEnabled);
 		return {
 			channel: "qqbot",
-			error: `Failed to download audio: ${mediaPath.slice(0, 80)}`
+			error: `Failed to download audio: ${truncateUtf16Safe(mediaPath, 80)}`
 		};
 	}
 	return await sendVoiceFromLocal(ctx, mediaPath, directUploadFormats, transcodeEnabled);
@@ -1011,7 +1012,7 @@ async function sendVideoMsg(ctx, videoPath) {
 		if (localFile) return await sendVideoFromLocal(ctx, localFile);
 		return {
 			channel: "qqbot",
-			error: `Failed to download video: ${mediaPath.slice(0, 80)}`
+			error: `Failed to download video: ${truncateUtf16Safe(mediaPath, 80)}`
 		};
 	}
 	try {
@@ -1125,7 +1126,7 @@ async function sendDocument(ctx, filePath, options = {}) {
 		if (localFile) return await sendDocumentFromLocal(ctx, localFile);
 		return {
 			channel: "qqbot",
-			error: `Failed to download file: ${mediaPath.slice(0, 80)}`
+			error: `Failed to download file: ${truncateUtf16Safe(mediaPath, 80)}`
 		};
 	}
 	try {
@@ -1230,7 +1231,7 @@ async function downloadToFallbackDir(httpUrl, caller) {
 	try {
 		const localFile = await downloadFile(httpUrl, getQQBotMediaDir("downloads", "url-fallback"));
 		if (!localFile) {
-			debugError(`${caller} fallback: download also failed for ${httpUrl.slice(0, 80)}`);
+			debugError(`${caller} fallback: download also failed for ${truncateUtf16Safe(httpUrl, 80)}`);
 			return null;
 		}
 		debugLog(`${caller} fallback: downloaded → ${localFile}`);
@@ -1395,7 +1396,8 @@ function parseQQBotPayload(text) {
 /** Encode a cron reminder payload into the stored cron-message format. */
 function encodePayloadForCron(payload) {
 	const jsonString = JSON.stringify(payload);
-	return `${CRON_PREFIX}${Buffer.from(jsonString, "utf-8").toString("base64")}`;
+	const base64 = Buffer.from(jsonString, "utf-8").toString("base64");
+	return `${CRON_PREFIX}${base64}`;
 }
 /** Decode a stored cron payload. */
 function decodeCronPayload(message) {
@@ -1512,7 +1514,7 @@ function decodeMediaPath(raw, log) {
 * These replace the inline `isImageFile` and `isVideoFile` helpers scattered
 * across `outbound.ts`. Centralizing them here keeps detection consistent.
 */
-const IMAGE_EXTENSIONS = new Set([
+const IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
 	".jpg",
 	".jpeg",
 	".png",
@@ -1520,7 +1522,7 @@ const IMAGE_EXTENSIONS = new Set([
 	".webp",
 	".bmp"
 ]);
-const VIDEO_EXTENSIONS = new Set([
+const VIDEO_EXTENSIONS = /* @__PURE__ */ new Set([
 	".mp4",
 	".mov",
 	".avi",
@@ -1582,7 +1584,7 @@ async function sendText(ctx) {
 	initApiConfig(account.appId, { markdownSupport: account.markdownSupport });
 	debugLog("[qqbot] sendText ctx:", JSON.stringify({
 		to,
-		text: text?.slice(0, 50),
+		text: truncateUtf16Safe(text, 50),
 		replyToId,
 		accountId: account.accountId
 	}, null, 2));
@@ -1680,7 +1682,7 @@ async function sendText(ctx) {
 					timestamp: result.timestamp,
 					refIdx: result.ext_info?.ref_idx
 				};
-				debugLog(`[qqbot] sendText: Sent text part: ${item.content.slice(0, 30)}...`);
+				debugLog(`[qqbot] sendText: Sent text part: ${truncateUtf16Safe(item.content, 30)}...`);
 			} else if (item.type === "image") lastResult = await sendPhoto(mediaTarget, item.content);
 			else if (item.type === "voice") lastResult = await sendVoice(mediaTarget, item.content, void 0, account.config?.audioFormatPolicy?.transcodeEnabled !== false);
 			else if (item.type === "video") lastResult = await sendVideoMsg(mediaTarget, item.content);

package/dist/{runtime-B4HWCOa-.js → runtime-DodcT_fQ.js}

@@ -1,4 +1,4 @@
-import { v as setOpenClawVersion } from "./sender-BfVLJJYp.js";
+import { v as setOpenClawVersion } from "./sender-CjDuU-uz.js";
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 //#region extensions/qqbot/src/bridge/runtime.ts
 const { setRuntime: _setRuntime, clearRuntime: resetQQBotRuntimeForTest, getRuntime: getQQBotRuntime } = createPluginRuntimeStore({

package/dist/runtime-api.js

@@ -1,2 +1,2 @@
-import { r as setQQBotRuntime, t as getQQBotRuntime } from "./runtime-B4HWCOa-.js";
+import { r as setQQBotRuntime, t as getQQBotRuntime } from "./runtime-DodcT_fQ.js";
 export { getQQBotRuntime, setQQBotRuntime };

package/dist/{sender-BfVLJJYp.js → sender-CjDuU-uz.js}

@@ -1,5 +1,6 @@
 import { c as getPlatformAdapter, i as normalizeOptionalString, s as sanitizeFileName } from "./string-normalize-R_0cKO7Q.js";
-import { a as formatErrorMessage, n as debugLog, r as debugWarn, t as debugError } from "./log-SDfMMBWe.js";
+import { a as formatErrorMessage, n as debugLog, r as debugWarn, t as debugError } from "./log-DEtcoDWe.js";
+import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import * as fs$1 from "node:fs";
 import os from "node:os";
 import { readProviderTextResponse, readResponseTextLimited } from "openclaw/plugin-sdk/provider-http";
@@ -10,8 +11,8 @@ import { sleep } from "openclaw/plugin-sdk/runtime-env";
 import { FsSafeError, openLocalFileSafely, readRegularFile, statRegularFileSync } from "openclaw/plugin-sdk/security-runtime";
 import * as path$1 from "node:path";
 import { mimeTypeFromFilePath } from "openclaw/plugin-sdk/media-mime";
+import { asDateTimestampMs, formatByteSize, isFutureDateTimestampMs, parseStrictPositiveInteger, resolveExpiresAtMsFromDurationSeconds, resolveTimestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
 import { readResponseWithLimit } from "openclaw/plugin-sdk/response-limit-runtime";
-import { asDateTimestampMs, isFutureDateTimestampMs, parseStrictPositiveInteger, resolveExpiresAtMsFromDurationSeconds, resolveTimestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -176,7 +177,7 @@ var ApiClient = class {
 					throw new ApiError(`API Error [${path}]: ${error.message ?? rawBody}`, res.status, path, bizCode, error.message);
 				} catch (parseErr) {
 					if (parseErr instanceof ApiError) throw parseErr;
-					throw new ApiError(`API Error [${path}] HTTP ${res.status}: ${rawBody.slice(0, 200)}`, res.status, path);
+					throw new ApiError(`API Error [${path}] HTTP ${res.status}: ${truncateUtf16Safe(rawBody, 200)}`, res.status, path);
 				}
 			}
 			if (isHtmlResponse) throw new ApiError(`QQ 服务端返回了非 JSON 响应（${path}），可能是临时故障，请稍后重试`, res.status, path);
@@ -287,16 +288,19 @@ async function fileExistsAsync(filePath) {
 }
 /** Format a byte count into a human-readable size string. */
 function formatFileSize(bytes) {
-	if (bytes < 1024) return `${bytes}B`;
-	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
-	return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+	return formatByteSize(bytes, {
+		style: "legacy-binary",
+		maxUnit: "mega",
+		separator: "",
+		fractionDigits: (_value, unit) => unit === "byte" ? null : 1
+	});
 }
 /** Infer a MIME type from the file extension. */
 function getMimeType(filePath) {
 	return mimeTypeFromFilePath(filePath) ?? "application/octet-stream";
 }
 /** Extensions accepted as image uploads by the QQ Bot media pipeline. */
-const IMAGE_EXTENSIONS = new Set([
+const IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
 	".jpg",
 	".jpeg",
 	".png",
@@ -495,7 +499,7 @@ async function withRetry(fn, policy, persistentPolicy, logger) {
 		if (policy.shouldRetry?.(lastError, attempt) === false) throw lastError;
 		if (attempt < policy.maxRetries) {
 			const delay = policy.backoff === "exponential" ? policy.baseDelayMs * 2 ** attempt : policy.baseDelayMs;
-			logger?.debug?.(`[qqbot:retry] Attempt ${attempt + 1} failed, retrying in ${delay}ms: ${lastError.message.slice(0, 100)}`);
+			logger?.debug?.(`[qqbot:retry] Attempt ${attempt + 1} failed, retrying in ${delay}ms: ${truncateUtf16Safe(lastError.message, 100)}`);
 			await sleep(delay);
 		}
 	}
@@ -571,7 +575,7 @@ function buildPartFinishPersistentPolicy(retryTimeoutMs, retryableCodes = PART_F
 	};
 }
 /** Business error codes that trigger persistent part-finish retry. */
-const PART_FINISH_RETRYABLE_CODES = new Set([40093001]);
+const PART_FINISH_RETRYABLE_CODES = /* @__PURE__ */ new Set([40093001]);
 /** upload_prepare error code indicating daily limit exceeded. */
 const UPLOAD_PREPARE_FALLBACK_CODE = 40093002;
 //#endregion
@@ -938,8 +942,8 @@ async function putToPresignedUrl(presignedUrl, data, partIndex, totalParts, logg
 				const etag = response.headers.get("ETag") ?? "-";
 				if (!response.ok) {
 					const body = await readResponseTextLimited(response, PART_UPLOAD_ERROR_BODY_LIMIT_BYTES).catch(() => "");
-					logger?.error?.(`${prefix} PUT part ${partIndex}/${totalParts}: HTTP ${response.status} ${response.statusText} (${elapsed}ms, requestId=${requestId}) body=${body.slice(0, 160)}`);
-					throw new Error(`COS PUT failed: ${response.status} ${response.statusText} - ${body.slice(0, 120)}`);
+					logger?.error?.(`${prefix} PUT part ${partIndex}/${totalParts}: HTTP ${response.status} ${response.statusText} (${elapsed}ms, requestId=${requestId}) body=${truncateUtf16Safe(body, 160)}`);
+					throw new Error(`COS PUT failed: ${response.status} ${response.statusText} - ${truncateUtf16Safe(body, 120)}`);
 				}
 				logger?.debug?.(`${prefix} PUT part ${partIndex}/${totalParts} OK (${elapsed}ms ETag=${etag} requestId=${requestId})`);
 				return;
@@ -951,7 +955,7 @@ async function putToPresignedUrl(presignedUrl, data, partIndex, totalParts, logg
 			if (lastError.name === "AbortError") lastError = /* @__PURE__ */ new Error(`Part ${partIndex}/${totalParts} upload timeout after ${PART_UPLOAD_TIMEOUT_MS}ms`);
 			if (attempt < PART_UPLOAD_MAX_RETRIES) {
 				const delay = 1e3 * 2 ** attempt;
-				(logger?.warn ?? logger?.error)?.(`${prefix} PUT part ${partIndex}/${totalParts} attempt ${attempt + 1} failed (${lastError.message.slice(0, 120)}), retrying in ${delay}ms`);
+				(logger?.warn ?? logger?.error)?.(`${prefix} PUT part ${partIndex}/${totalParts} attempt ${attempt + 1} failed (${truncateUtf16Safe(lastError.message, 120)}), retrying in ${delay}ms`);
 				await sleep(delay);
 			}
 		} finally {
@@ -1812,7 +1816,7 @@ async function withTokenRetry(creds, sendFn, log, _accountId) {
 		}
 		const errMsg = formatErrorMessage(err);
 		if (errMsg.includes("401") || errMsg.includes("token") || errMsg.includes("access_token")) {
-			log?.warn?.(`Token retry triggered by string heuristic (err is not ApiError). Consider propagating ApiError end-to-end. msg=${errMsg.slice(0, 120)}`);
+			log?.warn?.(`Token retry triggered by string heuristic (err is not ApiError). Consider propagating ApiError end-to-end. msg=${truncateUtf16Safe(errMsg, 120)}`);
 			clearTokenCache(creds.appId);
 			return await sendFn(await getAccessToken(creds.appId, creds.clientSecret));
 		}

package/dist/{tools-C8kTMXKc.js → tools-UJJ-tLHP.js}

@@ -1,11 +1,12 @@
 import { a as resolveQQBotAccount, r as listQQBotAccountIds } from "./config-C1qZbh0K.js";
-import { a as formatErrorMessage, n as debugLog, t as debugError } from "./log-SDfMMBWe.js";
+import { a as formatErrorMessage, n as debugLog, t as debugError } from "./log-DEtcoDWe.js";
 import { t as getRequestContext } from "./request-context-Bm7PTBD1.js";
+import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import { readProviderTextResponse, readResponseTextLimited } from "openclaw/plugin-sdk/provider-http";
 import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime";
 import { resolveExpiresAtMsFromDurationMs } from "openclaw/plugin-sdk/number-runtime";
+import { jsonResult } from "openclaw/plugin-sdk/tool-results";
 import { callGatewayTool } from "openclaw/plugin-sdk/agent-harness-runtime";
-import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 //#region extensions/qqbot/src/engine/tools/channel-api.ts
 /**
 * QQ Channel API proxy tool core logic.
@@ -118,15 +119,6 @@ function validateDeleteConfirmation(params) {
 	if (isBulkAnnouncementDeletePath(params.path) && !params.bulkConfirmed) return "Deleting all announcements requires bulkConfirmed=true after a separate bulk-delete confirmation.";
 	return null;
 }
-function json$1(data) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify(data, null, 2)
-		}],
-		details: data
-	};
-}
 /**
 * Execute a channel API proxy request.
 * 执行频道 API 代理请求。
@@ -136,8 +128,8 @@ function json$1(data) {
 * response formatting suitable for AI tool output.
 */
 async function executeChannelApi(params, options) {
-	if (!params.method) return json$1({ error: "method is required" });
-	if (!params.path) return json$1({ error: "path is required" });
+	if (!params.method) return jsonResult({ error: "method is required" });
+	if (!params.path) return jsonResult({ error: "path is required" });
 	const method = params.method.toUpperCase();
 	if (![
 		"GET",
@@ -145,14 +137,14 @@ async function executeChannelApi(params, options) {
 		"PUT",
 		"PATCH",
 		"DELETE"
-	].includes(method)) return json$1({ error: `Unsupported HTTP method: ${method}. Allowed values: GET, POST, PUT, PATCH, DELETE` });
+	].includes(method)) return jsonResult({ error: `Unsupported HTTP method: ${method}. Allowed values: GET, POST, PUT, PATCH, DELETE` });
 	const pathError = validatePath(params.path);
-	if (pathError) return json$1({ error: pathError });
+	if (pathError) return jsonResult({ error: pathError });
 	const confirmationError = validateDeleteConfirmation({
 		...params,
 		method
 	});
-	if (confirmationError) return json$1({
+	if (confirmationError) return jsonResult({
 		error: confirmationError,
 		path: params.path
 	});
@@ -191,13 +183,13 @@ async function executeChannelApi(params, options) {
 			clearTimeout(timeoutId);
 			if (err instanceof Error && err.name === "AbortError") {
 				debugError(`[qqbot-channel-api] <<< Request timeout after ${DEFAULT_TIMEOUT_MS}ms`);
-				return json$1({
+				return jsonResult({
 					error: `Request timed out after ${DEFAULT_TIMEOUT_MS}ms`,
 					path: params.path
 				});
 			}
 			debugError("[qqbot-channel-api] <<< Network error:", err);
-			return json$1({
+			return jsonResult({
 				error: `Network error: ${formatErrorMessage(err)}`,
 				path: params.path
 			});
@@ -208,12 +200,12 @@ async function executeChannelApi(params, options) {
 			debugLog(`[qqbot-channel-api] <<< Status: ${res.status} ${res.statusText}`);
 			const rawBody = res.ok ? await readProviderTextResponse(res, "QQ channel API response") : await readResponseTextLimited(res, CHANNEL_API_ERROR_BODY_LIMIT_BYTES);
 			if (!rawBody || rawBody.trim() === "") {
-				if (res.ok) return json$1({
+				if (res.ok) return jsonResult({
 					success: true,
 					status: res.status,
 					path: params.path
 				});
-				return json$1({
+				return jsonResult({
 					error: `API returned ${res.status} ${res.statusText}`,
 					status: res.status,
 					path: params.path
@@ -228,14 +220,14 @@ async function executeChannelApi(params, options) {
 			if (!res.ok) {
 				const errMsg = typeof parsed === "object" && parsed && "message" in parsed ? String(parsed.message) : `${res.status} ${res.statusText}`;
 				debugError(`[qqbot-channel-api] Error [${method} ${params.path}]: ${errMsg}`);
-				return json$1({
+				return jsonResult({
 					error: errMsg,
 					status: res.status,
 					path: params.path,
 					details: parsed
 				});
 			}
-			return json$1({
+			return jsonResult({
 				success: true,
 				status: res.status,
 				path: params.path,
@@ -245,7 +237,7 @@ async function executeChannelApi(params, options) {
 			await release?.();
 		}
 	} catch (err) {
-		return json$1({
+		return jsonResult({
 			error: formatErrorMessage(err),
 			path: params.path
 		});
@@ -274,7 +266,7 @@ function registerChannelTool(api) {
 		description: "Authenticated HTTP proxy for QQ Open Platform channel APIs. Use write and delete endpoints only after explicit user intent; DELETE requires confirmed=true, and bulk deletes require bulkConfirmed=true after confirming the exact target. Common endpoints: list guilds GET /users/@me/guilds | list channels GET /guilds/{guild_id}/channels | get channel GET /channels/{channel_id} | create channel POST /guilds/{guild_id}/channels | list members GET /guilds/{guild_id}/members?after=0&limit=100 | get member GET /guilds/{guild_id}/members/{user_id} | list threads GET /channels/{channel_id}/threads | create thread PUT /channels/{channel_id}/threads | create announce POST /guilds/{guild_id}/announces | create schedule POST /channels/{channel_id}/schedules. See the qqbot-channel skill for full endpoint details.",
 		parameters: ChannelApiSchema,
 		async execute(_toolCallId, params) {
-			const { getAccessToken } = await import("./sender-BfVLJJYp.js").then((n) => n._);
+			const { getAccessToken } = await import("./sender-CjDuU-uz.js").then((n) => n._);
 			return executeChannelApi(params, { accessToken: await getAccessToken(account.appId, account.clientSecret) });
 		}
 	}, { name: "qqbot_channel_api" });
@@ -451,15 +443,6 @@ function formatDelay(ms) {
 	if (minutes === 0) return `${hours}h`;
 	return `${hours}h${minutes}m`;
 }
-function json(data) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify(data, null, 2)
-		}],
-		details: data
-	};
-}
 function formatSchedulerError(error) {
 	return error instanceof Error ? error.message : String(error);
 }
@@ -526,17 +509,17 @@ function prepareRemindCronAction(params, ctx = {}) {
 }
 async function executeScheduledRemind(params, ctx, scheduler) {
 	const plan = prepareRemindCronAction(params, ctx);
-	if (!plan.ok) return json({ error: plan.error });
+	if (!plan.ok) return jsonResult({ error: plan.error });
 	try {
 		const cronResult = await scheduler(plan.cronAction);
-		return json({
+		return jsonResult({
 			ok: true,
 			action: plan.action,
 			summary: plan.summary,
 			cronResult
 		});
 	} catch (error) {
-		return json({
+		return jsonResult({
 			error: `Failed to run Gateway cron action: ${formatSchedulerError(error)}`,
 			action: plan.action
 		});

package/dist/tools-api.js

@@ -1,2 +1,2 @@
-import { t as registerQQBotTools } from "./tools-C8kTMXKc.js";
+import { t as registerQQBotTools } from "./tools-UJJ-tLHP.js";
 export { registerQQBotTools };

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@openclaw/qqbot",
-  "version": "2026.7.1-beta.2",
+  "version": "2026.7.1-beta.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/qqbot",
-      "version": "2026.7.1-beta.2",
+      "version": "2026.7.1-beta.4",
       "dependencies": {
         "@tencent-connect/qqbot-connector": "1.1.0",
         "mpg123-decoder": "1.0.3",
@@ -15,7 +15,7 @@
         "zod": "4.4.3"
       },
       "peerDependencies": {
-        "openclaw": ">=2026.7.1-beta.2"
+        "openclaw": ">=2026.7.1-beta.4"
       },
       "peerDependenciesMeta": {
         "openclaw": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/qqbot",
-  "version": "2026.7.1-beta.2",
+  "version": "2026.7.1-beta.4",
   "private": false,
   "description": "OpenClaw QQ Bot channel plugin for group and direct-message workflows.",
   "repository": {
@@ -16,7 +16,7 @@
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.7.1-beta.2"
+    "openclaw": ">=2026.7.1-beta.4"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -45,10 +45,10 @@
       "minHostVersion": ">=2026.4.10"
     },
     "compat": {
-      "pluginApi": ">=2026.7.1-beta.2"
+      "pluginApi": ">=2026.7.1-beta.4"
     },
     "build": {
-      "openclawVersion": "2026.7.1-beta.2"
+      "openclawVersion": "2026.7.1-beta.4"
     },
     "release": {
       "publishToClawHub": true,