@qqbrowser/openclaw-qbot 0.0.127 → 0.0.129

package/extensions/openclaw-weixin/src/media/media-download.ts

@@ -1,138 +0,0 @@
-import type { WeixinMessage } from "../api/types.js";
-import { MessageItemType } from "../api/types.js";
-import { downloadAndDecryptBuffer, downloadPlainCdnBuffer } from "../cdn/pic-decrypt.js";
-import type { WeixinInboundMediaOpts } from "../messaging/inbound.js";
-import { logger } from "../util/logger.js";
-import { getMimeFromFilename } from "./mime.js";
-import { silkToWav } from "./silk-transcode.js";
-
-const WEIXIN_MEDIA_MAX_BYTES = 100 * 1024 * 1024;
-
-/** Persist a buffer via the framework's unified media store. */
-type SaveMediaFn = (
-  buffer: Buffer,
-  contentType?: string,
-  subdir?: string,
-  maxBytes?: number,
-  originalFilename?: string,
-) => Promise<{ path: string }>;
-
-/**
- * Download and decrypt media from a single MessageItem.
- * Returns the populated WeixinInboundMediaOpts fields; empty object on unsupported type or failure.
- */
-export async function downloadMediaFromItem(
-  item: WeixinMessage["item_list"] extends (infer T)[] | undefined ? T : never,
-  deps: {
-    cdnBaseUrl: string;
-    saveMedia: SaveMediaFn;
-    log: (msg: string) => void;
-    errLog: (msg: string) => void;
-    label: string;
-  },
-): Promise<WeixinInboundMediaOpts> {
-  const { cdnBaseUrl, saveMedia, log, errLog, label } = deps;
-  const result: WeixinInboundMediaOpts = {};
-
-  if (item.type === MessageItemType.IMAGE) {
-    const img = item.image_item;
-    if (!img?.media?.encrypt_query_param) return result;
-    const aesKeyBase64 = img.aeskey
-      ? Buffer.from(img.aeskey, "hex").toString("base64")
-      : img.media.aes_key;
-    logger.debug(
-      `${label} image: encrypt_query_param=${img.media.encrypt_query_param.slice(0, 40)}... hasAesKey=${Boolean(aesKeyBase64)} aeskeySource=${img.aeskey ? "image_item.aeskey" : "media.aes_key"}`,
-    );
-    try {
-      const buf = aesKeyBase64
-        ? await downloadAndDecryptBuffer(
-            img.media.encrypt_query_param,
-            aesKeyBase64,
-            cdnBaseUrl,
-            `${label} image`,
-          )
-        : await downloadPlainCdnBuffer(
-            img.media.encrypt_query_param,
-            cdnBaseUrl,
-            `${label} image-plain`,
-          );
-      const saved = await saveMedia(buf, undefined, "inbound", WEIXIN_MEDIA_MAX_BYTES);
-      result.decryptedPicPath = saved.path;
-      logger.debug(`${label} image saved: ${saved.path}`);
-    } catch (err) {
-      logger.error(`${label} image download/decrypt failed: ${String(err)}`);
-      errLog(`weixin ${label} image download/decrypt failed: ${String(err)}`);
-    }
-  } else if (item.type === MessageItemType.VOICE) {
-    const voice = item.voice_item;
-    if (!voice?.media?.encrypt_query_param || !voice.media.aes_key) return result;
-    try {
-      const silkBuf = await downloadAndDecryptBuffer(
-        voice.media.encrypt_query_param,
-        voice.media.aes_key,
-        cdnBaseUrl,
-        `${label} voice`,
-      );
-      logger.debug(`${label} voice: decrypted ${silkBuf.length} bytes, attempting silk transcode`);
-      const wavBuf = await silkToWav(silkBuf);
-      if (wavBuf) {
-        const saved = await saveMedia(wavBuf, "audio/wav", "inbound", WEIXIN_MEDIA_MAX_BYTES);
-        result.decryptedVoicePath = saved.path;
-        result.voiceMediaType = "audio/wav";
-        logger.debug(`${label} voice: saved WAV to ${saved.path}`);
-      } else {
-        const saved = await saveMedia(silkBuf, "audio/silk", "inbound", WEIXIN_MEDIA_MAX_BYTES);
-        result.decryptedVoicePath = saved.path;
-        result.voiceMediaType = "audio/silk";
-        logger.debug(`${label} voice: silk transcode unavailable, saved raw SILK to ${saved.path}`);
-      }
-    } catch (err) {
-      logger.error(`${label} voice download/transcode failed: ${String(err)}`);
-      errLog(`weixin ${label} voice download/transcode failed: ${String(err)}`);
-    }
-  } else if (item.type === MessageItemType.FILE) {
-    const fileItem = item.file_item;
-    if (!fileItem?.media?.encrypt_query_param || !fileItem.media.aes_key) return result;
-    try {
-      const buf = await downloadAndDecryptBuffer(
-        fileItem.media.encrypt_query_param,
-        fileItem.media.aes_key,
-        cdnBaseUrl,
-        `${label} file`,
-      );
-      const mime = getMimeFromFilename(fileItem.file_name ?? "file.bin");
-      const saved = await saveMedia(
-        buf,
-        mime,
-        "inbound",
-        WEIXIN_MEDIA_MAX_BYTES,
-        fileItem.file_name ?? undefined,
-      );
-      result.decryptedFilePath = saved.path;
-      result.fileMediaType = mime;
-      logger.debug(`${label} file: saved to ${saved.path} mime=${mime}`);
-    } catch (err) {
-      logger.error(`${label} file download failed: ${String(err)}`);
-      errLog(`weixin ${label} file download failed: ${String(err)}`);
-    }
-  } else if (item.type === MessageItemType.VIDEO) {
-    const videoItem = item.video_item;
-    if (!videoItem?.media?.encrypt_query_param || !videoItem.media.aes_key) return result;
-    try {
-      const buf = await downloadAndDecryptBuffer(
-        videoItem.media.encrypt_query_param,
-        videoItem.media.aes_key,
-        cdnBaseUrl,
-        `${label} video`,
-      );
-      const saved = await saveMedia(buf, "video/mp4", "inbound", WEIXIN_MEDIA_MAX_BYTES);
-      result.decryptedVideoPath = saved.path;
-      logger.debug(`${label} video: saved to ${saved.path}`);
-    } catch (err) {
-      logger.error(`${label} video download failed: ${String(err)}`);
-      errLog(`weixin ${label} video download failed: ${String(err)}`);
-    }
-  }
-
-  return result;
-}

package/extensions/openclaw-weixin/src/media/mime.ts

@@ -1,76 +0,0 @@
-import path from "node:path";
-
-const EXTENSION_TO_MIME: Record<string, string> = {
-  ".pdf": "application/pdf",
-  ".doc": "application/msword",
-  ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-  ".xls": "application/vnd.ms-excel",
-  ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-  ".ppt": "application/vnd.ms-powerpoint",
-  ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
-  ".txt": "text/plain",
-  ".csv": "text/csv",
-  ".zip": "application/zip",
-  ".tar": "application/x-tar",
-  ".gz": "application/gzip",
-  ".mp3": "audio/mpeg",
-  ".ogg": "audio/ogg",
-  ".wav": "audio/wav",
-  ".mp4": "video/mp4",
-  ".mov": "video/quicktime",
-  ".webm": "video/webm",
-  ".mkv": "video/x-matroska",
-  ".avi": "video/x-msvideo",
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".webp": "image/webp",
-  ".bmp": "image/bmp",
-};
-
-const MIME_TO_EXTENSION: Record<string, string> = {
-  "image/jpeg": ".jpg",
-  "image/jpg": ".jpg",
-  "image/png": ".png",
-  "image/gif": ".gif",
-  "image/webp": ".webp",
-  "image/bmp": ".bmp",
-  "video/mp4": ".mp4",
-  "video/quicktime": ".mov",
-  "video/webm": ".webm",
-  "video/x-matroska": ".mkv",
-  "video/x-msvideo": ".avi",
-  "audio/mpeg": ".mp3",
-  "audio/ogg": ".ogg",
-  "audio/wav": ".wav",
-  "application/pdf": ".pdf",
-  "application/zip": ".zip",
-  "application/x-tar": ".tar",
-  "application/gzip": ".gz",
-  "text/plain": ".txt",
-  "text/csv": ".csv",
-};
-
-/** Get MIME type from filename extension. Returns "application/octet-stream" for unknown extensions. */
-export function getMimeFromFilename(filename: string): string {
-  const ext = path.extname(filename).toLowerCase();
-  return EXTENSION_TO_MIME[ext] ?? "application/octet-stream";
-}
-
-/** Get file extension from MIME type. Returns ".bin" for unknown types. */
-export function getExtensionFromMime(mimeType: string): string {
-  const ct = mimeType.split(";")[0].trim().toLowerCase();
-  return MIME_TO_EXTENSION[ct] ?? ".bin";
-}
-
-/** Get file extension from Content-Type header or URL path. Returns ".bin" for unknown. */
-export function getExtensionFromContentTypeOrUrl(contentType: string | null, url: string): string {
-  if (contentType) {
-    const ext = getExtensionFromMime(contentType);
-    if (ext !== ".bin") return ext;
-  }
-  const ext = path.extname(new URL(url).pathname).toLowerCase();
-  const knownExts = new Set(Object.keys(EXTENSION_TO_MIME));
-  return knownExts.has(ext) ? ext : ".bin";
-}

package/extensions/openclaw-weixin/src/media/silk-transcode.ts

@@ -1,74 +0,0 @@
-import { logger } from "../util/logger.js";
-
-/** Default sample rate for Weixin voice messages. */
-const SILK_SAMPLE_RATE = 24_000;
-
-/**
- * Wrap raw pcm_s16le bytes in a WAV container.
- * Mono channel, 16-bit signed little-endian.
- */
-function pcmBytesToWav(pcm: Uint8Array, sampleRate: number): Buffer {
-  const pcmBytes = pcm.byteLength;
-  const totalSize = 44 + pcmBytes;
-  const buf = Buffer.allocUnsafe(totalSize);
-  let offset = 0;
-
-  buf.write("RIFF", offset);
-  offset += 4;
-  buf.writeUInt32LE(totalSize - 8, offset);
-  offset += 4;
-  buf.write("WAVE", offset);
-  offset += 4;
-
-  buf.write("fmt ", offset);
-  offset += 4;
-  buf.writeUInt32LE(16, offset);
-  offset += 4; // fmt chunk size
-  buf.writeUInt16LE(1, offset);
-  offset += 2; // PCM format
-  buf.writeUInt16LE(1, offset);
-  offset += 2; // mono
-  buf.writeUInt32LE(sampleRate, offset);
-  offset += 4;
-  buf.writeUInt32LE(sampleRate * 2, offset);
-  offset += 4; // byte rate (mono 16-bit)
-  buf.writeUInt16LE(2, offset);
-  offset += 2; // block align
-  buf.writeUInt16LE(16, offset);
-  offset += 2; // bits per sample
-
-  buf.write("data", offset);
-  offset += 4;
-  buf.writeUInt32LE(pcmBytes, offset);
-  offset += 4;
-
-  Buffer.from(pcm.buffer, pcm.byteOffset, pcm.byteLength).copy(buf, offset);
-
-  return buf;
-}
-
-/**
- * Try to transcode a SILK audio buffer to WAV using silk-wasm.
- * silk-wasm's decode() returns { data: Uint8Array (pcm_s16le), duration: number }.
- *
- * Returns a WAV Buffer on success, or null if silk-wasm is unavailable or decoding fails.
- * Callers should fall back to passing the raw SILK file when null is returned.
- */
-export async function silkToWav(silkBuf: Buffer): Promise<Buffer | null> {
-  try {
-    const { decode } = await import("silk-wasm");
-
-    logger.debug(`silkToWav: decoding ${silkBuf.length} bytes of SILK`);
-    const result = await decode(silkBuf, SILK_SAMPLE_RATE);
-    logger.debug(
-      `silkToWav: decoded duration=${result.duration}ms pcmBytes=${result.data.byteLength}`,
-    );
-
-    const wav = pcmBytesToWav(result.data, SILK_SAMPLE_RATE);
-    logger.debug(`silkToWav: WAV size=${wav.length}`);
-    return wav;
-  } catch (err) {
-    logger.warn(`silkToWav: transcode failed, will use raw silk err=${String(err)}`);
-    return null;
-  }
-}

package/extensions/openclaw-weixin/src/messaging/debug-mode.ts

@@ -1,68 +0,0 @@
-/**
- * Per-bot debug mode toggle, persisted to disk so it survives gateway restarts.
- *
- * State file: `<stateDir>/openclaw-weixin/debug-mode.json`
- * Format:     `{ "accounts": { "<accountId>": true, ... } }`
- *
- * When enabled, processOneMessage appends a timing summary after each
- * AI reply is delivered to the user.
- */
-import fs from "node:fs";
-import path from "node:path";
-import { resolveStateDir } from "../storage/state-dir.js";
-import { logger } from "../util/logger.js";
-
-interface DebugModeState {
-  accounts: Record<string, boolean>;
-}
-
-function resolveDebugModePath(): string {
-  return path.join(resolveStateDir(), "openclaw-weixin", "debug-mode.json");
-}
-
-function loadState(): DebugModeState {
-  try {
-    const raw = fs.readFileSync(resolveDebugModePath(), "utf-8");
-    const parsed = JSON.parse(raw) as DebugModeState;
-    if (parsed && typeof parsed.accounts === "object") return parsed;
-  } catch {
-    // missing or corrupt — start fresh
-  }
-  return { accounts: {} };
-}
-
-function saveState(state: DebugModeState): void {
-  const filePath = resolveDebugModePath();
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  fs.writeFileSync(filePath, JSON.stringify(state, null, 2), "utf-8");
-}
-
-/** Toggle debug mode for a bot account. Returns the new state. */
-export function toggleDebugMode(accountId: string): boolean {
-  const state = loadState();
-  const next = !state.accounts[accountId];
-  state.accounts[accountId] = next;
-  try {
-    saveState(state);
-  } catch (err) {
-    logger.error(`debug-mode: failed to persist state: ${String(err)}`);
-  }
-  return next;
-}
-
-/** Check whether debug mode is active for a bot account. */
-export function isDebugMode(accountId: string): boolean {
-  return loadState().accounts[accountId] === true;
-}
-
-/**
- * Reset internal state — only for tests.
- * @internal
- */
-export function _resetForTest(): void {
-  try {
-    fs.unlinkSync(resolveDebugModePath());
-  } catch {
-    // ignore if not present
-  }
-}

package/extensions/openclaw-weixin/src/messaging/error-notice.ts

@@ -1,36 +0,0 @@
-import { logger } from "../util/logger.js";
-import { sendMessageWeixin } from "./send.js";
-
-/**
- * Send a plain-text error notice back to the user.
- * Fire-and-forget: errors are logged but never thrown, so callers stay unaffected.
- * No-op when contextToken is absent (we have no conversation reference to reply into).
- */
-export async function sendWeixinErrorNotice(params: {
-  to: string;
-  contextToken: string | undefined;
-  message: string;
-  baseUrl: string;
-  token?: string;
-  errLog: (m: string) => void;
-}): Promise<void> {
-  if (!params.contextToken) {
-    logger.warn(
-      `sendWeixinErrorNotice: no contextToken for to=${params.to}, sending without context`,
-    );
-  }
-  try {
-    await sendMessageWeixin({
-      to: params.to,
-      text: params.message,
-      opts: {
-        baseUrl: params.baseUrl,
-        token: params.token,
-        contextToken: params.contextToken,
-      },
-    });
-    logger.debug(`sendWeixinErrorNotice: sent to=${params.to}`);
-  } catch (err) {
-    params.errLog(`[weixin] sendWeixinErrorNotice failed to=${params.to}: ${String(err)}`);
-  }
-}

package/extensions/openclaw-weixin/src/messaging/inbound.ts

@@ -1,283 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import type { WeixinMessage, MessageItem } from "../api/types.js";
-import { MessageItemType } from "../api/types.js";
-import { resolveStateDir } from "../storage/state-dir.js";
-import { logger } from "../util/logger.js";
-import { generateId } from "../util/random.js";
-
-// ---------------------------------------------------------------------------
-// Context token store (in-process cache + disk persistence)
-// ---------------------------------------------------------------------------
-
-/**
- * contextToken is issued per-message by the Weixin getupdates API and must
- * be echoed verbatim in every outbound send. The in-memory map is the primary
- * lookup; a disk-backed file per account ensures tokens survive gateway restarts.
- */
-const contextTokenStore = new Map<string, string>();
-
-/**
- * 已注销账号集合。logoutAccount 清除文件后，monitor 的 long-poll 循环可能仍在运行，
- * 会通过 setContextToken / persistContextTokens 重新创建已删除的文件。
- * 将已注销的 accountId 加入此集合后，后续写入操作会被跳过。
- */
-const loggedOutAccounts = new Set<string>();
-
-function contextTokenKey(accountId: string, userId: string): string {
-  return `${accountId}:${userId}`;
-}
-
-// ---------------------------------------------------------------------------
-// Disk persistence helpers
-// ---------------------------------------------------------------------------
-
-function resolveContextTokenFilePath(accountId: string): string {
-  return path.join(
-    resolveStateDir(),
-    "openclaw-weixin",
-    "accounts",
-    `${accountId}.context-tokens.json`,
-  );
-}
-
-/** Persist all context tokens for a given account to disk. */
-function persistContextTokens(accountId: string): void {
-  // 账号已注销，跳过写入，避免重新创建已删除的文件
-  if (loggedOutAccounts.has(accountId)) return;
-  const prefix = `${accountId}:`;
-  const tokens: Record<string, string> = {};
-  for (const [k, v] of contextTokenStore) {
-    if (k.startsWith(prefix)) {
-      tokens[k.slice(prefix.length)] = v;
-    }
-  }
-  const filePath = resolveContextTokenFilePath(accountId);
-  // 如果内存中该账号已无任何 token，则删除磁盘文件而非写入空对象，
-  // 避免 clearContextTokensForAccount 删除文件后被并发的消息处理重新创建。
-  if (Object.keys(tokens).length === 0) {
-    try {
-      if (fs.existsSync(filePath)) fs.unlinkSync(filePath);
-    } catch {
-      // ignore — file may already be removed
-    }
-    return;
-  }
-  try {
-    const dir = path.dirname(filePath);
-    fs.mkdirSync(dir, { recursive: true });
-    fs.writeFileSync(filePath, JSON.stringify(tokens, null, 0), "utf-8");
-  } catch (err) {
-    logger.warn(`persistContextTokens: failed to write ${filePath}: ${String(err)}`);
-  }
-}
-
-/**
- * Restore persisted context tokens for an account into the in-memory map.
- * Called once during gateway startAccount to survive restarts.
- */
-export function restoreContextTokens(accountId: string): void {
-  // 账号重新登录/启动时，清除注销标记
-  loggedOutAccounts.delete(accountId);
-  const filePath = resolveContextTokenFilePath(accountId);
-  try {
-    if (!fs.existsSync(filePath)) return;
-    const raw = fs.readFileSync(filePath, "utf-8");
-    const tokens = JSON.parse(raw) as Record<string, string>;
-    let count = 0;
-    for (const [userId, token] of Object.entries(tokens)) {
-      if (typeof token === "string" && token) {
-        contextTokenStore.set(contextTokenKey(accountId, userId), token);
-        count++;
-      }
-    }
-    logger.info(`restoreContextTokens: restored ${count} tokens for account=${accountId}`);
-  } catch (err) {
-    logger.warn(`restoreContextTokens: failed to read ${filePath}: ${String(err)}`);
-  }
-}
-
-/** Remove all context tokens for a given account (memory + disk). */
-export function clearContextTokensForAccount(accountId: string): void {
-  // 标记账号已注销，阻止后续 setContextToken / persistContextTokens 重新写入文件
-  loggedOutAccounts.add(accountId);
-  const prefix = `${accountId}:`;
-  for (const k of [...contextTokenStore.keys()]) {
-    if (k.startsWith(prefix)) {
-      contextTokenStore.delete(k);
-    }
-  }
-  const filePath = resolveContextTokenFilePath(accountId);
-  try {
-    if (fs.existsSync(filePath)) fs.unlinkSync(filePath);
-  } catch (err) {
-    logger.warn(`clearContextTokensForAccount: failed to remove ${filePath}: ${String(err)}`);
-  }
-  logger.info(`clearContextTokensForAccount: cleared tokens for account=${accountId}`);
-}
-
-/** Store a context token for a given account+user pair (memory + disk). */
-export function setContextToken(accountId: string, userId: string, token: string): void {
-  // 账号已注销，跳过写入
-  if (loggedOutAccounts.has(accountId)) return;
-  const k = contextTokenKey(accountId, userId);
-  logger.debug(`setContextToken: key=${k}`);
-  contextTokenStore.set(k, token);
-  persistContextTokens(accountId);
-}
-
-/** Retrieve the cached context token for a given account+user pair. */
-export function getContextToken(accountId: string, userId: string): string | undefined {
-  const k = contextTokenKey(accountId, userId);
-  const val = contextTokenStore.get(k);
-  logger.debug(
-    `getContextToken: key=${k} found=${val !== undefined} storeSize=${contextTokenStore.size}`,
-  );
-  return val;
-}
-
-/**
- * Find all accountIds that have an active contextToken for the given userId.
- * Used to infer the sending bot account from the recipient address when
- * accountId is not explicitly provided (e.g. cron delivery).
- *
- * Returns all matching accountIds (not just the first) so the caller can
- * detect ambiguity when multiple accounts have sessions with the same user.
- */
-export function findAccountIdsByContextToken(accountIds: string[], userId: string): string[] {
-  return accountIds.filter((id) => contextTokenStore.has(contextTokenKey(id, userId)));
-}
-
-// ---------------------------------------------------------------------------
-// Message ID generation
-// ---------------------------------------------------------------------------
-
-function generateMessageSid(): string {
-  return generateId("openclaw-weixin");
-}
-
-/** Inbound context passed to the OpenClaw core pipeline (matches MsgContext shape). */
-export type WeixinMsgContext = {
-  Body: string;
-  From: string;
-  To: string;
-  AccountId: string;
-  OriginatingChannel: "openclaw-weixin";
-  OriginatingTo: string;
-  MessageSid: string;
-  Timestamp?: number;
-  Provider: "openclaw-weixin";
-  ChatType: "direct";
-  /** Set by monitor after resolveAgentRoute so dispatchReplyFromConfig uses the correct session. */
-  SessionKey?: string;
-  context_token?: string;
-  MediaUrl?: string;
-  MediaPath?: string;
-  MediaType?: string;
-  /** Raw message body for framework command authorization. */
-  CommandBody?: string;
-  /** Whether the sender is authorized to execute slash commands. */
-  CommandAuthorized?: boolean;
-};
-
-/** Returns true if the message item is a media type (image, video, file, or voice). */
-export function isMediaItem(item: MessageItem): boolean {
-  return (
-    item.type === MessageItemType.IMAGE ||
-    item.type === MessageItemType.VIDEO ||
-    item.type === MessageItemType.FILE ||
-    item.type === MessageItemType.VOICE
-  );
-}
-
-function bodyFromItemList(itemList?: MessageItem[]): string {
-  if (!itemList?.length) return "";
-  for (const item of itemList) {
-    if (item.type === MessageItemType.TEXT && item.text_item?.text != null) {
-      const text = String(item.text_item.text);
-      const ref = item.ref_msg;
-      if (!ref) return text;
-      // Quoted media is passed as MediaPath; only include the current text as body.
-      if (ref.message_item && isMediaItem(ref.message_item)) return text;
-      // Build quoted context from both title and message_item content.
-      const parts: string[] = [];
-      if (ref.title) parts.push(ref.title);
-      if (ref.message_item) {
-        const refBody = bodyFromItemList([ref.message_item]);
-        if (refBody) parts.push(refBody);
-      }
-      if (!parts.length) return text;
-      return `[引用: ${parts.join(" | ")}]\n${text}`;
-    }
-    // 语音转文字：如果语音消息有 text 字段，直接使用文字内容
-    if (item.type === MessageItemType.VOICE && item.voice_item?.text) {
-      return item.voice_item.text;
-    }
-  }
-  return "";
-}
-
-export type WeixinInboundMediaOpts = {
-  /** Local path to decrypted image file. */
-  decryptedPicPath?: string;
-  /** Local path to transcoded/raw voice file (.wav or .silk). */
-  decryptedVoicePath?: string;
-  /** MIME type for the voice file (e.g. "audio/wav" or "audio/silk"). */
-  voiceMediaType?: string;
-  /** Local path to decrypted file attachment. */
-  decryptedFilePath?: string;
-  /** MIME type for the file attachment (guessed from file_name). */
-  fileMediaType?: string;
-  /** Local path to decrypted video file. */
-  decryptedVideoPath?: string;
-};
-
-/**
- * Convert a WeixinMessage from getUpdates to the inbound MsgContext for the core pipeline.
- * Media: only pass MediaPath (local file, after CDN download + decrypt).
- * We never pass MediaUrl — the upstream CDN URL is encrypted/auth-only.
- * Priority when multiple media types present: image > video > file > voice.
- */
-export function weixinMessageToMsgContext(
-  msg: WeixinMessage,
-  accountId: string,
-  opts?: WeixinInboundMediaOpts,
-): WeixinMsgContext {
-  const from_user_id = msg.from_user_id ?? "";
-  const ctx: WeixinMsgContext = {
-    Body: bodyFromItemList(msg.item_list),
-    From: from_user_id,
-    To: from_user_id,
-    AccountId: accountId,
-    OriginatingChannel: "openclaw-weixin",
-    OriginatingTo: from_user_id,
-    MessageSid: generateMessageSid(),
-    Timestamp: msg.create_time_ms,
-    Provider: "openclaw-weixin",
-    ChatType: "direct",
-  };
-  if (msg.context_token) {
-    ctx.context_token = msg.context_token;
-  }
-
-  if (opts?.decryptedPicPath) {
-    ctx.MediaPath = opts.decryptedPicPath;
-    ctx.MediaType = "image/*";
-  } else if (opts?.decryptedVideoPath) {
-    ctx.MediaPath = opts.decryptedVideoPath;
-    ctx.MediaType = "video/mp4";
-  } else if (opts?.decryptedFilePath) {
-    ctx.MediaPath = opts.decryptedFilePath;
-    ctx.MediaType = opts.fileMediaType ?? "application/octet-stream";
-  } else if (opts?.decryptedVoicePath) {
-    ctx.MediaPath = opts.decryptedVoicePath;
-    ctx.MediaType = opts.voiceMediaType ?? "audio/wav";
-  }
-
-  return ctx;
-}
-
-/** Extract the context_token from an inbound WeixinMsgContext. */
-export function getContextTokenFromMsgContext(ctx: WeixinMsgContext): string | undefined {
-  return ctx.context_token;
-}