@onlyne/im-wechat 0.0.0-stage → 3.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dbydd
+
+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/README.md

@@ -1,3 +1,47 @@
-# Temporary Holding Version
+# @onlyne/im-wechat
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The WeChat connector for the Onlyne IM gateway. It uses the official iLink (ClawBot) bot API:
+long-poll for inbound messages, send text with the conversation context token, and report typing.
+
+## Credential
+
+The constructor accepts a `WECHAT_ILINK_BOT_TOKEN` value from explicit configuration, a
+credential file, or the environment. `WECHAT_ILINK_BASE_URL` may override the platform base URL.
+The token comes from the ClawBot QR login flow, which the node does not drive itself.
+
+## Transport
+
+The connector long-polls `getupdates` and holds the platform continuation cursor in memory for
+the life of the poll loop. It advances that cursor only after the gateway stored every message in
+the batch. A listener failure leaves the cursor unchanged, and the platform replay is safe
+because resource delivery deduplicates by platform message id.
+
+## Supported
+
+| Direction | Capability |
+|---|---|
+| Inbound | Text, voice transcript, image, file, video, and audio handles |
+| Outbound | Text with the inbound context token, typing |
+
+Quoting, attachments, recall, and group administration are not implemented. A send without an
+inbound context token is refused by the platform, and that refusal is reported verbatim. An
+expired session (`ret = -14`) moves the connector to a paused state with an onboarding note and
+keeps retrying.
+
+## Example
+
+```ts
+import { createWechatConnector } from '@onlyne/im-wechat';
+
+const connector = createWechatConnector({ credentialFile: './credentials/wechat' });
+await connector.start();
+```
+
+## Sources
+
+- WeChat iLink openapi: <https://developers.weixin.qq.com/doc/aispeech/knowledge/openapi/Clawbotrelated.html>
+- Wire protocol: <https://github.com/Tencent/openclaw-weixin/blob/main/docs/protocol.md>
+
+## License
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+import type { Json } from '@onlyne/lib';
+import { type Connector, type SendOutcome } from '@onlyne/im-core';
+import { type WechatPort } from './port.js';
+export type { WechatConfigResponse, WechatMessage, WechatMessageItem, WechatMediaRef, WechatOutboundMessage, WechatPort, WechatPortOptions, WechatSendResponse, WechatUpdatesResponse, } from './port.js';
+export { WECHAT_DEFAULT_BASE_URL, WechatPortError, createWechatPort } from './port.js';
+export declare const WECHAT_CREDENTIAL_VARIABLES: readonly ["WECHAT_ILINK_BOT_TOKEN"];
+/** Platform operations the connector implements beyond `send`; a resource lists them. */
+export declare const WECHAT_OPERATIONS: readonly ["typing"];
+/** The host-side status view; `Connector` deliberately does not carry it, the gateway duck-types it. */
+export interface WechatStatus {
+    state: string;
+    connected: boolean;
+    reconnects: number;
+    rate_limits: number;
+    last_event_at?: string;
+    onboarding?: string[];
+    error?: string;
+}
+export interface WechatConnectorOptions {
+    /** The bot token from the ClawBot QR login; wins over file and environment. */
+    credential?: string;
+    /** Path to a file holding the token; `$VAR` references resolve from the environment. */
+    credentialFile?: string;
+    env?: Record<string, string | undefined>;
+    readFile?: (path: string) => Promise<string>;
+    baseUrl?: string;
+    /** The HTTP boundary; production leaves it unset and one is built from the credential. */
+    port?: WechatPort;
+    log?: (message: string, fields?: Record<string, unknown>) => void;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface WechatConnector extends Connector {
+    readonly operations: readonly string[];
+    validate(operation: string, data: Json): void;
+    operate(operation: string, data: Json): Promise<SendOutcome>;
+    status(): WechatStatus;
+}
+/**
+ * The iLink connector. Inbound is a long poll of `getupdates`: the cursor is the platform's
+ * `get_updates_buf`, held in memory only, and it moves forward at exactly one place — after every
+ * message of a batch was accepted by every listener. A rejected event leaves the cursor alone, so
+ * the next poll asks for the same batch again and the message is not lost.
+ */
+export declare function createWechatConnector(options?: WechatConnectorOptions): WechatConnector;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAqB,KAAK,SAAS,EAAgB,KAAK,WAAW,EAAoB,MAAM,iBAAiB,CAAC;AACtH,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AAInB,YAAY,EACV,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,UAAU,EACzG,iBAAiB,EAAE,kBAAkB,EAAE,qBAAqB,GAC7D,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEvF,eAAO,MAAM,2BAA2B,qCAAsC,CAAC;AAC/E,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,qBAAsB,CAAC;AASrD,wGAAwG;AACxG,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0FAA0F;IAC1F,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7D,MAAM,IAAI,YAAY,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CA+M3F"}

package/dist/index.js

@@ -0,0 +1,223 @@
+import { readFile as nodeReadFile } from 'node:fs/promises';
+import { setTimeout as sleepFor } from 'node:timers/promises';
+import { OnlyneError } from '@onlyne/lib';
+import { resolveCredential } from '@onlyne/im-core';
+import { WechatPortError, createWechatPort, detailOf, } from './port.js';
+import { normalizeMessage } from './normalize.js';
+import { conversationTarget, outcomeOf, sendMessage } from './send.js';
+export { WECHAT_DEFAULT_BASE_URL, WechatPortError, createWechatPort } from './port.js';
+export const WECHAT_CREDENTIAL_VARIABLES = ['WECHAT_ILINK_BOT_TOKEN'];
+/** Platform operations the connector implements beyond `send`; a resource lists them. */
+export const WECHAT_OPERATIONS = ['typing'];
+const PLATFORM = 'wechat';
+const BASE_BACKOFF_MS = 1_000;
+const MAX_BACKOFF_MS = 30_000;
+/** A dead session needs a QR scan, so retrying it fast only burns the operator's rate budget. */
+const SESSION_BACKOFF_MS = 60_000;
+const SESSION_ONBOARDING = 'WECHAT_ILINK_BOT_TOKEN (re-scan the ClawBot QR to refresh the session)';
+/**
+ * The iLink connector. Inbound is a long poll of `getupdates`: the cursor is the platform's
+ * `get_updates_buf`, held in memory only, and it moves forward at exactly one place — after every
+ * message of a batch was accepted by every listener. A rejected event leaves the cursor alone, so
+ * the next poll asks for the same batch again and the message is not lost.
+ */
+export function createWechatConnector(options = {}) {
+    const sleep = options.sleep ?? ((ms) => sleepFor(ms));
+    const clock = options.now ?? (() => Date.now());
+    let port = options.port;
+    let controller;
+    let state = 'stopped';
+    let connected = false;
+    let reconnects = 0;
+    let lastEventAt;
+    let onboarding = [];
+    let failureText;
+    const listeners = [];
+    /** One chain per conversation: the endpoint's `receive` calls land in arrival order. */
+    const queues = new Map();
+    function emit(event) {
+        const previous = queues.get(event.conversation) ?? Promise.resolve();
+        const next = previous.catch(() => undefined).then(async () => {
+            for (const listener of listeners)
+                await listener(event);
+        });
+        queues.set(event.conversation, next);
+        const settle = () => {
+            if (queues.get(event.conversation) === next)
+                queues.delete(event.conversation);
+        };
+        void next.then(settle, settle);
+        return next;
+    }
+    async function poll(client, signal) {
+        let cursor = '';
+        let failures = 0;
+        while (!signal.aborted) {
+            let batch;
+            try {
+                batch = await client.getUpdates(cursor, signal);
+            }
+            catch (failure) {
+                if (signal.aborted)
+                    return;
+                failures += 1;
+                reconnects += 1;
+                failureText = detailOf(failure);
+                if (failure instanceof WechatPortError && failure.sessionExpired) {
+                    state = 'paused';
+                    connected = false;
+                    onboarding = [SESSION_ONBOARDING];
+                    options.log?.('wechat: the iLink session expired; polling is paused until the ClawBot QR is scanned again', { error: failureText });
+                    await sleep(SESSION_BACKOFF_MS);
+                    continue;
+                }
+                state = 'error';
+                connected = false;
+                options.log?.('wechat: getupdates failed; retrying', { error: failureText, attempt: failures });
+                await sleep(Math.min(BASE_BACKOFF_MS * 2 ** (failures - 1), MAX_BACKOFF_MS));
+                continue;
+            }
+            if (signal.aborted)
+                return;
+            try {
+                for (const message of batch.msgs ?? []) {
+                    const event = normalizeMessage(message, clock);
+                    if (event === undefined)
+                        continue;
+                    await emit(event);
+                    lastEventAt = event.at;
+                }
+            }
+            catch (failure) {
+                failures += 1;
+                reconnects += 1;
+                failureText = detailOf(failure);
+                options.log?.('wechat: a listener rejected an event; the batch will be redelivered', { error: failureText, attempt: failures });
+                await sleep(Math.min(BASE_BACKOFF_MS * 2 ** (failures - 1), MAX_BACKOFF_MS));
+                continue;
+            }
+            if (signal.aborted)
+                return;
+            // The one place the cursor moves: the whole batch was accepted, so the platform may drop it.
+            cursor = batch.get_updates_buf ?? cursor;
+            failures = 0;
+            connected = true;
+            state = 'polling';
+            failureText = undefined;
+            onboarding = [];
+        }
+    }
+    /** The operation's target user id, validated before any platform call. */
+    function typingTarget(operation, data) {
+        if (!WECHAT_OPERATIONS.includes(operation)) {
+            throw new OnlyneError('invalid_request', `The WeChat connector does not implement ${operation}.`);
+        }
+        const raw = data !== null && typeof data === 'object' && !Array.isArray(data) ? data : undefined;
+        const conversation = raw?.conversation;
+        const target = typeof conversation === 'string' ? conversationTarget(conversation) : undefined;
+        if (target === undefined) {
+            throw new OnlyneError('invalid_request', 'typing names conversation as user:<id> or group:<id>.');
+        }
+        return target.id;
+    }
+    return {
+        platform: PLATFORM,
+        operations: WECHAT_OPERATIONS,
+        async start() {
+            if (controller !== undefined)
+                return;
+            if (port === undefined) {
+                const env = options.env ?? process.env;
+                const resolved = await resolveCredential({
+                    value: options.credential,
+                    file: options.credentialFile,
+                    variables: [...WECHAT_CREDENTIAL_VARIABLES],
+                }, options.readFile ?? (path => nodeReadFile(path, 'utf8')), env);
+                const token = resolved.value?.trim();
+                if (token === undefined || token.length === 0) {
+                    state = 'onboarding';
+                    connected = false;
+                    // An unreadable credential file is reported verbatim; a plain absence names the field.
+                    onboarding = [
+                        resolved.problem !== undefined && (options.credential !== undefined || options.credentialFile !== undefined)
+                            ? resolved.problem
+                            : WECHAT_CREDENTIAL_VARIABLES[0],
+                    ];
+                    options.log?.('wechat: no bot token; the channel is onboarding', { onboarding: onboarding.join(', ') });
+                    return;
+                }
+                const baseUrl = options.baseUrl ?? env.WECHAT_ILINK_BASE_URL;
+                port = createWechatPort({ token, ...(baseUrl === undefined ? {} : { baseUrl }) });
+            }
+            const client = port;
+            state = 'connecting';
+            connected = false;
+            failureText = undefined;
+            void client.notifyStart().catch(failure => options.log?.('wechat: notifystart failed', { error: detailOf(failure) }));
+            const run = new AbortController();
+            controller = run;
+            void poll(client, run.signal).catch(failure => {
+                state = 'error';
+                connected = false;
+                failureText = detailOf(failure);
+                options.log?.('wechat: the poll loop stopped unexpectedly', { error: failureText });
+            });
+        },
+        onEvent(listener) {
+            listeners.push(listener);
+        },
+        async send(request) {
+            const client = port;
+            if (client === undefined) {
+                return { state: 'unknown', error: 'The WeChat connector is not connected; no iLink session is available.' };
+            }
+            return sendMessage(client, request);
+        },
+        validate(operation, data) {
+            typingTarget(operation, data);
+        },
+        async operate(operation, data) {
+            const userId = typingTarget(operation, data);
+            const client = port;
+            if (client === undefined) {
+                return { state: 'unknown', error: 'The WeChat connector is not connected; no iLink session is available.' };
+            }
+            try {
+                const config = await client.getConfig(userId);
+                const ticket = config.typing_ticket;
+                if (typeof ticket !== 'string' || ticket.length === 0) {
+                    return { state: 'unknown', error: 'The platform call failed: getconfig answered without a typing_ticket.' };
+                }
+                await client.sendTyping(userId, ticket, 1);
+                return { state: 'committed' };
+            }
+            catch (failure) {
+                return outcomeOf(failure);
+            }
+        },
+        async stop() {
+            const run = controller;
+            controller = undefined;
+            run?.abort();
+            listeners.length = 0;
+            queues.clear();
+            state = 'stopped';
+            connected = false;
+            if (port !== undefined) {
+                await port.notifyStop().catch(failure => options.log?.('wechat: notifystop failed', { error: detailOf(failure) }));
+            }
+        },
+        status() {
+            return {
+                state,
+                connected,
+                reconnects,
+                rate_limits: port?.rateLimits() ?? 0,
+                ...(lastEventAt === undefined ? {} : { last_event_at: lastEventAt }),
+                ...(onboarding.length === 0 ? {} : { onboarding: [...onboarding] }),
+                ...(failureText === undefined ? {} : { error: failureText }),
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/normalize.d.ts

@@ -0,0 +1,14 @@
+import type { ImEvent } from '@onlyne/im-core';
+import type { WechatMessage } from './port.js';
+/**
+ * One `WeixinMessage` from `getupdates`. `message_type === 2` is the bot's own outbound echo and
+ * never becomes an inbound event; a message with no sender or no id cannot be deduplicated, so it
+ * is dropped rather than given a synthetic id that would collide on the next poll.
+ *
+ * The conversation coordinate is `group:<group_id>` when the message names a group, else
+ * `user:<from_user_id>`. The inbound `context_token` rides in `ref_handle` as `ctx:<token>`: the
+ * bridge hands it back as `reply_to` on the answer to this event, and iLink wants it verbatim on
+ * the send. `message_handle` stays the platform message id.
+ */
+export declare function normalizeMessage(message: WechatMessage, now: () => number): ImEvent | undefined;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,OAAO,EAAW,MAAM,iBAAiB,CAAC;AAEtE,OAAO,KAAK,EAAkB,aAAa,EAAqB,MAAM,WAAW,CAAC;AAYlF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,OAAO,GAAG,SAAS,CA+C/F"}

package/dist/normalize.js

@@ -0,0 +1,89 @@
+const PLATFORM = 'wechat';
+/** Item type to attachment kind: 2 image, 3 voice, 4 file, 5 video. */
+const ATTACHMENT_KINDS = {
+    2: 'image',
+    3: 'audio',
+    4: 'file',
+    5: 'video',
+};
+/**
+ * One `WeixinMessage` from `getupdates`. `message_type === 2` is the bot's own outbound echo and
+ * never becomes an inbound event; a message with no sender or no id cannot be deduplicated, so it
+ * is dropped rather than given a synthetic id that would collide on the next poll.
+ *
+ * The conversation coordinate is `group:<group_id>` when the message names a group, else
+ * `user:<from_user_id>`. The inbound `context_token` rides in `ref_handle` as `ctx:<token>`: the
+ * bridge hands it back as `reply_to` on the answer to this event, and iLink wants it verbatim on
+ * the send. `message_handle` stays the platform message id.
+ */
+export function normalizeMessage(message, now) {
+    if (message.message_type === 2)
+        return undefined;
+    const from = message.from_user_id;
+    if (typeof from !== 'string' || from.length === 0)
+        return undefined;
+    const id = message.message_id ?? message.seq;
+    if (id === undefined || id === null || String(id).length === 0)
+        return undefined;
+    const items = message.item_list ?? [];
+    const texts = [];
+    let transcript;
+    const attachments = [];
+    let parent;
+    for (const item of items) {
+        if (item.type === 1 && typeof item.text_item?.text === 'string')
+            texts.push(item.text_item.text);
+        if (transcript === undefined && item.type === 3) {
+            const voice = item.voice_item?.text;
+            if (typeof voice === 'string' && voice.length > 0)
+                transcript = voice;
+        }
+        const attachment = attachmentOf(item);
+        if (attachment !== undefined)
+            attachments.push(attachment);
+        if (parent === undefined) {
+            const quoted = item.ref_msg?.msg_id;
+            if (typeof quoted === 'string' && quoted.length > 0)
+                parent = quoted;
+        }
+    }
+    const text = texts.length > 0 ? texts.join('\n') : transcript ?? '';
+    const reply = parent === undefined ? undefined : { parent };
+    const groupId = message.group_id;
+    const conversation = typeof groupId === 'string' && groupId.length > 0 ? `group:${groupId}` : `user:${from}`;
+    const contextToken = message.context_token;
+    const createdAt = message.create_time_ms;
+    return {
+        platform: PLATFORM,
+        source_id: String(id),
+        conversation,
+        kind: 'message',
+        from,
+        text,
+        attachments,
+        ...(reply === undefined ? {} : { reply }),
+        message_handle: String(id),
+        ...(typeof contextToken === 'string' && contextToken.length > 0 ? { ref_handle: `ctx:${contextToken}` } : {}),
+        at: typeof createdAt === 'number' && Number.isFinite(createdAt) ? new Date(createdAt).toISOString() : new Date(now()).toISOString(),
+        raw: message,
+    };
+}
+/** The media handle a later download needs: the pre-signed URL first, the encrypted reference second. */
+function attachmentOf(item) {
+    const kind = item.type === undefined ? undefined : ATTACHMENT_KINDS[item.type];
+    if (kind === undefined)
+        return undefined;
+    const media = item.type === 2 ? item.image_item
+        : item.type === 3 ? item.voice_item
+            : item.type === 4 ? item.file_item
+                : item.video_item;
+    const handle = firstNonEmpty(media?.full_url) ?? firstNonEmpty(media?.encrypt_query_param);
+    if (handle === undefined)
+        return undefined;
+    const name = item.type === 4 ? firstNonEmpty(item.file_item?.file_name) : undefined;
+    return { kind, platform_handle: handle, ...(name === undefined ? {} : { alt: name }) };
+}
+function firstNonEmpty(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

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

package/dist/port.d.ts

@@ -0,0 +1,139 @@
+/**
+ * The iLink Bot API boundary: every platform call the connector makes goes through this interface,
+ * so the connector's translation logic runs against a fake in tests and the real HTTP API in
+ * production. Primary source: `developers.weixin.qq.com/doc/aispeech/knowledge/openapi/Clawbotrelated.*`
+ * and `Tencent/openclaw-weixin` `docs/protocol.md`.
+ */
+export declare const WECHAT_DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com";
+/** One media reference inside a message item; `full_url` is pre-signed, the query param is not. */
+export interface WechatMediaRef {
+    full_url?: string;
+    encrypt_query_param?: string;
+    aes_key?: string;
+}
+export interface WechatMessageItem {
+    /** 1 text, 2 image, 3 voice, 4 file, 5 video. */
+    type?: number;
+    msg_id?: string;
+    ref_msg?: {
+        msg_id?: string;
+        [key: string]: unknown;
+    };
+    text_item?: {
+        text?: string;
+    };
+    image_item?: WechatMediaRef;
+    voice_item?: WechatMediaRef & {
+        text?: string;
+    };
+    file_item?: WechatMediaRef & {
+        file_name?: string;
+        len?: number;
+    };
+    video_item?: WechatMediaRef;
+}
+export interface WechatMessage {
+    seq?: number;
+    message_id?: number | string;
+    from_user_id?: string;
+    to_user_id?: string;
+    client_id?: string;
+    create_time_ms?: number;
+    session_id?: string;
+    group_id?: string;
+    /** 1 user message, 2 the bot's own outbound. */
+    message_type?: number;
+    message_state?: number;
+    item_list?: WechatMessageItem[];
+    context_token?: string;
+    run_id?: string;
+}
+export interface WechatUpdatesResponse {
+    ret: number;
+    errcode?: number;
+    errmsg?: string;
+    msgs?: WechatMessage[];
+    get_updates_buf?: string;
+    longpolling_timeout_ms?: number;
+}
+export interface WechatSendResponse {
+    ret: number;
+    errcode?: number;
+    errmsg?: string;
+}
+export interface WechatConfigResponse {
+    ret: number;
+    errcode?: number;
+    errmsg?: string;
+    typing_ticket?: string;
+}
+/** The `msg` envelope of `sendmessage`; the port adds `base_info` around it. */
+export interface WechatOutboundMessage {
+    from_user_id: string;
+    to_user_id: string;
+    client_id: string;
+    message_type: number;
+    message_state: number;
+    context_token?: string;
+    item_list: Array<{
+        type: number;
+        text_item: {
+            text: string;
+        };
+    }>;
+}
+/**
+ * One iLink answer that did not succeed. `ret`/`errmsg` are the platform's own rejection (it
+ * answered, so the operation is settled); without them the call never reached the platform and
+ * the caller cannot tell whether it landed.
+ */
+export declare class WechatPortError extends Error {
+    readonly status: number | undefined;
+    readonly ret: number | undefined;
+    readonly errcode: number | undefined;
+    readonly errmsg: string | undefined;
+    readonly retryable: boolean;
+    /** The caller's signal ended the call: a normal end of polling, not a fault. */
+    readonly aborted: boolean;
+    /** `ret` or `errcode` is -14: the bot token's session is gone until the QR is scanned again. */
+    readonly sessionExpired: boolean;
+    constructor(message: string, options?: {
+        status?: number;
+        ret?: number;
+        errcode?: number;
+        errmsg?: string;
+        retryable?: boolean;
+        aborted?: boolean;
+        cause?: unknown;
+    });
+}
+/**
+ * The platform calls this connector makes. `getUpdates` takes the caller's abort signal because
+ * the long poll is the one call a shutdown interrupts; `rateLimits` is the host's observation of
+ * HTTP 429 answers, counted here because this is where they arrive.
+ */
+export interface WechatPort {
+    getUpdates(cursor: string, signal?: AbortSignal): Promise<WechatUpdatesResponse>;
+    sendMessage(message: WechatOutboundMessage): Promise<WechatSendResponse>;
+    getConfig(userId: string, contextToken?: string): Promise<WechatConfigResponse>;
+    sendTyping(userId: string, typingTicket: string, status: 1 | 2): Promise<void>;
+    /** Lifecycle: a failure is logged by the caller, never fatal. */
+    notifyStart(): Promise<void>;
+    notifyStop(): Promise<void>;
+    rateLimits(): number;
+}
+export interface WechatPortOptions {
+    /** The bot token from the ClawBot QR login. */
+    token: string;
+    baseUrl?: string;
+    fetch?: (input: string, init: RequestInit) => Promise<Response>;
+    channelVersion?: string;
+    botAgent?: string;
+    /** `X-WECHAT-UIN` is a random uint32 per call; injected so a test can pin it. */
+    random?: () => number;
+    /** 0 disables the stall guard. */
+    timeoutMs?: number;
+}
+export declare function detailOf(error: unknown): string;
+export declare function createWechatPort(options: WechatPortOptions): WechatPort;
+//# sourceMappingURL=port.d.ts.map

package/dist/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AAUvE,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACtD,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,UAAU,CAAC,EAAE,cAAc,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,SAAS,CAAC,EAAE,cAAc,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CACjE;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QACpC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ;CAWP;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACjF,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAChF,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,iEAAiE;IACjE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,UAAU,IAAI,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAqIvE"}

package/dist/port.js

@@ -0,0 +1,168 @@
+/**
+ * The iLink Bot API boundary: every platform call the connector makes goes through this interface,
+ * so the connector's translation logic runs against a fake in tests and the real HTTP API in
+ * production. Primary source: `developers.weixin.qq.com/doc/aispeech/knowledge/openapi/Clawbotrelated.*`
+ * and `Tencent/openclaw-weixin` `docs/protocol.md`.
+ */
+export const WECHAT_DEFAULT_BASE_URL = 'https://ilinkai.weixin.qq.com';
+/** `iLink-App-ClientVersion`: 0x00010000, spelled as the decimal string the API takes. */
+const CLIENT_VERSION = 65536;
+const UINT32 = 0x1_0000_0000;
+const DEFAULT_CHANNEL_VERSION = '3.0.0';
+const DEFAULT_BOT_AGENT = 'Onlyne';
+/** A long poll holds the request for about 35 s; this guards a call that never answers at all. */
+const DEFAULT_TIMEOUT_MS = 60_000;
+/**
+ * One iLink answer that did not succeed. `ret`/`errmsg` are the platform's own rejection (it
+ * answered, so the operation is settled); without them the call never reached the platform and
+ * the caller cannot tell whether it landed.
+ */
+export class WechatPortError extends Error {
+    status;
+    ret;
+    errcode;
+    errmsg;
+    retryable;
+    /** The caller's signal ended the call: a normal end of polling, not a fault. */
+    aborted;
+    /** `ret` or `errcode` is -14: the bot token's session is gone until the QR is scanned again. */
+    sessionExpired;
+    constructor(message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = 'WechatPortError';
+        this.status = options.status;
+        this.ret = options.ret;
+        this.errcode = options.errcode;
+        this.errmsg = options.errmsg;
+        this.retryable = options.retryable ?? false;
+        this.aborted = options.aborted ?? false;
+        this.sessionExpired = options.ret === -14 || options.errcode === -14;
+    }
+}
+export function detailOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function createWechatPort(options) {
+    const baseUrl = (options.baseUrl ?? WECHAT_DEFAULT_BASE_URL).replace(/\/+$/, '');
+    const fetchImpl = options.fetch ?? ((input, init) => fetch(input, init));
+    const random = options.random ?? Math.random;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    let rateLimits = 0;
+    const uin = () => {
+        const draw = Math.floor(Math.abs(random()) * UINT32) % UINT32;
+        return Buffer.from(String(draw), 'utf8').toString('base64');
+    };
+    const headers = () => ({
+        'Content-Type': 'application/json',
+        AuthorizationType: 'ilink_bot_token',
+        Authorization: `Bearer ${options.token}`,
+        'X-WECHAT-UIN': uin(),
+        'iLink-App-Id': 'bot',
+        'iLink-App-ClientVersion': String(CLIENT_VERSION),
+    });
+    const baseInfo = () => ({
+        channel_version: options.channelVersion ?? DEFAULT_CHANNEL_VERSION,
+        bot_agent: options.botAgent ?? DEFAULT_BOT_AGENT,
+    });
+    /**
+     * One authenticated POST. `call` names the call in the error text, because the platform's
+     * `errmsg` answers "what did the platform say" and never says which call asked.
+     */
+    async function post(path, call, body, signal) {
+        const guard = timeoutMs > 0 ? AbortSignal.timeout(timeoutMs) : undefined;
+        const combined = signal !== undefined && guard !== undefined
+            ? AbortSignal.any([signal, guard])
+            : (signal ?? guard);
+        let response;
+        try {
+            response = await fetchImpl(`${baseUrl}${path}`, {
+                method: 'POST',
+                headers: headers(),
+                body: JSON.stringify(body),
+                ...(combined === undefined ? {} : { signal: combined }),
+            });
+        }
+        catch (failure) {
+            if (signal?.aborted === true) {
+                throw new WechatPortError('The platform call was aborted.', { aborted: true, retryable: true, cause: failure });
+            }
+            if (guard?.aborted === true) {
+                throw new WechatPortError(`The platform call failed: ${call} made no answer within ${timeoutMs} ms.`, { retryable: true, cause: failure });
+            }
+            throw new WechatPortError(`The platform call failed: ${detailOf(failure)}`, { retryable: true, cause: failure });
+        }
+        const text = await response.text();
+        if (response.status === 429) {
+            rateLimits += 1;
+            throw new WechatPortError(`The platform rate-limited ${call}: 429 ${text.trim()}`, { status: 429, retryable: true });
+        }
+        if (!response.ok) {
+            throw new WechatPortError(`The platform call failed: ${response.status} ${text.trim()}`, {
+                status: response.status,
+                retryable: response.status >= 500,
+            });
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            throw new WechatPortError(`The platform call failed: ${response.status} returned a body that is not JSON.`, { status: response.status });
+        }
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new WechatPortError(`The platform call failed: ${response.status} returned no JSON object.`, { status: response.status });
+        }
+        const record = parsed;
+        const ret = typeof record.ret === 'number' ? record.ret : 0;
+        const errcode = typeof record.errcode === 'number' ? record.errcode : undefined;
+        const errmsg = typeof record.errmsg === 'string' && record.errmsg.length > 0 ? record.errmsg : undefined;
+        if (ret !== 0 || (errcode !== undefined && errcode !== 0)) {
+            const reason = errmsg ?? `ret ${ret}${errcode === undefined || errcode === ret ? '' : ` errcode ${errcode}`}`;
+            throw new WechatPortError(`The platform rejected ${call}: ${reason}`, {
+                status: response.status,
+                ret,
+                ...(errcode === undefined ? {} : { errcode }),
+                ...(errmsg === undefined ? {} : { errmsg }),
+            });
+        }
+        return parsed;
+    }
+    return {
+        async getUpdates(cursor, signal) {
+            try {
+                return await post('/ilink/bot/getupdates', 'the poll call', { get_updates_buf: cursor, base_info: baseInfo() }, signal);
+            }
+            catch (failure) {
+                if (failure instanceof WechatPortError && failure.aborted)
+                    return { ret: 0, msgs: [] };
+                throw failure;
+            }
+        },
+        async sendMessage(message) {
+            return post('/ilink/bot/sendmessage', 'the send', { msg: message, base_info: baseInfo() });
+        },
+        async getConfig(userId, contextToken) {
+            return post('/ilink/bot/getconfig', 'the getconfig call', {
+                ilink_user_id: userId,
+                ...(contextToken === undefined ? {} : { context_token: contextToken }),
+                base_info: baseInfo(),
+            });
+        },
+        async sendTyping(userId, typingTicket, status) {
+            await post('/ilink/bot/sendtyping', 'the sendtyping call', {
+                ilink_user_id: userId,
+                typing_ticket: typingTicket,
+                status,
+                base_info: baseInfo(),
+            });
+        },
+        async notifyStart() {
+            await post('/ilink/bot/msg/notifystart', 'the notifystart call', { base_info: baseInfo() });
+        },
+        async notifyStop() {
+            await post('/ilink/bot/msg/notifystop', 'the notifystop call', { base_info: baseInfo() });
+        },
+        rateLimits: () => rateLimits,
+    };
+}
+//# sourceMappingURL=port.js.map

package/dist/port.js.map

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

package/dist/send.d.ts

@@ -0,0 +1,24 @@
+import type { SendOutcome, SendRequest } from '@onlyne/im-core';
+import { type WechatOutboundMessage } from './port.js';
+/** The one platform call a send makes; the connector's port satisfies it. */
+export interface SendPort {
+    sendMessage(message: WechatOutboundMessage): Promise<unknown>;
+}
+/** The conversation coordinate iLink addresses: `user:<id>`, or `group:<id>` whose id goes to `to_user_id`. */
+export declare function conversationTarget(conversation: string): {
+    scheme: 'user' | 'group';
+    id: string;
+} | undefined;
+/**
+ * One text send. `reply_to` starting with `ctx:` is the inbound event's transport context, used
+ * as `context_token`. iLink exposes no message-quoting field, so any other handle is not echoed;
+ * the text still goes out and the platform decides.
+ */
+export declare function sendMessage(port: SendPort, request: SendRequest): Promise<SendOutcome>;
+/**
+ * A platform answer (`ret`/`errmsg` present) settles the operation: the platform saw the call and
+ * refused it. Anything else — no answer, an HTTP failure, a rate limit — leaves it unknown,
+ * because the send may still have landed.
+ */
+export declare function outcomeOf(failure: unknown): SendOutcome;
+//# sourceMappingURL=send.d.ts.map

package/dist/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../src/send.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAA6B,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElF,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/D;AAID,+GAA+G;AAC/G,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAU7G;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAgC5F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAKvD"}

package/dist/send.js

@@ -0,0 +1,64 @@
+import { WechatPortError, detailOf } from './port.js';
+const UNSUPPORTED = 'unsupported by @onlyne/im-wechat';
+/** The conversation coordinate iLink addresses: `user:<id>`, or `group:<id>` whose id goes to `to_user_id`. */
+export function conversationTarget(conversation) {
+    if (conversation.startsWith('user:')) {
+        const id = conversation.slice('user:'.length);
+        return id.length === 0 ? undefined : { scheme: 'user', id };
+    }
+    if (conversation.startsWith('group:')) {
+        const id = conversation.slice('group:'.length);
+        return id.length === 0 ? undefined : { scheme: 'group', id };
+    }
+    return undefined;
+}
+/**
+ * One text send. `reply_to` starting with `ctx:` is the inbound event's transport context, used
+ * as `context_token`. iLink exposes no message-quoting field, so any other handle is not echoed;
+ * the text still goes out and the platform decides.
+ */
+export async function sendMessage(port, request) {
+    if (request.attachments.length > 0 || request.card !== undefined) {
+        return {
+            state: 'committed',
+            error: `${UNSUPPORTED}: the iLink Bot API path implemented here sends text only; attachments and cards are not sent.`,
+        };
+    }
+    const target = conversationTarget(request.conversation);
+    if (target === undefined) {
+        return { state: 'committed', error: `${UNSUPPORTED}: conversation ${request.conversation} is not user:<id> or group:<id>.` };
+    }
+    const replyTo = request.reply_to;
+    // `ctx:` is the inbound event's transport context. Any other handle is the event's message id,
+    // which the iLink Bot API has no field to quote; the text is still sent and the platform's own
+    // answer decides, instead of this connector refusing a reply the bridge legitimately addressed.
+    const contextToken = replyTo !== undefined && replyTo.startsWith('ctx:') ? replyTo.slice('ctx:'.length) : undefined;
+    const clientId = request.request_id ?? crypto.randomUUID();
+    try {
+        await port.sendMessage({
+            from_user_id: '',
+            to_user_id: target.id,
+            client_id: clientId,
+            message_type: 2,
+            message_state: 2,
+            ...(contextToken === undefined || contextToken.length === 0 ? {} : { context_token: contextToken }),
+            item_list: [{ type: 1, text_item: { text: request.text } }],
+        });
+        return { state: 'committed', message_id: clientId };
+    }
+    catch (failure) {
+        return outcomeOf(failure);
+    }
+}
+/**
+ * A platform answer (`ret`/`errmsg` present) settles the operation: the platform saw the call and
+ * refused it. Anything else — no answer, an HTTP failure, a rate limit — leaves it unknown,
+ * because the send may still have landed.
+ */
+export function outcomeOf(failure) {
+    if (failure instanceof WechatPortError && failure.ret !== undefined) {
+        return { state: 'committed', error: failure.message };
+    }
+    return { state: 'unknown', error: detailOf(failure) };
+}
+//# sourceMappingURL=send.js.map

package/dist/send.js.map

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

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@onlyne/im-wechat",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "3.2.0",
+  "description": "WeChat connector for the Onlyne IM gateway over the Tencent iLink / ClawBot Bot API: inbound polling and text sends",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dbydd/onlyne.git",
+    "directory": "packages/im-wechat"
+  },
+  "homepage": "https://github.com/dbydd/onlyne#readme",
+  "bugs": { "url": "https://github.com/dbydd/onlyne/issues" },
+  "keywords": ["onlyne", "wechat", "weixin", "ilink", "clawbot", "im", "connector"],
+  "publishConfig": { "access": "public" },
+  "engines": { "bun": ">=1.4.3" },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "LICENSE"],
+  "scripts": {
+    "build": "tsc",
+    "check": "tsc && tsc -p tsconfig.tests.json",
+    "test": "bun tests/verify.ts && bun tests/send.ts && bun tests/poll.ts",
+    "prepack": "bun run build"
+  },
+  "dependencies": {
+    "@onlyne/im-core": "^3.2.0",
+    "@onlyne/lib": "^3.2.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.0",
+    "typescript": "^5.9.0"
+  }
+}