evo360-types 1.3.376 → 1.3.378

package/dist/apps/evo-hub-ia/v1/zod-schemas.ts

@@ -98,16 +98,25 @@ export type IHubiaConversationMode = z.infer<typeof zHubiaConversationModeSchema
 // ───────── evo-hubia-rules (deterministic rule layer) ─────────
 //
 // Camada de regras determinísticas avaliada pelo motor `evo-hubia-rules`
-// (ver cloud-functions/docs/evo-hubia-rules/). Hooks suportados:
-//   - `pre_llm`  (v1.0)  : avalia ANTES do orchestrator LLM rodar.
-//   - `post_llm` (v1.1)  : avalia DEPOIS do orchestrator e ANTES do envio
-//                          outbound; cobre safety/governance (content gate,
-//                          circuit breaker, salvaguarda pós-tool).
+// (ver cloud-functions/docs/evo-hubia-rules/). A regra é identificada pela
+// combinação ortogonal (trigger `when` × `phase`):
+//   - `when=inbound_message`  + `phase=pre_llm`  (v1.0)  : avalia ANTES do
+//                          orchestrator LLM rodar, na mensagem do paciente.
+//   - `when=llm_completed`    + `phase=post_llm` (feat-026): avalia DEPOIS do
+//                          orchestrator e ANTES do envio outbound; cobre
+//                          safety/governance (content gate, circuit breaker).
+//   - `when=outbound_message` + `phase=pre_llm`  (feat-027): avalia DEPOIS que
+//                          uma mensagem outbound foi enviada ao paciente
+//                          (reativo pós-fato, qualquer origem: LLM, operador,
+//                          n8n, system). Executa side-effects; não muta a msg.
+//   - `when=outbound_message` + `phase=post_llm` : RESERVADO — habilitado
+//                          quando "LLM em outbound" for liberado (fora de
+//                          escopo na v1.0). Schema aceita, runtime não dispara.
 //
-// Matriz phase × outcome × when (enforced pelo superRefine de
-// `zHubiaRuleSchema` abaixo):
-//   - pre_llm  + when=inbound_message + outcome ∈ {stop,to_llm,to_llm_with_context}
-//   - post_llm + when=llm_completed   + outcome = stop
+// Matriz when × outcome (enforced pelo superRefine de `zHubiaRuleSchema`):
+//   - inbound_message  + outcome ∈ {stop, to_llm, to_llm_with_context}
+//   - llm_completed    + outcome = stop
+//   - outbound_message + outcome = stop  (to_llm reservado p/ LLM-em-outbound)
 //
 // As regras moram em `binding.rules[]` — o binding É o cruzamento canal⨯
 // departamento, então o escopo de departamento é implícito.
@@ -115,12 +124,20 @@ export type IHubiaConversationMode = z.infer<typeof zHubiaConversationModeSchema
 /** Fase de avaliação. Tipos TS em src/types/evo-hub-ia/v1/. */
 export const zHubiaRulePhaseSchema = z.enum(["pre_llm", "post_llm"]);
 
-export const zHubiaRuleTriggerSchema = z.enum(["inbound_message", "llm_completed"]);
+export const zHubiaRuleTriggerSchema = z.enum(["inbound_message", "llm_completed", "outbound_message"]);
 
 export const zHubiaRuleOutcomeSchema = z.enum(["stop", "to_llm", "to_llm_with_context"]);
 
 export const zHubiaRuleAppliesToSchema = z.enum(["real_message", "kickoff", "any"]);
 
+/** Filtro por origem da mensagem outbound (apenas `when=outbound_message`).
+ *  - `all`                : qualquer origem dispara a regra.
+ *  - `llm_only`           : só mensagens geradas pelo LLM.
+ *  - `non_system`         : exclui mensagens sintéticas do sistema.
+ *  - `all_except_kickoff` : default — exclui apenas msgs de kickoff de
+ *                           transferência (proteção contra loop). */
+export const zHubiaOutboundSourceSchema = z.enum(["all", "llm_only", "non_system", "all_except_kickoff"]);
+
 export const zHubiaConditionOpSchema = z.enum([
   "exists", "not_exists",
   "is_empty", "is_not_empty",
@@ -206,6 +223,9 @@ export const zHubiaConditionGroupSchema = z.object({
 export const zHubiaRuleScopeSchema = z.object({
   applies_to: zHubiaRuleAppliesToSchema.optional(),
   provider: z.enum(["chatbee", "hub-waba"]).optional(),
+  /** Apenas `when=outbound_message`: filtra por origem da msg outbound.
+   *  Default runtime quando ausente: `all_except_kickoff`. */
+  outbound_source: zHubiaOutboundSourceSchema.optional(),
 }).partial();
 
 /** Uma ação a executar via ToolRegistry. `input` aceita templating
@@ -250,9 +270,12 @@ export const zHubiaRuleSchema = z.object({
   /** Aborta sequência de ações no primeiro erro. */
   stop_actions_on_error: z.boolean().default(true),
 }).passthrough().superRefine((rule, ctx) => {
-  // Matriz phase × outcome × when. pre_llm é permissivo (back-compat com
-  // regras v1.0); post_llm é restrito a outcome=stop + when=llm_completed
-  // (decisão C2 em features/feat-026-hubia-rules-v1-1/decisions.md).
+  // Matriz when × phase × outcome. inbound_message+pre_llm é permissivo
+  // (back-compat com regras v1.0); as demais combinações são restritas.
+  //
+  //   - post_llm           → outcome=stop + when=llm_completed (feat-026 C2)
+  //   - outbound_message   → outcome=stop (to_llm reservado p/ LLM-em-outbound,
+  //                          fora de escopo na feat-027)
   if (rule.phase === "post_llm") {
     if (rule.outcome !== "stop") {
       ctx.addIssue({
@@ -269,6 +292,13 @@ export const zHubiaRuleSchema = z.object({
       });
     }
   }
+  if (rule.when === "outbound_message" && rule.outcome !== "stop") {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["outcome"],
+      message: "when=outbound_message aceita apenas outcome=stop (to_llm será habilitado quando LLM em outbound for liberado)",
+    });
+  }
 });
 
 // ───────── AI Binding (department → AI agent routing) ─────────

package/dist/apps/evo-survey/zod-schemas.d.ts

@@ -975,12 +975,12 @@ export declare const zQuestionResponseSchema: z.ZodObject<{
     answer: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
     date: z.ZodOptional<z.ZodDate>;
 }, "strip", z.ZodTypeAny, {
-    questionId: string;
     answer: string | string[];
+    questionId: string;
     date?: Date | undefined;
 }, {
-    questionId: string;
     answer: string | string[];
+    questionId: string;
     date?: Date | undefined;
 }>;
 export declare const zSurveyResponseSchema: z.ZodObject<{
@@ -998,12 +998,12 @@ export declare const zSurveyResponseSchema: z.ZodObject<{
         answer: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
         date: z.ZodOptional<z.ZodDate>;
     }, "strip", z.ZodTypeAny, {
-        questionId: string;
         answer: string | string[];
+        questionId: string;
         date?: Date | undefined;
     }, {
-        questionId: string;
         answer: string | string[];
+        questionId: string;
         date?: Date | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
@@ -1016,8 +1016,8 @@ export declare const zSurveyResponseSchema: z.ZodObject<{
     updated_at?: Date | null | undefined;
     deleted_at?: Date | null | undefined;
     responses?: {
-        questionId: string;
         answer: string | string[];
+        questionId: string;
         date?: Date | undefined;
     }[] | undefined;
 }, {
@@ -1030,8 +1030,8 @@ export declare const zSurveyResponseSchema: z.ZodObject<{
     updated_at?: Date | null | undefined;
     deleted_at?: Date | null | undefined;
     responses?: {
-        questionId: string;
         answer: string | string[];
+        questionId: string;
         date?: Date | undefined;
     }[] | undefined;
 }>;
@@ -1064,12 +1064,12 @@ export declare const zSurveySubmissionSchema: z.ZodObject<{
             answer: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
             date: z.ZodOptional<z.ZodDate>;
         }, "strip", z.ZodTypeAny, {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }, {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
@@ -1082,8 +1082,8 @@ export declare const zSurveySubmissionSchema: z.ZodObject<{
         updated_at?: Date | null | undefined;
         deleted_at?: Date | null | undefined;
         responses?: {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }[] | undefined;
     }, {
@@ -1096,8 +1096,8 @@ export declare const zSurveySubmissionSchema: z.ZodObject<{
         updated_at?: Date | null | undefined;
         deleted_at?: Date | null | undefined;
         responses?: {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }[] | undefined;
     }>, "many">>;
@@ -1127,8 +1127,8 @@ export declare const zSurveySubmissionSchema: z.ZodObject<{
         updated_at?: Date | null | undefined;
         deleted_at?: Date | null | undefined;
         responses?: {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }[] | undefined;
     }[] | undefined;
@@ -1154,8 +1154,8 @@ export declare const zSurveySubmissionSchema: z.ZodObject<{
         updated_at?: Date | null | undefined;
         deleted_at?: Date | null | undefined;
         responses?: {
-            questionId: string;
             answer: string | string[];
+            questionId: string;
             date?: Date | undefined;
         }[] | undefined;
     }[] | undefined;
@@ -1427,12 +1427,12 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
                 answer: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
                 date: z.ZodOptional<z.ZodDate>;
             }, "strip", z.ZodTypeAny, {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }, {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }>, "many">>;
         }, "strip", z.ZodTypeAny, {
@@ -1445,8 +1445,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }, {
@@ -1459,8 +1459,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }>, "many">>;
@@ -1490,8 +1490,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -1517,8 +1517,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -1615,8 +1615,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -1712,8 +1712,8 @@ export declare const zSurveyDeploymentSchema: z.ZodObject<{
             updated_at?: Date | null | undefined;
             deleted_at?: Date | null | undefined;
             responses?: {
-                questionId: string;
                 answer: string | string[];
+                questionId: string;
                 date?: Date | undefined;
             }[] | undefined;
         }[] | undefined;

package/dist/types/evo-chat/call-session/index.d.ts

@@ -18,6 +18,8 @@ export interface IMessageCall {
     duration_s?: number;
     end_reason?: string;
 }
+export type CallMediaState = 'idle' | 'offer_ready' | 'answering' | 'answered' | 'connected' | 'ended';
+export type CallTerminatedBy = 'patient' | 'agent' | 'system';
 export interface ICallSession extends IFireDoc {
     model_ver: number;
     provider_call_id: string;
@@ -38,4 +40,22 @@ export interface ICallSession extends IFireDoc {
     duration_s?: number;
     timeline_at: Date;
     last_event_at: Date;
+    claimed_by_user_id?: string;
+    claimed_by_name?: string;
+    claimed_at?: Date;
+    claim_expires_at?: Date;
+    accepted_by_user_id?: string;
+    accepted_at?: Date;
+    media_state?: CallMediaState;
+    browser_session_id?: string;
+    terminated_by?: CallTerminatedBy;
+    failure_code?: number;
+    failure_source?: string;
+}
+export interface ICallSignalRemote {
+    provider_call_id: string;
+    sdp_type: 'offer' | 'answer';
+    sdp: string;
+    source: 'meta';
+    created_at: Date;
 }

package/dist/types/evo-chat/call-session/index.ts

@@ -7,10 +7,9 @@ import type { MessageDirection } from "../thread-message";
 export type CallProviderDirection = 'USER_INITIATED' | 'BUSINESS_INITIATED';
 
 // Status de negócio normalizado da chamada.
-// Fase 1 (feat-029) produz apenas: ringing | missed | rejected | failed | completed.
-// Os demais (pre_accepted/accepted/connected/terminated) são reservados para a Fase 2
-// (voz via WebRTC) e já existem aqui para a state machine de precedência ser estável
-// sem exigir republish do evo360-types quando a Fase 2 chegar.
+// Fase 1 (feat-029) produz: ringing | missed | rejected | failed | completed.
+// Os demais (pre_accepted/accepted/connected/terminated) são usados na Fase 2
+// (voz via WebRTC, atendimento humano ao vivo).
 export type CallStatus =
   | 'ringing'
   | 'pre_accepted'
@@ -45,11 +44,23 @@ export interface IMessageCall {
   end_reason?: string;
 }
 
+// ── Call media state (Fase 2 — atendimento ao vivo via WebRTC) ──
+
+// Estado da mídia na perspectiva do nosso atendimento (browser do operador).
+// Distinto de CallStatus (status de negócio da chamada). Governa a UI do cliente.
+export type CallMediaState =
+  | 'idle'          // sem mídia
+  | 'offer_ready'   // SDP offer da Meta disponível para o operador (inbound)
+  | 'answering'     // operador gerou answer / aguardando connect da Meta
+  | 'answered'      // accept/connect enviado à Meta
+  | 'connected'     // mídia fluindo
+  | 'ended';        // mídia encerrada
+
+export type CallTerminatedBy = 'patient' | 'agent' | 'system';
+
 // ── Call Session (entidade canônica — fonte de verdade) ──
 
 // Path: tenants/{tenant}/apps/evo-chat/call_sessions/{provider_call_id}
-// Fase 1 = MÍNIMO. Campos operacionais da Fase 2 (claim/sdp refs/agent/presence)
-// NÃO devem ser adicionados aqui agora.
 export interface ICallSession extends IFireDoc {
   model_ver: number;
   provider_call_id: string;        // wacid.* (também é o doc id)
@@ -71,11 +82,44 @@ export interface ICallSession extends IFireDoc {
 
   // Semântica de tempo.
   started_at?: Date;               // chamada iniciada no WhatsApp (connect ts)
-  connected_at?: Date;             // mídia atendida — Fase 2 (não setado na Fase 1)
+  connected_at?: Date;             // mídia atendida (Fase 2)
   ended_at?: Date;                 // terminate
   duration_s?: number;
 
   // Ordenação/observação na timeline.
   timeline_at: Date;               // primeiro timestamp de provider observado
   last_event_at: Date;             // último timestamp de provider observado
+
+  // ── Fase 2 — atendimento ao vivo (WebRTC) ──
+  // Lock/claim: impede duas secretárias atenderem a mesma chamada.
+  claimed_by_user_id?: string;
+  claimed_by_name?: string;
+  claimed_at?: Date;
+  claim_expires_at?: Date;
+  // Operador que de fato atendeu a mídia.
+  accepted_by_user_id?: string;
+  accepted_at?: Date;
+  // Estado da mídia (governa a UI do cliente).
+  media_state?: CallMediaState;
+  // Identificador da sessão de browser que está conduzindo a mídia (1 aba ativa).
+  browser_session_id?: string;
+  // Encerramento.
+  terminated_by?: CallTerminatedBy;
+  failure_code?: number;
+  failure_source?: string;
+}
+
+// ── Sinalização WebRTC (relay de SDP) ──
+// Doc: call_sessions/{provider_call_id}/signaling/remote
+// Carrega APENAS o SDP REMOTO (vindo da Meta) que o browser do operador precisa
+// consumir: offer no inbound, answer no outbound. O SDP gerado pelo browser
+// (answer no inbound / offer no outbound) NUNCA é gravado aqui — vai por endpoint
+// autenticado direto para a Meta. SDP é dado sensível e efêmero.
+export interface ICallSignalRemote {
+  provider_call_id: string;
+  sdp_type: 'offer' | 'answer';
+  sdp: string;
+  // 'meta' = veio da Meta (único caso persistido).
+  source: 'meta';
+  created_at: Date;
 }

package/dist/types/evo-chat/channel/index.d.ts

@@ -23,9 +23,18 @@ export interface ICallDeflectionConfig {
     only_outside_business_hours?: boolean;
     cooldown_minutes?: number;
 }
+export interface ICallOutboundPermissionConfig {
+    enabled: boolean;
+    request_template?: {
+        name: string;
+        language: string;
+    };
+}
 export interface ICallsChannelConfig {
     enabled: boolean;
     deflection?: ICallDeflectionConfig;
+    inbound_voice_enabled?: boolean;
+    outbound_permission?: ICallOutboundPermissionConfig;
 }
 export interface IChannel extends IFireDoc {
     model_ver: number;

package/dist/types/evo-chat/channel/index.ts

@@ -32,10 +32,21 @@ export interface ICallDeflectionConfig {
   cooldown_minutes?: number;           // hardening leve (notificação repetida)
 }
 
+// Permissão para ligação outbound (business-initiated) — Fase 2.
+// Antes de discar, a clínica precisa de permissão do usuário; quando ausente,
+// envia-se um HSM com componente CALL_PERMISSION_REQUEST (template aprovado).
+export interface ICallOutboundPermissionConfig {
+  enabled: boolean;
+  // Template HSM com botão/ação CALL_PERMISSION_REQUEST.
+  request_template?: { name: string; language: string };
+}
+
 export interface ICallsChannelConfig {
   enabled: boolean;
   deflection?: ICallDeflectionConfig;
-  // outbound_permission?: ICallOutboundPermissionConfig; // Fase 2 — não definir agora
+  // Fase 2 — voz ao vivo via WebRTC.
+  inbound_voice_enabled?: boolean;     // permite atender chamada inbound no web-app
+  outbound_permission?: ICallOutboundPermissionConfig;
 }
 
 // ── Channel (evo-chat v3) ──

package/dist/types/evo-chat/contact/index.d.ts

@@ -21,5 +21,13 @@ export interface IChatContact extends IFireDoc {
     wa_id?: string | null;
     provider?: 'chatbee' | 'hub-waba' | string;
     channel_ids?: string[];
+    call_permission?: ICallPermissionState;
     [key: string]: unknown;
 }
+export interface ICallPermissionState {
+    status: 'granted' | 'denied' | 'none';
+    source?: 'user_action' | 'automatic';
+    is_permanent?: boolean;
+    expires_at?: string | number;
+    updated_at?: string;
+}

package/dist/types/evo-chat/contact/index.ts

@@ -29,5 +29,21 @@ export interface IChatContact extends IFireDoc {
   provider?: 'chatbee' | 'hub-waba' | string;
   channel_ids?: string[];
 
+  // ── call permission (feat-029 Fase 2) ──
+  // Última permissão de ligação conhecida deste contato (espelho local; a fonte
+  // de verdade é a Meta via GET /{phone_number_id}/call_permissions). Atualizado
+  // ao receber a interactive call_permission_reply.
+  call_permission?: ICallPermissionState;
+
   [key: string]: unknown; // index signature
 }
+
+// Estado de permissão de ligação outbound (business-initiated) para um contato.
+export interface ICallPermissionState {
+  status: 'granted' | 'denied' | 'none';
+  source?: 'user_action' | 'automatic';
+  is_permanent?: boolean;
+  // ISO 8601 ou epoch (segundos) — quando a permissão temporária expira.
+  expires_at?: string | number;
+  updated_at?: string;
+}

package/dist/types/evo-chat/fb_collections.d.ts

@@ -13,6 +13,8 @@ export declare const THREAD_MESSAGES_COLLECTION = "messages";
 export declare const TICKETS_COLLECTION = "tickets";
 export declare const INBOXES_COLLECTION = "inboxes";
 export declare const CALL_SESSIONS_COLLECTION = "call_sessions";
+export declare const CALL_SIGNALING_COLLECTION = "signaling";
+export declare const CALL_SIGNAL_REMOTE_DOC = "remote";
 export declare const HubWabaCollections: {
     readonly TEMPLATES: "waba-templates";
     readonly QUICK_REPLIES: "quick-replies";

package/dist/types/evo-chat/fb_collections.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WABA_CHANNEL_INDEX_PATH = exports.WABA_SETUP_PATH = exports.HubWabaCollections = exports.CALL_SESSIONS_COLLECTION = exports.INBOXES_COLLECTION = exports.TICKETS_COLLECTION = exports.THREAD_MESSAGES_COLLECTION = exports.THREADS_COLLECTION = exports.CHANNELS_COLLECTION = exports.CHATBEE_CHANNELS_COLLECTION = exports.HSM_MESSAGES_COLLECTION = exports.PROTOCOLS_COLLECTION = exports.CONTACTS_COLLECTION = exports.TICKET_CLOSE_TYPES_COLLECTION = exports.TICKET_CLOSES_COLLECTION = exports.TICKET_CLOSES = exports.CHAT_DICS_COLLECTION = exports.EVO_CHAT_APP = void 0;
+exports.WABA_CHANNEL_INDEX_PATH = exports.WABA_SETUP_PATH = exports.HubWabaCollections = exports.CALL_SIGNAL_REMOTE_DOC = exports.CALL_SIGNALING_COLLECTION = exports.CALL_SESSIONS_COLLECTION = exports.INBOXES_COLLECTION = exports.TICKETS_COLLECTION = exports.THREAD_MESSAGES_COLLECTION = exports.THREADS_COLLECTION = exports.CHANNELS_COLLECTION = exports.CHATBEE_CHANNELS_COLLECTION = exports.HSM_MESSAGES_COLLECTION = exports.PROTOCOLS_COLLECTION = exports.CONTACTS_COLLECTION = exports.TICKET_CLOSE_TYPES_COLLECTION = exports.TICKET_CLOSES_COLLECTION = exports.TICKET_CLOSES = exports.CHAT_DICS_COLLECTION = exports.EVO_CHAT_APP = void 0;
 //EVO Chat Application Doc
 exports.EVO_CHAT_APP = "evo-chat";
 //dictionaries
@@ -23,6 +23,8 @@ exports.THREAD_MESSAGES_COLLECTION = "messages"; // subcollection de threads
 exports.TICKETS_COLLECTION = "tickets";
 exports.INBOXES_COLLECTION = "inboxes";
 exports.CALL_SESSIONS_COLLECTION = "call_sessions"; // entidade canônica de chamadas (feat-029)
+exports.CALL_SIGNALING_COLLECTION = "signaling"; // subcoleção de call_sessions p/ relay de SDP (feat-029 Fase 2)
+exports.CALL_SIGNAL_REMOTE_DOC = "remote"; // doc único: SDP remoto (da Meta) que o browser consome
 // hub-waba template subcollection (under channels)
 exports.HubWabaCollections = {
     TEMPLATES: 'waba-templates',

package/dist/types/evo-chat/fb_collections.ts

@@ -26,6 +26,8 @@ export const THREAD_MESSAGES_COLLECTION = "messages"; // subcollection de thread
 export const TICKETS_COLLECTION = "tickets";
 export const INBOXES_COLLECTION = "inboxes";
 export const CALL_SESSIONS_COLLECTION = "call_sessions"; // entidade canônica de chamadas (feat-029)
+export const CALL_SIGNALING_COLLECTION = "signaling";    // subcoleção de call_sessions p/ relay de SDP (feat-029 Fase 2)
+export const CALL_SIGNAL_REMOTE_DOC = "remote";          // doc único: SDP remoto (da Meta) que o browser consome
 
 // hub-waba template subcollection (under channels)
 export const HubWabaCollections = {

package/dist/types/evo-chat/thread-message/index.d.ts

@@ -30,8 +30,17 @@ export interface IMessageLocation {
     name?: string;
     address?: string;
 }
+export type InteractiveMessageType = 'button_reply' | 'list_reply' | 'call_permission_reply' | 'call_permission_request';
+/** Resposta do paciente a um pedido de permissão de ligação (WhatsApp Calling API). */
+export interface ICallPermissionReply {
+    response?: 'accept' | 'reject';
+    is_permanent?: boolean;
+    /** Unix timestamp (segundos) — presente em permissões temporárias aceitas. */
+    expiration_timestamp?: number | string;
+    response_source?: 'user_action' | 'automatic';
+}
 export interface IMessageInteractive {
-    type: 'button_reply' | 'list_reply';
+    type: InteractiveMessageType | string;
     button_reply?: {
         id: string;
         title: string;
@@ -41,6 +50,7 @@ export interface IMessageInteractive {
         title: string;
         description?: string;
     };
+    call_permission_reply?: ICallPermissionReply;
 }
 export interface IMessageReaction {
     message_id: string;

package/dist/types/evo-chat/thread-message/index.ts

@@ -48,10 +48,26 @@ export interface IMessageLocation {
 
 // ── Message interactive ──
 
+export type InteractiveMessageType =
+  | 'button_reply'
+  | 'list_reply'
+  | 'call_permission_reply'
+  | 'call_permission_request';
+
+/** Resposta do paciente a um pedido de permissão de ligação (WhatsApp Calling API). */
+export interface ICallPermissionReply {
+  response?: 'accept' | 'reject';
+  is_permanent?: boolean;
+  /** Unix timestamp (segundos) — presente em permissões temporárias aceitas. */
+  expiration_timestamp?: number | string;
+  response_source?: 'user_action' | 'automatic';
+}
+
 export interface IMessageInteractive {
-  type: 'button_reply' | 'list_reply';
+  type: InteractiveMessageType | string;
   button_reply?: { id: string; title: string };
   list_reply?: { id: string; title: string; description?: string };
+  call_permission_reply?: ICallPermissionReply;
 }
 
 // ── Message reaction ──

package/dist/types/evo-hub-ia/v1/index.d.ts

@@ -1,26 +1,41 @@
 /** Fase de avaliação.
  *  - `pre_llm`  (v1.0) : avalia antes do orchestrator LLM.
  *  - `post_llm` (v1.1) : avalia depois do orchestrator e antes do envio
- *                        outbound (safety/governance). */
+ *                        outbound (safety/governance).
+ *  Ortogonal ao `when` (trigger): regras outbound (feat-027) usam
+ *  `when=outbound_message + phase=pre_llm`. O par
+ *  `outbound_message + post_llm` fica reservado p/ LLM-em-outbound futuro. */
 export type IHubiaRulePhase = "pre_llm" | "post_llm";
-/** Gatilho que dispara a avaliação. Correlacionado com `phase`:
- *  pre_llm → inbound_message; post_llm → llm_completed (validado pelo
- *  superRefine de `zHubiaRuleSchema`). */
-export type IHubiaRuleTrigger = "inbound_message" | "llm_completed";
+/** Gatilho que dispara a avaliação. Combinações válidas com `phase`
+ *  (validado pelo superRefine de `zHubiaRuleSchema`):
+ *  - `inbound_message`  + pre_llm  : mensagem do paciente (v1.0).
+ *  - `llm_completed`    + post_llm : turno do LLM concluído (feat-026).
+ *  - `outbound_message` + pre_llm  : mensagem enviada ao paciente, reativo
+ *                                    pós-fato (feat-027). */
+export type IHubiaRuleTrigger = "inbound_message" | "llm_completed" | "outbound_message";
 /** Desfecho do turno após a regra disparar:
  *  - `stop`                — finaliza turno; em pre_llm pula o LLM,
- *                            em post_llm bloqueia o envio outbound (único
- *                            outcome permitido em post_llm).
+ *                            em post_llm bloqueia o envio outbound, em
+ *                            outbound_message apenas registra trace + executa
+ *                            actions (msg já saiu). Único outcome permitido
+ *                            em post_llm e outbound_message.
  *  - `to_llm`              — segue para o orchestrator normalmente
- *                            (apenas pre_llm).
+ *                            (apenas inbound_message + pre_llm).
  *  - `to_llm_with_context` — segue para o orchestrator com trace das ações
- *                            injetado como bloco de sistema (apenas pre_llm).
+ *                            injetado como bloco de sistema (apenas
+ *                            inbound_message + pre_llm).
  *  Quando o LLM está desligado no binding (default_mode `human_only`/`blocked`),
  *  `to_llm`/`to_llm_with_context` degradam para "cai pro humano". */
 export type IHubiaRuleOutcome = "stop" | "to_llm" | "to_llm_with_context";
 /** Tipo de batch ao qual a regra se aplica. `real_message` (default) ignora
  *  a mensagem de kickoff do sistema — proteção contra loop de transferência. */
 export type IHubiaRuleAppliesTo = "real_message" | "kickoff" | "any";
+/** Filtro por origem da mensagem outbound (apenas `when=outbound_message`).
+ *  - `all`                : qualquer origem dispara.
+ *  - `llm_only`           : só mensagens do LLM.
+ *  - `non_system`         : exclui mensagens sintéticas do sistema.
+ *  - `all_except_kickoff` : default — exclui apenas kickoff de transferência. */
+export type IHubiaOutboundSource = "all" | "llm_only" | "non_system" | "all_except_kickoff";
 /** Operadores suportados pelas condições.
  *
  *  `in_schedule` / `not_in_schedule` esperam `value: IHubiaSchedule` e
@@ -79,6 +94,9 @@ export interface IHubiaConditionGroup {
 export interface IHubiaRuleScope {
     applies_to?: IHubiaRuleAppliesTo;
     provider?: "chatbee" | "hub-waba";
+    /** Apenas `when=outbound_message`: filtra por origem da msg outbound.
+     *  Default runtime quando ausente: `all_except_kickoff`. */
+    outbound_source?: IHubiaOutboundSource;
 }
 /** Uma ação a executar via ToolRegistry. `input` aceita templating
  *  `{{fact.path}}` resolvido em runtime pelo facts provider. */