@amaster.ai/pi-channels 0.1.2-beta.2 → 0.1.2-beta.21

package/README.md

@@ -1,5 +1,7 @@
 # @amaster.ai/pi-channels
 
+![pi-channels preview](https://raw.githubusercontent.com/TGYD-helige/pi/master/packages/pi-channels/preview.png)
+
 Pi extension for native messaging channels.
 
 This package follows the same extension shape as the open-source `@e9n/pi-channels`
@@ -10,17 +12,20 @@ It does not depend on `@e9n/pi-channels` at runtime. That package is published a
 a standalone extension source package with the older `@mariozechner/*` peer
 namespace and Slack/Telegram dependencies. This package keeps the same channel
 contract while targeting this repo's `@earendil-works/*` API surface and native
-Feishu/WeCom adapters.
+Feishu/DingTalk/WeCom adapters.
 
 ## Channels
 
 - `feishu` - Native Feishu/Lark app messaging backed by the official
   `@larksuiteoapi/node-sdk`. Supports outgoing text messages, WebSocket events
   by default, and HTTP event callbacks as a fallback.
-- `wecom` - Native WeCom self-built app messaging. Supports outgoing text
-  messages, appchat messages, encrypted HTTP callbacks for text messages, token
-  caching, request timeouts, and actionable API errors such as trusted-IP
-  failures.
+- `wecom` - Native WeCom intelligent bot messaging backed by the official
+  `@wecom/aibot-node-sdk`. Supports WebSocket long connection events and active
+  Markdown pushes with Bot ID / Secret credentials.
+- `dingtalk` - Native DingTalk app bot messaging backed by the official
+  `dingtalk-stream` SDK. Supports Stream mode incoming bot messages, reply
+  messages through `sessionWebhook`, and active group text pushes through the
+  DingTalk OpenAPI.
 - `webhook` - Generic outgoing HTTP requests.
 
 ## Example
@@ -38,17 +43,18 @@ Feishu/WeCom adapters.
       },
       "wecom": {
         "type": "wecom",
-        "corpId": "${WECOM_CORP_ID}",
-        "agentId": "${WECOM_AGENT_ID}",
-        "secret": "${WECOM_SECRET}",
-        "timeoutMs": 15000,
-        "token": "${WECOM_CALLBACK_TOKEN}",
-        "encodingAesKey": "${WECOM_ENCODING_AES_KEY}",
-        "incoming": {
-          "enabled": true,
-          "port": 8788,
-          "path": "/wecom/events"
-        }
+        "botId": "${WECOM_BOT_ID}",
+        "secret": "${WECOM_BOT_SECRET}",
+        "eventMode": "websocket",
+        "respondToMentionsOnly": true,
+        "timeoutMs": 15000
+      },
+      "dingtalk": {
+        "type": "dingtalk",
+        "clientId": "${DINGTALK_CLIENT_ID}",
+        "clientSecret": "${DINGTALK_CLIENT_SECRET}",
+        "eventMode": "stream",
+        "respondToMentionsOnly": true
       }
     },
     "routes": {
@@ -102,6 +108,46 @@ payloads:
 
 Set `"eventMode": "off"` for outgoing-only usage.
 
+### DingTalk modes
+
+Create a DingTalk internal app, add the bot capability, select Stream mode, and
+publish it. Copy the Client ID and Client Secret into the adapter config:
+
+```json
+{
+  "type": "dingtalk",
+  "clientId": "${DINGTALK_CLIENT_ID}",
+  "clientSecret": "${DINGTALK_CLIENT_SECRET}",
+  "robotCode": "${DINGTALK_ROBOT_CODE}",
+  "eventMode": "stream",
+  "respondToMentionsOnly": true,
+  "allowedConversationIds": ["cid_xxx"]
+}
+```
+
+Incoming replies use the per-message `sessionWebhook` when available. Active
+route sends use DingTalk's group message OpenAPI with the route recipient as the
+conversation/openConversationId. `robotCode` defaults to `clientId` when omitted.
+
+Set `"eventMode": "off"` when the bot should only send messages.
+
+### WeCom modes
+
+Create an intelligent bot in the WeCom admin console, choose API mode, and select
+the long connection option. Copy the Bot ID and Secret into the adapter config:
+
+```json
+{
+  "type": "wecom",
+  "botId": "${WECOM_BOT_ID}",
+  "secret": "${WECOM_BOT_SECRET}",
+  "eventMode": "websocket",
+  "allowedChatIds": ["wr_xxx"]
+}
+```
+
+Set `"eventMode": "off"` when the bot should only send messages.
+
 ## Tool
 
 ```text
@@ -120,20 +166,24 @@ user_id:abc123
 email:name@example.com
 ```
 
-For WeCom, recipients default to `touser`. Prefix the recipient to send to parties
-or tags. Prefix with `chat:` or `appchat:` to use the WeCom appchat API:
+For WeCom intelligent bots, recipients are the conversation ids used by the Bot
+API. In a group, send one message to the bot and use route capture to fill the
+group `chatid`; for one-to-one pushes, use the target user's userid:
 
 ```text
-user:zhangsan
-party:2
-tag:7
-appchat:chat-id
+wr_xxx
+zhangsan
 ```
 
-If WeCom returns `60020 not allow to access from your ip`, the adapter raises a
-typed `WeComApiError` with category `ip_whitelist`. Configure the trusted IP in
-the WeCom console, or run pi behind a fixed egress proxy that is allowed by the
-enterprise.
+The intelligent bot adapter uses the WebSocket Bot API, so long connection mode
+does not require a public callback URL.
+
+For DingTalk app bots, send one message to the bot and use route capture to fill
+the group conversation id:
+
+```text
+cid_xxx
+```
 
 ## Events
 
@@ -147,6 +197,7 @@ enterprise.
 
 ```text
 /channel list
+/channel reload
 /channel bridge on
 /channel bridge off
 /channel bridge status

package/dist/adapters/dingtalk.d.ts

@@ -0,0 +1,5 @@
+import type { AdapterConfig, ChannelAdapter } from '../types.js';
+export declare function createDingTalkAdapter(config: AdapterConfig, context?: {
+    log?: (event: string, data?: Record<string, unknown>, level?: string) => void;
+}): ChannelAdapter;
+//# sourceMappingURL=dingtalk.d.ts.map

package/dist/adapters/dingtalk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dingtalk.d.ts","sourceRoot":"","sources":["../../src/adapters/dingtalk.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EAIf,MAAM,aAAa,CAAC;AAsMrB,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1E,GACL,cAAc,CA+IhB"}

package/dist/adapters/dingtalk.js

@@ -0,0 +1,269 @@
+const DEFAULT_OPEN_API_BASE_URL = 'https://api.dingtalk.com';
+const DEFAULT_TOKEN_URL = 'https://oapi.dingtalk.com/gettoken';
+const DINGTALK_TEXT_MSG_KEY = 'sampleText';
+function asConfig(config) {
+    return config;
+}
+function requireString(value, name) {
+    if (typeof value === 'string' && value.trim())
+        return value.trim();
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    throw new Error(`DingTalk adapter requires ${name}`);
+}
+function optionalString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function normalizeConfig(config) {
+    const cfg = asConfig(config);
+    const clientId = requireString(cfg.clientId, 'clientId');
+    return {
+        ...cfg,
+        clientId,
+        clientSecret: requireString(cfg.clientSecret, 'clientSecret'),
+        robotCode: optionalString(cfg.robotCode) ?? clientId,
+        eventMode: cfg.eventMode === 'off' ? 'off' : 'stream',
+        openApiBaseUrl: optionalString(cfg.openApiBaseUrl) ?? DEFAULT_OPEN_API_BASE_URL,
+        tokenUrl: optionalString(cfg.tokenUrl) ?? DEFAULT_TOKEN_URL,
+    };
+}
+function textFromMessage(message) {
+    if (!message.text)
+        throw new Error('DingTalk adapter requires text');
+    return message.source ? `[${message.source}]\n${message.text}` : message.text;
+}
+function shouldAcceptMessage(body, cfg) {
+    const conversationId = body.conversationId ?? '';
+    const allowedConversationIds = cfg.allowedConversationIds;
+    if (conversationId &&
+        Array.isArray(allowedConversationIds) &&
+        allowedConversationIds.length > 0 &&
+        !allowedConversationIds.includes(conversationId)) {
+        return false;
+    }
+    const senderId = body.senderId ?? body.senderStaffId ?? '';
+    const allowedSenderIds = cfg.allowedSenderIds;
+    if (senderId &&
+        Array.isArray(allowedSenderIds) &&
+        allowedSenderIds.length > 0 &&
+        !allowedSenderIds.includes(senderId)) {
+        return false;
+    }
+    if ((cfg.respondToMentionsOnly ?? true) &&
+        body.conversationType !== '1' &&
+        body.isInAtList === false) {
+        return false;
+    }
+    return true;
+}
+function senderForMessage(body) {
+    return body.conversationId ?? body.senderId ?? body.senderStaffId ?? '';
+}
+function metadataFromMessage(body) {
+    return {
+        messageId: body.msgId,
+        replyToMessageId: body.msgId,
+        conversationId: body.conversationId,
+        chatId: body.conversationId,
+        groupId: body.conversationId,
+        conversationTitle: body.conversationTitle,
+        chatName: body.conversationTitle,
+        groupName: body.conversationTitle,
+        conversationType: body.conversationType,
+        senderId: body.senderId,
+        senderStaffId: body.senderStaffId,
+        senderNick: body.senderNick,
+        senderName: body.senderNick,
+        sessionWebhook: body.sessionWebhook,
+        sessionWebhookExpiredTime: body.sessionWebhookExpiredTime,
+        robotCode: body.robotCode,
+        chatbotCorpId: body.chatbotCorpId,
+        chatbotUserId: body.chatbotUserId,
+        createAt: body.createAt,
+        rawMsgtype: body.msgtype,
+    };
+}
+function parseRobotMessage(downstream) {
+    if (downstream.headers.topic !== '/v1.0/im/bot/messages/get')
+        return undefined;
+    try {
+        const parsed = JSON.parse(downstream.data);
+        return parsed && typeof parsed === 'object' ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function sessionWebhookFromMetadata(metadata) {
+    const value = metadata?.sessionWebhook;
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function sessionWebhookIsFresh(metadata) {
+    const value = metadata?.sessionWebhookExpiredTime;
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return true;
+    return value > Date.now();
+}
+function normalizeApiBaseUrl(value) {
+    return value.replace(/\/+$/, '');
+}
+async function readJsonResponse(response) {
+    const text = await response.text();
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function formatDingTalkApiError(body) {
+    if (!body || typeof body !== 'object' || Array.isArray(body))
+        return undefined;
+    const record = body;
+    const code = record.code ?? record.errcode;
+    if (code === undefined || code === 0 || code === '0')
+        return undefined;
+    const message = record.message ?? record.errmsg;
+    return `DingTalk API error ${String(code)}${message ? `: ${String(message)}` : ''}`;
+}
+export function createDingTalkAdapter(config, context = {}) {
+    const cfg = normalizeConfig(config);
+    let client = null;
+    let streamModulePromise = null;
+    let accessToken;
+    async function loadStreamModule() {
+        streamModulePromise ??= import('dingtalk-stream');
+        return streamModulePromise;
+    }
+    async function getAccessToken() {
+        if (accessToken && accessToken.expiresAt > Date.now())
+            return accessToken.token;
+        const url = new URL(cfg.tokenUrl);
+        url.searchParams.set('appkey', cfg.clientId);
+        url.searchParams.set('appsecret', cfg.clientSecret);
+        const response = await fetch(url);
+        const body = (await readJsonResponse(response));
+        if (!response.ok) {
+            throw new Error(`DingTalk token error ${response.status}: ${JSON.stringify(body)}`);
+        }
+        if (body?.errcode && body.errcode !== 0) {
+            throw new Error(`DingTalk token error ${body.errcode}: ${body.errmsg ?? 'unknown'}`);
+        }
+        if (!body?.access_token)
+            throw new Error('DingTalk token response missing access_token');
+        const expiresIn = Number.isFinite(body.expires_in) ? Number(body.expires_in) : 7200;
+        accessToken = {
+            token: body.access_token,
+            expiresAt: Date.now() + Math.max(60, expiresIn - 300) * 1000,
+        };
+        return accessToken.token;
+    }
+    async function sendViaSessionWebhook(url, text) {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json; charset=utf-8' },
+            body: JSON.stringify({
+                msgtype: 'text',
+                text: { content: text },
+            }),
+        });
+        const body = await readJsonResponse(response);
+        if (!response.ok) {
+            throw new Error(`DingTalk session webhook error ${response.status}: ${JSON.stringify(body)}`);
+        }
+        const apiError = formatDingTalkApiError(body);
+        if (apiError)
+            throw new Error(apiError);
+    }
+    async function sendViaOpenApi(recipient, text) {
+        const conversationId = recipient.trim();
+        if (!conversationId)
+            throw new Error('DingTalk adapter requires recipient');
+        const token = await getAccessToken();
+        const response = await fetch(`${normalizeApiBaseUrl(cfg.openApiBaseUrl)}/v1.0/robot/groupMessages/send`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json; charset=utf-8',
+                'x-acs-dingtalk-access-token': token,
+            },
+            body: JSON.stringify({
+                robotCode: cfg.robotCode,
+                openConversationId: conversationId,
+                msgKey: DINGTALK_TEXT_MSG_KEY,
+                msgParam: JSON.stringify({ content: text }),
+            }),
+        });
+        const body = await readJsonResponse(response);
+        if (!response.ok) {
+            throw new Error(`DingTalk send error ${response.status}: ${JSON.stringify(body)}`);
+        }
+        const apiError = formatDingTalkApiError(body);
+        if (apiError)
+            throw new Error(apiError);
+    }
+    async function sendText(message) {
+        const text = textFromMessage(message);
+        const sessionWebhook = sessionWebhookFromMetadata(message.metadata);
+        if (sessionWebhook && sessionWebhookIsFresh(message.metadata)) {
+            await sendViaSessionWebhook(sessionWebhook, text);
+            return;
+        }
+        await sendViaOpenApi(message.recipient, text);
+    }
+    async function start(onMessage) {
+        if (cfg.eventMode === 'off')
+            return;
+        if (client)
+            return;
+        const stream = await loadStreamModule();
+        client = new stream.DWClient({
+            clientId: cfg.clientId,
+            clientSecret: cfg.clientSecret,
+            ...(cfg.ua ? { ua: cfg.ua } : { ua: 'amaster-pi-channels' }),
+            ...(cfg.keepAlive !== undefined ? { keepAlive: cfg.keepAlive } : {}),
+            ...(cfg.debug !== undefined ? { debug: cfg.debug } : {}),
+        });
+        client.registerCallbackListener(stream.TOPIC_ROBOT, (downstream) => {
+            try {
+                const body = parseRobotMessage(downstream);
+                if (!body)
+                    return;
+                if (!shouldAcceptMessage(body, cfg))
+                    return;
+                if (body.msgtype !== 'text')
+                    return;
+                const text = body.text?.content?.trim();
+                const sender = senderForMessage(body);
+                if (!text || !sender)
+                    return;
+                void onMessage({
+                    adapter: 'dingtalk',
+                    sender,
+                    text,
+                    metadata: metadataFromMessage(body),
+                });
+            }
+            finally {
+                try {
+                    client?.socketCallBackResponse(downstream.headers.messageId, null);
+                }
+                catch (error) {
+                    context.log?.('dingtalk-stream-ack-failed', { error: error instanceof Error ? error.message : String(error) }, 'WARN');
+                }
+            }
+        });
+        await client.connect();
+    }
+    return {
+        direction: cfg.eventMode === 'off' ? 'outgoing' : 'bidirectional',
+        send: sendText,
+        start,
+        async stop() {
+            client?.disconnect();
+            client = null;
+        },
+    };
+}
+//# sourceMappingURL=dingtalk.js.map

package/dist/adapters/dingtalk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dingtalk.js","sourceRoot":"","sources":["../../src/adapters/dingtalk.ts"],"names":[],"mappings":"AA2DA,MAAM,yBAAyB,GAAG,0BAA0B,CAAC;AAC7D,MAAM,iBAAiB,GAAG,oCAAoC,CAAC;AAC/D,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAE3C,SAAS,QAAQ,CAAC,MAAqB;IACrC,OAAO,MAA+B,CAAC;AACzC,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,IAAY;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9E,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,SAAS,eAAe,CAAC,MAAqB;IAC5C,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACzD,OAAO;QACL,GAAG,GAAG;QACN,QAAQ;QACR,YAAY,EAAE,aAAa,CAAC,GAAG,CAAC,YAAY,EAAE,cAAc,CAAC;QAC7D,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,QAAQ;QACpD,SAAS,EAAE,GAAG,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ;QACrD,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,yBAAyB;QAC/E,QAAQ,EAAE,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,iBAAiB;KAC5D,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAuB;IAC9C,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACrE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;AAChF,CAAC;AAED,SAAS,mBAAmB,CAAC,IAA0B,EAAE,GAA6B;IACpF,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;IACjD,MAAM,sBAAsB,GAAG,GAAG,CAAC,sBAAsB,CAAC;IAC1D,IACE,cAAc;QACd,KAAK,CAAC,OAAO,CAAC,sBAAsB,CAAC;QACrC,sBAAsB,CAAC,MAAM,GAAG,CAAC;QACjC,CAAC,sBAAsB,CAAC,QAAQ,CAAC,cAAc,CAAC,EAChD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;IAC3D,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,CAAC;IAC9C,IACE,QAAQ;QACR,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC;QAC/B,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAC3B,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EACpC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IACE,CAAC,GAAG,CAAC,qBAAqB,IAAI,IAAI,CAAC;QACnC,IAAI,CAAC,gBAAgB,KAAK,GAAG;QAC7B,IAAI,CAAC,UAAU,KAAK,KAAK,EACzB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA0B;IAClD,OAAO,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;AAC1E,CAAC;AAED,SAAS,mBAAmB,CAAC,IAA0B;IACrD,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,KAAK;QACrB,gBAAgB,EAAE,IAAI,CAAC,KAAK;QAC5B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,MAAM,EAAE,IAAI,CAAC,cAAc;QAC3B,OAAO,EAAE,IAAI,CAAC,cAAc;QAC5B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,QAAQ,EAAE,IAAI,CAAC,iBAAiB;QAChC,SAAS,EAAE,IAAI,CAAC,iBAAiB;QACjC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,yBAAyB,EAAE,IAAI,CAAC,yBAAyB;QACzD,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,UAA8B;IACvD,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,KAAK,2BAA2B;QAAE,OAAO,SAAS,CAAC;IAC/E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAyB,CAAC;QACnE,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CACjC,QAA6C;IAE7C,MAAM,KAAK,GAAG,QAAQ,EAAE,cAAc,CAAC;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,SAAS,qBAAqB,CAAC,QAA6C;IAC1E,MAAM,KAAK,GAAG,QAAQ,EAAE,yBAAyB,CAAC;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,OAAO,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,QAAkB;IAChD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAa;IAC3C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/E,MAAM,MAAM,GAAG,IAAgC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC;IAC3C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC;IACvE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC;IAChD,OAAO,sBAAsB,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAqB,EACrB,UAEI,EAAE;IAEN,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,MAAM,GAAoB,IAAI,CAAC;IACnC,IAAI,mBAAmB,GAAyC,IAAI,CAAC;IACrE,IAAI,WAKS,CAAC;IAEd,KAAK,UAAU,gBAAgB;QAC7B,mBAAmB,KAAK,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAClD,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,KAAK,UAAU,cAAc;QAC3B,IAAI,WAAW,IAAI,WAAW,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE;YAAE,OAAO,WAAW,CAAC,KAAK,CAAC;QAChF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAA4C,CAAC;QAC3F,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACzF,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpF,WAAW,GAAG;YACZ,KAAK,EAAE,IAAI,CAAC,YAAY;YACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,GAAG,IAAI;SAC7D,CAAC;QACF,OAAO,WAAW,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,KAAK,UAAU,qBAAqB,CAAC,GAAW,EAAE,IAAY;QAC5D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,iCAAiC,EAAE;YAC9D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;aACxB,CAAC;SACH,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,UAAU,cAAc,CAAC,SAAiB,EAAE,IAAY;QAC3D,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,mBAAmB,CAAC,GAAG,CAAC,cAAc,CAAC,gCAAgC,EAC1E;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,iCAAiC;gBACjD,6BAA6B,EAAE,KAAK;aACrC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,kBAAkB,EAAE,cAAc;gBAClC,MAAM,EAAE,qBAAqB;gBAC7B,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;aAC5C,CAAC;SACH,CACF,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,UAAU,QAAQ,CAAC,OAAuB;QAC7C,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,cAAc,GAAG,0BAA0B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,cAAc,IAAI,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9D,MAAM,qBAAqB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,MAAM,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,UAAU,KAAK,CAAC,SAA4B;QAC/C,IAAI,GAAG,CAAC,SAAS,KAAK,KAAK;YAAE,OAAO;QACpC,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;QACxC,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC;YAC3B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,qBAAqB,EAAE,CAAC;YAC5D,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;QACH,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,UAA8B,EAAE,EAAE;YACrF,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;gBAC3C,IAAI,CAAC,IAAI;oBAAE,OAAO;gBAClB,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC;oBAAE,OAAO;gBAC5C,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM;oBAAE,OAAO;gBACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBACxC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBACtC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM;oBAAE,OAAO;gBAC7B,KAAK,SAAS,CAAC;oBACb,OAAO,EAAE,UAAU;oBACnB,MAAM;oBACN,IAAI;oBACJ,QAAQ,EAAE,mBAAmB,CAAC,IAAI,CAAC;iBACpC,CAAC,CAAC;YACL,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC;oBACH,MAAM,EAAE,sBAAsB,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBACrE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,GAAG,EAAE,CACX,4BAA4B,EAC5B,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACjE,MAAM,CACP,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IAED,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe;QACjE,IAAI,EAAE,QAAQ;QACd,KAAK;QACL,KAAK,CAAC,IAAI;YACR,MAAM,EAAE,UAAU,EAAE,CAAC;YACrB,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/feishu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feishu.d.ts","sourceRoot":"","sources":["../../src/adapters/feishu.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EAIf,MAAM,aAAa,CAAC;AA2JrB,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1E,GACL,cAAc,CA8OhB"}
+{"version":3,"file":"feishu.d.ts","sourceRoot":"","sources":["../../src/adapters/feishu.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EAIf,MAAM,aAAa,CAAC;AAyPrB,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1E,GACL,cAAc,CAoThB"}

package/dist/adapters/feishu.js

@@ -20,6 +20,61 @@ function parseTextContent(content) {
         return { text: content };
     }
 }
+function normalizeFeishuIncomingText(text, mentions, cfg, mentionedBot) {
+    let cleaned = text.replace(/\u00a0/g, ' ').trim();
+    cleaned = cleaned.replace(/^回复\s+[^:：]{1,80}[:：]\s*/u, '').trim();
+    if (mentions?.length) {
+        const botMentions = mentions.filter((mention) => isBotMention(mention, cfg));
+        const leadingMentions = botMentions.length > 0 ? botMentions : mentionedBot ? mentions : [];
+        cleaned = stripLeadingMentionTokens(cleaned, mentionTokens(leadingMentions));
+    }
+    if (mentionedBot) {
+        cleaned = cleaned.replace(/^@[\p{L}\p{N}_\-.·]+(?:\s+|$)/u, '').trim();
+    }
+    return cleaned;
+}
+function isBotMention(mention, cfg) {
+    if (mention.isBot)
+        return true;
+    const botOpenId = optionalNonEmptyString(cfg.botOpenId);
+    if (!botOpenId)
+        return false;
+    return (mention.openId === botOpenId ||
+        mention.userId === botOpenId ||
+        mention.id?.open_id === botOpenId ||
+        mention.id?.user_id === botOpenId ||
+        mention.id?.union_id === botOpenId);
+}
+function mentionTokens(mentions) {
+    const tokens = new Set();
+    for (const mention of mentions) {
+        if (mention.key?.trim())
+            tokens.add(mention.key.trim());
+        if (mention.name?.trim())
+            tokens.add(`@${mention.name.trim()}`);
+    }
+    return [...tokens].sort((a, b) => b.length - a.length);
+}
+function stripLeadingMentionTokens(text, tokens) {
+    let cleaned = text.trimStart();
+    for (let i = 0; i < 8; i++) {
+        const next = stripOneLeadingMentionToken(cleaned, tokens);
+        if (next === cleaned)
+            break;
+        cleaned = next.trimStart();
+    }
+    return cleaned.trim();
+}
+function stripOneLeadingMentionToken(text, tokens) {
+    for (const token of tokens) {
+        if (text === token)
+            return '';
+        if (text.startsWith(token) && /\s/u.test(text[token.length] ?? '')) {
+            return text.slice(token.length);
+        }
+    }
+    return text;
+}
 function resolveReceiveId(message, defaultType) {
     const match = message.recipient.match(/^(chat_id|open_id|user_id|union_id|email):(.+)$/);
     if (!match)
@@ -89,6 +144,17 @@ function shouldAcceptMessage(msg, cfg) {
 function senderForMessage(chatId, threadId) {
     return threadId ? `${chatId}:${threadId}` : chatId;
 }
+function objectStringField(value, key) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const field = value[key];
+    return typeof field === 'string' && field.trim() ? field : undefined;
+}
+function ackReactionEmoji(cfg) {
+    if (cfg.ackReactionEmoji === false)
+        return null;
+    return optionalNonEmptyString(cfg.ackReactionEmoji) ?? 'OK';
+}
 export function createFeishuAdapter(config, context = {}) {
     const cfg = asConfig(config);
     const appId = requireString(cfg.appId, 'appId');
@@ -110,6 +176,50 @@ export function createFeishuAdapter(config, context = {}) {
     });
     let channel = null;
     let server = null;
+    async function resolveChatName(chatId) {
+        const chatApi = client.im.chat;
+        if (!chatApi?.get)
+            return undefined;
+        try {
+            const response = await chatApi.get({ path: { chat_id: chatId } });
+            const code = response.code;
+            if (code !== undefined && code !== 0)
+                return undefined;
+            const data = response.data;
+            const chat = data && typeof data === 'object' ? data.chat : undefined;
+            return (objectStringField(data, 'name') ??
+                objectStringField(chat, 'name') ??
+                objectStringField(data, 'chat_name') ??
+                objectStringField(chat, 'chat_name'));
+        }
+        catch (error) {
+            context.log?.('feishu-chat-name-fetch-failed', { chatId, error: error instanceof Error ? error.message : String(error) }, 'WARN');
+            return undefined;
+        }
+    }
+    async function addAckReaction(messageId) {
+        const emojiType = ackReactionEmoji(cfg);
+        if (!emojiType)
+            return;
+        try {
+            const response = (await client.request({
+                url: `/open-apis/im/v1/messages/${encodeURIComponent(messageId)}/reactions`,
+                method: 'POST',
+                data: {
+                    reaction_type: {
+                        emoji_type: emojiType,
+                    },
+                },
+            }));
+            const body = response.data;
+            if (body?.code !== undefined && body.code !== 0) {
+                context.log?.('feishu-ack-reaction-failed', { messageId, emojiType, code: body.code, msg: body.msg }, 'WARN');
+            }
+        }
+        catch (error) {
+            context.log?.('feishu-ack-reaction-failed', { messageId, emojiType, error: error instanceof Error ? error.message : String(error) }, 'WARN');
+        }
+    }
     async function sendText(message) {
         if (!message.text)
             throw new Error('Feishu adapter requires text');
@@ -146,7 +256,7 @@ export function createFeishuAdapter(config, context = {}) {
             throw new Error(`Feishu send error: ${response.msg ?? response.code ?? 'unknown'}`);
         }
     }
-    function handleNormalizedMessage(msg, onMessage) {
+    async function handleNormalizedMessage(msg, onMessage) {
         if (!shouldAcceptMessage({
             chatId: msg.chatId,
             senderId: msg.senderId,
@@ -157,15 +267,19 @@ export function createFeishuAdapter(config, context = {}) {
         }
         if (msg.rawContentType !== 'text' && msg.rawContentType !== 'post')
             return;
-        if (!msg.content.trim())
+        const text = normalizeFeishuIncomingText(msg.content, msg.mentions, cfg, msg.mentionedBot);
+        if (!text)
             return;
+        void addAckReaction(msg.messageId);
+        const chatName = await resolveChatName(msg.chatId);
         void onMessage({
             adapter: 'feishu',
             sender: senderForMessage(msg.chatId, msg.threadId),
-            text: msg.content,
+            text,
             metadata: {
                 messageId: msg.messageId,
                 chatId: msg.chatId,
+                ...(chatName ? { chatName } : {}),
                 chatType: msg.chatType,
                 senderId: msg.senderId,
                 senderName: msg.senderName,
@@ -197,9 +311,10 @@ export function createFeishuAdapter(config, context = {}) {
         }, cfg)) {
             return;
         }
-        const text = parsed.text.trim();
+        const text = normalizeFeishuIncomingText(parsed.text, data.message.mentions, cfg, mentionedBot);
         if (!text)
             return;
+        void addAckReaction(data.message.message_id);
         void onMessage({
             adapter: 'feishu',
             sender: senderForMessage(data.message.chat_id, data.message.thread_id),
@@ -248,7 +363,9 @@ export function createFeishuAdapter(config, context = {}) {
                     ? { wsConfig: { pingTimeout: cfg.wsPingTimeoutSeconds } }
                     : {}),
             });
-            channel.on('message', (msg) => handleNormalizedMessage(msg, onMessage));
+            channel.on('message', (msg) => {
+                void handleNormalizedMessage(msg, onMessage);
+            });
             channel.on('error', (error) => {
                 context.log?.('feishu-channel-error', { error: error.message, code: error.code }, 'ERROR');
             });