@zhin.js/adapter-kook 8.0.0 → 8.0.1

package/lib/protocol.d.ts

@@ -114,7 +114,7 @@ export declare function resolveKookConfig(config?: KookAdapterConfig): ResolvedK
  */
 export declare function kookInboundConversation(endpointKey: string, msg: KookInboundMessage): ConversationRef;
 export declare function senderDisplayName(msg: KookInboundMessage): string;
-/** Build inbound text for MessageGateway.receive */
+/** Build inbound text for OutboundMessageService.receive */
 export declare function formatInboundContent(msg: KookInboundMessage): string;
 /**
  * KOOK @ 用户标记为 `(met)<userId>(met)`；content 含 `(met)<botId>(met)` 时视为 @ 机器人。

package/lib/protocol.js

@@ -78,7 +78,7 @@ export function kookInboundConversation(endpointKey, msg) {
 export function senderDisplayName(msg) {
     return msg.authorName || msg.authorId;
 }
-/** Build inbound text for MessageGateway.receive */
+/** Build inbound text for OutboundMessageService.receive */
 export function formatInboundContent(msg) {
     const text = (msg.content || msg.rawMessage || '').trim();
     return text || '(Empty message)';

package/lib/side-event-dispatch.d.ts

@@ -1,3 +1,3 @@
-import type { SideEventGateway } from '@zhin.js/core/runtime';
+import type { EndpointEventEmitter } from 'zhin.js/adapter';
 import { type getAdapterLogger } from '@zhin.js/logger';
-export declare function receiveKookSideEvent(sideEvents: SideEventGateway | undefined, configId: string, raw: unknown, logger: ReturnType<typeof getAdapterLogger>): boolean;
+export declare function receiveKookSideEvent(emit: EndpointEventEmitter, configId: string, raw: unknown, logger: ReturnType<typeof getAdapterLogger>): boolean;

package/lib/side-event-dispatch.js

@@ -12,9 +12,7 @@ function extractKookNoticeType(raw) {
     }
     return null;
 }
-export function receiveKookSideEvent(sideEvents, configId, raw, logger) {
-    if (!sideEvents)
-        return false;
+export function receiveKookSideEvent(emit, configId, raw, logger) {
     const noticeType = extractKookNoticeType(raw);
     if (!noticeType)
         return false;
@@ -29,7 +27,7 @@ export function receiveKookSideEvent(sideEvents, configId, raw, logger) {
         : userId != null
             ? String(userId)
             : configId;
-    void sideEvents.receiveNotice(buildNotice(event, {
+    void emit('notice.receive', buildNotice(event, {
         $id: `kook:${noticeType}:${event.msg_timestamp ?? Date.now()}:${sceneId}:${String(userId ?? '')}`,
         $adapter: 'kook',
         $endpoint: configId,

package/lib/webhook.d.ts

@@ -3,14 +3,13 @@
  */
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
-import type { SideEventGateway } from '@zhin.js/core/runtime';
-import { type KookInboundMessage, type ResolvedKookWebhookConfig } from './protocol.js';
+import { type KookInboundMessage, type KookWebhookEventData, type ResolvedKookWebhookConfig } from './protocol.js';
 export interface KookWebhookHandler {
     readonly config: ResolvedKookWebhookConfig;
     readonly isOpen: boolean;
     readonly selfId?: string;
-    readonly sideEvents?: SideEventGateway;
     admit(msg: KookInboundMessage): void;
+    admitEvent(event: KookWebhookEventData): void;
     checkAndRememberSn(sn: number): boolean;
 }
 export declare function registerKookWebhookRoutes(http: HttpHost, handler: KookWebhookHandler): HttpRouteRegistration[];

package/lib/webhook.js

@@ -1,6 +1,5 @@
 import { formatCompact, getLogger } from '@zhin.js/logger';
-import { isKookWebhookChallenge, normalizeKookWebhookEvent, parseKookWebhookBody, readRequestBody, verifyKookWebhookToken, } from './protocol.js';
-import { receiveKookSideEvent } from './side-event-dispatch.js';
+import { isKookWebhookChallenge, parseKookWebhookBody, readRequestBody, verifyKookWebhookToken, } from './protocol.js';
 const logger = getLogger('kook');
 export function registerKookWebhookRoutes(http, handler) {
     const path = handler.config.webhookPath;
@@ -68,13 +67,5 @@ export async function handleKookWebhookRequest(request, response, handler) {
     }
 }
 function handleKookWebhookEvent(event, handler) {
-    if (receiveKookSideEvent(handler.sideEvents, handler.config.id, event, logger)) {
-        return;
-    }
-    const msg = normalizeKookWebhookEvent(event, {
-        ignore: handler.config.ignore,
-        selfId: handler.selfId,
-    });
-    if (msg)
-        handler.admit(msg);
+    handler.admitEvent(event);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-kook",
-  "version": "8.0.0",
+  "version": "8.0.1",
   "description": "Zhin.js KOOK adapter for Plugin Runtime (WebSocket gateway or Webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -34,20 +34,21 @@
   },
   "dependencies": {
     "kook-client": "^1.0.4",
-    "@zhin.js/adapter": "1.2.0",
-    "@zhin.js/core": "1.5.13",
-    "@zhin.js/host-http": "1.0.12",
+    "@zhin.js/adapter": "1.2.1",
+    "@zhin.js/core": "1.5.14",
+    "@zhin.js/feature-kit": "1.0.13",
+    "@zhin.js/host-http": "1.0.13",
     "@zhin.js/im-contract": "1.0.4",
-    "@zhin.js/logger": "1.0.76",
-    "@zhin.js/permission": "1.0.3"
+    "@zhin.js/logger": "1.0.77",
+    "@zhin.js/permission": "1.0.4"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "1.2.0",
-    "@zhin.js/agent": "1.1.15",
-    "@zhin.js/command": "1.0.15",
-    "@zhin.js/core": "1.5.13",
-    "zhin.js": "6.0.13"
+    "@zhin.js/adapter": "1.2.1",
+    "@zhin.js/agent": "1.1.16",
+    "@zhin.js/command": "1.0.16",
+    "@zhin.js/core": "1.5.14",
+    "zhin.js": "6.0.14"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {
@@ -68,9 +69,9 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.15",
-    "@zhin.js/host-http": "1.0.12",
-    "zhin.js": "6.0.13"
+    "@zhin.js/agent": "1.1.16",
+    "@zhin.js/host-http": "1.0.13",
+    "zhin.js": "6.0.14"
   },
   "files": [
     "adapters",

package/src/client.ts

@@ -0,0 +1,15 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+import type { KookClientTransport } from './ws.js';
+
+export type KookClientEventMap = Record<string, unknown>;
+
+declare module '@zhin.js/feature-kit' {
+  interface AdapterClientRegistry {
+    readonly kook: {
+      readonly client: KookClientTransport;
+      readonly events: KookClientEventMap;
+    };
+  }
+}
+
+export const kookClient = defineEndpointClient<KookClientTransport, KookClientEventMap>('kook');

package/src/endpoint.ts

@@ -1,3 +1,4 @@
+import { Endpoint } from 'zhin.js/adapter';
 /**
  * KookEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
@@ -7,22 +8,21 @@ import {
   type EndpointControl,
   type EndpointChannel,
   type EndpointGroup,
-  type EndpointInstance,
   type EndpointManagement,
   type EndpointSendRequest,
 } from 'zhin.js/adapter';
-import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import type { CapabilityId } from 'zhin.js';
-import { registerKookAgentEndpoint } from './kook-agent-deps.js';
 import {
   formatInboundContent,
   formatOutboundKmarkdown,
   isKookBotMentioned,
   kookInboundConversation,
+  normalizeKookWebhookEvent,
   senderDisplayName,
   type KookInboundMessage,
+  type KookWebhookEventData,
   type ResolvedKookWebhookConfig,
   type ResolvedKookWebsocketConfig,
 } from './protocol.js';
@@ -38,13 +38,11 @@ import { receiveKookSideEvent } from './side-event-dispatch.js';
 
 export interface KookEndpointOptions {
   readonly id: CapabilityId;
-  readonly gateway: MessageGateway;
-  readonly sideEvents?: SideEventGateway;
   readonly config: ResolvedKookWebsocketConfig;
   readonly createClient?: CreateKookClient;
 }
 
-export class KookWebsocketEndpoint implements EndpointInstance {
+export class KookWebsocketEndpoint extends Endpoint<KookClientTransport> {
   readonly #logger!: ReturnType<typeof getAdapterLogger>;
 
   readonly #options: KookEndpointOptions;
@@ -52,21 +50,24 @@ export class KookWebsocketEndpoint implements EndpointInstance {
   #client: KookClientTransport | null = null;
   #open = false;
   #started = false;
-  #unregisterAgent?: () => void;
   readonly management: EndpointManagement = createKookEndpointManagement(() => this.#requireClient());
   readonly control: EndpointControl = createRecallEndpointControl((id) => this.recallMessage(id));
 
   constructor(options: KookEndpointOptions) {
+    super();
     this.#logger = getAdapterLogger('kook', options.config.id);
     this.#options = options;
     this.#createClient = options.createClient ?? (defaultCreateClient as CreateKookClient);
   }
 
+  get client(): KookClientTransport {
+    return this.#requireClient();
+  }
+
   async start(): Promise<void> {
     if (this.#started) return;
     this.#started = true;
     try {
-      this.#unregisterAgent = registerKookAgentEndpoint(this.#options.config.id, this);
       this.#client = this.#createClient(this.#options.config);
       this.#bindClient(this.#client);
       await this.#client.connect();
@@ -93,8 +94,6 @@ export class KookWebsocketEndpoint implements EndpointInstance {
 
   async stop(): Promise<void> {
     this.#open = false;
-    this.#unregisterAgent?.();
-    this.#unregisterAgent = undefined;
     if (this.#client) {
       try {
         this.#client.removeAllListeners();
@@ -124,13 +123,13 @@ export class KookWebsocketEndpoint implements EndpointInstance {
     return messageId;
   }
 
-  /** Test / internal: admit a message when open. */
+  /** Test / internal: admit a normalized message when open. */
   admit(msg: KookInboundMessage): void {
     if (!this.#open) return;
     if (msg.authorBot) return;
     const conversation = kookInboundConversation(String(this.#options.id), msg);
     const selfId = this.#client?.self_id != null ? String(this.#client.self_id) : undefined;
-    void this.#options.gateway.receive({
+    void this.emit('message.receive', {
       conversation,
       message: { conversation, id: msg.id },
       content: formatInboundContent(msg),
@@ -161,44 +160,26 @@ export class KookWebsocketEndpoint implements EndpointInstance {
     await this.#requireClient().recallMsg?.(messageId);
   }
 
-  // ── Agent tool surface ──────────────────────────────────────────────
-
-  async getRoleList(guildId: string) {
-    return this.#requireClient().pickGuild(guildId).getRoleList();
-  }
-
-  async createRole(guildId: string, name: string) {
-    return this.#requireClient().pickGuild(guildId).createRole(name);
-  }
-
-  async deleteRole(guildId: string, roleId: string) {
-    return this.#requireClient().pickGuild(guildId).deleteRole(roleId);
-  }
-
-  async grantRole(guildId: string, userId: string, roleId: string) {
-    return this.#requireClient().pickGuildMember(guildId, userId).grant(roleId);
-  }
-
-  async revokeRole(guildId: string, userId: string, roleId: string) {
-    return this.#requireClient().pickGuildMember(guildId, userId).revoke(roleId);
-  }
-
-  async addToBlacklist(guildId: string, userId: string, remark?: string) {
-    return this.#requireClient().pickGuildMember(guildId, userId).addToBlackList(remark);
-  }
-
-  async removeFromBlacklist(guildId: string, userId: string) {
-    return this.#requireClient().pickGuildMember(guildId, userId).removeFromBlackList();
-  }
-
   #bindClient(client: KookClientTransport): void {
     client.on('message', (raw) => {
+      this.#emitPlatformEvent('message', raw);
       const msg = normalizeKookMessage(raw);
       if (msg) this.admit(msg);
     });
     const receiver = (client as { receiver?: { on(event: string, listener: (...args: unknown[]) => void): void } }).receiver;
     receiver?.on('event', (raw) => {
-      receiveKookSideEvent(this.#options.sideEvents, this.#options.config.id, raw, this.#logger);
+      this.#emitPlatformEvent('event', raw);
+      receiveKookSideEvent((name, payload) => this.emit(name, payload), this.#options.config.id, raw, this.#logger);
+    });
+  }
+
+  #emitPlatformEvent(name: string, event: unknown): void {
+    void this.emitPlatform(name, event).catch((error) => {
+      this.#logger.warn(formatCompact({
+        op: 'kook_platform_event_failed',
+        event: name,
+        error: error instanceof Error ? error.message : String(error),
+      }));
     });
   }
 
@@ -210,14 +191,12 @@ export class KookWebsocketEndpoint implements EndpointInstance {
 
 export interface KookWebhookEndpointOptions {
   readonly id: CapabilityId;
-  readonly gateway: MessageGateway;
-  readonly sideEvents?: SideEventGateway;
   readonly http: HttpHost;
   readonly config: ResolvedKookWebhookConfig;
   readonly createClient?: CreateKookClient;
 }
 
-export class KookWebhookEndpoint implements EndpointInstance {
+export class KookWebhookEndpoint extends Endpoint<KookClientTransport> {
   readonly #logger!: ReturnType<typeof getAdapterLogger>;
 
   readonly #options: KookWebhookEndpointOptions;
@@ -227,16 +206,20 @@ export class KookWebhookEndpoint implements EndpointInstance {
   #processedSn = new Set<number>();
   #open = false;
   #started = false;
-  #unregisterAgent?: () => void;
   readonly management: EndpointManagement = createKookEndpointManagement(() => this.#requireClient());
   readonly control: EndpointControl = createRecallEndpointControl((id) => this.recallMessage(id));
 
   constructor(options: KookWebhookEndpointOptions) {
+    super();
     this.#logger = getAdapterLogger('kook', options.config.id);
     this.#options = options;
     this.#createClient = options.createClient ?? (defaultCreateWebhookClient as CreateKookClient);
   }
 
+  get client(): KookClientTransport {
+    return this.#requireClient();
+  }
+
   /** Used by webhook handler. */
   get isOpen(): boolean {
     return this.#open;
@@ -254,7 +237,6 @@ export class KookWebhookEndpoint implements EndpointInstance {
     if (this.#started) return;
     this.#started = true;
     try {
-      this.#unregisterAgent = registerKookAgentEndpoint(this.#options.config.id, this);
       this.#client = this.#createClient(this.#options.config);
       await (this.#client as Client).init();
       this.#routeReleases.push(...registerKookWebhookRoutes(this.#options.http, this));
@@ -283,8 +265,6 @@ export class KookWebhookEndpoint implements EndpointInstance {
   async stop(): Promise<void> {
     this.#open = false;
     for (const release of this.#routeReleases.splice(0)) release();
-    this.#unregisterAgent?.();
-    this.#unregisterAgent = undefined;
     this.#processedSn.clear();
     if (this.#client) {
       try {
@@ -315,13 +295,34 @@ export class KookWebhookEndpoint implements EndpointInstance {
     return messageId;
   }
 
+  admitEvent(event: KookWebhookEventData): void {
+    void this.emitPlatform(String(event.type ?? 'event'), event).catch((error) => {
+      this.#logger.warn(formatCompact({
+        op: 'kook_platform_event_failed',
+        event: String(event.type ?? 'event'),
+        error: error instanceof Error ? error.message : String(error),
+      }));
+    });
+    if (receiveKookSideEvent(
+      (name, payload) => this.emit(name, payload),
+      this.#options.config.id,
+      event,
+      this.#logger,
+    )) return;
+    const message = normalizeKookWebhookEvent(event, {
+      ignore: this.#options.config.ignore,
+      selfId: this.selfId,
+    });
+    if (message) this.admit(message);
+  }
+
   /** Test / internal: admit a message when open. */
   admit(msg: KookInboundMessage): void {
     if (!this.#open) return;
     if (msg.authorBot) return;
     const conversation = kookInboundConversation(String(this.#options.id), msg);
     const selfId = this.#client?.self_id != null ? String(this.#client.self_id) : undefined;
-    void this.#options.gateway.receive({
+    void this.emit('message.receive', {
       conversation,
       message: { conversation, id: msg.id },
       content: formatInboundContent(msg),
@@ -362,34 +363,6 @@ export class KookWebhookEndpoint implements EndpointInstance {
     return true;
   }
 
-  async getRoleList(guildId: string) {
-    return this.#requireClient().pickGuild(guildId).getRoleList();
-  }
-
-  async createRole(guildId: string, name: string) {
-    return this.#requireClient().pickGuild(guildId).createRole(name);
-  }
-
-  async deleteRole(guildId: string, roleId: string) {
-    return this.#requireClient().pickGuild(guildId).deleteRole(roleId);
-  }
-
-  async grantRole(guildId: string, userId: string, roleId: string) {
-    return this.#requireClient().pickGuildMember(guildId, userId).grant(roleId);
-  }
-
-  async revokeRole(guildId: string, userId: string, roleId: string) {
-    return this.#requireClient().pickGuildMember(guildId, userId).revoke(roleId);
-  }
-
-  async addToBlacklist(guildId: string, userId: string, remark?: string) {
-    return this.#requireClient().pickGuildMember(guildId, userId).addToBlackList(remark);
-  }
-
-  async removeFromBlacklist(guildId: string, userId: string) {
-    return this.#requireClient().pickGuildMember(guildId, userId).removeFromBlackList();
-  }
-
   #requireClient(): KookClientTransport {
     if (!this.#client) throw new Error('KOOK client not initialized');
     return this.#client;

package/src/index.ts

@@ -34,13 +34,7 @@ export {
   type KookClientTransport,
 } from './ws.js';
 
-export {
-  getKookAgentDeps,
-  registerKookAgentEndpoint,
-  setKookAgentDeps,
-  type KookAgentDeps,
-  type KookAgentEndpoint,
-} from './kook-agent-deps.js';
+export { kookClient, type KookClientEventMap } from './client.js';
 
 export {
   checkKookPlatformPermit,

package/src/protocol.ts

@@ -208,7 +208,7 @@ export function senderDisplayName(msg: KookInboundMessage): string {
   return msg.authorName || msg.authorId;
 }
 
-/** Build inbound text for MessageGateway.receive */
+/** Build inbound text for OutboundMessageService.receive */
 export function formatInboundContent(msg: KookInboundMessage): string {
   const text = (msg.content || msg.rawMessage || '').trim();
   return text || '(Empty message)';

package/src/side-event-dispatch.ts

@@ -1,5 +1,5 @@
 import { buildNotice, mapNoticeParts, senderFromId, KOOK_NOTICE_PARTS_MAP } from '@zhin.js/core';
-import type { SideEventGateway } from '@zhin.js/core/runtime';
+import type { EndpointEventEmitter } from 'zhin.js/adapter';
 import { formatCompact, type getAdapterLogger } from '@zhin.js/logger';
 import type { KookWebhookEventData } from './protocol.js';
 
@@ -15,12 +15,11 @@ function extractKookNoticeType(raw: unknown): string | null {
 }
 
 export function receiveKookSideEvent(
-  sideEvents: SideEventGateway | undefined,
+  emit: EndpointEventEmitter,
   configId: string,
   raw: unknown,
   logger: ReturnType<typeof getAdapterLogger>,
 ): boolean {
-  if (!sideEvents) return false;
   const noticeType = extractKookNoticeType(raw);
   if (!noticeType) return false;
   if (!Object.prototype.hasOwnProperty.call(KOOK_NOTICE_PARTS_MAP, noticeType)) return false;
@@ -33,7 +32,7 @@ export function receiveKookSideEvent(
     : userId != null
       ? String(userId)
       : configId;
-  void sideEvents.receiveNotice(buildNotice(event, {
+  void emit('notice.receive', buildNotice(event, {
     $id: `kook:${noticeType}:${event.msg_timestamp ?? Date.now()}:${sceneId}:${String(userId ?? '')}`,
     $adapter: 'kook' as never,
     $endpoint: configId,

package/src/webhook.ts

@@ -3,7 +3,6 @@
  */
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
-import type { SideEventGateway } from '@zhin.js/core/runtime';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 import {
   isKookWebhookChallenge,
@@ -24,8 +23,8 @@ export interface KookWebhookHandler {
   readonly config: ResolvedKookWebhookConfig;
   readonly isOpen: boolean;
   readonly selfId?: string;
-  readonly sideEvents?: SideEventGateway;
   admit(msg: KookInboundMessage): void;
+  admitEvent(event: KookWebhookEventData): void;
   checkAndRememberSn(sn: number): boolean;
 }
 
@@ -111,12 +110,5 @@ function handleKookWebhookEvent(
   event: KookWebhookEventData,
   handler: KookWebhookHandler,
 ): void {
-  if (receiveKookSideEvent(handler.sideEvents, handler.config.id, event, logger)) {
-    return;
-  }
-  const msg = normalizeKookWebhookEvent(event, {
-    ignore: handler.config.ignore,
-    selfId: handler.selfId,
-  });
-  if (msg) handler.admit(msg);
+  handler.admitEvent(event);
 }

package/lib/kook-agent-deps.d.ts

@@ -1,29 +0,0 @@
-/**
- * Agent tool deps for kook.
- * Endpoints register themselves on start; tools look up by config name / endpoint id.
- */
-export interface KookAgentEndpoint {
-    getRoleList(guildId: string): Promise<Array<{
-        role_id: string | number;
-        name: string;
-        color?: number;
-        position?: number;
-        permissions?: unknown;
-    }>>;
-    createRole(guildId: string, name: string): Promise<{
-        role_id: string | number;
-        name: string;
-    }>;
-    deleteRole(guildId: string, roleId: string): Promise<boolean>;
-    grantRole(guildId: string, userId: string, roleId: string): Promise<boolean>;
-    revokeRole(guildId: string, userId: string, roleId: string): Promise<boolean>;
-    addToBlacklist(guildId: string, userId: string, remark?: string): Promise<boolean>;
-    removeFromBlacklist(guildId: string, userId: string): Promise<boolean>;
-}
-export interface KookAgentDeps {
-    getEndpoint: (endpointKey: string) => KookAgentEndpoint;
-}
-export declare function registerKookAgentEndpoint(endpointKey: string, endpoint: KookAgentEndpoint): () => void;
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export declare function setKookAgentDeps(deps: KookAgentDeps | null): void;
-export declare function getKookAgentDeps(): KookAgentDeps;

package/lib/kook-agent-deps.js

@@ -1,30 +0,0 @@
-/**
- * Agent tool deps for kook.
- * Endpoints register themselves on start; tools look up by config name / endpoint id.
- */
-const endpoints = new Map();
-let override = null;
-export function registerKookAgentEndpoint(endpointKey, endpoint) {
-    endpoints.set(endpointKey, endpoint);
-    return () => {
-        if (endpoints.get(endpointKey) === endpoint) {
-            endpoints.delete(endpointKey);
-        }
-    };
-}
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export function setKookAgentDeps(deps) {
-    override = deps;
-}
-export function getKookAgentDeps() {
-    if (override)
-        return override;
-    return {
-        getEndpoint(endpointKey) {
-            const registered = endpoints.get(endpointKey);
-            if (!registered)
-                throw new Error(`Endpoint ${endpointKey} 不存在`);
-            return registered;
-        },
-    };
-}

package/src/kook-agent-deps.ts

@@ -1,55 +0,0 @@
-/**
- * Agent tool deps for kook.
- * Endpoints register themselves on start; tools look up by config name / endpoint id.
- */
-
-export interface KookAgentEndpoint {
-  getRoleList(guildId: string): Promise<Array<{
-    role_id: string | number;
-    name: string;
-    color?: number;
-    position?: number;
-    permissions?: unknown;
-  }>>;
-  createRole(guildId: string, name: string): Promise<{ role_id: string | number; name: string }>;
-  deleteRole(guildId: string, roleId: string): Promise<boolean>;
-  grantRole(guildId: string, userId: string, roleId: string): Promise<boolean>;
-  revokeRole(guildId: string, userId: string, roleId: string): Promise<boolean>;
-  addToBlacklist(guildId: string, userId: string, remark?: string): Promise<boolean>;
-  removeFromBlacklist(guildId: string, userId: string): Promise<boolean>;
-}
-
-export interface KookAgentDeps {
-  getEndpoint: (endpointKey: string) => KookAgentEndpoint;
-}
-
-const endpoints = new Map<string, KookAgentEndpoint>();
-let override: KookAgentDeps | null = null;
-
-export function registerKookAgentEndpoint(
-  endpointKey: string,
-  endpoint: KookAgentEndpoint,
-): () => void {
-  endpoints.set(endpointKey, endpoint);
-  return () => {
-    if (endpoints.get(endpointKey) === endpoint) {
-      endpoints.delete(endpointKey);
-    }
-  };
-}
-
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export function setKookAgentDeps(deps: KookAgentDeps | null): void {
-  override = deps;
-}
-
-export function getKookAgentDeps(): KookAgentDeps {
-  if (override) return override;
-  return {
-    getEndpoint(endpointKey: string): KookAgentEndpoint {
-      const registered = endpoints.get(endpointKey);
-      if (!registered) throw new Error(`Endpoint ${endpointKey} 不存在`);
-      return registered;
-    },
-  };
-}