evo360-types 1.3.374 → 1.3.375

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

@@ -84,9 +84,16 @@ exports.zHubiaConversationModeSchema = zod_1.z.enum(["ai_only", "hybrid_assist",
 // ───────── evo-hubia-rules (deterministic rule layer) ─────────
 //
 // Camada de regras determinísticas avaliada pelo motor `evo-hubia-rules`
-// (ver cloud-functions/docs/evo-hubia-rules/). Roda ANTES do LLM (fase
-// `pre_llm`, único escopo de implementação atual). O campo `phase` já
-// reserva espaço arquitetural para um hook `post_llm` futuro.
+// (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).
+//
+// 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
 //
 // As regras moram em `binding.rules[]` — o binding É o cruzamento canal⨯
 // departamento, então o escopo de departamento é implícito.
@@ -207,7 +214,27 @@ exports.zHubiaRuleSchema = zod_1.z.object({
     dry_run: zod_1.z.boolean().default(false),
     /** Aborta sequência de ações no primeiro erro. */
     stop_actions_on_error: zod_1.z.boolean().default(true),
-}).passthrough();
+}).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).
+    if (rule.phase === "post_llm") {
+        if (rule.outcome !== "stop") {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: ["outcome"],
+                message: "phase=post_llm aceita apenas outcome=stop",
+            });
+        }
+        if (rule.when !== "llm_completed") {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: ["when"],
+                message: "phase=post_llm requer when=llm_completed",
+            });
+        }
+    }
+});
 // ───────── AI Binding (department → AI agent routing) ─────────
 const zHubiaCapabilitiesSchema = zod_1.z.object({
     can_schedule: zod_1.z.boolean().default(false),

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

@@ -98,9 +98,16 @@ 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/). Roda ANTES do LLM (fase
-// `pre_llm`, único escopo de implementação atual). O campo `phase` já
-// reserva espaço arquitetural para um hook `post_llm` futuro.
+// (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).
+//
+// 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
 //
 // As regras moram em `binding.rules[]` — o binding É o cruzamento canal⨯
 // departamento, então o escopo de departamento é implícito.
@@ -242,7 +249,27 @@ export const zHubiaRuleSchema = z.object({
 
   /** Aborta sequência de ações no primeiro erro. */
   stop_actions_on_error: z.boolean().default(true),
-}).passthrough();
+}).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).
+  if (rule.phase === "post_llm") {
+    if (rule.outcome !== "stop") {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["outcome"],
+        message: "phase=post_llm aceita apenas outcome=stop",
+      });
+    }
+    if (rule.when !== "llm_completed") {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["when"],
+        message: "phase=post_llm requer when=llm_completed",
+      });
+    }
+  }
+});
 
 // ───────── AI Binding (department → AI agent routing) ─────────
 

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

@@ -0,0 +1,41 @@
+import { IFireDoc } from "../../shared";
+import type { MessageDirection } from "../thread-message";
+export type CallProviderDirection = 'USER_INITIATED' | 'BUSINESS_INITIATED';
+export type CallStatus = 'ringing' | 'pre_accepted' | 'accepted' | 'connected' | 'missed' | 'rejected' | 'failed' | 'completed' | 'terminated';
+export interface ICallProviderError {
+    code: number;
+    title?: string;
+    message?: string;
+    details?: string;
+}
+export interface IMessageCall {
+    provider_call_id: string;
+    call_session_id: string;
+    status: CallStatus;
+    direction: MessageDirection;
+    started_at?: Date;
+    ended_at?: Date;
+    duration_s?: number;
+    end_reason?: string;
+}
+export interface ICallSession extends IFireDoc {
+    model_ver: number;
+    provider_call_id: string;
+    channel_id: string;
+    thread_id: string;
+    ticket_id: string;
+    contact_id: string;
+    lead_id?: string;
+    direction: MessageDirection;
+    provider_direction?: CallProviderDirection;
+    status: CallStatus;
+    end_reason?: string;
+    provider_status?: string;
+    provider_errors?: ICallProviderError[];
+    started_at?: Date;
+    connected_at?: Date;
+    ended_at?: Date;
+    duration_s?: number;
+    timeline_at: Date;
+    last_event_at: Date;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,81 @@
+import { IFireDoc } from "../../shared";
+import type { MessageDirection } from "../thread-message";
+
+// ── Call enums ──
+
+// Direção crua da Meta Calling API (preservada para debug/suporte).
+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.
+export type CallStatus =
+  | 'ringing'
+  | 'pre_accepted'
+  | 'accepted'
+  | 'connected'
+  | 'missed'
+  | 'rejected'
+  | 'failed'
+  | 'completed'
+  | 'terminated';
+
+export interface ICallProviderError {
+  code: number;
+  title?: string;
+  message?: string;
+  details?: string;
+}
+
+// ── Call timeline projection ──
+
+// Projeção FINA da chamada na timeline omnichannel. NÃO é fonte de verdade.
+// A verdade canônica vive em ICallSession (referenciada por call_session_id).
+// Sem accepted_at/connected_at na Fase 1 (são campos da Fase 2).
+export interface IMessageCall {
+  provider_call_id: string;        // wacid.* (== call_session_id na Fase 1)
+  call_session_id: string;
+  status: CallStatus;
+  direction: MessageDirection;
+  started_at?: Date;
+  ended_at?: Date;
+  duration_s?: number;
+  end_reason?: string;
+}
+
+// ── 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)
+  channel_id: string;
+  thread_id: string;
+  ticket_id: string;
+  contact_id: string;
+  lead_id?: string;
+
+  direction: MessageDirection;     // 'in' (USER_INITIATED) | 'out' (BUSINESS_INITIATED)
+  provider_direction?: CallProviderDirection;
+
+  status: CallStatus;              // normalizado, governado pela state machine de precedência
+  end_reason?: string;             // 'completed' | 'not_answered' | 'failed' | 'rejected'
+
+  // Cru da Meta — não colapsar cedo (FAILED é ambíguo).
+  provider_status?: string;        // ex.: 'COMPLETED' | 'FAILED'
+  provider_errors?: ICallProviderError[];
+
+  // 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)
+  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
+}

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

@@ -10,6 +10,23 @@ export interface IChannelProviderRef {
     phone_number_id?: string;
     business_id?: string;
 }
+export interface ICallDeflectionConfig {
+    enabled: boolean;
+    mode: 'template' | 'text';
+    template?: {
+        name: string;
+        language: string;
+        category?: string;
+    };
+    text?: string;
+    end_call: boolean;
+    only_outside_business_hours?: boolean;
+    cooldown_minutes?: number;
+}
+export interface ICallsChannelConfig {
+    enabled: boolean;
+    deflection?: ICallDeflectionConfig;
+}
 export interface IChannel extends IFireDoc {
     model_ver: number;
     provider: ChannelProvider | string;
@@ -21,5 +38,6 @@ export interface IChannel extends IFireDoc {
     status: ChannelStatus;
     provider_ref: IChannelProviderRef;
     hub_ia?: IHubIAConfig;
+    calls?: ICallsChannelConfig;
     [key: string]: unknown;
 }

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

@@ -19,6 +19,25 @@ export interface IChannelProviderRef {
   business_id?: string;
 }
 
+// ── Calls config (feat-029) ──
+
+// Deflection de chamada recebida (inbound). Distinta de outbound_permission (Fase 2).
+export interface ICallDeflectionConfig {
+  enabled: boolean;
+  mode: 'template' | 'text';
+  template?: { name: string; language: string; category?: string };
+  text?: string;                       // mode 'text' — só aplicado com janela de 24h aberta
+  end_call: boolean;                   // default true — terminate/reject via call-control
+  only_outside_business_hours?: boolean;
+  cooldown_minutes?: number;           // hardening leve (notificação repetida)
+}
+
+export interface ICallsChannelConfig {
+  enabled: boolean;
+  deflection?: ICallDeflectionConfig;
+  // outbound_permission?: ICallOutboundPermissionConfig; // Fase 2 — não definir agora
+}
+
 // ── Channel (evo-chat v3) ──
 
 export interface IChannel extends IFireDoc {
@@ -32,5 +51,6 @@ export interface IChannel extends IFireDoc {
   status: ChannelStatus;
   provider_ref: IChannelProviderRef;
   hub_ia?: IHubIAConfig;
+  calls?: ICallsChannelConfig;
   [key: string]: unknown;
 }

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

@@ -12,6 +12,7 @@ export declare const THREADS_COLLECTION = "threads";
 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 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.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_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
@@ -22,6 +22,7 @@ exports.THREADS_COLLECTION = "threads";
 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)
 // hub-waba template subcollection (under channels)
 exports.HubWabaCollections = {
     TEMPLATES: 'waba-templates',

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

@@ -25,6 +25,7 @@ export const THREADS_COLLECTION = "threads";
 export const THREAD_MESSAGES_COLLECTION = "messages"; // subcollection de threads
 export const TICKETS_COLLECTION = "tickets";
 export const INBOXES_COLLECTION = "inboxes";
+export const CALL_SESSIONS_COLLECTION = "call_sessions"; // entidade canônica de chamadas (feat-029)
 
 // hub-waba template subcollection (under channels)
 export const HubWabaCollections = {

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

@@ -5,6 +5,7 @@ export * from "./chatbee";
 export * from "./channel";
 export * from "./thread";
 export * from "./thread-message";
+export * from "./call-session";
 export * from "./ticket";
 export * from "./inbox";
 export * from "./waba-template";

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

@@ -22,6 +22,7 @@ __exportStar(require("./chatbee"), exports);
 __exportStar(require("./channel"), exports);
 __exportStar(require("./thread"), exports);
 __exportStar(require("./thread-message"), exports);
+__exportStar(require("./call-session"), exports);
 __exportStar(require("./ticket"), exports);
 __exportStar(require("./inbox"), exports);
 __exportStar(require("./waba-template"), exports);

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

@@ -5,6 +5,7 @@ export * from "./chatbee";
 export * from "./channel";
 export * from "./thread";
 export * from "./thread-message";
+export * from "./call-session";
 export * from "./ticket";
 export * from "./inbox";
 export * from "./waba-template";

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

@@ -1,5 +1,6 @@
 import { IFireDoc } from "../../shared";
-export type EvoChatMessageType = 'text' | 'image' | 'audio' | 'video' | 'document' | 'sticker' | 'location' | 'contacts' | 'interactive' | 'reaction' | 'template' | 'system';
+import type { IMessageCall } from "../call-session";
+export type EvoChatMessageType = 'text' | 'image' | 'audio' | 'video' | 'document' | 'sticker' | 'location' | 'contacts' | 'interactive' | 'reaction' | 'template' | 'system' | 'call';
 export type MessageDirection = 'in' | 'out';
 export interface IMessageStatus {
     sent_at?: Date;
@@ -91,6 +92,7 @@ export interface IThreadMessage extends IFireDoc {
         components?: unknown[];
     };
     context?: IMessageContext;
+    call?: IMessageCall;
     provider_message_id?: string;
     status?: IMessageStatus;
     reactions?: Record<string, {

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

@@ -1,4 +1,5 @@
 import { IFireDoc } from "../../shared";
+import type { IMessageCall } from "../call-session";
 
 // ── Message type/direction enums ──
 
@@ -6,7 +7,8 @@ export type EvoChatMessageType =
   | 'text' | 'image' | 'audio' | 'video'
   | 'document' | 'sticker' | 'location'
   | 'contacts' | 'interactive' | 'reaction'
-  | 'template' | 'system';
+  | 'template' | 'system'
+  | 'call';
 
 export type MessageDirection = 'in' | 'out';
 
@@ -112,6 +114,9 @@ export interface IThreadMessage extends IFireDoc {
   };
   context?: IMessageContext;
 
+  // Call timeline projection (feat-029). Fonte de verdade em ICallSession.
+  call?: IMessageCall;
+
   // Provider reference
   provider_message_id?: string;
 

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

@@ -11,3 +11,4 @@ export declare const FINOPS_DICS_SERVICES_ID = "services";
 export declare const FINOPS_SERVICES_COLLECTION = "services";
 export declare const FINOPS_TAKERS_COLLECTION = "takers";
 export declare const FINOPS_INVOICES_COLLECTION = "invoices";
+export declare const FINOPS_PAYMENT_LINKS_COLLECTION = "payment_links";

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FINOPS_INVOICES_COLLECTION = exports.FINOPS_TAKERS_COLLECTION = exports.FINOPS_SERVICES_COLLECTION = exports.FINOPS_DICS_SERVICES_ID = exports.FINOPS_ISSUER_PROFILES_COLLECTION = exports.FINOPS_DICS_ISSUERS_ID = exports.FINOPS_PROVIDERS_COLLECTION = exports.FINOPS_DICS_COLLECTION = exports.EVO_FINOPS_APP = void 0;
+exports.FINOPS_PAYMENT_LINKS_COLLECTION = exports.FINOPS_INVOICES_COLLECTION = exports.FINOPS_TAKERS_COLLECTION = exports.FINOPS_SERVICES_COLLECTION = exports.FINOPS_DICS_SERVICES_ID = exports.FINOPS_ISSUER_PROFILES_COLLECTION = exports.FINOPS_DICS_ISSUERS_ID = exports.FINOPS_PROVIDERS_COLLECTION = exports.FINOPS_DICS_COLLECTION = exports.EVO_FINOPS_APP = void 0;
 // evo-finops app identifier for Firestore paths
 exports.EVO_FINOPS_APP = "evo-finops";
 // Collection names for evo-finops
@@ -16,3 +16,4 @@ exports.FINOPS_DICS_SERVICES_ID = "services";
 exports.FINOPS_SERVICES_COLLECTION = "services";
 exports.FINOPS_TAKERS_COLLECTION = "takers";
 exports.FINOPS_INVOICES_COLLECTION = "invoices";
+exports.FINOPS_PAYMENT_LINKS_COLLECTION = "payment_links";

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

@@ -14,4 +14,5 @@ export const FINOPS_DICS_SERVICES_ID = "services";
 export const FINOPS_SERVICES_COLLECTION = "services";
 export const FINOPS_TAKERS_COLLECTION = "takers";
 export const FINOPS_INVOICES_COLLECTION = "invoices";
+export const FINOPS_PAYMENT_LINKS_COLLECTION = "payment_links";
 

package/dist/types/evo-finops/payment-links/index.d.ts

@@ -1,5 +1,15 @@
 import type { IFireDoc, IExternalLink } from "../../shared";
 import type { IInvoiceTakerRef } from "../invoices";
+export declare const EvoFinopsPaymentLinkPermissions: {
+    readonly List: "evo_finops_payment_link_read";
+    readonly Get: "evo_finops_payment_link_read";
+    readonly Create: "evo_finops_payment_link_write";
+    readonly Update: "evo_finops_payment_link_write";
+    readonly Delete: "evo_finops_payment_link_write";
+    readonly AddExternalLink: "evo_finops_payment_link_write";
+    readonly RemoveExternalLink: "evo_finops_payment_link_write";
+};
+export type EvoFinopsPaymentLinkPermissions = (typeof EvoFinopsPaymentLinkPermissions)[keyof typeof EvoFinopsPaymentLinkPermissions];
 /** Asaas `billingType` for payment links */
 export declare enum AsaasPaymentLinkBillingTypeEnum {
     UNDEFINED = "UNDEFINED",
@@ -83,3 +93,5 @@ export interface IPaymentLink extends IFireDoc {
     }>;
     [key: string]: unknown;
 }
+/** Alias semântico para uso em evo-finops (tenant-scoped). Mesma forma de IPaymentLink. */
+export type IEvoFinopsPaymentLink = IPaymentLink;

package/dist/types/evo-finops/payment-links/index.js

@@ -1,7 +1,17 @@
 "use strict";
-// Nexus / FinOps — Payment links (Asaas) persisted in Firestore
+// FinOps — Payment links (Asaas) persisted in Firestore
+// Shared between nex-finops (cross-tenant) and evo-finops (tenant-scoped).
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PaymentLinkDocumentStateEnum = exports.AsaasPaymentLinkSubscriptionCycleEnum = exports.AsaasPaymentLinkChargeTypeEnum = exports.AsaasPaymentLinkBillingTypeEnum = void 0;
+exports.PaymentLinkDocumentStateEnum = exports.AsaasPaymentLinkSubscriptionCycleEnum = exports.AsaasPaymentLinkChargeTypeEnum = exports.AsaasPaymentLinkBillingTypeEnum = exports.EvoFinopsPaymentLinkPermissions = void 0;
+exports.EvoFinopsPaymentLinkPermissions = {
+    List: "evo_finops_payment_link_read",
+    Get: "evo_finops_payment_link_read",
+    Create: "evo_finops_payment_link_write",
+    Update: "evo_finops_payment_link_write",
+    Delete: "evo_finops_payment_link_write",
+    AddExternalLink: "evo_finops_payment_link_write",
+    RemoveExternalLink: "evo_finops_payment_link_write",
+};
 /** Asaas `billingType` for payment links */
 var AsaasPaymentLinkBillingTypeEnum;
 (function (AsaasPaymentLinkBillingTypeEnum) {

package/dist/types/evo-finops/payment-links/index.ts

@@ -1,8 +1,22 @@
-// Nexus / FinOps — Payment links (Asaas) persisted in Firestore
+// FinOps — Payment links (Asaas) persisted in Firestore
+// Shared between nex-finops (cross-tenant) and evo-finops (tenant-scoped).
 
 import type { IFireDoc, IExternalLink } from "../../shared";
 import type { IInvoiceTakerRef } from "../invoices";
 
+export const EvoFinopsPaymentLinkPermissions = {
+  List: "evo_finops_payment_link_read",
+  Get: "evo_finops_payment_link_read",
+  Create: "evo_finops_payment_link_write",
+  Update: "evo_finops_payment_link_write",
+  Delete: "evo_finops_payment_link_write",
+  AddExternalLink: "evo_finops_payment_link_write",
+  RemoveExternalLink: "evo_finops_payment_link_write",
+} as const;
+
+export type EvoFinopsPaymentLinkPermissions =
+  (typeof EvoFinopsPaymentLinkPermissions)[keyof typeof EvoFinopsPaymentLinkPermissions];
+
 /** Asaas `billingType` for payment links */
 export enum AsaasPaymentLinkBillingTypeEnum {
   UNDEFINED = "UNDEFINED",
@@ -101,3 +115,6 @@ export interface IPaymentLink extends IFireDoc {
 
   [key: string]: unknown;
 }
+
+/** Alias semântico para uso em evo-finops (tenant-scoped). Mesma forma de IPaymentLink. */
+export type IEvoFinopsPaymentLink = IPaymentLink;

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

@@ -1,13 +1,20 @@
-/** Fase de avaliação. `pre_llm` roda antes do orchestrator;
- *  `post_llm` está reservado (não implementado nesta entrega). */
+/** 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). */
 export type IHubiaRulePhase = "pre_llm" | "post_llm";
-/** Gatilho que dispara a avaliação. */
+/** 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";
 /** Desfecho do turno após a regra disparar:
- *  - `stop`                — finaliza turno sem chamar o LLM.
- *  - `to_llm`              — segue para o orchestrator normalmente.
+ *  - `stop`                — finaliza turno; em pre_llm pula o LLM,
+ *                            em post_llm bloqueia o envio outbound (único
+ *                            outcome permitido em post_llm).
+ *  - `to_llm`              — segue para o orchestrator normalmente
+ *                            (apenas pre_llm).
  *  - `to_llm_with_context` — segue para o orchestrator com trace das ações
- *                            injetado como bloco de sistema.
+ *                            injetado como bloco de sistema (apenas 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";
@@ -95,11 +102,13 @@ export interface IHubiaRule {
     priority?: number;
     /** Default: "pre_llm". */
     phase?: IHubiaRulePhase;
-    /** Default: "inbound_message" (compatível com `phase: pre_llm`). */
+    /** Default: "inbound_message" (compatível com `phase: pre_llm`).
+     *  Para `phase: post_llm`, precisa ser "llm_completed" (zod superRefine). */
     when?: IHubiaRuleTrigger;
     scope?: IHubiaRuleScope;
     conditions: IHubiaConditionGroup;
     actions: IHubiaRuleAction[];
+    /** Para `phase: post_llm`, único valor permitido é "stop" (zod superRefine). */
     outcome: IHubiaRuleOutcome;
     /** Shadow mode por regra (característica permanente, não só de rollout):
      *  avalia + grava trace, mas NÃO executa as actions. Permite canário de

package/dist/types/evo-hub-ia/v1/index.js

@@ -1,5 +1,5 @@
 "use strict";
-// Tipos da camada evo-hubia-rules (motor determinístico pré-LLM).
+// Tipos da camada evo-hubia-rules (motor determinístico de regras).
 // Schemas zod correspondentes ficam em src/apps/evo-hub-ia/v1/zod-schemas.ts;
 // estes tipos são escritos à mão e mantidos em paralelo (convenção do projeto:
 // `apps/` = zod, `types/` = interfaces TS).

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

@@ -1,4 +1,4 @@
-// Tipos da camada evo-hubia-rules (motor determinístico pré-LLM).
+// Tipos da camada evo-hubia-rules (motor determinístico de regras).
 // Schemas zod correspondentes ficam em src/apps/evo-hub-ia/v1/zod-schemas.ts;
 // estes tipos são escritos à mão e mantidos em paralelo (convenção do projeto:
 // `apps/` = zod, `types/` = interfaces TS).
@@ -7,18 +7,25 @@
 
 // ── Enums / Literals ──
 
-/** Fase de avaliação. `pre_llm` roda antes do orchestrator;
- *  `post_llm` está reservado (não implementado nesta entrega). */
+/** 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). */
 export type IHubiaRulePhase = "pre_llm" | "post_llm";
 
-/** Gatilho que dispara a avaliação. */
+/** 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";
 
 /** Desfecho do turno após a regra disparar:
- *  - `stop`                — finaliza turno sem chamar o LLM.
- *  - `to_llm`              — segue para o orchestrator normalmente.
+ *  - `stop`                — finaliza turno; em pre_llm pula o LLM,
+ *                            em post_llm bloqueia o envio outbound (único
+ *                            outcome permitido em post_llm).
+ *  - `to_llm`              — segue para o orchestrator normalmente
+ *                            (apenas pre_llm).
  *  - `to_llm_with_context` — segue para o orchestrator com trace das ações
- *                            injetado como bloco de sistema.
+ *                            injetado como bloco de sistema (apenas 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";
@@ -138,12 +145,14 @@ export interface IHubiaRule {
 
   /** Default: "pre_llm". */
   phase?: IHubiaRulePhase;
-  /** Default: "inbound_message" (compatível com `phase: pre_llm`). */
+  /** Default: "inbound_message" (compatível com `phase: pre_llm`).
+   *  Para `phase: post_llm`, precisa ser "llm_completed" (zod superRefine). */
   when?: IHubiaRuleTrigger;
 
   scope?: IHubiaRuleScope;
   conditions: IHubiaConditionGroup;
   actions: IHubiaRuleAction[];
+  /** Para `phase: post_llm`, único valor permitido é "stop" (zod superRefine). */
   outcome: IHubiaRuleOutcome;
 
   /** Shadow mode por regra (característica permanente, não só de rollout):

package/dist/types/evo-med/appointment/index.d.ts

@@ -79,6 +79,15 @@ export interface IAppointmentPaymentInvoiceRef {
     /** Indica se a invoice foi enviada ao contato (ex.: via evo-chat/WhatsApp) */
     evo_chat_sent?: boolean;
 }
+/** Origem da quitação do pagamento (ex.: link de pagamento Asaas via webhook). */
+export interface IAppointmentPaymentPaidVia {
+    kind: "payment_link" | "manual" | "pix" | "boleto";
+    payment_link_id?: string;
+    asaas_payment_id?: string;
+    event?: string;
+    received_at?: string;
+    raw_status?: string;
+}
 export interface IAppointmentPayment {
     total?: number | null;
     paid?: number | null;
@@ -87,6 +96,12 @@ export interface IAppointmentPayment {
     payment_type: PaymentType;
     /** Correspondência com invoices do evo-finops (NFSe) vinculadas a este pagamento */
     invoices?: IAppointmentPaymentInvoiceRef[];
+    /** Quando o pagamento foi marcado como pago (ISO 8601 ou Date). */
+    paid_at?: string | Date;
+    /** Origem da quitação (payment_link Asaas, manual, etc.). */
+    paid_via?: IAppointmentPaymentPaidVia | null;
+    /** Método/canal de pagamento livre (ex.: 'payment_link', 'cash', 'card_terminal'). */
+    payment_method?: string;
     metadata?: Record<string, unknown>;
     [key: string]: unknown;
 }