evolcore 0.0.12 → 0.0.14

package/dist/core/message/message-utils.js

@@ -9,6 +9,10 @@ import { renderCommandCardAsText, renderActionAsText } from '../interaction-rout
  */
 export function buildEnvelope(opts) {
     const taskId = opts.taskId ?? `interaction-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const delivery = opts.delivery ?? opts.replyContext?.delivery;
+    const replyContext = opts.replyContext
+        ? { ...opts.replyContext, ...(delivery ? { delivery } : {}) }
+        : undefined;
     return {
         taskId,
         operationId: opts.operationId ?? taskId,
@@ -17,11 +21,86 @@ export function buildEnvelope(opts) {
         channelId: opts.channelId,
         agentName: opts.agentName ?? '<unknown>',
         chatmode: opts.chatmode ?? 'interactive',
-        replyContext: opts.replyContext,
+        delivery,
+        replyContext,
         causation: opts.causation,
         timestamp: opts.timestamp ?? Date.now(),
     };
 }
+/**
+ * Replace an envelope's reply context while keeping its transport route
+ * authoritative at the top level. A per-send context may intentionally move
+ * a reply to another target (for example owner approval in a private chat).
+ */
+export function withEnvelopeReplyContext(envelope, replyContext) {
+    const delivery = replyContext?.delivery ?? envelope.delivery;
+    return {
+        ...envelope,
+        ...(delivery ? { delivery } : {}),
+        ...(replyContext
+            ? {
+                replyContext: {
+                    ...replyContext,
+                    ...(delivery ? { delivery } : {}),
+                },
+            }
+            : {}),
+    };
+}
+/** Runtime validation for routes persisted in envelopes, sessions, and outbox entries. */
+export function isDeliveryTarget(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const route = value;
+    if (route.chatType === 'private')
+        return true;
+    return route.chatType === 'group'
+        && typeof route.groupId === 'string'
+        && route.groupId.trim().length > 0;
+}
+/** Validate a route and ensure group routes address the enclosing channel. */
+export function isDeliveryTargetForChannel(value, channelId) {
+    return isDeliveryTarget(value)
+        && (value.chatType === 'private' || value.groupId === channelId);
+}
+/** Compare normalized private/group delivery routes. */
+export function sameDeliveryTarget(left, right) {
+    return left.chatType === right.chatType
+        && (left.chatType === 'private'
+            || (right.chatType === 'group' && left.groupId === right.groupId));
+}
+/** Resolve an outbound route from trusted, persisted session state. */
+export function deliveryTargetFromSession(session) {
+    const channelType = session.channelType || session.channel?.split('#', 1)[0];
+    const strictAun = channelType?.toLowerCase() === 'aun';
+    if (session.chatType === 'group') {
+        const groupId = session.metadata?.groupId;
+        if (strictAun && (!groupId || groupId !== session.channelId)) {
+            const code = groupId ? 'AUN_OUTBOUND_ROUTE_MISMATCH' : 'AUN_OUTBOUND_ROUTE_REQUIRED';
+            throw Object.assign(new Error(`AUN group session has no valid persisted groupId for channelId=${session.channelId}`), { code });
+        }
+        return { chatType: 'group', groupId: groupId || session.channelId };
+    }
+    if (session.chatType === 'private')
+        return { chatType: 'private' };
+    if (strictAun) {
+        throw Object.assign(new Error(`AUN session has no persisted chatType for channelId=${session.channelId}`), {
+            code: 'AUN_OUTBOUND_ROUTE_REQUIRED',
+        });
+    }
+    return { chatType: 'private' };
+}
+/** Preserve channel-specific reply fields while filling the session route. */
+export function replyContextFromSession(session, context) {
+    return {
+        ...(session.metadata?.replyContext ?? {}),
+        ...(context ?? {}),
+        // Session chatType/groupId is the persisted routing authority. The nested
+        // reply context can outlive a route correction, so only an explicit
+        // per-send context may override it.
+        delivery: context?.delivery ?? deliveryTargetFromSession(session),
+    };
+}
 /**
  * 交互请求的默认回退文本
  * 当调用方未显式提供时使用，根据交互类型选择合适的渲染器。
@@ -60,9 +139,7 @@ export async function sendInteractionPayload(adapter, envelope, interaction, fal
         fallbackText: text || undefined,
     };
     try {
-        const enriched = replyCtx
-            ? { ...envelope, replyContext: replyCtx }
-            : envelope;
+        const enriched = replyCtx ? withEnvelopeReplyContext(envelope, replyCtx) : envelope;
         const receipt = await adapter.send(enriched, payload);
         if (receipt?.status === 'suppressed')
             return false;