evo360-types 1.3.654 → 1.3.656

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

@@ -501,9 +501,19 @@ export interface ICsqClaimAppointmentInformed {
    *  jornada (o lead cancelou/desistiu, ou foi trocado por outro horario). O
    *  codigo nao exige registro na agenda de um claim assim. */
   superseded?: boolean;
+  /** feat-206 F3: quem extraiu o claim. Ausente = o juiz (laudos anteriores a
+   *  F3 e claim so do juiz). `detector` = so o detector de agenda; `both` = os
+   *  dois (mesma data/hora; a evidencia e a uniao). */
+  source?: CsqClaimSource;
+  /** feat-206 F3: `YYYY-MM-DD|HH:mm` do horario que substituiu este (o
+   *  detector viu um horario confirmado depois). */
+  superseded_by?: string;
   evidence: ICsqEvidence[];
 }
 
+/** feat-206 F3: origem de um claim `appointment_informed`. */
+export type CsqClaimSource = "judge" | "detector" | "both";
+
 /** "Prometi X ate quando". */
 export interface ICsqClaimPromise {
   type: "promise";
@@ -767,6 +777,85 @@ export interface ICsqTriageDecision {
   reasons: CsqTriageReason[];
 }
 
+// ───────── Detector de agenda (feat-206 F3) ─────────
+
+/** Evento canonico de agenda extraido pelo detector (independente do juiz).
+ *  `slot_offered` sozinho nao vira claim: oferta nao aceita nao e agendamento
+ *  informado. */
+export type CsqAppointmentEventKind =
+  | "slot_offered"
+  | "slot_accepted"
+  | "appointment_confirmed"
+  | "reschedule_requested"
+  | "appointment_cancelled";
+
+/** Quem produziu o evento na conversa. */
+export type CsqAppointmentEventActor = "attendant" | "lead" | "hubia" | "automation";
+
+export interface ICsqAppointmentEvent {
+  kind: CsqAppointmentEventKind;
+  /** YYYY-MM-DD absoluto, TZ do tenant. */
+  date?: string;
+  /** HH:mm absoluto, TZ do tenant. */
+  time?: string;
+  professional?: string;
+  patient_name?: string;
+  modality?: string;
+  actor: CsqAppointmentEventActor;
+  /** `message_id`/`ticket_id` do recorte; `ts` sempre do transcript. */
+  evidence: ICsqEvidence[];
+  /** `YYYY-MM-DD|HH:mm` (hora pode faltar: `YYYY-MM-DD|`) do agendamento que
+   *  este evento cancela ou remarca. */
+  supersedes?: string;
+}
+
+/** `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";
+
+/** 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). */
+export interface ICsqDetectorLlm {
+  provider: string;
+  model: string;
+  /** Doc em `llm-connections`; `null` quando sintetica. */
+  connection_id: string | null;
+  /** `extractor` = `extractor_connection_id`; `judge` = conexao do juiz. */
+  connection_source: "extractor" | "judge";
+  input_tokens: number;
+  /** Parte da entrada servida do cache do provedor (OpenAI: prefixo do system). */
+  cache_read_tokens?: number;
+  output_tokens: number;
+  rounds: number;
+  cost_usd_est: number | null;
+  duration_ms: number;
+}
+
+/** Divergencia detector x juiz do laudo (registrada, nao escalada — F4). */
+export interface ICsqDetectorReport {
+  mode: CsqDetectorMode;
+  outcome: CsqDetectorOutcome;
+  /** Mensagens com sinal deterministico (data/hora, confirmacao, desfecho). */
+  signals: number;
+  /** Mensagens no recorte enviado ao extrator (sinais + vizinhanca). */
+  excerpt_messages: number;
+  events: number;
+  claims_detector: number;
+  claims_judge: number;
+  only_detector: number;
+  only_judge: number;
+  superseded_by_detector: number;
+  /** Claims do detector no MESMO dia de um claim do juiz, com outra hora: nao
+   *  entram na verificacao (o juiz manda), so contam. */
+  time_mismatch?: number;
+  /** Eventos extraidos (com evidencia ja validada). */
+  event_list?: ICsqAppointmentEvent[];
+  llm?: ICsqDetectorLlm | null;
+  error?: string;
+}
+
 /** Tamanho de um bloco do prompt do juiz. `tokens_est` e estimativa
  *  deterministica (chars / 3,6), nao contagem do tokenizer. */
 export interface ICsqPromptBlockUsage {
@@ -1127,4 +1216,7 @@ export interface ICsqLeadReport extends IFireDoc {
   /** feat-206: presente quando o ULTIMO ticket nao passou pelo juiz. A avaliacao
    *  (score, pilares, criterios), `model` e `llm_usage` sao do ultimo juiz. */
   judge_skipped_reasons?: CsqTriageReason[];
+  /** feat-206 F3: detector de agenda (contagens e divergencia com o juiz).
+   *  Ausente quando o detector esta `off` ou o laudo e anterior a F3. */
+  detector?: ICsqDetectorReport;
 }

package/dist/types/hub-automation/index.d.ts

@@ -51,6 +51,8 @@ export interface IAutomationAppointmentSelection {
         payment_status_not_in?: string[];
         appointment_mode_in?: string[];
         appointment_mode_not_in?: string[];
+        appointment_type_names?: string[];
+        appointment_type_names_not_in?: string[];
         time_range?: {
             start: string;
             end: string;

package/dist/types/hub-automation/index.ts

@@ -128,6 +128,12 @@ export interface IAutomationAppointmentSelection {
     // wildcard glob (same style as payment_status_in).
     appointment_mode_in?: string[];
     appointment_mode_not_in?: string[];
+
+    // ---- fix-262: free-text type NAME as it shows on the calendar
+    // (`appointmentType`, e.g. "Consulta particular"), complementing the BASE
+    // filter above. Glob-aware like the other name filters.
+    appointment_type_names?: string[];
+    appointment_type_names_not_in?: string[];
     // Local-time window over appointment.startDate, evaluated in the TENANT
     // timezone. Boundaries: `start <= hh:mm < end` (start inclusive, end
     // exclusive) so adjacent ranges (08–12, 12–18) partition the day without

package/package.json

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