@zhin.js/adapter-milky 6.0.2 → 6.0.5

package/lib/webhook-endpoint.js

@@ -1,10 +1,10 @@
-import { formatCompact, getLogger } from '@zhin.js/logger';
+import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { readRequestBody, verifyMilkyAccessToken } from './milky-auth.js';
 import { createMilkyEndpointManagement } from './endpoint-management.js';
 import { registerMilkyAgentEndpoint } from './milky-agent-deps.js';
-import { buildSendAction, callApi, extractInboundAudioUrl, formatInboundContent, formatInboundMessageId, formatInboundSegments, formatInboundTarget, formatOutboundMessageId, formatOutboundSegments, isMentioned, parseMessageReceiveData, parseMilkyMessageId, senderNickname, } from './protocol.js';
-const logger = getLogger('milky');
+import { buildSendAction, callApi, extractInboundAudioUrl, formatInboundContent, formatInboundMessageId, formatInboundSegments, formatOutboundMessageId, formatOutboundSegments, isMentioned, milkyInboundConversation, parseMessageReceiveData, parseMilkyMessageId, senderNickname, } from './protocol.js';
 export class MilkyWebhookEndpoint {
+    #logger;
     #options;
     #callApi;
     management = createMilkyEndpointManagement(this);
@@ -13,6 +13,7 @@ export class MilkyWebhookEndpoint {
     #started = false;
     #unregisterAgent;
     constructor(options) {
+        this.#logger = getAdapterLogger('milky', options.config.id);
         this.#options = options;
         this.#callApi = options.callApi ?? callApi;
     }
@@ -20,11 +21,11 @@ export class MilkyWebhookEndpoint {
         if (this.#started)
             return;
         this.#started = true;
-        this.#unregisterAgent = registerMilkyAgentEndpoint(this.#options.config.name, this);
+        this.#unregisterAgent = registerMilkyAgentEndpoint(this.#options.config.id, this);
         this.#setupRoutes();
-        logger.info(formatCompact({
+        this.#logger.info(formatCompact({
             op: 'listen',
-            endpoint: this.#options.config.name,
+            endpoint: this.#options.config.id,
             mode: 'webhook',
             path: this.#options.config.path,
         }));
@@ -42,17 +43,17 @@ export class MilkyWebhookEndpoint {
         this.#unregisterAgent?.();
         this.#unregisterAgent = undefined;
         this.#started = false;
-        logger.debug(formatCompact({ op: 'disconnect', endpoint: this.#options.config.name }));
+        this.#logger.debug(formatCompact({ op: 'disconnect' }));
     }
-    async send({ target, payload }) {
+    async send({ conversation, payload }) {
         const message = formatOutboundSegments(payload);
-        const { action, params } = buildSendAction(target, message);
+        const { action, params } = buildSendAction(conversation, message);
         const data = await this.callApi(action, params);
-        const messageId = formatOutboundMessageId(target, data?.message_seq);
-        logger.debug(formatCompact({
+        const messageId = formatOutboundMessageId(conversation, data?.message_seq);
+        this.#logger.debug(formatCompact({
             op: 'milky_send',
-            endpoint: this.#options.config.name,
-            target,
+            endpoint: this.#options.config.id,
+            target: `${conversation.kind}:${conversation.id}`,
             messageId,
         }));
         return messageId;
@@ -144,33 +145,32 @@ export class MilkyWebhookEndpoint {
         };
     }
     #admitMessage(data, event) {
-        const target = formatInboundTarget(data);
+        const conversation = milkyInboundConversation(String(this.#options.id), data);
+        const target = `${conversation.kind}:${conversation.id}`;
         const content = formatInboundContent(data);
         const segments = formatInboundSegments(data);
         const audioUrl = extractInboundAudioUrl(data);
         const nickname = senderNickname(data);
         const mentioned = isMentioned(data, event.self_id);
         void this.#options.gateway.receive({
-            adapter: this.#options.id,
-            target,
+            conversation,
+            message: { conversation, id: formatInboundMessageId(data) },
             content,
             segments,
-            sender: String(data.sender_id),
-            id: formatInboundMessageId(data),
+            sender: { id: String(data.sender_id), name: nickname },
+            endpointId: this.#options.config.id,
+            ...(mentioned ? { mentioned: true } : {}),
             metadata: Object.freeze({
                 message_scene: data.message_scene,
                 peer_id: String(data.peer_id),
                 sender_id: String(data.sender_id),
                 message_seq: data.message_seq,
-                endpoint: this.#options.config.name,
                 time: data.time ?? event.time,
                 self_id: event.self_id != null ? String(event.self_id) : undefined,
                 ...(nickname ? { nickname } : {}),
-                ...(mentioned ? { mentioned: true } : {}),
-                ...(audioUrl ? { audio_url: audioUrl } : {}),
             }),
         }).catch((err) => {
-            logger.warn(formatCompact({
+            this.#logger.warn(formatCompact({
                 op: 'milky_gateway_receive_failed',
                 target,
                 error: err instanceof Error ? err.message : String(err),
@@ -206,7 +206,7 @@ export class MilkyWebhookEndpoint {
             response.end(JSON.stringify({ status: 'ok' }));
         }
         catch (error) {
-            logger.error('Milky webhook error:', error);
+            this.#logger.error('Milky webhook error:', error);
             if (!response.headersSent) {
                 response.writeHead(500, { 'Content-Type': 'application/json' });
                 response.end(JSON.stringify({ message: 'Internal Server Error' }));

package/lib/ws-endpoint.d.ts

@@ -1,4 +1,4 @@
-import { type EndpointInstance, type EndpointManagement } from '@zhin.js/adapter';
+import { type EndpointInstance, type EndpointManagement, type EndpointSendRequest } from '@zhin.js/adapter';
 import type { MessageGateway } from '@zhin.js/core/runtime';
 import type { CapabilityId } from '@zhin.js/plugin-runtime';
 import { callApi, type MilkyEvent, type MilkyWsConfig } from './protocol.js';
@@ -18,10 +18,7 @@ export declare class MilkyWsEndpoint implements EndpointInstance {
     open(): void;
     close(): void;
     stop(): Promise<void>;
-    send({ target, payload }: {
-        readonly target: string;
-        readonly payload: unknown;
-    }): Promise<string>;
+    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
     /** Public API for agent tools / callers. */
     callApi(action: string, params?: Record<string, unknown>): Promise<unknown>;
     recallMessage(id: string): Promise<void>;

package/lib/ws-endpoint.js

@@ -3,13 +3,13 @@
  */
 import WebSocket from 'ws';
 import { createEndpointLifecycle, } from '@zhin.js/adapter';
-import { formatCompact, getLogger } from '@zhin.js/logger';
+import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { createMilkyEndpointManagement } from './endpoint-management.js';
 import { registerMilkyAgentEndpoint } from './milky-agent-deps.js';
-import { buildSendAction, buildWsConnectOptions, callApi, extractInboundAudioUrl, formatInboundContent, formatInboundMessageId, formatInboundSegments, formatInboundTarget, formatOutboundMessageId, formatOutboundSegments, isMentioned, parseMessageReceiveData, parseMilkyMessageId, senderNickname, } from './protocol.js';
-const logger = getLogger('milky');
+import { buildSendAction, buildWsConnectOptions, callApi, extractInboundAudioUrl, formatInboundContent, formatInboundMessageId, formatInboundSegments, formatOutboundMessageId, formatOutboundSegments, isMentioned, milkyInboundConversation, parseMessageReceiveData, parseMilkyMessageId, senderNickname, } from './protocol.js';
 const WS_OPEN = 1;
 export class MilkyWsEndpoint {
+    #logger;
     #options;
     #callApi;
     management = createMilkyEndpointManagement(this);
@@ -18,10 +18,11 @@ export class MilkyWsEndpoint {
     #open = false;
     #unregisterAgent;
     constructor(options) {
+        this.#logger = getAdapterLogger('milky', options.config.id);
         this.#options = options;
         this.#callApi = options.callApi ?? callApi;
         this.#lifecycle = createEndpointLifecycle({
-            name: options.config.name,
+            name: options.config.id,
             // reconnect_interval 旧语义为固定间隔：multiplier 1 + 无 jitter + 不封顶
             reconnect: {
                 initialIntervalMs: options.config.reconnect_interval,
@@ -34,7 +35,7 @@ export class MilkyWsEndpoint {
     async start() {
         if (this.#lifecycle.started)
             return;
-        this.#unregisterAgent = registerMilkyAgentEndpoint(this.#options.config.name, this);
+        this.#unregisterAgent = registerMilkyAgentEndpoint(this.#options.config.id, this);
         try {
             await this.#lifecycle.start((handle) => this.#connect(handle));
         }
@@ -66,15 +67,15 @@ export class MilkyWsEndpoint {
             this.#ws = undefined;
         }
     }
-    async send({ target, payload }) {
+    async send({ conversation, payload }) {
         const message = formatOutboundSegments(payload);
-        const { action, params } = buildSendAction(target, message);
+        const { action, params } = buildSendAction(conversation, message);
         const data = await this.callApi(action, params);
-        const messageId = formatOutboundMessageId(target, data?.message_seq);
-        logger.debug(formatCompact({
+        const messageId = formatOutboundMessageId(conversation, data?.message_seq);
+        this.#logger.debug(formatCompact({
             op: 'milky_send',
-            endpoint: this.#options.config.name,
-            target,
+            endpoint: this.#options.config.id,
+            target: `${conversation.kind}:${conversation.id}`,
             messageId,
         }));
         return messageId;
@@ -168,33 +169,32 @@ export class MilkyWsEndpoint {
         };
     }
     #admitMessage(data, event) {
-        const target = formatInboundTarget(data);
+        const conversation = milkyInboundConversation(String(this.#options.id), data);
+        const target = `${conversation.kind}:${conversation.id}`;
         const content = formatInboundContent(data);
         const segments = formatInboundSegments(data);
         const audioUrl = extractInboundAudioUrl(data);
         const nickname = senderNickname(data);
         const mentioned = isMentioned(data, event.self_id);
         void this.#options.gateway.receive({
-            adapter: this.#options.id,
-            target,
+            conversation,
+            message: { conversation, id: formatInboundMessageId(data) },
             content,
             segments,
-            sender: String(data.sender_id),
-            id: formatInboundMessageId(data),
+            sender: { id: String(data.sender_id), name: nickname },
+            endpointId: this.#options.config.id,
+            ...(mentioned ? { mentioned: true } : {}),
             metadata: Object.freeze({
                 message_scene: data.message_scene,
                 peer_id: String(data.peer_id),
                 sender_id: String(data.sender_id),
                 message_seq: data.message_seq,
-                endpoint: this.#options.config.name,
                 time: data.time ?? event.time,
                 self_id: event.self_id != null ? String(event.self_id) : undefined,
                 ...(nickname ? { nickname } : {}),
-                ...(mentioned ? { mentioned: true } : {}),
-                ...(audioUrl ? { audio_url: audioUrl } : {}),
             }),
         }).catch((err) => {
-            logger.warn(formatCompact({
+            this.#logger.warn(formatCompact({
                 op: 'milky_gateway_receive_failed',
                 target,
                 error: err instanceof Error ? err.message : String(err),
@@ -222,14 +222,14 @@ export class MilkyWsEndpoint {
                     return;
                 settled = true;
                 if (!this.#options.config.access_token) {
-                    logger.warn(formatCompact({
-                        endpoint: this.#options.config.name,
+                    this.#logger.warn(formatCompact({
+                        endpoint: this.#options.config.id,
                         ok: false,
                         error: 'missing access_token',
                     }));
                 }
-                logger.debug(formatCompact({
-                    endpoint: this.#options.config.name,
+                this.#logger.debug(formatCompact({
+                    endpoint: this.#options.config.id,
                     mode: 'ws',
                     url: safeUrl,
                 }));
@@ -262,9 +262,8 @@ export class MilkyWsEndpoint {
                     : codeNum === 1006
                         ? ' [异常关闭]'
                         : '';
-                logger.warn(formatCompact({
+                this.#logger.warn(formatCompact({
                     op: 'disconnect',
-                    endpoint: this.#options.config.name,
                     code: codeNum,
                     error: `${reasonStr || 'closed'}${codeHint}`,
                     reconnect_ms: this.#options.config.reconnect_interval,
@@ -278,9 +277,9 @@ export class MilkyWsEndpoint {
             });
             ws.on('error', (err) => {
                 const error = err instanceof Error ? err : new Error(String(err));
-                logger.warn(formatCompact({
+                this.#logger.warn(formatCompact({
                     op: 'ws_error',
-                    endpoint: this.#options.config.name,
+                    endpoint: this.#options.config.id,
                     ok: false,
                     error: error.message,
                 }));
@@ -304,9 +303,9 @@ export class MilkyWsEndpoint {
             this.admit(event);
         }
         catch (error) {
-            logger.warn(formatCompact({
+            this.#logger.warn(formatCompact({
                 op: 'milky_parse_failed',
-                endpoint: this.#options.config.name,
+                endpoint: this.#options.config.id,
                 error: error instanceof Error ? error.message : String(error),
             }));
         }

package/lib/wss-endpoint.d.ts

@@ -1,4 +1,4 @@
-import type { EndpointInstance, EndpointManagement } from '@zhin.js/adapter';
+import type { EndpointInstance, EndpointManagement, EndpointSendRequest } from '@zhin.js/adapter';
 import type { MessageGateway } from '@zhin.js/core/runtime';
 import type { HttpHost } from '@zhin.js/host-http';
 import type { CapabilityId } from '@zhin.js/plugin-runtime';
@@ -18,10 +18,7 @@ export declare class MilkyWssEndpoint implements EndpointInstance {
     open(): void;
     close(): void;
     stop(): Promise<void>;
-    send({ target, payload }: {
-        readonly target: string;
-        readonly payload: unknown;
-    }): Promise<string>;
+    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
     callApi(action: string, params?: Record<string, unknown>): Promise<unknown>;
     recallMessage(id: string): Promise<void>;
     kickMember(groupId: number, userId: number, rejectAddRequest?: boolean): Promise<boolean>;

package/lib/wss-endpoint.js

@@ -2,14 +2,14 @@
  * Milky reverse WSS endpoint — httpHostToken WS upgrade inbound + baseUrl HTTP API outbound.
  */
 import { clearInterval } from 'node:timers';
-import { formatCompact, getLogger } from '@zhin.js/logger';
+import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { verifyMilkyAccessToken } from './milky-auth.js';
 import { createMilkyEndpointManagement } from './endpoint-management.js';
 import { registerMilkyAgentEndpoint } from './milky-agent-deps.js';
-import { buildSendAction, callApi, extractInboundAudioUrl, formatInboundContent, formatInboundMessageId, formatInboundSegments, formatInboundTarget, formatOutboundMessageId, formatOutboundSegments, isMentioned, parseMessageReceiveData, parseMilkyMessageId, senderNickname, } from './protocol.js';
-const logger = getLogger('milky');
+import { buildSendAction, callApi, extractInboundAudioUrl, formatInboundContent, formatInboundMessageId, formatInboundSegments, formatOutboundMessageId, formatOutboundSegments, isMentioned, milkyInboundConversation, parseMessageReceiveData, parseMilkyMessageId, senderNickname, } from './protocol.js';
 const WS_OPEN = 1;
 export class MilkyWssEndpoint {
+    #logger;
     #options;
     #callApi;
     management = createMilkyEndpointManagement(this);
@@ -20,6 +20,7 @@ export class MilkyWssEndpoint {
     #started = false;
     #unregisterAgent;
     constructor(options) {
+        this.#logger = getAdapterLogger('milky', options.config.id);
         this.#options = options;
         this.#callApi = options.callApi ?? callApi;
     }
@@ -27,14 +28,14 @@ export class MilkyWssEndpoint {
         if (this.#started)
             return;
         this.#started = true;
-        this.#unregisterAgent = registerMilkyAgentEndpoint(this.#options.config.name, this);
+        this.#unregisterAgent = registerMilkyAgentEndpoint(this.#options.config.id, this);
         const handle = this.#options.http.ws(this.#options.config.path);
         this.#wsRelease = handle.onConnection((connection) => {
             this.#acceptConnection(connection);
         });
-        logger.info(formatCompact({
+        this.#logger.info(formatCompact({
             op: 'listen',
-            endpoint: this.#options.config.name,
+            endpoint: this.#options.config.id,
             mode: 'wss',
             path: this.#options.config.path,
         }));
@@ -66,15 +67,15 @@ export class MilkyWssEndpoint {
         }
         this.#started = false;
     }
-    async send({ target, payload }) {
+    async send({ conversation, payload }) {
         const message = formatOutboundSegments(payload);
-        const { action, params } = buildSendAction(target, message);
+        const { action, params } = buildSendAction(conversation, message);
         const data = await this.callApi(action, params);
-        const messageId = formatOutboundMessageId(target, data?.message_seq);
-        logger.debug(formatCompact({
+        const messageId = formatOutboundMessageId(conversation, data?.message_seq);
+        this.#logger.debug(formatCompact({
             op: 'milky_send',
-            endpoint: this.#options.config.name,
-            target,
+            endpoint: this.#options.config.id,
+            target: `${conversation.kind}:${conversation.id}`,
             messageId,
         }));
         return messageId;
@@ -166,33 +167,32 @@ export class MilkyWssEndpoint {
         };
     }
     #admitMessage(data, event) {
-        const target = formatInboundTarget(data);
+        const conversation = milkyInboundConversation(String(this.#options.id), data);
+        const target = `${conversation.kind}:${conversation.id}`;
         const content = formatInboundContent(data);
         const segments = formatInboundSegments(data);
         const audioUrl = extractInboundAudioUrl(data);
         const nickname = senderNickname(data);
         const mentioned = isMentioned(data, event.self_id);
         void this.#options.gateway.receive({
-            adapter: this.#options.id,
-            target,
+            conversation,
+            message: { conversation, id: formatInboundMessageId(data) },
             content,
             segments,
-            sender: String(data.sender_id),
-            id: formatInboundMessageId(data),
+            sender: { id: String(data.sender_id) },
+            endpointId: this.#options.config.id,
+            ...(mentioned ? { mentioned: true } : {}),
             metadata: Object.freeze({
                 message_scene: data.message_scene,
                 peer_id: String(data.peer_id),
                 sender_id: String(data.sender_id),
                 message_seq: data.message_seq,
-                endpoint: this.#options.config.name,
                 time: data.time ?? event.time,
                 self_id: event.self_id != null ? String(event.self_id) : undefined,
                 ...(nickname ? { nickname } : {}),
-                ...(mentioned ? { mentioned: true } : {}),
-                ...(audioUrl ? { audio_url: audioUrl } : {}),
             }),
         }).catch((err) => {
-            logger.warn(formatCompact({
+            this.#logger.warn(formatCompact({
                 op: 'milky_gateway_receive_failed',
                 target,
                 error: err instanceof Error ? err.message : String(err),
@@ -222,8 +222,8 @@ export class MilkyWssEndpoint {
             if (this.#ws === socket)
                 this.#ws = undefined;
         });
-        logger.debug(formatCompact({
-            endpoint: this.#options.config.name,
+        this.#logger.debug(formatCompact({
+            endpoint: this.#options.config.id,
             mode: 'wss',
             peer: connection.request.socket.remoteAddress,
         }));
@@ -241,9 +241,9 @@ export class MilkyWssEndpoint {
             this.admit(event);
         }
         catch (error) {
-            logger.warn(formatCompact({
+            this.#logger.warn(formatCompact({
                 op: 'milky_parse_failed',
-                endpoint: this.#options.config.name,
+                endpoint: this.#options.config.id,
                 error: error instanceof Error ? error.message : String(error),
             }));
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-milky",
-  "version": "6.0.2",
+  "version": "6.0.5",
   "description": "Zhin.js Milky adapter for Plugin Runtime (WebSocket client)",
   "type": "module",
   "main": "./lib/index.js",
@@ -40,12 +40,13 @@
   },
   "dependencies": {
     "ws": "^8.21.1",
-    "@zhin.js/adapter": "1.1.4",
-    "@zhin.js/command": "1.0.6",
-    "@zhin.js/core": "1.5.1",
-    "@zhin.js/host-http": "1.0.5",
-    "@zhin.js/logger": "1.0.75",
-    "@zhin.js/plugin-runtime": "1.1.2"
+    "@zhin.js/adapter": "1.1.7",
+    "@zhin.js/command": "1.0.9",
+    "@zhin.js/core": "1.5.4",
+    "@zhin.js/host-http": "1.0.8",
+    "@zhin.js/im-contract": "1.0.3",
+    "@zhin.js/logger": "1.0.76",
+    "@zhin.js/plugin-runtime": "1.1.5"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
@@ -53,16 +54,16 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.2",
-    "@zhin.js/host-http": "1.0.5"
+    "@zhin.js/agent": "1.1.5",
+    "@zhin.js/host-http": "1.0.8"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "1.1.4",
-    "@zhin.js/agent": "1.1.2",
-    "@zhin.js/core": "1.5.1",
-    "@zhin.js/plugin-runtime": "1.1.2",
-    "zhin.js": "6.0.1"
+    "@zhin.js/adapter": "1.1.7",
+    "@zhin.js/agent": "1.1.5",
+    "@zhin.js/core": "1.5.4",
+    "@zhin.js/plugin-runtime": "1.1.5",
+    "zhin.js": "6.0.4"
   },
   "peerDependenciesMeta": {
     "zhin.js": {

package/schema.json

@@ -22,16 +22,48 @@
       "type": "number",
       "default": 30000
     },
+    "master": {
+      "type": [
+        "string",
+        "number"
+      ],
+      "description": "框架 master（QQ uin；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖"
+    },
+    "trusted": {
+      "type": "array",
+      "items": {
+        "type": [
+          "string",
+          "number"
+        ],
+        "description": "Trusted QQ uin"
+      },
+      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加"
+    },
     "endpoints": {
       "type": "array",
-      "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（name 必填，其余覆盖顶层）",
+      "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（id 必填，其余覆盖顶层）",
       "items": {
         "type": "object",
         "additionalProperties": true,
         "properties": {
-          "name": {
-            "type": "string",
-            "description": "Milky bot name"
+          "master": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "本 endpoint 的框架 master（QQ uin）；覆盖顶层 master"
+          },
+          "trusted": {
+            "type": "array",
+            "items": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Trusted QQ uin"
+            },
+            "description": "本 endpoint 的 trusted 列表"
           },
           "baseUrl": {
             "type": "string",
@@ -44,10 +76,14 @@
           "access_token": {
             "type": "string",
             "description": "Milky access token"
+          },
+          "id": {
+            "type": "string",
+            "description": "Milky bot name"
           }
         },
         "required": [
-          "name",
+          "id",
           "baseUrl"
         ]
       }

package/src/index.ts

@@ -5,15 +5,11 @@ export {
   callApi,
   extractInboundAudioUrl,
   formatInboundContent,
-  formatInboundMessageId,
-  formatInboundTarget,
-  formatOutboundMessageId,
   formatOutboundSegments,
   isMentioned,
   isMessageReceiveEvent,
+  milkyInboundConversation,
   parseMessageReceiveData,
-  parseMilkyMessageId,
-  parseSendTarget,
   resolveMilkyConfig,
   senderNickname,
   type MilkyAdapterConfig,
@@ -30,7 +26,6 @@ export {
   type MilkyWireSegment,
   type MilkyWsConfig,
   type MilkyWssConfig,
-  type ParsedSendTarget,
   type ResolvedMilkyConfig,
 } from './protocol.js';
 

package/src/milky-agent-deps.ts

@@ -18,20 +18,20 @@ export interface MilkyAgentEndpoint {
 }
 
 export interface MilkyAgentDeps {
-  getEndpoint: (endpointId: string) => MilkyAgentEndpoint;
+  getEndpoint: (endpointKey: string) => MilkyAgentEndpoint;
 }
 
 const endpoints = new Map<string, MilkyAgentEndpoint>();
 let override: MilkyAgentDeps | null = null;
 
 export function registerMilkyAgentEndpoint(
-  endpointId: string,
+  endpointKey: string,
   endpoint: MilkyAgentEndpoint,
 ): () => void {
-  endpoints.set(endpointId, endpoint);
+  endpoints.set(endpointKey, endpoint);
   return () => {
-    if (endpoints.get(endpointId) === endpoint) {
-      endpoints.delete(endpointId);
+    if (endpoints.get(endpointKey) === endpoint) {
+      endpoints.delete(endpointKey);
     }
   };
 }
@@ -44,9 +44,9 @@ export function setMilkyAgentDeps(deps: MilkyAgentDeps | null): void {
 export function getMilkyAgentDeps(): MilkyAgentDeps {
   if (override) return override;
   return {
-    getEndpoint(endpointId: string): MilkyAgentEndpoint {
-      const registered = endpoints.get(endpointId);
-      if (!registered) throw new Error(`Endpoint ${endpointId} 不存在`);
+    getEndpoint(endpointKey: string): MilkyAgentEndpoint {
+      const registered = endpoints.get(endpointKey);
+      if (!registered) throw new Error(`Endpoint ${endpointKey} 不存在`);
       return registered;
     },
   };