@trii/types 2.10.731 → 2.10.732

package/dist/Common/index.js

@@ -15,23 +15,13 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.QueueEvent = exports.Schedules = exports.Notifications = exports.Messages = exports.Channels = exports.API = void 0;
 exports.API = __importStar(require("./API/index"));

package/dist/Conversations/Conversation.d.ts

@@ -164,7 +164,7 @@ export declare enum ConversationStatus {
     FINALIZED = 3,// Alias for RESOLVED
     WAITING = 10
 }
-export type InboxViewId = 'pending' | 'following' | 'sla_warning' | 'sla_breached' | 'team_sla_breached' | 'resolved';
+export type InboxViewId = 'pending' | 'following' | 'sla_warning' | 'sla_breached' | 'team_sla_breached' | 'resolved' | 'label';
 export type OwnerType = 'user' | 'bot' | 'flow' | 'none';
 export interface NoConversationOwner {
     type: 'none';
@@ -308,7 +308,7 @@ export interface PutConversationReadStateRequest {
 export interface PutConversationPinRequest {
     pinned: boolean;
 }
-export type InboxVisibilityReason = 'manual_follow' | 'assigned_to_user' | 'shared_queue_member' | 'queue_claimable' | 'active_participant' | 'sla_warning_owner' | 'sla_breached_owner' | 'supervised_queue_sla' | 'supervisor_escalation' | 'resolved_visible';
+export type InboxVisibilityReason = 'manual_follow' | 'assigned_to_user' | 'shared_queue_member' | 'queue_claimable' | 'active_participant' | 'sla_warning_owner' | 'sla_breached_owner' | 'supervised_queue_sla' | 'supervisor_escalation' | 'resolved_visible' | 'labeled';
 export interface ConversationInboxSnapshot {
     interactionKind: 'private' | 'wall_post' | 'comment' | 'mention';
     channelType: string;
@@ -331,12 +331,21 @@ export interface ConversationInboxSnapshot {
         deadlineAt?: Date;
     };
     lastActivityAt: Date;
+    labels: {
+        id: ID;
+        name: string;
+        color?: string;
+    }[];
 }
 /**
  * Membership of one materialized conversation in one logical inbox view.
  *
  * visibilityReasons has set semantics: values must be unique and non-empty.
  * Removing one reason preserves the view while at least one reason remains.
+ *
+ * labelId is only populated when viewId is 'label' - identifies which of the
+ * space's labels this particular view entry represents (InboxViewId is a
+ * fixed enum, but labels are dynamic per space).
  */
 export interface UserInboxItemView {
     viewId: InboxViewId;
@@ -345,12 +354,16 @@ export interface UserInboxItemView {
         ...InboxVisibilityReason[]
     ];
     requiresAction: boolean;
+    labelId?: ID;
 }
 /**
  * Materialized read model. There is exactly one document for each
  * spaceId + userId + conversationId tuple.
  *
- * views must contain unique viewId values. Delete the document when the last
+ * views must contain unique viewId values, EXCEPT for viewId='label': a
+ * conversation can carry multiple labels, so multiple entries with
+ * viewId='label' are allowed as long as their labelId differs (unique
+ * (viewId, labelId) pairs for that case). Delete the document when the last
  * view is removed.
  */
 export interface UserInboxItemDocument {
@@ -370,7 +383,8 @@ export interface UserInboxItemDocument {
     projectedAt: Date;
 }
 /**
- * Materialized counters for exactly one user/view pair.
+ * Materialized counters for exactly one user/view pair (user/view/label when
+ * viewId is 'label' - labelId becomes part of the logical key in that case).
  *
  * total and requiresAction count conversations, never visibility reasons.
  * unread counts conversations whose snapshot.unreadCount is greater than zero,
@@ -381,6 +395,7 @@ export interface UserInboxCounterDocument {
     spaceId: ID;
     userId: ID;
     viewId: InboxViewId;
+    labelId?: ID;
     total: number;
     requiresAction: number;
     unread: number;

package/dist/Conversations/index.js

@@ -15,23 +15,13 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 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);
 };

package/dist/index.js

@@ -15,23 +15,13 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Automations = exports.Forms = exports.APIResponses = exports.Shop = exports.AI = exports.APIKeys = exports.Events = exports.EventsQueue = exports.ApiResponses = exports.Presence = exports.Users = exports.Collections = exports.Sales = exports.Tickets = exports.Spaces = exports.Reports = exports.Security = exports.Calls = exports.Conversations = exports.Calendar = exports.Contacts = exports.Common = exports.AuditLogs = exports.Accounts = void 0;
 exports.Accounts = __importStar(require("./Accounts/index"));

package/dist/src/Automations/Capabilities/Capability.d.ts

@@ -4,6 +4,37 @@ export declare enum AutomationCapabilityKind {
     ACTION = "action",
     CONDITION = "condition"
 }
+export declare enum AutomationCapabilityEffectClass {
+    NONE = "none",
+    READ = "read",
+    WRITE = "write",
+    COMMUNICATION = "communication",
+    BULK = "bulk"
+}
+export declare enum AutomationCapabilityIdempotency {
+    NONE = "none",
+    SUPPORTED = "supported",
+    REQUIRED = "required"
+}
+/** Capacidades operativas que el runtime puede aplicar de forma confiable. */
+export interface AutomationCapabilityExecutionSupport {
+    effectClass: AutomationCapabilityEffectClass;
+    supportsSimulation: boolean;
+    supportsTestTargets: boolean;
+    supportsUntilNode: boolean;
+    supportsFromNode: boolean;
+    supportsNodeOnly: boolean;
+    supportsCancellation: boolean;
+    idempotency: AutomationCapabilityIdempotency;
+    defaultTimeoutMs?: number | null;
+    maxAttempts?: number | null;
+    maxTestItems?: number | null;
+    inputSchema?: AutomationJsonSchema | null;
+    outputSchema?: AutomationJsonSchema | null;
+    simulationOutputSchema?: AutomationJsonSchema | null;
+    sensitivePaths?: string[] | null;
+    requiredPermissions?: string[] | null;
+}
 /**
  * Capacidad publicada por una aplicación de negocio para que Automation pueda
  * descubrirla y representarla sin incorporar reglas de ese dominio.
@@ -19,6 +50,8 @@ export interface AutomationCapability {
     requiredPermissions: string[];
     enabled: boolean;
     version: number;
+    /** Metadata opcional para definitions anteriores a la política de ejecución. */
+    executionSupport?: AutomationCapabilityExecutionSupport | null;
 }
 export interface AutomationCapabilityQuery {
     sourceApplications?: AutomationSourceApplication[];

package/dist/src/Automations/Capabilities/Capability.js

@@ -1,9 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AutomationCapabilityKind = void 0;
+exports.AutomationCapabilityIdempotency = exports.AutomationCapabilityEffectClass = exports.AutomationCapabilityKind = void 0;
 var AutomationCapabilityKind;
 (function (AutomationCapabilityKind) {
     AutomationCapabilityKind["TRIGGER"] = "trigger";
     AutomationCapabilityKind["ACTION"] = "action";
     AutomationCapabilityKind["CONDITION"] = "condition";
 })(AutomationCapabilityKind || (exports.AutomationCapabilityKind = AutomationCapabilityKind = {}));
+var AutomationCapabilityEffectClass;
+(function (AutomationCapabilityEffectClass) {
+    AutomationCapabilityEffectClass["NONE"] = "none";
+    AutomationCapabilityEffectClass["READ"] = "read";
+    AutomationCapabilityEffectClass["WRITE"] = "write";
+    AutomationCapabilityEffectClass["COMMUNICATION"] = "communication";
+    AutomationCapabilityEffectClass["BULK"] = "bulk";
+})(AutomationCapabilityEffectClass || (exports.AutomationCapabilityEffectClass = AutomationCapabilityEffectClass = {}));
+var AutomationCapabilityIdempotency;
+(function (AutomationCapabilityIdempotency) {
+    AutomationCapabilityIdempotency["NONE"] = "none";
+    AutomationCapabilityIdempotency["SUPPORTED"] = "supported";
+    AutomationCapabilityIdempotency["REQUIRED"] = "required";
+})(AutomationCapabilityIdempotency || (exports.AutomationCapabilityIdempotency = AutomationCapabilityIdempotency = {}));

package/dist/src/Automations/Common.d.ts

@@ -5,11 +5,33 @@
  * traducirse ni depender del nombre visible de la aplicación.
  */
 export declare enum AutomationSourceApplication {
+    /** Automations y sus capacidades Core. */
+    AUTOMATIONS = "automations",
+    /** Gestión de conversaciones y mensajería conversacional. */
     CONVERSATIONS = "conversations",
+    /** Gestión de contactos y organizaciones. */
+    CONTACTS = "contacts",
+    /** Gestión de tickets y soporte. */
     TICKETS = "tickets",
+    /** Campañas y operaciones de marketing. */
     MARKETING = "marketing",
+    /** Procesos y oportunidades comerciales. */
     SALES = "sales",
+    /** Telefonía y llamadas. */
     CALLS = "calls",
+    /** Comunicaciones salientes como email y SMS. */
+    COMMUNICATIONS = "communications",
+    /** Formularios y captura estructurada de datos. */
+    FORMS = "forms",
+    /** Conectores e integraciones externas. */
+    INTEGRATIONS = "integrations",
+    /** Acceso y transformación de datos. */
+    DATA = "data",
+    /** Agentes, modelos y herramientas de inteligencia artificial. */
+    AI = "ai",
+    /** Bases de conocimiento, documentos y búsqueda semántica. */
+    KNOWLEDGE = "knowledge",
+    /** Propietario externo o no clasificado; no debe usarse como fallback. */
     GENERIC = "generic"
 }
 export type AutomationJsonValue = string | number | boolean | null | AutomationJsonObject | AutomationJsonValue[];
@@ -45,3 +67,28 @@ export interface AutomationError {
     message: string;
     details?: AutomationJsonObject | null;
 }
+/** Referencia estable con la identidad visible al iniciar una ejecución. */
+export interface AutomationCustomerReference {
+    id: string;
+    displayNameSnapshot?: string | null;
+}
+/** Referencia transversal a una entidad perteneciente a una aplicación. */
+export interface AutomationResourceReference {
+    /** Aplicación propietaria de la entidad. */
+    sourceApplication: AutomationSourceApplication;
+    /** Tipo estable dentro de la aplicación, por ejemplo ticket o campaign. */
+    resourceType: string;
+    /** Identificador en la aplicación propietaria. */
+    id: string;
+    /** Nombre informativo capturado al crear la referencia. */
+    displayNameSnapshot?: string | null;
+}
+/**
+ * Contexto CRM opcional asociado a un evento o ejecución.
+ * Permite representar escenarios B2C, B2B o un contacto perteneciente a una
+ * empresa sin depender de los contratos internos del módulo Contacts.
+ */
+export interface AutomationCustomer {
+    contact?: AutomationCustomerReference | null;
+    business?: AutomationCustomerReference | null;
+}

package/dist/src/Automations/Common.js

@@ -9,10 +9,32 @@ exports.AutomationSourceApplication = void 0;
  */
 var AutomationSourceApplication;
 (function (AutomationSourceApplication) {
+    /** Automations y sus capacidades Core. */
+    AutomationSourceApplication["AUTOMATIONS"] = "automations";
+    /** Gestión de conversaciones y mensajería conversacional. */
     AutomationSourceApplication["CONVERSATIONS"] = "conversations";
+    /** Gestión de contactos y organizaciones. */
+    AutomationSourceApplication["CONTACTS"] = "contacts";
+    /** Gestión de tickets y soporte. */
     AutomationSourceApplication["TICKETS"] = "tickets";
+    /** Campañas y operaciones de marketing. */
     AutomationSourceApplication["MARKETING"] = "marketing";
+    /** Procesos y oportunidades comerciales. */
     AutomationSourceApplication["SALES"] = "sales";
+    /** Telefonía y llamadas. */
     AutomationSourceApplication["CALLS"] = "calls";
+    /** Comunicaciones salientes como email y SMS. */
+    AutomationSourceApplication["COMMUNICATIONS"] = "communications";
+    /** Formularios y captura estructurada de datos. */
+    AutomationSourceApplication["FORMS"] = "forms";
+    /** Conectores e integraciones externas. */
+    AutomationSourceApplication["INTEGRATIONS"] = "integrations";
+    /** Acceso y transformación de datos. */
+    AutomationSourceApplication["DATA"] = "data";
+    /** Agentes, modelos y herramientas de inteligencia artificial. */
+    AutomationSourceApplication["AI"] = "ai";
+    /** Bases de conocimiento, documentos y búsqueda semántica. */
+    AutomationSourceApplication["KNOWLEDGE"] = "knowledge";
+    /** Propietario externo o no clasificado; no debe usarse como fallback. */
     AutomationSourceApplication["GENERIC"] = "generic";
 })(AutomationSourceApplication || (exports.AutomationSourceApplication = AutomationSourceApplication = {}));

package/dist/src/Automations/Events/Event.d.ts

@@ -1,4 +1,4 @@
-import { AutomationJsonObject, AutomationJsonSchema, AutomationSourceApplication } from '../Common';
+import { AutomationCustomer, AutomationJsonObject, AutomationJsonSchema, AutomationResourceReference, AutomationSourceApplication } from '../Common';
 export interface AutomationEventDefinition {
     eventType: string;
     version: number;
@@ -6,6 +6,7 @@ export interface AutomationEventDefinition {
     name: string;
     description?: string | null;
     payloadSchema: AutomationJsonSchema;
+    /** Schema de la vista del envelope cuyos paths pueden utilizarse en filtros. */
     filterSchema?: AutomationJsonSchema | null;
     requiredPermissions: string[];
     enabled: boolean;
@@ -18,23 +19,50 @@ export interface AutomationEventEnvelope {
     eventVersion: number;
     occurredAt: string;
     receivedAt: string;
-    subjectId?: string | null;
+    customer?: AutomationCustomer | null;
+    /** Entidad principal sobre la que ocurrió el evento. */
+    subject?: AutomationResourceReference | null;
     correlationId?: string | null;
     causationId?: string | null;
     idempotencyKey?: string | null;
     payload: AutomationJsonObject;
     metadata?: AutomationJsonObject | null;
 }
+export declare enum AutomationEntryPointExclusionCode {
+    ENTRY_POINT_DISABLED = "entryPointDisabled",
+    SOURCE_APPLICATION_MISMATCH = "sourceApplicationMismatch",
+    EVENT_TYPE_MISMATCH = "eventTypeMismatch",
+    FILTERS_NOT_MATCHED = "filtersNotMatched",
+    FLOW_NOT_ACTIVE = "flowNotActive",
+    VERSION_NOT_PUBLISHED = "versionNotPublished",
+    LOWER_PRIORITY = "lowerPriority",
+    EXECUTION_MODE_RESTRICTED = "executionModeRestricted"
+}
+/** Motivo estructurado por el que un Entry Point no fue seleccionado. */
+export interface AutomationEntryPointExclusion {
+    /** Código estable para lógica, métricas y observabilidad. */
+    code: AutomationEntryPointExclusionCode;
+    /** Explicación humana opcional; no debe utilizarse para lógica. */
+    message?: string | null;
+    /** Datos diagnósticos específicos del código. */
+    details?: AutomationJsonObject | null;
+}
 export interface ResolveFlowEntryPointsRequest {
     event: AutomationEventEnvelope;
 }
 export interface ResolvedFlowEntryPoint {
+    /** Definición estable del Flow. */
     flowId: string;
+    /** Versión publicada candidata a recibir el evento. */
     flowVersionId: string;
+    /** Entry Point evaluado. */
     entryPointId: string;
+    /** Prioridad utilizada para resolver candidatos. */
     priority: number;
+    /** Indica si el candidato debe iniciar una ejecución. */
     selected: boolean;
-    exclusionReason?: string | null;
+    /** Motivo de exclusión; ausente cuando selected es true. */
+    exclusion?: AutomationEntryPointExclusion | null;
 }
 export interface ResolveFlowEntryPointsResult {
     matches: ResolvedFlowEntryPoint[];

package/dist/src/Automations/Events/Event.js

@@ -1,2 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationEntryPointExclusionCode = void 0;
+var AutomationEntryPointExclusionCode;
+(function (AutomationEntryPointExclusionCode) {
+    AutomationEntryPointExclusionCode["ENTRY_POINT_DISABLED"] = "entryPointDisabled";
+    AutomationEntryPointExclusionCode["SOURCE_APPLICATION_MISMATCH"] = "sourceApplicationMismatch";
+    AutomationEntryPointExclusionCode["EVENT_TYPE_MISMATCH"] = "eventTypeMismatch";
+    AutomationEntryPointExclusionCode["FILTERS_NOT_MATCHED"] = "filtersNotMatched";
+    AutomationEntryPointExclusionCode["FLOW_NOT_ACTIVE"] = "flowNotActive";
+    AutomationEntryPointExclusionCode["VERSION_NOT_PUBLISHED"] = "versionNotPublished";
+    AutomationEntryPointExclusionCode["LOWER_PRIORITY"] = "lowerPriority";
+    AutomationEntryPointExclusionCode["EXECUTION_MODE_RESTRICTED"] = "executionModeRestricted";
+})(AutomationEntryPointExclusionCode || (exports.AutomationEntryPointExclusionCode = AutomationEntryPointExclusionCode = {}));

package/dist/src/Automations/Executions/Execution.d.ts

@@ -1,4 +1,5 @@
-import { AutomationError, AutomationJsonObject, AutomationPageRequest, AutomationSourceApplication } from '../Common';
+import { AutomationCustomer, AutomationError, AutomationJsonObject, AutomationPageRequest, AutomationResourceReference, AutomationSourceApplication } from '../Common';
+import { AutomationCapabilityEffectClass } from '../Capabilities';
 export declare enum AutomationExecutionStatus {
     QUEUED = "queued",
     RUNNING = "running",
@@ -17,15 +18,104 @@ export declare enum AutomationExecutionStepStatus {
     SKIPPED = "skipped",
     CANCELLED = "cancelled"
 }
+export declare enum AutomationExecutionPurpose {
+    PRODUCTION = "production",
+    TEST = "test"
+}
+export declare enum AutomationExecutionEffectMode {
+    SIMULATE = "simulate",
+    TEST_TARGETS = "testTargets",
+    REAL = "real"
+}
+export declare enum AutomationExecutionScopeKind {
+    FULL = "full",
+    UNTIL_NODE = "untilNode",
+    FROM_NODE = "fromNode",
+    NODE_ONLY = "nodeOnly"
+}
+export declare enum AutomationExecutionSourceKind {
+    MANUAL = "manual",
+    FIXTURE = "fixture",
+    CAPTURED_EVENT = "capturedEvent",
+    EXECUTION = "execution",
+    STEP_OUTPUT = "stepOutput"
+}
+export declare enum AutomationExecutionLineageOperation {
+    NEW = "new",
+    REPLAY = "replay",
+    RETRY = "retry"
+}
+export declare enum AutomationExecutionEffectDecision {
+    EXECUTED = "executed",
+    SIMULATED = "simulated",
+    REDIRECTED = "redirected",
+    BLOCKED = "blocked"
+}
+export interface AutomationExecutionScope {
+    kind: AutomationExecutionScopeKind;
+    startNodeId?: string | null;
+    stopNodeId?: string | null;
+}
+/** Referencia inmutable a la definición exacta utilizada por una ejecución. */
+export interface AutomationFlowSnapshotReference {
+    flowId: string;
+    flowVersionId?: string | null;
+    snapshotId?: string | null;
+    revision: number;
+    contentHash: string;
+}
+export interface AutomationExecutionSource {
+    kind: AutomationExecutionSourceKind;
+    fixtureId?: string | null;
+    capturedEventId?: string | null;
+    executionId?: string | null;
+    stepId?: string | null;
+}
+export interface AutomationExecutionLineage {
+    operation: AutomationExecutionLineageOperation;
+    sourceExecutionId?: string | null;
+    sourceStepId?: string | null;
+    rootExecutionId?: string | null;
+}
+/** Resumen seguro; la política interna completa nunca se expone al caller. */
+export interface AutomationExecutionPolicySummary {
+    maxDurationMs?: number | null;
+    maxSteps?: number | null;
+    maxIterations?: number | null;
+    maxItems?: number | null;
+    maxCost?: number | null;
+    currency?: string | null;
+    simulatedClockAt?: string | null;
+    requiresConfirmation: boolean;
+}
+export interface AutomationExecutionEffectRecord {
+    id: string;
+    nodeId: string;
+    effectClass: AutomationCapabilityEffectClass;
+    action: string;
+    decision: AutomationExecutionEffectDecision;
+    originalTarget?: AutomationResourceReference | null;
+    effectiveTarget?: AutomationResourceReference | null;
+    preview?: AutomationJsonObject | null;
+    providerReference?: string | null;
+    idempotencyKey?: string | null;
+    warnings?: string[] | null;
+}
 /**
  * Referencia genérica al evento que inició una ejecución.
  */
 export interface AutomationExecutionTrigger {
+    /** Entry Point que aceptó el evento. */
     entryPointId: string;
+    /** Aplicación propietaria del evento. */
     sourceApplication: AutomationSourceApplication;
+    /** Código estable del tipo de evento. */
     eventType: string;
-    referenceId?: string | null;
+    /** Entidad principal relacionada con el evento. */
+    reference?: AutomationResourceReference | null;
+    /** Instante informado por el productor. */
     occurredAt?: string | null;
+    /** Snapshot opcional del payload disparador. */
     payload?: AutomationJsonObject | null;
 }
 /** Identidad completa que debe persistir una ejecución transversal. */
@@ -35,6 +125,27 @@ export interface AutomationFlowExecutionReference {
     entryPointId: string;
     executionId: string;
 }
+/** Contexto que un caller puede aportar al iniciar una ejecución. */
+export interface AutomationExecutionContextInput {
+    /** Valores iniciales de variables declaradas por la versión del Flow. */
+    variables: AutomationJsonObject;
+    /** Extensiones agrupadas por módulo propietario. */
+    extensions: AutomationJsonObject;
+}
+/** Datos confiables establecidos exclusivamente por Automations. */
+export interface AutomationExecutionSystemContext {
+    /** Locale BCP 47, por ejemplo es-AR. */
+    locale?: string | null;
+    /** Zona horaria IANA utilizada por fechas y agendas. */
+    timeZone?: string | null;
+    /** Usuario, servicio o recurso que originó la ejecución. */
+    actor?: AutomationResourceReference | null;
+}
+/** Contexto persistido y utilizado durante una ejecución. */
+export interface AutomationExecutionContext extends AutomationExecutionContextInput {
+    /** Datos confiables agregados por el runtime. */
+    system: AutomationExecutionSystemContext;
+}
 export interface AutomationExecution {
     id: string;
     spaceId: string;
@@ -43,9 +154,11 @@ export interface AutomationExecution {
     flowVersion: number;
     entryPointId: string;
     status: AutomationExecutionStatus;
+    customer?: AutomationCustomer | null;
     trigger: AutomationExecutionTrigger;
     input: AutomationJsonObject;
-    context: AutomationJsonObject;
+    /** Scope tipado y extensible utilizado durante la ejecución. */
+    context: AutomationExecutionContext;
     output?: AutomationJsonObject | null;
     error?: AutomationError | null;
     createdAt: string;
@@ -56,6 +169,18 @@ export interface AutomationExecution {
     correlationId?: string | null;
     parentExecutionId?: string | null;
     usage: AutomationExecutionUsage;
+    /** Ausente únicamente en ejecuciones creadas con contratos anteriores. */
+    purpose?: AutomationExecutionPurpose | null;
+    requestedEffectMode?: AutomationExecutionEffectMode | null;
+    effectiveEffectMode?: AutomationExecutionEffectMode | null;
+    scope?: AutomationExecutionScope | null;
+    source?: AutomationExecutionSource | null;
+    snapshot?: AutomationFlowSnapshotReference | null;
+    lineage?: AutomationExecutionLineage | null;
+    startedBy?: AutomationResourceReference | null;
+    policySummary?: AutomationExecutionPolicySummary | null;
+    testCaseId?: string | null;
+    testCaseRevision?: number | null;
 }
 export interface AutomationExecutionStep {
     id: string;
@@ -72,6 +197,13 @@ export interface AutomationExecutionStep {
     startedAt?: string | null;
     completedAt?: string | null;
     usage: AutomationExecutionUsage;
+    waitingReason?: string | null;
+    skippedReason?: string | null;
+    itemIndex?: number | null;
+    iteration?: number | null;
+    parentStepId?: string | null;
+    takenEdgeIds?: string[] | null;
+    effects?: AutomationExecutionEffectRecord[] | null;
 }
 export interface AutomationExecutionUsage {
     inputTokens: number;
@@ -85,18 +217,26 @@ export interface AutomationExecutionQuery extends AutomationPageRequest {
     flowId?: string | null;
     flowVersionId?: string | null;
     entryPointId?: string | null;
+    contactId?: string | null;
+    businessId?: string | null;
+    customerSearch?: string | null;
     statuses?: AutomationExecutionStatus[] | null;
     createdFrom?: string | null;
     createdTo?: string | null;
     correlationId?: string | null;
+    purposes?: AutomationExecutionPurpose[] | null;
+    effectModes?: AutomationExecutionEffectMode[] | null;
+    testCaseId?: string | null;
 }
 export interface StartAutomationExecutionRequest {
     flowId: string;
     flowVersionId: string;
     entryPointId: string;
+    customer?: AutomationCustomer | null;
     trigger: AutomationExecutionTrigger;
     input: AutomationJsonObject;
-    context: AutomationJsonObject;
+    /** Variables iniciales y extensiones aportadas por el caller. */
+    context: AutomationExecutionContextInput;
     idempotencyKey?: string | null;
     correlationId?: string | null;
     parentExecutionId?: string | null;