portal-aiatende-api 0.7.0 → 0.9.0

package/dist/index.d.mts

@@ -389,6 +389,14 @@ interface MessagingConversation {
     handoffReason?: string | null;
     handoffSetAt?: Date | string | null;
     handoffSetByName?: string | null;
+    /**
+     * "Reiniciar atendimento" — não apaga nenhuma Message (continuam visíveis na conversa pro
+     * humano), só marca um corte no tempo: mensagens com `createdAt` <= este timestamp devem ser
+     * excluídas do contexto montado pro modelo (ver Conversation.aiHistoryResetAt no Portal e
+     * aiatendeWaQueue.ts, canal aiatendeWa). `null` = nunca reiniciado, nada é filtrado.
+     */
+    aiHistoryResetAt?: Date | string | null;
+    aiHistoryResetByName?: string | null;
     /**
      * Lead da Kommo dono desse mesmo número de telefone — hoje toda a movimentação/tools da IA
      * (agendamento, mover pipeline, etc.) opera em cima de um lead_id da Kommo; este canal não tem
@@ -478,6 +486,12 @@ interface PatchConversationPayload {
      * auto-atribuir a conversa por round-robin (ver MessagingConfig.assignmentMode).
      */
     handoffReason?: string;
+    /**
+     * true reinicia a "memória" da IA — não apaga nenhuma Message, só grava
+     * `aiHistoryResetAt = agora()`. Sempre "agora" (nunca um timestamp escolhido pelo chamador,
+     * evita divergência de relógio cliente/servidor).
+     */
+    resetAiHistory?: boolean;
 }
 /**
  * `actor` só é respeitado pelo Portal quando o chamador é um papel de sistema/staff (ex.: o
@@ -655,6 +669,11 @@ interface UpdateContactPayload {
      * chaves sem definição são preservadas sem validação.
      */
     customFields?: Record<string, unknown>;
+    /**
+     * Vínculo com o lead da Kommo — fonte única de verdade (ver Contact.kommoLeadId no Portal).
+     * `null` limpa o vínculo (ex.: self-healing após 404 da Kommo).
+     */
+    kommoLeadId?: number | null;
 }
 
 /**

package/dist/index.d.ts

@@ -389,6 +389,14 @@ interface MessagingConversation {
     handoffReason?: string | null;
     handoffSetAt?: Date | string | null;
     handoffSetByName?: string | null;
+    /**
+     * "Reiniciar atendimento" — não apaga nenhuma Message (continuam visíveis na conversa pro
+     * humano), só marca um corte no tempo: mensagens com `createdAt` <= este timestamp devem ser
+     * excluídas do contexto montado pro modelo (ver Conversation.aiHistoryResetAt no Portal e
+     * aiatendeWaQueue.ts, canal aiatendeWa). `null` = nunca reiniciado, nada é filtrado.
+     */
+    aiHistoryResetAt?: Date | string | null;
+    aiHistoryResetByName?: string | null;
     /**
      * Lead da Kommo dono desse mesmo número de telefone — hoje toda a movimentação/tools da IA
      * (agendamento, mover pipeline, etc.) opera em cima de um lead_id da Kommo; este canal não tem
@@ -478,6 +486,12 @@ interface PatchConversationPayload {
      * auto-atribuir a conversa por round-robin (ver MessagingConfig.assignmentMode).
      */
     handoffReason?: string;
+    /**
+     * true reinicia a "memória" da IA — não apaga nenhuma Message, só grava
+     * `aiHistoryResetAt = agora()`. Sempre "agora" (nunca um timestamp escolhido pelo chamador,
+     * evita divergência de relógio cliente/servidor).
+     */
+    resetAiHistory?: boolean;
 }
 /**
  * `actor` só é respeitado pelo Portal quando o chamador é um papel de sistema/staff (ex.: o
@@ -655,6 +669,11 @@ interface UpdateContactPayload {
      * chaves sem definição são preservadas sem validação.
      */
     customFields?: Record<string, unknown>;
+    /**
+     * Vínculo com o lead da Kommo — fonte única de verdade (ver Contact.kommoLeadId no Portal).
+     * `null` limpa o vínculo (ex.: self-healing após 404 da Kommo).
+     */
+    kommoLeadId?: number | null;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portal-aiatende-api",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Cliente TypeScript tipado para a API interna do Portal AI Atende.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",