@open-mercato/ai-assistant 0.6.2-develop.3461.1.605f31c2c9 → 0.6.2

package/src/modules/ai_assistant/data/validators.ts

@@ -0,0 +1,134 @@
+import { z } from 'zod'
+
+/**
+ * Zod validators for the server-side AI chat conversation APIs.
+ *
+ * Spec: `2026-05-05-ai-chat-server-side-conversation-storage`. Used by the
+ * REST routes under `api/ai/conversations/...` and by the repository to keep
+ * input shapes aligned with the database constraints declared in
+ * `data/entities.ts`.
+ */
+
+/** Page-context snapshot persisted on a conversation row. */
+export const aiChatPageContextSchema = z
+  .object({
+    pageId: z.string().min(1).max(256).optional(),
+    entityType: z.string().min(1).max(256).optional(),
+    recordId: z.string().min(1).max(256).optional(),
+  })
+  .passthrough()
+
+export type AiChatPageContextInput = z.infer<typeof aiChatPageContextSchema>
+
+const aiAgentIdSchema = z
+  .string()
+  .trim()
+  .min(1, 'agentId must be a non-empty string')
+  .max(256, 'agentId exceeds the maximum length of 256 characters')
+
+const conversationIdSchema = z
+  .string()
+  .trim()
+  .min(1, 'conversationId must be a non-empty string')
+  .max(128, 'conversationId exceeds the maximum length of 128 characters')
+
+const titleSchema = z.string().trim().min(1).max(200)
+
+/** `POST /api/ai_assistant/ai/conversations` */
+export const aiChatConversationCreateSchema = z.object({
+  agentId: aiAgentIdSchema,
+  conversationId: conversationIdSchema.optional(),
+  title: titleSchema.optional(),
+  pageContext: aiChatPageContextSchema.nullable().optional(),
+})
+
+export type AiChatConversationCreateInput = z.infer<typeof aiChatConversationCreateSchema>
+
+/** `GET /api/ai_assistant/ai/conversations?agent=&status=&limit=&cursor=` */
+export const aiChatConversationListQuerySchema = z.object({
+  agent: aiAgentIdSchema.optional(),
+  status: z.enum(['open', 'closed']).optional(),
+  limit: z.coerce.number().int().min(1).max(100).optional(),
+  cursor: z.string().trim().min(1).max(200).optional(),
+})
+
+export type AiChatConversationListQuery = z.infer<typeof aiChatConversationListQuerySchema>
+
+/** `PATCH /api/ai_assistant/ai/conversations/:conversationId` */
+export const aiChatConversationUpdateSchema = z
+  .object({
+    title: titleSchema.nullable().optional(),
+    status: z.enum(['open', 'closed']).optional(),
+    pageContext: aiChatPageContextSchema.nullable().optional(),
+  })
+  .refine(
+    (value) =>
+      typeof value.title !== 'undefined' ||
+      typeof value.status !== 'undefined' ||
+      typeof value.pageContext !== 'undefined',
+    { message: 'At least one of title, status, or pageContext is required.' },
+  )
+
+export type AiChatConversationUpdateInput = z.infer<typeof aiChatConversationUpdateSchema>
+
+const messageRoleSchema = z.enum(['user', 'assistant', 'system'])
+
+/**
+ * Shared message-body shape. `clientMessageId` is the idempotency key for
+ * retries and lazy imports; `content` is capped to keep transcript rows
+ * bounded; `uiParts` / `attachmentIds` / `files` accept the serializable
+ * subset the chat UI already produces. Attachment previews (`data:` URLs
+ * and transient blob URLs) MUST NOT pass through here — the UI strips them
+ * before upload.
+ */
+const messageBaseSchema = z.object({
+  clientMessageId: z.string().trim().min(1).max(128).optional(),
+  role: messageRoleSchema,
+  content: z.string().max(64_000),
+  uiParts: z.array(z.unknown()).max(64).optional(),
+  attachmentIds: z.array(z.string().trim().min(1).max(128)).max(32).optional(),
+  files: z
+    .array(
+      z
+        .object({
+          id: z.string().trim().min(1).max(128).optional(),
+          name: z.string().trim().min(1).max(256).optional(),
+          mimeType: z.string().trim().min(1).max(128).optional(),
+          size: z.number().int().nonnegative().optional(),
+        })
+        .passthrough(),
+    )
+    .max(32)
+    .optional(),
+  model: z.string().trim().min(1).max(128).optional(),
+  metadata: z.record(z.string(), z.unknown()).optional(),
+})
+
+/** `POST /api/ai_assistant/ai/conversations/import` */
+export const aiChatConversationImportSchema = z.object({
+  conversation: z.object({
+    conversationId: conversationIdSchema,
+    agentId: aiAgentIdSchema,
+    title: titleSchema.optional(),
+    status: z.enum(['open', 'closed']).optional(),
+    pageContext: aiChatPageContextSchema.nullable().optional(),
+  }),
+  messages: z.array(messageBaseSchema).max(100),
+})
+
+export type AiChatConversationImportInput = z.infer<typeof aiChatConversationImportSchema>
+
+/** Transcript GET query: `?limit=&before=` */
+export const aiChatConversationTranscriptQuerySchema = z.object({
+  limit: z.coerce.number().int().min(1).max(200).optional(),
+  before: z.string().trim().min(1).max(200).optional(),
+})
+
+export type AiChatConversationTranscriptQuery = z.infer<
+  typeof aiChatConversationTranscriptQuerySchema
+>
+
+/** Internal payload accepted by the repository when appending a single message. */
+export const aiChatMessageAppendSchema = messageBaseSchema
+
+export type AiChatMessageAppendInput = z.infer<typeof aiChatMessageAppendSchema>

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

@@ -176,6 +176,7 @@
   "ai_assistant.chat.dock.close": "KI-Dock schließen",
   "ai_assistant.chat.dock.collapse": "KI-Dock einklappen",
   "ai_assistant.chat.dock.expand": "KI-Dock erweitern",
+  "ai_assistant.chat.downloadFile": "{name} herunterladen",
   "ai_assistant.chat.emptyTranscript": "Noch keine Nachrichten. Stellen Sie dem Agenten eine Frage, um zu beginnen.",
   "ai_assistant.chat.errorTitle": "Agenten-Anfrage fehlgeschlagen",
   "ai_assistant.chat.example.create": "Ein neues Produkt erstellen",
@@ -183,6 +184,7 @@
   "ai_assistant.chat.example.show": "Aktuelle Bestellungen anzeigen",
   "ai_assistant.chat.idleExamples": "Beispiele:",
   "ai_assistant.chat.idleTitle": "Stellen Sie eine Frage oder beschreiben Sie, was Sie tun möchten.",
+  "ai_assistant.chat.imagePreviewDialogDescription": "Bildvorschau",
   "ai_assistant.chat.mutation_cards.confirmation.cancel": "Abbrechen",
   "ai_assistant.chat.mutation_cards.confirmation.defaultSummary": "Die angeforderten Änderungen werden ausgeführt...",
   "ai_assistant.chat.mutation_cards.confirmation.errorTitle": "Bestätigung fehlgeschlagen",
@@ -273,6 +275,7 @@
   "ai_assistant.chat.uiPartPending": "Ausstehendes UI-Element:",
   "ai_assistant.chat.userRoleLabel": "Sie",
   "ai_assistant.chat.welcomeTitle": "How can I help?",
+  "ai_assistant.chat.zoomImage": "Vorschau von {name} öffnen",
   "ai_assistant.dock.bottom": "Unten andocken",
   "ai_assistant.dock.close": "Schließen",
   "ai_assistant.dock.floating": "Schwebend",

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

@@ -176,6 +176,7 @@
   "ai_assistant.chat.dock.close": "Close AI dock",
   "ai_assistant.chat.dock.collapse": "Collapse AI dock",
   "ai_assistant.chat.dock.expand": "Expand AI dock",
+  "ai_assistant.chat.downloadFile": "Download {name}",
   "ai_assistant.chat.emptyTranscript": "No messages yet. Ask the agent anything to get started.",
   "ai_assistant.chat.errorTitle": "Agent dispatch failed",
   "ai_assistant.chat.example.create": "Create a new product",
@@ -183,6 +184,7 @@
   "ai_assistant.chat.example.show": "Show me recent orders",
   "ai_assistant.chat.idleExamples": "Examples:",
   "ai_assistant.chat.idleTitle": "Ask me anything or describe what you want to do.",
+  "ai_assistant.chat.imagePreviewDialogDescription": "Image preview",
   "ai_assistant.chat.mutation_cards.confirmation.cancel": "Cancel",
   "ai_assistant.chat.mutation_cards.confirmation.defaultSummary": "Applying the requested changes...",
   "ai_assistant.chat.mutation_cards.confirmation.errorTitle": "Confirm failed",
@@ -273,6 +275,7 @@
   "ai_assistant.chat.uiPartPending": "Pending UI part:",
   "ai_assistant.chat.userRoleLabel": "You",
   "ai_assistant.chat.welcomeTitle": "How can I help?",
+  "ai_assistant.chat.zoomImage": "Open {name} preview",
   "ai_assistant.dock.bottom": "Dock Bottom",
   "ai_assistant.dock.close": "Close",
   "ai_assistant.dock.floating": "Floating",

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

@@ -176,6 +176,7 @@
   "ai_assistant.chat.dock.close": "Cerrar el panel de IA",
   "ai_assistant.chat.dock.collapse": "Contraer el panel de IA",
   "ai_assistant.chat.dock.expand": "Ampliar el panel de IA",
+  "ai_assistant.chat.downloadFile": "Descargar {name}",
   "ai_assistant.chat.emptyTranscript": "Aún no hay mensajes. Pregúntele al agente cualquier cosa para empezar.",
   "ai_assistant.chat.errorTitle": "Error al enviar la solicitud al agente",
   "ai_assistant.chat.example.create": "Crear un producto nuevo",
@@ -183,6 +184,7 @@
   "ai_assistant.chat.example.show": "Mostrar pedidos recientes",
   "ai_assistant.chat.idleExamples": "Ejemplos:",
   "ai_assistant.chat.idleTitle": "Pregunte lo que necesite o describa lo que desea hacer.",
+  "ai_assistant.chat.imagePreviewDialogDescription": "Vista previa de imagen",
   "ai_assistant.chat.mutation_cards.confirmation.cancel": "Cancelar",
   "ai_assistant.chat.mutation_cards.confirmation.defaultSummary": "Aplicando los cambios solicitados...",
   "ai_assistant.chat.mutation_cards.confirmation.errorTitle": "La confirmación falló",
@@ -273,6 +275,7 @@
   "ai_assistant.chat.uiPartPending": "Parte de UI pendiente:",
   "ai_assistant.chat.userRoleLabel": "Usted",
   "ai_assistant.chat.welcomeTitle": "How can I help?",
+  "ai_assistant.chat.zoomImage": "Abrir vista previa de {name}",
   "ai_assistant.dock.bottom": "Anclar abajo",
   "ai_assistant.dock.close": "Cerrar",
   "ai_assistant.dock.floating": "Flotante",

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

@@ -176,6 +176,7 @@
   "ai_assistant.chat.dock.close": "Zamknij panel AI",
   "ai_assistant.chat.dock.collapse": "Zwiń panel AI",
   "ai_assistant.chat.dock.expand": "Rozwiń panel AI",
+  "ai_assistant.chat.downloadFile": "Pobierz {name}",
   "ai_assistant.chat.emptyTranscript": "Brak wiadomości. Zadaj agentowi dowolne pytanie, aby rozpocząć.",
   "ai_assistant.chat.errorTitle": "Nie udało się wysłać żądania do agenta",
   "ai_assistant.chat.example.create": "Utwórz nowy produkt",
@@ -183,6 +184,7 @@
   "ai_assistant.chat.example.show": "Pokaż ostatnie zamówienia",
   "ai_assistant.chat.idleExamples": "Przykłady:",
   "ai_assistant.chat.idleTitle": "Zapytaj mnie o cokolwiek lub opisz, co chcesz zrobić.",
+  "ai_assistant.chat.imagePreviewDialogDescription": "Podgląd obrazu",
   "ai_assistant.chat.mutation_cards.confirmation.cancel": "Anuluj",
   "ai_assistant.chat.mutation_cards.confirmation.defaultSummary": "Wdrażanie żądanych zmian...",
   "ai_assistant.chat.mutation_cards.confirmation.errorTitle": "Potwierdzenie nie powiodło się",
@@ -273,6 +275,7 @@
   "ai_assistant.chat.uiPartPending": "Oczekująca część UI:",
   "ai_assistant.chat.userRoleLabel": "Ty",
   "ai_assistant.chat.welcomeTitle": "How can I help?",
+  "ai_assistant.chat.zoomImage": "Otwórz podgląd {name}",
   "ai_assistant.dock.bottom": "Dokuj na dole",
   "ai_assistant.dock.close": "Zamknij",
   "ai_assistant.dock.floating": "Pływające",

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

@@ -0,0 +1,93 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import type { AwilixContainer } from 'awilix'
+import {
+  AiChatConversation,
+  AiChatMessage,
+} from '../data/entities'
+import {
+  AiChatConversationAccessError,
+  AiChatConversationRepository,
+  type AiChatConversationContext,
+} from '../data/repositories/AiChatConversationRepository'
+
+/**
+ * Thin service-layer wrapper that resolves the entity manager from the
+ * Awilix container and exposes a typed API on top of
+ * `AiChatConversationRepository`. The REST routes for the conversation APIs
+ * call into this surface; the future chat dispatcher write path will reuse
+ * the same helpers so persistence stays consistent across entry points.
+ *
+ * Spec: `2026-05-05-ai-chat-server-side-conversation-storage` §"Commands".
+ *
+ * Re-exports the access error so route handlers can map it to a 404 without
+ * importing the repository directly.
+ */
+export { AiChatConversationAccessError }
+export type { AiChatConversationContext }
+
+export function createConversationStorage(
+  container: AwilixContainer,
+): AiChatConversationRepository {
+  const em = container.resolve<EntityManager>('em')
+  return new AiChatConversationRepository(em)
+}
+
+export interface SerializedAiChatConversation {
+  conversationId: string
+  agentId: string
+  title: string | null
+  status: 'open' | 'closed'
+  visibility: 'private' | 'shared' | 'organization'
+  pageContext: Record<string, unknown> | null
+  createdAt: string
+  updatedAt: string
+  lastMessageAt: string | null
+  importedFromLocalAt: string | null
+}
+
+export interface SerializedAiChatMessage {
+  id: string
+  clientMessageId: string | null
+  role: 'user' | 'assistant' | 'system'
+  content: string
+  uiParts: unknown[]
+  attachmentIds: string[]
+  files: Array<Record<string, unknown>>
+  model: string | null
+  metadata: Record<string, unknown> | null
+  createdAt: string
+}
+
+export function serializeAiChatConversation(
+  row: AiChatConversation,
+): SerializedAiChatConversation {
+  return {
+    conversationId: row.conversationId,
+    agentId: row.agentId,
+    title: row.title ?? null,
+    status: row.status,
+    visibility: row.visibility,
+    pageContext: row.pageContext ?? null,
+    createdAt: row.createdAt.toISOString(),
+    updatedAt: row.updatedAt.toISOString(),
+    lastMessageAt: row.lastMessageAt ? row.lastMessageAt.toISOString() : null,
+    importedFromLocalAt: row.importedFromLocalAt
+      ? row.importedFromLocalAt.toISOString()
+      : null,
+  }
+}
+
+export function serializeAiChatMessage(row: AiChatMessage): SerializedAiChatMessage {
+  return {
+    id: row.id,
+    clientMessageId: row.clientMessageId ?? null,
+    role: row.role,
+    content: row.content,
+    uiParts: Array.isArray(row.uiParts) ? row.uiParts : [],
+    attachmentIds: Array.isArray(row.attachmentIds) ? row.attachmentIds : [],
+    files: Array.isArray(row.filesMetadata) ? row.filesMetadata : [],
+    model: row.model ?? null,
+    metadata: row.metadata ?? null,
+    createdAt: row.createdAt.toISOString(),
+  }
+}