@ai-matrx/messaging 0.10.1 → 0.10.3

package/dist/index.d.cts

@@ -291,6 +291,8 @@ interface ActorPresentation {
     /** The audit principal. Always the row's `sender_id`. Never rewritten. */
     readonly principalUserId: Message["senderId"];
 }
+/** Stable presentation identity for grouping adjacent messages in the UI. */
+declare function effectiveActorKey(message: Message): string;
 declare function resolveActor(message: Message, sender: UserSummary | null): ActorPresentation;
 
 /**
@@ -1030,6 +1032,8 @@ declare function groupMessages(messages: readonly Message[], args?: {
     now?: number;
     windowMs?: number;
     locale?: string;
+    /** Split audit-principal rows by their effective actor presentation. */
+    actorKey?: (message: Message) => string;
 }): readonly MessageGroup[];
 /** "Ana is typing…" / "Ana and Bo are typing…" / "3 people are typing…" */
 declare function formatTypists(names: readonly string[]): string | null;
@@ -1115,4 +1119,4 @@ declare function summarizeText(content: string, maxLength?: number): string;
 /** Serialize picked references into a fence the platform's other readers accept. */
 declare function composeFence(references: readonly MatrxReference[]): string;
 
-export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCallArgs, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationCursor, type ConversationId, type ConversationSummary, type ConversationThread, type ConversationType, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, type SchemaLike, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createWebOutboxStorage, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, splitText, summarizeText, unreadCutoff };
+export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCallArgs, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationCursor, type ConversationId, type ConversationSummary, type ConversationThread, type ConversationType, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, type SchemaLike, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createWebOutboxStorage, effectiveActorKey, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, splitText, summarizeText, unreadCutoff };

package/dist/index.d.ts

@@ -291,6 +291,8 @@ interface ActorPresentation {
     /** The audit principal. Always the row's `sender_id`. Never rewritten. */
     readonly principalUserId: Message["senderId"];
 }
+/** Stable presentation identity for grouping adjacent messages in the UI. */
+declare function effectiveActorKey(message: Message): string;
 declare function resolveActor(message: Message, sender: UserSummary | null): ActorPresentation;
 
 /**
@@ -1030,6 +1032,8 @@ declare function groupMessages(messages: readonly Message[], args?: {
     now?: number;
     windowMs?: number;
     locale?: string;
+    /** Split audit-principal rows by their effective actor presentation. */
+    actorKey?: (message: Message) => string;
 }): readonly MessageGroup[];
 /** "Ana is typing…" / "Ana and Bo are typing…" / "3 people are typing…" */
 declare function formatTypists(names: readonly string[]): string | null;
@@ -1115,4 +1119,4 @@ declare function summarizeText(content: string, maxLength?: number): string;
 /** Serialize picked references into a fence the platform's other readers accept. */
 declare function composeFence(references: readonly MatrxReference[]): string;
 
-export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCallArgs, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationCursor, type ConversationId, type ConversationSummary, type ConversationThread, type ConversationType, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, type SchemaLike, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createWebOutboxStorage, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, splitText, summarizeText, unreadCutoff };
+export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCallArgs, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationCursor, type ConversationId, type ConversationSummary, type ConversationThread, type ConversationType, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, type SchemaLike, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createWebOutboxStorage, effectiveActorKey, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, splitText, summarizeText, unreadCutoff };

package/dist/index.js

@@ -71,19 +71,38 @@ function createActionRegistry() {
 
 // src/core/actor.ts
 function readActorHint(metadata) {
-  const raw = metadata["actor"];
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return null;
-  const record = raw;
-  const agentId = record["agentId"] ?? record["agent_id"];
-  if (typeof agentId !== "string" || agentId.length === 0) return null;
-  const name = record["agentName"] ?? record["agent_name"];
-  const avatar = record["agentAvatarUrl"] ?? record["agent_avatar_url"];
+  const envelope = metadata;
+  const raw = envelope["actor"];
+  if (typeof raw === "object" && raw !== null && !Array.isArray(raw)) {
+    const record = raw;
+    const agentId = record["agentId"] ?? record["agent_id"];
+    if (typeof agentId !== "string" || agentId.length === 0) return null;
+    const name2 = record["agentName"] ?? record["agent_name"];
+    const avatar2 = record["agentAvatarUrl"] ?? record["agent_avatar_url"];
+    return {
+      agentId,
+      showPrincipalAttribution: true,
+      ...typeof name2 === "string" && name2.length > 0 ? { agentName: name2 } : {},
+      ...typeof avatar2 === "string" && avatar2.length > 0 ? { agentAvatarUrl: avatar2 } : {}
+    };
+  }
+  const actorKind = envelope["actor_kind"] ?? envelope["actorKind"];
+  if (actorKind !== "agent") return null;
+  const id = envelope["actor_id"] ?? envelope["actorId"];
+  const name = envelope["actor_label"] ?? envelope["actorLabel"];
+  const avatar = envelope["actor_avatar_url"] ?? envelope["actorAvatarUrl"];
   return {
-    agentId,
+    showPrincipalAttribution: false,
+    ...typeof id === "string" && id.length > 0 ? { agentId: id } : {},
     ...typeof name === "string" && name.length > 0 ? { agentName: name } : {},
     ...typeof avatar === "string" && avatar.length > 0 ? { agentAvatarUrl: avatar } : {}
   };
 }
+function effectiveActorKey(message) {
+  const hint = readActorHint(message.metadata);
+  if (hint === null) return `principal:${message.senderId}`;
+  return `agent:${hint.agentId ?? hint.agentName ?? "anonymous"}`;
+}
 function resolveActor(message, sender) {
   const hint = readActorHint(message.metadata);
   const humanName = sender?.displayName ?? message.senderId;
@@ -95,7 +114,11 @@ function resolveActor(message, sender) {
       displayName: hint.agentName ?? "Agent",
       avatarUrl: hint.agentAvatarUrl ?? null,
       isAgent: true,
-      onBehalfOfName: humanName,
+      // The nested envelope explicitly models an agent acting on behalf of a
+      // session principal. Platform event rows use the flat actor envelope as
+      // the complete presentation identity; surfacing their audit writer as
+      // "via Human" wrongly re-attaches that person to an automated event.
+      onBehalfOfName: hint.showPrincipalAttribution ? humanName : null,
       principalUserId: message.senderId
     };
   }
@@ -1287,6 +1310,11 @@ function createMessagingEngine(options) {
       if (openChannels.has(id) || disposed) return;
       const handle = manager.open({
         topic: conversationTopic(id),
+        // Presence callbacks are JOIN-TIME in supabase-js. Declare the
+        // read-only room shape on the first holder (the engine) so the
+        // composer/typist/online hooks can attach without forcing a rebuild
+        // after this durable channel has already subscribed.
+        presence: { publish: false, state: {} },
         postgresChanges: [
           {
             event: "*",
@@ -1452,18 +1480,20 @@ function groupMessages(messages, args = {}) {
   let current = null;
   let previousDay = null;
   for (const message of messages) {
+    const actorKey = args.actorKey?.(message) ?? `principal:${message.senderId}`;
     const day = message.createdAt.slice(0, 10);
     const startsNewDay = day !== previousDay;
     previousDay = day;
     const last = current?.messages.at(-1);
     const withinWindow = last !== void 0 && Math.abs(Date.parse(message.createdAt) - Date.parse(last.createdAt)) <= windowMs;
-    if (current !== null && current.senderId === message.senderId && withinWindow && !startsNewDay) {
+    if (current !== null && current.senderId === message.senderId && current.actorKey === actorKey && withinWindow && !startsNewDay) {
       current.messages.push(message);
       continue;
     }
     if (current !== null) groups.push(current);
     current = {
       senderId: message.senderId,
+      actorKey,
       messages: [message],
       dateSeparator: startsNewDay ? formatDateSeparator(message.createdAt, now, args.locale) : null
     };
@@ -1862,6 +1892,7 @@ export {
   createOutbox,
   createReadCache,
   createWebOutboxStorage,
+  effectiveActorKey,
   extractReferences,
   formatConversationTime,
   formatDateSeparator,