@zhin.js/adapter-icqq 8.0.9 → 8.0.11

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @zhin.js/adapter-icqq
 
+## 8.0.11
+
+### Patch Changes
+
+- eb84b77: fix: 更新文档,建立正确的依赖关系
+- Updated dependencies [d3920e9]
+  - @zhin.js/core@1.5.10
+  - zhin.js@6.0.10
+  - @zhin.js/adapter@1.1.10
+  - @zhin.js/tool@1.0.11
+  - @zhin.js/agent@1.1.11
+
+## 8.0.10
+
+### Patch Changes
+
+- e4757a8: fix: bump
+- c3c0ebf: fix: jiagouyouhau
+- Updated dependencies [e4757a8]
+- Updated dependencies [c3c0ebf]
+  - @zhin.js/command@1.0.13
+  - @zhin.js/agent@1.1.10
+  - @zhin.js/core@1.5.9
+  - @zhin.js/tool@1.0.10
+  - @zhin.js/adapter@1.1.9
+  - zhin.js@6.0.9
+
 ## 8.0.9
 
 ### Patch Changes

package/README.md

@@ -1,22 +1,37 @@
 # @zhin.js/adapter-icqq
 
-ICQQ Plugin Runtime 适配器 — 通过 [@icqqjs/cli](https://github.com/icqqjs/cli) 守护进程 IPC 连接已登录 QQ 账号（无 `httpHostToken`）。
+ICQQ Plugin Runtime 适配器 — 进程内直接使用 [@icqqjs/icqq](https://github.com/icqqjs/icqq) `Client`
 
 ## 功能特性
 
 - 群聊 / 私聊 / 群临时会话 / QQ 频道消息
-- 入站：`messageGatewayToken`（IPC 事件订阅），归一为 `gateway.receive({ conversation, message, content, ... })`
-- 出站：`send({ conversation, payload })` → `send_group_msg` / `send_private_msg` / …（conversation kind/id/parent 路由）
-- Agent 工具：`agent/tools/`（戳一戳、群管、好友列表等）保留
-- Console Endpoint 管理：`src/endpoint.ts` 显式实现 `EndpointManagement`（好友/群/群成员列表、请求审批、删好友、踢人、禁言、设管理），Console 使用 `endpoint.friends` / `endpoint.groups` / `endpoint.group_members` 等规范 RPC
+- 入站：`messageGatewayToken`，归一为 `gateway.receive({ conversation, message, content, ... })`
+- 出站：`send({ conversation, payload })` → `sendGroupMsg` / `sendPrivateMsg` / …（conversation kind/id/parent 路由）
+- 群聊 reaction：`control.addReaction` / `removeReaction`（协议 ACK 失败不阻塞后续发送）
+- Agent 工具：包根 `tools/`（`@zhin.js/tool` Feature；模型侧名为 `icqq__send_user_like` 等）
+- Console Endpoint 管理：`src/endpoint.ts` 显式实现 `EndpointManagement`（好友/群/群成员列表、请求审批、删好友、踢人、禁言、设管理）
 
 ## 安装
 
 ```bash
-pnpm add @zhin.js/adapter-icqq
-pnpm add -g @icqqjs/cli   # 或 npx icqq login
+pnpm add @zhin.js/adapter-icqq @icqqjs/icqq
+# 可选：未配置 signApiAddr 时走本地签名
+pnpm add @icqqjs/qqsign
 ```
 
+`@icqqjs/icqq` 是适配器的**可选对等依赖**（`peerDependencies` + `optional`）。应用侧需自行安装；monorepo 内另在 `devDependencies` 声明以便构建/测试。
+
+`@icqqjs/*` 发布在 GitHub Packages，需：
+
+```ini
+@icqqjs:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${NPM_TOKEN}
+```
+
+并设置具有 `read:packages` 权限的 `NPM_TOKEN`（CI 使用仓库 secret `PERSONAL_TOKEN`）。
+
+签名：未配置 `signApiAddr` 时，若已安装 `@icqqjs/qqsign` 则自动走本地签名。
+
 ## 配置（Plugin Runtime）
 
 ```yaml
@@ -25,29 +40,22 @@ plugins:
     master: "1659488338"        # 必填，顶层共享（/approve 与 master 角色）
     autoReconnect: true
     endpoints:
-      - name: "${ICQQ_ACCOUNT}"   # QQ 号，须与 icqq login 一致
-      # rpc 为 endpoint 级字段：
-      # - name: "${ICQQ_ACCOUNT_2}"
-      #   rpc:
-      #     host: 10.0.0.2
-      #     port: 9527
-      #     token: ${ICQQ_RPC_TOKEN}
+      - id: "${ICQQ_ACCOUNT}"   # QQ 号
+        # password: "${ICQQ_PASSWORD}"  # 可选；不填则扫码登录
 ```
 
-多账号：一个插件实例挂多个 endpoint（`endpoints` 数组逐项覆盖顶层字段，`name` 必填）：
+多账号：一个插件实例挂多个 endpoint（`endpoints` 数组逐项覆盖顶层字段，`id` 必填）：
 
 ```yaml
 plugins:
   icqq:
-    master: "1659488338"      # 顶层字段所有 endpoint 共享
+    master: "1659488338"
     endpoints:
-      - name: "${ICQQ_ACCOUNT}"
-      - name: "${ICQQ_ACCOUNT_2}"
-      - name: "${ICQQ_ACCOUNT_3}"   # 各账号须分别 icqq login
+      - id: "${ICQQ_ACCOUNT}"
+      - id: "${ICQQ_ACCOUNT_2}"
+      - id: "${ICQQ_ACCOUNT_3}"
 ```
 
-先执行 `icqq login`，再启动 Zhin。
-
 ## Send conversation
 
 | 类型 | conversation |
@@ -60,17 +68,17 @@ plugins:
 ## 架构
 
 - `plugin.ts` + `adapters/icqq.ts`（`defineAdapter`）
+- Endpoint：`src/endpoint.ts`（继承 icqq `Client`，`start()` 内 `login()`）
 - 协议常量 / 配置：`src/protocol.ts`
-- IPC 客户端：`src/ipc-client.ts`（无 host-http）
-- Console loginAssist / host-router 延期
-- 旧 `usePlugin` / `extends Adapter` / Endpoint 生产入口已删除
+- Agent 工具：`tools/*.ts`；权限说明见 `agent/PERMITS.md`
 
 ## Plugin Runtime 迁移说明
 
-- `autoReconnect` 已恢复实现：IPC/RPC 意外断开后按指数退避自动重连（`stop()` 为主动断开，不触发重连）。
-- `outboundMedia: file | base64` 已恢复实现：`file` 模式把 segment base64 落盘为临时文件后发 `[image:path]`；`base64` 模式（配置 `rpc` 时默认）发 `[image:base64://...]` 由守护进程解码。
-- **Console 社交/群管 RPC 已接线**：endpoint 在 Adapter 内把 ICQQ 的 `get_friend_list` / `get_group_list` / `get_group_member_list`、请求审批和群管操作归一化为冻结的 `EndpointManagement` 对象。Host 只消费该语义端口，不再探测方法别名或读取 `friends` / `groups` SDK 缓存。
-- **notice / request 入站事件已移除**：Plugin Runtime 的 `MessageGateway` 仅有 message 通道，没有 `notice.receive` / `request.receive` 事件机制，旧 `icqq-side-events.ts` / `get-msg.ts` / `login-ipc-contract.ts` / `agent-prompt.ts` 随之删除。需要好友/入群请求处理能力时请等待 runtime 提供事件通道后再恢复。
+- 不再经过 `@icqqjs/cli` IPC 守护进程；登录态与协议栈都在本进程。
+- `autoReconnect`：Client 断线后按配置自动重连（`stop()` 为主动断开，不触发重连）。
+- `outboundMedia: file | base64`：`file` 把 segment base64 落盘后发本地路径；`base64` 发 CQ `base64://` 内联。
+- **Console 社交/群管 RPC 已接线**：endpoint 把好友/群/群成员列表、请求审批和群管操作归一化为冻结的 `EndpointManagement`。Host 只消费该语义端口。
+- 好友/入群请求与通知写入 unified inbox（有 DatabaseHost 时），不再走已删除的 `notice.receive` / `request.receive` 事件。
 
 ## License
 

package/adapters/icqq.js

@@ -2,36 +2,31 @@
 /**
  * Convention entry: discover `adapters/icqq.ts` → defineAdapter.
  */
-import { defineAdapter } from '@zhin.js/adapter';
+import { defineAdapter } from 'zhin.js/adapter';
 import { messageGatewayToken } from '@zhin.js/core/runtime';
 import { formatCompact, getLogger } from '@zhin.js/logger';
-import { databaseHostToken, INBOX_TABLE_NOTICE, INBOX_TABLE_REQUEST, runtimeEventPublisherToken, } from '@zhin.js/plugin-runtime';
-import { IcqqIpcEndpoint } from "../lib/endpoint.js";
+import { databaseHostToken, INBOX_TABLE_NOTICE, INBOX_TABLE_REQUEST, runtimeEventPublisherToken, } from 'zhin.js';
+import { IcqqEndpoint } from "../lib/endpoint.js";
 import { icqqRuntimeStateToken } from "../lib/icqq-runtime-state.js";
 import { resolveIcqqConfig, } from "../lib/protocol.js";
-export { IcqqIpcEndpoint } from "../lib/endpoint.js";
+export { IcqqEndpoint } from "../lib/endpoint.js";
 const logger = getLogger('icqq');
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
     operations: ['recall', 'reaction'],
-    // 统一消息元素通道（UNI-Channel）：端点可消费 base64（CQ base64:// 守护进程解码）
-    // / url（CQ 直发）/ path（同机守护进程读盘；file 模式出站物化产物）媒体；
-    // 卡片/按钮等富交互段无原生承载，降级纯文本。
     segments: {
         outboundMedia: ['base64', 'url', 'path'],
         interactive: 'text',
     },
     create(context) {
-        // Client-library / IPC daemon path — no httpHostToken.
-        // Console loginAssist + host-router routes deferred.
         const config = resolveIcqqConfig(context.config);
         // 注册到插件运行时状态（icqq.endpoint list 的"运行中"数据源）
         context.use(icqqRuntimeStateToken).endpoints.set(config.id, {
             id: config.id,
-            mode: config.rpc ? 'rpc' : 'ipc',
+            mode: 'direct',
         });
         const inbox = resolveInboxHooks(context);
-        return new IcqqIpcEndpoint({
+        return new IcqqEndpoint({
             id: context.id,
             gateway: context.use(messageGatewayToken),
             config,

package/adapters/icqq.ts

@@ -1,7 +1,7 @@
 /**
  * Convention entry: discover `adapters/icqq.ts` → defineAdapter.
  */
-import { defineAdapter, type AdapterContext } from '@zhin.js/adapter';
+import { defineAdapter, type AdapterContext } from 'zhin.js/adapter';
 import { messageGatewayToken } from '@zhin.js/core/runtime';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 import {
@@ -10,44 +10,35 @@ import {
   INBOX_TABLE_REQUEST,
   runtimeEventPublisherToken,
   type Token,
-} from '@zhin.js/plugin-runtime';
-import { IcqqIpcEndpoint, type IcqqInboxHooks } from '../src/endpoint.js';
+} from 'zhin.js';
+import { IcqqEndpoint, type IcqqInboxHooks } from '../src/endpoint.js';
 import { icqqRuntimeStateToken } from '../src/icqq-runtime-state.js';
 import {
   resolveIcqqConfig,
   type IcqqAdapterConfig,
 } from '../src/protocol.js';
 
-export { IcqqIpcEndpoint } from '../src/endpoint.js';
-export type {
-  CreateIcqqIpc,
-  IcqqEndpointOptions,
-  IcqqIpcTransport,
-} from '../src/endpoint.js';
+export { IcqqEndpoint } from '../src/endpoint.js';
+export type { IcqqEndpointOptions } from '../src/endpoint.js';
 
 const logger = getLogger('icqq');
 
 export default defineAdapter<IcqqAdapterConfig>({
   capabilities: ['inbound', 'outbound'],
   operations: ['recall', 'reaction'],
-  // 统一消息元素通道（UNI-Channel）：端点可消费 base64（CQ base64:// 守护进程解码）
-  // / url（CQ 直发）/ path（同机守护进程读盘；file 模式出站物化产物）媒体；
-  // 卡片/按钮等富交互段无原生承载，降级纯文本。
   segments: {
     outboundMedia: ['base64', 'url', 'path'],
     interactive: 'text',
   },
   create(context) {
-    // Client-library / IPC daemon path — no httpHostToken.
-    // Console loginAssist + host-router routes deferred.
     const config = resolveIcqqConfig(context.config);
     // 注册到插件运行时状态（icqq.endpoint list 的"运行中"数据源）
     context.use(icqqRuntimeStateToken).endpoints.set(config.id, {
       id: config.id,
-      mode: config.rpc ? 'rpc' : 'ipc',
+      mode: 'direct',
     });
     const inbox = resolveInboxHooks(context);
-    return new IcqqIpcEndpoint({
+    return new IcqqEndpoint({
       id: context.id,
       gateway: context.use(messageGatewayToken),
       config,

package/agent/PERMITS.md

@@ -6,6 +6,8 @@
 
 ## Permit 词汇表
 
+平台范围用工具的 `platforms: ['icqq']`，不要写非法的 `platform(icqq)`（缺 perm 时 PermissionHost 会直接拒绝，工具对模型不可见）。
+
 | `platform(icqq,…)` | 含义 |
 |--------------------|------|
 | `scene_owner` | 群主 |

package/lib/agent-prompt.js

@@ -2,7 +2,7 @@ import { filterTools } from 'zhin.js/ai';
 function isIcqqDelegatedTask(query, goal) {
     const text = `${query} ${goal}`;
     const lower = text.toLowerCase();
-    if (/\bicqq\b|mcp_icqq|send_private_msg|friend\s+send/i.test(text))
+    if (/\bicqq\b|icqq__|send_private_msg|friend\s+send/i.test(text))
         return true;
     if (/\bfriend\s+like\b/.test(lower) && /qq|好友|\d{5,}/i.test(text))
         return true;
@@ -13,27 +13,22 @@ function isIcqqDelegatedTask(query, goal) {
     return false;
 }
 function selectIcqqDeferredTools(query, goal, deferredCatalog, maxTools) {
-    const pool = deferredCatalog.filter(t => !t.name.startsWith('mcp_filesystem') && !t.name.startsWith('mcp_memory_'));
-    const icqqMcpTools = pool.filter(t => t.name.startsWith('mcp_icqq_'));
-    const icqqTools = pool.filter(t => t.name.startsWith('icqq_'));
+    const pool = deferredCatalog.filter(t => !t.name.startsWith('mcp_filesystem')
+        && !t.name.startsWith('mcp_memory_')
+        && !t.name.startsWith('mcp_icqq_'));
+    const icqqTools = pool.filter(t => t.name.startsWith('icqq__') || t.name.startsWith('icqq_'));
     const pinned = [];
-    const bash = pool.find(t => t.name === 'bash');
-    if (bash)
-        pinned.push(bash);
     const preferOrder = [
-        'mcp_icqq_icqq_invoke',
-        'mcp_icqq_icqq_list_actions',
-        'icqq_send_user_like',
-        'icqq_friend_list',
-        'icqq_poke',
+        'icqq__send_user_like',
+        'icqq__friend_list',
+        'icqq__poke',
     ];
     for (const name of preferOrder) {
-        const t = icqqMcpTools.find(x => x.name === name) ??
-            icqqTools.find(x => x.name === name);
+        const t = icqqTools.find(x => x.name === name);
         if (t)
             pinned.push(t);
     }
-    for (const t of [...icqqMcpTools, ...icqqTools]) {
+    for (const t of icqqTools) {
         if (pinned.length >= maxTools)
             break;
         if (!pinned.some(p => p.name === t.name))
@@ -51,15 +46,15 @@ function selectIcqqDeferredTools(query, goal, deferredCatalog, maxTools) {
     return merged.slice(0, maxTools);
 }
 const ORCHESTRATOR_ICQQ = [
-    'On icqq/QQ: use run_deferred_task with tool_query "mcp_icqq_icqq_invoke" or "icqq_send_user_like".',
-    'Examples: send_private_msg, friend_like; do not use mcp_filesystem_* for QQ tasks.',
-    'Skip tool_search when the user clearly asks to send a message, like a friend, or poke on QQ.',
+    'On icqq/QQ: if icqq__send_user_like is in your tool list, call it now with { endpoint_id, user_id, times }.',
+    'endpoint_id is this bot QQ (Session endpoint). user_id is the sender to like. times is 1-20.',
+    'Do not tell the user the tool is missing until you have called it this turn (or load_tool("icqq__send_user_like") failed).',
+    'Ignore prior turns that said the like tool was unavailable. Other social tools: icqq__poke, icqq__friend_list.',
 ].join('\n');
 const WORKER_ICQQ = [
-    'Send private message: `mcp_icqq_icqq_invoke` action `send_private_msg` params `{ user_id, message }`, or bash `icqq friend send <uid> "<text>"`.',
-    'Friend like: action `friend_like` or `icqq_send_user_like`, or bash `icqq friend like <uid> -t <times>`.',
-    'Use `icqq_list_actions` only if action name is unclear.',
-    'Do NOT use mcp_filesystem_* or explore node_modules / package.json to "discover" icqq.',
+    'Friend like: load_tool("icqq__send_user_like") then call with { endpoint_id, user_id, times }. endpoint_id is this bot QQ (origin.endpoint).',
+    'Poke: icqq__poke. Friend list: icqq__friend_list.',
+    'Do NOT use mcp_icqq_*, mcp_filesystem_*, or bash `icqq friend like`.',
     'Do not stop at --help; execute the action the goal describes.',
 ].map(line => `- ${line}`).join('\n');
 export function createIcqqAgentPromptContributor() {

package/lib/cq-message.d.ts

@@ -17,6 +17,6 @@ export declare function icqqMediaRefFromString(value: string): MediaRef;
  */
 export declare function resolveCqMediaArg(type: string, data: Record<string, unknown> | undefined): string | undefined;
 export declare function parseCqMessage(raw: string): MessageSegment[];
-/** 构建 icqq IPC send_*_msg 的 message 字符串（非空） */
-export declare function buildIcqqIpcMessage(content: SendContent): string;
+/** 构建 icqq send_*_msg 的 message 字符串（非空） */
+export declare function buildIcqqMessage(content: SendContent): string;
 export declare function toCqString(content: SendContent): string;

package/lib/cq-message.js

@@ -118,8 +118,8 @@ export function parseCqMessage(raw) {
     }
     return segments.length ? segments : [{ type: "text", data: { text: raw } }];
 }
-/** 构建 icqq IPC send_*_msg 的 message 字符串（非空） */
-export function buildIcqqIpcMessage(content) {
+/** 构建 icqq send_*_msg 的 message 字符串（非空） */
+export function buildIcqqMessage(content) {
     let message = toCqString(content).trim();
     if (!message)
         message = "\u200b";

package/lib/endpoint.d.ts

@@ -1,25 +1,8 @@
-/**
- * IcqqIpcEndpoint — lifecycle, outbound, IPC subscribe/admit for ICQQ daemon.
- */
-import type { EndpointControl, EndpointInstance, EndpointManagement, EndpointSendRequest } from '@zhin.js/adapter';
+import { Client } from '@icqqjs/icqq';
+import type { EndpointControl, EndpointInstance, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
 import type { MessageGateway } from '@zhin.js/core/runtime';
-import type { CapabilityId } from '@zhin.js/plugin-runtime';
-import { type IcqqInboundMessage, type IpcEvent, type IpcResponse, type ResolvedIcqqConfig } from './protocol.js';
-import type { IpcFriendInfo, IpcGroupInfo, IpcMemberInfo } from './types.js';
-/** Minimal IPC surface used by the endpoint (real IpcClient or test mock). */
-export interface IcqqIpcTransport {
-    request(action: string, params?: Record<string, unknown>): Promise<IpcResponse>;
-    subscribe(action: string, params: Record<string, unknown>, handler: (event: IpcEvent) => void): {
-        unsubscribe: () => Promise<void>;
-    };
-    setOnRemoteDisconnect(handler: (() => void) | null): void;
-    close(): void;
-}
-export type CreateIcqqIpc = (config: ResolvedIcqqConfig) => Promise<IcqqIpcTransport>;
-/**
- * 收件箱写/推钩子（由装配层注入，见 adapters/icqq.ts）。
- * record* 写 unified_inbox_request/notice；publish 向 console hub 推送实时事件。
- */
+import type { CapabilityId } from 'zhin.js';
+import { type IcqqInboundMessage, type ResolvedIcqqConfig } from './protocol.js';
 export interface IcqqInboxHooks {
     recordRequest(row: Record<string, unknown>): void | Promise<void>;
     recordNotice(row: Record<string, unknown>): void | Promise<void>;
@@ -29,71 +12,18 @@ export interface IcqqEndpointOptions {
     readonly id: CapabilityId;
     readonly gateway: MessageGateway;
     readonly config: ResolvedIcqqConfig;
-    readonly createIpc?: CreateIcqqIpc;
-    /** 未注入时 request/notice 事件仅按非消息载荷忽略（不报错）。 */
     readonly inbox?: IcqqInboxHooks;
 }
-export declare class IcqqIpcEndpoint implements EndpointInstance {
+export declare class IcqqEndpoint extends Client implements EndpointInstance {
     #private;
-    readonly name: string;
-    /** Populated after start(); agent tools read this. */
-    ipc: IcqqIpcTransport;
-    readonly friends: Map<number, IpcFriendInfo>;
-    readonly groups: Map<number, IpcGroupInfo>;
+    readonly endpointName: string;
     readonly management: EndpointManagement;
     readonly control: EndpointControl;
     constructor(options: IcqqEndpointOptions);
-    request(action: string, params?: Record<string, unknown>): Promise<IpcResponse>;
     start(): Promise<void>;
     open(): void;
     close(): void;
     stop(): Promise<void>;
     send({ conversation, payload }: EndpointSendRequest): Promise<string>;
-    private static readonly EMOJI_MAP;
-    private getEmojiId;
-    /** Activity-feedback / OutboundHost reaction surface. */
-    addReaction(messageId: string, emoji: string): Promise<string | null>;
-    removeReaction(messageId: string, reactionId: string): Promise<void>;
-    /** Activity-feedback autoRemove / Console recall. */
-    recallMessage(messageId: string): Promise<void>;
-    /** EndpointManagement.listFriends —— 好友列表（LIST_FRIENDS，归一为 {user_id, nickname, remark}）。 */
-    getFriendList(): Promise<Array<{
-        user_id: number;
-        nickname: string;
-        remark: string;
-    }>>;
-    /** EndpointManagement.listGroups —— 群列表（LIST_GROUPS，归一为 {group_id, name}）。 */
-    getGroupList(): Promise<Array<{
-        group_id: number;
-        name: string;
-    }>>;
-    /** EndpointManagement.listGroupMembers —— 群成员列表（字段对齐 daemon 返回）。 */
-    getGroupMemberList(groupId: number | string): Promise<IpcMemberInfo[]>;
-    /** getGroupMemberList 别名（console 探测 listMembers / getMemberList）。 */
-    listMembers(groupId: number | string): Promise<IpcMemberInfo[]>;
-    getMemberList(groupId: number | string): Promise<IpcMemberInfo[]>;
-    /**
-     * EndpointManagement.resolveRequest —— id 为 inbox 行的 platform_request_id。
-     * 先 GET_SYSTEM_MSG 按 flag（回退 seq）定位请求，再按类型路由 handle_friend/group_request。
-     */
-    approveRequest(id: string, remark?: string): Promise<void>;
-    rejectRequest(id: string, reason?: string): Promise<void>;
-    /** EndpointManagement.deleteFriend —— FRIEND_DELETE。 */
-    deleteFriend(userId: number | string): Promise<void>;
-    /** deleteFriend 别名（console 探测 delete_friend）。 */
-    delete_friend(userId: number | string): Promise<void>;
-    /** EndpointManagement.kickGroupMember —— GROUP_KICK。 */
-    removeMember(groupId: number | string, userId: number | string): Promise<void>;
-    kickMember(groupId: number | string, userId: number | string): Promise<void>;
-    setGroupKick(groupId: number | string, userId: number | string): Promise<void>;
-    /** EndpointManagement.muteGroupMember —— GROUP_MUTE（duration 秒，默认 600）。 */
-    muteMember(groupId: number | string, userId: number | string, duration?: number): Promise<void>;
-    banMember(groupId: number | string, userId: number | string, duration?: number): Promise<void>;
-    setGroupMute(groupId: number | string, userId: number | string, duration?: number): Promise<void>;
-    /** EndpointManagement.setGroupAdmin —— SET_GROUP_ADMIN（enable 默认 true）。 */
-    setModerator(groupId: number | string, userId: number | string, enable?: boolean): Promise<void>;
-    setAdmin(groupId: number | string, userId: number | string, enable?: boolean): Promise<void>;
-    setGroupAdmin(groupId: number | string, userId: number | string, enable?: boolean): Promise<void>;
-    /** Test / internal: admit when open. */
     admit(msg: IcqqInboundMessage): void;
 }