@zhin.js/adapter-icqq 1.0.71 → 1.1.2

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

@@ -0,0 +1,24 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取 QQ 群的群文件列表',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+    }),
+    adapter: 'icqq',
+    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: '群文件为空' };
+        return {
+            files: files.slice(0, 30).map((f) => 'size' in f
+                ? { name: f.name, is_dir: false, size: f.size, uploader: f.user_id, upload_time: f.create_time }
+                : { name: f.name, is_dir: true, file_count: f.file_count }),
+            count: files.length,
+        };
+    },
+});

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

@@ -0,0 +1,22 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number }>({
+  description: '获取 QQ 群的群文件列表',
+  inputSchema: z.object({
+    group_id: z.number().describe('群号'),
+  }),
+  adapter: 'icqq',
+  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: '群文件为空' };
+    return {
+      files: files.slice(0, 30).map((f) => 'size' in f
+        ? { name: f.name, is_dir: false, size: f.size, uploader: f.user_id, upload_time: f.create_time }
+        : { name: f.name, is_dir: true, file_count: f.file_count }),
+      count: files.length,
+    };
+  },
+});

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

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '查询 QQ 群中当前被禁言的成员列表',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+    }),
+    adapter: 'icqq',
+    scopes: ['group'],
+    requiresApproval: 'never',
+    async execute({ group_id }, context) {
+        const members = await context.$client.getGroupMemberList(group_id);
+        const now = Math.floor(Date.now() / 1000);
+        const muted = Array.from(members.values()).filter((m) => m.shutup_time > now);
+        return { muted_members: muted, count: muted.length };
+    },
+});

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

@@ -0,0 +1,17 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number }>({
+  description: '查询 QQ 群中当前被禁言的成员列表',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+  }),
+  adapter: 'icqq',
+  scopes:['group'],
+  requiresApproval: 'never',
+  async execute({ group_id }, context) {
+    const members = await context.$client.getGroupMemberList(group_id);
+    const now = Math.floor(Date.now() / 1000);
+    const muted = Array.from(members.values()).filter((m) => m.shutup_time > now);
+    return { muted_members: muted, count: muted.length };
+  },
+});

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/agents/icqq/skills/icqq-interaction/tools/group_sign/index.js

@@ -0,0 +1,20 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: 'QQ 群签到/打卡',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+    }),
+    adapter: 'icqq',
+    scopes: ['group'],
+    requiresApproval: 'never',
+    async execute({ group_id }, context) {
+        const client = context.$client;
+        const groupInfo = client.pickGroup(group_id);
+        if (!groupInfo)
+            return { success: false, message: '目标群不存在' };
+        await client.sendGroupSign(group_id);
+        return { success: true, message: '群签到成功' };
+    },
+});

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

@@ -0,0 +1,18 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number }>({
+  description: 'QQ 群签到/打卡',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+  }),
+  adapter: 'icqq',
+  scopes:['group'],
+  requiresApproval: 'never',
+  async execute({ group_id }, context) {
+    const client = context.$client;
+    const groupInfo= client.pickGroup(group_id);
+    if(!groupInfo) return { success: false, message: '目标群不存在' };
+    await client.sendGroupSign(group_id);
+    return { success: true, message: '群签到成功' };
+  },
+});

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

@@ -0,0 +1,17 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '在 QQ 群中对某个成员执行戳一戳互动操作',
+    inputSchema: z.object({
+        group_id: z.number().describe('目标群号'),
+        user_id: z.number().describe('要戳的目标成员 QQ号'),
+    }),
+    adapter: 'icqq',
+    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/agents/icqq/skills/icqq-interaction/tools/poke/index.ts

@@ -0,0 +1,16 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ group_id: number; user_id: number }>({
+  description: '在 QQ 群中对某个成员执行戳一戳互动操作',
+  inputSchema: z.object({
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('要戳的目标成员 QQ号'),
+  }),
+  adapter: 'icqq',
+  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/agents/icqq/skills/icqq-interaction/tools/send_user_like/index.js

@@ -0,0 +1,26 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '尝试给用户点尽量多的赞',
+    inputSchema: z.object({
+        user_id: z.number().describe('要点赞的目标用户 QQ号'),
+    }),
+    adapter: 'icqq',
+    requiresApproval: 'never',
+    async execute({ user_id }, context) {
+        const successArray = [];
+        await Promise.all([20, 20, 10].map(async (times) => {
+            try {
+                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);
+        if (!successTimes)
+            return { success: false, message: '点赞失败' };
+        return { success: true, message: `已给 ${user_id} 点赞 ${successTimes} 次` };
+    },
+});

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

@@ -0,0 +1,22 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool<{ user_id: number }>({
+  description: '尝试给用户点尽量多的赞',
+  inputSchema: z.object({
+    user_id: z.number().describe('要点赞的目标用户 QQ号'),
+  }),
+  adapter: 'icqq',
+  requiresApproval: 'never',
+  async execute({ user_id }, context) {
+    const successArray: number[] = [];
+    await Promise.all([20, 20, 10].map(async (times) => {
+      try {
+        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);
+    if (!successTimes) return { success: false, message: '点赞失败' };
+    return { success: true, message: `已给 ${user_id} 点赞 ${successTimes} 次` };
+  },
+});

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/icqq/endpoint/add/[[id]]/index.js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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/commands/icqq/endpoint/definition.js

@@ -0,0 +1,31 @@
+// 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 "../../../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: async ({ id, use }) => {
+        if (!id) {
+            return '用法：icqq endpoint add <uin>（uin 为纯数字 QQ 号）';
+        }
+        if (!/^\d+$/.test(id)) {
+            return 'icqq endpoint 名必须是纯数字 QQ 号（uin）';
+        }
+        try {
+            const { filePath } = await use(endpointConfigurationStoreToken).add({
+                adapterKey: 'icqq',
+                entry: { id },
+                environment: {},
+            });
+            return (`✅ endpoint「${id}」已追加到 ${filePath} 的 plugins.icqq.endpoints。\n` +
+                `重启 zhin 后生效。`);
+        }
+        catch (error) {
+            return `添加失败：${error instanceof Error ? error.message : String(error)}`;
+        }
+    },
+}, defineCommand);

package/commands/icqq/endpoint/definition.ts

@@ -0,0 +1,32 @@
+import { createEndpointCommands, endpointConfigurationStoreToken } from 'zhin.js/adapter';
+import { defineCommand } from 'zhin.js/command';
+import { icqqRuntimeStateToken } from '../../../src/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: async ({ id, use }) => {
+    if (!id) {
+      return '用法：icqq endpoint add <uin>（uin 为纯数字 QQ 号）';
+    }
+    if (!/^\d+$/.test(id)) {
+      return 'icqq endpoint 名必须是纯数字 QQ 号（uin）';
+    }
+    try {
+      const { filePath } = await use(endpointConfigurationStoreToken).add({
+        adapterKey: 'icqq',
+        entry: { id },
+        environment: {},
+      });
+      return (
+        `✅ endpoint「${id}」已追加到 ${filePath} 的 plugins.icqq.endpoints。\n` +
+        `重启 zhin 后生效。`
+      );
+    } catch (error) {
+      return `添加失败：${error instanceof Error ? error.message : String(error)}`;
+    }
+  },
+}, defineCommand);

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

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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/icqq/endpoint/remove/[id]/index.js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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/client.d.ts

@@ -0,0 +1,19 @@
+import type { Client, EventMap } from '@icqqjs/icqq';
+type EventPayload<TListener> = TListener extends (event: infer TEvent, ...rest: readonly unknown[]) => unknown ? TEvent : never;
+/** The actual ICQQ SDK instance exposed by every ICQQ Endpoint event. */
+export type IcqqClient = Client;
+/** Native ICQQ event-name → first public event payload, derived from the SDK SSOT. */
+export type IcqqClientEventMap = {
+    readonly [TName in keyof EventMap]: EventPayload<EventMap[TName]>;
+};
+declare module '@zhin.js/feature-kit' {
+    interface AdapterClientRegistry {
+        readonly icqq: {
+            readonly client: IcqqClient;
+            readonly events: IcqqClientEventMap;
+        };
+    }
+}
+/** Typed, generation-checked identity used by handlers, commands, tools and schedules. */
+export declare const icqqClient: import("@zhin.js/adapter").EndpointClientToken<Client, IcqqClientEventMap>;
+export {};

package/lib/client.js

@@ -0,0 +1,3 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+/** Typed, generation-checked identity used by handlers, commands, tools and schedules. */
+export const icqqClient = defineEndpointClient('icqq');

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

@@ -0,0 +1,14 @@
+/** ICQQ 历史文本视图 → canonical MessageSegment。出站只使用原生 Sendable。 */
+import { type MediaRef } from '@zhin.js/im-contract';
+import type { MessageSegment } from "zhin.js";
+/**
+ * CQ 媒体参数 / 入站元素媒体值 → canonical MediaRef：
+ * `base64://` → base64；http(s) → url；本机路径 → path；其余视为平台不透明引用（file）。
+ */
+export declare function icqqMediaRefFromString(value: string): MediaRef;
+/**
+ * canonical MediaRef（`data.media`，唯一媒体来源）→ ICQQ native
+ * element 的 file 参数。base64 使用 ICQQ 原生支持的 `base64://` 前缀。
+ */
+export declare function resolveIcqqMediaFile(data: Record<string, unknown> | undefined): string | undefined;
+export declare function parseCqMessage(raw: string): MessageSegment[];

package/lib/cq-message.js

@@ -0,0 +1,106 @@
+/** ICQQ 历史文本视图 → canonical MessageSegment。出站只使用原生 Sendable。 */
+import { isMediaRef } from '@zhin.js/im-contract';
+const MAX_CQ_PARSE_LEN = 256_000;
+/**
+ * CQ 媒体参数 / 入站元素媒体值 → canonical MediaRef：
+ * `base64://` → base64；http(s) → url；本机路径 → path；其余视为平台不透明引用（file）。
+ */
+export function icqqMediaRefFromString(value) {
+    if (value.startsWith("base64://")) {
+        return { kind: "base64", value: value.slice("base64://".length) };
+    }
+    if (value.startsWith("http://") || value.startsWith("https://")) {
+        return { kind: "url", value };
+    }
+    if (value.startsWith("/") || /^[a-zA-Z]:[\\/]/.test(value)) {
+        return { kind: "path", value };
+    }
+    return { kind: "file", value };
+}
+/**
+ * canonical MediaRef（`data.media`，唯一媒体来源）→ ICQQ native
+ * element 的 file 参数。base64 使用 ICQQ 原生支持的 `base64://` 前缀。
+ */
+export function resolveIcqqMediaFile(data) {
+    const media = data?.media;
+    if (!isMediaRef(media))
+        return undefined;
+    if (media.kind === "base64") {
+        return media.value.startsWith("base64://") ? media.value : `base64://${media.value}`;
+    }
+    return media.value;
+}
+function pushCqSegment(segments, type, arg) {
+    switch (type) {
+        case "face":
+            segments.push({ type: "face", data: { id: Number(arg) } });
+            break;
+        case "image":
+            segments.push({ type: "image", data: { media: icqqMediaRefFromString(arg) } });
+            break;
+        case "at":
+            if (arg === "all") {
+                segments.push({ type: "at", data: { qq: "all" } });
+            }
+            else {
+                segments.push({ type: "at", data: { qq: arg } });
+            }
+            break;
+        case "dice":
+            segments.push({ type: "dice", data: {} });
+            break;
+        case "rps":
+            segments.push({ type: "rps", data: {} });
+            break;
+        case "record":
+        case "audio":
+            segments.push({ type: "audio", data: { media: icqqMediaRefFromString(arg) } });
+            break;
+        case "video":
+            segments.push({ type: "video", data: { media: icqqMediaRefFromString(arg) } });
+            break;
+        case "reply":
+            segments.push({ type: "reply", data: { message_id: arg } });
+            break;
+        case "json":
+            segments.push({ type: "json", data: { text: arg } });
+            break;
+        default:
+            segments.push({ type, data: { text: `[${type}:${arg}]` } });
+            break;
+    }
+}
+export function parseCqMessage(raw) {
+    const text = raw.length > MAX_CQ_PARSE_LEN ? raw.slice(0, MAX_CQ_PARSE_LEN) : raw;
+    const segments = [];
+    let i = 0;
+    while (i < text.length) {
+        if (text[i] !== "[") {
+            const next = text.indexOf("[", i);
+            const chunk = next === -1 ? text.slice(i) : text.slice(i, next);
+            if (chunk)
+                segments.push({ type: "text", data: { text: chunk } });
+            if (next === -1)
+                break;
+            i = next;
+            continue;
+        }
+        const close = text.indexOf("]", i + 1);
+        if (close === -1) {
+            segments.push({ type: "text", data: { text: text.slice(i) } });
+            break;
+        }
+        const inner = text.slice(i + 1, close);
+        const colon = inner.indexOf(":");
+        const type = (colon === -1 ? inner : inner.slice(0, colon)).trim().toLowerCase();
+        const arg = colon === -1 ? "" : inner.slice(colon + 1);
+        if (/^[a-z_]+$/.test(type)) {
+            pushCqSegment(segments, type, arg);
+        }
+        else {
+            segments.push({ type: "text", data: { text: text.slice(i, close + 1) } });
+        }
+        i = close + 1;
+    }
+    return segments.length ? segments : [{ type: "text", data: { text: raw } }];
+}

package/lib/endpoint.d.ts

@@ -0,0 +1,30 @@
+import { Client } from '@icqqjs/icqq';
+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';
+import { type IcqqInboundMessage, type ResolvedIcqqConfig } from './protocol.js';
+export interface IcqqEndpointOptions {
+    readonly id: CapabilityId;
+    readonly config: ResolvedIcqqConfig;
+    readonly loginAssist: LoginAssist;
+}
+declare class ManagedIcqqClient extends Client {
+    cancelReconnect(): void;
+}
+export declare class IcqqEndpoint extends Endpoint<Client> {
+    #private;
+    readonly client: ManagedIcqqClient;
+    readonly endpointName: string;
+    readonly content: EndpointContentPort;
+    readonly management: EndpointManagement;
+    readonly control: EndpointControl;
+    constructor(options: IcqqEndpointOptions);
+    start(signal: AbortSignal): Promise<void>;
+    open(): void;
+    close(): Promise<void>;
+    stop(): Promise<void>;
+    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
+    admit(msg: IcqqInboundMessage): Promise<void>;
+}
+export {};