evo360-types 1.3.711 → 1.3.715

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zCsqAppointmentEventKindSchema = exports.zCsqTriageDecisionSchema = exports.zCsqTriageReasonSchema = exports.zCsqTriageModeSchema = exports.zCsqReviewSchema = exports.zCsqReviewCriterionDisagreementSchema = exports.zCsqReviewMissedAlertSchema = exports.zCsqDataQualitySchema = exports.zCsqCoverageSchema = exports.zCsqContributorSchema = exports.zCsqEvaluationSchema = exports.zCsqPillarScoreSchema = exports.zCsqPillarCoverageSchema = exports.zCsqCriterionScoreSchema = exports.zCsqCrossCheckSchema = exports.zCsqClaimTypeSchema = exports.zCsqClaimSchema = exports.zCsqClaimPriceInformedSchema = exports.zCsqClaimPatientStatusSchema = exports.zCsqClaimFirstConcreteOfferSchema = exports.zCsqClaimQuestionRequiresAnswerSchema = exports.zCsqClaimOutcomeSchema = exports.zCsqClaimRequiredDataSchema = exports.zCsqClaimDataCollectedSchema = exports.zCsqClaimPromiseSchema = exports.zCsqClaimAppointmentInformedSchema = exports.zCsqLeadStateSchema = exports.zCsqLeadStateListFieldSchema = exports.zCsqLeadStateFieldSchema = exports.zCsqIndicatorsSchema = exports.zCsqIndicatorsSetSchema = exports.zCsqAlertSchema = exports.zCsqEvidenceSchema = exports.zCsqAlertSubtypeSchema = exports.zCsqAlertCodeSchema = exports.zCsqPillarCodeSchema = exports.zCsqCriterionScoreValueSchema = exports.zCsqAuthorKindSchema = exports.zCsqReviewVerdictSchema = exports.zCsqLlmConnectionSourceSchema = exports.zCsqPhaseSchema = exports.zCsqRunStatusSchema = exports.zCsqVerificationStateSchema = exports.zCsqAlertResolvedReasonSchema = exports.zCsqAlertLifecycleSchema = exports.zCsqAlertScopeSchema = exports.zCsqAlertSourceSchema = exports.zCsqSeveritySchema = exports.zCsqStatusSchema = exports.zCsqModeSchema = void 0;
-exports.zCsqLeadReportSchema = exports.zCsqRunSchema = exports.zCsqAlertCountsSchema = exports.zCsqEligibilitySchema = exports.zCsqEvaluatedForSchema = exports.zCsqReportHeaderSchema = exports.zCsqReportAttendantSchema = exports.zCsqReportPatientSchema = exports.zCsqReportLeadSchema = exports.zCsqSystemFactsSchema = exports.zCsqBillingFactSchema = exports.zCsqPreviousTicketFactSchema = exports.zCsqOverlapFactSchema = exports.zCsqOverlapFamilyHintsSchema = exports.zCsqOverlapAppointmentFactSchema = exports.zCsqAppointmentFactSchema = exports.zCsqJudgeOutputSchema = exports.zCsqJudgeResolvedAlertSchema = exports.zCsqJudgeRevalidationSchema = exports.zCsqLlmUsageSchema = exports.zCsqTranscriptMessageSchema = exports.zCsqTicketSummarySchema = exports.zCsqTrailEntrySchema = exports.zCsqPromptBlockUsageSchema = exports.zCsqDetectorReportSchema = exports.zCsqDetectorLlmSchema = exports.zCsqDetectorModeSchema = exports.zCsqAppointmentEventSchema = void 0;
+exports.zCsqTriageDecisionSchema = exports.zCsqTriageReasonSchema = exports.zCsqTriageModeSchema = exports.zCsqReviewSchema = exports.zCsqReviewCriterionDisagreementSchema = exports.zCsqReviewMissedAlertSchema = exports.zCsqDataQualitySchema = exports.zCsqCoverageSchema = exports.zCsqContributorSchema = exports.zCsqEvaluationSchema = exports.zCsqPillarScoreSchema = exports.zCsqPillarCoverageSchema = exports.zCsqCriterionScoreSchema = exports.zCsqCrossCheckSchema = exports.zCsqClaimTypeSchema = exports.zCsqClaimSchema = exports.zCsqClaimPriceInformedSchema = exports.zCsqClaimPatientStatusSchema = exports.zCsqClaimFirstConcreteOfferSchema = exports.zCsqClaimQuestionRequiresAnswerSchema = exports.zCsqClaimOutcomeSchema = exports.zCsqClaimRequiredDataSchema = exports.zCsqClaimDataCollectedSchema = exports.zCsqClaimPromiseSchema = exports.zCsqClaimAppointmentInformedSchema = exports.zCsqLeadStateSchema = exports.zCsqLeadStateListFieldSchema = exports.zCsqLeadStateFieldSchema = exports.zCsqIndicatorsSchema = exports.zCsqIndicatorsSetSchema = exports.zCsqAlertSchema = exports.zCsqEvidenceSchema = exports.zCsqAlertSubtypeSchema = exports.zCsqAlertCodeSchema = exports.zCsqPillarCodeSchema = exports.zCsqCriterionScoreValueSchema = exports.zCsqAuthorKindSchema = exports.zCsqReviewSourceSchema = exports.zCsqReviewVerdictSchema = exports.zCsqLlmConnectionSourceSchema = exports.zCsqPhaseSchema = exports.zCsqRunStatusSchema = exports.zCsqVerificationStateSchema = exports.zCsqAlertResolvedReasonSchema = exports.zCsqAlertLifecycleSchema = exports.zCsqAlertScopeSchema = exports.zCsqAlertSourceSchema = exports.zCsqSeveritySchema = exports.zCsqStatusSchema = exports.zCsqModeSchema = void 0;
+exports.zCsqDryRunResultSchema = exports.zCsqDryRunRequestSchema = exports.zCsqLeadReportSchema = exports.zCsqRunSchema = exports.zCsqAlertCountsSchema = exports.zCsqEligibilitySchema = exports.zCsqEvaluatedForSchema = exports.zCsqReportHeaderSchema = exports.zCsqReportAttendantSchema = exports.zCsqReportPatientSchema = exports.zCsqReportLeadSchema = exports.zCsqSystemFactsSchema = exports.zCsqBillingFactSchema = exports.zCsqPreviousTicketFactSchema = exports.zCsqOverlapFactSchema = exports.zCsqOverlapFamilyHintsSchema = exports.zCsqOverlapAppointmentFactSchema = exports.zCsqAppointmentFactSchema = exports.zCsqJudgeOutputSchema = exports.zCsqJudgeResolvedAlertSchema = exports.zCsqJudgeRevalidationSchema = exports.zCsqLlmUsageSchema = exports.zCsqTranscriptMessageSchema = exports.zCsqTicketSummarySchema = exports.zCsqTrailEntrySchema = exports.zCsqPromptBlockUsageSchema = exports.zCsqDetectorReportSchema = exports.zCsqDetectorLlmSchema = exports.zCsqPlatformLlmConfigPatchSchema = exports.zCsqPlatformLlmConfigPatchFieldsSchema = exports.zCsqPlatformLlmConfigSchema = exports.zCsqTransportKillSwitchSchema = exports.zCsqDetectorModeSchema = exports.zCsqAppointmentEventSchema = exports.zCsqAppointmentEventKindSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../shared/zod-schemas");
 // Schemas zod do CSQ 2.0 (feat-154). As interfaces TS equivalentes ficam em
@@ -54,6 +54,8 @@ exports.zCsqLlmConnectionSourceSchema = zod_1.z.enum([
     "kill_switch",
 ]);
 exports.zCsqReviewVerdictSchema = zod_1.z.enum(["agree", "disagree"]);
+/** feat-280: origem da revisao (espelho de `CSQ_REVIEW_SOURCES`). */
+exports.zCsqReviewSourceSchema = zod_1.z.enum(["nexus", "mcp"]);
 exports.zCsqAuthorKindSchema = zod_1.z.enum([
     "lead",
     "human",
@@ -381,6 +383,10 @@ exports.zCsqReviewSchema = zod_1.z.object({
         .optional(),
     reviewer_login_id: zod_1.z.string(),
     reviewed_at: zod_schemas_1.zFirestoreDateSchema,
+    /** feat-280: ausente = `nexus` (revisoes anteriores). */
+    source: exports.zCsqReviewSourceSchema.optional(),
+    /** feat-280: `client_id` OAuth quando `source = 'mcp'`. */
+    client_id: zod_1.z.string().optional(),
 });
 // ───────── Trilha e denormalizacao ─────────
 // ───────── Triagem sem LLM (feat-206 F1) ─────────
@@ -419,6 +425,34 @@ exports.zCsqAppointmentEventSchema = zod_1.z.object({
     supersedes: zod_1.z.string().optional(),
 });
 exports.zCsqDetectorModeSchema = zod_1.z.enum(["off", "shadow", "on"]);
+exports.zCsqTransportKillSwitchSchema = zod_1.z.enum([
+    "vertex",
+    "anthropic_direct",
+]);
+/** feat-280: `/platform/evo-csq.llm` como lido (todos opcionais/nulos). */
+exports.zCsqPlatformLlmConfigSchema = zod_1.z.object({
+    default_connection_id: zod_1.z.string().nullable().optional(),
+    extractor_connection_id: zod_1.z.string().nullable().optional(),
+    detector_mode: exports.zCsqDetectorModeSchema.nullable().optional(),
+    transport_kill_switch: exports.zCsqTransportKillSwitchSchema.nullable().optional(),
+    service_account: zod_1.z.string().nullable().optional(),
+});
+/**
+ * feat-280: patch da config de plataforma gravado pelo MCP do Nexus
+ * (`chat.csq_admin`). `null` = apagar o campo (volta ao default do pacote).
+ * `service_account` NAO entra (so leitura): `.strict()` recusa a chave.
+ */
+exports.zCsqPlatformLlmConfigPatchFieldsSchema = zod_1.z
+    .object({
+    default_connection_id: zod_1.z.string().min(1).nullable().optional(),
+    extractor_connection_id: zod_1.z.string().min(1).nullable().optional(),
+    detector_mode: exports.zCsqDetectorModeSchema.nullable().optional(),
+    transport_kill_switch: exports.zCsqTransportKillSwitchSchema.nullable().optional(),
+})
+    .strict();
+/** Patch completo: campos acima + "ao menos um campo". Para `inputSchema` de
+ *  tool MCP use `zCsqPlatformLlmConfigPatchFieldsSchema.shape`. */
+exports.zCsqPlatformLlmConfigPatchSchema = exports.zCsqPlatformLlmConfigPatchFieldsSchema.refine((v) => Object.keys(v).some((k) => v[k] !== undefined), { message: "Informe ao menos um campo da config de plataforma." });
 exports.zCsqDetectorLlmSchema = zod_1.z.object({
     provider: zod_1.z.string(),
     model: zod_1.z.string(),
@@ -714,3 +748,40 @@ exports.zCsqLeadReportSchema = zod_schemas_1.zFireDocSchema
     detector: exports.zCsqDetectorReportSchema.optional(),
 })
     .passthrough();
+// ───────── Reavaliacao sob demanda (feat-280 F4) ─────────
+/** Contrato nexus -> hubia (`hubia_csq_dry_run`). Ids sem `/` (viram caminho de doc). */
+const zCsqDryRunIdSchema = zod_1.z
+    .string()
+    .min(1)
+    .max(200)
+    .refine((v) => v.indexOf("/") < 0, { message: "id nao pode conter /" });
+exports.zCsqDryRunRequestSchema = zod_1.z
+    .object({
+    tenant: zCsqDryRunIdSchema,
+    ticket_id: zCsqDryRunIdSchema,
+    channel_id: zCsqDryRunIdSchema.nullable().optional(),
+    lead_id: zCsqDryRunIdSchema.nullable().optional(),
+    connection_id: zCsqDryRunIdSchema.nullable().optional(),
+    force_review: zod_1.z.boolean().optional(),
+    requested_by: zod_1.z
+        .object({ login_id: zod_1.z.string().min(1), client_id: zod_1.z.string().nullable().optional() })
+        .nullable()
+        .optional(),
+})
+    .strict();
+exports.zCsqDryRunResultSchema = zod_1.z.object({
+    outcome: zod_1.z.string(),
+    detail: zod_1.z.string().nullable(),
+    evaluation_id: zod_1.z.string().nullable(),
+    lead_id: zod_1.z.string().nullable(),
+    channel_id: zod_1.z.string(),
+    report: zod_1.z.record(zod_1.z.unknown()).nullable(),
+    detector: exports.zCsqDetectorReportSchema.passthrough().nullable(),
+    model: zod_1.z.string().nullable(),
+    llm_provider: zod_1.z.string().nullable(),
+    llm_connection_id: zod_1.z.string().nullable(),
+    llm_connection_source: exports.zCsqLlmConnectionSourceSchema.nullable(),
+    triage_mode: exports.zCsqTriageModeSchema.nullable(),
+    cost_usd_est: zod_1.z.number().nullable(),
+    duration_ms: zod_1.z.number(),
+});

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

@@ -66,6 +66,9 @@ export const zCsqLlmConnectionSourceSchema = z.enum([
 
 export const zCsqReviewVerdictSchema = z.enum(["agree", "disagree"]);
 
+/** feat-280: origem da revisao (espelho de `CSQ_REVIEW_SOURCES`). */
+export const zCsqReviewSourceSchema = z.enum(["nexus", "mcp"]);
+
 export const zCsqAuthorKindSchema = z.enum([
   "lead",
   "human",
@@ -434,6 +437,10 @@ export const zCsqReviewSchema = z.object({
     .optional(),
   reviewer_login_id: z.string(),
   reviewed_at: zFirestoreDateSchema,
+  /** feat-280: ausente = `nexus` (revisoes anteriores). */
+  source: zCsqReviewSourceSchema.optional(),
+  /** feat-280: `client_id` OAuth quando `source = 'mcp'`. */
+  client_id: z.string().optional(),
 });
 
 // ───────── Trilha e denormalizacao ─────────
@@ -482,6 +489,45 @@ export const zCsqAppointmentEventSchema = z.object({
 
 export const zCsqDetectorModeSchema = z.enum(["off", "shadow", "on"]);
 
+export const zCsqTransportKillSwitchSchema = z.enum([
+  "vertex",
+  "anthropic_direct",
+]);
+
+/** feat-280: `/platform/evo-csq.llm` como lido (todos opcionais/nulos). */
+export const zCsqPlatformLlmConfigSchema = z.object({
+  default_connection_id: z.string().nullable().optional(),
+  extractor_connection_id: z.string().nullable().optional(),
+  detector_mode: zCsqDetectorModeSchema.nullable().optional(),
+  transport_kill_switch: zCsqTransportKillSwitchSchema.nullable().optional(),
+  service_account: z.string().nullable().optional(),
+});
+
+/**
+ * feat-280: patch da config de plataforma gravado pelo MCP do Nexus
+ * (`chat.csq_admin`). `null` = apagar o campo (volta ao default do pacote).
+ * `service_account` NAO entra (so leitura): `.strict()` recusa a chave.
+ */
+export const zCsqPlatformLlmConfigPatchFieldsSchema = z
+  .object({
+    default_connection_id: z.string().min(1).nullable().optional(),
+    extractor_connection_id: z.string().min(1).nullable().optional(),
+    detector_mode: zCsqDetectorModeSchema.nullable().optional(),
+    transport_kill_switch: zCsqTransportKillSwitchSchema.nullable().optional(),
+  })
+  .strict();
+
+/** Patch completo: campos acima + "ao menos um campo". Para `inputSchema` de
+ *  tool MCP use `zCsqPlatformLlmConfigPatchFieldsSchema.shape`. */
+export const zCsqPlatformLlmConfigPatchSchema =
+  zCsqPlatformLlmConfigPatchFieldsSchema.refine(
+    (v) =>
+      Object.keys(v).some(
+        (k) => (v as Record<string, unknown>)[k] !== undefined,
+      ),
+    { message: "Informe ao menos um campo da config de plataforma." },
+  );
+
 export const zCsqDetectorLlmSchema = z.object({
   provider: z.string(),
   model: z.string(),
@@ -814,3 +860,44 @@ export const zCsqLeadReportSchema = zFireDocSchema
     detector: zCsqDetectorReportSchema.optional(),
   })
   .passthrough();
+
+// ───────── Reavaliacao sob demanda (feat-280 F4) ─────────
+
+/** Contrato nexus -> hubia (`hubia_csq_dry_run`). Ids sem `/` (viram caminho de doc). */
+const zCsqDryRunIdSchema = z
+  .string()
+  .min(1)
+  .max(200)
+  .refine((v) => v.indexOf("/") < 0, { message: "id nao pode conter /" });
+
+export const zCsqDryRunRequestSchema = z
+  .object({
+    tenant: zCsqDryRunIdSchema,
+    ticket_id: zCsqDryRunIdSchema,
+    channel_id: zCsqDryRunIdSchema.nullable().optional(),
+    lead_id: zCsqDryRunIdSchema.nullable().optional(),
+    connection_id: zCsqDryRunIdSchema.nullable().optional(),
+    force_review: z.boolean().optional(),
+    requested_by: z
+      .object({ login_id: z.string().min(1), client_id: z.string().nullable().optional() })
+      .nullable()
+      .optional(),
+  })
+  .strict();
+
+export const zCsqDryRunResultSchema = z.object({
+  outcome: z.string(),
+  detail: z.string().nullable(),
+  evaluation_id: z.string().nullable(),
+  lead_id: z.string().nullable(),
+  channel_id: z.string(),
+  report: z.record(z.unknown()).nullable(),
+  detector: zCsqDetectorReportSchema.passthrough().nullable(),
+  model: z.string().nullable(),
+  llm_provider: z.string().nullable(),
+  llm_connection_id: z.string().nullable(),
+  llm_connection_source: zCsqLlmConnectionSourceSchema.nullable(),
+  triage_mode: zCsqTriageModeSchema.nullable(),
+  cost_usd_est: z.number().nullable(),
+  duration_ms: z.number(),
+});

package/dist/index.d.ts

@@ -39,6 +39,7 @@ export * from "./types/evo-telemedicine";
 export * from "./types/evo-modules";
 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/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-campaigns/index.d.ts

@@ -227,7 +227,18 @@ export interface ICampaignChannelCounters {
     failed?: number;
     clicked?: number;
     replied?: number;
+    /**
+     * Ticket outcome of sends whose policy asked to close the ticket (F6). Recorded by
+     * the hub-omni at the moment it decides. `kept_open` is the RULE (patient already had
+     * an open ticket — the campaign never ends a live attendance); `close_failed` is a
+     * defect (close attempted, did not happen).
+     */
+    ticket_closed?: number;
+    ticket_kept_open?: number;
+    ticket_close_failed?: number;
 }
+/** What happened to the ticket of a campaign send that asked to close it (F6). */
+export type CampaignTicketOutcome = "closed" | "kept_open" | "close_failed";
 export interface ICampaignCounters {
     raw?: number;
     unique?: number;
@@ -330,6 +341,26 @@ export interface ICampaign extends IFireDoc {
     finished_at?: Date | null;
     cancel_reason?: string | null;
     error_reason?: string | null;
+    /**
+     * Why the campaign is paused, when the SYSTEM paused it (F6 circuit breaker).
+     * `null`/absent on an operator pause and cleared on resume — its presence is what
+     * tells the screen "the platform stopped this, here is the cause".
+     */
+    pause_reason?: ICampaignPauseReason | null;
+}
+/**
+ * System pause (F6). A provider error that fails EVERY recipient the same way
+ * (account payment, account restricted, template paused/disabled, broken media)
+ * stops the dispatch instead of burning the rest of the list.
+ */
+export interface ICampaignPauseReason {
+    kind: "provider_systemic_error";
+    channel: CampaignChannel;
+    error_code: string;
+    error_message?: string | null;
+    /** Recipient whose failure tripped the breaker — the operator can open it. */
+    recipient_id?: string | null;
+    at: Date;
 }
 export type CampaignBucketSourceType = "leads" | "patients" | "appointments" | "csv";
 export interface ICampaignBucketCsvFile {
@@ -417,6 +448,16 @@ export interface ICampaignRecipientChannelState {
     failed_at?: Date | null;
     /** Provider error text that accompanies `failed_at`. */
     error?: string | null;
+    /**
+     * Provider error CODE that accompanies `failed_at` (F6). Kept apart from `error`
+     * because the code is what the operator-facing breakdown groups by and what the
+     * circuit breaker decides on; parsing it back out of the text would be guessing.
+     * String, not number: providers other than Meta do not promise numeric codes.
+     */
+    error_code?: string | null;
+    /** Ticket outcome when the policy asked to close it (F6) — see ICampaignChannelCounters. */
+    ticket_outcome?: CampaignTicketOutcome | null;
+    ticket_id?: string | null;
 }
 /**
  * Why a recipient was kept out. Closed union: every value here HAS a writer in

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

@@ -304,8 +304,20 @@ export interface ICampaignChannelCounters {
   failed?: number;
   clicked?: number;
   replied?: number;
+  /**
+   * Ticket outcome of sends whose policy asked to close the ticket (F6). Recorded by
+   * the hub-omni at the moment it decides. `kept_open` is the RULE (patient already had
+   * an open ticket — the campaign never ends a live attendance); `close_failed` is a
+   * defect (close attempted, did not happen).
+   */
+  ticket_closed?: number;
+  ticket_kept_open?: number;
+  ticket_close_failed?: number;
 }
 
+/** What happened to the ticket of a campaign send that asked to close it (F6). */
+export type CampaignTicketOutcome = "closed" | "kept_open" | "close_failed";
+
 export interface ICampaignCounters {
   raw?: number;
   unique?: number;
@@ -422,6 +434,27 @@ export interface ICampaign extends IFireDoc {
   finished_at?: Date | null;
   cancel_reason?: string | null;
   error_reason?: string | null;
+  /**
+   * Why the campaign is paused, when the SYSTEM paused it (F6 circuit breaker).
+   * `null`/absent on an operator pause and cleared on resume — its presence is what
+   * tells the screen "the platform stopped this, here is the cause".
+   */
+  pause_reason?: ICampaignPauseReason | null;
+}
+
+/**
+ * System pause (F6). A provider error that fails EVERY recipient the same way
+ * (account payment, account restricted, template paused/disabled, broken media)
+ * stops the dispatch instead of burning the rest of the list.
+ */
+export interface ICampaignPauseReason {
+  kind: "provider_systemic_error";
+  channel: CampaignChannel;
+  error_code: string;
+  error_message?: string | null;
+  /** Recipient whose failure tripped the breaker — the operator can open it. */
+  recipient_id?: string | null;
+  at: Date;
 }
 
 // ----- Bucket ---------------------------------------------------------------
@@ -550,6 +583,16 @@ export interface ICampaignRecipientChannelState {
   failed_at?: Date | null;
   /** Provider error text that accompanies `failed_at`. */
   error?: string | null;
+  /**
+   * Provider error CODE that accompanies `failed_at` (F6). Kept apart from `error`
+   * because the code is what the operator-facing breakdown groups by and what the
+   * circuit breaker decides on; parsing it back out of the text would be guessing.
+   * String, not number: providers other than Meta do not promise numeric codes.
+   */
+  error_code?: string | null;
+  /** Ticket outcome when the policy asked to close it (F6) — see ICampaignChannelCounters. */
+  ticket_outcome?: CampaignTicketOutcome | null;
+  ticket_id?: string | null;
 }
 
 /**

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/package.json

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