@zhin.js/adapter-kook 1.1.21 → 1.1.22

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @zhin.js/adapter-kook
 
+## 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/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.22",
   "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.28",
+    "@zhin.js/agent-feature": "1.1.13",
+    "@zhin.js/client": "1.1.24",
     "@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.56",
+    "@zhin.js/feature-kit": "1.1.12",
+    "@zhin.js/host-http": "1.1.14",
+    "@zhin.js/im-contract": "1.1.11",
     "@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.14",
+    "@zhin.js/permission": "1.1.12",
+    "@zhin.js/skill": "1.1.13",
+    "@zhin.js/tool": "1.1.15"
   },
   "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.28",
+    "@zhin.js/command": "^1.1.14",
+    "@zhin.js/core": "^1.1.56",
+    "zhin.js": "^1.1.21"
   },
   "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.14",
+    "zhin.js": "1.1.21"
   },
   "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/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;
+}