@wrcb/cb-common 1.0.887 → 1.0.889

package/build/types/crm.d.ts

@@ -96,11 +96,49 @@ export interface CrmAgentToolCall {
 }
 export interface CrmGuardrails {
     forbiddenTopics: string[];
-    blockUnsourcedRates: boolean;
-    handoffOnSensitiveData: boolean;
+    /**
+     * Assuntos que o agente só pode citar se tiver consultado o material de
+     * apoio. Um por linha, em linguagem natural: "taxa", "juros", "prazo de
+     * entrega", "tempo de recuperação".
+     *
+     * SUBSTITUIU o antigo `blockUnsourcedRates`, que era um sim/não com os
+     * padrões de taxa e juros fixos no código. Servia a um ramo só: um salão
+     * não tem taxa, mas tem prazo; uma clínica não tem juros, mas tem tempo de
+     * recuperação. Lista vazia = trava desligada.
+     */
+    sourcedTopics: string[];
+    /**
+     * Proibir o agente de afirmar que algo foi aprovado, garantido ou liberado.
+     *
+     * Nasceu de crédito, onde prometer aprovação é problema jurídico. É regra
+     * de NEGÓCIO, não do produto — uma imobiliária quer isto ligado, uma
+     * oficina que aprova orçamento na hora, não.
+     */
+    blockApprovalPromise: boolean;
     mandatoryDisclaimer: string | null;
     maxAiTurnsBeforeHandoff: number | null;
 }
+/**
+ * NÃO SÃO CONFIGURÁVEIS, de propósito — e vale registrar por quê, porque a
+ * pergunta volta:
+ *
+ * - PEDIR SENHA, CVV, NÚMERO DE CARTÃO OU TOKEN DE BANCO. Não é regra de
+ *   ramo, é antifraude. Agente que pede isso está alucinando ou foi
+ *   comprometido, e não existe negócio em que seja aceitável. Um interruptor
+ *   aqui só serviria para alguém se machucar.
+ *
+ * - ENCENAR ESPERA ("um momento", "já te respondo"). Não é regra de ramo, é
+ *   fato do runtime: a resposta é gerada inteira de uma vez e o agente não
+ *   tem um segundo turno para voltar sozinho. O divisor de mensagens ainda
+ *   entrega em partes espaçadas, o que dá aparência de tempo decorrido. A
+ *   frase é mentira em qualquer ramo, e deixa o lead esperando algo que
+ *   nunca foi agendado.
+ *
+ * - AFIRMAR QUE RECEBEU OU CONFERIU DOCUMENTO. Esta é condicional por
+ *   construção, não por configuração: só vale quando a conta tem checklist.
+ *   Sem documentos configurados o agente nem recebe a ferramenta, e não há
+ *   afirmação a policiar.
+ */
 export declare enum CrmKnowledgeStatus {
     Uploaded = "Uploaded",
     Processing = "Processing",
@@ -140,7 +178,15 @@ export declare enum CrmDocumentRejectionReason {
     SuspectedTampering = "SuspectedTampering"
 }
 export interface CrmCadenceStep {
-    afterHours: number;
+    /**
+     * Minutos após a última interação para disparar este passo.
+     *
+     * ERA `afterHours`, e hora era a menor unidade possível. Follow-up de
+     * poucos minutos é justamente o mais útil logo depois de um primeiro
+     * contato — quem pediu orçamento e não respondeu em 10 minutos ainda está
+     * com o assunto na cabeça; em 1 hora, já não está.
+     */
+    afterMinutes: number;
     stageKeys: string[];
     template: string | null;
     aiInstruction: string | null;
@@ -229,4 +275,15 @@ export interface CrmPublicPersona {
     agentId: string;
     name: string;
     publicTag: string | null;
+    /**
+     * A linha curta do card: idade, cidade, o que quiser. Texto livre, escrito
+     * no painel.
+     *
+     * Está aqui e não no site pela mesma razão do `name`: trocar a descrição de
+     * uma persona não pode exigir deploy. E NÃO é o `systemPrompt` — este é
+     * para o visitante ler, aquele é a receita do negócio e nunca sai do CRM.
+     */
+    publicHeadline: string | null;
+    /** Duas ou três frases, para o mesmo card. */
+    publicBio: string | null;
 }

package/build/types/crm.js

@@ -159,6 +159,27 @@ var CrmAgentTool;
     // Devolve a conversa para um humano.
     CrmAgentTool["RequestHuman"] = "RequestHuman";
 })(CrmAgentTool || (exports.CrmAgentTool = CrmAgentTool = {}));
+/**
+ * NÃO SÃO CONFIGURÁVEIS, de propósito — e vale registrar por quê, porque a
+ * pergunta volta:
+ *
+ * - PEDIR SENHA, CVV, NÚMERO DE CARTÃO OU TOKEN DE BANCO. Não é regra de
+ *   ramo, é antifraude. Agente que pede isso está alucinando ou foi
+ *   comprometido, e não existe negócio em que seja aceitável. Um interruptor
+ *   aqui só serviria para alguém se machucar.
+ *
+ * - ENCENAR ESPERA ("um momento", "já te respondo"). Não é regra de ramo, é
+ *   fato do runtime: a resposta é gerada inteira de uma vez e o agente não
+ *   tem um segundo turno para voltar sozinho. O divisor de mensagens ainda
+ *   entrega em partes espaçadas, o que dá aparência de tempo decorrido. A
+ *   frase é mentira em qualquer ramo, e deixa o lead esperando algo que
+ *   nunca foi agendado.
+ *
+ * - AFIRMAR QUE RECEBEU OU CONFERIU DOCUMENTO. Esta é condicional por
+ *   construção, não por configuração: só vale quando a conta tem checklist.
+ *   Sem documentos configurados o agente nem recebe a ferramenta, e não há
+ *   afirmação a policiar.
+ */
 // ============================================
 // BASE DE CONHECIMENTO (RAG)
 // ============================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrcb/cb-common",
-  "version": "1.0.887",
+  "version": "1.0.889",
   "description": "Common resources between services",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",