@ecat/weixin-bot-cli 0.1.0

package/dist/messaging/debug-mode.js

@@ -0,0 +1,63 @@
+/**
+ * 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";
+function resolveDebugModePath() {
+    return path.join(resolveStateDir(), "openclaw-weixin", "debug-mode.json");
+}
+function loadState() {
+    try {
+        const raw = fs.readFileSync(resolveDebugModePath(), "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed.accounts === "object")
+            return parsed;
+    }
+    catch {
+        // missing or corrupt — start fresh
+    }
+    return { accounts: {} };
+}
+function saveState(state) {
+    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) {
+    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) {
+    return loadState().accounts[accountId] === true;
+}
+/**
+ * Reset internal state — only for tests.
+ * @internal
+ */
+export function _resetForTest() {
+    try {
+        fs.unlinkSync(resolveDebugModePath());
+    }
+    catch {
+        // ignore if not present
+    }
+}
+//# sourceMappingURL=debug-mode.js.map

package/dist/messaging/debug-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-mode.js","sourceRoot":"","sources":["../../src/messaging/debug-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAM3C,SAAS,oBAAoB;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,oBAAoB,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QACjD,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,SAAS,CAAC,KAAqB;IACtC,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;IACxC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC;QACH,SAAS,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,wCAAwC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAO,SAAS,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;AACH,CAAC"}

package/dist/messaging/inbound.d.ts

@@ -0,0 +1,69 @@
+import type { WeixinMessage, MessageItem } from "../api/types.js";
+/**
+ * Restore persisted context tokens for an account into the in-memory map.
+ * Called once during gateway startAccount to survive restarts.
+ */
+export declare function restoreContextTokens(accountId: string): void;
+/** Remove all context tokens for a given account (memory + disk). */
+export declare function clearContextTokensForAccount(accountId: string): void;
+/** Store a context token for a given account+user pair (memory + disk). */
+export declare function setContextToken(accountId: string, userId: string, token: string): void;
+/** Retrieve the cached context token for a given account+user pair. */
+export declare function getContextToken(accountId: string, userId: string): string | undefined;
+/**
+ * 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 declare function findAccountIdsByContextToken(accountIds: string[], userId: string): string[];
+/** 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 declare function isMediaItem(item: MessageItem): boolean;
+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 declare function weixinMessageToMsgContext(msg: WeixinMessage, accountId: string, opts?: WeixinInboundMediaOpts): WeixinMsgContext;
+/** Extract the context_token from an inbound WeixinMsgContext. */
+export declare function getContextTokenFromMsgContext(ctx: WeixinMsgContext): string | undefined;

package/dist/messaging/inbound.js

@@ -0,0 +1,201 @@
+import fs from "node:fs";
+import path from "node:path";
+import { logger } from "../util/logger.js";
+import { generateId } from "../util/random.js";
+import { MessageItemType } from "../api/types.js";
+import { resolveStateDir } from "../storage/state-dir.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();
+function contextTokenKey(accountId, userId) {
+    return `${accountId}:${userId}`;
+}
+// ---------------------------------------------------------------------------
+// Disk persistence helpers
+// ---------------------------------------------------------------------------
+function resolveContextTokenFilePath(accountId) {
+    return path.join(resolveStateDir(), "openclaw-weixin", "accounts", `${accountId}.context-tokens.json`);
+}
+/** Persist all context tokens for a given account to disk. */
+function persistContextTokens(accountId) {
+    const prefix = `${accountId}:`;
+    const tokens = {};
+    for (const [k, v] of contextTokenStore) {
+        if (k.startsWith(prefix)) {
+            tokens[k.slice(prefix.length)] = v;
+        }
+    }
+    const filePath = resolveContextTokenFilePath(accountId);
+    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) {
+    const filePath = resolveContextTokenFilePath(accountId);
+    try {
+        if (!fs.existsSync(filePath))
+            return;
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const tokens = JSON.parse(raw);
+        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) {
+    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, userId, token) {
+    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, userId) {
+    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, userId) {
+    return accountIds.filter((id) => contextTokenStore.has(contextTokenKey(id, userId)));
+}
+// ---------------------------------------------------------------------------
+// Message ID generation
+// ---------------------------------------------------------------------------
+function generateMessageSid() {
+    return generateId("openclaw-weixin");
+}
+/** Returns true if the message item is a media type (image, video, file, or voice). */
+export function isMediaItem(item) {
+    return (item.type === MessageItemType.IMAGE ||
+        item.type === MessageItemType.VIDEO ||
+        item.type === MessageItemType.FILE ||
+        item.type === MessageItemType.VOICE);
+}
+function bodyFromItemList(itemList) {
+    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 = [];
+            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 "";
+}
+/**
+ * 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, accountId, opts) {
+    const from_user_id = msg.from_user_id ?? "";
+    const ctx = {
+        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) {
+    return ctx.context_token;
+}
+//# sourceMappingURL=inbound.js.map

package/dist/messaging/inbound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.js","sourceRoot":"","sources":["../../src/messaging/inbound.ts"],"names":[],"mappings":"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"}

package/dist/messaging/send-media.d.ts

@@ -0,0 +1,21 @@
+import type { WeixinApiOptions } from "../api/api.js";
+/**
+ * Upload a local file and send it as a weixin message, routing by MIME type:
+ *   video/*  → uploadVideoToWeixin        + sendVideoMessageWeixin
+ *   image/*  → uploadFileToWeixin         + sendImageMessageWeixin
+ *   else     → uploadFileAttachmentToWeixin + sendFileMessageWeixin
+ *
+ * Used by both the auto-reply deliver path (monitor.ts) and the outbound
+ * sendMedia path (channel.ts) so they stay in sync.
+ */
+export declare function sendWeixinMediaFile(params: {
+    filePath: string;
+    to: string;
+    text: string;
+    opts: WeixinApiOptions & {
+        contextToken?: string;
+    };
+    cdnBaseUrl: string;
+}): Promise<{
+    messageId: string;
+}>;

package/dist/messaging/send-media.js

@@ -0,0 +1,54 @@
+import path from "node:path";
+import { logger } from "../util/logger.js";
+import { getMimeFromFilename } from "../media/mime.js";
+import { sendFileMessageWeixin, sendImageMessageWeixin, sendVideoMessageWeixin } from "./send.js";
+import { uploadFileAttachmentToWeixin, uploadFileToWeixin, uploadVideoToWeixin } from "../cdn/upload.js";
+/**
+ * Upload a local file and send it as a weixin message, routing by MIME type:
+ *   video/*  → uploadVideoToWeixin        + sendVideoMessageWeixin
+ *   image/*  → uploadFileToWeixin         + sendImageMessageWeixin
+ *   else     → uploadFileAttachmentToWeixin + sendFileMessageWeixin
+ *
+ * Used by both the auto-reply deliver path (monitor.ts) and the outbound
+ * sendMedia path (channel.ts) so they stay in sync.
+ */
+export async function sendWeixinMediaFile(params) {
+    const { filePath, to, text, opts, cdnBaseUrl } = params;
+    const mime = getMimeFromFilename(filePath);
+    const uploadOpts = { baseUrl: opts.baseUrl, token: opts.token };
+    if (mime.startsWith("video/")) {
+        logger.info(`[weixin] sendWeixinMediaFile: uploading video filePath=${filePath} to=${to}`);
+        const uploaded = await uploadVideoToWeixin({
+            filePath,
+            toUserId: to,
+            opts: uploadOpts,
+            cdnBaseUrl,
+        });
+        logger.info(`[weixin] sendWeixinMediaFile: video upload done filekey=${uploaded.filekey} size=${uploaded.fileSize}`);
+        return sendVideoMessageWeixin({ to, text, uploaded, opts });
+    }
+    if (mime.startsWith("image/")) {
+        logger.info(`[weixin] sendWeixinMediaFile: uploading image filePath=${filePath} to=${to}`);
+        const uploaded = await uploadFileToWeixin({
+            filePath,
+            toUserId: to,
+            opts: uploadOpts,
+            cdnBaseUrl,
+        });
+        logger.info(`[weixin] sendWeixinMediaFile: image upload done filekey=${uploaded.filekey} size=${uploaded.fileSize}`);
+        return sendImageMessageWeixin({ to, text, uploaded, opts });
+    }
+    // File attachment: pdf, doc, zip, etc.
+    const fileName = path.basename(filePath);
+    logger.info(`[weixin] sendWeixinMediaFile: uploading file attachment filePath=${filePath} name=${fileName} to=${to}`);
+    const uploaded = await uploadFileAttachmentToWeixin({
+        filePath,
+        fileName,
+        toUserId: to,
+        opts: uploadOpts,
+        cdnBaseUrl,
+    });
+    logger.info(`[weixin] sendWeixinMediaFile: file upload done filekey=${uploaded.filekey} size=${uploaded.fileSize}`);
+    return sendFileMessageWeixin({ to, text, fileName, uploaded, opts });
+}
+//# sourceMappingURL=send-media.js.map

package/dist/messaging/send-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-media.js","sourceRoot":"","sources":["../../src/messaging/send-media.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAClG,OAAO,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEzG;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAMzC;IACC,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IACxD,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAqB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAElF,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,0DAA0D,QAAQ,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3F,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC;YACzC,QAAQ;YACR,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,UAAU;YAChB,UAAU;SACX,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CACT,2DAA2D,QAAQ,CAAC,OAAO,SAAS,QAAQ,CAAC,QAAQ,EAAE,CACxG,CAAC;QACF,OAAO,sBAAsB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,0DAA0D,QAAQ,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3F,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;YACxC,QAAQ;YACR,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,UAAU;YAChB,UAAU;SACX,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CACT,2DAA2D,QAAQ,CAAC,OAAO,SAAS,QAAQ,CAAC,QAAQ,EAAE,CACxG,CAAC;QACF,OAAO,sBAAsB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,uCAAuC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,CAAC,IAAI,CACT,oEAAoE,QAAQ,SAAS,QAAQ,OAAO,EAAE,EAAE,CACzG,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC;QAClD,QAAQ;QACR,QAAQ;QACR,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,UAAU;QAChB,UAAU;KACX,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CACT,0DAA0D,QAAQ,CAAC,OAAO,SAAS,QAAQ,CAAC,QAAQ,EAAE,CACvG,CAAC;IACF,OAAO,qBAAqB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/messaging/send.d.ts

@@ -0,0 +1,70 @@
+export declare function stripMarkdown(str: string): string;
+import type { WeixinApiOptions } from "../api/api.js";
+import type { UploadedFileInfo } from "../cdn/upload.js";
+/**
+ * Convert markdown-formatted model reply to plain text for Weixin delivery.
+ * Preserves newlines; strips markdown syntax.
+ */
+export declare function markdownToPlainText(text: string): string;
+/**
+ * Send a plain text message downstream.
+ */
+export declare function sendMessageWeixin(params: {
+    to: string;
+    text: string;
+    opts: WeixinApiOptions & {
+        contextToken?: string;
+    };
+}): Promise<{
+    messageId: string;
+}>;
+/**
+ * Send an image message downstream using a previously uploaded file.
+ * Optionally include a text caption as a separate TEXT item before the image.
+ *
+ * ImageItem fields:
+ *   - media.encrypt_query_param: CDN download param
+ *   - media.aes_key: AES key, base64-encoded
+ *   - mid_size: original ciphertext file size
+ */
+export declare function sendImageMessageWeixin(params: {
+    to: string;
+    text: string;
+    uploaded: UploadedFileInfo;
+    opts: WeixinApiOptions & {
+        contextToken?: string;
+    };
+}): Promise<{
+    messageId: string;
+}>;
+/**
+ * Send a video message downstream using a previously uploaded file.
+ * VideoItem: media (CDN ref), video_size (ciphertext bytes).
+ * Includes an optional text caption sent as a separate TEXT item first.
+ */
+export declare function sendVideoMessageWeixin(params: {
+    to: string;
+    text: string;
+    uploaded: UploadedFileInfo;
+    opts: WeixinApiOptions & {
+        contextToken?: string;
+    };
+}): Promise<{
+    messageId: string;
+}>;
+/**
+ * Send a file attachment downstream using a previously uploaded file.
+ * FileItem: media (CDN ref), file_name, len (plaintext bytes as string).
+ * Includes an optional text caption sent as a separate TEXT item first.
+ */
+export declare function sendFileMessageWeixin(params: {
+    to: string;
+    text: string;
+    fileName: string;
+    uploaded: UploadedFileInfo;
+    opts: WeixinApiOptions & {
+        contextToken?: string;
+    };
+}): Promise<{
+    messageId: string;
+}>;