@zhin.js/adapter-icqq 1.1.0 → 1.1.2

package/{tools/list_muted.js → agents/icqq/skills/icqq-group-state/tools/list_muted/index.js}

@@ -7,7 +7,8 @@ export default defineAgentTool({
         group_id: z.number().describe('目标群号'),
     }),
     adapter: 'icqq',
-    permissions: ['role(master,admin)'],
+    scopes: ['group'],
+    requiresApproval: 'never',
     async execute({ group_id }, context) {
         const members = await context.$client.getGroupMemberList(group_id);
         const now = Math.floor(Date.now() / 1000);

package/{tools/list_muted.ts → agents/icqq/skills/icqq-group-state/tools/list_muted/index.ts}

@@ -6,7 +6,8 @@ export default defineAgentTool<{ group_id: number }>({
     group_id: z.number().describe('目标群号'),
   }),
   adapter: 'icqq',
-  permissions: ['role(master,admin)'],
+  scopes:['group'],
+  requiresApproval: 'never',
   async execute({ group_id }, context) {
     const members = await context.$client.getGroupMemberList(group_id);
     const now = Math.floor(Date.now() / 1000);

package/agents/icqq/skills/icqq-interaction/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: icqq-interaction
+platforms:
+  - icqq
+description: ICQQ 点赞、戳一戳和群签到互动能力。
+keywords:
+  - "icqq"
+  - "点赞"
+  - "戳一戳"
+  - "签到"
+tools:
+  - "poke"
+  - "send_user_like"
+  - "group_sign"
+---
+
+# icqq-interaction
+
+用于低风险社交互动。确认目标用户或群后再调用，并遵守各 Tool 的审批策略。

package/{tools/group_sign.js → agents/icqq/skills/icqq-interaction/tools/group_sign/index.js}

@@ -7,7 +7,8 @@ export default defineAgentTool({
         group_id: z.number().describe('目标群号'),
     }),
     adapter: 'icqq',
-    approval: 'never',
+    scopes: ['group'],
+    requiresApproval: 'never',
     async execute({ group_id }, context) {
         const client = context.$client;
         const groupInfo = client.pickGroup(group_id);

package/{tools/group_sign.ts → agents/icqq/skills/icqq-interaction/tools/group_sign/index.ts}

@@ -6,7 +6,8 @@ export default defineAgentTool<{ group_id: number }>({
     group_id: z.number().describe('目标群号'),
   }),
   adapter: 'icqq',
-  approval: 'never',
+  scopes:['group'],
+  requiresApproval: 'never',
   async execute({ group_id }, context) {
     const client = context.$client;
     const groupInfo= client.pickGroup(group_id);

package/{tools/poke.js → agents/icqq/skills/icqq-interaction/tools/poke/index.js}

@@ -8,7 +8,8 @@ export default defineAgentTool({
         user_id: z.number().describe('要戳的目标成员 QQ号'),
     }),
     adapter: 'icqq',
-    approval: 'never',
+    scopes: ['group'],
+    requiresApproval: 'never',
     async execute({ group_id, user_id }, context) {
         await context.$client.sendGroupPoke(group_id, user_id);
         return { success: true, message: `已戳了戳 ${user_id}` };

package/{tools/poke.ts → agents/icqq/skills/icqq-interaction/tools/poke/index.ts}

@@ -7,7 +7,8 @@ export default defineAgentTool<{ group_id: number; user_id: number }>({
     user_id: z.number().describe('要戳的目标成员 QQ号'),
   }),
   adapter: 'icqq',
-  approval: 'never',
+  scopes:['group'],
+  requiresApproval: 'never',
   async execute({ group_id, user_id }, context) {
     await context.$client.sendGroupPoke(group_id, user_id);
     return { success: true, message: `已戳了戳 ${user_id}` };

package/{tools/send_user_like.js → agents/icqq/skills/icqq-interaction/tools/send_user_like/index.js}

@@ -7,13 +7,14 @@ export default defineAgentTool({
         user_id: z.number().describe('要点赞的目标用户 QQ号'),
     }),
     adapter: 'icqq',
-    approval: 'never',
+    requiresApproval: 'never',
     async execute({ user_id }, context) {
         const successArray = [];
         await Promise.all([20, 20, 10].map(async (times) => {
             try {
-                await context.$client.sendLike(user_id, times);
-                successArray.push(times);
+                const isSuccess = await context.$client.sendLike(user_id, times);
+                if (isSuccess)
+                    successArray.push(times);
             }
             catch { /* ignore */ }
         }));

package/{tools/send_user_like.ts → agents/icqq/skills/icqq-interaction/tools/send_user_like/index.ts}

@@ -6,13 +6,13 @@ export default defineAgentTool<{ user_id: number }>({
     user_id: z.number().describe('要点赞的目标用户 QQ号'),
   }),
   adapter: 'icqq',
-  approval: 'never',
+  requiresApproval: 'never',
   async execute({ user_id }, context) {
     const successArray: number[] = [];
     await Promise.all([20, 20, 10].map(async (times) => {
       try {
-        await context.$client.sendLike(user_id, times);
-        successArray.push(times);
+        const isSuccess= await context.$client.sendLike(user_id, times);
+        if (isSuccess) successArray.push(times);
       } catch { /* ignore */ }
     }));
     const successTimes = successArray.reduce((a, b) => a + b, 0);

package/agents/icqq/system.md

@@ -0,0 +1,3 @@
+# ICQQ Platform Agent
+
+You are the icqq platform specialist. Interpret requests in the current icqq conversation and load only the narrowest private Skill needed for the task.

package/commands/{endpoint/add/[[id]].js → icqq/endpoint/add/[[id]]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { icqqEndpointCommands } from "../../../lib/icqq-endpoint-commands.js";
+import { icqqEndpointCommands } from '../../definition.js';
 export default icqqEndpointCommands.add;

package/commands/icqq/endpoint/add/[[id]]/index.ts

@@ -0,0 +1,3 @@
+import { icqqEndpointCommands } from '../../definition.js';
+
+export default icqqEndpointCommands.add;

package/{lib/icqq-endpoint-commands.js → commands/icqq/endpoint/definition.js}

@@ -1,21 +1,26 @@
-import { addEndpointToConfig, createEndpointCommands } from 'zhin.js/adapter';
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { createEndpointCommands, endpointConfigurationStoreToken } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { icqqRuntimeStateToken } from './icqq-runtime-state.js';
+import { icqqRuntimeStateToken } from "../../../lib/icqq-runtime-state.js";
 export const icqqEndpointCommands = createEndpointCommands({
     adapterKey: 'icqq',
     adapterDisplayName: 'ICQQ',
     running: (use) => use(icqqRuntimeStateToken).endpoints.values(),
     describeEntry: () => 'direct（直连 @icqqjs/icqq）',
     addDescription: '登记 ICQQ endpoint（重启 zhin 生效）',
-    bindFlow: ({ id }) => {
+    bindFlow: async ({ id, use }) => {
         if (!id) {
-            return '用法：icqq.endpoint add <uin>（uin 为纯数字 QQ 号）';
+            return '用法：icqq endpoint add <uin>（uin 为纯数字 QQ 号）';
         }
         if (!/^\d+$/.test(id)) {
             return 'icqq endpoint 名必须是纯数字 QQ 号（uin）';
         }
         try {
-            const filePath = addEndpointToConfig('icqq', { id });
+            const { filePath } = await use(endpointConfigurationStoreToken).add({
+                adapterKey: 'icqq',
+                entry: { id },
+                environment: {},
+            });
             return (`✅ endpoint「${id}」已追加到 ${filePath} 的 plugins.icqq.endpoints。\n` +
                 `重启 zhin 后生效。`);
         }

package/{src/icqq-endpoint-commands.ts → commands/icqq/endpoint/definition.ts}

@@ -1,6 +1,6 @@
-import { addEndpointToConfig, createEndpointCommands } from 'zhin.js/adapter';
+import { createEndpointCommands, endpointConfigurationStoreToken } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { icqqRuntimeStateToken } from './icqq-runtime-state.js';
+import { icqqRuntimeStateToken } from '../../../src/icqq-runtime-state.js';
 
 export const icqqEndpointCommands = createEndpointCommands({
   adapterKey: 'icqq',
@@ -8,15 +8,19 @@ export const icqqEndpointCommands = createEndpointCommands({
   running: (use) => use(icqqRuntimeStateToken).endpoints.values(),
   describeEntry: () => 'direct（直连 @icqqjs/icqq）',
   addDescription: '登记 ICQQ endpoint（重启 zhin 生效）',
-  bindFlow: ({ id }) => {
+  bindFlow: async ({ id, use }) => {
     if (!id) {
-      return '用法：icqq.endpoint add <uin>（uin 为纯数字 QQ 号）';
+      return '用法：icqq endpoint add <uin>（uin 为纯数字 QQ 号）';
     }
     if (!/^\d+$/.test(id)) {
       return 'icqq endpoint 名必须是纯数字 QQ 号（uin）';
     }
     try {
-      const filePath = addEndpointToConfig('icqq', { id });
+      const { filePath } = await use(endpointConfigurationStoreToken).add({
+        adapterKey: 'icqq',
+        entry: { id },
+        environment: {},
+      });
       return (
         `✅ endpoint「${id}」已追加到 ${filePath} 的 plugins.icqq.endpoints。\n` +
         `重启 zhin 后生效。`

package/commands/{endpoint/list.js → icqq/endpoint/list/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { icqqEndpointCommands } from "../../lib/icqq-endpoint-commands.js";
+import { icqqEndpointCommands } from '../definition.js';
 export default icqqEndpointCommands.list;

package/commands/icqq/endpoint/list/index.ts

@@ -0,0 +1,3 @@
+import { icqqEndpointCommands } from '../definition.js';
+
+export default icqqEndpointCommands.list;

package/commands/{endpoint/remove/[id].js → icqq/endpoint/remove/[id]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { icqqEndpointCommands } from "../../../lib/icqq-endpoint-commands.js";
+import { icqqEndpointCommands } from '../../definition.js';
 export default icqqEndpointCommands.remove;

package/commands/icqq/endpoint/remove/[id]/index.ts

@@ -0,0 +1,3 @@
+import { icqqEndpointCommands } from '../../definition.js';
+
+export default icqqEndpointCommands.remove;

package/lib/content-resolver.d.ts

@@ -0,0 +1,10 @@
+import type { Client } from '@icqqjs/icqq';
+import type { EndpointContentPort } from 'zhin.js/adapter';
+import type { ConversationMessage } from '@zhin.js/im-contract';
+/** Owns ICQQ-observed message content and recursive merged-forward expansion. */
+export declare class IcqqContentResolver {
+    #private;
+    readonly port: EndpointContentPort;
+    constructor(client: Client);
+    remember(messageId: string, message: ConversationMessage): void;
+}

package/lib/content-resolver.js

@@ -0,0 +1,98 @@
+import { normalizeForwardMsgResponse } from './forward-msg.js';
+/** Owns ICQQ-observed message content and recursive merged-forward expansion. */
+export class IcqqContentResolver {
+    #client;
+    #messages = new Map();
+    port = Object.freeze({
+        resolve: (reference, context) => this.#resolve(reference, context),
+    });
+    constructor(client) {
+        this.#client = client;
+    }
+    remember(messageId, message) {
+        this.#messages.set(messageId, message);
+    }
+    async #resolve(reference, context) {
+        context.signal.throwIfAborted();
+        if (reference.kind === 'message') {
+            const cached = this.#messages.get(reference.message.id);
+            return cached
+                ? Object.freeze({ status: 'resolved', reference, value: cached })
+                : Object.freeze({ status: 'not_found', code: 'icqq_message_not_observed' });
+        }
+        if (reference.kind === 'forward') {
+            try {
+                const entries = await this.#resolveForwardEntries(reference.forwardId, context, { remainingEntries: context.maxEntries, path: new Set() }, 0);
+                if (entries.length === 0) {
+                    return Object.freeze({ status: 'not_found', code: 'icqq_forward_not_found' });
+                }
+                return Object.freeze({
+                    status: 'resolved',
+                    reference,
+                    value: Object.freeze(entries),
+                });
+            }
+            catch (error) {
+                if (context.signal.aborted)
+                    throw error;
+                return Object.freeze({
+                    status: 'failed',
+                    code: 'icqq_forward_fetch_failed',
+                    message: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        if (reference.media.kind === 'url'
+            || reference.media.kind === 'base64'
+            || reference.media.kind === 'path') {
+            return Object.freeze({ status: 'resolved', reference, value: reference.media });
+        }
+        return Object.freeze({
+            status: 'unsupported',
+            code: 'icqq_media_reference_unsupported',
+        });
+    }
+    async #resolveForwardEntries(forwardId, context, state, depth) {
+        context.signal.throwIfAborted();
+        if (state.remainingEntries <= 0 || state.path.has(forwardId))
+            return Object.freeze([]);
+        state.path.add(forwardId);
+        try {
+            // ICQQ has no cancellable getForwardMsg API. Keep the generation lease
+            // until the native operation settles, then honor cancellation.
+            const raw = await this.#client.getForwardMsg(forwardId);
+            context.signal.throwIfAborted();
+            const entries = normalizeForwardMsgResponse(raw).slice(0, state.remainingEntries);
+            state.remainingEntries -= entries.length;
+            const expanded = [];
+            for (const entry of entries) {
+                context.signal.throwIfAborted();
+                const segments = [];
+                for (const segment of entry.segments) {
+                    if (segment.type !== 'forward' || depth >= context.maxDepth) {
+                        segments.push(segment);
+                        continue;
+                    }
+                    const nestedId = String(segment.data.forward_id ?? '').trim();
+                    if (!nestedId || state.path.has(nestedId) || state.remainingEntries <= 0) {
+                        segments.push(segment);
+                        continue;
+                    }
+                    const nested = await this.#resolveForwardEntries(nestedId, context, state, depth + 1);
+                    segments.push(Object.freeze({
+                        ...segment,
+                        data: Object.freeze({
+                            ...segment.data,
+                            ...(nested.length > 0 ? { entries: nested } : {}),
+                        }),
+                    }));
+                }
+                expanded.push(Object.freeze({ ...entry, segments: Object.freeze(segments) }));
+            }
+            return Object.freeze(expanded);
+        }
+        finally {
+            state.path.delete(forwardId);
+        }
+    }
+}

package/lib/cq-message.d.ts

@@ -1,5 +1,5 @@
 /** ICQQ 历史文本视图 → canonical MessageSegment。出站只使用原生 Sendable。 */
-import { type MediaRef } from "@zhin.js/core";
+import { type MediaRef } from '@zhin.js/im-contract';
 import type { MessageSegment } from "zhin.js";
 /**
  * CQ 媒体参数 / 入站元素媒体值 → canonical MediaRef：

package/lib/cq-message.js

@@ -1,5 +1,5 @@
 /** ICQQ 历史文本视图 → canonical MessageSegment。出站只使用原生 Sendable。 */
-import { isMediaRef } from "@zhin.js/core";
+import { isMediaRef } from '@zhin.js/im-contract';
 const MAX_CQ_PARSE_LEN = 256_000;
 /**
  * CQ 媒体参数 / 入站元素媒体值 → canonical MediaRef：

package/lib/endpoint.d.ts

@@ -1,6 +1,5 @@
 import { Client } from '@icqqjs/icqq';
-import { Endpoint } from 'zhin.js/adapter';
-import type { EndpointControl, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
+import { Endpoint, type EndpointControl, type EndpointManagement, type EndpointSendRequest } from 'zhin.js/adapter';
 import type { EndpointContentPort } from '@zhin.js/adapter';
 import { type LoginAssist } from '@zhin.js/core';
 import type { CapabilityId } from 'zhin.js';

package/lib/endpoint.js

@@ -1,16 +1,16 @@
 import { Client, parseGroupMessageId, } from '@icqqjs/icqq';
 import { inspect } from 'node:util';
 import { AsyncLocalStorage } from 'node:async_hooks';
-import { Endpoint } from 'zhin.js/adapter';
+import { Endpoint, } from 'zhin.js/adapter';
 import { receiveOneBotLikeSideEvent, SystemEvent, toCanonicalSegments } from '@zhin.js/core';
 import { formatCompact, getAdapterLogger, truncatePreview } from '@zhin.js/logger';
 import { runIcqqLoginAssistStep } from './icqq-login-assist.js';
+import { IcqqContentResolver } from './content-resolver.js';
 import { InboundMessageDeduper, findIcqqNestedMessageSource, isIcqqBotMentioned, isIcqqMessagePostType, normalizeIcqqInboundMessage, messageLookupFromIcqqSource, resolveIcqqQuoteIdFromEvent, resolveIcqqInboundMedia, shouldSkipSelfInboundMessage, } from './icqq-inbound.js';
 import { isIcqqNoticePayload, isIcqqRequestPayload, } from './icqq-inbox.js';
 import { IcqqGuildCatalog, normalizeIcqqGuildInboundMessage, } from './icqq-guild.js';
 import { prepareIcqqOutboundMedia, resolveIcqqOutboundMediaMode, } from './outbound-media.js';
 import { formatInboundContent, formatOutboundBody, icqqInboundConversation, icqqOutboundTarget, } from './protocol.js';
-import { normalizeForwardMsgResponse } from './forward-msg.js';
 const BOUND_EVENTS = [
     'message.private',
     'message.group',
@@ -56,80 +56,8 @@ export class IcqqEndpoint extends Endpoint {
     #heldInbound = [];
     #inflightInbound = new Set();
     #inboundOwner = new AsyncLocalStorage();
-    #messageContent = new Map();
-    content = Object.freeze({
-        resolve: async (reference, context) => {
-            context.signal.throwIfAborted();
-            if (reference.kind === 'message') {
-                const cached = this.#messageContent.get(reference.message.id);
-                return cached
-                    ? Object.freeze({ status: 'resolved', reference, value: cached })
-                    : Object.freeze({ status: 'not_found', code: 'icqq_message_not_observed' });
-            }
-            if (reference.kind === 'forward') {
-                try {
-                    const entries = await this.#resolveForwardEntries(reference.forwardId, context, { remainingEntries: context.maxEntries, path: new Set() }, 0);
-                    if (entries.length === 0)
-                        return Object.freeze({ status: 'not_found', code: 'icqq_forward_not_found' });
-                    return Object.freeze({ status: 'resolved', reference, value: Object.freeze(entries) });
-                }
-                catch (error) {
-                    if (context.signal.aborted)
-                        throw error;
-                    return Object.freeze({
-                        status: 'failed',
-                        code: 'icqq_forward_fetch_failed',
-                        message: error instanceof Error ? error.message : String(error),
-                    });
-                }
-            }
-            if (reference.media.kind === 'url' || reference.media.kind === 'base64' || reference.media.kind === 'path') {
-                return Object.freeze({ status: 'resolved', reference, value: reference.media });
-            }
-            return Object.freeze({ status: 'unsupported', code: 'icqq_media_reference_unsupported' });
-        },
-    });
-    async #resolveForwardEntries(forwardId, context, state, depth) {
-        context.signal.throwIfAborted();
-        if (state.remainingEntries <= 0 || state.path.has(forwardId))
-            return Object.freeze([]);
-        state.path.add(forwardId);
-        try {
-            // ICQQ does not expose a cancellable getForwardMsg API. Keep the caller's
-            // generation lease until the native operation actually settles, then honor
-            // cancellation before publishing any resolved content.
-            const raw = await this.client.getForwardMsg(forwardId);
-            context.signal.throwIfAborted();
-            const entries = normalizeForwardMsgResponse(raw).slice(0, state.remainingEntries);
-            state.remainingEntries -= entries.length;
-            const expanded = [];
-            for (const entry of entries) {
-                context.signal.throwIfAborted();
-                const segments = [];
-                for (const segment of entry.segments) {
-                    if (segment.type !== 'forward' || depth >= context.maxDepth) {
-                        segments.push(segment);
-                        continue;
-                    }
-                    const nestedId = String(segment.data.forward_id ?? '').trim();
-                    if (!nestedId || state.path.has(nestedId) || state.remainingEntries <= 0) {
-                        segments.push(segment);
-                        continue;
-                    }
-                    const nested = await this.#resolveForwardEntries(nestedId, context, state, depth + 1);
-                    segments.push(Object.freeze({
-                        ...segment,
-                        data: Object.freeze({ ...segment.data, ...(nested.length > 0 ? { entries: nested } : {}) }),
-                    }));
-                }
-                expanded.push(Object.freeze({ ...entry, segments: Object.freeze(segments) }));
-            }
-            return Object.freeze(expanded);
-        }
-        finally {
-            state.path.delete(forwardId);
-        }
-    }
+    #contentResolver;
+    content;
     management = Object.freeze({
         listFriends: async () => Array.from(this.client.fl.values()).map((f) => ({
             user_id: f.user_id,
@@ -202,6 +130,8 @@ export class IcqqEndpoint extends Endpoint {
         super();
         const nativeConfig = resolveNativeClientConfig(options.config);
         this.client = new ManagedIcqqClient(Number(options.config.id), nativeConfig);
+        this.#contentResolver = new IcqqContentResolver(this.client);
+        this.content = this.#contentResolver.port;
         this.#logger = getAdapterLogger('icqq', options.config.id);
         this.#options = options;
         this.endpointName = options.config.id;
@@ -360,6 +290,27 @@ export class IcqqEndpoint extends Endpoint {
         }
     }
     async #sendNative(target, message) {
+        if (isIcqqShareElement(message)) {
+            switch (target.kind) {
+                case 'private':
+                    await this.client.pickFriend(target.userId).share(message);
+                    return {};
+                case 'group':
+                    await this.client.pickGroup(target.groupId).share(message);
+                    return {};
+                case 'temp':
+                    await this.client.pickMember(target.groupId, target.userId).share(message);
+                    return {};
+                case 'channel': {
+                    const channel = this.client.pickGuild(target.guildId).channels.get(target.channelId);
+                    if (!channel) {
+                        throw new TypeError(`ICQQ guild channel is unavailable: ${target.guildId}/${target.channelId}`);
+                    }
+                    await channel.share(message);
+                    return {};
+                }
+            }
+        }
         if (isIcqqFileElement(message)) {
             switch (target.kind) {
                 case 'private': {
@@ -708,7 +659,7 @@ export class IcqqEndpoint extends Endpoint {
         const quoteId = resolveIcqqQuoteIdFromEvent(data);
         const quoted = messageLookupFromIcqqSource(findIcqqNestedMessageSource(data));
         if (quoteId && quoted) {
-            this.#messageContent.set(quoteId, Object.freeze({
+            this.#contentResolver.remember(quoteId, Object.freeze({
                 ref: Object.freeze({ conversation, id: quoteId }),
                 ...(quoted.sender?.id ? { actor: Object.freeze({
                         id: quoted.sender.id,
@@ -919,6 +870,12 @@ export class IcqqEndpoint extends Endpoint {
         }
     }
 }
+function isIcqqShareElement(message) {
+    return !Array.isArray(message)
+        && typeof message === 'object'
+        && message !== null
+        && message.type === 'share';
+}
 function formatIcqqSendablePreview(message) {
     if (typeof message === 'string')
         return message;

package/lib/icqq-runtime-state.js

@@ -1,6 +1,6 @@
 /**
  * ICQQ 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `icqq.endpoint` 命令共享（同一 owner generation）。
+ * 由 plugin.ts setup() provide，adapter create 与 `icqq endpoint` 命令共享（同一 owner generation）。
  */
 import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
 export const icqqRuntimeStateToken = defineEndpointRuntimeStateToken('icqq');

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-export { Actions, formatInboundContent, formatOutboundBody, icqqInboundConversation, icqqOutboundTarget, type ActionResult, type IcqqAdapterConfig, type IcqqInboundMessage, type IcqqWireSegment, type ParsedIcqqSendTarget, type ResolvedIcqqConfig, } from './protocol.js';
+export { Actions, formatInboundContent, formatOutboundBody, icqqInboundConversation, icqqOutboundTarget, type ActionResult, type IcqqEndpointConfig, type IcqqInboundMessage, type IcqqWireSegment, 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';

package/lib/outbound-media.d.ts

@@ -1,5 +1,5 @@
 import type { SendContent } from "zhin.js";
-import type { IcqqEndpointConfig } from "./types.js";
+import type { IcqqEndpointConfig } from "./protocol.js";
 export type IcqqOutboundMediaMode = "file" | "base64";
 export declare function resolveIcqqOutboundMediaMode(config: Pick<IcqqEndpointConfig, "outboundMedia">): IcqqOutboundMediaMode;
 /**

package/lib/outbound-media.js

@@ -2,7 +2,7 @@ import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 import * as crypto from "node:crypto";
-import { isMediaRef } from "@zhin.js/core";
+import { isMediaRef } from '@zhin.js/im-contract';
 function extForMime(mime, fallback) {
     const map = {
         "image/jpeg": ".jpg",

package/lib/protocol.d.ts

@@ -161,9 +161,9 @@ export declare const Actions: {
     readonly SET_NOTIFY: "set_notify";
     readonly GET_NOTIFY: "get_notify";
 };
-/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
-export interface IcqqAdapterConfig {
-    readonly id?: string;
+/** One expanded ICQQ endpoint configuration produced by AdapterIndex. */
+export interface IcqqEndpointConfig {
+    readonly id: string;
     readonly autoReconnect?: boolean;
     readonly outboundMedia?: 'file' | 'base64';
     readonly password?: string;
@@ -177,24 +177,6 @@ export interface IcqqAdapterConfig {
     readonly autoServer?: boolean;
     readonly qqnt?: boolean;
     readonly ntLogin?: boolean;
-    /** Transitional: legacy root `endpoints[]` with `context: icqq`. */
-    readonly endpoints?: ReadonlyArray<{
-        readonly context?: string;
-        readonly id?: string;
-        readonly autoReconnect?: boolean;
-        readonly outboundMedia?: 'file' | 'base64';
-        readonly password?: string;
-        readonly platform?: number;
-        readonly ver?: string;
-        readonly dataDir?: string;
-        readonly signApiAddr?: string;
-        readonly ignoreSelf?: boolean;
-        readonly resend?: boolean;
-        readonly cacheGroupMember?: boolean;
-        readonly autoServer?: boolean;
-        readonly qqnt?: boolean;
-        readonly ntLogin?: boolean;
-    }>;
 }
 export interface ResolvedIcqqConfig {
     readonly context: 'icqq';
@@ -251,7 +233,7 @@ export type ParsedIcqqSendTarget = {
     readonly guildId: string;
     readonly channelId: string;
 };
-export declare function resolveIcqqConfig(config?: IcqqAdapterConfig): ResolvedIcqqConfig;
+export declare function resolveIcqqConfig(config: IcqqEndpointConfig): ResolvedIcqqConfig;
 /**
  * 入站归一化 → ConversationRef：群临时会话（temp）映射为群容器内的 private
  * 会话（parent kind 'group'）；频道消息的所属 guild 进 `parent`（kind 'channel'）。