@open-mercato/ai-assistant 0.6.3-develop.3901.1.ddad60693a → 0.6.3

package/src/modules/ai_assistant/events.ts

@@ -47,6 +47,20 @@ const events = [
     clientBroadcast: false,
     portalBroadcast: false,
   },
+  {
+    id: 'ai_assistant.conversation.shared',
+    label: 'AI Conversation Shared',
+    entity: 'ai_chat_conversation',
+    category: 'lifecycle' as const,
+    clientBroadcast: true,
+  },
+  {
+    id: 'ai_assistant.conversation.unshared',
+    label: 'AI Conversation Unshared',
+    entity: 'ai_chat_conversation',
+    category: 'lifecycle' as const,
+    clientBroadcast: true,
+  },
 ] as const
 
 export const eventsConfig = createModuleEvents({
@@ -117,4 +131,21 @@ export interface AiActionExpiredPayload {
   expiredAt?: string
 }
 
+export interface AiConversationSharedPayload {
+  conversationId: string
+  tenantId: string
+  organizationId: string | null
+  ownerUserId: string
+  participantUserId: string
+  role: string
+}
+
+export interface AiConversationUnsharedPayload {
+  conversationId: string
+  tenantId: string
+  organizationId: string | null
+  ownerUserId: string
+  participantUserId: string
+}
+
 export default eventsConfig

package/src/modules/ai_assistant/i18n/__tests__/conversation-share-translations.test.ts

@@ -0,0 +1,59 @@
+/**
+ * Regression coverage for issue #2097 (BUG-004): the conversation-sharing
+ * UI and notification strings MUST ship localized values in every supported
+ * locale, not the English copy. Catches drift when keys are renamed/added
+ * but their PL/DE/ES values are forgotten.
+ */
+
+import enDict from '../en.json'
+import plDict from '../pl.json'
+import deDict from '../de.json'
+import esDict from '../es.json'
+
+type Dict = Record<string, string>
+
+const KEYS_TO_LOCALIZE = [
+  'ai_assistant.chat.readOnlyNotice',
+  'ai_assistant.launcher.composerPlaceholder',
+  'ai_assistant.notifications.conversation_shared.title',
+  'ai_assistant.notifications.conversation_shared.body',
+  'ai_assistant.notifications.conversation_shared.view_button',
+  'ai_assistant.share.addParticipant',
+  'ai_assistant.share.allUsersAdded',
+  'ai_assistant.share.dialogDescription',
+  'ai_assistant.share.dialogTitle',
+  'ai_assistant.share.noParticipants',
+  'ai_assistant.share.participantPlaceholder',
+  'ai_assistant.share.removeParticipant',
+  'ai_assistant.share.saved',
+  'ai_assistant.share.saving',
+  'ai_assistant.share.selectUser',
+  'ai_assistant.share.shareButton',
+]
+
+const LOCALE_DICTS: Array<[string, Dict]> = [
+  ['pl', plDict as Dict],
+  ['de', deDict as Dict],
+  ['es', esDict as Dict],
+]
+
+describe('ai_assistant conversation-share i18n keys', () => {
+  it.each(KEYS_TO_LOCALIZE)('en.json defines %s', (key) => {
+    expect((enDict as Dict)[key]).toBeTruthy()
+  })
+
+  for (const [locale, dict] of LOCALE_DICTS) {
+    describe(`${locale}.json`, () => {
+      it.each(KEYS_TO_LOCALIZE)('defines %s', (key) => {
+        expect(dict[key]).toBeTruthy()
+      })
+
+      it.each(KEYS_TO_LOCALIZE)('localizes %s (value differs from en)', (key) => {
+        const enValue = (enDict as Dict)[key]
+        const localizedValue = dict[key]
+        expect(localizedValue).toBeTruthy()
+        expect(localizedValue).not.toBe(enValue)
+      })
+    })
+  }
+})

package/src/modules/ai_assistant/i18n/de.json

@@ -216,9 +216,11 @@
   "ai_assistant.chat.mutation_cards.result.successWithCommand": "Abgeschlossen",
   "ai_assistant.chat.mutation_cards.result.viewRecord": "Datensatz anzeigen",
   "ai_assistant.chat.newConversation": "Start new conversation",
+  "ai_assistant.chat.ownerRoleLabel": "Owner",
   "ai_assistant.chat.pending_phase3.body": "Diese interaktive Karte kommt in Phase 3 des vereinheitlichten KI-Frameworks.",
   "ai_assistant.chat.pending_phase3.title": "Mutations-Freigabe-Karte ausstehend",
   "ai_assistant.chat.placeholder": "Fragen Sie mich etwas...",
+  "ai_assistant.chat.readOnlyNotice": "Dies ist eine geteilte Konversation. Sie können lesen, aber nicht antworten.",
   "ai_assistant.chat.reasoning": "Reasoning",
   "ai_assistant.chat.records.fields.amount": "Betrag",
   "ai_assistant.chat.records.fields.category": "Kategorie",
@@ -282,6 +284,7 @@
   "ai_assistant.dock.left": "Links andocken",
   "ai_assistant.dock.minimize": "Minimieren",
   "ai_assistant.dock.right": "Rechts andocken",
+  "ai_assistant.launcher.composerPlaceholder": "Fragen Sie mich etwas…",
   "ai_assistant.launcher.dialogTitle": "AI assistants",
   "ai_assistant.launcher.dock.subtitle": "AI assistant",
   "ai_assistant.launcher.empty": "No assistants match your search.",
@@ -323,6 +326,9 @@
   "ai_assistant.modelPicker.triggerAriaLabel": "KI-Modell auswählen",
   "ai_assistant.modelPicker.useDefault": "Standard des Agenten verwenden",
   "ai_assistant.modelPicker.useDefaultWithModel": "Standard des Agenten verwenden: {{model}}",
+  "ai_assistant.notifications.conversation_shared.body": "Eine KI-Konversation wurde mit Ihnen geteilt.",
+  "ai_assistant.notifications.conversation_shared.title": "Konversation mit Ihnen geteilt",
+  "ai_assistant.notifications.conversation_shared.view_button": "Konversation öffnen",
   "ai_assistant.playground.agentPickerLabel": "Agent",
   "ai_assistant.playground.chat.notSupportedBody": "Wählen Sie einen Agenten, dessen Ausführungsmodus \"chat\" ist, oder wechseln Sie zum Objekt-Modus-Tab.",
   "ai_assistant.playground.chat.notSupportedTitle": "Chat-Modus ist für diesen Agenten nicht verfügbar.",
@@ -428,6 +434,17 @@
   "ai_assistant.settings.visibilityEnabled": "Im Header sichtbar mit aktiviertem Cmd+J-Shortcut.",
   "ai_assistant.settings.visibilityTitle": "KI-Assistent",
   "ai_assistant.settings.visibilityToggleLabel": "Sichtbarkeit",
+  "ai_assistant.share.addParticipant": "Teilnehmer hinzufügen",
+  "ai_assistant.share.allUsersAdded": "Alle Benutzer bereits hinzugefügt",
+  "ai_assistant.share.dialogDescription": "Teilen Sie diese Konversation mit anderen Benutzern. Sie erhalten nur Lesezugriff.",
+  "ai_assistant.share.dialogTitle": "Konversation teilen",
+  "ai_assistant.share.noParticipants": "Noch keine Teilnehmer. Fügen Sie jemanden hinzu, um diese Konversation zu teilen.",
+  "ai_assistant.share.participantPlaceholder": "Nach Benutzer suchen...",
+  "ai_assistant.share.removeParticipant": "Entfernen",
+  "ai_assistant.share.saved": "Gespeichert",
+  "ai_assistant.share.saving": "Wird gespeichert...",
+  "ai_assistant.share.selectUser": "Benutzer auswählen...",
+  "ai_assistant.share.shareButton": "Teilen",
   "ai_assistant.status.analyzing": "Anfrage wird analysiert...",
   "ai_assistant.status.executing": "Tools werden ausgeführt...",
   "ai_assistant.status.responding": "Antwort wird erstellt...",

package/src/modules/ai_assistant/i18n/en.json

@@ -216,9 +216,11 @@
   "ai_assistant.chat.mutation_cards.result.successWithCommand": "Completed",
   "ai_assistant.chat.mutation_cards.result.viewRecord": "View record",
   "ai_assistant.chat.newConversation": "Start new conversation",
+  "ai_assistant.chat.ownerRoleLabel": "Owner",
   "ai_assistant.chat.pending_phase3.body": "This interactive card will land in Phase 3 of the unified AI framework.",
   "ai_assistant.chat.pending_phase3.title": "Mutation approval card pending",
   "ai_assistant.chat.placeholder": "Ask me anything...",
+  "ai_assistant.chat.readOnlyNotice": "This is a shared conversation. You can read but not reply.",
   "ai_assistant.chat.reasoning": "Reasoning",
   "ai_assistant.chat.records.fields.amount": "Amount",
   "ai_assistant.chat.records.fields.category": "Category",
@@ -282,6 +284,7 @@
   "ai_assistant.dock.left": "Dock Left",
   "ai_assistant.dock.minimize": "Minimize",
   "ai_assistant.dock.right": "Dock Right",
+  "ai_assistant.launcher.composerPlaceholder": "Ask anything…",
   "ai_assistant.launcher.dialogTitle": "AI assistants",
   "ai_assistant.launcher.dock.subtitle": "AI assistant",
   "ai_assistant.launcher.empty": "No assistants match your search.",
@@ -323,6 +326,9 @@
   "ai_assistant.modelPicker.triggerAriaLabel": "Select AI model",
   "ai_assistant.modelPicker.useDefault": "Use agent default",
   "ai_assistant.modelPicker.useDefaultWithModel": "Use agent default: {{model}}",
+  "ai_assistant.notifications.conversation_shared.body": "An AI conversation has been shared with you.",
+  "ai_assistant.notifications.conversation_shared.title": "Conversation shared with you",
+  "ai_assistant.notifications.conversation_shared.view_button": "View Conversation",
   "ai_assistant.playground.agentPickerLabel": "Agent",
   "ai_assistant.playground.chat.notSupportedBody": "Pick an agent whose execution mode is \"chat\", or switch to the object-mode tab.",
   "ai_assistant.playground.chat.notSupportedTitle": "Chat mode is not available for this agent.",
@@ -428,6 +434,17 @@
   "ai_assistant.settings.visibilityEnabled": "Visible in header with Cmd+J shortcut enabled.",
   "ai_assistant.settings.visibilityTitle": "AI Assistant",
   "ai_assistant.settings.visibilityToggleLabel": "Visibility",
+  "ai_assistant.share.addParticipant": "Add participant",
+  "ai_assistant.share.allUsersAdded": "All users already added",
+  "ai_assistant.share.dialogDescription": "Share this conversation with other users. They will get read-only access.",
+  "ai_assistant.share.dialogTitle": "Share Conversation",
+  "ai_assistant.share.noParticipants": "No participants yet. Add someone to share this conversation.",
+  "ai_assistant.share.participantPlaceholder": "Search by user...",
+  "ai_assistant.share.removeParticipant": "Remove",
+  "ai_assistant.share.saved": "Saved",
+  "ai_assistant.share.saving": "Saving...",
+  "ai_assistant.share.selectUser": "Select a user...",
+  "ai_assistant.share.shareButton": "Share",
   "ai_assistant.status.analyzing": "Analyzing request...",
   "ai_assistant.status.executing": "Executing tools...",
   "ai_assistant.status.responding": "Responding...",

package/src/modules/ai_assistant/i18n/es.json

@@ -216,9 +216,11 @@
   "ai_assistant.chat.mutation_cards.result.successWithCommand": "Completado",
   "ai_assistant.chat.mutation_cards.result.viewRecord": "Ver registro",
   "ai_assistant.chat.newConversation": "Start new conversation",
+  "ai_assistant.chat.ownerRoleLabel": "Owner",
   "ai_assistant.chat.pending_phase3.body": "Esta tarjeta interactiva se integrará en la Fase 3 del marco unificado de IA.",
   "ai_assistant.chat.pending_phase3.title": "Tarjeta de aprobación de mutación pendiente",
   "ai_assistant.chat.placeholder": "Pregunte lo que necesite...",
+  "ai_assistant.chat.readOnlyNotice": "Esta es una conversación compartida. Puede leerla, pero no puede responder.",
   "ai_assistant.chat.reasoning": "Reasoning",
   "ai_assistant.chat.records.fields.amount": "Importe",
   "ai_assistant.chat.records.fields.category": "Categoría",
@@ -282,6 +284,7 @@
   "ai_assistant.dock.left": "Anclar a la izquierda",
   "ai_assistant.dock.minimize": "Minimizar",
   "ai_assistant.dock.right": "Anclar a la derecha",
+  "ai_assistant.launcher.composerPlaceholder": "Pregunte lo que necesite…",
   "ai_assistant.launcher.dialogTitle": "AI assistants",
   "ai_assistant.launcher.dock.subtitle": "AI assistant",
   "ai_assistant.launcher.empty": "No assistants match your search.",
@@ -323,6 +326,9 @@
   "ai_assistant.modelPicker.triggerAriaLabel": "Selector de modelo de IA",
   "ai_assistant.modelPicker.useDefault": "Usar predeterminado",
   "ai_assistant.modelPicker.useDefaultWithModel": "Usar predeterminado del agente: {{model}}",
+  "ai_assistant.notifications.conversation_shared.body": "Se ha compartido una conversación de IA con usted.",
+  "ai_assistant.notifications.conversation_shared.title": "Conversación compartida con usted",
+  "ai_assistant.notifications.conversation_shared.view_button": "Ver conversación",
   "ai_assistant.playground.agentPickerLabel": "Agente",
   "ai_assistant.playground.chat.notSupportedBody": "Elija un agente cuyo modo de ejecución sea \"chat\" o cambie a la pestaña de modo objeto.",
   "ai_assistant.playground.chat.notSupportedTitle": "El modo chat no está disponible para este agente.",
@@ -428,6 +434,17 @@
   "ai_assistant.settings.visibilityEnabled": "Habilitado",
   "ai_assistant.settings.visibilityTitle": "Visibilidad del asistente de IA",
   "ai_assistant.settings.visibilityToggleLabel": "Mostrar el asistente de IA a los usuarios",
+  "ai_assistant.share.addParticipant": "Añadir participante",
+  "ai_assistant.share.allUsersAdded": "Todos los usuarios ya añadidos",
+  "ai_assistant.share.dialogDescription": "Comparta esta conversación con otros usuarios. Obtendrán acceso de solo lectura.",
+  "ai_assistant.share.dialogTitle": "Compartir conversación",
+  "ai_assistant.share.noParticipants": "Aún no hay participantes. Añada a alguien para compartir esta conversación.",
+  "ai_assistant.share.participantPlaceholder": "Buscar usuario...",
+  "ai_assistant.share.removeParticipant": "Quitar",
+  "ai_assistant.share.saved": "Guardado",
+  "ai_assistant.share.saving": "Guardando...",
+  "ai_assistant.share.selectUser": "Seleccione un usuario...",
+  "ai_assistant.share.shareButton": "Compartir",
   "ai_assistant.status.analyzing": "Analizando solicitud...",
   "ai_assistant.status.executing": "Ejecutando herramientas...",
   "ai_assistant.status.responding": "Respondiendo...",

package/src/modules/ai_assistant/i18n/pl.json

@@ -216,9 +216,11 @@
   "ai_assistant.chat.mutation_cards.result.successWithCommand": "Zakończono",
   "ai_assistant.chat.mutation_cards.result.viewRecord": "Pokaż rekord",
   "ai_assistant.chat.newConversation": "Start new conversation",
+  "ai_assistant.chat.ownerRoleLabel": "Owner",
   "ai_assistant.chat.pending_phase3.body": "Ta interaktywna karta pojawi się w Fazie 3 zunifikowanego frameworku AI.",
   "ai_assistant.chat.pending_phase3.title": "Karta zatwierdzania mutacji oczekuje",
   "ai_assistant.chat.placeholder": "Zapytaj mnie o cokolwiek...",
+  "ai_assistant.chat.readOnlyNotice": "To jest udostępniona konwersacja. Możesz ją czytać, ale nie możesz odpowiadać.",
   "ai_assistant.chat.reasoning": "Reasoning",
   "ai_assistant.chat.records.fields.amount": "Kwota",
   "ai_assistant.chat.records.fields.category": "Kategoria",
@@ -282,6 +284,7 @@
   "ai_assistant.dock.left": "Dokuj po lewej",
   "ai_assistant.dock.minimize": "Minimalizuj",
   "ai_assistant.dock.right": "Dokuj po prawej",
+  "ai_assistant.launcher.composerPlaceholder": "Zapytaj o cokolwiek…",
   "ai_assistant.launcher.dialogTitle": "AI assistants",
   "ai_assistant.launcher.dock.subtitle": "AI assistant",
   "ai_assistant.launcher.empty": "No assistants match your search.",
@@ -323,6 +326,9 @@
   "ai_assistant.modelPicker.triggerAriaLabel": "Wybierz model AI",
   "ai_assistant.modelPicker.useDefault": "Użyj domyślnego agenta",
   "ai_assistant.modelPicker.useDefaultWithModel": "Użyj domyślnego agenta: {{model}}",
+  "ai_assistant.notifications.conversation_shared.body": "Udostępniono Ci konwersację z asystentem AI.",
+  "ai_assistant.notifications.conversation_shared.title": "Udostępniono Ci konwersację",
+  "ai_assistant.notifications.conversation_shared.view_button": "Otwórz konwersację",
   "ai_assistant.playground.agentPickerLabel": "Agent",
   "ai_assistant.playground.chat.notSupportedBody": "Wybierz agenta, którego tryb wykonywania to \"chat\", lub przełącz się na zakładkę trybu obiektowego.",
   "ai_assistant.playground.chat.notSupportedTitle": "Tryb czatu nie jest dostępny dla tego agenta.",
@@ -428,6 +434,17 @@
   "ai_assistant.settings.visibilityEnabled": "Widoczny w nagłówku ze skrótem Cmd+J.",
   "ai_assistant.settings.visibilityTitle": "Asystent AI",
   "ai_assistant.settings.visibilityToggleLabel": "Widoczność",
+  "ai_assistant.share.addParticipant": "Dodaj uczestnika",
+  "ai_assistant.share.allUsersAdded": "Dodano już wszystkich użytkowników",
+  "ai_assistant.share.dialogDescription": "Udostępnij tę konwersację innym użytkownikom. Otrzymają dostęp tylko do odczytu.",
+  "ai_assistant.share.dialogTitle": "Udostępnij konwersację",
+  "ai_assistant.share.noParticipants": "Brak uczestników. Dodaj kogoś, aby udostępnić tę konwersację.",
+  "ai_assistant.share.participantPlaceholder": "Szukaj użytkownika...",
+  "ai_assistant.share.removeParticipant": "Usuń",
+  "ai_assistant.share.saved": "Zapisano",
+  "ai_assistant.share.saving": "Zapisywanie...",
+  "ai_assistant.share.selectUser": "Wybierz użytkownika...",
+  "ai_assistant.share.shareButton": "Udostępnij",
   "ai_assistant.status.analyzing": "Analizowanie żądania...",
   "ai_assistant.status.executing": "Wykonywanie narzędzi...",
   "ai_assistant.status.responding": "Odpowiadanie...",

package/src/modules/ai_assistant/lib/conversation-storage.ts

@@ -6,6 +6,9 @@ import {
 } from '../data/entities'
 import {
   AiChatConversationAccessError,
+  AiChatConversationDuplicateParticipantError,
+  AiChatConversationOrgNotFoundError,
+  AiChatParticipantNotFoundError,
   AiChatConversationRepository,
   type AiChatConversationContext,
 } from '../data/repositories/AiChatConversationRepository'
@@ -22,7 +25,12 @@ import {
  * Re-exports the access error so route handlers can map it to a 404 without
  * importing the repository directly.
  */
-export { AiChatConversationAccessError }
+export {
+  AiChatConversationAccessError,
+  AiChatConversationDuplicateParticipantError,
+  AiChatConversationOrgNotFoundError,
+  AiChatParticipantNotFoundError,
+}
 export type { AiChatConversationContext }
 
 export function createConversationStorage(
@@ -43,6 +51,13 @@ export interface SerializedAiChatConversation {
   updatedAt: string
   lastMessageAt: string | null
   importedFromLocalAt: string | null
+  participantCount: number
+  isOwner: boolean | null
+}
+
+export interface AiChatConversationSerializeEnrich {
+  callerUserId?: string | null
+  participantCount?: number
 }
 
 export interface SerializedAiChatMessage {
@@ -56,10 +71,12 @@ export interface SerializedAiChatMessage {
   model: string | null
   metadata: Record<string, unknown> | null
   createdAt: string
+  senderUserId: string | null
 }
 
 export function serializeAiChatConversation(
   row: AiChatConversation,
+  enrich: AiChatConversationSerializeEnrich = {},
 ): SerializedAiChatConversation {
   return {
     conversationId: row.conversationId,
@@ -74,6 +91,9 @@ export function serializeAiChatConversation(
     importedFromLocalAt: row.importedFromLocalAt
       ? row.importedFromLocalAt.toISOString()
       : null,
+    participantCount: enrich.participantCount ?? 0,
+    isOwner:
+      enrich.callerUserId != null ? row.ownerUserId === enrich.callerUserId : null,
   }
 }
 
@@ -89,5 +109,6 @@ export function serializeAiChatMessage(row: AiChatMessage): SerializedAiChatMess
     model: row.model ?? null,
     metadata: row.metadata ?? null,
     createdAt: row.createdAt.toISOString(),
+    senderUserId: row.createdByUserId ?? null,
   }
 }

package/src/modules/ai_assistant/migrations/.snapshot-open-mercato.json

@@ -856,6 +856,22 @@
           "enumItems": [],
           "mappedType": "uuid"
         },
+        "deleted_at": {
+          "name": "deleted_at",
+          "type": "timestamptz(6)",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": 6,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "enumItems": [],
+          "mappedType": "datetime"
+        },
         "last_read_at": {
           "name": "last_read_at",
           "type": "timestamptz(6)",
@@ -972,6 +988,15 @@
           "unique": false,
           "expression": "create unique index \"ai_chat_conv_participants_tenant_org_conv_user_uq\" on \"ai_chat_conversation_participants\" (\"tenant_id\", \"organization_id\", \"conversation_id\", \"user_id\") where \"organization_id\" is not null"
         },
+        {
+          "columnNames": [],
+          "composite": false,
+          "constraint": false,
+          "keyName": "ai_chat_conv_participants_active_conv_user_idx",
+          "primary": false,
+          "unique": false,
+          "expression": "create index \"ai_chat_conv_participants_active_conv_user_idx\" on \"ai_chat_conversation_participants\" (\"tenant_id\", \"organization_id\", \"conversation_id\", \"user_id\") where \"deleted_at\" is null"
+        },
         {
           "columnNames": [
             "tenant_id",

package/src/modules/ai_assistant/migrations/Migration20260522120000_ai_assistant.ts

@@ -0,0 +1,15 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20260522120000_ai_assistant extends Migration {
+
+  override async up(): Promise<void> {
+    this.addSql(`alter table "ai_chat_conversation_participants" add column "deleted_at" timestamptz null;`)
+    this.addSql(`create index "ai_chat_conv_participants_active_conv_user_idx" on "ai_chat_conversation_participants" ("tenant_id", "organization_id", "conversation_id", "user_id") where "deleted_at" is null;`)
+  }
+
+  override async down(): Promise<void> {
+    this.addSql(`drop index if exists "ai_chat_conv_participants_active_conv_user_idx";`)
+    this.addSql(`alter table "ai_chat_conversation_participants" drop column if exists "deleted_at";`)
+  }
+
+}

package/src/modules/ai_assistant/notifications.client.ts

@@ -0,0 +1,29 @@
+'use client'
+
+import type { NotificationTypeDefinition } from '@open-mercato/shared/modules/notifications/types'
+import { ConversationSharedRenderer } from './widgets/notifications/ConversationSharedRenderer'
+
+export const aiAssistantNotificationTypes: NotificationTypeDefinition[] = [
+  {
+    type: 'ai_assistant.conversation_shared',
+    module: 'ai_assistant',
+    titleKey: 'ai_assistant.notifications.conversation_shared.title',
+    bodyKey: 'ai_assistant.notifications.conversation_shared.body',
+    icon: 'share-2',
+    severity: 'info',
+    actions: [
+      {
+        id: 'view',
+        labelKey: 'common.view',
+        variant: 'outline',
+        href: '/backend?openAiConversation={sourceEntityId}',
+        icon: 'external-link',
+      },
+    ],
+    linkHref: '/backend',
+    Renderer: ConversationSharedRenderer,
+    expiresAfterHours: 168,
+  },
+]
+
+export default aiAssistantNotificationTypes

package/src/modules/ai_assistant/notifications.ts

@@ -0,0 +1,25 @@
+import type { NotificationTypeDefinition } from '@open-mercato/shared/modules/notifications/types'
+
+export const notificationTypes: NotificationTypeDefinition[] = [
+  {
+    type: 'ai_assistant.conversation_shared',
+    module: 'ai_assistant',
+    titleKey: 'ai_assistant.notifications.conversation_shared.title',
+    bodyKey: 'ai_assistant.notifications.conversation_shared.body',
+    icon: 'share-2',
+    severity: 'info',
+    actions: [
+      {
+        id: 'view',
+        labelKey: 'common.view',
+        variant: 'outline',
+        href: '/backend?openAiConversation={sourceEntityId}',
+        icon: 'external-link',
+      },
+    ],
+    linkHref: '/backend',
+    expiresAfterHours: 168,
+  },
+]
+
+export default notificationTypes

package/src/modules/ai_assistant/setup.ts

@@ -103,12 +103,13 @@ export const setup: ModuleSetupConfig = {
       'ai_assistant.view',
       'ai_assistant.settings.manage',
       'ai_assistant.conversations.manage',
+      'ai_assistant.conversations.share',
       'ai_assistant.mcp.serve',
       'ai_assistant.tools.list',
       'ai_assistant.mcp_servers.view',
       'ai_assistant.mcp_servers.manage',
     ],
-    employee: ['ai_assistant.view'],
+    employee: ['ai_assistant.view', 'ai_assistant.conversations.share'],
   },
 
   async seedDefaults({ container }) {

package/src/modules/ai_assistant/subscribers/__tests__/conversation-shared-notify.test.ts

@@ -0,0 +1,116 @@
+/**
+ * Regression coverage for issue #2097 (BUG-004).
+ *
+ * Verifies that the conversation-shared notification subscriber persists a
+ * resolved title/body string rather than the raw i18n key, so that
+ * consumers that do not run the client renderer (email, export, digest)
+ * see human-readable text instead of `ai_assistant.notifications.…`.
+ */
+
+jest.mock('@open-mercato/shared/lib/i18n/server', () => ({
+  loadDictionary: jest.fn(async () => ({
+    'ai_assistant.notifications.conversation_shared.title': 'Conversation shared with you',
+    'ai_assistant.notifications.conversation_shared.body':
+      'An AI conversation has been shared with you.',
+  })),
+}))
+
+jest.mock('@open-mercato/core/modules/notifications/lib/notificationService', () => ({
+  resolveNotificationService: jest.fn(),
+}))
+
+import handleConversationShared from '../conversation-shared-notify'
+import { resolveNotificationService } from '@open-mercato/core/modules/notifications/lib/notificationService'
+import type { AiConversationSharedPayload } from '../../events'
+
+const RESOLVE_NOTIFICATION_SERVICE = resolveNotificationService as jest.MockedFunction<
+  typeof resolveNotificationService
+>
+
+function makePayload(
+  overrides: Partial<AiConversationSharedPayload> = {},
+): AiConversationSharedPayload {
+  return {
+    conversationId: 'conv-1',
+    tenantId: 'tenant-1',
+    organizationId: 'org-1',
+    ownerUserId: 'user-owner',
+    participantUserId: 'user-recipient',
+    role: 'viewer',
+    ...overrides,
+  }
+}
+
+function makeCtx(create: jest.Mock) {
+  const container = { resolve: jest.fn() }
+  RESOLVE_NOTIFICATION_SERVICE.mockReturnValue({ create } as never)
+  return { resolve: (name: string) => container.resolve(name), container }
+}
+
+describe('conversation-shared-notify subscriber', () => {
+  beforeEach(() => {
+    jest.clearAllMocks()
+  })
+
+  it('persists a resolved default-locale title and body, not the raw i18n key', async () => {
+    const create = jest.fn(async () => ({ ok: true }))
+    const ctx = makeCtx(create)
+
+    await handleConversationShared(makePayload(), ctx)
+
+    expect(create).toHaveBeenCalledTimes(1)
+    const [input] = create.mock.calls[0]
+    expect(input.title).toBe('Conversation shared with you')
+    expect(input.body).toBe('An AI conversation has been shared with you.')
+    expect(input.titleKey).toBe('ai_assistant.notifications.conversation_shared.title')
+    expect(input.bodyKey).toBe('ai_assistant.notifications.conversation_shared.body')
+  })
+
+  it('still calls the notification service with the recipient tenant scope', async () => {
+    const create = jest.fn(async () => ({ ok: true }))
+    const ctx = makeCtx(create)
+
+    await handleConversationShared(makePayload(), ctx)
+
+    const [, scope] = create.mock.calls[0]
+    expect(scope).toEqual({ tenantId: 'tenant-1', organizationId: 'org-1' })
+  })
+
+  it('returns early without calling create when participantUserId is missing', async () => {
+    const create = jest.fn(async () => ({ ok: true }))
+    const ctx = makeCtx(create)
+
+    await handleConversationShared(
+      makePayload({ participantUserId: '' as unknown as string }),
+      ctx,
+    )
+
+    expect(create).not.toHaveBeenCalled()
+  })
+
+  it('returns early without calling create when tenantId is missing', async () => {
+    const create = jest.fn(async () => ({ ok: true }))
+    const ctx = makeCtx(create)
+
+    await handleConversationShared(
+      makePayload({ tenantId: '' as unknown as string }),
+      ctx,
+    )
+
+    expect(create).not.toHaveBeenCalled()
+  })
+
+  it('falls back to the i18n key when the dictionary lookup throws', async () => {
+    const i18nServer = jest.requireMock('@open-mercato/shared/lib/i18n/server')
+    i18nServer.loadDictionary.mockRejectedValueOnce(new Error('dictionary unavailable'))
+    const create = jest.fn(async () => ({ ok: true }))
+    const ctx = makeCtx(create)
+
+    await handleConversationShared(makePayload(), ctx)
+
+    expect(create).toHaveBeenCalledTimes(1)
+    const [input] = create.mock.calls[0]
+    expect(input.title).toBe('ai_assistant.notifications.conversation_shared.title')
+    expect(input.body).toBe('ai_assistant.notifications.conversation_shared.body')
+  })
+})