@ai-matrx/messaging 0.10.0 → 0.10.2

package/dist/react.d.cts

@@ -1,4 +1,4 @@
-import { ReactNode, ComponentType, SVGProps } from 'react';
+import { ReactNode, ComponentType, KeyboardEvent, SVGProps } from 'react';
 import { MatrxJsonObject, MatrxTransport } from '@ai-matrx/agents/matrx';
 import { RealtimeClientLike, RealtimeManager } from '@ai-matrx/realtime';
 
@@ -331,7 +331,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. */
@@ -987,6 +993,15 @@ interface MessagingProviderProps {
      * number so an organization can decide.
      */
     maxTranscriptMessages?: number | undefined;
+    /**
+     * 🚨 REQUIRED IN PRACTICE FOR AI. The producer slugs stamped on every AI run.
+     * The AI Matrx server keeps a REGISTER of legal producers and REFUSES an
+     * unregistered one with a 422 — so this package's placeholder defaults
+     * (`ai-matrx` / `messaging.<capability>`) fail every call against a real
+     * server. Only the host knows its registered slugs; pass them.
+     */
+    sourceApp?: string | undefined;
+    sourceFeature?: string | undefined;
     /** Handlers for actionable messages. Registered once per handler identity. */
     actions?: readonly ActionHandler<never>[] | undefined;
     /**
@@ -1142,6 +1157,21 @@ interface ConversationViewProps {
     conversationId: ConversationId | null;
     onBack?: () => void;
     className?: string;
+    /** Hide package chrome when a containing workspace already owns the title. */
+    showHeader?: boolean;
+    /** Hide conversation AI controls on a surface that deliberately does not offer them. */
+    showAi?: boolean;
+    /** Let a host inject its canonical textarea chrome without taking composer behavior. */
+    renderComposerInput?: (props: ComposerInputRenderProps) => ReactNode;
+}
+interface ComposerInputRenderProps {
+    readonly value: string;
+    readonly disabled: boolean;
+    readonly canSend: boolean;
+    readonly placeholder: string;
+    readonly onChange: (value: string) => void;
+    readonly onKeyDown: (event: KeyboardEvent<HTMLTextAreaElement>) => void;
+    readonly onSubmit: () => void;
 }
 declare function ConversationView(props: ConversationViewProps): ReactNode;
 declare function MessageBubble(props: {
@@ -1270,6 +1300,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;
 
 /**
@@ -1419,6 +1451,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;
@@ -1504,4 +1538,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, AgentTag, type AiCallArgs, type AiCapability, type AiResult, AlertIcon, type Attachment, Avatar, BotIcon, CheckIcon, ChevronLeftIcon, type ClientMessageId, ClockIcon, CloseIcon, Composer, type Conversation, type ConversationCursor, type ConversationId, ConversationList, type ConversationListProps, type ConversationRowWrapperProps, ConversationSkeleton, type ConversationSummary, type ConversationThread, type ConversationType, ConversationView, type ConversationViewProps, type DeliveryState, DeliveryTick, DoubleCheckIcon, type DraftMessage, EmptyState, type EngineDiagnostic, type IncomingMessageContext, type JsonObject, type JsonValue, LinkIcon, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, MessageActionChips, type MessageActionRenderProps, type MessageActionRenderer, MessageBubble, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessageWrapperProps, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingHost, type MessagingIdentity, MessagingInbox, type MessagingInboxProps, MessagingProvider, type MessagingProviderProps, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, PaperclipIcon, type Participant, type ParticipantRole, PlusIcon, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, ReferenceCard, type ReferenceRenderer, ReplyIcon, type RepositoryOptions, type SchemaLike, SearchIcon, SendIcon, type SessionResolver, SparklesIcon, type SupabaseLike, TABLES, type TextSegment, TypingDots, type UseComposerResult, type UseConversationResult, type UseConversationsResult, type UseMessageActionResult, type UseMessagingAiResult, type UseTypistsResult, type UserId, type UserSummary, UsersIcon, 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, useComposer, useConversation, useConversations, useMessageAction, useMessagingAi, useMessagingHost, useMessagingSnapshot, useOnlineUserIds, useRequiredMessagingHost, useTypists };
+export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, AgentTag, type AiCallArgs, type AiCapability, type AiResult, AlertIcon, type Attachment, Avatar, BotIcon, CheckIcon, ChevronLeftIcon, type ClientMessageId, ClockIcon, CloseIcon, Composer, type ComposerInputRenderProps, type Conversation, type ConversationCursor, type ConversationId, ConversationList, type ConversationListProps, type ConversationRowWrapperProps, ConversationSkeleton, type ConversationSummary, type ConversationThread, type ConversationType, ConversationView, type ConversationViewProps, type DeliveryState, DeliveryTick, DoubleCheckIcon, type DraftMessage, EmptyState, type EngineDiagnostic, type IncomingMessageContext, type JsonObject, type JsonValue, LinkIcon, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, MessageActionChips, type MessageActionRenderProps, type MessageActionRenderer, MessageBubble, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessageWrapperProps, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingHost, type MessagingIdentity, MessagingInbox, type MessagingInboxProps, MessagingProvider, type MessagingProviderProps, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, PaperclipIcon, type Participant, type ParticipantRole, PlusIcon, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, ReferenceCard, type ReferenceRenderer, ReplyIcon, type RepositoryOptions, type SchemaLike, SearchIcon, SendIcon, type SessionResolver, SparklesIcon, type SupabaseLike, TABLES, type TextSegment, TypingDots, type UseComposerResult, type UseConversationResult, type UseConversationsResult, type UseMessageActionResult, type UseMessagingAiResult, type UseTypistsResult, type UserId, type UserSummary, UsersIcon, 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, useComposer, useConversation, useConversations, useMessageAction, useMessagingAi, useMessagingHost, useMessagingSnapshot, useOnlineUserIds, useRequiredMessagingHost, useTypists };

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode, ComponentType, SVGProps } from 'react';
+import { ReactNode, ComponentType, KeyboardEvent, SVGProps } from 'react';
 import { MatrxJsonObject, MatrxTransport } from '@ai-matrx/agents/matrx';
 import { RealtimeClientLike, RealtimeManager } from '@ai-matrx/realtime';
 
@@ -331,7 +331,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. */
@@ -987,6 +993,15 @@ interface MessagingProviderProps {
      * number so an organization can decide.
      */
     maxTranscriptMessages?: number | undefined;
+    /**
+     * 🚨 REQUIRED IN PRACTICE FOR AI. The producer slugs stamped on every AI run.
+     * The AI Matrx server keeps a REGISTER of legal producers and REFUSES an
+     * unregistered one with a 422 — so this package's placeholder defaults
+     * (`ai-matrx` / `messaging.<capability>`) fail every call against a real
+     * server. Only the host knows its registered slugs; pass them.
+     */
+    sourceApp?: string | undefined;
+    sourceFeature?: string | undefined;
     /** Handlers for actionable messages. Registered once per handler identity. */
     actions?: readonly ActionHandler<never>[] | undefined;
     /**
@@ -1142,6 +1157,21 @@ interface ConversationViewProps {
     conversationId: ConversationId | null;
     onBack?: () => void;
     className?: string;
+    /** Hide package chrome when a containing workspace already owns the title. */
+    showHeader?: boolean;
+    /** Hide conversation AI controls on a surface that deliberately does not offer them. */
+    showAi?: boolean;
+    /** Let a host inject its canonical textarea chrome without taking composer behavior. */
+    renderComposerInput?: (props: ComposerInputRenderProps) => ReactNode;
+}
+interface ComposerInputRenderProps {
+    readonly value: string;
+    readonly disabled: boolean;
+    readonly canSend: boolean;
+    readonly placeholder: string;
+    readonly onChange: (value: string) => void;
+    readonly onKeyDown: (event: KeyboardEvent<HTMLTextAreaElement>) => void;
+    readonly onSubmit: () => void;
 }
 declare function ConversationView(props: ConversationViewProps): ReactNode;
 declare function MessageBubble(props: {
@@ -1270,6 +1300,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;
 
 /**
@@ -1419,6 +1451,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;
@@ -1504,4 +1538,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, AgentTag, type AiCallArgs, type AiCapability, type AiResult, AlertIcon, type Attachment, Avatar, BotIcon, CheckIcon, ChevronLeftIcon, type ClientMessageId, ClockIcon, CloseIcon, Composer, type Conversation, type ConversationCursor, type ConversationId, ConversationList, type ConversationListProps, type ConversationRowWrapperProps, ConversationSkeleton, type ConversationSummary, type ConversationThread, type ConversationType, ConversationView, type ConversationViewProps, type DeliveryState, DeliveryTick, DoubleCheckIcon, type DraftMessage, EmptyState, type EngineDiagnostic, type IncomingMessageContext, type JsonObject, type JsonValue, LinkIcon, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, MessageActionChips, type MessageActionRenderProps, type MessageActionRenderer, MessageBubble, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessageWrapperProps, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingHost, type MessagingIdentity, MessagingInbox, type MessagingInboxProps, MessagingProvider, type MessagingProviderProps, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, PaperclipIcon, type Participant, type ParticipantRole, PlusIcon, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, ReferenceCard, type ReferenceRenderer, ReplyIcon, type RepositoryOptions, type SchemaLike, SearchIcon, SendIcon, type SessionResolver, SparklesIcon, type SupabaseLike, TABLES, type TextSegment, TypingDots, type UseComposerResult, type UseConversationResult, type UseConversationsResult, type UseMessageActionResult, type UseMessagingAiResult, type UseTypistsResult, type UserId, type UserSummary, UsersIcon, 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, useComposer, useConversation, useConversations, useMessageAction, useMessagingAi, useMessagingHost, useMessagingSnapshot, useOnlineUserIds, useRequiredMessagingHost, useTypists };
+export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, AgentTag, type AiCallArgs, type AiCapability, type AiResult, AlertIcon, type Attachment, Avatar, BotIcon, CheckIcon, ChevronLeftIcon, type ClientMessageId, ClockIcon, CloseIcon, Composer, type ComposerInputRenderProps, type Conversation, type ConversationCursor, type ConversationId, ConversationList, type ConversationListProps, type ConversationRowWrapperProps, ConversationSkeleton, type ConversationSummary, type ConversationThread, type ConversationType, ConversationView, type ConversationViewProps, type DeliveryState, DeliveryTick, DoubleCheckIcon, type DraftMessage, EmptyState, type EngineDiagnostic, type IncomingMessageContext, type JsonObject, type JsonValue, LinkIcon, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, MessageActionChips, type MessageActionRenderProps, type MessageActionRenderer, MessageBubble, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessageWrapperProps, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingHost, type MessagingIdentity, MessagingInbox, type MessagingInboxProps, MessagingProvider, type MessagingProviderProps, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, PaperclipIcon, type Participant, type ParticipantRole, PlusIcon, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, ReferenceCard, type ReferenceRenderer, ReplyIcon, type RepositoryOptions, type SchemaLike, SearchIcon, SendIcon, type SessionResolver, SparklesIcon, type SupabaseLike, TABLES, type TextSegment, TypingDots, type UseComposerResult, type UseConversationResult, type UseConversationsResult, type UseMessageActionResult, type UseMessagingAiResult, type UseTypistsResult, type UserId, type UserSummary, UsersIcon, 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, useComposer, useConversation, useConversations, useMessageAction, useMessagingAi, useMessagingHost, useMessagingSnapshot, useOnlineUserIds, useRequiredMessagingHost, useTypists };

package/dist/react.js

@@ -1817,15 +1817,27 @@ function MessagingRuntime(props) {
   const transport = props.transport;
   const agents = props.agents;
   const maxTranscriptMessages = props.maxTranscriptMessages;
+  const sourceApp = props.sourceApp;
+  const sourceFeature = props.sourceFeature;
   const ai = useMemo(() => {
     if (transport === void 0 || agents === void 0 || !ready) return null;
     return createMessagingAi({
       transport,
       organizationId,
       agents,
-      ...maxTranscriptMessages !== void 0 ? { maxTranscriptMessages } : {}
+      ...maxTranscriptMessages !== void 0 ? { maxTranscriptMessages } : {},
+      ...sourceApp !== void 0 ? { sourceApp } : {},
+      ...sourceFeature !== void 0 ? { sourceFeature } : {}
     });
-  }, [transport, agents, ready, organizationId, maxTranscriptMessages]);
+  }, [
+    transport,
+    agents,
+    ready,
+    organizationId,
+    maxTranscriptMessages,
+    sourceApp,
+    sourceFeature
+  ]);
   const renderers = props.actionRenderers;
   const rendererMap = useMemo(() => {
     const map = /* @__PURE__ */ new Map();
@@ -1944,18 +1956,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
     };
@@ -2273,23 +2287,45 @@ function useMessageAction(message) {
 }
 
 // src/react/components.tsx
-import { useEffect as useEffect3, useMemo as useMemo3, useRef as useRef3, useState as useState2 } from "react";
+import {
+  useEffect as useEffect3,
+  useMemo as useMemo3,
+  useRef as useRef3,
+  useState as useState2
+} from "react";
 
 // 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;
@@ -2685,7 +2721,7 @@ function ConversationView(props) {
   );
   const anyOnline = others.some((participant) => online.has(participant.userId));
   return /* @__PURE__ */ jsxs2("div", { className: `mx-msg__thread${props.className !== void 0 ? ` ${props.className}` : ""}`, children: [
-    /* @__PURE__ */ jsxs2("header", { className: "mx-msg__header", children: [
+    props.showHeader !== false ? /* @__PURE__ */ jsxs2("header", { className: "mx-msg__header", children: [
       props.onBack !== void 0 ? /* @__PURE__ */ jsx4(
         "button",
         {
@@ -2720,8 +2756,8 @@ function ConversationView(props) {
           children: /* @__PURE__ */ jsx4(UsersIcon, {})
         }
       ) : null })
-    ] }),
-    ai.available.length > 0 ? /* @__PURE__ */ jsx4("div", { className: "mx-msg__ai-bar", children: ai.available.map((capability) => /* @__PURE__ */ jsxs2(
+    ] }) : null,
+    props.showAi !== false && ai.available.length > 0 ? /* @__PURE__ */ jsx4("div", { className: "mx-msg__ai-bar", children: ai.available.map((capability) => /* @__PURE__ */ jsxs2(
       "button",
       {
         type: "button",
@@ -2735,7 +2771,7 @@ function ConversationView(props) {
       },
       capability
     )) }) : null,
-    ai.isRunning ? /* @__PURE__ */ jsx4("p", { className: "mx-msg__ai-output", "aria-busy": "true", "aria-live": "polite", children: ai.partialText.length > 0 ? ai.partialText : /* @__PURE__ */ jsxs2(Fragment, { children: [
+    props.showAi !== false && ai.isRunning ? /* @__PURE__ */ jsx4("p", { className: "mx-msg__ai-output", "aria-busy": "true", "aria-live": "polite", children: ai.partialText.length > 0 ? ai.partialText : /* @__PURE__ */ jsxs2(Fragment, { children: [
       /* @__PURE__ */ jsx4("span", { className: "mx-msg__ai-output-label", children: ai.activeCapability !== null ? `${AI_LABELS[ai.activeCapability]}\u2026` : "Working\u2026" }),
       /* @__PURE__ */ jsx4(
         "span",
@@ -2744,7 +2780,7 @@ function ConversationView(props) {
           style: { display: "block", height: 11, width: "72%" }
         }
       )
-    ] }) }) : ai.error !== null ? /* @__PURE__ */ jsx4("p", { className: "mx-msg__ai-output", style: { color: "var(--mx-msg-danger)" }, children: ai.error }) : ai.result !== null ? /* @__PURE__ */ jsxs2("p", { className: "mx-msg__ai-output", children: [
+    ] }) }) : props.showAi !== false && ai.error !== null ? /* @__PURE__ */ jsx4("p", { className: "mx-msg__ai-output", style: { color: "var(--mx-msg-danger)" }, children: ai.error }) : props.showAi !== false && ai.result !== null ? /* @__PURE__ */ jsxs2("p", { className: "mx-msg__ai-output", children: [
       ai.result.text,
       /* @__PURE__ */ jsx4(
         "button",
@@ -2769,26 +2805,24 @@ function ConversationView(props) {
           children: "Load earlier messages"
         }
       ) : null,
-      groupMessages(messages).map((group) => {
+      groupMessages(messages, { actorKey: effectiveActorKey }).map((group) => {
         const first = group.messages[0];
         if (first === void 0) return null;
-        const isMine = group.senderId === selfId;
         const sender = conversation.participants.find(
           (participant) => participant.userId === group.senderId
         ) ?? null;
+        const actor = resolveActor(first, sender);
+        const isMine = group.senderId === selfId && !actor.isAgent;
         return /* @__PURE__ */ jsxs2("div", { children: [
           group.dateSeparator !== null ? /* @__PURE__ */ jsx4("div", { className: "mx-msg__day", children: group.dateSeparator }) : null,
           /* @__PURE__ */ jsx4(
             MessageGroupView,
             {
               messages: group.messages,
-              sender,
+              actor,
               isMine,
               onRetry: conversation.retry,
               onReply: composer.setReplyTo,
-              pendingIds: new Set(
-                conversation.pending.filter((entry) => entry.state === "failed").map((entry) => entry.clientMessageId)
-              ),
               failedEntryIdByClientId: new Map(
                 conversation.pending.map((entry) => [entry.clientMessageId, entry.id])
               )
@@ -2801,13 +2835,20 @@ function ConversationView(props) {
       /* @__PURE__ */ jsx4(TypingDots, {}),
       typists.label
     ] }) : null }),
-    /* @__PURE__ */ jsx4(ComposerView, { composer, disabled: false })
+    /* @__PURE__ */ jsx4(
+      ComposerView,
+      {
+        composer,
+        disabled: false,
+        ...props.renderComposerInput !== void 0 ? { renderInput: props.renderComposerInput } : {}
+      }
+    )
   ] });
 }
 function MessageGroupView(props) {
   const first = props.messages[0];
   if (first === void 0) return null;
-  const actor = resolveActor(first, props.sender);
+  const actor = props.actor;
   return /* @__PURE__ */ jsxs2("div", { className: `mx-msg__group${props.isMine ? " mx-msg__group--mine" : ""}`, children: [
     /* @__PURE__ */ jsx4(
       Avatar,
@@ -2994,7 +3035,24 @@ function ComposerView(props) {
         }
       )
     ] }) : null,
-    /* @__PURE__ */ jsxs2("div", { className: "mx-msg__composer-row", children: [
+    props.renderInput !== void 0 ? props.renderInput({
+      value: composer.value,
+      disabled: props.disabled,
+      canSend: composer.canSend,
+      placeholder: "Write a reply\u2026",
+      onChange: (value) => {
+        composer.setValue(value);
+        composer.onKeystroke();
+      },
+      onKeyDown: (event) => {
+        if (event.key !== "Enter" || event.shiftKey) return;
+        const isTouch = typeof globalThis.matchMedia === "function" && globalThis.matchMedia("(pointer: coarse)").matches;
+        if (isTouch) return;
+        event.preventDefault();
+        composer.send();
+      },
+      onSubmit: composer.send
+    }) : /* @__PURE__ */ jsxs2("div", { className: "mx-msg__composer-row", children: [
       /* @__PURE__ */ jsx4(
         "textarea",
         {
@@ -3125,6 +3183,7 @@ export {
   createOutbox,
   createReadCache,
   createWebOutboxStorage,
+  effectiveActorKey,
   extractReferences,
   formatConversationTime,
   formatDateSeparator,