@wrcb/cb-common 1.0.877 → 1.0.879

package/build/events/ai/aiRequestMadeEvent.d.ts

@@ -1,6 +1,6 @@
 import { Subjects } from '../subjects';
 export type AIProvider = 'openai' | 'cerebras';
-export type AIRequestType = 'chat' | 'tts' | 'transcribe' | 'image-generate' | 'image-edit';
+export type AIRequestType = 'chat' | 'tts' | 'transcribe' | 'image-generate' | 'image-edit' | 'embeddings';
 export interface AIRequestMadeEvent {
     subject: Subjects.AIRequestMade;
     data: {

package/build/index.d.ts

@@ -56,6 +56,7 @@ export * from './types/betOutcome';
 export * from './types/betStatus';
 export * from './types/predictionType';
 export * from './types/trabalhoHomeOffice';
+export * from './types/crm';
 export * from './events/subjects';
 export * from './events/baseListener';
 export * from './events/basePublisher';

package/build/index.js

@@ -83,6 +83,8 @@ __exportStar(require("./types/betStatus"), exports);
 __exportStar(require("./types/predictionType"), exports);
 // trabalho-home-office
 __exportStar(require("./types/trabalhoHomeOffice"), exports);
+// crm — núcleo multi-tenant (pipeline configurável + agente de IA)
+__exportStar(require("./types/crm"), exports);
 __exportStar(require("./events/subjects"), exports);
 __exportStar(require("./events/baseListener"), exports);
 __exportStar(require("./events/basePublisher"), exports);

package/build/services/WasabiUploader.d.ts

@@ -1,3 +1,11 @@
+export type WasabiAcl = 'public-read' | 'private';
+export interface WasabiCredentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+    bucketName: string;
+    region?: string;
+    endpoint?: string;
+}
 export interface UploadToWasabiParams {
     fileBuffer: Buffer;
     originalName: string;
@@ -10,5 +18,47 @@ export interface UploadToWasabiParams {
     contentType?: string;
     extension?: string;
     cacheControl?: string;
+    acl?: WasabiAcl;
+}
+export interface WasabiObject {
+    key: string;
+    bucket: string;
+    url: string | null;
+    contentType: string;
+    sizeBytes: number;
+}
+/**
+ * Sobe um arquivo e devolve o objeto completo (chave, bucket, tamanho).
+ *
+ * Prefira esta função a `uploadToWasabi` em código novo: ela devolve a chave,
+ * que é o que permite assinar URL, apagar e aplicar retenção depois.
+ */
+export declare function uploadFileToWasabi({ fileBuffer, originalName, accessKeyId, secretAccessKey, bucketName, region, endpoint, folder, contentType: contentTypeOverride, extension: extensionOverride, cacheControl, acl }: UploadToWasabiParams): Promise<WasabiObject>;
+/**
+ * Assinatura histórica: sobe público e devolve só a URL.
+ *
+ * Mantida para não quebrar os serviços que já a usam. Em código novo use
+ * `uploadFileToWasabi`, e para dado pessoal use-a com `acl: 'private'`.
+ */
+export declare function uploadToWasabi(params: UploadToWasabiParams): Promise<string>;
+export interface SignedUrlParams extends WasabiCredentials {
+    key: string;
+    expiresInSeconds?: number;
+    downloadFileName?: string;
+}
+/**
+ * Gera uma URL temporária de leitura para um objeto privado.
+ *
+ * É assim que a foto de documento chega ao painel: o operador abre o lead, o
+ * backend assina na hora, o link morre em minutos.
+ */
+export declare function getWasabiSignedUrl({ key, expiresInSeconds, downloadFileName, ...credentials }: SignedUrlParams): Promise<string>;
+export interface DeleteFromWasabiParams extends WasabiCredentials {
+    key: string;
 }
-export declare function uploadToWasabi({ fileBuffer, originalName, accessKeyId, secretAccessKey, bucketName, region, endpoint, folder, contentType: contentTypeOverride, extension: extensionOverride, cacheControl }: UploadToWasabiParams): Promise<string>;
+/**
+ * Apaga um objeto. Usado pelo expurgo por retenção (LGPD): o arquivo some, o
+ * registro no banco fica marcado como expurgado para a auditoria continuar
+ * rastreável.
+ */
+export declare function deleteFromWasabi({ key, ...credentials }: DeleteFromWasabiParams): Promise<void>;

package/build/services/WasabiUploader.js

@@ -8,31 +8,113 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadFileToWasabi = uploadFileToWasabi;
 exports.uploadToWasabi = uploadToWasabi;
+exports.getWasabiSignedUrl = getWasabiSignedUrl;
+exports.deleteFromWasabi = deleteFromWasabi;
 // cb-common/server/services/wasabiUploader.ts
 const client_s3_1 = require("@aws-sdk/client-s3");
+const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
 const uuid_1 = require("uuid");
 const mime_types_1 = __importDefault(require("mime-types"));
-function uploadToWasabi(_a) {
-    return __awaiter(this, arguments, void 0, function* ({ fileBuffer, originalName, accessKeyId, secretAccessKey, bucketName, region = 'us-east-1', endpoint = 'https://s3.us-east-1.wasabisys.com', folder = 'uploads', contentType: contentTypeOverride, extension: extensionOverride, cacheControl }) {
+const DEFAULT_REGION = 'us-east-1';
+const DEFAULT_ENDPOINT = 'https://s3.us-east-1.wasabisys.com';
+function buildClient({ accessKeyId, secretAccessKey, region = DEFAULT_REGION, endpoint = DEFAULT_ENDPOINT }) {
+    return new client_s3_1.S3Client({
+        region,
+        endpoint,
+        forcePathStyle: true,
+        credentials: { accessKeyId, secretAccessKey }
+    });
+}
+/**
+ * Sobe um arquivo e devolve o objeto completo (chave, bucket, tamanho).
+ *
+ * Prefira esta função a `uploadToWasabi` em código novo: ela devolve a chave,
+ * que é o que permite assinar URL, apagar e aplicar retenção depois.
+ */
+function uploadFileToWasabi(_a) {
+    return __awaiter(this, arguments, void 0, function* ({ fileBuffer, originalName, accessKeyId, secretAccessKey, bucketName, region = DEFAULT_REGION, endpoint = DEFAULT_ENDPOINT, folder = 'uploads', contentType: contentTypeOverride, extension: extensionOverride, cacheControl, acl = 'public-read' }) {
         const extension = extensionOverride || originalName.split('.').pop() || 'jpg';
         const contentType = contentTypeOverride || mime_types_1.default.lookup(extension) || 'application/octet-stream';
-        const filename = `${folder}/${(0, uuid_1.v4)()}.${extension}`;
-        const wasabiClient = new client_s3_1.S3Client({
+        const key = `${folder}/${(0, uuid_1.v4)()}.${extension}`;
+        const wasabiClient = buildClient({
+            accessKeyId,
+            secretAccessKey,
+            bucketName,
             region,
-            endpoint,
-            forcePathStyle: true,
-            credentials: {
-                accessKeyId,
-                secretAccessKey
-            }
+            endpoint
         });
-        const params = Object.assign({ Bucket: bucketName, Key: filename, Body: fileBuffer, ContentType: contentType, ACL: 'public-read' }, (cacheControl ? { CacheControl: cacheControl } : {}));
+        const params = Object.assign({ Bucket: bucketName, Key: key, Body: fileBuffer, ContentType: contentType, ACL: acl }, (cacheControl ? { CacheControl: cacheControl } : {}));
         yield wasabiClient.send(new client_s3_1.PutObjectCommand(params));
-        return `${endpoint.replace(/\/$/, '')}/${bucketName}/${filename}`;
+        return {
+            key,
+            bucket: bucketName,
+            url: acl === 'public-read'
+                ? `${endpoint.replace(/\/$/, '')}/${bucketName}/${key}`
+                : null,
+            contentType,
+            sizeBytes: fileBuffer.length
+        };
+    });
+}
+/**
+ * Assinatura histórica: sobe público e devolve só a URL.
+ *
+ * Mantida para não quebrar os serviços que já a usam. Em código novo use
+ * `uploadFileToWasabi`, e para dado pessoal use-a com `acl: 'private'`.
+ */
+function uploadToWasabi(params) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const object = yield uploadFileToWasabi(params);
+        if (!object.url) {
+            throw new Error('uploadToWasabi: objeto privado não tem URL pública — use uploadFileToWasabi + getWasabiSignedUrl');
+        }
+        return object.url;
+    });
+}
+/**
+ * Gera uma URL temporária de leitura para um objeto privado.
+ *
+ * É assim que a foto de documento chega ao painel: o operador abre o lead, o
+ * backend assina na hora, o link morre em minutos.
+ */
+function getWasabiSignedUrl(_a) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var { key, expiresInSeconds = 300, downloadFileName } = _a, credentials = __rest(_a, ["key", "expiresInSeconds", "downloadFileName"]);
+        const wasabiClient = buildClient(credentials);
+        const command = new client_s3_1.GetObjectCommand(Object.assign({ Bucket: credentials.bucketName, Key: key }, (downloadFileName
+            ? {
+                ResponseContentDisposition: `attachment; filename="${downloadFileName}"`
+            }
+            : {})));
+        return (0, s3_request_presigner_1.getSignedUrl)(wasabiClient, command, { expiresIn: expiresInSeconds });
+    });
+}
+/**
+ * Apaga um objeto. Usado pelo expurgo por retenção (LGPD): o arquivo some, o
+ * registro no banco fica marcado como expurgado para a auditoria continuar
+ * rastreável.
+ */
+function deleteFromWasabi(_a) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var { key } = _a, credentials = __rest(_a, ["key"]);
+        const wasabiClient = buildClient(credentials);
+        yield wasabiClient.send(new client_s3_1.DeleteObjectCommand({ Bucket: credentials.bucketName, Key: key }));
     });
 }

package/build/services/ai/AIClient.d.ts

@@ -10,6 +10,14 @@ export interface ChatParams {
     responseFormat?: {
         type: 'json_object' | 'text';
     };
+    tools?: OpenAI.ChatCompletionTool[];
+    toolChoice?: OpenAI.ChatCompletionToolChoiceOption;
+    account?: string;
+}
+export interface EmbeddingsParams {
+    model: string;
+    input: string[];
+    dimensions?: number;
     account?: string;
 }
 export interface TTSParams {
@@ -44,10 +52,16 @@ export interface ImageEditParams {
 }
 export interface ChatResult {
     content: string;
+    toolCalls: OpenAI.ChatCompletionMessageToolCall[];
+    finishReason: string | null;
     promptTokens: number;
     completionTokens: number;
     totalTokens: number;
 }
+export interface EmbeddingsResult {
+    vectors: number[][];
+    promptTokens: number;
+}
 export declare class AIClient {
     private readonly natsClient;
     private readonly service;
@@ -60,6 +74,14 @@ export declare class AIClient {
     private get cerebras();
     private emit;
     chat(params: ChatParams): Promise<ChatResult>;
+    /**
+     * Gera embeddings para indexar a base de conhecimento do agente.
+     *
+     * Passa pelo mesmo caminho de auditoria das outras chamadas: indexar uma
+     * apostila grande custa dinheiro e precisa aparecer no relatório junto com
+     * o resto.
+     */
+    embeddings(params: EmbeddingsParams): Promise<EmbeddingsResult>;
     tts(params: TTSParams): Promise<Buffer>;
     transcribe(params: TranscribeParams): Promise<string>;
     generateImage(params: ImageGenerateParams): Promise<string>;

package/build/services/ai/AIClient.js

@@ -46,12 +46,42 @@ const COST_PER_1K = {
     'dall-e-3': { input: 0.040, output: 0 },
     'dall-e-2': { input: 0.020, output: 0 },
     'gpt-image-1': { input: 0.067, output: 0 },
+    // embeddings — cobrados só na entrada (USD por 1K tokens)
+    'text-embedding-3-small': { input: 0.00002, output: 0 },
+    'text-embedding-3-large': { input: 0.00013, output: 0 },
 };
 function calcCost(model, promptTokens, completionTokens) {
     var _a;
     const rates = (_a = COST_PER_1K[model]) !== null && _a !== void 0 ? _a : { input: 0, output: 0 };
     return (promptTokens / 1000) * rates.input + (completionTokens / 1000) * rates.output;
 }
+// Resumo do prompt para o evento de auditoria.
+//
+// O conteúdo de uma mensagem pode ser string ou lista de partes (texto +
+// imagem). Uma imagem vira só o rótulo `[image]`: além de não caber, um data
+// URI de foto de documento no log de auditoria seria exatamente o vazamento
+// que o armazenamento privado existe para evitar.
+function summarizeMessages(messages) {
+    return messages
+        .map((message) => {
+        const { content } = message;
+        let text;
+        if (typeof content === 'string') {
+            text = content;
+        }
+        else if (Array.isArray(content)) {
+            text = content
+                .map((part) => (part.type === 'text' ? part.text : `[${part.type}]`))
+                .join(' ');
+        }
+        else {
+            text = '';
+        }
+        return `[${message.role}] ${text.slice(0, 200)}`;
+    })
+        .join(' | ')
+        .slice(0, 500);
+}
 class AIClient {
     constructor(natsClient, service, openaiApiKey, cerebrasApiKey) {
         this.natsClient = natsClient;
@@ -99,21 +129,24 @@ class AIClient {
     }
     chat(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g;
-            const { provider, model, messages, maxTokens, temperature, responseFormat, account } = params;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { provider, model, messages, maxTokens, temperature, responseFormat, tools, toolChoice, account } = params;
             const client = provider === 'cerebras' ? this.cerebras : this.openai;
             const requestedAt = new Date().toISOString();
             const t0 = Date.now();
-            const promptSummary = messages.map(m => { var _a; return `[${m.role}] ${String((_a = m.content) !== null && _a !== void 0 ? _a : '').slice(0, 200)}`; }).join(' | ').slice(0, 500);
+            const promptSummary = summarizeMessages(messages);
             try {
-                const response = yield client.chat.completions.create(Object.assign(Object.assign(Object.assign({ model,
-                    messages }, (maxTokens !== undefined && { max_tokens: maxTokens })), (temperature !== undefined && { temperature })), (responseFormat !== undefined && { response_format: responseFormat })));
+                const response = yield client.chat.completions.create(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ model,
+                    messages }, (maxTokens !== undefined && { max_tokens: maxTokens })), (temperature !== undefined && { temperature })), (responseFormat !== undefined && { response_format: responseFormat })), (tools !== undefined && { tools })), (toolChoice !== undefined && { tool_choice: toolChoice })));
                 const promptTokens = (_b = (_a = response.usage) === null || _a === void 0 ? void 0 : _a.prompt_tokens) !== null && _b !== void 0 ? _b : 0;
                 const completionTokens = (_d = (_c = response.usage) === null || _c === void 0 ? void 0 : _c.completion_tokens) !== null && _d !== void 0 ? _d : 0;
                 const costUSD = calcCost(model, promptTokens, completionTokens);
-                yield this.emit({ provider, type: 'chat', model, promptTokens, completionTokens, costUSD, durationMs: Date.now() - t0, requestedAt, prompt: promptSummary, success: true });
+                yield this.emit({ provider, type: 'chat', model, promptTokens, completionTokens, costUSD, durationMs: Date.now() - t0, requestedAt, prompt: promptSummary, account, success: true });
+                const choice = response.choices[0];
                 return {
-                    content: (_g = (_f = (_e = response.choices[0]) === null || _e === void 0 ? void 0 : _e.message) === null || _f === void 0 ? void 0 : _f.content) !== null && _g !== void 0 ? _g : '',
+                    content: (_f = (_e = choice === null || choice === void 0 ? void 0 : choice.message) === null || _e === void 0 ? void 0 : _e.content) !== null && _f !== void 0 ? _f : '',
+                    toolCalls: (_h = (_g = choice === null || choice === void 0 ? void 0 : choice.message) === null || _g === void 0 ? void 0 : _g.tool_calls) !== null && _h !== void 0 ? _h : [],
+                    finishReason: (_j = choice === null || choice === void 0 ? void 0 : choice.finish_reason) !== null && _j !== void 0 ? _j : null,
                     promptTokens,
                     completionTokens,
                     totalTokens: promptTokens + completionTokens,
@@ -121,7 +154,42 @@ class AIClient {
             }
             catch (err) {
                 const errorMessage = err instanceof Error ? err.message : String(err);
-                yield this.emit({ provider, type: 'chat', model, promptTokens: 0, completionTokens: 0, costUSD: 0, durationMs: Date.now() - t0, requestedAt, prompt: promptSummary, success: false, errorMessage });
+                yield this.emit({ provider, type: 'chat', model, promptTokens: 0, completionTokens: 0, costUSD: 0, durationMs: Date.now() - t0, requestedAt, prompt: promptSummary, account, success: false, errorMessage });
+                throw err;
+            }
+        });
+    }
+    /**
+     * Gera embeddings para indexar a base de conhecimento do agente.
+     *
+     * Passa pelo mesmo caminho de auditoria das outras chamadas: indexar uma
+     * apostila grande custa dinheiro e precisa aparecer no relatório junto com
+     * o resto.
+     */
+    embeddings(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const { model, input, dimensions, account } = params;
+            const requestedAt = new Date().toISOString();
+            const t0 = Date.now();
+            const promptSummary = `${input.length} textos, ${input.reduce((total, text) => total + text.length, 0)} chars`;
+            try {
+                const response = yield this.openai.embeddings.create(Object.assign({ model,
+                    input }, (dimensions !== undefined && { dimensions })));
+                const promptTokens = (_b = (_a = response.usage) === null || _a === void 0 ? void 0 : _a.prompt_tokens) !== null && _b !== void 0 ? _b : 0;
+                const costUSD = calcCost(model, promptTokens, 0);
+                yield this.emit({ provider: 'openai', type: 'embeddings', model, promptTokens, completionTokens: 0, costUSD, durationMs: Date.now() - t0, requestedAt, prompt: promptSummary, account, success: true });
+                // A API não garante a ordem da resposta; `index` é quem amarra cada
+                // vetor ao texto que o originou.
+                const vectors = new Array(input.length);
+                for (const item of response.data) {
+                    vectors[item.index] = item.embedding;
+                }
+                return { vectors, promptTokens };
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                yield this.emit({ provider: 'openai', type: 'embeddings', model, promptTokens: 0, completionTokens: 0, costUSD: 0, durationMs: Date.now() - t0, requestedAt, prompt: promptSummary, account, success: false, errorMessage });
                 throw err;
             }
         });

package/build/types/crm.d.ts

@@ -0,0 +1,207 @@
+export declare enum CrmChannel {
+    WhatsAppCloud = "WhatsAppCloud",
+    WhatsAppEvolution = "WhatsAppEvolution"
+}
+export declare enum CrmActor {
+    Lead = "Lead",
+    Ai = "Ai",
+    Human = "Human",
+    System = "System"
+}
+export declare enum CrmDirection {
+    Inbound = "Inbound",
+    Outbound = "Outbound"
+}
+export declare enum CrmMessageType {
+    Text = "Text",
+    Image = "Image",
+    Audio = "Audio",
+    Video = "Video",
+    Document = "Document",
+    Template = "Template",
+    InternalNote = "InternalNote"
+}
+export declare enum CrmMessageStatus {
+    Queued = "Queued",
+    Sent = "Sent",
+    Delivered = "Delivered",
+    Read = "Read",
+    Failed = "Failed"
+}
+export declare enum CrmConnectionState {
+    Connected = "Connected",
+    Connecting = "Connecting",
+    Disconnected = "Disconnected",
+    Unknown = "Unknown"
+}
+export declare enum CrmWindowState {
+    Open = "Open",
+    Closed = "Closed"
+}
+export interface CrmStage {
+    key: string;
+    label: string;
+    order: number;
+    color: string;
+    aiDescription: string;
+    aiEnabled: boolean;
+    isTerminal: boolean;
+    isWon: boolean;
+    isLost: boolean;
+    slaMinutes: number | null;
+}
+export declare enum CrmStageChangedBy {
+    Ai = "Ai",
+    Human = "Human",
+    Automation = "Automation"
+}
+export declare enum CrmLeadSource {
+    Form = "Form",
+    InboundMessage = "InboundMessage",
+    Manual = "Manual",
+    Import = "Import"
+}
+export type CrmFieldValue = string | number | boolean | null | string[];
+export type CrmCustomFields = Record<string, CrmFieldValue>;
+export declare enum CrmControl {
+    Ai = "Ai",
+    Human = "Human"
+}
+export declare enum CrmHandoffReason {
+    LeadRequested = "LeadRequested",
+    OutOfScope = "OutOfScope",
+    Sensitive = "Sensitive",
+    DocumentBlocked = "DocumentBlocked",
+    ManualTakeover = "ManualTakeover",
+    SlaBreach = "SlaBreach"
+}
+export declare enum CrmAgentTool {
+    SearchKnowledge = "SearchKnowledge",
+    MoveStage = "MoveStage",
+    ScheduleFollowUp = "ScheduleFollowUp",
+    RecordField = "RecordField",
+    RequestDocument = "RequestDocument",
+    RequestHuman = "RequestHuman"
+}
+export interface CrmAgentToolCall {
+    tool: CrmAgentTool;
+    arguments: Record<string, CrmFieldValue>;
+    result: string;
+    succeeded: boolean;
+}
+export interface CrmGuardrails {
+    forbiddenTopics: string[];
+    blockUnsourcedRates: boolean;
+    handoffOnSensitiveData: boolean;
+    mandatoryDisclaimer: string | null;
+    maxAiTurnsBeforeHandoff: number | null;
+}
+export declare enum CrmKnowledgeStatus {
+    Uploaded = "Uploaded",
+    Processing = "Processing",
+    Ready = "Ready",
+    Failed = "Failed"
+}
+export declare enum CrmKnowledgeFormat {
+    Pdf = "Pdf",
+    Docx = "Docx",
+    Txt = "Txt",
+    Markdown = "Markdown",
+    Inline = "Inline"
+}
+export interface CrmDocumentRequirement {
+    key: string;
+    label: string;
+    aiInstruction: string;
+    validationHints: string[];
+    required: boolean;
+    acceptedMimeTypes: string[];
+    maxFiles: number;
+    maxRejections: number;
+}
+export declare enum CrmLeadDocumentStatus {
+    Received = "Received",
+    Validating = "Validating",
+    Approved = "Approved",
+    Rejected = "Rejected",
+    PendingReview = "PendingReview",
+    Purged = "Purged"
+}
+export declare enum CrmDocumentRejectionReason {
+    Unreadable = "Unreadable",
+    WrongDocument = "WrongDocument",
+    Incomplete = "Incomplete",
+    Expired = "Expired",
+    SuspectedTampering = "SuspectedTampering"
+}
+export interface CrmCadenceStep {
+    afterHours: number;
+    stageKeys: string[];
+    template: string | null;
+    aiInstruction: string | null;
+    whatsappTemplateName: string | null;
+}
+export interface CrmFirstContact {
+    enabled: boolean;
+    afterMinutes: number;
+    text: string | null;
+    followUpText: string | null;
+    whatsappTemplateName: string | null;
+}
+export declare enum CrmCadenceStopReason {
+    LeadReplied = "LeadReplied",
+    StepsExhausted = "StepsExhausted",
+    StageTerminal = "StageTerminal",
+    OptedOut = "OptedOut",
+    HumanTookOver = "HumanTookOver"
+}
+export interface CrmSchedule {
+    timezone: string;
+    activeDays: number[];
+    windowStart: number;
+    windowEnd: number;
+    holidays: string[];
+}
+export interface CrmTypingProfile {
+    minSeconds: number;
+    maxSeconds: number;
+    perCharMs: number;
+    jitterPercent: number;
+    splitLongMessages: boolean;
+    splitThreshold: number;
+}
+export interface CrmLeadIngestPayload {
+    externalId: string;
+    sourceSystem: string;
+    sourceTable: string;
+    name: string;
+    phone: string;
+    email: string | null;
+    customFields: CrmCustomFields;
+    utmSource: string | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    utmTerm: string | null;
+    utmContent: string | null;
+    trackingCode: string | null;
+    occurredAt: string;
+}
+export declare enum CrmEventType {
+    LeadCreated = "LeadCreated",
+    StageChanged = "StageChanged",
+    MessageSent = "MessageSent",
+    MessageReceived = "MessageReceived",
+    ControlChanged = "ControlChanged",
+    DocumentReceived = "DocumentReceived",
+    DocumentReviewed = "DocumentReviewed",
+    CadenceStepFired = "CadenceStepFired",
+    CadenceStopped = "CadenceStopped",
+    OptedOut = "OptedOut",
+    AgentToolCalled = "AgentToolCalled",
+    GuardrailTriggered = "GuardrailTriggered",
+    DailyLimitReached = "DailyLimitReached",
+    FirstContactSent = "FirstContactSent",
+    ConnectionLost = "ConnectionLost",
+    ConnectionRestored = "ConnectionRestored",
+    MessageRecovered = "MessageRecovered"
+}

package/build/types/crm.js

@@ -0,0 +1,230 @@
+"use strict";
+// crm — núcleo de CRM multi-tenant com agente de IA
+//
+// Convenção: prefixo Crm em tudo, para não colidir com os tipos do
+// leadAutomator (LeadStatus, LeadMessageDirection...), que continuam existindo
+// enquanto o gn-social-media não for portado para este núcleo.
+//
+// Regra de ouro deste módulo: o que varia por tenant é DADO, não código.
+// Por isso estágio de funil, passo de cadência, requisito de documento e
+// ferramenta do agente são interfaces/configuração — nunca enum fechado.
+// Enum aqui é só para o que é genuinamente fixo (canal, direção, ator).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrmEventType = exports.CrmCadenceStopReason = exports.CrmDocumentRejectionReason = exports.CrmLeadDocumentStatus = exports.CrmKnowledgeFormat = exports.CrmKnowledgeStatus = exports.CrmAgentTool = exports.CrmHandoffReason = exports.CrmControl = exports.CrmLeadSource = exports.CrmStageChangedBy = exports.CrmWindowState = exports.CrmConnectionState = exports.CrmMessageStatus = exports.CrmMessageType = exports.CrmDirection = exports.CrmActor = exports.CrmChannel = void 0;
+// ============================================
+// CANAL E MENSAGEM
+// ============================================
+var CrmChannel;
+(function (CrmChannel) {
+    // WhatsApp Business Platform (Cloud API da Meta). Canal padrão para lead
+    // inbound: número não corre risco de banimento e tem status de entrega.
+    CrmChannel["WhatsAppCloud"] = "WhatsAppCloud";
+    // Evolution API / Baileys. Não-oficial. Mantido para tenant que faz
+    // prospecção fria ou não tem conta Meta Business verificada.
+    CrmChannel["WhatsAppEvolution"] = "WhatsAppEvolution";
+})(CrmChannel || (exports.CrmChannel = CrmChannel = {}));
+var CrmActor;
+(function (CrmActor) {
+    CrmActor["Lead"] = "Lead";
+    CrmActor["Ai"] = "Ai";
+    CrmActor["Human"] = "Human";
+    // Mensagem gerada por regra (cadência, template de reengajamento) sem
+    // passar pelo modelo.
+    CrmActor["System"] = "System";
+})(CrmActor || (exports.CrmActor = CrmActor = {}));
+var CrmDirection;
+(function (CrmDirection) {
+    CrmDirection["Inbound"] = "Inbound";
+    CrmDirection["Outbound"] = "Outbound";
+})(CrmDirection || (exports.CrmDirection = CrmDirection = {}));
+var CrmMessageType;
+(function (CrmMessageType) {
+    CrmMessageType["Text"] = "Text";
+    CrmMessageType["Image"] = "Image";
+    CrmMessageType["Audio"] = "Audio";
+    CrmMessageType["Video"] = "Video";
+    CrmMessageType["Document"] = "Document";
+    // Template aprovado (HSM). Único tipo que pode ser enviado fora da
+    // janela de 24h do WhatsApp.
+    CrmMessageType["Template"] = "Template";
+    // Nota interna do operador — não é enviada ao lead, aparece só no painel.
+    CrmMessageType["InternalNote"] = "InternalNote";
+})(CrmMessageType || (exports.CrmMessageType = CrmMessageType = {}));
+var CrmMessageStatus;
+(function (CrmMessageStatus) {
+    CrmMessageStatus["Queued"] = "Queued";
+    CrmMessageStatus["Sent"] = "Sent";
+    CrmMessageStatus["Delivered"] = "Delivered";
+    CrmMessageStatus["Read"] = "Read";
+    CrmMessageStatus["Failed"] = "Failed";
+})(CrmMessageStatus || (exports.CrmMessageStatus = CrmMessageStatus = {}));
+// Estado do vínculo entre o canal e o WhatsApp.
+//
+// Só faz sentido em canal com sessão (Evolution/Baileys, que pareia como
+// aparelho conectado e pode ser desligado pelo WhatsApp a qualquer momento).
+// Na Cloud API não existe sessão: o canal está sempre `Connected`.
+var CrmConnectionState;
+(function (CrmConnectionState) {
+    CrmConnectionState["Connected"] = "Connected";
+    CrmConnectionState["Connecting"] = "Connecting";
+    CrmConnectionState["Disconnected"] = "Disconnected";
+    CrmConnectionState["Unknown"] = "Unknown";
+})(CrmConnectionState || (exports.CrmConnectionState = CrmConnectionState = {}));
+// Estado da janela de atendimento de 24h da Meta. Fora dela, só template.
+var CrmWindowState;
+(function (CrmWindowState) {
+    CrmWindowState["Open"] = "Open";
+    CrmWindowState["Closed"] = "Closed";
+})(CrmWindowState || (exports.CrmWindowState = CrmWindowState = {}));
+var CrmStageChangedBy;
+(function (CrmStageChangedBy) {
+    CrmStageChangedBy["Ai"] = "Ai";
+    CrmStageChangedBy["Human"] = "Human";
+    // Regra do sistema (ex.: checklist de documentos completou).
+    CrmStageChangedBy["Automation"] = "Automation";
+})(CrmStageChangedBy || (exports.CrmStageChangedBy = CrmStageChangedBy = {}));
+// ============================================
+// LEAD
+// ============================================
+var CrmLeadSource;
+(function (CrmLeadSource) {
+    // Formulário do site, via rota de ingestão. O payload carrega o id da
+    // linha no Postgres para casar os dois lados.
+    CrmLeadSource["Form"] = "Form";
+    // Lead que iniciou a conversa no WhatsApp sem ter passado pelo formulário
+    // (ou cujo telefone não casou com nenhum registro).
+    CrmLeadSource["InboundMessage"] = "InboundMessage";
+    // Criado à mão no painel.
+    CrmLeadSource["Manual"] = "Manual";
+    // Carga em lote (CSV, prospecção).
+    CrmLeadSource["Import"] = "Import";
+})(CrmLeadSource || (exports.CrmLeadSource = CrmLeadSource = {}));
+// Quem está conduzindo a conversa agora.
+var CrmControl;
+(function (CrmControl) {
+    CrmControl["Ai"] = "Ai";
+    CrmControl["Human"] = "Human";
+})(CrmControl || (exports.CrmControl = CrmControl = {}));
+// Motivo pelo qual o agente pediu um humano. Vira etiqueta no kanban, então
+// é fechado de propósito: lista aberta viraria texto livre inútil para filtro.
+var CrmHandoffReason;
+(function (CrmHandoffReason) {
+    // O lead pediu explicitamente falar com uma pessoa.
+    CrmHandoffReason["LeadRequested"] = "LeadRequested";
+    // A pergunta saiu do que a base de conhecimento cobre.
+    CrmHandoffReason["OutOfScope"] = "OutOfScope";
+    // Assunto sensível (reclamação, ameaça de processo, dado bancário).
+    CrmHandoffReason["Sensitive"] = "Sensitive";
+    // Documento reprovado mais vezes que o limite configurado.
+    CrmHandoffReason["DocumentBlocked"] = "DocumentBlocked";
+    // Um operador assumiu pelo painel, sem a IA ter pedido.
+    CrmHandoffReason["ManualTakeover"] = "ManualTakeover";
+    // Estourou o SLA do estágio.
+    CrmHandoffReason["SlaBreach"] = "SlaBreach";
+})(CrmHandoffReason || (exports.CrmHandoffReason = CrmHandoffReason = {}));
+// ============================================
+// AGENTE
+// ============================================
+// Ferramentas que o agente pode receber. Habilitadas por tenant: um CRM de
+// empréstimo usa coleta de documento, um de agendamento não.
+var CrmAgentTool;
+(function (CrmAgentTool) {
+    // Busca vetorial na base de conhecimento do tenant (apostila, tabela de
+    // produtos, script de objeções).
+    CrmAgentTool["SearchKnowledge"] = "SearchKnowledge";
+    // Move o lead de estágio, informando o motivo.
+    CrmAgentTool["MoveStage"] = "MoveStage";
+    // Agenda um novo contato para uma data/hora.
+    CrmAgentTool["ScheduleFollowUp"] = "ScheduleFollowUp";
+    // Grava um dado coletado na conversa em customFields.
+    CrmAgentTool["RecordField"] = "RecordField";
+    // Pede um documento da checklist ao lead.
+    CrmAgentTool["RequestDocument"] = "RequestDocument";
+    // Devolve a conversa para um humano.
+    CrmAgentTool["RequestHuman"] = "RequestHuman";
+})(CrmAgentTool || (exports.CrmAgentTool = CrmAgentTool = {}));
+// ============================================
+// BASE DE CONHECIMENTO (RAG)
+// ============================================
+var CrmKnowledgeStatus;
+(function (CrmKnowledgeStatus) {
+    // Arquivo no Wasabi, ainda não processado.
+    CrmKnowledgeStatus["Uploaded"] = "Uploaded";
+    // Extraindo texto / gerando embeddings.
+    CrmKnowledgeStatus["Processing"] = "Processing";
+    // Chunks indexados, disponível para busca.
+    CrmKnowledgeStatus["Ready"] = "Ready";
+    // Falhou (PDF protegido, formato não suportado, arquivo corrompido).
+    CrmKnowledgeStatus["Failed"] = "Failed";
+})(CrmKnowledgeStatus || (exports.CrmKnowledgeStatus = CrmKnowledgeStatus = {}));
+var CrmKnowledgeFormat;
+(function (CrmKnowledgeFormat) {
+    CrmKnowledgeFormat["Pdf"] = "Pdf";
+    CrmKnowledgeFormat["Docx"] = "Docx";
+    CrmKnowledgeFormat["Txt"] = "Txt";
+    CrmKnowledgeFormat["Markdown"] = "Markdown";
+    // Texto colado direto no painel, sem arquivo.
+    CrmKnowledgeFormat["Inline"] = "Inline";
+})(CrmKnowledgeFormat || (exports.CrmKnowledgeFormat = CrmKnowledgeFormat = {}));
+var CrmLeadDocumentStatus;
+(function (CrmLeadDocumentStatus) {
+    // Recebido e armazenado, ainda não analisado.
+    CrmLeadDocumentStatus["Received"] = "Received";
+    // Em análise pelo modelo de visão.
+    CrmLeadDocumentStatus["Validating"] = "Validating";
+    // Aprovado automaticamente ou por um operador.
+    CrmLeadDocumentStatus["Approved"] = "Approved";
+    // Ilegível, documento errado ou fora de validade.
+    CrmLeadDocumentStatus["Rejected"] = "Rejected";
+    // Aguardando conferência humana (o modelo não teve confiança suficiente).
+    CrmLeadDocumentStatus["PendingReview"] = "PendingReview";
+    // Removido por retenção/pedido do titular (LGPD). O registro permanece
+    // para auditoria; o arquivo no Wasabi já não existe.
+    CrmLeadDocumentStatus["Purged"] = "Purged";
+})(CrmLeadDocumentStatus || (exports.CrmLeadDocumentStatus = CrmLeadDocumentStatus = {}));
+var CrmDocumentRejectionReason;
+(function (CrmDocumentRejectionReason) {
+    CrmDocumentRejectionReason["Unreadable"] = "Unreadable";
+    CrmDocumentRejectionReason["WrongDocument"] = "WrongDocument";
+    CrmDocumentRejectionReason["Incomplete"] = "Incomplete";
+    CrmDocumentRejectionReason["Expired"] = "Expired";
+    CrmDocumentRejectionReason["SuspectedTampering"] = "SuspectedTampering";
+})(CrmDocumentRejectionReason || (exports.CrmDocumentRejectionReason = CrmDocumentRejectionReason = {}));
+var CrmCadenceStopReason;
+(function (CrmCadenceStopReason) {
+    CrmCadenceStopReason["LeadReplied"] = "LeadReplied";
+    CrmCadenceStopReason["StepsExhausted"] = "StepsExhausted";
+    CrmCadenceStopReason["StageTerminal"] = "StageTerminal";
+    CrmCadenceStopReason["OptedOut"] = "OptedOut";
+    CrmCadenceStopReason["HumanTookOver"] = "HumanTookOver";
+})(CrmCadenceStopReason || (exports.CrmCadenceStopReason = CrmCadenceStopReason = {}));
+// ============================================
+// EVENTOS DE AUDITORIA
+// ============================================
+// Tudo que muda um lead vira um CrmEvent. É o que permite responder "por que
+// este lead foi para 'perdido' às 3h da manhã" — e é exigência prática de
+// LGPD quando há decisão automatizada sobre crédito.
+var CrmEventType;
+(function (CrmEventType) {
+    CrmEventType["LeadCreated"] = "LeadCreated";
+    CrmEventType["StageChanged"] = "StageChanged";
+    CrmEventType["MessageSent"] = "MessageSent";
+    CrmEventType["MessageReceived"] = "MessageReceived";
+    CrmEventType["ControlChanged"] = "ControlChanged";
+    CrmEventType["DocumentReceived"] = "DocumentReceived";
+    CrmEventType["DocumentReviewed"] = "DocumentReviewed";
+    CrmEventType["CadenceStepFired"] = "CadenceStepFired";
+    CrmEventType["CadenceStopped"] = "CadenceStopped";
+    CrmEventType["OptedOut"] = "OptedOut";
+    CrmEventType["AgentToolCalled"] = "AgentToolCalled";
+    CrmEventType["GuardrailTriggered"] = "GuardrailTriggered";
+    // Envio ativo barrado pelo limite diário do canal (proteção de warmup).
+    CrmEventType["DailyLimitReached"] = "DailyLimitReached";
+    CrmEventType["FirstContactSent"] = "FirstContactSent";
+    // Sessão do canal caiu. Enquanto durar, nada entra nem sai — e é por isso
+    // que existe alerta: queda silenciosa é lead perdido sem ninguém saber.
+    CrmEventType["ConnectionLost"] = "ConnectionLost";
+    CrmEventType["ConnectionRestored"] = "ConnectionRestored";
+    // Mensagem que chegou durante a queda e foi recuperada na sincronização.
+    CrmEventType["MessageRecovered"] = "MessageRecovered";
+})(CrmEventType || (exports.CrmEventType = CrmEventType = {}));

package/package.json

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