@zhin.js/adapter-kook 1.1.22 → 1.1.23

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @zhin.js/adapter-kook
 
+## 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/permission@1.1.13
+  - @zhin.js/skill@1.1.14
+
 ## 1.1.22
 
 ### Patch Changes

package/lib/sender-roles.d.ts

@@ -1,11 +1,3 @@
-/**
- * KOOK 入站发送者角色投影。
- *
- * 事件只携带数字角色 id，无法直接判断群主 / 管理员；这里按服务器缓存
- * guild.view（群主 id）与 guild-role.list（角色权限位），把发送者投影为
- * 跨平台规范角色 owner / admin。原始角色 id 以 `role:<id>` 形式放入 permissions，
- * 不进入 `sender.roles`。
- */
 import type { KookClientTransport } from './ws.js';
 export interface KookSenderRoleProjection {
     /** 规范角色：owner / admin；普通成员为 undefined。 */

package/lib/sender-roles.js

@@ -1,11 +1,18 @@
+/**
+ * KOOK 入站发送者角色投影。
+ *
+ * 事件只携带数字角色 id，无法直接判断群主 / 管理员；这里按服务器缓存
+ * guild.view（群主 id）与 guild-role.list（角色权限位），把发送者投影为
+ * 跨平台规范角色 owner / admin。原始角色 id 以 `role:<id>` 形式放入 permissions，
+ * 不进入 `sender.roles`。
+ */
+import { TtlLookupCache } from 'zhin.js/adapter';
 /** KOOK 角色权限位：0x1 = 管理员。 */
 const KOOK_ROLE_ADMIN_BIT = 1;
 const CACHE_TTL_MS = 60_000;
 export class KookSenderRoleResolver {
     getClient;
-    #guilds = new Map();
-    /** One lookup per guild at a time: concurrent messages on a cache miss share it. */
-    #lookups = new Map();
+    #guilds = new TtlLookupCache({ ttlMs: CACHE_TTL_MS });
     constructor(getClient) {
         this.getClient = getClient;
     }
@@ -24,18 +31,11 @@ export class KookSenderRoleResolver {
         return { permissions };
     }
     async #snapshot(guildId) {
-        const cached = this.#guilds.get(guildId);
-        if (cached && Date.now() - cached.at < CACHE_TTL_MS)
-            return cached;
-        let lookup = this.#lookups.get(guildId);
-        if (!lookup) {
-            lookup = this.#fetch(guildId).finally(() => this.#lookups.delete(guildId));
-            this.#lookups.set(guildId, lookup);
-        }
-        return lookup;
+        return this.#guilds.getOrLoad(guildId, () => this.#fetch(guildId), {
+            cacheWhen: (snapshot) => snapshot !== undefined,
+        });
     }
     async #fetch(guildId) {
-        const now = Date.now();
         const client = this.getClient();
         if (!client)
             return undefined;
@@ -54,8 +54,6 @@ export class KookSenderRoleResolver {
             }
         }
         catch { /* 保守：视为无管理员角色 */ }
-        const snapshot = { at: now, ...(ownerId ? { ownerId } : {}), adminRoleIds };
-        this.#guilds.set(guildId, snapshot);
-        return snapshot;
+        return { ...(ownerId ? { ownerId } : {}), adminRoleIds };
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-kook",
-  "version": "1.1.22",
+  "version": "1.1.23",
   "description": "Zhin.js KOOK adapter for Plugin Runtime (WebSocket gateway or Webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,26 +33,26 @@
   },
   "dependencies": {
     "kook-client": "^1.0.5",
-    "@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/permission": "1.1.12",
-    "@zhin.js/skill": "1.1.13",
-    "@zhin.js/tool": "1.1.15"
+    "@zhin.js/page": "1.1.15",
+    "@zhin.js/permission": "1.1.13",
+    "@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": "^1.1.21"
+    "@zhin.js/adapter": "^1.1.29",
+    "@zhin.js/command": "^1.1.15",
+    "@zhin.js/core": "^1.1.57",
+    "zhin.js": "^1.1.22"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -70,8 +70,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/host-http": "1.1.14",
-    "zhin.js": "1.1.21"
+    "@zhin.js/host-http": "1.1.15",
+    "zhin.js": "1.1.22"
   },
   "files": [
     "adapters",

package/src/sender-roles.ts

@@ -6,6 +6,7 @@
  * 跨平台规范角色 owner / admin。原始角色 id 以 `role:<id>` 形式放入 permissions，
  * 不进入 `sender.roles`。
  */
+import { TtlLookupCache } from 'zhin.js/adapter';
 import type { KookClientTransport } from './ws.js';
 
 /** KOOK 角色权限位：0x1 = 管理员。 */
@@ -19,15 +20,12 @@ export interface KookSenderRoleProjection {
 }
 
 interface GuildSnapshot {
-  readonly at: number;
   readonly ownerId?: string;
   readonly adminRoleIds: ReadonlySet<string>;
 }
 
 export class KookSenderRoleResolver {
-  readonly #guilds = new Map<string, GuildSnapshot>();
-  /** One lookup per guild at a time: concurrent messages on a cache miss share it. */
-  readonly #lookups = new Map<string, Promise<GuildSnapshot | undefined>>();
+  readonly #guilds = new TtlLookupCache<string, GuildSnapshot | undefined>({ ttlMs: CACHE_TTL_MS });
 
   constructor(private readonly getClient: () => KookClientTransport | null) {}
 
@@ -51,18 +49,12 @@ export class KookSenderRoleResolver {
   }
 
   async #snapshot(guildId: string): Promise<GuildSnapshot | undefined> {
-    const cached = this.#guilds.get(guildId);
-    if (cached && Date.now() - cached.at < CACHE_TTL_MS) return cached;
-    let lookup = this.#lookups.get(guildId);
-    if (!lookup) {
-      lookup = this.#fetch(guildId).finally(() => this.#lookups.delete(guildId));
-      this.#lookups.set(guildId, lookup);
-    }
-    return lookup;
+    return this.#guilds.getOrLoad(guildId, () => this.#fetch(guildId), {
+      cacheWhen: (snapshot): snapshot is GuildSnapshot => snapshot !== undefined,
+    });
   }
 
   async #fetch(guildId: string): Promise<GuildSnapshot | undefined> {
-    const now = Date.now();
     const client = this.getClient();
     if (!client) return undefined;
     let ownerId: string | undefined;
@@ -76,8 +68,6 @@ export class KookSenderRoleResolver {
         if ((Number(role.permissions) & KOOK_ROLE_ADMIN_BIT) !== 0) adminRoleIds.add(String(role.role_id));
       }
     } catch { /* 保守：视为无管理员角色 */ }
-    const snapshot: GuildSnapshot = { at: now, ...(ownerId ? { ownerId } : {}), adminRoleIds };
-    this.#guilds.set(guildId, snapshot);
-    return snapshot;
+    return { ...(ownerId ? { ownerId } : {}), adminRoleIds };
   }
 }