@zhin.js/adapter-icqq 1.1.0 → 1.1.3

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

@@ -7,7 +7,9 @@ export default defineAgentTool({
         group_id: z.number().describe('群号'),
     }),
     adapter: 'icqq',
-    approval: 'never',
+    requiresApproval: 'once',
+    scopes: ['group'],
+    permissions: ['role(master,admin,trusted,owner)'],
     async execute({ group_id }, context) {
         const files = await context.$client.acquireGfs(group_id).ls('/');
         if (!files.length)

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

@@ -6,7 +6,9 @@ export default defineAgentTool<{ group_id: number }>({
     group_id: z.number().describe('群号'),
   }),
   adapter: 'icqq',
-  approval: 'never',
+  requiresApproval: 'once',
+  scopes:['group'],
+  permissions: ['role(master,admin,trusted,owner)'],
   async execute({ group_id }, context) {
     const files = await context.$client.acquireGfs(group_id).ls('/');
     if (!files.length) return { files: [], message: '群文件为空' };

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-inbound.js

@@ -360,6 +360,46 @@ export function icqqElementsToSegments(elements) {
                 });
                 break;
             }
+            case "share": {
+                const url = typeof el.url === "string" ? el.url.trim() : "";
+                const title = typeof el.title === "string" ? el.title.trim() : "";
+                if (!url || !title)
+                    break;
+                const description = typeof el.summary === "string" && el.summary
+                    ? el.summary
+                    : undefined;
+                const image = typeof el.image === "string" && el.image ? el.image : undefined;
+                const audio = typeof el.audio === "string" && el.audio ? el.audio : undefined;
+                const content = typeof el.content === "string" && el.content ? el.content : undefined;
+                const rawConfig = el.config && typeof el.config === "object" && !Array.isArray(el.config)
+                    ? el.config
+                    : undefined;
+                const appid = Number(rawConfig?.appid);
+                const config = Number.isSafeInteger(appid) && appid > 0
+                    ? {
+                        appid,
+                        ...(typeof rawConfig?.appname === "string" && rawConfig.appname
+                            ? { package: rawConfig.appname }
+                            : {}),
+                        ...(typeof rawConfig?.appsign === "string" && rawConfig.appsign
+                            ? { sign: rawConfig.appsign }
+                            : {}),
+                    }
+                    : undefined;
+                out.push({
+                    type: "share",
+                    data: {
+                        url,
+                        title,
+                        ...(description ? { description } : {}),
+                        ...(image ? { image } : {}),
+                        ...(audio ? { audio } : {}),
+                        ...(content ? { content } : {}),
+                        ...(config ? { config } : {}),
+                    },
+                });
+                break;
+            }
             default:
                 if (el.text != null && el.text !== "") {
                     out.push({ type: "text", data: { text: String(el.text) } });

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",