@xmanrui/dsh-im 4.4.0 → 4.6.0

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

@@ -4,6 +4,7 @@ import { createEditableMessageStream, splitMessageText } from '../shared/editabl
 import { createTextDeliveryBlock } from '../shared/semantic/delivery.mjs';
 import { t } from '../shared/i18n.mjs';
 import { captureContextEnhancement } from '../shared/context-enhancement.mjs';
+import { recoverAssistantTextByTimestamp } from '../shared/session-reply-recovery.mjs';
 import { COMMANDS_MENU_BUTTON, TelegramApi } from './telegram-api.mjs';
 import { createTelegramHttpTransport } from './telegram-http.mjs';
 import { createTelegramBridgeStatus, TelegramHarnessBridge } from './telegram-bridge.mjs';
@@ -138,11 +139,94 @@ function telegramFileSource(message, loadFile) {
   };
 }
 
+function telegramReplyAttachment(kind, file, fallbackName) {
+  if (!file || typeof file !== 'object') return null;
+  const name = typeof file.file_name === 'string' && file.file_name
+    ? file.file_name : typeof fallbackName === 'string' && fallbackName
+      ? fallbackName : undefined;
+  return { kind, ...(name ? { name } : {}) };
+}
+
+function telegramReplyAttachments(message) {
+  const attachments = [];
+  if (Array.isArray(message?.photo) && message.photo.length > 0) {
+    const largest = message.photo.reduce((best, candidate) => (
+      photoScore(candidate) > photoScore(best) ? candidate : best
+    ));
+    attachments.push(telegramReplyAttachment(
+      'image',
+      largest,
+      `${largest.file_unique_id ?? largest.file_id ?? 'telegram-photo'}.jpg`,
+    ));
+  } else if (message?.document) {
+    attachments.push(telegramReplyAttachment(
+      imageTypeForDocument(message.document) ? 'image' : 'file',
+      message.document,
+    ));
+  }
+  for (const [field, kind] of [
+    ['audio', 'audio'],
+    ['voice', 'audio'],
+    ['video', 'video'],
+    ['video_note', 'video'],
+    ['animation', 'video'],
+  ]) {
+    if (message?.[field]) attachments.push(telegramReplyAttachment(kind, message[field]));
+  }
+  if (message?.sticker) {
+    attachments.push(telegramReplyAttachment(
+      message.sticker.is_video === true ? 'video' : 'image',
+      message.sticker,
+      message.sticker.file_unique_id ?? message.sticker.file_id,
+    ));
+  }
+  return attachments.filter(Boolean);
+}
+
+function telegramReplyReference(message, { quote, loadReplyContent } = {}) {
+  if ((!message || typeof message !== 'object')
+    && (!quote || typeof quote !== 'object')) return undefined;
+  const authorId = message?.from?.id === undefined ? undefined : String(message.from.id);
+  const authorName = [message?.from?.first_name, message?.from?.last_name]
+    .filter((value) => typeof value === 'string' && value.trim())
+    .map((value) => value.trim()).join(' ') || (
+      typeof message?.from?.username === 'string' && message.from.username
+        ? message.from.username : undefined
+    );
+  const content = typeof message?.text === 'string'
+    ? message.text : typeof message?.caption === 'string'
+      ? message.caption : typeof quote?.text === 'string' ? quote.text : '';
+  const attachments = telegramReplyAttachments(message);
+  const messageId = Number.isSafeInteger(message?.message_id)
+    ? String(message.message_id) : undefined;
+  const createdAt = Number.isSafeInteger(message?.date) && message.date >= 0
+    ? message.date * 1_000 : undefined;
+  const load = !content.trim() && attachments.length === 0
+    && typeof loadReplyContent === 'function'
+    ? ({ signal } = {}) => loadReplyContent({
+        ...(messageId ? { messageId } : {}),
+        ...(createdAt === undefined ? {} : { createdAt }),
+      }, { signal })
+    : null;
+  return {
+    ...(messageId ? { messageId } : {}),
+    ...(authorId ? { authorId } : {}),
+    ...(authorName ? { authorName } : {}),
+    ...(content.trim() ? { content } : {}),
+    ...(attachments.length > 0 ? { attachments } : {}),
+    ...(load ? { load } : {}),
+    ...(!content.trim() && attachments.length === 0 && !load
+      ? { unavailableReason: 'not-delivered' }
+      : {}),
+  };
+}
+
 export function normalizeTelegramUpdate(update, {
   botId,
   username,
   loadFile = async () => { throw new Error('Telegram file downloader is unavailable'); },
   loadFileStream = loadFile,
+  loadReplyContent,
 }) {
   const message = update?.message;
   const chatId = message?.chat?.id;
@@ -159,6 +243,21 @@ export function normalizeTelegramUpdate(update, {
     ? message.message_thread_id : undefined;
   const image = telegramImageSource(message, loadFile);
   const file = telegramFileSource(message, loadFileStream);
+  const conversationId = messageThreadId === undefined
+    ? String(chatId) : `${chatId}:${messageThreadId}`;
+  const key = `${direct ? 'direct' : 'group'}:${conversationId}`;
+  const replyTo = telegramReplyReference(
+    message.reply_to_message ?? message.external_reply,
+    {
+      quote: message.quote,
+      ...(typeof loadReplyContent === 'function' ? {
+        loadReplyContent: (reference, options) => loadReplyContent({
+          conversationKey: key,
+          ...reference,
+        }, options),
+      } : {}),
+    },
+  );
   return {
     messageId: String(update.update_id),
     senderId: String(senderId),
@@ -166,15 +265,16 @@ export function normalizeTelegramUpdate(update, {
       senderName: [message.from?.first_name, message.from?.last_name]
         .filter((value) => typeof value === 'string' && value.trim())
         .map((value) => value.trim()).join(' ') || message.from?.username,
+      conversationTitle: direct ? undefined : message.chat?.title,
     }),
     senderIsBot: message.from?.is_bot === true,
     kind: direct ? 'direct' : 'group',
-    conversationId: messageThreadId === undefined
-      ? String(chatId) : `${chatId}:${messageThreadId}`,
+    conversationId,
     content: withoutBotMention(message.text ?? message.caption ?? '', username),
     plainText: typeof message.text === 'string',
     images: image ? [image] : [],
     files: file ? [file] : [],
+    ...(replyTo ? { replyTo } : {}),
     addressed,
     reactionTarget: { chatId, messageId },
     replyTarget: {
@@ -838,6 +938,21 @@ export class TelegramRuntime {
     }
   }
 
+  async #loadReplyContent(reference, { signal } = {}) {
+    const key = typeof reference?.conversationKey === 'string'
+      ? reference.conversationKey.trim() : '';
+    const quotedAt = Number(reference?.createdAt);
+    if (!key || !Number.isFinite(quotedAt)) {
+      return { unavailableReason: 'not-delivered' };
+    }
+    const sessionId = this.#state.sessionFor(key);
+    const session = typeof sessionId === 'string' && sessionId
+      ? this.#harness.workspaceSession?.(sessionId)
+      : null;
+    const text = await recoverAssistantTextByTimestamp({ session, quotedAt, signal });
+    return text ? { content: text } : { unavailableReason: 'not-delivered' };
+  }
+
   async #poll(initialCursor, signal) {
     let cursor = initialCursor;
     while (!signal.aborted) {
@@ -862,6 +977,7 @@ export class TelegramRuntime {
           username: this.#config.username,
           loadFile: (fileId, options) => this.#api.downloadFile({ fileId, ...options }),
           loadFileStream: (fileId, options) => this.#api.downloadFileStream({ fileId, ...options }),
+          loadReplyContent: (reference, options) => this.#loadReplyContent(reference, options),
         });
         if (message) {
           void this.#bridge.accept(message, { contextSnapshot }).catch((error) => {

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

@@ -33,7 +33,6 @@ import {
   ImagePromptError,
   imagePromptDiagnostic,
   imagePromptUserMessage,
-  promptContentForMessage,
 } from '../shared/image-prompt.mjs';
 import {
   hasInboundFiles,
@@ -42,6 +41,10 @@ import {
 import { rememberConnectionTestTarget } from '../shared/connection-test.mjs';
 import { trackOutboundArtifactProviderPromise } from '../shared/semantic/artifact.mjs';
 import { deliverOutboundArtifacts } from '../shared/semantic/artifact-delivery.mjs';
+import {
+  hasReplyReference,
+  promptContentForInboundMessage,
+} from '../shared/semantic/reply-reference.mjs';
 import {
   createDeliveryReceipt,
 } from '../shared/semantic/delivery.mjs';
@@ -68,7 +71,7 @@ function helpText() {
     t('/new  开启一个全新会话'),
     t('/compact  压缩当前会话的较早上下文'),
     t('/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）'),
-    t('/workspace 工作区绝对路径  切换工作区'),
+    t('/workspace 工作区序号或绝对路径  切换工作区'),
     t('/workspacelist  列出工作区绝对路径'),
     t('/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题'),
     t('/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话'),
@@ -108,8 +111,7 @@ function conversationKey(frame) {
   return body.chattype === 'group' ? `group:${body.chatid}` : `direct:${body.from?.userid}`;
 }
 
-function messageText(frame) {
-  const body = bodyOf(frame);
+function messageContentText(body) {
   let text = '';
   if (body.msgtype === 'text') {
     text = typeof body.text?.content === 'string' ? body.text.content.trim() : '';
@@ -122,6 +124,12 @@ function messageText(frame) {
       .join('\n')
       .trim();
   }
+  return text;
+}
+
+function messageText(frame) {
+  const body = bodyOf(frame);
+  const text = messageContentText(body);
   // Group callbacks retain the leading @bot mention that caused delivery.
   // It is routing metadata rather than part of the user's prompt or answer.
   return body.chattype === 'group'
@@ -145,6 +153,36 @@ function fileContents(frame) {
     : [];
 }
 
+function quoteAttachments(quote) {
+  if (quote?.msgtype === 'image') return [{ kind: 'image' }];
+  if (quote?.msgtype === 'voice') return [{ kind: 'audio' }];
+  if (quote?.msgtype === 'file') {
+    const name = nonEmptyString(
+      quote.file?.filename ?? quote.file?.file_name ?? quote.file?.name,
+    );
+    return [{ kind: 'file', ...(name ? { name } : {}) }];
+  }
+  if (quote?.msgtype !== 'mixed' || !Array.isArray(quote.mixed?.msg_item)) return [];
+  return quote.mixed.msg_item
+    .filter((item) => item?.msgtype === 'image')
+    .map(() => ({ kind: 'image' }));
+}
+
+function replyReferenceForBody(body) {
+  const quote = body?.quote;
+  if (!quote || typeof quote !== 'object') return null;
+  const content = messageContentText(quote);
+  const attachments = quoteAttachments(quote);
+  const supported = ['text', 'image', 'mixed', 'voice', 'file'].includes(quote.msgtype);
+  return {
+    ...(content ? { content } : {}),
+    ...(attachments.length > 0 ? { attachments } : {}),
+    ...(!content && attachments.length === 0
+      ? { unavailableReason: supported ? 'not-delivered' : 'unsupported' }
+      : {}),
+  };
+}
+
 function imageSource(client, image) {
   const url = nonEmptyString(image?.url);
   if (!url) return null;
@@ -200,10 +238,13 @@ function fileSource(client, file) {
 }
 
 export function wecomInboundMessage(frame, client) {
+  const body = bodyOf(frame);
+  const replyTo = replyReferenceForBody(body);
   return {
     content: messageText(frame),
     images: imageContents(frame).map((image) => imageSource(client, image)).filter(Boolean),
     files: fileContents(frame).map((file) => fileSource(client, file)).filter(Boolean),
+    ...(replyTo ? { replyTo } : {}),
   };
 }
 
@@ -604,7 +645,7 @@ export class WecomHarnessBridge {
         && (this.#queues.has(key) || pending || this.#approvals.hasPending(key))
         ? { handled: true, kind: 'busy', message: batchInputBusyMessage() }
         : this.#batchInputs.handle(key, commandText, {
-            plainText: isNativeWecomText(frame),
+            plainText: isNativeWecomText(frame) && !hasReplyReference(commandMessage),
           });
       if (result.handled) {
         if (result.kind === 'submit') {
@@ -934,6 +975,7 @@ export class WecomHarnessBridge {
     const text = message.content;
     const hasImages = hasInboundImages(message);
     const hasFiles = hasInboundFiles(message);
+    const hasReply = hasReplyReference(message);
     const key = conversationKey(frame);
     let streamId = null;
     let streamStarted = false;
@@ -942,7 +984,7 @@ export class WecomHarnessBridge {
     let batchSettled = batchSubmission === null;
     let promptRecorded = false;
     try {
-      if (!text && !hasImages && !hasFiles) {
+      if (!text && !hasImages && !hasFiles && !hasReply) {
         await this.#sendImmediate(frame, chatId, t('目前支持文字、图片、文件和语音转写消息。'));
         await this.#state.markSeen(messageId);
         return;
@@ -1003,15 +1045,18 @@ export class WecomHarnessBridge {
         this.#logger.warn?.('[dsh-im:wecom] unable to start a stream; using an active reply:', error);
       }
 
-      let content = hasImages
-        ? await promptContentForMessage(message, { signal: this.#signal })
+      let content = hasImages || hasReply
+        ? await promptContentForInboundMessage(message, { signal: this.#signal })
         : undefined;
       const snapshot = this.#acceptedMessageIds.get(messageId);
+      let contextEnhanced = false;
       if (snapshot) {
-        content = enhanceContextContent(content ?? text, snapshot, () => ({
+        const originalContent = content ?? text;
+        content = enhanceContextContent(originalContent, snapshot, () => ({
           channel: 'wecom',
           senderId,
         }));
+        contextEnhanced = content !== originalContent;
       }
       await this.#state.markSeen(messageId);
       promptRecorded = true;
@@ -1021,6 +1066,7 @@ export class WecomHarnessBridge {
         key,
         text,
         content,
+        contextEnhanced,
         createOptions: { signal: this.#signal },
         existsOptions: { signal: this.#signal },
         askOptions: {

package/src/channels/weixin/state-store.mjs

@@ -1,13 +1,67 @@
 import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 
+import { weixinMessageTimestampMs } from './weixin-api.mjs';
+
 const EMPTY_STATE = Object.freeze({
   version: 1,
   sessions: {},
   seenMessageIds: [],
   getUpdatesBuf: '',
+  recentOutboundMessages: [],
 });
 
+export const WEIXIN_RECENT_OUTBOUND_LIMIT = 200;
+export const WEIXIN_RECENT_OUTBOUND_TTL_MS = 30 * 24 * 60 * 60 * 1_000;
+export const WEIXIN_RECENT_OUTBOUND_TEXT_LIMIT = 8_000;
+export const WEIXIN_RECENT_OUTBOUND_MATCH_TOLERANCE_MS = 15_000;
+
+function nonEmptyString(value) {
+  return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+
+function timestamp(value) {
+  const number = typeof value === 'string' && value.trim() ? Number(value) : value;
+  return Number.isFinite(number) && number >= 0 ? Math.trunc(number) : null;
+}
+
+function providerMessageIds(value) {
+  if (!Array.isArray(value)) return [];
+  return [...new Set(value
+    .map((id) => (id === undefined || id === null ? null : nonEmptyString(String(id))))
+    .filter(Boolean))];
+}
+
+function truncateText(value) {
+  const text = nonEmptyString(value);
+  return text ? [...text].slice(0, WEIXIN_RECENT_OUTBOUND_TEXT_LIMIT).join('') : null;
+}
+
+function normalizeRecentOutboundMessage(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return null;
+  const toUserId = nonEmptyString(value.toUserId);
+  const text = truncateText(value.text);
+  const sentAt = timestamp(value.sentAt);
+  const completedAt = timestamp(value.completedAt) ?? sentAt;
+  if (!toUserId || !text || sentAt === null || completedAt === null) return null;
+  return {
+    toUserId,
+    text,
+    sentAt,
+    completedAt: Math.max(sentAt, completedAt),
+    providerMessageIds: providerMessageIds(value.providerMessageIds),
+  };
+}
+
+function recentOutboundMessages(value, now = Date.now()) {
+  if (!Array.isArray(value)) return [];
+  const cutoff = now - WEIXIN_RECENT_OUTBOUND_TTL_MS;
+  return value
+    .map(normalizeRecentOutboundMessage)
+    .filter((entry) => entry && entry.completedAt >= cutoff)
+    .slice(-WEIXIN_RECENT_OUTBOUND_LIMIT);
+}
+
 function normalizeState(value) {
   if (!value || typeof value !== 'object') return structuredClone(EMPTY_STATE);
   const sessions = {};
@@ -25,6 +79,7 @@ function normalizeState(value) {
       ? value.seenMessageIds.filter((id) => typeof id === 'string').slice(-1_000)
       : [],
     getUpdatesBuf: typeof value.getUpdatesBuf === 'string' ? value.getUpdatesBuf : '',
+    recentOutboundMessages: recentOutboundMessages(value.recentOutboundMessages),
   };
 }
 
@@ -90,6 +145,61 @@ export class WeixinStateStore {
     await this.#persist();
   }
 
+  async rememberOutboundMessage({
+    toUserId,
+    text,
+    sentAt = Date.now(),
+    completedAt = Date.now(),
+    providerMessageIds: messageIds = [],
+  } = {}) {
+    const entry = normalizeRecentOutboundMessage({
+      toUserId,
+      text,
+      sentAt,
+      completedAt,
+      providerMessageIds: messageIds,
+    });
+    if (!entry) throw new TypeError('Invalid Weixin outbound message');
+    this.#state.recentOutboundMessages = recentOutboundMessages([
+      ...this.#state.recentOutboundMessages,
+      entry,
+    ]);
+    await this.#persist();
+  }
+
+  recentOutboundTextFor({
+    toUserId,
+    messageId,
+    createTimeMs,
+    updateTimeMs,
+    now = Date.now(),
+  } = {}) {
+    const recipient = nonEmptyString(toUserId);
+    if (!recipient) return null;
+    const active = recentOutboundMessages(this.#state.recentOutboundMessages, now)
+      .filter((entry) => entry.toUserId === recipient);
+    const quotedMessageId = messageId === undefined || messageId === null
+      ? null
+      : nonEmptyString(String(messageId));
+    if (quotedMessageId) {
+      const exact = active.filter((entry) => entry.providerMessageIds.includes(quotedMessageId));
+      if (exact.length === 1) return exact[0].text;
+      if (exact.length > 1) return null;
+    }
+    const quotedTimes = [
+      timestamp(createTimeMs),
+      timestamp(updateTimeMs),
+      weixinMessageTimestampMs(quotedMessageId, { now }),
+    ]
+      .filter((value) => value !== null);
+    if (quotedTimes.length === 0) return null;
+    const candidates = active.filter((entry) => quotedTimes.some((quotedAt) => (
+      quotedAt >= entry.sentAt - WEIXIN_RECENT_OUTBOUND_MATCH_TOLERANCE_MS
+        && quotedAt <= entry.completedAt + WEIXIN_RECENT_OUTBOUND_MATCH_TOLERANCE_MS
+    )));
+    return candidates.length === 1 ? candidates[0].text : null;
+  }
+
   snapshot() {
     return structuredClone(this.#state);
   }

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

@@ -21,6 +21,9 @@ const ILINK_CLIENT_VERSION = (2 << 16) | (4 << 8) | 6;
 const DEFAULT_TIMEOUT_MS = 15_000;
 const DEFAULT_LONG_POLL_TIMEOUT_MS = 35_000;
 const WEIXIN_CDN_UPLOAD_RETRIES = 3;
+const WEIXIN_MESSAGE_ID_TIMESTAMP_SHIFT = 22n;
+const WEIXIN_MESSAGE_ID_MIN_TIMESTAMP_MS = Date.UTC(2020, 0, 1);
+const WEIXIN_MESSAGE_ID_MAX_FUTURE_MS = 24 * 60 * 60 * 1_000;
 const LOGIN_STATUSES = new Set([
   'wait',
   'scaned',
@@ -689,6 +692,7 @@ export function createWeixinApi({ fetchImpl = fetch } = {}) {
       const recipient = nonEmptyString(toUserId);
       const content = nonEmptyString(text);
       if (!recipient || !content) throw new TypeError('toUserId and text are required');
+      const clientId = `dsh-weixin-${randomUUID()}`;
       const response = await requestJson(fetchImpl, {
         method: 'POST',
         baseUrl,
@@ -699,7 +703,7 @@ export function createWeixinApi({ fetchImpl = fetch } = {}) {
           msg: {
             from_user_id: '',
             to_user_id: recipient,
-            client_id: `dsh-weixin-${randomUUID()}`,
+            client_id: clientId,
             message_type: 2,
             message_state: 2,
             item_list: [{ type: 1, text_item: { text: content } }],
@@ -717,7 +721,10 @@ export function createWeixinApi({ fetchImpl = fetch } = {}) {
           { providerCode: sendRejection },
         );
       }
-      return true;
+      return {
+        ...(response && typeof response === 'object' ? response : {}),
+        providerMessageIds: [clientId],
+      };
     },
 
     async sendFile(request) {
@@ -791,6 +798,83 @@ export function extractWeixinText(message) {
   return null;
 }
 
+function weixinReplyAttachment(item) {
+  if (item?.type === 2 || (item?.image_item && typeof item.image_item === 'object')) {
+    return { kind: 'image' };
+  }
+  if (item?.type === 3 || (item?.voice_item && typeof item.voice_item === 'object')) {
+    return { kind: 'audio' };
+  }
+  if (item?.type === 4 || (item?.file_item && typeof item.file_item === 'object')) {
+    const name = nonEmptyString(item?.file_item?.file_name);
+    return { kind: 'file', ...(name ? { name } : {}) };
+  }
+  if (item?.type === 5 || (item?.video_item && typeof item.video_item === 'object')) {
+    return { kind: 'video' };
+  }
+  return null;
+}
+
+function weixinQuotedText(item) {
+  const text = nonEmptyString(item?.text_item?.text);
+  if (text) return text;
+  return nonEmptyString(item?.voice_item?.text);
+}
+
+/** Extract the one-level reply snapshot embedded in an inbound iLink message item. */
+export function extractWeixinReplyReference(message, { resolveContent, loadContent } = {}) {
+  const container = (message?.item_list ?? []).find((item) => (
+    item?.ref_msg && typeof item.ref_msg === 'object'
+  ));
+  if (!container) return null;
+  const ref = container.ref_msg;
+  const quotedItem = ref.message_item && typeof ref.message_item === 'object'
+    ? ref.message_item
+    : null;
+  const quotedText = weixinQuotedText(quotedItem);
+  let content = quotedText ?? nonEmptyString(ref.title);
+  const attachment = weixinReplyAttachment(quotedItem);
+  const messageId = quotedItem?.msg_id === undefined || quotedItem?.msg_id === null
+    ? null
+    : nonEmptyString(String(quotedItem.msg_id));
+  const referenceDetails = {
+    messageId,
+    createTimeMs: quotedItem?.create_time_ms ?? ref.create_time_ms,
+    updateTimeMs: quotedItem?.update_time_ms ?? ref.update_time_ms,
+  };
+  if (!content && !attachment && typeof resolveContent === 'function') {
+    content = nonEmptyString(resolveContent(referenceDetails));
+  }
+  const load = !content && !attachment && typeof loadContent === 'function'
+    ? (options) => loadContent(referenceDetails, options)
+    : null;
+  const knownType = quotedItem && [1, 2, 3, 4, 5, 8].includes(quotedItem.type);
+  return {
+    ...(messageId ? { messageId } : {}),
+    ...(content ? { content } : {}),
+    ...(attachment ? { attachments: [attachment] } : {}),
+    ...(load ? { load } : {}),
+    ...(!content && !attachment && !load
+      ? { unavailableReason: quotedItem && !knownType ? 'unsupported' : 'not-delivered' }
+      : {}),
+  };
+}
+
+/** Decode the millisecond timestamp carried by current 64-bit iLink message IDs. */
+export function weixinMessageTimestampMs(messageId, { now = Date.now() } = {}) {
+  const value = messageId === undefined || messageId === null ? '' : String(messageId).trim();
+  if (!/^\d{16,20}$/u.test(value)) return null;
+  try {
+    const timestampMs = Number(BigInt(value) >> WEIXIN_MESSAGE_ID_TIMESTAMP_SHIFT);
+    if (!Number.isSafeInteger(timestampMs)
+      || timestampMs < WEIXIN_MESSAGE_ID_MIN_TIMESTAMP_MS
+      || timestampMs > now + WEIXIN_MESSAGE_ID_MAX_FUTURE_MS) return null;
+    return timestampMs;
+  } catch {
+    return null;
+  }
+}
+
 export function weixinMessageId(message) {
   if (message?.message_id !== undefined && message.message_id !== null) {
     return String(message.message_id);