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

package/dist/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/dist/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/dist/modules/ai_assistant/lib/conversation-storage.js

@@ -0,0 +1,43 @@
+import {
+  AiChatConversationAccessError,
+  AiChatConversationRepository
+} from "../data/repositories/AiChatConversationRepository.js";
+function createConversationStorage(container) {
+  const em = container.resolve("em");
+  return new AiChatConversationRepository(em);
+}
+function serializeAiChatConversation(row) {
+  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
+  };
+}
+function serializeAiChatMessage(row) {
+  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()
+  };
+}
+export {
+  AiChatConversationAccessError,
+  createConversationStorage,
+  serializeAiChatConversation,
+  serializeAiChatMessage
+};
+//# sourceMappingURL=conversation-storage.js.map

package/dist/modules/ai_assistant/lib/conversation-storage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ai_assistant/lib/conversation-storage.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport {\n  AiChatConversation,\n  AiChatMessage,\n} from '../data/entities'\nimport {\n  AiChatConversationAccessError,\n  AiChatConversationRepository,\n  type AiChatConversationContext,\n} from '../data/repositories/AiChatConversationRepository'\n\n/**\n * Thin service-layer wrapper that resolves the entity manager from the\n * Awilix container and exposes a typed API on top of\n * `AiChatConversationRepository`. The REST routes for the conversation APIs\n * call into this surface; the future chat dispatcher write path will reuse\n * the same helpers so persistence stays consistent across entry points.\n *\n * Spec: `2026-05-05-ai-chat-server-side-conversation-storage` \u00A7\"Commands\".\n *\n * Re-exports the access error so route handlers can map it to a 404 without\n * importing the repository directly.\n */\nexport { AiChatConversationAccessError }\nexport type { AiChatConversationContext }\n\nexport function createConversationStorage(\n  container: AwilixContainer,\n): AiChatConversationRepository {\n  const em = container.resolve<EntityManager>('em')\n  return new AiChatConversationRepository(em)\n}\n\nexport interface SerializedAiChatConversation {\n  conversationId: string\n  agentId: string\n  title: string | null\n  status: 'open' | 'closed'\n  visibility: 'private' | 'shared' | 'organization'\n  pageContext: Record<string, unknown> | null\n  createdAt: string\n  updatedAt: string\n  lastMessageAt: string | null\n  importedFromLocalAt: string | null\n}\n\nexport interface SerializedAiChatMessage {\n  id: string\n  clientMessageId: string | null\n  role: 'user' | 'assistant' | 'system'\n  content: string\n  uiParts: unknown[]\n  attachmentIds: string[]\n  files: Array<Record<string, unknown>>\n  model: string | null\n  metadata: Record<string, unknown> | null\n  createdAt: string\n}\n\nexport function serializeAiChatConversation(\n  row: AiChatConversation,\n): SerializedAiChatConversation {\n  return {\n    conversationId: row.conversationId,\n    agentId: row.agentId,\n    title: row.title ?? null,\n    status: row.status,\n    visibility: row.visibility,\n    pageContext: row.pageContext ?? null,\n    createdAt: row.createdAt.toISOString(),\n    updatedAt: row.updatedAt.toISOString(),\n    lastMessageAt: row.lastMessageAt ? row.lastMessageAt.toISOString() : null,\n    importedFromLocalAt: row.importedFromLocalAt\n      ? row.importedFromLocalAt.toISOString()\n      : null,\n  }\n}\n\nexport function serializeAiChatMessage(row: AiChatMessage): SerializedAiChatMessage {\n  return {\n    id: row.id,\n    clientMessageId: row.clientMessageId ?? null,\n    role: row.role,\n    content: row.content,\n    uiParts: Array.isArray(row.uiParts) ? row.uiParts : [],\n    attachmentIds: Array.isArray(row.attachmentIds) ? row.attachmentIds : [],\n    files: Array.isArray(row.filesMetadata) ? row.filesMetadata : [],\n    model: row.model ?? null,\n    metadata: row.metadata ?? null,\n    createdAt: row.createdAt.toISOString(),\n  }\n}\n"],
+  "mappings": "AAMA;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAiBA,SAAS,0BACd,WAC8B;AAC9B,QAAM,KAAK,UAAU,QAAuB,IAAI;AAChD,SAAO,IAAI,6BAA6B,EAAE;AAC5C;AA4BO,SAAS,4BACd,KAC8B;AAC9B,SAAO;AAAA,IACL,gBAAgB,IAAI;AAAA,IACpB,SAAS,IAAI;AAAA,IACb,OAAO,IAAI,SAAS;AAAA,IACpB,QAAQ,IAAI;AAAA,IACZ,YAAY,IAAI;AAAA,IAChB,aAAa,IAAI,eAAe;AAAA,IAChC,WAAW,IAAI,UAAU,YAAY;AAAA,IACrC,WAAW,IAAI,UAAU,YAAY;AAAA,IACrC,eAAe,IAAI,gBAAgB,IAAI,cAAc,YAAY,IAAI;AAAA,IACrE,qBAAqB,IAAI,sBACrB,IAAI,oBAAoB,YAAY,IACpC;AAAA,EACN;AACF;AAEO,SAAS,uBAAuB,KAA6C;AAClF,SAAO;AAAA,IACL,IAAI,IAAI;AAAA,IACR,iBAAiB,IAAI,mBAAmB;AAAA,IACxC,MAAM,IAAI;AAAA,IACV,SAAS,IAAI;AAAA,IACb,SAAS,MAAM,QAAQ,IAAI,OAAO,IAAI,IAAI,UAAU,CAAC;AAAA,IACrD,eAAe,MAAM,QAAQ,IAAI,aAAa,IAAI,IAAI,gBAAgB,CAAC;AAAA,IACvE,OAAO,MAAM,QAAQ,IAAI,aAAa,IAAI,IAAI,gBAAgB,CAAC;AAAA,IAC/D,OAAO,IAAI,SAAS;AAAA,IACpB,UAAU,IAAI,YAAY;AAAA,IAC1B,WAAW,IAAI,UAAU,YAAY;AAAA,EACvC;AACF;",
+  "names": []
+}

package/dist/modules/ai_assistant/migrations/Migration20260518092853_ai_assistant.js

@@ -0,0 +1,28 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260518092853_ai_assistant extends Migration {
+  async up() {
+    this.addSql(`create table "ai_chat_conversations" ("id" uuid not null default gen_random_uuid(), "tenant_id" uuid not null, "organization_id" uuid null, "conversation_id" text not null, "agent_id" text not null, "owner_user_id" uuid not null, "title" text null, "status" text not null default 'open', "visibility" text not null default 'private', "page_context" jsonb null, "last_message_at" timestamptz null, "imported_from_local_at" timestamptz null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, primary key ("id"));`);
+    this.addSql(`create index "ai_chat_conversations_tenant_org_deleted_idx" on "ai_chat_conversations" ("tenant_id", "organization_id", "deleted_at");`);
+    this.addSql(`create index "ai_chat_conversations_tenant_org_owner_agent_idx" on "ai_chat_conversations" ("tenant_id", "organization_id", "owner_user_id", "agent_id", "status", "last_message_at");`);
+    this.addSql(`create unique index "ai_chat_conversations_tenant_conv_null_org_uq" on "ai_chat_conversations" ("tenant_id", "conversation_id") where "organization_id" is null and "deleted_at" is null;`);
+    this.addSql(`create unique index "ai_chat_conversations_tenant_org_conv_uq" on "ai_chat_conversations" ("tenant_id", "organization_id", "conversation_id") where "organization_id" is not null and "deleted_at" is null;`);
+    this.addSql(`create table "ai_chat_conversation_participants" ("id" uuid not null default gen_random_uuid(), "tenant_id" uuid not null, "organization_id" uuid null, "conversation_id" text not null, "user_id" uuid not null, "role" text not null default 'owner', "last_read_at" timestamptz null, "created_at" timestamptz not null, "updated_at" timestamptz not null, primary key ("id"));`);
+    this.addSql(`create index "ai_chat_conv_participants_tenant_org_user_conv_idx" on "ai_chat_conversation_participants" ("tenant_id", "organization_id", "user_id", "conversation_id");`);
+    this.addSql(`create unique index "ai_chat_conv_participants_tenant_conv_user_null_org_uq" on "ai_chat_conversation_participants" ("tenant_id", "conversation_id", "user_id") where "organization_id" is null;`);
+    this.addSql(`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;`);
+    this.addSql(`create table "ai_chat_messages" ("id" uuid not null default gen_random_uuid(), "tenant_id" uuid not null, "organization_id" uuid null, "conversation_id" text not null, "client_message_id" text null, "role" text not null, "content" text not null, "ui_parts" jsonb null, "attachment_ids" jsonb null, "files_metadata" jsonb null, "model" text null, "metadata" jsonb null, "created_by_user_id" uuid null, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, primary key ("id"));`);
+    this.addSql(`create index "ai_chat_messages_tenant_org_deleted_idx" on "ai_chat_messages" ("tenant_id", "organization_id", "deleted_at");`);
+    this.addSql(`create index "ai_chat_messages_tenant_org_conv_created_idx" on "ai_chat_messages" ("tenant_id", "organization_id", "conversation_id", "created_at");`);
+    this.addSql(`create unique index "ai_chat_messages_tenant_conv_client_id_null_org_uq" on "ai_chat_messages" ("tenant_id", "conversation_id", "client_message_id") where "organization_id" is null and "client_message_id" is not null and "deleted_at" is null;`);
+    this.addSql(`create unique index "ai_chat_messages_tenant_org_conv_client_id_uq" on "ai_chat_messages" ("tenant_id", "organization_id", "conversation_id", "client_message_id") where "organization_id" is not null and "client_message_id" is not null and "deleted_at" is null;`);
+  }
+  async down() {
+    this.addSql(`drop table if exists "ai_chat_messages" cascade;`);
+    this.addSql(`drop table if exists "ai_chat_conversation_participants" cascade;`);
+    this.addSql(`drop table if exists "ai_chat_conversations" cascade;`);
+  }
+}
+export {
+  Migration20260518092853_ai_assistant
+};
+//# sourceMappingURL=Migration20260518092853_ai_assistant.js.map

package/dist/modules/ai_assistant/migrations/Migration20260518092853_ai_assistant.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ai_assistant/migrations/Migration20260518092853_ai_assistant.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\n/**\n * Server-side AI chat conversation storage.\n *\n * Adds the three additive tables introduced by spec\n * `2026-05-05-ai-chat-server-side-conversation-storage`:\n * - `ai_chat_conversations`: durable session record per `(tenant, org, owner)`.\n * - `ai_chat_conversation_participants`: per-user membership, prepares for sharing.\n * - `ai_chat_messages`: append-only transcript with idempotent `client_message_id`.\n */\nexport class Migration20260518092853_ai_assistant extends Migration {\n\n  override async up(): Promise<void> {\n    this.addSql(`create table \"ai_chat_conversations\" (\"id\" uuid not null default gen_random_uuid(), \"tenant_id\" uuid not null, \"organization_id\" uuid null, \"conversation_id\" text not null, \"agent_id\" text not null, \"owner_user_id\" uuid not null, \"title\" text null, \"status\" text not null default 'open', \"visibility\" text not null default 'private', \"page_context\" jsonb null, \"last_message_at\" timestamptz null, \"imported_from_local_at\" timestamptz null, \"created_at\" timestamptz not null, \"updated_at\" timestamptz not null, \"deleted_at\" timestamptz null, primary key (\"id\"));`);\n    this.addSql(`create index \"ai_chat_conversations_tenant_org_deleted_idx\" on \"ai_chat_conversations\" (\"tenant_id\", \"organization_id\", \"deleted_at\");`);\n    this.addSql(`create index \"ai_chat_conversations_tenant_org_owner_agent_idx\" on \"ai_chat_conversations\" (\"tenant_id\", \"organization_id\", \"owner_user_id\", \"agent_id\", \"status\", \"last_message_at\");`);\n    this.addSql(`create unique index \"ai_chat_conversations_tenant_conv_null_org_uq\" on \"ai_chat_conversations\" (\"tenant_id\", \"conversation_id\") where \"organization_id\" is null and \"deleted_at\" is null;`);\n    this.addSql(`create unique index \"ai_chat_conversations_tenant_org_conv_uq\" on \"ai_chat_conversations\" (\"tenant_id\", \"organization_id\", \"conversation_id\") where \"organization_id\" is not null and \"deleted_at\" is null;`);\n\n    this.addSql(`create table \"ai_chat_conversation_participants\" (\"id\" uuid not null default gen_random_uuid(), \"tenant_id\" uuid not null, \"organization_id\" uuid null, \"conversation_id\" text not null, \"user_id\" uuid not null, \"role\" text not null default 'owner', \"last_read_at\" timestamptz null, \"created_at\" timestamptz not null, \"updated_at\" timestamptz not null, primary key (\"id\"));`);\n    this.addSql(`create index \"ai_chat_conv_participants_tenant_org_user_conv_idx\" on \"ai_chat_conversation_participants\" (\"tenant_id\", \"organization_id\", \"user_id\", \"conversation_id\");`);\n    this.addSql(`create unique index \"ai_chat_conv_participants_tenant_conv_user_null_org_uq\" on \"ai_chat_conversation_participants\" (\"tenant_id\", \"conversation_id\", \"user_id\") where \"organization_id\" is null;`);\n    this.addSql(`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;`);\n\n    this.addSql(`create table \"ai_chat_messages\" (\"id\" uuid not null default gen_random_uuid(), \"tenant_id\" uuid not null, \"organization_id\" uuid null, \"conversation_id\" text not null, \"client_message_id\" text null, \"role\" text not null, \"content\" text not null, \"ui_parts\" jsonb null, \"attachment_ids\" jsonb null, \"files_metadata\" jsonb null, \"model\" text null, \"metadata\" jsonb null, \"created_by_user_id\" uuid null, \"created_at\" timestamptz not null, \"updated_at\" timestamptz not null, \"deleted_at\" timestamptz null, primary key (\"id\"));`);\n    this.addSql(`create index \"ai_chat_messages_tenant_org_deleted_idx\" on \"ai_chat_messages\" (\"tenant_id\", \"organization_id\", \"deleted_at\");`);\n    this.addSql(`create index \"ai_chat_messages_tenant_org_conv_created_idx\" on \"ai_chat_messages\" (\"tenant_id\", \"organization_id\", \"conversation_id\", \"created_at\");`);\n    this.addSql(`create unique index \"ai_chat_messages_tenant_conv_client_id_null_org_uq\" on \"ai_chat_messages\" (\"tenant_id\", \"conversation_id\", \"client_message_id\") where \"organization_id\" is null and \"client_message_id\" is not null and \"deleted_at\" is null;`);\n    this.addSql(`create unique index \"ai_chat_messages_tenant_org_conv_client_id_uq\" on \"ai_chat_messages\" (\"tenant_id\", \"organization_id\", \"conversation_id\", \"client_message_id\") where \"organization_id\" is not null and \"client_message_id\" is not null and \"deleted_at\" is null;`);\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`drop table if exists \"ai_chat_messages\" cascade;`);\n    this.addSql(`drop table if exists \"ai_chat_conversation_participants\" cascade;`);\n    this.addSql(`drop table if exists \"ai_chat_conversations\" cascade;`);\n  }\n\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAWnB,MAAM,6CAA6C,UAAU;AAAA,EAElE,MAAe,KAAoB;AACjC,SAAK,OAAO,mjBAAmjB;AAC/jB,SAAK,OAAO,wIAAwI;AACpJ,SAAK,OAAO,wLAAwL;AACpM,SAAK,OAAO,2LAA2L;AACvM,SAAK,OAAO,6MAA6M;AAEzN,SAAK,OAAO,qXAAqX;AACjY,SAAK,OAAO,0KAA0K;AACtL,SAAK,OAAO,kMAAkM;AAC9M,SAAK,OAAO,oNAAoN;AAEhO,SAAK,OAAO,4gBAA4gB;AACxhB,SAAK,OAAO,8HAA8H;AAC1I,SAAK,OAAO,sJAAsJ;AAClK,SAAK,OAAO,oPAAoP;AAChQ,SAAK,OAAO,sQAAsQ;AAAA,EACpR;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,kDAAkD;AAC9D,SAAK,OAAO,mEAAmE;AAC/E,SAAK,OAAO,uDAAuD;AAAA,EACrE;AAEF;",
+  "names": []
+}

package/dist/modules/ai_assistant/setup.js

@@ -69,6 +69,7 @@ const setup = {
     admin: [
       "ai_assistant.view",
       "ai_assistant.settings.manage",
+      "ai_assistant.conversations.manage",
       "ai_assistant.mcp.serve",
       "ai_assistant.tools.list",
       "ai_assistant.mcp_servers.view",

package/dist/modules/ai_assistant/setup.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/modules/ai_assistant/setup.ts"],
-  "sourcesContent": ["import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'\n\nconst PENDING_ACTION_CLEANUP_SCHEDULE_ID = 'ai_assistant:pending-action-cleanup'\nconst TOKEN_USAGE_PRUNE_SCHEDULE_ID = 'ai_assistant:token-usage-prune'\n\n/**\n * System-scoped recurring schedule: every 5 minutes, enqueue a job to the\n * `ai-pending-action-cleanup` queue so the worker can sweep rows whose TTL\n * elapsed without any confirm/cancel activity (Step 5.12). The schedule id\n * is stable and `scheduler.register()` is an upsert, so calling this from\n * every tenant bootstrap stays idempotent.\n */\nasync function ensurePendingActionCleanupSchedule(\n  container: import('awilix').AwilixContainer | undefined,\n): Promise<void> {\n  if (!container) return\n  let schedulerService:\n    | {\n        register: (registration: Record<string, unknown>) => Promise<void>\n      }\n    | undefined\n  try {\n    schedulerService = container.resolve('schedulerService')\n  } catch {\n    schedulerService = undefined\n  }\n  if (!schedulerService) return\n  try {\n    await schedulerService.register({\n      id: PENDING_ACTION_CLEANUP_SCHEDULE_ID,\n      name: 'AI pending-action cleanup',\n      description:\n        'Sweep pending AI mutation approvals whose TTL elapsed without confirm/cancel and flip them to expired.',\n      scopeType: 'system',\n      scheduleType: 'interval',\n      scheduleValue: '5m',\n      timezone: 'UTC',\n      targetType: 'queue',\n      targetQueue: 'ai-pending-action-cleanup',\n      targetPayload: {},\n      sourceType: 'module',\n      sourceModule: 'ai_assistant',\n      isEnabled: true,\n    })\n  } catch (error) {\n    console.warn(\n      '[ai_assistant] Failed to register pending-action cleanup schedule:',\n      error instanceof Error ? error.message : error,\n    )\n  }\n}\n\n/**\n * System-scoped daily schedule: enqueue a job to the `ai-token-usage-prune`\n * queue to prune events older than the retention window and reconcile the\n * daily rollup session counts.\n *\n * Phase 6.4 of spec `2026-04-28-ai-agents-agentic-loop-controls`.\n */\nasync function ensureTokenUsagePruneSchedule(\n  container: import('awilix').AwilixContainer | undefined,\n): Promise<void> {\n  if (!container) return\n  let schedulerService:\n    | {\n        register: (registration: Record<string, unknown>) => Promise<void>\n      }\n    | undefined\n  try {\n    schedulerService = container.resolve('schedulerService')\n  } catch {\n    schedulerService = undefined\n  }\n  if (!schedulerService) return\n  try {\n    await schedulerService.register({\n      id: TOKEN_USAGE_PRUNE_SCHEDULE_ID,\n      name: 'AI token-usage prune',\n      description:\n        'Delete ai_token_usage_events rows older than AI_TOKEN_USAGE_EVENTS_RETENTION_DAYS (default 90) and reconcile session_count on the daily rollup.',\n      scopeType: 'system',\n      scheduleType: 'interval',\n      scheduleValue: '24h',\n      timezone: 'UTC',\n      targetType: 'queue',\n      targetQueue: 'ai-token-usage-prune',\n      targetPayload: {},\n      sourceType: 'module',\n      sourceModule: 'ai_assistant',\n      isEnabled: true,\n    })\n  } catch (error) {\n    console.warn(\n      '[ai_assistant] Failed to register token-usage prune schedule:',\n      error instanceof Error ? error.message : error,\n    )\n  }\n}\n\nexport const setup: ModuleSetupConfig = {\n  defaultRoleFeatures: {\n    admin: [\n      'ai_assistant.view',\n      'ai_assistant.settings.manage',\n      'ai_assistant.mcp.serve',\n      'ai_assistant.tools.list',\n      'ai_assistant.mcp_servers.view',\n      'ai_assistant.mcp_servers.manage',\n    ],\n    employee: ['ai_assistant.view'],\n  },\n\n  async seedDefaults({ container }) {\n    await ensurePendingActionCleanupSchedule(container)\n    await ensureTokenUsagePruneSchedule(container)\n  },\n}\n\nexport default setup\n"],
-  "mappings": "AAEA,MAAM,qCAAqC;AAC3C,MAAM,gCAAgC;AAStC,eAAe,mCACb,WACe;AACf,MAAI,CAAC,UAAW;AAChB,MAAI;AAKJ,MAAI;AACF,uBAAmB,UAAU,QAAQ,kBAAkB;AAAA,EACzD,QAAQ;AACN,uBAAmB;AAAA,EACrB;AACA,MAAI,CAAC,iBAAkB;AACvB,MAAI;AACF,UAAM,iBAAiB,SAAS;AAAA,MAC9B,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,aACE;AAAA,MACF,WAAW;AAAA,MACX,cAAc;AAAA,MACd,eAAe;AAAA,MACf,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,aAAa;AAAA,MACb,eAAe,CAAC;AAAA,MAChB,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,WAAW;AAAA,IACb,CAAC;AAAA,EACH,SAAS,OAAO;AACd,YAAQ;AAAA,MACN;AAAA,MACA,iBAAiB,QAAQ,MAAM,UAAU;AAAA,IAC3C;AAAA,EACF;AACF;AASA,eAAe,8BACb,WACe;AACf,MAAI,CAAC,UAAW;AAChB,MAAI;AAKJ,MAAI;AACF,uBAAmB,UAAU,QAAQ,kBAAkB;AAAA,EACzD,QAAQ;AACN,uBAAmB;AAAA,EACrB;AACA,MAAI,CAAC,iBAAkB;AACvB,MAAI;AACF,UAAM,iBAAiB,SAAS;AAAA,MAC9B,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,aACE;AAAA,MACF,WAAW;AAAA,MACX,cAAc;AAAA,MACd,eAAe;AAAA,MACf,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,aAAa;AAAA,MACb,eAAe,CAAC;AAAA,MAChB,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,WAAW;AAAA,IACb,CAAC;AAAA,EACH,SAAS,OAAO;AACd,YAAQ;AAAA,MACN;AAAA,MACA,iBAAiB,QAAQ,MAAM,UAAU;AAAA,IAC3C;AAAA,EACF;AACF;AAEO,MAAM,QAA2B;AAAA,EACtC,qBAAqB;AAAA,IACnB,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,UAAU,CAAC,mBAAmB;AAAA,EAChC;AAAA,EAEA,MAAM,aAAa,EAAE,UAAU,GAAG;AAChC,UAAM,mCAAmC,SAAS;AAClD,UAAM,8BAA8B,SAAS;AAAA,EAC/C;AACF;AAEA,IAAO,gBAAQ;",
+  "sourcesContent": ["import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'\n\nconst PENDING_ACTION_CLEANUP_SCHEDULE_ID = 'ai_assistant:pending-action-cleanup'\nconst TOKEN_USAGE_PRUNE_SCHEDULE_ID = 'ai_assistant:token-usage-prune'\n\n/**\n * System-scoped recurring schedule: every 5 minutes, enqueue a job to the\n * `ai-pending-action-cleanup` queue so the worker can sweep rows whose TTL\n * elapsed without any confirm/cancel activity (Step 5.12). The schedule id\n * is stable and `scheduler.register()` is an upsert, so calling this from\n * every tenant bootstrap stays idempotent.\n */\nasync function ensurePendingActionCleanupSchedule(\n  container: import('awilix').AwilixContainer | undefined,\n): Promise<void> {\n  if (!container) return\n  let schedulerService:\n    | {\n        register: (registration: Record<string, unknown>) => Promise<void>\n      }\n    | undefined\n  try {\n    schedulerService = container.resolve('schedulerService')\n  } catch {\n    schedulerService = undefined\n  }\n  if (!schedulerService) return\n  try {\n    await schedulerService.register({\n      id: PENDING_ACTION_CLEANUP_SCHEDULE_ID,\n      name: 'AI pending-action cleanup',\n      description:\n        'Sweep pending AI mutation approvals whose TTL elapsed without confirm/cancel and flip them to expired.',\n      scopeType: 'system',\n      scheduleType: 'interval',\n      scheduleValue: '5m',\n      timezone: 'UTC',\n      targetType: 'queue',\n      targetQueue: 'ai-pending-action-cleanup',\n      targetPayload: {},\n      sourceType: 'module',\n      sourceModule: 'ai_assistant',\n      isEnabled: true,\n    })\n  } catch (error) {\n    console.warn(\n      '[ai_assistant] Failed to register pending-action cleanup schedule:',\n      error instanceof Error ? error.message : error,\n    )\n  }\n}\n\n/**\n * System-scoped daily schedule: enqueue a job to the `ai-token-usage-prune`\n * queue to prune events older than the retention window and reconcile the\n * daily rollup session counts.\n *\n * Phase 6.4 of spec `2026-04-28-ai-agents-agentic-loop-controls`.\n */\nasync function ensureTokenUsagePruneSchedule(\n  container: import('awilix').AwilixContainer | undefined,\n): Promise<void> {\n  if (!container) return\n  let schedulerService:\n    | {\n        register: (registration: Record<string, unknown>) => Promise<void>\n      }\n    | undefined\n  try {\n    schedulerService = container.resolve('schedulerService')\n  } catch {\n    schedulerService = undefined\n  }\n  if (!schedulerService) return\n  try {\n    await schedulerService.register({\n      id: TOKEN_USAGE_PRUNE_SCHEDULE_ID,\n      name: 'AI token-usage prune',\n      description:\n        'Delete ai_token_usage_events rows older than AI_TOKEN_USAGE_EVENTS_RETENTION_DAYS (default 90) and reconcile session_count on the daily rollup.',\n      scopeType: 'system',\n      scheduleType: 'interval',\n      scheduleValue: '24h',\n      timezone: 'UTC',\n      targetType: 'queue',\n      targetQueue: 'ai-token-usage-prune',\n      targetPayload: {},\n      sourceType: 'module',\n      sourceModule: 'ai_assistant',\n      isEnabled: true,\n    })\n  } catch (error) {\n    console.warn(\n      '[ai_assistant] Failed to register token-usage prune schedule:',\n      error instanceof Error ? error.message : error,\n    )\n  }\n}\n\nexport const setup: ModuleSetupConfig = {\n  defaultRoleFeatures: {\n    admin: [\n      'ai_assistant.view',\n      'ai_assistant.settings.manage',\n      'ai_assistant.conversations.manage',\n      'ai_assistant.mcp.serve',\n      'ai_assistant.tools.list',\n      'ai_assistant.mcp_servers.view',\n      'ai_assistant.mcp_servers.manage',\n    ],\n    employee: ['ai_assistant.view'],\n  },\n\n  async seedDefaults({ container }) {\n    await ensurePendingActionCleanupSchedule(container)\n    await ensureTokenUsagePruneSchedule(container)\n  },\n}\n\nexport default setup\n"],
+  "mappings": "AAEA,MAAM,qCAAqC;AAC3C,MAAM,gCAAgC;AAStC,eAAe,mCACb,WACe;AACf,MAAI,CAAC,UAAW;AAChB,MAAI;AAKJ,MAAI;AACF,uBAAmB,UAAU,QAAQ,kBAAkB;AAAA,EACzD,QAAQ;AACN,uBAAmB;AAAA,EACrB;AACA,MAAI,CAAC,iBAAkB;AACvB,MAAI;AACF,UAAM,iBAAiB,SAAS;AAAA,MAC9B,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,aACE;AAAA,MACF,WAAW;AAAA,MACX,cAAc;AAAA,MACd,eAAe;AAAA,MACf,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,aAAa;AAAA,MACb,eAAe,CAAC;AAAA,MAChB,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,WAAW;AAAA,IACb,CAAC;AAAA,EACH,SAAS,OAAO;AACd,YAAQ;AAAA,MACN;AAAA,MACA,iBAAiB,QAAQ,MAAM,UAAU;AAAA,IAC3C;AAAA,EACF;AACF;AASA,eAAe,8BACb,WACe;AACf,MAAI,CAAC,UAAW;AAChB,MAAI;AAKJ,MAAI;AACF,uBAAmB,UAAU,QAAQ,kBAAkB;AAAA,EACzD,QAAQ;AACN,uBAAmB;AAAA,EACrB;AACA,MAAI,CAAC,iBAAkB;AACvB,MAAI;AACF,UAAM,iBAAiB,SAAS;AAAA,MAC9B,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,aACE;AAAA,MACF,WAAW;AAAA,MACX,cAAc;AAAA,MACd,eAAe;AAAA,MACf,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,aAAa;AAAA,MACb,eAAe,CAAC;AAAA,MAChB,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,WAAW;AAAA,IACb,CAAC;AAAA,EACH,SAAS,OAAO;AACd,YAAQ;AAAA,MACN;AAAA,MACA,iBAAiB,QAAQ,MAAM,UAAU;AAAA,IAC3C;AAAA,EACF;AACF;AAEO,MAAM,QAA2B;AAAA,EACtC,qBAAqB;AAAA,IACnB,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,UAAU,CAAC,mBAAmB;AAAA,EAChC;AAAA,EAEA,MAAM,aAAa,EAAE,UAAU,GAAG;AAChC,UAAM,mCAAmC,SAAS;AAClD,UAAM,8BAA8B,SAAS;AAAA,EAC/C;AACF;AAEA,IAAO,gBAAQ;",
   "names": []
 }

package/generated/entities/ai_chat_conversation/index.ts

@@ -0,0 +1,15 @@
+export const id = "id";
+export const tenant_id = "tenant_id";
+export const organization_id = "organization_id";
+export const conversation_id = "conversation_id";
+export const agent_id = "agent_id";
+export const owner_user_id = "owner_user_id";
+export const title = "title";
+export const status = "status";
+export const visibility = "visibility";
+export const page_context = "page_context";
+export const last_message_at = "last_message_at";
+export const imported_from_local_at = "imported_from_local_at";
+export const created_at = "created_at";
+export const updated_at = "updated_at";
+export const deleted_at = "deleted_at";

package/generated/entities/ai_chat_conversation_participant/index.ts

@@ -0,0 +1,9 @@
+export const id = "id";
+export const tenant_id = "tenant_id";
+export const organization_id = "organization_id";
+export const conversation_id = "conversation_id";
+export const user_id = "user_id";
+export const role = "role";
+export const last_read_at = "last_read_at";
+export const created_at = "created_at";
+export const updated_at = "updated_at";

package/generated/entities/ai_chat_message/index.ts

@@ -0,0 +1,16 @@
+export const id = "id";
+export const tenant_id = "tenant_id";
+export const organization_id = "organization_id";
+export const conversation_id = "conversation_id";
+export const client_message_id = "client_message_id";
+export const role = "role";
+export const content = "content";
+export const ui_parts = "ui_parts";
+export const attachment_ids = "attachment_ids";
+export const files_metadata = "files_metadata";
+export const model = "model";
+export const metadata = "metadata";
+export const created_by_user_id = "created_by_user_id";
+export const created_at = "created_at";
+export const updated_at = "updated_at";
+export const deleted_at = "deleted_at";

package/generated/entities.ids.generated.ts

@@ -9,7 +9,10 @@ export const M = {
       "ai_token_usage_event": "ai_assistant:ai_token_usage_event",
       "ai_token_usage_daily": "ai_assistant:ai_token_usage_daily",
       "ai_tenant_model_allowlist": "ai_assistant:ai_tenant_model_allowlist",
-      "ai_agent_mutation_policy_override": "ai_assistant:ai_agent_mutation_policy_override"
+      "ai_agent_mutation_policy_override": "ai_assistant:ai_agent_mutation_policy_override",
+      "ai_chat_conversation": "ai_assistant:ai_chat_conversation",
+      "ai_chat_conversation_participant": "ai_assistant:ai_chat_conversation_participant",
+      "ai_chat_message": "ai_assistant:ai_chat_message"
     }
   } as const;
 

package/generated/entity-fields-registry.ts

@@ -46,6 +46,52 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
       "loop_stop_when_json": "loop_stop_when_json",
       "loop_active_tools_json": "loop_active_tools_json"
     },
+    "ai_chat_conversation": {
+      "id": "id",
+      "tenant_id": "tenant_id",
+      "organization_id": "organization_id",
+      "conversation_id": "conversation_id",
+      "agent_id": "agent_id",
+      "owner_user_id": "owner_user_id",
+      "title": "title",
+      "status": "status",
+      "visibility": "visibility",
+      "page_context": "page_context",
+      "last_message_at": "last_message_at",
+      "imported_from_local_at": "imported_from_local_at",
+      "created_at": "created_at",
+      "updated_at": "updated_at",
+      "deleted_at": "deleted_at"
+    },
+    "ai_chat_conversation_participant": {
+      "id": "id",
+      "tenant_id": "tenant_id",
+      "organization_id": "organization_id",
+      "conversation_id": "conversation_id",
+      "user_id": "user_id",
+      "role": "role",
+      "last_read_at": "last_read_at",
+      "created_at": "created_at",
+      "updated_at": "updated_at"
+    },
+    "ai_chat_message": {
+      "id": "id",
+      "tenant_id": "tenant_id",
+      "organization_id": "organization_id",
+      "conversation_id": "conversation_id",
+      "client_message_id": "client_message_id",
+      "role": "role",
+      "content": "content",
+      "ui_parts": "ui_parts",
+      "attachment_ids": "attachment_ids",
+      "files_metadata": "files_metadata",
+      "model": "model",
+      "metadata": "metadata",
+      "created_by_user_id": "created_by_user_id",
+      "created_at": "created_at",
+      "updated_at": "updated_at",
+      "deleted_at": "deleted_at"
+    },
     "ai_pending_action": {
       "id": "id",
       "tenant_id": "tenant_id",

package/jest.config.cjs

@@ -23,12 +23,14 @@ module.exports = {
       {
         tsconfig: {
           jsx: 'react-jsx',
+          rootDir: '.',
+          ignoreDeprecations: '6.0',
         },
       },
     ],
   },
   transformIgnorePatterns: [
-    'node_modules/(?!(@mikro-orm)/)',
+    'node_modules/(?!(@mikro-orm|kysely)/)',
   ],
   testMatch: ['<rootDir>/src/**/__tests__/**/*.test.(ts|tsx)'],
   passWithNoTests: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/ai-assistant",
-  "version": "0.6.2-develop.3461.1.605f31c2c9",
+  "version": "0.6.2",
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -85,35 +85,35 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "^3.0.76",
-    "@ai-sdk/google": "^3.0.71",
-    "@ai-sdk/openai": "^3.0.63",
+    "@ai-sdk/anthropic": "^3.0.78",
+    "@ai-sdk/google": "^3.0.75",
+    "@ai-sdk/openai": "^3.0.64",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "ai": "^6.0.177",
+    "ai": "^6.0.185",
     "cmdk": "^1.0.0",
-    "framer-motion": "^12.38.0",
+    "framer-motion": "^12.39.0",
     "isolated-vm": "^6.1.2",
     "react-json-view-lite": "^2.5.0",
     "react-markdown": "^10.1.0",
     "zod-to-json-schema": "^3.25.2"
   },
   "peerDependencies": {
-    "@open-mercato/shared": "0.6.2-develop.3461.1.605f31c2c9",
-    "@open-mercato/ui": "0.6.2-develop.3461.1.605f31c2c9",
+    "@open-mercato/shared": "0.6.2",
+    "@open-mercato/ui": "0.6.2",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "zod": ">=3.23.0"
   },
   "devDependencies": {
-    "@open-mercato/cli": "0.6.2-develop.3461.1.605f31c2c9",
-    "@open-mercato/shared": "0.6.2-develop.3461.1.605f31c2c9",
-    "@open-mercato/ui": "0.6.2-develop.3461.1.605f31c2c9",
+    "@open-mercato/cli": "0.6.2",
+    "@open-mercato/shared": "0.6.2",
+    "@open-mercato/ui": "0.6.2",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "react": "19.2.6",
     "react-dom": "19.2.6",
-    "tsx": "^4.21.0",
-    "zod": "^4.3.6"
+    "tsx": "^4.22.2",
+    "zod": "^4.4.3"
   },
   "publishConfig": {
     "access": "public"
@@ -122,6 +122,5 @@
     "type": "git",
     "url": "https://github.com/open-mercato/open-mercato",
     "directory": "packages/ai-assistant"
-  },
-  "stableVersion": "0.6.1"
+  }
 }

package/src/modules/ai_assistant/acl.ts

@@ -1,6 +1,7 @@
 export const features = [
   { id: 'ai_assistant.view', title: 'View AI Assistant Settings', module: 'ai_assistant' },
   { id: 'ai_assistant.settings.manage', title: 'Manage AI Assistant Settings', module: 'ai_assistant' },
+  { id: 'ai_assistant.conversations.manage', title: 'Manage AI Assistant Conversations', module: 'ai_assistant' },
   { id: 'ai_assistant.mcp.serve', title: 'Start MCP Server', module: 'ai_assistant' },
   { id: 'ai_assistant.tools.list', title: 'List MCP Tools', module: 'ai_assistant' },
   { id: 'ai_assistant.mcp_servers.view', title: 'View MCP Server Configurations', module: 'ai_assistant' },

package/src/modules/ai_assistant/api/ai/chat/__tests__/route.test.ts

@@ -11,6 +11,8 @@ const authMock = jest.fn()
 const loadAclMock = jest.fn()
 const createRequestContainerMock = jest.fn()
 const runAiAgentTextMock = jest.fn()
+const createOrGetConversationMock = jest.fn()
+const appendConversationMessageMock = jest.fn()
 
 jest.mock('@open-mercato/shared/lib/auth/server', () => ({
   getAuthFromRequest: (...args: unknown[]) => authMock(...args),
@@ -28,6 +30,13 @@ jest.mock('../../../../lib/agent-runtime', () => {
   }
 })
 
+jest.mock('../../../../lib/conversation-storage', () => ({
+  createConversationStorage: jest.fn(() => ({
+    createOrGet: (...args: unknown[]) => createOrGetConversationMock(...args),
+    appendMessage: (...args: unknown[]) => appendConversationMessageMock(...args),
+  })),
+}))
+
 const getMock = jest.fn()
 const listMock = jest.fn()
 
@@ -128,6 +137,8 @@ describe('POST /api/ai/chat', () => {
     })
     tenantAllowlistGetSnapshotMock.mockResolvedValue(null)
     agentRuntimeOverrideGetExactMock.mockResolvedValue(null)
+    createOrGetConversationMock.mockResolvedValue({})
+    appendConversationMessageMock.mockResolvedValue({})
     runAiAgentTextMock.mockResolvedValue(
       new Response('data: {"type":"text","content":"ok"}\n\ndata: [DONE]\n\n', {
         status: 200,
@@ -304,6 +315,102 @@ describe('POST /api/ai/chat', () => {
     expect(callArg.container).toBeDefined()
   })
 
+  it('persists the user message before dispatch and the assistant message after the stream finishes', async () => {
+    seedAgentRegistryForTests([
+      makeAgent({
+        id: 'customers.assistant',
+        moduleId: 'customers',
+      }),
+    ])
+    runAiAgentTextMock.mockResolvedValueOnce(
+      new Response(
+        [
+          'data: {"type":"text-delta","delta":"Hello"}\n\n',
+          'data: {"type":"text-delta","delta":" world"}\n\n',
+          'data: [DONE]\n\n',
+        ].join(''),
+        {
+          status: 200,
+          headers: { 'Content-Type': 'text/event-stream' },
+        },
+      ),
+    )
+
+    const response = await POST(
+      buildRequest({
+        agent: 'customers.assistant',
+        body: {
+          conversationId: 'conv-persist-1',
+          attachmentIds: ['att-image-1'],
+          messages: [
+            {
+              id: 'msg-user-1',
+              role: 'user',
+              content: 'Hello assistant',
+              files: [
+                {
+                  id: 'att-image-1',
+                  name: 'IMG_5328.JPEG',
+                  type: 'image/jpeg',
+                },
+              ],
+            },
+          ],
+        },
+      }) as any,
+    )
+    await response.text()
+
+    expect(createOrGetConversationMock).toHaveBeenCalledWith(
+      {
+        conversationId: 'conv-persist-1',
+        agentId: 'customers.assistant',
+        pageContext: null,
+      },
+      {
+        tenantId: 'tenant-1',
+        organizationId: 'org-1',
+        userId: 'user-1',
+      },
+    )
+    expect(appendConversationMessageMock).toHaveBeenNthCalledWith(
+      1,
+      'conv-persist-1',
+      expect.objectContaining({
+        clientMessageId: 'msg-user-1',
+        role: 'user',
+        content: 'Hello assistant',
+        attachmentIds: ['att-image-1'],
+        files: [
+          {
+            id: 'att-image-1',
+            name: 'IMG_5328.JPEG',
+            mimeType: 'image/jpeg',
+          },
+        ],
+      }),
+      expect.objectContaining({
+        tenantId: 'tenant-1',
+        organizationId: 'org-1',
+        userId: 'user-1',
+      }),
+    )
+    expect(appendConversationMessageMock).toHaveBeenNthCalledWith(
+      2,
+      'conv-persist-1',
+      expect.objectContaining({
+        clientMessageId: 'msg-user-1:assistant',
+        role: 'assistant',
+        content: 'Hello world',
+      }),
+      expect.objectContaining({
+        tenantId: 'tenant-1',
+        organizationId: 'org-1',
+        userId: 'user-1',
+      }),
+    )
+  })
+
   it('maps AgentPolicyError thrown by the runtime to the canonical HTTP status', async () => {
     const { AgentPolicyError } = await import('../../../../lib/agent-tools')
     seedAgentRegistryForTests([