@pawastation/wechat-kf 0.1.1

package/dist/src/channel.js

@@ -0,0 +1,183 @@
+/**
+ * WeChat KF ChannelPlugin implementation
+ *
+ * Dynamically discovers kfids from webhook callbacks.
+ * Each kfid = one accountId = one independent session.
+ */
+import { homedir } from "node:os";
+import { deleteKfId, disableKfId, enableKfId, getChannelConfig, listAccountIds, resolveAccount } from "./accounts.js";
+import { wechatKfConfigSchema } from "./config-schema.js";
+import { startMonitor } from "./monitor.js";
+import { wechatKfOutbound } from "./outbound.js";
+const meta = {
+    id: "wechat-kf",
+    label: "WeChat KF",
+    selectionLabel: "WeChat Customer Service (微信客服)",
+    docsPath: "/channels/wechat-kf",
+    docsLabel: "wechat-kf",
+    blurb: "WeCom Customer Service (企业微信客服) API channel — let WeChat users chat with your agent.",
+    aliases: ["wxkf"],
+    order: 80,
+};
+export const wechatKfPlugin = {
+    id: "wechat-kf",
+    meta: { ...meta },
+    capabilities: {
+        chatTypes: ["direct"],
+        media: true,
+        reactions: false,
+        threads: false,
+        polls: false,
+        nativeCommands: false,
+        blockStreaming: false,
+    },
+    agentPrompt: {
+        messageToolHints: () => [
+            "- WeChat KF: omit `target` to reply to current conversation.",
+            "- Supports text and media messages (image, voice, video, file).",
+            "- 48h reply window, max 5 replies per window.",
+            "- To send a rich link card, include `[[wechat_link: title | desc | url | thumbUrl]]` in your reply. Fields: title (required), desc (optional), url (required, must be https://), thumbUrl (optional, thumbnail image URL). Example: `[[wechat_link: Article Title | Brief description | https://example.com/article | https://example.com/thumb.jpg]]`",
+        ],
+    },
+    reload: { configPrefixes: ["channels.wechat-kf"] },
+    configSchema: { schema: wechatKfConfigSchema },
+    config: {
+        listAccountIds: (cfg) => listAccountIds(cfg),
+        resolveAccount: (cfg, accountId) => resolveAccount(cfg, accountId),
+        defaultAccountId: (cfg) => listAccountIds(cfg)[0] ?? "default",
+        setAccountEnabled: ({ cfg, accountId, enabled }) => {
+            // Dynamic accounts — toggle via in-memory disabled set (persisted to disk).
+            // Fire-and-forget: the async persist is best-effort; the in-memory state
+            // takes effect immediately so the framework sees the change right away.
+            if (enabled) {
+                void enableKfId(accountId);
+            }
+            else {
+                void disableKfId(accountId);
+            }
+            return cfg;
+        },
+        deleteAccount: ({ cfg, accountId }) => {
+            // Remove from discovered set and add to disabled set so it won't come
+            // back from future webhook callbacks. Fire-and-forget for persistence.
+            void deleteKfId(accountId);
+            return cfg;
+        },
+        isConfigured: (account) => account.configured,
+        describeAccount: (account) => ({
+            accountId: account.accountId,
+            enabled: account.enabled,
+            configured: account.configured,
+            corpId: account.corpId,
+            openKfId: account.openKfId,
+        }),
+        resolveAllowFrom: ({ cfg }) => {
+            const config = getChannelConfig(cfg);
+            return (config.allowFrom ?? []).map(String);
+        },
+        formatAllowFrom: ({ allowFrom }) => allowFrom.map((e) => e.trim()).filter(Boolean),
+    },
+    security: {
+        resolveDmPolicy: ({ cfg }) => {
+            const config = getChannelConfig(cfg);
+            const policy = config.dmPolicy ?? "open";
+            return {
+                policy,
+                allowFrom: config.allowFrom ?? [],
+                allowFromPath: "channels.wechat-kf.allowFrom",
+                approveHint: [
+                    "To approve a WeChat KF user, add their external_userid to the allowlist:",
+                    "  openclaw config set channels.wechat-kf.allowFrom '[\"{userid}\"]'",
+                ].join("\n"),
+                normalizeEntry: (raw) => raw.replace(/^user:/i, "").trim(),
+            };
+        },
+        collectWarnings: ({ cfg }) => {
+            const config = getChannelConfig(cfg);
+            const policy = config.dmPolicy ?? "open";
+            if (policy === "open") {
+                return ['- WeChat KF: dmPolicy="open" — any WeChat user can chat with the agent.'];
+            }
+            return [];
+        },
+    },
+    setup: {
+        resolveAccountId: (_cfg, accountId) => accountId ?? "default",
+        applyAccountConfig: ({ cfg }) => {
+            const config = getChannelConfig(cfg);
+            return {
+                ...cfg,
+                channels: { ...(cfg.channels ?? {}), "wechat-kf": { ...config, enabled: true } },
+            };
+        },
+    },
+    outbound: wechatKfOutbound,
+    status: {
+        defaultRuntime: {
+            accountId: "default",
+            running: false,
+            lastStartAt: null,
+            lastStopAt: null,
+            lastError: null,
+            port: null,
+        },
+        buildChannelSummary: ({ snapshot }) => ({
+            configured: snapshot.configured ?? false,
+            running: snapshot.running ?? false,
+            lastStartAt: snapshot.lastStartAt ?? null,
+            lastError: snapshot.lastError ?? null,
+            port: snapshot.port ?? null,
+        }),
+        buildAccountSnapshot: ({ account, runtime, }) => ({
+            accountId: account.accountId,
+            enabled: account.enabled,
+            configured: account.configured,
+            corpId: account.corpId,
+            running: runtime?.running ?? false,
+            lastStartAt: runtime?.lastStartAt ?? null,
+            lastError: runtime?.lastError ?? null,
+            port: runtime?.port ?? null,
+        }),
+    },
+    gateway: {
+        /** Track whether the account is currently started to prevent duplicate launches. */
+        _started: false,
+        startAccount: async (ctx) => {
+            const self = wechatKfPlugin.gateway;
+            // Idempotency guard — skip if already started
+            if (self._started) {
+                ctx.log?.info("[wechat-kf] startAccount: already running, skipping duplicate call");
+                return;
+            }
+            const config = getChannelConfig(ctx.cfg);
+            const port = config.webhookPort ?? 9999;
+            const path = config.webhookPath ?? "/wechat-kf";
+            try {
+                self._started = true;
+                ctx.setStatus?.({ accountId: ctx.accountId, port, running: true, lastStartAt: new Date().toISOString() });
+                ctx.log?.info(`[wechat-kf] starting on :${port}${path}`);
+                const stateDir = ctx.runtime?.state?.resolveStateDir?.() ?? `${homedir()}/.openclaw/state/wechat-kf`;
+                await startMonitor({
+                    cfg: ctx.cfg,
+                    runtime: ctx.runtime,
+                    abortSignal: ctx.abortSignal,
+                    stateDir,
+                    log: ctx.log,
+                });
+            }
+            catch (err) {
+                self._started = false;
+                ctx.setStatus?.({
+                    accountId: ctx.accountId,
+                    port,
+                    running: false,
+                    lastError: err instanceof Error ? err.message : String(err),
+                    lastStopAt: new Date().toISOString(),
+                });
+                ctx.log?.error?.(`[wechat-kf] startAccount failed: ${err instanceof Error ? err.message : String(err)}`);
+                throw err;
+            }
+        },
+    },
+};
+//# sourceMappingURL=channel.js.map

package/dist/src/channel.js.map

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

package/dist/src/chunk-utils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Text chunking utilities for WeChat KF message splitting.
+ *
+ * Splits long text into chunks that fit within the WeChat character limit,
+ * preferring natural boundaries (newlines, then whitespace) before hard-cutting.
+ */
+/**
+ * Split `text` into chunks of at most `limit` characters.
+ *
+ * Strategy (per chunk):
+ *  1. If remaining text fits within `limit`, emit it as the final chunk.
+ *  2. Look for the last newline (`\n`) within the first `limit` characters.
+ *  3. Failing that, look for the last whitespace character.
+ *  4. Failing that, hard-cut at exactly `limit` characters.
+ *
+ * Chunks are trimmed; empty chunks are never returned.
+ */
+export declare function chunkText(text: string, limit: number): string[];

package/dist/src/chunk-utils.js

@@ -0,0 +1,58 @@
+/**
+ * Text chunking utilities for WeChat KF message splitting.
+ *
+ * Splits long text into chunks that fit within the WeChat character limit,
+ * preferring natural boundaries (newlines, then whitespace) before hard-cutting.
+ */
+/**
+ * Split `text` into chunks of at most `limit` characters.
+ *
+ * Strategy (per chunk):
+ *  1. If remaining text fits within `limit`, emit it as the final chunk.
+ *  2. Look for the last newline (`\n`) within the first `limit` characters.
+ *  3. Failing that, look for the last whitespace character.
+ *  4. Failing that, hard-cut at exactly `limit` characters.
+ *
+ * Chunks are trimmed; empty chunks are never returned.
+ */
+export function chunkText(text, limit) {
+    if (limit <= 0)
+        return [];
+    if (text.length <= limit) {
+        const trimmed = text.trim();
+        return trimmed.length > 0 ? [trimmed] : [];
+    }
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= limit) {
+            const trimmed = remaining.trim();
+            if (trimmed.length > 0) {
+                chunks.push(trimmed);
+            }
+            break;
+        }
+        const window = remaining.slice(0, limit);
+        // Try to split at the last newline within the window
+        let splitIdx = window.lastIndexOf("\n");
+        // Fall back to last whitespace
+        if (splitIdx <= 0) {
+            splitIdx = window.lastIndexOf(" ");
+        }
+        if (splitIdx <= 0) {
+            splitIdx = window.lastIndexOf("\t");
+        }
+        // Hard-cut if no suitable boundary found
+        if (splitIdx <= 0) {
+            splitIdx = limit;
+        }
+        const chunk = remaining.slice(0, splitIdx).trim();
+        if (chunk.length > 0) {
+            chunks.push(chunk);
+        }
+        // Advance past the split point (skip the delimiter character when splitting on boundary)
+        remaining = remaining.slice(splitIdx).trimStart();
+    }
+    return chunks;
+}
+//# sourceMappingURL=chunk-utils.js.map

package/dist/src/chunk-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-utils.js","sourceRoot":"","sources":["../../src/chunk-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa;IACnD,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1B,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,IAAI,CAAC;IAErB,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,SAAS,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YACD,MAAM;QACR,CAAC;QAED,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAEzC,qDAAqD;QACrD,IAAI,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAExC,+BAA+B;QAC/B,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QAED,yCAAyC;QACzC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;QAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QAED,yFAAyF;QACzF,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/config-schema.d.ts

@@ -0,0 +1,56 @@
+/**
+ * JSON Schema for wechat-kf channel config
+ *
+ * Authoritative source: openclaw.plugin.json → configSchema.
+ * This runtime copy must stay in sync with the manifest.
+ *
+ * Flat enterprise-level credentials. No per-account config needed —
+ * kfids are discovered dynamically from webhook callbacks.
+ */
+export declare const wechatKfConfigSchema: {
+    type: "object";
+    properties: {
+        enabled: {
+            type: "boolean";
+        };
+        corpId: {
+            type: "string";
+            description: string;
+        };
+        appSecret: {
+            type: "string";
+            description: string;
+        };
+        token: {
+            type: "string";
+            description: string;
+        };
+        encodingAESKey: {
+            type: "string";
+            description: string;
+            minLength: number;
+            maxLength: number;
+        };
+        webhookPort: {
+            type: "integer";
+            minimum: number;
+            maximum: number;
+            default: number;
+        };
+        webhookPath: {
+            type: "string";
+            default: string;
+        };
+        dmPolicy: {
+            type: "string";
+            enum: readonly ["open", "pairing", "allowlist", "disabled"];
+            default: string;
+        };
+        allowFrom: {
+            type: "array";
+            items: {
+                type: "string";
+            };
+        };
+    };
+};

package/dist/src/config-schema.js

@@ -0,0 +1,38 @@
+/**
+ * JSON Schema for wechat-kf channel config
+ *
+ * Authoritative source: openclaw.plugin.json → configSchema.
+ * This runtime copy must stay in sync with the manifest.
+ *
+ * Flat enterprise-level credentials. No per-account config needed —
+ * kfids are discovered dynamically from webhook callbacks.
+ */
+export const wechatKfConfigSchema = {
+    type: "object",
+    properties: {
+        enabled: { type: "boolean" },
+        corpId: { type: "string", description: "WeCom Corp ID (企业ID)" },
+        appSecret: { type: "string", description: "Self-built app secret (应用密钥)" },
+        token: { type: "string", description: "Webhook callback token" },
+        encodingAESKey: {
+            type: "string",
+            description: "43-character base64 AES key",
+            minLength: 43,
+            maxLength: 43,
+        },
+        webhookPort: {
+            type: "integer",
+            minimum: 1,
+            maximum: 65535,
+            default: 9999,
+        },
+        webhookPath: { type: "string", default: "/wechat-kf" },
+        dmPolicy: {
+            type: "string",
+            enum: ["open", "pairing", "allowlist", "disabled"],
+            default: "open",
+        },
+        allowFrom: { type: "array", items: { type: "string" } },
+    },
+};
+//# sourceMappingURL=config-schema.js.map

package/dist/src/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/config-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;QACrC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,WAAW,EAAE,sBAAsB,EAAE;QACxE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,WAAW,EAAE,8BAA8B,EAAE;QACnF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACzE,cAAc,EAAE;YACd,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,6BAA6B;YAC1C,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,EAAE;SACd;QACD,WAAW,EAAE;YACX,IAAI,EAAE,SAAkB;YACxB,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;SACd;QACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,YAAY,EAAE;QAC/D,QAAQ,EAAE;YACR,IAAI,EAAE,QAAiB;YACvB,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,CAAU;YAC3D,OAAO,EAAE,MAAM;SAChB;QACD,SAAS,EAAE,EAAE,IAAI,EAAE,OAAgB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,EAAE;KAC1E;CACF,CAAC"}

package/dist/src/constants.d.ts

@@ -0,0 +1,19 @@
+/** WeChat KF text message character limit */
+export declare const WECHAT_TEXT_CHUNK_LIMIT = 2000;
+/** Timeout for token fetch requests (ms) */
+export declare const TOKEN_FETCH_TIMEOUT_MS = 15000;
+/** Timeout for API POST requests (ms) */
+export declare const API_POST_TIMEOUT_MS = 30000;
+/** Timeout for media download/upload requests (ms) */
+export declare const MEDIA_TIMEOUT_MS = 60000;
+/** WeChat errcode values that indicate an expired or invalid access token */
+export declare const TOKEN_EXPIRED_CODES: Set<number>;
+/**
+ * WeChat KF errcode indicating the 48-hour / 5-message session limit has
+ * been exceeded. When a customer service session is inactive for 48 hours,
+ * or the agent has already sent 5 messages without a customer reply, the
+ * API returns this error.
+ */
+export declare const WECHAT_MSG_LIMIT_ERRCODE = 95026;
+/** Timeout for downloading media from external HTTP URLs (ms) */
+export declare const MEDIA_DOWNLOAD_TIMEOUT_MS = 60000;

package/dist/src/constants.js

@@ -0,0 +1,20 @@
+/** WeChat KF text message character limit */
+export const WECHAT_TEXT_CHUNK_LIMIT = 2000;
+/** Timeout for token fetch requests (ms) */
+export const TOKEN_FETCH_TIMEOUT_MS = 15_000;
+/** Timeout for API POST requests (ms) */
+export const API_POST_TIMEOUT_MS = 30_000;
+/** Timeout for media download/upload requests (ms) */
+export const MEDIA_TIMEOUT_MS = 60_000;
+/** WeChat errcode values that indicate an expired or invalid access token */
+export const TOKEN_EXPIRED_CODES = new Set([40014, 42001, 40001]);
+/**
+ * WeChat KF errcode indicating the 48-hour / 5-message session limit has
+ * been exceeded. When a customer service session is inactive for 48 hours,
+ * or the agent has already sent 5 messages without a customer reply, the
+ * API returns this error.
+ */
+export const WECHAT_MSG_LIMIT_ERRCODE = 95026;
+/** Timeout for downloading media from external HTTP URLs (ms) */
+export const MEDIA_DOWNLOAD_TIMEOUT_MS = 60_000;
+//# sourceMappingURL=constants.js.map

package/dist/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAElE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAE9C,iEAAiE;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC"}

package/dist/src/crypto.d.ts

@@ -0,0 +1,18 @@
+/**
+ * WeCom message encryption/decryption
+ *
+ * - Signature: SHA1(sort([token, timestamp, nonce, encrypt]))
+ * - Encryption: AES-256-CBC, key = Base64Decode(EncodingAESKey + "="), iv = key[0:16]
+ * - Plaintext format: random(16B) + msg_len(4B network order) + msg + receiveid
+ */
+export declare function deriveAesKey(encodingAESKey: string): Buffer;
+/** SHA1 signature verification */
+export declare function computeSignature(token: string, timestamp: string, nonce: string, encrypt: string): string;
+export declare function verifySignature(token: string, timestamp: string, nonce: string, encrypt: string, expectedSignature: string): boolean;
+/** Decrypt an encrypted message from WeChat callback */
+export declare function decrypt(encodingAESKey: string, encrypted: string): {
+    message: string;
+    receiverId: string;
+};
+/** Encrypt a message for WeChat callback response */
+export declare function encrypt(encodingAESKey: string, message: string, receiverId: string): string;

package/dist/src/crypto.js

@@ -0,0 +1,80 @@
+/**
+ * WeCom message encryption/decryption
+ *
+ * - Signature: SHA1(sort([token, timestamp, nonce, encrypt]))
+ * - Encryption: AES-256-CBC, key = Base64Decode(EncodingAESKey + "="), iv = key[0:16]
+ * - Plaintext format: random(16B) + msg_len(4B network order) + msg + receiveid
+ */
+import { createCipheriv, createDecipheriv, createHash, randomBytes, timingSafeEqual } from "node:crypto";
+export function deriveAesKey(encodingAESKey) {
+    if (encodingAESKey.length !== 43) {
+        throw new Error(`[wechat-kf] EncodingAESKey must be 43 characters, got ${encodingAESKey.length}`);
+    }
+    const key = Buffer.from(`${encodingAESKey}=`, "base64");
+    if (key.length !== 32) {
+        throw new Error(`[wechat-kf] derived AES key must be 32 bytes, got ${key.length}`);
+    }
+    return key;
+}
+/** SHA1 signature verification */
+export function computeSignature(token, timestamp, nonce, encrypt) {
+    const items = [token, timestamp, nonce, encrypt].sort();
+    return createHash("sha1").update(items.join("")).digest("hex");
+}
+export function verifySignature(token, timestamp, nonce, encrypt, expectedSignature) {
+    const actual = Buffer.from(computeSignature(token, timestamp, nonce, encrypt), "utf8");
+    const expected = Buffer.from(expectedSignature, "utf8");
+    if (actual.length !== expected.length)
+        return false;
+    return timingSafeEqual(actual, expected);
+}
+/** Decrypt an encrypted message from WeChat callback */
+export function decrypt(encodingAESKey, encrypted) {
+    const aesKey = deriveAesKey(encodingAESKey);
+    const iv = aesKey.subarray(0, 16);
+    const decipher = createDecipheriv("aes-256-cbc", aesKey, iv);
+    decipher.setAutoPadding(false);
+    const decrypted = Buffer.concat([decipher.update(encrypted, "base64"), decipher.final()]);
+    // Remove PKCS#7 padding — validate ALL N padding bytes equal N
+    const pad = decrypted[decrypted.length - 1];
+    if (pad < 1 || pad > 32 || pad > decrypted.length) {
+        throw new Error("[wechat-kf] invalid PKCS#7 padding");
+    }
+    for (let i = 1; i <= pad; i++) {
+        if (decrypted[decrypted.length - i] !== pad) {
+            throw new Error("[wechat-kf] invalid PKCS#7 padding");
+        }
+    }
+    const content = decrypted.subarray(0, decrypted.length - pad);
+    // Parse: random(16) + msg_len(4, big-endian) + msg + receiverId
+    if (content.length < 20) {
+        throw new Error("[wechat-kf] decrypted content too short");
+    }
+    const msgLen = content.readUInt32BE(16);
+    if (msgLen < 0 || 20 + msgLen > content.length) {
+        throw new Error("[wechat-kf] invalid message length in decrypted content");
+    }
+    const message = content.subarray(20, 20 + msgLen).toString("utf8");
+    const receiverId = content.subarray(20 + msgLen).toString("utf8");
+    return { message, receiverId };
+}
+/** Encrypt a message for WeChat callback response */
+export function encrypt(encodingAESKey, message, receiverId) {
+    const aesKey = deriveAesKey(encodingAESKey);
+    const iv = aesKey.subarray(0, 16);
+    const random = randomBytes(16);
+    const msgBuf = Buffer.from(message, "utf8");
+    const receiverBuf = Buffer.from(receiverId, "utf8");
+    const msgLenBuf = Buffer.alloc(4);
+    msgLenBuf.writeUInt32BE(msgBuf.length, 0);
+    const plaintext = Buffer.concat([random, msgLenBuf, msgBuf, receiverBuf]);
+    // PKCS#7 padding to 32-byte blocks
+    const blockSize = 32;
+    const padLen = blockSize - (plaintext.length % blockSize);
+    const padding = Buffer.alloc(padLen, padLen);
+    const padded = Buffer.concat([plaintext, padding]);
+    const cipher = createCipheriv("aes-256-cbc", aesKey, iv);
+    cipher.setAutoPadding(false);
+    return Buffer.concat([cipher.update(padded), cipher.final()]).toString("base64");
+}
+//# sourceMappingURL=crypto.js.map

package/dist/src/crypto.js.map

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

package/dist/src/fs-utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * File-system utilities — atomic write via temp file + rename.
+ *
+ * On POSIX systems, `rename()` within the same filesystem is atomic,
+ * so the target file is never left in a partially-written state.
+ */
+export declare function atomicWriteFile(filePath: string, content: string, encoding?: BufferEncoding): Promise<void>;

package/dist/src/fs-utils.js

@@ -0,0 +1,13 @@
+/**
+ * File-system utilities — atomic write via temp file + rename.
+ *
+ * On POSIX systems, `rename()` within the same filesystem is atomic,
+ * so the target file is never left in a partially-written state.
+ */
+import { rename, writeFile } from "node:fs/promises";
+export async function atomicWriteFile(filePath, content, encoding = "utf8") {
+    const tmpPath = `${filePath}.tmp`;
+    await writeFile(tmpPath, content, encoding);
+    await rename(tmpPath, filePath); // atomic on the same filesystem
+}
+//# sourceMappingURL=fs-utils.js.map

package/dist/src/fs-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../../src/fs-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAAe,EACf,WAA2B,MAAM;IAEjC,MAAM,OAAO,GAAG,GAAG,QAAQ,MAAM,CAAC;IAClC,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,gCAAgC;AACnE,CAAC"}

package/dist/src/monitor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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 type { Server } from "node:http";
+import { type Logger } from "./bot.js";
+import type { PluginRuntime } from "./runtime.js";
+import type { OpenClawConfig } from "./types.js";
+export type MonitorContext = {
+    cfg: OpenClawConfig;
+    runtime?: PluginRuntime;
+    abortSignal?: AbortSignal;
+    stateDir: string;
+    log?: Logger;
+};
+export declare function startMonitor(ctx: MonitorContext): Promise<Server>;