@zhin.js/adapter-icqq 6.0.2 → 7.0.0

package/agent/tools/announce.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; group_id: number; content: string }>({
+export default defineAgentTool<{ endpoint_id: string; group_id: number; content: string }>({
   description: '发送 QQ 群公告（需要管理员权限）',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint QQ号'),

package/agent/tools/essence.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; message_id: string; action: 'add' | 'remove' }>({
+export default defineAgentTool<{ endpoint_id: string; message_id: string; action: 'add' | 'remove' }>({
   description: '设置或移除 QQ 群精华消息',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint QQ号'),

package/agent/tools/friend_list.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string }>({
+export default defineAgentTool<{ endpoint_id: string }>({
   description: '获取 QQ 好友列表',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),

package/agent/tools/group_files.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; group_id: number }>({
+export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
   description: '获取 QQ 群的群文件列表',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),

package/agent/tools/group_invite.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; group_id: number; user_id: number }>({
+export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number }>({
   description: '邀请好友加入 QQ 群',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint QQ号'),

package/agent/tools/group_list.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string }>({
+export default defineAgentTool<{ endpoint_id: string }>({
   description: '获取 Endpoint 的 QQ 群列表',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),

package/agent/tools/group_sign.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; group_id: number }>({
+export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
   description: 'QQ 群签到打卡',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint QQ号'),

package/agent/tools/list_muted.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; group_id: number }>({
+export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
   description: '查询 QQ 群中当前被禁言的成员列表',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint QQ号'),

package/agent/tools/poke.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; group_id: number; user_id: number }>({
+export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number }>({
   description: '在 QQ 群中对某个成员执行戳一戳互动操作',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint QQ号'),

package/agent/tools/send_user_like.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; user_id: number; times?: number }>({
+export default defineAgentTool<{ endpoint_id: string; user_id: number; times?: number }>({
   description: '给用户点赞（竖大拇指），每人每天最多 20 次',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint QQ号'),

package/agent/tools/set_anonymous.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; group_id: number; enable?: boolean }>({
+export default defineAgentTool<{ endpoint_id: string; group_id: number; enable?: boolean }>({
   description: '开启或关闭 QQ 群的匿名聊天功能',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint QQ号'),

package/agent/tools/set_title.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; group_id: number; user_id: number; title: string; duration?: number }>({
+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号'),

package/lib/agent-prompt.d.ts

@@ -0,0 +1,2 @@
+import type { AgentPromptContributor } from 'zhin.js';
+export declare function createIcqqAgentPromptContributor(): AgentPromptContributor;

package/lib/{src/agent-prompt.js → agent-prompt.js}

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

package/lib/cq-message.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CQ 码与 MessageSegment 互转。
+ * 出站：@icqqjs/cli 要求 message 为非空字符串；引用段编码为 [reply:id]（需 cli parse-message 支持 reply，见 scripts/patch-icqq-cli-reply.mjs）。
+ */
+import { MessageSegment, SendContent } from "zhin.js";
+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;

package/lib/{src/cq-message.js → cq-message.js}

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

package/lib/endpoint.d.ts

@@ -0,0 +1,101 @@
+/**
+ * IcqqIpcEndpoint — lifecycle, outbound, IPC subscribe/admit for ICQQ daemon.
+ */
+import type { EndpointInstance, EndpointManagement } 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, IpcMemberInfo } 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>;
+    };
+    setOnRemoteDisconnect(handler: (() => void) | null): void;
+    close(): void;
+}
+export type CreateIcqqIpc = (config: ResolvedIcqqConfig) => Promise<IcqqIpcTransport>;
+/**
+ * 收件箱写/推钩子（由装配层注入，见 adapters/icqq.ts）。
+ * record* 写 unified_inbox_request/notice；publish 向 console hub 推送实时事件。
+ */
+export interface IcqqInboxHooks {
+    recordRequest(row: Record<string, unknown>): void | Promise<void>;
+    recordNotice(row: Record<string, unknown>): void | Promise<void>;
+    publish?(type: string, data: unknown): void;
+}
+export interface IcqqEndpointOptions {
+    readonly id: CapabilityId;
+    readonly gateway: MessageGateway;
+    readonly config: ResolvedIcqqConfig;
+    readonly createIpc?: CreateIcqqIpc;
+    /** 未注入时 request/notice 事件仅按非消息载荷忽略（不报错）。 */
+    readonly inbox?: IcqqInboxHooks;
+}
+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>;
+    readonly management: EndpointManagement;
+    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;
+    private getEmojiId;
+    /** 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>;
+    /** EndpointManagement.listFriends —— 好友列表（LIST_FRIENDS，归一为 {user_id, nickname, remark}）。 */
+    getFriendList(): Promise<Array<{
+        user_id: number;
+        nickname: string;
+        remark: string;
+    }>>;
+    /** EndpointManagement.listGroups —— 群列表（LIST_GROUPS，归一为 {group_id, name}）。 */
+    getGroupList(): Promise<Array<{
+        group_id: number;
+        name: string;
+    }>>;
+    /** EndpointManagement.listGroupMembers —— 群成员列表（字段对齐 daemon 返回）。 */
+    getGroupMemberList(groupId: number | string): Promise<IpcMemberInfo[]>;
+    /** getGroupMemberList 别名（console 探测 listMembers / getMemberList）。 */
+    listMembers(groupId: number | string): Promise<IpcMemberInfo[]>;
+    getMemberList(groupId: number | string): Promise<IpcMemberInfo[]>;
+    /**
+     * EndpointManagement.resolveRequest —— id 为 inbox 行的 platform_request_id。
+     * 先 GET_SYSTEM_MSG 按 flag（回退 seq）定位请求，再按类型路由 handle_friend/group_request。
+     */
+    approveRequest(id: string, remark?: string): Promise<void>;
+    rejectRequest(id: string, reason?: string): Promise<void>;
+    /** EndpointManagement.deleteFriend —— FRIEND_DELETE。 */
+    deleteFriend(userId: number | string): Promise<void>;
+    /** deleteFriend 别名（console 探测 delete_friend）。 */
+    delete_friend(userId: number | string): Promise<void>;
+    /** EndpointManagement.kickGroupMember —— GROUP_KICK。 */
+    removeMember(groupId: number | string, userId: number | string): Promise<void>;
+    kickMember(groupId: number | string, userId: number | string): Promise<void>;
+    setGroupKick(groupId: number | string, userId: number | string): Promise<void>;
+    /** EndpointManagement.muteGroupMember —— GROUP_MUTE（duration 秒，默认 600）。 */
+    muteMember(groupId: number | string, userId: number | string, duration?: number): Promise<void>;
+    banMember(groupId: number | string, userId: number | string, duration?: number): Promise<void>;
+    setGroupMute(groupId: number | string, userId: number | string, duration?: number): Promise<void>;
+    /** EndpointManagement.setGroupAdmin —— SET_GROUP_ADMIN（enable 默认 true）。 */
+    setModerator(groupId: number | string, userId: number | string, enable?: boolean): Promise<void>;
+    setAdmin(groupId: number | string, userId: number | string, enable?: boolean): Promise<void>;
+    setGroupAdmin(groupId: number | string, userId: number | string, enable?: boolean): Promise<void>;
+    /** Test / internal: admit when open. */
+    admit(msg: IcqqInboundMessage): void;
+}