@yaoqi10012/wechat-kf 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 pawaca
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/accounts.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Account resolution for WeChat KF
+ *
+ * Accounts are dynamically discovered from webhook callbacks.
+ * Each openKfId becomes an independent accountId (like Telegram chat groups).
+ * Enterprise credentials (corpId, appSecret, token, encodingAESKey) are shared.
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+import type { ResolvedWechatKfAccount, WechatKfConfig } from "./types.js";
+export declare function setStateDir(dir: string): void;
+export declare function getChannelConfig(cfg: OpenClawConfig): WechatKfConfig;
+/** Register a dynamically discovered kfid */
+export declare function registerKfId(kfId: string): Promise<void>;
+/** Get all known kfids */
+export declare function getKnownKfIds(): string[];
+/** Get all known kfids that are currently enabled */
+export declare function getEnabledKfIds(): string[];
+/** Check whether a kfid is enabled (not in the disabled set) */
+export declare function isKfIdEnabled(kfId: string): boolean;
+/** Disable a kfid (add to disabled set). Returns true if the state changed. */
+export declare function disableKfId(kfId: string): Promise<boolean>;
+/** Enable a previously disabled kfid. Returns true if the state changed. */
+export declare function enableKfId(kfId: string): Promise<boolean>;
+/**
+ * Delete a kfid entirely — removes from discovered set and adds to disabled set
+ * so it won't be re-activated if the webhook delivers it again before restart.
+ * Returns true if the kfid was known (and thus actually removed).
+ */
+export declare function deleteKfId(kfId: string): Promise<boolean>;
+/** Load persisted kfids from state dir */
+export declare function loadKfIds(dir: string): Promise<void>;
+export declare function listAccountIds(_cfg: OpenClawConfig): string[];
+/**
+ * Reset all module-level mutable state.
+ * @internal Exposed for testing only — allows test isolation between runs.
+ */
+export declare function _reset(): void;
+export declare function resolveAccount(cfg: OpenClawConfig, accountId?: string): ResolvedWechatKfAccount;

package/dist/accounts.js

@@ -0,0 +1,247 @@
+/**
+ * Account resolution for WeChat KF
+ *
+ * Accounts are dynamically discovered from webhook callbacks.
+ * Each openKfId becomes an independent accountId (like Telegram chat groups).
+ * Enterprise credentials (corpId, appSecret, token, encodingAESKey) are shared.
+ */
+import { readFileSync } from "node:fs";
+import { mkdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { CHANNEL_ID, DEFAULT_WEBHOOK_PATH, DISABLED_KFIDS_FILE, defaultStateDir, formatError, KFIDS_FILE, logTag, } from "./constants.js";
+import { atomicWriteFile } from "./fs-utils.js";
+import { getSharedContext } from "./monitor.js";
+/** In-memory set of discovered kfids */
+const discoveredKfIds = new Set();
+/** In-memory set of disabled kfids (persisted to disk) */
+const disabledKfIds = new Set();
+let stateDir = null;
+let kfIdsPreloaded = false;
+/** Synchronously preload persisted kfIds so listAccountIds returns them before loadKfIds runs */
+function preloadKfIdsSync() {
+    if (kfIdsPreloaded)
+        return;
+    kfIdsPreloaded = true;
+    const dir = stateDir ?? defaultStateDir();
+    try {
+        const data = readFileSync(join(dir, KFIDS_FILE), "utf8");
+        const ids = JSON.parse(data);
+        if (Array.isArray(ids)) {
+            for (const id of ids)
+                discoveredKfIds.add(id);
+        }
+    }
+    catch (err) {
+        if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) {
+            console.warn(`${logTag()} failed to preload kfids: ${formatError(err)}`);
+        }
+    }
+    try {
+        const data = readFileSync(join(dir, DISABLED_KFIDS_FILE), "utf8");
+        const ids = JSON.parse(data);
+        if (Array.isArray(ids)) {
+            for (const id of ids)
+                disabledKfIds.add(id);
+        }
+    }
+    catch (err) {
+        if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) {
+            console.warn(`${logTag()} failed to preload disabled kfids: ${formatError(err)}`);
+        }
+    }
+}
+export function setStateDir(dir) {
+    stateDir = dir;
+}
+export function getChannelConfig(cfg) {
+    return (cfg.channels?.[CHANNEL_ID] ?? {});
+}
+/** Register a dynamically discovered kfid */
+export async function registerKfId(kfId) {
+    if (!kfId || discoveredKfIds.has(kfId))
+        return;
+    discoveredKfIds.add(kfId);
+    await persistKfIds();
+}
+/** Get all known kfids */
+export function getKnownKfIds() {
+    return Array.from(discoveredKfIds);
+}
+/** Get all known kfids that are currently enabled */
+export function getEnabledKfIds() {
+    return Array.from(discoveredKfIds).filter((id) => !disabledKfIds.has(id));
+}
+/** Check whether a kfid is enabled (not in the disabled set) */
+export function isKfIdEnabled(kfId) {
+    return !disabledKfIds.has(resolveKfId(kfId));
+}
+/** Disable a kfid (add to disabled set). Returns true if the state changed. */
+export async function disableKfId(kfId) {
+    if (!kfId)
+        return false;
+    const resolved = resolveKfId(kfId);
+    if (disabledKfIds.has(resolved))
+        return false;
+    disabledKfIds.add(resolved);
+    await persistDisabledKfIds();
+    return true;
+}
+/** Enable a previously disabled kfid. Returns true if the state changed. */
+export async function enableKfId(kfId) {
+    if (!kfId)
+        return false;
+    const resolved = resolveKfId(kfId);
+    if (!disabledKfIds.has(resolved))
+        return false;
+    disabledKfIds.delete(resolved);
+    await persistDisabledKfIds();
+    return true;
+}
+/**
+ * Delete a kfid entirely — removes from discovered set and adds to disabled set
+ * so it won't be re-activated if the webhook delivers it again before restart.
+ * Returns true if the kfid was known (and thus actually removed).
+ */
+export async function deleteKfId(kfId) {
+    if (!kfId)
+        return false;
+    const resolved = resolveKfId(kfId);
+    const wasKnown = discoveredKfIds.has(resolved);
+    discoveredKfIds.delete(resolved);
+    disabledKfIds.add(resolved);
+    await persistKfIds();
+    await persistDisabledKfIds();
+    return wasKnown;
+}
+/**
+ * Resolve a potentially lowercased kfId to its original-case form.
+ * Falls back to the input if no match is found in the discovered set.
+ */
+function resolveKfId(kfId) {
+    // Direct match — fast path
+    if (discoveredKfIds.has(kfId) || disabledKfIds.has(kfId))
+        return kfId;
+    // Case-insensitive lookup in discovered set
+    for (const id of discoveredKfIds) {
+        if (id.toLowerCase() === kfId.toLowerCase())
+            return id;
+    }
+    // Case-insensitive lookup in disabled set
+    for (const id of disabledKfIds) {
+        if (id.toLowerCase() === kfId.toLowerCase())
+            return id;
+    }
+    return kfId;
+}
+/** Load persisted kfids from state dir */
+export async function loadKfIds(dir) {
+    stateDir = dir;
+    kfIdsPreloaded = true;
+    try {
+        const data = await readFile(join(dir, KFIDS_FILE), "utf8");
+        const ids = JSON.parse(data);
+        if (Array.isArray(ids)) {
+            for (const id of ids)
+                discoveredKfIds.add(id);
+        }
+    }
+    catch (err) {
+        if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) {
+            console.warn(`${logTag()} failed to load kfids: ${formatError(err)}`);
+        }
+    }
+    try {
+        const data = await readFile(join(dir, DISABLED_KFIDS_FILE), "utf8");
+        const ids = JSON.parse(data);
+        if (Array.isArray(ids)) {
+            for (const id of ids)
+                disabledKfIds.add(id);
+        }
+    }
+    catch (err) {
+        if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) {
+            console.warn(`${logTag()} failed to load disabled kfids: ${formatError(err)}`);
+        }
+    }
+}
+/** Persist kfids to state dir */
+async function persistKfIds() {
+    if (!stateDir)
+        return;
+    try {
+        await mkdir(stateDir, { recursive: true });
+        await atomicWriteFile(join(stateDir, KFIDS_FILE), JSON.stringify(Array.from(discoveredKfIds)));
+    }
+    catch (err) {
+        getSharedContext()?.botCtx.log?.warn(`${logTag()} failed to persist kfids: ${formatError(err)}`);
+    }
+}
+/** Persist disabled kfids to state dir */
+async function persistDisabledKfIds() {
+    if (!stateDir)
+        return;
+    try {
+        await mkdir(stateDir, { recursive: true });
+        await atomicWriteFile(join(stateDir, DISABLED_KFIDS_FILE), JSON.stringify(Array.from(disabledKfIds)));
+    }
+    catch (err) {
+        getSharedContext()?.botCtx.log?.warn(`${logTag()} failed to persist disabled kfids: ${formatError(err)}`);
+    }
+}
+export function listAccountIds(_cfg) {
+    // "default" is always first — represents enterprise-level shared infrastructure.
+    // Real kfIds follow. When no kfIds are discovered yet, returns ["default"].
+    preloadKfIdsSync();
+    const ids = getEnabledKfIds();
+    return ["default", ...ids];
+}
+/**
+ * Recover the original case-sensitive kfId from the normalized (lowercased) accountId.
+ * OpenClaw core normalizes accountIds to lowercase, but WeChat KF API requires
+ * the original case-sensitive openKfId.
+ */
+function recoverOriginalKfId(normalizedId) {
+    if (normalizedId === "default")
+        return undefined;
+    // Look up the original-case kfId from our discovered set
+    for (const kfId of discoveredKfIds) {
+        if (kfId.toLowerCase() === normalizedId.toLowerCase())
+            return kfId;
+    }
+    // Fallback: return as-is (may fail if case matters)
+    return normalizedId;
+}
+/**
+ * Reset all module-level mutable state.
+ * @internal Exposed for testing only — allows test isolation between runs.
+ */
+export function _reset() {
+    discoveredKfIds.clear();
+    disabledKfIds.clear();
+    stateDir = null;
+    kfIdsPreloaded = false;
+}
+export function resolveAccount(cfg, accountId) {
+    const config = getChannelConfig(cfg);
+    const id = accountId ?? "default";
+    const corpId = config.corpId;
+    const appSecret = config.appSecret;
+    const token = config.token;
+    const encodingAESKey = config.encodingAESKey;
+    const kfIdDisabled = id !== "default" && !isKfIdEnabled(id);
+    const enabled = kfIdDisabled ? false : (config.enabled ?? false);
+    const configured = !!(corpId && appSecret && token && encodingAESKey);
+    return {
+        accountId: id,
+        enabled,
+        configured,
+        corpId,
+        appSecret,
+        token,
+        encodingAESKey,
+        openKfId: recoverOriginalKfId(id),
+        webhookPath: config.webhookPath ?? DEFAULT_WEBHOOK_PATH,
+        config,
+    };
+}
+//# sourceMappingURL=accounts.js.map

package/dist/accounts.js.map

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

package/dist/api.d.ts

@@ -0,0 +1,58 @@
+/**
+ * WeCom Customer Service API wrapper
+ */
+import type { WechatKfSendMsgRequest, WechatKfSendMsgResponse, WechatKfSyncMsgRequest, WechatKfSyncMsgResponse, WechatMediaUploadResponse } from "./types.js";
+/** Pull messages from WeChat KF */
+export declare function syncMessages(corpId: string, appSecret: string, params: WechatKfSyncMsgRequest): Promise<WechatKfSyncMsgResponse>;
+/** Send a text message to a WeChat user */
+export declare function sendTextMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, content: string): Promise<WechatKfSendMsgResponse>;
+/** Download media file from WeChat */
+export declare function downloadMedia(corpId: string, appSecret: string, mediaId: string): Promise<{
+    buffer: Buffer;
+    contentType: string;
+}>;
+type WechatMediaType = "image" | "voice" | "video" | "file";
+/** Upload media file to WeChat */
+export declare function uploadMedia(corpId: string, appSecret: string, type: WechatMediaType, buffer: Buffer, filename: string): Promise<WechatMediaUploadResponse>;
+/** Send an image message to a WeChat user */
+export declare function sendImageMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, mediaId: string): Promise<WechatKfSendMsgResponse>;
+/** Send a voice message to a WeChat user */
+export declare function sendVoiceMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, mediaId: string): Promise<WechatKfSendMsgResponse>;
+/** Send a video message to a WeChat user */
+export declare function sendVideoMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, mediaId: string): Promise<WechatKfSendMsgResponse>;
+/** Send a file message to a WeChat user */
+export declare function sendFileMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, mediaId: string): Promise<WechatKfSendMsgResponse>;
+/** Send a link message to a WeChat user */
+export declare function sendLinkMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, link: {
+    title: string;
+    desc?: string;
+    url: string;
+    thumb_media_id: string;
+}): Promise<WechatKfSendMsgResponse>;
+/** Send a location message to a WeChat user */
+export declare function sendLocationMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, location: {
+    name?: string;
+    address?: string;
+    latitude: number;
+    longitude: number;
+}): Promise<WechatKfSendMsgResponse>;
+/** Send a miniprogram message to a WeChat user */
+export declare function sendMiniprogramMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, miniprogram: {
+    appid: string;
+    title?: string;
+    thumb_media_id: string;
+    pagepath: string;
+}): Promise<WechatKfSendMsgResponse>;
+/** Send a menu message to a WeChat user */
+export declare function sendMsgMenuMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, msgmenu: WechatKfSendMsgRequest["msgmenu"]): Promise<WechatKfSendMsgResponse>;
+/** Send a business card message to a WeChat user */
+export declare function sendBusinessCardMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, businessCard: {
+    userid: string;
+}): Promise<WechatKfSendMsgResponse>;
+/** Send an acquisition link (获客链接) message to a WeChat user */
+export declare function sendCaLinkMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, caLink: {
+    link_url: string;
+}): Promise<WechatKfSendMsgResponse>;
+/** Send a raw message with arbitrary msgtype — for testing undocumented message types. */
+export declare function sendRawMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, msgtype: string, payload: Record<string, unknown>): Promise<WechatKfSendMsgResponse>;
+export {};

package/dist/api.js

@@ -0,0 +1,200 @@
+/**
+ * WeCom Customer Service API wrapper
+ */
+import { extname } from "node:path";
+import { API_POST_TIMEOUT_MS, logTag, MEDIA_TIMEOUT_MS, TOKEN_EXPIRED_CODES } from "./constants.js";
+import { getSharedContext } from "./monitor.js";
+import { clearAccessToken, getAccessToken } from "./token.js";
+const MIME_MAP = {
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".gif": "image/gif",
+    ".bmp": "image/bmp",
+    ".webp": "image/webp",
+    ".amr": "audio/amr",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".ogg": "audio/ogg",
+    ".silk": "audio/silk",
+    ".m4a": "audio/mp4",
+    ".aac": "audio/aac",
+    ".mp4": "video/mp4",
+    ".avi": "video/x-msvideo",
+    ".mov": "video/quicktime",
+};
+const BASE = "https://qyapi.weixin.qq.com/cgi-bin";
+/**
+ * Check whether a WeCom API response indicates a business error.
+ * Successful responses have errcode === 0 or omit errcode entirely (undefined).
+ * Using a truthy check so that both 0 and undefined are treated as success.
+ */
+function hasApiError(errcode) {
+    return !!errcode;
+}
+async function apiPost(path, token, body) {
+    const resp = await fetch(`${BASE}${path}?access_token=${token}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(API_POST_TIMEOUT_MS),
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => "");
+        throw new Error(`${logTag()} API ${path} HTTP ${resp.status}: ${text.slice(0, 200)}`);
+    }
+    return (await resp.json());
+}
+/**
+ * Call apiPost with automatic token refresh on token-expired errors.
+ * Detects errcode 40014/42001/40001, clears the cached token, fetches a
+ * new one and retries exactly once.
+ */
+async function apiPostWithTokenRetry(path, corpId, appSecret, body) {
+    let token = await getAccessToken(corpId, appSecret);
+    const data = await apiPost(path, token, body);
+    const result = data;
+    if (typeof result.errcode === "number" && TOKEN_EXPIRED_CODES.has(result.errcode)) {
+        getSharedContext()?.botCtx.log?.info(`${logTag()} token expired (errcode=${result.errcode}), refreshing and retrying ${path}`);
+        clearAccessToken(corpId, appSecret);
+        token = await getAccessToken(corpId, appSecret);
+        return apiPost(path, token, body);
+    }
+    return data;
+}
+/** Pull messages from WeChat KF */
+export async function syncMessages(corpId, appSecret, params) {
+    const data = await apiPostWithTokenRetry("/kf/sync_msg", corpId, appSecret, params);
+    if (hasApiError(data.errcode)) {
+        throw new Error(`${logTag()} sync_msg failed: ${data.errcode} ${data.errmsg}`);
+    }
+    return data;
+}
+async function sendMessage(corpId, appSecret, toUser, openKfId, msgtype, payload) {
+    const body = {
+        touser: toUser,
+        open_kfid: openKfId,
+        msgtype,
+        ...payload,
+    };
+    const data = await apiPostWithTokenRetry("/kf/send_msg", corpId, appSecret, body);
+    if (hasApiError(data.errcode)) {
+        throw new Error(`${logTag()} send_msg failed: ${data.errcode} ${data.errmsg}`);
+    }
+    return data;
+}
+/** Send a text message to a WeChat user */
+export function sendTextMessage(corpId, appSecret, toUser, openKfId, content) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "text", { text: { content } });
+}
+/** Download media file from WeChat */
+export async function downloadMedia(corpId, appSecret, mediaId) {
+    const attemptDownload = async (token) => {
+        const resp = await fetch(`${BASE}/media/get?access_token=${token}&media_id=${mediaId}`, {
+            signal: AbortSignal.timeout(MEDIA_TIMEOUT_MS),
+        });
+        if (!resp.ok) {
+            throw new Error(`${logTag()} download media failed: ${resp.status} ${resp.statusText}`);
+        }
+        const contentType = resp.headers.get("content-type") ?? "";
+        if (contentType.includes("application/json")) {
+            const data = (await resp.json());
+            return { buffer: Buffer.alloc(0), contentType, errcode: data.errcode, errmsg: data.errmsg };
+        }
+        return { buffer: Buffer.from(await resp.arrayBuffer()), contentType };
+    };
+    let token = await getAccessToken(corpId, appSecret);
+    const result = await attemptDownload(token);
+    if (result.errcode !== undefined) {
+        // Token-expired error: clear and retry once
+        if (TOKEN_EXPIRED_CODES.has(result.errcode)) {
+            getSharedContext()?.botCtx.log?.info(`${logTag()} token expired (errcode=${result.errcode}), refreshing and retrying media download`);
+            clearAccessToken(corpId, appSecret);
+            token = await getAccessToken(corpId, appSecret);
+            const retry = await attemptDownload(token);
+            if (retry.errcode !== undefined) {
+                throw new Error(`${logTag()} download media failed: ${retry.errcode} ${retry.errmsg}`);
+            }
+            return { buffer: retry.buffer, contentType: retry.contentType };
+        }
+        throw new Error(`${logTag()} download media failed: ${result.errcode} ${result.errmsg}`);
+    }
+    return { buffer: result.buffer, contentType: result.contentType };
+}
+/** Upload media file to WeChat */
+export async function uploadMedia(corpId, appSecret, type, buffer, filename) {
+    const doUpload = async (token) => {
+        const formData = new FormData();
+        const ext = extname(filename).toLowerCase();
+        const mime = MIME_MAP[ext] ?? "application/octet-stream";
+        const blob = new Blob([new Uint8Array(buffer)], { type: mime });
+        formData.append("media", blob, filename);
+        const resp = await fetch(`${BASE}/media/upload?access_token=${token}&type=${type}`, {
+            method: "POST",
+            body: formData,
+            signal: AbortSignal.timeout(MEDIA_TIMEOUT_MS),
+        });
+        if (!resp.ok) {
+            const text = await resp.text().catch(() => "");
+            throw new Error(`${logTag()} upload media HTTP ${resp.status}: ${text.slice(0, 200)}`);
+        }
+        return (await resp.json());
+    };
+    let token = await getAccessToken(corpId, appSecret);
+    let data = await doUpload(token);
+    if (TOKEN_EXPIRED_CODES.has(data.errcode)) {
+        getSharedContext()?.botCtx.log?.info(`${logTag()} token expired (errcode=${data.errcode}), refreshing and retrying media upload`);
+        clearAccessToken(corpId, appSecret);
+        token = await getAccessToken(corpId, appSecret);
+        data = await doUpload(token);
+    }
+    if (hasApiError(data.errcode)) {
+        throw new Error(`${logTag()} upload media failed: ${data.errcode} ${data.errmsg}`);
+    }
+    return data;
+}
+/** Send an image message to a WeChat user */
+export function sendImageMessage(corpId, appSecret, toUser, openKfId, mediaId) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "image", { image: { media_id: mediaId } });
+}
+/** Send a voice message to a WeChat user */
+export function sendVoiceMessage(corpId, appSecret, toUser, openKfId, mediaId) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "voice", { voice: { media_id: mediaId } });
+}
+/** Send a video message to a WeChat user */
+export function sendVideoMessage(corpId, appSecret, toUser, openKfId, mediaId) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "video", { video: { media_id: mediaId } });
+}
+/** Send a file message to a WeChat user */
+export function sendFileMessage(corpId, appSecret, toUser, openKfId, mediaId) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "file", { file: { media_id: mediaId } });
+}
+/** Send a link message to a WeChat user */
+export function sendLinkMessage(corpId, appSecret, toUser, openKfId, link) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "link", { link });
+}
+/** Send a location message to a WeChat user */
+export function sendLocationMessage(corpId, appSecret, toUser, openKfId, location) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "location", { location });
+}
+/** Send a miniprogram message to a WeChat user */
+export function sendMiniprogramMessage(corpId, appSecret, toUser, openKfId, miniprogram) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "miniprogram", { miniprogram });
+}
+/** Send a menu message to a WeChat user */
+export function sendMsgMenuMessage(corpId, appSecret, toUser, openKfId, msgmenu) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "msgmenu", { msgmenu });
+}
+/** Send a business card message to a WeChat user */
+export function sendBusinessCardMessage(corpId, appSecret, toUser, openKfId, businessCard) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "business_card", { business_card: businessCard });
+}
+/** Send an acquisition link (获客链接) message to a WeChat user */
+export function sendCaLinkMessage(corpId, appSecret, toUser, openKfId, caLink) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "ca_link", { ca_link: caLink });
+}
+/** Send a raw message with arbitrary msgtype — for testing undocumented message types. */
+export function sendRawMessage(corpId, appSecret, toUser, openKfId, msgtype, payload) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, msgtype, payload);
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAS9D,MAAM,QAAQ,GAAG;IACf,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;CACgB,CAAC;AAE5C,MAAM,IAAI,GAAG,qCAAqC,CAAC;AAEnD;;;;GAIG;AACH,SAAS,WAAW,CAAC,OAA2B;IAC9C,OAAO,CAAC,CAAC,OAAO,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,OAAO,CAAI,IAAY,EAAE,KAAa,EAAE,IAAa;IAClE,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,IAAI,iBAAiB,KAAK,EAAE,EAAE;QAC/D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC;KACjD,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,IAAI,SAAS,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAM,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,qBAAqB,CAAI,IAAY,EAAE,MAAc,EAAE,SAAiB,EAAE,IAAa;IACpG,IAAI,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAI,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAEjD,MAAM,MAAM,GAAG,IAA+B,CAAC;IAC/C,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAClF,gBAAgB,EAAE,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,CAClC,GAAG,MAAM,EAAE,2BAA2B,MAAM,CAAC,OAAO,8BAA8B,IAAI,EAAE,CACzF,CAAC;QACF,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpC,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAChD,OAAO,OAAO,CAAI,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mCAAmC;AACnC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,SAAiB,EACjB,MAA8B;IAE9B,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAA0B,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7G,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,qBAAqB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAiBD,KAAK,UAAU,WAAW,CACxB,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,OAAsB,EACtB,OAAgC;IAEhC,MAAM,IAAI,GAA2B;QACnC,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,QAAQ;QACnB,OAAO;QACP,GAAG,OAAO;KACX,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAA0B,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3G,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,qBAAqB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,OAAe;IAEf,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,SAAiB,EACjB,OAAe;IAEf,MAAM,eAAe,GAAG,KAAK,EAC3B,KAAa,EACwE,EAAE;QACvF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,2BAA2B,KAAK,aAAa,OAAO,EAAE,EAAE;YACtF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC;SAC9C,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,2BAA2B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAwC,CAAC;YACxE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9F,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC;IACxE,CAAC,CAAC;IAEF,IAAI,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IAE5C,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,4CAA4C;QAC5C,IAAI,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5C,gBAAgB,EAAE,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,CAClC,GAAG,MAAM,EAAE,2BAA2B,MAAM,CAAC,OAAO,2CAA2C,CAChG,CAAC;YACF,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACpC,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,2BAA2B,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACzF,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;QAClE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,2BAA2B,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;AACpE,CAAC;AAMD,kCAAkC;AAClC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,SAAiB,EACjB,IAAqB,EACrB,MAAc,EACd,QAAgB;IAEhB,MAAM,QAAQ,GAAG,KAAK,EAAE,KAAa,EAAsC,EAAE;QAC3E,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAA2B,CAAC;QACrE,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;QACzD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEzC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,8BAA8B,KAAK,SAAS,IAAI,EAAE,EAAE;YAClF,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC;SAC9C,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,sBAAsB,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAA8B,CAAC;IAC1D,CAAC,CAAC;IAEF,IAAI,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpD,IAAI,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEjC,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,gBAAgB,EAAE,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,CAClC,GAAG,MAAM,EAAE,2BAA2B,IAAI,CAAC,OAAO,yCAAyC,CAC5F,CAAC;QACF,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpC,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAChD,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,yBAAyB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,OAAe;IAEf,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AACrG,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,OAAe;IAEf,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AACrG,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,OAAe;IAEf,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AACrG,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,OAAe;IAEf,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AACnG,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,IAA2E;IAE3E,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,QAAkF;IAElF,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AACpF,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,WAAwF;IAExF,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,OAA0C;IAE1C,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,uBAAuB,CACrC,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,YAAgC;IAEhC,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAC5G,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,MAA4B;IAE5B,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,OAAe,EACf,OAAgC;IAEhC,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAwB,EAAE,OAAO,CAAC,CAAC;AAC7F,CAAC"}

package/dist/bot.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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 type { ChannelLogSink, OpenClawConfig } from "openclaw/plugin-sdk";
+import type { ResolvedWechatKfAccount, WechatKfMessage } from "./types.js";
+/** Minimal runtime shape used only for error logging in the reply dispatcher. */
+export type RuntimeErrorLogger = {
+    error?: (...args: unknown[]) => void;
+    [key: string]: unknown;
+};
+export type BotContext = {
+    cfg: OpenClawConfig;
+    runtime?: RuntimeErrorLogger;
+    stateDir: string;
+    log?: ChannelLogSink;
+};
+declare function isDuplicate(msgid: string): boolean;
+/** Exposed for testing only — do not use in production code. */
+export declare const _testing: {
+    kfLocks: Map<string, Promise<void>>;
+    processedMsgIds: Set<string>;
+    isDuplicate: typeof isDuplicate;
+    DEDUP_MAX_SIZE: number;
+    handleEvent: typeof handleEvent;
+    drainToLatestCursor: typeof drainToLatestCursor;
+    resetState(): void;
+};
+declare function handleEvent(ctx: BotContext, _account: ResolvedWechatKfAccount, msg: WechatKfMessage): Promise<void>;
+declare function drainToLatestCursor(corpId: string, appSecret: string, openKfId: string, syncToken: string, stateDir: string, log?: ChannelLogSink): Promise<void>;
+export declare function handleWebhookEvent(ctx: BotContext, openKfId: string, syncToken: string): Promise<void>;
+export {};