@pawastation/wechat-kf 0.1.1

package/dist/src/bot.js

@@ -0,0 +1,379 @@
+/**
+ * Message processing — pull messages via sync_msg and dispatch to OpenClaw agent.
+ *
+ * Architecture:
+ * - Each openKfId is an independent account with its own cursor and session
+ * - sync_msg is called with open_kfid filter to only pull messages for that kf account
+ * - Plugin layer: download media, save via MediaPaths/MediaTypes
+ * - OpenClaw runner: handles media understanding (transcription, vision, etc.)
+ */
+import { mkdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getChannelConfig, registerKfId, resolveAccount } from "./accounts.js";
+import { downloadMedia, syncMessages } from "./api.js";
+import { atomicWriteFile } from "./fs-utils.js";
+import { createReplyDispatcher } from "./reply-dispatcher.js";
+import { getRuntime } from "./runtime.js";
+// ── Per-kfId async mutex ──
+// Ensures that concurrent calls to handleWebhookEvent for the same openKfId
+// (e.g. from webhook + polling simultaneously) are serialized.
+const kfLocks = new Map();
+// ── Message deduplication ──
+// Tracks recently-processed msgids to avoid dispatching the same message twice,
+// even if sync_msg returns overlapping batches from concurrent paths.
+const processedMsgIds = new Set();
+const DEDUP_MAX_SIZE = 10_000;
+function isDuplicate(msgid) {
+    if (processedMsgIds.has(msgid))
+        return true;
+    if (processedMsgIds.size >= DEDUP_MAX_SIZE) {
+        // Evict the oldest half (Set preserves insertion order)
+        const entries = [...processedMsgIds];
+        processedMsgIds.clear();
+        for (const id of entries.slice(entries.length >>> 1)) {
+            processedMsgIds.add(id);
+        }
+    }
+    processedMsgIds.add(msgid);
+    return false;
+}
+/** Exposed for testing only — do not use in production code. */
+export const _testing = {
+    kfLocks,
+    processedMsgIds,
+    isDuplicate,
+    DEDUP_MAX_SIZE,
+    handleEvent,
+    resetState() {
+        kfLocks.clear();
+        processedMsgIds.clear();
+    },
+};
+// ── Cursor persistence (per kfid) ──
+async function loadCursor(stateDir, kfId) {
+    try {
+        return (await readFile(join(stateDir, `wechat-kf-cursor-${kfId}.txt`), "utf8")).trim();
+    }
+    catch {
+        return "";
+    }
+}
+let dirCreated = false;
+async function saveCursor(stateDir, kfId, cursor) {
+    if (!dirCreated) {
+        await mkdir(stateDir, { recursive: true });
+        dirCreated = true;
+    }
+    await atomicWriteFile(join(stateDir, `wechat-kf-cursor-${kfId}.txt`), cursor);
+}
+// ── Message text extraction ──
+// Descriptions of non-text messages injected into the AI agent's context.
+// Kept in Chinese because end-users are Chinese WeChat users and the agent
+// replies in Chinese. These are NOT displayed to end-users directly.
+function extractText(msg) {
+    switch (msg.msgtype) {
+        case "text":
+            return msg.text?.content ?? "";
+        case "image":
+            return "[用户发送了一张图片]";
+        case "voice":
+            return "[用户发送了一段语音]";
+        case "video":
+            return "[用户发送了一段视频]";
+        case "file":
+            return "[用户发送了一个文件]";
+        case "location": {
+            const locDetail = [msg.location?.name, msg.location?.address].filter(Boolean).join(" ");
+            return locDetail ? `[位置: ${locDetail}]` : "[位置]";
+        }
+        case "link":
+            return `[链接: ${msg.link?.title ?? ""} ${msg.link?.url ?? ""}]`;
+        case "merged_msg": {
+            const merged = msg.merged_msg;
+            if (!merged)
+                return "[转发的聊天记录]";
+            const title = merged.title ?? "聊天记录";
+            const items = Array.isArray(merged.item) ? merged.item : [];
+            const lines = items.map((item) => {
+                const sender = item.sender_name ?? "未知";
+                let content = "";
+                try {
+                    const parsed = JSON.parse(item.msg_content ?? "{}");
+                    const parsedText = parsed.text;
+                    if (parsedText?.content)
+                        content = parsedText.content;
+                    else if (parsed.image)
+                        content = "[图片]";
+                    else if (parsed.voice)
+                        content = "[语音]";
+                    else if (parsed.video)
+                        content = "[视频]";
+                    else if (parsed.file)
+                        content = "[文件]";
+                    else if (parsed.link)
+                        content = `[链接: ${parsed.link?.title ?? ""}]`;
+                    else
+                        content = `[${parsed.msgtype ?? "未知类型"}]`;
+                }
+                catch {
+                    content = item.msg_content ?? "";
+                }
+                return `${sender}: ${content}`;
+            });
+            return `[转发的聊天记录: ${title}]\n${lines.join("\n")}`;
+        }
+        case "channels": {
+            const ch = msg.channels;
+            const typeMap = { 1: "视频号动态", 2: "视频号直播", 3: "视频号名片" };
+            const typeName = ch?.sub_type != null ? (typeMap[ch.sub_type] ?? "视频号消息") : "视频号消息";
+            return `[${typeName}] ${ch?.nickname ?? ""}: ${ch?.title ?? ""}`;
+        }
+        case "miniprogram": {
+            const mp = msg.miniprogram;
+            return `[小程序] ${mp?.title ?? ""} (appid: ${mp?.appid ?? ""})`;
+        }
+        case "msgmenu": {
+            const menu = msg.msgmenu;
+            const head = menu?.head_content ?? "";
+            const items = Array.isArray(menu?.list) ? menu.list.map((item) => item.content ?? item.id).join(", ") : "";
+            return head ? `${head} [选项: ${items}]` : `[菜单消息: ${items}]`;
+        }
+        case "business_card":
+            return `[名片] userid: ${msg.business_card?.userid ?? ""}`;
+        case "event":
+            return null;
+        default:
+            return `[未支持的消息类型: ${msg.msgtype}]`;
+    }
+}
+// ── Event handling ──
+async function handleEvent(ctx, _account, msg) {
+    const event = msg.event;
+    const { log } = ctx;
+    const kfId = msg.open_kfid;
+    switch (event?.event_type) {
+        case "enter_session":
+            log?.info(`[wechat-kf:${kfId}] user ${msg.external_userid} entered session` +
+                (event.welcome_code ? `, welcome_code=${event.welcome_code}` : "") +
+                (event.scene ? `, scene=${event.scene}` : ""));
+            break;
+        case "msg_send_fail":
+            log?.error(`[wechat-kf:${kfId}] message send failed: msgid=${event.fail_msgid}, type=${event.fail_type}`);
+            break;
+        case "servicer_status_change":
+            log?.info(`[wechat-kf:${kfId}] servicer status changed: ${event.servicer_userid} -> ${event.status}`);
+            break;
+        default:
+            log?.info(`[wechat-kf:${kfId}] unhandled event: ${event?.event_type}`);
+    }
+}
+// ── Core message handler (per kfid) ──
+export async function handleWebhookEvent(ctx, openKfId, syncToken) {
+    // Acquire per-kfId mutex — chains onto any in-flight processing for this kfId
+    const prev = kfLocks.get(openKfId) ?? Promise.resolve();
+    let release;
+    const current = new Promise((r) => {
+        release = r;
+    });
+    kfLocks.set(openKfId, current);
+    try {
+        await prev;
+        await _handleWebhookEventInner(ctx, openKfId, syncToken);
+    }
+    finally {
+        release();
+        // Clean up map entry only if no newer caller has replaced it
+        if (kfLocks.get(openKfId) === current) {
+            kfLocks.delete(openKfId);
+        }
+    }
+}
+async function _handleWebhookEventInner(ctx, openKfId, syncToken) {
+    const { cfg, stateDir, log } = ctx;
+    const account = resolveAccount(cfg, openKfId); // kfid as accountId
+    const { corpId, appSecret } = account;
+    if (!corpId || !appSecret) {
+        log?.error("[wechat-kf] missing corpId/appSecret");
+        return;
+    }
+    // Register this kfid as discovered
+    await registerKfId(openKfId);
+    let cursor = await loadCursor(stateDir, openKfId);
+    let hasMore = true;
+    while (hasMore) {
+        const syncReq = {
+            limit: 1000,
+            open_kfid: openKfId, // Only pull messages for this kf account
+        };
+        if (cursor) {
+            // Have a persisted cursor — use it for incremental fetch (token is ignored)
+            syncReq.cursor = cursor;
+        }
+        else if (syncToken) {
+            // No cursor but webhook provided a token — use it for the first fetch
+            syncReq.token = syncToken;
+        }
+        else {
+            // Neither cursor nor token — will fetch the initial batch (up to 3 days history)
+            log?.info(`[wechat-kf:${openKfId}] no cursor or token, fetching initial batch`);
+        }
+        let resp;
+        try {
+            resp = await syncMessages(corpId, appSecret, syncReq);
+        }
+        catch (err) {
+            log?.error(`[wechat-kf:${openKfId}] sync_msg failed: ${err instanceof Error ? err.message : err}`);
+            return;
+        }
+        for (const msg of resp.msg_list ?? []) {
+            // Handle event messages (any origin) before normal message processing
+            if (msg.msgtype === "event") {
+                await handleEvent(ctx, account, msg);
+                continue;
+            }
+            if (msg.origin !== 3)
+                continue; // Only customer messages
+            // Dedup: skip messages we have already processed
+            if (isDuplicate(msg.msgid)) {
+                log?.info(`[wechat-kf:${openKfId}] skipping duplicate msg ${msg.msgid}`);
+                continue;
+            }
+            const text = extractText(msg);
+            if (text === null || text === "")
+                continue;
+            try {
+                await dispatchMessage(ctx, account, msg, text);
+            }
+            catch (err) {
+                log?.error(`[wechat-kf:${openKfId}] dispatch error for msg ${msg.msgid}: ${err instanceof Error ? err.stack || err.message : err}`);
+            }
+        }
+        // P1-02: Save cursor AFTER all messages in the batch are processed
+        // (at-least-once delivery). If the process crashes mid-batch, the
+        // cursor has not advanced and the batch will be re-fetched on restart.
+        // P1-01 msgid dedup ensures replayed messages are not dispatched twice.
+        if (resp.next_cursor) {
+            cursor = resp.next_cursor;
+            await saveCursor(stateDir, openKfId, cursor);
+        }
+        hasMore = resp.has_more === 1;
+    }
+}
+// ── Dispatch message to agent ──
+async function dispatchMessage(ctx, account, msg, text) {
+    const { cfg, runtime, log } = ctx;
+    // ── DM policy check ──
+    const channelConfig = getChannelConfig(cfg);
+    const dmPolicy = channelConfig.dmPolicy ?? "open";
+    const externalUserId = msg.external_userid;
+    if (dmPolicy === "disabled") {
+        log?.info?.(`[wechat-kf] drop DM (dmPolicy: disabled)`);
+        return;
+    }
+    if (dmPolicy === "allowlist") {
+        const allowFrom = channelConfig.allowFrom ?? [];
+        if (!allowFrom.includes(externalUserId)) {
+            log?.info?.(`[wechat-kf] blocked sender ${externalUserId} (dmPolicy: allowlist)`);
+            return;
+        }
+    }
+    // "open" and "pairing" modes: allow message through
+    // Note: full pairing flow requires runtime API support, deferred to P2
+    const core = getRuntime();
+    const kfId = msg.open_kfid;
+    const from = `wechat-kf:${msg.external_userid}`;
+    const to = `user:${msg.external_userid}`;
+    // Download media
+    const mediaPaths = [];
+    const mediaTypes = [];
+    async function saveMedia(mediaId, mimeType, filename) {
+        try {
+            const buffer = await downloadMedia(account.corpId, account.appSecret, mediaId);
+            const saved = await core.channel.media.saveMediaBuffer(buffer, mimeType, "inbound", undefined, filename);
+            mediaPaths.push(saved.path);
+            mediaTypes.push(mimeType);
+            log?.info(`[wechat-kf:${kfId}] saved media: ${saved.path} (${mimeType})`);
+        }
+        catch (err) {
+            log?.error(`[wechat-kf:${kfId}] failed to save media ${mediaId}: ${err instanceof Error ? err.message : err}`);
+        }
+    }
+    if (account.corpId && account.appSecret) {
+        const mediaId = msg.image?.media_id || msg.voice?.media_id || msg.video?.media_id || msg.file?.media_id;
+        if (mediaId) {
+            const mimeMap = {
+                image: ["image/jpeg", `wechat_image_${msg.msgid}.jpg`],
+                voice: ["audio/amr", `wechat_voice_${msg.msgid}.amr`],
+                video: ["video/mp4", `wechat_video_${msg.msgid}.mp4`],
+                file: ["application/octet-stream", `wechat_file_${msg.msgid}`],
+            };
+            const [mime, filename] = mimeMap[msg.msgtype] ?? ["application/octet-stream", `wechat_media_${msg.msgid}`];
+            await saveMedia(mediaId, mime, filename);
+        }
+    }
+    // Route using kfid as accountId — each kfid gets its own session
+    // peer id includes kfid so different kf accounts get isolated sessions
+    const route = core.channel.routing.resolveAgentRoute({
+        cfg,
+        channel: "wechat-kf",
+        accountId: kfId,
+        peer: { kind: "direct", id: `${kfId}:${msg.external_userid}` },
+    });
+    // System event
+    const preview = text.replace(/\s+/g, " ").slice(0, 160);
+    core.system.enqueueSystemEvent(`WeChat-KF[${kfId}] DM from ${msg.external_userid}: ${preview}`, {
+        sessionKey: route.sessionKey,
+        contextKey: `wechat-kf:message:${msg.msgid}`,
+    });
+    // Format envelope
+    const envelopeOptions = core.channel.reply.resolveEnvelopeFormatOptions(cfg);
+    const body = core.channel.reply.formatAgentEnvelope({
+        channel: "WeChat-KF",
+        from: msg.external_userid,
+        timestamp: new Date(msg.send_time * 1000),
+        envelope: envelopeOptions,
+        body: text,
+    });
+    // Build inbound context
+    const inboundCtx = core.channel.reply.finalizeInboundContext({
+        Body: body,
+        RawBody: text,
+        CommandBody: text,
+        From: from,
+        To: to,
+        SessionKey: route.sessionKey,
+        AccountId: kfId,
+        ChatType: "direct",
+        SenderName: msg.external_userid,
+        SenderId: msg.external_userid,
+        Provider: "wechat-kf",
+        Surface: "wechat-kf",
+        MessageSid: msg.msgid,
+        Timestamp: msg.send_time * 1000,
+        WasMentioned: false,
+        CommandAuthorized: true,
+        OriginatingChannel: "wechat-kf",
+        OriginatingTo: to,
+        MediaPaths: mediaPaths.length > 0 ? mediaPaths : undefined,
+        MediaTypes: mediaTypes.length > 0 ? mediaTypes : undefined,
+    });
+    // Dispatch to agent
+    const { dispatcher, replyOptions, markDispatchIdle } = createReplyDispatcher({
+        cfg,
+        agentId: route.agentId,
+        runtime: runtime ?? {},
+        externalUserId: msg.external_userid,
+        openKfId: kfId,
+        accountId: kfId,
+    });
+    log?.info(`[wechat-kf:${kfId}] dispatching to agent (session=${route.sessionKey})`);
+    const { queuedFinal, counts } = await core.channel.reply.dispatchReplyFromConfig({
+        ctx: inboundCtx,
+        cfg,
+        dispatcher,
+        replyOptions,
+    });
+    markDispatchIdle?.();
+    log?.info(`[wechat-kf:${kfId}] dispatch complete (queuedFinal=${queuedFinal}, replies=${counts?.final})`);
+}
+//# sourceMappingURL=bot.js.map

package/dist/src/bot.js.map

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

package/dist/src/channel.d.ts

@@ -0,0 +1,113 @@
+/**
+ * WeChat KF ChannelPlugin implementation
+ *
+ * Dynamically discovers kfids from webhook callbacks.
+ * Each kfid = one accountId = one independent session.
+ */
+import type { Logger } from "./bot.js";
+import { wechatKfOutbound } from "./outbound.js";
+import type { PluginRuntime } from "./runtime.js";
+import type { OpenClawConfig, ResolvedWechatKfAccount } from "./types.js";
+type ChannelMeta = {
+    id: string;
+    label: string;
+    selectionLabel: string;
+    docsPath: string;
+    docsLabel: string;
+    blurb: string;
+    aliases?: string[];
+    order?: number;
+};
+type ChannelCapabilities = {
+    chatTypes: string[];
+    media: boolean;
+    reactions: boolean;
+    threads: boolean;
+    polls: boolean;
+    nativeCommands: boolean;
+    blockStreaming: boolean;
+};
+type AccountRuntimeStatus = {
+    accountId: string;
+    running: boolean;
+    lastStartAt: string | null;
+    lastStopAt: string | null;
+    lastError: string | null;
+    port: number | null;
+};
+type GatewayContext = {
+    cfg: OpenClawConfig;
+    runtime?: PluginRuntime;
+    abortSignal?: AbortSignal;
+    accountId: string;
+    log?: Logger;
+    setStatus?: (status: Partial<AccountRuntimeStatus>) => void;
+};
+type ChannelPlugin<T = unknown> = {
+    id: string;
+    meta: ChannelMeta;
+    capabilities: ChannelCapabilities;
+    agentPrompt: {
+        messageToolHints: () => string[];
+    };
+    reload: {
+        configPrefixes: string[];
+    };
+    configSchema: {
+        schema: unknown;
+    };
+    config: {
+        listAccountIds: (cfg: OpenClawConfig) => string[];
+        resolveAccount: (cfg: OpenClawConfig, accountId?: string) => T;
+        defaultAccountId: (cfg: OpenClawConfig) => string;
+        setAccountEnabled: (opts: {
+            cfg: OpenClawConfig;
+            accountId: string;
+            enabled: boolean;
+        }) => OpenClawConfig;
+        deleteAccount: (opts: {
+            cfg: OpenClawConfig;
+            accountId: string;
+        }) => OpenClawConfig;
+        isConfigured: (account: T) => boolean;
+        describeAccount: (account: T) => Record<string, unknown>;
+        resolveAllowFrom: (opts: {
+            cfg: OpenClawConfig;
+        }) => string[];
+        formatAllowFrom: (opts: {
+            allowFrom: string[];
+        }) => string[];
+    };
+    security: {
+        resolveDmPolicy: (opts: {
+            cfg: OpenClawConfig;
+        }) => Record<string, unknown>;
+        collectWarnings: (opts: {
+            cfg: OpenClawConfig;
+        }) => string[];
+    };
+    setup: {
+        resolveAccountId: (cfg: OpenClawConfig, accountId?: string) => string;
+        applyAccountConfig: (opts: {
+            cfg: OpenClawConfig;
+            accountId: string;
+        }) => OpenClawConfig;
+    };
+    outbound: typeof wechatKfOutbound;
+    status: {
+        defaultRuntime: AccountRuntimeStatus;
+        buildChannelSummary: (opts: {
+            snapshot: Record<string, unknown>;
+        }) => Record<string, unknown>;
+        buildAccountSnapshot: (opts: {
+            account: T;
+            runtime: Partial<AccountRuntimeStatus> | null;
+        }) => Record<string, unknown>;
+    };
+    gateway: {
+        _started: boolean;
+        startAccount: (ctx: GatewayContext) => Promise<void>;
+    };
+};
+export declare const wechatKfPlugin: ChannelPlugin<ResolvedWechatKfAccount>;
+export {};