@zhin.js/core 1.5.6 → 1.5.7

package/lib/plugin-runtime/im/im-runtime.d.ts

@@ -1,4 +1,4 @@
-import { Scope, type PluginId, type SnapshotLease, type SnapshotStore } from '@zhin.js/plugin-runtime';
+import { Scope, type PluginId, type RuntimeSnapshot, type SnapshotLease, type SnapshotStore } from '@zhin.js/plugin-runtime';
 import { MessageBus } from './message-bus.js';
 import { type EndpointManagement, type EndpointManagementCapability } from '@zhin.js/adapter';
 import { type ConversationRef, type DeliveryReceipt, type MessageRef } from '@zhin.js/im-contract';
@@ -34,6 +34,13 @@ export interface ImRuntimeOptions {
     readonly renderer?: OutboundRenderer;
     /** Process-root ingress claim (pending interaction, authentication challenge, etc.). */
     readonly inboundClaim?: (message: Message) => boolean | Promise<boolean>;
+    /**
+     * 入站 sender 增强：在构造 Message 前，将框架级角色（master / trusted）
+     * 合并到 sender.roles，使整个下游链路（命令分发、agent ingress 等）都能读到完整角色。
+     *
+     * 返回增强后的 sender（可原样返回）。缺省时 sender 保留适配器给出的平台角色。
+     */
+    readonly enrichSender?: (sender: MessageSenderRef | undefined, conversation: IncomingMessage['conversation'], snapshot: RuntimeSnapshot) => MessageSenderRef | undefined;
 }
 export declare class ImRuntime implements MessageGateway {
     #private;

package/lib/plugin-runtime/im/im-runtime.js

@@ -23,12 +23,14 @@ export class ImRuntime {
     #interactiveHandlers = [];
     #snapshots;
     #inboundClaim;
+    #enrichSender;
     constructor(options = {}) {
         this.#dispatcher = new MessageDispatcher(options.commandPrefix === undefined
             ? defaultCommandPrefixResolver
             : () => options.commandPrefix ?? '');
         this.#renderer = options.renderer ?? new OutboundRenderer();
         this.#inboundClaim = options.inboundClaim;
+        this.#enrichSender = options.enrichSender;
     }
     attach(snapshots) {
         if (this.#snapshots && this.#snapshots !== snapshots) {
@@ -87,6 +89,9 @@ export class ImRuntime {
                 sender: `${input.sender?.name || 'undefined'}(${input.sender?.id || 'undefined'})`,
                 preview: truncatePreview(input.content),
             }));
+            const enrichedSender = this.#enrichSender
+                ? this.#enrichSender(input.sender, conversation, lease.value)
+                : input.sender;
             const message = new Message(conversation, input.content, lease.value.generation, (content, replyRequester = requester, targetConversation) => {
                 if (!active)
                     throw new Error('Message reply scope has ended');
@@ -98,7 +103,7 @@ export class ImRuntime {
                     requester: replyRequester,
                     content,
                     incoming: {
-                        sender: input.sender,
+                        sender: enrichedSender,
                         content: input.content,
                         segments: input.segments,
                         messageId: input.message?.id,
@@ -107,7 +112,7 @@ export class ImRuntime {
                         mentioned: input.mentioned,
                     },
                 }, lease.value);
-            }, input.sender, Object.freeze({ ...input.metadata }), input.segments ? Object.freeze([...input.segments]) : undefined, input.message, input.endpointId, input.mentioned, input.replyTo);
+            }, enrichedSender, Object.freeze({ ...input.metadata }), input.segments ? Object.freeze([...input.segments]) : undefined, input.message, input.endpointId, input.mentioned, input.replyTo);
             let result = Object.freeze({ matched: false });
             const claimed = await this.#inboundClaim?.(message) === true;
             if (claimed) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/core",
-  "version": "1.5.6",
+  "version": "1.5.7",
   "description": "Zhin机器人核心框架",
   "type": "module",
   "main": "./lib/index.js",