evo360-types 1.3.637 → 1.3.644

package/dist/apps/evo-finops/zod-schemas.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zProviderInvoiceLinksSchema = exports.zServiceTaxInfoSchema = exports.zServiceLineItemSchema = exports.zServiceInvoiceStateSchema = exports.zProviderServiceInvoiceStatusSchema = exports.zExternalLinkSchema = exports.zExternalObjectTypeSchema = exports.zInvoiceSourceRefSchema = exports.zInvoiceSourceTypeSchema = exports.zInvoiceTakerRefSchema = exports.zInvoiceTakerSnapshotSchema = exports.zInvoiceTakerSnapshotAddressSchema = exports.zTakerDocumentSchema = exports.zTakerTaxProfileSchema = exports.zTakerProviderRefsSchema = exports.zTakerAddressSchema = exports.zInvoiceTakerTypeSchema = exports.zServiceSchema = exports.zCustomerServiceTaxInfoSchema = exports.zIssuerTaxProfileSchema = exports.zIssuerNfseConfigSchema = exports.zIssuerMunicipalCredentialsRefSchema = exports.zIssuerTaxRegimeSchema = exports.zIssuerCompanyIdentitySchema = exports.zIssuerCompanyAddressSchema = exports.zTaxProfileSyncStateSchema = exports.zAsaasProviderSchema = exports.zAsaasProviderAsaasBlockSchema = exports.zAsaasProviderCapabilitiesSchema = exports.zAsaasPaymentsCapabilitiesSchema = exports.zAsaasNfseCapabilitiesSchema = exports.zAsaasEnvAuthConfigSchema = exports.zAsaasSubaccountInputSchema = exports.zAsaasAccountScopeSchema = exports.zAsaasWebhookConfigSchema = exports.zRetryPolicySchema = exports.zAsaasWebhookEventSchema = exports.zAsaasAccountScopeModeSchema = exports.zProviderRemoteRefsSchema = exports.zProviderFiscalInfoPayloadSchema = exports.zProviderCredentialsInputSchema = exports.zProviderCredentialsSecretRefsSchema = exports.zProviderMunicipalOptionsSnapshotSchema = exports.zProviderOptionItemSchema = exports.zProviderMunicipalAuthTypeSchema = exports.zFinopsProviderBaseSchema = exports.zProviderStatusSchema = exports.zFinopsActionSchema = exports.zFinopsProviderTypeSchema = exports.zProviderEnvSchema = void 0;
-exports.zNexFinopsContractAllowancesWriteSchema = exports.zNexFinopsUsageAlertDefaultsSchema = exports.zNexFinopsAlertThresholdSchema = exports.zNexFinopsContractAllowancesSchema = exports.zNexFinopsContractAllowanceSchema = exports.zNexVendasJourneyPaymentSchema = exports.zNexVendasJourneyPaymentSupersededSchema = exports.zNexVendasJourneyPaymentWebhookEventSchema = exports.zNexVendasJourneyBoletoSchema = exports.zNexVendasJourneyPaymentChooseSchema = exports.zNexVendasJourneyPaymentStateSchema = exports.zNexVendasJourneyPaymentKindSchema = exports.zNexVendasJourneyPaymentMethodSchema = exports.zNexFinopsContractAsaasInfoSchema = exports.zNexFinopsAsaasSubscriptionStatusSchema = exports.zNexFinopsPaymentMethodSchema = exports.zNexFinopsProposalSchema = exports.zNexFinopsProposalWriteSchema = exports.zNexFinopsProposalPrefillSchema = exports.zNexFinopsProposalLoyaltyPeriodSchema = exports.zNexFinopsProposalPaymentMethodSchema = exports.zNexFinopsProposalStatusSchema = exports.zServiceInvoiceSchema = exports.zPaymentLinkSchema = exports.zPaymentLinkDocumentStateSchema = exports.zAsaasPaymentLinkSubscriptionCycleSchema = exports.zAsaasPaymentLinkChargeTypeSchema = exports.zAsaasPaymentLinkBillingTypeSchema = exports.zProviderPayloadSnapshotSchema = exports.zProviderTraceSchema = exports.zProviderInvoiceErrorSchema = exports.zProviderInvoiceIdentifiersSchema = void 0;
+exports.zServiceTaxInfoSchema = exports.zServiceLineItemSchema = exports.zServiceInvoiceStateSchema = exports.zProviderServiceInvoiceStatusSchema = exports.zExternalLinkSchema = exports.zExternalObjectTypeSchema = exports.zInvoiceSourceRefSchema = exports.zInvoiceSourceTypeSchema = exports.zInvoiceTakerRefSchema = exports.zInvoiceTakerSnapshotSchema = exports.zInvoiceTakerSnapshotAddressSchema = exports.zTakerDocumentSchema = exports.zTakerTaxProfileSchema = exports.zTakerProviderRefsSchema = exports.zTakerAddressSchema = exports.zInvoiceTakerTypeSchema = exports.zServiceSchema = exports.zCustomerServiceTaxInfoSchema = exports.zIssuerTaxProfileSchema = exports.zIssuerNfseConfigSchema = exports.zIssuerMunicipalCredentialsRefSchema = exports.zIssuerTaxRegimeSchema = exports.zIssuerCompanyIdentitySchema = exports.zIssuerCompanyAddressSchema = exports.zTaxProfileSyncStateSchema = exports.zAsaasProviderSchema = exports.zAsaasProviderAsaasBlockSchema = exports.zAsaasProviderCapabilitiesSchema = exports.zAsaasPaymentsCapabilitiesSchema = exports.zAsaasEnvFlagSchema = exports.zAsaasNfseCapabilitiesSchema = exports.zAsaasEnvAuthConfigSchema = exports.zAsaasSubaccountInputSchema = exports.zAsaasAccountScopeSchema = exports.zAsaasWebhookConfigSchema = exports.zRetryPolicySchema = exports.zAsaasWebhookEventSchema = exports.zAsaasAccountScopeModeSchema = exports.zProviderRemoteRefsSchema = exports.zProviderFiscalInfoPayloadSchema = exports.zProviderCredentialsInputSchema = exports.zProviderCredentialsSecretRefsSchema = exports.zProviderMunicipalOptionsSnapshotSchema = exports.zProviderOptionItemSchema = exports.zProviderMunicipalAuthTypeSchema = exports.zFinopsProviderBaseSchema = exports.zProviderStatusSchema = exports.zFinopsActionSchema = exports.zFinopsProviderTypeSchema = exports.zProviderEnvSchema = void 0;
+exports.zNexFinopsPaymentMethodsDiscoverSchema = exports.zNexFinopsBillingCardChargeSchema = exports.zNexFinopsContractPaymentMethodsWriteSchema = exports.zNexFinopsPaymentMethodPatchSchema = exports.zNexFinopsPaymentMethodStatusSchema = exports.zNexFinopsPaymentMethodKindSchema = exports.zNexFinopsContractAllowancesWriteSchema = exports.zNexFinopsUsageAlertDefaultsSchema = exports.zNexFinopsAlertThresholdSchema = exports.zNexFinopsContractAllowancesSchema = exports.zNexFinopsContractAllowanceSchema = exports.zNexVendasJourneyPaymentSchema = exports.zNexVendasJourneyPaymentSupersededSchema = exports.zNexVendasJourneyPaymentWebhookEventSchema = exports.zNexVendasJourneyBoletoSchema = exports.zNexVendasJourneyPaymentChooseSchema = exports.zNexVendasJourneyPaymentStateSchema = exports.zNexVendasJourneyPaymentKindSchema = exports.zNexVendasJourneyPaymentMethodSchema = exports.zNexFinopsContractAsaasInfoSchema = exports.zNexFinopsAsaasSubscriptionStatusSchema = exports.zNexFinopsPaymentMethodSchema = exports.zNexFinopsProposalSchema = exports.zNexFinopsProposalWriteSchema = exports.zNexFinopsProposalPrefillSchema = exports.zNexFinopsProposalLoyaltyPeriodSchema = exports.zNexFinopsProposalPaymentMethodSchema = exports.zNexFinopsProposalStatusSchema = exports.zServiceInvoiceSchema = exports.zPaymentLinkSchema = exports.zPaymentLinkDocumentStateSchema = exports.zAsaasPaymentLinkSubscriptionCycleSchema = exports.zAsaasPaymentLinkChargeTypeSchema = exports.zAsaasPaymentLinkBillingTypeSchema = exports.zProviderPayloadSnapshotSchema = exports.zProviderTraceSchema = exports.zProviderInvoiceErrorSchema = exports.zProviderInvoiceIdentifiersSchema = exports.zProviderInvoiceLinksSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../shared/zod-schemas");
 // ---- Provider enums and base ----
@@ -233,8 +233,18 @@ exports.zAsaasNfseCapabilitiesSchema = zod_1.z.object({
     allow_avulsa: zod_1.z.boolean(),
     allow_linked_to_payment: zod_1.z.boolean(),
 });
+exports.zAsaasEnvFlagSchema = zod_1.z
+    .object({
+    sandbox: zod_1.z.boolean().optional(),
+    production: zod_1.z.boolean().optional(),
+})
+    .strip();
 exports.zAsaasPaymentsCapabilitiesSchema = zod_1.z.object({
     enabled: zod_1.z.boolean(),
+    /** feat-253 — kill-switch do caminho A. */
+    card_subscription_adjust: exports.zAsaasEnvFlagSchema.optional(),
+    /** feat-253 — flag do caminho B (token). */
+    card_token: exports.zAsaasEnvFlagSchema.optional(),
 });
 exports.zAsaasProviderCapabilitiesSchema = zod_1.z.object({
     nfse: exports.zAsaasNfseCapabilitiesSchema,
@@ -913,3 +923,52 @@ exports.zNexFinopsContractAllowancesWriteSchema = zod_1.z
     alert_thresholds: zod_1.z.array(exports.zNexFinopsAlertThresholdSchema).optional().nullable(),
 })
     .strip();
+// ---- Nexus FinOps — métodos de pagamento do cliente (feat-253) ----
+//
+// PCI: todos `.strip()`. Nenhum schema aceita número de cartão, CCV, dados do
+// portador ou token — chave desconhecida é descartada antes de chegar ao use case.
+exports.zNexFinopsPaymentMethodKindSchema = zod_1.z.enum([
+    "asaas_subscription",
+    "asaas_card_token",
+]);
+exports.zNexFinopsPaymentMethodStatusSchema = zod_1.z.enum([
+    "active",
+    "failing",
+    "inactive",
+    "revoked",
+]);
+/** `PATCH /payment-methods/:id` — o operador só renomeia ou liga/desliga. */
+exports.zNexFinopsPaymentMethodPatchSchema = zod_1.z
+    .object({
+    label: zod_1.z.string().max(120).optional().nullable(),
+    status: zod_1.z.enum(["active", "inactive"]).optional(),
+})
+    .strip();
+/** `PUT /contracts/:id/payment-methods` — rota dedicada (o PUT genérico ignora estes campos). */
+exports.zNexFinopsContractPaymentMethodsWriteSchema = zod_1.z
+    .object({
+    payment_method_ids: zod_1.z.array(zod_1.z.string().min(1).max(128)).max(10),
+    default_payment_method_id: zod_1.z.string().min(1).max(128).optional().nullable(),
+})
+    .strip();
+/** `POST /billings/:id/card-charge` (F2/F3). */
+exports.zNexFinopsBillingCardChargeSchema = zod_1.z
+    .object({
+    action: zod_1.z.enum(["preview", "adjust", "revert", "charge_now"]),
+    expected_value: zod_1.z.number(),
+    asaas_payment_id: zod_1.z.string().min(1).max(128).optional(),
+    confirm: zod_1.z.boolean().optional(),
+})
+    .strip();
+/** `POST /payment-methods/discover` — sem `confirm` é dry-run. */
+exports.zNexFinopsPaymentMethodsDiscoverSchema = zod_1.z
+    .object({
+    customer_id: zod_1.z.string().min(1).max(128).optional(),
+    confirm: zod_1.z
+        .object({
+        payment_method_ids: zod_1.z.array(zod_1.z.string().min(1).max(128)).max(500),
+    })
+        .strip()
+        .optional(),
+})
+    .strip();

package/dist/apps/evo-finops/zod-schemas.ts

@@ -247,8 +247,19 @@ export const zAsaasNfseCapabilitiesSchema = z.object({
   allow_linked_to_payment: z.boolean(),
 });
 
+export const zAsaasEnvFlagSchema = z
+  .object({
+    sandbox: z.boolean().optional(),
+    production: z.boolean().optional(),
+  })
+  .strip();
+
 export const zAsaasPaymentsCapabilitiesSchema = z.object({
   enabled: z.boolean(),
+  /** feat-253 — kill-switch do caminho A. */
+  card_subscription_adjust: zAsaasEnvFlagSchema.optional(),
+  /** feat-253 — flag do caminho B (token). */
+  card_token: zAsaasEnvFlagSchema.optional(),
 });
 
 export const zAsaasProviderCapabilitiesSchema = z.object({
@@ -1001,3 +1012,59 @@ export const zNexFinopsContractAllowancesWriteSchema = z
     alert_thresholds: z.array(zNexFinopsAlertThresholdSchema).optional().nullable(),
   })
   .strip();
+
+// ---- Nexus FinOps — métodos de pagamento do cliente (feat-253) ----
+//
+// PCI: todos `.strip()`. Nenhum schema aceita número de cartão, CCV, dados do
+// portador ou token — chave desconhecida é descartada antes de chegar ao use case.
+
+export const zNexFinopsPaymentMethodKindSchema = z.enum([
+  "asaas_subscription",
+  "asaas_card_token",
+]);
+
+export const zNexFinopsPaymentMethodStatusSchema = z.enum([
+  "active",
+  "failing",
+  "inactive",
+  "revoked",
+]);
+
+/** `PATCH /payment-methods/:id` — o operador só renomeia ou liga/desliga. */
+export const zNexFinopsPaymentMethodPatchSchema = z
+  .object({
+    label: z.string().max(120).optional().nullable(),
+    status: z.enum(["active", "inactive"]).optional(),
+  })
+  .strip();
+
+/** `PUT /contracts/:id/payment-methods` — rota dedicada (o PUT genérico ignora estes campos). */
+export const zNexFinopsContractPaymentMethodsWriteSchema = z
+  .object({
+    payment_method_ids: z.array(z.string().min(1).max(128)).max(10),
+    default_payment_method_id: z.string().min(1).max(128).optional().nullable(),
+  })
+  .strip();
+
+/** `POST /billings/:id/card-charge` (F2/F3). */
+export const zNexFinopsBillingCardChargeSchema = z
+  .object({
+    action: z.enum(["preview", "adjust", "revert", "charge_now"]),
+    expected_value: z.number(),
+    asaas_payment_id: z.string().min(1).max(128).optional(),
+    confirm: z.boolean().optional(),
+  })
+  .strip();
+
+/** `POST /payment-methods/discover` — sem `confirm` é dry-run. */
+export const zNexFinopsPaymentMethodsDiscoverSchema = z
+  .object({
+    customer_id: z.string().min(1).max(128).optional(),
+    confirm: z
+      .object({
+        payment_method_ids: z.array(z.string().min(1).max(128)).max(500),
+      })
+      .strip()
+      .optional(),
+  })
+  .strip();

package/dist/apps/evo-hub-ia/v1/zod-schemas.d.ts

@@ -2341,6 +2341,22 @@ export declare const zAiBindingSchema: z.ZodObject<{
     /** CSQ 2.0 — off (default) | shadow (avalia, não notifica) | active.
      *  Ausente equivale a `off`: o gate do pipeline só segue com `shadow`/`active`. */
     csq_mode: z.ZodOptional<z.ZodEnum<["off", "shadow", "active"]>>;
+    /** feat-226: conexão do juiz do CSQ (`/platform/evo-csq/llm-connections/{id}`).
+     *  `null`/ausente = default da plataforma. Independente do `llm_connection_id`
+     *  da HubIA: o juiz e o atendimento escolhem modelo por motivos diferentes. */
+    csq_judge_connection_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** feat-226: tokens do juiz contam no consumo do tenant. Só vale com
+     *  `csq_mode: 'active'`; em `shadow` nunca cobra. Ausente = `false`. */
+    csq_billable: z.ZodOptional<z.ZodBoolean>;
+    /** feat-226: texto só do juiz, fora de `prompt_overrides` para a HubIA nunca
+     *  o ler. Entra no prompt do juiz depois do roteiro, com a mesma precedência. */
+    csq_prompts: z.ZodOptional<z.ZodObject<{
+        policy_addendum: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        policy_addendum?: string | undefined;
+    }, {
+        policy_addendum?: string | undefined;
+    }>>;
     /** Conexão do catálogo da plataforma (`/platform/evo-ai/llm-connections/{id}`,
      *  com `hubia` em `usable_for`) usada neste departamento. Vence o
      *  `llm_connection_id` do canal. `null`/ausente = herda do canal. */
@@ -3091,6 +3107,22 @@ export declare const zAiBindingSchema: z.ZodObject<{
     /** CSQ 2.0 — off (default) | shadow (avalia, não notifica) | active.
      *  Ausente equivale a `off`: o gate do pipeline só segue com `shadow`/`active`. */
     csq_mode: z.ZodOptional<z.ZodEnum<["off", "shadow", "active"]>>;
+    /** feat-226: conexão do juiz do CSQ (`/platform/evo-csq/llm-connections/{id}`).
+     *  `null`/ausente = default da plataforma. Independente do `llm_connection_id`
+     *  da HubIA: o juiz e o atendimento escolhem modelo por motivos diferentes. */
+    csq_judge_connection_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** feat-226: tokens do juiz contam no consumo do tenant. Só vale com
+     *  `csq_mode: 'active'`; em `shadow` nunca cobra. Ausente = `false`. */
+    csq_billable: z.ZodOptional<z.ZodBoolean>;
+    /** feat-226: texto só do juiz, fora de `prompt_overrides` para a HubIA nunca
+     *  o ler. Entra no prompt do juiz depois do roteiro, com a mesma precedência. */
+    csq_prompts: z.ZodOptional<z.ZodObject<{
+        policy_addendum: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        policy_addendum?: string | undefined;
+    }, {
+        policy_addendum?: string | undefined;
+    }>>;
     /** Conexão do catálogo da plataforma (`/platform/evo-ai/llm-connections/{id}`,
      *  com `hubia` em `usable_for`) usada neste departamento. Vence o
      *  `llm_connection_id` do canal. `null`/ausente = herda do canal. */
@@ -3841,6 +3873,22 @@ export declare const zAiBindingSchema: z.ZodObject<{
     /** CSQ 2.0 — off (default) | shadow (avalia, não notifica) | active.
      *  Ausente equivale a `off`: o gate do pipeline só segue com `shadow`/`active`. */
     csq_mode: z.ZodOptional<z.ZodEnum<["off", "shadow", "active"]>>;
+    /** feat-226: conexão do juiz do CSQ (`/platform/evo-csq/llm-connections/{id}`).
+     *  `null`/ausente = default da plataforma. Independente do `llm_connection_id`
+     *  da HubIA: o juiz e o atendimento escolhem modelo por motivos diferentes. */
+    csq_judge_connection_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** feat-226: tokens do juiz contam no consumo do tenant. Só vale com
+     *  `csq_mode: 'active'`; em `shadow` nunca cobra. Ausente = `false`. */
+    csq_billable: z.ZodOptional<z.ZodBoolean>;
+    /** feat-226: texto só do juiz, fora de `prompt_overrides` para a HubIA nunca
+     *  o ler. Entra no prompt do juiz depois do roteiro, com a mesma precedência. */
+    csq_prompts: z.ZodOptional<z.ZodObject<{
+        policy_addendum: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        policy_addendum?: string | undefined;
+    }, {
+        policy_addendum?: string | undefined;
+    }>>;
     /** Conexão do catálogo da plataforma (`/platform/evo-ai/llm-connections/{id}`,
      *  com `hubia` em `usable_for`) usada neste departamento. Vence o
      *  `llm_connection_id` do canal. `null`/ausente = herda do canal. */

package/dist/apps/evo-hub-ia/v1/zod-schemas.js

@@ -371,6 +371,18 @@ exports.zAiBindingSchema = zod_schemas_1.zFireDocSchema.extend({
     /** CSQ 2.0 — off (default) | shadow (avalia, não notifica) | active.
      *  Ausente equivale a `off`: o gate do pipeline só segue com `shadow`/`active`. */
     csq_mode: zod_schemas_2.zCsqModeSchema.optional(),
+    /** feat-226: conexão do juiz do CSQ (`/platform/evo-csq/llm-connections/{id}`).
+     *  `null`/ausente = default da plataforma. Independente do `llm_connection_id`
+     *  da HubIA: o juiz e o atendimento escolhem modelo por motivos diferentes. */
+    csq_judge_connection_id: zod_1.z.string().nullable().optional(),
+    /** feat-226: tokens do juiz contam no consumo do tenant. Só vale com
+     *  `csq_mode: 'active'`; em `shadow` nunca cobra. Ausente = `false`. */
+    csq_billable: zod_1.z.boolean().optional(),
+    /** feat-226: texto só do juiz, fora de `prompt_overrides` para a HubIA nunca
+     *  o ler. Entra no prompt do juiz depois do roteiro, com a mesma precedência. */
+    csq_prompts: zod_1.z.object({
+        policy_addendum: zod_1.z.string().max(4000).optional(),
+    }).optional(),
     // ───── LLM (feat-210) ─────
     /** Conexão do catálogo da plataforma (`/platform/evo-ai/llm-connections/{id}`,
      *  com `hubia` em `usable_for`) usada neste departamento. Vence o

package/dist/apps/evo-hub-ia/v1/zod-schemas.ts

@@ -417,6 +417,18 @@ export const zAiBindingSchema = zFireDocSchema.extend({
   /** CSQ 2.0 — off (default) | shadow (avalia, não notifica) | active.
    *  Ausente equivale a `off`: o gate do pipeline só segue com `shadow`/`active`. */
   csq_mode: zCsqModeSchema.optional(),
+  /** feat-226: conexão do juiz do CSQ (`/platform/evo-csq/llm-connections/{id}`).
+   *  `null`/ausente = default da plataforma. Independente do `llm_connection_id`
+   *  da HubIA: o juiz e o atendimento escolhem modelo por motivos diferentes. */
+  csq_judge_connection_id: z.string().nullable().optional(),
+  /** feat-226: tokens do juiz contam no consumo do tenant. Só vale com
+   *  `csq_mode: 'active'`; em `shadow` nunca cobra. Ausente = `false`. */
+  csq_billable: z.boolean().optional(),
+  /** feat-226: texto só do juiz, fora de `prompt_overrides` para a HubIA nunca
+   *  o ler. Entra no prompt do juiz depois do roteiro, com a mesma precedência. */
+  csq_prompts: z.object({
+    policy_addendum: z.string().max(4000).optional(),
+  }).optional(),
 
   // ───── LLM (feat-210) ─────
   /** Conexão do catálogo da plataforma (`/platform/evo-ai/llm-connections/{id}`,

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

@@ -58,12 +58,12 @@ export type CsqReviewVerdict = "agree" | "disagree";
 /** Fase do pipeline: `f0` = so indicadores + alertas deterministicos;
  *  `f1` = com o juiz LLM. */
 export type CsqPhase = "f0" | "f1";
-/** De onde veio a conexao de LLM do juiz (feat-191 §2.3), na ordem de
- *  resolucao: `tenant` (`judge_connection_id`), `legacy_channel`
- *  (`channel_config.csq_judge_model`), `platform_default`, `constant`; e
- *  `kill_switch` quando `/platform/evo-csq.llm.transport_kill_switch` forca a
- *  Anthropic direta. */
-export type CsqLlmConnectionSource = "tenant" | "legacy_channel" | "platform_default" | "constant" | "kill_switch";
+/** De onde veio a conexao de LLM do juiz. Desde a feat-226 a ordem e
+ *  `binding` (`csq_judge_connection_id` do binding da HubIA),
+ *  `platform_default`, `constant`; e `kill_switch` quando
+ *  `/platform/evo-csq.llm.transport_kill_switch` forca a Anthropic direta.
+ *  `tenant` e `legacy_channel` so aparecem em laudos anteriores a feat-226. */
+export type CsqLlmConnectionSource = "binding" | "tenant" | "legacy_channel" | "platform_default" | "constant" | "kill_switch";
 /** Autor de uma mensagem da transcricao entregue ao juiz. */
 export type CsqAuthorKind = "lead" | "human" | "automation" | "hubia" | "event" | "note";
 /** Codigos de alerta v1. Os subtipos de `POLITICA_VIOLADA` e
@@ -414,9 +414,39 @@ export interface ICsqReview {
     /** Fingerprints dos alertas marcados como falso positivo. */
     false_alert_fingerprints: string[];
     note?: string;
+    /** feat-206 F5: alertas que o juiz deixou de dar (falso negativo). Dado de
+     *  calibracao: nao vira alerta nem altera o laudo. */
+    missed_alerts?: ICsqReviewMissedAlert[];
+    /** feat-206 F5: criterios em que o supervisor discorda da nota do juiz. */
+    criteria_disagreements?: ICsqReviewCriterionDisagreement[];
     reviewer_login_id: string;
     reviewed_at: Date;
 }
+/** Alerta que faltou no laudo, segundo o supervisor (feat-206 F5). */
+export interface ICsqReviewMissedAlert {
+    code: CsqAlertCode;
+    /** Severidade que o supervisor acha que deveria ter. */
+    severity?: CsqSeverity;
+    /** Onde aconteceu; ausente = o ticket avaliado. */
+    ticket_id?: string;
+    /** Obrigatoria e curta (ate `CSQ_REVIEW_LIMITS.note_max_chars`). */
+    note: string;
+}
+/** Discordancia de nota de um criterio da rubrica (feat-206 F5). */
+export interface ICsqReviewCriterionDisagreement {
+    /** `code` do criterio na rubrica (mesmo de `ICsqCriterionScore.criterion`). */
+    criterion: string;
+    /** Nota que o supervisor esperava. */
+    expected: CsqCriterionScore;
+    note?: string;
+}
+/** Tetos da revisao validados pelo backend (feat-206 F5). */
+export declare const CSQ_REVIEW_LIMITS: {
+    /** Maximo de itens em `missed_alerts` e em `criteria_disagreements`. */
+    readonly max_items: 10;
+    /** Maximo de caracteres de cada nota de item. */
+    readonly note_max_chars: 300;
+};
 /** Modo decidido pela triagem deterministica antes do prompt. Os modos
  *  intermediarios ficam para a F3/F4. */
 export type CsqTriageMode = "skip_llm" | "full_review";

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_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_RUBRIC_VERSION = void 0;
 __exportStar(require("./fb_collections"), exports);
 // ───────── Versao da rubrica ─────────
 /** Versao da rubrica da plataforma gravada em cada avaliacao. Pesos e criterios
@@ -193,3 +193,10 @@ exports.CSQ_DEFAULTS = {
     /** Atraso da rechecagem agendada da agenda (minutos apos closed_at). */
     recheck_delay_min: 30,
 };
+/** Tetos da revisao validados pelo backend (feat-206 F5). */
+exports.CSQ_REVIEW_LIMITS = {
+    /** Maximo de itens em `missed_alerts` e em `criteria_disagreements`. */
+    max_items: 10,
+    /** Maximo de caracteres de cada nota de item. */
+    note_max_chars: 300,
+};

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

@@ -102,12 +102,13 @@ export type CsqReviewVerdict = "agree" | "disagree";
  *  `f1` = com o juiz LLM. */
 export type CsqPhase = "f0" | "f1";
 
-/** De onde veio a conexao de LLM do juiz (feat-191 §2.3), na ordem de
- *  resolucao: `tenant` (`judge_connection_id`), `legacy_channel`
- *  (`channel_config.csq_judge_model`), `platform_default`, `constant`; e
- *  `kill_switch` quando `/platform/evo-csq.llm.transport_kill_switch` forca a
- *  Anthropic direta. */
+/** De onde veio a conexao de LLM do juiz. Desde a feat-226 a ordem e
+ *  `binding` (`csq_judge_connection_id` do binding da HubIA),
+ *  `platform_default`, `constant`; e `kill_switch` quando
+ *  `/platform/evo-csq.llm.transport_kill_switch` forca a Anthropic direta.
+ *  `tenant` e `legacy_channel` so aparecem em laudos anteriores a feat-226. */
 export type CsqLlmConnectionSource =
+  | "binding"
   | "tenant"
   | "legacy_channel"
   | "platform_default"
@@ -659,10 +660,43 @@ export interface ICsqReview {
   /** Fingerprints dos alertas marcados como falso positivo. */
   false_alert_fingerprints: string[];
   note?: string;
+  /** feat-206 F5: alertas que o juiz deixou de dar (falso negativo). Dado de
+   *  calibracao: nao vira alerta nem altera o laudo. */
+  missed_alerts?: ICsqReviewMissedAlert[];
+  /** feat-206 F5: criterios em que o supervisor discorda da nota do juiz. */
+  criteria_disagreements?: ICsqReviewCriterionDisagreement[];
   reviewer_login_id: string;
   reviewed_at: Date;
 }
 
+/** Alerta que faltou no laudo, segundo o supervisor (feat-206 F5). */
+export interface ICsqReviewMissedAlert {
+  code: CsqAlertCode;
+  /** Severidade que o supervisor acha que deveria ter. */
+  severity?: CsqSeverity;
+  /** Onde aconteceu; ausente = o ticket avaliado. */
+  ticket_id?: string;
+  /** Obrigatoria e curta (ate `CSQ_REVIEW_LIMITS.note_max_chars`). */
+  note: string;
+}
+
+/** Discordancia de nota de um criterio da rubrica (feat-206 F5). */
+export interface ICsqReviewCriterionDisagreement {
+  /** `code` do criterio na rubrica (mesmo de `ICsqCriterionScore.criterion`). */
+  criterion: string;
+  /** Nota que o supervisor esperava. */
+  expected: CsqCriterionScore;
+  note?: string;
+}
+
+/** Tetos da revisao validados pelo backend (feat-206 F5). */
+export const CSQ_REVIEW_LIMITS = {
+  /** Maximo de itens em `missed_alerts` e em `criteria_disagreements`. */
+  max_items: 10,
+  /** Maximo de caracteres de cada nota de item. */
+  note_max_chars: 300,
+} as const;
+
 // ───────── Trilha e denormalizacao ─────────
 
 // ───────── Triagem sem LLM (feat-206 F1) ─────────

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

@@ -1,4 +1,5 @@
 import type { IFireGlobalDoc } from '../../shared';
+import type { NexFinopsPaymentMethodKind } from './payment-method';
 export type NexFinopsBillingStatus = 'draft' | 'issued' | 'paid' | 'overdue' | 'canceled';
 export type NexFinopsBillingAttachmentCategory = 'boleto' | 'invoice' | 'other';
 export interface INexFinopsBillingServiceItem {
@@ -28,7 +29,7 @@ export interface INexFinopsBillingBoletoTerms {
     mora_taxa: number;
 }
 export interface INexFinopsBillingPaymentOption {
-    type: 'pix' | 'boleto' | 'payment_link';
+    type: 'pix' | 'boleto' | 'payment_link' | 'credit_card';
     provider_id?: string | null;
     external_id?: string | null;
     url?: string | null;
@@ -63,12 +64,61 @@ export interface INexFinopsBillingAttachment {
     category?: NexFinopsBillingAttachmentCategory;
 }
 export interface INexFinopsBillingPaidVia {
-    kind: 'payment_link' | 'manual' | 'pix' | 'boleto';
+    kind: 'payment_link' | 'manual' | 'pix' | 'boleto' | 'credit_card';
     payment_link_id?: string | null;
     asaas_payment_id?: string | null;
     event?: string | null;
     received_at?: string | null;
     raw_status?: string | null;
+    /** feat-253: método de pagamento (cartão) que liquidou a cobrança. */
+    payment_method_id?: string | null;
+    /** feat-253: degrau do roteamento do webhook de cartão que casou o pagamento. Interno (não vai ao portal). */
+    matched_by?: 'card_payment_id' | 'external_reference' | 'subscription_competency' | null;
+}
+/** Resumo do método herdado — só bandeira e últimos 4 (PCI). */
+export interface INexFinopsBillingPaymentMethodSnapshot {
+    kind: NexFinopsPaymentMethodKind;
+    brand: string | null;
+    last4: string | null;
+    subscription_id?: string | null;
+}
+export type NexFinopsBillingCardChargeMode = 'subscription_adjust'
+/** Contingência A′. */
+ | 'subscription_value_update' | 'token_charge';
+export type NexFinopsBillingCardChargeStatus = 'scheduled' | 'stale' | 'confirmed' | 'refused' | 'refunded' | 'chargeback' | 'canceled' | 'reverted';
+export interface INexFinopsBillingCardChargeHistoryEntry {
+    at: string;
+    by: string | null;
+    action: 'adjust' | 'readjust' | 'revert' | 'charge' | 'event';
+    value?: number | null;
+    event?: string | null;
+}
+export interface INexFinopsBillingCardCharge {
+    mode: NexFinopsBillingCardChargeMode;
+    payment_method_id: string;
+    asaas_payment_id: string;
+    subscription_id?: string | null;
+    /** `dueDate` do `pay_` no Asaas (YYYY-MM-DD). */
+    due_date: string;
+    /** Caminho A: valor antes do ajuste. */
+    value_before?: number | null;
+    /** = `billing.total` no momento do ajuste. */
+    value_after: number;
+    status: NexFinopsBillingCardChargeStatus;
+    raw_status?: string | null;
+    adjusted_at: string;
+    adjusted_by: {
+        kind: 'user' | 'system';
+        id: string | null;
+    };
+    last_event?: string | null;
+    last_event_at?: string | null;
+    failure?: {
+        event: string;
+        description?: string | null;
+    } | null;
+    /** Capado em 30 entradas. */
+    history: INexFinopsBillingCardChargeHistoryEntry[];
 }
 export interface INexFinopsBilling extends IFireGlobalDoc {
     customer_id: string;
@@ -95,6 +145,12 @@ export interface INexFinopsBilling extends IFireGlobalDoc {
     contract_snapshot?: Record<string, unknown> | null;
     customer_snapshot?: Record<string, unknown> | null;
     notes?: string | null;
+    /** Método herdado do `default_payment_method_id` do contrato na geração (ou escolhido depois). */
+    payment_method_id?: string | null;
+    payment_method_snapshot?: INexFinopsBillingPaymentMethodSnapshot | null;
+    /** Todos os `pay_` do Asaas já associados (A e B) — chave do roteamento do webhook. Interno. */
+    card_payment_ids?: string[];
+    card_charge?: INexFinopsBillingCardCharge | null;
 }
 /**
  * Transições permitidas de status de cobrança.

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

@@ -1,4 +1,5 @@
 import type { IFireGlobalDoc } from '../../shared';
+import type { NexFinopsPaymentMethodKind } from './payment-method';
 
 // ── Status ──
 
@@ -42,7 +43,7 @@ export interface INexFinopsBillingBoletoTerms {
 }
 
 export interface INexFinopsBillingPaymentOption {
-  type: 'pix' | 'boleto' | 'payment_link';
+  type: 'pix' | 'boleto' | 'payment_link' | 'credit_card';
   provider_id?: string | null;
   external_id?: string | null;
   url?: string | null;
@@ -80,12 +81,72 @@ export interface INexFinopsBillingAttachment {
 }
 
 export interface INexFinopsBillingPaidVia {
-  kind: 'payment_link' | 'manual' | 'pix' | 'boleto';
+  kind: 'payment_link' | 'manual' | 'pix' | 'boleto' | 'credit_card';
   payment_link_id?: string | null;
   asaas_payment_id?: string | null;
   event?: string | null;
   received_at?: string | null;
   raw_status?: string | null;
+  /** feat-253: método de pagamento (cartão) que liquidou a cobrança. */
+  payment_method_id?: string | null;
+  /** feat-253: degrau do roteamento do webhook de cartão que casou o pagamento. Interno (não vai ao portal). */
+  matched_by?: 'card_payment_id' | 'external_reference' | 'subscription_competency' | null;
+}
+
+// ── Cobrança no cartão (feat-253) ──
+
+/** Resumo do método herdado — só bandeira e últimos 4 (PCI). */
+export interface INexFinopsBillingPaymentMethodSnapshot {
+  kind: NexFinopsPaymentMethodKind;
+  brand: string | null;
+  last4: string | null;
+  subscription_id?: string | null;
+}
+
+export type NexFinopsBillingCardChargeMode =
+  | 'subscription_adjust'
+  /** Contingência A′. */
+  | 'subscription_value_update'
+  | 'token_charge';
+
+export type NexFinopsBillingCardChargeStatus =
+  | 'scheduled'
+  | 'stale'
+  | 'confirmed'
+  | 'refused'
+  | 'refunded'
+  | 'chargeback'
+  | 'canceled'
+  | 'reverted';
+
+export interface INexFinopsBillingCardChargeHistoryEntry {
+  at: string;
+  by: string | null;
+  action: 'adjust' | 'readjust' | 'revert' | 'charge' | 'event';
+  value?: number | null;
+  event?: string | null;
+}
+
+export interface INexFinopsBillingCardCharge {
+  mode: NexFinopsBillingCardChargeMode;
+  payment_method_id: string;
+  asaas_payment_id: string;
+  subscription_id?: string | null;
+  /** `dueDate` do `pay_` no Asaas (YYYY-MM-DD). */
+  due_date: string;
+  /** Caminho A: valor antes do ajuste. */
+  value_before?: number | null;
+  /** = `billing.total` no momento do ajuste. */
+  value_after: number;
+  status: NexFinopsBillingCardChargeStatus;
+  raw_status?: string | null;
+  adjusted_at: string;
+  adjusted_by: { kind: 'user' | 'system'; id: string | null };
+  last_event?: string | null;
+  last_event_at?: string | null;
+  failure?: { event: string; description?: string | null } | null;
+  /** Capado em 30 entradas. */
+  history: INexFinopsBillingCardChargeHistoryEntry[];
 }
 
 // ── Main Document ──
@@ -144,6 +205,15 @@ export interface INexFinopsBilling extends IFireGlobalDoc {
 
   // Observações
   notes?: string | null;
+
+  // ── Cartão (feat-253) ──
+
+  /** Método herdado do `default_payment_method_id` do contrato na geração (ou escolhido depois). */
+  payment_method_id?: string | null;
+  payment_method_snapshot?: INexFinopsBillingPaymentMethodSnapshot | null;
+  /** Todos os `pay_` do Asaas já associados (A e B) — chave do roteamento do webhook. Interno. */
+  card_payment_ids?: string[];
+  card_charge?: INexFinopsBillingCardCharge | null;
 }
 
 // ── Status transitions ──

package/dist/types/evo-finops/common/contract.d.ts

@@ -139,6 +139,14 @@ export interface INexFinopsContract extends IFireGlobalDoc {
     /** Método com que o primeiro pagamento foi feito. `accepted_payment_methods` é a oferta; este é o fato. */
     payment_method?: NexFinopsPaymentMethod | null;
     asaas?: INexFinopsContractAsaasInfo | null;
+    /**
+     * Ids de `payment_methods` do MESMO customer habilitados neste contrato.
+     * Escrito só pela rota dedicada `PUT /contracts/:id/payment-methods`; o
+     * `PUT /contracts/:id` genérico ignora este campo.
+     */
+    payment_method_ids?: string[] | null;
+    /** Precisa estar em `payment_method_ids`. É o que a cobrança herda no `billingGenerate`. */
+    default_payment_method_id?: string | null;
     /**
      * Franquia incluída no ciclo, por métrica. A CHAVE é o id da métrica (ver
      * `NexFinopsMetricCatalog`) e é deliberadamente `string`: métrica nova é um

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

@@ -172,6 +172,17 @@ export interface INexFinopsContract extends IFireGlobalDoc {
   payment_method?: NexFinopsPaymentMethod | null;
   asaas?: INexFinopsContractAsaasInfo | null;
 
+  // ── Métodos de pagamento habilitados (feat-253) ──
+
+  /**
+   * Ids de `payment_methods` do MESMO customer habilitados neste contrato.
+   * Escrito só pela rota dedicada `PUT /contracts/:id/payment-methods`; o
+   * `PUT /contracts/:id` genérico ignora este campo.
+   */
+  payment_method_ids?: string[] | null;
+  /** Precisa estar em `payment_method_ids`. É o que a cobrança herda no `billingGenerate`. */
+  default_payment_method_id?: string | null;
+
   // ── Franquias e alertas de consumo (feat-150 F0) ──
 
   /**