@zhin.js/adapter-onebot11 1.1.21 → 1.1.23

package/CHANGELOG.md

@@ -1,5 +1,75 @@
 # @zhin.js/adapter-onebot11
 
+## 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/adapter-onebot-events@0.0.2
+  - @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/adapter-onebot-events@0.0.1
+  - @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/onebot11/index.js

@@ -9,11 +9,23 @@ export { OneBot11WsEndpoint } from "../../lib/ws-endpoint.js";
 export { OneBot11WssEndpoint } from "../../lib/wss-endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
-    operations: ['recall'],
     // OneBot file 参数原生消费 url / base64:// 媒体；无卡片交互面，交互段降级纯文本。
-    segments: {
-        outboundMedia: ['url', 'base64'],
-        interactive: 'text',
+    profile: {
+        default: {
+            messaging: {
+                segments: {
+                    outboundMedia: ['url', 'base64'],
+                    interactive: 'text',
+                },
+                quote: true,
+                recall: {},
+            },
+            actions: {
+                recall: { scopes: ['private', 'group'] },
+                quoteReply: { scopes: ['private', 'group'] },
+            },
+            delivery: { send: true, proactive: true, spool: true },
+        },
     },
     createAdapter: context => new Onebot11Adapter(context),
 });

package/adapters/onebot11/index.ts

@@ -15,11 +15,23 @@ export type { OneBot11WsSocket, OneBot11WsCreateOptions } from '../../src/ws-typ
 
 export default defineAdapter<OneBot11EndpointConfig>({
   capabilities: ['inbound', 'outbound'],
-  operations: ['recall'],
   // OneBot file 参数原生消费 url / base64:// 媒体；无卡片交互面，交互段降级纯文本。
-  segments: {
-    outboundMedia: ['url', 'base64'],
-    interactive: 'text',
+  profile: {
+    default: {
+      messaging: {
+        segments: {
+          outboundMedia: ['url', 'base64'],
+          interactive: 'text',
+        },
+        quote: true,
+        recall: {},
+      },
+      actions: {
+        recall: { scopes: ['private', 'group'] },
+        quoteReply: { scopes: ['private', 'group'] },
+      },
+      delivery: { send: true, proactive: true, spool: true },
+    },
   },
   createAdapter: context => new Onebot11Adapter(context),
 });

package/lib/protocol.d.ts

@@ -5,6 +5,7 @@ import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
  * Spec: https://github.com/botuniverse/onebot-11
  */
 import { type MediaRef, type ConversationRef } from '@zhin.js/im-contract';
+import { type Segment } from '@zhin.js/core';
 /** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
 export interface OneBot11EndpointConfig extends EndpointProfileConfiguration {
     readonly connection?: 'ws' | 'wss';
@@ -117,6 +118,7 @@ export interface OneBot11InboundFields {
     readonly replyTo: {
         readonly id: string;
     } | undefined;
+    readonly segments?: readonly Segment[];
 }
 /** 构造 gateway.receive 的 metadata 与提升字段（ws / wss 两个 endpoint 共用）。 */
 export declare function formatInboundMetadata(ev: OneBot11Event, endpoint: string): OneBot11InboundFields;

package/lib/protocol.js

@@ -4,6 +4,7 @@
  * Spec: https://github.com/botuniverse/onebot-11
  */
 import { EndpointDeliveryError, isMediaRef } from '@zhin.js/im-contract';
+import { toCanonicalSegments } from '@zhin.js/core';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 const logger = getLogger('onebot11');
 function normalizeConnection(connection) {
@@ -161,6 +162,7 @@ export function formatInboundMetadata(ev, endpoint) {
     const nickname = senderNickname(ev);
     const quoteId = extractQuoteId(ev);
     const mentioned = isOneBot11BotMentioned({ selfId, message: ev.message });
+    const segments = Array.isArray(ev.message) ? toCanonicalSegments(ev.message) : undefined;
     return {
         metadata: Object.freeze({
             message_type: ev.message_type,
@@ -174,6 +176,7 @@ export function formatInboundMetadata(ev, endpoint) {
         endpointId: endpoint,
         mentioned,
         replyTo: quoteId ? { id: quoteId } : undefined,
+        ...(segments?.length ? { segments } : {}),
     };
 }
 /**

package/lib/side-event-dispatch.js

@@ -1,4 +1,4 @@
-import { receiveOneBotLikeSideEvent } from '@zhin.js/core';
+import { receiveOneBotLikeSideEvent } from '@zhin.js/adapter-onebot-events';
 import { formatCompact } from '@zhin.js/logger';
 export function receiveOneBot11SideEvent(raw, context) {
     const { emit, endpointKey, caller, logger } = context;

package/lib/ws-endpoint.js

@@ -165,6 +165,7 @@ export class OneBot11WsEndpoint extends Onebot11Client {
             endpointId: inbound.endpointId,
             ...(inbound.mentioned ? { mentioned: true } : {}),
             ...(inbound.replyTo ? { replyTo: inbound.replyTo } : {}),
+            ...(inbound.segments?.length ? { segments: inbound.segments } : {}),
             metadata: inbound.metadata,
         }).catch((err) => {
             this.#logger.warn(formatCompact({
@@ -207,6 +208,7 @@ export class OneBot11WsEndpoint extends Onebot11Client {
                 }
                 try {
                     ws.close();
+                    ws.terminate?.();
                 }
                 catch {
                     /* ignore */

package/lib/ws-types.d.ts

@@ -3,6 +3,7 @@ export interface OneBot11WsSocket {
     readonly readyState: number;
     send(data: string): void;
     close(code?: number, reason?: string): void;
+    terminate?(): void;
     ping?(): void;
     on(event: 'open' | 'message' | 'close' | 'error' | 'pong', listener: (...args: unknown[]) => void): void;
 }

package/lib/wss-endpoint.js

@@ -172,6 +172,7 @@ export class OneBot11WssEndpoint extends Onebot11Client {
             endpointId: inbound.endpointId,
             ...(inbound.mentioned ? { mentioned: true } : {}),
             ...(inbound.replyTo ? { replyTo: inbound.replyTo } : {}),
+            ...(inbound.segments?.length ? { segments: inbound.segments } : {}),
             metadata: inbound.metadata,
         }).catch((err) => {
             this.#logger.warn(formatCompact({
@@ -220,6 +221,7 @@ export class OneBot11WssEndpoint extends Onebot11Client {
                 }
                 try {
                     socket.close();
+                    socket.terminate?.();
                 }
                 catch {
                     /* ignore */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-onebot11",
-  "version": "1.1.21",
+  "version": "1.1.23",
   "description": "Zhin.js OneBot 11 adapter for Plugin Runtime (WebSocket client)",
   "type": "module",
   "main": "./lib/index.js",
@@ -45,19 +45,20 @@
     "@imhelper/onebot-v11": "1.0.7",
     "imhelper": "1.0.7",
     "ws": "^8.21.1",
-    "@zhin.js/adapter": "1.1.27",
-    "@zhin.js/client": "1.1.23",
-    "@zhin.js/agent-feature": "1.1.12",
+    "@zhin.js/adapter-onebot-events": "0.0.2",
+    "@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/permission": "1.1.11",
-    "@zhin.js/page": "1.1.13",
-    "@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"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
@@ -65,15 +66,15 @@
     "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"
   },
   "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": {

package/plugin.js

@@ -4,6 +4,7 @@ import { permissionHostToken, createSceneRolePlatformChecker } from '@zhin.js/pe
 import { createOnebot11ConsoleRpc } from "./lib/console.js";
 export default definePlugin({
     name: 'onebot11',
+    configUpdate: { featurePaths: [['nickname'], ['profile'], ['endpoints']] },
     metadata: {
         displayName: 'OneBot 11 Adapter',
     },

package/src/protocol.ts

@@ -5,6 +5,7 @@ import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
  * Spec: https://github.com/botuniverse/onebot-11
  */
 import { EndpointDeliveryError, isMediaRef, type MediaRef, type ConversationRef } from '@zhin.js/im-contract';
+import { toCanonicalSegments, type Segment } from '@zhin.js/core';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 
 const logger = getLogger('onebot11');
@@ -261,6 +262,7 @@ export interface OneBot11InboundFields {
   readonly endpointId: string;
   readonly mentioned: boolean;
   readonly replyTo: { readonly id: string } | undefined;
+  readonly segments?: readonly Segment[];
 }
 
 /** 构造 gateway.receive 的 metadata 与提升字段（ws / wss 两个 endpoint 共用）。 */
@@ -272,6 +274,7 @@ export function formatInboundMetadata(
   const nickname = senderNickname(ev);
   const quoteId = extractQuoteId(ev);
   const mentioned = isOneBot11BotMentioned({ selfId, message: ev.message });
+  const segments = Array.isArray(ev.message) ? toCanonicalSegments(ev.message) : undefined;
   return {
     metadata: Object.freeze({
       message_type: ev.message_type,
@@ -285,6 +288,7 @@ export function formatInboundMetadata(
     endpointId: endpoint,
     mentioned,
     replyTo: quoteId ? { id: quoteId } : undefined,
+    ...(segments?.length ? { segments } : {}),
   };
 }
 

package/src/side-event-dispatch.ts

@@ -1,4 +1,4 @@
-import { receiveOneBotLikeSideEvent } from '@zhin.js/core';
+import { receiveOneBotLikeSideEvent } from '@zhin.js/adapter-onebot-events';
 import type { EndpointEventEmitter } from 'zhin.js/adapter';
 import { formatCompact, type getAdapterLogger } from '@zhin.js/logger';
 import type { OneBot11Event } from './protocol.js';

package/src/ws-endpoint.ts

@@ -206,6 +206,7 @@ export class OneBot11WsEndpoint extends Onebot11Client implements Endpoint {
       endpointId: inbound.endpointId,
       ...(inbound.mentioned ? { mentioned: true } : {}),
       ...(inbound.replyTo ? { replyTo: inbound.replyTo } : {}),
+      ...(inbound.segments?.length ? { segments: inbound.segments } : {}),
       metadata: inbound.metadata,
     }).catch((err) => {
       this.#logger.warn(formatCompact({
@@ -251,6 +252,7 @@ export class OneBot11WsEndpoint extends Onebot11Client implements Endpoint {
         }
         try {
           ws.close();
+          ws.terminate?.();
         } catch {
           /* ignore */
         }

package/src/ws-types.ts

@@ -3,6 +3,7 @@ export interface OneBot11WsSocket {
   readonly readyState: number;
   send(data: string): void;
   close(code?: number, reason?: string): void;
+  terminate?(): void;
   ping?(): void;
   on(event: 'open' | 'message' | 'close' | 'error' | 'pong', listener: (...args: unknown[]) => void): void;
 }

package/src/wss-endpoint.ts

@@ -208,6 +208,7 @@ export class OneBot11WssEndpoint extends Onebot11Client implements Endpoint {
       endpointId: inbound.endpointId,
       ...(inbound.mentioned ? { mentioned: true } : {}),
       ...(inbound.replyTo ? { replyTo: inbound.replyTo } : {}),
+      ...(inbound.segments?.length ? { segments: inbound.segments } : {}),
       metadata: inbound.metadata,
     }).catch((err) => {
       this.#logger.warn(formatCompact({
@@ -257,6 +258,7 @@ export class OneBot11WssEndpoint extends Onebot11Client implements Endpoint {
         }
         try {
           socket.close();
+          socket.terminate?.();
         } catch {
           /* ignore */
         }