@zhin.js/adapter-dingtalk 7.0.0 → 7.0.1

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @zhin.js/adapter-dingtalk
 
+## 7.0.1
+
+### Patch Changes
+
+- 1fc78bc: Unify native platform Client access behind the literal `adapter` discriminant. Handlers infer both native events and Clients, while command, inbound/outbound middleware, and both Agent tool authoring surfaces expose the exact operation-scoped Client through a lazy `$client` getter. Definitions without `adapter` keep `$client` typed as `unknown`, and runtime dispatch rejects adapter mismatches before resolving the Client. Bundled platform tools now use this single path instead of model-provided endpoint ids and adapter-specific dependency wrappers. Every adapter registers one Client/EventMap contract, and protocol adapters including NapCat, Milky, OneBot and Satori now produce transport-independent Client objects rather than letting Endpoint instances impersonate Clients.
+- Updated dependencies [e9c6a73]
+- Updated dependencies [4e8117c]
+- Updated dependencies [902fa35]
+- Updated dependencies [54bfd6b]
+- Updated dependencies [12025ee]
+- Updated dependencies [09b14d6]
+- Updated dependencies [1fc78bc]
+  - @zhin.js/agent@1.1.16
+  - @zhin.js/adapter@1.2.1
+  - @zhin.js/core@1.5.14
+  - @zhin.js/host-http@1.0.13
+  - @zhin.js/command@1.0.16
+  - @zhin.js/logger@1.0.77
+  - zhin.js@6.0.14
+  - @zhin.js/feature-kit@1.0.13
+  - @zhin.js/permission@1.0.4
+
 ## 7.0.0
 
 ### Patch Changes

package/README.md

@@ -20,7 +20,7 @@ pnpm add @zhin.js/adapter-dingtalk
 
 - `@zhin.js/adapter` — 约定式薄入口 `adapters/dingtalk.ts`（`defineAdapter`）
 - 实现：`src/endpoint.ts`（生命周期/出站/OpenAPI）、`src/webhook.ts`（验签入站）、`src/protocol.ts`
-- `@zhin.js/core` — `messageGatewayToken` 入站/出站
+- `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
 - `@zhin.js/host-http` — `httpHostToken` 注册 Webhook 路由（**非** legacy host-router/Koa）
 - `zhin.js` — `plugin.ts`（`definePlugin`）
 - 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
@@ -75,7 +75,7 @@ plugins:
 
 ## Agent 工具
 
-`agent/` 目录保留（get_user、部门、群聊、工作通知等）。Endpoint 在 `start` 时自注册到 `dingtalk-agent-deps`。
+`agent/` 目录保留（get_user、部门、群聊、工作通知等）。工具声明 `adapter: 'dingtalk'` 后，通过惰性的 `context.$client` 自动取得当前操作的 `DingTalkClient`；无需把 Endpoint id 暴露给模型。
 
 ## 平台权限（platform permit）
 
@@ -87,3 +87,12 @@ plugins:
 pnpm --filter @zhin.js/adapter-dingtalk build
 pnpm --filter @zhin.js/adapter-dingtalk test
 ```
+
+## 故障排查
+
+| 现象 | 排查 |
+| --- | --- |
+| 平台校验 URL 失败 | 确认公网 HTTPS 可达，HTTP Host 已监听，路径与 `webhookPath` 一致 |
+| Webhook 返回 401/403 | 检查 `appSecret`、签名时间戳与服务器时钟 |
+| 能收到但无法回复 | 检查 `robotCode`、应用权限与 session webhook 是否有效 |
+| Endpoint 未出现 | 在日志查 Schema 或凭据错误，再到运行时能力核对 Endpoint |

package/adapters/dingtalk.js

@@ -3,7 +3,6 @@
  * Convention entry: discover `adapters/dingtalk.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { DingTalkEndpoint } from "../lib/endpoint.js";
 import { resolveDingTalkConfig, } from "../lib/protocol.js";
@@ -27,8 +26,6 @@ export default defineAdapter({
         });
         return new DingTalkEndpoint({
             id: context.id,
-            gateway: context.use(messageGatewayToken),
-            sideEvents: context.use(sideEventGatewayToken),
             http: context.use(httpHostToken),
             config,
         });

package/adapters/dingtalk.ts

@@ -2,7 +2,6 @@
  * Convention entry: discover `adapters/dingtalk.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { DingTalkEndpoint } from '../src/endpoint.js';
 import {
@@ -32,8 +31,6 @@ export default defineAdapter<DingTalkAdapterConfig>({
     });
     return new DingTalkEndpoint({
       id: context.id,
-      gateway: context.use(messageGatewayToken),
-      sideEvents: context.use(sideEventGatewayToken),
       http: context.use(httpHostToken),
       config,
     });

package/agent/tools/add_chat_members.ts

@@ -1,20 +1,18 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getDingtalkAgentDeps } from '../../src/dingtalk-agent-deps.js';
 import { platformPermit } from '../../src/platform-permit.js';
 
-export default defineAgentTool<{ endpoint_id: string; chat_id: string; user_ids: string }>({
+export default defineAgentTool<{ chat_id: string; user_ids: string }>({
   description: '向钉钉群聊添加成员',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     chat_id: z.string().describe('群聊 ID'),
     user_ids: z.string().describe('要添加的用户 ID 列表，逗号分隔'),
   }),
-  platforms: ['dingtalk'],
+  adapter: 'dingtalk',
   tags: ['dingtalk'],
   permissions: [platformPermit('chat_admin')],
-  async execute({ endpoint_id, chat_id, user_ids    }: { endpoint_id: string; chat_id: string; user_ids: string }) {
-    const endpoint = getDingtalkAgentDeps().getEndpoint(endpoint_id);
+  async execute({ chat_id, user_ids    }: { chat_id: string; user_ids: string }, context) {
+    const endpoint = context.$client;
     const success = await endpoint.updateChat(chat_id, { add_useridlist: user_ids.split(',') });
     return { success, message: success ? '成员添加成功' : '添加失败' };
   },

package/agent/tools/create_chat.ts

@@ -1,21 +1,19 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getDingtalkAgentDeps } from '../../src/dingtalk-agent-deps.js';
 import { platformPermit } from '../../src/platform-permit.js';
 
-export default defineAgentTool<{ endpoint_id: string; name: string; owner: string; members: string }>({
+export default defineAgentTool<{ name: string; owner: string; members: string }>({
   description: '创建钉钉群聊',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     name: z.string().describe('群名'),
     owner: z.string().describe('群主用户 ID'),
     members: z.string().describe('成员用户 ID 列表，逗号分隔'),
   }),
-  platforms: ['dingtalk'],
+  adapter: 'dingtalk',
   tags: ['dingtalk'],
   permissions: [platformPermit('chat_owner')],
-  async execute({ endpoint_id, name, owner, members    }: { endpoint_id: string; name: string; owner: string; members: string }) {
-    const endpoint = getDingtalkAgentDeps().getEndpoint(endpoint_id);
+  async execute({ name, owner, members    }: { name: string; owner: string; members: string }, context) {
+    const endpoint = context.$client;
     const chatId = await endpoint.createChat(name, owner, members.split(','));
     return { success: !!chatId, chat_id: chatId, message: chatId ? `群聊创建成功: ${chatId}` : '创建失败' };
   },

package/agent/tools/dept_info.ts

@@ -1,16 +1,14 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getDingtalkAgentDeps } from '../../src/dingtalk-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; dept_id: string }>({
+export default defineAgentTool<{ dept_id: string }>({
   description: '获取钉钉部门详细信息',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     dept_id: z.string().describe('部门 ID'),
   }),
-  platforms: ['dingtalk'],
+  adapter: 'dingtalk',
   tags: ['dingtalk'],
-  async execute({ endpoint_id, dept_id    }: { endpoint_id: string; dept_id: string }) {
-    const endpoint = getDingtalkAgentDeps().getEndpoint(endpoint_id);
+  async execute({ dept_id    }: { dept_id: string }, context) {
+    const endpoint = context.$client;
     return await endpoint.getDepartmentInfo(Number(dept_id));
   },
 });

package/agent/tools/get_dept_users.ts

@@ -1,16 +1,14 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getDingtalkAgentDeps } from '../../src/dingtalk-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; dept_id: string }>({
+export default defineAgentTool<{ dept_id: string }>({
   description: '获取钉钉部门用户列表',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     dept_id: z.string().describe('部门 ID'),
   }),
-  platforms: ['dingtalk'],
+  adapter: 'dingtalk',
   tags: ['dingtalk'],
-  async execute({ endpoint_id, dept_id    }: { endpoint_id: string; dept_id: string }) {
-    const endpoint = getDingtalkAgentDeps().getEndpoint(endpoint_id);
+  async execute({ dept_id    }: { dept_id: string }, context) {
+    const endpoint = context.$client;
     const users = await endpoint.getDepartmentUsers(Number(dept_id));
     return { users, count: users.length };
   },

package/agent/tools/get_user.ts

@@ -1,16 +1,14 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getDingtalkAgentDeps } from '../../src/dingtalk-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; user_id: string }>({
+export default defineAgentTool<{ user_id: string }>({
   description: '获取钉钉用户信息',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     user_id: z.string().describe('用户 ID'),
   }),
-  platforms: ['dingtalk'],
+  adapter: 'dingtalk',
   tags: ['dingtalk'],
-  async execute({ endpoint_id, user_id    }: { endpoint_id: string; user_id: string }) {
-    const endpoint = getDingtalkAgentDeps().getEndpoint(endpoint_id);
+  async execute({ user_id    }: { user_id: string }, context) {
+    const endpoint = context.$client;
     return await endpoint.getUserInfo(user_id);
   },
 });

package/agent/tools/list_departments.ts

@@ -1,16 +1,14 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getDingtalkAgentDeps } from '../../src/dingtalk-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; dept_id?: string }>({
+export default defineAgentTool<{ dept_id?: string }>({
   description: '获取钉钉部门列表',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     dept_id: z.string().optional().describe('父部门 ID，默认 1（根部门）'),
   }),
-  platforms: ['dingtalk'],
+  adapter: 'dingtalk',
   tags: ['dingtalk'],
-  async execute({ endpoint_id, dept_id    }: { endpoint_id: string; dept_id?: string }) {
-    const endpoint = getDingtalkAgentDeps().getEndpoint(endpoint_id);
+  async execute({ dept_id    }: { dept_id?: string }, context) {
+    const endpoint = context.$client;
     const departments = await endpoint.getDepartmentList(Number(dept_id || '1'));
     return { departments, count: departments.length };
   },

package/agent/tools/send_work_notice.ts

@@ -1,17 +1,15 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getDingtalkAgentDeps } from '../../src/dingtalk-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; user_ids: string; content: string }>({
+export default defineAgentTool<{ user_ids: string; content: string }>({
   description: '向指定用户发送钉钉工作通知',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     user_ids: z.string().describe('用户 ID 列表，逗号分隔'),
     content: z.string().describe('通知内容'),
   }),
-  platforms: ['dingtalk'],
+  adapter: 'dingtalk',
   tags: ['dingtalk'],
-  async execute({ endpoint_id, user_ids, content    }: { endpoint_id: string; user_ids: string; content: string }) {
-    const endpoint = getDingtalkAgentDeps().getEndpoint(endpoint_id);
+  async execute({ user_ids, content    }: { user_ids: string; content: string }, context) {
+    const endpoint = context.$client;
     const msgContent = { msgtype: 'text', text: { content } };
     const success = await endpoint.sendWorkNotice(user_ids.split(','), msgContent);
     return { success, message: success ? '工作通知已发送' : '发送失败' };

package/agent/tools/update_chat.ts

@@ -1,20 +1,18 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getDingtalkAgentDeps } from '../../src/dingtalk-agent-deps.js';
-export default defineAgentTool<{ endpoint_id: string; chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }>({
+export default defineAgentTool<{ chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }>({
   description: '更新钉钉群聊设置（改名、换群主、增减成员）',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     chat_id: z.string().describe('群聊 ID'),
     name: z.string().optional().describe('新群名（可选）'),
     owner: z.string().optional().describe('新群主 userId（可选）'),
     add_members: z.string().optional().describe('要添加的成员 userId，逗号分隔（可选）'),
     remove_members: z.string().optional().describe('要移除的成员 userId，逗号分隔（可选）'),
   }),
-  platforms: ['dingtalk'],
+  adapter: 'dingtalk',
   tags: ['dingtalk'],
-  async execute({ endpoint_id, chat_id, name, owner, add_members, remove_members    }: { endpoint_id: string; chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }) {
-    const endpoint = getDingtalkAgentDeps().getEndpoint(endpoint_id);
+  async execute({ chat_id, name, owner, add_members, remove_members    }: { chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }, context) {
+    const endpoint = context.$client;
     const options: Record<string, unknown> = {};
     if (name) options.name = name;
     if (owner) options.owner = owner;

package/lib/client.d.ts

@@ -0,0 +1,12 @@
+import type { DingTalkClient } from './endpoint.js';
+import type { DingTalkEvent } from './protocol.js';
+export type DingtalkClientEventMap = Record<string, DingTalkEvent>;
+declare module '@zhin.js/feature-kit' {
+    interface AdapterClientRegistry {
+        readonly dingtalk: {
+            readonly client: DingTalkClient;
+            readonly events: DingtalkClientEventMap;
+        };
+    }
+}
+export declare const dingtalkClient: import("@zhin.js/adapter").EndpointClientToken<DingTalkClient, DingtalkClientEventMap>;

package/lib/client.js

@@ -0,0 +1,2 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+export const dingtalkClient = defineEndpointClient('dingtalk');

package/lib/dingtalk-endpoint-commands.d.ts

@@ -1 +1 @@
-export declare const dingtalkEndpointCommands: import("@zhin.js/adapter").EndpointCommands<Readonly<import("@zhin.js/command").CommandDefinition<unknown, unknown, import("@zhin.js/command").CommandMessage>>>;
+export declare const dingtalkEndpointCommands: import("@zhin.js/adapter").EndpointCommands<Readonly<import("@zhin.js/command").CommandDefinition<unknown, unknown, import("@zhin.js/command").CommandMessage, string | undefined>>>;

package/lib/endpoint.d.ts

@@ -1,8 +1,8 @@
+import { Endpoint } from 'zhin.js/adapter';
 /**
  * DingTalkEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
-import type { EndpointInstance, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
+import { type EndpointSendRequest } from 'zhin.js/adapter';
 import type { HttpHost } from '@zhin.js/host-http';
 import type { CapabilityId } from 'zhin.js';
 import { type DingTalkEvent, type DingTalkMessage, type ResolvedDingTalkConfig } from './protocol.js';
@@ -18,19 +18,46 @@ export type DingTalkFetch = (url: string, init?: {
 }>;
 export interface DingTalkEndpointOptions {
     readonly id: CapabilityId;
-    readonly gateway: MessageGateway;
-    readonly sideEvents?: SideEventGateway;
     readonly http: HttpHost;
     readonly config: ResolvedDingTalkConfig;
     readonly fetch?: DingTalkFetch;
 }
+export interface DingTalkClientApi {
+    getUserInfo(userId: string): Promise<unknown>;
+    getDepartmentUsers(deptId: number): Promise<unknown[]>;
+    sendWorkNotice(userIdList: string[], content: unknown): Promise<boolean>;
+    getDepartmentList(deptId?: number): Promise<unknown[]>;
+    getDepartmentInfo(deptId: number): Promise<unknown>;
+    createChat(name: string, ownerUserId: string, userIdList: string[]): Promise<string | null>;
+    getChatInfo(chatId: string): Promise<unknown>;
+    updateChat(chatId: string, options: {
+        name?: string;
+        owner?: string;
+        add_useridlist?: string[];
+        del_useridlist?: string[];
+    }): Promise<boolean>;
+}
+/** SDK-like DingTalk OpenAPI surface available on every Endpoint event. */
+export declare class DingTalkClient implements DingTalkClientApi {
+    readonly api: DingTalkClientApi;
+    constructor(api: DingTalkClientApi);
+    getUserInfo: (userId: string) => Promise<unknown>;
+    getDepartmentUsers: (deptId: number) => Promise<unknown[]>;
+    sendWorkNotice: (userIds: string[], content: unknown) => Promise<boolean>;
+    getDepartmentList: (deptId?: number) => Promise<unknown[]>;
+    getDepartmentInfo: (deptId: number) => Promise<unknown>;
+    createChat: (name: string, owner: string, users: string[]) => Promise<string | null>;
+    getChatInfo: (chatId: string) => Promise<unknown>;
+    updateChat: (chatId: string, options: Parameters<DingTalkClientApi["updateChat"]>[1]) => Promise<boolean>;
+}
 /**
  * 钉钉机器人（webhook/stream 模式）无常规群列表 API——机器人不持有
  * 「我所在的群」枚举面，仅能收发消息；
  * 因此本 endpoint 不暴露 EndpointManagement（Console 社交面 RPC 对该平台保持未接线）。
  */
-export declare class DingTalkEndpoint implements EndpointInstance {
+export declare class DingTalkEndpoint extends Endpoint<DingTalkClient> {
     #private;
+    readonly client: DingTalkClient;
     constructor(options: DingTalkEndpointOptions);
     /** Used by webhook handler. */
     get isOpen(): boolean;
@@ -42,17 +69,4 @@ export declare class DingTalkEndpoint implements EndpointInstance {
     send({ conversation, payload }: EndpointSendRequest): Promise<string>;
     /** Test / internal: admit a parsed event when open (non-webhook path). */
     admit(event: DingTalkEvent | DingTalkMessage): void;
-    getUserInfo(userId: string): Promise<unknown>;
-    getDepartmentUsers(deptId: number): Promise<unknown[]>;
-    sendWorkNotice(userIdList: string[], content: unknown): Promise<boolean>;
-    getDepartmentList(deptId?: number): Promise<unknown[]>;
-    getDepartmentInfo(deptId: number): Promise<unknown>;
-    createChat(name: string, ownerUserId: string, userIdList: string[]): Promise<string | null>;
-    getChatInfo(chatId: string): Promise<unknown>;
-    updateChat(chatId: string, options: {
-        name?: string;
-        owner?: string;
-        add_useridlist?: string[];
-        del_useridlist?: string[];
-    }): Promise<boolean>;
 }

package/lib/endpoint.js

@@ -1,14 +1,39 @@
+import { Endpoint } from 'zhin.js/adapter';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
-import { registerDingtalkAgentEndpoint } from './dingtalk-agent-deps.js';
 import { normalizeDingtalkSenderForPermit } from './platform-permit.js';
 import { dingtalkInboundConversation, formatInboundContent, formatOutboundBody, generateMessageId, isDingtalkBotMentioned, resolveChatType, resolveSender, } from './protocol.js';
 import { registerDingTalkWebhookRoutes } from './webhook.js';
+/** SDK-like DingTalk OpenAPI surface available on every Endpoint event. */
+export class DingTalkClient {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    getUserInfo = (userId) => this.api.getUserInfo(userId);
+    getDepartmentUsers = (deptId) => this.api.getDepartmentUsers(deptId);
+    sendWorkNotice = (userIds, content) => this.api.sendWorkNotice(userIds, content);
+    getDepartmentList = (deptId) => this.api.getDepartmentList(deptId);
+    getDepartmentInfo = (deptId) => this.api.getDepartmentInfo(deptId);
+    createChat = (name, owner, users) => this.api.createChat(name, owner, users);
+    getChatInfo = (chatId) => this.api.getChatInfo(chatId);
+    updateChat = (chatId, options) => this.api.updateChat(chatId, options);
+}
 /**
  * 钉钉机器人（webhook/stream 模式）无常规群列表 API——机器人不持有
  * 「我所在的群」枚举面，仅能收发消息；
  * 因此本 endpoint 不暴露 EndpointManagement（Console 社交面 RPC 对该平台保持未接线）。
  */
-export class DingTalkEndpoint {
+export class DingTalkEndpoint extends Endpoint {
+    client = new DingTalkClient({
+        getUserInfo: (userId) => this.#getUserInfo(userId),
+        getDepartmentUsers: (deptId) => this.#getDepartmentUsers(deptId),
+        sendWorkNotice: (userIds, content) => this.#sendWorkNotice(userIds, content),
+        getDepartmentList: (deptId) => this.#getDepartmentList(deptId),
+        getDepartmentInfo: (deptId) => this.#getDepartmentInfo(deptId),
+        createChat: (name, owner, users) => this.#createChat(name, owner, users),
+        getChatInfo: (chatId) => this.#getChatInfo(chatId),
+        updateChat: (chatId, options) => this.#updateChat(chatId, options),
+    });
     #logger;
     #options;
     #fetch;
@@ -18,8 +43,8 @@ export class DingTalkEndpoint {
     #sessionWebhooks = new Map();
     #open = false;
     #started = false;
-    #unregisterAgent;
     constructor(options) {
+        super();
         this.#logger = getAdapterLogger('dingtalk', options.config.id);
         this.#options = options;
         this.#fetch = options.fetch ?? globalThis.fetch;
@@ -37,7 +62,6 @@ export class DingTalkEndpoint {
         this.#started = true;
         try {
             await this.#refreshAccessToken();
-            this.#unregisterAgent = registerDingtalkAgentEndpoint(this.#options.config.id, this);
             this.#routeReleases.push(...registerDingTalkWebhookRoutes(this.#options.http, this));
             this.#logger.debug(formatCompact({
                 endpoint: this.#options.config.id,
@@ -62,8 +86,6 @@ export class DingTalkEndpoint {
         this.#sessionWebhooks.clear();
         for (const release of this.#routeReleases.splice(0))
             release();
-        this.#unregisterAgent?.();
-        this.#unregisterAgent = undefined;
         this.#started = false;
         this.#logger.debug(formatCompact({ op: 'disconnect' }));
     }
@@ -108,13 +130,14 @@ export class DingTalkEndpoint {
     admit(event) {
         if (!this.#open)
             return;
+        this.#emitPlatformEvent(event.msgtype || 'event', event);
         if (event.sessionWebhook && event.conversationId) {
             this.#sessionWebhooks.set(event.conversationId, event.sessionWebhook);
         }
         const conversation = dingtalkInboundConversation(String(this.#options.id), event);
         const chatType = resolveChatType(event.conversationType);
         const permit = normalizeDingtalkSenderForPermit({ isAdmin: event.isAdmin === true });
-        void this.#options.gateway.receive({
+        void this.emit('message.receive', {
             conversation,
             message: { conversation, id: generateMessageId(event) },
             content: formatInboundContent(event),
@@ -141,7 +164,16 @@ export class DingTalkEndpoint {
             }));
         });
     }
-    async getUserInfo(userId) {
+    #emitPlatformEvent(name, event) {
+        void this.emitPlatform(name, event).catch((error) => {
+            this.#logger.warn(formatCompact({
+                op: 'dingtalk_platform_event_failed',
+                event: name,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        });
+    }
+    async #getUserInfo(userId) {
         try {
             const data = await this.#request('/topapi/v2/user/get', {
                 method: 'POST',
@@ -156,7 +188,7 @@ export class DingTalkEndpoint {
             return null;
         }
     }
-    async getDepartmentUsers(deptId) {
+    async #getDepartmentUsers(deptId) {
         try {
             const data = await this.#request('/topapi/user/listid', {
                 method: 'POST',
@@ -173,7 +205,7 @@ export class DingTalkEndpoint {
             return [];
         }
     }
-    async sendWorkNotice(userIdList, content) {
+    async #sendWorkNotice(userIdList, content) {
         try {
             const data = await this.#request('/topapi/message/corpconversation/asyncsend_v2', {
                 method: 'POST',
@@ -192,7 +224,7 @@ export class DingTalkEndpoint {
             return false;
         }
     }
-    async getDepartmentList(deptId = 1) {
+    async #getDepartmentList(deptId = 1) {
         try {
             const data = await this.#request('/topapi/v2/department/listsub', {
                 method: 'POST',
@@ -207,7 +239,7 @@ export class DingTalkEndpoint {
             return [];
         }
     }
-    async getDepartmentInfo(deptId) {
+    async #getDepartmentInfo(deptId) {
         try {
             const data = await this.#request('/topapi/v2/department/get', {
                 method: 'POST',
@@ -222,7 +254,7 @@ export class DingTalkEndpoint {
             return null;
         }
     }
-    async createChat(name, ownerUserId, userIdList) {
+    async #createChat(name, ownerUserId, userIdList) {
         try {
             const data = await this.#request('/topapi/chat/create', {
                 method: 'POST',
@@ -237,7 +269,7 @@ export class DingTalkEndpoint {
             return null;
         }
     }
-    async getChatInfo(chatId) {
+    async #getChatInfo(chatId) {
         try {
             const data = await this.#request('/topapi/chat/get', {
                 method: 'POST',
@@ -252,7 +284,7 @@ export class DingTalkEndpoint {
             return null;
         }
     }
-    async updateChat(chatId, options) {
+    async #updateChat(chatId, options) {
         try {
             const data = await this.#request('/topapi/chat/update', {
                 method: 'POST',

package/lib/index.d.ts

@@ -1,5 +1,5 @@
 export { dingtalkInboundConversation, formatInboundContent, formatOutboundBody, generateMessageId, headerValue, normalizeWebhookPath, readTextBody, resolveChatType, resolveDingTalkConfig, resolveSender, verifySignature, type AccessToken, type DingTalkAdapterConfig, type DingTalkApiResponse, type DingTalkEvent, type DingTalkMessage, type DingTalkSendBody, type DingTalkWireSegment, type ResolvedDingTalkConfig, } from './protocol.js';
-export { DingTalkEndpoint, type DingTalkEndpointOptions, type DingTalkFetch, } from './endpoint.js';
+export { DingTalkClient, DingTalkEndpoint, type DingTalkClientApi, type DingTalkEndpointOptions, type DingTalkFetch, } from './endpoint.js';
 export { registerDingTalkWebhookRoutes, handleDingTalkWebhookRequest, type DingTalkWebhookHandler, } from './webhook.js';
-export { getDingtalkAgentDeps, registerDingtalkAgentEndpoint, setDingtalkAgentDeps, type DingtalkAgentDeps, type DingtalkAgentEndpoint, } from './dingtalk-agent-deps.js';
+export { dingtalkClient, type DingtalkClientEventMap } from './client.js';
 export { checkDingtalkPlatformPermit, dingtalkGroupPermitResolver, normalizeDingtalkSenderForPermit, platformPermit, } from './platform-permit.js';

package/lib/index.js

@@ -1,5 +1,5 @@
 export { dingtalkInboundConversation, formatInboundContent, formatOutboundBody, generateMessageId, headerValue, normalizeWebhookPath, readTextBody, resolveChatType, resolveDingTalkConfig, resolveSender, verifySignature, } from './protocol.js';
-export { DingTalkEndpoint, } from './endpoint.js';
+export { DingTalkClient, DingTalkEndpoint, } from './endpoint.js';
 export { registerDingTalkWebhookRoutes, handleDingTalkWebhookRequest, } from './webhook.js';
-export { getDingtalkAgentDeps, registerDingtalkAgentEndpoint, setDingtalkAgentDeps, } from './dingtalk-agent-deps.js';
+export { dingtalkClient } from './client.js';
 export { checkDingtalkPlatformPermit, dingtalkGroupPermitResolver, normalizeDingtalkSenderForPermit, platformPermit, } from './platform-permit.js';

package/lib/protocol.d.ts

@@ -113,7 +113,7 @@ export declare function resolveChatType(conversationType?: string): 'group' | 'p
 export declare function dingtalkInboundConversation(endpointKey: string, msg: DingTalkMessage): ConversationRef;
 export declare function resolveSender(msg: DingTalkMessage): string;
 export declare function generateMessageId(msg: DingTalkMessage): string;
-/** Build inbound text for MessageGateway.receive. */
+/** Build inbound text for OutboundMessageService.receive. */
 export declare function formatInboundContent(msg: DingTalkMessage): string;
 /** DingTalk timestamps are epoch milliseconds; reject replays outside ±1 hour. */
 export declare const MAX_TIMESTAMP_DRIFT_MS: number;

package/lib/protocol.js

@@ -71,7 +71,7 @@ export function resolveSender(msg) {
 export function generateMessageId(msg) {
     return msg.msgId || `${msg.createAt ?? Date.now()}`;
 }
-/** Build inbound text for MessageGateway.receive. */
+/** Build inbound text for OutboundMessageService.receive. */
 export function formatInboundContent(msg) {
     if (!msg.msgtype)
         return '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-dingtalk",
-  "version": "7.0.0",
+  "version": "7.0.1",
   "description": "Zhin.js DingTalk (钉钉) adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,21 +33,22 @@
     "directory": "plugins/adapters/dingtalk"
   },
   "dependencies": {
-    "@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/logger": "1.0.77"
   },
   "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/host-http": "1.0.12",
-    "@zhin.js/permission": "1.0.3",
-    "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/host-http": "1.0.13",
+    "@zhin.js/permission": "1.0.4",
+    "zhin.js": "6.0.14"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {
@@ -68,8 +69,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.15",
-    "zhin.js": "6.0.13"
+    "@zhin.js/agent": "1.1.16",
+    "zhin.js": "6.0.14"
   },
   "files": [
     "adapters",

package/src/client.ts

@@ -0,0 +1,16 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+import type { DingTalkClient } from './endpoint.js';
+import type { DingTalkEvent } from './protocol.js';
+
+export type DingtalkClientEventMap = Record<string, DingTalkEvent>;
+
+declare module '@zhin.js/feature-kit' {
+  interface AdapterClientRegistry {
+    readonly dingtalk: {
+      readonly client: DingTalkClient;
+      readonly events: DingtalkClientEventMap;
+    };
+  }
+}
+
+export const dingtalkClient = defineEndpointClient<DingTalkClient, DingtalkClientEventMap>('dingtalk');

package/src/endpoint.ts

@@ -1,12 +1,11 @@
+import { Endpoint } from 'zhin.js/adapter';
 /**
  * DingTalkEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
-import type { EndpointInstance, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
+import { type EndpointSendRequest } from 'zhin.js/adapter';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import type { CapabilityId } from 'zhin.js';
-import { registerDingtalkAgentEndpoint } from './dingtalk-agent-deps.js';
 import { normalizeDingtalkSenderForPermit } from './platform-permit.js';
 import {
   dingtalkInboundConversation,
@@ -41,19 +40,59 @@ export type DingTalkFetch = (
 
 export interface DingTalkEndpointOptions {
   readonly id: CapabilityId;
-  readonly gateway: MessageGateway;
-  readonly sideEvents?: SideEventGateway;
   readonly http: HttpHost;
   readonly config: ResolvedDingTalkConfig;
   readonly fetch?: DingTalkFetch;
 }
 
+export interface DingTalkClientApi {
+  getUserInfo(userId: string): Promise<unknown>;
+  getDepartmentUsers(deptId: number): Promise<unknown[]>;
+  sendWorkNotice(userIdList: string[], content: unknown): Promise<boolean>;
+  getDepartmentList(deptId?: number): Promise<unknown[]>;
+  getDepartmentInfo(deptId: number): Promise<unknown>;
+  createChat(name: string, ownerUserId: string, userIdList: string[]): Promise<string | null>;
+  getChatInfo(chatId: string): Promise<unknown>;
+  updateChat(chatId: string, options: {
+    name?: string;
+    owner?: string;
+    add_useridlist?: string[];
+    del_useridlist?: string[];
+  }): Promise<boolean>;
+}
+
+/** SDK-like DingTalk OpenAPI surface available on every Endpoint event. */
+export class DingTalkClient implements DingTalkClientApi {
+  constructor(readonly api: DingTalkClientApi) {}
+  getUserInfo = (userId: string) => this.api.getUserInfo(userId);
+  getDepartmentUsers = (deptId: number) => this.api.getDepartmentUsers(deptId);
+  sendWorkNotice = (userIds: string[], content: unknown) =>
+    this.api.sendWorkNotice(userIds, content);
+  getDepartmentList = (deptId?: number) => this.api.getDepartmentList(deptId);
+  getDepartmentInfo = (deptId: number) => this.api.getDepartmentInfo(deptId);
+  createChat = (name: string, owner: string, users: string[]) =>
+    this.api.createChat(name, owner, users);
+  getChatInfo = (chatId: string) => this.api.getChatInfo(chatId);
+  updateChat = (chatId: string, options: Parameters<DingTalkClientApi['updateChat']>[1]) =>
+    this.api.updateChat(chatId, options);
+}
+
 /**
  * 钉钉机器人（webhook/stream 模式）无常规群列表 API——机器人不持有
  * 「我所在的群」枚举面，仅能收发消息；
  * 因此本 endpoint 不暴露 EndpointManagement（Console 社交面 RPC 对该平台保持未接线）。
  */
-export class DingTalkEndpoint implements EndpointInstance {
+export class DingTalkEndpoint extends Endpoint<DingTalkClient> {
+  readonly client = new DingTalkClient({
+    getUserInfo: (userId) => this.#getUserInfo(userId),
+    getDepartmentUsers: (deptId) => this.#getDepartmentUsers(deptId),
+    sendWorkNotice: (userIds, content) => this.#sendWorkNotice(userIds, content),
+    getDepartmentList: (deptId) => this.#getDepartmentList(deptId),
+    getDepartmentInfo: (deptId) => this.#getDepartmentInfo(deptId),
+    createChat: (name, owner, users) => this.#createChat(name, owner, users),
+    getChatInfo: (chatId) => this.#getChatInfo(chatId),
+    updateChat: (chatId, options) => this.#updateChat(chatId, options),
+  });
   readonly #logger!: ReturnType<typeof getAdapterLogger>;
 
   readonly #options: DingTalkEndpointOptions;
@@ -64,9 +103,9 @@ export class DingTalkEndpoint implements EndpointInstance {
   #sessionWebhooks = new Map<string, string>();
   #open = false;
   #started = false;
-  #unregisterAgent?: () => void;
 
   constructor(options: DingTalkEndpointOptions) {
+    super();
     this.#logger = getAdapterLogger('dingtalk', options.config.id);
     this.#options = options;
     this.#fetch = options.fetch ?? globalThis.fetch;
@@ -86,7 +125,6 @@ export class DingTalkEndpoint implements EndpointInstance {
     this.#started = true;
     try {
       await this.#refreshAccessToken();
-      this.#unregisterAgent = registerDingtalkAgentEndpoint(this.#options.config.id, this);
       this.#routeReleases.push(...registerDingTalkWebhookRoutes(this.#options.http, this));
       this.#logger.debug(formatCompact({
         endpoint: this.#options.config.id,
@@ -112,8 +150,6 @@ export class DingTalkEndpoint implements EndpointInstance {
     this.#open = false;
     this.#sessionWebhooks.clear();
     for (const release of this.#routeReleases.splice(0)) release();
-    this.#unregisterAgent?.();
-    this.#unregisterAgent = undefined;
     this.#started = false;
     this.#logger.debug(formatCompact({ op: 'disconnect' }));
   }
@@ -160,13 +196,14 @@ export class DingTalkEndpoint implements EndpointInstance {
   /** Test / internal: admit a parsed event when open (non-webhook path). */
   admit(event: DingTalkEvent | DingTalkMessage): void {
     if (!this.#open) return;
+    this.#emitPlatformEvent(event.msgtype || 'event', event);
     if (event.sessionWebhook && event.conversationId) {
       this.#sessionWebhooks.set(event.conversationId, event.sessionWebhook);
     }
     const conversation = dingtalkInboundConversation(String(this.#options.id), event);
     const chatType = resolveChatType(event.conversationType);
     const permit = normalizeDingtalkSenderForPermit({ isAdmin: event.isAdmin === true });
-    void this.#options.gateway.receive({
+    void this.emit('message.receive', {
       conversation,
       message: { conversation, id: generateMessageId(event) },
       content: formatInboundContent(event),
@@ -194,7 +231,17 @@ export class DingTalkEndpoint implements EndpointInstance {
     });
   }
 
-  async getUserInfo(userId: string): Promise<unknown> {
+  #emitPlatformEvent(name: string, event: unknown): void {
+    void this.emitPlatform(name, event).catch((error) => {
+      this.#logger.warn(formatCompact({
+        op: 'dingtalk_platform_event_failed',
+        event: name,
+        error: error instanceof Error ? error.message : String(error),
+      }));
+    });
+  }
+
+  async #getUserInfo(userId: string): Promise<unknown> {
     try {
       const data = await this.#request('/topapi/v2/user/get', {
         method: 'POST',
@@ -208,7 +255,7 @@ export class DingTalkEndpoint implements EndpointInstance {
     }
   }
 
-  async getDepartmentUsers(deptId: number): Promise<unknown[]> {
+  async #getDepartmentUsers(deptId: number): Promise<unknown[]> {
     try {
       const data = await this.#request('/topapi/user/listid', {
         method: 'POST',
@@ -225,7 +272,7 @@ export class DingTalkEndpoint implements EndpointInstance {
     }
   }
 
-  async sendWorkNotice(userIdList: string[], content: unknown): Promise<boolean> {
+  async #sendWorkNotice(userIdList: string[], content: unknown): Promise<boolean> {
     try {
       const data = await this.#request('/topapi/message/corpconversation/asyncsend_v2', {
         method: 'POST',
@@ -243,7 +290,7 @@ export class DingTalkEndpoint implements EndpointInstance {
     }
   }
 
-  async getDepartmentList(deptId: number = 1): Promise<unknown[]> {
+  async #getDepartmentList(deptId: number = 1): Promise<unknown[]> {
     try {
       const data = await this.#request('/topapi/v2/department/listsub', {
         method: 'POST',
@@ -257,7 +304,7 @@ export class DingTalkEndpoint implements EndpointInstance {
     }
   }
 
-  async getDepartmentInfo(deptId: number): Promise<unknown> {
+  async #getDepartmentInfo(deptId: number): Promise<unknown> {
     try {
       const data = await this.#request('/topapi/v2/department/get', {
         method: 'POST',
@@ -271,7 +318,7 @@ export class DingTalkEndpoint implements EndpointInstance {
     }
   }
 
-  async createChat(
+  async #createChat(
     name: string,
     ownerUserId: string,
     userIdList: string[],
@@ -289,7 +336,7 @@ export class DingTalkEndpoint implements EndpointInstance {
     }
   }
 
-  async getChatInfo(chatId: string): Promise<unknown> {
+  async #getChatInfo(chatId: string): Promise<unknown> {
     try {
       const data = await this.#request('/topapi/chat/get', {
         method: 'POST',
@@ -303,7 +350,7 @@ export class DingTalkEndpoint implements EndpointInstance {
     }
   }
 
-  async updateChat(
+  async #updateChat(
     chatId: string,
     options: {
       name?: string;

package/src/index.ts

@@ -21,7 +21,9 @@ export {
 } from './protocol.js';
 
 export {
+  DingTalkClient,
   DingTalkEndpoint,
+  type DingTalkClientApi,
   type DingTalkEndpointOptions,
   type DingTalkFetch,
 } from './endpoint.js';
@@ -32,13 +34,7 @@ export {
   type DingTalkWebhookHandler,
 } from './webhook.js';
 
-export {
-  getDingtalkAgentDeps,
-  registerDingtalkAgentEndpoint,
-  setDingtalkAgentDeps,
-  type DingtalkAgentDeps,
-  type DingtalkAgentEndpoint,
-} from './dingtalk-agent-deps.js';
+export { dingtalkClient, type DingtalkClientEventMap } from './client.js';
 
 export {
   checkDingtalkPlatformPermit,

package/src/protocol.ts

@@ -176,7 +176,7 @@ export function generateMessageId(msg: DingTalkMessage): string {
   return msg.msgId || `${msg.createAt ?? Date.now()}`;
 }
 
-/** Build inbound text for MessageGateway.receive. */
+/** Build inbound text for OutboundMessageService.receive. */
 export function formatInboundContent(msg: DingTalkMessage): string {
   if (!msg.msgtype) return '';
   switch (msg.msgtype) {

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

@@ -1,26 +0,0 @@
-/**
- * Agent tool deps for dingtalk (user / dept / chat / work notice).
- * Endpoints register themselves on start; tools look up by endpoint id.
- */
-export interface DingtalkAgentEndpoint {
-    getUserInfo(userId: string): Promise<unknown>;
-    getDepartmentUsers(deptId: number): Promise<unknown[]>;
-    sendWorkNotice(userIdList: string[], content: unknown): Promise<boolean>;
-    getDepartmentList(deptId?: number): Promise<unknown[]>;
-    getDepartmentInfo(deptId: number): Promise<unknown>;
-    createChat(name: string, ownerUserId: string, userIdList: string[]): Promise<string | null>;
-    getChatInfo(chatId: string): Promise<unknown>;
-    updateChat(chatId: string, options: {
-        name?: string;
-        owner?: string;
-        add_useridlist?: string[];
-        del_useridlist?: string[];
-    }): Promise<boolean>;
-}
-export interface DingtalkAgentDeps {
-    getEndpoint: (endpointKey: string) => DingtalkAgentEndpoint;
-}
-export declare function registerDingtalkAgentEndpoint(endpointKey: string, endpoint: DingtalkAgentEndpoint): () => void;
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export declare function setDingtalkAgentDeps(deps: DingtalkAgentDeps | null): void;
-export declare function getDingtalkAgentDeps(): DingtalkAgentDeps;

package/lib/dingtalk-agent-deps.js

@@ -1,30 +0,0 @@
-/**
- * Agent tool deps for dingtalk (user / dept / chat / work notice).
- * Endpoints register themselves on start; tools look up by endpoint id.
- */
-const endpoints = new Map();
-let override = null;
-export function registerDingtalkAgentEndpoint(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 setDingtalkAgentDeps(deps) {
-    override = deps;
-}
-export function getDingtalkAgentDeps() {
-    if (override)
-        return override;
-    return {
-        getEndpoint(endpointKey) {
-            const endpoint = endpoints.get(endpointKey);
-            if (!endpoint)
-                throw new Error(`Endpoint ${endpointKey} 不存在`);
-            return endpoint;
-        },
-    };
-}

package/src/dingtalk-agent-deps.ts

@@ -1,58 +0,0 @@
-/**
- * Agent tool deps for dingtalk (user / dept / chat / work notice).
- * Endpoints register themselves on start; tools look up by endpoint id.
- */
-
-export interface DingtalkAgentEndpoint {
-  getUserInfo(userId: string): Promise<unknown>;
-  getDepartmentUsers(deptId: number): Promise<unknown[]>;
-  sendWorkNotice(userIdList: string[], content: unknown): Promise<boolean>;
-  getDepartmentList(deptId?: number): Promise<unknown[]>;
-  getDepartmentInfo(deptId: number): Promise<unknown>;
-  createChat(name: string, ownerUserId: string, userIdList: string[]): Promise<string | null>;
-  getChatInfo(chatId: string): Promise<unknown>;
-  updateChat(
-    chatId: string,
-    options: {
-      name?: string;
-      owner?: string;
-      add_useridlist?: string[];
-      del_useridlist?: string[];
-    },
-  ): Promise<boolean>;
-}
-
-export interface DingtalkAgentDeps {
-  getEndpoint: (endpointKey: string) => DingtalkAgentEndpoint;
-}
-
-const endpoints = new Map<string, DingtalkAgentEndpoint>();
-let override: DingtalkAgentDeps | null = null;
-
-export function registerDingtalkAgentEndpoint(
-  endpointKey: string,
-  endpoint: DingtalkAgentEndpoint,
-): () => 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 setDingtalkAgentDeps(deps: DingtalkAgentDeps | null): void {
-  override = deps;
-}
-
-export function getDingtalkAgentDeps(): DingtalkAgentDeps {
-  if (override) return override;
-  return {
-    getEndpoint(endpointKey) {
-      const endpoint = endpoints.get(endpointKey);
-      if (!endpoint) throw new Error(`Endpoint ${endpointKey} 不存在`);
-      return endpoint;
-    },
-  };
-}