@zhin.js/adapter-napcat 7.0.0 → 7.0.2

package/agent/tools/mark_msg_as_read.ts

@@ -1,18 +1,16 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; message_id: number }>({
+export default defineAgentTool<{ message_id: number }>({
   description: '标记消息为已读。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     message_id: z.number().describe('消息 ID'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['已读', 'mark read', '标记已读'],
-  async execute({ endpoint_id, message_id }: { endpoint_id: string; message_id: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ message_id }: { message_id: number }, context) {
+    const endpoint = context.$client;
       await endpoint.markMsgAsRead(message_id);
       return { success: true };
   },

package/agent/tools/ocr_image.ts

@@ -1,18 +1,16 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; image: string }>({
+export default defineAgentTool<{ image: string }>({
   description: '图片 OCR 文字识别。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     image: z.string().describe('图片 file 参数（收到消息中的 file 字段或 URL）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['OCR', '文字识别', '图片识别', 'ocr'],
-  async execute({ endpoint_id, image }: { endpoint_id: string; image: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ image }: { image: string }, context) {
+    const endpoint = context.$client;
       return endpoint.ocrImage(image);
   },
 });

package/agent/tools/send_forward_msg.ts

@@ -1,30 +1,26 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
 export default defineAgentTool<{
-  endpoint_id: string;
   message_type: 'private' | 'group';
   id: number;
   messages: string;
 }>({
   description: '发送合并转发消息（群聊或私聊）。messages 为转发节点数组。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     message_type: z.enum(['private', 'group']).describe('private 或 group'),
     id: z.number().describe('群号或 QQ 号'),
     messages: z.string().describe('转发节点 JSON（node 数组）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['合并转发', 'forward', '转发消息'],
-  async execute({ endpoint_id, message_type, id, messages }: {
-    endpoint_id: string;
+  async execute({ message_type, id, messages }: {
     message_type: 'private' | 'group';
     id: number;
     messages: string;
-  }) {
-    const endpoint = getEndpoint(endpoint_id);
+  }, context) {
+    const endpoint = context.$client;
     const nodes = typeof messages === 'string' ? JSON.parse(messages) : messages;
     return endpoint.sendForwardMsg(message_type, id, nodes);
   },

package/agent/tools/send_group_notice.ts

@@ -1,22 +1,20 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number; content: string; image?: string }>({
+export default defineAgentTool<{ group_id: number; content: string; image?: string }>({
   description: '发送群公告。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
     content: z.string().describe('公告内容'),
     image: z.string().optional().describe('图片（URL 或 base64，可选）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['群公告', 'notice', '公告', '发公告'],
   permissions: ['platform(napcat,scene_admin)'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id, content, image }: { endpoint_id: string; group_id: number; content: string; image?: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ group_id, content, image }: { group_id: number; content: string; image?: string }, context) {
+    const endpoint = context.$client;
       await endpoint.sendGroupNotice(group_id, content, image);
       return { success: true };
   },

package/agent/tools/send_like.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; user_id: number; times?: number }>({
+export default defineAgentTool<{ user_id: number; times?: number }>({
   description: '给好友点赞（每人每天最多 10 次）。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     user_id: z.number().describe('目标 QQ 号'),
     times: z.number().optional().describe('点赞次数（1-10）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['点赞', 'like', '赞', '好友赞'],
-  async execute({ endpoint_id, user_id, times }: { endpoint_id: string; user_id: number; times?: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ user_id, times }: { user_id: number; times?: number }, context) {
+    const endpoint = context.$client;
       await endpoint.sendLike(user_id, times || 1);
       return { success: true, message: `已给 ${user_id} 点赞 ${times || 1} 次` };
   },

package/agent/tools/send_poke.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; user_id: number; group_id?: number }>({
+export default defineAgentTool<{ user_id: number; group_id?: number }>({
   description: '戳一戳（群聊或私聊）。group_id 不传时为私聊戳一戳。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     user_id: z.number().describe('目标用户 QQ 号'),
     group_id: z.number().optional().describe('群号（不传则为私聊戳一戳）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['戳一戳', 'poke', '戳', '拍一拍'],
-  async execute({ endpoint_id, user_id, group_id }: { endpoint_id: string; user_id: number; group_id?: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ user_id, group_id }: { user_id: number; group_id?: number }, context) {
+    const endpoint = context.$client;
       await endpoint.sendPoke(user_id, group_id);
       return { success: true, message: `已戳 ${user_id}` };
   },

package/agent/tools/set_avatar.ts

@@ -1,18 +1,16 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; file: string }>({
+export default defineAgentTool<{ file: string }>({
   description: '修改 QQ 头像。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     file: z.string().describe('图片（URL 或 base64）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['头像', 'avatar', '设置头像', '换头像'],
-  async execute({ endpoint_id, file }: { endpoint_id: string; file: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ file }: { file: string }, context) {
+    const endpoint = context.$client;
       await endpoint.setQQAvatar(file);
       return { success: true };
   },

package/agent/tools/set_emoji_reaction.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; message_id: number; emoji_id: string }>({
+export default defineAgentTool<{ message_id: number; emoji_id: string }>({
   description: '为消息添加表情回应（贴表情）。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     message_id: z.number().describe('消息 ID'),
     emoji_id: z.string().describe('表情 ID'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['表情回应', 'reaction', '贴表情', 'emoji'],
-  async execute({ endpoint_id, message_id, emoji_id }: { endpoint_id: string; message_id: number; emoji_id: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ message_id, emoji_id }: { message_id: number; emoji_id: string }, context) {
+    const endpoint = context.$client;
       await endpoint.setMsgEmojiLike(message_id, emoji_id);
       return { success: true };
   },

package/agent/tools/set_essence_msg.ts

@@ -1,20 +1,18 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; message_id: number }>({
+export default defineAgentTool<{ message_id: number }>({
   description: '设置群精华消息。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     message_id: z.number().describe('消息 ID'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['精华', 'essence', '设精', '加精'],
   permissions: ['platform(napcat,scene_admin)'],
   scopes: ['group'],
-  async execute({ endpoint_id, message_id }: { endpoint_id: string; message_id: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ message_id }: { message_id: number }, context) {
+    const endpoint = context.$client;
       await endpoint.setEssenceMsg(message_id);
       return { success: true };
   },

package/agent/tools/set_group_portrait.ts

@@ -1,21 +1,19 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number; file: string }>({
+export default defineAgentTool<{ group_id: number; file: string }>({
   description: '设置群头像。file 为图片 URL 或 base64。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
     file: z.string().describe('图片（URL 或 base64）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['群头像', 'group portrait', '设置群头像'],
   permissions: ['platform(napcat,scene_admin)'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id, file }: { endpoint_id: string; group_id: number; file: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ group_id, file }: { group_id: number; file: string }, context) {
+    const endpoint = context.$client;
       await endpoint.setGroupPortrait(group_id, file);
       return { success: true };
   },

package/agent/tools/set_online_status.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; status: number; ext_status?: number }>({
+export default defineAgentTool<{ status: number; ext_status?: number }>({
   description: '设置在线状态（在线、隐身、忙碌等）。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     status: z.number().describe('状态码（11=在线, 21=离开, 31=隐身, 41=忙碌, 50=请勿打扰, 60=Q我吧）'),
     ext_status: z.number().optional().describe('扩展状态码'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['在线状态', '隐身', '忙碌', 'online', 'status'],
-  async execute({ endpoint_id, status, ext_status }: { endpoint_id: string; status: number; ext_status?: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ status, ext_status }: { status: number; ext_status?: number }, context) {
+    const endpoint = context.$client;
       await endpoint.setOnlineStatus(status, ext_status || 0);
       return { success: true };
   },

package/agent/tools/set_profile.ts

@@ -1,22 +1,20 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; nickname: string; company?: string; email?: string; college?: string; personal_note?: string }>({
+export default defineAgentTool<{ nickname: string; company?: string; email?: string; college?: string; personal_note?: string }>({
   description: '修改 QQ 资料（昵称等）。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     nickname: z.string().describe('昵称'),
     company: z.string().optional().describe('公司（可选）'),
     email: z.string().optional().describe('邮箱（可选）'),
     college: z.string().optional().describe('学校（可选）'),
     personal_note: z.string().optional().describe('个人说明（可选）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['修改资料', '设置昵称', 'profile', 'set profile'],
-  async execute({ endpoint_id, nickname, company, email, college, personal_note }: { endpoint_id: string; nickname: string; company?: string; email?: string; college?: string; personal_note?: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ nickname, company, email, college, personal_note }: { nickname: string; company?: string; email?: string; college?: string; personal_note?: string }, context) {
+    const endpoint = context.$client;
       await endpoint.setQQProfile(nickname, company, email, college, personal_note);
       return { success: true };
   },

package/agent/tools/set_signature.ts

@@ -1,18 +1,16 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; signature: string }>({
+export default defineAgentTool<{ signature: string }>({
   description: '设置个人签名（个性签名）。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     signature: z.string().describe('签名内容'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['签名', '个性签名', 'signature', 'longnick'],
-  async execute({ endpoint_id, signature }: { endpoint_id: string; signature: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ signature }: { signature: string }, context) {
+    const endpoint = context.$client;
       await endpoint.setSelfLongnick(signature);
       return { success: true };
   },

package/agent/tools/set_title.ts

@@ -1,22 +1,20 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number; title: string }>({
+export default defineAgentTool<{ group_id: number; user_id: number; title: string }>({
   description: '设置群成员专属头衔。需要群主权限。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
     user_id: z.number().describe('目标成员 QQ 号'),
     title: z.string().describe('头衔文字'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['头衔', 'title', '专属头衔', '设置头衔'],
   permissions: ['platform(napcat,scene_owner)'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id, user_id, title }: { endpoint_id: string; group_id: number; user_id: number; title: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ group_id, user_id, title }: { group_id: number; user_id: number; title: string }, context) {
+    const endpoint = context.$client;
       await endpoint.setTitle(group_id, user_id, title);
       return { success: true, message: `已设置 ${user_id} 头衔为 "${title}"` };
   },

package/agent/tools/translate.ts

@@ -1,18 +1,16 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; text: string }>({
+export default defineAgentTool<{ text: string }>({
   description: '英译中翻译。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     text: z.string().describe('要翻译的英文文本'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['翻译', 'translate', '英译中'],
-  async execute({ endpoint_id, text }: { endpoint_id: string; text: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ text }: { text: string }, context) {
+    const endpoint = context.$client;
       return endpoint.translateEn2Zh(text);
   },
 });

package/agent/tools/upload_group_file.ts

@@ -1,22 +1,20 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number; file: string; name: string; folder?: string }>({
+export default defineAgentTool<{ group_id: number; file: string; name: string; folder?: string }>({
   description: '上传文件到群。file 为本地路径或 URL。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
     file: z.string().describe('文件路径或 URL'),
     name: z.string().describe('文件名'),
     folder: z.string().optional().describe('目标文件夹 ID（可选）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['上传文件', 'upload file', '群文件'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id, file, name, folder }: { endpoint_id: string; group_id: number; file: string; name: string; folder?: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ group_id, file, name, folder }: { group_id: number; file: string; name: string; folder?: string }, context) {
+    const endpoint = context.$client;
       await endpoint.uploadGroupFile(group_id, file, name, folder);
       return { success: true };
   },

package/lib/{napcat-agent-deps.d.ts → client.d.ts}

@@ -1,9 +1,9 @@
-/**
- * Agent tool deps for napcat.
- * Endpoints register themselves on start; tools look up by config name / endpoint id.
- */
-export interface NapcatAgentEndpoint {
-    callApi(action: string, params?: Record<string, unknown>): Promise<unknown>;
+import type { NapCatEvent } from './protocol.js';
+export type NapcatApiCall = (action: string, params?: Record<string, unknown>) => Promise<unknown>;
+/** Transport-independent NapCat protocol Client produced by every Endpoint mode. */
+export declare class NapcatClient {
+    readonly callApi: NapcatApiCall;
+    constructor(callApi: NapcatApiCall);
     setTitle(groupId: number, userId: number, title: string, duration?: number): Promise<boolean>;
     sendLike(userId: number, times?: number): Promise<unknown>;
     deleteFriend(userId: number): Promise<unknown>;
@@ -40,12 +40,13 @@ export interface NapcatAgentEndpoint {
     getAiCharacters(groupId: number): Promise<unknown>;
     sendGroupAiRecord(groupId: number, characterId: string, text: string): Promise<unknown>;
 }
-export interface NapcatAgentDeps {
-    getEndpoint: (endpointKey: string) => NapcatAgentEndpoint;
+export type NapcatClientEventMap = Record<string, NapCatEvent>;
+declare module '@zhin.js/feature-kit' {
+    interface AdapterClientRegistry {
+        readonly napcat: {
+            readonly client: NapcatClient;
+            readonly events: NapcatClientEventMap;
+        };
+    }
 }
-export declare function registerNapcatAgentEndpoint(endpointKey: string, endpoint: NapcatAgentEndpoint): () => void;
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export declare function setNapcatAgentDeps(deps: NapcatAgentDeps | null): void;
-export declare function getNapcatAgentDeps(): NapcatAgentDeps;
-/** Convenience for agent/tools (unchanged call sites). */
-export declare function getEndpoint(endpointKey: string): NapcatAgentEndpoint;
+export declare const napcatClient: import("@zhin.js/adapter").EndpointClientToken<NapcatClient, NapcatClientEventMap>;

package/lib/client.js

@@ -0,0 +1,62 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+/** Transport-independent NapCat protocol Client produced by every Endpoint mode. */
+export class NapcatClient {
+    callApi;
+    constructor(callApi) {
+        this.callApi = callApi;
+    }
+    async setTitle(groupId, userId, title, duration = -1) {
+        await this.callApi('set_group_special_title', {
+            group_id: groupId,
+            user_id: userId,
+            special_title: title,
+            duration,
+        });
+        return true;
+    }
+    sendLike(userId, times = 1) { return this.callApi('send_like', { user_id: userId, times }); }
+    deleteFriend(userId) { return this.callApi('delete_friend', { user_id: userId }); }
+    markMsgAsRead(messageId) { return this.callApi('mark_msg_as_read', { message_id: messageId }); }
+    ocrImage(image) { return this.callApi('ocr_image', { image }); }
+    setQQProfile(nickname, company, email, college, personalNote) {
+        return this.callApi('set_qq_profile', { nickname, company, email, college, personal_note: personalNote });
+    }
+    setGroupPortrait(groupId, file) { return this.callApi('set_group_portrait', { group_id: groupId, file }); }
+    setEssenceMsg(messageId) { return this.callApi('set_essence_msg', { message_id: messageId }); }
+    deleteEssenceMsg(messageId) { return this.callApi('delete_essence_msg', { message_id: messageId }); }
+    getEssenceMsgList(groupId) { return this.callApi('get_essence_msg_list', { group_id: groupId }); }
+    sendGroupSign(groupId) { return this.callApi('send_group_sign', { group_id: groupId }); }
+    sendGroupNotice(groupId, content, image) { return this.callApi('_send_group_notice', { group_id: groupId, content, image }); }
+    getGroupNotice(groupId) { return this.callApi('_get_group_notice', { group_id: groupId }); }
+    deleteGroupNotice(groupId, noticeId) { return this.callApi('_del_group_notice', { group_id: groupId, notice_id: noticeId }); }
+    uploadGroupFile(groupId, file, name, folder) { return this.callApi('upload_group_file', { group_id: groupId, file, name, folder }); }
+    getGroupRootFiles(groupId) { return this.callApi('get_group_root_files', { group_id: groupId }); }
+    getGroupFileUrl(groupId, fileId, busid) { return this.callApi('get_group_file_url', { group_id: groupId, file_id: fileId, busid }); }
+    downloadFile(url, threadCount = 1, headers) { return this.callApi('download_file', { url, thread_count: threadCount, headers }); }
+    setOnlineStatus(status, extStatus) { return this.callApi('set_online_status', { status, ext_status: extStatus }); }
+    setQQAvatar(file) { return this.callApi('set_qq_avatar', { file }); }
+    forwardFriendSingleMsg(userId, messageId) { return this.callApi('forward_friend_single_msg', { user_id: userId, message_id: messageId }); }
+    forwardGroupSingleMsg(groupId, messageId) { return this.callApi('forward_group_single_msg', { group_id: groupId, message_id: messageId }); }
+    translateEn2Zh(sourceText) { return this.callApi('translate_en2zh', { source_text: sourceText }); }
+    setMsgEmojiLike(messageId, emojiId) { return this.callApi('set_msg_emoji_like', { message_id: messageId, emoji_id: emojiId }); }
+    sendForwardMsg(messageType, id, messages) {
+        return this.callApi('send_forward_msg', {
+            message_type: messageType,
+            [messageType === 'group' ? 'group_id' : 'user_id']: id,
+            messages,
+        });
+    }
+    getFriendMsgHistory(userId, messageSeq, count) { return this.callApi('get_friend_msg_history', { user_id: userId, message_seq: messageSeq, count }); }
+    getGroupMsgHistory(groupId, messageSeq, count) { return this.callApi('get_group_msg_history', { group_id: groupId, message_seq: messageSeq, count }); }
+    setSelfLongnick(longnick) { return this.callApi('set_self_longnick', { longNick: longnick }); }
+    getGroupInfoEx(groupId) { return this.callApi('get_group_info_ex', { group_id: groupId }); }
+    sendPoke(userId, groupId) { return this.callApi('send_poke', { user_id: userId, group_id: groupId }); }
+    ncGetUserStatus(userId) { return this.callApi('nc_get_user_status', { user_id: userId }); }
+    getGroupShutList(groupId) { return this.callApi('get_group_shut_list', { group_id: groupId }); }
+    getMiniAppArk(type, title, desc, picUrl, jumpUrl) { return this.callApi('get_mini_app_ark', { type, title, desc, picUrl, jumpUrl }); }
+    getAiCharacters(groupId) { return this.callApi('get_ai_characters', { group_id: groupId }); }
+    sendGroupAiRecord(groupId, characterId, text) {
+        return this.callApi('send_group_ai_record', { group_id: groupId, character: characterId, text });
+    }
+}
+export const napcatClient = defineEndpointClient('napcat');

package/lib/http-endpoint.d.ts

@@ -1,18 +1,18 @@
-import { type EndpointControl, type EndpointInstance, type EndpointManagement, type EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
+import { Endpoint } from 'zhin.js/adapter';
+import { type EndpointControl, type EndpointManagement, type EndpointSendRequest } from 'zhin.js/adapter';
 import type { HttpHost } from '@zhin.js/host-http';
 import type { CapabilityId } from 'zhin.js';
 import { callNapCatHttpAction, type NapCatEvent, type NapCatHttpConfig } from './protocol.js';
+import { NapcatClient } from './client.js';
 export interface NapCatHttpEndpointOptions {
     readonly id: CapabilityId;
-    readonly gateway: MessageGateway;
-    readonly sideEvents?: SideEventGateway;
     readonly http: HttpHost;
     readonly config: NapCatHttpConfig;
     readonly callHttpAction?: typeof callNapCatHttpAction;
 }
-export declare class NapCatHttpEndpoint implements EndpointInstance {
+export declare class NapCatHttpEndpoint extends Endpoint<NapcatClient> {
     #private;
+    readonly client: NapcatClient;
     readonly management: EndpointManagement;
     readonly control: EndpointControl;
     readonly content: import("@zhin.js/adapter").EndpointContentPort;
@@ -23,6 +23,5 @@ export declare class NapCatHttpEndpoint implements EndpointInstance {
     stop(): Promise<void>;
     send({ conversation, payload }: EndpointSendRequest): Promise<string>;
     recallMessage(messageId: string): Promise<void>;
-    callApi(action: string, params?: Record<string, unknown>): Promise<unknown>;
     admit(ev: NapCatEvent): void;
 }