@zhin.js/adapter-napcat 3.0.1 → 4.0.1

package/src/wss-endpoint.ts

@@ -0,0 +1,205 @@
+/**
+ * NapCat reverse WSS endpoint — accepts inbound WebSocket from NapCat.
+ */
+import { clearInterval } from 'node:timers';
+import type { EndpointInstance } from '@zhin.js/adapter';
+import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { HttpHost, WsConnection } from '@zhin.js/host-http';
+import { formatCompact, getLogger } from '@zhin.js/logger';
+import type { CapabilityId } from '@zhin.js/plugin-runtime';
+import { registerNapcatAgentEndpoint } from './napcat-agent-deps.js';
+import {
+  InboundMessageDeduper,
+  isNapCatBotMentioned,
+  isSelfMessage,
+  normalizeMessage,
+} from './napcat-inbound.js';
+import {
+  buildSendAction,
+  formatInboundContent,
+  formatInboundTarget,
+  formatOutboundSegments,
+  isMessageEvent,
+  senderNickname,
+  senderUserId,
+  type NapCatEvent,
+  type NapCatWssConfig,
+} from './protocol.js';
+import {
+  callNapCatWsAction,
+  handleNapCatWsMessage,
+  rejectAllPending,
+  startNapCatHeartbeat,
+} from './ws-transport.js';
+import { NapCatWsEndpoint } from './ws-endpoint.js';
+import {
+  type NapCatPendingAction,
+  type NapCatWsSocket,
+} from './ws-types.js';
+import { verifyNapCatAccessToken } from './wss-auth.js';
+
+const logger = getLogger('napcat');
+
+export interface NapCatWssEndpointOptions {
+  readonly id: CapabilityId;
+  readonly gateway: MessageGateway;
+  readonly http: HttpHost;
+  readonly config: NapCatWssConfig;
+}
+
+export class NapCatWssEndpoint implements EndpointInstance {
+  readonly #options: NapCatWssEndpointOptions;
+  readonly #inboundDeduper = new InboundMessageDeduper();
+  #ws?: NapCatWsSocket;
+  #wsRelease?: () => void;
+  #heartbeatTimer?: NodeJS.Timeout;
+  #requestId = { value: 0 };
+  #pending = new Map<string, NapCatPendingAction>();
+  #open = false;
+  #started = false;
+  #unregisterAgent?: () => void;
+
+  constructor(options: NapCatWssEndpointOptions) {
+    this.#options = options;
+  }
+
+  async start(): Promise<void> {
+    if (this.#started) return;
+    this.#started = true;
+    this.#unregisterAgent = registerNapcatAgentEndpoint(
+      this.#options.config.name,
+      this as unknown as NapCatWsEndpoint,
+    );
+    const handle = this.#options.http.ws(this.#options.config.path);
+    this.#wsRelease = handle.onConnection((connection) => {
+      this.#acceptConnection(connection);
+    });
+    logger.info(formatCompact({
+      op: 'listen',
+      endpoint: this.#options.config.name,
+      mode: 'wss',
+      path: this.#options.config.path,
+    }));
+  }
+
+  open(): void {
+    this.#open = true;
+  }
+
+  close(): void {
+    this.#open = false;
+  }
+
+  async stop(): Promise<void> {
+    this.#open = false;
+    this.#unregisterAgent?.();
+    this.#unregisterAgent = undefined;
+    this.#wsRelease?.();
+    this.#wsRelease = undefined;
+    if (this.#heartbeatTimer) {
+      clearInterval(this.#heartbeatTimer);
+      this.#heartbeatTimer = undefined;
+    }
+    rejectAllPending(this.#pending);
+    this.#inboundDeduper.clear();
+    if (this.#ws) {
+      try {
+        this.#ws.close();
+      } catch {
+        /* ignore */
+      }
+      this.#ws = undefined;
+    }
+    this.#started = false;
+  }
+
+  async send({ target, payload }: { readonly target: string; readonly payload: unknown }): Promise<string> {
+    const message = formatOutboundSegments(payload);
+    const { action, params } = buildSendAction(target, message);
+    const data = await this.callApi(action, params) as { message_id?: number | string } | undefined;
+    return data?.message_id != null ? String(data.message_id) : '';
+  }
+
+  callApi(action: string, params: Record<string, unknown> = {}): Promise<unknown> {
+    return callNapCatWsAction(this.#ws, this.#pending, this.#requestId, action, params);
+  }
+
+  admit(ev: NapCatEvent): void {
+    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),
+      }));
+    });
+  }
+
+  #acceptConnection(connection: WsConnection): void {
+    if (!verifyNapCatAccessToken(this.#options.config.access_token, connection.request)) {
+      connection.socket.close(4003, 'Unauthorized');
+      return;
+    }
+    const socket = connection.socket as unknown as NapCatWsSocket;
+    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, {
+        endpointName: this.#options.config.name,
+        pending: this.#pending,
+        admit: (event) => this.admit(event),
+      });
+    });
+    socket.on('close', () => {
+      if (this.#ws === socket) {
+        this.#ws = undefined;
+        if (this.#heartbeatTimer) {
+          clearInterval(this.#heartbeatTimer);
+          this.#heartbeatTimer = undefined;
+        }
+      }
+    });
+    logger.debug(formatCompact({
+      endpoint: this.#options.config.name,
+      mode: 'wss',
+      peer: connection.request.socket.remoteAddress,
+    }));
+  }
+}

package/client/NapCatManagement.tsx

@@ -1,113 +0,0 @@
-import { useCallback, useEffect, useState } from "react";
-import { Bot, Users, RefreshCw, Wifi, WifiOff, Loader2, Activity } from "lucide-react";
-import { apiFetch } from "./utils/api";
-
-interface EndpointRow {
-  name: string;
-  connected: boolean;
-  connection: string;
-  groupCount: number;
-  friendCount: number;
-  status: string;
-}
-
-export default function NapCatManagement() {
-  const [endpoints, setEndpoints] = useState<EndpointRow[]>([]);
-  const [loading, setLoading] = useState(true);
-  const [err, setErr] = useState<string | null>(null);
-
-  const loadBots = useCallback(async () => {
-    setLoading(true);
-    setErr(null);
-    try {
-      const res = await apiFetch("/api/napcat/endpoints");
-      const json = (await res.json()) as { success?: boolean; data?: EndpointRow[]; message?: string };
-      if (!res.ok || !json.success) throw new Error(json.message || "加载失败");
-      setEndpoints(Array.isArray(json.data) ? json.data : []);
-    } catch (e) {
-      setErr((e as Error).message);
-      setEndpoints([]);
-    } finally {
-      setLoading(false);
-    }
-  }, []);
-
-  useEffect(() => {
-    void loadBots();
-  }, [loadBots]);
-
-  const connectionLabel = (c: string) => {
-    switch (c) {
-      case 'ws': return '正向 WS';
-      case 'wss': return '反向 WS';
-      case 'http': return 'HTTP';
-      default: return c;
-    }
-  };
-
-  return (
-    <div className="p-6 max-w-5xl mx-auto space-y-5">
-      <div className="flex items-center justify-between">
-        <div>
-          <h1 className="text-2xl font-bold flex items-center gap-2">
-            <Bot className="w-6 h-6" /> NapCat 管理
-          </h1>
-          <p className="text-sm text-muted-foreground mt-1">
-            NapCatQQ 机器人概览（OneBot11 + go-cqhttp + NapCat 扩展）
-          </p>
-        </div>
-        <button
-          onClick={loadBots}
-          disabled={loading}
-          className="flex items-center gap-1 px-3 py-1.5 rounded bg-blue-500 text-white hover:bg-blue-600 disabled:opacity-50 text-sm"
-        >
-          <RefreshCw className={`w-4 h-4 ${loading ? "animate-spin" : ""}`} /> 刷新
-        </button>
-      </div>
-
-      {err && (
-        <div className="p-3 bg-red-50 text-red-600 rounded border border-red-200 text-sm dark:bg-red-900/20 dark:text-red-400 dark:border-red-800">
-          {err}
-        </div>
-      )}
-      {loading ? (
-        <div className="flex justify-center py-12">
-          <Loader2 className="w-6 h-6 animate-spin text-blue-500" />
-        </div>
-      ) : endpoints.length === 0 ? (
-        <div className="text-center text-muted-foreground py-12">
-          暂无 NapCat Endpoint 实例
-        </div>
-      ) : (
-        <div className="grid gap-4 md:grid-cols-2">
-          {endpoints.map((endpoint) => (
-            <div key={endpoint.name} className="border rounded-lg p-4 bg-card shadow-sm">
-              <div className="flex items-center justify-between mb-3">
-                <span className="font-medium text-lg">{endpoint.name}</span>
-                {endpoint.connected ? (
-                  <span className="flex items-center gap-1 text-green-600 text-sm">
-                    <Wifi className="w-4 h-4" /> 在线
-                  </span>
-                ) : (
-                  <span className="flex items-center gap-1 text-gray-400 text-sm">
-                    <WifiOff className="w-4 h-4" /> 离线
-                  </span>
-                )}
-              </div>
-              <div className="space-y-2 text-sm text-muted-foreground">
-                <div className="flex items-center gap-1.5">
-                  <Users className="w-3.5 h-3.5" />
-                  群 {endpoint.groupCount} · 好友 {endpoint.friendCount}
-                </div>
-                <div className="flex items-center gap-1.5">
-                  <Activity className="w-3.5 h-3.5" />
-                  连接方式 {connectionLabel(endpoint.connection)} · {endpoint.status}
-                </div>
-              </div>
-            </div>
-          ))}
-        </div>
-      )}
-    </div>
-  );
-}

package/client/index.tsx

@@ -1,11 +0,0 @@
-import type { PluginRegisterHostApi } from '@zhin.js/contract';
-import NapCatManagement from './NapCatManagement';
-
-export function register(api: PluginRegisterHostApi) {
-  api.addRoute({
-    path: '/console/napcat',
-    name: 'NapCat管理',
-    element: api.React.createElement(NapCatManagement, { hostReact: api.React }),
-  });
-  api.addTool({ id: 'napcat', name: 'NapCat', path: '/console/napcat' });
-}

package/client/tsconfig.json

@@ -1,7 +0,0 @@
-{
-  "extends": "../node_modules/@zhin.js/host-api/browser.tsconfig.json",
-  "compilerOptions": {
-    "outDir": "../dist"
-  },
-  "include": ["./**/*"]
-}

package/client/utils/api.ts

@@ -1,30 +0,0 @@
-const TOKEN_KEY = "zhin_api_token";
-const API_BASE_KEY = "zhin_api_base";
-
-export function getApiBase(): string {
-  const stored = localStorage.getItem(API_BASE_KEY)?.trim();
-  if (stored) return stored.replace(/\/$/, "");
-  if (typeof window !== "undefined") return window.location.origin;
-  return "";
-}
-
-export function getToken(): string | null {
-  return localStorage.getItem(TOKEN_KEY);
-}
-
-export async function apiFetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {
-  const token = getToken();
-  const headers = new Headers(init?.headers);
-  if (token) headers.set("Authorization", `Bearer ${token}`);
-
-  const base = getApiBase();
-  const url =
-    typeof input === "string" && input.startsWith("/") ? `${base}${input}` : input;
-
-  const res = await fetch(url, { ...init, headers });
-  if (res.status === 401) {
-    localStorage.removeItem(TOKEN_KEY);
-    window.dispatchEvent(new CustomEvent("zhin:auth-required"));
-  }
-  return res;
-}

package/dist/index.js

@@ -1,27 +0,0 @@
-import{useCallback as ta,useEffect as ua,useState as P}from"react";import{forwardRef as X,createElement as N}from"react";var S=(...a)=>a.filter((e,u,o)=>!!e&&e.trim()!==""&&o.indexOf(e)===u).join(" ").trim();var B=a=>a.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase();var M=a=>a.replace(/^([A-Z])|[\s-_]+(\w)/g,(e,u,o)=>o?o.toUpperCase():u.toLowerCase());var k=a=>{let e=M(a);return e.charAt(0).toUpperCase()+e.slice(1)};import{forwardRef as z,createElement as R}from"react";var g={xmlns:"http://www.w3.org/2000/svg",width:24,height:24,viewBox:"0 0 24 24",fill:"none",stroke:"currentColor",strokeWidth:2,strokeLinecap:"round",strokeLinejoin:"round"};var D=a=>{for(let e in a)if(e.startsWith("aria-")||e==="role"||e==="title")return!0;return!1};import{createContext as W,useContext as E,useMemo as na,createElement as pa}from"react";var V=W({});var F=()=>E(V);var T=z(({color:a,size:e,strokeWidth:u,absoluteStrokeWidth:o,className:s="",children:r,iconNode:i,...h},t)=>{let{size:c=24,strokeWidth:A=2,absoluteStrokeWidth:b=!1,color:U="currentColor",className:O=""}=F()??{},v=o??b?Number(u??A)*24/Number(e??c):u??A;return R("svg",{ref:t,...g,width:e??c??g.width,height:e??c??g.height,stroke:a??U,strokeWidth:v,className:S("lucide",O,s),...!r&&!D(h)&&{"aria-hidden":"true"},...h},[...i.map(([H,G])=>R(H,G)),...Array.isArray(r)?r:[r]])});var d=(a,e)=>{let u=X(({className:o,...s},r)=>N(T,{ref:r,iconNode:e,className:S(`lucide-${B(k(a))}`,`lucide-${a}`,o),...s}));return u.displayName=k(a),u};var K=[["path",{d:"M22 12h-2.48a2 2 0 0 0-1.93 1.46l-2.35 8.36a.25.25 0 0 1-.48 0L9.24 2.18a.25.25 0 0 0-.48 0l-2.35 8.36A2 2 0 0 1 4.49 12H2",key:"169zse"}]],p=d("activity",K);var Z=[["path",{d:"M12 8V4H8",key:"hb8ula"}],["rect",{width:"16",height:"12",x:"4",y:"8",rx:"2",key:"enze0r"}],["path",{d:"M2 14h2",key:"vft8re"}],["path",{d:"M20 14h2",key:"4cs60a"}],["path",{d:"M15 13v2",key:"1xurst"}],["path",{d:"M9 13v2",key:"rq6x2g"}]],L=d("bot",Z);var Q=[["path",{d:"M21 12a9 9 0 1 1-6.219-8.56",key:"13zald"}]],n=d("loader-circle",Q);var J=[["path",{d:"M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8",key:"v9h5vc"}],["path",{d:"M21 3v5h-5",key:"1q7to0"}],["path",{d:"M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16",key:"3uifl3"}],["path",{d:"M8 16H3v5",key:"1cv678"}]],m=d("refresh-cw",J);var _=[["path",{d:"M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2",key:"1yyitq"}],["path",{d:"M16 3.128a4 4 0 0 1 0 7.744",key:"16gr8j"}],["path",{d:"M22 21v-2a4 4 0 0 0-3-3.87",key:"kshegd"}],["circle",{cx:"9",cy:"7",r:"4",key:"nufk8"}]],I=d("users",_);var j=[["path",{d:"M12 20h.01",key:"zekei9"}],["path",{d:"M8.5 16.429a5 5 0 0 1 7 0",key:"1bycff"}],["path",{d:"M5 12.859a10 10 0 0 1 5.17-2.69",key:"1dl1wf"}],["path",{d:"M19 12.859a10 10 0 0 0-2.007-1.523",key:"4k23kn"}],["path",{d:"M2 8.82a15 15 0 0 1 4.177-2.643",key:"1grhjp"}],["path",{d:"M22 8.82a15 15 0 0 0-11.288-3.764",key:"z3jwby"}],["path",{d:"m2 2 20 20",key:"1ooewy"}]],x=d("wifi-off",j);var Y=[["path",{d:"M12 20h.01",key:"zekei9"}],["path",{d:"M2 8.82a15 15 0 0 1 20 0",key:"dnpr2z"}],["path",{d:"M5 12.859a10 10 0 0 1 14 0",key:"1x1e6c"}],["path",{d:"M8.5 16.429a5 5 0 0 1 7 0",key:"1bycff"}]],C=d("wifi",Y);var y="zhin_api_token",$="zhin_api_base";function aa(){let a=localStorage.getItem($)?.trim();return a?a.replace(/\/$/,""):typeof window<"u"?window.location.origin:""}function ea(){return localStorage.getItem(y)}async function q(a,e){let u=ea(),o=new Headers(e?.headers);u&&o.set("Authorization",`Bearer ${u}`);let s=aa(),r=typeof a=="string"&&a.startsWith("/")?`${s}${a}`:a,i=await fetch(r,{...e,headers:o});return i.status===401&&(localStorage.removeItem(y),window.dispatchEvent(new CustomEvent("zhin:auth-required"))),i}import{jsx as l,jsxs as f}from"react/jsx-runtime";function w(){let[a,e]=P([]),[u,o]=P(!0),[s,r]=P(null),i=ta(async()=>{o(!0),r(null);try{let t=await q("/api/napcat/endpoints"),c=await t.json();if(!t.ok||!c.success)throw new Error(c.message||"\u52A0\u8F7D\u5931\u8D25");e(Array.isArray(c.data)?c.data:[])}catch(t){r(t.message),e([])}finally{o(!1)}},[]);ua(()=>{i()},[i]);let h=t=>{switch(t){case"ws":return"\u6B63\u5411 WS";case"wss":return"\u53CD\u5411 WS";case"http":return"HTTP";default:return t}};return f("div",{className:"p-6 max-w-5xl mx-auto space-y-5",children:[f("div",{className:"flex items-center justify-between",children:[f("div",{children:[f("h1",{className:"text-2xl font-bold flex items-center gap-2",children:[l(L,{className:"w-6 h-6"})," NapCat \u7BA1\u7406"]}),l("p",{className:"text-sm text-muted-foreground mt-1",children:"NapCatQQ \u673A\u5668\u4EBA\u6982\u89C8\uFF08OneBot11 + go-cqhttp + NapCat \u6269\u5C55\uFF09"})]}),f("button",{onClick:i,disabled:u,className:"flex items-center gap-1 px-3 py-1.5 rounded bg-blue-500 text-white hover:bg-blue-600 disabled:opacity-50 text-sm",children:[l(m,{className:`w-4 h-4 ${u?"animate-spin":""}`})," \u5237\u65B0"]})]}),s&&l("div",{className:"p-3 bg-red-50 text-red-600 rounded border border-red-200 text-sm dark:bg-red-900/20 dark:text-red-400 dark:border-red-800",children:s}),u?l("div",{className:"flex justify-center py-12",children:l(n,{className:"w-6 h-6 animate-spin text-blue-500"})}):a.length===0?l("div",{className:"text-center text-muted-foreground py-12",children:"\u6682\u65E0 NapCat Endpoint \u5B9E\u4F8B"}):l("div",{className:"grid gap-4 md:grid-cols-2",children:a.map(t=>f("div",{className:"border rounded-lg p-4 bg-card shadow-sm",children:[f("div",{className:"flex items-center justify-between mb-3",children:[l("span",{className:"font-medium text-lg",children:t.name}),t.connected?f("span",{className:"flex items-center gap-1 text-green-600 text-sm",children:[l(C,{className:"w-4 h-4"})," \u5728\u7EBF"]}):f("span",{className:"flex items-center gap-1 text-gray-400 text-sm",children:[l(x,{className:"w-4 h-4"})," \u79BB\u7EBF"]})]}),f("div",{className:"space-y-2 text-sm text-muted-foreground",children:[f("div",{className:"flex items-center gap-1.5",children:[l(I,{className:"w-3.5 h-3.5"}),"\u7FA4 ",t.groupCount," \xB7 \u597D\u53CB ",t.friendCount]}),f("div",{className:"flex items-center gap-1.5",children:[l(p,{className:"w-3.5 h-3.5"}),"\u8FDE\u63A5\u65B9\u5F0F ",h(t.connection)," \xB7 ",t.status]})]})]},t.name))})]})}function te(a){a.addRoute({path:"/console/napcat",name:"NapCat\u7BA1\u7406",element:a.React.createElement(w,{hostReact:a.React})}),a.addTool({id:"napcat",name:"NapCat",path:"/console/napcat"})}export{te as register};
-/*! Bundled license information:
-
-lucide-react/dist/esm/shared/src/utils/mergeClasses.mjs:
-lucide-react/dist/esm/shared/src/utils/toKebabCase.mjs:
-lucide-react/dist/esm/shared/src/utils/toCamelCase.mjs:
-lucide-react/dist/esm/shared/src/utils/toPascalCase.mjs:
-lucide-react/dist/esm/defaultAttributes.mjs:
-lucide-react/dist/esm/shared/src/utils/hasA11yProp.mjs:
-lucide-react/dist/esm/context.mjs:
-lucide-react/dist/esm/Icon.mjs:
-lucide-react/dist/esm/createLucideIcon.mjs:
-lucide-react/dist/esm/icons/activity.mjs:
-lucide-react/dist/esm/icons/bot.mjs:
-lucide-react/dist/esm/icons/loader-circle.mjs:
-lucide-react/dist/esm/icons/refresh-cw.mjs:
-lucide-react/dist/esm/icons/users.mjs:
-lucide-react/dist/esm/icons/wifi-off.mjs:
-lucide-react/dist/esm/icons/wifi.mjs:
-lucide-react/dist/esm/lucide-react.mjs:
-  (**
-   * @license lucide-react v1.23.0 - ISC
-   *
-   * This source code is licensed under the ISC license.
-   * See the LICENSE file in the root directory of this source tree.
-   *)
-*/

package/lib/adapter.d.ts

@@ -1,36 +0,0 @@
-/**
- * NapCat 适配器：支持正向 WS / 反向 WS / HTTP
- */
-import { Adapter, Plugin } from 'zhin.js';
-import { NapCatWsClient } from './endpoint-ws-client.js';
-import { NapCatWsServer } from './endpoint-ws-server.js';
-import { NapCatHttpEndpoint } from './endpoint-http.js';
-import type { NapCatEndpointConfig } from './types.js';
-export type NapCatEndpoint = NapCatWsClient | NapCatWsServer | NapCatHttpEndpoint;
-export declare class NapCatAdapter extends Adapter<NapCatEndpoint> {
-    #private;
-    static readonly capabilities: readonly ["inbound", "outbound"];
-    static outboundRichSegmentPolicy: import("zhin.js").OutboundRichSegmentPolicy;
-    static interactivePolicy: "text";
-    static aiOutboundCapabilities: {
-        mentions: boolean;
-        richSegments: string[];
-        interactive: "text";
-    };
-    static aiOutboundExtensions: import("zhin.js").AiOutboundExtensionDefinition[];
-    constructor(plugin: Plugin);
-    createEndpoint(config: NapCatEndpointConfig): NapCatEndpoint;
-    removeMember(endpointId: string, sceneId: string, userId: string): Promise<boolean>;
-    muteMember(endpointId: string, sceneId: string, userId: string, duration?: number): Promise<boolean>;
-    setSceneMuted(endpointId: string, sceneId: string, enable?: boolean): Promise<boolean>;
-    setModerator(endpointId: string, sceneId: string, userId: string, enable?: boolean): Promise<boolean>;
-    setMemberNickname(endpointId: string, sceneId: string, userId: string, nickname: string): Promise<boolean>;
-    renameScene(endpointId: string, sceneId: string, name: string): Promise<any>;
-    listMembers(endpointId: string, sceneId: string): Promise<{
-        members: any;
-        count: any;
-    }>;
-    getSceneInfo(endpointId: string, sceneId: string): Promise<any>;
-    start(): Promise<void>;
-}
-//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiB,OAAO,EAAE,MAAM,EAA+E,MAAM,SAAS,CAAC;AAEtI,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAgE,MAAM,YAAY,CAAC;AAErH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,kBAAkB,CAAC;AAElF,qBAAa,aAAc,SAAQ,OAAO,CAAC,cAAc,CAAC;;IACxD,gBAAyB,YAAY,mCAAoC;IACzE,OAAgB,yBAAyB,8CAAwC;IACjF,OAAgB,iBAAiB,EAAG,MAAM,CAAU;IACpD,OAAgB,sBAAsB;;;;MAIpC;IACF,OAAgB,oBAAoB,oDAA2C;gBAInE,MAAM,EAAE,MAAM;IAI1B,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc;IAkBtD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMhE,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAM;IAM9E,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAO;IAMhE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAO;IAM/E,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMvF,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAM7D,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;IAY/C,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAMhD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/lib/adapter.js

@@ -1,102 +0,0 @@
-/**
- * NapCat 适配器：支持正向 WS / 反向 WS / HTTP
- */
-import { Adapter, OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL, ONEBOT_KEYBOARD_AI_OUTBOUND_EXTENSION } from 'zhin.js';
-import { NapCatWsClient } from './endpoint-ws-client.js';
-import { NapCatWsServer } from './endpoint-ws-server.js';
-import { NapCatHttpEndpoint } from './endpoint-http.js';
-export class NapCatAdapter extends Adapter {
-    static capabilities = ['inbound', 'outbound'];
-    static outboundRichSegmentPolicy = OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL;
-    static interactivePolicy = 'text';
-    static aiOutboundCapabilities = {
-        mentions: true,
-        richSegments: ['qrcode', 'html', 'markdown', 'tts'],
-        interactive: 'text',
-    };
-    static aiOutboundExtensions = [ONEBOT_KEYBOARD_AI_OUTBOUND_EXTENSION];
-    #router;
-    constructor(plugin) {
-        super(plugin, 'napcat', []);
-    }
-    createEndpoint(config) {
-        const connection = config.connection ?? 'ws';
-        switch (connection) {
-            case 'ws':
-                return new NapCatWsClient(this, config);
-            case 'wss':
-                if (!this.#router)
-                    throw new Error('NapCat connection: wss requires router. Enable @zhin.js/host-router first.');
-                return new NapCatWsServer(this, this.#router, config);
-            case 'http':
-                if (!this.#router)
-                    throw new Error('NapCat connection: http requires router. Enable @zhin.js/host-router first.');
-                return new NapCatHttpEndpoint(this, this.#router, config);
-            default:
-                throw new Error(`Unknown NapCat connection: ${connection}`);
-        }
-    }
-    // ── 群管理接口（ISceneManagement 适配）──────────────────────────
-    async removeMember(endpointId, sceneId, userId) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} not found`);
-        return endpoint.kickMember(Number(sceneId), Number(userId));
-    }
-    async muteMember(endpointId, sceneId, userId, duration = 600) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} not found`);
-        return endpoint.muteMember(Number(sceneId), Number(userId), duration);
-    }
-    async setSceneMuted(endpointId, sceneId, enable = true) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} not found`);
-        return endpoint.muteAll(Number(sceneId), enable);
-    }
-    async setModerator(endpointId, sceneId, userId, enable = true) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} not found`);
-        return endpoint.setAdmin(Number(sceneId), Number(userId), enable);
-    }
-    async setMemberNickname(endpointId, sceneId, userId, nickname) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} not found`);
-        return endpoint.setCard(Number(sceneId), Number(userId), nickname);
-    }
-    async renameScene(endpointId, sceneId, name) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} not found`);
-        return endpoint.setGroupName(Number(sceneId), name);
-    }
-    async listMembers(endpointId, sceneId) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} not found`);
-        const members = await endpoint.getMemberList(Number(sceneId));
-        return {
-            members: members.map((m) => ({
-                user_id: m.user_id, nickname: m.nickname, card: m.card, role: m.role, title: m.title,
-            })),
-            count: members.length,
-        };
-    }
-    async getSceneInfo(endpointId, sceneId) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} not found`);
-        return endpoint.getGroupInfo(Number(sceneId));
-    }
-    async start() {
-        this.#router = this.plugin.inject('router');
-        this.plugin.useContext('router', (router) => {
-            this.#router = router;
-        });
-        await super.start();
-    }
-}
-//# sourceMappingURL=adapter.js.map

package/lib/adapter.js.map

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

package/lib/agent-prompt.d.ts

@@ -1,3 +0,0 @@
-import type { AgentPromptContributor } from 'zhin.js';
-export declare function createNapCatAgentPromptContributor(): AgentPromptContributor;
-//# sourceMappingURL=agent-prompt.d.ts.map

package/lib/agent-prompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-prompt.d.ts","sourceRoot":"","sources":["../src/agent-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,sBAAsB,EAGvB,MAAM,SAAS,CAAC;AAwEjB,wBAAgB,kCAAkC,IAAI,sBAAsB,CAsC3E"}