@trii/types 2.10.694 → 2.10.696

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

@@ -357,4 +357,73 @@ export interface UserInboxCounterDocument {
     projectionVersion: number;
     updatedAt: Date;
 }
+export interface CursorPage<T> {
+    items: T[];
+    nextCursor?: string;
+    hasMore: boolean;
+    generatedAt: Date;
+}
+export interface ConversationCapabilitiesDto {
+    canView: boolean;
+    canReply: boolean;
+    canFollow: boolean;
+    canAbandon: boolean;
+    canClaim: boolean;
+    canAccept: boolean;
+    canRelease: boolean;
+    canTransfer: boolean;
+    canResolve: boolean;
+    canReopen: boolean;
+    canChangePriority: boolean;
+    canManageLabels: boolean;
+    canManageSla: boolean;
+    canViewAssignmentHistory: boolean;
+    canViewRoutingDecisions: boolean;
+}
+export interface InboxViewSummaryDto {
+    id: InboxViewId | 'supervised_target';
+    label: string;
+    scope: 'personal' | 'supervision' | 'history';
+    order: number;
+    total: number;
+    requiresAction: number;
+    unread: number;
+    enabled: boolean;
+    targetRequired: boolean;
+    capabilities: string[];
+}
+export interface InboxViewsResponse {
+    views: InboxViewSummaryDto[];
+    countersGeneratedAt: Date;
+    projectionLagMs?: number;
+}
+export interface InboxFilterDto {
+    text?: string;
+    queueIds?: ID[];
+    ownerUserIds?: ID[];
+    channelTypes?: string[];
+    statuses?: ConversationStatus[];
+    priorities?: Array<'low' | 'normal' | 'high' | 'urgent'>;
+    slaStatuses?: Array<'none' | 'running' | 'warning' | 'breached' | 'met'>;
+    labelIds?: ID[];
+    unread?: boolean;
+    requiresAction?: boolean;
+    pinned?: boolean;
+    lastActivity?: {
+        from?: Date;
+        to?: Date;
+    };
+    sort: {
+        type: 'activity';
+    } | {
+        type: 'priority';
+    };
+}
+export type InboxConversationItemDto = Pick<UserInboxItemDocument, 'conversationId' | 'views' | 'snapshot' | 'pinned' | 'priorityScore' | 'sortAt'> & {
+    capabilities: Pick<ConversationCapabilitiesDto, 'canView' | 'canReply' | 'canClaim' | 'canTransfer'>;
+};
+export interface InboxConversationPage extends CursorPage<InboxConversationItemDto> {
+    appliedFilter: InboxFilterDto;
+    facets?: unknown;
+}
 export {};

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/Tickets/Dashboard.d.ts

@@ -229,6 +229,7 @@ export interface ITicketMetricDefinition {
     supportsPercentile?: boolean;
     supportsRealTime?: boolean;
     higherIsBetter?: boolean;
+    supportedFilters: (keyof Omit<ITicketAnalyticsFilter, 'range'>)[];
 }
 export interface ITicketMetricQuery {
     metric: TicketMetricCode;

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.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;