@pawastation/wechat-kf 0.1.2 → 0.2.0

package/dist/src/constants.js

@@ -1,3 +1,26 @@
+import { homedir } from "node:os";
+/** Channel identifier — single source of truth for the plugin ID string. */
+export const CHANNEL_ID = "wechat-kf";
+/** Default webhook path registered on the framework's shared gateway. */
+export const DEFAULT_WEBHOOK_PATH = `/${CHANNEL_ID}`;
+/** Config key prefix for this channel in OpenClaw config. */
+export const CONFIG_KEY = `channels.${CHANNEL_ID}`;
+/** Build a log-tag prefix: `[wechat-kf]` or `[wechat-kf:kfId]`. */
+export function logTag(kfId) {
+    return kfId ? `[${CHANNEL_ID}:${kfId}]` : `[${CHANNEL_ID}]`;
+}
+/** Default state directory for cursor and kfid persistence. */
+export function defaultStateDir() {
+    return `${homedir()}/.openclaw/state/${CHANNEL_ID}`;
+}
+/** Cursor file name for a given kfId. */
+export function cursorFileName(kfId) {
+    return `${CHANNEL_ID}-cursor-${kfId}.txt`;
+}
+/** Persisted file name for discovered kfids. */
+export const KFIDS_FILE = `${CHANNEL_ID}-kfids.json`;
+/** Persisted file name for disabled kfids. */
+export const DISABLED_KFIDS_FILE = `${CHANNEL_ID}-disabled-kfids.json`;
 /** WeChat KF text message character limit */
 export const WECHAT_TEXT_CHUNK_LIMIT = 2000;
 /** Timeout for token fetch requests (ms) */
@@ -17,4 +40,10 @@ export const TOKEN_EXPIRED_CODES = new Set([40014, 42001, 40001]);
 export const WECHAT_MSG_LIMIT_ERRCODE = 95026;
 /** Timeout for downloading media from external HTTP URLs (ms) */
 export const MEDIA_DOWNLOAD_TIMEOUT_MS = 60_000;
+/** Max age (seconds) for inbound messages. Messages older than this are skipped. */
+export const MAX_MESSAGE_AGE_S = 300; // 5 minutes
+/** Format an unknown caught value for log messages (no stack traces). */
+export function formatError(err) {
+    return err instanceof Error ? err.message : String(err);
+}
 //# sourceMappingURL=constants.js.map

package/dist/src/constants.js.map

@@ -1 +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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,UAAU,GAAG,WAAoB,CAAC;AAE/C,yEAAyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,UAAU,EAAE,CAAC;AAErD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,UAAU,EAAE,CAAC;AAEnD,mEAAmE;AACnE,MAAM,UAAU,MAAM,CAAC,IAAa;IAClC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,UAAU,GAAG,CAAC;AAC9D,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,eAAe;IAC7B,OAAO,GAAG,OAAO,EAAE,oBAAoB,UAAU,EAAE,CAAC;AACtD,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,GAAG,UAAU,WAAW,IAAI,MAAM,CAAC;AAC5C,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,UAAU,aAAa,CAAC;AAErD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,UAAU,sBAAsB,CAAC;AAEvE,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;AAEhD,oFAAoF;AACpF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC,CAAC,YAAY;AAElD,yEAAyE;AACzE,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/dist/src/crypto.js

@@ -6,13 +6,14 @@
  * - Plaintext format: random(16B) + msg_len(4B network order) + msg + receiveid
  */
 import { createCipheriv, createDecipheriv, createHash, randomBytes, timingSafeEqual } from "node:crypto";
+import { logTag } from "./constants.js";
 export function deriveAesKey(encodingAESKey) {
     if (encodingAESKey.length !== 43) {
-        throw new Error(`[wechat-kf] EncodingAESKey must be 43 characters, got ${encodingAESKey.length}`);
+        throw new Error(`${logTag()} 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}`);
+        throw new Error(`${logTag()} derived AES key must be 32 bytes, got ${key.length}`);
     }
     return key;
 }
@@ -38,21 +39,21 @@ export function decrypt(encodingAESKey, encrypted) {
     // 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");
+        throw new Error(`${logTag()} 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");
+            throw new Error(`${logTag()} 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");
+        throw new Error(`${logTag()} 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");
+        throw new Error(`${logTag()} invalid message length in decrypted content`);
     }
     const message = content.subarray(20, 20 + msgLen).toString("utf8");
     const receiverId = content.subarray(20 + msgLen).toString("utf8");

package/dist/src/crypto.js.map

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

package/dist/src/monitor.d.ts

@@ -1,18 +1,31 @@
 /**
- * Monitor — starts webhook server and manages lifecycle
+ * Shared context manager for WeChat KF plugin
  *
- * Single webhook server for the enterprise. KfIds are discovered dynamically
- * from webhook callbacks. Polling fallback iterates all known kfids.
+ * Provides a rendezvous point between the "default" account (which sets up
+ * enterprise-level shared infrastructure) and per-kfId accounts (which need
+ * the shared crypto config and BotContext to start polling).
  */
-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;
+import type { BotContext } from "./bot.js";
+export type SharedContext = {
+    callbackToken: string;
+    encodingAESKey: string;
+    corpId: string;
+    appSecret: string;
+    webhookPath: string;
+    botCtx: BotContext;
 };
-export declare function startMonitor(ctx: MonitorContext): Promise<Server>;
+export declare function setPairingKfId(externalUserId: string, openKfId: string): void;
+export declare function getPairingKfId(externalUserId: string): string | undefined;
+/** Set the shared context. Resolves any pending waitForSharedContext calls. */
+export declare function setSharedContext(ctx: SharedContext): void;
+/** Get the shared context, or null if not yet set. */
+export declare function getSharedContext(): SharedContext | null;
+/**
+ * Wait until the shared context is set.
+ * Rejects if the signal aborts before the context is ready.
+ */
+export declare function waitForSharedContext(signal?: AbortSignal): Promise<SharedContext>;
+/** Clear the shared context (used during shutdown). */
+export declare function clearSharedContext(): void;
+/** Reset all module-level state. @internal For testing only. */
+export declare function _reset(): void;

package/dist/src/monitor.js

@@ -1,131 +1,78 @@
 /**
- * Monitor — starts webhook server and manages lifecycle
+ * Shared context manager for WeChat KF plugin
  *
- * Single webhook server for the enterprise. KfIds are discovered dynamically
- * from webhook callbacks. Polling fallback iterates all known kfids.
+ * Provides a rendezvous point between the "default" account (which sets up
+ * enterprise-level shared infrastructure) and per-kfId accounts (which need
+ * the shared crypto config and BotContext to start polling).
  */
-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 () => { },
+// ── Module-level state ──
+let sharedCtx = null;
+let readyResolve = null;
+let readyPromise = null;
+/** Cache: externalUserId → openKfId for pairing approval notifications. */
+const pairingKfIdCache = new Map();
+export function setPairingKfId(externalUserId, openKfId) {
+    pairingKfIdCache.set(externalUserId, openKfId);
+}
+export function getPairingKfId(externalUserId) {
+    return pairingKfIdCache.get(externalUserId);
+}
+function ensureReadyPromise() {
+    if (!readyPromise) {
+        readyPromise = new Promise((resolve) => {
+            readyResolve = resolve;
         });
-        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`);
+    return readyPromise;
+}
+/** Set the shared context. Resolves any pending waitForSharedContext calls. */
+export function setSharedContext(ctx) {
+    sharedCtx = ctx;
+    // Resolve waiting callers
+    if (readyResolve) {
+        readyResolve();
+        readyResolve = null;
     }
-    catch (err) {
-        log?.warn?.(`[wechat-kf] access_token validation failed (will retry on first message): ${err}`);
+}
+/** Get the shared context, or null if not yet set. */
+export function getSharedContext() {
+    return sharedCtx;
+}
+/**
+ * Wait until the shared context is set.
+ * Rejects if the signal aborts before the context is ready.
+ */
+export function waitForSharedContext(signal) {
+    // Already available — fast path
+    if (sharedCtx)
+        return Promise.resolve(sharedCtx);
+    // Already aborted
+    if (signal?.aborted) {
+        return Promise.reject(new DOMException("The operation was aborted.", "AbortError"));
     }
-    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);
+    const ready = ensureReadyPromise();
+    return new Promise((resolve, reject) => {
+        const onReady = () => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve(sharedCtx);
         };
-        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");
+        const onAbort = () => {
+            reject(new DOMException("The operation was aborted.", "AbortError"));
         };
-        // 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;
+        signal?.addEventListener("abort", onAbort, { once: true });
+        ready.then(onReady);
+    });
+}
+/** Clear the shared context (used during shutdown). */
+export function clearSharedContext() {
+    sharedCtx = null;
+    pairingKfIdCache.clear();
+}
+/** Reset all module-level state. @internal For testing only. */
+export function _reset() {
+    sharedCtx = null;
+    readyResolve = null;
+    readyPromise = null;
+    pairingKfIdCache.clear();
 }
 //# sourceMappingURL=monitor.js.map

package/dist/src/monitor.js.map

@@ -1 +1 @@
-{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../src/monitor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../src/monitor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,2BAA2B;AAE3B,IAAI,SAAS,GAAyB,IAAI,CAAC;AAC3C,IAAI,YAAY,GAAwB,IAAI,CAAC;AAC7C,IAAI,YAAY,GAAyB,IAAI,CAAC;AAE9C,2EAA2E;AAC3E,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEnD,MAAM,UAAU,cAAc,CAAC,cAAsB,EAAE,QAAgB;IACrE,gBAAgB,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,cAAsB;IACnD,OAAO,gBAAgB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,kBAAkB;IACzB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC3C,YAAY,GAAG,OAAO,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,GAAkB;IACjD,SAAS,GAAG,GAAG,CAAC;IAChB,0BAA0B;IAC1B,IAAI,YAAY,EAAE,CAAC;QACjB,YAAY,EAAE,CAAC;QACf,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,gCAAgC;IAChC,IAAI,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEjD,kBAAkB;IAClB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IAEnC,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpD,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,CAAC,SAAU,CAAC,CAAC;QACtB,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,CAAC,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC;QAEF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,kBAAkB;IAChC,SAAS,GAAG,IAAI,CAAC;IACjB,gBAAgB,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,MAAM;IACpB,SAAS,GAAG,IAAI,CAAC;IACjB,YAAY,GAAG,IAAI,CAAC;IACpB,YAAY,GAAG,IAAI,CAAC;IACpB,gBAAgB,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/src/outbound.d.ts

@@ -5,12 +5,15 @@
  *   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.
+ *   Text is first converted from markdown to Unicode formatting (formatText),
+ *   then chunked via the runtime's `chunkTextWithMode` helper (respecting user
+ *   `chunkMode` config).  Framework auto-chunking is disabled (`chunker: null`)
+ *   because it would chunk *before* formatting, causing post-format expansion
+ *   (Unicode math-bold chars are 2 `.length` units each) to exceed the limit.
  *
- *   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`.
+ *   For media, the framework's `loadWebMedia` handles all URL formats
+ *   (HTTP, file://, local paths, MEDIA: prefix, ~), then the buffer is
+ *   uploaded to WeChat and sent using `uploadAndSendMedia` from `send-utils.ts`.
  *
  * WeChat KF session limits:
  *   The API enforces a 48-hour / 5-message limit per session window.
@@ -25,42 +28,5 @@
  *
  * 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>;
-};
+import type { ChannelOutboundAdapter } from "openclaw/plugin-sdk";
+export declare const wechatKfOutbound: ChannelOutboundAdapter;