@zhin.js/adapter-icqq 1.1.17 → 1.1.19

package/lib/group-moderation.d.ts

@@ -1,5 +1,8 @@
 import type { Client } from '@icqqjs/icqq';
-import type { GroupModerationAction, GroupModerationMember } from 'zhin.js/adapter';
+import { type EndpointMemberInspectionRequest, type EndpointModerationRequest, type GroupModerationMember } from 'zhin.js/adapter';
 /** Native role/join facts stay in the adapter; the moderation plugin owns policy. */
-export declare function inspectGroupMember(client: Client, groupId: string, userId: string, signal: AbortSignal): Promise<GroupModerationMember>;
-export declare function moderateGroupMember(client: Client, groupId: string, userId: string, action: GroupModerationAction, signal: AbortSignal, isActive: () => boolean): Promise<void>;
+export declare function inspectGroupMember(client: Client, { groupId, userId, signal }: EndpointMemberInspectionRequest): Promise<GroupModerationMember>;
+export declare function moderateGroupMember({ client, isActive }: {
+    readonly client: Client;
+    readonly isActive: () => boolean;
+}, { groupId, userId, action, signal }: EndpointModerationRequest): Promise<void>;

package/lib/group-moderation.js

@@ -1,12 +1,13 @@
+import { createEndpointOperation } from 'zhin.js/adapter';
 /** Native role/join facts stay in the adapter; the moderation plugin owns policy. */
-export async function inspectGroupMember(client, groupId, userId, signal) {
-    signal.throwIfAborted();
+export async function inspectGroupMember(client, { groupId, userId, signal }) {
+    const operation = createEndpointOperation({ signal });
     const group = numericId(groupId);
     const user = numericId(userId);
-    const selfLookup = client.getGroupMemberInfo(group, client.uin, true);
+    const selfLookup = operation.run(() => client.getGroupMemberInfo(group, client.uin, true));
     const [self, member] = await Promise.all([
         selfLookup,
-        user === client.uin ? selfLookup : client.getGroupMemberInfo(group, user, true),
+        user === client.uin ? selfLookup : operation.run(() => client.getGroupMemberInfo(group, user, true)),
     ]);
     signal.throwIfAborted();
     const joinedAt = member.join_time * 1000;
@@ -22,8 +23,8 @@ export async function inspectGroupMember(client, groupId, userId, signal) {
         ...(Number.isSafeInteger(joinedAt) && joinedAt > 0 && joinedAt <= Date.now() ? { joinedAt } : {}),
     };
 }
-export async function moderateGroupMember(client, groupId, userId, action, signal, isActive) {
-    const member = await inspectGroupMember(client, groupId, userId, signal);
+export async function moderateGroupMember({ client, isActive }, { groupId, userId, action, signal }) {
+    const member = await inspectGroupMember(client, { groupId: groupId, userId: userId, signal: signal });
     signal.throwIfAborted();
     if (!isActive() || !member.canModerate)
         throw new Error('Group moderation permission is unavailable');
@@ -38,8 +39,8 @@ export async function moderateGroupMember(client, groupId, userId, action, signa
         throw new Error('Invalid group mute duration');
     }
     const ok = action.type === 'kick'
-        ? await client.setGroupKick(numericId(groupId), numericId(userId))
-        : await client.setGroupBan(numericId(groupId), numericId(userId), action.durationSeconds);
+        ? await createEndpointOperation({ signal }).run(() => client.setGroupKick(numericId(groupId), numericId(userId)))
+        : await createEndpointOperation({ signal }).run(() => client.setGroupBan(numericId(groupId), numericId(userId), action.durationSeconds));
     if (!ok)
         throw new Error('Platform did not confirm the moderation action');
 }

package/lib/group-scene.d.ts

@@ -1,11 +1,11 @@
 import type { Client } from '@icqqjs/icqq';
-import type { GroupMemberProfile, GroupSceneFacts } from 'zhin.js/adapter';
+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;
 /**
  * ADR 0041 scene facts: one uncached group-info read, plus (small groups only) one roster read for
  * admins. A roster failure leaves adminIds unknown instead of failing the other facts.
  */
-export declare function inspectGroupScene(client: Client, groupId: string, signal: AbortSignal): Promise<GroupSceneFacts>;
+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: string, userId: string, signal: AbortSignal): Promise<GroupMemberProfile>;
+export declare function inspectGroupMemberProfile(client: Client, { groupId, userId, signal }: EndpointMemberInspectionRequest): Promise<GroupMemberProfile>;

package/lib/group-scene.js

@@ -1,3 +1,4 @@
+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;
 const MAX_ADMIN_IDS = 20;
@@ -14,10 +15,10 @@ function numericId(value) {
  * ADR 0041 scene facts: one uncached group-info read, plus (small groups only) one roster read for
  * admins. A roster failure leaves adminIds unknown instead of failing the other facts.
  */
-export async function inspectGroupScene(client, groupId, signal) {
-    signal.throwIfAborted();
+export async function inspectGroupScene(client, { groupId, signal }) {
+    const operation = createEndpointOperation({ signal });
     const group = numericId(groupId);
-    const info = await client.getGroupInfo(group, true);
+    const info = await operation.run(() => client.getGroupInfo(group, true));
     signal.throwIfAborted();
     if (info.group_id !== group)
         return {};
@@ -26,7 +27,7 @@ export async function inspectGroupScene(client, groupId, signal) {
     let adminIds;
     if (memberCount === undefined || memberCount <= ADMIN_SCAN_MAX_MEMBERS) {
         try {
-            const roster = await client.getGroupMemberList(group);
+            const roster = await operation.run(() => client.getGroupMemberList(group));
             signal.throwIfAborted();
             adminIds = [...roster.values()]
                 .filter(member => member.role === 'admin' && member.group_id === group)
@@ -50,11 +51,11 @@ export async function inspectGroupScene(client, groupId, signal) {
     };
 }
 /** ADR 0041 member facts from one uncached lookup (same rationale as the agent `freshMember` helper). */
-export async function inspectGroupMemberProfile(client, groupId, userId, signal) {
-    signal.throwIfAborted();
+export async function inspectGroupMemberProfile(client, { groupId, userId, signal }) {
+    const operation = createEndpointOperation({ signal });
     const group = numericId(groupId);
     const user = numericId(userId);
-    const member = await client.getGroupMemberInfo(group, user, true);
+    const member = await operation.run(() => client.getGroupMemberInfo(group, user, true));
     signal.throwIfAborted();
     if (member.user_id !== user || member.group_id !== group)
         return {};

package/lib/icqq-login-assist.d.ts

@@ -1,5 +1,5 @@
 import type { Locale } from 'zhin.js/i18n';
-import type { LoginAssist, LoginAssistType } from '@zhin.js/core';
+import type { LoginAssist, LoginAssistEndpointIdentity, LoginAssistType } from '@zhin.js/core';
 type IcqqLoginClient = {
     login(password?: string): Promise<unknown>;
     submitSlider(ticket: string): Promise<unknown>;
@@ -21,6 +21,8 @@ export declare function runIcqqLoginAssistStep(input: {
     adapter: string;
     endpointKey: string;
     owner: object;
+    signal?: AbortSignal;
+    endpointIdentity?: LoginAssistEndpointIdentity;
     logger: Logger;
     step: LoginAssistType;
     event: unknown;

package/lib/icqq-login-assist.js

@@ -17,6 +17,7 @@ export async function runIcqqLoginAssistStep(input) {
         ...(typeof payload.url === 'string' ? { url: payload.url } : {}),
     }));
     try {
+        input.signal?.throwIfAborted();
         if (step === 'device') {
             try {
                 await client.sendSmsCode();
@@ -29,7 +30,8 @@ export async function runIcqqLoginAssistStep(input) {
                 }));
             }
         }
-        const value = await assist.waitForInput(adapter, endpointKey, step, payload, { owner });
+        const value = await assist.waitForInput(adapter, endpointKey, step, payload, { owner, signal: input.signal, endpointIdentity: input.endpointIdentity });
+        input.signal?.throwIfAborted();
         const text = normalizeSubmitValue(value);
         switch (step) {
             case 'qrcode':

package/lib/icqq-login-control.d.ts

@@ -0,0 +1,24 @@
+import type { FeatureId, PluginId } from 'zhin.js';
+import type { PendingLoginTask } from '@zhin.js/core';
+export interface IcqqLoginControlState {
+    readonly endpointId: string;
+    readonly transportState: string;
+    readonly online: boolean;
+    readonly pending: readonly PendingLoginTask[];
+}
+export interface IcqqLoginControl {
+    readonly endpointId: string;
+    state(): IcqqLoginControlState;
+    pending(): readonly PendingLoginTask[];
+    /** Force a login attempt; rejects when the endpoint is stopped or the SDK login fails. */
+    relogin(): Promise<void>;
+    submit(taskId: string, value: string | Record<string, unknown>): boolean;
+    cancel(taskId: string, reason?: string): boolean;
+}
+/** Read the owning Adapter's actual incarnations; this projection retains no independent directory. */
+export declare function icqqLoginControls(context: Readonly<{
+    owner: PluginId | Readonly<{
+        id: PluginId;
+    }>;
+    project<T>(id: FeatureId): T;
+}>): ReadonlyMap<string, IcqqLoginControl>;

package/lib/icqq-login-control.js

@@ -0,0 +1,25 @@
+/**
+ * ICQQ login control surface exposed to the Plugin Runtime, Console and the
+ * recovery command. Controls are projected from actual current incarnations in
+ * the owning IcqqAdapter; no plugin resource keeps a second Endpoint directory.
+ */
+import { adapterFeatureId, isAdapterIndex } from 'zhin.js/adapter';
+import { IcqqAdapter } from './adapter.js';
+/** Read the owning Adapter's actual incarnations; this projection retains no independent directory. */
+export function icqqLoginControls(context) {
+    const index = context.project(adapterFeatureId);
+    if (!isAdapterIndex(index))
+        throw new Error('ICQQ Adapter projection is unavailable');
+    const owner = typeof context.owner === 'string' ? context.owner : context.owner.id;
+    const controls = new Map();
+    for (const adapter of index.forOwner(owner).adapters()) {
+        if (!(adapter instanceof IcqqAdapter))
+            continue;
+        for (const row of adapter.list()) {
+            const endpoint = adapter.getEndpoint(row.instanceId);
+            if (endpoint)
+                controls.set(row.endpointId, endpoint.loginControl);
+        }
+    }
+    return controls;
+}

package/lib/index.d.ts

@@ -1,5 +1,6 @@
-export { Actions, formatInboundContent, formatOutboundBody, formatOutboundMessages, icqqInboundConversation, icqqOutboundTarget, type ActionResult, type IcqqEndpointConfig, type IcqqInboundMessage, type IcqqWireSegment, type ParsedIcqqSendTarget, type ResolvedIcqqConfig, } from './protocol.js';
+export { Actions, formatInboundContent, formatOutboundBody, formatOutboundMessages, formatOutboundMessageParts, icqqInboundConversation, icqqOutboundTarget, type ActionResult, type IcqqEndpointConfig, type IcqqInboundMessage, type IcqqWireSegment, type IcqqOutboundMessagePart, type ParsedIcqqSendTarget, type ResolvedIcqqConfig, } from './protocol.js';
 export { IcqqEndpoint, type IcqqEndpointOptions, } from './endpoint.js';
 export * from './types.js';
-export { icqqClient, type IcqqClient, type IcqqClientEventMap, } from './client.js';
+export { type IcqqClient, type IcqqClientEventMap, } from './client.js';
 export { resolveIcqqInboundMessageId, } from './icqq-inbound.js';
+export { IcqqAdapter } from './adapter.js';

package/lib/index.js

@@ -1,5 +1,5 @@
-export { Actions, formatInboundContent, formatOutboundBody, formatOutboundMessages, icqqInboundConversation, icqqOutboundTarget, } from './protocol.js';
+export { Actions, formatInboundContent, formatOutboundBody, formatOutboundMessages, formatOutboundMessageParts, icqqInboundConversation, icqqOutboundTarget, } from './protocol.js';
 export { IcqqEndpoint, } from './endpoint.js';
 export * from './types.js';
-export { icqqClient, } from './client.js';
 export { resolveIcqqInboundMessageId, } from './icqq-inbound.js';
+export { IcqqAdapter } from './adapter.js';

package/lib/protocol.d.ts

@@ -1,5 +1,6 @@
 import type { Sendable } from '@icqqjs/icqq';
 import { type ConversationRef } from '@zhin.js/im-contract';
+import { type AdapterNotifyTarget, type ResolvedAdapterNotifyTarget } from 'zhin.js/adapter';
 import type { MessageSegment, SendContent } from "zhin.js";
 export type ActionResult = {
     id: string;
@@ -177,6 +178,8 @@ export interface IcqqEndpointConfig {
     readonly autoServer?: boolean;
     readonly qqnt?: boolean;
     readonly ntLogin?: boolean;
+    /** Optional out-of-band outage notification target (usually a QQ adapter instance). */
+    readonly notify?: AdapterNotifyTarget;
 }
 export interface ResolvedIcqqConfig {
     readonly context: 'icqq';
@@ -194,6 +197,7 @@ export interface ResolvedIcqqConfig {
     readonly autoServer?: boolean;
     readonly qqnt?: boolean;
     readonly ntLogin?: boolean;
+    readonly notify?: ResolvedAdapterNotifyTarget;
 }
 export interface IcqqWireSegment {
     readonly type: string;
@@ -201,6 +205,9 @@ export interface IcqqWireSegment {
     readonly platform?: Readonly<Record<string, unknown>>;
 }
 export interface IcqqInboundMessage {
+    /** Exact SDK callback object, operation-local and never a persisted projection. */
+    readonly event?: unknown;
+    readonly platformSentAt?: number;
     readonly id: string;
     readonly conversation: ConversationRef;
     readonly content: string;
@@ -269,4 +276,10 @@ export declare function formatOutboundBody(payload: unknown): Sendable;
  * quote or whitespace are dropped: a standalone element cannot carry the quote.
  */
 export declare function formatOutboundMessages(payload: unknown): Sendable[];
+/** Native bubble and the exact source segment positions which produced it. */
+export interface IcqqOutboundMessagePart {
+    readonly message: Sendable;
+    readonly sourceIndices?: readonly number[];
+}
+export declare function formatOutboundMessageParts(payload: unknown): IcqqOutboundMessagePart[];
 export declare function formatInboundContent(rawMessage: string): string;

package/lib/protocol.js

@@ -1,4 +1,5 @@
 import { isMediaRef } from '@zhin.js/im-contract';
+import { resolveAdapterNotifyTarget } from 'zhin.js/adapter';
 import { resolveIcqqMediaFile } from "./cq-message.js";
 export { resolveIcqqInboundMessageId } from "./icqq-inbound.js";
 /**
@@ -190,6 +191,7 @@ export function resolveIcqqConfig(config) {
     const autoServer = config.autoServer ?? true;
     const qqnt = config.qqnt;
     const ntLogin = config.ntLogin;
+    const notify = resolveAdapterNotifyTarget(config.notify);
     return {
         context: 'icqq',
         id,
@@ -206,6 +208,7 @@ export function resolveIcqqConfig(config) {
         ...(autoServer != null ? { autoServer } : {}),
         ...(qqnt != null ? { qqnt } : {}),
         ...(ntLogin != null ? { ntLogin } : {}),
+        ...(notify ? { notify } : {}),
     };
 }
 /**
@@ -326,22 +329,34 @@ export function formatOutboundBody(payload) {
  * quote or whitespace are dropped: a standalone element cannot carry the quote.
  */
 export function formatOutboundMessages(payload) {
+    return formatOutboundMessageParts(payload).map(part => part.message);
+}
+export function formatOutboundMessageParts(payload) {
     if (!Array.isArray(payload)) {
-        return isWireSegment(payload) ? formatOutboundMessages([payload]) : [formatOutboundBody(payload)];
+        if (isWireSegment(payload))
+            return formatOutboundMessageParts([payload]);
+        const message = formatOutboundBody(payload);
+        return [{ message, ...(typeof payload === 'string' && message !== payload ? {} : { sourceIndices: [0] }) }];
     }
     const groups = [[]];
-    for (const element of formatOutboundElements(payload)) {
-        if (isStandaloneElement(element))
-            groups.push([element], []);
-        else
-            groups.at(-1).push(element);
+    for (const [sourceIndex, source] of payload.entries()) {
+        for (const element of formatOutboundElements([source])) {
+            const item = { element, sourceIndex };
+            if (isStandaloneElement(element))
+                groups.push([item], []);
+            else
+                groups.at(-1).push(item);
+        }
     }
-    const messages = groups.filter(group => group.some(element => typeof element === 'string'
+    const messages = groups.filter(group => group.some(({ element }) => typeof element === 'string'
         ? element.trim() !== ''
         : element.type !== 'reply' && element.type !== 'quote'));
     if (messages.length === 0)
-        return ['\u200b'];
-    return messages.map(group => group.length === 1 ? group[0] : group);
+        return [{ message: '\u200b', sourceIndices: [] }];
+    return messages.map(group => ({
+        message: group.length === 1 ? group[0].element : group.map(item => item.element),
+        sourceIndices: [...new Set(group.map(item => item.sourceIndex))],
+    }));
 }
 function isStandaloneElement(element) {
     return typeof element !== 'string' && ICQQ_STANDALONE_ELEMENTS.has(element.type);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-icqq",
-  "version": "1.1.17",
+  "version": "1.1.19",
   "description": "Zhin.js ICQQ adapter — direct connection to @icqqjs/icqq",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,24 +33,27 @@
     "directory": "plugins/adapters/icqq"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.24",
-    "@zhin.js/agent-feature": "1.1.10",
-    "@zhin.js/core": "1.1.52",
-    "@zhin.js/feature-kit": "1.1.9",
-    "@zhin.js/im-contract": "1.1.8",
+    "@zhin.js/adapter": "1.1.26",
+    "@zhin.js/agent-feature": "1.1.11",
+    "@zhin.js/client": "1.1.22",
+    "@zhin.js/console-contract": "1.1.3",
+    "@zhin.js/core": "1.1.54",
+    "@zhin.js/feature-kit": "1.1.10",
+    "@zhin.js/im-contract": "1.1.9",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/permission": "1.1.9",
-    "@zhin.js/skill": "1.1.10",
-    "@zhin.js/tool": "1.1.11"
+    "@zhin.js/page": "1.1.11",
+    "@zhin.js/permission": "1.1.10",
+    "@zhin.js/skill": "1.1.11",
+    "@zhin.js/tool": "1.1.13"
   },
   "peerDependencies": {
     "@icqqjs/icqq": "^1.12.2",
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.24",
-    "@zhin.js/command": "^1.1.11",
-    "@zhin.js/core": "^1.1.52",
-    "@zhin.js/prompt-section": "^1.1.9",
-    "zhin.js": "^1.1.17"
+    "@zhin.js/adapter": "^1.1.26",
+    "@zhin.js/command": "^1.1.12",
+    "@zhin.js/core": "^1.1.54",
+    "@zhin.js/prompt-section": "^1.1.10",
+    "zhin.js": "^1.1.19"
   },
   "peerDependenciesMeta": {
     "@icqqjs/icqq": {
@@ -75,12 +78,13 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/prompt-section": "1.1.9",
-    "zhin.js": "1.1.17"
+    "@zhin.js/prompt-section": "1.1.10",
+    "zhin.js": "1.1.19"
   },
   "files": [
     "adapters",
     "commands",
+    "pages",
     "plugin.js",
     "schema.json",
     "src",
@@ -107,7 +111,7 @@
     "features": [
       {
         "package": "@zhin.js/adapter",
-        "api": "^1.0.0"
+        "api": "^2.0.0"
       },
       {
         "package": "@zhin.js/command",
@@ -124,6 +128,10 @@
       {
         "package": "@zhin.js/agent-feature",
         "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/page",
+        "api": "^1.0.0"
       }
     ],
     "plugins": []

package/pages/index/index.js

@@ -0,0 +1,15 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePage } from '@zhin.js/console-contract';
+import { createAdapterConsolePage } from '@zhin.js/client';
+export const meta = definePage({
+    title: 'ICQQ',
+    titleI18n: { en: 'ICQQ' },
+    icon: 'MessageCircle',
+    order: 64,
+    requiredPermissions: ['icqq:read'],
+});
+/**
+ * Convention page: `pages/index/index.ts` → `/icqq`（插件路径）。
+ * 连接状态、连接测试、endpoint 增删；登录待办来自 LoginAssist（ICQQ 等）。
+ */
+export default createAdapterConsolePage('icqq');

package/pages/index/index.ts

@@ -0,0 +1,16 @@
+import { definePage } from '@zhin.js/console-contract';
+import { createAdapterConsolePage } from '@zhin.js/client';
+
+export const meta = definePage({
+  title: 'ICQQ',
+  titleI18n: { en: 'ICQQ' },
+  icon: 'MessageCircle',
+  order: 64,
+  requiredPermissions: ['icqq:read'],
+});
+
+/**
+ * Convention page: `pages/index/index.ts` → `/icqq`（插件路径）。
+ * 连接状态、连接测试、endpoint 增删；登录待办来自 LoginAssist（ICQQ 等）。
+ */
+export default createAdapterConsolePage('icqq');

package/plugin.js

@@ -1,16 +1,14 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { createEndpointRuntimeState } from 'zhin.js/adapter';
-import { definePlugin } from 'zhin.js';
+import { definePlugin, pluginConsoleRpcToken } from 'zhin.js';
 import { permissionHostToken, createSceneRolePlatformChecker } from '@zhin.js/permission';
-import { icqqRuntimeStateToken } from "./lib/icqq-runtime-state.js";
+import { createIcqqConsoleRpc } from "./lib/console.js";
 export default definePlugin({
     name: 'icqq',
     metadata: {
         displayName: 'ICQQ Adapter',
     },
     setup(context) {
-        // 运行中 endpoint 注册表（icqq endpoint list 的"运行中"数据源）
-        context.resources.provide(icqqRuntimeStateToken, createEndpointRuntimeState());
+        context.resources.provide(pluginConsoleRpcToken, createIcqqConsoleRpc(() => context.config.get()));
         const disposePlatform = context.resources.has(permissionHostToken)
             ? context.resources.use(permissionHostToken).registerPlatform('icqq', createSceneRolePlatformChecker())
             : undefined;

package/schema.json

@@ -346,6 +346,93 @@
                 "description": "Command prefix for this endpoint."
               }
             }
+          },
+          "notify": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "掉线/登录失败时通过另一个适配器实例给 master 发通知（adapter/endpoint/kind/id 指向实际会话）",
+            "x-i18n": {
+              "en": {
+                "description": "Send outage/login notices to the master through another adapter instance (adapter/endpoint/kind/id identify the actual conversation)."
+              }
+            },
+            "properties": {
+              "adapter": {
+                "type": "string",
+                "description": "通知使用的适配器类型，如 qq / icqq",
+                "x-i18n": {
+                  "en": {
+                    "description": "Adapter type used for the notice, such as qq or icqq."
+                  }
+                }
+              },
+              "endpoint": {
+                "type": "string",
+                "description": "该适配器的 endpoint id",
+                "x-i18n": {
+                  "en": {
+                    "description": "Endpoint id of that adapter."
+                  }
+                }
+              },
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "private",
+                  "group",
+                  "channel"
+                ],
+                "default": "private",
+                "description": "会话类型，默认 private",
+                "x-i18n": {
+                  "en": {
+                    "description": "Conversation kind; defaults to private."
+                  }
+                }
+              },
+              "id": {
+                "type": [
+                  "string",
+                  "number"
+                ],
+                "description": "master 在该平台上的会话 id（QQ 官方为 openid，ICQQ 为 QQ 号）",
+                "x-i18n": {
+                  "en": {
+                    "description": "Master conversation id on that platform (openid for QQ official, QQ number for ICQQ)."
+                  }
+                }
+              },
+              "parent": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "private",
+                      "group",
+                      "channel"
+                    ]
+                  },
+                  "id": {
+                    "type": [
+                      "string",
+                      "number"
+                    ]
+                  }
+                },
+                "required": [
+                  "kind",
+                  "id"
+                ],
+                "description": "可选的父频道/群容器"
+              }
+            },
+            "required": [
+              "adapter",
+              "endpoint",
+              "id"
+            ]
           }
         },
         "required": [
@@ -367,6 +454,93 @@
           "description": "Command prefix, empty by default. Each endpoints[i] can override it."
         }
       }
+    },
+    "notify": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "掉线/登录失败时通过另一个适配器实例给 master 发通知（adapter/endpoint/kind/id 指向实际会话）",
+      "x-i18n": {
+        "en": {
+          "description": "Send outage/login notices to the master through another adapter instance (adapter/endpoint/kind/id identify the actual conversation)."
+        }
+      },
+      "properties": {
+        "adapter": {
+          "type": "string",
+          "description": "通知使用的适配器类型，如 qq / icqq",
+          "x-i18n": {
+            "en": {
+              "description": "Adapter type used for the notice, such as qq or icqq."
+            }
+          }
+        },
+        "endpoint": {
+          "type": "string",
+          "description": "该适配器的 endpoint id",
+          "x-i18n": {
+            "en": {
+              "description": "Endpoint id of that adapter."
+            }
+          }
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "private",
+            "group",
+            "channel"
+          ],
+          "default": "private",
+          "description": "会话类型，默认 private",
+          "x-i18n": {
+            "en": {
+              "description": "Conversation kind; defaults to private."
+            }
+          }
+        },
+        "id": {
+          "type": [
+            "string",
+            "number"
+          ],
+          "description": "master 在该平台上的会话 id（QQ 官方为 openid，ICQQ 为 QQ 号）",
+          "x-i18n": {
+            "en": {
+              "description": "Master conversation id on that platform (openid for QQ official, QQ number for ICQQ)."
+            }
+          }
+        },
+        "parent": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "private",
+                "group",
+                "channel"
+              ]
+            },
+            "id": {
+              "type": [
+                "string",
+                "number"
+              ]
+            }
+          },
+          "required": [
+            "kind",
+            "id"
+          ],
+          "description": "可选的父频道/群容器"
+        }
+      },
+      "required": [
+        "adapter",
+        "endpoint",
+        "id"
+      ]
     }
   },
   "required": [