portal-aiatende-api 0.6.0 → 0.8.0

package/dist/index.d.mts

@@ -379,6 +379,16 @@ interface MessagingConversation {
     aiCareStatusSetByName: string | null;
     /** Só presente na resposta do GET de detalhe (não na listagem). */
     aiResumeMode?: AiResumeMode | null;
+    /**
+     * Resumo + motivo do último handoff (IA -> humano) — guardam só a transferência mais recente,
+     * sem histórico (uma nova transferência sobrescreve). `summary` é congelado no momento do
+     * handoff (não atualizado a cada resposta da IA). Ver Conversation.summary/handoffReason em
+     * prisma/schema.prisma do Portal.
+     */
+    summary?: string | null;
+    handoffReason?: string | null;
+    handoffSetAt?: Date | string | null;
+    handoffSetByName?: 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
@@ -456,6 +466,18 @@ interface PatchConversationPayload {
     kommoLeadId?: number | null;
     /** Status de triagem, puramente organizacional (não bloqueia envio/recebimento). Reabre sozinho ('open') com qualquer mensagem inbound nova. */
     status?: 'open' | 'closed';
+    /**
+     * Resumo da conversa, congelado no momento do handoff — reaproveita o `resumo_conversa` que
+     * as tools de handoff já pedem ao modelo hoje. Não é recalculado a cada resposta da IA.
+     */
+    summary?: string;
+    /**
+     * Motivo do handoff/perda — texto livre de propósito (sem lista fechada de opções no Portal:
+     * um valor nunca visto antes é aceito e passa a aparecer nas sugestões da UI sozinho). Quando
+     * enviado junto com `aiCareStatus: 'INACTIVE'` sem `assignedToId` explícito, o Portal pode
+     * auto-atribuir a conversa por round-robin (ver MessagingConfig.assignmentMode).
+     */
+    handoffReason?: string;
 }
 /**
  * `actor` só é respeitado pelo Portal quando o chamador é um papel de sistema/staff (ex.: o
@@ -633,6 +655,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

@@ -379,6 +379,16 @@ interface MessagingConversation {
     aiCareStatusSetByName: string | null;
     /** Só presente na resposta do GET de detalhe (não na listagem). */
     aiResumeMode?: AiResumeMode | null;
+    /**
+     * Resumo + motivo do último handoff (IA -> humano) — guardam só a transferência mais recente,
+     * sem histórico (uma nova transferência sobrescreve). `summary` é congelado no momento do
+     * handoff (não atualizado a cada resposta da IA). Ver Conversation.summary/handoffReason em
+     * prisma/schema.prisma do Portal.
+     */
+    summary?: string | null;
+    handoffReason?: string | null;
+    handoffSetAt?: Date | string | null;
+    handoffSetByName?: 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
@@ -456,6 +466,18 @@ interface PatchConversationPayload {
     kommoLeadId?: number | null;
     /** Status de triagem, puramente organizacional (não bloqueia envio/recebimento). Reabre sozinho ('open') com qualquer mensagem inbound nova. */
     status?: 'open' | 'closed';
+    /**
+     * Resumo da conversa, congelado no momento do handoff — reaproveita o `resumo_conversa` que
+     * as tools de handoff já pedem ao modelo hoje. Não é recalculado a cada resposta da IA.
+     */
+    summary?: string;
+    /**
+     * Motivo do handoff/perda — texto livre de propósito (sem lista fechada de opções no Portal:
+     * um valor nunca visto antes é aceito e passa a aparecer nas sugestões da UI sozinho). Quando
+     * enviado junto com `aiCareStatus: 'INACTIVE'` sem `assignedToId` explícito, o Portal pode
+     * auto-atribuir a conversa por round-robin (ver MessagingConfig.assignmentMode).
+     */
+    handoffReason?: string;
 }
 /**
  * `actor` só é respeitado pelo Portal quando o chamador é um papel de sistema/staff (ex.: o
@@ -633,6 +655,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.6.0",
+  "version": "0.8.0",
   "description": "Cliente TypeScript tipado para a API interna do Portal AI Atende.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",