@zhin.js/adapter-napcat 3.0.1 → 4.0.1

package/agent/tools/get_user_status.ts

@@ -0,0 +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; user_id: number }>({
+  description: '获取用户在线状态。',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    user_id: z.number().describe('目标 QQ 号'),
+  }),
+  platforms: ['napcat'],
+  tags: ['napcat', 'qq'],
+  keywords: ['在线状态', '用户状态', 'online status'],
+  async execute({ endpoint_id, user_id }: { endpoint_id: string; user_id: number }) {
+    const endpoint = getEndpoint(endpoint_id);
+      return endpoint.ncGetUserStatus(user_id);
+  },
+});

package/agent/tools/group_sign.ts

@@ -0,0 +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 }>({
+  description: '群签到/群打卡。',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    group_id: z.number().describe('群号'),
+  }),
+  platforms: ['napcat'],
+  tags: ['napcat', 'qq'],
+  keywords: ['签到', '打卡', 'sign', 'check in'],
+  scopes: ['group'],
+  async execute({ endpoint_id, group_id }: { endpoint_id: string; group_id: number }) {
+    const endpoint = getEndpoint(endpoint_id);
+      await endpoint.sendGroupSign(group_id);
+      return { success: true };
+  },
+});

package/agent/tools/mark_msg_as_read.ts

@@ -0,0 +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; message_id: number }>({
+  description: '标记消息为已读。',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    message_id: z.number().describe('消息 ID'),
+  }),
+  platforms: ['napcat'],
+  tags: ['napcat', 'qq'],
+  keywords: ['已读', 'mark read', '标记已读'],
+  async execute({ endpoint_id, message_id }: { endpoint_id: string; message_id: number }) {
+    const endpoint = getEndpoint(endpoint_id);
+      await endpoint.markMsgAsRead(message_id);
+      return { success: true };
+  },
+});

package/agent/tools/ocr_image.ts

@@ -0,0 +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; image: string }>({
+  description: '图片 OCR 文字识别。',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    image: z.string().describe('图片 file 参数（收到消息中的 file 字段或 URL）'),
+  }),
+  platforms: ['napcat'],
+  tags: ['napcat', 'qq'],
+  keywords: ['OCR', '文字识别', '图片识别', 'ocr'],
+  async execute({ endpoint_id, image }: { endpoint_id: string; image: string }) {
+    const endpoint = getEndpoint(endpoint_id);
+      return endpoint.ocrImage(image);
+  },
+});

package/agent/tools/send_forward_msg.ts

@@ -0,0 +1,31 @@
+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'],
+  tags: ['napcat', 'qq'],
+  keywords: ['合并转发', 'forward', '转发消息'],
+  async execute({ endpoint_id, message_type, id, messages }: {
+    endpoint_id: string;
+    message_type: 'private' | 'group';
+    id: number;
+    messages: string;
+  }) {
+    const endpoint = getEndpoint(endpoint_id);
+    const nodes = typeof messages === 'string' ? JSON.parse(messages) : messages;
+    return endpoint.sendForwardMsg(message_type, id, nodes);
+  },
+});

package/agent/tools/send_group_notice.ts

@@ -0,0 +1,23 @@
+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 }>({
+  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'],
+  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);
+      await endpoint.sendGroupNotice(group_id, content, image);
+      return { success: true };
+  },
+});

package/agent/tools/send_like.ts

@@ -0,0 +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; 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'],
+  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);
+      await endpoint.sendLike(user_id, times || 1);
+      return { success: true, message: `已给 ${user_id} 点赞 ${times || 1} 次` };
+  },
+});

package/agent/tools/send_poke.ts

@@ -0,0 +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; 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'],
+  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);
+      await endpoint.sendPoke(user_id, group_id);
+      return { success: true, message: `已戳 ${user_id}` };
+  },
+});

package/agent/tools/set_avatar.ts

@@ -0,0 +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; file: string }>({
+  description: '修改 QQ 头像。',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    file: z.string().describe('图片（URL 或 base64）'),
+  }),
+  platforms: ['napcat'],
+  tags: ['napcat', 'qq'],
+  keywords: ['头像', 'avatar', '设置头像', '换头像'],
+  async execute({ endpoint_id, file }: { endpoint_id: string; file: string }) {
+    const endpoint = getEndpoint(endpoint_id);
+      await endpoint.setQQAvatar(file);
+      return { success: true };
+  },
+});

package/agent/tools/set_emoji_reaction.ts

@@ -0,0 +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; 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'],
+  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);
+      await endpoint.setMsgEmojiLike(message_id, emoji_id);
+      return { success: true };
+  },
+});

package/agent/tools/set_essence_msg.ts

@@ -0,0 +1,21 @@
+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 }>({
+  description: '设置群精华消息。',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    message_id: z.number().describe('消息 ID'),
+  }),
+  platforms: ['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);
+      await endpoint.setEssenceMsg(message_id);
+      return { success: true };
+  },
+});

package/agent/tools/set_group_portrait.ts

@@ -0,0 +1,22 @@
+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 }>({
+  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'],
+  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);
+      await endpoint.setGroupPortrait(group_id, file);
+      return { success: true };
+  },
+});

package/agent/tools/set_online_status.ts

@@ -0,0 +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; 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'],
+  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);
+      await endpoint.setOnlineStatus(status, ext_status || 0);
+      return { success: true };
+  },
+});

package/agent/tools/set_profile.ts

@@ -0,0 +1,23 @@
+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 }>({
+  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'],
+  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);
+      await endpoint.setQQProfile(nickname, company, email, college, personal_note);
+      return { success: true };
+  },
+});

package/agent/tools/set_signature.ts

@@ -0,0 +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; signature: string }>({
+  description: '设置个人签名（个性签名）。',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    signature: z.string().describe('签名内容'),
+  }),
+  platforms: ['napcat'],
+  tags: ['napcat', 'qq'],
+  keywords: ['签名', '个性签名', 'signature', 'longnick'],
+  async execute({ endpoint_id, signature }: { endpoint_id: string; signature: string }) {
+    const endpoint = getEndpoint(endpoint_id);
+      await endpoint.setSelfLongnick(signature);
+      return { success: true };
+  },
+});

package/agent/tools/set_title.ts

@@ -0,0 +1,23 @@
+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 }>({
+  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'],
+  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);
+      await endpoint.setTitle(group_id, user_id, title);
+      return { success: true, message: `已设置 ${user_id} 头衔为 "${title}"` };
+  },
+});

package/agent/tools/translate.ts

@@ -0,0 +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; text: string }>({
+  description: '英译中翻译。',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    text: z.string().describe('要翻译的英文文本'),
+  }),
+  platforms: ['napcat'],
+  tags: ['napcat', 'qq'],
+  keywords: ['翻译', 'translate', '英译中'],
+  async execute({ endpoint_id, text }: { endpoint_id: string; text: string }) {
+    const endpoint = getEndpoint(endpoint_id);
+      return endpoint.translateEn2Zh(text);
+  },
+});

package/agent/tools/upload_group_file.ts

@@ -0,0 +1,23 @@
+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 }>({
+  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'],
+  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);
+      await endpoint.uploadGroupFile(group_id, file, name, folder);
+      return { success: true };
+  },
+});

package/lib/http-endpoint.d.ts

@@ -0,0 +1,26 @@
+import type { EndpointInstance } from '@zhin.js/adapter';
+import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { HttpHost } from '@zhin.js/host-http';
+import type { CapabilityId } from '@zhin.js/plugin-runtime';
+import { callNapCatHttpAction, type NapCatEvent, type NapCatHttpConfig } from './protocol.js';
+export interface NapCatHttpEndpointOptions {
+    readonly id: CapabilityId;
+    readonly gateway: MessageGateway;
+    readonly http: HttpHost;
+    readonly config: NapCatHttpConfig;
+    readonly callHttpAction?: typeof callNapCatHttpAction;
+}
+export declare class NapCatHttpEndpoint implements EndpointInstance {
+    #private;
+    constructor(options: NapCatHttpEndpointOptions);
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ target, payload }: {
+        readonly target: string;
+        readonly payload: unknown;
+    }): Promise<string>;
+    callApi(action: string, params?: Record<string, unknown>): Promise<unknown>;
+    admit(ev: NapCatEvent): void;
+}

package/lib/http-endpoint.js

@@ -0,0 +1,147 @@
+import { formatCompact, getLogger } from '@zhin.js/logger';
+import { registerNapcatAgentEndpoint } from './napcat-agent-deps.js';
+import { InboundMessageDeduper, isNapCatBotMentioned, isSelfMessage, normalizeMessage, } from './napcat-inbound.js';
+import { buildSendAction, callNapCatHttpAction, formatInboundContent, formatInboundTarget, formatOutboundSegments, isMessageEvent, senderNickname, senderUserId, } from './protocol.js';
+import { readRequestBody } from './webhook.js';
+import { verifyNapCatAccessToken } from './wss-auth.js';
+const logger = getLogger('napcat');
+export class NapCatHttpEndpoint {
+    #options;
+    #inboundDeduper = new InboundMessageDeduper();
+    #callHttpAction;
+    #routeReleases = [];
+    #open = false;
+    #started = false;
+    #unregisterAgent;
+    constructor(options) {
+        this.#options = options;
+        this.#callHttpAction = options.callHttpAction ?? callNapCatHttpAction;
+    }
+    async start() {
+        if (this.#started)
+            return;
+        this.#started = true;
+        this.#unregisterAgent = registerNapcatAgentEndpoint(this.#options.config.name, this);
+        this.#setupRoutes();
+        logger.info(formatCompact({
+            op: 'listen',
+            endpoint: this.#options.config.name,
+            mode: 'http',
+            path: this.#options.config.post_path,
+        }));
+    }
+    open() {
+        this.#open = true;
+    }
+    close() {
+        this.#open = false;
+    }
+    async stop() {
+        this.#open = false;
+        for (const release of this.#routeReleases.splice(0))
+            release();
+        this.#unregisterAgent?.();
+        this.#unregisterAgent = undefined;
+        this.#inboundDeduper.clear();
+        this.#started = false;
+        logger.debug(formatCompact({ op: 'disconnect', endpoint: this.#options.config.name }));
+    }
+    async send({ target, payload }) {
+        const message = formatOutboundSegments(payload);
+        const { action, params } = buildSendAction(target, message);
+        const resp = await this.#callHttpAction({
+            http_url: this.#options.config.http_url,
+            access_token: this.#options.config.access_token,
+        }, action, params);
+        const data = resp.data;
+        const messageId = data?.message_id != null ? String(data.message_id) : '';
+        logger.debug(formatCompact({
+            op: 'napcat_send',
+            endpoint: this.#options.config.name,
+            target,
+            messageId,
+        }));
+        return messageId;
+    }
+    callApi(action, params = {}) {
+        return this.#callHttpAction({
+            http_url: this.#options.config.http_url,
+            access_token: this.#options.config.access_token,
+        }, action, params).then((resp) => resp.data);
+    }
+    admit(ev) {
+        if (!this.#open || !isMessageEvent(ev))
+            return;
+        if (isSelfMessage(ev))
+            return;
+        const msgId = String(ev.message_id);
+        if (!this.#inboundDeduper.shouldProcess(msgId))
+            return;
+        if (Array.isArray(ev.message) || typeof ev.message === 'string') {
+            ev = { ...ev, message: normalizeMessage(ev.message) };
+        }
+        const target = formatInboundTarget(ev);
+        const nickname = senderNickname(ev);
+        const mentioned = isNapCatBotMentioned(ev);
+        void this.#options.gateway.receive({
+            adapter: this.#options.id,
+            target,
+            content: formatInboundContent(ev),
+            sender: senderUserId(ev),
+            id: msgId,
+            metadata: Object.freeze({
+                message_type: ev.message_type,
+                user_id: ev.user_id != null ? String(ev.user_id) : undefined,
+                group_id: ev.group_id != null ? String(ev.group_id) : undefined,
+                endpoint: this.#options.config.name,
+                time: ev.time,
+                self_id: ev.self_id != null ? String(ev.self_id) : undefined,
+                role: ev.sender?.role,
+                ...(nickname ? { nickname } : {}),
+                ...(mentioned ? { mentioned: true } : {}),
+            }),
+        }).catch((err) => {
+            logger.warn(formatCompact({
+                op: 'napcat_gateway_receive_failed',
+                target,
+                error: err instanceof Error ? err.message : String(err),
+            }));
+        });
+    }
+    #setupRoutes() {
+        const path = this.#options.config.post_path;
+        this.#routeReleases.push(this.#options.http.route('POST', path, async (request, response) => {
+            await this.#handlePost(request, response);
+        }, { summary: 'NapCat HTTP event callback', tags: ['napcat'] }));
+    }
+    async #handlePost(request, response) {
+        try {
+            if (!verifyNapCatAccessToken(this.#options.config.access_token, request)) {
+                response.writeHead(403, { 'Content-Type': 'application/json' });
+                response.end(JSON.stringify({ message: 'Unauthorized' }));
+                return;
+            }
+            const raw = await readRequestBody(request);
+            let ev;
+            try {
+                ev = JSON.parse(raw);
+            }
+            catch {
+                response.writeHead(400, { 'Content-Type': 'application/json' });
+                response.end(JSON.stringify({ message: 'Invalid JSON' }));
+                return;
+            }
+            if (this.#open)
+                this.admit(ev);
+            response.writeHead(200, { 'Content-Type': 'application/json' });
+            response.end(JSON.stringify({ status: 'ok' }));
+        }
+        catch (error) {
+            logger.error('NapCat HTTP webhook error:', error);
+            if (!response.headersSent) {
+                response.writeHead(500, { 'Content-Type': 'application/json' });
+                response.end(JSON.stringify({ message: 'Internal Server Error' }));
+            }
+        }
+    }
+}

package/lib/index.d.ts

@@ -1,21 +1,11 @@
-import type { Router } from '@zhin.js/host-router';
-import { PageManager } from '@zhin.js/host-api';
-import { NapCatAdapter } from './adapter.js';
-export * from './types.js';
-export { NapCatWsClient } from './endpoint-ws-client.js';
-export { NapCatWsServer } from './endpoint-ws-server.js';
-export { NapCatHttpEndpoint } from './endpoint-http.js';
-export { NapCatAdapter, type NapCatEndpoint } from './adapter.js';
-export { NapCatEndpointBase } from './endpoint-base.js';
-declare module 'zhin.js' {
-    namespace Plugin {
-        interface Contexts {
-            web: PageManager;
-            router: Router;
-        }
-    }
-    interface Adapters {
-        napcat: NapCatAdapter;
-    }
-}
-//# sourceMappingURL=index.d.ts.map
+export { buildSendAction, buildWsConnectOptions, callNapCatHttpAction, formatInboundContent, formatInboundTarget, formatOutboundSegments, getChannelId, isMessageEvent, parseSendTarget, resolveNapCatConfig, senderNickname, senderUserId, type MessageSegment, type NapCatActionRequest, type NapCatActionResponse, type NapCatAdapterConfig, type NapCatConfigBase, type NapCatEndpointConfig, type NapCatEvent, type NapCatHttpConfig, type NapCatMessageEvent, type NapCatSender, type NapCatWireSegment, type NapCatWsConfig, type NapCatWssConfig, type ParsedSendTarget, type ResolvedNapCatConfig, } from './protocol.js';
+export { InboundMessageDeduper, isNapCatBotMentioned, isSelfMessage, normalizeMessage, } from './napcat-inbound.js';
+export { getEndpoint, getNapcatAgentDeps, registerNapcatAgentEndpoint, setNapcatAgentDeps, type NapcatAgentDeps, type NapcatAgentEndpoint, } from './napcat-agent-deps.js';
+export { parseOneBotGetMsgResponse } from './onebot-get-msg.js';
+export { NapCatWsEndpoint, type NapCatWsEndpointOptions, } from './ws-endpoint.js';
+export { NapCatWssEndpoint, type NapCatWssEndpointOptions, } from './wss-endpoint.js';
+export { NapCatHttpEndpoint, type NapCatHttpEndpointOptions, } from './http-endpoint.js';
+export type { NapCatWsSocket, NapCatWsCreateOptions } from './ws-types.js';
+export { callNapCatWsAction, decodeWsPayload, handleNapCatWsMessage, rejectAllPending, startNapCatHeartbeat, } from './ws-transport.js';
+export { verifyNapCatAccessToken } from './wss-auth.js';
+export { readRequestBody } from './webhook.js';