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

package/dist/modules/ai_assistant/data/repositories/AiChatConversationRepository.js

@@ -0,0 +1,448 @@
+import {
+  findOneWithDecryption,
+  findWithDecryption
+} from "@open-mercato/shared/lib/encryption/find";
+import {
+  AiChatConversation,
+  AiChatConversationParticipant,
+  AiChatMessage
+} from "../entities.js";
+const DEFAULT_LIST_LIMIT = 50;
+const MAX_LIST_LIMIT = 100;
+const DEFAULT_TRANSCRIPT_LIMIT = 100;
+const MAX_TRANSCRIPT_LIMIT = 200;
+class AiChatConversationAccessError extends Error {
+  constructor(message = "Conversation is not accessible to the caller.") {
+    super(message);
+    this.name = "AiChatConversationAccessError";
+  }
+}
+class AiChatConversationRepository {
+  constructor(em) {
+    this.em = em;
+  }
+  /**
+   * Idempotent create. If a non-deleted conversation already exists for the
+   * caller in this tenant/org with the same `conversationId`, returns the
+   * existing row. The owner-participant row is created in the same
+   * transaction; a partial failure leaves no orphan conversation.
+   */
+  async createOrGet(input, ctx) {
+    assertContext(ctx, "createOrGet");
+    if (!input?.agentId) {
+      throw new Error("AiChatConversationRepository.createOrGet requires agentId");
+    }
+    const now = input.now ?? /* @__PURE__ */ new Date();
+    const conversationId = (input.conversationId ?? "").trim() || generateConversationId();
+    return this.em.transactional(async (tx) => {
+      const existing = await findOneAccessibleConversation(
+        tx,
+        conversationId,
+        ctx
+      );
+      if (existing) {
+        if (existing.ownerUserId !== ctx.userId) {
+          throw new AiChatConversationAccessError();
+        }
+        return existing;
+      }
+      const conversation = tx.create(AiChatConversation, {
+        tenantId: ctx.tenantId,
+        organizationId: ctx.organizationId ?? null,
+        conversationId,
+        agentId: input.agentId,
+        ownerUserId: ctx.userId,
+        title: normalizeTitle(input.title),
+        status: "open",
+        visibility: "private",
+        pageContext: input.pageContext ?? null,
+        lastMessageAt: null,
+        importedFromLocalAt: input.importedFromLocal ? now : null,
+        createdAt: now,
+        updatedAt: now,
+        deletedAt: null
+      });
+      const participant = tx.create(AiChatConversationParticipant, {
+        tenantId: ctx.tenantId,
+        organizationId: ctx.organizationId ?? null,
+        conversationId,
+        userId: ctx.userId,
+        role: "owner",
+        lastReadAt: null,
+        createdAt: now,
+        updatedAt: now
+      });
+      await tx.persist(conversation).persist(participant).flush();
+      return conversation;
+    });
+  }
+  /** Fetch within tenant/org. View-only callers see only their own conversations. */
+  async getById(conversationId, ctx) {
+    assertContext(ctx, "getById");
+    if (!conversationId) return null;
+    const row = await findOneAccessibleConversation(this.em, conversationId, ctx);
+    if (!row) return null;
+    if (!canAccessConversation(row, ctx)) return null;
+    return row;
+  }
+  /** Owner-scoped list unless the caller has tenant/org manage access. */
+  async list(ctx, options = {}) {
+    assertContext(ctx, "list");
+    const limit = clampLimit(options.limit, DEFAULT_LIST_LIMIT, MAX_LIST_LIMIT);
+    const where = {
+      tenantId: ctx.tenantId,
+      organizationId: ctx.organizationId ?? null,
+      deletedAt: null
+    };
+    if (!canManageConversations(ctx)) where.ownerUserId = ctx.userId;
+    if (options.agentId) where.agentId = options.agentId;
+    if (options.status) where.status = options.status;
+    if (options.cursor) {
+      const cursorDate = parseIso(options.cursor);
+      if (cursorDate) {
+        where.lastMessageAt = { $lt: cursorDate };
+      }
+    }
+    const rows = await findWithDecryption(
+      this.em,
+      AiChatConversation,
+      where,
+      {
+        orderBy: [{ lastMessageAt: "desc" }, { createdAt: "desc" }],
+        limit: limit + 1
+      },
+      {
+        tenantId: ctx.tenantId ?? null,
+        organizationId: ctx.organizationId ?? null
+      }
+    );
+    let nextCursor = null;
+    if (rows.length > limit) {
+      const lastIncluded = rows[limit - 1];
+      const cursorValue = lastIncluded.lastMessageAt ?? lastIncluded.createdAt;
+      nextCursor = cursorValue ? cursorValue.toISOString() : null;
+    }
+    return { items: rows.slice(0, limit), nextCursor };
+  }
+  /** Update within tenant/org. View-only callers can update only their own conversations. */
+  async update(conversationId, patch, ctx) {
+    assertContext(ctx, "update");
+    if (!conversationId) {
+      throw new Error("AiChatConversationRepository.update requires conversationId");
+    }
+    return this.em.transactional(async (tx) => {
+      const existing = await findOneAccessibleConversation(
+        tx,
+        conversationId,
+        ctx
+      );
+      if (!existing) {
+        throw new AiChatConversationAccessError(
+          `Conversation "${conversationId}" was not found for the caller.`
+        );
+      }
+      if (!canAccessConversation(existing, ctx)) {
+        throw new AiChatConversationAccessError();
+      }
+      const now = patch.now ?? /* @__PURE__ */ new Date();
+      if (Object.prototype.hasOwnProperty.call(patch, "title")) {
+        existing.title = normalizeTitle(patch.title);
+      }
+      if (patch.status) existing.status = patch.status;
+      if (Object.prototype.hasOwnProperty.call(patch, "pageContext")) {
+        existing.pageContext = patch.pageContext ?? null;
+      }
+      existing.updatedAt = now;
+      await tx.persist(existing).flush();
+      return existing;
+    });
+  }
+  /** Soft-delete the conversation and all its messages in one transaction. */
+  async softDelete(conversationId, ctx, now = /* @__PURE__ */ new Date()) {
+    assertContext(ctx, "softDelete");
+    if (!conversationId) {
+      throw new Error("AiChatConversationRepository.softDelete requires conversationId");
+    }
+    await this.em.transactional(async (tx) => {
+      const existing = await findOneAccessibleConversation(
+        tx,
+        conversationId,
+        ctx
+      );
+      if (!existing) {
+        throw new AiChatConversationAccessError(
+          `Conversation "${conversationId}" was not found for the caller.`
+        );
+      }
+      if (!canAccessConversation(existing, ctx)) {
+        throw new AiChatConversationAccessError();
+      }
+      existing.deletedAt = now;
+      existing.status = "closed";
+      existing.updatedAt = now;
+      await tx.persist(existing).flush();
+      const messages = await findWithDecryption(
+        tx,
+        AiChatMessage,
+        {
+          tenantId: ctx.tenantId,
+          organizationId: ctx.organizationId ?? null,
+          conversationId,
+          deletedAt: null
+        },
+        {},
+        {
+          tenantId: ctx.tenantId ?? null,
+          organizationId: ctx.organizationId ?? null
+        }
+      );
+      for (const msg of messages) {
+        msg.deletedAt = now;
+        msg.updatedAt = now;
+        tx.persist(msg);
+      }
+      if (messages.length > 0) await tx.flush();
+    });
+  }
+  /**
+   * Owner-only transcript hydration. Internally fetched DESC so the `before`
+   * cursor naturally advances toward older messages, then reversed so the
+   * response contract (`messages` array ordered ascending by `createdAt`)
+   * stays stable for callers. `nextCursor` points to the OLDEST message in
+   * the returned page — the next call with `before=<cursor>` fetches the
+   * next-older window.
+   */
+  async getTranscript(conversationId, ctx, options = {}) {
+    assertContext(ctx, "getTranscript");
+    if (!conversationId) return null;
+    const conversation = await this.getById(conversationId, ctx);
+    if (!conversation) return null;
+    const limit = clampLimit(options.limit, DEFAULT_TRANSCRIPT_LIMIT, MAX_TRANSCRIPT_LIMIT);
+    const where = {
+      tenantId: ctx.tenantId,
+      organizationId: ctx.organizationId ?? null,
+      conversationId,
+      deletedAt: null
+    };
+    if (options.before) {
+      const beforeDate = parseIso(options.before);
+      if (beforeDate) {
+        where.createdAt = { $lt: beforeDate };
+      }
+    }
+    const rows = await findWithDecryption(
+      this.em,
+      AiChatMessage,
+      where,
+      {
+        orderBy: { createdAt: "desc" },
+        limit: limit + 1
+      },
+      {
+        tenantId: ctx.tenantId ?? null,
+        organizationId: ctx.organizationId ?? null
+      }
+    );
+    let nextCursor = null;
+    let pageDesc;
+    if (rows.length > limit) {
+      pageDesc = rows.slice(0, limit);
+      const oldestIncluded = pageDesc[pageDesc.length - 1];
+      nextCursor = oldestIncluded?.createdAt ? oldestIncluded.createdAt.toISOString() : null;
+    } else {
+      pageDesc = rows;
+    }
+    const messages = [...pageDesc].reverse();
+    return { conversation, messages, nextCursor };
+  }
+  /**
+   * Append a single message to an owner-accessible conversation. Honors
+   * `clientMessageId` idempotency: if a non-deleted message with the same
+   * client id already exists, returns it untouched.
+   */
+  async appendMessage(conversationId, input, ctx, options = {}) {
+    assertContext(ctx, "appendMessage");
+    if (!conversationId) {
+      throw new Error("AiChatConversationRepository.appendMessage requires conversationId");
+    }
+    return this.em.transactional(async (tx) => {
+      const conversation = await findOneAccessibleConversation(
+        tx,
+        conversationId,
+        ctx
+      );
+      if (!conversation) {
+        throw new AiChatConversationAccessError(
+          `Conversation "${conversationId}" was not found for the caller.`
+        );
+      }
+      if (conversation.ownerUserId !== ctx.userId) {
+        throw new AiChatConversationAccessError();
+      }
+      const now = options.createdAt ?? /* @__PURE__ */ new Date();
+      if (input.clientMessageId) {
+        const existing = await findOneWithDecryption(
+          tx,
+          AiChatMessage,
+          {
+            tenantId: ctx.tenantId,
+            organizationId: ctx.organizationId ?? null,
+            conversationId,
+            clientMessageId: input.clientMessageId,
+            deletedAt: null
+          },
+          {},
+          {
+            tenantId: ctx.tenantId ?? null,
+            organizationId: ctx.organizationId ?? null
+          }
+        );
+        if (existing) return existing;
+      }
+      const message = tx.create(AiChatMessage, {
+        tenantId: ctx.tenantId,
+        organizationId: ctx.organizationId ?? null,
+        conversationId,
+        clientMessageId: input.clientMessageId ?? null,
+        role: input.role,
+        content: input.content,
+        uiParts: normalizeArray(input.uiParts),
+        attachmentIds: normalizeArray(input.attachmentIds),
+        filesMetadata: normalizeArray(input.files),
+        model: input.model ?? null,
+        metadata: input.metadata ?? null,
+        createdByUserId: options.createdByUserId === void 0 ? input.role === "user" ? ctx.userId : null : options.createdByUserId,
+        createdAt: now,
+        updatedAt: now,
+        deletedAt: null
+      });
+      conversation.lastMessageAt = now;
+      conversation.updatedAt = now;
+      await tx.persist(message).persist(conversation).flush();
+      return message;
+    });
+  }
+  /**
+   * Lazy migration entrypoint: create-or-get the conversation and append the
+   * provided messages with `clientMessageId` dedupe. Designed to be safe to
+   * call repeatedly — repeated imports of the same payload return the same
+   * counts of imported/skipped rows.
+   */
+  async importLocalConversation(input, ctx, now = /* @__PURE__ */ new Date()) {
+    assertContext(ctx, "importLocalConversation");
+    const conversation = await this.createOrGet(
+      { ...input.conversation, importedFromLocal: true, now },
+      ctx
+    );
+    if (input.conversation.status && conversation.status !== input.conversation.status) {
+      await this.update(
+        conversation.conversationId,
+        { status: input.conversation.status, now },
+        ctx
+      );
+    }
+    let imported = 0;
+    let skipped = 0;
+    for (const message of input.messages) {
+      if (!message.clientMessageId) {
+        skipped += 1;
+        continue;
+      }
+      const before = await findOneWithDecryption(
+        this.em,
+        AiChatMessage,
+        {
+          tenantId: ctx.tenantId,
+          organizationId: ctx.organizationId ?? null,
+          conversationId: conversation.conversationId,
+          clientMessageId: message.clientMessageId,
+          deletedAt: null
+        },
+        {},
+        {
+          tenantId: ctx.tenantId ?? null,
+          organizationId: ctx.organizationId ?? null
+        }
+      );
+      if (before) {
+        skipped += 1;
+        continue;
+      }
+      await this.appendMessage(
+        conversation.conversationId,
+        message,
+        ctx,
+        { createdAt: now }
+      );
+      imported += 1;
+    }
+    return {
+      conversation,
+      importedMessageCount: imported,
+      skippedMessageCount: skipped
+    };
+  }
+}
+function assertContext(ctx, method) {
+  if (!ctx?.tenantId) {
+    throw new Error(`AiChatConversationRepository.${method} requires tenantId`);
+  }
+  if (!ctx?.userId) {
+    throw new Error(`AiChatConversationRepository.${method} requires userId`);
+  }
+}
+function canManageConversations(ctx) {
+  return ctx.canManageConversations === true;
+}
+function canAccessConversation(row, ctx) {
+  return canManageConversations(ctx) || row.ownerUserId === ctx.userId;
+}
+async function findOneAccessibleConversation(em, conversationId, ctx) {
+  const row = await findOneWithDecryption(
+    em,
+    AiChatConversation,
+    {
+      tenantId: ctx.tenantId,
+      organizationId: ctx.organizationId ?? null,
+      conversationId,
+      deletedAt: null
+    },
+    {},
+    {
+      tenantId: ctx.tenantId ?? null,
+      organizationId: ctx.organizationId ?? null
+    }
+  );
+  return row ?? null;
+}
+function normalizeTitle(title) {
+  if (title === void 0) return null;
+  if (title === null) return null;
+  const trimmed = title.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function normalizeArray(value) {
+  if (!Array.isArray(value) || value.length === 0) return null;
+  return value;
+}
+function clampLimit(value, fallback, max) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
+  return Math.max(1, Math.min(Math.floor(value), max));
+}
+function parseIso(value) {
+  if (!value) return null;
+  const date = new Date(value);
+  return Number.isNaN(date.getTime()) ? null : date;
+}
+function generateConversationId() {
+  const cryptoMod = typeof globalThis === "object" ? globalThis.crypto : void 0;
+  if (cryptoMod?.randomUUID) return cryptoMod.randomUUID();
+  return `chat_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 12)}`;
+}
+var AiChatConversationRepository_default = AiChatConversationRepository;
+export {
+  AiChatConversationAccessError,
+  AiChatConversationRepository,
+  AiChatConversationRepository_default as default
+};
+//# sourceMappingURL=AiChatConversationRepository.js.map

package/dist/modules/ai_assistant/data/repositories/AiChatConversationRepository.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/ai_assistant/data/repositories/AiChatConversationRepository.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport {\n  findOneWithDecryption,\n  findWithDecryption,\n} from '@open-mercato/shared/lib/encryption/find'\nimport {\n  AiChatConversation,\n  AiChatConversationParticipant,\n  AiChatMessage,\n} from '../entities'\nimport type {\n  AiChatMessageAppendInput,\n  AiChatPageContextInput,\n} from '../validators'\n\n/**\n * Persistent store for AI chat conversations, participants, and messages.\n *\n * Owner-first MVP per spec\n * `2026-05-05-ai-chat-server-side-conversation-storage`. Every read/write\n * goes through `findOneWithDecryption` / `findWithDecryption` so the repo\n * stays consistent with the rest of the module and is GDPR-encryption-ready\n * without a second refactor when `content` / `ui_parts` columns are\n * eventually flagged.\n *\n * Tenant + organization scope is required on every method. View-only callers\n * are owner-scoped. Callers with `ai_assistant.conversations.manage` may\n * list/read/update/delete any conversation in the same tenant/org, but never\n * outside that boundary. The participant row is written transactionally\n * alongside conversation create/import.\n *\n * TODO(ai-chat-sharing): widen the non-manage read predicate to include\n * explicit undeleted participants once shared conversations are implemented.\n */\n\nexport interface AiChatConversationContext {\n  tenantId: string\n  organizationId?: string | null\n  userId: string\n  canManageConversations?: boolean\n}\n\nexport interface AiChatConversationCreateOrGetInput {\n  conversationId?: string | null\n  agentId: string\n  title?: string | null\n  pageContext?: AiChatPageContextInput | null\n  /** Marks the conversation as imported from local storage (sets `importedFromLocalAt`). */\n  importedFromLocal?: boolean\n  /** Optional explicit `now` for deterministic tests. */\n  now?: Date\n}\n\nexport interface AiChatConversationListOptions {\n  agentId?: string | null\n  status?: 'open' | 'closed' | null\n  limit?: number\n  cursor?: string | null\n}\n\nexport interface AiChatConversationUpdateInput {\n  title?: string | null\n  status?: 'open' | 'closed'\n  pageContext?: AiChatPageContextInput | null\n  /** Optional explicit `now` for deterministic tests. */\n  now?: Date\n}\n\nexport interface AiChatTranscriptOptions {\n  limit?: number\n  /** ISO timestamp string; rows strictly older than this are returned. */\n  before?: string | null\n}\n\nexport interface AiChatTranscriptResult {\n  conversation: AiChatConversation\n  messages: AiChatMessage[]\n  nextCursor: string | null\n}\n\nexport interface AiChatMessageAppendOptions {\n  /** Override the message timestamp (used to thread server-injected stream-completion turns). */\n  createdAt?: Date\n  /** Override `createdByUserId` (defaults to the calling context user). */\n  createdByUserId?: string | null\n}\n\nexport interface AiChatConversationImportResult {\n  conversation: AiChatConversation\n  importedMessageCount: number\n  skippedMessageCount: number\n}\n\nconst DEFAULT_LIST_LIMIT = 50\nconst MAX_LIST_LIMIT = 100\nconst DEFAULT_TRANSCRIPT_LIMIT = 100\nconst MAX_TRANSCRIPT_LIMIT = 200\n\nexport class AiChatConversationAccessError extends Error {\n  override readonly name = 'AiChatConversationAccessError'\n  constructor(message: string = 'Conversation is not accessible to the caller.') {\n    super(message)\n  }\n}\n\nexport class AiChatConversationRepository {\n  constructor(private readonly em: EntityManager) {}\n\n  /**\n   * Idempotent create. If a non-deleted conversation already exists for the\n   * caller in this tenant/org with the same `conversationId`, returns the\n   * existing row. The owner-participant row is created in the same\n   * transaction; a partial failure leaves no orphan conversation.\n   */\n  async createOrGet(\n    input: AiChatConversationCreateOrGetInput,\n    ctx: AiChatConversationContext,\n  ): Promise<AiChatConversation> {\n    assertContext(ctx, 'createOrGet')\n    if (!input?.agentId) {\n      throw new Error('AiChatConversationRepository.createOrGet requires agentId')\n    }\n    const now = input.now ?? new Date()\n    const conversationId = (input.conversationId ?? '').trim() || generateConversationId()\n\n    return this.em.transactional(async (tx) => {\n      const existing = await findOneAccessibleConversation(\n        tx as unknown as EntityManager,\n        conversationId,\n        ctx,\n      )\n      if (existing) {\n        if (existing.ownerUserId !== ctx.userId) {\n          throw new AiChatConversationAccessError()\n        }\n        return existing\n      }\n      const conversation = tx.create(AiChatConversation, {\n        tenantId: ctx.tenantId,\n        organizationId: ctx.organizationId ?? null,\n        conversationId,\n        agentId: input.agentId,\n        ownerUserId: ctx.userId,\n        title: normalizeTitle(input.title),\n        status: 'open',\n        visibility: 'private',\n        pageContext: input.pageContext ?? null,\n        lastMessageAt: null,\n        importedFromLocalAt: input.importedFromLocal ? now : null,\n        createdAt: now,\n        updatedAt: now,\n        deletedAt: null,\n      } as unknown as AiChatConversation)\n      const participant = tx.create(AiChatConversationParticipant, {\n        tenantId: ctx.tenantId,\n        organizationId: ctx.organizationId ?? null,\n        conversationId,\n        userId: ctx.userId,\n        role: 'owner',\n        lastReadAt: null,\n        createdAt: now,\n        updatedAt: now,\n      } as unknown as AiChatConversationParticipant)\n      await tx.persist(conversation).persist(participant).flush()\n      return conversation\n    })\n  }\n\n  /** Fetch within tenant/org. View-only callers see only their own conversations. */\n  async getById(\n    conversationId: string,\n    ctx: AiChatConversationContext,\n  ): Promise<AiChatConversation | null> {\n    assertContext(ctx, 'getById')\n    if (!conversationId) return null\n    const row = await findOneAccessibleConversation(this.em, conversationId, ctx)\n    if (!row) return null\n    if (!canAccessConversation(row, ctx)) return null\n    return row\n  }\n\n  /** Owner-scoped list unless the caller has tenant/org manage access. */\n  async list(\n    ctx: AiChatConversationContext,\n    options: AiChatConversationListOptions = {},\n  ): Promise<{ items: AiChatConversation[]; nextCursor: string | null }> {\n    assertContext(ctx, 'list')\n    const limit = clampLimit(options.limit, DEFAULT_LIST_LIMIT, MAX_LIST_LIMIT)\n    const where: Record<string, unknown> = {\n      tenantId: ctx.tenantId,\n      organizationId: ctx.organizationId ?? null,\n      deletedAt: null,\n    }\n    if (!canManageConversations(ctx)) where.ownerUserId = ctx.userId\n    if (options.agentId) where.agentId = options.agentId\n    if (options.status) where.status = options.status\n    if (options.cursor) {\n      const cursorDate = parseIso(options.cursor)\n      if (cursorDate) {\n        where.lastMessageAt = { $lt: cursorDate }\n      }\n    }\n    const rows = await findWithDecryption<AiChatConversation>(\n      this.em,\n      AiChatConversation,\n      where as any,\n      {\n        orderBy: [{ lastMessageAt: 'desc' }, { createdAt: 'desc' }] as any,\n        limit: limit + 1,\n      },\n      {\n        tenantId: ctx.tenantId ?? null,\n        organizationId: ctx.organizationId ?? null,\n      },\n    )\n    let nextCursor: string | null = null\n    if (rows.length > limit) {\n      const lastIncluded = rows[limit - 1]\n      const cursorValue = lastIncluded.lastMessageAt ?? lastIncluded.createdAt\n      nextCursor = cursorValue ? cursorValue.toISOString() : null\n    }\n    return { items: rows.slice(0, limit), nextCursor }\n  }\n\n  /** Update within tenant/org. View-only callers can update only their own conversations. */\n  async update(\n    conversationId: string,\n    patch: AiChatConversationUpdateInput,\n    ctx: AiChatConversationContext,\n  ): Promise<AiChatConversation> {\n    assertContext(ctx, 'update')\n    if (!conversationId) {\n      throw new Error('AiChatConversationRepository.update requires conversationId')\n    }\n    return this.em.transactional(async (tx) => {\n      const existing = await findOneAccessibleConversation(\n        tx as unknown as EntityManager,\n        conversationId,\n        ctx,\n      )\n      if (!existing) {\n        throw new AiChatConversationAccessError(\n          `Conversation \"${conversationId}\" was not found for the caller.`,\n        )\n      }\n      if (!canAccessConversation(existing, ctx)) {\n        throw new AiChatConversationAccessError()\n      }\n      const now = patch.now ?? new Date()\n      if (Object.prototype.hasOwnProperty.call(patch, 'title')) {\n        existing.title = normalizeTitle(patch.title)\n      }\n      if (patch.status) existing.status = patch.status\n      if (Object.prototype.hasOwnProperty.call(patch, 'pageContext')) {\n        existing.pageContext = patch.pageContext ?? null\n      }\n      existing.updatedAt = now\n      await tx.persist(existing).flush()\n      return existing\n    })\n  }\n\n  /** Soft-delete the conversation and all its messages in one transaction. */\n  async softDelete(\n    conversationId: string,\n    ctx: AiChatConversationContext,\n    now: Date = new Date(),\n  ): Promise<void> {\n    assertContext(ctx, 'softDelete')\n    if (!conversationId) {\n      throw new Error('AiChatConversationRepository.softDelete requires conversationId')\n    }\n    await this.em.transactional(async (tx) => {\n      const existing = await findOneAccessibleConversation(\n        tx as unknown as EntityManager,\n        conversationId,\n        ctx,\n      )\n      if (!existing) {\n        throw new AiChatConversationAccessError(\n          `Conversation \"${conversationId}\" was not found for the caller.`,\n        )\n      }\n      if (!canAccessConversation(existing, ctx)) {\n        throw new AiChatConversationAccessError()\n      }\n      existing.deletedAt = now\n      existing.status = 'closed'\n      existing.updatedAt = now\n      await tx.persist(existing).flush()\n\n      const messages = await findWithDecryption<AiChatMessage>(\n        tx as unknown as EntityManager,\n        AiChatMessage,\n        {\n          tenantId: ctx.tenantId,\n          organizationId: ctx.organizationId ?? null,\n          conversationId,\n          deletedAt: null,\n        } as any,\n        {},\n        {\n          tenantId: ctx.tenantId ?? null,\n          organizationId: ctx.organizationId ?? null,\n        },\n      )\n      for (const msg of messages) {\n        msg.deletedAt = now\n        msg.updatedAt = now\n        tx.persist(msg)\n      }\n      if (messages.length > 0) await tx.flush()\n    })\n  }\n\n  /**\n   * Owner-only transcript hydration. Internally fetched DESC so the `before`\n   * cursor naturally advances toward older messages, then reversed so the\n   * response contract (`messages` array ordered ascending by `createdAt`)\n   * stays stable for callers. `nextCursor` points to the OLDEST message in\n   * the returned page \u2014 the next call with `before=<cursor>` fetches the\n   * next-older window.\n   */\n  async getTranscript(\n    conversationId: string,\n    ctx: AiChatConversationContext,\n    options: AiChatTranscriptOptions = {},\n  ): Promise<AiChatTranscriptResult | null> {\n    assertContext(ctx, 'getTranscript')\n    if (!conversationId) return null\n    const conversation = await this.getById(conversationId, ctx)\n    if (!conversation) return null\n    const limit = clampLimit(options.limit, DEFAULT_TRANSCRIPT_LIMIT, MAX_TRANSCRIPT_LIMIT)\n    const where: Record<string, unknown> = {\n      tenantId: ctx.tenantId,\n      organizationId: ctx.organizationId ?? null,\n      conversationId,\n      deletedAt: null,\n    }\n    if (options.before) {\n      const beforeDate = parseIso(options.before)\n      if (beforeDate) {\n        where.createdAt = { $lt: beforeDate }\n      }\n    }\n    const rows = await findWithDecryption<AiChatMessage>(\n      this.em,\n      AiChatMessage,\n      where as any,\n      {\n        orderBy: { createdAt: 'desc' } as any,\n        limit: limit + 1,\n      },\n      {\n        tenantId: ctx.tenantId ?? null,\n        organizationId: ctx.organizationId ?? null,\n      },\n    )\n    let nextCursor: string | null = null\n    let pageDesc: AiChatMessage[]\n    if (rows.length > limit) {\n      pageDesc = rows.slice(0, limit)\n      const oldestIncluded = pageDesc[pageDesc.length - 1]\n      nextCursor = oldestIncluded?.createdAt ? oldestIncluded.createdAt.toISOString() : null\n    } else {\n      pageDesc = rows\n    }\n    const messages = [...pageDesc].reverse()\n    return { conversation, messages, nextCursor }\n  }\n\n  /**\n   * Append a single message to an owner-accessible conversation. Honors\n   * `clientMessageId` idempotency: if a non-deleted message with the same\n   * client id already exists, returns it untouched.\n   */\n  async appendMessage(\n    conversationId: string,\n    input: AiChatMessageAppendInput,\n    ctx: AiChatConversationContext,\n    options: AiChatMessageAppendOptions = {},\n  ): Promise<AiChatMessage> {\n    assertContext(ctx, 'appendMessage')\n    if (!conversationId) {\n      throw new Error('AiChatConversationRepository.appendMessage requires conversationId')\n    }\n    return this.em.transactional(async (tx) => {\n      const conversation = await findOneAccessibleConversation(\n        tx as unknown as EntityManager,\n        conversationId,\n        ctx,\n      )\n      if (!conversation) {\n        throw new AiChatConversationAccessError(\n          `Conversation \"${conversationId}\" was not found for the caller.`,\n        )\n      }\n      if (conversation.ownerUserId !== ctx.userId) {\n        throw new AiChatConversationAccessError()\n      }\n      const now = options.createdAt ?? new Date()\n      if (input.clientMessageId) {\n        const existing = await findOneWithDecryption<AiChatMessage>(\n          tx as unknown as EntityManager,\n          AiChatMessage,\n          {\n            tenantId: ctx.tenantId,\n            organizationId: ctx.organizationId ?? null,\n            conversationId,\n            clientMessageId: input.clientMessageId,\n            deletedAt: null,\n          } as any,\n          {},\n          {\n            tenantId: ctx.tenantId ?? null,\n            organizationId: ctx.organizationId ?? null,\n          },\n        )\n        if (existing) return existing\n      }\n      const message = tx.create(AiChatMessage, {\n        tenantId: ctx.tenantId,\n        organizationId: ctx.organizationId ?? null,\n        conversationId,\n        clientMessageId: input.clientMessageId ?? null,\n        role: input.role,\n        content: input.content,\n        uiParts: normalizeArray(input.uiParts),\n        attachmentIds: normalizeArray(input.attachmentIds),\n        filesMetadata: normalizeArray(input.files),\n        model: input.model ?? null,\n        metadata: input.metadata ?? null,\n        createdByUserId:\n          options.createdByUserId === undefined\n            ? input.role === 'user'\n              ? ctx.userId\n              : null\n            : options.createdByUserId,\n        createdAt: now,\n        updatedAt: now,\n        deletedAt: null,\n      } as unknown as AiChatMessage)\n      conversation.lastMessageAt = now\n      conversation.updatedAt = now\n      await tx.persist(message).persist(conversation).flush()\n      return message\n    })\n  }\n\n  /**\n   * Lazy migration entrypoint: create-or-get the conversation and append the\n   * provided messages with `clientMessageId` dedupe. Designed to be safe to\n   * call repeatedly \u2014 repeated imports of the same payload return the same\n   * counts of imported/skipped rows.\n   */\n  async importLocalConversation(\n    input: {\n      conversation: AiChatConversationCreateOrGetInput & {\n        status?: 'open' | 'closed'\n      }\n      messages: AiChatMessageAppendInput[]\n    },\n    ctx: AiChatConversationContext,\n    now: Date = new Date(),\n  ): Promise<AiChatConversationImportResult> {\n    assertContext(ctx, 'importLocalConversation')\n    const conversation = await this.createOrGet(\n      { ...input.conversation, importedFromLocal: true, now },\n      ctx,\n    )\n    if (input.conversation.status && conversation.status !== input.conversation.status) {\n      await this.update(\n        conversation.conversationId,\n        { status: input.conversation.status, now },\n        ctx,\n      )\n    }\n    let imported = 0\n    let skipped = 0\n    for (const message of input.messages) {\n      if (!message.clientMessageId) {\n        // Without an idempotency key the import has no safe way to dedupe.\n        skipped += 1\n        continue\n      }\n      const before = await findOneWithDecryption<AiChatMessage>(\n        this.em,\n        AiChatMessage,\n        {\n          tenantId: ctx.tenantId,\n          organizationId: ctx.organizationId ?? null,\n          conversationId: conversation.conversationId,\n          clientMessageId: message.clientMessageId,\n          deletedAt: null,\n        } as any,\n        {},\n        {\n          tenantId: ctx.tenantId ?? null,\n          organizationId: ctx.organizationId ?? null,\n        },\n      )\n      if (before) {\n        skipped += 1\n        continue\n      }\n      await this.appendMessage(\n        conversation.conversationId,\n        message,\n        ctx,\n        { createdAt: now },\n      )\n      imported += 1\n    }\n    return {\n      conversation,\n      importedMessageCount: imported,\n      skippedMessageCount: skipped,\n    }\n  }\n}\n\nfunction assertContext(ctx: AiChatConversationContext | undefined, method: string): void {\n  if (!ctx?.tenantId) {\n    throw new Error(`AiChatConversationRepository.${method} requires tenantId`)\n  }\n  if (!ctx?.userId) {\n    throw new Error(`AiChatConversationRepository.${method} requires userId`)\n  }\n}\n\nfunction canManageConversations(ctx: AiChatConversationContext): boolean {\n  return ctx.canManageConversations === true\n}\n\nfunction canAccessConversation(\n  row: AiChatConversation,\n  ctx: AiChatConversationContext,\n): boolean {\n  return canManageConversations(ctx) || row.ownerUserId === ctx.userId\n}\n\nasync function findOneAccessibleConversation(\n  em: EntityManager,\n  conversationId: string,\n  ctx: AiChatConversationContext,\n): Promise<AiChatConversation | null> {\n  const row = await findOneWithDecryption<AiChatConversation>(\n    em,\n    AiChatConversation,\n    {\n      tenantId: ctx.tenantId,\n      organizationId: ctx.organizationId ?? null,\n      conversationId,\n      deletedAt: null,\n    } as any,\n    {},\n    {\n      tenantId: ctx.tenantId ?? null,\n      organizationId: ctx.organizationId ?? null,\n    },\n  )\n  return row ?? null\n}\n\nfunction normalizeTitle(title: string | null | undefined): string | null {\n  if (title === undefined) return null\n  if (title === null) return null\n  const trimmed = title.trim()\n  return trimmed.length > 0 ? trimmed : null\n}\n\nfunction normalizeArray<T>(value: T[] | null | undefined): T[] | null {\n  if (!Array.isArray(value) || value.length === 0) return null\n  return value\n}\n\nfunction clampLimit(value: number | undefined | null, fallback: number, max: number): number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) return fallback\n  return Math.max(1, Math.min(Math.floor(value), max))\n}\n\nfunction parseIso(value: string): Date | null {\n  if (!value) return null\n  const date = new Date(value)\n  return Number.isNaN(date.getTime()) ? null : date\n}\n\nfunction generateConversationId(): string {\n  // Prefer the runtime crypto generator when present; fall back to a non-cryptographic\n  // string for environments without `crypto.randomUUID()` (older Node / test mocks).\n  const cryptoMod: { randomUUID?: () => string } | undefined =\n    typeof globalThis === 'object' ? (globalThis as any).crypto : undefined\n  if (cryptoMod?.randomUUID) return cryptoMod.randomUUID()\n  return `chat_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 12)}`\n}\n\nexport default AiChatConversationRepository\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/ai_assistant/data/validators.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+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();
+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);
+const aiChatConversationCreateSchema = z.object({
+  agentId: aiAgentIdSchema,
+  conversationId: conversationIdSchema.optional(),
+  title: titleSchema.optional(),
+  pageContext: aiChatPageContextSchema.nullable().optional()
+});
+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()
+});
+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." }
+);
+const messageRoleSchema = z.enum(["user", "assistant", "system"]);
+const messageBaseSchema = z.object({
+  clientMessageId: z.string().trim().min(1).max(128).optional(),
+  role: messageRoleSchema,
+  content: z.string().max(64e3),
+  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()
+});
+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)
+});
+const aiChatConversationTranscriptQuerySchema = z.object({
+  limit: z.coerce.number().int().min(1).max(200).optional(),
+  before: z.string().trim().min(1).max(200).optional()
+});
+const aiChatMessageAppendSchema = messageBaseSchema;
+export {
+  aiChatConversationCreateSchema,
+  aiChatConversationImportSchema,
+  aiChatConversationListQuerySchema,
+  aiChatConversationTranscriptQuerySchema,
+  aiChatConversationUpdateSchema,
+  aiChatMessageAppendSchema,
+  aiChatPageContextSchema
+};
+//# sourceMappingURL=validators.js.map

package/dist/modules/ai_assistant/data/validators.js.map

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

package/dist/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/dist/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",