evo360-types 1.3.651 → 1.3.656

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

@@ -8,3 +8,64 @@ export const EvoBillingPermissions = {
 
 export type EvoBillingPermissions =
   (typeof EvoBillingPermissions)[keyof typeof EvoBillingPermissions];
+
+// ── Métodos de pagamento no portal (feat-253 fatia 9) ──
+//
+// Projeção do `payment_methods` para o cliente. PCI/escopo: só bandeira + últimos 4.
+// Sem id do método, `cus_`, `pay_`/`sub_` ou token.
+
+export type EvoBillingPortalPaymentMethodKind = 'asaas_card_token' | 'asaas_subscription';
+export type EvoBillingPortalPaymentMethodStatus = 'active' | 'failing' | 'inactive' | 'revoked';
+
+export interface IEvoBillingPortalPaymentMethodContract {
+  contract_id: string;
+  name: string | null;
+  /** O contrato cobra neste método por padrão. */
+  is_default: boolean;
+}
+
+export interface IEvoBillingPortalPaymentMethod {
+  /** Chave opaca só para a lista (não é o id do método). */
+  key: string;
+  kind: EvoBillingPortalPaymentMethodKind;
+  status: EvoBillingPortalPaymentMethodStatus;
+  brand: string | null;
+  last4: string | null;
+  /** Contratos do cliente que usam este método. */
+  contracts: IEvoBillingPortalPaymentMethodContract[];
+}
+
+/** Cobrança que o "Cadastrar/trocar cartão" usaria agora (ou null: aguarda a próxima). */
+export interface IEvoBillingPortalCardCaptureTarget {
+  billing_id: string;
+  contract_id: string | null;
+  competency_key: string | null;
+  value: number;
+  due_date: string | null;
+}
+
+export interface IEvoBillingPortalPaymentMethodsResponse {
+  ok: true;
+  items: IEvoBillingPortalPaymentMethod[];
+  /** O cadastro de cartão pelo portal está ligado no ambiente atual. */
+  capture_enabled: boolean;
+  capture_target: IEvoBillingPortalCardCaptureTarget | null;
+}
+
+export interface IEvoBillingPortalCardCaptureResponse {
+  ok: true;
+  billing_id: string;
+  invoice_url: string;
+  value: number;
+  due_date: string;
+  reused: boolean;
+}
+
+export type EvoBillingPortalCardCaptureErrorCode =
+  | 'no_open_billing'
+  | 'card_capture_unavailable'
+  | 'customer_document_missing'
+  | 'taker_without_remote_customer'
+  | 'preview_changed'
+  | 'already_paid'
+  | 'internal';

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

@@ -288,8 +288,17 @@ 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";
@@ -496,6 +505,71 @@ export interface ICsqTriageDecision {
     mode: CsqTriageMode;
     reasons: CsqTriageReason[];
 }
+/** 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 {
@@ -818,4 +892,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/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/evo-finops/common/billing.d.ts

@@ -137,6 +137,12 @@ export interface INexFinopsBillingCardCharge {
     /** Provider/ambiente onde o `pay_` foi criado. */
     provider_id?: string | null;
     env?: 'sandbox' | 'production' | null;
+    /**
+     * feat-253 fatia 9: quem gerou a fatura de captura. `portal` = o próprio cliente pediu
+     * "Cadastrar/trocar cartão" → o cartão capturado vira o padrão do contrato. Ausente/`nexus`
+     * = regra da F2b (habilita só em contrato sem método; senão fica como sugestão).
+     */
+    capture_origin?: 'nexus' | 'portal' | null;
 }
 export type NexFinopsBillingCardCaptureStatus = 'captured' | 'no_token' | 'skipped';
 export interface INexFinopsBilling extends IFireGlobalDoc {

package/dist/types/evo-finops/common/billing.ts

@@ -168,6 +168,12 @@ export interface INexFinopsBillingCardCharge {
   /** Provider/ambiente onde o `pay_` foi criado. */
   provider_id?: string | null;
   env?: 'sandbox' | 'production' | null;
+  /**
+   * feat-253 fatia 9: quem gerou a fatura de captura. `portal` = o próprio cliente pediu
+   * "Cadastrar/trocar cartão" → o cartão capturado vira o padrão do contrato. Ausente/`nexus`
+   * = regra da F2b (habilita só em contrato sem método; senão fica como sugestão).
+   */
+  capture_origin?: 'nexus' | 'portal' | null;
 }
 
 export type NexFinopsBillingCardCaptureStatus = 'captured' | 'no_token' | 'skipped';

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.651",
+  "version": "1.3.656",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",