@wrcb/cb-common 1.0.898 → 1.0.899

package/build/index.d.ts

@@ -58,6 +58,7 @@ export * from './types/predictionType';
 export * from './types/mercadoProfissional';
 export * from './types/trabalhoHomeOffice';
 export * from './types/crm';
+export * from './types/clinica';
 export * from './types/companion';
 export * from './events/subjects';
 export * from './events/baseListener';

package/build/index.js

@@ -86,6 +86,7 @@ __exportStar(require("./types/mercadoProfissional"), exports);
 __exportStar(require("./types/trabalhoHomeOffice"), exports);
 // crm — núcleo multi-tenant (pipeline configurável + agente de IA)
 __exportStar(require("./types/crm"), exports);
+__exportStar(require("./types/clinica"), exports);
 __exportStar(require("./types/companion"), exports);
 __exportStar(require("./events/subjects"), exports);
 __exportStar(require("./events/baseListener"), exports);

package/build/services/RedisService.d.ts

@@ -21,4 +21,12 @@ export declare class RedisService {
     static babeliaWordQuestionsKey(word: string, language: string): string;
     static babeliaTopicsListKey(language: string, level: string, activityType: string, topicType?: string): string;
     static babeliaLeaderboardKey(userId: string): string;
+    /** Trava de agenda de UM profissional enquanto um horário é marcado. */
+    static clinicaSlotLockKey(tenant: Tenant, professionalId: string): string;
+    /** Configuração da agenda da conta (lida a cada mensagem que chega). */
+    static clinicaAgendaSettingsKey(tenant: Tenant, ownerId: string): string;
+    /** Rodada de um worker periódico: só um pod roda por vez. */
+    static clinicaRoundLockKey(tenant: Tenant, worker: string): string;
+    /** Cache das leituras da Meta (campanhas, posts) de uma conta. */
+    static clinicaMetaCacheKey(tenant: Tenant, ownerId: string, what: string): string;
 }

package/build/services/RedisService.js

@@ -68,5 +68,22 @@ class RedisService {
     static babeliaLeaderboardKey(userId) {
         return `babelia:leaderboard:${userId}`;
     }
+    // --- Pacientto (clinica-backend) -----------------------------------------
+    /** Trava de agenda de UM profissional enquanto um horário é marcado. */
+    static clinicaSlotLockKey(tenant, professionalId) {
+        return `${tenant}:clinica:slot-lock:${professionalId}`;
+    }
+    /** Configuração da agenda da conta (lida a cada mensagem que chega). */
+    static clinicaAgendaSettingsKey(tenant, ownerId) {
+        return `${tenant}:clinica:agenda-settings:${ownerId}`;
+    }
+    /** Rodada de um worker periódico: só um pod roda por vez. */
+    static clinicaRoundLockKey(tenant, worker) {
+        return `${tenant}:clinica:round:${worker}`;
+    }
+    /** Cache das leituras da Meta (campanhas, posts) de uma conta. */
+    static clinicaMetaCacheKey(tenant, ownerId, what) {
+        return `${tenant}:clinica:meta:${ownerId}:${what}`;
+    }
 }
 exports.RedisService = RedisService;

package/build/types/clinica.d.ts

@@ -0,0 +1,239 @@
+export declare enum ClinicaAppointmentStatus {
+    AwaitingDeposit = "AwaitingDeposit",
+    Confirmed = "Confirmed",
+    Cancelled = "Cancelled",
+    Completed = "Completed",
+    NoShow = "NoShow"
+}
+export declare enum ClinicaAppointmentSource {
+    Ai = "Ai",
+    Panel = "Panel",
+    Assistant = "Assistant"
+}
+export declare enum ClinicaCancelReason {
+    PatientRequested = "PatientRequested",
+    ClinicRescheduled = "ClinicRescheduled",
+    DepositExpired = "DepositExpired",
+    Other = "Other"
+}
+export declare enum ClinicaDepositStatus {
+    NotRequired = "NotRequired",
+    Pending = "Pending",
+    Approved = "Approved",
+    Rejected = "Rejected",
+    Expired = "Expired"
+}
+/** Um intervalo de atendimento na semana. `weekday`: 0 = domingo. */
+export interface ClinicaWeeklySlot {
+    weekday: number;
+    start: string;
+    end: string;
+}
+/** Lembrete enviado antes do horário marcado (ex.: 1 dia antes). */
+export interface ClinicaReminder {
+    beforeMinutes: number;
+    text: string | null;
+    aiInstruction: string | null;
+}
+export interface ClinicaAgendaSettings {
+    timezone: string;
+    slotMinutes: number;
+    minNoticeMinutes: number;
+    maxDaysAhead: number;
+    depositHoldMinutes: number;
+    cancelWithoutLossHours: number;
+    pixKey: string | null;
+    pixKeyHolder: string | null;
+    reminders: ClinicaReminder[];
+    readDelaySeconds: number;
+    audioEnabled: boolean;
+    fishVoiceId: string | null;
+    photosEnabled: boolean;
+    reclassifySuggestions: boolean;
+}
+/** 1 = só informa, 3 = equilibrada (padrão), 5 = máxima. */
+export type ClinicaAggressiveness = 1 | 2 | 3 | 4 | 5;
+/** Foto de resultado de um atendimento do catálogo. */
+export interface ClinicaServicePhoto {
+    id: string;
+    key: string;
+    caption: string;
+    tags: string[];
+    consent: boolean;
+}
+export interface ClinicaStageSuggestion {
+    stageKey: string;
+    reason: string;
+    createdAt: Date;
+}
+export interface ClinicaTestChatMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+/** Uma ferramenta usada pela IA no teste. As que mudam dado são simuladas. */
+export interface ClinicaTestChatStep {
+    tool: string;
+    arguments: Record<string, string | number | boolean | null | string[]>;
+    result: string;
+    succeeded: boolean;
+    simulated: boolean;
+}
+export interface ClinicaTestChatPhoto {
+    url: string;
+    caption: string;
+}
+export interface ClinicaTestChatResult {
+    reply: string;
+    steps: ClinicaTestChatStep[];
+    sources: string[];
+    photos: ClinicaTestChatPhoto[];
+    audio: string | null;
+    handoff: string | null;
+    stageKey: string;
+}
+export declare enum ClinicaMetaStatus {
+    Pending = "Pending",
+    Active = "Active",
+    Expired = "Expired"
+}
+export interface ClinicaMetaPageOption {
+    id: string;
+    name: string;
+    igUserId: string | null;
+    igUsername: string | null;
+}
+export interface ClinicaMetaAdAccountOption {
+    id: string;
+    name: string;
+    currency: string;
+}
+export declare enum ClinicaCommentPlatform {
+    Instagram = "Instagram",
+    Facebook = "Facebook"
+}
+/** Resposta automática a comentários (estilo ManyChat, só comentários). */
+export interface ClinicaCommentRule {
+    id: string;
+    name: string;
+    isActive: boolean;
+    platforms: ClinicaCommentPlatform[];
+    keywords: string[];
+    postIds: string[];
+    publicReplies: string[];
+    aiPublicReply: boolean;
+    privateMessage: string | null;
+}
+export declare enum ClinicaCampaignAutomationMode {
+    Off = "Off",
+    SemiAutomatic = "SemiAutomatic",
+    Automatic = "Automatic"
+}
+export interface ClinicaCampaignLimits {
+    maxDailySpendCents: number | null;
+    maxMonthlySpendCents: number | null;
+    maxBudgetIncreasePercent: number;
+}
+export declare enum ClinicaCampaignActionType {
+    Pause = "Pause",
+    Activate = "Activate",
+    SetDailyBudget = "SetDailyBudget",
+    CreateFromPost = "CreateFromPost"
+}
+export declare enum ClinicaCampaignActionOrigin {
+    Panel = "Panel",
+    Assistant = "Assistant",
+    Automation = "Automation"
+}
+export declare enum ClinicaCampaignActionStatus {
+    Suggested = "Suggested",
+    Executed = "Executed",
+    Rejected = "Rejected",
+    Failed = "Failed"
+}
+export interface ClinicaCampaignMetrics {
+    campaignId: string;
+    name: string;
+    status: string;
+    objective: string | null;
+    dailyBudgetCents: number | null;
+    spendCents: number;
+    impressions: number;
+    reach: number;
+    clicks: number;
+    conversations: number;
+    leads: number;
+    appointments: number;
+    costPerLeadCents: number | null;
+    costPerAppointmentCents: number | null;
+}
+export interface ClinicaMetaPost {
+    id: string;
+    platform: ClinicaCommentPlatform;
+    caption: string;
+    mediaType: string;
+    permalink: string | null;
+    thumbnailUrl: string | null;
+    publishedAt: string;
+    likes: number;
+    comments: number;
+    reach: number | null;
+    saves: number | null;
+    shares: number | null;
+    views: number | null;
+}
+export interface ClinicaCreativeScript {
+    hook: string;
+    lines: string[];
+    onScreenText: string[];
+    caption: string;
+}
+export interface ClinicaCreativeSuggestion {
+    title: string;
+    basedOn: string[];
+    why: string;
+    script: ClinicaCreativeScript;
+}
+export interface ClinicaCreativeRankingItem {
+    postId: string;
+    verdict: 'focar' | 'manter' | 'deixar';
+    reason: string;
+}
+/** De qual anúncio veio o contato (clique para o WhatsApp). */
+export interface ClinicaAdReferral {
+    adId: string;
+    campaignId: string | null;
+    headline: string | null;
+    sourceUrl: string | null;
+    receivedAt: Date;
+}
+export declare enum ClinicaAssistantActionType {
+    RequestReschedule = "RequestReschedule",
+    MoveAppointment = "MoveAppointment",
+    CancelAppointment = "CancelAppointment",
+    BlockAgenda = "BlockAgenda",
+    SendMessage = "SendMessage",
+    MoveLeadStage = "MoveLeadStage",
+    PauseCampaign = "PauseCampaign",
+    ActivateCampaign = "ActivateCampaign",
+    SetCampaignBudget = "SetCampaignBudget",
+    CreateCampaignFromPost = "CreateCampaignFromPost"
+}
+export declare enum ClinicaAssistantPlanStatus {
+    Proposed = "Proposed",
+    Running = "Running",
+    Done = "Done",
+    PartiallyFailed = "PartiallyFailed",
+    Discarded = "Discarded"
+}
+export declare enum ClinicaAssistantActionStatus {
+    Pending = "Pending",
+    Done = "Done",
+    Failed = "Failed"
+}
+export interface ClinicaAssistantAction {
+    type: ClinicaAssistantActionType;
+    description: string;
+    params: Record<string, string | number | boolean | null>;
+    status: ClinicaAssistantActionStatus;
+    error: string | null;
+}

package/build/types/clinica.js

@@ -0,0 +1,126 @@
+"use strict";
+// Tipos do Pacientto (clinica-backend / clinica-frontend): agenda, sinal por
+// Pix, áudio e assistente de comandos. O núcleo de CRM (funil, conversa,
+// follow-up) continua em ./crm.ts.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClinicaAssistantActionStatus = exports.ClinicaAssistantPlanStatus = exports.ClinicaAssistantActionType = exports.ClinicaCampaignActionStatus = exports.ClinicaCampaignActionOrigin = exports.ClinicaCampaignActionType = exports.ClinicaCampaignAutomationMode = exports.ClinicaCommentPlatform = exports.ClinicaMetaStatus = exports.ClinicaDepositStatus = exports.ClinicaCancelReason = exports.ClinicaAppointmentSource = exports.ClinicaAppointmentStatus = void 0;
+// ============================================
+// AGENDA
+// ============================================
+var ClinicaAppointmentStatus;
+(function (ClinicaAppointmentStatus) {
+    // Horário reservado esperando o comprovante do sinal. Libera sozinho quando
+    // `deposit.expiresAt` passa.
+    ClinicaAppointmentStatus["AwaitingDeposit"] = "AwaitingDeposit";
+    ClinicaAppointmentStatus["Confirmed"] = "Confirmed";
+    ClinicaAppointmentStatus["Cancelled"] = "Cancelled";
+    ClinicaAppointmentStatus["Completed"] = "Completed";
+    ClinicaAppointmentStatus["NoShow"] = "NoShow";
+})(ClinicaAppointmentStatus || (exports.ClinicaAppointmentStatus = ClinicaAppointmentStatus = {}));
+var ClinicaAppointmentSource;
+(function (ClinicaAppointmentSource) {
+    // Marcado pela IA no WhatsApp.
+    ClinicaAppointmentSource["Ai"] = "Ai";
+    // Marcado pela equipe no painel.
+    ClinicaAppointmentSource["Panel"] = "Panel";
+    // Marcado pelo assistente de comandos.
+    ClinicaAppointmentSource["Assistant"] = "Assistant";
+})(ClinicaAppointmentSource || (exports.ClinicaAppointmentSource = ClinicaAppointmentSource = {}));
+var ClinicaCancelReason;
+(function (ClinicaCancelReason) {
+    ClinicaCancelReason["PatientRequested"] = "PatientRequested";
+    ClinicaCancelReason["ClinicRescheduled"] = "ClinicRescheduled";
+    ClinicaCancelReason["DepositExpired"] = "DepositExpired";
+    ClinicaCancelReason["Other"] = "Other";
+})(ClinicaCancelReason || (exports.ClinicaCancelReason = ClinicaCancelReason = {}));
+var ClinicaDepositStatus;
+(function (ClinicaDepositStatus) {
+    ClinicaDepositStatus["NotRequired"] = "NotRequired";
+    ClinicaDepositStatus["Pending"] = "Pending";
+    ClinicaDepositStatus["Approved"] = "Approved";
+    // Comprovante lido mas recusado (valor, chave ou data não batem). Continua
+    // esperando um válido até expirar.
+    ClinicaDepositStatus["Rejected"] = "Rejected";
+    ClinicaDepositStatus["Expired"] = "Expired";
+})(ClinicaDepositStatus || (exports.ClinicaDepositStatus = ClinicaDepositStatus = {}));
+// ============================================
+// META (Instagram e Facebook)
+// ============================================
+var ClinicaMetaStatus;
+(function (ClinicaMetaStatus) {
+    // Conectado, esperando escolher a página e a conta de anúncios.
+    ClinicaMetaStatus["Pending"] = "Pending";
+    ClinicaMetaStatus["Active"] = "Active";
+    // O token venceu ou foi revogado: precisa conectar de novo.
+    ClinicaMetaStatus["Expired"] = "Expired";
+})(ClinicaMetaStatus || (exports.ClinicaMetaStatus = ClinicaMetaStatus = {}));
+var ClinicaCommentPlatform;
+(function (ClinicaCommentPlatform) {
+    ClinicaCommentPlatform["Instagram"] = "Instagram";
+    ClinicaCommentPlatform["Facebook"] = "Facebook";
+})(ClinicaCommentPlatform || (exports.ClinicaCommentPlatform = ClinicaCommentPlatform = {}));
+var ClinicaCampaignAutomationMode;
+(function (ClinicaCampaignAutomationMode) {
+    ClinicaCampaignAutomationMode["Off"] = "Off";
+    // A IA sugere e o admin aprova.
+    ClinicaCampaignAutomationMode["SemiAutomatic"] = "SemiAutomatic";
+    // A IA executa sozinha, dentro dos limites.
+    ClinicaCampaignAutomationMode["Automatic"] = "Automatic";
+})(ClinicaCampaignAutomationMode || (exports.ClinicaCampaignAutomationMode = ClinicaCampaignAutomationMode = {}));
+var ClinicaCampaignActionType;
+(function (ClinicaCampaignActionType) {
+    ClinicaCampaignActionType["Pause"] = "Pause";
+    ClinicaCampaignActionType["Activate"] = "Activate";
+    ClinicaCampaignActionType["SetDailyBudget"] = "SetDailyBudget";
+    ClinicaCampaignActionType["CreateFromPost"] = "CreateFromPost";
+})(ClinicaCampaignActionType || (exports.ClinicaCampaignActionType = ClinicaCampaignActionType = {}));
+var ClinicaCampaignActionOrigin;
+(function (ClinicaCampaignActionOrigin) {
+    ClinicaCampaignActionOrigin["Panel"] = "Panel";
+    ClinicaCampaignActionOrigin["Assistant"] = "Assistant";
+    ClinicaCampaignActionOrigin["Automation"] = "Automation";
+})(ClinicaCampaignActionOrigin || (exports.ClinicaCampaignActionOrigin = ClinicaCampaignActionOrigin = {}));
+var ClinicaCampaignActionStatus;
+(function (ClinicaCampaignActionStatus) {
+    // Sugerida pela automação, esperando o admin.
+    ClinicaCampaignActionStatus["Suggested"] = "Suggested";
+    ClinicaCampaignActionStatus["Executed"] = "Executed";
+    ClinicaCampaignActionStatus["Rejected"] = "Rejected";
+    ClinicaCampaignActionStatus["Failed"] = "Failed";
+})(ClinicaCampaignActionStatus || (exports.ClinicaCampaignActionStatus = ClinicaCampaignActionStatus = {}));
+// ============================================
+// ASSISTENTE DE COMANDOS
+// ============================================
+var ClinicaAssistantActionType;
+(function (ClinicaAssistantActionType) {
+    // Desmarca e chama o paciente no WhatsApp para escolher outro horário.
+    ClinicaAssistantActionType["RequestReschedule"] = "RequestReschedule";
+    // Muda o horário de um agendamento para outro já livre.
+    ClinicaAssistantActionType["MoveAppointment"] = "MoveAppointment";
+    ClinicaAssistantActionType["CancelAppointment"] = "CancelAppointment";
+    // Bloqueia a agenda de um profissional (folga, imprevisto).
+    ClinicaAssistantActionType["BlockAgenda"] = "BlockAgenda";
+    ClinicaAssistantActionType["SendMessage"] = "SendMessage";
+    ClinicaAssistantActionType["MoveLeadStage"] = "MoveLeadStage";
+    // Campanhas (só o dono da conta, dentro dos limites de gasto).
+    ClinicaAssistantActionType["PauseCampaign"] = "PauseCampaign";
+    ClinicaAssistantActionType["ActivateCampaign"] = "ActivateCampaign";
+    ClinicaAssistantActionType["SetCampaignBudget"] = "SetCampaignBudget";
+    ClinicaAssistantActionType["CreateCampaignFromPost"] = "CreateCampaignFromPost";
+})(ClinicaAssistantActionType || (exports.ClinicaAssistantActionType = ClinicaAssistantActionType = {}));
+var ClinicaAssistantPlanStatus;
+(function (ClinicaAssistantPlanStatus) {
+    // Proposto, esperando o "executar" de quem pediu.
+    ClinicaAssistantPlanStatus["Proposed"] = "Proposed";
+    ClinicaAssistantPlanStatus["Running"] = "Running";
+    ClinicaAssistantPlanStatus["Done"] = "Done";
+    // Terminou com alguma ação falhando — o detalhe fica em cada ação.
+    ClinicaAssistantPlanStatus["PartiallyFailed"] = "PartiallyFailed";
+    ClinicaAssistantPlanStatus["Discarded"] = "Discarded";
+})(ClinicaAssistantPlanStatus || (exports.ClinicaAssistantPlanStatus = ClinicaAssistantPlanStatus = {}));
+var ClinicaAssistantActionStatus;
+(function (ClinicaAssistantActionStatus) {
+    ClinicaAssistantActionStatus["Pending"] = "Pending";
+    ClinicaAssistantActionStatus["Done"] = "Done";
+    ClinicaAssistantActionStatus["Failed"] = "Failed";
+})(ClinicaAssistantActionStatus || (exports.ClinicaAssistantActionStatus = ClinicaAssistantActionStatus = {}));

package/build/types/crm.d.ts

@@ -49,6 +49,7 @@ export interface CrmStage {
     isWon: boolean;
     isLost: boolean;
     slaMinutes: number | null;
+    aggressiveness?: number | null;
 }
 export declare enum CrmStageChangedBy {
     Ai = "Ai",
@@ -89,7 +90,16 @@ export declare enum CrmAgentTool {
     MoveStage = "MoveStage",
     ScheduleFollowUp = "ScheduleFollowUp",
     RecordField = "RecordField",
-    RequestHuman = "RequestHuman"
+    RequestHuman = "RequestHuman",
+    CheckAvailability = "CheckAvailability",
+    BookAppointment = "BookAppointment",
+    ListAppointments = "ListAppointments",
+    RescheduleAppointment = "RescheduleAppointment",
+    CancelAppointment = "CancelAppointment",
+    SetAudioConsent = "SetAudioConsent",
+    SendAudio = "SendAudio",
+    SendServicePhotos = "SendServicePhotos",
+    ConfirmPresence = "ConfirmPresence"
 }
 export interface CrmAgentToolCall {
     tool: CrmAgentTool;

package/build/types/crm.js

@@ -168,6 +168,27 @@ var CrmAgentTool;
     CrmAgentTool["RecordField"] = "RecordField";
     // Devolve a conversa para um humano.
     CrmAgentTool["RequestHuman"] = "RequestHuman";
+    // --- Agenda (Pacientto) -------------------------------------------------
+    // Horários livres de verdade, já descontados agendamentos e bloqueios. O
+    // agente só pode oferecer o que esta ferramenta devolver.
+    CrmAgentTool["CheckAvailability"] = "CheckAvailability";
+    // Marca o horário. Com sinal, nasce reservado aguardando o comprovante Pix.
+    CrmAgentTool["BookAppointment"] = "BookAppointment";
+    // Agendamentos futuros do contato, para remarcar ou cancelar o certo.
+    CrmAgentTool["ListAppointments"] = "ListAppointments";
+    CrmAgentTool["RescheduleAppointment"] = "RescheduleAppointment";
+    CrmAgentTool["CancelAppointment"] = "CancelAppointment";
+    // --- Áudio ----------------------------------------------------------------
+    // Grava a resposta do contato à pergunta "posso te mandar um áudio?".
+    CrmAgentTool["SetAudioConsent"] = "SetAudioConsent";
+    // Gera a fala (FishAudio) e envia como áudio. Só com consentimento.
+    CrmAgentTool["SendAudio"] = "SendAudio";
+    // --- Catálogo e presença (Pacientto) -------------------------------------
+    // Envia fotos de resultado de um atendimento do catálogo (só as que têm
+    // autorização do paciente fotografado).
+    CrmAgentTool["SendServicePhotos"] = "SendServicePhotos";
+    // O paciente confirmou que vai ao horário marcado.
+    CrmAgentTool["ConfirmPresence"] = "ConfirmPresence";
 })(CrmAgentTool || (exports.CrmAgentTool = CrmAgentTool = {}));
 /**
  * NÃO SÃO CONFIGURÁVEIS, de propósito — e vale registrar por quê, porque a

package/package.json

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