@ai-matrx/messaging 0.10.0 → 0.10.2

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;
 
 /**
@@ -355,7 +357,13 @@ interface MessagingAiOptions {
     transport: MatrxTransport;
     organizationId: string;
     agents: MessagingAgents;
-    /** Stable source slugs so server-side analytics can see where a run came from. */
+    /**
+     * The producer slugs stamped on every run. 🚨 The AI Matrx server keeps a
+     * REGISTER of legal producers and refuses an unregistered one with a 422, so
+     * the defaults below are placeholders that will NOT survive a real server —
+     * only the host knows its registered slugs. Not analytics garnish: an
+     * unstamped or unregistered run is a refused run.
+     */
     sourceApp?: string | undefined;
     sourceFeature?: string | undefined;
     /** Cap on how much transcript is sent. Default 200 messages. */
@@ -1024,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;
@@ -1109,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;
 
 /**
@@ -355,7 +357,13 @@ interface MessagingAiOptions {
     transport: MatrxTransport;
     organizationId: string;
     agents: MessagingAgents;
-    /** Stable source slugs so server-side analytics can see where a run came from. */
+    /**
+     * The producer slugs stamped on every run. 🚨 The AI Matrx server keeps a
+     * REGISTER of legal producers and refuses an unregistered one with a 422, so
+     * the defaults below are placeholders that will NOT survive a real server —
+     * only the host knows its registered slugs. Not analytics garnish: an
+     * unstamped or unregistered run is a refused run.
+     */
     sourceApp?: string | undefined;
     sourceFeature?: string | undefined;
     /** Cap on how much transcript is sent. Default 200 messages. */
@@ -1024,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;
@@ -1109,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,36 @@ 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,
+      ...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,
+    ...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;
@@ -1452,18 +1469,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 +1881,7 @@ export {
   createOutbox,
   createReadCache,
   createWebOutboxStorage,
+  effectiveActorKey,
   extractReferences,
   formatConversationTime,
   formatDateSeparator,