@zhin.js/adapter-napcat 1.1.0 → 1.1.3

package/agents/napcat/skills/napcat-messaging/tools/send_forward_msg/index.js

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '发送合并转发消息（群聊或私聊）。messages 为转发节点数组。',
+    inputSchema: z.object({
+        message_type: z.enum(['private', 'group']).describe('private 或 group'),
+        id: z.number().describe('群号或 QQ 号'),
+        messages: z.string().describe('转发节点 JSON（node 数组）'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['合并转发', 'forward', '转发消息'],
+    async execute({ message_type, id, messages }, 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_forward_msg.ts → agents/napcat/skills/napcat-messaging/tools/send_forward_msg/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{

package/agents/napcat/skills/napcat-messaging/tools/send_poke/index.js

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '戳一戳（群聊或私聊）。group_id 不传时为私聊戳一戳。',
+    inputSchema: z.object({
+        user_id: z.number().describe('目标用户 QQ 号'),
+        group_id: z.number().optional().describe('群号（不传则为私聊戳一戳）'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['戳一戳', 'poke', '戳', '拍一拍'],
+    async execute({ user_id, group_id }, context) {
+        const endpoint = context.$client;
+        await endpoint.sendPoke(user_id, group_id);
+        return { success: true, message: `已戳 ${user_id}` };
+    },
+});

package/{agent/tools/send_poke.ts → agents/napcat/skills/napcat-messaging/tools/send_poke/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ user_id: number; group_id?: number }>({

package/agents/napcat/skills/napcat-messaging/tools/set_emoji_reaction/index.js

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '为消息添加表情回应（贴表情）。',
+    inputSchema: z.object({
+        message_id: z.number().describe('消息 ID'),
+        emoji_id: z.string().describe('表情 ID'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['表情回应', 'reaction', '贴表情', 'emoji'],
+    async execute({ message_id, emoji_id }, context) {
+        const endpoint = context.$client;
+        await endpoint.setMsgEmojiLike(message_id, emoji_id);
+        return { success: true };
+    },
+});

package/{agent/tools/set_emoji_reaction.ts → agents/napcat/skills/napcat-messaging/tools/set_emoji_reaction/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ message_id: number; emoji_id: string }>({

package/agents/napcat/system.md

@@ -0,0 +1,3 @@
+# NAPCAT Platform Agent
+
+You are the napcat platform specialist. Interpret requests in the current napcat conversation and load only the narrowest private Skill needed for the task.

package/commands/{endpoint/add/[id].js → napcat/endpoint/add/[id]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { napcatEndpointCommands } from "../../../lib/napcat-endpoint-commands.js";
+import { napcatEndpointCommands } from '../../definition.js';
 export default napcatEndpointCommands.add;

package/commands/napcat/endpoint/add/[id]/index.ts

@@ -0,0 +1,3 @@
+import { napcatEndpointCommands } from '../../definition.js';
+
+export default napcatEndpointCommands.add;

package/{lib/napcat-endpoint-commands.js → commands/napcat/endpoint/definition.js}

@@ -1,10 +1,11 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * `napcat.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ * `napcat endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/napcat/endpoint/ 下的 list / add / remove 直接默认导出这三项。
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { napcatRuntimeStateToken } from './napcat-runtime-state.js';
+import { napcatRuntimeStateToken } from "../../../lib/napcat-runtime-state.js";
 export const napcatEndpointCommands = createEndpointCommands({
     adapterKey: 'napcat',
     adapterDisplayName: 'NapCat',

package/{src/napcat-endpoint-commands.ts → commands/napcat/endpoint/definition.ts}

@@ -1,10 +1,10 @@
 /**
- * `napcat.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ * `napcat endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/napcat/endpoint/ 下的 list / add / remove 直接默认导出这三项。
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { napcatRuntimeStateToken } from './napcat-runtime-state.js';
+import { napcatRuntimeStateToken } from '../../../src/napcat-runtime-state.js';
 
 export const napcatEndpointCommands = createEndpointCommands({
   adapterKey: 'napcat',

package/commands/{endpoint/list.js → napcat/endpoint/list/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { napcatEndpointCommands } from "../../lib/napcat-endpoint-commands.js";
+import { napcatEndpointCommands } from '../definition.js';
 export default napcatEndpointCommands.list;

package/commands/napcat/endpoint/list/index.ts

@@ -0,0 +1,3 @@
+import { napcatEndpointCommands } from '../definition.js';
+
+export default napcatEndpointCommands.list;

package/commands/{endpoint/remove/[id].js → napcat/endpoint/remove/[id]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { napcatEndpointCommands } from "../../../lib/napcat-endpoint-commands.js";
+import { napcatEndpointCommands } from '../../definition.js';
 export default napcatEndpointCommands.remove;

package/commands/napcat/endpoint/remove/[id]/index.ts

@@ -0,0 +1,3 @@
+import { napcatEndpointCommands } from '../../definition.js';
+
+export default napcatEndpointCommands.remove;

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-export { buildSendAction, buildWsConnectOptions, callNapCatHttpAction, formatInboundContent, formatOutboundSegments, getChannelId, isMessageEvent, mediaRefToOneBotFile, napcatInboundConversation, napcatOutboundTarget, 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 { buildSendAction, buildWsConnectOptions, callNapCatHttpAction, formatInboundContent, formatOutboundSegments, getChannelId, isMessageEvent, mediaRefToOneBotFile, napcatInboundConversation, napcatOutboundTarget, resolveNapCatConfig, senderNickname, senderUserId, type MessageSegment, type NapCatActionRequest, type NapCatActionResponse, 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 { napcatClient, type NapcatClient, type NapcatClientEventMap, } from './client.js';
 export { parseOneBotGetMsgResponse } from './onebot-get-msg.js';

package/lib/napcat-runtime-state.js

@@ -1,6 +1,6 @@
 /**
  * NapCat 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `napcat.endpoint` 命令共享（同一 owner generation）。
+ * 由 plugin.ts setup() provide，adapter create 与 `napcat endpoint` 命令共享（同一 owner generation）。
  */
 import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
 export const napcatRuntimeStateToken = defineEndpointRuntimeStateToken('napcat');

package/lib/protocol.d.ts

@@ -3,26 +3,11 @@
  * No legacy Adapter/Endpoint / segment-mapper.
  * Canonicalization is owned by gateway/core before endpoint.send.
  */
-import { type MediaRef } from '@zhin.js/core';
-import type { ConversationRef } from '@zhin.js/im-contract';
-/** Transitional legacy endpoint row (`endpoints[]` with `context: napcat`). */
-export interface NapCatLegacyEndpointRow {
-    readonly context?: string;
+import { type MediaRef, type ConversationRef } from '@zhin.js/im-contract';
+/** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
+export interface NapCatEndpointConfig {
     readonly connection?: 'ws' | 'wss' | 'http';
-    readonly id?: string;
-    readonly access_token?: string;
-    readonly url?: string;
-    readonly path?: string;
-    readonly http_url?: string;
-    readonly post_path?: string;
-    readonly reconnect_interval?: number;
-    readonly heartbeat_interval?: number;
-    readonly poll_interval?: number;
-}
-/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
-export interface NapCatAdapterConfig {
-    readonly connection?: 'ws' | 'wss' | 'http';
-    readonly id?: string;
+    readonly id: string;
     readonly access_token?: string;
     readonly url?: string;
     readonly path?: string;
@@ -31,8 +16,6 @@ export interface NapCatAdapterConfig {
     readonly reconnect_interval?: number;
     readonly heartbeat_interval?: number;
     readonly poll_interval?: number;
-    /** Transitional: legacy root `endpoints[]` with `context: napcat`. */
-    readonly endpoints?: ReadonlyArray<NapCatLegacyEndpointRow>;
 }
 export interface NapCatConfigBase {
     readonly context: 'napcat';
@@ -60,7 +43,6 @@ export interface NapCatHttpConfig extends NapCatConfigBase {
     readonly poll_interval: number;
 }
 export type ResolvedNapCatConfig = NapCatWsConfig | NapCatWssConfig | NapCatHttpConfig;
-export type NapCatEndpointConfig = ResolvedNapCatConfig;
 export interface NapCatSender {
     readonly role?: string;
     readonly nickname?: string;
@@ -114,7 +96,7 @@ export interface ParsedSendTarget {
     readonly message_type: 'private' | 'group';
     readonly id: string;
 }
-export declare function resolveNapCatConfig(config?: NapCatAdapterConfig): ResolvedNapCatConfig;
+export declare function resolveNapCatConfig(config: NapCatEndpointConfig): ResolvedNapCatConfig;
 export declare function isMessageEvent(ev: NapCatEvent): ev is NapCatMessageEvent;
 export declare function getChannelId(ev: NapCatEvent): string;
 /**

package/lib/protocol.js

@@ -3,7 +3,7 @@
  * No legacy Adapter/Endpoint / segment-mapper.
  * Canonicalization is owned by gateway/core before endpoint.send.
  */
-import { isMediaRef } from '@zhin.js/core';
+import { isMediaRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 const logger = getLogger('napcat');
 function normalizeConnection(connection) {
@@ -11,48 +11,36 @@ function normalizeConnection(connection) {
         return connection;
     return 'ws';
 }
-export function resolveNapCatConfig(config = {}) {
-    const entry = config.endpoints?.find((item) => item.context === 'napcat');
-    const connection = normalizeConnection(config.connection ?? entry?.connection);
-    const id = (typeof config.id === 'string' && config.id)
-        || (typeof entry?.id === 'string' && entry.id)
-        || process.env.NAPCAT_BOT_NAME
-        || 'napcat-bot';
-    const access_token = config.access_token ?? entry?.access_token;
+export function resolveNapCatConfig(config) {
+    const connection = normalizeConnection(config.connection);
+    const id = requiredEndpointField(config.id, 'id');
+    const access_token = optionalEndpointField(config.access_token);
     if (connection === 'ws') {
-        const url = config.url ?? entry?.url;
-        if (!url) {
-            throw new TypeError('NapCat connection:ws requires url (plugins.<key>.url or endpoints with context: napcat)');
-        }
+        const url = requiredEndpointField(config.url, 'url');
         return {
             context: 'napcat',
             connection: 'ws',
             id,
             access_token,
             url,
-            reconnect_interval: config.reconnect_interval ?? entry?.reconnect_interval ?? 5000,
-            heartbeat_interval: config.heartbeat_interval ?? entry?.heartbeat_interval ?? 30_000,
+            reconnect_interval: config.reconnect_interval ?? 5000,
+            heartbeat_interval: config.heartbeat_interval ?? 30_000,
         };
     }
     if (connection === 'wss') {
-        const path = config.path ?? entry?.path;
-        if (!path)
-            throw new TypeError('NapCat connection:wss requires path');
+        const path = requiredEndpointField(config.path, 'path');
         return {
             context: 'napcat',
             connection: 'wss',
             id,
             access_token,
             path,
-            heartbeat_interval: config.heartbeat_interval ?? entry?.heartbeat_interval ?? 30_000,
+            heartbeat_interval: config.heartbeat_interval ?? 30_000,
         };
     }
     if (connection === 'http') {
-        const http_url = config.http_url ?? entry?.http_url;
-        const post_path = config.post_path ?? entry?.post_path;
-        if (!http_url || !post_path) {
-            throw new TypeError('NapCat connection:http requires http_url and post_path');
-        }
+        const http_url = requiredEndpointField(config.http_url, 'http_url');
+        const post_path = requiredEndpointField(config.post_path, 'post_path');
         return {
             context: 'napcat',
             connection: 'http',
@@ -60,11 +48,21 @@ export function resolveNapCatConfig(config = {}) {
             access_token,
             http_url,
             post_path,
-            poll_interval: config.poll_interval ?? entry?.poll_interval ?? 30_000,
+            poll_interval: config.poll_interval ?? 30_000,
         };
     }
     throw new TypeError(`Unknown NapCat connection: ${String(connection)}`);
 }
+function requiredEndpointField(value, field) {
+    const resolved = optionalEndpointField(value);
+    if (!resolved) {
+        throw new TypeError(`NapCat endpoint requires a non-empty ${field}`);
+    }
+    return resolved;
+}
+function optionalEndpointField(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
 export function isMessageEvent(ev) {
     return (ev.post_type === 'message' || ev.post_type === 'message_sent')
         && ev.message_id != null;
@@ -112,11 +110,26 @@ export function formatInboundContent(ev) {
             .join('');
     }
     if (typeof ev.message === 'string')
-        return ev.message.replace(/\[CQ:[^\]]+\]/g, '').trim();
+        return stripCqCodes(ev.message).trim();
     return typeof ev.raw_message === 'string'
-        ? ev.raw_message.replace(/\[CQ:[^\]]+\]/g, '').trim()
+        ? stripCqCodes(ev.raw_message).trim()
         : '';
 }
+function stripCqCodes(input) {
+    let result = '';
+    let cursor = 0;
+    while (cursor < input.length) {
+        const start = input.indexOf('[CQ:', cursor);
+        if (start < 0)
+            return result + input.slice(cursor);
+        result += input.slice(cursor, start);
+        const end = input.indexOf(']', start + 4);
+        if (end < 0)
+            return result + input.slice(start);
+        cursor = end + 1;
+    }
+    return result;
+}
 /**
  * 入站 sender 语义：必须是用户 ID（Runtime Message contract）。
  * 显示名走 metadata.nickname，见 senderNickname。

package/lib/wss-endpoint.d.ts

@@ -1,4 +1,7 @@
 import { Endpoint } from 'zhin.js/adapter';
+/**
+ * NapCat reverse WSS endpoint — accepts inbound WebSocket from NapCat.
+ */
 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';

package/lib/wss-endpoint.js

@@ -2,8 +2,7 @@ import { Endpoint } from 'zhin.js/adapter';
 /**
  * NapCat reverse WSS endpoint — accepts inbound WebSocket from NapCat.
  */
-import { clearInterval } from 'node:timers';
-import { createRecallEndpointControl, } from 'zhin.js/adapter';
+import { createEndpointLifecycle, createRecallEndpointControl, } from 'zhin.js/adapter';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { createNapCatEndpointManagement } from './endpoint-management.js';
 import { InboundMessageDeduper, isNapCatBotMentioned, isSelfMessage, normalizeMessage, } from './napcat-inbound.js';
@@ -11,7 +10,7 @@ import { buildSendAction, formatInboundContent, formatOutboundSegments, isMessag
 import { receiveNapCatSideEvent } from './side-event-dispatch.js';
 import { createNapCatContentPort } from './onebot-get-msg.js';
 import { NapcatClient } from './client.js';
-import { callNapCatWsAction, handleNapCatWsMessage, rejectAllPending, startNapCatHeartbeat, } from './ws-transport.js';
+import { callNapCatWsAction, handleNapCatWsMessage, rejectAllPending, } from './ws-transport.js';
 import { verifyNapCatAccessToken } from './wss-auth.js';
 export class NapCatWssEndpoint extends Endpoint {
     client = new NapcatClient((action, params) => this.#callApi(action, params));
@@ -21,9 +20,10 @@ export class NapCatWssEndpoint extends Endpoint {
     management = createNapCatEndpointManagement(this.client);
     control = createRecallEndpointControl((id) => this.recallMessage(id));
     content = createNapCatContentPort((action, params) => this.client.callApi(action, params));
+    #connectionLifecycle;
     #ws;
     #wsRelease;
-    #heartbeatTimer;
+    #connectionTask = Promise.resolve();
     #requestId = { value: 0 };
     #pending = new Map();
     #open = false;
@@ -32,6 +32,10 @@ export class NapCatWssEndpoint extends Endpoint {
         super();
         this.#logger = getAdapterLogger('napcat', options.config.id);
         this.#options = options;
+        this.#connectionLifecycle = createEndpointLifecycle({
+            name: `${options.config.id}:inbound`,
+            reconnect: false,
+        });
     }
     async start() {
         if (this.#started)
@@ -39,7 +43,15 @@ export class NapCatWssEndpoint extends Endpoint {
         this.#started = true;
         const handle = this.#options.http.ws(this.#options.config.path);
         this.#wsRelease = handle.onConnection((connection) => {
-            this.#acceptConnection(connection);
+            this.#connectionTask = this.#connectionTask
+                .then(() => this.#acceptConnection(connection))
+                .catch((error) => {
+                this.#logger.warn(formatCompact({
+                    op: 'wss_connection_failed',
+                    endpoint: this.#options.config.id,
+                    error: error instanceof Error ? error.message : String(error),
+                }));
+            });
         });
         this.#logger.info(formatCompact({
             op: 'listen',
@@ -58,21 +70,11 @@ export class NapCatWssEndpoint extends Endpoint {
         this.#open = false;
         this.#wsRelease?.();
         this.#wsRelease = undefined;
-        if (this.#heartbeatTimer) {
-            clearInterval(this.#heartbeatTimer);
-            this.#heartbeatTimer = undefined;
-        }
+        await this.#connectionTask;
+        await this.#connectionLifecycle.stop();
         rejectAllPending(this.#pending);
         this.#inboundDeduper.clear();
-        if (this.#ws) {
-            try {
-                this.#ws.close();
-            }
-            catch {
-                /* ignore */
-            }
-            this.#ws = undefined;
-        }
+        this.#ws = undefined;
         this.#started = false;
     }
     async send({ conversation, payload }) {
@@ -141,37 +143,44 @@ export class NapCatWssEndpoint extends Endpoint {
             }));
         });
     }
-    #acceptConnection(connection) {
+    async #acceptConnection(connection) {
         if (!verifyNapCatAccessToken(this.#options.config.access_token, connection.request)) {
             connection.socket.close(4003, 'Unauthorized');
             return;
         }
         const socket = connection.socket;
-        if (this.#ws) {
-            try {
-                this.#ws.close();
-            }
-            catch {
-                /* ignore */
-            }
-        }
-        this.#ws = socket;
-        this.#heartbeatTimer = startNapCatHeartbeat(this.#ws, this.#options.config.heartbeat_interval, this.#heartbeatTimer);
-        socket.on('message', (data) => {
-            handleNapCatWsMessage(data, {
-                endpointId: this.#options.config.id,
-                pending: this.#pending,
-                admit: (event) => this.admit(event),
+        await this.#connectionLifecycle.stop();
+        await this.#connectionLifecycle.start(async (lifecycleHandle) => {
+            this.#ws = socket;
+            lifecycleHandle.onForceClose(() => {
+                try {
+                    socket.close();
+                }
+                catch {
+                    /* ignore */
+                }
             });
-        });
-        socket.on('close', () => {
-            if (this.#ws === socket) {
-                this.#ws = undefined;
-                if (this.#heartbeatTimer) {
-                    clearInterval(this.#heartbeatTimer);
-                    this.#heartbeatTimer = undefined;
+            this.#connectionLifecycle.startHeartbeat(() => {
+                try {
+                    socket.ping?.();
+                }
+                catch {
+                    /* ignore */
                 }
-            }
+            }, this.#options.config.heartbeat_interval);
+            socket.on('message', (data) => {
+                this.#connectionLifecycle.notifyHeartbeatAck();
+                handleNapCatWsMessage(data, {
+                    endpointId: this.#options.config.id,
+                    pending: this.#pending,
+                    admit: (event) => this.admit(event),
+                });
+            });
+            socket.on('close', () => {
+                if (this.#ws === socket)
+                    this.#ws = undefined;
+                lifecycleHandle.notifyClosed(new Error('NapCat reverse WebSocket closed'));
+            });
         });
         this.#logger.debug(formatCompact({
             endpoint: this.#options.config.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-napcat",
-  "version": "1.1.0",
+  "version": "1.1.3",
   "description": "Zhin.js NapCat adapter for Plugin Runtime (WebSocket client, OneBot11 + NapCat extensions)",
   "type": "module",
   "main": "./lib/index.js",
@@ -19,9 +19,11 @@
     "schema.json",
     "src",
     "lib",
-    "agent",
+    "tools",
+    "agents",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "PERMITS.md"
   ],
   "keywords": [
     "zhin",
@@ -43,13 +45,16 @@
   },
   "dependencies": {
     "ws": "^8.21.1",
-    "@zhin.js/adapter": "1.1.12",
-    "@zhin.js/core": "1.1.35",
-    "@zhin.js/feature-kit": "1.1.0",
-    "@zhin.js/host-http": "1.1.0",
-    "@zhin.js/im-contract": "1.1.0",
-    "@zhin.js/logger": "1.1.0",
-    "@zhin.js/permission": "1.1.0"
+    "@zhin.js/adapter": "1.1.15",
+    "@zhin.js/agent-feature": "1.1.2",
+    "@zhin.js/core": "1.1.38",
+    "@zhin.js/feature-kit": "1.1.2",
+    "@zhin.js/host-http": "1.1.2",
+    "@zhin.js/im-contract": "1.1.2",
+    "@zhin.js/logger": "1.1.1",
+    "@zhin.js/permission": "1.1.2",
+    "@zhin.js/skill": "1.1.2",
+    "@zhin.js/tool": "1.1.2"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
@@ -57,22 +62,17 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.23",
-    "@zhin.js/host-http": "1.1.0",
-    "zhin.js": "1.1.0"
+    "@zhin.js/host-http": "1.1.2",
+    "zhin.js": "1.1.3"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.12",
-    "@zhin.js/agent": "^1.1.23",
-    "@zhin.js/command": "^1.1.0",
-    "@zhin.js/core": "^1.1.35",
-    "zhin.js": "^1.1.0"
+    "@zhin.js/adapter": "^1.1.15",
+    "@zhin.js/command": "^1.1.2",
+    "@zhin.js/core": "^1.1.38",
+    "zhin.js": "^1.1.3"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/agent": {
-      "optional": true
-    },
     "@zhin.js/command": {
       "optional": true
     },
@@ -109,6 +109,18 @@
       {
         "package": "@zhin.js/command",
         "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/skill",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/agent-feature",
+        "api": "^1.0.0"
       }
     ],
     "plugins": []

package/schema.json

@@ -45,10 +45,11 @@
     },
     "endpoints": {
       "type": "array",
+      "minItems": 1,
       "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（id 必填，其余覆盖顶层）",
       "items": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": false,
         "properties": {
           "master": {
             "type": [
@@ -68,6 +69,14 @@
             },
             "description": "本 endpoint 的 trusted 列表"
           },
+          "connection": {
+            "type": "string",
+            "enum": [
+              "ws",
+              "wss",
+              "http"
+            ]
+          },
           "url": {
             "type": "string",
             "description": "NapCat WebSocket URL (required for connection: ws)"
@@ -88,6 +97,18 @@
             "type": "string",
             "description": "NapCat access token"
           },
+          "reconnect_interval": {
+            "type": "number"
+          },
+          "heartbeat_interval": {
+            "type": "number"
+          },
+          "poll_interval": {
+            "type": "number"
+          },
+          "commandPrefix": {
+            "type": "string"
+          },
           "id": {
             "type": "string",
             "description": "NapCat bot name"