@openclaw/qqbot 2026.5.28 → 2026.5.31-beta.1

package/dist/api.js

@@ -1,9 +1,10 @@
-import { C as getMessageReplyStats, D as setOutboundAudioPort, E as OUTBOUND_ERROR_CODES, S as getMessageReplyConfig, T as DEFAULT_MEDIA_SEND_ERROR, _ as sendVideoMsg, a as sendText, b as MESSAGE_REPLY_LIMIT, f as buildMediaTarget, g as sendPhoto, h as sendDocument, i as sendProactiveMessage, m as resolveOutboundMediaPath, n as sendCronMessage, p as parseTarget, r as sendMedia, v as sendVoice, w as recordMessageReply, x as checkMessageReplyLimit, y as resolveUserFacingMediaError } from "./outbound-Ba5ryGDm.js";
-import { c as listQQBotAccountIds, l as resolveDefaultQQBotAccountId, o as DEFAULT_ACCOUNT_ID, s as applyQQBotAccountConfig, u as resolveQQBotAccount } from "./config-schema-iX2iJzKm.js";
-import { t as qqbotPlugin } from "./channel-8Efx0wKu.js";
-import { C as debugError, l as getAccessToken, w as debugLog, z as formatErrorMessage } from "./runtime-DWfbz21q.js";
-import { t as qqbotSetupPlugin } from "./channel.setup-BxGpVkdx.js";
-import { r as getFrameworkCommands, t as getRequestContext } from "./request-context-BCsRtyph.js";
+import { C as getMessageReplyStats, D as setOutboundAudioPort, E as OUTBOUND_ERROR_CODES, S as getMessageReplyConfig, T as DEFAULT_MEDIA_SEND_ERROR, _ as sendVideoMsg, a as sendText, b as MESSAGE_REPLY_LIMIT, f as buildMediaTarget, g as sendPhoto, h as sendDocument, i as sendProactiveMessage, m as resolveOutboundMediaPath, n as sendCronMessage, p as parseTarget, r as sendMedia, v as sendVoice, w as recordMessageReply, x as checkMessageReplyLimit, y as resolveUserFacingMediaError } from "./outbound-CgW0-dMd.js";
+import { c as listQQBotAccountIds, l as resolveDefaultQQBotAccountId, o as DEFAULT_ACCOUNT_ID, s as applyQQBotAccountConfig, u as resolveQQBotAccount } from "./config-schema-Bc-ArbIT.js";
+import { t as qqbotPlugin } from "./channel-DsUMS0Az.js";
+import { C as debugError, l as getAccessToken, w as debugLog, z as formatErrorMessage } from "./runtime-DDu_1bny.js";
+import { t as qqbotSetupPlugin } from "./channel.setup-_OAH-xmU.js";
+import { r as getFrameworkCommands, t as getRequestContext } from "./request-context-DNbuU0Co.js";
+import { resolveExpiresAtMsFromDurationMs } from "openclaw/plugin-sdk/number-runtime";
 import { callGatewayTool } from "openclaw/plugin-sdk/agent-harness-runtime";
 //#region extensions/qqbot/src/engine/tools/channel-api.ts
 /**
@@ -320,8 +321,7 @@ function buildReminderPrompt(content) {
 	return `You are a warm reminder assistant. Please remind the user about: ${content}. Requirements: (1) do not reply with HEARTBEAT_OK (2) do not explain who you are (3) output a direct and caring reminder message (4) you may add a short encouraging line (5) keep it within 2-3 sentences (6) use a small amount of emoji.`;
 }
 /** Build cron job params for a one-shot delayed reminder. */
-function buildOnceJob(params, delayMs, to, accountId) {
-	const atMs = Date.now() + delayMs;
+function buildOnceJob(params, atMs, to, accountId) {
 	const content = params.content;
 	return {
 		action: "add",
@@ -448,10 +448,15 @@ function prepareRemindCronAction(params, ctx = {}) {
 		ok: false,
 		error: "Reminder delay must be at least 30 seconds"
 	};
+	const atMs = resolveExpiresAtMsFromDurationMs(delayMs);
+	if (atMs === void 0) return {
+		ok: false,
+		error: "Reminder time is outside the supported Date range"
+	};
 	return {
 		ok: true,
 		action: "add",
-		cronAction: buildOnceJob(params, delayMs, resolvedTo, resolvedAccountId),
+		cronAction: buildOnceJob(params, atMs, resolvedTo, resolvedAccountId),
 		summary: `⏰ Reminder in ${formatDelay(delayMs)}: "${params.content}"`
 	};
 }

package/dist/{channel-8Efx0wKu.js → channel-DsUMS0Az.js}

@@ -1,6 +1,6 @@
 import { c as getPlatformAdapter, t as asOptionalObjectRecord } from "./string-normalize-R_0cKO7Q.js";
-import { a as qqbotSetupAdapterShared, c as listQQBotAccountIds, i as qqbotMeta, m as getBridgeLogger, n as qqbotSetupWizard, o as DEFAULT_ACCOUNT_ID$1, p as ensurePlatformAdapter, r as qqbotConfigAdapter, s as applyQQBotAccountConfig, t as qqbotChannelConfigSchema, u as resolveQQBotAccount } from "./config-schema-iX2iJzKm.js";
-import { T as debugWarn, t as getQQBotRuntime, w as debugLog, z as formatErrorMessage } from "./runtime-DWfbz21q.js";
+import { a as qqbotSetupAdapterShared, c as listQQBotAccountIds, i as qqbotMeta, m as getBridgeLogger, n as qqbotSetupWizard, o as DEFAULT_ACCOUNT_ID$1, p as ensurePlatformAdapter, r as qqbotConfigAdapter, s as applyQQBotAccountConfig, t as qqbotChannelConfigSchema, u as resolveQQBotAccount } from "./config-schema-Bc-ArbIT.js";
+import { T as debugWarn, t as getQQBotRuntime, w as debugLog, z as formatErrorMessage } from "./runtime-DDu_1bny.js";
 import { getExecApprovalReplyMetadata } from "openclaw/plugin-sdk/approval-runtime";
 import { createMessageReceiptFromOutboundResults, defineChannelMessageAdapter } from "openclaw/plugin-sdk/channel-outbound";
 import { createChannelApprovalCapability } from "openclaw/plugin-sdk/approval-delivery-runtime";
@@ -374,7 +374,7 @@ function createQQBotApprovalCapability() {
 			},
 			load: async () => {
 				ensurePlatformAdapter();
-				return (await import("./handler-runtime-C-5nL3Cl.js")).qqbotApprovalNativeRuntime;
+				return (await import("./handler-runtime-TwO5-5cH.js")).qqbotApprovalNativeRuntime;
 			}
 		})
 	});
@@ -813,7 +813,7 @@ function clearAccountCredentials(cfg, accountId) {
 * @throws {Error} When the target format is invalid.
 */
 function parseTarget(to) {
-	let id = to.replace(/^qqbot:/i, "");
+	const id = to.replace(/^qqbot:/i, "");
 	if (id.startsWith("c2c:")) {
 		const userId = id.slice(4);
 		if (!userId) throw new Error(`Invalid c2c target format: ${to} - missing user ID`);
@@ -868,9 +868,14 @@ function looksLikeQQBotTarget(id) {
 //#region extensions/qqbot/src/channel.ts
 let gatewayModulePromise;
 function loadGatewayModule() {
-	gatewayModulePromise ??= import("./gateway-CuTCxSqs.js");
+	gatewayModulePromise ??= import("./gateway-Bx-wZKqQ.js");
 	return gatewayModulePromise;
 }
+let outboundMessagingModulePromise;
+function loadOutboundMessagingModule() {
+	outboundMessagingModulePromise ??= import("./outbound-CgW0-dMd.js").then((n) => n.t);
+	return outboundMessagingModulePromise;
+}
 function createQQBotSendReceipt(params) {
 	const messageId = params.messageId?.trim();
 	return createMessageReceiptFromOutboundResults({
@@ -886,7 +891,7 @@ function createQQBotSendReceipt(params) {
 async function sendQQBotText(params) {
 	await loadGatewayModule();
 	const account = resolveQQBotAccount(params.cfg, params.accountId);
-	const { sendText } = await import("./outbound-Ba5ryGDm.js").then((n) => n.t);
+	const { sendText } = await loadOutboundMessagingModule();
 	const result = await sendText({
 		to: params.to,
 		text: params.text,
@@ -908,7 +913,7 @@ async function sendQQBotText(params) {
 async function sendQQBotMedia(params) {
 	await loadGatewayModule();
 	const account = resolveQQBotAccount(params.cfg, params.accountId);
-	const { sendMedia } = await import("./outbound-Ba5ryGDm.js").then((n) => n.t);
+	const { sendMedia } = await loadOutboundMessagingModule();
 	const result = await sendMedia({
 		to: params.to,
 		text: params.text ?? "",

package/dist/channel-plugin-api.js

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

package/dist/{channel.setup-BxGpVkdx.js → channel.setup-_OAH-xmU.js}

@@ -1,4 +1,4 @@
-import { a as qqbotSetupAdapterShared, i as qqbotMeta, n as qqbotSetupWizard, r as qqbotConfigAdapter, t as qqbotChannelConfigSchema } from "./config-schema-iX2iJzKm.js";
+import { a as qqbotSetupAdapterShared, i as qqbotMeta, n as qqbotSetupWizard, r as qqbotConfigAdapter, t as qqbotChannelConfigSchema } from "./config-schema-Bc-ArbIT.js";
 //#region extensions/qqbot/src/channel.setup.ts
 /**
 * Setup-only QQBot plugin — lightweight subset used during `openclaw onboard`

package/dist/{config-schema-iX2iJzKm.js → config-schema-Bc-ArbIT.js}

@@ -48,6 +48,11 @@ function getBridgeLogger() {
 * statically at the top level so they work reliably in both production and
 * vitest (which resolves bare specifiers via `resolve.alias`, not Node CJS).
 */
+let mediaRuntimeModulePromise = null;
+const loadMediaRuntimeModule = async () => {
+	mediaRuntimeModulePromise ??= import("openclaw/plugin-sdk/media-runtime");
+	return await mediaRuntimeModulePromise;
+};
 function createBuiltinAdapter() {
 	return {
 		async validateRemoteUrl(_url, _options) {},
@@ -55,7 +60,7 @@ function createBuiltinAdapter() {
 			if (typeof value === "string") return value || void 0;
 		},
 		async downloadFile(url, destDir, filename) {
-			const { readRemoteMediaBuffer } = await import("openclaw/plugin-sdk/media-runtime");
+			const { readRemoteMediaBuffer } = await loadMediaRuntimeModule();
 			const result = await readRemoteMediaBuffer({
 				url,
 				filePathHint: filename
@@ -68,7 +73,7 @@ function createBuiltinAdapter() {
 			return destPath;
 		},
 		async fetchMedia(options) {
-			const { readRemoteMediaBuffer } = await import("openclaw/plugin-sdk/media-runtime");
+			const { readRemoteMediaBuffer } = await loadMediaRuntimeModule();
 			const result = await readRemoteMediaBuffer({
 				url: options.url,
 				filePathHint: options.filePathHint,

package/dist/{gateway-CuTCxSqs.js → gateway-Bx-wZKqQ.js}

@@ -1,9 +1,9 @@
-import { D as setOutboundAudioPort, T as DEFAULT_MEDIA_SEND_ERROR, _ as sendVideoMsg, c as isCronReminderPayload, d as normalizeMediaTags, g as sendPhoto, h as sendDocument, l as isMediaPayload, o as decodeMediaPath, r as sendMedia, s as encodePayloadForCron, u as parseQQBotPayload, v as sendVoice, y as resolveUserFacingMediaError } from "./outbound-Ba5ryGDm.js";
+import { D as setOutboundAudioPort, T as DEFAULT_MEDIA_SEND_ERROR, _ as sendVideoMsg, c as isCronReminderPayload, d as normalizeMediaTags, g as sendPhoto, h as sendDocument, l as isMediaPayload, o as decodeMediaPath, r as sendMedia, s as encodePayloadForCron, u as parseQQBotPayload, v as sendVoice, y as resolveUserFacingMediaError } from "./outbound-CgW0-dMd.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 { f as resolveAccountBase, h as setBridgeLogger, p as ensurePlatformAdapter } from "./config-schema-iX2iJzKm.js";
-import { C as parseApprovalButtonData, a as getQQBotDataDir, d as isWindows, f as normalizePath, h as authorizeQQBotApprovalAction, i as getHomeDir, l as getTempDir, m as toGatewayAccount, o as getQQBotDataPath, p as resolveQQBotPayloadLocalFilePath, r as checkSilkWasmAvailable, s as getQQBotMediaDir, u as isLocalPath } from "./channel-8Efx0wKu.js";
-import { B as StreamContentType, C as debugError, D as getNextMsgSeq, F as getImageMimeType, H as StreamInputState, I as getMaxUploadSize, N as formatFileSize, R as formatDuration, S as withTokenRetry, T as debugWarn, V as StreamInputMode, _ as sendInputNotify, a as acknowledgeInteraction, b as startBackgroundTokenRefresh, c as createRawInputNotifyFn, d as getMessageApi, f as getPluginUserAgent, g as registerAccount, h as onMessageSent, i as accountToCreds, j as downloadFile, k as openLocalFile, l as getAccessToken, m as initSender, n as getQQBotRuntimeForEngine, o as buildDeliveryTarget, p as initApiConfig, s as clearTokenCache, t as getQQBotRuntime, u as getGatewayUrl, v as sendMedia$1, w as debugLog, x as stopBackgroundTokenRefresh, y as sendText, z as formatErrorMessage } from "./runtime-DWfbz21q.js";
-import { a as getPluginVersion, i as getFrameworkVersion, n as runWithRequestContext, o as initCommands, s as matchSlashCommand } from "./request-context-BCsRtyph.js";
+import { f as resolveAccountBase, h as setBridgeLogger, p as ensurePlatformAdapter } from "./config-schema-Bc-ArbIT.js";
+import { C as parseApprovalButtonData, a as getQQBotDataDir, d as isWindows, f as normalizePath, h as authorizeQQBotApprovalAction, i as getHomeDir, l as getTempDir, m as toGatewayAccount, o as getQQBotDataPath, p as resolveQQBotPayloadLocalFilePath, r as checkSilkWasmAvailable, s as getQQBotMediaDir, u as isLocalPath } from "./channel-DsUMS0Az.js";
+import { B as StreamContentType, C as debugError, D as getNextMsgSeq, F as getImageMimeType, H as StreamInputState, I as getMaxUploadSize, N as formatFileSize, R as formatDuration, S as withTokenRetry, T as debugWarn, V as StreamInputMode, _ as sendInputNotify, a as acknowledgeInteraction, b as startBackgroundTokenRefresh, c as createRawInputNotifyFn, d as getMessageApi, f as getPluginUserAgent, g as registerAccount, h as onMessageSent, i as accountToCreds, j as downloadFile, k as openLocalFile, l as getAccessToken, m as initSender, n as getQQBotRuntimeForEngine, o as buildDeliveryTarget, p as initApiConfig, s as clearTokenCache, t as getQQBotRuntime, u as getGatewayUrl, v as sendMedia$1, w as debugLog, x as stopBackgroundTokenRefresh, y as sendText, z as formatErrorMessage } from "./runtime-DDu_1bny.js";
+import { a as getPluginVersion, i as getFrameworkVersion, n as runWithRequestContext, o as initCommands, s as matchSlashCommand } from "./request-context-DNbuU0Co.js";
 import { asBoolean, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { isImplicitSameChatApprovalAuthorization } from "openclaw/plugin-sdk/approval-auth-runtime";
 import * as fs$1 from "node:fs";
@@ -84,7 +84,7 @@ const TRANSCRIPT_SOURCE_LABELS = {
 * Shared grammar (both modes):
 *
 * ```
-* attachment_with_source  := "MEDIA:" SOURCE [voice_suffix]
+* attachment_with_source  := "[" TYPE_LABEL ": " SOURCE "]" [voice_suffix]
 * voice_suffix            := ' (transcript: "' TEXT '")' [source_suffix]
 * attachment_no_source    := "[" TYPE_LABEL [": " FILENAME] [voice_suffix_bare] "]" [source_suffix_bare]
 * voice_suffix_bare       := ' (transcript: "' TEXT '")'
@@ -116,7 +116,7 @@ function formatAttachmentTags(attachments) {
 * Render a single attachment.
 *
 * The function is split into two orthogonal concerns:
-*   - `renderBody`: the shared "MEDIA:{source}…" or "[type…]" string.
+*   - `renderBody`: the shared "[type: source]…" or "[type…]" string.
 *   - `renderSourceSuffix`: ref-mode-only `" [source: …]"` tail.
 *
 * Both consumers produce the same body; only the suffix differs.
@@ -128,8 +128,9 @@ function renderOne(att, mode) {
 function renderBody(att) {
 	const source = att.localPath || att.url;
 	const voiceSuffix = att.type === "voice" && att.transcript ? ` (transcript: "${att.transcript}")` : "";
-	if (source) return `MEDIA:${source}${voiceSuffix}`;
-	return `[${labelForType(att.type)}${att.filename ? `: ${att.filename}` : ""}${voiceSuffix}]`;
+	const label = labelForType(att.type);
+	if (source) return `[${label}: ${source}]${voiceSuffix}`;
+	return `[${label}${att.filename ? `: ${att.filename}` : ""}${voiceSuffix}]`;
 }
 /**
 * Ref-mode-only tail that records where a voice transcript came from.
@@ -234,7 +235,7 @@ function appendLine(line) {
 	}
 }
 function shouldCompact() {
-	return !!cache && totalLinesOnDisk > cache.size * COMPACT_THRESHOLD_RATIO && totalLinesOnDisk > 1e3;
+	return cache !== null && totalLinesOnDisk > cache.size * COMPACT_THRESHOLD_RATIO && totalLinesOnDisk > 1e3;
 }
 function compactFile() {
 	if (!cache) return;
@@ -1976,7 +1977,8 @@ async function processAttachments(attachments, ctx) {
 		attachmentLocalPaths
 	};
 }
-async function processVoiceAttachment(localPath, audioPath, att, asrReferText, cfg, downloadDir, audioConvert, log) {
+async function processVoiceAttachment(localPath, audioPathInput, att, asrReferText, cfg, downloadDir, audioConvert, log) {
+	let audioPath = audioPathInput;
 	const wavUrl = att.voice_wav_url ? att.voice_wav_url.startsWith("//") ? `https:${att.voice_wav_url}` : att.voice_wav_url : "";
 	const attUrl = att.url?.startsWith("//") ? `https:${att.url}` : att.url;
 	const meta = {
@@ -3498,13 +3500,14 @@ async function autoMediaBatch(params) {
 	}
 }
 async function sendTextChunkToTarget(params) {
-	const { account, event, text, consumeQuoteRef, allowDm } = params;
+	const { account, event, text, consumeQuoteRef, allowDm, forcePlainText } = params;
 	const ref = consumeQuoteRef();
 	const target = buildDeliveryTarget(event);
 	if (target.type === "dm" && !allowDm) return;
 	return await sendText(target, text, accountToCreds(account), {
 		msgId: event.messageId,
-		messageReference: ref
+		messageReference: ref,
+		forcePlainText
 	});
 }
 async function sendTextChunks(text, event, actx, sendWithRetry, consumeQuoteRef, deps) {
@@ -3521,8 +3524,25 @@ async function sendTextChunks(text, event, actx, sendWithRetry, consumeQuoteRef,
 		onError: (err) => `Failed to send text chunk: ${formatErrorMessage(err)}`
 	});
 }
+async function sendTextOnlyReply(text, event, actx, sendWithRetry, consumeQuoteRef, deps) {
+	const safeText = filterInternalMarkers(text).trim();
+	if (!safeText) return;
+	const { account, log } = actx;
+	await sendTextChunksWithRetry({
+		account,
+		event,
+		chunks: deps.chunkText(safeText, TEXT_CHUNK_LIMIT),
+		sendWithRetry,
+		consumeQuoteRef,
+		allowDm: true,
+		forcePlainText: true,
+		log,
+		onSuccess: (chunk) => `Sent text-only chunk (${chunk.length}/${safeText.length} chars): ${chunk.slice(0, 50)}...`,
+		onError: (err) => `Failed to send text-only chunk: ${formatErrorMessage(err)}`
+	});
+}
 async function sendTextChunksWithRetry(params) {
-	const { account, event, chunks, sendWithRetry, consumeQuoteRef, allowDm, log } = params;
+	const { account, event, chunks, sendWithRetry, consumeQuoteRef, allowDm, forcePlainText, log } = params;
 	for (const chunk of chunks) try {
 		await sendWithRetry((token) => sendTextChunkToTarget({
 			account,
@@ -3530,7 +3550,8 @@ async function sendTextChunksWithRetry(params) {
 			token,
 			text: chunk,
 			consumeQuoteRef,
-			allowDm
+			allowDm,
+			forcePlainText
 		}));
 		log?.info(params.onSuccess(chunk));
 	} catch (err) {
@@ -4242,7 +4263,7 @@ function fixPathEncoding(mediaPath, log) {
 		const hasNonASCII = /[\u0080-\u00FF]/.test(result);
 		if (!isWinLocal && (hasOctal || hasNonASCII)) {
 			log?.debug?.(`Decoding path with mixed encoding: ${result}`);
-			let decoded = result.replace(/\\([0-7]{1,3})/g, (_, octal) => String.fromCharCode(Number.parseInt(octal, 8)));
+			const decoded = result.replace(/\\([0-7]{1,3})/g, (_, octal) => String.fromCharCode(Number.parseInt(octal, 8)));
 			const bytes = [];
 			for (let i = 0; i < decoded.length; i++) {
 				const code = decoded.charCodeAt(i);
@@ -4310,7 +4331,6 @@ function findFirstClosedMediaTag(text, log) {
 		const textBefore = text.slice(0, match.index);
 		const tagName = match[1].toLowerCase();
 		let mediaPath = match[2]?.trim() ?? "";
-		if (mediaPath.startsWith("MEDIA:")) mediaPath = mediaPath.slice(6);
 		mediaPath = normalizePath(mediaPath);
 		mediaPath = fixPathEncoding(mediaPath, log);
 		return {
@@ -5671,6 +5691,18 @@ function resolveResponseTimeoutMs(cfg) {
 const TOOL_ONLY_TIMEOUT = 6e4;
 const MAX_TOOL_RENEWALS = 3;
 const TOOL_MEDIA_SEND_TIMEOUT = 45e3;
+function shouldDeliverToolProgressImmediately(account, useOfficialC2cStream) {
+	if (useOfficialC2cStream) return true;
+	const streaming = account.config?.streaming;
+	if (streaming === true) return true;
+	return typeof streaming === "object" && streaming !== null && streaming.mode !== "off";
+}
+function immediateToolProgressText(payload) {
+	const text = (payload.text ?? "").trim();
+	if (!text || payload.isError || payload.audioAsVoice) return;
+	if (payload.mediaUrl || payload.mediaUrls?.length) return;
+	return text;
+}
 /**
 * Dispatch the AI reply for the given inbound context.
 *
@@ -5739,6 +5771,24 @@ async function dispatchOutbound(inbound, deps) {
 		}
 		if (toolTexts.length > 0) await sendErrorMessage(toolTexts.slice(-3).join("\n---\n").slice(0, 2e3));
 	};
+	const hasPendingToolFallbackPayload = () => toolTexts.length > 0 || toolMediaUrls.length > 0;
+	const renewToolOnlyFallback = () => {
+		if (toolFallbackSent) return false;
+		if (toolOnlyTimeoutId) {
+			if (toolRenewalCount >= MAX_TOOL_RENEWALS) return false;
+			clearTimeout(toolOnlyTimeoutId);
+			toolRenewalCount++;
+		}
+		toolOnlyTimeoutId = setTimeout(async () => {
+			if (!hasBlockResponse && !toolFallbackSent) {
+				toolFallbackSent = true;
+				try {
+					await sendToolFallback();
+				} catch {}
+			}
+		}, TOOL_ONLY_TIMEOUT);
+		return true;
+	};
 	const responseTimeoutMs = resolveResponseTimeoutMs(cfg);
 	const timeoutPromise = new Promise((_, reject) => {
 		timeoutId = setTimeout(() => {
@@ -5766,6 +5816,7 @@ async function dispatchOutbound(inbound, deps) {
 	});
 	const messagesConfig = runtime.channel.reply.resolveEffectiveMessagesConfig(cfg, inbound.route.agentId);
 	const useOfficialC2cStream = shouldUseOfficialC2cStream(account, event.type === "c2c" ? "c2c" : event.type === "group" ? "group" : "channel");
+	const deliverToolProgressImmediately = shouldDeliverToolProgressImmediately(account, useOfficialC2cStream);
 	let streamingController = null;
 	if (useOfficialC2cStream) streamingController = new StreamingController({
 		account,
@@ -5821,6 +5872,24 @@ async function dispatchOutbound(inbound, deps) {
 							if (info.kind === "tool") {
 								toolDeliverCount++;
 								const toolText = (payload.text ?? "").trim();
+								const textOnlyProgress = immediateToolProgressText(payload);
+								if (!hasBlockResponse && deliverToolProgressImmediately && textOnlyProgress) {
+									if (toolOnlyTimeoutId || hasPendingToolFallbackPayload()) renewToolOnlyFallback();
+									await sendTextOnlyReply(textOnlyProgress, {
+										type: event.type,
+										senderId: event.senderId,
+										messageId: event.messageId,
+										channelId: event.channelId,
+										groupOpenid: event.groupOpenid,
+										msgIdx: event.msgIdx
+									}, {
+										account,
+										qualifiedTarget,
+										log
+									}, sendWithRetry, () => void 0, deliverDeps);
+									recordOutbound();
+									return;
+								}
 								if (toolText) toolTexts.push(toolText);
 								if (payload.mediaUrls?.length) toolMediaUrls.push(...payload.mediaUrls);
 								if (payload.mediaUrl && !toolMediaUrls.includes(payload.mediaUrl)) toolMediaUrls.push(payload.mediaUrl);
@@ -5840,18 +5909,7 @@ async function dispatchOutbound(inbound, deps) {
 									return;
 								}
 								if (toolFallbackSent) return;
-								if (toolOnlyTimeoutId) if (toolRenewalCount < MAX_TOOL_RENEWALS) {
-									clearTimeout(toolOnlyTimeoutId);
-									toolRenewalCount++;
-								} else return;
-								toolOnlyTimeoutId = setTimeout(async () => {
-									if (!hasBlockResponse && !toolFallbackSent) {
-										toolFallbackSent = true;
-										try {
-											await sendToolFallback();
-										} catch {}
-									}
-								}, TOOL_ONLY_TIMEOUT);
+								renewToolOnlyFallback();
 								return;
 							}
 							hasBlockResponse = true;
@@ -6567,7 +6625,7 @@ async function startGateway(ctx) {
 			context: { account: ctx.account },
 			abortSignal: ctx.abortSignal
 		});
-		accountLogger.info(`approval.native context registered (lease=${!!lease})`);
+		accountLogger.info(`approval.native context registered (lease=${Boolean(lease)})`);
 	} else accountLogger.info("No channelRuntime — skipping approval.native registration");
 	return startGateway$1({
 		account: toGatewayAccount(ctx.account),

package/dist/{handler-runtime-C-5nL3Cl.js → handler-runtime-TwO5-5cH.js}

@@ -1,6 +1,6 @@
-import { m as getBridgeLogger, p as ensurePlatformAdapter, u as resolveQQBotAccount } from "./config-schema-iX2iJzKm.js";
-import { S as buildPluginApprovalText, _ as matchesQQBotApprovalAccount, b as buildApprovalKeyboard, g as isQQBotExecApprovalClientEnabled, v as resolveQQBotExecApprovalConfig, w as resolveApprovalTarget, x as buildExecApprovalText, y as shouldHandleQQBotExecApprovalRequest } from "./channel-8Efx0wKu.js";
-import { d as getMessageApi, i as accountToCreds } from "./runtime-DWfbz21q.js";
+import { m as getBridgeLogger, p as ensurePlatformAdapter, u as resolveQQBotAccount } from "./config-schema-Bc-ArbIT.js";
+import { S as buildPluginApprovalText, _ as matchesQQBotApprovalAccount, b as buildApprovalKeyboard, g as isQQBotExecApprovalClientEnabled, v as resolveQQBotExecApprovalConfig, w as resolveApprovalTarget, x as buildExecApprovalText, y as shouldHandleQQBotExecApprovalRequest } from "./channel-DsUMS0Az.js";
+import { d as getMessageApi, i as accountToCreds } from "./runtime-DDu_1bny.js";
 import { resolveApprovalRequestSessionConversation } from "openclaw/plugin-sdk/approval-native-runtime";
 import { createChannelApprovalNativeRuntimeAdapter } from "openclaw/plugin-sdk/approval-handler-runtime";
 //#region extensions/qqbot/src/bridge/approval/handler-runtime.ts

package/dist/{outbound-Ba5ryGDm.js → outbound-CgW0-dMd.js}

@@ -1,6 +1,6 @@
 import { i as normalizeOptionalString, n as normalizeLowercaseStringOrEmpty, s as sanitizeFileName } from "./string-normalize-R_0cKO7Q.js";
-import { a as getQQBotDataDir, f as normalizePath$1, n as parseTarget$1, p as resolveQQBotPayloadLocalFilePath, s as getQQBotMediaDir, u as isLocalPath } from "./channel-8Efx0wKu.js";
-import { A as checkFileSize, C as debugError, E as UploadDailyLimitExceededError, F as getImageMimeType, I as getMaxUploadSize, L as readFileAsync, M as fileExistsAsync, N as formatFileSize, O as UPLOAD_PREPARE_FALLBACK_CODE, P as getFileTypeName, T as debugWarn, i as accountToCreds, j as downloadFile, p as initApiConfig, v as sendMedia$1, w as debugLog, y as sendText$1, z as formatErrorMessage } from "./runtime-DWfbz21q.js";
+import { a as getQQBotDataDir, f as normalizePath$1, n as parseTarget$1, p as resolveQQBotPayloadLocalFilePath, s as getQQBotMediaDir, u as isLocalPath } from "./channel-DsUMS0Az.js";
+import { A as checkFileSize, C as debugError, E as UploadDailyLimitExceededError, F as getImageMimeType, I as getMaxUploadSize, L as readFileAsync, M as fileExistsAsync, N as formatFileSize, O as UPLOAD_PREPARE_FALLBACK_CODE, P as getFileTypeName, T as debugWarn, i as accountToCreds, j as downloadFile, p as initApiConfig, v as sendMedia$1, w as debugLog, y as sendText$1, z as formatErrorMessage } from "./runtime-DDu_1bny.js";
 import { pathExistsSync, resolveLocalPathFromRootsSync } from "openclaw/plugin-sdk/security-runtime";
 import path from "node:path";
 import { getFileExtension } from "openclaw/plugin-sdk/media-mime";
@@ -997,8 +997,8 @@ function normalizePath(p) {
 	return result;
 }
 /**
-* Decode a media path by stripping `MEDIA:`, expanding `~`, and unescaping
-* octal/UTF-8 byte sequences.
+* Decode a media path by expanding `~` and unescaping octal/UTF-8 byte
+* sequences.
 *
 * @param raw - Raw path string from a media tag.
 * @param log - Optional logger for decode diagnostics.
@@ -1006,7 +1006,6 @@ function normalizePath(p) {
 */
 function decodeMediaPath(raw, log) {
 	let mediaPath = raw;
-	if (mediaPath.startsWith("MEDIA:")) mediaPath = mediaPath.slice(6);
 	mediaPath = normalizePath(mediaPath);
 	mediaPath = mediaPath.replace(/\\\\/g, "\\");
 	const isWinLocal = /^[a-zA-Z]:[\\/]/.test(mediaPath) || mediaPath.startsWith("\\\\");
@@ -1078,10 +1077,24 @@ function isVideoFile$1(filePath, mimeType) {
 var outbound_exports = /* @__PURE__ */ __exportAll({
 	DEFAULT_MEDIA_SEND_ERROR: () => DEFAULT_MEDIA_SEND_ERROR,
 	MESSAGE_REPLY_LIMIT: () => 4,
+	OUTBOUND_ERROR_CODES: () => OUTBOUND_ERROR_CODES,
+	buildMediaTarget: () => buildMediaTarget,
+	checkMessageReplyLimit: () => checkMessageReplyLimit,
+	getMessageReplyConfig: () => getMessageReplyConfig,
+	getMessageReplyStats: () => getMessageReplyStats,
+	parseTarget: () => parseTarget,
+	recordMessageReply: () => recordMessageReply,
+	resolveOutboundMediaPath: () => resolveOutboundMediaPath,
+	resolveUserFacingMediaError: () => resolveUserFacingMediaError,
 	sendCronMessage: () => sendCronMessage,
+	sendDocument: () => sendDocument,
 	sendMedia: () => sendMedia,
+	sendPhoto: () => sendPhoto,
 	sendProactiveMessage: () => sendProactiveMessage,
-	sendText: () => sendText
+	sendText: () => sendText,
+	sendVideoMsg: () => sendVideoMsg,
+	sendVoice: () => sendVoice,
+	setOutboundAudioPort: () => setOutboundAudioPort
 });
 const isImageFile = isImageFile$1;
 const isVideoFile = isVideoFile$1;

package/dist/{request-context-BCsRtyph.js → request-context-DNbuU0Co.js}

@@ -1,5 +1,5 @@
-import { a as getQQBotDataDir, c as getQQBotMediaPath, d as isWindows, i as getHomeDir } from "./channel-8Efx0wKu.js";
-import { w as debugLog } from "./runtime-DWfbz21q.js";
+import { a as getQQBotDataDir, c as getQQBotMediaPath, d as isWindows, i as getHomeDir } from "./channel-DsUMS0Az.js";
+import { w as debugLog } from "./runtime-DDu_1bny.js";
 import { uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import fs from "node:fs";
 import path from "node:path";

package/dist/{runtime-DWfbz21q.js → runtime-DDu_1bny.js}

@@ -9,7 +9,7 @@ import { FsSafeError, openLocalFileSafely, readRegularFile, statRegularFileSync
 import * as path$1 from "node:path";
 import { mimeTypeFromFilePath } from "openclaw/plugin-sdk/media-mime";
 import { readResponseWithLimit } from "openclaw/plugin-sdk/response-limit-runtime";
-import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
+import { asDateTimestampMs, isFutureDateTimestampMs, parseStrictPositiveInteger, resolveExpiresAtMsFromDurationSeconds, resolveTimestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
 //#region extensions/qqbot/src/engine/types.ts
 /**
 * Core API layer public types.
@@ -1173,13 +1173,18 @@ var TokenManager = class {
 				throw new Error("QQBot access_token response was malformed JSON");
 			}
 			if (!data.access_token) throw new Error(`Failed to get access_token: ${JSON.stringify(data)}`);
-			const expiresAt = Date.now() + resolveTokenExpiresInSeconds(data.expires_in) * 1e3;
+			const nowMs = asDateTimestampMs(Date.now());
+			if (nowMs === void 0) {
+				this.logger?.debug?.(`[qqbot:token:${appId}] Not cached: invalid process clock`);
+				return data.access_token;
+			}
+			const expiresAt = resolveExpiresAtMsFromDurationSeconds(resolveTokenExpiresInSeconds(data.expires_in), { nowMs }) ?? nowMs;
 			this.cache.set(appId, {
 				token: data.access_token,
 				expiresAt,
 				appId
 			});
-			this.logger?.debug?.(`[qqbot:token:${appId}] Cached, expires at: ${new Date(expiresAt).toISOString()}`);
+			this.logger?.debug?.(`[qqbot:token:${appId}] Cached, expires at: ${resolveTimestampMsToIsoString(expiresAt)}`);
 			return data.access_token;
 		} finally {
 			await release?.();
@@ -1426,15 +1431,15 @@ var MessageApi = class {
 	async sendMessage(scope, targetId, content, creds, opts) {
 		const token = await this.tokenManager.getAccessToken(creds.appId, creds.clientSecret);
 		const msgSeq = opts?.msgId ? getNextMsgSeq(opts.msgId) : 1;
-		const body = this.buildMessageBody(content, opts?.msgId, msgSeq, opts?.messageReference, opts?.inlineKeyboard);
+		const body = this.buildMessageBody(content, opts?.msgId, msgSeq, opts?.messageReference, opts?.inlineKeyboard, opts?.forcePlainText);
 		const path = messagePath(scope, targetId);
 		return this.sendAndNotify(creds.appId, token, "POST", path, body, { text: content });
 	}
 	/** Send a proactive (no msgId) message to a C2C or Group target. */
-	async sendProactiveMessage(scope, targetId, content, creds) {
+	async sendProactiveMessage(scope, targetId, content, creds, opts) {
 		if (!content?.trim()) throw new Error("Proactive message content must not be empty");
 		const token = await this.tokenManager.getAccessToken(creds.appId, creds.clientSecret);
-		const body = this.buildProactiveBody(content);
+		const body = this.buildProactiveBody(content, opts?.forcePlainText);
 		const path = messagePath(scope, targetId);
 		return this.sendAndNotify(creds.appId, token, "POST", path, body, { text: content });
 	}
@@ -1508,8 +1513,9 @@ var MessageApi = class {
 		}
 		return result;
 	}
-	buildMessageBody(content, msgId, msgSeq, messageReference, inlineKeyboard) {
-		const body = this.markdownSupport ? {
+	buildMessageBody(content, msgId, msgSeq, messageReference, inlineKeyboard, forcePlainText = false) {
+		const useMarkdown = this.markdownSupport && !forcePlainText;
+		const body = useMarkdown ? {
 			markdown: { content },
 			msg_type: 2,
 			msg_seq: msgSeq
@@ -1519,12 +1525,12 @@ var MessageApi = class {
 			msg_seq: msgSeq
 		};
 		if (msgId) body.msg_id = msgId;
-		if (messageReference && !this.markdownSupport) body.message_reference = { message_id: messageReference };
+		if (messageReference && !useMarkdown) body.message_reference = { message_id: messageReference };
 		if (inlineKeyboard) body.keyboard = inlineKeyboard;
 		return body;
 	}
-	buildProactiveBody(content) {
-		return this.markdownSupport ? {
+	buildProactiveBody(content, forcePlainText = false) {
+		return this.markdownSupport && !forcePlainText ? {
 			markdown: { content },
 			msg_type: 2
 		} : {
@@ -1607,7 +1613,7 @@ function getCachedFileInfo(contentHash, scope, targetId, fileType) {
 	const key = buildCacheKey(contentHash, scope, targetId, fileType);
 	const entry = cache.get(key);
 	if (!entry) return null;
-	if (Date.now() >= entry.expiresAt) {
+	if (!isFutureDateTimestampMs(entry.expiresAt)) {
 		cache.delete(key);
 		return null;
 	}
@@ -1618,7 +1624,7 @@ function getCachedFileInfo(contentHash, scope, targetId, fileType) {
 function setCachedFileInfo(contentHash, scope, targetId, fileType, fileInfo, fileUuid, ttl) {
 	if (cache.size >= MAX_CACHE_SIZE) {
 		const now = Date.now();
-		for (const [k, v] of cache) if (now >= v.expiresAt) cache.delete(k);
+		for (const [k, v] of cache) if (!isFutureDateTimestampMs(v.expiresAt, { nowMs: now })) cache.delete(k);
 		if (cache.size >= MAX_CACHE_SIZE) {
 			const keys = Array.from(cache.keys());
 			for (let i = 0; i < keys.length / 2; i++) cache.delete(keys[i]);
@@ -1626,10 +1632,15 @@ function setCachedFileInfo(contentHash, scope, targetId, fileType, fileInfo, fil
 	}
 	const key = buildCacheKey(contentHash, scope, targetId, fileType);
 	const effectiveTtl = Math.max(ttl - 60, 10);
+	const expiresAt = resolveExpiresAtMsFromDurationSeconds(effectiveTtl);
+	if (expiresAt === void 0) {
+		cache.delete(key);
+		return;
+	}
 	cache.set(key, {
 		fileInfo,
 		fileUuid,
-		expiresAt: Date.now() + effectiveTtl * 1e3
+		expiresAt
 	});
 	debugLog(`[upload-cache] Cache SET: key=${key.slice(0, 40)}..., ttl=${effectiveTtl}s, uuid=${fileUuid}`);
 }
@@ -1860,9 +1871,10 @@ async function sendText(target, content, creds, opts) {
 		const scope = target.type;
 		if (opts?.msgId) return api.sendMessage(scope, target.id, content, c, {
 			msgId: opts.msgId,
-			messageReference: opts.messageReference
+			messageReference: opts.messageReference,
+			forcePlainText: opts.forcePlainText
 		});
-		return api.sendProactiveMessage(scope, target.id, content, c);
+		return api.sendProactiveMessage(scope, target.id, content, c, { forcePlainText: opts?.forcePlainText });
 	}
 	if (target.type === "dm") return api.sendDmMessage({
 		guildId: target.id,

package/dist/runtime-api.js

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

package/dist/setup-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as qqbotSetupPlugin } from "./channel.setup-BxGpVkdx.js";
+import { t as qqbotSetupPlugin } from "./channel.setup-_OAH-xmU.js";
 export { qqbotSetupPlugin };

package/npm-shrinkwrap.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/qqbot",
-  "version": "2026.5.28",
+  "version": "2026.5.31-beta.1",
   "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.5.28"
+    "openclaw": ">=2026.5.31-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -45,10 +45,10 @@
       "minHostVersion": ">=2026.4.10"
     },
     "compat": {
-      "pluginApi": ">=2026.5.28"
+      "pluginApi": ">=2026.5.31-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.5.28"
+      "openclawVersion": "2026.5.31-beta.1"
     },
     "release": {
       "publishToClawHub": true,