evo360-types 1.3.378 → 1.3.383

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

@@ -13,9 +13,7 @@ export interface IChannelProviderRef {
 export interface ICallDeflectionConfig {
     enabled: boolean;
     mode: 'template' | 'text';
-    template?: {
-        name: string;
-        language: string;
+    template?: ICallHsmTemplateRef & {
         category?: string;
     };
     text?: string;
@@ -23,12 +21,18 @@ export interface ICallDeflectionConfig {
     only_outside_business_hours?: boolean;
     cooldown_minutes?: number;
 }
+/** Referência a HSM aprovado na Meta (nome + idioma + variáveis opcionais). */
+export interface ICallHsmTemplateRef {
+    name: string;
+    language: string;
+    /** Valores do BODY na ordem {{1}}, {{2}}, … Suporta placeholder {{contact_name}}. */
+    body_parameters?: string[];
+    /** Valores do HEADER TEXT na ordem {{1}}, … */
+    header_parameters?: string[];
+}
 export interface ICallOutboundPermissionConfig {
     enabled: boolean;
-    request_template?: {
-        name: string;
-        language: string;
-    };
+    request_template?: ICallHsmTemplateRef;
 }
 export interface ICallsChannelConfig {
     enabled: boolean;

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

@@ -25,20 +25,30 @@ export interface IChannelProviderRef {
 export interface ICallDeflectionConfig {
   enabled: boolean;
   mode: 'template' | 'text';
-  template?: { name: string; language: string; category?: string };
+  template?: ICallHsmTemplateRef & { 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)
 }
 
+/** Referência a HSM aprovado na Meta (nome + idioma + variáveis opcionais). */
+export interface ICallHsmTemplateRef {
+  name: string;
+  language: string;
+  /** Valores do BODY na ordem {{1}}, {{2}}, … Suporta placeholder {{contact_name}}. */
+  body_parameters?: string[];
+  /** Valores do HEADER TEXT na ordem {{1}}, … */
+  header_parameters?: string[];
+}
+
 // 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 };
+  request_template?: ICallHsmTemplateRef;
 }
 
 export interface ICallsChannelConfig {

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

@@ -1,4 +1,15 @@
 export declare const EvoMcpPermissions: {
+    /**
+     * @deprecated desde feat-022 (2026-06-03). Não gateia mais a conexão nem
+     * tools — a conexão passou a exigir Read/WriteLowRisk/WriteHighRisk.
+     * Mantido exportado apenas para compatibilidade com consumidores antigos.
+     */
     readonly Access: "evo_mcp_access";
+    /** Gate de leitura: exigido por toda read tool, junto da perm read do módulo. */
+    readonly Read: "evo_mcp_read";
+    /** Gate de write reversível/baixo blast-radius (criar lead, fechar ticket, etc.). */
+    readonly WriteLowRisk: "evo_mcp_write_low_risk";
+    /** Gate de write com side-effect externo/irreversível (enviar WhatsApp, mover appointment, etc.). */
+    readonly WriteHighRisk: "evo_mcp_write_high_risk";
 };
 export type EvoMcpPermissions = (typeof EvoMcpPermissions)[keyof typeof EvoMcpPermissions];

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

@@ -2,6 +2,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EvoMcpPermissions = void 0;
 // Permissões para o evo-mcp (servidor MCP tenant-level)
+//
+// Modelo de gating (feat-022, reconciliação 2026-06-03):
+//   - Conexão: usuário precisa de Read OU WriteLowRisk OU WriteHighRisk no tenant.
+//   - Read tool:        Read           + perm read do módulo.
+//   - Write low-risk:   WriteLowRisk   + perm write do módulo.
+//   - Write high-risk:  WriteHighRisk  + perm write do módulo.
+//   - Admin (is_admin no JWT) bypassa membership + perms (tenant continua obrigatório).
 exports.EvoMcpPermissions = {
+    /**
+     * @deprecated desde feat-022 (2026-06-03). Não gateia mais a conexão nem
+     * tools — a conexão passou a exigir Read/WriteLowRisk/WriteHighRisk.
+     * Mantido exportado apenas para compatibilidade com consumidores antigos.
+     */
     Access: "evo_mcp_access",
+    /** Gate de leitura: exigido por toda read tool, junto da perm read do módulo. */
+    Read: "evo_mcp_read",
+    /** Gate de write reversível/baixo blast-radius (criar lead, fechar ticket, etc.). */
+    WriteLowRisk: "evo_mcp_write_low_risk",
+    /** Gate de write com side-effect externo/irreversível (enviar WhatsApp, mover appointment, etc.). */
+    WriteHighRisk: "evo_mcp_write_high_risk",
 };

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

@@ -1,6 +1,24 @@
 // Permissões para o evo-mcp (servidor MCP tenant-level)
+//
+// Modelo de gating (feat-022, reconciliação 2026-06-03):
+//   - Conexão: usuário precisa de Read OU WriteLowRisk OU WriteHighRisk no tenant.
+//   - Read tool:        Read           + perm read do módulo.
+//   - Write low-risk:   WriteLowRisk   + perm write do módulo.
+//   - Write high-risk:  WriteHighRisk  + perm write do módulo.
+//   - Admin (is_admin no JWT) bypassa membership + perms (tenant continua obrigatório).
 export const EvoMcpPermissions = {
+  /**
+   * @deprecated desde feat-022 (2026-06-03). Não gateia mais a conexão nem
+   * tools — a conexão passou a exigir Read/WriteLowRisk/WriteHighRisk.
+   * Mantido exportado apenas para compatibilidade com consumidores antigos.
+   */
   Access: "evo_mcp_access",
+  /** Gate de leitura: exigido por toda read tool, junto da perm read do módulo. */
+  Read: "evo_mcp_read",
+  /** Gate de write reversível/baixo blast-radius (criar lead, fechar ticket, etc.). */
+  WriteLowRisk: "evo_mcp_write_low_risk",
+  /** Gate de write com side-effect externo/irreversível (enviar WhatsApp, mover appointment, etc.). */
+  WriteHighRisk: "evo_mcp_write_high_risk",
 } as const;
 
 export type EvoMcpPermissions =

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evo360-types",
-  "version": "1.3.378",
+  "version": "1.3.383",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",