@pawastation/wechat-kf 0.1.1

package/dist/src/monitor.js

@@ -0,0 +1,131 @@
+/**
+ * Monitor — starts webhook server and manages lifecycle
+ *
+ * Single webhook server for the enterprise. KfIds are discovered dynamically
+ * from webhook callbacks. Polling fallback iterates all known kfids.
+ */
+import { getChannelConfig, getKnownKfIds, loadKfIds } from "./accounts.js";
+import { handleWebhookEvent } from "./bot.js";
+import { getAccessToken } from "./token.js";
+import { createWebhookServer } from "./webhook.js";
+export async function startMonitor(ctx) {
+    const { cfg, runtime, abortSignal, stateDir, log } = ctx;
+    // Guard: if signal is already aborted, skip all resource creation
+    if (abortSignal?.aborted) {
+        log?.info("[wechat-kf] abort signal already triggered, skipping monitor start");
+        // Return a dummy server that is not listening
+        const dummyServer = createWebhookServer({
+            port: 0,
+            path: "/",
+            callbackToken: "",
+            encodingAESKey: "",
+            corpId: "",
+            onEvent: async () => { },
+        });
+        return dummyServer;
+    }
+    const config = getChannelConfig(cfg);
+    const { corpId, appSecret, token, encodingAESKey } = config;
+    const webhookPort = config.webhookPort ?? 9999;
+    const webhookPath = config.webhookPath ?? "/wechat-kf";
+    if (!corpId || !appSecret || !token || !encodingAESKey) {
+        throw new Error("[wechat-kf] missing required config fields (corpId, appSecret, token, encodingAESKey)");
+    }
+    // Load previously discovered kfids
+    await loadKfIds(stateDir);
+    // Validate access token on startup
+    try {
+        await getAccessToken(corpId, appSecret);
+        log?.info(`[wechat-kf] access_token validated`);
+    }
+    catch (err) {
+        log?.warn?.(`[wechat-kf] access_token validation failed (will retry on first message): ${err}`);
+    }
+    const botCtx = { cfg, runtime, stateDir, log };
+    const server = createWebhookServer({
+        port: webhookPort,
+        path: webhookPath,
+        callbackToken: token,
+        encodingAESKey,
+        corpId,
+        onEvent: async (kfId, syncToken) => {
+            if (!kfId) {
+                log?.error("[wechat-kf] webhook callback missing OpenKfId, ignoring");
+                return;
+            }
+            try {
+                await handleWebhookEvent(botCtx, kfId, syncToken);
+            }
+            catch (err) {
+                log?.error(`[wechat-kf:${kfId}] event processing error: ${err}`);
+            }
+        },
+    });
+    await new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new Error(`[wechat-kf] server.listen(:${webhookPort}) timed out`)), 10_000);
+        const onError = (err) => {
+            clearTimeout(timeout);
+            reject(err);
+        };
+        server.once("error", onError);
+        server.listen(webhookPort, () => {
+            clearTimeout(timeout);
+            server.removeListener("error", onError);
+            log?.info(`[wechat-kf] webhook listening on :${webhookPort}${webhookPath}`);
+            resolve();
+        });
+    });
+    // ── Polling fallback ──
+    // Poll sync_msg for each known kfid as fallback
+    const POLL_INTERVAL_MS = 30000;
+    let pollTimer = null;
+    let polling = false;
+    pollTimer = setInterval(async () => {
+        if (abortSignal?.aborted)
+            return;
+        if (polling)
+            return;
+        polling = true;
+        try {
+            const kfIds = getKnownKfIds();
+            if (kfIds.length === 0) {
+                // No kfids discovered yet, nothing to poll
+                return;
+            }
+            for (const kfId of kfIds) {
+                if (abortSignal?.aborted)
+                    break;
+                try {
+                    log?.info(`[wechat-kf:${kfId}] polling sync_msg...`);
+                    await handleWebhookEvent(botCtx, kfId, "");
+                }
+                catch (err) {
+                    log?.error(`[wechat-kf:${kfId}] poll error: ${err instanceof Error ? err.stack || err.message : err}`);
+                }
+            }
+        }
+        finally {
+            polling = false;
+        }
+    }, POLL_INTERVAL_MS);
+    log?.info(`[wechat-kf] polling fallback enabled (every ${POLL_INTERVAL_MS}ms)`);
+    if (abortSignal) {
+        const cleanup = () => {
+            if (pollTimer) {
+                clearInterval(pollTimer);
+                pollTimer = null;
+            }
+            server.close();
+            log?.info("[wechat-kf] webhook server + polling stopped");
+        };
+        // Double-check: signal may have been aborted between the top guard and here
+        if (abortSignal.aborted) {
+            cleanup();
+        }
+        else {
+            abortSignal.addEventListener("abort", cleanup, { once: true });
+        }
+    }
+    return server;
+}
+//# sourceMappingURL=monitor.js.map

package/dist/src/monitor.js.map

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

package/dist/src/outbound.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Outbound message adapter for WeChat KF  (framework-driven direct delivery)
+ *
+ * Responsibility:
+ *   This module implements the OpenClaw `ChannelPlugin.outbound` interface and
+ *   is called by the framework when the agent produces a final reply.
+ *
+ *   Text chunking is handled by the framework itself via the declared `chunker`
+ *   function (P0-01), so `sendText` always receives a single pre-chunked piece.
+ *
+ *   For media, the file is read from disk (or downloaded from HTTP URL),
+ *   classified, uploaded to WeChat, and sent using the shared
+ *   `uploadAndSendMedia` helper from `send-utils.ts`.
+ *
+ * WeChat KF session limits:
+ *   The API enforces a 48-hour / 5-message limit per session window.
+ *   Once a customer sends a message, the agent may reply with up to 5 messages
+ *   within 48 hours.  After that, sending returns errcode 95026.
+ *   This module detects that error and logs a clear warning rather than
+ *   propagating a generic failure.
+ *
+ * Counterpart:
+ *   `reply-dispatcher.ts` handles the *other* outbound path: typing-aware
+ *   streaming replies dispatched internally by `bot.ts`.
+ *
+ * accountId = openKfId (dynamically discovered)
+ */
+import type { OpenClawConfig } from "./types.js";
+export type SendTextParams = {
+    cfg: OpenClawConfig;
+    to: string;
+    text: string;
+    accountId: string;
+};
+export type SendMediaParams = {
+    cfg: OpenClawConfig;
+    to: string;
+    text?: string;
+    mediaUrl?: string;
+    accountId: string;
+};
+export type SendResult = {
+    channel: string;
+    messageId: string;
+    chatId: string;
+};
+export type SendPayloadParams = {
+    cfg: OpenClawConfig;
+    to: string;
+    text?: string;
+    accountId: string;
+    payload: {
+        text?: string;
+        channelData?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+};
+export declare const wechatKfOutbound: {
+    deliveryMode: "direct";
+    chunker: (text: string, limit: number) => string[];
+    chunkerMode: "text";
+    textChunkLimit: number;
+    sendText: ({ cfg, to, text, accountId }: SendTextParams) => Promise<SendResult>;
+    sendMedia: ({ cfg, to, text, mediaUrl, accountId }: SendMediaParams) => Promise<SendResult>;
+    sendPayload: ({ cfg, to, text, accountId, payload }: SendPayloadParams) => Promise<SendResult>;
+};

package/dist/src/outbound.js

@@ -0,0 +1,234 @@
+/**
+ * Outbound message adapter for WeChat KF  (framework-driven direct delivery)
+ *
+ * Responsibility:
+ *   This module implements the OpenClaw `ChannelPlugin.outbound` interface and
+ *   is called by the framework when the agent produces a final reply.
+ *
+ *   Text chunking is handled by the framework itself via the declared `chunker`
+ *   function (P0-01), so `sendText` always receives a single pre-chunked piece.
+ *
+ *   For media, the file is read from disk (or downloaded from HTTP URL),
+ *   classified, uploaded to WeChat, and sent using the shared
+ *   `uploadAndSendMedia` helper from `send-utils.ts`.
+ *
+ * WeChat KF session limits:
+ *   The API enforces a 48-hour / 5-message limit per session window.
+ *   Once a customer sends a message, the agent may reply with up to 5 messages
+ *   within 48 hours.  After that, sending returns errcode 95026.
+ *   This module detects that error and logs a clear warning rather than
+ *   propagating a generic failure.
+ *
+ * Counterpart:
+ *   `reply-dispatcher.ts` handles the *other* outbound path: typing-aware
+ *   streaming replies dispatched internally by `bot.ts`.
+ *
+ * accountId = openKfId (dynamically discovered)
+ */
+import { readFile } from "node:fs/promises";
+import { extname } from "node:path";
+import { resolveAccount } from "./accounts.js";
+import { sendLinkMessage, sendTextMessage, uploadMedia } from "./api.js";
+import { chunkText } from "./chunk-utils.js";
+import { WECHAT_MSG_LIMIT_ERRCODE, WECHAT_TEXT_CHUNK_LIMIT } from "./constants.js";
+import { detectMediaType, downloadMediaFromUrl, formatText, uploadAndSendMedia } from "./send-utils.js";
+import { parseWechatLinkDirective } from "./wechat-kf-directives.js";
+/**
+ * Check whether an error indicates the WeChat 48h/5-message session limit.
+ * When detected, logs a warning and returns true so the caller can handle
+ * gracefully instead of throwing a generic error.
+ */
+function isSessionLimitError(err) {
+    if (err instanceof Error) {
+        return err.message.includes(String(WECHAT_MSG_LIMIT_ERRCODE));
+    }
+    return false;
+}
+export const wechatKfOutbound = {
+    deliveryMode: "direct",
+    chunker: (text, limit) => chunkText(text, limit),
+    chunkerMode: "text",
+    textChunkLimit: WECHAT_TEXT_CHUNK_LIMIT,
+    sendText: async ({ cfg, to, text, accountId }) => {
+        const account = resolveAccount(cfg, accountId);
+        const openKfId = account.openKfId ?? accountId;
+        if (!account.corpId || !account.appSecret || !openKfId) {
+            throw new Error("[wechat-kf] missing corpId/appSecret/openKfId");
+        }
+        const externalUserId = String(to).replace(/^user:/, "");
+        // ── Intercept [[wechat_link:...]] directives BEFORE formatText ──
+        // Parse on raw text so title/desc/url stay clean (formatText would
+        // convert markdown inside the directive to unicode characters).
+        const directive = parseWechatLinkDirective(text);
+        if (directive.link) {
+            try {
+                let thumbMediaId;
+                if (directive.link.thumbUrl) {
+                    const downloaded = await downloadMediaFromUrl(directive.link.thumbUrl);
+                    const uploaded = await uploadMedia(account.corpId, account.appSecret, "image", downloaded.buffer, downloaded.filename);
+                    thumbMediaId = uploaded.media_id;
+                }
+                // WeChat requires thumb_media_id for link cards — fall back to plain text if missing
+                if (!thumbMediaId) {
+                    const fallbackText = directive.text
+                        ? `${formatText(directive.text)}\n${directive.link.title}: ${directive.link.url}`
+                        : `${directive.link.title}: ${directive.link.url}`;
+                    const result = await sendTextMessage(account.corpId, account.appSecret, externalUserId, openKfId, fallbackText);
+                    return { channel: "wechat-kf", messageId: result.msgid, chatId: to };
+                }
+                const linkResult = await sendLinkMessage(account.corpId, account.appSecret, externalUserId, openKfId, {
+                    title: directive.link.title,
+                    desc: directive.link.desc,
+                    url: directive.link.url,
+                    thumb_media_id: thumbMediaId,
+                });
+                // Send remaining text if non-empty (apply formatText to surrounding text only)
+                if (directive.text) {
+                    await sendTextMessage(account.corpId, account.appSecret, externalUserId, openKfId, formatText(directive.text));
+                }
+                return { channel: "wechat-kf", messageId: linkResult.msgid, chatId: to };
+            }
+            catch (err) {
+                if (isSessionLimitError(err)) {
+                    console.error(`[wechat-kf] session limit exceeded (48h/5-msg) for user=${externalUserId} kf=${openKfId}. ` +
+                        `The customer must send a new message before more replies can be delivered.`);
+                }
+                throw err;
+            }
+        }
+        const formatted = formatText(text);
+        try {
+            const result = await sendTextMessage(account.corpId, account.appSecret, externalUserId, openKfId, formatted);
+            return { channel: "wechat-kf", messageId: result.msgid, chatId: to };
+        }
+        catch (err) {
+            if (isSessionLimitError(err)) {
+                console.error(`[wechat-kf] session limit exceeded (48h/5-msg) for user=${externalUserId} kf=${openKfId}. ` +
+                    `The customer must send a new message before more replies can be delivered.`);
+            }
+            throw err;
+        }
+    },
+    sendMedia: async ({ cfg, to, text, mediaUrl, accountId }) => {
+        const account = resolveAccount(cfg, accountId);
+        const openKfId = account.openKfId ?? accountId;
+        if (!account.corpId || !account.appSecret || !openKfId) {
+            throw new Error("[wechat-kf] missing corpId/appSecret/openKfId");
+        }
+        const externalUserId = String(to).replace(/^user:/, "");
+        // ── HTTP/HTTPS URL: download then upload ──
+        if (mediaUrl?.startsWith("http")) {
+            const downloaded = await downloadMediaFromUrl(mediaUrl);
+            const ext = downloaded.ext.toLowerCase();
+            const mediaType = detectMediaType(ext);
+            try {
+                const result = await uploadAndSendMedia(account.corpId, account.appSecret, externalUserId, openKfId, downloaded.buffer, downloaded.filename, mediaType);
+                if (text?.trim()) {
+                    await sendTextMessage(account.corpId, account.appSecret, externalUserId, openKfId, formatText(text));
+                }
+                return { channel: "wechat-kf", messageId: result.msgid, chatId: to };
+            }
+            catch (err) {
+                if (isSessionLimitError(err)) {
+                    console.error(`[wechat-kf] session limit exceeded (48h/5-msg) for user=${externalUserId} kf=${openKfId}. ` +
+                        `The customer must send a new message before more replies can be delivered.`);
+                }
+                throw err;
+            }
+        }
+        // ── Local file path: read then upload ──
+        if (mediaUrl) {
+            const buffer = await readFile(mediaUrl);
+            const ext = extname(mediaUrl).toLowerCase();
+            const mediaType = detectMediaType(ext);
+            const filename = mediaUrl.split("/").pop() || "file";
+            try {
+                const result = await uploadAndSendMedia(account.corpId, account.appSecret, externalUserId, openKfId, buffer, filename, mediaType);
+                if (text?.trim()) {
+                    await sendTextMessage(account.corpId, account.appSecret, externalUserId, openKfId, formatText(text));
+                }
+                return { channel: "wechat-kf", messageId: result.msgid, chatId: to };
+            }
+            catch (err) {
+                if (isSessionLimitError(err)) {
+                    console.error(`[wechat-kf] session limit exceeded (48h/5-msg) for user=${externalUserId} kf=${openKfId}. ` +
+                        `The customer must send a new message before more replies can be delivered.`);
+                }
+                throw err;
+            }
+        }
+        // ── No resolvable media: send as text ──
+        const content = text?.trim() ? `${text}\n${mediaUrl || ""}` : mediaUrl || text || "";
+        try {
+            const result = await sendTextMessage(account.corpId, account.appSecret, externalUserId, openKfId, content);
+            return { channel: "wechat-kf", messageId: result.msgid, chatId: to };
+        }
+        catch (err) {
+            if (isSessionLimitError(err)) {
+                console.error(`[wechat-kf] session limit exceeded (48h/5-msg) for user=${externalUserId} kf=${openKfId}. ` +
+                    `The customer must send a new message before more replies can be delivered.`);
+            }
+            throw err;
+        }
+    },
+    sendPayload: async ({ cfg, to, text, accountId, payload }) => {
+        const account = resolveAccount(cfg, accountId);
+        const openKfId = account.openKfId ?? accountId;
+        if (!account.corpId || !account.appSecret || !openKfId) {
+            throw new Error("[wechat-kf] missing corpId/appSecret/openKfId");
+        }
+        const externalUserId = String(to).replace(/^user:/, "");
+        const wechatKf = payload.channelData?.wechatKf;
+        const link = wechatKf?.link;
+        if (link) {
+            let thumbMediaId = link.thumb_media_id;
+            // Download and upload thumbnail if only URL is provided
+            if (!thumbMediaId && link.thumbUrl) {
+                const downloaded = await downloadMediaFromUrl(link.thumbUrl);
+                const uploaded = await uploadMedia(account.corpId, account.appSecret, "image", downloaded.buffer, downloaded.filename);
+                thumbMediaId = uploaded.media_id;
+            }
+            if (!thumbMediaId) {
+                throw new Error("[wechat-kf] sendPayload link requires thumb_media_id or thumbUrl");
+            }
+            try {
+                const result = await sendLinkMessage(account.corpId, account.appSecret, externalUserId, openKfId, {
+                    title: link.title,
+                    desc: link.desc,
+                    url: link.url,
+                    thumb_media_id: thumbMediaId,
+                });
+                // Send accompanying text if present
+                if ((text ?? payload.text)?.trim()) {
+                    const textContent = (text ?? payload.text);
+                    await sendTextMessage(account.corpId, account.appSecret, externalUserId, openKfId, formatText(textContent));
+                }
+                return { channel: "wechat-kf", messageId: result.msgid, chatId: to };
+            }
+            catch (err) {
+                if (isSessionLimitError(err)) {
+                    console.error(`[wechat-kf] session limit exceeded (48h/5-msg) for user=${externalUserId} kf=${openKfId}. ` +
+                        `The customer must send a new message before more replies can be delivered.`);
+                }
+                throw err;
+            }
+        }
+        // No link data — fall back to sending text
+        const textContent = text ?? payload.text ?? "";
+        if (textContent.trim()) {
+            try {
+                const result = await sendTextMessage(account.corpId, account.appSecret, externalUserId, openKfId, formatText(textContent));
+                return { channel: "wechat-kf", messageId: result.msgid, chatId: to };
+            }
+            catch (err) {
+                if (isSessionLimitError(err)) {
+                    console.error(`[wechat-kf] session limit exceeded (48h/5-msg) for user=${externalUserId} kf=${openKfId}. ` +
+                        `The customer must send a new message before more replies can be delivered.`);
+                }
+                throw err;
+            }
+        }
+        return { channel: "wechat-kf", messageId: "", chatId: to };
+    },
+};
+//# sourceMappingURL=outbound.js.map

package/dist/src/outbound.js.map

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

package/dist/src/reply-dispatcher.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Reply dispatcher for WeChat KF  (typing-aware streaming replies)
+ *
+ * Responsibility:
+ *   This module is used internally by `bot.ts` when the agent streams tokens
+ *   back to the user. It wraps OpenClaw's `createReplyDispatcherWithTyping` to
+ *   batch tokens into natural-looking messages with simulated human typing
+ *   delay, then delivers them through the WeChat KF API.
+ *
+ *   Text chunking is performed at delivery time via the runtime's
+ *   `chunkTextWithMode` helper (NOT the framework auto-chunker), because
+ *   streaming replies accumulate text incrementally.
+ *
+ * Counterpart:
+ *   `outbound.ts` handles the *other* outbound path: framework-driven direct
+ *   delivery where the framework itself pre-chunks text via the declared
+ *   `chunker` function.
+ *
+ * accountId = openKfId (dynamically discovered)
+ */
+import type { OpenClawConfig } from "./types.js";
+/** Minimal runtime shape used only for error logging in the reply dispatcher. */
+type RuntimeErrorLogger = {
+    error?: (...args: unknown[]) => void;
+    [key: string]: unknown;
+};
+export type CreateReplyDispatcherParams = {
+    cfg: OpenClawConfig;
+    agentId: string;
+    runtime: RuntimeErrorLogger;
+    externalUserId: string;
+    openKfId: string;
+    accountId: string;
+};
+export declare function createReplyDispatcher(params: CreateReplyDispatcherParams): {
+    dispatcher: unknown;
+    replyOptions: unknown;
+    markDispatchIdle: (() => void) | undefined;
+};
+export {};

package/dist/src/reply-dispatcher.js

@@ -0,0 +1,120 @@
+/**
+ * Reply dispatcher for WeChat KF  (typing-aware streaming replies)
+ *
+ * Responsibility:
+ *   This module is used internally by `bot.ts` when the agent streams tokens
+ *   back to the user. It wraps OpenClaw's `createReplyDispatcherWithTyping` to
+ *   batch tokens into natural-looking messages with simulated human typing
+ *   delay, then delivers them through the WeChat KF API.
+ *
+ *   Text chunking is performed at delivery time via the runtime's
+ *   `chunkTextWithMode` helper (NOT the framework auto-chunker), because
+ *   streaming replies accumulate text incrementally.
+ *
+ * Counterpart:
+ *   `outbound.ts` handles the *other* outbound path: framework-driven direct
+ *   delivery where the framework itself pre-chunks text via the declared
+ *   `chunker` function.
+ *
+ * accountId = openKfId (dynamically discovered)
+ */
+import { readFile } from "node:fs/promises";
+import { basename, extname } from "node:path";
+import { resolveAccount } from "./accounts.js";
+import { sendLinkMessage, sendTextMessage, uploadMedia } from "./api.js";
+import { WECHAT_TEXT_CHUNK_LIMIT } from "./constants.js";
+import { getRuntime } from "./runtime.js";
+import { detectMediaType, downloadMediaFromUrl, formatText, uploadAndSendMedia } from "./send-utils.js";
+import { parseWechatLinkDirective } from "./wechat-kf-directives.js";
+export function createReplyDispatcher(params) {
+    const core = getRuntime();
+    const { cfg, agentId, externalUserId, openKfId, accountId } = params;
+    const account = resolveAccount(cfg, accountId);
+    const kfId = openKfId; // accountId IS the kfid
+    const textChunkLimit = core.channel.text.resolveTextChunkLimit(cfg, "wechat-kf", accountId, {
+        fallbackLimit: WECHAT_TEXT_CHUNK_LIMIT,
+    });
+    const chunkMode = core.channel.text.resolveChunkMode(cfg, "wechat-kf");
+    const { dispatcher, replyOptions, markDispatchIdle } = core.channel.reply.createReplyDispatcherWithTyping({
+        humanDelay: core.channel.reply.resolveHumanDelayConfig(cfg, agentId),
+        deliver: async (payload) => {
+            const text = payload.text ?? "";
+            const attachments = payload.attachments ?? [];
+            const { corpId, appSecret } = account;
+            if (!corpId || !appSecret) {
+                throw new Error("[wechat-kf] missing corpId/appSecret for send");
+            }
+            // Handle media attachments (image, voice, video, file)
+            for (const attachment of attachments) {
+                if (attachment.path) {
+                    try {
+                        const ext = extname(attachment.path).toLowerCase();
+                        const mediaType = detectMediaType(ext);
+                        const filename = basename(attachment.path);
+                        const buffer = await readFile(attachment.path);
+                        await uploadAndSendMedia(corpId, appSecret, externalUserId, kfId, buffer, filename, mediaType);
+                    }
+                    catch (err) {
+                        params.runtime?.error?.(`[wechat-kf] failed to send ${attachment.type ?? "media"} attachment: ${String(err)}`);
+                    }
+                }
+            }
+            // ── Intercept [[wechat_link:...]] directives BEFORE formatText ──
+            // Parse on raw text so title/desc/url stay clean (formatText would
+            // convert markdown inside the directive to unicode characters).
+            if (text.trim()) {
+                const directive = parseWechatLinkDirective(text);
+                if (directive.link) {
+                    let linkSent = false;
+                    if (directive.link.thumbUrl) {
+                        try {
+                            const downloaded = await downloadMediaFromUrl(directive.link.thumbUrl);
+                            const uploaded = await uploadMedia(corpId, appSecret, "image", downloaded.buffer, downloaded.filename);
+                            await sendLinkMessage(corpId, appSecret, externalUserId, kfId, {
+                                title: directive.link.title,
+                                desc: directive.link.desc,
+                                url: directive.link.url,
+                                thumb_media_id: uploaded.media_id,
+                            });
+                            linkSent = true;
+                        }
+                        catch (err) {
+                            params.runtime?.error?.(`[wechat-kf] failed to send link card: ${String(err)}`);
+                        }
+                    }
+                    // Send remaining text (or fallback with title:url if link card failed / no thumbUrl)
+                    const rawRemaining = linkSent
+                        ? directive.text
+                        : directive.text
+                            ? `${directive.text}\n${directive.link.title}: ${directive.link.url}`
+                            : `${directive.link.title}: ${directive.link.url}`;
+                    if (rawRemaining?.trim()) {
+                        const formatted = formatText(rawRemaining);
+                        const chunks = core.channel.text.chunkTextWithMode(formatted, textChunkLimit, chunkMode);
+                        for (const chunk of chunks) {
+                            await sendTextMessage(corpId, appSecret, externalUserId, kfId, chunk);
+                        }
+                    }
+                }
+                else {
+                    // No directive — normal path: formatText then chunk and send
+                    const formatted = formatText(text);
+                    if (formatted.trim()) {
+                        const chunks = core.channel.text.chunkTextWithMode(formatted, textChunkLimit, chunkMode);
+                        for (const chunk of chunks) {
+                            await sendTextMessage(corpId, appSecret, externalUserId, kfId, chunk);
+                        }
+                    }
+                }
+            }
+            if (!text.trim() && attachments.length === 0) {
+                return;
+            }
+        },
+        onError: (err, info) => {
+            params.runtime?.error?.(`[wechat-kf] ${info?.kind ?? "unknown"} reply failed: ${String(err)}`);
+        },
+    });
+    return { dispatcher, replyOptions, markDispatchIdle };
+}
+//# sourceMappingURL=reply-dispatcher.js.map

package/dist/src/reply-dispatcher.js.map

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