@trii/types 2.10.754 → 2.10.756

package/dist/Conversations/Conversation.d.ts

@@ -1,5 +1,6 @@
 import { UserInfo } from "../Users/UserTrii";
 import type { ConversationReadState } from './ConversationReadState';
+import type { ConversationAutomationState } from './ConversationAutomationState';
 import type { ConversationPendingTransfer } from './ConversationPendingTransfer';
 import type { ConversationSlaSnapshot, ConversationSlaStatus } from './ConversationSlaClockState';
 import { ILabel } from "./Label";
@@ -65,9 +66,22 @@ export interface IConversation {
     archived: boolean;
     spam: boolean;
     externalMessagingWindowEndAt?: Date;
+    /**
+     * Automatización que controla la conversación; null si no hay ejecución registrada.
+     * Actualizar con control de version y executionId para rechazar eventos antiguos.
+     */
+    automation?: ConversationAutomationState | null;
+    /** @deprecated Id de ejecución legacy. Usar automation.executionId. */
     workflowId?: string;
+    /** @deprecated Usar automation.status; con automation presente no controla SLA. */
     botStatus: ConversationBotStatus;
-    botVars: ConversationBotVar[];
+    /**
+     * Datos relevantes para atender esta conversación, de solo lectura en el CRM.
+     * No almacena variables internas del flujo ni reemplaza datos de Contact.
+     * Cada key es única: publicar nuevamente la misma clave actualiza el dato.
+     * Se conservan al finalizar la automatización.
+     */
+    contextFields: ConversationContextField[];
     metadata: IConversationMetadata;
     /** Domain objects discussed or served by this conversation. */
     finalizedOnWebChat: Date;
@@ -146,6 +160,7 @@ export interface IConversationMetadata {
     sessionId?: string;
     screenResolution?: string;
 }
+/** @deprecated Estado legacy. Usar ConversationAutomationStatus para ejecuciones nuevas. */
 export declare enum ConversationBotStatus {
     NONE = 0,
     WAITING = 1,
@@ -153,9 +168,18 @@ export declare enum ConversationBotStatus {
     FINALIZED = 4,
     CANCELED = 5
 }
-export interface ConversationBotVar {
-    title: string;
+/** Dato publicado explícitamente para la atención de la conversación. */
+export interface ConversationContextField {
+    /** Clave estable y única dentro de la conversación. Ejemplo: motivo_consulta. */
+    key: string;
+    /** Etiqueta visible para el usuario del CRM. */
+    label: string;
+    /** Valor de texto preparado para mostrar. */
     value: string;
+    /** Fecha UTC de la última actualización del dato. */
+    updatedAt: Date;
+    /** Ejecución que lo publicó; null para otro origen. Se conserva al terminar o cambiar la ejecución. */
+    automationExecutionId?: string | null;
 }
 /**
  * @deprecated Legacy channel assignment configuration. Use QueueRoutingConfig.

package/dist/Conversations/Conversation.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConversationStatus = exports.AssignMethod = exports.ConversationDirection = exports.ConversationBotStatus = void 0;
+/** @deprecated Estado legacy. Usar ConversationAutomationStatus para ejecuciones nuevas. */
 var ConversationBotStatus;
 (function (ConversationBotStatus) {
     ConversationBotStatus[ConversationBotStatus["NONE"] = 0] = "NONE";

package/dist/Conversations/ConversationAutomationState.d.ts

@@ -0,0 +1,27 @@
+export type ConversationAutomationStatus = 'running' | 'completed' | 'cancelled' | 'failed';
+/**
+ * Automatización que controla la conversación, como máximo una a la vez.
+ * No representa tareas auxiliares en segundo plano ni su historial.
+ * running incluye esperas internas y reintentos; failed significa fallo terminal.
+ */
+export interface ConversationAutomationState {
+    /**
+     * Id de ejecución (WorkFlow.id), no de definición del flujo.
+     * Una ejecución nueva reemplaza este objeto con otro executionId.
+     * Eventos de otra ejecución no pueden modificar el estado ni reanudar sus SLA.
+     */
+    workflowId: string;
+    /**
+     * Solo running pausa SLA humanos de respuesta. completed incluye la derivación efectiva
+     * a un humano. Ningún estado terminal finaliza por sí solo la conversación.
+     */
+    status: ConversationAutomationStatus;
+    /** Fecha efectiva UTC en que tomó el control, no la recepción del evento. */
+    startedAt: Date;
+    /**
+     * Null mientras running; obligatoria en estados terminales y no anterior a startedAt.
+     * Fecha efectiva UTC de devolución del control. Conservar el objeto terminal hasta
+     * la siguiente ejecución permite reconocer eventos atrasados.
+     */
+    endedAt?: Date | null;
+}

package/dist/Conversations/ConversationAutomationState.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/Conversations/ConversationSlaClockState.d.ts

@@ -14,6 +14,8 @@ export interface ConversationSlaClockState {
     policyId: string;
     policyVersion: number;
     startedByEventId: string;
+    /** Ordinal del ingreso que inició el reloj. */
+    startedByIncomingSequence?: number | null;
     startedByMessageId?: string | null;
     assignmentId?: string | null;
     startedAt: Date;
@@ -22,6 +24,13 @@ export interface ConversationSlaClockState {
     warningAt?: Date | null;
     /** Current pause only; clear on resume. */
     pausedAt?: Date | null;
+    /**
+     * Causas activas, no historial. Un reloj pendiente permanece paused mientras alguna sea true.
+     * Actualizar con status, pausedAt, deadlines y resumen en la misma escritura.
+     * Completar/cancelar limpia las causas. Un paused legacy sin causas requiere migración;
+     * no asumir pausa de automatización ni reanudarlo automáticamente.
+     */
+    pauseReasons: ConversationSlaPauseReasons;
     /** Chargeable seconds through elapsedCalculatedAt, within JS safe integer range. */
     elapsedSeconds: number;
     /** Accounting watermark; on resume reset to resume time preserving consumed seconds. */
@@ -30,8 +39,24 @@ export interface ConversationSlaClockState {
     completedAt?: Date | null;
     cancelledAt?: Date | null;
 }
+/** Las causas pueden coexistir; cada operación agrega o retira únicamente la suya. */
+export interface ConversationSlaPauseReasons {
+    /** Se retira solo por una reanudación manual autorizada. */
+    manual: boolean;
+    /** La política pauseOnStatuses exige pausa en el estado actual de Conversation. */
+    conversationStatus: boolean;
+    /**
+     * Solo first_response/next_response mientras automation.status sea running,
+     * incluidos relojes que nacen durante la ejecución. Al terminar, retirar esta causa
+     * conservando ciclo, consumo y breachedAt, aunque onResume sea restart.
+     * Si queda otra causa, continúa pausado. No afecta assignment/acceptance/resolution.
+     */
+    automation: boolean;
+}
 /** Summary updated atomically with clocks; never an independent state source. */
 export interface ConversationSlaSnapshot {
+    /** Mayor cursor atendido por un ACK humano; independiente de lectura. */
+    humanResponseThroughSequence?: number;
     /** Precedence: breached, active warning, running, paused, met, cancelled, none. */
     status: ConversationSlaStatus;
     /** Earliest unfinished/unpaused deadline. Compare against UTC even if evaluator lags. */

package/dist/Conversations/Sla.d.ts

@@ -135,7 +135,13 @@ export interface PublishConversationSlaPolicyVersionRequest {
     definition: ConversationSlaPolicyDefinitionInput;
 }
 export type ConversationSlaClockAction = 'start' | 'evaluate' | 'pause' | 'resume' | 'complete' | 'recalculate' | 'cancel';
-export type ConversationSlaClockReason = 'conversation_created' | 'conversation_enqueued' | 'customer_message' | 'agent_response' | 'assignment_changed' | 'status_changed' | 'queue_transfer' | 'conversation_reopened' | 'deadline_due' | 'policy_override';
+export type ConversationSlaClockReason = 'conversation_created' | 'conversation_enqueued' | 'customer_message'
+/** Solo respuesta humana aceptada por el proveedor; IA, flujos y notas internas no califican. */
+ | 'agent_response' | 'assignment_changed' | 'status_changed' | 'queue_transfer' | 'conversation_reopened' | 'deadline_due' | 'policy_override'
+/** La ejecución toma control; pausa solo first_response/next_response. */
+ | 'automation_started'
+/** Fin, cancelación, fallo terminal o derivación; retira solo la pausa de automatización. */
+ | 'automation_finished';
 /**
  * Idempotent input for the conversation-sla-worker.
  * policyId/policyVersion identify the immutable policy snapshot to apply.
@@ -152,6 +158,12 @@ export interface SlaClockCommand {
     policyId: ID;
     policyVersion: number;
     queueId?: ID;
+    /**
+     * Obligatorio para automation_started/automation_finished; null para otros motivos.
+     * Debe coincidir con Conversation.automation.executionId; descartar eventos de otra ejecución.
+     * occurredAt es la fecha efectiva del cambio; el fin conserva el tiempo SLA consumido.
+     */
+    automationExecutionId?: ID | null;
     occurredAt: Date;
     requestedAt: Date;
 }

package/dist/Conversations/index.d.ts

@@ -2,6 +2,7 @@ export * as Flows from './Flows/index';
 export * as Groups from './Groups/Group';
 export * from './Assignment';
 export * from './Conversation';
+export * from './ConversationAutomationState';
 export * from './InboxQueries';
 export * from './ConversationReadState';
 export * from './ConversationPendingTransfer';

package/dist/Conversations/index.js

@@ -41,6 +41,7 @@ exports.Flows = __importStar(require("./Flows/index"));
 exports.Groups = __importStar(require("./Groups/Group"));
 __exportStar(require("./Assignment"), exports);
 __exportStar(require("./Conversation"), exports);
+__exportStar(require("./ConversationAutomationState"), exports);
 __exportStar(require("./InboxQueries"), exports);
 __exportStar(require("./ConversationReadState"), exports);
 __exportStar(require("./ConversationPendingTransfer"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trii/types",
-  "version": "2.10.754",
+  "version": "2.10.756",
   "description": "Types definitions for Trii projects - ",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",