@zhin.js/adapter-kook 1.1.21 → 1.1.23

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # @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
+
+- b249e5e: ADR 0044 C4：事件映射迁出 core。新增 `@zhin.js/adapter-onebot-events`，承载 OneBot v11 / NapCat / icqq 的原始通知与请求 → 标准事件映射（`receiveOneBotLikeSideEvent`、`mapNoticeParts`、`mapRequestParts`、`resolveSideEventDedupeKey` 及 OneBot 映射表，icqq 差异用覆盖表表达）；KOOK、Slack 的映射迁入各自适配器；`@zhin.js/core` 只保留标准事件名、类型与 `buildNotice` / `buildRequest` / `buildSystem` / `senderFromId`，不再含任何平台名。core 不再导出上述映射函数与 `ONEBOT_/KOOK_/SLACK_NOTICE_PARTS_MAP`、`SideEventPlatform`、`OneBotLike*` 类型，适配器改从共享包导入。
+- 41ff1a5: ADR 0044 C5: every official adapter now declares a capability `profile` (its `segments` moved into `profile.default.messaging.segments`). icqq declares the complete profile (per conversation kind: scene, all 14 actions with real limits, events, feedback, delivery) and implements the seven new management ports (`pokeUser`, `unmuteGroupMember`, `muteAllGroupMembers`, `setGroupCard`, `setGroupTitle`, `setGroupEssence`, `inviteGroupMember`) with fresh bot-role reads. qq official declares its passive reply windows; undeclared capabilities stay unsupported.
+- cbd3f14: ADR 0044 integration and C6 guard. `delivery.spool` now reproduces the pre-0044 media rule (icqq `false`, every other official adapter `true`). icqq narrows `actions.recall.others` unless the Bot is admin or owner, and declares recall for groups. Endpoint kind capabilities merge the Endpoint's `operations` (Discord reactions keep working; Discord declares reaction feedback). Adapters in the `@zhin.js/` scope are trusted: their custom prompt text is not labelled `external_content`. Core no longer keeps a telegram/discord interactive-policy table (adapters declare `segments.interactive`). New `pnpm check:no-platform-branches` blocks platform-name branches in runtime code.
+- 4fe49b5: 支持配置按需生效：分离保存与有效版本，独立变更先应用，账号资料更新保留连接，模型按回合使用确定版本；Console 返回结构化应用结果。监听改为仅显式 --watch 启用，开发模板显式选择源码和配置监听。
+
+  自变更消费配置应用回执，避免已处理配置被二次重载；持久化本次写入修订和应用结果，未知结果或修订冲突时停止自动续作并保留现场，恢复不会覆盖未经本次变更确认的配置。
+
+- Updated dependencies [b249e5e]
+- Updated dependencies [57661f6]
+- Updated dependencies [cbd3f14]
+- Updated dependencies [299863a]
+- Updated dependencies [aaa93d7]
+- Updated dependencies [bd524d1]
+- Updated dependencies [126ae99]
+- Updated dependencies [4fe49b5]
+- Updated dependencies [cce07db]
+- Updated dependencies [b652db3]
+- Updated dependencies [0315ba0]
+- Updated dependencies [00be764]
+  - @zhin.js/core@1.1.56
+  - @zhin.js/adapter@1.1.28
+  - @zhin.js/im-contract@1.1.11
+  - @zhin.js/tool@1.1.15
+  - @zhin.js/skill@1.1.13
+  - @zhin.js/host-http@1.1.14
+  - @zhin.js/feature-kit@1.1.12
+  - @zhin.js/client@1.1.24
+  - @zhin.js/page@1.1.14
+  - @zhin.js/agent-feature@1.1.13
+  - @zhin.js/permission@1.1.12
+
 ## 1.1.21
 
 ### Patch Changes

package/adapters/kook/index.js

@@ -9,13 +9,25 @@ import {} from "../../lib/protocol.js";
 export { KookWebhookEndpoint, KookWebsocketEndpoint, } from "../../lib/endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
-    operations: ['recall'],
     // KOOK 图片上传后以原生卡片保留图文混排；KMarkdown 原生消费；
     // 原生卡片按钮经 return-val 事件进入 canonical action 链路。
-    segments: {
-        outboundMedia: ['url', 'upload'],
-        interactive: 'native',
-        markdown: 'native',
+    profile: {
+        default: {
+            messaging: {
+                segments: {
+                    outboundMedia: ['url', 'upload'],
+                    interactive: 'native',
+                    markdown: 'native',
+                },
+                quote: true,
+                recall: {},
+            },
+            actions: {
+                recall: { scopes: ['private', 'group', 'channel'] },
+                quoteReply: { scopes: ['private', 'group', 'channel'] },
+            },
+            delivery: { send: true, proactive: true, spool: true },
+        },
     },
     createAdapter: context => new KookAdapter(context),
 });

package/adapters/kook/index.ts

@@ -20,13 +20,25 @@ export type { KookClientTransport } from '../../src/ws.js';
 
 export default defineAdapter<KookEndpointConfig>({
   capabilities: ['inbound', 'outbound'],
-  operations: ['recall'],
   // KOOK 图片上传后以原生卡片保留图文混排；KMarkdown 原生消费；
   // 原生卡片按钮经 return-val 事件进入 canonical action 链路。
-  segments: {
-    outboundMedia: ['url', 'upload'],
-    interactive: 'native',
-    markdown: 'native',
+  profile: {
+    default: {
+      messaging: {
+        segments: {
+          outboundMedia: ['url', 'upload'],
+          interactive: 'native',
+          markdown: 'native',
+        },
+        quote: true,
+        recall: {},
+      },
+      actions: {
+        recall: { scopes: ['private', 'group', 'channel'] },
+        quoteReply: { scopes: ['private', 'group', 'channel'] },
+      },
+      delivery: { send: true, proactive: true, spool: true },
+    },
   },
   createAdapter: context => new KookAdapter(context),
 });

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/lib/side-event-dispatch.js

@@ -1,5 +1,6 @@
-import { composeSideEventName, buildNotice, mapNoticeParts, senderFromId, KOOK_NOTICE_PARTS_MAP } from '@zhin.js/core';
+import { composeSideEventName, buildNotice, senderFromId } from '@zhin.js/core';
 import { formatCompact } from '@zhin.js/logger';
+import { mapKookNoticeParts } from './side-event-map.js';
 function extractKookNoticeType(raw) {
     if (!raw || typeof raw !== 'object')
         return null;
@@ -16,10 +17,10 @@ export function receiveKookSideEvent(emit, configId, raw, logger) {
     const noticeType = extractKookNoticeType(raw);
     if (!noticeType)
         return false;
-    if (!Object.prototype.hasOwnProperty.call(KOOK_NOTICE_PARTS_MAP, noticeType))
+    const parts = mapKookNoticeParts(noticeType);
+    if (!parts)
         return false;
     const event = raw;
-    const parts = mapNoticeParts('kook', noticeType);
     const body = event.extra?.body;
     const guildId = event.extra?.guild_id
         ?? (event.channel_type === 'GROUP' && event.type === 255 ? event.target_id : undefined);

package/lib/side-event-map.d.ts

@@ -0,0 +1,5 @@
+import type { SideEventParts } from '@zhin.js/core';
+/** KOOK extra.type 原始值 → 标准 scene_type + sub_type */
+export declare const KOOK_NOTICE_PARTS_MAP: Readonly<Record<string, SideEventParts>>;
+/** 已登记的 KOOK 通知映射为标准 scene_type + sub_type；未登记返回 undefined。 */
+export declare function mapKookNoticeParts(raw: string): SideEventParts | undefined;

package/lib/side-event-map.js

@@ -0,0 +1,15 @@
+/** KOOK extra.type 原始值 → 标准 scene_type + sub_type */
+export const KOOK_NOTICE_PARTS_MAP = {
+    joined_guild: { scene_type: 'group', sub_type: 'member_increase' },
+    exited_guild: { scene_type: 'group', sub_type: 'member_decrease' },
+    deleted_message: { scene_type: 'group', sub_type: 'recall' },
+    deleted_private_message: { scene_type: 'friend', sub_type: 'recall' },
+    added_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+    deleted_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+    private_added_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+    private_deleted_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+};
+/** 已登记的 KOOK 通知映射为标准 scene_type + sub_type；未登记返回 undefined。 */
+export function mapKookNoticeParts(raw) {
+    return Object.prototype.hasOwnProperty.call(KOOK_NOTICE_PARTS_MAP, raw) ? KOOK_NOTICE_PARTS_MAP[raw] : undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-kook",
-  "version": "1.1.21",
+  "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.27",
-    "@zhin.js/agent-feature": "1.1.12",
-    "@zhin.js/client": "1.1.23",
+    "@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.55",
-    "@zhin.js/feature-kit": "1.1.11",
-    "@zhin.js/host-http": "1.1.13",
-    "@zhin.js/im-contract": "1.1.10",
+    "@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.13",
-    "@zhin.js/permission": "1.1.11",
-    "@zhin.js/skill": "1.1.12",
-    "@zhin.js/tool": "1.1.14"
+    "@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.27",
-    "@zhin.js/command": "^1.1.13",
-    "@zhin.js/core": "^1.1.55",
-    "zhin.js": "^1.1.20"
+    "@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.13",
-    "zhin.js": "1.1.20"
+    "@zhin.js/host-http": "1.1.15",
+    "zhin.js": "1.1.22"
   },
   "files": [
     "adapters",

package/plugin.js

@@ -5,6 +5,7 @@ import { checkKookPlatformPermit } from "./lib/platform-permit.js";
 import { createKookConsoleRpc } from "./lib/console.js";
 export default definePlugin({
     name: 'kook',
+    configUpdate: { featurePaths: [['nickname'], ['profile'], ['endpoints']] },
     metadata: {
         displayName: 'KOOK WebSocket Adapter',
     },

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 };
   }
 }

package/src/side-event-dispatch.ts

@@ -1,7 +1,8 @@
-import { composeSideEventName, buildNotice, mapNoticeParts, senderFromId, KOOK_NOTICE_PARTS_MAP } from '@zhin.js/core';
+import { composeSideEventName, buildNotice, senderFromId } from '@zhin.js/core';
 import type { EndpointEventEmitter } from 'zhin.js/adapter';
 import { formatCompact, type getAdapterLogger } from '@zhin.js/logger';
 import type { KookWebhookEventData } from './protocol.js';
+import { mapKookNoticeParts } from './side-event-map.js';
 
 function extractKookNoticeType(raw: unknown): string | null {
   if (!raw || typeof raw !== 'object') return null;
@@ -22,9 +23,9 @@ export function receiveKookSideEvent(
 ): boolean {
   const noticeType = extractKookNoticeType(raw);
   if (!noticeType) return false;
-  if (!Object.prototype.hasOwnProperty.call(KOOK_NOTICE_PARTS_MAP, noticeType)) return false;
+  const parts = mapKookNoticeParts(noticeType);
+  if (!parts) return false;
   const event = raw as KookWebhookEventData;
-  const parts = mapNoticeParts('kook', noticeType);
   const body = event.extra?.body;
   const guildId = event.extra?.guild_id
     ?? (event.channel_type === 'GROUP' && event.type === 255 ? event.target_id : undefined);

package/src/side-event-map.ts

@@ -0,0 +1,18 @@
+import type { SideEventParts } from '@zhin.js/core';
+
+/** KOOK extra.type 原始值 → 标准 scene_type + sub_type */
+export const KOOK_NOTICE_PARTS_MAP: Readonly<Record<string, SideEventParts>> = {
+  joined_guild: { scene_type: 'group', sub_type: 'member_increase' },
+  exited_guild: { scene_type: 'group', sub_type: 'member_decrease' },
+  deleted_message: { scene_type: 'group', sub_type: 'recall' },
+  deleted_private_message: { scene_type: 'friend', sub_type: 'recall' },
+  added_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+  deleted_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+  private_added_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+  private_deleted_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+};
+
+/** 已登记的 KOOK 通知映射为标准 scene_type + sub_type；未登记返回 undefined。 */
+export function mapKookNoticeParts(raw: string): SideEventParts | undefined {
+  return Object.prototype.hasOwnProperty.call(KOOK_NOTICE_PARTS_MAP, raw) ? KOOK_NOTICE_PARTS_MAP[raw] : undefined;
+}