@zhin.js/adapter-icqq 1.1.26 → 1.1.27

package/lib/endpoint.js

@@ -16,7 +16,7 @@ import { formatInboundContent, formatOutboundMessageParts, normalizeIcqqImageMed
 import { ManagedIcqqClient } from './managed-client.js';
 import { createIcqqActionPorts } from './group-actions.js';
 import { inspectGroupMember, moderateGroupMember } from './group-moderation.js';
-import { inspectGroupMemberProfile, inspectGroupScene } from './group-scene.js';
+import { inspectGroupMemberProfile, inspectGroupScene, inspectSelfStanding } from './group-scene.js';
 import { createIcqqSelfProfile } from './self-profile.js';
 const BOUND_EVENTS = [
     'message.private',
@@ -69,6 +69,7 @@ export class IcqqEndpoint extends ManagedIcqqClient {
         inspectGroupMember: request => inspectGroupMember(this, request),
         inspectGroupScene: request => inspectGroupScene(this, request),
         inspectGroupMemberProfile: request => inspectGroupMemberProfile(this, request),
+        inspectSelfStanding: request => inspectSelfStanding(this, request),
         moderateGroupMember: request => moderateGroupMember({ client: this, isActive: () => this.#open && !this.#retiring && !this.#stopped }, request),
         listFriends: async (request = {}) => createEndpointOperation(request).run(() => Array.from(this.fl.values()).map((f) => ({
             user_id: f.user_id,
@@ -977,7 +978,7 @@ export class IcqqEndpoint extends ManagedIcqqClient {
             sender: {
                 id: normalized.userId,
                 name: normalized.nickname || undefined,
-                ...(normalized.senderRole ? { roles: [normalized.senderRole] } : {}),
+                ...(normalized.senderRole ? { platform: { standing: normalized.senderRole } } : {}),
             },
             channelType: normalized.channelType,
             ...(quoteId ? { replyTo: { id: quoteId } } : {}),

package/lib/group-scene.d.ts

@@ -1,4 +1,5 @@
 import type { Client } from '@icqqjs/icqq';
+import { type PlatformStanding, type SelfStandingRequest } from '@zhin.js/im-contract';
 import { type EndpointGroupInspectionRequest, type EndpointMemberInspectionRequest, type GroupMemberProfile, type GroupSceneFacts } from 'zhin.js/adapter';
 /** Listing a very large roster only to find admins is not worth the packet; adminIds stay unknown. */
 export declare const ADMIN_SCAN_MAX_MEMBERS = 1000;
@@ -9,3 +10,5 @@ export declare const ADMIN_SCAN_MAX_MEMBERS = 1000;
 export declare function inspectGroupScene(client: Client, { groupId, signal }: EndpointGroupInspectionRequest): Promise<GroupSceneFacts>;
 /** ADR 0041 member facts from one uncached lookup (same rationale as the agent `freshMember` helper). */
 export declare function inspectGroupMemberProfile(client: Client, { groupId, userId, signal }: EndpointMemberInspectionRequest): Promise<GroupMemberProfile>;
+/** ADR 0056 §1: the Bot's own standing in a group (`scene.selfStanding`); undefined outside groups. */
+export declare function inspectSelfStanding(client: Client, { conversation, signal }: SelfStandingRequest): Promise<PlatformStanding | undefined>;

package/lib/group-scene.js

@@ -1,3 +1,4 @@
+import { standingFromMemberRole } from '@zhin.js/im-contract';
 import { createEndpointOperation } from 'zhin.js/adapter';
 /** Listing a very large roster only to find admins is not worth the packet; adminIds stay unknown. */
 export const ADMIN_SCAN_MAX_MEMBERS = 1000;
@@ -70,3 +71,13 @@ export async function inspectGroupMemberProfile(client, { groupId, userId, signa
             ? { mutedUntil: shutupSeconds * 1000 > Date.now() ? shutupSeconds * 1000 : 0 } : {}),
     };
 }
+/** ADR 0056 §1: the Bot's own standing in a group (`scene.selfStanding`); undefined outside groups. */
+export async function inspectSelfStanding(client, { conversation, signal }) {
+    if (conversation.kind !== 'group')
+        return undefined;
+    const self = client.uin;
+    if (!self)
+        return undefined;
+    const profile = await inspectGroupMemberProfile(client, { groupId: conversation.id, userId: String(self), signal });
+    return standingFromMemberRole(profile.platformRole);
+}

package/lib/protocol.d.ts

@@ -1,6 +1,6 @@
 import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 import type { Sendable } from '@icqqjs/icqq';
-import { type ConversationRef } from '@zhin.js/im-contract';
+import { type ConversationRef, type PlatformStanding } from '@zhin.js/im-contract';
 import { type AdapterNotifyTarget, type ResolvedAdapterNotifyTarget } from 'zhin.js/adapter';
 import type { MessageSegment, SendContent } from "zhin.js";
 export type ActionResult = {
@@ -217,9 +217,11 @@ export interface IcqqInboundMessage {
      * 与 content（CQ 原文纯文本视图）同源，随 gateway.receive 上送。
      */
     readonly segments?: readonly MessageSegment[];
+    /** `platform`: ADR 0056 §1 normalized standing (group messages only). */
     readonly sender: {
         readonly id: string;
         readonly name?: string;
+        readonly platform?: PlatformStanding;
     };
     readonly channelType: 'private' | 'group' | 'channel';
     readonly metadata?: Record<string, unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-icqq",
-  "version": "1.1.26",
+  "version": "1.1.27",
   "description": "Zhin.js ICQQ adapter — direct connection to @icqqjs/icqq",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,28 +33,28 @@
     "directory": "plugins/adapters/icqq"
   },
   "dependencies": {
-    "@zhin.js/adapter-onebot-events": "0.0.5",
-    "@zhin.js/adapter": "1.1.32",
-    "@zhin.js/agent-feature": "1.1.16",
-    "@zhin.js/console-contract": "1.1.5",
-    "@zhin.js/core": "1.1.60",
-    "@zhin.js/feature-kit": "1.1.15",
-    "@zhin.js/im-contract": "1.1.13",
-    "@zhin.js/logger": "1.1.2",
-    "@zhin.js/page": "1.1.17",
-    "@zhin.js/permission": "1.1.15",
-    "@zhin.js/skill": "1.1.16",
-    "@zhin.js/tool": "1.1.18"
+    "zod": "^4.6.7",
+    "@zhin.js/adapter": "1.1.33",
+    "@zhin.js/adapter-onebot-events": "0.0.6",
+    "@zhin.js/agent-feature": "1.1.17",
+    "@zhin.js/console-contract": "1.1.6",
+    "@zhin.js/core": "1.2.0",
+    "@zhin.js/feature-kit": "1.1.16",
+    "@zhin.js/im-contract": "1.1.14",
+    "@zhin.js/logger": "1.1.3",
+    "@zhin.js/page": "1.1.18",
+    "@zhin.js/permission": "1.2.0",
+    "@zhin.js/skill": "1.1.17",
+    "@zhin.js/tool": "1.1.19"
   },
   "peerDependencies": {
     "@icqqjs/icqq": "^1.12.2",
-    "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.32",
-    "@zhin.js/agent": "^1.1.51",
-    "@zhin.js/command": "^1.1.17",
-    "@zhin.js/core": "^1.1.60",
-    "@zhin.js/prompt-section": "^1.1.15",
-    "zhin.js": "^1.1.25"
+    "@zhin.js/adapter": "^1.1.33",
+    "@zhin.js/agent": "^1.2.0",
+    "@zhin.js/command": "^1.2.0",
+    "@zhin.js/core": "^1.2.0",
+    "@zhin.js/prompt-section": "^1.1.16",
+    "zhin.js": "^1.1.26"
   },
   "peerDependenciesMeta": {
     "@icqqjs/icqq": {
@@ -71,9 +71,6 @@
     },
     "zhin.js": {
       "optional": true
-    },
-    "zod": {
-      "optional": true
     }
   },
   "devDependencies": {
@@ -81,10 +78,9 @@
     "@types/node": "^26.1.2",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.51",
-    "@zhin.js/prompt-section": "1.1.15",
-    "zhin.js": "1.1.25"
+    "@zhin.js/agent": "1.2.0",
+    "@zhin.js/prompt-section": "1.1.16",
+    "zhin.js": "1.1.26"
   },
   "files": [
     "adapters",
@@ -137,6 +133,11 @@
       {
         "package": "@zhin.js/page",
         "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/prompt-section",
+        "api": "^1.0.0",
+        "optional": true
       }
     ],
     "plugins": []
@@ -144,7 +145,7 @@
   "scripts": {
     "build": "tsc",
     "clean": "rimraf lib",
-    "test": "pnpm run test:types && NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/adapters/icqq/tests",
+    "test": "pnpm run test:types && vitest run --root ../../.. plugins/adapters/icqq/tests",
     "test:types": "tsc -p tsconfig.type-tests.json"
   }
 }

package/plugin.js

@@ -1,6 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { definePlugin } from 'zhin.js';
-import { permissionHostToken, createSceneRolePlatformChecker } from '@zhin.js/permission';
 import { registerSensitiveExecCommand } from '@zhin.js/agent';
 import { createIcqqConsoleRpc } from "./lib/console.js";
 import { icqqSensitiveExecRule } from "./lib/sensitive-commands.js";
@@ -11,15 +10,11 @@ export default definePlugin({
         displayName: 'ICQQ Adapter',
     },
     setup(context) {
-        const disposePlatform = context.resources.has(permissionHostToken)
-            ? context.resources.use(permissionHostToken).registerPlatform('icqq', createSceneRolePlatformChecker())
-            : undefined;
         const disposeExecRule = registerSensitiveExecCommand(icqqSensitiveExecRule);
         return {
             consoleRpc: createIcqqConsoleRpc(() => context.config.get()),
             dispose: () => {
                 disposeExecRule();
-                disposePlatform?.();
             },
         };
     },

package/schema.json

@@ -3,33 +3,6 @@
   "type": "object",
   "additionalProperties": false,
   "properties": {
-    "master": {
-      "type": [
-        "string",
-        "number"
-      ],
-      "description": "框架 master QQ uin（/approve、AI/工具权限）；endpoints[i].master 可逐项覆盖",
-      "x-i18n": {
-        "en": {
-          "description": "Framework master QQ uin list for approval and AI/tool permissions. endpoints[i].master can override this value."
-        }
-      }
-    },
-    "trusted": {
-      "type": "array",
-      "items": {
-        "type": [
-          "string",
-          "number"
-        ]
-      },
-      "description": "框架 trusted QQ uin 列表（弱于 master）",
-      "x-i18n": {
-        "en": {
-          "description": "Framework trusted QQ uin list, below master authority."
-        }
-      }
-    },
     "password": {
       "type": "string",
       "description": "QQ 密码（可选，不填则扫码登录）",
@@ -181,33 +154,6 @@
             "pattern": "^[0-9]+$",
             "description": "QQ uin"
           },
-          "master": {
-            "type": [
-              "string",
-              "number"
-            ],
-            "description": "本 endpoint 的 master QQ uin；覆盖顶层 master",
-            "x-i18n": {
-              "en": {
-                "description": "Master QQ uin list for this endpoint, overriding the top-level master list."
-              }
-            }
-          },
-          "trusted": {
-            "type": "array",
-            "items": {
-              "type": [
-                "string",
-                "number"
-              ]
-            },
-            "description": "本 endpoint 的 trusted 列表",
-            "x-i18n": {
-              "en": {
-                "description": "Trusted users for this endpoint."
-              }
-            }
-          },
           "password": {
             "type": "string",
             "description": "本 endpoint 的 QQ 密码",
@@ -586,7 +532,6 @@
     }
   },
   "required": [
-    "master",
     "endpoints"
   ],
   "$defs": {

package/src/endpoint.ts

@@ -80,7 +80,7 @@ import type { SystemMessage as IcqqSystemMessage } from './types.js';
 import { ManagedIcqqClient, type IcqqBackgroundOperation } from './managed-client.js';
 import { createIcqqActionPorts } from './group-actions.js';
 import { inspectGroupMember, moderateGroupMember } from './group-moderation.js';
-import { inspectGroupMemberProfile, inspectGroupScene } from './group-scene.js';
+import { inspectGroupMemberProfile, inspectGroupScene, inspectSelfStanding } from './group-scene.js';
 import { createIcqqSelfProfile } from './self-profile.js';
 
 export interface IcqqEndpointOptions {
@@ -147,6 +147,7 @@ export class IcqqEndpoint extends ManagedIcqqClient implements Endpoint {
     inspectGroupMember: request => inspectGroupMember(this, request),
     inspectGroupScene: request => inspectGroupScene(this, request),
     inspectGroupMemberProfile: request => inspectGroupMemberProfile(this, request),
+    inspectSelfStanding: request => inspectSelfStanding(this, request),
     moderateGroupMember: request => moderateGroupMember({ client: this, isActive: () => this.#open && !this.#retiring && !this.#stopped }, request),
     listFriends: async (request: EndpointManagementRequest = {}) =>
       createEndpointOperation(request).run(() => Array.from(this.fl.values()).map((f) => ({
@@ -1054,7 +1055,7 @@ export class IcqqEndpoint extends ManagedIcqqClient implements Endpoint {
       sender: {
         id: normalized.userId,
         name: normalized.nickname || undefined,
-        ...(normalized.senderRole ? { roles: [normalized.senderRole] } : {}),
+        ...(normalized.senderRole ? { platform: { standing: normalized.senderRole } } : {}),
       },
       channelType: normalized.channelType,
       ...(quoteId ? { replyTo: { id: quoteId } } : {}),

package/src/group-scene.ts

@@ -1,4 +1,5 @@
 import type { Client } from '@icqqjs/icqq';
+import { standingFromMemberRole, type PlatformStanding, type SelfStandingRequest } from '@zhin.js/im-contract';
 import { createEndpointOperation, type EndpointGroupInspectionRequest, type EndpointMemberInspectionRequest, type GroupMemberProfile, type GroupSceneFacts } from 'zhin.js/adapter';
 
 /** Listing a very large roster only to find admins is not worth the packet; adminIds stay unknown. */
@@ -74,3 +75,14 @@ export async function inspectGroupMemberProfile(
       ? { mutedUntil: shutupSeconds * 1000 > Date.now() ? shutupSeconds * 1000 : 0 } : {}),
   };
 }
+
+/** ADR 0056 §1: the Bot's own standing in a group (`scene.selfStanding`); undefined outside groups. */
+export async function inspectSelfStanding(
+  client: Client, { conversation, signal }: SelfStandingRequest,
+): Promise<PlatformStanding | undefined> {
+  if (conversation.kind !== 'group') return undefined;
+  const self = client.uin;
+  if (!self) return undefined;
+  const profile = await inspectGroupMemberProfile(client, { groupId: conversation.id, userId: String(self), signal });
+  return standingFromMemberRole(profile.platformRole);
+}

package/src/protocol.ts

@@ -1,6 +1,6 @@
 import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 import type { MessageElem, Sendable, ShareElem } from '@icqqjs/icqq';
-import { isMediaRef, type ConversationRef } from '@zhin.js/im-contract';
+import { isMediaRef, type ConversationRef, type PlatformStanding } from '@zhin.js/im-contract';
 import { resolveAdapterNotifyTarget, type AdapterNotifyTarget, type ResolvedAdapterNotifyTarget } from 'zhin.js/adapter';
 import type { MessageSegment, SendContent } from "zhin.js";
 import { resolveIcqqMediaFile } from "./cq-message.js";
@@ -289,7 +289,8 @@ export interface IcqqInboundMessage {
    * 与 content（CQ 原文纯文本视图）同源，随 gateway.receive 上送。
    */
   readonly segments?: readonly MessageSegment[];
-  readonly sender: { readonly id: string; readonly name?: string };
+  /** `platform`: ADR 0056 §1 normalized standing (group messages only). */
+  readonly sender: { readonly id: string; readonly name?: string; readonly platform?: PlatformStanding };
   readonly channelType: 'private' | 'group' | 'channel';
   readonly metadata?: Record<string, unknown>;
   readonly replyTo?: { readonly id: string };