@zhin.js/adapter-lark 1.1.22 → 1.1.23

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @zhin.js/adapter-lark
 
+## 1.1.23
+
+### Patch Changes
+
+- bc6ccb1: Deep audit bug fixes and 7 architectural improvements:
+  - Sink Agent Turn ingress pipeline from `@zhin.js/cli` into `@zhin.js/agent/runtime` (`plugin-runtime/ingress/`) and decompose `ingress-route.ts` into modular pipeline stages.
+  - Bind Session State Plane (`JsxButtonRegistry`, `InteractionRuntime`, `RuntimeInteractiveRouter`) to `PluginIncarnationRef` so active buttons and interactions survive unrelated-plugin HMR while expiring when the owning plugin reloads, and support per-conversation fallback numbering (`numberingScope: 'conversation'`).
+  - Establish `conversation_events` as the canonical message SSOT and reference `conversation_event_id`, `conversation_key`, `platform_message_id`, and `message_key` in `agent_messages` (`AGENT_MESSAGE_QUERY_VERSION = 2`), threading `conversationSequence` across inbound and outbound delivery receipts.
+  - Push down `DatabaseContextRepository` and `DatabaseScheduleJobStorage` full-session/full-table memory scans to indexed SQL queries.
+  - Add kernel-level inbound `replyTo` and `mentioned` auto-promotion (`promoteInboundMessagePayload`) plus reusable `InboundDeduper` and `TtlLookupCache` primitives in `@zhin.js/adapter`.
+  - Add `MiddlewareContext.dispatch` (`InboundDispatchSummary`) and `onAfterDispatch` hooks for `after-dispatch` middlewares, and support incremental rendering of in-place `envelope.payload` array mutations in `OutboundDeliveryRuntime`.
+  - Unify `HistoryWindowTracker` and `AgentCompactionRuntime` token/message budgets (`resolveUnifiedHistoryAndCompactionBudget`).
+  - Fix schema validation, database transaction connection cleanup and SQLite WAL mode, schedule timer wheel head-of-line blocking, security policy bash read paths and subagent guard propagation, group merge window permission carrier handoff, micro-compact namespaced tool matching, and WebSocket force-close / inbound segment mapping across adapters.
+- Updated dependencies [3a8504b]
+- Updated dependencies [6163abc]
+- Updated dependencies [fed2c27]
+- Updated dependencies [bc6ccb1]
+- Updated dependencies [72b5a12]
+- Updated dependencies [aa41889]
+- Updated dependencies [4427e72]
+- Updated dependencies [22bd14a]
+  - @zhin.js/agent-feature@1.1.14
+  - @zhin.js/core@1.1.57
+  - @zhin.js/client@1.1.25
+  - @zhin.js/page@1.1.15
+  - @zhin.js/im-contract@1.1.12
+  - @zhin.js/adapter@1.1.29
+  - @zhin.js/host-http@1.1.15
+  - @zhin.js/feature-kit@1.1.13
+  - @zhin.js/tool@1.1.16
+  - @zhin.js/skill@1.1.14
+
 ## 1.1.22
 
 ### Patch Changes

package/lib/client.js

@@ -7,10 +7,10 @@ import { EndpointDeliveryError } from '@zhin.js/im-contract';
  */
 import { readFile } from 'node:fs/promises';
 import { basename } from 'node:path';
-import { createEndpointLifecycle, createEndpointOperation, createRecallEndpointControl, } from 'zhin.js/adapter';
+import { createEndpointLifecycle, createEndpointOperation, createRecallEndpointControl, InboundDeduper, TtlLookupCache, } from 'zhin.js/adapter';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { buildImageUploadForm, readOutboundImageMedia, resolveMediaBinary, } from './media-upload.js';
-import { formatInboundContent, formatOutboundBody, generateMessageId, larkInboundConversation, resolveChatType, resolveSender, } from './protocol.js';
+import { formatInboundContent, formatOutboundBody, generateMessageId, isLarkBotMentioned, larkInboundConversation, resolveChatType, resolveSender, } from './protocol.js';
 import { normalizeLarkSenderForPermit } from './platform-permit.js';
 import { registerLarkWebhookRoutes } from './webhook.js';
 import { createLarkLongConnection } from './long-connection.js';
@@ -61,10 +61,10 @@ export class LarkClient extends SdkClient {
     #started = false;
     #lifecycle;
     #cardSources = new Map();
-    #seen = new Map();
-    #chatManagers = new Map();
-    /** One chat.get per chat at a time: concurrent messages on a cache miss share the lookup. */
-    #chatManagerLookups = new Map();
+    #seen = new InboundDeduper({ ttlMs: 300_000, maxEntries: 10_000 });
+    #chatManagers = new TtlLookupCache({
+        ttlMs: LARK_CHAT_MANAGER_CACHE_TTL_MS,
+    });
     #startupGeneration = 0;
     #pendingInbound = [];
     #bindSignal;
@@ -304,17 +304,8 @@ export class LarkClient extends SdkClient {
         if (!this.#open)
             return;
         void this.receiveInboundCallback(async () => {
-            if (msg.message_id) {
-                const now = Date.now();
-                for (const [id, time] of this.#seen)
-                    if (now - time > 300_000)
-                        this.#seen.delete(id);
-                if (this.#seen.has(msg.message_id))
-                    return;
-                this.#seen.set(msg.message_id, now);
-                if (this.#seen.size > 10_000)
-                    this.#seen.delete(this.#seen.keys().next().value);
-            }
+            if (!this.#seen.shouldProcess(msg.message_id))
+                return;
             await this.#emitInbound(msg, larkInboundConversation(String(this.#options.id), msg), nativeEvent);
         }).catch((err) => this.#logger.warn(formatCompact({ op: 'lark_gateway_receive_failed',
             conversation: msg.chat_id, error: err instanceof Error ? err.message : String(err) })));
@@ -327,6 +318,8 @@ export class LarkClient extends SdkClient {
             : undefined;
         // 规范角色 owner / admin 进 roles；细粒度能力放 senderPermissions
         const role = permit?.role === 'owner' || permit?.role === 'admin' ? permit.role : undefined;
+        const mentioned = isLarkBotMentioned(msg);
+        const replyToId = msg.parent_id || msg.root_id;
         await this.publishEvent('message.receive', {
             event: nativeEvent,
             conversation,
@@ -334,6 +327,8 @@ export class LarkClient extends SdkClient {
             content: formatInboundContent(msg),
             ...(senderId ? { sender: { id: senderId, ...(role ? { roles: [role] } : {}) } } : {}),
             endpointId: this.#options.config.id,
+            ...(mentioned ? { mentioned: true } : {}),
+            ...(replyToId ? { replyTo: { id: replyToId } } : {}),
             metadata: Object.freeze({
                 messageType: msg.message_type,
                 chatType,
@@ -344,29 +339,14 @@ export class LarkClient extends SdkClient {
     }
     /** 群主 / 群管理员来自 chat.get（owner_id + 管理员列表），按群缓存；失败时保守地视为普通成员。 */
     async #resolveChatRole(chatId, senderId) {
-        const now = Date.now();
-        for (const [id, entry] of this.#chatManagers)
-            if (now - entry.at > LARK_CHAT_MANAGER_CACHE_TTL_MS)
-                this.#chatManagers.delete(id);
-        let entry = this.#chatManagers.get(chatId);
-        if (!entry) {
-            let lookup = this.#chatManagerLookups.get(chatId);
-            if (!lookup) {
-                lookup = (async () => {
-                    const info = await this.getChatInfo(chatId);
-                    const admins = Array.isArray(info?.user_manager_id_list) ? info.user_manager_id_list.map(String) : [];
-                    const fetched = {
-                        at: Date.now(),
-                        ...(typeof info?.owner_id === 'string' && info.owner_id ? { owner: info.owner_id } : {}),
-                        admins: new Set(admins),
-                    };
-                    this.#chatManagers.set(chatId, fetched);
-                    return fetched;
-                })().finally(() => this.#chatManagerLookups.delete(chatId));
-                this.#chatManagerLookups.set(chatId, lookup);
-            }
-            entry = await lookup;
-        }
+        const entry = await this.#chatManagers.getOrLoad(chatId, async () => {
+            const info = await this.getChatInfo(chatId);
+            const admins = Array.isArray(info?.user_manager_id_list) ? info.user_manager_id_list.map(String) : [];
+            return {
+                ...(typeof info?.owner_id === 'string' && info.owner_id ? { owner: info.owner_id } : {}),
+                admins: new Set(admins),
+            };
+        });
         return {
             isOwner: entry.owner !== undefined && entry.owner === senderId,
             isAdmin: entry.admins.has(senderId),
@@ -391,11 +371,8 @@ export class LarkClient extends SdkClient {
         if (!source || source.conversation.id !== chatId || Date.now() - source.time > 300_000)
             return;
         const dedup = `card:${event.token ?? `${sourceId}:${sender}:${payload}`}`;
-        if (this.#seen.has(dedup))
+        if (!this.#seen.shouldProcess(dedup))
             return;
-        this.#seen.set(dedup, Date.now());
-        if (this.#seen.size > 10_000)
-            this.#seen.delete(this.#seen.keys().next().value);
         const conversation = source.conversation;
         void this.publishEvent('message.receive', {
             event,

package/lib/protocol.d.ts

@@ -111,6 +111,8 @@ export declare function resolveChatType(chatId?: string, chatType?: string): 'gr
 export declare function larkInboundConversation(endpointKey: string, msg: LarkMessage): ConversationRef;
 export declare function resolveSender(msg: LarkMessage): string | undefined;
 export declare function generateMessageId(msg: LarkMessage): string;
+/** 判断入站消息是否 @ 了非全员目标（Lark 群消息 @ 机器人在 mentions 列表中，key 不为 `@_all`）。 */
+export declare function isLarkBotMentioned(msg: LarkMessage): boolean;
 /** Build inbound text for OutboundMessageService.receive. */
 export declare function formatInboundContent(msg: LarkMessage): string;
 /** 验签时间戳时效窗口（防重放）。 */

package/lib/protocol.js

@@ -89,6 +89,12 @@ export function resolveSender(msg) {
 export function generateMessageId(msg) {
     return msg.message_id || `${msg.create_time ?? Date.now()}`;
 }
+/** 判断入站消息是否 @ 了非全员目标（Lark 群消息 @ 机器人在 mentions 列表中，key 不为 `@_all`）。 */
+export function isLarkBotMentioned(msg) {
+    if (!Array.isArray(msg.mentions) || msg.mentions.length === 0)
+        return false;
+    return msg.mentions.some((m) => m && m.key !== '@_all');
+}
 /** Build inbound text for OutboundMessageService.receive. */
 export function formatInboundContent(msg) {
     if (!msg.content || !msg.message_type)

package/lib/webhook.js

@@ -56,9 +56,10 @@ export async function handleLarkWebhookRequest(request, response, handler) {
             response.end(JSON.stringify({ challenge: event.challenge }));
             return;
         }
-        if (event.header?.event_type === 'card.action.trigger' && handler.isOpen)
+        const headerEventType = event.header?.event_type;
+        if (headerEventType === 'card.action.trigger' && handler.isOpen)
             handler.admitCardAction?.(event.event);
-        if (event.type === 'event_callback' && event.event?.message && handler.isOpen) {
+        if ((event.type === 'event_callback' || headerEventType === 'im.message.receive_v1') && event.event?.message && handler.isOpen) {
             const message = {
                 ...event.event.message,
                 sender: event.event.message.sender ?? event.event.sender,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-lark",
-  "version": "1.1.22",
+  "version": "1.1.23",
   "description": "Zhin.js Lark/Feishu adapter (HTTP webhook and WebSocket long connection)",
   "type": "module",
   "main": "./lib/index.js",
@@ -35,27 +35,27 @@
   "dependencies": {
     "@larksuiteoapi/node-sdk": "^1.67.0",
     "undici": "6.29.1",
-    "@zhin.js/adapter": "1.1.28",
-    "@zhin.js/agent-feature": "1.1.13",
-    "@zhin.js/client": "1.1.24",
+    "@zhin.js/adapter": "1.1.29",
+    "@zhin.js/agent-feature": "1.1.14",
+    "@zhin.js/client": "1.1.25",
     "@zhin.js/console-contract": "1.1.3",
-    "@zhin.js/core": "1.1.56",
-    "@zhin.js/feature-kit": "1.1.12",
-    "@zhin.js/host-http": "1.1.14",
-    "@zhin.js/im-contract": "1.1.11",
+    "@zhin.js/core": "1.1.57",
+    "@zhin.js/feature-kit": "1.1.13",
+    "@zhin.js/host-http": "1.1.15",
+    "@zhin.js/im-contract": "1.1.12",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/page": "1.1.14",
-    "@zhin.js/skill": "1.1.13",
-    "@zhin.js/tool": "1.1.15"
+    "@zhin.js/page": "1.1.15",
+    "@zhin.js/skill": "1.1.14",
+    "@zhin.js/tool": "1.1.16"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.28",
-    "@zhin.js/command": "^1.1.14",
-    "@zhin.js/core": "^1.1.56",
-    "@zhin.js/host-http": "^1.1.14",
-    "@zhin.js/permission": "^1.1.12",
-    "zhin.js": "^1.1.21"
+    "@zhin.js/adapter": "^1.1.29",
+    "@zhin.js/command": "^1.1.15",
+    "@zhin.js/core": "^1.1.57",
+    "@zhin.js/host-http": "^1.1.15",
+    "@zhin.js/permission": "^1.1.13",
+    "zhin.js": "^1.1.22"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -73,7 +73,7 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "zhin.js": "1.1.21"
+    "zhin.js": "1.1.22"
   },
   "files": [
     "adapters",

package/src/client.ts

@@ -20,6 +20,8 @@ import {
   type EndpointSendRequest,
   type EndpointManagementRequest,
   type EndpointGroupRequest,
+  InboundDeduper,
+  TtlLookupCache,
 } from 'zhin.js/adapter';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
@@ -33,6 +35,7 @@ import {
   formatInboundContent,
   formatOutboundBody,
   generateMessageId,
+  isLarkBotMentioned,
   larkInboundConversation,
   resolveChatType,
   resolveSender,
@@ -137,10 +140,10 @@ export class LarkClient extends SdkClient {
   #started = false;
   readonly #lifecycle: EndpointLifecycle;
   readonly #cardSources = new Map<string, { conversation: ConversationRef; time: number }>();
-  readonly #seen = new Map<string, number>();
-  readonly #chatManagers = new Map<string, { at: number; owner?: string; admins: ReadonlySet<string> }>();
-  /** One chat.get per chat at a time: concurrent messages on a cache miss share the lookup. */
-  readonly #chatManagerLookups = new Map<string, Promise<{ at: number; owner?: string; admins: ReadonlySet<string> }>>();
+  readonly #seen = new InboundDeduper({ ttlMs: 300_000, maxEntries: 10_000 });
+  readonly #chatManagers = new TtlLookupCache<string, { owner?: string; admins: ReadonlySet<string> }>({
+    ttlMs: LARK_CHAT_MANAGER_CACHE_TTL_MS,
+  });
   #startupGeneration = 0;
   readonly #pendingInbound: { message: LarkMessage; event: unknown }[] = [];
 
@@ -358,13 +361,7 @@ export class LarkClient extends SdkClient {
   admit(msg: LarkMessage, nativeEvent: unknown = msg): void {
     if (!this.#open) return;
     void this.receiveInboundCallback(async () => {
-      if (msg.message_id) {
-        const now = Date.now();
-        for (const [id, time] of this.#seen) if (now - time > 300_000) this.#seen.delete(id);
-        if (this.#seen.has(msg.message_id)) return;
-        this.#seen.set(msg.message_id, now);
-        if (this.#seen.size > 10_000) this.#seen.delete(this.#seen.keys().next().value!);
-      }
+      if (!this.#seen.shouldProcess(msg.message_id)) return;
       await this.#emitInbound(msg, larkInboundConversation(String(this.#options.id), msg), nativeEvent);
     }).catch((err) => this.#logger.warn(formatCompact({ op: 'lark_gateway_receive_failed',
       conversation: msg.chat_id, error: err instanceof Error ? err.message : String(err) })));
@@ -378,6 +375,8 @@ export class LarkClient extends SdkClient {
       : undefined;
     // 规范角色 owner / admin 进 roles；细粒度能力放 senderPermissions
     const role = permit?.role === 'owner' || permit?.role === 'admin' ? permit.role : undefined;
+    const mentioned = isLarkBotMentioned(msg);
+    const replyToId = msg.parent_id || msg.root_id;
     await this.publishEvent('message.receive', {
       event: nativeEvent,
       conversation,
@@ -385,6 +384,8 @@ export class LarkClient extends SdkClient {
       content: formatInboundContent(msg),
       ...(senderId ? { sender: { id: senderId, ...(role ? { roles: [role] } : {}) } } : {}),
       endpointId: this.#options.config.id,
+      ...(mentioned ? { mentioned: true } : {}),
+      ...(replyToId ? { replyTo: { id: replyToId } } : {}),
       metadata: Object.freeze({
         messageType: msg.message_type,
         chatType,
@@ -396,30 +397,17 @@ export class LarkClient extends SdkClient {
 
   /** 群主 / 群管理员来自 chat.get（owner_id + 管理员列表），按群缓存；失败时保守地视为普通成员。 */
   async #resolveChatRole(chatId: string, senderId: string): Promise<{ isOwner: boolean; isAdmin: boolean }> {
-    const now = Date.now();
-    for (const [id, entry] of this.#chatManagers) if (now - entry.at > LARK_CHAT_MANAGER_CACHE_TTL_MS) this.#chatManagers.delete(id);
-    let entry = this.#chatManagers.get(chatId);
-    if (!entry) {
-      let lookup = this.#chatManagerLookups.get(chatId);
-      if (!lookup) {
-        lookup = (async () => {
-          const info = await this.getChatInfo(chatId) as {
-            owner_id?: unknown;
-            user_manager_id_list?: unknown;
-          } | null;
-          const admins = Array.isArray(info?.user_manager_id_list) ? info.user_manager_id_list.map(String) : [];
-          const fetched = {
-            at: Date.now(),
-            ...(typeof info?.owner_id === 'string' && info.owner_id ? { owner: info.owner_id } : {}),
-            admins: new Set(admins) as ReadonlySet<string>,
-          };
-          this.#chatManagers.set(chatId, fetched);
-          return fetched;
-        })().finally(() => this.#chatManagerLookups.delete(chatId));
-        this.#chatManagerLookups.set(chatId, lookup);
-      }
-      entry = await lookup;
-    }
+    const entry = await this.#chatManagers.getOrLoad(chatId, async () => {
+      const info = await this.getChatInfo(chatId) as {
+        owner_id?: unknown;
+        user_manager_id_list?: unknown;
+      } | null;
+      const admins = Array.isArray(info?.user_manager_id_list) ? info.user_manager_id_list.map(String) : [];
+      return {
+        ...(typeof info?.owner_id === 'string' && info.owner_id ? { owner: info.owner_id } : {}),
+        admins: new Set(admins) as ReadonlySet<string>,
+      };
+    });
     return {
       isOwner: entry.owner !== undefined && entry.owner === senderId,
       isAdmin: entry.admins.has(senderId),
@@ -442,9 +430,7 @@ export class LarkClient extends SdkClient {
     const source = this.#cardSources.get(sourceId);
     if (!source || source.conversation.id !== chatId || Date.now() - source.time > 300_000) return;
     const dedup = `card:${event.token ?? `${sourceId}:${sender}:${payload}`}`;
-    if (this.#seen.has(dedup)) return;
-    this.#seen.set(dedup, Date.now());
-    if (this.#seen.size > 10_000) this.#seen.delete(this.#seen.keys().next().value!);
+    if (!this.#seen.shouldProcess(dedup)) return;
     const conversation = source.conversation;
     void this.publishEvent('message.receive', {
       event,

package/src/protocol.ts

@@ -206,6 +206,12 @@ export function generateMessageId(msg: LarkMessage): string {
   return msg.message_id || `${msg.create_time ?? Date.now()}`;
 }
 
+/** 判断入站消息是否 @ 了非全员目标（Lark 群消息 @ 机器人在 mentions 列表中，key 不为 `@_all`）。 */
+export function isLarkBotMentioned(msg: LarkMessage): boolean {
+  if (!Array.isArray(msg.mentions) || msg.mentions.length === 0) return false;
+  return msg.mentions.some((m) => m && m.key !== '@_all');
+}
+
 /** Build inbound text for OutboundMessageService.receive. */
 export function formatInboundContent(msg: LarkMessage): string {
   if (!msg.content || !msg.message_type) return '';

package/src/webhook.ts

@@ -96,9 +96,10 @@ export async function handleLarkWebhookRequest(
       return;
     }
 
-    if ((event as LarkEventBody & { header?: { event_type?: string } }).header?.event_type === 'card.action.trigger' && handler.isOpen) handler.admitCardAction?.(event.event as LarkCardAction);
+    const headerEventType = (event as LarkEventBody & { header?: { event_type?: string } }).header?.event_type;
+    if (headerEventType === 'card.action.trigger' && handler.isOpen) handler.admitCardAction?.(event.event as LarkCardAction);
 
-    if (event.type === 'event_callback' && event.event?.message && handler.isOpen) {
+    if ((event.type === 'event_callback' || headerEventType === 'im.message.receive_v1') && event.event?.message && handler.isOpen) {
       const message: LarkMessage = {
         ...event.event.message,
         sender: event.event.message.sender ?? event.event.sender,