@xmanrui/dsh-im 2.2.1 → 2.4.0

package/src/channels/shared/i18n-en/shared-c.mjs

@@ -96,4 +96,53 @@ export default {
 
   // agent-preset.mjs
   'Agent Preset 无效。': 'Invalid Agent Preset.',
+
+  // batch-input.mjs
+  '/batch  开始批量输入（仅私聊，最多 10 条文字）':
+    '/batch  Start batch input (direct messages only, up to 10 text messages)',
+  '/send  提交当前批次': '/send  Submit the current batch',
+  '/cancel  取消当前批次': '/cancel  Cancel the current batch',
+  '开始批量输入（仅私聊）': 'Start batch input (direct messages only)',
+  '提交当前批次': 'Submit the current batch',
+  '取消当前批次': 'Cancel the current batch',
+  '当前已处于批量输入模式，已收集 {count}/{limit} 条。\n请发送 /send 提交或 /cancel 取消。':
+    'Batch input is already active with {count}/{limit} messages collected.\nSend /send to submit or /cancel to cancel.',
+  '当前已处于批量输入模式，已收集 {count}/{limit} 条。\n完成后发送 /send，取消请发送 /cancel。':
+    'Batch input is already active with {count}/{limit} messages collected.\nSend /send when finished or /cancel to cancel.',
+  '[消息 {index}]': '[Message {index}]',
+  '以下是用户通过批量输入模式发送的多条内容，请按顺序作为同一次输入统一处理。':
+    'The user sent the following messages in batch input mode. Process them in order as one input.',
+  '批量输入模式仅支持私聊，请在与机器人的私聊中使用。':
+    'Batch input is available only in direct messages. Please use it in a direct chat with the bot.',
+  '当前聊天有正在运行的任务、待回答问题或待审批请求。\n请先完成当前交互或发送 /stop，再使用 /batch。':
+    'This chat has a running task, unanswered question, or pending approval.\nFinish the current interaction or send /stop before using /batch.',
+  '用法：/{command}（不带参数）': 'Usage: /{command} (without arguments)',
+  '批量输入命令仅支持纯文字，请移除图片或文件后重试。':
+    'Batch input commands support text only. Remove the image or file and try again.',
+  '当前没有待提交的批量内容，请先发送 /batch。':
+    'There is no batch to submit. Send /batch first.',
+  '当前没有正在进行的批量输入。': 'There is no active batch input.',
+  '已进入批量输入模式，最多可发送 {limit} 条文字。\n完成后发送 /send，取消请发送 /cancel。':
+    'Batch input started. You can send up to {limit} text messages.\nSend /send when finished or /cancel to cancel.',
+  '批量输入模式目前仅支持文字，这条消息未收录。\n请继续发送文字，或使用 /send、/cancel。':
+    'Batch input currently supports text only, so this message was not collected.\nContinue with text, or use /send or /cancel.',
+  '当前批次正在提交，请勿重复发送 /send。':
+    'The current batch is being submitted. Do not send /send again.',
+  '批量内容已经提交，无法取消。\n如需停止当前任务，请发送 /stop。':
+    'The batch has already been submitted and cannot be cancelled.\nSend /stop if you need to stop the current task.',
+  '当前批次正在提交，请等待处理完成后再开启新批次。':
+    'The current batch is being submitted. Wait for it to finish before starting another batch.',
+  '已取消批量输入。': 'Batch input cancelled.',
+  '已取消批量输入，共丢弃 {count} 条消息。':
+    'Batch input cancelled; {count} messages were discarded.',
+  '当前批次还没有内容，请先发送文字，或使用 /cancel 取消。':
+    'The current batch is empty. Send some text first or use /cancel.',
+  '当前正在批量输入，请先发送 /send 提交或 /cancel 取消。':
+    'Batch input is active. Send /send to submit or /cancel to cancel first.',
+  '当前批次已满，这条消息未收录。\n请先发送 /send 提交或 /cancel 取消，然后重新发送这条消息。':
+    'The current batch is full, so this message was not collected.\nSend /send or /cancel first, then resend this message.',
+  '已收集 {count}/{limit} 条，当前批次已满，请发送 /send 提交或 /cancel 取消。':
+    'Collected {count}/{limit} messages. The batch is full; send /send or /cancel.',
+  '批量内容提交失败，已保留 {count} 条消息。\n请再次发送 /send 重试或 /cancel 取消。':
+    'Batch submission failed; {count} messages were retained.\nSend /send to retry or /cancel to cancel.',
 };

package/src/channels/shared/i18n-en/telegram.mjs

@@ -13,6 +13,7 @@ export default {
   '停止当前任务': 'Stop the current task',
   '纠偏当前任务': 'Steer the current task',
   '检查连接状态': 'Check connection status',
+  '查看插件版本': 'Show plugin version',
   '显示帮助': 'Show help',
   '该 Telegram 机器人已配置 Webhook，请先在原服务中移除 Webhook 后重试。':
     'This Telegram bot already has a Webhook configured. Remove the Webhook from the original service and try again.',

package/src/channels/shared/text-harness-bridge.mjs

@@ -19,6 +19,12 @@ import {
 } from './preset-command.mjs';
 import { askInWorkspaceSession } from './workspace-session.mjs';
 import { HarnessApprovalQueue } from './harness-approval.mjs';
+import {
+  BatchInputManager,
+  batchInputBusyMessage,
+  batchInputGroupUnsupportedMessage,
+  isBatchInputCommand,
+} from './batch-input.mjs';
 import {
   hasInboundImages,
   imagePromptUserMessage,
@@ -119,6 +125,7 @@ export class TextHarnessBridge {
   #approvalTasks = new Set();
   #commandTasks = new Set();
   #approvals;
+  #batches = new BatchInputManager();
 
   constructor({
     descriptor,
@@ -173,7 +180,54 @@ export class TextHarnessBridge {
     const key = `${kind}:${conversationId}`;
     const pending = this.#pendingInteractions.get(key);
     const text = cleanText(normalized.content);
-    const commandRunner = hasInboundFiles(normalized) ? null : isControlCommand(text)
+    const batchCommand = isBatchInputCommand(text);
+    if (batchCommand && normalized.kind === 'group' && normalized.addressed === true) {
+      return this.#finishLocalMessage(
+        normalized,
+        messageId,
+        batchInputGroupUnsupportedMessage(),
+      );
+    }
+    if (batchCommand && normalized.kind === 'direct') {
+      const exactBatch = /^\/batch$/iu.test(text);
+      if (exactBatch && (
+        this.#queues.has(key)
+        || Boolean(pending)
+        || this.#approvals.hasPending(key)
+      )) {
+        return this.#finishLocalMessage(normalized, messageId, batchInputBusyMessage());
+      }
+      const batch = this.#batches.handle(key, text, {
+        plainText: Boolean(text)
+          && normalized.plainText !== false
+          && !hasInboundImages(normalized)
+          && !hasInboundFiles(normalized),
+      });
+      if (batch.handled) {
+        if (batch.kind === 'submit') {
+          return this.#enqueueMessage({
+            ...normalized,
+            content: batch.prompt,
+            batchSubmission: { token: batch.token },
+          }, messageId, senderId, key);
+        }
+        return this.#finishLocalMessage(normalized, messageId, batch.message);
+      }
+    } else if (normalized.kind === 'direct'
+      && this.#batches.status(key).phase === 'collecting') {
+      const batch = this.#batches.handle(key, text, {
+        plainText: Boolean(text)
+          && normalized.plainText !== false
+          && !hasInboundImages(normalized)
+          && !hasInboundFiles(normalized),
+      });
+      if (batch.handled) {
+        return this.#finishLocalMessage(normalized, messageId, batch.message);
+      }
+    }
+    const collectingBatch = normalized.kind === 'direct'
+      && this.#batches.status(key).phase === 'collecting';
+    const commandRunner = collectingBatch || hasInboundFiles(normalized) ? null : isControlCommand(text)
       ? runControlCommand
       : (isModelCommand(text)
           ? runModelCommand
@@ -254,6 +308,30 @@ export class TextHarnessBridge {
     return this.#enqueueMessage(normalized, messageId, senderId, key);
   }
 
+  #finishLocalMessage(message, messageId, reply) {
+    let task;
+    task = (async () => {
+      if (this.#state.hasSeen(messageId)) return;
+      await this.#state.markSeen(messageId);
+      this.#status.messagesReceived += 1;
+      this.#status.lastMessageAt = new Date().toISOString();
+      if (reply) await this.#bot.sendText(message.replyTarget, reply);
+      this.#status.lastError = null;
+    })().catch(async (error) => {
+      if (this.#signal?.aborted) return;
+      this.#status.lastError = error?.message ?? String(error);
+      this.#logger.error?.(
+        `[dsh-im:${this.#descriptor.key}] failed to process a batch input message:`,
+        error,
+      );
+    }).finally(() => {
+      this.#acceptedMessageIds.delete(messageId);
+      this.#commandTasks.delete(task);
+    });
+    this.#commandTasks.add(task);
+    return task;
+  }
+
   #enqueueMessage(message, messageId, senderId, key, {
     releaseMessageId = true,
     alreadyRecorded = false,
@@ -373,6 +451,7 @@ export class TextHarnessBridge {
 
     const target = message.replyTarget;
     const text = cleanText(message.content);
+    const batchSubmission = message.batchSubmission;
     let stream = null;
     let semanticStream = false;
     try {
@@ -411,7 +490,11 @@ export class TextHarnessBridge {
           t('/preset --default  跟随 Host 默认'),
           t('/stop  停止当前任务'),
           t('/steer 补充指令  纠偏当前任务'),
+          t('/batch  开始批量输入（仅私聊，最多 10 条文字）'),
+          t('/send  提交当前批次'),
+          t('/cancel  取消当前批次'),
           t('/status  检查连接状态'),
+          t('/version  查看插件版本'),
           t('/help  显示本帮助'),
         ].join('\n'));
         return;
@@ -508,6 +591,9 @@ export class TextHarnessBridge {
           files: message.files,
         },
       });
+      if (batchSubmission) {
+        this.#batches.complete(conversationKey, batchSubmission.token);
+      }
       const fileOnlyCompletion = !cleanText(answer) && artifacts.length > 0;
       const visibleAnswer = fileOnlyCompletion
         ? t(FILE_ONLY_COMPLETION_TEXT)
@@ -579,7 +665,14 @@ export class TextHarnessBridge {
       }
       return delivery.receipt;
     } catch (error) {
-      if (error?.code === 'turn-stopped') {
+      const turnStopped = error?.code === 'turn-stopped';
+      if (batchSubmission && turnStopped) {
+        this.#batches.complete(conversationKey, batchSubmission.token);
+      }
+      const failedBatch = batchSubmission && !turnStopped
+        ? this.#batches.fail(conversationKey, batchSubmission.token)
+        : null;
+      if (turnStopped) {
         if (stream) {
           try {
             await stream.finish(t('已停止。'));
@@ -607,6 +700,23 @@ export class TextHarnessBridge {
           return false;
         }
       };
+      if (failedBatch?.retained) {
+        this.#logger.error?.(
+          `[dsh-im:${this.#descriptor.key}] failed to submit a batch input:`,
+          error,
+        );
+        if (await presentStreamFailure(failedBatch.message)) return;
+        stream?.cancel?.();
+        try {
+          await this.#bot.sendText(target, failedBatch.message);
+        } catch (sendError) {
+          this.#logger.error?.(
+            `[dsh-im:${this.#descriptor.key}] failed to send the batch retry notice:`,
+            sendError,
+          );
+        }
+        return;
+      }
       const imageErrorMessage = imagePromptUserMessage(error);
       if (imageErrorMessage) {
         if (await presentStreamFailure(imageErrorMessage)) return;

package/src/channels/slack/slack-runtime.mjs

@@ -119,6 +119,7 @@ export function normalizeSlackEvent(payload, botUserId, {
     kind: direct ? 'direct' : 'group',
     conversationId: direct ? String(event.channel) : `${event.channel}:${threadTs}`,
     content: stripBotMention(event.text ?? '', botUserId),
+    plainText: !Array.isArray(event.files) || event.files.length === 0,
     images: Array.isArray(event.files)
       ? event.files.map((file) => slackImageSource(file, loadFile)).filter(Boolean)
       : [],

package/src/channels/telegram/telegram-runtime.mjs

@@ -28,7 +28,11 @@ export const TELEGRAM_COMMAND_MENU = Object.freeze([
   { command: 'preset', description: '查看或设置新会话 Agent Preset' },
   { command: 'stop', description: '停止当前任务' },
   { command: 'steer', description: '纠偏当前任务' },
+  { command: 'batch', description: '开始批量输入（仅私聊）' },
+  { command: 'send', description: '提交当前批次' },
+  { command: 'cancel', description: '取消当前批次' },
   { command: 'status', description: '检查连接状态' },
+  { command: 'version', description: '查看插件版本' },
   { command: 'help', description: '显示帮助' },
 ]);
 
@@ -160,6 +164,7 @@ export function normalizeTelegramUpdate(update, {
     conversationId: messageThreadId === undefined
       ? String(chatId) : `${chatId}:${messageThreadId}`,
     content: withoutBotMention(message.text ?? message.caption ?? '', username),
+    plainText: typeof message.text === 'string',
     images: image ? [image] : [],
     files: file ? [file] : [],
     addressed,

package/src/channels/wecom/wecom-bridge.mjs

@@ -5,6 +5,12 @@ import {
   validHarnessQuestion,
 } from '../shared/harness-question.mjs';
 import { HarnessApprovalQueue } from '../shared/harness-approval.mjs';
+import {
+  BatchInputManager,
+  batchInputBusyMessage,
+  batchInputGroupUnsupportedMessage,
+  isBatchInputCommand,
+} from '../shared/batch-input.mjs';
 import { runCompactCommand } from '../shared/compact-command.mjs';
 import {
   isControlCommand,
@@ -63,7 +69,11 @@ function helpText() {
     t('/preset --default  跟随 Host 默认'),
     t('/stop  停止当前任务'),
     t('/steer 补充指令  纠偏当前任务'),
+    t('/batch  开始批量输入（仅私聊，最多 10 条文字）'),
+    t('/send  提交当前批次'),
+    t('/cancel  取消当前批次'),
     t('/status  检查连接状态'),
+    t('/version  查看插件版本'),
     t('/help  显示本帮助'),
   ].join('\n');
 }
@@ -254,6 +264,10 @@ function interactionReplyText(frame) {
   return bodyOf(frame).msgtype === 'text' ? messageText(frame) : '';
 }
 
+function isNativeWecomText(frame) {
+  return bodyOf(frame).msgtype === 'text' && Boolean(nonEmptyString(messageText(frame)));
+}
+
 function splitUtf8(text, maxBytes = MAX_REPLY_BYTES) {
   const source = String(text ?? '').trim();
   if (!source) return [];
@@ -466,6 +480,7 @@ export class WecomHarnessBridge {
   #approvalTasks = new Set();
   #commandTasks = new Set();
   #approvals;
+  #batchInputs = new BatchInputManager();
   #prefetchedImageCount = 0;
 
   constructor({
@@ -523,6 +538,40 @@ export class WecomHarnessBridge {
     const pending = this.#pendingInteractions.get(key);
     const commandMessage = wecomInboundMessage(frame, this.#client);
     const commandText = nonEmptyString(commandMessage.content) ?? '';
+    const batchCommand = isBatchInputCommand(commandText);
+    const batchStatus = this.#batchInputs.status(key);
+    if (batchCommand && body.chattype === 'group') {
+      return this.#finishBatchResult(
+        frame,
+        messageId,
+        chatId,
+        { message: batchInputGroupUnsupportedMessage() },
+      );
+    }
+    if (body.chattype === 'single'
+      && (batchCommand || batchStatus.phase === 'collecting')) {
+      const exactBatchStart = /^\/batch$/iu.test(commandText);
+      const result = exactBatchStart
+        && batchStatus.phase === 'idle'
+        && (this.#queues.has(key) || pending || this.#approvals.hasPending(key))
+        ? { handled: true, kind: 'busy', message: batchInputBusyMessage() }
+        : this.#batchInputs.handle(key, commandText, {
+            plainText: isNativeWecomText(frame),
+          });
+      if (result.handled) {
+        if (result.kind === 'submit') {
+          return this.#enqueueMessage({
+            ...frame,
+            body: {
+              ...body,
+              msgtype: 'text',
+              text: { content: result.prompt },
+            },
+          }, messageId, key, { batchSubmission: result });
+        }
+        return this.#finishBatchResult(frame, messageId, chatId, result);
+      }
+    }
     const commandRunner = hasInboundFiles(commandMessage) ? null : isControlCommand(commandText)
       ? runControlCommand
       : (isModelCommand(commandText)
@@ -616,6 +665,7 @@ export class WecomHarnessBridge {
   #enqueueMessage(frame, messageId, key, {
     releaseMessageId = true,
     alreadyRecorded = false,
+    batchSubmission = null,
   } = {}) {
     // WeCom image URLs expire after five minutes, while a conversation turn
     // may legally stay queued longer. Start the authenticated SDK download as
@@ -637,7 +687,11 @@ export class WecomHarnessBridge {
     const previous = this.#queues.get(key) ?? Promise.resolve();
     const current = previous
       .catch(() => undefined)
-      .then(() => this.#process(frame, { alreadyRecorded, preparedMessage }))
+      .then(() => this.#process(frame, {
+        alreadyRecorded,
+        preparedMessage,
+        batchSubmission,
+      }))
       .finally(() => {
         this.#prefetchedImageCount -= reservedImages;
         if (releaseMessageId) this.#acceptedMessageIds.delete(messageId);
@@ -647,6 +701,29 @@ export class WecomHarnessBridge {
     return current;
   }
 
+  #finishBatchResult(frame, messageId, chatId, result) {
+    let task;
+    task = Promise.resolve().then(async () => {
+      if (this.#state.hasSeen(messageId)) return;
+      await this.#state.markSeen(messageId);
+      this.#status.messagesReceived += 1;
+      this.#status.lastMessageAt = new Date().toISOString();
+      if (result.message) await this.#sendImmediate(frame, chatId, result.message);
+      this.#status.lastError = null;
+    }).catch(async (error) => {
+      if (this.#signal?.aborted) return;
+      this.#status.lastError = error?.message ?? String(error);
+      this.#logger.error?.('[dsh-im:wecom] failed to process a batch input message');
+      await this.#sendImmediate(frame, chatId, t('消息处理失败，请稍后重试。'))
+        .catch(() => undefined);
+    }).finally(() => {
+      this.#acceptedMessageIds.delete(messageId);
+      this.#commandTasks.delete(task);
+    });
+    this.#commandTasks.add(task);
+    return task;
+  }
+
   async waitForIdle() {
     await Promise.allSettled([
       ...this.#queues.values(),
@@ -748,7 +825,11 @@ export class WecomHarnessBridge {
     };
   }
 
-  async #process(frame, { alreadyRecorded = false, preparedMessage } = {}) {
+  async #process(frame, {
+    alreadyRecorded = false,
+    preparedMessage,
+    batchSubmission = null,
+  } = {}) {
     if (this.#signal?.aborted) return;
     const body = bodyOf(frame);
     const messageId = typeof body.msgid === 'string' ? body.msgid : '';
@@ -767,6 +848,7 @@ export class WecomHarnessBridge {
     const key = conversationKey(frame);
     let streamId = null;
     let streamStarted = false;
+    let batchSettled = batchSubmission === null;
     try {
       if (!text && !hasImages && !hasFiles) {
         await this.#sendImmediate(frame, chatId, t('目前支持文字、图片、文件和语音转写消息。'));
@@ -855,6 +937,10 @@ export class WecomHarnessBridge {
           files: message.files,
         },
       });
+      if (batchSubmission) {
+        this.#batchInputs.complete(key, batchSubmission.token);
+        batchSettled = true;
+      }
 
       this.#signal?.throwIfAborted();
       const displayAnswer = answerTextForDelivery(answer, artifacts);
@@ -915,6 +1001,15 @@ export class WecomHarnessBridge {
       this.#status.lastError = null;
       return delivery.receipt;
     } catch (error) {
+      let batchFailureMessage = null;
+      if (!batchSettled && batchSubmission) {
+        if (error?.code === 'turn-stopped') {
+          this.#batchInputs.complete(key, batchSubmission.token);
+        } else {
+          batchFailureMessage = this.#batchInputs.fail(key, batchSubmission.token).message ?? null;
+        }
+        batchSettled = true;
+      }
       if (error?.code === 'turn-stopped') {
         if (streamStarted && streamId) {
           await this.#client.replyStream(frame, streamId, t('已停止。'), true)
@@ -929,11 +1024,14 @@ export class WecomHarnessBridge {
       const errorText = inboundFileUserMessage(error)
         ?? imagePromptUserMessage(error)
         ?? t('消息处理失败，请稍后重试。');
+      const visibleError = batchFailureMessage
+        ? `${errorText}\n\n${batchFailureMessage}`
+        : errorText;
       try {
         if (streamStarted && streamId) {
-          await this.#client.replyStream(frame, streamId, errorText, true);
+          await this.#client.replyStream(frame, streamId, visibleError, true);
         } else {
-          await this.#sendImmediate(frame, chatId, errorText);
+          await this.#sendImmediate(frame, chatId, visibleError);
         }
         await this.#state.markSeen(messageId);
       } catch {

package/src/channels/weixin/weixin-bridge.mjs

@@ -12,6 +12,11 @@ import {
   validHarnessQuestion,
 } from '../shared/harness-question.mjs';
 import { HarnessApprovalQueue } from '../shared/harness-approval.mjs';
+import {
+  BatchInputManager,
+  batchInputBusyMessage,
+  isBatchInputCommand,
+} from '../shared/batch-input.mjs';
 import { runCompactCommand } from '../shared/compact-command.mjs';
 import {
   isControlCommand,
@@ -70,7 +75,11 @@ const HELP_TEXT = () => [
   t('/preset --default  跟随 Host 默认'),
   t('/stop  停止当前任务'),
   t('/steer 补充指令  纠偏当前任务'),
+  t('/batch  开始批量输入（仅私聊，最多 10 条文字）'),
+  t('/send  提交当前批次'),
+  t('/cancel  取消当前批次'),
   t('/status  检查连接状态'),
+  t('/version  查看插件版本'),
   t('/help  显示本帮助'),
 ].join('\n');
 
@@ -104,6 +113,15 @@ function hasWeixinFileItems(message) {
     && message.item_list.some((item) => item?.file_item && typeof item.file_item === 'object');
 }
 
+function isNativeWeixinText(message) {
+  return Array.isArray(message?.item_list)
+    && message.item_list.length > 0
+    && message.item_list.every((item) => (
+      item?.type === 1 && typeof item.text_item?.text === 'string'
+    ))
+    && Boolean(nonEmptyString(extractWeixinText(message)));
+}
+
 function canClaimInteractionReply(message, pending) {
   return pending.questions[pending.index]
     && nonEmptyString(message?.from_user_id) === pending.actor
@@ -176,6 +194,7 @@ export class WeixinHarnessBridge {
   #approvalTasks = new Set();
   #commandTasks = new Set();
   #approvals;
+  #batchInputs = new BatchInputManager();
 
   constructor({
     api,
@@ -227,6 +246,35 @@ export class WeixinHarnessBridge {
     const runId = nonEmptyString(message?.run_id) ?? undefined;
     const pending = this.#pendingInteractions.get(key);
     const commandText = nonEmptyString(extractWeixinText(message)) ?? '';
+    const batchCommand = isBatchInputCommand(commandText);
+    const batchStatus = this.#batchInputs.status(key);
+    if (sender === this.#ownerUserId
+      && (batchCommand || batchStatus.phase === 'collecting')) {
+      const exactBatchStart = /^\/batch$/iu.test(commandText);
+      const result = exactBatchStart
+        && batchStatus.phase === 'idle'
+        && (this.#queues.has(key) || pending || this.#approvals.hasPending(key))
+        ? { handled: true, kind: 'busy', message: batchInputBusyMessage() }
+        : this.#batchInputs.handle(key, commandText, {
+            plainText: isNativeWeixinText(message),
+          });
+      if (result.handled) {
+        if (result.kind === 'submit') {
+          return this.#enqueueMessage({
+            ...message,
+            item_list: [{ type: 1, text_item: { text: result.prompt } }],
+          }, messageId, key, { batchSubmission: result });
+        }
+        return this.#finishBatchResult(
+          message,
+          messageId,
+          sender,
+          contextToken,
+          runId,
+          result,
+        );
+      }
+    }
     const commandRunner = hasWeixinFileItems(message) ? null : isControlCommand(commandText)
       ? runControlCommand
       : (isModelCommand(commandText)
@@ -314,6 +362,7 @@ export class WeixinHarnessBridge {
   #enqueueMessage(message, messageId, key, {
     releaseMessageId = true,
     alreadyRecorded = false,
+    batchSubmission = null,
   } = {}) {
     const preparedMessage = message.from_user_id === this.#ownerUserId
       ? prefetchInboundFiles(
@@ -324,7 +373,11 @@ export class WeixinHarnessBridge {
     const previous = this.#queues.get(key) ?? Promise.resolve();
     const current = previous
       .catch(() => undefined)
-      .then(() => this.#process(message, key, { alreadyRecorded, preparedMessage }))
+      .then(() => this.#process(message, key, {
+        alreadyRecorded,
+        preparedMessage,
+        batchSubmission,
+      }))
       .finally(() => {
         if (releaseMessageId) this.#acceptedMessageIds.delete(messageId);
         if (this.#queues.get(key) === current) this.#queues.delete(key);
@@ -333,6 +386,33 @@ export class WeixinHarnessBridge {
     return current;
   }
 
+  #finishBatchResult(message, messageId, sender, contextToken, runId, result) {
+    let task;
+    task = Promise.resolve().then(async () => {
+      if (this.#state.hasSeen(messageId)) return;
+      await this.#state.markSeen(messageId);
+      this.#status.messagesReceived += 1;
+      this.#status.lastMessageAt = new Date().toISOString();
+      if (result.message) {
+        await this.#send(sender, result.message, contextToken, runId);
+      }
+      this.#status.lastError = null;
+      this.#status.lastMessageError = null;
+    }).catch(async (error) => {
+      if (this.#signal?.aborted) return;
+      this.#status.lastError = error?.message ?? String(error);
+      this.#status.lastMessageError = safeMessageError(error);
+      this.#logger.error?.('[dsh-weixin] failed to process a batch input message:', error);
+      await this.#send(sender, GENERIC_PROCESSING_ERROR(), contextToken, runId)
+        .catch(() => undefined);
+    }).finally(() => {
+      this.#acceptedMessageIds.delete(messageId);
+      this.#commandTasks.delete(task);
+    });
+    this.#commandTasks.add(task);
+    return task;
+  }
+
   async waitForIdle() {
     await Promise.allSettled([
       ...this.#queues.values(),
@@ -380,7 +460,11 @@ export class WeixinHarnessBridge {
     this.#status.lastMessageError = null;
   }
 
-  async #process(message, key, { alreadyRecorded = false, preparedMessage } = {}) {
+  async #process(message, key, {
+    alreadyRecorded = false,
+    preparedMessage,
+    batchSubmission = null,
+  } = {}) {
     this.#signal?.throwIfAborted();
     const messageId = weixinMessageId(message);
     const sender = nonEmptyString(message?.from_user_id);
@@ -398,6 +482,7 @@ export class WeixinHarnessBridge {
 
     const contextToken = typeof message.context_token === 'string' ? message.context_token : undefined;
     const runId = typeof message.run_id === 'string' ? message.run_id : undefined;
+    let batchSettled = batchSubmission === null;
     try {
       const promptMessage = preparedMessage ?? weixinInboundMessage(message, this.#api);
       const text = promptMessage.content;
@@ -479,6 +564,10 @@ export class WeixinHarnessBridge {
             files: promptMessage.files,
           },
         }));
+        if (batchSubmission) {
+          this.#batchInputs.complete(key, batchSubmission.token);
+          batchSettled = true;
+        }
       } finally {
         await Promise.allSettled([
           this.#cancelPendingInteraction(key),
@@ -515,6 +604,15 @@ export class WeixinHarnessBridge {
       this.#status.lastMessageError = null;
       return delivery.receipt;
     } catch (error) {
+      let batchFailureMessage = null;
+      if (!batchSettled && batchSubmission) {
+        if (error?.code === 'turn-stopped') {
+          this.#batchInputs.complete(key, batchSubmission.token);
+        } else {
+          batchFailureMessage = this.#batchInputs.fail(key, batchSubmission.token).message ?? null;
+        }
+        batchSettled = true;
+      }
       if (error?.code === 'turn-stopped') {
         await this.#state.markSeen(messageId);
         return;
@@ -529,7 +627,7 @@ export class WeixinHarnessBridge {
       try {
         await this.#send(
           sender,
-          userMessage,
+          batchFailureMessage ? `${userMessage}\n\n${batchFailureMessage}` : userMessage,
           contextToken,
           runId,
         );