evo360-types 1.3.376 → 1.3.378

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

@@ -10,22 +10,31 @@
 /** 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";
@@ -34,6 +43,13 @@ export type IHubiaRuleOutcome = "stop" | "to_llm" | "to_llm_with_context";
  *  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
@@ -117,6 +133,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

package/package.json

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