evo360-types 1.3.709 → 1.3.713

package/dist/index.js

@@ -57,6 +57,7 @@ __exportStar(require("./types/evo-modules"), exports);
 // zod schemas
 __exportStar(require("./apps/shared/zod-schemas"), exports);
 __exportStar(require("./apps/evo-core/zod-schemas"), exports);
+__exportStar(require("./apps/evo-core/nexus-claims"), exports);
 __exportStar(require("./apps/evo-tenant/zod-schemas"), exports);
 __exportStar(require("./apps/evo-activity/zod-schemas"), exports);
 __exportStar(require("./apps/evo-people/zod-schemas"), exports);

package/dist/index.ts

@@ -42,6 +42,7 @@ export * from "./types/evo-modules";
 // zod schemas
 export * from "./apps/shared/zod-schemas";
 export * from "./apps/evo-core/zod-schemas";
+export * from "./apps/evo-core/nexus-claims";
 export * from "./apps/evo-tenant/zod-schemas";
 export * from "./apps/evo-activity/zod-schemas";
 export * from "./apps/evo-people/zod-schemas";

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

@@ -51,6 +51,9 @@ export interface INexusModuleChatPermissions {
     supervision?: boolean;
     /** Supervisão 2.0 (CSQ). Gate da fila e do laudo do evo-csq no Nexus. */
     csq?: boolean;
+    /** feat-280: administração do CSQ (config de LLM da plataforma e
+     *  reavaliação sob demanda). Só reconhecida pelo MCP do Nexus. */
+    csq_admin?: boolean;
 }
 export interface INexusReports {
 }

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

@@ -62,6 +62,9 @@ export interface INexusModuleChatPermissions {
   supervision?: boolean;
   /** Supervisão 2.0 (CSQ). Gate da fila e do laudo do evo-csq no Nexus. */
   csq?: boolean;
+  /** feat-280: administração do CSQ (config de LLM da plataforma e
+   *  reavaliação sob demanda). Só reconhecida pelo MCP do Nexus. */
+  csq_admin?: boolean;
 }
 
 export interface INexusReports {}

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

@@ -55,6 +55,11 @@ export type CsqRunStatus = "running" | "done" | "failed" | "quarantined";
 export type CsqCriterionScore = 0 | 50 | 100 | "NA";
 /** Veredito humano sobre o laudo (adendo §D / Q9=A). */
 export type CsqReviewVerdict = "agree" | "disagree";
+/** feat-280 (Q6): por onde a revisao entrou. `nexus` = tela Supervisao 2.0;
+ *  `mcp` = conector MCP do Nexus (claude.ai/ChatGPT). Ausente = `nexus` legado.
+ *  A calibracao do juiz pode filtrar por origem. */
+export declare const CSQ_REVIEW_SOURCES: readonly ["nexus", "mcp"];
+export type CsqReviewSource = (typeof CSQ_REVIEW_SOURCES)[number];
 /** Fase do pipeline: `f0` = so indicadores + alertas deterministicos;
  *  `f1` = com o juiz LLM. */
 export type CsqPhase = "f0" | "f1";
@@ -462,6 +467,10 @@ export interface ICsqReview {
     criteria_disagreements?: ICsqReviewCriterionDisagreement[];
     reviewer_login_id: string;
     reviewed_at: Date;
+    /** feat-280: origem da revisao. Ausente = `nexus` (revisoes anteriores). */
+    source?: CsqReviewSource;
+    /** feat-280: `client_id` OAuth do cliente MCP quando `source = 'mcp'`. */
+    client_id?: string;
 }
 /** Alerta que faltou no laudo, segundo o supervisor (feat-206 F5). */
 export interface ICsqReviewMissedAlert {
@@ -530,6 +539,25 @@ export interface ICsqAppointmentEvent {
 /** `off`: nao roda; `shadow`: roda e registra em `report.detector`, sem mexer
  *  nos claims; `on`: os claims do detector entram na verificacao. */
 export type CsqDetectorMode = "off" | "shadow" | "on";
+/** Transporte forcado do juiz (`/platform/evo-csq.llm.transport_kill_switch`). */
+export type CsqTransportKillSwitch = "vertex" | "anthropic_direct";
+/**
+ * Config de LLM da plataforma: `/platform/evo-csq` -> campo `llm` (feat-191,
+ * feat-206 F3). Espelho de `CsqPlatformLlmConfig` do `@evo/csq`. Campo ausente
+ * ou `null` = constante do pacote (conexao) / `off` (detector) / ADC (SA).
+ * feat-280: gravavel pelo MCP do Nexus (claim `chat.csq_admin`), exceto
+ * `service_account` (so leitura).
+ */
+export interface ICsqPlatformLlmConfig {
+    default_connection_id?: string | null;
+    extractor_connection_id?: string | null;
+    detector_mode?: CsqDetectorMode | null;
+    transport_kill_switch?: CsqTransportKillSwitch | null;
+    /** SA que a SA de runtime impersona no Vertex. So leitura pelo MCP. */
+    service_account?: string | null;
+}
+/** Campos de `ICsqPlatformLlmConfig` que o MCP pode gravar. */
+export type ICsqPlatformLlmConfigPatch = Partial<Omit<ICsqPlatformLlmConfig, "service_account">>;
 /** Como terminou a extracao por LLM do detector. */
 export type CsqDetectorOutcome = "no_signal" | "ok" | "failed" | "skipped";
 /** Uso do LLM do extrator (so quando houve chamada). */
@@ -896,3 +924,44 @@ export interface ICsqLeadReport extends IFireDoc {
      *  Ausente quando o detector esta `off` ou o laudo e anterior a F3. */
     detector?: ICsqDetectorReport;
 }
+/**
+ * Pedido de reavaliacao (dry-run) do nex-mcp para o `hubia_csq_dry_run`.
+ * Roda o pipeline com o juiz REAL e grava NADA (laudo, runs, BQ, evo_log do
+ * pipeline, notificacao, rechecagem, `ticket.csq`).
+ */
+export interface ICsqDryRunRequest {
+    tenant: string;
+    ticket_id: string;
+    /** Canal evo-chat do ticket. Ausente = `channel_id` do laudo atual do lead. */
+    channel_id?: string | null;
+    /** Ausente = `lead_id` do ticket. */
+    lead_id?: string | null;
+    /** Conexao do juiz (`llm-connections/{id}`). Ausente = resolucao da producao. */
+    connection_id?: string | null;
+    /** Ignora a triagem sem LLM (`full_review` com motivo `forced`). Default true. */
+    force_review?: boolean;
+    /** Quem pediu (so log/auditoria do lado do hubia). */
+    requested_by?: {
+        login_id: string;
+        client_id?: string | null;
+    } | null;
+}
+/** Resposta do dry-run. `report` vem serializado (datas em ISO). */
+export interface ICsqDryRunResult {
+    /** `CsqRunResult.outcome` do pipeline (ex.: `evaluated`, `skipped_*`). */
+    outcome: string;
+    detail: string | null;
+    evaluation_id: string | null;
+    lead_id: string | null;
+    channel_id: string;
+    /** Laudo capturado (NAO gravado); null quando o pipeline nao chegou a montar. */
+    report: Record<string, unknown> | null;
+    detector: ICsqDetectorReport | null;
+    model: string | null;
+    llm_provider: string | null;
+    llm_connection_id: string | null;
+    llm_connection_source: CsqLlmConnectionSource | null;
+    triage_mode: CsqTriageMode | null;
+    cost_usd_est: number | null;
+    duration_ms: number;
+}

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

@@ -22,7 +22,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CSQ_REVIEW_LIMITS = exports.CSQ_DEFAULTS = exports.CSQ_RUBRIC_V1 = exports.CSQ_AUTO_FAIL_POLICY_SUBTYPES = exports.CSQ_AUTO_FAIL_ALERT_CODES = exports.CSQ_SALES_FLOW_SUBTYPES = exports.CSQ_POLICY_VIOLATION_SUBTYPES = exports.CSQ_ALERT_CODES = exports.CSQ_RUBRIC_VERSION = void 0;
+exports.CSQ_REVIEW_LIMITS = exports.CSQ_DEFAULTS = exports.CSQ_RUBRIC_V1 = exports.CSQ_AUTO_FAIL_POLICY_SUBTYPES = exports.CSQ_AUTO_FAIL_ALERT_CODES = exports.CSQ_SALES_FLOW_SUBTYPES = exports.CSQ_POLICY_VIOLATION_SUBTYPES = exports.CSQ_ALERT_CODES = exports.CSQ_REVIEW_SOURCES = exports.CSQ_RUBRIC_VERSION = void 0;
 __exportStar(require("./fb_collections"), exports);
 // ───────── Versao da rubrica ─────────
 /** Versao da rubrica da plataforma gravada em cada avaliacao. Pesos e criterios
@@ -39,6 +39,10 @@ __exportStar(require("./fb_collections"), exports);
  *  regra generica; familia em horarios vizinhos e esperada; `retorno_apos_vou_verificar` e
  *  `nomes_corretos` com ponderacao) e a SAIDA do juiz ganha `revalidations` e `resolved_alerts`. */
 exports.CSQ_RUBRIC_VERSION = "v1.3";
+/** feat-280 (Q6): por onde a revisao entrou. `nexus` = tela Supervisao 2.0;
+ *  `mcp` = conector MCP do Nexus (claude.ai/ChatGPT). Ausente = `nexus` legado.
+ *  A calibracao do juiz pode filtrar por origem. */
+exports.CSQ_REVIEW_SOURCES = ["nexus", "mcp"];
 // ───────── Catalogo de alertas (report-spec §6) ─────────
 /** Codigos de alerta v1. Os subtipos de `POLITICA_VIOLADA` e
  *  `FLUXO_VENDA_NAO_SEGUIDO` vivem em `ICsqAlert.subtype`, nao como codigos. */

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

@@ -98,6 +98,12 @@ export type CsqCriterionScore = 0 | 50 | 100 | "NA";
 /** Veredito humano sobre o laudo (adendo §D / Q9=A). */
 export type CsqReviewVerdict = "agree" | "disagree";
 
+/** feat-280 (Q6): por onde a revisao entrou. `nexus` = tela Supervisao 2.0;
+ *  `mcp` = conector MCP do Nexus (claude.ai/ChatGPT). Ausente = `nexus` legado.
+ *  A calibracao do juiz pode filtrar por origem. */
+export const CSQ_REVIEW_SOURCES = ["nexus", "mcp"] as const;
+export type CsqReviewSource = (typeof CSQ_REVIEW_SOURCES)[number];
+
 /** Fase do pipeline: `f0` = so indicadores + alertas deterministicos;
  *  `f1` = com o juiz LLM. */
 export type CsqPhase = "f0" | "f1";
@@ -717,6 +723,10 @@ export interface ICsqReview {
   criteria_disagreements?: ICsqReviewCriterionDisagreement[];
   reviewer_login_id: string;
   reviewed_at: Date;
+  /** feat-280: origem da revisao. Ausente = `nexus` (revisoes anteriores). */
+  source?: CsqReviewSource;
+  /** feat-280: `client_id` OAuth do cliente MCP quando `source = 'mcp'`. */
+  client_id?: string;
 }
 
 /** Alerta que faltou no laudo, segundo o supervisor (feat-206 F5). */
@@ -813,6 +823,30 @@ export interface ICsqAppointmentEvent {
  *  nos claims; `on`: os claims do detector entram na verificacao. */
 export type CsqDetectorMode = "off" | "shadow" | "on";
 
+/** Transporte forcado do juiz (`/platform/evo-csq.llm.transport_kill_switch`). */
+export type CsqTransportKillSwitch = "vertex" | "anthropic_direct";
+
+/**
+ * Config de LLM da plataforma: `/platform/evo-csq` -> campo `llm` (feat-191,
+ * feat-206 F3). Espelho de `CsqPlatformLlmConfig` do `@evo/csq`. Campo ausente
+ * ou `null` = constante do pacote (conexao) / `off` (detector) / ADC (SA).
+ * feat-280: gravavel pelo MCP do Nexus (claim `chat.csq_admin`), exceto
+ * `service_account` (so leitura).
+ */
+export interface ICsqPlatformLlmConfig {
+  default_connection_id?: string | null;
+  extractor_connection_id?: string | null;
+  detector_mode?: CsqDetectorMode | null;
+  transport_kill_switch?: CsqTransportKillSwitch | null;
+  /** SA que a SA de runtime impersona no Vertex. So leitura pelo MCP. */
+  service_account?: string | null;
+}
+
+/** Campos de `ICsqPlatformLlmConfig` que o MCP pode gravar. */
+export type ICsqPlatformLlmConfigPatch = Partial<
+  Omit<ICsqPlatformLlmConfig, "service_account">
+>;
+
 /** Como terminou a extracao por LLM do detector. */
 export type CsqDetectorOutcome = "no_signal" | "ok" | "failed" | "skipped";
 
@@ -1220,3 +1254,45 @@ export interface ICsqLeadReport extends IFireDoc {
    *  Ausente quando o detector esta `off` ou o laudo e anterior a F3. */
   detector?: ICsqDetectorReport;
 }
+
+// ───────── Reavaliacao sob demanda (feat-280 F4) ─────────
+
+/**
+ * Pedido de reavaliacao (dry-run) do nex-mcp para o `hubia_csq_dry_run`.
+ * Roda o pipeline com o juiz REAL e grava NADA (laudo, runs, BQ, evo_log do
+ * pipeline, notificacao, rechecagem, `ticket.csq`).
+ */
+export interface ICsqDryRunRequest {
+  tenant: string;
+  ticket_id: string;
+  /** Canal evo-chat do ticket. Ausente = `channel_id` do laudo atual do lead. */
+  channel_id?: string | null;
+  /** Ausente = `lead_id` do ticket. */
+  lead_id?: string | null;
+  /** Conexao do juiz (`llm-connections/{id}`). Ausente = resolucao da producao. */
+  connection_id?: string | null;
+  /** Ignora a triagem sem LLM (`full_review` com motivo `forced`). Default true. */
+  force_review?: boolean;
+  /** Quem pediu (so log/auditoria do lado do hubia). */
+  requested_by?: { login_id: string; client_id?: string | null } | null;
+}
+
+/** Resposta do dry-run. `report` vem serializado (datas em ISO). */
+export interface ICsqDryRunResult {
+  /** `CsqRunResult.outcome` do pipeline (ex.: `evaluated`, `skipped_*`). */
+  outcome: string;
+  detail: string | null;
+  evaluation_id: string | null;
+  lead_id: string | null;
+  channel_id: string;
+  /** Laudo capturado (NAO gravado); null quando o pipeline nao chegou a montar. */
+  report: Record<string, unknown> | null;
+  detector: ICsqDetectorReport | null;
+  model: string | null;
+  llm_provider: string | null;
+  llm_connection_id: string | null;
+  llm_connection_source: CsqLlmConnectionSource | null;
+  triage_mode: CsqTriageMode | null;
+  cost_usd_est: number | null;
+  duration_ms: number;
+}

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

@@ -137,6 +137,28 @@ export interface INotificationAttachment {
     /** Conteúdo em base64. <= 64 KB já codificado. */
     content_base64: string;
 }
+/**
+ * feat-254 B1 — anexo de e-mail por referência a um objeto já no storage.
+ *
+ * O front sobe o arquivo por `POST /media/upload` (hub-waba, devolve
+ * `gcs_uri`) e manda só a referência. O backend aceita apenas
+ * `gs://<bucket de mídia>/tenants/<tenant do envio>/...`, valida tipo/extensão
+ * contra a allowlist do e-mail (a mesma dos anexos recebidos) e aplica
+ * 10 arquivos, 10 MiB por arquivo e o total do canal. Falha vira envio
+ * `failed_final` com `attachment_invalid` ou `attachment_limit_exceeded`.
+ */
+export interface INotificationAttachmentRef {
+    /** Nome apresentado ao destinatário; a extensão precisa casar com `content_type`. */
+    filename: string;
+    /** MIME da allowlist do e-mail. Ex.: 'application/pdf'. */
+    content_type: string;
+    /** Tamanho informado pelo front (o backend confere o tamanho real do objeto). */
+    size_bytes?: number;
+    /** `gs://<bucket>/tenants/<tenant>/...` devolvido pelo upload de mídia. */
+    gcs_uri: string;
+}
+/** Item de `attachments[]` do envio: inline legado OU referência (discriminado por `gcs_uri`). */
+export type INotificationAttachmentInput = INotificationAttachment | INotificationAttachmentRef;
 /** Campos compartilhados pelo conteúdo de email novo e de resposta. */
 interface INotificationEmailContentBase {
     /** Versões textuais do corpo livre. */
@@ -185,9 +207,11 @@ export interface INotificationSendPayload {
     quick_reply_actions?: IQuickReplyActionIntent[];
     /**
      * Anexos (feat-160 R6 / F31). Honrado SÓ no canal de e-mail; ignorado pelos
-     * demais providers. 1 anexo, <= 64 KB em base64 — ver `INotificationAttachment`.
+     * demais providers. Inline: 1 anexo, <= 64 KB em base64 — ver
+     * `INotificationAttachment`. feat-254 B1: no e-mail, até 10 itens por
+     * referência (`INotificationAttachmentRef`, 10 MiB cada, total do canal).
      */
-    attachments?: INotificationAttachment[];
+    attachments?: INotificationAttachmentInput[];
     routine?: {
         id: string;
         version?: number | string;

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

@@ -222,6 +222,30 @@ export interface INotificationAttachment {
   content_base64: string;
 }
 
+/**
+ * feat-254 B1 — anexo de e-mail por referência a um objeto já no storage.
+ *
+ * O front sobe o arquivo por `POST /media/upload` (hub-waba, devolve
+ * `gcs_uri`) e manda só a referência. O backend aceita apenas
+ * `gs://<bucket de mídia>/tenants/<tenant do envio>/...`, valida tipo/extensão
+ * contra a allowlist do e-mail (a mesma dos anexos recebidos) e aplica
+ * 10 arquivos, 10 MiB por arquivo e o total do canal. Falha vira envio
+ * `failed_final` com `attachment_invalid` ou `attachment_limit_exceeded`.
+ */
+export interface INotificationAttachmentRef {
+  /** Nome apresentado ao destinatário; a extensão precisa casar com `content_type`. */
+  filename: string;
+  /** MIME da allowlist do e-mail. Ex.: 'application/pdf'. */
+  content_type: string;
+  /** Tamanho informado pelo front (o backend confere o tamanho real do objeto). */
+  size_bytes?: number;
+  /** `gs://<bucket>/tenants/<tenant>/...` devolvido pelo upload de mídia. */
+  gcs_uri: string;
+}
+
+/** Item de `attachments[]` do envio: inline legado OU referência (discriminado por `gcs_uri`). */
+export type INotificationAttachmentInput = INotificationAttachment | INotificationAttachmentRef;
+
 /** Campos compartilhados pelo conteúdo de email novo e de resposta. */
 interface INotificationEmailContentBase {
   /** Versões textuais do corpo livre. */
@@ -285,9 +309,11 @@ export interface INotificationSendPayload {
 
   /**
    * Anexos (feat-160 R6 / F31). Honrado SÓ no canal de e-mail; ignorado pelos
-   * demais providers. 1 anexo, <= 64 KB em base64 — ver `INotificationAttachment`.
+   * demais providers. Inline: 1 anexo, <= 64 KB em base64 — ver
+   * `INotificationAttachment`. feat-254 B1: no e-mail, até 10 itens por
+   * referência (`INotificationAttachmentRef`, 10 MiB cada, total do canal).
    */
-  attachments?: INotificationAttachment[];
+  attachments?: INotificationAttachmentInput[];
 
   // Optional business context
   routine?: {

package/package.json

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