@zhin.js/adapter-napcat 0.1.0

package/lib/bot-http.d.ts

@@ -0,0 +1,22 @@
+/**
+ * NapCat HTTP 连接方式
+ * 出站：HTTP POST 调用 NapCat API
+ * 入站：挂载 webhook 路由接收 NapCat 的 HTTP POST 事件上报
+ */
+import { NapCatBotBase } from './bot-base.js';
+import type { NapCatHttpConfig } from './types.js';
+import type { NapCatAdapter } from './adapter.js';
+import type { Router } from '@zhin.js/http';
+export declare class NapCatHttpBot extends NapCatBotBase {
+    router: Router;
+    private pollTimer?;
+    $config: NapCatHttpConfig;
+    constructor(adapter: NapCatAdapter, router: Router, config: NapCatHttpConfig);
+    $connect(): Promise<void>;
+    $disconnect(): Promise<void>;
+    callApi<T = any>(action: string, params?: Record<string, any>): Promise<T>;
+    private mountWebhook;
+    private checkConnection;
+    private startPoll;
+}
+//# sourceMappingURL=bot-http.d.ts.map

package/lib/bot-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-http.d.ts","sourceRoot":"","sources":["../src/bot-http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C,qBAAa,aAAc,SAAQ,aAAa;IAKH,MAAM,EAAE,MAAM;IAJzD,OAAO,CAAC,SAAS,CAAC,CAAiB;IAE3B,OAAO,EAAE,gBAAgB,CAAC;gBAEtB,OAAO,EAAE,aAAa,EAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB;IAI7E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAcpF,OAAO,CAAC,YAAY;YAqBN,eAAe;IAQ7B,OAAO,CAAC,SAAS;CAWlB"}

package/lib/bot-http.js

@@ -0,0 +1,95 @@
+/**
+ * NapCat HTTP 连接方式
+ * 出站：HTTP POST 调用 NapCat API
+ * 入站：挂载 webhook 路由接收 NapCat 的 HTTP POST 事件上报
+ */
+import { NapCatBotBase } from './bot-base.js';
+import * as crypto from 'crypto';
+export class NapCatHttpBot extends NapCatBotBase {
+    router;
+    pollTimer;
+    constructor(adapter, router, config) {
+        super(adapter, config);
+        this.router = router;
+    }
+    async $connect() {
+        this.mountWebhook();
+        await this.checkConnection();
+        this.startPoll();
+        this.$connected = true;
+        this.logger.info(`${this.$id} HTTP mode started (api: ${this.$config.http_url}, post: ${this.$config.post_path})`);
+    }
+    async $disconnect() {
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = undefined;
+        }
+        this.$connected = false;
+    }
+    async callApi(action, params = {}) {
+        const url = `${this.$config.http_url.replace(/\/$/, '')}/${action}`;
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.$config.access_token)
+            headers['Authorization'] = `Bearer ${this.$config.access_token}`;
+        const resp = await fetch(url, { method: 'POST', headers, body: JSON.stringify(params) });
+        if (!resp.ok)
+            throw new Error(`HTTP ${resp.status} ${resp.statusText} for ${action}`);
+        const json = await resp.json();
+        if (json.status !== 'ok' && json.retcode !== 0) {
+            throw new Error(`API error [${json.retcode}]: ${json.message || json.wording || 'unknown'}`);
+        }
+        return json.data;
+    }
+    mountWebhook() {
+        const postPath = this.$config.post_path;
+        this.router.post(postPath, async (ctx) => {
+            const body = ctx.request.body;
+            if (!body || typeof body !== 'object') {
+                ctx.status = 400;
+                ctx.body = { error: 'invalid body' };
+                return;
+            }
+            if (this.$config.access_token) {
+                const sig = ctx.headers['x-signature'];
+                if (sig) {
+                    const expected = 'sha1=' + crypto.createHmac('sha1', this.$config.access_token).update(JSON.stringify(body)).digest('hex');
+                    if (sig !== expected) {
+                        ctx.status = 403;
+                        ctx.body = { error: 'signature mismatch' };
+                        return;
+                    }
+                }
+            }
+            ctx.status = 204;
+            ctx.body = '';
+            try {
+                this.dispatchEvent(body);
+            }
+            catch (e) {
+                this.logger.warn(`${this.$id} HTTP event dispatch error: ${e}`);
+            }
+        });
+        this.logger.info(`${this.$id} webhook mounted at ${postPath}`);
+    }
+    async checkConnection() {
+        try {
+            await this.callApi('get_login_info');
+        }
+        catch (e) {
+            throw new Error(`${this.$id} cannot connect to NapCat HTTP API at ${this.$config.http_url}: ${e}`);
+        }
+    }
+    startPoll() {
+        const interval = this.$config.poll_interval || 30000;
+        this.pollTimer = setInterval(async () => {
+            try {
+                await this.callApi('get_status');
+            }
+            catch {
+                this.$connected = false;
+                this.logger.warn(`${this.$id} HTTP heartbeat failed, marking as disconnected`);
+            }
+        }, interval);
+    }
+}
+//# sourceMappingURL=bot-http.js.map

package/lib/bot-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-http.js","sourceRoot":"","sources":["../src/bot-http.ts"],"names":[],"mappings":"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"}

package/lib/bot-ws-client.d.ts

@@ -0,0 +1,19 @@
+import { NapCatBotBase } from './bot-base.js';
+import type { NapCatWsClientConfig } from './types.js';
+import type { NapCatAdapter } from './adapter.js';
+export declare class NapCatWsClient extends NapCatBotBase {
+    private ws?;
+    private reconnectTimer?;
+    private heartbeatTimer?;
+    private requestId;
+    private pendingRequests;
+    $config: NapCatWsClientConfig;
+    constructor(adapter: NapCatAdapter, config: NapCatWsClientConfig);
+    $connect(): Promise<void>;
+    $disconnect(): Promise<void>;
+    callApi<T = any>(action: string, params?: Record<string, any>): Promise<T>;
+    private handleWsMessage;
+    private startHeartbeat;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=bot-ws-client.d.ts.map

package/lib/bot-ws-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-ws-client.d.ts","sourceRoot":"","sources":["../src/bot-ws-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAe,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,qBAAa,cAAe,SAAQ,aAAa;IAC/C,OAAO,CAAC,EAAE,CAAC,CAAY;IACvB,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAIlB;IAEG,OAAO,EAAE,oBAAoB,CAAC;gBAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB;IAI1D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAUpF,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;CAQ1B"}

package/lib/bot-ws-client.js

@@ -0,0 +1,120 @@
+/**
+ * NapCat 正向 WebSocket 连接
+ */
+import WebSocket from 'ws';
+import { NapCatBotBase } from './bot-base.js';
+export class NapCatWsClient extends NapCatBotBase {
+    ws;
+    reconnectTimer;
+    heartbeatTimer;
+    requestId = 0;
+    pendingRequests = new Map();
+    constructor(adapter, config) {
+        super(adapter, config);
+    }
+    async $connect() {
+        return new Promise((resolve, reject) => {
+            const headers = {};
+            let url = this.$config.url;
+            if (this.$config.access_token) {
+                headers['Authorization'] = `Bearer ${this.$config.access_token}`;
+                const u = new URL(url);
+                u.searchParams.set('access_token', this.$config.access_token);
+                url = u.toString();
+            }
+            this.ws = new WebSocket(url, { headers });
+            this.ws.on('open', () => {
+                this.$connected = true;
+                if (!this.$config.access_token)
+                    this.logger.warn(`[${this.$id}] missing 'access_token', connection is not secure`);
+                this.logger.info(`${this.$id} connected (WS forward: ${this.$config.url})`);
+                this.startHeartbeat();
+                resolve();
+            });
+            this.ws.on('message', (data) => {
+                try {
+                    this.handleWsMessage(JSON.parse(data.toString()));
+                }
+                catch (error) {
+                    this.emit('error', error);
+                }
+            });
+            this.ws.on('close', (code, reason) => {
+                this.$connected = false;
+                const reasonStr = reason?.toString?.() || '';
+                const codeHint = code === 1005 ? ' [no status]' : code === 1006 ? ' [abnormal]' : '';
+                this.logger.warn(`${this.$id} disconnected (code=${code}${codeHint}${reasonStr ? `, reason=${reasonStr}` : ''}), reconnecting in ${this.$config.reconnect_interval || 5000}ms`);
+                reject({ code, reason });
+                this.scheduleReconnect();
+            });
+            this.ws.on('error', (error) => {
+                this.logger.warn(`${this.$id} WS error: ${error instanceof Error ? error.message : String(error)}`);
+                reject(error);
+            });
+        });
+    }
+    async $disconnect() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+        for (const [, req] of this.pendingRequests) {
+            clearTimeout(req.timeout);
+            req.reject(new Error('Connection closed'));
+        }
+        this.pendingRequests.clear();
+        if (this.ws) {
+            this.ws.close();
+            this.ws = undefined;
+        }
+        this.$connected = false;
+    }
+    async callApi(action, params = {}) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN)
+            throw new Error('WebSocket is not connected');
+        const echo = `req_${++this.requestId}`;
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => { this.pendingRequests.delete(echo); reject(new Error(`API call timeout: ${action}`)); }, 30000);
+            this.pendingRequests.set(echo, { resolve, reject, timeout });
+            this.ws.send(JSON.stringify({ action, params, echo }));
+        });
+    }
+    handleWsMessage(message) {
+        if (message.echo && this.pendingRequests.has(message.echo)) {
+            const req = this.pendingRequests.get(message.echo);
+            this.pendingRequests.delete(message.echo);
+            clearTimeout(req.timeout);
+            const resp = message;
+            if (resp.status === 'ok')
+                return req.resolve(resp.data);
+            return req.reject(new Error(`API error [${resp.retcode}]: ${resp.message || resp.wording || 'unknown'}`));
+        }
+        this.dispatchEvent(message);
+    }
+    startHeartbeat() {
+        const interval = this.$config.heartbeat_interval || 30000;
+        this.heartbeatTimer = setInterval(() => {
+            if (this.ws && this.ws.readyState === WebSocket.OPEN)
+                this.ws.ping();
+        }, interval);
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        const interval = this.$config.reconnect_interval || 5000;
+        this.reconnectTimer = setTimeout(async () => {
+            this.reconnectTimer = undefined;
+            try {
+                await this.$connect();
+            }
+            catch {
+                this.scheduleReconnect();
+            }
+        }, interval);
+    }
+}
+//# sourceMappingURL=bot-ws-client.js.map

package/lib/bot-ws-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-ws-client.js","sourceRoot":"","sources":["../src/bot-ws-client.ts"],"names":[],"mappings":"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"}

package/lib/bot-ws-server.d.ts

@@ -0,0 +1,20 @@
+import { NapCatBotBase } from './bot-base.js';
+import type { NapCatWsServerConfig } from './types.js';
+import type { NapCatAdapter } from './adapter.js';
+import type { Router } from '@zhin.js/http';
+export declare class NapCatWsServer extends NapCatBotBase {
+    #private;
+    router: Router;
+    private heartbeatTimer?;
+    private requestId;
+    private pendingRequests;
+    $config: NapCatWsServerConfig;
+    constructor(adapter: NapCatAdapter, router: Router, config: NapCatWsServerConfig);
+    $connect(): Promise<void>;
+    $disconnect(): Promise<void>;
+    callApi<T = any>(action: string, params?: Record<string, any>): Promise<T>;
+    private getFirstSelfId;
+    private handleWsMessage;
+    private startHeartbeat;
+}
+//# sourceMappingURL=bot-ws-server.d.ts.map

package/lib/bot-ws-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-ws-server.d.ts","sourceRoot":"","sources":["../src/bot-ws-server.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAe,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,cAAe,SAAQ,aAAa;;IAaJ,MAAM,EAAE,MAAM;IAVzD,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAIlB;IAEG,OAAO,EAAE,oBAAoB,CAAC;gBAE1B,OAAO,EAAE,aAAa,EAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB;IAIjF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAYpF,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,cAAc;CASvB"}

package/lib/bot-ws-server.js

@@ -0,0 +1,124 @@
+/**
+ * NapCat 反向 WebSocket 连接
+ */
+import WebSocket from 'ws';
+import { NapCatBotBase } from './bot-base.js';
+export class NapCatWsServer extends NapCatBotBase {
+    router;
+    #wss;
+    #clientMap = new Map();
+    heartbeatTimer;
+    requestId = 0;
+    pendingRequests = new Map();
+    constructor(adapter, router, config) {
+        super(adapter, config);
+        this.router = router;
+    }
+    async $connect() {
+        if (!this.$config.access_token)
+            this.logger.warn(`[${this.$id}] missing 'access_token', connection is not secure`);
+        this.#wss = this.router.ws(this.$config.path, {
+            verifyClient: (info) => {
+                const authorization = info.req.headers['authorization'] || '';
+                if (this.$config.access_token && authorization !== `Bearer ${this.$config.access_token}`) {
+                    this.logger.error(`[${this.$id}] auth failed`);
+                    return false;
+                }
+                return true;
+            },
+        });
+        this.logger.info(`${this.$id} WS server started at path: ${this.$config.path}`);
+        this.#wss.on('connection', (client, req) => {
+            this.startHeartbeat();
+            this.logger.info(`${this.$id} client connected: ${req.socket.remoteAddress}`);
+            client.on('error', (err) => this.logger.warn(`${this.$id} WS error: ${err instanceof Error ? err.message : String(err)}`));
+            client.on('close', (code, reason) => {
+                const reasonStr = reason?.toString?.() || '';
+                this.logger.warn(`${this.$id} client disconnected (code=${code}${reasonStr ? `, reason=${reasonStr}` : ''})`);
+                for (const [key, val] of this.#clientMap) {
+                    if (val === client)
+                        this.#clientMap.delete(key);
+                }
+                if (this.#clientMap.size === 0)
+                    this.$connected = false;
+            });
+            client.on('message', (data) => {
+                try {
+                    this.handleWsMessage(client, JSON.parse(data.toString()));
+                }
+                catch (e) {
+                    this.emit('error', e);
+                }
+            });
+        });
+    }
+    async $disconnect() {
+        this.#wss?.close();
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+        for (const [, req] of this.pendingRequests) {
+            clearTimeout(req.timeout);
+            req.reject(new Error('Connection closed'));
+        }
+        this.pendingRequests.clear();
+        this.$connected = false;
+    }
+    async callApi(action, params = {}) {
+        const selfId = this.getFirstSelfId();
+        const client = this.#clientMap.get(selfId);
+        if (!client || client.readyState !== WebSocket.OPEN)
+            throw new Error('WebSocket is not connected');
+        const echo = `req_${++this.requestId}`;
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => { this.pendingRequests.delete(echo); reject(new Error(`API call timeout: ${action}`)); }, 30000);
+            this.pendingRequests.set(echo, { resolve, reject, timeout });
+            client.send(JSON.stringify({ action, params, echo }));
+        });
+    }
+    getFirstSelfId() {
+        const first = this.#clientMap.keys().next().value;
+        if (!first)
+            throw new Error('No NapCat client connected to reverse WS');
+        return first;
+    }
+    handleWsMessage(client, message) {
+        if (message.self_id != null) {
+            const selfIdStr = String(message.self_id);
+            if (!this.#clientMap.has(selfIdStr) || this.#clientMap.get(selfIdStr) !== client) {
+                this.#clientMap.set(selfIdStr, client);
+                if (!this.$connected)
+                    this.$connected = true;
+            }
+        }
+        if (message.echo && this.pendingRequests.has(message.echo)) {
+            const req = this.pendingRequests.get(message.echo);
+            this.pendingRequests.delete(message.echo);
+            clearTimeout(req.timeout);
+            const resp = message;
+            if (resp.status === 'ok')
+                return req.resolve(resp.data);
+            return req.reject(new Error(`API error [${resp.retcode}]: ${resp.message || resp.wording || 'unknown'}`));
+        }
+        if (message.post_type === 'meta_event' && message.sub_type === 'connect') {
+            this.#clientMap.set(String(message.self_id), client);
+            this.$connected = true;
+            this.logger.info(`${this.$id} client ${message.self_id} connected via lifecycle`);
+            return;
+        }
+        this.dispatchEvent(message);
+    }
+    startHeartbeat() {
+        if (this.heartbeatTimer)
+            return;
+        const interval = this.$config.heartbeat_interval || 30000;
+        this.heartbeatTimer = setInterval(() => {
+            for (const client of this.#wss?.clients || []) {
+                if (client.readyState === WebSocket.OPEN)
+                    client.ping();
+            }
+        }, interval);
+    }
+}
+//# sourceMappingURL=bot-ws-server.js.map

package/lib/bot-ws-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-ws-server.js","sourceRoot":"","sources":["../src/bot-ws-server.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,18 @@
+import { NapCatAdapter } from './adapter.js';
+export * from './types.js';
+export { NapCatWsClient } from './bot-ws-client.js';
+export { NapCatWsServer } from './bot-ws-server.js';
+export { NapCatHttpBot } from './bot-http.js';
+export { NapCatAdapter, type NapCatBot } from './adapter.js';
+export { NapCatBotBase } from './bot-base.js';
+declare module 'zhin.js' {
+    namespace Plugin {
+        interface Contexts {
+            router: import('@zhin.js/http').Router;
+        }
+    }
+    interface Adapters {
+        napcat: NapCatAdapter;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,MAAM,CAAC;QACf,UAAU,QAAQ;YAChB,MAAM,EAAE,OAAO,eAAe,EAAE,MAAM,CAAC;SACxC;KACF;IACD,UAAU,QAAQ;QAChB,MAAM,EAAE,aAAa,CAAC;KACvB;CACF"}

package/lib/index.js

@@ -0,0 +1,37 @@
+/**
+ * NapCat 适配器入口
+ * 支持 OneBot11 标准 + go-cqhttp 扩展 + NapCat 独有 API
+ * 连接方式：正向 WS / 反向 WS / HTTP
+ */
+import { usePlugin, createGroupManagementTools } from 'zhin.js';
+import { NapCatAdapter } from './adapter.js';
+import { createNapCatTools } from './tools.js';
+export * from './types.js';
+export { NapCatWsClient } from './bot-ws-client.js';
+export { NapCatWsServer } from './bot-ws-server.js';
+export { NapCatHttpBot } from './bot-http.js';
+export { NapCatAdapter } from './adapter.js';
+export { NapCatBotBase } from './bot-base.js';
+const plugin = usePlugin();
+const { provide, useContext } = plugin;
+provide({
+    name: 'napcat',
+    description: 'NapCatQQ 适配器（OneBot11 + go-cqhttp + NapCat 扩展，正向/反向 WS + HTTP）',
+    mounted: async (p) => {
+        const adapter = new NapCatAdapter(p);
+        await adapter.start();
+        return adapter;
+    },
+    dispose: async (adapter) => {
+        await adapter.stop();
+    },
+});
+useContext('tool', 'napcat', (toolService, napcat) => {
+    const disposers = [];
+    const groupTools = createGroupManagementTools(napcat, 'napcat');
+    disposers.push(...groupTools.map(t => toolService.addTool(t, plugin.name)));
+    const napcatTools = createNapCatTools(napcat);
+    disposers.push(...napcatTools.map(t => toolService.addTool(t, plugin.name)));
+    return () => disposers.forEach(d => d());
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAoD,0BAA0B,EAAoB,MAAM,SAAS,CAAC;AACpI,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAkB,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAa9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AAC3B,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;AAEvC,OAAO,CAAC;IACN,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,gEAAgE;IAC7E,OAAO,EAAE,KAAK,EAAE,CAAS,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE;QACxC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;CAC8B,CAAC,CAAC;AAEnC,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,WAAwB,EAAE,MAAqB,EAAE,EAAE;IAC/E,MAAM,SAAS,GAAmB,EAAE,CAAC;IAErC,MAAM,UAAU,GAAG,0BAA0B,CAC3C,MAAqC,EACrC,QAAQ,CACT,CAAC;IACF,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE5E,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC9C,SAAS,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE7E,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC"}

package/lib/tools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * NapCat 扩展 Tool 注册
+ * 覆盖 go-cqhttp 扩展与 NapCat 独有 API，全部通过 AI Tool 系统暴露。
+ */
+import type { Tool } from 'zhin.js';
+import type { NapCatAdapter } from './adapter.js';
+export declare function createNapCatTools(adapter: NapCatAdapter): Tool[];
+//# sourceMappingURL=tools.d.ts.map

package/lib/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,IAAI,EAAkC,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,cAAc,CAAC;AAkmB7D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,EAAE,CAiBhE"}