@zhin.js/adapter-icqq 6.0.1 → 6.0.3

package/agent/tools/group_files.ts

@@ -0,0 +1,27 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+  description: '获取 QQ 群的群文件列表',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    group_id: z.number().describe('群号'),
+  }),
+  platforms: ['icqq'],
+  tags: ['icqq'],
+  async execute({ endpoint_id, group_id    }: { endpoint_id: string; group_id: number }) {
+    const { Actions } = await import('../../src/protocol.js');
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const resp = await endpoint.ipc.request(Actions.GFS_LIST, { group_id });
+    if (!resp.ok) throw new Error(resp.error ?? '获取群文件失败');
+    const files = Array.isArray(resp.data) ? resp.data : [];
+    if (!files.length) return { files: [], message: '群文件为空' };
+    return {
+      files: files.slice(0, 30).map((f: { name: string; size: number; uploader_uin: string; upload_time: number }) => ({
+        name: f.name, size: f.size, uploader: f.uploader_uin, upload_time: f.upload_time,
+      })),
+      count: files.length,
+    };
+  },
+});
+

package/agent/tools/group_invite.ts

@@ -0,0 +1,20 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number }>({
+  description: '邀请好友加入 QQ 群',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('要邀请的 QQ号'),
+  }),
+  platforms: ['icqq'],
+  tags: ['icqq'],
+  async execute({ endpoint_id, group_id, user_id    }: { endpoint_id: string; group_id: number; user_id: number }) {
+    const { Actions } = await import('../../src/protocol.js');
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const resp = await endpoint.ipc.request(Actions.GROUP_INVITE, { group_id, user_id });
+    return { success: resp.ok, message: resp.ok ? `已邀请 ${user_id} 加入群` : (resp.error ?? '邀请失败') };
+  },
+});
+

package/agent/tools/group_list.ts

@@ -0,0 +1,20 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string }>({
+  description: '获取 Endpoint 的 QQ 群列表',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+  }),
+  platforms: ['icqq'],
+  tags: ['icqq'],
+  async execute({ endpoint_id    }: { endpoint_id: string }) {
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const groups = Array.from(endpoint.groups.values()).map((g) => ({
+      group_id: g.group_id, group_name: g.group_name,
+      member_count: g.member_count, max_member_count: g.max_member_count,
+    }));
+    return { groups: groups.slice(0, 50), count: endpoint.groups.size };
+  },
+});
+

package/agent/tools/group_sign.ts

@@ -0,0 +1,19 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+  description: 'QQ 群签到打卡',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    group_id: z.number().describe('目标群号'),
+  }),
+  platforms: ['icqq'],
+  tags: ['icqq'],
+  async execute({ endpoint_id, group_id    }: { endpoint_id: string; group_id: number }) {
+    const { Actions } = await import('../../src/protocol.js');
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const resp = await endpoint.ipc.request(Actions.GROUP_SIGN, { group_id });
+    return { success: resp.ok, message: resp.ok ? '群签到成功' : (resp.error ?? '签到失败') };
+  },
+});
+

package/agent/tools/list_muted.ts

@@ -0,0 +1,22 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+  description: '查询 QQ 群中当前被禁言的成员列表',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    group_id: z.number().describe('目标群号'),
+  }),
+  platforms: ['icqq'],
+  tags: ['icqq'],
+  permissions: ['platform(icqq,scene_admin)'],
+  async execute({ endpoint_id, group_id    }: { endpoint_id: string; group_id: number }) {
+    const { Actions } = await import('../../src/protocol.js');
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const resp = await endpoint.ipc.request(Actions.GROUP_MUTED_LIST, { group_id });
+    if (!resp.ok) throw new Error(resp.error ?? '获取禁言列表失败');
+    const list = Array.isArray(resp.data) ? resp.data : [];
+    return { muted_members: list, count: list.length };
+  },
+});
+

package/agent/tools/poke.ts

@@ -0,0 +1,20 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number }>({
+  description: '在 QQ 群中对某个成员执行戳一戳互动操作',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('要戳的目标成员 QQ号'),
+  }),
+  platforms: ['icqq'],
+  tags: ['icqq'],
+  async execute({ endpoint_id, group_id, user_id    }: { endpoint_id: string; group_id: number; user_id: number }) {
+    const { Actions } = await import('../../src/protocol.js');
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const resp = await endpoint.ipc.request(Actions.GROUP_POKE, { group_id, user_id });
+    return { success: resp.ok, message: resp.ok ? `已戳了戳 ${user_id}` : (resp.error ?? '戳一戳失败') };
+  },
+});
+

package/agent/tools/send_user_like.ts

@@ -0,0 +1,22 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; user_id: number; times?: number }>({
+  description: '给用户点赞（竖大拇指），每人每天最多 20 次',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    user_id: z.number().describe('要点赞的目标用户 QQ号'),
+    times: z.number().optional().describe('点赞次数（1-20），默认 1'),
+  }),
+  platforms: ['icqq'],
+  tags: ['icqq'],
+  async execute({ endpoint_id, user_id, times    }: { endpoint_id: string; user_id: number; times?: number }) {
+    const { Actions } = await import('../../src/protocol.js');
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const resp = await endpoint.ipc.request(Actions.FRIEND_LIKE, {
+      user_id, times: Math.min(times ?? 1, 20),
+    });
+    return { success: resp.ok, message: resp.ok ? `已给 ${user_id} 点赞` : (resp.error ?? '点赞失败') };
+  },
+});
+

package/agent/tools/set_anonymous.ts

@@ -0,0 +1,22 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; group_id: number; enable?: boolean }>({
+  description: '开启或关闭 QQ 群的匿名聊天功能',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    group_id: z.number().describe('目标群号'),
+    enable: z.boolean().optional().describe('true=开启，false=关闭，默认 true'),
+  }),
+  platforms: ['icqq'],
+  tags: ['icqq'],
+  permissions: ['platform(icqq,scene_owner)'],
+  async execute({ endpoint_id, group_id, enable    }: { endpoint_id: string; group_id: number; enable?: boolean }) {
+    const { Actions } = await import('../../src/protocol.js');
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const on = enable ?? true;
+    const resp = await endpoint.ipc.request(Actions.GROUP_ALLOW_ANONY, { group_id, enable: on });
+    return { success: resp.ok, message: resp.ok ? (on ? '已开启匿名聊天' : '已关闭匿名聊天') : (resp.error ?? '操作失败') };
+  },
+});
+

package/agent/tools/set_title.ts

@@ -0,0 +1,25 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
+export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number; title: string; duration?: number }>({
+  description: '设置 QQ 群成员的专属头衔',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint QQ号'),
+    group_id: z.number().describe('目标群号'),
+    user_id: z.number().describe('目标成员 QQ号'),
+    title: z.string().describe('头衔文字'),
+    duration: z.number().optional().describe('持续时间(秒)，-1永久'),
+  }),
+  platforms: ['icqq'],
+  tags: ['icqq'],
+  permissions: ['platform(icqq,scene_owner)'],
+  async execute({ endpoint_id, group_id, user_id, title, duration    }: { endpoint_id: string; group_id: number; user_id: number; title: string; duration?: number }) {
+    const { Actions } = await import('../../src/protocol.js');
+    const endpoint = getIcqqAgentDeps().getEndpoint(endpoint_id);
+    const resp = await endpoint.ipc.request(Actions.SET_GROUP_TITLE, {
+      group_id, user_id, title, duration: duration ?? -1,
+    });
+    return { success: resp.ok, message: resp.ok ? `已将 ${user_id} 的头衔设为 "${title}"` : (resp.error ?? '设置失败') };
+  },
+});
+

package/lib/agent-prompt.d.ts

@@ -1,3 +1,2 @@
 import type { AgentPromptContributor } from 'zhin.js';
 export declare function createIcqqAgentPromptContributor(): AgentPromptContributor;
-//# sourceMappingURL=agent-prompt.d.ts.map

package/lib/agent-prompt.js

@@ -100,4 +100,3 @@ export function createIcqqAgentPromptContributor() {
         },
     };
 }
-//# sourceMappingURL=agent-prompt.js.map

package/lib/cq-message.d.ts

@@ -7,4 +7,3 @@ export declare function parseCqMessage(raw: string): MessageSegment[];
 /** 构建 icqq IPC send_*_msg 的 message 字符串（非空） */
 export declare function buildIcqqIpcMessage(content: SendContent): string;
 export declare function toCqString(content: SendContent): string;
-//# sourceMappingURL=cq-message.d.ts.map

package/lib/cq-message.js

@@ -145,4 +145,3 @@ export function toCqString(content) {
     })
         .join("");
 }
-//# sourceMappingURL=cq-message.js.map

package/lib/endpoint.d.ts

@@ -1,103 +1,51 @@
 /**
- * ICQQ Bot：通过 @icqqjs/cli 守护进程 IPC 通信，实现 zhin Endpoint 接口
- *
- * 不再直接依赖 @icqqjs/icqq 协议库。
- * 登录由 `icqq login` 完成，本 Endpoint 只负责连接守护进程并收发消息。
+ * IcqqIpcEndpoint — lifecycle, outbound, IPC subscribe/admit for ICQQ daemon.
  */
-import { Endpoint, Message, SendOptions, type QuotedMessagePayload } from 'zhin.js';
-import type { IcqqEndpointConfig, IpcFriendInfo, IpcGroupInfo } from "./types.js";
-import type { IcqqAdapter } from "./adapter.js";
-import { IpcClient } from "./ipc-client.js";
-import type { IcqqIpcMessageEvent } from "./icqq-inbound.js";
-import { type NormalizedIcqqInbound } from "./icqq-inbound.js";
-import { buildIcqqIpcMessage as buildIcqqIpcMessageImpl, parseCqMessage as parseCqMessageImpl, toCqString as toCqStringImpl } from "./cq-message.js";
-import { IcqqGuildCatalog } from "./icqq-guild.js";
-export declare class IcqqEndpoint implements Endpoint<IcqqEndpointConfig, IcqqIpcMessageEvent> {
-    adapter: IcqqAdapter;
-    $connected: boolean;
-    $config: IcqqEndpointConfig;
-    ipc: IpcClient;
-    /** 缓存的好友列表 */
-    friends: Map<number, IpcFriendInfo>;
-    /** 缓存的群列表 */
-    groups: Map<number, IpcGroupInfo>;
-    /** QQ 频道（guild）子频道缓存 */
-    readonly guildCatalog: IcqqGuildCatalog;
-    private subscriptions;
-    /** 事件去重：覆盖多端回流/服务端重复推送等场景 */
-    private readonly inboundDeduper;
-    /** MessageEvent.source 解析结果，供 $getMsg 优先命中 */
-    private readonly quotedSourceCache;
-    /** 用户主动断开时为 true，阻止自动重连 */
-    private intentionalDisconnect;
-    /** 是否已有重连循环在跑（避免多次 schedule 叠套） */
-    private reconnectRunning;
-    get $id(): `${number}`;
-    get logger(): import("zhin.js").Logger;
-    constructor(adapter: IcqqAdapter, config: IcqqEndpointConfig);
-    $connect(): Promise<void>;
-    /** 建立或恢复与守护进程的 IPC/RPC 会话（订阅、缓存列表） */
-    private rebindIpcSession;
-    /** IPC/RPC 意外断开时调度重连（指数退避） */
-    private scheduleReconnect;
-    private runReconnectLoop;
-    /** 刷新好友/群列表缓存 */
-    refreshLists(): Promise<void>;
-    /** Console：列出 guild 子频道（含 parent.guild） */
-    getGuildChannelList(): ReturnType<IcqqGuildCatalog["getGuildChannelList"]>;
-    resolveConsoleChannelNames(channelId: string, guildId?: string): {
-        channelName?: string;
-        parentName?: string;
+import type { EndpointInstance } from '@zhin.js/adapter';
+import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { CapabilityId } from '@zhin.js/plugin-runtime';
+import { type IcqqInboundMessage, type IpcEvent, type IpcResponse, type ResolvedIcqqConfig } from './protocol.js';
+import type { IpcFriendInfo, IpcGroupInfo } from './types.js';
+/** Minimal IPC surface used by the endpoint (real IpcClient or test mock). */
+export interface IcqqIpcTransport {
+    request(action: string, params?: Record<string, unknown>): Promise<IpcResponse>;
+    subscribe(action: string, params: Record<string, unknown>, handler: (event: IpcEvent) => void): {
+        unsubscribe: () => Promise<void>;
     };
-    $disconnect(): Promise<void>;
-    private handleEvent;
-    private dispatchInboundMessage;
-    private handleGuildMessageEvent;
-    private dispatchGuildInboundMessage;
-    private $formatGuildMessage;
-    private handleNoticeEvent;
-    private handleRequestEvent;
-    private handleMetaEvent;
-    /** 调试 IPC 入站字段：默认 debug；设 ICQQ_IPC_LOG_RAW=1 则 info 打完整 payload */
-    private logIpcInboundPayload;
-    $formatMessage(input: NormalizedIcqqInbound | IcqqIpcMessageEvent): ReturnType<typeof Message.from<IcqqIpcMessageEvent>>;
-    /**
-     * 有 source.message_id 时用 get_msg 拉全量正文；否则仅用 source 内联摘要。
-     */
-    private primeQuotedSourceCache;
-    private fetchQuotedMessagePayload;
-    $getMsg(messageId: string): Promise<QuotedMessagePayload>;
-    $recallMessage(id: string): Promise<void>;
-    $sendMessage(options: SendOptions): Promise<string>;
-    /**
-     * 表情符号到 reaction id 的映射
-     * QQ 使用数字 ID 来标识表情，而不是 Unicode 字符
-     */
+    setOnRemoteDisconnect(handler: (() => void) | null): void;
+    close(): void;
+}
+export type CreateIcqqIpc = (config: ResolvedIcqqConfig) => Promise<IcqqIpcTransport>;
+export interface IcqqEndpointOptions {
+    readonly id: CapabilityId;
+    readonly gateway: MessageGateway;
+    readonly config: ResolvedIcqqConfig;
+    readonly createIpc?: CreateIcqqIpc;
+}
+export declare class IcqqIpcEndpoint implements EndpointInstance {
+    #private;
+    readonly name: string;
+    /** Populated after start(); agent tools read this. */
+    ipc: IcqqIpcTransport;
+    readonly friends: Map<number, IpcFriendInfo>;
+    readonly groups: Map<number, IpcGroupInfo>;
+    constructor(options: IcqqEndpointOptions);
+    request(action: string, params?: Record<string, unknown>): Promise<IpcResponse>;
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ target, payload }: {
+        readonly target: string;
+        readonly payload: unknown;
+    }): Promise<string>;
     private static readonly EMOJI_MAP;
-    /**
-     * 将表情符号转换为 reaction id
-     */
     private getEmojiId;
-    /**
-     * 添加消息回应（表情）
-     *
-     * @param messageId - 消息 ID
-    * @param emoji - 表情符号或 reaction id
-     * @returns 反应 ID，可用于后续移除
-     */
-    $addReaction(messageId: string, emoji: string): Promise<string | null>;
-    /**
-     * 移除消息回应
-     *
-     * @param messageId - 消息 ID
-     * @param reactionId - 反应 ID（由 $addReaction 返回）
-     */
-    $removeReaction(messageId: string, reactionId: string): Promise<void>;
-}
-/** @deprecated 使用 `./cq-message.js` 导出 */
-export declare namespace IcqqEndpoint {
-    const parseCqMessage: typeof parseCqMessageImpl;
-    const buildIcqqIpcMessage: typeof buildIcqqIpcMessageImpl;
-    const toCqString: typeof toCqStringImpl;
+    /** Activity-feedback / OutboundHost reaction surface. */
+    addReaction(messageId: string, emoji: string): Promise<string | null>;
+    removeReaction(messageId: string, reactionId: string): Promise<void>;
+    /** Activity-feedback autoRemove / Console recall. */
+    recallMessage(messageId: string): Promise<void>;
+    /** Test / internal: admit when open. */
+    admit(msg: IcqqInboundMessage): void;
 }
-//# sourceMappingURL=endpoint.d.ts.map